--- /srv/rebuilderd/tmp/rebuilderdTRPoQ8/inputs/shishi-doc_1.0.3-7_all.deb
+++ /srv/rebuilderd/tmp/rebuilderdTRPoQ8/out/shishi-doc_1.0.3-7_all.deb
├── control.tar.xz
│ ├── control.tar
│ │ ├── ./md5sums
│ │ │ ├── ./md5sums
│ │ │ │┄ Files differ
├── data.tar.xz
│ ├── data.tar
│ │ ├── file list
│ │ │ @@ -15,30 +15,30 @@
│ │ │  -rw-r--r--   0 root         (0) root         (0)      261 2026-03-08 22:00:36.000000 ./usr/share/doc/shishi/gtk-doc/right.png
│ │ │  -rw-r--r--   0 root         (0) root         (0)     6202 2026-03-08 22:00:36.000000 ./usr/share/doc/shishi/gtk-doc/shishi-shishi-version.h.html
│ │ │  -rw-r--r--   0 root         (0) root         (0)  1617019 2026-03-08 22:00:36.000000 ./usr/share/doc/shishi/gtk-doc/shishi-shishi.h.html
│ │ │  -rw-r--r--   0 root         (0) root         (0)   125249 2026-03-08 22:00:36.000000 ./usr/share/doc/shishi/gtk-doc/shishi.devhelp2
│ │ │  -rw-r--r--   0 root         (0) root         (0)    12035 2026-03-08 22:00:36.000000 ./usr/share/doc/shishi/gtk-doc/style.css
│ │ │  -rw-r--r--   0 root         (0) root         (0)      374 2026-03-08 22:00:36.000000 ./usr/share/doc/shishi/gtk-doc/up-insensitive.png
│ │ │  -rw-r--r--   0 root         (0) root         (0)      260 2026-03-08 22:00:36.000000 ./usr/share/doc/shishi/gtk-doc/up.png
│ │ │ --rw-r--r--   0 root         (0) root         (0)  1577382 2026-03-08 22:00:36.000000 ./usr/share/doc/shishi/shishi.html
│ │ │ --rw-r--r--   0 root         (0) root         (0)   869965 2026-03-08 22:00:36.000000 ./usr/share/doc/shishi/shishi.pdf
│ │ │ +-rw-r--r--   0 root         (0) root         (0)  1577384 2026-03-08 22:00:36.000000 ./usr/share/doc/shishi/shishi.html
│ │ │ +-rw-r--r--   0 root         (0) root         (0)   869966 2026-03-08 22:00:36.000000 ./usr/share/doc/shishi/shishi.pdf
│ │ │  drwxr-xr-x   0 root         (0) root         (0)        0 2026-03-08 22:00:36.000000 ./usr/share/doc/shishi-doc/
│ │ │  -rw-r--r--   0 root         (0) root         (0)     1250 2026-03-08 22:00:36.000000 ./usr/share/doc/shishi-doc/changelog.Debian.gz
│ │ │  -rw-r--r--   0 root         (0) root         (0)    31528 2022-08-07 01:59:17.000000 ./usr/share/doc/shishi-doc/changelog.gz
│ │ │  -rw-r--r--   0 root         (0) root         (0)     8088 2026-03-08 22:00:36.000000 ./usr/share/doc/shishi-doc/copyright
│ │ │  drwxr-xr-x   0 root         (0) root         (0)        0 2026-03-08 22:00:36.000000 ./usr/share/doc-base/
│ │ │  -rw-r--r--   0 root         (0) root         (0)      354 2026-03-08 22:00:36.000000 ./usr/share/doc-base/shishi-doc.shishi
│ │ │  -rw-r--r--   0 root         (0) root         (0)      232 2026-03-08 22:00:36.000000 ./usr/share/doc-base/shishi-doc.shishi-api
│ │ │  drwxr-xr-x   0 root         (0) root         (0)        0 2026-03-08 22:00:36.000000 ./usr/share/gtk-doc/
│ │ │  drwxr-xr-x   0 root         (0) root         (0)        0 2026-03-08 22:00:36.000000 ./usr/share/gtk-doc/html/
│ │ │  drwxr-xr-x   0 root         (0) root         (0)        0 2026-03-08 22:00:36.000000 ./usr/share/info/
│ │ │ --rw-r--r--   0 root         (0) root         (0)    70436 2026-03-08 22:00:36.000000 ./usr/share/info/shishi.info-1.gz
│ │ │ --rw-r--r--   0 root         (0) root         (0)    50893 2026-03-08 22:00:36.000000 ./usr/share/info/shishi.info-2.gz
│ │ │ --rw-r--r--   0 root         (0) root         (0)    21655 2026-03-08 22:00:36.000000 ./usr/share/info/shishi.info-3.gz
│ │ │ --rw-r--r--   0 root         (0) root         (0)     7487 2026-03-08 22:00:36.000000 ./usr/share/info/shishi.info.gz
│ │ │ +-rw-r--r--   0 root         (0) root         (0)    70438 2026-03-08 22:00:36.000000 ./usr/share/info/shishi.info-1.gz
│ │ │ +-rw-r--r--   0 root         (0) root         (0)    50894 2026-03-08 22:00:36.000000 ./usr/share/info/shishi.info-2.gz
│ │ │ +-rw-r--r--   0 root         (0) root         (0)    21656 2026-03-08 22:00:36.000000 ./usr/share/info/shishi.info-3.gz
│ │ │ +-rw-r--r--   0 root         (0) root         (0)     7482 2026-03-08 22:00:36.000000 ./usr/share/info/shishi.info.gz
│ │ │  drwxr-xr-x   0 root         (0) root         (0)        0 2026-03-08 22:00:36.000000 ./usr/share/man/
│ │ │  drwxr-xr-x   0 root         (0) root         (0)        0 2026-03-08 22:00:36.000000 ./usr/share/man/man3/
│ │ │  -rw-r--r--   0 root         (0) root         (0)      698 2026-03-08 22:00:36.000000 ./usr/share/man/man3/shishi.3.gz
│ │ │  -rw-r--r--   0 root         (0) root         (0)      942 2026-03-08 22:00:36.000000 ./usr/share/man/man3/shishi_3des.3.gz
│ │ │  -rw-r--r--   0 root         (0) root         (0)     1009 2026-03-08 22:00:36.000000 ./usr/share/man/man3/shishi_aes_cts.3.gz
│ │ │  -rw-r--r--   0 root         (0) root         (0)      871 2026-03-08 22:00:36.000000 ./usr/share/man/man3/shishi_ap.3.gz
│ │ │  -rw-r--r--   0 root         (0) root         (0)      700 2026-03-08 22:00:36.000000 ./usr/share/man/man3/shishi_ap_authenticator.3.gz
│ │ ├── ./usr/share/doc/shishi/shishi.html
│ │ │ @@ -1,13 +1,13 @@
│ │ │  <!DOCTYPE html>
│ │ │  <html>
│ │ │  <!-- Created by GNU Texinfo 7.2, https://www.gnu.org/software/texinfo/ -->
│ │ │  <head>
│ │ │  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
│ │ │ -<!-- This manual is last updated 8 March 2026 for version
│ │ │ +<!-- This manual is last updated 14 March 2026 for version
│ │ │  1.0.3 of Shishi.
│ │ │  
│ │ │  Copyright © 2002-2022 Simon Josefsson.
│ │ │  
│ │ │  Permission is granted to copy, distribute and/or modify this document
│ │ │  under the terms of the GNU Free Documentation License, Version 1.3 or
│ │ │  any later version published by the Free Software Foundation; with no
│ │ │ @@ -60,15 +60,15 @@
│ │ │  
│ │ │  <div class="top-level-extent" id="Top">
│ │ │  <div class="nav-panel">
│ │ │  <p>
│ │ │  Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Function-and-Data-Index" title="Index" rel="index">Index</a>]</p>
│ │ │  </div>
│ │ │  <h1 class="top" id="Shishi"><span>Shishi<a class="copiable-link" href="#Shishi"> &para;</a></span></h1>
│ │ │ -<p>This manual is last updated 8 March 2026 for version
│ │ │ +<p>This manual is last updated 14 March 2026 for version
│ │ │  1.0.3 of Shishi.
│ │ │  </p>
│ │ │  <p>Copyright &copy; 2002&ndash;2022 Simon Josefsson.
│ │ │  </p>
│ │ │  <blockquote class="quotation">
│ │ │  <p>Permission is granted to copy, distribute and/or modify this document
│ │ │  under the terms of the GNU Free Documentation License, Version 1.3 or
│ │ │ ├── html2text {}
│ │ │ │ @@ -1,10 +1,10 @@
│ │ │ │  Next: _I_n_t_r_o_d_u_c_t_i_o_n   [_C_o_n_t_e_n_t_s][_I_n_d_e_x]
│ │ │ │  ************ SShhiisshhii_ _?¶ ************
│ │ │ │ -This manual is last updated 8 March 2026 for version 1.0.3 of Shishi.
│ │ │ │ +This manual is last updated 14 March 2026 for version 1.0.3 of Shishi.
│ │ │ │  Copyright © 2002–2022 Simon Josefsson.
│ │ │ │       Permission is granted to copy, distribute and/or modify this document
│ │ │ │       under the terms of the GNU Free Documentation License, Version 1.3 or
│ │ │ │       any later version published by the Free Software Foundation; with no
│ │ │ │       Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
│ │ │ │       copy of the license is included in the section entitled “GNU Free
│ │ │ │       Documentation License”.
│ │ ├── ./usr/share/doc/shishi/shishi.pdf
│ │ │ ├── pdftotext {} -
│ │ │ │ @@ -1,14 +1,14 @@
│ │ │ │  Shishi
│ │ │ │  Kerberos 5 implementation for the GNU system
│ │ │ │ -for version 1.0.3, 8 March 2026
│ │ │ │ +for version 1.0.3, 14 March 2026
│ │ │ │  
│ │ │ │  Simon Josefsson
│ │ │ │  
│ │ │ │ -This manual is last updated 8 March 2026 for version 1.0.3 of Shishi.
│ │ │ │ +This manual is last updated 14 March 2026 for version 1.0.3 of Shishi.
│ │ │ │  Copyright c 2002–2022 Simon Josefsson.
│ │ │ │  Permission is granted to copy, distribute and/or modify this document under the
│ │ │ │  terms of the GNU Free Documentation License, Version 1.3 or any later version
│ │ │ │  published by the Free Software Foundation; with no Invariant Sections, no
│ │ │ │  Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included
│ │ │ │  in the section entitled “GNU Free Documentation License”.
│ │ ├── ./usr/share/info/shishi.info-1.gz
│ │ │ ├── shishi.info-1
│ │ │ │ @@ -1,19024 +1,19024 @@
│ │ │ │  00000000: 5468 6973 2069 7320 7368 6973 6869 2e69  This is shishi.i
│ │ │ │  00000010: 6e66 6f2c 2070 726f 6475 6365 6420 6279  nfo, produced by
│ │ │ │  00000020: 206d 616b 6569 6e66 6f20 7665 7273 696f   makeinfo versio
│ │ │ │  00000030: 6e20 372e 3220 6672 6f6d 2073 6869 7368  n 7.2 from shish
│ │ │ │  00000040: 692e 7465 7869 2e0a 0a54 6869 7320 6d61  i.texi...This ma
│ │ │ │  00000050: 6e75 616c 2069 7320 6c61 7374 2075 7064  nual is last upd
│ │ │ │ -00000060: 6174 6564 2038 204d 6172 6368 2032 3032  ated 8 March 202
│ │ │ │ -00000070: 3620 666f 7220 7665 7273 696f 6e20 312e  6 for version 1.
│ │ │ │ -00000080: 302e 3320 6f66 2053 6869 7368 692e 0a0a  0.3 of Shishi...
│ │ │ │ -00000090: 2020 2043 6f70 7972 6967 6874 20c2 a920     Copyright .. 
│ │ │ │ -000000a0: 3230 3032 2d32 3032 3220 5369 6d6f 6e20  2002-2022 Simon 
│ │ │ │ -000000b0: 4a6f 7365 6673 736f 6e2e 0a0a 2020 2020  Josefsson...    
│ │ │ │ -000000c0: 2050 6572 6d69 7373 696f 6e20 6973 2067   Permission is g
│ │ │ │ -000000d0: 7261 6e74 6564 2074 6f20 636f 7079 2c20  ranted to copy, 
│ │ │ │ -000000e0: 6469 7374 7269 6275 7465 2061 6e64 2f6f  distribute and/o
│ │ │ │ -000000f0: 7220 6d6f 6469 6679 2074 6869 730a 2020  r modify this.  
│ │ │ │ -00000100: 2020 2064 6f63 756d 656e 7420 756e 6465     document unde
│ │ │ │ -00000110: 7220 7468 6520 7465 726d 7320 6f66 2074  r the terms of t
│ │ │ │ -00000120: 6865 2047 4e55 2046 7265 6520 446f 6375  he GNU Free Docu
│ │ │ │ -00000130: 6d65 6e74 6174 696f 6e20 4c69 6365 6e73  mentation Licens
│ │ │ │ -00000140: 652c 0a20 2020 2020 5665 7273 696f 6e20  e,.     Version 
│ │ │ │ -00000150: 312e 3320 6f72 2061 6e79 206c 6174 6572  1.3 or any later
│ │ │ │ -00000160: 2076 6572 7369 6f6e 2070 7562 6c69 7368   version publish
│ │ │ │ -00000170: 6564 2062 7920 7468 6520 4672 6565 2053  ed by the Free S
│ │ │ │ -00000180: 6f66 7477 6172 650a 2020 2020 2046 6f75  oftware.     Fou
│ │ │ │ -00000190: 6e64 6174 696f 6e3b 2077 6974 6820 6e6f  ndation; with no
│ │ │ │ -000001a0: 2049 6e76 6172 6961 6e74 2053 6563 7469   Invariant Secti
│ │ │ │ -000001b0: 6f6e 732c 206e 6f20 4672 6f6e 742d 436f  ons, no Front-Co
│ │ │ │ -000001c0: 7665 7220 5465 7874 732c 2061 6e64 0a20  ver Texts, and. 
│ │ │ │ -000001d0: 2020 2020 6e6f 2042 6163 6b2d 436f 7665      no Back-Cove
│ │ │ │ -000001e0: 7220 5465 7874 732e 2020 4120 636f 7079  r Texts.  A copy
│ │ │ │ -000001f0: 206f 6620 7468 6520 6c69 6365 6e73 6520   of the license 
│ │ │ │ -00000200: 6973 2069 6e63 6c75 6465 6420 696e 2074  is included in t
│ │ │ │ -00000210: 6865 0a20 2020 2020 7365 6374 696f 6e20  he.     section 
│ │ │ │ -00000220: 656e 7469 746c 6564 2022 474e 5520 4672  entitled "GNU Fr
│ │ │ │ -00000230: 6565 2044 6f63 756d 656e 7461 7469 6f6e  ee Documentation
│ │ │ │ -00000240: 204c 6963 656e 7365 222e 0a49 4e46 4f2d   License"..INFO-
│ │ │ │ -00000250: 4449 522d 5345 4354 494f 4e20 474e 5520  DIR-SECTION GNU 
│ │ │ │ -00000260: 7574 696c 6974 6965 730a 5354 4152 542d  utilities.START-
│ │ │ │ -00000270: 494e 464f 2d44 4952 2d45 4e54 5259 0a2a  INFO-DIR-ENTRY.*
│ │ │ │ -00000280: 2073 6869 7368 693a 2028 7368 6973 6869   shishi: (shishi
│ │ │ │ -00000290: 292e 0909 4120 4b65 7262 6572 6f73 2035  )...A Kerberos 5
│ │ │ │ -000002a0: 2069 6d70 6c65 6d65 6e74 6174 696f 6e0a   implementation.
│ │ │ │ -000002b0: 454e 442d 494e 464f 2d44 4952 2d45 4e54  END-INFO-DIR-ENT
│ │ │ │ -000002c0: 5259 0a0a 494e 464f 2d44 4952 2d53 4543  RY..INFO-DIR-SEC
│ │ │ │ -000002d0: 5449 4f4e 2047 4e55 204c 6962 7261 7269  TION GNU Librari
│ │ │ │ -000002e0: 6573 0a53 5441 5254 2d49 4e46 4f2d 4449  es.START-INFO-DI
│ │ │ │ -000002f0: 522d 454e 5452 590a 2a20 6c69 6273 6869  R-ENTRY.* libshi
│ │ │ │ -00000300: 7368 693a 2028 7368 6973 6869 292e 0909  shi: (shishi)...
│ │ │ │ -00000310: 4c69 6272 6172 7920 696d 706c 656d 656e  Library implemen
│ │ │ │ -00000320: 7469 6e67 204b 6572 6265 726f 7320 352e  ting Kerberos 5.
│ │ │ │ -00000330: 0a45 4e44 2d49 4e46 4f2d 4449 522d 454e  .END-INFO-DIR-EN
│ │ │ │ -00000340: 5452 590a 0a1f 0a46 696c 653a 2073 6869  TRY....File: shi
│ │ │ │ -00000350: 7368 692e 696e 666f 2c20 204e 6f64 653a  shi.info,  Node:
│ │ │ │ -00000360: 2054 6f70 2c20 204e 6578 743a 2049 6e74   Top,  Next: Int
│ │ │ │ -00000370: 726f 6475 6374 696f 6e2c 2020 5570 3a20  roduction,  Up: 
│ │ │ │ -00000380: 2864 6972 290a 0a53 6869 7368 690a 2a2a  (dir)..Shishi.**
│ │ │ │ -00000390: 2a2a 2a2a 0a0a 5468 6973 206d 616e 7561  ****..This manua
│ │ │ │ -000003a0: 6c20 6973 206c 6173 7420 7570 6461 7465  l is last update
│ │ │ │ -000003b0: 6420 3820 4d61 7263 6820 3230 3236 2066  d 8 March 2026 f
│ │ │ │ -000003c0: 6f72 2076 6572 7369 6f6e 2031 2e30 2e33  or version 1.0.3
│ │ │ │ -000003d0: 206f 6620 5368 6973 6869 2e0a 0a20 2020   of Shishi...   
│ │ │ │ -000003e0: 436f 7079 7269 6768 7420 c2a9 2032 3030  Copyright .. 200
│ │ │ │ -000003f0: 322d 3230 3232 2053 696d 6f6e 204a 6f73  2-2022 Simon Jos
│ │ │ │ -00000400: 6566 7373 6f6e 2e0a 0a20 2020 2020 5065  efsson...     Pe
│ │ │ │ -00000410: 726d 6973 7369 6f6e 2069 7320 6772 616e  rmission is gran
│ │ │ │ -00000420: 7465 6420 746f 2063 6f70 792c 2064 6973  ted to copy, dis
│ │ │ │ -00000430: 7472 6962 7574 6520 616e 642f 6f72 206d  tribute and/or m
│ │ │ │ -00000440: 6f64 6966 7920 7468 6973 0a20 2020 2020  odify this.     
│ │ │ │ -00000450: 646f 6375 6d65 6e74 2075 6e64 6572 2074  document under t
│ │ │ │ -00000460: 6865 2074 6572 6d73 206f 6620 7468 6520  he terms of the 
│ │ │ │ -00000470: 474e 5520 4672 6565 2044 6f63 756d 656e  GNU Free Documen
│ │ │ │ -00000480: 7461 7469 6f6e 204c 6963 656e 7365 2c0a  tation License,.
│ │ │ │ -00000490: 2020 2020 2056 6572 7369 6f6e 2031 2e33       Version 1.3
│ │ │ │ -000004a0: 206f 7220 616e 7920 6c61 7465 7220 7665   or any later ve
│ │ │ │ -000004b0: 7273 696f 6e20 7075 626c 6973 6865 6420  rsion published 
│ │ │ │ -000004c0: 6279 2074 6865 2046 7265 6520 536f 6674  by the Free Soft
│ │ │ │ -000004d0: 7761 7265 0a20 2020 2020 466f 756e 6461  ware.     Founda
│ │ │ │ -000004e0: 7469 6f6e 3b20 7769 7468 206e 6f20 496e  tion; with no In
│ │ │ │ -000004f0: 7661 7269 616e 7420 5365 6374 696f 6e73  variant Sections
│ │ │ │ -00000500: 2c20 6e6f 2046 726f 6e74 2d43 6f76 6572  , no Front-Cover
│ │ │ │ -00000510: 2054 6578 7473 2c20 616e 640a 2020 2020   Texts, and.    
│ │ │ │ -00000520: 206e 6f20 4261 636b 2d43 6f76 6572 2054   no Back-Cover T
│ │ │ │ -00000530: 6578 7473 2e20 2041 2063 6f70 7920 6f66  exts.  A copy of
│ │ │ │ -00000540: 2074 6865 206c 6963 656e 7365 2069 7320   the license is 
│ │ │ │ -00000550: 696e 636c 7564 6564 2069 6e20 7468 650a  included in the.
│ │ │ │ -00000560: 2020 2020 2073 6563 7469 6f6e 2065 6e74       section ent
│ │ │ │ -00000570: 6974 6c65 6420 2247 4e55 2046 7265 6520  itled "GNU Free 
│ │ │ │ -00000580: 446f 6375 6d65 6e74 6174 696f 6e20 4c69  Documentation Li
│ │ │ │ -00000590: 6365 6e73 6522 2e0a 0a2a 204d 656e 753a  cense"...* Menu:
│ │ │ │ -000005a0: 0a0a 2a20 496e 7472 6f64 7563 7469 6f6e  ..* Introduction
│ │ │ │ -000005b0: 3a3a 2020 2020 2020 2020 2020 2020 2020  ::              
│ │ │ │ -000005c0: 2020 486f 7720 746f 2075 7365 2074 6869    How to use thi
│ │ │ │ -000005d0: 7320 6d61 6e75 616c 2e0a 2a20 5573 6572  s manual..* User
│ │ │ │ -000005e0: 204d 616e 7561 6c3a 3a20 2020 2020 2020   Manual::       
│ │ │ │ -000005f0: 2020 2020 2020 2020 2020 5573 696e 6720            Using 
│ │ │ │ -00000600: 5368 6973 6869 2061 7320 656e 642d 7573  Shishi as end-us
│ │ │ │ -00000610: 6572 2e0a 2a20 4164 6d69 6e69 7374 7261  er..* Administra
│ │ │ │ -00000620: 7469 6f6e 204d 616e 7561 6c3a 3a20 2020  tion Manual::   
│ │ │ │ -00000630: 2020 2020 4164 6d69 6e69 7374 7261 7469      Administrati
│ │ │ │ -00000640: 6e67 2073 6572 7665 7220 6173 7065 6374  ng server aspect
│ │ │ │ -00000650: 7320 6f66 2053 6869 7368 692e 0a2a 2052  s of Shishi..* R
│ │ │ │ -00000660: 6566 6572 656e 6365 204d 616e 7561 6c3a  eference Manual:
│ │ │ │ -00000670: 3a20 2020 2020 2020 2020 2020 2044 6574  :            Det
│ │ │ │ -00000680: 6169 6c65 6420 6465 7363 7269 7074 696f  ailed descriptio
│ │ │ │ -00000690: 6e20 6f66 2063 6f6e 6669 6720 6669 6c65  n of config file
│ │ │ │ -000006a0: 732c 2065 7463 2e0a 2a20 5072 6f67 7261  s, etc..* Progra
│ │ │ │ -000006b0: 6d6d 696e 6720 4d61 6e75 616c 3a3a 2020  mming Manual::  
│ │ │ │ -000006c0: 2020 2020 2020 2020 4361 6c6c 696e 6720          Calling 
│ │ │ │ -000006d0: 5368 6973 6869 2066 726f 6d20 6120 7072  Shishi from a pr
│ │ │ │ -000006e0: 6f67 7261 6d6d 696e 6720 6c61 6e67 7561  ogramming langua
│ │ │ │ -000006f0: 6765 2e0a 2a20 4163 6b6e 6f77 6c65 6467  ge..* Acknowledg
│ │ │ │ -00000700: 656d 656e 7473 3a3a 2020 2020 2020 2020  ements::        
│ │ │ │ -00000710: 2020 2020 5768 6f6d 2074 6f20 626c 616d      Whom to blam
│ │ │ │ -00000720: 652e 0a0a 4170 7065 6e64 6963 6573 0a0a  e...Appendices..
│ │ │ │ -00000730: 2a20 4372 6974 6963 6973 6d20 6f66 204b  * Criticism of K
│ │ │ │ -00000740: 6572 6265 726f 733a 3a20 2020 2020 2020  erberos::       
│ │ │ │ -00000750: 5768 7920 796f 7520 6d61 7962 6520 7368  Why you maybe sh
│ │ │ │ -00000760: 6f75 6c64 6e27 7420 7573 6520 4b65 7262  ouldn't use Kerb
│ │ │ │ -00000770: 6572 6f73 2e0a 2a20 5072 6f74 6f63 6f6c  eros..* Protocol
│ │ │ │ -00000780: 2045 7874 656e 7369 6f6e 733a 3a20 2020   Extensions::   
│ │ │ │ -00000790: 2020 2020 2020 4465 7363 7269 7074 696f        Descriptio
│ │ │ │ -000007a0: 6e20 6f66 2070 726f 746f 636f 6c20 6578  n of protocol ex
│ │ │ │ -000007b0: 7465 6e73 696f 6e73 2075 7365 642e 0a2a  tensions used..*
│ │ │ │ -000007c0: 2043 6f70 7969 6e67 2049 6e66 6f72 6d61   Copying Informa
│ │ │ │ -000007d0: 7469 6f6e 3a3a 2020 2020 2020 2020 2048  tion::         H
│ │ │ │ -000007e0: 6f77 2079 6f75 2063 616e 2063 6f70 7920  ow you can copy 
│ │ │ │ -000007f0: 616e 6420 7368 6172 6520 5368 6973 6869  and share Shishi
│ │ │ │ -00000800: 2e0a 0a49 6e64 6963 6573 0a0a 2a20 4675  ...Indices..* Fu
│ │ │ │ -00000810: 6e63 7469 6f6e 2061 6e64 2044 6174 6120  nction and Data 
│ │ │ │ -00000820: 496e 6465 783a 3a20 2020 2020 496e 6465  Index::     Inde
│ │ │ │ -00000830: 7820 6f66 2066 756e 6374 696f 6e73 2c20  x of functions, 
│ │ │ │ -00000840: 7661 7269 6162 6c65 7320 616e 6420 6461  variables and da
│ │ │ │ -00000850: 7461 2074 7970 6573 2e0a 2a20 436f 6e63  ta types..* Conc
│ │ │ │ -00000860: 6570 7420 496e 6465 783a 3a20 2020 2020  ept Index::     
│ │ │ │ -00000870: 2020 2020 2020 2020 2020 496e 6465 7820            Index 
│ │ │ │ -00000880: 6f66 2063 6f6e 6365 7074 7320 616e 6420  of concepts and 
│ │ │ │ -00000890: 7072 6f67 7261 6d73 2e0a 0a1f 0a46 696c  programs.....Fil
│ │ │ │ -000008a0: 653a 2073 6869 7368 692e 696e 666f 2c20  e: shishi.info, 
│ │ │ │ -000008b0: 204e 6f64 653a 2049 6e74 726f 6475 6374   Node: Introduct
│ │ │ │ -000008c0: 696f 6e2c 2020 4e65 7874 3a20 5573 6572  ion,  Next: User
│ │ │ │ -000008d0: 204d 616e 7561 6c2c 2020 5072 6576 3a20   Manual,  Prev: 
│ │ │ │ -000008e0: 546f 702c 2020 5570 3a20 546f 700a 0a31  Top,  Up: Top..1
│ │ │ │ -000008f0: 2049 6e74 726f 6475 6374 696f 6e0a 2a2a   Introduction.**
│ │ │ │ -00000900: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a 5368  ************..Sh
│ │ │ │ -00000910: 6973 6869 2069 6d70 6c65 6d65 6e74 7320  ishi implements 
│ │ │ │ -00000920: 7468 6520 4b65 7262 6572 6f73 206e 6574  the Kerberos net
│ │ │ │ -00000930: 776f 726b 2061 7574 6865 6e74 6963 6174  work authenticat
│ │ │ │ -00000940: 696f 6e20 7379 7374 656d 2e20 2053 6869  ion system.  Shi
│ │ │ │ -00000950: 7368 690a 6361 6e20 6265 2075 7365 6420  shi.can be used 
│ │ │ │ -00000960: 746f 2061 7574 6865 6e74 6963 6174 6520  to authenticate 
│ │ │ │ -00000970: 7573 6572 7320 696e 2064 6973 7472 6962  users in distrib
│ │ │ │ -00000980: 7574 6564 2073 7973 7465 6d73 2c20 616e  uted systems, an
│ │ │ │ -00000990: 6420 6973 206d 6f73 740a 6f66 7465 6e20  d is most.often 
│ │ │ │ -000009a0: 7573 6564 2076 6961 2047 5353 2d41 5049  used via GSS-API
│ │ │ │ -000009b0: 2066 6f72 2053 5348 206f 7220 7669 6120   for SSH or via 
│ │ │ │ -000009c0: 5341 534c 2066 6f72 2049 4d41 502f 504f  SASL for IMAP/PO
│ │ │ │ -000009d0: 5033 2e0a 0a20 2020 5368 6973 6869 2063  P3...   Shishi c
│ │ │ │ -000009e0: 6f6e 7461 696e 7320 6120 6c69 6272 6172  ontains a librar
│ │ │ │ -000009f0: 7920 2827 6c69 6273 6869 7368 6927 2920  y ('libshishi') 
│ │ │ │ -00000a00: 7468 6174 2063 616e 2062 6520 7573 6564  that can be used
│ │ │ │ -00000a10: 2062 790a 6170 706c 6963 6174 696f 6e20   by.application 
│ │ │ │ -00000a20: 6465 7665 6c6f 7065 7273 2074 6f20 6164  developers to ad
│ │ │ │ -00000a30: 6420 7375 7070 6f72 7420 666f 7220 4b65  d support for Ke
│ │ │ │ -00000a40: 7262 6572 6f73 2035 2e20 2054 6865 7265  rberos 5.  There
│ │ │ │ -00000a50: 2069 7320 616c 736f 2061 0a63 6f6d 6d61   is also a.comma
│ │ │ │ -00000a60: 6e64 206c 696e 6520 7574 696c 6974 7920  nd line utility 
│ │ │ │ -00000a70: 2827 7368 6973 6869 2729 2074 6861 7420  ('shishi') that 
│ │ │ │ -00000a80: 6973 2075 7365 6420 6279 2075 7365 7273  is used by users
│ │ │ │ -00000a90: 2074 6f20 6163 7175 6972 6520 616e 640a   to acquire and.
│ │ │ │ -00000aa0: 6d61 6e61 6765 2074 6963 6b65 7473 2e20  manage tickets. 
│ │ │ │ -00000ab0: 2054 6865 2073 6572 7665 7220 7369 6465   The server side
│ │ │ │ -00000ac0: 2c20 6120 4b65 7920 4469 7374 7269 6275  , a Key Distribu
│ │ │ │ -00000ad0: 7469 6f6e 2043 656e 7465 722c 2069 730a  tion Center, is.
│ │ │ │ -00000ae0: 696d 706c 656d 656e 7465 6420 6279 2027  implemented by '
│ │ │ │ -00000af0: 7368 6973 6869 6427 2e20 204f 6620 636f  shishid'.  Of co
│ │ │ │ -00000b00: 7572 7365 2c20 6120 6d61 6e75 616c 2064  urse, a manual d
│ │ │ │ -00000b10: 6f63 756d 656e 7469 6e67 2075 7361 6765  ocumenting usage
│ │ │ │ -00000b20: 2061 7370 6563 7473 0a61 7320 7765 6c6c   aspects.as well
│ │ │ │ -00000b30: 2061 7320 7468 6520 7072 6f67 7261 6d6d   as the programm
│ │ │ │ -00000b40: 696e 6720 4150 4920 6973 2069 6e63 6c75  ing API is inclu
│ │ │ │ -00000b50: 6465 642e 0a0a 2020 2053 6869 7368 6920  ded...   Shishi 
│ │ │ │ -00000b60: 6375 7272 656e 746c 7920 7375 7070 6f72  currently suppor
│ │ │ │ -00000b70: 7473 2041 532f 5447 5320 6578 6368 616e  ts AS/TGS exchan
│ │ │ │ -00000b80: 6765 7320 666f 7220 6163 7175 6972 696e  ges for acquirin
│ │ │ │ -00000b90: 6720 7469 636b 6574 732c 0a70 7265 2d61  g tickets,.pre-a
│ │ │ │ -00000ba0: 7574 6865 6e74 6963 6174 696f 6e2c 2074  uthentication, t
│ │ │ │ -00000bb0: 6865 2041 5020 6578 6368 616e 6765 2066  he AP exchange f
│ │ │ │ -00000bc0: 6f72 2070 6572 666f 726d 696e 6720 636c  or performing cl
│ │ │ │ -00000bd0: 6965 6e74 2061 6e64 2073 6572 7665 720a  ient and server.
│ │ │ │ -00000be0: 6175 7468 656e 7469 6361 7469 6f6e 2c20  authentication, 
│ │ │ │ -00000bf0: 616e 6420 5341 4645 2f50 5249 5620 666f  and SAFE/PRIV fo
│ │ │ │ -00000c00: 7220 696e 7465 6772 6974 792f 7072 6976  r integrity/priv
│ │ │ │ -00000c10: 6163 7920 7072 6f74 6563 7465 640a 6170  acy protected.ap
│ │ │ │ -00000c20: 706c 6963 6174 696f 6e20 6461 7461 2065  plication data e
│ │ │ │ -00000c30: 7863 6861 6e67 6573 2e0a 0a20 2020 5368  xchanges...   Sh
│ │ │ │ -00000c40: 6973 6869 2069 7320 696e 7465 726e 6174  ishi is internat
│ │ │ │ -00000c50: 696f 6e61 6c69 7a65 643b 2065 7272 6f72  ionalized; error
│ │ │ │ -00000c60: 2061 6e64 2073 7461 7475 7320 6d65 7373   and status mess
│ │ │ │ -00000c70: 6167 6573 2063 616e 2062 650a 7472 616e  ages can be.tran
│ │ │ │ -00000c80: 736c 6174 6564 2069 6e74 6f20 7468 6520  slated into the 
│ │ │ │ -00000c90: 7573 6572 7327 206c 616e 6775 6167 653b  users' language;
│ │ │ │ -00000ca0: 2075 7365 7220 6e61 6d65 2061 6e64 2070   user name and p
│ │ │ │ -00000cb0: 6173 7377 6f72 6473 2063 616e 2062 650a  asswords can be.
│ │ │ │ -00000cc0: 636f 6e76 6572 7465 6420 696e 746f 2061  converted into a
│ │ │ │ -00000cd0: 6e79 2061 7661 696c 6162 6c65 2063 6861  ny available cha
│ │ │ │ -00000ce0: 7261 6374 6572 2073 6574 2028 6e6f 726d  racter set (norm
│ │ │ │ -00000cf0: 616c 6c79 2069 6e63 6c75 6469 6e67 0a49  ally including.I
│ │ │ │ -00000d00: 534f 2d38 3835 392d 3120 616e 6420 5554  SO-8859-1 and UT
│ │ │ │ -00000d10: 462d 3829 2061 6e64 2061 6c73 6f20 6265  F-8) and also be
│ │ │ │ -00000d20: 2070 726f 6365 7373 6564 2075 7369 6e67   processed using
│ │ │ │ -00000d30: 2061 6e20 6578 7065 7269 6d65 6e74 616c   an experimental
│ │ │ │ -00000d40: 0a53 7472 696e 6770 7265 7020 7072 6f66  .Stringprep prof
│ │ │ │ -00000d50: 696c 652e 0a0a 2020 204d 6f73 742c 2069  ile...   Most, i
│ │ │ │ -00000d60: 6620 6e6f 7420 616c 6c2c 206f 6620 7468  f not all, of th
│ │ │ │ -00000d70: 6520 7769 6465 6c79 2075 7365 6420 656e  e widely used en
│ │ │ │ -00000d80: 6372 7970 7469 6f6e 2061 6e64 2063 6865  cryption and che
│ │ │ │ -00000d90: 636b 7375 6d20 7479 7065 730a 6172 6520  cksum types.are 
│ │ │ │ -00000da0: 7375 7070 6f72 7465 642c 2073 7563 6820  supported, such 
│ │ │ │ -00000db0: 6173 2033 4445 532c 2041 4553 2c20 4152  as 3DES, AES, AR
│ │ │ │ -00000dc0: 4346 4f55 5220 616e 6420 484d 4143 2d53  CFOUR and HMAC-S
│ │ │ │ -00000dd0: 4841 312e 0a0a 2020 2053 6869 7368 6920  HA1...   Shishi 
│ │ │ │ -00000de0: 6973 2064 6576 656c 6f70 6564 2066 6f72  is developed for
│ │ │ │ -00000df0: 2074 6865 2047 4e55 2f4c 696e 7578 2073   the GNU/Linux s
│ │ │ │ -00000e00: 7973 7465 6d20 6275 7420 776f 726b 7320  ystem but works 
│ │ │ │ -00000e10: 6f6e 206d 616e 790a 706c 6174 666f 726d  on many.platform
│ │ │ │ -00000e20: 7320 696e 636c 7564 696e 6720 6d6f 7374  s including most
│ │ │ │ -00000e30: 206d 616a 6f72 2055 6e69 7820 616e 6420   major Unix and 
│ │ │ │ -00000e40: 5769 6e64 6f77 7320 7379 7374 656d 732e  Windows systems.
│ │ │ │ -00000e50: 0a0a 2020 2053 6869 7368 6920 6973 2066  ..   Shishi is f
│ │ │ │ -00000e60: 7265 6520 736f 6674 7761 7265 206c 6963  ree software lic
│ │ │ │ -00000e70: 656e 7365 6420 756e 6465 7220 7468 6520  ensed under the 
│ │ │ │ -00000e80: 474e 5520 4765 6e65 7261 6c20 5075 626c  GNU General Publ
│ │ │ │ -00000e90: 6963 204c 6963 656e 7365 0a76 6572 7369  ic License.versi
│ │ │ │ -00000ea0: 6f6e 2033 2e30 206f 7220 6c61 7465 722e  on 3.0 or later.
│ │ │ │ -00000eb0: 0a0a 2a20 4d65 6e75 3a0a 0a2a 2047 6574  ..* Menu:..* Get
│ │ │ │ -00000ec0: 7469 6e67 2053 7461 7274 6564 3a3a 0a2a  ting Started::.*
│ │ │ │ -00000ed0: 2046 6561 7475 7265 7320 616e 6420 5374   Features and St
│ │ │ │ -00000ee0: 6174 7573 3a3a 0a2a 204f 7665 7276 6965  atus::.* Overvie
│ │ │ │ -00000ef0: 773a 3a0a 2a20 4372 7970 746f 6772 6170  w::.* Cryptograp
│ │ │ │ -00000f00: 6869 6320 4f76 6572 7669 6577 3a3a 0a2a  hic Overview::.*
│ │ │ │ -00000f10: 2053 7570 706f 7274 6564 2050 6c61 7466   Supported Platf
│ │ │ │ -00000f20: 6f72 6d73 3a3a 0a2a 2047 6574 7469 6e67  orms::.* Getting
│ │ │ │ -00000f30: 2068 656c 703a 3a0a 2a20 446f 776e 6c6f   help::.* Downlo
│ │ │ │ -00000f40: 6164 696e 6720 616e 6420 496e 7374 616c  ading and Instal
│ │ │ │ -00000f50: 6c69 6e67 3a3a 0a2a 2042 7567 2052 6570  ling::.* Bug Rep
│ │ │ │ -00000f60: 6f72 7473 3a3a 0a2a 2043 6f6e 7472 6962  orts::.* Contrib
│ │ │ │ -00000f70: 7574 696e 673a 3a0a 0a1f 0a46 696c 653a  uting::....File:
│ │ │ │ -00000f80: 2073 6869 7368 692e 696e 666f 2c20 204e   shishi.info,  N
│ │ │ │ -00000f90: 6f64 653a 2047 6574 7469 6e67 2053 7461  ode: Getting Sta
│ │ │ │ -00000fa0: 7274 6564 2c20 204e 6578 743a 2046 6561  rted,  Next: Fea
│ │ │ │ -00000fb0: 7475 7265 7320 616e 6420 5374 6174 7573  tures and Status
│ │ │ │ -00000fc0: 2c20 2055 703a 2049 6e74 726f 6475 6374  ,  Up: Introduct
│ │ │ │ -00000fd0: 696f 6e0a 0a31 2e31 2047 6574 7469 6e67  ion..1.1 Getting
│ │ │ │ -00000fe0: 2053 7461 7274 6564 0a3d 3d3d 3d3d 3d3d   Started.=======
│ │ │ │ -00000ff0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 5468  ============..Th
│ │ │ │ -00001000: 6973 206d 616e 7561 6c20 646f 6375 6d65  is manual docume
│ │ │ │ -00001010: 6e74 7320 7468 6520 5368 6973 6869 2061  nts the Shishi a
│ │ │ │ -00001020: 7070 6c69 6361 7469 6f6e 2061 6e64 206c  pplication and l
│ │ │ │ -00001030: 6962 7261 7279 2070 726f 6772 616d 6d69  ibrary programmi
│ │ │ │ -00001040: 6e67 0a69 6e74 6572 6661 6365 2e20 2041  ng.interface.  A
│ │ │ │ -00001050: 6c6c 2063 6f6d 6d61 6e64 732c 2066 756e  ll commands, fun
│ │ │ │ -00001060: 6374 696f 6e73 2061 6e64 2064 6174 6120  ctions and data 
│ │ │ │ -00001070: 7479 7065 7320 7072 6f76 6964 6564 2062  types provided b
│ │ │ │ -00001080: 7920 5368 6973 6869 0a61 7265 2065 7870  y Shishi.are exp
│ │ │ │ -00001090: 6c61 696e 6564 2e0a 0a20 2020 5468 6520  lained...   The 
│ │ │ │ -000010a0: 7265 6164 6572 2069 7320 6173 7375 6d65  reader is assume
│ │ │ │ -000010b0: 6420 746f 2070 6f73 7365 7373 2062 6173  d to possess bas
│ │ │ │ -000010c0: 6963 2066 616d 696c 6961 7269 7479 2077  ic familiarity w
│ │ │ │ -000010d0: 6974 6820 6e65 7477 6f72 6b0a 7365 6375  ith network.secu
│ │ │ │ -000010e0: 7269 7479 2061 6e64 2074 6865 204b 6572  rity and the Ker
│ │ │ │ -000010f0: 6265 726f 7320 3520 7365 6375 7269 7479  beros 5 security
│ │ │ │ -00001100: 2073 7973 7465 6d2e 0a0a 2020 2054 6869   system...   Thi
│ │ │ │ -00001110: 7320 6d61 6e75 616c 2063 616e 2062 6520  s manual can be 
│ │ │ │ -00001120: 7573 6564 2069 6e20 7365 7665 7261 6c20  used in several 
│ │ │ │ -00001130: 7761 7973 2e20 2049 6620 7265 6164 2066  ways.  If read f
│ │ │ │ -00001140: 726f 6d20 7468 6520 6265 6769 6e6e 696e  rom the beginnin
│ │ │ │ -00001150: 670a 746f 2074 6865 2065 6e64 2c20 6974  g.to the end, it
│ │ │ │ -00001160: 2067 6976 6573 2061 2067 6f6f 6420 696e   gives a good in
│ │ │ │ -00001170: 7472 6f64 7563 7469 6f6e 2069 6e74 6f20  troduction into 
│ │ │ │ -00001180: 7468 6520 6c69 6272 6172 7920 616e 6420  the library and 
│ │ │ │ -00001190: 686f 7720 6974 2063 616e 0a62 6520 7573  how it can.be us
│ │ │ │ -000011a0: 6564 2069 6e20 616e 2061 7070 6c69 6361  ed in an applica
│ │ │ │ -000011b0: 7469 6f6e 2e20 2046 6f72 7761 7264 2072  tion.  Forward r
│ │ │ │ -000011c0: 6566 6572 656e 6365 7320 6172 6520 696e  eferences are in
│ │ │ │ -000011d0: 636c 7564 6564 2077 6865 7265 0a6e 6563  cluded where.nec
│ │ │ │ -000011e0: 6573 7361 7279 2e20 204c 6174 6572 206f  essary.  Later o
│ │ │ │ -000011f0: 6e2c 2074 6865 206d 616e 7561 6c20 6361  n, the manual ca
│ │ │ │ -00001200: 6e20 6265 2075 7365 6420 6173 2061 2072  n be used as a r
│ │ │ │ -00001210: 6566 6572 656e 6365 206d 616e 7561 6c20  eference manual 
│ │ │ │ -00001220: 746f 0a67 6574 206a 7573 7420 7468 6520  to.get just the 
│ │ │ │ -00001230: 696e 666f 726d 6174 696f 6e20 6e65 6564  information need
│ │ │ │ -00001240: 6564 2061 626f 7574 2061 6e79 2070 6172  ed about any par
│ │ │ │ -00001250: 7469 6375 6c61 7220 696e 7465 7266 6163  ticular interfac
│ │ │ │ -00001260: 6520 6f66 2074 6865 0a6c 6962 7261 7279  e of the.library
│ │ │ │ -00001270: 2e20 2045 7870 6572 6965 6e63 6564 2070  .  Experienced p
│ │ │ │ -00001280: 726f 6772 616d 6d65 7273 206d 6967 6874  rogrammers might
│ │ │ │ -00001290: 2077 616e 7420 746f 2073 7461 7274 206c   want to start l
│ │ │ │ -000012a0: 6f6f 6b69 6e67 2061 7420 7468 650a 6578  ooking at the.ex
│ │ │ │ -000012b0: 616d 706c 6573 2061 7420 7468 6520 656e  amples at the en
│ │ │ │ -000012c0: 6420 6f66 2074 6865 206d 616e 7561 6c2c  d of the manual,
│ │ │ │ -000012d0: 2061 6e64 2074 6865 6e20 6f6e 6c79 2072   and then only r
│ │ │ │ -000012e0: 6561 6420 7570 206f 6e20 7468 6f73 6520  ead up on those 
│ │ │ │ -000012f0: 7061 7274 730a 6f66 2074 6865 2069 6e74  parts.of the int
│ │ │ │ -00001300: 6572 6661 6365 2077 6869 6368 2061 7265  erface which are
│ │ │ │ -00001310: 2075 6e63 6c65 6172 2e0a 0a1f 0a46 696c   unclear.....Fil
│ │ │ │ -00001320: 653a 2073 6869 7368 692e 696e 666f 2c20  e: shishi.info, 
│ │ │ │ -00001330: 204e 6f64 653a 2046 6561 7475 7265 7320   Node: Features 
│ │ │ │ -00001340: 616e 6420 5374 6174 7573 2c20 204e 6578  and Status,  Nex
│ │ │ │ -00001350: 743a 204f 7665 7276 6965 772c 2020 5072  t: Overview,  Pr
│ │ │ │ -00001360: 6576 3a20 4765 7474 696e 6720 5374 6172  ev: Getting Star
│ │ │ │ -00001370: 7465 642c 2020 5570 3a20 496e 7472 6f64  ted,  Up: Introd
│ │ │ │ -00001380: 7563 7469 6f6e 0a0a 312e 3220 4665 6174  uction..1.2 Feat
│ │ │ │ -00001390: 7572 6573 2061 6e64 2053 7461 7475 730a  ures and Status.
│ │ │ │ -000013a0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ -000013b0: 3d3d 3d3d 3d3d 3d0a 0a53 6869 7368 6920  =======..Shishi 
│ │ │ │ -000013c0: 6d69 6768 7420 6861 7665 2061 2063 6f75  might have a cou
│ │ │ │ -000013d0: 706c 6520 6f66 2061 6476 616e 7461 6765  ple of advantage
│ │ │ │ -000013e0: 7320 6f76 6572 206f 7468 6572 2070 6163  s over other pac
│ │ │ │ -000013f0: 6b61 6765 7320 646f 696e 6720 610a 7369  kages doing a.si
│ │ │ │ -00001400: 6d69 6c61 7220 6a6f 622e 0a0a 4974 2773  milar job...It's
│ │ │ │ -00001410: 2046 7265 6520 536f 6674 7761 7265 0a20   Free Software. 
│ │ │ │ -00001420: 2020 2020 416e 7962 6f64 7920 6361 6e20      Anybody can 
│ │ │ │ -00001430: 7573 652c 206d 6f64 6966 792c 2061 6e64  use, modify, and
│ │ │ │ -00001440: 2072 6564 6973 7472 6962 7574 6520 6974   redistribute it
│ │ │ │ -00001450: 2075 6e64 6572 2074 6865 2074 6572 6d73   under the terms
│ │ │ │ -00001460: 206f 6620 7468 650a 2020 2020 2047 4e55   of the.     GNU
│ │ │ │ -00001470: 2047 656e 6572 616c 2050 7562 6c69 6320   General Public 
│ │ │ │ -00001480: 4c69 6365 6e73 6520 7665 7273 696f 6e20  License version 
│ │ │ │ -00001490: 332e 3020 6f72 206c 6174 6572 2e0a 0a49  3.0 or later...I
│ │ │ │ -000014a0: 7427 7320 7468 7265 6164 2d73 6166 650a  t's thread-safe.
│ │ │ │ -000014b0: 2020 2020 2054 6865 206c 6962 7261 7279       The library
│ │ │ │ -000014c0: 2075 7365 7320 6e6f 2067 6c6f 6261 6c20   uses no global 
│ │ │ │ -000014d0: 7661 7269 6162 6c65 732e 0a0a 4974 2773  variables...It's
│ │ │ │ -000014e0: 2069 6e74 6572 6e61 7469 6f6e 616c 697a   internationaliz
│ │ │ │ -000014f0: 6564 0a20 2020 2020 4974 2068 616e 646c  ed.     It handl
│ │ │ │ -00001500: 6573 206e 6f6e 2d41 5343 4949 2075 7365  es non-ASCII use
│ │ │ │ -00001510: 726e 616d 6520 616e 6420 7061 7373 776f  rname and passwo
│ │ │ │ -00001520: 7264 732c 2061 6e64 2075 7365 7220 7669  rds, and user vi
│ │ │ │ -00001530: 7369 626c 650a 2020 2020 2073 7472 696e  sible.     strin
│ │ │ │ -00001540: 6773 2075 7365 6420 696e 2074 6865 206c  gs used in the l
│ │ │ │ -00001550: 6962 7261 7279 2028 6572 726f 7220 6d65  ibrary (error me
│ │ │ │ -00001560: 7373 6167 6573 2920 6361 6e20 6265 2074  ssages) can be t
│ │ │ │ -00001570: 7261 6e73 6c61 7465 6420 696e 746f 0a20  ranslated into. 
│ │ │ │ -00001580: 2020 2020 7468 6520 7573 6572 7327 206c      the users' l
│ │ │ │ -00001590: 616e 6775 6167 652e 0a0a 4974 2773 2070  anguage...It's p
│ │ │ │ -000015a0: 6f72 7461 626c 650a 2020 2020 2049 7420  ortable.     It 
│ │ │ │ -000015b0: 7368 6f75 6c64 2077 6f72 6b20 6f6e 2061  should work on a
│ │ │ │ -000015c0: 6c6c 2055 6e69 7820 6c69 6b65 206f 7065  ll Unix like ope
│ │ │ │ -000015d0: 7261 7469 6e67 2073 7973 7465 6d73 2c20  rating systems, 
│ │ │ │ -000015e0: 696e 636c 7564 696e 670a 2020 2020 2057  including.     W
│ │ │ │ -000015f0: 696e 646f 7773 2e0a 0a20 2020 5368 6973  indows...   Shis
│ │ │ │ -00001600: 6869 2069 7320 6661 7220 6672 6f6d 2066  hi is far from f
│ │ │ │ -00001610: 6561 7475 7265 2063 6f6d 706c 6574 652c  eature complete,
│ │ │ │ -00001620: 2069 7420 6973 206e 6f74 2065 7665 6e20   it is not even 
│ │ │ │ -00001630: 6120 6675 6c6c 2052 4643 2034 3132 300a  a full RFC 4120.
│ │ │ │ -00001640: 696d 706c 656d 656e 7461 7469 6f6e 2079  implementation y
│ │ │ │ -00001650: 6574 2e20 2048 6f77 6576 6572 2c20 736f  et.  However, so
│ │ │ │ -00001660: 6d65 2062 6173 6963 2066 756e 6374 696f  me basic functio
│ │ │ │ -00001670: 6e61 6c69 7479 2069 7320 696d 706c 656d  nality is implem
│ │ │ │ -00001680: 656e 7465 642e 0a41 2066 6577 2069 6d70  ented..A few imp
│ │ │ │ -00001690: 6c65 6d65 6e74 6564 2066 6561 7475 7265  lemented feature
│ │ │ │ -000016a0: 2061 7265 206d 656e 7469 6f6e 6564 2062   are mentioned b
│ │ │ │ -000016b0: 656c 6f77 2e0a 0a20 2020 e280 a220 496e  elow...   ... In
│ │ │ │ -000016c0: 6974 6961 6c20 6175 7468 656e 7469 6361  itial authentica
│ │ │ │ -000016d0: 7469 6f6e 2028 4153 2920 6672 6f6d 2072  tion (AS) from r
│ │ │ │ -000016e0: 6177 206b 6579 206f 7220 7061 7373 776f  aw key or passwo
│ │ │ │ -000016f0: 7264 2e20 2054 6869 7320 7374 6570 2069  rd.  This step i
│ │ │ │ -00001700: 730a 2020 2020 2074 7970 6963 616c 6c79  s.     typically
│ │ │ │ -00001710: 2075 7365 6420 746f 2061 6371 7569 7265   used to acquire
│ │ │ │ -00001720: 2061 2074 6963 6b65 7420 6772 616e 7469   a ticket granti
│ │ │ │ -00001730: 6e67 2074 6963 6b65 7420 616e 642c 206c  ng ticket and, l
│ │ │ │ -00001740: 6573 730a 2020 2020 2063 6f6d 6d6f 6e6c  ess.     commonl
│ │ │ │ -00001750: 792c 2061 2073 6572 7665 7220 7469 636b  y, a server tick
│ │ │ │ -00001760: 6574 2e0a 0a20 2020 e280 a220 5375 6273  et...   ... Subs
│ │ │ │ -00001770: 6571 7565 6e74 2061 7574 6865 6e74 6963  equent authentic
│ │ │ │ -00001780: 6174 696f 6e20 2854 4753 292e 2054 6869  ation (TGS). Thi
│ │ │ │ -00001790: 7320 7374 6570 2069 7320 7479 7069 6361  s step is typica
│ │ │ │ -000017a0: 6c6c 7920 7573 6564 2074 6f0a 2020 2020  lly used to.    
│ │ │ │ -000017b0: 2061 6371 7569 7265 2061 2073 6572 7665   acquire a serve
│ │ │ │ -000017c0: 7220 7469 636b 6574 2c20 6279 2061 7574  r ticket, by aut
│ │ │ │ -000017d0: 6865 6e74 6963 6174 696e 6720 796f 7572  henticating your
│ │ │ │ -000017e0: 7365 6c66 2075 7369 6e67 2074 6865 0a20  self using the. 
│ │ │ │ -000017f0: 2020 2020 7469 636b 6574 2067 7261 6e74      ticket grant
│ │ │ │ -00001800: 696e 6720 7469 636b 6574 2e0a 0a20 2020  ing ticket...   
│ │ │ │ -00001810: e280 a220 436c 6965 6e74 2d53 6572 7665  ... Client-Serve
│ │ │ │ -00001820: 7220 6175 7468 656e 7469 6361 7469 6f6e  r authentication
│ │ │ │ -00001830: 2028 4150 292e 2054 6869 7320 7374 6570   (AP). This step
│ │ │ │ -00001840: 2069 7320 7573 6564 2062 7920 636c 6965   is used by clie
│ │ │ │ -00001850: 6e74 7320 616e 640a 2020 2020 2073 6572  nts and.     ser
│ │ │ │ -00001860: 7665 7273 2074 6f20 7072 6f76 6520 746f  vers to prove to
│ │ │ │ -00001870: 2065 6163 6820 6f74 6865 7220 7768 6f20   each other who 
│ │ │ │ -00001880: 7468 6579 2061 7265 2c20 7573 696e 6720  they are, using 
│ │ │ │ -00001890: 6e65 676f 7469 6174 6564 0a20 2020 2020  negotiated.     
│ │ │ │ -000018a0: 7469 636b 6574 732e 0a0a 2020 20e2 80a2  tickets...   ...
│ │ │ │ -000018b0: 2049 6e74 6567 7269 7479 2070 726f 7465   Integrity prote
│ │ │ │ -000018c0: 6374 6564 2063 6f6d 6d75 6e69 6361 7469  cted communicati
│ │ │ │ -000018d0: 6f6e 2028 5341 4645 292e 2054 6869 7320  on (SAFE). This 
│ │ │ │ -000018e0: 7374 6570 2069 7320 7573 6564 2062 790a  step is used by.
│ │ │ │ -000018f0: 2020 2020 2063 6c69 656e 7473 2061 6e64       clients and
│ │ │ │ -00001900: 2073 6572 7665 7273 2074 6f20 6578 6368   servers to exch
│ │ │ │ -00001910: 616e 6765 2069 6e74 6567 7269 7479 2070  ange integrity p
│ │ │ │ -00001920: 726f 7465 6374 6564 2064 6174 6120 7769  rotected data wi
│ │ │ │ -00001930: 7468 2065 6163 680a 2020 2020 206f 7468  th each.     oth
│ │ │ │ -00001940: 6572 2e20 2054 6865 206b 6579 2069 7320  er.  The key is 
│ │ │ │ -00001950: 7479 7069 6361 6c6c 7920 6167 7265 6564  typically agreed
│ │ │ │ -00001960: 206f 6e20 7573 696e 6720 7468 6520 436c   on using the Cl
│ │ │ │ -00001970: 6965 6e74 2d53 6572 7665 720a 2020 2020  ient-Server.    
│ │ │ │ -00001980: 2061 7574 6865 6e74 6963 6174 696f 6e20   authentication 
│ │ │ │ -00001990: 7374 6570 2e0a 0a20 2020 e280 a220 5469  step...   ... Ti
│ │ │ │ -000019a0: 636b 6574 2063 6163 6865 2c20 7375 7070  cket cache, supp
│ │ │ │ -000019b0: 6f72 7469 6e67 206d 756c 7469 706c 6520  orting multiple 
│ │ │ │ -000019c0: 7072 696e 6369 7061 6c73 2061 6e64 2072  principals and r
│ │ │ │ -000019d0: 6561 6c6d 732e 2020 4173 0a20 2020 2020  ealms.  As.     
│ │ │ │ -000019e0: 7469 636b 6574 7320 6861 7665 2061 206c  tickets have a l
│ │ │ │ -000019f0: 6966 6520 7469 6d65 206f 6620 7479 7069  ife time of typi
│ │ │ │ -00001a00: 6361 6c6c 7920 7365 7665 7261 6c20 686f  cally several ho
│ │ │ │ -00001a10: 7572 732c 2074 6865 7920 6172 650a 2020  urs, they are.  
│ │ │ │ -00001a20: 2020 206d 616e 6167 6564 2069 6e20 6469     managed in di
│ │ │ │ -00001a30: 736b 2066 696c 6573 2e20 2054 6865 7265  sk files.  There
│ │ │ │ -00001a40: 2063 616e 2062 6520 6d75 6c74 6970 6c65   can be multiple
│ │ │ │ -00001a50: 2074 6963 6b65 7420 6361 6368 6573 2c20   ticket caches, 
│ │ │ │ -00001a60: 616e 640a 2020 2020 2065 6163 6820 7469  and.     each ti
│ │ │ │ -00001a70: 636b 6574 2063 6163 6865 2063 616e 2073  cket cache can s
│ │ │ │ -00001a80: 746f 7265 2074 6963 6b65 7473 2066 6f72  tore tickets for
│ │ │ │ -00001a90: 206d 756c 7469 706c 6520 636c 6965 6e74   multiple client
│ │ │ │ -00001aa0: 7320 2875 7365 7273 292c 0a20 2020 2020  s (users),.     
│ │ │ │ -00001ab0: 7365 7276 6572 732c 2065 6e63 7279 7074  servers, encrypt
│ │ │ │ -00001ac0: 696f 6e20 7479 7065 732c 2065 7463 2e20  ion types, etc. 
│ │ │ │ -00001ad0: 2046 756e 6374 696f 6e61 6c69 7479 2069   Functionality i
│ │ │ │ -00001ae0: 7320 7072 6f76 6964 6564 2066 6f72 0a20  s provided for. 
│ │ │ │ -00001af0: 2020 2020 6c6f 6361 7469 6e67 2074 6865      locating the
│ │ │ │ -00001b00: 2070 726f 7065 7220 7469 636b 6574 2066   proper ticket f
│ │ │ │ -00001b10: 6f72 2065 7665 7279 2075 7365 2e0a 0a20  or every use... 
│ │ │ │ -00001b20: 2020 e280 a220 4d6f 7374 2073 7461 6e64    ... Most stand
│ │ │ │ -00001b30: 6172 6420 6372 7970 746f 6772 6170 6869  ard cryptographi
│ │ │ │ -00001b40: 6320 7072 696d 6974 6976 6573 2e20 2054  c primitives.  T
│ │ │ │ -00001b50: 6865 2062 656c 6965 7665 6420 6d6f 7374  he believed most
│ │ │ │ -00001b60: 2073 6563 7572 650a 2020 2020 2061 6c67   secure.     alg
│ │ │ │ -00001b70: 6f72 6974 686d 7320 6172 6520 7375 7070  orithms are supp
│ │ │ │ -00001b80: 6f72 7465 6420 282a 6e6f 7465 2043 7279  orted (*note Cry
│ │ │ │ -00001b90: 7074 6f67 7261 7068 6963 204f 7665 7276  ptographic Overv
│ │ │ │ -00001ba0: 6965 773a 3a29 2e0a 0a20 2020 e280 a220  iew::)...   ... 
│ │ │ │ -00001bb0: 5465 6c6e 6574 2063 6c69 656e 7420 616e  Telnet client an
│ │ │ │ -00001bc0: 6420 7365 7276 6572 2e20 2054 6869 7320  d server.  This 
│ │ │ │ -00001bd0: 6973 2075 7365 6420 746f 2072 656d 6f74  is used to remot
│ │ │ │ -00001be0: 656c 7920 6c6f 6769 6e20 746f 206f 7468  ely login to oth
│ │ │ │ -00001bf0: 6572 0a20 2020 2020 6d61 6368 696e 6573  er.     machines
│ │ │ │ -00001c00: 2c20 6166 7465 7220 6175 7468 656e 7469  , after authenti
│ │ │ │ -00001c10: 6361 7469 6e67 2079 6f75 7273 656c 6620  cating yourself 
│ │ │ │ -00001c20: 7769 7468 2061 2074 6963 6b65 742e 0a0a  with a ticket...
│ │ │ │ -00001c30: 2020 20e2 80a2 2050 414d 206d 6f64 756c     ... PAM modul
│ │ │ │ -00001c40: 652e 2020 5468 6973 2069 7320 7573 6564  e.  This is used
│ │ │ │ -00001c50: 2074 6f20 6c6f 6769 6e20 6c6f 6361 6c6c   to login locall
│ │ │ │ -00001c60: 7920 6f6e 2061 206d 6163 6869 6e65 2e0a  y on a machine..
│ │ │ │ -00001c70: 0a20 2020 e280 a220 4b44 4320 6164 6472  .   ... KDC addr
│ │ │ │ -00001c80: 6573 7365 7320 6c6f 6361 7465 6420 7573  esses located us
│ │ │ │ -00001c90: 696e 6720 444e 5320 5352 5620 5252 732e  ing DNS SRV RRs.
│ │ │ │ -00001ca0: 0a0a 2020 20e2 80a2 204d 6f64 756c 6172  ..   ... Modular
│ │ │ │ -00001cb0: 697a 6564 206c 6f77 2d6c 6576 656c 2063  ized low-level c
│ │ │ │ -00001cc0: 7279 7074 6f20 696e 7465 7266 6163 652e  rypto interface.
│ │ │ │ -00001cd0: 2020 4375 7272 656e 746c 7920 476e 756c    Currently Gnul
│ │ │ │ -00001ce0: 6962 2061 6e64 0a20 2020 2020 4c69 6267  ib and.     Libg
│ │ │ │ -00001cf0: 6372 7970 7420 6172 6520 7375 7070 6f72  crypt are suppor
│ │ │ │ -00001d00: 7465 642e 2020 4966 2079 6f75 2077 6973  ted.  If you wis
│ │ │ │ -00001d10: 6820 746f 2061 6464 2073 7570 706f 7274  h to add support
│ │ │ │ -00001d20: 2066 6f72 2061 6e6f 7468 6572 0a20 2020   for another.   
│ │ │ │ -00001d30: 2020 6c6f 772d 6c65 7665 6c20 6372 7970    low-level cryp
│ │ │ │ -00001d40: 746f 6772 6170 6869 6320 6c69 6272 6172  tographic librar
│ │ │ │ -00001d50: 792c 2079 6f75 206f 6e6c 7920 6861 7665  y, you only have
│ │ │ │ -00001d60: 2074 6f20 696d 706c 656d 656e 7420 6120   to implement a 
│ │ │ │ -00001d70: 6665 770a 2020 2020 2041 5049 7320 666f  few.     APIs fo
│ │ │ │ -00001d80: 7220 4445 532c 2041 4553 2c20 4d44 352c  r DES, AES, MD5,
│ │ │ │ -00001d90: 2053 4841 312c 2048 4d41 432c 2065 7463   SHA1, HMAC, etc
│ │ │ │ -00001da0: 2e20 204c 6f6f 6b20 6174 20e2 8098 676c  .  Look at ...gl
│ │ │ │ -00001db0: 2f67 632d 676e 756c 6962 2e63 e280 990a  /gc-gnulib.c....
│ │ │ │ -00001dc0: 2020 2020 206f 7220 e280 9867 6c2f 6763       or ...gl/gc
│ │ │ │ -00001dd0: 2d6c 6962 6763 7279 7074 2e63 e280 9920  -libgcrypt.c... 
│ │ │ │ -00001de0: 6173 2061 2073 7461 7274 696e 6720 706f  as a starting po
│ │ │ │ -00001df0: 696e 7465 722e 0a0a 2020 2054 6865 2066  inter...   The f
│ │ │ │ -00001e00: 6f6c 6c6f 7769 6e67 2074 6162 6c65 2073  ollowing table s
│ │ │ │ -00001e10: 756d 6d61 7269 7a65 2077 6861 7420 7468  ummarize what th
│ │ │ │ -00001e20: 6520 6375 7272 656e 7420 6f62 6a65 6374  e current object
│ │ │ │ -00001e30: 6976 6573 2061 7265 2028 692e 652e 2c0a  ives are (i.e.,.
│ │ │ │ -00001e40: 7468 6520 746f 646f 206c 6973 7429 2061  the todo list) a
│ │ │ │ -00001e50: 6e64 2061 6e20 6573 7469 6d61 7465 206f  nd an estimate o
│ │ │ │ -00001e60: 6e20 686f 7720 6c6f 6e67 2069 7420 7769  n how long it wi
│ │ │ │ -00001e70: 6c6c 2074 616b 6520 746f 2069 6d70 6c65  ll take to imple
│ │ │ │ -00001e80: 6d65 6e74 2074 6865 0a66 6561 7475 7265  ment the.feature
│ │ │ │ -00001e90: 2c20 696e 636c 7564 696e 6720 736f 6d65  , including some
│ │ │ │ -00001ea0: 2072 6561 736f 6e61 626c 6520 7374 6172   reasonable star
│ │ │ │ -00001eb0: 7475 702d 7469 6d65 2074 6f20 6765 7420  tup-time to get 
│ │ │ │ -00001ec0: 6661 6d69 6c69 6172 2077 6974 680a 5368  familiar with.Sh
│ │ │ │ -00001ed0: 6973 6869 2069 6e20 6765 6e65 7261 6c2e  ishi in general.
│ │ │ │ -00001ee0: 2020 4966 2079 6f75 206c 696b 6520 746f    If you like to
│ │ │ │ -00001ef0: 2073 7461 7274 2077 6f72 6b69 6e67 206f   start working o
│ │ │ │ -00001f00: 6e20 616e 7974 6869 6e67 2c20 706c 6561  n anything, plea
│ │ │ │ -00001f10: 7365 206c 6574 0a6d 6520 6b6e 6f77 2073  se let.me know s
│ │ │ │ -00001f20: 6f20 776f 726b 2064 7570 6c69 6361 7469  o work duplicati
│ │ │ │ -00001f30: 6f6e 2063 616e 2062 6520 6176 6f69 6465  on can be avoide
│ │ │ │ -00001f40: 642e 0a0a 2020 20e2 80a2 2050 6172 7365  d...   ... Parse
│ │ │ │ -00001f50: 20e2 8098 2f65 7463 2f6b 7262 352e 6b65   .../etc/krb5.ke
│ │ │ │ -00001f60: 7974 6162 e280 9920 746f 2065 7874 7261  ytab... to extra
│ │ │ │ -00001f70: 6374 206b 6579 7320 746f 2075 7365 2066  ct keys to use f
│ │ │ │ -00001f80: 6f72 2074 656c 6e65 7464 2065 7463 0a20  or telnetd etc. 
│ │ │ │ -00001f90: 2020 2020 2877 6565 6b29 0a0a 2020 20e2      (week)..   .
│ │ │ │ -00001fa0: 80a2 2043 726f 7373 2d72 6561 6c6d 2073  .. Cross-realm s
│ │ │ │ -00001fb0: 7570 706f 7274 2028 7765 656b 292e 0a0a  upport (week)...
│ │ │ │ -00001fc0: 2020 20e2 80a2 2050 4b49 4e49 5420 2875     ... PKINIT (u
│ │ │ │ -00001fd0: 7365 206c 6962 6b73 6261 2c20 7765 656b  se libksba, week
│ │ │ │ -00001fe0: 7329 0a0a 2020 20e2 80a2 2046 696e 6973  s)..   ... Finis
│ │ │ │ -00001ff0: 6820 4753 5341 5049 2073 7570 706f 7274  h GSSAPI support
│ │ │ │ -00002000: 2076 6961 2047 5353 4c69 6220 2877 6565   via GSSLib (wee
│ │ │ │ -00002010: 6b73 2920 5368 6973 6869 2077 696c 6c20  ks) Shishi will 
│ │ │ │ -00002020: 6e6f 7420 7375 7070 6f72 740a 2020 2020  not support.    
│ │ │ │ -00002030: 2047 5353 4c69 6220 6e61 7469 7665 6c79   GSSLib natively
│ │ │ │ -00002040: 2c20 6275 7420 6120 7365 7061 7261 7465  , but a separate
│ │ │ │ -00002050: 2070 726f 6a65 6374 2022 4753 534c 6962   project "GSSLib
│ │ │ │ -00002060: 2220 6973 2075 6e64 6572 2077 6179 2074  " is under way t
│ │ │ │ -00002070: 6f0a 2020 2020 2070 726f 6475 6365 2061  o.     produce a
│ │ │ │ -00002080: 2067 656e 6572 6963 2047 5353 2069 6d70   generic GSS imp
│ │ │ │ -00002090: 6c65 6d65 6e74 6174 696f 6e2c 2061 6e64  lementation, and
│ │ │ │ -000020a0: 2069 7420 7769 6c6c 2075 7365 2053 6869   it will use Shi
│ │ │ │ -000020b0: 7368 6920 746f 0a20 2020 2020 696d 706c  shi to.     impl
│ │ │ │ -000020c0: 656d 656e 7420 7468 6520 4b65 7262 6572  ement the Kerber
│ │ │ │ -000020d0: 6f73 2035 206d 6563 6861 6e69 736d 2e0a  os 5 mechanism..
│ │ │ │ -000020e0: 0a20 2020 e280 a220 506f 7274 2074 6f20  .   ... Port to 
│ │ │ │ -000020f0: 6379 636c 6f6e 6520 2863 7963 6c6f 6e65  cyclone (cyclone
│ │ │ │ -00002100: 206e 6565 6420 746f 206d 6174 7572 6520   need to mature 
│ │ │ │ -00002110: 6669 7273 7429 0a0a 2020 20e2 80a2 204d  first)..   ... M
│ │ │ │ -00002120: 6f64 756c 6172 697a 6520 4153 4e2e 3120  odularize ASN.1 
│ │ │ │ -00002130: 6c69 6272 6172 7920 736f 2069 7420 6361  library so it ca
│ │ │ │ -00002140: 6e20 6265 2072 6570 6c61 6365 6420 2864  n be replaced (d
│ │ │ │ -00002150: 6179 7329 2e20 2041 6c6d 6f73 740a 2020  ays).  Almost.  
│ │ │ │ -00002160: 2020 2064 6f6e 652c 2061 6c6c 2041 534e     done, all ASN
│ │ │ │ -00002170: 2e31 2066 756e 6374 696f 6e61 6c69 7479  .1 functionality
│ │ │ │ -00002180: 2069 7320 666f 756e 6420 696e 206c 6962   is found in lib
│ │ │ │ -00002190: 2f61 736e 312e 632c 2061 6c74 686f 7567  /asn1.c, althoug
│ │ │ │ -000021a0: 6820 7468 650a 2020 2020 2069 6e74 6572  h the.     inter
│ │ │ │ -000021b0: 6661 6365 2069 7320 7261 7468 6572 206c  face is rather l
│ │ │ │ -000021c0: 6962 7461 736e 3120 6365 6e74 7269 632e  ibtasn1 centric.
│ │ │ │ -000021d0: 0a0a 2020 20e2 80a2 204b 4443 2028 696e  ..   ... KDC (in
│ │ │ │ -000021e0: 6974 6961 7465 642c 2077 6565 6b73 290a  itiated, weeks).
│ │ │ │ -000021f0: 0a20 2020 e280 a220 4c44 4150 2062 6163  .   ... LDAP bac
│ │ │ │ -00002200: 6b65 6e64 2066 6f72 2053 6869 7361 2e0a  kend for Shisa..
│ │ │ │ -00002210: 0a20 2020 e280 a220 5365 742f 4368 616e  .   ... Set/Chan
│ │ │ │ -00002220: 6765 2070 6173 7377 6f72 6420 7072 6f74  ge password prot
│ │ │ │ -00002230: 6f63 6f6c 2028 7765 656b 733f 290a 0a20  ocol (weeks?).. 
│ │ │ │ -00002240: 2020 e280 a220 506f 7274 2061 7070 6c69    ... Port appli
│ │ │ │ -00002250: 6361 7469 6f6e 7320 746f 2075 7365 2053  cations to use S
│ │ │ │ -00002260: 6869 7368 6920 2869 6e64 6566 696e 6974  hishi (indefinit
│ │ │ │ -00002270: 6529 0a0a 2020 20e2 80a2 2046 696e 6973  e)..   ... Finis
│ │ │ │ -00002280: 6820 7365 7276 6572 2d72 6561 6c6d 2073  h server-realm s
│ │ │ │ -00002290: 7475 6666 0a0a 2020 20e2 80a2 2049 6d70  tuff..   ... Imp
│ │ │ │ -000022a0: 726f 7665 2064 6f63 756d 656e 7461 7469  rove documentati
│ │ │ │ -000022b0: 6f6e 0a0a 2020 20e2 80a2 2049 6d70 726f  on..   ... Impro
│ │ │ │ -000022c0: 7665 2069 6e74 6572 6e61 7469 6f6e 616c  ve international
│ │ │ │ -000022d0: 697a 6174 696f 6e0a 0a20 2020 e280 a220  ization..   ... 
│ │ │ │ -000022e0: 4164 6420 4150 2d52 4551 2072 6570 6c61  Add AP-REQ repla
│ │ │ │ -000022f0: 7920 6361 6368 6520 2877 6565 6b29 2e0a  y cache (week)..
│ │ │ │ -00002300: 0a20 2020 e280 a220 5374 7564 7920 6265  .   ... Study be
│ │ │ │ -00002310: 6e65 6669 7473 2062 7920 696e 7472 6f64  nefits by introd
│ │ │ │ -00002320: 7563 696e 6720 6120 5041 2d54 4753 2d52  ucing a PA-TGS-R
│ │ │ │ -00002330: 4550 2e20 5468 6973 2077 6f75 6c64 2070  EP. This would p
│ │ │ │ -00002340: 726f 7669 6465 0a20 2020 2020 6d75 7475  rovide.     mutu
│ │ │ │ -00002350: 616c 2061 7574 6865 6e74 6963 6174 696f  al authenticatio
│ │ │ │ -00002360: 6e20 6f66 2074 6865 204b 4443 2069 6e20  n of the KDC in 
│ │ │ │ -00002370: 6120 7761 7920 7468 6174 2069 7320 6561  a way that is ea
│ │ │ │ -00002380: 7369 6572 2074 6f0a 2020 2020 2061 6e61  sier to.     ana
│ │ │ │ -00002390: 6c79 7a65 2e20 2043 7572 7265 6e74 6c79  lyze.  Currently
│ │ │ │ -000023a0: 2074 6865 206d 7574 7561 6c20 6175 7468   the mutual auth
│ │ │ │ -000023b0: 656e 7469 6361 7469 6f6e 2070 726f 7065  entication prope
│ │ │ │ -000023c0: 7274 7920 6973 206f 6e6c 790a 2020 2020  rty is only.    
│ │ │ │ -000023d0: 2069 6d70 6c69 6369 7420 6672 6f6d 2073   implicit from s
│ │ │ │ -000023e0: 7563 6365 7373 6675 6c20 6465 6372 7970  uccessful decryp
│ │ │ │ -000023f0: 7469 6f6e 206f 6620 7468 6520 4b44 432d  tion of the KDC-
│ │ │ │ -00002400: 5245 5020 616e 6420 7468 6520 3420 6279  REP and the 4 by
│ │ │ │ -00002410: 7465 0a20 2020 2020 e280 986e 6f6e 6365  te.     ...nonce
│ │ │ │ -00002420: e280 992e 0a0a 2020 20e2 80a2 2047 5549  ......   ... GUI
│ │ │ │ -00002430: 2061 7070 6c65 7420 666f 7220 6d61 6e61   applet for mana
│ │ │ │ -00002440: 6769 6e67 2074 6963 6b65 7473 2e20 2054  ging tickets.  T
│ │ │ │ -00002450: 6869 7320 6973 2073 7570 706f 7274 6564  his is supported
│ │ │ │ -00002460: 2076 6961 2074 6865 0a20 2020 2020 7469   via the.     ti
│ │ │ │ -00002470: 636b 6574 2d61 7070 6c65 742c 206f 6620  cket-applet, of 
│ │ │ │ -00002480: 7768 6963 6820 6120 5368 6973 6869 2070  which a Shishi p
│ │ │ │ -00002490: 6f72 7420 6973 2070 7562 6c69 7368 6564  ort is published
│ │ │ │ -000024a0: 206f 6e20 7468 6520 5368 6973 6869 0a20   on the Shishi. 
│ │ │ │ -000024b0: 2020 2020 686f 6d65 2070 6167 652e 0a0a      home page...
│ │ │ │ -000024c0: 2020 20e2 80a2 2041 7574 686f 7269 7a61     ... Authoriza
│ │ │ │ -000024d0: 7469 6f6e 206c 6962 7261 7279 2028 6d6f  tion library (mo
│ │ │ │ -000024e0: 6e74 6873 3f29 2020 5468 6520 7368 6973  nths?)  The shis
│ │ │ │ -000024f0: 6869 5f61 7574 686f 7269 7a65 645f 7028  hi_authorized_p(
│ │ │ │ -00002500: 2920 6973 206e 6f74 2061 0a20 2020 2020  ) is not a.     
│ │ │ │ -00002510: 676f 6f64 2073 6f6c 7574 696f 6e2c 2062  good solution, b
│ │ │ │ -00002520: 6574 7465 7220 776f 756c 6420 6265 2074  etter would be t
│ │ │ │ -00002530: 6f20 6861 7665 2061 2067 656e 6572 6963  o have a generic
│ │ │ │ -00002540: 2061 6e64 2066 6c65 7869 626c 650a 2020   and flexible.  
│ │ │ │ -00002550: 2020 2061 7574 686f 7269 7a61 7469 6f6e     authorization
│ │ │ │ -00002560: 206c 6962 7261 7279 2e20 2050 6f73 7369   library.  Possi
│ │ │ │ -00002570: 626c 7920 6261 7365 6420 6f6e 2053 2d45  bly based on S-E
│ │ │ │ -00002580: 5850 2773 2069 6e20 7469 636b 6574 733f  XP's in tickets?
│ │ │ │ -00002590: 0a20 2020 2020 5368 6f75 6c64 2073 7570  .     Should sup
│ │ │ │ -000025a0: 706f 7274 206e 6f6e 2d4b 6572 6265 726f  port non-Kerbero
│ │ │ │ -000025b0: 7320 7573 6573 2061 7320 7765 6c6c 2c20  s uses as well, 
│ │ │ │ -000025c0: 6f66 2063 6f75 7273 652e 0a0a 2020 20e2  of course...   .
│ │ │ │ -000025d0: 80a2 2050 726f 6f66 2072 6561 6420 6d61  .. Proof read ma
│ │ │ │ -000025e0: 6e75 616c 2e0a 0a20 2020 e280 a220 582e  nual...   ... X.
│ │ │ │ -000025f0: 3530 3020 7375 7070 6f72 742c 2069 6e63  500 support, inc
│ │ │ │ -00002600: 6c75 6469 6e67 2044 4f4d 4149 4e2d 5835  luding DOMAIN-X5
│ │ │ │ -00002610: 3030 2d43 4f4d 5052 4553 532e 2049 2077  00-COMPRESS. I w
│ │ │ │ -00002620: 696c 6c20 6163 6365 7074 0a20 2020 2020  ill accept.     
│ │ │ │ -00002630: 7061 7463 6865 7320 7468 6174 2069 6d70  patches that imp
│ │ │ │ -00002640: 6c65 6d65 6e74 2074 6869 732c 2069 6620  lement this, if 
│ │ │ │ -00002650: 6974 2063 6175 7365 7320 6d69 6e69 6d61  it causes minima
│ │ │ │ -00002660: 6c20 6368 616e 6765 7320 746f 2074 6865  l changes to the
│ │ │ │ -00002670: 0a20 2020 2020 6375 7272 656e 7420 636f  .     current co
│ │ │ │ -00002680: 6465 2e0a 0a1f 0a46 696c 653a 2073 6869  de.....File: shi
│ │ │ │ -00002690: 7368 692e 696e 666f 2c20 204e 6f64 653a  shi.info,  Node:
│ │ │ │ -000026a0: 204f 7665 7276 6965 772c 2020 4e65 7874   Overview,  Next
│ │ │ │ -000026b0: 3a20 4372 7970 746f 6772 6170 6869 6320  : Cryptographic 
│ │ │ │ -000026c0: 4f76 6572 7669 6577 2c20 2050 7265 763a  Overview,  Prev:
│ │ │ │ -000026d0: 2046 6561 7475 7265 7320 616e 6420 5374   Features and St
│ │ │ │ -000026e0: 6174 7573 2c20 2055 703a 2049 6e74 726f  atus,  Up: Intro
│ │ │ │ -000026f0: 6475 6374 696f 6e0a 0a31 2e33 204f 7665  duction..1.3 Ove
│ │ │ │ -00002700: 7276 6965 770a 3d3d 3d3d 3d3d 3d3d 3d3d  rview.==========
│ │ │ │ -00002710: 3d3d 0a0a 5468 6973 2073 6563 7469 6f6e  ==..This section
│ │ │ │ -00002720: 2064 6573 6372 6962 6573 2052 4643 2031   describes RFC 1
│ │ │ │ -00002730: 3531 3020 6672 6f6d 2061 2070 726f 746f  510 from a proto
│ │ │ │ -00002740: 636f 6c20 706f 696e 7420 6f66 2076 6965  col point of vie
│ │ │ │ -00002750: 7728 3129 2e0a 0a20 2020 4b65 7262 6572  w(1)...   Kerber
│ │ │ │ -00002760: 6f73 2070 726f 7669 6465 7320 6120 6d65  os provides a me
│ │ │ │ -00002770: 616e 7320 6f66 2076 6572 6966 7969 6e67  ans of verifying
│ │ │ │ -00002780: 2074 6865 2069 6465 6e74 6974 6965 7320   the identities 
│ │ │ │ -00002790: 6f66 2070 7269 6e63 6970 616c 732c 0a28  of principals,.(
│ │ │ │ -000027a0: 652e 672e 2c20 6120 776f 726b 7374 6174  e.g., a workstat
│ │ │ │ -000027b0: 696f 6e20 7573 6572 206f 7220 6120 6e65  ion user or a ne
│ │ │ │ -000027c0: 7477 6f72 6b20 7365 7276 6572 2920 6f6e  twork server) on
│ │ │ │ -000027d0: 2061 6e20 6f70 656e 2028 756e 7072 6f74   an open (unprot
│ │ │ │ -000027e0: 6563 7465 6429 0a6e 6574 776f 726b 2e20  ected).network. 
│ │ │ │ -000027f0: 2054 6869 7320 6973 2061 6363 6f6d 706c   This is accompl
│ │ │ │ -00002800: 6973 6865 6420 7769 7468 6f75 7420 7265  ished without re
│ │ │ │ -00002810: 6c79 696e 6720 6f6e 2061 7574 6865 6e74  lying on authent
│ │ │ │ -00002820: 6963 6174 696f 6e20 6279 2074 6865 0a68  ication by the.h
│ │ │ │ -00002830: 6f73 7420 6f70 6572 6174 696e 6720 7379  ost operating sy
│ │ │ │ -00002840: 7374 656d 2c20 7769 7468 6f75 7420 6261  stem, without ba
│ │ │ │ -00002850: 7369 6e67 2074 7275 7374 206f 6e20 686f  sing trust on ho
│ │ │ │ -00002860: 7374 2061 6464 7265 7373 6573 2c20 7769  st addresses, wi
│ │ │ │ -00002870: 7468 6f75 740a 7265 7175 6972 696e 6720  thout.requiring 
│ │ │ │ -00002880: 7068 7973 6963 616c 2073 6563 7572 6974  physical securit
│ │ │ │ -00002890: 7920 6f66 2061 6c6c 2074 6865 2068 6f73  y of all the hos
│ │ │ │ -000028a0: 7473 206f 6e20 7468 6520 6e65 7477 6f72  ts on the networ
│ │ │ │ -000028b0: 6b2c 2061 6e64 2075 6e64 6572 0a74 6865  k, and under.the
│ │ │ │ -000028c0: 2061 7373 756d 7074 696f 6e20 7468 6174   assumption that
│ │ │ │ -000028d0: 2070 6163 6b65 7473 2074 7261 7665 6c69   packets traveli
│ │ │ │ -000028e0: 6e67 2061 6c6f 6e67 2074 6865 206e 6574  ng along the net
│ │ │ │ -000028f0: 776f 726b 2063 616e 2062 6520 7265 6164  work can be read
│ │ │ │ -00002900: 2c0a 6d6f 6469 6669 6564 2c20 616e 6420  ,.modified, and 
│ │ │ │ -00002910: 696e 7365 7274 6564 2061 7420 7769 6c6c  inserted at will
│ │ │ │ -00002920: 2e20 2028 4e6f 7465 2c20 686f 7765 7665  .  (Note, howeve
│ │ │ │ -00002930: 722c 2074 6861 7420 6d61 6e79 2061 7070  r, that many app
│ │ │ │ -00002940: 6c69 6361 7469 6f6e 730a 7573 6520 4b65  lications.use Ke
│ │ │ │ -00002950: 7262 6572 6f73 2720 6675 6e63 7469 6f6e  rberos' function
│ │ │ │ -00002960: 7320 6f6e 6c79 2075 706f 6e20 7468 6520  s only upon the 
│ │ │ │ -00002970: 696e 6974 6961 7469 6f6e 206f 6620 6120  initiation of a 
│ │ │ │ -00002980: 7374 7265 616d 2d62 6173 6564 0a6e 6574  stream-based.net
│ │ │ │ -00002990: 776f 726b 2063 6f6e 6e65 6374 696f 6e2c  work connection,
│ │ │ │ -000029a0: 2061 6e64 2061 7373 756d 6520 7468 6520   and assume the 
│ │ │ │ -000029b0: 6162 7365 6e63 6520 6f66 2061 6e79 2022  absence of any "
│ │ │ │ -000029c0: 6869 6a61 636b 6572 7322 2077 686f 206d  hijackers" who m
│ │ │ │ -000029d0: 6967 6874 0a73 7562 7665 7274 2073 7563  ight.subvert suc
│ │ │ │ -000029e0: 6820 6120 636f 6e6e 6563 7469 6f6e 2e20  h a connection. 
│ │ │ │ -000029f0: 2053 7563 6820 7573 6520 696d 706c 6963   Such use implic
│ │ │ │ -00002a00: 6974 6c79 2074 7275 7374 7320 7468 6520  itly trusts the 
│ │ │ │ -00002a10: 686f 7374 0a61 6464 7265 7373 6573 2069  host.addresses i
│ │ │ │ -00002a20: 6e76 6f6c 7665 642e 2920 204b 6572 6265  nvolved.)  Kerbe
│ │ │ │ -00002a30: 726f 7320 7065 7266 6f72 6d73 2061 7574  ros performs aut
│ │ │ │ -00002a40: 6865 6e74 6963 6174 696f 6e20 756e 6465  hentication unde
│ │ │ │ -00002a50: 7220 7468 6573 650a 636f 6e64 6974 696f  r these.conditio
│ │ │ │ -00002a60: 6e73 2061 7320 6120 7472 7573 7465 6420  ns as a trusted 
│ │ │ │ -00002a70: 7468 6972 642d 2070 6172 7479 2061 7574  third- party aut
│ │ │ │ -00002a80: 6865 6e74 6963 6174 696f 6e20 7365 7276  hentication serv
│ │ │ │ -00002a90: 6963 6520 6279 2075 7369 6e67 0a63 6f6e  ice by using.con
│ │ │ │ -00002aa0: 7665 6e74 696f 6e61 6c20 6372 7970 746f  ventional crypto
│ │ │ │ -00002ab0: 6772 6170 6879 2c20 692e 652e 2c20 7368  graphy, i.e., sh
│ │ │ │ -00002ac0: 6172 6564 2073 6563 7265 7420 6b65 792e  ared secret key.
│ │ │ │ -00002ad0: 2020 2873 6861 7265 6420 7365 6372 6574    (shared secret
│ │ │ │ -00002ae0: 206b 6579 0a2d 2053 6563 7265 7420 616e   key.- Secret an
│ │ │ │ -00002af0: 6420 7072 6976 6174 6520 6172 6520 6f66  d private are of
│ │ │ │ -00002b00: 7465 6e20 7573 6564 2069 6e74 6572 6368  ten used interch
│ │ │ │ -00002b10: 616e 6765 6162 6c79 2069 6e20 7468 6520  angeably in the 
│ │ │ │ -00002b20: 6c69 7465 7261 7475 7265 2e0a 496e 206f  literature..In o
│ │ │ │ -00002b30: 7572 2075 7361 6765 2c20 6974 2074 616b  ur usage, it tak
│ │ │ │ -00002b40: 6573 2074 776f 2028 6f72 206d 6f72 6529  es two (or more)
│ │ │ │ -00002b50: 2074 6f20 7368 6172 6520 6120 7365 6372   to share a secr
│ │ │ │ -00002b60: 6574 2c20 7468 7573 2061 2073 6861 7265  et, thus a share
│ │ │ │ -00002b70: 640a 4445 5320 6b65 7920 6973 2061 2073  d.DES key is a s
│ │ │ │ -00002b80: 6563 7265 7420 6b65 792e 2020 536f 6d65  ecret key.  Some
│ │ │ │ -00002b90: 7468 696e 6720 6973 206f 6e6c 7920 7072  thing is only pr
│ │ │ │ -00002ba0: 6976 6174 6520 7768 656e 206e 6f20 6f6e  ivate when no on
│ │ │ │ -00002bb0: 6520 6275 7420 6974 730a 6f77 6e65 7220  e but its.owner 
│ │ │ │ -00002bc0: 6b6e 6f77 7320 6974 2e20 2054 6875 732c  knows it.  Thus,
│ │ │ │ -00002bd0: 2069 6e20 7075 626c 6963 206b 6579 2063   in public key c
│ │ │ │ -00002be0: 7279 7074 6f73 7973 7465 6d73 2c20 6f6e  ryptosystems, on
│ │ │ │ -00002bf0: 6520 6861 7320 6120 7075 626c 6963 2061  e has a public a
│ │ │ │ -00002c00: 6e64 0a61 2070 7269 7661 7465 206b 6579  nd.a private key
│ │ │ │ -00002c10: 2e29 0a0a 2020 2054 6865 2061 7574 6865  .)..   The authe
│ │ │ │ -00002c20: 6e74 6963 6174 696f 6e20 7072 6f63 6573  ntication proces
│ │ │ │ -00002c30: 7320 7072 6f63 6565 6473 2061 7320 666f  s proceeds as fo
│ │ │ │ -00002c40: 6c6c 6f77 733a 2041 2063 6c69 656e 7420  llows: A client 
│ │ │ │ -00002c50: 7365 6e64 7320 610a 7265 7175 6573 7420  sends a.request 
│ │ │ │ -00002c60: 746f 2074 6865 2061 7574 6865 6e74 6963  to the authentic
│ │ │ │ -00002c70: 6174 696f 6e20 7365 7276 6572 2028 4153  ation server (AS
│ │ │ │ -00002c80: 2920 7265 7175 6573 7469 6e67 2022 6372  ) requesting "cr
│ │ │ │ -00002c90: 6564 656e 7469 616c 7322 2066 6f72 2061  edentials" for a
│ │ │ │ -00002ca0: 0a67 6976 656e 2073 6572 7665 722e 2020  .given server.  
│ │ │ │ -00002cb0: 5468 6520 4153 2072 6573 706f 6e64 7320  The AS responds 
│ │ │ │ -00002cc0: 7769 7468 2074 6865 7365 2063 7265 6465  with these crede
│ │ │ │ -00002cd0: 6e74 6961 6c73 2c20 656e 6372 7970 7465  ntials, encrypte
│ │ │ │ -00002ce0: 6420 696e 2074 6865 0a63 6c69 656e 7427  d in the.client'
│ │ │ │ -00002cf0: 7320 6b65 792e 2020 5468 6520 6372 6564  s key.  The cred
│ │ │ │ -00002d00: 656e 7469 616c 7320 636f 6e73 6973 7420  entials consist 
│ │ │ │ -00002d10: 6f66 2031 2920 6120 2274 6963 6b65 7422  of 1) a "ticket"
│ │ │ │ -00002d20: 2066 6f72 2074 6865 2073 6572 7665 720a   for the server.
│ │ │ │ -00002d30: 616e 6420 3229 2061 2074 656d 706f 7261  and 2) a tempora
│ │ │ │ -00002d40: 7279 2065 6e63 7279 7074 696f 6e20 6b65  ry encryption ke
│ │ │ │ -00002d50: 7920 286f 6674 656e 2063 616c 6c65 6420  y (often called 
│ │ │ │ -00002d60: 6120 2273 6573 7369 6f6e 206b 6579 2229  a "session key")
│ │ │ │ -00002d70: 2e20 2054 6865 0a63 6c69 656e 7420 7472  .  The.client tr
│ │ │ │ -00002d80: 616e 736d 6974 7320 7468 6520 7469 636b  ansmits the tick
│ │ │ │ -00002d90: 6574 2028 7768 6963 6820 636f 6e74 6169  et (which contai
│ │ │ │ -00002da0: 6e73 2074 6865 2063 6c69 656e 7427 7320  ns the client's 
│ │ │ │ -00002db0: 6964 656e 7469 7479 2061 6e64 2061 0a63  identity and a.c
│ │ │ │ -00002dc0: 6f70 7920 6f66 2074 6865 2073 6573 7369  opy of the sessi
│ │ │ │ -00002dd0: 6f6e 206b 6579 2c20 616c 6c20 656e 6372  on key, all encr
│ │ │ │ -00002de0: 7970 7465 6420 696e 2074 6865 2073 6572  ypted in the ser
│ │ │ │ -00002df0: 7665 7227 7320 6b65 7929 2074 6f20 7468  ver's key) to th
│ │ │ │ -00002e00: 650a 7365 7276 6572 2e20 2054 6865 2073  e.server.  The s
│ │ │ │ -00002e10: 6573 7369 6f6e 206b 6579 2028 6e6f 7720  ession key (now 
│ │ │ │ -00002e20: 7368 6172 6564 2062 7920 7468 6520 636c  shared by the cl
│ │ │ │ -00002e30: 6965 6e74 2061 6e64 2073 6572 7665 7229  ient and server)
│ │ │ │ -00002e40: 2069 7320 7573 6564 0a74 6f20 6175 7468   is used.to auth
│ │ │ │ -00002e50: 656e 7469 6361 7465 2074 6865 2063 6c69  enticate the cli
│ │ │ │ -00002e60: 656e 742c 2061 6e64 206d 6179 206f 7074  ent, and may opt
│ │ │ │ -00002e70: 696f 6e61 6c6c 7920 6265 2075 7365 6420  ionally be used 
│ │ │ │ -00002e80: 746f 2061 7574 6865 6e74 6963 6174 650a  to authenticate.
│ │ │ │ -00002e90: 7468 6520 7365 7276 6572 2e20 2049 7420  the server.  It 
│ │ │ │ -00002ea0: 6d61 7920 616c 736f 2062 6520 7573 6564  may also be used
│ │ │ │ -00002eb0: 2074 6f20 656e 6372 7970 7420 6675 7274   to encrypt furt
│ │ │ │ -00002ec0: 6865 7220 636f 6d6d 756e 6963 6174 696f  her communicatio
│ │ │ │ -00002ed0: 6e0a 6265 7477 6565 6e20 7468 6520 7477  n.between the tw
│ │ │ │ -00002ee0: 6f20 7061 7274 6965 7320 6f72 2074 6f20  o parties or to 
│ │ │ │ -00002ef0: 6578 6368 616e 6765 2061 2073 6570 6172  exchange a separ
│ │ │ │ -00002f00: 6174 6520 7375 622d 7365 7373 696f 6e20  ate sub-session 
│ │ │ │ -00002f10: 6b65 7920 746f 2062 650a 7573 6564 2074  key to be.used t
│ │ │ │ -00002f20: 6f20 656e 6372 7970 7420 6675 7274 6865  o encrypt furthe
│ │ │ │ -00002f30: 7220 636f 6d6d 756e 6963 6174 696f 6e2e  r communication.
│ │ │ │ -00002f40: 0a0a 2020 2054 6865 2069 6d70 6c65 6d65  ..   The impleme
│ │ │ │ -00002f50: 6e74 6174 696f 6e20 636f 6e73 6973 7473  ntation consists
│ │ │ │ -00002f60: 206f 6620 6f6e 6520 6f72 206d 6f72 6520   of one or more 
│ │ │ │ -00002f70: 6175 7468 656e 7469 6361 7469 6f6e 2073  authentication s
│ │ │ │ -00002f80: 6572 7665 7273 0a72 756e 6e69 6e67 206f  ervers.running o
│ │ │ │ -00002f90: 6e20 7068 7973 6963 616c 6c79 2073 6563  n physically sec
│ │ │ │ -00002fa0: 7572 6520 686f 7374 732e 2020 5468 6520  ure hosts.  The 
│ │ │ │ -00002fb0: 6175 7468 656e 7469 6361 7469 6f6e 2073  authentication s
│ │ │ │ -00002fc0: 6572 7665 7273 206d 6169 6e74 6169 6e0a  ervers maintain.
│ │ │ │ -00002fd0: 6120 6461 7461 6261 7365 206f 6620 7072  a database of pr
│ │ │ │ -00002fe0: 696e 6369 7061 6c73 2028 692e 652e 2c20  incipals (i.e., 
│ │ │ │ -00002ff0: 7573 6572 7320 616e 6420 7365 7276 6572  users and server
│ │ │ │ -00003000: 7329 2061 6e64 2074 6865 6972 2073 6563  s) and their sec
│ │ │ │ -00003010: 7265 740a 6b65 7973 2e20 2043 6f64 6520  ret.keys.  Code 
│ │ │ │ -00003020: 6c69 6272 6172 6965 7320 7072 6f76 6964  libraries provid
│ │ │ │ -00003030: 6520 656e 6372 7970 7469 6f6e 2061 6e64  e encryption and
│ │ │ │ -00003040: 2069 6d70 6c65 6d65 6e74 2074 6865 204b   implement the K
│ │ │ │ -00003050: 6572 6265 726f 730a 7072 6f74 6f63 6f6c  erberos.protocol
│ │ │ │ -00003060: 2e20 2049 6e20 6f72 6465 7220 746f 2061  .  In order to a
│ │ │ │ -00003070: 6464 2061 7574 6865 6e74 6963 6174 696f  dd authenticatio
│ │ │ │ -00003080: 6e20 746f 2069 7473 2074 7261 6e73 6163  n to its transac
│ │ │ │ -00003090: 7469 6f6e 732c 2061 2074 7970 6963 616c  tions, a typical
│ │ │ │ -000030a0: 0a6e 6574 776f 726b 2061 7070 6c69 6361  .network applica
│ │ │ │ -000030b0: 7469 6f6e 2061 6464 7320 6f6e 6520 6f72  tion adds one or
│ │ │ │ -000030c0: 2074 776f 2063 616c 6c73 2074 6f20 7468   two calls to th
│ │ │ │ -000030d0: 6520 4b65 7262 6572 6f73 206c 6962 7261  e Kerberos libra
│ │ │ │ -000030e0: 7279 2c20 7768 6963 680a 7265 7375 6c74  ry, which.result
│ │ │ │ -000030f0: 7320 696e 2074 6865 2074 7261 6e73 6d69  s in the transmi
│ │ │ │ -00003100: 7373 696f 6e20 6f66 2074 6865 206e 6563  ssion of the nec
│ │ │ │ -00003110: 6573 7361 7279 206d 6573 7361 6765 7320  essary messages 
│ │ │ │ -00003120: 746f 2061 6368 6965 7665 0a61 7574 6865  to achieve.authe
│ │ │ │ -00003130: 6e74 6963 6174 696f 6e2e 0a0a 2020 2054  ntication...   T
│ │ │ │ -00003140: 6865 204b 6572 6265 726f 7320 7072 6f74  he Kerberos prot
│ │ │ │ -00003150: 6f63 6f6c 2063 6f6e 7369 7374 7320 6f66  ocol consists of
│ │ │ │ -00003160: 2073 6576 6572 616c 2073 7562 2d70 726f   several sub-pro
│ │ │ │ -00003170: 746f 636f 6c73 2028 6f72 0a65 7863 6861  tocols (or.excha
│ │ │ │ -00003180: 6e67 6573 292e 2020 5468 6572 6520 6172  nges).  There ar
│ │ │ │ -00003190: 6520 7477 6f20 6d65 7468 6f64 7320 6279  e two methods by
│ │ │ │ -000031a0: 2077 6869 6368 2061 2063 6c69 656e 7420   which a client 
│ │ │ │ -000031b0: 6361 6e20 6173 6b20 6120 4b65 7262 6572  can ask a Kerber
│ │ │ │ -000031c0: 6f73 0a73 6572 7665 7220 666f 7220 6372  os.server for cr
│ │ │ │ -000031d0: 6564 656e 7469 616c 732e 2020 496e 2074  edentials.  In t
│ │ │ │ -000031e0: 6865 2066 6972 7374 2061 7070 726f 6163  he first approac
│ │ │ │ -000031f0: 682c 2074 6865 2063 6c69 656e 7420 7365  h, the client se
│ │ │ │ -00003200: 6e64 7320 610a 636c 6561 7274 6578 7420  nds a.cleartext 
│ │ │ │ -00003210: 7265 7175 6573 7420 666f 7220 6120 7469  request for a ti
│ │ │ │ -00003220: 636b 6574 2066 6f72 2074 6865 2064 6573  cket for the des
│ │ │ │ -00003230: 6972 6564 2073 6572 7665 7220 746f 2074  ired server to t
│ │ │ │ -00003240: 6865 2041 532e 2054 6865 0a72 6570 6c79  he AS. The.reply
│ │ │ │ -00003250: 2069 7320 7365 6e74 2065 6e63 7279 7074   is sent encrypt
│ │ │ │ -00003260: 6564 2069 6e20 7468 6520 636c 6965 6e74  ed in the client
│ │ │ │ -00003270: 2773 2073 6563 7265 7420 6b65 792e 2020  's secret key.  
│ │ │ │ -00003280: 5573 7561 6c6c 7920 7468 6973 0a72 6571  Usually this.req
│ │ │ │ -00003290: 7565 7374 2069 7320 666f 7220 6120 7469  uest is for a ti
│ │ │ │ -000032a0: 636b 6574 2d67 7261 6e74 696e 6720 7469  cket-granting ti
│ │ │ │ -000032b0: 636b 6574 2028 5447 5429 2077 6869 6368  cket (TGT) which
│ │ │ │ -000032c0: 2063 616e 206c 6174 6572 2062 6520 7573   can later be us
│ │ │ │ -000032d0: 6564 0a77 6974 6820 7468 6520 7469 636b  ed.with the tick
│ │ │ │ -000032e0: 6574 2d67 7261 6e74 696e 6720 7365 7276  et-granting serv
│ │ │ │ -000032f0: 6572 2028 5447 5329 2e20 496e 2074 6865  er (TGS). In the
│ │ │ │ -00003300: 2073 6563 6f6e 6420 6d65 7468 6f64 2c20   second method, 
│ │ │ │ -00003310: 7468 6520 636c 6965 6e74 0a73 656e 6473  the client.sends
│ │ │ │ -00003320: 2061 2072 6571 7565 7374 2074 6f20 7468   a request to th
│ │ │ │ -00003330: 6520 5447 532e 2054 6865 2063 6c69 656e  e TGS. The clien
│ │ │ │ -00003340: 7420 7365 6e64 7320 7468 6520 5447 5420  t sends the TGT 
│ │ │ │ -00003350: 746f 2074 6865 2054 4753 2069 6e20 7468  to the TGS in th
│ │ │ │ -00003360: 650a 7361 6d65 206d 616e 6e65 7220 6173  e.same manner as
│ │ │ │ -00003370: 2069 6620 6974 2077 6572 6520 636f 6e74   if it were cont
│ │ │ │ -00003380: 6163 7469 6e67 2061 6e79 206f 7468 6572  acting any other
│ │ │ │ -00003390: 2061 7070 6c69 6361 7469 6f6e 2073 6572   application ser
│ │ │ │ -000033a0: 7665 7220 7768 6963 680a 7265 7175 6972  ver which.requir
│ │ │ │ -000033b0: 6573 204b 6572 6265 726f 7320 6372 6564  es Kerberos cred
│ │ │ │ -000033c0: 656e 7469 616c 732e 2020 5468 6520 7265  entials.  The re
│ │ │ │ -000033d0: 706c 7920 6973 2065 6e63 7279 7074 6564  ply is encrypted
│ │ │ │ -000033e0: 2069 6e20 7468 6520 7365 7373 696f 6e0a   in the session.
│ │ │ │ -000033f0: 6b65 7920 6672 6f6d 2074 6865 2054 4754  key from the TGT
│ │ │ │ -00003400: 2e0a 0a20 2020 4f6e 6365 206f 6274 6169  ...   Once obtai
│ │ │ │ -00003410: 6e65 642c 2063 7265 6465 6e74 6961 6c73  ned, credentials
│ │ │ │ -00003420: 206d 6179 2062 6520 7573 6564 2074 6f20   may be used to 
│ │ │ │ -00003430: 7665 7269 6679 2074 6865 2069 6465 6e74  verify the ident
│ │ │ │ -00003440: 6974 7920 6f66 2074 6865 0a70 7269 6e63  ity of the.princ
│ │ │ │ -00003450: 6970 616c 7320 696e 2061 2074 7261 6e73  ipals in a trans
│ │ │ │ -00003460: 6163 7469 6f6e 2c20 746f 2065 6e73 7572  action, to ensur
│ │ │ │ -00003470: 6520 7468 6520 696e 7465 6772 6974 7920  e the integrity 
│ │ │ │ -00003480: 6f66 206d 6573 7361 6765 730a 6578 6368  of messages.exch
│ │ │ │ -00003490: 616e 6765 6420 6265 7477 6565 6e20 7468  anged between th
│ │ │ │ -000034a0: 656d 2c20 6f72 2074 6f20 7072 6573 6572  em, or to preser
│ │ │ │ -000034b0: 7665 2070 7269 7661 6379 206f 6620 7468  ve privacy of th
│ │ │ │ -000034c0: 6520 6d65 7373 6167 6573 2e20 2054 6865  e messages.  The
│ │ │ │ -000034d0: 0a61 7070 6c69 6361 7469 6f6e 2069 7320  .application is 
│ │ │ │ -000034e0: 6672 6565 2074 6f20 6368 6f6f 7365 2077  free to choose w
│ │ │ │ -000034f0: 6861 7465 7665 7220 7072 6f74 6563 7469  hatever protecti
│ │ │ │ -00003500: 6f6e 206d 6179 2062 6520 6e65 6365 7373  on may be necess
│ │ │ │ -00003510: 6172 792e 0a0a 2020 2054 6f20 7665 7269  ary...   To veri
│ │ │ │ -00003520: 6679 2074 6865 2069 6465 6e74 6974 6965  fy the identitie
│ │ │ │ -00003530: 7320 6f66 2074 6865 2070 7269 6e63 6970  s of the princip
│ │ │ │ -00003540: 616c 7320 696e 2061 2074 7261 6e73 6163  als in a transac
│ │ │ │ -00003550: 7469 6f6e 2c20 7468 650a 636c 6965 6e74  tion, the.client
│ │ │ │ -00003560: 2074 7261 6e73 6d69 7473 2074 6865 2074   transmits the t
│ │ │ │ -00003570: 6963 6b65 7420 746f 2074 6865 2073 6572  icket to the ser
│ │ │ │ -00003580: 7665 722e 2020 5369 6e63 6520 7468 6520  ver.  Since the 
│ │ │ │ -00003590: 7469 636b 6574 2069 7320 7365 6e74 2022  ticket is sent "
│ │ │ │ -000035a0: 696e 0a74 6865 2063 6c65 6172 2220 2870  in.the clear" (p
│ │ │ │ -000035b0: 6172 7473 206f 6620 6974 2061 7265 2065  arts of it are e
│ │ │ │ -000035c0: 6e63 7279 7074 6564 2c20 6275 7420 7468  ncrypted, but th
│ │ │ │ -000035d0: 6973 2065 6e63 7279 7074 696f 6e20 646f  is encryption do
│ │ │ │ -000035e0: 6573 6e27 740a 7468 7761 7274 2072 6570  esn't.thwart rep
│ │ │ │ -000035f0: 6c61 7929 2061 6e64 206d 6967 6874 2062  lay) and might b
│ │ │ │ -00003600: 6520 696e 7465 7263 6570 7465 6420 616e  e intercepted an
│ │ │ │ -00003610: 6420 7265 7573 6564 2062 7920 616e 2061  d reused by an a
│ │ │ │ -00003620: 7474 6163 6b65 722c 0a61 6464 6974 696f  ttacker,.additio
│ │ │ │ -00003630: 6e61 6c20 696e 666f 726d 6174 696f 6e20  nal information 
│ │ │ │ -00003640: 6973 2073 656e 7420 746f 2070 726f 7665  is sent to prove
│ │ │ │ -00003650: 2074 6861 7420 7468 6520 6d65 7373 6167   that the messag
│ │ │ │ -00003660: 6520 7761 7320 6f72 6967 696e 6174 6564  e was originated
│ │ │ │ -00003670: 0a62 7920 7468 6520 7072 696e 6369 7061  .by the principa
│ │ │ │ -00003680: 6c20 746f 2077 686f 6d20 7468 6520 7469  l to whom the ti
│ │ │ │ -00003690: 636b 6574 2077 6173 2069 7373 7565 642e  cket was issued.
│ │ │ │ -000036a0: 2020 5468 6973 2069 6e66 6f72 6d61 7469    This informati
│ │ │ │ -000036b0: 6f6e 0a28 6361 6c6c 6564 2074 6865 2061  on.(called the a
│ │ │ │ -000036c0: 7574 6865 6e74 6963 6174 6f72 2920 6973  uthenticator) is
│ │ │ │ -000036d0: 2065 6e63 7279 7074 6564 2069 6e20 7468   encrypted in th
│ │ │ │ -000036e0: 6520 7365 7373 696f 6e20 6b65 792c 2061  e session key, a
│ │ │ │ -000036f0: 6e64 2069 6e63 6c75 6465 730a 6120 7469  nd includes.a ti
│ │ │ │ -00003700: 6d65 7374 616d 702e 2020 5468 6520 7469  mestamp.  The ti
│ │ │ │ -00003710: 6d65 7374 616d 7020 7072 6f76 6573 2074  mestamp proves t
│ │ │ │ -00003720: 6861 7420 7468 6520 6d65 7373 6167 6520  hat the message 
│ │ │ │ -00003730: 7761 7320 7265 6365 6e74 6c79 0a67 656e  was recently.gen
│ │ │ │ -00003740: 6572 6174 6564 2061 6e64 2069 7320 6e6f  erated and is no
│ │ │ │ -00003750: 7420 6120 7265 706c 6179 2e20 2045 6e63  t a replay.  Enc
│ │ │ │ -00003760: 7279 7074 696e 6720 7468 6520 6175 7468  rypting the auth
│ │ │ │ -00003770: 656e 7469 6361 746f 7220 696e 2074 6865  enticator in the
│ │ │ │ -00003780: 0a73 6573 7369 6f6e 206b 6579 2070 726f  .session key pro
│ │ │ │ -00003790: 7665 7320 7468 6174 2069 7420 7761 7320  ves that it was 
│ │ │ │ -000037a0: 6765 6e65 7261 7465 6420 6279 2061 2070  generated by a p
│ │ │ │ -000037b0: 6172 7479 2070 6f73 7365 7373 696e 6720  arty possessing 
│ │ │ │ -000037c0: 7468 650a 7365 7373 696f 6e20 6b65 792e  the.session key.
│ │ │ │ -000037d0: 2020 5369 6e63 6520 6e6f 206f 6e65 2065    Since no one e
│ │ │ │ -000037e0: 7863 6570 7420 7468 6520 7265 7175 6573  xcept the reques
│ │ │ │ -000037f0: 7469 6e67 2070 7269 6e63 6970 616c 2061  ting principal a
│ │ │ │ -00003800: 6e64 2074 6865 0a73 6572 7665 7220 6b6e  nd the.server kn
│ │ │ │ -00003810: 6f77 2074 6865 2073 6573 7369 6f6e 206b  ow the session k
│ │ │ │ -00003820: 6579 2028 6974 2069 7320 6e65 7665 7220  ey (it is never 
│ │ │ │ -00003830: 7365 6e74 206f 7665 7220 7468 6520 6e65  sent over the ne
│ │ │ │ -00003840: 7477 6f72 6b20 696e 2074 6865 0a63 6c65  twork in the.cle
│ │ │ │ -00003850: 6172 2920 7468 6973 2067 7561 7261 6e74  ar) this guarant
│ │ │ │ -00003860: 6565 7320 7468 6520 6964 656e 7469 7479  ees the identity
│ │ │ │ -00003870: 206f 6620 7468 6520 636c 6965 6e74 2e0a   of the client..
│ │ │ │ -00003880: 0a20 2020 5468 6520 696e 7465 6772 6974  .   The integrit
│ │ │ │ -00003890: 7920 6f66 2074 6865 206d 6573 7361 6765  y of the message
│ │ │ │ -000038a0: 7320 6578 6368 616e 6765 6420 6265 7477  s exchanged betw
│ │ │ │ -000038b0: 6565 6e20 7072 696e 6369 7061 6c73 2063  een principals c
│ │ │ │ -000038c0: 616e 2061 6c73 6f0a 6265 2067 7561 7261  an also.be guara
│ │ │ │ -000038d0: 6e74 6565 6420 7573 696e 6720 7468 6520  nteed using the 
│ │ │ │ -000038e0: 7365 7373 696f 6e20 6b65 7920 2870 6173  session key (pas
│ │ │ │ -000038f0: 7365 6420 696e 2074 6865 2074 6963 6b65  sed in the ticke
│ │ │ │ -00003900: 7420 616e 6420 636f 6e74 6169 6e65 640a  t and contained.
│ │ │ │ -00003910: 696e 2074 6865 2063 7265 6465 6e74 6961  in the credentia
│ │ │ │ -00003920: 6c73 292e 2020 5468 6973 2061 7070 726f  ls).  This appro
│ │ │ │ -00003930: 6163 6820 7072 6f76 6964 6573 2064 6574  ach provides det
│ │ │ │ -00003940: 6563 7469 6f6e 206f 6620 626f 7468 2072  ection of both r
│ │ │ │ -00003950: 6570 6c61 790a 6174 7461 636b 7320 616e  eplay.attacks an
│ │ │ │ -00003960: 6420 6d65 7373 6167 6520 7374 7265 616d  d message stream
│ │ │ │ -00003970: 206d 6f64 6966 6963 6174 696f 6e20 6174   modification at
│ │ │ │ -00003980: 7461 636b 732e 2020 4974 2069 7320 6163  tacks.  It is ac
│ │ │ │ -00003990: 636f 6d70 6c69 7368 6564 2062 790a 6765  complished by.ge
│ │ │ │ -000039a0: 6e65 7261 7469 6e67 2061 6e64 2074 7261  nerating and tra
│ │ │ │ -000039b0: 6e73 6d69 7474 696e 6720 6120 636f 6c6c  nsmitting a coll
│ │ │ │ -000039c0: 6973 696f 6e2d 7072 6f6f 6620 6368 6563  ision-proof chec
│ │ │ │ -000039d0: 6b73 756d 2028 656c 7365 7768 6572 6520  ksum (elsewhere 
│ │ │ │ -000039e0: 6361 6c6c 6564 0a61 2068 6173 6820 6f72  called.a hash or
│ │ │ │ -000039f0: 2064 6967 6573 7420 6675 6e63 7469 6f6e   digest function
│ │ │ │ -00003a00: 2920 6f66 2074 6865 2063 6c69 656e 7427  ) of the client'
│ │ │ │ -00003a10: 7320 6d65 7373 6167 652c 206b 6579 6564  s message, keyed
│ │ │ │ -00003a20: 2077 6974 6820 7468 650a 7365 7373 696f   with the.sessio
│ │ │ │ -00003a30: 6e20 6b65 792e 2020 5072 6976 6163 7920  n key.  Privacy 
│ │ │ │ -00003a40: 616e 6420 696e 7465 6772 6974 7920 6f66  and integrity of
│ │ │ │ -00003a50: 2074 6865 206d 6573 7361 6765 7320 6578   the messages ex
│ │ │ │ -00003a60: 6368 616e 6765 6420 6265 7477 6565 6e0a  changed between.
│ │ │ │ -00003a70: 7072 696e 6369 7061 6c73 2063 616e 2062  principals can b
│ │ │ │ -00003a80: 6520 7365 6375 7265 6420 6279 2065 6e63  e secured by enc
│ │ │ │ -00003a90: 7279 7074 696e 6720 7468 6520 6461 7461  rypting the data
│ │ │ │ -00003aa0: 2074 6f20 6265 2070 6173 7365 6420 7573   to be passed us
│ │ │ │ -00003ab0: 696e 6720 7468 650a 7365 7373 696f 6e20  ing the.session 
│ │ │ │ -00003ac0: 6b65 7920 7061 7373 6564 2069 6e20 7468  key passed in th
│ │ │ │ -00003ad0: 6520 7469 636b 6574 2c20 616e 6420 636f  e ticket, and co
│ │ │ │ -00003ae0: 6e74 6169 6e65 6420 696e 2074 6865 2063  ntained in the c
│ │ │ │ -00003af0: 7265 6465 6e74 6961 6c73 2e0a 0a20 2020  redentials...   
│ │ │ │ -00003b00: 2d2d 2d2d 2d2d 2d2d 2d2d 2046 6f6f 746e  ---------- Footn
│ │ │ │ -00003b10: 6f74 6573 202d 2d2d 2d2d 2d2d 2d2d 2d0a  otes ----------.
│ │ │ │ -00003b20: 0a20 2020 2831 2920 5468 6520 7465 7874  .   (1) The text
│ │ │ │ -00003b30: 2069 7320 6120 6c69 6768 746c 7920 6164   is a lightly ad
│ │ │ │ -00003b40: 6170 7465 6420 7665 7273 696f 6e20 6f66  apted version of
│ │ │ │ -00003b50: 2074 6865 2069 6e74 726f 6475 6374 696f   the introductio
│ │ │ │ -00003b60: 6e20 7365 6374 696f 6e0a 6672 6f6d 2052  n section.from R
│ │ │ │ -00003b70: 4643 2031 3531 3020 6279 204a 2e20 4b6f  FC 1510 by J. Ko
│ │ │ │ -00003b80: 686c 2061 6e64 2043 2e20 4e65 756d 616e  hl and C. Neuman
│ │ │ │ -00003b90: 2c20 5365 7074 656d 6265 7220 3139 3933  , September 1993
│ │ │ │ -00003ba0: 2c20 636f 7079 7269 6768 7420 6c69 6b65  , copyright like
│ │ │ │ -00003bb0: 6c79 0a6f 776e 6564 2062 7920 7468 6520  ly.owned by the 
│ │ │ │ -00003bc0: 5246 4320 3135 3130 2061 7574 686f 7273  RFC 1510 authors
│ │ │ │ -00003bd0: 206f 7220 736f 6d65 2063 6f6e 7472 6962   or some contrib
│ │ │ │ -00003be0: 7574 6f72 2e0a 0a1f 0a46 696c 653a 2073  utor.....File: s
│ │ │ │ -00003bf0: 6869 7368 692e 696e 666f 2c20 204e 6f64  hishi.info,  Nod
│ │ │ │ -00003c00: 653a 2043 7279 7074 6f67 7261 7068 6963  e: Cryptographic
│ │ │ │ -00003c10: 204f 7665 7276 6965 772c 2020 4e65 7874   Overview,  Next
│ │ │ │ -00003c20: 3a20 5375 7070 6f72 7465 6420 506c 6174  : Supported Plat
│ │ │ │ -00003c30: 666f 726d 732c 2020 5072 6576 3a20 4f76  forms,  Prev: Ov
│ │ │ │ -00003c40: 6572 7669 6577 2c20 2055 703a 2049 6e74  erview,  Up: Int
│ │ │ │ -00003c50: 726f 6475 6374 696f 6e0a 0a31 2e34 2043  roduction..1.4 C
│ │ │ │ -00003c60: 7279 7074 6f67 7261 7068 6963 204f 7665  ryptographic Ove
│ │ │ │ -00003c70: 7276 6965 770a 3d3d 3d3d 3d3d 3d3d 3d3d  rview.==========
│ │ │ │ +00000060: 6174 6564 2031 3420 4d61 7263 6820 3230  ated 14 March 20
│ │ │ │ +00000070: 3236 2066 6f72 2076 6572 7369 6f6e 2031  26 for version 1
│ │ │ │ +00000080: 2e30 2e33 206f 6620 5368 6973 6869 2e0a  .0.3 of Shishi..
│ │ │ │ +00000090: 0a20 2020 436f 7079 7269 6768 7420 c2a9  .   Copyright ..
│ │ │ │ +000000a0: 2032 3030 322d 3230 3232 2053 696d 6f6e   2002-2022 Simon
│ │ │ │ +000000b0: 204a 6f73 6566 7373 6f6e 2e0a 0a20 2020   Josefsson...   
│ │ │ │ +000000c0: 2020 5065 726d 6973 7369 6f6e 2069 7320    Permission is 
│ │ │ │ +000000d0: 6772 616e 7465 6420 746f 2063 6f70 792c  granted to copy,
│ │ │ │ +000000e0: 2064 6973 7472 6962 7574 6520 616e 642f   distribute and/
│ │ │ │ +000000f0: 6f72 206d 6f64 6966 7920 7468 6973 0a20  or modify this. 
│ │ │ │ +00000100: 2020 2020 646f 6375 6d65 6e74 2075 6e64      document und
│ │ │ │ +00000110: 6572 2074 6865 2074 6572 6d73 206f 6620  er the terms of 
│ │ │ │ +00000120: 7468 6520 474e 5520 4672 6565 2044 6f63  the GNU Free Doc
│ │ │ │ +00000130: 756d 656e 7461 7469 6f6e 204c 6963 656e  umentation Licen
│ │ │ │ +00000140: 7365 2c0a 2020 2020 2056 6572 7369 6f6e  se,.     Version
│ │ │ │ +00000150: 2031 2e33 206f 7220 616e 7920 6c61 7465   1.3 or any late
│ │ │ │ +00000160: 7220 7665 7273 696f 6e20 7075 626c 6973  r version publis
│ │ │ │ +00000170: 6865 6420 6279 2074 6865 2046 7265 6520  hed by the Free 
│ │ │ │ +00000180: 536f 6674 7761 7265 0a20 2020 2020 466f  Software.     Fo
│ │ │ │ +00000190: 756e 6461 7469 6f6e 3b20 7769 7468 206e  undation; with n
│ │ │ │ +000001a0: 6f20 496e 7661 7269 616e 7420 5365 6374  o Invariant Sect
│ │ │ │ +000001b0: 696f 6e73 2c20 6e6f 2046 726f 6e74 2d43  ions, no Front-C
│ │ │ │ +000001c0: 6f76 6572 2054 6578 7473 2c20 616e 640a  over Texts, and.
│ │ │ │ +000001d0: 2020 2020 206e 6f20 4261 636b 2d43 6f76       no Back-Cov
│ │ │ │ +000001e0: 6572 2054 6578 7473 2e20 2041 2063 6f70  er Texts.  A cop
│ │ │ │ +000001f0: 7920 6f66 2074 6865 206c 6963 656e 7365  y of the license
│ │ │ │ +00000200: 2069 7320 696e 636c 7564 6564 2069 6e20   is included in 
│ │ │ │ +00000210: 7468 650a 2020 2020 2073 6563 7469 6f6e  the.     section
│ │ │ │ +00000220: 2065 6e74 6974 6c65 6420 2247 4e55 2046   entitled "GNU F
│ │ │ │ +00000230: 7265 6520 446f 6375 6d65 6e74 6174 696f  ree Documentatio
│ │ │ │ +00000240: 6e20 4c69 6365 6e73 6522 2e0a 494e 464f  n License"..INFO
│ │ │ │ +00000250: 2d44 4952 2d53 4543 5449 4f4e 2047 4e55  -DIR-SECTION GNU
│ │ │ │ +00000260: 2075 7469 6c69 7469 6573 0a53 5441 5254   utilities.START
│ │ │ │ +00000270: 2d49 4e46 4f2d 4449 522d 454e 5452 590a  -INFO-DIR-ENTRY.
│ │ │ │ +00000280: 2a20 7368 6973 6869 3a20 2873 6869 7368  * shishi: (shish
│ │ │ │ +00000290: 6929 2e09 0941 204b 6572 6265 726f 7320  i)...A Kerberos 
│ │ │ │ +000002a0: 3520 696d 706c 656d 656e 7461 7469 6f6e  5 implementation
│ │ │ │ +000002b0: 0a45 4e44 2d49 4e46 4f2d 4449 522d 454e  .END-INFO-DIR-EN
│ │ │ │ +000002c0: 5452 590a 0a49 4e46 4f2d 4449 522d 5345  TRY..INFO-DIR-SE
│ │ │ │ +000002d0: 4354 494f 4e20 474e 5520 4c69 6272 6172  CTION GNU Librar
│ │ │ │ +000002e0: 6965 730a 5354 4152 542d 494e 464f 2d44  ies.START-INFO-D
│ │ │ │ +000002f0: 4952 2d45 4e54 5259 0a2a 206c 6962 7368  IR-ENTRY.* libsh
│ │ │ │ +00000300: 6973 6869 3a20 2873 6869 7368 6929 2e09  ishi: (shishi)..
│ │ │ │ +00000310: 094c 6962 7261 7279 2069 6d70 6c65 6d65  .Library impleme
│ │ │ │ +00000320: 6e74 696e 6720 4b65 7262 6572 6f73 2035  nting Kerberos 5
│ │ │ │ +00000330: 2e0a 454e 442d 494e 464f 2d44 4952 2d45  ..END-INFO-DIR-E
│ │ │ │ +00000340: 4e54 5259 0a0a 1f0a 4669 6c65 3a20 7368  NTRY....File: sh
│ │ │ │ +00000350: 6973 6869 2e69 6e66 6f2c 2020 4e6f 6465  ishi.info,  Node
│ │ │ │ +00000360: 3a20 546f 702c 2020 4e65 7874 3a20 496e  : Top,  Next: In
│ │ │ │ +00000370: 7472 6f64 7563 7469 6f6e 2c20 2055 703a  troduction,  Up:
│ │ │ │ +00000380: 2028 6469 7229 0a0a 5368 6973 6869 0a2a   (dir)..Shishi.*
│ │ │ │ +00000390: 2a2a 2a2a 2a0a 0a54 6869 7320 6d61 6e75  *****..This manu
│ │ │ │ +000003a0: 616c 2069 7320 6c61 7374 2075 7064 6174  al is last updat
│ │ │ │ +000003b0: 6564 2031 3420 4d61 7263 6820 3230 3236  ed 14 March 2026
│ │ │ │ +000003c0: 2066 6f72 2076 6572 7369 6f6e 2031 2e30   for version 1.0
│ │ │ │ +000003d0: 2e33 206f 6620 5368 6973 6869 2e0a 0a20  .3 of Shishi... 
│ │ │ │ +000003e0: 2020 436f 7079 7269 6768 7420 c2a9 2032    Copyright .. 2
│ │ │ │ +000003f0: 3030 322d 3230 3232 2053 696d 6f6e 204a  002-2022 Simon J
│ │ │ │ +00000400: 6f73 6566 7373 6f6e 2e0a 0a20 2020 2020  osefsson...     
│ │ │ │ +00000410: 5065 726d 6973 7369 6f6e 2069 7320 6772  Permission is gr
│ │ │ │ +00000420: 616e 7465 6420 746f 2063 6f70 792c 2064  anted to copy, d
│ │ │ │ +00000430: 6973 7472 6962 7574 6520 616e 642f 6f72  istribute and/or
│ │ │ │ +00000440: 206d 6f64 6966 7920 7468 6973 0a20 2020   modify this.   
│ │ │ │ +00000450: 2020 646f 6375 6d65 6e74 2075 6e64 6572    document under
│ │ │ │ +00000460: 2074 6865 2074 6572 6d73 206f 6620 7468   the terms of th
│ │ │ │ +00000470: 6520 474e 5520 4672 6565 2044 6f63 756d  e GNU Free Docum
│ │ │ │ +00000480: 656e 7461 7469 6f6e 204c 6963 656e 7365  entation License
│ │ │ │ +00000490: 2c0a 2020 2020 2056 6572 7369 6f6e 2031  ,.     Version 1
│ │ │ │ +000004a0: 2e33 206f 7220 616e 7920 6c61 7465 7220  .3 or any later 
│ │ │ │ +000004b0: 7665 7273 696f 6e20 7075 626c 6973 6865  version publishe
│ │ │ │ +000004c0: 6420 6279 2074 6865 2046 7265 6520 536f  d by the Free So
│ │ │ │ +000004d0: 6674 7761 7265 0a20 2020 2020 466f 756e  ftware.     Foun
│ │ │ │ +000004e0: 6461 7469 6f6e 3b20 7769 7468 206e 6f20  dation; with no 
│ │ │ │ +000004f0: 496e 7661 7269 616e 7420 5365 6374 696f  Invariant Sectio
│ │ │ │ +00000500: 6e73 2c20 6e6f 2046 726f 6e74 2d43 6f76  ns, no Front-Cov
│ │ │ │ +00000510: 6572 2054 6578 7473 2c20 616e 640a 2020  er Texts, and.  
│ │ │ │ +00000520: 2020 206e 6f20 4261 636b 2d43 6f76 6572     no Back-Cover
│ │ │ │ +00000530: 2054 6578 7473 2e20 2041 2063 6f70 7920   Texts.  A copy 
│ │ │ │ +00000540: 6f66 2074 6865 206c 6963 656e 7365 2069  of the license i
│ │ │ │ +00000550: 7320 696e 636c 7564 6564 2069 6e20 7468  s included in th
│ │ │ │ +00000560: 650a 2020 2020 2073 6563 7469 6f6e 2065  e.     section e
│ │ │ │ +00000570: 6e74 6974 6c65 6420 2247 4e55 2046 7265  ntitled "GNU Fre
│ │ │ │ +00000580: 6520 446f 6375 6d65 6e74 6174 696f 6e20  e Documentation 
│ │ │ │ +00000590: 4c69 6365 6e73 6522 2e0a 0a2a 204d 656e  License"...* Men
│ │ │ │ +000005a0: 753a 0a0a 2a20 496e 7472 6f64 7563 7469  u:..* Introducti
│ │ │ │ +000005b0: 6f6e 3a3a 2020 2020 2020 2020 2020 2020  on::            
│ │ │ │ +000005c0: 2020 2020 486f 7720 746f 2075 7365 2074      How to use t
│ │ │ │ +000005d0: 6869 7320 6d61 6e75 616c 2e0a 2a20 5573  his manual..* Us
│ │ │ │ +000005e0: 6572 204d 616e 7561 6c3a 3a20 2020 2020  er Manual::     
│ │ │ │ +000005f0: 2020 2020 2020 2020 2020 2020 5573 696e              Usin
│ │ │ │ +00000600: 6720 5368 6973 6869 2061 7320 656e 642d  g Shishi as end-
│ │ │ │ +00000610: 7573 6572 2e0a 2a20 4164 6d69 6e69 7374  user..* Administ
│ │ │ │ +00000620: 7261 7469 6f6e 204d 616e 7561 6c3a 3a20  ration Manual:: 
│ │ │ │ +00000630: 2020 2020 2020 4164 6d69 6e69 7374 7261        Administra
│ │ │ │ +00000640: 7469 6e67 2073 6572 7665 7220 6173 7065  ting server aspe
│ │ │ │ +00000650: 6374 7320 6f66 2053 6869 7368 692e 0a2a  cts of Shishi..*
│ │ │ │ +00000660: 2052 6566 6572 656e 6365 204d 616e 7561   Reference Manua
│ │ │ │ +00000670: 6c3a 3a20 2020 2020 2020 2020 2020 2044  l::            D
│ │ │ │ +00000680: 6574 6169 6c65 6420 6465 7363 7269 7074  etailed descript
│ │ │ │ +00000690: 696f 6e20 6f66 2063 6f6e 6669 6720 6669  ion of config fi
│ │ │ │ +000006a0: 6c65 732c 2065 7463 2e0a 2a20 5072 6f67  les, etc..* Prog
│ │ │ │ +000006b0: 7261 6d6d 696e 6720 4d61 6e75 616c 3a3a  ramming Manual::
│ │ │ │ +000006c0: 2020 2020 2020 2020 2020 4361 6c6c 696e            Callin
│ │ │ │ +000006d0: 6720 5368 6973 6869 2066 726f 6d20 6120  g Shishi from a 
│ │ │ │ +000006e0: 7072 6f67 7261 6d6d 696e 6720 6c61 6e67  programming lang
│ │ │ │ +000006f0: 7561 6765 2e0a 2a20 4163 6b6e 6f77 6c65  uage..* Acknowle
│ │ │ │ +00000700: 6467 656d 656e 7473 3a3a 2020 2020 2020  dgements::      
│ │ │ │ +00000710: 2020 2020 2020 5768 6f6d 2074 6f20 626c        Whom to bl
│ │ │ │ +00000720: 616d 652e 0a0a 4170 7065 6e64 6963 6573  ame...Appendices
│ │ │ │ +00000730: 0a0a 2a20 4372 6974 6963 6973 6d20 6f66  ..* Criticism of
│ │ │ │ +00000740: 204b 6572 6265 726f 733a 3a20 2020 2020   Kerberos::     
│ │ │ │ +00000750: 2020 5768 7920 796f 7520 6d61 7962 6520    Why you maybe 
│ │ │ │ +00000760: 7368 6f75 6c64 6e27 7420 7573 6520 4b65  shouldn't use Ke
│ │ │ │ +00000770: 7262 6572 6f73 2e0a 2a20 5072 6f74 6f63  rberos..* Protoc
│ │ │ │ +00000780: 6f6c 2045 7874 656e 7369 6f6e 733a 3a20  ol Extensions:: 
│ │ │ │ +00000790: 2020 2020 2020 2020 4465 7363 7269 7074          Descript
│ │ │ │ +000007a0: 696f 6e20 6f66 2070 726f 746f 636f 6c20  ion of protocol 
│ │ │ │ +000007b0: 6578 7465 6e73 696f 6e73 2075 7365 642e  extensions used.
│ │ │ │ +000007c0: 0a2a 2043 6f70 7969 6e67 2049 6e66 6f72  .* Copying Infor
│ │ │ │ +000007d0: 6d61 7469 6f6e 3a3a 2020 2020 2020 2020  mation::        
│ │ │ │ +000007e0: 2048 6f77 2079 6f75 2063 616e 2063 6f70   How you can cop
│ │ │ │ +000007f0: 7920 616e 6420 7368 6172 6520 5368 6973  y and share Shis
│ │ │ │ +00000800: 6869 2e0a 0a49 6e64 6963 6573 0a0a 2a20  hi...Indices..* 
│ │ │ │ +00000810: 4675 6e63 7469 6f6e 2061 6e64 2044 6174  Function and Dat
│ │ │ │ +00000820: 6120 496e 6465 783a 3a20 2020 2020 496e  a Index::     In
│ │ │ │ +00000830: 6465 7820 6f66 2066 756e 6374 696f 6e73  dex of functions
│ │ │ │ +00000840: 2c20 7661 7269 6162 6c65 7320 616e 6420  , variables and 
│ │ │ │ +00000850: 6461 7461 2074 7970 6573 2e0a 2a20 436f  data types..* Co
│ │ │ │ +00000860: 6e63 6570 7420 496e 6465 783a 3a20 2020  ncept Index::   
│ │ │ │ +00000870: 2020 2020 2020 2020 2020 2020 496e 6465              Inde
│ │ │ │ +00000880: 7820 6f66 2063 6f6e 6365 7074 7320 616e  x of concepts an
│ │ │ │ +00000890: 6420 7072 6f67 7261 6d73 2e0a 0a1f 0a46  d programs.....F
│ │ │ │ +000008a0: 696c 653a 2073 6869 7368 692e 696e 666f  ile: shishi.info
│ │ │ │ +000008b0: 2c20 204e 6f64 653a 2049 6e74 726f 6475  ,  Node: Introdu
│ │ │ │ +000008c0: 6374 696f 6e2c 2020 4e65 7874 3a20 5573  ction,  Next: Us
│ │ │ │ +000008d0: 6572 204d 616e 7561 6c2c 2020 5072 6576  er Manual,  Prev
│ │ │ │ +000008e0: 3a20 546f 702c 2020 5570 3a20 546f 700a  : Top,  Up: Top.
│ │ │ │ +000008f0: 0a31 2049 6e74 726f 6475 6374 696f 6e0a  .1 Introduction.
│ │ │ │ +00000900: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a  **************..
│ │ │ │ +00000910: 5368 6973 6869 2069 6d70 6c65 6d65 6e74  Shishi implement
│ │ │ │ +00000920: 7320 7468 6520 4b65 7262 6572 6f73 206e  s the Kerberos n
│ │ │ │ +00000930: 6574 776f 726b 2061 7574 6865 6e74 6963  etwork authentic
│ │ │ │ +00000940: 6174 696f 6e20 7379 7374 656d 2e20 2053  ation system.  S
│ │ │ │ +00000950: 6869 7368 690a 6361 6e20 6265 2075 7365  hishi.can be use
│ │ │ │ +00000960: 6420 746f 2061 7574 6865 6e74 6963 6174  d to authenticat
│ │ │ │ +00000970: 6520 7573 6572 7320 696e 2064 6973 7472  e users in distr
│ │ │ │ +00000980: 6962 7574 6564 2073 7973 7465 6d73 2c20  ibuted systems, 
│ │ │ │ +00000990: 616e 6420 6973 206d 6f73 740a 6f66 7465  and is most.ofte
│ │ │ │ +000009a0: 6e20 7573 6564 2076 6961 2047 5353 2d41  n used via GSS-A
│ │ │ │ +000009b0: 5049 2066 6f72 2053 5348 206f 7220 7669  PI for SSH or vi
│ │ │ │ +000009c0: 6120 5341 534c 2066 6f72 2049 4d41 502f  a SASL for IMAP/
│ │ │ │ +000009d0: 504f 5033 2e0a 0a20 2020 5368 6973 6869  POP3...   Shishi
│ │ │ │ +000009e0: 2063 6f6e 7461 696e 7320 6120 6c69 6272   contains a libr
│ │ │ │ +000009f0: 6172 7920 2827 6c69 6273 6869 7368 6927  ary ('libshishi'
│ │ │ │ +00000a00: 2920 7468 6174 2063 616e 2062 6520 7573  ) that can be us
│ │ │ │ +00000a10: 6564 2062 790a 6170 706c 6963 6174 696f  ed by.applicatio
│ │ │ │ +00000a20: 6e20 6465 7665 6c6f 7065 7273 2074 6f20  n developers to 
│ │ │ │ +00000a30: 6164 6420 7375 7070 6f72 7420 666f 7220  add support for 
│ │ │ │ +00000a40: 4b65 7262 6572 6f73 2035 2e20 2054 6865  Kerberos 5.  The
│ │ │ │ +00000a50: 7265 2069 7320 616c 736f 2061 0a63 6f6d  re is also a.com
│ │ │ │ +00000a60: 6d61 6e64 206c 696e 6520 7574 696c 6974  mand line utilit
│ │ │ │ +00000a70: 7920 2827 7368 6973 6869 2729 2074 6861  y ('shishi') tha
│ │ │ │ +00000a80: 7420 6973 2075 7365 6420 6279 2075 7365  t is used by use
│ │ │ │ +00000a90: 7273 2074 6f20 6163 7175 6972 6520 616e  rs to acquire an
│ │ │ │ +00000aa0: 640a 6d61 6e61 6765 2074 6963 6b65 7473  d.manage tickets
│ │ │ │ +00000ab0: 2e20 2054 6865 2073 6572 7665 7220 7369  .  The server si
│ │ │ │ +00000ac0: 6465 2c20 6120 4b65 7920 4469 7374 7269  de, a Key Distri
│ │ │ │ +00000ad0: 6275 7469 6f6e 2043 656e 7465 722c 2069  bution Center, i
│ │ │ │ +00000ae0: 730a 696d 706c 656d 656e 7465 6420 6279  s.implemented by
│ │ │ │ +00000af0: 2027 7368 6973 6869 6427 2e20 204f 6620   'shishid'.  Of 
│ │ │ │ +00000b00: 636f 7572 7365 2c20 6120 6d61 6e75 616c  course, a manual
│ │ │ │ +00000b10: 2064 6f63 756d 656e 7469 6e67 2075 7361   documenting usa
│ │ │ │ +00000b20: 6765 2061 7370 6563 7473 0a61 7320 7765  ge aspects.as we
│ │ │ │ +00000b30: 6c6c 2061 7320 7468 6520 7072 6f67 7261  ll as the progra
│ │ │ │ +00000b40: 6d6d 696e 6720 4150 4920 6973 2069 6e63  mming API is inc
│ │ │ │ +00000b50: 6c75 6465 642e 0a0a 2020 2053 6869 7368  luded...   Shish
│ │ │ │ +00000b60: 6920 6375 7272 656e 746c 7920 7375 7070  i currently supp
│ │ │ │ +00000b70: 6f72 7473 2041 532f 5447 5320 6578 6368  orts AS/TGS exch
│ │ │ │ +00000b80: 616e 6765 7320 666f 7220 6163 7175 6972  anges for acquir
│ │ │ │ +00000b90: 696e 6720 7469 636b 6574 732c 0a70 7265  ing tickets,.pre
│ │ │ │ +00000ba0: 2d61 7574 6865 6e74 6963 6174 696f 6e2c  -authentication,
│ │ │ │ +00000bb0: 2074 6865 2041 5020 6578 6368 616e 6765   the AP exchange
│ │ │ │ +00000bc0: 2066 6f72 2070 6572 666f 726d 696e 6720   for performing 
│ │ │ │ +00000bd0: 636c 6965 6e74 2061 6e64 2073 6572 7665  client and serve
│ │ │ │ +00000be0: 720a 6175 7468 656e 7469 6361 7469 6f6e  r.authentication
│ │ │ │ +00000bf0: 2c20 616e 6420 5341 4645 2f50 5249 5620  , and SAFE/PRIV 
│ │ │ │ +00000c00: 666f 7220 696e 7465 6772 6974 792f 7072  for integrity/pr
│ │ │ │ +00000c10: 6976 6163 7920 7072 6f74 6563 7465 640a  ivacy protected.
│ │ │ │ +00000c20: 6170 706c 6963 6174 696f 6e20 6461 7461  application data
│ │ │ │ +00000c30: 2065 7863 6861 6e67 6573 2e0a 0a20 2020   exchanges...   
│ │ │ │ +00000c40: 5368 6973 6869 2069 7320 696e 7465 726e  Shishi is intern
│ │ │ │ +00000c50: 6174 696f 6e61 6c69 7a65 643b 2065 7272  ationalized; err
│ │ │ │ +00000c60: 6f72 2061 6e64 2073 7461 7475 7320 6d65  or and status me
│ │ │ │ +00000c70: 7373 6167 6573 2063 616e 2062 650a 7472  ssages can be.tr
│ │ │ │ +00000c80: 616e 736c 6174 6564 2069 6e74 6f20 7468  anslated into th
│ │ │ │ +00000c90: 6520 7573 6572 7327 206c 616e 6775 6167  e users' languag
│ │ │ │ +00000ca0: 653b 2075 7365 7220 6e61 6d65 2061 6e64  e; user name and
│ │ │ │ +00000cb0: 2070 6173 7377 6f72 6473 2063 616e 2062   passwords can b
│ │ │ │ +00000cc0: 650a 636f 6e76 6572 7465 6420 696e 746f  e.converted into
│ │ │ │ +00000cd0: 2061 6e79 2061 7661 696c 6162 6c65 2063   any available c
│ │ │ │ +00000ce0: 6861 7261 6374 6572 2073 6574 2028 6e6f  haracter set (no
│ │ │ │ +00000cf0: 726d 616c 6c79 2069 6e63 6c75 6469 6e67  rmally including
│ │ │ │ +00000d00: 0a49 534f 2d38 3835 392d 3120 616e 6420  .ISO-8859-1 and 
│ │ │ │ +00000d10: 5554 462d 3829 2061 6e64 2061 6c73 6f20  UTF-8) and also 
│ │ │ │ +00000d20: 6265 2070 726f 6365 7373 6564 2075 7369  be processed usi
│ │ │ │ +00000d30: 6e67 2061 6e20 6578 7065 7269 6d65 6e74  ng an experiment
│ │ │ │ +00000d40: 616c 0a53 7472 696e 6770 7265 7020 7072  al.Stringprep pr
│ │ │ │ +00000d50: 6f66 696c 652e 0a0a 2020 204d 6f73 742c  ofile...   Most,
│ │ │ │ +00000d60: 2069 6620 6e6f 7420 616c 6c2c 206f 6620   if not all, of 
│ │ │ │ +00000d70: 7468 6520 7769 6465 6c79 2075 7365 6420  the widely used 
│ │ │ │ +00000d80: 656e 6372 7970 7469 6f6e 2061 6e64 2063  encryption and c
│ │ │ │ +00000d90: 6865 636b 7375 6d20 7479 7065 730a 6172  hecksum types.ar
│ │ │ │ +00000da0: 6520 7375 7070 6f72 7465 642c 2073 7563  e supported, suc
│ │ │ │ +00000db0: 6820 6173 2033 4445 532c 2041 4553 2c20  h as 3DES, AES, 
│ │ │ │ +00000dc0: 4152 4346 4f55 5220 616e 6420 484d 4143  ARCFOUR and HMAC
│ │ │ │ +00000dd0: 2d53 4841 312e 0a0a 2020 2053 6869 7368  -SHA1...   Shish
│ │ │ │ +00000de0: 6920 6973 2064 6576 656c 6f70 6564 2066  i is developed f
│ │ │ │ +00000df0: 6f72 2074 6865 2047 4e55 2f4c 696e 7578  or the GNU/Linux
│ │ │ │ +00000e00: 2073 7973 7465 6d20 6275 7420 776f 726b   system but work
│ │ │ │ +00000e10: 7320 6f6e 206d 616e 790a 706c 6174 666f  s on many.platfo
│ │ │ │ +00000e20: 726d 7320 696e 636c 7564 696e 6720 6d6f  rms including mo
│ │ │ │ +00000e30: 7374 206d 616a 6f72 2055 6e69 7820 616e  st major Unix an
│ │ │ │ +00000e40: 6420 5769 6e64 6f77 7320 7379 7374 656d  d Windows system
│ │ │ │ +00000e50: 732e 0a0a 2020 2053 6869 7368 6920 6973  s...   Shishi is
│ │ │ │ +00000e60: 2066 7265 6520 736f 6674 7761 7265 206c   free software l
│ │ │ │ +00000e70: 6963 656e 7365 6420 756e 6465 7220 7468  icensed under th
│ │ │ │ +00000e80: 6520 474e 5520 4765 6e65 7261 6c20 5075  e GNU General Pu
│ │ │ │ +00000e90: 626c 6963 204c 6963 656e 7365 0a76 6572  blic License.ver
│ │ │ │ +00000ea0: 7369 6f6e 2033 2e30 206f 7220 6c61 7465  sion 3.0 or late
│ │ │ │ +00000eb0: 722e 0a0a 2a20 4d65 6e75 3a0a 0a2a 2047  r...* Menu:..* G
│ │ │ │ +00000ec0: 6574 7469 6e67 2053 7461 7274 6564 3a3a  etting Started::
│ │ │ │ +00000ed0: 0a2a 2046 6561 7475 7265 7320 616e 6420  .* Features and 
│ │ │ │ +00000ee0: 5374 6174 7573 3a3a 0a2a 204f 7665 7276  Status::.* Overv
│ │ │ │ +00000ef0: 6965 773a 3a0a 2a20 4372 7970 746f 6772  iew::.* Cryptogr
│ │ │ │ +00000f00: 6170 6869 6320 4f76 6572 7669 6577 3a3a  aphic Overview::
│ │ │ │ +00000f10: 0a2a 2053 7570 706f 7274 6564 2050 6c61  .* Supported Pla
│ │ │ │ +00000f20: 7466 6f72 6d73 3a3a 0a2a 2047 6574 7469  tforms::.* Getti
│ │ │ │ +00000f30: 6e67 2068 656c 703a 3a0a 2a20 446f 776e  ng help::.* Down
│ │ │ │ +00000f40: 6c6f 6164 696e 6720 616e 6420 496e 7374  loading and Inst
│ │ │ │ +00000f50: 616c 6c69 6e67 3a3a 0a2a 2042 7567 2052  alling::.* Bug R
│ │ │ │ +00000f60: 6570 6f72 7473 3a3a 0a2a 2043 6f6e 7472  eports::.* Contr
│ │ │ │ +00000f70: 6962 7574 696e 673a 3a0a 0a1f 0a46 696c  ibuting::....Fil
│ │ │ │ +00000f80: 653a 2073 6869 7368 692e 696e 666f 2c20  e: shishi.info, 
│ │ │ │ +00000f90: 204e 6f64 653a 2047 6574 7469 6e67 2053   Node: Getting S
│ │ │ │ +00000fa0: 7461 7274 6564 2c20 204e 6578 743a 2046  tarted,  Next: F
│ │ │ │ +00000fb0: 6561 7475 7265 7320 616e 6420 5374 6174  eatures and Stat
│ │ │ │ +00000fc0: 7573 2c20 2055 703a 2049 6e74 726f 6475  us,  Up: Introdu
│ │ │ │ +00000fd0: 6374 696f 6e0a 0a31 2e31 2047 6574 7469  ction..1.1 Getti
│ │ │ │ +00000fe0: 6e67 2053 7461 7274 6564 0a3d 3d3d 3d3d  ng Started.=====
│ │ │ │ +00000ff0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a  ==============..
│ │ │ │ +00001000: 5468 6973 206d 616e 7561 6c20 646f 6375  This manual docu
│ │ │ │ +00001010: 6d65 6e74 7320 7468 6520 5368 6973 6869  ments the Shishi
│ │ │ │ +00001020: 2061 7070 6c69 6361 7469 6f6e 2061 6e64   application and
│ │ │ │ +00001030: 206c 6962 7261 7279 2070 726f 6772 616d   library program
│ │ │ │ +00001040: 6d69 6e67 0a69 6e74 6572 6661 6365 2e20  ming.interface. 
│ │ │ │ +00001050: 2041 6c6c 2063 6f6d 6d61 6e64 732c 2066   All commands, f
│ │ │ │ +00001060: 756e 6374 696f 6e73 2061 6e64 2064 6174  unctions and dat
│ │ │ │ +00001070: 6120 7479 7065 7320 7072 6f76 6964 6564  a types provided
│ │ │ │ +00001080: 2062 7920 5368 6973 6869 0a61 7265 2065   by Shishi.are e
│ │ │ │ +00001090: 7870 6c61 696e 6564 2e0a 0a20 2020 5468  xplained...   Th
│ │ │ │ +000010a0: 6520 7265 6164 6572 2069 7320 6173 7375  e reader is assu
│ │ │ │ +000010b0: 6d65 6420 746f 2070 6f73 7365 7373 2062  med to possess b
│ │ │ │ +000010c0: 6173 6963 2066 616d 696c 6961 7269 7479  asic familiarity
│ │ │ │ +000010d0: 2077 6974 6820 6e65 7477 6f72 6b0a 7365   with network.se
│ │ │ │ +000010e0: 6375 7269 7479 2061 6e64 2074 6865 204b  curity and the K
│ │ │ │ +000010f0: 6572 6265 726f 7320 3520 7365 6375 7269  erberos 5 securi
│ │ │ │ +00001100: 7479 2073 7973 7465 6d2e 0a0a 2020 2054  ty system...   T
│ │ │ │ +00001110: 6869 7320 6d61 6e75 616c 2063 616e 2062  his manual can b
│ │ │ │ +00001120: 6520 7573 6564 2069 6e20 7365 7665 7261  e used in severa
│ │ │ │ +00001130: 6c20 7761 7973 2e20 2049 6620 7265 6164  l ways.  If read
│ │ │ │ +00001140: 2066 726f 6d20 7468 6520 6265 6769 6e6e   from the beginn
│ │ │ │ +00001150: 696e 670a 746f 2074 6865 2065 6e64 2c20  ing.to the end, 
│ │ │ │ +00001160: 6974 2067 6976 6573 2061 2067 6f6f 6420  it gives a good 
│ │ │ │ +00001170: 696e 7472 6f64 7563 7469 6f6e 2069 6e74  introduction int
│ │ │ │ +00001180: 6f20 7468 6520 6c69 6272 6172 7920 616e  o the library an
│ │ │ │ +00001190: 6420 686f 7720 6974 2063 616e 0a62 6520  d how it can.be 
│ │ │ │ +000011a0: 7573 6564 2069 6e20 616e 2061 7070 6c69  used in an appli
│ │ │ │ +000011b0: 6361 7469 6f6e 2e20 2046 6f72 7761 7264  cation.  Forward
│ │ │ │ +000011c0: 2072 6566 6572 656e 6365 7320 6172 6520   references are 
│ │ │ │ +000011d0: 696e 636c 7564 6564 2077 6865 7265 0a6e  included where.n
│ │ │ │ +000011e0: 6563 6573 7361 7279 2e20 204c 6174 6572  ecessary.  Later
│ │ │ │ +000011f0: 206f 6e2c 2074 6865 206d 616e 7561 6c20   on, the manual 
│ │ │ │ +00001200: 6361 6e20 6265 2075 7365 6420 6173 2061  can be used as a
│ │ │ │ +00001210: 2072 6566 6572 656e 6365 206d 616e 7561   reference manua
│ │ │ │ +00001220: 6c20 746f 0a67 6574 206a 7573 7420 7468  l to.get just th
│ │ │ │ +00001230: 6520 696e 666f 726d 6174 696f 6e20 6e65  e information ne
│ │ │ │ +00001240: 6564 6564 2061 626f 7574 2061 6e79 2070  eded about any p
│ │ │ │ +00001250: 6172 7469 6375 6c61 7220 696e 7465 7266  articular interf
│ │ │ │ +00001260: 6163 6520 6f66 2074 6865 0a6c 6962 7261  ace of the.libra
│ │ │ │ +00001270: 7279 2e20 2045 7870 6572 6965 6e63 6564  ry.  Experienced
│ │ │ │ +00001280: 2070 726f 6772 616d 6d65 7273 206d 6967   programmers mig
│ │ │ │ +00001290: 6874 2077 616e 7420 746f 2073 7461 7274  ht want to start
│ │ │ │ +000012a0: 206c 6f6f 6b69 6e67 2061 7420 7468 650a   looking at the.
│ │ │ │ +000012b0: 6578 616d 706c 6573 2061 7420 7468 6520  examples at the 
│ │ │ │ +000012c0: 656e 6420 6f66 2074 6865 206d 616e 7561  end of the manua
│ │ │ │ +000012d0: 6c2c 2061 6e64 2074 6865 6e20 6f6e 6c79  l, and then only
│ │ │ │ +000012e0: 2072 6561 6420 7570 206f 6e20 7468 6f73   read up on thos
│ │ │ │ +000012f0: 6520 7061 7274 730a 6f66 2074 6865 2069  e parts.of the i
│ │ │ │ +00001300: 6e74 6572 6661 6365 2077 6869 6368 2061  nterface which a
│ │ │ │ +00001310: 7265 2075 6e63 6c65 6172 2e0a 0a1f 0a46  re unclear.....F
│ │ │ │ +00001320: 696c 653a 2073 6869 7368 692e 696e 666f  ile: shishi.info
│ │ │ │ +00001330: 2c20 204e 6f64 653a 2046 6561 7475 7265  ,  Node: Feature
│ │ │ │ +00001340: 7320 616e 6420 5374 6174 7573 2c20 204e  s and Status,  N
│ │ │ │ +00001350: 6578 743a 204f 7665 7276 6965 772c 2020  ext: Overview,  
│ │ │ │ +00001360: 5072 6576 3a20 4765 7474 696e 6720 5374  Prev: Getting St
│ │ │ │ +00001370: 6172 7465 642c 2020 5570 3a20 496e 7472  arted,  Up: Intr
│ │ │ │ +00001380: 6f64 7563 7469 6f6e 0a0a 312e 3220 4665  oduction..1.2 Fe
│ │ │ │ +00001390: 6174 7572 6573 2061 6e64 2053 7461 7475  atures and Statu
│ │ │ │ +000013a0: 730a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  s.==============
│ │ │ │ +000013b0: 3d3d 3d3d 3d3d 3d3d 3d0a 0a53 6869 7368  =========..Shish
│ │ │ │ +000013c0: 6920 6d69 6768 7420 6861 7665 2061 2063  i might have a c
│ │ │ │ +000013d0: 6f75 706c 6520 6f66 2061 6476 616e 7461  ouple of advanta
│ │ │ │ +000013e0: 6765 7320 6f76 6572 206f 7468 6572 2070  ges over other p
│ │ │ │ +000013f0: 6163 6b61 6765 7320 646f 696e 6720 610a  ackages doing a.
│ │ │ │ +00001400: 7369 6d69 6c61 7220 6a6f 622e 0a0a 4974  similar job...It
│ │ │ │ +00001410: 2773 2046 7265 6520 536f 6674 7761 7265  's Free Software
│ │ │ │ +00001420: 0a20 2020 2020 416e 7962 6f64 7920 6361  .     Anybody ca
│ │ │ │ +00001430: 6e20 7573 652c 206d 6f64 6966 792c 2061  n use, modify, a
│ │ │ │ +00001440: 6e64 2072 6564 6973 7472 6962 7574 6520  nd redistribute 
│ │ │ │ +00001450: 6974 2075 6e64 6572 2074 6865 2074 6572  it under the ter
│ │ │ │ +00001460: 6d73 206f 6620 7468 650a 2020 2020 2047  ms of the.     G
│ │ │ │ +00001470: 4e55 2047 656e 6572 616c 2050 7562 6c69  NU General Publi
│ │ │ │ +00001480: 6320 4c69 6365 6e73 6520 7665 7273 696f  c License versio
│ │ │ │ +00001490: 6e20 332e 3020 6f72 206c 6174 6572 2e0a  n 3.0 or later..
│ │ │ │ +000014a0: 0a49 7427 7320 7468 7265 6164 2d73 6166  .It's thread-saf
│ │ │ │ +000014b0: 650a 2020 2020 2054 6865 206c 6962 7261  e.     The libra
│ │ │ │ +000014c0: 7279 2075 7365 7320 6e6f 2067 6c6f 6261  ry uses no globa
│ │ │ │ +000014d0: 6c20 7661 7269 6162 6c65 732e 0a0a 4974  l variables...It
│ │ │ │ +000014e0: 2773 2069 6e74 6572 6e61 7469 6f6e 616c  's international
│ │ │ │ +000014f0: 697a 6564 0a20 2020 2020 4974 2068 616e  ized.     It han
│ │ │ │ +00001500: 646c 6573 206e 6f6e 2d41 5343 4949 2075  dles non-ASCII u
│ │ │ │ +00001510: 7365 726e 616d 6520 616e 6420 7061 7373  sername and pass
│ │ │ │ +00001520: 776f 7264 732c 2061 6e64 2075 7365 7220  words, and user 
│ │ │ │ +00001530: 7669 7369 626c 650a 2020 2020 2073 7472  visible.     str
│ │ │ │ +00001540: 696e 6773 2075 7365 6420 696e 2074 6865  ings used in the
│ │ │ │ +00001550: 206c 6962 7261 7279 2028 6572 726f 7220   library (error 
│ │ │ │ +00001560: 6d65 7373 6167 6573 2920 6361 6e20 6265  messages) can be
│ │ │ │ +00001570: 2074 7261 6e73 6c61 7465 6420 696e 746f   translated into
│ │ │ │ +00001580: 0a20 2020 2020 7468 6520 7573 6572 7327  .     the users'
│ │ │ │ +00001590: 206c 616e 6775 6167 652e 0a0a 4974 2773   language...It's
│ │ │ │ +000015a0: 2070 6f72 7461 626c 650a 2020 2020 2049   portable.     I
│ │ │ │ +000015b0: 7420 7368 6f75 6c64 2077 6f72 6b20 6f6e  t should work on
│ │ │ │ +000015c0: 2061 6c6c 2055 6e69 7820 6c69 6b65 206f   all Unix like o
│ │ │ │ +000015d0: 7065 7261 7469 6e67 2073 7973 7465 6d73  perating systems
│ │ │ │ +000015e0: 2c20 696e 636c 7564 696e 670a 2020 2020  , including.    
│ │ │ │ +000015f0: 2057 696e 646f 7773 2e0a 0a20 2020 5368   Windows...   Sh
│ │ │ │ +00001600: 6973 6869 2069 7320 6661 7220 6672 6f6d  ishi is far from
│ │ │ │ +00001610: 2066 6561 7475 7265 2063 6f6d 706c 6574   feature complet
│ │ │ │ +00001620: 652c 2069 7420 6973 206e 6f74 2065 7665  e, it is not eve
│ │ │ │ +00001630: 6e20 6120 6675 6c6c 2052 4643 2034 3132  n a full RFC 412
│ │ │ │ +00001640: 300a 696d 706c 656d 656e 7461 7469 6f6e  0.implementation
│ │ │ │ +00001650: 2079 6574 2e20 2048 6f77 6576 6572 2c20   yet.  However, 
│ │ │ │ +00001660: 736f 6d65 2062 6173 6963 2066 756e 6374  some basic funct
│ │ │ │ +00001670: 696f 6e61 6c69 7479 2069 7320 696d 706c  ionality is impl
│ │ │ │ +00001680: 656d 656e 7465 642e 0a41 2066 6577 2069  emented..A few i
│ │ │ │ +00001690: 6d70 6c65 6d65 6e74 6564 2066 6561 7475  mplemented featu
│ │ │ │ +000016a0: 7265 2061 7265 206d 656e 7469 6f6e 6564  re are mentioned
│ │ │ │ +000016b0: 2062 656c 6f77 2e0a 0a20 2020 e280 a220   below...   ... 
│ │ │ │ +000016c0: 496e 6974 6961 6c20 6175 7468 656e 7469  Initial authenti
│ │ │ │ +000016d0: 6361 7469 6f6e 2028 4153 2920 6672 6f6d  cation (AS) from
│ │ │ │ +000016e0: 2072 6177 206b 6579 206f 7220 7061 7373   raw key or pass
│ │ │ │ +000016f0: 776f 7264 2e20 2054 6869 7320 7374 6570  word.  This step
│ │ │ │ +00001700: 2069 730a 2020 2020 2074 7970 6963 616c   is.     typical
│ │ │ │ +00001710: 6c79 2075 7365 6420 746f 2061 6371 7569  ly used to acqui
│ │ │ │ +00001720: 7265 2061 2074 6963 6b65 7420 6772 616e  re a ticket gran
│ │ │ │ +00001730: 7469 6e67 2074 6963 6b65 7420 616e 642c  ting ticket and,
│ │ │ │ +00001740: 206c 6573 730a 2020 2020 2063 6f6d 6d6f   less.     commo
│ │ │ │ +00001750: 6e6c 792c 2061 2073 6572 7665 7220 7469  nly, a server ti
│ │ │ │ +00001760: 636b 6574 2e0a 0a20 2020 e280 a220 5375  cket...   ... Su
│ │ │ │ +00001770: 6273 6571 7565 6e74 2061 7574 6865 6e74  bsequent authent
│ │ │ │ +00001780: 6963 6174 696f 6e20 2854 4753 292e 2054  ication (TGS). T
│ │ │ │ +00001790: 6869 7320 7374 6570 2069 7320 7479 7069  his step is typi
│ │ │ │ +000017a0: 6361 6c6c 7920 7573 6564 2074 6f0a 2020  cally used to.  
│ │ │ │ +000017b0: 2020 2061 6371 7569 7265 2061 2073 6572     acquire a ser
│ │ │ │ +000017c0: 7665 7220 7469 636b 6574 2c20 6279 2061  ver ticket, by a
│ │ │ │ +000017d0: 7574 6865 6e74 6963 6174 696e 6720 796f  uthenticating yo
│ │ │ │ +000017e0: 7572 7365 6c66 2075 7369 6e67 2074 6865  urself using the
│ │ │ │ +000017f0: 0a20 2020 2020 7469 636b 6574 2067 7261  .     ticket gra
│ │ │ │ +00001800: 6e74 696e 6720 7469 636b 6574 2e0a 0a20  nting ticket... 
│ │ │ │ +00001810: 2020 e280 a220 436c 6965 6e74 2d53 6572    ... Client-Ser
│ │ │ │ +00001820: 7665 7220 6175 7468 656e 7469 6361 7469  ver authenticati
│ │ │ │ +00001830: 6f6e 2028 4150 292e 2054 6869 7320 7374  on (AP). This st
│ │ │ │ +00001840: 6570 2069 7320 7573 6564 2062 7920 636c  ep is used by cl
│ │ │ │ +00001850: 6965 6e74 7320 616e 640a 2020 2020 2073  ients and.     s
│ │ │ │ +00001860: 6572 7665 7273 2074 6f20 7072 6f76 6520  ervers to prove 
│ │ │ │ +00001870: 746f 2065 6163 6820 6f74 6865 7220 7768  to each other wh
│ │ │ │ +00001880: 6f20 7468 6579 2061 7265 2c20 7573 696e  o they are, usin
│ │ │ │ +00001890: 6720 6e65 676f 7469 6174 6564 0a20 2020  g negotiated.   
│ │ │ │ +000018a0: 2020 7469 636b 6574 732e 0a0a 2020 20e2    tickets...   .
│ │ │ │ +000018b0: 80a2 2049 6e74 6567 7269 7479 2070 726f  .. Integrity pro
│ │ │ │ +000018c0: 7465 6374 6564 2063 6f6d 6d75 6e69 6361  tected communica
│ │ │ │ +000018d0: 7469 6f6e 2028 5341 4645 292e 2054 6869  tion (SAFE). Thi
│ │ │ │ +000018e0: 7320 7374 6570 2069 7320 7573 6564 2062  s step is used b
│ │ │ │ +000018f0: 790a 2020 2020 2063 6c69 656e 7473 2061  y.     clients a
│ │ │ │ +00001900: 6e64 2073 6572 7665 7273 2074 6f20 6578  nd servers to ex
│ │ │ │ +00001910: 6368 616e 6765 2069 6e74 6567 7269 7479  change integrity
│ │ │ │ +00001920: 2070 726f 7465 6374 6564 2064 6174 6120   protected data 
│ │ │ │ +00001930: 7769 7468 2065 6163 680a 2020 2020 206f  with each.     o
│ │ │ │ +00001940: 7468 6572 2e20 2054 6865 206b 6579 2069  ther.  The key i
│ │ │ │ +00001950: 7320 7479 7069 6361 6c6c 7920 6167 7265  s typically agre
│ │ │ │ +00001960: 6564 206f 6e20 7573 696e 6720 7468 6520  ed on using the 
│ │ │ │ +00001970: 436c 6965 6e74 2d53 6572 7665 720a 2020  Client-Server.  
│ │ │ │ +00001980: 2020 2061 7574 6865 6e74 6963 6174 696f     authenticatio
│ │ │ │ +00001990: 6e20 7374 6570 2e0a 0a20 2020 e280 a220  n step...   ... 
│ │ │ │ +000019a0: 5469 636b 6574 2063 6163 6865 2c20 7375  Ticket cache, su
│ │ │ │ +000019b0: 7070 6f72 7469 6e67 206d 756c 7469 706c  pporting multipl
│ │ │ │ +000019c0: 6520 7072 696e 6369 7061 6c73 2061 6e64  e principals and
│ │ │ │ +000019d0: 2072 6561 6c6d 732e 2020 4173 0a20 2020   realms.  As.   
│ │ │ │ +000019e0: 2020 7469 636b 6574 7320 6861 7665 2061    tickets have a
│ │ │ │ +000019f0: 206c 6966 6520 7469 6d65 206f 6620 7479   life time of ty
│ │ │ │ +00001a00: 7069 6361 6c6c 7920 7365 7665 7261 6c20  pically several 
│ │ │ │ +00001a10: 686f 7572 732c 2074 6865 7920 6172 650a  hours, they are.
│ │ │ │ +00001a20: 2020 2020 206d 616e 6167 6564 2069 6e20       managed in 
│ │ │ │ +00001a30: 6469 736b 2066 696c 6573 2e20 2054 6865  disk files.  The
│ │ │ │ +00001a40: 7265 2063 616e 2062 6520 6d75 6c74 6970  re can be multip
│ │ │ │ +00001a50: 6c65 2074 6963 6b65 7420 6361 6368 6573  le ticket caches
│ │ │ │ +00001a60: 2c20 616e 640a 2020 2020 2065 6163 6820  , and.     each 
│ │ │ │ +00001a70: 7469 636b 6574 2063 6163 6865 2063 616e  ticket cache can
│ │ │ │ +00001a80: 2073 746f 7265 2074 6963 6b65 7473 2066   store tickets f
│ │ │ │ +00001a90: 6f72 206d 756c 7469 706c 6520 636c 6965  or multiple clie
│ │ │ │ +00001aa0: 6e74 7320 2875 7365 7273 292c 0a20 2020  nts (users),.   
│ │ │ │ +00001ab0: 2020 7365 7276 6572 732c 2065 6e63 7279    servers, encry
│ │ │ │ +00001ac0: 7074 696f 6e20 7479 7065 732c 2065 7463  ption types, etc
│ │ │ │ +00001ad0: 2e20 2046 756e 6374 696f 6e61 6c69 7479  .  Functionality
│ │ │ │ +00001ae0: 2069 7320 7072 6f76 6964 6564 2066 6f72   is provided for
│ │ │ │ +00001af0: 0a20 2020 2020 6c6f 6361 7469 6e67 2074  .     locating t
│ │ │ │ +00001b00: 6865 2070 726f 7065 7220 7469 636b 6574  he proper ticket
│ │ │ │ +00001b10: 2066 6f72 2065 7665 7279 2075 7365 2e0a   for every use..
│ │ │ │ +00001b20: 0a20 2020 e280 a220 4d6f 7374 2073 7461  .   ... Most sta
│ │ │ │ +00001b30: 6e64 6172 6420 6372 7970 746f 6772 6170  ndard cryptograp
│ │ │ │ +00001b40: 6869 6320 7072 696d 6974 6976 6573 2e20  hic primitives. 
│ │ │ │ +00001b50: 2054 6865 2062 656c 6965 7665 6420 6d6f   The believed mo
│ │ │ │ +00001b60: 7374 2073 6563 7572 650a 2020 2020 2061  st secure.     a
│ │ │ │ +00001b70: 6c67 6f72 6974 686d 7320 6172 6520 7375  lgorithms are su
│ │ │ │ +00001b80: 7070 6f72 7465 6420 282a 6e6f 7465 2043  pported (*note C
│ │ │ │ +00001b90: 7279 7074 6f67 7261 7068 6963 204f 7665  ryptographic Ove
│ │ │ │ +00001ba0: 7276 6965 773a 3a29 2e0a 0a20 2020 e280  rview::)...   ..
│ │ │ │ +00001bb0: a220 5465 6c6e 6574 2063 6c69 656e 7420  . Telnet client 
│ │ │ │ +00001bc0: 616e 6420 7365 7276 6572 2e20 2054 6869  and server.  Thi
│ │ │ │ +00001bd0: 7320 6973 2075 7365 6420 746f 2072 656d  s is used to rem
│ │ │ │ +00001be0: 6f74 656c 7920 6c6f 6769 6e20 746f 206f  otely login to o
│ │ │ │ +00001bf0: 7468 6572 0a20 2020 2020 6d61 6368 696e  ther.     machin
│ │ │ │ +00001c00: 6573 2c20 6166 7465 7220 6175 7468 656e  es, after authen
│ │ │ │ +00001c10: 7469 6361 7469 6e67 2079 6f75 7273 656c  ticating yoursel
│ │ │ │ +00001c20: 6620 7769 7468 2061 2074 6963 6b65 742e  f with a ticket.
│ │ │ │ +00001c30: 0a0a 2020 20e2 80a2 2050 414d 206d 6f64  ..   ... PAM mod
│ │ │ │ +00001c40: 756c 652e 2020 5468 6973 2069 7320 7573  ule.  This is us
│ │ │ │ +00001c50: 6564 2074 6f20 6c6f 6769 6e20 6c6f 6361  ed to login loca
│ │ │ │ +00001c60: 6c6c 7920 6f6e 2061 206d 6163 6869 6e65  lly on a machine
│ │ │ │ +00001c70: 2e0a 0a20 2020 e280 a220 4b44 4320 6164  ...   ... KDC ad
│ │ │ │ +00001c80: 6472 6573 7365 7320 6c6f 6361 7465 6420  dresses located 
│ │ │ │ +00001c90: 7573 696e 6720 444e 5320 5352 5620 5252  using DNS SRV RR
│ │ │ │ +00001ca0: 732e 0a0a 2020 20e2 80a2 204d 6f64 756c  s...   ... Modul
│ │ │ │ +00001cb0: 6172 697a 6564 206c 6f77 2d6c 6576 656c  arized low-level
│ │ │ │ +00001cc0: 2063 7279 7074 6f20 696e 7465 7266 6163   crypto interfac
│ │ │ │ +00001cd0: 652e 2020 4375 7272 656e 746c 7920 476e  e.  Currently Gn
│ │ │ │ +00001ce0: 756c 6962 2061 6e64 0a20 2020 2020 4c69  ulib and.     Li
│ │ │ │ +00001cf0: 6267 6372 7970 7420 6172 6520 7375 7070  bgcrypt are supp
│ │ │ │ +00001d00: 6f72 7465 642e 2020 4966 2079 6f75 2077  orted.  If you w
│ │ │ │ +00001d10: 6973 6820 746f 2061 6464 2073 7570 706f  ish to add suppo
│ │ │ │ +00001d20: 7274 2066 6f72 2061 6e6f 7468 6572 0a20  rt for another. 
│ │ │ │ +00001d30: 2020 2020 6c6f 772d 6c65 7665 6c20 6372      low-level cr
│ │ │ │ +00001d40: 7970 746f 6772 6170 6869 6320 6c69 6272  yptographic libr
│ │ │ │ +00001d50: 6172 792c 2079 6f75 206f 6e6c 7920 6861  ary, you only ha
│ │ │ │ +00001d60: 7665 2074 6f20 696d 706c 656d 656e 7420  ve to implement 
│ │ │ │ +00001d70: 6120 6665 770a 2020 2020 2041 5049 7320  a few.     APIs 
│ │ │ │ +00001d80: 666f 7220 4445 532c 2041 4553 2c20 4d44  for DES, AES, MD
│ │ │ │ +00001d90: 352c 2053 4841 312c 2048 4d41 432c 2065  5, SHA1, HMAC, e
│ │ │ │ +00001da0: 7463 2e20 204c 6f6f 6b20 6174 20e2 8098  tc.  Look at ...
│ │ │ │ +00001db0: 676c 2f67 632d 676e 756c 6962 2e63 e280  gl/gc-gnulib.c..
│ │ │ │ +00001dc0: 990a 2020 2020 206f 7220 e280 9867 6c2f  ..     or ...gl/
│ │ │ │ +00001dd0: 6763 2d6c 6962 6763 7279 7074 2e63 e280  gc-libgcrypt.c..
│ │ │ │ +00001de0: 9920 6173 2061 2073 7461 7274 696e 6720  . as a starting 
│ │ │ │ +00001df0: 706f 696e 7465 722e 0a0a 2020 2054 6865  pointer...   The
│ │ │ │ +00001e00: 2066 6f6c 6c6f 7769 6e67 2074 6162 6c65   following table
│ │ │ │ +00001e10: 2073 756d 6d61 7269 7a65 2077 6861 7420   summarize what 
│ │ │ │ +00001e20: 7468 6520 6375 7272 656e 7420 6f62 6a65  the current obje
│ │ │ │ +00001e30: 6374 6976 6573 2061 7265 2028 692e 652e  ctives are (i.e.
│ │ │ │ +00001e40: 2c0a 7468 6520 746f 646f 206c 6973 7429  ,.the todo list)
│ │ │ │ +00001e50: 2061 6e64 2061 6e20 6573 7469 6d61 7465   and an estimate
│ │ │ │ +00001e60: 206f 6e20 686f 7720 6c6f 6e67 2069 7420   on how long it 
│ │ │ │ +00001e70: 7769 6c6c 2074 616b 6520 746f 2069 6d70  will take to imp
│ │ │ │ +00001e80: 6c65 6d65 6e74 2074 6865 0a66 6561 7475  lement the.featu
│ │ │ │ +00001e90: 7265 2c20 696e 636c 7564 696e 6720 736f  re, including so
│ │ │ │ +00001ea0: 6d65 2072 6561 736f 6e61 626c 6520 7374  me reasonable st
│ │ │ │ +00001eb0: 6172 7475 702d 7469 6d65 2074 6f20 6765  artup-time to ge
│ │ │ │ +00001ec0: 7420 6661 6d69 6c69 6172 2077 6974 680a  t familiar with.
│ │ │ │ +00001ed0: 5368 6973 6869 2069 6e20 6765 6e65 7261  Shishi in genera
│ │ │ │ +00001ee0: 6c2e 2020 4966 2079 6f75 206c 696b 6520  l.  If you like 
│ │ │ │ +00001ef0: 746f 2073 7461 7274 2077 6f72 6b69 6e67  to start working
│ │ │ │ +00001f00: 206f 6e20 616e 7974 6869 6e67 2c20 706c   on anything, pl
│ │ │ │ +00001f10: 6561 7365 206c 6574 0a6d 6520 6b6e 6f77  ease let.me know
│ │ │ │ +00001f20: 2073 6f20 776f 726b 2064 7570 6c69 6361   so work duplica
│ │ │ │ +00001f30: 7469 6f6e 2063 616e 2062 6520 6176 6f69  tion can be avoi
│ │ │ │ +00001f40: 6465 642e 0a0a 2020 20e2 80a2 2050 6172  ded...   ... Par
│ │ │ │ +00001f50: 7365 20e2 8098 2f65 7463 2f6b 7262 352e  se .../etc/krb5.
│ │ │ │ +00001f60: 6b65 7974 6162 e280 9920 746f 2065 7874  keytab... to ext
│ │ │ │ +00001f70: 7261 6374 206b 6579 7320 746f 2075 7365  ract keys to use
│ │ │ │ +00001f80: 2066 6f72 2074 656c 6e65 7464 2065 7463   for telnetd etc
│ │ │ │ +00001f90: 0a20 2020 2020 2877 6565 6b29 0a0a 2020  .     (week)..  
│ │ │ │ +00001fa0: 20e2 80a2 2043 726f 7373 2d72 6561 6c6d   ... Cross-realm
│ │ │ │ +00001fb0: 2073 7570 706f 7274 2028 7765 656b 292e   support (week).
│ │ │ │ +00001fc0: 0a0a 2020 20e2 80a2 2050 4b49 4e49 5420  ..   ... PKINIT 
│ │ │ │ +00001fd0: 2875 7365 206c 6962 6b73 6261 2c20 7765  (use libksba, we
│ │ │ │ +00001fe0: 656b 7329 0a0a 2020 20e2 80a2 2046 696e  eks)..   ... Fin
│ │ │ │ +00001ff0: 6973 6820 4753 5341 5049 2073 7570 706f  ish GSSAPI suppo
│ │ │ │ +00002000: 7274 2076 6961 2047 5353 4c69 6220 2877  rt via GSSLib (w
│ │ │ │ +00002010: 6565 6b73 2920 5368 6973 6869 2077 696c  eeks) Shishi wil
│ │ │ │ +00002020: 6c20 6e6f 7420 7375 7070 6f72 740a 2020  l not support.  
│ │ │ │ +00002030: 2020 2047 5353 4c69 6220 6e61 7469 7665     GSSLib native
│ │ │ │ +00002040: 6c79 2c20 6275 7420 6120 7365 7061 7261  ly, but a separa
│ │ │ │ +00002050: 7465 2070 726f 6a65 6374 2022 4753 534c  te project "GSSL
│ │ │ │ +00002060: 6962 2220 6973 2075 6e64 6572 2077 6179  ib" is under way
│ │ │ │ +00002070: 2074 6f0a 2020 2020 2070 726f 6475 6365   to.     produce
│ │ │ │ +00002080: 2061 2067 656e 6572 6963 2047 5353 2069   a generic GSS i
│ │ │ │ +00002090: 6d70 6c65 6d65 6e74 6174 696f 6e2c 2061  mplementation, a
│ │ │ │ +000020a0: 6e64 2069 7420 7769 6c6c 2075 7365 2053  nd it will use S
│ │ │ │ +000020b0: 6869 7368 6920 746f 0a20 2020 2020 696d  hishi to.     im
│ │ │ │ +000020c0: 706c 656d 656e 7420 7468 6520 4b65 7262  plement the Kerb
│ │ │ │ +000020d0: 6572 6f73 2035 206d 6563 6861 6e69 736d  eros 5 mechanism
│ │ │ │ +000020e0: 2e0a 0a20 2020 e280 a220 506f 7274 2074  ...   ... Port t
│ │ │ │ +000020f0: 6f20 6379 636c 6f6e 6520 2863 7963 6c6f  o cyclone (cyclo
│ │ │ │ +00002100: 6e65 206e 6565 6420 746f 206d 6174 7572  ne need to matur
│ │ │ │ +00002110: 6520 6669 7273 7429 0a0a 2020 20e2 80a2  e first)..   ...
│ │ │ │ +00002120: 204d 6f64 756c 6172 697a 6520 4153 4e2e   Modularize ASN.
│ │ │ │ +00002130: 3120 6c69 6272 6172 7920 736f 2069 7420  1 library so it 
│ │ │ │ +00002140: 6361 6e20 6265 2072 6570 6c61 6365 6420  can be replaced 
│ │ │ │ +00002150: 2864 6179 7329 2e20 2041 6c6d 6f73 740a  (days).  Almost.
│ │ │ │ +00002160: 2020 2020 2064 6f6e 652c 2061 6c6c 2041       done, all A
│ │ │ │ +00002170: 534e 2e31 2066 756e 6374 696f 6e61 6c69  SN.1 functionali
│ │ │ │ +00002180: 7479 2069 7320 666f 756e 6420 696e 206c  ty is found in l
│ │ │ │ +00002190: 6962 2f61 736e 312e 632c 2061 6c74 686f  ib/asn1.c, altho
│ │ │ │ +000021a0: 7567 6820 7468 650a 2020 2020 2069 6e74  ugh the.     int
│ │ │ │ +000021b0: 6572 6661 6365 2069 7320 7261 7468 6572  erface is rather
│ │ │ │ +000021c0: 206c 6962 7461 736e 3120 6365 6e74 7269   libtasn1 centri
│ │ │ │ +000021d0: 632e 0a0a 2020 20e2 80a2 204b 4443 2028  c...   ... KDC (
│ │ │ │ +000021e0: 696e 6974 6961 7465 642c 2077 6565 6b73  initiated, weeks
│ │ │ │ +000021f0: 290a 0a20 2020 e280 a220 4c44 4150 2062  )..   ... LDAP b
│ │ │ │ +00002200: 6163 6b65 6e64 2066 6f72 2053 6869 7361  ackend for Shisa
│ │ │ │ +00002210: 2e0a 0a20 2020 e280 a220 5365 742f 4368  ...   ... Set/Ch
│ │ │ │ +00002220: 616e 6765 2070 6173 7377 6f72 6420 7072  ange password pr
│ │ │ │ +00002230: 6f74 6f63 6f6c 2028 7765 656b 733f 290a  otocol (weeks?).
│ │ │ │ +00002240: 0a20 2020 e280 a220 506f 7274 2061 7070  .   ... Port app
│ │ │ │ +00002250: 6c69 6361 7469 6f6e 7320 746f 2075 7365  lications to use
│ │ │ │ +00002260: 2053 6869 7368 6920 2869 6e64 6566 696e   Shishi (indefin
│ │ │ │ +00002270: 6974 6529 0a0a 2020 20e2 80a2 2046 696e  ite)..   ... Fin
│ │ │ │ +00002280: 6973 6820 7365 7276 6572 2d72 6561 6c6d  ish server-realm
│ │ │ │ +00002290: 2073 7475 6666 0a0a 2020 20e2 80a2 2049   stuff..   ... I
│ │ │ │ +000022a0: 6d70 726f 7665 2064 6f63 756d 656e 7461  mprove documenta
│ │ │ │ +000022b0: 7469 6f6e 0a0a 2020 20e2 80a2 2049 6d70  tion..   ... Imp
│ │ │ │ +000022c0: 726f 7665 2069 6e74 6572 6e61 7469 6f6e  rove internation
│ │ │ │ +000022d0: 616c 697a 6174 696f 6e0a 0a20 2020 e280  alization..   ..
│ │ │ │ +000022e0: a220 4164 6420 4150 2d52 4551 2072 6570  . Add AP-REQ rep
│ │ │ │ +000022f0: 6c61 7920 6361 6368 6520 2877 6565 6b29  lay cache (week)
│ │ │ │ +00002300: 2e0a 0a20 2020 e280 a220 5374 7564 7920  ...   ... Study 
│ │ │ │ +00002310: 6265 6e65 6669 7473 2062 7920 696e 7472  benefits by intr
│ │ │ │ +00002320: 6f64 7563 696e 6720 6120 5041 2d54 4753  oducing a PA-TGS
│ │ │ │ +00002330: 2d52 4550 2e20 5468 6973 2077 6f75 6c64  -REP. This would
│ │ │ │ +00002340: 2070 726f 7669 6465 0a20 2020 2020 6d75   provide.     mu
│ │ │ │ +00002350: 7475 616c 2061 7574 6865 6e74 6963 6174  tual authenticat
│ │ │ │ +00002360: 696f 6e20 6f66 2074 6865 204b 4443 2069  ion of the KDC i
│ │ │ │ +00002370: 6e20 6120 7761 7920 7468 6174 2069 7320  n a way that is 
│ │ │ │ +00002380: 6561 7369 6572 2074 6f0a 2020 2020 2061  easier to.     a
│ │ │ │ +00002390: 6e61 6c79 7a65 2e20 2043 7572 7265 6e74  nalyze.  Current
│ │ │ │ +000023a0: 6c79 2074 6865 206d 7574 7561 6c20 6175  ly the mutual au
│ │ │ │ +000023b0: 7468 656e 7469 6361 7469 6f6e 2070 726f  thentication pro
│ │ │ │ +000023c0: 7065 7274 7920 6973 206f 6e6c 790a 2020  perty is only.  
│ │ │ │ +000023d0: 2020 2069 6d70 6c69 6369 7420 6672 6f6d     implicit from
│ │ │ │ +000023e0: 2073 7563 6365 7373 6675 6c20 6465 6372   successful decr
│ │ │ │ +000023f0: 7970 7469 6f6e 206f 6620 7468 6520 4b44  yption of the KD
│ │ │ │ +00002400: 432d 5245 5020 616e 6420 7468 6520 3420  C-REP and the 4 
│ │ │ │ +00002410: 6279 7465 0a20 2020 2020 e280 986e 6f6e  byte.     ...non
│ │ │ │ +00002420: 6365 e280 992e 0a0a 2020 20e2 80a2 2047  ce......   ... G
│ │ │ │ +00002430: 5549 2061 7070 6c65 7420 666f 7220 6d61  UI applet for ma
│ │ │ │ +00002440: 6e61 6769 6e67 2074 6963 6b65 7473 2e20  naging tickets. 
│ │ │ │ +00002450: 2054 6869 7320 6973 2073 7570 706f 7274   This is support
│ │ │ │ +00002460: 6564 2076 6961 2074 6865 0a20 2020 2020  ed via the.     
│ │ │ │ +00002470: 7469 636b 6574 2d61 7070 6c65 742c 206f  ticket-applet, o
│ │ │ │ +00002480: 6620 7768 6963 6820 6120 5368 6973 6869  f which a Shishi
│ │ │ │ +00002490: 2070 6f72 7420 6973 2070 7562 6c69 7368   port is publish
│ │ │ │ +000024a0: 6564 206f 6e20 7468 6520 5368 6973 6869  ed on the Shishi
│ │ │ │ +000024b0: 0a20 2020 2020 686f 6d65 2070 6167 652e  .     home page.
│ │ │ │ +000024c0: 0a0a 2020 20e2 80a2 2041 7574 686f 7269  ..   ... Authori
│ │ │ │ +000024d0: 7a61 7469 6f6e 206c 6962 7261 7279 2028  zation library (
│ │ │ │ +000024e0: 6d6f 6e74 6873 3f29 2020 5468 6520 7368  months?)  The sh
│ │ │ │ +000024f0: 6973 6869 5f61 7574 686f 7269 7a65 645f  ishi_authorized_
│ │ │ │ +00002500: 7028 2920 6973 206e 6f74 2061 0a20 2020  p() is not a.   
│ │ │ │ +00002510: 2020 676f 6f64 2073 6f6c 7574 696f 6e2c    good solution,
│ │ │ │ +00002520: 2062 6574 7465 7220 776f 756c 6420 6265   better would be
│ │ │ │ +00002530: 2074 6f20 6861 7665 2061 2067 656e 6572   to have a gener
│ │ │ │ +00002540: 6963 2061 6e64 2066 6c65 7869 626c 650a  ic and flexible.
│ │ │ │ +00002550: 2020 2020 2061 7574 686f 7269 7a61 7469       authorizati
│ │ │ │ +00002560: 6f6e 206c 6962 7261 7279 2e20 2050 6f73  on library.  Pos
│ │ │ │ +00002570: 7369 626c 7920 6261 7365 6420 6f6e 2053  sibly based on S
│ │ │ │ +00002580: 2d45 5850 2773 2069 6e20 7469 636b 6574  -EXP's in ticket
│ │ │ │ +00002590: 733f 0a20 2020 2020 5368 6f75 6c64 2073  s?.     Should s
│ │ │ │ +000025a0: 7570 706f 7274 206e 6f6e 2d4b 6572 6265  upport non-Kerbe
│ │ │ │ +000025b0: 726f 7320 7573 6573 2061 7320 7765 6c6c  ros uses as well
│ │ │ │ +000025c0: 2c20 6f66 2063 6f75 7273 652e 0a0a 2020  , of course...  
│ │ │ │ +000025d0: 20e2 80a2 2050 726f 6f66 2072 6561 6420   ... Proof read 
│ │ │ │ +000025e0: 6d61 6e75 616c 2e0a 0a20 2020 e280 a220  manual...   ... 
│ │ │ │ +000025f0: 582e 3530 3020 7375 7070 6f72 742c 2069  X.500 support, i
│ │ │ │ +00002600: 6e63 6c75 6469 6e67 2044 4f4d 4149 4e2d  ncluding DOMAIN-
│ │ │ │ +00002610: 5835 3030 2d43 4f4d 5052 4553 532e 2049  X500-COMPRESS. I
│ │ │ │ +00002620: 2077 696c 6c20 6163 6365 7074 0a20 2020   will accept.   
│ │ │ │ +00002630: 2020 7061 7463 6865 7320 7468 6174 2069    patches that i
│ │ │ │ +00002640: 6d70 6c65 6d65 6e74 2074 6869 732c 2069  mplement this, i
│ │ │ │ +00002650: 6620 6974 2063 6175 7365 7320 6d69 6e69  f it causes mini
│ │ │ │ +00002660: 6d61 6c20 6368 616e 6765 7320 746f 2074  mal changes to t
│ │ │ │ +00002670: 6865 0a20 2020 2020 6375 7272 656e 7420  he.     current 
│ │ │ │ +00002680: 636f 6465 2e0a 0a1f 0a46 696c 653a 2073  code.....File: s
│ │ │ │ +00002690: 6869 7368 692e 696e 666f 2c20 204e 6f64  hishi.info,  Nod
│ │ │ │ +000026a0: 653a 204f 7665 7276 6965 772c 2020 4e65  e: Overview,  Ne
│ │ │ │ +000026b0: 7874 3a20 4372 7970 746f 6772 6170 6869  xt: Cryptographi
│ │ │ │ +000026c0: 6320 4f76 6572 7669 6577 2c20 2050 7265  c Overview,  Pre
│ │ │ │ +000026d0: 763a 2046 6561 7475 7265 7320 616e 6420  v: Features and 
│ │ │ │ +000026e0: 5374 6174 7573 2c20 2055 703a 2049 6e74  Status,  Up: Int
│ │ │ │ +000026f0: 726f 6475 6374 696f 6e0a 0a31 2e33 204f  roduction..1.3 O
│ │ │ │ +00002700: 7665 7276 6965 770a 3d3d 3d3d 3d3d 3d3d  verview.========
│ │ │ │ +00002710: 3d3d 3d3d 0a0a 5468 6973 2073 6563 7469  ====..This secti
│ │ │ │ +00002720: 6f6e 2064 6573 6372 6962 6573 2052 4643  on describes RFC
│ │ │ │ +00002730: 2031 3531 3020 6672 6f6d 2061 2070 726f   1510 from a pro
│ │ │ │ +00002740: 746f 636f 6c20 706f 696e 7420 6f66 2076  tocol point of v
│ │ │ │ +00002750: 6965 7728 3129 2e0a 0a20 2020 4b65 7262  iew(1)...   Kerb
│ │ │ │ +00002760: 6572 6f73 2070 726f 7669 6465 7320 6120  eros provides a 
│ │ │ │ +00002770: 6d65 616e 7320 6f66 2076 6572 6966 7969  means of verifyi
│ │ │ │ +00002780: 6e67 2074 6865 2069 6465 6e74 6974 6965  ng the identitie
│ │ │ │ +00002790: 7320 6f66 2070 7269 6e63 6970 616c 732c  s of principals,
│ │ │ │ +000027a0: 0a28 652e 672e 2c20 6120 776f 726b 7374  .(e.g., a workst
│ │ │ │ +000027b0: 6174 696f 6e20 7573 6572 206f 7220 6120  ation user or a 
│ │ │ │ +000027c0: 6e65 7477 6f72 6b20 7365 7276 6572 2920  network server) 
│ │ │ │ +000027d0: 6f6e 2061 6e20 6f70 656e 2028 756e 7072  on an open (unpr
│ │ │ │ +000027e0: 6f74 6563 7465 6429 0a6e 6574 776f 726b  otected).network
│ │ │ │ +000027f0: 2e20 2054 6869 7320 6973 2061 6363 6f6d  .  This is accom
│ │ │ │ +00002800: 706c 6973 6865 6420 7769 7468 6f75 7420  plished without 
│ │ │ │ +00002810: 7265 6c79 696e 6720 6f6e 2061 7574 6865  relying on authe
│ │ │ │ +00002820: 6e74 6963 6174 696f 6e20 6279 2074 6865  ntication by the
│ │ │ │ +00002830: 0a68 6f73 7420 6f70 6572 6174 696e 6720  .host operating 
│ │ │ │ +00002840: 7379 7374 656d 2c20 7769 7468 6f75 7420  system, without 
│ │ │ │ +00002850: 6261 7369 6e67 2074 7275 7374 206f 6e20  basing trust on 
│ │ │ │ +00002860: 686f 7374 2061 6464 7265 7373 6573 2c20  host addresses, 
│ │ │ │ +00002870: 7769 7468 6f75 740a 7265 7175 6972 696e  without.requirin
│ │ │ │ +00002880: 6720 7068 7973 6963 616c 2073 6563 7572  g physical secur
│ │ │ │ +00002890: 6974 7920 6f66 2061 6c6c 2074 6865 2068  ity of all the h
│ │ │ │ +000028a0: 6f73 7473 206f 6e20 7468 6520 6e65 7477  osts on the netw
│ │ │ │ +000028b0: 6f72 6b2c 2061 6e64 2075 6e64 6572 0a74  ork, and under.t
│ │ │ │ +000028c0: 6865 2061 7373 756d 7074 696f 6e20 7468  he assumption th
│ │ │ │ +000028d0: 6174 2070 6163 6b65 7473 2074 7261 7665  at packets trave
│ │ │ │ +000028e0: 6c69 6e67 2061 6c6f 6e67 2074 6865 206e  ling along the n
│ │ │ │ +000028f0: 6574 776f 726b 2063 616e 2062 6520 7265  etwork can be re
│ │ │ │ +00002900: 6164 2c0a 6d6f 6469 6669 6564 2c20 616e  ad,.modified, an
│ │ │ │ +00002910: 6420 696e 7365 7274 6564 2061 7420 7769  d inserted at wi
│ │ │ │ +00002920: 6c6c 2e20 2028 4e6f 7465 2c20 686f 7765  ll.  (Note, howe
│ │ │ │ +00002930: 7665 722c 2074 6861 7420 6d61 6e79 2061  ver, that many a
│ │ │ │ +00002940: 7070 6c69 6361 7469 6f6e 730a 7573 6520  pplications.use 
│ │ │ │ +00002950: 4b65 7262 6572 6f73 2720 6675 6e63 7469  Kerberos' functi
│ │ │ │ +00002960: 6f6e 7320 6f6e 6c79 2075 706f 6e20 7468  ons only upon th
│ │ │ │ +00002970: 6520 696e 6974 6961 7469 6f6e 206f 6620  e initiation of 
│ │ │ │ +00002980: 6120 7374 7265 616d 2d62 6173 6564 0a6e  a stream-based.n
│ │ │ │ +00002990: 6574 776f 726b 2063 6f6e 6e65 6374 696f  etwork connectio
│ │ │ │ +000029a0: 6e2c 2061 6e64 2061 7373 756d 6520 7468  n, and assume th
│ │ │ │ +000029b0: 6520 6162 7365 6e63 6520 6f66 2061 6e79  e absence of any
│ │ │ │ +000029c0: 2022 6869 6a61 636b 6572 7322 2077 686f   "hijackers" who
│ │ │ │ +000029d0: 206d 6967 6874 0a73 7562 7665 7274 2073   might.subvert s
│ │ │ │ +000029e0: 7563 6820 6120 636f 6e6e 6563 7469 6f6e  uch a connection
│ │ │ │ +000029f0: 2e20 2053 7563 6820 7573 6520 696d 706c  .  Such use impl
│ │ │ │ +00002a00: 6963 6974 6c79 2074 7275 7374 7320 7468  icitly trusts th
│ │ │ │ +00002a10: 6520 686f 7374 0a61 6464 7265 7373 6573  e host.addresses
│ │ │ │ +00002a20: 2069 6e76 6f6c 7665 642e 2920 204b 6572   involved.)  Ker
│ │ │ │ +00002a30: 6265 726f 7320 7065 7266 6f72 6d73 2061  beros performs a
│ │ │ │ +00002a40: 7574 6865 6e74 6963 6174 696f 6e20 756e  uthentication un
│ │ │ │ +00002a50: 6465 7220 7468 6573 650a 636f 6e64 6974  der these.condit
│ │ │ │ +00002a60: 696f 6e73 2061 7320 6120 7472 7573 7465  ions as a truste
│ │ │ │ +00002a70: 6420 7468 6972 642d 2070 6172 7479 2061  d third- party a
│ │ │ │ +00002a80: 7574 6865 6e74 6963 6174 696f 6e20 7365  uthentication se
│ │ │ │ +00002a90: 7276 6963 6520 6279 2075 7369 6e67 0a63  rvice by using.c
│ │ │ │ +00002aa0: 6f6e 7665 6e74 696f 6e61 6c20 6372 7970  onventional cryp
│ │ │ │ +00002ab0: 746f 6772 6170 6879 2c20 692e 652e 2c20  tography, i.e., 
│ │ │ │ +00002ac0: 7368 6172 6564 2073 6563 7265 7420 6b65  shared secret ke
│ │ │ │ +00002ad0: 792e 2020 2873 6861 7265 6420 7365 6372  y.  (shared secr
│ │ │ │ +00002ae0: 6574 206b 6579 0a2d 2053 6563 7265 7420  et key.- Secret 
│ │ │ │ +00002af0: 616e 6420 7072 6976 6174 6520 6172 6520  and private are 
│ │ │ │ +00002b00: 6f66 7465 6e20 7573 6564 2069 6e74 6572  often used inter
│ │ │ │ +00002b10: 6368 616e 6765 6162 6c79 2069 6e20 7468  changeably in th
│ │ │ │ +00002b20: 6520 6c69 7465 7261 7475 7265 2e0a 496e  e literature..In
│ │ │ │ +00002b30: 206f 7572 2075 7361 6765 2c20 6974 2074   our usage, it t
│ │ │ │ +00002b40: 616b 6573 2074 776f 2028 6f72 206d 6f72  akes two (or mor
│ │ │ │ +00002b50: 6529 2074 6f20 7368 6172 6520 6120 7365  e) to share a se
│ │ │ │ +00002b60: 6372 6574 2c20 7468 7573 2061 2073 6861  cret, thus a sha
│ │ │ │ +00002b70: 7265 640a 4445 5320 6b65 7920 6973 2061  red.DES key is a
│ │ │ │ +00002b80: 2073 6563 7265 7420 6b65 792e 2020 536f   secret key.  So
│ │ │ │ +00002b90: 6d65 7468 696e 6720 6973 206f 6e6c 7920  mething is only 
│ │ │ │ +00002ba0: 7072 6976 6174 6520 7768 656e 206e 6f20  private when no 
│ │ │ │ +00002bb0: 6f6e 6520 6275 7420 6974 730a 6f77 6e65  one but its.owne
│ │ │ │ +00002bc0: 7220 6b6e 6f77 7320 6974 2e20 2054 6875  r knows it.  Thu
│ │ │ │ +00002bd0: 732c 2069 6e20 7075 626c 6963 206b 6579  s, in public key
│ │ │ │ +00002be0: 2063 7279 7074 6f73 7973 7465 6d73 2c20   cryptosystems, 
│ │ │ │ +00002bf0: 6f6e 6520 6861 7320 6120 7075 626c 6963  one has a public
│ │ │ │ +00002c00: 2061 6e64 0a61 2070 7269 7661 7465 206b   and.a private k
│ │ │ │ +00002c10: 6579 2e29 0a0a 2020 2054 6865 2061 7574  ey.)..   The aut
│ │ │ │ +00002c20: 6865 6e74 6963 6174 696f 6e20 7072 6f63  hentication proc
│ │ │ │ +00002c30: 6573 7320 7072 6f63 6565 6473 2061 7320  ess proceeds as 
│ │ │ │ +00002c40: 666f 6c6c 6f77 733a 2041 2063 6c69 656e  follows: A clien
│ │ │ │ +00002c50: 7420 7365 6e64 7320 610a 7265 7175 6573  t sends a.reques
│ │ │ │ +00002c60: 7420 746f 2074 6865 2061 7574 6865 6e74  t to the authent
│ │ │ │ +00002c70: 6963 6174 696f 6e20 7365 7276 6572 2028  ication server (
│ │ │ │ +00002c80: 4153 2920 7265 7175 6573 7469 6e67 2022  AS) requesting "
│ │ │ │ +00002c90: 6372 6564 656e 7469 616c 7322 2066 6f72  credentials" for
│ │ │ │ +00002ca0: 2061 0a67 6976 656e 2073 6572 7665 722e   a.given server.
│ │ │ │ +00002cb0: 2020 5468 6520 4153 2072 6573 706f 6e64    The AS respond
│ │ │ │ +00002cc0: 7320 7769 7468 2074 6865 7365 2063 7265  s with these cre
│ │ │ │ +00002cd0: 6465 6e74 6961 6c73 2c20 656e 6372 7970  dentials, encryp
│ │ │ │ +00002ce0: 7465 6420 696e 2074 6865 0a63 6c69 656e  ted in the.clien
│ │ │ │ +00002cf0: 7427 7320 6b65 792e 2020 5468 6520 6372  t's key.  The cr
│ │ │ │ +00002d00: 6564 656e 7469 616c 7320 636f 6e73 6973  edentials consis
│ │ │ │ +00002d10: 7420 6f66 2031 2920 6120 2274 6963 6b65  t of 1) a "ticke
│ │ │ │ +00002d20: 7422 2066 6f72 2074 6865 2073 6572 7665  t" for the serve
│ │ │ │ +00002d30: 720a 616e 6420 3229 2061 2074 656d 706f  r.and 2) a tempo
│ │ │ │ +00002d40: 7261 7279 2065 6e63 7279 7074 696f 6e20  rary encryption 
│ │ │ │ +00002d50: 6b65 7920 286f 6674 656e 2063 616c 6c65  key (often calle
│ │ │ │ +00002d60: 6420 6120 2273 6573 7369 6f6e 206b 6579  d a "session key
│ │ │ │ +00002d70: 2229 2e20 2054 6865 0a63 6c69 656e 7420  ").  The.client 
│ │ │ │ +00002d80: 7472 616e 736d 6974 7320 7468 6520 7469  transmits the ti
│ │ │ │ +00002d90: 636b 6574 2028 7768 6963 6820 636f 6e74  cket (which cont
│ │ │ │ +00002da0: 6169 6e73 2074 6865 2063 6c69 656e 7427  ains the client'
│ │ │ │ +00002db0: 7320 6964 656e 7469 7479 2061 6e64 2061  s identity and a
│ │ │ │ +00002dc0: 0a63 6f70 7920 6f66 2074 6865 2073 6573  .copy of the ses
│ │ │ │ +00002dd0: 7369 6f6e 206b 6579 2c20 616c 6c20 656e  sion key, all en
│ │ │ │ +00002de0: 6372 7970 7465 6420 696e 2074 6865 2073  crypted in the s
│ │ │ │ +00002df0: 6572 7665 7227 7320 6b65 7929 2074 6f20  erver's key) to 
│ │ │ │ +00002e00: 7468 650a 7365 7276 6572 2e20 2054 6865  the.server.  The
│ │ │ │ +00002e10: 2073 6573 7369 6f6e 206b 6579 2028 6e6f   session key (no
│ │ │ │ +00002e20: 7720 7368 6172 6564 2062 7920 7468 6520  w shared by the 
│ │ │ │ +00002e30: 636c 6965 6e74 2061 6e64 2073 6572 7665  client and serve
│ │ │ │ +00002e40: 7229 2069 7320 7573 6564 0a74 6f20 6175  r) is used.to au
│ │ │ │ +00002e50: 7468 656e 7469 6361 7465 2074 6865 2063  thenticate the c
│ │ │ │ +00002e60: 6c69 656e 742c 2061 6e64 206d 6179 206f  lient, and may o
│ │ │ │ +00002e70: 7074 696f 6e61 6c6c 7920 6265 2075 7365  ptionally be use
│ │ │ │ +00002e80: 6420 746f 2061 7574 6865 6e74 6963 6174  d to authenticat
│ │ │ │ +00002e90: 650a 7468 6520 7365 7276 6572 2e20 2049  e.the server.  I
│ │ │ │ +00002ea0: 7420 6d61 7920 616c 736f 2062 6520 7573  t may also be us
│ │ │ │ +00002eb0: 6564 2074 6f20 656e 6372 7970 7420 6675  ed to encrypt fu
│ │ │ │ +00002ec0: 7274 6865 7220 636f 6d6d 756e 6963 6174  rther communicat
│ │ │ │ +00002ed0: 696f 6e0a 6265 7477 6565 6e20 7468 6520  ion.between the 
│ │ │ │ +00002ee0: 7477 6f20 7061 7274 6965 7320 6f72 2074  two parties or t
│ │ │ │ +00002ef0: 6f20 6578 6368 616e 6765 2061 2073 6570  o exchange a sep
│ │ │ │ +00002f00: 6172 6174 6520 7375 622d 7365 7373 696f  arate sub-sessio
│ │ │ │ +00002f10: 6e20 6b65 7920 746f 2062 650a 7573 6564  n key to be.used
│ │ │ │ +00002f20: 2074 6f20 656e 6372 7970 7420 6675 7274   to encrypt furt
│ │ │ │ +00002f30: 6865 7220 636f 6d6d 756e 6963 6174 696f  her communicatio
│ │ │ │ +00002f40: 6e2e 0a0a 2020 2054 6865 2069 6d70 6c65  n...   The imple
│ │ │ │ +00002f50: 6d65 6e74 6174 696f 6e20 636f 6e73 6973  mentation consis
│ │ │ │ +00002f60: 7473 206f 6620 6f6e 6520 6f72 206d 6f72  ts of one or mor
│ │ │ │ +00002f70: 6520 6175 7468 656e 7469 6361 7469 6f6e  e authentication
│ │ │ │ +00002f80: 2073 6572 7665 7273 0a72 756e 6e69 6e67   servers.running
│ │ │ │ +00002f90: 206f 6e20 7068 7973 6963 616c 6c79 2073   on physically s
│ │ │ │ +00002fa0: 6563 7572 6520 686f 7374 732e 2020 5468  ecure hosts.  Th
│ │ │ │ +00002fb0: 6520 6175 7468 656e 7469 6361 7469 6f6e  e authentication
│ │ │ │ +00002fc0: 2073 6572 7665 7273 206d 6169 6e74 6169   servers maintai
│ │ │ │ +00002fd0: 6e0a 6120 6461 7461 6261 7365 206f 6620  n.a database of 
│ │ │ │ +00002fe0: 7072 696e 6369 7061 6c73 2028 692e 652e  principals (i.e.
│ │ │ │ +00002ff0: 2c20 7573 6572 7320 616e 6420 7365 7276  , users and serv
│ │ │ │ +00003000: 6572 7329 2061 6e64 2074 6865 6972 2073  ers) and their s
│ │ │ │ +00003010: 6563 7265 740a 6b65 7973 2e20 2043 6f64  ecret.keys.  Cod
│ │ │ │ +00003020: 6520 6c69 6272 6172 6965 7320 7072 6f76  e libraries prov
│ │ │ │ +00003030: 6964 6520 656e 6372 7970 7469 6f6e 2061  ide encryption a
│ │ │ │ +00003040: 6e64 2069 6d70 6c65 6d65 6e74 2074 6865  nd implement the
│ │ │ │ +00003050: 204b 6572 6265 726f 730a 7072 6f74 6f63   Kerberos.protoc
│ │ │ │ +00003060: 6f6c 2e20 2049 6e20 6f72 6465 7220 746f  ol.  In order to
│ │ │ │ +00003070: 2061 6464 2061 7574 6865 6e74 6963 6174   add authenticat
│ │ │ │ +00003080: 696f 6e20 746f 2069 7473 2074 7261 6e73  ion to its trans
│ │ │ │ +00003090: 6163 7469 6f6e 732c 2061 2074 7970 6963  actions, a typic
│ │ │ │ +000030a0: 616c 0a6e 6574 776f 726b 2061 7070 6c69  al.network appli
│ │ │ │ +000030b0: 6361 7469 6f6e 2061 6464 7320 6f6e 6520  cation adds one 
│ │ │ │ +000030c0: 6f72 2074 776f 2063 616c 6c73 2074 6f20  or two calls to 
│ │ │ │ +000030d0: 7468 6520 4b65 7262 6572 6f73 206c 6962  the Kerberos lib
│ │ │ │ +000030e0: 7261 7279 2c20 7768 6963 680a 7265 7375  rary, which.resu
│ │ │ │ +000030f0: 6c74 7320 696e 2074 6865 2074 7261 6e73  lts in the trans
│ │ │ │ +00003100: 6d69 7373 696f 6e20 6f66 2074 6865 206e  mission of the n
│ │ │ │ +00003110: 6563 6573 7361 7279 206d 6573 7361 6765  ecessary message
│ │ │ │ +00003120: 7320 746f 2061 6368 6965 7665 0a61 7574  s to achieve.aut
│ │ │ │ +00003130: 6865 6e74 6963 6174 696f 6e2e 0a0a 2020  hentication...  
│ │ │ │ +00003140: 2054 6865 204b 6572 6265 726f 7320 7072   The Kerberos pr
│ │ │ │ +00003150: 6f74 6f63 6f6c 2063 6f6e 7369 7374 7320  otocol consists 
│ │ │ │ +00003160: 6f66 2073 6576 6572 616c 2073 7562 2d70  of several sub-p
│ │ │ │ +00003170: 726f 746f 636f 6c73 2028 6f72 0a65 7863  rotocols (or.exc
│ │ │ │ +00003180: 6861 6e67 6573 292e 2020 5468 6572 6520  hanges).  There 
│ │ │ │ +00003190: 6172 6520 7477 6f20 6d65 7468 6f64 7320  are two methods 
│ │ │ │ +000031a0: 6279 2077 6869 6368 2061 2063 6c69 656e  by which a clien
│ │ │ │ +000031b0: 7420 6361 6e20 6173 6b20 6120 4b65 7262  t can ask a Kerb
│ │ │ │ +000031c0: 6572 6f73 0a73 6572 7665 7220 666f 7220  eros.server for 
│ │ │ │ +000031d0: 6372 6564 656e 7469 616c 732e 2020 496e  credentials.  In
│ │ │ │ +000031e0: 2074 6865 2066 6972 7374 2061 7070 726f   the first appro
│ │ │ │ +000031f0: 6163 682c 2074 6865 2063 6c69 656e 7420  ach, the client 
│ │ │ │ +00003200: 7365 6e64 7320 610a 636c 6561 7274 6578  sends a.cleartex
│ │ │ │ +00003210: 7420 7265 7175 6573 7420 666f 7220 6120  t request for a 
│ │ │ │ +00003220: 7469 636b 6574 2066 6f72 2074 6865 2064  ticket for the d
│ │ │ │ +00003230: 6573 6972 6564 2073 6572 7665 7220 746f  esired server to
│ │ │ │ +00003240: 2074 6865 2041 532e 2054 6865 0a72 6570   the AS. The.rep
│ │ │ │ +00003250: 6c79 2069 7320 7365 6e74 2065 6e63 7279  ly is sent encry
│ │ │ │ +00003260: 7074 6564 2069 6e20 7468 6520 636c 6965  pted in the clie
│ │ │ │ +00003270: 6e74 2773 2073 6563 7265 7420 6b65 792e  nt's secret key.
│ │ │ │ +00003280: 2020 5573 7561 6c6c 7920 7468 6973 0a72    Usually this.r
│ │ │ │ +00003290: 6571 7565 7374 2069 7320 666f 7220 6120  equest is for a 
│ │ │ │ +000032a0: 7469 636b 6574 2d67 7261 6e74 696e 6720  ticket-granting 
│ │ │ │ +000032b0: 7469 636b 6574 2028 5447 5429 2077 6869  ticket (TGT) whi
│ │ │ │ +000032c0: 6368 2063 616e 206c 6174 6572 2062 6520  ch can later be 
│ │ │ │ +000032d0: 7573 6564 0a77 6974 6820 7468 6520 7469  used.with the ti
│ │ │ │ +000032e0: 636b 6574 2d67 7261 6e74 696e 6720 7365  cket-granting se
│ │ │ │ +000032f0: 7276 6572 2028 5447 5329 2e20 496e 2074  rver (TGS). In t
│ │ │ │ +00003300: 6865 2073 6563 6f6e 6420 6d65 7468 6f64  he second method
│ │ │ │ +00003310: 2c20 7468 6520 636c 6965 6e74 0a73 656e  , the client.sen
│ │ │ │ +00003320: 6473 2061 2072 6571 7565 7374 2074 6f20  ds a request to 
│ │ │ │ +00003330: 7468 6520 5447 532e 2054 6865 2063 6c69  the TGS. The cli
│ │ │ │ +00003340: 656e 7420 7365 6e64 7320 7468 6520 5447  ent sends the TG
│ │ │ │ +00003350: 5420 746f 2074 6865 2054 4753 2069 6e20  T to the TGS in 
│ │ │ │ +00003360: 7468 650a 7361 6d65 206d 616e 6e65 7220  the.same manner 
│ │ │ │ +00003370: 6173 2069 6620 6974 2077 6572 6520 636f  as if it were co
│ │ │ │ +00003380: 6e74 6163 7469 6e67 2061 6e79 206f 7468  ntacting any oth
│ │ │ │ +00003390: 6572 2061 7070 6c69 6361 7469 6f6e 2073  er application s
│ │ │ │ +000033a0: 6572 7665 7220 7768 6963 680a 7265 7175  erver which.requ
│ │ │ │ +000033b0: 6972 6573 204b 6572 6265 726f 7320 6372  ires Kerberos cr
│ │ │ │ +000033c0: 6564 656e 7469 616c 732e 2020 5468 6520  edentials.  The 
│ │ │ │ +000033d0: 7265 706c 7920 6973 2065 6e63 7279 7074  reply is encrypt
│ │ │ │ +000033e0: 6564 2069 6e20 7468 6520 7365 7373 696f  ed in the sessio
│ │ │ │ +000033f0: 6e0a 6b65 7920 6672 6f6d 2074 6865 2054  n.key from the T
│ │ │ │ +00003400: 4754 2e0a 0a20 2020 4f6e 6365 206f 6274  GT...   Once obt
│ │ │ │ +00003410: 6169 6e65 642c 2063 7265 6465 6e74 6961  ained, credentia
│ │ │ │ +00003420: 6c73 206d 6179 2062 6520 7573 6564 2074  ls may be used t
│ │ │ │ +00003430: 6f20 7665 7269 6679 2074 6865 2069 6465  o verify the ide
│ │ │ │ +00003440: 6e74 6974 7920 6f66 2074 6865 0a70 7269  ntity of the.pri
│ │ │ │ +00003450: 6e63 6970 616c 7320 696e 2061 2074 7261  ncipals in a tra
│ │ │ │ +00003460: 6e73 6163 7469 6f6e 2c20 746f 2065 6e73  nsaction, to ens
│ │ │ │ +00003470: 7572 6520 7468 6520 696e 7465 6772 6974  ure the integrit
│ │ │ │ +00003480: 7920 6f66 206d 6573 7361 6765 730a 6578  y of messages.ex
│ │ │ │ +00003490: 6368 616e 6765 6420 6265 7477 6565 6e20  changed between 
│ │ │ │ +000034a0: 7468 656d 2c20 6f72 2074 6f20 7072 6573  them, or to pres
│ │ │ │ +000034b0: 6572 7665 2070 7269 7661 6379 206f 6620  erve privacy of 
│ │ │ │ +000034c0: 7468 6520 6d65 7373 6167 6573 2e20 2054  the messages.  T
│ │ │ │ +000034d0: 6865 0a61 7070 6c69 6361 7469 6f6e 2069  he.application i
│ │ │ │ +000034e0: 7320 6672 6565 2074 6f20 6368 6f6f 7365  s free to choose
│ │ │ │ +000034f0: 2077 6861 7465 7665 7220 7072 6f74 6563   whatever protec
│ │ │ │ +00003500: 7469 6f6e 206d 6179 2062 6520 6e65 6365  tion may be nece
│ │ │ │ +00003510: 7373 6172 792e 0a0a 2020 2054 6f20 7665  ssary...   To ve
│ │ │ │ +00003520: 7269 6679 2074 6865 2069 6465 6e74 6974  rify the identit
│ │ │ │ +00003530: 6965 7320 6f66 2074 6865 2070 7269 6e63  ies of the princ
│ │ │ │ +00003540: 6970 616c 7320 696e 2061 2074 7261 6e73  ipals in a trans
│ │ │ │ +00003550: 6163 7469 6f6e 2c20 7468 650a 636c 6965  action, the.clie
│ │ │ │ +00003560: 6e74 2074 7261 6e73 6d69 7473 2074 6865  nt transmits the
│ │ │ │ +00003570: 2074 6963 6b65 7420 746f 2074 6865 2073   ticket to the s
│ │ │ │ +00003580: 6572 7665 722e 2020 5369 6e63 6520 7468  erver.  Since th
│ │ │ │ +00003590: 6520 7469 636b 6574 2069 7320 7365 6e74  e ticket is sent
│ │ │ │ +000035a0: 2022 696e 0a74 6865 2063 6c65 6172 2220   "in.the clear" 
│ │ │ │ +000035b0: 2870 6172 7473 206f 6620 6974 2061 7265  (parts of it are
│ │ │ │ +000035c0: 2065 6e63 7279 7074 6564 2c20 6275 7420   encrypted, but 
│ │ │ │ +000035d0: 7468 6973 2065 6e63 7279 7074 696f 6e20  this encryption 
│ │ │ │ +000035e0: 646f 6573 6e27 740a 7468 7761 7274 2072  doesn't.thwart r
│ │ │ │ +000035f0: 6570 6c61 7929 2061 6e64 206d 6967 6874  eplay) and might
│ │ │ │ +00003600: 2062 6520 696e 7465 7263 6570 7465 6420   be intercepted 
│ │ │ │ +00003610: 616e 6420 7265 7573 6564 2062 7920 616e  and reused by an
│ │ │ │ +00003620: 2061 7474 6163 6b65 722c 0a61 6464 6974   attacker,.addit
│ │ │ │ +00003630: 696f 6e61 6c20 696e 666f 726d 6174 696f  ional informatio
│ │ │ │ +00003640: 6e20 6973 2073 656e 7420 746f 2070 726f  n is sent to pro
│ │ │ │ +00003650: 7665 2074 6861 7420 7468 6520 6d65 7373  ve that the mess
│ │ │ │ +00003660: 6167 6520 7761 7320 6f72 6967 696e 6174  age was originat
│ │ │ │ +00003670: 6564 0a62 7920 7468 6520 7072 696e 6369  ed.by the princi
│ │ │ │ +00003680: 7061 6c20 746f 2077 686f 6d20 7468 6520  pal to whom the 
│ │ │ │ +00003690: 7469 636b 6574 2077 6173 2069 7373 7565  ticket was issue
│ │ │ │ +000036a0: 642e 2020 5468 6973 2069 6e66 6f72 6d61  d.  This informa
│ │ │ │ +000036b0: 7469 6f6e 0a28 6361 6c6c 6564 2074 6865  tion.(called the
│ │ │ │ +000036c0: 2061 7574 6865 6e74 6963 6174 6f72 2920   authenticator) 
│ │ │ │ +000036d0: 6973 2065 6e63 7279 7074 6564 2069 6e20  is encrypted in 
│ │ │ │ +000036e0: 7468 6520 7365 7373 696f 6e20 6b65 792c  the session key,
│ │ │ │ +000036f0: 2061 6e64 2069 6e63 6c75 6465 730a 6120   and includes.a 
│ │ │ │ +00003700: 7469 6d65 7374 616d 702e 2020 5468 6520  timestamp.  The 
│ │ │ │ +00003710: 7469 6d65 7374 616d 7020 7072 6f76 6573  timestamp proves
│ │ │ │ +00003720: 2074 6861 7420 7468 6520 6d65 7373 6167   that the messag
│ │ │ │ +00003730: 6520 7761 7320 7265 6365 6e74 6c79 0a67  e was recently.g
│ │ │ │ +00003740: 656e 6572 6174 6564 2061 6e64 2069 7320  enerated and is 
│ │ │ │ +00003750: 6e6f 7420 6120 7265 706c 6179 2e20 2045  not a replay.  E
│ │ │ │ +00003760: 6e63 7279 7074 696e 6720 7468 6520 6175  ncrypting the au
│ │ │ │ +00003770: 7468 656e 7469 6361 746f 7220 696e 2074  thenticator in t
│ │ │ │ +00003780: 6865 0a73 6573 7369 6f6e 206b 6579 2070  he.session key p
│ │ │ │ +00003790: 726f 7665 7320 7468 6174 2069 7420 7761  roves that it wa
│ │ │ │ +000037a0: 7320 6765 6e65 7261 7465 6420 6279 2061  s generated by a
│ │ │ │ +000037b0: 2070 6172 7479 2070 6f73 7365 7373 696e   party possessin
│ │ │ │ +000037c0: 6720 7468 650a 7365 7373 696f 6e20 6b65  g the.session ke
│ │ │ │ +000037d0: 792e 2020 5369 6e63 6520 6e6f 206f 6e65  y.  Since no one
│ │ │ │ +000037e0: 2065 7863 6570 7420 7468 6520 7265 7175   except the requ
│ │ │ │ +000037f0: 6573 7469 6e67 2070 7269 6e63 6970 616c  esting principal
│ │ │ │ +00003800: 2061 6e64 2074 6865 0a73 6572 7665 7220   and the.server 
│ │ │ │ +00003810: 6b6e 6f77 2074 6865 2073 6573 7369 6f6e  know the session
│ │ │ │ +00003820: 206b 6579 2028 6974 2069 7320 6e65 7665   key (it is neve
│ │ │ │ +00003830: 7220 7365 6e74 206f 7665 7220 7468 6520  r sent over the 
│ │ │ │ +00003840: 6e65 7477 6f72 6b20 696e 2074 6865 0a63  network in the.c
│ │ │ │ +00003850: 6c65 6172 2920 7468 6973 2067 7561 7261  lear) this guara
│ │ │ │ +00003860: 6e74 6565 7320 7468 6520 6964 656e 7469  ntees the identi
│ │ │ │ +00003870: 7479 206f 6620 7468 6520 636c 6965 6e74  ty of the client
│ │ │ │ +00003880: 2e0a 0a20 2020 5468 6520 696e 7465 6772  ...   The integr
│ │ │ │ +00003890: 6974 7920 6f66 2074 6865 206d 6573 7361  ity of the messa
│ │ │ │ +000038a0: 6765 7320 6578 6368 616e 6765 6420 6265  ges exchanged be
│ │ │ │ +000038b0: 7477 6565 6e20 7072 696e 6369 7061 6c73  tween principals
│ │ │ │ +000038c0: 2063 616e 2061 6c73 6f0a 6265 2067 7561   can also.be gua
│ │ │ │ +000038d0: 7261 6e74 6565 6420 7573 696e 6720 7468  ranteed using th
│ │ │ │ +000038e0: 6520 7365 7373 696f 6e20 6b65 7920 2870  e session key (p
│ │ │ │ +000038f0: 6173 7365 6420 696e 2074 6865 2074 6963  assed in the tic
│ │ │ │ +00003900: 6b65 7420 616e 6420 636f 6e74 6169 6e65  ket and containe
│ │ │ │ +00003910: 640a 696e 2074 6865 2063 7265 6465 6e74  d.in the credent
│ │ │ │ +00003920: 6961 6c73 292e 2020 5468 6973 2061 7070  ials).  This app
│ │ │ │ +00003930: 726f 6163 6820 7072 6f76 6964 6573 2064  roach provides d
│ │ │ │ +00003940: 6574 6563 7469 6f6e 206f 6620 626f 7468  etection of both
│ │ │ │ +00003950: 2072 6570 6c61 790a 6174 7461 636b 7320   replay.attacks 
│ │ │ │ +00003960: 616e 6420 6d65 7373 6167 6520 7374 7265  and message stre
│ │ │ │ +00003970: 616d 206d 6f64 6966 6963 6174 696f 6e20  am modification 
│ │ │ │ +00003980: 6174 7461 636b 732e 2020 4974 2069 7320  attacks.  It is 
│ │ │ │ +00003990: 6163 636f 6d70 6c69 7368 6564 2062 790a  accomplished by.
│ │ │ │ +000039a0: 6765 6e65 7261 7469 6e67 2061 6e64 2074  generating and t
│ │ │ │ +000039b0: 7261 6e73 6d69 7474 696e 6720 6120 636f  ransmitting a co
│ │ │ │ +000039c0: 6c6c 6973 696f 6e2d 7072 6f6f 6620 6368  llision-proof ch
│ │ │ │ +000039d0: 6563 6b73 756d 2028 656c 7365 7768 6572  ecksum (elsewher
│ │ │ │ +000039e0: 6520 6361 6c6c 6564 0a61 2068 6173 6820  e called.a hash 
│ │ │ │ +000039f0: 6f72 2064 6967 6573 7420 6675 6e63 7469  or digest functi
│ │ │ │ +00003a00: 6f6e 2920 6f66 2074 6865 2063 6c69 656e  on) of the clien
│ │ │ │ +00003a10: 7427 7320 6d65 7373 6167 652c 206b 6579  t's message, key
│ │ │ │ +00003a20: 6564 2077 6974 6820 7468 650a 7365 7373  ed with the.sess
│ │ │ │ +00003a30: 696f 6e20 6b65 792e 2020 5072 6976 6163  ion key.  Privac
│ │ │ │ +00003a40: 7920 616e 6420 696e 7465 6772 6974 7920  y and integrity 
│ │ │ │ +00003a50: 6f66 2074 6865 206d 6573 7361 6765 7320  of the messages 
│ │ │ │ +00003a60: 6578 6368 616e 6765 6420 6265 7477 6565  exchanged betwee
│ │ │ │ +00003a70: 6e0a 7072 696e 6369 7061 6c73 2063 616e  n.principals can
│ │ │ │ +00003a80: 2062 6520 7365 6375 7265 6420 6279 2065   be secured by e
│ │ │ │ +00003a90: 6e63 7279 7074 696e 6720 7468 6520 6461  ncrypting the da
│ │ │ │ +00003aa0: 7461 2074 6f20 6265 2070 6173 7365 6420  ta to be passed 
│ │ │ │ +00003ab0: 7573 696e 6720 7468 650a 7365 7373 696f  using the.sessio
│ │ │ │ +00003ac0: 6e20 6b65 7920 7061 7373 6564 2069 6e20  n key passed in 
│ │ │ │ +00003ad0: 7468 6520 7469 636b 6574 2c20 616e 6420  the ticket, and 
│ │ │ │ +00003ae0: 636f 6e74 6169 6e65 6420 696e 2074 6865  contained in the
│ │ │ │ +00003af0: 2063 7265 6465 6e74 6961 6c73 2e0a 0a20   credentials... 
│ │ │ │ +00003b00: 2020 2d2d 2d2d 2d2d 2d2d 2d2d 2046 6f6f    ---------- Foo
│ │ │ │ +00003b10: 746e 6f74 6573 202d 2d2d 2d2d 2d2d 2d2d  tnotes ---------
│ │ │ │ +00003b20: 2d0a 0a20 2020 2831 2920 5468 6520 7465  -..   (1) The te
│ │ │ │ +00003b30: 7874 2069 7320 6120 6c69 6768 746c 7920  xt is a lightly 
│ │ │ │ +00003b40: 6164 6170 7465 6420 7665 7273 696f 6e20  adapted version 
│ │ │ │ +00003b50: 6f66 2074 6865 2069 6e74 726f 6475 6374  of the introduct
│ │ │ │ +00003b60: 696f 6e20 7365 6374 696f 6e0a 6672 6f6d  ion section.from
│ │ │ │ +00003b70: 2052 4643 2031 3531 3020 6279 204a 2e20   RFC 1510 by J. 
│ │ │ │ +00003b80: 4b6f 686c 2061 6e64 2043 2e20 4e65 756d  Kohl and C. Neum
│ │ │ │ +00003b90: 616e 2c20 5365 7074 656d 6265 7220 3139  an, September 19
│ │ │ │ +00003ba0: 3933 2c20 636f 7079 7269 6768 7420 6c69  93, copyright li
│ │ │ │ +00003bb0: 6b65 6c79 0a6f 776e 6564 2062 7920 7468  kely.owned by th
│ │ │ │ +00003bc0: 6520 5246 4320 3135 3130 2061 7574 686f  e RFC 1510 autho
│ │ │ │ +00003bd0: 7273 206f 7220 736f 6d65 2063 6f6e 7472  rs or some contr
│ │ │ │ +00003be0: 6962 7574 6f72 2e0a 0a1f 0a46 696c 653a  ibutor.....File:
│ │ │ │ +00003bf0: 2073 6869 7368 692e 696e 666f 2c20 204e   shishi.info,  N
│ │ │ │ +00003c00: 6f64 653a 2043 7279 7074 6f67 7261 7068  ode: Cryptograph
│ │ │ │ +00003c10: 6963 204f 7665 7276 6965 772c 2020 4e65  ic Overview,  Ne
│ │ │ │ +00003c20: 7874 3a20 5375 7070 6f72 7465 6420 506c  xt: Supported Pl
│ │ │ │ +00003c30: 6174 666f 726d 732c 2020 5072 6576 3a20  atforms,  Prev: 
│ │ │ │ +00003c40: 4f76 6572 7669 6577 2c20 2055 703a 2049  Overview,  Up: I
│ │ │ │ +00003c50: 6e74 726f 6475 6374 696f 6e0a 0a31 2e34  ntroduction..1.4
│ │ │ │ +00003c60: 2043 7279 7074 6f67 7261 7068 6963 204f   Cryptographic O
│ │ │ │ +00003c70: 7665 7276 6965 770a 3d3d 3d3d 3d3d 3d3d  verview.========
│ │ │ │  00003c80: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ -00003c90: 0a0a 5368 6973 6869 2069 6d70 6c65 6d65  ..Shishi impleme
│ │ │ │ -00003ca0: 6e74 7320 7365 7665 7261 6c20 6f66 2074  nts several of t
│ │ │ │ -00003cb0: 6865 2073 7461 6e64 6172 6420 6372 7970  he standard cryp
│ │ │ │ -00003cc0: 746f 6772 6170 6869 6320 7072 696d 6974  tographic primit
│ │ │ │ -00003cd0: 6976 6573 2e20 2049 6e0a 7468 6973 2073  ives.  In.this s
│ │ │ │ -00003ce0: 6563 7469 6f6e 2077 6520 6769 7665 2074  ection we give t
│ │ │ │ -00003cf0: 6865 206e 616d 6573 206f 6620 7468 6520  he names of the 
│ │ │ │ -00003d00: 7375 7070 6f72 7465 6420 656e 6372 7970  supported encryp
│ │ │ │ -00003d10: 7469 6f6e 2073 7569 7465 732c 2061 6e64  tion suites, and
│ │ │ │ -00003d20: 0a73 6f6d 6520 6e6f 7465 7320 6162 6f75  .some notes abou
│ │ │ │ -00003d30: 7420 7468 656d 2c20 616e 6420 7468 6569  t them, and thei
│ │ │ │ -00003d40: 7220 6173 736f 6369 6174 6564 2063 6865  r associated che
│ │ │ │ -00003d50: 636b 7375 6d20 7375 6974 652e 0a0a 2020  cksum suite...  
│ │ │ │ -00003d60: 2053 7461 7465 6d65 6e74 7320 7375 6368   Statements such
│ │ │ │ -00003d70: 2061 7320 2269 7420 6973 2077 6561 6b22   as "it is weak"
│ │ │ │ -00003d80: 2073 686f 756c 6420 6265 2072 6561 6420   should be read 
│ │ │ │ -00003d90: 6173 206d 6561 6e69 6e67 2074 6861 7420  as meaning that 
│ │ │ │ -00003da0: 7468 6572 650a 6973 206e 6f20 6372 6564  there.is no cred
│ │ │ │ -00003db0: 6962 6c65 2073 6563 7572 6974 7920 616e  ible security an
│ │ │ │ -00003dc0: 616c 7973 6973 206f 6620 7468 6520 6d65  alysis of the me
│ │ │ │ -00003dd0: 6368 616e 6973 6d20 6176 6169 6c61 626c  chanism availabl
│ │ │ │ -00003de0: 652c 2061 6e64 2f6f 7220 7468 6174 0a73  e, and/or that.s
│ │ │ │ -00003df0: 686f 756c 6420 616e 2061 7474 6163 6b20  hould an attack 
│ │ │ │ -00003e00: 6265 2070 7562 6c69 7368 6564 2070 7562  be published pub
│ │ │ │ -00003e10: 6c69 636c 792c 2066 6577 2070 656f 706c  licly, few peopl
│ │ │ │ -00003e20: 6520 776f 756c 6420 6c69 6b65 6c79 2062  e would likely b
│ │ │ │ -00003e30: 650a 7375 7270 7269 7365 642e 2020 416c  e.surprised.  Al
│ │ │ │ -00003e40: 736f 206b 6565 7020 696e 206d 696e 6420  so keep in mind 
│ │ │ │ -00003e50: 7468 6174 2074 6865 206b 6579 2073 697a  that the key siz
│ │ │ │ -00003e60: 6520 6d65 6e74 696f 6e65 6420 6973 2074  e mentioned is t
│ │ │ │ -00003e70: 6865 2061 6374 7561 6c0a 6b65 7920 7369  he actual.key si
│ │ │ │ -00003e80: 7a65 2c20 6e6f 7420 7468 6520 6566 6665  ze, not the effe
│ │ │ │ -00003e90: 6374 6976 6520 6b65 7920 7370 6163 6520  ctive key space 
│ │ │ │ -00003ea0: 6173 2066 6172 2061 7320 6120 6272 7574  as far as a brut
│ │ │ │ -00003eb0: 6520 666f 7263 6520 6174 7461 636b 2069  e force attack i
│ │ │ │ -00003ec0: 730a 636f 6e63 6572 6e65 642e 0a0a 2020  s.concerned...  
│ │ │ │ -00003ed0: 2041 7320 796f 7520 6d61 7920 696e 6665   As you may infe
│ │ │ │ -00003ee0: 7220 6672 6f6d 2074 6865 2064 6573 6372  r from the descr
│ │ │ │ -00003ef0: 6970 7469 6f6e 732c 2074 6865 7265 2069  iptions, there i
│ │ │ │ -00003f00: 7320 6375 7272 656e 746c 7920 6e6f 0a65  s currently no.e
│ │ │ │ -00003f10: 6e63 7279 7074 696f 6e20 616c 676f 7269  ncryption algori
│ │ │ │ -00003f20: 7468 6d20 616e 6420 6f6e 6c79 206f 6e65  thm and only one
│ │ │ │ -00003f30: 2063 6865 636b 7375 6d20 616c 676f 7269   checksum algori
│ │ │ │ -00003f40: 7468 6d20 7468 6174 2069 6e73 7069 7265  thm that inspire
│ │ │ │ -00003f50: 2067 7265 6174 0a63 6f6e 6669 6465 6e63   great.confidenc
│ │ │ │ -00003f60: 6520 696e 2069 7473 2064 6573 6967 6e2e  e in its design.
│ │ │ │ -00003f70: 2020 486f 7065 6675 6c6c 7920 7468 6973    Hopefully this
│ │ │ │ -00003f80: 2077 696c 6c20 6368 616e 6765 206f 7665   will change ove
│ │ │ │ -00003f90: 7220 7469 6d65 2e0a 0ae2 8098 4e55 4c4c  r time......NULL
│ │ │ │ -00003fa0: e280 990a 0a20 2020 2020 e280 984e 554c  .....     ...NUL
│ │ │ │ -00003fb0: 4ce2 8099 2069 7320 6120 6475 6d6d 7920  L... is a dummy 
│ │ │ │ -00003fc0: 656e 6372 7970 7469 6f6e 2073 7569 7465  encryption suite
│ │ │ │ -00003fd0: 2066 6f72 2064 6562 7567 6769 6e67 2e20   for debugging. 
│ │ │ │ -00003fe0: 2045 6e63 7279 7074 696f 6e20 616e 640a   Encryption and.
│ │ │ │ -00003ff0: 2020 2020 2064 6563 7279 7074 696f 6e20       decryption 
│ │ │ │ -00004000: 6172 6520 6964 656e 7469 7479 2066 756e  are identity fun
│ │ │ │ -00004010: 6374 696f 6e73 2e20 204e 6f20 696e 7465  ctions.  No inte
│ │ │ │ -00004020: 6772 6974 7920 7072 6f74 6563 7469 6f6e  grity protection
│ │ │ │ -00004030: 2e20 2049 7420 6973 0a20 2020 2020 7765  .  It is.     we
│ │ │ │ -00004040: 616b 2e20 2049 7420 6973 2061 7373 6f63  ak.  It is assoc
│ │ │ │ -00004050: 6961 7465 6420 7769 7468 2074 6865 20e2  iated with the .
│ │ │ │ -00004060: 8098 4e55 4c4c e280 9920 6368 6563 6b73  ..NULL... checks
│ │ │ │ -00004070: 756d 2e0a 0ae2 8098 6172 6366 6f75 722d  um......arcfour-
│ │ │ │ -00004080: 686d 6163 e280 990a e280 9861 7263 666f  hmac.......arcfo
│ │ │ │ -00004090: 7572 2d68 6d61 632d 6578 70e2 8099 0a0a  ur-hmac-exp.....
│ │ │ │ -000040a0: 2020 2020 20e2 8098 6172 6366 6f75 722d       ...arcfour-
│ │ │ │ -000040b0: 686d 6163 2d2a e280 9920 6172 6520 6120  hmac-*... are a 
│ │ │ │ -000040c0: 7072 6f70 7269 6574 6172 7920 7374 7265  proprietary stre
│ │ │ │ -000040d0: 616d 2063 6970 6865 7220 7769 7468 2035  am cipher with 5
│ │ │ │ -000040e0: 3620 6269 740a 2020 2020 2028 e280 9861  6 bit.     (...a
│ │ │ │ -000040f0: 7263 666f 7572 2d68 6d61 632d 6578 70e2  rcfour-hmac-exp.
│ │ │ │ -00004100: 8099 2920 6f72 2031 3238 2062 6974 2028  ..) or 128 bit (
│ │ │ │ -00004110: e280 9861 7263 666f 7572 2d68 6d61 63e2  ...arcfour-hmac.
│ │ │ │ -00004120: 8099 2920 6b65 7973 2c20 7573 6564 2069  ..) keys, used i
│ │ │ │ -00004130: 6e20 610a 2020 2020 2070 726f 7072 6965  n a.     proprie
│ │ │ │ -00004140: 7461 7279 2077 6179 2064 6573 6372 6962  tary way describ
│ │ │ │ -00004150: 6564 2069 6e20 616e 2065 7870 6972 6564  ed in an expired
│ │ │ │ -00004160: 2049 4554 4620 6472 6166 740a 2020 2020   IETF draft.    
│ │ │ │ -00004170: 20e2 8098 6472 6166 742d 6272 657a 616b   ...draft-brezak
│ │ │ │ -00004180: 2d77 696e 326b 2d6b 7262 2d72 6334 2d68  -win2k-krb-rc4-h
│ │ │ │ -00004190: 6d61 632d 3034 2e74 7874 e280 992e 2020  mac-04.txt....  
│ │ │ │ -000041a0: 4465 7269 7669 6e67 206b 6579 7320 6672  Deriving keys fr
│ │ │ │ -000041b0: 6f6d 0a20 2020 2020 7061 7373 776f 7264  om.     password
│ │ │ │ -000041c0: 7320 6973 2073 7570 706f 7274 6564 2c20  s is supported, 
│ │ │ │ -000041d0: 616e 6420 6973 2064 6f6e 6520 6279 2063  and is done by c
│ │ │ │ -000041e0: 6f6d 7075 7469 6e67 2061 206d 6573 7361  omputing a messa
│ │ │ │ -000041f0: 6765 2064 6967 6573 740a 2020 2020 2028  ge digest.     (
│ │ │ │ -00004200: 4d44 3429 206f 6620 6120 3136 2d62 6974  MD4) of a 16-bit
│ │ │ │ -00004210: 2055 6e69 636f 6465 2072 6570 7265 7365   Unicode represe
│ │ │ │ -00004220: 6e74 6174 696f 6e20 6f66 2074 6865 2041  ntation of the A
│ │ │ │ -00004230: 5343 4949 2070 6173 7377 6f72 642c 0a20  SCII password,. 
│ │ │ │ -00004240: 2020 2020 7769 7468 206e 6f20 7361 6c74      with no salt
│ │ │ │ -00004250: 2e20 2044 6174 6120 6973 2069 6e74 6567  .  Data is integ
│ │ │ │ -00004260: 7269 7479 2070 726f 7465 6374 6564 2077  rity protected w
│ │ │ │ -00004270: 6974 6820 6120 6b65 7965 6420 6861 7368  ith a keyed hash
│ │ │ │ -00004280: 0a20 2020 2020 2848 4d41 432d 4d44 3529  .     (HMAC-MD5)
│ │ │ │ -00004290: 2c20 7768 6572 6520 7468 6520 6b65 7920  , where the key 
│ │ │ │ -000042a0: 6973 2064 6572 6976 6564 2066 726f 6d20  is derived from 
│ │ │ │ -000042b0: 7468 6520 6261 7365 206b 6579 2069 6e20  the base key in 
│ │ │ │ -000042c0: 610a 2020 2020 2063 7265 6174 6976 6520  a.     creative 
│ │ │ │ -000042d0: 7761 792e 2020 4974 2069 7320 7765 616b  way.  It is weak
│ │ │ │ -000042e0: 2e20 2049 7420 6973 2061 7373 6f63 6961  .  It is associa
│ │ │ │ -000042f0: 7465 6420 7769 7468 2074 6865 0a20 2020  ted with the.   
│ │ │ │ -00004300: 2020 e280 9861 7263 666f 7572 2d68 6d61    ...arcfour-hma
│ │ │ │ -00004310: 632d 6d64 35e2 8099 2063 6865 636b 7375  c-md5... checksu
│ │ │ │ -00004320: 6d2e 0a0a e280 9864 6573 2d63 6263 2d6e  m......des-cbc-n
│ │ │ │ -00004330: 6f6e 65e2 8099 0a0a 2020 2020 20e2 8098  one.....     ...
│ │ │ │ -00004340: 6465 732d 6362 632d 6e6f 6e65 e280 9920  des-cbc-none... 
│ │ │ │ -00004350: 6973 2044 4553 2065 6e63 7279 7074 696f  is DES encryptio
│ │ │ │ -00004360: 6e20 616e 6420 6465 6372 7970 7469 6f6e  n and decryption
│ │ │ │ -00004370: 2077 6974 6820 3536 2062 6974 206b 6579   with 56 bit key
│ │ │ │ -00004380: 730a 2020 2020 2061 6e64 2038 2062 7974  s.     and 8 byt
│ │ │ │ -00004390: 6520 626c 6f63 6b73 2069 6e20 4342 4320  e blocks in CBC 
│ │ │ │ -000043a0: 6d6f 6465 2c20 7573 696e 6720 6120 7a65  mode, using a ze
│ │ │ │ -000043b0: 726f 2049 562e 2054 6865 206b 6579 7320  ro IV. The keys 
│ │ │ │ -000043c0: 6361 6e20 6265 0a20 2020 2020 6465 7269  can be.     deri
│ │ │ │ -000043d0: 7665 6420 6672 6f6d 2070 6173 7377 6f72  ved from passwor
│ │ │ │ -000043e0: 6473 2062 7920 616e 206f 6273 6375 7265  ds by an obscure
│ │ │ │ -000043f0: 2061 7070 6c69 6361 7469 6f6e 2073 7065   application spe
│ │ │ │ -00004400: 6369 6669 630a 2020 2020 2061 6c67 6f72  cific.     algor
│ │ │ │ -00004410: 6974 686d 2e20 2049 7420 6973 2077 6561  ithm.  It is wea
│ │ │ │ -00004420: 6b2c 2062 6563 6175 7365 2069 7420 6f66  k, because it of
│ │ │ │ -00004430: 6665 7273 206e 6f20 696e 7465 6772 6974  fers no integrit
│ │ │ │ -00004440: 7920 7072 6f74 6563 7469 6f6e 2e0a 2020  y protection..  
│ │ │ │ -00004450: 2020 2054 6869 7320 6973 2074 7970 6963     This is typic
│ │ │ │ -00004460: 616c 6c79 206f 6e6c 7920 7573 6564 2062  ally only used b
│ │ │ │ -00004470: 7920 5246 4320 3139 3634 2047 5353 2d41  y RFC 1964 GSS-A
│ │ │ │ -00004480: 5049 2069 6d70 6c65 6d65 6e74 6174 696f  PI implementatio
│ │ │ │ -00004490: 6e73 0a20 2020 2020 2877 6869 6368 2074  ns.     (which t
│ │ │ │ -000044a0: 7279 2074 6f20 7072 6f74 6563 7420 696e  ry to protect in
│ │ │ │ -000044b0: 7465 6772 6974 7920 7573 696e 6720 616e  tegrity using an
│ │ │ │ -000044c0: 2061 642d 686f 6320 736f 6c75 7469 6f6e   ad-hoc solution
│ │ │ │ -000044d0: 292e 2020 4974 2069 730a 2020 2020 2061  ).  It is.     a
│ │ │ │ -000044e0: 7373 6f63 6961 7465 6420 7769 7468 2074  ssociated with t
│ │ │ │ -000044f0: 6865 20e2 8098 4e55 4c4c e280 9920 6368  he ...NULL... ch
│ │ │ │ -00004500: 6563 6b73 756d 2e0a 0ae2 8098 6465 732d  ecksum......des-
│ │ │ │ -00004510: 6362 632d 6372 63e2 8099 0a0a 2020 2020  cbc-crc.....    
│ │ │ │ -00004520: 20e2 8098 6465 732d 6362 632d 6372 63e2   ...des-cbc-crc.
│ │ │ │ -00004530: 8099 2069 7320 4445 5320 656e 6372 7970  .. is DES encryp
│ │ │ │ -00004540: 7469 6f6e 2061 6e64 2064 6563 7279 7074  tion and decrypt
│ │ │ │ -00004550: 696f 6e20 7769 7468 2035 3620 6269 7420  ion with 56 bit 
│ │ │ │ -00004560: 6b65 7973 2061 6e64 0a20 2020 2020 3820  keys and.     8 
│ │ │ │ -00004570: 6279 7465 2062 6c6f 636b 7320 696e 2043  byte blocks in C
│ │ │ │ -00004580: 4243 206d 6f64 652c 2075 7369 6e67 2074  BC mode, using t
│ │ │ │ -00004590: 6865 206b 6579 2061 7320 4956 2028 2a6e  he key as IV (*n
│ │ │ │ -000045a0: 6f74 6520 4b65 7920 6173 0a20 2020 2020  ote Key as.     
│ │ │ │ -000045b0: 696e 6974 6961 6c69 7a61 7469 6f6e 2076  initialization v
│ │ │ │ -000045c0: 6563 746f 723a 3a29 2e20 2054 6865 206b  ector::).  The k
│ │ │ │ -000045d0: 6579 7320 6361 6e20 6265 2064 6572 6976  eys can be deriv
│ │ │ │ -000045e0: 6564 2066 726f 6d20 7061 7373 776f 7264  ed from password
│ │ │ │ -000045f0: 730a 2020 2020 2062 7920 616e 206f 6273  s.     by an obs
│ │ │ │ -00004600: 6375 7265 2061 7070 6c69 6361 7469 6f6e  cure application
│ │ │ │ -00004610: 2073 7065 6369 6669 6320 616c 676f 7269   specific algori
│ │ │ │ -00004620: 7468 6d2e 2020 4461 7461 2069 7320 696e  thm.  Data is in
│ │ │ │ -00004630: 7465 6772 6974 790a 2020 2020 2070 726f  tegrity.     pro
│ │ │ │ -00004640: 7465 6374 6564 2077 6974 6820 616e 2075  tected with an u
│ │ │ │ -00004650: 6e6b 6579 6564 2062 7574 2065 6e63 7279  nkeyed but encry
│ │ │ │ -00004660: 7074 6564 20e2 8098 4352 4333 32e2 8099  pted ...CRC32...
│ │ │ │ -00004670: 2d6c 696b 6520 6368 6563 6b73 756d 2e20  -like checksum. 
│ │ │ │ -00004680: 2049 740a 2020 2020 2069 7320 7765 616b   It.     is weak
│ │ │ │ -00004690: 2e20 2049 7420 6973 2061 7373 6f63 6961  .  It is associa
│ │ │ │ -000046a0: 7465 6420 7769 7468 2074 6865 20e2 8098  ted with the ...
│ │ │ │ -000046b0: 7273 612d 6d64 352d 6465 73e2 8099 2063  rsa-md5-des... c
│ │ │ │ -000046c0: 6865 636b 7375 6d2e 0a0a e280 9864 6573  hecksum......des
│ │ │ │ -000046d0: 2d63 6263 2d6d 6434 e280 990a 0a20 2020  -cbc-md4.....   
│ │ │ │ -000046e0: 2020 e280 9864 6573 2d63 6263 2d6d 6434    ...des-cbc-md4
│ │ │ │ -000046f0: e280 9920 6973 2044 4553 2065 6e63 7279  ... is DES encry
│ │ │ │ -00004700: 7074 696f 6e20 616e 6420 6465 6372 7970  ption and decryp
│ │ │ │ -00004710: 7469 6f6e 2077 6974 6820 3536 2062 6974  tion with 56 bit
│ │ │ │ -00004720: 206b 6579 7320 616e 640a 2020 2020 2038   keys and.     8
│ │ │ │ -00004730: 2062 7974 6520 626c 6f63 6b73 2069 6e20   byte blocks in 
│ │ │ │ -00004740: 4342 4320 6d6f 6465 2c20 7573 696e 6720  CBC mode, using 
│ │ │ │ -00004750: 6120 7a65 726f 2049 562e 2054 6865 206b  a zero IV. The k
│ │ │ │ -00004760: 6579 7320 6361 6e20 6265 2064 6572 6976  eys can be deriv
│ │ │ │ -00004770: 6564 0a20 2020 2020 6672 6f6d 2070 6173  ed.     from pas
│ │ │ │ -00004780: 7377 6f72 6473 2062 7920 616e 206f 6273  swords by an obs
│ │ │ │ -00004790: 6375 7265 2061 7070 6c69 6361 7469 6f6e  cure application
│ │ │ │ -000047a0: 2073 7065 6369 6669 6320 616c 676f 7269   specific algori
│ │ │ │ -000047b0: 7468 6d2e 2020 4461 7461 0a20 2020 2020  thm.  Data.     
│ │ │ │ -000047c0: 6973 2069 6e74 6567 7269 7479 2070 726f  is integrity pro
│ │ │ │ -000047d0: 7465 6374 6564 2077 6974 6820 616e 2075  tected with an u
│ │ │ │ -000047e0: 6e6b 6579 6564 2062 7574 2065 6e63 7279  nkeyed but encry
│ │ │ │ -000047f0: 7074 6564 204d 4434 2068 6173 682e 2020  pted MD4 hash.  
│ │ │ │ -00004800: 4974 0a20 2020 2020 6973 2077 6561 6b2e  It.     is weak.
│ │ │ │ -00004810: 2020 4974 2069 7320 6173 736f 6369 6174    It is associat
│ │ │ │ -00004820: 6564 2077 6974 6820 7468 6520 e280 9872  ed with the ...r
│ │ │ │ -00004830: 7361 2d6d 6434 2d64 6573 e280 9920 6368  sa-md4-des... ch
│ │ │ │ -00004840: 6563 6b73 756d 2e0a 0ae2 8098 6465 732d  ecksum......des-
│ │ │ │ -00004850: 6362 632d 6d64 35e2 8099 0a0a 2020 2020  cbc-md5.....    
│ │ │ │ -00004860: 20e2 8098 6465 732d 6362 632d 6d64 35e2   ...des-cbc-md5.
│ │ │ │ -00004870: 8099 2069 7320 4445 5320 656e 6372 7970  .. is DES encryp
│ │ │ │ -00004880: 7469 6f6e 2061 6e64 2064 6563 7279 7074  tion and decrypt
│ │ │ │ -00004890: 696f 6e20 7769 7468 2035 3620 6269 7420  ion with 56 bit 
│ │ │ │ -000048a0: 6b65 7973 2061 6e64 0a20 2020 2020 3820  keys and.     8 
│ │ │ │ -000048b0: 6279 7465 2062 6c6f 636b 7320 696e 2043  byte blocks in C
│ │ │ │ -000048c0: 4243 206d 6f64 652c 2075 7369 6e67 2061  BC mode, using a
│ │ │ │ -000048d0: 207a 6572 6f20 4956 2e20 5468 6520 6b65   zero IV. The ke
│ │ │ │ -000048e0: 7973 2063 616e 2062 6520 6465 7269 7665  ys can be derive
│ │ │ │ -000048f0: 640a 2020 2020 2066 726f 6d20 7061 7373  d.     from pass
│ │ │ │ -00004900: 776f 7264 7320 6279 2061 6e20 6f62 7363  words by an obsc
│ │ │ │ -00004910: 7572 6520 6170 706c 6963 6174 696f 6e20  ure application 
│ │ │ │ -00004920: 7370 6563 6966 6963 2061 6c67 6f72 6974  specific algorit
│ │ │ │ -00004930: 686d 2e20 2044 6174 610a 2020 2020 2069  hm.  Data.     i
│ │ │ │ -00004940: 7320 696e 7465 6772 6974 7920 7072 6f74  s integrity prot
│ │ │ │ -00004950: 6563 7465 6420 7769 7468 2061 6e20 756e  ected with an un
│ │ │ │ -00004960: 6b65 7965 6420 6275 7420 656e 6372 7970  keyed but encryp
│ │ │ │ -00004970: 7465 6420 4d44 3520 6861 7368 2e20 2049  ted MD5 hash.  I
│ │ │ │ -00004980: 740a 2020 2020 2069 7320 7765 616b 2e20  t.     is weak. 
│ │ │ │ -00004990: 2049 7420 6973 2061 7373 6f63 6961 7465   It is associate
│ │ │ │ -000049a0: 6420 7769 7468 2074 6865 20e2 8098 7273  d with the ...rs
│ │ │ │ -000049b0: 612d 6d64 352d 6465 73e2 8099 2063 6865  a-md5-des... che
│ │ │ │ -000049c0: 636b 7375 6d2e 2020 5468 6973 0a20 2020  cksum.  This.   
│ │ │ │ -000049d0: 2020 6973 2074 6865 2073 7472 6f6e 6765    is the stronge
│ │ │ │ -000049e0: 7374 2052 4643 2031 3531 3020 696e 7465  st RFC 1510 inte
│ │ │ │ -000049f0: 726f 7065 7261 626c 6520 656e 6372 7970  roperable encryp
│ │ │ │ -00004a00: 7469 6f6e 206d 6563 6861 6e69 736d 2e0a  tion mechanism..
│ │ │ │ -00004a10: 0ae2 8098 6465 7333 2d63 6263 2d6e 6f6e  ....des3-cbc-non
│ │ │ │ -00004a20: 65e2 8099 0a0a 2020 2020 20e2 8098 6465  e.....     ...de
│ │ │ │ -00004a30: 7333 2d63 6263 2d6e 6f6e 65e2 8099 2069  s3-cbc-none... i
│ │ │ │ -00004a40: 7320 4445 5320 656e 6372 7970 7469 6f6e  s DES encryption
│ │ │ │ -00004a50: 2061 6e64 2064 6563 7279 7074 696f 6e20   and decryption 
│ │ │ │ -00004a60: 7769 7468 2074 6872 6565 2035 3620 6269  with three 56 bi
│ │ │ │ -00004a70: 740a 2020 2020 206b 6579 7320 2865 6666  t.     keys (eff
│ │ │ │ -00004a80: 6563 7469 7665 206b 6579 2073 697a 6520  ective key size 
│ │ │ │ -00004a90: 3131 3220 6269 7473 2920 616e 6420 3820  112 bits) and 8 
│ │ │ │ -00004aa0: 6279 7465 2062 6c6f 636b 7320 696e 2043  byte blocks in C
│ │ │ │ -00004ab0: 4243 206d 6f64 652e 0a20 2020 2020 5468  BC mode..     Th
│ │ │ │ -00004ac0: 6520 6b65 7973 2063 616e 2062 6520 6465  e keys can be de
│ │ │ │ -00004ad0: 7269 7665 6420 6672 6f6d 2070 6173 7377  rived from passw
│ │ │ │ -00004ae0: 6f72 6473 2062 7920 7468 6520 7361 6d65  ords by the same
│ │ │ │ -00004af0: 2061 6c67 6f72 6974 686d 2061 730a 2020   algorithm as.  
│ │ │ │ -00004b00: 2020 20e2 8098 6465 7333 2d63 6263 2d73     ...des3-cbc-s
│ │ │ │ -00004b10: 6861 312d 6b64 e280 992e 2020 4974 2069  ha1-kd....  It i
│ │ │ │ -00004b20: 7320 7765 616b 2c20 6265 6361 7573 6520  s weak, because 
│ │ │ │ -00004b30: 6974 206f 6666 6572 7320 6e6f 2069 6e74  it offers no int
│ │ │ │ -00004b40: 6567 7269 7479 0a20 2020 2020 7072 6f74  egrity.     prot
│ │ │ │ -00004b50: 6563 7469 6f6e 2e20 2054 6869 7320 6973  ection.  This is
│ │ │ │ -00004b60: 2074 7970 6963 616c 6c79 206f 6e6c 7920   typically only 
│ │ │ │ -00004b70: 7573 6564 2062 7920 4753 532d 4150 4920  used by GSS-API 
│ │ │ │ -00004b80: 696d 706c 656d 656e 7461 7469 6f6e 730a  implementations.
│ │ │ │ -00004b90: 2020 2020 2028 7768 6963 6820 7472 7920       (which try 
│ │ │ │ -00004ba0: 746f 2070 726f 7465 6374 2069 6e74 6567  to protect integ
│ │ │ │ -00004bb0: 7269 7479 2075 7369 6e67 2061 6e20 6164  rity using an ad
│ │ │ │ -00004bc0: 2d68 6f63 2073 6f6c 7574 696f 6e29 2066  -hoc solution) f
│ │ │ │ -00004bd0: 6f72 0a20 2020 2020 696e 7465 726f 7065  or.     interope
│ │ │ │ -00004be0: 7261 6269 6c69 7479 2077 6974 6820 736f  rability with so
│ │ │ │ -00004bf0: 6d65 2065 7869 7374 696e 6720 4b65 7262  me existing Kerb
│ │ │ │ -00004c00: 6572 6f73 2047 5353 2069 6d70 6c65 6d65  eros GSS impleme
│ │ │ │ -00004c10: 6e74 6174 696f 6e73 2e0a 2020 2020 2049  ntations..     I
│ │ │ │ -00004c20: 7420 6973 2061 7373 6f63 6961 7465 6420  t is associated 
│ │ │ │ -00004c30: 7769 7468 2074 6865 20e2 8098 4e55 4c4c  with the ...NULL
│ │ │ │ -00004c40: e280 9920 6368 6563 6b73 756d 2e0a 0ae2  ... checksum....
│ │ │ │ -00004c50: 8098 6465 7333 2d63 6263 2d73 6861 312d  ..des3-cbc-sha1-
│ │ │ │ -00004c60: 6b64 e280 990a 0a20 2020 2020 e280 9864  kd.....     ...d
│ │ │ │ -00004c70: 6573 332d 6362 632d 7368 6131 2d6b 64e2  es3-cbc-sha1-kd.
│ │ │ │ -00004c80: 8099 2069 7320 4445 5320 656e 6372 7970  .. is DES encryp
│ │ │ │ -00004c90: 7469 6f6e 2061 6e64 2064 6563 7279 7074  tion and decrypt
│ │ │ │ -00004ca0: 696f 6e20 7769 7468 2074 6872 6565 2035  ion with three 5
│ │ │ │ -00004cb0: 360a 2020 2020 2062 6974 206b 6579 7320  6.     bit keys 
│ │ │ │ -00004cc0: 2865 6666 6563 7469 7665 206b 6579 2073  (effective key s
│ │ │ │ -00004cd0: 697a 6520 3131 3220 6269 7473 2920 616e  ize 112 bits) an
│ │ │ │ -00004ce0: 6420 3820 6279 7465 2062 6c6f 636b 7320  d 8 byte blocks 
│ │ │ │ -00004cf0: 696e 2043 4243 0a20 2020 2020 6d6f 6465  in CBC.     mode
│ │ │ │ -00004d00: 2e20 2054 6865 206b 6579 7320 6361 6e20  .  The keys can 
│ │ │ │ -00004d10: 6265 2064 6572 6976 6564 2066 726f 6d20  be derived from 
│ │ │ │ -00004d20: 7061 7373 776f 7264 7320 6279 2061 2061  passwords by a a
│ │ │ │ -00004d30: 6c67 6f72 6974 686d 2062 6173 6564 0a20  lgorithm based. 
│ │ │ │ -00004d40: 2020 2020 6f6e 2074 6865 2070 6170 6572      on the paper
│ │ │ │ -00004d50: 2022 4120 4265 7474 6572 204b 6579 2053   "A Better Key S
│ │ │ │ -00004d60: 6368 6564 756c 6520 466f 7220 4445 532d  chedule For DES-
│ │ │ │ -00004d70: 6c69 6b65 2043 6970 6865 7273 2220 2831  like Ciphers" (1
│ │ │ │ -00004d80: 2920 6279 0a20 2020 2020 5572 6920 426c  ) by.     Uri Bl
│ │ │ │ -00004d90: 756d 656e 7468 616c 2061 6e64 2053 7465  umenthal and Ste
│ │ │ │ -00004da0: 7665 6e20 4d2e 2042 656c 6c6f 7669 6e20  ven M. Bellovin 
│ │ │ │ -00004db0: 2869 7420 6973 206e 6f74 2063 6c65 6172  (it is not clear
│ │ │ │ -00004dc0: 2069 6620 7468 650a 2020 2020 2061 6c67   if the.     alg
│ │ │ │ -00004dd0: 6f72 6974 686d 2c20 616e 6420 7468 6520  orithm, and the 
│ │ │ │ -00004de0: 7761 7920 6974 2069 7320 7573 6564 2c20  way it is used, 
│ │ │ │ -00004df0: 6973 2075 7365 6420 6279 2061 6e79 206f  is used by any o
│ │ │ │ -00004e00: 7468 6572 2070 726f 746f 636f 6c73 2c0a  ther protocols,.
│ │ │ │ -00004e10: 2020 2020 2061 6c74 686f 7567 6820 6974       although it
│ │ │ │ -00004e20: 2073 6565 6d73 2075 6e6c 696b 656c 7929   seems unlikely)
│ │ │ │ -00004e30: 2e20 2044 6174 6120 6973 2069 6e74 6567  .  Data is integ
│ │ │ │ -00004e40: 7269 7479 2070 726f 7465 6374 6564 2077  rity protected w
│ │ │ │ -00004e50: 6974 6820 610a 2020 2020 206b 6579 6564  ith a.     keyed
│ │ │ │ -00004e60: 2053 4841 3120 6861 7368 2069 6e20 484d   SHA1 hash in HM
│ │ │ │ -00004e70: 4143 206d 6f64 652e 2020 4974 2068 6173  AC mode.  It has
│ │ │ │ -00004e80: 206e 6f20 7365 6375 7269 7479 2070 726f   no security pro
│ │ │ │ -00004e90: 6f66 2c20 6275 7420 6973 0a20 2020 2020  of, but is.     
│ │ │ │ -00004ea0: 6173 7375 6d65 6420 746f 2070 726f 7669  assumed to provi
│ │ │ │ -00004eb0: 6465 2061 6465 7175 6174 6520 7365 6375  de adequate secu
│ │ │ │ -00004ec0: 7269 7479 2069 6e20 7468 6520 7365 6e73  rity in the sens
│ │ │ │ -00004ed0: 6520 7468 6174 206b 6e6f 776c 6564 6765  e that knowledge
│ │ │ │ -00004ee0: 206f 6e0a 2020 2020 2068 6f77 2074 6f20   on.     how to 
│ │ │ │ -00004ef0: 6372 6163 6b20 6974 2069 7320 6e6f 7420  crack it is not 
│ │ │ │ -00004f00: 6b6e 6f77 6e20 746f 2074 6865 2070 7562  known to the pub
│ │ │ │ -00004f10: 6c69 632e 2020 4e6f 7465 2074 6861 7420  lic.  Note that 
│ │ │ │ -00004f20: 7468 6520 6b65 790a 2020 2020 2064 6572  the key.     der
│ │ │ │ -00004f30: 6976 6174 696f 6e20 6675 6e63 7469 6f6e  ivation function
│ │ │ │ -00004f40: 2069 7320 6e6f 7420 7769 6465 6c79 2075   is not widely u
│ │ │ │ -00004f50: 7365 6420 6f75 7473 6964 6520 6f66 204b  sed outside of K
│ │ │ │ -00004f60: 6572 6265 726f 732c 2068 656e 6365 0a20  erberos, hence. 
│ │ │ │ -00004f70: 2020 2020 6e6f 7420 7769 6465 6c79 2073      not widely s
│ │ │ │ -00004f80: 7475 6469 6564 2e20 2049 7420 6973 2061  tudied.  It is a
│ │ │ │ -00004f90: 7373 6f63 6961 7465 6420 7769 7468 2074  ssociated with t
│ │ │ │ -00004fa0: 6865 20e2 8098 686d 6163 2d73 6861 312d  he ...hmac-sha1-
│ │ │ │ -00004fb0: 6465 7333 2d6b 64e2 8099 0a20 2020 2020  des3-kd....     
│ │ │ │ -00004fc0: 6368 6563 6b73 756d 2e0a 0ae2 8098 6165  checksum......ae
│ │ │ │ -00004fd0: 7331 3238 2d63 7473 2d68 6d61 632d 7368  s128-cts-hmac-sh
│ │ │ │ -00004fe0: 6131 2d39 36e2 8099 0ae2 8098 6165 7332  a1-96.......aes2
│ │ │ │ -00004ff0: 3536 2d63 7473 2d68 6d61 632d 7368 6131  56-cts-hmac-sha1
│ │ │ │ -00005000: 2d39 36e2 8099 0a0a 2020 2020 20e2 8098  -96.....     ...
│ │ │ │ -00005010: 6165 7331 3238 2d63 7473 2d68 6d61 632d  aes128-cts-hmac-
│ │ │ │ -00005020: 7368 6131 2d39 36e2 8099 2061 6e64 20e2  sha1-96... and .
│ │ │ │ -00005030: 8098 6165 7332 3536 2d63 7473 2d68 6d61  ..aes256-cts-hma
│ │ │ │ -00005040: 632d 7368 6131 2d39 36e2 8099 2069 7320  c-sha1-96... is 
│ │ │ │ -00005050: 4145 530a 2020 2020 2065 6e63 7279 7074  AES.     encrypt
│ │ │ │ -00005060: 696f 6e20 616e 6420 6465 6372 7970 7469  ion and decrypti
│ │ │ │ -00005070: 6f6e 2077 6974 6820 3132 3820 6269 7420  on with 128 bit 
│ │ │ │ -00005080: 616e 6420 3235 3620 6269 7420 6b65 792c  and 256 bit key,
│ │ │ │ -00005090: 0a20 2020 2020 7265 7370 6563 7469 7665  .     respective
│ │ │ │ -000050a0: 6c79 2c20 616e 6420 3136 2062 7974 6520  ly, and 16 byte 
│ │ │ │ -000050b0: 626c 6f63 6b73 2069 6e20 4342 4320 6d6f  blocks in CBC mo
│ │ │ │ -000050c0: 6465 2077 6974 6820 4369 7068 6572 2054  de with Cipher T
│ │ │ │ -000050d0: 6578 740a 2020 2020 2053 7465 616c 696e  ext.     Stealin
│ │ │ │ -000050e0: 672e 2020 4369 7068 6572 2054 6578 7420  g.  Cipher Text 
│ │ │ │ -000050f0: 5374 6561 6c69 6e67 206d 6561 6e73 2064  Stealing means d
│ │ │ │ -00005100: 6174 6120 6c65 6e67 7468 206f 6620 656e  ata length of en
│ │ │ │ -00005110: 6372 7970 7465 6420 6461 7461 0a20 2020  crypted data.   
│ │ │ │ -00005120: 2020 6973 2070 7265 7365 7276 6564 2028    is preserved (
│ │ │ │ -00005130: 7075 7265 2043 4243 2061 6464 2075 7020  pure CBC add up 
│ │ │ │ -00005140: 746f 2037 2070 6164 2063 6861 7261 6374  to 7 pad charact
│ │ │ │ -00005150: 6572 7329 2e20 2054 6865 206b 6579 7320  ers).  The keys 
│ │ │ │ -00005160: 6361 6e0a 2020 2020 2062 6520 6465 7269  can.     be deri
│ │ │ │ -00005170: 7665 6420 6672 6f6d 2070 6173 7377 6f72  ved from passwor
│ │ │ │ -00005180: 6473 2077 6974 6820 5253 4120 4c61 626f  ds with RSA Labo
│ │ │ │ -00005190: 7261 746f 7269 6573 2050 4b43 5323 3520  ratories PKCS#5 
│ │ │ │ -000051a0: 5061 7373 776f 7264 0a20 2020 2020 4261  Password.     Ba
│ │ │ │ -000051b0: 7365 6420 4b65 7920 4465 7269 7661 7469  sed Key Derivati
│ │ │ │ -000051c0: 6f6e 2046 756e 6374 696f 6e20 3228 3229  on Function 2(2)
│ │ │ │ -000051d0: 2c20 7768 6963 6820 6973 2061 6c6c 6567  , which is alleg
│ │ │ │ -000051e0: 6564 6c79 2070 726f 7661 626c 790a 2020  edly provably.  
│ │ │ │ -000051f0: 2020 2073 6563 7572 6520 696e 2061 2072     secure in a r
│ │ │ │ -00005200: 616e 646f 6d20 6f72 6163 6c65 206d 6f64  andom oracle mod
│ │ │ │ -00005210: 656c 2e20 2044 6174 6120 6973 2069 6e74  el.  Data is int
│ │ │ │ -00005220: 6567 7269 7479 2070 726f 7465 6374 6564  egrity protected
│ │ │ │ -00005230: 2077 6974 680a 2020 2020 2061 206b 6579   with.     a key
│ │ │ │ -00005240: 6564 2053 4841 3120 6861 7368 2c20 696e  ed SHA1 hash, in
│ │ │ │ -00005250: 2048 4d41 4320 6d6f 6465 2c20 7472 756e   HMAC mode, trun
│ │ │ │ -00005260: 6361 7465 6420 746f 2039 3620 6269 7473  cated to 96 bits
│ │ │ │ -00005270: 2e20 2054 6865 7265 2069 7320 6e6f 0a20  .  There is no. 
│ │ │ │ -00005280: 2020 2020 7365 6375 7269 7479 2070 726f      security pro
│ │ │ │ -00005290: 6f66 2c20 6275 7420 7468 6520 7363 6865  of, but the sche
│ │ │ │ -000052a0: 6d65 7320 6172 6520 6173 7375 6d65 6420  mes are assumed 
│ │ │ │ -000052b0: 746f 2070 726f 7669 6465 2061 6465 7175  to provide adequ
│ │ │ │ -000052c0: 6174 650a 2020 2020 2073 6563 7572 6974  ate.     securit
│ │ │ │ -000052d0: 7920 696e 2074 6865 2073 656e 7365 2074  y in the sense t
│ │ │ │ -000052e0: 6861 7420 6b6e 6f77 6c65 6467 6520 6f6e  hat knowledge on
│ │ │ │ -000052f0: 2068 6f77 2074 6f20 6372 6163 6b20 7468   how to crack th
│ │ │ │ -00005300: 656d 2069 7320 6e6f 740a 2020 2020 206b  em is not.     k
│ │ │ │ -00005310: 6e6f 776e 2074 6f20 7468 6520 7075 626c  nown to the publ
│ │ │ │ -00005320: 6963 2e20 204e 6f74 6520 7468 6174 2041  ic.  Note that A
│ │ │ │ -00005330: 4553 2068 6173 2079 6574 2074 6f20 7265  ES has yet to re
│ │ │ │ -00005340: 6365 6976 6520 7468 6520 7465 7374 206f  ceive the test o
│ │ │ │ -00005350: 660a 2020 2020 2074 696d 652c 2061 6e64  f.     time, and
│ │ │ │ -00005360: 2074 6865 2041 4553 2063 6970 6865 7220   the AES cipher 
│ │ │ │ -00005370: 656e 6372 7970 7469 6f6e 206d 6f64 6520  encryption mode 
│ │ │ │ -00005380: 2843 4243 2077 6974 6820 4369 7068 6572  (CBC with Cipher
│ │ │ │ -00005390: 7465 7874 0a20 2020 2020 5374 6561 6c69  text.     Steali
│ │ │ │ -000053a0: 6e67 2c20 616e 6420 6120 6e6f 6e2d 7374  ng, and a non-st
│ │ │ │ -000053b0: 616e 6461 7264 2049 5620 6f75 7470 7574  andard IV output
│ │ │ │ -000053c0: 2920 6973 206e 6f74 2077 6964 656c 7920  ) is not widely 
│ │ │ │ -000053d0: 7374 616e 6461 7264 697a 6564 0a20 2020  standardized.   
│ │ │ │ -000053e0: 2020 2868 656e 6365 206e 6f74 2077 6964    (hence not wid
│ │ │ │ -000053f0: 656c 7920 7374 7564 6965 6429 2e20 2049  ely studied).  I
│ │ │ │ -00005400: 7420 6973 2061 7373 6f63 6961 7465 6420  t is associated 
│ │ │ │ -00005410: 7769 7468 2074 6865 0a20 2020 2020 e280  with the.     ..
│ │ │ │ -00005420: 9868 6d61 632d 7368 6131 2d39 362d 6165  .hmac-sha1-96-ae
│ │ │ │ -00005430: 7331 3238 e280 9920 616e 6420 e280 9868  s128... and ...h
│ │ │ │ -00005440: 6d61 632d 7368 6131 2d39 362d 6165 7332  mac-sha1-96-aes2
│ │ │ │ -00005450: 3536 e280 9920 6368 6563 6b73 756d 732c  56... checksums,
│ │ │ │ -00005460: 0a20 2020 2020 7265 7370 6563 7469 7665  .     respective
│ │ │ │ -00005470: 6c79 2e0a 0a20 2020 5468 6520 7072 6f74  ly...   The prot
│ │ │ │ -00005480: 6f63 6f6c 2064 6f20 6e6f 7420 696e 636c  ocol do not incl
│ │ │ │ -00005490: 7564 6520 616e 7920 7761 7920 746f 206e  ude any way to n
│ │ │ │ -000054a0: 6567 6f74 6961 7465 2077 6869 6368 2063  egotiate which c
│ │ │ │ -000054b0: 6865 636b 7375 6d0a 6d65 6368 616e 6973  hecksum.mechanis
│ │ │ │ -000054c0: 6d73 2074 6f20 7573 652c 2073 6f20 696e  ms to use, so in
│ │ │ │ -000054d0: 206d 6f73 7420 6361 7365 7320 7468 6520   most cases the 
│ │ │ │ -000054e0: 6173 736f 6369 6174 6564 2063 6865 636b  associated check
│ │ │ │ -000054f0: 7375 6d20 7769 6c6c 2062 650a 7573 6564  sum will be.used
│ │ │ │ -00005500: 2e20 2048 6f77 6576 6572 2c20 6368 6563  .  However, chec
│ │ │ │ -00005510: 6b73 756d 206d 6563 6861 6e69 736d 7320  ksum mechanisms 
│ │ │ │ -00005520: 6361 6e20 6265 2075 7365 6420 7769 7468  can be used with
│ │ │ │ -00005530: 206f 7468 6572 2065 6e63 7279 7074 696f   other encryptio
│ │ │ │ -00005540: 6e0a 6d65 6368 616e 6973 6d73 2c20 6173  n.mechanisms, as
│ │ │ │ -00005550: 206c 6f6e 6720 6173 2074 6865 7920 6172   long as they ar
│ │ │ │ -00005560: 6520 636f 6d70 6174 6962 6c65 2069 6e20  e compatible in 
│ │ │ │ -00005570: 7465 726d 7320 6f66 206b 6579 2066 6f72  terms of key for
│ │ │ │ -00005580: 6d61 7420 6574 632e 0a48 6572 6520 6172  mat etc..Here ar
│ │ │ │ -00005590: 6520 7468 6520 6e61 6d65 7320 6f66 2074  e the names of t
│ │ │ │ -000055a0: 6865 2073 7570 706f 7274 6564 2063 6865  he supported che
│ │ │ │ -000055b0: 636b 7375 6d20 6d65 6368 616e 6973 6d73  cksum mechanisms
│ │ │ │ -000055c0: 2c20 7769 7468 2073 6f6d 6520 6e6f 7465  , with some note
│ │ │ │ -000055d0: 730a 6f6e 2074 6865 6972 2073 7461 7475  s.on their statu
│ │ │ │ -000055e0: 7320 616e 6420 7468 6520 636f 6d70 6174  s and the compat
│ │ │ │ -000055f0: 6962 6c65 2065 6e63 7279 7074 696f 6e20  ible encryption 
│ │ │ │ -00005600: 6d65 6368 616e 6973 6d73 2e20 2054 6865  mechanisms.  The
│ │ │ │ -00005610: 7920 6172 650a 6f72 6465 7265 6420 6279  y are.ordered by
│ │ │ │ -00005620: 2069 6e63 7265 6173 6564 2073 6563 7572   increased secur
│ │ │ │ -00005630: 6974 7920 6173 2070 6572 6365 6976 6564  ity as perceived
│ │ │ │ -00005640: 2062 7920 7468 6520 6175 7468 6f72 2e0a   by the author..
│ │ │ │ -00005650: 0ae2 8098 4e55 4c4c e280 990a 0a20 2020  ....NULL.....   
│ │ │ │ -00005660: 2020 e280 984e 554c 4ce2 8099 2069 7320    ...NULL... is 
│ │ │ │ -00005670: 6120 6475 6d6d 7920 6368 6563 6b73 756d  a dummy checksum
│ │ │ │ -00005680: 2073 7569 7465 2066 6f72 2064 6562 7567   suite for debug
│ │ │ │ -00005690: 6769 6e67 2e20 2049 7420 7072 6f76 6964  ging.  It provid
│ │ │ │ -000056a0: 6573 206e 6f0a 2020 2020 2069 6e74 6567  es no.     integ
│ │ │ │ -000056b0: 7269 7479 2e20 2049 7420 6973 2077 6561  rity.  It is wea
│ │ │ │ -000056c0: 6b2e 2020 4974 2069 7320 636f 6d70 6174  k.  It is compat
│ │ │ │ -000056d0: 6962 6c65 2077 6974 6820 7468 6520 e280  ible with the ..
│ │ │ │ -000056e0: 984e 554c 4ce2 8099 0a20 2020 2020 656e  .NULL....     en
│ │ │ │ -000056f0: 6372 7970 7469 6f6e 206d 6563 6861 6e69  cryption mechani
│ │ │ │ -00005700: 736d 2e0a 0ae2 8098 6172 6366 6f75 722d  sm......arcfour-
│ │ │ │ -00005710: 686d 6163 2d6d 6435 e280 990a 0a20 2020  hmac-md5.....   
│ │ │ │ -00005720: 2020 e280 9861 7263 666f 7572 2d68 6d61    ...arcfour-hma
│ │ │ │ -00005730: 632d 6d64 35e2 8099 2069 7320 6120 6b65  c-md5... is a ke
│ │ │ │ -00005740: 7965 6420 484d 4143 2d4d 4435 2063 6865  yed HMAC-MD5 che
│ │ │ │ -00005750: 636b 7375 6d20 636f 6d70 7574 6564 206f  cksum computed o
│ │ │ │ -00005760: 6e20 6120 4d44 350a 2020 2020 206d 6573  n a MD5.     mes
│ │ │ │ -00005770: 7361 6765 2064 6967 6573 742c 2069 6e20  sage digest, in 
│ │ │ │ -00005780: 7475 726e 2063 6f6d 7075 7465 6420 6f6e  turn computed on
│ │ │ │ -00005790: 2061 2066 6f75 7220 6279 7465 206d 6573   a four byte mes
│ │ │ │ -000057a0: 7361 6765 2074 7970 650a 2020 2020 2069  sage type.     i
│ │ │ │ -000057b0: 6e64 6963 6174 6f72 2063 6f6e 6361 7465  ndicator concate
│ │ │ │ -000057c0: 6e61 7465 6420 7769 7468 2074 6865 2061  nated with the a
│ │ │ │ -000057d0: 7070 6c69 6361 7469 6f6e 2064 6174 612e  pplication data.
│ │ │ │ -000057e0: 2020 2854 6865 20e2 8098 6172 6366 6f75    (The ...arcfou
│ │ │ │ -000057f0: 72e2 8099 0a20 2020 2020 6465 7369 676e  r....     design
│ │ │ │ -00005800: 6174 696f 6e20 6973 2074 6875 7320 736f  ation is thus so
│ │ │ │ -00005810: 6d65 7768 6174 206d 6973 6c65 6164 696e  mewhat misleadin
│ │ │ │ -00005820: 672c 2062 7574 2073 696e 6365 2074 6869  g, but since thi
│ │ │ │ -00005830: 7320 6368 6563 6b73 756d 0a20 2020 2020  s checksum.     
│ │ │ │ -00005840: 6d65 6368 616e 6973 6d20 6973 2064 6573  mechanism is des
│ │ │ │ -00005850: 6372 6962 6564 2069 6e20 7468 6520 7361  cribed in the sa
│ │ │ │ -00005860: 6d65 2064 6f63 756d 656e 7420 6173 2074  me document as t
│ │ │ │ -00005870: 6865 20e2 8098 6172 6366 6f75 72e2 8099  he ...arcfour...
│ │ │ │ -00005880: 0a20 2020 2020 656e 6372 7970 7469 6f6e  .     encryption
│ │ │ │ -00005890: 206d 6563 6861 6e69 736d 732c 2069 7420   mechanisms, it 
│ │ │ │ -000058a0: 6973 206e 6f74 2061 2063 6f6d 706c 6574  is not a complet
│ │ │ │ -000058b0: 656c 7920 756e 6e61 7475 7261 6c0a 2020  ely unnatural.  
│ │ │ │ -000058c0: 2020 2064 6573 6967 6e61 7469 6f6e 2e29     designation.)
│ │ │ │ -000058d0: 2020 4974 2069 7320 7765 616b 2e20 2049    It is weak.  I
│ │ │ │ -000058e0: 7420 6973 2063 6f6d 7061 7469 626c 6520  t is compatible 
│ │ │ │ -000058f0: 7769 7468 2061 6c6c 2065 6e63 7279 7074  with all encrypt
│ │ │ │ -00005900: 696f 6e0a 2020 2020 206d 6563 6861 6e69  ion.     mechani
│ │ │ │ -00005910: 736d 732e 0a0a e280 9872 7361 2d6d 6434  sms......rsa-md4
│ │ │ │ -00005920: e280 990a 0a20 2020 2020 e280 9872 7361  .....     ...rsa
│ │ │ │ -00005930: 2d6d 6434 e280 9920 6973 2061 2075 6e6b  -md4... is a unk
│ │ │ │ -00005940: 6579 6564 204d 4434 2068 6173 6820 636f  eyed MD4 hash co
│ │ │ │ -00005950: 6d70 7574 6564 206f 7665 7220 7468 6520  mputed over the 
│ │ │ │ -00005960: 6d65 7373 6167 652e 2020 4974 2069 730a  message.  It is.
│ │ │ │ -00005970: 2020 2020 2077 6561 6b2c 2062 6563 6175       weak, becau
│ │ │ │ -00005980: 7365 2069 7420 6973 2075 6e6b 6579 6564  se it is unkeyed
│ │ │ │ -00005990: 2e20 2048 6f77 6576 6572 2061 7070 6c69  .  However appli
│ │ │ │ -000059a0: 6361 7469 6f6e 7320 6361 6e2c 2077 6974  cations can, wit
│ │ │ │ -000059b0: 6820 6361 7265 2c0a 2020 2020 2075 7365  h care,.     use
│ │ │ │ -000059c0: 2069 7420 6e6f 6e2d 7765 616b 2077 6179   it non-weak way
│ │ │ │ -000059d0: 7320 2865 2e67 2e2c 2062 7920 696e 636c  s (e.g., by incl
│ │ │ │ -000059e0: 7564 696e 6720 7468 6520 6861 7368 2069  uding the hash i
│ │ │ │ -000059f0: 6e20 6f74 6865 7220 6d65 7373 6167 6573  n other messages
│ │ │ │ -00005a00: 0a20 2020 2020 7468 6174 2061 7265 2070  .     that are p
│ │ │ │ -00005a10: 726f 7465 6374 6564 2062 7920 6f74 6865  rotected by othe
│ │ │ │ -00005a20: 7220 6d65 616e 7329 2e20 2049 7420 6973  r means).  It is
│ │ │ │ -00005a30: 2063 6f6d 7061 7469 626c 6520 7769 7468   compatible with
│ │ │ │ -00005a40: 2061 6c6c 0a20 2020 2020 656e 6372 7970   all.     encryp
│ │ │ │ -00005a50: 7469 6f6e 206d 6563 6861 6e69 736d 732e  tion mechanisms.
│ │ │ │ -00005a60: 0a0a e280 9872 7361 2d6d 6434 2d64 6573  .....rsa-md4-des
│ │ │ │ -00005a70: e280 990a 0a20 2020 2020 e280 9872 7361  .....     ...rsa
│ │ │ │ -00005a80: 2d6d 6434 2d64 6573 e280 9920 6973 2061  -md4-des... is a
│ │ │ │ -00005a90: 2044 4553 2043 4243 2065 6e63 7279 7074   DES CBC encrypt
│ │ │ │ -00005aa0: 696f 6e20 6f66 206f 6e65 2062 6c6f 636b  ion of one block
│ │ │ │ -00005ab0: 206f 6620 7261 6e64 6f6d 2064 6174 610a   of random data.
│ │ │ │ -00005ac0: 2020 2020 2061 6e64 2061 2075 6e6b 6579       and a unkey
│ │ │ │ -00005ad0: 6564 204d 4434 2068 6173 6820 636f 6d70  ed MD4 hash comp
│ │ │ │ -00005ae0: 7574 6564 206f 7665 7220 7468 6520 7261  uted over the ra
│ │ │ │ -00005af0: 6e64 6f6d 2064 6174 6120 616e 6420 7468  ndom data and th
│ │ │ │ -00005b00: 650a 2020 2020 206d 6573 7361 6765 2074  e.     message t
│ │ │ │ -00005b10: 6f20 696e 7465 6772 6974 7920 7072 6f74  o integrity prot
│ │ │ │ -00005b20: 6563 742e 2020 5468 6520 6b65 7920 7573  ect.  The key us
│ │ │ │ -00005b30: 6564 2069 7320 6465 7269 7665 6420 6672  ed is derived fr
│ │ │ │ -00005b40: 6f6d 2074 6865 0a20 2020 2020 6261 7365  om the.     base
│ │ │ │ -00005b50: 2070 726f 746f 636f 6c20 6b65 7920 6279   protocol key by
│ │ │ │ -00005b60: 2058 4f52 2077 6974 6820 6120 636f 6e73   XOR with a cons
│ │ │ │ -00005b70: 7461 6e74 2e20 2049 7420 6973 2077 6561  tant.  It is wea
│ │ │ │ -00005b80: 6b2e 2020 4974 2069 730a 2020 2020 2063  k.  It is.     c
│ │ │ │ -00005b90: 6f6d 7061 7469 626c 6520 7769 7468 2074  ompatible with t
│ │ │ │ -00005ba0: 6865 20e2 8098 6465 732d 6362 632d 6372  he ...des-cbc-cr
│ │ │ │ -00005bb0: 63e2 8099 2c20 e280 9864 6573 2d63 6263  c..., ...des-cbc
│ │ │ │ -00005bc0: 2d6d 6434 e280 992c 20e2 8098 6465 732d  -md4..., ...des-
│ │ │ │ -00005bd0: 6362 632d 6d64 35e2 8099 0a20 2020 2020  cbc-md5....     
│ │ │ │ -00005be0: 656e 6372 7970 7469 6f6e 206d 6563 6861  encryption mecha
│ │ │ │ -00005bf0: 6e69 736d 732e 0a0a e280 9872 7361 2d6d  nisms......rsa-m
│ │ │ │ -00005c00: 6435 e280 990a 0a20 2020 2020 e280 9872  d5.....     ...r
│ │ │ │ -00005c10: 7361 2d6d 6435 e280 9920 6973 2061 2075  sa-md5... is a u
│ │ │ │ -00005c20: 6e6b 6579 6564 204d 4435 2068 6173 6820  nkeyed MD5 hash 
│ │ │ │ -00005c30: 636f 6d70 7574 6564 206f 7665 7220 7468  computed over th
│ │ │ │ -00005c40: 6520 6d65 7373 6167 652e 2020 4974 2069  e message.  It i
│ │ │ │ -00005c50: 730a 2020 2020 2077 6561 6b2c 2062 6563  s.     weak, bec
│ │ │ │ -00005c60: 6175 7365 2069 7420 6973 2075 6e6b 6579  ause it is unkey
│ │ │ │ -00005c70: 6564 2e20 2048 6f77 6576 6572 2061 7070  ed.  However app
│ │ │ │ -00005c80: 6c69 6361 7469 6f6e 7320 6361 6e2c 2077  lications can, w
│ │ │ │ -00005c90: 6974 6820 6361 7265 2c0a 2020 2020 2075  ith care,.     u
│ │ │ │ -00005ca0: 7365 2069 7420 6e6f 6e2d 7765 616b 2077  se it non-weak w
│ │ │ │ -00005cb0: 6179 7320 2865 2e67 2e2c 2062 7920 696e  ays (e.g., by in
│ │ │ │ -00005cc0: 636c 7564 696e 6720 7468 6520 6861 7368  cluding the hash
│ │ │ │ -00005cd0: 2069 6e20 6f74 6865 7220 6d65 7373 6167   in other messag
│ │ │ │ -00005ce0: 6573 0a20 2020 2020 7468 6174 2061 7265  es.     that are
│ │ │ │ -00005cf0: 2070 726f 7465 6374 6564 2062 7920 6f74   protected by ot
│ │ │ │ -00005d00: 6865 7220 6d65 616e 7329 2e20 2049 7420  her means).  It 
│ │ │ │ -00005d10: 6973 2063 6f6d 7061 7469 626c 6520 7769  is compatible wi
│ │ │ │ -00005d20: 7468 2061 6c6c 0a20 2020 2020 656e 6372  th all.     encr
│ │ │ │ -00005d30: 7970 7469 6f6e 206d 6563 6861 6e69 736d  yption mechanism
│ │ │ │ -00005d40: 732e 0a0a e280 9872 7361 2d6d 6435 2d64  s......rsa-md5-d
│ │ │ │ -00005d50: 6573 e280 990a 0a20 2020 2020 e280 9872  es.....     ...r
│ │ │ │ -00005d60: 7361 2d6d 6435 2d64 6573 e280 9920 6973  sa-md5-des... is
│ │ │ │ -00005d70: 2061 2044 4553 2043 4243 2065 6e63 7279   a DES CBC encry
│ │ │ │ -00005d80: 7074 696f 6e20 6f66 206f 6e65 2062 6c6f  ption of one blo
│ │ │ │ -00005d90: 636b 206f 6620 7261 6e64 6f6d 2064 6174  ck of random dat
│ │ │ │ -00005da0: 610a 2020 2020 2061 6e64 2061 2075 6e6b  a.     and a unk
│ │ │ │ -00005db0: 6579 6564 204d 4435 2068 6173 6820 636f  eyed MD5 hash co
│ │ │ │ -00005dc0: 6d70 7574 6564 206f 7665 7220 7468 6520  mputed over the 
│ │ │ │ -00005dd0: 7261 6e64 6f6d 2064 6174 6120 616e 6420  random data and 
│ │ │ │ -00005de0: 7468 650a 2020 2020 206d 6573 7361 6765  the.     message
│ │ │ │ -00005df0: 2074 6f20 696e 7465 6772 6974 7920 7072   to integrity pr
│ │ │ │ -00005e00: 6f74 6563 742e 2020 5468 6520 6b65 7920  otect.  The key 
│ │ │ │ -00005e10: 7573 6564 2069 7320 6465 7269 7665 6420  used is derived 
│ │ │ │ -00005e20: 6672 6f6d 2074 6865 0a20 2020 2020 6261  from the.     ba
│ │ │ │ -00005e30: 7365 2070 726f 746f 636f 6c20 6b65 7920  se protocol key 
│ │ │ │ -00005e40: 6279 2058 4f52 2077 6974 6820 6120 636f  by XOR with a co
│ │ │ │ -00005e50: 6e73 7461 6e74 2e20 2049 7420 6973 2077  nstant.  It is w
│ │ │ │ -00005e60: 6561 6b2e 2020 4974 2069 730a 2020 2020  eak.  It is.    
│ │ │ │ -00005e70: 2063 6f6d 7061 7469 626c 6520 7769 7468   compatible with
│ │ │ │ -00005e80: 2074 6865 20e2 8098 6465 732d 6362 632d   the ...des-cbc-
│ │ │ │ -00005e90: 6372 63e2 8099 2c20 e280 9864 6573 2d63  crc..., ...des-c
│ │ │ │ -00005ea0: 6263 2d6d 6434 e280 992c 20e2 8098 6465  bc-md4..., ...de
│ │ │ │ -00005eb0: 732d 6362 632d 6d64 35e2 8099 0a20 2020  s-cbc-md5....   
│ │ │ │ -00005ec0: 2020 656e 6372 7970 7469 6f6e 206d 6563    encryption mec
│ │ │ │ -00005ed0: 6861 6e69 736d 732e 0a0a e280 9868 6d61  hanisms......hma
│ │ │ │ -00005ee0: 632d 7368 6131 2d64 6573 332d 6b64 e280  c-sha1-des3-kd..
│ │ │ │ -00005ef0: 990a 0a20 2020 2020 e280 9868 6d61 632d  ...     ...hmac-
│ │ │ │ -00005f00: 7368 6131 2d64 6573 332d 6b64 e280 9920  sha1-des3-kd... 
│ │ │ │ -00005f10: 6973 2061 206b 6579 6564 2053 4841 3120  is a keyed SHA1 
│ │ │ │ -00005f20: 6861 7368 2069 6e20 484d 4143 206d 6f64  hash in HMAC mod
│ │ │ │ -00005f30: 6520 636f 6d70 7574 6564 206f 7665 720a  e computed over.
│ │ │ │ -00005f40: 2020 2020 2074 6865 206d 6573 7361 6765       the message
│ │ │ │ -00005f50: 2e20 2054 6865 206b 6579 2069 7320 6465  .  The key is de
│ │ │ │ -00005f60: 7269 7665 6420 6672 6f6d 2074 6865 2062  rived from the b
│ │ │ │ -00005f70: 6173 6520 7072 6f74 6f63 6f6c 2062 7920  ase protocol by 
│ │ │ │ -00005f80: 7468 650a 2020 2020 2073 696d 706c 6966  the.     simplif
│ │ │ │ -00005f90: 6965 6420 6b65 7920 6465 7269 7661 7469  ied key derivati
│ │ │ │ -00005fa0: 6f6e 2066 756e 6374 696f 6e20 2873 696d  on function (sim
│ │ │ │ -00005fb0: 696c 6172 2074 6f20 7468 6520 7061 7373  ilar to the pass
│ │ │ │ -00005fc0: 776f 7264 206b 6579 0a20 2020 2020 6465  word key.     de
│ │ │ │ -00005fd0: 7269 7661 7469 6f6e 2066 756e 6374 696f  rivation functio
│ │ │ │ -00005fe0: 6e73 206f 6620 e280 9864 6573 332d 6362  ns of ...des3-cb
│ │ │ │ -00005ff0: 632d 7368 6131 2d6b 64e2 8099 2c20 7768  c-sha1-kd..., wh
│ │ │ │ -00006000: 6963 6820 646f 6573 206e 6f74 2061 7070  ich does not app
│ │ │ │ -00006010: 6561 720a 2020 2020 2074 6f20 6265 2077  ear.     to be w
│ │ │ │ -00006020: 6964 656c 7920 7573 6564 206f 7574 7369  idely used outsi
│ │ │ │ -00006030: 6465 204b 6572 6265 726f 7320 616e 6420  de Kerberos and 
│ │ │ │ -00006040: 6865 6e63 6520 6e6f 7420 7769 6465 6c79  hence not widely
│ │ │ │ -00006050: 2073 7475 6469 6564 292e 0a20 2020 2020   studied)..     
│ │ │ │ -00006060: 4974 2068 6173 206e 6f20 7365 6375 7269  It has no securi
│ │ │ │ -00006070: 7479 2070 726f 6f66 2c20 6275 7420 6973  ty proof, but is
│ │ │ │ -00006080: 2061 7373 756d 6564 2074 6f20 7072 6f76   assumed to prov
│ │ │ │ -00006090: 6964 6520 676f 6f64 2073 6563 7572 6974  ide good securit
│ │ │ │ -000060a0: 792e 0a20 2020 2020 5468 6520 7765 616b  y..     The weak
│ │ │ │ -000060b0: 6573 7420 7061 7274 2069 7320 6c69 6b65  est part is like
│ │ │ │ -000060c0: 6c79 2074 6865 2070 726f 7072 6965 7461  ly the proprieta
│ │ │ │ -000060d0: 7279 206b 6579 2064 6572 6976 6174 696f  ry key derivatio
│ │ │ │ -000060e0: 6e20 6675 6e63 7469 6f6e 2e0a 2020 2020  n function..    
│ │ │ │ -000060f0: 2049 7420 6973 2063 6f6d 7061 7469 626c   It is compatibl
│ │ │ │ -00006100: 6520 7769 7468 2074 6865 20e2 8098 6465  e with the ...de
│ │ │ │ -00006110: 7333 2d63 6263 2d73 6861 312d 6b64 e280  s3-cbc-sha1-kd..
│ │ │ │ -00006120: 9920 656e 6372 7970 7469 6f6e 206d 6563  . encryption mec
│ │ │ │ -00006130: 6861 6e69 736d 2e0a 0ae2 8098 686d 6163  hanism......hmac
│ │ │ │ -00006140: 2d73 6861 312d 3936 2d61 6573 3132 38e2  -sha1-96-aes128.
│ │ │ │ -00006150: 8099 0ae2 8098 686d 6163 2d73 6861 312d  ......hmac-sha1-
│ │ │ │ -00006160: 3936 2d61 6573 3235 36e2 8099 0a0a 2020  96-aes256.....  
│ │ │ │ -00006170: 2020 20e2 8098 686d 6163 2d73 6861 312d     ...hmac-sha1-
│ │ │ │ -00006180: 3936 2d61 6573 2ae2 8099 2061 7265 206b  96-aes*... are k
│ │ │ │ -00006190: 6579 6564 2053 4841 3120 6861 7368 6573  eyed SHA1 hashes
│ │ │ │ -000061a0: 2069 6e20 484d 4143 206d 6f64 6520 636f   in HMAC mode co
│ │ │ │ -000061b0: 6d70 7574 6564 0a20 2020 2020 6f76 6572  mputed.     over
│ │ │ │ -000061c0: 2074 6865 206d 6573 7361 6765 2061 6e64   the message and
│ │ │ │ -000061d0: 2074 6865 6e20 7472 756e 6361 7465 6420   then truncated 
│ │ │ │ -000061e0: 746f 2039 3620 6269 7473 2e20 2054 6865  to 96 bits.  The
│ │ │ │ -000061f0: 206b 6579 2069 7320 6465 7269 7665 640a   key is derived.
│ │ │ │ -00006200: 2020 2020 2066 726f 6d20 7468 6520 6261       from the ba
│ │ │ │ -00006210: 7365 2070 726f 746f 636f 6c20 6279 2074  se protocol by t
│ │ │ │ -00006220: 6865 2073 696d 706c 6966 6965 6420 6b65  he simplified ke
│ │ │ │ -00006230: 7920 6465 7269 7661 7469 6f6e 2066 756e  y derivation fun
│ │ │ │ -00006240: 6374 696f 6e0a 2020 2020 2028 7369 6d69  ction.     (simi
│ │ │ │ -00006250: 6c61 7220 746f 2074 6865 2070 6173 7377  lar to the passw
│ │ │ │ -00006260: 6f72 6420 6b65 7920 6465 7269 7661 7469  ord key derivati
│ │ │ │ -00006270: 6f6e 2066 756e 6374 696f 6e73 206f 660a  on functions of.
│ │ │ │ -00006280: 2020 2020 20e2 8098 6165 732a 2d63 7473       ...aes*-cts
│ │ │ │ -00006290: 2d68 6d61 632d 7368 6131 2d39 36e2 8099  -hmac-sha1-96...
│ │ │ │ -000062a0: 2c20 692e 652e 2c20 504b 4353 2335 292e  , i.e., PKCS#5).
│ │ │ │ -000062b0: 2020 4974 2068 6173 206e 6f20 7365 6375    It has no secu
│ │ │ │ -000062c0: 7269 7479 2070 726f 6f66 2c0a 2020 2020  rity proof,.    
│ │ │ │ -000062d0: 2062 7574 2069 7320 6173 7375 6d65 6420   but is assumed 
│ │ │ │ -000062e0: 746f 2070 726f 7669 6465 2067 6f6f 6420  to provide good 
│ │ │ │ -000062f0: 7365 6375 7269 7479 2e20 2049 7420 6973  security.  It is
│ │ │ │ -00006300: 2063 6f6d 7061 7469 626c 6520 7769 7468   compatible with
│ │ │ │ -00006310: 2074 6865 0a20 2020 2020 e280 9861 6573   the.     ...aes
│ │ │ │ -00006320: 2a2d 6374 732d 686d 6163 2d73 6861 312d  *-cts-hmac-sha1-
│ │ │ │ -00006330: 3936 e280 9920 656e 6372 7970 7469 6f6e  96... encryption
│ │ │ │ -00006340: 206d 6563 6861 6e69 736d 732e 0a0a 2020   mechanisms...  
│ │ │ │ -00006350: 2053 6576 6572 616c 206f 6620 7468 6520   Several of the 
│ │ │ │ -00006360: 6369 7068 6572 2073 7569 7465 7320 6861  cipher suites ha
│ │ │ │ -00006370: 7665 206c 6f6e 6720 6e61 6d65 7320 7468  ve long names th
│ │ │ │ -00006380: 6174 2063 616e 2062 6520 6861 7264 2074  at can be hard t
│ │ │ │ -00006390: 6f0a 6d65 6d6f 7269 7a65 2e20 2046 6f72  o.memorize.  For
│ │ │ │ -000063a0: 2079 6f75 7220 636f 6e76 656e 6965 6e63   your convenienc
│ │ │ │ -000063b0: 652c 2074 6865 2066 6f6c 6c6f 7769 6e67  e, the following
│ │ │ │ -000063c0: 2073 686f 7274 2d68 616e 6420 616c 6961   short-hand alia
│ │ │ │ -000063d0: 7365 730a 6578 6973 7473 2e20 2054 6865  ses.exists.  The
│ │ │ │ -000063e0: 7920 6361 6e20 6265 2075 7365 6420 7768  y can be used wh
│ │ │ │ -000063f0: 6572 6576 6572 2074 6865 2066 756c 6c20  erever the full 
│ │ │ │ -00006400: 656e 6372 7970 7469 6f6e 206e 616d 6573  encryption names
│ │ │ │ -00006410: 2061 7265 2075 7365 642e 0a0a e280 9861   are used......a
│ │ │ │ -00006420: 7263 666f 7572 e280 990a 0a20 2020 2020  rcfour.....     
│ │ │ │ -00006430: 416c 6961 7320 666f 7220 e280 9861 7263  Alias for ...arc
│ │ │ │ -00006440: 666f 7572 2d68 6d61 63e2 8099 2e0a 0ae2  four-hmac.......
│ │ │ │ -00006450: 8098 6465 732d 6372 63e2 8099 0a0a 2020  ..des-crc.....  
│ │ │ │ -00006460: 2020 2041 6c69 6173 2066 6f72 20e2 8098     Alias for ...
│ │ │ │ -00006470: 6465 732d 6362 632d 6372 63e2 8099 2e0a  des-cbc-crc.....
│ │ │ │ -00006480: 0ae2 8098 6465 732d 6d64 34e2 8099 0a0a  ....des-md4.....
│ │ │ │ -00006490: 2020 2020 2041 6c69 6173 2066 6f72 20e2       Alias for .
│ │ │ │ -000064a0: 8098 6465 732d 6362 632d 6d64 34e2 8099  ..des-cbc-md4...
│ │ │ │ -000064b0: 2e0a 0ae2 8098 6465 732d 6d64 35e2 8099  ......des-md5...
│ │ │ │ -000064c0: 0ae2 8098 6465 73e2 8099 0a0a 2020 2020  ....des.....    
│ │ │ │ -000064d0: 2041 6c69 6173 2066 6f72 20e2 8098 6465   Alias for ...de
│ │ │ │ -000064e0: 732d 6362 632d 6d64 35e2 8099 2e0a 0ae2  s-cbc-md5.......
│ │ │ │ -000064f0: 8098 6465 7333 e280 990a e280 9833 6465  ..des3.......3de
│ │ │ │ -00006500: 73e2 8099 0a0a 2020 2020 2041 6c69 6173  s.....     Alias
│ │ │ │ -00006510: 2066 6f72 20e2 8098 6465 7333 2d63 6263   for ...des3-cbc
│ │ │ │ -00006520: 2d73 6861 312d 6b64 e280 992e 0a0a e280  -sha1-kd........
│ │ │ │ -00006530: 9861 6573 3132 38e2 8099 0a0a 2020 2020  .aes128.....    
│ │ │ │ -00006540: 2041 6c69 6173 2066 6f72 20e2 8098 6165   Alias for ...ae
│ │ │ │ -00006550: 7331 3238 2d63 7473 2d68 6d61 632d 7368  s128-cts-hmac-sh
│ │ │ │ -00006560: 6131 2d39 36e2 8099 2e0a 0ae2 8098 6165  a1-96.........ae
│ │ │ │ -00006570: 73e2 8099 0ae2 8098 6165 7332 3536 e280  s.......aes256..
│ │ │ │ -00006580: 990a 0a20 2020 2020 416c 6961 7320 666f  ...     Alias fo
│ │ │ │ -00006590: 7220 e280 9861 6573 3235 362d 6374 732d  r ...aes256-cts-
│ │ │ │ -000065a0: 686d 6163 2d73 6861 312d 3936 e280 992e  hmac-sha1-96....
│ │ │ │ -000065b0: 0a0a 2020 202d 2d2d 2d2d 2d2d 2d2d 2d20  ..   ---------- 
│ │ │ │ -000065c0: 466f 6f74 6e6f 7465 7320 2d2d 2d2d 2d2d  Footnotes ------
│ │ │ │ -000065d0: 2d2d 2d2d 0a0a 2020 2028 3129 203c 6874  ----..   (1) <ht
│ │ │ │ -000065e0: 7470 3a2f 2f77 7777 2e72 6573 6561 7263  tp://www.researc
│ │ │ │ -000065f0: 682e 6174 742e 636f 6d2f 7e73 6d62 2f70  h.att.com/~smb/p
│ │ │ │ -00006600: 6170 6572 732f 6964 6573 2e70 6466 3e0a  apers/ides.pdf>.
│ │ │ │ -00006610: 0a20 2020 2832 2920 3c68 7474 703a 2f2f  .   (2) <http://
│ │ │ │ -00006620: 7777 772e 7273 6173 6563 7572 6974 792e  www.rsasecurity.
│ │ │ │ -00006630: 636f 6d2f 7273 616c 6162 732f 706b 6373  com/rsalabs/pkcs
│ │ │ │ -00006640: 2f70 6b63 732d 352f 3e0a 0a1f 0a46 696c  /pkcs-5/>....Fil
│ │ │ │ -00006650: 653a 2073 6869 7368 692e 696e 666f 2c20  e: shishi.info, 
│ │ │ │ -00006660: 204e 6f64 653a 2053 7570 706f 7274 6564   Node: Supported
│ │ │ │ -00006670: 2050 6c61 7466 6f72 6d73 2c20 204e 6578   Platforms,  Nex
│ │ │ │ -00006680: 743a 2047 6574 7469 6e67 2068 656c 702c  t: Getting help,
│ │ │ │ -00006690: 2020 5072 6576 3a20 4372 7970 746f 6772    Prev: Cryptogr
│ │ │ │ -000066a0: 6170 6869 6320 4f76 6572 7669 6577 2c20  aphic Overview, 
│ │ │ │ -000066b0: 2055 703a 2049 6e74 726f 6475 6374 696f   Up: Introductio
│ │ │ │ -000066c0: 6e0a 0a31 2e35 2053 7570 706f 7274 6564  n..1.5 Supported
│ │ │ │ -000066d0: 2050 6c61 7466 6f72 6d73 0a3d 3d3d 3d3d   Platforms.=====
│ │ │ │ +00003c90: 3d3d 0a0a 5368 6973 6869 2069 6d70 6c65  ==..Shishi imple
│ │ │ │ +00003ca0: 6d65 6e74 7320 7365 7665 7261 6c20 6f66  ments several of
│ │ │ │ +00003cb0: 2074 6865 2073 7461 6e64 6172 6420 6372   the standard cr
│ │ │ │ +00003cc0: 7970 746f 6772 6170 6869 6320 7072 696d  yptographic prim
│ │ │ │ +00003cd0: 6974 6976 6573 2e20 2049 6e0a 7468 6973  itives.  In.this
│ │ │ │ +00003ce0: 2073 6563 7469 6f6e 2077 6520 6769 7665   section we give
│ │ │ │ +00003cf0: 2074 6865 206e 616d 6573 206f 6620 7468   the names of th
│ │ │ │ +00003d00: 6520 7375 7070 6f72 7465 6420 656e 6372  e supported encr
│ │ │ │ +00003d10: 7970 7469 6f6e 2073 7569 7465 732c 2061  yption suites, a
│ │ │ │ +00003d20: 6e64 0a73 6f6d 6520 6e6f 7465 7320 6162  nd.some notes ab
│ │ │ │ +00003d30: 6f75 7420 7468 656d 2c20 616e 6420 7468  out them, and th
│ │ │ │ +00003d40: 6569 7220 6173 736f 6369 6174 6564 2063  eir associated c
│ │ │ │ +00003d50: 6865 636b 7375 6d20 7375 6974 652e 0a0a  hecksum suite...
│ │ │ │ +00003d60: 2020 2053 7461 7465 6d65 6e74 7320 7375     Statements su
│ │ │ │ +00003d70: 6368 2061 7320 2269 7420 6973 2077 6561  ch as "it is wea
│ │ │ │ +00003d80: 6b22 2073 686f 756c 6420 6265 2072 6561  k" should be rea
│ │ │ │ +00003d90: 6420 6173 206d 6561 6e69 6e67 2074 6861  d as meaning tha
│ │ │ │ +00003da0: 7420 7468 6572 650a 6973 206e 6f20 6372  t there.is no cr
│ │ │ │ +00003db0: 6564 6962 6c65 2073 6563 7572 6974 7920  edible security 
│ │ │ │ +00003dc0: 616e 616c 7973 6973 206f 6620 7468 6520  analysis of the 
│ │ │ │ +00003dd0: 6d65 6368 616e 6973 6d20 6176 6169 6c61  mechanism availa
│ │ │ │ +00003de0: 626c 652c 2061 6e64 2f6f 7220 7468 6174  ble, and/or that
│ │ │ │ +00003df0: 0a73 686f 756c 6420 616e 2061 7474 6163  .should an attac
│ │ │ │ +00003e00: 6b20 6265 2070 7562 6c69 7368 6564 2070  k be published p
│ │ │ │ +00003e10: 7562 6c69 636c 792c 2066 6577 2070 656f  ublicly, few peo
│ │ │ │ +00003e20: 706c 6520 776f 756c 6420 6c69 6b65 6c79  ple would likely
│ │ │ │ +00003e30: 2062 650a 7375 7270 7269 7365 642e 2020   be.surprised.  
│ │ │ │ +00003e40: 416c 736f 206b 6565 7020 696e 206d 696e  Also keep in min
│ │ │ │ +00003e50: 6420 7468 6174 2074 6865 206b 6579 2073  d that the key s
│ │ │ │ +00003e60: 697a 6520 6d65 6e74 696f 6e65 6420 6973  ize mentioned is
│ │ │ │ +00003e70: 2074 6865 2061 6374 7561 6c0a 6b65 7920   the actual.key 
│ │ │ │ +00003e80: 7369 7a65 2c20 6e6f 7420 7468 6520 6566  size, not the ef
│ │ │ │ +00003e90: 6665 6374 6976 6520 6b65 7920 7370 6163  fective key spac
│ │ │ │ +00003ea0: 6520 6173 2066 6172 2061 7320 6120 6272  e as far as a br
│ │ │ │ +00003eb0: 7574 6520 666f 7263 6520 6174 7461 636b  ute force attack
│ │ │ │ +00003ec0: 2069 730a 636f 6e63 6572 6e65 642e 0a0a   is.concerned...
│ │ │ │ +00003ed0: 2020 2041 7320 796f 7520 6d61 7920 696e     As you may in
│ │ │ │ +00003ee0: 6665 7220 6672 6f6d 2074 6865 2064 6573  fer from the des
│ │ │ │ +00003ef0: 6372 6970 7469 6f6e 732c 2074 6865 7265  criptions, there
│ │ │ │ +00003f00: 2069 7320 6375 7272 656e 746c 7920 6e6f   is currently no
│ │ │ │ +00003f10: 0a65 6e63 7279 7074 696f 6e20 616c 676f  .encryption algo
│ │ │ │ +00003f20: 7269 7468 6d20 616e 6420 6f6e 6c79 206f  rithm and only o
│ │ │ │ +00003f30: 6e65 2063 6865 636b 7375 6d20 616c 676f  ne checksum algo
│ │ │ │ +00003f40: 7269 7468 6d20 7468 6174 2069 6e73 7069  rithm that inspi
│ │ │ │ +00003f50: 7265 2067 7265 6174 0a63 6f6e 6669 6465  re great.confide
│ │ │ │ +00003f60: 6e63 6520 696e 2069 7473 2064 6573 6967  nce in its desig
│ │ │ │ +00003f70: 6e2e 2020 486f 7065 6675 6c6c 7920 7468  n.  Hopefully th
│ │ │ │ +00003f80: 6973 2077 696c 6c20 6368 616e 6765 206f  is will change o
│ │ │ │ +00003f90: 7665 7220 7469 6d65 2e0a 0ae2 8098 4e55  ver time......NU
│ │ │ │ +00003fa0: 4c4c e280 990a 0a20 2020 2020 e280 984e  LL.....     ...N
│ │ │ │ +00003fb0: 554c 4ce2 8099 2069 7320 6120 6475 6d6d  ULL... is a dumm
│ │ │ │ +00003fc0: 7920 656e 6372 7970 7469 6f6e 2073 7569  y encryption sui
│ │ │ │ +00003fd0: 7465 2066 6f72 2064 6562 7567 6769 6e67  te for debugging
│ │ │ │ +00003fe0: 2e20 2045 6e63 7279 7074 696f 6e20 616e  .  Encryption an
│ │ │ │ +00003ff0: 640a 2020 2020 2064 6563 7279 7074 696f  d.     decryptio
│ │ │ │ +00004000: 6e20 6172 6520 6964 656e 7469 7479 2066  n are identity f
│ │ │ │ +00004010: 756e 6374 696f 6e73 2e20 204e 6f20 696e  unctions.  No in
│ │ │ │ +00004020: 7465 6772 6974 7920 7072 6f74 6563 7469  tegrity protecti
│ │ │ │ +00004030: 6f6e 2e20 2049 7420 6973 0a20 2020 2020  on.  It is.     
│ │ │ │ +00004040: 7765 616b 2e20 2049 7420 6973 2061 7373  weak.  It is ass
│ │ │ │ +00004050: 6f63 6961 7465 6420 7769 7468 2074 6865  ociated with the
│ │ │ │ +00004060: 20e2 8098 4e55 4c4c e280 9920 6368 6563   ...NULL... chec
│ │ │ │ +00004070: 6b73 756d 2e0a 0ae2 8098 6172 6366 6f75  ksum......arcfou
│ │ │ │ +00004080: 722d 686d 6163 e280 990a e280 9861 7263  r-hmac.......arc
│ │ │ │ +00004090: 666f 7572 2d68 6d61 632d 6578 70e2 8099  four-hmac-exp...
│ │ │ │ +000040a0: 0a0a 2020 2020 20e2 8098 6172 6366 6f75  ..     ...arcfou
│ │ │ │ +000040b0: 722d 686d 6163 2d2a e280 9920 6172 6520  r-hmac-*... are 
│ │ │ │ +000040c0: 6120 7072 6f70 7269 6574 6172 7920 7374  a proprietary st
│ │ │ │ +000040d0: 7265 616d 2063 6970 6865 7220 7769 7468  ream cipher with
│ │ │ │ +000040e0: 2035 3620 6269 740a 2020 2020 2028 e280   56 bit.     (..
│ │ │ │ +000040f0: 9861 7263 666f 7572 2d68 6d61 632d 6578  .arcfour-hmac-ex
│ │ │ │ +00004100: 70e2 8099 2920 6f72 2031 3238 2062 6974  p...) or 128 bit
│ │ │ │ +00004110: 2028 e280 9861 7263 666f 7572 2d68 6d61   (...arcfour-hma
│ │ │ │ +00004120: 63e2 8099 2920 6b65 7973 2c20 7573 6564  c...) keys, used
│ │ │ │ +00004130: 2069 6e20 610a 2020 2020 2070 726f 7072   in a.     propr
│ │ │ │ +00004140: 6965 7461 7279 2077 6179 2064 6573 6372  ietary way descr
│ │ │ │ +00004150: 6962 6564 2069 6e20 616e 2065 7870 6972  ibed in an expir
│ │ │ │ +00004160: 6564 2049 4554 4620 6472 6166 740a 2020  ed IETF draft.  
│ │ │ │ +00004170: 2020 20e2 8098 6472 6166 742d 6272 657a     ...draft-brez
│ │ │ │ +00004180: 616b 2d77 696e 326b 2d6b 7262 2d72 6334  ak-win2k-krb-rc4
│ │ │ │ +00004190: 2d68 6d61 632d 3034 2e74 7874 e280 992e  -hmac-04.txt....
│ │ │ │ +000041a0: 2020 4465 7269 7669 6e67 206b 6579 7320    Deriving keys 
│ │ │ │ +000041b0: 6672 6f6d 0a20 2020 2020 7061 7373 776f  from.     passwo
│ │ │ │ +000041c0: 7264 7320 6973 2073 7570 706f 7274 6564  rds is supported
│ │ │ │ +000041d0: 2c20 616e 6420 6973 2064 6f6e 6520 6279  , and is done by
│ │ │ │ +000041e0: 2063 6f6d 7075 7469 6e67 2061 206d 6573   computing a mes
│ │ │ │ +000041f0: 7361 6765 2064 6967 6573 740a 2020 2020  sage digest.    
│ │ │ │ +00004200: 2028 4d44 3429 206f 6620 6120 3136 2d62   (MD4) of a 16-b
│ │ │ │ +00004210: 6974 2055 6e69 636f 6465 2072 6570 7265  it Unicode repre
│ │ │ │ +00004220: 7365 6e74 6174 696f 6e20 6f66 2074 6865  sentation of the
│ │ │ │ +00004230: 2041 5343 4949 2070 6173 7377 6f72 642c   ASCII password,
│ │ │ │ +00004240: 0a20 2020 2020 7769 7468 206e 6f20 7361  .     with no sa
│ │ │ │ +00004250: 6c74 2e20 2044 6174 6120 6973 2069 6e74  lt.  Data is int
│ │ │ │ +00004260: 6567 7269 7479 2070 726f 7465 6374 6564  egrity protected
│ │ │ │ +00004270: 2077 6974 6820 6120 6b65 7965 6420 6861   with a keyed ha
│ │ │ │ +00004280: 7368 0a20 2020 2020 2848 4d41 432d 4d44  sh.     (HMAC-MD
│ │ │ │ +00004290: 3529 2c20 7768 6572 6520 7468 6520 6b65  5), where the ke
│ │ │ │ +000042a0: 7920 6973 2064 6572 6976 6564 2066 726f  y is derived fro
│ │ │ │ +000042b0: 6d20 7468 6520 6261 7365 206b 6579 2069  m the base key i
│ │ │ │ +000042c0: 6e20 610a 2020 2020 2063 7265 6174 6976  n a.     creativ
│ │ │ │ +000042d0: 6520 7761 792e 2020 4974 2069 7320 7765  e way.  It is we
│ │ │ │ +000042e0: 616b 2e20 2049 7420 6973 2061 7373 6f63  ak.  It is assoc
│ │ │ │ +000042f0: 6961 7465 6420 7769 7468 2074 6865 0a20  iated with the. 
│ │ │ │ +00004300: 2020 2020 e280 9861 7263 666f 7572 2d68      ...arcfour-h
│ │ │ │ +00004310: 6d61 632d 6d64 35e2 8099 2063 6865 636b  mac-md5... check
│ │ │ │ +00004320: 7375 6d2e 0a0a e280 9864 6573 2d63 6263  sum......des-cbc
│ │ │ │ +00004330: 2d6e 6f6e 65e2 8099 0a0a 2020 2020 20e2  -none.....     .
│ │ │ │ +00004340: 8098 6465 732d 6362 632d 6e6f 6e65 e280  ..des-cbc-none..
│ │ │ │ +00004350: 9920 6973 2044 4553 2065 6e63 7279 7074  . is DES encrypt
│ │ │ │ +00004360: 696f 6e20 616e 6420 6465 6372 7970 7469  ion and decrypti
│ │ │ │ +00004370: 6f6e 2077 6974 6820 3536 2062 6974 206b  on with 56 bit k
│ │ │ │ +00004380: 6579 730a 2020 2020 2061 6e64 2038 2062  eys.     and 8 b
│ │ │ │ +00004390: 7974 6520 626c 6f63 6b73 2069 6e20 4342  yte blocks in CB
│ │ │ │ +000043a0: 4320 6d6f 6465 2c20 7573 696e 6720 6120  C mode, using a 
│ │ │ │ +000043b0: 7a65 726f 2049 562e 2054 6865 206b 6579  zero IV. The key
│ │ │ │ +000043c0: 7320 6361 6e20 6265 0a20 2020 2020 6465  s can be.     de
│ │ │ │ +000043d0: 7269 7665 6420 6672 6f6d 2070 6173 7377  rived from passw
│ │ │ │ +000043e0: 6f72 6473 2062 7920 616e 206f 6273 6375  ords by an obscu
│ │ │ │ +000043f0: 7265 2061 7070 6c69 6361 7469 6f6e 2073  re application s
│ │ │ │ +00004400: 7065 6369 6669 630a 2020 2020 2061 6c67  pecific.     alg
│ │ │ │ +00004410: 6f72 6974 686d 2e20 2049 7420 6973 2077  orithm.  It is w
│ │ │ │ +00004420: 6561 6b2c 2062 6563 6175 7365 2069 7420  eak, because it 
│ │ │ │ +00004430: 6f66 6665 7273 206e 6f20 696e 7465 6772  offers no integr
│ │ │ │ +00004440: 6974 7920 7072 6f74 6563 7469 6f6e 2e0a  ity protection..
│ │ │ │ +00004450: 2020 2020 2054 6869 7320 6973 2074 7970       This is typ
│ │ │ │ +00004460: 6963 616c 6c79 206f 6e6c 7920 7573 6564  ically only used
│ │ │ │ +00004470: 2062 7920 5246 4320 3139 3634 2047 5353   by RFC 1964 GSS
│ │ │ │ +00004480: 2d41 5049 2069 6d70 6c65 6d65 6e74 6174  -API implementat
│ │ │ │ +00004490: 696f 6e73 0a20 2020 2020 2877 6869 6368  ions.     (which
│ │ │ │ +000044a0: 2074 7279 2074 6f20 7072 6f74 6563 7420   try to protect 
│ │ │ │ +000044b0: 696e 7465 6772 6974 7920 7573 696e 6720  integrity using 
│ │ │ │ +000044c0: 616e 2061 642d 686f 6320 736f 6c75 7469  an ad-hoc soluti
│ │ │ │ +000044d0: 6f6e 292e 2020 4974 2069 730a 2020 2020  on).  It is.    
│ │ │ │ +000044e0: 2061 7373 6f63 6961 7465 6420 7769 7468   associated with
│ │ │ │ +000044f0: 2074 6865 20e2 8098 4e55 4c4c e280 9920   the ...NULL... 
│ │ │ │ +00004500: 6368 6563 6b73 756d 2e0a 0ae2 8098 6465  checksum......de
│ │ │ │ +00004510: 732d 6362 632d 6372 63e2 8099 0a0a 2020  s-cbc-crc.....  
│ │ │ │ +00004520: 2020 20e2 8098 6465 732d 6362 632d 6372     ...des-cbc-cr
│ │ │ │ +00004530: 63e2 8099 2069 7320 4445 5320 656e 6372  c... is DES encr
│ │ │ │ +00004540: 7970 7469 6f6e 2061 6e64 2064 6563 7279  yption and decry
│ │ │ │ +00004550: 7074 696f 6e20 7769 7468 2035 3620 6269  ption with 56 bi
│ │ │ │ +00004560: 7420 6b65 7973 2061 6e64 0a20 2020 2020  t keys and.     
│ │ │ │ +00004570: 3820 6279 7465 2062 6c6f 636b 7320 696e  8 byte blocks in
│ │ │ │ +00004580: 2043 4243 206d 6f64 652c 2075 7369 6e67   CBC mode, using
│ │ │ │ +00004590: 2074 6865 206b 6579 2061 7320 4956 2028   the key as IV (
│ │ │ │ +000045a0: 2a6e 6f74 6520 4b65 7920 6173 0a20 2020  *note Key as.   
│ │ │ │ +000045b0: 2020 696e 6974 6961 6c69 7a61 7469 6f6e    initialization
│ │ │ │ +000045c0: 2076 6563 746f 723a 3a29 2e20 2054 6865   vector::).  The
│ │ │ │ +000045d0: 206b 6579 7320 6361 6e20 6265 2064 6572   keys can be der
│ │ │ │ +000045e0: 6976 6564 2066 726f 6d20 7061 7373 776f  ived from passwo
│ │ │ │ +000045f0: 7264 730a 2020 2020 2062 7920 616e 206f  rds.     by an o
│ │ │ │ +00004600: 6273 6375 7265 2061 7070 6c69 6361 7469  bscure applicati
│ │ │ │ +00004610: 6f6e 2073 7065 6369 6669 6320 616c 676f  on specific algo
│ │ │ │ +00004620: 7269 7468 6d2e 2020 4461 7461 2069 7320  rithm.  Data is 
│ │ │ │ +00004630: 696e 7465 6772 6974 790a 2020 2020 2070  integrity.     p
│ │ │ │ +00004640: 726f 7465 6374 6564 2077 6974 6820 616e  rotected with an
│ │ │ │ +00004650: 2075 6e6b 6579 6564 2062 7574 2065 6e63   unkeyed but enc
│ │ │ │ +00004660: 7279 7074 6564 20e2 8098 4352 4333 32e2  rypted ...CRC32.
│ │ │ │ +00004670: 8099 2d6c 696b 6520 6368 6563 6b73 756d  ..-like checksum
│ │ │ │ +00004680: 2e20 2049 740a 2020 2020 2069 7320 7765  .  It.     is we
│ │ │ │ +00004690: 616b 2e20 2049 7420 6973 2061 7373 6f63  ak.  It is assoc
│ │ │ │ +000046a0: 6961 7465 6420 7769 7468 2074 6865 20e2  iated with the .
│ │ │ │ +000046b0: 8098 7273 612d 6d64 352d 6465 73e2 8099  ..rsa-md5-des...
│ │ │ │ +000046c0: 2063 6865 636b 7375 6d2e 0a0a e280 9864   checksum......d
│ │ │ │ +000046d0: 6573 2d63 6263 2d6d 6434 e280 990a 0a20  es-cbc-md4..... 
│ │ │ │ +000046e0: 2020 2020 e280 9864 6573 2d63 6263 2d6d      ...des-cbc-m
│ │ │ │ +000046f0: 6434 e280 9920 6973 2044 4553 2065 6e63  d4... is DES enc
│ │ │ │ +00004700: 7279 7074 696f 6e20 616e 6420 6465 6372  ryption and decr
│ │ │ │ +00004710: 7970 7469 6f6e 2077 6974 6820 3536 2062  yption with 56 b
│ │ │ │ +00004720: 6974 206b 6579 7320 616e 640a 2020 2020  it keys and.    
│ │ │ │ +00004730: 2038 2062 7974 6520 626c 6f63 6b73 2069   8 byte blocks i
│ │ │ │ +00004740: 6e20 4342 4320 6d6f 6465 2c20 7573 696e  n CBC mode, usin
│ │ │ │ +00004750: 6720 6120 7a65 726f 2049 562e 2054 6865  g a zero IV. The
│ │ │ │ +00004760: 206b 6579 7320 6361 6e20 6265 2064 6572   keys can be der
│ │ │ │ +00004770: 6976 6564 0a20 2020 2020 6672 6f6d 2070  ived.     from p
│ │ │ │ +00004780: 6173 7377 6f72 6473 2062 7920 616e 206f  asswords by an o
│ │ │ │ +00004790: 6273 6375 7265 2061 7070 6c69 6361 7469  bscure applicati
│ │ │ │ +000047a0: 6f6e 2073 7065 6369 6669 6320 616c 676f  on specific algo
│ │ │ │ +000047b0: 7269 7468 6d2e 2020 4461 7461 0a20 2020  rithm.  Data.   
│ │ │ │ +000047c0: 2020 6973 2069 6e74 6567 7269 7479 2070    is integrity p
│ │ │ │ +000047d0: 726f 7465 6374 6564 2077 6974 6820 616e  rotected with an
│ │ │ │ +000047e0: 2075 6e6b 6579 6564 2062 7574 2065 6e63   unkeyed but enc
│ │ │ │ +000047f0: 7279 7074 6564 204d 4434 2068 6173 682e  rypted MD4 hash.
│ │ │ │ +00004800: 2020 4974 0a20 2020 2020 6973 2077 6561    It.     is wea
│ │ │ │ +00004810: 6b2e 2020 4974 2069 7320 6173 736f 6369  k.  It is associ
│ │ │ │ +00004820: 6174 6564 2077 6974 6820 7468 6520 e280  ated with the ..
│ │ │ │ +00004830: 9872 7361 2d6d 6434 2d64 6573 e280 9920  .rsa-md4-des... 
│ │ │ │ +00004840: 6368 6563 6b73 756d 2e0a 0ae2 8098 6465  checksum......de
│ │ │ │ +00004850: 732d 6362 632d 6d64 35e2 8099 0a0a 2020  s-cbc-md5.....  
│ │ │ │ +00004860: 2020 20e2 8098 6465 732d 6362 632d 6d64     ...des-cbc-md
│ │ │ │ +00004870: 35e2 8099 2069 7320 4445 5320 656e 6372  5... is DES encr
│ │ │ │ +00004880: 7970 7469 6f6e 2061 6e64 2064 6563 7279  yption and decry
│ │ │ │ +00004890: 7074 696f 6e20 7769 7468 2035 3620 6269  ption with 56 bi
│ │ │ │ +000048a0: 7420 6b65 7973 2061 6e64 0a20 2020 2020  t keys and.     
│ │ │ │ +000048b0: 3820 6279 7465 2062 6c6f 636b 7320 696e  8 byte blocks in
│ │ │ │ +000048c0: 2043 4243 206d 6f64 652c 2075 7369 6e67   CBC mode, using
│ │ │ │ +000048d0: 2061 207a 6572 6f20 4956 2e20 5468 6520   a zero IV. The 
│ │ │ │ +000048e0: 6b65 7973 2063 616e 2062 6520 6465 7269  keys can be deri
│ │ │ │ +000048f0: 7665 640a 2020 2020 2066 726f 6d20 7061  ved.     from pa
│ │ │ │ +00004900: 7373 776f 7264 7320 6279 2061 6e20 6f62  sswords by an ob
│ │ │ │ +00004910: 7363 7572 6520 6170 706c 6963 6174 696f  scure applicatio
│ │ │ │ +00004920: 6e20 7370 6563 6966 6963 2061 6c67 6f72  n specific algor
│ │ │ │ +00004930: 6974 686d 2e20 2044 6174 610a 2020 2020  ithm.  Data.    
│ │ │ │ +00004940: 2069 7320 696e 7465 6772 6974 7920 7072   is integrity pr
│ │ │ │ +00004950: 6f74 6563 7465 6420 7769 7468 2061 6e20  otected with an 
│ │ │ │ +00004960: 756e 6b65 7965 6420 6275 7420 656e 6372  unkeyed but encr
│ │ │ │ +00004970: 7970 7465 6420 4d44 3520 6861 7368 2e20  ypted MD5 hash. 
│ │ │ │ +00004980: 2049 740a 2020 2020 2069 7320 7765 616b   It.     is weak
│ │ │ │ +00004990: 2e20 2049 7420 6973 2061 7373 6f63 6961  .  It is associa
│ │ │ │ +000049a0: 7465 6420 7769 7468 2074 6865 20e2 8098  ted with the ...
│ │ │ │ +000049b0: 7273 612d 6d64 352d 6465 73e2 8099 2063  rsa-md5-des... c
│ │ │ │ +000049c0: 6865 636b 7375 6d2e 2020 5468 6973 0a20  hecksum.  This. 
│ │ │ │ +000049d0: 2020 2020 6973 2074 6865 2073 7472 6f6e      is the stron
│ │ │ │ +000049e0: 6765 7374 2052 4643 2031 3531 3020 696e  gest RFC 1510 in
│ │ │ │ +000049f0: 7465 726f 7065 7261 626c 6520 656e 6372  teroperable encr
│ │ │ │ +00004a00: 7970 7469 6f6e 206d 6563 6861 6e69 736d  yption mechanism
│ │ │ │ +00004a10: 2e0a 0ae2 8098 6465 7333 2d63 6263 2d6e  ......des3-cbc-n
│ │ │ │ +00004a20: 6f6e 65e2 8099 0a0a 2020 2020 20e2 8098  one.....     ...
│ │ │ │ +00004a30: 6465 7333 2d63 6263 2d6e 6f6e 65e2 8099  des3-cbc-none...
│ │ │ │ +00004a40: 2069 7320 4445 5320 656e 6372 7970 7469   is DES encrypti
│ │ │ │ +00004a50: 6f6e 2061 6e64 2064 6563 7279 7074 696f  on and decryptio
│ │ │ │ +00004a60: 6e20 7769 7468 2074 6872 6565 2035 3620  n with three 56 
│ │ │ │ +00004a70: 6269 740a 2020 2020 206b 6579 7320 2865  bit.     keys (e
│ │ │ │ +00004a80: 6666 6563 7469 7665 206b 6579 2073 697a  ffective key siz
│ │ │ │ +00004a90: 6520 3131 3220 6269 7473 2920 616e 6420  e 112 bits) and 
│ │ │ │ +00004aa0: 3820 6279 7465 2062 6c6f 636b 7320 696e  8 byte blocks in
│ │ │ │ +00004ab0: 2043 4243 206d 6f64 652e 0a20 2020 2020   CBC mode..     
│ │ │ │ +00004ac0: 5468 6520 6b65 7973 2063 616e 2062 6520  The keys can be 
│ │ │ │ +00004ad0: 6465 7269 7665 6420 6672 6f6d 2070 6173  derived from pas
│ │ │ │ +00004ae0: 7377 6f72 6473 2062 7920 7468 6520 7361  swords by the sa
│ │ │ │ +00004af0: 6d65 2061 6c67 6f72 6974 686d 2061 730a  me algorithm as.
│ │ │ │ +00004b00: 2020 2020 20e2 8098 6465 7333 2d63 6263       ...des3-cbc
│ │ │ │ +00004b10: 2d73 6861 312d 6b64 e280 992e 2020 4974  -sha1-kd....  It
│ │ │ │ +00004b20: 2069 7320 7765 616b 2c20 6265 6361 7573   is weak, becaus
│ │ │ │ +00004b30: 6520 6974 206f 6666 6572 7320 6e6f 2069  e it offers no i
│ │ │ │ +00004b40: 6e74 6567 7269 7479 0a20 2020 2020 7072  ntegrity.     pr
│ │ │ │ +00004b50: 6f74 6563 7469 6f6e 2e20 2054 6869 7320  otection.  This 
│ │ │ │ +00004b60: 6973 2074 7970 6963 616c 6c79 206f 6e6c  is typically onl
│ │ │ │ +00004b70: 7920 7573 6564 2062 7920 4753 532d 4150  y used by GSS-AP
│ │ │ │ +00004b80: 4920 696d 706c 656d 656e 7461 7469 6f6e  I implementation
│ │ │ │ +00004b90: 730a 2020 2020 2028 7768 6963 6820 7472  s.     (which tr
│ │ │ │ +00004ba0: 7920 746f 2070 726f 7465 6374 2069 6e74  y to protect int
│ │ │ │ +00004bb0: 6567 7269 7479 2075 7369 6e67 2061 6e20  egrity using an 
│ │ │ │ +00004bc0: 6164 2d68 6f63 2073 6f6c 7574 696f 6e29  ad-hoc solution)
│ │ │ │ +00004bd0: 2066 6f72 0a20 2020 2020 696e 7465 726f   for.     intero
│ │ │ │ +00004be0: 7065 7261 6269 6c69 7479 2077 6974 6820  perability with 
│ │ │ │ +00004bf0: 736f 6d65 2065 7869 7374 696e 6720 4b65  some existing Ke
│ │ │ │ +00004c00: 7262 6572 6f73 2047 5353 2069 6d70 6c65  rberos GSS imple
│ │ │ │ +00004c10: 6d65 6e74 6174 696f 6e73 2e0a 2020 2020  mentations..    
│ │ │ │ +00004c20: 2049 7420 6973 2061 7373 6f63 6961 7465   It is associate
│ │ │ │ +00004c30: 6420 7769 7468 2074 6865 20e2 8098 4e55  d with the ...NU
│ │ │ │ +00004c40: 4c4c e280 9920 6368 6563 6b73 756d 2e0a  LL... checksum..
│ │ │ │ +00004c50: 0ae2 8098 6465 7333 2d63 6263 2d73 6861  ....des3-cbc-sha
│ │ │ │ +00004c60: 312d 6b64 e280 990a 0a20 2020 2020 e280  1-kd.....     ..
│ │ │ │ +00004c70: 9864 6573 332d 6362 632d 7368 6131 2d6b  .des3-cbc-sha1-k
│ │ │ │ +00004c80: 64e2 8099 2069 7320 4445 5320 656e 6372  d... is DES encr
│ │ │ │ +00004c90: 7970 7469 6f6e 2061 6e64 2064 6563 7279  yption and decry
│ │ │ │ +00004ca0: 7074 696f 6e20 7769 7468 2074 6872 6565  ption with three
│ │ │ │ +00004cb0: 2035 360a 2020 2020 2062 6974 206b 6579   56.     bit key
│ │ │ │ +00004cc0: 7320 2865 6666 6563 7469 7665 206b 6579  s (effective key
│ │ │ │ +00004cd0: 2073 697a 6520 3131 3220 6269 7473 2920   size 112 bits) 
│ │ │ │ +00004ce0: 616e 6420 3820 6279 7465 2062 6c6f 636b  and 8 byte block
│ │ │ │ +00004cf0: 7320 696e 2043 4243 0a20 2020 2020 6d6f  s in CBC.     mo
│ │ │ │ +00004d00: 6465 2e20 2054 6865 206b 6579 7320 6361  de.  The keys ca
│ │ │ │ +00004d10: 6e20 6265 2064 6572 6976 6564 2066 726f  n be derived fro
│ │ │ │ +00004d20: 6d20 7061 7373 776f 7264 7320 6279 2061  m passwords by a
│ │ │ │ +00004d30: 2061 6c67 6f72 6974 686d 2062 6173 6564   algorithm based
│ │ │ │ +00004d40: 0a20 2020 2020 6f6e 2074 6865 2070 6170  .     on the pap
│ │ │ │ +00004d50: 6572 2022 4120 4265 7474 6572 204b 6579  er "A Better Key
│ │ │ │ +00004d60: 2053 6368 6564 756c 6520 466f 7220 4445   Schedule For DE
│ │ │ │ +00004d70: 532d 6c69 6b65 2043 6970 6865 7273 2220  S-like Ciphers" 
│ │ │ │ +00004d80: 2831 2920 6279 0a20 2020 2020 5572 6920  (1) by.     Uri 
│ │ │ │ +00004d90: 426c 756d 656e 7468 616c 2061 6e64 2053  Blumenthal and S
│ │ │ │ +00004da0: 7465 7665 6e20 4d2e 2042 656c 6c6f 7669  teven M. Bellovi
│ │ │ │ +00004db0: 6e20 2869 7420 6973 206e 6f74 2063 6c65  n (it is not cle
│ │ │ │ +00004dc0: 6172 2069 6620 7468 650a 2020 2020 2061  ar if the.     a
│ │ │ │ +00004dd0: 6c67 6f72 6974 686d 2c20 616e 6420 7468  lgorithm, and th
│ │ │ │ +00004de0: 6520 7761 7920 6974 2069 7320 7573 6564  e way it is used
│ │ │ │ +00004df0: 2c20 6973 2075 7365 6420 6279 2061 6e79  , is used by any
│ │ │ │ +00004e00: 206f 7468 6572 2070 726f 746f 636f 6c73   other protocols
│ │ │ │ +00004e10: 2c0a 2020 2020 2061 6c74 686f 7567 6820  ,.     although 
│ │ │ │ +00004e20: 6974 2073 6565 6d73 2075 6e6c 696b 656c  it seems unlikel
│ │ │ │ +00004e30: 7929 2e20 2044 6174 6120 6973 2069 6e74  y).  Data is int
│ │ │ │ +00004e40: 6567 7269 7479 2070 726f 7465 6374 6564  egrity protected
│ │ │ │ +00004e50: 2077 6974 6820 610a 2020 2020 206b 6579   with a.     key
│ │ │ │ +00004e60: 6564 2053 4841 3120 6861 7368 2069 6e20  ed SHA1 hash in 
│ │ │ │ +00004e70: 484d 4143 206d 6f64 652e 2020 4974 2068  HMAC mode.  It h
│ │ │ │ +00004e80: 6173 206e 6f20 7365 6375 7269 7479 2070  as no security p
│ │ │ │ +00004e90: 726f 6f66 2c20 6275 7420 6973 0a20 2020  roof, but is.   
│ │ │ │ +00004ea0: 2020 6173 7375 6d65 6420 746f 2070 726f    assumed to pro
│ │ │ │ +00004eb0: 7669 6465 2061 6465 7175 6174 6520 7365  vide adequate se
│ │ │ │ +00004ec0: 6375 7269 7479 2069 6e20 7468 6520 7365  curity in the se
│ │ │ │ +00004ed0: 6e73 6520 7468 6174 206b 6e6f 776c 6564  nse that knowled
│ │ │ │ +00004ee0: 6765 206f 6e0a 2020 2020 2068 6f77 2074  ge on.     how t
│ │ │ │ +00004ef0: 6f20 6372 6163 6b20 6974 2069 7320 6e6f  o crack it is no
│ │ │ │ +00004f00: 7420 6b6e 6f77 6e20 746f 2074 6865 2070  t known to the p
│ │ │ │ +00004f10: 7562 6c69 632e 2020 4e6f 7465 2074 6861  ublic.  Note tha
│ │ │ │ +00004f20: 7420 7468 6520 6b65 790a 2020 2020 2064  t the key.     d
│ │ │ │ +00004f30: 6572 6976 6174 696f 6e20 6675 6e63 7469  erivation functi
│ │ │ │ +00004f40: 6f6e 2069 7320 6e6f 7420 7769 6465 6c79  on is not widely
│ │ │ │ +00004f50: 2075 7365 6420 6f75 7473 6964 6520 6f66   used outside of
│ │ │ │ +00004f60: 204b 6572 6265 726f 732c 2068 656e 6365   Kerberos, hence
│ │ │ │ +00004f70: 0a20 2020 2020 6e6f 7420 7769 6465 6c79  .     not widely
│ │ │ │ +00004f80: 2073 7475 6469 6564 2e20 2049 7420 6973   studied.  It is
│ │ │ │ +00004f90: 2061 7373 6f63 6961 7465 6420 7769 7468   associated with
│ │ │ │ +00004fa0: 2074 6865 20e2 8098 686d 6163 2d73 6861   the ...hmac-sha
│ │ │ │ +00004fb0: 312d 6465 7333 2d6b 64e2 8099 0a20 2020  1-des3-kd....   
│ │ │ │ +00004fc0: 2020 6368 6563 6b73 756d 2e0a 0ae2 8098    checksum......
│ │ │ │ +00004fd0: 6165 7331 3238 2d63 7473 2d68 6d61 632d  aes128-cts-hmac-
│ │ │ │ +00004fe0: 7368 6131 2d39 36e2 8099 0ae2 8098 6165  sha1-96.......ae
│ │ │ │ +00004ff0: 7332 3536 2d63 7473 2d68 6d61 632d 7368  s256-cts-hmac-sh
│ │ │ │ +00005000: 6131 2d39 36e2 8099 0a0a 2020 2020 20e2  a1-96.....     .
│ │ │ │ +00005010: 8098 6165 7331 3238 2d63 7473 2d68 6d61  ..aes128-cts-hma
│ │ │ │ +00005020: 632d 7368 6131 2d39 36e2 8099 2061 6e64  c-sha1-96... and
│ │ │ │ +00005030: 20e2 8098 6165 7332 3536 2d63 7473 2d68   ...aes256-cts-h
│ │ │ │ +00005040: 6d61 632d 7368 6131 2d39 36e2 8099 2069  mac-sha1-96... i
│ │ │ │ +00005050: 7320 4145 530a 2020 2020 2065 6e63 7279  s AES.     encry
│ │ │ │ +00005060: 7074 696f 6e20 616e 6420 6465 6372 7970  ption and decryp
│ │ │ │ +00005070: 7469 6f6e 2077 6974 6820 3132 3820 6269  tion with 128 bi
│ │ │ │ +00005080: 7420 616e 6420 3235 3620 6269 7420 6b65  t and 256 bit ke
│ │ │ │ +00005090: 792c 0a20 2020 2020 7265 7370 6563 7469  y,.     respecti
│ │ │ │ +000050a0: 7665 6c79 2c20 616e 6420 3136 2062 7974  vely, and 16 byt
│ │ │ │ +000050b0: 6520 626c 6f63 6b73 2069 6e20 4342 4320  e blocks in CBC 
│ │ │ │ +000050c0: 6d6f 6465 2077 6974 6820 4369 7068 6572  mode with Cipher
│ │ │ │ +000050d0: 2054 6578 740a 2020 2020 2053 7465 616c   Text.     Steal
│ │ │ │ +000050e0: 696e 672e 2020 4369 7068 6572 2054 6578  ing.  Cipher Tex
│ │ │ │ +000050f0: 7420 5374 6561 6c69 6e67 206d 6561 6e73  t Stealing means
│ │ │ │ +00005100: 2064 6174 6120 6c65 6e67 7468 206f 6620   data length of 
│ │ │ │ +00005110: 656e 6372 7970 7465 6420 6461 7461 0a20  encrypted data. 
│ │ │ │ +00005120: 2020 2020 6973 2070 7265 7365 7276 6564      is preserved
│ │ │ │ +00005130: 2028 7075 7265 2043 4243 2061 6464 2075   (pure CBC add u
│ │ │ │ +00005140: 7020 746f 2037 2070 6164 2063 6861 7261  p to 7 pad chara
│ │ │ │ +00005150: 6374 6572 7329 2e20 2054 6865 206b 6579  cters).  The key
│ │ │ │ +00005160: 7320 6361 6e0a 2020 2020 2062 6520 6465  s can.     be de
│ │ │ │ +00005170: 7269 7665 6420 6672 6f6d 2070 6173 7377  rived from passw
│ │ │ │ +00005180: 6f72 6473 2077 6974 6820 5253 4120 4c61  ords with RSA La
│ │ │ │ +00005190: 626f 7261 746f 7269 6573 2050 4b43 5323  boratories PKCS#
│ │ │ │ +000051a0: 3520 5061 7373 776f 7264 0a20 2020 2020  5 Password.     
│ │ │ │ +000051b0: 4261 7365 6420 4b65 7920 4465 7269 7661  Based Key Deriva
│ │ │ │ +000051c0: 7469 6f6e 2046 756e 6374 696f 6e20 3228  tion Function 2(
│ │ │ │ +000051d0: 3229 2c20 7768 6963 6820 6973 2061 6c6c  2), which is all
│ │ │ │ +000051e0: 6567 6564 6c79 2070 726f 7661 626c 790a  egedly provably.
│ │ │ │ +000051f0: 2020 2020 2073 6563 7572 6520 696e 2061       secure in a
│ │ │ │ +00005200: 2072 616e 646f 6d20 6f72 6163 6c65 206d   random oracle m
│ │ │ │ +00005210: 6f64 656c 2e20 2044 6174 6120 6973 2069  odel.  Data is i
│ │ │ │ +00005220: 6e74 6567 7269 7479 2070 726f 7465 6374  ntegrity protect
│ │ │ │ +00005230: 6564 2077 6974 680a 2020 2020 2061 206b  ed with.     a k
│ │ │ │ +00005240: 6579 6564 2053 4841 3120 6861 7368 2c20  eyed SHA1 hash, 
│ │ │ │ +00005250: 696e 2048 4d41 4320 6d6f 6465 2c20 7472  in HMAC mode, tr
│ │ │ │ +00005260: 756e 6361 7465 6420 746f 2039 3620 6269  uncated to 96 bi
│ │ │ │ +00005270: 7473 2e20 2054 6865 7265 2069 7320 6e6f  ts.  There is no
│ │ │ │ +00005280: 0a20 2020 2020 7365 6375 7269 7479 2070  .     security p
│ │ │ │ +00005290: 726f 6f66 2c20 6275 7420 7468 6520 7363  roof, but the sc
│ │ │ │ +000052a0: 6865 6d65 7320 6172 6520 6173 7375 6d65  hemes are assume
│ │ │ │ +000052b0: 6420 746f 2070 726f 7669 6465 2061 6465  d to provide ade
│ │ │ │ +000052c0: 7175 6174 650a 2020 2020 2073 6563 7572  quate.     secur
│ │ │ │ +000052d0: 6974 7920 696e 2074 6865 2073 656e 7365  ity in the sense
│ │ │ │ +000052e0: 2074 6861 7420 6b6e 6f77 6c65 6467 6520   that knowledge 
│ │ │ │ +000052f0: 6f6e 2068 6f77 2074 6f20 6372 6163 6b20  on how to crack 
│ │ │ │ +00005300: 7468 656d 2069 7320 6e6f 740a 2020 2020  them is not.    
│ │ │ │ +00005310: 206b 6e6f 776e 2074 6f20 7468 6520 7075   known to the pu
│ │ │ │ +00005320: 626c 6963 2e20 204e 6f74 6520 7468 6174  blic.  Note that
│ │ │ │ +00005330: 2041 4553 2068 6173 2079 6574 2074 6f20   AES has yet to 
│ │ │ │ +00005340: 7265 6365 6976 6520 7468 6520 7465 7374  receive the test
│ │ │ │ +00005350: 206f 660a 2020 2020 2074 696d 652c 2061   of.     time, a
│ │ │ │ +00005360: 6e64 2074 6865 2041 4553 2063 6970 6865  nd the AES ciphe
│ │ │ │ +00005370: 7220 656e 6372 7970 7469 6f6e 206d 6f64  r encryption mod
│ │ │ │ +00005380: 6520 2843 4243 2077 6974 6820 4369 7068  e (CBC with Ciph
│ │ │ │ +00005390: 6572 7465 7874 0a20 2020 2020 5374 6561  ertext.     Stea
│ │ │ │ +000053a0: 6c69 6e67 2c20 616e 6420 6120 6e6f 6e2d  ling, and a non-
│ │ │ │ +000053b0: 7374 616e 6461 7264 2049 5620 6f75 7470  standard IV outp
│ │ │ │ +000053c0: 7574 2920 6973 206e 6f74 2077 6964 656c  ut) is not widel
│ │ │ │ +000053d0: 7920 7374 616e 6461 7264 697a 6564 0a20  y standardized. 
│ │ │ │ +000053e0: 2020 2020 2868 656e 6365 206e 6f74 2077      (hence not w
│ │ │ │ +000053f0: 6964 656c 7920 7374 7564 6965 6429 2e20  idely studied). 
│ │ │ │ +00005400: 2049 7420 6973 2061 7373 6f63 6961 7465   It is associate
│ │ │ │ +00005410: 6420 7769 7468 2074 6865 0a20 2020 2020  d with the.     
│ │ │ │ +00005420: e280 9868 6d61 632d 7368 6131 2d39 362d  ...hmac-sha1-96-
│ │ │ │ +00005430: 6165 7331 3238 e280 9920 616e 6420 e280  aes128... and ..
│ │ │ │ +00005440: 9868 6d61 632d 7368 6131 2d39 362d 6165  .hmac-sha1-96-ae
│ │ │ │ +00005450: 7332 3536 e280 9920 6368 6563 6b73 756d  s256... checksum
│ │ │ │ +00005460: 732c 0a20 2020 2020 7265 7370 6563 7469  s,.     respecti
│ │ │ │ +00005470: 7665 6c79 2e0a 0a20 2020 5468 6520 7072  vely...   The pr
│ │ │ │ +00005480: 6f74 6f63 6f6c 2064 6f20 6e6f 7420 696e  otocol do not in
│ │ │ │ +00005490: 636c 7564 6520 616e 7920 7761 7920 746f  clude any way to
│ │ │ │ +000054a0: 206e 6567 6f74 6961 7465 2077 6869 6368   negotiate which
│ │ │ │ +000054b0: 2063 6865 636b 7375 6d0a 6d65 6368 616e   checksum.mechan
│ │ │ │ +000054c0: 6973 6d73 2074 6f20 7573 652c 2073 6f20  isms to use, so 
│ │ │ │ +000054d0: 696e 206d 6f73 7420 6361 7365 7320 7468  in most cases th
│ │ │ │ +000054e0: 6520 6173 736f 6369 6174 6564 2063 6865  e associated che
│ │ │ │ +000054f0: 636b 7375 6d20 7769 6c6c 2062 650a 7573  cksum will be.us
│ │ │ │ +00005500: 6564 2e20 2048 6f77 6576 6572 2c20 6368  ed.  However, ch
│ │ │ │ +00005510: 6563 6b73 756d 206d 6563 6861 6e69 736d  ecksum mechanism
│ │ │ │ +00005520: 7320 6361 6e20 6265 2075 7365 6420 7769  s can be used wi
│ │ │ │ +00005530: 7468 206f 7468 6572 2065 6e63 7279 7074  th other encrypt
│ │ │ │ +00005540: 696f 6e0a 6d65 6368 616e 6973 6d73 2c20  ion.mechanisms, 
│ │ │ │ +00005550: 6173 206c 6f6e 6720 6173 2074 6865 7920  as long as they 
│ │ │ │ +00005560: 6172 6520 636f 6d70 6174 6962 6c65 2069  are compatible i
│ │ │ │ +00005570: 6e20 7465 726d 7320 6f66 206b 6579 2066  n terms of key f
│ │ │ │ +00005580: 6f72 6d61 7420 6574 632e 0a48 6572 6520  ormat etc..Here 
│ │ │ │ +00005590: 6172 6520 7468 6520 6e61 6d65 7320 6f66  are the names of
│ │ │ │ +000055a0: 2074 6865 2073 7570 706f 7274 6564 2063   the supported c
│ │ │ │ +000055b0: 6865 636b 7375 6d20 6d65 6368 616e 6973  hecksum mechanis
│ │ │ │ +000055c0: 6d73 2c20 7769 7468 2073 6f6d 6520 6e6f  ms, with some no
│ │ │ │ +000055d0: 7465 730a 6f6e 2074 6865 6972 2073 7461  tes.on their sta
│ │ │ │ +000055e0: 7475 7320 616e 6420 7468 6520 636f 6d70  tus and the comp
│ │ │ │ +000055f0: 6174 6962 6c65 2065 6e63 7279 7074 696f  atible encryptio
│ │ │ │ +00005600: 6e20 6d65 6368 616e 6973 6d73 2e20 2054  n mechanisms.  T
│ │ │ │ +00005610: 6865 7920 6172 650a 6f72 6465 7265 6420  hey are.ordered 
│ │ │ │ +00005620: 6279 2069 6e63 7265 6173 6564 2073 6563  by increased sec
│ │ │ │ +00005630: 7572 6974 7920 6173 2070 6572 6365 6976  urity as perceiv
│ │ │ │ +00005640: 6564 2062 7920 7468 6520 6175 7468 6f72  ed by the author
│ │ │ │ +00005650: 2e0a 0ae2 8098 4e55 4c4c e280 990a 0a20  ......NULL..... 
│ │ │ │ +00005660: 2020 2020 e280 984e 554c 4ce2 8099 2069      ...NULL... i
│ │ │ │ +00005670: 7320 6120 6475 6d6d 7920 6368 6563 6b73  s a dummy checks
│ │ │ │ +00005680: 756d 2073 7569 7465 2066 6f72 2064 6562  um suite for deb
│ │ │ │ +00005690: 7567 6769 6e67 2e20 2049 7420 7072 6f76  ugging.  It prov
│ │ │ │ +000056a0: 6964 6573 206e 6f0a 2020 2020 2069 6e74  ides no.     int
│ │ │ │ +000056b0: 6567 7269 7479 2e20 2049 7420 6973 2077  egrity.  It is w
│ │ │ │ +000056c0: 6561 6b2e 2020 4974 2069 7320 636f 6d70  eak.  It is comp
│ │ │ │ +000056d0: 6174 6962 6c65 2077 6974 6820 7468 6520  atible with the 
│ │ │ │ +000056e0: e280 984e 554c 4ce2 8099 0a20 2020 2020  ...NULL....     
│ │ │ │ +000056f0: 656e 6372 7970 7469 6f6e 206d 6563 6861  encryption mecha
│ │ │ │ +00005700: 6e69 736d 2e0a 0ae2 8098 6172 6366 6f75  nism......arcfou
│ │ │ │ +00005710: 722d 686d 6163 2d6d 6435 e280 990a 0a20  r-hmac-md5..... 
│ │ │ │ +00005720: 2020 2020 e280 9861 7263 666f 7572 2d68      ...arcfour-h
│ │ │ │ +00005730: 6d61 632d 6d64 35e2 8099 2069 7320 6120  mac-md5... is a 
│ │ │ │ +00005740: 6b65 7965 6420 484d 4143 2d4d 4435 2063  keyed HMAC-MD5 c
│ │ │ │ +00005750: 6865 636b 7375 6d20 636f 6d70 7574 6564  hecksum computed
│ │ │ │ +00005760: 206f 6e20 6120 4d44 350a 2020 2020 206d   on a MD5.     m
│ │ │ │ +00005770: 6573 7361 6765 2064 6967 6573 742c 2069  essage digest, i
│ │ │ │ +00005780: 6e20 7475 726e 2063 6f6d 7075 7465 6420  n turn computed 
│ │ │ │ +00005790: 6f6e 2061 2066 6f75 7220 6279 7465 206d  on a four byte m
│ │ │ │ +000057a0: 6573 7361 6765 2074 7970 650a 2020 2020  essage type.    
│ │ │ │ +000057b0: 2069 6e64 6963 6174 6f72 2063 6f6e 6361   indicator conca
│ │ │ │ +000057c0: 7465 6e61 7465 6420 7769 7468 2074 6865  tenated with the
│ │ │ │ +000057d0: 2061 7070 6c69 6361 7469 6f6e 2064 6174   application dat
│ │ │ │ +000057e0: 612e 2020 2854 6865 20e2 8098 6172 6366  a.  (The ...arcf
│ │ │ │ +000057f0: 6f75 72e2 8099 0a20 2020 2020 6465 7369  our....     desi
│ │ │ │ +00005800: 676e 6174 696f 6e20 6973 2074 6875 7320  gnation is thus 
│ │ │ │ +00005810: 736f 6d65 7768 6174 206d 6973 6c65 6164  somewhat mislead
│ │ │ │ +00005820: 696e 672c 2062 7574 2073 696e 6365 2074  ing, but since t
│ │ │ │ +00005830: 6869 7320 6368 6563 6b73 756d 0a20 2020  his checksum.   
│ │ │ │ +00005840: 2020 6d65 6368 616e 6973 6d20 6973 2064    mechanism is d
│ │ │ │ +00005850: 6573 6372 6962 6564 2069 6e20 7468 6520  escribed in the 
│ │ │ │ +00005860: 7361 6d65 2064 6f63 756d 656e 7420 6173  same document as
│ │ │ │ +00005870: 2074 6865 20e2 8098 6172 6366 6f75 72e2   the ...arcfour.
│ │ │ │ +00005880: 8099 0a20 2020 2020 656e 6372 7970 7469  ...     encrypti
│ │ │ │ +00005890: 6f6e 206d 6563 6861 6e69 736d 732c 2069  on mechanisms, i
│ │ │ │ +000058a0: 7420 6973 206e 6f74 2061 2063 6f6d 706c  t is not a compl
│ │ │ │ +000058b0: 6574 656c 7920 756e 6e61 7475 7261 6c0a  etely unnatural.
│ │ │ │ +000058c0: 2020 2020 2064 6573 6967 6e61 7469 6f6e       designation
│ │ │ │ +000058d0: 2e29 2020 4974 2069 7320 7765 616b 2e20  .)  It is weak. 
│ │ │ │ +000058e0: 2049 7420 6973 2063 6f6d 7061 7469 626c   It is compatibl
│ │ │ │ +000058f0: 6520 7769 7468 2061 6c6c 2065 6e63 7279  e with all encry
│ │ │ │ +00005900: 7074 696f 6e0a 2020 2020 206d 6563 6861  ption.     mecha
│ │ │ │ +00005910: 6e69 736d 732e 0a0a e280 9872 7361 2d6d  nisms......rsa-m
│ │ │ │ +00005920: 6434 e280 990a 0a20 2020 2020 e280 9872  d4.....     ...r
│ │ │ │ +00005930: 7361 2d6d 6434 e280 9920 6973 2061 2075  sa-md4... is a u
│ │ │ │ +00005940: 6e6b 6579 6564 204d 4434 2068 6173 6820  nkeyed MD4 hash 
│ │ │ │ +00005950: 636f 6d70 7574 6564 206f 7665 7220 7468  computed over th
│ │ │ │ +00005960: 6520 6d65 7373 6167 652e 2020 4974 2069  e message.  It i
│ │ │ │ +00005970: 730a 2020 2020 2077 6561 6b2c 2062 6563  s.     weak, bec
│ │ │ │ +00005980: 6175 7365 2069 7420 6973 2075 6e6b 6579  ause it is unkey
│ │ │ │ +00005990: 6564 2e20 2048 6f77 6576 6572 2061 7070  ed.  However app
│ │ │ │ +000059a0: 6c69 6361 7469 6f6e 7320 6361 6e2c 2077  lications can, w
│ │ │ │ +000059b0: 6974 6820 6361 7265 2c0a 2020 2020 2075  ith care,.     u
│ │ │ │ +000059c0: 7365 2069 7420 6e6f 6e2d 7765 616b 2077  se it non-weak w
│ │ │ │ +000059d0: 6179 7320 2865 2e67 2e2c 2062 7920 696e  ays (e.g., by in
│ │ │ │ +000059e0: 636c 7564 696e 6720 7468 6520 6861 7368  cluding the hash
│ │ │ │ +000059f0: 2069 6e20 6f74 6865 7220 6d65 7373 6167   in other messag
│ │ │ │ +00005a00: 6573 0a20 2020 2020 7468 6174 2061 7265  es.     that are
│ │ │ │ +00005a10: 2070 726f 7465 6374 6564 2062 7920 6f74   protected by ot
│ │ │ │ +00005a20: 6865 7220 6d65 616e 7329 2e20 2049 7420  her means).  It 
│ │ │ │ +00005a30: 6973 2063 6f6d 7061 7469 626c 6520 7769  is compatible wi
│ │ │ │ +00005a40: 7468 2061 6c6c 0a20 2020 2020 656e 6372  th all.     encr
│ │ │ │ +00005a50: 7970 7469 6f6e 206d 6563 6861 6e69 736d  yption mechanism
│ │ │ │ +00005a60: 732e 0a0a e280 9872 7361 2d6d 6434 2d64  s......rsa-md4-d
│ │ │ │ +00005a70: 6573 e280 990a 0a20 2020 2020 e280 9872  es.....     ...r
│ │ │ │ +00005a80: 7361 2d6d 6434 2d64 6573 e280 9920 6973  sa-md4-des... is
│ │ │ │ +00005a90: 2061 2044 4553 2043 4243 2065 6e63 7279   a DES CBC encry
│ │ │ │ +00005aa0: 7074 696f 6e20 6f66 206f 6e65 2062 6c6f  ption of one blo
│ │ │ │ +00005ab0: 636b 206f 6620 7261 6e64 6f6d 2064 6174  ck of random dat
│ │ │ │ +00005ac0: 610a 2020 2020 2061 6e64 2061 2075 6e6b  a.     and a unk
│ │ │ │ +00005ad0: 6579 6564 204d 4434 2068 6173 6820 636f  eyed MD4 hash co
│ │ │ │ +00005ae0: 6d70 7574 6564 206f 7665 7220 7468 6520  mputed over the 
│ │ │ │ +00005af0: 7261 6e64 6f6d 2064 6174 6120 616e 6420  random data and 
│ │ │ │ +00005b00: 7468 650a 2020 2020 206d 6573 7361 6765  the.     message
│ │ │ │ +00005b10: 2074 6f20 696e 7465 6772 6974 7920 7072   to integrity pr
│ │ │ │ +00005b20: 6f74 6563 742e 2020 5468 6520 6b65 7920  otect.  The key 
│ │ │ │ +00005b30: 7573 6564 2069 7320 6465 7269 7665 6420  used is derived 
│ │ │ │ +00005b40: 6672 6f6d 2074 6865 0a20 2020 2020 6261  from the.     ba
│ │ │ │ +00005b50: 7365 2070 726f 746f 636f 6c20 6b65 7920  se protocol key 
│ │ │ │ +00005b60: 6279 2058 4f52 2077 6974 6820 6120 636f  by XOR with a co
│ │ │ │ +00005b70: 6e73 7461 6e74 2e20 2049 7420 6973 2077  nstant.  It is w
│ │ │ │ +00005b80: 6561 6b2e 2020 4974 2069 730a 2020 2020  eak.  It is.    
│ │ │ │ +00005b90: 2063 6f6d 7061 7469 626c 6520 7769 7468   compatible with
│ │ │ │ +00005ba0: 2074 6865 20e2 8098 6465 732d 6362 632d   the ...des-cbc-
│ │ │ │ +00005bb0: 6372 63e2 8099 2c20 e280 9864 6573 2d63  crc..., ...des-c
│ │ │ │ +00005bc0: 6263 2d6d 6434 e280 992c 20e2 8098 6465  bc-md4..., ...de
│ │ │ │ +00005bd0: 732d 6362 632d 6d64 35e2 8099 0a20 2020  s-cbc-md5....   
│ │ │ │ +00005be0: 2020 656e 6372 7970 7469 6f6e 206d 6563    encryption mec
│ │ │ │ +00005bf0: 6861 6e69 736d 732e 0a0a e280 9872 7361  hanisms......rsa
│ │ │ │ +00005c00: 2d6d 6435 e280 990a 0a20 2020 2020 e280  -md5.....     ..
│ │ │ │ +00005c10: 9872 7361 2d6d 6435 e280 9920 6973 2061  .rsa-md5... is a
│ │ │ │ +00005c20: 2075 6e6b 6579 6564 204d 4435 2068 6173   unkeyed MD5 has
│ │ │ │ +00005c30: 6820 636f 6d70 7574 6564 206f 7665 7220  h computed over 
│ │ │ │ +00005c40: 7468 6520 6d65 7373 6167 652e 2020 4974  the message.  It
│ │ │ │ +00005c50: 2069 730a 2020 2020 2077 6561 6b2c 2062   is.     weak, b
│ │ │ │ +00005c60: 6563 6175 7365 2069 7420 6973 2075 6e6b  ecause it is unk
│ │ │ │ +00005c70: 6579 6564 2e20 2048 6f77 6576 6572 2061  eyed.  However a
│ │ │ │ +00005c80: 7070 6c69 6361 7469 6f6e 7320 6361 6e2c  pplications can,
│ │ │ │ +00005c90: 2077 6974 6820 6361 7265 2c0a 2020 2020   with care,.    
│ │ │ │ +00005ca0: 2075 7365 2069 7420 6e6f 6e2d 7765 616b   use it non-weak
│ │ │ │ +00005cb0: 2077 6179 7320 2865 2e67 2e2c 2062 7920   ways (e.g., by 
│ │ │ │ +00005cc0: 696e 636c 7564 696e 6720 7468 6520 6861  including the ha
│ │ │ │ +00005cd0: 7368 2069 6e20 6f74 6865 7220 6d65 7373  sh in other mess
│ │ │ │ +00005ce0: 6167 6573 0a20 2020 2020 7468 6174 2061  ages.     that a
│ │ │ │ +00005cf0: 7265 2070 726f 7465 6374 6564 2062 7920  re protected by 
│ │ │ │ +00005d00: 6f74 6865 7220 6d65 616e 7329 2e20 2049  other means).  I
│ │ │ │ +00005d10: 7420 6973 2063 6f6d 7061 7469 626c 6520  t is compatible 
│ │ │ │ +00005d20: 7769 7468 2061 6c6c 0a20 2020 2020 656e  with all.     en
│ │ │ │ +00005d30: 6372 7970 7469 6f6e 206d 6563 6861 6e69  cryption mechani
│ │ │ │ +00005d40: 736d 732e 0a0a e280 9872 7361 2d6d 6435  sms......rsa-md5
│ │ │ │ +00005d50: 2d64 6573 e280 990a 0a20 2020 2020 e280  -des.....     ..
│ │ │ │ +00005d60: 9872 7361 2d6d 6435 2d64 6573 e280 9920  .rsa-md5-des... 
│ │ │ │ +00005d70: 6973 2061 2044 4553 2043 4243 2065 6e63  is a DES CBC enc
│ │ │ │ +00005d80: 7279 7074 696f 6e20 6f66 206f 6e65 2062  ryption of one b
│ │ │ │ +00005d90: 6c6f 636b 206f 6620 7261 6e64 6f6d 2064  lock of random d
│ │ │ │ +00005da0: 6174 610a 2020 2020 2061 6e64 2061 2075  ata.     and a u
│ │ │ │ +00005db0: 6e6b 6579 6564 204d 4435 2068 6173 6820  nkeyed MD5 hash 
│ │ │ │ +00005dc0: 636f 6d70 7574 6564 206f 7665 7220 7468  computed over th
│ │ │ │ +00005dd0: 6520 7261 6e64 6f6d 2064 6174 6120 616e  e random data an
│ │ │ │ +00005de0: 6420 7468 650a 2020 2020 206d 6573 7361  d the.     messa
│ │ │ │ +00005df0: 6765 2074 6f20 696e 7465 6772 6974 7920  ge to integrity 
│ │ │ │ +00005e00: 7072 6f74 6563 742e 2020 5468 6520 6b65  protect.  The ke
│ │ │ │ +00005e10: 7920 7573 6564 2069 7320 6465 7269 7665  y used is derive
│ │ │ │ +00005e20: 6420 6672 6f6d 2074 6865 0a20 2020 2020  d from the.     
│ │ │ │ +00005e30: 6261 7365 2070 726f 746f 636f 6c20 6b65  base protocol ke
│ │ │ │ +00005e40: 7920 6279 2058 4f52 2077 6974 6820 6120  y by XOR with a 
│ │ │ │ +00005e50: 636f 6e73 7461 6e74 2e20 2049 7420 6973  constant.  It is
│ │ │ │ +00005e60: 2077 6561 6b2e 2020 4974 2069 730a 2020   weak.  It is.  
│ │ │ │ +00005e70: 2020 2063 6f6d 7061 7469 626c 6520 7769     compatible wi
│ │ │ │ +00005e80: 7468 2074 6865 20e2 8098 6465 732d 6362  th the ...des-cb
│ │ │ │ +00005e90: 632d 6372 63e2 8099 2c20 e280 9864 6573  c-crc..., ...des
│ │ │ │ +00005ea0: 2d63 6263 2d6d 6434 e280 992c 20e2 8098  -cbc-md4..., ...
│ │ │ │ +00005eb0: 6465 732d 6362 632d 6d64 35e2 8099 0a20  des-cbc-md5.... 
│ │ │ │ +00005ec0: 2020 2020 656e 6372 7970 7469 6f6e 206d      encryption m
│ │ │ │ +00005ed0: 6563 6861 6e69 736d 732e 0a0a e280 9868  echanisms......h
│ │ │ │ +00005ee0: 6d61 632d 7368 6131 2d64 6573 332d 6b64  mac-sha1-des3-kd
│ │ │ │ +00005ef0: e280 990a 0a20 2020 2020 e280 9868 6d61  .....     ...hma
│ │ │ │ +00005f00: 632d 7368 6131 2d64 6573 332d 6b64 e280  c-sha1-des3-kd..
│ │ │ │ +00005f10: 9920 6973 2061 206b 6579 6564 2053 4841  . is a keyed SHA
│ │ │ │ +00005f20: 3120 6861 7368 2069 6e20 484d 4143 206d  1 hash in HMAC m
│ │ │ │ +00005f30: 6f64 6520 636f 6d70 7574 6564 206f 7665  ode computed ove
│ │ │ │ +00005f40: 720a 2020 2020 2074 6865 206d 6573 7361  r.     the messa
│ │ │ │ +00005f50: 6765 2e20 2054 6865 206b 6579 2069 7320  ge.  The key is 
│ │ │ │ +00005f60: 6465 7269 7665 6420 6672 6f6d 2074 6865  derived from the
│ │ │ │ +00005f70: 2062 6173 6520 7072 6f74 6f63 6f6c 2062   base protocol b
│ │ │ │ +00005f80: 7920 7468 650a 2020 2020 2073 696d 706c  y the.     simpl
│ │ │ │ +00005f90: 6966 6965 6420 6b65 7920 6465 7269 7661  ified key deriva
│ │ │ │ +00005fa0: 7469 6f6e 2066 756e 6374 696f 6e20 2873  tion function (s
│ │ │ │ +00005fb0: 696d 696c 6172 2074 6f20 7468 6520 7061  imilar to the pa
│ │ │ │ +00005fc0: 7373 776f 7264 206b 6579 0a20 2020 2020  ssword key.     
│ │ │ │ +00005fd0: 6465 7269 7661 7469 6f6e 2066 756e 6374  derivation funct
│ │ │ │ +00005fe0: 696f 6e73 206f 6620 e280 9864 6573 332d  ions of ...des3-
│ │ │ │ +00005ff0: 6362 632d 7368 6131 2d6b 64e2 8099 2c20  cbc-sha1-kd..., 
│ │ │ │ +00006000: 7768 6963 6820 646f 6573 206e 6f74 2061  which does not a
│ │ │ │ +00006010: 7070 6561 720a 2020 2020 2074 6f20 6265  ppear.     to be
│ │ │ │ +00006020: 2077 6964 656c 7920 7573 6564 206f 7574   widely used out
│ │ │ │ +00006030: 7369 6465 204b 6572 6265 726f 7320 616e  side Kerberos an
│ │ │ │ +00006040: 6420 6865 6e63 6520 6e6f 7420 7769 6465  d hence not wide
│ │ │ │ +00006050: 6c79 2073 7475 6469 6564 292e 0a20 2020  ly studied)..   
│ │ │ │ +00006060: 2020 4974 2068 6173 206e 6f20 7365 6375    It has no secu
│ │ │ │ +00006070: 7269 7479 2070 726f 6f66 2c20 6275 7420  rity proof, but 
│ │ │ │ +00006080: 6973 2061 7373 756d 6564 2074 6f20 7072  is assumed to pr
│ │ │ │ +00006090: 6f76 6964 6520 676f 6f64 2073 6563 7572  ovide good secur
│ │ │ │ +000060a0: 6974 792e 0a20 2020 2020 5468 6520 7765  ity..     The we
│ │ │ │ +000060b0: 616b 6573 7420 7061 7274 2069 7320 6c69  akest part is li
│ │ │ │ +000060c0: 6b65 6c79 2074 6865 2070 726f 7072 6965  kely the proprie
│ │ │ │ +000060d0: 7461 7279 206b 6579 2064 6572 6976 6174  tary key derivat
│ │ │ │ +000060e0: 696f 6e20 6675 6e63 7469 6f6e 2e0a 2020  ion function..  
│ │ │ │ +000060f0: 2020 2049 7420 6973 2063 6f6d 7061 7469     It is compati
│ │ │ │ +00006100: 626c 6520 7769 7468 2074 6865 20e2 8098  ble with the ...
│ │ │ │ +00006110: 6465 7333 2d63 6263 2d73 6861 312d 6b64  des3-cbc-sha1-kd
│ │ │ │ +00006120: e280 9920 656e 6372 7970 7469 6f6e 206d  ... encryption m
│ │ │ │ +00006130: 6563 6861 6e69 736d 2e0a 0ae2 8098 686d  echanism......hm
│ │ │ │ +00006140: 6163 2d73 6861 312d 3936 2d61 6573 3132  ac-sha1-96-aes12
│ │ │ │ +00006150: 38e2 8099 0ae2 8098 686d 6163 2d73 6861  8.......hmac-sha
│ │ │ │ +00006160: 312d 3936 2d61 6573 3235 36e2 8099 0a0a  1-96-aes256.....
│ │ │ │ +00006170: 2020 2020 20e2 8098 686d 6163 2d73 6861       ...hmac-sha
│ │ │ │ +00006180: 312d 3936 2d61 6573 2ae2 8099 2061 7265  1-96-aes*... are
│ │ │ │ +00006190: 206b 6579 6564 2053 4841 3120 6861 7368   keyed SHA1 hash
│ │ │ │ +000061a0: 6573 2069 6e20 484d 4143 206d 6f64 6520  es in HMAC mode 
│ │ │ │ +000061b0: 636f 6d70 7574 6564 0a20 2020 2020 6f76  computed.     ov
│ │ │ │ +000061c0: 6572 2074 6865 206d 6573 7361 6765 2061  er the message a
│ │ │ │ +000061d0: 6e64 2074 6865 6e20 7472 756e 6361 7465  nd then truncate
│ │ │ │ +000061e0: 6420 746f 2039 3620 6269 7473 2e20 2054  d to 96 bits.  T
│ │ │ │ +000061f0: 6865 206b 6579 2069 7320 6465 7269 7665  he key is derive
│ │ │ │ +00006200: 640a 2020 2020 2066 726f 6d20 7468 6520  d.     from the 
│ │ │ │ +00006210: 6261 7365 2070 726f 746f 636f 6c20 6279  base protocol by
│ │ │ │ +00006220: 2074 6865 2073 696d 706c 6966 6965 6420   the simplified 
│ │ │ │ +00006230: 6b65 7920 6465 7269 7661 7469 6f6e 2066  key derivation f
│ │ │ │ +00006240: 756e 6374 696f 6e0a 2020 2020 2028 7369  unction.     (si
│ │ │ │ +00006250: 6d69 6c61 7220 746f 2074 6865 2070 6173  milar to the pas
│ │ │ │ +00006260: 7377 6f72 6420 6b65 7920 6465 7269 7661  sword key deriva
│ │ │ │ +00006270: 7469 6f6e 2066 756e 6374 696f 6e73 206f  tion functions o
│ │ │ │ +00006280: 660a 2020 2020 20e2 8098 6165 732a 2d63  f.     ...aes*-c
│ │ │ │ +00006290: 7473 2d68 6d61 632d 7368 6131 2d39 36e2  ts-hmac-sha1-96.
│ │ │ │ +000062a0: 8099 2c20 692e 652e 2c20 504b 4353 2335  .., i.e., PKCS#5
│ │ │ │ +000062b0: 292e 2020 4974 2068 6173 206e 6f20 7365  ).  It has no se
│ │ │ │ +000062c0: 6375 7269 7479 2070 726f 6f66 2c0a 2020  curity proof,.  
│ │ │ │ +000062d0: 2020 2062 7574 2069 7320 6173 7375 6d65     but is assume
│ │ │ │ +000062e0: 6420 746f 2070 726f 7669 6465 2067 6f6f  d to provide goo
│ │ │ │ +000062f0: 6420 7365 6375 7269 7479 2e20 2049 7420  d security.  It 
│ │ │ │ +00006300: 6973 2063 6f6d 7061 7469 626c 6520 7769  is compatible wi
│ │ │ │ +00006310: 7468 2074 6865 0a20 2020 2020 e280 9861  th the.     ...a
│ │ │ │ +00006320: 6573 2a2d 6374 732d 686d 6163 2d73 6861  es*-cts-hmac-sha
│ │ │ │ +00006330: 312d 3936 e280 9920 656e 6372 7970 7469  1-96... encrypti
│ │ │ │ +00006340: 6f6e 206d 6563 6861 6e69 736d 732e 0a0a  on mechanisms...
│ │ │ │ +00006350: 2020 2053 6576 6572 616c 206f 6620 7468     Several of th
│ │ │ │ +00006360: 6520 6369 7068 6572 2073 7569 7465 7320  e cipher suites 
│ │ │ │ +00006370: 6861 7665 206c 6f6e 6720 6e61 6d65 7320  have long names 
│ │ │ │ +00006380: 7468 6174 2063 616e 2062 6520 6861 7264  that can be hard
│ │ │ │ +00006390: 2074 6f0a 6d65 6d6f 7269 7a65 2e20 2046   to.memorize.  F
│ │ │ │ +000063a0: 6f72 2079 6f75 7220 636f 6e76 656e 6965  or your convenie
│ │ │ │ +000063b0: 6e63 652c 2074 6865 2066 6f6c 6c6f 7769  nce, the followi
│ │ │ │ +000063c0: 6e67 2073 686f 7274 2d68 616e 6420 616c  ng short-hand al
│ │ │ │ +000063d0: 6961 7365 730a 6578 6973 7473 2e20 2054  iases.exists.  T
│ │ │ │ +000063e0: 6865 7920 6361 6e20 6265 2075 7365 6420  hey can be used 
│ │ │ │ +000063f0: 7768 6572 6576 6572 2074 6865 2066 756c  wherever the ful
│ │ │ │ +00006400: 6c20 656e 6372 7970 7469 6f6e 206e 616d  l encryption nam
│ │ │ │ +00006410: 6573 2061 7265 2075 7365 642e 0a0a e280  es are used.....
│ │ │ │ +00006420: 9861 7263 666f 7572 e280 990a 0a20 2020  .arcfour.....   
│ │ │ │ +00006430: 2020 416c 6961 7320 666f 7220 e280 9861    Alias for ...a
│ │ │ │ +00006440: 7263 666f 7572 2d68 6d61 63e2 8099 2e0a  rcfour-hmac.....
│ │ │ │ +00006450: 0ae2 8098 6465 732d 6372 63e2 8099 0a0a  ....des-crc.....
│ │ │ │ +00006460: 2020 2020 2041 6c69 6173 2066 6f72 20e2       Alias for .
│ │ │ │ +00006470: 8098 6465 732d 6362 632d 6372 63e2 8099  ..des-cbc-crc...
│ │ │ │ +00006480: 2e0a 0ae2 8098 6465 732d 6d64 34e2 8099  ......des-md4...
│ │ │ │ +00006490: 0a0a 2020 2020 2041 6c69 6173 2066 6f72  ..     Alias for
│ │ │ │ +000064a0: 20e2 8098 6465 732d 6362 632d 6d64 34e2   ...des-cbc-md4.
│ │ │ │ +000064b0: 8099 2e0a 0ae2 8098 6465 732d 6d64 35e2  ........des-md5.
│ │ │ │ +000064c0: 8099 0ae2 8098 6465 73e2 8099 0a0a 2020  ......des.....  
│ │ │ │ +000064d0: 2020 2041 6c69 6173 2066 6f72 20e2 8098     Alias for ...
│ │ │ │ +000064e0: 6465 732d 6362 632d 6d64 35e2 8099 2e0a  des-cbc-md5.....
│ │ │ │ +000064f0: 0ae2 8098 6465 7333 e280 990a e280 9833  ....des3.......3
│ │ │ │ +00006500: 6465 73e2 8099 0a0a 2020 2020 2041 6c69  des.....     Ali
│ │ │ │ +00006510: 6173 2066 6f72 20e2 8098 6465 7333 2d63  as for ...des3-c
│ │ │ │ +00006520: 6263 2d73 6861 312d 6b64 e280 992e 0a0a  bc-sha1-kd......
│ │ │ │ +00006530: e280 9861 6573 3132 38e2 8099 0a0a 2020  ...aes128.....  
│ │ │ │ +00006540: 2020 2041 6c69 6173 2066 6f72 20e2 8098     Alias for ...
│ │ │ │ +00006550: 6165 7331 3238 2d63 7473 2d68 6d61 632d  aes128-cts-hmac-
│ │ │ │ +00006560: 7368 6131 2d39 36e2 8099 2e0a 0ae2 8098  sha1-96.........
│ │ │ │ +00006570: 6165 73e2 8099 0ae2 8098 6165 7332 3536  aes.......aes256
│ │ │ │ +00006580: e280 990a 0a20 2020 2020 416c 6961 7320  .....     Alias 
│ │ │ │ +00006590: 666f 7220 e280 9861 6573 3235 362d 6374  for ...aes256-ct
│ │ │ │ +000065a0: 732d 686d 6163 2d73 6861 312d 3936 e280  s-hmac-sha1-96..
│ │ │ │ +000065b0: 992e 0a0a 2020 202d 2d2d 2d2d 2d2d 2d2d  ....   ---------
│ │ │ │ +000065c0: 2d20 466f 6f74 6e6f 7465 7320 2d2d 2d2d  - Footnotes ----
│ │ │ │ +000065d0: 2d2d 2d2d 2d2d 0a0a 2020 2028 3129 203c  ------..   (1) <
│ │ │ │ +000065e0: 6874 7470 3a2f 2f77 7777 2e72 6573 6561  http://www.resea
│ │ │ │ +000065f0: 7263 682e 6174 742e 636f 6d2f 7e73 6d62  rch.att.com/~smb
│ │ │ │ +00006600: 2f70 6170 6572 732f 6964 6573 2e70 6466  /papers/ides.pdf
│ │ │ │ +00006610: 3e0a 0a20 2020 2832 2920 3c68 7474 703a  >..   (2) <http:
│ │ │ │ +00006620: 2f2f 7777 772e 7273 6173 6563 7572 6974  //www.rsasecurit
│ │ │ │ +00006630: 792e 636f 6d2f 7273 616c 6162 732f 706b  y.com/rsalabs/pk
│ │ │ │ +00006640: 6373 2f70 6b63 732d 352f 3e0a 0a1f 0a46  cs/pkcs-5/>....F
│ │ │ │ +00006650: 696c 653a 2073 6869 7368 692e 696e 666f  ile: shishi.info
│ │ │ │ +00006660: 2c20 204e 6f64 653a 2053 7570 706f 7274  ,  Node: Support
│ │ │ │ +00006670: 6564 2050 6c61 7466 6f72 6d73 2c20 204e  ed Platforms,  N
│ │ │ │ +00006680: 6578 743a 2047 6574 7469 6e67 2068 656c  ext: Getting hel
│ │ │ │ +00006690: 702c 2020 5072 6576 3a20 4372 7970 746f  p,  Prev: Crypto
│ │ │ │ +000066a0: 6772 6170 6869 6320 4f76 6572 7669 6577  graphic Overview
│ │ │ │ +000066b0: 2c20 2055 703a 2049 6e74 726f 6475 6374  ,  Up: Introduct
│ │ │ │ +000066c0: 696f 6e0a 0a31 2e35 2053 7570 706f 7274  ion..1.5 Support
│ │ │ │ +000066d0: 6564 2050 6c61 7466 6f72 6d73 0a3d 3d3d  ed Platforms.===
│ │ │ │  000066e0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ -000066f0: 3d3d 0a0a 5368 6973 6869 2068 6173 2061  ==..Shishi has a
│ │ │ │ -00006700: 7420 736f 6d65 2070 6f69 6e74 2069 6e20  t some point in 
│ │ │ │ -00006710: 7469 6d65 2062 6565 6e20 7465 7374 6564  time been tested
│ │ │ │ -00006720: 206f 6e20 7468 6520 666f 6c6c 6f77 696e   on the followin
│ │ │ │ -00006730: 6720 706c 6174 666f 726d 732e 0a4f 6e6c  g platforms..Onl
│ │ │ │ -00006740: 696e 6520 6275 696c 6420 7265 706f 7274  ine build report
│ │ │ │ -00006750: 7320 666f 7220 6561 6368 2070 6c61 7466  s for each platf
│ │ │ │ -00006760: 6f72 6d73 2061 6e64 2053 6869 7368 6920  orms and Shishi 
│ │ │ │ -00006770: 7665 7273 696f 6e20 6973 2061 7661 696c  version is avail
│ │ │ │ -00006780: 6162 6c65 0a61 7420 3c68 7474 703a 2f2f  able.at <http://
│ │ │ │ -00006790: 6175 746f 6275 696c 642e 6a6f 7365 6673  autobuild.josefs
│ │ │ │ -000067a0: 736f 6e2e 6f72 672f 7368 6973 6869 2f3e  son.org/shishi/>
│ │ │ │ -000067b0: 2e0a 0a20 2031 2e20 4465 6269 616e 2047  ...  1. Debian G
│ │ │ │ -000067c0: 4e55 2f4c 696e 7578 2033 2e30 2028 576f  NU/Linux 3.0 (Wo
│ │ │ │ -000067d0: 6f64 7929 0a0a 2020 2020 2047 4343 2032  ody)..     GCC 2
│ │ │ │ -000067e0: 2e39 352e 3420 616e 6420 474e 5520 4d61  .95.4 and GNU Ma
│ │ │ │ -000067f0: 6b65 2e20 2054 6869 7320 6973 2074 6865  ke.  This is the
│ │ │ │ -00006800: 206d 6169 6e20 6465 7665 6c6f 706d 656e   main developmen
│ │ │ │ -00006810: 7420 706c 6174 666f 726d 2e0a 2020 2020  t platform..    
│ │ │ │ -00006820: 20e2 8098 616c 7068 6165 7636 372d 756e   ...alphaev67-un
│ │ │ │ -00006830: 6b6e 6f77 6e2d 6c69 6e75 782d 676e 75e2  known-linux-gnu.
│ │ │ │ -00006840: 8099 2c20 e280 9861 6c70 6861 6576 362d  .., ...alphaev6-
│ │ │ │ -00006850: 756e 6b6e 6f77 6e2d 6c69 6e75 782d 676e  unknown-linux-gn
│ │ │ │ -00006860: 75e2 8099 2c0a 2020 2020 20e2 8098 6172  u...,.     ...ar
│ │ │ │ -00006870: 6d2d 756e 6b6e 6f77 6e2d 6c69 6e75 782d  m-unknown-linux-
│ │ │ │ -00006880: 676e 75e2 8099 2c20 e280 9861 726d 7634  gnu..., ...armv4
│ │ │ │ -00006890: 6c2d 756e 6b6e 6f77 6e2d 6c69 6e75 782d  l-unknown-linux-
│ │ │ │ -000068a0: 676e 75e2 8099 2c0a 2020 2020 20e2 8098  gnu...,.     ...
│ │ │ │ -000068b0: 6870 7061 2d75 6e6b 6e6f 776e 2d6c 696e  hppa-unknown-lin
│ │ │ │ -000068c0: 7578 2d67 6e75 e280 992c 20e2 8098 6870  ux-gnu..., ...hp
│ │ │ │ -000068d0: 7061 3634 2d75 6e6b 6e6f 776e 2d6c 696e  pa64-unknown-lin
│ │ │ │ -000068e0: 7578 2d67 6e75 e280 992c 0a20 2020 2020  ux-gnu...,.     
│ │ │ │ -000068f0: e280 9869 3638 362d 7063 2d6c 696e 7578  ...i686-pc-linux
│ │ │ │ -00006900: 2d67 6e75 e280 992c 20e2 8098 6961 3634  -gnu..., ...ia64
│ │ │ │ -00006910: 2d75 6e6b 6e6f 776e 2d6c 696e 7578 2d67  -unknown-linux-g
│ │ │ │ -00006920: 6e75 e280 992c 0a20 2020 2020 e280 986d  nu...,.     ...m
│ │ │ │ -00006930: 3638 6b2d 756e 6b6e 6f77 6e2d 6c69 6e75  68k-unknown-linu
│ │ │ │ -00006940: 782d 676e 75e2 8099 2c20 e280 986d 6970  x-gnu..., ...mip
│ │ │ │ -00006950: 732d 756e 6b6e 6f77 6e2d 6c69 6e75 782d  s-unknown-linux-
│ │ │ │ -00006960: 676e 75e2 8099 2c0a 2020 2020 20e2 8098  gnu...,.     ...
│ │ │ │ -00006970: 6d69 7073 656c 2d75 6e6b 6e6f 776e 2d6c  mipsel-unknown-l
│ │ │ │ -00006980: 696e 7578 2d67 6e75 e280 992c 20e2 8098  inux-gnu..., ...
│ │ │ │ -00006990: 706f 7765 7270 632d 756e 6b6e 6f77 6e2d  powerpc-unknown-
│ │ │ │ -000069a0: 6c69 6e75 782d 676e 75e2 8099 2c0a 2020  linux-gnu...,.  
│ │ │ │ -000069b0: 2020 20e2 8098 7333 3930 2d69 626d 2d6c     ...s390-ibm-l
│ │ │ │ -000069c0: 696e 7578 2d67 6e75 e280 992c 20e2 8098  inux-gnu..., ...
│ │ │ │ -000069d0: 7370 6172 632d 756e 6b6e 6f77 6e2d 6c69  sparc-unknown-li
│ │ │ │ -000069e0: 6e75 782d 676e 75e2 8099 2c0a 2020 2020  nux-gnu...,.    
│ │ │ │ -000069f0: 20e2 8098 7370 6172 6336 342d 756e 6b6e   ...sparc64-unkn
│ │ │ │ -00006a00: 6f77 6e2d 6c69 6e75 782d 676e 75e2 8099  own-linux-gnu...
│ │ │ │ -00006a10: 2e0a 0a20 2032 2e20 4465 6269 616e 2047  ...  2. Debian G
│ │ │ │ -00006a20: 4e55 2f4c 696e 7578 2032 2e31 0a0a 2020  NU/Linux 2.1..  
│ │ │ │ -00006a30: 2020 2047 4343 2032 2e39 352e 3420 616e     GCC 2.95.4 an
│ │ │ │ -00006a40: 6420 474e 5520 4d61 6b65 2e20 20e2 8098  d GNU Make.  ...
│ │ │ │ -00006a50: 6172 6d76 346c 2d75 6e6b 6e6f 776e 2d6c  armv4l-unknown-l
│ │ │ │ -00006a60: 696e 7578 2d67 6e75 e280 992e 0a0a 2020  inux-gnu......  
│ │ │ │ -00006a70: 332e 2054 7275 3634 2055 4e49 580a 0a20  3. Tru64 UNIX.. 
│ │ │ │ -00006a80: 2020 2020 5472 7536 3420 554e 4958 2043      Tru64 UNIX C
│ │ │ │ -00006a90: 2063 6f6d 7069 6c65 7220 616e 6420 5472   compiler and Tr
│ │ │ │ -00006aa0: 7536 3420 4d61 6b65 2e20 20e2 8098 616c  u64 Make.  ...al
│ │ │ │ -00006ab0: 7068 6165 7636 372d 6465 632d 6f73 6635  phaev67-dec-osf5
│ │ │ │ -00006ac0: 2e31 e280 992c 0a20 2020 2020 e280 9861  .1...,.     ...a
│ │ │ │ -00006ad0: 6c70 6861 6576 3638 2d64 6563 2d6f 7366  lphaev68-dec-osf
│ │ │ │ -00006ae0: 352e 31e2 8099 2e0a 0a20 2034 2e20 5375  5.1......  4. Su
│ │ │ │ -00006af0: 5345 204c 696e 7578 2037 2e31 0a0a 2020  SE Linux 7.1..  
│ │ │ │ -00006b00: 2020 2047 4343 2032 2e39 3620 616e 6420     GCC 2.96 and 
│ │ │ │ -00006b10: 474e 5520 4d61 6b65 2e20 20e2 8098 616c  GNU Make.  ...al
│ │ │ │ -00006b20: 7068 6165 7636 2d75 6e6b 6e6f 776e 2d6c  phaev6-unknown-l
│ │ │ │ -00006b30: 696e 7578 2d67 6e75 e280 992c 0a20 2020  inux-gnu...,.   
│ │ │ │ -00006b40: 2020 e280 9861 6c70 6861 6576 3637 2d75    ...alphaev67-u
│ │ │ │ -00006b50: 6e6b 6e6f 776e 2d6c 696e 7578 2d67 6e75  nknown-linux-gnu
│ │ │ │ -00006b60: e280 992e 0a0a 2020 352e 2053 7553 4520  ......  5. SuSE 
│ │ │ │ -00006b70: 4c69 6e75 7820 372e 3261 0a0a 2020 2020  Linux 7.2a..    
│ │ │ │ -00006b80: 2047 4343 2033 2e30 2061 6e64 2047 4e55   GCC 3.0 and GNU
│ │ │ │ -00006b90: 204d 616b 652e 2020 e280 9869 6136 342d   Make.  ...ia64-
│ │ │ │ -00006ba0: 756e 6b6e 6f77 6e2d 6c69 6e75 782d 676e  unknown-linux-gn
│ │ │ │ -00006bb0: 75e2 8099 2e0a 0a20 2036 2e20 5375 5345  u......  6. SuSE
│ │ │ │ -00006bc0: 204c 696e 7578 0a0a 2020 2020 2047 4343   Linux..     GCC
│ │ │ │ -00006bd0: 2033 2e32 2e32 2061 6e64 2047 4e55 204d   3.2.2 and GNU M
│ │ │ │ -00006be0: 616b 652e 2020 e280 9878 3836 5f36 342d  ake.  ...x86_64-
│ │ │ │ -00006bf0: 756e 6b6e 6f77 6e2d 6c69 6e75 782d 676e  unknown-linux-gn
│ │ │ │ -00006c00: 75e2 8099 2028 414d 4436 3420 4f70 7465  u... (AMD64 Opte
│ │ │ │ -00006c10: 726f 6e0a 2020 2020 2022 4d65 6c6f 6479  ron.     "Melody
│ │ │ │ -00006c20: 2229 2e0a 0a20 2037 2e20 5265 6448 6174  ")...  7. RedHat
│ │ │ │ -00006c30: 204c 696e 7578 2037 2e32 0a0a 2020 2020   Linux 7.2..    
│ │ │ │ -00006c40: 2047 4343 2032 2e39 3620 616e 6420 474e   GCC 2.96 and GN
│ │ │ │ -00006c50: 5520 4d61 6b65 2e20 20e2 8098 616c 7068  U Make.  ...alph
│ │ │ │ -00006c60: 6165 7636 2d75 6e6b 6e6f 776e 2d6c 696e  aev6-unknown-lin
│ │ │ │ -00006c70: 7578 2d67 6e75 e280 992c 0a20 2020 2020  ux-gnu...,.     
│ │ │ │ -00006c80: e280 9861 6c70 6861 6576 3637 2d75 6e6b  ...alphaev67-unk
│ │ │ │ -00006c90: 6e6f 776e 2d6c 696e 7578 2d67 6e75 e280  nown-linux-gnu..
│ │ │ │ -00006ca0: 992c 20e2 8098 6961 3634 2d75 6e6b 6e6f  ., ...ia64-unkno
│ │ │ │ -00006cb0: 776e 2d6c 696e 7578 2d67 6e75 e280 992e  wn-linux-gnu....
│ │ │ │ -00006cc0: 0a0a 2020 382e 2052 6564 4861 7420 4c69  ..  8. RedHat Li
│ │ │ │ -00006cd0: 6e75 7820 382e 300a 0a20 2020 2020 4743  nux 8.0..     GC
│ │ │ │ -00006ce0: 4320 332e 3220 616e 6420 474e 5520 4d61  C 3.2 and GNU Ma
│ │ │ │ -00006cf0: 6b65 2e20 20e2 8098 6936 3836 2d70 632d  ke.  ...i686-pc-
│ │ │ │ -00006d00: 6c69 6e75 782d 676e 75e2 8099 2e0a 0a20  linux-gnu...... 
│ │ │ │ -00006d10: 2039 2e20 5265 6448 6174 2041 6476 616e   9. RedHat Advan
│ │ │ │ -00006d20: 6365 6420 5365 7276 6572 2032 2e31 0a0a  ced Server 2.1..
│ │ │ │ -00006d30: 2020 2020 2047 4343 2032 2e39 3620 616e       GCC 2.96 an
│ │ │ │ -00006d40: 6420 474e 5520 4d61 6b65 2e20 20e2 8098  d GNU Make.  ...
│ │ │ │ -00006d50: 6936 3836 2d70 632d 6c69 6e75 782d 676e  i686-pc-linux-gn
│ │ │ │ -00006d60: 75e2 8099 2e0a 0a20 2031 302e 2053 6c61  u......  10. Sla
│ │ │ │ -00006d70: 636b 7761 7265 204c 696e 7578 2038 2e30  ckware Linux 8.0
│ │ │ │ -00006d80: 2e30 310a 0a20 2020 2020 4743 4320 322e  .01..     GCC 2.
│ │ │ │ -00006d90: 3935 2e33 2061 6e64 2047 4e55 204d 616b  95.3 and GNU Mak
│ │ │ │ -00006da0: 652e 2020 e280 9869 3638 362d 7063 2d6c  e.  ...i686-pc-l
│ │ │ │ -00006db0: 696e 7578 2d67 6e75 e280 992e 0a0a 2020  inux-gnu......  
│ │ │ │ -00006dc0: 3131 2e20 4d61 6e64 7261 6b65 204c 696e  11. Mandrake Lin
│ │ │ │ -00006dd0: 7578 2039 2e30 0a0a 2020 2020 2047 4343  ux 9.0..     GCC
│ │ │ │ -00006de0: 2033 2e32 2061 6e64 2047 4e55 204d 616b   3.2 and GNU Mak
│ │ │ │ -00006df0: 652e 2020 e280 9869 3638 362d 7063 2d6c  e.  ...i686-pc-l
│ │ │ │ -00006e00: 696e 7578 2d67 6e75 e280 992e 0a0a 2020  inux-gnu......  
│ │ │ │ -00006e10: 3132 2e20 4952 4958 2036 2e35 0a0a 2020  12. IRIX 6.5..  
│ │ │ │ -00006e20: 2020 204d 4950 5320 4320 636f 6d70 696c     MIPS C compil
│ │ │ │ -00006e30: 6572 2c20 4952 4958 204d 616b 652e 2020  er, IRIX Make.  
│ │ │ │ -00006e40: e280 986d 6970 732d 7367 692d 6972 6978  ...mips-sgi-irix
│ │ │ │ -00006e50: 362e 35e2 8099 2e0a 0a20 2031 332e 2041  6.5......  13. A
│ │ │ │ -00006e60: 4958 2034 2e33 2e32 0a0a 2020 2020 2049  IX 4.3.2..     I
│ │ │ │ -00006e70: 424d 2043 2066 6f72 2041 4958 2063 6f6d  BM C for AIX com
│ │ │ │ -00006e80: 7069 6c65 722c 2041 4958 204d 616b 652e  piler, AIX Make.
│ │ │ │ -00006e90: 2020 e280 9872 7336 3030 302d 6962 6d2d    ...rs6000-ibm-
│ │ │ │ -00006ea0: 6169 7834 2e33 2e32 2e30 e280 992e 0a0a  aix4.3.2.0......
│ │ │ │ -00006eb0: 2020 3134 2e20 4850 2d55 5820 3131 0a0a    14. HP-UX 11..
│ │ │ │ -00006ec0: 2020 2020 2048 502d 5558 2043 2063 6f6d       HP-UX C com
│ │ │ │ -00006ed0: 7069 6c65 7220 616e 6420 4850 204d 616b  piler and HP Mak
│ │ │ │ -00006ee0: 652e 2020 e280 9869 6136 342d 6870 2d68  e.  ...ia64-hp-h
│ │ │ │ -00006ef0: 7075 7831 312e 3232 e280 992c 0a20 2020  pux11.22...,.   
│ │ │ │ -00006f00: 2020 e280 9868 7070 6132 2e30 772d 6870    ...hppa2.0w-hp
│ │ │ │ -00006f10: 2d68 7075 7831 312e 3131 e280 992e 0a0a  -hpux11.11......
│ │ │ │ -00006f20: 2020 3135 2e20 5355 4e20 536f 6c61 7269    15. SUN Solari
│ │ │ │ -00006f30: 7320 322e 380a 0a20 2020 2020 5375 6e20  s 2.8..     Sun 
│ │ │ │ -00006f40: 576f 726b 5368 6f70 2043 6f6d 7069 6c65  WorkShop Compile
│ │ │ │ -00006f50: 7220 4320 362e 3020 616e 6420 5355 4e20  r C 6.0 and SUN 
│ │ │ │ -00006f60: 4d61 6b65 2e20 20e2 8098 7370 6172 632d  Make.  ...sparc-
│ │ │ │ -00006f70: 7375 6e2d 736f 6c61 7269 7332 2e38 e280  sun-solaris2.8..
│ │ │ │ -00006f80: 992e 0a0a 2020 3136 2e20 4e65 7442 5344  ....  16. NetBSD
│ │ │ │ -00006f90: 2031 2e36 0a0a 2020 2020 2047 4343 2032   1.6..     GCC 2
│ │ │ │ -00006fa0: 2e39 352e 3320 616e 6420 474e 5520 4d61  .95.3 and GNU Ma
│ │ │ │ -00006fb0: 6b65 2e20 20e2 8098 616c 7068 612d 756e  ke.  ...alpha-un
│ │ │ │ -00006fc0: 6b6e 6f77 6e2d 6e65 7462 7364 312e 36e2  known-netbsd1.6.
│ │ │ │ -00006fd0: 8099 2c0a 2020 2020 20e2 8098 6933 3836  ..,.     ...i386
│ │ │ │ -00006fe0: 2d75 6e6b 6e6f 776e 2d6e 6574 6273 6465  -unknown-netbsde
│ │ │ │ -00006ff0: 6c66 312e 36e2 8099 2e0a 0a20 2031 372e  lf1.6......  17.
│ │ │ │ -00007000: 204f 7065 6e42 5344 2033 2e31 2061 6e64   OpenBSD 3.1 and
│ │ │ │ -00007010: 2033 2e32 0a0a 2020 2020 2047 4343 2032   3.2..     GCC 2
│ │ │ │ -00007020: 2e39 352e 3320 616e 6420 474e 5520 4d61  .95.3 and GNU Ma
│ │ │ │ -00007030: 6b65 2e20 20e2 8098 616c 7068 612d 756e  ke.  ...alpha-un
│ │ │ │ -00007040: 6b6e 6f77 6e2d 6f70 656e 6273 6433 2e31  known-openbsd3.1
│ │ │ │ -00007050: e280 992c 0a20 2020 2020 e280 9869 3338  ...,.     ...i38
│ │ │ │ -00007060: 362d 756e 6b6e 6f77 6e2d 6f70 656e 6273  6-unknown-openbs
│ │ │ │ -00007070: 6433 2e31 e280 992e 0a0a 2020 3138 2e20  d3.1......  18. 
│ │ │ │ -00007080: 4672 6565 4253 4420 342e 3720 616e 6420  FreeBSD 4.7 and 
│ │ │ │ -00007090: 342e 380a 0a20 2020 2020 4743 4320 322e  4.8..     GCC 2.
│ │ │ │ -000070a0: 3935 2e34 2061 6e64 2047 4e55 204d 616b  95.4 and GNU Mak
│ │ │ │ -000070b0: 652e 2020 e280 9861 6c70 6861 2d75 6e6b  e.  ...alpha-unk
│ │ │ │ -000070c0: 6e6f 776e 2d66 7265 6562 7364 342e 37e2  nown-freebsd4.7.
│ │ │ │ -000070d0: 8099 2c0a 2020 2020 20e2 8098 616c 7068  ..,.     ...alph
│ │ │ │ -000070e0: 612d 756e 6b6e 6f77 6e2d 6672 6565 6273  a-unknown-freebs
│ │ │ │ -000070f0: 6434 2e38 e280 992c 20e2 8098 6933 3836  d4.8..., ...i386
│ │ │ │ -00007100: 2d75 6e6b 6e6f 776e 2d66 7265 6562 7364  -unknown-freebsd
│ │ │ │ -00007110: 342e 37e2 8099 2c0a 2020 2020 20e2 8098  4.7...,.     ...
│ │ │ │ -00007120: 6933 3836 2d75 6e6b 6e6f 776e 2d66 7265  i386-unknown-fre
│ │ │ │ -00007130: 6562 7364 342e 38e2 8099 2e0a 0a20 2031  ebsd4.8......  1
│ │ │ │ -00007140: 392e 204d 6163 4f53 2058 2031 302e 3220  9. MacOS X 10.2 
│ │ │ │ -00007150: 5365 7276 6572 2045 6469 7469 6f6e 0a0a  Server Edition..
│ │ │ │ -00007160: 2020 2020 2047 4343 2033 2e31 2061 6e64       GCC 3.1 and
│ │ │ │ -00007170: 2047 4e55 204d 616b 652e 2020 e280 9870   GNU Make.  ...p
│ │ │ │ -00007180: 6f77 6572 7063 2d61 7070 6c65 2d64 6172  owerpc-apple-dar
│ │ │ │ -00007190: 7769 6e36 2e35 e280 992e 0a0a 2020 3230  win6.5......  20
│ │ │ │ -000071a0: 2e20 4372 6f73 7320 636f 6d70 696c 6564  . Cross compiled
│ │ │ │ -000071b0: 2074 6f20 7543 6c69 6e75 782f 7543 6c69   to uClinux/uCli
│ │ │ │ -000071c0: 6263 206f 6e20 4d6f 746f 726f 6c61 2043  bc on Motorola C
│ │ │ │ -000071d0: 6f6c 6466 6972 652e 0a0a 2020 2020 2047  oldfire...     G
│ │ │ │ -000071e0: 4343 2033 2e34 2061 6e64 2047 4e55 204d  CC 3.4 and GNU M
│ │ │ │ -000071f0: 616b 6520 e280 986d 3638 6b2d 7563 6c69  ake ...m68k-ucli
│ │ │ │ -00007200: 6e75 782d 656c 66e2 8099 2e0a 0a20 2020  nux-elf......   
│ │ │ │ -00007210: 4966 2079 6f75 2075 7365 2053 6869 7368  If you use Shish
│ │ │ │ -00007220: 6920 6f6e 2c20 6f72 2070 6f72 7420 5368  i on, or port Sh
│ │ │ │ -00007230: 6973 6869 2074 6f2c 2061 206e 6577 2070  ishi to, a new p
│ │ │ │ -00007240: 6c61 7466 6f72 6d20 706c 6561 7365 2072  latform please r
│ │ │ │ -00007250: 6570 6f72 740a 6974 2074 6f20 7468 6520  eport.it to the 
│ │ │ │ -00007260: 6175 7468 6f72 2028 2a6e 6f74 6520 4275  author (*note Bu
│ │ │ │ -00007270: 6720 5265 706f 7274 733a 3a29 2e0a 0a1f  g Reports::)....
│ │ │ │ -00007280: 0a46 696c 653a 2073 6869 7368 692e 696e  .File: shishi.in
│ │ │ │ -00007290: 666f 2c20 204e 6f64 653a 2047 6574 7469  fo,  Node: Getti
│ │ │ │ -000072a0: 6e67 2068 656c 702c 2020 4e65 7874 3a20  ng help,  Next: 
│ │ │ │ -000072b0: 446f 776e 6c6f 6164 696e 6720 616e 6420  Downloading and 
│ │ │ │ -000072c0: 496e 7374 616c 6c69 6e67 2c20 2050 7265  Installing,  Pre
│ │ │ │ -000072d0: 763a 2053 7570 706f 7274 6564 2050 6c61  v: Supported Pla
│ │ │ │ -000072e0: 7466 6f72 6d73 2c20 2055 703a 2049 6e74  tforms,  Up: Int
│ │ │ │ -000072f0: 726f 6475 6374 696f 6e0a 0a31 2e36 2047  roduction..1.6 G
│ │ │ │ -00007300: 6574 7469 6e67 2068 656c 700a 3d3d 3d3d  etting help.====
│ │ │ │ -00007310: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 4120  ============..A 
│ │ │ │ -00007320: 6d61 696c 696e 6720 6c69 7374 2077 6865  mailing list whe
│ │ │ │ -00007330: 7265 2075 7365 7273 206f 6620 5368 6973  re users of Shis
│ │ │ │ -00007340: 6869 206d 6179 2068 656c 7020 6561 6368  hi may help each
│ │ │ │ -00007350: 206f 7468 6572 2065 7869 7374 732c 2061   other exists, a
│ │ │ │ -00007360: 6e64 2079 6f75 0a63 616e 2072 6561 6368  nd you.can reach
│ │ │ │ -00007370: 2069 7420 6279 2073 656e 6469 6e67 2065   it by sending e
│ │ │ │ -00007380: 2d6d 6169 6c20 746f 203c 6865 6c70 2d73  -mail to <help-s
│ │ │ │ -00007390: 6869 7368 6940 676e 752e 6f72 673e 2e20  hishi@gnu.org>. 
│ │ │ │ -000073a0: 2041 7263 6869 7665 7320 6f66 0a74 6865   Archives of.the
│ │ │ │ -000073b0: 206d 6169 6c69 6e67 206c 6973 7420 6469   mailing list di
│ │ │ │ -000073c0: 7363 7573 7369 6f6e 732c 2061 6e64 2061  scussions, and a
│ │ │ │ -000073d0: 6e20 696e 7465 7266 6163 6520 746f 206d  n interface to m
│ │ │ │ -000073e0: 616e 6167 6520 7375 6273 6372 6970 7469  anage subscripti
│ │ │ │ -000073f0: 6f6e 732c 0a69 7320 6176 6169 6c61 626c  ons,.is availabl
│ │ │ │ -00007400: 6520 7468 726f 7567 6820 7468 6520 576f  e through the Wo
│ │ │ │ -00007410: 726c 6420 5769 6465 2057 6562 2061 740a  rld Wide Web at.
│ │ │ │ -00007420: 3c68 7474 703a 2f2f 6c69 7374 732e 676e  <http://lists.gn
│ │ │ │ -00007430: 752e 6f72 672f 6d61 696c 6d61 6e2f 6c69  u.org/mailman/li
│ │ │ │ -00007440: 7374 696e 666f 2f68 656c 702d 7368 6973  stinfo/help-shis
│ │ │ │ -00007450: 6869 3e2e 0a0a 1f0a 4669 6c65 3a20 7368  hi>.....File: sh
│ │ │ │ -00007460: 6973 6869 2e69 6e66 6f2c 2020 4e6f 6465  ishi.info,  Node
│ │ │ │ -00007470: 3a20 446f 776e 6c6f 6164 696e 6720 616e  : Downloading an
│ │ │ │ -00007480: 6420 496e 7374 616c 6c69 6e67 2c20 204e  d Installing,  N
│ │ │ │ -00007490: 6578 743a 2042 7567 2052 6570 6f72 7473  ext: Bug Reports
│ │ │ │ -000074a0: 2c20 2050 7265 763a 2047 6574 7469 6e67  ,  Prev: Getting
│ │ │ │ -000074b0: 2068 656c 702c 2020 5570 3a20 496e 7472   help,  Up: Intr
│ │ │ │ -000074c0: 6f64 7563 7469 6f6e 0a0a 312e 3720 446f  oduction..1.7 Do
│ │ │ │ -000074d0: 776e 6c6f 6164 696e 6720 616e 6420 496e  wnloading and In
│ │ │ │ -000074e0: 7374 616c 6c69 6e67 0a3d 3d3d 3d3d 3d3d  stalling.=======
│ │ │ │ +000066f0: 3d3d 3d3d 0a0a 5368 6973 6869 2068 6173  ====..Shishi has
│ │ │ │ +00006700: 2061 7420 736f 6d65 2070 6f69 6e74 2069   at some point i
│ │ │ │ +00006710: 6e20 7469 6d65 2062 6565 6e20 7465 7374  n time been test
│ │ │ │ +00006720: 6564 206f 6e20 7468 6520 666f 6c6c 6f77  ed on the follow
│ │ │ │ +00006730: 696e 6720 706c 6174 666f 726d 732e 0a4f  ing platforms..O
│ │ │ │ +00006740: 6e6c 696e 6520 6275 696c 6420 7265 706f  nline build repo
│ │ │ │ +00006750: 7274 7320 666f 7220 6561 6368 2070 6c61  rts for each pla
│ │ │ │ +00006760: 7466 6f72 6d73 2061 6e64 2053 6869 7368  tforms and Shish
│ │ │ │ +00006770: 6920 7665 7273 696f 6e20 6973 2061 7661  i version is ava
│ │ │ │ +00006780: 696c 6162 6c65 0a61 7420 3c68 7474 703a  ilable.at <http:
│ │ │ │ +00006790: 2f2f 6175 746f 6275 696c 642e 6a6f 7365  //autobuild.jose
│ │ │ │ +000067a0: 6673 736f 6e2e 6f72 672f 7368 6973 6869  fsson.org/shishi
│ │ │ │ +000067b0: 2f3e 2e0a 0a20 2031 2e20 4465 6269 616e  />...  1. Debian
│ │ │ │ +000067c0: 2047 4e55 2f4c 696e 7578 2033 2e30 2028   GNU/Linux 3.0 (
│ │ │ │ +000067d0: 576f 6f64 7929 0a0a 2020 2020 2047 4343  Woody)..     GCC
│ │ │ │ +000067e0: 2032 2e39 352e 3420 616e 6420 474e 5520   2.95.4 and GNU 
│ │ │ │ +000067f0: 4d61 6b65 2e20 2054 6869 7320 6973 2074  Make.  This is t
│ │ │ │ +00006800: 6865 206d 6169 6e20 6465 7665 6c6f 706d  he main developm
│ │ │ │ +00006810: 656e 7420 706c 6174 666f 726d 2e0a 2020  ent platform..  
│ │ │ │ +00006820: 2020 20e2 8098 616c 7068 6165 7636 372d     ...alphaev67-
│ │ │ │ +00006830: 756e 6b6e 6f77 6e2d 6c69 6e75 782d 676e  unknown-linux-gn
│ │ │ │ +00006840: 75e2 8099 2c20 e280 9861 6c70 6861 6576  u..., ...alphaev
│ │ │ │ +00006850: 362d 756e 6b6e 6f77 6e2d 6c69 6e75 782d  6-unknown-linux-
│ │ │ │ +00006860: 676e 75e2 8099 2c0a 2020 2020 20e2 8098  gnu...,.     ...
│ │ │ │ +00006870: 6172 6d2d 756e 6b6e 6f77 6e2d 6c69 6e75  arm-unknown-linu
│ │ │ │ +00006880: 782d 676e 75e2 8099 2c20 e280 9861 726d  x-gnu..., ...arm
│ │ │ │ +00006890: 7634 6c2d 756e 6b6e 6f77 6e2d 6c69 6e75  v4l-unknown-linu
│ │ │ │ +000068a0: 782d 676e 75e2 8099 2c0a 2020 2020 20e2  x-gnu...,.     .
│ │ │ │ +000068b0: 8098 6870 7061 2d75 6e6b 6e6f 776e 2d6c  ..hppa-unknown-l
│ │ │ │ +000068c0: 696e 7578 2d67 6e75 e280 992c 20e2 8098  inux-gnu..., ...
│ │ │ │ +000068d0: 6870 7061 3634 2d75 6e6b 6e6f 776e 2d6c  hppa64-unknown-l
│ │ │ │ +000068e0: 696e 7578 2d67 6e75 e280 992c 0a20 2020  inux-gnu...,.   
│ │ │ │ +000068f0: 2020 e280 9869 3638 362d 7063 2d6c 696e    ...i686-pc-lin
│ │ │ │ +00006900: 7578 2d67 6e75 e280 992c 20e2 8098 6961  ux-gnu..., ...ia
│ │ │ │ +00006910: 3634 2d75 6e6b 6e6f 776e 2d6c 696e 7578  64-unknown-linux
│ │ │ │ +00006920: 2d67 6e75 e280 992c 0a20 2020 2020 e280  -gnu...,.     ..
│ │ │ │ +00006930: 986d 3638 6b2d 756e 6b6e 6f77 6e2d 6c69  .m68k-unknown-li
│ │ │ │ +00006940: 6e75 782d 676e 75e2 8099 2c20 e280 986d  nux-gnu..., ...m
│ │ │ │ +00006950: 6970 732d 756e 6b6e 6f77 6e2d 6c69 6e75  ips-unknown-linu
│ │ │ │ +00006960: 782d 676e 75e2 8099 2c0a 2020 2020 20e2  x-gnu...,.     .
│ │ │ │ +00006970: 8098 6d69 7073 656c 2d75 6e6b 6e6f 776e  ..mipsel-unknown
│ │ │ │ +00006980: 2d6c 696e 7578 2d67 6e75 e280 992c 20e2  -linux-gnu..., .
│ │ │ │ +00006990: 8098 706f 7765 7270 632d 756e 6b6e 6f77  ..powerpc-unknow
│ │ │ │ +000069a0: 6e2d 6c69 6e75 782d 676e 75e2 8099 2c0a  n-linux-gnu...,.
│ │ │ │ +000069b0: 2020 2020 20e2 8098 7333 3930 2d69 626d       ...s390-ibm
│ │ │ │ +000069c0: 2d6c 696e 7578 2d67 6e75 e280 992c 20e2  -linux-gnu..., .
│ │ │ │ +000069d0: 8098 7370 6172 632d 756e 6b6e 6f77 6e2d  ..sparc-unknown-
│ │ │ │ +000069e0: 6c69 6e75 782d 676e 75e2 8099 2c0a 2020  linux-gnu...,.  
│ │ │ │ +000069f0: 2020 20e2 8098 7370 6172 6336 342d 756e     ...sparc64-un
│ │ │ │ +00006a00: 6b6e 6f77 6e2d 6c69 6e75 782d 676e 75e2  known-linux-gnu.
│ │ │ │ +00006a10: 8099 2e0a 0a20 2032 2e20 4465 6269 616e  .....  2. Debian
│ │ │ │ +00006a20: 2047 4e55 2f4c 696e 7578 2032 2e31 0a0a   GNU/Linux 2.1..
│ │ │ │ +00006a30: 2020 2020 2047 4343 2032 2e39 352e 3420       GCC 2.95.4 
│ │ │ │ +00006a40: 616e 6420 474e 5520 4d61 6b65 2e20 20e2  and GNU Make.  .
│ │ │ │ +00006a50: 8098 6172 6d76 346c 2d75 6e6b 6e6f 776e  ..armv4l-unknown
│ │ │ │ +00006a60: 2d6c 696e 7578 2d67 6e75 e280 992e 0a0a  -linux-gnu......
│ │ │ │ +00006a70: 2020 332e 2054 7275 3634 2055 4e49 580a    3. Tru64 UNIX.
│ │ │ │ +00006a80: 0a20 2020 2020 5472 7536 3420 554e 4958  .     Tru64 UNIX
│ │ │ │ +00006a90: 2043 2063 6f6d 7069 6c65 7220 616e 6420   C compiler and 
│ │ │ │ +00006aa0: 5472 7536 3420 4d61 6b65 2e20 20e2 8098  Tru64 Make.  ...
│ │ │ │ +00006ab0: 616c 7068 6165 7636 372d 6465 632d 6f73  alphaev67-dec-os
│ │ │ │ +00006ac0: 6635 2e31 e280 992c 0a20 2020 2020 e280  f5.1...,.     ..
│ │ │ │ +00006ad0: 9861 6c70 6861 6576 3638 2d64 6563 2d6f  .alphaev68-dec-o
│ │ │ │ +00006ae0: 7366 352e 31e2 8099 2e0a 0a20 2034 2e20  sf5.1......  4. 
│ │ │ │ +00006af0: 5375 5345 204c 696e 7578 2037 2e31 0a0a  SuSE Linux 7.1..
│ │ │ │ +00006b00: 2020 2020 2047 4343 2032 2e39 3620 616e       GCC 2.96 an
│ │ │ │ +00006b10: 6420 474e 5520 4d61 6b65 2e20 20e2 8098  d GNU Make.  ...
│ │ │ │ +00006b20: 616c 7068 6165 7636 2d75 6e6b 6e6f 776e  alphaev6-unknown
│ │ │ │ +00006b30: 2d6c 696e 7578 2d67 6e75 e280 992c 0a20  -linux-gnu...,. 
│ │ │ │ +00006b40: 2020 2020 e280 9861 6c70 6861 6576 3637      ...alphaev67
│ │ │ │ +00006b50: 2d75 6e6b 6e6f 776e 2d6c 696e 7578 2d67  -unknown-linux-g
│ │ │ │ +00006b60: 6e75 e280 992e 0a0a 2020 352e 2053 7553  nu......  5. SuS
│ │ │ │ +00006b70: 4520 4c69 6e75 7820 372e 3261 0a0a 2020  E Linux 7.2a..  
│ │ │ │ +00006b80: 2020 2047 4343 2033 2e30 2061 6e64 2047     GCC 3.0 and G
│ │ │ │ +00006b90: 4e55 204d 616b 652e 2020 e280 9869 6136  NU Make.  ...ia6
│ │ │ │ +00006ba0: 342d 756e 6b6e 6f77 6e2d 6c69 6e75 782d  4-unknown-linux-
│ │ │ │ +00006bb0: 676e 75e2 8099 2e0a 0a20 2036 2e20 5375  gnu......  6. Su
│ │ │ │ +00006bc0: 5345 204c 696e 7578 0a0a 2020 2020 2047  SE Linux..     G
│ │ │ │ +00006bd0: 4343 2033 2e32 2e32 2061 6e64 2047 4e55  CC 3.2.2 and GNU
│ │ │ │ +00006be0: 204d 616b 652e 2020 e280 9878 3836 5f36   Make.  ...x86_6
│ │ │ │ +00006bf0: 342d 756e 6b6e 6f77 6e2d 6c69 6e75 782d  4-unknown-linux-
│ │ │ │ +00006c00: 676e 75e2 8099 2028 414d 4436 3420 4f70  gnu... (AMD64 Op
│ │ │ │ +00006c10: 7465 726f 6e0a 2020 2020 2022 4d65 6c6f  teron.     "Melo
│ │ │ │ +00006c20: 6479 2229 2e0a 0a20 2037 2e20 5265 6448  dy")...  7. RedH
│ │ │ │ +00006c30: 6174 204c 696e 7578 2037 2e32 0a0a 2020  at Linux 7.2..  
│ │ │ │ +00006c40: 2020 2047 4343 2032 2e39 3620 616e 6420     GCC 2.96 and 
│ │ │ │ +00006c50: 474e 5520 4d61 6b65 2e20 20e2 8098 616c  GNU Make.  ...al
│ │ │ │ +00006c60: 7068 6165 7636 2d75 6e6b 6e6f 776e 2d6c  phaev6-unknown-l
│ │ │ │ +00006c70: 696e 7578 2d67 6e75 e280 992c 0a20 2020  inux-gnu...,.   
│ │ │ │ +00006c80: 2020 e280 9861 6c70 6861 6576 3637 2d75    ...alphaev67-u
│ │ │ │ +00006c90: 6e6b 6e6f 776e 2d6c 696e 7578 2d67 6e75  nknown-linux-gnu
│ │ │ │ +00006ca0: e280 992c 20e2 8098 6961 3634 2d75 6e6b  ..., ...ia64-unk
│ │ │ │ +00006cb0: 6e6f 776e 2d6c 696e 7578 2d67 6e75 e280  nown-linux-gnu..
│ │ │ │ +00006cc0: 992e 0a0a 2020 382e 2052 6564 4861 7420  ....  8. RedHat 
│ │ │ │ +00006cd0: 4c69 6e75 7820 382e 300a 0a20 2020 2020  Linux 8.0..     
│ │ │ │ +00006ce0: 4743 4320 332e 3220 616e 6420 474e 5520  GCC 3.2 and GNU 
│ │ │ │ +00006cf0: 4d61 6b65 2e20 20e2 8098 6936 3836 2d70  Make.  ...i686-p
│ │ │ │ +00006d00: 632d 6c69 6e75 782d 676e 75e2 8099 2e0a  c-linux-gnu.....
│ │ │ │ +00006d10: 0a20 2039 2e20 5265 6448 6174 2041 6476  .  9. RedHat Adv
│ │ │ │ +00006d20: 616e 6365 6420 5365 7276 6572 2032 2e31  anced Server 2.1
│ │ │ │ +00006d30: 0a0a 2020 2020 2047 4343 2032 2e39 3620  ..     GCC 2.96 
│ │ │ │ +00006d40: 616e 6420 474e 5520 4d61 6b65 2e20 20e2  and GNU Make.  .
│ │ │ │ +00006d50: 8098 6936 3836 2d70 632d 6c69 6e75 782d  ..i686-pc-linux-
│ │ │ │ +00006d60: 676e 75e2 8099 2e0a 0a20 2031 302e 2053  gnu......  10. S
│ │ │ │ +00006d70: 6c61 636b 7761 7265 204c 696e 7578 2038  lackware Linux 8
│ │ │ │ +00006d80: 2e30 2e30 310a 0a20 2020 2020 4743 4320  .0.01..     GCC 
│ │ │ │ +00006d90: 322e 3935 2e33 2061 6e64 2047 4e55 204d  2.95.3 and GNU M
│ │ │ │ +00006da0: 616b 652e 2020 e280 9869 3638 362d 7063  ake.  ...i686-pc
│ │ │ │ +00006db0: 2d6c 696e 7578 2d67 6e75 e280 992e 0a0a  -linux-gnu......
│ │ │ │ +00006dc0: 2020 3131 2e20 4d61 6e64 7261 6b65 204c    11. Mandrake L
│ │ │ │ +00006dd0: 696e 7578 2039 2e30 0a0a 2020 2020 2047  inux 9.0..     G
│ │ │ │ +00006de0: 4343 2033 2e32 2061 6e64 2047 4e55 204d  CC 3.2 and GNU M
│ │ │ │ +00006df0: 616b 652e 2020 e280 9869 3638 362d 7063  ake.  ...i686-pc
│ │ │ │ +00006e00: 2d6c 696e 7578 2d67 6e75 e280 992e 0a0a  -linux-gnu......
│ │ │ │ +00006e10: 2020 3132 2e20 4952 4958 2036 2e35 0a0a    12. IRIX 6.5..
│ │ │ │ +00006e20: 2020 2020 204d 4950 5320 4320 636f 6d70       MIPS C comp
│ │ │ │ +00006e30: 696c 6572 2c20 4952 4958 204d 616b 652e  iler, IRIX Make.
│ │ │ │ +00006e40: 2020 e280 986d 6970 732d 7367 692d 6972    ...mips-sgi-ir
│ │ │ │ +00006e50: 6978 362e 35e2 8099 2e0a 0a20 2031 332e  ix6.5......  13.
│ │ │ │ +00006e60: 2041 4958 2034 2e33 2e32 0a0a 2020 2020   AIX 4.3.2..    
│ │ │ │ +00006e70: 2049 424d 2043 2066 6f72 2041 4958 2063   IBM C for AIX c
│ │ │ │ +00006e80: 6f6d 7069 6c65 722c 2041 4958 204d 616b  ompiler, AIX Mak
│ │ │ │ +00006e90: 652e 2020 e280 9872 7336 3030 302d 6962  e.  ...rs6000-ib
│ │ │ │ +00006ea0: 6d2d 6169 7834 2e33 2e32 2e30 e280 992e  m-aix4.3.2.0....
│ │ │ │ +00006eb0: 0a0a 2020 3134 2e20 4850 2d55 5820 3131  ..  14. HP-UX 11
│ │ │ │ +00006ec0: 0a0a 2020 2020 2048 502d 5558 2043 2063  ..     HP-UX C c
│ │ │ │ +00006ed0: 6f6d 7069 6c65 7220 616e 6420 4850 204d  ompiler and HP M
│ │ │ │ +00006ee0: 616b 652e 2020 e280 9869 6136 342d 6870  ake.  ...ia64-hp
│ │ │ │ +00006ef0: 2d68 7075 7831 312e 3232 e280 992c 0a20  -hpux11.22...,. 
│ │ │ │ +00006f00: 2020 2020 e280 9868 7070 6132 2e30 772d      ...hppa2.0w-
│ │ │ │ +00006f10: 6870 2d68 7075 7831 312e 3131 e280 992e  hp-hpux11.11....
│ │ │ │ +00006f20: 0a0a 2020 3135 2e20 5355 4e20 536f 6c61  ..  15. SUN Sola
│ │ │ │ +00006f30: 7269 7320 322e 380a 0a20 2020 2020 5375  ris 2.8..     Su
│ │ │ │ +00006f40: 6e20 576f 726b 5368 6f70 2043 6f6d 7069  n WorkShop Compi
│ │ │ │ +00006f50: 6c65 7220 4320 362e 3020 616e 6420 5355  ler C 6.0 and SU
│ │ │ │ +00006f60: 4e20 4d61 6b65 2e20 20e2 8098 7370 6172  N Make.  ...spar
│ │ │ │ +00006f70: 632d 7375 6e2d 736f 6c61 7269 7332 2e38  c-sun-solaris2.8
│ │ │ │ +00006f80: e280 992e 0a0a 2020 3136 2e20 4e65 7442  ......  16. NetB
│ │ │ │ +00006f90: 5344 2031 2e36 0a0a 2020 2020 2047 4343  SD 1.6..     GCC
│ │ │ │ +00006fa0: 2032 2e39 352e 3320 616e 6420 474e 5520   2.95.3 and GNU 
│ │ │ │ +00006fb0: 4d61 6b65 2e20 20e2 8098 616c 7068 612d  Make.  ...alpha-
│ │ │ │ +00006fc0: 756e 6b6e 6f77 6e2d 6e65 7462 7364 312e  unknown-netbsd1.
│ │ │ │ +00006fd0: 36e2 8099 2c0a 2020 2020 20e2 8098 6933  6...,.     ...i3
│ │ │ │ +00006fe0: 3836 2d75 6e6b 6e6f 776e 2d6e 6574 6273  86-unknown-netbs
│ │ │ │ +00006ff0: 6465 6c66 312e 36e2 8099 2e0a 0a20 2031  delf1.6......  1
│ │ │ │ +00007000: 372e 204f 7065 6e42 5344 2033 2e31 2061  7. OpenBSD 3.1 a
│ │ │ │ +00007010: 6e64 2033 2e32 0a0a 2020 2020 2047 4343  nd 3.2..     GCC
│ │ │ │ +00007020: 2032 2e39 352e 3320 616e 6420 474e 5520   2.95.3 and GNU 
│ │ │ │ +00007030: 4d61 6b65 2e20 20e2 8098 616c 7068 612d  Make.  ...alpha-
│ │ │ │ +00007040: 756e 6b6e 6f77 6e2d 6f70 656e 6273 6433  unknown-openbsd3
│ │ │ │ +00007050: 2e31 e280 992c 0a20 2020 2020 e280 9869  .1...,.     ...i
│ │ │ │ +00007060: 3338 362d 756e 6b6e 6f77 6e2d 6f70 656e  386-unknown-open
│ │ │ │ +00007070: 6273 6433 2e31 e280 992e 0a0a 2020 3138  bsd3.1......  18
│ │ │ │ +00007080: 2e20 4672 6565 4253 4420 342e 3720 616e  . FreeBSD 4.7 an
│ │ │ │ +00007090: 6420 342e 380a 0a20 2020 2020 4743 4320  d 4.8..     GCC 
│ │ │ │ +000070a0: 322e 3935 2e34 2061 6e64 2047 4e55 204d  2.95.4 and GNU M
│ │ │ │ +000070b0: 616b 652e 2020 e280 9861 6c70 6861 2d75  ake.  ...alpha-u
│ │ │ │ +000070c0: 6e6b 6e6f 776e 2d66 7265 6562 7364 342e  nknown-freebsd4.
│ │ │ │ +000070d0: 37e2 8099 2c0a 2020 2020 20e2 8098 616c  7...,.     ...al
│ │ │ │ +000070e0: 7068 612d 756e 6b6e 6f77 6e2d 6672 6565  pha-unknown-free
│ │ │ │ +000070f0: 6273 6434 2e38 e280 992c 20e2 8098 6933  bsd4.8..., ...i3
│ │ │ │ +00007100: 3836 2d75 6e6b 6e6f 776e 2d66 7265 6562  86-unknown-freeb
│ │ │ │ +00007110: 7364 342e 37e2 8099 2c0a 2020 2020 20e2  sd4.7...,.     .
│ │ │ │ +00007120: 8098 6933 3836 2d75 6e6b 6e6f 776e 2d66  ..i386-unknown-f
│ │ │ │ +00007130: 7265 6562 7364 342e 38e2 8099 2e0a 0a20  reebsd4.8...... 
│ │ │ │ +00007140: 2031 392e 204d 6163 4f53 2058 2031 302e   19. MacOS X 10.
│ │ │ │ +00007150: 3220 5365 7276 6572 2045 6469 7469 6f6e  2 Server Edition
│ │ │ │ +00007160: 0a0a 2020 2020 2047 4343 2033 2e31 2061  ..     GCC 3.1 a
│ │ │ │ +00007170: 6e64 2047 4e55 204d 616b 652e 2020 e280  nd GNU Make.  ..
│ │ │ │ +00007180: 9870 6f77 6572 7063 2d61 7070 6c65 2d64  .powerpc-apple-d
│ │ │ │ +00007190: 6172 7769 6e36 2e35 e280 992e 0a0a 2020  arwin6.5......  
│ │ │ │ +000071a0: 3230 2e20 4372 6f73 7320 636f 6d70 696c  20. Cross compil
│ │ │ │ +000071b0: 6564 2074 6f20 7543 6c69 6e75 782f 7543  ed to uClinux/uC
│ │ │ │ +000071c0: 6c69 6263 206f 6e20 4d6f 746f 726f 6c61  libc on Motorola
│ │ │ │ +000071d0: 2043 6f6c 6466 6972 652e 0a0a 2020 2020   Coldfire...    
│ │ │ │ +000071e0: 2047 4343 2033 2e34 2061 6e64 2047 4e55   GCC 3.4 and GNU
│ │ │ │ +000071f0: 204d 616b 6520 e280 986d 3638 6b2d 7563   Make ...m68k-uc
│ │ │ │ +00007200: 6c69 6e75 782d 656c 66e2 8099 2e0a 0a20  linux-elf...... 
│ │ │ │ +00007210: 2020 4966 2079 6f75 2075 7365 2053 6869    If you use Shi
│ │ │ │ +00007220: 7368 6920 6f6e 2c20 6f72 2070 6f72 7420  shi on, or port 
│ │ │ │ +00007230: 5368 6973 6869 2074 6f2c 2061 206e 6577  Shishi to, a new
│ │ │ │ +00007240: 2070 6c61 7466 6f72 6d20 706c 6561 7365   platform please
│ │ │ │ +00007250: 2072 6570 6f72 740a 6974 2074 6f20 7468   report.it to th
│ │ │ │ +00007260: 6520 6175 7468 6f72 2028 2a6e 6f74 6520  e author (*note 
│ │ │ │ +00007270: 4275 6720 5265 706f 7274 733a 3a29 2e0a  Bug Reports::)..
│ │ │ │ +00007280: 0a1f 0a46 696c 653a 2073 6869 7368 692e  ...File: shishi.
│ │ │ │ +00007290: 696e 666f 2c20 204e 6f64 653a 2047 6574  info,  Node: Get
│ │ │ │ +000072a0: 7469 6e67 2068 656c 702c 2020 4e65 7874  ting help,  Next
│ │ │ │ +000072b0: 3a20 446f 776e 6c6f 6164 696e 6720 616e  : Downloading an
│ │ │ │ +000072c0: 6420 496e 7374 616c 6c69 6e67 2c20 2050  d Installing,  P
│ │ │ │ +000072d0: 7265 763a 2053 7570 706f 7274 6564 2050  rev: Supported P
│ │ │ │ +000072e0: 6c61 7466 6f72 6d73 2c20 2055 703a 2049  latforms,  Up: I
│ │ │ │ +000072f0: 6e74 726f 6475 6374 696f 6e0a 0a31 2e36  ntroduction..1.6
│ │ │ │ +00007300: 2047 6574 7469 6e67 2068 656c 700a 3d3d   Getting help.==
│ │ │ │ +00007310: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a  ==============..
│ │ │ │ +00007320: 4120 6d61 696c 696e 6720 6c69 7374 2077  A mailing list w
│ │ │ │ +00007330: 6865 7265 2075 7365 7273 206f 6620 5368  here users of Sh
│ │ │ │ +00007340: 6973 6869 206d 6179 2068 656c 7020 6561  ishi may help ea
│ │ │ │ +00007350: 6368 206f 7468 6572 2065 7869 7374 732c  ch other exists,
│ │ │ │ +00007360: 2061 6e64 2079 6f75 0a63 616e 2072 6561   and you.can rea
│ │ │ │ +00007370: 6368 2069 7420 6279 2073 656e 6469 6e67  ch it by sending
│ │ │ │ +00007380: 2065 2d6d 6169 6c20 746f 203c 6865 6c70   e-mail to <help
│ │ │ │ +00007390: 2d73 6869 7368 6940 676e 752e 6f72 673e  -shishi@gnu.org>
│ │ │ │ +000073a0: 2e20 2041 7263 6869 7665 7320 6f66 0a74  .  Archives of.t
│ │ │ │ +000073b0: 6865 206d 6169 6c69 6e67 206c 6973 7420  he mailing list 
│ │ │ │ +000073c0: 6469 7363 7573 7369 6f6e 732c 2061 6e64  discussions, and
│ │ │ │ +000073d0: 2061 6e20 696e 7465 7266 6163 6520 746f   an interface to
│ │ │ │ +000073e0: 206d 616e 6167 6520 7375 6273 6372 6970   manage subscrip
│ │ │ │ +000073f0: 7469 6f6e 732c 0a69 7320 6176 6169 6c61  tions,.is availa
│ │ │ │ +00007400: 626c 6520 7468 726f 7567 6820 7468 6520  ble through the 
│ │ │ │ +00007410: 576f 726c 6420 5769 6465 2057 6562 2061  World Wide Web a
│ │ │ │ +00007420: 740a 3c68 7474 703a 2f2f 6c69 7374 732e  t.<http://lists.
│ │ │ │ +00007430: 676e 752e 6f72 672f 6d61 696c 6d61 6e2f  gnu.org/mailman/
│ │ │ │ +00007440: 6c69 7374 696e 666f 2f68 656c 702d 7368  listinfo/help-sh
│ │ │ │ +00007450: 6973 6869 3e2e 0a0a 1f0a 4669 6c65 3a20  ishi>.....File: 
│ │ │ │ +00007460: 7368 6973 6869 2e69 6e66 6f2c 2020 4e6f  shishi.info,  No
│ │ │ │ +00007470: 6465 3a20 446f 776e 6c6f 6164 696e 6720  de: Downloading 
│ │ │ │ +00007480: 616e 6420 496e 7374 616c 6c69 6e67 2c20  and Installing, 
│ │ │ │ +00007490: 204e 6578 743a 2042 7567 2052 6570 6f72   Next: Bug Repor
│ │ │ │ +000074a0: 7473 2c20 2050 7265 763a 2047 6574 7469  ts,  Prev: Getti
│ │ │ │ +000074b0: 6e67 2068 656c 702c 2020 5570 3a20 496e  ng help,  Up: In
│ │ │ │ +000074c0: 7472 6f64 7563 7469 6f6e 0a0a 312e 3720  troduction..1.7 
│ │ │ │ +000074d0: 446f 776e 6c6f 6164 696e 6720 616e 6420  Downloading and 
│ │ │ │ +000074e0: 496e 7374 616c 6c69 6e67 0a3d 3d3d 3d3d  Installing.=====
│ │ │ │  000074f0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ -00007500: 3d3d 3d3d 3d3d 3d0a 0a54 6865 2070 6163  =======..The pac
│ │ │ │ -00007510: 6b61 6765 2063 616e 2062 6520 646f 776e  kage can be down
│ │ │ │ -00007520: 6c6f 6164 6564 2066 726f 6d20 7365 7665  loaded from seve
│ │ │ │ -00007530: 7261 6c20 706c 6163 6573 2c20 696e 636c  ral places, incl
│ │ │ │ -00007540: 7564 696e 673a 0a0a 2020 203c 6674 703a  uding:..   <ftp:
│ │ │ │ -00007550: 2f2f 616c 7068 612e 676e 752e 6f72 672f  //alpha.gnu.org/
│ │ │ │ -00007560: 7075 622f 676e 752f 7368 6973 6869 2f3e  pub/gnu/shishi/>
│ │ │ │ -00007570: 0a0a 2020 2054 6865 206c 6174 6573 7420  ..   The latest 
│ │ │ │ -00007580: 7665 7273 696f 6e20 6973 2073 746f 7265  version is store
│ │ │ │ -00007590: 6420 696e 2061 2066 696c 652c 2065 2e67  d in a file, e.g
│ │ │ │ -000075a0: 2e2c 20e2 8098 7368 6973 6869 2d31 2e30  ., ...shishi-1.0
│ │ │ │ -000075b0: 2e33 2e74 6172 2e67 7ae2 8099 0a77 6865  .3.tar.gz....whe
│ │ │ │ -000075c0: 7265 2074 6865 20e2 8098 312e 302e 33e2  re the ...1.0.3.
│ │ │ │ -000075d0: 8099 2069 6e64 6963 6174 6520 7468 6520  .. indicate the 
│ │ │ │ -000075e0: 6869 6768 6573 7420 7665 7273 696f 6e20  highest version 
│ │ │ │ -000075f0: 6e75 6d62 6572 2e0a 0a20 2020 5468 6520  number...   The 
│ │ │ │ -00007600: 7061 636b 6167 6520 6973 2074 6865 6e20  package is then 
│ │ │ │ -00007610: 6578 7472 6163 7465 642c 2063 6f6e 6669  extracted, confi
│ │ │ │ -00007620: 6775 7265 6420 616e 6420 6275 696c 7420  gured and built 
│ │ │ │ -00007630: 6c69 6b65 206d 616e 7920 6f74 6865 720a  like many other.
│ │ │ │ -00007640: 7061 636b 6167 6573 2074 6861 7420 7573  packages that us
│ │ │ │ -00007650: 6520 4175 746f 636f 6e66 2e20 2046 6f72  e Autoconf.  For
│ │ │ │ -00007660: 2064 6574 6169 6c65 6420 696e 666f 726d   detailed inform
│ │ │ │ -00007670: 6174 696f 6e20 6f6e 2063 6f6e 6669 6775  ation on configu
│ │ │ │ -00007680: 7269 6e67 2061 6e64 0a62 7569 6c64 696e  ring and.buildin
│ │ │ │ -00007690: 6720 6974 2c20 7265 6665 7220 746f 2074  g it, refer to t
│ │ │ │ -000076a0: 6865 20e2 8098 494e 5354 414c 4ce2 8099  he ...INSTALL...
│ │ │ │ -000076b0: 2066 696c 6520 7468 6174 2069 7320 7061   file that is pa
│ │ │ │ -000076c0: 7274 206f 6620 7468 650a 6469 7374 7269  rt of the.distri
│ │ │ │ -000076d0: 6275 7469 6f6e 2061 7263 6869 7665 2e0a  bution archive..
│ │ │ │ -000076e0: 0a20 2020 4865 7265 2069 7320 616e 2065  .   Here is an e
│ │ │ │ -000076f0: 7861 6d70 6c65 2074 6572 6d69 6e61 6c20  xample terminal 
│ │ │ │ -00007700: 7365 7373 696f 6e20 7468 6174 2064 6f77  session that dow
│ │ │ │ -00007710: 6e6c 6f61 642c 2063 6f6e 6669 6775 7265  nload, configure
│ │ │ │ -00007720: 2c20 6275 696c 640a 616e 6420 696e 7374  , build.and inst
│ │ │ │ -00007730: 616c 6c20 7468 6520 7061 636b 6167 652e  all the package.
│ │ │ │ -00007740: 2020 596f 7520 7769 6c6c 206e 6565 6420    You will need 
│ │ │ │ -00007750: 6120 6665 7720 6261 7369 6320 746f 6f6c  a few basic tool
│ │ │ │ -00007760: 732c 2073 7563 6820 6173 20e2 8098 7368  s, such as ...sh
│ │ │ │ -00007770: e280 992c 0ae2 8098 6d61 6b65 e280 9920  ...,....make... 
│ │ │ │ -00007780: 616e 6420 e280 9863 63e2 8099 2e0a 0a20  and ...cc...... 
│ │ │ │ -00007790: 2020 2020 2420 7767 6574 202d 7120 6674      $ wget -q ft
│ │ │ │ -000077a0: 703a 2f2f 616c 7068 612e 676e 752e 6f72  p://alpha.gnu.or
│ │ │ │ -000077b0: 672f 7075 622f 676e 752f 7368 6973 6869  g/pub/gnu/shishi
│ │ │ │ -000077c0: 2f73 6869 7368 692d 312e 302e 332e 7461  /shishi-1.0.3.ta
│ │ │ │ -000077d0: 722e 677a 0a20 2020 2020 2420 7461 7220  r.gz.     $ tar 
│ │ │ │ -000077e0: 7866 7a20 7368 6973 6869 2d31 2e30 2e33  xfz shishi-1.0.3
│ │ │ │ -000077f0: 2e74 6172 2e67 7a0a 2020 2020 2024 2063  .tar.gz.     $ c
│ │ │ │ -00007800: 6420 7368 6973 6869 2d31 2e30 2e33 2f0a  d shishi-1.0.3/.
│ │ │ │ -00007810: 2020 2020 2024 202e 2f63 6f6e 6669 6775       $ ./configu
│ │ │ │ -00007820: 7265 0a20 2020 2020 2e2e 2e0a 2020 2020  re.     ....    
│ │ │ │ -00007830: 2024 206d 616b 650a 2020 2020 202e 2e2e   $ make.     ...
│ │ │ │ -00007840: 0a20 2020 2020 2420 6d61 6b65 2069 6e73  .     $ make ins
│ │ │ │ -00007850: 7461 6c6c 0a20 2020 2020 2e2e 2e0a 0a20  tall.     ..... 
│ │ │ │ -00007860: 2020 4166 7465 7220 7468 6973 2079 6f75    After this you
│ │ │ │ -00007870: 2073 686f 756c 6420 6265 2070 7265 7061   should be prepa
│ │ │ │ -00007880: 7265 6420 746f 2063 6f6e 7469 6e75 6520  red to continue 
│ │ │ │ -00007890: 7769 7468 2074 6865 2075 7365 722c 0a61  with the user,.a
│ │ │ │ -000078a0: 646d 696e 6973 7472 6174 696f 6e20 6f72  dministration or
│ │ │ │ -000078b0: 2070 726f 6772 616d 6d69 6e67 206d 616e   programming man
│ │ │ │ -000078c0: 7561 6c2c 2064 6570 656e 6469 6e67 206f  ual, depending o
│ │ │ │ -000078d0: 6e20 686f 7720 796f 7520 7761 6e74 2074  n how you want t
│ │ │ │ -000078e0: 6f20 7573 650a 5368 6973 6869 2e0a 0a20  o use.Shishi... 
│ │ │ │ -000078f0: 2020 4120 6665 7720 e280 9863 6f6e 6669    A few ...confi
│ │ │ │ -00007900: 6775 7265 e280 9920 6f70 7469 6f6e 7320  gure... options 
│ │ │ │ -00007910: 6d61 7920 6265 2072 656c 6576 616e 742c  may be relevant,
│ │ │ │ -00007920: 2073 756d 6d61 7269 7a65 6420 696e 2074   summarized in t
│ │ │ │ -00007930: 6865 2074 6162 6c65 2e0a 0ae2 8098 2d2d  he table......--
│ │ │ │ -00007940: 6469 7361 626c 652d 6465 73e2 8099 0ae2  disable-des.....
│ │ │ │ -00007950: 8098 2d2d 6469 7361 626c 652d 3364 6573  ..--disable-3des
│ │ │ │ -00007960: e280 990a e280 982d 2d64 6973 6162 6c65  .......--disable
│ │ │ │ -00007970: 2d61 6573 e280 990a e280 982d 2d64 6973  -aes.......--dis
│ │ │ │ -00007980: 6162 6c65 2d6d 64e2 8099 0ae2 8098 2d2d  able-md.......--
│ │ │ │ -00007990: 6469 7361 626c 652d 6e75 6c6c e280 990a  disable-null....
│ │ │ │ -000079a0: e280 982d 2d64 6973 6162 6c65 2d61 7263  ...--disable-arc
│ │ │ │ -000079b0: 666f 7572 e280 990a 2020 2020 2044 6973  four....     Dis
│ │ │ │ -000079c0: 6162 6c65 2061 2063 7279 7074 6f67 7261  able a cryptogra
│ │ │ │ -000079d0: 7068 6963 2061 6c67 6f72 6974 686d 2061  phic algorithm a
│ │ │ │ -000079e0: 7420 636f 6d70 696c 6520 7469 6d65 2e20  t compile time. 
│ │ │ │ -000079f0: 2055 7375 616c 6c79 2069 7420 6973 0a20   Usually it is. 
│ │ │ │ -00007a00: 2020 2020 6265 7474 6572 2074 6f20 6469      better to di
│ │ │ │ -00007a10: 7361 626c 6520 616c 676f 7269 7468 6d73  sable algorithms
│ │ │ │ -00007a20: 2064 7572 696e 6720 7275 6e2d 7469 6d65   during run-time
│ │ │ │ -00007a30: 2077 6974 6820 7468 6520 636f 6e66 6967   with the config
│ │ │ │ -00007a40: 7572 6174 696f 6e0a 2020 2020 2066 696c  uration.     fil
│ │ │ │ -00007a50: 652c 2062 7574 2074 6869 7320 616c 6c6f  e, but this allo
│ │ │ │ -00007a60: 7773 2079 6f75 2074 6f20 7265 6475 6365  ws you to reduce
│ │ │ │ -00007a70: 2074 6865 2063 6f64 6520 7369 7a65 2073   the code size s
│ │ │ │ -00007a80: 6c69 6768 746c 792e 0a0a e280 982d 2d64  lightly......--d
│ │ │ │ -00007a90: 6973 6162 6c65 2d73 7461 7274 746c 73e2  isable-starttls.
│ │ │ │ -00007aa0: 8099 0a20 2020 2020 4469 7361 626c 6520  ...     Disable 
│ │ │ │ -00007ab0: 7468 6520 6578 7065 7269 6d65 6e74 616c  the experimental
│ │ │ │ -00007ac0: 2054 4c53 2073 7570 706f 7274 2066 6f72   TLS support for
│ │ │ │ -00007ad0: 204b 4443 2063 6f6e 6e65 6374 696f 6e73   KDC connections
│ │ │ │ -00007ae0: 2e20 2049 6620 796f 750a 2020 2020 2064  .  If you.     d
│ │ │ │ -00007af0: 6f20 6e6f 7420 7573 6520 6120 5368 6973  o not use a Shis
│ │ │ │ -00007b00: 6869 204b 4443 2c20 7468 6973 2073 7570  hi KDC, this sup
│ │ │ │ -00007b10: 706f 7274 2069 7320 6f66 206e 6f20 7573  port is of no us
│ │ │ │ -00007b20: 6520 736f 2079 6f75 2063 6f75 6c64 0a20  e so you could. 
│ │ │ │ -00007b30: 2020 2020 7361 6665 6c79 2064 6973 6162      safely disab
│ │ │ │ -00007b40: 6c65 2069 742e 0a0a e280 982d 2d77 6974  le it......--wit
│ │ │ │ -00007b50: 686f 7574 2d73 7472 696e 6770 7265 70e2  hout-stringprep.
│ │ │ │ -00007b60: 8099 0a20 2020 2020 4469 7361 626c 6520  ...     Disable 
│ │ │ │ -00007b70: 696e 7465 726e 6174 696f 6e61 6c69 7a65  internationalize
│ │ │ │ -00007b80: 6420 7374 7269 6e67 2070 726f 6365 7373  d string process
│ │ │ │ -00007b90: 696e 672e 0a0a 2020 2046 6f72 2074 6865  ing...   For the
│ │ │ │ -00007ba0: 2063 6f6d 706c 6574 6520 6c69 7374 2c20   complete list, 
│ │ │ │ -00007bb0: 7265 6665 7220 746f 2074 6865 206f 7574  refer to the out
│ │ │ │ -00007bc0: 7075 7420 6672 6f6d 20e2 8098 636f 6e66  put from ...conf
│ │ │ │ -00007bd0: 6967 7572 6520 2d2d 6865 6c70 e280 992e  igure --help....
│ │ │ │ -00007be0: 0a0a 1f0a 4669 6c65 3a20 7368 6973 6869  ....File: shishi
│ │ │ │ -00007bf0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 4275  .info,  Node: Bu
│ │ │ │ -00007c00: 6720 5265 706f 7274 732c 2020 4e65 7874  g Reports,  Next
│ │ │ │ -00007c10: 3a20 436f 6e74 7269 6275 7469 6e67 2c20  : Contributing, 
│ │ │ │ -00007c20: 2050 7265 763a 2044 6f77 6e6c 6f61 6469   Prev: Downloadi
│ │ │ │ -00007c30: 6e67 2061 6e64 2049 6e73 7461 6c6c 696e  ng and Installin
│ │ │ │ -00007c40: 672c 2020 5570 3a20 496e 7472 6f64 7563  g,  Up: Introduc
│ │ │ │ -00007c50: 7469 6f6e 0a0a 312e 3820 4275 6720 5265  tion..1.8 Bug Re
│ │ │ │ -00007c60: 706f 7274 730a 3d3d 3d3d 3d3d 3d3d 3d3d  ports.==========
│ │ │ │ -00007c70: 3d3d 3d3d 3d0a 0a49 6620 796f 7520 7468  =====..If you th
│ │ │ │ -00007c80: 696e 6b20 796f 7520 6861 7665 2066 6f75  ink you have fou
│ │ │ │ -00007c90: 6e64 2061 2062 7567 2069 6e20 5368 6973  nd a bug in Shis
│ │ │ │ -00007ca0: 6869 2c20 706c 6561 7365 2069 6e76 6573  hi, please inves
│ │ │ │ -00007cb0: 7469 6761 7465 2069 7420 616e 640a 7265  tigate it and.re
│ │ │ │ -00007cc0: 706f 7274 2069 742e 0a0a 2020 20e2 80a2  port it...   ...
│ │ │ │ -00007cd0: 2050 6c65 6173 6520 6d61 6b65 2073 7572   Please make sur
│ │ │ │ -00007ce0: 6520 7468 6174 2074 6865 2062 7567 2069  e that the bug i
│ │ │ │ -00007cf0: 7320 7265 616c 6c79 2069 6e20 5368 6973  s really in Shis
│ │ │ │ -00007d00: 6869 2c20 616e 6420 7072 6566 6572 6162  hi, and preferab
│ │ │ │ -00007d10: 6c79 0a20 2020 2020 616c 736f 2063 6865  ly.     also che
│ │ │ │ -00007d20: 636b 2074 6861 7420 6974 2068 6173 6e27  ck that it hasn'
│ │ │ │ -00007d30: 7420 616c 7265 6164 7920 6265 656e 2066  t already been f
│ │ │ │ -00007d40: 6978 6564 2069 6e20 7468 6520 6c61 7465  ixed in the late
│ │ │ │ -00007d50: 7374 2076 6572 7369 6f6e 2e0a 0a20 2020  st version...   
│ │ │ │ -00007d60: e280 a220 596f 7520 6861 7665 2074 6f20  ... You have to 
│ │ │ │ -00007d70: 7365 6e64 2075 7320 6120 7465 7374 2063  send us a test c
│ │ │ │ -00007d80: 6173 6520 7468 6174 206d 616b 6573 2069  ase that makes i
│ │ │ │ -00007d90: 7420 706f 7373 6962 6c65 2066 6f72 2075  t possible for u
│ │ │ │ -00007da0: 7320 746f 0a20 2020 2020 7265 7072 6f64  s to.     reprod
│ │ │ │ -00007db0: 7563 6520 7468 6520 6275 672e 0a0a 2020  uce the bug...  
│ │ │ │ -00007dc0: 20e2 80a2 2059 6f75 2061 6c73 6f20 6861   ... You also ha
│ │ │ │ -00007dd0: 7665 2074 6f20 6578 706c 6169 6e20 7768  ve to explain wh
│ │ │ │ -00007de0: 6174 2069 7320 7772 6f6e 673b 2069 6620  at is wrong; if 
│ │ │ │ -00007df0: 796f 7520 6765 7420 6120 6372 6173 682c  you get a crash,
│ │ │ │ -00007e00: 206f 7220 6966 0a20 2020 2020 7468 6520   or if.     the 
│ │ │ │ -00007e10: 7265 7375 6c74 7320 7072 696e 7465 6420  results printed 
│ │ │ │ -00007e20: 6172 6520 6e6f 7420 676f 6f64 2061 6e64  are not good and
│ │ │ │ -00007e30: 2069 6e20 7468 6174 2063 6173 652c 2069   in that case, i
│ │ │ │ -00007e40: 6e20 7768 6174 2077 6179 2e0a 2020 2020  n what way..    
│ │ │ │ -00007e50: 204d 616b 6520 7375 7265 2074 6861 7420   Make sure that 
│ │ │ │ -00007e60: 7468 6520 6275 6720 7265 706f 7274 2069  the bug report i
│ │ │ │ -00007e70: 6e63 6c75 6465 7320 616c 6c20 696e 666f  ncludes all info
│ │ │ │ -00007e80: 726d 6174 696f 6e20 796f 7520 776f 756c  rmation you woul
│ │ │ │ -00007e90: 640a 2020 2020 206e 6565 6420 746f 2066  d.     need to f
│ │ │ │ -00007ea0: 6978 2074 6869 7320 6b69 6e64 206f 6620  ix this kind of 
│ │ │ │ -00007eb0: 6275 6720 666f 7220 736f 6d65 6f6e 6520  bug for someone 
│ │ │ │ -00007ec0: 656c 7365 2e0a 0a20 2020 506c 6561 7365  else...   Please
│ │ │ │ -00007ed0: 206d 616b 6520 616e 2065 6666 6f72 7420   make an effort 
│ │ │ │ -00007ee0: 746f 2070 726f 6475 6365 2061 2073 656c  to produce a sel
│ │ │ │ -00007ef0: 662d 636f 6e74 6169 6e65 6420 7265 706f  f-contained repo
│ │ │ │ -00007f00: 7274 2c20 7769 7468 0a73 6f6d 6574 6869  rt, with.somethi
│ │ │ │ -00007f10: 6e67 2064 6566 696e 6974 6520 7468 6174  ng definite that
│ │ │ │ -00007f20: 2063 616e 2062 6520 7465 7374 6564 206f   can be tested o
│ │ │ │ -00007f30: 7220 6465 6275 6767 6564 2e20 2056 6167  r debugged.  Vag
│ │ │ │ -00007f40: 7565 2071 7565 7269 6573 206f 720a 7069  ue queries or.pi
│ │ │ │ -00007f50: 6563 656d 6561 6c20 6d65 7373 6167 6573  ecemeal messages
│ │ │ │ -00007f60: 2061 7265 2064 6966 6669 6375 6c74 2074   are difficult t
│ │ │ │ -00007f70: 6f20 6163 7420 6f6e 2061 6e64 2064 6f6e  o act on and don
│ │ │ │ -00007f80: 2774 2068 656c 7020 7468 650a 6465 7665  't help the.deve
│ │ │ │ -00007f90: 6c6f 706d 656e 7420 6566 666f 7274 2e0a  lopment effort..
│ │ │ │ -00007fa0: 0a20 2020 4966 2079 6f75 7220 6275 6720  .   If your bug 
│ │ │ │ -00007fb0: 7265 706f 7274 2069 7320 676f 6f64 2c20  report is good, 
│ │ │ │ -00007fc0: 7765 2077 696c 6c20 646f 206f 7572 2062  we will do our b
│ │ │ │ -00007fd0: 6573 7420 746f 2068 656c 7020 796f 7520  est to help you 
│ │ │ │ -00007fe0: 746f 2067 6574 2061 0a63 6f72 7265 6374  to get a.correct
│ │ │ │ -00007ff0: 6564 2076 6572 7369 6f6e 206f 6620 7468  ed version of th
│ │ │ │ -00008000: 6520 736f 6674 7761 7265 3b20 6966 2074  e software; if t
│ │ │ │ -00008010: 6865 2062 7567 2072 6570 6f72 7420 6973  he bug report is
│ │ │ │ -00008020: 2070 6f6f 722c 2077 6520 776f 6e27 740a   poor, we won't.
│ │ │ │ -00008030: 646f 2061 6e79 7468 696e 6720 6162 6f75  do anything abou
│ │ │ │ -00008040: 7420 6974 2028 6170 6172 7420 6672 6f6d  t it (apart from
│ │ │ │ -00008050: 2061 736b 696e 6720 796f 7520 746f 2073   asking you to s
│ │ │ │ -00008060: 656e 6420 6265 7474 6572 2062 7567 2072  end better bug r
│ │ │ │ -00008070: 6570 6f72 7473 292e 0a0a 2020 2049 6620  eports)...   If 
│ │ │ │ -00008080: 796f 7520 7468 696e 6b20 736f 6d65 7468  you think someth
│ │ │ │ -00008090: 696e 6720 696e 2074 6869 7320 6d61 6e75  ing in this manu
│ │ │ │ -000080a0: 616c 2069 7320 756e 636c 6561 722c 206f  al is unclear, o
│ │ │ │ -000080b0: 7220 646f 776e 7269 6768 740a 696e 636f  r downright.inco
│ │ │ │ -000080c0: 7272 6563 742c 206f 7220 6966 2074 6865  rrect, or if the
│ │ │ │ -000080d0: 206c 616e 6775 6167 6520 6e65 6564 7320   language needs 
│ │ │ │ -000080e0: 746f 2062 6520 696d 7072 6f76 6564 2c20  to be improved, 
│ │ │ │ -000080f0: 706c 6561 7365 2061 6c73 6f20 7365 6e64  please also send
│ │ │ │ -00008100: 2061 0a6e 6f74 652e 0a0a 2020 2053 656e   a.note...   Sen
│ │ │ │ -00008110: 6420 796f 7572 2062 7567 2072 6570 6f72  d your bug repor
│ │ │ │ -00008120: 7420 746f 3a0a 0a20 2020 2020 2020 2020  t to:..         
│ │ │ │ -00008130: 2020 2020 2020 2020 2020 2020 20e2 8098               ...
│ │ │ │ -00008140: 6275 672d 7368 6973 6869 406a 6f73 6566  bug-shishi@josef
│ │ │ │ -00008150: 7373 6f6e 2e6f 7267 e280 990a 0a1f 0a46  sson.org.......F
│ │ │ │ -00008160: 696c 653a 2073 6869 7368 692e 696e 666f  ile: shishi.info
│ │ │ │ -00008170: 2c20 204e 6f64 653a 2043 6f6e 7472 6962  ,  Node: Contrib
│ │ │ │ -00008180: 7574 696e 672c 2020 5072 6576 3a20 4275  uting,  Prev: Bu
│ │ │ │ -00008190: 6720 5265 706f 7274 732c 2020 5570 3a20  g Reports,  Up: 
│ │ │ │ -000081a0: 496e 7472 6f64 7563 7469 6f6e 0a0a 312e  Introduction..1.
│ │ │ │ -000081b0: 3920 436f 6e74 7269 6275 7469 6e67 0a3d  9 Contributing.=
│ │ │ │ -000081c0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a  ===============.
│ │ │ │ -000081d0: 0a49 6620 796f 7520 7761 6e74 2074 6f20  .If you want to 
│ │ │ │ -000081e0: 7375 626d 6974 2061 2070 6174 6368 2066  submit a patch f
│ │ │ │ -000081f0: 6f72 2069 6e63 6c75 7369 6f6e 202d 2066  or inclusion - f
│ │ │ │ -00008200: 726f 6d20 736f 6c76 6520 6120 7479 706f  rom solve a typo
│ │ │ │ -00008210: 2079 6f75 0a64 6973 636f 7665 7265 642c   you.discovered,
│ │ │ │ -00008220: 2075 7020 746f 2061 6464 696e 6720 7375   up to adding su
│ │ │ │ -00008230: 7070 6f72 7420 666f 7220 6120 6e65 7720  pport for a new 
│ │ │ │ -00008240: 6665 6174 7572 6520 2d20 796f 7520 7368  feature - you sh
│ │ │ │ -00008250: 6f75 6c64 2073 7562 6d69 740a 6974 2061  ould submit.it a
│ │ │ │ -00008260: 7320 6120 6275 6720 7265 706f 7274 2028  s a bug report (
│ │ │ │ -00008270: 2a6e 6f74 6520 4275 6720 5265 706f 7274  *note Bug Report
│ │ │ │ -00008280: 733a 3a29 2e20 2054 6865 7265 2061 7265  s::).  There are
│ │ │ │ -00008290: 2073 6f6d 6520 7468 696e 6773 2074 6861   some things tha
│ │ │ │ -000082a0: 740a 796f 7520 6361 6e20 646f 2074 6f20  t.you can do to 
│ │ │ │ -000082b0: 696e 6372 6561 7365 2074 6865 2063 6861  increase the cha
│ │ │ │ -000082c0: 6e63 6573 2066 6f72 2069 7420 746f 2062  nces for it to b
│ │ │ │ -000082d0: 6520 696e 636c 7564 6564 2069 6e20 7468  e included in th
│ │ │ │ -000082e0: 6520 6f66 6669 6369 616c 0a70 6163 6b61  e official.packa
│ │ │ │ -000082f0: 6765 2e0a 0a20 2020 556e 6c65 7373 2079  ge...   Unless y
│ │ │ │ -00008300: 6f75 7220 7061 7463 6820 6973 2076 6572  our patch is ver
│ │ │ │ -00008310: 7920 736d 616c 6c20 2873 6179 2c20 756e  y small (say, un
│ │ │ │ -00008320: 6465 7220 3130 206c 696e 6573 2920 7765  der 10 lines) we
│ │ │ │ -00008330: 2072 6571 7569 7265 2074 6861 740a 796f   require that.yo
│ │ │ │ -00008340: 7520 6173 7369 676e 2074 6865 2063 6f70  u assign the cop
│ │ │ │ -00008350: 7972 6967 6874 206f 6620 796f 7572 2077  yright of your w
│ │ │ │ -00008360: 6f72 6b20 746f 2074 6865 2046 7265 6520  ork to the Free 
│ │ │ │ -00008370: 536f 6674 7761 7265 2046 6f75 6e64 6174  Software Foundat
│ │ │ │ -00008380: 696f 6e2e 0a54 6869 7320 6973 2074 6f20  ion..This is to 
│ │ │ │ -00008390: 7072 6f74 6563 7420 7468 6520 6672 6565  protect the free
│ │ │ │ -000083a0: 646f 6d20 6f66 2074 6865 2070 726f 6a65  dom of the proje
│ │ │ │ -000083b0: 6374 2e20 2049 6620 796f 7520 6861 7665  ct.  If you have
│ │ │ │ -000083c0: 206e 6f74 2061 6c72 6561 6479 0a73 6967   not already.sig
│ │ │ │ -000083d0: 6e65 6420 7061 7065 7273 2c20 7765 2077  ned papers, we w
│ │ │ │ -000083e0: 696c 6c20 7365 6e64 2079 6f75 2074 6865  ill send you the
│ │ │ │ -000083f0: 206e 6563 6573 7361 7279 2069 6e66 6f72   necessary infor
│ │ │ │ -00008400: 6d61 7469 6f6e 2077 6865 6e20 796f 750a  mation when you.
│ │ │ │ -00008410: 7375 626d 6974 2079 6f75 7220 636f 6e74  submit your cont
│ │ │ │ -00008420: 7269 6275 7469 6f6e 2e0a 0a20 2020 466f  ribution...   Fo
│ │ │ │ -00008430: 7220 636f 6e74 7269 6275 7469 6f6e 7320  r contributions 
│ │ │ │ -00008440: 7468 6174 2064 6f65 736e 2774 2063 6f6e  that doesn't con
│ │ │ │ -00008450: 7369 7374 206f 6620 6163 7475 616c 2070  sist of actual p
│ │ │ │ -00008460: 726f 6772 616d 6d69 6e67 2063 6f64 652c  rogramming code,
│ │ │ │ -00008470: 0a74 6865 206f 6e6c 7920 6775 6964 656c  .the only guidel
│ │ │ │ -00008480: 696e 6573 2061 7265 2063 6f6d 6d6f 6e20  ines are common 
│ │ │ │ -00008490: 7365 6e73 652e 2020 5573 6520 6974 2e0a  sense.  Use it..
│ │ │ │ -000084a0: 0a20 2020 466f 7220 636f 6465 2063 6f6e  .   For code con
│ │ │ │ -000084b0: 7472 6962 7574 696f 6e73 2c20 6120 6e75  tributions, a nu
│ │ │ │ -000084c0: 6d62 6572 206f 6620 7374 796c 6520 6775  mber of style gu
│ │ │ │ -000084d0: 6964 6573 2077 696c 6c20 6865 6c70 2079  ides will help y
│ │ │ │ -000084e0: 6f75 3a0a 0a20 2020 e280 a220 436f 6469  ou:..   ... Codi
│ │ │ │ -000084f0: 6e67 2053 7479 6c65 2e20 2046 6f6c 6c6f  ng Style.  Follo
│ │ │ │ -00008500: 7720 7468 6520 474e 5520 5374 616e 6461  w the GNU Standa
│ │ │ │ -00008510: 7264 7320 646f 6375 6d65 6e74 2028 2a6e  rds document (*n
│ │ │ │ -00008520: 6f74 6520 474e 5520 436f 6469 6e67 0a20  ote GNU Coding. 
│ │ │ │ -00008530: 2020 2020 5374 616e 6461 7264 733a 2028      Standards: (
│ │ │ │ -00008540: 7374 616e 6461 7264 7329 746f 702e 292e  standards)top.).
│ │ │ │ -00008550: 0a0a 2020 2020 2049 6620 796f 7520 6e6f  ..     If you no
│ │ │ │ -00008560: 726d 616c 6c79 2063 6f64 6520 7573 696e  rmally code usin
│ │ │ │ -00008570: 6720 616e 6f74 6865 7220 636f 6469 6e67  g another coding
│ │ │ │ -00008580: 2073 7461 6e64 6172 642c 2074 6865 7265   standard, there
│ │ │ │ -00008590: 2069 7320 6e6f 0a20 2020 2020 7072 6f62   is no.     prob
│ │ │ │ -000085a0: 6c65 6d2c 2062 7574 2079 6f75 2073 686f  lem, but you sho
│ │ │ │ -000085b0: 756c 6420 7573 6520 e280 9869 6e64 656e  uld use ...inden
│ │ │ │ -000085c0: 74e2 8099 2074 6f20 7265 666f 726d 6174  t... to reformat
│ │ │ │ -000085d0: 2074 6865 2063 6f64 6520 282a 6e6f 7465   the code (*note
│ │ │ │ -000085e0: 0a20 2020 2020 474e 5520 496e 6465 6e74  .     GNU Indent
│ │ │ │ -000085f0: 3a20 2869 6e64 656e 7429 746f 702e 2920  : (indent)top.) 
│ │ │ │ -00008600: 6265 666f 7265 2073 7562 6d69 7474 696e  before submittin
│ │ │ │ -00008610: 6720 796f 7572 2077 6f72 6b2e 0a0a 2020  g your work...  
│ │ │ │ -00008620: 20e2 80a2 2055 7365 2074 6865 2075 6e69   ... Use the uni
│ │ │ │ -00008630: 6669 6564 2064 6966 6620 666f 726d 6174  fied diff format
│ │ │ │ -00008640: 20e2 8098 6469 6666 202d 75e2 8099 2e0a   ...diff -u.....
│ │ │ │ -00008650: 0a20 2020 e280 a220 5265 7475 726e 2065  .   ... Return e
│ │ │ │ -00008660: 7272 6f72 732e 2020 5468 6520 6f6e 6c79  rrors.  The only
│ │ │ │ -00008670: 2076 616c 6964 2072 6561 736f 6e20 666f   valid reason fo
│ │ │ │ -00008680: 7220 6576 6572 2061 626f 7274 696e 6720  r ever aborting 
│ │ │ │ -00008690: 7468 650a 2020 2020 2065 7865 6375 7469  the.     executi
│ │ │ │ -000086a0: 6f6e 206f 6620 7468 6520 7072 6f67 7261  on of the progra
│ │ │ │ -000086b0: 6d20 6973 2064 7565 2074 6f20 6d65 6d6f  m is due to memo
│ │ │ │ -000086c0: 7279 2061 6c6c 6f63 6174 696f 6e20 6572  ry allocation er
│ │ │ │ -000086d0: 726f 7273 2c20 6275 740a 2020 2020 2066  rors, but.     f
│ │ │ │ -000086e0: 6f72 2074 6861 7420 796f 7520 7368 6f75  or that you shou
│ │ │ │ -000086f0: 6c64 2063 616c 6c20 e280 9873 6869 7368  ld call ...shish
│ │ │ │ -00008700: 695f 7861 6c6c 6f63 5f64 6965 e280 9920  i_xalloc_die... 
│ │ │ │ -00008710: 746f 2061 6c6c 6f77 2074 6865 0a20 2020  to allow the.   
│ │ │ │ -00008720: 2020 6170 706c 6963 6174 696f 6e20 746f    application to
│ │ │ │ -00008730: 2072 6563 6f76 6572 2069 6620 6974 2077   recover if it w
│ │ │ │ -00008740: 616e 7473 2074 6f2e 0a0a 2020 20e2 80a2  ants to...   ...
│ │ │ │ -00008750: 2044 6573 6967 6e20 7769 7468 2074 6872   Design with thr
│ │ │ │ -00008760: 6561 6420 7361 6665 7479 2069 6e20 6d69  ead safety in mi
│ │ │ │ -00008770: 6e64 2e20 2044 6f6e 2774 2075 7365 2067  nd.  Don't use g
│ │ │ │ -00008780: 6c6f 6261 6c20 7661 7269 6162 6c65 732e  lobal variables.
│ │ │ │ -00008790: 0a20 2020 2020 446f 6e27 7420 6576 656e  .     Don't even
│ │ │ │ -000087a0: 2077 7269 7465 2074 6f20 7065 722d 6861   write to per-ha
│ │ │ │ -000087b0: 6e64 6c65 2067 6c6f 6261 6c20 7661 7269  ndle global vari
│ │ │ │ -000087c0: 6162 6c65 7320 756e 6c65 7373 2074 6865  ables unless the
│ │ │ │ -000087d0: 0a20 2020 2020 646f 6375 6d65 6e74 6564  .     documented
│ │ │ │ -000087e0: 2062 6568 6176 696f 7572 206f 6620 7468   behaviour of th
│ │ │ │ -000087f0: 6520 6675 6e63 7469 6f6e 2079 6f75 2077  e function you w
│ │ │ │ -00008800: 7269 7465 2069 7320 746f 2077 7269 7465  rite is to write
│ │ │ │ -00008810: 2074 6f20 7468 650a 2020 2020 2070 6572   to the.     per
│ │ │ │ -00008820: 2d68 616e 646c 6520 676c 6f62 616c 2076  -handle global v
│ │ │ │ -00008830: 6172 6961 626c 652e 0a0a 2020 20e2 80a2  ariable...   ...
│ │ │ │ -00008840: 2041 766f 6964 2075 7369 6e67 2074 6865   Avoid using the
│ │ │ │ -00008850: 2043 206d 6174 6820 6c69 6272 6172 792e   C math library.
│ │ │ │ -00008860: 2020 4974 2063 6175 7365 7320 7072 6f62    It causes prob
│ │ │ │ -00008870: 6c65 6d73 2066 6f72 2065 6d62 6564 6465  lems for embedde
│ │ │ │ -00008880: 640a 2020 2020 2069 6d70 6c65 6d65 6e74  d.     implement
│ │ │ │ -00008890: 6174 696f 6e73 2c20 616e 6420 696e 206d  ations, and in m
│ │ │ │ -000088a0: 6f73 7420 7369 7475 6174 696f 6e73 2069  ost situations i
│ │ │ │ -000088b0: 7420 6973 2076 6572 7920 6561 7379 2074  t is very easy t
│ │ │ │ -000088c0: 6f20 6176 6f69 640a 2020 2020 2075 7369  o avoid.     usi
│ │ │ │ -000088d0: 6e67 2069 742e 0a0a 2020 20e2 80a2 2044  ng it...   ... D
│ │ │ │ -000088e0: 6f63 756d 656e 7420 796f 7572 2066 756e  ocument your fun
│ │ │ │ -000088f0: 6374 696f 6e73 2e20 2055 7365 2063 6f6d  ctions.  Use com
│ │ │ │ -00008900: 6d65 6e74 7320 6265 666f 7265 2065 6163  ments before eac
│ │ │ │ -00008910: 6820 6675 6e63 7469 6f6e 0a20 2020 2020  h function.     
│ │ │ │ -00008920: 6865 6164 6572 732c 2074 6861 742c 2069  headers, that, i
│ │ │ │ -00008930: 6620 7072 6f70 6572 6c79 2066 6f72 6d61  f properly forma
│ │ │ │ -00008940: 7474 6564 2c20 6172 6520 6578 7472 6163  tted, are extrac
│ │ │ │ -00008950: 7465 6420 696e 746f 2054 6578 696e 666f  ted into Texinfo
│ │ │ │ -00008960: 0a20 2020 2020 6d61 6e75 616c 7320 616e  .     manuals an
│ │ │ │ -00008970: 6420 4754 4b2d 444f 4320 7765 6220 7061  d GTK-DOC web pa
│ │ │ │ -00008980: 6765 732e 0a0a 2020 20e2 80a2 2053 7570  ges...   ... Sup
│ │ │ │ -00008990: 706c 7920 6120 4368 616e 6765 4c6f 6720  ply a ChangeLog 
│ │ │ │ -000089a0: 616e 6420 4e45 5753 2065 6e74 7269 6573  and NEWS entries
│ │ │ │ -000089b0: 2c20 7768 6572 6520 6170 7072 6f70 7269  , where appropri
│ │ │ │ -000089c0: 6174 652e 0a0a 1f0a 4669 6c65 3a20 7368  ate.....File: sh
│ │ │ │ -000089d0: 6973 6869 2e69 6e66 6f2c 2020 4e6f 6465  ishi.info,  Node
│ │ │ │ -000089e0: 3a20 5573 6572 204d 616e 7561 6c2c 2020  : User Manual,  
│ │ │ │ -000089f0: 4e65 7874 3a20 4164 6d69 6e69 7374 7261  Next: Administra
│ │ │ │ -00008a00: 7469 6f6e 204d 616e 7561 6c2c 2020 5072  tion Manual,  Pr
│ │ │ │ -00008a10: 6576 3a20 496e 7472 6f64 7563 7469 6f6e  ev: Introduction
│ │ │ │ -00008a20: 2c20 2055 703a 2054 6f70 0a0a 3220 5573  ,  Up: Top..2 Us
│ │ │ │ -00008a30: 6572 204d 616e 7561 6c0a 2a2a 2a2a 2a2a  er Manual.******
│ │ │ │ -00008a40: 2a2a 2a2a 2a2a 2a0a 0a55 7375 616c 6c79  *******..Usually
│ │ │ │ -00008a50: 2053 6869 7368 6920 696e 7465 7261 6374   Shishi interact
│ │ │ │ -00008a60: 7320 7769 7468 2079 6f75 2074 6f20 6765  s with you to ge
│ │ │ │ -00008a70: 7420 736f 6d65 2069 6e69 7469 616c 2061  t some initial a
│ │ │ │ -00008a80: 7574 6865 6e74 6963 6174 696f 6e0a 696e  uthentication.in
│ │ │ │ -00008a90: 666f 726d 6174 696f 6e20 6c69 6b65 2061  formation like a
│ │ │ │ -00008aa0: 2070 6173 7377 6f72 642c 2061 6e64 2074   password, and t
│ │ │ │ -00008ab0: 6865 6e20 636f 6e74 6163 7473 2061 2073  hen contacts a s
│ │ │ │ -00008ac0: 6572 7665 7220 746f 2072 6563 6569 7665  erver to receive
│ │ │ │ -00008ad0: 2061 2073 6f0a 6361 6c6c 6564 2074 6963   a so.called tic
│ │ │ │ -00008ae0: 6b65 7420 6772 616e 7469 6e67 2074 6963  ket granting tic
│ │ │ │ -00008af0: 6b65 742e 2020 4672 6f6d 206e 6f77 206f  ket.  From now o
│ │ │ │ -00008b00: 6e2c 2079 6f75 2072 6172 656c 7920 696e  n, you rarely in
│ │ │ │ -00008b10: 7465 7261 6374 2077 6974 680a 5368 6973  teract with.Shis
│ │ │ │ -00008b20: 6869 2064 6972 6563 746c 792e 2020 4170  hi directly.  Ap
│ │ │ │ -00008b30: 706c 6963 6174 696f 6e73 2074 6861 7420  plications that 
│ │ │ │ -00008b40: 6e65 6564 2073 6563 7572 6974 7920 7365  need security se
│ │ │ │ -00008b50: 7276 6963 6573 2069 6e73 7472 7563 7420  rvices instruct 
│ │ │ │ -00008b60: 7468 650a 5368 6973 6869 206c 6962 7261  the.Shishi libra
│ │ │ │ -00008b70: 7279 2074 6f20 7573 6520 7468 6520 7469  ry to use the ti
│ │ │ │ -00008b80: 636b 6574 2067 7261 6e74 696e 6720 7469  cket granting ti
│ │ │ │ -00008b90: 636b 6574 2074 6f20 6765 7420 6e65 7720  cket to get new 
│ │ │ │ -00008ba0: 7469 636b 6574 7320 666f 720a 7661 7269  tickets for.vari
│ │ │ │ -00008bb0: 6f75 7320 7365 7276 6572 732e 2020 416e  ous servers.  An
│ │ │ │ -00008bc0: 2065 7861 6d70 6c65 2063 6f75 6c64 2062   example could b
│ │ │ │ -00008bd0: 6520 6966 2079 6f75 206c 6f67 206f 6e20  e if you log on 
│ │ │ │ -00008be0: 746f 2061 2068 6f73 7420 7265 6d6f 7465  to a host remote
│ │ │ │ -00008bf0: 6c79 0a76 6961 20e2 8098 7465 6c6e 6574  ly.via ...telnet
│ │ │ │ -00008c00: e280 992e 2020 5468 6520 686f 7374 2075  ....  The host u
│ │ │ │ -00008c10: 7375 616c 6c79 2072 6571 7569 7265 7320  sually requires 
│ │ │ │ -00008c20: 6175 7468 656e 7469 6361 7469 6f6e 2062  authentication b
│ │ │ │ -00008c30: 6566 6f72 650a 7065 726d 6974 7469 6e67  efore.permitting
│ │ │ │ -00008c40: 2079 6f75 2069 6e2e 2020 5468 6520 e280   you in.  The ..
│ │ │ │ -00008c50: 9874 656c 6e65 74e2 8099 2063 6c69 656e  .telnet... clien
│ │ │ │ -00008c60: 7420 7573 6573 2074 6865 2074 6963 6b65  t uses the ticke
│ │ │ │ -00008c70: 7420 6772 616e 7469 6e67 2074 6963 6b65  t granting ticke
│ │ │ │ -00008c80: 740a 746f 2067 6574 2061 2074 6963 6b65  t.to get a ticke
│ │ │ │ -00008c90: 7420 666f 7220 7468 6520 7365 7276 6572  t for the server
│ │ │ │ -00008ca0: 2c20 616e 6420 7468 656e 2075 7365 7320  , and then uses 
│ │ │ │ -00008cb0: 7468 6973 2074 6963 6b65 7420 746f 0a61  this ticket to.a
│ │ │ │ -00008cc0: 7574 6865 6e74 6963 6174 6520 796f 7520  uthenticate you 
│ │ │ │ -00008cd0: 6167 6169 6e73 7420 7468 6520 7365 7276  against the serv
│ │ │ │ -00008ce0: 6572 2028 7479 7069 6361 6c6c 7920 7468  er (typically th
│ │ │ │ -00008cf0: 6520 7365 7276 6572 2069 7320 616c 736f  e server is also
│ │ │ │ -00008d00: 0a61 7574 6865 6e74 6963 6174 6564 2074  .authenticated t
│ │ │ │ -00008d10: 6f20 796f 7529 2e20 2059 6f75 2070 6572  o you).  You per
│ │ │ │ -00008d20: 666f 726d 2074 6865 2069 6e69 7469 616c  form the initial
│ │ │ │ -00008d30: 2061 7574 6865 6e74 6963 6174 696f 6e20   authentication 
│ │ │ │ -00008d40: 6279 2074 7970 696e 670a e280 9873 6869  by typing....shi
│ │ │ │ -00008d50: 7368 69e2 8099 2061 7420 7468 6520 7072  shi... at the pr
│ │ │ │ -00008d60: 6f6d 7074 2e20 2053 6f6d 6574 696d 6573  ompt.  Sometimes
│ │ │ │ -00008d70: 2069 7420 6973 206e 6563 6573 7361 7279   it is necessary
│ │ │ │ -00008d80: 2074 6f20 7375 7070 6c79 206f 7074 696f   to supply optio
│ │ │ │ -00008d90: 6e73 0a74 656c 6c69 6e67 2053 6869 7368  ns.telling Shish
│ │ │ │ -00008da0: 6920 7768 6174 2079 6f75 7220 7072 696e  i what your prin
│ │ │ │ -00008db0: 6369 7061 6c20 6e61 6d65 2028 7573 6572  cipal name (user
│ │ │ │ -00008dc0: 206e 616d 6520 696e 2074 6865 204b 6572   name in the Ker
│ │ │ │ -00008dd0: 6265 726f 730a 7265 616c 6d29 206f 7220  beros.realm) or 
│ │ │ │ -00008de0: 796f 7572 2072 6561 6c6d 2069 732e 2020  your realm is.  
│ │ │ │ -00008df0: 496e 2074 6865 2065 7861 6d70 6c65 2c20  In the example, 
│ │ │ │ -00008e00: 4920 7370 6563 6966 7920 7468 6520 636c  I specify the cl
│ │ │ │ -00008e10: 6965 6e74 206e 616d 650a e280 9873 696d  ient name....sim
│ │ │ │ -00008e20: 6f6e 404a 4f53 4546 5353 4f4e 2e4f 5247  on@JOSEFSSON.ORG
│ │ │ │ -00008e30: e280 992e 0a0a 2020 2020 2024 2073 6869  ......     $ shi
│ │ │ │ -00008e40: 7368 6920 7369 6d6f 6e40 4a4f 5345 4653  shi simon@JOSEFS
│ │ │ │ -00008e50: 534f 4e2e 4f52 470a 2020 2020 2045 6e74  SON.ORG.     Ent
│ │ │ │ -00008e60: 6572 2070 6173 7377 6f72 6420 666f 7220  er password for 
│ │ │ │ -00008e70: 6073 696d 6f6e 404a 4f53 4546 5353 4f4e  `simon@JOSEFSSON
│ │ │ │ -00008e80: 2e4f 5247 273a 0a20 2020 2020 7369 6d6f  .ORG':.     simo
│ │ │ │ -00008e90: 6e40 4a4f 5345 4653 534f 4e2e 4f52 473a  n@JOSEFSSON.ORG:
│ │ │ │ -00008ea0: 0a20 2020 2020 4175 7468 7469 6d65 3a20  .     Authtime: 
│ │ │ │ -00008eb0: 2020 2020 2020 4672 6920 4175 6720 3135        Fri Aug 15
│ │ │ │ -00008ec0: 2030 343a 3434 3a34 3920 3230 3033 0a20   04:44:49 2003. 
│ │ │ │ -00008ed0: 2020 2020 456e 6474 696d 653a 2020 2020      Endtime:    
│ │ │ │ -00008ee0: 2020 2020 4672 6920 4175 6720 3135 2030      Fri Aug 15 0
│ │ │ │ -00008ef0: 353a 3031 3a32 3920 3230 3033 0a20 2020  5:01:29 2003.   
│ │ │ │ -00008f00: 2020 5365 7276 6572 3a20 2020 2020 2020    Server:       
│ │ │ │ -00008f10: 2020 6b72 6274 6774 2f4a 4f53 4546 5353    krbtgt/JOSEFSS
│ │ │ │ -00008f20: 4f4e 2e4f 5247 206b 6579 2064 6573 332d  ON.ORG key des3-
│ │ │ │ -00008f30: 6362 632d 7368 6131 2d6b 6420 2831 3629  cbc-sha1-kd (16)
│ │ │ │ -00008f40: 0a20 2020 2020 5469 636b 6574 206b 6579  .     Ticket key
│ │ │ │ -00008f50: 3a20 2020 2020 6465 7333 2d63 6263 2d73  :     des3-cbc-s
│ │ │ │ -00008f60: 6861 312d 6b64 2028 3136 2920 7072 6f74  ha1-kd (16) prot
│ │ │ │ -00008f70: 6563 7465 6420 6279 2064 6573 332d 6362  ected by des3-cb
│ │ │ │ -00008f80: 632d 7368 6131 2d6b 6420 2831 3629 0a20  c-sha1-kd (16). 
│ │ │ │ -00008f90: 2020 2020 5469 636b 6574 2066 6c61 6773      Ticket flags
│ │ │ │ -00008fa0: 3a20 2020 494e 4954 4941 4c20 2835 3132  :   INITIAL (512
│ │ │ │ -00008fb0: 290a 2020 2020 2024 0a0a 2020 2041 7320  ).     $..   As 
│ │ │ │ -00008fc0: 796f 7520 6361 6e20 7365 652c 2053 6869  you can see, Shi
│ │ │ │ -00008fd0: 7368 6920 616c 736f 2070 7269 6e74 7320  shi also prints 
│ │ │ │ -00008fe0: 6120 7368 6f72 7420 6465 7363 7269 7074  a short descript
│ │ │ │ -00008ff0: 696f 6e20 6f66 2074 6865 2074 6963 6b65  ion of the ticke
│ │ │ │ -00009000: 740a 7265 6365 6976 6564 2e0a 0a20 2020  t.received...   
│ │ │ │ -00009010: 4120 6c6f 6769 6361 6c20 6e65 7874 2073  A logical next s
│ │ │ │ -00009020: 7465 7020 6973 2074 6f20 6469 7370 6c61  tep is to displa
│ │ │ │ -00009030: 7920 616c 6c20 7469 636b 6574 7320 796f  y all tickets yo
│ │ │ │ -00009040: 7520 6861 7665 2072 6563 6569 7665 642e  u have received.
│ │ │ │ -00009050: 2020 4279 0a74 6865 2077 6179 2c20 7468    By.the way, th
│ │ │ │ -00009060: 6520 7469 636b 6574 7320 6172 6520 7573  e tickets are us
│ │ │ │ -00009070: 7561 6c6c 7920 7374 6f72 6564 2061 7320  ually stored as 
│ │ │ │ -00009080: 7465 7874 2069 6e20 e280 987e 2f2e 7368  text in ...~/.sh
│ │ │ │ -00009090: 6973 6869 2f74 6963 6b65 7473 e280 992e  ishi/tickets....
│ │ │ │ -000090a0: 0a54 6869 7320 6973 2061 6368 6965 7665  .This is achieve
│ │ │ │ -000090b0: 6420 6279 2074 7970 696e 6720 e280 9873  d by typing ...s
│ │ │ │ -000090c0: 6869 7368 6920 2d2d 6c69 7374 e280 992e  hishi --list....
│ │ │ │ -000090d0: 0a0a 2020 2020 2024 2073 6869 7368 6920  ..     $ shishi 
│ │ │ │ -000090e0: 2d2d 6c69 7374 0a20 2020 2020 5469 636b  --list.     Tick
│ │ │ │ -000090f0: 6574 7320 696e 2060 2f68 6f6d 652f 6a61  ets in `/home/ja
│ │ │ │ -00009100: 732f 2e73 6869 7368 692f 7469 636b 6574  s/.shishi/ticket
│ │ │ │ -00009110: 7327 3a0a 0a20 2020 2020 6a61 7340 4a4f  s':..     jas@JO
│ │ │ │ -00009120: 5345 4653 534f 4e2e 4f52 473a 0a20 2020  SEFSSON.ORG:.   
│ │ │ │ -00009130: 2020 4175 7468 7469 6d65 3a20 2020 2020    Authtime:     
│ │ │ │ -00009140: 2020 4672 6920 4175 6720 3135 2030 343a    Fri Aug 15 04:
│ │ │ │ -00009150: 3439 3a34 3620 3230 3033 0a20 2020 2020  49:46 2003.     
│ │ │ │ -00009160: 456e 6474 696d 653a 2020 2020 2020 2020  Endtime:        
│ │ │ │ -00009170: 4672 6920 4175 6720 3135 2030 353a 3036  Fri Aug 15 05:06
│ │ │ │ -00009180: 3a32 3620 3230 3033 0a20 2020 2020 5365  :26 2003.     Se
│ │ │ │ -00009190: 7276 6572 3a20 2020 2020 2020 2020 6b72  rver:         kr
│ │ │ │ -000091a0: 6274 6774 2f4a 4f53 4546 5353 4f4e 2e4f  btgt/JOSEFSSON.O
│ │ │ │ -000091b0: 5247 206b 6579 2064 6573 2d63 6263 2d6d  RG key des-cbc-m
│ │ │ │ -000091c0: 6435 2028 3329 0a20 2020 2020 5469 636b  d5 (3).     Tick
│ │ │ │ -000091d0: 6574 206b 6579 3a20 2020 2020 6465 732d  et key:     des-
│ │ │ │ -000091e0: 6362 632d 6d64 3520 2833 2920 7072 6f74  cbc-md5 (3) prot
│ │ │ │ -000091f0: 6563 7465 6420 6279 2064 6573 2d63 6263  ected by des-cbc
│ │ │ │ -00009200: 2d6d 6435 2028 3329 0a20 2020 2020 5469  -md5 (3).     Ti
│ │ │ │ -00009210: 636b 6574 2066 6c61 6773 3a20 2020 494e  cket flags:   IN
│ │ │ │ -00009220: 4954 4941 4c20 2835 3132 290a 0a20 2020  ITIAL (512)..   
│ │ │ │ -00009230: 2020 6a61 7340 4a4f 5345 4653 534f 4e2e    jas@JOSEFSSON.
│ │ │ │ -00009240: 4f52 473a 0a20 2020 2020 4175 7468 7469  ORG:.     Authti
│ │ │ │ -00009250: 6d65 3a20 2020 2020 2020 4672 6920 4175  me:       Fri Au
│ │ │ │ -00009260: 6720 3135 2030 343a 3439 3a34 3620 3230  g 15 04:49:46 20
│ │ │ │ -00009270: 3033 0a20 2020 2020 5374 6172 7474 696d  03.     Starttim
│ │ │ │ -00009280: 653a 2020 2020 2020 4672 6920 4175 6720  e:      Fri Aug 
│ │ │ │ -00009290: 3135 2030 343a 3439 3a34 3920 3230 3033  15 04:49:49 2003
│ │ │ │ -000092a0: 0a20 2020 2020 456e 6474 696d 653a 2020  .     Endtime:  
│ │ │ │ -000092b0: 2020 2020 2020 4672 6920 4175 6720 3135        Fri Aug 15
│ │ │ │ -000092c0: 2030 353a 3036 3a32 3620 3230 3033 0a20   05:06:26 2003. 
│ │ │ │ -000092d0: 2020 2020 5365 7276 6572 3a20 2020 2020      Server:     
│ │ │ │ -000092e0: 2020 2020 686f 7374 2f6c 6174 7465 2e6a      host/latte.j
│ │ │ │ -000092f0: 6f73 6566 7373 6f6e 2e6f 7267 206b 6579  osefsson.org key
│ │ │ │ -00009300: 2064 6573 2d63 6263 2d6d 6435 2028 3329   des-cbc-md5 (3)
│ │ │ │ -00009310: 0a20 2020 2020 5469 636b 6574 206b 6579  .     Ticket key
│ │ │ │ -00009320: 3a20 2020 2020 6465 732d 6362 632d 6d64  :     des-cbc-md
│ │ │ │ -00009330: 3520 2833 2920 7072 6f74 6563 7465 6420  5 (3) protected 
│ │ │ │ -00009340: 6279 2064 6573 2d63 6263 2d6d 6435 2028  by des-cbc-md5 (
│ │ │ │ -00009350: 3329 0a0a 2020 2020 2032 2074 6963 6b65  3)..     2 ticke
│ │ │ │ -00009360: 7473 2066 6f75 6e64 2e0a 2020 2020 2024  ts found..     $
│ │ │ │ -00009370: 0a0a 2020 2041 7320 796f 7520 6361 6e20  ..   As you can 
│ │ │ │ -00009380: 7365 652c 2049 2068 6164 2061 2074 6963  see, I had a tic
│ │ │ │ -00009390: 6b65 7420 666f 7220 7468 6520 7365 7276  ket for the serv
│ │ │ │ -000093a0: 6572 0ae2 8098 686f 7374 2f6c 6174 7465  er....host/latte
│ │ │ │ -000093b0: 2e6a 6f73 6566 7373 6f6e 2e6f 7267 e280  .josefsson.org..
│ │ │ │ -000093c0: 9920 7768 6963 6820 7761 7320 6765 6e65  . which was gene
│ │ │ │ -000093d0: 7261 7465 6420 6279 20e2 8098 7465 6c6e  rated by ...teln
│ │ │ │ -000093e0: 6574 e280 993a 696e 6720 746f 2074 6861  et...:ing to tha
│ │ │ │ -000093f0: 740a 686f 7374 2e0a 0a20 2020 4966 2c20  t.host...   If, 
│ │ │ │ -00009400: 666f 7220 736f 6d65 2072 6561 736f 6e2c  for some reason,
│ │ │ │ -00009410: 2079 6f75 2077 616e 7420 746f 206d 616e   you want to man
│ │ │ │ -00009420: 7561 6c6c 7920 6765 7420 6120 7469 636b  ually get a tick
│ │ │ │ -00009430: 6574 2066 6f72 2061 2073 7065 6369 6669  et for a specifi
│ │ │ │ -00009440: 630a 7365 7276 6572 2c20 796f 7520 6361  c.server, you ca
│ │ │ │ -00009450: 6e20 7573 6520 7468 6520 e280 9873 6869  n use the ...shi
│ │ │ │ -00009460: 7368 6920 2d2d 7365 7276 6572 2d6e 616d  shi --server-nam
│ │ │ │ -00009470: 65e2 8099 2063 6f6d 6d61 6e64 2e20 204e  e... command.  N
│ │ │ │ -00009480: 6f72 6d61 6c6c 792c 0a68 6f77 6576 6572  ormally,.however
│ │ │ │ -00009490: 2c20 7468 6520 6170 706c 6963 6174 696f  , the applicatio
│ │ │ │ -000094a0: 6e20 7468 6174 2075 7365 7320 5368 6973  n that uses Shis
│ │ │ │ -000094b0: 6869 2077 696c 6c20 7461 6b65 2063 6172  hi will take car
│ │ │ │ -000094c0: 6520 6f66 2067 6574 7469 6e67 2061 0a74  e of getting a.t
│ │ │ │ -000094d0: 6963 6b65 7420 666f 7220 7468 6520 6170  icket for the ap
│ │ │ │ -000094e0: 7072 6f70 7269 6174 6520 7365 7276 6572  propriate server
│ │ │ │ -000094f0: 2c20 736f 2079 6f75 206e 6f72 6d61 6c6c  , so you normall
│ │ │ │ -00009500: 7920 776f 756c 646e 2774 206e 6565 6420  y wouldn't need 
│ │ │ │ -00009510: 746f 0a69 7373 7565 2074 6869 7320 636f  to.issue this co
│ │ │ │ -00009520: 6d6d 616e 642e 0a0a 2020 2020 2024 2073  mmand...     $ s
│ │ │ │ -00009530: 6869 7368 6920 2d2d 7365 7276 6572 2d6e  hishi --server-n
│ │ │ │ -00009540: 616d 653d 7573 6572 2f62 696c 6c67 202d  ame=user/billg -
│ │ │ │ -00009550: 2d65 6e63 7279 7074 696f 6e2d 7479 7065  -encryption-type
│ │ │ │ -00009560: 3d64 6573 2d63 6263 2d6d 6434 0a20 2020  =des-cbc-md4.   
│ │ │ │ -00009570: 2020 6a61 7340 4a4f 5345 4653 534f 4e2e    jas@JOSEFSSON.
│ │ │ │ -00009580: 4f52 473a 0a20 2020 2020 4175 7468 7469  ORG:.     Authti
│ │ │ │ -00009590: 6d65 3a20 2020 2020 2020 4672 6920 4175  me:       Fri Au
│ │ │ │ -000095a0: 6720 3135 2030 343a 3439 3a34 3620 3230  g 15 04:49:46 20
│ │ │ │ -000095b0: 3033 0a20 2020 2020 5374 6172 7474 696d  03.     Starttim
│ │ │ │ -000095c0: 653a 2020 2020 2020 4672 6920 4175 6720  e:      Fri Aug 
│ │ │ │ -000095d0: 3135 2030 343a 3534 3a33 3320 3230 3033  15 04:54:33 2003
│ │ │ │ -000095e0: 0a20 2020 2020 456e 6474 696d 653a 2020  .     Endtime:  
│ │ │ │ -000095f0: 2020 2020 2020 4672 6920 4175 6720 3135        Fri Aug 15
│ │ │ │ -00009600: 2030 353a 3036 3a32 3620 3230 3033 0a20   05:06:26 2003. 
│ │ │ │ -00009610: 2020 2020 5365 7276 6572 3a20 2020 2020      Server:     
│ │ │ │ -00009620: 2020 2020 7573 6572 2f62 696c 6c67 206b      user/billg k
│ │ │ │ -00009630: 6579 2064 6573 2d63 6263 2d6d 6434 2028  ey des-cbc-md4 (
│ │ │ │ -00009640: 3229 0a20 2020 2020 5469 636b 6574 206b  2).     Ticket k
│ │ │ │ -00009650: 6579 3a20 2020 2020 6465 732d 6362 632d  ey:     des-cbc-
│ │ │ │ -00009660: 6d64 3420 2832 2920 7072 6f74 6563 7465  md4 (2) protecte
│ │ │ │ -00009670: 6420 6279 2064 6573 2d63 6263 2d6d 6435  d by des-cbc-md5
│ │ │ │ -00009680: 2028 3329 0a20 2020 2020 240a 0a20 2020   (3).     $..   
│ │ │ │ -00009690: 4173 2079 6f75 2063 616e 2073 6565 2c20  As you can see, 
│ │ │ │ -000096a0: 4920 6163 7175 6972 6564 2061 2074 6963  I acquired a tic
│ │ │ │ -000096b0: 6b65 7420 666f 7220 e280 9875 7365 722f  ket for ...user/
│ │ │ │ -000096c0: 6269 6c6c 67e2 8099 2077 6974 6820 610a  billg... with a.
│ │ │ │ -000096d0: e280 9864 6573 2d63 6263 2d6d 6434 e280  ...des-cbc-md4..
│ │ │ │ -000096e0: 9920 282a 6e6f 7465 2043 7279 7074 6f67  . (*note Cryptog
│ │ │ │ -000096f0: 7261 7068 6963 204f 7665 7276 6965 773a  raphic Overview:
│ │ │ │ -00009700: 3a29 2065 6e63 7279 7074 696f 6e20 6b65  :) encryption ke
│ │ │ │ -00009710: 7920 7370 6563 6966 6965 640a 7769 7468  y specified.with
│ │ │ │ -00009720: 2074 6865 20e2 8098 2d2d 656e 6372 7970   the ...--encryp
│ │ │ │ -00009730: 7469 6f6e 2d74 7970 65e2 8099 2070 6172  tion-type... par
│ │ │ │ -00009740: 616d 6574 6572 2e0a 0a20 2020 546f 2077  ameter...   To w
│ │ │ │ -00009750: 7261 7020 7570 2074 6869 7320 696e 7472  rap up this intr
│ │ │ │ -00009760: 6f64 7563 7469 6f6e 2c20 6c65 7420 7573  oduction, let us
│ │ │ │ -00009770: 2073 6565 2068 6f77 2079 6f75 2063 616e   see how you can
│ │ │ │ -00009780: 2072 656d 6f76 6520 7469 636b 6574 732e   remove tickets.
│ │ │ │ -00009790: 0a59 6f75 206d 6179 2077 616e 7420 746f  .You may want to
│ │ │ │ -000097a0: 2064 6f20 7468 6973 2069 6620 796f 7520   do this if you 
│ │ │ │ -000097b0: 6c65 6176 6520 796f 7572 2074 6572 6d69  leave your termi
│ │ │ │ -000097c0: 6e61 6c20 666f 7220 6c75 6e63 6820 6f72  nal for lunch or
│ │ │ │ -000097d0: 2073 696d 696c 6172 2c0a 616e 6420 646f   similar,.and do
│ │ │ │ -000097e0: 6e27 7420 7761 6e74 2073 6f6d 656f 6e65  n't want someone
│ │ │ │ -000097f0: 2074 6f20 6265 2061 626c 6520 746f 2063   to be able to c
│ │ │ │ -00009800: 6f70 7920 7468 6520 6669 6c65 2061 6e64  opy the file and
│ │ │ │ -00009810: 2074 6865 6e20 7573 6520 796f 7572 0a63   then use your.c
│ │ │ │ -00009820: 7265 6465 6e74 6961 6c73 2e20 204e 6f74  redentials.  Not
│ │ │ │ -00009830: 6520 7468 6174 2074 6869 7320 6f6e 6c79  e that this only
│ │ │ │ -00009840: 2064 6573 7472 6f79 7320 7468 6520 7469   destroys the ti
│ │ │ │ -00009850: 636b 6574 7320 6c6f 6361 6c6c 792c 2069  ckets locally, i
│ │ │ │ -00009860: 7420 646f 6573 0a6e 6f74 2063 6f6e 7461  t does.not conta
│ │ │ │ -00009870: 6374 2061 6e79 2073 6572 7665 7220 7465  ct any server te
│ │ │ │ -00009880: 6c6c 696e 6720 7468 6174 2074 6865 7365  lling that these
│ │ │ │ -00009890: 2063 7265 6465 6e74 6961 6c73 2061 7265   credentials are
│ │ │ │ -000098a0: 206e 6f20 6c6f 6e67 6572 0a76 616c 6964   no longer.valid
│ │ │ │ -000098b0: 2e20 2053 6f2c 2069 6620 736f 6d65 6f6e  .  So, if someon
│ │ │ │ -000098c0: 6520 7374 6f6c 6520 796f 7572 2074 6963  e stole your tic
│ │ │ │ -000098d0: 6b65 7420 6669 6c65 2c20 796f 7520 6d75  ket file, you mu
│ │ │ │ -000098e0: 7374 2073 7469 6c6c 2063 6f6e 7461 6374  st still contact
│ │ │ │ -000098f0: 0a79 6f75 7220 6164 6d69 6e69 7374 7261  .your administra
│ │ │ │ -00009900: 746f 7220 616e 6420 6861 7665 2074 6865  tor and have the
│ │ │ │ -00009910: 6d20 7265 7365 7420 796f 7572 2061 6363  m reset your acc
│ │ │ │ -00009920: 6f75 6e74 2e20 2053 696d 706c 7920 7573  ount.  Simply us
│ │ │ │ -00009930: 696e 6720 7468 6973 0a73 7769 7463 6820  ing this.switch 
│ │ │ │ -00009940: 6973 206e 6f74 2073 7566 6669 6369 656e  is not sufficien
│ │ │ │ -00009950: 742e 0a0a 2020 2020 2024 2073 6869 7368  t...     $ shish
│ │ │ │ -00009960: 6920 2d2d 7365 7276 6572 2d6e 616d 653d  i --server-name=
│ │ │ │ -00009970: 696d 6170 2f6c 6174 7465 2e6a 6f73 6566  imap/latte.josef
│ │ │ │ -00009980: 7373 6f6e 2e6f 7267 202d 2d64 6573 7472  sson.org --destr
│ │ │ │ -00009990: 6f79 0a20 2020 2020 3120 7469 636b 6574  oy.     1 ticket
│ │ │ │ -000099a0: 2072 656d 6f76 6564 2e0a 2020 2020 2024   removed..     $
│ │ │ │ -000099b0: 2073 6869 7368 6920 2d2d 7365 7276 6572   shishi --server
│ │ │ │ -000099c0: 2d6e 616d 653d 666f 6f62 6172 202d 2d64  -name=foobar --d
│ │ │ │ -000099d0: 6573 7472 6f79 0a20 2020 2020 4e6f 2074  estroy.     No t
│ │ │ │ -000099e0: 6963 6b65 7473 2072 656d 6f76 6564 2e0a  ickets removed..
│ │ │ │ -000099f0: 2020 2020 2024 2073 6869 7368 6920 2d2d       $ shishi --
│ │ │ │ -00009a00: 6465 7374 726f 790a 2020 2020 2033 2074  destroy.     3 t
│ │ │ │ -00009a10: 6963 6b65 7473 2072 656d 6f76 6564 2e0a  ickets removed..
│ │ │ │ -00009a20: 2020 2020 2024 0a0a 2020 2053 696e 6365       $..   Since
│ │ │ │ -00009a30: 2074 6865 20e2 8098 2d2d 7365 7276 6572   the ...--server
│ │ │ │ -00009a40: 2d6e 616d 65e2 8099 2070 6172 616d 6574  -name... paramet
│ │ │ │ -00009a50: 6572 2074 616b 6573 2061 206c 6f6e 6720  er takes a long 
│ │ │ │ -00009a60: 7374 7269 6e67 2074 6f20 7479 7065 2c20  string to type, 
│ │ │ │ -00009a70: 6974 0a69 7320 706f 7373 6962 6c65 2074  it.is possible t
│ │ │ │ -00009a80: 6f20 7479 7065 2074 6865 2073 6572 7665  o type the serve
│ │ │ │ -00009a90: 7220 6e61 6d65 2064 6972 6563 746c 792c  r name directly,
│ │ │ │ -00009aa0: 2061 6674 6572 2074 6865 2063 6c69 656e   after the clien
│ │ │ │ -00009ab0: 7420 6e61 6d65 2e0a 5468 6520 666f 6c6c  t name..The foll
│ │ │ │ -00009ac0: 6f77 696e 6720 6578 616d 706c 6520 6465  owing example de
│ │ │ │ -00009ad0: 6d6f 6e73 7472 6174 6573 2061 6e20 4153  monstrates an AS
│ │ │ │ -00009ae0: 2d52 4551 2066 6f6c 6c6f 7765 6420 6279  -REQ followed by
│ │ │ │ -00009af0: 2061 2054 4753 2d52 4551 2066 6f72 2061   a TGS-REQ for a
│ │ │ │ -00009b00: 0a73 7065 6369 6669 6320 7365 7276 6572  .specific server
│ │ │ │ -00009b10: 2028 6173 7375 6d69 6e67 2079 6f75 2064   (assuming you d
│ │ │ │ -00009b20: 6964 206e 6f74 2068 6176 6520 616e 7920  id not have any 
│ │ │ │ -00009b30: 7469 636b 6574 7320 746f 2062 6567 696e  tickets to begin
│ │ │ │ -00009b40: 2077 6974 6829 2e0a 0a20 2020 2020 2420   with)...     $ 
│ │ │ │ -00009b50: 7372 632f 7368 6973 6869 2073 696d 6f6e  src/shishi simon
│ │ │ │ -00009b60: 406c 6174 7465 2e6a 6f73 6566 7373 6f6e  @latte.josefsson
│ │ │ │ -00009b70: 2e6f 7267 2069 6d61 702f 6c61 7474 652e  .org imap/latte.
│ │ │ │ -00009b80: 6a6f 7365 6673 736f 6e2e 6f72 670a 2020  josefsson.org.  
│ │ │ │ -00009b90: 2020 2045 6e74 6572 2070 6173 7377 6f72     Enter passwor
│ │ │ │ -00009ba0: 6420 666f 7220 6073 696d 6f6e 406c 6174  d for `simon@lat
│ │ │ │ -00009bb0: 7465 2e6a 6f73 6566 7373 6f6e 2e6f 7267  te.josefsson.org
│ │ │ │ -00009bc0: 273a 0a20 2020 2020 7369 6d6f 6e40 6c61  ':.     simon@la
│ │ │ │ -00009bd0: 7474 652e 6a6f 7365 6673 736f 6e2e 6f72  tte.josefsson.or
│ │ │ │ -00009be0: 673a 0a20 2020 2020 4163 7175 6972 6564  g:.     Acquired
│ │ │ │ -00009bf0: 3a20 2020 2020 2020 5765 6420 4175 6720  :       Wed Aug 
│ │ │ │ -00009c00: 3237 2031 373a 3231 3a30 3620 3230 3033  27 17:21:06 2003
│ │ │ │ -00009c10: 0a20 2020 2020 4578 7069 7265 733a 2020  .     Expires:  
│ │ │ │ -00009c20: 2020 2020 2020 5765 6420 4175 6720 3237        Wed Aug 27
│ │ │ │ -00009c30: 2031 373a 3337 3a34 3620 3230 3033 0a20   17:37:46 2003. 
│ │ │ │ -00009c40: 2020 2020 5365 7276 6572 3a20 2020 2020      Server:     
│ │ │ │ -00009c50: 2020 2020 696d 6170 2f6c 6174 7465 2e6a      imap/latte.j
│ │ │ │ -00009c60: 6f73 6566 7373 6f6e 2e6f 7267 206b 6579  osefsson.org key
│ │ │ │ -00009c70: 2061 6573 3235 362d 6374 732d 686d 6163   aes256-cts-hmac
│ │ │ │ -00009c80: 2d73 6861 312d 3936 2028 3138 290a 2020  -sha1-96 (18).  
│ │ │ │ -00009c90: 2020 2054 6963 6b65 7420 6b65 793a 2020     Ticket key:  
│ │ │ │ -00009ca0: 2020 2061 6573 3235 362d 6374 732d 686d     aes256-cts-hm
│ │ │ │ -00009cb0: 6163 2d73 6861 312d 3936 2028 3138 2920  ac-sha1-96 (18) 
│ │ │ │ -00009cc0: 7072 6f74 6563 7465 6420 6279 2061 6573  protected by aes
│ │ │ │ -00009cd0: 3235 362d 6374 732d 686d 6163 2d73 6861  256-cts-hmac-sha
│ │ │ │ -00009ce0: 312d 3936 2028 3138 290a 2020 2020 2054  1-96 (18).     T
│ │ │ │ -00009cf0: 6963 6b65 7420 666c 6167 733a 2020 2046  icket flags:   F
│ │ │ │ -00009d00: 4f52 5741 5244 4544 2050 524f 5849 4142  ORWARDED PROXIAB
│ │ │ │ -00009d10: 4c45 2028 3132 290a 2020 2020 2024 0a0a  LE (12).     $..
│ │ │ │ -00009d20: 2020 2052 6566 6572 2074 6f20 7468 6520     Refer to the 
│ │ │ │ -00009d30: 7265 6665 7265 6e63 6520 6d61 6e75 616c  reference manual
│ │ │ │ -00009d40: 2066 6f72 2061 6c6c 2061 7661 696c 6162   for all availab
│ │ │ │ -00009d50: 6c65 2070 6172 616d 6574 6572 7320 282a  le parameters (*
│ │ │ │ -00009d60: 6e6f 7465 0a50 6172 616d 6574 6572 7320  note.Parameters 
│ │ │ │ -00009d70: 666f 7220 7368 6973 6869 3a3a 292e 2020  for shishi::).  
│ │ │ │ -00009d80: 5468 6520 7265 7374 206f 6620 7468 6973  The rest of this
│ │ │ │ -00009d90: 2073 6563 7469 6f6e 2063 6f6e 7461 696e   section contain
│ │ │ │ -00009da0: 730a 6465 7363 7269 7074 696f 6e73 206f  s.descriptions o
│ │ │ │ -00009db0: 6620 6d6f 7265 2073 7065 6369 616c 697a  f more specializ
│ │ │ │ -00009dc0: 6564 2075 7361 6765 206d 6f64 6573 2074  ed usage modes t
│ │ │ │ -00009dd0: 6861 7420 6361 6e20 6265 2069 676e 6f72  hat can be ignor
│ │ │ │ -00009de0: 6564 2062 7920 6d6f 7374 0a75 7365 7273  ed by most.users
│ │ │ │ -00009df0: 2e0a 0a32 2e31 2050 726f 7869 6162 6c65  ...2.1 Proxiable
│ │ │ │ -00009e00: 2061 6e64 2050 726f 7879 2054 6963 6b65   and Proxy Ticke
│ │ │ │ -00009e10: 7473 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ts.=============
│ │ │ │ +00007500: 3d3d 3d3d 3d3d 3d3d 3d0a 0a54 6865 2070  =========..The p
│ │ │ │ +00007510: 6163 6b61 6765 2063 616e 2062 6520 646f  ackage can be do
│ │ │ │ +00007520: 776e 6c6f 6164 6564 2066 726f 6d20 7365  wnloaded from se
│ │ │ │ +00007530: 7665 7261 6c20 706c 6163 6573 2c20 696e  veral places, in
│ │ │ │ +00007540: 636c 7564 696e 673a 0a0a 2020 203c 6674  cluding:..   <ft
│ │ │ │ +00007550: 703a 2f2f 616c 7068 612e 676e 752e 6f72  p://alpha.gnu.or
│ │ │ │ +00007560: 672f 7075 622f 676e 752f 7368 6973 6869  g/pub/gnu/shishi
│ │ │ │ +00007570: 2f3e 0a0a 2020 2054 6865 206c 6174 6573  />..   The lates
│ │ │ │ +00007580: 7420 7665 7273 696f 6e20 6973 2073 746f  t version is sto
│ │ │ │ +00007590: 7265 6420 696e 2061 2066 696c 652c 2065  red in a file, e
│ │ │ │ +000075a0: 2e67 2e2c 20e2 8098 7368 6973 6869 2d31  .g., ...shishi-1
│ │ │ │ +000075b0: 2e30 2e33 2e74 6172 2e67 7ae2 8099 0a77  .0.3.tar.gz....w
│ │ │ │ +000075c0: 6865 7265 2074 6865 20e2 8098 312e 302e  here the ...1.0.
│ │ │ │ +000075d0: 33e2 8099 2069 6e64 6963 6174 6520 7468  3... indicate th
│ │ │ │ +000075e0: 6520 6869 6768 6573 7420 7665 7273 696f  e highest versio
│ │ │ │ +000075f0: 6e20 6e75 6d62 6572 2e0a 0a20 2020 5468  n number...   Th
│ │ │ │ +00007600: 6520 7061 636b 6167 6520 6973 2074 6865  e package is the
│ │ │ │ +00007610: 6e20 6578 7472 6163 7465 642c 2063 6f6e  n extracted, con
│ │ │ │ +00007620: 6669 6775 7265 6420 616e 6420 6275 696c  figured and buil
│ │ │ │ +00007630: 7420 6c69 6b65 206d 616e 7920 6f74 6865  t like many othe
│ │ │ │ +00007640: 720a 7061 636b 6167 6573 2074 6861 7420  r.packages that 
│ │ │ │ +00007650: 7573 6520 4175 746f 636f 6e66 2e20 2046  use Autoconf.  F
│ │ │ │ +00007660: 6f72 2064 6574 6169 6c65 6420 696e 666f  or detailed info
│ │ │ │ +00007670: 726d 6174 696f 6e20 6f6e 2063 6f6e 6669  rmation on confi
│ │ │ │ +00007680: 6775 7269 6e67 2061 6e64 0a62 7569 6c64  guring and.build
│ │ │ │ +00007690: 696e 6720 6974 2c20 7265 6665 7220 746f  ing it, refer to
│ │ │ │ +000076a0: 2074 6865 20e2 8098 494e 5354 414c 4ce2   the ...INSTALL.
│ │ │ │ +000076b0: 8099 2066 696c 6520 7468 6174 2069 7320  .. file that is 
│ │ │ │ +000076c0: 7061 7274 206f 6620 7468 650a 6469 7374  part of the.dist
│ │ │ │ +000076d0: 7269 6275 7469 6f6e 2061 7263 6869 7665  ribution archive
│ │ │ │ +000076e0: 2e0a 0a20 2020 4865 7265 2069 7320 616e  ...   Here is an
│ │ │ │ +000076f0: 2065 7861 6d70 6c65 2074 6572 6d69 6e61   example termina
│ │ │ │ +00007700: 6c20 7365 7373 696f 6e20 7468 6174 2064  l session that d
│ │ │ │ +00007710: 6f77 6e6c 6f61 642c 2063 6f6e 6669 6775  ownload, configu
│ │ │ │ +00007720: 7265 2c20 6275 696c 640a 616e 6420 696e  re, build.and in
│ │ │ │ +00007730: 7374 616c 6c20 7468 6520 7061 636b 6167  stall the packag
│ │ │ │ +00007740: 652e 2020 596f 7520 7769 6c6c 206e 6565  e.  You will nee
│ │ │ │ +00007750: 6420 6120 6665 7720 6261 7369 6320 746f  d a few basic to
│ │ │ │ +00007760: 6f6c 732c 2073 7563 6820 6173 20e2 8098  ols, such as ...
│ │ │ │ +00007770: 7368 e280 992c 0ae2 8098 6d61 6b65 e280  sh...,....make..
│ │ │ │ +00007780: 9920 616e 6420 e280 9863 63e2 8099 2e0a  . and ...cc.....
│ │ │ │ +00007790: 0a20 2020 2020 2420 7767 6574 202d 7120  .     $ wget -q 
│ │ │ │ +000077a0: 6674 703a 2f2f 616c 7068 612e 676e 752e  ftp://alpha.gnu.
│ │ │ │ +000077b0: 6f72 672f 7075 622f 676e 752f 7368 6973  org/pub/gnu/shis
│ │ │ │ +000077c0: 6869 2f73 6869 7368 692d 312e 302e 332e  hi/shishi-1.0.3.
│ │ │ │ +000077d0: 7461 722e 677a 0a20 2020 2020 2420 7461  tar.gz.     $ ta
│ │ │ │ +000077e0: 7220 7866 7a20 7368 6973 6869 2d31 2e30  r xfz shishi-1.0
│ │ │ │ +000077f0: 2e33 2e74 6172 2e67 7a0a 2020 2020 2024  .3.tar.gz.     $
│ │ │ │ +00007800: 2063 6420 7368 6973 6869 2d31 2e30 2e33   cd shishi-1.0.3
│ │ │ │ +00007810: 2f0a 2020 2020 2024 202e 2f63 6f6e 6669  /.     $ ./confi
│ │ │ │ +00007820: 6775 7265 0a20 2020 2020 2e2e 2e0a 2020  gure.     ....  
│ │ │ │ +00007830: 2020 2024 206d 616b 650a 2020 2020 202e     $ make.     .
│ │ │ │ +00007840: 2e2e 0a20 2020 2020 2420 6d61 6b65 2069  ...     $ make i
│ │ │ │ +00007850: 6e73 7461 6c6c 0a20 2020 2020 2e2e 2e0a  nstall.     ....
│ │ │ │ +00007860: 0a20 2020 4166 7465 7220 7468 6973 2079  .   After this y
│ │ │ │ +00007870: 6f75 2073 686f 756c 6420 6265 2070 7265  ou should be pre
│ │ │ │ +00007880: 7061 7265 6420 746f 2063 6f6e 7469 6e75  pared to continu
│ │ │ │ +00007890: 6520 7769 7468 2074 6865 2075 7365 722c  e with the user,
│ │ │ │ +000078a0: 0a61 646d 696e 6973 7472 6174 696f 6e20  .administration 
│ │ │ │ +000078b0: 6f72 2070 726f 6772 616d 6d69 6e67 206d  or programming m
│ │ │ │ +000078c0: 616e 7561 6c2c 2064 6570 656e 6469 6e67  anual, depending
│ │ │ │ +000078d0: 206f 6e20 686f 7720 796f 7520 7761 6e74   on how you want
│ │ │ │ +000078e0: 2074 6f20 7573 650a 5368 6973 6869 2e0a   to use.Shishi..
│ │ │ │ +000078f0: 0a20 2020 4120 6665 7720 e280 9863 6f6e  .   A few ...con
│ │ │ │ +00007900: 6669 6775 7265 e280 9920 6f70 7469 6f6e  figure... option
│ │ │ │ +00007910: 7320 6d61 7920 6265 2072 656c 6576 616e  s may be relevan
│ │ │ │ +00007920: 742c 2073 756d 6d61 7269 7a65 6420 696e  t, summarized in
│ │ │ │ +00007930: 2074 6865 2074 6162 6c65 2e0a 0ae2 8098   the table......
│ │ │ │ +00007940: 2d2d 6469 7361 626c 652d 6465 73e2 8099  --disable-des...
│ │ │ │ +00007950: 0ae2 8098 2d2d 6469 7361 626c 652d 3364  ....--disable-3d
│ │ │ │ +00007960: 6573 e280 990a e280 982d 2d64 6973 6162  es.......--disab
│ │ │ │ +00007970: 6c65 2d61 6573 e280 990a e280 982d 2d64  le-aes.......--d
│ │ │ │ +00007980: 6973 6162 6c65 2d6d 64e2 8099 0ae2 8098  isable-md.......
│ │ │ │ +00007990: 2d2d 6469 7361 626c 652d 6e75 6c6c e280  --disable-null..
│ │ │ │ +000079a0: 990a e280 982d 2d64 6973 6162 6c65 2d61  .....--disable-a
│ │ │ │ +000079b0: 7263 666f 7572 e280 990a 2020 2020 2044  rcfour....     D
│ │ │ │ +000079c0: 6973 6162 6c65 2061 2063 7279 7074 6f67  isable a cryptog
│ │ │ │ +000079d0: 7261 7068 6963 2061 6c67 6f72 6974 686d  raphic algorithm
│ │ │ │ +000079e0: 2061 7420 636f 6d70 696c 6520 7469 6d65   at compile time
│ │ │ │ +000079f0: 2e20 2055 7375 616c 6c79 2069 7420 6973  .  Usually it is
│ │ │ │ +00007a00: 0a20 2020 2020 6265 7474 6572 2074 6f20  .     better to 
│ │ │ │ +00007a10: 6469 7361 626c 6520 616c 676f 7269 7468  disable algorith
│ │ │ │ +00007a20: 6d73 2064 7572 696e 6720 7275 6e2d 7469  ms during run-ti
│ │ │ │ +00007a30: 6d65 2077 6974 6820 7468 6520 636f 6e66  me with the conf
│ │ │ │ +00007a40: 6967 7572 6174 696f 6e0a 2020 2020 2066  iguration.     f
│ │ │ │ +00007a50: 696c 652c 2062 7574 2074 6869 7320 616c  ile, but this al
│ │ │ │ +00007a60: 6c6f 7773 2079 6f75 2074 6f20 7265 6475  lows you to redu
│ │ │ │ +00007a70: 6365 2074 6865 2063 6f64 6520 7369 7a65  ce the code size
│ │ │ │ +00007a80: 2073 6c69 6768 746c 792e 0a0a e280 982d   slightly......-
│ │ │ │ +00007a90: 2d64 6973 6162 6c65 2d73 7461 7274 746c  -disable-starttl
│ │ │ │ +00007aa0: 73e2 8099 0a20 2020 2020 4469 7361 626c  s....     Disabl
│ │ │ │ +00007ab0: 6520 7468 6520 6578 7065 7269 6d65 6e74  e the experiment
│ │ │ │ +00007ac0: 616c 2054 4c53 2073 7570 706f 7274 2066  al TLS support f
│ │ │ │ +00007ad0: 6f72 204b 4443 2063 6f6e 6e65 6374 696f  or KDC connectio
│ │ │ │ +00007ae0: 6e73 2e20 2049 6620 796f 750a 2020 2020  ns.  If you.    
│ │ │ │ +00007af0: 2064 6f20 6e6f 7420 7573 6520 6120 5368   do not use a Sh
│ │ │ │ +00007b00: 6973 6869 204b 4443 2c20 7468 6973 2073  ishi KDC, this s
│ │ │ │ +00007b10: 7570 706f 7274 2069 7320 6f66 206e 6f20  upport is of no 
│ │ │ │ +00007b20: 7573 6520 736f 2079 6f75 2063 6f75 6c64  use so you could
│ │ │ │ +00007b30: 0a20 2020 2020 7361 6665 6c79 2064 6973  .     safely dis
│ │ │ │ +00007b40: 6162 6c65 2069 742e 0a0a e280 982d 2d77  able it......--w
│ │ │ │ +00007b50: 6974 686f 7574 2d73 7472 696e 6770 7265  ithout-stringpre
│ │ │ │ +00007b60: 70e2 8099 0a20 2020 2020 4469 7361 626c  p....     Disabl
│ │ │ │ +00007b70: 6520 696e 7465 726e 6174 696f 6e61 6c69  e internationali
│ │ │ │ +00007b80: 7a65 6420 7374 7269 6e67 2070 726f 6365  zed string proce
│ │ │ │ +00007b90: 7373 696e 672e 0a0a 2020 2046 6f72 2074  ssing...   For t
│ │ │ │ +00007ba0: 6865 2063 6f6d 706c 6574 6520 6c69 7374  he complete list
│ │ │ │ +00007bb0: 2c20 7265 6665 7220 746f 2074 6865 206f  , refer to the o
│ │ │ │ +00007bc0: 7574 7075 7420 6672 6f6d 20e2 8098 636f  utput from ...co
│ │ │ │ +00007bd0: 6e66 6967 7572 6520 2d2d 6865 6c70 e280  nfigure --help..
│ │ │ │ +00007be0: 992e 0a0a 1f0a 4669 6c65 3a20 7368 6973  ......File: shis
│ │ │ │ +00007bf0: 6869 2e69 6e66 6f2c 2020 4e6f 6465 3a20  hi.info,  Node: 
│ │ │ │ +00007c00: 4275 6720 5265 706f 7274 732c 2020 4e65  Bug Reports,  Ne
│ │ │ │ +00007c10: 7874 3a20 436f 6e74 7269 6275 7469 6e67  xt: Contributing
│ │ │ │ +00007c20: 2c20 2050 7265 763a 2044 6f77 6e6c 6f61  ,  Prev: Downloa
│ │ │ │ +00007c30: 6469 6e67 2061 6e64 2049 6e73 7461 6c6c  ding and Install
│ │ │ │ +00007c40: 696e 672c 2020 5570 3a20 496e 7472 6f64  ing,  Up: Introd
│ │ │ │ +00007c50: 7563 7469 6f6e 0a0a 312e 3820 4275 6720  uction..1.8 Bug 
│ │ │ │ +00007c60: 5265 706f 7274 730a 3d3d 3d3d 3d3d 3d3d  Reports.========
│ │ │ │ +00007c70: 3d3d 3d3d 3d3d 3d0a 0a49 6620 796f 7520  =======..If you 
│ │ │ │ +00007c80: 7468 696e 6b20 796f 7520 6861 7665 2066  think you have f
│ │ │ │ +00007c90: 6f75 6e64 2061 2062 7567 2069 6e20 5368  ound a bug in Sh
│ │ │ │ +00007ca0: 6973 6869 2c20 706c 6561 7365 2069 6e76  ishi, please inv
│ │ │ │ +00007cb0: 6573 7469 6761 7465 2069 7420 616e 640a  estigate it and.
│ │ │ │ +00007cc0: 7265 706f 7274 2069 742e 0a0a 2020 20e2  report it...   .
│ │ │ │ +00007cd0: 80a2 2050 6c65 6173 6520 6d61 6b65 2073  .. Please make s
│ │ │ │ +00007ce0: 7572 6520 7468 6174 2074 6865 2062 7567  ure that the bug
│ │ │ │ +00007cf0: 2069 7320 7265 616c 6c79 2069 6e20 5368   is really in Sh
│ │ │ │ +00007d00: 6973 6869 2c20 616e 6420 7072 6566 6572  ishi, and prefer
│ │ │ │ +00007d10: 6162 6c79 0a20 2020 2020 616c 736f 2063  ably.     also c
│ │ │ │ +00007d20: 6865 636b 2074 6861 7420 6974 2068 6173  heck that it has
│ │ │ │ +00007d30: 6e27 7420 616c 7265 6164 7920 6265 656e  n't already been
│ │ │ │ +00007d40: 2066 6978 6564 2069 6e20 7468 6520 6c61   fixed in the la
│ │ │ │ +00007d50: 7465 7374 2076 6572 7369 6f6e 2e0a 0a20  test version... 
│ │ │ │ +00007d60: 2020 e280 a220 596f 7520 6861 7665 2074    ... You have t
│ │ │ │ +00007d70: 6f20 7365 6e64 2075 7320 6120 7465 7374  o send us a test
│ │ │ │ +00007d80: 2063 6173 6520 7468 6174 206d 616b 6573   case that makes
│ │ │ │ +00007d90: 2069 7420 706f 7373 6962 6c65 2066 6f72   it possible for
│ │ │ │ +00007da0: 2075 7320 746f 0a20 2020 2020 7265 7072   us to.     repr
│ │ │ │ +00007db0: 6f64 7563 6520 7468 6520 6275 672e 0a0a  oduce the bug...
│ │ │ │ +00007dc0: 2020 20e2 80a2 2059 6f75 2061 6c73 6f20     ... You also 
│ │ │ │ +00007dd0: 6861 7665 2074 6f20 6578 706c 6169 6e20  have to explain 
│ │ │ │ +00007de0: 7768 6174 2069 7320 7772 6f6e 673b 2069  what is wrong; i
│ │ │ │ +00007df0: 6620 796f 7520 6765 7420 6120 6372 6173  f you get a cras
│ │ │ │ +00007e00: 682c 206f 7220 6966 0a20 2020 2020 7468  h, or if.     th
│ │ │ │ +00007e10: 6520 7265 7375 6c74 7320 7072 696e 7465  e results printe
│ │ │ │ +00007e20: 6420 6172 6520 6e6f 7420 676f 6f64 2061  d are not good a
│ │ │ │ +00007e30: 6e64 2069 6e20 7468 6174 2063 6173 652c  nd in that case,
│ │ │ │ +00007e40: 2069 6e20 7768 6174 2077 6179 2e0a 2020   in what way..  
│ │ │ │ +00007e50: 2020 204d 616b 6520 7375 7265 2074 6861     Make sure tha
│ │ │ │ +00007e60: 7420 7468 6520 6275 6720 7265 706f 7274  t the bug report
│ │ │ │ +00007e70: 2069 6e63 6c75 6465 7320 616c 6c20 696e   includes all in
│ │ │ │ +00007e80: 666f 726d 6174 696f 6e20 796f 7520 776f  formation you wo
│ │ │ │ +00007e90: 756c 640a 2020 2020 206e 6565 6420 746f  uld.     need to
│ │ │ │ +00007ea0: 2066 6978 2074 6869 7320 6b69 6e64 206f   fix this kind o
│ │ │ │ +00007eb0: 6620 6275 6720 666f 7220 736f 6d65 6f6e  f bug for someon
│ │ │ │ +00007ec0: 6520 656c 7365 2e0a 0a20 2020 506c 6561  e else...   Plea
│ │ │ │ +00007ed0: 7365 206d 616b 6520 616e 2065 6666 6f72  se make an effor
│ │ │ │ +00007ee0: 7420 746f 2070 726f 6475 6365 2061 2073  t to produce a s
│ │ │ │ +00007ef0: 656c 662d 636f 6e74 6169 6e65 6420 7265  elf-contained re
│ │ │ │ +00007f00: 706f 7274 2c20 7769 7468 0a73 6f6d 6574  port, with.somet
│ │ │ │ +00007f10: 6869 6e67 2064 6566 696e 6974 6520 7468  hing definite th
│ │ │ │ +00007f20: 6174 2063 616e 2062 6520 7465 7374 6564  at can be tested
│ │ │ │ +00007f30: 206f 7220 6465 6275 6767 6564 2e20 2056   or debugged.  V
│ │ │ │ +00007f40: 6167 7565 2071 7565 7269 6573 206f 720a  ague queries or.
│ │ │ │ +00007f50: 7069 6563 656d 6561 6c20 6d65 7373 6167  piecemeal messag
│ │ │ │ +00007f60: 6573 2061 7265 2064 6966 6669 6375 6c74  es are difficult
│ │ │ │ +00007f70: 2074 6f20 6163 7420 6f6e 2061 6e64 2064   to act on and d
│ │ │ │ +00007f80: 6f6e 2774 2068 656c 7020 7468 650a 6465  on't help the.de
│ │ │ │ +00007f90: 7665 6c6f 706d 656e 7420 6566 666f 7274  velopment effort
│ │ │ │ +00007fa0: 2e0a 0a20 2020 4966 2079 6f75 7220 6275  ...   If your bu
│ │ │ │ +00007fb0: 6720 7265 706f 7274 2069 7320 676f 6f64  g report is good
│ │ │ │ +00007fc0: 2c20 7765 2077 696c 6c20 646f 206f 7572  , we will do our
│ │ │ │ +00007fd0: 2062 6573 7420 746f 2068 656c 7020 796f   best to help yo
│ │ │ │ +00007fe0: 7520 746f 2067 6574 2061 0a63 6f72 7265  u to get a.corre
│ │ │ │ +00007ff0: 6374 6564 2076 6572 7369 6f6e 206f 6620  cted version of 
│ │ │ │ +00008000: 7468 6520 736f 6674 7761 7265 3b20 6966  the software; if
│ │ │ │ +00008010: 2074 6865 2062 7567 2072 6570 6f72 7420   the bug report 
│ │ │ │ +00008020: 6973 2070 6f6f 722c 2077 6520 776f 6e27  is poor, we won'
│ │ │ │ +00008030: 740a 646f 2061 6e79 7468 696e 6720 6162  t.do anything ab
│ │ │ │ +00008040: 6f75 7420 6974 2028 6170 6172 7420 6672  out it (apart fr
│ │ │ │ +00008050: 6f6d 2061 736b 696e 6720 796f 7520 746f  om asking you to
│ │ │ │ +00008060: 2073 656e 6420 6265 7474 6572 2062 7567   send better bug
│ │ │ │ +00008070: 2072 6570 6f72 7473 292e 0a0a 2020 2049   reports)...   I
│ │ │ │ +00008080: 6620 796f 7520 7468 696e 6b20 736f 6d65  f you think some
│ │ │ │ +00008090: 7468 696e 6720 696e 2074 6869 7320 6d61  thing in this ma
│ │ │ │ +000080a0: 6e75 616c 2069 7320 756e 636c 6561 722c  nual is unclear,
│ │ │ │ +000080b0: 206f 7220 646f 776e 7269 6768 740a 696e   or downright.in
│ │ │ │ +000080c0: 636f 7272 6563 742c 206f 7220 6966 2074  correct, or if t
│ │ │ │ +000080d0: 6865 206c 616e 6775 6167 6520 6e65 6564  he language need
│ │ │ │ +000080e0: 7320 746f 2062 6520 696d 7072 6f76 6564  s to be improved
│ │ │ │ +000080f0: 2c20 706c 6561 7365 2061 6c73 6f20 7365  , please also se
│ │ │ │ +00008100: 6e64 2061 0a6e 6f74 652e 0a0a 2020 2053  nd a.note...   S
│ │ │ │ +00008110: 656e 6420 796f 7572 2062 7567 2072 6570  end your bug rep
│ │ │ │ +00008120: 6f72 7420 746f 3a0a 0a20 2020 2020 2020  ort to:..       
│ │ │ │ +00008130: 2020 2020 2020 2020 2020 2020 2020 20e2                 .
│ │ │ │ +00008140: 8098 6275 672d 7368 6973 6869 406a 6f73  ..bug-shishi@jos
│ │ │ │ +00008150: 6566 7373 6f6e 2e6f 7267 e280 990a 0a1f  efsson.org......
│ │ │ │ +00008160: 0a46 696c 653a 2073 6869 7368 692e 696e  .File: shishi.in
│ │ │ │ +00008170: 666f 2c20 204e 6f64 653a 2043 6f6e 7472  fo,  Node: Contr
│ │ │ │ +00008180: 6962 7574 696e 672c 2020 5072 6576 3a20  ibuting,  Prev: 
│ │ │ │ +00008190: 4275 6720 5265 706f 7274 732c 2020 5570  Bug Reports,  Up
│ │ │ │ +000081a0: 3a20 496e 7472 6f64 7563 7469 6f6e 0a0a  : Introduction..
│ │ │ │ +000081b0: 312e 3920 436f 6e74 7269 6275 7469 6e67  1.9 Contributing
│ │ │ │ +000081c0: 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  .===============
│ │ │ │ +000081d0: 3d0a 0a49 6620 796f 7520 7761 6e74 2074  =..If you want t
│ │ │ │ +000081e0: 6f20 7375 626d 6974 2061 2070 6174 6368  o submit a patch
│ │ │ │ +000081f0: 2066 6f72 2069 6e63 6c75 7369 6f6e 202d   for inclusion -
│ │ │ │ +00008200: 2066 726f 6d20 736f 6c76 6520 6120 7479   from solve a ty
│ │ │ │ +00008210: 706f 2079 6f75 0a64 6973 636f 7665 7265  po you.discovere
│ │ │ │ +00008220: 642c 2075 7020 746f 2061 6464 696e 6720  d, up to adding 
│ │ │ │ +00008230: 7375 7070 6f72 7420 666f 7220 6120 6e65  support for a ne
│ │ │ │ +00008240: 7720 6665 6174 7572 6520 2d20 796f 7520  w feature - you 
│ │ │ │ +00008250: 7368 6f75 6c64 2073 7562 6d69 740a 6974  should submit.it
│ │ │ │ +00008260: 2061 7320 6120 6275 6720 7265 706f 7274   as a bug report
│ │ │ │ +00008270: 2028 2a6e 6f74 6520 4275 6720 5265 706f   (*note Bug Repo
│ │ │ │ +00008280: 7274 733a 3a29 2e20 2054 6865 7265 2061  rts::).  There a
│ │ │ │ +00008290: 7265 2073 6f6d 6520 7468 696e 6773 2074  re some things t
│ │ │ │ +000082a0: 6861 740a 796f 7520 6361 6e20 646f 2074  hat.you can do t
│ │ │ │ +000082b0: 6f20 696e 6372 6561 7365 2074 6865 2063  o increase the c
│ │ │ │ +000082c0: 6861 6e63 6573 2066 6f72 2069 7420 746f  hances for it to
│ │ │ │ +000082d0: 2062 6520 696e 636c 7564 6564 2069 6e20   be included in 
│ │ │ │ +000082e0: 7468 6520 6f66 6669 6369 616c 0a70 6163  the official.pac
│ │ │ │ +000082f0: 6b61 6765 2e0a 0a20 2020 556e 6c65 7373  kage...   Unless
│ │ │ │ +00008300: 2079 6f75 7220 7061 7463 6820 6973 2076   your patch is v
│ │ │ │ +00008310: 6572 7920 736d 616c 6c20 2873 6179 2c20  ery small (say, 
│ │ │ │ +00008320: 756e 6465 7220 3130 206c 696e 6573 2920  under 10 lines) 
│ │ │ │ +00008330: 7765 2072 6571 7569 7265 2074 6861 740a  we require that.
│ │ │ │ +00008340: 796f 7520 6173 7369 676e 2074 6865 2063  you assign the c
│ │ │ │ +00008350: 6f70 7972 6967 6874 206f 6620 796f 7572  opyright of your
│ │ │ │ +00008360: 2077 6f72 6b20 746f 2074 6865 2046 7265   work to the Fre
│ │ │ │ +00008370: 6520 536f 6674 7761 7265 2046 6f75 6e64  e Software Found
│ │ │ │ +00008380: 6174 696f 6e2e 0a54 6869 7320 6973 2074  ation..This is t
│ │ │ │ +00008390: 6f20 7072 6f74 6563 7420 7468 6520 6672  o protect the fr
│ │ │ │ +000083a0: 6565 646f 6d20 6f66 2074 6865 2070 726f  eedom of the pro
│ │ │ │ +000083b0: 6a65 6374 2e20 2049 6620 796f 7520 6861  ject.  If you ha
│ │ │ │ +000083c0: 7665 206e 6f74 2061 6c72 6561 6479 0a73  ve not already.s
│ │ │ │ +000083d0: 6967 6e65 6420 7061 7065 7273 2c20 7765  igned papers, we
│ │ │ │ +000083e0: 2077 696c 6c20 7365 6e64 2079 6f75 2074   will send you t
│ │ │ │ +000083f0: 6865 206e 6563 6573 7361 7279 2069 6e66  he necessary inf
│ │ │ │ +00008400: 6f72 6d61 7469 6f6e 2077 6865 6e20 796f  ormation when yo
│ │ │ │ +00008410: 750a 7375 626d 6974 2079 6f75 7220 636f  u.submit your co
│ │ │ │ +00008420: 6e74 7269 6275 7469 6f6e 2e0a 0a20 2020  ntribution...   
│ │ │ │ +00008430: 466f 7220 636f 6e74 7269 6275 7469 6f6e  For contribution
│ │ │ │ +00008440: 7320 7468 6174 2064 6f65 736e 2774 2063  s that doesn't c
│ │ │ │ +00008450: 6f6e 7369 7374 206f 6620 6163 7475 616c  onsist of actual
│ │ │ │ +00008460: 2070 726f 6772 616d 6d69 6e67 2063 6f64   programming cod
│ │ │ │ +00008470: 652c 0a74 6865 206f 6e6c 7920 6775 6964  e,.the only guid
│ │ │ │ +00008480: 656c 696e 6573 2061 7265 2063 6f6d 6d6f  elines are commo
│ │ │ │ +00008490: 6e20 7365 6e73 652e 2020 5573 6520 6974  n sense.  Use it
│ │ │ │ +000084a0: 2e0a 0a20 2020 466f 7220 636f 6465 2063  ...   For code c
│ │ │ │ +000084b0: 6f6e 7472 6962 7574 696f 6e73 2c20 6120  ontributions, a 
│ │ │ │ +000084c0: 6e75 6d62 6572 206f 6620 7374 796c 6520  number of style 
│ │ │ │ +000084d0: 6775 6964 6573 2077 696c 6c20 6865 6c70  guides will help
│ │ │ │ +000084e0: 2079 6f75 3a0a 0a20 2020 e280 a220 436f   you:..   ... Co
│ │ │ │ +000084f0: 6469 6e67 2053 7479 6c65 2e20 2046 6f6c  ding Style.  Fol
│ │ │ │ +00008500: 6c6f 7720 7468 6520 474e 5520 5374 616e  low the GNU Stan
│ │ │ │ +00008510: 6461 7264 7320 646f 6375 6d65 6e74 2028  dards document (
│ │ │ │ +00008520: 2a6e 6f74 6520 474e 5520 436f 6469 6e67  *note GNU Coding
│ │ │ │ +00008530: 0a20 2020 2020 5374 616e 6461 7264 733a  .     Standards:
│ │ │ │ +00008540: 2028 7374 616e 6461 7264 7329 746f 702e   (standards)top.
│ │ │ │ +00008550: 292e 0a0a 2020 2020 2049 6620 796f 7520  )...     If you 
│ │ │ │ +00008560: 6e6f 726d 616c 6c79 2063 6f64 6520 7573  normally code us
│ │ │ │ +00008570: 696e 6720 616e 6f74 6865 7220 636f 6469  ing another codi
│ │ │ │ +00008580: 6e67 2073 7461 6e64 6172 642c 2074 6865  ng standard, the
│ │ │ │ +00008590: 7265 2069 7320 6e6f 0a20 2020 2020 7072  re is no.     pr
│ │ │ │ +000085a0: 6f62 6c65 6d2c 2062 7574 2079 6f75 2073  oblem, but you s
│ │ │ │ +000085b0: 686f 756c 6420 7573 6520 e280 9869 6e64  hould use ...ind
│ │ │ │ +000085c0: 656e 74e2 8099 2074 6f20 7265 666f 726d  ent... to reform
│ │ │ │ +000085d0: 6174 2074 6865 2063 6f64 6520 282a 6e6f  at the code (*no
│ │ │ │ +000085e0: 7465 0a20 2020 2020 474e 5520 496e 6465  te.     GNU Inde
│ │ │ │ +000085f0: 6e74 3a20 2869 6e64 656e 7429 746f 702e  nt: (indent)top.
│ │ │ │ +00008600: 2920 6265 666f 7265 2073 7562 6d69 7474  ) before submitt
│ │ │ │ +00008610: 696e 6720 796f 7572 2077 6f72 6b2e 0a0a  ing your work...
│ │ │ │ +00008620: 2020 20e2 80a2 2055 7365 2074 6865 2075     ... Use the u
│ │ │ │ +00008630: 6e69 6669 6564 2064 6966 6620 666f 726d  nified diff form
│ │ │ │ +00008640: 6174 20e2 8098 6469 6666 202d 75e2 8099  at ...diff -u...
│ │ │ │ +00008650: 2e0a 0a20 2020 e280 a220 5265 7475 726e  ...   ... Return
│ │ │ │ +00008660: 2065 7272 6f72 732e 2020 5468 6520 6f6e   errors.  The on
│ │ │ │ +00008670: 6c79 2076 616c 6964 2072 6561 736f 6e20  ly valid reason 
│ │ │ │ +00008680: 666f 7220 6576 6572 2061 626f 7274 696e  for ever abortin
│ │ │ │ +00008690: 6720 7468 650a 2020 2020 2065 7865 6375  g the.     execu
│ │ │ │ +000086a0: 7469 6f6e 206f 6620 7468 6520 7072 6f67  tion of the prog
│ │ │ │ +000086b0: 7261 6d20 6973 2064 7565 2074 6f20 6d65  ram is due to me
│ │ │ │ +000086c0: 6d6f 7279 2061 6c6c 6f63 6174 696f 6e20  mory allocation 
│ │ │ │ +000086d0: 6572 726f 7273 2c20 6275 740a 2020 2020  errors, but.    
│ │ │ │ +000086e0: 2066 6f72 2074 6861 7420 796f 7520 7368   for that you sh
│ │ │ │ +000086f0: 6f75 6c64 2063 616c 6c20 e280 9873 6869  ould call ...shi
│ │ │ │ +00008700: 7368 695f 7861 6c6c 6f63 5f64 6965 e280  shi_xalloc_die..
│ │ │ │ +00008710: 9920 746f 2061 6c6c 6f77 2074 6865 0a20  . to allow the. 
│ │ │ │ +00008720: 2020 2020 6170 706c 6963 6174 696f 6e20      application 
│ │ │ │ +00008730: 746f 2072 6563 6f76 6572 2069 6620 6974  to recover if it
│ │ │ │ +00008740: 2077 616e 7473 2074 6f2e 0a0a 2020 20e2   wants to...   .
│ │ │ │ +00008750: 80a2 2044 6573 6967 6e20 7769 7468 2074  .. Design with t
│ │ │ │ +00008760: 6872 6561 6420 7361 6665 7479 2069 6e20  hread safety in 
│ │ │ │ +00008770: 6d69 6e64 2e20 2044 6f6e 2774 2075 7365  mind.  Don't use
│ │ │ │ +00008780: 2067 6c6f 6261 6c20 7661 7269 6162 6c65   global variable
│ │ │ │ +00008790: 732e 0a20 2020 2020 446f 6e27 7420 6576  s..     Don't ev
│ │ │ │ +000087a0: 656e 2077 7269 7465 2074 6f20 7065 722d  en write to per-
│ │ │ │ +000087b0: 6861 6e64 6c65 2067 6c6f 6261 6c20 7661  handle global va
│ │ │ │ +000087c0: 7269 6162 6c65 7320 756e 6c65 7373 2074  riables unless t
│ │ │ │ +000087d0: 6865 0a20 2020 2020 646f 6375 6d65 6e74  he.     document
│ │ │ │ +000087e0: 6564 2062 6568 6176 696f 7572 206f 6620  ed behaviour of 
│ │ │ │ +000087f0: 7468 6520 6675 6e63 7469 6f6e 2079 6f75  the function you
│ │ │ │ +00008800: 2077 7269 7465 2069 7320 746f 2077 7269   write is to wri
│ │ │ │ +00008810: 7465 2074 6f20 7468 650a 2020 2020 2070  te to the.     p
│ │ │ │ +00008820: 6572 2d68 616e 646c 6520 676c 6f62 616c  er-handle global
│ │ │ │ +00008830: 2076 6172 6961 626c 652e 0a0a 2020 20e2   variable...   .
│ │ │ │ +00008840: 80a2 2041 766f 6964 2075 7369 6e67 2074  .. Avoid using t
│ │ │ │ +00008850: 6865 2043 206d 6174 6820 6c69 6272 6172  he C math librar
│ │ │ │ +00008860: 792e 2020 4974 2063 6175 7365 7320 7072  y.  It causes pr
│ │ │ │ +00008870: 6f62 6c65 6d73 2066 6f72 2065 6d62 6564  oblems for embed
│ │ │ │ +00008880: 6465 640a 2020 2020 2069 6d70 6c65 6d65  ded.     impleme
│ │ │ │ +00008890: 6e74 6174 696f 6e73 2c20 616e 6420 696e  ntations, and in
│ │ │ │ +000088a0: 206d 6f73 7420 7369 7475 6174 696f 6e73   most situations
│ │ │ │ +000088b0: 2069 7420 6973 2076 6572 7920 6561 7379   it is very easy
│ │ │ │ +000088c0: 2074 6f20 6176 6f69 640a 2020 2020 2075   to avoid.     u
│ │ │ │ +000088d0: 7369 6e67 2069 742e 0a0a 2020 20e2 80a2  sing it...   ...
│ │ │ │ +000088e0: 2044 6f63 756d 656e 7420 796f 7572 2066   Document your f
│ │ │ │ +000088f0: 756e 6374 696f 6e73 2e20 2055 7365 2063  unctions.  Use c
│ │ │ │ +00008900: 6f6d 6d65 6e74 7320 6265 666f 7265 2065  omments before e
│ │ │ │ +00008910: 6163 6820 6675 6e63 7469 6f6e 0a20 2020  ach function.   
│ │ │ │ +00008920: 2020 6865 6164 6572 732c 2074 6861 742c    headers, that,
│ │ │ │ +00008930: 2069 6620 7072 6f70 6572 6c79 2066 6f72   if properly for
│ │ │ │ +00008940: 6d61 7474 6564 2c20 6172 6520 6578 7472  matted, are extr
│ │ │ │ +00008950: 6163 7465 6420 696e 746f 2054 6578 696e  acted into Texin
│ │ │ │ +00008960: 666f 0a20 2020 2020 6d61 6e75 616c 7320  fo.     manuals 
│ │ │ │ +00008970: 616e 6420 4754 4b2d 444f 4320 7765 6220  and GTK-DOC web 
│ │ │ │ +00008980: 7061 6765 732e 0a0a 2020 20e2 80a2 2053  pages...   ... S
│ │ │ │ +00008990: 7570 706c 7920 6120 4368 616e 6765 4c6f  upply a ChangeLo
│ │ │ │ +000089a0: 6720 616e 6420 4e45 5753 2065 6e74 7269  g and NEWS entri
│ │ │ │ +000089b0: 6573 2c20 7768 6572 6520 6170 7072 6f70  es, where approp
│ │ │ │ +000089c0: 7269 6174 652e 0a0a 1f0a 4669 6c65 3a20  riate.....File: 
│ │ │ │ +000089d0: 7368 6973 6869 2e69 6e66 6f2c 2020 4e6f  shishi.info,  No
│ │ │ │ +000089e0: 6465 3a20 5573 6572 204d 616e 7561 6c2c  de: User Manual,
│ │ │ │ +000089f0: 2020 4e65 7874 3a20 4164 6d69 6e69 7374    Next: Administ
│ │ │ │ +00008a00: 7261 7469 6f6e 204d 616e 7561 6c2c 2020  ration Manual,  
│ │ │ │ +00008a10: 5072 6576 3a20 496e 7472 6f64 7563 7469  Prev: Introducti
│ │ │ │ +00008a20: 6f6e 2c20 2055 703a 2054 6f70 0a0a 3220  on,  Up: Top..2 
│ │ │ │ +00008a30: 5573 6572 204d 616e 7561 6c0a 2a2a 2a2a  User Manual.****
│ │ │ │ +00008a40: 2a2a 2a2a 2a2a 2a2a 2a0a 0a55 7375 616c  *********..Usual
│ │ │ │ +00008a50: 6c79 2053 6869 7368 6920 696e 7465 7261  ly Shishi intera
│ │ │ │ +00008a60: 6374 7320 7769 7468 2079 6f75 2074 6f20  cts with you to 
│ │ │ │ +00008a70: 6765 7420 736f 6d65 2069 6e69 7469 616c  get some initial
│ │ │ │ +00008a80: 2061 7574 6865 6e74 6963 6174 696f 6e0a   authentication.
│ │ │ │ +00008a90: 696e 666f 726d 6174 696f 6e20 6c69 6b65  information like
│ │ │ │ +00008aa0: 2061 2070 6173 7377 6f72 642c 2061 6e64   a password, and
│ │ │ │ +00008ab0: 2074 6865 6e20 636f 6e74 6163 7473 2061   then contacts a
│ │ │ │ +00008ac0: 2073 6572 7665 7220 746f 2072 6563 6569   server to recei
│ │ │ │ +00008ad0: 7665 2061 2073 6f0a 6361 6c6c 6564 2074  ve a so.called t
│ │ │ │ +00008ae0: 6963 6b65 7420 6772 616e 7469 6e67 2074  icket granting t
│ │ │ │ +00008af0: 6963 6b65 742e 2020 4672 6f6d 206e 6f77  icket.  From now
│ │ │ │ +00008b00: 206f 6e2c 2079 6f75 2072 6172 656c 7920   on, you rarely 
│ │ │ │ +00008b10: 696e 7465 7261 6374 2077 6974 680a 5368  interact with.Sh
│ │ │ │ +00008b20: 6973 6869 2064 6972 6563 746c 792e 2020  ishi directly.  
│ │ │ │ +00008b30: 4170 706c 6963 6174 696f 6e73 2074 6861  Applications tha
│ │ │ │ +00008b40: 7420 6e65 6564 2073 6563 7572 6974 7920  t need security 
│ │ │ │ +00008b50: 7365 7276 6963 6573 2069 6e73 7472 7563  services instruc
│ │ │ │ +00008b60: 7420 7468 650a 5368 6973 6869 206c 6962  t the.Shishi lib
│ │ │ │ +00008b70: 7261 7279 2074 6f20 7573 6520 7468 6520  rary to use the 
│ │ │ │ +00008b80: 7469 636b 6574 2067 7261 6e74 696e 6720  ticket granting 
│ │ │ │ +00008b90: 7469 636b 6574 2074 6f20 6765 7420 6e65  ticket to get ne
│ │ │ │ +00008ba0: 7720 7469 636b 6574 7320 666f 720a 7661  w tickets for.va
│ │ │ │ +00008bb0: 7269 6f75 7320 7365 7276 6572 732e 2020  rious servers.  
│ │ │ │ +00008bc0: 416e 2065 7861 6d70 6c65 2063 6f75 6c64  An example could
│ │ │ │ +00008bd0: 2062 6520 6966 2079 6f75 206c 6f67 206f   be if you log o
│ │ │ │ +00008be0: 6e20 746f 2061 2068 6f73 7420 7265 6d6f  n to a host remo
│ │ │ │ +00008bf0: 7465 6c79 0a76 6961 20e2 8098 7465 6c6e  tely.via ...teln
│ │ │ │ +00008c00: 6574 e280 992e 2020 5468 6520 686f 7374  et....  The host
│ │ │ │ +00008c10: 2075 7375 616c 6c79 2072 6571 7569 7265   usually require
│ │ │ │ +00008c20: 7320 6175 7468 656e 7469 6361 7469 6f6e  s authentication
│ │ │ │ +00008c30: 2062 6566 6f72 650a 7065 726d 6974 7469   before.permitti
│ │ │ │ +00008c40: 6e67 2079 6f75 2069 6e2e 2020 5468 6520  ng you in.  The 
│ │ │ │ +00008c50: e280 9874 656c 6e65 74e2 8099 2063 6c69  ...telnet... cli
│ │ │ │ +00008c60: 656e 7420 7573 6573 2074 6865 2074 6963  ent uses the tic
│ │ │ │ +00008c70: 6b65 7420 6772 616e 7469 6e67 2074 6963  ket granting tic
│ │ │ │ +00008c80: 6b65 740a 746f 2067 6574 2061 2074 6963  ket.to get a tic
│ │ │ │ +00008c90: 6b65 7420 666f 7220 7468 6520 7365 7276  ket for the serv
│ │ │ │ +00008ca0: 6572 2c20 616e 6420 7468 656e 2075 7365  er, and then use
│ │ │ │ +00008cb0: 7320 7468 6973 2074 6963 6b65 7420 746f  s this ticket to
│ │ │ │ +00008cc0: 0a61 7574 6865 6e74 6963 6174 6520 796f  .authenticate yo
│ │ │ │ +00008cd0: 7520 6167 6169 6e73 7420 7468 6520 7365  u against the se
│ │ │ │ +00008ce0: 7276 6572 2028 7479 7069 6361 6c6c 7920  rver (typically 
│ │ │ │ +00008cf0: 7468 6520 7365 7276 6572 2069 7320 616c  the server is al
│ │ │ │ +00008d00: 736f 0a61 7574 6865 6e74 6963 6174 6564  so.authenticated
│ │ │ │ +00008d10: 2074 6f20 796f 7529 2e20 2059 6f75 2070   to you).  You p
│ │ │ │ +00008d20: 6572 666f 726d 2074 6865 2069 6e69 7469  erform the initi
│ │ │ │ +00008d30: 616c 2061 7574 6865 6e74 6963 6174 696f  al authenticatio
│ │ │ │ +00008d40: 6e20 6279 2074 7970 696e 670a e280 9873  n by typing....s
│ │ │ │ +00008d50: 6869 7368 69e2 8099 2061 7420 7468 6520  hishi... at the 
│ │ │ │ +00008d60: 7072 6f6d 7074 2e20 2053 6f6d 6574 696d  prompt.  Sometim
│ │ │ │ +00008d70: 6573 2069 7420 6973 206e 6563 6573 7361  es it is necessa
│ │ │ │ +00008d80: 7279 2074 6f20 7375 7070 6c79 206f 7074  ry to supply opt
│ │ │ │ +00008d90: 696f 6e73 0a74 656c 6c69 6e67 2053 6869  ions.telling Shi
│ │ │ │ +00008da0: 7368 6920 7768 6174 2079 6f75 7220 7072  shi what your pr
│ │ │ │ +00008db0: 696e 6369 7061 6c20 6e61 6d65 2028 7573  incipal name (us
│ │ │ │ +00008dc0: 6572 206e 616d 6520 696e 2074 6865 204b  er name in the K
│ │ │ │ +00008dd0: 6572 6265 726f 730a 7265 616c 6d29 206f  erberos.realm) o
│ │ │ │ +00008de0: 7220 796f 7572 2072 6561 6c6d 2069 732e  r your realm is.
│ │ │ │ +00008df0: 2020 496e 2074 6865 2065 7861 6d70 6c65    In the example
│ │ │ │ +00008e00: 2c20 4920 7370 6563 6966 7920 7468 6520  , I specify the 
│ │ │ │ +00008e10: 636c 6965 6e74 206e 616d 650a e280 9873  client name....s
│ │ │ │ +00008e20: 696d 6f6e 404a 4f53 4546 5353 4f4e 2e4f  imon@JOSEFSSON.O
│ │ │ │ +00008e30: 5247 e280 992e 0a0a 2020 2020 2024 2073  RG......     $ s
│ │ │ │ +00008e40: 6869 7368 6920 7369 6d6f 6e40 4a4f 5345  hishi simon@JOSE
│ │ │ │ +00008e50: 4653 534f 4e2e 4f52 470a 2020 2020 2045  FSSON.ORG.     E
│ │ │ │ +00008e60: 6e74 6572 2070 6173 7377 6f72 6420 666f  nter password fo
│ │ │ │ +00008e70: 7220 6073 696d 6f6e 404a 4f53 4546 5353  r `simon@JOSEFSS
│ │ │ │ +00008e80: 4f4e 2e4f 5247 273a 0a20 2020 2020 7369  ON.ORG':.     si
│ │ │ │ +00008e90: 6d6f 6e40 4a4f 5345 4653 534f 4e2e 4f52  mon@JOSEFSSON.OR
│ │ │ │ +00008ea0: 473a 0a20 2020 2020 4175 7468 7469 6d65  G:.     Authtime
│ │ │ │ +00008eb0: 3a20 2020 2020 2020 4672 6920 4175 6720  :       Fri Aug 
│ │ │ │ +00008ec0: 3135 2030 343a 3434 3a34 3920 3230 3033  15 04:44:49 2003
│ │ │ │ +00008ed0: 0a20 2020 2020 456e 6474 696d 653a 2020  .     Endtime:  
│ │ │ │ +00008ee0: 2020 2020 2020 4672 6920 4175 6720 3135        Fri Aug 15
│ │ │ │ +00008ef0: 2030 353a 3031 3a32 3920 3230 3033 0a20   05:01:29 2003. 
│ │ │ │ +00008f00: 2020 2020 5365 7276 6572 3a20 2020 2020      Server:     
│ │ │ │ +00008f10: 2020 2020 6b72 6274 6774 2f4a 4f53 4546      krbtgt/JOSEF
│ │ │ │ +00008f20: 5353 4f4e 2e4f 5247 206b 6579 2064 6573  SSON.ORG key des
│ │ │ │ +00008f30: 332d 6362 632d 7368 6131 2d6b 6420 2831  3-cbc-sha1-kd (1
│ │ │ │ +00008f40: 3629 0a20 2020 2020 5469 636b 6574 206b  6).     Ticket k
│ │ │ │ +00008f50: 6579 3a20 2020 2020 6465 7333 2d63 6263  ey:     des3-cbc
│ │ │ │ +00008f60: 2d73 6861 312d 6b64 2028 3136 2920 7072  -sha1-kd (16) pr
│ │ │ │ +00008f70: 6f74 6563 7465 6420 6279 2064 6573 332d  otected by des3-
│ │ │ │ +00008f80: 6362 632d 7368 6131 2d6b 6420 2831 3629  cbc-sha1-kd (16)
│ │ │ │ +00008f90: 0a20 2020 2020 5469 636b 6574 2066 6c61  .     Ticket fla
│ │ │ │ +00008fa0: 6773 3a20 2020 494e 4954 4941 4c20 2835  gs:   INITIAL (5
│ │ │ │ +00008fb0: 3132 290a 2020 2020 2024 0a0a 2020 2041  12).     $..   A
│ │ │ │ +00008fc0: 7320 796f 7520 6361 6e20 7365 652c 2053  s you can see, S
│ │ │ │ +00008fd0: 6869 7368 6920 616c 736f 2070 7269 6e74  hishi also print
│ │ │ │ +00008fe0: 7320 6120 7368 6f72 7420 6465 7363 7269  s a short descri
│ │ │ │ +00008ff0: 7074 696f 6e20 6f66 2074 6865 2074 6963  ption of the tic
│ │ │ │ +00009000: 6b65 740a 7265 6365 6976 6564 2e0a 0a20  ket.received... 
│ │ │ │ +00009010: 2020 4120 6c6f 6769 6361 6c20 6e65 7874    A logical next
│ │ │ │ +00009020: 2073 7465 7020 6973 2074 6f20 6469 7370   step is to disp
│ │ │ │ +00009030: 6c61 7920 616c 6c20 7469 636b 6574 7320  lay all tickets 
│ │ │ │ +00009040: 796f 7520 6861 7665 2072 6563 6569 7665  you have receive
│ │ │ │ +00009050: 642e 2020 4279 0a74 6865 2077 6179 2c20  d.  By.the way, 
│ │ │ │ +00009060: 7468 6520 7469 636b 6574 7320 6172 6520  the tickets are 
│ │ │ │ +00009070: 7573 7561 6c6c 7920 7374 6f72 6564 2061  usually stored a
│ │ │ │ +00009080: 7320 7465 7874 2069 6e20 e280 987e 2f2e  s text in ...~/.
│ │ │ │ +00009090: 7368 6973 6869 2f74 6963 6b65 7473 e280  shishi/tickets..
│ │ │ │ +000090a0: 992e 0a54 6869 7320 6973 2061 6368 6965  ...This is achie
│ │ │ │ +000090b0: 7665 6420 6279 2074 7970 696e 6720 e280  ved by typing ..
│ │ │ │ +000090c0: 9873 6869 7368 6920 2d2d 6c69 7374 e280  .shishi --list..
│ │ │ │ +000090d0: 992e 0a0a 2020 2020 2024 2073 6869 7368  ....     $ shish
│ │ │ │ +000090e0: 6920 2d2d 6c69 7374 0a20 2020 2020 5469  i --list.     Ti
│ │ │ │ +000090f0: 636b 6574 7320 696e 2060 2f68 6f6d 652f  ckets in `/home/
│ │ │ │ +00009100: 6a61 732f 2e73 6869 7368 692f 7469 636b  jas/.shishi/tick
│ │ │ │ +00009110: 6574 7327 3a0a 0a20 2020 2020 6a61 7340  ets':..     jas@
│ │ │ │ +00009120: 4a4f 5345 4653 534f 4e2e 4f52 473a 0a20  JOSEFSSON.ORG:. 
│ │ │ │ +00009130: 2020 2020 4175 7468 7469 6d65 3a20 2020      Authtime:   
│ │ │ │ +00009140: 2020 2020 4672 6920 4175 6720 3135 2030      Fri Aug 15 0
│ │ │ │ +00009150: 343a 3439 3a34 3620 3230 3033 0a20 2020  4:49:46 2003.   
│ │ │ │ +00009160: 2020 456e 6474 696d 653a 2020 2020 2020    Endtime:      
│ │ │ │ +00009170: 2020 4672 6920 4175 6720 3135 2030 353a    Fri Aug 15 05:
│ │ │ │ +00009180: 3036 3a32 3620 3230 3033 0a20 2020 2020  06:26 2003.     
│ │ │ │ +00009190: 5365 7276 6572 3a20 2020 2020 2020 2020  Server:         
│ │ │ │ +000091a0: 6b72 6274 6774 2f4a 4f53 4546 5353 4f4e  krbtgt/JOSEFSSON
│ │ │ │ +000091b0: 2e4f 5247 206b 6579 2064 6573 2d63 6263  .ORG key des-cbc
│ │ │ │ +000091c0: 2d6d 6435 2028 3329 0a20 2020 2020 5469  -md5 (3).     Ti
│ │ │ │ +000091d0: 636b 6574 206b 6579 3a20 2020 2020 6465  cket key:     de
│ │ │ │ +000091e0: 732d 6362 632d 6d64 3520 2833 2920 7072  s-cbc-md5 (3) pr
│ │ │ │ +000091f0: 6f74 6563 7465 6420 6279 2064 6573 2d63  otected by des-c
│ │ │ │ +00009200: 6263 2d6d 6435 2028 3329 0a20 2020 2020  bc-md5 (3).     
│ │ │ │ +00009210: 5469 636b 6574 2066 6c61 6773 3a20 2020  Ticket flags:   
│ │ │ │ +00009220: 494e 4954 4941 4c20 2835 3132 290a 0a20  INITIAL (512).. 
│ │ │ │ +00009230: 2020 2020 6a61 7340 4a4f 5345 4653 534f      jas@JOSEFSSO
│ │ │ │ +00009240: 4e2e 4f52 473a 0a20 2020 2020 4175 7468  N.ORG:.     Auth
│ │ │ │ +00009250: 7469 6d65 3a20 2020 2020 2020 4672 6920  time:       Fri 
│ │ │ │ +00009260: 4175 6720 3135 2030 343a 3439 3a34 3620  Aug 15 04:49:46 
│ │ │ │ +00009270: 3230 3033 0a20 2020 2020 5374 6172 7474  2003.     Startt
│ │ │ │ +00009280: 696d 653a 2020 2020 2020 4672 6920 4175  ime:      Fri Au
│ │ │ │ +00009290: 6720 3135 2030 343a 3439 3a34 3920 3230  g 15 04:49:49 20
│ │ │ │ +000092a0: 3033 0a20 2020 2020 456e 6474 696d 653a  03.     Endtime:
│ │ │ │ +000092b0: 2020 2020 2020 2020 4672 6920 4175 6720          Fri Aug 
│ │ │ │ +000092c0: 3135 2030 353a 3036 3a32 3620 3230 3033  15 05:06:26 2003
│ │ │ │ +000092d0: 0a20 2020 2020 5365 7276 6572 3a20 2020  .     Server:   
│ │ │ │ +000092e0: 2020 2020 2020 686f 7374 2f6c 6174 7465        host/latte
│ │ │ │ +000092f0: 2e6a 6f73 6566 7373 6f6e 2e6f 7267 206b  .josefsson.org k
│ │ │ │ +00009300: 6579 2064 6573 2d63 6263 2d6d 6435 2028  ey des-cbc-md5 (
│ │ │ │ +00009310: 3329 0a20 2020 2020 5469 636b 6574 206b  3).     Ticket k
│ │ │ │ +00009320: 6579 3a20 2020 2020 6465 732d 6362 632d  ey:     des-cbc-
│ │ │ │ +00009330: 6d64 3520 2833 2920 7072 6f74 6563 7465  md5 (3) protecte
│ │ │ │ +00009340: 6420 6279 2064 6573 2d63 6263 2d6d 6435  d by des-cbc-md5
│ │ │ │ +00009350: 2028 3329 0a0a 2020 2020 2032 2074 6963   (3)..     2 tic
│ │ │ │ +00009360: 6b65 7473 2066 6f75 6e64 2e0a 2020 2020  kets found..    
│ │ │ │ +00009370: 2024 0a0a 2020 2041 7320 796f 7520 6361   $..   As you ca
│ │ │ │ +00009380: 6e20 7365 652c 2049 2068 6164 2061 2074  n see, I had a t
│ │ │ │ +00009390: 6963 6b65 7420 666f 7220 7468 6520 7365  icket for the se
│ │ │ │ +000093a0: 7276 6572 0ae2 8098 686f 7374 2f6c 6174  rver....host/lat
│ │ │ │ +000093b0: 7465 2e6a 6f73 6566 7373 6f6e 2e6f 7267  te.josefsson.org
│ │ │ │ +000093c0: e280 9920 7768 6963 6820 7761 7320 6765  ... which was ge
│ │ │ │ +000093d0: 6e65 7261 7465 6420 6279 20e2 8098 7465  nerated by ...te
│ │ │ │ +000093e0: 6c6e 6574 e280 993a 696e 6720 746f 2074  lnet...:ing to t
│ │ │ │ +000093f0: 6861 740a 686f 7374 2e0a 0a20 2020 4966  hat.host...   If
│ │ │ │ +00009400: 2c20 666f 7220 736f 6d65 2072 6561 736f  , for some reaso
│ │ │ │ +00009410: 6e2c 2079 6f75 2077 616e 7420 746f 206d  n, you want to m
│ │ │ │ +00009420: 616e 7561 6c6c 7920 6765 7420 6120 7469  anually get a ti
│ │ │ │ +00009430: 636b 6574 2066 6f72 2061 2073 7065 6369  cket for a speci
│ │ │ │ +00009440: 6669 630a 7365 7276 6572 2c20 796f 7520  fic.server, you 
│ │ │ │ +00009450: 6361 6e20 7573 6520 7468 6520 e280 9873  can use the ...s
│ │ │ │ +00009460: 6869 7368 6920 2d2d 7365 7276 6572 2d6e  hishi --server-n
│ │ │ │ +00009470: 616d 65e2 8099 2063 6f6d 6d61 6e64 2e20  ame... command. 
│ │ │ │ +00009480: 204e 6f72 6d61 6c6c 792c 0a68 6f77 6576   Normally,.howev
│ │ │ │ +00009490: 6572 2c20 7468 6520 6170 706c 6963 6174  er, the applicat
│ │ │ │ +000094a0: 696f 6e20 7468 6174 2075 7365 7320 5368  ion that uses Sh
│ │ │ │ +000094b0: 6973 6869 2077 696c 6c20 7461 6b65 2063  ishi will take c
│ │ │ │ +000094c0: 6172 6520 6f66 2067 6574 7469 6e67 2061  are of getting a
│ │ │ │ +000094d0: 0a74 6963 6b65 7420 666f 7220 7468 6520  .ticket for the 
│ │ │ │ +000094e0: 6170 7072 6f70 7269 6174 6520 7365 7276  appropriate serv
│ │ │ │ +000094f0: 6572 2c20 736f 2079 6f75 206e 6f72 6d61  er, so you norma
│ │ │ │ +00009500: 6c6c 7920 776f 756c 646e 2774 206e 6565  lly wouldn't nee
│ │ │ │ +00009510: 6420 746f 0a69 7373 7565 2074 6869 7320  d to.issue this 
│ │ │ │ +00009520: 636f 6d6d 616e 642e 0a0a 2020 2020 2024  command...     $
│ │ │ │ +00009530: 2073 6869 7368 6920 2d2d 7365 7276 6572   shishi --server
│ │ │ │ +00009540: 2d6e 616d 653d 7573 6572 2f62 696c 6c67  -name=user/billg
│ │ │ │ +00009550: 202d 2d65 6e63 7279 7074 696f 6e2d 7479   --encryption-ty
│ │ │ │ +00009560: 7065 3d64 6573 2d63 6263 2d6d 6434 0a20  pe=des-cbc-md4. 
│ │ │ │ +00009570: 2020 2020 6a61 7340 4a4f 5345 4653 534f      jas@JOSEFSSO
│ │ │ │ +00009580: 4e2e 4f52 473a 0a20 2020 2020 4175 7468  N.ORG:.     Auth
│ │ │ │ +00009590: 7469 6d65 3a20 2020 2020 2020 4672 6920  time:       Fri 
│ │ │ │ +000095a0: 4175 6720 3135 2030 343a 3439 3a34 3620  Aug 15 04:49:46 
│ │ │ │ +000095b0: 3230 3033 0a20 2020 2020 5374 6172 7474  2003.     Startt
│ │ │ │ +000095c0: 696d 653a 2020 2020 2020 4672 6920 4175  ime:      Fri Au
│ │ │ │ +000095d0: 6720 3135 2030 343a 3534 3a33 3320 3230  g 15 04:54:33 20
│ │ │ │ +000095e0: 3033 0a20 2020 2020 456e 6474 696d 653a  03.     Endtime:
│ │ │ │ +000095f0: 2020 2020 2020 2020 4672 6920 4175 6720          Fri Aug 
│ │ │ │ +00009600: 3135 2030 353a 3036 3a32 3620 3230 3033  15 05:06:26 2003
│ │ │ │ +00009610: 0a20 2020 2020 5365 7276 6572 3a20 2020  .     Server:   
│ │ │ │ +00009620: 2020 2020 2020 7573 6572 2f62 696c 6c67        user/billg
│ │ │ │ +00009630: 206b 6579 2064 6573 2d63 6263 2d6d 6434   key des-cbc-md4
│ │ │ │ +00009640: 2028 3229 0a20 2020 2020 5469 636b 6574   (2).     Ticket
│ │ │ │ +00009650: 206b 6579 3a20 2020 2020 6465 732d 6362   key:     des-cb
│ │ │ │ +00009660: 632d 6d64 3420 2832 2920 7072 6f74 6563  c-md4 (2) protec
│ │ │ │ +00009670: 7465 6420 6279 2064 6573 2d63 6263 2d6d  ted by des-cbc-m
│ │ │ │ +00009680: 6435 2028 3329 0a20 2020 2020 240a 0a20  d5 (3).     $.. 
│ │ │ │ +00009690: 2020 4173 2079 6f75 2063 616e 2073 6565    As you can see
│ │ │ │ +000096a0: 2c20 4920 6163 7175 6972 6564 2061 2074  , I acquired a t
│ │ │ │ +000096b0: 6963 6b65 7420 666f 7220 e280 9875 7365  icket for ...use
│ │ │ │ +000096c0: 722f 6269 6c6c 67e2 8099 2077 6974 6820  r/billg... with 
│ │ │ │ +000096d0: 610a e280 9864 6573 2d63 6263 2d6d 6434  a....des-cbc-md4
│ │ │ │ +000096e0: e280 9920 282a 6e6f 7465 2043 7279 7074  ... (*note Crypt
│ │ │ │ +000096f0: 6f67 7261 7068 6963 204f 7665 7276 6965  ographic Overvie
│ │ │ │ +00009700: 773a 3a29 2065 6e63 7279 7074 696f 6e20  w::) encryption 
│ │ │ │ +00009710: 6b65 7920 7370 6563 6966 6965 640a 7769  key specified.wi
│ │ │ │ +00009720: 7468 2074 6865 20e2 8098 2d2d 656e 6372  th the ...--encr
│ │ │ │ +00009730: 7970 7469 6f6e 2d74 7970 65e2 8099 2070  yption-type... p
│ │ │ │ +00009740: 6172 616d 6574 6572 2e0a 0a20 2020 546f  arameter...   To
│ │ │ │ +00009750: 2077 7261 7020 7570 2074 6869 7320 696e   wrap up this in
│ │ │ │ +00009760: 7472 6f64 7563 7469 6f6e 2c20 6c65 7420  troduction, let 
│ │ │ │ +00009770: 7573 2073 6565 2068 6f77 2079 6f75 2063  us see how you c
│ │ │ │ +00009780: 616e 2072 656d 6f76 6520 7469 636b 6574  an remove ticket
│ │ │ │ +00009790: 732e 0a59 6f75 206d 6179 2077 616e 7420  s..You may want 
│ │ │ │ +000097a0: 746f 2064 6f20 7468 6973 2069 6620 796f  to do this if yo
│ │ │ │ +000097b0: 7520 6c65 6176 6520 796f 7572 2074 6572  u leave your ter
│ │ │ │ +000097c0: 6d69 6e61 6c20 666f 7220 6c75 6e63 6820  minal for lunch 
│ │ │ │ +000097d0: 6f72 2073 696d 696c 6172 2c0a 616e 6420  or similar,.and 
│ │ │ │ +000097e0: 646f 6e27 7420 7761 6e74 2073 6f6d 656f  don't want someo
│ │ │ │ +000097f0: 6e65 2074 6f20 6265 2061 626c 6520 746f  ne to be able to
│ │ │ │ +00009800: 2063 6f70 7920 7468 6520 6669 6c65 2061   copy the file a
│ │ │ │ +00009810: 6e64 2074 6865 6e20 7573 6520 796f 7572  nd then use your
│ │ │ │ +00009820: 0a63 7265 6465 6e74 6961 6c73 2e20 204e  .credentials.  N
│ │ │ │ +00009830: 6f74 6520 7468 6174 2074 6869 7320 6f6e  ote that this on
│ │ │ │ +00009840: 6c79 2064 6573 7472 6f79 7320 7468 6520  ly destroys the 
│ │ │ │ +00009850: 7469 636b 6574 7320 6c6f 6361 6c6c 792c  tickets locally,
│ │ │ │ +00009860: 2069 7420 646f 6573 0a6e 6f74 2063 6f6e   it does.not con
│ │ │ │ +00009870: 7461 6374 2061 6e79 2073 6572 7665 7220  tact any server 
│ │ │ │ +00009880: 7465 6c6c 696e 6720 7468 6174 2074 6865  telling that the
│ │ │ │ +00009890: 7365 2063 7265 6465 6e74 6961 6c73 2061  se credentials a
│ │ │ │ +000098a0: 7265 206e 6f20 6c6f 6e67 6572 0a76 616c  re no longer.val
│ │ │ │ +000098b0: 6964 2e20 2053 6f2c 2069 6620 736f 6d65  id.  So, if some
│ │ │ │ +000098c0: 6f6e 6520 7374 6f6c 6520 796f 7572 2074  one stole your t
│ │ │ │ +000098d0: 6963 6b65 7420 6669 6c65 2c20 796f 7520  icket file, you 
│ │ │ │ +000098e0: 6d75 7374 2073 7469 6c6c 2063 6f6e 7461  must still conta
│ │ │ │ +000098f0: 6374 0a79 6f75 7220 6164 6d69 6e69 7374  ct.your administ
│ │ │ │ +00009900: 7261 746f 7220 616e 6420 6861 7665 2074  rator and have t
│ │ │ │ +00009910: 6865 6d20 7265 7365 7420 796f 7572 2061  hem reset your a
│ │ │ │ +00009920: 6363 6f75 6e74 2e20 2053 696d 706c 7920  ccount.  Simply 
│ │ │ │ +00009930: 7573 696e 6720 7468 6973 0a73 7769 7463  using this.switc
│ │ │ │ +00009940: 6820 6973 206e 6f74 2073 7566 6669 6369  h is not suffici
│ │ │ │ +00009950: 656e 742e 0a0a 2020 2020 2024 2073 6869  ent...     $ shi
│ │ │ │ +00009960: 7368 6920 2d2d 7365 7276 6572 2d6e 616d  shi --server-nam
│ │ │ │ +00009970: 653d 696d 6170 2f6c 6174 7465 2e6a 6f73  e=imap/latte.jos
│ │ │ │ +00009980: 6566 7373 6f6e 2e6f 7267 202d 2d64 6573  efsson.org --des
│ │ │ │ +00009990: 7472 6f79 0a20 2020 2020 3120 7469 636b  troy.     1 tick
│ │ │ │ +000099a0: 6574 2072 656d 6f76 6564 2e0a 2020 2020  et removed..    
│ │ │ │ +000099b0: 2024 2073 6869 7368 6920 2d2d 7365 7276   $ shishi --serv
│ │ │ │ +000099c0: 6572 2d6e 616d 653d 666f 6f62 6172 202d  er-name=foobar -
│ │ │ │ +000099d0: 2d64 6573 7472 6f79 0a20 2020 2020 4e6f  -destroy.     No
│ │ │ │ +000099e0: 2074 6963 6b65 7473 2072 656d 6f76 6564   tickets removed
│ │ │ │ +000099f0: 2e0a 2020 2020 2024 2073 6869 7368 6920  ..     $ shishi 
│ │ │ │ +00009a00: 2d2d 6465 7374 726f 790a 2020 2020 2033  --destroy.     3
│ │ │ │ +00009a10: 2074 6963 6b65 7473 2072 656d 6f76 6564   tickets removed
│ │ │ │ +00009a20: 2e0a 2020 2020 2024 0a0a 2020 2053 696e  ..     $..   Sin
│ │ │ │ +00009a30: 6365 2074 6865 20e2 8098 2d2d 7365 7276  ce the ...--serv
│ │ │ │ +00009a40: 6572 2d6e 616d 65e2 8099 2070 6172 616d  er-name... param
│ │ │ │ +00009a50: 6574 6572 2074 616b 6573 2061 206c 6f6e  eter takes a lon
│ │ │ │ +00009a60: 6720 7374 7269 6e67 2074 6f20 7479 7065  g string to type
│ │ │ │ +00009a70: 2c20 6974 0a69 7320 706f 7373 6962 6c65  , it.is possible
│ │ │ │ +00009a80: 2074 6f20 7479 7065 2074 6865 2073 6572   to type the ser
│ │ │ │ +00009a90: 7665 7220 6e61 6d65 2064 6972 6563 746c  ver name directl
│ │ │ │ +00009aa0: 792c 2061 6674 6572 2074 6865 2063 6c69  y, after the cli
│ │ │ │ +00009ab0: 656e 7420 6e61 6d65 2e0a 5468 6520 666f  ent name..The fo
│ │ │ │ +00009ac0: 6c6c 6f77 696e 6720 6578 616d 706c 6520  llowing example 
│ │ │ │ +00009ad0: 6465 6d6f 6e73 7472 6174 6573 2061 6e20  demonstrates an 
│ │ │ │ +00009ae0: 4153 2d52 4551 2066 6f6c 6c6f 7765 6420  AS-REQ followed 
│ │ │ │ +00009af0: 6279 2061 2054 4753 2d52 4551 2066 6f72  by a TGS-REQ for
│ │ │ │ +00009b00: 2061 0a73 7065 6369 6669 6320 7365 7276   a.specific serv
│ │ │ │ +00009b10: 6572 2028 6173 7375 6d69 6e67 2079 6f75  er (assuming you
│ │ │ │ +00009b20: 2064 6964 206e 6f74 2068 6176 6520 616e   did not have an
│ │ │ │ +00009b30: 7920 7469 636b 6574 7320 746f 2062 6567  y tickets to beg
│ │ │ │ +00009b40: 696e 2077 6974 6829 2e0a 0a20 2020 2020  in with)...     
│ │ │ │ +00009b50: 2420 7372 632f 7368 6973 6869 2073 696d  $ src/shishi sim
│ │ │ │ +00009b60: 6f6e 406c 6174 7465 2e6a 6f73 6566 7373  on@latte.josefss
│ │ │ │ +00009b70: 6f6e 2e6f 7267 2069 6d61 702f 6c61 7474  on.org imap/latt
│ │ │ │ +00009b80: 652e 6a6f 7365 6673 736f 6e2e 6f72 670a  e.josefsson.org.
│ │ │ │ +00009b90: 2020 2020 2045 6e74 6572 2070 6173 7377       Enter passw
│ │ │ │ +00009ba0: 6f72 6420 666f 7220 6073 696d 6f6e 406c  ord for `simon@l
│ │ │ │ +00009bb0: 6174 7465 2e6a 6f73 6566 7373 6f6e 2e6f  atte.josefsson.o
│ │ │ │ +00009bc0: 7267 273a 0a20 2020 2020 7369 6d6f 6e40  rg':.     simon@
│ │ │ │ +00009bd0: 6c61 7474 652e 6a6f 7365 6673 736f 6e2e  latte.josefsson.
│ │ │ │ +00009be0: 6f72 673a 0a20 2020 2020 4163 7175 6972  org:.     Acquir
│ │ │ │ +00009bf0: 6564 3a20 2020 2020 2020 5765 6420 4175  ed:       Wed Au
│ │ │ │ +00009c00: 6720 3237 2031 373a 3231 3a30 3620 3230  g 27 17:21:06 20
│ │ │ │ +00009c10: 3033 0a20 2020 2020 4578 7069 7265 733a  03.     Expires:
│ │ │ │ +00009c20: 2020 2020 2020 2020 5765 6420 4175 6720          Wed Aug 
│ │ │ │ +00009c30: 3237 2031 373a 3337 3a34 3620 3230 3033  27 17:37:46 2003
│ │ │ │ +00009c40: 0a20 2020 2020 5365 7276 6572 3a20 2020  .     Server:   
│ │ │ │ +00009c50: 2020 2020 2020 696d 6170 2f6c 6174 7465        imap/latte
│ │ │ │ +00009c60: 2e6a 6f73 6566 7373 6f6e 2e6f 7267 206b  .josefsson.org k
│ │ │ │ +00009c70: 6579 2061 6573 3235 362d 6374 732d 686d  ey aes256-cts-hm
│ │ │ │ +00009c80: 6163 2d73 6861 312d 3936 2028 3138 290a  ac-sha1-96 (18).
│ │ │ │ +00009c90: 2020 2020 2054 6963 6b65 7420 6b65 793a       Ticket key:
│ │ │ │ +00009ca0: 2020 2020 2061 6573 3235 362d 6374 732d       aes256-cts-
│ │ │ │ +00009cb0: 686d 6163 2d73 6861 312d 3936 2028 3138  hmac-sha1-96 (18
│ │ │ │ +00009cc0: 2920 7072 6f74 6563 7465 6420 6279 2061  ) protected by a
│ │ │ │ +00009cd0: 6573 3235 362d 6374 732d 686d 6163 2d73  es256-cts-hmac-s
│ │ │ │ +00009ce0: 6861 312d 3936 2028 3138 290a 2020 2020  ha1-96 (18).    
│ │ │ │ +00009cf0: 2054 6963 6b65 7420 666c 6167 733a 2020   Ticket flags:  
│ │ │ │ +00009d00: 2046 4f52 5741 5244 4544 2050 524f 5849   FORWARDED PROXI
│ │ │ │ +00009d10: 4142 4c45 2028 3132 290a 2020 2020 2024  ABLE (12).     $
│ │ │ │ +00009d20: 0a0a 2020 2052 6566 6572 2074 6f20 7468  ..   Refer to th
│ │ │ │ +00009d30: 6520 7265 6665 7265 6e63 6520 6d61 6e75  e reference manu
│ │ │ │ +00009d40: 616c 2066 6f72 2061 6c6c 2061 7661 696c  al for all avail
│ │ │ │ +00009d50: 6162 6c65 2070 6172 616d 6574 6572 7320  able parameters 
│ │ │ │ +00009d60: 282a 6e6f 7465 0a50 6172 616d 6574 6572  (*note.Parameter
│ │ │ │ +00009d70: 7320 666f 7220 7368 6973 6869 3a3a 292e  s for shishi::).
│ │ │ │ +00009d80: 2020 5468 6520 7265 7374 206f 6620 7468    The rest of th
│ │ │ │ +00009d90: 6973 2073 6563 7469 6f6e 2063 6f6e 7461  is section conta
│ │ │ │ +00009da0: 696e 730a 6465 7363 7269 7074 696f 6e73  ins.descriptions
│ │ │ │ +00009db0: 206f 6620 6d6f 7265 2073 7065 6369 616c   of more special
│ │ │ │ +00009dc0: 697a 6564 2075 7361 6765 206d 6f64 6573  ized usage modes
│ │ │ │ +00009dd0: 2074 6861 7420 6361 6e20 6265 2069 676e   that can be ign
│ │ │ │ +00009de0: 6f72 6564 2062 7920 6d6f 7374 0a75 7365  ored by most.use
│ │ │ │ +00009df0: 7273 2e0a 0a32 2e31 2050 726f 7869 6162  rs...2.1 Proxiab
│ │ │ │ +00009e00: 6c65 2061 6e64 2050 726f 7879 2054 6963  le and Proxy Tic
│ │ │ │ +00009e10: 6b65 7473 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d  kets.===========
│ │ │ │  00009e20: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ -00009e30: 3d3d 0a0a 4174 2074 696d 6573 2069 7420  ==..At times it 
│ │ │ │ -00009e40: 6d61 7920 6265 206e 6563 6573 7361 7279  may be necessary
│ │ │ │ -00009e50: 2066 6f72 2061 2070 7269 6e63 6970 616c   for a principal
│ │ │ │ -00009e60: 2074 6f20 616c 6c6f 7720 6120 7365 7276   to allow a serv
│ │ │ │ -00009e70: 6963 6520 746f 0a70 6572 666f 726d 2061  ice to.perform a
│ │ │ │ -00009e80: 6e20 6f70 6572 6174 696f 6e20 6f6e 2069  n operation on i
│ │ │ │ -00009e90: 7473 2062 6568 616c 662e 2020 5468 6520  ts behalf.  The 
│ │ │ │ -00009ea0: 7365 7276 6963 6520 6d75 7374 2062 6520  service must be 
│ │ │ │ -00009eb0: 6162 6c65 2074 6f20 7461 6b65 206f 6e0a  able to take on.
│ │ │ │ -00009ec0: 7468 6520 6964 656e 7469 7479 206f 6620  the identity of 
│ │ │ │ -00009ed0: 7468 6520 636c 6965 6e74 2c20 6275 7420  the client, but 
│ │ │ │ -00009ee0: 6f6e 6c79 2066 6f72 2061 2070 6172 7469  only for a parti
│ │ │ │ -00009ef0: 6375 6c61 7220 7075 7270 6f73 652e 2020  cular purpose.  
│ │ │ │ -00009f00: 410a 7072 696e 6369 7061 6c20 6361 6e20  A.principal can 
│ │ │ │ -00009f10: 616c 6c6f 7720 6120 7365 7276 6963 6520  allow a service 
│ │ │ │ -00009f20: 746f 2074 616b 6520 6f6e 2074 6865 2070  to take on the p
│ │ │ │ -00009f30: 7269 6e63 6970 616c 2773 2069 6465 6e74  rincipal's ident
│ │ │ │ -00009f40: 6974 7920 666f 7220 610a 7061 7274 6963  ity for a.partic
│ │ │ │ -00009f50: 756c 6172 2070 7572 706f 7365 2062 7920  ular purpose by 
│ │ │ │ -00009f60: 6772 616e 7469 6e67 2069 7420 6120 7072  granting it a pr
│ │ │ │ -00009f70: 6f78 792e 0a0a 2020 2054 6865 2070 726f  oxy...   The pro
│ │ │ │ -00009f80: 6365 7373 206f 6620 6772 616e 7469 6e67  cess of granting
│ │ │ │ -00009f90: 2061 2070 726f 7879 2075 7369 6e67 2074   a proxy using t
│ │ │ │ -00009fa0: 6865 2070 726f 7879 2061 6e64 2070 726f  he proxy and pro
│ │ │ │ -00009fb0: 7869 6162 6c65 2066 6c61 6773 0a69 7320  xiable flags.is 
│ │ │ │ -00009fc0: 7573 6564 2074 6f20 7072 6f76 6964 6520  used to provide 
│ │ │ │ -00009fd0: 6372 6564 656e 7469 616c 7320 666f 7220  credentials for 
│ │ │ │ -00009fe0: 7573 6520 7769 7468 2073 7065 6369 6669  use with specifi
│ │ │ │ -00009ff0: 6320 7365 7276 6963 6573 2e20 2054 686f  c services.  Tho
│ │ │ │ -0000a000: 7567 680a 636f 6e63 6570 7475 616c 6c79  ugh.conceptually
│ │ │ │ -0000a010: 2061 6c73 6f20 6120 7072 6f78 792c 2075   also a proxy, u
│ │ │ │ -0000a020: 7365 7273 2077 6973 6869 6e67 2074 6f20  sers wishing to 
│ │ │ │ -0000a030: 6465 6c65 6761 7465 2074 6865 6972 2069  delegate their i
│ │ │ │ -0000a040: 6465 6e74 6974 7920 696e 2061 0a66 6f72  dentity in a.for
│ │ │ │ -0000a050: 6d20 7573 6162 6c65 2066 6f72 2061 6c6c  m usable for all
│ │ │ │ -0000a060: 2070 7572 706f 7365 204d 5553 5420 7573   purpose MUST us
│ │ │ │ -0000a070: 6520 7468 6520 7469 636b 6574 2066 6f72  e the ticket for
│ │ │ │ -0000a080: 7761 7264 696e 6720 6d65 6368 616e 6973  warding mechanis
│ │ │ │ -0000a090: 6d0a 6465 7363 7269 6265 6420 696e 2074  m.described in t
│ │ │ │ -0000a0a0: 6865 206e 6578 7420 7365 6374 696f 6e20  he next section 
│ │ │ │ -0000a0b0: 746f 2066 6f72 7761 7264 2061 2074 6963  to forward a tic
│ │ │ │ -0000a0c0: 6b65 742d 6772 616e 7469 6e67 2074 6963  ket-granting tic
│ │ │ │ -0000a0d0: 6b65 742e 0a0a 2020 2054 6865 2050 524f  ket...   The PRO
│ │ │ │ -0000a0e0: 5849 4142 4c45 2066 6c61 6720 696e 2061  XIABLE flag in a
│ │ │ │ -0000a0f0: 2074 6963 6b65 7420 6973 206e 6f72 6d61   ticket is norma
│ │ │ │ -0000a100: 6c6c 7920 6f6e 6c79 2069 6e74 6572 7072  lly only interpr
│ │ │ │ -0000a110: 6574 6564 2062 7920 7468 650a 7469 636b  eted by the.tick
│ │ │ │ -0000a120: 6574 2d67 7261 6e74 696e 6720 7365 7276  et-granting serv
│ │ │ │ -0000a130: 6963 652e 2020 4974 2063 616e 2062 6520  ice.  It can be 
│ │ │ │ -0000a140: 6967 6e6f 7265 6420 6279 2061 7070 6c69  ignored by appli
│ │ │ │ -0000a150: 6361 7469 6f6e 2073 6572 7665 7273 2e0a  cation servers..
│ │ │ │ -0000a160: 5768 656e 2073 6574 2c20 7468 6973 2066  When set, this f
│ │ │ │ -0000a170: 6c61 6720 7465 6c6c 7320 7468 6520 7469  lag tells the ti
│ │ │ │ -0000a180: 636b 6574 2d67 7261 6e74 696e 6720 7365  cket-granting se
│ │ │ │ -0000a190: 7276 6572 2074 6861 7420 6974 2069 7320  rver that it is 
│ │ │ │ -0000a1a0: 4f4b 2074 6f0a 6973 7375 6520 6120 6e65  OK to.issue a ne
│ │ │ │ -0000a1b0: 7720 7469 636b 6574 2028 6275 7420 6e6f  w ticket (but no
│ │ │ │ -0000a1c0: 7420 6120 7469 636b 6574 2d67 7261 6e74  t a ticket-grant
│ │ │ │ -0000a1d0: 696e 6720 7469 636b 6574 2920 7769 7468  ing ticket) with
│ │ │ │ -0000a1e0: 2061 2064 6966 6665 7265 6e74 0a6e 6574   a different.net
│ │ │ │ -0000a1f0: 776f 726b 2061 6464 7265 7373 2062 6173  work address bas
│ │ │ │ -0000a200: 6564 206f 6e20 7468 6973 2074 6963 6b65  ed on this ticke
│ │ │ │ -0000a210: 742e 2020 5468 6973 2066 6c61 6720 6973  t.  This flag is
│ │ │ │ -0000a220: 2073 6574 2069 6620 7265 7175 6573 7465   set if requeste
│ │ │ │ -0000a230: 6420 6279 0a74 6865 2063 6c69 656e 7420  d by.the client 
│ │ │ │ -0000a240: 6f6e 2069 6e69 7469 616c 2061 7574 6865  on initial authe
│ │ │ │ -0000a250: 6e74 6963 6174 696f 6e2e 2020 4279 2064  ntication.  By d
│ │ │ │ -0000a260: 6566 6175 6c74 2c20 7468 6520 636c 6965  efault, the clie
│ │ │ │ -0000a270: 6e74 2077 696c 6c0a 7265 7175 6573 7420  nt will.request 
│ │ │ │ -0000a280: 7468 6174 2069 7420 6265 2073 6574 2077  that it be set w
│ │ │ │ -0000a290: 6865 6e20 7265 7175 6573 7469 6e67 2061  hen requesting a
│ │ │ │ -0000a2a0: 2074 6963 6b65 742d 6772 616e 7469 6e67   ticket-granting
│ │ │ │ -0000a2b0: 2074 6963 6b65 742c 2061 6e64 0a72 6573   ticket, and.res
│ │ │ │ -0000a2c0: 6574 2077 6865 6e20 7265 7175 6573 7469  et when requesti
│ │ │ │ -0000a2d0: 6e67 2061 6e79 206f 7468 6572 2074 6963  ng any other tic
│ │ │ │ -0000a2e0: 6b65 742e 0a0a 2020 2054 6869 7320 666c  ket...   This fl
│ │ │ │ -0000a2f0: 6167 2061 6c6c 6f77 7320 6120 636c 6965  ag allows a clie
│ │ │ │ -0000a300: 6e74 2074 6f20 7061 7373 2061 2070 726f  nt to pass a pro
│ │ │ │ -0000a310: 7879 2074 6f20 6120 7365 7276 6572 2074  xy to a server t
│ │ │ │ -0000a320: 6f20 7065 7266 6f72 6d20 610a 7265 6d6f  o perform a.remo
│ │ │ │ -0000a330: 7465 2072 6571 7565 7374 206f 6e20 6974  te request on it
│ │ │ │ -0000a340: 7320 6265 6861 6c66 2028 652e 672e 2020  s behalf (e.g.  
│ │ │ │ -0000a350: 6120 7072 696e 7420 7365 7276 6963 6520  a print service 
│ │ │ │ -0000a360: 636c 6965 6e74 2063 616e 2067 6976 6520  client can give 
│ │ │ │ -0000a370: 7468 650a 7072 696e 7420 7365 7276 6572  the.print server
│ │ │ │ -0000a380: 2061 2070 726f 7879 2074 6f20 6163 6365   a proxy to acce
│ │ │ │ -0000a390: 7373 2074 6865 2063 6c69 656e 7427 7320  ss the client's 
│ │ │ │ -0000a3a0: 6669 6c65 7320 6f6e 2061 2070 6172 7469  files on a parti
│ │ │ │ -0000a3b0: 6375 6c61 7220 6669 6c65 0a73 6572 7665  cular file.serve
│ │ │ │ -0000a3c0: 7220 696e 206f 7264 6572 2074 6f20 7361  r in order to sa
│ │ │ │ -0000a3d0: 7469 7366 7920 6120 7072 696e 7420 7265  tisfy a print re
│ │ │ │ -0000a3e0: 7175 6573 7429 2e0a 0a20 2020 496e 206f  quest)...   In o
│ │ │ │ -0000a3f0: 7264 6572 2074 6f20 636f 6d70 6c69 6361  rder to complica
│ │ │ │ -0000a400: 7465 2074 6865 2075 7365 206f 6620 7374  te the use of st
│ │ │ │ -0000a410: 6f6c 656e 2063 7265 6465 6e74 6961 6c73  olen credentials
│ │ │ │ -0000a420: 2c20 4b65 7262 6572 6f73 0a74 6963 6b65  , Kerberos.ticke
│ │ │ │ -0000a430: 7473 2061 7265 2075 7375 616c 6c79 2076  ts are usually v
│ │ │ │ -0000a440: 616c 6964 2066 726f 6d20 6f6e 6c79 2074  alid from only t
│ │ │ │ -0000a450: 686f 7365 206e 6574 776f 726b 2061 6464  hose network add
│ │ │ │ -0000a460: 7265 7373 6573 2073 7065 6369 6669 6361  resses specifica
│ │ │ │ -0000a470: 6c6c 790a 696e 636c 7564 6564 2069 6e20  lly.included in 
│ │ │ │ -0000a480: 7468 6520 7469 636b 6574 5b34 5d2e 2020  the ticket[4].  
│ │ │ │ -0000a490: 5768 656e 2067 7261 6e74 696e 6720 6120  When granting a 
│ │ │ │ -0000a4a0: 7072 6f78 792c 2074 6865 2063 6c69 656e  proxy, the clien
│ │ │ │ -0000a4b0: 7420 4d55 5354 0a73 7065 6369 6679 2074  t MUST.specify t
│ │ │ │ -0000a4c0: 6865 206e 6577 206e 6574 776f 726b 2061  he new network a
│ │ │ │ -0000a4d0: 6464 7265 7373 2066 726f 6d20 7768 6963  ddress from whic
│ │ │ │ -0000a4e0: 6820 7468 6520 7072 6f78 7920 6973 2074  h the proxy is t
│ │ │ │ -0000a4f0: 6f20 6265 2075 7365 642c 206f 720a 696e  o be used, or.in
│ │ │ │ -0000a500: 6469 6361 7465 2074 6861 7420 7468 6520  dicate that the 
│ │ │ │ -0000a510: 7072 6f78 7920 6973 2074 6f20 6265 2069  proxy is to be i
│ │ │ │ -0000a520: 7373 7565 6420 666f 7220 7573 6520 6672  ssued for use fr
│ │ │ │ -0000a530: 6f6d 2061 6e79 2061 6464 7265 7373 2e0a  om any address..
│ │ │ │ -0000a540: 0a20 2020 5468 6520 5052 4f58 5920 666c  .   The PROXY fl
│ │ │ │ -0000a550: 6167 2069 7320 7365 7420 696e 2061 2074  ag is set in a t
│ │ │ │ -0000a560: 6963 6b65 7420 6279 2074 6865 2054 4753  icket by the TGS
│ │ │ │ -0000a570: 2077 6865 6e20 6974 2069 7373 7565 7320   when it issues 
│ │ │ │ -0000a580: 6120 7072 6f78 790a 7469 636b 6574 2e20  a proxy.ticket. 
│ │ │ │ -0000a590: 2041 7070 6c69 6361 7469 6f6e 2073 6572   Application ser
│ │ │ │ -0000a5a0: 7665 7273 204d 4159 2063 6865 636b 2074  vers MAY check t
│ │ │ │ -0000a5b0: 6869 7320 666c 6167 2061 6e64 2061 7420  his flag and at 
│ │ │ │ -0000a5c0: 7468 6569 7220 6f70 7469 6f6e 0a74 6865  their option.the
│ │ │ │ -0000a5d0: 7920 4d41 5920 7265 7175 6972 6520 6164  y MAY require ad
│ │ │ │ -0000a5e0: 6469 7469 6f6e 616c 2061 7574 6865 6e74  ditional authent
│ │ │ │ -0000a5f0: 6963 6174 696f 6e20 6672 6f6d 2074 6865  ication from the
│ │ │ │ -0000a600: 2061 6765 6e74 2070 7265 7365 6e74 696e   agent presentin
│ │ │ │ -0000a610: 6720 7468 650a 7072 6f78 7920 696e 206f  g the.proxy in o
│ │ │ │ -0000a620: 7264 6572 2074 6f20 7072 6f76 6964 6520  rder to provide 
│ │ │ │ -0000a630: 616e 2061 7564 6974 2074 7261 696c 2e0a  an audit trail..
│ │ │ │ -0000a640: 0a20 2020 4865 7265 2069 7320 686f 7720  .   Here is how 
│ │ │ │ -0000a650: 796f 7520 776f 756c 6420 6163 7175 6972  you would acquir
│ │ │ │ -0000a660: 6520 6120 5052 4f58 5920 7469 636b 6574  e a PROXY ticket
│ │ │ │ -0000a670: 2066 6f72 2074 6865 2073 6572 7669 6365   for the service
│ │ │ │ -0000a680: 0ae2 8098 696d 6170 2f6c 6174 7465 2e6a  ....imap/latte.j
│ │ │ │ -0000a690: 6f73 6566 7373 6f6e 2e6f 7267 e280 993a  osefsson.org...:
│ │ │ │ -0000a6a0: 0a0a 2020 2020 2024 2073 6869 7368 6920  ..     $ shishi 
│ │ │ │ -0000a6b0: 6a61 7340 4a4f 5345 4653 534f 4e2e 4f52  jas@JOSEFSSON.OR
│ │ │ │ -0000a6c0: 4720 696d 6170 2f6c 6174 7465 2e6a 6f73  G imap/latte.jos
│ │ │ │ -0000a6d0: 6566 7373 6f6e 2e6f 7267 202d 2d70 726f  efsson.org --pro
│ │ │ │ -0000a6e0: 7879 0a20 2020 2020 456e 7465 7220 7061  xy.     Enter pa
│ │ │ │ -0000a6f0: 7373 776f 7264 2066 6f72 2060 6a61 7340  ssword for `jas@
│ │ │ │ -0000a700: 4a4f 5345 4653 534f 4e2e 4f52 4727 3a0a  JOSEFSSON.ORG':.
│ │ │ │ -0000a710: 2020 2020 206c 6962 7368 6973 6869 3a20       libshishi: 
│ │ │ │ -0000a720: 7761 726e 696e 673a 204b 4443 2062 7567  warning: KDC bug
│ │ │ │ -0000a730: 3a20 5265 706c 7920 656e 6372 7970 7465  : Reply encrypte
│ │ │ │ -0000a740: 6420 7573 696e 6720 7772 6f6e 6720 6b65  d using wrong ke
│ │ │ │ -0000a750: 792e 0a20 2020 2020 6a61 7340 4a4f 5345  y..     jas@JOSE
│ │ │ │ -0000a760: 4653 534f 4e2e 4f52 473a 0a20 2020 2020  FSSON.ORG:.     
│ │ │ │ -0000a770: 4175 7468 7469 6d65 3a20 2020 2020 2020  Authtime:       
│ │ │ │ -0000a780: 4d6f 6e20 5365 7020 2038 2032 303a 3032  Mon Sep  8 20:02
│ │ │ │ -0000a790: 3a33 3520 3230 3033 0a20 2020 2020 5374  :35 2003.     St
│ │ │ │ -0000a7a0: 6172 7474 696d 653a 2020 2020 2020 4d6f  arttime:      Mo
│ │ │ │ -0000a7b0: 6e20 5365 7020 2038 2032 303a 3032 3a33  n Sep  8 20:02:3
│ │ │ │ -0000a7c0: 3620 3230 3033 0a20 2020 2020 456e 6474  6 2003.     Endt
│ │ │ │ -0000a7d0: 696d 653a 2020 2020 2020 2020 5475 6520  ime:        Tue 
│ │ │ │ -0000a7e0: 5365 7020 2039 2030 343a 3032 3a33 3520  Sep  9 04:02:35 
│ │ │ │ -0000a7f0: 3230 3033 0a20 2020 2020 5365 7276 6572  2003.     Server
│ │ │ │ -0000a800: 3a20 2020 2020 2020 2020 696d 6170 2f6c  :         imap/l
│ │ │ │ -0000a810: 6174 7465 2e6a 6f73 6566 7373 6f6e 2e6f  atte.josefsson.o
│ │ │ │ -0000a820: 7267 206b 6579 2064 6573 332d 6362 632d  rg key des3-cbc-
│ │ │ │ -0000a830: 7368 6131 2d6b 6420 2831 3629 0a20 2020  sha1-kd (16).   
│ │ │ │ -0000a840: 2020 5469 636b 6574 206b 6579 3a20 2020    Ticket key:   
│ │ │ │ -0000a850: 2020 6465 7333 2d63 6263 2d73 6861 312d    des3-cbc-sha1-
│ │ │ │ -0000a860: 6b64 2028 3136 2920 7072 6f74 6563 7465  kd (16) protecte
│ │ │ │ -0000a870: 6420 6279 2064 6573 332d 6362 632d 7368  d by des3-cbc-sh
│ │ │ │ -0000a880: 6131 2d6b 6420 2831 3629 0a20 2020 2020  a1-kd (16).     
│ │ │ │ -0000a890: 5469 636b 6574 2066 6c61 6773 3a20 2020  Ticket flags:   
│ │ │ │ -0000a8a0: 5052 4f58 5920 2831 3629 0a20 2020 2020  PROXY (16).     
│ │ │ │ -0000a8b0: 240a 0a20 2020 4173 2079 6f75 206e 6f74  $..   As you not
│ │ │ │ -0000a8c0: 6963 6564 2c20 7468 6973 2061 736b 6564  iced, this asked
│ │ │ │ -0000a8d0: 2066 6f72 2079 6f75 7220 7061 7373 776f   for your passwo
│ │ │ │ -0000a8e0: 7264 2e20 2054 6865 2072 6561 736f 6e20  rd.  The reason 
│ │ │ │ -0000a8f0: 6973 2074 6861 740a 7072 6f78 7920 7469  is that.proxy ti
│ │ │ │ -0000a900: 636b 6574 7320 6d75 7374 2062 6520 6163  ckets must be ac
│ │ │ │ -0000a910: 7175 6972 6564 2075 7369 6e67 2061 2070  quired using a p
│ │ │ │ -0000a920: 726f 7869 6162 6c65 2074 6963 6b65 7420  roxiable ticket 
│ │ │ │ -0000a930: 6772 616e 7469 6e67 2074 6963 6b65 742c  granting ticket,
│ │ │ │ -0000a940: 0a77 6869 6368 2077 6173 206e 6f74 2070  .which was not p
│ │ │ │ -0000a950: 7265 7365 6e74 2e20 2049 6620 796f 7520  resent.  If you 
│ │ │ │ -0000a960: 6f66 7465 6e20 6e65 6564 2074 6f20 6765  often need to ge
│ │ │ │ -0000a970: 7420 7072 6f78 7920 7469 636b 6574 732c  t proxy tickets,
│ │ │ │ -0000a980: 2079 6f75 206d 6179 0a61 6371 7569 7265   you may.acquire
│ │ │ │ -0000a990: 2061 2070 726f 7869 6162 6c65 2074 6963   a proxiable tic
│ │ │ │ -0000a9a0: 6b65 7420 6772 616e 7469 6e67 2074 6963  ket granting tic
│ │ │ │ -0000a9b0: 6b65 7420 6672 6f6d 2074 6865 2073 7461  ket from the sta
│ │ │ │ -0000a9c0: 7274 3a0a 0a20 2020 2020 2420 7368 6973  rt:..     $ shis
│ │ │ │ -0000a9d0: 6869 202d 2d70 726f 7869 6162 6c65 0a20  hi --proxiable. 
│ │ │ │ -0000a9e0: 2020 2020 456e 7465 7220 7061 7373 776f      Enter passwo
│ │ │ │ -0000a9f0: 7264 2066 6f72 2060 6a61 7340 4a4f 5345  rd for `jas@JOSE
│ │ │ │ -0000aa00: 4653 534f 4e2e 4f52 4727 3a0a 2020 2020  FSSON.ORG':.    
│ │ │ │ -0000aa10: 206a 6173 404a 4f53 4546 5353 4f4e 2e4f   jas@JOSEFSSON.O
│ │ │ │ -0000aa20: 5247 3a0a 2020 2020 2041 7574 6874 696d  RG:.     Authtim
│ │ │ │ -0000aa30: 653a 2020 2020 2020 204d 6f6e 2053 6570  e:       Mon Sep
│ │ │ │ -0000aa40: 2020 3820 3230 3a30 343a 3237 2032 3030    8 20:04:27 200
│ │ │ │ -0000aa50: 330a 2020 2020 2045 6e64 7469 6d65 3a20  3.     Endtime: 
│ │ │ │ -0000aa60: 2020 2020 2020 2054 7565 2053 6570 2020         Tue Sep  
│ │ │ │ -0000aa70: 3920 3034 3a30 343a 3237 2032 3030 330a  9 04:04:27 2003.
│ │ │ │ -0000aa80: 2020 2020 2053 6572 7665 723a 2020 2020       Server:    
│ │ │ │ -0000aa90: 2020 2020 206b 7262 7467 742f 4a4f 5345       krbtgt/JOSE
│ │ │ │ -0000aaa0: 4653 534f 4e2e 4f52 4720 6b65 7920 6465  FSSON.ORG key de
│ │ │ │ -0000aab0: 7333 2d63 6263 2d73 6861 312d 6b64 2028  s3-cbc-sha1-kd (
│ │ │ │ -0000aac0: 3136 290a 2020 2020 2054 6963 6b65 7420  16).     Ticket 
│ │ │ │ -0000aad0: 6b65 793a 2020 2020 2064 6573 332d 6362  key:     des3-cb
│ │ │ │ -0000aae0: 632d 7368 6131 2d6b 6420 2831 3629 2070  c-sha1-kd (16) p
│ │ │ │ -0000aaf0: 726f 7465 6374 6564 2062 7920 6465 7333  rotected by des3
│ │ │ │ -0000ab00: 2d63 6263 2d73 6861 312d 6b64 2028 3136  -cbc-sha1-kd (16
│ │ │ │ -0000ab10: 290a 2020 2020 2054 6963 6b65 7420 666c  ).     Ticket fl
│ │ │ │ -0000ab20: 6167 733a 2020 2050 524f 5849 4142 4c45  ags:   PROXIABLE
│ │ │ │ -0000ab30: 2049 4e49 5449 414c 2028 3532 3029 0a0a   INITIAL (520)..
│ │ │ │ -0000ab40: 2020 2054 6865 6e20 796f 7520 7368 6f75     Then you shou
│ │ │ │ -0000ab50: 6c64 2062 6520 6162 6c65 2074 6f20 6163  ld be able to ac
│ │ │ │ -0000ab60: 7175 6972 6520 7072 6f78 7920 7469 636b  quire proxy tick
│ │ │ │ -0000ab70: 6574 7320 6261 7365 6420 6f6e 2074 6861  ets based on tha
│ │ │ │ -0000ab80: 7420 7469 636b 6574 0a67 7261 6e74 696e  t ticket.grantin
│ │ │ │ -0000ab90: 6720 7469 636b 6574 2c20 6173 2066 6f6c  g ticket, as fol
│ │ │ │ -0000aba0: 6c6f 7773 3a0a 0a20 2020 2020 2420 7368  lows:..     $ sh
│ │ │ │ -0000abb0: 6973 6869 206a 6173 404a 4f53 4546 5353  ishi jas@JOSEFSS
│ │ │ │ -0000abc0: 4f4e 2e4f 5247 2069 6d61 702f 6c61 7474  ON.ORG imap/latt
│ │ │ │ -0000abd0: 652e 6a6f 7365 6673 736f 6e2e 6f72 6720  e.josefsson.org 
│ │ │ │ -0000abe0: 2d2d 7072 6f78 790a 2020 2020 206c 6962  --proxy.     lib
│ │ │ │ -0000abf0: 7368 6973 6869 3a20 7761 726e 696e 673a  shishi: warning:
│ │ │ │ -0000ac00: 204b 4443 2062 7567 3a20 5265 706c 7920   KDC bug: Reply 
│ │ │ │ -0000ac10: 656e 6372 7970 7465 6420 7573 696e 6720  encrypted using 
│ │ │ │ -0000ac20: 7772 6f6e 6720 6b65 792e 0a20 2020 2020  wrong key..     
│ │ │ │ -0000ac30: 6a61 7340 4a4f 5345 4653 534f 4e2e 4f52  jas@JOSEFSSON.OR
│ │ │ │ -0000ac40: 473a 0a20 2020 2020 4175 7468 7469 6d65  G:.     Authtime
│ │ │ │ -0000ac50: 3a20 2020 2020 2020 4d6f 6e20 5365 7020  :       Mon Sep 
│ │ │ │ -0000ac60: 2038 2032 303a 3034 3a32 3720 3230 3033   8 20:04:27 2003
│ │ │ │ -0000ac70: 0a20 2020 2020 5374 6172 7474 696d 653a  .     Starttime:
│ │ │ │ -0000ac80: 2020 2020 2020 4d6f 6e20 5365 7020 2038        Mon Sep  8
│ │ │ │ -0000ac90: 2032 303a 3034 3a33 3220 3230 3033 0a20   20:04:32 2003. 
│ │ │ │ -0000aca0: 2020 2020 456e 6474 696d 653a 2020 2020      Endtime:    
│ │ │ │ -0000acb0: 2020 2020 5475 6520 5365 7020 2039 2030      Tue Sep  9 0
│ │ │ │ -0000acc0: 343a 3034 3a32 3720 3230 3033 0a20 2020  4:04:27 2003.   
│ │ │ │ -0000acd0: 2020 5365 7276 6572 3a20 2020 2020 2020    Server:       
│ │ │ │ -0000ace0: 2020 696d 6170 2f6c 6174 7465 2e6a 6f73    imap/latte.jos
│ │ │ │ -0000acf0: 6566 7373 6f6e 2e6f 7267 206b 6579 2064  efsson.org key d
│ │ │ │ -0000ad00: 6573 332d 6362 632d 7368 6131 2d6b 6420  es3-cbc-sha1-kd 
│ │ │ │ -0000ad10: 2831 3629 0a20 2020 2020 5469 636b 6574  (16).     Ticket
│ │ │ │ -0000ad20: 206b 6579 3a20 2020 2020 6465 7333 2d63   key:     des3-c
│ │ │ │ -0000ad30: 6263 2d73 6861 312d 6b64 2028 3136 2920  bc-sha1-kd (16) 
│ │ │ │ -0000ad40: 7072 6f74 6563 7465 6420 6279 2064 6573  protected by des
│ │ │ │ -0000ad50: 332d 6362 632d 7368 6131 2d6b 6420 2831  3-cbc-sha1-kd (1
│ │ │ │ -0000ad60: 3629 0a20 2020 2020 5469 636b 6574 2066  6).     Ticket f
│ │ │ │ -0000ad70: 6c61 6773 3a20 2020 5052 4f58 5920 2831  lags:   PROXY (1
│ │ │ │ -0000ad80: 3629 0a20 2020 2020 240a 0a32 2e32 2046  6).     $..2.2 F
│ │ │ │ -0000ad90: 6f72 7761 7264 6162 6c65 2061 6e64 2046  orwardable and F
│ │ │ │ -0000ada0: 6f72 7761 7264 6564 2054 6963 6b65 7473  orwarded Tickets
│ │ │ │ -0000adb0: 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  .===============
│ │ │ │ +00009e30: 3d3d 3d3d 0a0a 4174 2074 696d 6573 2069  ====..At times i
│ │ │ │ +00009e40: 7420 6d61 7920 6265 206e 6563 6573 7361  t may be necessa
│ │ │ │ +00009e50: 7279 2066 6f72 2061 2070 7269 6e63 6970  ry for a princip
│ │ │ │ +00009e60: 616c 2074 6f20 616c 6c6f 7720 6120 7365  al to allow a se
│ │ │ │ +00009e70: 7276 6963 6520 746f 0a70 6572 666f 726d  rvice to.perform
│ │ │ │ +00009e80: 2061 6e20 6f70 6572 6174 696f 6e20 6f6e   an operation on
│ │ │ │ +00009e90: 2069 7473 2062 6568 616c 662e 2020 5468   its behalf.  Th
│ │ │ │ +00009ea0: 6520 7365 7276 6963 6520 6d75 7374 2062  e service must b
│ │ │ │ +00009eb0: 6520 6162 6c65 2074 6f20 7461 6b65 206f  e able to take o
│ │ │ │ +00009ec0: 6e0a 7468 6520 6964 656e 7469 7479 206f  n.the identity o
│ │ │ │ +00009ed0: 6620 7468 6520 636c 6965 6e74 2c20 6275  f the client, bu
│ │ │ │ +00009ee0: 7420 6f6e 6c79 2066 6f72 2061 2070 6172  t only for a par
│ │ │ │ +00009ef0: 7469 6375 6c61 7220 7075 7270 6f73 652e  ticular purpose.
│ │ │ │ +00009f00: 2020 410a 7072 696e 6369 7061 6c20 6361    A.principal ca
│ │ │ │ +00009f10: 6e20 616c 6c6f 7720 6120 7365 7276 6963  n allow a servic
│ │ │ │ +00009f20: 6520 746f 2074 616b 6520 6f6e 2074 6865  e to take on the
│ │ │ │ +00009f30: 2070 7269 6e63 6970 616c 2773 2069 6465   principal's ide
│ │ │ │ +00009f40: 6e74 6974 7920 666f 7220 610a 7061 7274  ntity for a.part
│ │ │ │ +00009f50: 6963 756c 6172 2070 7572 706f 7365 2062  icular purpose b
│ │ │ │ +00009f60: 7920 6772 616e 7469 6e67 2069 7420 6120  y granting it a 
│ │ │ │ +00009f70: 7072 6f78 792e 0a0a 2020 2054 6865 2070  proxy...   The p
│ │ │ │ +00009f80: 726f 6365 7373 206f 6620 6772 616e 7469  rocess of granti
│ │ │ │ +00009f90: 6e67 2061 2070 726f 7879 2075 7369 6e67  ng a proxy using
│ │ │ │ +00009fa0: 2074 6865 2070 726f 7879 2061 6e64 2070   the proxy and p
│ │ │ │ +00009fb0: 726f 7869 6162 6c65 2066 6c61 6773 0a69  roxiable flags.i
│ │ │ │ +00009fc0: 7320 7573 6564 2074 6f20 7072 6f76 6964  s used to provid
│ │ │ │ +00009fd0: 6520 6372 6564 656e 7469 616c 7320 666f  e credentials fo
│ │ │ │ +00009fe0: 7220 7573 6520 7769 7468 2073 7065 6369  r use with speci
│ │ │ │ +00009ff0: 6669 6320 7365 7276 6963 6573 2e20 2054  fic services.  T
│ │ │ │ +0000a000: 686f 7567 680a 636f 6e63 6570 7475 616c  hough.conceptual
│ │ │ │ +0000a010: 6c79 2061 6c73 6f20 6120 7072 6f78 792c  ly also a proxy,
│ │ │ │ +0000a020: 2075 7365 7273 2077 6973 6869 6e67 2074   users wishing t
│ │ │ │ +0000a030: 6f20 6465 6c65 6761 7465 2074 6865 6972  o delegate their
│ │ │ │ +0000a040: 2069 6465 6e74 6974 7920 696e 2061 0a66   identity in a.f
│ │ │ │ +0000a050: 6f72 6d20 7573 6162 6c65 2066 6f72 2061  orm usable for a
│ │ │ │ +0000a060: 6c6c 2070 7572 706f 7365 204d 5553 5420  ll purpose MUST 
│ │ │ │ +0000a070: 7573 6520 7468 6520 7469 636b 6574 2066  use the ticket f
│ │ │ │ +0000a080: 6f72 7761 7264 696e 6720 6d65 6368 616e  orwarding mechan
│ │ │ │ +0000a090: 6973 6d0a 6465 7363 7269 6265 6420 696e  ism.described in
│ │ │ │ +0000a0a0: 2074 6865 206e 6578 7420 7365 6374 696f   the next sectio
│ │ │ │ +0000a0b0: 6e20 746f 2066 6f72 7761 7264 2061 2074  n to forward a t
│ │ │ │ +0000a0c0: 6963 6b65 742d 6772 616e 7469 6e67 2074  icket-granting t
│ │ │ │ +0000a0d0: 6963 6b65 742e 0a0a 2020 2054 6865 2050  icket...   The P
│ │ │ │ +0000a0e0: 524f 5849 4142 4c45 2066 6c61 6720 696e  ROXIABLE flag in
│ │ │ │ +0000a0f0: 2061 2074 6963 6b65 7420 6973 206e 6f72   a ticket is nor
│ │ │ │ +0000a100: 6d61 6c6c 7920 6f6e 6c79 2069 6e74 6572  mally only inter
│ │ │ │ +0000a110: 7072 6574 6564 2062 7920 7468 650a 7469  preted by the.ti
│ │ │ │ +0000a120: 636b 6574 2d67 7261 6e74 696e 6720 7365  cket-granting se
│ │ │ │ +0000a130: 7276 6963 652e 2020 4974 2063 616e 2062  rvice.  It can b
│ │ │ │ +0000a140: 6520 6967 6e6f 7265 6420 6279 2061 7070  e ignored by app
│ │ │ │ +0000a150: 6c69 6361 7469 6f6e 2073 6572 7665 7273  lication servers
│ │ │ │ +0000a160: 2e0a 5768 656e 2073 6574 2c20 7468 6973  ..When set, this
│ │ │ │ +0000a170: 2066 6c61 6720 7465 6c6c 7320 7468 6520   flag tells the 
│ │ │ │ +0000a180: 7469 636b 6574 2d67 7261 6e74 696e 6720  ticket-granting 
│ │ │ │ +0000a190: 7365 7276 6572 2074 6861 7420 6974 2069  server that it i
│ │ │ │ +0000a1a0: 7320 4f4b 2074 6f0a 6973 7375 6520 6120  s OK to.issue a 
│ │ │ │ +0000a1b0: 6e65 7720 7469 636b 6574 2028 6275 7420  new ticket (but 
│ │ │ │ +0000a1c0: 6e6f 7420 6120 7469 636b 6574 2d67 7261  not a ticket-gra
│ │ │ │ +0000a1d0: 6e74 696e 6720 7469 636b 6574 2920 7769  nting ticket) wi
│ │ │ │ +0000a1e0: 7468 2061 2064 6966 6665 7265 6e74 0a6e  th a different.n
│ │ │ │ +0000a1f0: 6574 776f 726b 2061 6464 7265 7373 2062  etwork address b
│ │ │ │ +0000a200: 6173 6564 206f 6e20 7468 6973 2074 6963  ased on this tic
│ │ │ │ +0000a210: 6b65 742e 2020 5468 6973 2066 6c61 6720  ket.  This flag 
│ │ │ │ +0000a220: 6973 2073 6574 2069 6620 7265 7175 6573  is set if reques
│ │ │ │ +0000a230: 7465 6420 6279 0a74 6865 2063 6c69 656e  ted by.the clien
│ │ │ │ +0000a240: 7420 6f6e 2069 6e69 7469 616c 2061 7574  t on initial aut
│ │ │ │ +0000a250: 6865 6e74 6963 6174 696f 6e2e 2020 4279  hentication.  By
│ │ │ │ +0000a260: 2064 6566 6175 6c74 2c20 7468 6520 636c   default, the cl
│ │ │ │ +0000a270: 6965 6e74 2077 696c 6c0a 7265 7175 6573  ient will.reques
│ │ │ │ +0000a280: 7420 7468 6174 2069 7420 6265 2073 6574  t that it be set
│ │ │ │ +0000a290: 2077 6865 6e20 7265 7175 6573 7469 6e67   when requesting
│ │ │ │ +0000a2a0: 2061 2074 6963 6b65 742d 6772 616e 7469   a ticket-granti
│ │ │ │ +0000a2b0: 6e67 2074 6963 6b65 742c 2061 6e64 0a72  ng ticket, and.r
│ │ │ │ +0000a2c0: 6573 6574 2077 6865 6e20 7265 7175 6573  eset when reques
│ │ │ │ +0000a2d0: 7469 6e67 2061 6e79 206f 7468 6572 2074  ting any other t
│ │ │ │ +0000a2e0: 6963 6b65 742e 0a0a 2020 2054 6869 7320  icket...   This 
│ │ │ │ +0000a2f0: 666c 6167 2061 6c6c 6f77 7320 6120 636c  flag allows a cl
│ │ │ │ +0000a300: 6965 6e74 2074 6f20 7061 7373 2061 2070  ient to pass a p
│ │ │ │ +0000a310: 726f 7879 2074 6f20 6120 7365 7276 6572  roxy to a server
│ │ │ │ +0000a320: 2074 6f20 7065 7266 6f72 6d20 610a 7265   to perform a.re
│ │ │ │ +0000a330: 6d6f 7465 2072 6571 7565 7374 206f 6e20  mote request on 
│ │ │ │ +0000a340: 6974 7320 6265 6861 6c66 2028 652e 672e  its behalf (e.g.
│ │ │ │ +0000a350: 2020 6120 7072 696e 7420 7365 7276 6963    a print servic
│ │ │ │ +0000a360: 6520 636c 6965 6e74 2063 616e 2067 6976  e client can giv
│ │ │ │ +0000a370: 6520 7468 650a 7072 696e 7420 7365 7276  e the.print serv
│ │ │ │ +0000a380: 6572 2061 2070 726f 7879 2074 6f20 6163  er a proxy to ac
│ │ │ │ +0000a390: 6365 7373 2074 6865 2063 6c69 656e 7427  cess the client'
│ │ │ │ +0000a3a0: 7320 6669 6c65 7320 6f6e 2061 2070 6172  s files on a par
│ │ │ │ +0000a3b0: 7469 6375 6c61 7220 6669 6c65 0a73 6572  ticular file.ser
│ │ │ │ +0000a3c0: 7665 7220 696e 206f 7264 6572 2074 6f20  ver in order to 
│ │ │ │ +0000a3d0: 7361 7469 7366 7920 6120 7072 696e 7420  satisfy a print 
│ │ │ │ +0000a3e0: 7265 7175 6573 7429 2e0a 0a20 2020 496e  request)...   In
│ │ │ │ +0000a3f0: 206f 7264 6572 2074 6f20 636f 6d70 6c69   order to compli
│ │ │ │ +0000a400: 6361 7465 2074 6865 2075 7365 206f 6620  cate the use of 
│ │ │ │ +0000a410: 7374 6f6c 656e 2063 7265 6465 6e74 6961  stolen credentia
│ │ │ │ +0000a420: 6c73 2c20 4b65 7262 6572 6f73 0a74 6963  ls, Kerberos.tic
│ │ │ │ +0000a430: 6b65 7473 2061 7265 2075 7375 616c 6c79  kets are usually
│ │ │ │ +0000a440: 2076 616c 6964 2066 726f 6d20 6f6e 6c79   valid from only
│ │ │ │ +0000a450: 2074 686f 7365 206e 6574 776f 726b 2061   those network a
│ │ │ │ +0000a460: 6464 7265 7373 6573 2073 7065 6369 6669  ddresses specifi
│ │ │ │ +0000a470: 6361 6c6c 790a 696e 636c 7564 6564 2069  cally.included i
│ │ │ │ +0000a480: 6e20 7468 6520 7469 636b 6574 5b34 5d2e  n the ticket[4].
│ │ │ │ +0000a490: 2020 5768 656e 2067 7261 6e74 696e 6720    When granting 
│ │ │ │ +0000a4a0: 6120 7072 6f78 792c 2074 6865 2063 6c69  a proxy, the cli
│ │ │ │ +0000a4b0: 656e 7420 4d55 5354 0a73 7065 6369 6679  ent MUST.specify
│ │ │ │ +0000a4c0: 2074 6865 206e 6577 206e 6574 776f 726b   the new network
│ │ │ │ +0000a4d0: 2061 6464 7265 7373 2066 726f 6d20 7768   address from wh
│ │ │ │ +0000a4e0: 6963 6820 7468 6520 7072 6f78 7920 6973  ich the proxy is
│ │ │ │ +0000a4f0: 2074 6f20 6265 2075 7365 642c 206f 720a   to be used, or.
│ │ │ │ +0000a500: 696e 6469 6361 7465 2074 6861 7420 7468  indicate that th
│ │ │ │ +0000a510: 6520 7072 6f78 7920 6973 2074 6f20 6265  e proxy is to be
│ │ │ │ +0000a520: 2069 7373 7565 6420 666f 7220 7573 6520   issued for use 
│ │ │ │ +0000a530: 6672 6f6d 2061 6e79 2061 6464 7265 7373  from any address
│ │ │ │ +0000a540: 2e0a 0a20 2020 5468 6520 5052 4f58 5920  ...   The PROXY 
│ │ │ │ +0000a550: 666c 6167 2069 7320 7365 7420 696e 2061  flag is set in a
│ │ │ │ +0000a560: 2074 6963 6b65 7420 6279 2074 6865 2054   ticket by the T
│ │ │ │ +0000a570: 4753 2077 6865 6e20 6974 2069 7373 7565  GS when it issue
│ │ │ │ +0000a580: 7320 6120 7072 6f78 790a 7469 636b 6574  s a proxy.ticket
│ │ │ │ +0000a590: 2e20 2041 7070 6c69 6361 7469 6f6e 2073  .  Application s
│ │ │ │ +0000a5a0: 6572 7665 7273 204d 4159 2063 6865 636b  ervers MAY check
│ │ │ │ +0000a5b0: 2074 6869 7320 666c 6167 2061 6e64 2061   this flag and a
│ │ │ │ +0000a5c0: 7420 7468 6569 7220 6f70 7469 6f6e 0a74  t their option.t
│ │ │ │ +0000a5d0: 6865 7920 4d41 5920 7265 7175 6972 6520  hey MAY require 
│ │ │ │ +0000a5e0: 6164 6469 7469 6f6e 616c 2061 7574 6865  additional authe
│ │ │ │ +0000a5f0: 6e74 6963 6174 696f 6e20 6672 6f6d 2074  ntication from t
│ │ │ │ +0000a600: 6865 2061 6765 6e74 2070 7265 7365 6e74  he agent present
│ │ │ │ +0000a610: 696e 6720 7468 650a 7072 6f78 7920 696e  ing the.proxy in
│ │ │ │ +0000a620: 206f 7264 6572 2074 6f20 7072 6f76 6964   order to provid
│ │ │ │ +0000a630: 6520 616e 2061 7564 6974 2074 7261 696c  e an audit trail
│ │ │ │ +0000a640: 2e0a 0a20 2020 4865 7265 2069 7320 686f  ...   Here is ho
│ │ │ │ +0000a650: 7720 796f 7520 776f 756c 6420 6163 7175  w you would acqu
│ │ │ │ +0000a660: 6972 6520 6120 5052 4f58 5920 7469 636b  ire a PROXY tick
│ │ │ │ +0000a670: 6574 2066 6f72 2074 6865 2073 6572 7669  et for the servi
│ │ │ │ +0000a680: 6365 0ae2 8098 696d 6170 2f6c 6174 7465  ce....imap/latte
│ │ │ │ +0000a690: 2e6a 6f73 6566 7373 6f6e 2e6f 7267 e280  .josefsson.org..
│ │ │ │ +0000a6a0: 993a 0a0a 2020 2020 2024 2073 6869 7368  .:..     $ shish
│ │ │ │ +0000a6b0: 6920 6a61 7340 4a4f 5345 4653 534f 4e2e  i jas@JOSEFSSON.
│ │ │ │ +0000a6c0: 4f52 4720 696d 6170 2f6c 6174 7465 2e6a  ORG imap/latte.j
│ │ │ │ +0000a6d0: 6f73 6566 7373 6f6e 2e6f 7267 202d 2d70  osefsson.org --p
│ │ │ │ +0000a6e0: 726f 7879 0a20 2020 2020 456e 7465 7220  roxy.     Enter 
│ │ │ │ +0000a6f0: 7061 7373 776f 7264 2066 6f72 2060 6a61  password for `ja
│ │ │ │ +0000a700: 7340 4a4f 5345 4653 534f 4e2e 4f52 4727  s@JOSEFSSON.ORG'
│ │ │ │ +0000a710: 3a0a 2020 2020 206c 6962 7368 6973 6869  :.     libshishi
│ │ │ │ +0000a720: 3a20 7761 726e 696e 673a 204b 4443 2062  : warning: KDC b
│ │ │ │ +0000a730: 7567 3a20 5265 706c 7920 656e 6372 7970  ug: Reply encryp
│ │ │ │ +0000a740: 7465 6420 7573 696e 6720 7772 6f6e 6720  ted using wrong 
│ │ │ │ +0000a750: 6b65 792e 0a20 2020 2020 6a61 7340 4a4f  key..     jas@JO
│ │ │ │ +0000a760: 5345 4653 534f 4e2e 4f52 473a 0a20 2020  SEFSSON.ORG:.   
│ │ │ │ +0000a770: 2020 4175 7468 7469 6d65 3a20 2020 2020    Authtime:     
│ │ │ │ +0000a780: 2020 4d6f 6e20 5365 7020 2038 2032 303a    Mon Sep  8 20:
│ │ │ │ +0000a790: 3032 3a33 3520 3230 3033 0a20 2020 2020  02:35 2003.     
│ │ │ │ +0000a7a0: 5374 6172 7474 696d 653a 2020 2020 2020  Starttime:      
│ │ │ │ +0000a7b0: 4d6f 6e20 5365 7020 2038 2032 303a 3032  Mon Sep  8 20:02
│ │ │ │ +0000a7c0: 3a33 3620 3230 3033 0a20 2020 2020 456e  :36 2003.     En
│ │ │ │ +0000a7d0: 6474 696d 653a 2020 2020 2020 2020 5475  dtime:        Tu
│ │ │ │ +0000a7e0: 6520 5365 7020 2039 2030 343a 3032 3a33  e Sep  9 04:02:3
│ │ │ │ +0000a7f0: 3520 3230 3033 0a20 2020 2020 5365 7276  5 2003.     Serv
│ │ │ │ +0000a800: 6572 3a20 2020 2020 2020 2020 696d 6170  er:         imap
│ │ │ │ +0000a810: 2f6c 6174 7465 2e6a 6f73 6566 7373 6f6e  /latte.josefsson
│ │ │ │ +0000a820: 2e6f 7267 206b 6579 2064 6573 332d 6362  .org key des3-cb
│ │ │ │ +0000a830: 632d 7368 6131 2d6b 6420 2831 3629 0a20  c-sha1-kd (16). 
│ │ │ │ +0000a840: 2020 2020 5469 636b 6574 206b 6579 3a20      Ticket key: 
│ │ │ │ +0000a850: 2020 2020 6465 7333 2d63 6263 2d73 6861      des3-cbc-sha
│ │ │ │ +0000a860: 312d 6b64 2028 3136 2920 7072 6f74 6563  1-kd (16) protec
│ │ │ │ +0000a870: 7465 6420 6279 2064 6573 332d 6362 632d  ted by des3-cbc-
│ │ │ │ +0000a880: 7368 6131 2d6b 6420 2831 3629 0a20 2020  sha1-kd (16).   
│ │ │ │ +0000a890: 2020 5469 636b 6574 2066 6c61 6773 3a20    Ticket flags: 
│ │ │ │ +0000a8a0: 2020 5052 4f58 5920 2831 3629 0a20 2020    PROXY (16).   
│ │ │ │ +0000a8b0: 2020 240a 0a20 2020 4173 2079 6f75 206e    $..   As you n
│ │ │ │ +0000a8c0: 6f74 6963 6564 2c20 7468 6973 2061 736b  oticed, this ask
│ │ │ │ +0000a8d0: 6564 2066 6f72 2079 6f75 7220 7061 7373  ed for your pass
│ │ │ │ +0000a8e0: 776f 7264 2e20 2054 6865 2072 6561 736f  word.  The reaso
│ │ │ │ +0000a8f0: 6e20 6973 2074 6861 740a 7072 6f78 7920  n is that.proxy 
│ │ │ │ +0000a900: 7469 636b 6574 7320 6d75 7374 2062 6520  tickets must be 
│ │ │ │ +0000a910: 6163 7175 6972 6564 2075 7369 6e67 2061  acquired using a
│ │ │ │ +0000a920: 2070 726f 7869 6162 6c65 2074 6963 6b65   proxiable ticke
│ │ │ │ +0000a930: 7420 6772 616e 7469 6e67 2074 6963 6b65  t granting ticke
│ │ │ │ +0000a940: 742c 0a77 6869 6368 2077 6173 206e 6f74  t,.which was not
│ │ │ │ +0000a950: 2070 7265 7365 6e74 2e20 2049 6620 796f   present.  If yo
│ │ │ │ +0000a960: 7520 6f66 7465 6e20 6e65 6564 2074 6f20  u often need to 
│ │ │ │ +0000a970: 6765 7420 7072 6f78 7920 7469 636b 6574  get proxy ticket
│ │ │ │ +0000a980: 732c 2079 6f75 206d 6179 0a61 6371 7569  s, you may.acqui
│ │ │ │ +0000a990: 7265 2061 2070 726f 7869 6162 6c65 2074  re a proxiable t
│ │ │ │ +0000a9a0: 6963 6b65 7420 6772 616e 7469 6e67 2074  icket granting t
│ │ │ │ +0000a9b0: 6963 6b65 7420 6672 6f6d 2074 6865 2073  icket from the s
│ │ │ │ +0000a9c0: 7461 7274 3a0a 0a20 2020 2020 2420 7368  tart:..     $ sh
│ │ │ │ +0000a9d0: 6973 6869 202d 2d70 726f 7869 6162 6c65  ishi --proxiable
│ │ │ │ +0000a9e0: 0a20 2020 2020 456e 7465 7220 7061 7373  .     Enter pass
│ │ │ │ +0000a9f0: 776f 7264 2066 6f72 2060 6a61 7340 4a4f  word for `jas@JO
│ │ │ │ +0000aa00: 5345 4653 534f 4e2e 4f52 4727 3a0a 2020  SEFSSON.ORG':.  
│ │ │ │ +0000aa10: 2020 206a 6173 404a 4f53 4546 5353 4f4e     jas@JOSEFSSON
│ │ │ │ +0000aa20: 2e4f 5247 3a0a 2020 2020 2041 7574 6874  .ORG:.     Autht
│ │ │ │ +0000aa30: 696d 653a 2020 2020 2020 204d 6f6e 2053  ime:       Mon S
│ │ │ │ +0000aa40: 6570 2020 3820 3230 3a30 343a 3237 2032  ep  8 20:04:27 2
│ │ │ │ +0000aa50: 3030 330a 2020 2020 2045 6e64 7469 6d65  003.     Endtime
│ │ │ │ +0000aa60: 3a20 2020 2020 2020 2054 7565 2053 6570  :        Tue Sep
│ │ │ │ +0000aa70: 2020 3920 3034 3a30 343a 3237 2032 3030    9 04:04:27 200
│ │ │ │ +0000aa80: 330a 2020 2020 2053 6572 7665 723a 2020  3.     Server:  
│ │ │ │ +0000aa90: 2020 2020 2020 206b 7262 7467 742f 4a4f         krbtgt/JO
│ │ │ │ +0000aaa0: 5345 4653 534f 4e2e 4f52 4720 6b65 7920  SEFSSON.ORG key 
│ │ │ │ +0000aab0: 6465 7333 2d63 6263 2d73 6861 312d 6b64  des3-cbc-sha1-kd
│ │ │ │ +0000aac0: 2028 3136 290a 2020 2020 2054 6963 6b65   (16).     Ticke
│ │ │ │ +0000aad0: 7420 6b65 793a 2020 2020 2064 6573 332d  t key:     des3-
│ │ │ │ +0000aae0: 6362 632d 7368 6131 2d6b 6420 2831 3629  cbc-sha1-kd (16)
│ │ │ │ +0000aaf0: 2070 726f 7465 6374 6564 2062 7920 6465   protected by de
│ │ │ │ +0000ab00: 7333 2d63 6263 2d73 6861 312d 6b64 2028  s3-cbc-sha1-kd (
│ │ │ │ +0000ab10: 3136 290a 2020 2020 2054 6963 6b65 7420  16).     Ticket 
│ │ │ │ +0000ab20: 666c 6167 733a 2020 2050 524f 5849 4142  flags:   PROXIAB
│ │ │ │ +0000ab30: 4c45 2049 4e49 5449 414c 2028 3532 3029  LE INITIAL (520)
│ │ │ │ +0000ab40: 0a0a 2020 2054 6865 6e20 796f 7520 7368  ..   Then you sh
│ │ │ │ +0000ab50: 6f75 6c64 2062 6520 6162 6c65 2074 6f20  ould be able to 
│ │ │ │ +0000ab60: 6163 7175 6972 6520 7072 6f78 7920 7469  acquire proxy ti
│ │ │ │ +0000ab70: 636b 6574 7320 6261 7365 6420 6f6e 2074  ckets based on t
│ │ │ │ +0000ab80: 6861 7420 7469 636b 6574 0a67 7261 6e74  hat ticket.grant
│ │ │ │ +0000ab90: 696e 6720 7469 636b 6574 2c20 6173 2066  ing ticket, as f
│ │ │ │ +0000aba0: 6f6c 6c6f 7773 3a0a 0a20 2020 2020 2420  ollows:..     $ 
│ │ │ │ +0000abb0: 7368 6973 6869 206a 6173 404a 4f53 4546  shishi jas@JOSEF
│ │ │ │ +0000abc0: 5353 4f4e 2e4f 5247 2069 6d61 702f 6c61  SSON.ORG imap/la
│ │ │ │ +0000abd0: 7474 652e 6a6f 7365 6673 736f 6e2e 6f72  tte.josefsson.or
│ │ │ │ +0000abe0: 6720 2d2d 7072 6f78 790a 2020 2020 206c  g --proxy.     l
│ │ │ │ +0000abf0: 6962 7368 6973 6869 3a20 7761 726e 696e  ibshishi: warnin
│ │ │ │ +0000ac00: 673a 204b 4443 2062 7567 3a20 5265 706c  g: KDC bug: Repl
│ │ │ │ +0000ac10: 7920 656e 6372 7970 7465 6420 7573 696e  y encrypted usin
│ │ │ │ +0000ac20: 6720 7772 6f6e 6720 6b65 792e 0a20 2020  g wrong key..   
│ │ │ │ +0000ac30: 2020 6a61 7340 4a4f 5345 4653 534f 4e2e    jas@JOSEFSSON.
│ │ │ │ +0000ac40: 4f52 473a 0a20 2020 2020 4175 7468 7469  ORG:.     Authti
│ │ │ │ +0000ac50: 6d65 3a20 2020 2020 2020 4d6f 6e20 5365  me:       Mon Se
│ │ │ │ +0000ac60: 7020 2038 2032 303a 3034 3a32 3720 3230  p  8 20:04:27 20
│ │ │ │ +0000ac70: 3033 0a20 2020 2020 5374 6172 7474 696d  03.     Starttim
│ │ │ │ +0000ac80: 653a 2020 2020 2020 4d6f 6e20 5365 7020  e:      Mon Sep 
│ │ │ │ +0000ac90: 2038 2032 303a 3034 3a33 3220 3230 3033   8 20:04:32 2003
│ │ │ │ +0000aca0: 0a20 2020 2020 456e 6474 696d 653a 2020  .     Endtime:  
│ │ │ │ +0000acb0: 2020 2020 2020 5475 6520 5365 7020 2039        Tue Sep  9
│ │ │ │ +0000acc0: 2030 343a 3034 3a32 3720 3230 3033 0a20   04:04:27 2003. 
│ │ │ │ +0000acd0: 2020 2020 5365 7276 6572 3a20 2020 2020      Server:     
│ │ │ │ +0000ace0: 2020 2020 696d 6170 2f6c 6174 7465 2e6a      imap/latte.j
│ │ │ │ +0000acf0: 6f73 6566 7373 6f6e 2e6f 7267 206b 6579  osefsson.org key
│ │ │ │ +0000ad00: 2064 6573 332d 6362 632d 7368 6131 2d6b   des3-cbc-sha1-k
│ │ │ │ +0000ad10: 6420 2831 3629 0a20 2020 2020 5469 636b  d (16).     Tick
│ │ │ │ +0000ad20: 6574 206b 6579 3a20 2020 2020 6465 7333  et key:     des3
│ │ │ │ +0000ad30: 2d63 6263 2d73 6861 312d 6b64 2028 3136  -cbc-sha1-kd (16
│ │ │ │ +0000ad40: 2920 7072 6f74 6563 7465 6420 6279 2064  ) protected by d
│ │ │ │ +0000ad50: 6573 332d 6362 632d 7368 6131 2d6b 6420  es3-cbc-sha1-kd 
│ │ │ │ +0000ad60: 2831 3629 0a20 2020 2020 5469 636b 6574  (16).     Ticket
│ │ │ │ +0000ad70: 2066 6c61 6773 3a20 2020 5052 4f58 5920   flags:   PROXY 
│ │ │ │ +0000ad80: 2831 3629 0a20 2020 2020 240a 0a32 2e32  (16).     $..2.2
│ │ │ │ +0000ad90: 2046 6f72 7761 7264 6162 6c65 2061 6e64   Forwardable and
│ │ │ │ +0000ada0: 2046 6f72 7761 7264 6564 2054 6963 6b65   Forwarded Ticke
│ │ │ │ +0000adb0: 7473 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ts.=============
│ │ │ │  0000adc0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ -0000add0: 3d3d 3d3d 3d3d 0a0a 4175 7468 656e 7469  ======..Authenti
│ │ │ │ -0000ade0: 6361 7469 6f6e 2066 6f72 7761 7264 696e  cation forwardin
│ │ │ │ -0000adf0: 6720 6973 2061 6e20 696e 7374 616e 6365  g is an instance
│ │ │ │ -0000ae00: 206f 6620 6120 7072 6f78 7920 7768 6572   of a proxy wher
│ │ │ │ -0000ae10: 6520 7468 6520 7365 7276 6963 650a 7468  e the service.th
│ │ │ │ -0000ae20: 6174 2069 7320 6772 616e 7465 6420 6973  at is granted is
│ │ │ │ -0000ae30: 2063 6f6d 706c 6574 6520 7573 6520 6f66   complete use of
│ │ │ │ -0000ae40: 2074 6865 2063 6c69 656e 7427 7320 6964   the client's id
│ │ │ │ -0000ae50: 656e 7469 7479 2e20 2041 6e20 6578 616d  entity.  An exam
│ │ │ │ -0000ae60: 706c 650a 7768 6572 6520 6974 206d 6967  ple.where it mig
│ │ │ │ -0000ae70: 6874 2062 6520 7573 6564 2069 7320 7768  ht be used is wh
│ │ │ │ -0000ae80: 656e 2061 2075 7365 7220 6c6f 6773 2069  en a user logs i
│ │ │ │ -0000ae90: 6e20 746f 2061 2072 656d 6f74 6520 7379  n to a remote sy
│ │ │ │ -0000aea0: 7374 656d 2061 6e64 0a77 616e 7473 2061  stem and.wants a
│ │ │ │ -0000aeb0: 7574 6865 6e74 6963 6174 696f 6e20 746f  uthentication to
│ │ │ │ -0000aec0: 2077 6f72 6b20 6672 6f6d 2074 6861 7420   work from that 
│ │ │ │ -0000aed0: 7379 7374 656d 2061 7320 6966 2074 6865  system as if the
│ │ │ │ -0000aee0: 206c 6f67 696e 2077 6572 650a 6c6f 6361   login were.loca
│ │ │ │ -0000aef0: 6c2e 0a0a 2020 2054 6865 2046 4f52 5741  l...   The FORWA
│ │ │ │ -0000af00: 5244 4142 4c45 2066 6c61 6720 696e 2061  RDABLE flag in a
│ │ │ │ -0000af10: 2074 6963 6b65 7420 6973 206e 6f72 6d61   ticket is norma
│ │ │ │ -0000af20: 6c6c 7920 6f6e 6c79 2069 6e74 6572 7072  lly only interpr
│ │ │ │ -0000af30: 6574 6564 2062 7920 7468 650a 7469 636b  eted by the.tick
│ │ │ │ -0000af40: 6574 2d67 7261 6e74 696e 6720 7365 7276  et-granting serv
│ │ │ │ -0000af50: 6963 652e 2020 4974 2063 616e 2062 6520  ice.  It can be 
│ │ │ │ -0000af60: 6967 6e6f 7265 6420 6279 2061 7070 6c69  ignored by appli
│ │ │ │ -0000af70: 6361 7469 6f6e 2073 6572 7665 7273 2e20  cation servers. 
│ │ │ │ -0000af80: 2054 6865 0a46 4f52 5741 5244 4142 4c45   The.FORWARDABLE
│ │ │ │ -0000af90: 2066 6c61 6720 6861 7320 616e 2069 6e74   flag has an int
│ │ │ │ -0000afa0: 6572 7072 6574 6174 696f 6e20 7369 6d69  erpretation simi
│ │ │ │ -0000afb0: 6c61 7220 746f 2074 6861 7420 6f66 2074  lar to that of t
│ │ │ │ -0000afc0: 6865 2050 524f 5849 4142 4c45 0a66 6c61  he PROXIABLE.fla
│ │ │ │ -0000afd0: 672c 2065 7863 6570 7420 7469 636b 6574  g, except ticket
│ │ │ │ -0000afe0: 2d67 7261 6e74 696e 6720 7469 636b 6574  -granting ticket
│ │ │ │ -0000aff0: 7320 6d61 7920 616c 736f 2062 6520 6973  s may also be is
│ │ │ │ -0000b000: 7375 6564 2077 6974 6820 6469 6666 6572  sued with differ
│ │ │ │ -0000b010: 656e 740a 6e65 7477 6f72 6b20 6164 6472  ent.network addr
│ │ │ │ -0000b020: 6573 7365 732e 2020 5468 6973 2066 6c61  esses.  This fla
│ │ │ │ -0000b030: 6720 6973 2072 6573 6574 2062 7920 6465  g is reset by de
│ │ │ │ -0000b040: 6661 756c 742c 2062 7574 2075 7365 7273  fault, but users
│ │ │ │ -0000b050: 204d 4159 2072 6571 7565 7374 0a74 6861   MAY request.tha
│ │ │ │ -0000b060: 7420 6974 2062 6520 7365 7420 6279 2073  t it be set by s
│ │ │ │ -0000b070: 6574 7469 6e67 2074 6865 2046 4f52 5741  etting the FORWA
│ │ │ │ -0000b080: 5244 4142 4c45 206f 7074 696f 6e20 696e  RDABLE option in
│ │ │ │ -0000b090: 2074 6865 2041 5320 7265 7175 6573 7420   the AS request 
│ │ │ │ -0000b0a0: 7768 656e 0a74 6865 7920 7265 7175 6573  when.they reques
│ │ │ │ -0000b0b0: 7420 7468 6569 7220 696e 6974 6961 6c20  t their initial 
│ │ │ │ -0000b0c0: 7469 636b 6574 2d67 7261 6e74 696e 6720  ticket-granting 
│ │ │ │ -0000b0d0: 7469 636b 6574 2e0a 0a20 2020 5468 6973  ticket...   This
│ │ │ │ -0000b0e0: 2066 6c61 6720 616c 6c6f 7773 2066 6f72   flag allows for
│ │ │ │ -0000b0f0: 2061 7574 6865 6e74 6963 6174 696f 6e20   authentication 
│ │ │ │ -0000b100: 666f 7277 6172 6469 6e67 2077 6974 686f  forwarding witho
│ │ │ │ -0000b110: 7574 2072 6571 7569 7269 6e67 2074 6865  ut requiring the
│ │ │ │ -0000b120: 0a75 7365 7220 746f 2065 6e74 6572 2061  .user to enter a
│ │ │ │ -0000b130: 2070 6173 7377 6f72 6420 6167 6169 6e2e   password again.
│ │ │ │ -0000b140: 2020 4966 2074 6865 2066 6c61 6720 6973    If the flag is
│ │ │ │ -0000b150: 206e 6f74 2073 6574 2c20 7468 656e 0a61   not set, then.a
│ │ │ │ -0000b160: 7574 6865 6e74 6963 6174 696f 6e20 666f  uthentication fo
│ │ │ │ -0000b170: 7277 6172 6469 6e67 2069 7320 6e6f 7420  rwarding is not 
│ │ │ │ -0000b180: 7065 726d 6974 7465 642c 2062 7574 2074  permitted, but t
│ │ │ │ -0000b190: 6865 2073 616d 6520 7265 7375 6c74 2063  he same result c
│ │ │ │ -0000b1a0: 616e 0a73 7469 6c6c 2062 6520 6163 6869  an.still be achi
│ │ │ │ -0000b1b0: 6576 6564 2069 6620 7468 6520 7573 6572  eved if the user
│ │ │ │ -0000b1c0: 2065 6e67 6167 6573 2069 6e20 7468 6520   engages in the 
│ │ │ │ -0000b1d0: 4153 2065 7863 6861 6e67 6520 7370 6563  AS exchange spec
│ │ │ │ -0000b1e0: 6966 7969 6e67 2074 6865 0a72 6571 7565  ifying the.reque
│ │ │ │ -0000b1f0: 7374 6564 206e 6574 776f 726b 2061 6464  sted network add
│ │ │ │ -0000b200: 7265 7373 6573 2061 6e64 2073 7570 706c  resses and suppl
│ │ │ │ -0000b210: 6965 7320 6120 7061 7373 776f 7264 2e0a  ies a password..
│ │ │ │ -0000b220: 0a20 2020 5468 6520 464f 5257 4152 4445  .   The FORWARDE
│ │ │ │ -0000b230: 4420 666c 6167 2069 7320 7365 7420 6279  D flag is set by
│ │ │ │ -0000b240: 2074 6865 2054 4753 2077 6865 6e20 6120   the TGS when a 
│ │ │ │ -0000b250: 636c 6965 6e74 2070 7265 7365 6e74 7320  client presents 
│ │ │ │ -0000b260: 6120 7469 636b 6574 0a77 6974 6820 7468  a ticket.with th
│ │ │ │ -0000b270: 6520 464f 5257 4152 4441 424c 4520 666c  e FORWARDABLE fl
│ │ │ │ -0000b280: 6167 2073 6574 2061 6e64 2072 6571 7565  ag set and reque
│ │ │ │ -0000b290: 7374 7320 6120 666f 7277 6172 6465 6420  sts a forwarded 
│ │ │ │ -0000b2a0: 7469 636b 6574 2062 790a 7370 6563 6966  ticket by.specif
│ │ │ │ -0000b2b0: 7969 6e67 2074 6865 2046 4f52 5741 5244  ying the FORWARD
│ │ │ │ -0000b2c0: 4544 204b 4443 206f 7074 696f 6e20 616e  ED KDC option an
│ │ │ │ -0000b2d0: 6420 7375 7070 6c79 696e 6720 6120 7365  d supplying a se
│ │ │ │ -0000b2e0: 7420 6f66 2061 6464 7265 7373 6573 2066  t of addresses f
│ │ │ │ -0000b2f0: 6f72 0a74 6865 206e 6577 2074 6963 6b65  or.the new ticke
│ │ │ │ -0000b300: 742e 2020 4974 2069 7320 616c 736f 2073  t.  It is also s
│ │ │ │ -0000b310: 6574 2069 6e20 616c 6c20 7469 636b 6574  et in all ticket
│ │ │ │ -0000b320: 7320 6973 7375 6564 2062 6173 6564 206f  s issued based o
│ │ │ │ -0000b330: 6e20 7469 636b 6574 730a 7769 7468 2074  n tickets.with t
│ │ │ │ -0000b340: 6865 2046 4f52 5741 5244 4544 2066 6c61  he FORWARDED fla
│ │ │ │ -0000b350: 6720 7365 742e 2020 4170 706c 6963 6174  g set.  Applicat
│ │ │ │ -0000b360: 696f 6e20 7365 7276 6572 7320 6d61 7920  ion servers may 
│ │ │ │ -0000b370: 6368 6f6f 7365 2074 6f20 7072 6f63 6573  choose to proces
│ │ │ │ -0000b380: 730a 464f 5257 4152 4445 4420 7469 636b  s.FORWARDED tick
│ │ │ │ -0000b390: 6574 7320 6469 6666 6572 656e 746c 7920  ets differently 
│ │ │ │ -0000b3a0: 7468 616e 206e 6f6e 2d46 4f52 5741 5244  than non-FORWARD
│ │ │ │ -0000b3b0: 4544 2074 6963 6b65 7473 2e0a 0a20 2020  ED tickets...   
│ │ │ │ -0000b3c0: 4966 2061 6464 7265 7373 6c65 7373 2074  If addressless t
│ │ │ │ -0000b3d0: 6963 6b65 7473 2061 7265 2066 6f72 7761  ickets are forwa
│ │ │ │ -0000b3e0: 7264 6564 2066 726f 6d20 6f6e 6520 7379  rded from one sy
│ │ │ │ -0000b3f0: 7374 656d 2074 6f20 616e 6f74 6865 722c  stem to another,
│ │ │ │ -0000b400: 0a63 6c69 656e 7473 2053 484f 554c 4420  .clients SHOULD 
│ │ │ │ -0000b410: 7374 696c 6c20 7573 6520 7468 6973 206f  still use this o
│ │ │ │ -0000b420: 7074 696f 6e20 746f 206f 6274 6169 6e20  ption to obtain 
│ │ │ │ -0000b430: 6120 6e65 7720 5447 5420 696e 206f 7264  a new TGT in ord
│ │ │ │ -0000b440: 6572 2074 6f0a 6861 7665 2064 6966 6665  er to.have diffe
│ │ │ │ -0000b450: 7265 6e74 2073 6573 7369 6f6e 206b 6579  rent session key
│ │ │ │ -0000b460: 7320 6f6e 2074 6865 2064 6966 6665 7265  s on the differe
│ │ │ │ -0000b470: 6e74 2073 7973 7465 6d73 2e0a 0a20 2020  nt systems...   
│ │ │ │ -0000b480: 4865 7265 2069 7320 686f 7720 796f 7520  Here is how you 
│ │ │ │ -0000b490: 776f 756c 6420 6163 7175 6972 6520 6120  would acquire a 
│ │ │ │ -0000b4a0: 464f 5257 4152 4445 4420 7469 636b 6574  FORWARDED ticket
│ │ │ │ -0000b4b0: 2066 6f72 2074 6865 2073 6572 7669 6365   for the service
│ │ │ │ -0000b4c0: 0ae2 8098 686f 7374 2f6c 6174 7465 2e6a  ....host/latte.j
│ │ │ │ -0000b4d0: 6f73 6566 7373 6f6e 2e6f 7267 e280 993a  osefsson.org...:
│ │ │ │ -0000b4e0: 0a0a 2020 2020 2024 2073 6869 7368 6920  ..     $ shishi 
│ │ │ │ -0000b4f0: 6a61 7340 4a4f 5345 4653 534f 4e2e 4f52  jas@JOSEFSSON.OR
│ │ │ │ -0000b500: 4720 686f 7374 2f6c 6174 7465 2e6a 6f73  G host/latte.jos
│ │ │ │ -0000b510: 6566 7373 6f6e 2e6f 7267 202d 2d66 6f72  efsson.org --for
│ │ │ │ -0000b520: 7761 7264 6564 0a20 2020 2020 456e 7465  warded.     Ente
│ │ │ │ -0000b530: 7220 7061 7373 776f 7264 2066 6f72 2060  r password for `
│ │ │ │ -0000b540: 6a61 7340 4a4f 5345 4653 534f 4e2e 4f52  jas@JOSEFSSON.OR
│ │ │ │ -0000b550: 4727 3a0a 2020 2020 206c 6962 7368 6973  G':.     libshis
│ │ │ │ -0000b560: 6869 3a20 7761 726e 696e 673a 204b 4443  hi: warning: KDC
│ │ │ │ -0000b570: 2062 7567 3a20 5265 706c 7920 656e 6372   bug: Reply encr
│ │ │ │ -0000b580: 7970 7465 6420 7573 696e 6720 7772 6f6e  ypted using wron
│ │ │ │ -0000b590: 6720 6b65 792e 0a20 2020 2020 6a61 7340  g key..     jas@
│ │ │ │ -0000b5a0: 4a4f 5345 4653 534f 4e2e 4f52 473a 0a20  JOSEFSSON.ORG:. 
│ │ │ │ -0000b5b0: 2020 2020 4175 7468 7469 6d65 3a20 2020      Authtime:   
│ │ │ │ -0000b5c0: 2020 2020 4d6f 6e20 5365 7020 2038 2032      Mon Sep  8 2
│ │ │ │ -0000b5d0: 303a 3037 3a31 3120 3230 3033 0a20 2020  0:07:11 2003.   
│ │ │ │ -0000b5e0: 2020 5374 6172 7474 696d 653a 2020 2020    Starttime:    
│ │ │ │ -0000b5f0: 2020 4d6f 6e20 5365 7020 2038 2032 303a    Mon Sep  8 20:
│ │ │ │ -0000b600: 3037 3a31 3220 3230 3033 0a20 2020 2020  07:12 2003.     
│ │ │ │ -0000b610: 456e 6474 696d 653a 2020 2020 2020 2020  Endtime:        
│ │ │ │ -0000b620: 5475 6520 5365 7020 2039 2030 343a 3037  Tue Sep  9 04:07
│ │ │ │ -0000b630: 3a31 3120 3230 3033 0a20 2020 2020 5365  :11 2003.     Se
│ │ │ │ -0000b640: 7276 6572 3a20 2020 2020 2020 2020 686f  rver:         ho
│ │ │ │ -0000b650: 7374 2f6c 6174 7465 2e6a 6f73 6566 7373  st/latte.josefss
│ │ │ │ -0000b660: 6f6e 2e6f 7267 206b 6579 2064 6573 332d  on.org key des3-
│ │ │ │ -0000b670: 6362 632d 7368 6131 2d6b 6420 2831 3629  cbc-sha1-kd (16)
│ │ │ │ -0000b680: 0a20 2020 2020 5469 636b 6574 206b 6579  .     Ticket key
│ │ │ │ -0000b690: 3a20 2020 2020 6465 7333 2d63 6263 2d73  :     des3-cbc-s
│ │ │ │ -0000b6a0: 6861 312d 6b64 2028 3136 2920 7072 6f74  ha1-kd (16) prot
│ │ │ │ -0000b6b0: 6563 7465 6420 6279 2064 6573 332d 6362  ected by des3-cb
│ │ │ │ -0000b6c0: 632d 7368 6131 2d6b 6420 2831 3629 0a20  c-sha1-kd (16). 
│ │ │ │ -0000b6d0: 2020 2020 5469 636b 6574 2066 6c61 6773      Ticket flags
│ │ │ │ -0000b6e0: 3a20 2020 464f 5257 4152 4445 4420 2834  :   FORWARDED (4
│ │ │ │ -0000b6f0: 290a 2020 2020 2024 0a0a 2020 2041 7320  ).     $..   As 
│ │ │ │ -0000b700: 796f 7520 6e6f 7469 6365 642c 2074 6869  you noticed, thi
│ │ │ │ -0000b710: 7320 6173 6b65 6420 666f 7220 796f 7572  s asked for your
│ │ │ │ -0000b720: 2070 6173 7377 6f72 642e 2020 5468 6520   password.  The 
│ │ │ │ -0000b730: 7265 6173 6f6e 2069 7320 7468 6174 0a66  reason is that.f
│ │ │ │ -0000b740: 6f72 7761 7264 6564 2074 6963 6b65 7473  orwarded tickets
│ │ │ │ -0000b750: 206d 7573 7420 6265 2061 6371 7569 7265   must be acquire
│ │ │ │ -0000b760: 6420 7573 696e 6720 6120 666f 7277 6172  d using a forwar
│ │ │ │ -0000b770: 6461 626c 6520 7469 636b 6574 2067 7261  dable ticket gra
│ │ │ │ -0000b780: 6e74 696e 670a 7469 636b 6574 2c20 7768  nting.ticket, wh
│ │ │ │ -0000b790: 6963 6820 7761 7320 6e6f 7420 7072 6573  ich was not pres
│ │ │ │ -0000b7a0: 656e 742e 2020 4966 2079 6f75 206f 6674  ent.  If you oft
│ │ │ │ -0000b7b0: 656e 206e 6565 6420 746f 2067 6574 2066  en need to get f
│ │ │ │ -0000b7c0: 6f72 7761 7264 6564 0a74 6963 6b65 7473  orwarded.tickets
│ │ │ │ -0000b7d0: 2c20 796f 7520 6d61 7920 6163 7175 6972  , you may acquir
│ │ │ │ -0000b7e0: 6520 6120 666f 7277 6172 6461 626c 6520  e a forwardable 
│ │ │ │ -0000b7f0: 7469 636b 6574 2067 7261 6e74 696e 6720  ticket granting 
│ │ │ │ -0000b800: 7469 636b 6574 2066 726f 6d20 7468 650a  ticket from the.
│ │ │ │ -0000b810: 7374 6172 743a 0a0a 2020 2020 2024 2073  start:..     $ s
│ │ │ │ -0000b820: 6869 7368 6920 2d2d 666f 7277 6172 6461  hishi --forwarda
│ │ │ │ -0000b830: 626c 650a 2020 2020 2045 6e74 6572 2070  ble.     Enter p
│ │ │ │ -0000b840: 6173 7377 6f72 6420 666f 7220 606a 6173  assword for `jas
│ │ │ │ -0000b850: 404a 4f53 4546 5353 4f4e 2e4f 5247 273a  @JOSEFSSON.ORG':
│ │ │ │ -0000b860: 0a20 2020 2020 6a61 7340 4a4f 5345 4653  .     jas@JOSEFS
│ │ │ │ -0000b870: 534f 4e2e 4f52 473a 0a20 2020 2020 4175  SON.ORG:.     Au
│ │ │ │ -0000b880: 7468 7469 6d65 3a20 2020 2020 2020 4d6f  thtime:       Mo
│ │ │ │ -0000b890: 6e20 5365 7020 2038 2032 303a 3038 3a35  n Sep  8 20:08:5
│ │ │ │ -0000b8a0: 3320 3230 3033 0a20 2020 2020 456e 6474  3 2003.     Endt
│ │ │ │ -0000b8b0: 696d 653a 2020 2020 2020 2020 5475 6520  ime:        Tue 
│ │ │ │ -0000b8c0: 5365 7020 2039 2030 343a 3038 3a35 3320  Sep  9 04:08:53 
│ │ │ │ -0000b8d0: 3230 3033 0a20 2020 2020 5365 7276 6572  2003.     Server
│ │ │ │ -0000b8e0: 3a20 2020 2020 2020 2020 6b72 6274 6774  :         krbtgt
│ │ │ │ -0000b8f0: 2f4a 4f53 4546 5353 4f4e 2e4f 5247 206b  /JOSEFSSON.ORG k
│ │ │ │ -0000b900: 6579 2064 6573 332d 6362 632d 7368 6131  ey des3-cbc-sha1
│ │ │ │ -0000b910: 2d6b 6420 2831 3629 0a20 2020 2020 5469  -kd (16).     Ti
│ │ │ │ -0000b920: 636b 6574 206b 6579 3a20 2020 2020 6465  cket key:     de
│ │ │ │ -0000b930: 7333 2d63 6263 2d73 6861 312d 6b64 2028  s3-cbc-sha1-kd (
│ │ │ │ -0000b940: 3136 2920 7072 6f74 6563 7465 6420 6279  16) protected by
│ │ │ │ -0000b950: 2064 6573 332d 6362 632d 7368 6131 2d6b   des3-cbc-sha1-k
│ │ │ │ -0000b960: 6420 2831 3629 0a20 2020 2020 5469 636b  d (16).     Tick
│ │ │ │ -0000b970: 6574 2066 6c61 6773 3a20 2020 464f 5257  et flags:   FORW
│ │ │ │ -0000b980: 4152 4441 424c 4520 494e 4954 4941 4c20  ARDABLE INITIAL 
│ │ │ │ -0000b990: 2835 3134 290a 2020 2020 2024 0a0a 2020  (514).     $..  
│ │ │ │ -0000b9a0: 2054 6865 6e20 796f 7520 7368 6f75 6c64   Then you should
│ │ │ │ -0000b9b0: 2062 6520 6162 6c65 2074 6f20 6163 7175   be able to acqu
│ │ │ │ -0000b9c0: 6972 6520 666f 7277 6172 6465 6420 7469  ire forwarded ti
│ │ │ │ -0000b9d0: 636b 6574 7320 6261 7365 6420 6f6e 2074  ckets based on t
│ │ │ │ -0000b9e0: 6861 740a 7469 636b 6574 2067 7261 6e74  hat.ticket grant
│ │ │ │ -0000b9f0: 696e 6720 7469 636b 6574 2c20 6173 2066  ing ticket, as f
│ │ │ │ -0000ba00: 6f6c 6c6f 7773 3a0a 0a20 2020 2020 2420  ollows:..     $ 
│ │ │ │ -0000ba10: 7368 6973 6869 206a 6173 404a 4f53 4546  shishi jas@JOSEF
│ │ │ │ -0000ba20: 5353 4f4e 2e4f 5247 2068 6f73 742f 6c61  SSON.ORG host/la
│ │ │ │ -0000ba30: 7474 652e 6a6f 7365 6673 736f 6e2e 6f72  tte.josefsson.or
│ │ │ │ -0000ba40: 6720 2d2d 666f 7277 6172 6465 640a 2020  g --forwarded.  
│ │ │ │ -0000ba50: 2020 206c 6962 7368 6973 6869 3a20 7761     libshishi: wa
│ │ │ │ -0000ba60: 726e 696e 673a 204b 4443 2062 7567 3a20  rning: KDC bug: 
│ │ │ │ -0000ba70: 5265 706c 7920 656e 6372 7970 7465 6420  Reply encrypted 
│ │ │ │ -0000ba80: 7573 696e 6720 7772 6f6e 6720 6b65 792e  using wrong key.
│ │ │ │ -0000ba90: 0a20 2020 2020 6a61 7340 4a4f 5345 4653  .     jas@JOSEFS
│ │ │ │ -0000baa0: 534f 4e2e 4f52 473a 0a20 2020 2020 4175  SON.ORG:.     Au
│ │ │ │ -0000bab0: 7468 7469 6d65 3a20 2020 2020 2020 4d6f  thtime:       Mo
│ │ │ │ -0000bac0: 6e20 5365 7020 2038 2032 303a 3038 3a35  n Sep  8 20:08:5
│ │ │ │ -0000bad0: 3320 3230 3033 0a20 2020 2020 5374 6172  3 2003.     Star
│ │ │ │ -0000bae0: 7474 696d 653a 2020 2020 2020 4d6f 6e20  ttime:      Mon 
│ │ │ │ -0000baf0: 5365 7020 2038 2032 303a 3038 3a35 3720  Sep  8 20:08:57 
│ │ │ │ -0000bb00: 3230 3033 0a20 2020 2020 456e 6474 696d  2003.     Endtim
│ │ │ │ -0000bb10: 653a 2020 2020 2020 2020 5475 6520 5365  e:        Tue Se
│ │ │ │ -0000bb20: 7020 2039 2030 343a 3038 3a35 3320 3230  p  9 04:08:53 20
│ │ │ │ -0000bb30: 3033 0a20 2020 2020 5365 7276 6572 3a20  03.     Server: 
│ │ │ │ -0000bb40: 2020 2020 2020 2020 686f 7374 2f6c 6174          host/lat
│ │ │ │ -0000bb50: 7465 2e6a 6f73 6566 7373 6f6e 2e6f 7267  te.josefsson.org
│ │ │ │ -0000bb60: 206b 6579 2064 6573 332d 6362 632d 7368   key des3-cbc-sh
│ │ │ │ -0000bb70: 6131 2d6b 6420 2831 3629 0a20 2020 2020  a1-kd (16).     
│ │ │ │ -0000bb80: 5469 636b 6574 206b 6579 3a20 2020 2020  Ticket key:     
│ │ │ │ -0000bb90: 6465 7333 2d63 6263 2d73 6861 312d 6b64  des3-cbc-sha1-kd
│ │ │ │ -0000bba0: 2028 3136 2920 7072 6f74 6563 7465 6420   (16) protected 
│ │ │ │ -0000bbb0: 6279 2064 6573 332d 6362 632d 7368 6131  by des3-cbc-sha1
│ │ │ │ -0000bbc0: 2d6b 6420 2831 3629 0a20 2020 2020 5469  -kd (16).     Ti
│ │ │ │ -0000bbd0: 636b 6574 2066 6c61 6773 3a20 2020 464f  cket flags:   FO
│ │ │ │ -0000bbe0: 5257 4152 4445 4420 2834 290a 2020 2020  RWARDED (4).    
│ │ │ │ -0000bbf0: 2024 0a0a 1f0a 4669 6c65 3a20 7368 6973   $....File: shis
│ │ │ │ -0000bc00: 6869 2e69 6e66 6f2c 2020 4e6f 6465 3a20  hi.info,  Node: 
│ │ │ │ -0000bc10: 4164 6d69 6e69 7374 7261 7469 6f6e 204d  Administration M
│ │ │ │ -0000bc20: 616e 7561 6c2c 2020 4e65 7874 3a20 5265  anual,  Next: Re
│ │ │ │ -0000bc30: 6665 7265 6e63 6520 4d61 6e75 616c 2c20  ference Manual, 
│ │ │ │ -0000bc40: 2050 7265 763a 2055 7365 7220 4d61 6e75   Prev: User Manu
│ │ │ │ -0000bc50: 616c 2c20 2055 703a 2054 6f70 0a0a 3320  al,  Up: Top..3 
│ │ │ │ -0000bc60: 4164 6d69 6e69 7374 7261 7469 6f6e 204d  Administration M
│ │ │ │ -0000bc70: 616e 7561 6c0a 2a2a 2a2a 2a2a 2a2a 2a2a  anual.**********
│ │ │ │ -0000bc80: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a48  *************..H
│ │ │ │ -0000bc90: 6572 6520 796f 7520 7769 6c6c 206c 6561  ere you will lea
│ │ │ │ -0000bca0: 726e 2068 6f77 2074 6f20 7365 7420 7570  rn how to set up
│ │ │ │ -0000bcb0: 2c20 7275 6e20 616e 6420 6d61 696e 7461  , run and mainta
│ │ │ │ -0000bcc0: 696e 2074 6865 2053 6869 7368 6920 4b65  in the Shishi Ke
│ │ │ │ -0000bcd0: 7262 6572 6f73 0a73 6572 7665 722e 2020  rberos.server.  
│ │ │ │ -0000bce0: 4b65 7262 6572 6f73 2069 7320 696e 636f  Kerberos is inco
│ │ │ │ -0000bcf0: 6d70 6174 6962 6c65 2077 6974 6820 7468  mpatible with th
│ │ │ │ -0000bd00: 6520 7374 616e 6461 7264 2055 6e69 7820  e standard Unix 
│ │ │ │ -0000bd10: e280 982f 6574 632f 7061 7373 7764 e280  .../etc/passwd..
│ │ │ │ -0000bd20: 990a 7061 7373 776f 7264 2064 6174 6162  ..password datab
│ │ │ │ -0000bd30: 6173 6528 3129 2c20 7468 6572 6566 6f72  ase(1), therefor
│ │ │ │ -0000bd40: 6520 7468 6520 6669 7273 7420 7374 6570  e the first step
│ │ │ │ -0000bd50: 2077 696c 6c20 6265 2074 6f20 6372 6561   will be to crea
│ │ │ │ -0000bd60: 7465 2061 0a4b 6572 6265 726f 7320 7573  te a.Kerberos us
│ │ │ │ -0000bd70: 6572 2064 6174 6162 6173 652e 2020 5368  er database.  Sh
│ │ │ │ -0000bd80: 6973 6869 2773 2075 7365 7220 6461 7461  ishi's user data
│ │ │ │ -0000bd90: 6261 7365 2073 7973 7465 6d20 6973 2063  base system is c
│ │ │ │ -0000bda0: 616c 6c65 6420 5368 6973 612e 0a4f 6e63  alled Shisa..Onc
│ │ │ │ -0000bdb0: 6520 5368 6973 6120 6861 7320 6265 656e  e Shisa has been
│ │ │ │ -0000bdc0: 2063 6f6e 6669 6775 7265 642c 2079 6f75   configured, you
│ │ │ │ -0000bdd0: 2063 616e 2074 6865 6e20 7374 6172 7420   can then start 
│ │ │ │ -0000bde0: 7468 6520 7365 7276 6572 2061 6e64 2062  the server and b
│ │ │ │ -0000bdf0: 6567 696e 0a69 7373 7569 6e67 204b 6572  egin.issuing Ker
│ │ │ │ -0000be00: 6265 726f 7320 7469 636b 6574 7320 746f  beros tickets to
│ │ │ │ -0000be10: 2079 6f75 7220 7573 6572 732e 2020 5468   your users.  Th
│ │ │ │ -0000be20: 6520 5368 6973 6869 2073 6572 7665 7220  e Shishi server 
│ │ │ │ -0000be30: 6973 2063 616c 6c65 640a e280 9873 6869  is called....shi
│ │ │ │ -0000be40: 7368 6964 e280 992e 2020 4166 7465 7220  shid....  After 
│ │ │ │ -0000be50: 6765 7474 696e 6720 7468 6520 7365 7276  getting the serv
│ │ │ │ -0000be60: 6572 2075 7020 616e 6420 7275 6e6e 696e  er up and runnin
│ │ │ │ -0000be70: 672c 2077 6520 6469 7363 7573 7320 686f  g, we discuss ho
│ │ │ │ -0000be80: 7720 796f 750a 6361 6e20 7365 7420 7570  w you.can set up
│ │ │ │ -0000be90: 206d 756c 7469 706c 6520 4b65 7262 6572   multiple Kerber
│ │ │ │ -0000bea0: 6f73 2073 6572 7665 7273 2c20 746f 2069  os servers, to i
│ │ │ │ -0000beb0: 6e63 7265 6173 6520 6176 6169 6c61 6269  ncrease availabi
│ │ │ │ -0000bec0: 6c69 7479 206f 7220 6f66 6665 720a 6c6f  lity or offer.lo
│ │ │ │ -0000bed0: 6164 2d62 616c 616e 6369 6e67 2e20 2046  ad-balancing.  F
│ │ │ │ -0000bee0: 696e 616c 6c79 2c20 7765 2069 6e63 6c75  inally, we inclu
│ │ │ │ -0000bef0: 6465 2073 6f6d 6520 696e 666f 726d 6174  de some informat
│ │ │ │ -0000bf00: 696f 6e20 696e 7465 6e64 6564 2066 6f72  ion intended for
│ │ │ │ -0000bf10: 0a64 6576 656c 6f70 6572 732c 2074 6861  .developers, tha
│ │ │ │ -0000bf20: 7420 7769 6c6c 2065 6e61 626c 6520 796f  t will enable yo
│ │ │ │ -0000bf30: 7520 746f 2063 7573 746f 6d69 7a65 2053  u to customize S
│ │ │ │ -0000bf40: 6869 7361 2074 6f20 7573 6520 616e 2065  hisa to use an e
│ │ │ │ -0000bf50: 7874 6572 6e61 6c0a 7573 6572 2064 6174  xternal.user dat
│ │ │ │ -0000bf60: 6162 6173 652c 2073 7563 6820 6173 2061  abase, such as a
│ │ │ │ -0000bf70: 204c 4441 5020 7365 7276 6572 206f 7220   LDAP server or 
│ │ │ │ -0000bf80: 5351 4c20 6461 7461 6261 7365 2e0a 0a2a  SQL database...*
│ │ │ │ -0000bf90: 204d 656e 753a 0a0a 2a20 496e 7472 6f64   Menu:..* Introd
│ │ │ │ -0000bfa0: 7563 7469 6f6e 2074 6f20 5368 6973 613a  uction to Shisa:
│ │ │ │ -0000bfb0: 3a20 2020 2020 2020 4578 706c 616e 6174  :       Explanat
│ │ │ │ -0000bfc0: 696f 6e20 6f66 2074 6865 2053 6869 7368  ion of the Shish
│ │ │ │ -0000bfd0: 6920 7573 6572 2064 6174 6162 6173 652e  i user database.
│ │ │ │ -0000bfe0: 0a2a 2043 6f6e 6669 6775 7269 6e67 2053  .* Configuring S
│ │ │ │ -0000bff0: 6869 7361 3a3a 2020 2020 2020 2020 2020  hisa::          
│ │ │ │ -0000c000: 2044 6566 696e 6520 7468 6520 7573 6572   Define the user
│ │ │ │ -0000c010: 2064 6174 6162 6173 6520 696e 2053 6869   database in Shi
│ │ │ │ -0000c020: 7361 2e0a 2a20 5573 696e 6720 5368 6973  sa..* Using Shis
│ │ │ │ -0000c030: 613a 3a20 2020 2020 2020 2020 2020 2020  a::             
│ │ │ │ -0000c040: 2020 2020 486f 7720 746f 2061 6464 2072      How to add r
│ │ │ │ -0000c050: 6561 6c6d 7320 616e 6420 7072 696e 6369  ealms and princi
│ │ │ │ -0000c060: 7061 6c73 2074 6f20 6461 7461 6261 7365  pals to database
│ │ │ │ -0000c070: 2e0a 2a20 5374 6172 7469 6e67 2053 6869  ..* Starting Shi
│ │ │ │ -0000c080: 7368 6964 3a3a 2020 2020 2020 2020 2020  shid::          
│ │ │ │ -0000c090: 2020 4973 7375 6520 4b65 7262 6572 6f73    Issue Kerberos
│ │ │ │ -0000c0a0: 2074 6963 6b65 7473 2074 6f20 796f 7572   tickets to your
│ │ │ │ -0000c0b0: 2075 7365 7273 2e0a 2a20 436f 6e66 6967   users..* Config
│ │ │ │ -0000c0c0: 7572 696e 6720 444e 5320 666f 7220 4b44  uring DNS for KD
│ │ │ │ -0000c0d0: 433a 3a20 2020 2020 506c 6163 696e 6720  C::     Placing 
│ │ │ │ -0000c0e0: 7468 6520 4b44 4320 6164 6472 6573 7320  the KDC address 
│ │ │ │ -0000c0f0: 696e 2044 4e53 2069 7320 7573 6566 756c  in DNS is useful
│ │ │ │ -0000c100: 2e0a 2a20 4b65 7262 6572 6f73 2076 6961  ..* Kerberos via
│ │ │ │ -0000c110: 2054 4c53 3a3a 2020 2020 2020 2020 2020   TLS::          
│ │ │ │ -0000c120: 2020 486f 7720 746f 2073 6574 7570 2053    How to setup S
│ │ │ │ -0000c130: 6869 7368 6920 746f 2075 7365 2054 4c53  hishi to use TLS
│ │ │ │ -0000c140: 2e0a 2a20 4d75 6c74 6970 6c65 2073 6572  ..* Multiple ser
│ │ │ │ -0000c150: 7665 7273 3a3a 2020 2020 2020 2020 2020  vers::          
│ │ │ │ -0000c160: 2020 4869 6768 2061 7661 696c 6162 696c    High availabil
│ │ │ │ -0000c170: 6974 7920 616e 6420 6c6f 6164 2d62 616c  ity and load-bal
│ │ │ │ -0000c180: 616e 6369 6e67 2e0a 2a20 4465 7665 6c6f  ancing..* Develo
│ │ │ │ -0000c190: 7065 7220 696e 666f 726d 6174 696f 6e3a  per information:
│ │ │ │ -0000c1a0: 3a20 2020 2020 2020 5772 6974 696e 6720  :       Writing 
│ │ │ │ -0000c1b0: 796f 7572 206f 776e 2053 6869 7361 2064  your own Shisa d
│ │ │ │ -0000c1c0: 6174 6162 6173 6520 6261 636b 656e 642e  atabase backend.
│ │ │ │ -0000c1d0: 0a0a 2020 202d 2d2d 2d2d 2d2d 2d2d 2d20  ..   ---------- 
│ │ │ │ -0000c1e0: 466f 6f74 6e6f 7465 7320 2d2d 2d2d 2d2d  Footnotes ------
│ │ │ │ -0000c1f0: 2d2d 2d2d 0a0a 2020 2028 3129 2041 6e64  ----..   (1) And
│ │ │ │ -0000c200: 2062 6573 6964 6573 2c20 5368 6973 6869   besides, Shishi
│ │ │ │ -0000c210: 2069 7320 696e 7465 6e64 6564 2074 6f20   is intended to 
│ │ │ │ -0000c220: 776f 726b 206f 6e20 6e6f 6e2d 556e 6978  work on non-Unix
│ │ │ │ -0000c230: 2070 6c61 7466 6f72 6d73 2061 730a 7765   platforms as.we
│ │ │ │ -0000c240: 6c6c 2e0a 0a1f 0a46 696c 653a 2073 6869  ll.....File: shi
│ │ │ │ -0000c250: 7368 692e 696e 666f 2c20 204e 6f64 653a  shi.info,  Node:
│ │ │ │ -0000c260: 2049 6e74 726f 6475 6374 696f 6e20 746f   Introduction to
│ │ │ │ -0000c270: 2053 6869 7361 2c20 204e 6578 743a 2043   Shisa,  Next: C
│ │ │ │ -0000c280: 6f6e 6669 6775 7269 6e67 2053 6869 7361  onfiguring Shisa
│ │ │ │ -0000c290: 2c20 2055 703a 2041 646d 696e 6973 7472  ,  Up: Administr
│ │ │ │ -0000c2a0: 6174 696f 6e20 4d61 6e75 616c 0a0a 332e  ation Manual..3.
│ │ │ │ -0000c2b0: 3120 496e 7472 6f64 7563 7469 6f6e 2074  1 Introduction t
│ │ │ │ -0000c2c0: 6f20 5368 6973 610a 3d3d 3d3d 3d3d 3d3d  o Shisa.========
│ │ │ │ +0000add0: 3d3d 3d3d 3d3d 3d3d 0a0a 4175 7468 656e  ========..Authen
│ │ │ │ +0000ade0: 7469 6361 7469 6f6e 2066 6f72 7761 7264  tication forward
│ │ │ │ +0000adf0: 696e 6720 6973 2061 6e20 696e 7374 616e  ing is an instan
│ │ │ │ +0000ae00: 6365 206f 6620 6120 7072 6f78 7920 7768  ce of a proxy wh
│ │ │ │ +0000ae10: 6572 6520 7468 6520 7365 7276 6963 650a  ere the service.
│ │ │ │ +0000ae20: 7468 6174 2069 7320 6772 616e 7465 6420  that is granted 
│ │ │ │ +0000ae30: 6973 2063 6f6d 706c 6574 6520 7573 6520  is complete use 
│ │ │ │ +0000ae40: 6f66 2074 6865 2063 6c69 656e 7427 7320  of the client's 
│ │ │ │ +0000ae50: 6964 656e 7469 7479 2e20 2041 6e20 6578  identity.  An ex
│ │ │ │ +0000ae60: 616d 706c 650a 7768 6572 6520 6974 206d  ample.where it m
│ │ │ │ +0000ae70: 6967 6874 2062 6520 7573 6564 2069 7320  ight be used is 
│ │ │ │ +0000ae80: 7768 656e 2061 2075 7365 7220 6c6f 6773  when a user logs
│ │ │ │ +0000ae90: 2069 6e20 746f 2061 2072 656d 6f74 6520   in to a remote 
│ │ │ │ +0000aea0: 7379 7374 656d 2061 6e64 0a77 616e 7473  system and.wants
│ │ │ │ +0000aeb0: 2061 7574 6865 6e74 6963 6174 696f 6e20   authentication 
│ │ │ │ +0000aec0: 746f 2077 6f72 6b20 6672 6f6d 2074 6861  to work from tha
│ │ │ │ +0000aed0: 7420 7379 7374 656d 2061 7320 6966 2074  t system as if t
│ │ │ │ +0000aee0: 6865 206c 6f67 696e 2077 6572 650a 6c6f  he login were.lo
│ │ │ │ +0000aef0: 6361 6c2e 0a0a 2020 2054 6865 2046 4f52  cal...   The FOR
│ │ │ │ +0000af00: 5741 5244 4142 4c45 2066 6c61 6720 696e  WARDABLE flag in
│ │ │ │ +0000af10: 2061 2074 6963 6b65 7420 6973 206e 6f72   a ticket is nor
│ │ │ │ +0000af20: 6d61 6c6c 7920 6f6e 6c79 2069 6e74 6572  mally only inter
│ │ │ │ +0000af30: 7072 6574 6564 2062 7920 7468 650a 7469  preted by the.ti
│ │ │ │ +0000af40: 636b 6574 2d67 7261 6e74 696e 6720 7365  cket-granting se
│ │ │ │ +0000af50: 7276 6963 652e 2020 4974 2063 616e 2062  rvice.  It can b
│ │ │ │ +0000af60: 6520 6967 6e6f 7265 6420 6279 2061 7070  e ignored by app
│ │ │ │ +0000af70: 6c69 6361 7469 6f6e 2073 6572 7665 7273  lication servers
│ │ │ │ +0000af80: 2e20 2054 6865 0a46 4f52 5741 5244 4142  .  The.FORWARDAB
│ │ │ │ +0000af90: 4c45 2066 6c61 6720 6861 7320 616e 2069  LE flag has an i
│ │ │ │ +0000afa0: 6e74 6572 7072 6574 6174 696f 6e20 7369  nterpretation si
│ │ │ │ +0000afb0: 6d69 6c61 7220 746f 2074 6861 7420 6f66  milar to that of
│ │ │ │ +0000afc0: 2074 6865 2050 524f 5849 4142 4c45 0a66   the PROXIABLE.f
│ │ │ │ +0000afd0: 6c61 672c 2065 7863 6570 7420 7469 636b  lag, except tick
│ │ │ │ +0000afe0: 6574 2d67 7261 6e74 696e 6720 7469 636b  et-granting tick
│ │ │ │ +0000aff0: 6574 7320 6d61 7920 616c 736f 2062 6520  ets may also be 
│ │ │ │ +0000b000: 6973 7375 6564 2077 6974 6820 6469 6666  issued with diff
│ │ │ │ +0000b010: 6572 656e 740a 6e65 7477 6f72 6b20 6164  erent.network ad
│ │ │ │ +0000b020: 6472 6573 7365 732e 2020 5468 6973 2066  dresses.  This f
│ │ │ │ +0000b030: 6c61 6720 6973 2072 6573 6574 2062 7920  lag is reset by 
│ │ │ │ +0000b040: 6465 6661 756c 742c 2062 7574 2075 7365  default, but use
│ │ │ │ +0000b050: 7273 204d 4159 2072 6571 7565 7374 0a74  rs MAY request.t
│ │ │ │ +0000b060: 6861 7420 6974 2062 6520 7365 7420 6279  hat it be set by
│ │ │ │ +0000b070: 2073 6574 7469 6e67 2074 6865 2046 4f52   setting the FOR
│ │ │ │ +0000b080: 5741 5244 4142 4c45 206f 7074 696f 6e20  WARDABLE option 
│ │ │ │ +0000b090: 696e 2074 6865 2041 5320 7265 7175 6573  in the AS reques
│ │ │ │ +0000b0a0: 7420 7768 656e 0a74 6865 7920 7265 7175  t when.they requ
│ │ │ │ +0000b0b0: 6573 7420 7468 6569 7220 696e 6974 6961  est their initia
│ │ │ │ +0000b0c0: 6c20 7469 636b 6574 2d67 7261 6e74 696e  l ticket-grantin
│ │ │ │ +0000b0d0: 6720 7469 636b 6574 2e0a 0a20 2020 5468  g ticket...   Th
│ │ │ │ +0000b0e0: 6973 2066 6c61 6720 616c 6c6f 7773 2066  is flag allows f
│ │ │ │ +0000b0f0: 6f72 2061 7574 6865 6e74 6963 6174 696f  or authenticatio
│ │ │ │ +0000b100: 6e20 666f 7277 6172 6469 6e67 2077 6974  n forwarding wit
│ │ │ │ +0000b110: 686f 7574 2072 6571 7569 7269 6e67 2074  hout requiring t
│ │ │ │ +0000b120: 6865 0a75 7365 7220 746f 2065 6e74 6572  he.user to enter
│ │ │ │ +0000b130: 2061 2070 6173 7377 6f72 6420 6167 6169   a password agai
│ │ │ │ +0000b140: 6e2e 2020 4966 2074 6865 2066 6c61 6720  n.  If the flag 
│ │ │ │ +0000b150: 6973 206e 6f74 2073 6574 2c20 7468 656e  is not set, then
│ │ │ │ +0000b160: 0a61 7574 6865 6e74 6963 6174 696f 6e20  .authentication 
│ │ │ │ +0000b170: 666f 7277 6172 6469 6e67 2069 7320 6e6f  forwarding is no
│ │ │ │ +0000b180: 7420 7065 726d 6974 7465 642c 2062 7574  t permitted, but
│ │ │ │ +0000b190: 2074 6865 2073 616d 6520 7265 7375 6c74   the same result
│ │ │ │ +0000b1a0: 2063 616e 0a73 7469 6c6c 2062 6520 6163   can.still be ac
│ │ │ │ +0000b1b0: 6869 6576 6564 2069 6620 7468 6520 7573  hieved if the us
│ │ │ │ +0000b1c0: 6572 2065 6e67 6167 6573 2069 6e20 7468  er engages in th
│ │ │ │ +0000b1d0: 6520 4153 2065 7863 6861 6e67 6520 7370  e AS exchange sp
│ │ │ │ +0000b1e0: 6563 6966 7969 6e67 2074 6865 0a72 6571  ecifying the.req
│ │ │ │ +0000b1f0: 7565 7374 6564 206e 6574 776f 726b 2061  uested network a
│ │ │ │ +0000b200: 6464 7265 7373 6573 2061 6e64 2073 7570  ddresses and sup
│ │ │ │ +0000b210: 706c 6965 7320 6120 7061 7373 776f 7264  plies a password
│ │ │ │ +0000b220: 2e0a 0a20 2020 5468 6520 464f 5257 4152  ...   The FORWAR
│ │ │ │ +0000b230: 4445 4420 666c 6167 2069 7320 7365 7420  DED flag is set 
│ │ │ │ +0000b240: 6279 2074 6865 2054 4753 2077 6865 6e20  by the TGS when 
│ │ │ │ +0000b250: 6120 636c 6965 6e74 2070 7265 7365 6e74  a client present
│ │ │ │ +0000b260: 7320 6120 7469 636b 6574 0a77 6974 6820  s a ticket.with 
│ │ │ │ +0000b270: 7468 6520 464f 5257 4152 4441 424c 4520  the FORWARDABLE 
│ │ │ │ +0000b280: 666c 6167 2073 6574 2061 6e64 2072 6571  flag set and req
│ │ │ │ +0000b290: 7565 7374 7320 6120 666f 7277 6172 6465  uests a forwarde
│ │ │ │ +0000b2a0: 6420 7469 636b 6574 2062 790a 7370 6563  d ticket by.spec
│ │ │ │ +0000b2b0: 6966 7969 6e67 2074 6865 2046 4f52 5741  ifying the FORWA
│ │ │ │ +0000b2c0: 5244 4544 204b 4443 206f 7074 696f 6e20  RDED KDC option 
│ │ │ │ +0000b2d0: 616e 6420 7375 7070 6c79 696e 6720 6120  and supplying a 
│ │ │ │ +0000b2e0: 7365 7420 6f66 2061 6464 7265 7373 6573  set of addresses
│ │ │ │ +0000b2f0: 2066 6f72 0a74 6865 206e 6577 2074 6963   for.the new tic
│ │ │ │ +0000b300: 6b65 742e 2020 4974 2069 7320 616c 736f  ket.  It is also
│ │ │ │ +0000b310: 2073 6574 2069 6e20 616c 6c20 7469 636b   set in all tick
│ │ │ │ +0000b320: 6574 7320 6973 7375 6564 2062 6173 6564  ets issued based
│ │ │ │ +0000b330: 206f 6e20 7469 636b 6574 730a 7769 7468   on tickets.with
│ │ │ │ +0000b340: 2074 6865 2046 4f52 5741 5244 4544 2066   the FORWARDED f
│ │ │ │ +0000b350: 6c61 6720 7365 742e 2020 4170 706c 6963  lag set.  Applic
│ │ │ │ +0000b360: 6174 696f 6e20 7365 7276 6572 7320 6d61  ation servers ma
│ │ │ │ +0000b370: 7920 6368 6f6f 7365 2074 6f20 7072 6f63  y choose to proc
│ │ │ │ +0000b380: 6573 730a 464f 5257 4152 4445 4420 7469  ess.FORWARDED ti
│ │ │ │ +0000b390: 636b 6574 7320 6469 6666 6572 656e 746c  ckets differentl
│ │ │ │ +0000b3a0: 7920 7468 616e 206e 6f6e 2d46 4f52 5741  y than non-FORWA
│ │ │ │ +0000b3b0: 5244 4544 2074 6963 6b65 7473 2e0a 0a20  RDED tickets... 
│ │ │ │ +0000b3c0: 2020 4966 2061 6464 7265 7373 6c65 7373    If addressless
│ │ │ │ +0000b3d0: 2074 6963 6b65 7473 2061 7265 2066 6f72   tickets are for
│ │ │ │ +0000b3e0: 7761 7264 6564 2066 726f 6d20 6f6e 6520  warded from one 
│ │ │ │ +0000b3f0: 7379 7374 656d 2074 6f20 616e 6f74 6865  system to anothe
│ │ │ │ +0000b400: 722c 0a63 6c69 656e 7473 2053 484f 554c  r,.clients SHOUL
│ │ │ │ +0000b410: 4420 7374 696c 6c20 7573 6520 7468 6973  D still use this
│ │ │ │ +0000b420: 206f 7074 696f 6e20 746f 206f 6274 6169   option to obtai
│ │ │ │ +0000b430: 6e20 6120 6e65 7720 5447 5420 696e 206f  n a new TGT in o
│ │ │ │ +0000b440: 7264 6572 2074 6f0a 6861 7665 2064 6966  rder to.have dif
│ │ │ │ +0000b450: 6665 7265 6e74 2073 6573 7369 6f6e 206b  ferent session k
│ │ │ │ +0000b460: 6579 7320 6f6e 2074 6865 2064 6966 6665  eys on the diffe
│ │ │ │ +0000b470: 7265 6e74 2073 7973 7465 6d73 2e0a 0a20  rent systems... 
│ │ │ │ +0000b480: 2020 4865 7265 2069 7320 686f 7720 796f    Here is how yo
│ │ │ │ +0000b490: 7520 776f 756c 6420 6163 7175 6972 6520  u would acquire 
│ │ │ │ +0000b4a0: 6120 464f 5257 4152 4445 4420 7469 636b  a FORWARDED tick
│ │ │ │ +0000b4b0: 6574 2066 6f72 2074 6865 2073 6572 7669  et for the servi
│ │ │ │ +0000b4c0: 6365 0ae2 8098 686f 7374 2f6c 6174 7465  ce....host/latte
│ │ │ │ +0000b4d0: 2e6a 6f73 6566 7373 6f6e 2e6f 7267 e280  .josefsson.org..
│ │ │ │ +0000b4e0: 993a 0a0a 2020 2020 2024 2073 6869 7368  .:..     $ shish
│ │ │ │ +0000b4f0: 6920 6a61 7340 4a4f 5345 4653 534f 4e2e  i jas@JOSEFSSON.
│ │ │ │ +0000b500: 4f52 4720 686f 7374 2f6c 6174 7465 2e6a  ORG host/latte.j
│ │ │ │ +0000b510: 6f73 6566 7373 6f6e 2e6f 7267 202d 2d66  osefsson.org --f
│ │ │ │ +0000b520: 6f72 7761 7264 6564 0a20 2020 2020 456e  orwarded.     En
│ │ │ │ +0000b530: 7465 7220 7061 7373 776f 7264 2066 6f72  ter password for
│ │ │ │ +0000b540: 2060 6a61 7340 4a4f 5345 4653 534f 4e2e   `jas@JOSEFSSON.
│ │ │ │ +0000b550: 4f52 4727 3a0a 2020 2020 206c 6962 7368  ORG':.     libsh
│ │ │ │ +0000b560: 6973 6869 3a20 7761 726e 696e 673a 204b  ishi: warning: K
│ │ │ │ +0000b570: 4443 2062 7567 3a20 5265 706c 7920 656e  DC bug: Reply en
│ │ │ │ +0000b580: 6372 7970 7465 6420 7573 696e 6720 7772  crypted using wr
│ │ │ │ +0000b590: 6f6e 6720 6b65 792e 0a20 2020 2020 6a61  ong key..     ja
│ │ │ │ +0000b5a0: 7340 4a4f 5345 4653 534f 4e2e 4f52 473a  s@JOSEFSSON.ORG:
│ │ │ │ +0000b5b0: 0a20 2020 2020 4175 7468 7469 6d65 3a20  .     Authtime: 
│ │ │ │ +0000b5c0: 2020 2020 2020 4d6f 6e20 5365 7020 2038        Mon Sep  8
│ │ │ │ +0000b5d0: 2032 303a 3037 3a31 3120 3230 3033 0a20   20:07:11 2003. 
│ │ │ │ +0000b5e0: 2020 2020 5374 6172 7474 696d 653a 2020      Starttime:  
│ │ │ │ +0000b5f0: 2020 2020 4d6f 6e20 5365 7020 2038 2032      Mon Sep  8 2
│ │ │ │ +0000b600: 303a 3037 3a31 3220 3230 3033 0a20 2020  0:07:12 2003.   
│ │ │ │ +0000b610: 2020 456e 6474 696d 653a 2020 2020 2020    Endtime:      
│ │ │ │ +0000b620: 2020 5475 6520 5365 7020 2039 2030 343a    Tue Sep  9 04:
│ │ │ │ +0000b630: 3037 3a31 3120 3230 3033 0a20 2020 2020  07:11 2003.     
│ │ │ │ +0000b640: 5365 7276 6572 3a20 2020 2020 2020 2020  Server:         
│ │ │ │ +0000b650: 686f 7374 2f6c 6174 7465 2e6a 6f73 6566  host/latte.josef
│ │ │ │ +0000b660: 7373 6f6e 2e6f 7267 206b 6579 2064 6573  sson.org key des
│ │ │ │ +0000b670: 332d 6362 632d 7368 6131 2d6b 6420 2831  3-cbc-sha1-kd (1
│ │ │ │ +0000b680: 3629 0a20 2020 2020 5469 636b 6574 206b  6).     Ticket k
│ │ │ │ +0000b690: 6579 3a20 2020 2020 6465 7333 2d63 6263  ey:     des3-cbc
│ │ │ │ +0000b6a0: 2d73 6861 312d 6b64 2028 3136 2920 7072  -sha1-kd (16) pr
│ │ │ │ +0000b6b0: 6f74 6563 7465 6420 6279 2064 6573 332d  otected by des3-
│ │ │ │ +0000b6c0: 6362 632d 7368 6131 2d6b 6420 2831 3629  cbc-sha1-kd (16)
│ │ │ │ +0000b6d0: 0a20 2020 2020 5469 636b 6574 2066 6c61  .     Ticket fla
│ │ │ │ +0000b6e0: 6773 3a20 2020 464f 5257 4152 4445 4420  gs:   FORWARDED 
│ │ │ │ +0000b6f0: 2834 290a 2020 2020 2024 0a0a 2020 2041  (4).     $..   A
│ │ │ │ +0000b700: 7320 796f 7520 6e6f 7469 6365 642c 2074  s you noticed, t
│ │ │ │ +0000b710: 6869 7320 6173 6b65 6420 666f 7220 796f  his asked for yo
│ │ │ │ +0000b720: 7572 2070 6173 7377 6f72 642e 2020 5468  ur password.  Th
│ │ │ │ +0000b730: 6520 7265 6173 6f6e 2069 7320 7468 6174  e reason is that
│ │ │ │ +0000b740: 0a66 6f72 7761 7264 6564 2074 6963 6b65  .forwarded ticke
│ │ │ │ +0000b750: 7473 206d 7573 7420 6265 2061 6371 7569  ts must be acqui
│ │ │ │ +0000b760: 7265 6420 7573 696e 6720 6120 666f 7277  red using a forw
│ │ │ │ +0000b770: 6172 6461 626c 6520 7469 636b 6574 2067  ardable ticket g
│ │ │ │ +0000b780: 7261 6e74 696e 670a 7469 636b 6574 2c20  ranting.ticket, 
│ │ │ │ +0000b790: 7768 6963 6820 7761 7320 6e6f 7420 7072  which was not pr
│ │ │ │ +0000b7a0: 6573 656e 742e 2020 4966 2079 6f75 206f  esent.  If you o
│ │ │ │ +0000b7b0: 6674 656e 206e 6565 6420 746f 2067 6574  ften need to get
│ │ │ │ +0000b7c0: 2066 6f72 7761 7264 6564 0a74 6963 6b65   forwarded.ticke
│ │ │ │ +0000b7d0: 7473 2c20 796f 7520 6d61 7920 6163 7175  ts, you may acqu
│ │ │ │ +0000b7e0: 6972 6520 6120 666f 7277 6172 6461 626c  ire a forwardabl
│ │ │ │ +0000b7f0: 6520 7469 636b 6574 2067 7261 6e74 696e  e ticket grantin
│ │ │ │ +0000b800: 6720 7469 636b 6574 2066 726f 6d20 7468  g ticket from th
│ │ │ │ +0000b810: 650a 7374 6172 743a 0a0a 2020 2020 2024  e.start:..     $
│ │ │ │ +0000b820: 2073 6869 7368 6920 2d2d 666f 7277 6172   shishi --forwar
│ │ │ │ +0000b830: 6461 626c 650a 2020 2020 2045 6e74 6572  dable.     Enter
│ │ │ │ +0000b840: 2070 6173 7377 6f72 6420 666f 7220 606a   password for `j
│ │ │ │ +0000b850: 6173 404a 4f53 4546 5353 4f4e 2e4f 5247  as@JOSEFSSON.ORG
│ │ │ │ +0000b860: 273a 0a20 2020 2020 6a61 7340 4a4f 5345  ':.     jas@JOSE
│ │ │ │ +0000b870: 4653 534f 4e2e 4f52 473a 0a20 2020 2020  FSSON.ORG:.     
│ │ │ │ +0000b880: 4175 7468 7469 6d65 3a20 2020 2020 2020  Authtime:       
│ │ │ │ +0000b890: 4d6f 6e20 5365 7020 2038 2032 303a 3038  Mon Sep  8 20:08
│ │ │ │ +0000b8a0: 3a35 3320 3230 3033 0a20 2020 2020 456e  :53 2003.     En
│ │ │ │ +0000b8b0: 6474 696d 653a 2020 2020 2020 2020 5475  dtime:        Tu
│ │ │ │ +0000b8c0: 6520 5365 7020 2039 2030 343a 3038 3a35  e Sep  9 04:08:5
│ │ │ │ +0000b8d0: 3320 3230 3033 0a20 2020 2020 5365 7276  3 2003.     Serv
│ │ │ │ +0000b8e0: 6572 3a20 2020 2020 2020 2020 6b72 6274  er:         krbt
│ │ │ │ +0000b8f0: 6774 2f4a 4f53 4546 5353 4f4e 2e4f 5247  gt/JOSEFSSON.ORG
│ │ │ │ +0000b900: 206b 6579 2064 6573 332d 6362 632d 7368   key des3-cbc-sh
│ │ │ │ +0000b910: 6131 2d6b 6420 2831 3629 0a20 2020 2020  a1-kd (16).     
│ │ │ │ +0000b920: 5469 636b 6574 206b 6579 3a20 2020 2020  Ticket key:     
│ │ │ │ +0000b930: 6465 7333 2d63 6263 2d73 6861 312d 6b64  des3-cbc-sha1-kd
│ │ │ │ +0000b940: 2028 3136 2920 7072 6f74 6563 7465 6420   (16) protected 
│ │ │ │ +0000b950: 6279 2064 6573 332d 6362 632d 7368 6131  by des3-cbc-sha1
│ │ │ │ +0000b960: 2d6b 6420 2831 3629 0a20 2020 2020 5469  -kd (16).     Ti
│ │ │ │ +0000b970: 636b 6574 2066 6c61 6773 3a20 2020 464f  cket flags:   FO
│ │ │ │ +0000b980: 5257 4152 4441 424c 4520 494e 4954 4941  RWARDABLE INITIA
│ │ │ │ +0000b990: 4c20 2835 3134 290a 2020 2020 2024 0a0a  L (514).     $..
│ │ │ │ +0000b9a0: 2020 2054 6865 6e20 796f 7520 7368 6f75     Then you shou
│ │ │ │ +0000b9b0: 6c64 2062 6520 6162 6c65 2074 6f20 6163  ld be able to ac
│ │ │ │ +0000b9c0: 7175 6972 6520 666f 7277 6172 6465 6420  quire forwarded 
│ │ │ │ +0000b9d0: 7469 636b 6574 7320 6261 7365 6420 6f6e  tickets based on
│ │ │ │ +0000b9e0: 2074 6861 740a 7469 636b 6574 2067 7261   that.ticket gra
│ │ │ │ +0000b9f0: 6e74 696e 6720 7469 636b 6574 2c20 6173  nting ticket, as
│ │ │ │ +0000ba00: 2066 6f6c 6c6f 7773 3a0a 0a20 2020 2020   follows:..     
│ │ │ │ +0000ba10: 2420 7368 6973 6869 206a 6173 404a 4f53  $ shishi jas@JOS
│ │ │ │ +0000ba20: 4546 5353 4f4e 2e4f 5247 2068 6f73 742f  EFSSON.ORG host/
│ │ │ │ +0000ba30: 6c61 7474 652e 6a6f 7365 6673 736f 6e2e  latte.josefsson.
│ │ │ │ +0000ba40: 6f72 6720 2d2d 666f 7277 6172 6465 640a  org --forwarded.
│ │ │ │ +0000ba50: 2020 2020 206c 6962 7368 6973 6869 3a20       libshishi: 
│ │ │ │ +0000ba60: 7761 726e 696e 673a 204b 4443 2062 7567  warning: KDC bug
│ │ │ │ +0000ba70: 3a20 5265 706c 7920 656e 6372 7970 7465  : Reply encrypte
│ │ │ │ +0000ba80: 6420 7573 696e 6720 7772 6f6e 6720 6b65  d using wrong ke
│ │ │ │ +0000ba90: 792e 0a20 2020 2020 6a61 7340 4a4f 5345  y..     jas@JOSE
│ │ │ │ +0000baa0: 4653 534f 4e2e 4f52 473a 0a20 2020 2020  FSSON.ORG:.     
│ │ │ │ +0000bab0: 4175 7468 7469 6d65 3a20 2020 2020 2020  Authtime:       
│ │ │ │ +0000bac0: 4d6f 6e20 5365 7020 2038 2032 303a 3038  Mon Sep  8 20:08
│ │ │ │ +0000bad0: 3a35 3320 3230 3033 0a20 2020 2020 5374  :53 2003.     St
│ │ │ │ +0000bae0: 6172 7474 696d 653a 2020 2020 2020 4d6f  arttime:      Mo
│ │ │ │ +0000baf0: 6e20 5365 7020 2038 2032 303a 3038 3a35  n Sep  8 20:08:5
│ │ │ │ +0000bb00: 3720 3230 3033 0a20 2020 2020 456e 6474  7 2003.     Endt
│ │ │ │ +0000bb10: 696d 653a 2020 2020 2020 2020 5475 6520  ime:        Tue 
│ │ │ │ +0000bb20: 5365 7020 2039 2030 343a 3038 3a35 3320  Sep  9 04:08:53 
│ │ │ │ +0000bb30: 3230 3033 0a20 2020 2020 5365 7276 6572  2003.     Server
│ │ │ │ +0000bb40: 3a20 2020 2020 2020 2020 686f 7374 2f6c  :         host/l
│ │ │ │ +0000bb50: 6174 7465 2e6a 6f73 6566 7373 6f6e 2e6f  atte.josefsson.o
│ │ │ │ +0000bb60: 7267 206b 6579 2064 6573 332d 6362 632d  rg key des3-cbc-
│ │ │ │ +0000bb70: 7368 6131 2d6b 6420 2831 3629 0a20 2020  sha1-kd (16).   
│ │ │ │ +0000bb80: 2020 5469 636b 6574 206b 6579 3a20 2020    Ticket key:   
│ │ │ │ +0000bb90: 2020 6465 7333 2d63 6263 2d73 6861 312d    des3-cbc-sha1-
│ │ │ │ +0000bba0: 6b64 2028 3136 2920 7072 6f74 6563 7465  kd (16) protecte
│ │ │ │ +0000bbb0: 6420 6279 2064 6573 332d 6362 632d 7368  d by des3-cbc-sh
│ │ │ │ +0000bbc0: 6131 2d6b 6420 2831 3629 0a20 2020 2020  a1-kd (16).     
│ │ │ │ +0000bbd0: 5469 636b 6574 2066 6c61 6773 3a20 2020  Ticket flags:   
│ │ │ │ +0000bbe0: 464f 5257 4152 4445 4420 2834 290a 2020  FORWARDED (4).  
│ │ │ │ +0000bbf0: 2020 2024 0a0a 1f0a 4669 6c65 3a20 7368     $....File: sh
│ │ │ │ +0000bc00: 6973 6869 2e69 6e66 6f2c 2020 4e6f 6465  ishi.info,  Node
│ │ │ │ +0000bc10: 3a20 4164 6d69 6e69 7374 7261 7469 6f6e  : Administration
│ │ │ │ +0000bc20: 204d 616e 7561 6c2c 2020 4e65 7874 3a20   Manual,  Next: 
│ │ │ │ +0000bc30: 5265 6665 7265 6e63 6520 4d61 6e75 616c  Reference Manual
│ │ │ │ +0000bc40: 2c20 2050 7265 763a 2055 7365 7220 4d61  ,  Prev: User Ma
│ │ │ │ +0000bc50: 6e75 616c 2c20 2055 703a 2054 6f70 0a0a  nual,  Up: Top..
│ │ │ │ +0000bc60: 3320 4164 6d69 6e69 7374 7261 7469 6f6e  3 Administration
│ │ │ │ +0000bc70: 204d 616e 7561 6c0a 2a2a 2a2a 2a2a 2a2a   Manual.********
│ │ │ │ +0000bc80: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a  ***************.
│ │ │ │ +0000bc90: 0a48 6572 6520 796f 7520 7769 6c6c 206c  .Here you will l
│ │ │ │ +0000bca0: 6561 726e 2068 6f77 2074 6f20 7365 7420  earn how to set 
│ │ │ │ +0000bcb0: 7570 2c20 7275 6e20 616e 6420 6d61 696e  up, run and main
│ │ │ │ +0000bcc0: 7461 696e 2074 6865 2053 6869 7368 6920  tain the Shishi 
│ │ │ │ +0000bcd0: 4b65 7262 6572 6f73 0a73 6572 7665 722e  Kerberos.server.
│ │ │ │ +0000bce0: 2020 4b65 7262 6572 6f73 2069 7320 696e    Kerberos is in
│ │ │ │ +0000bcf0: 636f 6d70 6174 6962 6c65 2077 6974 6820  compatible with 
│ │ │ │ +0000bd00: 7468 6520 7374 616e 6461 7264 2055 6e69  the standard Uni
│ │ │ │ +0000bd10: 7820 e280 982f 6574 632f 7061 7373 7764  x .../etc/passwd
│ │ │ │ +0000bd20: e280 990a 7061 7373 776f 7264 2064 6174  ....password dat
│ │ │ │ +0000bd30: 6162 6173 6528 3129 2c20 7468 6572 6566  abase(1), theref
│ │ │ │ +0000bd40: 6f72 6520 7468 6520 6669 7273 7420 7374  ore the first st
│ │ │ │ +0000bd50: 6570 2077 696c 6c20 6265 2074 6f20 6372  ep will be to cr
│ │ │ │ +0000bd60: 6561 7465 2061 0a4b 6572 6265 726f 7320  eate a.Kerberos 
│ │ │ │ +0000bd70: 7573 6572 2064 6174 6162 6173 652e 2020  user database.  
│ │ │ │ +0000bd80: 5368 6973 6869 2773 2075 7365 7220 6461  Shishi's user da
│ │ │ │ +0000bd90: 7461 6261 7365 2073 7973 7465 6d20 6973  tabase system is
│ │ │ │ +0000bda0: 2063 616c 6c65 6420 5368 6973 612e 0a4f   called Shisa..O
│ │ │ │ +0000bdb0: 6e63 6520 5368 6973 6120 6861 7320 6265  nce Shisa has be
│ │ │ │ +0000bdc0: 656e 2063 6f6e 6669 6775 7265 642c 2079  en configured, y
│ │ │ │ +0000bdd0: 6f75 2063 616e 2074 6865 6e20 7374 6172  ou can then star
│ │ │ │ +0000bde0: 7420 7468 6520 7365 7276 6572 2061 6e64  t the server and
│ │ │ │ +0000bdf0: 2062 6567 696e 0a69 7373 7569 6e67 204b   begin.issuing K
│ │ │ │ +0000be00: 6572 6265 726f 7320 7469 636b 6574 7320  erberos tickets 
│ │ │ │ +0000be10: 746f 2079 6f75 7220 7573 6572 732e 2020  to your users.  
│ │ │ │ +0000be20: 5468 6520 5368 6973 6869 2073 6572 7665  The Shishi serve
│ │ │ │ +0000be30: 7220 6973 2063 616c 6c65 640a e280 9873  r is called....s
│ │ │ │ +0000be40: 6869 7368 6964 e280 992e 2020 4166 7465  hishid....  Afte
│ │ │ │ +0000be50: 7220 6765 7474 696e 6720 7468 6520 7365  r getting the se
│ │ │ │ +0000be60: 7276 6572 2075 7020 616e 6420 7275 6e6e  rver up and runn
│ │ │ │ +0000be70: 696e 672c 2077 6520 6469 7363 7573 7320  ing, we discuss 
│ │ │ │ +0000be80: 686f 7720 796f 750a 6361 6e20 7365 7420  how you.can set 
│ │ │ │ +0000be90: 7570 206d 756c 7469 706c 6520 4b65 7262  up multiple Kerb
│ │ │ │ +0000bea0: 6572 6f73 2073 6572 7665 7273 2c20 746f  eros servers, to
│ │ │ │ +0000beb0: 2069 6e63 7265 6173 6520 6176 6169 6c61   increase availa
│ │ │ │ +0000bec0: 6269 6c69 7479 206f 7220 6f66 6665 720a  bility or offer.
│ │ │ │ +0000bed0: 6c6f 6164 2d62 616c 616e 6369 6e67 2e20  load-balancing. 
│ │ │ │ +0000bee0: 2046 696e 616c 6c79 2c20 7765 2069 6e63   Finally, we inc
│ │ │ │ +0000bef0: 6c75 6465 2073 6f6d 6520 696e 666f 726d  lude some inform
│ │ │ │ +0000bf00: 6174 696f 6e20 696e 7465 6e64 6564 2066  ation intended f
│ │ │ │ +0000bf10: 6f72 0a64 6576 656c 6f70 6572 732c 2074  or.developers, t
│ │ │ │ +0000bf20: 6861 7420 7769 6c6c 2065 6e61 626c 6520  hat will enable 
│ │ │ │ +0000bf30: 796f 7520 746f 2063 7573 746f 6d69 7a65  you to customize
│ │ │ │ +0000bf40: 2053 6869 7361 2074 6f20 7573 6520 616e   Shisa to use an
│ │ │ │ +0000bf50: 2065 7874 6572 6e61 6c0a 7573 6572 2064   external.user d
│ │ │ │ +0000bf60: 6174 6162 6173 652c 2073 7563 6820 6173  atabase, such as
│ │ │ │ +0000bf70: 2061 204c 4441 5020 7365 7276 6572 206f   a LDAP server o
│ │ │ │ +0000bf80: 7220 5351 4c20 6461 7461 6261 7365 2e0a  r SQL database..
│ │ │ │ +0000bf90: 0a2a 204d 656e 753a 0a0a 2a20 496e 7472  .* Menu:..* Intr
│ │ │ │ +0000bfa0: 6f64 7563 7469 6f6e 2074 6f20 5368 6973  oduction to Shis
│ │ │ │ +0000bfb0: 613a 3a20 2020 2020 2020 4578 706c 616e  a::       Explan
│ │ │ │ +0000bfc0: 6174 696f 6e20 6f66 2074 6865 2053 6869  ation of the Shi
│ │ │ │ +0000bfd0: 7368 6920 7573 6572 2064 6174 6162 6173  shi user databas
│ │ │ │ +0000bfe0: 652e 0a2a 2043 6f6e 6669 6775 7269 6e67  e..* Configuring
│ │ │ │ +0000bff0: 2053 6869 7361 3a3a 2020 2020 2020 2020   Shisa::        
│ │ │ │ +0000c000: 2020 2044 6566 696e 6520 7468 6520 7573     Define the us
│ │ │ │ +0000c010: 6572 2064 6174 6162 6173 6520 696e 2053  er database in S
│ │ │ │ +0000c020: 6869 7361 2e0a 2a20 5573 696e 6720 5368  hisa..* Using Sh
│ │ │ │ +0000c030: 6973 613a 3a20 2020 2020 2020 2020 2020  isa::           
│ │ │ │ +0000c040: 2020 2020 2020 486f 7720 746f 2061 6464        How to add
│ │ │ │ +0000c050: 2072 6561 6c6d 7320 616e 6420 7072 696e   realms and prin
│ │ │ │ +0000c060: 6369 7061 6c73 2074 6f20 6461 7461 6261  cipals to databa
│ │ │ │ +0000c070: 7365 2e0a 2a20 5374 6172 7469 6e67 2053  se..* Starting S
│ │ │ │ +0000c080: 6869 7368 6964 3a3a 2020 2020 2020 2020  hishid::        
│ │ │ │ +0000c090: 2020 2020 4973 7375 6520 4b65 7262 6572      Issue Kerber
│ │ │ │ +0000c0a0: 6f73 2074 6963 6b65 7473 2074 6f20 796f  os tickets to yo
│ │ │ │ +0000c0b0: 7572 2075 7365 7273 2e0a 2a20 436f 6e66  ur users..* Conf
│ │ │ │ +0000c0c0: 6967 7572 696e 6720 444e 5320 666f 7220  iguring DNS for 
│ │ │ │ +0000c0d0: 4b44 433a 3a20 2020 2020 506c 6163 696e  KDC::     Placin
│ │ │ │ +0000c0e0: 6720 7468 6520 4b44 4320 6164 6472 6573  g the KDC addres
│ │ │ │ +0000c0f0: 7320 696e 2044 4e53 2069 7320 7573 6566  s in DNS is usef
│ │ │ │ +0000c100: 756c 2e0a 2a20 4b65 7262 6572 6f73 2076  ul..* Kerberos v
│ │ │ │ +0000c110: 6961 2054 4c53 3a3a 2020 2020 2020 2020  ia TLS::        
│ │ │ │ +0000c120: 2020 2020 486f 7720 746f 2073 6574 7570      How to setup
│ │ │ │ +0000c130: 2053 6869 7368 6920 746f 2075 7365 2054   Shishi to use T
│ │ │ │ +0000c140: 4c53 2e0a 2a20 4d75 6c74 6970 6c65 2073  LS..* Multiple s
│ │ │ │ +0000c150: 6572 7665 7273 3a3a 2020 2020 2020 2020  ervers::        
│ │ │ │ +0000c160: 2020 2020 4869 6768 2061 7661 696c 6162      High availab
│ │ │ │ +0000c170: 696c 6974 7920 616e 6420 6c6f 6164 2d62  ility and load-b
│ │ │ │ +0000c180: 616c 616e 6369 6e67 2e0a 2a20 4465 7665  alancing..* Deve
│ │ │ │ +0000c190: 6c6f 7065 7220 696e 666f 726d 6174 696f  loper informatio
│ │ │ │ +0000c1a0: 6e3a 3a20 2020 2020 2020 5772 6974 696e  n::       Writin
│ │ │ │ +0000c1b0: 6720 796f 7572 206f 776e 2053 6869 7361  g your own Shisa
│ │ │ │ +0000c1c0: 2064 6174 6162 6173 6520 6261 636b 656e   database backen
│ │ │ │ +0000c1d0: 642e 0a0a 2020 202d 2d2d 2d2d 2d2d 2d2d  d...   ---------
│ │ │ │ +0000c1e0: 2d20 466f 6f74 6e6f 7465 7320 2d2d 2d2d  - Footnotes ----
│ │ │ │ +0000c1f0: 2d2d 2d2d 2d2d 0a0a 2020 2028 3129 2041  ------..   (1) A
│ │ │ │ +0000c200: 6e64 2062 6573 6964 6573 2c20 5368 6973  nd besides, Shis
│ │ │ │ +0000c210: 6869 2069 7320 696e 7465 6e64 6564 2074  hi is intended t
│ │ │ │ +0000c220: 6f20 776f 726b 206f 6e20 6e6f 6e2d 556e  o work on non-Un
│ │ │ │ +0000c230: 6978 2070 6c61 7466 6f72 6d73 2061 730a  ix platforms as.
│ │ │ │ +0000c240: 7765 6c6c 2e0a 0a1f 0a46 696c 653a 2073  well.....File: s
│ │ │ │ +0000c250: 6869 7368 692e 696e 666f 2c20 204e 6f64  hishi.info,  Nod
│ │ │ │ +0000c260: 653a 2049 6e74 726f 6475 6374 696f 6e20  e: Introduction 
│ │ │ │ +0000c270: 746f 2053 6869 7361 2c20 204e 6578 743a  to Shisa,  Next:
│ │ │ │ +0000c280: 2043 6f6e 6669 6775 7269 6e67 2053 6869   Configuring Shi
│ │ │ │ +0000c290: 7361 2c20 2055 703a 2041 646d 696e 6973  sa,  Up: Adminis
│ │ │ │ +0000c2a0: 7472 6174 696f 6e20 4d61 6e75 616c 0a0a  tration Manual..
│ │ │ │ +0000c2b0: 332e 3120 496e 7472 6f64 7563 7469 6f6e  3.1 Introduction
│ │ │ │ +0000c2c0: 2074 6f20 5368 6973 610a 3d3d 3d3d 3d3d   to Shisa.======
│ │ │ │  0000c2d0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ -0000c2e0: 3d0a 0a54 6865 2075 7365 7220 6461 7461  =..The user data
│ │ │ │ -0000c2f0: 6261 7365 2070 6172 7420 6f66 2053 6869  base part of Shi
│ │ │ │ -0000c300: 7368 6920 6973 2063 616c 6c65 6420 5368  shi is called Sh
│ │ │ │ -0000c310: 6973 612e 2020 5468 6520 5368 6973 6120  isa.  The Shisa 
│ │ │ │ -0000c320: 6c69 6272 6172 7920 6973 0a69 6e64 6570  library is.indep
│ │ │ │ -0000c330: 656e 6465 6e74 206f 6620 7468 6520 636f  endent of the co
│ │ │ │ -0000c340: 7265 2053 6869 7368 6920 6c69 6272 6172  re Shishi librar
│ │ │ │ -0000c350: 792e 2020 5368 6973 6120 6973 2072 6573  y.  Shisa is res
│ │ │ │ -0000c360: 706f 6e73 6962 6c65 2066 6f72 0a73 746f  ponsible for.sto
│ │ │ │ -0000c370: 7269 6e67 2074 6865 206e 616d 6520 6f66  ring the name of
│ │ │ │ -0000c380: 2079 6f75 7220 7265 616c 6d73 2c20 7468   your realms, th
│ │ │ │ -0000c390: 6520 6e61 6d65 206f 6620 796f 7572 2070  e name of your p
│ │ │ │ -0000c3a0: 7269 6e63 6970 616c 7320 2875 7365 7273  rincipals (users
│ │ │ │ -0000c3b0: 292c 0a61 6363 6f75 6e74 696e 6720 696e  ),.accounting in
│ │ │ │ -0000c3c0: 666f 726d 6174 696f 6e20 666f 7220 7468  formation for th
│ │ │ │ -0000c3d0: 6520 7573 6572 7320 2869 2e65 2e2c 2077  e users (i.e., w
│ │ │ │ -0000c3e0: 6865 6e20 6561 6368 2061 6363 6f75 6e74  hen each account
│ │ │ │ -0000c3f0: 2073 7461 7274 7320 746f 0a62 6520 7661   starts to.be va
│ │ │ │ -0000c400: 6c69 6420 616e 6420 7768 656e 2069 7420  lid and when it 
│ │ │ │ -0000c410: 6578 7069 7265 7329 2c20 616e 6420 7468  expires), and th
│ │ │ │ -0000c420: 6520 6372 7970 746f 6772 6170 6869 6320  e cryptographic 
│ │ │ │ -0000c430: 6b65 7973 2065 6163 6820 7573 6572 2068  keys each user h
│ │ │ │ -0000c440: 6173 2e0a 536f 6d65 204b 6572 6265 726f  as..Some Kerbero
│ │ │ │ -0000c450: 7320 696e 7465 726e 616c 2064 6174 6120  s internal data 
│ │ │ │ -0000c460: 6361 6e20 616c 736f 2062 6520 7374 6f72  can also be stor
│ │ │ │ -0000c470: 6564 2c20 7375 6368 2061 7320 7468 6520  ed, such as the 
│ │ │ │ -0000c480: 6b65 7920 7665 7273 696f 6e0a 6e75 6d62  key version.numb
│ │ │ │ -0000c490: 6572 2c20 7468 6520 6c61 7374 2064 6174  er, the last dat
│ │ │ │ -0000c4a0: 6573 2066 6f72 2077 6865 6e20 7661 7269  es for when vari
│ │ │ │ -0000c4b0: 6f75 7320 7469 636b 6574 2072 6571 7565  ous ticket reque
│ │ │ │ -0000c4c0: 7374 7320 7765 7265 206d 6164 652c 2074  sts were made, t
│ │ │ │ -0000c4d0: 6865 0a63 7279 7074 6f67 7261 7068 6963  he.cryptographic
│ │ │ │ -0000c4e0: 2073 616c 742c 2073 7472 696e 672d 746f   salt, string-to
│ │ │ │ -0000c4f0: 2d6b 6579 2070 6172 616d 6574 6572 7320  -key parameters 
│ │ │ │ -0000c500: 616e 6420 7061 7373 776f 7264 2066 6f72  and password for
│ │ │ │ -0000c510: 2065 6163 6820 7573 6572 2e0a 4e6f 7420   each user..Not 
│ │ │ │ -0000c520: 616c 6c20 696e 666f 726d 6174 696f 6e20  all information 
│ │ │ │ -0000c530: 6e65 6564 2074 6f20 6265 2073 746f 7265  need to be store
│ │ │ │ -0000c540: 642e 2020 466f 7220 6578 616d 706c 652c  d.  For example,
│ │ │ │ -0000c550: 2069 6e20 736f 6d65 2073 6974 7561 7469   in some situati
│ │ │ │ -0000c560: 6f6e 730a 6974 2069 7320 7072 7564 656e  ons.it is pruden
│ │ │ │ -0000c570: 7420 746f 206c 6561 7665 2074 6865 2070  t to leave the p
│ │ │ │ -0000c580: 6173 7377 6f72 6420 6669 656c 6420 656d  assword field em
│ │ │ │ -0000c590: 7074 792c 2073 6f20 7468 6174 2073 6f6d  pty, so that som
│ │ │ │ -0000c5a0: 6562 6f64 7920 7768 6f0a 6d61 6e61 6765  ebody who.manage
│ │ │ │ -0000c5b0: 7320 746f 2073 7465 616c 2074 6865 2075  s to steal the u
│ │ │ │ -0000c5c0: 7365 7220 6461 7461 6261 7365 2077 696c  ser database wil
│ │ │ │ -0000c5d0: 6c20 6f6e 6c79 2062 6520 6162 6c65 2074  l only be able t
│ │ │ │ -0000c5e0: 6f20 636f 6d70 726f 6d69 7365 2079 6f75  o compromise you
│ │ │ │ -0000c5f0: 720a 7379 7374 656d 2c20 616e 6420 6e6f  r.system, and no
│ │ │ │ -0000c600: 7420 616e 7920 6f74 6865 7220 7379 7374  t any other syst
│ │ │ │ -0000c610: 656d 7320 7765 7265 2079 6f75 7220 7573  ems were your us
│ │ │ │ -0000c620: 6572 206d 6179 2068 6176 6520 7265 2d75  er may have re-u
│ │ │ │ -0000c630: 7365 6420 7468 650a 7361 6d65 2070 6173  sed the.same pas
│ │ │ │ -0000c640: 7377 6f72 642e 2020 4f6e 2074 6865 206f  sword.  On the o
│ │ │ │ -0000c650: 7468 6572 2068 616e 642c 2079 6f75 206d  ther hand, you m
│ │ │ │ -0000c660: 6179 2061 6c72 6561 6479 2062 6520 7374  ay already be st
│ │ │ │ -0000c670: 6f72 696e 6720 7468 650a 7061 7373 776f  oring the.passwo
│ │ │ │ -0000c680: 7264 2069 6e20 796f 7572 2063 7573 746f  rd in your custo
│ │ │ │ -0000c690: 6d69 7a65 6420 6461 7461 6261 7365 2c20  mized database, 
│ │ │ │ -0000c6a0: 696e 2077 6869 6368 2063 6173 6520 6265  in which case be
│ │ │ │ -0000c6b0: 696e 6720 6162 6c65 2074 6f20 6368 616e  ing able to chan
│ │ │ │ -0000c6c0: 6765 0a69 7420 7669 6120 7468 6520 5368  ge.it via the Sh
│ │ │ │ -0000c6d0: 6973 6120 696e 7465 7266 6163 6520 6361  isa interface ca
│ │ │ │ -0000c6e0: 6e20 6265 2075 7365 6675 6c2e 0a0a 2020  n be useful...  
│ │ │ │ -0000c6f0: 2053 6869 7361 2069 7320 6120 736d 616c   Shisa is a smal
│ │ │ │ -0000c700: 6c20 2861 2066 6577 2074 686f 7573 616e  l (a few thousan
│ │ │ │ -0000c710: 6420 6c69 6e65 7320 6f66 2043 2063 6f64  d lines of C cod
│ │ │ │ -0000c720: 6529 2073 7461 6e64 616c 6f6e 6520 6c69  e) standalone li
│ │ │ │ -0000c730: 6272 6172 792e 0a53 6869 7361 2064 6f65  brary..Shisa doe
│ │ │ │ -0000c740: 7320 6e6f 7420 6465 7065 6e64 206f 6e20  s not depend on 
│ │ │ │ -0000c750: 7468 6520 5368 6973 6869 206c 6962 7261  the Shishi libra
│ │ │ │ -0000c760: 7279 2e20 2042 6563 6175 7365 2061 2075  ry.  Because a u
│ │ │ │ -0000c770: 7365 7220 6461 7461 6261 7365 0a77 6974  ser database.wit
│ │ │ │ -0000c780: 6820 7061 7373 776f 7264 7320 6d61 7920  h passwords may 
│ │ │ │ -0000c790: 6265 2075 7365 6675 6c20 666f 7220 6f74  be useful for ot
│ │ │ │ -0000c7a0: 6865 7220 6170 706c 6963 6174 696f 6e73  her applications
│ │ │ │ -0000c7b0: 2061 7320 7765 6c6c 2028 652e 672e 2c20   as well (e.g., 
│ │ │ │ -0000c7c0: 474e 550a 5341 534c 292c 2069 7420 6d69  GNU.SASL), it mi
│ │ │ │ -0000c7d0: 6768 7420 6265 2073 6570 6172 6174 6564  ght be separated
│ │ │ │ -0000c7e0: 2069 6e74 6f20 6974 7320 6f77 6e20 7072   into its own pr
│ │ │ │ -0000c7f0: 6f6a 6563 7420 6c61 7465 7220 6f6e 2e20  oject later on. 
│ │ │ │ -0000c800: 2059 6f75 2073 686f 756c 640a 6b65 6570   You should.keep
│ │ │ │ -0000c810: 2074 6869 7320 696e 206d 696e 642c 2073   this in mind, s
│ │ │ │ -0000c820: 6f20 7468 6174 2079 6f75 2064 6f6e 2774  o that you don't
│ │ │ │ -0000c830: 2063 6f6e 7369 6465 7220 7772 6974 696e   consider writin
│ │ │ │ -0000c840: 6720 6120 5368 6973 6120 6261 636b 656e  g a Shisa backen
│ │ │ │ -0000c850: 640a 666f 7220 796f 7572 206f 776e 2064  d.for your own d
│ │ │ │ -0000c860: 6174 6162 6173 6520 6173 2061 2070 7572  atabase as a pur
│ │ │ │ -0000c870: 656c 7920 5368 6973 6869 2073 7065 6369  ely Shishi speci
│ │ │ │ -0000c880: 6669 6320 7072 6f6a 6563 742e 2020 596f  fic project.  Yo
│ │ │ │ -0000c890: 7520 6361 6e2c 2066 6f72 0a65 7861 6d70  u can, for.examp
│ │ │ │ -0000c8a0: 6c65 2c20 6368 6f6f 7365 2074 6f20 7573  le, choose to us
│ │ │ │ -0000c8b0: 6520 7468 6520 5368 6973 6120 696e 7465  e the Shisa inte
│ │ │ │ -0000c8c0: 7266 6163 6520 696e 2079 6f75 7220 6f77  rface in your ow
│ │ │ │ -0000c8d0: 6e20 6170 706c 6963 6174 696f 6e73 2074  n applications t
│ │ │ │ -0000c8e0: 6f0a 6861 7665 2061 2073 696d 706c 6520  o.have a simple 
│ │ │ │ -0000c8f0: 696e 7465 7266 6163 6520 746f 2079 6f75  interface to you
│ │ │ │ -0000c900: 7220 7573 6572 2064 6174 6162 6173 652e  r user database.
│ │ │ │ -0000c910: 2020 596f 7572 2065 7870 6572 6965 6e63    Your experienc
│ │ │ │ -0000c920: 6520 616e 640a 6665 6564 6261 636b 2069  e and.feedback i
│ │ │ │ -0000c930: 7320 6170 7072 6563 6961 7465 6420 6966  s appreciated if
│ │ │ │ -0000c940: 2079 6f75 2068 6176 6520 6368 6f73 656e   you have chosen
│ │ │ │ -0000c950: 2074 6f20 6578 706c 6f72 6520 7468 6973   to explore this
│ │ │ │ -0000c960: 2e0a 0a20 2020 4e6f 7465 2074 6861 7420  ...   Note that 
│ │ │ │ -0000c970: 7468 6520 5368 6973 6120 6461 7461 6261  the Shisa databa
│ │ │ │ -0000c980: 7365 2064 6f65 7320 6e6f 7420 6578 706f  se does not expo
│ │ │ │ -0000c990: 7365 2065 7665 7279 7468 696e 6720 796f  se everything yo
│ │ │ │ -0000c9a0: 7520 6d61 7920 7761 6e74 0a74 6f20 6b6e  u may want.to kn
│ │ │ │ -0000c9b0: 6f77 2061 626f 7574 2061 2075 7365 722c  ow about a user,
│ │ │ │ -0000c9c0: 2073 7563 6820 6173 2069 7473 2066 756c   such as its ful
│ │ │ │ -0000c9d0: 6c20 6875 6d61 6e20 6e61 6d65 2c20 7465  l human name, te
│ │ │ │ -0000c9e0: 6c65 7068 6f6e 6520 6e75 6d62 6572 206f  lephone number o
│ │ │ │ -0000c9f0: 720a 6576 656e 2074 6865 2075 7365 7227  r.even the user'
│ │ │ │ -0000ca00: 7320 6c6f 6769 6e20 6163 636f 756e 7420  s login account 
│ │ │ │ -0000ca10: 6e61 6d65 206f 7220 686f 6d65 2064 6972  name or home dir
│ │ │ │ -0000ca20: 6563 746f 7279 2e20 2049 7420 6f6e 6c79  ectory.  It only
│ │ │ │ -0000ca30: 2073 746f 7265 730a 7768 6174 2069 7320   stores.what is 
│ │ │ │ -0000ca40: 6e65 6564 6564 2074 6f20 6175 7468 656e  needed to authen
│ │ │ │ -0000ca50: 7469 6361 7465 2061 2070 6565 7220 636c  ticate a peer cl
│ │ │ │ -0000ca60: 6169 6d69 6e67 2074 6f20 6265 2061 6e20  aiming to be an 
│ │ │ │ -0000ca70: 656e 7469 7479 2e20 2054 6875 7320 6974  entity.  Thus it
│ │ │ │ -0000ca80: 0a64 6f65 7320 6e6f 7420 6d61 6b65 2073  .does not make s
│ │ │ │ -0000ca90: 656e 7365 2074 6f20 7265 706c 6163 6520  ense to replace 
│ │ │ │ -0000caa0: 796f 7572 2063 7572 7265 6e74 2075 7365  your current use
│ │ │ │ -0000cab0: 7220 6461 7461 6261 7365 206f 720a e280  r database or...
│ │ │ │ -0000cac0: 982f 6574 632f 7061 7373 7764 e280 9920  ./etc/passwd... 
│ │ │ │ -0000cad0: 7769 7468 2064 6174 6120 6465 7269 7665  with data derive
│ │ │ │ -0000cae0: 6420 6672 6f6d 2074 6865 2053 6869 7361  d from the Shisa
│ │ │ │ -0000caf0: 2064 6174 6162 6173 652e 2020 496e 7374   database.  Inst
│ │ │ │ -0000cb00: 6561 642c 2069 7420 6973 0a69 6e74 656e  ead, it is.inten
│ │ │ │ -0000cb10: 6465 6420 7468 6174 2079 6f75 2077 7269  ded that you wri
│ │ │ │ -0000cb20: 7465 2061 2053 6869 7361 2062 6163 6b65  te a Shisa backe
│ │ │ │ -0000cb30: 6e64 2074 6861 7420 6578 706f 7274 7320  nd that exports 
│ │ │ │ -0000cb40: 736f 6d65 206f 6620 7468 650a 696e 666f  some of the.info
│ │ │ │ -0000cb50: 726d 6174 696f 6e20 7374 6f72 6564 2069  rmation stored i
│ │ │ │ -0000cb60: 6e20 796f 7572 2075 7365 7220 6461 7461  n your user data
│ │ │ │ -0000cb70: 6261 7365 2e20 2059 6f75 206d 6179 2062  base.  You may b
│ │ │ │ -0000cb80: 6520 6162 6c65 2074 6f20 7265 706c 6163  e able to replac
│ │ │ │ -0000cb90: 650a 736f 6d65 2065 7869 7374 696e 6720  e.some existing 
│ │ │ │ -0000cba0: 6675 6e63 7469 6f6e 616c 6974 792c 2073  functionality, s
│ │ │ │ -0000cbb0: 7563 6820 6173 2074 6865 2070 6173 7377  uch as the passw
│ │ │ │ -0000cbc0: 6f72 6420 6669 656c 6420 696e 20e2 8098  ord field in ...
│ │ │ │ -0000cbd0: 2f65 7463 2f70 6173 7377 64e2 8099 0a77  /etc/passwd....w
│ │ │ │ -0000cbe0: 6974 6820 6120 4b65 7262 6572 6f73 2050  ith a Kerberos P
│ │ │ │ -0000cbf0: 414d 206d 6f64 756c 652c 2062 7574 2074  AM module, but t
│ │ │ │ -0000cc00: 6865 7265 2069 7320 6e6f 2072 6571 7569  here is no requi
│ │ │ │ -0000cc10: 7265 6d65 6e74 2066 6f72 2064 6f69 6e67  rement for doing
│ │ │ │ -0000cc20: 2073 6f2e 0a0a 1f0a 4669 6c65 3a20 7368   so.....File: sh
│ │ │ │ -0000cc30: 6973 6869 2e69 6e66 6f2c 2020 4e6f 6465  ishi.info,  Node
│ │ │ │ -0000cc40: 3a20 436f 6e66 6967 7572 696e 6720 5368  : Configuring Sh
│ │ │ │ -0000cc50: 6973 612c 2020 4e65 7874 3a20 5573 696e  isa,  Next: Usin
│ │ │ │ -0000cc60: 6720 5368 6973 612c 2020 5072 6576 3a20  g Shisa,  Prev: 
│ │ │ │ -0000cc70: 496e 7472 6f64 7563 7469 6f6e 2074 6f20  Introduction to 
│ │ │ │ -0000cc80: 5368 6973 612c 2020 5570 3a20 4164 6d69  Shisa,  Up: Admi
│ │ │ │ -0000cc90: 6e69 7374 7261 7469 6f6e 204d 616e 7561  nistration Manua
│ │ │ │ -0000cca0: 6c0a 0a33 2e32 2043 6f6e 6669 6775 7269  l..3.2 Configuri
│ │ │ │ -0000ccb0: 6e67 2053 6869 7361 0a3d 3d3d 3d3d 3d3d  ng Shisa.=======
│ │ │ │ -0000ccc0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a  ==============..
│ │ │ │ -0000ccd0: 5468 6520 636f 6e66 6967 7572 6174 696f  The configuratio
│ │ │ │ -0000cce0: 6e20 6669 6c65 2066 6f72 2053 6869 7361  n file for Shisa
│ │ │ │ -0000ccf0: 2069 7320 7479 7069 6361 6c6c 7920 7374   is typically st
│ │ │ │ -0000cd00: 6f72 6564 2069 6e0a e280 982f 7573 722f  ored in..../usr/
│ │ │ │ -0000cd10: 6c6f 6361 6c2f 6574 632f 7368 6973 6869  local/etc/shishi
│ │ │ │ -0000cd20: 2f73 6869 7361 2e63 6f6e 66e2 8099 2e20  /shisa.conf.... 
│ │ │ │ -0000cd30: 2059 6f75 2064 6f20 6e6f 7420 6861 7665   You do not have
│ │ │ │ -0000cd40: 2074 6f20 6d6f 6469 6679 2074 6869 730a   to modify this.
│ │ │ │ -0000cd50: 6669 6c65 2c20 7468 6520 6465 6661 756c  file, the defaul
│ │ │ │ -0000cd60: 7473 2073 686f 756c 6420 6265 2061 6363  ts should be acc
│ │ │ │ -0000cd70: 6570 7461 626c 6520 746f 2066 6972 7374  eptable to first
│ │ │ │ -0000cd80: 2d74 696d 6520 7573 6572 732e 2020 5468  -time users.  Th
│ │ │ │ -0000cd90: 6520 6669 6c65 0a69 7320 7573 6564 2074  e file.is used t
│ │ │ │ -0000cda0: 6f20 6465 6669 6e65 2077 6865 7265 2079  o define where y
│ │ │ │ -0000cdb0: 6f75 7220 7573 6572 2064 6174 6162 6173  our user databas
│ │ │ │ -0000cdc0: 6520 7265 7369 6465 732c 2061 6e64 2073  e resides, and s
│ │ │ │ -0000cdd0: 6f6d 6520 6f70 7469 6f6e 730a 7375 6368  ome options.such
│ │ │ │ -0000cde0: 2061 7320 6d61 6b69 6e67 2074 6865 2064   as making the d
│ │ │ │ -0000cdf0: 6174 6162 6173 6520 7265 6164 2d6f 6e6c  atabase read-onl
│ │ │ │ -0000ce00: 792c 206f 7220 7768 6574 6865 7220 6572  y, or whether er
│ │ │ │ -0000ce10: 726f 7273 2064 6574 6563 7465 6420 7768  rors detected wh
│ │ │ │ -0000ce20: 656e 0a61 6363 6573 7369 6e67 2074 6865  en.accessing the
│ │ │ │ -0000ce30: 2064 6174 6162 6173 6520 7368 6f75 6c64   database should
│ │ │ │ -0000ce40: 2062 6520 6967 6e6f 7265 642e 2020 2854   be ignored.  (T
│ │ │ │ -0000ce50: 6865 206c 6174 7465 7220 636f 756c 6420  he latter could 
│ │ │ │ -0000ce60: 6265 2075 7365 6675 6c0a 6966 2074 6865  be useful.if the
│ │ │ │ -0000ce70: 2073 6572 7665 7220 6973 2061 2072 656d   server is a rem
│ │ │ │ -0000ce80: 6f74 6520 4c44 4150 2073 6572 7665 7220  ote LDAP server 
│ │ │ │ -0000ce90: 7468 6174 206d 6967 6874 2062 6520 756e  that might be un
│ │ │ │ -0000cea0: 6176 6169 6c61 626c 652c 2061 6e64 0a74  available, and.t
│ │ │ │ -0000ceb0: 6865 6e20 796f 7520 776f 756c 6420 7761  hen you would wa
│ │ │ │ -0000cec0: 6e74 2074 6f20 6661 6c6c 2062 6163 6b20  nt to fall back 
│ │ │ │ -0000ced0: 746f 2061 206c 6f63 616c 2063 6f70 7920  to a local copy 
│ │ │ │ -0000cee0: 6f66 2074 6865 2064 6174 6162 6173 652e  of the database.
│ │ │ │ -0000cef0: 290a 0a20 2020 5468 6520 6465 6661 756c  )..   The defaul
│ │ │ │ -0000cf00: 7420 7769 6c6c 2073 746f 7265 2074 6865  t will store the
│ │ │ │ -0000cf10: 2075 7365 7220 6461 7461 6261 7365 2075   user database u
│ │ │ │ -0000cf20: 7369 6e67 2064 6972 6563 746f 7269 6573  sing directories
│ │ │ │ -0000cf30: 2061 6e64 2066 696c 6573 2c0a 726f 6f74   and files,.root
│ │ │ │ -0000cf40: 6564 2062 7920 6465 6661 756c 7420 696e  ed by default in
│ │ │ │ -0000cf50: 20e2 8098 2f75 7372 2f6c 6f63 616c 2f76   .../usr/local/v
│ │ │ │ -0000cf60: 6172 2f73 6869 7368 69e2 8099 2e20 2059  ar/shishi....  Y
│ │ │ │ -0000cf70: 6f75 2063 616e 2075 7365 2073 7461 6e64  ou can use stand
│ │ │ │ -0000cf80: 6172 6420 6669 6c65 0a70 6572 6d69 7373  ard file.permiss
│ │ │ │ -0000cf90: 696f 6e20 7365 7474 696e 6773 2074 6f20  ion settings to 
│ │ │ │ -0000cfa0: 636f 6e74 726f 6c20 6163 6365 7373 2074  control access t
│ │ │ │ -0000cfb0: 6f20 7468 6520 6469 7265 6374 6f72 7920  o the directory 
│ │ │ │ -0000cfc0: 6869 6572 6172 6368 792e 2020 4974 2069  hierarchy.  It i
│ │ │ │ -0000cfd0: 730a 7374 726f 6e67 6c79 2072 6563 6f6d  s.strongly recom
│ │ │ │ -0000cfe0: 6d65 6e64 6564 2074 6f20 7265 7374 7269  mended to restri
│ │ │ │ -0000cff0: 6374 2061 6363 6573 7320 746f 2074 6865  ct access to the
│ │ │ │ -0000d000: 2064 6972 6563 746f 7279 2e20 2053 746f   directory.  Sto
│ │ │ │ -0000d010: 7269 6e67 2074 6865 0a64 6972 6563 746f  ring the.directo
│ │ │ │ -0000d020: 7279 206f 6e20 6c6f 6361 6c20 7374 6f72  ry on local stor
│ │ │ │ -0000d030: 6167 652c 2069 2e65 2e2c 2068 6172 6420  age, i.e., hard 
│ │ │ │ -0000d040: 6469 736b 206f 7220 7265 6d6f 7661 626c  disk or removabl
│ │ │ │ -0000d050: 6520 6d65 6469 612c 2069 730a 7265 636f  e media, is.reco
│ │ │ │ -0000d060: 6d6d 656e 6465 642e 2020 5765 2064 6973  mmended.  We dis
│ │ │ │ -0000d070: 636f 7572 6167 6520 706c 6163 696e 6720  courage placing 
│ │ │ │ -0000d080: 7468 6520 6461 7461 6261 7365 206f 6e20  the database on 
│ │ │ │ -0000d090: 6120 6e65 7477 6f72 6b20 6669 6c65 0a73  a network file.s
│ │ │ │ -0000d0a0: 7973 7465 6d2c 2062 7574 2072 6561 6c69  ystem, but reali
│ │ │ │ -0000d0b0: 7a65 2074 6869 7320 6361 6e20 6265 2075  ze this can be u
│ │ │ │ -0000d0c0: 7365 6675 6c20 696e 2073 6f6d 6520 7369  seful in some si
│ │ │ │ -0000d0d0: 7475 6174 696f 6e73 2028 2a6e 6f74 650a  tuations (*note.
│ │ │ │ -0000d0e0: 4d75 6c74 6970 6c65 2073 6572 7665 7273  Multiple servers
│ │ │ │ -0000d0f0: 3a3a 292e 0a0a 2020 2053 6565 2074 6865  ::)...   See the
│ │ │ │ -0000d100: 2072 6566 6572 656e 6365 206d 616e 7561   reference manua
│ │ │ │ -0000d110: 6c20 282a 6e6f 7465 2053 6869 7361 2043  l (*note Shisa C
│ │ │ │ -0000d120: 6f6e 6669 6775 7261 7469 6f6e 3a3a 2920  onfiguration::) 
│ │ │ │ -0000d130: 666f 7220 7468 650a 6465 7461 696c 7320  for the.details 
│ │ │ │ -0000d140: 6f66 2074 6865 2063 6f6e 6669 6775 7261  of the configura
│ │ │ │ -0000d150: 7469 6f6e 2066 696c 652e 2020 4167 6169  tion file.  Agai
│ │ │ │ -0000d160: 6e2c 2079 6f75 2061 7265 206e 6f74 2065  n, you are not e
│ │ │ │ -0000d170: 7870 6563 7465 6420 746f 206e 6565 640a  xpected to need.
│ │ │ │ -0000d180: 746f 206d 6f64 6966 7920 616e 7974 6869  to modify anythi
│ │ │ │ -0000d190: 6e67 2075 6e6c 6573 7320 796f 7520 6172  ng unless you ar
│ │ │ │ -0000d1a0: 6520 616e 2065 7870 6572 6965 6e63 6564  e an experienced
│ │ │ │ -0000d1b0: 2053 6869 7368 6920 6164 6d69 6e69 7374   Shishi administ
│ │ │ │ -0000d1c0: 7261 746f 722e 0a0a 1f0a 4669 6c65 3a20  rator.....File: 
│ │ │ │ -0000d1d0: 7368 6973 6869 2e69 6e66 6f2c 2020 4e6f  shishi.info,  No
│ │ │ │ -0000d1e0: 6465 3a20 5573 696e 6720 5368 6973 612c  de: Using Shisa,
│ │ │ │ -0000d1f0: 2020 4e65 7874 3a20 5374 6172 7469 6e67    Next: Starting
│ │ │ │ -0000d200: 2053 6869 7368 6964 2c20 2050 7265 763a   Shishid,  Prev:
│ │ │ │ -0000d210: 2043 6f6e 6669 6775 7269 6e67 2053 6869   Configuring Shi
│ │ │ │ -0000d220: 7361 2c20 2055 703a 2041 646d 696e 6973  sa,  Up: Adminis
│ │ │ │ -0000d230: 7472 6174 696f 6e20 4d61 6e75 616c 0a0a  tration Manual..
│ │ │ │ -0000d240: 332e 3320 5573 696e 6720 5368 6973 610a  3.3 Using Shisa.
│ │ │ │ -0000d250: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a  ===============.
│ │ │ │ -0000d260: 0a54 6865 7265 2069 7320 6120 636f 6d6d  .There is a comm
│ │ │ │ -0000d270: 616e 6420 6c69 6e65 2069 6e74 6572 6661  and line interfa
│ │ │ │ -0000d280: 6365 2074 6f20 7468 6520 5368 6973 6120  ce to the Shisa 
│ │ │ │ -0000d290: 6c69 6272 6172 792c 2061 7074 6c79 206e  library, aptly n
│ │ │ │ -0000d2a0: 616d 6564 0ae2 8098 7368 6973 61e2 8099  amed....shisa...
│ │ │ │ -0000d2b0: 2e20 2059 6f75 2077 696c 6c20 7573 6520  .  You will use 
│ │ │ │ -0000d2c0: 7468 6973 2074 6f6f 6c20 746f 2061 6464  this tool to add
│ │ │ │ -0000d2d0: 2c20 7265 6d6f 7665 2c20 616e 6420 6368  , remove, and ch
│ │ │ │ -0000d2e0: 616e 6765 2069 6e66 6f72 6d61 7469 6f6e  ange information
│ │ │ │ -0000d2f0: 0a73 746f 7265 6420 696e 2074 6865 2064  .stored in the d
│ │ │ │ -0000d300: 6174 6162 6173 6520 6162 6f75 7420 7265  atabase about re
│ │ │ │ -0000d310: 616c 6d73 2c20 7072 696e 6369 7061 6c73  alms, principals
│ │ │ │ -0000d320: 2c20 616e 6420 6b65 7973 2e20 2054 6865  , and keys.  The
│ │ │ │ -0000d330: 2074 6f6f 6c20 6361 6e0a 616c 736f 2062   tool can.also b
│ │ │ │ -0000d340: 6520 7573 6564 2074 6f20 2264 756d 7022  e used to "dump"
│ │ │ │ -0000d350: 2061 6c6c 2069 6e66 6f72 6d61 7469 6f6e   all information
│ │ │ │ -0000d360: 2069 6e20 7468 6520 6461 7461 6261 7365   in the database
│ │ │ │ -0000d370: 2c20 666f 7220 6261 636b 7570 206f 720a  , for backup or.
│ │ │ │ -0000d380: 6465 6275 6767 696e 6720 7075 7270 6f73  debugging purpos
│ │ │ │ -0000d390: 6573 2e20 2028 4375 7272 656e 746c 7920  es.  (Currently 
│ │ │ │ -0000d3a0: 7468 6520 6f75 7470 7574 2066 6f72 6d61  the output forma
│ │ │ │ -0000d3b0: 7420 6361 6e6e 6f74 2062 6520 7265 6164  t cannot be read
│ │ │ │ -0000d3c0: 2062 7920 616e 790a 746f 6f6c 2c20 6275   by any.tool, bu
│ │ │ │ -0000d3d0: 7420 6675 6e63 7469 6f6e 616c 6974 7920  t functionality 
│ │ │ │ -0000d3e0: 746f 2064 6f20 7468 6973 2077 696c 6c20  to do this will 
│ │ │ │ -0000d3f0: 6265 2061 6464 6564 2069 6e20 7468 6520  be added in the 
│ │ │ │ -0000d400: 6675 7475 7265 2c20 706f 7373 6962 6c79  future, possibly
│ │ │ │ -0000d410: 0a61 7320 6120 7265 6164 2d6f 6e6c 7920  .as a read-only 
│ │ │ │ -0000d420: 6669 6c65 2d62 6173 6564 2053 6869 7361  file-based Shisa
│ │ │ │ -0000d430: 2064 6174 6162 6173 6520 6261 636b 656e   database backen
│ │ │ │ -0000d440: 642e 290a 0a20 2020 5468 6520 7265 6665  d.)..   The refe
│ │ │ │ -0000d450: 7265 6e63 6520 6d61 6e75 616c 2028 2a6e  rence manual (*n
│ │ │ │ -0000d460: 6f74 6520 5061 7261 6d65 7465 7273 2066  ote Parameters f
│ │ │ │ -0000d470: 6f72 2073 6869 7361 3a3a 2920 6578 706c  or shisa::) expl
│ │ │ │ -0000d480: 6169 6e73 2061 6c6c 0a70 6172 616d 6574  ains all.paramet
│ │ │ │ -0000d490: 6572 732c 2062 7574 2068 6572 6520 7765  ers, but here we
│ │ │ │ -0000d4a0: 2077 696c 6c20 6769 7665 2079 6f75 2061   will give you a
│ │ │ │ -0000d4b0: 2077 616c 6b2d 7468 726f 7567 6820 6f66   walk-through of
│ │ │ │ -0000d4c0: 2074 6865 2074 7970 6963 616c 2075 7365   the typical use
│ │ │ │ -0000d4d0: 730a 6f66 2074 6865 2074 6f6f 6c2e 0a0a  s.of the tool...
│ │ │ │ -0000d4e0: 2020 2049 6e73 7461 6c6c 696e 6720 5368     Installing Sh
│ │ │ │ -0000d4f0: 6973 6869 2075 7375 616c 6c79 2063 7265  ishi usually cre
│ │ │ │ -0000d500: 6174 6573 2061 2072 6561 6c6d 2077 6974  ates a realm wit
│ │ │ │ -0000d510: 6820 7477 6f20 7072 696e 6369 7061 6c73  h two principals
│ │ │ │ -0000d520: 3a20 6f6e 650a 7469 636b 6574 2067 7261  : one.ticket gra
│ │ │ │ -0000d530: 6e74 696e 6720 7469 636b 6574 2066 6f72  nting ticket for
│ │ │ │ -0000d540: 2074 6865 2072 6561 6c6d 2c20 616e 6420   the realm, and 
│ │ │ │ -0000d550: 6f6e 6520 686f 7374 206b 6579 2066 6f72  one host key for
│ │ │ │ -0000d560: 2074 6865 2073 6572 7665 722e 0a54 6869   the server..Thi
│ │ │ │ -0000d570: 7320 6973 2077 6861 7420 796f 7520 7479  s is what you ty
│ │ │ │ -0000d580: 7069 6361 6c6c 7920 6e65 6564 2074 6f20  pically need to 
│ │ │ │ -0000d590: 6765 7420 7374 6172 7465 642c 2062 7574  get started, but
│ │ │ │ -0000d5a0: 2069 7420 646f 6573 6e27 7420 7365 7276   it doesn't serv
│ │ │ │ -0000d5b0: 6520 6f75 720a 7075 7270 6f73 6573 2c20  e our.purposes, 
│ │ │ │ -0000d5c0: 736f 2077 6520 7374 6172 7420 6279 2072  so we start by r
│ │ │ │ -0000d5d0: 656d 6f76 696e 6720 7468 6520 7072 696e  emoving the prin
│ │ │ │ -0000d5e0: 6369 7061 6c73 2061 6e64 2074 6865 2072  cipals and the r
│ │ │ │ -0000d5f0: 6561 6c6d 2e20 2054 6f20 646f 0a74 6861  ealm.  To do.tha
│ │ │ │ -0000d600: 742c 2077 6520 6e65 6564 2074 6f20 6669  t, we need to fi
│ │ │ │ -0000d610: 6775 7265 206f 7574 2074 6865 206e 616d  gure out the nam
│ │ │ │ -0000d620: 6520 6f66 2074 6865 2072 6561 6c6d 2e20  e of the realm. 
│ │ │ │ -0000d630: 2054 6865 20e2 8098 2d2d 6c69 7374 e280   The ...--list..
│ │ │ │ -0000d640: 9920 6f72 0ae2 8098 2d2d 6475 6d70 e280  . or....--dump..
│ │ │ │ -0000d650: 9920 7061 7261 6d65 7465 7273 2063 616e  . parameters can
│ │ │ │ -0000d660: 2062 6520 7573 6564 2066 6f72 2074 6869   be used for thi
│ │ │ │ -0000d670: 732e 2020 284d 6f73 7420 226c 6f6e 6722  s.  (Most "long"
│ │ │ │ -0000d680: 2070 6172 616d 6574 6572 732c 206c 696b   parameters, lik
│ │ │ │ -0000d690: 650a e280 982d 2d64 756d 70e2 8099 2c20  e....--dump..., 
│ │ │ │ -0000d6a0: 6861 7665 2073 686f 7274 6572 206e 616d  have shorter nam
│ │ │ │ -0000d6b0: 6573 2061 7320 7765 6c6c 2c20 696e 2074  es as well, in t
│ │ │ │ -0000d6c0: 6869 7320 6361 7365 20e2 8098 2d64 e280  his case ...-d..
│ │ │ │ -0000d6d0: 992c 202a 6e6f 7465 0a50 6172 616d 6574  ., *note.Paramet
│ │ │ │ -0000d6e0: 6572 7320 666f 7220 7368 6973 613a 3a29  ers for shisa::)
│ │ │ │ -0000d6f0: 2e0a 0a20 2020 2020 6a61 7340 6c61 7474  ...     jas@latt
│ │ │ │ -0000d700: 653a 7e24 2073 6869 7361 202d 640a 2020  e:~$ shisa -d.  
│ │ │ │ -0000d710: 2020 206c 6174 7465 0a20 2020 2020 2020     latte.       
│ │ │ │ -0000d720: 2020 2020 2020 6b72 6274 6774 2f6c 6174        krbtgt/lat
│ │ │ │ -0000d730: 7465 0a20 2020 2020 2020 2020 2020 2020  te.             
│ │ │ │ -0000d740: 2020 2020 2020 2020 4163 636f 756e 7420          Account 
│ │ │ │ -0000d750: 6973 2065 6e61 626c 6564 2e0a 2020 2020  is enabled..    
│ │ │ │ +0000c2e0: 3d3d 3d0a 0a54 6865 2075 7365 7220 6461  ===..The user da
│ │ │ │ +0000c2f0: 7461 6261 7365 2070 6172 7420 6f66 2053  tabase part of S
│ │ │ │ +0000c300: 6869 7368 6920 6973 2063 616c 6c65 6420  hishi is called 
│ │ │ │ +0000c310: 5368 6973 612e 2020 5468 6520 5368 6973  Shisa.  The Shis
│ │ │ │ +0000c320: 6120 6c69 6272 6172 7920 6973 0a69 6e64  a library is.ind
│ │ │ │ +0000c330: 6570 656e 6465 6e74 206f 6620 7468 6520  ependent of the 
│ │ │ │ +0000c340: 636f 7265 2053 6869 7368 6920 6c69 6272  core Shishi libr
│ │ │ │ +0000c350: 6172 792e 2020 5368 6973 6120 6973 2072  ary.  Shisa is r
│ │ │ │ +0000c360: 6573 706f 6e73 6962 6c65 2066 6f72 0a73  esponsible for.s
│ │ │ │ +0000c370: 746f 7269 6e67 2074 6865 206e 616d 6520  toring the name 
│ │ │ │ +0000c380: 6f66 2079 6f75 7220 7265 616c 6d73 2c20  of your realms, 
│ │ │ │ +0000c390: 7468 6520 6e61 6d65 206f 6620 796f 7572  the name of your
│ │ │ │ +0000c3a0: 2070 7269 6e63 6970 616c 7320 2875 7365   principals (use
│ │ │ │ +0000c3b0: 7273 292c 0a61 6363 6f75 6e74 696e 6720  rs),.accounting 
│ │ │ │ +0000c3c0: 696e 666f 726d 6174 696f 6e20 666f 7220  information for 
│ │ │ │ +0000c3d0: 7468 6520 7573 6572 7320 2869 2e65 2e2c  the users (i.e.,
│ │ │ │ +0000c3e0: 2077 6865 6e20 6561 6368 2061 6363 6f75   when each accou
│ │ │ │ +0000c3f0: 6e74 2073 7461 7274 7320 746f 0a62 6520  nt starts to.be 
│ │ │ │ +0000c400: 7661 6c69 6420 616e 6420 7768 656e 2069  valid and when i
│ │ │ │ +0000c410: 7420 6578 7069 7265 7329 2c20 616e 6420  t expires), and 
│ │ │ │ +0000c420: 7468 6520 6372 7970 746f 6772 6170 6869  the cryptographi
│ │ │ │ +0000c430: 6320 6b65 7973 2065 6163 6820 7573 6572  c keys each user
│ │ │ │ +0000c440: 2068 6173 2e0a 536f 6d65 204b 6572 6265   has..Some Kerbe
│ │ │ │ +0000c450: 726f 7320 696e 7465 726e 616c 2064 6174  ros internal dat
│ │ │ │ +0000c460: 6120 6361 6e20 616c 736f 2062 6520 7374  a can also be st
│ │ │ │ +0000c470: 6f72 6564 2c20 7375 6368 2061 7320 7468  ored, such as th
│ │ │ │ +0000c480: 6520 6b65 7920 7665 7273 696f 6e0a 6e75  e key version.nu
│ │ │ │ +0000c490: 6d62 6572 2c20 7468 6520 6c61 7374 2064  mber, the last d
│ │ │ │ +0000c4a0: 6174 6573 2066 6f72 2077 6865 6e20 7661  ates for when va
│ │ │ │ +0000c4b0: 7269 6f75 7320 7469 636b 6574 2072 6571  rious ticket req
│ │ │ │ +0000c4c0: 7565 7374 7320 7765 7265 206d 6164 652c  uests were made,
│ │ │ │ +0000c4d0: 2074 6865 0a63 7279 7074 6f67 7261 7068   the.cryptograph
│ │ │ │ +0000c4e0: 6963 2073 616c 742c 2073 7472 696e 672d  ic salt, string-
│ │ │ │ +0000c4f0: 746f 2d6b 6579 2070 6172 616d 6574 6572  to-key parameter
│ │ │ │ +0000c500: 7320 616e 6420 7061 7373 776f 7264 2066  s and password f
│ │ │ │ +0000c510: 6f72 2065 6163 6820 7573 6572 2e0a 4e6f  or each user..No
│ │ │ │ +0000c520: 7420 616c 6c20 696e 666f 726d 6174 696f  t all informatio
│ │ │ │ +0000c530: 6e20 6e65 6564 2074 6f20 6265 2073 746f  n need to be sto
│ │ │ │ +0000c540: 7265 642e 2020 466f 7220 6578 616d 706c  red.  For exampl
│ │ │ │ +0000c550: 652c 2069 6e20 736f 6d65 2073 6974 7561  e, in some situa
│ │ │ │ +0000c560: 7469 6f6e 730a 6974 2069 7320 7072 7564  tions.it is prud
│ │ │ │ +0000c570: 656e 7420 746f 206c 6561 7665 2074 6865  ent to leave the
│ │ │ │ +0000c580: 2070 6173 7377 6f72 6420 6669 656c 6420   password field 
│ │ │ │ +0000c590: 656d 7074 792c 2073 6f20 7468 6174 2073  empty, so that s
│ │ │ │ +0000c5a0: 6f6d 6562 6f64 7920 7768 6f0a 6d61 6e61  omebody who.mana
│ │ │ │ +0000c5b0: 6765 7320 746f 2073 7465 616c 2074 6865  ges to steal the
│ │ │ │ +0000c5c0: 2075 7365 7220 6461 7461 6261 7365 2077   user database w
│ │ │ │ +0000c5d0: 696c 6c20 6f6e 6c79 2062 6520 6162 6c65  ill only be able
│ │ │ │ +0000c5e0: 2074 6f20 636f 6d70 726f 6d69 7365 2079   to compromise y
│ │ │ │ +0000c5f0: 6f75 720a 7379 7374 656d 2c20 616e 6420  our.system, and 
│ │ │ │ +0000c600: 6e6f 7420 616e 7920 6f74 6865 7220 7379  not any other sy
│ │ │ │ +0000c610: 7374 656d 7320 7765 7265 2079 6f75 7220  stems were your 
│ │ │ │ +0000c620: 7573 6572 206d 6179 2068 6176 6520 7265  user may have re
│ │ │ │ +0000c630: 2d75 7365 6420 7468 650a 7361 6d65 2070  -used the.same p
│ │ │ │ +0000c640: 6173 7377 6f72 642e 2020 4f6e 2074 6865  assword.  On the
│ │ │ │ +0000c650: 206f 7468 6572 2068 616e 642c 2079 6f75   other hand, you
│ │ │ │ +0000c660: 206d 6179 2061 6c72 6561 6479 2062 6520   may already be 
│ │ │ │ +0000c670: 7374 6f72 696e 6720 7468 650a 7061 7373  storing the.pass
│ │ │ │ +0000c680: 776f 7264 2069 6e20 796f 7572 2063 7573  word in your cus
│ │ │ │ +0000c690: 746f 6d69 7a65 6420 6461 7461 6261 7365  tomized database
│ │ │ │ +0000c6a0: 2c20 696e 2077 6869 6368 2063 6173 6520  , in which case 
│ │ │ │ +0000c6b0: 6265 696e 6720 6162 6c65 2074 6f20 6368  being able to ch
│ │ │ │ +0000c6c0: 616e 6765 0a69 7420 7669 6120 7468 6520  ange.it via the 
│ │ │ │ +0000c6d0: 5368 6973 6120 696e 7465 7266 6163 6520  Shisa interface 
│ │ │ │ +0000c6e0: 6361 6e20 6265 2075 7365 6675 6c2e 0a0a  can be useful...
│ │ │ │ +0000c6f0: 2020 2053 6869 7361 2069 7320 6120 736d     Shisa is a sm
│ │ │ │ +0000c700: 616c 6c20 2861 2066 6577 2074 686f 7573  all (a few thous
│ │ │ │ +0000c710: 616e 6420 6c69 6e65 7320 6f66 2043 2063  and lines of C c
│ │ │ │ +0000c720: 6f64 6529 2073 7461 6e64 616c 6f6e 6520  ode) standalone 
│ │ │ │ +0000c730: 6c69 6272 6172 792e 0a53 6869 7361 2064  library..Shisa d
│ │ │ │ +0000c740: 6f65 7320 6e6f 7420 6465 7065 6e64 206f  oes not depend o
│ │ │ │ +0000c750: 6e20 7468 6520 5368 6973 6869 206c 6962  n the Shishi lib
│ │ │ │ +0000c760: 7261 7279 2e20 2042 6563 6175 7365 2061  rary.  Because a
│ │ │ │ +0000c770: 2075 7365 7220 6461 7461 6261 7365 0a77   user database.w
│ │ │ │ +0000c780: 6974 6820 7061 7373 776f 7264 7320 6d61  ith passwords ma
│ │ │ │ +0000c790: 7920 6265 2075 7365 6675 6c20 666f 7220  y be useful for 
│ │ │ │ +0000c7a0: 6f74 6865 7220 6170 706c 6963 6174 696f  other applicatio
│ │ │ │ +0000c7b0: 6e73 2061 7320 7765 6c6c 2028 652e 672e  ns as well (e.g.
│ │ │ │ +0000c7c0: 2c20 474e 550a 5341 534c 292c 2069 7420  , GNU.SASL), it 
│ │ │ │ +0000c7d0: 6d69 6768 7420 6265 2073 6570 6172 6174  might be separat
│ │ │ │ +0000c7e0: 6564 2069 6e74 6f20 6974 7320 6f77 6e20  ed into its own 
│ │ │ │ +0000c7f0: 7072 6f6a 6563 7420 6c61 7465 7220 6f6e  project later on
│ │ │ │ +0000c800: 2e20 2059 6f75 2073 686f 756c 640a 6b65  .  You should.ke
│ │ │ │ +0000c810: 6570 2074 6869 7320 696e 206d 696e 642c  ep this in mind,
│ │ │ │ +0000c820: 2073 6f20 7468 6174 2079 6f75 2064 6f6e   so that you don
│ │ │ │ +0000c830: 2774 2063 6f6e 7369 6465 7220 7772 6974  't consider writ
│ │ │ │ +0000c840: 696e 6720 6120 5368 6973 6120 6261 636b  ing a Shisa back
│ │ │ │ +0000c850: 656e 640a 666f 7220 796f 7572 206f 776e  end.for your own
│ │ │ │ +0000c860: 2064 6174 6162 6173 6520 6173 2061 2070   database as a p
│ │ │ │ +0000c870: 7572 656c 7920 5368 6973 6869 2073 7065  urely Shishi spe
│ │ │ │ +0000c880: 6369 6669 6320 7072 6f6a 6563 742e 2020  cific project.  
│ │ │ │ +0000c890: 596f 7520 6361 6e2c 2066 6f72 0a65 7861  You can, for.exa
│ │ │ │ +0000c8a0: 6d70 6c65 2c20 6368 6f6f 7365 2074 6f20  mple, choose to 
│ │ │ │ +0000c8b0: 7573 6520 7468 6520 5368 6973 6120 696e  use the Shisa in
│ │ │ │ +0000c8c0: 7465 7266 6163 6520 696e 2079 6f75 7220  terface in your 
│ │ │ │ +0000c8d0: 6f77 6e20 6170 706c 6963 6174 696f 6e73  own applications
│ │ │ │ +0000c8e0: 2074 6f0a 6861 7665 2061 2073 696d 706c   to.have a simpl
│ │ │ │ +0000c8f0: 6520 696e 7465 7266 6163 6520 746f 2079  e interface to y
│ │ │ │ +0000c900: 6f75 7220 7573 6572 2064 6174 6162 6173  our user databas
│ │ │ │ +0000c910: 652e 2020 596f 7572 2065 7870 6572 6965  e.  Your experie
│ │ │ │ +0000c920: 6e63 6520 616e 640a 6665 6564 6261 636b  nce and.feedback
│ │ │ │ +0000c930: 2069 7320 6170 7072 6563 6961 7465 6420   is appreciated 
│ │ │ │ +0000c940: 6966 2079 6f75 2068 6176 6520 6368 6f73  if you have chos
│ │ │ │ +0000c950: 656e 2074 6f20 6578 706c 6f72 6520 7468  en to explore th
│ │ │ │ +0000c960: 6973 2e0a 0a20 2020 4e6f 7465 2074 6861  is...   Note tha
│ │ │ │ +0000c970: 7420 7468 6520 5368 6973 6120 6461 7461  t the Shisa data
│ │ │ │ +0000c980: 6261 7365 2064 6f65 7320 6e6f 7420 6578  base does not ex
│ │ │ │ +0000c990: 706f 7365 2065 7665 7279 7468 696e 6720  pose everything 
│ │ │ │ +0000c9a0: 796f 7520 6d61 7920 7761 6e74 0a74 6f20  you may want.to 
│ │ │ │ +0000c9b0: 6b6e 6f77 2061 626f 7574 2061 2075 7365  know about a use
│ │ │ │ +0000c9c0: 722c 2073 7563 6820 6173 2069 7473 2066  r, such as its f
│ │ │ │ +0000c9d0: 756c 6c20 6875 6d61 6e20 6e61 6d65 2c20  ull human name, 
│ │ │ │ +0000c9e0: 7465 6c65 7068 6f6e 6520 6e75 6d62 6572  telephone number
│ │ │ │ +0000c9f0: 206f 720a 6576 656e 2074 6865 2075 7365   or.even the use
│ │ │ │ +0000ca00: 7227 7320 6c6f 6769 6e20 6163 636f 756e  r's login accoun
│ │ │ │ +0000ca10: 7420 6e61 6d65 206f 7220 686f 6d65 2064  t name or home d
│ │ │ │ +0000ca20: 6972 6563 746f 7279 2e20 2049 7420 6f6e  irectory.  It on
│ │ │ │ +0000ca30: 6c79 2073 746f 7265 730a 7768 6174 2069  ly stores.what i
│ │ │ │ +0000ca40: 7320 6e65 6564 6564 2074 6f20 6175 7468  s needed to auth
│ │ │ │ +0000ca50: 656e 7469 6361 7465 2061 2070 6565 7220  enticate a peer 
│ │ │ │ +0000ca60: 636c 6169 6d69 6e67 2074 6f20 6265 2061  claiming to be a
│ │ │ │ +0000ca70: 6e20 656e 7469 7479 2e20 2054 6875 7320  n entity.  Thus 
│ │ │ │ +0000ca80: 6974 0a64 6f65 7320 6e6f 7420 6d61 6b65  it.does not make
│ │ │ │ +0000ca90: 2073 656e 7365 2074 6f20 7265 706c 6163   sense to replac
│ │ │ │ +0000caa0: 6520 796f 7572 2063 7572 7265 6e74 2075  e your current u
│ │ │ │ +0000cab0: 7365 7220 6461 7461 6261 7365 206f 720a  ser database or.
│ │ │ │ +0000cac0: e280 982f 6574 632f 7061 7373 7764 e280  .../etc/passwd..
│ │ │ │ +0000cad0: 9920 7769 7468 2064 6174 6120 6465 7269  . with data deri
│ │ │ │ +0000cae0: 7665 6420 6672 6f6d 2074 6865 2053 6869  ved from the Shi
│ │ │ │ +0000caf0: 7361 2064 6174 6162 6173 652e 2020 496e  sa database.  In
│ │ │ │ +0000cb00: 7374 6561 642c 2069 7420 6973 0a69 6e74  stead, it is.int
│ │ │ │ +0000cb10: 656e 6465 6420 7468 6174 2079 6f75 2077  ended that you w
│ │ │ │ +0000cb20: 7269 7465 2061 2053 6869 7361 2062 6163  rite a Shisa bac
│ │ │ │ +0000cb30: 6b65 6e64 2074 6861 7420 6578 706f 7274  kend that export
│ │ │ │ +0000cb40: 7320 736f 6d65 206f 6620 7468 650a 696e  s some of the.in
│ │ │ │ +0000cb50: 666f 726d 6174 696f 6e20 7374 6f72 6564  formation stored
│ │ │ │ +0000cb60: 2069 6e20 796f 7572 2075 7365 7220 6461   in your user da
│ │ │ │ +0000cb70: 7461 6261 7365 2e20 2059 6f75 206d 6179  tabase.  You may
│ │ │ │ +0000cb80: 2062 6520 6162 6c65 2074 6f20 7265 706c   be able to repl
│ │ │ │ +0000cb90: 6163 650a 736f 6d65 2065 7869 7374 696e  ace.some existin
│ │ │ │ +0000cba0: 6720 6675 6e63 7469 6f6e 616c 6974 792c  g functionality,
│ │ │ │ +0000cbb0: 2073 7563 6820 6173 2074 6865 2070 6173   such as the pas
│ │ │ │ +0000cbc0: 7377 6f72 6420 6669 656c 6420 696e 20e2  sword field in .
│ │ │ │ +0000cbd0: 8098 2f65 7463 2f70 6173 7377 64e2 8099  ../etc/passwd...
│ │ │ │ +0000cbe0: 0a77 6974 6820 6120 4b65 7262 6572 6f73  .with a Kerberos
│ │ │ │ +0000cbf0: 2050 414d 206d 6f64 756c 652c 2062 7574   PAM module, but
│ │ │ │ +0000cc00: 2074 6865 7265 2069 7320 6e6f 2072 6571   there is no req
│ │ │ │ +0000cc10: 7569 7265 6d65 6e74 2066 6f72 2064 6f69  uirement for doi
│ │ │ │ +0000cc20: 6e67 2073 6f2e 0a0a 1f0a 4669 6c65 3a20  ng so.....File: 
│ │ │ │ +0000cc30: 7368 6973 6869 2e69 6e66 6f2c 2020 4e6f  shishi.info,  No
│ │ │ │ +0000cc40: 6465 3a20 436f 6e66 6967 7572 696e 6720  de: Configuring 
│ │ │ │ +0000cc50: 5368 6973 612c 2020 4e65 7874 3a20 5573  Shisa,  Next: Us
│ │ │ │ +0000cc60: 696e 6720 5368 6973 612c 2020 5072 6576  ing Shisa,  Prev
│ │ │ │ +0000cc70: 3a20 496e 7472 6f64 7563 7469 6f6e 2074  : Introduction t
│ │ │ │ +0000cc80: 6f20 5368 6973 612c 2020 5570 3a20 4164  o Shisa,  Up: Ad
│ │ │ │ +0000cc90: 6d69 6e69 7374 7261 7469 6f6e 204d 616e  ministration Man
│ │ │ │ +0000cca0: 7561 6c0a 0a33 2e32 2043 6f6e 6669 6775  ual..3.2 Configu
│ │ │ │ +0000ccb0: 7269 6e67 2053 6869 7361 0a3d 3d3d 3d3d  ring Shisa.=====
│ │ │ │ +0000ccc0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ +0000ccd0: 0a0a 5468 6520 636f 6e66 6967 7572 6174  ..The configurat
│ │ │ │ +0000cce0: 696f 6e20 6669 6c65 2066 6f72 2053 6869  ion file for Shi
│ │ │ │ +0000ccf0: 7361 2069 7320 7479 7069 6361 6c6c 7920  sa is typically 
│ │ │ │ +0000cd00: 7374 6f72 6564 2069 6e0a e280 982f 7573  stored in..../us
│ │ │ │ +0000cd10: 722f 6c6f 6361 6c2f 6574 632f 7368 6973  r/local/etc/shis
│ │ │ │ +0000cd20: 6869 2f73 6869 7361 2e63 6f6e 66e2 8099  hi/shisa.conf...
│ │ │ │ +0000cd30: 2e20 2059 6f75 2064 6f20 6e6f 7420 6861  .  You do not ha
│ │ │ │ +0000cd40: 7665 2074 6f20 6d6f 6469 6679 2074 6869  ve to modify thi
│ │ │ │ +0000cd50: 730a 6669 6c65 2c20 7468 6520 6465 6661  s.file, the defa
│ │ │ │ +0000cd60: 756c 7473 2073 686f 756c 6420 6265 2061  ults should be a
│ │ │ │ +0000cd70: 6363 6570 7461 626c 6520 746f 2066 6972  cceptable to fir
│ │ │ │ +0000cd80: 7374 2d74 696d 6520 7573 6572 732e 2020  st-time users.  
│ │ │ │ +0000cd90: 5468 6520 6669 6c65 0a69 7320 7573 6564  The file.is used
│ │ │ │ +0000cda0: 2074 6f20 6465 6669 6e65 2077 6865 7265   to define where
│ │ │ │ +0000cdb0: 2079 6f75 7220 7573 6572 2064 6174 6162   your user datab
│ │ │ │ +0000cdc0: 6173 6520 7265 7369 6465 732c 2061 6e64  ase resides, and
│ │ │ │ +0000cdd0: 2073 6f6d 6520 6f70 7469 6f6e 730a 7375   some options.su
│ │ │ │ +0000cde0: 6368 2061 7320 6d61 6b69 6e67 2074 6865  ch as making the
│ │ │ │ +0000cdf0: 2064 6174 6162 6173 6520 7265 6164 2d6f   database read-o
│ │ │ │ +0000ce00: 6e6c 792c 206f 7220 7768 6574 6865 7220  nly, or whether 
│ │ │ │ +0000ce10: 6572 726f 7273 2064 6574 6563 7465 6420  errors detected 
│ │ │ │ +0000ce20: 7768 656e 0a61 6363 6573 7369 6e67 2074  when.accessing t
│ │ │ │ +0000ce30: 6865 2064 6174 6162 6173 6520 7368 6f75  he database shou
│ │ │ │ +0000ce40: 6c64 2062 6520 6967 6e6f 7265 642e 2020  ld be ignored.  
│ │ │ │ +0000ce50: 2854 6865 206c 6174 7465 7220 636f 756c  (The latter coul
│ │ │ │ +0000ce60: 6420 6265 2075 7365 6675 6c0a 6966 2074  d be useful.if t
│ │ │ │ +0000ce70: 6865 2073 6572 7665 7220 6973 2061 2072  he server is a r
│ │ │ │ +0000ce80: 656d 6f74 6520 4c44 4150 2073 6572 7665  emote LDAP serve
│ │ │ │ +0000ce90: 7220 7468 6174 206d 6967 6874 2062 6520  r that might be 
│ │ │ │ +0000cea0: 756e 6176 6169 6c61 626c 652c 2061 6e64  unavailable, and
│ │ │ │ +0000ceb0: 0a74 6865 6e20 796f 7520 776f 756c 6420  .then you would 
│ │ │ │ +0000cec0: 7761 6e74 2074 6f20 6661 6c6c 2062 6163  want to fall bac
│ │ │ │ +0000ced0: 6b20 746f 2061 206c 6f63 616c 2063 6f70  k to a local cop
│ │ │ │ +0000cee0: 7920 6f66 2074 6865 2064 6174 6162 6173  y of the databas
│ │ │ │ +0000cef0: 652e 290a 0a20 2020 5468 6520 6465 6661  e.)..   The defa
│ │ │ │ +0000cf00: 756c 7420 7769 6c6c 2073 746f 7265 2074  ult will store t
│ │ │ │ +0000cf10: 6865 2075 7365 7220 6461 7461 6261 7365  he user database
│ │ │ │ +0000cf20: 2075 7369 6e67 2064 6972 6563 746f 7269   using directori
│ │ │ │ +0000cf30: 6573 2061 6e64 2066 696c 6573 2c0a 726f  es and files,.ro
│ │ │ │ +0000cf40: 6f74 6564 2062 7920 6465 6661 756c 7420  oted by default 
│ │ │ │ +0000cf50: 696e 20e2 8098 2f75 7372 2f6c 6f63 616c  in .../usr/local
│ │ │ │ +0000cf60: 2f76 6172 2f73 6869 7368 69e2 8099 2e20  /var/shishi.... 
│ │ │ │ +0000cf70: 2059 6f75 2063 616e 2075 7365 2073 7461   You can use sta
│ │ │ │ +0000cf80: 6e64 6172 6420 6669 6c65 0a70 6572 6d69  ndard file.permi
│ │ │ │ +0000cf90: 7373 696f 6e20 7365 7474 696e 6773 2074  ssion settings t
│ │ │ │ +0000cfa0: 6f20 636f 6e74 726f 6c20 6163 6365 7373  o control access
│ │ │ │ +0000cfb0: 2074 6f20 7468 6520 6469 7265 6374 6f72   to the director
│ │ │ │ +0000cfc0: 7920 6869 6572 6172 6368 792e 2020 4974  y hierarchy.  It
│ │ │ │ +0000cfd0: 2069 730a 7374 726f 6e67 6c79 2072 6563   is.strongly rec
│ │ │ │ +0000cfe0: 6f6d 6d65 6e64 6564 2074 6f20 7265 7374  ommended to rest
│ │ │ │ +0000cff0: 7269 6374 2061 6363 6573 7320 746f 2074  rict access to t
│ │ │ │ +0000d000: 6865 2064 6972 6563 746f 7279 2e20 2053  he directory.  S
│ │ │ │ +0000d010: 746f 7269 6e67 2074 6865 0a64 6972 6563  toring the.direc
│ │ │ │ +0000d020: 746f 7279 206f 6e20 6c6f 6361 6c20 7374  tory on local st
│ │ │ │ +0000d030: 6f72 6167 652c 2069 2e65 2e2c 2068 6172  orage, i.e., har
│ │ │ │ +0000d040: 6420 6469 736b 206f 7220 7265 6d6f 7661  d disk or remova
│ │ │ │ +0000d050: 626c 6520 6d65 6469 612c 2069 730a 7265  ble media, is.re
│ │ │ │ +0000d060: 636f 6d6d 656e 6465 642e 2020 5765 2064  commended.  We d
│ │ │ │ +0000d070: 6973 636f 7572 6167 6520 706c 6163 696e  iscourage placin
│ │ │ │ +0000d080: 6720 7468 6520 6461 7461 6261 7365 206f  g the database o
│ │ │ │ +0000d090: 6e20 6120 6e65 7477 6f72 6b20 6669 6c65  n a network file
│ │ │ │ +0000d0a0: 0a73 7973 7465 6d2c 2062 7574 2072 6561  .system, but rea
│ │ │ │ +0000d0b0: 6c69 7a65 2074 6869 7320 6361 6e20 6265  lize this can be
│ │ │ │ +0000d0c0: 2075 7365 6675 6c20 696e 2073 6f6d 6520   useful in some 
│ │ │ │ +0000d0d0: 7369 7475 6174 696f 6e73 2028 2a6e 6f74  situations (*not
│ │ │ │ +0000d0e0: 650a 4d75 6c74 6970 6c65 2073 6572 7665  e.Multiple serve
│ │ │ │ +0000d0f0: 7273 3a3a 292e 0a0a 2020 2053 6565 2074  rs::)...   See t
│ │ │ │ +0000d100: 6865 2072 6566 6572 656e 6365 206d 616e  he reference man
│ │ │ │ +0000d110: 7561 6c20 282a 6e6f 7465 2053 6869 7361  ual (*note Shisa
│ │ │ │ +0000d120: 2043 6f6e 6669 6775 7261 7469 6f6e 3a3a   Configuration::
│ │ │ │ +0000d130: 2920 666f 7220 7468 650a 6465 7461 696c  ) for the.detail
│ │ │ │ +0000d140: 7320 6f66 2074 6865 2063 6f6e 6669 6775  s of the configu
│ │ │ │ +0000d150: 7261 7469 6f6e 2066 696c 652e 2020 4167  ration file.  Ag
│ │ │ │ +0000d160: 6169 6e2c 2079 6f75 2061 7265 206e 6f74  ain, you are not
│ │ │ │ +0000d170: 2065 7870 6563 7465 6420 746f 206e 6565   expected to nee
│ │ │ │ +0000d180: 640a 746f 206d 6f64 6966 7920 616e 7974  d.to modify anyt
│ │ │ │ +0000d190: 6869 6e67 2075 6e6c 6573 7320 796f 7520  hing unless you 
│ │ │ │ +0000d1a0: 6172 6520 616e 2065 7870 6572 6965 6e63  are an experienc
│ │ │ │ +0000d1b0: 6564 2053 6869 7368 6920 6164 6d69 6e69  ed Shishi admini
│ │ │ │ +0000d1c0: 7374 7261 746f 722e 0a0a 1f0a 4669 6c65  strator.....File
│ │ │ │ +0000d1d0: 3a20 7368 6973 6869 2e69 6e66 6f2c 2020  : shishi.info,  
│ │ │ │ +0000d1e0: 4e6f 6465 3a20 5573 696e 6720 5368 6973  Node: Using Shis
│ │ │ │ +0000d1f0: 612c 2020 4e65 7874 3a20 5374 6172 7469  a,  Next: Starti
│ │ │ │ +0000d200: 6e67 2053 6869 7368 6964 2c20 2050 7265  ng Shishid,  Pre
│ │ │ │ +0000d210: 763a 2043 6f6e 6669 6775 7269 6e67 2053  v: Configuring S
│ │ │ │ +0000d220: 6869 7361 2c20 2055 703a 2041 646d 696e  hisa,  Up: Admin
│ │ │ │ +0000d230: 6973 7472 6174 696f 6e20 4d61 6e75 616c  istration Manual
│ │ │ │ +0000d240: 0a0a 332e 3320 5573 696e 6720 5368 6973  ..3.3 Using Shis
│ │ │ │ +0000d250: 610a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  a.==============
│ │ │ │ +0000d260: 3d0a 0a54 6865 7265 2069 7320 6120 636f  =..There is a co
│ │ │ │ +0000d270: 6d6d 616e 6420 6c69 6e65 2069 6e74 6572  mmand line inter
│ │ │ │ +0000d280: 6661 6365 2074 6f20 7468 6520 5368 6973  face to the Shis
│ │ │ │ +0000d290: 6120 6c69 6272 6172 792c 2061 7074 6c79  a library, aptly
│ │ │ │ +0000d2a0: 206e 616d 6564 0ae2 8098 7368 6973 61e2   named....shisa.
│ │ │ │ +0000d2b0: 8099 2e20 2059 6f75 2077 696c 6c20 7573  ...  You will us
│ │ │ │ +0000d2c0: 6520 7468 6973 2074 6f6f 6c20 746f 2061  e this tool to a
│ │ │ │ +0000d2d0: 6464 2c20 7265 6d6f 7665 2c20 616e 6420  dd, remove, and 
│ │ │ │ +0000d2e0: 6368 616e 6765 2069 6e66 6f72 6d61 7469  change informati
│ │ │ │ +0000d2f0: 6f6e 0a73 746f 7265 6420 696e 2074 6865  on.stored in the
│ │ │ │ +0000d300: 2064 6174 6162 6173 6520 6162 6f75 7420   database about 
│ │ │ │ +0000d310: 7265 616c 6d73 2c20 7072 696e 6369 7061  realms, principa
│ │ │ │ +0000d320: 6c73 2c20 616e 6420 6b65 7973 2e20 2054  ls, and keys.  T
│ │ │ │ +0000d330: 6865 2074 6f6f 6c20 6361 6e0a 616c 736f  he tool can.also
│ │ │ │ +0000d340: 2062 6520 7573 6564 2074 6f20 2264 756d   be used to "dum
│ │ │ │ +0000d350: 7022 2061 6c6c 2069 6e66 6f72 6d61 7469  p" all informati
│ │ │ │ +0000d360: 6f6e 2069 6e20 7468 6520 6461 7461 6261  on in the databa
│ │ │ │ +0000d370: 7365 2c20 666f 7220 6261 636b 7570 206f  se, for backup o
│ │ │ │ +0000d380: 720a 6465 6275 6767 696e 6720 7075 7270  r.debugging purp
│ │ │ │ +0000d390: 6f73 6573 2e20 2028 4375 7272 656e 746c  oses.  (Currentl
│ │ │ │ +0000d3a0: 7920 7468 6520 6f75 7470 7574 2066 6f72  y the output for
│ │ │ │ +0000d3b0: 6d61 7420 6361 6e6e 6f74 2062 6520 7265  mat cannot be re
│ │ │ │ +0000d3c0: 6164 2062 7920 616e 790a 746f 6f6c 2c20  ad by any.tool, 
│ │ │ │ +0000d3d0: 6275 7420 6675 6e63 7469 6f6e 616c 6974  but functionalit
│ │ │ │ +0000d3e0: 7920 746f 2064 6f20 7468 6973 2077 696c  y to do this wil
│ │ │ │ +0000d3f0: 6c20 6265 2061 6464 6564 2069 6e20 7468  l be added in th
│ │ │ │ +0000d400: 6520 6675 7475 7265 2c20 706f 7373 6962  e future, possib
│ │ │ │ +0000d410: 6c79 0a61 7320 6120 7265 6164 2d6f 6e6c  ly.as a read-onl
│ │ │ │ +0000d420: 7920 6669 6c65 2d62 6173 6564 2053 6869  y file-based Shi
│ │ │ │ +0000d430: 7361 2064 6174 6162 6173 6520 6261 636b  sa database back
│ │ │ │ +0000d440: 656e 642e 290a 0a20 2020 5468 6520 7265  end.)..   The re
│ │ │ │ +0000d450: 6665 7265 6e63 6520 6d61 6e75 616c 2028  ference manual (
│ │ │ │ +0000d460: 2a6e 6f74 6520 5061 7261 6d65 7465 7273  *note Parameters
│ │ │ │ +0000d470: 2066 6f72 2073 6869 7361 3a3a 2920 6578   for shisa::) ex
│ │ │ │ +0000d480: 706c 6169 6e73 2061 6c6c 0a70 6172 616d  plains all.param
│ │ │ │ +0000d490: 6574 6572 732c 2062 7574 2068 6572 6520  eters, but here 
│ │ │ │ +0000d4a0: 7765 2077 696c 6c20 6769 7665 2079 6f75  we will give you
│ │ │ │ +0000d4b0: 2061 2077 616c 6b2d 7468 726f 7567 6820   a walk-through 
│ │ │ │ +0000d4c0: 6f66 2074 6865 2074 7970 6963 616c 2075  of the typical u
│ │ │ │ +0000d4d0: 7365 730a 6f66 2074 6865 2074 6f6f 6c2e  ses.of the tool.
│ │ │ │ +0000d4e0: 0a0a 2020 2049 6e73 7461 6c6c 696e 6720  ..   Installing 
│ │ │ │ +0000d4f0: 5368 6973 6869 2075 7375 616c 6c79 2063  Shishi usually c
│ │ │ │ +0000d500: 7265 6174 6573 2061 2072 6561 6c6d 2077  reates a realm w
│ │ │ │ +0000d510: 6974 6820 7477 6f20 7072 696e 6369 7061  ith two principa
│ │ │ │ +0000d520: 6c73 3a20 6f6e 650a 7469 636b 6574 2067  ls: one.ticket g
│ │ │ │ +0000d530: 7261 6e74 696e 6720 7469 636b 6574 2066  ranting ticket f
│ │ │ │ +0000d540: 6f72 2074 6865 2072 6561 6c6d 2c20 616e  or the realm, an
│ │ │ │ +0000d550: 6420 6f6e 6520 686f 7374 206b 6579 2066  d one host key f
│ │ │ │ +0000d560: 6f72 2074 6865 2073 6572 7665 722e 0a54  or the server..T
│ │ │ │ +0000d570: 6869 7320 6973 2077 6861 7420 796f 7520  his is what you 
│ │ │ │ +0000d580: 7479 7069 6361 6c6c 7920 6e65 6564 2074  typically need t
│ │ │ │ +0000d590: 6f20 6765 7420 7374 6172 7465 642c 2062  o get started, b
│ │ │ │ +0000d5a0: 7574 2069 7420 646f 6573 6e27 7420 7365  ut it doesn't se
│ │ │ │ +0000d5b0: 7276 6520 6f75 720a 7075 7270 6f73 6573  rve our.purposes
│ │ │ │ +0000d5c0: 2c20 736f 2077 6520 7374 6172 7420 6279  , so we start by
│ │ │ │ +0000d5d0: 2072 656d 6f76 696e 6720 7468 6520 7072   removing the pr
│ │ │ │ +0000d5e0: 696e 6369 7061 6c73 2061 6e64 2074 6865  incipals and the
│ │ │ │ +0000d5f0: 2072 6561 6c6d 2e20 2054 6f20 646f 0a74   realm.  To do.t
│ │ │ │ +0000d600: 6861 742c 2077 6520 6e65 6564 2074 6f20  hat, we need to 
│ │ │ │ +0000d610: 6669 6775 7265 206f 7574 2074 6865 206e  figure out the n
│ │ │ │ +0000d620: 616d 6520 6f66 2074 6865 2072 6561 6c6d  ame of the realm
│ │ │ │ +0000d630: 2e20 2054 6865 20e2 8098 2d2d 6c69 7374  .  The ...--list
│ │ │ │ +0000d640: e280 9920 6f72 0ae2 8098 2d2d 6475 6d70  ... or....--dump
│ │ │ │ +0000d650: e280 9920 7061 7261 6d65 7465 7273 2063  ... parameters c
│ │ │ │ +0000d660: 616e 2062 6520 7573 6564 2066 6f72 2074  an be used for t
│ │ │ │ +0000d670: 6869 732e 2020 284d 6f73 7420 226c 6f6e  his.  (Most "lon
│ │ │ │ +0000d680: 6722 2070 6172 616d 6574 6572 732c 206c  g" parameters, l
│ │ │ │ +0000d690: 696b 650a e280 982d 2d64 756d 70e2 8099  ike....--dump...
│ │ │ │ +0000d6a0: 2c20 6861 7665 2073 686f 7274 6572 206e  , have shorter n
│ │ │ │ +0000d6b0: 616d 6573 2061 7320 7765 6c6c 2c20 696e  ames as well, in
│ │ │ │ +0000d6c0: 2074 6869 7320 6361 7365 20e2 8098 2d64   this case ...-d
│ │ │ │ +0000d6d0: e280 992c 202a 6e6f 7465 0a50 6172 616d  ..., *note.Param
│ │ │ │ +0000d6e0: 6574 6572 7320 666f 7220 7368 6973 613a  eters for shisa:
│ │ │ │ +0000d6f0: 3a29 2e0a 0a20 2020 2020 6a61 7340 6c61  :)...     jas@la
│ │ │ │ +0000d700: 7474 653a 7e24 2073 6869 7361 202d 640a  tte:~$ shisa -d.
│ │ │ │ +0000d710: 2020 2020 206c 6174 7465 0a20 2020 2020       latte.     
│ │ │ │ +0000d720: 2020 2020 2020 2020 6b72 6274 6774 2f6c          krbtgt/l
│ │ │ │ +0000d730: 6174 7465 0a20 2020 2020 2020 2020 2020  atte.           
│ │ │ │ +0000d740: 2020 2020 2020 2020 2020 4163 636f 756e            Accoun
│ │ │ │ +0000d750: 7420 6973 2065 6e61 626c 6564 2e0a 2020  t is enabled..  
│ │ │ │  0000d760: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000d770: 2043 7572 7265 6e74 206b 6579 2076 6572   Current key ver
│ │ │ │ -0000d780: 7369 6f6e 2030 2028 3078 3029 2e0a 2020  sion 0 (0x0)..  
│ │ │ │ +0000d770: 2020 2043 7572 7265 6e74 206b 6579 2076     Current key v
│ │ │ │ +0000d780: 6572 7369 6f6e 2030 2028 3078 3029 2e0a  ersion 0 (0x0)..
│ │ │ │  0000d790: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000d7a0: 2020 204b 6579 2030 2028 3078 3029 2e0a     Key 0 (0x0)..
│ │ │ │ -0000d7b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000d7c0: 2020 2020 2020 2020 2020 2020 2045 7479               Ety
│ │ │ │ -0000d7d0: 7065 2061 6573 3235 362d 6374 732d 686d  pe aes256-cts-hm
│ │ │ │ -0000d7e0: 6163 2d73 6861 312d 3936 2028 3078 3132  ac-sha1-96 (0x12
│ │ │ │ -0000d7f0: 2c20 3138 292e 0a20 2020 2020 2020 2020  , 18)..         
│ │ │ │ +0000d7a0: 2020 2020 204b 6579 2030 2028 3078 3029       Key 0 (0x0)
│ │ │ │ +0000d7b0: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │ +0000d7c0: 2020 2020 2020 2020 2020 2020 2020 2045                 E
│ │ │ │ +0000d7d0: 7479 7065 2061 6573 3235 362d 6374 732d  type aes256-cts-
│ │ │ │ +0000d7e0: 686d 6163 2d73 6861 312d 3936 2028 3078  hmac-sha1-96 (0x
│ │ │ │ +0000d7f0: 3132 2c20 3138 292e 0a20 2020 2020 2020  12, 18)..       
│ │ │ │  0000d800: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000d810: 2020 2020 5361 6c74 206c 6174 7465 6b72      Salt lattekr
│ │ │ │ -0000d820: 6274 6774 2f6c 6174 7465 2e0a 2020 2020  btgt/latte..    
│ │ │ │ -0000d830: 2020 2020 2020 2020 2068 6f73 742f 6c61           host/la
│ │ │ │ -0000d840: 7474 650a 2020 2020 2020 2020 2020 2020  tte.            
│ │ │ │ -0000d850: 2020 2020 2020 2020 2041 6363 6f75 6e74           Account
│ │ │ │ -0000d860: 2069 7320 656e 6162 6c65 642e 0a20 2020   is enabled..   
│ │ │ │ +0000d810: 2020 2020 2020 5361 6c74 206c 6174 7465        Salt latte
│ │ │ │ +0000d820: 6b72 6274 6774 2f6c 6174 7465 2e0a 2020  krbtgt/latte..  
│ │ │ │ +0000d830: 2020 2020 2020 2020 2020 2068 6f73 742f             host/
│ │ │ │ +0000d840: 6c61 7474 650a 2020 2020 2020 2020 2020  latte.          
│ │ │ │ +0000d850: 2020 2020 2020 2020 2020 2041 6363 6f75             Accou
│ │ │ │ +0000d860: 6e74 2069 7320 656e 6162 6c65 642e 0a20  nt is enabled.. 
│ │ │ │  0000d870: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000d880: 2020 4375 7272 656e 7420 6b65 7920 7665    Current key ve
│ │ │ │ -0000d890: 7273 696f 6e20 3020 2830 7830 292e 0a20  rsion 0 (0x0).. 
│ │ │ │ -0000d8a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000d8b0: 2020 2020 4b65 7920 3020 2830 7830 292e      Key 0 (0x0).
│ │ │ │ -0000d8c0: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ -0000d8d0: 2020 2020 2020 2020 2020 2020 2020 4574                Et
│ │ │ │ -0000d8e0: 7970 6520 6165 7332 3536 2d63 7473 2d68  ype aes256-cts-h
│ │ │ │ -0000d8f0: 6d61 632d 7368 6131 2d39 3620 2830 7831  mac-sha1-96 (0x1
│ │ │ │ -0000d900: 322c 2031 3829 2e0a 2020 2020 2020 2020  2, 18)..        
│ │ │ │ +0000d880: 2020 2020 4375 7272 656e 7420 6b65 7920      Current key 
│ │ │ │ +0000d890: 7665 7273 696f 6e20 3020 2830 7830 292e  version 0 (0x0).
│ │ │ │ +0000d8a0: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ +0000d8b0: 2020 2020 2020 4b65 7920 3020 2830 7830        Key 0 (0x0
│ │ │ │ +0000d8c0: 292e 0a20 2020 2020 2020 2020 2020 2020  )..             
│ │ │ │ +0000d8d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0000d8e0: 4574 7970 6520 6165 7332 3536 2d63 7473  Etype aes256-cts
│ │ │ │ +0000d8f0: 2d68 6d61 632d 7368 6131 2d39 3620 2830  -hmac-sha1-96 (0
│ │ │ │ +0000d900: 7831 322c 2031 3829 2e0a 2020 2020 2020  x12, 18)..      
│ │ │ │  0000d910: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000d920: 2020 2020 2053 616c 7420 6c61 7474 6568       Salt latteh
│ │ │ │ -0000d930: 6f73 742f 6c61 7474 652e 0a20 2020 2020  ost/latte..     
│ │ │ │ -0000d940: 6a61 7340 6c61 7474 653a 7e24 0a0a 2020  jas@latte:~$..  
│ │ │ │ -0000d950: 2054 6865 2072 6561 6c6d 206e 616d 6573   The realm names
│ │ │ │ -0000d960: 2061 7265 2070 7269 6e74 6564 2061 7420   are printed at 
│ │ │ │ -0000d970: 636f 6c75 6d6e 2030 2c20 7468 6520 7072  column 0, the pr
│ │ │ │ -0000d980: 696e 6369 7061 6c20 6e61 6d65 7320 6172  incipal names ar
│ │ │ │ -0000d990: 650a 696e 6465 6e74 6564 2077 6974 6820  e.indented with 
│ │ │ │ -0000d9a0: 6f6e 6520 e280 9854 4142 e280 9920 6368  one ...TAB... ch
│ │ │ │ -0000d9b0: 6172 6163 7465 7220 2861 6b61 20e2 8098  aracter (aka ...
│ │ │ │ -0000d9c0: 5c74 e280 9920 6f72 2041 5343 4949 2030  \t... or ASCII 0
│ │ │ │ -0000d9d0: 7830 3920 486f 7269 7a6f 6e74 616c 0a54  x09 Horizontal.T
│ │ │ │ -0000d9e0: 6162 756c 6174 696f 6e29 2c20 616e 6420  abulation), and 
│ │ │ │ -0000d9f0: 7468 6520 696e 666f 726d 6174 696f 6e20  the information 
│ │ │ │ -0000da00: 6162 6f75 7420 6561 6368 2070 7269 6e63  about each princ
│ │ │ │ -0000da10: 6970 616c 2069 7320 696e 6465 6e74 6564  ipal is indented
│ │ │ │ -0000da20: 2077 6974 680a 7477 6f20 e280 9854 4142   with.two ...TAB
│ │ │ │ -0000da30: e280 9920 6368 6172 6163 7465 7273 2e20  ... characters. 
│ │ │ │ -0000da40: 2054 6865 2061 626f 7665 206f 7574 7075   The above outpu
│ │ │ │ -0000da50: 7420 6d65 616e 7320 7468 6174 2074 6865  t means that the
│ │ │ │ -0000da60: 7265 2069 7320 6f6e 6520 7265 616c 6d0a  re is one realm.
│ │ │ │ -0000da70: e280 986c 6174 7465 e280 9920 7769 7468  ...latte... with
│ │ │ │ -0000da80: 2074 776f 2070 7269 6e63 6970 616c 733a   two principals:
│ │ │ │ -0000da90: 20e2 8098 6b72 6274 6774 2f6c 6174 7465   ...krbtgt/latte
│ │ │ │ -0000daa0: e280 9920 2877 6869 6368 2069 7320 7573  ... (which is us
│ │ │ │ -0000dab0: 6564 2074 6f0a 6175 7468 656e 7469 6361  ed to.authentica
│ │ │ │ -0000dac0: 7465 204b 6572 6265 726f 7320 7469 636b  te Kerberos tick
│ │ │ │ -0000dad0: 6574 2072 6571 7565 7374 7329 2061 6e64  et requests) and
│ │ │ │ -0000dae0: 20e2 8098 686f 7374 2f6c 6174 7465 e280   ...host/latte..
│ │ │ │ -0000daf0: 9920 2875 7365 6420 746f 0a61 7574 6865  . (used to.authe
│ │ │ │ -0000db00: 6e74 6963 6174 6520 686f 7374 2d62 6173  nticate host-bas
│ │ │ │ -0000db10: 6564 2061 7070 6c69 6361 7469 6f6e 7320  ed applications 
│ │ │ │ -0000db20: 6c69 6b65 2054 656c 6e65 7429 2e20 2054  like Telnet).  T
│ │ │ │ -0000db30: 6865 7920 7765 7265 2063 7265 6174 6564  hey were created
│ │ │ │ -0000db40: 0a64 7572 696e 6720 e280 986d 616b 6520  .during ...make 
│ │ │ │ -0000db50: 696e 7374 616c 6ce2 8099 206f 6e20 6120  install... on a 
│ │ │ │ -0000db60: 686f 7374 2063 616c 6c65 6420 e280 986c  host called ...l
│ │ │ │ -0000db70: 6174 7465 e280 992e 0a0a 2020 2049 6620  atte......   If 
│ │ │ │ -0000db80: 7468 6520 696e 7374 616c 6c61 7469 6f6e  the installation
│ │ │ │ -0000db90: 2064 6964 206e 6f74 2063 7265 6174 6520   did not create 
│ │ │ │ -0000dba0: 6120 6465 6661 756c 7420 6461 7461 6261  a default databa
│ │ │ │ -0000dbb0: 7365 2066 6f72 2079 6f75 2c20 796f 750a  se for you, you.
│ │ │ │ -0000dbc0: 6d69 6768 7420 6765 7420 616e 2065 7272  might get an err
│ │ │ │ -0000dbd0: 6f72 2073 696d 696c 6172 2074 6f20 7468  or similar to th
│ │ │ │ -0000dbe0: 6520 666f 6c6c 6f77 696e 6720 6f75 7470  e following outp
│ │ │ │ -0000dbf0: 7574 2e0a 0a20 2020 2020 6a61 7340 6c61  ut...     jas@la
│ │ │ │ -0000dc00: 7474 653a 7e24 2073 6869 7361 202d 640a  tte:~$ shisa -d.
│ │ │ │ -0000dc10: 2020 2020 2073 6869 7361 3a20 4361 6e6e       shisa: Cann
│ │ │ │ -0000dc20: 6f74 2069 6e69 7469 616c 697a 6520 6066  ot initialize `f
│ │ │ │ -0000dc30: 696c 6527 2064 6174 6162 6173 6520 6261  ile' database ba
│ │ │ │ -0000dc40: 636b 656e 642e 0a20 2020 2020 4c6f 6361  ckend..     Loca
│ │ │ │ -0000dc50: 7469 6f6e 2060 2f75 7372 2f6c 6f63 616c  tion `/usr/local
│ │ │ │ -0000dc60: 2f76 6172 2f73 6869 7368 6927 2061 6e64  /var/shishi' and
│ │ │ │ -0000dc70: 206f 7074 696f 6e73 2060 4e2f 4127 2e0a   options `N/A'..
│ │ │ │ -0000dc80: 2020 2020 2073 6869 7361 3a20 496e 6974       shisa: Init
│ │ │ │ -0000dc90: 6961 6c69 7a61 7469 6f6e 2066 6169 6c65  ialization faile
│ │ │ │ -0000dca0: 643a 0a20 2020 2020 5368 6973 6120 6461  d:.     Shisa da
│ │ │ │ -0000dcb0: 7461 6261 7365 2063 6f75 6c64 206e 6f74  tabase could not
│ │ │ │ -0000dcc0: 2062 6520 6f70 656e 6564 2e0a 2020 2020   be opened..    
│ │ │ │ -0000dcd0: 206a 6173 406c 6174 7465 3a7e 240a 0a20   jas@latte:~$.. 
│ │ │ │ -0000dce0: 2020 5468 6973 2069 6e64 6963 6174 6573    This indicates
│ │ │ │ -0000dcf0: 2074 6861 7420 7468 6520 6461 7461 6261   that the databa
│ │ │ │ -0000dd00: 7365 2064 6f65 7320 6e6f 7420 6578 6973  se does not exis
│ │ │ │ -0000dd10: 742e 2020 466f 7220 6120 6669 6c65 0a64  t.  For a file.d
│ │ │ │ -0000dd20: 6174 6162 6173 652c 2079 6f75 2063 616e  atabase, you can
│ │ │ │ -0000dd30: 2063 7265 6174 6520 6974 2073 696d 706c   create it simpl
│ │ │ │ -0000dd40: 7920 6279 2063 7265 6174 696e 6720 7468  y by creating th
│ │ │ │ -0000dd50: 6520 6469 7265 6374 6f72 792c 2061 730a  e directory, as.
│ │ │ │ -0000dd60: 666f 6c6c 6f77 732e 2020 4e6f 7465 2074  follows.  Note t
│ │ │ │ -0000dd70: 6865 2061 6363 6573 7320 7065 726d 6973  he access permis
│ │ │ │ -0000dd80: 7369 6f6e 2063 6861 6e67 6520 7769 7468  sion change with
│ │ │ │ -0000dd90: 20e2 8098 6368 6d6f 64e2 8099 2e20 2054   ...chmod....  T
│ │ │ │ -0000dda0: 7970 6963 616c 6c79 2074 6865 0ae2 8098  ypically the....
│ │ │ │ -0000ddb0: 726f 6f74 e280 9920 7573 6572 2077 6f75  root... user wou
│ │ │ │ -0000ddc0: 6c64 206f 776e 2074 6865 2066 696c 6573  ld own the files
│ │ │ │ -0000ddd0: 2c20 6275 7420 6173 2074 6865 7365 2065  , but as these e
│ │ │ │ -0000dde0: 7861 6d70 6c65 7320 6465 6d6f 6e73 7472  xamples demonstr
│ │ │ │ -0000ddf0: 6174 652c 0a73 6574 7469 6e67 2075 7020  ate,.setting up 
│ │ │ │ -0000de00: 6120 4b65 7262 6572 6f73 2073 6572 7665  a Kerberos serve
│ │ │ │ -0000de10: 7220 646f 6573 206e 6f74 2072 6571 7569  r does not requi
│ │ │ │ -0000de20: 7265 2072 6f6f 7420 6163 6365 7373 2e20  re root access. 
│ │ │ │ -0000de30: 2049 6e64 6565 642c 2069 740a 6d61 7920   Indeed, it.may 
│ │ │ │ -0000de40: 6265 2070 7275 6465 6e74 2074 6f20 7275  be prudent to ru
│ │ │ │ -0000de50: 6e20 616c 6c20 5368 6973 6869 2061 7070  n all Shishi app
│ │ │ │ -0000de60: 6c69 6361 7469 6f6e 7320 6173 2061 2073  lications as a s
│ │ │ │ -0000de70: 7065 6369 616c 206e 6f6e 2de2 8098 726f  pecial non-...ro
│ │ │ │ -0000de80: 6f74 e280 990a 7573 6572 2c20 616e 6420  ot....user, and 
│ │ │ │ -0000de90: 6861 7665 2061 6c6c 2053 6869 7368 6920  have all Shishi 
│ │ │ │ -0000dea0: 7265 6c61 7465 6420 6669 6c65 7320 6f77  related files ow
│ │ │ │ -0000deb0: 6e65 6420 6279 2074 6861 7420 7573 6572  ned by that user
│ │ │ │ -0000dec0: 2c20 736f 2074 6861 7420 616e 790a 7365  , so that any.se
│ │ │ │ -0000ded0: 6375 7269 7479 2076 756c 6e65 7261 6269  curity vulnerabi
│ │ │ │ -0000dee0: 6c69 7469 6573 2064 6f20 6e6f 7420 6c65  lities do not le
│ │ │ │ -0000def0: 6164 2074 6f20 6120 7379 7374 656d 2063  ad to a system c
│ │ │ │ -0000df00: 6f6d 7072 6f6d 6973 652e 2020 2848 6f77  ompromise.  (How
│ │ │ │ -0000df10: 6576 6572 2c0a 6966 2074 6865 2075 7365  ever,.if the use
│ │ │ │ -0000df20: 7220 6461 7461 6261 7365 2069 7320 6576  r database is ev
│ │ │ │ -0000df30: 6572 2073 746f 6c65 6e2c 2073 7973 7465  er stolen, syste
│ │ │ │ -0000df40: 6d20 636f 6d70 726f 6d69 7365 7320 6f66  m compromises of
│ │ │ │ -0000df50: 206f 7468 6572 2073 7973 7465 6d73 0a6d   other systems.m
│ │ │ │ -0000df60: 6179 2066 6f6c 6c6f 772c 2073 686f 756c  ay follow, shoul
│ │ │ │ -0000df70: 6420 796f 7520 7573 652c 2065 2e67 2e2c  d you use, e.g.,
│ │ │ │ -0000df80: 2061 206b 6572 6265 7269 7a65 6420 5465   a kerberized Te
│ │ │ │ -0000df90: 6c6e 6574 2e29 0a0a 2020 2020 206a 6173  lnet.)..     jas
│ │ │ │ -0000dfa0: 406c 6174 7465 3a7e 2420 6d6b 6469 7220  @latte:~$ mkdir 
│ │ │ │ -0000dfb0: 2f75 7372 2f6c 6f63 616c 2f76 6172 2f73  /usr/local/var/s
│ │ │ │ -0000dfc0: 6869 7368 690a 2020 2020 206a 6173 406c  hishi.     jas@l
│ │ │ │ -0000dfd0: 6174 7465 3a7e 2420 6368 6d6f 6420 676f  atte:~$ chmod go
│ │ │ │ -0000dfe0: 2d72 7778 202f 7573 722f 6c6f 6361 6c2f  -rwx /usr/local/
│ │ │ │ -0000dff0: 7661 722f 7368 6973 6869 0a0a 2020 2042  var/shishi..   B
│ │ │ │ -0000e000: 6163 6b20 746f 2074 6865 2066 6972 7374  ack to the first
│ │ │ │ -0000e010: 2065 7861 6d70 6c65 2c20 7768 6572 6520   example, where 
│ │ │ │ -0000e020: 796f 7520 6861 7665 2061 2072 6561 6c6d  you have a realm
│ │ │ │ -0000e030: 20e2 8098 6c61 7474 65e2 8099 2077 6974   ...latte... wit
│ │ │ │ -0000e040: 6820 736f 6d65 0a70 7269 6e63 6970 616c  h some.principal
│ │ │ │ -0000e050: 732e 2020 5765 2077 616e 7420 746f 2072  s.  We want to r
│ │ │ │ -0000e060: 656d 6f76 6520 7468 6520 7265 616c 6d20  emove the realm 
│ │ │ │ -0000e070: 746f 2064 656d 6f6e 7374 7261 7465 2068  to demonstrate h
│ │ │ │ -0000e080: 6f77 2079 6f75 2063 7265 6174 650a 7468  ow you create.th
│ │ │ │ -0000e090: 6520 7265 616c 6d20 6672 6f6d 2073 6372  e realm from scr
│ │ │ │ -0000e0a0: 6174 6368 2e20 2028 4f66 2063 6f75 7273  atch.  (Of cours
│ │ │ │ -0000e0b0: 652c 2079 6f75 2063 616e 2068 6176 6520  e, you can have 
│ │ │ │ -0000e0c0: 6d6f 7265 2074 6861 6e20 6f6e 6520 7265  more than one re
│ │ │ │ -0000e0d0: 616c 6d20 696e 0a74 6865 2064 6174 6162  alm in.the datab
│ │ │ │ -0000e0e0: 6173 652c 2062 7574 2066 6f72 2074 6869  ase, but for thi
│ │ │ │ -0000e0f0: 7320 6578 616d 706c 6520 7765 2061 7373  s example we ass
│ │ │ │ -0000e100: 756d 6520 796f 7520 7761 6e74 2074 6f20  ume you want to 
│ │ │ │ -0000e110: 7365 7420 7570 2061 2072 6561 6c6d 0a6e  set up a realm.n
│ │ │ │ -0000e120: 616d 6564 2074 6865 2073 616d 6520 6173  amed the same as
│ │ │ │ -0000e130: 2053 6869 7368 6920 6775 6573 7365 6420   Shishi guessed 
│ │ │ │ -0000e140: 796f 7520 776f 756c 6420 6e61 6d65 2069  you would name i
│ │ │ │ -0000e150: 742c 2073 6f20 7468 6520 6578 6973 7469  t, so the existi
│ │ │ │ -0000e160: 6e67 0a72 6561 6c6d 206e 6565 6420 746f  ng.realm need to
│ │ │ │ -0000e170: 2062 6520 7265 6d6f 7665 6420 6669 7273   be removed firs
│ │ │ │ -0000e180: 742e 2920 2054 6865 20e2 8098 2d2d 7265  t.)  The ...--re
│ │ │ │ -0000e190: 6d6f 7665 e280 9920 2873 686f 7274 2066  move... (short f
│ │ │ │ -0000e1a0: 6f72 6d20 e280 982d 72e2 8099 290a 7061  orm ...-r...).pa
│ │ │ │ -0000e1b0: 7261 6d65 7465 7220 6973 2075 7365 6420  rameter is used 
│ │ │ │ -0000e1c0: 666f 7220 7468 6973 2070 7572 706f 7365  for this purpose
│ │ │ │ -0000e1d0: 2c20 6173 2066 6f6c 6c6f 7773 2e0a 0a20  , as follows... 
│ │ │ │ -0000e1e0: 2020 2020 6a61 7340 6c61 7474 653a 7e24      jas@latte:~$
│ │ │ │ -0000e1f0: 2073 6869 7361 202d 7220 6c61 7474 6520   shisa -r latte 
│ │ │ │ -0000e200: 686f 7374 2f6c 6174 7465 0a20 2020 2020  host/latte.     
│ │ │ │ -0000e210: 5265 6d6f 7669 6e67 2070 7269 6e63 6970  Removing princip
│ │ │ │ -0000e220: 616c 2060 686f 7374 2f6c 6174 7465 406c  al `host/latte@l
│ │ │ │ -0000e230: 6174 7465 272e 2e2e 0a20 2020 2020 5265  atte'....     Re
│ │ │ │ -0000e240: 6d6f 7669 6e67 2070 7269 6e63 6970 616c  moving principal
│ │ │ │ -0000e250: 2060 686f 7374 2f6c 6174 7465 406c 6174   `host/latte@lat
│ │ │ │ -0000e260: 7465 272e 2e2e 646f 6e65 0a20 2020 2020  te'...done.     
│ │ │ │ -0000e270: 6a61 7340 6c61 7474 653a 7e24 2073 6869  jas@latte:~$ shi
│ │ │ │ -0000e280: 7361 202d 7220 6c61 7474 6520 6b72 6274  sa -r latte krbt
│ │ │ │ -0000e290: 6774 2f6c 6174 7465 0a20 2020 2020 5265  gt/latte.     Re
│ │ │ │ -0000e2a0: 6d6f 7669 6e67 2070 7269 6e63 6970 616c  moving principal
│ │ │ │ -0000e2b0: 2060 6b72 6274 6774 2f6c 6174 7465 406c   `krbtgt/latte@l
│ │ │ │ -0000e2c0: 6174 7465 272e 2e2e 0a20 2020 2020 5265  atte'....     Re
│ │ │ │ -0000e2d0: 6d6f 7669 6e67 2070 7269 6e63 6970 616c  moving principal
│ │ │ │ -0000e2e0: 2060 6b72 6274 6774 2f6c 6174 7465 406c   `krbtgt/latte@l
│ │ │ │ -0000e2f0: 6174 7465 272e 2e2e 646f 6e65 0a20 2020  atte'...done.   
│ │ │ │ -0000e300: 2020 6a61 7340 6c61 7474 653a 7e24 2073    jas@latte:~$ s
│ │ │ │ -0000e310: 6869 7361 202d 7220 6c61 7474 650a 2020  hisa -r latte.  
│ │ │ │ -0000e320: 2020 2052 656d 6f76 696e 6720 7265 616c     Removing real
│ │ │ │ -0000e330: 6d20 606c 6174 7465 272e 2e2e 0a20 2020  m `latte'....   
│ │ │ │ -0000e340: 2020 5265 6d6f 7669 6e67 2072 6561 6c6d    Removing realm
│ │ │ │ -0000e350: 2060 6c61 7474 6527 2e2e 2e64 6f6e 650a   `latte'...done.
│ │ │ │ -0000e360: 2020 2020 206a 6173 406c 6174 7465 3a7e       jas@latte:~
│ │ │ │ -0000e370: 240a 0a20 2020 596f 7520 6d61 7920 6265  $..   You may be
│ │ │ │ -0000e380: 2061 736b 696e 6720 796f 7572 7365 6c66   asking yourself
│ │ │ │ -0000e390: 2022 5768 6174 2069 6620 7468 6520 7265   "What if the re
│ │ │ │ -0000e3a0: 616c 6d20 6861 7320 6d61 6e79 206d 6f72  alm has many mor
│ │ │ │ -0000e3b0: 650a 7072 696e 6369 7061 6c73 3f22 2e20  e.principals?". 
│ │ │ │ -0000e3c0: 2049 6620 796f 7520 6665 6172 206d 616e   If you fear man
│ │ │ │ -0000e3d0: 7561 6c20 6c61 626f 7220 286f 7220 6120  ual labor (or a 
│ │ │ │ -0000e3e0: 736d 616c 6c20 e280 9873 6564 e280 9920  small ...sed... 
│ │ │ │ -0000e3f0: 7363 7269 7074 2c20 7265 6361 6c6c 0a74  script, recall.t
│ │ │ │ -0000e400: 6865 2066 6f72 6d61 7420 6f66 20e2 8098  he format of ...
│ │ │ │ -0000e410: 2d2d 6c69 7374 e280 993f 292c 2064 6f6e  --list...?), don
│ │ │ │ -0000e420: 2774 2077 6f72 7279 2c20 7468 6572 6520  't worry, there 
│ │ │ │ -0000e430: 6973 2061 20e2 8098 2d2d 666f 7263 65e2  is a ...--force.
│ │ │ │ -0000e440: 8099 2028 7368 6f72 7420 666f 726d 0ae2  .. (short form..
│ │ │ │ -0000e450: 8098 2d66 e280 9929 2066 6c61 672e 2020  ..-f...) flag.  
│ │ │ │ -0000e460: 5573 6520 6974 2077 6974 6820 6361 7265  Use it with care
│ │ │ │ -0000e470: 2e20 2048 6572 6520 6973 2061 2066 6173  .  Here is a fas
│ │ │ │ -0000e480: 7465 7220 7761 7920 746f 2064 6f20 7468  ter way to do th
│ │ │ │ -0000e490: 6520 6162 6f76 653a 0a0a 2020 2020 206a  e above:..     j
│ │ │ │ -0000e4a0: 6173 406c 6174 7465 3a7e 2420 7368 6973  as@latte:~$ shis
│ │ │ │ -0000e4b0: 6120 2d72 206c 6174 7465 202d 660a 2020  a -r latte -f.  
│ │ │ │ -0000e4c0: 2020 2052 656d 6f76 696e 6720 7072 696e     Removing prin
│ │ │ │ -0000e4d0: 6369 7061 6c20 606b 7262 7467 742f 6c61  cipal `krbtgt/la
│ │ │ │ -0000e4e0: 7474 6540 6c61 7474 6527 2e2e 2e0a 2020  tte@latte'....  
│ │ │ │ -0000e4f0: 2020 2052 656d 6f76 696e 6720 7072 696e     Removing prin
│ │ │ │ -0000e500: 6369 7061 6c20 606b 7262 7467 742f 6c61  cipal `krbtgt/la
│ │ │ │ -0000e510: 7474 6540 6c61 7474 6527 2e2e 2e64 6f6e  tte@latte'...don
│ │ │ │ -0000e520: 650a 2020 2020 2052 656d 6f76 696e 6720  e.     Removing 
│ │ │ │ -0000e530: 7072 696e 6369 7061 6c20 6068 6f73 742f  principal `host/
│ │ │ │ -0000e540: 6c61 7474 6540 6c61 7474 6527 2e2e 2e0a  latte@latte'....
│ │ │ │ -0000e550: 2020 2020 2052 656d 6f76 696e 6720 7072       Removing pr
│ │ │ │ -0000e560: 696e 6369 7061 6c20 6068 6f73 742f 6c61  incipal `host/la
│ │ │ │ -0000e570: 7474 6540 6c61 7474 6527 2e2e 2e64 6f6e  tte@latte'...don
│ │ │ │ -0000e580: 650a 2020 2020 2052 656d 6f76 696e 6720  e.     Removing 
│ │ │ │ -0000e590: 7265 616c 6d20 606c 6174 7465 272e 2e2e  realm `latte'...
│ │ │ │ -0000e5a0: 0a20 2020 2020 5265 6d6f 7669 6e67 2072  .     Removing r
│ │ │ │ -0000e5b0: 6561 6c6d 2060 6c61 7474 6527 2e2e 2e64  ealm `latte'...d
│ │ │ │ -0000e5c0: 6f6e 650a 2020 2020 206a 6173 406c 6174  one.     jas@lat
│ │ │ │ -0000e5d0: 7465 3a7e 240a 0a20 2020 596f 7520 7368  te:~$..   You sh
│ │ │ │ -0000e5e0: 6f75 6c64 206e 6f77 2068 6176 6520 6120  ould now have a 
│ │ │ │ -0000e5f0: 776f 726b 696e 672c 2062 7574 2065 6d70  working, but emp
│ │ │ │ -0000e600: 7479 2c20 5368 6973 6120 6461 7461 6261  ty, Shisa databa
│ │ │ │ -0000e610: 7365 2e20 204c 6574 2773 2073 6574 0a75  se.  Let's set.u
│ │ │ │ -0000e620: 7020 7468 6520 7265 616c 6d20 6d61 6e75  p the realm manu
│ │ │ │ -0000e630: 616c 6c79 2c20 7374 6570 2062 7920 7374  ally, step by st
│ │ │ │ -0000e640: 6570 2e20 2054 6865 2066 6972 7374 2073  ep.  The first s
│ │ │ │ -0000e650: 7465 7020 6973 2074 6f20 6465 6369 6465  tep is to decide
│ │ │ │ -0000e660: 206f 6e20 610a 6e61 6d65 2066 6f72 2079   on a.name for y
│ │ │ │ -0000e670: 6f75 7220 7265 616c 6d2e 2020 5468 6520  our realm.  The 
│ │ │ │ -0000e680: 6675 6c6c 2073 746f 7279 2069 7320 6578  full story is ex
│ │ │ │ -0000e690: 706c 6169 6e65 6420 656c 7365 7768 6572  plained elsewher
│ │ │ │ -0000e6a0: 6520 282a 6e6f 7465 2052 6561 6c6d 0a61  e (*note Realm.a
│ │ │ │ -0000e6b0: 6e64 2050 7269 6e63 6970 616c 204e 616d  nd Principal Nam
│ │ │ │ -0000e6c0: 696e 673a 3a29 2c20 6275 7420 7468 6520  ing::), but the 
│ │ │ │ -0000e6d0: 7368 6f72 7420 7374 6f72 7920 6973 2074  short story is t
│ │ │ │ -0000e6e0: 6f20 7461 6b65 2079 6f75 7220 444e 5320  o take your DNS 
│ │ │ │ -0000e6f0: 646f 6d61 696e 0a6e 616d 6520 616e 6420  domain.name and 
│ │ │ │ -0000e700: 7472 616e 736c 6174 6520 6974 2074 6f20  translate it to 
│ │ │ │ -0000e710: 7570 7065 7220 6361 7365 2e20 2046 6f72  upper case.  For
│ │ │ │ -0000e720: 2065 7861 6d70 6c65 2c20 6966 2079 6f75   example, if you
│ │ │ │ -0000e730: 7220 6f72 6761 6e69 7a61 7469 6f6e 0a75  r organization.u
│ │ │ │ -0000e740: 7365 7320 e280 9865 7861 6d70 6c65 2e6f  ses ...example.o
│ │ │ │ -0000e750: 7267 e280 9920 6974 2069 7320 6120 676f  rg... it is a go
│ │ │ │ -0000e760: 6f64 2069 6465 6120 746f 2075 7365 20e2  od idea to use .
│ │ │ │ -0000e770: 8098 4558 414d 504c 452e 4f52 47e2 8099  ..EXAMPLE.ORG...
│ │ │ │ -0000e780: 2061 7320 7468 6520 6e61 6d65 206f 660a   as the name of.
│ │ │ │ -0000e790: 796f 7572 204b 6572 6265 726f 7320 7265  your Kerberos re
│ │ │ │ -0000e7a0: 616c 6d2e 2020 5765 276c 6c20 7573 6520  alm.  We'll use 
│ │ │ │ -0000e7b0: e280 9845 5841 4d50 4c45 2e4f 5247 e280  ...EXAMPLE.ORG..
│ │ │ │ -0000e7c0: 9920 6173 2074 6865 2072 6561 6c6d 206e  . as the realm n
│ │ │ │ -0000e7d0: 616d 6520 696e 2074 6865 7365 0a65 7861  ame in these.exa
│ │ │ │ -0000e7e0: 6d70 6c65 732e 2020 4c65 7427 7320 6372  mples.  Let's cr
│ │ │ │ -0000e7f0: 6561 7465 2074 6865 2072 6561 6c6d 2e0a  eate the realm..
│ │ │ │ -0000e800: 0a20 2020 2020 6a61 7340 6c61 7474 653a  .     jas@latte:
│ │ │ │ -0000e810: 7e24 2073 6869 7361 202d 6120 4558 414d  ~$ shisa -a EXAM
│ │ │ │ -0000e820: 504c 452e 4f52 470a 2020 2020 2041 6464  PLE.ORG.     Add
│ │ │ │ -0000e830: 696e 6720 7265 616c 6d20 6045 5841 4d50  ing realm `EXAMP
│ │ │ │ -0000e840: 4c45 2e4f 5247 272e 2e2e 0a20 2020 2020  LE.ORG'....     
│ │ │ │ -0000e850: 4164 6469 6e67 2072 6561 6c6d 2060 4558  Adding realm `EX
│ │ │ │ -0000e860: 414d 504c 452e 4f52 4727 2e2e 2e64 6f6e  AMPLE.ORG'...don
│ │ │ │ -0000e870: 650a 2020 2020 206a 6173 406c 6174 7465  e.     jas@latte
│ │ │ │ -0000e880: 3a7e 240a 0a20 2020 4375 7272 656e 746c  :~$..   Currentl
│ │ │ │ -0000e890: 792c 2074 6865 7265 2061 7265 206e 6f20  y, there are no 
│ │ │ │ -0000e8a0: 7072 6f70 6572 7469 6573 2061 7373 6f63  properties assoc
│ │ │ │ -0000e8b0: 6961 7465 6420 7769 7468 2065 6e74 6972  iated with entir
│ │ │ │ -0000e8c0: 6520 7265 616c 6d73 2e20 2049 6e0a 7468  e realms.  In.th
│ │ │ │ -0000e8d0: 6520 6675 7475 7265 2c20 6974 206d 6179  e future, it may
│ │ │ │ -0000e8e0: 2062 6520 706f 7373 6962 6c65 2074 6f20   be possible to 
│ │ │ │ -0000e8f0: 7365 7420 6120 6465 6661 756c 7420 7265  set a default re
│ │ │ │ -0000e900: 616c 6d2d 7769 6465 2070 6173 7377 6f72  alm-wide passwor
│ │ │ │ -0000e910: 640a 6578 7069 7279 2070 6f6c 6963 7920  d.expiry policy 
│ │ │ │ -0000e920: 6f72 2073 696d 696c 6172 2e20 2045 6163  or similar.  Eac
│ │ │ │ -0000e930: 6820 7265 616c 6d20 6e6f 726d 616c 6c79  h realm normally
│ │ │ │ -0000e940: 2068 6173 206f 6e65 2070 7269 6e63 6970   has one princip
│ │ │ │ -0000e950: 616c 2074 6861 7420 6973 0a75 7365 6420  al that is.used 
│ │ │ │ -0000e960: 666f 7220 6175 7468 656e 7469 6361 7469  for authenticati
│ │ │ │ -0000e970: 6e67 2061 6761 696e 7374 2074 6865 2022  ng against the "
│ │ │ │ -0000e980: 7469 636b 6574 2067 7261 6e74 696e 6720  ticket granting 
│ │ │ │ -0000e990: 7365 7276 6963 6522 206f 6e20 7468 650a  service" on the.
│ │ │ │ -0000e9a0: 4b65 7262 6572 6f73 2073 6572 7665 7220  Kerberos server 
│ │ │ │ -0000e9b0: 7769 7468 2061 2074 6963 6b65 7420 696e  with a ticket in
│ │ │ │ -0000e9c0: 7374 6561 6420 6f66 2075 7369 6e67 2074  stead of using t
│ │ │ │ -0000e9d0: 6865 2070 6173 7377 6f72 642e 2020 5468  he password.  Th
│ │ │ │ -0000e9e0: 6973 2069 730a 7573 6564 2062 7920 7468  is is.used by th
│ │ │ │ -0000e9f0: 6520 7573 6572 2077 6865 6e20 7368 6520  e user when she 
│ │ │ │ -0000ea00: 6163 7175 6972 6520 6120 7469 636b 6574  acquire a ticket
│ │ │ │ -0000ea10: 2066 6f72 2061 2073 6572 7665 722e 2020   for a server.  
│ │ │ │ -0000ea20: 5468 6520 7072 696e 6369 7061 6c0a 6d75  The principal.mu
│ │ │ │ -0000ea30: 7374 206c 6f6f 6b20 6c69 6b65 20e2 8098  st look like ...
│ │ │ │ -0000ea40: 6b72 6274 6774 2f52 4541 4c4d e280 9920  krbtgt/REALM... 
│ │ │ │ -0000ea50: 282a 6e6f 7465 204e 616d 6520 6f66 2074  (*note Name of t
│ │ │ │ -0000ea60: 6865 2054 4753 3a20 6b72 6274 6774 2e29  he TGS: krbtgt.)
│ │ │ │ -0000ea70: 2e20 204c 6574 2773 0a63 7265 6174 6520  .  Let's.create 
│ │ │ │ -0000ea80: 6974 2e0a 0a20 2020 2020 6a61 7340 6c61  it...     jas@la
│ │ │ │ -0000ea90: 7474 653a 7e24 2073 6869 7361 202d 6120  tte:~$ shisa -a 
│ │ │ │ -0000eaa0: 4558 414d 504c 452e 4f52 4720 6b72 6274  EXAMPLE.ORG krbt
│ │ │ │ -0000eab0: 6774 2f45 5841 4d50 4c45 2e4f 5247 0a20  gt/EXAMPLE.ORG. 
│ │ │ │ -0000eac0: 2020 2020 4164 6469 6e67 2070 7269 6e63      Adding princ
│ │ │ │ -0000ead0: 6970 616c 2060 6b72 6274 6774 2f45 5841  ipal `krbtgt/EXA
│ │ │ │ -0000eae0: 4d50 4c45 2e4f 5247 4045 5841 4d50 4c45  MPLE.ORG@EXAMPLE
│ │ │ │ -0000eaf0: 2e4f 5247 272e 2e2e 0a20 2020 2020 4164  .ORG'....     Ad
│ │ │ │ -0000eb00: 6469 6e67 2070 7269 6e63 6970 616c 2060  ding principal `
│ │ │ │ -0000eb10: 6b72 6274 6774 2f45 5841 4d50 4c45 2e4f  krbtgt/EXAMPLE.O
│ │ │ │ -0000eb20: 5247 4045 5841 4d50 4c45 2e4f 5247 272e  RG@EXAMPLE.ORG'.
│ │ │ │ -0000eb30: 2e2e 646f 6e65 0a20 2020 2020 6a61 7340  ..done.     jas@
│ │ │ │ -0000eb40: 6c61 7474 653a 7e24 0a0a 2020 204e 6f77  latte:~$..   Now
│ │ │ │ -0000eb50: 2074 6861 7420 7761 736e 2774 2064 6966   that wasn't dif
│ │ │ │ -0000eb60: 6669 6375 6c74 2c20 616c 7468 6f75 6768  ficult, although
│ │ │ │ -0000eb70: 206e 6f74 2076 6572 7920 7361 7469 7366   not very satisf
│ │ │ │ -0000eb80: 7969 6e67 2065 6974 6865 722e 2020 5768  ying either.  Wh
│ │ │ │ -0000eb90: 6174 0a64 6f65 7320 6164 6469 6e67 2061  at.does adding a
│ │ │ │ -0000eba0: 2070 7269 6e63 6970 616c 206d 6561 6e3f   principal mean?
│ │ │ │ -0000ebb0: 2020 5468 6520 6e61 6d65 2069 7320 6372    The name is cr
│ │ │ │ -0000ebc0: 6561 7465 642c 206f 6276 696f 7573 6c79  eated, obviously
│ │ │ │ -0000ebd0: 2c20 6275 7420 6974 0a61 6c73 6f20 6d65  , but it.also me
│ │ │ │ -0000ebe0: 616e 7320 7365 7474 696e 6720 6120 6665  ans setting a fe
│ │ │ │ -0000ebf0: 7720 7661 6c75 6573 2069 6e20 7468 6520  w values in the 
│ │ │ │ -0000ec00: 6461 7461 6261 7365 2e20 204c 6574 2773  database.  Let's
│ │ │ │ -0000ec10: 2076 6965 7720 7468 6520 656e 7472 790a   view the entry.
│ │ │ │ -0000ec20: 746f 2066 696e 6420 6f75 7420 7768 6963  to find out whic
│ │ │ │ -0000ec30: 6820 7661 6c75 6573 2e0a 0a20 2020 2020  h values...     
│ │ │ │ -0000ec40: 6a61 7340 6c61 7474 653a 7e24 2073 6869  jas@latte:~$ shi
│ │ │ │ -0000ec50: 7361 202d 640a 2020 2020 2045 5841 4d50  sa -d.     EXAMP
│ │ │ │ -0000ec60: 4c45 2e4f 5247 0a20 2020 2020 2020 2020  LE.ORG.         
│ │ │ │ -0000ec70: 2020 2020 6b72 6274 6774 2f45 5841 4d50      krbtgt/EXAMP
│ │ │ │ -0000ec80: 4c45 2e4f 5247 0a20 2020 2020 2020 2020  LE.ORG.         
│ │ │ │ -0000ec90: 2020 2020 2020 2020 2020 2020 4163 636f              Acco
│ │ │ │ -0000eca0: 756e 7420 6973 2065 6e61 626c 6564 2e0a  unt is enabled..
│ │ │ │ -0000ecb0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000ecc0: 2020 2020 2043 7572 7265 6e74 206b 6579       Current key
│ │ │ │ -0000ecd0: 2076 6572 7369 6f6e 2030 2028 3078 3029   version 0 (0x0)
│ │ │ │ -0000ece0: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │ -0000ecf0: 2020 2020 2020 204b 6579 2030 2028 3078         Key 0 (0x
│ │ │ │ -0000ed00: 3029 2e0a 2020 2020 2020 2020 2020 2020  0)..            
│ │ │ │ +0000d920: 2020 2020 2020 2053 616c 7420 6c61 7474         Salt latt
│ │ │ │ +0000d930: 6568 6f73 742f 6c61 7474 652e 0a20 2020  ehost/latte..   
│ │ │ │ +0000d940: 2020 6a61 7340 6c61 7474 653a 7e24 0a0a    jas@latte:~$..
│ │ │ │ +0000d950: 2020 2054 6865 2072 6561 6c6d 206e 616d     The realm nam
│ │ │ │ +0000d960: 6573 2061 7265 2070 7269 6e74 6564 2061  es are printed a
│ │ │ │ +0000d970: 7420 636f 6c75 6d6e 2030 2c20 7468 6520  t column 0, the 
│ │ │ │ +0000d980: 7072 696e 6369 7061 6c20 6e61 6d65 7320  principal names 
│ │ │ │ +0000d990: 6172 650a 696e 6465 6e74 6564 2077 6974  are.indented wit
│ │ │ │ +0000d9a0: 6820 6f6e 6520 e280 9854 4142 e280 9920  h one ...TAB... 
│ │ │ │ +0000d9b0: 6368 6172 6163 7465 7220 2861 6b61 20e2  character (aka .
│ │ │ │ +0000d9c0: 8098 5c74 e280 9920 6f72 2041 5343 4949  ..\t... or ASCII
│ │ │ │ +0000d9d0: 2030 7830 3920 486f 7269 7a6f 6e74 616c   0x09 Horizontal
│ │ │ │ +0000d9e0: 0a54 6162 756c 6174 696f 6e29 2c20 616e  .Tabulation), an
│ │ │ │ +0000d9f0: 6420 7468 6520 696e 666f 726d 6174 696f  d the informatio
│ │ │ │ +0000da00: 6e20 6162 6f75 7420 6561 6368 2070 7269  n about each pri
│ │ │ │ +0000da10: 6e63 6970 616c 2069 7320 696e 6465 6e74  ncipal is indent
│ │ │ │ +0000da20: 6564 2077 6974 680a 7477 6f20 e280 9854  ed with.two ...T
│ │ │ │ +0000da30: 4142 e280 9920 6368 6172 6163 7465 7273  AB... characters
│ │ │ │ +0000da40: 2e20 2054 6865 2061 626f 7665 206f 7574  .  The above out
│ │ │ │ +0000da50: 7075 7420 6d65 616e 7320 7468 6174 2074  put means that t
│ │ │ │ +0000da60: 6865 7265 2069 7320 6f6e 6520 7265 616c  here is one real
│ │ │ │ +0000da70: 6d0a e280 986c 6174 7465 e280 9920 7769  m....latte... wi
│ │ │ │ +0000da80: 7468 2074 776f 2070 7269 6e63 6970 616c  th two principal
│ │ │ │ +0000da90: 733a 20e2 8098 6b72 6274 6774 2f6c 6174  s: ...krbtgt/lat
│ │ │ │ +0000daa0: 7465 e280 9920 2877 6869 6368 2069 7320  te... (which is 
│ │ │ │ +0000dab0: 7573 6564 2074 6f0a 6175 7468 656e 7469  used to.authenti
│ │ │ │ +0000dac0: 6361 7465 204b 6572 6265 726f 7320 7469  cate Kerberos ti
│ │ │ │ +0000dad0: 636b 6574 2072 6571 7565 7374 7329 2061  cket requests) a
│ │ │ │ +0000dae0: 6e64 20e2 8098 686f 7374 2f6c 6174 7465  nd ...host/latte
│ │ │ │ +0000daf0: e280 9920 2875 7365 6420 746f 0a61 7574  ... (used to.aut
│ │ │ │ +0000db00: 6865 6e74 6963 6174 6520 686f 7374 2d62  henticate host-b
│ │ │ │ +0000db10: 6173 6564 2061 7070 6c69 6361 7469 6f6e  ased application
│ │ │ │ +0000db20: 7320 6c69 6b65 2054 656c 6e65 7429 2e20  s like Telnet). 
│ │ │ │ +0000db30: 2054 6865 7920 7765 7265 2063 7265 6174   They were creat
│ │ │ │ +0000db40: 6564 0a64 7572 696e 6720 e280 986d 616b  ed.during ...mak
│ │ │ │ +0000db50: 6520 696e 7374 616c 6ce2 8099 206f 6e20  e install... on 
│ │ │ │ +0000db60: 6120 686f 7374 2063 616c 6c65 6420 e280  a host called ..
│ │ │ │ +0000db70: 986c 6174 7465 e280 992e 0a0a 2020 2049  .latte......   I
│ │ │ │ +0000db80: 6620 7468 6520 696e 7374 616c 6c61 7469  f the installati
│ │ │ │ +0000db90: 6f6e 2064 6964 206e 6f74 2063 7265 6174  on did not creat
│ │ │ │ +0000dba0: 6520 6120 6465 6661 756c 7420 6461 7461  e a default data
│ │ │ │ +0000dbb0: 6261 7365 2066 6f72 2079 6f75 2c20 796f  base for you, yo
│ │ │ │ +0000dbc0: 750a 6d69 6768 7420 6765 7420 616e 2065  u.might get an e
│ │ │ │ +0000dbd0: 7272 6f72 2073 696d 696c 6172 2074 6f20  rror similar to 
│ │ │ │ +0000dbe0: 7468 6520 666f 6c6c 6f77 696e 6720 6f75  the following ou
│ │ │ │ +0000dbf0: 7470 7574 2e0a 0a20 2020 2020 6a61 7340  tput...     jas@
│ │ │ │ +0000dc00: 6c61 7474 653a 7e24 2073 6869 7361 202d  latte:~$ shisa -
│ │ │ │ +0000dc10: 640a 2020 2020 2073 6869 7361 3a20 4361  d.     shisa: Ca
│ │ │ │ +0000dc20: 6e6e 6f74 2069 6e69 7469 616c 697a 6520  nnot initialize 
│ │ │ │ +0000dc30: 6066 696c 6527 2064 6174 6162 6173 6520  `file' database 
│ │ │ │ +0000dc40: 6261 636b 656e 642e 0a20 2020 2020 4c6f  backend..     Lo
│ │ │ │ +0000dc50: 6361 7469 6f6e 2060 2f75 7372 2f6c 6f63  cation `/usr/loc
│ │ │ │ +0000dc60: 616c 2f76 6172 2f73 6869 7368 6927 2061  al/var/shishi' a
│ │ │ │ +0000dc70: 6e64 206f 7074 696f 6e73 2060 4e2f 4127  nd options `N/A'
│ │ │ │ +0000dc80: 2e0a 2020 2020 2073 6869 7361 3a20 496e  ..     shisa: In
│ │ │ │ +0000dc90: 6974 6961 6c69 7a61 7469 6f6e 2066 6169  itialization fai
│ │ │ │ +0000dca0: 6c65 643a 0a20 2020 2020 5368 6973 6120  led:.     Shisa 
│ │ │ │ +0000dcb0: 6461 7461 6261 7365 2063 6f75 6c64 206e  database could n
│ │ │ │ +0000dcc0: 6f74 2062 6520 6f70 656e 6564 2e0a 2020  ot be opened..  
│ │ │ │ +0000dcd0: 2020 206a 6173 406c 6174 7465 3a7e 240a     jas@latte:~$.
│ │ │ │ +0000dce0: 0a20 2020 5468 6973 2069 6e64 6963 6174  .   This indicat
│ │ │ │ +0000dcf0: 6573 2074 6861 7420 7468 6520 6461 7461  es that the data
│ │ │ │ +0000dd00: 6261 7365 2064 6f65 7320 6e6f 7420 6578  base does not ex
│ │ │ │ +0000dd10: 6973 742e 2020 466f 7220 6120 6669 6c65  ist.  For a file
│ │ │ │ +0000dd20: 0a64 6174 6162 6173 652c 2079 6f75 2063  .database, you c
│ │ │ │ +0000dd30: 616e 2063 7265 6174 6520 6974 2073 696d  an create it sim
│ │ │ │ +0000dd40: 706c 7920 6279 2063 7265 6174 696e 6720  ply by creating 
│ │ │ │ +0000dd50: 7468 6520 6469 7265 6374 6f72 792c 2061  the directory, a
│ │ │ │ +0000dd60: 730a 666f 6c6c 6f77 732e 2020 4e6f 7465  s.follows.  Note
│ │ │ │ +0000dd70: 2074 6865 2061 6363 6573 7320 7065 726d   the access perm
│ │ │ │ +0000dd80: 6973 7369 6f6e 2063 6861 6e67 6520 7769  ission change wi
│ │ │ │ +0000dd90: 7468 20e2 8098 6368 6d6f 64e2 8099 2e20  th ...chmod.... 
│ │ │ │ +0000dda0: 2054 7970 6963 616c 6c79 2074 6865 0ae2   Typically the..
│ │ │ │ +0000ddb0: 8098 726f 6f74 e280 9920 7573 6572 2077  ..root... user w
│ │ │ │ +0000ddc0: 6f75 6c64 206f 776e 2074 6865 2066 696c  ould own the fil
│ │ │ │ +0000ddd0: 6573 2c20 6275 7420 6173 2074 6865 7365  es, but as these
│ │ │ │ +0000dde0: 2065 7861 6d70 6c65 7320 6465 6d6f 6e73   examples demons
│ │ │ │ +0000ddf0: 7472 6174 652c 0a73 6574 7469 6e67 2075  trate,.setting u
│ │ │ │ +0000de00: 7020 6120 4b65 7262 6572 6f73 2073 6572  p a Kerberos ser
│ │ │ │ +0000de10: 7665 7220 646f 6573 206e 6f74 2072 6571  ver does not req
│ │ │ │ +0000de20: 7569 7265 2072 6f6f 7420 6163 6365 7373  uire root access
│ │ │ │ +0000de30: 2e20 2049 6e64 6565 642c 2069 740a 6d61  .  Indeed, it.ma
│ │ │ │ +0000de40: 7920 6265 2070 7275 6465 6e74 2074 6f20  y be prudent to 
│ │ │ │ +0000de50: 7275 6e20 616c 6c20 5368 6973 6869 2061  run all Shishi a
│ │ │ │ +0000de60: 7070 6c69 6361 7469 6f6e 7320 6173 2061  pplications as a
│ │ │ │ +0000de70: 2073 7065 6369 616c 206e 6f6e 2de2 8098   special non-...
│ │ │ │ +0000de80: 726f 6f74 e280 990a 7573 6572 2c20 616e  root....user, an
│ │ │ │ +0000de90: 6420 6861 7665 2061 6c6c 2053 6869 7368  d have all Shish
│ │ │ │ +0000dea0: 6920 7265 6c61 7465 6420 6669 6c65 7320  i related files 
│ │ │ │ +0000deb0: 6f77 6e65 6420 6279 2074 6861 7420 7573  owned by that us
│ │ │ │ +0000dec0: 6572 2c20 736f 2074 6861 7420 616e 790a  er, so that any.
│ │ │ │ +0000ded0: 7365 6375 7269 7479 2076 756c 6e65 7261  security vulnera
│ │ │ │ +0000dee0: 6269 6c69 7469 6573 2064 6f20 6e6f 7420  bilities do not 
│ │ │ │ +0000def0: 6c65 6164 2074 6f20 6120 7379 7374 656d  lead to a system
│ │ │ │ +0000df00: 2063 6f6d 7072 6f6d 6973 652e 2020 2848   compromise.  (H
│ │ │ │ +0000df10: 6f77 6576 6572 2c0a 6966 2074 6865 2075  owever,.if the u
│ │ │ │ +0000df20: 7365 7220 6461 7461 6261 7365 2069 7320  ser database is 
│ │ │ │ +0000df30: 6576 6572 2073 746f 6c65 6e2c 2073 7973  ever stolen, sys
│ │ │ │ +0000df40: 7465 6d20 636f 6d70 726f 6d69 7365 7320  tem compromises 
│ │ │ │ +0000df50: 6f66 206f 7468 6572 2073 7973 7465 6d73  of other systems
│ │ │ │ +0000df60: 0a6d 6179 2066 6f6c 6c6f 772c 2073 686f  .may follow, sho
│ │ │ │ +0000df70: 756c 6420 796f 7520 7573 652c 2065 2e67  uld you use, e.g
│ │ │ │ +0000df80: 2e2c 2061 206b 6572 6265 7269 7a65 6420  ., a kerberized 
│ │ │ │ +0000df90: 5465 6c6e 6574 2e29 0a0a 2020 2020 206a  Telnet.)..     j
│ │ │ │ +0000dfa0: 6173 406c 6174 7465 3a7e 2420 6d6b 6469  as@latte:~$ mkdi
│ │ │ │ +0000dfb0: 7220 2f75 7372 2f6c 6f63 616c 2f76 6172  r /usr/local/var
│ │ │ │ +0000dfc0: 2f73 6869 7368 690a 2020 2020 206a 6173  /shishi.     jas
│ │ │ │ +0000dfd0: 406c 6174 7465 3a7e 2420 6368 6d6f 6420  @latte:~$ chmod 
│ │ │ │ +0000dfe0: 676f 2d72 7778 202f 7573 722f 6c6f 6361  go-rwx /usr/loca
│ │ │ │ +0000dff0: 6c2f 7661 722f 7368 6973 6869 0a0a 2020  l/var/shishi..  
│ │ │ │ +0000e000: 2042 6163 6b20 746f 2074 6865 2066 6972   Back to the fir
│ │ │ │ +0000e010: 7374 2065 7861 6d70 6c65 2c20 7768 6572  st example, wher
│ │ │ │ +0000e020: 6520 796f 7520 6861 7665 2061 2072 6561  e you have a rea
│ │ │ │ +0000e030: 6c6d 20e2 8098 6c61 7474 65e2 8099 2077  lm ...latte... w
│ │ │ │ +0000e040: 6974 6820 736f 6d65 0a70 7269 6e63 6970  ith some.princip
│ │ │ │ +0000e050: 616c 732e 2020 5765 2077 616e 7420 746f  als.  We want to
│ │ │ │ +0000e060: 2072 656d 6f76 6520 7468 6520 7265 616c   remove the real
│ │ │ │ +0000e070: 6d20 746f 2064 656d 6f6e 7374 7261 7465  m to demonstrate
│ │ │ │ +0000e080: 2068 6f77 2079 6f75 2063 7265 6174 650a   how you create.
│ │ │ │ +0000e090: 7468 6520 7265 616c 6d20 6672 6f6d 2073  the realm from s
│ │ │ │ +0000e0a0: 6372 6174 6368 2e20 2028 4f66 2063 6f75  cratch.  (Of cou
│ │ │ │ +0000e0b0: 7273 652c 2079 6f75 2063 616e 2068 6176  rse, you can hav
│ │ │ │ +0000e0c0: 6520 6d6f 7265 2074 6861 6e20 6f6e 6520  e more than one 
│ │ │ │ +0000e0d0: 7265 616c 6d20 696e 0a74 6865 2064 6174  realm in.the dat
│ │ │ │ +0000e0e0: 6162 6173 652c 2062 7574 2066 6f72 2074  abase, but for t
│ │ │ │ +0000e0f0: 6869 7320 6578 616d 706c 6520 7765 2061  his example we a
│ │ │ │ +0000e100: 7373 756d 6520 796f 7520 7761 6e74 2074  ssume you want t
│ │ │ │ +0000e110: 6f20 7365 7420 7570 2061 2072 6561 6c6d  o set up a realm
│ │ │ │ +0000e120: 0a6e 616d 6564 2074 6865 2073 616d 6520  .named the same 
│ │ │ │ +0000e130: 6173 2053 6869 7368 6920 6775 6573 7365  as Shishi guesse
│ │ │ │ +0000e140: 6420 796f 7520 776f 756c 6420 6e61 6d65  d you would name
│ │ │ │ +0000e150: 2069 742c 2073 6f20 7468 6520 6578 6973   it, so the exis
│ │ │ │ +0000e160: 7469 6e67 0a72 6561 6c6d 206e 6565 6420  ting.realm need 
│ │ │ │ +0000e170: 746f 2062 6520 7265 6d6f 7665 6420 6669  to be removed fi
│ │ │ │ +0000e180: 7273 742e 2920 2054 6865 20e2 8098 2d2d  rst.)  The ...--
│ │ │ │ +0000e190: 7265 6d6f 7665 e280 9920 2873 686f 7274  remove... (short
│ │ │ │ +0000e1a0: 2066 6f72 6d20 e280 982d 72e2 8099 290a   form ...-r...).
│ │ │ │ +0000e1b0: 7061 7261 6d65 7465 7220 6973 2075 7365  parameter is use
│ │ │ │ +0000e1c0: 6420 666f 7220 7468 6973 2070 7572 706f  d for this purpo
│ │ │ │ +0000e1d0: 7365 2c20 6173 2066 6f6c 6c6f 7773 2e0a  se, as follows..
│ │ │ │ +0000e1e0: 0a20 2020 2020 6a61 7340 6c61 7474 653a  .     jas@latte:
│ │ │ │ +0000e1f0: 7e24 2073 6869 7361 202d 7220 6c61 7474  ~$ shisa -r latt
│ │ │ │ +0000e200: 6520 686f 7374 2f6c 6174 7465 0a20 2020  e host/latte.   
│ │ │ │ +0000e210: 2020 5265 6d6f 7669 6e67 2070 7269 6e63    Removing princ
│ │ │ │ +0000e220: 6970 616c 2060 686f 7374 2f6c 6174 7465  ipal `host/latte
│ │ │ │ +0000e230: 406c 6174 7465 272e 2e2e 0a20 2020 2020  @latte'....     
│ │ │ │ +0000e240: 5265 6d6f 7669 6e67 2070 7269 6e63 6970  Removing princip
│ │ │ │ +0000e250: 616c 2060 686f 7374 2f6c 6174 7465 406c  al `host/latte@l
│ │ │ │ +0000e260: 6174 7465 272e 2e2e 646f 6e65 0a20 2020  atte'...done.   
│ │ │ │ +0000e270: 2020 6a61 7340 6c61 7474 653a 7e24 2073    jas@latte:~$ s
│ │ │ │ +0000e280: 6869 7361 202d 7220 6c61 7474 6520 6b72  hisa -r latte kr
│ │ │ │ +0000e290: 6274 6774 2f6c 6174 7465 0a20 2020 2020  btgt/latte.     
│ │ │ │ +0000e2a0: 5265 6d6f 7669 6e67 2070 7269 6e63 6970  Removing princip
│ │ │ │ +0000e2b0: 616c 2060 6b72 6274 6774 2f6c 6174 7465  al `krbtgt/latte
│ │ │ │ +0000e2c0: 406c 6174 7465 272e 2e2e 0a20 2020 2020  @latte'....     
│ │ │ │ +0000e2d0: 5265 6d6f 7669 6e67 2070 7269 6e63 6970  Removing princip
│ │ │ │ +0000e2e0: 616c 2060 6b72 6274 6774 2f6c 6174 7465  al `krbtgt/latte
│ │ │ │ +0000e2f0: 406c 6174 7465 272e 2e2e 646f 6e65 0a20  @latte'...done. 
│ │ │ │ +0000e300: 2020 2020 6a61 7340 6c61 7474 653a 7e24      jas@latte:~$
│ │ │ │ +0000e310: 2073 6869 7361 202d 7220 6c61 7474 650a   shisa -r latte.
│ │ │ │ +0000e320: 2020 2020 2052 656d 6f76 696e 6720 7265       Removing re
│ │ │ │ +0000e330: 616c 6d20 606c 6174 7465 272e 2e2e 0a20  alm `latte'.... 
│ │ │ │ +0000e340: 2020 2020 5265 6d6f 7669 6e67 2072 6561      Removing rea
│ │ │ │ +0000e350: 6c6d 2060 6c61 7474 6527 2e2e 2e64 6f6e  lm `latte'...don
│ │ │ │ +0000e360: 650a 2020 2020 206a 6173 406c 6174 7465  e.     jas@latte
│ │ │ │ +0000e370: 3a7e 240a 0a20 2020 596f 7520 6d61 7920  :~$..   You may 
│ │ │ │ +0000e380: 6265 2061 736b 696e 6720 796f 7572 7365  be asking yourse
│ │ │ │ +0000e390: 6c66 2022 5768 6174 2069 6620 7468 6520  lf "What if the 
│ │ │ │ +0000e3a0: 7265 616c 6d20 6861 7320 6d61 6e79 206d  realm has many m
│ │ │ │ +0000e3b0: 6f72 650a 7072 696e 6369 7061 6c73 3f22  ore.principals?"
│ │ │ │ +0000e3c0: 2e20 2049 6620 796f 7520 6665 6172 206d  .  If you fear m
│ │ │ │ +0000e3d0: 616e 7561 6c20 6c61 626f 7220 286f 7220  anual labor (or 
│ │ │ │ +0000e3e0: 6120 736d 616c 6c20 e280 9873 6564 e280  a small ...sed..
│ │ │ │ +0000e3f0: 9920 7363 7269 7074 2c20 7265 6361 6c6c  . script, recall
│ │ │ │ +0000e400: 0a74 6865 2066 6f72 6d61 7420 6f66 20e2  .the format of .
│ │ │ │ +0000e410: 8098 2d2d 6c69 7374 e280 993f 292c 2064  ..--list...?), d
│ │ │ │ +0000e420: 6f6e 2774 2077 6f72 7279 2c20 7468 6572  on't worry, ther
│ │ │ │ +0000e430: 6520 6973 2061 20e2 8098 2d2d 666f 7263  e is a ...--forc
│ │ │ │ +0000e440: 65e2 8099 2028 7368 6f72 7420 666f 726d  e... (short form
│ │ │ │ +0000e450: 0ae2 8098 2d66 e280 9929 2066 6c61 672e  ....-f...) flag.
│ │ │ │ +0000e460: 2020 5573 6520 6974 2077 6974 6820 6361    Use it with ca
│ │ │ │ +0000e470: 7265 2e20 2048 6572 6520 6973 2061 2066  re.  Here is a f
│ │ │ │ +0000e480: 6173 7465 7220 7761 7920 746f 2064 6f20  aster way to do 
│ │ │ │ +0000e490: 7468 6520 6162 6f76 653a 0a0a 2020 2020  the above:..    
│ │ │ │ +0000e4a0: 206a 6173 406c 6174 7465 3a7e 2420 7368   jas@latte:~$ sh
│ │ │ │ +0000e4b0: 6973 6120 2d72 206c 6174 7465 202d 660a  isa -r latte -f.
│ │ │ │ +0000e4c0: 2020 2020 2052 656d 6f76 696e 6720 7072       Removing pr
│ │ │ │ +0000e4d0: 696e 6369 7061 6c20 606b 7262 7467 742f  incipal `krbtgt/
│ │ │ │ +0000e4e0: 6c61 7474 6540 6c61 7474 6527 2e2e 2e0a  latte@latte'....
│ │ │ │ +0000e4f0: 2020 2020 2052 656d 6f76 696e 6720 7072       Removing pr
│ │ │ │ +0000e500: 696e 6369 7061 6c20 606b 7262 7467 742f  incipal `krbtgt/
│ │ │ │ +0000e510: 6c61 7474 6540 6c61 7474 6527 2e2e 2e64  latte@latte'...d
│ │ │ │ +0000e520: 6f6e 650a 2020 2020 2052 656d 6f76 696e  one.     Removin
│ │ │ │ +0000e530: 6720 7072 696e 6369 7061 6c20 6068 6f73  g principal `hos
│ │ │ │ +0000e540: 742f 6c61 7474 6540 6c61 7474 6527 2e2e  t/latte@latte'..
│ │ │ │ +0000e550: 2e0a 2020 2020 2052 656d 6f76 696e 6720  ..     Removing 
│ │ │ │ +0000e560: 7072 696e 6369 7061 6c20 6068 6f73 742f  principal `host/
│ │ │ │ +0000e570: 6c61 7474 6540 6c61 7474 6527 2e2e 2e64  latte@latte'...d
│ │ │ │ +0000e580: 6f6e 650a 2020 2020 2052 656d 6f76 696e  one.     Removin
│ │ │ │ +0000e590: 6720 7265 616c 6d20 606c 6174 7465 272e  g realm `latte'.
│ │ │ │ +0000e5a0: 2e2e 0a20 2020 2020 5265 6d6f 7669 6e67  ...     Removing
│ │ │ │ +0000e5b0: 2072 6561 6c6d 2060 6c61 7474 6527 2e2e   realm `latte'..
│ │ │ │ +0000e5c0: 2e64 6f6e 650a 2020 2020 206a 6173 406c  .done.     jas@l
│ │ │ │ +0000e5d0: 6174 7465 3a7e 240a 0a20 2020 596f 7520  atte:~$..   You 
│ │ │ │ +0000e5e0: 7368 6f75 6c64 206e 6f77 2068 6176 6520  should now have 
│ │ │ │ +0000e5f0: 6120 776f 726b 696e 672c 2062 7574 2065  a working, but e
│ │ │ │ +0000e600: 6d70 7479 2c20 5368 6973 6120 6461 7461  mpty, Shisa data
│ │ │ │ +0000e610: 6261 7365 2e20 204c 6574 2773 2073 6574  base.  Let's set
│ │ │ │ +0000e620: 0a75 7020 7468 6520 7265 616c 6d20 6d61  .up the realm ma
│ │ │ │ +0000e630: 6e75 616c 6c79 2c20 7374 6570 2062 7920  nually, step by 
│ │ │ │ +0000e640: 7374 6570 2e20 2054 6865 2066 6972 7374  step.  The first
│ │ │ │ +0000e650: 2073 7465 7020 6973 2074 6f20 6465 6369   step is to deci
│ │ │ │ +0000e660: 6465 206f 6e20 610a 6e61 6d65 2066 6f72  de on a.name for
│ │ │ │ +0000e670: 2079 6f75 7220 7265 616c 6d2e 2020 5468   your realm.  Th
│ │ │ │ +0000e680: 6520 6675 6c6c 2073 746f 7279 2069 7320  e full story is 
│ │ │ │ +0000e690: 6578 706c 6169 6e65 6420 656c 7365 7768  explained elsewh
│ │ │ │ +0000e6a0: 6572 6520 282a 6e6f 7465 2052 6561 6c6d  ere (*note Realm
│ │ │ │ +0000e6b0: 0a61 6e64 2050 7269 6e63 6970 616c 204e  .and Principal N
│ │ │ │ +0000e6c0: 616d 696e 673a 3a29 2c20 6275 7420 7468  aming::), but th
│ │ │ │ +0000e6d0: 6520 7368 6f72 7420 7374 6f72 7920 6973  e short story is
│ │ │ │ +0000e6e0: 2074 6f20 7461 6b65 2079 6f75 7220 444e   to take your DN
│ │ │ │ +0000e6f0: 5320 646f 6d61 696e 0a6e 616d 6520 616e  S domain.name an
│ │ │ │ +0000e700: 6420 7472 616e 736c 6174 6520 6974 2074  d translate it t
│ │ │ │ +0000e710: 6f20 7570 7065 7220 6361 7365 2e20 2046  o upper case.  F
│ │ │ │ +0000e720: 6f72 2065 7861 6d70 6c65 2c20 6966 2079  or example, if y
│ │ │ │ +0000e730: 6f75 7220 6f72 6761 6e69 7a61 7469 6f6e  our organization
│ │ │ │ +0000e740: 0a75 7365 7320 e280 9865 7861 6d70 6c65  .uses ...example
│ │ │ │ +0000e750: 2e6f 7267 e280 9920 6974 2069 7320 6120  .org... it is a 
│ │ │ │ +0000e760: 676f 6f64 2069 6465 6120 746f 2075 7365  good idea to use
│ │ │ │ +0000e770: 20e2 8098 4558 414d 504c 452e 4f52 47e2   ...EXAMPLE.ORG.
│ │ │ │ +0000e780: 8099 2061 7320 7468 6520 6e61 6d65 206f  .. as the name o
│ │ │ │ +0000e790: 660a 796f 7572 204b 6572 6265 726f 7320  f.your Kerberos 
│ │ │ │ +0000e7a0: 7265 616c 6d2e 2020 5765 276c 6c20 7573  realm.  We'll us
│ │ │ │ +0000e7b0: 6520 e280 9845 5841 4d50 4c45 2e4f 5247  e ...EXAMPLE.ORG
│ │ │ │ +0000e7c0: e280 9920 6173 2074 6865 2072 6561 6c6d  ... as the realm
│ │ │ │ +0000e7d0: 206e 616d 6520 696e 2074 6865 7365 0a65   name in these.e
│ │ │ │ +0000e7e0: 7861 6d70 6c65 732e 2020 4c65 7427 7320  xamples.  Let's 
│ │ │ │ +0000e7f0: 6372 6561 7465 2074 6865 2072 6561 6c6d  create the realm
│ │ │ │ +0000e800: 2e0a 0a20 2020 2020 6a61 7340 6c61 7474  ...     jas@latt
│ │ │ │ +0000e810: 653a 7e24 2073 6869 7361 202d 6120 4558  e:~$ shisa -a EX
│ │ │ │ +0000e820: 414d 504c 452e 4f52 470a 2020 2020 2041  AMPLE.ORG.     A
│ │ │ │ +0000e830: 6464 696e 6720 7265 616c 6d20 6045 5841  dding realm `EXA
│ │ │ │ +0000e840: 4d50 4c45 2e4f 5247 272e 2e2e 0a20 2020  MPLE.ORG'....   
│ │ │ │ +0000e850: 2020 4164 6469 6e67 2072 6561 6c6d 2060    Adding realm `
│ │ │ │ +0000e860: 4558 414d 504c 452e 4f52 4727 2e2e 2e64  EXAMPLE.ORG'...d
│ │ │ │ +0000e870: 6f6e 650a 2020 2020 206a 6173 406c 6174  one.     jas@lat
│ │ │ │ +0000e880: 7465 3a7e 240a 0a20 2020 4375 7272 656e  te:~$..   Curren
│ │ │ │ +0000e890: 746c 792c 2074 6865 7265 2061 7265 206e  tly, there are n
│ │ │ │ +0000e8a0: 6f20 7072 6f70 6572 7469 6573 2061 7373  o properties ass
│ │ │ │ +0000e8b0: 6f63 6961 7465 6420 7769 7468 2065 6e74  ociated with ent
│ │ │ │ +0000e8c0: 6972 6520 7265 616c 6d73 2e20 2049 6e0a  ire realms.  In.
│ │ │ │ +0000e8d0: 7468 6520 6675 7475 7265 2c20 6974 206d  the future, it m
│ │ │ │ +0000e8e0: 6179 2062 6520 706f 7373 6962 6c65 2074  ay be possible t
│ │ │ │ +0000e8f0: 6f20 7365 7420 6120 6465 6661 756c 7420  o set a default 
│ │ │ │ +0000e900: 7265 616c 6d2d 7769 6465 2070 6173 7377  realm-wide passw
│ │ │ │ +0000e910: 6f72 640a 6578 7069 7279 2070 6f6c 6963  ord.expiry polic
│ │ │ │ +0000e920: 7920 6f72 2073 696d 696c 6172 2e20 2045  y or similar.  E
│ │ │ │ +0000e930: 6163 6820 7265 616c 6d20 6e6f 726d 616c  ach realm normal
│ │ │ │ +0000e940: 6c79 2068 6173 206f 6e65 2070 7269 6e63  ly has one princ
│ │ │ │ +0000e950: 6970 616c 2074 6861 7420 6973 0a75 7365  ipal that is.use
│ │ │ │ +0000e960: 6420 666f 7220 6175 7468 656e 7469 6361  d for authentica
│ │ │ │ +0000e970: 7469 6e67 2061 6761 696e 7374 2074 6865  ting against the
│ │ │ │ +0000e980: 2022 7469 636b 6574 2067 7261 6e74 696e   "ticket grantin
│ │ │ │ +0000e990: 6720 7365 7276 6963 6522 206f 6e20 7468  g service" on th
│ │ │ │ +0000e9a0: 650a 4b65 7262 6572 6f73 2073 6572 7665  e.Kerberos serve
│ │ │ │ +0000e9b0: 7220 7769 7468 2061 2074 6963 6b65 7420  r with a ticket 
│ │ │ │ +0000e9c0: 696e 7374 6561 6420 6f66 2075 7369 6e67  instead of using
│ │ │ │ +0000e9d0: 2074 6865 2070 6173 7377 6f72 642e 2020   the password.  
│ │ │ │ +0000e9e0: 5468 6973 2069 730a 7573 6564 2062 7920  This is.used by 
│ │ │ │ +0000e9f0: 7468 6520 7573 6572 2077 6865 6e20 7368  the user when sh
│ │ │ │ +0000ea00: 6520 6163 7175 6972 6520 6120 7469 636b  e acquire a tick
│ │ │ │ +0000ea10: 6574 2066 6f72 2061 2073 6572 7665 722e  et for a server.
│ │ │ │ +0000ea20: 2020 5468 6520 7072 696e 6369 7061 6c0a    The principal.
│ │ │ │ +0000ea30: 6d75 7374 206c 6f6f 6b20 6c69 6b65 20e2  must look like .
│ │ │ │ +0000ea40: 8098 6b72 6274 6774 2f52 4541 4c4d e280  ..krbtgt/REALM..
│ │ │ │ +0000ea50: 9920 282a 6e6f 7465 204e 616d 6520 6f66  . (*note Name of
│ │ │ │ +0000ea60: 2074 6865 2054 4753 3a20 6b72 6274 6774   the TGS: krbtgt
│ │ │ │ +0000ea70: 2e29 2e20 204c 6574 2773 0a63 7265 6174  .).  Let's.creat
│ │ │ │ +0000ea80: 6520 6974 2e0a 0a20 2020 2020 6a61 7340  e it...     jas@
│ │ │ │ +0000ea90: 6c61 7474 653a 7e24 2073 6869 7361 202d  latte:~$ shisa -
│ │ │ │ +0000eaa0: 6120 4558 414d 504c 452e 4f52 4720 6b72  a EXAMPLE.ORG kr
│ │ │ │ +0000eab0: 6274 6774 2f45 5841 4d50 4c45 2e4f 5247  btgt/EXAMPLE.ORG
│ │ │ │ +0000eac0: 0a20 2020 2020 4164 6469 6e67 2070 7269  .     Adding pri
│ │ │ │ +0000ead0: 6e63 6970 616c 2060 6b72 6274 6774 2f45  ncipal `krbtgt/E
│ │ │ │ +0000eae0: 5841 4d50 4c45 2e4f 5247 4045 5841 4d50  XAMPLE.ORG@EXAMP
│ │ │ │ +0000eaf0: 4c45 2e4f 5247 272e 2e2e 0a20 2020 2020  LE.ORG'....     
│ │ │ │ +0000eb00: 4164 6469 6e67 2070 7269 6e63 6970 616c  Adding principal
│ │ │ │ +0000eb10: 2060 6b72 6274 6774 2f45 5841 4d50 4c45   `krbtgt/EXAMPLE
│ │ │ │ +0000eb20: 2e4f 5247 4045 5841 4d50 4c45 2e4f 5247  .ORG@EXAMPLE.ORG
│ │ │ │ +0000eb30: 272e 2e2e 646f 6e65 0a20 2020 2020 6a61  '...done.     ja
│ │ │ │ +0000eb40: 7340 6c61 7474 653a 7e24 0a0a 2020 204e  s@latte:~$..   N
│ │ │ │ +0000eb50: 6f77 2074 6861 7420 7761 736e 2774 2064  ow that wasn't d
│ │ │ │ +0000eb60: 6966 6669 6375 6c74 2c20 616c 7468 6f75  ifficult, althou
│ │ │ │ +0000eb70: 6768 206e 6f74 2076 6572 7920 7361 7469  gh not very sati
│ │ │ │ +0000eb80: 7366 7969 6e67 2065 6974 6865 722e 2020  sfying either.  
│ │ │ │ +0000eb90: 5768 6174 0a64 6f65 7320 6164 6469 6e67  What.does adding
│ │ │ │ +0000eba0: 2061 2070 7269 6e63 6970 616c 206d 6561   a principal mea
│ │ │ │ +0000ebb0: 6e3f 2020 5468 6520 6e61 6d65 2069 7320  n?  The name is 
│ │ │ │ +0000ebc0: 6372 6561 7465 642c 206f 6276 696f 7573  created, obvious
│ │ │ │ +0000ebd0: 6c79 2c20 6275 7420 6974 0a61 6c73 6f20  ly, but it.also 
│ │ │ │ +0000ebe0: 6d65 616e 7320 7365 7474 696e 6720 6120  means setting a 
│ │ │ │ +0000ebf0: 6665 7720 7661 6c75 6573 2069 6e20 7468  few values in th
│ │ │ │ +0000ec00: 6520 6461 7461 6261 7365 2e20 204c 6574  e database.  Let
│ │ │ │ +0000ec10: 2773 2076 6965 7720 7468 6520 656e 7472  's view the entr
│ │ │ │ +0000ec20: 790a 746f 2066 696e 6420 6f75 7420 7768  y.to find out wh
│ │ │ │ +0000ec30: 6963 6820 7661 6c75 6573 2e0a 0a20 2020  ich values...   
│ │ │ │ +0000ec40: 2020 6a61 7340 6c61 7474 653a 7e24 2073    jas@latte:~$ s
│ │ │ │ +0000ec50: 6869 7361 202d 640a 2020 2020 2045 5841  hisa -d.     EXA
│ │ │ │ +0000ec60: 4d50 4c45 2e4f 5247 0a20 2020 2020 2020  MPLE.ORG.       
│ │ │ │ +0000ec70: 2020 2020 2020 6b72 6274 6774 2f45 5841        krbtgt/EXA
│ │ │ │ +0000ec80: 4d50 4c45 2e4f 5247 0a20 2020 2020 2020  MPLE.ORG.       
│ │ │ │ +0000ec90: 2020 2020 2020 2020 2020 2020 2020 4163                Ac
│ │ │ │ +0000eca0: 636f 756e 7420 6973 2065 6e61 626c 6564  count is enabled
│ │ │ │ +0000ecb0: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │ +0000ecc0: 2020 2020 2020 2043 7572 7265 6e74 206b         Current k
│ │ │ │ +0000ecd0: 6579 2076 6572 7369 6f6e 2030 2028 3078  ey version 0 (0x
│ │ │ │ +0000ece0: 3029 2e0a 2020 2020 2020 2020 2020 2020  0)..            
│ │ │ │ +0000ecf0: 2020 2020 2020 2020 204b 6579 2030 2028           Key 0 (
│ │ │ │ +0000ed00: 3078 3029 2e0a 2020 2020 2020 2020 2020  0x0)..          
│ │ │ │  0000ed10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000ed20: 2045 7479 7065 2061 6573 3235 362d 6374   Etype aes256-ct
│ │ │ │ -0000ed30: 732d 686d 6163 2d73 6861 312d 3936 2028  s-hmac-sha1-96 (
│ │ │ │ -0000ed40: 3078 3132 2c20 3138 292e 0a20 2020 2020  0x12, 18)..     
│ │ │ │ +0000ed20: 2020 2045 7479 7065 2061 6573 3235 362d     Etype aes256-
│ │ │ │ +0000ed30: 6374 732d 686d 6163 2d73 6861 312d 3936  cts-hmac-sha1-96
│ │ │ │ +0000ed40: 2028 3078 3132 2c20 3138 292e 0a20 2020   (0x12, 18)..   
│ │ │ │  0000ed50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000ed60: 2020 2020 2020 2020 5361 6c74 2045 5841          Salt EXA
│ │ │ │ -0000ed70: 4d50 4c45 2e4f 5247 6b72 6274 6774 2f45  MPLE.ORGkrbtgt/E
│ │ │ │ -0000ed80: 5841 4d50 4c45 2e4f 5247 2e0a 2020 2020  XAMPLE.ORG..    
│ │ │ │ -0000ed90: 206a 6173 406c 6174 7465 3a7e 240a 0a20   jas@latte:~$.. 
│ │ │ │ -0000eda0: 2020 546f 2075 7365 2068 6f73 7420 6261    To use host ba
│ │ │ │ -0000edb0: 7365 6420 7365 6375 7269 7479 2073 6572  sed security ser
│ │ │ │ -0000edc0: 7669 6365 7320 6c69 6b65 2053 5348 206f  vices like SSH o
│ │ │ │ -0000edd0: 7220 5465 6c6e 6574 2077 6974 6820 4b65  r Telnet with Ke
│ │ │ │ -0000ede0: 7262 6572 6f73 2c0a 6561 6368 2068 6f73  rberos,.each hos
│ │ │ │ -0000edf0: 7420 6d75 7374 2068 6176 6520 6120 6b65  t must have a ke
│ │ │ │ -0000ee00: 7920 7368 6172 6564 2062 6574 7765 656e  y shared between
│ │ │ │ -0000ee10: 2074 6865 2068 6f73 7420 616e 6420 7468   the host and th
│ │ │ │ -0000ee20: 6520 4b44 432e 2054 6865 206b 6579 0a69  e KDC. The key.i
│ │ │ │ -0000ee30: 7320 7479 7069 6361 6c6c 7920 7374 6f72  s typically stor
│ │ │ │ -0000ee40: 6564 2069 6e20 e280 982f 7573 722f 6c6f  ed in .../usr/lo
│ │ │ │ -0000ee50: 6361 6c2f 6574 632f 7368 6973 6869 2f73  cal/etc/shishi/s
│ │ │ │ -0000ee60: 6869 7368 692e 6b65 7973 e280 992e 2020  hishi.keys....  
│ │ │ │ -0000ee70: 5765 2061 7373 756d 650a 796f 7572 2073  We assume.your s
│ │ │ │ -0000ee80: 6572 7665 7220 6973 2063 616c 6c65 6420  erver is called 
│ │ │ │ -0000ee90: e280 986d 6169 6c2e 6578 616d 706c 652e  ...mail.example.
│ │ │ │ -0000eea0: 6f72 67e2 8099 2061 6e64 2077 6520 6372  org... and we cr
│ │ │ │ -0000eeb0: 6561 7465 2074 6865 2070 7269 6e63 6970  eate the princip
│ │ │ │ -0000eec0: 616c 2e0a 546f 2069 6c6c 7573 7472 6174  al..To illustrat
│ │ │ │ -0000eed0: 6520 6120 6e65 7720 7061 7261 6d65 7465  e a new paramete
│ │ │ │ -0000eee0: 722c 2077 6520 616c 736f 2073 6574 2074  r, we also set t
│ │ │ │ -0000eef0: 6865 2073 7065 6369 6669 6320 616c 676f  he specific algo
│ │ │ │ -0000ef00: 7269 7468 6d20 746f 2075 7365 0a62 7920  rithm to use.by 
│ │ │ │ -0000ef10: 7573 696e 6720 7468 6520 e280 982d 2d65  using the ...--e
│ │ │ │ -0000ef20: 6e63 7279 7074 696f 6e2d 7479 7065 e280  ncryption-type..
│ │ │ │ -0000ef30: 9920 2873 686f 7274 2066 6f72 6d20 e280  . (short form ..
│ │ │ │ -0000ef40: 982d 45e2 8099 2920 7061 7261 6d65 7465  .-E...) paramete
│ │ │ │ -0000ef50: 722e 0a0a 2020 2020 206a 6173 406c 6174  r...     jas@lat
│ │ │ │ -0000ef60: 7465 3a7e 2420 7368 6973 6120 2d61 2045  te:~$ shisa -a E
│ │ │ │ -0000ef70: 5841 4d50 4c45 2e4f 5247 2068 6f73 742f  XAMPLE.ORG host/
│ │ │ │ -0000ef80: 6d61 696c 2e65 7861 6d70 6c65 2e6f 7267  mail.example.org
│ │ │ │ -0000ef90: 202d 4520 6465 7333 0a20 2020 2020 4164   -E des3.     Ad
│ │ │ │ -0000efa0: 6469 6e67 2070 7269 6e63 6970 616c 2060  ding principal `
│ │ │ │ -0000efb0: 686f 7374 2f6d 6169 6c2e 6578 616d 706c  host/mail.exampl
│ │ │ │ -0000efc0: 652e 6f72 6740 4558 414d 504c 452e 4f52  e.org@EXAMPLE.OR
│ │ │ │ -0000efd0: 4727 2e2e 2e0a 2020 2020 2041 6464 696e  G'....     Addin
│ │ │ │ -0000efe0: 6720 7072 696e 6369 7061 6c20 6068 6f73  g principal `hos
│ │ │ │ -0000eff0: 742f 6d61 696c 2e65 7861 6d70 6c65 2e6f  t/mail.example.o
│ │ │ │ -0000f000: 7267 4045 5841 4d50 4c45 2e4f 5247 272e  rg@EXAMPLE.ORG'.
│ │ │ │ -0000f010: 2e2e 646f 6e65 0a20 2020 2020 6a61 7340  ..done.     jas@
│ │ │ │ -0000f020: 6c61 7474 653a 7e24 0a0a 2020 2054 6f20  latte:~$..   To 
│ │ │ │ -0000f030: 6578 706f 7274 2074 6865 206b 6579 2c20  export the key, 
│ │ │ │ -0000f040: 7468 6572 6520 6973 2061 6e6f 7468 6572  there is another
│ │ │ │ -0000f050: 2053 6869 7361 2070 6172 616d 6574 6572   Shisa parameter
│ │ │ │ -0000f060: 20e2 8098 2d2d 6b65 7973 e280 9920 7468   ...--keys... th
│ │ │ │ -0000f070: 6174 0a77 696c 6c20 7072 696e 7420 7468  at.will print th
│ │ │ │ -0000f080: 6520 6b65 7920 696e 2061 2066 6f72 6d61  e key in a forma
│ │ │ │ -0000f090: 7420 7468 6174 2069 7320 7265 636f 676e  t that is recogn
│ │ │ │ -0000f0a0: 697a 6564 2062 7920 5368 6973 6869 2e20  ized by Shishi. 
│ │ │ │ -0000f0b0: 204c 6574 2773 2075 7365 0a69 7420 746f   Let's use.it to
│ │ │ │ -0000f0c0: 2070 7269 6e74 2074 6865 2068 6f73 7420   print the host 
│ │ │ │ -0000f0d0: 6b65 792e 0a0a 2020 2020 206a 6173 406c  key...     jas@l
│ │ │ │ -0000f0e0: 6174 7465 3a7e 2420 7368 6973 6120 2d64  atte:~$ shisa -d
│ │ │ │ -0000f0f0: 202d 2d6b 6579 7320 4558 414d 504c 452e   --keys EXAMPLE.
│ │ │ │ -0000f100: 4f52 4720 686f 7374 2f6d 6169 6c2e 6578  ORG host/mail.ex
│ │ │ │ -0000f110: 616d 706c 652e 6f72 670a 2020 2020 2045  ample.org.     E
│ │ │ │ -0000f120: 5841 4d50 4c45 2e4f 5247 0a20 2020 2020  XAMPLE.ORG.     
│ │ │ │ -0000f130: 2020 2020 2020 2020 686f 7374 2f6d 6169          host/mai
│ │ │ │ -0000f140: 6c2e 6578 616d 706c 652e 6f72 670a 2020  l.example.org.  
│ │ │ │ +0000ed60: 2020 2020 2020 2020 2020 5361 6c74 2045            Salt E
│ │ │ │ +0000ed70: 5841 4d50 4c45 2e4f 5247 6b72 6274 6774  XAMPLE.ORGkrbtgt
│ │ │ │ +0000ed80: 2f45 5841 4d50 4c45 2e4f 5247 2e0a 2020  /EXAMPLE.ORG..  
│ │ │ │ +0000ed90: 2020 206a 6173 406c 6174 7465 3a7e 240a     jas@latte:~$.
│ │ │ │ +0000eda0: 0a20 2020 546f 2075 7365 2068 6f73 7420  .   To use host 
│ │ │ │ +0000edb0: 6261 7365 6420 7365 6375 7269 7479 2073  based security s
│ │ │ │ +0000edc0: 6572 7669 6365 7320 6c69 6b65 2053 5348  ervices like SSH
│ │ │ │ +0000edd0: 206f 7220 5465 6c6e 6574 2077 6974 6820   or Telnet with 
│ │ │ │ +0000ede0: 4b65 7262 6572 6f73 2c0a 6561 6368 2068  Kerberos,.each h
│ │ │ │ +0000edf0: 6f73 7420 6d75 7374 2068 6176 6520 6120  ost must have a 
│ │ │ │ +0000ee00: 6b65 7920 7368 6172 6564 2062 6574 7765  key shared betwe
│ │ │ │ +0000ee10: 656e 2074 6865 2068 6f73 7420 616e 6420  en the host and 
│ │ │ │ +0000ee20: 7468 6520 4b44 432e 2054 6865 206b 6579  the KDC. The key
│ │ │ │ +0000ee30: 0a69 7320 7479 7069 6361 6c6c 7920 7374  .is typically st
│ │ │ │ +0000ee40: 6f72 6564 2069 6e20 e280 982f 7573 722f  ored in .../usr/
│ │ │ │ +0000ee50: 6c6f 6361 6c2f 6574 632f 7368 6973 6869  local/etc/shishi
│ │ │ │ +0000ee60: 2f73 6869 7368 692e 6b65 7973 e280 992e  /shishi.keys....
│ │ │ │ +0000ee70: 2020 5765 2061 7373 756d 650a 796f 7572    We assume.your
│ │ │ │ +0000ee80: 2073 6572 7665 7220 6973 2063 616c 6c65   server is calle
│ │ │ │ +0000ee90: 6420 e280 986d 6169 6c2e 6578 616d 706c  d ...mail.exampl
│ │ │ │ +0000eea0: 652e 6f72 67e2 8099 2061 6e64 2077 6520  e.org... and we 
│ │ │ │ +0000eeb0: 6372 6561 7465 2074 6865 2070 7269 6e63  create the princ
│ │ │ │ +0000eec0: 6970 616c 2e0a 546f 2069 6c6c 7573 7472  ipal..To illustr
│ │ │ │ +0000eed0: 6174 6520 6120 6e65 7720 7061 7261 6d65  ate a new parame
│ │ │ │ +0000eee0: 7465 722c 2077 6520 616c 736f 2073 6574  ter, we also set
│ │ │ │ +0000eef0: 2074 6865 2073 7065 6369 6669 6320 616c   the specific al
│ │ │ │ +0000ef00: 676f 7269 7468 6d20 746f 2075 7365 0a62  gorithm to use.b
│ │ │ │ +0000ef10: 7920 7573 696e 6720 7468 6520 e280 982d  y using the ...-
│ │ │ │ +0000ef20: 2d65 6e63 7279 7074 696f 6e2d 7479 7065  -encryption-type
│ │ │ │ +0000ef30: e280 9920 2873 686f 7274 2066 6f72 6d20  ... (short form 
│ │ │ │ +0000ef40: e280 982d 45e2 8099 2920 7061 7261 6d65  ...-E...) parame
│ │ │ │ +0000ef50: 7465 722e 0a0a 2020 2020 206a 6173 406c  ter...     jas@l
│ │ │ │ +0000ef60: 6174 7465 3a7e 2420 7368 6973 6120 2d61  atte:~$ shisa -a
│ │ │ │ +0000ef70: 2045 5841 4d50 4c45 2e4f 5247 2068 6f73   EXAMPLE.ORG hos
│ │ │ │ +0000ef80: 742f 6d61 696c 2e65 7861 6d70 6c65 2e6f  t/mail.example.o
│ │ │ │ +0000ef90: 7267 202d 4520 6465 7333 0a20 2020 2020  rg -E des3.     
│ │ │ │ +0000efa0: 4164 6469 6e67 2070 7269 6e63 6970 616c  Adding principal
│ │ │ │ +0000efb0: 2060 686f 7374 2f6d 6169 6c2e 6578 616d   `host/mail.exam
│ │ │ │ +0000efc0: 706c 652e 6f72 6740 4558 414d 504c 452e  ple.org@EXAMPLE.
│ │ │ │ +0000efd0: 4f52 4727 2e2e 2e0a 2020 2020 2041 6464  ORG'....     Add
│ │ │ │ +0000efe0: 696e 6720 7072 696e 6369 7061 6c20 6068  ing principal `h
│ │ │ │ +0000eff0: 6f73 742f 6d61 696c 2e65 7861 6d70 6c65  ost/mail.example
│ │ │ │ +0000f000: 2e6f 7267 4045 5841 4d50 4c45 2e4f 5247  .org@EXAMPLE.ORG
│ │ │ │ +0000f010: 272e 2e2e 646f 6e65 0a20 2020 2020 6a61  '...done.     ja
│ │ │ │ +0000f020: 7340 6c61 7474 653a 7e24 0a0a 2020 2054  s@latte:~$..   T
│ │ │ │ +0000f030: 6f20 6578 706f 7274 2074 6865 206b 6579  o export the key
│ │ │ │ +0000f040: 2c20 7468 6572 6520 6973 2061 6e6f 7468  , there is anoth
│ │ │ │ +0000f050: 6572 2053 6869 7361 2070 6172 616d 6574  er Shisa paramet
│ │ │ │ +0000f060: 6572 20e2 8098 2d2d 6b65 7973 e280 9920  er ...--keys... 
│ │ │ │ +0000f070: 7468 6174 0a77 696c 6c20 7072 696e 7420  that.will print 
│ │ │ │ +0000f080: 7468 6520 6b65 7920 696e 2061 2066 6f72  the key in a for
│ │ │ │ +0000f090: 6d61 7420 7468 6174 2069 7320 7265 636f  mat that is reco
│ │ │ │ +0000f0a0: 676e 697a 6564 2062 7920 5368 6973 6869  gnized by Shishi
│ │ │ │ +0000f0b0: 2e20 204c 6574 2773 2075 7365 0a69 7420  .  Let's use.it 
│ │ │ │ +0000f0c0: 746f 2070 7269 6e74 2074 6865 2068 6f73  to print the hos
│ │ │ │ +0000f0d0: 7420 6b65 792e 0a0a 2020 2020 206a 6173  t key...     jas
│ │ │ │ +0000f0e0: 406c 6174 7465 3a7e 2420 7368 6973 6120  @latte:~$ shisa 
│ │ │ │ +0000f0f0: 2d64 202d 2d6b 6579 7320 4558 414d 504c  -d --keys EXAMPL
│ │ │ │ +0000f100: 452e 4f52 4720 686f 7374 2f6d 6169 6c2e  E.ORG host/mail.
│ │ │ │ +0000f110: 6578 616d 706c 652e 6f72 670a 2020 2020  example.org.    
│ │ │ │ +0000f120: 2045 5841 4d50 4c45 2e4f 5247 0a20 2020   EXAMPLE.ORG.   
│ │ │ │ +0000f130: 2020 2020 2020 2020 2020 686f 7374 2f6d            host/m
│ │ │ │ +0000f140: 6169 6c2e 6578 616d 706c 652e 6f72 670a  ail.example.org.
│ │ │ │  0000f150: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000f160: 2020 2041 6363 6f75 6e74 2069 7320 656e     Account is en
│ │ │ │ -0000f170: 6162 6c65 642e 0a20 2020 2020 2020 2020  abled..         
│ │ │ │ -0000f180: 2020 2020 2020 2020 2020 2020 4375 7272              Curr
│ │ │ │ -0000f190: 656e 7420 6b65 7920 7665 7273 696f 6e20  ent key version 
│ │ │ │ -0000f1a0: 3020 2830 7830 292e 0a20 2020 2020 2020  0 (0x0)..       
│ │ │ │ -0000f1b0: 2020 2020 2020 2020 2020 2020 2020 4b65                Ke
│ │ │ │ -0000f1c0: 7920 3020 2830 7830 292e 0a20 2020 2020  y 0 (0x0)..     
│ │ │ │ +0000f160: 2020 2020 2041 6363 6f75 6e74 2069 7320       Account is 
│ │ │ │ +0000f170: 656e 6162 6c65 642e 0a20 2020 2020 2020  enabled..       
│ │ │ │ +0000f180: 2020 2020 2020 2020 2020 2020 2020 4375                Cu
│ │ │ │ +0000f190: 7272 656e 7420 6b65 7920 7665 7273 696f  rrent key versio
│ │ │ │ +0000f1a0: 6e20 3020 2830 7830 292e 0a20 2020 2020  n 0 (0x0)..     
│ │ │ │ +0000f1b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0000f1c0: 4b65 7920 3020 2830 7830 292e 0a20 2020  Key 0 (0x0)..   
│ │ │ │  0000f1d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000f1e0: 2020 2020 2020 2020 4574 7970 6520 6465          Etype de
│ │ │ │ -0000f1f0: 7333 2d63 6263 2d73 6861 312d 6b64 2028  s3-cbc-sha1-kd (
│ │ │ │ -0000f200: 3078 3130 2c20 3136 292e 0a20 2020 2020  0x10, 16)..     
│ │ │ │ -0000f210: 2d2d 2d2d 2d42 4547 494e 2053 4849 5348  -----BEGIN SHISH
│ │ │ │ -0000f220: 4920 4b45 592d 2d2d 2d2d 0a20 2020 2020  I KEY-----.     
│ │ │ │ -0000f230: 4b65 7974 7970 653a 2031 3620 2864 6573  Keytype: 16 (des
│ │ │ │ -0000f240: 332d 6362 632d 7368 6131 2d6b 6429 0a20  3-cbc-sha1-kd). 
│ │ │ │ -0000f250: 2020 2020 5072 696e 6369 7061 6c3a 2068      Principal: h
│ │ │ │ -0000f260: 6f73 742f 6d61 696c 2e65 7861 6d70 6c65  ost/mail.example
│ │ │ │ -0000f270: 2e6f 7267 0a20 2020 2020 5265 616c 6d3a  .org.     Realm:
│ │ │ │ -0000f280: 2045 5841 4d50 4c45 2e4f 5247 0a0a 2020   EXAMPLE.ORG..  
│ │ │ │ -0000f290: 2020 2069 5164 4138 6878 6476 4f55 485a     iQdA8hxdvOUHZ
│ │ │ │ -0000f2a0: 4e6c 695a 4a76 376e 6f4d 3032 7258 4856  NliZJv7noM02rXHV
│ │ │ │ -0000f2b0: 3867 710a 2020 2020 202d 2d2d 2d2d 454e  8gq.     -----EN
│ │ │ │ -0000f2c0: 4420 5348 4953 4849 204b 4559 2d2d 2d2d  D SHISHI KEY----
│ │ │ │ -0000f2d0: 2d0a 2020 2020 2020 2020 2020 2020 2020  -.              
│ │ │ │ -0000f2e0: 2020 2020 2020 2020 2020 2020 2020 2053                 S
│ │ │ │ -0000f2f0: 616c 7420 4558 414d 504c 452e 4f52 4768  alt EXAMPLE.ORGh
│ │ │ │ -0000f300: 6f73 742f 6d61 696c 2e65 7861 6d70 6c65  ost/mail.example
│ │ │ │ -0000f310: 2e6f 7267 2e0a 2020 2020 206a 6173 406c  .org..     jas@l
│ │ │ │ -0000f320: 6174 7465 3a7e 240a 0a20 2020 536f 2074  atte:~$..   So t
│ │ │ │ -0000f330: 6f20 7365 7420 7570 2074 6865 2068 6f73  o set up the hos
│ │ │ │ -0000f340: 742c 2073 696d 706c 7920 7265 6469 7265  t, simply redire
│ │ │ │ -0000f350: 6374 206f 7574 7075 7420 746f 2074 6865  ct output to the
│ │ │ │ -0000f360: 2068 6f73 7420 6b65 7920 6669 6c65 2e0a   host key file..
│ │ │ │ -0000f370: 0a20 2020 2020 6a61 7340 6c61 7474 653a  .     jas@latte:
│ │ │ │ -0000f380: 7e24 2073 6869 7361 202d 6420 2d2d 6b65  ~$ shisa -d --ke
│ │ │ │ -0000f390: 7973 2045 5841 4d50 4c45 2e4f 5247 205c  ys EXAMPLE.ORG \
│ │ │ │ -0000f3a0: 0a20 2020 2020 2020 2020 2068 6f73 742f  .          host/
│ │ │ │ -0000f3b0: 6d61 696c 2e65 7861 6d70 6c65 2e6f 7267  mail.example.org
│ │ │ │ -0000f3c0: 203e 3e20 2f75 7372 2f6c 6f63 616c 2f65   >> /usr/local/e
│ │ │ │ -0000f3d0: 7463 2f73 6869 7368 692f 7368 6973 6869  tc/shishi/shishi
│ │ │ │ -0000f3e0: 2e6b 6579 730a 2020 2020 206a 6173 406c  .keys.     jas@l
│ │ │ │ -0000f3f0: 6174 7465 3a7e 240a 0a20 2020 5468 6520  atte:~$..   The 
│ │ │ │ -0000f400: 6e65 7874 206c 6f67 6963 616c 2073 7465  next logical ste
│ │ │ │ -0000f410: 7020 6973 2074 6f20 6372 6561 7465 2061  p is to create a
│ │ │ │ -0000f420: 2070 7269 6e63 6970 616c 2066 6f72 2073   principal for s
│ │ │ │ -0000f430: 6f6d 6520 7573 6572 2c20 736f 2079 6f75  ome user, so you
│ │ │ │ -0000f440: 0a63 616e 2075 7365 2079 6f75 7220 7061  .can use your pa
│ │ │ │ -0000f450: 7373 776f 7264 2074 6f20 6765 7420 6120  ssword to get a 
│ │ │ │ -0000f460: 5469 636b 6574 2047 7261 6e74 696e 6720  Ticket Granting 
│ │ │ │ -0000f470: 5469 636b 6574 2076 6961 2074 6865 0a41  Ticket via the.A
│ │ │ │ -0000f480: 7574 6865 6e74 6963 6174 696f 6e20 5365  uthentication Se
│ │ │ │ -0000f490: 7276 6963 6520 2841 5329 2066 726f 6d20  rvice (AS) from 
│ │ │ │ -0000f4a0: 7468 6520 4b44 432c 2061 6e64 2074 6865  the KDC, and the
│ │ │ │ -0000f4b0: 6e20 7573 6520 7468 6520 5469 636b 6574  n use the Ticket
│ │ │ │ -0000f4c0: 0a47 7261 6e74 696e 6720 5365 7276 6963  .Granting Servic
│ │ │ │ -0000f4d0: 6520 2854 4753 2920 6672 6f6d 2074 6865  e (TGS) from the
│ │ │ │ -0000f4e0: 204b 4443 2074 6f20 6765 7420 6120 7469   KDC to get a ti
│ │ │ │ -0000f4f0: 636b 6574 2066 6f72 2061 2073 7065 6369  cket for a speci
│ │ │ │ -0000f500: 6669 6320 686f 7374 2c0a 616e 6420 7468  fic host,.and th
│ │ │ │ -0000f510: 656e 2073 656e 6420 7468 6174 2074 6963  en send that tic
│ │ │ │ -0000f520: 6b65 7420 746f 2074 6865 2068 6f73 7420  ket to the host 
│ │ │ │ -0000f530: 746f 2061 7574 6865 6e74 6963 6174 6520  to authenticate 
│ │ │ │ -0000f540: 796f 7572 7365 6c66 2e0a 4372 6561 7469  yourself..Creati
│ │ │ │ -0000f550: 6e67 2074 6869 7320 656e 642d 7573 6572  ng this end-user
│ │ │ │ -0000f560: 2070 7269 6e63 6970 6c65 2069 7320 736c   principle is sl
│ │ │ │ -0000f570: 6967 6874 6c79 2064 6966 6665 7265 6e74  ightly different
│ │ │ │ -0000f580: 2066 726f 6d20 7468 6520 6561 726c 6965   from the earlie
│ │ │ │ -0000f590: 720a 7374 6570 732c 2062 6563 6175 7365  r.steps, because
│ │ │ │ -0000f5a0: 2079 6f75 2077 616e 7420 7468 6520 6b65   you want the ke
│ │ │ │ -0000f5b0: 7920 746f 2062 6520 6465 7269 7665 6420  y to be derived 
│ │ │ │ -0000f5c0: 6672 6f6d 2061 2070 6173 7377 6f72 6420  from a password 
│ │ │ │ -0000f5d0: 696e 7374 6561 6420 6f66 0a62 6569 6e67  instead of.being
│ │ │ │ -0000f5e0: 2061 2072 616e 646f 6d20 6b65 792e 2020   a random key.  
│ │ │ │ -0000f5f0: 5468 6520 e280 982d 2d70 6173 7377 6f72  The ...--passwor
│ │ │ │ -0000f600: 64e2 8099 2070 6172 616d 6574 6572 2069  d... parameter i
│ │ │ │ -0000f610: 6e64 6963 6174 6520 7468 6973 2e20 2054  ndicate this.  T
│ │ │ │ -0000f620: 6869 730a 6d61 6b65 2074 6865 2074 6f6f  his.make the too
│ │ │ │ -0000f630: 6c20 6173 6b20 796f 7520 666f 7220 7468  l ask you for th
│ │ │ │ -0000f640: 6520 7061 7373 776f 7264 2e0a 0a20 2020  e password...   
│ │ │ │ -0000f650: 2020 6a61 7340 6c61 7474 653a 7e24 2073    jas@latte:~$ s
│ │ │ │ -0000f660: 6869 7361 202d 6120 4558 414d 504c 452e  hisa -a EXAMPLE.
│ │ │ │ -0000f670: 4f52 4720 7369 6d6f 6e20 2d2d 7061 7373  ORG simon --pass
│ │ │ │ -0000f680: 776f 7264 0a20 2020 2020 5061 7373 776f  word.     Passwo
│ │ │ │ -0000f690: 7264 2066 6f72 2060 7369 6d6f 6e40 4558  rd for `simon@EX
│ │ │ │ -0000f6a0: 414d 504c 452e 4f52 4727 3a0a 2020 2020  AMPLE.ORG':.    
│ │ │ │ -0000f6b0: 2041 6464 696e 6720 7072 696e 6369 7061   Adding principa
│ │ │ │ -0000f6c0: 6c20 6073 696d 6f6e 4045 5841 4d50 4c45  l `simon@EXAMPLE
│ │ │ │ -0000f6d0: 2e4f 5247 272e 2e2e 0a20 2020 2020 4164  .ORG'....     Ad
│ │ │ │ -0000f6e0: 6469 6e67 2070 7269 6e63 6970 616c 2060  ding principal `
│ │ │ │ -0000f6f0: 7369 6d6f 6e40 4558 414d 504c 452e 4f52  simon@EXAMPLE.OR
│ │ │ │ -0000f700: 4727 2e2e 2e64 6f6e 650a 2020 2020 206a  G'...done.     j
│ │ │ │ -0000f710: 6173 406c 6174 7465 3a7e 240a 0a20 2020  as@latte:~$..   
│ │ │ │ -0000f720: 5468 6520 6f6e 6c79 2073 7065 6369 616c  The only special
│ │ │ │ -0000f730: 2074 6869 6e67 2061 626f 7574 2074 6869   thing about thi
│ │ │ │ -0000f740: 7320 7072 696e 6369 7061 6c20 6e6f 7720  s principal now 
│ │ │ │ -0000f750: 6973 2074 6861 7420 6974 2068 6173 2061  is that it has a
│ │ │ │ -0000f760: 0ae2 8098 7061 7373 776f 7264 e280 9920  ....password... 
│ │ │ │ -0000f770: 6669 656c 6420 7365 7420 696e 2074 6865  field set in the
│ │ │ │ -0000f780: 2064 6174 6162 6173 652e 0a0a 2020 2020   database...    
│ │ │ │ -0000f790: 206a 6173 406c 6174 7465 3a7e 2420 7368   jas@latte:~$ sh
│ │ │ │ -0000f7a0: 6973 6120 2d64 2045 5841 4d50 4c45 2e4f  isa -d EXAMPLE.O
│ │ │ │ -0000f7b0: 5247 2073 696d 6f6e 202d 2d6b 6579 730a  RG simon --keys.
│ │ │ │ -0000f7c0: 2020 2020 2045 5841 4d50 4c45 2e4f 5247       EXAMPLE.ORG
│ │ │ │ -0000f7d0: 0a20 2020 2020 2020 2020 2020 2020 7369  .             si
│ │ │ │ -0000f7e0: 6d6f 6e0a 2020 2020 2020 2020 2020 2020  mon.            
│ │ │ │ -0000f7f0: 2020 2020 2020 2020 2041 6363 6f75 6e74           Account
│ │ │ │ -0000f800: 2069 7320 656e 6162 6c65 642e 0a20 2020   is enabled..   
│ │ │ │ +0000f1e0: 2020 2020 2020 2020 2020 4574 7970 6520            Etype 
│ │ │ │ +0000f1f0: 6465 7333 2d63 6263 2d73 6861 312d 6b64  des3-cbc-sha1-kd
│ │ │ │ +0000f200: 2028 3078 3130 2c20 3136 292e 0a20 2020   (0x10, 16)..   
│ │ │ │ +0000f210: 2020 2d2d 2d2d 2d42 4547 494e 2053 4849    -----BEGIN SHI
│ │ │ │ +0000f220: 5348 4920 4b45 592d 2d2d 2d2d 0a20 2020  SHI KEY-----.   
│ │ │ │ +0000f230: 2020 4b65 7974 7970 653a 2031 3620 2864    Keytype: 16 (d
│ │ │ │ +0000f240: 6573 332d 6362 632d 7368 6131 2d6b 6429  es3-cbc-sha1-kd)
│ │ │ │ +0000f250: 0a20 2020 2020 5072 696e 6369 7061 6c3a  .     Principal:
│ │ │ │ +0000f260: 2068 6f73 742f 6d61 696c 2e65 7861 6d70   host/mail.examp
│ │ │ │ +0000f270: 6c65 2e6f 7267 0a20 2020 2020 5265 616c  le.org.     Real
│ │ │ │ +0000f280: 6d3a 2045 5841 4d50 4c45 2e4f 5247 0a0a  m: EXAMPLE.ORG..
│ │ │ │ +0000f290: 2020 2020 2069 5164 4138 6878 6476 4f55       iQdA8hxdvOU
│ │ │ │ +0000f2a0: 485a 4e6c 695a 4a76 376e 6f4d 3032 7258  HZNliZJv7noM02rX
│ │ │ │ +0000f2b0: 4856 3867 710a 2020 2020 202d 2d2d 2d2d  HV8gq.     -----
│ │ │ │ +0000f2c0: 454e 4420 5348 4953 4849 204b 4559 2d2d  END SHISHI KEY--
│ │ │ │ +0000f2d0: 2d2d 2d0a 2020 2020 2020 2020 2020 2020  ---.            
│ │ │ │ +0000f2e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0000f2f0: 2053 616c 7420 4558 414d 504c 452e 4f52   Salt EXAMPLE.OR
│ │ │ │ +0000f300: 4768 6f73 742f 6d61 696c 2e65 7861 6d70  Ghost/mail.examp
│ │ │ │ +0000f310: 6c65 2e6f 7267 2e0a 2020 2020 206a 6173  le.org..     jas
│ │ │ │ +0000f320: 406c 6174 7465 3a7e 240a 0a20 2020 536f  @latte:~$..   So
│ │ │ │ +0000f330: 2074 6f20 7365 7420 7570 2074 6865 2068   to set up the h
│ │ │ │ +0000f340: 6f73 742c 2073 696d 706c 7920 7265 6469  ost, simply redi
│ │ │ │ +0000f350: 7265 6374 206f 7574 7075 7420 746f 2074  rect output to t
│ │ │ │ +0000f360: 6865 2068 6f73 7420 6b65 7920 6669 6c65  he host key file
│ │ │ │ +0000f370: 2e0a 0a20 2020 2020 6a61 7340 6c61 7474  ...     jas@latt
│ │ │ │ +0000f380: 653a 7e24 2073 6869 7361 202d 6420 2d2d  e:~$ shisa -d --
│ │ │ │ +0000f390: 6b65 7973 2045 5841 4d50 4c45 2e4f 5247  keys EXAMPLE.ORG
│ │ │ │ +0000f3a0: 205c 0a20 2020 2020 2020 2020 2068 6f73   \.          hos
│ │ │ │ +0000f3b0: 742f 6d61 696c 2e65 7861 6d70 6c65 2e6f  t/mail.example.o
│ │ │ │ +0000f3c0: 7267 203e 3e20 2f75 7372 2f6c 6f63 616c  rg >> /usr/local
│ │ │ │ +0000f3d0: 2f65 7463 2f73 6869 7368 692f 7368 6973  /etc/shishi/shis
│ │ │ │ +0000f3e0: 6869 2e6b 6579 730a 2020 2020 206a 6173  hi.keys.     jas
│ │ │ │ +0000f3f0: 406c 6174 7465 3a7e 240a 0a20 2020 5468  @latte:~$..   Th
│ │ │ │ +0000f400: 6520 6e65 7874 206c 6f67 6963 616c 2073  e next logical s
│ │ │ │ +0000f410: 7465 7020 6973 2074 6f20 6372 6561 7465  tep is to create
│ │ │ │ +0000f420: 2061 2070 7269 6e63 6970 616c 2066 6f72   a principal for
│ │ │ │ +0000f430: 2073 6f6d 6520 7573 6572 2c20 736f 2079   some user, so y
│ │ │ │ +0000f440: 6f75 0a63 616e 2075 7365 2079 6f75 7220  ou.can use your 
│ │ │ │ +0000f450: 7061 7373 776f 7264 2074 6f20 6765 7420  password to get 
│ │ │ │ +0000f460: 6120 5469 636b 6574 2047 7261 6e74 696e  a Ticket Grantin
│ │ │ │ +0000f470: 6720 5469 636b 6574 2076 6961 2074 6865  g Ticket via the
│ │ │ │ +0000f480: 0a41 7574 6865 6e74 6963 6174 696f 6e20  .Authentication 
│ │ │ │ +0000f490: 5365 7276 6963 6520 2841 5329 2066 726f  Service (AS) fro
│ │ │ │ +0000f4a0: 6d20 7468 6520 4b44 432c 2061 6e64 2074  m the KDC, and t
│ │ │ │ +0000f4b0: 6865 6e20 7573 6520 7468 6520 5469 636b  hen use the Tick
│ │ │ │ +0000f4c0: 6574 0a47 7261 6e74 696e 6720 5365 7276  et.Granting Serv
│ │ │ │ +0000f4d0: 6963 6520 2854 4753 2920 6672 6f6d 2074  ice (TGS) from t
│ │ │ │ +0000f4e0: 6865 204b 4443 2074 6f20 6765 7420 6120  he KDC to get a 
│ │ │ │ +0000f4f0: 7469 636b 6574 2066 6f72 2061 2073 7065  ticket for a spe
│ │ │ │ +0000f500: 6369 6669 6320 686f 7374 2c0a 616e 6420  cific host,.and 
│ │ │ │ +0000f510: 7468 656e 2073 656e 6420 7468 6174 2074  then send that t
│ │ │ │ +0000f520: 6963 6b65 7420 746f 2074 6865 2068 6f73  icket to the hos
│ │ │ │ +0000f530: 7420 746f 2061 7574 6865 6e74 6963 6174  t to authenticat
│ │ │ │ +0000f540: 6520 796f 7572 7365 6c66 2e0a 4372 6561  e yourself..Crea
│ │ │ │ +0000f550: 7469 6e67 2074 6869 7320 656e 642d 7573  ting this end-us
│ │ │ │ +0000f560: 6572 2070 7269 6e63 6970 6c65 2069 7320  er principle is 
│ │ │ │ +0000f570: 736c 6967 6874 6c79 2064 6966 6665 7265  slightly differe
│ │ │ │ +0000f580: 6e74 2066 726f 6d20 7468 6520 6561 726c  nt from the earl
│ │ │ │ +0000f590: 6965 720a 7374 6570 732c 2062 6563 6175  ier.steps, becau
│ │ │ │ +0000f5a0: 7365 2079 6f75 2077 616e 7420 7468 6520  se you want the 
│ │ │ │ +0000f5b0: 6b65 7920 746f 2062 6520 6465 7269 7665  key to be derive
│ │ │ │ +0000f5c0: 6420 6672 6f6d 2061 2070 6173 7377 6f72  d from a passwor
│ │ │ │ +0000f5d0: 6420 696e 7374 6561 6420 6f66 0a62 6569  d instead of.bei
│ │ │ │ +0000f5e0: 6e67 2061 2072 616e 646f 6d20 6b65 792e  ng a random key.
│ │ │ │ +0000f5f0: 2020 5468 6520 e280 982d 2d70 6173 7377    The ...--passw
│ │ │ │ +0000f600: 6f72 64e2 8099 2070 6172 616d 6574 6572  ord... parameter
│ │ │ │ +0000f610: 2069 6e64 6963 6174 6520 7468 6973 2e20   indicate this. 
│ │ │ │ +0000f620: 2054 6869 730a 6d61 6b65 2074 6865 2074   This.make the t
│ │ │ │ +0000f630: 6f6f 6c20 6173 6b20 796f 7520 666f 7220  ool ask you for 
│ │ │ │ +0000f640: 7468 6520 7061 7373 776f 7264 2e0a 0a20  the password... 
│ │ │ │ +0000f650: 2020 2020 6a61 7340 6c61 7474 653a 7e24      jas@latte:~$
│ │ │ │ +0000f660: 2073 6869 7361 202d 6120 4558 414d 504c   shisa -a EXAMPL
│ │ │ │ +0000f670: 452e 4f52 4720 7369 6d6f 6e20 2d2d 7061  E.ORG simon --pa
│ │ │ │ +0000f680: 7373 776f 7264 0a20 2020 2020 5061 7373  ssword.     Pass
│ │ │ │ +0000f690: 776f 7264 2066 6f72 2060 7369 6d6f 6e40  word for `simon@
│ │ │ │ +0000f6a0: 4558 414d 504c 452e 4f52 4727 3a0a 2020  EXAMPLE.ORG':.  
│ │ │ │ +0000f6b0: 2020 2041 6464 696e 6720 7072 696e 6369     Adding princi
│ │ │ │ +0000f6c0: 7061 6c20 6073 696d 6f6e 4045 5841 4d50  pal `simon@EXAMP
│ │ │ │ +0000f6d0: 4c45 2e4f 5247 272e 2e2e 0a20 2020 2020  LE.ORG'....     
│ │ │ │ +0000f6e0: 4164 6469 6e67 2070 7269 6e63 6970 616c  Adding principal
│ │ │ │ +0000f6f0: 2060 7369 6d6f 6e40 4558 414d 504c 452e   `simon@EXAMPLE.
│ │ │ │ +0000f700: 4f52 4727 2e2e 2e64 6f6e 650a 2020 2020  ORG'...done.    
│ │ │ │ +0000f710: 206a 6173 406c 6174 7465 3a7e 240a 0a20   jas@latte:~$.. 
│ │ │ │ +0000f720: 2020 5468 6520 6f6e 6c79 2073 7065 6369    The only speci
│ │ │ │ +0000f730: 616c 2074 6869 6e67 2061 626f 7574 2074  al thing about t
│ │ │ │ +0000f740: 6869 7320 7072 696e 6369 7061 6c20 6e6f  his principal no
│ │ │ │ +0000f750: 7720 6973 2074 6861 7420 6974 2068 6173  w is that it has
│ │ │ │ +0000f760: 2061 0ae2 8098 7061 7373 776f 7264 e280   a....password..
│ │ │ │ +0000f770: 9920 6669 656c 6420 7365 7420 696e 2074  . field set in t
│ │ │ │ +0000f780: 6865 2064 6174 6162 6173 652e 0a0a 2020  he database...  
│ │ │ │ +0000f790: 2020 206a 6173 406c 6174 7465 3a7e 2420     jas@latte:~$ 
│ │ │ │ +0000f7a0: 7368 6973 6120 2d64 2045 5841 4d50 4c45  shisa -d EXAMPLE
│ │ │ │ +0000f7b0: 2e4f 5247 2073 696d 6f6e 202d 2d6b 6579  .ORG simon --key
│ │ │ │ +0000f7c0: 730a 2020 2020 2045 5841 4d50 4c45 2e4f  s.     EXAMPLE.O
│ │ │ │ +0000f7d0: 5247 0a20 2020 2020 2020 2020 2020 2020  RG.             
│ │ │ │ +0000f7e0: 7369 6d6f 6e0a 2020 2020 2020 2020 2020  simon.          
│ │ │ │ +0000f7f0: 2020 2020 2020 2020 2020 2041 6363 6f75             Accou
│ │ │ │ +0000f800: 6e74 2069 7320 656e 6162 6c65 642e 0a20  nt is enabled.. 
│ │ │ │  0000f810: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000f820: 2020 4375 7272 656e 7420 6b65 7920 7665    Current key ve
│ │ │ │ -0000f830: 7273 696f 6e20 3020 2830 7830 292e 0a20  rsion 0 (0x0).. 
│ │ │ │ -0000f840: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000f850: 2020 2020 4b65 7920 3020 2830 7830 292e      Key 0 (0x0).
│ │ │ │ -0000f860: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ -0000f870: 2020 2020 2020 2020 2020 2020 2020 4574                Et
│ │ │ │ -0000f880: 7970 6520 6165 7332 3536 2d63 7473 2d68  ype aes256-cts-h
│ │ │ │ -0000f890: 6d61 632d 7368 6131 2d39 3620 2830 7831  mac-sha1-96 (0x1
│ │ │ │ -0000f8a0: 322c 2031 3829 2e0a 2020 2020 202d 2d2d  2, 18)..     ---
│ │ │ │ -0000f8b0: 2d2d 4245 4749 4e20 5348 4953 4849 204b  --BEGIN SHISHI K
│ │ │ │ -0000f8c0: 4559 2d2d 2d2d 2d0a 2020 2020 204b 6579  EY-----.     Key
│ │ │ │ -0000f8d0: 7479 7065 3a20 3138 2028 6165 7332 3536  type: 18 (aes256
│ │ │ │ -0000f8e0: 2d63 7473 2d68 6d61 632d 7368 6131 2d39  -cts-hmac-sha1-9
│ │ │ │ -0000f8f0: 3629 0a20 2020 2020 5072 696e 6369 7061  6).     Principa
│ │ │ │ -0000f900: 6c3a 2073 696d 6f6e 0a20 2020 2020 5265  l: simon.     Re
│ │ │ │ -0000f910: 616c 6d3a 2045 5841 4d50 4c45 2e4f 5247  alm: EXAMPLE.ORG
│ │ │ │ -0000f920: 0a0a 2020 2020 204a 6137 6369 4e74 7241  ..     Ja7ciNtrA
│ │ │ │ -0000f930: 4933 6774 6f64 4c61 5644 5135 7a68 6348  I3gtodLaVDQ5zhcH
│ │ │ │ -0000f940: 3538 6666 6b30 6b53 3574 4741 4d37 494c  58ffk0kS5tGAM7IL
│ │ │ │ -0000f950: 764d 3d0a 2020 2020 202d 2d2d 2d2d 454e  vM=.     -----EN
│ │ │ │ -0000f960: 4420 5348 4953 4849 204b 4559 2d2d 2d2d  D SHISHI KEY----
│ │ │ │ -0000f970: 2d0a 2020 2020 2020 2020 2020 2020 2020  -.              
│ │ │ │ -0000f980: 2020 2020 2020 2020 2020 2020 2020 2053                 S
│ │ │ │ -0000f990: 616c 7420 4558 414d 504c 452e 4f52 4773  alt EXAMPLE.ORGs
│ │ │ │ -0000f9a0: 696d 6f6e 2e0a 2020 2020 2020 2020 2020  imon..          
│ │ │ │ +0000f820: 2020 2020 4375 7272 656e 7420 6b65 7920      Current key 
│ │ │ │ +0000f830: 7665 7273 696f 6e20 3020 2830 7830 292e  version 0 (0x0).
│ │ │ │ +0000f840: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ +0000f850: 2020 2020 2020 4b65 7920 3020 2830 7830        Key 0 (0x0
│ │ │ │ +0000f860: 292e 0a20 2020 2020 2020 2020 2020 2020  )..             
│ │ │ │ +0000f870: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0000f880: 4574 7970 6520 6165 7332 3536 2d63 7473  Etype aes256-cts
│ │ │ │ +0000f890: 2d68 6d61 632d 7368 6131 2d39 3620 2830  -hmac-sha1-96 (0
│ │ │ │ +0000f8a0: 7831 322c 2031 3829 2e0a 2020 2020 202d  x12, 18)..     -
│ │ │ │ +0000f8b0: 2d2d 2d2d 4245 4749 4e20 5348 4953 4849  ----BEGIN SHISHI
│ │ │ │ +0000f8c0: 204b 4559 2d2d 2d2d 2d0a 2020 2020 204b   KEY-----.     K
│ │ │ │ +0000f8d0: 6579 7479 7065 3a20 3138 2028 6165 7332  eytype: 18 (aes2
│ │ │ │ +0000f8e0: 3536 2d63 7473 2d68 6d61 632d 7368 6131  56-cts-hmac-sha1
│ │ │ │ +0000f8f0: 2d39 3629 0a20 2020 2020 5072 696e 6369  -96).     Princi
│ │ │ │ +0000f900: 7061 6c3a 2073 696d 6f6e 0a20 2020 2020  pal: simon.     
│ │ │ │ +0000f910: 5265 616c 6d3a 2045 5841 4d50 4c45 2e4f  Realm: EXAMPLE.O
│ │ │ │ +0000f920: 5247 0a0a 2020 2020 204a 6137 6369 4e74  RG..     Ja7ciNt
│ │ │ │ +0000f930: 7241 4933 6774 6f64 4c61 5644 5135 7a68  rAI3gtodLaVDQ5zh
│ │ │ │ +0000f940: 6348 3538 6666 6b30 6b53 3574 4741 4d37  cH58ffk0kS5tGAM7
│ │ │ │ +0000f950: 494c 764d 3d0a 2020 2020 202d 2d2d 2d2d  ILvM=.     -----
│ │ │ │ +0000f960: 454e 4420 5348 4953 4849 204b 4559 2d2d  END SHISHI KEY--
│ │ │ │ +0000f970: 2d2d 2d0a 2020 2020 2020 2020 2020 2020  ---.            
│ │ │ │ +0000f980: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0000f990: 2053 616c 7420 4558 414d 504c 452e 4f52   Salt EXAMPLE.OR
│ │ │ │ +0000f9a0: 4773 696d 6f6e 2e0a 2020 2020 2020 2020  Gsimon..        
│ │ │ │  0000f9b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000f9c0: 2020 2050 6173 7377 6f72 6420 666f 6f2e     Password foo.
│ │ │ │ -0000f9d0: 0a20 2020 2020 6a61 7340 6c61 7474 653a  .     jas@latte:
│ │ │ │ -0000f9e0: 7e24 0a0a 2020 2059 6f75 2073 686f 756c  ~$..   You shoul
│ │ │ │ -0000f9f0: 6420 6e6f 7720 6265 2072 6561 6479 2074  d now be ready t
│ │ │ │ -0000fa00: 6f20 7374 6172 7420 7468 6520 4b44 432c  o start the KDC,
│ │ │ │ -0000fa10: 2077 6869 6368 2069 7320 6578 706c 6169   which is explai
│ │ │ │ -0000fa20: 6e65 6420 696e 2074 6865 0a6e 6578 7420  ned in the.next 
│ │ │ │ -0000fa30: 7365 6374 696f 6e20 282a 6e6f 7465 2053  section (*note S
│ │ │ │ -0000fa40: 7461 7274 696e 6720 5368 6973 6869 643a  tarting Shishid:
│ │ │ │ -0000fa50: 3a29 2c20 616e 6420 6765 7420 7469 636b  :), and get tick
│ │ │ │ -0000fa60: 6574 7320 6173 2065 7870 6c61 696e 6564  ets as explained
│ │ │ │ -0000fa70: 0a65 6172 6c69 6572 2028 2a6e 6f74 6520  .earlier (*note 
│ │ │ │ -0000fa80: 5573 6572 204d 616e 7561 6c3a 3a29 2e0a  User Manual::)..
│ │ │ │ -0000fa90: 0a1f 0a46 696c 653a 2073 6869 7368 692e  ...File: shishi.
│ │ │ │ -0000faa0: 696e 666f 2c20 204e 6f64 653a 2053 7461  info,  Node: Sta
│ │ │ │ -0000fab0: 7274 696e 6720 5368 6973 6869 642c 2020  rting Shishid,  
│ │ │ │ -0000fac0: 4e65 7874 3a20 436f 6e66 6967 7572 696e  Next: Configurin
│ │ │ │ -0000fad0: 6720 444e 5320 666f 7220 4b44 432c 2020  g DNS for KDC,  
│ │ │ │ -0000fae0: 5072 6576 3a20 5573 696e 6720 5368 6973  Prev: Using Shis
│ │ │ │ -0000faf0: 612c 2020 5570 3a20 4164 6d69 6e69 7374  a,  Up: Administ
│ │ │ │ -0000fb00: 7261 7469 6f6e 204d 616e 7561 6c0a 0a33  ration Manual..3
│ │ │ │ -0000fb10: 2e34 2053 7461 7274 696e 6720 5368 6973  .4 Starting Shis
│ │ │ │ -0000fb20: 6869 640a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  hid.============
│ │ │ │ -0000fb30: 3d3d 3d3d 3d3d 3d3d 0a0a 5468 6520 5368  ========..The Sh
│ │ │ │ -0000fb40: 6973 6869 2073 6572 7665 722c 206f 7220  ishi server, or 
│ │ │ │ -0000fb50: 4b65 7920 4469 7374 7269 6275 7469 6f6e  Key Distribution
│ │ │ │ -0000fb60: 2043 656e 7465 7220 284b 4443 292c 2069   Center (KDC), i
│ │ │ │ -0000fb70: 7320 6361 6c6c 6564 2053 6869 7368 6964  s called Shishid
│ │ │ │ -0000fb80: 2e0a 5368 6973 6869 6420 6973 2072 6573  ..Shishid is res
│ │ │ │ -0000fb90: 706f 6e73 6962 6c65 2066 6f72 206c 6973  ponsible for lis
│ │ │ │ -0000fba0: 7465 6e69 6e67 206f 6e20 5544 5020 616e  tening on UDP an
│ │ │ │ -0000fbb0: 6420 5443 5020 706f 7274 7320 666f 7220  d TCP ports for 
│ │ │ │ -0000fbc0: 4b65 7262 6572 6f73 0a72 6571 7565 7374  Kerberos.request
│ │ │ │ -0000fbd0: 732e 2020 4375 7272 656e 746c 7920 6974  s.  Currently it
│ │ │ │ -0000fbe0: 2063 616e 2068 616e 646c 6520 696e 6974   can handle init
│ │ │ │ -0000fbf0: 6961 6c20 7469 636b 6574 2072 6571 7565  ial ticket reque
│ │ │ │ -0000fc00: 7374 730a 2841 7574 6865 6e74 6963 6174  sts.(Authenticat
│ │ │ │ -0000fc10: 696f 6e20 5365 7276 6963 652c 206f 7220  ion Service, or 
│ │ │ │ -0000fc20: 4153 292c 2074 7970 6963 616c 6c79 2061  AS), typically a
│ │ │ │ -0000fc30: 7574 6865 6e74 6963 6174 6564 2077 6974  uthenticated wit
│ │ │ │ -0000fc40: 6820 6b65 7973 0a64 6572 6976 6564 2066  h keys.derived f
│ │ │ │ -0000fc50: 726f 6d20 7061 7373 776f 7264 732c 2061  rom passwords, a
│ │ │ │ -0000fc60: 6e64 2073 7562 7365 7175 656e 7420 7469  nd subsequent ti
│ │ │ │ -0000fc70: 636b 6574 2072 6571 7565 7374 7320 2854  cket requests (T
│ │ │ │ -0000fc80: 6963 6b65 7420 4772 616e 7469 6e67 0a53  icket Granting.S
│ │ │ │ -0000fc90: 6572 7669 6365 2c20 6f72 2054 4753 292c  ervice, or TGS),
│ │ │ │ -0000fca0: 2074 7970 6963 616c 6c79 2061 7574 6865   typically authe
│ │ │ │ -0000fcb0: 6e74 6963 6174 6564 2077 6974 6820 7468  nticated with th
│ │ │ │ -0000fcc0: 6520 6b65 7920 6163 7175 6972 6564 2064  e key acquired d
│ │ │ │ -0000fcd0: 7572 696e 670a 616e 2041 5320 6578 6368  uring.an AS exch
│ │ │ │ -0000fce0: 616e 6765 2e0a 0a20 2020 4375 7272 656e  ange...   Curren
│ │ │ │ -0000fcf0: 746c 7920 7468 6572 6520 6973 2076 6572  tly there is ver
│ │ │ │ -0000fd00: 7920 6c69 7474 6c65 2063 6f6e 6669 6775  y little configu
│ │ │ │ -0000fd10: 7261 7469 6f6e 2061 7661 696c 6162 6c65  ration available
│ │ │ │ -0000fd20: 2c20 7468 6520 6f6e 6c79 0a76 6172 6961  , the only.varia
│ │ │ │ -0000fd30: 626c 6573 2061 7265 2077 6869 6368 2070  bles are which p
│ │ │ │ -0000fd40: 6f72 7473 2074 6865 2073 6572 7665 7220  orts the server 
│ │ │ │ -0000fd50: 7368 6f75 6c64 206c 6973 7465 6e20 6f6e  should listen on
│ │ │ │ -0000fd60: 2061 6e64 2061 6e20 6f70 7469 6f6e 616c   and an optional
│ │ │ │ -0000fd70: 0a75 7365 7220 6e61 6d65 2074 6f20 e280  .user name to ..
│ │ │ │ -0000fd80: 9873 6574 7569 64e2 8099 2069 6e74 6f20  .setuid... into 
│ │ │ │ -0000fd90: 6166 7465 7220 7375 6363 6573 7366 756c  after successful
│ │ │ │ -0000fda0: 6c79 206c 6973 7465 6e69 6e67 2074 6f20  ly listening to 
│ │ │ │ -0000fdb0: 7468 6520 706f 7274 732e 0a0a 2020 2042  the ports...   B
│ │ │ │ -0000fdc0: 7920 6465 6661 756c 742c 2053 6869 7368  y default, Shish
│ │ │ │ -0000fdd0: 6964 206c 6973 7465 6e73 206f 6e20 7468  id listens on th
│ │ │ │ -0000fde0: 6520 e280 986b 6572 6265 726f 73e2 8099  e ...kerberos...
│ │ │ │ -0000fdf0: 2073 6572 7669 6365 2070 6f72 7420 2874   service port (t
│ │ │ │ -0000fe00: 7970 6963 616c 6c79 0a74 7261 6e73 6c61  ypically.transla
│ │ │ │ -0000fe10: 7465 6420 746f 2038 3820 7669 6120 e280  ted to 88 via ..
│ │ │ │ -0000fe20: 982f 6574 632f 7365 7276 6963 6573 e280  ./etc/services..
│ │ │ │ -0000fe30: 9929 206f 6e20 7468 6520 5544 5020 616e  .) on the UDP an
│ │ │ │ -0000fe40: 6420 5443 5020 7472 616e 7370 6f72 7473  d TCP transports
│ │ │ │ -0000fe50: 2076 6961 0a49 5076 3420 616e 6420 2869   via.IPv4 and (i
│ │ │ │ -0000fe60: 6620 796f 7572 206d 6163 6869 6e65 2073  f your machine s
│ │ │ │ -0000fe70: 7570 706f 7274 2069 7429 2049 5076 3620  upport it) IPv6 
│ │ │ │ -0000fe80: 6f6e 2061 6c6c 2069 6e74 6572 6661 6365  on all interface
│ │ │ │ -0000fe90: 7320 6f6e 2079 6f75 720a 6d61 6368 696e  s on your.machin
│ │ │ │ -0000fea0: 652e 2020 4865 7265 2069 7320 6120 7479  e.  Here is a ty
│ │ │ │ -0000feb0: 7069 6361 6c20 7374 6172 7475 702e 0a0a  pical startup...
│ │ │ │ -0000fec0: 2020 2020 206c 6174 7465 3a2f 686f 6d65       latte:/home
│ │ │ │ -0000fed0: 2f6a 6173 2f73 7263 2f73 6869 7368 6923  /jas/src/shishi#
│ │ │ │ -0000fee0: 202f 7573 722f 6c6f 6361 6c2f 7362 696e   /usr/local/sbin
│ │ │ │ -0000fef0: 2f73 6869 7368 6964 0a20 2020 2020 496e  /shishid.     In
│ │ │ │ -0000ff00: 6974 6961 6c69 7a69 6e67 2047 4e55 544c  itializing GNUTL
│ │ │ │ -0000ff10: 532e 2e2e 0a20 2020 2020 496e 6974 6961  S....     Initia
│ │ │ │ -0000ff20: 6c69 7a69 6e67 2047 4e55 544c 532e 2e2e  lizing GNUTLS...
│ │ │ │ -0000ff30: 646f 6e65 0a20 2020 2020 4c69 7374 656e  done.     Listen
│ │ │ │ -0000ff40: 696e 6720 6f6e 2049 5076 343a 2a3a 6b65  ing on IPv4:*:ke
│ │ │ │ -0000ff50: 7262 6572 6f73 2f75 6470 2e2e 2e64 6f6e  rberos/udp...don
│ │ │ │ -0000ff60: 650a 2020 2020 204c 6973 7465 6e69 6e67  e.     Listening
│ │ │ │ -0000ff70: 206f 6e20 4950 7634 3a2a 3a6b 6572 6265   on IPv4:*:kerbe
│ │ │ │ -0000ff80: 726f 732f 7463 702e 2e2e 646f 6e65 0a20  ros/tcp...done. 
│ │ │ │ -0000ff90: 2020 2020 4c69 7374 656e 696e 6720 6f6e      Listening on
│ │ │ │ -0000ffa0: 2049 5076 363a 2a3a 6b65 7262 6572 6f73   IPv6:*:kerberos
│ │ │ │ -0000ffb0: 2f75 6470 2e2e 2e66 6169 6c65 640a 2020  /udp...failed.  
│ │ │ │ -0000ffc0: 2020 2073 6f63 6b65 743a 2041 6464 7265     socket: Addre
│ │ │ │ -0000ffd0: 7373 2066 616d 696c 7920 6e6f 7420 7375  ss family not su
│ │ │ │ -0000ffe0: 7070 6f72 7465 6420 6279 2070 726f 746f  pported by proto
│ │ │ │ -0000fff0: 636f 6c0a 2020 2020 204c 6973 7465 6e69  col.     Listeni
│ │ │ │ -00010000: 6e67 206f 6e20 4950 7636 3a2a 3a6b 6572  ng on IPv6:*:ker
│ │ │ │ -00010010: 6265 726f 732f 7463 702e 2e2e 6661 696c  beros/tcp...fail
│ │ │ │ -00010020: 6564 0a20 2020 2020 736f 636b 6574 3a20  ed.     socket: 
│ │ │ │ -00010030: 4164 6472 6573 7320 6661 6d69 6c79 206e  Address family n
│ │ │ │ -00010040: 6f74 2073 7570 706f 7274 6564 2062 7920  ot supported by 
│ │ │ │ -00010050: 7072 6f74 6f63 6f6c 0a20 2020 2020 4c69  protocol.     Li
│ │ │ │ -00010060: 7374 656e 696e 6720 6f6e 2032 2070 6f72  stening on 2 por
│ │ │ │ -00010070: 7473 2e2e 2e0a 0a20 2020 5275 6e6e 696e  ts.....   Runnin
│ │ │ │ -00010080: 6720 6173 2072 6f6f 7420 6973 206e 6f74  g as root is not
│ │ │ │ -00010090: 2072 6563 6f6d 6d65 6e64 6564 2e20 2041   recommended.  A
│ │ │ │ -000100a0: 6e79 2073 6563 7572 6974 7920 7072 6f62  ny security prob
│ │ │ │ -000100b0: 6c65 6d20 696e 2073 6869 7368 6964 0a61  lem in shishid.a
│ │ │ │ -000100c0: 6e64 2079 6f75 7220 686f 7374 206d 6179  nd your host may
│ │ │ │ -000100d0: 2062 6520 636f 6d70 726f 6d69 7365 642e   be compromised.
│ │ │ │ -000100e0: 2020 5468 6572 6566 6f72 2c20 7765 2072    Therefor, we r
│ │ │ │ -000100f0: 6563 6f6d 6d65 6e64 2075 7369 6e67 2074  ecommend using t
│ │ │ │ -00010100: 6865 0ae2 8098 2d2d 7365 7475 6964 e280  he....--setuid..
│ │ │ │ -00010110: 9920 7061 7261 6d65 7465 722c 2061 7320  . parameter, as 
│ │ │ │ -00010120: 666f 6c6c 6f77 732e 0a0a 2020 2020 206c  follows...     l
│ │ │ │ -00010130: 6174 7465 3a2f 686f 6d65 2f6a 6173 2f73  atte:/home/jas/s
│ │ │ │ -00010140: 7263 2f73 6869 7368 6923 202f 7573 722f  rc/shishi# /usr/
│ │ │ │ -00010150: 6c6f 6361 6c2f 7362 696e 2f73 6869 7368  local/sbin/shish
│ │ │ │ -00010160: 6964 202d 2d73 6574 7569 643d 6a61 730a  id --setuid=jas.
│ │ │ │ -00010170: 2020 2020 2049 6e69 7469 616c 697a 696e       Initializin
│ │ │ │ -00010180: 6720 474e 5554 4c53 2e2e 2e0a 2020 2020  g GNUTLS....    
│ │ │ │ -00010190: 2049 6e69 7469 616c 697a 696e 6720 474e   Initializing GN
│ │ │ │ -000101a0: 5554 4c53 2e2e 2e64 6f6e 650a 2020 2020  UTLS...done.    
│ │ │ │ -000101b0: 204c 6973 7465 6e69 6e67 206f 6e20 4950   Listening on IP
│ │ │ │ -000101c0: 7634 3a2a 3a6b 6572 6265 726f 732f 7564  v4:*:kerberos/ud
│ │ │ │ -000101d0: 702e 2e2e 646f 6e65 0a20 2020 2020 4c69  p...done.     Li
│ │ │ │ -000101e0: 7374 656e 696e 6720 6f6e 2049 5076 343a  stening on IPv4:
│ │ │ │ -000101f0: 2a3a 6b65 7262 6572 6f73 2f74 6370 2e2e  *:kerberos/tcp..
│ │ │ │ -00010200: 2e64 6f6e 650a 2020 2020 204c 6973 7465  .done.     Liste
│ │ │ │ -00010210: 6e69 6e67 206f 6e20 4950 7636 3a2a 3a6b  ning on IPv6:*:k
│ │ │ │ -00010220: 6572 6265 726f 732f 7564 702e 2e2e 6661  erberos/udp...fa
│ │ │ │ -00010230: 696c 6564 0a20 2020 2020 736f 636b 6574  iled.     socket
│ │ │ │ -00010240: 3a20 4164 6472 6573 7320 6661 6d69 6c79  : Address family
│ │ │ │ -00010250: 206e 6f74 2073 7570 706f 7274 6564 2062   not supported b
│ │ │ │ -00010260: 7920 7072 6f74 6f63 6f6c 0a20 2020 2020  y protocol.     
│ │ │ │ -00010270: 4c69 7374 656e 696e 6720 6f6e 2049 5076  Listening on IPv
│ │ │ │ -00010280: 363a 2a3a 6b65 7262 6572 6f73 2f74 6370  6:*:kerberos/tcp
│ │ │ │ -00010290: 2e2e 2e66 6169 6c65 640a 2020 2020 2073  ...failed.     s
│ │ │ │ -000102a0: 6f63 6b65 743a 2041 6464 7265 7373 2066  ocket: Address f
│ │ │ │ -000102b0: 616d 696c 7920 6e6f 7420 7375 7070 6f72  amily not suppor
│ │ │ │ -000102c0: 7465 6420 6279 2070 726f 746f 636f 6c0a  ted by protocol.
│ │ │ │ -000102d0: 2020 2020 204c 6973 7465 6e69 6e67 206f       Listening o
│ │ │ │ -000102e0: 6e20 3220 706f 7274 732e 2e2e 0a20 2020  n 2 ports....   
│ │ │ │ -000102f0: 2020 5573 6572 2069 6465 6e74 6974 7920    User identity 
│ │ │ │ -00010300: 7365 7420 746f 2060 6a61 7327 2028 3232  set to `jas' (22
│ │ │ │ -00010310: 3534 3129 2e2e 2e0a 0a20 2020 416e 2061  541).....   An a
│ │ │ │ -00010320: 6c74 6572 6e61 7469 7665 2069 7320 746f  lternative is to
│ │ │ │ -00010330: 2072 756e 2073 6869 7368 6964 206f 6e20   run shishid on 
│ │ │ │ -00010340: 616e 2061 6c74 6572 6e61 7469 7665 2070  an alternative p
│ │ │ │ -00010350: 6f72 7420 6173 2061 0a6e 6f6e 2d70 7269  ort as a.non-pri
│ │ │ │ -00010360: 7669 6c65 6765 6420 7573 6572 2e20 2054  vileged user.  T
│ │ │ │ -00010370: 6f20 636f 6e74 696e 7565 2074 6865 2065  o continue the e
│ │ │ │ -00010380: 7861 6d70 6c65 206f 6620 7365 7474 696e  xample of settin
│ │ │ │ -00010390: 6720 7570 2074 6865 0ae2 8098 4558 414d  g up the....EXAM
│ │ │ │ -000103a0: 504c 452e 4f52 47e2 8099 2072 6561 6c6d  PLE.ORG... realm
│ │ │ │ -000103b0: 2061 7320 6120 6e6f 6e2d 7072 6976 696c   as a non-privil
│ │ │ │ -000103c0: 6567 6564 2075 7365 7220 6672 6f6d 2074  eged user from t
│ │ │ │ -000103d0: 6865 2070 7265 6365 6469 6e67 2073 6563  he preceding sec
│ │ │ │ -000103e0: 7469 6f6e 2c0a 7765 2073 7461 7274 2074  tion,.we start t
│ │ │ │ -000103f0: 6865 2073 6572 7665 7220 6c69 7374 656e  he server listen
│ │ │ │ -00010400: 206f 6e20 706f 7274 2034 3731 3120 7669   on port 4711 vi
│ │ │ │ -00010410: 6120 5544 5020 6f6e 2049 5076 342e 0a0a  a UDP on IPv4...
│ │ │ │ -00010420: 2020 2020 206a 6173 406c 6174 7465 3a7e       jas@latte:~
│ │ │ │ -00010430: 2420 2f75 7372 2f6c 6f63 616c 2f73 6269  $ /usr/local/sbi
│ │ │ │ -00010440: 6e2f 7368 6973 6869 6420 2d6c 2049 5076  n/shishid -l IPv
│ │ │ │ -00010450: 343a 2a3a 3437 3131 2f75 6470 0a20 2020  4:*:4711/udp.   
│ │ │ │ -00010460: 2020 496e 6974 6961 6c69 7a69 6e67 2047    Initializing G
│ │ │ │ -00010470: 4e55 544c 532e 2e2e 0a20 2020 2020 496e  NUTLS....     In
│ │ │ │ -00010480: 6974 6961 6c69 7a69 6e67 2047 4e55 544c  itializing GNUTL
│ │ │ │ -00010490: 532e 2e2e 646f 6e65 0a20 2020 2020 4c69  S...done.     Li
│ │ │ │ -000104a0: 7374 656e 696e 6720 6f6e 202a 3a34 3731  stening on *:471
│ │ │ │ -000104b0: 312f 7463 702e 2e2e 0a20 2020 2020 4c69  1/tcp....     Li
│ │ │ │ -000104c0: 7374 656e 696e 6720 6f6e 2031 2070 6f72  stening on 1 por
│ │ │ │ -000104d0: 7473 2e2e 2e0a 2020 2020 2073 6869 7368  ts....     shish
│ │ │ │ -000104e0: 6964 3a20 5374 6172 7469 6e67 2028 474e  id: Starting (GN
│ │ │ │ -000104f0: 5554 4c53 2060 312e 302e 3427 290a 2020  UTLS `1.0.4').  
│ │ │ │ -00010500: 2020 2073 6869 7368 6964 3a20 4c69 7374     shishid: List
│ │ │ │ -00010510: 656e 696e 6720 6f6e 202a 3a34 3731 312f  ening on *:4711/
│ │ │ │ -00010520: 7463 7020 736f 636b 6574 2034 0a0a 2020  tcp socket 4..  
│ │ │ │ -00010530: 2049 6620 796f 7520 6861 7665 2073 6574   If you have set
│ │ │ │ -00010540: 2075 7020 7468 6520 5368 6973 6120 6461   up the Shisa da
│ │ │ │ -00010550: 7461 6261 7365 2061 7320 696e 2074 6865  tabase as in the
│ │ │ │ -00010560: 2070 7265 7669 6f75 7320 6578 616d 706c   previous exampl
│ │ │ │ -00010570: 652c 2079 6f75 0a63 616e 206e 6f77 2061  e, you.can now a
│ │ │ │ -00010580: 6371 7569 7265 2074 6963 6b65 7473 2061  cquire tickets a
│ │ │ │ -00010590: 7320 666f 6c6c 6f77 732e 0a0a 2020 2020  s follows...    
│ │ │ │ -000105a0: 206a 6173 406c 6174 7465 3a7e 2420 7368   jas@latte:~$ sh
│ │ │ │ -000105b0: 6973 6869 202d 6f20 2772 6561 6c6d 2d6b  ishi -o 'realm-k
│ │ │ │ -000105c0: 6463 3d45 5841 4d50 4c45 2e4f 5247 2c6c  dc=EXAMPLE.ORG,l
│ │ │ │ -000105d0: 6f63 616c 686f 7374 3a34 3731 3127 205c  ocalhost:4711' \
│ │ │ │ -000105e0: 0a20 2020 2020 2020 2073 696d 6f6e 4045  .        simon@E
│ │ │ │ -000105f0: 5841 4d50 4c45 2e4f 5247 0a20 2020 2020  XAMPLE.ORG.     
│ │ │ │ -00010600: 456e 7465 7220 7061 7373 776f 7264 2066  Enter password f
│ │ │ │ -00010610: 6f72 2060 7369 6d6f 6e40 4558 414d 504c  or `simon@EXAMPL
│ │ │ │ -00010620: 452e 4f52 4727 3a0a 2020 2020 2073 696d  E.ORG':.     sim
│ │ │ │ -00010630: 6f6e 4045 5841 4d50 4c45 2e4f 5247 3a0a  on@EXAMPLE.ORG:.
│ │ │ │ -00010640: 2020 2020 2041 7574 6874 696d 653a 2020       Authtime:  
│ │ │ │ -00010650: 2020 2020 2046 7269 2044 6563 2031 3220       Fri Dec 12 
│ │ │ │ -00010660: 3031 3a34 313a 3031 2032 3030 330a 2020  01:41:01 2003.  
│ │ │ │ -00010670: 2020 2045 6e64 7469 6d65 3a20 2020 2020     Endtime:     
│ │ │ │ -00010680: 2020 2046 7269 2044 6563 2031 3220 3031     Fri Dec 12 01
│ │ │ │ -00010690: 3a35 373a 3431 2032 3030 330a 2020 2020  :57:41 2003.    
│ │ │ │ -000106a0: 2053 6572 7665 723a 2020 2020 2020 2020   Server:        
│ │ │ │ -000106b0: 206b 7262 7467 742f 4558 414d 504c 452e   krbtgt/EXAMPLE.
│ │ │ │ -000106c0: 4f52 4720 6b65 7920 6165 7332 3536 2d63  ORG key aes256-c
│ │ │ │ -000106d0: 7473 2d68 6d61 632d 7368 6131 2d39 3620  ts-hmac-sha1-96 
│ │ │ │ -000106e0: 2831 3829 0a20 2020 2020 5469 636b 6574  (18).     Ticket
│ │ │ │ -000106f0: 206b 6579 3a20 2020 2020 6165 7332 3536   key:     aes256
│ │ │ │ -00010700: 2d63 7473 2d68 6d61 632d 7368 6131 2d39  -cts-hmac-sha1-9
│ │ │ │ -00010710: 3620 2831 3829 2070 726f 7465 6374 6564  6 (18) protected
│ │ │ │ -00010720: 2062 7920 6165 7332 3536 2d63 7473 2d68   by aes256-cts-h
│ │ │ │ -00010730: 6d61 632d 7368 6131 2d39 3620 2831 3829  mac-sha1-96 (18)
│ │ │ │ -00010740: 0a20 2020 2020 5469 636b 6574 2066 6c61  .     Ticket fla
│ │ │ │ -00010750: 6773 3a20 2020 464f 5257 4152 4445 4420  gs:   FORWARDED 
│ │ │ │ -00010760: 5052 4f58 4941 424c 4520 5245 4e45 5741  PROXIABLE RENEWA
│ │ │ │ -00010770: 424c 4520 494e 4954 4941 4c20 2831 3229  BLE INITIAL (12)
│ │ │ │ -00010780: 0a20 2020 2020 6a61 7340 6c61 7474 653a  .     jas@latte:
│ │ │ │ -00010790: 7e24 0a0a 2020 2054 6865 206f 7574 7075  ~$..   The outpu
│ │ │ │ -000107a0: 7420 6672 6f6d 2053 6869 7368 6964 206f  t from Shishid o
│ │ │ │ -000107b0: 6e20 6120 7375 6363 6573 7366 756c 2069  n a successful i
│ │ │ │ -000107c0: 6e76 6f63 6174 696f 6e20 776f 756c 6420  nvocation would 
│ │ │ │ -000107d0: 6c6f 6f6b 206c 696b 653a 0a0a 2020 2020  look like:..    
│ │ │ │ -000107e0: 2073 6869 7368 6964 3a20 4861 7320 3133   shishid: Has 13
│ │ │ │ -000107f0: 3120 6279 7465 7320 6672 6f6d 202a 3a34  1 bytes from *:4
│ │ │ │ -00010800: 3731 312f 7564 7020 6f6e 2073 6f63 6b65  711/udp on socke
│ │ │ │ -00010810: 7420 340a 2020 2020 2073 6869 7368 6964  t 4.     shishid
│ │ │ │ -00010820: 3a20 5072 6f63 6573 7369 6e67 2031 3331  : Processing 131
│ │ │ │ -00010830: 2066 726f 6d20 2a3a 3437 3131 2f75 6470   from *:4711/udp
│ │ │ │ -00010840: 206f 6e20 736f 636b 6574 2034 0a20 2020   on socket 4.   
│ │ │ │ -00010850: 2020 7368 6973 6869 643a 2054 7279 696e    shishid: Tryin
│ │ │ │ -00010860: 6720 4153 2d52 4551 0a20 2020 2020 7368  g AS-REQ.     sh
│ │ │ │ -00010870: 6973 6869 643a 2041 532d 5245 5120 6672  ishid: AS-REQ fr
│ │ │ │ -00010880: 6f6d 2073 696d 6f6e 4045 5841 4d50 4c45  om simon@EXAMPLE
│ │ │ │ -00010890: 2e4f 5247 2066 6f72 206b 7262 7467 742f  .ORG for krbtgt/
│ │ │ │ -000108a0: 4558 414d 504c 452e 4f52 4740 4558 414d  EXAMPLE.ORG@EXAM
│ │ │ │ -000108b0: 504c 452e 4f52 470a 2020 2020 2073 6869  PLE.ORG.     shi
│ │ │ │ -000108c0: 7368 6964 3a20 4d61 7463 6869 6e67 2063  shid: Matching c
│ │ │ │ -000108d0: 6c69 656e 7420 6574 7970 6520 3138 2061  lient etype 18 a
│ │ │ │ -000108e0: 6761 696e 7374 2075 7365 7220 6b65 7920  gainst user key 
│ │ │ │ -000108f0: 6574 7970 6520 3138 0a20 2020 2020 7368  etype 18.     sh
│ │ │ │ -00010900: 6973 6869 643a 2048 6176 6520 3531 3120  ishid: Have 511 
│ │ │ │ -00010910: 6279 7465 7320 666f 7220 2a3a 3437 3131  bytes for *:4711
│ │ │ │ -00010920: 2f75 6470 206f 6e20 736f 636b 6574 2034  /udp on socket 4
│ │ │ │ -00010930: 0a20 2020 2020 7368 6973 6869 643a 2053  .     shishid: S
│ │ │ │ -00010940: 656e 6469 6e67 2035 3131 2062 7974 6573  ending 511 bytes
│ │ │ │ -00010950: 2074 6f20 2a3a 3437 3131 2f75 6470 2073   to *:4711/udp s
│ │ │ │ -00010960: 6f63 6b65 7420 3420 7669 6120 5544 500a  ocket 4 via UDP.
│ │ │ │ -00010970: 2020 2020 2073 6869 7368 6964 3a20 4c69       shishid: Li
│ │ │ │ -00010980: 7374 656e 696e 6720 6f6e 202a 3a34 3731  stening on *:471
│ │ │ │ -00010990: 312f 7564 7020 736f 636b 6574 2034 0a0a  1/udp socket 4..
│ │ │ │ -000109a0: 2020 2059 6f75 206d 6179 2075 7365 2074     You may use t
│ │ │ │ -000109b0: 6865 2027 2d76 2720 7061 7261 6d65 7465  he '-v' paramete
│ │ │ │ -000109c0: 7220 666f 7220 5368 6973 6869 6420 616e  r for Shishid an
│ │ │ │ -000109d0: 6420 5368 6973 6869 2074 6f20 6765 6e65  d Shishi to gene
│ │ │ │ -000109e0: 7261 7465 0a6d 6f72 6520 6465 6275 6767  rate.more debugg
│ │ │ │ -000109f0: 696e 6720 696e 666f 726d 6174 696f 6e2e  ing information.
│ │ │ │ -00010a00: 0a0a 2020 2054 6f20 696c 6c75 7374 7261  ..   To illustra
│ │ │ │ -00010a10: 7465 2077 6861 7420 616e 2061 7070 6c69  te what an appli
│ │ │ │ -00010a20: 6361 7469 6f6e 2c20 7375 6368 2061 7320  cation, such as 
│ │ │ │ -00010a30: 7468 6520 5368 6973 6869 2070 6174 6368  the Shishi patch
│ │ │ │ -00010a40: 6564 0a76 6572 7369 6f6e 7320 6f66 2047  ed.versions of G
│ │ │ │ -00010a50: 4e55 206c 7368 206f 7220 5465 6c6e 6574  NU lsh or Telnet
│ │ │ │ -00010a60: 2066 726f 6d20 474e 5520 496e 6574 5574   from GNU InetUt
│ │ │ │ -00010a70: 696c 732c 2077 6f75 6c64 2064 6f20 7768  ils, would do wh
│ │ │ │ -00010a80: 656e 0a63 6f6e 7461 6374 696e 6720 7468  en.contacting th
│ │ │ │ -00010a90: 6520 686f 7374 20e2 8098 6d61 696c 2e65  e host ...mail.e
│ │ │ │ -00010aa0: 7861 6d70 6c65 2e6f 7267 e280 9920 7765  xample.org... we
│ │ │ │ -00010ab0: 2069 6c6c 7573 7472 6174 6520 7573 696e   illustrate usin
│ │ │ │ -00010ac0: 6720 7468 6520 5447 530a 7365 7276 6963  g the TGS.servic
│ │ │ │ -00010ad0: 6520 6173 2077 656c 6c2e 0a0a 2020 2020  e as well...    
│ │ │ │ -00010ae0: 206a 6173 406c 6174 7465 3a7e 2420 7368   jas@latte:~$ sh
│ │ │ │ -00010af0: 6973 6869 202d 6f20 2772 6561 6c6d 2d6b  ishi -o 'realm-k
│ │ │ │ -00010b00: 6463 3d45 5841 4d50 4c45 2e4f 5247 2c6c  dc=EXAMPLE.ORG,l
│ │ │ │ -00010b10: 6f63 616c 686f 7374 3a34 3731 3127 205c  ocalhost:4711' \
│ │ │ │ -00010b20: 0a20 2020 2020 2020 2073 696d 6f6e 4045  .        simon@E
│ │ │ │ -00010b30: 5841 4d50 4c45 2e4f 5247 2068 6f73 742f  XAMPLE.ORG host/
│ │ │ │ -00010b40: 6d61 696c 2e65 7861 6d70 6c65 2e6f 7267  mail.example.org
│ │ │ │ -00010b50: 0a20 2020 2020 7369 6d6f 6e40 4558 414d  .     simon@EXAM
│ │ │ │ -00010b60: 504c 452e 4f52 473a 0a20 2020 2020 4175  PLE.ORG:.     Au
│ │ │ │ -00010b70: 7468 7469 6d65 3a20 2020 2020 2020 4672  thtime:       Fr
│ │ │ │ -00010b80: 6920 4465 6320 3132 2030 313a 3436 3a35  i Dec 12 01:46:5
│ │ │ │ -00010b90: 3420 3230 3033 0a20 2020 2020 456e 6474  4 2003.     Endt
│ │ │ │ -00010ba0: 696d 653a 2020 2020 2020 2020 4672 6920  ime:        Fri 
│ │ │ │ -00010bb0: 4465 6320 3132 2030 323a 3033 3a33 3420  Dec 12 02:03:34 
│ │ │ │ -00010bc0: 3230 3033 0a20 2020 2020 5365 7276 6572  2003.     Server
│ │ │ │ -00010bd0: 3a20 2020 2020 2020 2020 686f 7374 2f6d  :         host/m
│ │ │ │ -00010be0: 6169 6c2e 6578 616d 706c 652e 6f72 6720  ail.example.org 
│ │ │ │ -00010bf0: 6b65 7920 6465 7333 2d63 6263 2d73 6861  key des3-cbc-sha
│ │ │ │ -00010c00: 312d 6b64 2028 3136 290a 2020 2020 2054  1-kd (16).     T
│ │ │ │ -00010c10: 6963 6b65 7420 6b65 793a 2020 2020 2064  icket key:     d
│ │ │ │ -00010c20: 6573 332d 6362 632d 7368 6131 2d6b 6420  es3-cbc-sha1-kd 
│ │ │ │ -00010c30: 2831 3629 2070 726f 7465 6374 6564 2062  (16) protected b
│ │ │ │ -00010c40: 7920 6165 7332 3536 2d63 7473 2d68 6d61  y aes256-cts-hma
│ │ │ │ -00010c50: 632d 7368 6131 2d39 3620 2831 3829 0a20  c-sha1-96 (18). 
│ │ │ │ -00010c60: 2020 2020 5469 636b 6574 2066 6c61 6773      Ticket flags
│ │ │ │ -00010c70: 3a20 2020 464f 5257 4152 4445 4420 5052  :   FORWARDED PR
│ │ │ │ -00010c80: 4f58 4941 424c 4520 2834 3533 3938 3739  OXIABLE (4539879
│ │ │ │ -00010c90: 3629 0a20 2020 2020 6a61 7340 6c61 7474  6).     jas@latt
│ │ │ │ -00010ca0: 653a 7e24 0a0a 2020 2054 6869 7320 636f  e:~$..   This co
│ │ │ │ -00010cb0: 6e63 6c75 6465 206f 7572 2077 616c 6b2d  nclude our walk-
│ │ │ │ -00010cc0: 7468 726f 7567 6820 6f66 2073 6574 7469  through of setti
│ │ │ │ -00010cd0: 6e67 2075 7020 6120 6e65 7720 4b65 7262  ng up a new Kerb
│ │ │ │ -00010ce0: 6572 6f73 2072 6561 6c6d 0a75 7369 6e67  eros realm.using
│ │ │ │ -00010cf0: 2053 6869 7368 692e 2020 4974 2069 7320   Shishi.  It is 
│ │ │ │ -00010d00: 7175 6974 6520 6c69 6b65 6c79 2074 6861  quite likely tha
│ │ │ │ -00010d10: 7420 6f6e 6520 6f72 206d 6f72 6520 7374  t one or more st
│ │ │ │ -00010d20: 6570 7320 6661 696c 6564 2c20 616e 6420  eps failed, and 
│ │ │ │ -00010d30: 6966 0a73 6f20 7765 2065 6e63 6f75 7261  if.so we encoura
│ │ │ │ -00010d40: 6765 2079 6f75 2074 6f20 6465 6275 6720  ge you to debug 
│ │ │ │ -00010d50: 6974 2061 6e64 2073 7562 6d69 7420 6120  it and submit a 
│ │ │ │ -00010d60: 7061 7463 682c 206f 7220 6174 206c 6561  patch, or at lea
│ │ │ │ -00010d70: 7374 2072 6570 6f72 740a 6974 2061 7320  st report.it as 
│ │ │ │ -00010d80: 6120 7072 6f62 6c65 6d2e 2020 4865 636b  a problem.  Heck
│ │ │ │ -00010d90: 2c20 6576 656e 206c 6574 7469 6e67 2075  , even letting u
│ │ │ │ -00010da0: 7320 6b6e 6f77 2069 6620 796f 7520 676f  s know if you go
│ │ │ │ -00010db0: 7420 7468 6973 2066 6172 2077 6f75 6c64  t this far would
│ │ │ │ -00010dc0: 0a62 6520 6f66 2069 6e74 6572 6573 742e  .be of interest.
│ │ │ │ -00010dd0: 2020 2a4e 6f74 6520 4275 6720 5265 706f    *Note Bug Repo
│ │ │ │ -00010de0: 7274 733a 3a2e 0a0a 1f0a 4669 6c65 3a20  rts::.....File: 
│ │ │ │ -00010df0: 7368 6973 6869 2e69 6e66 6f2c 2020 4e6f  shishi.info,  No
│ │ │ │ -00010e00: 6465 3a20 436f 6e66 6967 7572 696e 6720  de: Configuring 
│ │ │ │ -00010e10: 444e 5320 666f 7220 4b44 432c 2020 4e65  DNS for KDC,  Ne
│ │ │ │ -00010e20: 7874 3a20 4b65 7262 6572 6f73 2076 6961  xt: Kerberos via
│ │ │ │ -00010e30: 2054 4c53 2c20 2050 7265 763a 2053 7461   TLS,  Prev: Sta
│ │ │ │ -00010e40: 7274 696e 6720 5368 6973 6869 642c 2020  rting Shishid,  
│ │ │ │ -00010e50: 5570 3a20 4164 6d69 6e69 7374 7261 7469  Up: Administrati
│ │ │ │ -00010e60: 6f6e 204d 616e 7561 6c0a 0a33 2e35 2043  on Manual..3.5 C
│ │ │ │ -00010e70: 6f6e 6669 6775 7269 6e67 2044 4e53 2066  onfiguring DNS f
│ │ │ │ -00010e80: 6f72 204b 4443 0a3d 3d3d 3d3d 3d3d 3d3d  or KDC.=========
│ │ │ │ +0000f9c0: 2020 2020 2050 6173 7377 6f72 6420 666f       Password fo
│ │ │ │ +0000f9d0: 6f2e 0a20 2020 2020 6a61 7340 6c61 7474  o..     jas@latt
│ │ │ │ +0000f9e0: 653a 7e24 0a0a 2020 2059 6f75 2073 686f  e:~$..   You sho
│ │ │ │ +0000f9f0: 756c 6420 6e6f 7720 6265 2072 6561 6479  uld now be ready
│ │ │ │ +0000fa00: 2074 6f20 7374 6172 7420 7468 6520 4b44   to start the KD
│ │ │ │ +0000fa10: 432c 2077 6869 6368 2069 7320 6578 706c  C, which is expl
│ │ │ │ +0000fa20: 6169 6e65 6420 696e 2074 6865 0a6e 6578  ained in the.nex
│ │ │ │ +0000fa30: 7420 7365 6374 696f 6e20 282a 6e6f 7465  t section (*note
│ │ │ │ +0000fa40: 2053 7461 7274 696e 6720 5368 6973 6869   Starting Shishi
│ │ │ │ +0000fa50: 643a 3a29 2c20 616e 6420 6765 7420 7469  d::), and get ti
│ │ │ │ +0000fa60: 636b 6574 7320 6173 2065 7870 6c61 696e  ckets as explain
│ │ │ │ +0000fa70: 6564 0a65 6172 6c69 6572 2028 2a6e 6f74  ed.earlier (*not
│ │ │ │ +0000fa80: 6520 5573 6572 204d 616e 7561 6c3a 3a29  e User Manual::)
│ │ │ │ +0000fa90: 2e0a 0a1f 0a46 696c 653a 2073 6869 7368  .....File: shish
│ │ │ │ +0000faa0: 692e 696e 666f 2c20 204e 6f64 653a 2053  i.info,  Node: S
│ │ │ │ +0000fab0: 7461 7274 696e 6720 5368 6973 6869 642c  tarting Shishid,
│ │ │ │ +0000fac0: 2020 4e65 7874 3a20 436f 6e66 6967 7572    Next: Configur
│ │ │ │ +0000fad0: 696e 6720 444e 5320 666f 7220 4b44 432c  ing DNS for KDC,
│ │ │ │ +0000fae0: 2020 5072 6576 3a20 5573 696e 6720 5368    Prev: Using Sh
│ │ │ │ +0000faf0: 6973 612c 2020 5570 3a20 4164 6d69 6e69  isa,  Up: Admini
│ │ │ │ +0000fb00: 7374 7261 7469 6f6e 204d 616e 7561 6c0a  stration Manual.
│ │ │ │ +0000fb10: 0a33 2e34 2053 7461 7274 696e 6720 5368  .3.4 Starting Sh
│ │ │ │ +0000fb20: 6973 6869 640a 3d3d 3d3d 3d3d 3d3d 3d3d  ishid.==========
│ │ │ │ +0000fb30: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 5468 6520  ==========..The 
│ │ │ │ +0000fb40: 5368 6973 6869 2073 6572 7665 722c 206f  Shishi server, o
│ │ │ │ +0000fb50: 7220 4b65 7920 4469 7374 7269 6275 7469  r Key Distributi
│ │ │ │ +0000fb60: 6f6e 2043 656e 7465 7220 284b 4443 292c  on Center (KDC),
│ │ │ │ +0000fb70: 2069 7320 6361 6c6c 6564 2053 6869 7368   is called Shish
│ │ │ │ +0000fb80: 6964 2e0a 5368 6973 6869 6420 6973 2072  id..Shishid is r
│ │ │ │ +0000fb90: 6573 706f 6e73 6962 6c65 2066 6f72 206c  esponsible for l
│ │ │ │ +0000fba0: 6973 7465 6e69 6e67 206f 6e20 5544 5020  istening on UDP 
│ │ │ │ +0000fbb0: 616e 6420 5443 5020 706f 7274 7320 666f  and TCP ports fo
│ │ │ │ +0000fbc0: 7220 4b65 7262 6572 6f73 0a72 6571 7565  r Kerberos.reque
│ │ │ │ +0000fbd0: 7374 732e 2020 4375 7272 656e 746c 7920  sts.  Currently 
│ │ │ │ +0000fbe0: 6974 2063 616e 2068 616e 646c 6520 696e  it can handle in
│ │ │ │ +0000fbf0: 6974 6961 6c20 7469 636b 6574 2072 6571  itial ticket req
│ │ │ │ +0000fc00: 7565 7374 730a 2841 7574 6865 6e74 6963  uests.(Authentic
│ │ │ │ +0000fc10: 6174 696f 6e20 5365 7276 6963 652c 206f  ation Service, o
│ │ │ │ +0000fc20: 7220 4153 292c 2074 7970 6963 616c 6c79  r AS), typically
│ │ │ │ +0000fc30: 2061 7574 6865 6e74 6963 6174 6564 2077   authenticated w
│ │ │ │ +0000fc40: 6974 6820 6b65 7973 0a64 6572 6976 6564  ith keys.derived
│ │ │ │ +0000fc50: 2066 726f 6d20 7061 7373 776f 7264 732c   from passwords,
│ │ │ │ +0000fc60: 2061 6e64 2073 7562 7365 7175 656e 7420   and subsequent 
│ │ │ │ +0000fc70: 7469 636b 6574 2072 6571 7565 7374 7320  ticket requests 
│ │ │ │ +0000fc80: 2854 6963 6b65 7420 4772 616e 7469 6e67  (Ticket Granting
│ │ │ │ +0000fc90: 0a53 6572 7669 6365 2c20 6f72 2054 4753  .Service, or TGS
│ │ │ │ +0000fca0: 292c 2074 7970 6963 616c 6c79 2061 7574  ), typically aut
│ │ │ │ +0000fcb0: 6865 6e74 6963 6174 6564 2077 6974 6820  henticated with 
│ │ │ │ +0000fcc0: 7468 6520 6b65 7920 6163 7175 6972 6564  the key acquired
│ │ │ │ +0000fcd0: 2064 7572 696e 670a 616e 2041 5320 6578   during.an AS ex
│ │ │ │ +0000fce0: 6368 616e 6765 2e0a 0a20 2020 4375 7272  change...   Curr
│ │ │ │ +0000fcf0: 656e 746c 7920 7468 6572 6520 6973 2076  ently there is v
│ │ │ │ +0000fd00: 6572 7920 6c69 7474 6c65 2063 6f6e 6669  ery little confi
│ │ │ │ +0000fd10: 6775 7261 7469 6f6e 2061 7661 696c 6162  guration availab
│ │ │ │ +0000fd20: 6c65 2c20 7468 6520 6f6e 6c79 0a76 6172  le, the only.var
│ │ │ │ +0000fd30: 6961 626c 6573 2061 7265 2077 6869 6368  iables are which
│ │ │ │ +0000fd40: 2070 6f72 7473 2074 6865 2073 6572 7665   ports the serve
│ │ │ │ +0000fd50: 7220 7368 6f75 6c64 206c 6973 7465 6e20  r should listen 
│ │ │ │ +0000fd60: 6f6e 2061 6e64 2061 6e20 6f70 7469 6f6e  on and an option
│ │ │ │ +0000fd70: 616c 0a75 7365 7220 6e61 6d65 2074 6f20  al.user name to 
│ │ │ │ +0000fd80: e280 9873 6574 7569 64e2 8099 2069 6e74  ...setuid... int
│ │ │ │ +0000fd90: 6f20 6166 7465 7220 7375 6363 6573 7366  o after successf
│ │ │ │ +0000fda0: 756c 6c79 206c 6973 7465 6e69 6e67 2074  ully listening t
│ │ │ │ +0000fdb0: 6f20 7468 6520 706f 7274 732e 0a0a 2020  o the ports...  
│ │ │ │ +0000fdc0: 2042 7920 6465 6661 756c 742c 2053 6869   By default, Shi
│ │ │ │ +0000fdd0: 7368 6964 206c 6973 7465 6e73 206f 6e20  shid listens on 
│ │ │ │ +0000fde0: 7468 6520 e280 986b 6572 6265 726f 73e2  the ...kerberos.
│ │ │ │ +0000fdf0: 8099 2073 6572 7669 6365 2070 6f72 7420  .. service port 
│ │ │ │ +0000fe00: 2874 7970 6963 616c 6c79 0a74 7261 6e73  (typically.trans
│ │ │ │ +0000fe10: 6c61 7465 6420 746f 2038 3820 7669 6120  lated to 88 via 
│ │ │ │ +0000fe20: e280 982f 6574 632f 7365 7276 6963 6573  .../etc/services
│ │ │ │ +0000fe30: e280 9929 206f 6e20 7468 6520 5544 5020  ...) on the UDP 
│ │ │ │ +0000fe40: 616e 6420 5443 5020 7472 616e 7370 6f72  and TCP transpor
│ │ │ │ +0000fe50: 7473 2076 6961 0a49 5076 3420 616e 6420  ts via.IPv4 and 
│ │ │ │ +0000fe60: 2869 6620 796f 7572 206d 6163 6869 6e65  (if your machine
│ │ │ │ +0000fe70: 2073 7570 706f 7274 2069 7429 2049 5076   support it) IPv
│ │ │ │ +0000fe80: 3620 6f6e 2061 6c6c 2069 6e74 6572 6661  6 on all interfa
│ │ │ │ +0000fe90: 6365 7320 6f6e 2079 6f75 720a 6d61 6368  ces on your.mach
│ │ │ │ +0000fea0: 696e 652e 2020 4865 7265 2069 7320 6120  ine.  Here is a 
│ │ │ │ +0000feb0: 7479 7069 6361 6c20 7374 6172 7475 702e  typical startup.
│ │ │ │ +0000fec0: 0a0a 2020 2020 206c 6174 7465 3a2f 686f  ..     latte:/ho
│ │ │ │ +0000fed0: 6d65 2f6a 6173 2f73 7263 2f73 6869 7368  me/jas/src/shish
│ │ │ │ +0000fee0: 6923 202f 7573 722f 6c6f 6361 6c2f 7362  i# /usr/local/sb
│ │ │ │ +0000fef0: 696e 2f73 6869 7368 6964 0a20 2020 2020  in/shishid.     
│ │ │ │ +0000ff00: 496e 6974 6961 6c69 7a69 6e67 2047 4e55  Initializing GNU
│ │ │ │ +0000ff10: 544c 532e 2e2e 0a20 2020 2020 496e 6974  TLS....     Init
│ │ │ │ +0000ff20: 6961 6c69 7a69 6e67 2047 4e55 544c 532e  ializing GNUTLS.
│ │ │ │ +0000ff30: 2e2e 646f 6e65 0a20 2020 2020 4c69 7374  ..done.     List
│ │ │ │ +0000ff40: 656e 696e 6720 6f6e 2049 5076 343a 2a3a  ening on IPv4:*:
│ │ │ │ +0000ff50: 6b65 7262 6572 6f73 2f75 6470 2e2e 2e64  kerberos/udp...d
│ │ │ │ +0000ff60: 6f6e 650a 2020 2020 204c 6973 7465 6e69  one.     Listeni
│ │ │ │ +0000ff70: 6e67 206f 6e20 4950 7634 3a2a 3a6b 6572  ng on IPv4:*:ker
│ │ │ │ +0000ff80: 6265 726f 732f 7463 702e 2e2e 646f 6e65  beros/tcp...done
│ │ │ │ +0000ff90: 0a20 2020 2020 4c69 7374 656e 696e 6720  .     Listening 
│ │ │ │ +0000ffa0: 6f6e 2049 5076 363a 2a3a 6b65 7262 6572  on IPv6:*:kerber
│ │ │ │ +0000ffb0: 6f73 2f75 6470 2e2e 2e66 6169 6c65 640a  os/udp...failed.
│ │ │ │ +0000ffc0: 2020 2020 2073 6f63 6b65 743a 2041 6464       socket: Add
│ │ │ │ +0000ffd0: 7265 7373 2066 616d 696c 7920 6e6f 7420  ress family not 
│ │ │ │ +0000ffe0: 7375 7070 6f72 7465 6420 6279 2070 726f  supported by pro
│ │ │ │ +0000fff0: 746f 636f 6c0a 2020 2020 204c 6973 7465  tocol.     Liste
│ │ │ │ +00010000: 6e69 6e67 206f 6e20 4950 7636 3a2a 3a6b  ning on IPv6:*:k
│ │ │ │ +00010010: 6572 6265 726f 732f 7463 702e 2e2e 6661  erberos/tcp...fa
│ │ │ │ +00010020: 696c 6564 0a20 2020 2020 736f 636b 6574  iled.     socket
│ │ │ │ +00010030: 3a20 4164 6472 6573 7320 6661 6d69 6c79  : Address family
│ │ │ │ +00010040: 206e 6f74 2073 7570 706f 7274 6564 2062   not supported b
│ │ │ │ +00010050: 7920 7072 6f74 6f63 6f6c 0a20 2020 2020  y protocol.     
│ │ │ │ +00010060: 4c69 7374 656e 696e 6720 6f6e 2032 2070  Listening on 2 p
│ │ │ │ +00010070: 6f72 7473 2e2e 2e0a 0a20 2020 5275 6e6e  orts.....   Runn
│ │ │ │ +00010080: 696e 6720 6173 2072 6f6f 7420 6973 206e  ing as root is n
│ │ │ │ +00010090: 6f74 2072 6563 6f6d 6d65 6e64 6564 2e20  ot recommended. 
│ │ │ │ +000100a0: 2041 6e79 2073 6563 7572 6974 7920 7072   Any security pr
│ │ │ │ +000100b0: 6f62 6c65 6d20 696e 2073 6869 7368 6964  oblem in shishid
│ │ │ │ +000100c0: 0a61 6e64 2079 6f75 7220 686f 7374 206d  .and your host m
│ │ │ │ +000100d0: 6179 2062 6520 636f 6d70 726f 6d69 7365  ay be compromise
│ │ │ │ +000100e0: 642e 2020 5468 6572 6566 6f72 2c20 7765  d.  Therefor, we
│ │ │ │ +000100f0: 2072 6563 6f6d 6d65 6e64 2075 7369 6e67   recommend using
│ │ │ │ +00010100: 2074 6865 0ae2 8098 2d2d 7365 7475 6964   the....--setuid
│ │ │ │ +00010110: e280 9920 7061 7261 6d65 7465 722c 2061  ... parameter, a
│ │ │ │ +00010120: 7320 666f 6c6c 6f77 732e 0a0a 2020 2020  s follows...    
│ │ │ │ +00010130: 206c 6174 7465 3a2f 686f 6d65 2f6a 6173   latte:/home/jas
│ │ │ │ +00010140: 2f73 7263 2f73 6869 7368 6923 202f 7573  /src/shishi# /us
│ │ │ │ +00010150: 722f 6c6f 6361 6c2f 7362 696e 2f73 6869  r/local/sbin/shi
│ │ │ │ +00010160: 7368 6964 202d 2d73 6574 7569 643d 6a61  shid --setuid=ja
│ │ │ │ +00010170: 730a 2020 2020 2049 6e69 7469 616c 697a  s.     Initializ
│ │ │ │ +00010180: 696e 6720 474e 5554 4c53 2e2e 2e0a 2020  ing GNUTLS....  
│ │ │ │ +00010190: 2020 2049 6e69 7469 616c 697a 696e 6720     Initializing 
│ │ │ │ +000101a0: 474e 5554 4c53 2e2e 2e64 6f6e 650a 2020  GNUTLS...done.  
│ │ │ │ +000101b0: 2020 204c 6973 7465 6e69 6e67 206f 6e20     Listening on 
│ │ │ │ +000101c0: 4950 7634 3a2a 3a6b 6572 6265 726f 732f  IPv4:*:kerberos/
│ │ │ │ +000101d0: 7564 702e 2e2e 646f 6e65 0a20 2020 2020  udp...done.     
│ │ │ │ +000101e0: 4c69 7374 656e 696e 6720 6f6e 2049 5076  Listening on IPv
│ │ │ │ +000101f0: 343a 2a3a 6b65 7262 6572 6f73 2f74 6370  4:*:kerberos/tcp
│ │ │ │ +00010200: 2e2e 2e64 6f6e 650a 2020 2020 204c 6973  ...done.     Lis
│ │ │ │ +00010210: 7465 6e69 6e67 206f 6e20 4950 7636 3a2a  tening on IPv6:*
│ │ │ │ +00010220: 3a6b 6572 6265 726f 732f 7564 702e 2e2e  :kerberos/udp...
│ │ │ │ +00010230: 6661 696c 6564 0a20 2020 2020 736f 636b  failed.     sock
│ │ │ │ +00010240: 6574 3a20 4164 6472 6573 7320 6661 6d69  et: Address fami
│ │ │ │ +00010250: 6c79 206e 6f74 2073 7570 706f 7274 6564  ly not supported
│ │ │ │ +00010260: 2062 7920 7072 6f74 6f63 6f6c 0a20 2020   by protocol.   
│ │ │ │ +00010270: 2020 4c69 7374 656e 696e 6720 6f6e 2049    Listening on I
│ │ │ │ +00010280: 5076 363a 2a3a 6b65 7262 6572 6f73 2f74  Pv6:*:kerberos/t
│ │ │ │ +00010290: 6370 2e2e 2e66 6169 6c65 640a 2020 2020  cp...failed.    
│ │ │ │ +000102a0: 2073 6f63 6b65 743a 2041 6464 7265 7373   socket: Address
│ │ │ │ +000102b0: 2066 616d 696c 7920 6e6f 7420 7375 7070   family not supp
│ │ │ │ +000102c0: 6f72 7465 6420 6279 2070 726f 746f 636f  orted by protoco
│ │ │ │ +000102d0: 6c0a 2020 2020 204c 6973 7465 6e69 6e67  l.     Listening
│ │ │ │ +000102e0: 206f 6e20 3220 706f 7274 732e 2e2e 0a20   on 2 ports.... 
│ │ │ │ +000102f0: 2020 2020 5573 6572 2069 6465 6e74 6974      User identit
│ │ │ │ +00010300: 7920 7365 7420 746f 2060 6a61 7327 2028  y set to `jas' (
│ │ │ │ +00010310: 3232 3534 3129 2e2e 2e0a 0a20 2020 416e  22541).....   An
│ │ │ │ +00010320: 2061 6c74 6572 6e61 7469 7665 2069 7320   alternative is 
│ │ │ │ +00010330: 746f 2072 756e 2073 6869 7368 6964 206f  to run shishid o
│ │ │ │ +00010340: 6e20 616e 2061 6c74 6572 6e61 7469 7665  n an alternative
│ │ │ │ +00010350: 2070 6f72 7420 6173 2061 0a6e 6f6e 2d70   port as a.non-p
│ │ │ │ +00010360: 7269 7669 6c65 6765 6420 7573 6572 2e20  rivileged user. 
│ │ │ │ +00010370: 2054 6f20 636f 6e74 696e 7565 2074 6865   To continue the
│ │ │ │ +00010380: 2065 7861 6d70 6c65 206f 6620 7365 7474   example of sett
│ │ │ │ +00010390: 696e 6720 7570 2074 6865 0ae2 8098 4558  ing up the....EX
│ │ │ │ +000103a0: 414d 504c 452e 4f52 47e2 8099 2072 6561  AMPLE.ORG... rea
│ │ │ │ +000103b0: 6c6d 2061 7320 6120 6e6f 6e2d 7072 6976  lm as a non-priv
│ │ │ │ +000103c0: 696c 6567 6564 2075 7365 7220 6672 6f6d  ileged user from
│ │ │ │ +000103d0: 2074 6865 2070 7265 6365 6469 6e67 2073   the preceding s
│ │ │ │ +000103e0: 6563 7469 6f6e 2c0a 7765 2073 7461 7274  ection,.we start
│ │ │ │ +000103f0: 2074 6865 2073 6572 7665 7220 6c69 7374   the server list
│ │ │ │ +00010400: 656e 206f 6e20 706f 7274 2034 3731 3120  en on port 4711 
│ │ │ │ +00010410: 7669 6120 5544 5020 6f6e 2049 5076 342e  via UDP on IPv4.
│ │ │ │ +00010420: 0a0a 2020 2020 206a 6173 406c 6174 7465  ..     jas@latte
│ │ │ │ +00010430: 3a7e 2420 2f75 7372 2f6c 6f63 616c 2f73  :~$ /usr/local/s
│ │ │ │ +00010440: 6269 6e2f 7368 6973 6869 6420 2d6c 2049  bin/shishid -l I
│ │ │ │ +00010450: 5076 343a 2a3a 3437 3131 2f75 6470 0a20  Pv4:*:4711/udp. 
│ │ │ │ +00010460: 2020 2020 496e 6974 6961 6c69 7a69 6e67      Initializing
│ │ │ │ +00010470: 2047 4e55 544c 532e 2e2e 0a20 2020 2020   GNUTLS....     
│ │ │ │ +00010480: 496e 6974 6961 6c69 7a69 6e67 2047 4e55  Initializing GNU
│ │ │ │ +00010490: 544c 532e 2e2e 646f 6e65 0a20 2020 2020  TLS...done.     
│ │ │ │ +000104a0: 4c69 7374 656e 696e 6720 6f6e 202a 3a34  Listening on *:4
│ │ │ │ +000104b0: 3731 312f 7463 702e 2e2e 0a20 2020 2020  711/tcp....     
│ │ │ │ +000104c0: 4c69 7374 656e 696e 6720 6f6e 2031 2070  Listening on 1 p
│ │ │ │ +000104d0: 6f72 7473 2e2e 2e0a 2020 2020 2073 6869  orts....     shi
│ │ │ │ +000104e0: 7368 6964 3a20 5374 6172 7469 6e67 2028  shid: Starting (
│ │ │ │ +000104f0: 474e 5554 4c53 2060 312e 302e 3427 290a  GNUTLS `1.0.4').
│ │ │ │ +00010500: 2020 2020 2073 6869 7368 6964 3a20 4c69       shishid: Li
│ │ │ │ +00010510: 7374 656e 696e 6720 6f6e 202a 3a34 3731  stening on *:471
│ │ │ │ +00010520: 312f 7463 7020 736f 636b 6574 2034 0a0a  1/tcp socket 4..
│ │ │ │ +00010530: 2020 2049 6620 796f 7520 6861 7665 2073     If you have s
│ │ │ │ +00010540: 6574 2075 7020 7468 6520 5368 6973 6120  et up the Shisa 
│ │ │ │ +00010550: 6461 7461 6261 7365 2061 7320 696e 2074  database as in t
│ │ │ │ +00010560: 6865 2070 7265 7669 6f75 7320 6578 616d  he previous exam
│ │ │ │ +00010570: 706c 652c 2079 6f75 0a63 616e 206e 6f77  ple, you.can now
│ │ │ │ +00010580: 2061 6371 7569 7265 2074 6963 6b65 7473   acquire tickets
│ │ │ │ +00010590: 2061 7320 666f 6c6c 6f77 732e 0a0a 2020   as follows...  
│ │ │ │ +000105a0: 2020 206a 6173 406c 6174 7465 3a7e 2420     jas@latte:~$ 
│ │ │ │ +000105b0: 7368 6973 6869 202d 6f20 2772 6561 6c6d  shishi -o 'realm
│ │ │ │ +000105c0: 2d6b 6463 3d45 5841 4d50 4c45 2e4f 5247  -kdc=EXAMPLE.ORG
│ │ │ │ +000105d0: 2c6c 6f63 616c 686f 7374 3a34 3731 3127  ,localhost:4711'
│ │ │ │ +000105e0: 205c 0a20 2020 2020 2020 2073 696d 6f6e   \.        simon
│ │ │ │ +000105f0: 4045 5841 4d50 4c45 2e4f 5247 0a20 2020  @EXAMPLE.ORG.   
│ │ │ │ +00010600: 2020 456e 7465 7220 7061 7373 776f 7264    Enter password
│ │ │ │ +00010610: 2066 6f72 2060 7369 6d6f 6e40 4558 414d   for `simon@EXAM
│ │ │ │ +00010620: 504c 452e 4f52 4727 3a0a 2020 2020 2073  PLE.ORG':.     s
│ │ │ │ +00010630: 696d 6f6e 4045 5841 4d50 4c45 2e4f 5247  imon@EXAMPLE.ORG
│ │ │ │ +00010640: 3a0a 2020 2020 2041 7574 6874 696d 653a  :.     Authtime:
│ │ │ │ +00010650: 2020 2020 2020 2046 7269 2044 6563 2031         Fri Dec 1
│ │ │ │ +00010660: 3220 3031 3a34 313a 3031 2032 3030 330a  2 01:41:01 2003.
│ │ │ │ +00010670: 2020 2020 2045 6e64 7469 6d65 3a20 2020       Endtime:   
│ │ │ │ +00010680: 2020 2020 2046 7269 2044 6563 2031 3220       Fri Dec 12 
│ │ │ │ +00010690: 3031 3a35 373a 3431 2032 3030 330a 2020  01:57:41 2003.  
│ │ │ │ +000106a0: 2020 2053 6572 7665 723a 2020 2020 2020     Server:      
│ │ │ │ +000106b0: 2020 206b 7262 7467 742f 4558 414d 504c     krbtgt/EXAMPL
│ │ │ │ +000106c0: 452e 4f52 4720 6b65 7920 6165 7332 3536  E.ORG key aes256
│ │ │ │ +000106d0: 2d63 7473 2d68 6d61 632d 7368 6131 2d39  -cts-hmac-sha1-9
│ │ │ │ +000106e0: 3620 2831 3829 0a20 2020 2020 5469 636b  6 (18).     Tick
│ │ │ │ +000106f0: 6574 206b 6579 3a20 2020 2020 6165 7332  et key:     aes2
│ │ │ │ +00010700: 3536 2d63 7473 2d68 6d61 632d 7368 6131  56-cts-hmac-sha1
│ │ │ │ +00010710: 2d39 3620 2831 3829 2070 726f 7465 6374  -96 (18) protect
│ │ │ │ +00010720: 6564 2062 7920 6165 7332 3536 2d63 7473  ed by aes256-cts
│ │ │ │ +00010730: 2d68 6d61 632d 7368 6131 2d39 3620 2831  -hmac-sha1-96 (1
│ │ │ │ +00010740: 3829 0a20 2020 2020 5469 636b 6574 2066  8).     Ticket f
│ │ │ │ +00010750: 6c61 6773 3a20 2020 464f 5257 4152 4445  lags:   FORWARDE
│ │ │ │ +00010760: 4420 5052 4f58 4941 424c 4520 5245 4e45  D PROXIABLE RENE
│ │ │ │ +00010770: 5741 424c 4520 494e 4954 4941 4c20 2831  WABLE INITIAL (1
│ │ │ │ +00010780: 3229 0a20 2020 2020 6a61 7340 6c61 7474  2).     jas@latt
│ │ │ │ +00010790: 653a 7e24 0a0a 2020 2054 6865 206f 7574  e:~$..   The out
│ │ │ │ +000107a0: 7075 7420 6672 6f6d 2053 6869 7368 6964  put from Shishid
│ │ │ │ +000107b0: 206f 6e20 6120 7375 6363 6573 7366 756c   on a successful
│ │ │ │ +000107c0: 2069 6e76 6f63 6174 696f 6e20 776f 756c   invocation woul
│ │ │ │ +000107d0: 6420 6c6f 6f6b 206c 696b 653a 0a0a 2020  d look like:..  
│ │ │ │ +000107e0: 2020 2073 6869 7368 6964 3a20 4861 7320     shishid: Has 
│ │ │ │ +000107f0: 3133 3120 6279 7465 7320 6672 6f6d 202a  131 bytes from *
│ │ │ │ +00010800: 3a34 3731 312f 7564 7020 6f6e 2073 6f63  :4711/udp on soc
│ │ │ │ +00010810: 6b65 7420 340a 2020 2020 2073 6869 7368  ket 4.     shish
│ │ │ │ +00010820: 6964 3a20 5072 6f63 6573 7369 6e67 2031  id: Processing 1
│ │ │ │ +00010830: 3331 2066 726f 6d20 2a3a 3437 3131 2f75  31 from *:4711/u
│ │ │ │ +00010840: 6470 206f 6e20 736f 636b 6574 2034 0a20  dp on socket 4. 
│ │ │ │ +00010850: 2020 2020 7368 6973 6869 643a 2054 7279      shishid: Try
│ │ │ │ +00010860: 696e 6720 4153 2d52 4551 0a20 2020 2020  ing AS-REQ.     
│ │ │ │ +00010870: 7368 6973 6869 643a 2041 532d 5245 5120  shishid: AS-REQ 
│ │ │ │ +00010880: 6672 6f6d 2073 696d 6f6e 4045 5841 4d50  from simon@EXAMP
│ │ │ │ +00010890: 4c45 2e4f 5247 2066 6f72 206b 7262 7467  LE.ORG for krbtg
│ │ │ │ +000108a0: 742f 4558 414d 504c 452e 4f52 4740 4558  t/EXAMPLE.ORG@EX
│ │ │ │ +000108b0: 414d 504c 452e 4f52 470a 2020 2020 2073  AMPLE.ORG.     s
│ │ │ │ +000108c0: 6869 7368 6964 3a20 4d61 7463 6869 6e67  hishid: Matching
│ │ │ │ +000108d0: 2063 6c69 656e 7420 6574 7970 6520 3138   client etype 18
│ │ │ │ +000108e0: 2061 6761 696e 7374 2075 7365 7220 6b65   against user ke
│ │ │ │ +000108f0: 7920 6574 7970 6520 3138 0a20 2020 2020  y etype 18.     
│ │ │ │ +00010900: 7368 6973 6869 643a 2048 6176 6520 3531  shishid: Have 51
│ │ │ │ +00010910: 3120 6279 7465 7320 666f 7220 2a3a 3437  1 bytes for *:47
│ │ │ │ +00010920: 3131 2f75 6470 206f 6e20 736f 636b 6574  11/udp on socket
│ │ │ │ +00010930: 2034 0a20 2020 2020 7368 6973 6869 643a   4.     shishid:
│ │ │ │ +00010940: 2053 656e 6469 6e67 2035 3131 2062 7974   Sending 511 byt
│ │ │ │ +00010950: 6573 2074 6f20 2a3a 3437 3131 2f75 6470  es to *:4711/udp
│ │ │ │ +00010960: 2073 6f63 6b65 7420 3420 7669 6120 5544   socket 4 via UD
│ │ │ │ +00010970: 500a 2020 2020 2073 6869 7368 6964 3a20  P.     shishid: 
│ │ │ │ +00010980: 4c69 7374 656e 696e 6720 6f6e 202a 3a34  Listening on *:4
│ │ │ │ +00010990: 3731 312f 7564 7020 736f 636b 6574 2034  711/udp socket 4
│ │ │ │ +000109a0: 0a0a 2020 2059 6f75 206d 6179 2075 7365  ..   You may use
│ │ │ │ +000109b0: 2074 6865 2027 2d76 2720 7061 7261 6d65   the '-v' parame
│ │ │ │ +000109c0: 7465 7220 666f 7220 5368 6973 6869 6420  ter for Shishid 
│ │ │ │ +000109d0: 616e 6420 5368 6973 6869 2074 6f20 6765  and Shishi to ge
│ │ │ │ +000109e0: 6e65 7261 7465 0a6d 6f72 6520 6465 6275  nerate.more debu
│ │ │ │ +000109f0: 6767 696e 6720 696e 666f 726d 6174 696f  gging informatio
│ │ │ │ +00010a00: 6e2e 0a0a 2020 2054 6f20 696c 6c75 7374  n...   To illust
│ │ │ │ +00010a10: 7261 7465 2077 6861 7420 616e 2061 7070  rate what an app
│ │ │ │ +00010a20: 6c69 6361 7469 6f6e 2c20 7375 6368 2061  lication, such a
│ │ │ │ +00010a30: 7320 7468 6520 5368 6973 6869 2070 6174  s the Shishi pat
│ │ │ │ +00010a40: 6368 6564 0a76 6572 7369 6f6e 7320 6f66  ched.versions of
│ │ │ │ +00010a50: 2047 4e55 206c 7368 206f 7220 5465 6c6e   GNU lsh or Teln
│ │ │ │ +00010a60: 6574 2066 726f 6d20 474e 5520 496e 6574  et from GNU Inet
│ │ │ │ +00010a70: 5574 696c 732c 2077 6f75 6c64 2064 6f20  Utils, would do 
│ │ │ │ +00010a80: 7768 656e 0a63 6f6e 7461 6374 696e 6720  when.contacting 
│ │ │ │ +00010a90: 7468 6520 686f 7374 20e2 8098 6d61 696c  the host ...mail
│ │ │ │ +00010aa0: 2e65 7861 6d70 6c65 2e6f 7267 e280 9920  .example.org... 
│ │ │ │ +00010ab0: 7765 2069 6c6c 7573 7472 6174 6520 7573  we illustrate us
│ │ │ │ +00010ac0: 696e 6720 7468 6520 5447 530a 7365 7276  ing the TGS.serv
│ │ │ │ +00010ad0: 6963 6520 6173 2077 656c 6c2e 0a0a 2020  ice as well...  
│ │ │ │ +00010ae0: 2020 206a 6173 406c 6174 7465 3a7e 2420     jas@latte:~$ 
│ │ │ │ +00010af0: 7368 6973 6869 202d 6f20 2772 6561 6c6d  shishi -o 'realm
│ │ │ │ +00010b00: 2d6b 6463 3d45 5841 4d50 4c45 2e4f 5247  -kdc=EXAMPLE.ORG
│ │ │ │ +00010b10: 2c6c 6f63 616c 686f 7374 3a34 3731 3127  ,localhost:4711'
│ │ │ │ +00010b20: 205c 0a20 2020 2020 2020 2073 696d 6f6e   \.        simon
│ │ │ │ +00010b30: 4045 5841 4d50 4c45 2e4f 5247 2068 6f73  @EXAMPLE.ORG hos
│ │ │ │ +00010b40: 742f 6d61 696c 2e65 7861 6d70 6c65 2e6f  t/mail.example.o
│ │ │ │ +00010b50: 7267 0a20 2020 2020 7369 6d6f 6e40 4558  rg.     simon@EX
│ │ │ │ +00010b60: 414d 504c 452e 4f52 473a 0a20 2020 2020  AMPLE.ORG:.     
│ │ │ │ +00010b70: 4175 7468 7469 6d65 3a20 2020 2020 2020  Authtime:       
│ │ │ │ +00010b80: 4672 6920 4465 6320 3132 2030 313a 3436  Fri Dec 12 01:46
│ │ │ │ +00010b90: 3a35 3420 3230 3033 0a20 2020 2020 456e  :54 2003.     En
│ │ │ │ +00010ba0: 6474 696d 653a 2020 2020 2020 2020 4672  dtime:        Fr
│ │ │ │ +00010bb0: 6920 4465 6320 3132 2030 323a 3033 3a33  i Dec 12 02:03:3
│ │ │ │ +00010bc0: 3420 3230 3033 0a20 2020 2020 5365 7276  4 2003.     Serv
│ │ │ │ +00010bd0: 6572 3a20 2020 2020 2020 2020 686f 7374  er:         host
│ │ │ │ +00010be0: 2f6d 6169 6c2e 6578 616d 706c 652e 6f72  /mail.example.or
│ │ │ │ +00010bf0: 6720 6b65 7920 6465 7333 2d63 6263 2d73  g key des3-cbc-s
│ │ │ │ +00010c00: 6861 312d 6b64 2028 3136 290a 2020 2020  ha1-kd (16).    
│ │ │ │ +00010c10: 2054 6963 6b65 7420 6b65 793a 2020 2020   Ticket key:    
│ │ │ │ +00010c20: 2064 6573 332d 6362 632d 7368 6131 2d6b   des3-cbc-sha1-k
│ │ │ │ +00010c30: 6420 2831 3629 2070 726f 7465 6374 6564  d (16) protected
│ │ │ │ +00010c40: 2062 7920 6165 7332 3536 2d63 7473 2d68   by aes256-cts-h
│ │ │ │ +00010c50: 6d61 632d 7368 6131 2d39 3620 2831 3829  mac-sha1-96 (18)
│ │ │ │ +00010c60: 0a20 2020 2020 5469 636b 6574 2066 6c61  .     Ticket fla
│ │ │ │ +00010c70: 6773 3a20 2020 464f 5257 4152 4445 4420  gs:   FORWARDED 
│ │ │ │ +00010c80: 5052 4f58 4941 424c 4520 2834 3533 3938  PROXIABLE (45398
│ │ │ │ +00010c90: 3739 3629 0a20 2020 2020 6a61 7340 6c61  796).     jas@la
│ │ │ │ +00010ca0: 7474 653a 7e24 0a0a 2020 2054 6869 7320  tte:~$..   This 
│ │ │ │ +00010cb0: 636f 6e63 6c75 6465 206f 7572 2077 616c  conclude our wal
│ │ │ │ +00010cc0: 6b2d 7468 726f 7567 6820 6f66 2073 6574  k-through of set
│ │ │ │ +00010cd0: 7469 6e67 2075 7020 6120 6e65 7720 4b65  ting up a new Ke
│ │ │ │ +00010ce0: 7262 6572 6f73 2072 6561 6c6d 0a75 7369  rberos realm.usi
│ │ │ │ +00010cf0: 6e67 2053 6869 7368 692e 2020 4974 2069  ng Shishi.  It i
│ │ │ │ +00010d00: 7320 7175 6974 6520 6c69 6b65 6c79 2074  s quite likely t
│ │ │ │ +00010d10: 6861 7420 6f6e 6520 6f72 206d 6f72 6520  hat one or more 
│ │ │ │ +00010d20: 7374 6570 7320 6661 696c 6564 2c20 616e  steps failed, an
│ │ │ │ +00010d30: 6420 6966 0a73 6f20 7765 2065 6e63 6f75  d if.so we encou
│ │ │ │ +00010d40: 7261 6765 2079 6f75 2074 6f20 6465 6275  rage you to debu
│ │ │ │ +00010d50: 6720 6974 2061 6e64 2073 7562 6d69 7420  g it and submit 
│ │ │ │ +00010d60: 6120 7061 7463 682c 206f 7220 6174 206c  a patch, or at l
│ │ │ │ +00010d70: 6561 7374 2072 6570 6f72 740a 6974 2061  east report.it a
│ │ │ │ +00010d80: 7320 6120 7072 6f62 6c65 6d2e 2020 4865  s a problem.  He
│ │ │ │ +00010d90: 636b 2c20 6576 656e 206c 6574 7469 6e67  ck, even letting
│ │ │ │ +00010da0: 2075 7320 6b6e 6f77 2069 6620 796f 7520   us know if you 
│ │ │ │ +00010db0: 676f 7420 7468 6973 2066 6172 2077 6f75  got this far wou
│ │ │ │ +00010dc0: 6c64 0a62 6520 6f66 2069 6e74 6572 6573  ld.be of interes
│ │ │ │ +00010dd0: 742e 2020 2a4e 6f74 6520 4275 6720 5265  t.  *Note Bug Re
│ │ │ │ +00010de0: 706f 7274 733a 3a2e 0a0a 1f0a 4669 6c65  ports::.....File
│ │ │ │ +00010df0: 3a20 7368 6973 6869 2e69 6e66 6f2c 2020  : shishi.info,  
│ │ │ │ +00010e00: 4e6f 6465 3a20 436f 6e66 6967 7572 696e  Node: Configurin
│ │ │ │ +00010e10: 6720 444e 5320 666f 7220 4b44 432c 2020  g DNS for KDC,  
│ │ │ │ +00010e20: 4e65 7874 3a20 4b65 7262 6572 6f73 2076  Next: Kerberos v
│ │ │ │ +00010e30: 6961 2054 4c53 2c20 2050 7265 763a 2053  ia TLS,  Prev: S
│ │ │ │ +00010e40: 7461 7274 696e 6720 5368 6973 6869 642c  tarting Shishid,
│ │ │ │ +00010e50: 2020 5570 3a20 4164 6d69 6e69 7374 7261    Up: Administra
│ │ │ │ +00010e60: 7469 6f6e 204d 616e 7561 6c0a 0a33 2e35  tion Manual..3.5
│ │ │ │ +00010e70: 2043 6f6e 6669 6775 7269 6e67 2044 4e53   Configuring DNS
│ │ │ │ +00010e80: 2066 6f72 204b 4443 0a3d 3d3d 3d3d 3d3d   for KDC.=======
│ │ │ │  00010e90: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ -00010ea0: 3d3d 0a0a 4d61 6b69 6e67 2073 7572 6520  ==..Making sure 
│ │ │ │ -00010eb0: 7468 6520 636f 6e66 6967 7572 6174 696f  the configuratio
│ │ │ │ -00010ec0: 6e20 6669 6c65 7320 6f6e 2061 6c6c 2068  n files on all h
│ │ │ │ -00010ed0: 6f73 7473 2072 756e 6e69 6e67 2053 6869  osts running Shi
│ │ │ │ -00010ee0: 7368 6920 636c 6965 6e74 730a 696e 636c  shi clients.incl
│ │ │ │ -00010ef0: 7564 6520 7468 6520 6164 6472 6573 7365  ude the addresse
│ │ │ │ -00010f00: 7320 6f66 2079 6f75 7220 7365 7276 6572  s of your server
│ │ │ │ -00010f10: 2069 7320 7465 6469 6f75 732e 2020 4966   is tedious.  If
│ │ │ │ -00010f20: 2074 6865 2063 6f6e 6669 6775 7261 7469   the configurati
│ │ │ │ -00010f30: 6f6e 0a66 696c 6573 2064 6f20 6e6f 7420  on.files do not 
│ │ │ │ -00010f40: 6d65 6e74 696f 6e20 7468 6520 4b44 4320  mention the KDC 
│ │ │ │ -00010f50: 6164 6472 6573 7320 666f 7220 6120 7265  address for a re
│ │ │ │ -00010f60: 616c 6d2c 2053 6869 7368 6920 7769 6c6c  alm, Shishi will
│ │ │ │ -00010f70: 2074 7279 2074 6f0a 6c6f 6f6b 2075 7020   try to.look up 
│ │ │ │ -00010f80: 7468 6520 696e 666f 726d 6174 696f 6e20  the information 
│ │ │ │ -00010f90: 6672 6f6d 2044 4e53 2e20 496e 206f 7264  from DNS. In ord
│ │ │ │ -00010fa0: 6572 2066 6f72 2053 6869 7368 6920 746f  er for Shishi to
│ │ │ │ -00010fb0: 2066 696e 6420 7468 6174 0a69 6e66 6f72   find that.infor
│ │ │ │ -00010fc0: 6d61 7469 6f6e 2c20 796f 7520 6e65 6564  mation, you need
│ │ │ │ -00010fd0: 2074 6f20 6164 6420 7468 6520 696e 666f   to add the info
│ │ │ │ -00010fe0: 726d 6174 696f 6e20 746f 2044 4e53 2e20  rmation to DNS. 
│ │ │ │ -00010ff0: 466f 7220 7468 6973 2074 6f20 776f 726b  For this to work
│ │ │ │ -00011000: 0a77 656c 6c2c 2079 6f75 206e 6565 6420  .well, you need 
│ │ │ │ -00011010: 746f 2073 6574 2075 7020 6120 444e 5320  to set up a DNS 
│ │ │ │ -00011020: 7a6f 6e65 2077 6974 6820 7468 6520 7361  zone with the sa
│ │ │ │ -00011030: 6d65 206e 616d 6520 6173 2079 6f75 7220  me name as your 
│ │ │ │ -00011040: 4b65 7262 6572 6f73 0a72 6561 6c6d 2e20  Kerberos.realm. 
│ │ │ │ -00011050: 2054 6865 2065 6173 6965 7374 2069 7320   The easiest is 
│ │ │ │ -00011060: 6966 2079 6f75 206f 776e 2074 6865 2070  if you own the p
│ │ │ │ -00011070: 7562 6c69 636c 7920 7669 7369 626c 6520  ublicly visible 
│ │ │ │ -00011080: 444e 5320 6e61 6d65 2c20 7375 6368 2061  DNS name, such a
│ │ │ │ -00011090: 730a e280 9865 7861 6d70 6c65 2e6f 7267  s....example.org
│ │ │ │ -000110a0: e280 9920 6966 2079 6f75 7220 7265 616c  ... if your real
│ │ │ │ -000110b0: 6d20 6973 20e2 8098 4558 414d 504c 452e  m is ...EXAMPLE.
│ │ │ │ -000110c0: 4f52 47e2 8099 2c20 6275 7420 796f 7520  ORG..., but you 
│ │ │ │ -000110d0: 6361 6e20 7365 7420 7570 2061 6e0a 696e  can set up an.in
│ │ │ │ -000110e0: 7465 726e 616c 2044 4e53 2073 6572 7665  ternal DNS serve
│ │ │ │ -000110f0: 7220 7769 7468 2074 6865 2069 6e66 6f72  r with the infor
│ │ │ │ -00011100: 6d61 7469 6f6e 2066 6f72 2079 6f75 7220  mation for your 
│ │ │ │ -00011110: 7265 616c 6d20 6f6e 6c79 2e20 2049 6620  realm only.  If 
│ │ │ │ -00011120: 7468 6973 0a69 7320 646f 6e65 2c20 796f  this.is done, yo
│ │ │ │ -00011130: 7520 646f 206e 6f74 206e 6565 6420 746f  u do not need to
│ │ │ │ -00011140: 206b 6565 7020 636f 6e66 6967 7572 6174   keep configurat
│ │ │ │ -00011150: 696f 6e20 6669 6c65 7320 7570 6461 7465  ion files update
│ │ │ │ -00011160: 6420 666f 7220 7468 6520 4b44 430a 6164  d for the KDC.ad
│ │ │ │ -00011170: 6472 6573 7369 6e67 2069 6e66 6f72 6d61  dressing informa
│ │ │ │ -00011180: 7469 6f6e 2e0a 0a33 2e35 2e31 2044 4e53  tion...3.5.1 DNS
│ │ │ │ -00011190: 2076 732e 204b 6572 6265 726f 7320 2d20   vs. Kerberos - 
│ │ │ │ -000111a0: 4361 7365 2053 656e 7369 7469 7669 7479  Case Sensitivity
│ │ │ │ -000111b0: 206f 6620 5265 616c 6d20 4e61 6d65 730a   of Realm Names.
│ │ │ │ -000111c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +00010ea0: 3d3d 3d3d 0a0a 4d61 6b69 6e67 2073 7572  ====..Making sur
│ │ │ │ +00010eb0: 6520 7468 6520 636f 6e66 6967 7572 6174  e the configurat
│ │ │ │ +00010ec0: 696f 6e20 6669 6c65 7320 6f6e 2061 6c6c  ion files on all
│ │ │ │ +00010ed0: 2068 6f73 7473 2072 756e 6e69 6e67 2053   hosts running S
│ │ │ │ +00010ee0: 6869 7368 6920 636c 6965 6e74 730a 696e  hishi clients.in
│ │ │ │ +00010ef0: 636c 7564 6520 7468 6520 6164 6472 6573  clude the addres
│ │ │ │ +00010f00: 7365 7320 6f66 2079 6f75 7220 7365 7276  ses of your serv
│ │ │ │ +00010f10: 6572 2069 7320 7465 6469 6f75 732e 2020  er is tedious.  
│ │ │ │ +00010f20: 4966 2074 6865 2063 6f6e 6669 6775 7261  If the configura
│ │ │ │ +00010f30: 7469 6f6e 0a66 696c 6573 2064 6f20 6e6f  tion.files do no
│ │ │ │ +00010f40: 7420 6d65 6e74 696f 6e20 7468 6520 4b44  t mention the KD
│ │ │ │ +00010f50: 4320 6164 6472 6573 7320 666f 7220 6120  C address for a 
│ │ │ │ +00010f60: 7265 616c 6d2c 2053 6869 7368 6920 7769  realm, Shishi wi
│ │ │ │ +00010f70: 6c6c 2074 7279 2074 6f0a 6c6f 6f6b 2075  ll try to.look u
│ │ │ │ +00010f80: 7020 7468 6520 696e 666f 726d 6174 696f  p the informatio
│ │ │ │ +00010f90: 6e20 6672 6f6d 2044 4e53 2e20 496e 206f  n from DNS. In o
│ │ │ │ +00010fa0: 7264 6572 2066 6f72 2053 6869 7368 6920  rder for Shishi 
│ │ │ │ +00010fb0: 746f 2066 696e 6420 7468 6174 0a69 6e66  to find that.inf
│ │ │ │ +00010fc0: 6f72 6d61 7469 6f6e 2c20 796f 7520 6e65  ormation, you ne
│ │ │ │ +00010fd0: 6564 2074 6f20 6164 6420 7468 6520 696e  ed to add the in
│ │ │ │ +00010fe0: 666f 726d 6174 696f 6e20 746f 2044 4e53  formation to DNS
│ │ │ │ +00010ff0: 2e20 466f 7220 7468 6973 2074 6f20 776f  . For this to wo
│ │ │ │ +00011000: 726b 0a77 656c 6c2c 2079 6f75 206e 6565  rk.well, you nee
│ │ │ │ +00011010: 6420 746f 2073 6574 2075 7020 6120 444e  d to set up a DN
│ │ │ │ +00011020: 5320 7a6f 6e65 2077 6974 6820 7468 6520  S zone with the 
│ │ │ │ +00011030: 7361 6d65 206e 616d 6520 6173 2079 6f75  same name as you
│ │ │ │ +00011040: 7220 4b65 7262 6572 6f73 0a72 6561 6c6d  r Kerberos.realm
│ │ │ │ +00011050: 2e20 2054 6865 2065 6173 6965 7374 2069  .  The easiest i
│ │ │ │ +00011060: 7320 6966 2079 6f75 206f 776e 2074 6865  s if you own the
│ │ │ │ +00011070: 2070 7562 6c69 636c 7920 7669 7369 626c   publicly visibl
│ │ │ │ +00011080: 6520 444e 5320 6e61 6d65 2c20 7375 6368  e DNS name, such
│ │ │ │ +00011090: 2061 730a e280 9865 7861 6d70 6c65 2e6f   as....example.o
│ │ │ │ +000110a0: 7267 e280 9920 6966 2079 6f75 7220 7265  rg... if your re
│ │ │ │ +000110b0: 616c 6d20 6973 20e2 8098 4558 414d 504c  alm is ...EXAMPL
│ │ │ │ +000110c0: 452e 4f52 47e2 8099 2c20 6275 7420 796f  E.ORG..., but yo
│ │ │ │ +000110d0: 7520 6361 6e20 7365 7420 7570 2061 6e0a  u can set up an.
│ │ │ │ +000110e0: 696e 7465 726e 616c 2044 4e53 2073 6572  internal DNS ser
│ │ │ │ +000110f0: 7665 7220 7769 7468 2074 6865 2069 6e66  ver with the inf
│ │ │ │ +00011100: 6f72 6d61 7469 6f6e 2066 6f72 2079 6f75  ormation for you
│ │ │ │ +00011110: 7220 7265 616c 6d20 6f6e 6c79 2e20 2049  r realm only.  I
│ │ │ │ +00011120: 6620 7468 6973 0a69 7320 646f 6e65 2c20  f this.is done, 
│ │ │ │ +00011130: 796f 7520 646f 206e 6f74 206e 6565 6420  you do not need 
│ │ │ │ +00011140: 746f 206b 6565 7020 636f 6e66 6967 7572  to keep configur
│ │ │ │ +00011150: 6174 696f 6e20 6669 6c65 7320 7570 6461  ation files upda
│ │ │ │ +00011160: 7465 6420 666f 7220 7468 6520 4b44 430a  ted for the KDC.
│ │ │ │ +00011170: 6164 6472 6573 7369 6e67 2069 6e66 6f72  addressing infor
│ │ │ │ +00011180: 6d61 7469 6f6e 2e0a 0a33 2e35 2e31 2044  mation...3.5.1 D
│ │ │ │ +00011190: 4e53 2076 732e 204b 6572 6265 726f 7320  NS vs. Kerberos 
│ │ │ │ +000111a0: 2d20 4361 7365 2053 656e 7369 7469 7669  - Case Sensitivi
│ │ │ │ +000111b0: 7479 206f 6620 5265 616c 6d20 4e61 6d65  ty of Realm Name
│ │ │ │ +000111c0: 730a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  s.--------------
│ │ │ │  000111d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │  000111e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000111f0: 2d2d 2d2d 2d2d 2d2d 0a0a 496e 204b 6572  --------..In Ker
│ │ │ │ -00011200: 6265 726f 732c 2072 6561 6c6d 206e 616d  beros, realm nam
│ │ │ │ -00011210: 6573 2061 7265 2063 6173 6520 7365 6e73  es are case sens
│ │ │ │ -00011220: 6974 6976 652e 2020 5768 696c 6520 6974  itive.  While it
│ │ │ │ -00011230: 2069 7320 7374 726f 6e67 6c79 0a65 6e63   is strongly.enc
│ │ │ │ -00011240: 6f75 7261 6765 6420 7468 6174 2061 6c6c  ouraged that all
│ │ │ │ -00011250: 2072 6561 6c6d 206e 616d 6573 2062 6520   realm names be 
│ │ │ │ -00011260: 616c 6c20 7570 7065 7220 6361 7365 2074  all upper case t
│ │ │ │ -00011270: 6869 7320 7265 636f 6d6d 656e 6461 7469  his recommendati
│ │ │ │ -00011280: 6f6e 0a68 6173 206e 6f74 2062 6565 6e20  on.has not been 
│ │ │ │ -00011290: 6164 6f70 7465 6420 6279 2061 6c6c 2073  adopted by all s
│ │ │ │ -000112a0: 6974 6573 2e20 2053 6f6d 6520 7369 7465  ites.  Some site
│ │ │ │ -000112b0: 7320 7573 6520 616c 6c20 6c6f 7765 7220  s use all lower 
│ │ │ │ -000112c0: 6361 7365 206e 616d 6573 0a61 6e64 206f  case names.and o
│ │ │ │ -000112d0: 7468 6572 2075 7365 206d 6978 6564 2063  ther use mixed c
│ │ │ │ -000112e0: 6173 652e 2020 444e 5320 6f6e 2074 6865  ase.  DNS on the
│ │ │ │ -000112f0: 206f 7468 6572 2068 616e 6420 6973 2063   other hand is c
│ │ │ │ -00011300: 6173 6520 696e 7365 6e73 6974 6976 6520  ase insensitive 
│ │ │ │ -00011310: 666f 720a 7175 6572 6965 7320 6275 7420  for.queries but 
│ │ │ │ -00011320: 6973 2063 6173 6520 7072 6573 6572 7669  is case preservi
│ │ │ │ -00011330: 6e67 2066 6f72 2072 6573 706f 6e73 6573  ng for responses
│ │ │ │ -00011340: 2074 6f20 5458 5420 7175 6572 6965 732e   to TXT queries.
│ │ │ │ -00011350: 2020 5369 6e63 650a 224d 5952 4541 4c4d    Since."MYREALM
│ │ │ │ -00011360: 222c 2022 6d79 7265 616c 6d22 2c20 616e  ", "myrealm", an
│ │ │ │ -00011370: 6420 224d 7952 6561 6c6d 2220 6172 6520  d "MyRealm" are 
│ │ │ │ -00011380: 616c 6c20 6469 6666 6572 656e 7420 6974  all different it
│ │ │ │ -00011390: 2069 7320 6e65 6365 7373 6172 790a 7468   is necessary.th
│ │ │ │ -000113a0: 6174 206f 6e6c 7920 6f6e 6520 6f66 2074  at only one of t
│ │ │ │ -000113b0: 6865 2070 6f73 7369 626c 6520 636f 6d62  he possible comb
│ │ │ │ -000113c0: 696e 6174 696f 6e73 206f 6620 7570 7065  inations of uppe
│ │ │ │ -000113d0: 7220 616e 6420 6c6f 7765 7220 6361 7365  r and lower case
│ │ │ │ -000113e0: 0a63 6861 7261 6374 6572 7320 6265 2075  .characters be u
│ │ │ │ -000113f0: 7365 642e 2020 5468 6973 2072 6573 7472  sed.  This restr
│ │ │ │ -00011400: 6963 7469 6f6e 206d 6179 2062 6520 6c69  iction may be li
│ │ │ │ -00011410: 6674 6564 2069 6e20 7468 6520 6675 7475  fted in the futu
│ │ │ │ -00011420: 7265 2061 7320 7468 650a 444e 5320 6e61  re as the.DNS na
│ │ │ │ -00011430: 6d69 6e67 2073 6368 656d 6520 6973 2065  ming scheme is e
│ │ │ │ -00011440: 7870 616e 6465 6420 746f 2073 7570 706f  xpanded to suppo
│ │ │ │ -00011450: 7274 206e 6f6e 2d41 5343 4949 206e 616d  rt non-ASCII nam
│ │ │ │ -00011460: 6573 2e0a 0a33 2e35 2e32 204f 7665 7276  es...3.5.2 Overv
│ │ │ │ -00011470: 6965 7720 2d20 4b44 4320 6c6f 6361 7469  iew - KDC locati
│ │ │ │ -00011480: 6f6e 2069 6e66 6f72 6d61 7469 6f6e 0a2d  on information.-
│ │ │ │ -00011490: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +000111f0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 496e 204b  ----------..In K
│ │ │ │ +00011200: 6572 6265 726f 732c 2072 6561 6c6d 206e  erberos, realm n
│ │ │ │ +00011210: 616d 6573 2061 7265 2063 6173 6520 7365  ames are case se
│ │ │ │ +00011220: 6e73 6974 6976 652e 2020 5768 696c 6520  nsitive.  While 
│ │ │ │ +00011230: 6974 2069 7320 7374 726f 6e67 6c79 0a65  it is strongly.e
│ │ │ │ +00011240: 6e63 6f75 7261 6765 6420 7468 6174 2061  ncouraged that a
│ │ │ │ +00011250: 6c6c 2072 6561 6c6d 206e 616d 6573 2062  ll realm names b
│ │ │ │ +00011260: 6520 616c 6c20 7570 7065 7220 6361 7365  e all upper case
│ │ │ │ +00011270: 2074 6869 7320 7265 636f 6d6d 656e 6461   this recommenda
│ │ │ │ +00011280: 7469 6f6e 0a68 6173 206e 6f74 2062 6565  tion.has not bee
│ │ │ │ +00011290: 6e20 6164 6f70 7465 6420 6279 2061 6c6c  n adopted by all
│ │ │ │ +000112a0: 2073 6974 6573 2e20 2053 6f6d 6520 7369   sites.  Some si
│ │ │ │ +000112b0: 7465 7320 7573 6520 616c 6c20 6c6f 7765  tes use all lowe
│ │ │ │ +000112c0: 7220 6361 7365 206e 616d 6573 0a61 6e64  r case names.and
│ │ │ │ +000112d0: 206f 7468 6572 2075 7365 206d 6978 6564   other use mixed
│ │ │ │ +000112e0: 2063 6173 652e 2020 444e 5320 6f6e 2074   case.  DNS on t
│ │ │ │ +000112f0: 6865 206f 7468 6572 2068 616e 6420 6973  he other hand is
│ │ │ │ +00011300: 2063 6173 6520 696e 7365 6e73 6974 6976   case insensitiv
│ │ │ │ +00011310: 6520 666f 720a 7175 6572 6965 7320 6275  e for.queries bu
│ │ │ │ +00011320: 7420 6973 2063 6173 6520 7072 6573 6572  t is case preser
│ │ │ │ +00011330: 7669 6e67 2066 6f72 2072 6573 706f 6e73  ving for respons
│ │ │ │ +00011340: 6573 2074 6f20 5458 5420 7175 6572 6965  es to TXT querie
│ │ │ │ +00011350: 732e 2020 5369 6e63 650a 224d 5952 4541  s.  Since."MYREA
│ │ │ │ +00011360: 4c4d 222c 2022 6d79 7265 616c 6d22 2c20  LM", "myrealm", 
│ │ │ │ +00011370: 616e 6420 224d 7952 6561 6c6d 2220 6172  and "MyRealm" ar
│ │ │ │ +00011380: 6520 616c 6c20 6469 6666 6572 656e 7420  e all different 
│ │ │ │ +00011390: 6974 2069 7320 6e65 6365 7373 6172 790a  it is necessary.
│ │ │ │ +000113a0: 7468 6174 206f 6e6c 7920 6f6e 6520 6f66  that only one of
│ │ │ │ +000113b0: 2074 6865 2070 6f73 7369 626c 6520 636f   the possible co
│ │ │ │ +000113c0: 6d62 696e 6174 696f 6e73 206f 6620 7570  mbinations of up
│ │ │ │ +000113d0: 7065 7220 616e 6420 6c6f 7765 7220 6361  per and lower ca
│ │ │ │ +000113e0: 7365 0a63 6861 7261 6374 6572 7320 6265  se.characters be
│ │ │ │ +000113f0: 2075 7365 642e 2020 5468 6973 2072 6573   used.  This res
│ │ │ │ +00011400: 7472 6963 7469 6f6e 206d 6179 2062 6520  triction may be 
│ │ │ │ +00011410: 6c69 6674 6564 2069 6e20 7468 6520 6675  lifted in the fu
│ │ │ │ +00011420: 7475 7265 2061 7320 7468 650a 444e 5320  ture as the.DNS 
│ │ │ │ +00011430: 6e61 6d69 6e67 2073 6368 656d 6520 6973  naming scheme is
│ │ │ │ +00011440: 2065 7870 616e 6465 6420 746f 2073 7570   expanded to sup
│ │ │ │ +00011450: 706f 7274 206e 6f6e 2d41 5343 4949 206e  port non-ASCII n
│ │ │ │ +00011460: 616d 6573 2e0a 0a33 2e35 2e32 204f 7665  ames...3.5.2 Ove
│ │ │ │ +00011470: 7276 6965 7720 2d20 4b44 4320 6c6f 6361  rview - KDC loca
│ │ │ │ +00011480: 7469 6f6e 2069 6e66 6f72 6d61 7469 6f6e  tion information
│ │ │ │ +00011490: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │  000114a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000114b0: 2d2d 2d2d 2d2d 2d2d 0a0a 4b44 4320 6c6f  --------..KDC lo
│ │ │ │ -000114c0: 6361 7469 6f6e 2069 6e66 6f72 6d61 7469  cation informati
│ │ │ │ -000114d0: 6f6e 2069 7320 746f 2062 6520 7374 6f72  on is to be stor
│ │ │ │ -000114e0: 6564 2075 7369 6e67 2074 6865 2044 4e53  ed using the DNS
│ │ │ │ -000114f0: 2053 5256 2052 5220 5b52 4643 0a32 3035   SRV RR [RFC.205
│ │ │ │ -00011500: 325d 2e20 2054 6865 2066 6f72 6d61 7420  2].  The format 
│ │ │ │ -00011510: 6f66 2074 6869 7320 5252 2069 7320 6173  of this RR is as
│ │ │ │ -00011520: 2066 6f6c 6c6f 7773 3a0a 0a20 2020 5365   follows:..   Se
│ │ │ │ -00011530: 7276 6963 652e 5072 6f74 6f2e 5265 616c  rvice.Proto.Real
│ │ │ │ -00011540: 6d20 5454 4c20 436c 6173 7320 5352 5620  m TTL Class SRV 
│ │ │ │ -00011550: 5072 696f 7269 7479 2057 6569 6768 7420  Priority Weight 
│ │ │ │ -00011560: 506f 7274 2054 6172 6765 740a 0a20 2020  Port Target..   
│ │ │ │ -00011570: 5468 6520 5365 7276 6963 6520 6e61 6d65  The Service name
│ │ │ │ -00011580: 2066 6f72 204b 6572 6265 726f 7320 6973   for Kerberos is
│ │ │ │ -00011590: 2061 6c77 6179 7320 225f 6b65 7262 6572   always "_kerber
│ │ │ │ -000115a0: 6f73 222e 0a0a 2020 2054 6865 2050 726f  os"...   The Pro
│ │ │ │ -000115b0: 746f 2063 616e 2062 6520 6569 7468 6572  to can be either
│ │ │ │ -000115c0: 2022 5f75 6470 222c 2022 5f74 6370 222c   "_udp", "_tcp",
│ │ │ │ -000115d0: 206f 7220 225f 746c 732e 5f74 6370 222e   or "_tls._tcp".
│ │ │ │ -000115e0: 2020 4966 2074 6865 7365 2053 5256 0a72    If these SRV.r
│ │ │ │ -000115f0: 6563 6f72 6473 2061 7265 2074 6f20 6265  ecords are to be
│ │ │ │ -00011600: 2075 7365 642c 2061 2022 5f75 6470 2220   used, a "_udp" 
│ │ │ │ -00011610: 7265 636f 7264 204d 5553 5420 6265 2069  record MUST be i
│ │ │ │ -00011620: 6e63 6c75 6465 642e 2020 4966 2074 6865  ncluded.  If the
│ │ │ │ -00011630: 0a4b 6572 6265 726f 7320 696d 706c 656d  .Kerberos implem
│ │ │ │ -00011640: 656e 7461 7469 6f6e 2073 7570 706f 7274  entation support
│ │ │ │ -00011650: 7320 5443 5020 7472 616e 7370 6f72 742c  s TCP transport,
│ │ │ │ -00011660: 2061 2022 5f74 6370 2220 7265 636f 7264   a "_tcp" record
│ │ │ │ -00011670: 204d 5553 5420 6265 0a69 6e63 6c75 6465   MUST be.include
│ │ │ │ -00011680: 642e 2020 5768 656e 2075 7369 6e67 2022  d.  When using "
│ │ │ │ -00011690: 5f74 6370 2220 7769 7468 2022 5f6b 6572  _tcp" with "_ker
│ │ │ │ -000116a0: 6265 726f 7322 2c20 7468 6973 2069 6e64  beros", this ind
│ │ │ │ -000116b0: 6963 6174 6573 2061 2022 7261 7722 0a54  icates a "raw".T
│ │ │ │ -000116c0: 4350 2063 6f6e 6e65 6374 696f 6e20 7769  CP connection wi
│ │ │ │ -000116d0: 7468 6f75 7420 616e 7920 6164 6469 7469  thout any additi
│ │ │ │ -000116e0: 6f6e 616c 2065 6e63 6170 7375 6c61 7469  onal encapsulati
│ │ │ │ -000116f0: 6f6e 2e20 2041 2022 5f74 6c73 2e5f 7463  on.  A "_tls._tc
│ │ │ │ -00011700: 7022 0a72 6563 6f72 6420 4d55 5354 2062  p".record MUST b
│ │ │ │ -00011710: 6520 7370 6563 6966 6965 6420 666f 7220  e specified for 
│ │ │ │ -00011720: 616c 6c20 4b65 7262 6572 6f73 2069 6d70  all Kerberos imp
│ │ │ │ -00011730: 6c65 6d65 6e74 6174 696f 6e73 2074 6861  lementations tha
│ │ │ │ -00011740: 7420 7375 7070 6f72 740a 636f 6d6d 756e  t support.commun
│ │ │ │ -00011750: 6963 6174 696f 6e20 7769 7468 2074 6865  ication with the
│ │ │ │ -00011760: 204b 4443 2061 6372 6f73 7320 5443 5020   KDC across TCP 
│ │ │ │ -00011770: 736f 636b 6574 7320 656e 6361 7073 756c  sockets encapsul
│ │ │ │ -00011780: 6174 6564 2075 7369 6e67 2054 4c53 0a5b  ated using TLS.[
│ │ │ │ -00011790: 5246 4332 3234 365d 2028 2a6e 6f74 6520  RFC2246] (*note 
│ │ │ │ -000117a0: 5354 4152 5454 4c53 2070 726f 7465 6374  STARTTLS protect
│ │ │ │ -000117b0: 6564 204b 4443 2065 7863 6861 6e67 6573  ed KDC exchanges
│ │ │ │ -000117c0: 3a3a 292e 0a0a 2020 2054 6865 2052 6561  ::)...   The Rea
│ │ │ │ -000117d0: 6c6d 2069 7320 7468 6520 4b65 7262 6572  lm is the Kerber
│ │ │ │ -000117e0: 6f73 2072 6561 6c6d 2074 6861 7420 7468  os realm that th
│ │ │ │ -000117f0: 6973 2072 6563 6f72 6420 636f 7272 6573  is record corres
│ │ │ │ -00011800: 706f 6e64 7320 746f 2e0a 0a20 2020 5454  ponds to...   TT
│ │ │ │ -00011810: 4c2c 2043 6c61 7373 2c20 5352 562c 2050  L, Class, SRV, P
│ │ │ │ -00011820: 7269 6f72 6974 792c 2057 6569 6768 742c  riority, Weight,
│ │ │ │ -00011830: 2061 6e64 2054 6172 6765 7420 6861 7665   and Target have
│ │ │ │ -00011840: 2074 6865 2073 7461 6e64 6172 640a 6d65   the standard.me
│ │ │ │ -00011850: 616e 696e 6720 6173 2064 6566 696e 6564  aning as defined
│ │ │ │ -00011860: 2069 6e20 5246 4320 3230 3532 2e0a 0a20   in RFC 2052... 
│ │ │ │ -00011870: 2020 4173 2070 6572 2052 4643 2032 3035    As per RFC 205
│ │ │ │ -00011880: 3220 7468 6520 506f 7274 206e 756d 6265  2 the Port numbe
│ │ │ │ -00011890: 7220 7368 6f75 6c64 2062 6520 7468 6520  r should be the 
│ │ │ │ -000118a0: 7661 6c75 6520 6173 7369 676e 6564 2074  value assigned t
│ │ │ │ -000118b0: 6f0a 226b 6572 6265 726f 7322 2062 7920  o."kerberos" by 
│ │ │ │ -000118c0: 7468 6520 496e 7465 726e 6574 2041 7373  the Internet Ass
│ │ │ │ -000118d0: 6967 6e65 6420 4e75 6d62 6572 2041 7574  igned Number Aut
│ │ │ │ -000118e0: 686f 7269 7479 2028 3838 292e 0a0a 332e  hority (88)...3.
│ │ │ │ -000118f0: 352e 3320 4578 616d 706c 6520 2d20 4b44  5.3 Example - KD
│ │ │ │ -00011900: 4320 6c6f 6361 7469 6f6e 2069 6e66 6f72  C location infor
│ │ │ │ -00011910: 6d61 7469 6f6e 0a2d 2d2d 2d2d 2d2d 2d2d  mation.---------
│ │ │ │ +000114b0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 4b44 4320  ----------..KDC 
│ │ │ │ +000114c0: 6c6f 6361 7469 6f6e 2069 6e66 6f72 6d61  location informa
│ │ │ │ +000114d0: 7469 6f6e 2069 7320 746f 2062 6520 7374  tion is to be st
│ │ │ │ +000114e0: 6f72 6564 2075 7369 6e67 2074 6865 2044  ored using the D
│ │ │ │ +000114f0: 4e53 2053 5256 2052 5220 5b52 4643 0a32  NS SRV RR [RFC.2
│ │ │ │ +00011500: 3035 325d 2e20 2054 6865 2066 6f72 6d61  052].  The forma
│ │ │ │ +00011510: 7420 6f66 2074 6869 7320 5252 2069 7320  t of this RR is 
│ │ │ │ +00011520: 6173 2066 6f6c 6c6f 7773 3a0a 0a20 2020  as follows:..   
│ │ │ │ +00011530: 5365 7276 6963 652e 5072 6f74 6f2e 5265  Service.Proto.Re
│ │ │ │ +00011540: 616c 6d20 5454 4c20 436c 6173 7320 5352  alm TTL Class SR
│ │ │ │ +00011550: 5620 5072 696f 7269 7479 2057 6569 6768  V Priority Weigh
│ │ │ │ +00011560: 7420 506f 7274 2054 6172 6765 740a 0a20  t Port Target.. 
│ │ │ │ +00011570: 2020 5468 6520 5365 7276 6963 6520 6e61    The Service na
│ │ │ │ +00011580: 6d65 2066 6f72 204b 6572 6265 726f 7320  me for Kerberos 
│ │ │ │ +00011590: 6973 2061 6c77 6179 7320 225f 6b65 7262  is always "_kerb
│ │ │ │ +000115a0: 6572 6f73 222e 0a0a 2020 2054 6865 2050  eros"...   The P
│ │ │ │ +000115b0: 726f 746f 2063 616e 2062 6520 6569 7468  roto can be eith
│ │ │ │ +000115c0: 6572 2022 5f75 6470 222c 2022 5f74 6370  er "_udp", "_tcp
│ │ │ │ +000115d0: 222c 206f 7220 225f 746c 732e 5f74 6370  ", or "_tls._tcp
│ │ │ │ +000115e0: 222e 2020 4966 2074 6865 7365 2053 5256  ".  If these SRV
│ │ │ │ +000115f0: 0a72 6563 6f72 6473 2061 7265 2074 6f20  .records are to 
│ │ │ │ +00011600: 6265 2075 7365 642c 2061 2022 5f75 6470  be used, a "_udp
│ │ │ │ +00011610: 2220 7265 636f 7264 204d 5553 5420 6265  " record MUST be
│ │ │ │ +00011620: 2069 6e63 6c75 6465 642e 2020 4966 2074   included.  If t
│ │ │ │ +00011630: 6865 0a4b 6572 6265 726f 7320 696d 706c  he.Kerberos impl
│ │ │ │ +00011640: 656d 656e 7461 7469 6f6e 2073 7570 706f  ementation suppo
│ │ │ │ +00011650: 7274 7320 5443 5020 7472 616e 7370 6f72  rts TCP transpor
│ │ │ │ +00011660: 742c 2061 2022 5f74 6370 2220 7265 636f  t, a "_tcp" reco
│ │ │ │ +00011670: 7264 204d 5553 5420 6265 0a69 6e63 6c75  rd MUST be.inclu
│ │ │ │ +00011680: 6465 642e 2020 5768 656e 2075 7369 6e67  ded.  When using
│ │ │ │ +00011690: 2022 5f74 6370 2220 7769 7468 2022 5f6b   "_tcp" with "_k
│ │ │ │ +000116a0: 6572 6265 726f 7322 2c20 7468 6973 2069  erberos", this i
│ │ │ │ +000116b0: 6e64 6963 6174 6573 2061 2022 7261 7722  ndicates a "raw"
│ │ │ │ +000116c0: 0a54 4350 2063 6f6e 6e65 6374 696f 6e20  .TCP connection 
│ │ │ │ +000116d0: 7769 7468 6f75 7420 616e 7920 6164 6469  without any addi
│ │ │ │ +000116e0: 7469 6f6e 616c 2065 6e63 6170 7375 6c61  tional encapsula
│ │ │ │ +000116f0: 7469 6f6e 2e20 2041 2022 5f74 6c73 2e5f  tion.  A "_tls._
│ │ │ │ +00011700: 7463 7022 0a72 6563 6f72 6420 4d55 5354  tcp".record MUST
│ │ │ │ +00011710: 2062 6520 7370 6563 6966 6965 6420 666f   be specified fo
│ │ │ │ +00011720: 7220 616c 6c20 4b65 7262 6572 6f73 2069  r all Kerberos i
│ │ │ │ +00011730: 6d70 6c65 6d65 6e74 6174 696f 6e73 2074  mplementations t
│ │ │ │ +00011740: 6861 7420 7375 7070 6f72 740a 636f 6d6d  hat support.comm
│ │ │ │ +00011750: 756e 6963 6174 696f 6e20 7769 7468 2074  unication with t
│ │ │ │ +00011760: 6865 204b 4443 2061 6372 6f73 7320 5443  he KDC across TC
│ │ │ │ +00011770: 5020 736f 636b 6574 7320 656e 6361 7073  P sockets encaps
│ │ │ │ +00011780: 756c 6174 6564 2075 7369 6e67 2054 4c53  ulated using TLS
│ │ │ │ +00011790: 0a5b 5246 4332 3234 365d 2028 2a6e 6f74  .[RFC2246] (*not
│ │ │ │ +000117a0: 6520 5354 4152 5454 4c53 2070 726f 7465  e STARTTLS prote
│ │ │ │ +000117b0: 6374 6564 204b 4443 2065 7863 6861 6e67  cted KDC exchang
│ │ │ │ +000117c0: 6573 3a3a 292e 0a0a 2020 2054 6865 2052  es::)...   The R
│ │ │ │ +000117d0: 6561 6c6d 2069 7320 7468 6520 4b65 7262  ealm is the Kerb
│ │ │ │ +000117e0: 6572 6f73 2072 6561 6c6d 2074 6861 7420  eros realm that 
│ │ │ │ +000117f0: 7468 6973 2072 6563 6f72 6420 636f 7272  this record corr
│ │ │ │ +00011800: 6573 706f 6e64 7320 746f 2e0a 0a20 2020  esponds to...   
│ │ │ │ +00011810: 5454 4c2c 2043 6c61 7373 2c20 5352 562c  TTL, Class, SRV,
│ │ │ │ +00011820: 2050 7269 6f72 6974 792c 2057 6569 6768   Priority, Weigh
│ │ │ │ +00011830: 742c 2061 6e64 2054 6172 6765 7420 6861  t, and Target ha
│ │ │ │ +00011840: 7665 2074 6865 2073 7461 6e64 6172 640a  ve the standard.
│ │ │ │ +00011850: 6d65 616e 696e 6720 6173 2064 6566 696e  meaning as defin
│ │ │ │ +00011860: 6564 2069 6e20 5246 4320 3230 3532 2e0a  ed in RFC 2052..
│ │ │ │ +00011870: 0a20 2020 4173 2070 6572 2052 4643 2032  .   As per RFC 2
│ │ │ │ +00011880: 3035 3220 7468 6520 506f 7274 206e 756d  052 the Port num
│ │ │ │ +00011890: 6265 7220 7368 6f75 6c64 2062 6520 7468  ber should be th
│ │ │ │ +000118a0: 6520 7661 6c75 6520 6173 7369 676e 6564  e value assigned
│ │ │ │ +000118b0: 2074 6f0a 226b 6572 6265 726f 7322 2062   to."kerberos" b
│ │ │ │ +000118c0: 7920 7468 6520 496e 7465 726e 6574 2041  y the Internet A
│ │ │ │ +000118d0: 7373 6967 6e65 6420 4e75 6d62 6572 2041  ssigned Number A
│ │ │ │ +000118e0: 7574 686f 7269 7479 2028 3838 292e 0a0a  uthority (88)...
│ │ │ │ +000118f0: 332e 352e 3320 4578 616d 706c 6520 2d20  3.5.3 Example - 
│ │ │ │ +00011900: 4b44 4320 6c6f 6361 7469 6f6e 2069 6e66  KDC location inf
│ │ │ │ +00011910: 6f72 6d61 7469 6f6e 0a2d 2d2d 2d2d 2d2d  ormation.-------
│ │ │ │  00011920: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00011930: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -00011940: 0a54 6865 7365 2061 7265 2044 4e53 2072  .These are DNS r
│ │ │ │ -00011950: 6563 6f72 6473 2066 6f72 2061 204b 6572  ecords for a Ker
│ │ │ │ -00011960: 6265 726f 7320 7265 616c 6d20 4153 4446  beros realm ASDF
│ │ │ │ -00011970: 2e43 4f4d 2e20 4974 2068 6173 2074 776f  .COM. It has two
│ │ │ │ -00011980: 204b 6572 6265 726f 730a 7365 7276 6572   Kerberos.server
│ │ │ │ -00011990: 732c 206b 6463 312e 6173 6466 2e63 6f6d  s, kdc1.asdf.com
│ │ │ │ -000119a0: 2061 6e64 206b 6463 322e 6173 6466 2e63   and kdc2.asdf.c
│ │ │ │ -000119b0: 6f6d 2e20 2051 7565 7269 6573 2073 686f  om.  Queries sho
│ │ │ │ -000119c0: 756c 6420 6265 2064 6972 6563 7465 6420  uld be directed 
│ │ │ │ -000119d0: 746f 0a6b 6463 312e 6173 6466 2e63 6f6d  to.kdc1.asdf.com
│ │ │ │ -000119e0: 2066 6972 7374 2061 7320 7065 7220 7468   first as per th
│ │ │ │ -000119f0: 6520 7370 6563 6966 6965 6420 7072 696f  e specified prio
│ │ │ │ -00011a00: 7269 7479 2e20 2057 6569 6768 7473 2061  rity.  Weights a
│ │ │ │ -00011a10: 7265 206e 6f74 2075 7365 640a 696e 2074  re not used.in t
│ │ │ │ -00011a20: 6865 7365 2072 6563 6f72 6473 2e0a 0a20  hese records... 
│ │ │ │ -00011a30: 2020 2020 5f6b 6572 6265 726f 732e 5f75      _kerberos._u
│ │ │ │ -00011a40: 6470 2e41 5344 462e 434f 4d2e 2020 2020  dp.ASDF.COM.    
│ │ │ │ -00011a50: 2020 2020 494e 2020 2020 2020 5352 5620      IN      SRV 
│ │ │ │ -00011a60: 2020 2020 3020 3020 3838 206b 6463 312e      0 0 88 kdc1.
│ │ │ │ -00011a70: 6173 6466 2e63 6f6d 2e0a 2020 2020 205f  asdf.com..     _
│ │ │ │ -00011a80: 6b65 7262 6572 6f73 2e5f 7564 702e 4153  kerberos._udp.AS
│ │ │ │ -00011a90: 4446 2e43 4f4d 2e20 2020 2020 2020 2049  DF.COM.        I
│ │ │ │ -00011aa0: 4e20 2020 2020 2053 5256 2020 2020 2031  N      SRV     1
│ │ │ │ -00011ab0: 2030 2038 3820 6b64 6332 2e61 7364 662e   0 88 kdc2.asdf.
│ │ │ │ -00011ac0: 636f 6d2e 0a20 2020 2020 5f6b 6572 6265  com..     _kerbe
│ │ │ │ -00011ad0: 726f 732e 5f74 6370 2e41 5344 462e 434f  ros._tcp.ASDF.CO
│ │ │ │ -00011ae0: 4d2e 2020 2020 2020 2020 494e 2020 2020  M.        IN    
│ │ │ │ -00011af0: 2020 5352 5620 2020 2020 3020 3020 3838    SRV     0 0 88
│ │ │ │ -00011b00: 206b 6463 312e 6173 6466 2e63 6f6d 2e0a   kdc1.asdf.com..
│ │ │ │ -00011b10: 2020 2020 205f 6b65 7262 6572 6f73 2e5f       _kerberos._
│ │ │ │ -00011b20: 7463 702e 4153 4446 2e43 4f4d 2e20 2020  tcp.ASDF.COM.   
│ │ │ │ -00011b30: 2020 2020 2049 4e20 2020 2020 2053 5256       IN      SRV
│ │ │ │ -00011b40: 2020 2020 2031 2030 2038 3820 6b64 6332       1 0 88 kdc2
│ │ │ │ -00011b50: 2e61 7364 662e 636f 6d2e 0a20 2020 2020  .asdf.com..     
│ │ │ │ -00011b60: 5f6b 6572 6265 726f 732e 5f74 6c73 2e5f  _kerberos._tls._
│ │ │ │ -00011b70: 7463 702e 4153 4446 2e43 4f4d 2e20 2020  tcp.ASDF.COM.   
│ │ │ │ -00011b80: 494e 2020 2020 2020 5352 5620 2020 2020  IN      SRV     
│ │ │ │ -00011b90: 3020 3020 3838 206b 6463 312e 6173 6466  0 0 88 kdc1.asdf
│ │ │ │ -00011ba0: 2e63 6f6d 2e0a 2020 2020 205f 6b65 7262  .com..     _kerb
│ │ │ │ -00011bb0: 6572 6f73 2e5f 746c 732e 5f74 6370 2e41  eros._tls._tcp.A
│ │ │ │ -00011bc0: 5344 462e 434f 4d2e 2020 2049 4e20 2020  SDF.COM.   IN   
│ │ │ │ -00011bd0: 2020 2053 5256 2020 2020 2031 2030 2038     SRV     1 0 8
│ │ │ │ -00011be0: 3820 6b64 6332 2e61 7364 662e 636f 6d2e  8 kdc2.asdf.com.
│ │ │ │ -00011bf0: 0a0a 332e 352e 3420 5365 6375 7269 7479  ..3.5.4 Security
│ │ │ │ -00011c00: 2063 6f6e 7369 6465 7261 7469 6f6e 730a   considerations.
│ │ │ │ -00011c10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00011c20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a41  -------------..A
│ │ │ │ -00011c30: 7320 444e 5320 6973 2064 6570 6c6f 7965  s DNS is deploye
│ │ │ │ -00011c40: 6420 746f 6461 792c 2069 7420 6973 2061  d today, it is a
│ │ │ │ -00011c50: 6e20 756e 7365 6375 7265 2073 6572 7669  n unsecure servi
│ │ │ │ -00011c60: 6365 2e20 2054 6875 7320 7468 6520 696e  ce.  Thus the in
│ │ │ │ -00011c70: 666f 722d 0a6d 6174 696f 6e20 7265 7475  for-.mation retu
│ │ │ │ -00011c80: 726e 6564 2062 7920 6974 2063 616e 6e6f  rned by it canno
│ │ │ │ -00011c90: 7420 6265 2074 7275 7374 6564 2e0a 0a20  t be trusted... 
│ │ │ │ -00011ca0: 2020 4375 7272 656e 7420 7072 6163 7469    Current practi
│ │ │ │ -00011cb0: 6365 2066 6f72 2052 4541 4c4d 2074 6f20  ce for REALM to 
│ │ │ │ -00011cc0: 4b44 4320 6d61 7070 696e 6720 6973 2074  KDC mapping is t
│ │ │ │ -00011cd0: 6f20 7573 6520 686f 7374 6e61 6d65 7320  o use hostnames 
│ │ │ │ -00011ce0: 746f 0a69 6e64 6963 6174 6520 4b44 4320  to.indicate KDC 
│ │ │ │ -00011cf0: 686f 7374 7320 2873 746f 7265 6420 696e  hosts (stored in
│ │ │ │ -00011d00: 2073 6f6d 6520 696d 706c 656d 656e 7461   some implementa
│ │ │ │ -00011d10: 7469 6f6e 2d64 6570 656e 6465 6e74 206c  tion-dependent l
│ │ │ │ -00011d20: 6f63 6174 696f 6e2c 0a62 7574 2067 656e  ocation,.but gen
│ │ │ │ -00011d30: 6572 616c 6c79 2061 206c 6f63 616c 2063  erally a local c
│ │ │ │ -00011d40: 6f6e 6669 6720 6669 6c65 292e 2020 5468  onfig file).  Th
│ │ │ │ -00011d50: 6573 6520 686f 7374 6e61 6d65 7320 6172  ese hostnames ar
│ │ │ │ -00011d60: 6520 7675 6c6e 6572 6162 6c65 2074 6f0a  e vulnerable to.
│ │ │ │ -00011d70: 7468 6520 7374 616e 6461 7264 2073 6574  the standard set
│ │ │ │ -00011d80: 206f 6620 444e 5320 6174 7461 636b 7320   of DNS attacks 
│ │ │ │ -00011d90: 2864 656e 6961 6c20 6f66 2073 6572 7669  (denial of servi
│ │ │ │ -00011da0: 6365 2c20 7370 6f6f 6665 6420 656e 7472  ce, spoofed entr
│ │ │ │ -00011db0: 6965 732c 0a65 7463 292e 2020 5468 6520  ies,.etc).  The 
│ │ │ │ -00011dc0: 6465 7369 676e 206f 6620 7468 6520 4b65  design of the Ke
│ │ │ │ -00011dd0: 7262 6572 6f73 2070 726f 746f 636f 6c20  rberos protocol 
│ │ │ │ -00011de0: 6c69 6d69 7473 2061 7474 6163 6b73 206f  limits attacks o
│ │ │ │ -00011df0: 6620 7468 6973 2073 6f72 740a 746f 2064  f this sort.to d
│ │ │ │ -00011e00: 656e 6961 6c20 6f66 2073 6572 7669 6365  enial of service
│ │ │ │ -00011e10: 2e20 2048 6f77 6576 6572 2c20 7468 6520  .  However, the 
│ │ │ │ -00011e20: 7573 6520 6f66 2053 5256 2072 6563 6f72  use of SRV recor
│ │ │ │ -00011e30: 6473 2064 6f65 7320 6e6f 7420 6368 616e  ds does not chan
│ │ │ │ -00011e40: 6765 0a74 6869 7320 6174 7461 636b 2069  ge.this attack i
│ │ │ │ -00011e50: 6e20 616e 7920 7761 792e 2020 5468 6579  n any way.  They
│ │ │ │ -00011e60: 2068 6176 6520 7468 6520 7361 6d65 2076   have the same v
│ │ │ │ -00011e70: 756c 6e65 7261 6269 6c69 7469 6573 2074  ulnerabilities t
│ │ │ │ -00011e80: 6861 7420 616c 7265 6164 790a 6578 6973  hat already.exis
│ │ │ │ -00011e90: 7420 696e 2074 6865 2063 6f6d 6d6f 6e20  t in the common 
│ │ │ │ -00011ea0: 7072 6163 7469 6365 206f 6620 7573 696e  practice of usin
│ │ │ │ -00011eb0: 6720 686f 7374 6e61 6d65 7320 666f 7220  g hostnames for 
│ │ │ │ -00011ec0: 4b44 4320 6c6f 6361 7469 6f6e 732e 0a0a  KDC locations...
│ │ │ │ -00011ed0: 2020 2049 6d70 6c65 6d65 6e74 6174 696f     Implementatio
│ │ │ │ -00011ee0: 6e73 2053 484f 554c 4420 7072 6f76 6964  ns SHOULD provid
│ │ │ │ -00011ef0: 6520 6120 7761 7920 6f66 2073 7065 6369  e a way of speci
│ │ │ │ -00011f00: 6679 696e 6720 7468 6973 2069 6e66 6f72  fying this infor
│ │ │ │ -00011f10: 6d61 7469 6f6e 0a6c 6f63 616c 6c79 2077  mation.locally w
│ │ │ │ -00011f20: 6974 686f 7574 2074 6865 2075 7365 206f  ithout the use o
│ │ │ │ -00011f30: 6620 444e 532e 2048 6f77 6576 6572 2c20  f DNS. However, 
│ │ │ │ -00011f40: 746f 206d 616b 6520 7468 6973 2066 6561  to make this fea
│ │ │ │ -00011f50: 7475 7265 2077 6f72 7468 7768 696c 650a  ture worthwhile.
│ │ │ │ -00011f60: 6120 6c61 636b 206f 6620 616e 7920 636f  a lack of any co
│ │ │ │ -00011f70: 6e66 6967 7572 6174 696f 6e20 696e 666f  nfiguration info
│ │ │ │ -00011f80: 726d 6174 696f 6e20 6f6e 2061 2063 6c69  rmation on a cli
│ │ │ │ -00011f90: 656e 7420 7368 6f75 6c64 2062 650a 696e  ent should be.in
│ │ │ │ -00011fa0: 7465 7270 7265 7474 6564 2061 7320 7065  terpretted as pe
│ │ │ │ -00011fb0: 726d 6973 7369 6f6e 2074 6f20 7573 6520  rmission to use 
│ │ │ │ -00011fc0: 444e 532e 0a0a 1f0a 4669 6c65 3a20 7368  DNS.....File: sh
│ │ │ │ -00011fd0: 6973 6869 2e69 6e66 6f2c 2020 4e6f 6465  ishi.info,  Node
│ │ │ │ -00011fe0: 3a20 4b65 7262 6572 6f73 2076 6961 2054  : Kerberos via T
│ │ │ │ -00011ff0: 4c53 2c20 204e 6578 743a 204d 756c 7469  LS,  Next: Multi
│ │ │ │ -00012000: 706c 6520 7365 7276 6572 732c 2020 5072  ple servers,  Pr
│ │ │ │ -00012010: 6576 3a20 436f 6e66 6967 7572 696e 6720  ev: Configuring 
│ │ │ │ -00012020: 444e 5320 666f 7220 4b44 432c 2020 5570  DNS for KDC,  Up
│ │ │ │ -00012030: 3a20 4164 6d69 6e69 7374 7261 7469 6f6e  : Administration
│ │ │ │ -00012040: 204d 616e 7561 6c0a 0a33 2e36 204b 6572   Manual..3.6 Ker
│ │ │ │ -00012050: 6265 726f 7320 7669 6120 544c 530a 3d3d  beros via TLS.==
│ │ │ │ +00011930: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +00011940: 2d0a 0a54 6865 7365 2061 7265 2044 4e53  -..These are DNS
│ │ │ │ +00011950: 2072 6563 6f72 6473 2066 6f72 2061 204b   records for a K
│ │ │ │ +00011960: 6572 6265 726f 7320 7265 616c 6d20 4153  erberos realm AS
│ │ │ │ +00011970: 4446 2e43 4f4d 2e20 4974 2068 6173 2074  DF.COM. It has t
│ │ │ │ +00011980: 776f 204b 6572 6265 726f 730a 7365 7276  wo Kerberos.serv
│ │ │ │ +00011990: 6572 732c 206b 6463 312e 6173 6466 2e63  ers, kdc1.asdf.c
│ │ │ │ +000119a0: 6f6d 2061 6e64 206b 6463 322e 6173 6466  om and kdc2.asdf
│ │ │ │ +000119b0: 2e63 6f6d 2e20 2051 7565 7269 6573 2073  .com.  Queries s
│ │ │ │ +000119c0: 686f 756c 6420 6265 2064 6972 6563 7465  hould be directe
│ │ │ │ +000119d0: 6420 746f 0a6b 6463 312e 6173 6466 2e63  d to.kdc1.asdf.c
│ │ │ │ +000119e0: 6f6d 2066 6972 7374 2061 7320 7065 7220  om first as per 
│ │ │ │ +000119f0: 7468 6520 7370 6563 6966 6965 6420 7072  the specified pr
│ │ │ │ +00011a00: 696f 7269 7479 2e20 2057 6569 6768 7473  iority.  Weights
│ │ │ │ +00011a10: 2061 7265 206e 6f74 2075 7365 640a 696e   are not used.in
│ │ │ │ +00011a20: 2074 6865 7365 2072 6563 6f72 6473 2e0a   these records..
│ │ │ │ +00011a30: 0a20 2020 2020 5f6b 6572 6265 726f 732e  .     _kerberos.
│ │ │ │ +00011a40: 5f75 6470 2e41 5344 462e 434f 4d2e 2020  _udp.ASDF.COM.  
│ │ │ │ +00011a50: 2020 2020 2020 494e 2020 2020 2020 5352        IN      SR
│ │ │ │ +00011a60: 5620 2020 2020 3020 3020 3838 206b 6463  V     0 0 88 kdc
│ │ │ │ +00011a70: 312e 6173 6466 2e63 6f6d 2e0a 2020 2020  1.asdf.com..    
│ │ │ │ +00011a80: 205f 6b65 7262 6572 6f73 2e5f 7564 702e   _kerberos._udp.
│ │ │ │ +00011a90: 4153 4446 2e43 4f4d 2e20 2020 2020 2020  ASDF.COM.       
│ │ │ │ +00011aa0: 2049 4e20 2020 2020 2053 5256 2020 2020   IN      SRV    
│ │ │ │ +00011ab0: 2031 2030 2038 3820 6b64 6332 2e61 7364   1 0 88 kdc2.asd
│ │ │ │ +00011ac0: 662e 636f 6d2e 0a20 2020 2020 5f6b 6572  f.com..     _ker
│ │ │ │ +00011ad0: 6265 726f 732e 5f74 6370 2e41 5344 462e  beros._tcp.ASDF.
│ │ │ │ +00011ae0: 434f 4d2e 2020 2020 2020 2020 494e 2020  COM.        IN  
│ │ │ │ +00011af0: 2020 2020 5352 5620 2020 2020 3020 3020      SRV     0 0 
│ │ │ │ +00011b00: 3838 206b 6463 312e 6173 6466 2e63 6f6d  88 kdc1.asdf.com
│ │ │ │ +00011b10: 2e0a 2020 2020 205f 6b65 7262 6572 6f73  ..     _kerberos
│ │ │ │ +00011b20: 2e5f 7463 702e 4153 4446 2e43 4f4d 2e20  ._tcp.ASDF.COM. 
│ │ │ │ +00011b30: 2020 2020 2020 2049 4e20 2020 2020 2053         IN      S
│ │ │ │ +00011b40: 5256 2020 2020 2031 2030 2038 3820 6b64  RV     1 0 88 kd
│ │ │ │ +00011b50: 6332 2e61 7364 662e 636f 6d2e 0a20 2020  c2.asdf.com..   
│ │ │ │ +00011b60: 2020 5f6b 6572 6265 726f 732e 5f74 6c73    _kerberos._tls
│ │ │ │ +00011b70: 2e5f 7463 702e 4153 4446 2e43 4f4d 2e20  ._tcp.ASDF.COM. 
│ │ │ │ +00011b80: 2020 494e 2020 2020 2020 5352 5620 2020    IN      SRV   
│ │ │ │ +00011b90: 2020 3020 3020 3838 206b 6463 312e 6173    0 0 88 kdc1.as
│ │ │ │ +00011ba0: 6466 2e63 6f6d 2e0a 2020 2020 205f 6b65  df.com..     _ke
│ │ │ │ +00011bb0: 7262 6572 6f73 2e5f 746c 732e 5f74 6370  rberos._tls._tcp
│ │ │ │ +00011bc0: 2e41 5344 462e 434f 4d2e 2020 2049 4e20  .ASDF.COM.   IN 
│ │ │ │ +00011bd0: 2020 2020 2053 5256 2020 2020 2031 2030       SRV     1 0
│ │ │ │ +00011be0: 2038 3820 6b64 6332 2e61 7364 662e 636f   88 kdc2.asdf.co
│ │ │ │ +00011bf0: 6d2e 0a0a 332e 352e 3420 5365 6375 7269  m...3.5.4 Securi
│ │ │ │ +00011c00: 7479 2063 6f6e 7369 6465 7261 7469 6f6e  ty consideration
│ │ │ │ +00011c10: 730a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  s.--------------
│ │ │ │ +00011c20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +00011c30: 0a41 7320 444e 5320 6973 2064 6570 6c6f  .As DNS is deplo
│ │ │ │ +00011c40: 7965 6420 746f 6461 792c 2069 7420 6973  yed today, it is
│ │ │ │ +00011c50: 2061 6e20 756e 7365 6375 7265 2073 6572   an unsecure ser
│ │ │ │ +00011c60: 7669 6365 2e20 2054 6875 7320 7468 6520  vice.  Thus the 
│ │ │ │ +00011c70: 696e 666f 722d 0a6d 6174 696f 6e20 7265  infor-.mation re
│ │ │ │ +00011c80: 7475 726e 6564 2062 7920 6974 2063 616e  turned by it can
│ │ │ │ +00011c90: 6e6f 7420 6265 2074 7275 7374 6564 2e0a  not be trusted..
│ │ │ │ +00011ca0: 0a20 2020 4375 7272 656e 7420 7072 6163  .   Current prac
│ │ │ │ +00011cb0: 7469 6365 2066 6f72 2052 4541 4c4d 2074  tice for REALM t
│ │ │ │ +00011cc0: 6f20 4b44 4320 6d61 7070 696e 6720 6973  o KDC mapping is
│ │ │ │ +00011cd0: 2074 6f20 7573 6520 686f 7374 6e61 6d65   to use hostname
│ │ │ │ +00011ce0: 7320 746f 0a69 6e64 6963 6174 6520 4b44  s to.indicate KD
│ │ │ │ +00011cf0: 4320 686f 7374 7320 2873 746f 7265 6420  C hosts (stored 
│ │ │ │ +00011d00: 696e 2073 6f6d 6520 696d 706c 656d 656e  in some implemen
│ │ │ │ +00011d10: 7461 7469 6f6e 2d64 6570 656e 6465 6e74  tation-dependent
│ │ │ │ +00011d20: 206c 6f63 6174 696f 6e2c 0a62 7574 2067   location,.but g
│ │ │ │ +00011d30: 656e 6572 616c 6c79 2061 206c 6f63 616c  enerally a local
│ │ │ │ +00011d40: 2063 6f6e 6669 6720 6669 6c65 292e 2020   config file).  
│ │ │ │ +00011d50: 5468 6573 6520 686f 7374 6e61 6d65 7320  These hostnames 
│ │ │ │ +00011d60: 6172 6520 7675 6c6e 6572 6162 6c65 2074  are vulnerable t
│ │ │ │ +00011d70: 6f0a 7468 6520 7374 616e 6461 7264 2073  o.the standard s
│ │ │ │ +00011d80: 6574 206f 6620 444e 5320 6174 7461 636b  et of DNS attack
│ │ │ │ +00011d90: 7320 2864 656e 6961 6c20 6f66 2073 6572  s (denial of ser
│ │ │ │ +00011da0: 7669 6365 2c20 7370 6f6f 6665 6420 656e  vice, spoofed en
│ │ │ │ +00011db0: 7472 6965 732c 0a65 7463 292e 2020 5468  tries,.etc).  Th
│ │ │ │ +00011dc0: 6520 6465 7369 676e 206f 6620 7468 6520  e design of the 
│ │ │ │ +00011dd0: 4b65 7262 6572 6f73 2070 726f 746f 636f  Kerberos protoco
│ │ │ │ +00011de0: 6c20 6c69 6d69 7473 2061 7474 6163 6b73  l limits attacks
│ │ │ │ +00011df0: 206f 6620 7468 6973 2073 6f72 740a 746f   of this sort.to
│ │ │ │ +00011e00: 2064 656e 6961 6c20 6f66 2073 6572 7669   denial of servi
│ │ │ │ +00011e10: 6365 2e20 2048 6f77 6576 6572 2c20 7468  ce.  However, th
│ │ │ │ +00011e20: 6520 7573 6520 6f66 2053 5256 2072 6563  e use of SRV rec
│ │ │ │ +00011e30: 6f72 6473 2064 6f65 7320 6e6f 7420 6368  ords does not ch
│ │ │ │ +00011e40: 616e 6765 0a74 6869 7320 6174 7461 636b  ange.this attack
│ │ │ │ +00011e50: 2069 6e20 616e 7920 7761 792e 2020 5468   in any way.  Th
│ │ │ │ +00011e60: 6579 2068 6176 6520 7468 6520 7361 6d65  ey have the same
│ │ │ │ +00011e70: 2076 756c 6e65 7261 6269 6c69 7469 6573   vulnerabilities
│ │ │ │ +00011e80: 2074 6861 7420 616c 7265 6164 790a 6578   that already.ex
│ │ │ │ +00011e90: 6973 7420 696e 2074 6865 2063 6f6d 6d6f  ist in the commo
│ │ │ │ +00011ea0: 6e20 7072 6163 7469 6365 206f 6620 7573  n practice of us
│ │ │ │ +00011eb0: 696e 6720 686f 7374 6e61 6d65 7320 666f  ing hostnames fo
│ │ │ │ +00011ec0: 7220 4b44 4320 6c6f 6361 7469 6f6e 732e  r KDC locations.
│ │ │ │ +00011ed0: 0a0a 2020 2049 6d70 6c65 6d65 6e74 6174  ..   Implementat
│ │ │ │ +00011ee0: 696f 6e73 2053 484f 554c 4420 7072 6f76  ions SHOULD prov
│ │ │ │ +00011ef0: 6964 6520 6120 7761 7920 6f66 2073 7065  ide a way of spe
│ │ │ │ +00011f00: 6369 6679 696e 6720 7468 6973 2069 6e66  cifying this inf
│ │ │ │ +00011f10: 6f72 6d61 7469 6f6e 0a6c 6f63 616c 6c79  ormation.locally
│ │ │ │ +00011f20: 2077 6974 686f 7574 2074 6865 2075 7365   without the use
│ │ │ │ +00011f30: 206f 6620 444e 532e 2048 6f77 6576 6572   of DNS. However
│ │ │ │ +00011f40: 2c20 746f 206d 616b 6520 7468 6973 2066  , to make this f
│ │ │ │ +00011f50: 6561 7475 7265 2077 6f72 7468 7768 696c  eature worthwhil
│ │ │ │ +00011f60: 650a 6120 6c61 636b 206f 6620 616e 7920  e.a lack of any 
│ │ │ │ +00011f70: 636f 6e66 6967 7572 6174 696f 6e20 696e  configuration in
│ │ │ │ +00011f80: 666f 726d 6174 696f 6e20 6f6e 2061 2063  formation on a c
│ │ │ │ +00011f90: 6c69 656e 7420 7368 6f75 6c64 2062 650a  lient should be.
│ │ │ │ +00011fa0: 696e 7465 7270 7265 7474 6564 2061 7320  interpretted as 
│ │ │ │ +00011fb0: 7065 726d 6973 7369 6f6e 2074 6f20 7573  permission to us
│ │ │ │ +00011fc0: 6520 444e 532e 0a0a 1f0a 4669 6c65 3a20  e DNS.....File: 
│ │ │ │ +00011fd0: 7368 6973 6869 2e69 6e66 6f2c 2020 4e6f  shishi.info,  No
│ │ │ │ +00011fe0: 6465 3a20 4b65 7262 6572 6f73 2076 6961  de: Kerberos via
│ │ │ │ +00011ff0: 2054 4c53 2c20 204e 6578 743a 204d 756c   TLS,  Next: Mul
│ │ │ │ +00012000: 7469 706c 6520 7365 7276 6572 732c 2020  tiple servers,  
│ │ │ │ +00012010: 5072 6576 3a20 436f 6e66 6967 7572 696e  Prev: Configurin
│ │ │ │ +00012020: 6720 444e 5320 666f 7220 4b44 432c 2020  g DNS for KDC,  
│ │ │ │ +00012030: 5570 3a20 4164 6d69 6e69 7374 7261 7469  Up: Administrati
│ │ │ │ +00012040: 6f6e 204d 616e 7561 6c0a 0a33 2e36 204b  on Manual..3.6 K
│ │ │ │ +00012050: 6572 6265 726f 7320 7669 6120 544c 530a  erberos via TLS.
│ │ │ │  00012060: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ -00012070: 3d3d 0a0a 4966 2053 6869 7368 6920 6973  ==..If Shishi is
│ │ │ │ -00012080: 2062 7569 6c74 2077 6974 6820 7375 7070   built with supp
│ │ │ │ -00012090: 6f72 7420 666f 7220 474e 5554 4c53 2c20  ort for GNUTLS, 
│ │ │ │ -000120a0: 7468 6520 6d65 7373 6167 6573 2065 7863  the messages exc
│ │ │ │ -000120b0: 6861 6e67 6564 0a62 6574 7765 656e 2063  hanged.between c
│ │ │ │ -000120c0: 6c69 656e 7473 2061 6e64 2053 6869 7368  lients and Shish
│ │ │ │ -000120d0: 6964 2063 616e 2062 6520 7072 6f74 6563  id can be protec
│ │ │ │ -000120e0: 7465 6420 7769 7468 2054 4c53 2e20 544c  ted with TLS. TL
│ │ │ │ -000120f0: 5320 6973 206f 6e6c 790a 6176 6169 6c61  S is only.availa
│ │ │ │ -00012100: 626c 6520 6f76 6572 2054 4350 2063 6f6e  ble over TCP con
│ │ │ │ -00012110: 6e65 6374 696f 6e73 2e20 2041 2066 756c  nections.  A ful
│ │ │ │ -00012120: 6c20 6469 7363 7573 7369 6f6e 206f 6620  l discussion of 
│ │ │ │ -00012130: 7468 6520 6665 6174 7572 6573 2054 4c53  the features TLS
│ │ │ │ -00012140: 0a68 6176 6520 6973 206f 7574 206f 6620  .have is out of 
│ │ │ │ -00012150: 7363 6f70 6520 6865 7265 2c20 6275 7420  scope here, but 
│ │ │ │ -00012160: 696e 2073 686f 7274 2069 7420 6d65 616e  in short it mean
│ │ │ │ -00012170: 7320 7468 6520 636f 6d6d 756e 6963 6174  s the communicat
│ │ │ │ -00012180: 696f 6e20 6973 0a69 6e74 6567 7269 7479  ion is.integrity
│ │ │ │ -00012190: 2061 6e64 2070 7269 7661 6379 2070 726f   and privacy pro
│ │ │ │ -000121a0: 7465 6374 6564 2c20 616e 6420 7468 6174  tected, and that
│ │ │ │ -000121b0: 2075 7365 7273 2063 616e 2075 7365 204f   users can use O
│ │ │ │ -000121c0: 7065 6e50 4750 2c20 582e 3530 390a 6f72  penPGP, X.509.or
│ │ │ │ -000121d0: 2053 5250 2028 692e 652e 2c20 616e 7920   SRP (i.e., any 
│ │ │ │ -000121e0: 6d65 6368 616e 6973 6d20 7375 7070 6f72  mechanism suppor
│ │ │ │ -000121f0: 7465 6420 6279 2054 4c53 2920 746f 2061  ted by TLS) to a
│ │ │ │ -00012200: 7574 6865 6e74 6963 6174 6520 7468 656d  uthenticate them
│ │ │ │ -00012210: 7365 6c76 6573 0a74 6f20 7468 6520 4b65  selves.to the Ke
│ │ │ │ -00012220: 7262 6572 6f73 2073 6572 7665 722e 2020  rberos server.  
│ │ │ │ -00012230: 466f 7220 6465 7461 696c 7320 6f6e 2074  For details on t
│ │ │ │ -00012240: 6865 2069 6d70 6c65 6d65 6e74 6174 696f  he implementatio
│ │ │ │ -00012250: 6e2c 202a 4e6f 7465 0a53 5441 5254 544c  n, *Note.STARTTL
│ │ │ │ -00012260: 5320 7072 6f74 6563 7465 6420 4b44 4320  S protected KDC 
│ │ │ │ -00012270: 6578 6368 616e 6765 733a 3a2e 0a0a 332e  exchanges::...3.
│ │ │ │ -00012280: 362e 3120 5365 7474 696e 6720 7570 2054  6.1 Setting up T
│ │ │ │ -00012290: 4c53 2072 6573 756d 650a 2d2d 2d2d 2d2d  LS resume.------
│ │ │ │ +00012070: 3d3d 3d3d 0a0a 4966 2053 6869 7368 6920  ====..If Shishi 
│ │ │ │ +00012080: 6973 2062 7569 6c74 2077 6974 6820 7375  is built with su
│ │ │ │ +00012090: 7070 6f72 7420 666f 7220 474e 5554 4c53  pport for GNUTLS
│ │ │ │ +000120a0: 2c20 7468 6520 6d65 7373 6167 6573 2065  , the messages e
│ │ │ │ +000120b0: 7863 6861 6e67 6564 0a62 6574 7765 656e  xchanged.between
│ │ │ │ +000120c0: 2063 6c69 656e 7473 2061 6e64 2053 6869   clients and Shi
│ │ │ │ +000120d0: 7368 6964 2063 616e 2062 6520 7072 6f74  shid can be prot
│ │ │ │ +000120e0: 6563 7465 6420 7769 7468 2054 4c53 2e20  ected with TLS. 
│ │ │ │ +000120f0: 544c 5320 6973 206f 6e6c 790a 6176 6169  TLS is only.avai
│ │ │ │ +00012100: 6c61 626c 6520 6f76 6572 2054 4350 2063  lable over TCP c
│ │ │ │ +00012110: 6f6e 6e65 6374 696f 6e73 2e20 2041 2066  onnections.  A f
│ │ │ │ +00012120: 756c 6c20 6469 7363 7573 7369 6f6e 206f  ull discussion o
│ │ │ │ +00012130: 6620 7468 6520 6665 6174 7572 6573 2054  f the features T
│ │ │ │ +00012140: 4c53 0a68 6176 6520 6973 206f 7574 206f  LS.have is out o
│ │ │ │ +00012150: 6620 7363 6f70 6520 6865 7265 2c20 6275  f scope here, bu
│ │ │ │ +00012160: 7420 696e 2073 686f 7274 2069 7420 6d65  t in short it me
│ │ │ │ +00012170: 616e 7320 7468 6520 636f 6d6d 756e 6963  ans the communic
│ │ │ │ +00012180: 6174 696f 6e20 6973 0a69 6e74 6567 7269  ation is.integri
│ │ │ │ +00012190: 7479 2061 6e64 2070 7269 7661 6379 2070  ty and privacy p
│ │ │ │ +000121a0: 726f 7465 6374 6564 2c20 616e 6420 7468  rotected, and th
│ │ │ │ +000121b0: 6174 2075 7365 7273 2063 616e 2075 7365  at users can use
│ │ │ │ +000121c0: 204f 7065 6e50 4750 2c20 582e 3530 390a   OpenPGP, X.509.
│ │ │ │ +000121d0: 6f72 2053 5250 2028 692e 652e 2c20 616e  or SRP (i.e., an
│ │ │ │ +000121e0: 7920 6d65 6368 616e 6973 6d20 7375 7070  y mechanism supp
│ │ │ │ +000121f0: 6f72 7465 6420 6279 2054 4c53 2920 746f  orted by TLS) to
│ │ │ │ +00012200: 2061 7574 6865 6e74 6963 6174 6520 7468   authenticate th
│ │ │ │ +00012210: 656d 7365 6c76 6573 0a74 6f20 7468 6520  emselves.to the 
│ │ │ │ +00012220: 4b65 7262 6572 6f73 2073 6572 7665 722e  Kerberos server.
│ │ │ │ +00012230: 2020 466f 7220 6465 7461 696c 7320 6f6e    For details on
│ │ │ │ +00012240: 2074 6865 2069 6d70 6c65 6d65 6e74 6174   the implementat
│ │ │ │ +00012250: 696f 6e2c 202a 4e6f 7465 0a53 5441 5254  ion, *Note.START
│ │ │ │ +00012260: 544c 5320 7072 6f74 6563 7465 6420 4b44  TLS protected KD
│ │ │ │ +00012270: 4320 6578 6368 616e 6765 733a 3a2e 0a0a  C exchanges::...
│ │ │ │ +00012280: 332e 362e 3120 5365 7474 696e 6720 7570  3.6.1 Setting up
│ │ │ │ +00012290: 2054 4c53 2072 6573 756d 650a 2d2d 2d2d   TLS resume.----
│ │ │ │  000122a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000122b0: 2d2d 2d2d 2d0a 0a52 6573 756d 696e 6720  -----..Resuming 
│ │ │ │ -000122c0: 6561 726c 6965 7220 544c 5320 7365 7373  earlier TLS sess
│ │ │ │ -000122d0: 696f 6e20 6973 2073 7570 706f 7274 6564  ion is supported
│ │ │ │ -000122e0: 2061 6e64 2065 6e61 626c 6564 2062 7920   and enabled by 
│ │ │ │ -000122f0: 6465 6661 756c 742e 2020 5468 6973 0a69  default.  This.i
│ │ │ │ -00012300: 6d70 726f 7665 7320 7468 6520 7370 6565  mproves the spee
│ │ │ │ -00012310: 6420 6f66 2074 6865 2054 4c53 2068 616e  d of the TLS han
│ │ │ │ -00012320: 6473 6861 6b65 2c20 6265 6361 7573 6520  dshake, because 
│ │ │ │ -00012330: 7265 7375 6c74 7320 6672 6f6d 2065 6172  results from ear
│ │ │ │ -00012340: 6c69 6572 0a6e 6567 6f74 6961 7469 6f6e  lier.negotiation
│ │ │ │ -00012350: 7320 6361 6e20 6265 2072 652d 7573 6564  s can be re-used
│ │ │ │ -00012360: 2e20 2043 7572 7265 6e74 6c79 2074 6865  .  Currently the
│ │ │ │ -00012370: 2054 4c53 2072 6573 756d 6520 6461 7461   TLS resume data
│ │ │ │ -00012380: 6261 7365 2069 730a 7374 6f72 6564 2069  base is.stored i
│ │ │ │ -00012390: 6e20 6d65 6d6f 7279 2028 696e 2063 6f6e  n memory (in con
│ │ │ │ -000123a0: 7374 7261 6374 2074 6f20 7374 6f72 696e  stract to storin
│ │ │ │ -000123b0: 6720 6974 206f 6e20 6469 736b 292c 2069  g it on disk), i
│ │ │ │ -000123c0: 6e20 626f 7468 2074 6865 0a63 6c69 656e  n both the.clien
│ │ │ │ -000123d0: 7420 616e 6420 696e 2074 6865 2073 6572  t and in the ser
│ │ │ │ -000123e0: 7665 722e 2020 4265 6361 7573 6520 7468  ver.  Because th
│ │ │ │ -000123f0: 6520 7365 7276 6572 2074 7970 6963 616c  e server typical
│ │ │ │ -00012400: 6c79 2072 756e 7320 666f 7220 6120 6c6f  ly runs for a lo
│ │ │ │ -00012410: 6e67 0a74 696d 652c 2074 6869 7320 6973  ng.time, this is
│ │ │ │ -00012420: 206e 6f74 2061 2070 726f 626c 656d 2066   not a problem f
│ │ │ │ -00012430: 6f72 2074 6861 7420 7369 6465 2e20 2054  or that side.  T
│ │ │ │ -00012440: 6865 2063 6c69 656e 7420 6973 2074 7970  he client is typ
│ │ │ │ -00012450: 6963 616c 6c79 206e 6f74 0a61 206c 6f6e  ically not.a lon
│ │ │ │ -00012460: 672d 7275 6e6e 696e 6720 7072 6f63 6573  g-running proces
│ │ │ │ -00012470: 7320 7468 6f75 6768 3b20 7468 6520 636c  s though; the cl
│ │ │ │ -00012480: 6965 6e74 2075 7375 616c 6c79 2069 7320  ient usually is 
│ │ │ │ -00012490: 696e 766f 6b65 6420 6173 2070 6172 7420  invoked as part 
│ │ │ │ -000124a0: 6f66 0a61 7070 6c69 6361 7469 6f6e 7320  of.applications 
│ │ │ │ -000124b0: 6c69 6b65 20e2 8098 7465 6c6e 6574 e280  like ...telnet..
│ │ │ │ -000124c0: 9920 6f72 20e2 8098 6c6f 6769 6ee2 8099  . or ...login...
│ │ │ │ -000124d0: 2e20 2048 6f77 6576 6572 2c20 6265 6361  .  However, beca
│ │ │ │ -000124e0: 7573 6520 6561 6368 2075 7365 206f 6620  use each use of 
│ │ │ │ -000124f0: 7468 650a 636c 6965 6e74 206c 6962 7261  the.client libra
│ │ │ │ -00012500: 7279 2074 7970 6963 616c 6c79 2072 6573  ry typically res
│ │ │ │ -00012510: 756c 7420 696e 2061 2074 6963 6b65 742c  ult in a ticket,
│ │ │ │ -00012520: 2077 6869 6368 2069 7320 7374 6f72 6564   which is stored
│ │ │ │ -00012530: 206f 6e20 6469 736b 2061 6e64 0a72 652d   on disk and.re-
│ │ │ │ -00012540: 7573 6564 2062 7920 6c61 7465 7220 7072  used by later pr
│ │ │ │ -00012550: 6f63 6573 7365 732c 2074 6869 7320 6973  ocesses, this is
│ │ │ │ -00012560: 206c 696b 656c 7920 6e6f 7420 6120 7365   likely not a se
│ │ │ │ -00012570: 7269 6f75 7320 7072 6f62 6c65 6d20 6265  rious problem be
│ │ │ │ -00012580: 6361 7573 650a 7468 6520 6e75 6d62 6572  cause.the number
│ │ │ │ -00012590: 206f 6620 6469 6666 6572 656e 7420 7469   of different ti
│ │ │ │ -000125a0: 636b 6574 7320 7265 7175 6972 6564 2062  ckets required b
│ │ │ │ -000125b0: 7920 6120 7573 6572 2069 7320 7573 7561  y a user is usua
│ │ │ │ -000125c0: 6c6c 7920 7175 6974 650a 736d 616c 6c2e  lly quite.small.
│ │ │ │ -000125d0: 2020 466f 7220 7468 6520 636c 6965 6e74    For the client
│ │ │ │ -000125e0: 2c20 544c 5320 7265 7375 6d65 2069 7320  , TLS resume is 
│ │ │ │ -000125f0: 7479 7069 6361 6c6c 7920 6f6e 6c79 2075  typically only u
│ │ │ │ -00012600: 7365 6675 6c20 7768 656e 2079 6f75 0a70  seful when you.p
│ │ │ │ -00012610: 6572 666f 726d 2061 6e20 696e 6974 6961  erform an initia
│ │ │ │ -00012620: 6c20 6175 7468 656e 7469 6361 7469 6f6e  l authentication
│ │ │ │ -00012630: 2028 7573 696e 6720 6120 7061 7373 776f   (using a passwo
│ │ │ │ -00012640: 7264 2920 666f 6c6c 6f77 6564 2062 7920  rd) followed by 
│ │ │ │ -00012650: 610a 7469 636b 6574 2072 6571 7565 7374  a.ticket request
│ │ │ │ -00012660: 2066 6f72 2061 2073 6572 7669 6365 2c20   for a service, 
│ │ │ │ -00012670: 696e 2074 6865 2073 616d 6520 7072 6f63  in the same proc
│ │ │ │ -00012680: 6573 732e 0a0a 2020 2059 6f75 2063 616e  ess...   You can
│ │ │ │ -00012690: 2063 6f6e 6669 6775 7265 2074 6865 2073   configure the s
│ │ │ │ -000126a0: 6572 7665 722c 20e2 8098 7368 6973 6869  erver, ...shishi
│ │ │ │ -000126b0: 64e2 8099 2074 6f20 6e65 7665 7220 7573  d... to never us
│ │ │ │ -000126c0: 6520 544c 5320 7265 7375 6d65 2c20 6f72  e TLS resume, or
│ │ │ │ -000126d0: 0a74 6f20 696e 6372 6561 7365 206f 7220  .to increase or 
│ │ │ │ -000126e0: 6465 6372 6561 7365 2074 6865 206e 756d  decrease the num
│ │ │ │ -000126f0: 6265 7220 6f66 2064 6973 7469 6e63 7420  ber of distinct 
│ │ │ │ -00012700: 544c 5320 636f 6e6e 6563 7469 6f6e 7320  TLS connections 
│ │ │ │ -00012710: 7468 6174 2063 616e 0a62 6520 7265 7375  that can.be resu
│ │ │ │ -00012720: 6d65 6420 6265 666f 7265 2074 6865 7920  med before they 
│ │ │ │ -00012730: 6172 6520 6761 7262 6167 6520 636f 6c6c  are garbage coll
│ │ │ │ -00012740: 6563 7465 642c 2073 6565 2074 6865 20e2  ected, see the .
│ │ │ │ -00012750: 8098 2d2d 7265 7375 6d65 2d6c 696d 6974  ..--resume-limit
│ │ │ │ -00012760: e280 990a 7061 7261 6d65 7465 7220 282a  ....parameter (*
│ │ │ │ -00012770: 6e6f 7465 2050 6172 616d 6574 6572 7320  note Parameters 
│ │ │ │ -00012780: 666f 7220 7368 6973 6869 643a 3a29 2e0a  for shishid::)..
│ │ │ │ -00012790: 0a33 2e36 2e32 2053 6574 7469 6e67 2075  .3.6.2 Setting u
│ │ │ │ -000127a0: 7020 416e 6f6e 796d 6f75 7320 544c 530a  p Anonymous TLS.
│ │ │ │ -000127b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000127c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -000127d0: 416e 6f6e 796d 6f75 7320 544c 5320 6973  Anonymous TLS is
│ │ │ │ -000127e0: 2074 6865 2073 696d 706c 6573 7420 746f   the simplest to
│ │ │ │ -000127f0: 2073 6574 2075 7020 616e 6420 7573 652e   set up and use.
│ │ │ │ -00012800: 2020 496e 2066 6163 742c 206f 6e6c 7920    In fact, only 
│ │ │ │ -00012810: 7468 650a 636c 6965 6e74 206e 6565 6420  the.client need 
│ │ │ │ -00012820: 746f 2062 6520 696e 666f 726d 6564 2074  to be informed t
│ │ │ │ -00012830: 6861 7420 796f 7572 204b 4443 2073 7570  hat your KDC sup
│ │ │ │ -00012840: 706f 7274 2054 4c53 2e20 5468 6973 2063  port TLS. This c
│ │ │ │ -00012850: 616e 2062 6520 646f 6e65 0a69 6e20 7468  an be done.in th
│ │ │ │ -00012860: 6520 636f 6e66 6967 7572 6174 696f 6e20  e configuration 
│ │ │ │ -00012870: 6669 6c65 2077 6974 6820 7468 6520 e280  file with the ..
│ │ │ │ -00012880: 982f 746c 73e2 8099 2070 6172 616d 6574  ./tls... paramet
│ │ │ │ -00012890: 6572 2066 6f72 20e2 8098 6b64 632d 7265  er for ...kdc-re
│ │ │ │ -000128a0: 616c 6de2 8099 0a28 2a6e 6f74 6520 5368  alm....(*note Sh
│ │ │ │ -000128b0: 6973 6869 2043 6f6e 6669 6775 7261 7469  ishi Configurati
│ │ │ │ -000128c0: 6f6e 3a20 7265 616c 6d2d 6b64 632e 292c  on: realm-kdc.),
│ │ │ │ -000128d0: 206f 7220 6279 2070 6c61 6369 6e67 2074   or by placing t
│ │ │ │ -000128e0: 6865 204b 4443 2061 6464 7265 7373 0a69  he KDC address.i
│ │ │ │ -000128f0: 6e20 444e 5320 7573 696e 6720 7468 6520  n DNS using the 
│ │ │ │ -00012900: e280 985f 746c 73e2 8099 2053 5256 2072  ..._tls... SRV r
│ │ │ │ -00012910: 6563 6f72 6420 282a 6e6f 7465 2043 6f6e  ecord (*note Con
│ │ │ │ -00012920: 6669 6775 7269 6e67 2044 4e53 2066 6f72  figuring DNS for
│ │ │ │ -00012930: 204b 4443 3a3a 292e 0a0a 2020 204c 6574   KDC::)...   Let
│ │ │ │ -00012940: 2773 2073 7461 7274 2053 6869 7368 6964  's start Shishid
│ │ │ │ -00012950: 2c20 6c69 7374 656e 696e 6720 6f6e 2061  , listening on a
│ │ │ │ -00012960: 2054 4350 2073 6f63 6b65 742e 2020 544c   TCP socket.  TL
│ │ │ │ -00012970: 5320 7265 7175 6972 6520 5443 502e 2054  S require TCP. T
│ │ │ │ -00012980: 4350 0a73 6f63 6b65 7473 2061 7265 2061  CP.sockets are a
│ │ │ │ -00012990: 7574 6f6d 6174 6963 616c 6c79 2075 7067  utomatically upg
│ │ │ │ -000129a0: 7261 6465 6420 746f 2054 4c53 2069 6620  raded to TLS if 
│ │ │ │ -000129b0: 7468 6520 636c 6965 6e74 2072 6571 7565  the client reque
│ │ │ │ -000129c0: 7374 2069 742e 0a0a 2020 2020 206a 6173  st it...     jas
│ │ │ │ -000129d0: 406c 6174 7465 3a7e 2420 2f75 7372 2f6c  @latte:~$ /usr/l
│ │ │ │ -000129e0: 6f63 616c 2f73 6269 6e2f 7368 6973 6869  ocal/sbin/shishi
│ │ │ │ -000129f0: 6420 2d6c 2049 5076 343a 2a3a 3437 3131  d -l IPv4:*:4711
│ │ │ │ -00012a00: 2f74 6370 0a20 2020 2020 496e 6974 6961  /tcp.     Initia
│ │ │ │ -00012a10: 6c69 7a69 6e67 2047 4e55 544c 532e 2e2e  lizing GNUTLS...
│ │ │ │ -00012a20: 646f 6e65 0a20 2020 2020 4c69 7374 656e  done.     Listen
│ │ │ │ -00012a30: 696e 6720 6f6e 2049 5076 343a 2a3a 3437  ing on IPv4:*:47
│ │ │ │ -00012a40: 3131 2f74 6370 2e2e 2e0a 2020 2020 204c  11/tcp....     L
│ │ │ │ -00012a50: 6973 7465 6e69 6e67 206f 6e20 3120 706f  istening on 1 po
│ │ │ │ -00012a60: 7274 732e 2e2e 0a20 2020 2020 7368 6973  rts....     shis
│ │ │ │ -00012a70: 6869 643a 2053 7461 7274 696e 6720 2847  hid: Starting (G
│ │ │ │ -00012a80: 4e55 544c 5320 6031 2e30 2e34 2729 0a20  NUTLS `1.0.4'). 
│ │ │ │ -00012a90: 2020 2020 7368 6973 6869 643a 204c 6973      shishid: Lis
│ │ │ │ -00012aa0: 7465 6e69 6e67 206f 6e20 4950 7634 3a2a  tening on IPv4:*
│ │ │ │ -00012ab0: 3a34 3731 312f 7463 7020 736f 636b 6574  :4711/tcp socket
│ │ │ │ -00012ac0: 2034 0a0a 2020 204c 6574 2773 2075 7365   4..   Let's use
│ │ │ │ -00012ad0: 2074 6865 2063 6c69 656e 7420 746f 2074   the client to t
│ │ │ │ -00012ae0: 616c 6b20 7769 7468 2069 742c 2075 7369  alk with it, usi
│ │ │ │ -00012af0: 6e67 2054 4c53 2e0a 0a20 2020 2020 6a61  ng TLS...     ja
│ │ │ │ -00012b00: 7340 6c61 7474 653a 7e24 2073 6869 7368  s@latte:~$ shish
│ │ │ │ -00012b10: 6920 2d6f 2027 7265 616c 6d2d 6b64 633d  i -o 'realm-kdc=
│ │ │ │ -00012b20: 4558 414d 504c 452e 4f52 472c 6c6f 6361  EXAMPLE.ORG,loca
│ │ │ │ -00012b30: 6c68 6f73 743a 3437 3131 2f74 6c73 205c  lhost:4711/tls \
│ │ │ │ -00012b40: 0a20 2020 2020 2020 2020 7369 6d6f 6e40  .         simon@
│ │ │ │ -00012b50: 4558 414d 504c 452e 4f52 470a 2020 2020  EXAMPLE.ORG.    
│ │ │ │ -00012b60: 2045 6e74 6572 2070 6173 7377 6f72 6420   Enter password 
│ │ │ │ -00012b70: 666f 7220 6073 696d 6f6e 4045 5841 4d50  for `simon@EXAMP
│ │ │ │ -00012b80: 4c45 2e4f 5247 273a 0a20 2020 2020 7369  LE.ORG':.     si
│ │ │ │ -00012b90: 6d6f 6e40 4558 414d 504c 452e 4f52 473a  mon@EXAMPLE.ORG:
│ │ │ │ -00012ba0: 0a20 2020 2020 4175 7468 7469 6d65 3a20  .     Authtime: 
│ │ │ │ -00012bb0: 2020 2020 2020 5475 6520 4465 6320 3136        Tue Dec 16
│ │ │ │ -00012bc0: 2030 353a 3230 3a34 3720 3230 3033 0a20   05:20:47 2003. 
│ │ │ │ -00012bd0: 2020 2020 456e 6474 696d 653a 2020 2020      Endtime:    
│ │ │ │ -00012be0: 2020 2020 5475 6520 4465 6320 3136 2030      Tue Dec 16 0
│ │ │ │ -00012bf0: 353a 3337 3a32 3720 3230 3033 0a20 2020  5:37:27 2003.   
│ │ │ │ -00012c00: 2020 5365 7276 6572 3a20 2020 2020 2020    Server:       
│ │ │ │ -00012c10: 2020 6b72 6274 6774 2f45 5841 4d50 4c45    krbtgt/EXAMPLE
│ │ │ │ -00012c20: 2e4f 5247 206b 6579 2061 6573 3235 362d  .ORG key aes256-
│ │ │ │ -00012c30: 6374 732d 686d 6163 2d73 6861 312d 3936  cts-hmac-sha1-96
│ │ │ │ -00012c40: 2028 3138 290a 2020 2020 2054 6963 6b65   (18).     Ticke
│ │ │ │ -00012c50: 7420 6b65 793a 2020 2020 2061 6573 3235  t key:     aes25
│ │ │ │ -00012c60: 362d 6374 732d 686d 6163 2d73 6861 312d  6-cts-hmac-sha1-
│ │ │ │ -00012c70: 3936 2028 3138 2920 7072 6f74 6563 7465  96 (18) protecte
│ │ │ │ -00012c80: 6420 6279 2061 6573 3235 362d 6374 732d  d by aes256-cts-
│ │ │ │ -00012c90: 686d 6163 2d73 6861 312d 3936 2028 3138  hmac-sha1-96 (18
│ │ │ │ -00012ca0: 290a 2020 2020 2054 6963 6b65 7420 666c  ).     Ticket fl
│ │ │ │ -00012cb0: 6167 733a 2020 2046 4f52 5741 5244 4544  ags:   FORWARDED
│ │ │ │ -00012cc0: 2050 524f 5849 4142 4c45 2028 3132 290a   PROXIABLE (12).
│ │ │ │ -00012cd0: 2020 2020 206a 6173 406c 6174 7465 3a7e       jas@latte:~
│ │ │ │ -00012ce0: 240a 0a20 2020 4f6e 2073 7563 6365 7373  $..   On success
│ │ │ │ -00012cf0: 2c20 7468 6520 7365 7276 6572 2077 696c  , the server wil
│ │ │ │ -00012d00: 6c20 7072 696e 7420 7468 6520 666f 6c6c  l print the foll
│ │ │ │ -00012d10: 6f77 696e 6720 6465 6275 6720 696e 666f  owing debug info
│ │ │ │ -00012d20: 726d 6174 696f 6e2e 0a0a 2020 2020 2073  rmation...     s
│ │ │ │ -00012d30: 6869 7368 6964 3a20 4163 6365 7074 6564  hishid: Accepted
│ │ │ │ -00012d40: 2073 6f63 6b65 7420 3620 6672 6f6d 2073   socket 6 from s
│ │ │ │ -00012d50: 6f63 6b65 7420 3420 6173 2049 5076 343a  ocket 4 as IPv4:
│ │ │ │ -00012d60: 2a3a 3437 3131 2f74 6370 2070 6565 7220  *:4711/tcp peer 
│ │ │ │ -00012d70: 3132 372e 302e 302e 310a 2020 2020 2073  127.0.0.1.     s
│ │ │ │ -00012d80: 6869 7368 6964 3a20 4c69 7374 656e 696e  hishid: Listenin
│ │ │ │ -00012d90: 6720 6f6e 2049 5076 343a 2a3a 3437 3131  g on IPv4:*:4711
│ │ │ │ -00012da0: 2f74 6370 2073 6f63 6b65 7420 340a 2020  /tcp socket 4.  
│ │ │ │ -00012db0: 2020 2073 6869 7368 6964 3a20 4c69 7374     shishid: List
│ │ │ │ -00012dc0: 656e 696e 6720 6f6e 2049 5076 343a 2a3a  ening on IPv4:*:
│ │ │ │ -00012dd0: 3437 3131 2f74 6370 2070 6565 7220 3132  4711/tcp peer 12
│ │ │ │ -00012de0: 372e 302e 302e 3120 736f 636b 6574 2036  7.0.0.1 socket 6
│ │ │ │ -00012df0: 0a20 2020 2020 7368 6973 6869 643a 2048  .     shishid: H
│ │ │ │ -00012e00: 6173 2034 2062 7974 6573 2066 726f 6d20  as 4 bytes from 
│ │ │ │ -00012e10: 4950 7634 3a2a 3a34 3731 312f 7463 7020  IPv4:*:4711/tcp 
│ │ │ │ -00012e20: 7065 6572 2031 3237 2e30 2e30 2e31 206f  peer 127.0.0.1 o
│ │ │ │ -00012e30: 6e20 736f 636b 6574 2036 0a20 2020 2020  n socket 6.     
│ │ │ │ -00012e40: 7368 6973 6869 643a 2054 7279 696e 6720  shishid: Trying 
│ │ │ │ -00012e50: 5354 4152 5454 4c53 0a20 2020 2020 7368  STARTTLS.     sh
│ │ │ │ -00012e60: 6973 6869 643a 2054 4c53 2068 616e 6473  ishid: TLS hands
│ │ │ │ -00012e70: 6861 6b65 206e 6567 6f74 6961 7465 6420  hake negotiated 
│ │ │ │ -00012e80: 7072 6f74 6f63 6f6c 2060 544c 5320 312e  protocol `TLS 1.
│ │ │ │ -00012e90: 3027 2c20 6b65 7920 6578 6368 616e 6765  0', key exchange
│ │ │ │ -00012ea0: 2060 416e 6f6e 2044 4827 2c20 6365 7274   `Anon DH', cert
│ │ │ │ -00012eb0: 6966 6963 6174 6520 7479 7065 2060 582e  ificate type `X.
│ │ │ │ -00012ec0: 3530 3927 2c20 6369 7068 6572 2060 4145  509', cipher `AE
│ │ │ │ -00012ed0: 5320 3235 3620 4342 4327 2c20 6d61 6320  S 256 CBC', mac 
│ │ │ │ -00012ee0: 6053 4841 272c 2063 6f6d 7072 6573 7369  `SHA', compressi
│ │ │ │ -00012ef0: 6f6e 2060 4e55 4c4c 272c 2073 6573 7369  on `NULL', sessi
│ │ │ │ -00012f00: 6f6e 206e 6f74 2072 6573 756d 6564 0a20  on not resumed. 
│ │ │ │ -00012f10: 2020 2020 7368 6973 6869 643a 2054 4c53      shishid: TLS
│ │ │ │ -00012f20: 2061 6e6f 6e79 6d6f 7573 2061 7574 6865   anonymous authe
│ │ │ │ -00012f30: 6e74 6963 6174 696f 6e20 7769 7468 2031  ntication with 1
│ │ │ │ -00012f40: 3032 3420 6269 7420 4469 6666 6965 2d48  024 bit Diffie-H
│ │ │ │ -00012f50: 656c 6c6d 616e 0a20 2020 2020 7368 6973  ellman.     shis
│ │ │ │ -00012f60: 6869 643a 204c 6973 7465 6e69 6e67 206f  hid: Listening o
│ │ │ │ -00012f70: 6e20 4950 7634 3a2a 3a34 3731 312f 7463  n IPv4:*:4711/tc
│ │ │ │ -00012f80: 7020 736f 636b 6574 2034 0a20 2020 2020  p socket 4.     
│ │ │ │ -00012f90: 7368 6973 6869 643a 204c 6973 7465 6e69  shishid: Listeni
│ │ │ │ -00012fa0: 6e67 206f 6e20 4950 7634 3a2a 3a34 3731  ng on IPv4:*:471
│ │ │ │ -00012fb0: 312f 7463 7020 7065 6572 2031 3237 2e30  1/tcp peer 127.0
│ │ │ │ -00012fc0: 2e30 2e31 2073 6f63 6b65 7420 360a 2020  .0.1 socket 6.  
│ │ │ │ -00012fd0: 2020 2073 6869 7368 6964 3a20 4861 7320     shishid: Has 
│ │ │ │ -00012fe0: 3133 3120 6279 7465 7320 6672 6f6d 2049  131 bytes from I
│ │ │ │ -00012ff0: 5076 343a 2a3a 3437 3131 2f74 6370 2070  Pv4:*:4711/tcp p
│ │ │ │ -00013000: 6565 7220 3132 372e 302e 302e 3120 6f6e  eer 127.0.0.1 on
│ │ │ │ -00013010: 2073 6f63 6b65 7420 360a 2020 2020 2073   socket 6.     s
│ │ │ │ -00013020: 6869 7368 6964 3a20 5072 6f63 6573 7369  hishid: Processi
│ │ │ │ -00013030: 6e67 2031 3331 2066 726f 6d20 4950 7634  ng 131 from IPv4
│ │ │ │ -00013040: 3a2a 3a34 3731 312f 7463 7020 7065 6572  :*:4711/tcp peer
│ │ │ │ -00013050: 2031 3237 2e30 2e30 2e31 206f 6e20 736f   127.0.0.1 on so
│ │ │ │ -00013060: 636b 6574 2036 0a20 2020 2020 7368 6973  cket 6.     shis
│ │ │ │ -00013070: 6869 643a 2054 7279 696e 6720 4153 2d52  hid: Trying AS-R
│ │ │ │ -00013080: 4551 0a20 2020 2020 7368 6973 6869 643a  EQ.     shishid:
│ │ │ │ -00013090: 2041 532d 5245 5120 6672 6f6d 2073 696d   AS-REQ from sim
│ │ │ │ -000130a0: 6f6e 4045 5841 4d50 4c45 2e4f 5247 2066  on@EXAMPLE.ORG f
│ │ │ │ -000130b0: 6f72 206b 7262 7467 742f 4558 414d 504c  or krbtgt/EXAMPL
│ │ │ │ -000130c0: 452e 4f52 4740 4558 414d 504c 452e 4f52  E.ORG@EXAMPLE.OR
│ │ │ │ -000130d0: 470a 2020 2020 2073 6869 7368 6964 3a20  G.     shishid: 
│ │ │ │ -000130e0: 4d61 7463 6869 6e67 2063 6c69 656e 7420  Matching client 
│ │ │ │ -000130f0: 6574 7970 6520 3138 2061 6761 696e 7374  etype 18 against
│ │ │ │ -00013100: 2075 7365 7220 6b65 7920 6574 7970 6520   user key etype 
│ │ │ │ -00013110: 3138 0a20 2020 2020 7368 6973 6869 643a  18.     shishid:
│ │ │ │ -00013120: 2048 6176 6520 3531 3120 6279 7465 7320   Have 511 bytes 
│ │ │ │ -00013130: 666f 7220 4950 7634 3a2a 3a34 3731 312f  for IPv4:*:4711/
│ │ │ │ -00013140: 7463 7020 7065 6572 2031 3237 2e30 2e30  tcp peer 127.0.0
│ │ │ │ -00013150: 2e31 206f 6e20 736f 636b 6574 2036 0a20  .1 on socket 6. 
│ │ │ │ -00013160: 2020 2020 7368 6973 6869 643a 2053 656e      shishid: Sen
│ │ │ │ -00013170: 6469 6e67 2035 3131 2062 7974 6573 2074  ding 511 bytes t
│ │ │ │ -00013180: 6f20 4950 7634 3a2a 3a34 3731 312f 7463  o IPv4:*:4711/tc
│ │ │ │ -00013190: 7020 7065 6572 2031 3237 2e30 2e30 2e31  p peer 127.0.0.1
│ │ │ │ -000131a0: 2073 6f63 6b65 7420 3620 7669 6120 544c   socket 6 via TL
│ │ │ │ -000131b0: 530a 2020 2020 2073 6869 7368 6964 3a20  S.     shishid: 
│ │ │ │ -000131c0: 4c69 7374 656e 696e 6720 6f6e 2049 5076  Listening on IPv
│ │ │ │ -000131d0: 343a 2a3a 3437 3131 2f74 6370 2073 6f63  4:*:4711/tcp soc
│ │ │ │ -000131e0: 6b65 7420 340a 2020 2020 2073 6869 7368  ket 4.     shish
│ │ │ │ -000131f0: 6964 3a20 4c69 7374 656e 696e 6720 6f6e  id: Listening on
│ │ │ │ -00013200: 2049 5076 343a 2a3a 3437 3131 2f74 6370   IPv4:*:4711/tcp
│ │ │ │ -00013210: 2070 6565 7220 3132 372e 302e 302e 3120   peer 127.0.0.1 
│ │ │ │ -00013220: 736f 636b 6574 2036 0a20 2020 2020 7368  socket 6.     sh
│ │ │ │ -00013230: 6973 6869 643a 2050 6565 7220 4950 7634  ishid: Peer IPv4
│ │ │ │ -00013240: 3a2a 3a34 3731 312f 7463 7020 7065 6572  :*:4711/tcp peer
│ │ │ │ -00013250: 2031 3237 2e30 2e30 2e31 2064 6973 636f   127.0.0.1 disco
│ │ │ │ -00013260: 6e6e 6563 7465 6420 6f6e 2073 6f63 6b65  nnected on socke
│ │ │ │ -00013270: 7420 360a 2020 2020 2073 6869 7368 6964  t 6.     shishid
│ │ │ │ -00013280: 3a20 436c 6f73 696e 6720 4950 7634 3a2a  : Closing IPv4:*
│ │ │ │ -00013290: 3a34 3731 312f 7463 7020 7065 6572 2031  :4711/tcp peer 1
│ │ │ │ -000132a0: 3237 2e30 2e30 2e31 2073 6f63 6b65 7420  27.0.0.1 socket 
│ │ │ │ -000132b0: 360a 2020 2020 2073 6869 7368 6964 3a20  6.     shishid: 
│ │ │ │ -000132c0: 4c69 7374 656e 696e 6720 6f6e 2049 5076  Listening on IPv
│ │ │ │ -000132d0: 343a 2a3a 3437 3131 2f74 6370 2073 6f63  4:*:4711/tcp soc
│ │ │ │ -000132e0: 6b65 7420 340a 0a33 2e36 2e33 2053 6574  ket 4..3.6.3 Set
│ │ │ │ -000132f0: 7469 6e67 2075 7020 582e 3530 3920 6175  ting up X.509 au
│ │ │ │ -00013300: 7468 656e 7469 6361 7465 6420 544c 530a  thenticated TLS.
│ │ │ │ -00013310: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +000122b0: 2d2d 2d2d 2d2d 2d0a 0a52 6573 756d 696e  -------..Resumin
│ │ │ │ +000122c0: 6720 6561 726c 6965 7220 544c 5320 7365  g earlier TLS se
│ │ │ │ +000122d0: 7373 696f 6e20 6973 2073 7570 706f 7274  ssion is support
│ │ │ │ +000122e0: 6564 2061 6e64 2065 6e61 626c 6564 2062  ed and enabled b
│ │ │ │ +000122f0: 7920 6465 6661 756c 742e 2020 5468 6973  y default.  This
│ │ │ │ +00012300: 0a69 6d70 726f 7665 7320 7468 6520 7370  .improves the sp
│ │ │ │ +00012310: 6565 6420 6f66 2074 6865 2054 4c53 2068  eed of the TLS h
│ │ │ │ +00012320: 616e 6473 6861 6b65 2c20 6265 6361 7573  andshake, becaus
│ │ │ │ +00012330: 6520 7265 7375 6c74 7320 6672 6f6d 2065  e results from e
│ │ │ │ +00012340: 6172 6c69 6572 0a6e 6567 6f74 6961 7469  arlier.negotiati
│ │ │ │ +00012350: 6f6e 7320 6361 6e20 6265 2072 652d 7573  ons can be re-us
│ │ │ │ +00012360: 6564 2e20 2043 7572 7265 6e74 6c79 2074  ed.  Currently t
│ │ │ │ +00012370: 6865 2054 4c53 2072 6573 756d 6520 6461  he TLS resume da
│ │ │ │ +00012380: 7461 6261 7365 2069 730a 7374 6f72 6564  tabase is.stored
│ │ │ │ +00012390: 2069 6e20 6d65 6d6f 7279 2028 696e 2063   in memory (in c
│ │ │ │ +000123a0: 6f6e 7374 7261 6374 2074 6f20 7374 6f72  onstract to stor
│ │ │ │ +000123b0: 696e 6720 6974 206f 6e20 6469 736b 292c  ing it on disk),
│ │ │ │ +000123c0: 2069 6e20 626f 7468 2074 6865 0a63 6c69   in both the.cli
│ │ │ │ +000123d0: 656e 7420 616e 6420 696e 2074 6865 2073  ent and in the s
│ │ │ │ +000123e0: 6572 7665 722e 2020 4265 6361 7573 6520  erver.  Because 
│ │ │ │ +000123f0: 7468 6520 7365 7276 6572 2074 7970 6963  the server typic
│ │ │ │ +00012400: 616c 6c79 2072 756e 7320 666f 7220 6120  ally runs for a 
│ │ │ │ +00012410: 6c6f 6e67 0a74 696d 652c 2074 6869 7320  long.time, this 
│ │ │ │ +00012420: 6973 206e 6f74 2061 2070 726f 626c 656d  is not a problem
│ │ │ │ +00012430: 2066 6f72 2074 6861 7420 7369 6465 2e20   for that side. 
│ │ │ │ +00012440: 2054 6865 2063 6c69 656e 7420 6973 2074   The client is t
│ │ │ │ +00012450: 7970 6963 616c 6c79 206e 6f74 0a61 206c  ypically not.a l
│ │ │ │ +00012460: 6f6e 672d 7275 6e6e 696e 6720 7072 6f63  ong-running proc
│ │ │ │ +00012470: 6573 7320 7468 6f75 6768 3b20 7468 6520  ess though; the 
│ │ │ │ +00012480: 636c 6965 6e74 2075 7375 616c 6c79 2069  client usually i
│ │ │ │ +00012490: 7320 696e 766f 6b65 6420 6173 2070 6172  s invoked as par
│ │ │ │ +000124a0: 7420 6f66 0a61 7070 6c69 6361 7469 6f6e  t of.application
│ │ │ │ +000124b0: 7320 6c69 6b65 20e2 8098 7465 6c6e 6574  s like ...telnet
│ │ │ │ +000124c0: e280 9920 6f72 20e2 8098 6c6f 6769 6ee2  ... or ...login.
│ │ │ │ +000124d0: 8099 2e20 2048 6f77 6576 6572 2c20 6265  ...  However, be
│ │ │ │ +000124e0: 6361 7573 6520 6561 6368 2075 7365 206f  cause each use o
│ │ │ │ +000124f0: 6620 7468 650a 636c 6965 6e74 206c 6962  f the.client lib
│ │ │ │ +00012500: 7261 7279 2074 7970 6963 616c 6c79 2072  rary typically r
│ │ │ │ +00012510: 6573 756c 7420 696e 2061 2074 6963 6b65  esult in a ticke
│ │ │ │ +00012520: 742c 2077 6869 6368 2069 7320 7374 6f72  t, which is stor
│ │ │ │ +00012530: 6564 206f 6e20 6469 736b 2061 6e64 0a72  ed on disk and.r
│ │ │ │ +00012540: 652d 7573 6564 2062 7920 6c61 7465 7220  e-used by later 
│ │ │ │ +00012550: 7072 6f63 6573 7365 732c 2074 6869 7320  processes, this 
│ │ │ │ +00012560: 6973 206c 696b 656c 7920 6e6f 7420 6120  is likely not a 
│ │ │ │ +00012570: 7365 7269 6f75 7320 7072 6f62 6c65 6d20  serious problem 
│ │ │ │ +00012580: 6265 6361 7573 650a 7468 6520 6e75 6d62  because.the numb
│ │ │ │ +00012590: 6572 206f 6620 6469 6666 6572 656e 7420  er of different 
│ │ │ │ +000125a0: 7469 636b 6574 7320 7265 7175 6972 6564  tickets required
│ │ │ │ +000125b0: 2062 7920 6120 7573 6572 2069 7320 7573   by a user is us
│ │ │ │ +000125c0: 7561 6c6c 7920 7175 6974 650a 736d 616c  ually quite.smal
│ │ │ │ +000125d0: 6c2e 2020 466f 7220 7468 6520 636c 6965  l.  For the clie
│ │ │ │ +000125e0: 6e74 2c20 544c 5320 7265 7375 6d65 2069  nt, TLS resume i
│ │ │ │ +000125f0: 7320 7479 7069 6361 6c6c 7920 6f6e 6c79  s typically only
│ │ │ │ +00012600: 2075 7365 6675 6c20 7768 656e 2079 6f75   useful when you
│ │ │ │ +00012610: 0a70 6572 666f 726d 2061 6e20 696e 6974  .perform an init
│ │ │ │ +00012620: 6961 6c20 6175 7468 656e 7469 6361 7469  ial authenticati
│ │ │ │ +00012630: 6f6e 2028 7573 696e 6720 6120 7061 7373  on (using a pass
│ │ │ │ +00012640: 776f 7264 2920 666f 6c6c 6f77 6564 2062  word) followed b
│ │ │ │ +00012650: 7920 610a 7469 636b 6574 2072 6571 7565  y a.ticket reque
│ │ │ │ +00012660: 7374 2066 6f72 2061 2073 6572 7669 6365  st for a service
│ │ │ │ +00012670: 2c20 696e 2074 6865 2073 616d 6520 7072  , in the same pr
│ │ │ │ +00012680: 6f63 6573 732e 0a0a 2020 2059 6f75 2063  ocess...   You c
│ │ │ │ +00012690: 616e 2063 6f6e 6669 6775 7265 2074 6865  an configure the
│ │ │ │ +000126a0: 2073 6572 7665 722c 20e2 8098 7368 6973   server, ...shis
│ │ │ │ +000126b0: 6869 64e2 8099 2074 6f20 6e65 7665 7220  hid... to never 
│ │ │ │ +000126c0: 7573 6520 544c 5320 7265 7375 6d65 2c20  use TLS resume, 
│ │ │ │ +000126d0: 6f72 0a74 6f20 696e 6372 6561 7365 206f  or.to increase o
│ │ │ │ +000126e0: 7220 6465 6372 6561 7365 2074 6865 206e  r decrease the n
│ │ │ │ +000126f0: 756d 6265 7220 6f66 2064 6973 7469 6e63  umber of distinc
│ │ │ │ +00012700: 7420 544c 5320 636f 6e6e 6563 7469 6f6e  t TLS connection
│ │ │ │ +00012710: 7320 7468 6174 2063 616e 0a62 6520 7265  s that can.be re
│ │ │ │ +00012720: 7375 6d65 6420 6265 666f 7265 2074 6865  sumed before the
│ │ │ │ +00012730: 7920 6172 6520 6761 7262 6167 6520 636f  y are garbage co
│ │ │ │ +00012740: 6c6c 6563 7465 642c 2073 6565 2074 6865  llected, see the
│ │ │ │ +00012750: 20e2 8098 2d2d 7265 7375 6d65 2d6c 696d   ...--resume-lim
│ │ │ │ +00012760: 6974 e280 990a 7061 7261 6d65 7465 7220  it....parameter 
│ │ │ │ +00012770: 282a 6e6f 7465 2050 6172 616d 6574 6572  (*note Parameter
│ │ │ │ +00012780: 7320 666f 7220 7368 6973 6869 643a 3a29  s for shishid::)
│ │ │ │ +00012790: 2e0a 0a33 2e36 2e32 2053 6574 7469 6e67  ...3.6.2 Setting
│ │ │ │ +000127a0: 2075 7020 416e 6f6e 796d 6f75 7320 544c   up Anonymous TL
│ │ │ │ +000127b0: 530a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  S.--------------
│ │ │ │ +000127c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +000127d0: 0a0a 416e 6f6e 796d 6f75 7320 544c 5320  ..Anonymous TLS 
│ │ │ │ +000127e0: 6973 2074 6865 2073 696d 706c 6573 7420  is the simplest 
│ │ │ │ +000127f0: 746f 2073 6574 2075 7020 616e 6420 7573  to set up and us
│ │ │ │ +00012800: 652e 2020 496e 2066 6163 742c 206f 6e6c  e.  In fact, onl
│ │ │ │ +00012810: 7920 7468 650a 636c 6965 6e74 206e 6565  y the.client nee
│ │ │ │ +00012820: 6420 746f 2062 6520 696e 666f 726d 6564  d to be informed
│ │ │ │ +00012830: 2074 6861 7420 796f 7572 204b 4443 2073   that your KDC s
│ │ │ │ +00012840: 7570 706f 7274 2054 4c53 2e20 5468 6973  upport TLS. This
│ │ │ │ +00012850: 2063 616e 2062 6520 646f 6e65 0a69 6e20   can be done.in 
│ │ │ │ +00012860: 7468 6520 636f 6e66 6967 7572 6174 696f  the configuratio
│ │ │ │ +00012870: 6e20 6669 6c65 2077 6974 6820 7468 6520  n file with the 
│ │ │ │ +00012880: e280 982f 746c 73e2 8099 2070 6172 616d  .../tls... param
│ │ │ │ +00012890: 6574 6572 2066 6f72 20e2 8098 6b64 632d  eter for ...kdc-
│ │ │ │ +000128a0: 7265 616c 6de2 8099 0a28 2a6e 6f74 6520  realm....(*note 
│ │ │ │ +000128b0: 5368 6973 6869 2043 6f6e 6669 6775 7261  Shishi Configura
│ │ │ │ +000128c0: 7469 6f6e 3a20 7265 616c 6d2d 6b64 632e  tion: realm-kdc.
│ │ │ │ +000128d0: 292c 206f 7220 6279 2070 6c61 6369 6e67  ), or by placing
│ │ │ │ +000128e0: 2074 6865 204b 4443 2061 6464 7265 7373   the KDC address
│ │ │ │ +000128f0: 0a69 6e20 444e 5320 7573 696e 6720 7468  .in DNS using th
│ │ │ │ +00012900: 6520 e280 985f 746c 73e2 8099 2053 5256  e ..._tls... SRV
│ │ │ │ +00012910: 2072 6563 6f72 6420 282a 6e6f 7465 2043   record (*note C
│ │ │ │ +00012920: 6f6e 6669 6775 7269 6e67 2044 4e53 2066  onfiguring DNS f
│ │ │ │ +00012930: 6f72 204b 4443 3a3a 292e 0a0a 2020 204c  or KDC::)...   L
│ │ │ │ +00012940: 6574 2773 2073 7461 7274 2053 6869 7368  et's start Shish
│ │ │ │ +00012950: 6964 2c20 6c69 7374 656e 696e 6720 6f6e  id, listening on
│ │ │ │ +00012960: 2061 2054 4350 2073 6f63 6b65 742e 2020   a TCP socket.  
│ │ │ │ +00012970: 544c 5320 7265 7175 6972 6520 5443 502e  TLS require TCP.
│ │ │ │ +00012980: 2054 4350 0a73 6f63 6b65 7473 2061 7265   TCP.sockets are
│ │ │ │ +00012990: 2061 7574 6f6d 6174 6963 616c 6c79 2075   automatically u
│ │ │ │ +000129a0: 7067 7261 6465 6420 746f 2054 4c53 2069  pgraded to TLS i
│ │ │ │ +000129b0: 6620 7468 6520 636c 6965 6e74 2072 6571  f the client req
│ │ │ │ +000129c0: 7565 7374 2069 742e 0a0a 2020 2020 206a  uest it...     j
│ │ │ │ +000129d0: 6173 406c 6174 7465 3a7e 2420 2f75 7372  as@latte:~$ /usr
│ │ │ │ +000129e0: 2f6c 6f63 616c 2f73 6269 6e2f 7368 6973  /local/sbin/shis
│ │ │ │ +000129f0: 6869 6420 2d6c 2049 5076 343a 2a3a 3437  hid -l IPv4:*:47
│ │ │ │ +00012a00: 3131 2f74 6370 0a20 2020 2020 496e 6974  11/tcp.     Init
│ │ │ │ +00012a10: 6961 6c69 7a69 6e67 2047 4e55 544c 532e  ializing GNUTLS.
│ │ │ │ +00012a20: 2e2e 646f 6e65 0a20 2020 2020 4c69 7374  ..done.     List
│ │ │ │ +00012a30: 656e 696e 6720 6f6e 2049 5076 343a 2a3a  ening on IPv4:*:
│ │ │ │ +00012a40: 3437 3131 2f74 6370 2e2e 2e0a 2020 2020  4711/tcp....    
│ │ │ │ +00012a50: 204c 6973 7465 6e69 6e67 206f 6e20 3120   Listening on 1 
│ │ │ │ +00012a60: 706f 7274 732e 2e2e 0a20 2020 2020 7368  ports....     sh
│ │ │ │ +00012a70: 6973 6869 643a 2053 7461 7274 696e 6720  ishid: Starting 
│ │ │ │ +00012a80: 2847 4e55 544c 5320 6031 2e30 2e34 2729  (GNUTLS `1.0.4')
│ │ │ │ +00012a90: 0a20 2020 2020 7368 6973 6869 643a 204c  .     shishid: L
│ │ │ │ +00012aa0: 6973 7465 6e69 6e67 206f 6e20 4950 7634  istening on IPv4
│ │ │ │ +00012ab0: 3a2a 3a34 3731 312f 7463 7020 736f 636b  :*:4711/tcp sock
│ │ │ │ +00012ac0: 6574 2034 0a0a 2020 204c 6574 2773 2075  et 4..   Let's u
│ │ │ │ +00012ad0: 7365 2074 6865 2063 6c69 656e 7420 746f  se the client to
│ │ │ │ +00012ae0: 2074 616c 6b20 7769 7468 2069 742c 2075   talk with it, u
│ │ │ │ +00012af0: 7369 6e67 2054 4c53 2e0a 0a20 2020 2020  sing TLS...     
│ │ │ │ +00012b00: 6a61 7340 6c61 7474 653a 7e24 2073 6869  jas@latte:~$ shi
│ │ │ │ +00012b10: 7368 6920 2d6f 2027 7265 616c 6d2d 6b64  shi -o 'realm-kd
│ │ │ │ +00012b20: 633d 4558 414d 504c 452e 4f52 472c 6c6f  c=EXAMPLE.ORG,lo
│ │ │ │ +00012b30: 6361 6c68 6f73 743a 3437 3131 2f74 6c73  calhost:4711/tls
│ │ │ │ +00012b40: 205c 0a20 2020 2020 2020 2020 7369 6d6f   \.         simo
│ │ │ │ +00012b50: 6e40 4558 414d 504c 452e 4f52 470a 2020  n@EXAMPLE.ORG.  
│ │ │ │ +00012b60: 2020 2045 6e74 6572 2070 6173 7377 6f72     Enter passwor
│ │ │ │ +00012b70: 6420 666f 7220 6073 696d 6f6e 4045 5841  d for `simon@EXA
│ │ │ │ +00012b80: 4d50 4c45 2e4f 5247 273a 0a20 2020 2020  MPLE.ORG':.     
│ │ │ │ +00012b90: 7369 6d6f 6e40 4558 414d 504c 452e 4f52  simon@EXAMPLE.OR
│ │ │ │ +00012ba0: 473a 0a20 2020 2020 4175 7468 7469 6d65  G:.     Authtime
│ │ │ │ +00012bb0: 3a20 2020 2020 2020 5475 6520 4465 6320  :       Tue Dec 
│ │ │ │ +00012bc0: 3136 2030 353a 3230 3a34 3720 3230 3033  16 05:20:47 2003
│ │ │ │ +00012bd0: 0a20 2020 2020 456e 6474 696d 653a 2020  .     Endtime:  
│ │ │ │ +00012be0: 2020 2020 2020 5475 6520 4465 6320 3136        Tue Dec 16
│ │ │ │ +00012bf0: 2030 353a 3337 3a32 3720 3230 3033 0a20   05:37:27 2003. 
│ │ │ │ +00012c00: 2020 2020 5365 7276 6572 3a20 2020 2020      Server:     
│ │ │ │ +00012c10: 2020 2020 6b72 6274 6774 2f45 5841 4d50      krbtgt/EXAMP
│ │ │ │ +00012c20: 4c45 2e4f 5247 206b 6579 2061 6573 3235  LE.ORG key aes25
│ │ │ │ +00012c30: 362d 6374 732d 686d 6163 2d73 6861 312d  6-cts-hmac-sha1-
│ │ │ │ +00012c40: 3936 2028 3138 290a 2020 2020 2054 6963  96 (18).     Tic
│ │ │ │ +00012c50: 6b65 7420 6b65 793a 2020 2020 2061 6573  ket key:     aes
│ │ │ │ +00012c60: 3235 362d 6374 732d 686d 6163 2d73 6861  256-cts-hmac-sha
│ │ │ │ +00012c70: 312d 3936 2028 3138 2920 7072 6f74 6563  1-96 (18) protec
│ │ │ │ +00012c80: 7465 6420 6279 2061 6573 3235 362d 6374  ted by aes256-ct
│ │ │ │ +00012c90: 732d 686d 6163 2d73 6861 312d 3936 2028  s-hmac-sha1-96 (
│ │ │ │ +00012ca0: 3138 290a 2020 2020 2054 6963 6b65 7420  18).     Ticket 
│ │ │ │ +00012cb0: 666c 6167 733a 2020 2046 4f52 5741 5244  flags:   FORWARD
│ │ │ │ +00012cc0: 4544 2050 524f 5849 4142 4c45 2028 3132  ED PROXIABLE (12
│ │ │ │ +00012cd0: 290a 2020 2020 206a 6173 406c 6174 7465  ).     jas@latte
│ │ │ │ +00012ce0: 3a7e 240a 0a20 2020 4f6e 2073 7563 6365  :~$..   On succe
│ │ │ │ +00012cf0: 7373 2c20 7468 6520 7365 7276 6572 2077  ss, the server w
│ │ │ │ +00012d00: 696c 6c20 7072 696e 7420 7468 6520 666f  ill print the fo
│ │ │ │ +00012d10: 6c6c 6f77 696e 6720 6465 6275 6720 696e  llowing debug in
│ │ │ │ +00012d20: 666f 726d 6174 696f 6e2e 0a0a 2020 2020  formation...    
│ │ │ │ +00012d30: 2073 6869 7368 6964 3a20 4163 6365 7074   shishid: Accept
│ │ │ │ +00012d40: 6564 2073 6f63 6b65 7420 3620 6672 6f6d  ed socket 6 from
│ │ │ │ +00012d50: 2073 6f63 6b65 7420 3420 6173 2049 5076   socket 4 as IPv
│ │ │ │ +00012d60: 343a 2a3a 3437 3131 2f74 6370 2070 6565  4:*:4711/tcp pee
│ │ │ │ +00012d70: 7220 3132 372e 302e 302e 310a 2020 2020  r 127.0.0.1.    
│ │ │ │ +00012d80: 2073 6869 7368 6964 3a20 4c69 7374 656e   shishid: Listen
│ │ │ │ +00012d90: 696e 6720 6f6e 2049 5076 343a 2a3a 3437  ing on IPv4:*:47
│ │ │ │ +00012da0: 3131 2f74 6370 2073 6f63 6b65 7420 340a  11/tcp socket 4.
│ │ │ │ +00012db0: 2020 2020 2073 6869 7368 6964 3a20 4c69       shishid: Li
│ │ │ │ +00012dc0: 7374 656e 696e 6720 6f6e 2049 5076 343a  stening on IPv4:
│ │ │ │ +00012dd0: 2a3a 3437 3131 2f74 6370 2070 6565 7220  *:4711/tcp peer 
│ │ │ │ +00012de0: 3132 372e 302e 302e 3120 736f 636b 6574  127.0.0.1 socket
│ │ │ │ +00012df0: 2036 0a20 2020 2020 7368 6973 6869 643a   6.     shishid:
│ │ │ │ +00012e00: 2048 6173 2034 2062 7974 6573 2066 726f   Has 4 bytes fro
│ │ │ │ +00012e10: 6d20 4950 7634 3a2a 3a34 3731 312f 7463  m IPv4:*:4711/tc
│ │ │ │ +00012e20: 7020 7065 6572 2031 3237 2e30 2e30 2e31  p peer 127.0.0.1
│ │ │ │ +00012e30: 206f 6e20 736f 636b 6574 2036 0a20 2020   on socket 6.   
│ │ │ │ +00012e40: 2020 7368 6973 6869 643a 2054 7279 696e    shishid: Tryin
│ │ │ │ +00012e50: 6720 5354 4152 5454 4c53 0a20 2020 2020  g STARTTLS.     
│ │ │ │ +00012e60: 7368 6973 6869 643a 2054 4c53 2068 616e  shishid: TLS han
│ │ │ │ +00012e70: 6473 6861 6b65 206e 6567 6f74 6961 7465  dshake negotiate
│ │ │ │ +00012e80: 6420 7072 6f74 6f63 6f6c 2060 544c 5320  d protocol `TLS 
│ │ │ │ +00012e90: 312e 3027 2c20 6b65 7920 6578 6368 616e  1.0', key exchan
│ │ │ │ +00012ea0: 6765 2060 416e 6f6e 2044 4827 2c20 6365  ge `Anon DH', ce
│ │ │ │ +00012eb0: 7274 6966 6963 6174 6520 7479 7065 2060  rtificate type `
│ │ │ │ +00012ec0: 582e 3530 3927 2c20 6369 7068 6572 2060  X.509', cipher `
│ │ │ │ +00012ed0: 4145 5320 3235 3620 4342 4327 2c20 6d61  AES 256 CBC', ma
│ │ │ │ +00012ee0: 6320 6053 4841 272c 2063 6f6d 7072 6573  c `SHA', compres
│ │ │ │ +00012ef0: 7369 6f6e 2060 4e55 4c4c 272c 2073 6573  sion `NULL', ses
│ │ │ │ +00012f00: 7369 6f6e 206e 6f74 2072 6573 756d 6564  sion not resumed
│ │ │ │ +00012f10: 0a20 2020 2020 7368 6973 6869 643a 2054  .     shishid: T
│ │ │ │ +00012f20: 4c53 2061 6e6f 6e79 6d6f 7573 2061 7574  LS anonymous aut
│ │ │ │ +00012f30: 6865 6e74 6963 6174 696f 6e20 7769 7468  hentication with
│ │ │ │ +00012f40: 2031 3032 3420 6269 7420 4469 6666 6965   1024 bit Diffie
│ │ │ │ +00012f50: 2d48 656c 6c6d 616e 0a20 2020 2020 7368  -Hellman.     sh
│ │ │ │ +00012f60: 6973 6869 643a 204c 6973 7465 6e69 6e67  ishid: Listening
│ │ │ │ +00012f70: 206f 6e20 4950 7634 3a2a 3a34 3731 312f   on IPv4:*:4711/
│ │ │ │ +00012f80: 7463 7020 736f 636b 6574 2034 0a20 2020  tcp socket 4.   
│ │ │ │ +00012f90: 2020 7368 6973 6869 643a 204c 6973 7465    shishid: Liste
│ │ │ │ +00012fa0: 6e69 6e67 206f 6e20 4950 7634 3a2a 3a34  ning on IPv4:*:4
│ │ │ │ +00012fb0: 3731 312f 7463 7020 7065 6572 2031 3237  711/tcp peer 127
│ │ │ │ +00012fc0: 2e30 2e30 2e31 2073 6f63 6b65 7420 360a  .0.0.1 socket 6.
│ │ │ │ +00012fd0: 2020 2020 2073 6869 7368 6964 3a20 4861       shishid: Ha
│ │ │ │ +00012fe0: 7320 3133 3120 6279 7465 7320 6672 6f6d  s 131 bytes from
│ │ │ │ +00012ff0: 2049 5076 343a 2a3a 3437 3131 2f74 6370   IPv4:*:4711/tcp
│ │ │ │ +00013000: 2070 6565 7220 3132 372e 302e 302e 3120   peer 127.0.0.1 
│ │ │ │ +00013010: 6f6e 2073 6f63 6b65 7420 360a 2020 2020  on socket 6.    
│ │ │ │ +00013020: 2073 6869 7368 6964 3a20 5072 6f63 6573   shishid: Proces
│ │ │ │ +00013030: 7369 6e67 2031 3331 2066 726f 6d20 4950  sing 131 from IP
│ │ │ │ +00013040: 7634 3a2a 3a34 3731 312f 7463 7020 7065  v4:*:4711/tcp pe
│ │ │ │ +00013050: 6572 2031 3237 2e30 2e30 2e31 206f 6e20  er 127.0.0.1 on 
│ │ │ │ +00013060: 736f 636b 6574 2036 0a20 2020 2020 7368  socket 6.     sh
│ │ │ │ +00013070: 6973 6869 643a 2054 7279 696e 6720 4153  ishid: Trying AS
│ │ │ │ +00013080: 2d52 4551 0a20 2020 2020 7368 6973 6869  -REQ.     shishi
│ │ │ │ +00013090: 643a 2041 532d 5245 5120 6672 6f6d 2073  d: AS-REQ from s
│ │ │ │ +000130a0: 696d 6f6e 4045 5841 4d50 4c45 2e4f 5247  imon@EXAMPLE.ORG
│ │ │ │ +000130b0: 2066 6f72 206b 7262 7467 742f 4558 414d   for krbtgt/EXAM
│ │ │ │ +000130c0: 504c 452e 4f52 4740 4558 414d 504c 452e  PLE.ORG@EXAMPLE.
│ │ │ │ +000130d0: 4f52 470a 2020 2020 2073 6869 7368 6964  ORG.     shishid
│ │ │ │ +000130e0: 3a20 4d61 7463 6869 6e67 2063 6c69 656e  : Matching clien
│ │ │ │ +000130f0: 7420 6574 7970 6520 3138 2061 6761 696e  t etype 18 again
│ │ │ │ +00013100: 7374 2075 7365 7220 6b65 7920 6574 7970  st user key etyp
│ │ │ │ +00013110: 6520 3138 0a20 2020 2020 7368 6973 6869  e 18.     shishi
│ │ │ │ +00013120: 643a 2048 6176 6520 3531 3120 6279 7465  d: Have 511 byte
│ │ │ │ +00013130: 7320 666f 7220 4950 7634 3a2a 3a34 3731  s for IPv4:*:471
│ │ │ │ +00013140: 312f 7463 7020 7065 6572 2031 3237 2e30  1/tcp peer 127.0
│ │ │ │ +00013150: 2e30 2e31 206f 6e20 736f 636b 6574 2036  .0.1 on socket 6
│ │ │ │ +00013160: 0a20 2020 2020 7368 6973 6869 643a 2053  .     shishid: S
│ │ │ │ +00013170: 656e 6469 6e67 2035 3131 2062 7974 6573  ending 511 bytes
│ │ │ │ +00013180: 2074 6f20 4950 7634 3a2a 3a34 3731 312f   to IPv4:*:4711/
│ │ │ │ +00013190: 7463 7020 7065 6572 2031 3237 2e30 2e30  tcp peer 127.0.0
│ │ │ │ +000131a0: 2e31 2073 6f63 6b65 7420 3620 7669 6120  .1 socket 6 via 
│ │ │ │ +000131b0: 544c 530a 2020 2020 2073 6869 7368 6964  TLS.     shishid
│ │ │ │ +000131c0: 3a20 4c69 7374 656e 696e 6720 6f6e 2049  : Listening on I
│ │ │ │ +000131d0: 5076 343a 2a3a 3437 3131 2f74 6370 2073  Pv4:*:4711/tcp s
│ │ │ │ +000131e0: 6f63 6b65 7420 340a 2020 2020 2073 6869  ocket 4.     shi
│ │ │ │ +000131f0: 7368 6964 3a20 4c69 7374 656e 696e 6720  shid: Listening 
│ │ │ │ +00013200: 6f6e 2049 5076 343a 2a3a 3437 3131 2f74  on IPv4:*:4711/t
│ │ │ │ +00013210: 6370 2070 6565 7220 3132 372e 302e 302e  cp peer 127.0.0.
│ │ │ │ +00013220: 3120 736f 636b 6574 2036 0a20 2020 2020  1 socket 6.     
│ │ │ │ +00013230: 7368 6973 6869 643a 2050 6565 7220 4950  shishid: Peer IP
│ │ │ │ +00013240: 7634 3a2a 3a34 3731 312f 7463 7020 7065  v4:*:4711/tcp pe
│ │ │ │ +00013250: 6572 2031 3237 2e30 2e30 2e31 2064 6973  er 127.0.0.1 dis
│ │ │ │ +00013260: 636f 6e6e 6563 7465 6420 6f6e 2073 6f63  connected on soc
│ │ │ │ +00013270: 6b65 7420 360a 2020 2020 2073 6869 7368  ket 6.     shish
│ │ │ │ +00013280: 6964 3a20 436c 6f73 696e 6720 4950 7634  id: Closing IPv4
│ │ │ │ +00013290: 3a2a 3a34 3731 312f 7463 7020 7065 6572  :*:4711/tcp peer
│ │ │ │ +000132a0: 2031 3237 2e30 2e30 2e31 2073 6f63 6b65   127.0.0.1 socke
│ │ │ │ +000132b0: 7420 360a 2020 2020 2073 6869 7368 6964  t 6.     shishid
│ │ │ │ +000132c0: 3a20 4c69 7374 656e 696e 6720 6f6e 2049  : Listening on I
│ │ │ │ +000132d0: 5076 343a 2a3a 3437 3131 2f74 6370 2073  Pv4:*:4711/tcp s
│ │ │ │ +000132e0: 6f63 6b65 7420 340a 0a33 2e36 2e33 2053  ocket 4..3.6.3 S
│ │ │ │ +000132f0: 6574 7469 6e67 2075 7020 582e 3530 3920  etting up X.509 
│ │ │ │ +00013300: 6175 7468 656e 7469 6361 7465 6420 544c  authenticated TL
│ │ │ │ +00013310: 530a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  S.--------------
│ │ │ │  00013320: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00013330: 2d2d 2d2d 2d2d 2d2d 0a0a 5365 7474 696e  --------..Settin
│ │ │ │ -00013340: 6720 7570 2058 2e35 3039 2061 7574 6865  g up X.509 authe
│ │ │ │ -00013350: 6e74 6963 6174 696f 6e20 6973 2073 6c69  ntication is sli
│ │ │ │ -00013360: 6768 746c 7920 6d6f 7265 2063 6f6d 706c  ghtly more compl
│ │ │ │ -00013370: 6963 6174 6564 2074 6861 6e0a 616e 6f6e  icated than.anon
│ │ │ │ -00013380: 796d 6f75 7320 6175 7468 656e 7469 6361  ymous authentica
│ │ │ │ -00013390: 7469 6f6e 2e20 2059 6f75 206e 6565 6420  tion.  You need 
│ │ │ │ -000133a0: 6120 582e 3530 3920 6365 7274 6966 6963  a X.509 certific
│ │ │ │ -000133b0: 6174 6520 6175 7468 6f72 6974 7920 2843  ate authority (C
│ │ │ │ -000133c0: 4129 0a74 6861 7420 6361 6e20 6765 6e65  A).that can gene
│ │ │ │ -000133d0: 7261 7465 2063 6572 7469 6669 6361 7465  rate certificate
│ │ │ │ -000133e0: 7320 666f 7220 796f 7572 204b 6572 6265  s for your Kerbe
│ │ │ │ -000133f0: 726f 7320 7365 7276 6572 2061 6e64 204b  ros server and K
│ │ │ │ -00013400: 6572 6265 726f 730a 636c 6965 6e74 732e  erberos.clients.
│ │ │ │ -00013410: 2020 4974 2069 7320 6f66 7465 6e20 6561    It is often ea
│ │ │ │ -00013420: 7369 6573 7420 746f 2073 6574 7570 2074  siest to setup t
│ │ │ │ -00013430: 6865 2043 4120 796f 7572 7365 6c66 2e20  he CA yourself. 
│ │ │ │ -00013440: 204d 616e 6167 696e 6720 6120 4341 0a63   Managing a CA.c
│ │ │ │ -00013450: 616e 2062 6520 6120 6461 756e 7469 6e67  an be a daunting
│ │ │ │ -00013460: 2074 6173 6b2c 2061 6e64 2077 6520 6f6e   task, and we on
│ │ │ │ -00013470: 6c79 2067 6976 6520 7468 6520 6261 7265  ly give the bare
│ │ │ │ -00013480: 2065 7373 656e 7469 616c 7320 746f 2067   essentials to g
│ │ │ │ -00013490: 6574 0a74 6869 6e67 7320 7570 2061 6e64  et.things up and
│ │ │ │ -000134a0: 2072 756e 6e69 6e67 2e20 2057 6520 7375   running.  We su
│ │ │ │ -000134b0: 6767 6573 7420 7468 6174 2079 6f75 2073  ggest that you s
│ │ │ │ -000134c0: 7475 6479 2074 6865 2072 656c 6576 616e  tudy the relevan
│ │ │ │ -000134d0: 740a 6c69 7465 7261 7475 7265 2e20 2041  t.literature.  A
│ │ │ │ -000134e0: 7320 6120 6669 7273 7420 7374 6570 2062  s a first step b
│ │ │ │ -000134f0: 6579 6f6e 6420 7468 6973 2069 6e74 726f  eyond this intro
│ │ │ │ -00013500: 6475 6374 696f 6e2c 2079 6f75 206d 6179  duction, you may
│ │ │ │ -00013510: 2077 6973 6820 746f 0a65 7870 6c6f 7265   wish to.explore
│ │ │ │ -00013520: 206d 6f72 6520 7365 6375 7265 2066 6f72   more secure for
│ │ │ │ -00013530: 6d73 206f 6620 6b65 7920 7374 6f72 6167  ms of key storag
│ │ │ │ -00013540: 6520 7468 616e 2073 746f 7269 6e67 2074  e than storing t
│ │ │ │ -00013550: 6865 6d20 756e 656e 6372 7970 7465 640a  hem unencrypted.
│ │ │ │ -00013560: 6f6e 2064 6973 6b2e 0a0a 2020 2054 6865  on disk...   The
│ │ │ │ -00013570: 2066 6f6c 6c6f 7769 6e67 2074 6872 6565   following three
│ │ │ │ -00013580: 2073 6563 7469 6f6e 7320 6465 7363 7269   sections descri
│ │ │ │ -00013590: 6265 2068 6f77 2079 6f75 2063 7265 6174  be how you creat
│ │ │ │ -000135a0: 6520 7468 6520 4341 2c20 4b44 430a 6365  e the CA, KDC.ce
│ │ │ │ -000135b0: 7274 6966 6963 6174 652c 2061 6e64 2063  rtificate, and c
│ │ │ │ -000135c0: 6c69 656e 7420 6365 7274 6966 6963 6174  lient certificat
│ │ │ │ -000135d0: 6573 2e20 2059 6f75 2063 616e 2075 7365  es.  You can use
│ │ │ │ -000135e0: 2061 6e79 2074 6f6f 6c20 796f 7520 6c69   any tool you li
│ │ │ │ -000135f0: 6b65 2066 6f72 0a74 6869 7320 7461 736b  ke for.this task
│ │ │ │ -00013600: 2c20 6173 206c 6f6e 6720 6173 2074 6865  , as long as the
│ │ │ │ -00013610: 7920 6765 6e65 7261 7465 2058 2e35 3039  y generate X.509
│ │ │ │ -00013620: 2028 504b 4958 2920 6365 7274 6966 6963   (PKIX) certific
│ │ │ │ -00013630: 6174 6573 2069 6e20 5045 4d0a 666f 726d  ates in PEM.form
│ │ │ │ -00013640: 6174 2061 6e64 2052 5341 206b 6579 7320  at and RSA keys 
│ │ │ │ -00013650: 696e 2050 4b43 5323 3120 666f 726d 6174  in PKCS#1 format
│ │ │ │ -00013660: 2e20 2048 6572 6520 7765 2075 7365 20e2  .  Here we use .
│ │ │ │ -00013670: 8098 6365 7274 746f 6f6c e280 9920 7468  ..certtool... th
│ │ │ │ -00013680: 6174 2063 6f6d 650a 7769 7468 2047 4e55  at come.with GNU
│ │ │ │ -00013690: 544c 532c 2077 6869 6368 2069 7320 7769  TLS, which is wi
│ │ │ │ -000136a0: 6465 6c79 2061 7661 696c 6162 6c65 2e20  dely available. 
│ │ │ │ -000136b0: 2057 6520 636f 6e63 6c75 6465 2062 7920   We conclude by 
│ │ │ │ -000136c0: 6469 7363 7573 7369 6e67 2068 6f77 0a79  discussing how.y
│ │ │ │ -000136d0: 6f75 2075 7365 2074 6865 7365 2063 6572  ou use these cer
│ │ │ │ -000136e0: 7469 6669 6361 7465 7320 696e 2074 6865  tificates in the
│ │ │ │ -000136f0: 204b 4443 2061 6e64 2069 6e20 7468 6520   KDC and in the 
│ │ │ │ -00013700: 5368 6973 6869 2063 6c69 656e 742e 0a0a  Shishi client...
│ │ │ │ -00013710: 332e 362e 332e 3120 4372 6561 7465 2061  3.6.3.1 Create a
│ │ │ │ -00013720: 204b 6572 6265 726f 7320 4365 7274 6966   Kerberos Certif
│ │ │ │ -00013730: 6963 6174 6520 4175 7468 6f72 6974 790a  icate Authority.
│ │ │ │ -00013740: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e  ................
│ │ │ │ +00013330: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 5365 7474  ----------..Sett
│ │ │ │ +00013340: 696e 6720 7570 2058 2e35 3039 2061 7574  ing up X.509 aut
│ │ │ │ +00013350: 6865 6e74 6963 6174 696f 6e20 6973 2073  hentication is s
│ │ │ │ +00013360: 6c69 6768 746c 7920 6d6f 7265 2063 6f6d  lightly more com
│ │ │ │ +00013370: 706c 6963 6174 6564 2074 6861 6e0a 616e  plicated than.an
│ │ │ │ +00013380: 6f6e 796d 6f75 7320 6175 7468 656e 7469  onymous authenti
│ │ │ │ +00013390: 6361 7469 6f6e 2e20 2059 6f75 206e 6565  cation.  You nee
│ │ │ │ +000133a0: 6420 6120 582e 3530 3920 6365 7274 6966  d a X.509 certif
│ │ │ │ +000133b0: 6963 6174 6520 6175 7468 6f72 6974 7920  icate authority 
│ │ │ │ +000133c0: 2843 4129 0a74 6861 7420 6361 6e20 6765  (CA).that can ge
│ │ │ │ +000133d0: 6e65 7261 7465 2063 6572 7469 6669 6361  nerate certifica
│ │ │ │ +000133e0: 7465 7320 666f 7220 796f 7572 204b 6572  tes for your Ker
│ │ │ │ +000133f0: 6265 726f 7320 7365 7276 6572 2061 6e64  beros server and
│ │ │ │ +00013400: 204b 6572 6265 726f 730a 636c 6965 6e74   Kerberos.client
│ │ │ │ +00013410: 732e 2020 4974 2069 7320 6f66 7465 6e20  s.  It is often 
│ │ │ │ +00013420: 6561 7369 6573 7420 746f 2073 6574 7570  easiest to setup
│ │ │ │ +00013430: 2074 6865 2043 4120 796f 7572 7365 6c66   the CA yourself
│ │ │ │ +00013440: 2e20 204d 616e 6167 696e 6720 6120 4341  .  Managing a CA
│ │ │ │ +00013450: 0a63 616e 2062 6520 6120 6461 756e 7469  .can be a daunti
│ │ │ │ +00013460: 6e67 2074 6173 6b2c 2061 6e64 2077 6520  ng task, and we 
│ │ │ │ +00013470: 6f6e 6c79 2067 6976 6520 7468 6520 6261  only give the ba
│ │ │ │ +00013480: 7265 2065 7373 656e 7469 616c 7320 746f  re essentials to
│ │ │ │ +00013490: 2067 6574 0a74 6869 6e67 7320 7570 2061   get.things up a
│ │ │ │ +000134a0: 6e64 2072 756e 6e69 6e67 2e20 2057 6520  nd running.  We 
│ │ │ │ +000134b0: 7375 6767 6573 7420 7468 6174 2079 6f75  suggest that you
│ │ │ │ +000134c0: 2073 7475 6479 2074 6865 2072 656c 6576   study the relev
│ │ │ │ +000134d0: 616e 740a 6c69 7465 7261 7475 7265 2e20  ant.literature. 
│ │ │ │ +000134e0: 2041 7320 6120 6669 7273 7420 7374 6570   As a first step
│ │ │ │ +000134f0: 2062 6579 6f6e 6420 7468 6973 2069 6e74   beyond this int
│ │ │ │ +00013500: 726f 6475 6374 696f 6e2c 2079 6f75 206d  roduction, you m
│ │ │ │ +00013510: 6179 2077 6973 6820 746f 0a65 7870 6c6f  ay wish to.explo
│ │ │ │ +00013520: 7265 206d 6f72 6520 7365 6375 7265 2066  re more secure f
│ │ │ │ +00013530: 6f72 6d73 206f 6620 6b65 7920 7374 6f72  orms of key stor
│ │ │ │ +00013540: 6167 6520 7468 616e 2073 746f 7269 6e67  age than storing
│ │ │ │ +00013550: 2074 6865 6d20 756e 656e 6372 7970 7465   them unencrypte
│ │ │ │ +00013560: 640a 6f6e 2064 6973 6b2e 0a0a 2020 2054  d.on disk...   T
│ │ │ │ +00013570: 6865 2066 6f6c 6c6f 7769 6e67 2074 6872  he following thr
│ │ │ │ +00013580: 6565 2073 6563 7469 6f6e 7320 6465 7363  ee sections desc
│ │ │ │ +00013590: 7269 6265 2068 6f77 2079 6f75 2063 7265  ribe how you cre
│ │ │ │ +000135a0: 6174 6520 7468 6520 4341 2c20 4b44 430a  ate the CA, KDC.
│ │ │ │ +000135b0: 6365 7274 6966 6963 6174 652c 2061 6e64  certificate, and
│ │ │ │ +000135c0: 2063 6c69 656e 7420 6365 7274 6966 6963   client certific
│ │ │ │ +000135d0: 6174 6573 2e20 2059 6f75 2063 616e 2075  ates.  You can u
│ │ │ │ +000135e0: 7365 2061 6e79 2074 6f6f 6c20 796f 7520  se any tool you 
│ │ │ │ +000135f0: 6c69 6b65 2066 6f72 0a74 6869 7320 7461  like for.this ta
│ │ │ │ +00013600: 736b 2c20 6173 206c 6f6e 6720 6173 2074  sk, as long as t
│ │ │ │ +00013610: 6865 7920 6765 6e65 7261 7465 2058 2e35  hey generate X.5
│ │ │ │ +00013620: 3039 2028 504b 4958 2920 6365 7274 6966  09 (PKIX) certif
│ │ │ │ +00013630: 6963 6174 6573 2069 6e20 5045 4d0a 666f  icates in PEM.fo
│ │ │ │ +00013640: 726d 6174 2061 6e64 2052 5341 206b 6579  rmat and RSA key
│ │ │ │ +00013650: 7320 696e 2050 4b43 5323 3120 666f 726d  s in PKCS#1 form
│ │ │ │ +00013660: 6174 2e20 2048 6572 6520 7765 2075 7365  at.  Here we use
│ │ │ │ +00013670: 20e2 8098 6365 7274 746f 6f6c e280 9920   ...certtool... 
│ │ │ │ +00013680: 7468 6174 2063 6f6d 650a 7769 7468 2047  that come.with G
│ │ │ │ +00013690: 4e55 544c 532c 2077 6869 6368 2069 7320  NUTLS, which is 
│ │ │ │ +000136a0: 7769 6465 6c79 2061 7661 696c 6162 6c65  widely available
│ │ │ │ +000136b0: 2e20 2057 6520 636f 6e63 6c75 6465 2062  .  We conclude b
│ │ │ │ +000136c0: 7920 6469 7363 7573 7369 6e67 2068 6f77  y discussing how
│ │ │ │ +000136d0: 0a79 6f75 2075 7365 2074 6865 7365 2063  .you use these c
│ │ │ │ +000136e0: 6572 7469 6669 6361 7465 7320 696e 2074  ertificates in t
│ │ │ │ +000136f0: 6865 204b 4443 2061 6e64 2069 6e20 7468  he KDC and in th
│ │ │ │ +00013700: 6520 5368 6973 6869 2063 6c69 656e 742e  e Shishi client.
│ │ │ │ +00013710: 0a0a 332e 362e 332e 3120 4372 6561 7465  ..3.6.3.1 Create
│ │ │ │ +00013720: 2061 204b 6572 6265 726f 7320 4365 7274   a Kerberos Cert
│ │ │ │ +00013730: 6966 6963 6174 6520 4175 7468 6f72 6974  ificate Authorit
│ │ │ │ +00013740: 790a 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e  y...............
│ │ │ │  00013750: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e  ................
│ │ │ │ -00013760: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e0a  ................
│ │ │ │ -00013770: 0a46 6972 7374 2063 7265 6174 6520 6120  .First create a 
│ │ │ │ -00013780: 4341 206b 6579 2e0a 0a20 2020 2020 6a61  CA key...     ja
│ │ │ │ -00013790: 7340 6c61 7474 653a 7e24 2063 6572 7474  s@latte:~$ certt
│ │ │ │ -000137a0: 6f6f 6c20 2d2d 6765 6e65 7261 7465 2d70  ool --generate-p
│ │ │ │ -000137b0: 7269 766b 6579 205c 0a20 2020 2020 2020  rivkey \.       
│ │ │ │ -000137c0: 202d 2d6f 7574 6669 6c65 202f 7573 722f   --outfile /usr/
│ │ │ │ -000137d0: 6c6f 6361 6c2f 6574 632f 7368 6973 6869  local/etc/shishi
│ │ │ │ -000137e0: 2f73 6869 7368 692e 6b65 790a 2020 2020  /shishi.key.    
│ │ │ │ -000137f0: 2047 656e 6572 6174 696e 6720 6120 7072   Generating a pr
│ │ │ │ -00013800: 6976 6174 6520 6b65 792e 2e2e 0a20 2020  ivate key....   
│ │ │ │ -00013810: 2020 4765 6e65 7261 7469 6e67 2061 2031    Generating a 1
│ │ │ │ -00013820: 3032 3420 6269 7420 5253 4120 7072 6976  024 bit RSA priv
│ │ │ │ -00013830: 6174 6520 6b65 792e 2e2e 0a20 2020 2020  ate key....     
│ │ │ │ -00013840: 6a61 7340 6c61 7474 653a 7e24 0a0a 2020  jas@latte:~$..  
│ │ │ │ -00013850: 2054 6865 6e20 6372 6561 7465 2074 6865   Then create the
│ │ │ │ -00013860: 2043 4120 6365 7274 6966 6963 6174 652e   CA certificate.
│ │ │ │ -00013870: 2020 5573 6520 7768 6174 6576 6572 2064    Use whatever d
│ │ │ │ -00013880: 6574 6169 6c73 2079 6f75 2070 7265 6665  etails you prefe
│ │ │ │ -00013890: 722e 0a0a 2020 2020 206a 6173 406c 6174  r...     jas@lat
│ │ │ │ -000138a0: 7465 3a7e 2420 6365 7274 746f 6f6c 202d  te:~$ certtool -
│ │ │ │ -000138b0: 2d67 656e 6572 6174 652d 7365 6c66 2d73  -generate-self-s
│ │ │ │ -000138c0: 6967 6e65 6420 5c0a 2020 2020 2020 2020  igned \.        
│ │ │ │ -000138d0: 2d2d 6c6f 6164 2d70 7269 766b 6579 202f  --load-privkey /
│ │ │ │ -000138e0: 7573 722f 6c6f 6361 6c2f 6574 632f 7368  usr/local/etc/sh
│ │ │ │ -000138f0: 6973 6869 2f73 6869 7368 692e 6b65 7920  ishi/shishi.key 
│ │ │ │ -00013900: 5c0a 2020 2020 2020 2020 2d2d 6f75 7466  \.        --outf
│ │ │ │ -00013910: 696c 6520 2f75 7372 2f6c 6f63 616c 2f65  ile /usr/local/e
│ │ │ │ -00013920: 7463 2f73 6869 7368 692f 7368 6973 6869  tc/shishi/shishi
│ │ │ │ -00013930: 2e63 6572 740a 2020 2020 2047 656e 6572  .cert.     Gener
│ │ │ │ -00013940: 6174 696e 6720 6120 7365 6c66 2073 6967  ating a self sig
│ │ │ │ -00013950: 6e65 6420 6365 7274 6966 6963 6174 652e  ned certificate.
│ │ │ │ -00013960: 2e2e 0a20 2020 2020 506c 6561 7365 2065  ...     Please e
│ │ │ │ -00013970: 6e74 6572 2074 6865 2064 6574 6169 6c73  nter the details
│ │ │ │ -00013980: 206f 6620 7468 6520 6365 7274 6966 6963   of the certific
│ │ │ │ -00013990: 6174 6527 7320 6469 7374 696e 6775 6973  ate's distinguis
│ │ │ │ -000139a0: 6865 6420 6e61 6d65 2e20 5c0a 2020 2020  hed name. \.    
│ │ │ │ -000139b0: 204a 7573 7420 7072 6573 7320 656e 7465   Just press ente
│ │ │ │ -000139c0: 7220 746f 2069 676e 6f72 6520 6120 6669  r to ignore a fi
│ │ │ │ -000139d0: 656c 642e 0a20 2020 2020 436f 756e 7472  eld..     Countr
│ │ │ │ -000139e0: 7920 6e61 6d65 2028 3220 6368 6172 7329  y name (2 chars)
│ │ │ │ -000139f0: 3a20 5345 0a20 2020 2020 4f72 6761 6e69  : SE.     Organi
│ │ │ │ -00013a00: 7a61 7469 6f6e 206e 616d 653a 2053 6869  zation name: Shi
│ │ │ │ -00013a10: 7368 6920 4578 616d 706c 6520 4341 0a20  shi Example CA. 
│ │ │ │ -00013a20: 2020 2020 4f72 6761 6e69 7a61 7469 6f6e      Organization
│ │ │ │ -00013a30: 616c 2075 6e69 7420 6e61 6d65 3a0a 2020  al unit name:.  
│ │ │ │ -00013a40: 2020 204c 6f63 616c 6974 7920 6e61 6d65     Locality name
│ │ │ │ -00013a50: 3a0a 2020 2020 2053 7461 7465 206f 7220  :.     State or 
│ │ │ │ -00013a60: 7072 6f76 696e 6365 206e 616d 653a 0a20  province name:. 
│ │ │ │ -00013a70: 2020 2020 436f 6d6d 6f6e 206e 616d 653a      Common name:
│ │ │ │ -00013a80: 2043 410a 2020 2020 2054 6869 7320 6669   CA.     This fi
│ │ │ │ -00013a90: 656c 6420 7368 6f75 6c64 206e 6f74 2062  eld should not b
│ │ │ │ -00013aa0: 6520 7573 6564 2069 6e20 6e65 7720 6365  e used in new ce
│ │ │ │ -00013ab0: 7274 6966 6963 6174 6573 2e0a 2020 2020  rtificates..    
│ │ │ │ -00013ac0: 2045 2d6d 6169 6c3a 0a20 2020 2020 456e   E-mail:.     En
│ │ │ │ -00013ad0: 7465 7220 7468 6520 6365 7274 6966 6963  ter the certific
│ │ │ │ -00013ae0: 6174 6527 7320 7365 7269 616c 206e 756d  ate's serial num
│ │ │ │ -00013af0: 6265 7220 2864 6563 696d 616c 293a 2030  ber (decimal): 0
│ │ │ │ -00013b00: 0a20 2020 2020 4163 7469 7661 7469 6f6e  .     Activation
│ │ │ │ -00013b10: 2f45 7870 6972 6174 696f 6e20 7469 6d65  /Expiration time
│ │ │ │ -00013b20: 2e0a 2020 2020 2054 6865 2067 656e 6572  ..     The gener
│ │ │ │ -00013b30: 6174 6564 2063 6572 7469 6669 6361 7465  ated certificate
│ │ │ │ -00013b40: 2077 696c 6c20 6578 7069 7265 2069 6e20   will expire in 
│ │ │ │ -00013b50: 2864 6179 7329 3a20 3138 300a 2020 2020  (days): 180.    
│ │ │ │ -00013b60: 2045 7874 656e 7369 6f6e 732e 0a20 2020   Extensions..   
│ │ │ │ -00013b70: 2020 446f 6573 2074 6865 2063 6572 7469    Does the certi
│ │ │ │ -00013b80: 6669 6361 7465 2062 656c 6f6e 6720 746f  ficate belong to
│ │ │ │ -00013b90: 2061 6e20 6175 7468 6f72 6974 793f 2028   an authority? (
│ │ │ │ -00013ba0: 592f 4e29 3a20 790a 2020 2020 2049 7320  Y/N): y.     Is 
│ │ │ │ -00013bb0: 7468 6973 2061 2077 6562 2073 6572 7665  this a web serve
│ │ │ │ -00013bc0: 7220 6365 7274 6966 6963 6174 653f 2028  r certificate? (
│ │ │ │ -00013bd0: 592f 4e29 3a20 6e0a 2020 2020 2045 6e74  Y/N): n.     Ent
│ │ │ │ -00013be0: 6572 2074 6865 2065 2d6d 6169 6c20 6f66  er the e-mail of
│ │ │ │ -00013bf0: 2074 6865 2073 7562 6a65 6374 206f 6620   the subject of 
│ │ │ │ -00013c00: 7468 6520 6365 7274 6966 6963 6174 653a  the certificate:
│ │ │ │ -00013c10: 0a20 2020 2020 582e 3530 3920 6365 7274  .     X.509 cert
│ │ │ │ -00013c20: 6966 6963 6174 6520 696e 666f 3a0a 2020  ificate info:.  
│ │ │ │ -00013c30: 2020 2056 6572 7369 6f6e 3a20 330a 2020     Version: 3.  
│ │ │ │ -00013c40: 2020 2053 6572 6961 6c20 4e75 6d62 6572     Serial Number
│ │ │ │ -00013c50: 2028 6865 7829 3a20 3030 0a20 2020 2020   (hex): 00.     
│ │ │ │ -00013c60: 5661 6c69 6469 7479 3a0a 2020 2020 2020  Validity:.      
│ │ │ │ -00013c70: 2020 2020 2020 204e 6f74 2042 6566 6f72         Not Befor
│ │ │ │ -00013c80: 653a 2053 756e 2044 6563 2032 3120 3130  e: Sun Dec 21 10
│ │ │ │ -00013c90: 3a35 393a 3030 2032 3030 330a 2020 2020  :59:00 2003.    
│ │ │ │ -00013ca0: 2020 2020 2020 2020 204e 6f74 2041 6674           Not Aft
│ │ │ │ -00013cb0: 6572 3a20 4672 6920 4a75 6e20 3138 2031  er: Fri Jun 18 1
│ │ │ │ -00013cc0: 313a 3539 3a30 3020 3230 3034 0a20 2020  1:59:00 2004.   
│ │ │ │ -00013cd0: 2020 5375 626a 6563 743a 2043 3d53 452c    Subject: C=SE,
│ │ │ │ -00013ce0: 4f3d 5368 6973 6869 2045 7861 6d70 6c65  O=Shishi Example
│ │ │ │ -00013cf0: 2043 412c 434e 3d43 410a 2020 2020 2053   CA,CN=CA.     S
│ │ │ │ -00013d00: 7562 6a65 6374 2050 7562 6c69 6320 4b65  ubject Public Ke
│ │ │ │ -00013d10: 7920 496e 666f 3a0a 2020 2020 2020 2020  y Info:.        
│ │ │ │ -00013d20: 2020 2020 2050 7562 6c69 6320 4b65 7920       Public Key 
│ │ │ │ -00013d30: 416c 676f 7269 7468 6d3a 2052 5341 0a20  Algorithm: RSA. 
│ │ │ │ -00013d40: 2020 2020 582e 3530 3920 4578 7465 6e73      X.509 Extens
│ │ │ │ -00013d50: 696f 6e73 3a0a 2020 2020 2020 2020 2020  ions:.          
│ │ │ │ -00013d60: 2020 2042 6173 6963 2043 6f6e 7374 7261     Basic Constra
│ │ │ │ -00013d70: 696e 7473 3a20 2863 7269 7469 6361 6c29  ints: (critical)
│ │ │ │ -00013d80: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ -00013d90: 2020 2020 2020 4341 3a54 5255 450a 2020        CA:TRUE.  
│ │ │ │ -00013da0: 2020 2049 7320 7468 6520 6162 6f76 6520     Is the above 
│ │ │ │ -00013db0: 696e 666f 726d 6174 696f 6e20 6f6b 3f20  information ok? 
│ │ │ │ -00013dc0: 2859 2f4e 293a 2079 0a20 2020 2020 5369  (Y/N): y.     Si
│ │ │ │ -00013dd0: 676e 696e 6720 6365 7274 6966 6963 6174  gning certificat
│ │ │ │ -00013de0: 652e 2e2e 0a20 2020 2020 6a61 7340 6c61  e....     jas@la
│ │ │ │ -00013df0: 7474 653a 7e24 0a0a 332e 362e 332e 3220  tte:~$..3.6.3.2 
│ │ │ │ -00013e00: 4372 6561 7465 2061 204b 6572 6265 726f  Create a Kerbero
│ │ │ │ -00013e10: 7320 4b44 4320 4365 7274 6966 6963 6174  s KDC Certificat
│ │ │ │ -00013e20: 650a 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e  e...............
│ │ │ │ +00013760: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e  ................
│ │ │ │ +00013770: 2e0a 0a46 6972 7374 2063 7265 6174 6520  ...First create 
│ │ │ │ +00013780: 6120 4341 206b 6579 2e0a 0a20 2020 2020  a CA key...     
│ │ │ │ +00013790: 6a61 7340 6c61 7474 653a 7e24 2063 6572  jas@latte:~$ cer
│ │ │ │ +000137a0: 7474 6f6f 6c20 2d2d 6765 6e65 7261 7465  ttool --generate
│ │ │ │ +000137b0: 2d70 7269 766b 6579 205c 0a20 2020 2020  -privkey \.     
│ │ │ │ +000137c0: 2020 202d 2d6f 7574 6669 6c65 202f 7573     --outfile /us
│ │ │ │ +000137d0: 722f 6c6f 6361 6c2f 6574 632f 7368 6973  r/local/etc/shis
│ │ │ │ +000137e0: 6869 2f73 6869 7368 692e 6b65 790a 2020  hi/shishi.key.  
│ │ │ │ +000137f0: 2020 2047 656e 6572 6174 696e 6720 6120     Generating a 
│ │ │ │ +00013800: 7072 6976 6174 6520 6b65 792e 2e2e 0a20  private key.... 
│ │ │ │ +00013810: 2020 2020 4765 6e65 7261 7469 6e67 2061      Generating a
│ │ │ │ +00013820: 2031 3032 3420 6269 7420 5253 4120 7072   1024 bit RSA pr
│ │ │ │ +00013830: 6976 6174 6520 6b65 792e 2e2e 0a20 2020  ivate key....   
│ │ │ │ +00013840: 2020 6a61 7340 6c61 7474 653a 7e24 0a0a    jas@latte:~$..
│ │ │ │ +00013850: 2020 2054 6865 6e20 6372 6561 7465 2074     Then create t
│ │ │ │ +00013860: 6865 2043 4120 6365 7274 6966 6963 6174  he CA certificat
│ │ │ │ +00013870: 652e 2020 5573 6520 7768 6174 6576 6572  e.  Use whatever
│ │ │ │ +00013880: 2064 6574 6169 6c73 2079 6f75 2070 7265   details you pre
│ │ │ │ +00013890: 6665 722e 0a0a 2020 2020 206a 6173 406c  fer...     jas@l
│ │ │ │ +000138a0: 6174 7465 3a7e 2420 6365 7274 746f 6f6c  atte:~$ certtool
│ │ │ │ +000138b0: 202d 2d67 656e 6572 6174 652d 7365 6c66   --generate-self
│ │ │ │ +000138c0: 2d73 6967 6e65 6420 5c0a 2020 2020 2020  -signed \.      
│ │ │ │ +000138d0: 2020 2d2d 6c6f 6164 2d70 7269 766b 6579    --load-privkey
│ │ │ │ +000138e0: 202f 7573 722f 6c6f 6361 6c2f 6574 632f   /usr/local/etc/
│ │ │ │ +000138f0: 7368 6973 6869 2f73 6869 7368 692e 6b65  shishi/shishi.ke
│ │ │ │ +00013900: 7920 5c0a 2020 2020 2020 2020 2d2d 6f75  y \.        --ou
│ │ │ │ +00013910: 7466 696c 6520 2f75 7372 2f6c 6f63 616c  tfile /usr/local
│ │ │ │ +00013920: 2f65 7463 2f73 6869 7368 692f 7368 6973  /etc/shishi/shis
│ │ │ │ +00013930: 6869 2e63 6572 740a 2020 2020 2047 656e  hi.cert.     Gen
│ │ │ │ +00013940: 6572 6174 696e 6720 6120 7365 6c66 2073  erating a self s
│ │ │ │ +00013950: 6967 6e65 6420 6365 7274 6966 6963 6174  igned certificat
│ │ │ │ +00013960: 652e 2e2e 0a20 2020 2020 506c 6561 7365  e....     Please
│ │ │ │ +00013970: 2065 6e74 6572 2074 6865 2064 6574 6169   enter the detai
│ │ │ │ +00013980: 6c73 206f 6620 7468 6520 6365 7274 6966  ls of the certif
│ │ │ │ +00013990: 6963 6174 6527 7320 6469 7374 696e 6775  icate's distingu
│ │ │ │ +000139a0: 6973 6865 6420 6e61 6d65 2e20 5c0a 2020  ished name. \.  
│ │ │ │ +000139b0: 2020 204a 7573 7420 7072 6573 7320 656e     Just press en
│ │ │ │ +000139c0: 7465 7220 746f 2069 676e 6f72 6520 6120  ter to ignore a 
│ │ │ │ +000139d0: 6669 656c 642e 0a20 2020 2020 436f 756e  field..     Coun
│ │ │ │ +000139e0: 7472 7920 6e61 6d65 2028 3220 6368 6172  try name (2 char
│ │ │ │ +000139f0: 7329 3a20 5345 0a20 2020 2020 4f72 6761  s): SE.     Orga
│ │ │ │ +00013a00: 6e69 7a61 7469 6f6e 206e 616d 653a 2053  nization name: S
│ │ │ │ +00013a10: 6869 7368 6920 4578 616d 706c 6520 4341  hishi Example CA
│ │ │ │ +00013a20: 0a20 2020 2020 4f72 6761 6e69 7a61 7469  .     Organizati
│ │ │ │ +00013a30: 6f6e 616c 2075 6e69 7420 6e61 6d65 3a0a  onal unit name:.
│ │ │ │ +00013a40: 2020 2020 204c 6f63 616c 6974 7920 6e61       Locality na
│ │ │ │ +00013a50: 6d65 3a0a 2020 2020 2053 7461 7465 206f  me:.     State o
│ │ │ │ +00013a60: 7220 7072 6f76 696e 6365 206e 616d 653a  r province name:
│ │ │ │ +00013a70: 0a20 2020 2020 436f 6d6d 6f6e 206e 616d  .     Common nam
│ │ │ │ +00013a80: 653a 2043 410a 2020 2020 2054 6869 7320  e: CA.     This 
│ │ │ │ +00013a90: 6669 656c 6420 7368 6f75 6c64 206e 6f74  field should not
│ │ │ │ +00013aa0: 2062 6520 7573 6564 2069 6e20 6e65 7720   be used in new 
│ │ │ │ +00013ab0: 6365 7274 6966 6963 6174 6573 2e0a 2020  certificates..  
│ │ │ │ +00013ac0: 2020 2045 2d6d 6169 6c3a 0a20 2020 2020     E-mail:.     
│ │ │ │ +00013ad0: 456e 7465 7220 7468 6520 6365 7274 6966  Enter the certif
│ │ │ │ +00013ae0: 6963 6174 6527 7320 7365 7269 616c 206e  icate's serial n
│ │ │ │ +00013af0: 756d 6265 7220 2864 6563 696d 616c 293a  umber (decimal):
│ │ │ │ +00013b00: 2030 0a20 2020 2020 4163 7469 7661 7469   0.     Activati
│ │ │ │ +00013b10: 6f6e 2f45 7870 6972 6174 696f 6e20 7469  on/Expiration ti
│ │ │ │ +00013b20: 6d65 2e0a 2020 2020 2054 6865 2067 656e  me..     The gen
│ │ │ │ +00013b30: 6572 6174 6564 2063 6572 7469 6669 6361  erated certifica
│ │ │ │ +00013b40: 7465 2077 696c 6c20 6578 7069 7265 2069  te will expire i
│ │ │ │ +00013b50: 6e20 2864 6179 7329 3a20 3138 300a 2020  n (days): 180.  
│ │ │ │ +00013b60: 2020 2045 7874 656e 7369 6f6e 732e 0a20     Extensions.. 
│ │ │ │ +00013b70: 2020 2020 446f 6573 2074 6865 2063 6572      Does the cer
│ │ │ │ +00013b80: 7469 6669 6361 7465 2062 656c 6f6e 6720  tificate belong 
│ │ │ │ +00013b90: 746f 2061 6e20 6175 7468 6f72 6974 793f  to an authority?
│ │ │ │ +00013ba0: 2028 592f 4e29 3a20 790a 2020 2020 2049   (Y/N): y.     I
│ │ │ │ +00013bb0: 7320 7468 6973 2061 2077 6562 2073 6572  s this a web ser
│ │ │ │ +00013bc0: 7665 7220 6365 7274 6966 6963 6174 653f  ver certificate?
│ │ │ │ +00013bd0: 2028 592f 4e29 3a20 6e0a 2020 2020 2045   (Y/N): n.     E
│ │ │ │ +00013be0: 6e74 6572 2074 6865 2065 2d6d 6169 6c20  nter the e-mail 
│ │ │ │ +00013bf0: 6f66 2074 6865 2073 7562 6a65 6374 206f  of the subject o
│ │ │ │ +00013c00: 6620 7468 6520 6365 7274 6966 6963 6174  f the certificat
│ │ │ │ +00013c10: 653a 0a20 2020 2020 582e 3530 3920 6365  e:.     X.509 ce
│ │ │ │ +00013c20: 7274 6966 6963 6174 6520 696e 666f 3a0a  rtificate info:.
│ │ │ │ +00013c30: 2020 2020 2056 6572 7369 6f6e 3a20 330a       Version: 3.
│ │ │ │ +00013c40: 2020 2020 2053 6572 6961 6c20 4e75 6d62       Serial Numb
│ │ │ │ +00013c50: 6572 2028 6865 7829 3a20 3030 0a20 2020  er (hex): 00.   
│ │ │ │ +00013c60: 2020 5661 6c69 6469 7479 3a0a 2020 2020    Validity:.    
│ │ │ │ +00013c70: 2020 2020 2020 2020 204e 6f74 2042 6566           Not Bef
│ │ │ │ +00013c80: 6f72 653a 2053 756e 2044 6563 2032 3120  ore: Sun Dec 21 
│ │ │ │ +00013c90: 3130 3a35 393a 3030 2032 3030 330a 2020  10:59:00 2003.  
│ │ │ │ +00013ca0: 2020 2020 2020 2020 2020 204e 6f74 2041             Not A
│ │ │ │ +00013cb0: 6674 6572 3a20 4672 6920 4a75 6e20 3138  fter: Fri Jun 18
│ │ │ │ +00013cc0: 2031 313a 3539 3a30 3020 3230 3034 0a20   11:59:00 2004. 
│ │ │ │ +00013cd0: 2020 2020 5375 626a 6563 743a 2043 3d53      Subject: C=S
│ │ │ │ +00013ce0: 452c 4f3d 5368 6973 6869 2045 7861 6d70  E,O=Shishi Examp
│ │ │ │ +00013cf0: 6c65 2043 412c 434e 3d43 410a 2020 2020  le CA,CN=CA.    
│ │ │ │ +00013d00: 2053 7562 6a65 6374 2050 7562 6c69 6320   Subject Public 
│ │ │ │ +00013d10: 4b65 7920 496e 666f 3a0a 2020 2020 2020  Key Info:.      
│ │ │ │ +00013d20: 2020 2020 2020 2050 7562 6c69 6320 4b65         Public Ke
│ │ │ │ +00013d30: 7920 416c 676f 7269 7468 6d3a 2052 5341  y Algorithm: RSA
│ │ │ │ +00013d40: 0a20 2020 2020 582e 3530 3920 4578 7465  .     X.509 Exte
│ │ │ │ +00013d50: 6e73 696f 6e73 3a0a 2020 2020 2020 2020  nsions:.        
│ │ │ │ +00013d60: 2020 2020 2042 6173 6963 2043 6f6e 7374       Basic Const
│ │ │ │ +00013d70: 7261 696e 7473 3a20 2863 7269 7469 6361  raints: (critica
│ │ │ │ +00013d80: 6c29 0a20 2020 2020 2020 2020 2020 2020  l).             
│ │ │ │ +00013d90: 2020 2020 2020 2020 4341 3a54 5255 450a          CA:TRUE.
│ │ │ │ +00013da0: 2020 2020 2049 7320 7468 6520 6162 6f76       Is the abov
│ │ │ │ +00013db0: 6520 696e 666f 726d 6174 696f 6e20 6f6b  e information ok
│ │ │ │ +00013dc0: 3f20 2859 2f4e 293a 2079 0a20 2020 2020  ? (Y/N): y.     
│ │ │ │ +00013dd0: 5369 676e 696e 6720 6365 7274 6966 6963  Signing certific
│ │ │ │ +00013de0: 6174 652e 2e2e 0a20 2020 2020 6a61 7340  ate....     jas@
│ │ │ │ +00013df0: 6c61 7474 653a 7e24 0a0a 332e 362e 332e  latte:~$..3.6.3.
│ │ │ │ +00013e00: 3220 4372 6561 7465 2061 204b 6572 6265  2 Create a Kerbe
│ │ │ │ +00013e10: 726f 7320 4b44 4320 4365 7274 6966 6963  ros KDC Certific
│ │ │ │ +00013e20: 6174 650a 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e  ate.............
│ │ │ │  00013e30: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e  ................
│ │ │ │ -00013e40: 2e2e 2e2e 2e2e 2e2e 2e2e 2e0a 0a46 6972  .............Fir
│ │ │ │ -00013e50: 7374 2063 7265 6174 6520 7468 6520 6b65  st create the ke
│ │ │ │ -00013e60: 7920 666f 7220 7468 6520 4b44 432e 0a0a  y for the KDC...
│ │ │ │ -00013e70: 2020 2020 206a 6173 406c 6174 7465 3a7e       jas@latte:~
│ │ │ │ -00013e80: 2420 6365 7274 746f 6f6c 202d 2d67 656e  $ certtool --gen
│ │ │ │ -00013e90: 6572 6174 652d 7072 6976 6b65 7920 5c0a  erate-privkey \.
│ │ │ │ -00013ea0: 2020 2020 2020 2020 2d2d 6f75 7466 696c          --outfil
│ │ │ │ -00013eb0: 6520 2f75 7372 2f6c 6f63 616c 2f65 7463  e /usr/local/etc
│ │ │ │ -00013ec0: 2f73 6869 7368 692f 7368 6973 6869 642e  /shishi/shishid.
│ │ │ │ -00013ed0: 6b65 790a 2020 2020 2047 656e 6572 6174  key.     Generat
│ │ │ │ -00013ee0: 696e 6720 6120 7072 6976 6174 6520 6b65  ing a private ke
│ │ │ │ -00013ef0: 792e 2e2e 0a20 2020 2020 4765 6e65 7261  y....     Genera
│ │ │ │ -00013f00: 7469 6e67 2061 2031 3032 3420 6269 7420  ting a 1024 bit 
│ │ │ │ -00013f10: 5253 4120 7072 6976 6174 6520 6b65 792e  RSA private key.
│ │ │ │ -00013f20: 2e2e 0a20 2020 2020 6a61 7340 6c61 7474  ...     jas@latt
│ │ │ │ -00013f30: 653a 7e24 0a0a 2020 2054 6865 6e20 6372  e:~$..   Then cr
│ │ │ │ -00013f40: 6561 7465 2061 6374 7561 6c20 4b44 4320  eate actual KDC 
│ │ │ │ -00013f50: 6365 7274 6966 6963 6174 652c 2073 6967  certificate, sig
│ │ │ │ -00013f60: 6e65 6420 6279 2074 6865 2043 4120 6365  ned by the CA ce
│ │ │ │ -00013f70: 7274 6966 6963 6174 650a 6372 6561 7465  rtificate.create
│ │ │ │ -00013f80: 6420 696e 2074 6865 2070 7265 7669 6f75  d in the previou
│ │ │ │ -00013f90: 7320 7374 6570 2e0a 0a20 2020 2020 6a61  s step...     ja
│ │ │ │ -00013fa0: 7340 6c61 7474 653a 7e24 2063 6572 7474  s@latte:~$ certt
│ │ │ │ -00013fb0: 6f6f 6c20 2d2d 6765 6e65 7261 7465 2d63  ool --generate-c
│ │ │ │ -00013fc0: 6572 7469 6669 6361 7465 205c 0a20 2020  ertificate \.   
│ │ │ │ -00013fd0: 2020 2020 202d 2d6c 6f61 642d 6361 2d63       --load-ca-c
│ │ │ │ -00013fe0: 6572 7469 6669 6361 7465 202f 7573 722f  ertificate /usr/
│ │ │ │ -00013ff0: 6c6f 6361 6c2f 6574 632f 7368 6973 6869  local/etc/shishi
│ │ │ │ -00014000: 2f73 6869 7368 692e 6365 7274 205c 0a20  /shishi.cert \. 
│ │ │ │ -00014010: 2020 2020 2020 202d 2d6c 6f61 642d 6361         --load-ca
│ │ │ │ -00014020: 2d70 7269 766b 6579 202f 7573 722f 6c6f  -privkey /usr/lo
│ │ │ │ -00014030: 6361 6c2f 6574 632f 7368 6973 6869 2f73  cal/etc/shishi/s
│ │ │ │ -00014040: 6869 7368 692e 6b65 7920 5c0a 2020 2020  hishi.key \.    
│ │ │ │ -00014050: 2020 2020 2d2d 6c6f 6164 2d70 7269 766b      --load-privk
│ │ │ │ -00014060: 6579 202f 7573 722f 6c6f 6361 6c2f 6574  ey /usr/local/et
│ │ │ │ -00014070: 632f 7368 6973 6869 2f73 6869 7368 6964  c/shishi/shishid
│ │ │ │ -00014080: 2e6b 6579 205c 0a20 2020 2020 2020 202d  .key \.        -
│ │ │ │ -00014090: 2d6f 7574 6669 6c65 202f 7573 722f 6c6f  -outfile /usr/lo
│ │ │ │ -000140a0: 6361 6c2f 6574 632f 7368 6973 6869 2f73  cal/etc/shishi/s
│ │ │ │ -000140b0: 6869 7368 6964 2e63 6572 740a 2020 2020  hishid.cert.    
│ │ │ │ -000140c0: 2047 656e 6572 6174 696e 6720 6120 7369   Generating a si
│ │ │ │ -000140d0: 676e 6564 2063 6572 7469 6669 6361 7465  gned certificate
│ │ │ │ -000140e0: 2e2e 2e0a 2020 2020 204c 6f61 6469 6e67  ....     Loading
│ │ │ │ -000140f0: 2043 4127 7320 7072 6976 6174 6520 6b65   CA's private ke
│ │ │ │ -00014100: 792e 2e2e 0a20 2020 2020 4c6f 6164 696e  y....     Loadin
│ │ │ │ -00014110: 6720 4341 2773 2063 6572 7469 6669 6361  g CA's certifica
│ │ │ │ -00014120: 7465 2e2e 2e0a 2020 2020 2050 6c65 6173  te....     Pleas
│ │ │ │ -00014130: 6520 656e 7465 7220 7468 6520 6465 7461  e enter the deta
│ │ │ │ -00014140: 696c 7320 6f66 2074 6865 2063 6572 7469  ils of the certi
│ │ │ │ -00014150: 6669 6361 7465 2773 2064 6973 7469 6e67  ficate's disting
│ │ │ │ -00014160: 7569 7368 6564 206e 616d 652e 205c 0a20  uished name. \. 
│ │ │ │ -00014170: 2020 2020 4a75 7374 2070 7265 7373 2065      Just press e
│ │ │ │ -00014180: 6e74 6572 2074 6f20 6967 6e6f 7265 2061  nter to ignore a
│ │ │ │ -00014190: 2066 6965 6c64 2e0a 2020 2020 2043 6f75   field..     Cou
│ │ │ │ -000141a0: 6e74 7279 206e 616d 6520 2832 2063 6861  ntry name (2 cha
│ │ │ │ -000141b0: 7273 293a 2053 450a 2020 2020 204f 7267  rs): SE.     Org
│ │ │ │ -000141c0: 616e 697a 6174 696f 6e20 6e61 6d65 3a20  anization name: 
│ │ │ │ -000141d0: 5368 6973 6869 2045 7861 6d70 6c65 204b  Shishi Example K
│ │ │ │ -000141e0: 4443 0a20 2020 2020 4f72 6761 6e69 7a61  DC.     Organiza
│ │ │ │ -000141f0: 7469 6f6e 616c 2075 6e69 7420 6e61 6d65  tional unit name
│ │ │ │ -00014200: 3a0a 2020 2020 204c 6f63 616c 6974 7920  :.     Locality 
│ │ │ │ -00014210: 6e61 6d65 3a0a 2020 2020 2053 7461 7465  name:.     State
│ │ │ │ -00014220: 206f 7220 7072 6f76 696e 6365 206e 616d   or province nam
│ │ │ │ -00014230: 653a 0a20 2020 2020 436f 6d6d 6f6e 206e  e:.     Common n
│ │ │ │ -00014240: 616d 653a 204b 4443 0a20 2020 2020 5468  ame: KDC.     Th
│ │ │ │ -00014250: 6973 2066 6965 6c64 2073 686f 756c 6420  is field should 
│ │ │ │ -00014260: 6e6f 7420 6265 2075 7365 6420 696e 206e  not be used in n
│ │ │ │ -00014270: 6577 2063 6572 7469 6669 6361 7465 732e  ew certificates.
│ │ │ │ -00014280: 0a20 2020 2020 452d 6d61 696c 3a0a 2020  .     E-mail:.  
│ │ │ │ -00014290: 2020 2045 6e74 6572 2074 6865 2063 6572     Enter the cer
│ │ │ │ -000142a0: 7469 6669 6361 7465 2773 2073 6572 6961  tificate's seria
│ │ │ │ -000142b0: 6c20 6e75 6d62 6572 2028 6465 6369 6d61  l number (decima
│ │ │ │ -000142c0: 6c29 3a20 300a 2020 2020 2041 6374 6976  l): 0.     Activ
│ │ │ │ -000142d0: 6174 696f 6e2f 4578 7069 7261 7469 6f6e  ation/Expiration
│ │ │ │ -000142e0: 2074 696d 652e 0a20 2020 2020 5468 6520   time..     The 
│ │ │ │ -000142f0: 6765 6e65 7261 7465 6420 6365 7274 6966  generated certif
│ │ │ │ -00014300: 6963 6174 6520 7769 6c6c 2065 7870 6972  icate will expir
│ │ │ │ -00014310: 6520 696e 2028 6461 7973 293a 2031 3830  e in (days): 180
│ │ │ │ -00014320: 0a20 2020 2020 4578 7465 6e73 696f 6e73  .     Extensions
│ │ │ │ -00014330: 2e0a 2020 2020 2044 6f65 7320 7468 6520  ..     Does the 
│ │ │ │ -00014340: 6365 7274 6966 6963 6174 6520 6265 6c6f  certificate belo
│ │ │ │ -00014350: 6e67 2074 6f20 616e 2061 7574 686f 7269  ng to an authori
│ │ │ │ -00014360: 7479 3f20 2859 2f4e 293a 206e 0a20 2020  ty? (Y/N): n.   
│ │ │ │ -00014370: 2020 4973 2074 6869 7320 6120 7765 6220    Is this a web 
│ │ │ │ -00014380: 7365 7276 6572 2063 6572 7469 6669 6361  server certifica
│ │ │ │ -00014390: 7465 3f20 2859 2f4e 293a 206e 0a20 2020  te? (Y/N): n.   
│ │ │ │ -000143a0: 2020 456e 7465 7220 7468 6520 652d 6d61    Enter the e-ma
│ │ │ │ -000143b0: 696c 206f 6620 7468 6520 7375 626a 6563  il of the subjec
│ │ │ │ -000143c0: 7420 6f66 2074 6865 2063 6572 7469 6669  t of the certifi
│ │ │ │ -000143d0: 6361 7465 3a0a 2020 2020 2058 2e35 3039  cate:.     X.509
│ │ │ │ -000143e0: 2063 6572 7469 6669 6361 7465 2069 6e66   certificate inf
│ │ │ │ -000143f0: 6f3a 0a20 2020 2020 5665 7273 696f 6e3a  o:.     Version:
│ │ │ │ -00014400: 2033 0a20 2020 2020 5365 7269 616c 204e   3.     Serial N
│ │ │ │ -00014410: 756d 6265 7220 2868 6578 293a 2030 300a  umber (hex): 00.
│ │ │ │ -00014420: 2020 2020 2056 616c 6964 6974 793a 0a20       Validity:. 
│ │ │ │ -00014430: 2020 2020 2020 2020 2020 2020 4e6f 7420              Not 
│ │ │ │ -00014440: 4265 666f 7265 3a20 5375 6e20 4465 6320  Before: Sun Dec 
│ │ │ │ -00014450: 3231 2031 313a 3032 3a30 3020 3230 3033  21 11:02:00 2003
│ │ │ │ -00014460: 0a20 2020 2020 2020 2020 2020 2020 4e6f  .             No
│ │ │ │ -00014470: 7420 4166 7465 723a 2046 7269 204a 756e  t After: Fri Jun
│ │ │ │ -00014480: 2031 3820 3132 3a30 323a 3030 2032 3030   18 12:02:00 200
│ │ │ │ -00014490: 340a 2020 2020 2053 7562 6a65 6374 3a20  4.     Subject: 
│ │ │ │ -000144a0: 433d 5345 2c4f 3d53 6869 7368 6920 4578  C=SE,O=Shishi Ex
│ │ │ │ -000144b0: 616d 706c 6520 4b44 432c 434e 3d4b 4443  ample KDC,CN=KDC
│ │ │ │ -000144c0: 0a20 2020 2020 5375 626a 6563 7420 5075  .     Subject Pu
│ │ │ │ -000144d0: 626c 6963 204b 6579 2049 6e66 6f3a 0a20  blic Key Info:. 
│ │ │ │ -000144e0: 2020 2020 2020 2020 2020 2020 5075 626c              Publ
│ │ │ │ -000144f0: 6963 204b 6579 2041 6c67 6f72 6974 686d  ic Key Algorithm
│ │ │ │ -00014500: 3a20 5253 410a 2020 2020 2058 2e35 3039  : RSA.     X.509
│ │ │ │ -00014510: 2045 7874 656e 7369 6f6e 733a 0a20 2020   Extensions:.   
│ │ │ │ -00014520: 2020 2020 2020 2020 2020 4261 7369 6320            Basic 
│ │ │ │ -00014530: 436f 6e73 7472 6169 6e74 733a 2028 6372  Constraints: (cr
│ │ │ │ -00014540: 6974 6963 616c 290a 2020 2020 2020 2020  itical).        
│ │ │ │ -00014550: 2020 2020 2020 2020 2020 2020 2043 413a               CA:
│ │ │ │ -00014560: 4641 4c53 450a 2020 2020 2049 7320 7468  FALSE.     Is th
│ │ │ │ -00014570: 6520 6162 6f76 6520 696e 666f 726d 6174  e above informat
│ │ │ │ -00014580: 696f 6e20 6f6b 3f20 2859 2f4e 293a 2079  ion ok? (Y/N): y
│ │ │ │ -00014590: 0a20 2020 2020 5369 676e 696e 6720 6365  .     Signing ce
│ │ │ │ -000145a0: 7274 6966 6963 6174 652e 2e2e 0a20 2020  rtificate....   
│ │ │ │ -000145b0: 2020 6a61 7340 6c61 7474 653a 7e24 0a0a    jas@latte:~$..
│ │ │ │ -000145c0: 332e 362e 332e 3320 4372 6561 7465 2061  3.6.3.3 Create a
│ │ │ │ -000145d0: 204b 6572 6265 726f 7320 436c 6965 6e74   Kerberos Client
│ │ │ │ -000145e0: 2043 6572 7469 6669 6361 7465 0a2e 2e2e   Certificate....
│ │ │ │ +00013e40: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e0a 0a46  ...............F
│ │ │ │ +00013e50: 6972 7374 2063 7265 6174 6520 7468 6520  irst create the 
│ │ │ │ +00013e60: 6b65 7920 666f 7220 7468 6520 4b44 432e  key for the KDC.
│ │ │ │ +00013e70: 0a0a 2020 2020 206a 6173 406c 6174 7465  ..     jas@latte
│ │ │ │ +00013e80: 3a7e 2420 6365 7274 746f 6f6c 202d 2d67  :~$ certtool --g
│ │ │ │ +00013e90: 656e 6572 6174 652d 7072 6976 6b65 7920  enerate-privkey 
│ │ │ │ +00013ea0: 5c0a 2020 2020 2020 2020 2d2d 6f75 7466  \.        --outf
│ │ │ │ +00013eb0: 696c 6520 2f75 7372 2f6c 6f63 616c 2f65  ile /usr/local/e
│ │ │ │ +00013ec0: 7463 2f73 6869 7368 692f 7368 6973 6869  tc/shishi/shishi
│ │ │ │ +00013ed0: 642e 6b65 790a 2020 2020 2047 656e 6572  d.key.     Gener
│ │ │ │ +00013ee0: 6174 696e 6720 6120 7072 6976 6174 6520  ating a private 
│ │ │ │ +00013ef0: 6b65 792e 2e2e 0a20 2020 2020 4765 6e65  key....     Gene
│ │ │ │ +00013f00: 7261 7469 6e67 2061 2031 3032 3420 6269  rating a 1024 bi
│ │ │ │ +00013f10: 7420 5253 4120 7072 6976 6174 6520 6b65  t RSA private ke
│ │ │ │ +00013f20: 792e 2e2e 0a20 2020 2020 6a61 7340 6c61  y....     jas@la
│ │ │ │ +00013f30: 7474 653a 7e24 0a0a 2020 2054 6865 6e20  tte:~$..   Then 
│ │ │ │ +00013f40: 6372 6561 7465 2061 6374 7561 6c20 4b44  create actual KD
│ │ │ │ +00013f50: 4320 6365 7274 6966 6963 6174 652c 2073  C certificate, s
│ │ │ │ +00013f60: 6967 6e65 6420 6279 2074 6865 2043 4120  igned by the CA 
│ │ │ │ +00013f70: 6365 7274 6966 6963 6174 650a 6372 6561  certificate.crea
│ │ │ │ +00013f80: 7465 6420 696e 2074 6865 2070 7265 7669  ted in the previ
│ │ │ │ +00013f90: 6f75 7320 7374 6570 2e0a 0a20 2020 2020  ous step...     
│ │ │ │ +00013fa0: 6a61 7340 6c61 7474 653a 7e24 2063 6572  jas@latte:~$ cer
│ │ │ │ +00013fb0: 7474 6f6f 6c20 2d2d 6765 6e65 7261 7465  ttool --generate
│ │ │ │ +00013fc0: 2d63 6572 7469 6669 6361 7465 205c 0a20  -certificate \. 
│ │ │ │ +00013fd0: 2020 2020 2020 202d 2d6c 6f61 642d 6361         --load-ca
│ │ │ │ +00013fe0: 2d63 6572 7469 6669 6361 7465 202f 7573  -certificate /us
│ │ │ │ +00013ff0: 722f 6c6f 6361 6c2f 6574 632f 7368 6973  r/local/etc/shis
│ │ │ │ +00014000: 6869 2f73 6869 7368 692e 6365 7274 205c  hi/shishi.cert \
│ │ │ │ +00014010: 0a20 2020 2020 2020 202d 2d6c 6f61 642d  .        --load-
│ │ │ │ +00014020: 6361 2d70 7269 766b 6579 202f 7573 722f  ca-privkey /usr/
│ │ │ │ +00014030: 6c6f 6361 6c2f 6574 632f 7368 6973 6869  local/etc/shishi
│ │ │ │ +00014040: 2f73 6869 7368 692e 6b65 7920 5c0a 2020  /shishi.key \.  
│ │ │ │ +00014050: 2020 2020 2020 2d2d 6c6f 6164 2d70 7269        --load-pri
│ │ │ │ +00014060: 766b 6579 202f 7573 722f 6c6f 6361 6c2f  vkey /usr/local/
│ │ │ │ +00014070: 6574 632f 7368 6973 6869 2f73 6869 7368  etc/shishi/shish
│ │ │ │ +00014080: 6964 2e6b 6579 205c 0a20 2020 2020 2020  id.key \.       
│ │ │ │ +00014090: 202d 2d6f 7574 6669 6c65 202f 7573 722f   --outfile /usr/
│ │ │ │ +000140a0: 6c6f 6361 6c2f 6574 632f 7368 6973 6869  local/etc/shishi
│ │ │ │ +000140b0: 2f73 6869 7368 6964 2e63 6572 740a 2020  /shishid.cert.  
│ │ │ │ +000140c0: 2020 2047 656e 6572 6174 696e 6720 6120     Generating a 
│ │ │ │ +000140d0: 7369 676e 6564 2063 6572 7469 6669 6361  signed certifica
│ │ │ │ +000140e0: 7465 2e2e 2e0a 2020 2020 204c 6f61 6469  te....     Loadi
│ │ │ │ +000140f0: 6e67 2043 4127 7320 7072 6976 6174 6520  ng CA's private 
│ │ │ │ +00014100: 6b65 792e 2e2e 0a20 2020 2020 4c6f 6164  key....     Load
│ │ │ │ +00014110: 696e 6720 4341 2773 2063 6572 7469 6669  ing CA's certifi
│ │ │ │ +00014120: 6361 7465 2e2e 2e0a 2020 2020 2050 6c65  cate....     Ple
│ │ │ │ +00014130: 6173 6520 656e 7465 7220 7468 6520 6465  ase enter the de
│ │ │ │ +00014140: 7461 696c 7320 6f66 2074 6865 2063 6572  tails of the cer
│ │ │ │ +00014150: 7469 6669 6361 7465 2773 2064 6973 7469  tificate's disti
│ │ │ │ +00014160: 6e67 7569 7368 6564 206e 616d 652e 205c  nguished name. \
│ │ │ │ +00014170: 0a20 2020 2020 4a75 7374 2070 7265 7373  .     Just press
│ │ │ │ +00014180: 2065 6e74 6572 2074 6f20 6967 6e6f 7265   enter to ignore
│ │ │ │ +00014190: 2061 2066 6965 6c64 2e0a 2020 2020 2043   a field..     C
│ │ │ │ +000141a0: 6f75 6e74 7279 206e 616d 6520 2832 2063  ountry name (2 c
│ │ │ │ +000141b0: 6861 7273 293a 2053 450a 2020 2020 204f  hars): SE.     O
│ │ │ │ +000141c0: 7267 616e 697a 6174 696f 6e20 6e61 6d65  rganization name
│ │ │ │ +000141d0: 3a20 5368 6973 6869 2045 7861 6d70 6c65  : Shishi Example
│ │ │ │ +000141e0: 204b 4443 0a20 2020 2020 4f72 6761 6e69   KDC.     Organi
│ │ │ │ +000141f0: 7a61 7469 6f6e 616c 2075 6e69 7420 6e61  zational unit na
│ │ │ │ +00014200: 6d65 3a0a 2020 2020 204c 6f63 616c 6974  me:.     Localit
│ │ │ │ +00014210: 7920 6e61 6d65 3a0a 2020 2020 2053 7461  y name:.     Sta
│ │ │ │ +00014220: 7465 206f 7220 7072 6f76 696e 6365 206e  te or province n
│ │ │ │ +00014230: 616d 653a 0a20 2020 2020 436f 6d6d 6f6e  ame:.     Common
│ │ │ │ +00014240: 206e 616d 653a 204b 4443 0a20 2020 2020   name: KDC.     
│ │ │ │ +00014250: 5468 6973 2066 6965 6c64 2073 686f 756c  This field shoul
│ │ │ │ +00014260: 6420 6e6f 7420 6265 2075 7365 6420 696e  d not be used in
│ │ │ │ +00014270: 206e 6577 2063 6572 7469 6669 6361 7465   new certificate
│ │ │ │ +00014280: 732e 0a20 2020 2020 452d 6d61 696c 3a0a  s..     E-mail:.
│ │ │ │ +00014290: 2020 2020 2045 6e74 6572 2074 6865 2063       Enter the c
│ │ │ │ +000142a0: 6572 7469 6669 6361 7465 2773 2073 6572  ertificate's ser
│ │ │ │ +000142b0: 6961 6c20 6e75 6d62 6572 2028 6465 6369  ial number (deci
│ │ │ │ +000142c0: 6d61 6c29 3a20 300a 2020 2020 2041 6374  mal): 0.     Act
│ │ │ │ +000142d0: 6976 6174 696f 6e2f 4578 7069 7261 7469  ivation/Expirati
│ │ │ │ +000142e0: 6f6e 2074 696d 652e 0a20 2020 2020 5468  on time..     Th
│ │ │ │ +000142f0: 6520 6765 6e65 7261 7465 6420 6365 7274  e generated cert
│ │ │ │ +00014300: 6966 6963 6174 6520 7769 6c6c 2065 7870  ificate will exp
│ │ │ │ +00014310: 6972 6520 696e 2028 6461 7973 293a 2031  ire in (days): 1
│ │ │ │ +00014320: 3830 0a20 2020 2020 4578 7465 6e73 696f  80.     Extensio
│ │ │ │ +00014330: 6e73 2e0a 2020 2020 2044 6f65 7320 7468  ns..     Does th
│ │ │ │ +00014340: 6520 6365 7274 6966 6963 6174 6520 6265  e certificate be
│ │ │ │ +00014350: 6c6f 6e67 2074 6f20 616e 2061 7574 686f  long to an autho
│ │ │ │ +00014360: 7269 7479 3f20 2859 2f4e 293a 206e 0a20  rity? (Y/N): n. 
│ │ │ │ +00014370: 2020 2020 4973 2074 6869 7320 6120 7765      Is this a we
│ │ │ │ +00014380: 6220 7365 7276 6572 2063 6572 7469 6669  b server certifi
│ │ │ │ +00014390: 6361 7465 3f20 2859 2f4e 293a 206e 0a20  cate? (Y/N): n. 
│ │ │ │ +000143a0: 2020 2020 456e 7465 7220 7468 6520 652d      Enter the e-
│ │ │ │ +000143b0: 6d61 696c 206f 6620 7468 6520 7375 626a  mail of the subj
│ │ │ │ +000143c0: 6563 7420 6f66 2074 6865 2063 6572 7469  ect of the certi
│ │ │ │ +000143d0: 6669 6361 7465 3a0a 2020 2020 2058 2e35  ficate:.     X.5
│ │ │ │ +000143e0: 3039 2063 6572 7469 6669 6361 7465 2069  09 certificate i
│ │ │ │ +000143f0: 6e66 6f3a 0a20 2020 2020 5665 7273 696f  nfo:.     Versio
│ │ │ │ +00014400: 6e3a 2033 0a20 2020 2020 5365 7269 616c  n: 3.     Serial
│ │ │ │ +00014410: 204e 756d 6265 7220 2868 6578 293a 2030   Number (hex): 0
│ │ │ │ +00014420: 300a 2020 2020 2056 616c 6964 6974 793a  0.     Validity:
│ │ │ │ +00014430: 0a20 2020 2020 2020 2020 2020 2020 4e6f  .             No
│ │ │ │ +00014440: 7420 4265 666f 7265 3a20 5375 6e20 4465  t Before: Sun De
│ │ │ │ +00014450: 6320 3231 2031 313a 3032 3a30 3020 3230  c 21 11:02:00 20
│ │ │ │ +00014460: 3033 0a20 2020 2020 2020 2020 2020 2020  03.             
│ │ │ │ +00014470: 4e6f 7420 4166 7465 723a 2046 7269 204a  Not After: Fri J
│ │ │ │ +00014480: 756e 2031 3820 3132 3a30 323a 3030 2032  un 18 12:02:00 2
│ │ │ │ +00014490: 3030 340a 2020 2020 2053 7562 6a65 6374  004.     Subject
│ │ │ │ +000144a0: 3a20 433d 5345 2c4f 3d53 6869 7368 6920  : C=SE,O=Shishi 
│ │ │ │ +000144b0: 4578 616d 706c 6520 4b44 432c 434e 3d4b  Example KDC,CN=K
│ │ │ │ +000144c0: 4443 0a20 2020 2020 5375 626a 6563 7420  DC.     Subject 
│ │ │ │ +000144d0: 5075 626c 6963 204b 6579 2049 6e66 6f3a  Public Key Info:
│ │ │ │ +000144e0: 0a20 2020 2020 2020 2020 2020 2020 5075  .             Pu
│ │ │ │ +000144f0: 626c 6963 204b 6579 2041 6c67 6f72 6974  blic Key Algorit
│ │ │ │ +00014500: 686d 3a20 5253 410a 2020 2020 2058 2e35  hm: RSA.     X.5
│ │ │ │ +00014510: 3039 2045 7874 656e 7369 6f6e 733a 0a20  09 Extensions:. 
│ │ │ │ +00014520: 2020 2020 2020 2020 2020 2020 4261 7369              Basi
│ │ │ │ +00014530: 6320 436f 6e73 7472 6169 6e74 733a 2028  c Constraints: (
│ │ │ │ +00014540: 6372 6974 6963 616c 290a 2020 2020 2020  critical).      
│ │ │ │ +00014550: 2020 2020 2020 2020 2020 2020 2020 2043                 C
│ │ │ │ +00014560: 413a 4641 4c53 450a 2020 2020 2049 7320  A:FALSE.     Is 
│ │ │ │ +00014570: 7468 6520 6162 6f76 6520 696e 666f 726d  the above inform
│ │ │ │ +00014580: 6174 696f 6e20 6f6b 3f20 2859 2f4e 293a  ation ok? (Y/N):
│ │ │ │ +00014590: 2079 0a20 2020 2020 5369 676e 696e 6720   y.     Signing 
│ │ │ │ +000145a0: 6365 7274 6966 6963 6174 652e 2e2e 0a20  certificate.... 
│ │ │ │ +000145b0: 2020 2020 6a61 7340 6c61 7474 653a 7e24      jas@latte:~$
│ │ │ │ +000145c0: 0a0a 332e 362e 332e 3320 4372 6561 7465  ..3.6.3.3 Create
│ │ │ │ +000145d0: 2061 204b 6572 6265 726f 7320 436c 6965   a Kerberos Clie
│ │ │ │ +000145e0: 6e74 2043 6572 7469 6669 6361 7465 0a2e  nt Certificate..
│ │ │ │  000145f0: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e  ................
│ │ │ │  00014600: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e  ................
│ │ │ │ -00014610: 2e2e 2e2e 2e2e 2e2e 2e0a 0a46 6972 7374  ...........First
│ │ │ │ -00014620: 2063 7265 6174 6520 7468 6520 6b65 7920   create the key 
│ │ │ │ -00014630: 666f 7220 7468 6520 636c 6965 6e74 2e0a  for the client..
│ │ │ │ -00014640: 0a20 2020 2020 6a61 7340 6c61 7474 653a  .     jas@latte:
│ │ │ │ -00014650: 7e24 2063 6572 7474 6f6f 6c20 2d2d 6765  ~$ certtool --ge
│ │ │ │ -00014660: 6e65 7261 7465 2d70 7269 766b 6579 205c  nerate-privkey \
│ │ │ │ -00014670: 0a20 2020 2020 2020 202d 2d6f 7574 6669  .        --outfi
│ │ │ │ -00014680: 6c65 207e 2f2e 7368 6973 6869 2f63 6c69  le ~/.shishi/cli
│ │ │ │ -00014690: 656e 742e 6b65 790a 2020 2020 2047 656e  ent.key.     Gen
│ │ │ │ -000146a0: 6572 6174 696e 6720 6120 7072 6976 6174  erating a privat
│ │ │ │ -000146b0: 6520 6b65 792e 2e2e 0a20 2020 2020 4765  e key....     Ge
│ │ │ │ -000146c0: 6e65 7261 7469 6e67 2061 2031 3032 3420  nerating a 1024 
│ │ │ │ -000146d0: 6269 7420 5253 4120 7072 6976 6174 6520  bit RSA private 
│ │ │ │ -000146e0: 6b65 792e 2e2e 0a20 2020 2020 6a61 7340  key....     jas@
│ │ │ │ -000146f0: 6c61 7474 653a 7e24 0a0a 2020 2054 6865  latte:~$..   The
│ │ │ │ -00014700: 6e20 6372 6561 7465 2074 6865 2063 6c69  n create the cli
│ │ │ │ -00014710: 656e 7420 6365 7274 6966 6963 6174 652c  ent certificate,
│ │ │ │ -00014720: 2073 6967 6e65 6420 6279 2074 6865 2043   signed by the C
│ │ │ │ -00014730: 412e 2041 6e20 616c 7465 726e 6174 6976  A. An alternativ
│ │ │ │ -00014740: 650a 776f 756c 6420 6265 2074 6f20 6861  e.would be to ha
│ │ │ │ -00014750: 7665 2074 6865 204b 4443 2073 6967 6e20  ve the KDC sign 
│ │ │ │ -00014760: 7468 6520 636c 6965 6e74 2063 6572 7469  the client certi
│ │ │ │ -00014770: 6669 6361 7465 732e 0a0a 2020 2020 206a  ficates...     j
│ │ │ │ -00014780: 6173 406c 6174 7465 3a7e 2420 6365 7274  as@latte:~$ cert
│ │ │ │ -00014790: 746f 6f6c 202d 2d67 656e 6572 6174 652d  tool --generate-
│ │ │ │ -000147a0: 6365 7274 6966 6963 6174 6520 5c0a 2020  certificate \.  
│ │ │ │ -000147b0: 2020 2020 2020 2d2d 6c6f 6164 2d63 612d        --load-ca-
│ │ │ │ -000147c0: 6365 7274 6966 6963 6174 6520 2f75 7372  certificate /usr
│ │ │ │ -000147d0: 2f6c 6f63 616c 2f65 7463 2f73 6869 7368  /local/etc/shish
│ │ │ │ -000147e0: 692f 7368 6973 6869 2e63 6572 7420 5c0a  i/shishi.cert \.
│ │ │ │ -000147f0: 2020 2020 2020 2020 2d2d 6c6f 6164 2d63          --load-c
│ │ │ │ -00014800: 612d 7072 6976 6b65 7920 2f75 7372 2f6c  a-privkey /usr/l
│ │ │ │ -00014810: 6f63 616c 2f65 7463 2f73 6869 7368 692f  ocal/etc/shishi/
│ │ │ │ -00014820: 7368 6973 6869 2e6b 6579 205c 0a20 2020  shishi.key \.   
│ │ │ │ -00014830: 2020 2020 202d 2d6c 6f61 642d 7072 6976       --load-priv
│ │ │ │ -00014840: 6b65 7920 7e2f 2e73 6869 7368 692f 636c  key ~/.shishi/cl
│ │ │ │ -00014850: 6965 6e74 2e6b 6579 205c 0a20 2020 2020  ient.key \.     
│ │ │ │ -00014860: 2020 202d 2d6f 7574 6669 6c65 207e 2f2e     --outfile ~/.
│ │ │ │ -00014870: 7368 6973 6869 2f63 6c69 656e 742e 6365  shishi/client.ce
│ │ │ │ -00014880: 7274 730a 2020 2020 2047 656e 6572 6174  rts.     Generat
│ │ │ │ -00014890: 696e 6720 6120 7369 676e 6564 2063 6572  ing a signed cer
│ │ │ │ -000148a0: 7469 6669 6361 7465 2e2e 2e0a 2020 2020  tificate....    
│ │ │ │ -000148b0: 204c 6f61 6469 6e67 2043 4127 7320 7072   Loading CA's pr
│ │ │ │ -000148c0: 6976 6174 6520 6b65 792e 2e2e 0a20 2020  ivate key....   
│ │ │ │ -000148d0: 2020 4c6f 6164 696e 6720 4341 2773 2063    Loading CA's c
│ │ │ │ -000148e0: 6572 7469 6669 6361 7465 2e2e 2e0a 2020  ertificate....  
│ │ │ │ -000148f0: 2020 2050 6c65 6173 6520 656e 7465 7220     Please enter 
│ │ │ │ -00014900: 7468 6520 6465 7461 696c 7320 6f66 2074  the details of t
│ │ │ │ -00014910: 6865 2063 6572 7469 6669 6361 7465 2773  he certificate's
│ │ │ │ -00014920: 2064 6973 7469 6e67 7569 7368 6564 206e   distinguished n
│ │ │ │ -00014930: 616d 652e 205c 0a20 2020 2020 4a75 7374  ame. \.     Just
│ │ │ │ -00014940: 2070 7265 7373 2065 6e74 6572 2074 6f20   press enter to 
│ │ │ │ -00014950: 6967 6e6f 7265 2061 2066 6965 6c64 2e0a  ignore a field..
│ │ │ │ -00014960: 2020 2020 2043 6f75 6e74 7279 206e 616d       Country nam
│ │ │ │ -00014970: 6520 2832 2063 6861 7273 293a 2053 450a  e (2 chars): SE.
│ │ │ │ -00014980: 2020 2020 204f 7267 616e 697a 6174 696f       Organizatio
│ │ │ │ -00014990: 6e20 6e61 6d65 3a20 5368 6973 6869 2045  n name: Shishi E
│ │ │ │ -000149a0: 7861 6d70 6c65 2043 6c69 656e 740a 2020  xample Client.  
│ │ │ │ -000149b0: 2020 204f 7267 616e 697a 6174 696f 6e61     Organizationa
│ │ │ │ -000149c0: 6c20 756e 6974 206e 616d 653a 0a20 2020  l unit name:.   
│ │ │ │ -000149d0: 2020 4c6f 6361 6c69 7479 206e 616d 653a    Locality name:
│ │ │ │ -000149e0: 0a20 2020 2020 5374 6174 6520 6f72 2070  .     State or p
│ │ │ │ -000149f0: 726f 7669 6e63 6520 6e61 6d65 3a0a 2020  rovince name:.  
│ │ │ │ -00014a00: 2020 2043 6f6d 6d6f 6e20 6e61 6d65 3a20     Common name: 
│ │ │ │ -00014a10: 436c 6965 6e74 0a20 2020 2020 5468 6973  Client.     This
│ │ │ │ -00014a20: 2066 6965 6c64 2073 686f 756c 6420 6e6f   field should no
│ │ │ │ -00014a30: 7420 6265 2075 7365 6420 696e 206e 6577  t be used in new
│ │ │ │ -00014a40: 2063 6572 7469 6669 6361 7465 732e 0a20   certificates.. 
│ │ │ │ -00014a50: 2020 2020 452d 6d61 696c 3a0a 2020 2020      E-mail:.    
│ │ │ │ -00014a60: 2045 6e74 6572 2074 6865 2063 6572 7469   Enter the certi
│ │ │ │ -00014a70: 6669 6361 7465 2773 2073 6572 6961 6c20  ficate's serial 
│ │ │ │ -00014a80: 6e75 6d62 6572 2028 6465 6369 6d61 6c29  number (decimal)
│ │ │ │ -00014a90: 3a20 300a 2020 2020 2041 6374 6976 6174  : 0.     Activat
│ │ │ │ -00014aa0: 696f 6e2f 4578 7069 7261 7469 6f6e 2074  ion/Expiration t
│ │ │ │ -00014ab0: 696d 652e 0a20 2020 2020 5468 6520 6765  ime..     The ge
│ │ │ │ -00014ac0: 6e65 7261 7465 6420 6365 7274 6966 6963  nerated certific
│ │ │ │ -00014ad0: 6174 6520 7769 6c6c 2065 7870 6972 6520  ate will expire 
│ │ │ │ -00014ae0: 696e 2028 6461 7973 293a 2031 3830 0a20  in (days): 180. 
│ │ │ │ -00014af0: 2020 2020 4578 7465 6e73 696f 6e73 2e0a      Extensions..
│ │ │ │ -00014b00: 2020 2020 2044 6f65 7320 7468 6520 6365       Does the ce
│ │ │ │ -00014b10: 7274 6966 6963 6174 6520 6265 6c6f 6e67  rtificate belong
│ │ │ │ -00014b20: 2074 6f20 616e 2061 7574 686f 7269 7479   to an authority
│ │ │ │ -00014b30: 3f20 2859 2f4e 293a 206e 0a20 2020 2020  ? (Y/N): n.     
│ │ │ │ -00014b40: 4973 2074 6869 7320 6120 7765 6220 7365  Is this a web se
│ │ │ │ -00014b50: 7276 6572 2063 6572 7469 6669 6361 7465  rver certificate
│ │ │ │ -00014b60: 3f20 2859 2f4e 293a 206e 0a20 2020 2020  ? (Y/N): n.     
│ │ │ │ -00014b70: 456e 7465 7220 7468 6520 652d 6d61 696c  Enter the e-mail
│ │ │ │ -00014b80: 206f 6620 7468 6520 7375 626a 6563 7420   of the subject 
│ │ │ │ -00014b90: 6f66 2074 6865 2063 6572 7469 6669 6361  of the certifica
│ │ │ │ -00014ba0: 7465 3a0a 2020 2020 2058 2e35 3039 2063  te:.     X.509 c
│ │ │ │ -00014bb0: 6572 7469 6669 6361 7465 2069 6e66 6f3a  ertificate info:
│ │ │ │ -00014bc0: 0a20 2020 2020 5665 7273 696f 6e3a 2033  .     Version: 3
│ │ │ │ -00014bd0: 0a20 2020 2020 5365 7269 616c 204e 756d  .     Serial Num
│ │ │ │ -00014be0: 6265 7220 2868 6578 293a 2030 300a 2020  ber (hex): 00.  
│ │ │ │ -00014bf0: 2020 2056 616c 6964 6974 793a 0a20 2020     Validity:.   
│ │ │ │ -00014c00: 2020 2020 2020 2020 2020 4e6f 7420 4265            Not Be
│ │ │ │ -00014c10: 666f 7265 3a20 5375 6e20 4465 6320 3231  fore: Sun Dec 21
│ │ │ │ -00014c20: 2031 313a 3034 3a30 3020 3230 3033 0a20   11:04:00 2003. 
│ │ │ │ -00014c30: 2020 2020 2020 2020 2020 2020 4e6f 7420              Not 
│ │ │ │ -00014c40: 4166 7465 723a 2046 7269 204a 756e 2031  After: Fri Jun 1
│ │ │ │ -00014c50: 3820 3132 3a30 343a 3030 2032 3030 340a  8 12:04:00 2004.
│ │ │ │ -00014c60: 2020 2020 2053 7562 6a65 6374 3a20 433d       Subject: C=
│ │ │ │ -00014c70: 5345 2c4f 3d53 6869 7368 6920 4578 616d  SE,O=Shishi Exam
│ │ │ │ -00014c80: 706c 6520 436c 6965 6e74 2c43 4e3d 436c  ple Client,CN=Cl
│ │ │ │ -00014c90: 6965 6e74 0a20 2020 2020 5375 626a 6563  ient.     Subjec
│ │ │ │ -00014ca0: 7420 5075 626c 6963 204b 6579 2049 6e66  t Public Key Inf
│ │ │ │ -00014cb0: 6f3a 0a20 2020 2020 2020 2020 2020 2020  o:.             
│ │ │ │ -00014cc0: 5075 626c 6963 204b 6579 2041 6c67 6f72  Public Key Algor
│ │ │ │ -00014cd0: 6974 686d 3a20 5253 410a 2020 2020 2058  ithm: RSA.     X
│ │ │ │ -00014ce0: 2e35 3039 2045 7874 656e 7369 6f6e 733a  .509 Extensions:
│ │ │ │ -00014cf0: 0a20 2020 2020 2020 2020 2020 2020 4261  .             Ba
│ │ │ │ -00014d00: 7369 6320 436f 6e73 7472 6169 6e74 733a  sic Constraints:
│ │ │ │ -00014d10: 2028 6372 6974 6963 616c 290a 2020 2020   (critical).    
│ │ │ │ +00014610: 2e2e 2e2e 2e2e 2e2e 2e2e 2e0a 0a46 6972  .............Fir
│ │ │ │ +00014620: 7374 2063 7265 6174 6520 7468 6520 6b65  st create the ke
│ │ │ │ +00014630: 7920 666f 7220 7468 6520 636c 6965 6e74  y for the client
│ │ │ │ +00014640: 2e0a 0a20 2020 2020 6a61 7340 6c61 7474  ...     jas@latt
│ │ │ │ +00014650: 653a 7e24 2063 6572 7474 6f6f 6c20 2d2d  e:~$ certtool --
│ │ │ │ +00014660: 6765 6e65 7261 7465 2d70 7269 766b 6579  generate-privkey
│ │ │ │ +00014670: 205c 0a20 2020 2020 2020 202d 2d6f 7574   \.        --out
│ │ │ │ +00014680: 6669 6c65 207e 2f2e 7368 6973 6869 2f63  file ~/.shishi/c
│ │ │ │ +00014690: 6c69 656e 742e 6b65 790a 2020 2020 2047  lient.key.     G
│ │ │ │ +000146a0: 656e 6572 6174 696e 6720 6120 7072 6976  enerating a priv
│ │ │ │ +000146b0: 6174 6520 6b65 792e 2e2e 0a20 2020 2020  ate key....     
│ │ │ │ +000146c0: 4765 6e65 7261 7469 6e67 2061 2031 3032  Generating a 102
│ │ │ │ +000146d0: 3420 6269 7420 5253 4120 7072 6976 6174  4 bit RSA privat
│ │ │ │ +000146e0: 6520 6b65 792e 2e2e 0a20 2020 2020 6a61  e key....     ja
│ │ │ │ +000146f0: 7340 6c61 7474 653a 7e24 0a0a 2020 2054  s@latte:~$..   T
│ │ │ │ +00014700: 6865 6e20 6372 6561 7465 2074 6865 2063  hen create the c
│ │ │ │ +00014710: 6c69 656e 7420 6365 7274 6966 6963 6174  lient certificat
│ │ │ │ +00014720: 652c 2073 6967 6e65 6420 6279 2074 6865  e, signed by the
│ │ │ │ +00014730: 2043 412e 2041 6e20 616c 7465 726e 6174   CA. An alternat
│ │ │ │ +00014740: 6976 650a 776f 756c 6420 6265 2074 6f20  ive.would be to 
│ │ │ │ +00014750: 6861 7665 2074 6865 204b 4443 2073 6967  have the KDC sig
│ │ │ │ +00014760: 6e20 7468 6520 636c 6965 6e74 2063 6572  n the client cer
│ │ │ │ +00014770: 7469 6669 6361 7465 732e 0a0a 2020 2020  tificates...    
│ │ │ │ +00014780: 206a 6173 406c 6174 7465 3a7e 2420 6365   jas@latte:~$ ce
│ │ │ │ +00014790: 7274 746f 6f6c 202d 2d67 656e 6572 6174  rttool --generat
│ │ │ │ +000147a0: 652d 6365 7274 6966 6963 6174 6520 5c0a  e-certificate \.
│ │ │ │ +000147b0: 2020 2020 2020 2020 2d2d 6c6f 6164 2d63          --load-c
│ │ │ │ +000147c0: 612d 6365 7274 6966 6963 6174 6520 2f75  a-certificate /u
│ │ │ │ +000147d0: 7372 2f6c 6f63 616c 2f65 7463 2f73 6869  sr/local/etc/shi
│ │ │ │ +000147e0: 7368 692f 7368 6973 6869 2e63 6572 7420  shi/shishi.cert 
│ │ │ │ +000147f0: 5c0a 2020 2020 2020 2020 2d2d 6c6f 6164  \.        --load
│ │ │ │ +00014800: 2d63 612d 7072 6976 6b65 7920 2f75 7372  -ca-privkey /usr
│ │ │ │ +00014810: 2f6c 6f63 616c 2f65 7463 2f73 6869 7368  /local/etc/shish
│ │ │ │ +00014820: 692f 7368 6973 6869 2e6b 6579 205c 0a20  i/shishi.key \. 
│ │ │ │ +00014830: 2020 2020 2020 202d 2d6c 6f61 642d 7072         --load-pr
│ │ │ │ +00014840: 6976 6b65 7920 7e2f 2e73 6869 7368 692f  ivkey ~/.shishi/
│ │ │ │ +00014850: 636c 6965 6e74 2e6b 6579 205c 0a20 2020  client.key \.   
│ │ │ │ +00014860: 2020 2020 202d 2d6f 7574 6669 6c65 207e       --outfile ~
│ │ │ │ +00014870: 2f2e 7368 6973 6869 2f63 6c69 656e 742e  /.shishi/client.
│ │ │ │ +00014880: 6365 7274 730a 2020 2020 2047 656e 6572  certs.     Gener
│ │ │ │ +00014890: 6174 696e 6720 6120 7369 676e 6564 2063  ating a signed c
│ │ │ │ +000148a0: 6572 7469 6669 6361 7465 2e2e 2e0a 2020  ertificate....  
│ │ │ │ +000148b0: 2020 204c 6f61 6469 6e67 2043 4127 7320     Loading CA's 
│ │ │ │ +000148c0: 7072 6976 6174 6520 6b65 792e 2e2e 0a20  private key.... 
│ │ │ │ +000148d0: 2020 2020 4c6f 6164 696e 6720 4341 2773      Loading CA's
│ │ │ │ +000148e0: 2063 6572 7469 6669 6361 7465 2e2e 2e0a   certificate....
│ │ │ │ +000148f0: 2020 2020 2050 6c65 6173 6520 656e 7465       Please ente
│ │ │ │ +00014900: 7220 7468 6520 6465 7461 696c 7320 6f66  r the details of
│ │ │ │ +00014910: 2074 6865 2063 6572 7469 6669 6361 7465   the certificate
│ │ │ │ +00014920: 2773 2064 6973 7469 6e67 7569 7368 6564  's distinguished
│ │ │ │ +00014930: 206e 616d 652e 205c 0a20 2020 2020 4a75   name. \.     Ju
│ │ │ │ +00014940: 7374 2070 7265 7373 2065 6e74 6572 2074  st press enter t
│ │ │ │ +00014950: 6f20 6967 6e6f 7265 2061 2066 6965 6c64  o ignore a field
│ │ │ │ +00014960: 2e0a 2020 2020 2043 6f75 6e74 7279 206e  ..     Country n
│ │ │ │ +00014970: 616d 6520 2832 2063 6861 7273 293a 2053  ame (2 chars): S
│ │ │ │ +00014980: 450a 2020 2020 204f 7267 616e 697a 6174  E.     Organizat
│ │ │ │ +00014990: 696f 6e20 6e61 6d65 3a20 5368 6973 6869  ion name: Shishi
│ │ │ │ +000149a0: 2045 7861 6d70 6c65 2043 6c69 656e 740a   Example Client.
│ │ │ │ +000149b0: 2020 2020 204f 7267 616e 697a 6174 696f       Organizatio
│ │ │ │ +000149c0: 6e61 6c20 756e 6974 206e 616d 653a 0a20  nal unit name:. 
│ │ │ │ +000149d0: 2020 2020 4c6f 6361 6c69 7479 206e 616d      Locality nam
│ │ │ │ +000149e0: 653a 0a20 2020 2020 5374 6174 6520 6f72  e:.     State or
│ │ │ │ +000149f0: 2070 726f 7669 6e63 6520 6e61 6d65 3a0a   province name:.
│ │ │ │ +00014a00: 2020 2020 2043 6f6d 6d6f 6e20 6e61 6d65       Common name
│ │ │ │ +00014a10: 3a20 436c 6965 6e74 0a20 2020 2020 5468  : Client.     Th
│ │ │ │ +00014a20: 6973 2066 6965 6c64 2073 686f 756c 6420  is field should 
│ │ │ │ +00014a30: 6e6f 7420 6265 2075 7365 6420 696e 206e  not be used in n
│ │ │ │ +00014a40: 6577 2063 6572 7469 6669 6361 7465 732e  ew certificates.
│ │ │ │ +00014a50: 0a20 2020 2020 452d 6d61 696c 3a0a 2020  .     E-mail:.  
│ │ │ │ +00014a60: 2020 2045 6e74 6572 2074 6865 2063 6572     Enter the cer
│ │ │ │ +00014a70: 7469 6669 6361 7465 2773 2073 6572 6961  tificate's seria
│ │ │ │ +00014a80: 6c20 6e75 6d62 6572 2028 6465 6369 6d61  l number (decima
│ │ │ │ +00014a90: 6c29 3a20 300a 2020 2020 2041 6374 6976  l): 0.     Activ
│ │ │ │ +00014aa0: 6174 696f 6e2f 4578 7069 7261 7469 6f6e  ation/Expiration
│ │ │ │ +00014ab0: 2074 696d 652e 0a20 2020 2020 5468 6520   time..     The 
│ │ │ │ +00014ac0: 6765 6e65 7261 7465 6420 6365 7274 6966  generated certif
│ │ │ │ +00014ad0: 6963 6174 6520 7769 6c6c 2065 7870 6972  icate will expir
│ │ │ │ +00014ae0: 6520 696e 2028 6461 7973 293a 2031 3830  e in (days): 180
│ │ │ │ +00014af0: 0a20 2020 2020 4578 7465 6e73 696f 6e73  .     Extensions
│ │ │ │ +00014b00: 2e0a 2020 2020 2044 6f65 7320 7468 6520  ..     Does the 
│ │ │ │ +00014b10: 6365 7274 6966 6963 6174 6520 6265 6c6f  certificate belo
│ │ │ │ +00014b20: 6e67 2074 6f20 616e 2061 7574 686f 7269  ng to an authori
│ │ │ │ +00014b30: 7479 3f20 2859 2f4e 293a 206e 0a20 2020  ty? (Y/N): n.   
│ │ │ │ +00014b40: 2020 4973 2074 6869 7320 6120 7765 6220    Is this a web 
│ │ │ │ +00014b50: 7365 7276 6572 2063 6572 7469 6669 6361  server certifica
│ │ │ │ +00014b60: 7465 3f20 2859 2f4e 293a 206e 0a20 2020  te? (Y/N): n.   
│ │ │ │ +00014b70: 2020 456e 7465 7220 7468 6520 652d 6d61    Enter the e-ma
│ │ │ │ +00014b80: 696c 206f 6620 7468 6520 7375 626a 6563  il of the subjec
│ │ │ │ +00014b90: 7420 6f66 2074 6865 2063 6572 7469 6669  t of the certifi
│ │ │ │ +00014ba0: 6361 7465 3a0a 2020 2020 2058 2e35 3039  cate:.     X.509
│ │ │ │ +00014bb0: 2063 6572 7469 6669 6361 7465 2069 6e66   certificate inf
│ │ │ │ +00014bc0: 6f3a 0a20 2020 2020 5665 7273 696f 6e3a  o:.     Version:
│ │ │ │ +00014bd0: 2033 0a20 2020 2020 5365 7269 616c 204e   3.     Serial N
│ │ │ │ +00014be0: 756d 6265 7220 2868 6578 293a 2030 300a  umber (hex): 00.
│ │ │ │ +00014bf0: 2020 2020 2056 616c 6964 6974 793a 0a20       Validity:. 
│ │ │ │ +00014c00: 2020 2020 2020 2020 2020 2020 4e6f 7420              Not 
│ │ │ │ +00014c10: 4265 666f 7265 3a20 5375 6e20 4465 6320  Before: Sun Dec 
│ │ │ │ +00014c20: 3231 2031 313a 3034 3a30 3020 3230 3033  21 11:04:00 2003
│ │ │ │ +00014c30: 0a20 2020 2020 2020 2020 2020 2020 4e6f  .             No
│ │ │ │ +00014c40: 7420 4166 7465 723a 2046 7269 204a 756e  t After: Fri Jun
│ │ │ │ +00014c50: 2031 3820 3132 3a30 343a 3030 2032 3030   18 12:04:00 200
│ │ │ │ +00014c60: 340a 2020 2020 2053 7562 6a65 6374 3a20  4.     Subject: 
│ │ │ │ +00014c70: 433d 5345 2c4f 3d53 6869 7368 6920 4578  C=SE,O=Shishi Ex
│ │ │ │ +00014c80: 616d 706c 6520 436c 6965 6e74 2c43 4e3d  ample Client,CN=
│ │ │ │ +00014c90: 436c 6965 6e74 0a20 2020 2020 5375 626a  Client.     Subj
│ │ │ │ +00014ca0: 6563 7420 5075 626c 6963 204b 6579 2049  ect Public Key I
│ │ │ │ +00014cb0: 6e66 6f3a 0a20 2020 2020 2020 2020 2020  nfo:.           
│ │ │ │ +00014cc0: 2020 5075 626c 6963 204b 6579 2041 6c67    Public Key Alg
│ │ │ │ +00014cd0: 6f72 6974 686d 3a20 5253 410a 2020 2020  orithm: RSA.    
│ │ │ │ +00014ce0: 2058 2e35 3039 2045 7874 656e 7369 6f6e   X.509 Extension
│ │ │ │ +00014cf0: 733a 0a20 2020 2020 2020 2020 2020 2020  s:.             
│ │ │ │ +00014d00: 4261 7369 6320 436f 6e73 7472 6169 6e74  Basic Constraint
│ │ │ │ +00014d10: 733a 2028 6372 6974 6963 616c 290a 2020  s: (critical).  
│ │ │ │  00014d20: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00014d30: 2043 413a 4641 4c53 450a 2020 2020 2049   CA:FALSE.     I
│ │ │ │ -00014d40: 7320 7468 6520 6162 6f76 6520 696e 666f  s the above info
│ │ │ │ -00014d50: 726d 6174 696f 6e20 6f6b 3f20 2859 2f4e  rmation ok? (Y/N
│ │ │ │ -00014d60: 293a 2079 0a20 2020 2020 5369 676e 696e  ): y.     Signin
│ │ │ │ -00014d70: 6720 6365 7274 6966 6963 6174 652e 2e2e  g certificate...
│ │ │ │ -00014d80: 0a20 2020 2020 6a61 7340 6c61 7474 653a  .     jas@latte:
│ │ │ │ -00014d90: 7e24 0a0a 332e 362e 332e 3420 5374 6172  ~$..3.6.3.4 Star
│ │ │ │ -00014da0: 7469 6e67 204b 4443 2077 6974 6820 582e  ting KDC with X.
│ │ │ │ -00014db0: 3530 3920 6175 7468 656e 7469 6361 7469  509 authenticati
│ │ │ │ -00014dc0: 6f6e 2073 7570 706f 7274 0a2e 2e2e 2e2e  on support......
│ │ │ │ +00014d30: 2020 2043 413a 4641 4c53 450a 2020 2020     CA:FALSE.    
│ │ │ │ +00014d40: 2049 7320 7468 6520 6162 6f76 6520 696e   Is the above in
│ │ │ │ +00014d50: 666f 726d 6174 696f 6e20 6f6b 3f20 2859  formation ok? (Y
│ │ │ │ +00014d60: 2f4e 293a 2079 0a20 2020 2020 5369 676e  /N): y.     Sign
│ │ │ │ +00014d70: 696e 6720 6365 7274 6966 6963 6174 652e  ing certificate.
│ │ │ │ +00014d80: 2e2e 0a20 2020 2020 6a61 7340 6c61 7474  ...     jas@latt
│ │ │ │ +00014d90: 653a 7e24 0a0a 332e 362e 332e 3420 5374  e:~$..3.6.3.4 St
│ │ │ │ +00014da0: 6172 7469 6e67 204b 4443 2077 6974 6820  arting KDC with 
│ │ │ │ +00014db0: 582e 3530 3920 6175 7468 656e 7469 6361  X.509 authentica
│ │ │ │ +00014dc0: 7469 6f6e 2073 7570 706f 7274 0a2e 2e2e  tion support....
│ │ │ │  00014dd0: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e  ................
│ │ │ │  00014de0: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e  ................
│ │ │ │  00014df0: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e  ................
│ │ │ │ -00014e00: 2e0a 0a54 6865 204b 4443 206e 6565 6420  ...The KDC need 
│ │ │ │ -00014e10: 7468 6520 4341 2063 6572 7469 6669 6361  the CA certifica
│ │ │ │ -00014e20: 7465 2028 746f 2076 6572 6966 7920 636c  te (to verify cl
│ │ │ │ -00014e30: 6965 6e74 2063 6572 7469 6669 6361 7465  ient certificate
│ │ │ │ -00014e40: 7329 2061 6e64 2074 6865 0a73 6572 7665  s) and the.serve
│ │ │ │ -00014e50: 7220 6365 7274 6966 6963 6174 6520 616e  r certificate an
│ │ │ │ -00014e60: 6420 6b65 7920 2874 6f20 6175 7468 656e  d key (to authen
│ │ │ │ -00014e70: 7469 6361 7465 2069 7473 656c 6620 746f  ticate itself to
│ │ │ │ -00014e80: 2074 6865 2063 6c69 656e 7473 292e 2020   the clients).  
│ │ │ │ -00014e90: 5365 650a 656c 7365 7768 6572 6520 282a  See.elsewhere (*
│ │ │ │ -00014ea0: 6e6f 7465 2050 6172 616d 6574 6572 7320  note Parameters 
│ │ │ │ -00014eb0: 666f 7220 7368 6973 6869 643a 3a29 2066  for shishid::) f
│ │ │ │ -00014ec0: 6f72 2074 6865 2065 6e74 6972 6520 6465  or the entire de
│ │ │ │ -00014ed0: 7363 7269 7074 696f 6e20 6f66 0a74 6865  scription of.the
│ │ │ │ -00014ee0: 2070 6172 616d 6574 6572 732e 0a0a 2020   parameters...  
│ │ │ │ -00014ef0: 2020 206a 6173 406c 6174 7465 3a7e 2420     jas@latte:~$ 
│ │ │ │ -00014f00: 7368 6973 6869 6420 2d6c 202a 3a34 3731  shishid -l *:471
│ │ │ │ -00014f10: 312f 7463 7020 5c0a 2020 2020 2020 2020  1/tcp \.        
│ │ │ │ -00014f20: 2d2d 7835 3039 6361 6669 6c65 202f 7573  --x509cafile /us
│ │ │ │ -00014f30: 722f 6c6f 6361 6c2f 6574 632f 7368 6973  r/local/etc/shis
│ │ │ │ -00014f40: 6869 2f73 6869 7368 692e 6365 7274 205c  hi/shishi.cert \
│ │ │ │ -00014f50: 0a20 2020 2020 2020 202d 2d78 3530 3963  .        --x509c
│ │ │ │ -00014f60: 6572 7466 696c 6520 2f75 7372 2f6c 6f63  ertfile /usr/loc
│ │ │ │ -00014f70: 616c 2f65 7463 2f73 6869 7368 692f 7368  al/etc/shishi/sh
│ │ │ │ -00014f80: 6973 6869 642e 6365 7274 205c 0a20 2020  ishid.cert \.   
│ │ │ │ -00014f90: 2020 2020 202d 2d78 3530 396b 6579 6669       --x509keyfi
│ │ │ │ -00014fa0: 6c65 202f 7573 722f 6c6f 6361 6c2f 6574  le /usr/local/et
│ │ │ │ -00014fb0: 632f 7368 6973 6869 2f73 6869 7368 6964  c/shishi/shishid
│ │ │ │ -00014fc0: 2e6b 6579 0a20 2020 2020 496e 6974 6961  .key.     Initia
│ │ │ │ -00014fd0: 6c69 7a69 6e67 2047 4e55 544c 532e 2e2e  lizing GNUTLS...
│ │ │ │ -00014fe0: 0a20 2020 2020 5061 7273 6564 2031 2043  .     Parsed 1 C
│ │ │ │ -00014ff0: 4173 2e2e 2e0a 2020 2020 204c 6f61 6465  As....     Loade
│ │ │ │ -00015000: 6420 7365 7276 6572 2063 6572 7469 6669  d server certifi
│ │ │ │ -00015010: 6361 7465 2f6b 6579 2e2e 2e0a 2020 2020  cate/key....    
│ │ │ │ -00015020: 2047 656e 6572 6174 696e 6720 4469 6666   Generating Diff
│ │ │ │ -00015030: 6965 2d48 656c 6c6d 616e 2070 6172 616d  ie-Hellman param
│ │ │ │ -00015040: 6574 6572 732e 2e2e 0a20 2020 2020 496e  eters....     In
│ │ │ │ -00015050: 6974 6961 6c69 7a69 6e67 2047 4e55 544c  itializing GNUTL
│ │ │ │ -00015060: 532e 2e2e 646f 6e65 0a20 2020 2020 4c69  S...done.     Li
│ │ │ │ -00015070: 7374 656e 696e 6720 6f6e 202a 3a34 3731  stening on *:471
│ │ │ │ -00015080: 312f 7463 702e 2e2e 0a20 2020 2020 4c69  1/tcp....     Li
│ │ │ │ -00015090: 7374 656e 696e 6720 6f6e 2031 2070 6f72  stening on 1 por
│ │ │ │ -000150a0: 7473 2e2e 2e0a 2020 2020 2073 6869 7368  ts....     shish
│ │ │ │ -000150b0: 6964 3a20 5374 6172 7469 6e67 2028 474e  id: Starting (GN
│ │ │ │ -000150c0: 5554 4c53 2060 312e 302e 3427 290a 2020  UTLS `1.0.4').  
│ │ │ │ -000150d0: 2020 2073 6869 7368 6964 3a20 4c69 7374     shishid: List
│ │ │ │ -000150e0: 656e 696e 6720 6f6e 202a 3a34 3731 312f  ening on *:4711/
│ │ │ │ -000150f0: 7463 7020 736f 636b 6574 2034 0a0a 2020  tcp socket 4..  
│ │ │ │ -00015100: 2054 6865 6e20 6163 7175 6972 6520 7469   Then acquire ti
│ │ │ │ -00015110: 636b 6574 7320 6173 2075 7375 616c 2e20  ckets as usual. 
│ │ │ │ -00015120: 2049 6e20 6361 7365 2079 6f75 2077 6f6e   In case you won
│ │ │ │ -00015130: 6465 7220 686f 7720 7368 6973 6869 2066  der how shishi f
│ │ │ │ -00015140: 696e 6473 0a74 6865 2063 6c69 656e 7420  inds.the client 
│ │ │ │ -00015150: 6365 7274 6966 6963 6174 6520 616e 6420  certificate and 
│ │ │ │ -00015160: 6b65 792c 2074 6865 2066 696c 656e 616d  key, the filenam
│ │ │ │ -00015170: 6573 2075 7365 6420 6162 6f76 6520 7768  es used above wh
│ │ │ │ -00015180: 656e 2067 656e 6572 6174 696e 670a 7468  en generating.th
│ │ │ │ -00015190: 6520 636c 6965 6e74 2063 6572 7469 6669  e client certifi
│ │ │ │ -000151a0: 6361 7465 7320 6861 7070 656e 2074 6f20  cates happen to 
│ │ │ │ -000151b0: 6265 2074 6865 2064 6566 6175 6c74 2066  be the default f
│ │ │ │ -000151c0: 696c 656e 616d 6573 2066 6f72 2074 6865  ilenames for the
│ │ │ │ -000151d0: 7365 0a66 696c 6573 2e20 2053 6f20 6974  se.files.  So it
│ │ │ │ -000151e0: 2070 6963 6b20 7468 656d 2075 7020 6175   pick them up au
│ │ │ │ -000151f0: 746f 6d61 7469 6361 6c6c 792e 0a0a 2020  tomatically...  
│ │ │ │ -00015200: 2020 206a 6173 406c 6174 7465 3a7e 2420     jas@latte:~$ 
│ │ │ │ -00015210: 7368 6973 6869 202d 6f20 2772 6561 6c6d  shishi -o 'realm
│ │ │ │ -00015220: 2d6b 6463 3d45 5841 4d50 4c45 2e4f 5247  -kdc=EXAMPLE.ORG
│ │ │ │ -00015230: 2c6c 6f63 616c 686f 7374 3a34 3731 312f  ,localhost:4711/
│ │ │ │ -00015240: 746c 7327 205c 0a20 2020 2020 2020 2073  tls' \.        s
│ │ │ │ -00015250: 696d 6f6e 4045 5841 4d50 4c45 2e4f 5247  imon@EXAMPLE.ORG
│ │ │ │ -00015260: 0a20 2020 2020 456e 7465 7220 7061 7373  .     Enter pass
│ │ │ │ -00015270: 776f 7264 2066 6f72 2060 7369 6d6f 6e40  word for `simon@
│ │ │ │ -00015280: 4558 414d 504c 452e 4f52 4727 3a0a 2020  EXAMPLE.ORG':.  
│ │ │ │ -00015290: 2020 2073 696d 6f6e 4045 5841 4d50 4c45     simon@EXAMPLE
│ │ │ │ -000152a0: 2e4f 5247 3a0a 2020 2020 2041 7574 6874  .ORG:.     Autht
│ │ │ │ -000152b0: 696d 653a 2020 2020 2020 2053 756e 2044  ime:       Sun D
│ │ │ │ -000152c0: 6563 2032 3120 3131 3a31 353a 3437 2032  ec 21 11:15:47 2
│ │ │ │ -000152d0: 3030 330a 2020 2020 2045 6e64 7469 6d65  003.     Endtime
│ │ │ │ -000152e0: 3a20 2020 2020 2020 2053 756e 2044 6563  :        Sun Dec
│ │ │ │ -000152f0: 2032 3120 3131 3a33 323a 3237 2032 3030   21 11:32:27 200
│ │ │ │ -00015300: 330a 2020 2020 2053 6572 7665 723a 2020  3.     Server:  
│ │ │ │ -00015310: 2020 2020 2020 206b 7262 7467 742f 4558         krbtgt/EX
│ │ │ │ -00015320: 414d 504c 452e 4f52 4720 6b65 7920 6165  AMPLE.ORG key ae
│ │ │ │ -00015330: 7332 3536 2d63 7473 2d68 6d61 632d 7368  s256-cts-hmac-sh
│ │ │ │ -00015340: 6131 2d39 3620 2831 3829 0a20 2020 2020  a1-96 (18).     
│ │ │ │ -00015350: 5469 636b 6574 206b 6579 3a20 2020 2020  Ticket key:     
│ │ │ │ -00015360: 6165 7332 3536 2d63 7473 2d68 6d61 632d  aes256-cts-hmac-
│ │ │ │ -00015370: 7368 6131 2d39 3620 2831 3829 2070 726f  sha1-96 (18) pro
│ │ │ │ -00015380: 7465 6374 6564 2062 7920 6165 7332 3536  tected by aes256
│ │ │ │ -00015390: 2d63 7473 2d68 6d61 632d 7368 6131 2d39  -cts-hmac-sha1-9
│ │ │ │ -000153a0: 3620 2831 3829 0a20 2020 2020 5469 636b  6 (18).     Tick
│ │ │ │ -000153b0: 6574 2066 6c61 6773 3a20 2020 464f 5257  et flags:   FORW
│ │ │ │ -000153c0: 4152 4445 4420 5052 4f58 4941 424c 4520  ARDED PROXIABLE 
│ │ │ │ -000153d0: 5245 4e45 5741 424c 4520 4857 4155 5448  RENEWABLE HWAUTH
│ │ │ │ -000153e0: 454e 5420 5452 414e 5349 5445 4450 4f4c  ENT TRANSITEDPOL
│ │ │ │ -000153f0: 4943 5943 4845 434b 4544 204f 4b41 5344  ICYCHECKED OKASD
│ │ │ │ -00015400: 454c 4547 4154 4520 2831 3229 0a20 2020  ELEGATE (12).   
│ │ │ │ -00015410: 2020 6a61 7340 6c61 7474 653a 7e24 0a0a    jas@latte:~$..
│ │ │ │ -00015420: 2020 2048 6572 6520 6973 2077 6861 7420     Here is what 
│ │ │ │ -00015430: 7468 6520 7365 7276 6572 2077 6f75 6c64  the server would
│ │ │ │ -00015440: 2070 7269 6e74 2e0a 0a20 2020 2020 7368   print...     sh
│ │ │ │ -00015450: 6973 6869 643a 2041 6363 6570 7465 6420  ishid: Accepted 
│ │ │ │ -00015460: 736f 636b 6574 2036 2066 726f 6d20 736f  socket 6 from so
│ │ │ │ -00015470: 636b 6574 2034 2061 7320 2a3a 3437 3131  cket 4 as *:4711
│ │ │ │ -00015480: 2f74 6370 2070 6565 7220 3132 372e 302e  /tcp peer 127.0.
│ │ │ │ -00015490: 302e 310a 2020 2020 2073 6869 7368 6964  0.1.     shishid
│ │ │ │ -000154a0: 3a20 4c69 7374 656e 696e 6720 6f6e 202a  : Listening on *
│ │ │ │ -000154b0: 3a34 3731 312f 7463 7020 736f 636b 6574  :4711/tcp socket
│ │ │ │ -000154c0: 2034 0a20 2020 2020 7368 6973 6869 643a   4.     shishid:
│ │ │ │ -000154d0: 204c 6973 7465 6e69 6e67 206f 6e20 2a3a   Listening on *:
│ │ │ │ -000154e0: 3437 3131 2f74 6370 2070 6565 7220 3132  4711/tcp peer 12
│ │ │ │ -000154f0: 372e 302e 302e 3120 736f 636b 6574 2036  7.0.0.1 socket 6
│ │ │ │ -00015500: 0a20 2020 2020 7368 6973 6869 643a 2048  .     shishid: H
│ │ │ │ -00015510: 6173 2034 2062 7974 6573 2066 726f 6d20  as 4 bytes from 
│ │ │ │ -00015520: 2a3a 3437 3131 2f74 6370 2070 6565 7220  *:4711/tcp peer 
│ │ │ │ -00015530: 3132 372e 302e 302e 3120 6f6e 2073 6f63  127.0.0.1 on soc
│ │ │ │ -00015540: 6b65 7420 360a 2020 2020 2073 6869 7368  ket 6.     shish
│ │ │ │ -00015550: 6964 3a20 5472 7969 6e67 2053 5441 5254  id: Trying START
│ │ │ │ -00015560: 544c 530a 2020 2020 2073 6869 7368 6964  TLS.     shishid
│ │ │ │ -00015570: 3a20 544c 5320 6861 6e64 7368 616b 6520  : TLS handshake 
│ │ │ │ -00015580: 6e65 676f 7469 6174 6564 2070 726f 746f  negotiated proto
│ │ │ │ -00015590: 636f 6c20 6054 4c53 2031 2e30 272c 206b  col `TLS 1.0', k
│ │ │ │ -000155a0: 6579 2065 7863 6861 6e67 6520 6052 5341  ey exchange `RSA
│ │ │ │ -000155b0: 272c 2063 6572 7469 6669 6361 7465 2074  ', certificate t
│ │ │ │ -000155c0: 7970 6520 6058 2e35 3039 272c 2063 6970  ype `X.509', cip
│ │ │ │ -000155d0: 6865 7220 6041 4553 2032 3536 2043 4243  her `AES 256 CBC
│ │ │ │ -000155e0: 272c 206d 6163 2060 5348 4127 2c20 636f  ', mac `SHA', co
│ │ │ │ -000155f0: 6d70 7265 7373 696f 6e20 604e 554c 4c27  mpression `NULL'
│ │ │ │ -00015600: 2c20 7365 7373 696f 6e20 6e6f 7420 7265  , session not re
│ │ │ │ -00015610: 7375 6d65 640a 2020 2020 2073 6869 7368  sumed.     shish
│ │ │ │ -00015620: 6964 3a20 544c 5320 636c 6965 6e74 2063  id: TLS client c
│ │ │ │ -00015630: 6572 7469 6669 6361 7465 2060 433d 5345  ertificate `C=SE
│ │ │ │ -00015640: 2c4f 3d53 6869 7368 6920 4578 616d 706c  ,O=Shishi Exampl
│ │ │ │ -00015650: 6520 436c 6965 6e74 2c43 4e3d 436c 6965  e Client,CN=Clie
│ │ │ │ -00015660: 6e74 272c 2069 7373 7565 6420 6279 2060  nt', issued by `
│ │ │ │ -00015670: 433d 5345 2c4f 3d53 6869 7368 6920 4578  C=SE,O=Shishi Ex
│ │ │ │ -00015680: 616d 706c 6520 4341 2c43 4e3d 4341 272c  ample CA,CN=CA',
│ │ │ │ -00015690: 2073 6572 6961 6c20 6e75 6d62 6572 2060   serial number `
│ │ │ │ -000156a0: 3030 272c 204d 4435 2066 696e 6765 7270  00', MD5 fingerp
│ │ │ │ -000156b0: 7269 6e74 2060 6135 3a64 333a 3166 3a35  rint `a5:d3:1f:5
│ │ │ │ -000156c0: 383a 3736 3a65 333a 3538 3a63 643a 3264  8:76:e3:58:cd:2d
│ │ │ │ -000156d0: 3a65 623a 6637 3a34 353a 6132 3a34 623a  :eb:f7:45:a2:4b:
│ │ │ │ -000156e0: 3532 3a66 393a 272c 2061 6374 6976 6174  52:f9:', activat
│ │ │ │ -000156f0: 6564 2060 5375 6e20 4465 6320 3231 2031  ed `Sun Dec 21 1
│ │ │ │ -00015700: 313a 3034 3a30 3020 3230 3033 272c 2065  1:04:00 2003', e
│ │ │ │ -00015710: 7870 6972 6573 2060 4672 6920 4a75 6e20  xpires `Fri Jun 
│ │ │ │ -00015720: 3138 2031 323a 3034 3a30 3020 3230 3034  18 12:04:00 2004
│ │ │ │ -00015730: 272c 2076 6572 7369 6f6e 2023 332c 206b  ', version #3, k
│ │ │ │ -00015740: 6579 2052 5341 206d 6f64 756c 7573 2031  ey RSA modulus 1
│ │ │ │ -00015750: 3032 3420 6269 7473 2c20 6375 7272 656e  024 bits, curren
│ │ │ │ -00015760: 746c 7920 4558 5049 5245 440a 2020 2020  tly EXPIRED.    
│ │ │ │ -00015770: 2073 6869 7368 6964 3a20 4c69 7374 656e   shishid: Listen
│ │ │ │ -00015780: 696e 6720 6f6e 202a 3a34 3731 312f 7463  ing on *:4711/tc
│ │ │ │ -00015790: 7020 736f 636b 6574 2034 0a20 2020 2020  p socket 4.     
│ │ │ │ -000157a0: 7368 6973 6869 643a 204c 6973 7465 6e69  shishid: Listeni
│ │ │ │ -000157b0: 6e67 206f 6e20 2a3a 3437 3131 2f74 6370  ng on *:4711/tcp
│ │ │ │ -000157c0: 2070 6565 7220 3132 372e 302e 302e 3120   peer 127.0.0.1 
│ │ │ │ -000157d0: 736f 636b 6574 2036 0a20 2020 2020 7368  socket 6.     sh
│ │ │ │ -000157e0: 6973 6869 643a 2048 6173 2031 3331 2062  ishid: Has 131 b
│ │ │ │ -000157f0: 7974 6573 2066 726f 6d20 2a3a 3437 3131  ytes from *:4711
│ │ │ │ -00015800: 2f74 6370 2070 6565 7220 3132 372e 302e  /tcp peer 127.0.
│ │ │ │ -00015810: 302e 3120 6f6e 2073 6f63 6b65 7420 360a  0.1 on socket 6.
│ │ │ │ -00015820: 2020 2020 2073 6869 7368 6964 3a20 5072       shishid: Pr
│ │ │ │ -00015830: 6f63 6573 7369 6e67 2031 3331 2066 726f  ocessing 131 fro
│ │ │ │ -00015840: 6d20 2a3a 3437 3131 2f74 6370 2070 6565  m *:4711/tcp pee
│ │ │ │ -00015850: 7220 3132 372e 302e 302e 3120 6f6e 2073  r 127.0.0.1 on s
│ │ │ │ -00015860: 6f63 6b65 7420 360a 2020 2020 2073 6869  ocket 6.     shi
│ │ │ │ -00015870: 7368 6964 3a20 5472 7969 6e67 2041 532d  shid: Trying AS-
│ │ │ │ -00015880: 5245 510a 2020 2020 2073 6869 7368 6964  REQ.     shishid
│ │ │ │ -00015890: 3a20 4153 2d52 4551 2066 726f 6d20 7369  : AS-REQ from si
│ │ │ │ -000158a0: 6d6f 6e40 4558 414d 504c 452e 4f52 4720  mon@EXAMPLE.ORG 
│ │ │ │ -000158b0: 666f 7220 6b72 6274 6774 2f45 5841 4d50  for krbtgt/EXAMP
│ │ │ │ -000158c0: 4c45 2e4f 5247 4045 5841 4d50 4c45 2e4f  LE.ORG@EXAMPLE.O
│ │ │ │ -000158d0: 5247 0a20 2020 2020 7368 6973 6869 643a  RG.     shishid:
│ │ │ │ -000158e0: 204d 6174 6368 696e 6720 636c 6965 6e74   Matching client
│ │ │ │ -000158f0: 2065 7479 7065 2031 3820 6167 6169 6e73   etype 18 agains
│ │ │ │ -00015900: 7420 7573 6572 206b 6579 2065 7479 7065  t user key etype
│ │ │ │ -00015910: 2031 380a 2020 2020 2073 6869 7368 6964   18.     shishid
│ │ │ │ -00015920: 3a20 4861 7665 2035 3131 2062 7974 6573  : Have 511 bytes
│ │ │ │ -00015930: 2066 6f72 202a 3a34 3731 312f 7463 7020   for *:4711/tcp 
│ │ │ │ -00015940: 7065 6572 2031 3237 2e30 2e30 2e31 206f  peer 127.0.0.1 o
│ │ │ │ -00015950: 6e20 736f 636b 6574 2036 0a20 2020 2020  n socket 6.     
│ │ │ │ -00015960: 7368 6973 6869 643a 2053 656e 6469 6e67  shishid: Sending
│ │ │ │ -00015970: 2035 3131 2062 7974 6573 2074 6f20 2a3a   511 bytes to *:
│ │ │ │ -00015980: 3437 3131 2f74 6370 2070 6565 7220 3132  4711/tcp peer 12
│ │ │ │ -00015990: 372e 302e 302e 3120 736f 636b 6574 2036  7.0.0.1 socket 6
│ │ │ │ -000159a0: 2076 6961 2054 4c53 0a20 2020 2020 7368   via TLS.     sh
│ │ │ │ -000159b0: 6973 6869 643a 204c 6973 7465 6e69 6e67  ishid: Listening
│ │ │ │ -000159c0: 206f 6e20 2a3a 3437 3131 2f74 6370 2073   on *:4711/tcp s
│ │ │ │ -000159d0: 6f63 6b65 7420 340a 2020 2020 2073 6869  ocket 4.     shi
│ │ │ │ -000159e0: 7368 6964 3a20 4c69 7374 656e 696e 6720  shid: Listening 
│ │ │ │ -000159f0: 6f6e 202a 3a34 3731 312f 7463 7020 7065  on *:4711/tcp pe
│ │ │ │ -00015a00: 6572 2031 3237 2e30 2e30 2e31 2073 6f63  er 127.0.0.1 soc
│ │ │ │ -00015a10: 6b65 7420 360a 2020 2020 2073 6869 7368  ket 6.     shish
│ │ │ │ -00015a20: 6964 3a20 5065 6572 202a 3a34 3731 312f  id: Peer *:4711/
│ │ │ │ -00015a30: 7463 7020 7065 6572 2031 3237 2e30 2e30  tcp peer 127.0.0
│ │ │ │ -00015a40: 2e31 2064 6973 636f 6e6e 6563 7465 6420  .1 disconnected 
│ │ │ │ -00015a50: 6f6e 2073 6f63 6b65 7420 360a 2020 2020  on socket 6.    
│ │ │ │ -00015a60: 2073 6869 7368 6964 3a20 436c 6f73 696e   shishid: Closin
│ │ │ │ -00015a70: 6720 2a3a 3437 3131 2f74 6370 2070 6565  g *:4711/tcp pee
│ │ │ │ -00015a80: 7220 3132 372e 302e 302e 3120 736f 636b  r 127.0.0.1 sock
│ │ │ │ -00015a90: 6574 2036 0a20 2020 2020 7368 6973 6869  et 6.     shishi
│ │ │ │ -00015aa0: 643a 204c 6973 7465 6e69 6e67 206f 6e20  d: Listening on 
│ │ │ │ -00015ab0: 2a3a 3437 3131 2f74 6370 2073 6f63 6b65  *:4711/tcp socke
│ │ │ │ -00015ac0: 7420 340a 0a1f 0a46 696c 653a 2073 6869  t 4....File: shi
│ │ │ │ -00015ad0: 7368 692e 696e 666f 2c20 204e 6f64 653a  shi.info,  Node:
│ │ │ │ -00015ae0: 204d 756c 7469 706c 6520 7365 7276 6572   Multiple server
│ │ │ │ -00015af0: 732c 2020 4e65 7874 3a20 4465 7665 6c6f  s,  Next: Develo
│ │ │ │ -00015b00: 7065 7220 696e 666f 726d 6174 696f 6e2c  per information,
│ │ │ │ -00015b10: 2020 5072 6576 3a20 4b65 7262 6572 6f73    Prev: Kerberos
│ │ │ │ -00015b20: 2076 6961 2054 4c53 2c20 2055 703a 2041   via TLS,  Up: A
│ │ │ │ -00015b30: 646d 696e 6973 7472 6174 696f 6e20 4d61  dministration Ma
│ │ │ │ -00015b40: 6e75 616c 0a0a 332e 3720 4d75 6c74 6970  nual..3.7 Multip
│ │ │ │ -00015b50: 6c65 2073 6572 7665 7273 0a3d 3d3d 3d3d  le servers.=====
│ │ │ │ -00015b60: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a  ===============.
│ │ │ │ -00015b70: 0a53 6574 7469 6e67 2075 7020 6d75 6c74  .Setting up mult
│ │ │ │ -00015b80: 6970 6c65 2073 6572 7665 7273 2069 7320  iple servers is 
│ │ │ │ -00015b90: 6173 2065 6173 7920 6173 2072 6570 6c69  as easy as repli
│ │ │ │ -00015ba0: 6361 7469 6e67 2074 6865 2075 7365 7220  cating the user 
│ │ │ │ -00015bb0: 6461 7461 6261 7365 2e0a 5369 6e63 6520  database..Since 
│ │ │ │ -00015bc0: 7468 6520 6465 6661 756c 7420 e280 9866  the default ...f
│ │ │ │ -00015bd0: 696c 65e2 8099 2075 7365 7220 6461 7461  ile... user data
│ │ │ │ -00015be0: 6261 7365 2069 7320 7374 6f72 6564 2069  base is stored i
│ │ │ │ -00015bf0: 6e20 7468 6520 6e6f 726d 616c 2066 696c  n the normal fil
│ │ │ │ -00015c00: 650a 7379 7374 656d 2c20 796f 7520 6361  e.system, you ca
│ │ │ │ -00015c10: 6e20 7573 6520 616e 7920 636f 6d6d 6f6e  n use any common
│ │ │ │ -00015c20: 2074 6f6f 6c73 2074 6f20 7265 706c 6963   tools to replic
│ │ │ │ -00015c30: 6174 6520 6120 6669 6c65 2073 7973 7465  ate a file syste
│ │ │ │ -00015c40: 6d2e 0a4e 6574 776f 726b 2066 696c 6520  m..Network file 
│ │ │ │ -00015c50: 7379 7374 656d 206c 696b 6520 4e46 5320  system like NFS 
│ │ │ │ -00015c60: 2870 726f 7065 726c 7920 7365 6375 7265  (properly secure
│ │ │ │ -00015c70: 6420 6279 2c20 652e 672e 2c20 610a 706f  d by, e.g., a.po
│ │ │ │ -00015c80: 696e 742d 746f 2d70 6f69 6e74 2073 796d  int-to-point sym
│ │ │ │ -00015c90: 6d65 7472 6963 616c 6c79 2065 6e63 7279  metrically encry
│ │ │ │ -00015ca0: 7074 6564 2049 5053 4543 2063 6f6e 6e65  pted IPSEC conne
│ │ │ │ -00015cb0: 6374 696f 6e29 2061 6e64 2066 696c 650a  ction) and file.
│ │ │ │ -00015cc0: 7379 6e63 6872 6f6e 697a 696e 6720 746f  synchronizing to
│ │ │ │ -00015cd0: 6f6c 7320 6c69 6b65 20e2 8098 7273 796e  ols like ...rsyn
│ │ │ │ -00015ce0: 63e2 8099 2061 7265 2074 7970 6963 616c  c... are typical
│ │ │ │ -00015cf0: 2063 686f 6963 6573 2e0a 0a20 2020 5468   choices...   Th
│ │ │ │ -00015d00: 6520 7365 636f 6e64 6172 7920 7365 7276  e secondary serv
│ │ │ │ -00015d10: 6572 2073 686f 756c 6420 6265 2063 6f6e  er should be con
│ │ │ │ -00015d20: 6669 6775 7265 6420 6a75 7374 206c 696b  figured just lik
│ │ │ │ -00015d30: 6520 7468 6520 6d61 7374 6572 0a73 6572  e the master.ser
│ │ │ │ -00015d40: 7665 722e 2020 4966 2079 6f75 2075 7365  ver.  If you use
│ │ │ │ -00015d50: 2074 6865 20e2 8098 6669 6c65 e280 9920   the ...file... 
│ │ │ │ -00015d60: 6461 7461 6261 7365 206f 7665 7220 4e46  database over NF
│ │ │ │ -00015d70: 5320 796f 7520 646f 206e 6f74 2068 6176  S you do not hav
│ │ │ │ -00015d80: 6520 746f 206d 616b 650a 616e 7920 6d6f  e to make.any mo
│ │ │ │ -00015d90: 6469 6669 6361 7469 6f6e 732e 2020 4966  difications.  If
│ │ │ │ -00015da0: 2079 6f75 2075 7365 2c20 652e 672e 2c20   you use, e.g., 
│ │ │ │ -00015db0: 6120 6372 6f6e 206a 6f62 2074 6f20 e280  a cron job to ..
│ │ │ │ -00015dc0: 9872 7379 6e63 e280 9920 7468 650a 6469  .rsync... the.di
│ │ │ │ -00015dd0: 7265 6374 6f72 7920 6576 6572 7920 686f  rectory every ho
│ │ │ │ -00015de0: 7572 206f 7220 736f 2c20 796f 7520 6d61  ur or so, you ma
│ │ │ │ -00015df0: 7920 7761 6e74 2074 6f20 6164 6420 6120  y want to add a 
│ │ │ │ -00015e00: e280 982d 2d72 6561 642d 6f6e 6c79 e280  ...--read-only..
│ │ │ │ -00015e10: 9920 666c 6167 2074 6f0a 7468 6520 5368  . flag to.the Sh
│ │ │ │ -00015e20: 6973 6120 e280 9864 62e2 8099 2064 6566  isa ...db... def
│ │ │ │ -00015e30: 696e 6974 696f 6e20 282a 6e6f 7465 2053  inition (*note S
│ │ │ │ -00015e40: 6869 7361 2043 6f6e 6669 6775 7261 7469  hisa Configurati
│ │ │ │ -00015e50: 6f6e 3a3a 292e 2020 5468 6174 2077 6179  on::).  That way
│ │ │ │ -00015e60: 2c0a 6e6f 626f 6479 2077 696c 6c20 6265  ,.nobody will be
│ │ │ │ -00015e70: 206c 7572 6564 2069 6e74 6f20 6372 6561   lured into crea
│ │ │ │ -00015e80: 7469 6e67 206f 7220 6368 616e 6769 6e67  ting or changing
│ │ │ │ -00015e90: 2069 6e66 6f72 6d61 7469 6f6e 2069 6e20   information in 
│ │ │ │ -00015ea0: 7468 650a 6461 7461 6261 7365 206f 6e20  the.database on 
│ │ │ │ -00015eb0: 7468 6520 7365 636f 6e64 6172 7920 7365  the secondary se
│ │ │ │ -00015ec0: 7276 6572 2c20 7768 6963 6820 6f6e 6c79  rver, which only
│ │ │ │ -00015ed0: 2077 6f75 6c64 2062 6520 6f76 6572 7772   would be overwr
│ │ │ │ -00015ee0: 6974 7465 6e20 6475 7269 6e67 0a74 6865  itten during.the
│ │ │ │ -00015ef0: 206e 6578 7420 7379 6e63 6872 6f6e 697a   next synchroniz
│ │ │ │ -00015f00: 6174 696f 6e2e 0a0a 2020 2020 2064 6220  ation...     db 
│ │ │ │ -00015f10: 2d2d 7265 6164 2d6f 6e6c 7920 6669 6c65  --read-only file
│ │ │ │ -00015f20: 202f 7573 722f 6c6f 6361 6c2f 7661 722f   /usr/local/var/
│ │ │ │ -00015f30: 6261 636b 7570 2d73 6869 7368 690a 0a20  backup-shishi.. 
│ │ │ │ -00015f40: 2020 5468 6520 e280 9866 696c 65e2 8099    The ...file...
│ │ │ │ -00015f50: 2064 6174 6162 6173 6520 6973 2064 6573   database is des
│ │ │ │ -00015f60: 6967 6e65 6420 736f 2069 7420 646f 6573  igned so it does
│ │ │ │ -00015f70: 6e27 7420 7265 7175 6972 6520 6669 6c65  n't require file
│ │ │ │ -00015f80: 206c 6f63 6b69 6e67 2069 6e0a 7468 6520   locking in.the 
│ │ │ │ -00015f90: 6669 6c65 2073 7973 7465 6d2c 2077 6869  file system, whi
│ │ │ │ -00015fa0: 6368 206d 6179 2062 6520 756e 7265 6c69  ch may be unreli
│ │ │ │ -00015fb0: 6162 6c65 2069 6e20 736f 6d65 206e 6574  able in some net
│ │ │ │ -00015fc0: 776f 726b 2066 696c 6520 7379 7374 656d  work file system
│ │ │ │ -00015fd0: 7320 6f72 0a69 6d70 6c65 6d65 6e74 6174  s or.implementat
│ │ │ │ -00015fe0: 696f 6e73 2e20 2049 7420 6973 2061 6c73  ions.  It is als
│ │ │ │ -00015ff0: 6f20 6465 7369 676e 6564 2073 6f20 7468  o designed so th
│ │ │ │ -00016000: 6174 206d 756c 7469 706c 6520 636f 6e63  at multiple conc
│ │ │ │ -00016010: 7572 7265 6e74 0a72 6561 6465 7273 2061  urrent.readers a
│ │ │ │ -00016020: 6e64 2077 7269 7465 7273 206d 6179 2061  nd writers may a
│ │ │ │ -00016030: 6363 6573 7320 7468 6520 6461 7461 6261  ccess the databa
│ │ │ │ -00016040: 7365 2077 6974 686f 7574 2063 6175 7369  se without causi
│ │ │ │ -00016050: 6e67 2063 6f72 7275 7074 696f 6e2e 0a0a  ng corruption...
│ │ │ │ -00016060: 2020 202a 5761 726e 696e 673a 2a20 5468     *Warning:* Th
│ │ │ │ -00016070: 6520 6c61 7374 2070 6172 6167 7261 7068  e last paragraph
│ │ │ │ -00016080: 2069 7320 6375 7272 656e 746c 7920 6e6f   is currently no
│ │ │ │ -00016090: 7420 636f 6d70 6c65 7465 6c79 2061 6363  t completely acc
│ │ │ │ -000160a0: 7572 6174 652e 0a54 6865 7265 206d 6179  urate..There may
│ │ │ │ -000160b0: 2062 6520 7261 6365 2063 6f6e 6469 7469   be race conditi
│ │ │ │ -000160c0: 6f6e 7320 7769 7468 2063 6f6e 6375 7272  ons with concurr
│ │ │ │ -000160d0: 656e 7420 7772 6974 6572 732e 2020 4e6f  ent writers.  No
│ │ │ │ -000160e0: 6e65 2073 686f 756c 6420 6361 7573 650a  ne should cause.
│ │ │ │ -000160f0: 696e 6669 6e69 7465 206c 6f6f 7073 206f  infinite loops o
│ │ │ │ -00016100: 7220 6461 7461 206c 6f73 732e 2020 486f  r data loss.  Ho
│ │ │ │ -00016110: 7765 7665 722c 2075 6e65 7870 6563 7465  wever, unexpecte
│ │ │ │ -00016120: 6420 7265 7375 6c74 7320 6d69 6768 7420  d results might 
│ │ │ │ -00016130: 6f63 6375 7220 6966 0a74 776f 2077 7269  occur if.two wri
│ │ │ │ -00016140: 7465 7273 2074 7279 2074 6f20 7570 6461  ters try to upda
│ │ │ │ -00016150: 7465 2069 6e66 6f72 6d61 7469 6f6e 2061  te information a
│ │ │ │ -00016160: 626f 7574 2061 2070 7269 6e63 6970 616c  bout a principal
│ │ │ │ -00016170: 2073 696d 756c 7461 6e65 6f75 732e 0a0a   simultaneous...
│ │ │ │ -00016180: 2020 2049 6620 796f 7520 7573 6520 6120     If you use a 
│ │ │ │ -00016190: 7265 6d6f 7465 204c 4441 5020 7365 7276  remote LDAP serv
│ │ │ │ -000161a0: 6572 206f 7220 5351 4c20 6461 7461 6261  er or SQL databa
│ │ │ │ -000161b0: 7365 2074 6f20 7374 6f72 6520 7468 6520  se to store the 
│ │ │ │ -000161c0: 7573 6572 0a64 6174 6162 6173 652c 2061  user.database, a
│ │ │ │ -000161d0: 6e64 2061 6363 6573 7320 6974 2076 6961  nd access it via
│ │ │ │ -000161e0: 2061 2053 6869 7361 2062 6163 6b65 6e64   a Shisa backend
│ │ │ │ -000161f0: 2c20 796f 7520 6861 7665 206d 616b 6520  , you have make 
│ │ │ │ -00016200: 7375 7265 2079 6f75 720a 5368 6973 6120  sure your.Shisa 
│ │ │ │ -00016210: 6261 636b 656e 6420 6861 6e64 6c65 2063  backend handle c
│ │ │ │ -00016220: 6f6e 6375 7272 656e 7420 7772 6974 6572  oncurrent writer
│ │ │ │ -00016230: 7320 7072 6f70 6572 6c79 2e20 2049 6620  s properly.  If 
│ │ │ │ -00016240: 796f 7520 7573 6520 6120 6d6f 6465 726e  you use a modern
│ │ │ │ -00016250: 0a53 514c 2064 6174 6162 6173 652c 2074  .SQL database, t
│ │ │ │ -00016260: 6869 7320 7072 6f62 6162 6c79 2069 7320  his probably is 
│ │ │ │ -00016270: 6e6f 7420 6120 636f 6e63 6572 6e2e 2020  not a concern.  
│ │ │ │ -00016280: 4966 2069 7420 6973 2061 2070 726f 626c  If it is a probl
│ │ │ │ -00016290: 656d 2c20 796f 750a 6d61 7920 6265 2061  em, you.may be a
│ │ │ │ -000162a0: 626c 6520 746f 2077 6f72 6b20 6172 6f75  ble to work arou
│ │ │ │ -000162b0: 6e64 2069 7420 6279 2069 6d70 6c65 6d65  nd it by impleme
│ │ │ │ -000162c0: 6e74 696e 6720 736f 6d65 206b 696e 6420  nting some kind 
│ │ │ │ -000162d0: 6f66 0a73 796e 6368 726f 6e69 7a61 7469  of.synchronizati
│ │ │ │ -000162e0: 6f6e 206f 7220 7365 6d61 7068 6f72 6520  on or semaphore 
│ │ │ │ -000162f0: 6d65 6368 616e 6973 6d2e 2020 4966 2061  mechanism.  If a
│ │ │ │ -00016300: 6c6c 2065 6c73 6520 736f 756e 6473 2074  ll else sounds t
│ │ │ │ -00016310: 6f6f 0a63 6f6d 706c 6963 6174 6564 2c20  oo.complicated, 
│ │ │ │ -00016320: 796f 7520 6361 6e20 7365 7420 7570 2074  you can set up t
│ │ │ │ -00016330: 6865 2073 6563 6f6e 6461 7279 2073 6572  he secondary ser
│ │ │ │ -00016340: 7665 7273 2061 7320 e280 982d 2d72 6561  vers as ...--rea
│ │ │ │ -00016350: 642d 6f6e 6c79 e280 990a 7365 7276 6572  d-only....server
│ │ │ │ -00016360: 732c 2061 6c74 686f 7567 6820 796f 7520  s, although you 
│ │ │ │ -00016370: 7769 6c6c 206c 6f73 6520 736f 6d65 2066  will lose some f
│ │ │ │ -00016380: 756e 6374 696f 6e61 6c69 7479 2028 6c69  unctionality (li
│ │ │ │ -00016390: 6b65 2063 6861 6e67 696e 670a 7061 7373  ke changing.pass
│ │ │ │ -000163a0: 776f 7264 7320 7669 6120 7468 6520 7365  words via the se
│ │ │ │ -000163b0: 636f 6e64 6172 7920 7365 7276 6572 2c20  condary server, 
│ │ │ │ -000163c0: 6f72 2075 7064 6174 696e 6720 7469 6d65  or updating time
│ │ │ │ -000163d0: 7374 616d 7073 2077 6865 6e20 7468 6520  stamps when the 
│ │ │ │ -000163e0: 6c61 7374 0a74 6963 6b65 7420 7265 7175  last.ticket requ
│ │ │ │ -000163f0: 6573 7420 6f63 6375 7272 6564 292e 0a0a  est occurred)...
│ │ │ │ -00016400: 2020 204f 6e65 2066 756e 6374 696f 6e20     One function 
│ │ │ │ -00016410: 7468 6174 2069 7320 6f66 2070 6172 7469  that is of parti
│ │ │ │ -00016420: 6375 6c61 7220 7573 6520 666f 7220 7573  cular use for us
│ │ │ │ -00016430: 6572 7320 7769 7468 2072 656d 6f74 650a  ers with remote.
│ │ │ │ -00016440: 6461 7461 6261 7365 7320 2862 6520 6974  databases (be it
│ │ │ │ -00016450: 204c 4441 5020 6f72 2053 514c 2920 6973   LDAP or SQL) is
│ │ │ │ -00016460: 2074 6865 2022 6461 7461 6261 7365 206f   the "database o
│ │ │ │ -00016470: 7665 7272 6964 6522 2066 6561 7475 7265  verride" feature
│ │ │ │ -00016480: 2e20 2055 7369 6e67 0a74 6869 7320 796f  .  Using.this yo
│ │ │ │ -00016490: 7520 6361 6e20 6861 7665 2074 6865 2073  u can have the s
│ │ │ │ -000164a0: 6563 7572 6974 7920 6372 6974 6963 616c  ecurity critical
│ │ │ │ -000164b0: 2070 7269 6e63 6970 616c 7320 2873 7563   principals (suc
│ │ │ │ -000164c0: 6820 6173 2074 6865 2074 6963 6b65 740a  h as the ticket.
│ │ │ │ -000164d0: 6772 616e 7469 6e67 2074 6963 6b65 7429  granting ticket)
│ │ │ │ -000164e0: 2073 746f 7265 6420 6f6e 206c 6f63 616c   stored on local
│ │ │ │ -000164f0: 2066 696c 6520 7379 7374 656d 2073 746f   file system sto
│ │ │ │ -00016500: 7261 6765 2c20 6275 7420 7573 6520 7468  rage, but use th
│ │ │ │ -00016510: 6520 7265 6d6f 7465 0a64 6174 6162 6173  e remote.databas
│ │ │ │ -00016520: 6520 666f 7220 7573 6572 2070 7269 6e63  e for user princ
│ │ │ │ -00016530: 6970 616c 732e 2020 4f66 2063 6f75 7273  ipals.  Of cours
│ │ │ │ -00016540: 652c 2079 6f75 206d 7573 7420 6b65 6570  e, you must keep
│ │ │ │ -00016550: 2074 6865 206c 6f63 616c 2066 696c 650a   the local file.
│ │ │ │ -00016560: 7379 7374 656d 2073 746f 7261 6765 2073  system storage s
│ │ │ │ -00016570: 796e 6368 726f 6e69 7a65 6420 6265 7477  ynchronized betw
│ │ │ │ -00016580: 6565 6e20 616c 6c20 7365 7276 6572 732c  een all servers,
│ │ │ │ -00016590: 2061 7320 6265 666f 7265 2e20 2048 6572   as before.  Her
│ │ │ │ -000165a0: 6520 6973 2061 6e0a 6578 616d 706c 6520  e is an.example 
│ │ │ │ -000165b0: 636f 6e66 6967 7572 6174 696f 6e2e 0a0a  configuration...
│ │ │ │ -000165c0: 2020 2020 2064 6220 2d2d 7265 6164 2d6f       db --read-o
│ │ │ │ -000165d0: 6e6c 7920 6669 6c65 202f 7661 722f 6c6f  nly file /var/lo
│ │ │ │ -000165e0: 6361 6c2f 6d61 7374 6572 0a20 2020 2020  cal/master.     
│ │ │ │ -000165f0: 6462 206c 6461 7020 6b64 632e 6578 616d  db ldap kdc.exam
│ │ │ │ -00016600: 706c 652e 6f72 6720 6361 3d2f 6574 632f  ple.org ca=/etc/
│ │ │ │ -00016610: 7368 6973 612f 6b64 632d 6361 2e70 656d  shisa/kdc-ca.pem
│ │ │ │ -00016620: 0a0a 2020 2054 6869 7320 696e 7374 7275  ..   This instru
│ │ │ │ -00016630: 6374 2074 6865 2053 6869 7361 206c 6962  ct the Shisa lib
│ │ │ │ -00016640: 7261 7279 2074 6f20 6163 6365 7373 2074  rary to access t
│ │ │ │ -00016650: 6865 2074 776f 2064 6174 6162 6173 6573  he two databases
│ │ │ │ -00016660: 0a73 6571 7565 6e74 6961 6c6c 792c 2066  .sequentially, f
│ │ │ │ -00016670: 6f72 2065 6163 6820 7175 6572 7920 7573  or each query us
│ │ │ │ -00016680: 696e 6720 7468 6520 6669 7273 7420 6461  ing the first da
│ │ │ │ -00016690: 7461 6261 7365 2074 6861 7420 6b6e 6f77  tabase that know
│ │ │ │ -000166a0: 2061 626f 7574 0a74 6865 2072 6571 7565   about.the reque
│ │ │ │ -000166b0: 7374 6564 2070 7269 6e63 6970 616c 2e20  sted principal. 
│ │ │ │ -000166c0: 2049 6620 796f 7520 7075 7420 7468 6520   If you put the 
│ │ │ │ -000166d0: e280 986b 7262 7467 742f 5245 414c 4de2  ...krbtgt/REALM.
│ │ │ │ -000166e0: 8099 2070 7269 6e63 6970 616c 2069 6e20  .. principal in 
│ │ │ │ -000166f0: 7468 650a 6c6f 6361 6c20 e280 9866 696c  the.local ...fil
│ │ │ │ -00016700: 65e2 8099 2064 6174 6162 6173 652c 2074  e... database, t
│ │ │ │ -00016710: 6869 7320 7769 6c6c 206f 7665 7272 6964  his will overrid
│ │ │ │ -00016720: 6520 7468 6520 4c44 4150 2069 6e74 6572  e the LDAP inter
│ │ │ │ -00016730: 6661 6365 2e0a 4e61 7475 7261 6c6c 792c  face..Naturally,
│ │ │ │ -00016740: 2079 6f75 2063 616e 2068 6176 6520 6173   you can have as
│ │ │ │ -00016750: 206d 616e 7920 e280 9864 62e2 8099 2064   many ...db... d
│ │ │ │ -00016760: 6566 696e 6974 696f 6e20 6c69 6e65 7320  efinition lines 
│ │ │ │ -00016770: 6173 2079 6f75 2077 6973 682e 0a0a 2020  as you wish...  
│ │ │ │ -00016780: 2055 7365 7273 2077 6974 6820 7265 6d6f   Users with remo
│ │ │ │ -00016790: 7465 2064 6174 6162 6173 6573 2063 616e  te databases can
│ │ │ │ -000167a0: 2061 6c73 6f20 696e 7665 7374 6967 6174   also investigat
│ │ │ │ -000167b0: 6520 6120 736f 2063 616c 6c65 6420 4869  e a so called Hi
│ │ │ │ -000167c0: 6768 0a41 7661 696c 6162 696c 6974 7920  gh.Availability 
│ │ │ │ -000167d0: 6d6f 6465 2e20 2054 6869 7320 6973 2075  mode.  This is u
│ │ │ │ -000167e0: 7365 6675 6c20 6966 2079 6f75 2077 6973  seful if you wis
│ │ │ │ -000167f0: 6820 746f 2068 6176 6520 796f 7572 204b  h to have your K
│ │ │ │ -00016800: 6572 6265 726f 730a 7365 7276 6572 7320  erberos.servers 
│ │ │ │ -00016810: 6265 2061 626c 6520 746f 2063 6f6e 7469  be able to conti
│ │ │ │ -00016820: 6e75 6520 746f 206f 7065 7261 7465 2065  nue to operate e
│ │ │ │ -00016830: 7665 6e20 7768 656e 2074 6865 2072 656d  ven when the rem
│ │ │ │ -00016840: 6f74 6520 6461 7461 6261 7365 2069 730a  ote database is.
│ │ │ │ -00016850: 6f66 666c 696e 652e 2020 5468 6973 2069  offline.  This i
│ │ │ │ -00016860: 7320 6163 6869 6576 6564 2076 6961 2074  s achieved via t
│ │ │ │ -00016870: 6865 20e2 8098 2d2d 6967 6e6f 7265 2d65  he ...--ignore-e
│ │ │ │ -00016880: 7272 6f72 73e2 8099 2066 6c61 6720 696e  rrors... flag in
│ │ │ │ -00016890: 2074 6865 0a64 6174 6162 6173 6520 6465   the.database de
│ │ │ │ -000168a0: 6669 6e69 7469 6f6e 2e20 2048 6572 6520  finition.  Here 
│ │ │ │ -000168b0: 6973 2061 2073 616d 706c 6520 636f 6e66  is a sample conf
│ │ │ │ -000168c0: 6967 7572 6174 696f 6e2e 0a0a 2020 2020  iguration...    
│ │ │ │ -000168d0: 2064 6220 2d2d 6967 6e6f 7265 2d65 7272   db --ignore-err
│ │ │ │ -000168e0: 6f72 7320 6c64 6170 206b 6463 2e65 7861  ors ldap kdc.exa
│ │ │ │ -000168f0: 6d70 6c65 2e6f 7267 2063 613d 2f65 7463  mple.org ca=/etc
│ │ │ │ -00016900: 2f73 6869 7361 2f6b 6463 2d63 612e 7065  /shisa/kdc-ca.pe
│ │ │ │ -00016910: 6d0a 2020 2020 2064 6220 2d2d 7265 6164  m.     db --read
│ │ │ │ -00016920: 2d6f 6e6c 7920 6669 6c65 202f 7661 722f  -only file /var/
│ │ │ │ -00016930: 6361 6368 652f 6c64 6170 2d63 6f70 790a  cache/ldap-copy.
│ │ │ │ -00016940: 0a20 2020 5468 6973 2069 6e73 7472 7563  .   This instruc
│ │ │ │ -00016950: 7420 7468 6520 5368 6973 6120 6c69 6272  t the Shisa libr
│ │ │ │ -00016960: 6172 7920 746f 2074 7279 2074 6865 204c  ary to try the L
│ │ │ │ -00016970: 4441 5020 6261 636b 656e 6420 6669 7273  DAP backend firs
│ │ │ │ -00016980: 742c 2062 7574 2069 660a 6974 2066 6169  t, but if.it fai
│ │ │ │ -00016990: 6c73 2c20 696e 7374 6561 6420 6f66 2072  ls, instead of r
│ │ │ │ -000169a0: 6574 7572 6e69 6e67 2061 6e20 6572 726f  eturning an erro
│ │ │ │ -000169b0: 722c 2063 6f6e 7469 6e75 6520 746f 2074  r, continue to t
│ │ │ │ -000169c0: 7279 2074 6865 206f 7065 7261 7469 6f6e  ry the operation
│ │ │ │ -000169d0: 0a6f 6e20 6120 7265 6164 206f 6e6c 7920  .on a read only 
│ │ │ │ -000169e0: 6c6f 6361 6c20 e280 9866 696c 65e2 8099  local ...file...
│ │ │ │ -000169f0: 2062 6173 6564 2064 6174 6162 6173 652e   based database.
│ │ │ │ -00016a00: 2020 4f66 2063 6f75 7273 652c 2077 7269    Of course, wri
│ │ │ │ -00016a10: 7465 2072 6571 7565 7374 730a 7769 6c6c  te requests.will
│ │ │ │ -00016a20: 2073 7469 6c6c 2066 6169 6c2c 2062 7574   still fail, but
│ │ │ │ -00016a30: 2069 7420 6d61 7920 6265 2062 6574 7465   it may be bette
│ │ │ │ -00016a40: 7220 7468 616e 2068 616c 7469 6e67 2074  r than halting t
│ │ │ │ -00016a50: 6865 2073 6572 7665 720a 636f 6d70 6c65  he server.comple
│ │ │ │ -00016a60: 7465 6c79 2e20 2054 6f20 6d61 6b65 2074  tely.  To make t
│ │ │ │ -00016a70: 6869 7320 776f 726b 2c20 796f 7520 6669  his work, you fi
│ │ │ │ -00016a80: 7273 7420 6e65 6564 2074 6f20 7365 7420  rst need to set 
│ │ │ │ -00016a90: 7570 2061 2063 726f 6e20 6a6f 6220 6f6e  up a cron job on
│ │ │ │ -00016aa0: 0a61 2c20 7361 792c 2068 6f75 726c 7920  .a, say, hourly 
│ │ │ │ -00016ab0: 6261 7369 732c 2074 6f20 6d61 6b65 2061  basis, to make a
│ │ │ │ -00016ac0: 2063 6f70 7920 6f66 2074 6865 2072 656d   copy of the rem
│ │ │ │ -00016ad0: 6f74 6520 6461 7461 6261 7365 2061 6e64  ote database and
│ │ │ │ -00016ae0: 2073 746f 7265 2069 740a 696e 2074 6865   store it.in the
│ │ │ │ -00016af0: 206c 6f63 616c 2066 696c 6520 6461 7461   local file data
│ │ │ │ -00016b00: 6261 7365 2e20 2054 6861 7420 7761 792c  base.  That way,
│ │ │ │ -00016b10: 2077 6865 6e20 7468 6520 7265 6d6f 7465   when the remote
│ │ │ │ -00016b20: 2073 6572 7665 7220 676f 6573 2061 7761   server goes awa
│ │ │ │ -00016b30: 792c 0a66 6169 726c 7920 6375 7272 656e  y,.fairly curren
│ │ │ │ -00016b40: 7420 696e 666f 726d 6174 696f 6e20 7769  t information wi
│ │ │ │ -00016b50: 6c6c 2073 7469 6c6c 2062 6520 6176 6169  ll still be avai
│ │ │ │ -00016b60: 6c61 626c 6520 6c6f 6361 6c6c 792e 0a0a  lable locally...
│ │ │ │ -00016b70: 2020 2049 6620 796f 7520 616c 736f 2077     If you also w
│ │ │ │ -00016b80: 6973 6820 746f 2065 7870 6572 696d 656e  ish to experimen
│ │ │ │ -00016b90: 7420 7769 7468 2072 6561 642d 7772 6974  t with read-writ
│ │ │ │ -00016ba0: 6520 6661 696c 206f 7665 722c 2068 6572  e fail over, her
│ │ │ │ -00016bb0: 6520 6973 2061 6e0a 6964 6561 2066 6f72  e is an.idea for
│ │ │ │ -00016bc0: 2074 6865 2063 6f6e 6669 6775 7261 7469   the configurati
│ │ │ │ -00016bd0: 6f6e 2e0a 0a20 2020 2020 6462 202d 2d69  on...     db --i
│ │ │ │ -00016be0: 676e 6f72 652d 6572 726f 7273 206c 6461  gnore-errors lda
│ │ │ │ -00016bf0: 7020 6b64 632e 6578 616d 706c 652e 6f72  p kdc.example.or
│ │ │ │ -00016c00: 6720 6361 3d2f 6574 632f 7368 6973 612f  g ca=/etc/shisa/
│ │ │ │ -00016c10: 6b64 632d 6361 2e70 656d 0a20 2020 2020  kdc-ca.pem.     
│ │ │ │ -00016c20: 6462 202d 2d69 676e 6f72 652d 6572 726f  db --ignore-erro
│ │ │ │ -00016c30: 7273 202d 2d72 6561 642d 6f6e 6c79 2066  rs --read-only f
│ │ │ │ -00016c40: 696c 6520 2f76 6172 2f63 6163 6865 2f6c  ile /var/cache/l
│ │ │ │ -00016c50: 6461 702d 636f 7079 0a20 2020 2020 6462  dap-copy.     db
│ │ │ │ -00016c60: 2066 696c 6520 2f76 6172 2f63 6163 6865   file /var/cache
│ │ │ │ -00016c70: 2f6c 6f63 616c 2d75 7064 6174 6573 0a0a  /local-updates..
│ │ │ │ -00016c80: 2020 2054 6869 7320 6973 2073 696d 696c     This is simil
│ │ │ │ -00016c90: 6172 2074 6f20 7468 6520 7072 6576 696f  ar to the previo
│ │ │ │ -00016ca0: 7573 2c20 6275 7420 6974 2077 696c 6c20  us, but it will 
│ │ │ │ -00016cb0: 6967 6e6f 7265 2065 7272 6f72 7320 7265  ignore errors re
│ │ │ │ -00016cc0: 6164 696e 670a 616e 6420 7772 6974 696e  ading.and writin
│ │ │ │ -00016cd0: 6720 6672 6f6d 2074 6865 2066 6972 7374  g from the first
│ │ │ │ -00016ce0: 2074 776f 2064 6174 6162 6173 6573 2c20   two databases, 
│ │ │ │ -00016cf0: 756c 7469 6d61 7465 6c79 2063 6175 7369  ultimately causi
│ │ │ │ -00016d00: 6e67 2077 7269 7465 0a61 7474 656d 7074  ng write.attempt
│ │ │ │ -00016d10: 7320 746f 2065 6e64 2075 7020 696e 2074  s to end up in t
│ │ │ │ -00016d20: 6865 2066 696e 616c 20e2 8098 6669 6c65  he final ...file
│ │ │ │ -00016d30: e280 9920 6261 7365 6420 6461 7461 6261  ... based databa
│ │ │ │ -00016d40: 7365 2e20 204f 6620 636f 7572 7365 2c20  se.  Of course, 
│ │ │ │ -00016d50: 796f 750a 776f 756c 6420 6e65 6564 2074  you.would need t
│ │ │ │ -00016d60: 6f20 6372 6561 7465 2074 6f6f 6c73 2074  o create tools t
│ │ │ │ -00016d70: 6f20 6665 6564 2062 6163 6b20 616e 7920  o feed back any 
│ │ │ │ -00016d80: 6c6f 6361 6c20 7570 6461 7465 7320 6d61  local updates ma
│ │ │ │ -00016d90: 6465 2077 6869 6c65 2074 6865 0a72 656d  de while the.rem
│ │ │ │ -00016da0: 6f74 6520 7365 7276 6572 2077 6173 2064  ote server was d
│ │ │ │ -00016db0: 6f77 6e2e 2020 4974 206d 6179 2061 6c73  own.  It may als
│ │ │ │ -00016dc0: 6f20 6265 206e 6563 6573 7361 7279 2074  o be necessary t
│ │ │ │ -00016dd0: 6f20 6372 6561 7465 2061 2073 7065 6369  o create a speci
│ │ │ │ -00016de0: 616c 0a62 6163 6b65 6e64 2066 6f72 2074  al.backend for t
│ │ │ │ -00016df0: 6869 7320 7075 7270 6f73 652c 2077 6869  his purpose, whi
│ │ │ │ -00016e00: 6368 2063 616e 2061 7574 6f20 6372 6561  ch can auto crea
│ │ │ │ -00016e10: 7465 2070 7269 6e63 6970 616c 7320 7468  te principals th
│ │ │ │ -00016e20: 6174 2061 7265 0a75 7365 642e 0a0a 2020  at are.used...  
│ │ │ │ -00016e30: 2057 6520 6669 6e69 7368 2077 6974 6820   We finish with 
│ │ │ │ -00016e40: 616e 2065 7861 6d70 6c65 2074 6861 7420  an example that 
│ │ │ │ -00016e50: 6465 6d6f 6e73 7472 6174 6520 616c 6c20  demonstrate all 
│ │ │ │ -00016e60: 7468 6520 6964 6561 7320 7072 6573 656e  the ideas presen
│ │ │ │ -00016e70: 7465 642e 0a0a 2020 2020 2064 6220 2d2d  ted...     db --
│ │ │ │ -00016e80: 7265 6164 2d6f 6e6c 7920 6669 6c65 202f  read-only file /
│ │ │ │ -00016e90: 7661 722f 6c6f 6361 6c2f 6d61 7374 6572  var/local/master
│ │ │ │ -00016ea0: 0a20 2020 2020 6462 202d 2d69 676e 6f72  .     db --ignor
│ │ │ │ -00016eb0: 652d 6572 726f 7273 206c 6461 7020 6b64  e-errors ldap kd
│ │ │ │ -00016ec0: 632e 6578 616d 706c 652e 6f72 6720 6361  c.example.org ca
│ │ │ │ -00016ed0: 3d2f 6574 632f 7368 6973 612f 6b64 632d  =/etc/shisa/kdc-
│ │ │ │ -00016ee0: 6361 2e70 656d 0a20 2020 2020 6462 202d  ca.pem.     db -
│ │ │ │ -00016ef0: 2d69 676e 6f72 652d 6572 726f 7273 202d  -ignore-errors -
│ │ │ │ -00016f00: 2d72 6561 642d 6f6e 6c79 2066 696c 6520  -read-only file 
│ │ │ │ -00016f10: 2f76 6172 2f63 6163 6865 2f6c 6461 702d  /var/cache/ldap-
│ │ │ │ -00016f20: 636f 7079 0a20 2020 2020 6462 2066 696c  copy.     db fil
│ │ │ │ -00016f30: 6520 2f76 6172 2f63 6163 6865 2f6c 6f63  e /var/cache/loc
│ │ │ │ -00016f40: 616c 2d75 7064 6174 6573 0a0a 1f0a 4669  al-updates....Fi
│ │ │ │ -00016f50: 6c65 3a20 7368 6973 6869 2e69 6e66 6f2c  le: shishi.info,
│ │ │ │ -00016f60: 2020 4e6f 6465 3a20 4465 7665 6c6f 7065    Node: Develope
│ │ │ │ -00016f70: 7220 696e 666f 726d 6174 696f 6e2c 2020  r information,  
│ │ │ │ -00016f80: 5072 6576 3a20 4d75 6c74 6970 6c65 2073  Prev: Multiple s
│ │ │ │ -00016f90: 6572 7665 7273 2c20 2055 703a 2041 646d  ervers,  Up: Adm
│ │ │ │ -00016fa0: 696e 6973 7472 6174 696f 6e20 4d61 6e75  inistration Manu
│ │ │ │ -00016fb0: 616c 0a0a 332e 3820 4465 7665 6c6f 7065  al..3.8 Develope
│ │ │ │ -00016fc0: 7220 696e 666f 726d 6174 696f 6e0a 3d3d  r information.==
│ │ │ │ +00014e00: 2e2e 2e0a 0a54 6865 204b 4443 206e 6565  .....The KDC nee
│ │ │ │ +00014e10: 6420 7468 6520 4341 2063 6572 7469 6669  d the CA certifi
│ │ │ │ +00014e20: 6361 7465 2028 746f 2076 6572 6966 7920  cate (to verify 
│ │ │ │ +00014e30: 636c 6965 6e74 2063 6572 7469 6669 6361  client certifica
│ │ │ │ +00014e40: 7465 7329 2061 6e64 2074 6865 0a73 6572  tes) and the.ser
│ │ │ │ +00014e50: 7665 7220 6365 7274 6966 6963 6174 6520  ver certificate 
│ │ │ │ +00014e60: 616e 6420 6b65 7920 2874 6f20 6175 7468  and key (to auth
│ │ │ │ +00014e70: 656e 7469 6361 7465 2069 7473 656c 6620  enticate itself 
│ │ │ │ +00014e80: 746f 2074 6865 2063 6c69 656e 7473 292e  to the clients).
│ │ │ │ +00014e90: 2020 5365 650a 656c 7365 7768 6572 6520    See.elsewhere 
│ │ │ │ +00014ea0: 282a 6e6f 7465 2050 6172 616d 6574 6572  (*note Parameter
│ │ │ │ +00014eb0: 7320 666f 7220 7368 6973 6869 643a 3a29  s for shishid::)
│ │ │ │ +00014ec0: 2066 6f72 2074 6865 2065 6e74 6972 6520   for the entire 
│ │ │ │ +00014ed0: 6465 7363 7269 7074 696f 6e20 6f66 0a74  description of.t
│ │ │ │ +00014ee0: 6865 2070 6172 616d 6574 6572 732e 0a0a  he parameters...
│ │ │ │ +00014ef0: 2020 2020 206a 6173 406c 6174 7465 3a7e       jas@latte:~
│ │ │ │ +00014f00: 2420 7368 6973 6869 6420 2d6c 202a 3a34  $ shishid -l *:4
│ │ │ │ +00014f10: 3731 312f 7463 7020 5c0a 2020 2020 2020  711/tcp \.      
│ │ │ │ +00014f20: 2020 2d2d 7835 3039 6361 6669 6c65 202f    --x509cafile /
│ │ │ │ +00014f30: 7573 722f 6c6f 6361 6c2f 6574 632f 7368  usr/local/etc/sh
│ │ │ │ +00014f40: 6973 6869 2f73 6869 7368 692e 6365 7274  ishi/shishi.cert
│ │ │ │ +00014f50: 205c 0a20 2020 2020 2020 202d 2d78 3530   \.        --x50
│ │ │ │ +00014f60: 3963 6572 7466 696c 6520 2f75 7372 2f6c  9certfile /usr/l
│ │ │ │ +00014f70: 6f63 616c 2f65 7463 2f73 6869 7368 692f  ocal/etc/shishi/
│ │ │ │ +00014f80: 7368 6973 6869 642e 6365 7274 205c 0a20  shishid.cert \. 
│ │ │ │ +00014f90: 2020 2020 2020 202d 2d78 3530 396b 6579         --x509key
│ │ │ │ +00014fa0: 6669 6c65 202f 7573 722f 6c6f 6361 6c2f  file /usr/local/
│ │ │ │ +00014fb0: 6574 632f 7368 6973 6869 2f73 6869 7368  etc/shishi/shish
│ │ │ │ +00014fc0: 6964 2e6b 6579 0a20 2020 2020 496e 6974  id.key.     Init
│ │ │ │ +00014fd0: 6961 6c69 7a69 6e67 2047 4e55 544c 532e  ializing GNUTLS.
│ │ │ │ +00014fe0: 2e2e 0a20 2020 2020 5061 7273 6564 2031  ...     Parsed 1
│ │ │ │ +00014ff0: 2043 4173 2e2e 2e0a 2020 2020 204c 6f61   CAs....     Loa
│ │ │ │ +00015000: 6465 6420 7365 7276 6572 2063 6572 7469  ded server certi
│ │ │ │ +00015010: 6669 6361 7465 2f6b 6579 2e2e 2e0a 2020  ficate/key....  
│ │ │ │ +00015020: 2020 2047 656e 6572 6174 696e 6720 4469     Generating Di
│ │ │ │ +00015030: 6666 6965 2d48 656c 6c6d 616e 2070 6172  ffie-Hellman par
│ │ │ │ +00015040: 616d 6574 6572 732e 2e2e 0a20 2020 2020  ameters....     
│ │ │ │ +00015050: 496e 6974 6961 6c69 7a69 6e67 2047 4e55  Initializing GNU
│ │ │ │ +00015060: 544c 532e 2e2e 646f 6e65 0a20 2020 2020  TLS...done.     
│ │ │ │ +00015070: 4c69 7374 656e 696e 6720 6f6e 202a 3a34  Listening on *:4
│ │ │ │ +00015080: 3731 312f 7463 702e 2e2e 0a20 2020 2020  711/tcp....     
│ │ │ │ +00015090: 4c69 7374 656e 696e 6720 6f6e 2031 2070  Listening on 1 p
│ │ │ │ +000150a0: 6f72 7473 2e2e 2e0a 2020 2020 2073 6869  orts....     shi
│ │ │ │ +000150b0: 7368 6964 3a20 5374 6172 7469 6e67 2028  shid: Starting (
│ │ │ │ +000150c0: 474e 5554 4c53 2060 312e 302e 3427 290a  GNUTLS `1.0.4').
│ │ │ │ +000150d0: 2020 2020 2073 6869 7368 6964 3a20 4c69       shishid: Li
│ │ │ │ +000150e0: 7374 656e 696e 6720 6f6e 202a 3a34 3731  stening on *:471
│ │ │ │ +000150f0: 312f 7463 7020 736f 636b 6574 2034 0a0a  1/tcp socket 4..
│ │ │ │ +00015100: 2020 2054 6865 6e20 6163 7175 6972 6520     Then acquire 
│ │ │ │ +00015110: 7469 636b 6574 7320 6173 2075 7375 616c  tickets as usual
│ │ │ │ +00015120: 2e20 2049 6e20 6361 7365 2079 6f75 2077  .  In case you w
│ │ │ │ +00015130: 6f6e 6465 7220 686f 7720 7368 6973 6869  onder how shishi
│ │ │ │ +00015140: 2066 696e 6473 0a74 6865 2063 6c69 656e   finds.the clien
│ │ │ │ +00015150: 7420 6365 7274 6966 6963 6174 6520 616e  t certificate an
│ │ │ │ +00015160: 6420 6b65 792c 2074 6865 2066 696c 656e  d key, the filen
│ │ │ │ +00015170: 616d 6573 2075 7365 6420 6162 6f76 6520  ames used above 
│ │ │ │ +00015180: 7768 656e 2067 656e 6572 6174 696e 670a  when generating.
│ │ │ │ +00015190: 7468 6520 636c 6965 6e74 2063 6572 7469  the client certi
│ │ │ │ +000151a0: 6669 6361 7465 7320 6861 7070 656e 2074  ficates happen t
│ │ │ │ +000151b0: 6f20 6265 2074 6865 2064 6566 6175 6c74  o be the default
│ │ │ │ +000151c0: 2066 696c 656e 616d 6573 2066 6f72 2074   filenames for t
│ │ │ │ +000151d0: 6865 7365 0a66 696c 6573 2e20 2053 6f20  hese.files.  So 
│ │ │ │ +000151e0: 6974 2070 6963 6b20 7468 656d 2075 7020  it pick them up 
│ │ │ │ +000151f0: 6175 746f 6d61 7469 6361 6c6c 792e 0a0a  automatically...
│ │ │ │ +00015200: 2020 2020 206a 6173 406c 6174 7465 3a7e       jas@latte:~
│ │ │ │ +00015210: 2420 7368 6973 6869 202d 6f20 2772 6561  $ shishi -o 'rea
│ │ │ │ +00015220: 6c6d 2d6b 6463 3d45 5841 4d50 4c45 2e4f  lm-kdc=EXAMPLE.O
│ │ │ │ +00015230: 5247 2c6c 6f63 616c 686f 7374 3a34 3731  RG,localhost:471
│ │ │ │ +00015240: 312f 746c 7327 205c 0a20 2020 2020 2020  1/tls' \.       
│ │ │ │ +00015250: 2073 696d 6f6e 4045 5841 4d50 4c45 2e4f   simon@EXAMPLE.O
│ │ │ │ +00015260: 5247 0a20 2020 2020 456e 7465 7220 7061  RG.     Enter pa
│ │ │ │ +00015270: 7373 776f 7264 2066 6f72 2060 7369 6d6f  ssword for `simo
│ │ │ │ +00015280: 6e40 4558 414d 504c 452e 4f52 4727 3a0a  n@EXAMPLE.ORG':.
│ │ │ │ +00015290: 2020 2020 2073 696d 6f6e 4045 5841 4d50       simon@EXAMP
│ │ │ │ +000152a0: 4c45 2e4f 5247 3a0a 2020 2020 2041 7574  LE.ORG:.     Aut
│ │ │ │ +000152b0: 6874 696d 653a 2020 2020 2020 2053 756e  htime:       Sun
│ │ │ │ +000152c0: 2044 6563 2032 3120 3131 3a31 353a 3437   Dec 21 11:15:47
│ │ │ │ +000152d0: 2032 3030 330a 2020 2020 2045 6e64 7469   2003.     Endti
│ │ │ │ +000152e0: 6d65 3a20 2020 2020 2020 2053 756e 2044  me:        Sun D
│ │ │ │ +000152f0: 6563 2032 3120 3131 3a33 323a 3237 2032  ec 21 11:32:27 2
│ │ │ │ +00015300: 3030 330a 2020 2020 2053 6572 7665 723a  003.     Server:
│ │ │ │ +00015310: 2020 2020 2020 2020 206b 7262 7467 742f           krbtgt/
│ │ │ │ +00015320: 4558 414d 504c 452e 4f52 4720 6b65 7920  EXAMPLE.ORG key 
│ │ │ │ +00015330: 6165 7332 3536 2d63 7473 2d68 6d61 632d  aes256-cts-hmac-
│ │ │ │ +00015340: 7368 6131 2d39 3620 2831 3829 0a20 2020  sha1-96 (18).   
│ │ │ │ +00015350: 2020 5469 636b 6574 206b 6579 3a20 2020    Ticket key:   
│ │ │ │ +00015360: 2020 6165 7332 3536 2d63 7473 2d68 6d61    aes256-cts-hma
│ │ │ │ +00015370: 632d 7368 6131 2d39 3620 2831 3829 2070  c-sha1-96 (18) p
│ │ │ │ +00015380: 726f 7465 6374 6564 2062 7920 6165 7332  rotected by aes2
│ │ │ │ +00015390: 3536 2d63 7473 2d68 6d61 632d 7368 6131  56-cts-hmac-sha1
│ │ │ │ +000153a0: 2d39 3620 2831 3829 0a20 2020 2020 5469  -96 (18).     Ti
│ │ │ │ +000153b0: 636b 6574 2066 6c61 6773 3a20 2020 464f  cket flags:   FO
│ │ │ │ +000153c0: 5257 4152 4445 4420 5052 4f58 4941 424c  RWARDED PROXIABL
│ │ │ │ +000153d0: 4520 5245 4e45 5741 424c 4520 4857 4155  E RENEWABLE HWAU
│ │ │ │ +000153e0: 5448 454e 5420 5452 414e 5349 5445 4450  THENT TRANSITEDP
│ │ │ │ +000153f0: 4f4c 4943 5943 4845 434b 4544 204f 4b41  OLICYCHECKED OKA
│ │ │ │ +00015400: 5344 454c 4547 4154 4520 2831 3229 0a20  SDELEGATE (12). 
│ │ │ │ +00015410: 2020 2020 6a61 7340 6c61 7474 653a 7e24      jas@latte:~$
│ │ │ │ +00015420: 0a0a 2020 2048 6572 6520 6973 2077 6861  ..   Here is wha
│ │ │ │ +00015430: 7420 7468 6520 7365 7276 6572 2077 6f75  t the server wou
│ │ │ │ +00015440: 6c64 2070 7269 6e74 2e0a 0a20 2020 2020  ld print...     
│ │ │ │ +00015450: 7368 6973 6869 643a 2041 6363 6570 7465  shishid: Accepte
│ │ │ │ +00015460: 6420 736f 636b 6574 2036 2066 726f 6d20  d socket 6 from 
│ │ │ │ +00015470: 736f 636b 6574 2034 2061 7320 2a3a 3437  socket 4 as *:47
│ │ │ │ +00015480: 3131 2f74 6370 2070 6565 7220 3132 372e  11/tcp peer 127.
│ │ │ │ +00015490: 302e 302e 310a 2020 2020 2073 6869 7368  0.0.1.     shish
│ │ │ │ +000154a0: 6964 3a20 4c69 7374 656e 696e 6720 6f6e  id: Listening on
│ │ │ │ +000154b0: 202a 3a34 3731 312f 7463 7020 736f 636b   *:4711/tcp sock
│ │ │ │ +000154c0: 6574 2034 0a20 2020 2020 7368 6973 6869  et 4.     shishi
│ │ │ │ +000154d0: 643a 204c 6973 7465 6e69 6e67 206f 6e20  d: Listening on 
│ │ │ │ +000154e0: 2a3a 3437 3131 2f74 6370 2070 6565 7220  *:4711/tcp peer 
│ │ │ │ +000154f0: 3132 372e 302e 302e 3120 736f 636b 6574  127.0.0.1 socket
│ │ │ │ +00015500: 2036 0a20 2020 2020 7368 6973 6869 643a   6.     shishid:
│ │ │ │ +00015510: 2048 6173 2034 2062 7974 6573 2066 726f   Has 4 bytes fro
│ │ │ │ +00015520: 6d20 2a3a 3437 3131 2f74 6370 2070 6565  m *:4711/tcp pee
│ │ │ │ +00015530: 7220 3132 372e 302e 302e 3120 6f6e 2073  r 127.0.0.1 on s
│ │ │ │ +00015540: 6f63 6b65 7420 360a 2020 2020 2073 6869  ocket 6.     shi
│ │ │ │ +00015550: 7368 6964 3a20 5472 7969 6e67 2053 5441  shid: Trying STA
│ │ │ │ +00015560: 5254 544c 530a 2020 2020 2073 6869 7368  RTTLS.     shish
│ │ │ │ +00015570: 6964 3a20 544c 5320 6861 6e64 7368 616b  id: TLS handshak
│ │ │ │ +00015580: 6520 6e65 676f 7469 6174 6564 2070 726f  e negotiated pro
│ │ │ │ +00015590: 746f 636f 6c20 6054 4c53 2031 2e30 272c  tocol `TLS 1.0',
│ │ │ │ +000155a0: 206b 6579 2065 7863 6861 6e67 6520 6052   key exchange `R
│ │ │ │ +000155b0: 5341 272c 2063 6572 7469 6669 6361 7465  SA', certificate
│ │ │ │ +000155c0: 2074 7970 6520 6058 2e35 3039 272c 2063   type `X.509', c
│ │ │ │ +000155d0: 6970 6865 7220 6041 4553 2032 3536 2043  ipher `AES 256 C
│ │ │ │ +000155e0: 4243 272c 206d 6163 2060 5348 4127 2c20  BC', mac `SHA', 
│ │ │ │ +000155f0: 636f 6d70 7265 7373 696f 6e20 604e 554c  compression `NUL
│ │ │ │ +00015600: 4c27 2c20 7365 7373 696f 6e20 6e6f 7420  L', session not 
│ │ │ │ +00015610: 7265 7375 6d65 640a 2020 2020 2073 6869  resumed.     shi
│ │ │ │ +00015620: 7368 6964 3a20 544c 5320 636c 6965 6e74  shid: TLS client
│ │ │ │ +00015630: 2063 6572 7469 6669 6361 7465 2060 433d   certificate `C=
│ │ │ │ +00015640: 5345 2c4f 3d53 6869 7368 6920 4578 616d  SE,O=Shishi Exam
│ │ │ │ +00015650: 706c 6520 436c 6965 6e74 2c43 4e3d 436c  ple Client,CN=Cl
│ │ │ │ +00015660: 6965 6e74 272c 2069 7373 7565 6420 6279  ient', issued by
│ │ │ │ +00015670: 2060 433d 5345 2c4f 3d53 6869 7368 6920   `C=SE,O=Shishi 
│ │ │ │ +00015680: 4578 616d 706c 6520 4341 2c43 4e3d 4341  Example CA,CN=CA
│ │ │ │ +00015690: 272c 2073 6572 6961 6c20 6e75 6d62 6572  ', serial number
│ │ │ │ +000156a0: 2060 3030 272c 204d 4435 2066 696e 6765   `00', MD5 finge
│ │ │ │ +000156b0: 7270 7269 6e74 2060 6135 3a64 333a 3166  rprint `a5:d3:1f
│ │ │ │ +000156c0: 3a35 383a 3736 3a65 333a 3538 3a63 643a  :58:76:e3:58:cd:
│ │ │ │ +000156d0: 3264 3a65 623a 6637 3a34 353a 6132 3a34  2d:eb:f7:45:a2:4
│ │ │ │ +000156e0: 623a 3532 3a66 393a 272c 2061 6374 6976  b:52:f9:', activ
│ │ │ │ +000156f0: 6174 6564 2060 5375 6e20 4465 6320 3231  ated `Sun Dec 21
│ │ │ │ +00015700: 2031 313a 3034 3a30 3020 3230 3033 272c   11:04:00 2003',
│ │ │ │ +00015710: 2065 7870 6972 6573 2060 4672 6920 4a75   expires `Fri Ju
│ │ │ │ +00015720: 6e20 3138 2031 323a 3034 3a30 3020 3230  n 18 12:04:00 20
│ │ │ │ +00015730: 3034 272c 2076 6572 7369 6f6e 2023 332c  04', version #3,
│ │ │ │ +00015740: 206b 6579 2052 5341 206d 6f64 756c 7573   key RSA modulus
│ │ │ │ +00015750: 2031 3032 3420 6269 7473 2c20 6375 7272   1024 bits, curr
│ │ │ │ +00015760: 656e 746c 7920 4558 5049 5245 440a 2020  ently EXPIRED.  
│ │ │ │ +00015770: 2020 2073 6869 7368 6964 3a20 4c69 7374     shishid: List
│ │ │ │ +00015780: 656e 696e 6720 6f6e 202a 3a34 3731 312f  ening on *:4711/
│ │ │ │ +00015790: 7463 7020 736f 636b 6574 2034 0a20 2020  tcp socket 4.   
│ │ │ │ +000157a0: 2020 7368 6973 6869 643a 204c 6973 7465    shishid: Liste
│ │ │ │ +000157b0: 6e69 6e67 206f 6e20 2a3a 3437 3131 2f74  ning on *:4711/t
│ │ │ │ +000157c0: 6370 2070 6565 7220 3132 372e 302e 302e  cp peer 127.0.0.
│ │ │ │ +000157d0: 3120 736f 636b 6574 2036 0a20 2020 2020  1 socket 6.     
│ │ │ │ +000157e0: 7368 6973 6869 643a 2048 6173 2031 3331  shishid: Has 131
│ │ │ │ +000157f0: 2062 7974 6573 2066 726f 6d20 2a3a 3437   bytes from *:47
│ │ │ │ +00015800: 3131 2f74 6370 2070 6565 7220 3132 372e  11/tcp peer 127.
│ │ │ │ +00015810: 302e 302e 3120 6f6e 2073 6f63 6b65 7420  0.0.1 on socket 
│ │ │ │ +00015820: 360a 2020 2020 2073 6869 7368 6964 3a20  6.     shishid: 
│ │ │ │ +00015830: 5072 6f63 6573 7369 6e67 2031 3331 2066  Processing 131 f
│ │ │ │ +00015840: 726f 6d20 2a3a 3437 3131 2f74 6370 2070  rom *:4711/tcp p
│ │ │ │ +00015850: 6565 7220 3132 372e 302e 302e 3120 6f6e  eer 127.0.0.1 on
│ │ │ │ +00015860: 2073 6f63 6b65 7420 360a 2020 2020 2073   socket 6.     s
│ │ │ │ +00015870: 6869 7368 6964 3a20 5472 7969 6e67 2041  hishid: Trying A
│ │ │ │ +00015880: 532d 5245 510a 2020 2020 2073 6869 7368  S-REQ.     shish
│ │ │ │ +00015890: 6964 3a20 4153 2d52 4551 2066 726f 6d20  id: AS-REQ from 
│ │ │ │ +000158a0: 7369 6d6f 6e40 4558 414d 504c 452e 4f52  simon@EXAMPLE.OR
│ │ │ │ +000158b0: 4720 666f 7220 6b72 6274 6774 2f45 5841  G for krbtgt/EXA
│ │ │ │ +000158c0: 4d50 4c45 2e4f 5247 4045 5841 4d50 4c45  MPLE.ORG@EXAMPLE
│ │ │ │ +000158d0: 2e4f 5247 0a20 2020 2020 7368 6973 6869  .ORG.     shishi
│ │ │ │ +000158e0: 643a 204d 6174 6368 696e 6720 636c 6965  d: Matching clie
│ │ │ │ +000158f0: 6e74 2065 7479 7065 2031 3820 6167 6169  nt etype 18 agai
│ │ │ │ +00015900: 6e73 7420 7573 6572 206b 6579 2065 7479  nst user key ety
│ │ │ │ +00015910: 7065 2031 380a 2020 2020 2073 6869 7368  pe 18.     shish
│ │ │ │ +00015920: 6964 3a20 4861 7665 2035 3131 2062 7974  id: Have 511 byt
│ │ │ │ +00015930: 6573 2066 6f72 202a 3a34 3731 312f 7463  es for *:4711/tc
│ │ │ │ +00015940: 7020 7065 6572 2031 3237 2e30 2e30 2e31  p peer 127.0.0.1
│ │ │ │ +00015950: 206f 6e20 736f 636b 6574 2036 0a20 2020   on socket 6.   
│ │ │ │ +00015960: 2020 7368 6973 6869 643a 2053 656e 6469    shishid: Sendi
│ │ │ │ +00015970: 6e67 2035 3131 2062 7974 6573 2074 6f20  ng 511 bytes to 
│ │ │ │ +00015980: 2a3a 3437 3131 2f74 6370 2070 6565 7220  *:4711/tcp peer 
│ │ │ │ +00015990: 3132 372e 302e 302e 3120 736f 636b 6574  127.0.0.1 socket
│ │ │ │ +000159a0: 2036 2076 6961 2054 4c53 0a20 2020 2020   6 via TLS.     
│ │ │ │ +000159b0: 7368 6973 6869 643a 204c 6973 7465 6e69  shishid: Listeni
│ │ │ │ +000159c0: 6e67 206f 6e20 2a3a 3437 3131 2f74 6370  ng on *:4711/tcp
│ │ │ │ +000159d0: 2073 6f63 6b65 7420 340a 2020 2020 2073   socket 4.     s
│ │ │ │ +000159e0: 6869 7368 6964 3a20 4c69 7374 656e 696e  hishid: Listenin
│ │ │ │ +000159f0: 6720 6f6e 202a 3a34 3731 312f 7463 7020  g on *:4711/tcp 
│ │ │ │ +00015a00: 7065 6572 2031 3237 2e30 2e30 2e31 2073  peer 127.0.0.1 s
│ │ │ │ +00015a10: 6f63 6b65 7420 360a 2020 2020 2073 6869  ocket 6.     shi
│ │ │ │ +00015a20: 7368 6964 3a20 5065 6572 202a 3a34 3731  shid: Peer *:471
│ │ │ │ +00015a30: 312f 7463 7020 7065 6572 2031 3237 2e30  1/tcp peer 127.0
│ │ │ │ +00015a40: 2e30 2e31 2064 6973 636f 6e6e 6563 7465  .0.1 disconnecte
│ │ │ │ +00015a50: 6420 6f6e 2073 6f63 6b65 7420 360a 2020  d on socket 6.  
│ │ │ │ +00015a60: 2020 2073 6869 7368 6964 3a20 436c 6f73     shishid: Clos
│ │ │ │ +00015a70: 696e 6720 2a3a 3437 3131 2f74 6370 2070  ing *:4711/tcp p
│ │ │ │ +00015a80: 6565 7220 3132 372e 302e 302e 3120 736f  eer 127.0.0.1 so
│ │ │ │ +00015a90: 636b 6574 2036 0a20 2020 2020 7368 6973  cket 6.     shis
│ │ │ │ +00015aa0: 6869 643a 204c 6973 7465 6e69 6e67 206f  hid: Listening o
│ │ │ │ +00015ab0: 6e20 2a3a 3437 3131 2f74 6370 2073 6f63  n *:4711/tcp soc
│ │ │ │ +00015ac0: 6b65 7420 340a 0a1f 0a46 696c 653a 2073  ket 4....File: s
│ │ │ │ +00015ad0: 6869 7368 692e 696e 666f 2c20 204e 6f64  hishi.info,  Nod
│ │ │ │ +00015ae0: 653a 204d 756c 7469 706c 6520 7365 7276  e: Multiple serv
│ │ │ │ +00015af0: 6572 732c 2020 4e65 7874 3a20 4465 7665  ers,  Next: Deve
│ │ │ │ +00015b00: 6c6f 7065 7220 696e 666f 726d 6174 696f  loper informatio
│ │ │ │ +00015b10: 6e2c 2020 5072 6576 3a20 4b65 7262 6572  n,  Prev: Kerber
│ │ │ │ +00015b20: 6f73 2076 6961 2054 4c53 2c20 2055 703a  os via TLS,  Up:
│ │ │ │ +00015b30: 2041 646d 696e 6973 7472 6174 696f 6e20   Administration 
│ │ │ │ +00015b40: 4d61 6e75 616c 0a0a 332e 3720 4d75 6c74  Manual..3.7 Mult
│ │ │ │ +00015b50: 6970 6c65 2073 6572 7665 7273 0a3d 3d3d  iple servers.===
│ │ │ │ +00015b60: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ +00015b70: 3d0a 0a53 6574 7469 6e67 2075 7020 6d75  =..Setting up mu
│ │ │ │ +00015b80: 6c74 6970 6c65 2073 6572 7665 7273 2069  ltiple servers i
│ │ │ │ +00015b90: 7320 6173 2065 6173 7920 6173 2072 6570  s as easy as rep
│ │ │ │ +00015ba0: 6c69 6361 7469 6e67 2074 6865 2075 7365  licating the use
│ │ │ │ +00015bb0: 7220 6461 7461 6261 7365 2e0a 5369 6e63  r database..Sinc
│ │ │ │ +00015bc0: 6520 7468 6520 6465 6661 756c 7420 e280  e the default ..
│ │ │ │ +00015bd0: 9866 696c 65e2 8099 2075 7365 7220 6461  .file... user da
│ │ │ │ +00015be0: 7461 6261 7365 2069 7320 7374 6f72 6564  tabase is stored
│ │ │ │ +00015bf0: 2069 6e20 7468 6520 6e6f 726d 616c 2066   in the normal f
│ │ │ │ +00015c00: 696c 650a 7379 7374 656d 2c20 796f 7520  ile.system, you 
│ │ │ │ +00015c10: 6361 6e20 7573 6520 616e 7920 636f 6d6d  can use any comm
│ │ │ │ +00015c20: 6f6e 2074 6f6f 6c73 2074 6f20 7265 706c  on tools to repl
│ │ │ │ +00015c30: 6963 6174 6520 6120 6669 6c65 2073 7973  icate a file sys
│ │ │ │ +00015c40: 7465 6d2e 0a4e 6574 776f 726b 2066 696c  tem..Network fil
│ │ │ │ +00015c50: 6520 7379 7374 656d 206c 696b 6520 4e46  e system like NF
│ │ │ │ +00015c60: 5320 2870 726f 7065 726c 7920 7365 6375  S (properly secu
│ │ │ │ +00015c70: 7265 6420 6279 2c20 652e 672e 2c20 610a  red by, e.g., a.
│ │ │ │ +00015c80: 706f 696e 742d 746f 2d70 6f69 6e74 2073  point-to-point s
│ │ │ │ +00015c90: 796d 6d65 7472 6963 616c 6c79 2065 6e63  ymmetrically enc
│ │ │ │ +00015ca0: 7279 7074 6564 2049 5053 4543 2063 6f6e  rypted IPSEC con
│ │ │ │ +00015cb0: 6e65 6374 696f 6e29 2061 6e64 2066 696c  nection) and fil
│ │ │ │ +00015cc0: 650a 7379 6e63 6872 6f6e 697a 696e 6720  e.synchronizing 
│ │ │ │ +00015cd0: 746f 6f6c 7320 6c69 6b65 20e2 8098 7273  tools like ...rs
│ │ │ │ +00015ce0: 796e 63e2 8099 2061 7265 2074 7970 6963  ync... are typic
│ │ │ │ +00015cf0: 616c 2063 686f 6963 6573 2e0a 0a20 2020  al choices...   
│ │ │ │ +00015d00: 5468 6520 7365 636f 6e64 6172 7920 7365  The secondary se
│ │ │ │ +00015d10: 7276 6572 2073 686f 756c 6420 6265 2063  rver should be c
│ │ │ │ +00015d20: 6f6e 6669 6775 7265 6420 6a75 7374 206c  onfigured just l
│ │ │ │ +00015d30: 696b 6520 7468 6520 6d61 7374 6572 0a73  ike the master.s
│ │ │ │ +00015d40: 6572 7665 722e 2020 4966 2079 6f75 2075  erver.  If you u
│ │ │ │ +00015d50: 7365 2074 6865 20e2 8098 6669 6c65 e280  se the ...file..
│ │ │ │ +00015d60: 9920 6461 7461 6261 7365 206f 7665 7220  . database over 
│ │ │ │ +00015d70: 4e46 5320 796f 7520 646f 206e 6f74 2068  NFS you do not h
│ │ │ │ +00015d80: 6176 6520 746f 206d 616b 650a 616e 7920  ave to make.any 
│ │ │ │ +00015d90: 6d6f 6469 6669 6361 7469 6f6e 732e 2020  modifications.  
│ │ │ │ +00015da0: 4966 2079 6f75 2075 7365 2c20 652e 672e  If you use, e.g.
│ │ │ │ +00015db0: 2c20 6120 6372 6f6e 206a 6f62 2074 6f20  , a cron job to 
│ │ │ │ +00015dc0: e280 9872 7379 6e63 e280 9920 7468 650a  ...rsync... the.
│ │ │ │ +00015dd0: 6469 7265 6374 6f72 7920 6576 6572 7920  directory every 
│ │ │ │ +00015de0: 686f 7572 206f 7220 736f 2c20 796f 7520  hour or so, you 
│ │ │ │ +00015df0: 6d61 7920 7761 6e74 2074 6f20 6164 6420  may want to add 
│ │ │ │ +00015e00: 6120 e280 982d 2d72 6561 642d 6f6e 6c79  a ...--read-only
│ │ │ │ +00015e10: e280 9920 666c 6167 2074 6f0a 7468 6520  ... flag to.the 
│ │ │ │ +00015e20: 5368 6973 6120 e280 9864 62e2 8099 2064  Shisa ...db... d
│ │ │ │ +00015e30: 6566 696e 6974 696f 6e20 282a 6e6f 7465  efinition (*note
│ │ │ │ +00015e40: 2053 6869 7361 2043 6f6e 6669 6775 7261   Shisa Configura
│ │ │ │ +00015e50: 7469 6f6e 3a3a 292e 2020 5468 6174 2077  tion::).  That w
│ │ │ │ +00015e60: 6179 2c0a 6e6f 626f 6479 2077 696c 6c20  ay,.nobody will 
│ │ │ │ +00015e70: 6265 206c 7572 6564 2069 6e74 6f20 6372  be lured into cr
│ │ │ │ +00015e80: 6561 7469 6e67 206f 7220 6368 616e 6769  eating or changi
│ │ │ │ +00015e90: 6e67 2069 6e66 6f72 6d61 7469 6f6e 2069  ng information i
│ │ │ │ +00015ea0: 6e20 7468 650a 6461 7461 6261 7365 206f  n the.database o
│ │ │ │ +00015eb0: 6e20 7468 6520 7365 636f 6e64 6172 7920  n the secondary 
│ │ │ │ +00015ec0: 7365 7276 6572 2c20 7768 6963 6820 6f6e  server, which on
│ │ │ │ +00015ed0: 6c79 2077 6f75 6c64 2062 6520 6f76 6572  ly would be over
│ │ │ │ +00015ee0: 7772 6974 7465 6e20 6475 7269 6e67 0a74  written during.t
│ │ │ │ +00015ef0: 6865 206e 6578 7420 7379 6e63 6872 6f6e  he next synchron
│ │ │ │ +00015f00: 697a 6174 696f 6e2e 0a0a 2020 2020 2064  ization...     d
│ │ │ │ +00015f10: 6220 2d2d 7265 6164 2d6f 6e6c 7920 6669  b --read-only fi
│ │ │ │ +00015f20: 6c65 202f 7573 722f 6c6f 6361 6c2f 7661  le /usr/local/va
│ │ │ │ +00015f30: 722f 6261 636b 7570 2d73 6869 7368 690a  r/backup-shishi.
│ │ │ │ +00015f40: 0a20 2020 5468 6520 e280 9866 696c 65e2  .   The ...file.
│ │ │ │ +00015f50: 8099 2064 6174 6162 6173 6520 6973 2064  .. database is d
│ │ │ │ +00015f60: 6573 6967 6e65 6420 736f 2069 7420 646f  esigned so it do
│ │ │ │ +00015f70: 6573 6e27 7420 7265 7175 6972 6520 6669  esn't require fi
│ │ │ │ +00015f80: 6c65 206c 6f63 6b69 6e67 2069 6e0a 7468  le locking in.th
│ │ │ │ +00015f90: 6520 6669 6c65 2073 7973 7465 6d2c 2077  e file system, w
│ │ │ │ +00015fa0: 6869 6368 206d 6179 2062 6520 756e 7265  hich may be unre
│ │ │ │ +00015fb0: 6c69 6162 6c65 2069 6e20 736f 6d65 206e  liable in some n
│ │ │ │ +00015fc0: 6574 776f 726b 2066 696c 6520 7379 7374  etwork file syst
│ │ │ │ +00015fd0: 656d 7320 6f72 0a69 6d70 6c65 6d65 6e74  ems or.implement
│ │ │ │ +00015fe0: 6174 696f 6e73 2e20 2049 7420 6973 2061  ations.  It is a
│ │ │ │ +00015ff0: 6c73 6f20 6465 7369 676e 6564 2073 6f20  lso designed so 
│ │ │ │ +00016000: 7468 6174 206d 756c 7469 706c 6520 636f  that multiple co
│ │ │ │ +00016010: 6e63 7572 7265 6e74 0a72 6561 6465 7273  ncurrent.readers
│ │ │ │ +00016020: 2061 6e64 2077 7269 7465 7273 206d 6179   and writers may
│ │ │ │ +00016030: 2061 6363 6573 7320 7468 6520 6461 7461   access the data
│ │ │ │ +00016040: 6261 7365 2077 6974 686f 7574 2063 6175  base without cau
│ │ │ │ +00016050: 7369 6e67 2063 6f72 7275 7074 696f 6e2e  sing corruption.
│ │ │ │ +00016060: 0a0a 2020 202a 5761 726e 696e 673a 2a20  ..   *Warning:* 
│ │ │ │ +00016070: 5468 6520 6c61 7374 2070 6172 6167 7261  The last paragra
│ │ │ │ +00016080: 7068 2069 7320 6375 7272 656e 746c 7920  ph is currently 
│ │ │ │ +00016090: 6e6f 7420 636f 6d70 6c65 7465 6c79 2061  not completely a
│ │ │ │ +000160a0: 6363 7572 6174 652e 0a54 6865 7265 206d  ccurate..There m
│ │ │ │ +000160b0: 6179 2062 6520 7261 6365 2063 6f6e 6469  ay be race condi
│ │ │ │ +000160c0: 7469 6f6e 7320 7769 7468 2063 6f6e 6375  tions with concu
│ │ │ │ +000160d0: 7272 656e 7420 7772 6974 6572 732e 2020  rrent writers.  
│ │ │ │ +000160e0: 4e6f 6e65 2073 686f 756c 6420 6361 7573  None should caus
│ │ │ │ +000160f0: 650a 696e 6669 6e69 7465 206c 6f6f 7073  e.infinite loops
│ │ │ │ +00016100: 206f 7220 6461 7461 206c 6f73 732e 2020   or data loss.  
│ │ │ │ +00016110: 486f 7765 7665 722c 2075 6e65 7870 6563  However, unexpec
│ │ │ │ +00016120: 7465 6420 7265 7375 6c74 7320 6d69 6768  ted results migh
│ │ │ │ +00016130: 7420 6f63 6375 7220 6966 0a74 776f 2077  t occur if.two w
│ │ │ │ +00016140: 7269 7465 7273 2074 7279 2074 6f20 7570  riters try to up
│ │ │ │ +00016150: 6461 7465 2069 6e66 6f72 6d61 7469 6f6e  date information
│ │ │ │ +00016160: 2061 626f 7574 2061 2070 7269 6e63 6970   about a princip
│ │ │ │ +00016170: 616c 2073 696d 756c 7461 6e65 6f75 732e  al simultaneous.
│ │ │ │ +00016180: 0a0a 2020 2049 6620 796f 7520 7573 6520  ..   If you use 
│ │ │ │ +00016190: 6120 7265 6d6f 7465 204c 4441 5020 7365  a remote LDAP se
│ │ │ │ +000161a0: 7276 6572 206f 7220 5351 4c20 6461 7461  rver or SQL data
│ │ │ │ +000161b0: 6261 7365 2074 6f20 7374 6f72 6520 7468  base to store th
│ │ │ │ +000161c0: 6520 7573 6572 0a64 6174 6162 6173 652c  e user.database,
│ │ │ │ +000161d0: 2061 6e64 2061 6363 6573 7320 6974 2076   and access it v
│ │ │ │ +000161e0: 6961 2061 2053 6869 7361 2062 6163 6b65  ia a Shisa backe
│ │ │ │ +000161f0: 6e64 2c20 796f 7520 6861 7665 206d 616b  nd, you have mak
│ │ │ │ +00016200: 6520 7375 7265 2079 6f75 720a 5368 6973  e sure your.Shis
│ │ │ │ +00016210: 6120 6261 636b 656e 6420 6861 6e64 6c65  a backend handle
│ │ │ │ +00016220: 2063 6f6e 6375 7272 656e 7420 7772 6974   concurrent writ
│ │ │ │ +00016230: 6572 7320 7072 6f70 6572 6c79 2e20 2049  ers properly.  I
│ │ │ │ +00016240: 6620 796f 7520 7573 6520 6120 6d6f 6465  f you use a mode
│ │ │ │ +00016250: 726e 0a53 514c 2064 6174 6162 6173 652c  rn.SQL database,
│ │ │ │ +00016260: 2074 6869 7320 7072 6f62 6162 6c79 2069   this probably i
│ │ │ │ +00016270: 7320 6e6f 7420 6120 636f 6e63 6572 6e2e  s not a concern.
│ │ │ │ +00016280: 2020 4966 2069 7420 6973 2061 2070 726f    If it is a pro
│ │ │ │ +00016290: 626c 656d 2c20 796f 750a 6d61 7920 6265  blem, you.may be
│ │ │ │ +000162a0: 2061 626c 6520 746f 2077 6f72 6b20 6172   able to work ar
│ │ │ │ +000162b0: 6f75 6e64 2069 7420 6279 2069 6d70 6c65  ound it by imple
│ │ │ │ +000162c0: 6d65 6e74 696e 6720 736f 6d65 206b 696e  menting some kin
│ │ │ │ +000162d0: 6420 6f66 0a73 796e 6368 726f 6e69 7a61  d of.synchroniza
│ │ │ │ +000162e0: 7469 6f6e 206f 7220 7365 6d61 7068 6f72  tion or semaphor
│ │ │ │ +000162f0: 6520 6d65 6368 616e 6973 6d2e 2020 4966  e mechanism.  If
│ │ │ │ +00016300: 2061 6c6c 2065 6c73 6520 736f 756e 6473   all else sounds
│ │ │ │ +00016310: 2074 6f6f 0a63 6f6d 706c 6963 6174 6564   too.complicated
│ │ │ │ +00016320: 2c20 796f 7520 6361 6e20 7365 7420 7570  , you can set up
│ │ │ │ +00016330: 2074 6865 2073 6563 6f6e 6461 7279 2073   the secondary s
│ │ │ │ +00016340: 6572 7665 7273 2061 7320 e280 982d 2d72  ervers as ...--r
│ │ │ │ +00016350: 6561 642d 6f6e 6c79 e280 990a 7365 7276  ead-only....serv
│ │ │ │ +00016360: 6572 732c 2061 6c74 686f 7567 6820 796f  ers, although yo
│ │ │ │ +00016370: 7520 7769 6c6c 206c 6f73 6520 736f 6d65  u will lose some
│ │ │ │ +00016380: 2066 756e 6374 696f 6e61 6c69 7479 2028   functionality (
│ │ │ │ +00016390: 6c69 6b65 2063 6861 6e67 696e 670a 7061  like changing.pa
│ │ │ │ +000163a0: 7373 776f 7264 7320 7669 6120 7468 6520  sswords via the 
│ │ │ │ +000163b0: 7365 636f 6e64 6172 7920 7365 7276 6572  secondary server
│ │ │ │ +000163c0: 2c20 6f72 2075 7064 6174 696e 6720 7469  , or updating ti
│ │ │ │ +000163d0: 6d65 7374 616d 7073 2077 6865 6e20 7468  mestamps when th
│ │ │ │ +000163e0: 6520 6c61 7374 0a74 6963 6b65 7420 7265  e last.ticket re
│ │ │ │ +000163f0: 7175 6573 7420 6f63 6375 7272 6564 292e  quest occurred).
│ │ │ │ +00016400: 0a0a 2020 204f 6e65 2066 756e 6374 696f  ..   One functio
│ │ │ │ +00016410: 6e20 7468 6174 2069 7320 6f66 2070 6172  n that is of par
│ │ │ │ +00016420: 7469 6375 6c61 7220 7573 6520 666f 7220  ticular use for 
│ │ │ │ +00016430: 7573 6572 7320 7769 7468 2072 656d 6f74  users with remot
│ │ │ │ +00016440: 650a 6461 7461 6261 7365 7320 2862 6520  e.databases (be 
│ │ │ │ +00016450: 6974 204c 4441 5020 6f72 2053 514c 2920  it LDAP or SQL) 
│ │ │ │ +00016460: 6973 2074 6865 2022 6461 7461 6261 7365  is the "database
│ │ │ │ +00016470: 206f 7665 7272 6964 6522 2066 6561 7475   override" featu
│ │ │ │ +00016480: 7265 2e20 2055 7369 6e67 0a74 6869 7320  re.  Using.this 
│ │ │ │ +00016490: 796f 7520 6361 6e20 6861 7665 2074 6865  you can have the
│ │ │ │ +000164a0: 2073 6563 7572 6974 7920 6372 6974 6963   security critic
│ │ │ │ +000164b0: 616c 2070 7269 6e63 6970 616c 7320 2873  al principals (s
│ │ │ │ +000164c0: 7563 6820 6173 2074 6865 2074 6963 6b65  uch as the ticke
│ │ │ │ +000164d0: 740a 6772 616e 7469 6e67 2074 6963 6b65  t.granting ticke
│ │ │ │ +000164e0: 7429 2073 746f 7265 6420 6f6e 206c 6f63  t) stored on loc
│ │ │ │ +000164f0: 616c 2066 696c 6520 7379 7374 656d 2073  al file system s
│ │ │ │ +00016500: 746f 7261 6765 2c20 6275 7420 7573 6520  torage, but use 
│ │ │ │ +00016510: 7468 6520 7265 6d6f 7465 0a64 6174 6162  the remote.datab
│ │ │ │ +00016520: 6173 6520 666f 7220 7573 6572 2070 7269  ase for user pri
│ │ │ │ +00016530: 6e63 6970 616c 732e 2020 4f66 2063 6f75  ncipals.  Of cou
│ │ │ │ +00016540: 7273 652c 2079 6f75 206d 7573 7420 6b65  rse, you must ke
│ │ │ │ +00016550: 6570 2074 6865 206c 6f63 616c 2066 696c  ep the local fil
│ │ │ │ +00016560: 650a 7379 7374 656d 2073 746f 7261 6765  e.system storage
│ │ │ │ +00016570: 2073 796e 6368 726f 6e69 7a65 6420 6265   synchronized be
│ │ │ │ +00016580: 7477 6565 6e20 616c 6c20 7365 7276 6572  tween all server
│ │ │ │ +00016590: 732c 2061 7320 6265 666f 7265 2e20 2048  s, as before.  H
│ │ │ │ +000165a0: 6572 6520 6973 2061 6e0a 6578 616d 706c  ere is an.exampl
│ │ │ │ +000165b0: 6520 636f 6e66 6967 7572 6174 696f 6e2e  e configuration.
│ │ │ │ +000165c0: 0a0a 2020 2020 2064 6220 2d2d 7265 6164  ..     db --read
│ │ │ │ +000165d0: 2d6f 6e6c 7920 6669 6c65 202f 7661 722f  -only file /var/
│ │ │ │ +000165e0: 6c6f 6361 6c2f 6d61 7374 6572 0a20 2020  local/master.   
│ │ │ │ +000165f0: 2020 6462 206c 6461 7020 6b64 632e 6578    db ldap kdc.ex
│ │ │ │ +00016600: 616d 706c 652e 6f72 6720 6361 3d2f 6574  ample.org ca=/et
│ │ │ │ +00016610: 632f 7368 6973 612f 6b64 632d 6361 2e70  c/shisa/kdc-ca.p
│ │ │ │ +00016620: 656d 0a0a 2020 2054 6869 7320 696e 7374  em..   This inst
│ │ │ │ +00016630: 7275 6374 2074 6865 2053 6869 7361 206c  ruct the Shisa l
│ │ │ │ +00016640: 6962 7261 7279 2074 6f20 6163 6365 7373  ibrary to access
│ │ │ │ +00016650: 2074 6865 2074 776f 2064 6174 6162 6173   the two databas
│ │ │ │ +00016660: 6573 0a73 6571 7565 6e74 6961 6c6c 792c  es.sequentially,
│ │ │ │ +00016670: 2066 6f72 2065 6163 6820 7175 6572 7920   for each query 
│ │ │ │ +00016680: 7573 696e 6720 7468 6520 6669 7273 7420  using the first 
│ │ │ │ +00016690: 6461 7461 6261 7365 2074 6861 7420 6b6e  database that kn
│ │ │ │ +000166a0: 6f77 2061 626f 7574 0a74 6865 2072 6571  ow about.the req
│ │ │ │ +000166b0: 7565 7374 6564 2070 7269 6e63 6970 616c  uested principal
│ │ │ │ +000166c0: 2e20 2049 6620 796f 7520 7075 7420 7468  .  If you put th
│ │ │ │ +000166d0: 6520 e280 986b 7262 7467 742f 5245 414c  e ...krbtgt/REAL
│ │ │ │ +000166e0: 4de2 8099 2070 7269 6e63 6970 616c 2069  M... principal i
│ │ │ │ +000166f0: 6e20 7468 650a 6c6f 6361 6c20 e280 9866  n the.local ...f
│ │ │ │ +00016700: 696c 65e2 8099 2064 6174 6162 6173 652c  ile... database,
│ │ │ │ +00016710: 2074 6869 7320 7769 6c6c 206f 7665 7272   this will overr
│ │ │ │ +00016720: 6964 6520 7468 6520 4c44 4150 2069 6e74  ide the LDAP int
│ │ │ │ +00016730: 6572 6661 6365 2e0a 4e61 7475 7261 6c6c  erface..Naturall
│ │ │ │ +00016740: 792c 2079 6f75 2063 616e 2068 6176 6520  y, you can have 
│ │ │ │ +00016750: 6173 206d 616e 7920 e280 9864 62e2 8099  as many ...db...
│ │ │ │ +00016760: 2064 6566 696e 6974 696f 6e20 6c69 6e65   definition line
│ │ │ │ +00016770: 7320 6173 2079 6f75 2077 6973 682e 0a0a  s as you wish...
│ │ │ │ +00016780: 2020 2055 7365 7273 2077 6974 6820 7265     Users with re
│ │ │ │ +00016790: 6d6f 7465 2064 6174 6162 6173 6573 2063  mote databases c
│ │ │ │ +000167a0: 616e 2061 6c73 6f20 696e 7665 7374 6967  an also investig
│ │ │ │ +000167b0: 6174 6520 6120 736f 2063 616c 6c65 6420  ate a so called 
│ │ │ │ +000167c0: 4869 6768 0a41 7661 696c 6162 696c 6974  High.Availabilit
│ │ │ │ +000167d0: 7920 6d6f 6465 2e20 2054 6869 7320 6973  y mode.  This is
│ │ │ │ +000167e0: 2075 7365 6675 6c20 6966 2079 6f75 2077   useful if you w
│ │ │ │ +000167f0: 6973 6820 746f 2068 6176 6520 796f 7572  ish to have your
│ │ │ │ +00016800: 204b 6572 6265 726f 730a 7365 7276 6572   Kerberos.server
│ │ │ │ +00016810: 7320 6265 2061 626c 6520 746f 2063 6f6e  s be able to con
│ │ │ │ +00016820: 7469 6e75 6520 746f 206f 7065 7261 7465  tinue to operate
│ │ │ │ +00016830: 2065 7665 6e20 7768 656e 2074 6865 2072   even when the r
│ │ │ │ +00016840: 656d 6f74 6520 6461 7461 6261 7365 2069  emote database i
│ │ │ │ +00016850: 730a 6f66 666c 696e 652e 2020 5468 6973  s.offline.  This
│ │ │ │ +00016860: 2069 7320 6163 6869 6576 6564 2076 6961   is achieved via
│ │ │ │ +00016870: 2074 6865 20e2 8098 2d2d 6967 6e6f 7265   the ...--ignore
│ │ │ │ +00016880: 2d65 7272 6f72 73e2 8099 2066 6c61 6720  -errors... flag 
│ │ │ │ +00016890: 696e 2074 6865 0a64 6174 6162 6173 6520  in the.database 
│ │ │ │ +000168a0: 6465 6669 6e69 7469 6f6e 2e20 2048 6572  definition.  Her
│ │ │ │ +000168b0: 6520 6973 2061 2073 616d 706c 6520 636f  e is a sample co
│ │ │ │ +000168c0: 6e66 6967 7572 6174 696f 6e2e 0a0a 2020  nfiguration...  
│ │ │ │ +000168d0: 2020 2064 6220 2d2d 6967 6e6f 7265 2d65     db --ignore-e
│ │ │ │ +000168e0: 7272 6f72 7320 6c64 6170 206b 6463 2e65  rrors ldap kdc.e
│ │ │ │ +000168f0: 7861 6d70 6c65 2e6f 7267 2063 613d 2f65  xample.org ca=/e
│ │ │ │ +00016900: 7463 2f73 6869 7361 2f6b 6463 2d63 612e  tc/shisa/kdc-ca.
│ │ │ │ +00016910: 7065 6d0a 2020 2020 2064 6220 2d2d 7265  pem.     db --re
│ │ │ │ +00016920: 6164 2d6f 6e6c 7920 6669 6c65 202f 7661  ad-only file /va
│ │ │ │ +00016930: 722f 6361 6368 652f 6c64 6170 2d63 6f70  r/cache/ldap-cop
│ │ │ │ +00016940: 790a 0a20 2020 5468 6973 2069 6e73 7472  y..   This instr
│ │ │ │ +00016950: 7563 7420 7468 6520 5368 6973 6120 6c69  uct the Shisa li
│ │ │ │ +00016960: 6272 6172 7920 746f 2074 7279 2074 6865  brary to try the
│ │ │ │ +00016970: 204c 4441 5020 6261 636b 656e 6420 6669   LDAP backend fi
│ │ │ │ +00016980: 7273 742c 2062 7574 2069 660a 6974 2066  rst, but if.it f
│ │ │ │ +00016990: 6169 6c73 2c20 696e 7374 6561 6420 6f66  ails, instead of
│ │ │ │ +000169a0: 2072 6574 7572 6e69 6e67 2061 6e20 6572   returning an er
│ │ │ │ +000169b0: 726f 722c 2063 6f6e 7469 6e75 6520 746f  ror, continue to
│ │ │ │ +000169c0: 2074 7279 2074 6865 206f 7065 7261 7469   try the operati
│ │ │ │ +000169d0: 6f6e 0a6f 6e20 6120 7265 6164 206f 6e6c  on.on a read onl
│ │ │ │ +000169e0: 7920 6c6f 6361 6c20 e280 9866 696c 65e2  y local ...file.
│ │ │ │ +000169f0: 8099 2062 6173 6564 2064 6174 6162 6173  .. based databas
│ │ │ │ +00016a00: 652e 2020 4f66 2063 6f75 7273 652c 2077  e.  Of course, w
│ │ │ │ +00016a10: 7269 7465 2072 6571 7565 7374 730a 7769  rite requests.wi
│ │ │ │ +00016a20: 6c6c 2073 7469 6c6c 2066 6169 6c2c 2062  ll still fail, b
│ │ │ │ +00016a30: 7574 2069 7420 6d61 7920 6265 2062 6574  ut it may be bet
│ │ │ │ +00016a40: 7465 7220 7468 616e 2068 616c 7469 6e67  ter than halting
│ │ │ │ +00016a50: 2074 6865 2073 6572 7665 720a 636f 6d70   the server.comp
│ │ │ │ +00016a60: 6c65 7465 6c79 2e20 2054 6f20 6d61 6b65  letely.  To make
│ │ │ │ +00016a70: 2074 6869 7320 776f 726b 2c20 796f 7520   this work, you 
│ │ │ │ +00016a80: 6669 7273 7420 6e65 6564 2074 6f20 7365  first need to se
│ │ │ │ +00016a90: 7420 7570 2061 2063 726f 6e20 6a6f 6220  t up a cron job 
│ │ │ │ +00016aa0: 6f6e 0a61 2c20 7361 792c 2068 6f75 726c  on.a, say, hourl
│ │ │ │ +00016ab0: 7920 6261 7369 732c 2074 6f20 6d61 6b65  y basis, to make
│ │ │ │ +00016ac0: 2061 2063 6f70 7920 6f66 2074 6865 2072   a copy of the r
│ │ │ │ +00016ad0: 656d 6f74 6520 6461 7461 6261 7365 2061  emote database a
│ │ │ │ +00016ae0: 6e64 2073 746f 7265 2069 740a 696e 2074  nd store it.in t
│ │ │ │ +00016af0: 6865 206c 6f63 616c 2066 696c 6520 6461  he local file da
│ │ │ │ +00016b00: 7461 6261 7365 2e20 2054 6861 7420 7761  tabase.  That wa
│ │ │ │ +00016b10: 792c 2077 6865 6e20 7468 6520 7265 6d6f  y, when the remo
│ │ │ │ +00016b20: 7465 2073 6572 7665 7220 676f 6573 2061  te server goes a
│ │ │ │ +00016b30: 7761 792c 0a66 6169 726c 7920 6375 7272  way,.fairly curr
│ │ │ │ +00016b40: 656e 7420 696e 666f 726d 6174 696f 6e20  ent information 
│ │ │ │ +00016b50: 7769 6c6c 2073 7469 6c6c 2062 6520 6176  will still be av
│ │ │ │ +00016b60: 6169 6c61 626c 6520 6c6f 6361 6c6c 792e  ailable locally.
│ │ │ │ +00016b70: 0a0a 2020 2049 6620 796f 7520 616c 736f  ..   If you also
│ │ │ │ +00016b80: 2077 6973 6820 746f 2065 7870 6572 696d   wish to experim
│ │ │ │ +00016b90: 656e 7420 7769 7468 2072 6561 642d 7772  ent with read-wr
│ │ │ │ +00016ba0: 6974 6520 6661 696c 206f 7665 722c 2068  ite fail over, h
│ │ │ │ +00016bb0: 6572 6520 6973 2061 6e0a 6964 6561 2066  ere is an.idea f
│ │ │ │ +00016bc0: 6f72 2074 6865 2063 6f6e 6669 6775 7261  or the configura
│ │ │ │ +00016bd0: 7469 6f6e 2e0a 0a20 2020 2020 6462 202d  tion...     db -
│ │ │ │ +00016be0: 2d69 676e 6f72 652d 6572 726f 7273 206c  -ignore-errors l
│ │ │ │ +00016bf0: 6461 7020 6b64 632e 6578 616d 706c 652e  dap kdc.example.
│ │ │ │ +00016c00: 6f72 6720 6361 3d2f 6574 632f 7368 6973  org ca=/etc/shis
│ │ │ │ +00016c10: 612f 6b64 632d 6361 2e70 656d 0a20 2020  a/kdc-ca.pem.   
│ │ │ │ +00016c20: 2020 6462 202d 2d69 676e 6f72 652d 6572    db --ignore-er
│ │ │ │ +00016c30: 726f 7273 202d 2d72 6561 642d 6f6e 6c79  rors --read-only
│ │ │ │ +00016c40: 2066 696c 6520 2f76 6172 2f63 6163 6865   file /var/cache
│ │ │ │ +00016c50: 2f6c 6461 702d 636f 7079 0a20 2020 2020  /ldap-copy.     
│ │ │ │ +00016c60: 6462 2066 696c 6520 2f76 6172 2f63 6163  db file /var/cac
│ │ │ │ +00016c70: 6865 2f6c 6f63 616c 2d75 7064 6174 6573  he/local-updates
│ │ │ │ +00016c80: 0a0a 2020 2054 6869 7320 6973 2073 696d  ..   This is sim
│ │ │ │ +00016c90: 696c 6172 2074 6f20 7468 6520 7072 6576  ilar to the prev
│ │ │ │ +00016ca0: 696f 7573 2c20 6275 7420 6974 2077 696c  ious, but it wil
│ │ │ │ +00016cb0: 6c20 6967 6e6f 7265 2065 7272 6f72 7320  l ignore errors 
│ │ │ │ +00016cc0: 7265 6164 696e 670a 616e 6420 7772 6974  reading.and writ
│ │ │ │ +00016cd0: 696e 6720 6672 6f6d 2074 6865 2066 6972  ing from the fir
│ │ │ │ +00016ce0: 7374 2074 776f 2064 6174 6162 6173 6573  st two databases
│ │ │ │ +00016cf0: 2c20 756c 7469 6d61 7465 6c79 2063 6175  , ultimately cau
│ │ │ │ +00016d00: 7369 6e67 2077 7269 7465 0a61 7474 656d  sing write.attem
│ │ │ │ +00016d10: 7074 7320 746f 2065 6e64 2075 7020 696e  pts to end up in
│ │ │ │ +00016d20: 2074 6865 2066 696e 616c 20e2 8098 6669   the final ...fi
│ │ │ │ +00016d30: 6c65 e280 9920 6261 7365 6420 6461 7461  le... based data
│ │ │ │ +00016d40: 6261 7365 2e20 204f 6620 636f 7572 7365  base.  Of course
│ │ │ │ +00016d50: 2c20 796f 750a 776f 756c 6420 6e65 6564  , you.would need
│ │ │ │ +00016d60: 2074 6f20 6372 6561 7465 2074 6f6f 6c73   to create tools
│ │ │ │ +00016d70: 2074 6f20 6665 6564 2062 6163 6b20 616e   to feed back an
│ │ │ │ +00016d80: 7920 6c6f 6361 6c20 7570 6461 7465 7320  y local updates 
│ │ │ │ +00016d90: 6d61 6465 2077 6869 6c65 2074 6865 0a72  made while the.r
│ │ │ │ +00016da0: 656d 6f74 6520 7365 7276 6572 2077 6173  emote server was
│ │ │ │ +00016db0: 2064 6f77 6e2e 2020 4974 206d 6179 2061   down.  It may a
│ │ │ │ +00016dc0: 6c73 6f20 6265 206e 6563 6573 7361 7279  lso be necessary
│ │ │ │ +00016dd0: 2074 6f20 6372 6561 7465 2061 2073 7065   to create a spe
│ │ │ │ +00016de0: 6369 616c 0a62 6163 6b65 6e64 2066 6f72  cial.backend for
│ │ │ │ +00016df0: 2074 6869 7320 7075 7270 6f73 652c 2077   this purpose, w
│ │ │ │ +00016e00: 6869 6368 2063 616e 2061 7574 6f20 6372  hich can auto cr
│ │ │ │ +00016e10: 6561 7465 2070 7269 6e63 6970 616c 7320  eate principals 
│ │ │ │ +00016e20: 7468 6174 2061 7265 0a75 7365 642e 0a0a  that are.used...
│ │ │ │ +00016e30: 2020 2057 6520 6669 6e69 7368 2077 6974     We finish wit
│ │ │ │ +00016e40: 6820 616e 2065 7861 6d70 6c65 2074 6861  h an example tha
│ │ │ │ +00016e50: 7420 6465 6d6f 6e73 7472 6174 6520 616c  t demonstrate al
│ │ │ │ +00016e60: 6c20 7468 6520 6964 6561 7320 7072 6573  l the ideas pres
│ │ │ │ +00016e70: 656e 7465 642e 0a0a 2020 2020 2064 6220  ented...     db 
│ │ │ │ +00016e80: 2d2d 7265 6164 2d6f 6e6c 7920 6669 6c65  --read-only file
│ │ │ │ +00016e90: 202f 7661 722f 6c6f 6361 6c2f 6d61 7374   /var/local/mast
│ │ │ │ +00016ea0: 6572 0a20 2020 2020 6462 202d 2d69 676e  er.     db --ign
│ │ │ │ +00016eb0: 6f72 652d 6572 726f 7273 206c 6461 7020  ore-errors ldap 
│ │ │ │ +00016ec0: 6b64 632e 6578 616d 706c 652e 6f72 6720  kdc.example.org 
│ │ │ │ +00016ed0: 6361 3d2f 6574 632f 7368 6973 612f 6b64  ca=/etc/shisa/kd
│ │ │ │ +00016ee0: 632d 6361 2e70 656d 0a20 2020 2020 6462  c-ca.pem.     db
│ │ │ │ +00016ef0: 202d 2d69 676e 6f72 652d 6572 726f 7273   --ignore-errors
│ │ │ │ +00016f00: 202d 2d72 6561 642d 6f6e 6c79 2066 696c   --read-only fil
│ │ │ │ +00016f10: 6520 2f76 6172 2f63 6163 6865 2f6c 6461  e /var/cache/lda
│ │ │ │ +00016f20: 702d 636f 7079 0a20 2020 2020 6462 2066  p-copy.     db f
│ │ │ │ +00016f30: 696c 6520 2f76 6172 2f63 6163 6865 2f6c  ile /var/cache/l
│ │ │ │ +00016f40: 6f63 616c 2d75 7064 6174 6573 0a0a 1f0a  ocal-updates....
│ │ │ │ +00016f50: 4669 6c65 3a20 7368 6973 6869 2e69 6e66  File: shishi.inf
│ │ │ │ +00016f60: 6f2c 2020 4e6f 6465 3a20 4465 7665 6c6f  o,  Node: Develo
│ │ │ │ +00016f70: 7065 7220 696e 666f 726d 6174 696f 6e2c  per information,
│ │ │ │ +00016f80: 2020 5072 6576 3a20 4d75 6c74 6970 6c65    Prev: Multiple
│ │ │ │ +00016f90: 2073 6572 7665 7273 2c20 2055 703a 2041   servers,  Up: A
│ │ │ │ +00016fa0: 646d 696e 6973 7472 6174 696f 6e20 4d61  dministration Ma
│ │ │ │ +00016fb0: 6e75 616c 0a0a 332e 3820 4465 7665 6c6f  nual..3.8 Develo
│ │ │ │ +00016fc0: 7065 7220 696e 666f 726d 6174 696f 6e0a  per information.
│ │ │ │  00016fd0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ -00016fe0: 3d3d 3d3d 3d3d 3d0a 0a54 6865 2050 726f  =======..The Pro
│ │ │ │ -00016ff0: 6772 616d 6d69 6e67 2041 5049 2066 6f72  gramming API for
│ │ │ │ -00017000: 2053 6869 7361 2069 7320 6465 7363 7269   Shisa is descri
│ │ │ │ -00017010: 6265 6420 6265 6c6f 7720 282a 6e6f 7465  bed below (*note
│ │ │ │ -00017020: 204b 6572 6265 726f 730a 4461 7461 6261   Kerberos.Databa
│ │ │ │ -00017030: 7365 2046 756e 6374 696f 6e73 3a3a 293b  se Functions::);
│ │ │ │ -00017040: 2074 6869 7320 7365 6374 696f 6e20 6973   this section is
│ │ │ │ -00017050: 2061 626f 7574 2065 7874 656e 6469 6e67   about extending
│ │ │ │ -00017060: 2053 6869 7361 2c20 616e 640a 636f 6e73   Shisa, and.cons
│ │ │ │ -00017070: 6571 7565 6e74 6c79 2053 6869 7368 692c  equently Shishi,
│ │ │ │ -00017080: 2074 6f20 7573 6520 796f 7572 206f 776e   to use your own
│ │ │ │ -00017090: 2075 7365 7220 6461 7461 6261 7365 2073   user database s
│ │ │ │ -000170a0: 7973 7465 6d2e 2020 596f 7520 6d61 7920  ystem.  You may 
│ │ │ │ -000170b0: 7761 6e74 0a74 6f20 7374 6f72 6520 796f  want.to store yo
│ │ │ │ -000170c0: 7572 204b 6572 6265 726f 7320 7573 6572  ur Kerberos user
│ │ │ │ -000170d0: 2069 6e66 6f72 6d61 7469 6f6e 206f 6e20   information on 
│ │ │ │ -000170e0: 616e 204c 4441 5020 6461 7461 6261 7365  an LDAP database
│ │ │ │ -000170f0: 2073 6572 7665 722c 2066 6f72 0a65 7861   server, for.exa
│ │ │ │ -00017100: 6d70 6c65 2e0a 0a20 2020 4164 6469 6e67  mple...   Adding
│ │ │ │ -00017110: 2061 206e 6577 2062 6163 6b65 6e64 2069   a new backend i
│ │ │ │ -00017120: 7320 7374 7261 6967 6874 2066 6f72 7761  s straight forwa
│ │ │ │ -00017130: 7264 2e20 2059 6f75 206e 6565 6420 746f  rd.  You need to
│ │ │ │ -00017140: 2069 6d70 6c65 6d65 6e74 2074 6865 0a62   implement the.b
│ │ │ │ -00017150: 6163 6b65 6e64 2041 5049 2066 756e 6374  ackend API funct
│ │ │ │ -00017160: 696f 6e20 7365 742c 2061 6464 2074 6865  ion set, add the
│ │ │ │ -00017170: 206c 6973 7420 6f66 2041 5049 2066 756e   list of API fun
│ │ │ │ -00017180: 6374 696f 6e73 2074 6f20 e280 9864 622f  ctions to ...db/
│ │ │ │ -00017190: 6462 2e63 e280 9920 616e 640a 706f 7373  db.c... and.poss
│ │ │ │ -000171a0: 6962 6c79 2061 6c73 6f20 6164 6420 616e  ibly also add an
│ │ │ │ -000171b0: 7920 6c69 6272 6172 7920 6465 7065 6e64  y library depend
│ │ │ │ -000171c0: 656e 6369 6573 2074 6f20 7468 6520 4d61  encies to the Ma
│ │ │ │ -000171d0: 6b65 6669 6c65 2e0a 0a20 2020 5468 6520  kefile...   The 
│ │ │ │ -000171e0: 7369 6d70 6c65 7374 2077 6179 2074 6f20  simplest way to 
│ │ │ │ -000171f0: 7772 6974 6520 6120 6e65 7720 6261 636b  write a new back
│ │ │ │ -00017200: 656e 6420 6973 2074 6f20 7374 6172 7420  end is to start 
│ │ │ │ -00017210: 6672 6f6d 2074 6865 2065 7869 7374 696e  from the existin
│ │ │ │ -00017220: 670a e280 9866 696c 65e2 8099 2062 6173  g....file... bas
│ │ │ │ -00017230: 6564 2064 6174 6162 6173 652c 2069 6e20  ed database, in 
│ │ │ │ -00017240: e280 9864 622f 6669 6c65 2e63 e280 992c  ...db/file.c...,
│ │ │ │ -00017250: 2061 6e64 206d 6f64 6966 7920 7468 6520   and modify the 
│ │ │ │ -00017260: 656e 7472 7920 706f 696e 7473 2061 730a  entry points as.
│ │ │ │ -00017270: 6e65 6564 6564 2e0a 0a20 2020 4e6f 7465  needed...   Note
│ │ │ │ -00017280: 2074 6861 7420 7468 6520 6375 7272 656e   that the curren
│ │ │ │ -00017290: 7420 6261 636b 656e 6420 4150 4920 7769  t backend API wi
│ │ │ │ -000172a0: 6c6c 206c 696b 656c 7920 6368 616e 6765  ll likely change
│ │ │ │ -000172b0: 2062 6566 6f72 6520 6974 2069 730a 6672   before it is.fr
│ │ │ │ -000172c0: 6f7a 656e 2e20 2057 6520 6d61 7920 6465  ozen.  We may de
│ │ │ │ -000172d0: 7363 7269 6265 2069 7420 696e 2064 6574  scribe it in det
│ │ │ │ -000172e0: 6169 6c20 6865 7265 2077 6865 6e20 6974  ail here when it
│ │ │ │ -000172f0: 2068 6173 206d 6174 7572 6564 2e0a 486f   has matured..Ho
│ │ │ │ -00017300: 7765 7665 722c 2063 7572 7265 6e74 6c79  wever, currently
│ │ │ │ -00017310: 2069 7420 6973 2073 696d 696c 6172 2074   it is similar t
│ │ │ │ -00017320: 6f20 7468 6520 6578 7465 726e 616c 2053  o the external S
│ │ │ │ -00017330: 6869 7361 2041 5049 2028 2a6e 6f74 650a  hisa API (*note.
│ │ │ │ -00017340: 4b65 7262 6572 6f73 2044 6174 6162 6173  Kerberos Databas
│ │ │ │ -00017350: 6520 4675 6e63 7469 6f6e 733a 3a29 2e0a  e Functions::)..
│ │ │ │ -00017360: 0a20 2020 5468 6572 6520 7368 6f75 6c64  .   There should
│ │ │ │ -00017370: 2062 6520 6e6f 206e 6565 6420 746f 206d   be no need to m
│ │ │ │ -00017380: 6f64 6966 7920 616e 7974 6869 6e67 2065  odify anything e
│ │ │ │ -00017390: 6c73 6520 696e 2074 6865 2053 6869 7361  lse in the Shisa
│ │ │ │ -000173a0: 206c 6962 7261 7279 2c0a 616e 6420 6365   library,.and ce
│ │ │ │ -000173b0: 7274 6169 6e6c 7920 6e6f 7420 696e 2074  rtainly not in t
│ │ │ │ -000173c0: 6865 2053 6869 7368 6920 6c69 6272 6172  he Shishi librar
│ │ │ │ -000173d0: 7920 6f72 2074 6865 20e2 8098 7368 6973  y or the ...shis
│ │ │ │ -000173e0: 6869 64e2 8099 2073 6572 7665 722e 0a0a  hid... server...
│ │ │ │ -000173f0: 2020 204e 6174 7572 616c 6c79 2c20 7765     Naturally, we
│ │ │ │ -00017400: 2077 6f75 6c64 2061 7070 7265 6369 6174   would appreciat
│ │ │ │ -00017410: 6520 6966 2079 6f75 2077 6f75 6c64 2073  e if you would s
│ │ │ │ -00017420: 656e 6420 7573 2079 6f75 7220 6e65 7720  end us your new 
│ │ │ │ -00017430: 6261 636b 656e 642c 0a69 6620 796f 7520  backend,.if you 
│ │ │ │ -00017440: 6265 6c69 6576 6520 6974 2069 7320 6765  believe it is ge
│ │ │ │ -00017450: 6e65 7261 6c6c 7920 7573 6566 756c 2028  nerally useful (
│ │ │ │ -00017460: 2a6e 6f74 6520 4275 6720 5265 706f 7274  *note Bug Report
│ │ │ │ -00017470: 733a 3a29 2e0a 0a1f 0a46 696c 653a 2073  s::).....File: s
│ │ │ │ -00017480: 6869 7368 692e 696e 666f 2c20 204e 6f64  hishi.info,  Nod
│ │ │ │ -00017490: 653a 2052 6566 6572 656e 6365 204d 616e  e: Reference Man
│ │ │ │ -000174a0: 7561 6c2c 2020 4e65 7874 3a20 5072 6f67  ual,  Next: Prog
│ │ │ │ -000174b0: 7261 6d6d 696e 6720 4d61 6e75 616c 2c20  ramming Manual, 
│ │ │ │ -000174c0: 2050 7265 763a 2041 646d 696e 6973 7472   Prev: Administr
│ │ │ │ -000174d0: 6174 696f 6e20 4d61 6e75 616c 2c20 2055  ation Manual,  U
│ │ │ │ -000174e0: 703a 2054 6f70 0a0a 3420 5265 6665 7265  p: Top..4 Refere
│ │ │ │ -000174f0: 6e63 6520 4d61 6e75 616c 0a2a 2a2a 2a2a  nce Manual.*****
│ │ │ │ -00017500: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a54  *************..T
│ │ │ │ -00017510: 6869 7320 6368 6170 7465 7220 6469 7363  his chapter disc
│ │ │ │ -00017520: 7573 7320 7468 6520 756e 6465 726c 7969  uss the underlyi
│ │ │ │ -00017530: 6e67 2061 7373 756d 7074 696f 6e73 206f  ng assumptions o
│ │ │ │ -00017540: 6620 4b65 7262 6572 6f73 2c20 636f 6e74  f Kerberos, cont
│ │ │ │ -00017550: 6169 6e20 610a 676c 6f73 7361 7279 2074  ain a.glossary t
│ │ │ │ -00017560: 6f20 4b65 7262 6572 6f73 2063 6f6e 6365  o Kerberos conce
│ │ │ │ -00017570: 7074 732c 2067 6976 6520 796f 7520 6261  pts, give you ba
│ │ │ │ -00017580: 636b 6772 6f75 6e64 2069 6e66 6f72 6d61  ckground informa
│ │ │ │ -00017590: 7469 6f6e 206f 6e0a 6368 6f6f 7369 6e67  tion on.choosing
│ │ │ │ -000175a0: 2072 6561 6c6d 2061 6e64 2070 7269 6e63   realm and princ
│ │ │ │ -000175b0: 6970 616c 206e 616d 6573 2c20 616e 6420  ipal names, and 
│ │ │ │ -000175c0: 6465 7363 7269 6265 2061 6c6c 2070 6172  describe all par
│ │ │ │ -000175d0: 616d 6574 6572 7320 616e 640a 636f 6e66  ameters and.conf
│ │ │ │ -000175e0: 6967 7572 6174 696f 6e20 6669 6c65 2073  iguration file s
│ │ │ │ -000175f0: 796e 7461 7865 7320 666f 7220 7468 6520  yntaxes for the 
│ │ │ │ -00017600: 5368 6973 6869 2074 6f6f 6c73 2e0a 0a2a  Shishi tools...*
│ │ │ │ -00017610: 204d 656e 753a 0a0a 2a20 456e 7669 726f   Menu:..* Enviro
│ │ │ │ -00017620: 6e6d 656e 7461 6c20 4173 7375 6d70 7469  nmental Assumpti
│ │ │ │ -00017630: 6f6e 733a 3a20 2020 4b65 7262 6572 6f73  ons::   Kerberos
│ │ │ │ -00017640: 2035 2061 7373 756d 7074 696f 6e73 2061   5 assumptions a
│ │ │ │ -00017650: 626f 7574 2079 6f75 7220 7379 7374 656d  bout your system
│ │ │ │ -00017660: 2e0a 2a20 476c 6f73 7361 7279 206f 6620  ..* Glossary of 
│ │ │ │ -00017670: 7465 726d 733a 3a20 2020 2020 2020 2020  terms::         
│ │ │ │ -00017680: 2020 476c 6f73 7361 7279 206f 6620 4b65    Glossary of Ke
│ │ │ │ -00017690: 7262 6572 6f73 2072 656c 6174 6564 2074  rberos related t
│ │ │ │ -000176a0: 6572 6d69 6e6f 6c6f 6779 2e0a 2a20 5265  erminology..* Re
│ │ │ │ -000176b0: 616c 6d20 616e 6420 5072 696e 6369 7061  alm and Principa
│ │ │ │ -000176c0: 6c20 4e61 6d69 6e67 3a3a 2020 486f 7720  l Naming::  How 
│ │ │ │ -000176d0: 746f 206e 616d 6520 796f 7572 2072 6561  to name your rea
│ │ │ │ -000176e0: 6c6d 2061 6e64 2070 7269 6e63 6970 616c  lm and principal
│ │ │ │ -000176f0: 732e 0a2a 2053 6869 7368 6920 436f 6e66  s..* Shishi Conf
│ │ │ │ -00017700: 6967 7572 6174 696f 6e3a 3a20 2020 2020  iguration::     
│ │ │ │ -00017710: 2020 2045 7870 6c61 696e 7320 7468 6520     Explains the 
│ │ │ │ -00017720: 436f 7265 2053 6869 7368 6920 636f 6e66  Core Shishi conf
│ │ │ │ -00017730: 6967 7572 6174 696f 6e20 6669 6c65 2e0a  iguration file..
│ │ │ │ -00017740: 2a20 5368 6973 6120 436f 6e66 6967 7572  * Shisa Configur
│ │ │ │ -00017750: 6174 696f 6e3a 3a20 2020 2020 2020 2020  ation::         
│ │ │ │ -00017760: 4578 706c 6169 6e73 2074 6865 2053 6869  Explains the Shi
│ │ │ │ -00017770: 7361 2064 6174 6162 6173 6520 6465 6669  sa database defi
│ │ │ │ -00017780: 6e69 7469 6f6e 2066 696c 652e 0a2a 2050  nition file..* P
│ │ │ │ -00017790: 6172 616d 6574 6572 7320 666f 7220 7368  arameters for sh
│ │ │ │ -000177a0: 6973 6869 3a3a 2020 2020 2020 2043 6f6d  ishi::       Com
│ │ │ │ -000177b0: 6d61 6e64 206c 696e 6520 7061 7261 6d65  mand line parame
│ │ │ │ -000177c0: 7465 7273 2066 6f72 2027 7368 6973 6869  ters for 'shishi
│ │ │ │ -000177d0: 272e 0a2a 2050 6172 616d 6574 6572 7320  '..* Parameters 
│ │ │ │ -000177e0: 666f 7220 7368 6973 6869 643a 3a20 2020  for shishid::   
│ │ │ │ -000177f0: 2020 2043 6f6d 6d61 6e64 206c 696e 6520     Command line 
│ │ │ │ -00017800: 7061 7261 6d65 7465 7273 2066 6f72 2027  parameters for '
│ │ │ │ -00017810: 7368 6973 6869 6427 2e0a 2a20 5061 7261  shishid'..* Para
│ │ │ │ -00017820: 6d65 7465 7273 2066 6f72 2073 6869 7361  meters for shisa
│ │ │ │ -00017830: 3a3a 2020 2020 2020 2020 436f 6d6d 616e  ::        Comman
│ │ │ │ -00017840: 6420 6c69 6e65 2070 6172 616d 6574 6572  d line parameter
│ │ │ │ -00017850: 7320 666f 7220 2773 6869 7361 272e 0a2a  s for 'shisa'..*
│ │ │ │ -00017860: 2045 6e76 6972 6f6e 6d65 6e74 2076 6172   Environment var
│ │ │ │ -00017870: 6961 626c 6573 3a3a 2020 2020 2020 204f  iables::       O
│ │ │ │ -00017880: 7665 7272 6964 696e 6720 636f 6d70 696c  verriding compil
│ │ │ │ -00017890: 652d 7469 6d65 2064 6566 6175 6c74 7320  e-time defaults 
│ │ │ │ -000178a0: 6174 2072 756e 2d74 696d 652e 0a2a 2044  at run-time..* D
│ │ │ │ -000178b0: 6174 6520 696e 7075 7420 666f 726d 6174  ate input format
│ │ │ │ -000178c0: 733a 3a20 2020 2020 2020 2020 2044 6574  s::          Det
│ │ │ │ -000178d0: 6169 6c73 206f 6620 7468 6520 756e 6465  ails of the unde
│ │ │ │ -000178e0: 7273 746f 6f64 2064 6174 6520 666f 726d  rstood date form
│ │ │ │ -000178f0: 6174 732e 0a0a 1f0a 4669 6c65 3a20 7368  ats.....File: sh
│ │ │ │ -00017900: 6973 6869 2e69 6e66 6f2c 2020 4e6f 6465  ishi.info,  Node
│ │ │ │ -00017910: 3a20 456e 7669 726f 6e6d 656e 7461 6c20  : Environmental 
│ │ │ │ -00017920: 4173 7375 6d70 7469 6f6e 732c 2020 4e65  Assumptions,  Ne
│ │ │ │ -00017930: 7874 3a20 476c 6f73 7361 7279 206f 6620  xt: Glossary of 
│ │ │ │ -00017940: 7465 726d 732c 2020 5570 3a20 5265 6665  terms,  Up: Refe
│ │ │ │ -00017950: 7265 6e63 6520 4d61 6e75 616c 0a0a 342e  rence Manual..4.
│ │ │ │ -00017960: 3120 456e 7669 726f 6e6d 656e 7461 6c20  1 Environmental 
│ │ │ │ -00017970: 4173 7375 6d70 7469 6f6e 730a 3d3d 3d3d  Assumptions.====
│ │ │ │ +00016fe0: 3d3d 3d3d 3d3d 3d3d 3d0a 0a54 6865 2050  =========..The P
│ │ │ │ +00016ff0: 726f 6772 616d 6d69 6e67 2041 5049 2066  rogramming API f
│ │ │ │ +00017000: 6f72 2053 6869 7361 2069 7320 6465 7363  or Shisa is desc
│ │ │ │ +00017010: 7269 6265 6420 6265 6c6f 7720 282a 6e6f  ribed below (*no
│ │ │ │ +00017020: 7465 204b 6572 6265 726f 730a 4461 7461  te Kerberos.Data
│ │ │ │ +00017030: 6261 7365 2046 756e 6374 696f 6e73 3a3a  base Functions::
│ │ │ │ +00017040: 293b 2074 6869 7320 7365 6374 696f 6e20  ); this section 
│ │ │ │ +00017050: 6973 2061 626f 7574 2065 7874 656e 6469  is about extendi
│ │ │ │ +00017060: 6e67 2053 6869 7361 2c20 616e 640a 636f  ng Shisa, and.co
│ │ │ │ +00017070: 6e73 6571 7565 6e74 6c79 2053 6869 7368  nsequently Shish
│ │ │ │ +00017080: 692c 2074 6f20 7573 6520 796f 7572 206f  i, to use your o
│ │ │ │ +00017090: 776e 2075 7365 7220 6461 7461 6261 7365  wn user database
│ │ │ │ +000170a0: 2073 7973 7465 6d2e 2020 596f 7520 6d61   system.  You ma
│ │ │ │ +000170b0: 7920 7761 6e74 0a74 6f20 7374 6f72 6520  y want.to store 
│ │ │ │ +000170c0: 796f 7572 204b 6572 6265 726f 7320 7573  your Kerberos us
│ │ │ │ +000170d0: 6572 2069 6e66 6f72 6d61 7469 6f6e 206f  er information o
│ │ │ │ +000170e0: 6e20 616e 204c 4441 5020 6461 7461 6261  n an LDAP databa
│ │ │ │ +000170f0: 7365 2073 6572 7665 722c 2066 6f72 0a65  se server, for.e
│ │ │ │ +00017100: 7861 6d70 6c65 2e0a 0a20 2020 4164 6469  xample...   Addi
│ │ │ │ +00017110: 6e67 2061 206e 6577 2062 6163 6b65 6e64  ng a new backend
│ │ │ │ +00017120: 2069 7320 7374 7261 6967 6874 2066 6f72   is straight for
│ │ │ │ +00017130: 7761 7264 2e20 2059 6f75 206e 6565 6420  ward.  You need 
│ │ │ │ +00017140: 746f 2069 6d70 6c65 6d65 6e74 2074 6865  to implement the
│ │ │ │ +00017150: 0a62 6163 6b65 6e64 2041 5049 2066 756e  .backend API fun
│ │ │ │ +00017160: 6374 696f 6e20 7365 742c 2061 6464 2074  ction set, add t
│ │ │ │ +00017170: 6865 206c 6973 7420 6f66 2041 5049 2066  he list of API f
│ │ │ │ +00017180: 756e 6374 696f 6e73 2074 6f20 e280 9864  unctions to ...d
│ │ │ │ +00017190: 622f 6462 2e63 e280 9920 616e 640a 706f  b/db.c... and.po
│ │ │ │ +000171a0: 7373 6962 6c79 2061 6c73 6f20 6164 6420  ssibly also add 
│ │ │ │ +000171b0: 616e 7920 6c69 6272 6172 7920 6465 7065  any library depe
│ │ │ │ +000171c0: 6e64 656e 6369 6573 2074 6f20 7468 6520  ndencies to the 
│ │ │ │ +000171d0: 4d61 6b65 6669 6c65 2e0a 0a20 2020 5468  Makefile...   Th
│ │ │ │ +000171e0: 6520 7369 6d70 6c65 7374 2077 6179 2074  e simplest way t
│ │ │ │ +000171f0: 6f20 7772 6974 6520 6120 6e65 7720 6261  o write a new ba
│ │ │ │ +00017200: 636b 656e 6420 6973 2074 6f20 7374 6172  ckend is to star
│ │ │ │ +00017210: 7420 6672 6f6d 2074 6865 2065 7869 7374  t from the exist
│ │ │ │ +00017220: 696e 670a e280 9866 696c 65e2 8099 2062  ing....file... b
│ │ │ │ +00017230: 6173 6564 2064 6174 6162 6173 652c 2069  ased database, i
│ │ │ │ +00017240: 6e20 e280 9864 622f 6669 6c65 2e63 e280  n ...db/file.c..
│ │ │ │ +00017250: 992c 2061 6e64 206d 6f64 6966 7920 7468  ., and modify th
│ │ │ │ +00017260: 6520 656e 7472 7920 706f 696e 7473 2061  e entry points a
│ │ │ │ +00017270: 730a 6e65 6564 6564 2e0a 0a20 2020 4e6f  s.needed...   No
│ │ │ │ +00017280: 7465 2074 6861 7420 7468 6520 6375 7272  te that the curr
│ │ │ │ +00017290: 656e 7420 6261 636b 656e 6420 4150 4920  ent backend API 
│ │ │ │ +000172a0: 7769 6c6c 206c 696b 656c 7920 6368 616e  will likely chan
│ │ │ │ +000172b0: 6765 2062 6566 6f72 6520 6974 2069 730a  ge before it is.
│ │ │ │ +000172c0: 6672 6f7a 656e 2e20 2057 6520 6d61 7920  frozen.  We may 
│ │ │ │ +000172d0: 6465 7363 7269 6265 2069 7420 696e 2064  describe it in d
│ │ │ │ +000172e0: 6574 6169 6c20 6865 7265 2077 6865 6e20  etail here when 
│ │ │ │ +000172f0: 6974 2068 6173 206d 6174 7572 6564 2e0a  it has matured..
│ │ │ │ +00017300: 486f 7765 7665 722c 2063 7572 7265 6e74  However, current
│ │ │ │ +00017310: 6c79 2069 7420 6973 2073 696d 696c 6172  ly it is similar
│ │ │ │ +00017320: 2074 6f20 7468 6520 6578 7465 726e 616c   to the external
│ │ │ │ +00017330: 2053 6869 7361 2041 5049 2028 2a6e 6f74   Shisa API (*not
│ │ │ │ +00017340: 650a 4b65 7262 6572 6f73 2044 6174 6162  e.Kerberos Datab
│ │ │ │ +00017350: 6173 6520 4675 6e63 7469 6f6e 733a 3a29  ase Functions::)
│ │ │ │ +00017360: 2e0a 0a20 2020 5468 6572 6520 7368 6f75  ...   There shou
│ │ │ │ +00017370: 6c64 2062 6520 6e6f 206e 6565 6420 746f  ld be no need to
│ │ │ │ +00017380: 206d 6f64 6966 7920 616e 7974 6869 6e67   modify anything
│ │ │ │ +00017390: 2065 6c73 6520 696e 2074 6865 2053 6869   else in the Shi
│ │ │ │ +000173a0: 7361 206c 6962 7261 7279 2c0a 616e 6420  sa library,.and 
│ │ │ │ +000173b0: 6365 7274 6169 6e6c 7920 6e6f 7420 696e  certainly not in
│ │ │ │ +000173c0: 2074 6865 2053 6869 7368 6920 6c69 6272   the Shishi libr
│ │ │ │ +000173d0: 6172 7920 6f72 2074 6865 20e2 8098 7368  ary or the ...sh
│ │ │ │ +000173e0: 6973 6869 64e2 8099 2073 6572 7665 722e  ishid... server.
│ │ │ │ +000173f0: 0a0a 2020 204e 6174 7572 616c 6c79 2c20  ..   Naturally, 
│ │ │ │ +00017400: 7765 2077 6f75 6c64 2061 7070 7265 6369  we would appreci
│ │ │ │ +00017410: 6174 6520 6966 2079 6f75 2077 6f75 6c64  ate if you would
│ │ │ │ +00017420: 2073 656e 6420 7573 2079 6f75 7220 6e65   send us your ne
│ │ │ │ +00017430: 7720 6261 636b 656e 642c 0a69 6620 796f  w backend,.if yo
│ │ │ │ +00017440: 7520 6265 6c69 6576 6520 6974 2069 7320  u believe it is 
│ │ │ │ +00017450: 6765 6e65 7261 6c6c 7920 7573 6566 756c  generally useful
│ │ │ │ +00017460: 2028 2a6e 6f74 6520 4275 6720 5265 706f   (*note Bug Repo
│ │ │ │ +00017470: 7274 733a 3a29 2e0a 0a1f 0a46 696c 653a  rts::).....File:
│ │ │ │ +00017480: 2073 6869 7368 692e 696e 666f 2c20 204e   shishi.info,  N
│ │ │ │ +00017490: 6f64 653a 2052 6566 6572 656e 6365 204d  ode: Reference M
│ │ │ │ +000174a0: 616e 7561 6c2c 2020 4e65 7874 3a20 5072  anual,  Next: Pr
│ │ │ │ +000174b0: 6f67 7261 6d6d 696e 6720 4d61 6e75 616c  ogramming Manual
│ │ │ │ +000174c0: 2c20 2050 7265 763a 2041 646d 696e 6973  ,  Prev: Adminis
│ │ │ │ +000174d0: 7472 6174 696f 6e20 4d61 6e75 616c 2c20  tration Manual, 
│ │ │ │ +000174e0: 2055 703a 2054 6f70 0a0a 3420 5265 6665   Up: Top..4 Refe
│ │ │ │ +000174f0: 7265 6e63 6520 4d61 6e75 616c 0a2a 2a2a  rence Manual.***
│ │ │ │ +00017500: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a  ***************.
│ │ │ │ +00017510: 0a54 6869 7320 6368 6170 7465 7220 6469  .This chapter di
│ │ │ │ +00017520: 7363 7573 7320 7468 6520 756e 6465 726c  scuss the underl
│ │ │ │ +00017530: 7969 6e67 2061 7373 756d 7074 696f 6e73  ying assumptions
│ │ │ │ +00017540: 206f 6620 4b65 7262 6572 6f73 2c20 636f   of Kerberos, co
│ │ │ │ +00017550: 6e74 6169 6e20 610a 676c 6f73 7361 7279  ntain a.glossary
│ │ │ │ +00017560: 2074 6f20 4b65 7262 6572 6f73 2063 6f6e   to Kerberos con
│ │ │ │ +00017570: 6365 7074 732c 2067 6976 6520 796f 7520  cepts, give you 
│ │ │ │ +00017580: 6261 636b 6772 6f75 6e64 2069 6e66 6f72  background infor
│ │ │ │ +00017590: 6d61 7469 6f6e 206f 6e0a 6368 6f6f 7369  mation on.choosi
│ │ │ │ +000175a0: 6e67 2072 6561 6c6d 2061 6e64 2070 7269  ng realm and pri
│ │ │ │ +000175b0: 6e63 6970 616c 206e 616d 6573 2c20 616e  ncipal names, an
│ │ │ │ +000175c0: 6420 6465 7363 7269 6265 2061 6c6c 2070  d describe all p
│ │ │ │ +000175d0: 6172 616d 6574 6572 7320 616e 640a 636f  arameters and.co
│ │ │ │ +000175e0: 6e66 6967 7572 6174 696f 6e20 6669 6c65  nfiguration file
│ │ │ │ +000175f0: 2073 796e 7461 7865 7320 666f 7220 7468   syntaxes for th
│ │ │ │ +00017600: 6520 5368 6973 6869 2074 6f6f 6c73 2e0a  e Shishi tools..
│ │ │ │ +00017610: 0a2a 204d 656e 753a 0a0a 2a20 456e 7669  .* Menu:..* Envi
│ │ │ │ +00017620: 726f 6e6d 656e 7461 6c20 4173 7375 6d70  ronmental Assump
│ │ │ │ +00017630: 7469 6f6e 733a 3a20 2020 4b65 7262 6572  tions::   Kerber
│ │ │ │ +00017640: 6f73 2035 2061 7373 756d 7074 696f 6e73  os 5 assumptions
│ │ │ │ +00017650: 2061 626f 7574 2079 6f75 7220 7379 7374   about your syst
│ │ │ │ +00017660: 656d 2e0a 2a20 476c 6f73 7361 7279 206f  em..* Glossary o
│ │ │ │ +00017670: 6620 7465 726d 733a 3a20 2020 2020 2020  f terms::       
│ │ │ │ +00017680: 2020 2020 476c 6f73 7361 7279 206f 6620      Glossary of 
│ │ │ │ +00017690: 4b65 7262 6572 6f73 2072 656c 6174 6564  Kerberos related
│ │ │ │ +000176a0: 2074 6572 6d69 6e6f 6c6f 6779 2e0a 2a20   terminology..* 
│ │ │ │ +000176b0: 5265 616c 6d20 616e 6420 5072 696e 6369  Realm and Princi
│ │ │ │ +000176c0: 7061 6c20 4e61 6d69 6e67 3a3a 2020 486f  pal Naming::  Ho
│ │ │ │ +000176d0: 7720 746f 206e 616d 6520 796f 7572 2072  w to name your r
│ │ │ │ +000176e0: 6561 6c6d 2061 6e64 2070 7269 6e63 6970  ealm and princip
│ │ │ │ +000176f0: 616c 732e 0a2a 2053 6869 7368 6920 436f  als..* Shishi Co
│ │ │ │ +00017700: 6e66 6967 7572 6174 696f 6e3a 3a20 2020  nfiguration::   
│ │ │ │ +00017710: 2020 2020 2045 7870 6c61 696e 7320 7468       Explains th
│ │ │ │ +00017720: 6520 436f 7265 2053 6869 7368 6920 636f  e Core Shishi co
│ │ │ │ +00017730: 6e66 6967 7572 6174 696f 6e20 6669 6c65  nfiguration file
│ │ │ │ +00017740: 2e0a 2a20 5368 6973 6120 436f 6e66 6967  ..* Shisa Config
│ │ │ │ +00017750: 7572 6174 696f 6e3a 3a20 2020 2020 2020  uration::       
│ │ │ │ +00017760: 2020 4578 706c 6169 6e73 2074 6865 2053    Explains the S
│ │ │ │ +00017770: 6869 7361 2064 6174 6162 6173 6520 6465  hisa database de
│ │ │ │ +00017780: 6669 6e69 7469 6f6e 2066 696c 652e 0a2a  finition file..*
│ │ │ │ +00017790: 2050 6172 616d 6574 6572 7320 666f 7220   Parameters for 
│ │ │ │ +000177a0: 7368 6973 6869 3a3a 2020 2020 2020 2043  shishi::       C
│ │ │ │ +000177b0: 6f6d 6d61 6e64 206c 696e 6520 7061 7261  ommand line para
│ │ │ │ +000177c0: 6d65 7465 7273 2066 6f72 2027 7368 6973  meters for 'shis
│ │ │ │ +000177d0: 6869 272e 0a2a 2050 6172 616d 6574 6572  hi'..* Parameter
│ │ │ │ +000177e0: 7320 666f 7220 7368 6973 6869 643a 3a20  s for shishid:: 
│ │ │ │ +000177f0: 2020 2020 2043 6f6d 6d61 6e64 206c 696e       Command lin
│ │ │ │ +00017800: 6520 7061 7261 6d65 7465 7273 2066 6f72  e parameters for
│ │ │ │ +00017810: 2027 7368 6973 6869 6427 2e0a 2a20 5061   'shishid'..* Pa
│ │ │ │ +00017820: 7261 6d65 7465 7273 2066 6f72 2073 6869  rameters for shi
│ │ │ │ +00017830: 7361 3a3a 2020 2020 2020 2020 436f 6d6d  sa::        Comm
│ │ │ │ +00017840: 616e 6420 6c69 6e65 2070 6172 616d 6574  and line paramet
│ │ │ │ +00017850: 6572 7320 666f 7220 2773 6869 7361 272e  ers for 'shisa'.
│ │ │ │ +00017860: 0a2a 2045 6e76 6972 6f6e 6d65 6e74 2076  .* Environment v
│ │ │ │ +00017870: 6172 6961 626c 6573 3a3a 2020 2020 2020  ariables::      
│ │ │ │ +00017880: 204f 7665 7272 6964 696e 6720 636f 6d70   Overriding comp
│ │ │ │ +00017890: 696c 652d 7469 6d65 2064 6566 6175 6c74  ile-time default
│ │ │ │ +000178a0: 7320 6174 2072 756e 2d74 696d 652e 0a2a  s at run-time..*
│ │ │ │ +000178b0: 2044 6174 6520 696e 7075 7420 666f 726d   Date input form
│ │ │ │ +000178c0: 6174 733a 3a20 2020 2020 2020 2020 2044  ats::          D
│ │ │ │ +000178d0: 6574 6169 6c73 206f 6620 7468 6520 756e  etails of the un
│ │ │ │ +000178e0: 6465 7273 746f 6f64 2064 6174 6520 666f  derstood date fo
│ │ │ │ +000178f0: 726d 6174 732e 0a0a 1f0a 4669 6c65 3a20  rmats.....File: 
│ │ │ │ +00017900: 7368 6973 6869 2e69 6e66 6f2c 2020 4e6f  shishi.info,  No
│ │ │ │ +00017910: 6465 3a20 456e 7669 726f 6e6d 656e 7461  de: Environmenta
│ │ │ │ +00017920: 6c20 4173 7375 6d70 7469 6f6e 732c 2020  l Assumptions,  
│ │ │ │ +00017930: 4e65 7874 3a20 476c 6f73 7361 7279 206f  Next: Glossary o
│ │ │ │ +00017940: 6620 7465 726d 732c 2020 5570 3a20 5265  f terms,  Up: Re
│ │ │ │ +00017950: 6665 7265 6e63 6520 4d61 6e75 616c 0a0a  ference Manual..
│ │ │ │ +00017960: 342e 3120 456e 7669 726f 6e6d 656e 7461  4.1 Environmenta
│ │ │ │ +00017970: 6c20 4173 7375 6d70 7469 6f6e 730a 3d3d  l Assumptions.==
│ │ │ │  00017980: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ -00017990: 3d3d 3d3d 3d3d 3d3d 3d0a 0a4b 6572 6265  =========..Kerbe
│ │ │ │ -000179a0: 726f 7320 696d 706f 7365 7320 6120 6665  ros imposes a fe
│ │ │ │ -000179b0: 7720 6173 7375 6d70 7469 6f6e 7320 6f6e  w assumptions on
│ │ │ │ -000179c0: 2074 6865 2065 6e76 6972 6f6e 6d65 6e74   the environment
│ │ │ │ -000179d0: 2069 6e20 7768 6963 6820 6974 2063 616e   in which it can
│ │ │ │ -000179e0: 0a70 726f 7065 726c 7920 6675 6e63 7469  .properly functi
│ │ │ │ -000179f0: 6f6e 3a0a 0a20 2020 e280 a220 2244 656e  on:..   ... "Den
│ │ │ │ -00017a00: 6961 6c20 6f66 2073 6572 7669 6365 2220  ial of service" 
│ │ │ │ -00017a10: 6174 7461 636b 7320 6172 6520 6e6f 7420  attacks are not 
│ │ │ │ -00017a20: 736f 6c76 6564 2077 6974 6820 4b65 7262  solved with Kerb
│ │ │ │ -00017a30: 6572 6f73 2e20 2054 6865 7265 0a20 2020  eros.  There.   
│ │ │ │ -00017a40: 2020 6172 6520 706c 6163 6573 2069 6e20    are places in 
│ │ │ │ -00017a50: 7468 6520 7072 6f74 6f63 6f6c 7320 7768  the protocols wh
│ │ │ │ -00017a60: 6572 6520 616e 2069 6e74 7275 6465 7220  ere an intruder 
│ │ │ │ -00017a70: 6361 6e20 7072 6576 656e 7420 616e 0a20  can prevent an. 
│ │ │ │ -00017a80: 2020 2020 6170 706c 6963 6174 696f 6e20      application 
│ │ │ │ -00017a90: 6672 6f6d 2070 6172 7469 6369 7061 7469  from participati
│ │ │ │ -00017aa0: 6e67 2069 6e20 7468 6520 7072 6f70 6572  ng in the proper
│ │ │ │ -00017ab0: 2061 7574 6865 6e74 6963 6174 696f 6e20   authentication 
│ │ │ │ -00017ac0: 7374 6570 732e 0a20 2020 2020 4465 7465  steps..     Dete
│ │ │ │ -00017ad0: 6374 696f 6e20 616e 6420 736f 6c75 7469  ction and soluti
│ │ │ │ -00017ae0: 6f6e 206f 6620 7375 6368 2061 7474 6163  on of such attac
│ │ │ │ -00017af0: 6b73 2028 736f 6d65 206f 6620 7768 6963  ks (some of whic
│ │ │ │ -00017b00: 6820 6361 6e20 6170 7065 6172 2074 6f0a  h can appear to.
│ │ │ │ -00017b10: 2020 2020 2062 6520 6e6f 742d 756e 636f       be not-unco
│ │ │ │ -00017b20: 6d6d 6f6e 2022 6e6f 726d 616c 2220 6661  mmon "normal" fa
│ │ │ │ -00017b30: 696c 7572 6520 6d6f 6465 7320 666f 7220  ilure modes for 
│ │ │ │ -00017b40: 7468 6520 7379 7374 656d 2920 6973 2075  the system) is u
│ │ │ │ -00017b50: 7375 616c 6c79 0a20 2020 2020 6265 7374  sually.     best
│ │ │ │ -00017b60: 206c 6566 7420 746f 2074 6865 2068 756d   left to the hum
│ │ │ │ -00017b70: 616e 2061 646d 696e 6973 7472 6174 6f72  an administrator
│ │ │ │ -00017b80: 7320 616e 6420 7573 6572 732e 0a20 2020  s and users..   
│ │ │ │ -00017b90: e280 a220 5072 696e 6369 7061 6c73 204d  ... Principals M
│ │ │ │ -00017ba0: 5553 5420 6b65 6570 2074 6865 6972 2073  UST keep their s
│ │ │ │ -00017bb0: 6563 7265 7420 6b65 7973 2073 6563 7265  ecret keys secre
│ │ │ │ -00017bc0: 742e 2020 4966 2061 6e20 696e 7472 7564  t.  If an intrud
│ │ │ │ -00017bd0: 6572 0a20 2020 2020 736f 6d65 686f 7720  er.     somehow 
│ │ │ │ -00017be0: 7374 6561 6c73 2061 2070 7269 6e63 6970  steals a princip
│ │ │ │ -00017bf0: 616c 2773 206b 6579 2c20 6974 2077 696c  al's key, it wil
│ │ │ │ -00017c00: 6c20 6265 2061 626c 6520 746f 206d 6173  l be able to mas
│ │ │ │ -00017c10: 7175 6572 6164 6520 6173 0a20 2020 2020  querade as.     
│ │ │ │ -00017c20: 7468 6174 2070 7269 6e63 6970 616c 206f  that principal o
│ │ │ │ -00017c30: 7220 696d 7065 7273 6f6e 6174 6520 616e  r impersonate an
│ │ │ │ -00017c40: 7920 7365 7276 6572 2074 6f20 7468 6520  y server to the 
│ │ │ │ -00017c50: 6c65 6769 7469 6d61 7465 0a20 2020 2020  legitimate.     
│ │ │ │ -00017c60: 7072 696e 6369 7061 6c2e 0a20 2020 e280  principal..   ..
│ │ │ │ -00017c70: a220 2250 6173 7377 6f72 6420 6775 6573  . "Password gues
│ │ │ │ -00017c80: 7369 6e67 2220 6174 7461 636b 7320 6172  sing" attacks ar
│ │ │ │ -00017c90: 6520 6e6f 7420 736f 6c76 6564 2062 7920  e not solved by 
│ │ │ │ -00017ca0: 4b65 7262 6572 6f73 2e20 2049 6620 6120  Kerberos.  If a 
│ │ │ │ -00017cb0: 7573 6572 0a20 2020 2020 6368 6f6f 7365  user.     choose
│ │ │ │ -00017cc0: 7320 6120 706f 6f72 2070 6173 7377 6f72  s a poor passwor
│ │ │ │ -00017cd0: 642c 2069 7420 6973 2070 6f73 7369 626c  d, it is possibl
│ │ │ │ -00017ce0: 6520 666f 7220 616e 2061 7474 6163 6b65  e for an attacke
│ │ │ │ -00017cf0: 7220 746f 0a20 2020 2020 7375 6363 6573  r to.     succes
│ │ │ │ -00017d00: 7366 756c 6c79 206d 6f75 6e74 2061 6e20  sfully mount an 
│ │ │ │ -00017d10: 6f66 666c 696e 6520 6469 6374 696f 6e61  offline dictiona
│ │ │ │ -00017d20: 7279 2061 7474 6163 6b20 6279 2072 6570  ry attack by rep
│ │ │ │ -00017d30: 6561 7465 646c 790a 2020 2020 2061 7474  eatedly.     att
│ │ │ │ -00017d40: 656d 7074 696e 6720 746f 2064 6563 7279  empting to decry
│ │ │ │ -00017d50: 7074 2c20 7769 7468 2073 7563 6365 7373  pt, with success
│ │ │ │ -00017d60: 6976 6520 656e 7472 6965 7320 6672 6f6d  ive entries from
│ │ │ │ -00017d70: 2061 2064 6963 7469 6f6e 6172 792c 0a20   a dictionary,. 
│ │ │ │ -00017d80: 2020 2020 6d65 7373 6167 6573 206f 6274      messages obt
│ │ │ │ -00017d90: 6169 6e65 6420 7768 6963 6820 6172 6520  ained which are 
│ │ │ │ -00017da0: 656e 6372 7970 7465 6420 756e 6465 7220  encrypted under 
│ │ │ │ -00017db0: 6120 6b65 7920 6465 7269 7665 6420 6672  a key derived fr
│ │ │ │ -00017dc0: 6f6d 2074 6865 0a20 2020 2020 7573 6572  om the.     user
│ │ │ │ -00017dd0: 2773 2070 6173 7377 6f72 642e 0a20 2020  's password..   
│ │ │ │ -00017de0: e280 a220 4561 6368 2068 6f73 7420 6f6e  ... Each host on
│ │ │ │ -00017df0: 2074 6865 206e 6574 776f 726b 204d 5553   the network MUS
│ │ │ │ -00017e00: 5420 6861 7665 2061 2063 6c6f 636b 2077  T have a clock w
│ │ │ │ -00017e10: 6869 6368 2069 7320 226c 6f6f 7365 6c79  hich is "loosely
│ │ │ │ -00017e20: 0a20 2020 2020 7379 6e63 6872 6f6e 697a  .     synchroniz
│ │ │ │ -00017e30: 6564 2220 746f 2074 6865 2074 696d 6520  ed" to the time 
│ │ │ │ -00017e40: 6f66 2074 6865 206f 7468 6572 2068 6f73  of the other hos
│ │ │ │ -00017e50: 7473 3b20 7468 6973 2073 796e 6368 726f  ts; this synchro
│ │ │ │ -00017e60: 6e69 7a61 7469 6f6e 0a20 2020 2020 6973  nization.     is
│ │ │ │ -00017e70: 2075 7365 6420 746f 2072 6564 7563 6520   used to reduce 
│ │ │ │ -00017e80: 7468 6520 626f 6f6b 6b65 6570 696e 6720  the bookkeeping 
│ │ │ │ -00017e90: 6e65 6564 7320 6f66 2061 7070 6c69 6361  needs of applica
│ │ │ │ -00017ea0: 7469 6f6e 2073 6572 7665 7273 2077 6865  tion servers whe
│ │ │ │ -00017eb0: 6e0a 2020 2020 2074 6865 7920 646f 2072  n.     they do r
│ │ │ │ -00017ec0: 6570 6c61 7920 6465 7465 6374 696f 6e2e  eplay detection.
│ │ │ │ -00017ed0: 2020 5468 6520 6465 6772 6565 206f 6620    The degree of 
│ │ │ │ -00017ee0: 226c 6f6f 7365 6e65 7373 2220 6361 6e20  "looseness" can 
│ │ │ │ -00017ef0: 6265 0a20 2020 2020 636f 6e66 6967 7572  be.     configur
│ │ │ │ -00017f00: 6564 206f 6e20 6120 7065 722d 7365 7276  ed on a per-serv
│ │ │ │ -00017f10: 6572 2062 6173 6973 2c20 6275 7420 6973  er basis, but is
│ │ │ │ -00017f20: 2074 7970 6963 616c 6c79 206f 6e20 7468   typically on th
│ │ │ │ -00017f30: 6520 6f72 6465 7220 6f66 0a20 2020 2020  e order of.     
│ │ │ │ -00017f40: 3520 6d69 6e75 7465 732e 2020 4966 2074  5 minutes.  If t
│ │ │ │ -00017f50: 6865 2063 6c6f 636b 7320 6172 6520 7379  he clocks are sy
│ │ │ │ -00017f60: 6e63 6872 6f6e 697a 6564 206f 7665 7220  nchronized over 
│ │ │ │ -00017f70: 7468 6520 6e65 7477 6f72 6b2c 2074 6865  the network, the
│ │ │ │ -00017f80: 0a20 2020 2020 636c 6f63 6b20 7379 6e63  .     clock sync
│ │ │ │ -00017f90: 6872 6f6e 697a 6174 696f 6e20 7072 6f74  hronization prot
│ │ │ │ -00017fa0: 6f63 6f6c 204d 5553 5420 6974 7365 6c66  ocol MUST itself
│ │ │ │ -00017fb0: 2062 6520 7365 6375 7265 6420 6672 6f6d   be secured from
│ │ │ │ -00017fc0: 206e 6574 776f 726b 0a20 2020 2020 6174   network.     at
│ │ │ │ -00017fd0: 7461 636b 6572 732e 0a20 2020 e280 a220  tackers..   ... 
│ │ │ │ -00017fe0: 5072 696e 6369 7061 6c20 6964 656e 7469  Principal identi
│ │ │ │ -00017ff0: 6669 6572 7320 6172 6520 6e6f 7420 7265  fiers are not re
│ │ │ │ -00018000: 6379 636c 6564 206f 6e20 6120 7368 6f72  cycled on a shor
│ │ │ │ -00018010: 742d 7465 726d 2062 6173 6973 2e20 2041  t-term basis.  A
│ │ │ │ -00018020: 0a20 2020 2020 7479 7069 6361 6c20 6d6f  .     typical mo
│ │ │ │ -00018030: 6465 206f 6620 6163 6365 7373 2063 6f6e  de of access con
│ │ │ │ -00018040: 7472 6f6c 2077 696c 6c20 7573 6520 6163  trol will use ac
│ │ │ │ -00018050: 6365 7373 2063 6f6e 7472 6f6c 206c 6973  cess control lis
│ │ │ │ -00018060: 7473 2028 4143 4c73 290a 2020 2020 2074  ts (ACLs).     t
│ │ │ │ -00018070: 6f20 6772 616e 7420 7065 726d 6973 7369  o grant permissi
│ │ │ │ -00018080: 6f6e 7320 746f 2070 6172 7469 6375 6c61  ons to particula
│ │ │ │ -00018090: 7220 7072 696e 6369 7061 6c73 2e20 2049  r principals.  I
│ │ │ │ -000180a0: 6620 6120 7374 616c 6520 4143 4c0a 2020  f a stale ACL.  
│ │ │ │ -000180b0: 2020 2065 6e74 7279 2072 656d 6169 6e73     entry remains
│ │ │ │ -000180c0: 2066 6f72 2061 2064 656c 6574 6564 2070   for a deleted p
│ │ │ │ -000180d0: 7269 6e63 6970 616c 2061 6e64 2074 6865  rincipal and the
│ │ │ │ -000180e0: 2070 7269 6e63 6970 616c 2069 6465 6e74   principal ident
│ │ │ │ -000180f0: 6966 6965 720a 2020 2020 2069 7320 7265  ifier.     is re
│ │ │ │ -00018100: 7573 6564 2c20 7468 6520 6e65 7720 7072  used, the new pr
│ │ │ │ -00018110: 696e 6369 7061 6c20 7769 6c6c 2069 6e68  incipal will inh
│ │ │ │ -00018120: 6572 6974 2072 6967 6874 7320 7370 6563  erit rights spec
│ │ │ │ -00018130: 6966 6965 6420 696e 2074 6865 0a20 2020  ified in the.   
│ │ │ │ -00018140: 2020 7374 616c 6520 4143 4c20 656e 7472    stale ACL entr
│ │ │ │ -00018150: 792e 2020 4279 206e 6f74 2072 652d 7573  y.  By not re-us
│ │ │ │ -00018160: 696e 6720 7072 696e 6369 7061 6c20 6964  ing principal id
│ │ │ │ -00018170: 656e 7469 6669 6572 732c 2074 6865 2064  entifiers, the d
│ │ │ │ -00018180: 616e 6765 720a 2020 2020 206f 6620 696e  anger.     of in
│ │ │ │ -00018190: 6164 7665 7274 656e 7420 6163 6365 7373  advertent access
│ │ │ │ -000181a0: 2069 7320 7265 6d6f 7665 642e 0a0a 1f0a   is removed.....
│ │ │ │ -000181b0: 4669 6c65 3a20 7368 6973 6869 2e69 6e66  File: shishi.inf
│ │ │ │ -000181c0: 6f2c 2020 4e6f 6465 3a20 476c 6f73 7361  o,  Node: Glossa
│ │ │ │ -000181d0: 7279 206f 6620 7465 726d 732c 2020 4e65  ry of terms,  Ne
│ │ │ │ -000181e0: 7874 3a20 5265 616c 6d20 616e 6420 5072  xt: Realm and Pr
│ │ │ │ -000181f0: 696e 6369 7061 6c20 4e61 6d69 6e67 2c20  incipal Naming, 
│ │ │ │ -00018200: 2050 7265 763a 2045 6e76 6972 6f6e 6d65   Prev: Environme
│ │ │ │ -00018210: 6e74 616c 2041 7373 756d 7074 696f 6e73  ntal Assumptions
│ │ │ │ -00018220: 2c20 2055 703a 2052 6566 6572 656e 6365  ,  Up: Reference
│ │ │ │ -00018230: 204d 616e 7561 6c0a 0a34 2e32 2047 6c6f   Manual..4.2 Glo
│ │ │ │ -00018240: 7373 6172 7920 6f66 2074 6572 6d73 0a3d  ssary of terms.=
│ │ │ │ -00018250: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ -00018260: 3d3d 3d3d 0a0a 4175 7468 656e 7469 6361  ====..Authentica
│ │ │ │ -00018270: 7469 6f6e 0a20 2020 2020 5665 7269 6679  tion.     Verify
│ │ │ │ -00018280: 696e 6720 7468 6520 636c 6169 6d65 6420  ing the claimed 
│ │ │ │ -00018290: 6964 656e 7469 7479 206f 6620 6120 7072  identity of a pr
│ │ │ │ -000182a0: 696e 6369 7061 6c2e 0a0a 4175 7468 656e  incipal...Authen
│ │ │ │ -000182b0: 7469 6361 7469 6f6e 2068 6561 6465 720a  tication header.
│ │ │ │ -000182c0: 2020 2020 2041 2072 6563 6f72 6420 636f       A record co
│ │ │ │ -000182d0: 6e74 6169 6e69 6e67 2061 2054 6963 6b65  ntaining a Ticke
│ │ │ │ -000182e0: 7420 616e 6420 616e 2041 7574 6865 6e74  t and an Authent
│ │ │ │ -000182f0: 6963 6174 6f72 2074 6f20 6265 2070 7265  icator to be pre
│ │ │ │ -00018300: 7365 6e74 6564 0a20 2020 2020 746f 2061  sented.     to a
│ │ │ │ -00018310: 2073 6572 7665 7220 6173 2070 6172 7420   server as part 
│ │ │ │ -00018320: 6f66 2074 6865 2061 7574 6865 6e74 6963  of the authentic
│ │ │ │ -00018330: 6174 696f 6e20 7072 6f63 6573 732e 0a0a  ation process...
│ │ │ │ -00018340: 4175 7468 656e 7469 6361 7469 6f6e 2070  Authentication p
│ │ │ │ -00018350: 6174 680a 2020 2020 2041 2073 6571 7565  ath.     A seque
│ │ │ │ -00018360: 6e63 6520 6f66 2069 6e74 6572 6d65 6469  nce of intermedi
│ │ │ │ -00018370: 6174 6520 7265 616c 6d73 2074 7261 6e73  ate realms trans
│ │ │ │ -00018380: 6974 6564 2069 6e20 7468 6520 6175 7468  ited in the auth
│ │ │ │ -00018390: 656e 7469 6361 7469 6f6e 0a20 2020 2020  entication.     
│ │ │ │ -000183a0: 7072 6f63 6573 7320 7768 656e 2063 6f6d  process when com
│ │ │ │ -000183b0: 6d75 6e69 6361 7469 6e67 2066 726f 6d20  municating from 
│ │ │ │ -000183c0: 6f6e 6520 7265 616c 6d20 746f 2061 6e6f  one realm to ano
│ │ │ │ -000183d0: 7468 6572 2e0a 0a41 7574 6865 6e74 6963  ther...Authentic
│ │ │ │ -000183e0: 6174 6f72 0a20 2020 2020 4120 7265 636f  ator.     A reco
│ │ │ │ -000183f0: 7264 2063 6f6e 7461 696e 696e 6720 696e  rd containing in
│ │ │ │ -00018400: 666f 726d 6174 696f 6e20 7468 6174 2063  formation that c
│ │ │ │ -00018410: 616e 2062 6520 7368 6f77 6e20 746f 2068  an be shown to h
│ │ │ │ -00018420: 6176 6520 6265 656e 0a20 2020 2020 7265  ave been.     re
│ │ │ │ -00018430: 6365 6e74 6c79 2067 656e 6572 6174 6564  cently generated
│ │ │ │ -00018440: 2075 7369 6e67 2074 6865 2073 6573 7369   using the sessi
│ │ │ │ -00018450: 6f6e 206b 6579 206b 6e6f 776e 206f 6e6c  on key known onl
│ │ │ │ -00018460: 7920 6279 2074 6865 2063 6c69 656e 740a  y by the client.
│ │ │ │ -00018470: 2020 2020 2061 6e64 2073 6572 7665 722e       and server.
│ │ │ │ -00018480: 0a0a 4175 7468 6f72 697a 6174 696f 6e0a  ..Authorization.
│ │ │ │ -00018490: 2020 2020 2054 6865 2070 726f 6365 7373       The process
│ │ │ │ -000184a0: 206f 6620 6465 7465 726d 696e 696e 6720   of determining 
│ │ │ │ -000184b0: 7768 6574 6865 7220 6120 636c 6965 6e74  whether a client
│ │ │ │ -000184c0: 206d 6179 2075 7365 2061 2073 6572 7669   may use a servi
│ │ │ │ -000184d0: 6365 2c0a 2020 2020 2077 6869 6368 206f  ce,.     which o
│ │ │ │ -000184e0: 626a 6563 7473 2074 6865 2063 6c69 656e  bjects the clien
│ │ │ │ -000184f0: 7420 6973 2061 6c6c 6f77 6564 2074 6f20  t is allowed to 
│ │ │ │ -00018500: 6163 6365 7373 2c20 616e 6420 7468 6520  access, and the 
│ │ │ │ -00018510: 7479 7065 206f 660a 2020 2020 2061 6363  type of.     acc
│ │ │ │ -00018520: 6573 7320 616c 6c6f 7765 6420 666f 7220  ess allowed for 
│ │ │ │ -00018530: 6561 6368 2e0a 0a43 6170 6162 696c 6974  each...Capabilit
│ │ │ │ -00018540: 790a 2020 2020 2041 2074 6f6b 656e 2074  y.     A token t
│ │ │ │ -00018550: 6861 7420 6772 616e 7473 2074 6865 2062  hat grants the b
│ │ │ │ -00018560: 6561 7265 7220 7065 726d 6973 7369 6f6e  earer permission
│ │ │ │ -00018570: 2074 6f20 6163 6365 7373 2061 6e20 6f62   to access an ob
│ │ │ │ -00018580: 6a65 6374 206f 720a 2020 2020 2073 6572  ject or.     ser
│ │ │ │ -00018590: 7669 6365 2e20 2049 6e20 4b65 7262 6572  vice.  In Kerber
│ │ │ │ -000185a0: 6f73 2c20 7468 6973 206d 6967 6874 2062  os, this might b
│ │ │ │ -000185b0: 6520 6120 7469 636b 6574 2077 686f 7365  e a ticket whose
│ │ │ │ -000185c0: 2075 7365 2069 730a 2020 2020 2072 6573   use is.     res
│ │ │ │ -000185d0: 7472 6963 7465 6420 6279 2074 6865 2063  tricted by the c
│ │ │ │ -000185e0: 6f6e 7465 6e74 7320 6f66 2074 6865 2061  ontents of the a
│ │ │ │ -000185f0: 7574 686f 7269 7a61 7469 6f6e 2064 6174  uthorization dat
│ │ │ │ -00018600: 6120 6669 656c 642c 2062 7574 0a20 2020  a field, but.   
│ │ │ │ -00018610: 2020 7768 6963 6820 6c69 7374 7320 6e6f    which lists no
│ │ │ │ -00018620: 206e 6574 776f 726b 2061 6464 7265 7373   network address
│ │ │ │ -00018630: 6573 2c20 746f 6765 7468 6572 2077 6974  es, together wit
│ │ │ │ -00018640: 6820 7468 6520 7365 7373 696f 6e20 6b65  h the session ke
│ │ │ │ -00018650: 790a 2020 2020 206e 6563 6573 7361 7279  y.     necessary
│ │ │ │ -00018660: 2074 6f20 7573 6520 7468 6520 7469 636b   to use the tick
│ │ │ │ -00018670: 6574 2e0a 0a43 6970 6865 7274 6578 740a  et...Ciphertext.
│ │ │ │ -00018680: 2020 2020 2054 6865 206f 7574 7075 7420       The output 
│ │ │ │ -00018690: 6f66 2061 6e20 656e 6372 7970 7469 6f6e  of an encryption
│ │ │ │ -000186a0: 2066 756e 6374 696f 6e2e 2020 456e 6372   function.  Encr
│ │ │ │ -000186b0: 7970 7469 6f6e 2074 7261 6e73 666f 726d  yption transform
│ │ │ │ -000186c0: 730a 2020 2020 2070 6c61 696e 7465 7874  s.     plaintext
│ │ │ │ -000186d0: 2069 6e74 6f20 6369 7068 6572 7465 7874   into ciphertext
│ │ │ │ -000186e0: 2e0a 0a43 6c69 656e 740a 2020 2020 2041  ...Client.     A
│ │ │ │ -000186f0: 2070 726f 6365 7373 2074 6861 7420 6d61   process that ma
│ │ │ │ -00018700: 6b65 7320 7573 6520 6f66 2061 206e 6574  kes use of a net
│ │ │ │ -00018710: 776f 726b 2073 6572 7669 6365 206f 6e20  work service on 
│ │ │ │ -00018720: 6265 6861 6c66 206f 6620 6120 7573 6572  behalf of a user
│ │ │ │ -00018730: 2e0a 2020 2020 204e 6f74 6520 7468 6174  ..     Note that
│ │ │ │ -00018740: 2069 6e20 736f 6d65 2063 6173 6573 2061   in some cases a
│ │ │ │ -00018750: 2053 6572 7665 7220 6d61 7920 6974 7365   Server may itse
│ │ │ │ -00018760: 6c66 2062 6520 6120 636c 6965 6e74 206f  lf be a client o
│ │ │ │ -00018770: 6620 736f 6d65 0a20 2020 2020 6f74 6865  f some.     othe
│ │ │ │ -00018780: 7220 7365 7276 6572 2028 652e 672e 2020  r server (e.g.  
│ │ │ │ -00018790: 6120 7072 696e 7420 7365 7276 6572 206d  a print server m
│ │ │ │ -000187a0: 6179 2062 6520 6120 636c 6965 6e74 206f  ay be a client o
│ │ │ │ -000187b0: 6620 6120 6669 6c65 0a20 2020 2020 7365  f a file.     se
│ │ │ │ -000187c0: 7276 6572 292e 0a0a 4372 6564 656e 7469  rver)...Credenti
│ │ │ │ -000187d0: 616c 730a 2020 2020 2041 2074 6963 6b65  als.     A ticke
│ │ │ │ -000187e0: 7420 706c 7573 2074 6865 2073 6563 7265  t plus the secre
│ │ │ │ -000187f0: 7420 7365 7373 696f 6e20 6b65 7920 6e65  t session key ne
│ │ │ │ -00018800: 6365 7373 6172 7920 746f 2073 7563 6365  cessary to succe
│ │ │ │ -00018810: 7373 6675 6c6c 7920 7573 650a 2020 2020  ssfully use.    
│ │ │ │ -00018820: 2074 6861 7420 7469 636b 6574 2069 6e20   that ticket in 
│ │ │ │ -00018830: 616e 2061 7574 6865 6e74 6963 6174 696f  an authenticatio
│ │ │ │ -00018840: 6e20 6578 6368 616e 6765 2e0a 0a45 6e63  n exchange...Enc
│ │ │ │ -00018850: 7279 7074 696f 6e20 5479 7065 2028 6574  ryption Type (et
│ │ │ │ -00018860: 7970 6529 0a20 2020 2020 5768 656e 2061  ype).     When a
│ │ │ │ -00018870: 7373 6f63 6961 7465 6420 7769 7468 2065  ssociated with e
│ │ │ │ -00018880: 6e63 7279 7074 6564 2064 6174 612c 2061  ncrypted data, a
│ │ │ │ -00018890: 6e20 656e 6372 7970 7469 6f6e 2074 7970  n encryption typ
│ │ │ │ -000188a0: 6520 6964 656e 7469 6669 6573 0a20 2020  e identifies.   
│ │ │ │ -000188b0: 2020 7468 6520 616c 676f 7269 7468 6d20    the algorithm 
│ │ │ │ -000188c0: 7573 6564 2074 6f20 656e 6372 7970 7420  used to encrypt 
│ │ │ │ -000188d0: 7468 6520 6461 7461 2061 6e64 2069 7320  the data and is 
│ │ │ │ -000188e0: 7573 6564 2074 6f20 7365 6c65 6374 2074  used to select t
│ │ │ │ -000188f0: 6865 0a20 2020 2020 6170 7072 6f70 7269  he.     appropri
│ │ │ │ -00018900: 6174 6520 616c 676f 7269 7468 6d20 666f  ate algorithm fo
│ │ │ │ -00018910: 7220 6465 6372 7970 7469 6e67 2074 6865  r decrypting the
│ │ │ │ -00018920: 2064 6174 612e 2020 456e 6372 7970 7469   data.  Encrypti
│ │ │ │ -00018930: 6f6e 2074 7970 650a 2020 2020 2074 6167  on type.     tag
│ │ │ │ -00018940: 7320 6172 6520 636f 6d6d 756e 6963 6174  s are communicat
│ │ │ │ -00018950: 6564 2069 6e20 6f74 6865 7220 6d65 7373  ed in other mess
│ │ │ │ -00018960: 6167 6573 2074 6f20 656e 756d 6572 6174  ages to enumerat
│ │ │ │ -00018970: 6520 616c 676f 7269 7468 6d73 0a20 2020  e algorithms.   
│ │ │ │ -00018980: 2020 7468 6174 2061 7265 2064 6573 6972    that are desir
│ │ │ │ -00018990: 6564 2c20 7375 7070 6f72 7465 642c 2070  ed, supported, p
│ │ │ │ -000189a0: 7265 6665 7272 6564 2c20 6f72 2061 6c6c  referred, or all
│ │ │ │ -000189b0: 6f77 6564 2074 6f20 6265 2075 7365 6420  owed to be used 
│ │ │ │ -000189c0: 666f 720a 2020 2020 2065 6e63 7279 7074  for.     encrypt
│ │ │ │ -000189d0: 696f 6e20 6f66 2064 6174 6120 6265 7477  ion of data betw
│ │ │ │ -000189e0: 6565 6e20 7061 7274 6965 732e 2020 5468  een parties.  Th
│ │ │ │ -000189f0: 6973 2070 7265 6665 7265 6e63 6520 6973  is preference is
│ │ │ │ -00018a00: 2063 6f6d 6269 6e65 640a 2020 2020 2077   combined.     w
│ │ │ │ -00018a10: 6974 6820 6c6f 6361 6c20 696e 666f 726d  ith local inform
│ │ │ │ -00018a20: 6174 696f 6e20 616e 6420 706f 6c69 6379  ation and policy
│ │ │ │ -00018a30: 2074 6f20 7365 6c65 6374 2061 6e20 616c   to select an al
│ │ │ │ -00018a40: 676f 7269 7468 6d20 746f 2062 650a 2020  gorithm to be.  
│ │ │ │ -00018a50: 2020 2075 7365 642e 0a0a 4b44 430a 2020     used...KDC.  
│ │ │ │ -00018a60: 2020 204b 6579 2044 6973 7472 6962 7574     Key Distribut
│ │ │ │ -00018a70: 696f 6e20 4365 6e74 6572 2c20 6120 6e65  ion Center, a ne
│ │ │ │ -00018a80: 7477 6f72 6b20 7365 7276 6963 6520 7468  twork service th
│ │ │ │ -00018a90: 6174 2073 7570 706c 6965 7320 7469 636b  at supplies tick
│ │ │ │ -00018aa0: 6574 730a 2020 2020 2061 6e64 2074 656d  ets.     and tem
│ │ │ │ -00018ab0: 706f 7261 7279 2073 6573 7369 6f6e 206b  porary session k
│ │ │ │ -00018ac0: 6579 733b 206f 7220 616e 2069 6e73 7461  eys; or an insta
│ │ │ │ -00018ad0: 6e63 6520 6f66 2074 6861 7420 7365 7276  nce of that serv
│ │ │ │ -00018ae0: 6963 6520 6f72 2074 6865 0a20 2020 2020  ice or the.     
│ │ │ │ -00018af0: 686f 7374 206f 6e20 7768 6963 6820 6974  host on which it
│ │ │ │ -00018b00: 2072 756e 732e 2020 5468 6520 4b44 4320   runs.  The KDC 
│ │ │ │ -00018b10: 7365 7276 6963 6573 2062 6f74 6820 696e  services both in
│ │ │ │ -00018b20: 6974 6961 6c20 7469 636b 6574 2061 6e64  itial ticket and
│ │ │ │ -00018b30: 0a20 2020 2020 7469 636b 6574 2d67 7261  .     ticket-gra
│ │ │ │ -00018b40: 6e74 696e 6720 7469 636b 6574 2072 6571  nting ticket req
│ │ │ │ -00018b50: 7565 7374 732e 2020 5468 6520 696e 6974  uests.  The init
│ │ │ │ -00018b60: 6961 6c20 7469 636b 6574 2070 6f72 7469  ial ticket porti
│ │ │ │ -00018b70: 6f6e 2069 730a 2020 2020 2073 6f6d 6574  on is.     somet
│ │ │ │ -00018b80: 696d 6573 2072 6566 6572 7265 6420 746f  imes referred to
│ │ │ │ -00018b90: 2061 7320 7468 6520 4175 7468 656e 7469   as the Authenti
│ │ │ │ -00018ba0: 6361 7469 6f6e 2053 6572 7665 7220 286f  cation Server (o
│ │ │ │ -00018bb0: 7220 7365 7276 6963 6529 2e0a 2020 2020  r service)..    
│ │ │ │ -00018bc0: 2054 6865 2074 6963 6b65 742d 6772 616e   The ticket-gran
│ │ │ │ -00018bd0: 7469 6e67 2074 6963 6b65 7420 706f 7274  ting ticket port
│ │ │ │ -00018be0: 696f 6e20 6973 2073 6f6d 6574 696d 6573  ion is sometimes
│ │ │ │ -00018bf0: 2072 6566 6572 7265 6420 746f 2061 7320   referred to as 
│ │ │ │ -00018c00: 7468 650a 2020 2020 2074 6963 6b65 742d  the.     ticket-
│ │ │ │ -00018c10: 6772 616e 7469 6e67 2073 6572 7665 7220  granting server 
│ │ │ │ -00018c20: 286f 7220 7365 7276 6963 6529 2e0a 0a4b  (or service)...K
│ │ │ │ -00018c30: 6572 6265 726f 730a 2020 2020 2054 6865  erberos.     The
│ │ │ │ -00018c40: 206e 616d 6520 6769 7665 6e20 746f 2074   name given to t
│ │ │ │ -00018c50: 6865 2050 726f 6a65 6374 2041 7468 656e  he Project Athen
│ │ │ │ -00018c60: 6127 7320 6175 7468 656e 7469 6361 7469  a's authenticati
│ │ │ │ -00018c70: 6f6e 2073 6572 7669 6365 2c20 7468 650a  on service, the.
│ │ │ │ -00018c80: 2020 2020 2070 726f 746f 636f 6c20 7573       protocol us
│ │ │ │ -00018c90: 6564 2062 7920 7468 6174 2073 6572 7669  ed by that servi
│ │ │ │ -00018ca0: 6365 2c20 6f72 2074 6865 2063 6f64 6520  ce, or the code 
│ │ │ │ -00018cb0: 7573 6564 2074 6f20 696d 706c 656d 656e  used to implemen
│ │ │ │ -00018cc0: 7420 7468 650a 2020 2020 2061 7574 6865  t the.     authe
│ │ │ │ -00018cd0: 6e74 6963 6174 696f 6e20 7365 7276 6963  ntication servic
│ │ │ │ -00018ce0: 652e 2020 5468 6520 6e61 6d65 2069 7320  e.  The name is 
│ │ │ │ -00018cf0: 6164 6f70 7465 6420 6672 6f6d 2074 6865  adopted from the
│ │ │ │ -00018d00: 2074 6872 6565 2d68 6561 6465 640a 2020   three-headed.  
│ │ │ │ -00018d10: 2020 2064 6f67 2077 6869 6368 2067 7561     dog which gua
│ │ │ │ -00018d20: 7264 7320 4861 6465 732e 0a0a 4b65 7920  rds Hades...Key 
│ │ │ │ -00018d30: 5665 7273 696f 6e20 4e75 6d62 6572 2028  Version Number (
│ │ │ │ -00018d40: 6b76 6e6f 290a 2020 2020 2041 2074 6167  kvno).     A tag
│ │ │ │ -00018d50: 2061 7373 6f63 6961 7465 6420 7769 7468   associated with
│ │ │ │ -00018d60: 2065 6e63 7279 7074 6564 2064 6174 6120   encrypted data 
│ │ │ │ -00018d70: 6964 656e 7469 6669 6573 2077 6869 6368  identifies which
│ │ │ │ -00018d80: 206b 6579 2077 6173 2075 7365 640a 2020   key was used.  
│ │ │ │ -00018d90: 2020 2066 6f72 2065 6e63 7279 7074 696f     for encryptio
│ │ │ │ -00018da0: 6e20 7768 656e 2061 206c 6f6e 6720 6c69  n when a long li
│ │ │ │ -00018db0: 7665 6420 6b65 7920 6173 736f 6369 6174  ved key associat
│ │ │ │ -00018dc0: 6564 2077 6974 6820 6120 7072 696e 6369  ed with a princi
│ │ │ │ -00018dd0: 7061 6c0a 2020 2020 2063 6861 6e67 6573  pal.     changes
│ │ │ │ -00018de0: 206f 7665 7220 7469 6d65 2e20 2049 7420   over time.  It 
│ │ │ │ -00018df0: 6973 2075 7365 6420 6475 7269 6e67 2074  is used during t
│ │ │ │ -00018e00: 6865 2074 7261 6e73 6974 696f 6e20 746f  he transition to
│ │ │ │ -00018e10: 2061 206e 6577 206b 6579 0a20 2020 2020   a new key.     
│ │ │ │ -00018e20: 736f 2074 6861 7420 7468 6520 7061 7274  so that the part
│ │ │ │ -00018e30: 7920 6465 6372 7970 7469 6e67 2061 206d  y decrypting a m
│ │ │ │ -00018e40: 6573 7361 6765 2063 616e 2074 656c 6c20  essage can tell 
│ │ │ │ -00018e50: 7768 6574 6865 7220 7468 6520 6461 7461  whether the data
│ │ │ │ -00018e60: 0a20 2020 2020 7761 7320 656e 6372 7970  .     was encryp
│ │ │ │ -00018e70: 7465 6420 7573 696e 6720 7468 6520 6f6c  ted using the ol
│ │ │ │ -00018e80: 6420 6f72 2074 6865 206e 6577 206b 6579  d or the new key
│ │ │ │ -00018e90: 2e0a 0a50 6c61 696e 7465 7874 0a20 2020  ...Plaintext.   
│ │ │ │ -00018ea0: 2020 5468 6520 696e 7075 7420 746f 2061    The input to a
│ │ │ │ -00018eb0: 6e20 656e 6372 7970 7469 6f6e 2066 756e  n encryption fun
│ │ │ │ -00018ec0: 6374 696f 6e20 6f72 2074 6865 206f 7574  ction or the out
│ │ │ │ -00018ed0: 7075 7420 6f66 2061 2064 6563 7279 7074  put of a decrypt
│ │ │ │ -00018ee0: 696f 6e0a 2020 2020 2066 756e 6374 696f  ion.     functio
│ │ │ │ -00018ef0: 6e2e 2020 4465 6372 7970 7469 6f6e 2074  n.  Decryption t
│ │ │ │ -00018f00: 7261 6e73 666f 726d 7320 6369 7068 6572  ransforms cipher
│ │ │ │ -00018f10: 7465 7874 2069 6e74 6f20 706c 6169 6e74  text into plaint
│ │ │ │ -00018f20: 6578 742e 0a0a 5072 696e 6369 7061 6c0a  ext...Principal.
│ │ │ │ -00018f30: 2020 2020 2041 206e 616d 6564 2063 6c69       A named cli
│ │ │ │ -00018f40: 656e 7420 6f72 2073 6572 7665 7220 656e  ent or server en
│ │ │ │ -00018f50: 7469 7479 2074 6861 7420 7061 7274 6963  tity that partic
│ │ │ │ -00018f60: 6970 6174 6573 2069 6e20 6120 6e65 7477  ipates in a netw
│ │ │ │ -00018f70: 6f72 6b0a 2020 2020 2063 6f6d 6d75 6e69  ork.     communi
│ │ │ │ -00018f80: 6361 7469 6f6e 2c20 7769 7468 206f 6e65  cation, with one
│ │ │ │ -00018f90: 206e 616d 6520 7468 6174 2069 7320 636f   name that is co
│ │ │ │ -00018fa0: 6e73 6964 6572 6564 2063 616e 6f6e 6963  nsidered canonic
│ │ │ │ -00018fb0: 616c 2e0a 0a50 7269 6e63 6970 616c 2069  al...Principal i
│ │ │ │ -00018fc0: 6465 6e74 6966 6965 720a 2020 2020 2054  dentifier.     T
│ │ │ │ -00018fd0: 6865 2063 616e 6f6e 6963 616c 206e 616d  he canonical nam
│ │ │ │ -00018fe0: 6520 7573 6564 2074 6f20 756e 6971 7565  e used to unique
│ │ │ │ -00018ff0: 6c79 2069 6465 6e74 6966 7920 6561 6368  ly identify each
│ │ │ │ -00019000: 2064 6966 6665 7265 6e74 0a20 2020 2020   different.     
│ │ │ │ -00019010: 7072 696e 6369 7061 6c2e 0a0a 5365 616c  principal...Seal
│ │ │ │ -00019020: 0a20 2020 2020 546f 2065 6e63 6970 6865  .     To enciphe
│ │ │ │ -00019030: 7220 6120 7265 636f 7264 2063 6f6e 7461  r a record conta
│ │ │ │ -00019040: 696e 696e 6720 7365 7665 7261 6c20 6669  ining several fi
│ │ │ │ -00019050: 656c 6473 2069 6e20 7375 6368 2061 2077  elds in such a w
│ │ │ │ -00019060: 6179 2074 6861 740a 2020 2020 2074 6865  ay that.     the
│ │ │ │ -00019070: 2066 6965 6c64 7320 6361 6e6e 6f74 2062   fields cannot b
│ │ │ │ -00019080: 6520 696e 6469 7669 6475 616c 6c79 2072  e individually r
│ │ │ │ -00019090: 6570 6c61 6365 6420 7769 7468 6f75 7420  eplaced without 
│ │ │ │ -000190a0: 6569 7468 6572 206b 6e6f 776c 6564 6765  either knowledge
│ │ │ │ -000190b0: 0a20 2020 2020 6f66 2074 6865 2065 6e63  .     of the enc
│ │ │ │ -000190c0: 7279 7074 696f 6e20 6b65 7920 6f72 206c  ryption key or l
│ │ │ │ -000190d0: 6561 7669 6e67 2065 7669 6465 6e63 6520  eaving evidence 
│ │ │ │ -000190e0: 6f66 2074 616d 7065 7269 6e67 2e0a 0a53  of tampering...S
│ │ │ │ -000190f0: 6563 7265 7420 6b65 790a 2020 2020 2041  ecret key.     A
│ │ │ │ -00019100: 6e20 656e 6372 7970 7469 6f6e 206b 6579  n encryption key
│ │ │ │ -00019110: 2073 6861 7265 6420 6279 2061 2070 7269   shared by a pri
│ │ │ │ -00019120: 6e63 6970 616c 2061 6e64 2074 6865 204b  ncipal and the K
│ │ │ │ -00019130: 4443 2c20 6469 7374 7269 6275 7465 640a  DC, distributed.
│ │ │ │ -00019140: 2020 2020 206f 7574 7369 6465 2074 6865       outside the
│ │ │ │ -00019150: 2062 6f75 6e64 7320 6f66 2074 6865 2073   bounds of the s
│ │ │ │ -00019160: 7973 7465 6d2c 2077 6974 6820 6120 6c6f  ystem, with a lo
│ │ │ │ -00019170: 6e67 206c 6966 6574 696d 652e 2020 496e  ng lifetime.  In
│ │ │ │ -00019180: 2074 6865 0a20 2020 2020 6361 7365 206f   the.     case o
│ │ │ │ -00019190: 6620 6120 6875 6d61 6e20 7573 6572 2773  f a human user's
│ │ │ │ -000191a0: 2070 7269 6e63 6970 616c 2c20 7468 6520   principal, the 
│ │ │ │ -000191b0: 7365 6372 6574 206b 6579 204d 4159 2062  secret key MAY b
│ │ │ │ -000191c0: 6520 6465 7269 7665 640a 2020 2020 2066  e derived.     f
│ │ │ │ -000191d0: 726f 6d20 6120 7061 7373 776f 7264 2e0a  rom a password..
│ │ │ │ -000191e0: 0a53 6572 7665 720a 2020 2020 2041 2070  .Server.     A p
│ │ │ │ -000191f0: 6172 7469 6375 6c61 7220 5072 696e 6369  articular Princi
│ │ │ │ -00019200: 7061 6c20 7768 6963 6820 7072 6f76 6964  pal which provid
│ │ │ │ -00019210: 6573 2061 2072 6573 6f75 7263 6520 746f  es a resource to
│ │ │ │ -00019220: 206e 6574 776f 726b 0a20 2020 2020 636c   network.     cl
│ │ │ │ -00019230: 6965 6e74 732e 2020 5468 6520 7365 7276  ients.  The serv
│ │ │ │ -00019240: 6572 2069 7320 736f 6d65 7469 6d65 7320  er is sometimes 
│ │ │ │ -00019250: 7265 6665 7272 6564 2074 6f20 6173 2074  referred to as t
│ │ │ │ -00019260: 6865 2041 7070 6c69 6361 7469 6f6e 0a20  he Application. 
│ │ │ │ -00019270: 2020 2020 5365 7276 6572 2e0a 0a53 6572      Server...Ser
│ │ │ │ -00019280: 7669 6365 0a20 2020 2020 4120 7265 736f  vice.     A reso
│ │ │ │ -00019290: 7572 6365 2070 726f 7669 6465 6420 746f  urce provided to
│ │ │ │ -000192a0: 206e 6574 776f 726b 2063 6c69 656e 7473   network clients
│ │ │ │ -000192b0: 3b20 6f66 7465 6e20 7072 6f76 6964 6564  ; often provided
│ │ │ │ -000192c0: 2062 7920 6d6f 7265 2074 6861 6e0a 2020   by more than.  
│ │ │ │ -000192d0: 2020 206f 6e65 2073 6572 7665 7220 2866     one server (f
│ │ │ │ -000192e0: 6f72 2065 7861 6d70 6c65 2c20 7265 6d6f  or example, remo
│ │ │ │ -000192f0: 7465 2066 696c 6520 7365 7276 6963 6529  te file service)
│ │ │ │ -00019300: 2e0a 0a53 6573 7369 6f6e 206b 6579 0a20  ...Session key. 
│ │ │ │ -00019310: 2020 2020 4120 7465 6d70 6f72 6172 7920      A temporary 
│ │ │ │ -00019320: 656e 6372 7970 7469 6f6e 206b 6579 2075  encryption key u
│ │ │ │ -00019330: 7365 6420 6265 7477 6565 6e20 7477 6f20  sed between two 
│ │ │ │ -00019340: 7072 696e 6369 7061 6c73 2c20 7769 7468  principals, with
│ │ │ │ -00019350: 2061 0a20 2020 2020 6c69 6665 7469 6d65   a.     lifetime
│ │ │ │ -00019360: 206c 696d 6974 6564 2074 6f20 7468 6520   limited to the 
│ │ │ │ -00019370: 6475 7261 7469 6f6e 206f 6620 6120 7369  duration of a si
│ │ │ │ -00019380: 6e67 6c65 206c 6f67 696e 2022 7365 7373  ngle login "sess
│ │ │ │ -00019390: 696f 6e22 2e20 2049 6e0a 2020 2020 2074  ion".  In.     t
│ │ │ │ -000193a0: 6865 204b 6572 6265 726f 7320 7379 7374  he Kerberos syst
│ │ │ │ -000193b0: 656d 2c20 6120 7365 7373 696f 6e20 6b65  em, a session ke
│ │ │ │ -000193c0: 7920 6973 2067 656e 6572 6174 6564 2062  y is generated b
│ │ │ │ -000193d0: 7920 7468 6520 4b44 432e 2054 6865 0a20  y the KDC. The. 
│ │ │ │ -000193e0: 2020 2020 7365 7373 696f 6e20 6b65 7920      session key 
│ │ │ │ -000193f0: 6973 2064 6973 7469 6e63 7420 6672 6f6d  is distinct from
│ │ │ │ -00019400: 2074 6865 2073 7562 2d73 6573 7369 6f6e   the sub-session
│ │ │ │ -00019410: 206b 6579 2c20 6465 7363 7269 6265 6420   key, described 
│ │ │ │ -00019420: 6e65 7874 2e2e 0a0a 5375 622d 7365 7373  next....Sub-sess
│ │ │ │ -00019430: 696f 6e20 6b65 790a 2020 2020 2041 2074  ion key.     A t
│ │ │ │ -00019440: 656d 706f 7261 7279 2065 6e63 7279 7074  emporary encrypt
│ │ │ │ -00019450: 696f 6e20 6b65 7920 7573 6564 2062 6574  ion key used bet
│ │ │ │ -00019460: 7765 656e 2074 776f 2070 7269 6e63 6970  ween two princip
│ │ │ │ -00019470: 616c 732c 2073 656c 6563 7465 640a 2020  als, selected.  
│ │ │ │ -00019480: 2020 2061 6e64 2065 7863 6861 6e67 6564     and exchanged
│ │ │ │ -00019490: 2062 7920 7468 6520 7072 696e 6369 7061   by the principa
│ │ │ │ -000194a0: 6c73 2075 7369 6e67 2074 6865 2073 6573  ls using the ses
│ │ │ │ -000194b0: 7369 6f6e 206b 6579 2c20 616e 6420 7769  sion key, and wi
│ │ │ │ -000194c0: 7468 2061 0a20 2020 2020 6c69 6665 7469  th a.     lifeti
│ │ │ │ -000194d0: 6d65 206c 696d 6974 6564 2074 6f20 7468  me limited to th
│ │ │ │ -000194e0: 6520 6475 7261 7469 6f6e 206f 6620 6120  e duration of a 
│ │ │ │ -000194f0: 7369 6e67 6c65 2061 7373 6f63 6961 7469  single associati
│ │ │ │ -00019500: 6f6e 2e20 2054 6865 2073 7562 2d0a 2020  on.  The sub-.  
│ │ │ │ -00019510: 2020 2073 6573 7369 6f6e 206b 6579 2069     session key i
│ │ │ │ -00019520: 7320 616c 736f 2072 6566 6572 7265 6420  s also referred 
│ │ │ │ -00019530: 746f 2061 7320 7468 6520 7375 626b 6579  to as the subkey
│ │ │ │ -00019540: 2e0a 0a54 6963 6b65 740a 2020 2020 2041  ...Ticket.     A
│ │ │ │ -00019550: 2072 6563 6f72 6420 7468 6174 2068 656c   record that hel
│ │ │ │ -00019560: 7073 2061 2063 6c69 656e 7420 6175 7468  ps a client auth
│ │ │ │ -00019570: 656e 7469 6361 7465 2069 7473 656c 6620  enticate itself 
│ │ │ │ -00019580: 746f 2061 2073 6572 7665 723b 2069 740a  to a server; it.
│ │ │ │ -00019590: 2020 2020 2063 6f6e 7461 696e 7320 7468       contains th
│ │ │ │ -000195a0: 6520 636c 6965 6e74 2773 2069 6465 6e74  e client's ident
│ │ │ │ -000195b0: 6974 792c 2061 2073 6573 7369 6f6e 206b  ity, a session k
│ │ │ │ -000195c0: 6579 2c20 6120 7469 6d65 7374 616d 702c  ey, a timestamp,
│ │ │ │ -000195d0: 2061 6e64 0a20 2020 2020 6f74 6865 7220   and.     other 
│ │ │ │ -000195e0: 696e 666f 726d 6174 696f 6e2c 2061 6c6c  information, all
│ │ │ │ -000195f0: 2073 6561 6c65 6420 7573 696e 6720 7468   sealed using th
│ │ │ │ -00019600: 6520 7365 7276 6572 2773 2073 6563 7265  e server's secre
│ │ │ │ -00019610: 7420 6b65 792e 2020 4974 0a20 2020 2020  t key.  It.     
│ │ │ │ -00019620: 6f6e 6c79 2073 6572 7665 7320 746f 2061  only serves to a
│ │ │ │ -00019630: 7574 6865 6e74 6963 6174 6520 6120 636c  uthenticate a cl
│ │ │ │ -00019640: 6965 6e74 2077 6865 6e20 7072 6573 656e  ient when presen
│ │ │ │ -00019650: 7465 6420 616c 6f6e 6720 7769 7468 2061  ted along with a
│ │ │ │ -00019660: 0a20 2020 2020 6672 6573 6820 4175 7468  .     fresh Auth
│ │ │ │ -00019670: 656e 7469 6361 746f 722e 0a0a 1f0a 4669  enticator.....Fi
│ │ │ │ -00019680: 6c65 3a20 7368 6973 6869 2e69 6e66 6f2c  le: shishi.info,
│ │ │ │ -00019690: 2020 4e6f 6465 3a20 5265 616c 6d20 616e    Node: Realm an
│ │ │ │ -000196a0: 6420 5072 696e 6369 7061 6c20 4e61 6d69  d Principal Nami
│ │ │ │ -000196b0: 6e67 2c20 204e 6578 743a 2053 6869 7368  ng,  Next: Shish
│ │ │ │ -000196c0: 6920 436f 6e66 6967 7572 6174 696f 6e2c  i Configuration,
│ │ │ │ -000196d0: 2020 5072 6576 3a20 476c 6f73 7361 7279    Prev: Glossary
│ │ │ │ -000196e0: 206f 6620 7465 726d 732c 2020 5570 3a20   of terms,  Up: 
│ │ │ │ -000196f0: 5265 6665 7265 6e63 6520 4d61 6e75 616c  Reference Manual
│ │ │ │ -00019700: 0a0a 342e 3320 5265 616c 6d20 616e 6420  ..4.3 Realm and 
│ │ │ │ -00019710: 5072 696e 6369 7061 6c20 4e61 6d69 6e67  Principal Naming
│ │ │ │ -00019720: 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  .===============
│ │ │ │ -00019730: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a  ===============.
│ │ │ │ -00019740: 0a54 6869 7320 7365 6374 696f 6e20 636f  .This section co
│ │ │ │ -00019750: 6e74 6169 6e73 2074 6865 2064 6973 6375  ntains the discu
│ │ │ │ -00019760: 7373 696f 6e20 6f6e 206e 616d 696e 6720  ssion on naming 
│ │ │ │ -00019770: 7265 616c 6d73 2061 6e64 2070 7269 6e63  realms and princ
│ │ │ │ -00019780: 6970 616c 730a 6672 6f6d 2074 6865 204b  ipals.from the K
│ │ │ │ -00019790: 6572 6265 726f 7320 7370 6563 6966 6963  erberos specific
│ │ │ │ -000197a0: 6174 696f 6e2e 0a0a 342e 332e 3120 5265  ation...4.3.1 Re
│ │ │ │ -000197b0: 616c 6d20 4e61 6d65 730a 2d2d 2d2d 2d2d  alm Names.------
│ │ │ │ -000197c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a41 6c74  -----------..Alt
│ │ │ │ -000197d0: 686f 7567 6820 7265 616c 6d20 6e61 6d65  hough realm name
│ │ │ │ -000197e0: 7320 6172 6520 656e 636f 6465 6420 6173  s are encoded as
│ │ │ │ -000197f0: 2047 656e 6572 616c 5374 7269 6e67 7320   GeneralStrings 
│ │ │ │ -00019800: 616e 6420 616c 7468 6f75 6768 2061 2072  and although a r
│ │ │ │ -00019810: 6561 6c6d 0a63 616e 2074 6563 686e 6963  ealm.can technic
│ │ │ │ -00019820: 616c 6c79 2073 656c 6563 7420 616e 7920  ally select any 
│ │ │ │ -00019830: 6e61 6d65 2069 7420 6368 6f6f 7365 732c  name it chooses,
│ │ │ │ -00019840: 2069 6e74 6572 6f70 6572 6162 696c 6974   interoperabilit
│ │ │ │ -00019850: 7920 6163 726f 7373 0a72 6561 6c6d 2062  y across.realm b
│ │ │ │ -00019860: 6f75 6e64 6172 6965 7320 7265 7175 6972  oundaries requir
│ │ │ │ -00019870: 6573 2061 6772 6565 6d65 6e74 206f 6e20  es agreement on 
│ │ │ │ -00019880: 686f 7720 7265 616c 6d20 6e61 6d65 7320  how realm names 
│ │ │ │ -00019890: 6172 6520 746f 2062 650a 6173 7369 676e  are to be.assign
│ │ │ │ -000198a0: 6564 2c20 616e 6420 7768 6174 2069 6e66  ed, and what inf
│ │ │ │ -000198b0: 6f72 6d61 7469 6f6e 2074 6865 7920 696d  ormation they im
│ │ │ │ -000198c0: 706c 792e 0a0a 2020 2054 6f20 656e 666f  ply...   To enfo
│ │ │ │ -000198d0: 7263 6520 7468 6573 6520 636f 6e76 656e  rce these conven
│ │ │ │ -000198e0: 7469 6f6e 732c 2065 6163 6820 7265 616c  tions, each real
│ │ │ │ -000198f0: 6d20 4d55 5354 2063 6f6e 666f 726d 2074  m MUST conform t
│ │ │ │ -00019900: 6f20 7468 650a 636f 6e76 656e 7469 6f6e  o the.convention
│ │ │ │ -00019910: 7320 6974 7365 6c66 2c20 616e 6420 6974  s itself, and it
│ │ │ │ -00019920: 204d 5553 5420 7265 7175 6972 6520 7468   MUST require th
│ │ │ │ -00019930: 6174 2061 6e79 2072 6561 6c6d 7320 7769  at any realms wi
│ │ │ │ -00019940: 7468 2077 6869 6368 0a69 6e74 6572 2d72  th which.inter-r
│ │ │ │ -00019950: 6561 6c6d 206b 6579 7320 6172 6520 7368  ealm keys are sh
│ │ │ │ -00019960: 6172 6564 2061 6c73 6f20 636f 6e66 6f72  ared also confor
│ │ │ │ -00019970: 6d20 746f 2074 6865 2063 6f6e 7665 6e74  m to the convent
│ │ │ │ -00019980: 696f 6e73 2061 6e64 2072 6571 7569 7265  ions and require
│ │ │ │ -00019990: 0a74 6865 2073 616d 6520 6672 6f6d 2069  .the same from i
│ │ │ │ -000199a0: 7473 206e 6569 6768 626f 7273 2e0a 0a20  ts neighbors... 
│ │ │ │ -000199b0: 2020 4b65 7262 6572 6f73 2072 6561 6c6d    Kerberos realm
│ │ │ │ -000199c0: 206e 616d 6573 2061 7265 2063 6173 6520   names are case 
│ │ │ │ -000199d0: 7365 6e73 6974 6976 652e 2020 5265 616c  sensitive.  Real
│ │ │ │ -000199e0: 6d20 6e61 6d65 7320 7468 6174 2064 6966  m names that dif
│ │ │ │ -000199f0: 6665 720a 6f6e 6c79 2069 6e20 7468 6520  fer.only in the 
│ │ │ │ -00019a00: 6361 7365 206f 6620 7468 6520 6368 6172  case of the char
│ │ │ │ -00019a10: 6163 7465 7273 2061 7265 206e 6f74 2065  acters are not e
│ │ │ │ -00019a20: 7175 6976 616c 656e 742e 2020 5468 6572  quivalent.  Ther
│ │ │ │ -00019a30: 6520 6172 650a 7072 6573 656e 746c 7920  e are.presently 
│ │ │ │ -00019a40: 7468 7265 6520 7374 796c 6573 206f 6620  three styles of 
│ │ │ │ -00019a50: 7265 616c 6d20 6e61 6d65 733a 2064 6f6d  realm names: dom
│ │ │ │ -00019a60: 6169 6e2c 2058 3530 302c 2061 6e64 206f  ain, X500, and o
│ │ │ │ -00019a70: 7468 6572 2e0a 4578 616d 706c 6573 206f  ther..Examples o
│ │ │ │ -00019a80: 6620 6561 6368 2073 7479 6c65 2066 6f6c  f each style fol
│ │ │ │ -00019a90: 6c6f 773a 0a0a 2020 2020 2020 2020 2020  low:..          
│ │ │ │ -00019aa0: 646f 6d61 696e 3a20 2020 4154 4845 4e41  domain:   ATHENA
│ │ │ │ -00019ab0: 2e4d 4954 2e45 4455 0a20 2020 2020 2020  .MIT.EDU.       
│ │ │ │ -00019ac0: 2020 2020 2058 3530 303a 2020 2043 3d55       X500:   C=U
│ │ │ │ -00019ad0: 532f 4f3d 4f53 460a 2020 2020 2020 2020  S/O=OSF.        
│ │ │ │ -00019ae0: 2020 206f 7468 6572 3a20 2020 4e41 4d45     other:   NAME
│ │ │ │ -00019af0: 5459 5045 3a72 6573 742f 6f66 2e6e 616d  TYPE:rest/of.nam
│ │ │ │ -00019b00: 653d 7769 7468 6f75 742d 7265 7374 7269  e=without-restri
│ │ │ │ -00019b10: 6374 696f 6e73 0a0a 2020 2044 6f6d 6169  ctions..   Domai
│ │ │ │ -00019b20: 6e20 7379 6c65 2072 6561 6c6d 206e 616d  n syle realm nam
│ │ │ │ -00019b30: 6573 204d 5553 5420 6c6f 6f6b 206c 696b  es MUST look lik
│ │ │ │ -00019b40: 6520 646f 6d61 696e 206e 616d 6573 3a20  e domain names: 
│ │ │ │ -00019b50: 7468 6579 2063 6f6e 7369 7374 206f 660a  they consist of.
│ │ │ │ -00019b60: 636f 6d70 6f6e 656e 7473 2073 6570 6172  components separ
│ │ │ │ -00019b70: 6174 6564 2062 7920 7065 7269 6f64 7320  ated by periods 
│ │ │ │ -00019b80: 282e 2920 2061 6e64 2074 6865 7920 636f  (.)  and they co
│ │ │ │ -00019b90: 6e74 6169 6e20 6e65 6974 6865 7220 636f  ntain neither co
│ │ │ │ -00019ba0: 6c6f 6e73 2028 3a29 0a6e 6f72 2073 6c61  lons (:).nor sla
│ │ │ │ -00019bb0: 7368 6573 2028 2f29 2e20 2054 686f 7567  shes (/).  Thoug
│ │ │ │ -00019bc0: 6820 646f 6d61 696e 206e 616d 6573 2074  h domain names t
│ │ │ │ -00019bd0: 6865 6d73 656c 7665 7320 6172 6520 6361  hemselves are ca
│ │ │ │ -00019be0: 7365 2069 6e73 656e 7369 7469 7665 2c0a  se insensitive,.
│ │ │ │ -00019bf0: 696e 206f 7264 6572 2066 6f72 2072 6561  in order for rea
│ │ │ │ -00019c00: 6c6d 7320 746f 206d 6174 6368 2c20 7468  lms to match, th
│ │ │ │ -00019c10: 6520 6361 7365 206d 7573 7420 6d61 7463  e case must matc
│ │ │ │ -00019c20: 6820 6173 2077 656c 6c2e 2020 5768 656e  h as well.  When
│ │ │ │ -00019c30: 0a65 7374 6162 6c69 7368 696e 6720 6120  .establishing a 
│ │ │ │ -00019c40: 6e65 7720 7265 616c 6d20 6e61 6d65 2062  new realm name b
│ │ │ │ -00019c50: 6173 6564 206f 6e20 616e 2069 6e74 6572  ased on an inter
│ │ │ │ -00019c60: 6e65 7420 646f 6d61 696e 206e 616d 6520  net domain name 
│ │ │ │ -00019c70: 6974 2069 730a 7265 636f 6d6d 656e 6465  it is.recommende
│ │ │ │ -00019c80: 6420 6279 2063 6f6e 7665 6e74 696f 6e20  d by convention 
│ │ │ │ -00019c90: 7468 6174 2074 6865 2063 6861 7261 6374  that the charact
│ │ │ │ -00019ca0: 6572 7320 6265 2063 6f6e 7665 7274 6564  ers be converted
│ │ │ │ -00019cb0: 2074 6f20 7570 7065 720a 6361 7365 2e0a   to upper.case..
│ │ │ │ -00019cc0: 0a20 2020 582e 3530 3020 6e61 6d65 7320  .   X.500 names 
│ │ │ │ -00019cd0: 636f 6e74 6169 6e20 616e 2065 7175 616c  contain an equal
│ │ │ │ -00019ce0: 2028 3d29 2061 6e64 2063 616e 6e6f 7420   (=) and cannot 
│ │ │ │ -00019cf0: 636f 6e74 6169 6e20 6120 636f 6c6f 6e20  contain a colon 
│ │ │ │ -00019d00: 283a 290a 6265 666f 7265 2074 6865 2065  (:).before the e
│ │ │ │ -00019d10: 7175 616c 2e20 2054 6865 2072 6561 6c6d  qual.  The realm
│ │ │ │ -00019d20: 206e 616d 6573 2066 6f72 2058 2e35 3030   names for X.500
│ │ │ │ -00019d30: 206e 616d 6573 2077 696c 6c20 6265 2073   names will be s
│ │ │ │ -00019d40: 7472 696e 670a 7265 7072 6573 656e 7461  tring.representa
│ │ │ │ -00019d50: 7469 6f6e 7320 6f66 2074 6865 206e 616d  tions of the nam
│ │ │ │ -00019d60: 6573 2077 6974 6820 636f 6d70 6f6e 656e  es with componen
│ │ │ │ -00019d70: 7473 2073 6570 6172 6174 6564 2062 7920  ts separated by 
│ │ │ │ -00019d80: 736c 6173 6865 732e 0a4c 6561 6469 6e67  slashes..Leading
│ │ │ │ -00019d90: 2061 6e64 2074 7261 696c 696e 6720 736c   and trailing sl
│ │ │ │ -00019da0: 6173 6865 7320 7769 6c6c 206e 6f74 2062  ashes will not b
│ │ │ │ -00019db0: 6520 696e 636c 7564 6564 2e20 204e 6f74  e included.  Not
│ │ │ │ -00019dc0: 6520 7468 6174 2074 6865 2073 6c61 7368  e that the slash
│ │ │ │ -00019dd0: 0a73 6570 6172 6174 6f72 2069 7320 636f  .separator is co
│ │ │ │ -00019de0: 6e73 6973 7465 6e74 2077 6974 6820 4b65  nsistent with Ke
│ │ │ │ -00019df0: 7262 6572 6f73 2069 6d70 6c65 6d65 6e74  rberos implement
│ │ │ │ -00019e00: 6174 696f 6e73 2062 6173 6564 206f 6e20  ations based on 
│ │ │ │ -00019e10: 5246 4331 3531 302c 0a62 7574 2069 7420  RFC1510,.but it 
│ │ │ │ -00019e20: 6973 2064 6966 6665 7265 6e74 2066 726f  is different fro
│ │ │ │ -00019e30: 6d20 7468 6520 7365 7061 7261 746f 7220  m the separator 
│ │ │ │ -00019e40: 7265 636f 6d6d 656e 6465 6420 696e 2052  recommended in R
│ │ │ │ -00019e50: 4643 3232 3533 2e0a 0a20 2020 4e61 6d65  FC2253...   Name
│ │ │ │ -00019e60: 7320 7468 6174 2066 616c 6c20 696e 746f  s that fall into
│ │ │ │ -00019e70: 2074 6865 206f 7468 6572 2063 6174 6567   the other categ
│ │ │ │ -00019e80: 6f72 7920 4d55 5354 2062 6567 696e 2077  ory MUST begin w
│ │ │ │ -00019e90: 6974 6820 6120 7072 6566 6978 2074 6861  ith a prefix tha
│ │ │ │ -00019ea0: 740a 636f 6e74 6169 6e73 206e 6f20 6571  t.contains no eq
│ │ │ │ -00019eb0: 7561 6c20 283d 2920 6f72 2070 6572 696f  ual (=) or perio
│ │ │ │ -00019ec0: 6420 282e 2920 2061 6e64 2074 6865 2070  d (.)  and the p
│ │ │ │ -00019ed0: 7265 6669 7820 4d55 5354 2062 6520 666f  refix MUST be fo
│ │ │ │ -00019ee0: 6c6c 6f77 6564 2062 790a 6120 636f 6c6f  llowed by.a colo
│ │ │ │ -00019ef0: 6e20 283a 2920 616e 6420 7468 6520 7265  n (:) and the re
│ │ │ │ -00019f00: 7374 206f 6620 7468 6520 6e61 6d65 2e20  st of the name. 
│ │ │ │ -00019f10: 2041 6c6c 2070 7265 6669 7865 7320 6d75   All prefixes mu
│ │ │ │ -00019f20: 7374 2062 6520 6173 7369 676e 6564 0a62  st be assigned.b
│ │ │ │ -00019f30: 6566 6f72 6520 7468 6579 206d 6179 2062  efore they may b
│ │ │ │ -00019f40: 6520 7573 6564 2e20 2050 7265 7365 6e74  e used.  Present
│ │ │ │ -00019f50: 6c79 206e 6f6e 6520 6172 6520 6173 7369  ly none are assi
│ │ │ │ -00019f60: 676e 6564 2e0a 0a20 2020 5468 6520 7265  gned...   The re
│ │ │ │ -00019f70: 7365 7276 6564 2063 6174 6567 6f72 7920  served category 
│ │ │ │ -00019f80: 696e 636c 7564 6573 2073 7472 696e 6773  includes strings
│ │ │ │ -00019f90: 2077 6869 6368 2064 6f20 6e6f 7420 6661   which do not fa
│ │ │ │ -00019fa0: 6c6c 2069 6e74 6f20 7468 650a 6669 7273  ll into the.firs
│ │ │ │ -00019fb0: 7420 7468 7265 6520 6361 7465 676f 7269  t three categori
│ │ │ │ -00019fc0: 6573 2e20 2041 6c6c 206e 616d 6573 2069  es.  All names i
│ │ │ │ -00019fd0: 6e20 7468 6973 2063 6174 6567 6f72 7920  n this category 
│ │ │ │ -00019fe0: 6172 6520 7265 7365 7276 6564 2e20 2049  are reserved.  I
│ │ │ │ -00019ff0: 7420 6973 0a75 6e6c 696b 656c 7920 7468  t is.unlikely th
│ │ │ │ -0001a000: 6174 206e 616d 6573 2077 696c 6c20 6265  at names will be
│ │ │ │ -0001a010: 2061 7373 6967 6e65 6420 746f 2074 6869   assigned to thi
│ │ │ │ -0001a020: 7320 6361 7465 676f 7279 2075 6e6c 6573  s category unles
│ │ │ │ -0001a030: 7320 7468 6572 6520 6973 2061 0a76 6572  s there is a.ver
│ │ │ │ -0001a040: 7920 7374 726f 6e67 2061 7267 756d 656e  y strong argumen
│ │ │ │ -0001a050: 7420 666f 7220 6e6f 7420 7573 696e 6720  t for not using 
│ │ │ │ -0001a060: 7468 6520 276f 7468 6572 2720 6361 7465  the 'other' cate
│ │ │ │ -0001a070: 676f 7279 2e0a 0a20 2020 5468 6573 6520  gory...   These 
│ │ │ │ -0001a080: 7275 6c65 7320 6775 6172 616e 7465 6520  rules guarantee 
│ │ │ │ -0001a090: 7468 6174 2074 6865 7265 2077 696c 6c20  that there will 
│ │ │ │ -0001a0a0: 6265 206e 6f20 636f 6e66 6c69 6374 7320  be no conflicts 
│ │ │ │ -0001a0b0: 6265 7477 6565 6e20 7468 650a 7661 7269  between the.vari
│ │ │ │ -0001a0c0: 6f75 7320 6e61 6d65 2073 7479 6c65 732e  ous name styles.
│ │ │ │ -0001a0d0: 2020 5468 6520 666f 6c6c 6f77 696e 6720    The following 
│ │ │ │ -0001a0e0: 6164 6469 7469 6f6e 616c 2063 6f6e 7374  additional const
│ │ │ │ -0001a0f0: 7261 696e 7473 2061 7070 6c79 2074 6f20  raints apply to 
│ │ │ │ -0001a100: 7468 650a 6173 7369 676e 6d65 6e74 206f  the.assignment o
│ │ │ │ -0001a110: 6620 7265 616c 6d20 6e61 6d65 7320 696e  f realm names in
│ │ │ │ -0001a120: 2074 6865 2064 6f6d 6169 6e20 616e 6420   the domain and 
│ │ │ │ -0001a130: 582e 3530 3020 6361 7465 676f 7269 6573  X.500 categories
│ │ │ │ -0001a140: 3a20 7468 6520 6e61 6d65 0a6f 6620 6120  : the name.of a 
│ │ │ │ -0001a150: 7265 616c 6d20 666f 7220 7468 6520 646f  realm for the do
│ │ │ │ -0001a160: 6d61 696e 206f 7220 582e 3530 3020 666f  main or X.500 fo
│ │ │ │ -0001a170: 726d 6174 7320 6d75 7374 2065 6974 6865  rmats must eithe
│ │ │ │ -0001a180: 7220 6265 2075 7365 6420 6279 2074 6865  r be used by the
│ │ │ │ -0001a190: 0a6f 7267 616e 697a 6174 696f 6e20 6f77  .organization ow
│ │ │ │ -0001a1a0: 6e69 6e67 2028 746f 2077 686f 6d20 6974  ning (to whom it
│ │ │ │ -0001a1b0: 2077 6173 2061 7373 6967 6e65 6429 2061   was assigned) a
│ │ │ │ -0001a1c0: 6e20 496e 7465 726e 6574 2064 6f6d 6169  n Internet domai
│ │ │ │ -0001a1d0: 6e20 6e61 6d65 206f 720a 582e 3530 3020  n name or.X.500 
│ │ │ │ -0001a1e0: 6e61 6d65 2c20 6f72 2069 6e20 7468 6520  name, or in the 
│ │ │ │ -0001a1f0: 6361 7365 2074 6861 7420 6e6f 2073 7563  case that no suc
│ │ │ │ -0001a200: 6820 6e61 6d65 7320 6172 6520 7265 6769  h names are regi
│ │ │ │ -0001a210: 7374 6572 6564 2c20 6175 7468 6f72 6974  stered, authorit
│ │ │ │ -0001a220: 790a 746f 2075 7365 2061 2072 6561 6c6d  y.to use a realm
│ │ │ │ -0001a230: 206e 616d 6520 4d41 5920 6265 2064 6572   name MAY be der
│ │ │ │ -0001a240: 6976 6564 2066 726f 6d20 7468 6520 6175  ived from the au
│ │ │ │ -0001a250: 7468 6f72 6974 7920 6f66 2074 6865 2070  thority of the p
│ │ │ │ -0001a260: 6172 656e 740a 7265 616c 6d2e 2020 466f  arent.realm.  Fo
│ │ │ │ -0001a270: 7220 6578 616d 706c 652c 2069 6620 7468  r example, if th
│ │ │ │ -0001a280: 6572 6520 6973 206e 6f20 646f 6d61 696e  ere is no domain
│ │ │ │ -0001a290: 206e 616d 6520 666f 7220 4534 302e 4d49   name for E40.MI
│ │ │ │ -0001a2a0: 542e 4544 552c 2074 6865 6e0a 7468 6520  T.EDU, then.the 
│ │ │ │ -0001a2b0: 6164 6d69 6e69 7374 7261 746f 7220 6f66  administrator of
│ │ │ │ -0001a2c0: 2074 6865 204d 4954 2e45 4455 2072 6561   the MIT.EDU rea
│ │ │ │ -0001a2d0: 6c6d 2063 616e 2061 7574 686f 7269 7a65  lm can authorize
│ │ │ │ -0001a2e0: 2074 6865 2063 7265 6174 696f 6e20 6f66   the creation of
│ │ │ │ -0001a2f0: 2061 0a72 6561 6c6d 2077 6974 6820 7468   a.realm with th
│ │ │ │ -0001a300: 6174 206e 616d 652e 0a0a 2020 2054 6869  at name...   Thi
│ │ │ │ -0001a310: 7320 6973 2061 6363 6570 7461 626c 6520  s is acceptable 
│ │ │ │ -0001a320: 6265 6361 7573 6520 7468 6520 6f72 6761  because the orga
│ │ │ │ -0001a330: 6e69 7a61 7469 6f6e 2074 6f20 7768 6963  nization to whic
│ │ │ │ -0001a340: 6820 7468 6520 7061 7265 6e74 2069 730a  h the parent is.
│ │ │ │ -0001a350: 6173 7369 676e 6564 2069 7320 7072 6573  assigned is pres
│ │ │ │ -0001a360: 756d 6162 6c79 2074 6865 206f 7267 616e  umably the organ
│ │ │ │ -0001a370: 697a 6174 696f 6e20 6175 7468 6f72 697a  ization authoriz
│ │ │ │ -0001a380: 6564 2074 6f20 6173 7369 676e 206e 616d  ed to assign nam
│ │ │ │ -0001a390: 6573 2074 6f0a 6974 7320 6368 696c 6472  es to.its childr
│ │ │ │ -0001a3a0: 656e 2069 6e20 7468 6520 582e 3530 3020  en in the X.500 
│ │ │ │ -0001a3b0: 616e 6420 646f 6d61 696e 206e 616d 6520  and domain name 
│ │ │ │ -0001a3c0: 7379 7374 656d 7320 6173 2077 656c 6c2e  systems as well.
│ │ │ │ -0001a3d0: 2020 4966 2074 6865 0a70 6172 656e 7420    If the.parent 
│ │ │ │ -0001a3e0: 6173 7369 676e 7320 6120 7265 616c 6d20  assigns a realm 
│ │ │ │ -0001a3f0: 6e61 6d65 2077 6974 686f 7574 2061 6c73  name without als
│ │ │ │ -0001a400: 6f20 7265 6769 7374 6572 696e 6720 6974  o registering it
│ │ │ │ -0001a410: 2069 6e20 7468 6520 646f 6d61 696e 0a6e   in the domain.n
│ │ │ │ -0001a420: 616d 6520 6f72 2058 2e35 3030 2068 6965  ame or X.500 hie
│ │ │ │ -0001a430: 7261 7263 6879 2c20 6974 2069 7320 7468  rarchy, it is th
│ │ │ │ -0001a440: 6520 7061 7265 6e74 2773 2072 6573 706f  e parent's respo
│ │ │ │ -0001a450: 6e73 6962 696c 6974 7920 746f 206d 616b  nsibility to mak
│ │ │ │ -0001a460: 6520 7375 7265 0a74 6861 7420 7468 6572  e sure.that ther
│ │ │ │ -0001a470: 6520 7769 6c6c 206e 6f74 2069 6e20 7468  e will not in th
│ │ │ │ -0001a480: 6520 6675 7475 7265 2065 7869 7374 2061  e future exist a
│ │ │ │ -0001a490: 206e 616d 6520 6964 656e 7469 6361 6c20   name identical 
│ │ │ │ -0001a4a0: 746f 2074 6865 2072 6561 6c6d 0a6e 616d  to the realm.nam
│ │ │ │ -0001a4b0: 6520 6f66 2074 6865 2063 6869 6c64 2075  e of the child u
│ │ │ │ -0001a4c0: 6e6c 6573 7320 6974 2069 7320 6173 7369  nless it is assi
│ │ │ │ -0001a4d0: 676e 6564 2074 6f20 7468 6520 7361 6d65  gned to the same
│ │ │ │ -0001a4e0: 2065 6e74 6974 7920 6173 2074 6865 2072   entity as the r
│ │ │ │ -0001a4f0: 6561 6c6d 0a6e 616d 652e 0a0a 342e 332e  ealm.name...4.3.
│ │ │ │ -0001a500: 3220 5072 696e 6369 7061 6c20 4e61 6d65  2 Principal Name
│ │ │ │ -0001a510: 730a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  s.--------------
│ │ │ │ -0001a520: 2d2d 2d2d 2d2d 2d0a 0a41 7320 7761 7320  -------..As was 
│ │ │ │ -0001a530: 7468 6520 6361 7365 2066 6f72 2072 6561  the case for rea
│ │ │ │ -0001a540: 6c6d 206e 616d 6573 2c20 636f 6e76 656e  lm names, conven
│ │ │ │ -0001a550: 7469 6f6e 7320 6172 6520 6e65 6564 6564  tions are needed
│ │ │ │ -0001a560: 2074 6f20 656e 7375 7265 2074 6861 740a   to ensure that.
│ │ │ │ -0001a570: 616c 6c20 6167 7265 6520 6f6e 2077 6861  all agree on wha
│ │ │ │ -0001a580: 7420 696e 666f 726d 6174 696f 6e20 6973  t information is
│ │ │ │ -0001a590: 2069 6d70 6c69 6564 2062 7920 6120 7072   implied by a pr
│ │ │ │ -0001a5a0: 696e 6369 7061 6c20 6e61 6d65 2e20 2054  incipal name.  T
│ │ │ │ -0001a5b0: 6865 0a6e 616d 652d 7479 7065 2066 6965  he.name-type fie
│ │ │ │ -0001a5c0: 6c64 2074 6861 7420 6973 2070 6172 7420  ld that is part 
│ │ │ │ -0001a5d0: 6f66 2074 6865 2070 7269 6e63 6970 616c  of the principal
│ │ │ │ -0001a5e0: 206e 616d 6520 696e 6469 6361 7465 7320   name indicates 
│ │ │ │ -0001a5f0: 7468 6520 6b69 6e64 206f 660a 696e 666f  the kind of.info
│ │ │ │ -0001a600: 726d 6174 696f 6e20 696d 706c 6965 6420  rmation implied 
│ │ │ │ -0001a610: 6279 2074 6865 206e 616d 652e 2020 5468  by the name.  Th
│ │ │ │ -0001a620: 6520 6e61 6d65 2d74 7970 6520 5348 4f55  e name-type SHOU
│ │ │ │ -0001a630: 4c44 2062 6520 7472 6561 7465 6420 6f6e  LD be treated on
│ │ │ │ -0001a640: 6c79 0a61 7320 6120 6869 6e74 2074 6f20  ly.as a hint to 
│ │ │ │ -0001a650: 696e 7465 7270 7265 7469 6e67 2074 6865  interpreting the
│ │ │ │ -0001a660: 206d 6561 6e69 6e67 206f 6620 6120 6e61   meaning of a na
│ │ │ │ -0001a670: 6d65 2e20 2049 7420 6973 206e 6f74 2073  me.  It is not s
│ │ │ │ -0001a680: 6967 6e69 6669 6361 6e74 0a77 6865 6e20  ignificant.when 
│ │ │ │ -0001a690: 6368 6563 6b69 6e67 2066 6f72 2065 7175  checking for equ
│ │ │ │ -0001a6a0: 6976 616c 656e 6365 2e20 2050 7269 6e63  ivalence.  Princ
│ │ │ │ -0001a6b0: 6970 616c 206e 616d 6573 2074 6861 7420  ipal names that 
│ │ │ │ -0001a6c0: 6469 6666 6572 206f 6e6c 7920 696e 2074  differ only in t
│ │ │ │ -0001a6d0: 6865 0a6e 616d 652d 7479 7065 2069 6465  he.name-type ide
│ │ │ │ -0001a6e0: 6e74 6966 7920 7468 6520 7361 6d65 2070  ntify the same p
│ │ │ │ -0001a6f0: 7269 6e63 6970 616c 2e20 2054 6865 206e  rincipal.  The n
│ │ │ │ -0001a700: 616d 6520 7479 7065 2064 6f65 7320 6e6f  ame type does no
│ │ │ │ -0001a710: 7420 7061 7274 6974 696f 6e0a 7468 6520  t partition.the 
│ │ │ │ -0001a720: 6e61 6d65 2073 7061 6365 2e20 2049 676e  name space.  Ign
│ │ │ │ -0001a730: 6f72 696e 6720 7468 6520 6e61 6d65 2074  oring the name t
│ │ │ │ -0001a740: 7970 652c 206e 6f20 7477 6f20 6e61 6d65  ype, no two name
│ │ │ │ -0001a750: 7320 6361 6e20 6265 2074 6865 2073 616d  s can be the sam
│ │ │ │ -0001a760: 650a 2869 2e65 2e20 2061 7420 6c65 6173  e.(i.e.  at leas
│ │ │ │ -0001a770: 7420 6f6e 6520 6f66 2074 6865 2063 6f6d  t one of the com
│ │ │ │ -0001a780: 706f 6e65 6e74 732c 206f 7220 7468 6520  ponents, or the 
│ │ │ │ -0001a790: 7265 616c 6d2c 204d 5553 5420 6265 2064  realm, MUST be d
│ │ │ │ -0001a7a0: 6966 6665 7265 6e74 292e 0a54 6865 2066  ifferent)..The f
│ │ │ │ -0001a7b0: 6f6c 6c6f 7769 6e67 206e 616d 6520 7479  ollowing name ty
│ │ │ │ -0001a7c0: 7065 7320 6172 6520 6465 6669 6e65 643a  pes are defined:
│ │ │ │ -0001a7d0: 0a0a 2020 2020 206e 616d 652d 7479 7065  ..     name-type
│ │ │ │ -0001a7e0: 2020 2020 2020 7661 6c75 6520 2020 6d65        value   me
│ │ │ │ -0001a7f0: 616e 696e 670a 0a20 2020 2020 4e54 2d55  aning..     NT-U
│ │ │ │ -0001a800: 4e4b 4e4f 574e 2020 2020 2020 2020 3020  NKNOWN        0 
│ │ │ │ -0001a810: 204e 616d 6520 7479 7065 206e 6f74 206b   Name type not k
│ │ │ │ -0001a820: 6e6f 776e 0a20 2020 2020 4e54 2d50 5249  nown.     NT-PRI
│ │ │ │ -0001a830: 4e43 4950 414c 2020 2020 2020 3120 204a  NCIPAL      1  J
│ │ │ │ -0001a840: 7573 7420 7468 6520 6e61 6d65 206f 6620  ust the name of 
│ │ │ │ -0001a850: 7468 6520 7072 696e 6369 7061 6c20 6173  the principal as
│ │ │ │ -0001a860: 2069 6e20 4443 452c 206f 7220 666f 7220   in DCE, or for 
│ │ │ │ -0001a870: 7573 6572 730a 2020 2020 204e 542d 5352  users.     NT-SR
│ │ │ │ -0001a880: 562d 494e 5354 2020 2020 2020 2032 2020  V-INST       2  
│ │ │ │ -0001a890: 5365 7276 6963 6520 616e 6420 6f74 6865  Service and othe
│ │ │ │ -0001a8a0: 7220 756e 6971 7565 2069 6e73 7461 6e63  r unique instanc
│ │ │ │ -0001a8b0: 6520 286b 7262 7467 7429 0a20 2020 2020  e (krbtgt).     
│ │ │ │ -0001a8c0: 4e54 2d53 5256 2d48 5354 2020 2020 2020  NT-SRV-HST      
│ │ │ │ -0001a8d0: 2020 3320 2053 6572 7669 6365 2077 6974    3  Service wit
│ │ │ │ -0001a8e0: 6820 686f 7374 206e 616d 6520 6173 2069  h host name as i
│ │ │ │ -0001a8f0: 6e73 7461 6e63 6520 2874 656c 6e65 742c  nstance (telnet,
│ │ │ │ -0001a900: 2072 636f 6d6d 616e 6473 290a 2020 2020   rcommands).    
│ │ │ │ -0001a910: 204e 542d 5352 562d 5848 5354 2020 2020   NT-SRV-XHST    
│ │ │ │ -0001a920: 2020 2034 2020 5365 7276 6963 6520 7769     4  Service wi
│ │ │ │ -0001a930: 7468 2068 6f73 7420 6173 2072 656d 6169  th host as remai
│ │ │ │ -0001a940: 6e69 6e67 2063 6f6d 706f 6e65 6e74 730a  ning components.
│ │ │ │ -0001a950: 2020 2020 204e 542d 5549 4420 2020 2020       NT-UID     
│ │ │ │ -0001a960: 2020 2020 2020 2035 2020 556e 6971 7565         5  Unique
│ │ │ │ -0001a970: 2049 440a 2020 2020 204e 542d 5835 3030   ID.     NT-X500
│ │ │ │ -0001a980: 2d50 5249 4e43 4950 414c 2036 2020 456e  -PRINCIPAL 6  En
│ │ │ │ -0001a990: 636f 6465 6420 582e 3530 3920 4469 7374  coded X.509 Dist
│ │ │ │ -0001a9a0: 696e 6769 7368 6564 206e 616d 6520 5b52  ingished name [R
│ │ │ │ -0001a9b0: 4643 2032 3235 335d 0a20 2020 2020 4e54  FC 2253].     NT
│ │ │ │ -0001a9c0: 2d53 4d54 502d 4e41 4d45 2020 2020 2020  -SMTP-NAME      
│ │ │ │ -0001a9d0: 3720 204e 616d 6520 696e 2066 6f72 6d20  7  Name in form 
│ │ │ │ -0001a9e0: 6f66 2053 4d54 5020 656d 6169 6c20 6e61  of SMTP email na
│ │ │ │ -0001a9f0: 6d65 2028 652e 672e 2075 7365 7240 666f  me (e.g. user@fo
│ │ │ │ -0001aa00: 6f2e 636f 6d29 0a20 2020 2020 4e54 2d45  o.com).     NT-E
│ │ │ │ -0001aa10: 4e54 4552 5052 4953 4520 2020 2031 3020  NTERPRISE    10 
│ │ │ │ -0001aa20: 2020 456e 7465 7270 7269 7365 206e 616d    Enterprise nam
│ │ │ │ -0001aa30: 6520 2d20 6d61 7920 6265 206d 6170 7065  e - may be mappe
│ │ │ │ -0001aa40: 6420 746f 2070 7269 6e63 6970 616c 206e  d to principal n
│ │ │ │ -0001aa50: 616d 650a 0a20 2020 5768 656e 2061 206e  ame..   When a n
│ │ │ │ -0001aa60: 616d 6520 696d 706c 6965 7320 6e6f 2069  ame implies no i
│ │ │ │ -0001aa70: 6e66 6f72 6d61 7469 6f6e 206f 7468 6572  nformation other
│ │ │ │ -0001aa80: 2074 6861 6e20 6974 7320 756e 6971 7565   than its unique
│ │ │ │ -0001aa90: 6e65 7373 2061 7420 610a 7061 7274 6963  ness at a.partic
│ │ │ │ -0001aaa0: 756c 6172 2074 696d 6520 7468 6520 6e61  ular time the na
│ │ │ │ -0001aab0: 6d65 2074 7970 6520 5052 494e 4349 5041  me type PRINCIPA
│ │ │ │ -0001aac0: 4c20 5348 4f55 4c44 2062 6520 7573 6564  L SHOULD be used
│ │ │ │ -0001aad0: 2e20 2054 6865 2070 7269 6e63 6970 616c  .  The principal
│ │ │ │ -0001aae0: 0a6e 616d 6520 7479 7065 2053 484f 554c  .name type SHOUL
│ │ │ │ -0001aaf0: 4420 6265 2075 7365 6420 666f 7220 7573  D be used for us
│ │ │ │ -0001ab00: 6572 732c 2061 6e64 2069 7420 6d69 6768  ers, and it migh
│ │ │ │ -0001ab10: 7420 616c 736f 2062 6520 7573 6564 2066  t also be used f
│ │ │ │ -0001ab20: 6f72 2061 0a75 6e69 7175 6520 7365 7276  or a.unique serv
│ │ │ │ -0001ab30: 6572 2e20 2049 6620 7468 6520 6e61 6d65  er.  If the name
│ │ │ │ -0001ab40: 2069 7320 6120 756e 6971 7565 206d 6163   is a unique mac
│ │ │ │ -0001ab50: 6869 6e65 2067 656e 6572 6174 6564 2049  hine generated I
│ │ │ │ -0001ab60: 4420 7468 6174 2069 730a 6775 6172 616e  D that is.guaran
│ │ │ │ -0001ab70: 7465 6564 206e 6576 6572 2074 6f20 6265  teed never to be
│ │ │ │ -0001ab80: 2072 6561 7373 6967 6e65 6420 7468 656e   reassigned then
│ │ │ │ -0001ab90: 2074 6865 206e 616d 6520 7479 7065 206f   the name type o
│ │ │ │ -0001aba0: 6620 5549 4420 5348 4f55 4c44 2062 650a  f UID SHOULD be.
│ │ │ │ -0001abb0: 7573 6564 2028 6e6f 7465 2074 6861 7420  used (note that 
│ │ │ │ -0001abc0: 6974 2069 7320 6765 6e65 7261 6c6c 7920  it is generally 
│ │ │ │ -0001abd0: 6120 6261 6420 6964 6561 2074 6f20 7265  a bad idea to re
│ │ │ │ -0001abe0: 6173 7369 676e 206e 616d 6573 206f 6620  assign names of 
│ │ │ │ -0001abf0: 616e 7920 7479 7065 0a73 696e 6365 2073  any type.since s
│ │ │ │ -0001ac00: 7461 6c65 2065 6e74 7269 6573 206d 6967  tale entries mig
│ │ │ │ -0001ac10: 6874 2072 656d 6169 6e20 696e 2061 6363  ht remain in acc
│ │ │ │ -0001ac20: 6573 7320 636f 6e74 726f 6c20 6c69 7374  ess control list
│ │ │ │ -0001ac30: 7329 2e0a 0a20 2020 4966 2074 6865 2066  s)...   If the f
│ │ │ │ -0001ac40: 6972 7374 2063 6f6d 706f 6e65 6e74 206f  irst component o
│ │ │ │ -0001ac50: 6620 6120 6e61 6d65 2069 6465 6e74 6966  f a name identif
│ │ │ │ -0001ac60: 6965 7320 6120 7365 7276 6963 6520 616e  ies a service an
│ │ │ │ -0001ac70: 6420 7468 650a 7265 6d61 696e 696e 6720  d the.remaining 
│ │ │ │ -0001ac80: 636f 6d70 6f6e 656e 7473 2069 6465 6e74  components ident
│ │ │ │ -0001ac90: 6966 7920 616e 2069 6e73 7461 6e63 6520  ify an instance 
│ │ │ │ -0001aca0: 6f66 2074 6865 2073 6572 7669 6365 2069  of the service i
│ │ │ │ -0001acb0: 6e20 6120 7365 7276 6572 0a73 7065 6369  n a server.speci
│ │ │ │ -0001acc0: 6669 6564 206d 616e 6e65 722c 2074 6865  fied manner, the
│ │ │ │ -0001acd0: 6e20 7468 6520 6e61 6d65 2074 7970 6520  n the name type 
│ │ │ │ -0001ace0: 6f66 2053 5256 2d49 4e53 5420 5348 4f55  of SRV-INST SHOU
│ │ │ │ -0001acf0: 4c44 2062 6520 7573 6564 2e20 2041 6e0a  LD be used.  An.
│ │ │ │ -0001ad00: 6578 616d 706c 6520 6f66 2074 6869 7320  example of this 
│ │ │ │ -0001ad10: 6e61 6d65 2074 7970 6520 6973 2074 6865  name type is the
│ │ │ │ -0001ad20: 204b 6572 6265 726f 7320 7469 636b 6574   Kerberos ticket
│ │ │ │ -0001ad30: 2d67 7261 6e74 696e 6720 7365 7276 6963  -granting servic
│ │ │ │ -0001ad40: 6520 7768 6f73 650a 6e61 6d65 2068 6173  e whose.name has
│ │ │ │ -0001ad50: 2061 2066 6972 7374 2063 6f6d 706f 6e65   a first compone
│ │ │ │ -0001ad60: 6e74 206f 6620 6b72 6274 6774 2061 6e64  nt of krbtgt and
│ │ │ │ -0001ad70: 2061 2073 6563 6f6e 6420 636f 6d70 6f6e   a second compon
│ │ │ │ -0001ad80: 656e 7420 6964 656e 7469 6679 696e 670a  ent identifying.
│ │ │ │ -0001ad90: 7468 6520 7265 616c 6d20 666f 7220 7768  the realm for wh
│ │ │ │ -0001ada0: 6963 6820 7468 6520 7469 636b 6574 2069  ich the ticket i
│ │ │ │ -0001adb0: 7320 7661 6c69 642e 0a0a 2020 2049 6620  s valid...   If 
│ │ │ │ -0001adc0: 7468 6520 6669 7273 7420 636f 6d70 6f6e  the first compon
│ │ │ │ -0001add0: 656e 7420 6f66 2061 206e 616d 6520 6964  ent of a name id
│ │ │ │ -0001ade0: 656e 7469 6669 6573 2061 2073 6572 7669  entifies a servi
│ │ │ │ -0001adf0: 6365 2061 6e64 2074 6865 7265 2069 7320  ce and there is 
│ │ │ │ -0001ae00: 610a 7369 6e67 6c65 2063 6f6d 706f 6e65  a.single compone
│ │ │ │ -0001ae10: 6e74 2066 6f6c 6c6f 7769 6e67 2074 6865  nt following the
│ │ │ │ -0001ae20: 2073 6572 7669 6365 206e 616d 6520 6964   service name id
│ │ │ │ -0001ae30: 656e 7469 6679 696e 6720 7468 6520 696e  entifying the in
│ │ │ │ -0001ae40: 7374 616e 6365 2061 730a 7468 6520 686f  stance as.the ho
│ │ │ │ -0001ae50: 7374 206f 6e20 7768 6963 6820 7468 6520  st on which the 
│ │ │ │ -0001ae60: 7365 7276 6572 2069 7320 7275 6e6e 696e  server is runnin
│ │ │ │ -0001ae70: 672c 2074 6865 6e20 7468 6520 6e61 6d65  g, then the name
│ │ │ │ -0001ae80: 2074 7970 6520 5352 562d 2048 5354 0a53   type SRV- HST.S
│ │ │ │ -0001ae90: 484f 554c 4420 6265 2075 7365 642e 2020  HOULD be used.  
│ │ │ │ -0001aea0: 5468 6973 2074 7970 6520 6973 2074 7970  This type is typ
│ │ │ │ -0001aeb0: 6963 616c 6c79 2075 7365 6420 666f 7220  ically used for 
│ │ │ │ -0001aec0: 496e 7465 726e 6574 2073 6572 7669 6365  Internet service
│ │ │ │ -0001aed0: 7320 7375 6368 0a61 7320 7465 6c6e 6574  s such.as telnet
│ │ │ │ -0001aee0: 2061 6e64 2074 6865 2042 6572 6b65 6c65   and the Berkele
│ │ │ │ -0001aef0: 7920 5220 636f 6d6d 616e 6473 2e20 2049  y R commands.  I
│ │ │ │ -0001af00: 6620 7468 6520 7365 7061 7261 7465 2063  f the separate c
│ │ │ │ -0001af10: 6f6d 706f 6e65 6e74 7320 6f66 0a74 6865  omponents of.the
│ │ │ │ -0001af20: 2068 6f73 7420 6e61 6d65 2061 7070 6561   host name appea
│ │ │ │ -0001af30: 7220 6173 2073 7563 6365 7373 6976 6520  r as successive 
│ │ │ │ -0001af40: 636f 6d70 6f6e 656e 7473 2066 6f6c 6c6f  components follo
│ │ │ │ -0001af50: 7769 6e67 2074 6865 206e 616d 6520 6f66  wing the name of
│ │ │ │ -0001af60: 2074 6865 0a73 6572 7669 6365 2c20 7468   the.service, th
│ │ │ │ -0001af70: 656e 2074 6865 206e 616d 6520 7479 7065  en the name type
│ │ │ │ -0001af80: 2053 5256 2d58 4853 5420 5348 4f55 4c44   SRV-XHST SHOULD
│ │ │ │ -0001af90: 2062 6520 7573 6564 2e20 2054 6869 7320   be used.  This 
│ │ │ │ -0001afa0: 7479 7065 206d 6967 6874 2062 650a 7573  type might be.us
│ │ │ │ -0001afb0: 6564 2074 6f20 6964 656e 7469 6679 2073  ed to identify s
│ │ │ │ -0001afc0: 6572 7665 7273 206f 6e20 686f 7374 7320  ervers on hosts 
│ │ │ │ -0001afd0: 7769 7468 2058 2e35 3030 206e 616d 6573  with X.500 names
│ │ │ │ -0001afe0: 2077 6865 7265 2074 6865 2073 6c61 7368   where the slash
│ │ │ │ -0001aff0: 2028 2f29 0a6d 6967 6874 206f 7468 6572   (/).might other
│ │ │ │ -0001b000: 7769 7365 2062 6520 616d 6269 6775 6f75  wise be ambiguou
│ │ │ │ -0001b010: 732e 0a0a 2020 2041 206e 616d 6520 7479  s...   A name ty
│ │ │ │ -0001b020: 7065 206f 6620 4e54 2d58 3530 302d 5052  pe of NT-X500-PR
│ │ │ │ -0001b030: 494e 4349 5041 4c20 5348 4f55 4c44 2062  INCIPAL SHOULD b
│ │ │ │ -0001b040: 6520 7573 6564 2077 6865 6e20 6120 6e61  e used when a na
│ │ │ │ -0001b050: 6d65 2066 726f 6d20 616e 0a58 2e35 3039  me from an.X.509
│ │ │ │ -0001b060: 2063 6572 7469 6669 6361 7465 2069 7320   certificate is 
│ │ │ │ -0001b070: 7472 616e 736c 6174 6564 2069 6e74 6f20  translated into 
│ │ │ │ -0001b080: 6120 4b65 7262 6572 6f73 206e 616d 652e  a Kerberos name.
│ │ │ │ -0001b090: 2020 5468 6520 656e 636f 6469 6e67 206f    The encoding o
│ │ │ │ -0001b0a0: 660a 7468 6520 582e 3530 3920 6e61 6d65  f.the X.509 name
│ │ │ │ -0001b0b0: 2061 7320 6120 4b65 7262 6572 6f73 2070   as a Kerberos p
│ │ │ │ -0001b0c0: 7269 6e63 6970 616c 2073 6861 6c6c 2063  rincipal shall c
│ │ │ │ -0001b0d0: 6f6e 666f 726d 2074 6f20 7468 6520 656e  onform to the en
│ │ │ │ -0001b0e0: 636f 6469 6e67 0a72 756c 6573 2073 7065  coding.rules spe
│ │ │ │ -0001b0f0: 6369 6669 6564 2069 6e20 5246 4320 3232  cified in RFC 22
│ │ │ │ -0001b100: 3533 2e0a 0a20 2020 4120 6e61 6d65 2074  53...   A name t
│ │ │ │ -0001b110: 7970 6520 6f66 2053 4d54 5020 616c 6c6f  ype of SMTP allo
│ │ │ │ -0001b120: 7773 2061 206e 616d 6520 746f 2062 6520  ws a name to be 
│ │ │ │ -0001b130: 6f66 2061 2066 6f72 6d20 7468 6174 2072  of a form that r
│ │ │ │ -0001b140: 6573 656d 626c 6573 2061 0a53 4d54 5020  esembles a.SMTP 
│ │ │ │ -0001b150: 656d 6169 6c20 6e61 6d65 2e20 2054 6869  email name.  Thi
│ │ │ │ -0001b160: 7320 6e61 6d65 2c20 696e 636c 7564 696e  s name, includin
│ │ │ │ -0001b170: 6720 616e 2022 4022 2061 6e64 2061 2064  g an "@" and a d
│ │ │ │ -0001b180: 6f6d 6169 6e20 6e61 6d65 2c20 6973 2075  omain name, is u
│ │ │ │ -0001b190: 7365 640a 6173 2074 6865 206f 6e65 2063  sed.as the one c
│ │ │ │ -0001b1a0: 6f6d 706f 6e65 6e74 206f 6620 7468 6520  omponent of the 
│ │ │ │ -0001b1b0: 7072 696e 6369 7061 6c20 6e61 6d65 2e0a  principal name..
│ │ │ │ -0001b1c0: 0a20 2020 4120 6e61 6d65 2074 7970 6520  .   A name type 
│ │ │ │ -0001b1d0: 6f66 2055 4e4b 4e4f 574e 2053 484f 554c  of UNKNOWN SHOUL
│ │ │ │ -0001b1e0: 4420 6265 2075 7365 6420 7768 656e 2074  D be used when t
│ │ │ │ -0001b1f0: 6865 2066 6f72 6d20 6f66 2074 6865 206e  he form of the n
│ │ │ │ -0001b200: 616d 6520 6973 0a6e 6f74 206b 6e6f 776e  ame is.not known
│ │ │ │ -0001b210: 2e20 2057 6865 6e20 636f 6d70 6172 696e  .  When comparin
│ │ │ │ -0001b220: 6720 6e61 6d65 732c 2061 206e 616d 6520  g names, a name 
│ │ │ │ -0001b230: 6f66 2074 7970 6520 554e 4b4e 4f57 4e20  of type UNKNOWN 
│ │ │ │ -0001b240: 7769 6c6c 206d 6174 6368 0a70 7269 6e63  will match.princ
│ │ │ │ -0001b250: 6970 616c 7320 6175 7468 656e 7469 6361  ipals authentica
│ │ │ │ -0001b260: 7465 6420 7769 7468 206e 616d 6573 206f  ted with names o
│ │ │ │ -0001b270: 6620 616e 7920 7479 7065 2e20 2041 2070  f any type.  A p
│ │ │ │ -0001b280: 7269 6e63 6970 616c 0a61 7574 6865 6e74  rincipal.authent
│ │ │ │ -0001b290: 6963 6174 6564 2077 6974 6820 6120 6e61  icated with a na
│ │ │ │ -0001b2a0: 6d65 206f 6620 7479 7065 2055 4e4b 4e4f  me of type UNKNO
│ │ │ │ -0001b2b0: 574e 2c20 686f 7765 7665 722c 2077 696c  WN, however, wil
│ │ │ │ -0001b2c0: 6c20 6f6e 6c79 206d 6174 6368 0a6f 7468  l only match.oth
│ │ │ │ -0001b2d0: 6572 206e 616d 6573 206f 6620 7479 7065  er names of type
│ │ │ │ -0001b2e0: 2055 4e4b 4e4f 574e 2e0a 0a20 2020 4e61   UNKNOWN...   Na
│ │ │ │ -0001b2f0: 6d65 7320 6f66 2061 6e79 2074 7970 6520  mes of any type 
│ │ │ │ -0001b300: 7769 7468 2061 6e20 696e 6974 6961 6c20  with an initial 
│ │ │ │ -0001b310: 636f 6d70 6f6e 656e 7420 6f66 2027 6b72  component of 'kr
│ │ │ │ -0001b320: 6274 6774 2720 6172 6520 7265 7365 7276  btgt' are reserv
│ │ │ │ -0001b330: 6564 0a66 6f72 2074 6865 204b 6572 6265  ed.for the Kerbe
│ │ │ │ -0001b340: 726f 7320 7469 636b 6574 2067 7261 6e74  ros ticket grant
│ │ │ │ -0001b350: 696e 6720 7365 7276 6963 652e 2020 2a4e  ing service.  *N
│ │ │ │ -0001b360: 6f74 6520 4e61 6d65 206f 6620 7468 6520  ote Name of the 
│ │ │ │ -0001b370: 5447 533a 0a6b 7262 7467 742c 2066 6f72  TGS:.krbtgt, for
│ │ │ │ -0001b380: 2074 6865 2066 6f72 6d20 6f66 2073 7563   the form of suc
│ │ │ │ -0001b390: 6820 6e61 6d65 732e 0a0a 342e 332e 322e  h names...4.3.2.
│ │ │ │ -0001b3a0: 3120 4e61 6d65 206f 6620 7365 7276 6572  1 Name of server
│ │ │ │ -0001b3b0: 2070 7269 6e63 6970 616c 730a 2e2e 2e2e   principals.....
│ │ │ │ +00017990: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a4b 6572  ===========..Ker
│ │ │ │ +000179a0: 6265 726f 7320 696d 706f 7365 7320 6120  beros imposes a 
│ │ │ │ +000179b0: 6665 7720 6173 7375 6d70 7469 6f6e 7320  few assumptions 
│ │ │ │ +000179c0: 6f6e 2074 6865 2065 6e76 6972 6f6e 6d65  on the environme
│ │ │ │ +000179d0: 6e74 2069 6e20 7768 6963 6820 6974 2063  nt in which it c
│ │ │ │ +000179e0: 616e 0a70 726f 7065 726c 7920 6675 6e63  an.properly func
│ │ │ │ +000179f0: 7469 6f6e 3a0a 0a20 2020 e280 a220 2244  tion:..   ... "D
│ │ │ │ +00017a00: 656e 6961 6c20 6f66 2073 6572 7669 6365  enial of service
│ │ │ │ +00017a10: 2220 6174 7461 636b 7320 6172 6520 6e6f  " attacks are no
│ │ │ │ +00017a20: 7420 736f 6c76 6564 2077 6974 6820 4b65  t solved with Ke
│ │ │ │ +00017a30: 7262 6572 6f73 2e20 2054 6865 7265 0a20  rberos.  There. 
│ │ │ │ +00017a40: 2020 2020 6172 6520 706c 6163 6573 2069      are places i
│ │ │ │ +00017a50: 6e20 7468 6520 7072 6f74 6f63 6f6c 7320  n the protocols 
│ │ │ │ +00017a60: 7768 6572 6520 616e 2069 6e74 7275 6465  where an intrude
│ │ │ │ +00017a70: 7220 6361 6e20 7072 6576 656e 7420 616e  r can prevent an
│ │ │ │ +00017a80: 0a20 2020 2020 6170 706c 6963 6174 696f  .     applicatio
│ │ │ │ +00017a90: 6e20 6672 6f6d 2070 6172 7469 6369 7061  n from participa
│ │ │ │ +00017aa0: 7469 6e67 2069 6e20 7468 6520 7072 6f70  ting in the prop
│ │ │ │ +00017ab0: 6572 2061 7574 6865 6e74 6963 6174 696f  er authenticatio
│ │ │ │ +00017ac0: 6e20 7374 6570 732e 0a20 2020 2020 4465  n steps..     De
│ │ │ │ +00017ad0: 7465 6374 696f 6e20 616e 6420 736f 6c75  tection and solu
│ │ │ │ +00017ae0: 7469 6f6e 206f 6620 7375 6368 2061 7474  tion of such att
│ │ │ │ +00017af0: 6163 6b73 2028 736f 6d65 206f 6620 7768  acks (some of wh
│ │ │ │ +00017b00: 6963 6820 6361 6e20 6170 7065 6172 2074  ich can appear t
│ │ │ │ +00017b10: 6f0a 2020 2020 2062 6520 6e6f 742d 756e  o.     be not-un
│ │ │ │ +00017b20: 636f 6d6d 6f6e 2022 6e6f 726d 616c 2220  common "normal" 
│ │ │ │ +00017b30: 6661 696c 7572 6520 6d6f 6465 7320 666f  failure modes fo
│ │ │ │ +00017b40: 7220 7468 6520 7379 7374 656d 2920 6973  r the system) is
│ │ │ │ +00017b50: 2075 7375 616c 6c79 0a20 2020 2020 6265   usually.     be
│ │ │ │ +00017b60: 7374 206c 6566 7420 746f 2074 6865 2068  st left to the h
│ │ │ │ +00017b70: 756d 616e 2061 646d 696e 6973 7472 6174  uman administrat
│ │ │ │ +00017b80: 6f72 7320 616e 6420 7573 6572 732e 0a20  ors and users.. 
│ │ │ │ +00017b90: 2020 e280 a220 5072 696e 6369 7061 6c73    ... Principals
│ │ │ │ +00017ba0: 204d 5553 5420 6b65 6570 2074 6865 6972   MUST keep their
│ │ │ │ +00017bb0: 2073 6563 7265 7420 6b65 7973 2073 6563   secret keys sec
│ │ │ │ +00017bc0: 7265 742e 2020 4966 2061 6e20 696e 7472  ret.  If an intr
│ │ │ │ +00017bd0: 7564 6572 0a20 2020 2020 736f 6d65 686f  uder.     someho
│ │ │ │ +00017be0: 7720 7374 6561 6c73 2061 2070 7269 6e63  w steals a princ
│ │ │ │ +00017bf0: 6970 616c 2773 206b 6579 2c20 6974 2077  ipal's key, it w
│ │ │ │ +00017c00: 696c 6c20 6265 2061 626c 6520 746f 206d  ill be able to m
│ │ │ │ +00017c10: 6173 7175 6572 6164 6520 6173 0a20 2020  asquerade as.   
│ │ │ │ +00017c20: 2020 7468 6174 2070 7269 6e63 6970 616c    that principal
│ │ │ │ +00017c30: 206f 7220 696d 7065 7273 6f6e 6174 6520   or impersonate 
│ │ │ │ +00017c40: 616e 7920 7365 7276 6572 2074 6f20 7468  any server to th
│ │ │ │ +00017c50: 6520 6c65 6769 7469 6d61 7465 0a20 2020  e legitimate.   
│ │ │ │ +00017c60: 2020 7072 696e 6369 7061 6c2e 0a20 2020    principal..   
│ │ │ │ +00017c70: e280 a220 2250 6173 7377 6f72 6420 6775  ... "Password gu
│ │ │ │ +00017c80: 6573 7369 6e67 2220 6174 7461 636b 7320  essing" attacks 
│ │ │ │ +00017c90: 6172 6520 6e6f 7420 736f 6c76 6564 2062  are not solved b
│ │ │ │ +00017ca0: 7920 4b65 7262 6572 6f73 2e20 2049 6620  y Kerberos.  If 
│ │ │ │ +00017cb0: 6120 7573 6572 0a20 2020 2020 6368 6f6f  a user.     choo
│ │ │ │ +00017cc0: 7365 7320 6120 706f 6f72 2070 6173 7377  ses a poor passw
│ │ │ │ +00017cd0: 6f72 642c 2069 7420 6973 2070 6f73 7369  ord, it is possi
│ │ │ │ +00017ce0: 626c 6520 666f 7220 616e 2061 7474 6163  ble for an attac
│ │ │ │ +00017cf0: 6b65 7220 746f 0a20 2020 2020 7375 6363  ker to.     succ
│ │ │ │ +00017d00: 6573 7366 756c 6c79 206d 6f75 6e74 2061  essfully mount a
│ │ │ │ +00017d10: 6e20 6f66 666c 696e 6520 6469 6374 696f  n offline dictio
│ │ │ │ +00017d20: 6e61 7279 2061 7474 6163 6b20 6279 2072  nary attack by r
│ │ │ │ +00017d30: 6570 6561 7465 646c 790a 2020 2020 2061  epeatedly.     a
│ │ │ │ +00017d40: 7474 656d 7074 696e 6720 746f 2064 6563  ttempting to dec
│ │ │ │ +00017d50: 7279 7074 2c20 7769 7468 2073 7563 6365  rypt, with succe
│ │ │ │ +00017d60: 7373 6976 6520 656e 7472 6965 7320 6672  ssive entries fr
│ │ │ │ +00017d70: 6f6d 2061 2064 6963 7469 6f6e 6172 792c  om a dictionary,
│ │ │ │ +00017d80: 0a20 2020 2020 6d65 7373 6167 6573 206f  .     messages o
│ │ │ │ +00017d90: 6274 6169 6e65 6420 7768 6963 6820 6172  btained which ar
│ │ │ │ +00017da0: 6520 656e 6372 7970 7465 6420 756e 6465  e encrypted unde
│ │ │ │ +00017db0: 7220 6120 6b65 7920 6465 7269 7665 6420  r a key derived 
│ │ │ │ +00017dc0: 6672 6f6d 2074 6865 0a20 2020 2020 7573  from the.     us
│ │ │ │ +00017dd0: 6572 2773 2070 6173 7377 6f72 642e 0a20  er's password.. 
│ │ │ │ +00017de0: 2020 e280 a220 4561 6368 2068 6f73 7420    ... Each host 
│ │ │ │ +00017df0: 6f6e 2074 6865 206e 6574 776f 726b 204d  on the network M
│ │ │ │ +00017e00: 5553 5420 6861 7665 2061 2063 6c6f 636b  UST have a clock
│ │ │ │ +00017e10: 2077 6869 6368 2069 7320 226c 6f6f 7365   which is "loose
│ │ │ │ +00017e20: 6c79 0a20 2020 2020 7379 6e63 6872 6f6e  ly.     synchron
│ │ │ │ +00017e30: 697a 6564 2220 746f 2074 6865 2074 696d  ized" to the tim
│ │ │ │ +00017e40: 6520 6f66 2074 6865 206f 7468 6572 2068  e of the other h
│ │ │ │ +00017e50: 6f73 7473 3b20 7468 6973 2073 796e 6368  osts; this synch
│ │ │ │ +00017e60: 726f 6e69 7a61 7469 6f6e 0a20 2020 2020  ronization.     
│ │ │ │ +00017e70: 6973 2075 7365 6420 746f 2072 6564 7563  is used to reduc
│ │ │ │ +00017e80: 6520 7468 6520 626f 6f6b 6b65 6570 696e  e the bookkeepin
│ │ │ │ +00017e90: 6720 6e65 6564 7320 6f66 2061 7070 6c69  g needs of appli
│ │ │ │ +00017ea0: 6361 7469 6f6e 2073 6572 7665 7273 2077  cation servers w
│ │ │ │ +00017eb0: 6865 6e0a 2020 2020 2074 6865 7920 646f  hen.     they do
│ │ │ │ +00017ec0: 2072 6570 6c61 7920 6465 7465 6374 696f   replay detectio
│ │ │ │ +00017ed0: 6e2e 2020 5468 6520 6465 6772 6565 206f  n.  The degree o
│ │ │ │ +00017ee0: 6620 226c 6f6f 7365 6e65 7373 2220 6361  f "looseness" ca
│ │ │ │ +00017ef0: 6e20 6265 0a20 2020 2020 636f 6e66 6967  n be.     config
│ │ │ │ +00017f00: 7572 6564 206f 6e20 6120 7065 722d 7365  ured on a per-se
│ │ │ │ +00017f10: 7276 6572 2062 6173 6973 2c20 6275 7420  rver basis, but 
│ │ │ │ +00017f20: 6973 2074 7970 6963 616c 6c79 206f 6e20  is typically on 
│ │ │ │ +00017f30: 7468 6520 6f72 6465 7220 6f66 0a20 2020  the order of.   
│ │ │ │ +00017f40: 2020 3520 6d69 6e75 7465 732e 2020 4966    5 minutes.  If
│ │ │ │ +00017f50: 2074 6865 2063 6c6f 636b 7320 6172 6520   the clocks are 
│ │ │ │ +00017f60: 7379 6e63 6872 6f6e 697a 6564 206f 7665  synchronized ove
│ │ │ │ +00017f70: 7220 7468 6520 6e65 7477 6f72 6b2c 2074  r the network, t
│ │ │ │ +00017f80: 6865 0a20 2020 2020 636c 6f63 6b20 7379  he.     clock sy
│ │ │ │ +00017f90: 6e63 6872 6f6e 697a 6174 696f 6e20 7072  nchronization pr
│ │ │ │ +00017fa0: 6f74 6f63 6f6c 204d 5553 5420 6974 7365  otocol MUST itse
│ │ │ │ +00017fb0: 6c66 2062 6520 7365 6375 7265 6420 6672  lf be secured fr
│ │ │ │ +00017fc0: 6f6d 206e 6574 776f 726b 0a20 2020 2020  om network.     
│ │ │ │ +00017fd0: 6174 7461 636b 6572 732e 0a20 2020 e280  attackers..   ..
│ │ │ │ +00017fe0: a220 5072 696e 6369 7061 6c20 6964 656e  . Principal iden
│ │ │ │ +00017ff0: 7469 6669 6572 7320 6172 6520 6e6f 7420  tifiers are not 
│ │ │ │ +00018000: 7265 6379 636c 6564 206f 6e20 6120 7368  recycled on a sh
│ │ │ │ +00018010: 6f72 742d 7465 726d 2062 6173 6973 2e20  ort-term basis. 
│ │ │ │ +00018020: 2041 0a20 2020 2020 7479 7069 6361 6c20   A.     typical 
│ │ │ │ +00018030: 6d6f 6465 206f 6620 6163 6365 7373 2063  mode of access c
│ │ │ │ +00018040: 6f6e 7472 6f6c 2077 696c 6c20 7573 6520  ontrol will use 
│ │ │ │ +00018050: 6163 6365 7373 2063 6f6e 7472 6f6c 206c  access control l
│ │ │ │ +00018060: 6973 7473 2028 4143 4c73 290a 2020 2020  ists (ACLs).    
│ │ │ │ +00018070: 2074 6f20 6772 616e 7420 7065 726d 6973   to grant permis
│ │ │ │ +00018080: 7369 6f6e 7320 746f 2070 6172 7469 6375  sions to particu
│ │ │ │ +00018090: 6c61 7220 7072 696e 6369 7061 6c73 2e20  lar principals. 
│ │ │ │ +000180a0: 2049 6620 6120 7374 616c 6520 4143 4c0a   If a stale ACL.
│ │ │ │ +000180b0: 2020 2020 2065 6e74 7279 2072 656d 6169       entry remai
│ │ │ │ +000180c0: 6e73 2066 6f72 2061 2064 656c 6574 6564  ns for a deleted
│ │ │ │ +000180d0: 2070 7269 6e63 6970 616c 2061 6e64 2074   principal and t
│ │ │ │ +000180e0: 6865 2070 7269 6e63 6970 616c 2069 6465  he principal ide
│ │ │ │ +000180f0: 6e74 6966 6965 720a 2020 2020 2069 7320  ntifier.     is 
│ │ │ │ +00018100: 7265 7573 6564 2c20 7468 6520 6e65 7720  reused, the new 
│ │ │ │ +00018110: 7072 696e 6369 7061 6c20 7769 6c6c 2069  principal will i
│ │ │ │ +00018120: 6e68 6572 6974 2072 6967 6874 7320 7370  nherit rights sp
│ │ │ │ +00018130: 6563 6966 6965 6420 696e 2074 6865 0a20  ecified in the. 
│ │ │ │ +00018140: 2020 2020 7374 616c 6520 4143 4c20 656e      stale ACL en
│ │ │ │ +00018150: 7472 792e 2020 4279 206e 6f74 2072 652d  try.  By not re-
│ │ │ │ +00018160: 7573 696e 6720 7072 696e 6369 7061 6c20  using principal 
│ │ │ │ +00018170: 6964 656e 7469 6669 6572 732c 2074 6865  identifiers, the
│ │ │ │ +00018180: 2064 616e 6765 720a 2020 2020 206f 6620   danger.     of 
│ │ │ │ +00018190: 696e 6164 7665 7274 656e 7420 6163 6365  inadvertent acce
│ │ │ │ +000181a0: 7373 2069 7320 7265 6d6f 7665 642e 0a0a  ss is removed...
│ │ │ │ +000181b0: 1f0a 4669 6c65 3a20 7368 6973 6869 2e69  ..File: shishi.i
│ │ │ │ +000181c0: 6e66 6f2c 2020 4e6f 6465 3a20 476c 6f73  nfo,  Node: Glos
│ │ │ │ +000181d0: 7361 7279 206f 6620 7465 726d 732c 2020  sary of terms,  
│ │ │ │ +000181e0: 4e65 7874 3a20 5265 616c 6d20 616e 6420  Next: Realm and 
│ │ │ │ +000181f0: 5072 696e 6369 7061 6c20 4e61 6d69 6e67  Principal Naming
│ │ │ │ +00018200: 2c20 2050 7265 763a 2045 6e76 6972 6f6e  ,  Prev: Environ
│ │ │ │ +00018210: 6d65 6e74 616c 2041 7373 756d 7074 696f  mental Assumptio
│ │ │ │ +00018220: 6e73 2c20 2055 703a 2052 6566 6572 656e  ns,  Up: Referen
│ │ │ │ +00018230: 6365 204d 616e 7561 6c0a 0a34 2e32 2047  ce Manual..4.2 G
│ │ │ │ +00018240: 6c6f 7373 6172 7920 6f66 2074 6572 6d73  lossary of terms
│ │ │ │ +00018250: 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  .===============
│ │ │ │ +00018260: 3d3d 3d3d 3d3d 0a0a 4175 7468 656e 7469  ======..Authenti
│ │ │ │ +00018270: 6361 7469 6f6e 0a20 2020 2020 5665 7269  cation.     Veri
│ │ │ │ +00018280: 6679 696e 6720 7468 6520 636c 6169 6d65  fying the claime
│ │ │ │ +00018290: 6420 6964 656e 7469 7479 206f 6620 6120  d identity of a 
│ │ │ │ +000182a0: 7072 696e 6369 7061 6c2e 0a0a 4175 7468  principal...Auth
│ │ │ │ +000182b0: 656e 7469 6361 7469 6f6e 2068 6561 6465  entication heade
│ │ │ │ +000182c0: 720a 2020 2020 2041 2072 6563 6f72 6420  r.     A record 
│ │ │ │ +000182d0: 636f 6e74 6169 6e69 6e67 2061 2054 6963  containing a Tic
│ │ │ │ +000182e0: 6b65 7420 616e 6420 616e 2041 7574 6865  ket and an Authe
│ │ │ │ +000182f0: 6e74 6963 6174 6f72 2074 6f20 6265 2070  nticator to be p
│ │ │ │ +00018300: 7265 7365 6e74 6564 0a20 2020 2020 746f  resented.     to
│ │ │ │ +00018310: 2061 2073 6572 7665 7220 6173 2070 6172   a server as par
│ │ │ │ +00018320: 7420 6f66 2074 6865 2061 7574 6865 6e74  t of the authent
│ │ │ │ +00018330: 6963 6174 696f 6e20 7072 6f63 6573 732e  ication process.
│ │ │ │ +00018340: 0a0a 4175 7468 656e 7469 6361 7469 6f6e  ..Authentication
│ │ │ │ +00018350: 2070 6174 680a 2020 2020 2041 2073 6571   path.     A seq
│ │ │ │ +00018360: 7565 6e63 6520 6f66 2069 6e74 6572 6d65  uence of interme
│ │ │ │ +00018370: 6469 6174 6520 7265 616c 6d73 2074 7261  diate realms tra
│ │ │ │ +00018380: 6e73 6974 6564 2069 6e20 7468 6520 6175  nsited in the au
│ │ │ │ +00018390: 7468 656e 7469 6361 7469 6f6e 0a20 2020  thentication.   
│ │ │ │ +000183a0: 2020 7072 6f63 6573 7320 7768 656e 2063    process when c
│ │ │ │ +000183b0: 6f6d 6d75 6e69 6361 7469 6e67 2066 726f  ommunicating fro
│ │ │ │ +000183c0: 6d20 6f6e 6520 7265 616c 6d20 746f 2061  m one realm to a
│ │ │ │ +000183d0: 6e6f 7468 6572 2e0a 0a41 7574 6865 6e74  nother...Authent
│ │ │ │ +000183e0: 6963 6174 6f72 0a20 2020 2020 4120 7265  icator.     A re
│ │ │ │ +000183f0: 636f 7264 2063 6f6e 7461 696e 696e 6720  cord containing 
│ │ │ │ +00018400: 696e 666f 726d 6174 696f 6e20 7468 6174  information that
│ │ │ │ +00018410: 2063 616e 2062 6520 7368 6f77 6e20 746f   can be shown to
│ │ │ │ +00018420: 2068 6176 6520 6265 656e 0a20 2020 2020   have been.     
│ │ │ │ +00018430: 7265 6365 6e74 6c79 2067 656e 6572 6174  recently generat
│ │ │ │ +00018440: 6564 2075 7369 6e67 2074 6865 2073 6573  ed using the ses
│ │ │ │ +00018450: 7369 6f6e 206b 6579 206b 6e6f 776e 206f  sion key known o
│ │ │ │ +00018460: 6e6c 7920 6279 2074 6865 2063 6c69 656e  nly by the clien
│ │ │ │ +00018470: 740a 2020 2020 2061 6e64 2073 6572 7665  t.     and serve
│ │ │ │ +00018480: 722e 0a0a 4175 7468 6f72 697a 6174 696f  r...Authorizatio
│ │ │ │ +00018490: 6e0a 2020 2020 2054 6865 2070 726f 6365  n.     The proce
│ │ │ │ +000184a0: 7373 206f 6620 6465 7465 726d 696e 696e  ss of determinin
│ │ │ │ +000184b0: 6720 7768 6574 6865 7220 6120 636c 6965  g whether a clie
│ │ │ │ +000184c0: 6e74 206d 6179 2075 7365 2061 2073 6572  nt may use a ser
│ │ │ │ +000184d0: 7669 6365 2c0a 2020 2020 2077 6869 6368  vice,.     which
│ │ │ │ +000184e0: 206f 626a 6563 7473 2074 6865 2063 6c69   objects the cli
│ │ │ │ +000184f0: 656e 7420 6973 2061 6c6c 6f77 6564 2074  ent is allowed t
│ │ │ │ +00018500: 6f20 6163 6365 7373 2c20 616e 6420 7468  o access, and th
│ │ │ │ +00018510: 6520 7479 7065 206f 660a 2020 2020 2061  e type of.     a
│ │ │ │ +00018520: 6363 6573 7320 616c 6c6f 7765 6420 666f  ccess allowed fo
│ │ │ │ +00018530: 7220 6561 6368 2e0a 0a43 6170 6162 696c  r each...Capabil
│ │ │ │ +00018540: 6974 790a 2020 2020 2041 2074 6f6b 656e  ity.     A token
│ │ │ │ +00018550: 2074 6861 7420 6772 616e 7473 2074 6865   that grants the
│ │ │ │ +00018560: 2062 6561 7265 7220 7065 726d 6973 7369   bearer permissi
│ │ │ │ +00018570: 6f6e 2074 6f20 6163 6365 7373 2061 6e20  on to access an 
│ │ │ │ +00018580: 6f62 6a65 6374 206f 720a 2020 2020 2073  object or.     s
│ │ │ │ +00018590: 6572 7669 6365 2e20 2049 6e20 4b65 7262  ervice.  In Kerb
│ │ │ │ +000185a0: 6572 6f73 2c20 7468 6973 206d 6967 6874  eros, this might
│ │ │ │ +000185b0: 2062 6520 6120 7469 636b 6574 2077 686f   be a ticket who
│ │ │ │ +000185c0: 7365 2075 7365 2069 730a 2020 2020 2072  se use is.     r
│ │ │ │ +000185d0: 6573 7472 6963 7465 6420 6279 2074 6865  estricted by the
│ │ │ │ +000185e0: 2063 6f6e 7465 6e74 7320 6f66 2074 6865   contents of the
│ │ │ │ +000185f0: 2061 7574 686f 7269 7a61 7469 6f6e 2064   authorization d
│ │ │ │ +00018600: 6174 6120 6669 656c 642c 2062 7574 0a20  ata field, but. 
│ │ │ │ +00018610: 2020 2020 7768 6963 6820 6c69 7374 7320      which lists 
│ │ │ │ +00018620: 6e6f 206e 6574 776f 726b 2061 6464 7265  no network addre
│ │ │ │ +00018630: 7373 6573 2c20 746f 6765 7468 6572 2077  sses, together w
│ │ │ │ +00018640: 6974 6820 7468 6520 7365 7373 696f 6e20  ith the session 
│ │ │ │ +00018650: 6b65 790a 2020 2020 206e 6563 6573 7361  key.     necessa
│ │ │ │ +00018660: 7279 2074 6f20 7573 6520 7468 6520 7469  ry to use the ti
│ │ │ │ +00018670: 636b 6574 2e0a 0a43 6970 6865 7274 6578  cket...Ciphertex
│ │ │ │ +00018680: 740a 2020 2020 2054 6865 206f 7574 7075  t.     The outpu
│ │ │ │ +00018690: 7420 6f66 2061 6e20 656e 6372 7970 7469  t of an encrypti
│ │ │ │ +000186a0: 6f6e 2066 756e 6374 696f 6e2e 2020 456e  on function.  En
│ │ │ │ +000186b0: 6372 7970 7469 6f6e 2074 7261 6e73 666f  cryption transfo
│ │ │ │ +000186c0: 726d 730a 2020 2020 2070 6c61 696e 7465  rms.     plainte
│ │ │ │ +000186d0: 7874 2069 6e74 6f20 6369 7068 6572 7465  xt into cipherte
│ │ │ │ +000186e0: 7874 2e0a 0a43 6c69 656e 740a 2020 2020  xt...Client.    
│ │ │ │ +000186f0: 2041 2070 726f 6365 7373 2074 6861 7420   A process that 
│ │ │ │ +00018700: 6d61 6b65 7320 7573 6520 6f66 2061 206e  makes use of a n
│ │ │ │ +00018710: 6574 776f 726b 2073 6572 7669 6365 206f  etwork service o
│ │ │ │ +00018720: 6e20 6265 6861 6c66 206f 6620 6120 7573  n behalf of a us
│ │ │ │ +00018730: 6572 2e0a 2020 2020 204e 6f74 6520 7468  er..     Note th
│ │ │ │ +00018740: 6174 2069 6e20 736f 6d65 2063 6173 6573  at in some cases
│ │ │ │ +00018750: 2061 2053 6572 7665 7220 6d61 7920 6974   a Server may it
│ │ │ │ +00018760: 7365 6c66 2062 6520 6120 636c 6965 6e74  self be a client
│ │ │ │ +00018770: 206f 6620 736f 6d65 0a20 2020 2020 6f74   of some.     ot
│ │ │ │ +00018780: 6865 7220 7365 7276 6572 2028 652e 672e  her server (e.g.
│ │ │ │ +00018790: 2020 6120 7072 696e 7420 7365 7276 6572    a print server
│ │ │ │ +000187a0: 206d 6179 2062 6520 6120 636c 6965 6e74   may be a client
│ │ │ │ +000187b0: 206f 6620 6120 6669 6c65 0a20 2020 2020   of a file.     
│ │ │ │ +000187c0: 7365 7276 6572 292e 0a0a 4372 6564 656e  server)...Creden
│ │ │ │ +000187d0: 7469 616c 730a 2020 2020 2041 2074 6963  tials.     A tic
│ │ │ │ +000187e0: 6b65 7420 706c 7573 2074 6865 2073 6563  ket plus the sec
│ │ │ │ +000187f0: 7265 7420 7365 7373 696f 6e20 6b65 7920  ret session key 
│ │ │ │ +00018800: 6e65 6365 7373 6172 7920 746f 2073 7563  necessary to suc
│ │ │ │ +00018810: 6365 7373 6675 6c6c 7920 7573 650a 2020  cessfully use.  
│ │ │ │ +00018820: 2020 2074 6861 7420 7469 636b 6574 2069     that ticket i
│ │ │ │ +00018830: 6e20 616e 2061 7574 6865 6e74 6963 6174  n an authenticat
│ │ │ │ +00018840: 696f 6e20 6578 6368 616e 6765 2e0a 0a45  ion exchange...E
│ │ │ │ +00018850: 6e63 7279 7074 696f 6e20 5479 7065 2028  ncryption Type (
│ │ │ │ +00018860: 6574 7970 6529 0a20 2020 2020 5768 656e  etype).     When
│ │ │ │ +00018870: 2061 7373 6f63 6961 7465 6420 7769 7468   associated with
│ │ │ │ +00018880: 2065 6e63 7279 7074 6564 2064 6174 612c   encrypted data,
│ │ │ │ +00018890: 2061 6e20 656e 6372 7970 7469 6f6e 2074   an encryption t
│ │ │ │ +000188a0: 7970 6520 6964 656e 7469 6669 6573 0a20  ype identifies. 
│ │ │ │ +000188b0: 2020 2020 7468 6520 616c 676f 7269 7468      the algorith
│ │ │ │ +000188c0: 6d20 7573 6564 2074 6f20 656e 6372 7970  m used to encryp
│ │ │ │ +000188d0: 7420 7468 6520 6461 7461 2061 6e64 2069  t the data and i
│ │ │ │ +000188e0: 7320 7573 6564 2074 6f20 7365 6c65 6374  s used to select
│ │ │ │ +000188f0: 2074 6865 0a20 2020 2020 6170 7072 6f70   the.     approp
│ │ │ │ +00018900: 7269 6174 6520 616c 676f 7269 7468 6d20  riate algorithm 
│ │ │ │ +00018910: 666f 7220 6465 6372 7970 7469 6e67 2074  for decrypting t
│ │ │ │ +00018920: 6865 2064 6174 612e 2020 456e 6372 7970  he data.  Encryp
│ │ │ │ +00018930: 7469 6f6e 2074 7970 650a 2020 2020 2074  tion type.     t
│ │ │ │ +00018940: 6167 7320 6172 6520 636f 6d6d 756e 6963  ags are communic
│ │ │ │ +00018950: 6174 6564 2069 6e20 6f74 6865 7220 6d65  ated in other me
│ │ │ │ +00018960: 7373 6167 6573 2074 6f20 656e 756d 6572  ssages to enumer
│ │ │ │ +00018970: 6174 6520 616c 676f 7269 7468 6d73 0a20  ate algorithms. 
│ │ │ │ +00018980: 2020 2020 7468 6174 2061 7265 2064 6573      that are des
│ │ │ │ +00018990: 6972 6564 2c20 7375 7070 6f72 7465 642c  ired, supported,
│ │ │ │ +000189a0: 2070 7265 6665 7272 6564 2c20 6f72 2061   preferred, or a
│ │ │ │ +000189b0: 6c6c 6f77 6564 2074 6f20 6265 2075 7365  llowed to be use
│ │ │ │ +000189c0: 6420 666f 720a 2020 2020 2065 6e63 7279  d for.     encry
│ │ │ │ +000189d0: 7074 696f 6e20 6f66 2064 6174 6120 6265  ption of data be
│ │ │ │ +000189e0: 7477 6565 6e20 7061 7274 6965 732e 2020  tween parties.  
│ │ │ │ +000189f0: 5468 6973 2070 7265 6665 7265 6e63 6520  This preference 
│ │ │ │ +00018a00: 6973 2063 6f6d 6269 6e65 640a 2020 2020  is combined.    
│ │ │ │ +00018a10: 2077 6974 6820 6c6f 6361 6c20 696e 666f   with local info
│ │ │ │ +00018a20: 726d 6174 696f 6e20 616e 6420 706f 6c69  rmation and poli
│ │ │ │ +00018a30: 6379 2074 6f20 7365 6c65 6374 2061 6e20  cy to select an 
│ │ │ │ +00018a40: 616c 676f 7269 7468 6d20 746f 2062 650a  algorithm to be.
│ │ │ │ +00018a50: 2020 2020 2075 7365 642e 0a0a 4b44 430a       used...KDC.
│ │ │ │ +00018a60: 2020 2020 204b 6579 2044 6973 7472 6962       Key Distrib
│ │ │ │ +00018a70: 7574 696f 6e20 4365 6e74 6572 2c20 6120  ution Center, a 
│ │ │ │ +00018a80: 6e65 7477 6f72 6b20 7365 7276 6963 6520  network service 
│ │ │ │ +00018a90: 7468 6174 2073 7570 706c 6965 7320 7469  that supplies ti
│ │ │ │ +00018aa0: 636b 6574 730a 2020 2020 2061 6e64 2074  ckets.     and t
│ │ │ │ +00018ab0: 656d 706f 7261 7279 2073 6573 7369 6f6e  emporary session
│ │ │ │ +00018ac0: 206b 6579 733b 206f 7220 616e 2069 6e73   keys; or an ins
│ │ │ │ +00018ad0: 7461 6e63 6520 6f66 2074 6861 7420 7365  tance of that se
│ │ │ │ +00018ae0: 7276 6963 6520 6f72 2074 6865 0a20 2020  rvice or the.   
│ │ │ │ +00018af0: 2020 686f 7374 206f 6e20 7768 6963 6820    host on which 
│ │ │ │ +00018b00: 6974 2072 756e 732e 2020 5468 6520 4b44  it runs.  The KD
│ │ │ │ +00018b10: 4320 7365 7276 6963 6573 2062 6f74 6820  C services both 
│ │ │ │ +00018b20: 696e 6974 6961 6c20 7469 636b 6574 2061  initial ticket a
│ │ │ │ +00018b30: 6e64 0a20 2020 2020 7469 636b 6574 2d67  nd.     ticket-g
│ │ │ │ +00018b40: 7261 6e74 696e 6720 7469 636b 6574 2072  ranting ticket r
│ │ │ │ +00018b50: 6571 7565 7374 732e 2020 5468 6520 696e  equests.  The in
│ │ │ │ +00018b60: 6974 6961 6c20 7469 636b 6574 2070 6f72  itial ticket por
│ │ │ │ +00018b70: 7469 6f6e 2069 730a 2020 2020 2073 6f6d  tion is.     som
│ │ │ │ +00018b80: 6574 696d 6573 2072 6566 6572 7265 6420  etimes referred 
│ │ │ │ +00018b90: 746f 2061 7320 7468 6520 4175 7468 656e  to as the Authen
│ │ │ │ +00018ba0: 7469 6361 7469 6f6e 2053 6572 7665 7220  tication Server 
│ │ │ │ +00018bb0: 286f 7220 7365 7276 6963 6529 2e0a 2020  (or service)..  
│ │ │ │ +00018bc0: 2020 2054 6865 2074 6963 6b65 742d 6772     The ticket-gr
│ │ │ │ +00018bd0: 616e 7469 6e67 2074 6963 6b65 7420 706f  anting ticket po
│ │ │ │ +00018be0: 7274 696f 6e20 6973 2073 6f6d 6574 696d  rtion is sometim
│ │ │ │ +00018bf0: 6573 2072 6566 6572 7265 6420 746f 2061  es referred to a
│ │ │ │ +00018c00: 7320 7468 650a 2020 2020 2074 6963 6b65  s the.     ticke
│ │ │ │ +00018c10: 742d 6772 616e 7469 6e67 2073 6572 7665  t-granting serve
│ │ │ │ +00018c20: 7220 286f 7220 7365 7276 6963 6529 2e0a  r (or service)..
│ │ │ │ +00018c30: 0a4b 6572 6265 726f 730a 2020 2020 2054  .Kerberos.     T
│ │ │ │ +00018c40: 6865 206e 616d 6520 6769 7665 6e20 746f  he name given to
│ │ │ │ +00018c50: 2074 6865 2050 726f 6a65 6374 2041 7468   the Project Ath
│ │ │ │ +00018c60: 656e 6127 7320 6175 7468 656e 7469 6361  ena's authentica
│ │ │ │ +00018c70: 7469 6f6e 2073 6572 7669 6365 2c20 7468  tion service, th
│ │ │ │ +00018c80: 650a 2020 2020 2070 726f 746f 636f 6c20  e.     protocol 
│ │ │ │ +00018c90: 7573 6564 2062 7920 7468 6174 2073 6572  used by that ser
│ │ │ │ +00018ca0: 7669 6365 2c20 6f72 2074 6865 2063 6f64  vice, or the cod
│ │ │ │ +00018cb0: 6520 7573 6564 2074 6f20 696d 706c 656d  e used to implem
│ │ │ │ +00018cc0: 656e 7420 7468 650a 2020 2020 2061 7574  ent the.     aut
│ │ │ │ +00018cd0: 6865 6e74 6963 6174 696f 6e20 7365 7276  hentication serv
│ │ │ │ +00018ce0: 6963 652e 2020 5468 6520 6e61 6d65 2069  ice.  The name i
│ │ │ │ +00018cf0: 7320 6164 6f70 7465 6420 6672 6f6d 2074  s adopted from t
│ │ │ │ +00018d00: 6865 2074 6872 6565 2d68 6561 6465 640a  he three-headed.
│ │ │ │ +00018d10: 2020 2020 2064 6f67 2077 6869 6368 2067       dog which g
│ │ │ │ +00018d20: 7561 7264 7320 4861 6465 732e 0a0a 4b65  uards Hades...Ke
│ │ │ │ +00018d30: 7920 5665 7273 696f 6e20 4e75 6d62 6572  y Version Number
│ │ │ │ +00018d40: 2028 6b76 6e6f 290a 2020 2020 2041 2074   (kvno).     A t
│ │ │ │ +00018d50: 6167 2061 7373 6f63 6961 7465 6420 7769  ag associated wi
│ │ │ │ +00018d60: 7468 2065 6e63 7279 7074 6564 2064 6174  th encrypted dat
│ │ │ │ +00018d70: 6120 6964 656e 7469 6669 6573 2077 6869  a identifies whi
│ │ │ │ +00018d80: 6368 206b 6579 2077 6173 2075 7365 640a  ch key was used.
│ │ │ │ +00018d90: 2020 2020 2066 6f72 2065 6e63 7279 7074       for encrypt
│ │ │ │ +00018da0: 696f 6e20 7768 656e 2061 206c 6f6e 6720  ion when a long 
│ │ │ │ +00018db0: 6c69 7665 6420 6b65 7920 6173 736f 6369  lived key associ
│ │ │ │ +00018dc0: 6174 6564 2077 6974 6820 6120 7072 696e  ated with a prin
│ │ │ │ +00018dd0: 6369 7061 6c0a 2020 2020 2063 6861 6e67  cipal.     chang
│ │ │ │ +00018de0: 6573 206f 7665 7220 7469 6d65 2e20 2049  es over time.  I
│ │ │ │ +00018df0: 7420 6973 2075 7365 6420 6475 7269 6e67  t is used during
│ │ │ │ +00018e00: 2074 6865 2074 7261 6e73 6974 696f 6e20   the transition 
│ │ │ │ +00018e10: 746f 2061 206e 6577 206b 6579 0a20 2020  to a new key.   
│ │ │ │ +00018e20: 2020 736f 2074 6861 7420 7468 6520 7061    so that the pa
│ │ │ │ +00018e30: 7274 7920 6465 6372 7970 7469 6e67 2061  rty decrypting a
│ │ │ │ +00018e40: 206d 6573 7361 6765 2063 616e 2074 656c   message can tel
│ │ │ │ +00018e50: 6c20 7768 6574 6865 7220 7468 6520 6461  l whether the da
│ │ │ │ +00018e60: 7461 0a20 2020 2020 7761 7320 656e 6372  ta.     was encr
│ │ │ │ +00018e70: 7970 7465 6420 7573 696e 6720 7468 6520  ypted using the 
│ │ │ │ +00018e80: 6f6c 6420 6f72 2074 6865 206e 6577 206b  old or the new k
│ │ │ │ +00018e90: 6579 2e0a 0a50 6c61 696e 7465 7874 0a20  ey...Plaintext. 
│ │ │ │ +00018ea0: 2020 2020 5468 6520 696e 7075 7420 746f      The input to
│ │ │ │ +00018eb0: 2061 6e20 656e 6372 7970 7469 6f6e 2066   an encryption f
│ │ │ │ +00018ec0: 756e 6374 696f 6e20 6f72 2074 6865 206f  unction or the o
│ │ │ │ +00018ed0: 7574 7075 7420 6f66 2061 2064 6563 7279  utput of a decry
│ │ │ │ +00018ee0: 7074 696f 6e0a 2020 2020 2066 756e 6374  ption.     funct
│ │ │ │ +00018ef0: 696f 6e2e 2020 4465 6372 7970 7469 6f6e  ion.  Decryption
│ │ │ │ +00018f00: 2074 7261 6e73 666f 726d 7320 6369 7068   transforms ciph
│ │ │ │ +00018f10: 6572 7465 7874 2069 6e74 6f20 706c 6169  ertext into plai
│ │ │ │ +00018f20: 6e74 6578 742e 0a0a 5072 696e 6369 7061  ntext...Principa
│ │ │ │ +00018f30: 6c0a 2020 2020 2041 206e 616d 6564 2063  l.     A named c
│ │ │ │ +00018f40: 6c69 656e 7420 6f72 2073 6572 7665 7220  lient or server 
│ │ │ │ +00018f50: 656e 7469 7479 2074 6861 7420 7061 7274  entity that part
│ │ │ │ +00018f60: 6963 6970 6174 6573 2069 6e20 6120 6e65  icipates in a ne
│ │ │ │ +00018f70: 7477 6f72 6b0a 2020 2020 2063 6f6d 6d75  twork.     commu
│ │ │ │ +00018f80: 6e69 6361 7469 6f6e 2c20 7769 7468 206f  nication, with o
│ │ │ │ +00018f90: 6e65 206e 616d 6520 7468 6174 2069 7320  ne name that is 
│ │ │ │ +00018fa0: 636f 6e73 6964 6572 6564 2063 616e 6f6e  considered canon
│ │ │ │ +00018fb0: 6963 616c 2e0a 0a50 7269 6e63 6970 616c  ical...Principal
│ │ │ │ +00018fc0: 2069 6465 6e74 6966 6965 720a 2020 2020   identifier.    
│ │ │ │ +00018fd0: 2054 6865 2063 616e 6f6e 6963 616c 206e   The canonical n
│ │ │ │ +00018fe0: 616d 6520 7573 6564 2074 6f20 756e 6971  ame used to uniq
│ │ │ │ +00018ff0: 7565 6c79 2069 6465 6e74 6966 7920 6561  uely identify ea
│ │ │ │ +00019000: 6368 2064 6966 6665 7265 6e74 0a20 2020  ch different.   
│ │ │ │ +00019010: 2020 7072 696e 6369 7061 6c2e 0a0a 5365    principal...Se
│ │ │ │ +00019020: 616c 0a20 2020 2020 546f 2065 6e63 6970  al.     To encip
│ │ │ │ +00019030: 6865 7220 6120 7265 636f 7264 2063 6f6e  her a record con
│ │ │ │ +00019040: 7461 696e 696e 6720 7365 7665 7261 6c20  taining several 
│ │ │ │ +00019050: 6669 656c 6473 2069 6e20 7375 6368 2061  fields in such a
│ │ │ │ +00019060: 2077 6179 2074 6861 740a 2020 2020 2074   way that.     t
│ │ │ │ +00019070: 6865 2066 6965 6c64 7320 6361 6e6e 6f74  he fields cannot
│ │ │ │ +00019080: 2062 6520 696e 6469 7669 6475 616c 6c79   be individually
│ │ │ │ +00019090: 2072 6570 6c61 6365 6420 7769 7468 6f75   replaced withou
│ │ │ │ +000190a0: 7420 6569 7468 6572 206b 6e6f 776c 6564  t either knowled
│ │ │ │ +000190b0: 6765 0a20 2020 2020 6f66 2074 6865 2065  ge.     of the e
│ │ │ │ +000190c0: 6e63 7279 7074 696f 6e20 6b65 7920 6f72  ncryption key or
│ │ │ │ +000190d0: 206c 6561 7669 6e67 2065 7669 6465 6e63   leaving evidenc
│ │ │ │ +000190e0: 6520 6f66 2074 616d 7065 7269 6e67 2e0a  e of tampering..
│ │ │ │ +000190f0: 0a53 6563 7265 7420 6b65 790a 2020 2020  .Secret key.    
│ │ │ │ +00019100: 2041 6e20 656e 6372 7970 7469 6f6e 206b   An encryption k
│ │ │ │ +00019110: 6579 2073 6861 7265 6420 6279 2061 2070  ey shared by a p
│ │ │ │ +00019120: 7269 6e63 6970 616c 2061 6e64 2074 6865  rincipal and the
│ │ │ │ +00019130: 204b 4443 2c20 6469 7374 7269 6275 7465   KDC, distribute
│ │ │ │ +00019140: 640a 2020 2020 206f 7574 7369 6465 2074  d.     outside t
│ │ │ │ +00019150: 6865 2062 6f75 6e64 7320 6f66 2074 6865  he bounds of the
│ │ │ │ +00019160: 2073 7973 7465 6d2c 2077 6974 6820 6120   system, with a 
│ │ │ │ +00019170: 6c6f 6e67 206c 6966 6574 696d 652e 2020  long lifetime.  
│ │ │ │ +00019180: 496e 2074 6865 0a20 2020 2020 6361 7365  In the.     case
│ │ │ │ +00019190: 206f 6620 6120 6875 6d61 6e20 7573 6572   of a human user
│ │ │ │ +000191a0: 2773 2070 7269 6e63 6970 616c 2c20 7468  's principal, th
│ │ │ │ +000191b0: 6520 7365 6372 6574 206b 6579 204d 4159  e secret key MAY
│ │ │ │ +000191c0: 2062 6520 6465 7269 7665 640a 2020 2020   be derived.    
│ │ │ │ +000191d0: 2066 726f 6d20 6120 7061 7373 776f 7264   from a password
│ │ │ │ +000191e0: 2e0a 0a53 6572 7665 720a 2020 2020 2041  ...Server.     A
│ │ │ │ +000191f0: 2070 6172 7469 6375 6c61 7220 5072 696e   particular Prin
│ │ │ │ +00019200: 6369 7061 6c20 7768 6963 6820 7072 6f76  cipal which prov
│ │ │ │ +00019210: 6964 6573 2061 2072 6573 6f75 7263 6520  ides a resource 
│ │ │ │ +00019220: 746f 206e 6574 776f 726b 0a20 2020 2020  to network.     
│ │ │ │ +00019230: 636c 6965 6e74 732e 2020 5468 6520 7365  clients.  The se
│ │ │ │ +00019240: 7276 6572 2069 7320 736f 6d65 7469 6d65  rver is sometime
│ │ │ │ +00019250: 7320 7265 6665 7272 6564 2074 6f20 6173  s referred to as
│ │ │ │ +00019260: 2074 6865 2041 7070 6c69 6361 7469 6f6e   the Application
│ │ │ │ +00019270: 0a20 2020 2020 5365 7276 6572 2e0a 0a53  .     Server...S
│ │ │ │ +00019280: 6572 7669 6365 0a20 2020 2020 4120 7265  ervice.     A re
│ │ │ │ +00019290: 736f 7572 6365 2070 726f 7669 6465 6420  source provided 
│ │ │ │ +000192a0: 746f 206e 6574 776f 726b 2063 6c69 656e  to network clien
│ │ │ │ +000192b0: 7473 3b20 6f66 7465 6e20 7072 6f76 6964  ts; often provid
│ │ │ │ +000192c0: 6564 2062 7920 6d6f 7265 2074 6861 6e0a  ed by more than.
│ │ │ │ +000192d0: 2020 2020 206f 6e65 2073 6572 7665 7220       one server 
│ │ │ │ +000192e0: 2866 6f72 2065 7861 6d70 6c65 2c20 7265  (for example, re
│ │ │ │ +000192f0: 6d6f 7465 2066 696c 6520 7365 7276 6963  mote file servic
│ │ │ │ +00019300: 6529 2e0a 0a53 6573 7369 6f6e 206b 6579  e)...Session key
│ │ │ │ +00019310: 0a20 2020 2020 4120 7465 6d70 6f72 6172  .     A temporar
│ │ │ │ +00019320: 7920 656e 6372 7970 7469 6f6e 206b 6579  y encryption key
│ │ │ │ +00019330: 2075 7365 6420 6265 7477 6565 6e20 7477   used between tw
│ │ │ │ +00019340: 6f20 7072 696e 6369 7061 6c73 2c20 7769  o principals, wi
│ │ │ │ +00019350: 7468 2061 0a20 2020 2020 6c69 6665 7469  th a.     lifeti
│ │ │ │ +00019360: 6d65 206c 696d 6974 6564 2074 6f20 7468  me limited to th
│ │ │ │ +00019370: 6520 6475 7261 7469 6f6e 206f 6620 6120  e duration of a 
│ │ │ │ +00019380: 7369 6e67 6c65 206c 6f67 696e 2022 7365  single login "se
│ │ │ │ +00019390: 7373 696f 6e22 2e20 2049 6e0a 2020 2020  ssion".  In.    
│ │ │ │ +000193a0: 2074 6865 204b 6572 6265 726f 7320 7379   the Kerberos sy
│ │ │ │ +000193b0: 7374 656d 2c20 6120 7365 7373 696f 6e20  stem, a session 
│ │ │ │ +000193c0: 6b65 7920 6973 2067 656e 6572 6174 6564  key is generated
│ │ │ │ +000193d0: 2062 7920 7468 6520 4b44 432e 2054 6865   by the KDC. The
│ │ │ │ +000193e0: 0a20 2020 2020 7365 7373 696f 6e20 6b65  .     session ke
│ │ │ │ +000193f0: 7920 6973 2064 6973 7469 6e63 7420 6672  y is distinct fr
│ │ │ │ +00019400: 6f6d 2074 6865 2073 7562 2d73 6573 7369  om the sub-sessi
│ │ │ │ +00019410: 6f6e 206b 6579 2c20 6465 7363 7269 6265  on key, describe
│ │ │ │ +00019420: 6420 6e65 7874 2e2e 0a0a 5375 622d 7365  d next....Sub-se
│ │ │ │ +00019430: 7373 696f 6e20 6b65 790a 2020 2020 2041  ssion key.     A
│ │ │ │ +00019440: 2074 656d 706f 7261 7279 2065 6e63 7279   temporary encry
│ │ │ │ +00019450: 7074 696f 6e20 6b65 7920 7573 6564 2062  ption key used b
│ │ │ │ +00019460: 6574 7765 656e 2074 776f 2070 7269 6e63  etween two princ
│ │ │ │ +00019470: 6970 616c 732c 2073 656c 6563 7465 640a  ipals, selected.
│ │ │ │ +00019480: 2020 2020 2061 6e64 2065 7863 6861 6e67       and exchang
│ │ │ │ +00019490: 6564 2062 7920 7468 6520 7072 696e 6369  ed by the princi
│ │ │ │ +000194a0: 7061 6c73 2075 7369 6e67 2074 6865 2073  pals using the s
│ │ │ │ +000194b0: 6573 7369 6f6e 206b 6579 2c20 616e 6420  ession key, and 
│ │ │ │ +000194c0: 7769 7468 2061 0a20 2020 2020 6c69 6665  with a.     life
│ │ │ │ +000194d0: 7469 6d65 206c 696d 6974 6564 2074 6f20  time limited to 
│ │ │ │ +000194e0: 7468 6520 6475 7261 7469 6f6e 206f 6620  the duration of 
│ │ │ │ +000194f0: 6120 7369 6e67 6c65 2061 7373 6f63 6961  a single associa
│ │ │ │ +00019500: 7469 6f6e 2e20 2054 6865 2073 7562 2d0a  tion.  The sub-.
│ │ │ │ +00019510: 2020 2020 2073 6573 7369 6f6e 206b 6579       session key
│ │ │ │ +00019520: 2069 7320 616c 736f 2072 6566 6572 7265   is also referre
│ │ │ │ +00019530: 6420 746f 2061 7320 7468 6520 7375 626b  d to as the subk
│ │ │ │ +00019540: 6579 2e0a 0a54 6963 6b65 740a 2020 2020  ey...Ticket.    
│ │ │ │ +00019550: 2041 2072 6563 6f72 6420 7468 6174 2068   A record that h
│ │ │ │ +00019560: 656c 7073 2061 2063 6c69 656e 7420 6175  elps a client au
│ │ │ │ +00019570: 7468 656e 7469 6361 7465 2069 7473 656c  thenticate itsel
│ │ │ │ +00019580: 6620 746f 2061 2073 6572 7665 723b 2069  f to a server; i
│ │ │ │ +00019590: 740a 2020 2020 2063 6f6e 7461 696e 7320  t.     contains 
│ │ │ │ +000195a0: 7468 6520 636c 6965 6e74 2773 2069 6465  the client's ide
│ │ │ │ +000195b0: 6e74 6974 792c 2061 2073 6573 7369 6f6e  ntity, a session
│ │ │ │ +000195c0: 206b 6579 2c20 6120 7469 6d65 7374 616d   key, a timestam
│ │ │ │ +000195d0: 702c 2061 6e64 0a20 2020 2020 6f74 6865  p, and.     othe
│ │ │ │ +000195e0: 7220 696e 666f 726d 6174 696f 6e2c 2061  r information, a
│ │ │ │ +000195f0: 6c6c 2073 6561 6c65 6420 7573 696e 6720  ll sealed using 
│ │ │ │ +00019600: 7468 6520 7365 7276 6572 2773 2073 6563  the server's sec
│ │ │ │ +00019610: 7265 7420 6b65 792e 2020 4974 0a20 2020  ret key.  It.   
│ │ │ │ +00019620: 2020 6f6e 6c79 2073 6572 7665 7320 746f    only serves to
│ │ │ │ +00019630: 2061 7574 6865 6e74 6963 6174 6520 6120   authenticate a 
│ │ │ │ +00019640: 636c 6965 6e74 2077 6865 6e20 7072 6573  client when pres
│ │ │ │ +00019650: 656e 7465 6420 616c 6f6e 6720 7769 7468  ented along with
│ │ │ │ +00019660: 2061 0a20 2020 2020 6672 6573 6820 4175   a.     fresh Au
│ │ │ │ +00019670: 7468 656e 7469 6361 746f 722e 0a0a 1f0a  thenticator.....
│ │ │ │ +00019680: 4669 6c65 3a20 7368 6973 6869 2e69 6e66  File: shishi.inf
│ │ │ │ +00019690: 6f2c 2020 4e6f 6465 3a20 5265 616c 6d20  o,  Node: Realm 
│ │ │ │ +000196a0: 616e 6420 5072 696e 6369 7061 6c20 4e61  and Principal Na
│ │ │ │ +000196b0: 6d69 6e67 2c20 204e 6578 743a 2053 6869  ming,  Next: Shi
│ │ │ │ +000196c0: 7368 6920 436f 6e66 6967 7572 6174 696f  shi Configuratio
│ │ │ │ +000196d0: 6e2c 2020 5072 6576 3a20 476c 6f73 7361  n,  Prev: Glossa
│ │ │ │ +000196e0: 7279 206f 6620 7465 726d 732c 2020 5570  ry of terms,  Up
│ │ │ │ +000196f0: 3a20 5265 6665 7265 6e63 6520 4d61 6e75  : Reference Manu
│ │ │ │ +00019700: 616c 0a0a 342e 3320 5265 616c 6d20 616e  al..4.3 Realm an
│ │ │ │ +00019710: 6420 5072 696e 6369 7061 6c20 4e61 6d69  d Principal Nami
│ │ │ │ +00019720: 6e67 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ng.=============
│ │ │ │ +00019730: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ +00019740: 3d0a 0a54 6869 7320 7365 6374 696f 6e20  =..This section 
│ │ │ │ +00019750: 636f 6e74 6169 6e73 2074 6865 2064 6973  contains the dis
│ │ │ │ +00019760: 6375 7373 696f 6e20 6f6e 206e 616d 696e  cussion on namin
│ │ │ │ +00019770: 6720 7265 616c 6d73 2061 6e64 2070 7269  g realms and pri
│ │ │ │ +00019780: 6e63 6970 616c 730a 6672 6f6d 2074 6865  ncipals.from the
│ │ │ │ +00019790: 204b 6572 6265 726f 7320 7370 6563 6966   Kerberos specif
│ │ │ │ +000197a0: 6963 6174 696f 6e2e 0a0a 342e 332e 3120  ication...4.3.1 
│ │ │ │ +000197b0: 5265 616c 6d20 4e61 6d65 730a 2d2d 2d2d  Realm Names.----
│ │ │ │ +000197c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a41  -------------..A
│ │ │ │ +000197d0: 6c74 686f 7567 6820 7265 616c 6d20 6e61  lthough realm na
│ │ │ │ +000197e0: 6d65 7320 6172 6520 656e 636f 6465 6420  mes are encoded 
│ │ │ │ +000197f0: 6173 2047 656e 6572 616c 5374 7269 6e67  as GeneralString
│ │ │ │ +00019800: 7320 616e 6420 616c 7468 6f75 6768 2061  s and although a
│ │ │ │ +00019810: 2072 6561 6c6d 0a63 616e 2074 6563 686e   realm.can techn
│ │ │ │ +00019820: 6963 616c 6c79 2073 656c 6563 7420 616e  ically select an
│ │ │ │ +00019830: 7920 6e61 6d65 2069 7420 6368 6f6f 7365  y name it choose
│ │ │ │ +00019840: 732c 2069 6e74 6572 6f70 6572 6162 696c  s, interoperabil
│ │ │ │ +00019850: 6974 7920 6163 726f 7373 0a72 6561 6c6d  ity across.realm
│ │ │ │ +00019860: 2062 6f75 6e64 6172 6965 7320 7265 7175   boundaries requ
│ │ │ │ +00019870: 6972 6573 2061 6772 6565 6d65 6e74 206f  ires agreement o
│ │ │ │ +00019880: 6e20 686f 7720 7265 616c 6d20 6e61 6d65  n how realm name
│ │ │ │ +00019890: 7320 6172 6520 746f 2062 650a 6173 7369  s are to be.assi
│ │ │ │ +000198a0: 676e 6564 2c20 616e 6420 7768 6174 2069  gned, and what i
│ │ │ │ +000198b0: 6e66 6f72 6d61 7469 6f6e 2074 6865 7920  nformation they 
│ │ │ │ +000198c0: 696d 706c 792e 0a0a 2020 2054 6f20 656e  imply...   To en
│ │ │ │ +000198d0: 666f 7263 6520 7468 6573 6520 636f 6e76  force these conv
│ │ │ │ +000198e0: 656e 7469 6f6e 732c 2065 6163 6820 7265  entions, each re
│ │ │ │ +000198f0: 616c 6d20 4d55 5354 2063 6f6e 666f 726d  alm MUST conform
│ │ │ │ +00019900: 2074 6f20 7468 650a 636f 6e76 656e 7469   to the.conventi
│ │ │ │ +00019910: 6f6e 7320 6974 7365 6c66 2c20 616e 6420  ons itself, and 
│ │ │ │ +00019920: 6974 204d 5553 5420 7265 7175 6972 6520  it MUST require 
│ │ │ │ +00019930: 7468 6174 2061 6e79 2072 6561 6c6d 7320  that any realms 
│ │ │ │ +00019940: 7769 7468 2077 6869 6368 0a69 6e74 6572  with which.inter
│ │ │ │ +00019950: 2d72 6561 6c6d 206b 6579 7320 6172 6520  -realm keys are 
│ │ │ │ +00019960: 7368 6172 6564 2061 6c73 6f20 636f 6e66  shared also conf
│ │ │ │ +00019970: 6f72 6d20 746f 2074 6865 2063 6f6e 7665  orm to the conve
│ │ │ │ +00019980: 6e74 696f 6e73 2061 6e64 2072 6571 7569  ntions and requi
│ │ │ │ +00019990: 7265 0a74 6865 2073 616d 6520 6672 6f6d  re.the same from
│ │ │ │ +000199a0: 2069 7473 206e 6569 6768 626f 7273 2e0a   its neighbors..
│ │ │ │ +000199b0: 0a20 2020 4b65 7262 6572 6f73 2072 6561  .   Kerberos rea
│ │ │ │ +000199c0: 6c6d 206e 616d 6573 2061 7265 2063 6173  lm names are cas
│ │ │ │ +000199d0: 6520 7365 6e73 6974 6976 652e 2020 5265  e sensitive.  Re
│ │ │ │ +000199e0: 616c 6d20 6e61 6d65 7320 7468 6174 2064  alm names that d
│ │ │ │ +000199f0: 6966 6665 720a 6f6e 6c79 2069 6e20 7468  iffer.only in th
│ │ │ │ +00019a00: 6520 6361 7365 206f 6620 7468 6520 6368  e case of the ch
│ │ │ │ +00019a10: 6172 6163 7465 7273 2061 7265 206e 6f74  aracters are not
│ │ │ │ +00019a20: 2065 7175 6976 616c 656e 742e 2020 5468   equivalent.  Th
│ │ │ │ +00019a30: 6572 6520 6172 650a 7072 6573 656e 746c  ere are.presentl
│ │ │ │ +00019a40: 7920 7468 7265 6520 7374 796c 6573 206f  y three styles o
│ │ │ │ +00019a50: 6620 7265 616c 6d20 6e61 6d65 733a 2064  f realm names: d
│ │ │ │ +00019a60: 6f6d 6169 6e2c 2058 3530 302c 2061 6e64  omain, X500, and
│ │ │ │ +00019a70: 206f 7468 6572 2e0a 4578 616d 706c 6573   other..Examples
│ │ │ │ +00019a80: 206f 6620 6561 6368 2073 7479 6c65 2066   of each style f
│ │ │ │ +00019a90: 6f6c 6c6f 773a 0a0a 2020 2020 2020 2020  ollow:..        
│ │ │ │ +00019aa0: 2020 646f 6d61 696e 3a20 2020 4154 4845    domain:   ATHE
│ │ │ │ +00019ab0: 4e41 2e4d 4954 2e45 4455 0a20 2020 2020  NA.MIT.EDU.     
│ │ │ │ +00019ac0: 2020 2020 2020 2058 3530 303a 2020 2043         X500:   C
│ │ │ │ +00019ad0: 3d55 532f 4f3d 4f53 460a 2020 2020 2020  =US/O=OSF.      
│ │ │ │ +00019ae0: 2020 2020 206f 7468 6572 3a20 2020 4e41       other:   NA
│ │ │ │ +00019af0: 4d45 5459 5045 3a72 6573 742f 6f66 2e6e  METYPE:rest/of.n
│ │ │ │ +00019b00: 616d 653d 7769 7468 6f75 742d 7265 7374  ame=without-rest
│ │ │ │ +00019b10: 7269 6374 696f 6e73 0a0a 2020 2044 6f6d  rictions..   Dom
│ │ │ │ +00019b20: 6169 6e20 7379 6c65 2072 6561 6c6d 206e  ain syle realm n
│ │ │ │ +00019b30: 616d 6573 204d 5553 5420 6c6f 6f6b 206c  ames MUST look l
│ │ │ │ +00019b40: 696b 6520 646f 6d61 696e 206e 616d 6573  ike domain names
│ │ │ │ +00019b50: 3a20 7468 6579 2063 6f6e 7369 7374 206f  : they consist o
│ │ │ │ +00019b60: 660a 636f 6d70 6f6e 656e 7473 2073 6570  f.components sep
│ │ │ │ +00019b70: 6172 6174 6564 2062 7920 7065 7269 6f64  arated by period
│ │ │ │ +00019b80: 7320 282e 2920 2061 6e64 2074 6865 7920  s (.)  and they 
│ │ │ │ +00019b90: 636f 6e74 6169 6e20 6e65 6974 6865 7220  contain neither 
│ │ │ │ +00019ba0: 636f 6c6f 6e73 2028 3a29 0a6e 6f72 2073  colons (:).nor s
│ │ │ │ +00019bb0: 6c61 7368 6573 2028 2f29 2e20 2054 686f  lashes (/).  Tho
│ │ │ │ +00019bc0: 7567 6820 646f 6d61 696e 206e 616d 6573  ugh domain names
│ │ │ │ +00019bd0: 2074 6865 6d73 656c 7665 7320 6172 6520   themselves are 
│ │ │ │ +00019be0: 6361 7365 2069 6e73 656e 7369 7469 7665  case insensitive
│ │ │ │ +00019bf0: 2c0a 696e 206f 7264 6572 2066 6f72 2072  ,.in order for r
│ │ │ │ +00019c00: 6561 6c6d 7320 746f 206d 6174 6368 2c20  ealms to match, 
│ │ │ │ +00019c10: 7468 6520 6361 7365 206d 7573 7420 6d61  the case must ma
│ │ │ │ +00019c20: 7463 6820 6173 2077 656c 6c2e 2020 5768  tch as well.  Wh
│ │ │ │ +00019c30: 656e 0a65 7374 6162 6c69 7368 696e 6720  en.establishing 
│ │ │ │ +00019c40: 6120 6e65 7720 7265 616c 6d20 6e61 6d65  a new realm name
│ │ │ │ +00019c50: 2062 6173 6564 206f 6e20 616e 2069 6e74   based on an int
│ │ │ │ +00019c60: 6572 6e65 7420 646f 6d61 696e 206e 616d  ernet domain nam
│ │ │ │ +00019c70: 6520 6974 2069 730a 7265 636f 6d6d 656e  e it is.recommen
│ │ │ │ +00019c80: 6465 6420 6279 2063 6f6e 7665 6e74 696f  ded by conventio
│ │ │ │ +00019c90: 6e20 7468 6174 2074 6865 2063 6861 7261  n that the chara
│ │ │ │ +00019ca0: 6374 6572 7320 6265 2063 6f6e 7665 7274  cters be convert
│ │ │ │ +00019cb0: 6564 2074 6f20 7570 7065 720a 6361 7365  ed to upper.case
│ │ │ │ +00019cc0: 2e0a 0a20 2020 582e 3530 3020 6e61 6d65  ...   X.500 name
│ │ │ │ +00019cd0: 7320 636f 6e74 6169 6e20 616e 2065 7175  s contain an equ
│ │ │ │ +00019ce0: 616c 2028 3d29 2061 6e64 2063 616e 6e6f  al (=) and canno
│ │ │ │ +00019cf0: 7420 636f 6e74 6169 6e20 6120 636f 6c6f  t contain a colo
│ │ │ │ +00019d00: 6e20 283a 290a 6265 666f 7265 2074 6865  n (:).before the
│ │ │ │ +00019d10: 2065 7175 616c 2e20 2054 6865 2072 6561   equal.  The rea
│ │ │ │ +00019d20: 6c6d 206e 616d 6573 2066 6f72 2058 2e35  lm names for X.5
│ │ │ │ +00019d30: 3030 206e 616d 6573 2077 696c 6c20 6265  00 names will be
│ │ │ │ +00019d40: 2073 7472 696e 670a 7265 7072 6573 656e   string.represen
│ │ │ │ +00019d50: 7461 7469 6f6e 7320 6f66 2074 6865 206e  tations of the n
│ │ │ │ +00019d60: 616d 6573 2077 6974 6820 636f 6d70 6f6e  ames with compon
│ │ │ │ +00019d70: 656e 7473 2073 6570 6172 6174 6564 2062  ents separated b
│ │ │ │ +00019d80: 7920 736c 6173 6865 732e 0a4c 6561 6469  y slashes..Leadi
│ │ │ │ +00019d90: 6e67 2061 6e64 2074 7261 696c 696e 6720  ng and trailing 
│ │ │ │ +00019da0: 736c 6173 6865 7320 7769 6c6c 206e 6f74  slashes will not
│ │ │ │ +00019db0: 2062 6520 696e 636c 7564 6564 2e20 204e   be included.  N
│ │ │ │ +00019dc0: 6f74 6520 7468 6174 2074 6865 2073 6c61  ote that the sla
│ │ │ │ +00019dd0: 7368 0a73 6570 6172 6174 6f72 2069 7320  sh.separator is 
│ │ │ │ +00019de0: 636f 6e73 6973 7465 6e74 2077 6974 6820  consistent with 
│ │ │ │ +00019df0: 4b65 7262 6572 6f73 2069 6d70 6c65 6d65  Kerberos impleme
│ │ │ │ +00019e00: 6e74 6174 696f 6e73 2062 6173 6564 206f  ntations based o
│ │ │ │ +00019e10: 6e20 5246 4331 3531 302c 0a62 7574 2069  n RFC1510,.but i
│ │ │ │ +00019e20: 7420 6973 2064 6966 6665 7265 6e74 2066  t is different f
│ │ │ │ +00019e30: 726f 6d20 7468 6520 7365 7061 7261 746f  rom the separato
│ │ │ │ +00019e40: 7220 7265 636f 6d6d 656e 6465 6420 696e  r recommended in
│ │ │ │ +00019e50: 2052 4643 3232 3533 2e0a 0a20 2020 4e61   RFC2253...   Na
│ │ │ │ +00019e60: 6d65 7320 7468 6174 2066 616c 6c20 696e  mes that fall in
│ │ │ │ +00019e70: 746f 2074 6865 206f 7468 6572 2063 6174  to the other cat
│ │ │ │ +00019e80: 6567 6f72 7920 4d55 5354 2062 6567 696e  egory MUST begin
│ │ │ │ +00019e90: 2077 6974 6820 6120 7072 6566 6978 2074   with a prefix t
│ │ │ │ +00019ea0: 6861 740a 636f 6e74 6169 6e73 206e 6f20  hat.contains no 
│ │ │ │ +00019eb0: 6571 7561 6c20 283d 2920 6f72 2070 6572  equal (=) or per
│ │ │ │ +00019ec0: 696f 6420 282e 2920 2061 6e64 2074 6865  iod (.)  and the
│ │ │ │ +00019ed0: 2070 7265 6669 7820 4d55 5354 2062 6520   prefix MUST be 
│ │ │ │ +00019ee0: 666f 6c6c 6f77 6564 2062 790a 6120 636f  followed by.a co
│ │ │ │ +00019ef0: 6c6f 6e20 283a 2920 616e 6420 7468 6520  lon (:) and the 
│ │ │ │ +00019f00: 7265 7374 206f 6620 7468 6520 6e61 6d65  rest of the name
│ │ │ │ +00019f10: 2e20 2041 6c6c 2070 7265 6669 7865 7320  .  All prefixes 
│ │ │ │ +00019f20: 6d75 7374 2062 6520 6173 7369 676e 6564  must be assigned
│ │ │ │ +00019f30: 0a62 6566 6f72 6520 7468 6579 206d 6179  .before they may
│ │ │ │ +00019f40: 2062 6520 7573 6564 2e20 2050 7265 7365   be used.  Prese
│ │ │ │ +00019f50: 6e74 6c79 206e 6f6e 6520 6172 6520 6173  ntly none are as
│ │ │ │ +00019f60: 7369 676e 6564 2e0a 0a20 2020 5468 6520  signed...   The 
│ │ │ │ +00019f70: 7265 7365 7276 6564 2063 6174 6567 6f72  reserved categor
│ │ │ │ +00019f80: 7920 696e 636c 7564 6573 2073 7472 696e  y includes strin
│ │ │ │ +00019f90: 6773 2077 6869 6368 2064 6f20 6e6f 7420  gs which do not 
│ │ │ │ +00019fa0: 6661 6c6c 2069 6e74 6f20 7468 650a 6669  fall into the.fi
│ │ │ │ +00019fb0: 7273 7420 7468 7265 6520 6361 7465 676f  rst three catego
│ │ │ │ +00019fc0: 7269 6573 2e20 2041 6c6c 206e 616d 6573  ries.  All names
│ │ │ │ +00019fd0: 2069 6e20 7468 6973 2063 6174 6567 6f72   in this categor
│ │ │ │ +00019fe0: 7920 6172 6520 7265 7365 7276 6564 2e20  y are reserved. 
│ │ │ │ +00019ff0: 2049 7420 6973 0a75 6e6c 696b 656c 7920   It is.unlikely 
│ │ │ │ +0001a000: 7468 6174 206e 616d 6573 2077 696c 6c20  that names will 
│ │ │ │ +0001a010: 6265 2061 7373 6967 6e65 6420 746f 2074  be assigned to t
│ │ │ │ +0001a020: 6869 7320 6361 7465 676f 7279 2075 6e6c  his category unl
│ │ │ │ +0001a030: 6573 7320 7468 6572 6520 6973 2061 0a76  ess there is a.v
│ │ │ │ +0001a040: 6572 7920 7374 726f 6e67 2061 7267 756d  ery strong argum
│ │ │ │ +0001a050: 656e 7420 666f 7220 6e6f 7420 7573 696e  ent for not usin
│ │ │ │ +0001a060: 6720 7468 6520 276f 7468 6572 2720 6361  g the 'other' ca
│ │ │ │ +0001a070: 7465 676f 7279 2e0a 0a20 2020 5468 6573  tegory...   Thes
│ │ │ │ +0001a080: 6520 7275 6c65 7320 6775 6172 616e 7465  e rules guarante
│ │ │ │ +0001a090: 6520 7468 6174 2074 6865 7265 2077 696c  e that there wil
│ │ │ │ +0001a0a0: 6c20 6265 206e 6f20 636f 6e66 6c69 6374  l be no conflict
│ │ │ │ +0001a0b0: 7320 6265 7477 6565 6e20 7468 650a 7661  s between the.va
│ │ │ │ +0001a0c0: 7269 6f75 7320 6e61 6d65 2073 7479 6c65  rious name style
│ │ │ │ +0001a0d0: 732e 2020 5468 6520 666f 6c6c 6f77 696e  s.  The followin
│ │ │ │ +0001a0e0: 6720 6164 6469 7469 6f6e 616c 2063 6f6e  g additional con
│ │ │ │ +0001a0f0: 7374 7261 696e 7473 2061 7070 6c79 2074  straints apply t
│ │ │ │ +0001a100: 6f20 7468 650a 6173 7369 676e 6d65 6e74  o the.assignment
│ │ │ │ +0001a110: 206f 6620 7265 616c 6d20 6e61 6d65 7320   of realm names 
│ │ │ │ +0001a120: 696e 2074 6865 2064 6f6d 6169 6e20 616e  in the domain an
│ │ │ │ +0001a130: 6420 582e 3530 3020 6361 7465 676f 7269  d X.500 categori
│ │ │ │ +0001a140: 6573 3a20 7468 6520 6e61 6d65 0a6f 6620  es: the name.of 
│ │ │ │ +0001a150: 6120 7265 616c 6d20 666f 7220 7468 6520  a realm for the 
│ │ │ │ +0001a160: 646f 6d61 696e 206f 7220 582e 3530 3020  domain or X.500 
│ │ │ │ +0001a170: 666f 726d 6174 7320 6d75 7374 2065 6974  formats must eit
│ │ │ │ +0001a180: 6865 7220 6265 2075 7365 6420 6279 2074  her be used by t
│ │ │ │ +0001a190: 6865 0a6f 7267 616e 697a 6174 696f 6e20  he.organization 
│ │ │ │ +0001a1a0: 6f77 6e69 6e67 2028 746f 2077 686f 6d20  owning (to whom 
│ │ │ │ +0001a1b0: 6974 2077 6173 2061 7373 6967 6e65 6429  it was assigned)
│ │ │ │ +0001a1c0: 2061 6e20 496e 7465 726e 6574 2064 6f6d   an Internet dom
│ │ │ │ +0001a1d0: 6169 6e20 6e61 6d65 206f 720a 582e 3530  ain name or.X.50
│ │ │ │ +0001a1e0: 3020 6e61 6d65 2c20 6f72 2069 6e20 7468  0 name, or in th
│ │ │ │ +0001a1f0: 6520 6361 7365 2074 6861 7420 6e6f 2073  e case that no s
│ │ │ │ +0001a200: 7563 6820 6e61 6d65 7320 6172 6520 7265  uch names are re
│ │ │ │ +0001a210: 6769 7374 6572 6564 2c20 6175 7468 6f72  gistered, author
│ │ │ │ +0001a220: 6974 790a 746f 2075 7365 2061 2072 6561  ity.to use a rea
│ │ │ │ +0001a230: 6c6d 206e 616d 6520 4d41 5920 6265 2064  lm name MAY be d
│ │ │ │ +0001a240: 6572 6976 6564 2066 726f 6d20 7468 6520  erived from the 
│ │ │ │ +0001a250: 6175 7468 6f72 6974 7920 6f66 2074 6865  authority of the
│ │ │ │ +0001a260: 2070 6172 656e 740a 7265 616c 6d2e 2020   parent.realm.  
│ │ │ │ +0001a270: 466f 7220 6578 616d 706c 652c 2069 6620  For example, if 
│ │ │ │ +0001a280: 7468 6572 6520 6973 206e 6f20 646f 6d61  there is no doma
│ │ │ │ +0001a290: 696e 206e 616d 6520 666f 7220 4534 302e  in name for E40.
│ │ │ │ +0001a2a0: 4d49 542e 4544 552c 2074 6865 6e0a 7468  MIT.EDU, then.th
│ │ │ │ +0001a2b0: 6520 6164 6d69 6e69 7374 7261 746f 7220  e administrator 
│ │ │ │ +0001a2c0: 6f66 2074 6865 204d 4954 2e45 4455 2072  of the MIT.EDU r
│ │ │ │ +0001a2d0: 6561 6c6d 2063 616e 2061 7574 686f 7269  ealm can authori
│ │ │ │ +0001a2e0: 7a65 2074 6865 2063 7265 6174 696f 6e20  ze the creation 
│ │ │ │ +0001a2f0: 6f66 2061 0a72 6561 6c6d 2077 6974 6820  of a.realm with 
│ │ │ │ +0001a300: 7468 6174 206e 616d 652e 0a0a 2020 2054  that name...   T
│ │ │ │ +0001a310: 6869 7320 6973 2061 6363 6570 7461 626c  his is acceptabl
│ │ │ │ +0001a320: 6520 6265 6361 7573 6520 7468 6520 6f72  e because the or
│ │ │ │ +0001a330: 6761 6e69 7a61 7469 6f6e 2074 6f20 7768  ganization to wh
│ │ │ │ +0001a340: 6963 6820 7468 6520 7061 7265 6e74 2069  ich the parent i
│ │ │ │ +0001a350: 730a 6173 7369 676e 6564 2069 7320 7072  s.assigned is pr
│ │ │ │ +0001a360: 6573 756d 6162 6c79 2074 6865 206f 7267  esumably the org
│ │ │ │ +0001a370: 616e 697a 6174 696f 6e20 6175 7468 6f72  anization author
│ │ │ │ +0001a380: 697a 6564 2074 6f20 6173 7369 676e 206e  ized to assign n
│ │ │ │ +0001a390: 616d 6573 2074 6f0a 6974 7320 6368 696c  ames to.its chil
│ │ │ │ +0001a3a0: 6472 656e 2069 6e20 7468 6520 582e 3530  dren in the X.50
│ │ │ │ +0001a3b0: 3020 616e 6420 646f 6d61 696e 206e 616d  0 and domain nam
│ │ │ │ +0001a3c0: 6520 7379 7374 656d 7320 6173 2077 656c  e systems as wel
│ │ │ │ +0001a3d0: 6c2e 2020 4966 2074 6865 0a70 6172 656e  l.  If the.paren
│ │ │ │ +0001a3e0: 7420 6173 7369 676e 7320 6120 7265 616c  t assigns a real
│ │ │ │ +0001a3f0: 6d20 6e61 6d65 2077 6974 686f 7574 2061  m name without a
│ │ │ │ +0001a400: 6c73 6f20 7265 6769 7374 6572 696e 6720  lso registering 
│ │ │ │ +0001a410: 6974 2069 6e20 7468 6520 646f 6d61 696e  it in the domain
│ │ │ │ +0001a420: 0a6e 616d 6520 6f72 2058 2e35 3030 2068  .name or X.500 h
│ │ │ │ +0001a430: 6965 7261 7263 6879 2c20 6974 2069 7320  ierarchy, it is 
│ │ │ │ +0001a440: 7468 6520 7061 7265 6e74 2773 2072 6573  the parent's res
│ │ │ │ +0001a450: 706f 6e73 6962 696c 6974 7920 746f 206d  ponsibility to m
│ │ │ │ +0001a460: 616b 6520 7375 7265 0a74 6861 7420 7468  ake sure.that th
│ │ │ │ +0001a470: 6572 6520 7769 6c6c 206e 6f74 2069 6e20  ere will not in 
│ │ │ │ +0001a480: 7468 6520 6675 7475 7265 2065 7869 7374  the future exist
│ │ │ │ +0001a490: 2061 206e 616d 6520 6964 656e 7469 6361   a name identica
│ │ │ │ +0001a4a0: 6c20 746f 2074 6865 2072 6561 6c6d 0a6e  l to the realm.n
│ │ │ │ +0001a4b0: 616d 6520 6f66 2074 6865 2063 6869 6c64  ame of the child
│ │ │ │ +0001a4c0: 2075 6e6c 6573 7320 6974 2069 7320 6173   unless it is as
│ │ │ │ +0001a4d0: 7369 676e 6564 2074 6f20 7468 6520 7361  signed to the sa
│ │ │ │ +0001a4e0: 6d65 2065 6e74 6974 7920 6173 2074 6865  me entity as the
│ │ │ │ +0001a4f0: 2072 6561 6c6d 0a6e 616d 652e 0a0a 342e   realm.name...4.
│ │ │ │ +0001a500: 332e 3220 5072 696e 6369 7061 6c20 4e61  3.2 Principal Na
│ │ │ │ +0001a510: 6d65 730a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  mes.------------
│ │ │ │ +0001a520: 2d2d 2d2d 2d2d 2d2d 2d0a 0a41 7320 7761  ---------..As wa
│ │ │ │ +0001a530: 7320 7468 6520 6361 7365 2066 6f72 2072  s the case for r
│ │ │ │ +0001a540: 6561 6c6d 206e 616d 6573 2c20 636f 6e76  ealm names, conv
│ │ │ │ +0001a550: 656e 7469 6f6e 7320 6172 6520 6e65 6564  entions are need
│ │ │ │ +0001a560: 6564 2074 6f20 656e 7375 7265 2074 6861  ed to ensure tha
│ │ │ │ +0001a570: 740a 616c 6c20 6167 7265 6520 6f6e 2077  t.all agree on w
│ │ │ │ +0001a580: 6861 7420 696e 666f 726d 6174 696f 6e20  hat information 
│ │ │ │ +0001a590: 6973 2069 6d70 6c69 6564 2062 7920 6120  is implied by a 
│ │ │ │ +0001a5a0: 7072 696e 6369 7061 6c20 6e61 6d65 2e20  principal name. 
│ │ │ │ +0001a5b0: 2054 6865 0a6e 616d 652d 7479 7065 2066   The.name-type f
│ │ │ │ +0001a5c0: 6965 6c64 2074 6861 7420 6973 2070 6172  ield that is par
│ │ │ │ +0001a5d0: 7420 6f66 2074 6865 2070 7269 6e63 6970  t of the princip
│ │ │ │ +0001a5e0: 616c 206e 616d 6520 696e 6469 6361 7465  al name indicate
│ │ │ │ +0001a5f0: 7320 7468 6520 6b69 6e64 206f 660a 696e  s the kind of.in
│ │ │ │ +0001a600: 666f 726d 6174 696f 6e20 696d 706c 6965  formation implie
│ │ │ │ +0001a610: 6420 6279 2074 6865 206e 616d 652e 2020  d by the name.  
│ │ │ │ +0001a620: 5468 6520 6e61 6d65 2d74 7970 6520 5348  The name-type SH
│ │ │ │ +0001a630: 4f55 4c44 2062 6520 7472 6561 7465 6420  OULD be treated 
│ │ │ │ +0001a640: 6f6e 6c79 0a61 7320 6120 6869 6e74 2074  only.as a hint t
│ │ │ │ +0001a650: 6f20 696e 7465 7270 7265 7469 6e67 2074  o interpreting t
│ │ │ │ +0001a660: 6865 206d 6561 6e69 6e67 206f 6620 6120  he meaning of a 
│ │ │ │ +0001a670: 6e61 6d65 2e20 2049 7420 6973 206e 6f74  name.  It is not
│ │ │ │ +0001a680: 2073 6967 6e69 6669 6361 6e74 0a77 6865   significant.whe
│ │ │ │ +0001a690: 6e20 6368 6563 6b69 6e67 2066 6f72 2065  n checking for e
│ │ │ │ +0001a6a0: 7175 6976 616c 656e 6365 2e20 2050 7269  quivalence.  Pri
│ │ │ │ +0001a6b0: 6e63 6970 616c 206e 616d 6573 2074 6861  ncipal names tha
│ │ │ │ +0001a6c0: 7420 6469 6666 6572 206f 6e6c 7920 696e  t differ only in
│ │ │ │ +0001a6d0: 2074 6865 0a6e 616d 652d 7479 7065 2069   the.name-type i
│ │ │ │ +0001a6e0: 6465 6e74 6966 7920 7468 6520 7361 6d65  dentify the same
│ │ │ │ +0001a6f0: 2070 7269 6e63 6970 616c 2e20 2054 6865   principal.  The
│ │ │ │ +0001a700: 206e 616d 6520 7479 7065 2064 6f65 7320   name type does 
│ │ │ │ +0001a710: 6e6f 7420 7061 7274 6974 696f 6e0a 7468  not partition.th
│ │ │ │ +0001a720: 6520 6e61 6d65 2073 7061 6365 2e20 2049  e name space.  I
│ │ │ │ +0001a730: 676e 6f72 696e 6720 7468 6520 6e61 6d65  gnoring the name
│ │ │ │ +0001a740: 2074 7970 652c 206e 6f20 7477 6f20 6e61   type, no two na
│ │ │ │ +0001a750: 6d65 7320 6361 6e20 6265 2074 6865 2073  mes can be the s
│ │ │ │ +0001a760: 616d 650a 2869 2e65 2e20 2061 7420 6c65  ame.(i.e.  at le
│ │ │ │ +0001a770: 6173 7420 6f6e 6520 6f66 2074 6865 2063  ast one of the c
│ │ │ │ +0001a780: 6f6d 706f 6e65 6e74 732c 206f 7220 7468  omponents, or th
│ │ │ │ +0001a790: 6520 7265 616c 6d2c 204d 5553 5420 6265  e realm, MUST be
│ │ │ │ +0001a7a0: 2064 6966 6665 7265 6e74 292e 0a54 6865   different)..The
│ │ │ │ +0001a7b0: 2066 6f6c 6c6f 7769 6e67 206e 616d 6520   following name 
│ │ │ │ +0001a7c0: 7479 7065 7320 6172 6520 6465 6669 6e65  types are define
│ │ │ │ +0001a7d0: 643a 0a0a 2020 2020 206e 616d 652d 7479  d:..     name-ty
│ │ │ │ +0001a7e0: 7065 2020 2020 2020 7661 6c75 6520 2020  pe      value   
│ │ │ │ +0001a7f0: 6d65 616e 696e 670a 0a20 2020 2020 4e54  meaning..     NT
│ │ │ │ +0001a800: 2d55 4e4b 4e4f 574e 2020 2020 2020 2020  -UNKNOWN        
│ │ │ │ +0001a810: 3020 204e 616d 6520 7479 7065 206e 6f74  0  Name type not
│ │ │ │ +0001a820: 206b 6e6f 776e 0a20 2020 2020 4e54 2d50   known.     NT-P
│ │ │ │ +0001a830: 5249 4e43 4950 414c 2020 2020 2020 3120  RINCIPAL      1 
│ │ │ │ +0001a840: 204a 7573 7420 7468 6520 6e61 6d65 206f   Just the name o
│ │ │ │ +0001a850: 6620 7468 6520 7072 696e 6369 7061 6c20  f the principal 
│ │ │ │ +0001a860: 6173 2069 6e20 4443 452c 206f 7220 666f  as in DCE, or fo
│ │ │ │ +0001a870: 7220 7573 6572 730a 2020 2020 204e 542d  r users.     NT-
│ │ │ │ +0001a880: 5352 562d 494e 5354 2020 2020 2020 2032  SRV-INST       2
│ │ │ │ +0001a890: 2020 5365 7276 6963 6520 616e 6420 6f74    Service and ot
│ │ │ │ +0001a8a0: 6865 7220 756e 6971 7565 2069 6e73 7461  her unique insta
│ │ │ │ +0001a8b0: 6e63 6520 286b 7262 7467 7429 0a20 2020  nce (krbtgt).   
│ │ │ │ +0001a8c0: 2020 4e54 2d53 5256 2d48 5354 2020 2020    NT-SRV-HST    
│ │ │ │ +0001a8d0: 2020 2020 3320 2053 6572 7669 6365 2077      3  Service w
│ │ │ │ +0001a8e0: 6974 6820 686f 7374 206e 616d 6520 6173  ith host name as
│ │ │ │ +0001a8f0: 2069 6e73 7461 6e63 6520 2874 656c 6e65   instance (telne
│ │ │ │ +0001a900: 742c 2072 636f 6d6d 616e 6473 290a 2020  t, rcommands).  
│ │ │ │ +0001a910: 2020 204e 542d 5352 562d 5848 5354 2020     NT-SRV-XHST  
│ │ │ │ +0001a920: 2020 2020 2034 2020 5365 7276 6963 6520       4  Service 
│ │ │ │ +0001a930: 7769 7468 2068 6f73 7420 6173 2072 656d  with host as rem
│ │ │ │ +0001a940: 6169 6e69 6e67 2063 6f6d 706f 6e65 6e74  aining component
│ │ │ │ +0001a950: 730a 2020 2020 204e 542d 5549 4420 2020  s.     NT-UID   
│ │ │ │ +0001a960: 2020 2020 2020 2020 2035 2020 556e 6971           5  Uniq
│ │ │ │ +0001a970: 7565 2049 440a 2020 2020 204e 542d 5835  ue ID.     NT-X5
│ │ │ │ +0001a980: 3030 2d50 5249 4e43 4950 414c 2036 2020  00-PRINCIPAL 6  
│ │ │ │ +0001a990: 456e 636f 6465 6420 582e 3530 3920 4469  Encoded X.509 Di
│ │ │ │ +0001a9a0: 7374 696e 6769 7368 6564 206e 616d 6520  stingished name 
│ │ │ │ +0001a9b0: 5b52 4643 2032 3235 335d 0a20 2020 2020  [RFC 2253].     
│ │ │ │ +0001a9c0: 4e54 2d53 4d54 502d 4e41 4d45 2020 2020  NT-SMTP-NAME    
│ │ │ │ +0001a9d0: 2020 3720 204e 616d 6520 696e 2066 6f72    7  Name in for
│ │ │ │ +0001a9e0: 6d20 6f66 2053 4d54 5020 656d 6169 6c20  m of SMTP email 
│ │ │ │ +0001a9f0: 6e61 6d65 2028 652e 672e 2075 7365 7240  name (e.g. user@
│ │ │ │ +0001aa00: 666f 6f2e 636f 6d29 0a20 2020 2020 4e54  foo.com).     NT
│ │ │ │ +0001aa10: 2d45 4e54 4552 5052 4953 4520 2020 2031  -ENTERPRISE    1
│ │ │ │ +0001aa20: 3020 2020 456e 7465 7270 7269 7365 206e  0   Enterprise n
│ │ │ │ +0001aa30: 616d 6520 2d20 6d61 7920 6265 206d 6170  ame - may be map
│ │ │ │ +0001aa40: 7065 6420 746f 2070 7269 6e63 6970 616c  ped to principal
│ │ │ │ +0001aa50: 206e 616d 650a 0a20 2020 5768 656e 2061   name..   When a
│ │ │ │ +0001aa60: 206e 616d 6520 696d 706c 6965 7320 6e6f   name implies no
│ │ │ │ +0001aa70: 2069 6e66 6f72 6d61 7469 6f6e 206f 7468   information oth
│ │ │ │ +0001aa80: 6572 2074 6861 6e20 6974 7320 756e 6971  er than its uniq
│ │ │ │ +0001aa90: 7565 6e65 7373 2061 7420 610a 7061 7274  ueness at a.part
│ │ │ │ +0001aaa0: 6963 756c 6172 2074 696d 6520 7468 6520  icular time the 
│ │ │ │ +0001aab0: 6e61 6d65 2074 7970 6520 5052 494e 4349  name type PRINCI
│ │ │ │ +0001aac0: 5041 4c20 5348 4f55 4c44 2062 6520 7573  PAL SHOULD be us
│ │ │ │ +0001aad0: 6564 2e20 2054 6865 2070 7269 6e63 6970  ed.  The princip
│ │ │ │ +0001aae0: 616c 0a6e 616d 6520 7479 7065 2053 484f  al.name type SHO
│ │ │ │ +0001aaf0: 554c 4420 6265 2075 7365 6420 666f 7220  ULD be used for 
│ │ │ │ +0001ab00: 7573 6572 732c 2061 6e64 2069 7420 6d69  users, and it mi
│ │ │ │ +0001ab10: 6768 7420 616c 736f 2062 6520 7573 6564  ght also be used
│ │ │ │ +0001ab20: 2066 6f72 2061 0a75 6e69 7175 6520 7365   for a.unique se
│ │ │ │ +0001ab30: 7276 6572 2e20 2049 6620 7468 6520 6e61  rver.  If the na
│ │ │ │ +0001ab40: 6d65 2069 7320 6120 756e 6971 7565 206d  me is a unique m
│ │ │ │ +0001ab50: 6163 6869 6e65 2067 656e 6572 6174 6564  achine generated
│ │ │ │ +0001ab60: 2049 4420 7468 6174 2069 730a 6775 6172   ID that is.guar
│ │ │ │ +0001ab70: 616e 7465 6564 206e 6576 6572 2074 6f20  anteed never to 
│ │ │ │ +0001ab80: 6265 2072 6561 7373 6967 6e65 6420 7468  be reassigned th
│ │ │ │ +0001ab90: 656e 2074 6865 206e 616d 6520 7479 7065  en the name type
│ │ │ │ +0001aba0: 206f 6620 5549 4420 5348 4f55 4c44 2062   of UID SHOULD b
│ │ │ │ +0001abb0: 650a 7573 6564 2028 6e6f 7465 2074 6861  e.used (note tha
│ │ │ │ +0001abc0: 7420 6974 2069 7320 6765 6e65 7261 6c6c  t it is generall
│ │ │ │ +0001abd0: 7920 6120 6261 6420 6964 6561 2074 6f20  y a bad idea to 
│ │ │ │ +0001abe0: 7265 6173 7369 676e 206e 616d 6573 206f  reassign names o
│ │ │ │ +0001abf0: 6620 616e 7920 7479 7065 0a73 696e 6365  f any type.since
│ │ │ │ +0001ac00: 2073 7461 6c65 2065 6e74 7269 6573 206d   stale entries m
│ │ │ │ +0001ac10: 6967 6874 2072 656d 6169 6e20 696e 2061  ight remain in a
│ │ │ │ +0001ac20: 6363 6573 7320 636f 6e74 726f 6c20 6c69  ccess control li
│ │ │ │ +0001ac30: 7374 7329 2e0a 0a20 2020 4966 2074 6865  sts)...   If the
│ │ │ │ +0001ac40: 2066 6972 7374 2063 6f6d 706f 6e65 6e74   first component
│ │ │ │ +0001ac50: 206f 6620 6120 6e61 6d65 2069 6465 6e74   of a name ident
│ │ │ │ +0001ac60: 6966 6965 7320 6120 7365 7276 6963 6520  ifies a service 
│ │ │ │ +0001ac70: 616e 6420 7468 650a 7265 6d61 696e 696e  and the.remainin
│ │ │ │ +0001ac80: 6720 636f 6d70 6f6e 656e 7473 2069 6465  g components ide
│ │ │ │ +0001ac90: 6e74 6966 7920 616e 2069 6e73 7461 6e63  ntify an instanc
│ │ │ │ +0001aca0: 6520 6f66 2074 6865 2073 6572 7669 6365  e of the service
│ │ │ │ +0001acb0: 2069 6e20 6120 7365 7276 6572 0a73 7065   in a server.spe
│ │ │ │ +0001acc0: 6369 6669 6564 206d 616e 6e65 722c 2074  cified manner, t
│ │ │ │ +0001acd0: 6865 6e20 7468 6520 6e61 6d65 2074 7970  hen the name typ
│ │ │ │ +0001ace0: 6520 6f66 2053 5256 2d49 4e53 5420 5348  e of SRV-INST SH
│ │ │ │ +0001acf0: 4f55 4c44 2062 6520 7573 6564 2e20 2041  OULD be used.  A
│ │ │ │ +0001ad00: 6e0a 6578 616d 706c 6520 6f66 2074 6869  n.example of thi
│ │ │ │ +0001ad10: 7320 6e61 6d65 2074 7970 6520 6973 2074  s name type is t
│ │ │ │ +0001ad20: 6865 204b 6572 6265 726f 7320 7469 636b  he Kerberos tick
│ │ │ │ +0001ad30: 6574 2d67 7261 6e74 696e 6720 7365 7276  et-granting serv
│ │ │ │ +0001ad40: 6963 6520 7768 6f73 650a 6e61 6d65 2068  ice whose.name h
│ │ │ │ +0001ad50: 6173 2061 2066 6972 7374 2063 6f6d 706f  as a first compo
│ │ │ │ +0001ad60: 6e65 6e74 206f 6620 6b72 6274 6774 2061  nent of krbtgt a
│ │ │ │ +0001ad70: 6e64 2061 2073 6563 6f6e 6420 636f 6d70  nd a second comp
│ │ │ │ +0001ad80: 6f6e 656e 7420 6964 656e 7469 6679 696e  onent identifyin
│ │ │ │ +0001ad90: 670a 7468 6520 7265 616c 6d20 666f 7220  g.the realm for 
│ │ │ │ +0001ada0: 7768 6963 6820 7468 6520 7469 636b 6574  which the ticket
│ │ │ │ +0001adb0: 2069 7320 7661 6c69 642e 0a0a 2020 2049   is valid...   I
│ │ │ │ +0001adc0: 6620 7468 6520 6669 7273 7420 636f 6d70  f the first comp
│ │ │ │ +0001add0: 6f6e 656e 7420 6f66 2061 206e 616d 6520  onent of a name 
│ │ │ │ +0001ade0: 6964 656e 7469 6669 6573 2061 2073 6572  identifies a ser
│ │ │ │ +0001adf0: 7669 6365 2061 6e64 2074 6865 7265 2069  vice and there i
│ │ │ │ +0001ae00: 7320 610a 7369 6e67 6c65 2063 6f6d 706f  s a.single compo
│ │ │ │ +0001ae10: 6e65 6e74 2066 6f6c 6c6f 7769 6e67 2074  nent following t
│ │ │ │ +0001ae20: 6865 2073 6572 7669 6365 206e 616d 6520  he service name 
│ │ │ │ +0001ae30: 6964 656e 7469 6679 696e 6720 7468 6520  identifying the 
│ │ │ │ +0001ae40: 696e 7374 616e 6365 2061 730a 7468 6520  instance as.the 
│ │ │ │ +0001ae50: 686f 7374 206f 6e20 7768 6963 6820 7468  host on which th
│ │ │ │ +0001ae60: 6520 7365 7276 6572 2069 7320 7275 6e6e  e server is runn
│ │ │ │ +0001ae70: 696e 672c 2074 6865 6e20 7468 6520 6e61  ing, then the na
│ │ │ │ +0001ae80: 6d65 2074 7970 6520 5352 562d 2048 5354  me type SRV- HST
│ │ │ │ +0001ae90: 0a53 484f 554c 4420 6265 2075 7365 642e  .SHOULD be used.
│ │ │ │ +0001aea0: 2020 5468 6973 2074 7970 6520 6973 2074    This type is t
│ │ │ │ +0001aeb0: 7970 6963 616c 6c79 2075 7365 6420 666f  ypically used fo
│ │ │ │ +0001aec0: 7220 496e 7465 726e 6574 2073 6572 7669  r Internet servi
│ │ │ │ +0001aed0: 6365 7320 7375 6368 0a61 7320 7465 6c6e  ces such.as teln
│ │ │ │ +0001aee0: 6574 2061 6e64 2074 6865 2042 6572 6b65  et and the Berke
│ │ │ │ +0001aef0: 6c65 7920 5220 636f 6d6d 616e 6473 2e20  ley R commands. 
│ │ │ │ +0001af00: 2049 6620 7468 6520 7365 7061 7261 7465   If the separate
│ │ │ │ +0001af10: 2063 6f6d 706f 6e65 6e74 7320 6f66 0a74   components of.t
│ │ │ │ +0001af20: 6865 2068 6f73 7420 6e61 6d65 2061 7070  he host name app
│ │ │ │ +0001af30: 6561 7220 6173 2073 7563 6365 7373 6976  ear as successiv
│ │ │ │ +0001af40: 6520 636f 6d70 6f6e 656e 7473 2066 6f6c  e components fol
│ │ │ │ +0001af50: 6c6f 7769 6e67 2074 6865 206e 616d 6520  lowing the name 
│ │ │ │ +0001af60: 6f66 2074 6865 0a73 6572 7669 6365 2c20  of the.service, 
│ │ │ │ +0001af70: 7468 656e 2074 6865 206e 616d 6520 7479  then the name ty
│ │ │ │ +0001af80: 7065 2053 5256 2d58 4853 5420 5348 4f55  pe SRV-XHST SHOU
│ │ │ │ +0001af90: 4c44 2062 6520 7573 6564 2e20 2054 6869  LD be used.  Thi
│ │ │ │ +0001afa0: 7320 7479 7065 206d 6967 6874 2062 650a  s type might be.
│ │ │ │ +0001afb0: 7573 6564 2074 6f20 6964 656e 7469 6679  used to identify
│ │ │ │ +0001afc0: 2073 6572 7665 7273 206f 6e20 686f 7374   servers on host
│ │ │ │ +0001afd0: 7320 7769 7468 2058 2e35 3030 206e 616d  s with X.500 nam
│ │ │ │ +0001afe0: 6573 2077 6865 7265 2074 6865 2073 6c61  es where the sla
│ │ │ │ +0001aff0: 7368 2028 2f29 0a6d 6967 6874 206f 7468  sh (/).might oth
│ │ │ │ +0001b000: 6572 7769 7365 2062 6520 616d 6269 6775  erwise be ambigu
│ │ │ │ +0001b010: 6f75 732e 0a0a 2020 2041 206e 616d 6520  ous...   A name 
│ │ │ │ +0001b020: 7479 7065 206f 6620 4e54 2d58 3530 302d  type of NT-X500-
│ │ │ │ +0001b030: 5052 494e 4349 5041 4c20 5348 4f55 4c44  PRINCIPAL SHOULD
│ │ │ │ +0001b040: 2062 6520 7573 6564 2077 6865 6e20 6120   be used when a 
│ │ │ │ +0001b050: 6e61 6d65 2066 726f 6d20 616e 0a58 2e35  name from an.X.5
│ │ │ │ +0001b060: 3039 2063 6572 7469 6669 6361 7465 2069  09 certificate i
│ │ │ │ +0001b070: 7320 7472 616e 736c 6174 6564 2069 6e74  s translated int
│ │ │ │ +0001b080: 6f20 6120 4b65 7262 6572 6f73 206e 616d  o a Kerberos nam
│ │ │ │ +0001b090: 652e 2020 5468 6520 656e 636f 6469 6e67  e.  The encoding
│ │ │ │ +0001b0a0: 206f 660a 7468 6520 582e 3530 3920 6e61   of.the X.509 na
│ │ │ │ +0001b0b0: 6d65 2061 7320 6120 4b65 7262 6572 6f73  me as a Kerberos
│ │ │ │ +0001b0c0: 2070 7269 6e63 6970 616c 2073 6861 6c6c   principal shall
│ │ │ │ +0001b0d0: 2063 6f6e 666f 726d 2074 6f20 7468 6520   conform to the 
│ │ │ │ +0001b0e0: 656e 636f 6469 6e67 0a72 756c 6573 2073  encoding.rules s
│ │ │ │ +0001b0f0: 7065 6369 6669 6564 2069 6e20 5246 4320  pecified in RFC 
│ │ │ │ +0001b100: 3232 3533 2e0a 0a20 2020 4120 6e61 6d65  2253...   A name
│ │ │ │ +0001b110: 2074 7970 6520 6f66 2053 4d54 5020 616c   type of SMTP al
│ │ │ │ +0001b120: 6c6f 7773 2061 206e 616d 6520 746f 2062  lows a name to b
│ │ │ │ +0001b130: 6520 6f66 2061 2066 6f72 6d20 7468 6174  e of a form that
│ │ │ │ +0001b140: 2072 6573 656d 626c 6573 2061 0a53 4d54   resembles a.SMT
│ │ │ │ +0001b150: 5020 656d 6169 6c20 6e61 6d65 2e20 2054  P email name.  T
│ │ │ │ +0001b160: 6869 7320 6e61 6d65 2c20 696e 636c 7564  his name, includ
│ │ │ │ +0001b170: 696e 6720 616e 2022 4022 2061 6e64 2061  ing an "@" and a
│ │ │ │ +0001b180: 2064 6f6d 6169 6e20 6e61 6d65 2c20 6973   domain name, is
│ │ │ │ +0001b190: 2075 7365 640a 6173 2074 6865 206f 6e65   used.as the one
│ │ │ │ +0001b1a0: 2063 6f6d 706f 6e65 6e74 206f 6620 7468   component of th
│ │ │ │ +0001b1b0: 6520 7072 696e 6369 7061 6c20 6e61 6d65  e principal name
│ │ │ │ +0001b1c0: 2e0a 0a20 2020 4120 6e61 6d65 2074 7970  ...   A name typ
│ │ │ │ +0001b1d0: 6520 6f66 2055 4e4b 4e4f 574e 2053 484f  e of UNKNOWN SHO
│ │ │ │ +0001b1e0: 554c 4420 6265 2075 7365 6420 7768 656e  ULD be used when
│ │ │ │ +0001b1f0: 2074 6865 2066 6f72 6d20 6f66 2074 6865   the form of the
│ │ │ │ +0001b200: 206e 616d 6520 6973 0a6e 6f74 206b 6e6f   name is.not kno
│ │ │ │ +0001b210: 776e 2e20 2057 6865 6e20 636f 6d70 6172  wn.  When compar
│ │ │ │ +0001b220: 696e 6720 6e61 6d65 732c 2061 206e 616d  ing names, a nam
│ │ │ │ +0001b230: 6520 6f66 2074 7970 6520 554e 4b4e 4f57  e of type UNKNOW
│ │ │ │ +0001b240: 4e20 7769 6c6c 206d 6174 6368 0a70 7269  N will match.pri
│ │ │ │ +0001b250: 6e63 6970 616c 7320 6175 7468 656e 7469  ncipals authenti
│ │ │ │ +0001b260: 6361 7465 6420 7769 7468 206e 616d 6573  cated with names
│ │ │ │ +0001b270: 206f 6620 616e 7920 7479 7065 2e20 2041   of any type.  A
│ │ │ │ +0001b280: 2070 7269 6e63 6970 616c 0a61 7574 6865   principal.authe
│ │ │ │ +0001b290: 6e74 6963 6174 6564 2077 6974 6820 6120  nticated with a 
│ │ │ │ +0001b2a0: 6e61 6d65 206f 6620 7479 7065 2055 4e4b  name of type UNK
│ │ │ │ +0001b2b0: 4e4f 574e 2c20 686f 7765 7665 722c 2077  NOWN, however, w
│ │ │ │ +0001b2c0: 696c 6c20 6f6e 6c79 206d 6174 6368 0a6f  ill only match.o
│ │ │ │ +0001b2d0: 7468 6572 206e 616d 6573 206f 6620 7479  ther names of ty
│ │ │ │ +0001b2e0: 7065 2055 4e4b 4e4f 574e 2e0a 0a20 2020  pe UNKNOWN...   
│ │ │ │ +0001b2f0: 4e61 6d65 7320 6f66 2061 6e79 2074 7970  Names of any typ
│ │ │ │ +0001b300: 6520 7769 7468 2061 6e20 696e 6974 6961  e with an initia
│ │ │ │ +0001b310: 6c20 636f 6d70 6f6e 656e 7420 6f66 2027  l component of '
│ │ │ │ +0001b320: 6b72 6274 6774 2720 6172 6520 7265 7365  krbtgt' are rese
│ │ │ │ +0001b330: 7276 6564 0a66 6f72 2074 6865 204b 6572  rved.for the Ker
│ │ │ │ +0001b340: 6265 726f 7320 7469 636b 6574 2067 7261  beros ticket gra
│ │ │ │ +0001b350: 6e74 696e 6720 7365 7276 6963 652e 2020  nting service.  
│ │ │ │ +0001b360: 2a4e 6f74 6520 4e61 6d65 206f 6620 7468  *Note Name of th
│ │ │ │ +0001b370: 6520 5447 533a 0a6b 7262 7467 742c 2066  e TGS:.krbtgt, f
│ │ │ │ +0001b380: 6f72 2074 6865 2066 6f72 6d20 6f66 2073  or the form of s
│ │ │ │ +0001b390: 7563 6820 6e61 6d65 732e 0a0a 342e 332e  uch names...4.3.
│ │ │ │ +0001b3a0: 322e 3120 4e61 6d65 206f 6620 7365 7276  2.1 Name of serv
│ │ │ │ +0001b3b0: 6572 2070 7269 6e63 6970 616c 730a 2e2e  er principals...
│ │ │ │  0001b3c0: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e  ................
│ │ │ │ -0001b3d0: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e0a 0a54  ...............T
│ │ │ │ -0001b3e0: 6865 2070 7269 6e63 6970 616c 2069 6465  he principal ide
│ │ │ │ -0001b3f0: 6e74 6966 6965 7220 666f 7220 6120 7365  ntifier for a se
│ │ │ │ -0001b400: 7276 6572 206f 6e20 6120 686f 7374 2077  rver on a host w
│ │ │ │ -0001b410: 696c 6c20 6765 6e65 7261 6c6c 7920 6265  ill generally be
│ │ │ │ -0001b420: 0a63 6f6d 706f 7365 6420 6f66 2074 776f  .composed of two
│ │ │ │ -0001b430: 2070 6172 7473 3a20 2831 2920 7468 6520   parts: (1) the 
│ │ │ │ -0001b440: 7265 616c 6d20 6f66 2074 6865 204b 4443  realm of the KDC
│ │ │ │ -0001b450: 2077 6974 6820 7768 6963 6820 7468 6520   with which the 
│ │ │ │ -0001b460: 7365 7276 6572 2069 730a 7265 6769 7374  server is.regist
│ │ │ │ -0001b470: 6572 6564 2c20 616e 6420 2832 2920 6120  ered, and (2) a 
│ │ │ │ -0001b480: 7477 6f2d 636f 6d70 6f6e 656e 7420 6e61  two-component na
│ │ │ │ -0001b490: 6d65 206f 6620 7479 7065 204e 542d 5352  me of type NT-SR
│ │ │ │ -0001b4a0: 562d 4853 5420 6966 2074 6865 2068 6f73  V-HST if the hos
│ │ │ │ -0001b4b0: 740a 6e61 6d65 2069 7320 616e 2049 6e74  t.name is an Int
│ │ │ │ -0001b4c0: 6572 6e65 7420 646f 6d61 696e 206e 616d  ernet domain nam
│ │ │ │ -0001b4d0: 6520 6f72 2061 206d 756c 7469 2d63 6f6d  e or a multi-com
│ │ │ │ -0001b4e0: 706f 6e65 6e74 206e 616d 6520 6f66 2074  ponent name of t
│ │ │ │ -0001b4f0: 7970 650a 4e54 2d53 5256 2d58 4853 5420  ype.NT-SRV-XHST 
│ │ │ │ -0001b500: 6966 2074 6865 206e 616d 6520 6f66 2074  if the name of t
│ │ │ │ -0001b510: 6865 2068 6f73 7420 6973 206f 6620 6120  he host is of a 
│ │ │ │ -0001b520: 666f 726d 2073 7563 6820 6173 2058 2e35  form such as X.5
│ │ │ │ -0001b530: 3030 2074 6861 740a 616c 6c6f 7773 2073  00 that.allows s
│ │ │ │ -0001b540: 6c61 7368 2028 2f29 2073 6570 6172 6174  lash (/) separat
│ │ │ │ -0001b550: 6f72 732e 2020 5468 6520 6669 7273 7420  ors.  The first 
│ │ │ │ -0001b560: 636f 6d70 6f6e 656e 7420 6f66 2074 6865  component of the
│ │ │ │ -0001b570: 2074 776f 2d20 6f72 0a6d 756c 7469 2d63   two- or.multi-c
│ │ │ │ -0001b580: 6f6d 706f 6e65 6e74 206e 616d 6520 7769  omponent name wi
│ │ │ │ -0001b590: 6c6c 2069 6465 6e74 6966 7920 7468 6520  ll identify the 
│ │ │ │ -0001b5a0: 7365 7276 6963 6520 616e 6420 7468 6520  service and the 
│ │ │ │ -0001b5b0: 6c61 7474 6572 2063 6f6d 706f 6e65 6e74  latter component
│ │ │ │ -0001b5c0: 730a 7769 6c6c 2069 6465 6e74 6966 7920  s.will identify 
│ │ │ │ -0001b5d0: 7468 6520 686f 7374 2e20 2057 6865 7265  the host.  Where
│ │ │ │ -0001b5e0: 2074 6865 206e 616d 6520 6f66 2074 6865   the name of the
│ │ │ │ -0001b5f0: 2068 6f73 7420 6973 206e 6f74 2063 6173   host is not cas
│ │ │ │ -0001b600: 650a 7365 6e73 6974 6976 6520 2866 6f72  e.sensitive (for
│ │ │ │ -0001b610: 2065 7861 6d70 6c65 2c20 7769 7468 2049   example, with I
│ │ │ │ -0001b620: 6e74 6572 6e65 7420 646f 6d61 696e 206e  nternet domain n
│ │ │ │ -0001b630: 616d 6573 2920 7468 6520 6e61 6d65 206f  ames) the name o
│ │ │ │ -0001b640: 6620 7468 6520 686f 7374 0a4d 5553 5420  f the host.MUST 
│ │ │ │ -0001b650: 6265 206c 6f77 6572 2063 6173 652e 2020  be lower case.  
│ │ │ │ -0001b660: 4966 2073 7065 6369 6669 6564 2062 7920  If specified by 
│ │ │ │ -0001b670: 7468 6520 6170 706c 6963 6174 696f 6e20  the application 
│ │ │ │ -0001b680: 7072 6f74 6f63 6f6c 2066 6f72 0a73 6572  protocol for.ser
│ │ │ │ -0001b690: 7669 6365 7320 7375 6368 2061 7320 7465  vices such as te
│ │ │ │ -0001b6a0: 6c6e 6574 2061 6e64 2074 6865 2042 6572  lnet and the Ber
│ │ │ │ -0001b6b0: 6b65 6c65 7920 5220 636f 6d6d 616e 6473  keley R commands
│ │ │ │ -0001b6c0: 2077 6869 6368 2072 756e 2077 6974 680a   which run with.
│ │ │ │ -0001b6d0: 7379 7374 656d 2070 7269 7669 6c65 6765  system privilege
│ │ │ │ -0001b6e0: 732c 2074 6865 2066 6972 7374 2063 6f6d  s, the first com
│ │ │ │ -0001b6f0: 706f 6e65 6e74 204d 4159 2062 6520 7468  ponent MAY be th
│ │ │ │ -0001b700: 6520 7374 7269 6e67 2027 686f 7374 2720  e string 'host' 
│ │ │ │ -0001b710: 696e 7374 6561 640a 6f66 2061 2073 6572  instead.of a ser
│ │ │ │ -0001b720: 7669 6365 2073 7065 6369 6669 6320 6964  vice specific id
│ │ │ │ -0001b730: 656e 7469 6669 6572 2e0a 0a34 2e33 2e32  entifier...4.3.2
│ │ │ │ -0001b740: 2e32 204e 616d 6520 6f66 2074 6865 2054  .2 Name of the T
│ │ │ │ -0001b750: 4753 0a2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e  GS..............
│ │ │ │ -0001b760: 2e2e 2e2e 2e2e 2e2e 2e2e 0a0a 5468 6520  ............The 
│ │ │ │ -0001b770: 7072 696e 6369 7061 6c20 6964 656e 7469  principal identi
│ │ │ │ -0001b780: 6669 6572 206f 6620 7468 6520 7469 636b  fier of the tick
│ │ │ │ -0001b790: 6574 2d67 7261 6e74 696e 6720 7365 7276  et-granting serv
│ │ │ │ -0001b7a0: 6963 6520 7368 616c 6c20 6265 0a63 6f6d  ice shall be.com
│ │ │ │ -0001b7b0: 706f 7365 6420 6f66 2074 6872 6565 2070  posed of three p
│ │ │ │ -0001b7c0: 6172 7473 3a20 2831 2920 7468 6520 7265  arts: (1) the re
│ │ │ │ -0001b7d0: 616c 6d20 6f66 2074 6865 204b 4443 2069  alm of the KDC i
│ │ │ │ -0001b7e0: 7373 7569 6e67 2074 6865 2054 4753 2074  ssuing the TGS t
│ │ │ │ -0001b7f0: 6963 6b65 740a 2832 2920 6120 7477 6f2d  icket.(2) a two-
│ │ │ │ -0001b800: 7061 7274 206e 616d 6520 6f66 2074 7970  part name of typ
│ │ │ │ -0001b810: 6520 4e54 2d53 5256 2d49 4e53 542c 2077  e NT-SRV-INST, w
│ │ │ │ -0001b820: 6974 6820 7468 6520 6669 7273 7420 7061  ith the first pa
│ │ │ │ -0001b830: 7274 2022 6b72 6274 6774 220a 616e 6420  rt "krbtgt".and 
│ │ │ │ -0001b840: 7468 6520 7365 636f 6e64 2070 6172 7420  the second part 
│ │ │ │ -0001b850: 7468 6520 6e61 6d65 206f 6620 7468 6520  the name of the 
│ │ │ │ -0001b860: 7265 616c 6d20 7768 6963 6820 7769 6c6c  realm which will
│ │ │ │ -0001b870: 2061 6363 6570 7420 7468 650a 7469 636b   accept the.tick
│ │ │ │ -0001b880: 6574 2d67 7261 6e74 696e 6720 7469 636b  et-granting tick
│ │ │ │ -0001b890: 6574 2e20 2046 6f72 2065 7861 6d70 6c65  et.  For example
│ │ │ │ -0001b8a0: 2c20 6120 7469 636b 6574 2d67 7261 6e74  , a ticket-grant
│ │ │ │ -0001b8b0: 696e 6720 7469 636b 6574 2069 7373 7565  ing ticket issue
│ │ │ │ -0001b8c0: 6420 6279 0a74 6865 2041 5448 454e 412e  d by.the ATHENA.
│ │ │ │ -0001b8d0: 4d49 542e 4544 5520 7265 616c 6d20 746f  MIT.EDU realm to
│ │ │ │ -0001b8e0: 2062 6520 7573 6564 2074 6f20 6765 7420   be used to get 
│ │ │ │ -0001b8f0: 7469 636b 6574 7320 6672 6f6d 2074 6865  tickets from the
│ │ │ │ -0001b900: 0a41 5448 454e 412e 4d49 542e 4544 5520  .ATHENA.MIT.EDU 
│ │ │ │ -0001b910: 4b44 4320 6861 7320 6120 7072 696e 6369  KDC has a princi
│ │ │ │ -0001b920: 7061 6c20 6964 656e 7469 6669 6572 206f  pal identifier o
│ │ │ │ -0001b930: 6620 2241 5448 454e 412e 4d49 542e 4544  f "ATHENA.MIT.ED
│ │ │ │ -0001b940: 5522 0a28 7265 616c 6d29 2c20 2822 6b72  U".(realm), ("kr
│ │ │ │ -0001b950: 6274 6774 222c 2022 4154 4845 4e41 2e4d  btgt", "ATHENA.M
│ │ │ │ -0001b960: 4954 2e45 4455 2229 2028 6e61 6d65 292e  IT.EDU") (name).
│ │ │ │ -0001b970: 2020 4120 7469 636b 6574 2d67 7261 6e74    A ticket-grant
│ │ │ │ -0001b980: 696e 6720 7469 636b 6574 0a69 7373 7565  ing ticket.issue
│ │ │ │ -0001b990: 6420 6279 2074 6865 2041 5448 454e 412e  d by the ATHENA.
│ │ │ │ -0001b9a0: 4d49 542e 4544 5520 7265 616c 6d20 746f  MIT.EDU realm to
│ │ │ │ -0001b9b0: 2062 6520 7573 6564 2074 6f20 6765 7420   be used to get 
│ │ │ │ -0001b9c0: 7469 636b 6574 7320 6672 6f6d 2074 6865  tickets from the
│ │ │ │ -0001b9d0: 0a4d 4954 2e45 4455 2072 6561 6c6d 2068  .MIT.EDU realm h
│ │ │ │ -0001b9e0: 6173 2061 2070 7269 6e63 6970 616c 2069  as a principal i
│ │ │ │ -0001b9f0: 6465 6e74 6966 6965 7220 6f66 2022 4154  dentifier of "AT
│ │ │ │ -0001ba00: 4845 4e41 2e4d 4954 2e45 4455 2220 2872  HENA.MIT.EDU" (r
│ │ │ │ -0001ba10: 6561 6c6d 292c 0a28 226b 7262 7467 7422  ealm),.("krbtgt"
│ │ │ │ -0001ba20: 2c20 224d 4954 2e45 4455 2229 2028 6e61  , "MIT.EDU") (na
│ │ │ │ -0001ba30: 6d65 292e 0a0a 342e 332e 3320 4368 6f6f  me)...4.3.3 Choo
│ │ │ │ -0001ba40: 7369 6e67 2061 2070 7269 6e63 6970 616c  sing a principal
│ │ │ │ -0001ba50: 2077 6974 6820 7768 6963 6820 746f 2063   with which to c
│ │ │ │ -0001ba60: 6f6d 6d75 6e69 6361 7465 0a2d 2d2d 2d2d  ommunicate.-----
│ │ │ │ +0001b3d0: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e0a  ................
│ │ │ │ +0001b3e0: 0a54 6865 2070 7269 6e63 6970 616c 2069  .The principal i
│ │ │ │ +0001b3f0: 6465 6e74 6966 6965 7220 666f 7220 6120  dentifier for a 
│ │ │ │ +0001b400: 7365 7276 6572 206f 6e20 6120 686f 7374  server on a host
│ │ │ │ +0001b410: 2077 696c 6c20 6765 6e65 7261 6c6c 7920   will generally 
│ │ │ │ +0001b420: 6265 0a63 6f6d 706f 7365 6420 6f66 2074  be.composed of t
│ │ │ │ +0001b430: 776f 2070 6172 7473 3a20 2831 2920 7468  wo parts: (1) th
│ │ │ │ +0001b440: 6520 7265 616c 6d20 6f66 2074 6865 204b  e realm of the K
│ │ │ │ +0001b450: 4443 2077 6974 6820 7768 6963 6820 7468  DC with which th
│ │ │ │ +0001b460: 6520 7365 7276 6572 2069 730a 7265 6769  e server is.regi
│ │ │ │ +0001b470: 7374 6572 6564 2c20 616e 6420 2832 2920  stered, and (2) 
│ │ │ │ +0001b480: 6120 7477 6f2d 636f 6d70 6f6e 656e 7420  a two-component 
│ │ │ │ +0001b490: 6e61 6d65 206f 6620 7479 7065 204e 542d  name of type NT-
│ │ │ │ +0001b4a0: 5352 562d 4853 5420 6966 2074 6865 2068  SRV-HST if the h
│ │ │ │ +0001b4b0: 6f73 740a 6e61 6d65 2069 7320 616e 2049  ost.name is an I
│ │ │ │ +0001b4c0: 6e74 6572 6e65 7420 646f 6d61 696e 206e  nternet domain n
│ │ │ │ +0001b4d0: 616d 6520 6f72 2061 206d 756c 7469 2d63  ame or a multi-c
│ │ │ │ +0001b4e0: 6f6d 706f 6e65 6e74 206e 616d 6520 6f66  omponent name of
│ │ │ │ +0001b4f0: 2074 7970 650a 4e54 2d53 5256 2d58 4853   type.NT-SRV-XHS
│ │ │ │ +0001b500: 5420 6966 2074 6865 206e 616d 6520 6f66  T if the name of
│ │ │ │ +0001b510: 2074 6865 2068 6f73 7420 6973 206f 6620   the host is of 
│ │ │ │ +0001b520: 6120 666f 726d 2073 7563 6820 6173 2058  a form such as X
│ │ │ │ +0001b530: 2e35 3030 2074 6861 740a 616c 6c6f 7773  .500 that.allows
│ │ │ │ +0001b540: 2073 6c61 7368 2028 2f29 2073 6570 6172   slash (/) separ
│ │ │ │ +0001b550: 6174 6f72 732e 2020 5468 6520 6669 7273  ators.  The firs
│ │ │ │ +0001b560: 7420 636f 6d70 6f6e 656e 7420 6f66 2074  t component of t
│ │ │ │ +0001b570: 6865 2074 776f 2d20 6f72 0a6d 756c 7469  he two- or.multi
│ │ │ │ +0001b580: 2d63 6f6d 706f 6e65 6e74 206e 616d 6520  -component name 
│ │ │ │ +0001b590: 7769 6c6c 2069 6465 6e74 6966 7920 7468  will identify th
│ │ │ │ +0001b5a0: 6520 7365 7276 6963 6520 616e 6420 7468  e service and th
│ │ │ │ +0001b5b0: 6520 6c61 7474 6572 2063 6f6d 706f 6e65  e latter compone
│ │ │ │ +0001b5c0: 6e74 730a 7769 6c6c 2069 6465 6e74 6966  nts.will identif
│ │ │ │ +0001b5d0: 7920 7468 6520 686f 7374 2e20 2057 6865  y the host.  Whe
│ │ │ │ +0001b5e0: 7265 2074 6865 206e 616d 6520 6f66 2074  re the name of t
│ │ │ │ +0001b5f0: 6865 2068 6f73 7420 6973 206e 6f74 2063  he host is not c
│ │ │ │ +0001b600: 6173 650a 7365 6e73 6974 6976 6520 2866  ase.sensitive (f
│ │ │ │ +0001b610: 6f72 2065 7861 6d70 6c65 2c20 7769 7468  or example, with
│ │ │ │ +0001b620: 2049 6e74 6572 6e65 7420 646f 6d61 696e   Internet domain
│ │ │ │ +0001b630: 206e 616d 6573 2920 7468 6520 6e61 6d65   names) the name
│ │ │ │ +0001b640: 206f 6620 7468 6520 686f 7374 0a4d 5553   of the host.MUS
│ │ │ │ +0001b650: 5420 6265 206c 6f77 6572 2063 6173 652e  T be lower case.
│ │ │ │ +0001b660: 2020 4966 2073 7065 6369 6669 6564 2062    If specified b
│ │ │ │ +0001b670: 7920 7468 6520 6170 706c 6963 6174 696f  y the applicatio
│ │ │ │ +0001b680: 6e20 7072 6f74 6f63 6f6c 2066 6f72 0a73  n protocol for.s
│ │ │ │ +0001b690: 6572 7669 6365 7320 7375 6368 2061 7320  ervices such as 
│ │ │ │ +0001b6a0: 7465 6c6e 6574 2061 6e64 2074 6865 2042  telnet and the B
│ │ │ │ +0001b6b0: 6572 6b65 6c65 7920 5220 636f 6d6d 616e  erkeley R comman
│ │ │ │ +0001b6c0: 6473 2077 6869 6368 2072 756e 2077 6974  ds which run wit
│ │ │ │ +0001b6d0: 680a 7379 7374 656d 2070 7269 7669 6c65  h.system privile
│ │ │ │ +0001b6e0: 6765 732c 2074 6865 2066 6972 7374 2063  ges, the first c
│ │ │ │ +0001b6f0: 6f6d 706f 6e65 6e74 204d 4159 2062 6520  omponent MAY be 
│ │ │ │ +0001b700: 7468 6520 7374 7269 6e67 2027 686f 7374  the string 'host
│ │ │ │ +0001b710: 2720 696e 7374 6561 640a 6f66 2061 2073  ' instead.of a s
│ │ │ │ +0001b720: 6572 7669 6365 2073 7065 6369 6669 6320  ervice specific 
│ │ │ │ +0001b730: 6964 656e 7469 6669 6572 2e0a 0a34 2e33  identifier...4.3
│ │ │ │ +0001b740: 2e32 2e32 204e 616d 6520 6f66 2074 6865  .2.2 Name of the
│ │ │ │ +0001b750: 2054 4753 0a2e 2e2e 2e2e 2e2e 2e2e 2e2e   TGS............
│ │ │ │ +0001b760: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 0a0a 5468  ..............Th
│ │ │ │ +0001b770: 6520 7072 696e 6369 7061 6c20 6964 656e  e principal iden
│ │ │ │ +0001b780: 7469 6669 6572 206f 6620 7468 6520 7469  tifier of the ti
│ │ │ │ +0001b790: 636b 6574 2d67 7261 6e74 696e 6720 7365  cket-granting se
│ │ │ │ +0001b7a0: 7276 6963 6520 7368 616c 6c20 6265 0a63  rvice shall be.c
│ │ │ │ +0001b7b0: 6f6d 706f 7365 6420 6f66 2074 6872 6565  omposed of three
│ │ │ │ +0001b7c0: 2070 6172 7473 3a20 2831 2920 7468 6520   parts: (1) the 
│ │ │ │ +0001b7d0: 7265 616c 6d20 6f66 2074 6865 204b 4443  realm of the KDC
│ │ │ │ +0001b7e0: 2069 7373 7569 6e67 2074 6865 2054 4753   issuing the TGS
│ │ │ │ +0001b7f0: 2074 6963 6b65 740a 2832 2920 6120 7477   ticket.(2) a tw
│ │ │ │ +0001b800: 6f2d 7061 7274 206e 616d 6520 6f66 2074  o-part name of t
│ │ │ │ +0001b810: 7970 6520 4e54 2d53 5256 2d49 4e53 542c  ype NT-SRV-INST,
│ │ │ │ +0001b820: 2077 6974 6820 7468 6520 6669 7273 7420   with the first 
│ │ │ │ +0001b830: 7061 7274 2022 6b72 6274 6774 220a 616e  part "krbtgt".an
│ │ │ │ +0001b840: 6420 7468 6520 7365 636f 6e64 2070 6172  d the second par
│ │ │ │ +0001b850: 7420 7468 6520 6e61 6d65 206f 6620 7468  t the name of th
│ │ │ │ +0001b860: 6520 7265 616c 6d20 7768 6963 6820 7769  e realm which wi
│ │ │ │ +0001b870: 6c6c 2061 6363 6570 7420 7468 650a 7469  ll accept the.ti
│ │ │ │ +0001b880: 636b 6574 2d67 7261 6e74 696e 6720 7469  cket-granting ti
│ │ │ │ +0001b890: 636b 6574 2e20 2046 6f72 2065 7861 6d70  cket.  For examp
│ │ │ │ +0001b8a0: 6c65 2c20 6120 7469 636b 6574 2d67 7261  le, a ticket-gra
│ │ │ │ +0001b8b0: 6e74 696e 6720 7469 636b 6574 2069 7373  nting ticket iss
│ │ │ │ +0001b8c0: 7565 6420 6279 0a74 6865 2041 5448 454e  ued by.the ATHEN
│ │ │ │ +0001b8d0: 412e 4d49 542e 4544 5520 7265 616c 6d20  A.MIT.EDU realm 
│ │ │ │ +0001b8e0: 746f 2062 6520 7573 6564 2074 6f20 6765  to be used to ge
│ │ │ │ +0001b8f0: 7420 7469 636b 6574 7320 6672 6f6d 2074  t tickets from t
│ │ │ │ +0001b900: 6865 0a41 5448 454e 412e 4d49 542e 4544  he.ATHENA.MIT.ED
│ │ │ │ +0001b910: 5520 4b44 4320 6861 7320 6120 7072 696e  U KDC has a prin
│ │ │ │ +0001b920: 6369 7061 6c20 6964 656e 7469 6669 6572  cipal identifier
│ │ │ │ +0001b930: 206f 6620 2241 5448 454e 412e 4d49 542e   of "ATHENA.MIT.
│ │ │ │ +0001b940: 4544 5522 0a28 7265 616c 6d29 2c20 2822  EDU".(realm), ("
│ │ │ │ +0001b950: 6b72 6274 6774 222c 2022 4154 4845 4e41  krbtgt", "ATHENA
│ │ │ │ +0001b960: 2e4d 4954 2e45 4455 2229 2028 6e61 6d65  .MIT.EDU") (name
│ │ │ │ +0001b970: 292e 2020 4120 7469 636b 6574 2d67 7261  ).  A ticket-gra
│ │ │ │ +0001b980: 6e74 696e 6720 7469 636b 6574 0a69 7373  nting ticket.iss
│ │ │ │ +0001b990: 7565 6420 6279 2074 6865 2041 5448 454e  ued by the ATHEN
│ │ │ │ +0001b9a0: 412e 4d49 542e 4544 5520 7265 616c 6d20  A.MIT.EDU realm 
│ │ │ │ +0001b9b0: 746f 2062 6520 7573 6564 2074 6f20 6765  to be used to ge
│ │ │ │ +0001b9c0: 7420 7469 636b 6574 7320 6672 6f6d 2074  t tickets from t
│ │ │ │ +0001b9d0: 6865 0a4d 4954 2e45 4455 2072 6561 6c6d  he.MIT.EDU realm
│ │ │ │ +0001b9e0: 2068 6173 2061 2070 7269 6e63 6970 616c   has a principal
│ │ │ │ +0001b9f0: 2069 6465 6e74 6966 6965 7220 6f66 2022   identifier of "
│ │ │ │ +0001ba00: 4154 4845 4e41 2e4d 4954 2e45 4455 2220  ATHENA.MIT.EDU" 
│ │ │ │ +0001ba10: 2872 6561 6c6d 292c 0a28 226b 7262 7467  (realm),.("krbtg
│ │ │ │ +0001ba20: 7422 2c20 224d 4954 2e45 4455 2229 2028  t", "MIT.EDU") (
│ │ │ │ +0001ba30: 6e61 6d65 292e 0a0a 342e 332e 3320 4368  name)...4.3.3 Ch
│ │ │ │ +0001ba40: 6f6f 7369 6e67 2061 2070 7269 6e63 6970  oosing a princip
│ │ │ │ +0001ba50: 616c 2077 6974 6820 7768 6963 6820 746f  al with which to
│ │ │ │ +0001ba60: 2063 6f6d 6d75 6e69 6361 7465 0a2d 2d2d   communicate.---
│ │ │ │  0001ba70: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │  0001ba80: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0001ba90: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -0001baa0: 0a54 6865 204b 6572 6265 726f 7320 7072  .The Kerberos pr
│ │ │ │ -0001bab0: 6f74 6f63 6f6c 2070 726f 7669 6465 7320  otocol provides 
│ │ │ │ -0001bac0: 7468 6520 6d65 616e 7320 666f 7220 7665  the means for ve
│ │ │ │ -0001bad0: 7269 6679 696e 6720 2873 7562 6a65 6374  rifying (subject
│ │ │ │ -0001bae0: 2074 6f20 7468 650a 6173 7375 6d70 7469   to the.assumpti
│ │ │ │ -0001baf0: 6f6e 7320 696e 202a 6e6f 7465 2045 6e76  ons in *note Env
│ │ │ │ -0001bb00: 6972 6f6e 6d65 6e74 616c 2041 7373 756d  ironmental Assum
│ │ │ │ -0001bb10: 7074 696f 6e73 3a3a 2920 7468 6174 2074  ptions::) that t
│ │ │ │ -0001bb20: 6865 2065 6e74 6974 7920 7769 7468 0a77  he entity with.w
│ │ │ │ -0001bb30: 6869 6368 206f 6e65 2063 6f6d 6d75 6e69  hich one communi
│ │ │ │ -0001bb40: 6361 7465 7320 6973 2074 6865 2073 616d  cates is the sam
│ │ │ │ -0001bb50: 6520 656e 7469 7479 2074 6861 7420 7761  e entity that wa
│ │ │ │ -0001bb60: 7320 7265 6769 7374 6572 6564 2077 6974  s registered wit
│ │ │ │ -0001bb70: 6820 7468 650a 4b44 4320 7573 696e 6720  h the.KDC using 
│ │ │ │ -0001bb80: 7468 6520 636c 6169 6d65 6420 6964 656e  the claimed iden
│ │ │ │ -0001bb90: 7469 7479 2028 7072 696e 6369 7061 6c20  tity (principal 
│ │ │ │ -0001bba0: 6e61 6d65 292e 2020 4974 2069 7320 7374  name).  It is st
│ │ │ │ -0001bbb0: 696c 6c20 6e65 6365 7373 6172 790a 746f  ill necessary.to
│ │ │ │ -0001bbc0: 2064 6574 6572 6d69 6e65 2077 6865 7468   determine wheth
│ │ │ │ -0001bbd0: 6572 2074 6861 7420 6964 656e 7469 7479  er that identity
│ │ │ │ -0001bbe0: 2063 6f72 7265 7370 6f6e 6473 2074 6f20   corresponds to 
│ │ │ │ -0001bbf0: 7468 6520 656e 7469 7479 2077 6974 6820  the entity with 
│ │ │ │ -0001bc00: 7768 6963 680a 6f6e 6520 696e 7465 6e64  which.one intend
│ │ │ │ -0001bc10: 7320 746f 2063 6f6d 6d75 6e69 6361 7465  s to communicate
│ │ │ │ -0001bc20: 2e0a 0a20 2020 5768 656e 2061 7070 726f  ...   When appro
│ │ │ │ -0001bc30: 7072 6961 7465 2064 6174 6120 6861 7320  priate data has 
│ │ │ │ -0001bc40: 6265 656e 2065 7863 6861 6e67 6564 2069  been exchanged i
│ │ │ │ -0001bc50: 6e20 6164 7661 6e63 652c 2074 6869 730a  n advance, this.
│ │ │ │ -0001bc60: 6465 7465 726d 696e 6174 696f 6e20 6d61  determination ma
│ │ │ │ -0001bc70: 7920 6265 2070 6572 666f 726d 6564 2073  y be performed s
│ │ │ │ -0001bc80: 796e 7461 6374 6963 616c 6c79 2062 7920  yntactically by 
│ │ │ │ -0001bc90: 7468 6520 6170 706c 6963 6174 696f 6e20  the application 
│ │ │ │ -0001bca0: 6261 7365 6420 6f6e 0a74 6865 2061 7070  based on.the app
│ │ │ │ -0001bcb0: 6c69 6361 7469 6f6e 2070 726f 746f 636f  lication protoco
│ │ │ │ -0001bcc0: 6c20 7370 6563 6966 6963 6174 696f 6e2c  l specification,
│ │ │ │ -0001bcd0: 2069 6e66 6f72 6d61 7469 6f6e 2070 726f   information pro
│ │ │ │ -0001bce0: 7669 6465 6420 6279 2074 6865 0a75 7365  vided by the.use
│ │ │ │ -0001bcf0: 722c 2061 6e64 2063 6f6e 6669 6775 7261  r, and configura
│ │ │ │ -0001bd00: 7469 6f6e 2066 696c 6573 2e20 2046 6f72  tion files.  For
│ │ │ │ -0001bd10: 2065 7861 6d70 6c65 2c20 7468 6520 7365   example, the se
│ │ │ │ -0001bd20: 7276 6572 2070 7269 6e63 6970 616c 206e  rver principal n
│ │ │ │ -0001bd30: 616d 650a 2869 6e63 6c75 6469 6e67 2072  ame.(including r
│ │ │ │ -0001bd40: 6561 6c6d 2920 666f 7220 6120 7465 6c6e  ealm) for a teln
│ │ │ │ -0001bd50: 6574 2073 6572 7665 7220 6d69 6768 7420  et server might 
│ │ │ │ -0001bd60: 6265 2064 6572 6976 6564 2066 726f 6d20  be derived from 
│ │ │ │ -0001bd70: 7468 6520 7573 6572 0a73 7065 6369 6669  the user.specifi
│ │ │ │ -0001bd80: 6564 2068 6f73 7420 6e61 6d65 2028 6672  ed host name (fr
│ │ │ │ -0001bd90: 6f6d 2074 6865 2074 656c 6e65 7420 636f  om the telnet co
│ │ │ │ -0001bda0: 6d6d 616e 6420 6c69 6e65 292c 2074 6865  mmand line), the
│ │ │ │ -0001bdb0: 2022 686f 7374 2f22 2070 7265 6669 780a   "host/" prefix.
│ │ │ │ -0001bdc0: 7370 6563 6966 6965 6420 696e 2074 6865  specified in the
│ │ │ │ -0001bdd0: 2061 7070 6c69 6361 7469 6f6e 2070 726f   application pro
│ │ │ │ -0001bde0: 746f 636f 6c20 7370 6563 6966 6963 6174  tocol specificat
│ │ │ │ -0001bdf0: 696f 6e2c 2061 6e64 2061 206d 6170 7069  ion, and a mappi
│ │ │ │ -0001be00: 6e67 2074 6f20 610a 4b65 7262 6572 6f73  ng to a.Kerberos
│ │ │ │ -0001be10: 2072 6561 6c6d 2064 6572 6976 6564 2073   realm derived s
│ │ │ │ -0001be20: 796e 7461 6374 6963 616c 6c79 2066 726f  yntactically fro
│ │ │ │ -0001be30: 6d20 7468 6520 646f 6d61 696e 2070 6172  m the domain par
│ │ │ │ -0001be40: 7420 6f66 2074 6865 0a73 7065 6369 6669  t of the.specifi
│ │ │ │ -0001be50: 6564 2068 6f73 746e 616d 6520 616e 6420  ed hostname and 
│ │ │ │ -0001be60: 696e 666f 726d 6174 696f 6e20 6672 6f6d  information from
│ │ │ │ -0001be70: 2074 6865 206c 6f63 616c 204b 6572 6265   the local Kerbe
│ │ │ │ -0001be80: 726f 7320 7265 616c 6d73 0a64 6174 6162  ros realms.datab
│ │ │ │ -0001be90: 6173 652e 0a0a 2020 204f 6e65 2063 616e  ase...   One can
│ │ │ │ -0001bea0: 2061 6c73 6f20 7265 6c79 206f 6e20 7472   also rely on tr
│ │ │ │ -0001beb0: 7573 7465 6420 7468 6972 6420 7061 7274  usted third part
│ │ │ │ -0001bec0: 6965 7320 746f 206d 616b 6520 7468 6973  ies to make this
│ │ │ │ -0001bed0: 0a64 6574 6572 6d69 6e61 7469 6f6e 2c20  .determination, 
│ │ │ │ -0001bee0: 6275 7420 6f6e 6c79 2077 6865 6e20 7468  but only when th
│ │ │ │ -0001bef0: 6520 6461 7461 206f 6274 6169 6e65 6420  e data obtained 
│ │ │ │ -0001bf00: 6672 6f6d 2074 6865 2074 6869 7264 2070  from the third p
│ │ │ │ -0001bf10: 6172 7479 2069 730a 7375 6974 6162 6c79  arty is.suitably
│ │ │ │ -0001bf20: 2069 6e74 6567 7269 7479 2070 726f 7465   integrity prote
│ │ │ │ -0001bf30: 6374 6564 2077 6869 6c65 2072 6573 6964  cted while resid
│ │ │ │ -0001bf40: 656e 7420 6f6e 2074 6865 2074 6869 7264  ent on the third
│ │ │ │ -0001bf50: 2070 6172 7479 2073 6572 7665 720a 616e   party server.an
│ │ │ │ -0001bf60: 6420 7768 656e 2074 7261 6e73 6d69 7474  d when transmitt
│ │ │ │ -0001bf70: 6564 2e20 2054 6875 732c 2066 6f72 2065  ed.  Thus, for e
│ │ │ │ -0001bf80: 7861 6d70 6c65 2c20 6f6e 6520 7368 6f75  xample, one shou
│ │ │ │ -0001bf90: 6c64 206e 6f74 2072 656c 7920 6f6e 2061  ld not rely on a
│ │ │ │ -0001bfa0: 6e0a 756e 7072 6f74 6563 7465 6420 646f  n.unprotected do
│ │ │ │ -0001bfb0: 6d61 696e 206e 616d 6520 7379 7374 656d  main name system
│ │ │ │ -0001bfc0: 2072 6563 6f72 6420 746f 206d 6170 2061   record to map a
│ │ │ │ -0001bfd0: 2068 6f73 7420 616c 6961 7320 746f 2074   host alias to t
│ │ │ │ -0001bfe0: 6865 2070 7269 6d61 7279 0a6e 616d 6520  he primary.name 
│ │ │ │ -0001bff0: 6f66 2061 2073 6572 7665 722c 2061 6363  of a server, acc
│ │ │ │ -0001c000: 6570 7469 6e67 2074 6865 2070 7269 6d61  epting the prima
│ │ │ │ -0001c010: 7279 206e 616d 6520 6173 2074 6865 2070  ry name as the p
│ │ │ │ -0001c020: 6172 7479 206f 6e65 2069 6e74 656e 6473  arty one intends
│ │ │ │ -0001c030: 2074 6f0a 636f 6e74 6163 742c 2073 696e   to.contact, sin
│ │ │ │ -0001c040: 6365 2061 6e20 6174 7461 636b 6572 2063  ce an attacker c
│ │ │ │ -0001c050: 616e 206d 6f64 6966 7920 7468 6520 6d61  an modify the ma
│ │ │ │ -0001c060: 7070 696e 6720 616e 6420 696d 7065 7273  pping and impers
│ │ │ │ -0001c070: 6f6e 6174 6520 7468 650a 7061 7274 7920  onate the.party 
│ │ │ │ -0001c080: 7769 7468 2077 6869 6368 206f 6e65 2069  with which one i
│ │ │ │ -0001c090: 6e74 656e 6465 6420 746f 2063 6f6d 6d75  ntended to commu
│ │ │ │ -0001c0a0: 6e69 6361 7465 2e0a 0a20 2020 496d 706c  nicate...   Impl
│ │ │ │ -0001c0b0: 656d 656e 7461 7469 6f6e 7320 6f66 204b  ementations of K
│ │ │ │ -0001c0c0: 6572 6265 726f 7320 616e 6420 7072 6f74  erberos and prot
│ │ │ │ -0001c0d0: 6f63 6f6c 7320 6261 7365 6420 6f6e 204b  ocols based on K
│ │ │ │ -0001c0e0: 6572 6265 726f 7320 4d55 5354 204e 4f54  erberos MUST NOT
│ │ │ │ -0001c0f0: 0a75 7365 2069 6e73 6563 7572 6520 444e  .use insecure DN
│ │ │ │ -0001c100: 5320 7175 6572 6965 7320 746f 2063 616e  S queries to can
│ │ │ │ -0001c110: 6f6e 6963 616c 697a 6520 7468 6520 686f  onicalize the ho
│ │ │ │ -0001c120: 7374 6e61 6d65 2063 6f6d 706f 6e65 6e74  stname component
│ │ │ │ -0001c130: 7320 6f66 2074 6865 0a73 6572 7669 6365  s of the.service
│ │ │ │ -0001c140: 2070 7269 6e63 6970 616c 206e 616d 6573   principal names
│ │ │ │ -0001c150: 2e20 2049 6e20 616e 2065 6e76 6972 6f6e  .  In an environ
│ │ │ │ -0001c160: 6d65 6e74 2077 6974 686f 7574 2073 6563  ment without sec
│ │ │ │ -0001c170: 7572 6520 6e61 6d65 2073 6572 7669 6365  ure name service
│ │ │ │ -0001c180: 2c0a 6170 706c 6963 6174 696f 6e20 6175  ,.application au
│ │ │ │ -0001c190: 7468 6f72 7320 4d41 5920 6170 7065 6e64  thors MAY append
│ │ │ │ -0001c1a0: 2061 2073 7461 7469 6361 6c6c 7920 636f   a statically co
│ │ │ │ -0001c1b0: 6e66 6967 7572 6564 2064 6f6d 6169 6e20  nfigured domain 
│ │ │ │ -0001c1c0: 6e61 6d65 2074 6f0a 756e 7175 616c 6966  name to.unqualif
│ │ │ │ -0001c1d0: 6965 6420 686f 7374 6e61 6d65 7320 6265  ied hostnames be
│ │ │ │ -0001c1e0: 666f 7265 2070 6173 7369 6e67 2074 6865  fore passing the
│ │ │ │ -0001c1f0: 206e 616d 6520 746f 2074 6865 2073 6563   name to the sec
│ │ │ │ -0001c200: 7572 6974 790a 6d65 6368 616e 6973 6d73  urity.mechanisms
│ │ │ │ -0001c210: 2c20 6275 7420 7368 6f75 6c64 2064 6f20  , but should do 
│ │ │ │ -0001c220: 6e6f 206d 6f72 6520 7468 616e 2074 6861  no more than tha
│ │ │ │ -0001c230: 742e 2020 5365 6375 7265 206e 616d 6520  t.  Secure name 
│ │ │ │ -0001c240: 7365 7276 6963 650a 6661 6369 6c69 7469  service.faciliti
│ │ │ │ -0001c250: 6573 2c20 6966 2061 7661 696c 6162 6c65  es, if available
│ │ │ │ -0001c260: 2c20 6d69 6768 7420 6265 2074 7275 7374  , might be trust
│ │ │ │ -0001c270: 6564 2066 6f72 2068 6f73 746e 616d 650a  ed for hostname.
│ │ │ │ -0001c280: 6361 6e6f 6e69 6361 6c69 7a61 7469 6f6e  canonicalization
│ │ │ │ -0001c290: 2c20 6275 7420 7375 6368 2063 616e 6f6e  , but such canon
│ │ │ │ -0001c2a0: 6963 616c 697a 6174 696f 6e20 6279 2074  icalization by t
│ │ │ │ -0001c2b0: 6865 2063 6c69 656e 7420 5348 4f55 4c44  he client SHOULD
│ │ │ │ -0001c2c0: 204e 4f54 2062 650a 7265 7175 6972 6564   NOT be.required
│ │ │ │ -0001c2d0: 2062 7920 4b44 4320 696d 706c 656d 656e   by KDC implemen
│ │ │ │ -0001c2e0: 7461 7469 6f6e 732e 0a0a 2020 2049 6d70  tations...   Imp
│ │ │ │ -0001c2f0: 6c65 6d65 6e74 6174 696f 6e20 6e6f 7465  lementation note
│ │ │ │ -0001c300: 3a20 4d61 6e79 2063 7572 7265 6e74 2069  : Many current i
│ │ │ │ -0001c310: 6d70 6c65 6d65 6e74 6174 696f 6e73 2064  mplementations d
│ │ │ │ -0001c320: 6f20 736f 6d65 2064 6567 7265 6520 6f66  o some degree of
│ │ │ │ -0001c330: 0a63 616e 6f6e 6963 616c 697a 6174 696f  .canonicalizatio
│ │ │ │ -0001c340: 6e20 6f66 2074 6865 2070 726f 7669 6465  n of the provide
│ │ │ │ -0001c350: 6420 7365 7276 6963 6520 6e61 6d65 2c20  d service name, 
│ │ │ │ -0001c360: 6f66 7465 6e20 7573 696e 6720 444e 5320  often using DNS 
│ │ │ │ -0001c370: 6576 656e 0a74 686f 7567 6820 6974 2063  even.though it c
│ │ │ │ -0001c380: 7265 6174 6573 2073 6563 7572 6974 7920  reates security 
│ │ │ │ -0001c390: 7072 6f62 6c65 6d73 2e20 2048 6f77 6576  problems.  Howev
│ │ │ │ -0001c3a0: 6572 2074 6865 7265 2069 7320 6e6f 2063  er there is no c
│ │ │ │ -0001c3b0: 6f6e 7369 7374 656e 6379 0a61 6d6f 6e67  onsistency.among
│ │ │ │ -0001c3c0: 2069 6d70 6c65 6d65 6e74 6174 696f 6e73   implementations
│ │ │ │ -0001c3d0: 2061 626f 7574 2077 6865 7468 6572 2074   about whether t
│ │ │ │ -0001c3e0: 6865 2073 6572 7669 6365 206e 616d 6520  he service name 
│ │ │ │ -0001c3f0: 6973 2063 6173 6520 666f 6c64 6564 2074  is case folded t
│ │ │ │ -0001c400: 6f0a 6c6f 7765 7220 6361 7365 206f 7220  o.lower case or 
│ │ │ │ -0001c410: 7768 6574 6865 7220 7265 7665 7273 6520  whether reverse 
│ │ │ │ -0001c420: 7265 736f 6c75 7469 6f6e 2069 7320 7573  resolution is us
│ │ │ │ -0001c430: 6564 2e20 2054 6f20 6d61 7869 6d69 7a65  ed.  To maximize
│ │ │ │ -0001c440: 0a69 6e74 6572 6f70 6572 6162 696c 6974  .interoperabilit
│ │ │ │ -0001c450: 7920 616e 6420 7365 6375 7269 7479 2c20  y and security, 
│ │ │ │ -0001c460: 6170 706c 6963 6174 696f 6e73 2053 484f  applications SHO
│ │ │ │ -0001c470: 554c 4420 7072 6f76 6964 6520 7365 6375  ULD provide secu
│ │ │ │ -0001c480: 7269 7479 0a6d 6563 6861 6e69 736d 7320  rity.mechanisms 
│ │ │ │ -0001c490: 7769 7468 206e 616d 6573 2077 6869 6368  with names which
│ │ │ │ -0001c4a0: 2072 6573 756c 7420 6672 6f6d 2066 6f6c   result from fol
│ │ │ │ -0001c4b0: 6469 6e67 2074 6865 2075 7365 722d 656e  ding the user-en
│ │ │ │ -0001c4c0: 7465 7265 6420 6e61 6d65 2074 6f0a 6c6f  tered name to.lo
│ │ │ │ -0001c4d0: 7765 7220 6361 7365 2c20 7769 7468 6f75  wer case, withou
│ │ │ │ -0001c4e0: 7420 7065 7266 6f72 6d69 6e67 2061 6e79  t performing any
│ │ │ │ -0001c4f0: 206f 7468 6572 206d 6f64 6966 6963 6174   other modificat
│ │ │ │ -0001c500: 696f 6e73 206f 720a 6361 6e6f 6e69 6361  ions or.canonica
│ │ │ │ -0001c510: 6c69 7a61 7469 6f6e 2e0a 0a34 2e33 2e34  lization...4.3.4
│ │ │ │ -0001c520: 2050 7269 6e63 6970 616c 204e 616d 6520   Principal Name 
│ │ │ │ -0001c530: 466f 726d 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  Form.-----------
│ │ │ │ -0001c540: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -0001c550: 5072 696e 6369 7061 6c20 6e61 6d65 7320  Principal names 
│ │ │ │ -0001c560: 636f 6e73 6973 7420 6f66 2061 2073 6571  consist of a seq
│ │ │ │ -0001c570: 7565 6e63 6520 6f66 2073 7472 696e 6773  uence of strings
│ │ │ │ -0001c580: 2c20 7768 6963 6820 6973 206f 6674 656e  , which is often
│ │ │ │ -0001c590: 2074 6564 696f 7573 0a74 6f20 7061 7273   tedious.to pars
│ │ │ │ -0001c5a0: 652e 2020 5468 6572 6566 6f72 2c20 5368  e.  Therefor, Sh
│ │ │ │ -0001c5b0: 6973 6869 206f 6674 656e 2075 7365 7320  ishi often uses 
│ │ │ │ -0001c5c0: 6120 2270 7269 6e74 6564 2220 666f 726d  a "printed" form
│ │ │ │ -0001c5d0: 206f 6620 7072 696e 6369 7061 6c0a 7768   of principal.wh
│ │ │ │ -0001c5e0: 6963 6820 656d 6265 6420 7468 6520 656e  ich embed the en
│ │ │ │ -0001c5f0: 7469 7265 2070 7269 6e63 6970 616c 206e  tire principal n
│ │ │ │ -0001c600: 616d 6520 7374 7269 6e67 2073 6571 7565  ame string seque
│ │ │ │ -0001c610: 6e63 652c 2061 6e64 206f 7074 696f 6e61  nce, and optiona
│ │ │ │ -0001c620: 6c6c 790a 616c 736f 2074 6865 2072 6561  lly.also the rea
│ │ │ │ -0001c630: 6c6d 2c20 696e 746f 206f 6e65 2073 7472  lm, into one str
│ │ │ │ -0001c640: 696e 672e 2020 5468 6520 666f 726d 6174  ing.  The format
│ │ │ │ -0001c650: 2069 7320 7461 6b65 6e20 6672 6f6d 2074   is taken from t
│ │ │ │ -0001c660: 6865 204b 6572 6265 726f 730a 3520 4753  he Kerberos.5 GS
│ │ │ │ -0001c670: 532d 4150 4920 6d65 6368 616e 6973 6d20  S-API mechanism 
│ │ │ │ -0001c680: 2852 4643 2031 3936 3429 2e0a 0a20 2020  (RFC 1964)...   
│ │ │ │ -0001c690: 5468 6520 656c 656d 656e 7473 2069 6e63  The elements inc
│ │ │ │ -0001c6a0: 6c75 6465 6420 7769 7468 696e 2074 6869  luded within thi
│ │ │ │ -0001c6b0: 7320 6e61 6d65 2072 6570 7265 7365 6e74  s name represent
│ │ │ │ -0001c6c0: 6174 696f 6e20 6172 6520 6173 2066 6f6c  ation are as fol
│ │ │ │ -0001c6d0: 6c6f 7773 2c0a 7072 6f63 6565 6469 6e67  lows,.proceeding
│ │ │ │ -0001c6e0: 2066 726f 6d20 7468 6520 6265 6769 6e6e   from the beginn
│ │ │ │ -0001c6f0: 696e 6720 6f66 2074 6865 2073 7472 696e  ing of the strin
│ │ │ │ -0001c700: 673a 0a0a 2020 312e 204f 6e65 206f 7220  g:..  1. One or 
│ │ │ │ -0001c710: 6d6f 7265 2070 7269 6e63 6970 616c 206e  more principal n
│ │ │ │ -0001c720: 616d 6520 636f 6d70 6f6e 656e 7473 3b20  ame components; 
│ │ │ │ -0001c730: 6966 206d 6f72 6520 7468 616e 206f 6e65  if more than one
│ │ │ │ -0001c740: 2070 7269 6e63 6970 616c 0a20 2020 2020   principal.     
│ │ │ │ -0001c750: 6e61 6d65 2063 6f6d 706f 6e65 6e74 2069  name component i
│ │ │ │ -0001c760: 7320 696e 636c 7564 6564 2c20 7468 6520  s included, the 
│ │ │ │ -0001c770: 636f 6d70 6f6e 656e 7473 2061 7265 2073  components are s
│ │ │ │ -0001c780: 6570 6172 6174 6564 2062 7920 272f 272e  eparated by '/'.
│ │ │ │ -0001c790: 0a20 2020 2020 4172 6269 7472 6172 7920  .     Arbitrary 
│ │ │ │ -0001c7a0: 6f63 7465 7473 206d 6179 2062 6520 696e  octets may be in
│ │ │ │ -0001c7b0: 636c 7564 6564 2077 6974 6869 6e20 7072  cluded within pr
│ │ │ │ -0001c7c0: 696e 6369 7061 6c20 6e61 6d65 2063 6f6d  incipal name com
│ │ │ │ -0001c7d0: 706f 6e65 6e74 732c 0a20 2020 2020 7769  ponents,.     wi
│ │ │ │ -0001c7e0: 7468 2074 6865 2066 6f6c 6c6f 7769 6e67  th the following
│ │ │ │ -0001c7f0: 2063 6f6e 7374 7261 696e 7473 2061 6e64   constraints and
│ │ │ │ -0001c800: 2073 7065 6369 616c 2063 6f6e 7369 6465   special conside
│ │ │ │ -0001c810: 7261 7469 6f6e 733a 0a20 2020 2020 2020  rations:.       
│ │ │ │ -0001c820: 612e 2041 6e79 206f 6363 7572 7265 6e63  a. Any occurrenc
│ │ │ │ -0001c830: 6520 6f66 2074 6865 2063 6861 7261 6374  e of the charact
│ │ │ │ -0001c840: 6572 7320 2740 2720 6f72 2027 2f27 2077  ers '@' or '/' w
│ │ │ │ -0001c850: 6974 6869 6e20 6120 6e61 6d65 0a20 2020  ithin a name.   
│ │ │ │ -0001c860: 2020 2020 2020 2063 6f6d 706f 6e65 6e74         component
│ │ │ │ -0001c870: 206d 7573 7420 6265 2069 6d6d 6564 6961   must be immedia
│ │ │ │ -0001c880: 7465 6c79 2070 7265 6365 6465 6420 6279  tely preceded by
│ │ │ │ -0001c890: 2074 6865 2027 5c27 2071 756f 7469 6e67   the '\' quoting
│ │ │ │ -0001c8a0: 0a20 2020 2020 2020 2020 2063 6861 7261  .          chara
│ │ │ │ -0001c8b0: 6374 6572 2c20 746f 2070 7265 7665 6e74  cter, to prevent
│ │ │ │ -0001c8c0: 2069 6e74 6572 7072 6574 6174 696f 6e20   interpretation 
│ │ │ │ -0001c8d0: 6173 2061 2063 6f6d 706f 6e65 6e74 206f  as a component o
│ │ │ │ -0001c8e0: 7220 7265 616c 6d0a 2020 2020 2020 2020  r realm.        
│ │ │ │ -0001c8f0: 2020 7365 7061 7261 746f 722e 0a20 2020    separator..   
│ │ │ │ -0001c900: 2020 2020 622e 2054 6865 2041 5343 4949      b. The ASCII
│ │ │ │ -0001c910: 206e 6577 6c69 6e65 2c20 7461 622c 2062   newline, tab, b
│ │ │ │ -0001c920: 6163 6b73 7061 6365 2c20 616e 6420 6e75  ackspace, and nu
│ │ │ │ -0001c930: 6c6c 2063 6861 7261 6374 6572 7320 6d61  ll characters ma
│ │ │ │ -0001c940: 790a 2020 2020 2020 2020 2020 6f63 6375  y.          occu
│ │ │ │ -0001c950: 7220 6469 7265 6374 6c79 2077 6974 6869  r directly withi
│ │ │ │ -0001c960: 6e20 7468 6520 636f 6d70 6f6e 656e 7420  n the component 
│ │ │ │ -0001c970: 6f72 206d 6179 2062 6520 7265 7072 6573  or may be repres
│ │ │ │ -0001c980: 656e 7465 642c 0a20 2020 2020 2020 2020  ented,.         
│ │ │ │ -0001c990: 2072 6573 7065 6374 6976 656c 792c 2062   respectively, b
│ │ │ │ -0001c9a0: 7920 275c 6e27 2c20 275c 7427 2c20 275c  y '\n', '\t', '\
│ │ │ │ -0001c9b0: 6227 2c20 6f72 2027 5c30 272e 0a20 2020  b', or '\0'..   
│ │ │ │ -0001c9c0: 2020 2020 632e 2049 6620 7468 6520 275c      c. If the '\
│ │ │ │ -0001c9d0: 2720 7175 6f74 696e 6720 6368 6172 6163  ' quoting charac
│ │ │ │ -0001c9e0: 7465 7220 6f63 6375 7273 206f 7574 7369  ter occurs outsi
│ │ │ │ -0001c9f0: 6465 2074 6865 2063 6f6e 7465 7874 730a  de the contexts.
│ │ │ │ -0001ca00: 2020 2020 2020 2020 2020 6465 7363 7269            descri
│ │ │ │ -0001ca10: 6265 6420 696e 2028 3161 2920 616e 6420  bed in (1a) and 
│ │ │ │ -0001ca20: 2831 6229 2061 626f 7665 2c20 7468 6520  (1b) above, the 
│ │ │ │ -0001ca30: 666f 6c6c 6f77 696e 6720 6368 6172 6163  following charac
│ │ │ │ -0001ca40: 7465 7220 6973 0a20 2020 2020 2020 2020  ter is.         
│ │ │ │ -0001ca50: 2069 6e74 6572 7072 6574 6564 206c 6974   interpreted lit
│ │ │ │ -0001ca60: 6572 616c 6c79 2e20 2041 7320 6120 7370  erally.  As a sp
│ │ │ │ -0001ca70: 6563 6961 6c20 6361 7365 2c20 7468 6973  ecial case, this
│ │ │ │ -0001ca80: 2061 6c6c 6f77 7320 7468 650a 2020 2020   allows the.    
│ │ │ │ -0001ca90: 2020 2020 2020 646f 7562 6c65 6420 7265        doubled re
│ │ │ │ -0001caa0: 7072 6573 656e 7461 7469 6f6e 2027 5c5c  presentation '\\
│ │ │ │ -0001cab0: 2720 746f 2072 6570 7265 7365 6e74 2061  ' to represent a
│ │ │ │ -0001cac0: 2073 696e 676c 6520 6f63 6375 7272 656e   single occurren
│ │ │ │ -0001cad0: 6365 0a20 2020 2020 2020 2020 206f 6620  ce.          of 
│ │ │ │ -0001cae0: 7468 6520 7175 6f74 696e 6720 6368 6172  the quoting char
│ │ │ │ -0001caf0: 6163 7465 722e 0a20 2020 2020 2020 642e  acter..       d.
│ │ │ │ -0001cb00: 2041 6e20 6f63 6375 7272 656e 6365 206f   An occurrence o
│ │ │ │ -0001cb10: 6620 7468 6520 275c 2720 7175 6f74 696e  f the '\' quotin
│ │ │ │ -0001cb20: 6720 6368 6172 6163 7465 7220 6173 2074  g character as t
│ │ │ │ -0001cb30: 6865 206c 6173 740a 2020 2020 2020 2020  he last.        
│ │ │ │ -0001cb40: 2020 6368 6172 6163 7465 7220 6f66 2061    character of a
│ │ │ │ -0001cb50: 2063 6f6d 706f 6e65 6e74 2069 7320 696c   component is il
│ │ │ │ -0001cb60: 6c65 6761 6c2e 0a20 2032 2e20 4f70 7469  legal..  2. Opti
│ │ │ │ -0001cb70: 6f6e 616c 6c79 2c20 6120 2740 2720 6368  onally, a '@' ch
│ │ │ │ -0001cb80: 6172 6163 7465 722c 2073 6967 6e69 6679  aracter, signify
│ │ │ │ -0001cb90: 696e 6720 7468 6174 2061 2072 6561 6c6d  ing that a realm
│ │ │ │ -0001cba0: 206e 616d 650a 2020 2020 2069 6d6d 6564   name.     immed
│ │ │ │ -0001cbb0: 6961 7465 6c79 2066 6f6c 6c6f 7773 2e20  iately follows. 
│ │ │ │ -0001cbc0: 2049 6620 6e6f 2072 6561 6c6d 206e 616d   If no realm nam
│ │ │ │ -0001cbd0: 6520 656c 656d 656e 7420 6973 2069 6e63  e element is inc
│ │ │ │ -0001cbe0: 6c75 6465 642c 2074 6865 0a20 2020 2020  luded, the.     
│ │ │ │ -0001cbf0: 6c6f 6361 6c20 7265 616c 6d20 6e61 6d65  local realm name
│ │ │ │ -0001cc00: 2069 7320 6173 7375 6d65 642e 2020 5468   is assumed.  Th
│ │ │ │ -0001cc10: 6520 272f 2720 2c20 273a 272c 2061 6e64  e '/' , ':', and
│ │ │ │ -0001cc20: 206e 756c 6c20 6368 6172 6163 7465 7273   null characters
│ │ │ │ -0001cc30: 0a20 2020 2020 6d61 7920 6e6f 7420 6f63  .     may not oc
│ │ │ │ -0001cc40: 6375 7220 7769 7468 696e 2061 2072 6561  cur within a rea
│ │ │ │ -0001cc50: 6c6d 206e 616d 653b 2074 6865 2027 4027  lm name; the '@'
│ │ │ │ -0001cc60: 2c20 6e65 776c 696e 652c 2074 6162 2c20  , newline, tab, 
│ │ │ │ -0001cc70: 616e 640a 2020 2020 2062 6163 6b73 7061  and.     backspa
│ │ │ │ -0001cc80: 6365 2063 6861 7261 6374 6572 7320 6d61  ce characters ma
│ │ │ │ -0001cc90: 7920 6265 2069 6e63 6c75 6465 6420 7573  y be included us
│ │ │ │ -0001cca0: 696e 6720 7468 6520 7175 6f74 696e 6720  ing the quoting 
│ │ │ │ -0001ccb0: 636f 6e76 656e 7469 6f6e 730a 2020 2020  conventions.    
│ │ │ │ -0001ccc0: 2064 6573 6372 6962 6564 2069 6e20 2831   described in (1
│ │ │ │ -0001ccd0: 6129 2c20 2831 6229 2c20 616e 6420 2831  a), (1b), and (1
│ │ │ │ -0001cce0: 6329 2061 626f 7665 2e0a 0a1f 0a46 696c  c) above.....Fil
│ │ │ │ -0001ccf0: 653a 2073 6869 7368 692e 696e 666f 2c20  e: shishi.info, 
│ │ │ │ -0001cd00: 204e 6f64 653a 2053 6869 7368 6920 436f   Node: Shishi Co
│ │ │ │ -0001cd10: 6e66 6967 7572 6174 696f 6e2c 2020 4e65  nfiguration,  Ne
│ │ │ │ -0001cd20: 7874 3a20 5368 6973 6120 436f 6e66 6967  xt: Shisa Config
│ │ │ │ -0001cd30: 7572 6174 696f 6e2c 2020 5072 6576 3a20  uration,  Prev: 
│ │ │ │ -0001cd40: 5265 616c 6d20 616e 6420 5072 696e 6369  Realm and Princi
│ │ │ │ -0001cd50: 7061 6c20 4e61 6d69 6e67 2c20 2055 703a  pal Naming,  Up:
│ │ │ │ -0001cd60: 2052 6566 6572 656e 6365 204d 616e 7561   Reference Manua
│ │ │ │ -0001cd70: 6c0a 0a34 2e34 2053 6869 7368 6920 436f  l..4.4 Shishi Co
│ │ │ │ -0001cd80: 6e66 6967 7572 6174 696f 6e0a 3d3d 3d3d  nfiguration.====
│ │ │ │ +0001ba90: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +0001baa0: 2d0a 0a54 6865 204b 6572 6265 726f 7320  -..The Kerberos 
│ │ │ │ +0001bab0: 7072 6f74 6f63 6f6c 2070 726f 7669 6465  protocol provide
│ │ │ │ +0001bac0: 7320 7468 6520 6d65 616e 7320 666f 7220  s the means for 
│ │ │ │ +0001bad0: 7665 7269 6679 696e 6720 2873 7562 6a65  verifying (subje
│ │ │ │ +0001bae0: 6374 2074 6f20 7468 650a 6173 7375 6d70  ct to the.assump
│ │ │ │ +0001baf0: 7469 6f6e 7320 696e 202a 6e6f 7465 2045  tions in *note E
│ │ │ │ +0001bb00: 6e76 6972 6f6e 6d65 6e74 616c 2041 7373  nvironmental Ass
│ │ │ │ +0001bb10: 756d 7074 696f 6e73 3a3a 2920 7468 6174  umptions::) that
│ │ │ │ +0001bb20: 2074 6865 2065 6e74 6974 7920 7769 7468   the entity with
│ │ │ │ +0001bb30: 0a77 6869 6368 206f 6e65 2063 6f6d 6d75  .which one commu
│ │ │ │ +0001bb40: 6e69 6361 7465 7320 6973 2074 6865 2073  nicates is the s
│ │ │ │ +0001bb50: 616d 6520 656e 7469 7479 2074 6861 7420  ame entity that 
│ │ │ │ +0001bb60: 7761 7320 7265 6769 7374 6572 6564 2077  was registered w
│ │ │ │ +0001bb70: 6974 6820 7468 650a 4b44 4320 7573 696e  ith the.KDC usin
│ │ │ │ +0001bb80: 6720 7468 6520 636c 6169 6d65 6420 6964  g the claimed id
│ │ │ │ +0001bb90: 656e 7469 7479 2028 7072 696e 6369 7061  entity (principa
│ │ │ │ +0001bba0: 6c20 6e61 6d65 292e 2020 4974 2069 7320  l name).  It is 
│ │ │ │ +0001bbb0: 7374 696c 6c20 6e65 6365 7373 6172 790a  still necessary.
│ │ │ │ +0001bbc0: 746f 2064 6574 6572 6d69 6e65 2077 6865  to determine whe
│ │ │ │ +0001bbd0: 7468 6572 2074 6861 7420 6964 656e 7469  ther that identi
│ │ │ │ +0001bbe0: 7479 2063 6f72 7265 7370 6f6e 6473 2074  ty corresponds t
│ │ │ │ +0001bbf0: 6f20 7468 6520 656e 7469 7479 2077 6974  o the entity wit
│ │ │ │ +0001bc00: 6820 7768 6963 680a 6f6e 6520 696e 7465  h which.one inte
│ │ │ │ +0001bc10: 6e64 7320 746f 2063 6f6d 6d75 6e69 6361  nds to communica
│ │ │ │ +0001bc20: 7465 2e0a 0a20 2020 5768 656e 2061 7070  te...   When app
│ │ │ │ +0001bc30: 726f 7072 6961 7465 2064 6174 6120 6861  ropriate data ha
│ │ │ │ +0001bc40: 7320 6265 656e 2065 7863 6861 6e67 6564  s been exchanged
│ │ │ │ +0001bc50: 2069 6e20 6164 7661 6e63 652c 2074 6869   in advance, thi
│ │ │ │ +0001bc60: 730a 6465 7465 726d 696e 6174 696f 6e20  s.determination 
│ │ │ │ +0001bc70: 6d61 7920 6265 2070 6572 666f 726d 6564  may be performed
│ │ │ │ +0001bc80: 2073 796e 7461 6374 6963 616c 6c79 2062   syntactically b
│ │ │ │ +0001bc90: 7920 7468 6520 6170 706c 6963 6174 696f  y the applicatio
│ │ │ │ +0001bca0: 6e20 6261 7365 6420 6f6e 0a74 6865 2061  n based on.the a
│ │ │ │ +0001bcb0: 7070 6c69 6361 7469 6f6e 2070 726f 746f  pplication proto
│ │ │ │ +0001bcc0: 636f 6c20 7370 6563 6966 6963 6174 696f  col specificatio
│ │ │ │ +0001bcd0: 6e2c 2069 6e66 6f72 6d61 7469 6f6e 2070  n, information p
│ │ │ │ +0001bce0: 726f 7669 6465 6420 6279 2074 6865 0a75  rovided by the.u
│ │ │ │ +0001bcf0: 7365 722c 2061 6e64 2063 6f6e 6669 6775  ser, and configu
│ │ │ │ +0001bd00: 7261 7469 6f6e 2066 696c 6573 2e20 2046  ration files.  F
│ │ │ │ +0001bd10: 6f72 2065 7861 6d70 6c65 2c20 7468 6520  or example, the 
│ │ │ │ +0001bd20: 7365 7276 6572 2070 7269 6e63 6970 616c  server principal
│ │ │ │ +0001bd30: 206e 616d 650a 2869 6e63 6c75 6469 6e67   name.(including
│ │ │ │ +0001bd40: 2072 6561 6c6d 2920 666f 7220 6120 7465   realm) for a te
│ │ │ │ +0001bd50: 6c6e 6574 2073 6572 7665 7220 6d69 6768  lnet server migh
│ │ │ │ +0001bd60: 7420 6265 2064 6572 6976 6564 2066 726f  t be derived fro
│ │ │ │ +0001bd70: 6d20 7468 6520 7573 6572 0a73 7065 6369  m the user.speci
│ │ │ │ +0001bd80: 6669 6564 2068 6f73 7420 6e61 6d65 2028  fied host name (
│ │ │ │ +0001bd90: 6672 6f6d 2074 6865 2074 656c 6e65 7420  from the telnet 
│ │ │ │ +0001bda0: 636f 6d6d 616e 6420 6c69 6e65 292c 2074  command line), t
│ │ │ │ +0001bdb0: 6865 2022 686f 7374 2f22 2070 7265 6669  he "host/" prefi
│ │ │ │ +0001bdc0: 780a 7370 6563 6966 6965 6420 696e 2074  x.specified in t
│ │ │ │ +0001bdd0: 6865 2061 7070 6c69 6361 7469 6f6e 2070  he application p
│ │ │ │ +0001bde0: 726f 746f 636f 6c20 7370 6563 6966 6963  rotocol specific
│ │ │ │ +0001bdf0: 6174 696f 6e2c 2061 6e64 2061 206d 6170  ation, and a map
│ │ │ │ +0001be00: 7069 6e67 2074 6f20 610a 4b65 7262 6572  ping to a.Kerber
│ │ │ │ +0001be10: 6f73 2072 6561 6c6d 2064 6572 6976 6564  os realm derived
│ │ │ │ +0001be20: 2073 796e 7461 6374 6963 616c 6c79 2066   syntactically f
│ │ │ │ +0001be30: 726f 6d20 7468 6520 646f 6d61 696e 2070  rom the domain p
│ │ │ │ +0001be40: 6172 7420 6f66 2074 6865 0a73 7065 6369  art of the.speci
│ │ │ │ +0001be50: 6669 6564 2068 6f73 746e 616d 6520 616e  fied hostname an
│ │ │ │ +0001be60: 6420 696e 666f 726d 6174 696f 6e20 6672  d information fr
│ │ │ │ +0001be70: 6f6d 2074 6865 206c 6f63 616c 204b 6572  om the local Ker
│ │ │ │ +0001be80: 6265 726f 7320 7265 616c 6d73 0a64 6174  beros realms.dat
│ │ │ │ +0001be90: 6162 6173 652e 0a0a 2020 204f 6e65 2063  abase...   One c
│ │ │ │ +0001bea0: 616e 2061 6c73 6f20 7265 6c79 206f 6e20  an also rely on 
│ │ │ │ +0001beb0: 7472 7573 7465 6420 7468 6972 6420 7061  trusted third pa
│ │ │ │ +0001bec0: 7274 6965 7320 746f 206d 616b 6520 7468  rties to make th
│ │ │ │ +0001bed0: 6973 0a64 6574 6572 6d69 6e61 7469 6f6e  is.determination
│ │ │ │ +0001bee0: 2c20 6275 7420 6f6e 6c79 2077 6865 6e20  , but only when 
│ │ │ │ +0001bef0: 7468 6520 6461 7461 206f 6274 6169 6e65  the data obtaine
│ │ │ │ +0001bf00: 6420 6672 6f6d 2074 6865 2074 6869 7264  d from the third
│ │ │ │ +0001bf10: 2070 6172 7479 2069 730a 7375 6974 6162   party is.suitab
│ │ │ │ +0001bf20: 6c79 2069 6e74 6567 7269 7479 2070 726f  ly integrity pro
│ │ │ │ +0001bf30: 7465 6374 6564 2077 6869 6c65 2072 6573  tected while res
│ │ │ │ +0001bf40: 6964 656e 7420 6f6e 2074 6865 2074 6869  ident on the thi
│ │ │ │ +0001bf50: 7264 2070 6172 7479 2073 6572 7665 720a  rd party server.
│ │ │ │ +0001bf60: 616e 6420 7768 656e 2074 7261 6e73 6d69  and when transmi
│ │ │ │ +0001bf70: 7474 6564 2e20 2054 6875 732c 2066 6f72  tted.  Thus, for
│ │ │ │ +0001bf80: 2065 7861 6d70 6c65 2c20 6f6e 6520 7368   example, one sh
│ │ │ │ +0001bf90: 6f75 6c64 206e 6f74 2072 656c 7920 6f6e  ould not rely on
│ │ │ │ +0001bfa0: 2061 6e0a 756e 7072 6f74 6563 7465 6420   an.unprotected 
│ │ │ │ +0001bfb0: 646f 6d61 696e 206e 616d 6520 7379 7374  domain name syst
│ │ │ │ +0001bfc0: 656d 2072 6563 6f72 6420 746f 206d 6170  em record to map
│ │ │ │ +0001bfd0: 2061 2068 6f73 7420 616c 6961 7320 746f   a host alias to
│ │ │ │ +0001bfe0: 2074 6865 2070 7269 6d61 7279 0a6e 616d   the primary.nam
│ │ │ │ +0001bff0: 6520 6f66 2061 2073 6572 7665 722c 2061  e of a server, a
│ │ │ │ +0001c000: 6363 6570 7469 6e67 2074 6865 2070 7269  ccepting the pri
│ │ │ │ +0001c010: 6d61 7279 206e 616d 6520 6173 2074 6865  mary name as the
│ │ │ │ +0001c020: 2070 6172 7479 206f 6e65 2069 6e74 656e   party one inten
│ │ │ │ +0001c030: 6473 2074 6f0a 636f 6e74 6163 742c 2073  ds to.contact, s
│ │ │ │ +0001c040: 696e 6365 2061 6e20 6174 7461 636b 6572  ince an attacker
│ │ │ │ +0001c050: 2063 616e 206d 6f64 6966 7920 7468 6520   can modify the 
│ │ │ │ +0001c060: 6d61 7070 696e 6720 616e 6420 696d 7065  mapping and impe
│ │ │ │ +0001c070: 7273 6f6e 6174 6520 7468 650a 7061 7274  rsonate the.part
│ │ │ │ +0001c080: 7920 7769 7468 2077 6869 6368 206f 6e65  y with which one
│ │ │ │ +0001c090: 2069 6e74 656e 6465 6420 746f 2063 6f6d   intended to com
│ │ │ │ +0001c0a0: 6d75 6e69 6361 7465 2e0a 0a20 2020 496d  municate...   Im
│ │ │ │ +0001c0b0: 706c 656d 656e 7461 7469 6f6e 7320 6f66  plementations of
│ │ │ │ +0001c0c0: 204b 6572 6265 726f 7320 616e 6420 7072   Kerberos and pr
│ │ │ │ +0001c0d0: 6f74 6f63 6f6c 7320 6261 7365 6420 6f6e  otocols based on
│ │ │ │ +0001c0e0: 204b 6572 6265 726f 7320 4d55 5354 204e   Kerberos MUST N
│ │ │ │ +0001c0f0: 4f54 0a75 7365 2069 6e73 6563 7572 6520  OT.use insecure 
│ │ │ │ +0001c100: 444e 5320 7175 6572 6965 7320 746f 2063  DNS queries to c
│ │ │ │ +0001c110: 616e 6f6e 6963 616c 697a 6520 7468 6520  anonicalize the 
│ │ │ │ +0001c120: 686f 7374 6e61 6d65 2063 6f6d 706f 6e65  hostname compone
│ │ │ │ +0001c130: 6e74 7320 6f66 2074 6865 0a73 6572 7669  nts of the.servi
│ │ │ │ +0001c140: 6365 2070 7269 6e63 6970 616c 206e 616d  ce principal nam
│ │ │ │ +0001c150: 6573 2e20 2049 6e20 616e 2065 6e76 6972  es.  In an envir
│ │ │ │ +0001c160: 6f6e 6d65 6e74 2077 6974 686f 7574 2073  onment without s
│ │ │ │ +0001c170: 6563 7572 6520 6e61 6d65 2073 6572 7669  ecure name servi
│ │ │ │ +0001c180: 6365 2c0a 6170 706c 6963 6174 696f 6e20  ce,.application 
│ │ │ │ +0001c190: 6175 7468 6f72 7320 4d41 5920 6170 7065  authors MAY appe
│ │ │ │ +0001c1a0: 6e64 2061 2073 7461 7469 6361 6c6c 7920  nd a statically 
│ │ │ │ +0001c1b0: 636f 6e66 6967 7572 6564 2064 6f6d 6169  configured domai
│ │ │ │ +0001c1c0: 6e20 6e61 6d65 2074 6f0a 756e 7175 616c  n name to.unqual
│ │ │ │ +0001c1d0: 6966 6965 6420 686f 7374 6e61 6d65 7320  ified hostnames 
│ │ │ │ +0001c1e0: 6265 666f 7265 2070 6173 7369 6e67 2074  before passing t
│ │ │ │ +0001c1f0: 6865 206e 616d 6520 746f 2074 6865 2073  he name to the s
│ │ │ │ +0001c200: 6563 7572 6974 790a 6d65 6368 616e 6973  ecurity.mechanis
│ │ │ │ +0001c210: 6d73 2c20 6275 7420 7368 6f75 6c64 2064  ms, but should d
│ │ │ │ +0001c220: 6f20 6e6f 206d 6f72 6520 7468 616e 2074  o no more than t
│ │ │ │ +0001c230: 6861 742e 2020 5365 6375 7265 206e 616d  hat.  Secure nam
│ │ │ │ +0001c240: 6520 7365 7276 6963 650a 6661 6369 6c69  e service.facili
│ │ │ │ +0001c250: 7469 6573 2c20 6966 2061 7661 696c 6162  ties, if availab
│ │ │ │ +0001c260: 6c65 2c20 6d69 6768 7420 6265 2074 7275  le, might be tru
│ │ │ │ +0001c270: 7374 6564 2066 6f72 2068 6f73 746e 616d  sted for hostnam
│ │ │ │ +0001c280: 650a 6361 6e6f 6e69 6361 6c69 7a61 7469  e.canonicalizati
│ │ │ │ +0001c290: 6f6e 2c20 6275 7420 7375 6368 2063 616e  on, but such can
│ │ │ │ +0001c2a0: 6f6e 6963 616c 697a 6174 696f 6e20 6279  onicalization by
│ │ │ │ +0001c2b0: 2074 6865 2063 6c69 656e 7420 5348 4f55   the client SHOU
│ │ │ │ +0001c2c0: 4c44 204e 4f54 2062 650a 7265 7175 6972  LD NOT be.requir
│ │ │ │ +0001c2d0: 6564 2062 7920 4b44 4320 696d 706c 656d  ed by KDC implem
│ │ │ │ +0001c2e0: 656e 7461 7469 6f6e 732e 0a0a 2020 2049  entations...   I
│ │ │ │ +0001c2f0: 6d70 6c65 6d65 6e74 6174 696f 6e20 6e6f  mplementation no
│ │ │ │ +0001c300: 7465 3a20 4d61 6e79 2063 7572 7265 6e74  te: Many current
│ │ │ │ +0001c310: 2069 6d70 6c65 6d65 6e74 6174 696f 6e73   implementations
│ │ │ │ +0001c320: 2064 6f20 736f 6d65 2064 6567 7265 6520   do some degree 
│ │ │ │ +0001c330: 6f66 0a63 616e 6f6e 6963 616c 697a 6174  of.canonicalizat
│ │ │ │ +0001c340: 696f 6e20 6f66 2074 6865 2070 726f 7669  ion of the provi
│ │ │ │ +0001c350: 6465 6420 7365 7276 6963 6520 6e61 6d65  ded service name
│ │ │ │ +0001c360: 2c20 6f66 7465 6e20 7573 696e 6720 444e  , often using DN
│ │ │ │ +0001c370: 5320 6576 656e 0a74 686f 7567 6820 6974  S even.though it
│ │ │ │ +0001c380: 2063 7265 6174 6573 2073 6563 7572 6974   creates securit
│ │ │ │ +0001c390: 7920 7072 6f62 6c65 6d73 2e20 2048 6f77  y problems.  How
│ │ │ │ +0001c3a0: 6576 6572 2074 6865 7265 2069 7320 6e6f  ever there is no
│ │ │ │ +0001c3b0: 2063 6f6e 7369 7374 656e 6379 0a61 6d6f   consistency.amo
│ │ │ │ +0001c3c0: 6e67 2069 6d70 6c65 6d65 6e74 6174 696f  ng implementatio
│ │ │ │ +0001c3d0: 6e73 2061 626f 7574 2077 6865 7468 6572  ns about whether
│ │ │ │ +0001c3e0: 2074 6865 2073 6572 7669 6365 206e 616d   the service nam
│ │ │ │ +0001c3f0: 6520 6973 2063 6173 6520 666f 6c64 6564  e is case folded
│ │ │ │ +0001c400: 2074 6f0a 6c6f 7765 7220 6361 7365 206f   to.lower case o
│ │ │ │ +0001c410: 7220 7768 6574 6865 7220 7265 7665 7273  r whether revers
│ │ │ │ +0001c420: 6520 7265 736f 6c75 7469 6f6e 2069 7320  e resolution is 
│ │ │ │ +0001c430: 7573 6564 2e20 2054 6f20 6d61 7869 6d69  used.  To maximi
│ │ │ │ +0001c440: 7a65 0a69 6e74 6572 6f70 6572 6162 696c  ze.interoperabil
│ │ │ │ +0001c450: 6974 7920 616e 6420 7365 6375 7269 7479  ity and security
│ │ │ │ +0001c460: 2c20 6170 706c 6963 6174 696f 6e73 2053  , applications S
│ │ │ │ +0001c470: 484f 554c 4420 7072 6f76 6964 6520 7365  HOULD provide se
│ │ │ │ +0001c480: 6375 7269 7479 0a6d 6563 6861 6e69 736d  curity.mechanism
│ │ │ │ +0001c490: 7320 7769 7468 206e 616d 6573 2077 6869  s with names whi
│ │ │ │ +0001c4a0: 6368 2072 6573 756c 7420 6672 6f6d 2066  ch result from f
│ │ │ │ +0001c4b0: 6f6c 6469 6e67 2074 6865 2075 7365 722d  olding the user-
│ │ │ │ +0001c4c0: 656e 7465 7265 6420 6e61 6d65 2074 6f0a  entered name to.
│ │ │ │ +0001c4d0: 6c6f 7765 7220 6361 7365 2c20 7769 7468  lower case, with
│ │ │ │ +0001c4e0: 6f75 7420 7065 7266 6f72 6d69 6e67 2061  out performing a
│ │ │ │ +0001c4f0: 6e79 206f 7468 6572 206d 6f64 6966 6963  ny other modific
│ │ │ │ +0001c500: 6174 696f 6e73 206f 720a 6361 6e6f 6e69  ations or.canoni
│ │ │ │ +0001c510: 6361 6c69 7a61 7469 6f6e 2e0a 0a34 2e33  calization...4.3
│ │ │ │ +0001c520: 2e34 2050 7269 6e63 6970 616c 204e 616d  .4 Principal Nam
│ │ │ │ +0001c530: 6520 466f 726d 0a2d 2d2d 2d2d 2d2d 2d2d  e Form.---------
│ │ │ │ +0001c540: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +0001c550: 0a0a 5072 696e 6369 7061 6c20 6e61 6d65  ..Principal name
│ │ │ │ +0001c560: 7320 636f 6e73 6973 7420 6f66 2061 2073  s consist of a s
│ │ │ │ +0001c570: 6571 7565 6e63 6520 6f66 2073 7472 696e  equence of strin
│ │ │ │ +0001c580: 6773 2c20 7768 6963 6820 6973 206f 6674  gs, which is oft
│ │ │ │ +0001c590: 656e 2074 6564 696f 7573 0a74 6f20 7061  en tedious.to pa
│ │ │ │ +0001c5a0: 7273 652e 2020 5468 6572 6566 6f72 2c20  rse.  Therefor, 
│ │ │ │ +0001c5b0: 5368 6973 6869 206f 6674 656e 2075 7365  Shishi often use
│ │ │ │ +0001c5c0: 7320 6120 2270 7269 6e74 6564 2220 666f  s a "printed" fo
│ │ │ │ +0001c5d0: 726d 206f 6620 7072 696e 6369 7061 6c0a  rm of principal.
│ │ │ │ +0001c5e0: 7768 6963 6820 656d 6265 6420 7468 6520  which embed the 
│ │ │ │ +0001c5f0: 656e 7469 7265 2070 7269 6e63 6970 616c  entire principal
│ │ │ │ +0001c600: 206e 616d 6520 7374 7269 6e67 2073 6571   name string seq
│ │ │ │ +0001c610: 7565 6e63 652c 2061 6e64 206f 7074 696f  uence, and optio
│ │ │ │ +0001c620: 6e61 6c6c 790a 616c 736f 2074 6865 2072  nally.also the r
│ │ │ │ +0001c630: 6561 6c6d 2c20 696e 746f 206f 6e65 2073  ealm, into one s
│ │ │ │ +0001c640: 7472 696e 672e 2020 5468 6520 666f 726d  tring.  The form
│ │ │ │ +0001c650: 6174 2069 7320 7461 6b65 6e20 6672 6f6d  at is taken from
│ │ │ │ +0001c660: 2074 6865 204b 6572 6265 726f 730a 3520   the Kerberos.5 
│ │ │ │ +0001c670: 4753 532d 4150 4920 6d65 6368 616e 6973  GSS-API mechanis
│ │ │ │ +0001c680: 6d20 2852 4643 2031 3936 3429 2e0a 0a20  m (RFC 1964)... 
│ │ │ │ +0001c690: 2020 5468 6520 656c 656d 656e 7473 2069    The elements i
│ │ │ │ +0001c6a0: 6e63 6c75 6465 6420 7769 7468 696e 2074  ncluded within t
│ │ │ │ +0001c6b0: 6869 7320 6e61 6d65 2072 6570 7265 7365  his name represe
│ │ │ │ +0001c6c0: 6e74 6174 696f 6e20 6172 6520 6173 2066  ntation are as f
│ │ │ │ +0001c6d0: 6f6c 6c6f 7773 2c0a 7072 6f63 6565 6469  ollows,.proceedi
│ │ │ │ +0001c6e0: 6e67 2066 726f 6d20 7468 6520 6265 6769  ng from the begi
│ │ │ │ +0001c6f0: 6e6e 696e 6720 6f66 2074 6865 2073 7472  nning of the str
│ │ │ │ +0001c700: 696e 673a 0a0a 2020 312e 204f 6e65 206f  ing:..  1. One o
│ │ │ │ +0001c710: 7220 6d6f 7265 2070 7269 6e63 6970 616c  r more principal
│ │ │ │ +0001c720: 206e 616d 6520 636f 6d70 6f6e 656e 7473   name components
│ │ │ │ +0001c730: 3b20 6966 206d 6f72 6520 7468 616e 206f  ; if more than o
│ │ │ │ +0001c740: 6e65 2070 7269 6e63 6970 616c 0a20 2020  ne principal.   
│ │ │ │ +0001c750: 2020 6e61 6d65 2063 6f6d 706f 6e65 6e74    name component
│ │ │ │ +0001c760: 2069 7320 696e 636c 7564 6564 2c20 7468   is included, th
│ │ │ │ +0001c770: 6520 636f 6d70 6f6e 656e 7473 2061 7265  e components are
│ │ │ │ +0001c780: 2073 6570 6172 6174 6564 2062 7920 272f   separated by '/
│ │ │ │ +0001c790: 272e 0a20 2020 2020 4172 6269 7472 6172  '..     Arbitrar
│ │ │ │ +0001c7a0: 7920 6f63 7465 7473 206d 6179 2062 6520  y octets may be 
│ │ │ │ +0001c7b0: 696e 636c 7564 6564 2077 6974 6869 6e20  included within 
│ │ │ │ +0001c7c0: 7072 696e 6369 7061 6c20 6e61 6d65 2063  principal name c
│ │ │ │ +0001c7d0: 6f6d 706f 6e65 6e74 732c 0a20 2020 2020  omponents,.     
│ │ │ │ +0001c7e0: 7769 7468 2074 6865 2066 6f6c 6c6f 7769  with the followi
│ │ │ │ +0001c7f0: 6e67 2063 6f6e 7374 7261 696e 7473 2061  ng constraints a
│ │ │ │ +0001c800: 6e64 2073 7065 6369 616c 2063 6f6e 7369  nd special consi
│ │ │ │ +0001c810: 6465 7261 7469 6f6e 733a 0a20 2020 2020  derations:.     
│ │ │ │ +0001c820: 2020 612e 2041 6e79 206f 6363 7572 7265    a. Any occurre
│ │ │ │ +0001c830: 6e63 6520 6f66 2074 6865 2063 6861 7261  nce of the chara
│ │ │ │ +0001c840: 6374 6572 7320 2740 2720 6f72 2027 2f27  cters '@' or '/'
│ │ │ │ +0001c850: 2077 6974 6869 6e20 6120 6e61 6d65 0a20   within a name. 
│ │ │ │ +0001c860: 2020 2020 2020 2020 2063 6f6d 706f 6e65           compone
│ │ │ │ +0001c870: 6e74 206d 7573 7420 6265 2069 6d6d 6564  nt must be immed
│ │ │ │ +0001c880: 6961 7465 6c79 2070 7265 6365 6465 6420  iately preceded 
│ │ │ │ +0001c890: 6279 2074 6865 2027 5c27 2071 756f 7469  by the '\' quoti
│ │ │ │ +0001c8a0: 6e67 0a20 2020 2020 2020 2020 2063 6861  ng.          cha
│ │ │ │ +0001c8b0: 7261 6374 6572 2c20 746f 2070 7265 7665  racter, to preve
│ │ │ │ +0001c8c0: 6e74 2069 6e74 6572 7072 6574 6174 696f  nt interpretatio
│ │ │ │ +0001c8d0: 6e20 6173 2061 2063 6f6d 706f 6e65 6e74  n as a component
│ │ │ │ +0001c8e0: 206f 7220 7265 616c 6d0a 2020 2020 2020   or realm.      
│ │ │ │ +0001c8f0: 2020 2020 7365 7061 7261 746f 722e 0a20      separator.. 
│ │ │ │ +0001c900: 2020 2020 2020 622e 2054 6865 2041 5343        b. The ASC
│ │ │ │ +0001c910: 4949 206e 6577 6c69 6e65 2c20 7461 622c  II newline, tab,
│ │ │ │ +0001c920: 2062 6163 6b73 7061 6365 2c20 616e 6420   backspace, and 
│ │ │ │ +0001c930: 6e75 6c6c 2063 6861 7261 6374 6572 7320  null characters 
│ │ │ │ +0001c940: 6d61 790a 2020 2020 2020 2020 2020 6f63  may.          oc
│ │ │ │ +0001c950: 6375 7220 6469 7265 6374 6c79 2077 6974  cur directly wit
│ │ │ │ +0001c960: 6869 6e20 7468 6520 636f 6d70 6f6e 656e  hin the componen
│ │ │ │ +0001c970: 7420 6f72 206d 6179 2062 6520 7265 7072  t or may be repr
│ │ │ │ +0001c980: 6573 656e 7465 642c 0a20 2020 2020 2020  esented,.       
│ │ │ │ +0001c990: 2020 2072 6573 7065 6374 6976 656c 792c     respectively,
│ │ │ │ +0001c9a0: 2062 7920 275c 6e27 2c20 275c 7427 2c20   by '\n', '\t', 
│ │ │ │ +0001c9b0: 275c 6227 2c20 6f72 2027 5c30 272e 0a20  '\b', or '\0'.. 
│ │ │ │ +0001c9c0: 2020 2020 2020 632e 2049 6620 7468 6520        c. If the 
│ │ │ │ +0001c9d0: 275c 2720 7175 6f74 696e 6720 6368 6172  '\' quoting char
│ │ │ │ +0001c9e0: 6163 7465 7220 6f63 6375 7273 206f 7574  acter occurs out
│ │ │ │ +0001c9f0: 7369 6465 2074 6865 2063 6f6e 7465 7874  side the context
│ │ │ │ +0001ca00: 730a 2020 2020 2020 2020 2020 6465 7363  s.          desc
│ │ │ │ +0001ca10: 7269 6265 6420 696e 2028 3161 2920 616e  ribed in (1a) an
│ │ │ │ +0001ca20: 6420 2831 6229 2061 626f 7665 2c20 7468  d (1b) above, th
│ │ │ │ +0001ca30: 6520 666f 6c6c 6f77 696e 6720 6368 6172  e following char
│ │ │ │ +0001ca40: 6163 7465 7220 6973 0a20 2020 2020 2020  acter is.       
│ │ │ │ +0001ca50: 2020 2069 6e74 6572 7072 6574 6564 206c     interpreted l
│ │ │ │ +0001ca60: 6974 6572 616c 6c79 2e20 2041 7320 6120  iterally.  As a 
│ │ │ │ +0001ca70: 7370 6563 6961 6c20 6361 7365 2c20 7468  special case, th
│ │ │ │ +0001ca80: 6973 2061 6c6c 6f77 7320 7468 650a 2020  is allows the.  
│ │ │ │ +0001ca90: 2020 2020 2020 2020 646f 7562 6c65 6420          doubled 
│ │ │ │ +0001caa0: 7265 7072 6573 656e 7461 7469 6f6e 2027  representation '
│ │ │ │ +0001cab0: 5c5c 2720 746f 2072 6570 7265 7365 6e74  \\' to represent
│ │ │ │ +0001cac0: 2061 2073 696e 676c 6520 6f63 6375 7272   a single occurr
│ │ │ │ +0001cad0: 656e 6365 0a20 2020 2020 2020 2020 206f  ence.          o
│ │ │ │ +0001cae0: 6620 7468 6520 7175 6f74 696e 6720 6368  f the quoting ch
│ │ │ │ +0001caf0: 6172 6163 7465 722e 0a20 2020 2020 2020  aracter..       
│ │ │ │ +0001cb00: 642e 2041 6e20 6f63 6375 7272 656e 6365  d. An occurrence
│ │ │ │ +0001cb10: 206f 6620 7468 6520 275c 2720 7175 6f74   of the '\' quot
│ │ │ │ +0001cb20: 696e 6720 6368 6172 6163 7465 7220 6173  ing character as
│ │ │ │ +0001cb30: 2074 6865 206c 6173 740a 2020 2020 2020   the last.      
│ │ │ │ +0001cb40: 2020 2020 6368 6172 6163 7465 7220 6f66      character of
│ │ │ │ +0001cb50: 2061 2063 6f6d 706f 6e65 6e74 2069 7320   a component is 
│ │ │ │ +0001cb60: 696c 6c65 6761 6c2e 0a20 2032 2e20 4f70  illegal..  2. Op
│ │ │ │ +0001cb70: 7469 6f6e 616c 6c79 2c20 6120 2740 2720  tionally, a '@' 
│ │ │ │ +0001cb80: 6368 6172 6163 7465 722c 2073 6967 6e69  character, signi
│ │ │ │ +0001cb90: 6679 696e 6720 7468 6174 2061 2072 6561  fying that a rea
│ │ │ │ +0001cba0: 6c6d 206e 616d 650a 2020 2020 2069 6d6d  lm name.     imm
│ │ │ │ +0001cbb0: 6564 6961 7465 6c79 2066 6f6c 6c6f 7773  ediately follows
│ │ │ │ +0001cbc0: 2e20 2049 6620 6e6f 2072 6561 6c6d 206e  .  If no realm n
│ │ │ │ +0001cbd0: 616d 6520 656c 656d 656e 7420 6973 2069  ame element is i
│ │ │ │ +0001cbe0: 6e63 6c75 6465 642c 2074 6865 0a20 2020  ncluded, the.   
│ │ │ │ +0001cbf0: 2020 6c6f 6361 6c20 7265 616c 6d20 6e61    local realm na
│ │ │ │ +0001cc00: 6d65 2069 7320 6173 7375 6d65 642e 2020  me is assumed.  
│ │ │ │ +0001cc10: 5468 6520 272f 2720 2c20 273a 272c 2061  The '/' , ':', a
│ │ │ │ +0001cc20: 6e64 206e 756c 6c20 6368 6172 6163 7465  nd null characte
│ │ │ │ +0001cc30: 7273 0a20 2020 2020 6d61 7920 6e6f 7420  rs.     may not 
│ │ │ │ +0001cc40: 6f63 6375 7220 7769 7468 696e 2061 2072  occur within a r
│ │ │ │ +0001cc50: 6561 6c6d 206e 616d 653b 2074 6865 2027  ealm name; the '
│ │ │ │ +0001cc60: 4027 2c20 6e65 776c 696e 652c 2074 6162  @', newline, tab
│ │ │ │ +0001cc70: 2c20 616e 640a 2020 2020 2062 6163 6b73  , and.     backs
│ │ │ │ +0001cc80: 7061 6365 2063 6861 7261 6374 6572 7320  pace characters 
│ │ │ │ +0001cc90: 6d61 7920 6265 2069 6e63 6c75 6465 6420  may be included 
│ │ │ │ +0001cca0: 7573 696e 6720 7468 6520 7175 6f74 696e  using the quotin
│ │ │ │ +0001ccb0: 6720 636f 6e76 656e 7469 6f6e 730a 2020  g conventions.  
│ │ │ │ +0001ccc0: 2020 2064 6573 6372 6962 6564 2069 6e20     described in 
│ │ │ │ +0001ccd0: 2831 6129 2c20 2831 6229 2c20 616e 6420  (1a), (1b), and 
│ │ │ │ +0001cce0: 2831 6329 2061 626f 7665 2e0a 0a1f 0a46  (1c) above.....F
│ │ │ │ +0001ccf0: 696c 653a 2073 6869 7368 692e 696e 666f  ile: shishi.info
│ │ │ │ +0001cd00: 2c20 204e 6f64 653a 2053 6869 7368 6920  ,  Node: Shishi 
│ │ │ │ +0001cd10: 436f 6e66 6967 7572 6174 696f 6e2c 2020  Configuration,  
│ │ │ │ +0001cd20: 4e65 7874 3a20 5368 6973 6120 436f 6e66  Next: Shisa Conf
│ │ │ │ +0001cd30: 6967 7572 6174 696f 6e2c 2020 5072 6576  iguration,  Prev
│ │ │ │ +0001cd40: 3a20 5265 616c 6d20 616e 6420 5072 696e  : Realm and Prin
│ │ │ │ +0001cd50: 6369 7061 6c20 4e61 6d69 6e67 2c20 2055  cipal Naming,  U
│ │ │ │ +0001cd60: 703a 2052 6566 6572 656e 6365 204d 616e  p: Reference Man
│ │ │ │ +0001cd70: 7561 6c0a 0a34 2e34 2053 6869 7368 6920  ual..4.4 Shishi 
│ │ │ │ +0001cd80: 436f 6e66 6967 7572 6174 696f 6e0a 3d3d  Configuration.==
│ │ │ │  0001cd90: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ -0001cda0: 3d3d 3d3d 0a0a 5468 6520 7661 6c69 6420  ====..The valid 
│ │ │ │ -0001cdb0: 636f 6e66 6967 7572 6174 696f 6e20 6669  configuration fi
│ │ │ │ -0001cdc0: 6c65 2074 6f6b 656e 7320 6172 6520 6465  le tokens are de
│ │ │ │ -0001cdd0: 7363 7269 6265 6420 6865 7265 2e20 2054  scribed here.  T
│ │ │ │ -0001cde0: 6865 2075 7365 720a 636f 6e66 6967 7572  he user.configur
│ │ │ │ -0001cdf0: 6174 696f 6e20 6669 6c65 2069 7320 7479  ation file is ty
│ │ │ │ -0001ce00: 7069 6361 6c6c 7920 6c6f 6361 7465 6420  pically located 
│ │ │ │ -0001ce10: 696e 20e2 8098 7e2f 2e73 6869 7368 692f  in ...~/.shishi/
│ │ │ │ -0001ce20: 7368 6973 6869 2e63 6f6e 66e2 8099 0a28  shishi.conf....(
│ │ │ │ -0001ce30: 636f 6d70 6172 6520 e280 9873 6869 7368  compare ...shish
│ │ │ │ -0001ce40: 6920 2d2d 636f 6e66 6967 7572 6174 696f  i --configuratio
│ │ │ │ -0001ce50: 6e2d 6669 6c65 e280 9929 2061 6e64 2074  n-file...) and t
│ │ │ │ -0001ce60: 6865 2073 7973 7465 6d20 636f 6e66 6967  he system config
│ │ │ │ -0001ce70: 7572 6174 696f 6e20 6973 0a74 7970 6963  uration is.typic
│ │ │ │ -0001ce80: 616c 6c79 206c 6f63 6174 6564 2069 6e20  ally located in 
│ │ │ │ -0001ce90: e280 982f 7573 722f 6c6f 6361 6c2f 6574  .../usr/local/et
│ │ │ │ -0001cea0: 632f 7368 6973 6869 2f73 6869 7368 692e  c/shishi/shishi.
│ │ │ │ -0001ceb0: 636f 6e66 e280 9920 2863 6f6d 7061 7265  conf... (compare
│ │ │ │ -0001cec0: 0ae2 8098 7368 6973 6869 202d 2d73 7973  ....shishi --sys
│ │ │ │ -0001ced0: 7465 6d2d 636f 6e66 6967 7572 6174 696f  tem-configuratio
│ │ │ │ -0001cee0: 6e2d 6669 6c65 e280 9929 2e20 2049 6620  n-file...).  If 
│ │ │ │ -0001cef0: 7468 6520 6669 7273 7420 6e6f 6e20 7768  the first non wh
│ │ │ │ -0001cf00: 6974 6520 7370 6163 650a 6368 6172 6163  ite space.charac
│ │ │ │ -0001cf10: 7465 7220 6f66 2061 206c 696e 6520 6973  ter of a line is
│ │ │ │ -0001cf20: 2061 2027 2327 2c20 7468 6520 6c69 6e65   a '#', the line
│ │ │ │ -0001cf30: 2069 7320 6967 6e6f 7265 642e 2020 456d   is ignored.  Em
│ │ │ │ -0001cf40: 7074 7920 6c69 6e65 7320 6172 6520 616c  pty lines are al
│ │ │ │ -0001cf50: 736f 0a69 676e 6f72 6564 2e0a 0a20 2020  so.ignored...   
│ │ │ │ -0001cf60: 416c 6c20 746f 6b65 6e73 2061 7265 2076  All tokens are v
│ │ │ │ -0001cf70: 616c 6964 2069 6e20 626f 7468 2074 6865  alid in both the
│ │ │ │ -0001cf80: 2073 7973 7465 6d20 616e 6420 7468 6520   system and the 
│ │ │ │ -0001cf90: 7573 6572 2063 6f6e 6669 6775 7261 7469  user configurati
│ │ │ │ -0001cfa0: 6f6e 0a66 696c 6573 2c20 616e 6420 6861  on.files, and ha
│ │ │ │ -0001cfb0: 7665 2074 6865 2073 616d 6520 6d65 616e  ve the same mean
│ │ │ │ -0001cfc0: 696e 672e 2020 486f 7765 7665 722c 2061  ing.  However, a
│ │ │ │ -0001cfd0: 7320 7468 6520 7379 7374 656d 2066 696c  s the system fil
│ │ │ │ -0001cfe0: 6520 6973 0a73 7570 706f 7365 6420 746f  e is.supposed to
│ │ │ │ -0001cff0: 2061 7070 6c79 2074 6f20 616c 6c20 7573   apply to all us
│ │ │ │ -0001d000: 6572 7320 6f6e 2061 2073 7973 7465 6d2c  ers on a system,
│ │ │ │ -0001d010: 2069 7420 776f 756c 6420 6e6f 7420 6d61   it would not ma
│ │ │ │ -0001d020: 6b65 2073 656e 7365 2074 6f0a 7573 6520  ke sense to.use 
│ │ │ │ -0001d030: 736f 6d65 2074 6f6b 656e 7320 696e 2074  some tokens in t
│ │ │ │ -0001d040: 6861 7420 6669 6c65 2e20 2046 6f72 2065  hat file.  For e
│ │ │ │ -0001d050: 7861 6d70 6c65 2c20 7468 6520 e280 9864  xample, the ...d
│ │ │ │ -0001d060: 6566 6175 6c74 2d70 7269 6e63 6970 616c  efault-principal
│ │ │ │ -0001d070: e280 9920 6973 0a72 6172 656c 7920 7573  ... is.rarely us
│ │ │ │ -0001d080: 6566 756c 2069 6e20 6120 7379 7374 656d  eful in a system
│ │ │ │ -0001d090: 2063 6f6e 6669 6775 7261 7469 6f6e 2066   configuration f
│ │ │ │ -0001d0a0: 696c 652e 0a0a 342e 342e 3120 e280 9864  ile...4.4.1 ...d
│ │ │ │ -0001d0b0: 6566 6175 6c74 2d72 6561 6c6d e280 990a  efault-realm....
│ │ │ │ -0001d0c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0001d0d0: 2d2d 2d2d 2d0a 0a53 7065 6369 6679 2074  -----..Specify t
│ │ │ │ -0001d0e0: 6865 2064 6566 6175 6c74 2072 6561 6c6d  he default realm
│ │ │ │ -0001d0f0: 2c20 6279 2064 6566 6175 6c74 2074 6865  , by default the
│ │ │ │ -0001d100: 2068 6f73 746e 616d 6520 6f66 2074 6865   hostname of the
│ │ │ │ -0001d110: 2068 6f73 7420 6973 2075 7365 642e 0a45   host is used..E
│ │ │ │ -0001d120: 2e67 2e2c 0a0a 2020 2020 2064 6566 6175  .g.,..     defau
│ │ │ │ -0001d130: 6c74 2d72 6561 6c6d 204a 4f53 4546 5353  lt-realm JOSEFSS
│ │ │ │ -0001d140: 4f4e 2e4f 5247 0a0a 342e 342e 3220 e280  ON.ORG..4.4.2 ..
│ │ │ │ -0001d150: 9864 6566 6175 6c74 2d70 7269 6e63 6970  .default-princip
│ │ │ │ -0001d160: 616c e280 990a 2d2d 2d2d 2d2d 2d2d 2d2d  al....----------
│ │ │ │ -0001d170: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -0001d180: 0a53 7065 6369 6679 2074 6865 2064 6566  .Specify the def
│ │ │ │ -0001d190: 6175 6c74 2070 7269 6e63 6970 616c 2c20  ault principal, 
│ │ │ │ -0001d1a0: 6279 2064 6566 6175 6c74 2074 6865 206c  by default the l
│ │ │ │ -0001d1b0: 6f67 696e 2075 7365 726e 616d 6520 6973  ogin username is
│ │ │ │ -0001d1c0: 2075 7365 642e 0a45 2e67 2e2c 0a0a 2020   used..E.g.,..  
│ │ │ │ -0001d1d0: 2020 2064 6566 6175 6c74 2d70 7269 6e63     default-princ
│ │ │ │ -0001d1e0: 6970 616c 206a 6173 0a0a 342e 342e 3320  ipal jas..4.4.3 
│ │ │ │ -0001d1f0: e280 9863 6c69 656e 742d 6b64 632d 6574  ...client-kdc-et
│ │ │ │ -0001d200: 7970 6573 e280 990a 2d2d 2d2d 2d2d 2d2d  ypes....--------
│ │ │ │ +0001cda0: 3d3d 3d3d 3d3d 0a0a 5468 6520 7661 6c69  ======..The vali
│ │ │ │ +0001cdb0: 6420 636f 6e66 6967 7572 6174 696f 6e20  d configuration 
│ │ │ │ +0001cdc0: 6669 6c65 2074 6f6b 656e 7320 6172 6520  file tokens are 
│ │ │ │ +0001cdd0: 6465 7363 7269 6265 6420 6865 7265 2e20  described here. 
│ │ │ │ +0001cde0: 2054 6865 2075 7365 720a 636f 6e66 6967   The user.config
│ │ │ │ +0001cdf0: 7572 6174 696f 6e20 6669 6c65 2069 7320  uration file is 
│ │ │ │ +0001ce00: 7479 7069 6361 6c6c 7920 6c6f 6361 7465  typically locate
│ │ │ │ +0001ce10: 6420 696e 20e2 8098 7e2f 2e73 6869 7368  d in ...~/.shish
│ │ │ │ +0001ce20: 692f 7368 6973 6869 2e63 6f6e 66e2 8099  i/shishi.conf...
│ │ │ │ +0001ce30: 0a28 636f 6d70 6172 6520 e280 9873 6869  .(compare ...shi
│ │ │ │ +0001ce40: 7368 6920 2d2d 636f 6e66 6967 7572 6174  shi --configurat
│ │ │ │ +0001ce50: 696f 6e2d 6669 6c65 e280 9929 2061 6e64  ion-file...) and
│ │ │ │ +0001ce60: 2074 6865 2073 7973 7465 6d20 636f 6e66   the system conf
│ │ │ │ +0001ce70: 6967 7572 6174 696f 6e20 6973 0a74 7970  iguration is.typ
│ │ │ │ +0001ce80: 6963 616c 6c79 206c 6f63 6174 6564 2069  ically located i
│ │ │ │ +0001ce90: 6e20 e280 982f 7573 722f 6c6f 6361 6c2f  n .../usr/local/
│ │ │ │ +0001cea0: 6574 632f 7368 6973 6869 2f73 6869 7368  etc/shishi/shish
│ │ │ │ +0001ceb0: 692e 636f 6e66 e280 9920 2863 6f6d 7061  i.conf... (compa
│ │ │ │ +0001cec0: 7265 0ae2 8098 7368 6973 6869 202d 2d73  re....shishi --s
│ │ │ │ +0001ced0: 7973 7465 6d2d 636f 6e66 6967 7572 6174  ystem-configurat
│ │ │ │ +0001cee0: 696f 6e2d 6669 6c65 e280 9929 2e20 2049  ion-file...).  I
│ │ │ │ +0001cef0: 6620 7468 6520 6669 7273 7420 6e6f 6e20  f the first non 
│ │ │ │ +0001cf00: 7768 6974 6520 7370 6163 650a 6368 6172  white space.char
│ │ │ │ +0001cf10: 6163 7465 7220 6f66 2061 206c 696e 6520  acter of a line 
│ │ │ │ +0001cf20: 6973 2061 2027 2327 2c20 7468 6520 6c69  is a '#', the li
│ │ │ │ +0001cf30: 6e65 2069 7320 6967 6e6f 7265 642e 2020  ne is ignored.  
│ │ │ │ +0001cf40: 456d 7074 7920 6c69 6e65 7320 6172 6520  Empty lines are 
│ │ │ │ +0001cf50: 616c 736f 0a69 676e 6f72 6564 2e0a 0a20  also.ignored... 
│ │ │ │ +0001cf60: 2020 416c 6c20 746f 6b65 6e73 2061 7265    All tokens are
│ │ │ │ +0001cf70: 2076 616c 6964 2069 6e20 626f 7468 2074   valid in both t
│ │ │ │ +0001cf80: 6865 2073 7973 7465 6d20 616e 6420 7468  he system and th
│ │ │ │ +0001cf90: 6520 7573 6572 2063 6f6e 6669 6775 7261  e user configura
│ │ │ │ +0001cfa0: 7469 6f6e 0a66 696c 6573 2c20 616e 6420  tion.files, and 
│ │ │ │ +0001cfb0: 6861 7665 2074 6865 2073 616d 6520 6d65  have the same me
│ │ │ │ +0001cfc0: 616e 696e 672e 2020 486f 7765 7665 722c  aning.  However,
│ │ │ │ +0001cfd0: 2061 7320 7468 6520 7379 7374 656d 2066   as the system f
│ │ │ │ +0001cfe0: 696c 6520 6973 0a73 7570 706f 7365 6420  ile is.supposed 
│ │ │ │ +0001cff0: 746f 2061 7070 6c79 2074 6f20 616c 6c20  to apply to all 
│ │ │ │ +0001d000: 7573 6572 7320 6f6e 2061 2073 7973 7465  users on a syste
│ │ │ │ +0001d010: 6d2c 2069 7420 776f 756c 6420 6e6f 7420  m, it would not 
│ │ │ │ +0001d020: 6d61 6b65 2073 656e 7365 2074 6f0a 7573  make sense to.us
│ │ │ │ +0001d030: 6520 736f 6d65 2074 6f6b 656e 7320 696e  e some tokens in
│ │ │ │ +0001d040: 2074 6861 7420 6669 6c65 2e20 2046 6f72   that file.  For
│ │ │ │ +0001d050: 2065 7861 6d70 6c65 2c20 7468 6520 e280   example, the ..
│ │ │ │ +0001d060: 9864 6566 6175 6c74 2d70 7269 6e63 6970  .default-princip
│ │ │ │ +0001d070: 616c e280 9920 6973 0a72 6172 656c 7920  al... is.rarely 
│ │ │ │ +0001d080: 7573 6566 756c 2069 6e20 6120 7379 7374  useful in a syst
│ │ │ │ +0001d090: 656d 2063 6f6e 6669 6775 7261 7469 6f6e  em configuration
│ │ │ │ +0001d0a0: 2066 696c 652e 0a0a 342e 342e 3120 e280   file...4.4.1 ..
│ │ │ │ +0001d0b0: 9864 6566 6175 6c74 2d72 6561 6c6d e280  .default-realm..
│ │ │ │ +0001d0c0: 990a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ..--------------
│ │ │ │ +0001d0d0: 2d2d 2d2d 2d2d 2d0a 0a53 7065 6369 6679  -------..Specify
│ │ │ │ +0001d0e0: 2074 6865 2064 6566 6175 6c74 2072 6561   the default rea
│ │ │ │ +0001d0f0: 6c6d 2c20 6279 2064 6566 6175 6c74 2074  lm, by default t
│ │ │ │ +0001d100: 6865 2068 6f73 746e 616d 6520 6f66 2074  he hostname of t
│ │ │ │ +0001d110: 6865 2068 6f73 7420 6973 2075 7365 642e  he host is used.
│ │ │ │ +0001d120: 0a45 2e67 2e2c 0a0a 2020 2020 2064 6566  .E.g.,..     def
│ │ │ │ +0001d130: 6175 6c74 2d72 6561 6c6d 204a 4f53 4546  ault-realm JOSEF
│ │ │ │ +0001d140: 5353 4f4e 2e4f 5247 0a0a 342e 342e 3220  SSON.ORG..4.4.2 
│ │ │ │ +0001d150: e280 9864 6566 6175 6c74 2d70 7269 6e63  ...default-princ
│ │ │ │ +0001d160: 6970 616c e280 990a 2d2d 2d2d 2d2d 2d2d  ipal....--------
│ │ │ │ +0001d170: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +0001d180: 2d0a 0a53 7065 6369 6679 2074 6865 2064  -..Specify the d
│ │ │ │ +0001d190: 6566 6175 6c74 2070 7269 6e63 6970 616c  efault principal
│ │ │ │ +0001d1a0: 2c20 6279 2064 6566 6175 6c74 2074 6865  , by default the
│ │ │ │ +0001d1b0: 206c 6f67 696e 2075 7365 726e 616d 6520   login username 
│ │ │ │ +0001d1c0: 6973 2075 7365 642e 0a45 2e67 2e2c 0a0a  is used..E.g.,..
│ │ │ │ +0001d1d0: 2020 2020 2064 6566 6175 6c74 2d70 7269       default-pri
│ │ │ │ +0001d1e0: 6e63 6970 616c 206a 6173 0a0a 342e 342e  ncipal jas..4.4.
│ │ │ │ +0001d1f0: 3320 e280 9863 6c69 656e 742d 6b64 632d  3 ...client-kdc-
│ │ │ │ +0001d200: 6574 7970 6573 e280 990a 2d2d 2d2d 2d2d  etypes....------
│ │ │ │  0001d210: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0001d220: 2d0a 0a53 7065 6369 6679 2077 6869 6368  -..Specify which
│ │ │ │ -0001d230: 2065 6e63 7279 7074 696f 6e20 7479 7065   encryption type
│ │ │ │ -0001d240: 7320 636c 6965 6e74 2061 736b 7320 7365  s client asks se
│ │ │ │ -0001d250: 7276 6572 2074 6f20 7265 7370 6f6e 6420  rver to respond 
│ │ │ │ -0001d260: 696e 2064 7572 696e 670a 4153 2f54 4753  in during.AS/TGS
│ │ │ │ -0001d270: 2065 7863 6861 6e67 6573 2e20 204c 6973   exchanges.  Lis
│ │ │ │ -0001d280: 7420 7661 6c69 6420 656e 6372 7970 7469  t valid encrypti
│ │ │ │ -0001d290: 6f6e 2074 7970 6573 2c20 696e 2070 7265  on types, in pre
│ │ │ │ -0001d2a0: 6665 7265 6e63 6520 6f72 6465 722e 0a53  ference order..S
│ │ │ │ -0001d2b0: 7570 706f 7274 6564 2061 6c67 6f72 6974  upported algorit
│ │ │ │ -0001d2c0: 686d 7320 696e 636c 7564 6520 6165 7332  hms include aes2
│ │ │ │ -0001d2d0: 3536 2d63 7473 2d68 6d61 632d 7368 6131  56-cts-hmac-sha1
│ │ │ │ -0001d2e0: 2d39 362c 0a61 6573 3132 382d 6374 732d  -96,.aes128-cts-
│ │ │ │ -0001d2f0: 686d 6163 2d73 6861 312d 3936 2c20 6465  hmac-sha1-96, de
│ │ │ │ -0001d300: 7333 2d63 6263 2d73 6861 312d 6b64 2c20  s3-cbc-sha1-kd, 
│ │ │ │ -0001d310: 6465 732d 6362 632d 6d64 352c 2064 6573  des-cbc-md5, des
│ │ │ │ -0001d320: 2d63 6263 2d6d 6434 2c0a 6465 732d 6362  -cbc-md4,.des-cb
│ │ │ │ -0001d330: 632d 6372 6320 616e 6420 6e75 6c6c 2e20  c-crc and null. 
│ │ │ │ -0001d340: 2054 6869 7320 6f70 7469 6f6e 2061 6c73   This option als
│ │ │ │ -0001d350: 6f20 696e 6469 6361 7465 7320 7768 6963  o indicates whic
│ │ │ │ -0001d360: 6820 656e 6372 7970 7469 6f6e 2074 7970  h encryption typ
│ │ │ │ -0001d370: 6573 0a61 7265 2061 6363 6570 7465 6420  es.are accepted 
│ │ │ │ -0001d380: 6279 2074 6865 2063 6c69 656e 7420 7768  by the client wh
│ │ │ │ -0001d390: 656e 2072 6563 6569 7669 6e67 2074 6865  en receiving the
│ │ │ │ -0001d3a0: 2072 6573 706f 6e73 652e 2020 4e6f 7465   response.  Note
│ │ │ │ -0001d3b0: 2074 6861 7420 7468 650a 7072 6566 6572   that the.prefer
│ │ │ │ -0001d3c0: 656e 6365 206f 7264 6572 2069 7320 6e6f  ence order is no
│ │ │ │ -0001d3d0: 7420 6372 7970 746f 6772 6170 6869 6361  t cryptographica
│ │ │ │ -0001d3e0: 6c6c 7920 7072 6f74 6563 7465 642c 2073  lly protected, s
│ │ │ │ -0001d3f0: 6f20 6120 6d61 6e20 696e 2074 6865 0a6d  o a man in the.m
│ │ │ │ -0001d400: 6964 646c 6520 6361 6e20 6d6f 6469 6679  iddle can modify
│ │ │ │ -0001d410: 2074 6865 206f 7264 6572 2077 6974 686f   the order witho
│ │ │ │ -0001d420: 7574 2062 6569 6e67 2064 6574 6563 7465  ut being detecte
│ │ │ │ -0001d430: 642e 2020 5468 7573 2c20 6f6e 6c79 2073  d.  Thus, only s
│ │ │ │ -0001d440: 7065 6369 6679 0a65 6e63 7279 7074 696f  pecify.encryptio
│ │ │ │ -0001d450: 6e20 7479 7065 7320 796f 7520 7472 7573  n types you trus
│ │ │ │ -0001d460: 7420 636f 6d70 6c65 7465 6c79 2068 6572  t completely her
│ │ │ │ -0001d470: 652e 2020 5468 6520 6465 6661 756c 7420  e.  The default 
│ │ │ │ -0001d480: 6f6e 6c79 2069 6e63 6c75 6465 730a 6165  only includes.ae
│ │ │ │ -0001d490: 7332 3536 2d63 7473 2d68 6d61 632d 7368  s256-cts-hmac-sh
│ │ │ │ -0001d4a0: 6131 2d39 362c 2061 7320 7375 6767 6573  a1-96, as sugges
│ │ │ │ -0001d4b0: 7465 6420 6279 2052 4643 3135 3130 6269  ted by RFC1510bi
│ │ │ │ -0001d4c0: 732e 2020 452e 672e 2c0a 0a20 2020 2020  s.  E.g.,..     
│ │ │ │ -0001d4d0: 636c 6965 6e74 2d6b 6463 2d65 7479 7065  client-kdc-etype
│ │ │ │ -0001d4e0: 733d 6165 7332 3536 2d63 7473 2d68 6d61  s=aes256-cts-hma
│ │ │ │ -0001d4f0: 632d 7368 6131 2d39 3620 6465 7333 2d63  c-sha1-96 des3-c
│ │ │ │ -0001d500: 6263 2d73 6861 312d 6b64 2064 6573 2d63  bc-sha1-kd des-c
│ │ │ │ -0001d510: 6263 2d6d 6435 0a0a 342e 342e 3420 e280  bc-md5..4.4.4 ..
│ │ │ │ -0001d520: 9876 6572 626f 7365 e280 992c 20e2 8098  .verbose..., ...
│ │ │ │ -0001d530: 7665 7262 6f73 652d 6173 6e31 e280 992c  verbose-asn1...,
│ │ │ │ -0001d540: 20e2 8098 7665 7262 6f73 652d 6e6f 6973   ...verbose-nois
│ │ │ │ -0001d550: 65e2 8099 2c20 e280 9876 6572 626f 7365  e..., ...verbose
│ │ │ │ -0001d560: 2d63 7279 7074 6fe2 8099 2c20 e280 9876  -crypto..., ...v
│ │ │ │ -0001d570: 6572 626f 7365 2d63 7279 7074 6f2d 6e6f  erbose-crypto-no
│ │ │ │ -0001d580: 6973 65e2 8099 0a2d 2d2d 2d2d 2d2d 2d2d  ise....---------
│ │ │ │ +0001d220: 2d2d 2d0a 0a53 7065 6369 6679 2077 6869  ---..Specify whi
│ │ │ │ +0001d230: 6368 2065 6e63 7279 7074 696f 6e20 7479  ch encryption ty
│ │ │ │ +0001d240: 7065 7320 636c 6965 6e74 2061 736b 7320  pes client asks 
│ │ │ │ +0001d250: 7365 7276 6572 2074 6f20 7265 7370 6f6e  server to respon
│ │ │ │ +0001d260: 6420 696e 2064 7572 696e 670a 4153 2f54  d in during.AS/T
│ │ │ │ +0001d270: 4753 2065 7863 6861 6e67 6573 2e20 204c  GS exchanges.  L
│ │ │ │ +0001d280: 6973 7420 7661 6c69 6420 656e 6372 7970  ist valid encryp
│ │ │ │ +0001d290: 7469 6f6e 2074 7970 6573 2c20 696e 2070  tion types, in p
│ │ │ │ +0001d2a0: 7265 6665 7265 6e63 6520 6f72 6465 722e  reference order.
│ │ │ │ +0001d2b0: 0a53 7570 706f 7274 6564 2061 6c67 6f72  .Supported algor
│ │ │ │ +0001d2c0: 6974 686d 7320 696e 636c 7564 6520 6165  ithms include ae
│ │ │ │ +0001d2d0: 7332 3536 2d63 7473 2d68 6d61 632d 7368  s256-cts-hmac-sh
│ │ │ │ +0001d2e0: 6131 2d39 362c 0a61 6573 3132 382d 6374  a1-96,.aes128-ct
│ │ │ │ +0001d2f0: 732d 686d 6163 2d73 6861 312d 3936 2c20  s-hmac-sha1-96, 
│ │ │ │ +0001d300: 6465 7333 2d63 6263 2d73 6861 312d 6b64  des3-cbc-sha1-kd
│ │ │ │ +0001d310: 2c20 6465 732d 6362 632d 6d64 352c 2064  , des-cbc-md5, d
│ │ │ │ +0001d320: 6573 2d63 6263 2d6d 6434 2c0a 6465 732d  es-cbc-md4,.des-
│ │ │ │ +0001d330: 6362 632d 6372 6320 616e 6420 6e75 6c6c  cbc-crc and null
│ │ │ │ +0001d340: 2e20 2054 6869 7320 6f70 7469 6f6e 2061  .  This option a
│ │ │ │ +0001d350: 6c73 6f20 696e 6469 6361 7465 7320 7768  lso indicates wh
│ │ │ │ +0001d360: 6963 6820 656e 6372 7970 7469 6f6e 2074  ich encryption t
│ │ │ │ +0001d370: 7970 6573 0a61 7265 2061 6363 6570 7465  ypes.are accepte
│ │ │ │ +0001d380: 6420 6279 2074 6865 2063 6c69 656e 7420  d by the client 
│ │ │ │ +0001d390: 7768 656e 2072 6563 6569 7669 6e67 2074  when receiving t
│ │ │ │ +0001d3a0: 6865 2072 6573 706f 6e73 652e 2020 4e6f  he response.  No
│ │ │ │ +0001d3b0: 7465 2074 6861 7420 7468 650a 7072 6566  te that the.pref
│ │ │ │ +0001d3c0: 6572 656e 6365 206f 7264 6572 2069 7320  erence order is 
│ │ │ │ +0001d3d0: 6e6f 7420 6372 7970 746f 6772 6170 6869  not cryptographi
│ │ │ │ +0001d3e0: 6361 6c6c 7920 7072 6f74 6563 7465 642c  cally protected,
│ │ │ │ +0001d3f0: 2073 6f20 6120 6d61 6e20 696e 2074 6865   so a man in the
│ │ │ │ +0001d400: 0a6d 6964 646c 6520 6361 6e20 6d6f 6469  .middle can modi
│ │ │ │ +0001d410: 6679 2074 6865 206f 7264 6572 2077 6974  fy the order wit
│ │ │ │ +0001d420: 686f 7574 2062 6569 6e67 2064 6574 6563  hout being detec
│ │ │ │ +0001d430: 7465 642e 2020 5468 7573 2c20 6f6e 6c79  ted.  Thus, only
│ │ │ │ +0001d440: 2073 7065 6369 6679 0a65 6e63 7279 7074   specify.encrypt
│ │ │ │ +0001d450: 696f 6e20 7479 7065 7320 796f 7520 7472  ion types you tr
│ │ │ │ +0001d460: 7573 7420 636f 6d70 6c65 7465 6c79 2068  ust completely h
│ │ │ │ +0001d470: 6572 652e 2020 5468 6520 6465 6661 756c  ere.  The defaul
│ │ │ │ +0001d480: 7420 6f6e 6c79 2069 6e63 6c75 6465 730a  t only includes.
│ │ │ │ +0001d490: 6165 7332 3536 2d63 7473 2d68 6d61 632d  aes256-cts-hmac-
│ │ │ │ +0001d4a0: 7368 6131 2d39 362c 2061 7320 7375 6767  sha1-96, as sugg
│ │ │ │ +0001d4b0: 6573 7465 6420 6279 2052 4643 3135 3130  ested by RFC1510
│ │ │ │ +0001d4c0: 6269 732e 2020 452e 672e 2c0a 0a20 2020  bis.  E.g.,..   
│ │ │ │ +0001d4d0: 2020 636c 6965 6e74 2d6b 6463 2d65 7479    client-kdc-ety
│ │ │ │ +0001d4e0: 7065 733d 6165 7332 3536 2d63 7473 2d68  pes=aes256-cts-h
│ │ │ │ +0001d4f0: 6d61 632d 7368 6131 2d39 3620 6465 7333  mac-sha1-96 des3
│ │ │ │ +0001d500: 2d63 6263 2d73 6861 312d 6b64 2064 6573  -cbc-sha1-kd des
│ │ │ │ +0001d510: 2d63 6263 2d6d 6435 0a0a 342e 342e 3420  -cbc-md5..4.4.4 
│ │ │ │ +0001d520: e280 9876 6572 626f 7365 e280 992c 20e2  ...verbose..., .
│ │ │ │ +0001d530: 8098 7665 7262 6f73 652d 6173 6e31 e280  ..verbose-asn1..
│ │ │ │ +0001d540: 992c 20e2 8098 7665 7262 6f73 652d 6e6f  ., ...verbose-no
│ │ │ │ +0001d550: 6973 65e2 8099 2c20 e280 9876 6572 626f  ise..., ...verbo
│ │ │ │ +0001d560: 7365 2d63 7279 7074 6fe2 8099 2c20 e280  se-crypto..., ..
│ │ │ │ +0001d570: 9876 6572 626f 7365 2d63 7279 7074 6f2d  .verbose-crypto-
│ │ │ │ +0001d580: 6e6f 6973 65e2 8099 0a2d 2d2d 2d2d 2d2d  noise....-------
│ │ │ │  0001d590: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │  0001d5a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │  0001d5b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │  0001d5c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │  0001d5d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0001d5e0: 2d0a 0a45 6e61 626c 6520 7665 7262 6f73  -..Enable verbos
│ │ │ │ -0001d5f0: 6520 6c69 6272 6172 7920 6d65 7373 6167  e library messag
│ │ │ │ -0001d600: 6573 2e20 2045 2e67 2e2c 0a0a 2020 2020  es.  E.g.,..    
│ │ │ │ -0001d610: 2076 6572 626f 7365 0a20 2020 2020 7665   verbose.     ve
│ │ │ │ -0001d620: 7262 6f73 652d 6e6f 6973 650a 0a34 2e34  rbose-noise..4.4
│ │ │ │ -0001d630: 2e35 20e2 8098 7265 616c 6d2d 6b64 63e2  .5 ...realm-kdc.
│ │ │ │ -0001d640: 8099 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ...-------------
│ │ │ │ -0001d650: 2d2d 2d2d 0a0a 5370 6563 6966 7920 4b44  ----..Specify KD
│ │ │ │ -0001d660: 4320 6164 6472 6573 7365 7320 666f 7220  C addresses for 
│ │ │ │ -0001d670: 7265 616c 6d73 2e20 2056 616c 7565 2069  realms.  Value i
│ │ │ │ -0001d680: 730a e280 9852 4541 4c4d 2c4b 4443 4144  s....REALM,KDCAD
│ │ │ │ -0001d690: 4452 4553 535b 2f54 5241 4e53 504f 5254  DRESS[/TRANSPORT
│ │ │ │ -0001d6a0: 5d5b 2c4b 4443 4144 4452 4553 535b 2f54  ][,KDCADDRESS[/T
│ │ │ │ -0001d6b0: 5241 4e53 504f 5254 5d2e 2e2e 5de2 8099  RANSPORT]...]...
│ │ │ │ -0001d6c0: 2e0a 0a20 2020 4b44 4341 4444 5245 5353  ...   KDCADDRESS
│ │ │ │ -0001d6d0: 2069 7320 7468 6520 686f 7374 6e61 6d65   is the hostname
│ │ │ │ -0001d6e0: 206f 7220 4950 2061 6464 7265 7373 206f   or IP address o
│ │ │ │ -0001d6f0: 6620 4b44 432e 0a0a 2020 204f 7074 696f  f KDC...   Optio
│ │ │ │ -0001d700: 6e61 6c20 5452 414e 5350 4f52 5420 6973  nal TRANSPORT is
│ │ │ │ -0001d710: 2022 7564 7022 2066 6f72 2055 4450 2c20   "udp" for UDP, 
│ │ │ │ -0001d720: 2274 6370 2220 666f 7220 5443 502c 2061  "tcp" for TCP, a
│ │ │ │ -0001d730: 6e64 2022 746c 7322 2066 6f72 2054 4c53  nd "tls" for TLS
│ │ │ │ -0001d740: 0a63 6f6e 6e65 6374 696f 6e73 2e20 2042  .connections.  B
│ │ │ │ -0001d750: 7920 6465 6661 756c 7420 5544 5020 6973  y default UDP is
│ │ │ │ -0001d760: 2074 7269 6564 2066 6972 7374 2c20 616e   tried first, an
│ │ │ │ -0001d770: 6420 5443 5020 7573 6564 2061 7320 6120  d TCP used as a 
│ │ │ │ -0001d780: 6661 6c6c 6261 636b 0a69 6620 7468 6520  fallback.if the 
│ │ │ │ -0001d790: 4b52 425f 4552 525f 5245 5350 4f4e 5345  KRB_ERR_RESPONSE
│ │ │ │ -0001d7a0: 5f54 4f4f 5f42 4947 2065 7272 6f72 2069  _TOO_BIG error i
│ │ │ │ -0001d7b0: 7320 7265 6365 6976 6564 2e0a 0a20 2020  s received...   
│ │ │ │ -0001d7c0: 4966 206e 6f74 2073 7065 6369 6669 6564  If not specified
│ │ │ │ -0001d7d0: 2c20 5368 6973 6869 2074 7269 6573 2074  , Shishi tries t
│ │ │ │ -0001d7e0: 6f20 6c6f 6361 7465 2074 6865 204b 4443  o locate the KDC
│ │ │ │ -0001d7f0: 2075 7369 6e67 2053 5256 2052 5273 2c20   using SRV RRs, 
│ │ │ │ -0001d800: 7768 6963 680a 6973 2072 6563 6f6d 6d65  which.is recomme
│ │ │ │ -0001d810: 6e64 6564 2e20 2054 6869 7320 6f70 7469  nded.  This opti
│ │ │ │ -0001d820: 6f6e 2073 686f 756c 6420 6e6f 726d 616c  on should normal
│ │ │ │ -0001d830: 6c79 206f 6e6c 7920 6265 2075 7365 6420  ly only be used 
│ │ │ │ -0001d840: 6475 7269 6e67 0a65 7870 6572 696d 656e  during.experimen
│ │ │ │ -0001d850: 7473 2c20 6f72 2074 6f20 6163 6365 7373  ts, or to access
│ │ │ │ -0001d860: 2062 6164 6c79 206d 6169 6e74 6169 6e65   badly maintaine
│ │ │ │ -0001d870: 6420 7265 616c 6d73 2e0a 0a20 2020 2020  d realms...     
│ │ │ │ -0001d880: 7265 616c 6d2d 6b64 633d 4a4f 5345 4653  realm-kdc=JOSEFS
│ │ │ │ -0001d890: 534f 4e2e 4f52 472c 7269 7374 7265 7474  SON.ORG,ristrett
│ │ │ │ -0001d8a0: 6f2e 6a6f 7365 6673 736f 6e2e 6f72 670a  o.josefsson.org.
│ │ │ │ -0001d8b0: 0a34 2e34 2e36 20e2 8098 7365 7276 6572  .4.4.6 ...server
│ │ │ │ -0001d8c0: 2d72 6561 6c6d e280 990a 2d2d 2d2d 2d2d  -realm....------
│ │ │ │ -0001d8d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -0001d8e0: 5370 6563 6966 7920 7265 616c 6d20 666f  Specify realm fo
│ │ │ │ -0001d8f0: 7220 7365 7276 6572 732e 2020 5661 6c75  r servers.  Valu
│ │ │ │ -0001d900: 6520 6973 0ae2 8098 5245 414c 4d2c 5345  e is....REALM,SE
│ │ │ │ -0001d910: 5256 4552 5245 4745 5850 5b2c 5345 5256  RVERREGEXP[,SERV
│ │ │ │ -0001d920: 4552 5245 4745 5850 2e2e 2e5d e280 992e  ERREGEXP...]....
│ │ │ │ -0001d930: 0a0a 2020 2053 4552 5645 5252 4547 4558  ..   SERVERREGEX
│ │ │ │ -0001d940: 5020 6973 2061 2072 6567 756c 6172 2065  P is a regular e
│ │ │ │ -0001d950: 7870 7265 7373 696f 6e20 6d61 7463 6869  xpression matchi
│ │ │ │ -0001d960: 6e67 2073 6572 7665 7273 2069 6e20 7468  ng servers in th
│ │ │ │ -0001d970: 6520 7265 616c 6d2e 0a54 6865 2066 6972  e realm..The fir
│ │ │ │ -0001d980: 7374 206d 6174 6368 2069 7320 7573 6564  st match is used
│ │ │ │ -0001d990: 2e20 2045 2e67 2e2c 0a0a 2020 2020 2073  .  E.g.,..     s
│ │ │ │ -0001d9a0: 6572 7665 722d 7265 616c 6d3d 4a4f 5345  erver-realm=JOSE
│ │ │ │ -0001d9b0: 4653 534f 4e2e 4f52 472c 2e6a 6f73 6566  FSSON.ORG,.josef
│ │ │ │ -0001d9c0: 7373 6f6e 2e6f 7267 0a0a 2020 204e 6f74  sson.org..   Not
│ │ │ │ -0001d9d0: 653a 2063 7572 7265 6e74 6c79 206e 6f74  e: currently not
│ │ │ │ -0001d9e0: 2075 7365 642e 0a0a 342e 342e 3720 e280   used...4.4.7 ..
│ │ │ │ -0001d9f0: 986b 6463 2d74 696d 656f 7574 e280 992c  .kdc-timeout...,
│ │ │ │ -0001da00: 20e2 8098 6b64 632d 7265 7472 6965 73e2   ...kdc-retries.
│ │ │ │ -0001da10: 8099 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ...-------------
│ │ │ │ +0001d5e0: 2d2d 2d0a 0a45 6e61 626c 6520 7665 7262  ---..Enable verb
│ │ │ │ +0001d5f0: 6f73 6520 6c69 6272 6172 7920 6d65 7373  ose library mess
│ │ │ │ +0001d600: 6167 6573 2e20 2045 2e67 2e2c 0a0a 2020  ages.  E.g.,..  
│ │ │ │ +0001d610: 2020 2076 6572 626f 7365 0a20 2020 2020     verbose.     
│ │ │ │ +0001d620: 7665 7262 6f73 652d 6e6f 6973 650a 0a34  verbose-noise..4
│ │ │ │ +0001d630: 2e34 2e35 20e2 8098 7265 616c 6d2d 6b64  .4.5 ...realm-kd
│ │ │ │ +0001d640: 63e2 8099 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  c....-----------
│ │ │ │ +0001d650: 2d2d 2d2d 2d2d 0a0a 5370 6563 6966 7920  ------..Specify 
│ │ │ │ +0001d660: 4b44 4320 6164 6472 6573 7365 7320 666f  KDC addresses fo
│ │ │ │ +0001d670: 7220 7265 616c 6d73 2e20 2056 616c 7565  r realms.  Value
│ │ │ │ +0001d680: 2069 730a e280 9852 4541 4c4d 2c4b 4443   is....REALM,KDC
│ │ │ │ +0001d690: 4144 4452 4553 535b 2f54 5241 4e53 504f  ADDRESS[/TRANSPO
│ │ │ │ +0001d6a0: 5254 5d5b 2c4b 4443 4144 4452 4553 535b  RT][,KDCADDRESS[
│ │ │ │ +0001d6b0: 2f54 5241 4e53 504f 5254 5d2e 2e2e 5de2  /TRANSPORT]...].
│ │ │ │ +0001d6c0: 8099 2e0a 0a20 2020 4b44 4341 4444 5245  .....   KDCADDRE
│ │ │ │ +0001d6d0: 5353 2069 7320 7468 6520 686f 7374 6e61  SS is the hostna
│ │ │ │ +0001d6e0: 6d65 206f 7220 4950 2061 6464 7265 7373  me or IP address
│ │ │ │ +0001d6f0: 206f 6620 4b44 432e 0a0a 2020 204f 7074   of KDC...   Opt
│ │ │ │ +0001d700: 696f 6e61 6c20 5452 414e 5350 4f52 5420  ional TRANSPORT 
│ │ │ │ +0001d710: 6973 2022 7564 7022 2066 6f72 2055 4450  is "udp" for UDP
│ │ │ │ +0001d720: 2c20 2274 6370 2220 666f 7220 5443 502c  , "tcp" for TCP,
│ │ │ │ +0001d730: 2061 6e64 2022 746c 7322 2066 6f72 2054   and "tls" for T
│ │ │ │ +0001d740: 4c53 0a63 6f6e 6e65 6374 696f 6e73 2e20  LS.connections. 
│ │ │ │ +0001d750: 2042 7920 6465 6661 756c 7420 5544 5020   By default UDP 
│ │ │ │ +0001d760: 6973 2074 7269 6564 2066 6972 7374 2c20  is tried first, 
│ │ │ │ +0001d770: 616e 6420 5443 5020 7573 6564 2061 7320  and TCP used as 
│ │ │ │ +0001d780: 6120 6661 6c6c 6261 636b 0a69 6620 7468  a fallback.if th
│ │ │ │ +0001d790: 6520 4b52 425f 4552 525f 5245 5350 4f4e  e KRB_ERR_RESPON
│ │ │ │ +0001d7a0: 5345 5f54 4f4f 5f42 4947 2065 7272 6f72  SE_TOO_BIG error
│ │ │ │ +0001d7b0: 2069 7320 7265 6365 6976 6564 2e0a 0a20   is received... 
│ │ │ │ +0001d7c0: 2020 4966 206e 6f74 2073 7065 6369 6669    If not specifi
│ │ │ │ +0001d7d0: 6564 2c20 5368 6973 6869 2074 7269 6573  ed, Shishi tries
│ │ │ │ +0001d7e0: 2074 6f20 6c6f 6361 7465 2074 6865 204b   to locate the K
│ │ │ │ +0001d7f0: 4443 2075 7369 6e67 2053 5256 2052 5273  DC using SRV RRs
│ │ │ │ +0001d800: 2c20 7768 6963 680a 6973 2072 6563 6f6d  , which.is recom
│ │ │ │ +0001d810: 6d65 6e64 6564 2e20 2054 6869 7320 6f70  mended.  This op
│ │ │ │ +0001d820: 7469 6f6e 2073 686f 756c 6420 6e6f 726d  tion should norm
│ │ │ │ +0001d830: 616c 6c79 206f 6e6c 7920 6265 2075 7365  ally only be use
│ │ │ │ +0001d840: 6420 6475 7269 6e67 0a65 7870 6572 696d  d during.experim
│ │ │ │ +0001d850: 656e 7473 2c20 6f72 2074 6f20 6163 6365  ents, or to acce
│ │ │ │ +0001d860: 7373 2062 6164 6c79 206d 6169 6e74 6169  ss badly maintai
│ │ │ │ +0001d870: 6e65 6420 7265 616c 6d73 2e0a 0a20 2020  ned realms...   
│ │ │ │ +0001d880: 2020 7265 616c 6d2d 6b64 633d 4a4f 5345    realm-kdc=JOSE
│ │ │ │ +0001d890: 4653 534f 4e2e 4f52 472c 7269 7374 7265  FSSON.ORG,ristre
│ │ │ │ +0001d8a0: 7474 6f2e 6a6f 7365 6673 736f 6e2e 6f72  tto.josefsson.or
│ │ │ │ +0001d8b0: 670a 0a34 2e34 2e36 20e2 8098 7365 7276  g..4.4.6 ...serv
│ │ │ │ +0001d8c0: 6572 2d72 6561 6c6d e280 990a 2d2d 2d2d  er-realm....----
│ │ │ │ +0001d8d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +0001d8e0: 0a0a 5370 6563 6966 7920 7265 616c 6d20  ..Specify realm 
│ │ │ │ +0001d8f0: 666f 7220 7365 7276 6572 732e 2020 5661  for servers.  Va
│ │ │ │ +0001d900: 6c75 6520 6973 0ae2 8098 5245 414c 4d2c  lue is....REALM,
│ │ │ │ +0001d910: 5345 5256 4552 5245 4745 5850 5b2c 5345  SERVERREGEXP[,SE
│ │ │ │ +0001d920: 5256 4552 5245 4745 5850 2e2e 2e5d e280  RVERREGEXP...]..
│ │ │ │ +0001d930: 992e 0a0a 2020 2053 4552 5645 5252 4547  ....   SERVERREG
│ │ │ │ +0001d940: 4558 5020 6973 2061 2072 6567 756c 6172  EXP is a regular
│ │ │ │ +0001d950: 2065 7870 7265 7373 696f 6e20 6d61 7463   expression matc
│ │ │ │ +0001d960: 6869 6e67 2073 6572 7665 7273 2069 6e20  hing servers in 
│ │ │ │ +0001d970: 7468 6520 7265 616c 6d2e 0a54 6865 2066  the realm..The f
│ │ │ │ +0001d980: 6972 7374 206d 6174 6368 2069 7320 7573  irst match is us
│ │ │ │ +0001d990: 6564 2e20 2045 2e67 2e2c 0a0a 2020 2020  ed.  E.g.,..    
│ │ │ │ +0001d9a0: 2073 6572 7665 722d 7265 616c 6d3d 4a4f   server-realm=JO
│ │ │ │ +0001d9b0: 5345 4653 534f 4e2e 4f52 472c 2e6a 6f73  SEFSSON.ORG,.jos
│ │ │ │ +0001d9c0: 6566 7373 6f6e 2e6f 7267 0a0a 2020 204e  efsson.org..   N
│ │ │ │ +0001d9d0: 6f74 653a 2063 7572 7265 6e74 6c79 206e  ote: currently n
│ │ │ │ +0001d9e0: 6f74 2075 7365 642e 0a0a 342e 342e 3720  ot used...4.4.7 
│ │ │ │ +0001d9f0: e280 986b 6463 2d74 696d 656f 7574 e280  ...kdc-timeout..
│ │ │ │ +0001da00: 992c 20e2 8098 6b64 632d 7265 7472 6965  ., ...kdc-retrie
│ │ │ │ +0001da10: 73e2 8099 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  s....-----------
│ │ │ │  0001da20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0001da30: 2d2d 2d2d 2d0a 0a48 6f77 206c 6f6e 6720  -----..How long 
│ │ │ │ -0001da40: 7368 6973 6869 2077 6169 7473 2066 6f72  shishi waits for
│ │ │ │ -0001da50: 2061 2072 6573 706f 6e73 6520 6672 6f6d   a response from
│ │ │ │ -0001da60: 2061 204b 4443 2062 6566 6f72 6520 636f   a KDC before co
│ │ │ │ -0001da70: 6e74 696e 7569 6e67 2074 6f0a 6e65 7874  ntinuing to.next
│ │ │ │ -0001da80: 204b 4443 2066 6f72 2072 6561 6c6d 2e20   KDC for realm. 
│ │ │ │ -0001da90: 2054 6865 2064 6566 6175 6c74 2069 7320   The default is 
│ │ │ │ -0001daa0: 3520 7365 636f 6e64 732e 2020 452e 672e  5 seconds.  E.g.
│ │ │ │ -0001dab0: 2c0a 0a20 2020 2020 6b64 632d 7469 6d65  ,..     kdc-time
│ │ │ │ -0001dac0: 6f75 743d 3130 0a0a 2020 2048 6f77 206d  out=10..   How m
│ │ │ │ -0001dad0: 616e 7920 7469 6d65 7320 7368 6973 6869  any times shishi
│ │ │ │ -0001dae0: 2073 656e 6473 2061 2072 6571 7565 7374   sends a request
│ │ │ │ -0001daf0: 2074 6f20 6120 4b44 4320 6265 666f 7265   to a KDC before
│ │ │ │ -0001db00: 2067 6976 696e 6720 7570 2e20 2054 6865   giving up.  The
│ │ │ │ -0001db10: 0a64 6566 6175 6c74 2069 7320 3320 7469  .default is 3 ti
│ │ │ │ -0001db20: 6d65 732e 2020 452e 672e 2c0a 0a20 2020  mes.  E.g.,..   
│ │ │ │ -0001db30: 2020 6b64 632d 7265 7472 6965 733d 350a    kdc-retries=5.
│ │ │ │ -0001db40: 0a34 2e34 2e38 20e2 8098 7374 7269 6e67  .4.4.8 ...string
│ │ │ │ -0001db50: 7072 6f63 6573 73e2 8099 0a2d 2d2d 2d2d  process....-----
│ │ │ │ +0001da30: 2d2d 2d2d 2d2d 2d0a 0a48 6f77 206c 6f6e  -------..How lon
│ │ │ │ +0001da40: 6720 7368 6973 6869 2077 6169 7473 2066  g shishi waits f
│ │ │ │ +0001da50: 6f72 2061 2072 6573 706f 6e73 6520 6672  or a response fr
│ │ │ │ +0001da60: 6f6d 2061 204b 4443 2062 6566 6f72 6520  om a KDC before 
│ │ │ │ +0001da70: 636f 6e74 696e 7569 6e67 2074 6f0a 6e65  continuing to.ne
│ │ │ │ +0001da80: 7874 204b 4443 2066 6f72 2072 6561 6c6d  xt KDC for realm
│ │ │ │ +0001da90: 2e20 2054 6865 2064 6566 6175 6c74 2069  .  The default i
│ │ │ │ +0001daa0: 7320 3520 7365 636f 6e64 732e 2020 452e  s 5 seconds.  E.
│ │ │ │ +0001dab0: 672e 2c0a 0a20 2020 2020 6b64 632d 7469  g.,..     kdc-ti
│ │ │ │ +0001dac0: 6d65 6f75 743d 3130 0a0a 2020 2048 6f77  meout=10..   How
│ │ │ │ +0001dad0: 206d 616e 7920 7469 6d65 7320 7368 6973   many times shis
│ │ │ │ +0001dae0: 6869 2073 656e 6473 2061 2072 6571 7565  hi sends a reque
│ │ │ │ +0001daf0: 7374 2074 6f20 6120 4b44 4320 6265 666f  st to a KDC befo
│ │ │ │ +0001db00: 7265 2067 6976 696e 6720 7570 2e20 2054  re giving up.  T
│ │ │ │ +0001db10: 6865 0a64 6566 6175 6c74 2069 7320 3320  he.default is 3 
│ │ │ │ +0001db20: 7469 6d65 732e 2020 452e 672e 2c0a 0a20  times.  E.g.,.. 
│ │ │ │ +0001db30: 2020 2020 6b64 632d 7265 7472 6965 733d      kdc-retries=
│ │ │ │ +0001db40: 350a 0a34 2e34 2e38 20e2 8098 7374 7269  5..4.4.8 ...stri
│ │ │ │ +0001db50: 6e67 7072 6f63 6573 73e2 8099 0a2d 2d2d  ngprocess....---
│ │ │ │  0001db60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0001db70: 0a0a 486f 7720 7573 6572 6e61 6d65 2061  ..How username a
│ │ │ │ -0001db80: 6e64 2070 6173 7377 6f72 6473 2065 6e74  nd passwords ent
│ │ │ │ -0001db90: 6572 6564 2066 726f 6d20 7468 6520 7465  ered from the te
│ │ │ │ -0001dba0: 726d 696e 616c 2c20 6f72 2074 616b 656e  rminal, or taken
│ │ │ │ -0001dbb0: 2066 726f 6d20 7468 650a 636f 6d6d 616e   from the.comman
│ │ │ │ -0001dbc0: 6420 6c69 6e65 2c20 6172 6520 7072 6f63  d line, are proc
│ │ │ │ -0001dbd0: 6573 7365 642e 0a0a 2020 2022 6e6f 6e65  essed...   "none
│ │ │ │ -0001dbe0: 223a 206e 6f20 7072 6f63 6573 7369 6e67  ": no processing
│ │ │ │ -0001dbf0: 2069 7320 7573 6564 2e0a 0a20 2020 2273   is used...   "s
│ │ │ │ -0001dc00: 7472 696e 6770 7265 7022 3a20 636f 6e76  tringprep": conv
│ │ │ │ -0001dc10: 6572 7420 6672 6f6d 206c 6f63 616c 6520  ert from locale 
│ │ │ │ -0001dc20: 6368 6172 7365 7420 746f 2055 5446 2d38  charset to UTF-8
│ │ │ │ -0001dc30: 2061 6e64 2070 726f 6365 7373 2075 7369   and process usi
│ │ │ │ -0001dc40: 6e67 0a65 7870 6572 696d 656e 7461 6c20  ng.experimental 
│ │ │ │ -0001dc50: 5246 4320 3135 3130 2073 7472 696e 6770  RFC 1510 stringp
│ │ │ │ -0001dc60: 7265 7020 7072 6f66 696c 652e 0a0a 2020  rep profile...  
│ │ │ │ -0001dc70: 2049 7420 6361 6e20 616c 736f 2062 6520   It can also be 
│ │ │ │ -0001dc80: 6120 7374 7269 6e67 2069 6e64 6963 6174  a string indicat
│ │ │ │ -0001dc90: 696e 6720 6120 6368 6172 6163 7465 7220  ing a character 
│ │ │ │ -0001dca0: 7365 7420 7375 7070 6f72 7465 6420 6279  set supported by
│ │ │ │ -0001dcb0: 2069 636f 6e76 0a76 6961 206c 6962 7374   iconv.via libst
│ │ │ │ -0001dcc0: 7269 6e67 7072 6570 2c20 696e 2077 6869  ringprep, in whi
│ │ │ │ -0001dcd0: 6368 2063 6173 6520 6461 7461 2069 7320  ch case data is 
│ │ │ │ -0001dce0: 636f 6e76 6572 7465 6420 6672 6f6d 206c  converted from l
│ │ │ │ -0001dcf0: 6f63 616c 6520 6368 6172 7365 740a 696e  ocale charset.in
│ │ │ │ -0001dd00: 746f 2074 6865 2069 6e64 6963 6174 6564  to the indicated
│ │ │ │ -0001dd10: 2063 6861 7261 6374 6572 2073 6574 2e20   character set. 
│ │ │ │ -0001dd20: 2045 2e67 2e2c 2055 5446 2d38 2c20 4953   E.g., UTF-8, IS
│ │ │ │ -0001dd30: 4f2d 3838 3539 2d31 2c20 4b4f 492d 382c  O-8859-1, KOI-8,
│ │ │ │ -0001dd40: 0a45 4243 4449 432d 4953 2d46 5249 5353  .EBCDIC-IS-FRISS
│ │ │ │ -0001dd50: 2061 7265 2073 7570 706f 7274 6564 206f   are supported o
│ │ │ │ -0001dd60: 6e20 474e 5520 7379 7374 656d 732e 2020  n GNU systems.  
│ │ │ │ -0001dd70: 4f6e 2073 6f6d 6520 7379 7374 656d 7320  On some systems 
│ │ │ │ -0001dd80: 796f 7520 6361 6e0a 7573 6520 226c 6f63  you can.use "loc
│ │ │ │ -0001dd90: 616c 6520 2d6d 2220 746f 206c 6973 7420  ale -m" to list 
│ │ │ │ -0001dda0: 6176 6169 6c61 626c 6520 6368 6172 6163  available charac
│ │ │ │ -0001ddb0: 7465 7220 7365 7473 2e20 2042 7920 6465  ter sets.  By de
│ │ │ │ -0001ddc0: 6661 756c 742c 2074 6865 0a22 6e6f 6e65  fault, the."none
│ │ │ │ -0001ddd0: 2220 7365 7474 696e 6720 6973 2075 7365  " setting is use
│ │ │ │ -0001dde0: 6420 7768 6963 6820 6973 2063 6f6e 7369  d which is consi
│ │ │ │ -0001ddf0: 7374 656e 7420 7769 7468 2052 4643 2031  stent with RFC 1
│ │ │ │ -0001de00: 3531 3020 7468 6174 2069 7320 7369 6c65  510 that is sile
│ │ │ │ -0001de10: 6e74 0a6f 6e20 7468 6520 6973 7375 652e  nt.on the issue.
│ │ │ │ -0001de20: 2020 496e 2070 7261 6374 6963 652c 2068    In practice, h
│ │ │ │ -0001de30: 6f77 6576 6572 2c20 636f 6e76 6572 7469  owever, converti
│ │ │ │ -0001de40: 6e67 2074 6f20 5554 462d 3820 696d 7072  ng to UTF-8 impr
│ │ │ │ -0001de50: 6f76 6573 0a69 6e74 6572 6f70 6572 6162  oves.interoperab
│ │ │ │ -0001de60: 696c 6974 792e 0a0a 2020 2045 2e67 2e2c  ility...   E.g.,
│ │ │ │ -0001de70: 0a0a 2020 2020 2073 7472 696e 6770 726f  ..     stringpro
│ │ │ │ -0001de80: 6365 7373 3d55 5446 2d38 0a0a 342e 342e  cess=UTF-8..4.4.
│ │ │ │ -0001de90: 3920 e280 9874 6963 6b65 742d 6c69 6665  9 ...ticket-life
│ │ │ │ -0001dea0: e280 990a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ....------------
│ │ │ │ -0001deb0: 2d2d 2d2d 2d2d 2d0a 0a53 7065 6369 6679  -------..Specify
│ │ │ │ -0001dec0: 2064 6566 6175 6c74 2074 6963 6b65 7420   default ticket 
│ │ │ │ -0001ded0: 6c69 6665 2074 696d 652e 0a0a 2020 2054  life time...   T
│ │ │ │ -0001dee0: 6865 2073 7472 696e 6720 6361 6e20 6265  he string can be
│ │ │ │ -0001def0: 2069 6e20 616c 6d6f 7374 2061 6e79 2063   in almost any c
│ │ │ │ -0001df00: 6f6d 6d6f 6e20 666f 726d 6174 2e20 2049  ommon format.  I
│ │ │ │ -0001df10: 7420 6361 6e20 636f 6e74 6169 6e20 6d6f  t can contain mo
│ │ │ │ -0001df20: 6e74 680a 6e61 6d65 732c 2074 696d 6520  nth.names, time 
│ │ │ │ -0001df30: 7a6f 6e65 732c 2027 616d 2720 616e 6420  zones, 'am' and 
│ │ │ │ -0001df40: 2770 6d27 2c20 2779 6573 7465 7264 6179  'pm', 'yesterday
│ │ │ │ -0001df50: 272c 2027 6167 6f27 2c20 276e 6578 7427  ', 'ago', 'next'
│ │ │ │ -0001df60: 2c20 6574 632e 0a2a 4e6f 7465 2044 6174  , etc..*Note Dat
│ │ │ │ -0001df70: 6520 696e 7075 7420 666f 726d 6174 733a  e input formats:
│ │ │ │ -0001df80: 3a2c 2066 6f72 2074 6865 206c 6f6e 6720  :, for the long 
│ │ │ │ -0001df90: 7374 6f72 792e 0a0a 2020 2041 7320 616e  story...   As an
│ │ │ │ -0001dfa0: 2065 7874 7261 2066 6561 7475 7265 2c20   extra feature, 
│ │ │ │ -0001dfb0: 6966 2074 6865 2074 696d 6520 7370 6563  if the time spec
│ │ │ │ -0001dfc0: 6966 6965 6420 6279 2079 6f75 7220 7374  ified by your st
│ │ │ │ -0001dfd0: 7269 6e67 2063 6f72 7265 7370 6f6e 640a  ring correspond.
│ │ │ │ -0001dfe0: 746f 2061 2074 696d 6520 6475 7269 6e67  to a time during
│ │ │ │ -0001dff0: 2074 6865 206c 6173 7420 3234 2068 6f75   the last 24 hou
│ │ │ │ -0001e000: 7273 2c20 616e 2065 7874 7261 2064 6179  rs, an extra day
│ │ │ │ -0001e010: 2069 7320 6164 6465 6420 746f 2069 742e   is added to it.
│ │ │ │ -0001e020: 2020 5468 6973 0a61 6c6c 6f77 7320 796f    This.allows yo
│ │ │ │ -0001e030: 7520 746f 2073 7065 6369 6679 2072 656c  u to specify rel
│ │ │ │ -0001e040: 6174 6976 6520 7469 6d65 7320 7375 6368  ative times such
│ │ │ │ -0001e050: 2061 7320 2231 373a 3030 2220 746f 2061   as "17:00" to a
│ │ │ │ -0001e060: 6c77 6179 7320 6d65 616e 2074 6865 0a6e  lways mean the.n
│ │ │ │ -0001e070: 6578 7420 3137 3a30 302c 2065 7665 6e20  ext 17:00, even 
│ │ │ │ -0001e080: 6966 2079 6f75 7220 7379 7374 656d 2063  if your system c
│ │ │ │ -0001e090: 6c6f 636b 2068 6170 7065 6e73 2074 6f20  lock happens to 
│ │ │ │ -0001e0a0: 6265 2031 373a 3330 2e0a 0a20 2020 5468  be 17:30...   Th
│ │ │ │ -0001e0b0: 6520 6465 6661 756c 7420 6973 2038 2068  e default is 8 h
│ │ │ │ -0001e0c0: 6f75 7273 2e0a 0a20 2020 452e 672e 2c0a  ours...   E.g.,.
│ │ │ │ -0001e0d0: 0a20 2020 2020 2374 6963 6b65 742d 6c69  .     #ticket-li
│ │ │ │ -0001e0e0: 6665 3d38 2068 6f75 7273 0a20 2020 2020  fe=8 hours.     
│ │ │ │ -0001e0f0: 2374 6963 6b65 742d 6c69 6665 3d31 2064  #ticket-life=1 d
│ │ │ │ -0001e100: 6179 0a20 2020 2020 7469 636b 6574 2d6c  ay.     ticket-l
│ │ │ │ -0001e110: 6966 653d 3137 3a30 300a 0a34 2e34 2e31  ife=17:00..4.4.1
│ │ │ │ -0001e120: 3020 e280 9872 656e 6577 2d6c 6966 65e2  0 ...renew-life.
│ │ │ │ -0001e130: 8099 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ...-------------
│ │ │ │ -0001e140: 2d2d 2d2d 2d2d 0a0a 5370 6563 6966 7920  ------..Specify 
│ │ │ │ -0001e150: 686f 7720 6c6f 6e67 2061 2072 656e 6577  how long a renew
│ │ │ │ -0001e160: 6162 6c65 2074 6963 6b65 7420 7368 6f75  able ticket shou
│ │ │ │ -0001e170: 6c64 2072 656d 6169 6e20 7265 6e65 7761  ld remain renewa
│ │ │ │ -0001e180: 626c 652e 0a0a 2020 2053 6565 2074 6963  ble...   See tic
│ │ │ │ -0001e190: 6b65 742d 6c69 6665 2066 6f72 2074 6865  ket-life for the
│ │ │ │ -0001e1a0: 2073 796e 7461 782e 2020 5468 6520 6578   syntax.  The ex
│ │ │ │ -0001e1b0: 7472 6120 6665 6174 7572 6520 7468 6174  tra feature that
│ │ │ │ -0001e1c0: 2068 616e 646c 6573 0a6e 6567 6174 6976   handles.negativ
│ │ │ │ -0001e1d0: 6520 7661 6c75 6573 2077 6974 6869 6e20  e values within 
│ │ │ │ -0001e1e0: 7468 6520 6c61 7374 2032 2068 6f75 7273  the last 2 hours
│ │ │ │ -0001e1f0: 2069 7320 6e6f 7420 6163 7469 7665 2068   is not active h
│ │ │ │ -0001e200: 6572 652e 0a0a 2020 2054 6865 2064 6566  ere...   The def
│ │ │ │ -0001e210: 6175 6c74 2069 7320 3720 6461 7973 2e0a  ault is 7 days..
│ │ │ │ -0001e220: 0a20 2020 452e 672e 2c0a 0a20 2020 2020  .   E.g.,..     
│ │ │ │ -0001e230: 2372 656e 6577 2d6c 6966 653d 3120 7765  #renew-life=1 we
│ │ │ │ -0001e240: 656b 0a20 2020 2020 2372 656e 6577 2d6c  ek.     #renew-l
│ │ │ │ -0001e250: 6966 653d 6672 6964 6179 2031 373a 3030  ife=friday 17:00
│ │ │ │ -0001e260: 0a20 2020 2020 7265 6e65 772d 6c69 6665  .     renew-life
│ │ │ │ -0001e270: 3d73 756e 6461 790a 0a1f 0a46 696c 653a  =sunday....File:
│ │ │ │ -0001e280: 2073 6869 7368 692e 696e 666f 2c20 204e   shishi.info,  N
│ │ │ │ -0001e290: 6f64 653a 2053 6869 7361 2043 6f6e 6669  ode: Shisa Confi
│ │ │ │ -0001e2a0: 6775 7261 7469 6f6e 2c20 204e 6578 743a  guration,  Next:
│ │ │ │ -0001e2b0: 2050 6172 616d 6574 6572 7320 666f 7220   Parameters for 
│ │ │ │ -0001e2c0: 7368 6973 6869 2c20 2050 7265 763a 2053  shishi,  Prev: S
│ │ │ │ -0001e2d0: 6869 7368 6920 436f 6e66 6967 7572 6174  hishi Configurat
│ │ │ │ -0001e2e0: 696f 6e2c 2020 5570 3a20 5265 6665 7265  ion,  Up: Refere
│ │ │ │ -0001e2f0: 6e63 6520 4d61 6e75 616c 0a0a 342e 3520  nce Manual..4.5 
│ │ │ │ -0001e300: 5368 6973 6120 436f 6e66 6967 7572 6174  Shisa Configurat
│ │ │ │ -0001e310: 696f 6e0a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ion.============
│ │ │ │ -0001e320: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a54 6865  ===========..The
│ │ │ │ -0001e330: 2063 6f6e 6669 6775 7261 7469 6f6e 2066   configuration f
│ │ │ │ -0001e340: 696c 6520 666f 7220 5368 6973 6120 6973  ile for Shisa is
│ │ │ │ -0001e350: 2074 7970 6963 616c 6c79 2073 746f 7265   typically store
│ │ │ │ -0001e360: 6420 696e 0ae2 8098 2f75 7372 2f6c 6f63  d in..../usr/loc
│ │ │ │ -0001e370: 616c 2f65 7463 2f73 6869 7368 692f 7368  al/etc/shishi/sh
│ │ │ │ -0001e380: 6973 612e 636f 6e66 e280 992e 2020 4966  isa.conf....  If
│ │ │ │ -0001e390: 2074 6865 2066 6972 7374 206e 6f6e 2077   the first non w
│ │ │ │ -0001e3a0: 6869 7465 2073 7061 6365 0a63 6861 7261  hite space.chara
│ │ │ │ -0001e3b0: 6374 6572 206f 6620 6120 6c69 6e65 2069  cter of a line i
│ │ │ │ -0001e3c0: 7320 6120 2723 272c 2074 6865 206c 696e  s a '#', the lin
│ │ │ │ -0001e3d0: 6520 6973 2069 676e 6f72 6564 2e20 2045  e is ignored.  E
│ │ │ │ -0001e3e0: 6d70 7479 206c 696e 6573 2061 7265 2061  mpty lines are a
│ │ │ │ -0001e3f0: 6c73 6f0a 6967 6e6f 7265 642e 0a0a 342e  lso.ignored...4.
│ │ │ │ -0001e400: 352e 3120 e280 9864 62e2 8099 0a2d 2d2d  5.1 ...db....---
│ │ │ │ -0001e410: 2d2d 2d2d 2d2d 2d0a 0a43 7572 7265 6e74  -------..Current
│ │ │ │ -0001e420: 6c79 2074 6865 206f 6e6c 7920 636f 6e66  ly the only conf
│ │ │ │ -0001e430: 6967 7572 6174 696f 6e20 6f70 7469 6f6e  iguration option
│ │ │ │ -0001e440: 7320 6176 6169 6c61 626c 6520 6973 2074  s available is t
│ │ │ │ -0001e450: 6865 20e2 8098 6462 e280 9920 746f 6b65  he ...db... toke
│ │ │ │ -0001e460: 6e0a 7468 6174 2064 6566 696e 6520 7468  n.that define th
│ │ │ │ -0001e470: 6520 6461 7461 6261 7365 7320 746f 2075  e databases to u
│ │ │ │ -0001e480: 7365 2e20 2054 6865 2073 796e 7461 7820  se.  The syntax 
│ │ │ │ -0001e490: 6973 3a0a 0a20 2020 2020 6462 205b 4f50  is:..     db [OP
│ │ │ │ -0001e4a0: 5449 4f4e 535d 203c 5459 5045 3e20 5b4c  TIONS] <TYPE> [L
│ │ │ │ -0001e4b0: 4f43 4154 494f 4e5d 205b 5041 5241 4d45  OCATION] [PARAME
│ │ │ │ -0001e4c0: 5445 5253 202e 2e2e 5d0a 0a20 2020 5370  TERS ...]..   Sp
│ │ │ │ -0001e4d0: 6563 6966 7920 7468 6520 6461 7461 2073  ecify the data s
│ │ │ │ -0001e4e0: 6f75 7263 6573 2066 6f72 204b 6572 6265  ources for Kerbe
│ │ │ │ -0001e4f0: 726f 7320 3520 6461 7461 2e20 204d 756c  ros 5 data.  Mul
│ │ │ │ -0001e500: 7469 706c 6520 656e 7472 6965 732c 2065  tiple entries, e
│ │ │ │ -0001e510: 7665 6e0a 6f66 2074 6865 2073 616d 6520  ven.of the same 
│ │ │ │ -0001e520: 6461 7461 2073 6f75 7263 6520 7479 7065  data source type
│ │ │ │ -0001e530: 2c20 6172 6520 616c 6c6f 7765 642e 2020  , are allowed.  
│ │ │ │ -0001e540: 5468 6520 6461 7461 2073 6f75 7263 6573  The data sources
│ │ │ │ -0001e550: 2061 7265 0a61 6363 6573 7365 6420 696e   are.accessed in
│ │ │ │ -0001e560: 2074 6865 2073 616d 6520 7365 7175 656e   the same sequen
│ │ │ │ -0001e570: 6365 2061 7320 7468 6579 2061 7265 2064  ce as they are d
│ │ │ │ -0001e580: 6566 696e 6564 2068 6572 652e 2020 4966  efined here.  If
│ │ │ │ -0001e590: 2061 6e20 656e 7472 7920 6973 0a66 6f75   an entry is.fou
│ │ │ │ -0001e5a0: 6e64 2069 6e20 6f6e 6520 6461 7461 2073  nd in one data s
│ │ │ │ -0001e5b0: 6f75 7263 652c 2069 7420 7769 6c6c 2062  ource, it will b
│ │ │ │ -0001e5c0: 6520 7573 6564 2066 6f72 2074 6865 206f  e used for the o
│ │ │ │ -0001e5d0: 7065 7261 7469 6f6e 732c 2077 6974 686f  perations, witho
│ │ │ │ -0001e5e0: 7574 0a73 6561 7263 6869 6e67 2074 6865  ut.searching the
│ │ │ │ -0001e5f0: 2072 656d 6169 6e69 6e67 2064 6174 6120   remaining data 
│ │ │ │ -0001e600: 736f 7572 6365 732e 2020 5661 6c69 6420  sources.  Valid 
│ │ │ │ -0001e610: 4f50 5449 4f4e 5320 696e 636c 7564 653a  OPTIONS include:
│ │ │ │ -0001e620: 0a0a 2020 2020 202d 2d72 6561 642d 6f6e  ..     --read-on
│ │ │ │ -0001e630: 6c79 2020 2020 2020 204e 6f20 6461 7461  ly       No data
│ │ │ │ -0001e640: 2069 7320 7772 6974 7465 6e20 746f 2074   is written to t
│ │ │ │ -0001e650: 6869 7320 6461 7461 2073 6f75 7263 652e  his data source.
│ │ │ │ -0001e660: 0a20 2020 2020 2d2d 6967 6e6f 7265 2d65  .     --ignore-e
│ │ │ │ -0001e670: 7272 6f72 7320 2020 4967 6e6f 7265 2066  rrors   Ignore f
│ │ │ │ -0001e680: 6169 6c75 7265 7320 696e 2074 6869 7320  ailures in this 
│ │ │ │ -0001e690: 6261 636b 656e 642e 0a0a 2020 2054 6865  backend...   The
│ │ │ │ -0001e6a0: 2064 6566 6175 6c74 2028 7768 656e 2074   default (when t
│ │ │ │ -0001e6b0: 6865 2063 6f6e 6669 6775 7261 7469 6f6e  he configuration
│ │ │ │ -0001e6c0: 2066 696c 6520 6973 2065 6d70 7479 2920   file is empty) 
│ │ │ │ -0001e6d0: 7573 6573 206f 6e65 2022 6669 6c65 220a  uses one "file".
│ │ │ │ -0001e6e0: 6461 7461 2073 6f75 7263 6520 2873 6565  data source (see
│ │ │ │ -0001e6f0: 2062 656c 6f77 292c 2062 7574 2066 6f72   below), but for
│ │ │ │ -0001e700: 2061 206c 6172 6765 7220 696e 7374 616c   a larger instal
│ │ │ │ -0001e710: 6c61 7469 6f6e 2079 6f75 206d 6179 2077  lation you may w
│ │ │ │ -0001e720: 616e 7420 746f 0a63 6f6d 6269 6e65 2073  ant to.combine s
│ │ │ │ -0001e730: 6576 6572 616c 2064 6174 6120 736f 7572  everal data sour
│ │ │ │ -0001e740: 6365 732e 2020 4865 7265 2069 7320 616e  ces.  Here is an
│ │ │ │ -0001e750: 2065 7861 6d70 6c65 2e0a 0a20 2020 2020   example...     
│ │ │ │ -0001e760: 6462 202d 2d72 6561 642d 6f6e 6c79 2066  db --read-only f
│ │ │ │ -0001e770: 696c 6520 2f76 6172 2f6c 6f63 616c 2f6d  ile /var/local/m
│ │ │ │ -0001e780: 6173 7465 720a 2020 2020 2064 6220 2d2d  aster.     db --
│ │ │ │ -0001e790: 6967 6e6f 7265 2d65 7272 6f72 7320 6c64  ignore-errors ld
│ │ │ │ -0001e7a0: 6170 206b 6463 2e65 7861 6d70 6c65 2e6f  ap kdc.example.o
│ │ │ │ -0001e7b0: 7267 2063 613d 2f65 7463 2f73 6869 7361  rg ca=/etc/shisa
│ │ │ │ -0001e7c0: 2f6b 6463 2d63 612e 7065 6d0a 2020 2020  /kdc-ca.pem.    
│ │ │ │ -0001e7d0: 2064 6220 2d2d 7265 6164 2d6f 6e6c 7920   db --read-only 
│ │ │ │ -0001e7e0: 6669 6c65 202f 7661 722f 6361 6368 652f  file /var/cache/
│ │ │ │ -0001e7f0: 6c64 6170 2d63 6f70 790a 0a20 2020 5468  ldap-copy..   Th
│ │ │ │ -0001e800: 6973 2064 656d 6f6e 7374 7261 7465 2068  is demonstrate h
│ │ │ │ -0001e810: 6f77 2079 6f75 2063 616e 2073 746f 7265  ow you can store
│ │ │ │ -0001e820: 2063 7269 7469 6361 6c20 7072 696e 6369   critical princi
│ │ │ │ -0001e830: 7061 6c73 206f 6e20 6c6f 6361 6c20 6469  pals on local di
│ │ │ │ -0001e840: 736b 0a28 7468 6520 6669 7273 7420 656e  sk.(the first en
│ │ │ │ -0001e850: 7472 792c 202f 7661 722f 6c6f 6361 6c2f  try, /var/local/
│ │ │ │ -0001e860: 6d61 7374 6572 2920 7468 6174 2077 696c  master) that wil
│ │ │ │ -0001e870: 6c20 616c 7761 7973 2062 6520 666f 756e  l always be foun
│ │ │ │ -0001e880: 6420 7769 7468 6f75 740a 6c6f 6f6b 696e  d without.lookin
│ │ │ │ -0001e890: 6720 696e 2074 6865 204c 4441 5020 6469  g in the LDAP di
│ │ │ │ -0001e8a0: 7265 6374 6f72 792e 2020 5468 6520 6372  rectory.  The cr
│ │ │ │ -0001e8b0: 6974 6963 616c 2070 7269 6e63 6970 616c  itical principal
│ │ │ │ -0001e8c0: 7320 636f 756c 6420 6265 2c20 652e 672e  s could be, e.g.
│ │ │ │ -0001e8d0: 2c0a 6b72 6274 6774 2f45 5841 4d50 4c45  ,.krbtgt/EXAMPLE
│ │ │ │ -0001e8e0: 2e4f 5247 2e20 2054 6865 2073 6563 6f6e  .ORG.  The secon
│ │ │ │ -0001e8f0: 6420 656e 7472 7920 6465 6e6f 7465 2061  d entry denote a
│ │ │ │ -0001e900: 204c 4441 5020 7365 7276 6572 2074 6861   LDAP server tha
│ │ │ │ -0001e910: 7420 636f 756c 640a 686f 6c64 2075 7365  t could.hold use
│ │ │ │ -0001e920: 7220 7072 696e 6369 7061 6c73 2e20 2041  r principals.  A
│ │ │ │ -0001e930: 7320 796f 7520 6361 6e20 7365 652c 2053  s you can see, S
│ │ │ │ -0001e940: 6869 7361 2077 696c 6c20 6e6f 7420 6c65  hisa will not le
│ │ │ │ -0001e950: 7420 7468 6520 6361 6c6c 6572 0a6b 6e6f  t the caller.kno
│ │ │ │ -0001e960: 7720 6162 6f75 7420 6572 726f 7273 2077  w about errors w
│ │ │ │ -0001e970: 6974 6820 7468 6520 4c44 4150 2073 6f75  ith the LDAP sou
│ │ │ │ -0001e980: 7263 6520 2874 6865 7920 7769 6c6c 2062  rce (they will b
│ │ │ │ -0001e990: 6520 6c6f 6767 6564 2c20 686f 7765 7665  e logged, howeve
│ │ │ │ -0001e9a0: 7229 2e0a 496e 7374 6561 642c 2069 6620  r)..Instead, if 
│ │ │ │ -0001e9b0: 666f 7220 696e 7374 616e 6365 2074 6865  for instance the
│ │ │ │ -0001e9c0: 204c 4441 5020 7365 7276 6572 2068 6173   LDAP server has
│ │ │ │ -0001e9d0: 2063 7261 7368 6564 2c20 5368 6973 6120   crashed, Shisa 
│ │ │ │ -0001e9e0: 776f 756c 640a 636f 6e74 696e 7565 2061  would.continue a
│ │ │ │ -0001e9f0: 6e64 2072 6561 6420 6672 6f6d 2074 6865  nd read from the
│ │ │ │ -0001ea00: 202f 7661 722f 6361 6368 652f 6c64 6170   /var/cache/ldap
│ │ │ │ -0001ea10: 2d63 6f70 7920 6669 6c65 2073 6f75 7263  -copy file sourc
│ │ │ │ -0001ea20: 652e 2020 5468 6174 2066 696c 650a 736f  e.  That file.so
│ │ │ │ -0001ea30: 7572 6365 206d 6179 2068 6176 6520 6265  urce may have be
│ │ │ │ -0001ea40: 656e 2073 6574 2075 7020 746f 2063 6f6e  en set up to con
│ │ │ │ -0001ea50: 7461 696e 2061 2063 6f70 7920 6f66 2074  tain a copy of t
│ │ │ │ -0001ea60: 6865 2064 6174 6120 696e 2074 6865 204c  he data in the L
│ │ │ │ -0001ea70: 4441 500a 7365 7276 6572 2c20 7065 7268  DAP.server, perh
│ │ │ │ -0001ea80: 6170 7320 6d61 6465 206f 6e20 616e 2068  aps made on an h
│ │ │ │ -0001ea90: 6f75 726c 7920 6261 7369 732c 2073 6f20  ourly basis, so 
│ │ │ │ -0001eaa0: 7468 6174 2079 6f75 7220 7365 7276 6572  that your server
│ │ │ │ -0001eab0: 2077 696c 6c20 6265 0a61 626c 6520 746f   will be.able to
│ │ │ │ -0001eac0: 2073 6572 7665 2072 6563 656e 7420 6461   serve recent da
│ │ │ │ -0001ead0: 7461 2065 7665 6e20 696e 2063 6173 6520  ta even in case 
│ │ │ │ -0001eae0: 6f66 2061 2063 7261 7368 2e20 2041 6e79  of a crash.  Any
│ │ │ │ -0001eaf0: 2075 7064 6174 6573 206f 720a 7061 7373   updates or.pass
│ │ │ │ -0001eb00: 776f 7264 7320 6368 616e 6765 2072 6571  words change req
│ │ │ │ -0001eb10: 7565 7374 7320 7769 6c6c 2068 6f77 6576  uests will howev
│ │ │ │ -0001eb20: 6572 206e 6f74 2062 6520 706f 7373 6962  er not be possib
│ │ │ │ -0001eb30: 6c65 2077 6869 6c65 2074 6865 204c 4441  le while the LDA
│ │ │ │ -0001eb40: 500a 7365 7276 6572 2069 7320 696e 6163  P.server is inac
│ │ │ │ -0001eb50: 6365 7373 6962 6c65 2c20 746f 2072 6564  cessible, to red
│ │ │ │ -0001eb60: 7563 6520 7468 6520 7072 6f62 6c65 6d20  uce the problem 
│ │ │ │ -0001eb70: 6f66 2073 796e 6368 726f 6e69 7a69 6e67  of synchronizing
│ │ │ │ -0001eb80: 2064 6174 6120 6261 636b 0a69 6e74 6f20   data back.into 
│ │ │ │ -0001eb90: 7468 6520 4c44 4150 2073 6572 7665 7220  the LDAP server 
│ │ │ │ -0001eba0: 6f6e 6365 2069 7420 6973 206f 6e6c 696e  once it is onlin
│ │ │ │ -0001ebb0: 6520 6167 6169 6e2e 0a0a 2020 2043 7572  e again...   Cur
│ │ │ │ -0001ebc0: 7265 6e74 6c79 206f 6e6c 7920 7468 6520  rently only the 
│ │ │ │ -0001ebd0: 2266 696c 6522 2064 6174 6120 736f 7572  "file" data sour
│ │ │ │ -0001ebe0: 6365 2069 7320 7375 7070 6f72 7465 642c  ce is supported,
│ │ │ │ -0001ebf0: 2061 6e64 2064 656e 6f74 6520 6120 6461   and denote a da
│ │ │ │ -0001ec00: 7461 0a73 6f75 7263 6520 7468 6174 2075  ta.source that u
│ │ │ │ -0001ec10: 7365 2074 6865 2073 7461 6e64 6172 6420  se the standard 
│ │ │ │ -0001ec20: 6669 6c65 2073 7973 7465 6d20 666f 7220  file system for 
│ │ │ │ -0001ec30: 7374 6f72 6167 652e 0a0a 2020 2056 616c  storage...   Val
│ │ │ │ -0001ec40: 6964 2073 796e 7461 7865 7320 666f 7220  id syntaxes for 
│ │ │ │ -0001ec50: 7468 6520 2266 696c 6522 2064 6174 6162  the "file" datab
│ │ │ │ -0001ec60: 6173 653a 0a0a 2020 2020 2064 6220 6669  ase:..     db fi
│ │ │ │ -0001ec70: 6c65 2050 4154 480a 0a20 2020 4578 616d  le PATH..   Exam
│ │ │ │ -0001ec80: 706c 6573 3a0a 0a20 2020 2020 6462 2066  ples:..     db f
│ │ │ │ -0001ec90: 696c 6520 2f76 6172 2f73 6869 7368 690a  ile /var/shishi.
│ │ │ │ -0001eca0: 2020 2020 2064 6220 6669 6c65 202f 7573       db file /us
│ │ │ │ -0001ecb0: 722f 7368 6172 652f 7368 6973 6869 2072  r/share/shishi r
│ │ │ │ -0001ecc0: 6561 642d 6f6e 6c79 0a0a 2020 2049 6620  ead-only..   If 
│ │ │ │ -0001ecd0: 6e6f 20e2 8098 6462 e280 9920 746f 6b65  no ...db... toke
│ │ │ │ -0001ece0: 6e73 2061 7265 2070 7265 7365 6e74 2c20  ns are present, 
│ │ │ │ -0001ecf0: 7468 6520 6465 6661 756c 7420 7769 6c6c  the default will
│ │ │ │ -0001ed00: 2062 653a 0a0a 2020 2020 2064 6220 6669   be:..     db fi
│ │ │ │ -0001ed10: 6c65 202f 7573 722f 6c6f 6361 6c2f 7661  le /usr/local/va
│ │ │ │ -0001ed20: 722f 7368 6973 6869 0a0a 1f0a 4669 6c65  r/shishi....File
│ │ │ │ -0001ed30: 3a20 7368 6973 6869 2e69 6e66 6f2c 2020  : shishi.info,  
│ │ │ │ -0001ed40: 4e6f 6465 3a20 5061 7261 6d65 7465 7273  Node: Parameters
│ │ │ │ -0001ed50: 2066 6f72 2073 6869 7368 692c 2020 4e65   for shishi,  Ne
│ │ │ │ -0001ed60: 7874 3a20 5061 7261 6d65 7465 7273 2066  xt: Parameters f
│ │ │ │ -0001ed70: 6f72 2073 6869 7368 6964 2c20 2050 7265  or shishid,  Pre
│ │ │ │ -0001ed80: 763a 2053 6869 7361 2043 6f6e 6669 6775  v: Shisa Configu
│ │ │ │ -0001ed90: 7261 7469 6f6e 2c20 2055 703a 2052 6566  ration,  Up: Ref
│ │ │ │ -0001eda0: 6572 656e 6365 204d 616e 7561 6c0a 0a34  erence Manual..4
│ │ │ │ -0001edb0: 2e36 2050 6172 616d 6574 6572 7320 666f  .6 Parameters fo
│ │ │ │ -0001edc0: 7220 7368 6973 6869 0a3d 3d3d 3d3d 3d3d  r shishi.=======
│ │ │ │ +0001db70: 2d2d 0a0a 486f 7720 7573 6572 6e61 6d65  --..How username
│ │ │ │ +0001db80: 2061 6e64 2070 6173 7377 6f72 6473 2065   and passwords e
│ │ │ │ +0001db90: 6e74 6572 6564 2066 726f 6d20 7468 6520  ntered from the 
│ │ │ │ +0001dba0: 7465 726d 696e 616c 2c20 6f72 2074 616b  terminal, or tak
│ │ │ │ +0001dbb0: 656e 2066 726f 6d20 7468 650a 636f 6d6d  en from the.comm
│ │ │ │ +0001dbc0: 616e 6420 6c69 6e65 2c20 6172 6520 7072  and line, are pr
│ │ │ │ +0001dbd0: 6f63 6573 7365 642e 0a0a 2020 2022 6e6f  ocessed...   "no
│ │ │ │ +0001dbe0: 6e65 223a 206e 6f20 7072 6f63 6573 7369  ne": no processi
│ │ │ │ +0001dbf0: 6e67 2069 7320 7573 6564 2e0a 0a20 2020  ng is used...   
│ │ │ │ +0001dc00: 2273 7472 696e 6770 7265 7022 3a20 636f  "stringprep": co
│ │ │ │ +0001dc10: 6e76 6572 7420 6672 6f6d 206c 6f63 616c  nvert from local
│ │ │ │ +0001dc20: 6520 6368 6172 7365 7420 746f 2055 5446  e charset to UTF
│ │ │ │ +0001dc30: 2d38 2061 6e64 2070 726f 6365 7373 2075  -8 and process u
│ │ │ │ +0001dc40: 7369 6e67 0a65 7870 6572 696d 656e 7461  sing.experimenta
│ │ │ │ +0001dc50: 6c20 5246 4320 3135 3130 2073 7472 696e  l RFC 1510 strin
│ │ │ │ +0001dc60: 6770 7265 7020 7072 6f66 696c 652e 0a0a  gprep profile...
│ │ │ │ +0001dc70: 2020 2049 7420 6361 6e20 616c 736f 2062     It can also b
│ │ │ │ +0001dc80: 6520 6120 7374 7269 6e67 2069 6e64 6963  e a string indic
│ │ │ │ +0001dc90: 6174 696e 6720 6120 6368 6172 6163 7465  ating a characte
│ │ │ │ +0001dca0: 7220 7365 7420 7375 7070 6f72 7465 6420  r set supported 
│ │ │ │ +0001dcb0: 6279 2069 636f 6e76 0a76 6961 206c 6962  by iconv.via lib
│ │ │ │ +0001dcc0: 7374 7269 6e67 7072 6570 2c20 696e 2077  stringprep, in w
│ │ │ │ +0001dcd0: 6869 6368 2063 6173 6520 6461 7461 2069  hich case data i
│ │ │ │ +0001dce0: 7320 636f 6e76 6572 7465 6420 6672 6f6d  s converted from
│ │ │ │ +0001dcf0: 206c 6f63 616c 6520 6368 6172 7365 740a   locale charset.
│ │ │ │ +0001dd00: 696e 746f 2074 6865 2069 6e64 6963 6174  into the indicat
│ │ │ │ +0001dd10: 6564 2063 6861 7261 6374 6572 2073 6574  ed character set
│ │ │ │ +0001dd20: 2e20 2045 2e67 2e2c 2055 5446 2d38 2c20  .  E.g., UTF-8, 
│ │ │ │ +0001dd30: 4953 4f2d 3838 3539 2d31 2c20 4b4f 492d  ISO-8859-1, KOI-
│ │ │ │ +0001dd40: 382c 0a45 4243 4449 432d 4953 2d46 5249  8,.EBCDIC-IS-FRI
│ │ │ │ +0001dd50: 5353 2061 7265 2073 7570 706f 7274 6564  SS are supported
│ │ │ │ +0001dd60: 206f 6e20 474e 5520 7379 7374 656d 732e   on GNU systems.
│ │ │ │ +0001dd70: 2020 4f6e 2073 6f6d 6520 7379 7374 656d    On some system
│ │ │ │ +0001dd80: 7320 796f 7520 6361 6e0a 7573 6520 226c  s you can.use "l
│ │ │ │ +0001dd90: 6f63 616c 6520 2d6d 2220 746f 206c 6973  ocale -m" to lis
│ │ │ │ +0001dda0: 7420 6176 6169 6c61 626c 6520 6368 6172  t available char
│ │ │ │ +0001ddb0: 6163 7465 7220 7365 7473 2e20 2042 7920  acter sets.  By 
│ │ │ │ +0001ddc0: 6465 6661 756c 742c 2074 6865 0a22 6e6f  default, the."no
│ │ │ │ +0001ddd0: 6e65 2220 7365 7474 696e 6720 6973 2075  ne" setting is u
│ │ │ │ +0001dde0: 7365 6420 7768 6963 6820 6973 2063 6f6e  sed which is con
│ │ │ │ +0001ddf0: 7369 7374 656e 7420 7769 7468 2052 4643  sistent with RFC
│ │ │ │ +0001de00: 2031 3531 3020 7468 6174 2069 7320 7369   1510 that is si
│ │ │ │ +0001de10: 6c65 6e74 0a6f 6e20 7468 6520 6973 7375  lent.on the issu
│ │ │ │ +0001de20: 652e 2020 496e 2070 7261 6374 6963 652c  e.  In practice,
│ │ │ │ +0001de30: 2068 6f77 6576 6572 2c20 636f 6e76 6572   however, conver
│ │ │ │ +0001de40: 7469 6e67 2074 6f20 5554 462d 3820 696d  ting to UTF-8 im
│ │ │ │ +0001de50: 7072 6f76 6573 0a69 6e74 6572 6f70 6572  proves.interoper
│ │ │ │ +0001de60: 6162 696c 6974 792e 0a0a 2020 2045 2e67  ability...   E.g
│ │ │ │ +0001de70: 2e2c 0a0a 2020 2020 2073 7472 696e 6770  .,..     stringp
│ │ │ │ +0001de80: 726f 6365 7373 3d55 5446 2d38 0a0a 342e  rocess=UTF-8..4.
│ │ │ │ +0001de90: 342e 3920 e280 9874 6963 6b65 742d 6c69  4.9 ...ticket-li
│ │ │ │ +0001dea0: 6665 e280 990a 2d2d 2d2d 2d2d 2d2d 2d2d  fe....----------
│ │ │ │ +0001deb0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a53 7065 6369  ---------..Speci
│ │ │ │ +0001dec0: 6679 2064 6566 6175 6c74 2074 6963 6b65  fy default ticke
│ │ │ │ +0001ded0: 7420 6c69 6665 2074 696d 652e 0a0a 2020  t life time...  
│ │ │ │ +0001dee0: 2054 6865 2073 7472 696e 6720 6361 6e20   The string can 
│ │ │ │ +0001def0: 6265 2069 6e20 616c 6d6f 7374 2061 6e79  be in almost any
│ │ │ │ +0001df00: 2063 6f6d 6d6f 6e20 666f 726d 6174 2e20   common format. 
│ │ │ │ +0001df10: 2049 7420 6361 6e20 636f 6e74 6169 6e20   It can contain 
│ │ │ │ +0001df20: 6d6f 6e74 680a 6e61 6d65 732c 2074 696d  month.names, tim
│ │ │ │ +0001df30: 6520 7a6f 6e65 732c 2027 616d 2720 616e  e zones, 'am' an
│ │ │ │ +0001df40: 6420 2770 6d27 2c20 2779 6573 7465 7264  d 'pm', 'yesterd
│ │ │ │ +0001df50: 6179 272c 2027 6167 6f27 2c20 276e 6578  ay', 'ago', 'nex
│ │ │ │ +0001df60: 7427 2c20 6574 632e 0a2a 4e6f 7465 2044  t', etc..*Note D
│ │ │ │ +0001df70: 6174 6520 696e 7075 7420 666f 726d 6174  ate input format
│ │ │ │ +0001df80: 733a 3a2c 2066 6f72 2074 6865 206c 6f6e  s::, for the lon
│ │ │ │ +0001df90: 6720 7374 6f72 792e 0a0a 2020 2041 7320  g story...   As 
│ │ │ │ +0001dfa0: 616e 2065 7874 7261 2066 6561 7475 7265  an extra feature
│ │ │ │ +0001dfb0: 2c20 6966 2074 6865 2074 696d 6520 7370  , if the time sp
│ │ │ │ +0001dfc0: 6563 6966 6965 6420 6279 2079 6f75 7220  ecified by your 
│ │ │ │ +0001dfd0: 7374 7269 6e67 2063 6f72 7265 7370 6f6e  string correspon
│ │ │ │ +0001dfe0: 640a 746f 2061 2074 696d 6520 6475 7269  d.to a time duri
│ │ │ │ +0001dff0: 6e67 2074 6865 206c 6173 7420 3234 2068  ng the last 24 h
│ │ │ │ +0001e000: 6f75 7273 2c20 616e 2065 7874 7261 2064  ours, an extra d
│ │ │ │ +0001e010: 6179 2069 7320 6164 6465 6420 746f 2069  ay is added to i
│ │ │ │ +0001e020: 742e 2020 5468 6973 0a61 6c6c 6f77 7320  t.  This.allows 
│ │ │ │ +0001e030: 796f 7520 746f 2073 7065 6369 6679 2072  you to specify r
│ │ │ │ +0001e040: 656c 6174 6976 6520 7469 6d65 7320 7375  elative times su
│ │ │ │ +0001e050: 6368 2061 7320 2231 373a 3030 2220 746f  ch as "17:00" to
│ │ │ │ +0001e060: 2061 6c77 6179 7320 6d65 616e 2074 6865   always mean the
│ │ │ │ +0001e070: 0a6e 6578 7420 3137 3a30 302c 2065 7665  .next 17:00, eve
│ │ │ │ +0001e080: 6e20 6966 2079 6f75 7220 7379 7374 656d  n if your system
│ │ │ │ +0001e090: 2063 6c6f 636b 2068 6170 7065 6e73 2074   clock happens t
│ │ │ │ +0001e0a0: 6f20 6265 2031 373a 3330 2e0a 0a20 2020  o be 17:30...   
│ │ │ │ +0001e0b0: 5468 6520 6465 6661 756c 7420 6973 2038  The default is 8
│ │ │ │ +0001e0c0: 2068 6f75 7273 2e0a 0a20 2020 452e 672e   hours...   E.g.
│ │ │ │ +0001e0d0: 2c0a 0a20 2020 2020 2374 6963 6b65 742d  ,..     #ticket-
│ │ │ │ +0001e0e0: 6c69 6665 3d38 2068 6f75 7273 0a20 2020  life=8 hours.   
│ │ │ │ +0001e0f0: 2020 2374 6963 6b65 742d 6c69 6665 3d31    #ticket-life=1
│ │ │ │ +0001e100: 2064 6179 0a20 2020 2020 7469 636b 6574   day.     ticket
│ │ │ │ +0001e110: 2d6c 6966 653d 3137 3a30 300a 0a34 2e34  -life=17:00..4.4
│ │ │ │ +0001e120: 2e31 3020 e280 9872 656e 6577 2d6c 6966  .10 ...renew-lif
│ │ │ │ +0001e130: 65e2 8099 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  e....-----------
│ │ │ │ +0001e140: 2d2d 2d2d 2d2d 2d2d 0a0a 5370 6563 6966  --------..Specif
│ │ │ │ +0001e150: 7920 686f 7720 6c6f 6e67 2061 2072 656e  y how long a ren
│ │ │ │ +0001e160: 6577 6162 6c65 2074 6963 6b65 7420 7368  ewable ticket sh
│ │ │ │ +0001e170: 6f75 6c64 2072 656d 6169 6e20 7265 6e65  ould remain rene
│ │ │ │ +0001e180: 7761 626c 652e 0a0a 2020 2053 6565 2074  wable...   See t
│ │ │ │ +0001e190: 6963 6b65 742d 6c69 6665 2066 6f72 2074  icket-life for t
│ │ │ │ +0001e1a0: 6865 2073 796e 7461 782e 2020 5468 6520  he syntax.  The 
│ │ │ │ +0001e1b0: 6578 7472 6120 6665 6174 7572 6520 7468  extra feature th
│ │ │ │ +0001e1c0: 6174 2068 616e 646c 6573 0a6e 6567 6174  at handles.negat
│ │ │ │ +0001e1d0: 6976 6520 7661 6c75 6573 2077 6974 6869  ive values withi
│ │ │ │ +0001e1e0: 6e20 7468 6520 6c61 7374 2032 2068 6f75  n the last 2 hou
│ │ │ │ +0001e1f0: 7273 2069 7320 6e6f 7420 6163 7469 7665  rs is not active
│ │ │ │ +0001e200: 2068 6572 652e 0a0a 2020 2054 6865 2064   here...   The d
│ │ │ │ +0001e210: 6566 6175 6c74 2069 7320 3720 6461 7973  efault is 7 days
│ │ │ │ +0001e220: 2e0a 0a20 2020 452e 672e 2c0a 0a20 2020  ...   E.g.,..   
│ │ │ │ +0001e230: 2020 2372 656e 6577 2d6c 6966 653d 3120    #renew-life=1 
│ │ │ │ +0001e240: 7765 656b 0a20 2020 2020 2372 656e 6577  week.     #renew
│ │ │ │ +0001e250: 2d6c 6966 653d 6672 6964 6179 2031 373a  -life=friday 17:
│ │ │ │ +0001e260: 3030 0a20 2020 2020 7265 6e65 772d 6c69  00.     renew-li
│ │ │ │ +0001e270: 6665 3d73 756e 6461 790a 0a1f 0a46 696c  fe=sunday....Fil
│ │ │ │ +0001e280: 653a 2073 6869 7368 692e 696e 666f 2c20  e: shishi.info, 
│ │ │ │ +0001e290: 204e 6f64 653a 2053 6869 7361 2043 6f6e   Node: Shisa Con
│ │ │ │ +0001e2a0: 6669 6775 7261 7469 6f6e 2c20 204e 6578  figuration,  Nex
│ │ │ │ +0001e2b0: 743a 2050 6172 616d 6574 6572 7320 666f  t: Parameters fo
│ │ │ │ +0001e2c0: 7220 7368 6973 6869 2c20 2050 7265 763a  r shishi,  Prev:
│ │ │ │ +0001e2d0: 2053 6869 7368 6920 436f 6e66 6967 7572   Shishi Configur
│ │ │ │ +0001e2e0: 6174 696f 6e2c 2020 5570 3a20 5265 6665  ation,  Up: Refe
│ │ │ │ +0001e2f0: 7265 6e63 6520 4d61 6e75 616c 0a0a 342e  rence Manual..4.
│ │ │ │ +0001e300: 3520 5368 6973 6120 436f 6e66 6967 7572  5 Shisa Configur
│ │ │ │ +0001e310: 6174 696f 6e0a 3d3d 3d3d 3d3d 3d3d 3d3d  ation.==========
│ │ │ │ +0001e320: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a54  =============..T
│ │ │ │ +0001e330: 6865 2063 6f6e 6669 6775 7261 7469 6f6e  he configuration
│ │ │ │ +0001e340: 2066 696c 6520 666f 7220 5368 6973 6120   file for Shisa 
│ │ │ │ +0001e350: 6973 2074 7970 6963 616c 6c79 2073 746f  is typically sto
│ │ │ │ +0001e360: 7265 6420 696e 0ae2 8098 2f75 7372 2f6c  red in..../usr/l
│ │ │ │ +0001e370: 6f63 616c 2f65 7463 2f73 6869 7368 692f  ocal/etc/shishi/
│ │ │ │ +0001e380: 7368 6973 612e 636f 6e66 e280 992e 2020  shisa.conf....  
│ │ │ │ +0001e390: 4966 2074 6865 2066 6972 7374 206e 6f6e  If the first non
│ │ │ │ +0001e3a0: 2077 6869 7465 2073 7061 6365 0a63 6861   white space.cha
│ │ │ │ +0001e3b0: 7261 6374 6572 206f 6620 6120 6c69 6e65  racter of a line
│ │ │ │ +0001e3c0: 2069 7320 6120 2723 272c 2074 6865 206c   is a '#', the l
│ │ │ │ +0001e3d0: 696e 6520 6973 2069 676e 6f72 6564 2e20  ine is ignored. 
│ │ │ │ +0001e3e0: 2045 6d70 7479 206c 696e 6573 2061 7265   Empty lines are
│ │ │ │ +0001e3f0: 2061 6c73 6f0a 6967 6e6f 7265 642e 0a0a   also.ignored...
│ │ │ │ +0001e400: 342e 352e 3120 e280 9864 62e2 8099 0a2d  4.5.1 ...db....-
│ │ │ │ +0001e410: 2d2d 2d2d 2d2d 2d2d 2d0a 0a43 7572 7265  ---------..Curre
│ │ │ │ +0001e420: 6e74 6c79 2074 6865 206f 6e6c 7920 636f  ntly the only co
│ │ │ │ +0001e430: 6e66 6967 7572 6174 696f 6e20 6f70 7469  nfiguration opti
│ │ │ │ +0001e440: 6f6e 7320 6176 6169 6c61 626c 6520 6973  ons available is
│ │ │ │ +0001e450: 2074 6865 20e2 8098 6462 e280 9920 746f   the ...db... to
│ │ │ │ +0001e460: 6b65 6e0a 7468 6174 2064 6566 696e 6520  ken.that define 
│ │ │ │ +0001e470: 7468 6520 6461 7461 6261 7365 7320 746f  the databases to
│ │ │ │ +0001e480: 2075 7365 2e20 2054 6865 2073 796e 7461   use.  The synta
│ │ │ │ +0001e490: 7820 6973 3a0a 0a20 2020 2020 6462 205b  x is:..     db [
│ │ │ │ +0001e4a0: 4f50 5449 4f4e 535d 203c 5459 5045 3e20  OPTIONS] <TYPE> 
│ │ │ │ +0001e4b0: 5b4c 4f43 4154 494f 4e5d 205b 5041 5241  [LOCATION] [PARA
│ │ │ │ +0001e4c0: 4d45 5445 5253 202e 2e2e 5d0a 0a20 2020  METERS ...]..   
│ │ │ │ +0001e4d0: 5370 6563 6966 7920 7468 6520 6461 7461  Specify the data
│ │ │ │ +0001e4e0: 2073 6f75 7263 6573 2066 6f72 204b 6572   sources for Ker
│ │ │ │ +0001e4f0: 6265 726f 7320 3520 6461 7461 2e20 204d  beros 5 data.  M
│ │ │ │ +0001e500: 756c 7469 706c 6520 656e 7472 6965 732c  ultiple entries,
│ │ │ │ +0001e510: 2065 7665 6e0a 6f66 2074 6865 2073 616d   even.of the sam
│ │ │ │ +0001e520: 6520 6461 7461 2073 6f75 7263 6520 7479  e data source ty
│ │ │ │ +0001e530: 7065 2c20 6172 6520 616c 6c6f 7765 642e  pe, are allowed.
│ │ │ │ +0001e540: 2020 5468 6520 6461 7461 2073 6f75 7263    The data sourc
│ │ │ │ +0001e550: 6573 2061 7265 0a61 6363 6573 7365 6420  es are.accessed 
│ │ │ │ +0001e560: 696e 2074 6865 2073 616d 6520 7365 7175  in the same sequ
│ │ │ │ +0001e570: 656e 6365 2061 7320 7468 6579 2061 7265  ence as they are
│ │ │ │ +0001e580: 2064 6566 696e 6564 2068 6572 652e 2020   defined here.  
│ │ │ │ +0001e590: 4966 2061 6e20 656e 7472 7920 6973 0a66  If an entry is.f
│ │ │ │ +0001e5a0: 6f75 6e64 2069 6e20 6f6e 6520 6461 7461  ound in one data
│ │ │ │ +0001e5b0: 2073 6f75 7263 652c 2069 7420 7769 6c6c   source, it will
│ │ │ │ +0001e5c0: 2062 6520 7573 6564 2066 6f72 2074 6865   be used for the
│ │ │ │ +0001e5d0: 206f 7065 7261 7469 6f6e 732c 2077 6974   operations, wit
│ │ │ │ +0001e5e0: 686f 7574 0a73 6561 7263 6869 6e67 2074  hout.searching t
│ │ │ │ +0001e5f0: 6865 2072 656d 6169 6e69 6e67 2064 6174  he remaining dat
│ │ │ │ +0001e600: 6120 736f 7572 6365 732e 2020 5661 6c69  a sources.  Vali
│ │ │ │ +0001e610: 6420 4f50 5449 4f4e 5320 696e 636c 7564  d OPTIONS includ
│ │ │ │ +0001e620: 653a 0a0a 2020 2020 202d 2d72 6561 642d  e:..     --read-
│ │ │ │ +0001e630: 6f6e 6c79 2020 2020 2020 204e 6f20 6461  only       No da
│ │ │ │ +0001e640: 7461 2069 7320 7772 6974 7465 6e20 746f  ta is written to
│ │ │ │ +0001e650: 2074 6869 7320 6461 7461 2073 6f75 7263   this data sourc
│ │ │ │ +0001e660: 652e 0a20 2020 2020 2d2d 6967 6e6f 7265  e..     --ignore
│ │ │ │ +0001e670: 2d65 7272 6f72 7320 2020 4967 6e6f 7265  -errors   Ignore
│ │ │ │ +0001e680: 2066 6169 6c75 7265 7320 696e 2074 6869   failures in thi
│ │ │ │ +0001e690: 7320 6261 636b 656e 642e 0a0a 2020 2054  s backend...   T
│ │ │ │ +0001e6a0: 6865 2064 6566 6175 6c74 2028 7768 656e  he default (when
│ │ │ │ +0001e6b0: 2074 6865 2063 6f6e 6669 6775 7261 7469   the configurati
│ │ │ │ +0001e6c0: 6f6e 2066 696c 6520 6973 2065 6d70 7479  on file is empty
│ │ │ │ +0001e6d0: 2920 7573 6573 206f 6e65 2022 6669 6c65  ) uses one "file
│ │ │ │ +0001e6e0: 220a 6461 7461 2073 6f75 7263 6520 2873  ".data source (s
│ │ │ │ +0001e6f0: 6565 2062 656c 6f77 292c 2062 7574 2066  ee below), but f
│ │ │ │ +0001e700: 6f72 2061 206c 6172 6765 7220 696e 7374  or a larger inst
│ │ │ │ +0001e710: 616c 6c61 7469 6f6e 2079 6f75 206d 6179  allation you may
│ │ │ │ +0001e720: 2077 616e 7420 746f 0a63 6f6d 6269 6e65   want to.combine
│ │ │ │ +0001e730: 2073 6576 6572 616c 2064 6174 6120 736f   several data so
│ │ │ │ +0001e740: 7572 6365 732e 2020 4865 7265 2069 7320  urces.  Here is 
│ │ │ │ +0001e750: 616e 2065 7861 6d70 6c65 2e0a 0a20 2020  an example...   
│ │ │ │ +0001e760: 2020 6462 202d 2d72 6561 642d 6f6e 6c79    db --read-only
│ │ │ │ +0001e770: 2066 696c 6520 2f76 6172 2f6c 6f63 616c   file /var/local
│ │ │ │ +0001e780: 2f6d 6173 7465 720a 2020 2020 2064 6220  /master.     db 
│ │ │ │ +0001e790: 2d2d 6967 6e6f 7265 2d65 7272 6f72 7320  --ignore-errors 
│ │ │ │ +0001e7a0: 6c64 6170 206b 6463 2e65 7861 6d70 6c65  ldap kdc.example
│ │ │ │ +0001e7b0: 2e6f 7267 2063 613d 2f65 7463 2f73 6869  .org ca=/etc/shi
│ │ │ │ +0001e7c0: 7361 2f6b 6463 2d63 612e 7065 6d0a 2020  sa/kdc-ca.pem.  
│ │ │ │ +0001e7d0: 2020 2064 6220 2d2d 7265 6164 2d6f 6e6c     db --read-onl
│ │ │ │ +0001e7e0: 7920 6669 6c65 202f 7661 722f 6361 6368  y file /var/cach
│ │ │ │ +0001e7f0: 652f 6c64 6170 2d63 6f70 790a 0a20 2020  e/ldap-copy..   
│ │ │ │ +0001e800: 5468 6973 2064 656d 6f6e 7374 7261 7465  This demonstrate
│ │ │ │ +0001e810: 2068 6f77 2079 6f75 2063 616e 2073 746f   how you can sto
│ │ │ │ +0001e820: 7265 2063 7269 7469 6361 6c20 7072 696e  re critical prin
│ │ │ │ +0001e830: 6369 7061 6c73 206f 6e20 6c6f 6361 6c20  cipals on local 
│ │ │ │ +0001e840: 6469 736b 0a28 7468 6520 6669 7273 7420  disk.(the first 
│ │ │ │ +0001e850: 656e 7472 792c 202f 7661 722f 6c6f 6361  entry, /var/loca
│ │ │ │ +0001e860: 6c2f 6d61 7374 6572 2920 7468 6174 2077  l/master) that w
│ │ │ │ +0001e870: 696c 6c20 616c 7761 7973 2062 6520 666f  ill always be fo
│ │ │ │ +0001e880: 756e 6420 7769 7468 6f75 740a 6c6f 6f6b  und without.look
│ │ │ │ +0001e890: 696e 6720 696e 2074 6865 204c 4441 5020  ing in the LDAP 
│ │ │ │ +0001e8a0: 6469 7265 6374 6f72 792e 2020 5468 6520  directory.  The 
│ │ │ │ +0001e8b0: 6372 6974 6963 616c 2070 7269 6e63 6970  critical princip
│ │ │ │ +0001e8c0: 616c 7320 636f 756c 6420 6265 2c20 652e  als could be, e.
│ │ │ │ +0001e8d0: 672e 2c0a 6b72 6274 6774 2f45 5841 4d50  g.,.krbtgt/EXAMP
│ │ │ │ +0001e8e0: 4c45 2e4f 5247 2e20 2054 6865 2073 6563  LE.ORG.  The sec
│ │ │ │ +0001e8f0: 6f6e 6420 656e 7472 7920 6465 6e6f 7465  ond entry denote
│ │ │ │ +0001e900: 2061 204c 4441 5020 7365 7276 6572 2074   a LDAP server t
│ │ │ │ +0001e910: 6861 7420 636f 756c 640a 686f 6c64 2075  hat could.hold u
│ │ │ │ +0001e920: 7365 7220 7072 696e 6369 7061 6c73 2e20  ser principals. 
│ │ │ │ +0001e930: 2041 7320 796f 7520 6361 6e20 7365 652c   As you can see,
│ │ │ │ +0001e940: 2053 6869 7361 2077 696c 6c20 6e6f 7420   Shisa will not 
│ │ │ │ +0001e950: 6c65 7420 7468 6520 6361 6c6c 6572 0a6b  let the caller.k
│ │ │ │ +0001e960: 6e6f 7720 6162 6f75 7420 6572 726f 7273  now about errors
│ │ │ │ +0001e970: 2077 6974 6820 7468 6520 4c44 4150 2073   with the LDAP s
│ │ │ │ +0001e980: 6f75 7263 6520 2874 6865 7920 7769 6c6c  ource (they will
│ │ │ │ +0001e990: 2062 6520 6c6f 6767 6564 2c20 686f 7765   be logged, howe
│ │ │ │ +0001e9a0: 7665 7229 2e0a 496e 7374 6561 642c 2069  ver)..Instead, i
│ │ │ │ +0001e9b0: 6620 666f 7220 696e 7374 616e 6365 2074  f for instance t
│ │ │ │ +0001e9c0: 6865 204c 4441 5020 7365 7276 6572 2068  he LDAP server h
│ │ │ │ +0001e9d0: 6173 2063 7261 7368 6564 2c20 5368 6973  as crashed, Shis
│ │ │ │ +0001e9e0: 6120 776f 756c 640a 636f 6e74 696e 7565  a would.continue
│ │ │ │ +0001e9f0: 2061 6e64 2072 6561 6420 6672 6f6d 2074   and read from t
│ │ │ │ +0001ea00: 6865 202f 7661 722f 6361 6368 652f 6c64  he /var/cache/ld
│ │ │ │ +0001ea10: 6170 2d63 6f70 7920 6669 6c65 2073 6f75  ap-copy file sou
│ │ │ │ +0001ea20: 7263 652e 2020 5468 6174 2066 696c 650a  rce.  That file.
│ │ │ │ +0001ea30: 736f 7572 6365 206d 6179 2068 6176 6520  source may have 
│ │ │ │ +0001ea40: 6265 656e 2073 6574 2075 7020 746f 2063  been set up to c
│ │ │ │ +0001ea50: 6f6e 7461 696e 2061 2063 6f70 7920 6f66  ontain a copy of
│ │ │ │ +0001ea60: 2074 6865 2064 6174 6120 696e 2074 6865   the data in the
│ │ │ │ +0001ea70: 204c 4441 500a 7365 7276 6572 2c20 7065   LDAP.server, pe
│ │ │ │ +0001ea80: 7268 6170 7320 6d61 6465 206f 6e20 616e  rhaps made on an
│ │ │ │ +0001ea90: 2068 6f75 726c 7920 6261 7369 732c 2073   hourly basis, s
│ │ │ │ +0001eaa0: 6f20 7468 6174 2079 6f75 7220 7365 7276  o that your serv
│ │ │ │ +0001eab0: 6572 2077 696c 6c20 6265 0a61 626c 6520  er will be.able 
│ │ │ │ +0001eac0: 746f 2073 6572 7665 2072 6563 656e 7420  to serve recent 
│ │ │ │ +0001ead0: 6461 7461 2065 7665 6e20 696e 2063 6173  data even in cas
│ │ │ │ +0001eae0: 6520 6f66 2061 2063 7261 7368 2e20 2041  e of a crash.  A
│ │ │ │ +0001eaf0: 6e79 2075 7064 6174 6573 206f 720a 7061  ny updates or.pa
│ │ │ │ +0001eb00: 7373 776f 7264 7320 6368 616e 6765 2072  sswords change r
│ │ │ │ +0001eb10: 6571 7565 7374 7320 7769 6c6c 2068 6f77  equests will how
│ │ │ │ +0001eb20: 6576 6572 206e 6f74 2062 6520 706f 7373  ever not be poss
│ │ │ │ +0001eb30: 6962 6c65 2077 6869 6c65 2074 6865 204c  ible while the L
│ │ │ │ +0001eb40: 4441 500a 7365 7276 6572 2069 7320 696e  DAP.server is in
│ │ │ │ +0001eb50: 6163 6365 7373 6962 6c65 2c20 746f 2072  accessible, to r
│ │ │ │ +0001eb60: 6564 7563 6520 7468 6520 7072 6f62 6c65  educe the proble
│ │ │ │ +0001eb70: 6d20 6f66 2073 796e 6368 726f 6e69 7a69  m of synchronizi
│ │ │ │ +0001eb80: 6e67 2064 6174 6120 6261 636b 0a69 6e74  ng data back.int
│ │ │ │ +0001eb90: 6f20 7468 6520 4c44 4150 2073 6572 7665  o the LDAP serve
│ │ │ │ +0001eba0: 7220 6f6e 6365 2069 7420 6973 206f 6e6c  r once it is onl
│ │ │ │ +0001ebb0: 696e 6520 6167 6169 6e2e 0a0a 2020 2043  ine again...   C
│ │ │ │ +0001ebc0: 7572 7265 6e74 6c79 206f 6e6c 7920 7468  urrently only th
│ │ │ │ +0001ebd0: 6520 2266 696c 6522 2064 6174 6120 736f  e "file" data so
│ │ │ │ +0001ebe0: 7572 6365 2069 7320 7375 7070 6f72 7465  urce is supporte
│ │ │ │ +0001ebf0: 642c 2061 6e64 2064 656e 6f74 6520 6120  d, and denote a 
│ │ │ │ +0001ec00: 6461 7461 0a73 6f75 7263 6520 7468 6174  data.source that
│ │ │ │ +0001ec10: 2075 7365 2074 6865 2073 7461 6e64 6172   use the standar
│ │ │ │ +0001ec20: 6420 6669 6c65 2073 7973 7465 6d20 666f  d file system fo
│ │ │ │ +0001ec30: 7220 7374 6f72 6167 652e 0a0a 2020 2056  r storage...   V
│ │ │ │ +0001ec40: 616c 6964 2073 796e 7461 7865 7320 666f  alid syntaxes fo
│ │ │ │ +0001ec50: 7220 7468 6520 2266 696c 6522 2064 6174  r the "file" dat
│ │ │ │ +0001ec60: 6162 6173 653a 0a0a 2020 2020 2064 6220  abase:..     db 
│ │ │ │ +0001ec70: 6669 6c65 2050 4154 480a 0a20 2020 4578  file PATH..   Ex
│ │ │ │ +0001ec80: 616d 706c 6573 3a0a 0a20 2020 2020 6462  amples:..     db
│ │ │ │ +0001ec90: 2066 696c 6520 2f76 6172 2f73 6869 7368   file /var/shish
│ │ │ │ +0001eca0: 690a 2020 2020 2064 6220 6669 6c65 202f  i.     db file /
│ │ │ │ +0001ecb0: 7573 722f 7368 6172 652f 7368 6973 6869  usr/share/shishi
│ │ │ │ +0001ecc0: 2072 6561 642d 6f6e 6c79 0a0a 2020 2049   read-only..   I
│ │ │ │ +0001ecd0: 6620 6e6f 20e2 8098 6462 e280 9920 746f  f no ...db... to
│ │ │ │ +0001ece0: 6b65 6e73 2061 7265 2070 7265 7365 6e74  kens are present
│ │ │ │ +0001ecf0: 2c20 7468 6520 6465 6661 756c 7420 7769  , the default wi
│ │ │ │ +0001ed00: 6c6c 2062 653a 0a0a 2020 2020 2064 6220  ll be:..     db 
│ │ │ │ +0001ed10: 6669 6c65 202f 7573 722f 6c6f 6361 6c2f  file /usr/local/
│ │ │ │ +0001ed20: 7661 722f 7368 6973 6869 0a0a 1f0a 4669  var/shishi....Fi
│ │ │ │ +0001ed30: 6c65 3a20 7368 6973 6869 2e69 6e66 6f2c  le: shishi.info,
│ │ │ │ +0001ed40: 2020 4e6f 6465 3a20 5061 7261 6d65 7465    Node: Paramete
│ │ │ │ +0001ed50: 7273 2066 6f72 2073 6869 7368 692c 2020  rs for shishi,  
│ │ │ │ +0001ed60: 4e65 7874 3a20 5061 7261 6d65 7465 7273  Next: Parameters
│ │ │ │ +0001ed70: 2066 6f72 2073 6869 7368 6964 2c20 2050   for shishid,  P
│ │ │ │ +0001ed80: 7265 763a 2053 6869 7361 2043 6f6e 6669  rev: Shisa Confi
│ │ │ │ +0001ed90: 6775 7261 7469 6f6e 2c20 2055 703a 2052  guration,  Up: R
│ │ │ │ +0001eda0: 6566 6572 656e 6365 204d 616e 7561 6c0a  eference Manual.
│ │ │ │ +0001edb0: 0a34 2e36 2050 6172 616d 6574 6572 7320  .4.6 Parameters 
│ │ │ │ +0001edc0: 666f 7220 7368 6973 6869 0a3d 3d3d 3d3d  for shishi.=====
│ │ │ │  0001edd0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ -0001ede0: 3d3d 0a0a 4966 206e 6f20 636f 6d6d 616e  ==..If no comman
│ │ │ │ -0001edf0: 6420 6973 2067 6976 656e 2c20 5368 6973  d is given, Shis
│ │ │ │ -0001ee00: 6869 2074 7279 2074 6f20 6d61 6b65 2073  hi try to make s
│ │ │ │ -0001ee10: 7572 6520 796f 7520 6861 7665 2061 2074  ure you have a t
│ │ │ │ -0001ee20: 6963 6b65 740a 6772 616e 7469 6e67 2074  icket.granting t
│ │ │ │ -0001ee30: 6963 6b65 7420 666f 7220 7468 6520 6465  icket for the de
│ │ │ │ -0001ee40: 6661 756c 7420 7265 616c 6d2c 2061 6e64  fault realm, and
│ │ │ │ -0001ee50: 2074 6865 6e20 6469 7370 6c61 7920 6974   then display it
│ │ │ │ -0001ee60: 2e0a 0a20 2020 4d61 6e64 6174 6f72 7920  ...   Mandatory 
│ │ │ │ -0001ee70: 6172 6775 6d65 6e74 7320 746f 206c 6f6e  arguments to lon
│ │ │ │ -0001ee80: 6720 6f70 7469 6f6e 7320 6172 6520 6d61  g options are ma
│ │ │ │ -0001ee90: 6e64 6174 6f72 7920 666f 7220 7368 6f72  ndatory for shor
│ │ │ │ -0001eea0: 7420 6f70 7469 6f6e 730a 746f 6f2e 0a0a  t options.too...
│ │ │ │ -0001eeb0: 2020 2020 2055 7361 6765 3a20 7368 6973       Usage: shis
│ │ │ │ -0001eec0: 6869 205b 4f50 5449 4f4e 535d 2e2e 2e20  hi [OPTIONS]... 
│ │ │ │ -0001eed0: 5b43 4c49 454e 5420 5b53 4552 5645 525d  [CLIENT [SERVER]
│ │ │ │ -0001eee0: 5d2e 2e2e 0a0a 2020 2020 2020 202d 682c  ].....       -h,
│ │ │ │ -0001eef0: 202d 2d68 656c 7020 2020 2020 2020 2020   --help         
│ │ │ │ +0001ede0: 3d3d 3d3d 0a0a 4966 206e 6f20 636f 6d6d  ====..If no comm
│ │ │ │ +0001edf0: 616e 6420 6973 2067 6976 656e 2c20 5368  and is given, Sh
│ │ │ │ +0001ee00: 6973 6869 2074 7279 2074 6f20 6d61 6b65  ishi try to make
│ │ │ │ +0001ee10: 2073 7572 6520 796f 7520 6861 7665 2061   sure you have a
│ │ │ │ +0001ee20: 2074 6963 6b65 740a 6772 616e 7469 6e67   ticket.granting
│ │ │ │ +0001ee30: 2074 6963 6b65 7420 666f 7220 7468 6520   ticket for the 
│ │ │ │ +0001ee40: 6465 6661 756c 7420 7265 616c 6d2c 2061  default realm, a
│ │ │ │ +0001ee50: 6e64 2074 6865 6e20 6469 7370 6c61 7920  nd then display 
│ │ │ │ +0001ee60: 6974 2e0a 0a20 2020 4d61 6e64 6174 6f72  it...   Mandator
│ │ │ │ +0001ee70: 7920 6172 6775 6d65 6e74 7320 746f 206c  y arguments to l
│ │ │ │ +0001ee80: 6f6e 6720 6f70 7469 6f6e 7320 6172 6520  ong options are 
│ │ │ │ +0001ee90: 6d61 6e64 6174 6f72 7920 666f 7220 7368  mandatory for sh
│ │ │ │ +0001eea0: 6f72 7420 6f70 7469 6f6e 730a 746f 6f2e  ort options.too.
│ │ │ │ +0001eeb0: 0a0a 2020 2020 2055 7361 6765 3a20 7368  ..     Usage: sh
│ │ │ │ +0001eec0: 6973 6869 205b 4f50 5449 4f4e 535d 2e2e  ishi [OPTIONS]..
│ │ │ │ +0001eed0: 2e20 5b43 4c49 454e 5420 5b53 4552 5645  . [CLIENT [SERVE
│ │ │ │ +0001eee0: 525d 5d2e 2e2e 0a0a 2020 2020 2020 202d  R]].....       -
│ │ │ │ +0001eef0: 682c 202d 2d68 656c 7020 2020 2020 2020  h, --help       
│ │ │ │  0001ef00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001ef10: 2020 2020 2050 7269 6e74 2068 656c 7020       Print help 
│ │ │ │ -0001ef20: 616e 6420 6578 6974 0a20 2020 2020 2020  and exit.       
│ │ │ │ -0001ef30: 2d56 2c20 2d2d 7665 7273 696f 6e20 2020  -V, --version   
│ │ │ │ +0001ef10: 2020 2020 2020 2050 7269 6e74 2068 656c         Print hel
│ │ │ │ +0001ef20: 7020 616e 6420 6578 6974 0a20 2020 2020  p and exit.     
│ │ │ │ +0001ef30: 2020 2d56 2c20 2d2d 7665 7273 696f 6e20    -V, --version 
│ │ │ │  0001ef40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001ef50: 2020 2020 2020 2020 5072 696e 7420 7665          Print ve
│ │ │ │ -0001ef60: 7273 696f 6e20 616e 6420 6578 6974 0a0a  rsion and exit..
│ │ │ │ -0001ef70: 2020 2020 2043 6f6d 6d61 6e64 733a 0a20       Commands:. 
│ │ │ │ -0001ef80: 2020 2020 2020 2d64 2c20 2d2d 6465 7374        -d, --dest
│ │ │ │ -0001ef90: 726f 7920 2020 2020 2020 2020 2020 2020  roy             
│ │ │ │ -0001efa0: 2020 2020 2020 2020 2020 2020 2020 4465                De
│ │ │ │ -0001efb0: 7374 726f 7920 7469 636b 6574 7320 696e  stroy tickets in
│ │ │ │ -0001efc0: 206c 6f63 616c 2063 6163 6865 2c0a 2020   local cache,.  
│ │ │ │ +0001ef50: 2020 2020 2020 2020 2020 5072 696e 7420            Print 
│ │ │ │ +0001ef60: 7665 7273 696f 6e20 616e 6420 6578 6974  version and exit
│ │ │ │ +0001ef70: 0a0a 2020 2020 2043 6f6d 6d61 6e64 733a  ..     Commands:
│ │ │ │ +0001ef80: 0a20 2020 2020 2020 2d64 2c20 2d2d 6465  .       -d, --de
│ │ │ │ +0001ef90: 7374 726f 7920 2020 2020 2020 2020 2020  stroy           
│ │ │ │ +0001efa0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0001efb0: 4465 7374 726f 7920 7469 636b 6574 7320  Destroy tickets 
│ │ │ │ +0001efc0: 696e 206c 6f63 616c 2063 6163 6865 2c0a  in local cache,.
│ │ │ │  0001efd0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001efe0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001eff0: 2020 2020 2020 2020 2020 2020 2020 206c                 l
│ │ │ │ -0001f000: 696d 6974 6564 2062 7920 616e 7920 2d2d  imited by any --
│ │ │ │ -0001f010: 636c 6965 6e74 2d6e 616d 6520 6f72 0a20  client-name or. 
│ │ │ │ -0001f020: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0001eff0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0001f000: 206c 696d 6974 6564 2062 7920 616e 7920   limited by any 
│ │ │ │ +0001f010: 2d2d 636c 6965 6e74 2d6e 616d 6520 6f72  --client-name or
│ │ │ │ +0001f020: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │  0001f030: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001f040: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001f050: 2d2d 7365 7276 6572 2d6e 616d 652e 2020  --server-name.  
│ │ │ │ -0001f060: 2864 6566 6175 6c74 3d6f 6666 290a 2020  (default=off).  
│ │ │ │ -0001f070: 2020 2020 202d 6c2c 202d 2d6c 6973 7420       -l, --list 
│ │ │ │ -0001f080: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001f090: 2020 2020 2020 2020 2020 2020 204c 6973               Lis
│ │ │ │ -0001f0a0: 7420 7469 636b 6574 7320 696e 206c 6f63  t tickets in loc
│ │ │ │ -0001f0b0: 616c 2063 6163 6865 2c20 6c69 6d69 7465  al cache, limite
│ │ │ │ -0001f0c0: 640a 2020 2020 2020 2020 2020 2020 2020  d.              
│ │ │ │ +0001f050: 2020 2d2d 7365 7276 6572 2d6e 616d 652e    --server-name.
│ │ │ │ +0001f060: 2020 2864 6566 6175 6c74 3d6f 6666 290a    (default=off).
│ │ │ │ +0001f070: 2020 2020 2020 202d 6c2c 202d 2d6c 6973         -l, --lis
│ │ │ │ +0001f080: 7420 2020 2020 2020 2020 2020 2020 2020  t               
│ │ │ │ +0001f090: 2020 2020 2020 2020 2020 2020 2020 204c                 L
│ │ │ │ +0001f0a0: 6973 7420 7469 636b 6574 7320 696e 206c  ist tickets in l
│ │ │ │ +0001f0b0: 6f63 616c 2063 6163 6865 2c20 6c69 6d69  ocal cache, limi
│ │ │ │ +0001f0c0: 7465 640a 2020 2020 2020 2020 2020 2020  ted.            
│ │ │ │  0001f0d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001f0e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001f0f0: 2020 2062 7920 616e 7920 2d2d 636c 6965     by any --clie
│ │ │ │ -0001f100: 6e74 2d6e 616d 6520 616e 640a 2020 2020  nt-name and.    
│ │ │ │ +0001f0f0: 2020 2020 2062 7920 616e 7920 2d2d 636c       by any --cl
│ │ │ │ +0001f100: 6965 6e74 2d6e 616d 6520 616e 640a 2020  ient-name and.  
│ │ │ │  0001f110: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001f120: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001f130: 2020 2020 2020 2020 2020 2020 202d 2d73               --s
│ │ │ │ -0001f140: 6572 7665 722d 6e61 6d65 2e20 2028 6465  erver-name.  (de
│ │ │ │ -0001f150: 6661 756c 743d 6f66 6629 0a20 2020 2020  fault=off).     
│ │ │ │ -0001f160: 2020 2d72 2c20 2d2d 7265 6e65 7720 2020    -r, --renew   
│ │ │ │ +0001f130: 2020 2020 2020 2020 2020 2020 2020 202d                 -
│ │ │ │ +0001f140: 2d73 6572 7665 722d 6e61 6d65 2e20 2028  -server-name.  (
│ │ │ │ +0001f150: 6465 6661 756c 743d 6f66 6629 0a20 2020  default=off).   
│ │ │ │ +0001f160: 2020 2020 2d72 2c20 2d2d 7265 6e65 7720      -r, --renew 
│ │ │ │  0001f170: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001f180: 2020 2020 2020 2020 2020 5265 6e65 7720            Renew 
│ │ │ │ -0001f190: 7469 636b 6574 2e20 2055 7365 202d 2d73  ticket.  Use --s
│ │ │ │ -0001f1a0: 6572 7665 722d 6e61 6d65 2074 6f0a 2020  erver-name to.  
│ │ │ │ +0001f180: 2020 2020 2020 2020 2020 2020 5265 6e65              Rene
│ │ │ │ +0001f190: 7720 7469 636b 6574 2e20 2055 7365 202d  w ticket.  Use -
│ │ │ │ +0001f1a0: 2d73 6572 7665 722d 6e61 6d65 2074 6f0a  -server-name to.
│ │ │ │  0001f1b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001f1c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001f1d0: 2020 2020 2020 2020 2020 2020 2020 2073                 s
│ │ │ │ -0001f1e0: 7065 6369 6679 2074 6963 6b65 742c 2064  pecify ticket, d
│ │ │ │ -0001f1f0: 6566 6175 6c74 2069 7320 7468 650a 2020  efault is the.  
│ │ │ │ +0001f1d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0001f1e0: 2073 7065 6369 6679 2074 6963 6b65 742c   specify ticket,
│ │ │ │ +0001f1f0: 2064 6566 6175 6c74 2069 7320 7468 650a   default is the.
│ │ │ │  0001f200: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001f210: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001f220: 2020 2020 2020 2020 2020 2020 2020 206d                 m
│ │ │ │ -0001f230: 6f73 7420 7265 6365 6e74 2072 656e 6577  ost recent renew
│ │ │ │ -0001f240: 6162 6c65 2074 6963 6b65 740a 2020 2020  able ticket.    
│ │ │ │ +0001f220: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0001f230: 206d 6f73 7420 7265 6365 6e74 2072 656e   most recent ren
│ │ │ │ +0001f240: 6577 6162 6c65 2074 6963 6b65 740a 2020  ewable ticket.  
│ │ │ │  0001f250: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001f260: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001f270: 2020 2020 2020 2020 2020 2020 2067 7261               gra
│ │ │ │ -0001f280: 6e74 696e 6720 7469 636b 6574 2066 6f72  nting ticket for
│ │ │ │ -0001f290: 2074 6865 2064 6566 6175 6c74 0a20 2020   the default.   
│ │ │ │ +0001f270: 2020 2020 2020 2020 2020 2020 2020 2067                 g
│ │ │ │ +0001f280: 7261 6e74 696e 6720 7469 636b 6574 2066  ranting ticket f
│ │ │ │ +0001f290: 6f72 2074 6865 2064 6566 6175 6c74 0a20  or the default. 
│ │ │ │  0001f2a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001f2b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001f2c0: 2020 2020 2020 2020 2020 2020 2020 7265                re
│ │ │ │ -0001f2d0: 616c 6d2e 2020 2864 6566 6175 6c74 3d6f  alm.  (default=o
│ │ │ │ -0001f2e0: 6666 290a 0a20 2020 2020 466c 6167 733a  ff)..     Flags:
│ │ │ │ -0001f2f0: 0a20 2020 2020 2020 2020 2020 2d2d 666f  .           --fo
│ │ │ │ -0001f300: 7277 6172 6461 626c 6520 2020 2020 2020  rwardable       
│ │ │ │ +0001f2c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0001f2d0: 7265 616c 6d2e 2020 2864 6566 6175 6c74  realm.  (default
│ │ │ │ +0001f2e0: 3d6f 6666 290a 0a20 2020 2020 466c 6167  =off)..     Flag
│ │ │ │ +0001f2f0: 733a 0a20 2020 2020 2020 2020 2020 2d2d  s:.           --
│ │ │ │ +0001f300: 666f 7277 6172 6461 626c 6520 2020 2020  forwardable     
│ │ │ │  0001f310: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001f320: 4765 7420 6120 666f 7277 6172 6461 626c  Get a forwardabl
│ │ │ │ -0001f330: 6520 7469 636b 6574 2c20 692e 652e 2c20  e ticket, i.e., 
│ │ │ │ -0001f340: 6f6e 650a 2020 2020 2020 2020 2020 2020  one.            
│ │ │ │ +0001f320: 2020 4765 7420 6120 666f 7277 6172 6461    Get a forwarda
│ │ │ │ +0001f330: 626c 6520 7469 636b 6574 2c20 692e 652e  ble ticket, i.e.
│ │ │ │ +0001f340: 2c20 6f6e 650a 2020 2020 2020 2020 2020  , one.          
│ │ │ │  0001f350: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001f360: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001f370: 2020 2020 2074 6861 7420 6361 6e20 6265       that can be
│ │ │ │ -0001f380: 2075 7365 6420 746f 2067 6574 2066 6f72   used to get for
│ │ │ │ -0001f390: 7761 7264 6564 0a20 2020 2020 2020 2020  warded.         
│ │ │ │ +0001f370: 2020 2020 2020 2074 6861 7420 6361 6e20         that can 
│ │ │ │ +0001f380: 6265 2075 7365 6420 746f 2067 6574 2066  be used to get f
│ │ │ │ +0001f390: 6f72 7761 7264 6564 0a20 2020 2020 2020  orwarded.       
│ │ │ │  0001f3a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001f3b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001f3c0: 2020 2020 2020 2020 7469 636b 6574 732e          tickets.
│ │ │ │ -0001f3d0: 2020 2864 6566 6175 6c74 3d6f 6666 290a    (default=off).
│ │ │ │ -0001f3e0: 2020 2020 2020 2020 2020 202d 2d66 6f72             --for
│ │ │ │ -0001f3f0: 7761 7264 6564 2020 2020 2020 2020 2020  warded          
│ │ │ │ -0001f400: 2020 2020 2020 2020 2020 2020 2020 2047                 G
│ │ │ │ -0001f410: 6574 2061 2066 6f72 7761 7264 6564 2074  et a forwarded t
│ │ │ │ -0001f420: 6963 6b65 742e 2020 2864 6566 6175 6c74  icket.  (default
│ │ │ │ -0001f430: 3d0a 2020 2020 2020 2020 2020 2020 2020  =.              
│ │ │ │ +0001f3c0: 2020 2020 2020 2020 2020 7469 636b 6574            ticket
│ │ │ │ +0001f3d0: 732e 2020 2864 6566 6175 6c74 3d6f 6666  s.  (default=off
│ │ │ │ +0001f3e0: 290a 2020 2020 2020 2020 2020 202d 2d66  ).           --f
│ │ │ │ +0001f3f0: 6f72 7761 7264 6564 2020 2020 2020 2020  orwarded        
│ │ │ │ +0001f400: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0001f410: 2047 6574 2061 2066 6f72 7761 7264 6564   Get a forwarded
│ │ │ │ +0001f420: 2074 6963 6b65 742e 2020 2864 6566 6175   ticket.  (defau
│ │ │ │ +0001f430: 6c74 3d0a 2020 2020 2020 2020 2020 2020  lt=.            
│ │ │ │  0001f440: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001f450: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001f460: 2020 206f 6666 290a 2020 2020 2020 2020     off).        
│ │ │ │ -0001f470: 2020 202d 2d70 726f 7869 6162 6c65 2020     --proxiable  
│ │ │ │ +0001f460: 2020 2020 206f 6666 290a 2020 2020 2020       off).      
│ │ │ │ +0001f470: 2020 2020 202d 2d70 726f 7869 6162 6c65       --proxiable
│ │ │ │  0001f480: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001f490: 2020 2020 2020 2047 6574 2061 2070 726f         Get a pro
│ │ │ │ -0001f4a0: 7869 6162 6c65 2074 6963 6b65 742c 2069  xiable ticket, i
│ │ │ │ -0001f4b0: 2e65 2e2c 206f 6e65 0a20 2020 2020 2020  .e., one.       
│ │ │ │ +0001f490: 2020 2020 2020 2020 2047 6574 2061 2070           Get a p
│ │ │ │ +0001f4a0: 726f 7869 6162 6c65 2074 6963 6b65 742c  roxiable ticket,
│ │ │ │ +0001f4b0: 2069 2e65 2e2c 206f 6e65 0a20 2020 2020   i.e., one.     
│ │ │ │  0001f4c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001f4d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001f4e0: 2020 2020 2020 2020 2020 7468 6174 2063            that c
│ │ │ │ -0001f4f0: 616e 2062 6520 7573 6564 2074 6f20 6765  an be used to ge
│ │ │ │ -0001f500: 7420 7072 6f78 790a 2020 2020 2020 2020  t proxy.        
│ │ │ │ +0001f4e0: 2020 2020 2020 2020 2020 2020 7468 6174              that
│ │ │ │ +0001f4f0: 2063 616e 2062 6520 7573 6564 2074 6f20   can be used to 
│ │ │ │ +0001f500: 6765 7420 7072 6f78 790a 2020 2020 2020  get proxy.      
│ │ │ │  0001f510: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001f520: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001f530: 2020 2020 2020 2020 2074 6963 6b65 7473           tickets
│ │ │ │ -0001f540: 2e20 2028 6465 6661 756c 743d 6f66 6629  .  (default=off)
│ │ │ │ -0001f550: 0a20 2020 2020 2020 2020 2020 2d2d 7072  .           --pr
│ │ │ │ -0001f560: 6f78 7920 2020 2020 2020 2020 2020 2020  oxy             
│ │ │ │ +0001f530: 2020 2020 2020 2020 2020 2074 6963 6b65             ticke
│ │ │ │ +0001f540: 7473 2e20 2028 6465 6661 756c 743d 6f66  ts.  (default=of
│ │ │ │ +0001f550: 6629 0a20 2020 2020 2020 2020 2020 2d2d  f).           --
│ │ │ │ +0001f560: 7072 6f78 7920 2020 2020 2020 2020 2020  proxy           
│ │ │ │  0001f570: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001f580: 4765 7420 6120 7072 6f78 7920 7469 636b  Get a proxy tick
│ │ │ │ -0001f590: 6574 2e20 2028 6465 6661 756c 743d 6f66  et.  (default=of
│ │ │ │ -0001f5a0: 6629 0a20 2020 2020 2020 2020 2020 2d2d  f).           --
│ │ │ │ -0001f5b0: 7265 6e65 7761 626c 6520 2020 2020 2020  renewable       
│ │ │ │ +0001f580: 2020 4765 7420 6120 7072 6f78 7920 7469    Get a proxy ti
│ │ │ │ +0001f590: 636b 6574 2e20 2028 6465 6661 756c 743d  cket.  (default=
│ │ │ │ +0001f5a0: 6f66 6629 0a20 2020 2020 2020 2020 2020  off).           
│ │ │ │ +0001f5b0: 2d2d 7265 6e65 7761 626c 6520 2020 2020  --renewable     
│ │ │ │  0001f5c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001f5d0: 2020 4765 7420 6120 7265 6e65 7761 626c    Get a renewabl
│ │ │ │ -0001f5e0: 6520 7469 636b 6574 2e20 2028 6465 6661  e ticket.  (defa
│ │ │ │ -0001f5f0: 756c 743d 0a20 2020 2020 2020 2020 2020  ult=.           
│ │ │ │ +0001f5d0: 2020 2020 4765 7420 6120 7265 6e65 7761      Get a renewa
│ │ │ │ +0001f5e0: 626c 6520 7469 636b 6574 2e20 2028 6465  ble ticket.  (de
│ │ │ │ +0001f5f0: 6661 756c 743d 0a20 2020 2020 2020 2020  fault=.         
│ │ │ │  0001f600: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001f610: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001f620: 2020 2020 2020 6f66 6629 0a0a 2020 2020        off)..    
│ │ │ │ -0001f630: 204f 7074 696f 6e73 3a0a 2020 2020 2020   Options:.      
│ │ │ │ -0001f640: 2020 2020 202d 2d63 6c69 656e 742d 6e61       --client-na
│ │ │ │ -0001f650: 6d65 3d4e 414d 4520 2020 2020 2020 2020  me=NAME         
│ │ │ │ -0001f660: 2020 2020 2020 2020 2043 6c69 656e 7420           Client 
│ │ │ │ -0001f670: 6e61 6d65 2e20 4465 6661 756c 7420 6973  name. Default is
│ │ │ │ -0001f680: 206c 6f67 696e 0a20 2020 2020 2020 2020   login.         
│ │ │ │ +0001f620: 2020 2020 2020 2020 6f66 6629 0a0a 2020          off)..  
│ │ │ │ +0001f630: 2020 204f 7074 696f 6e73 3a0a 2020 2020     Options:.    
│ │ │ │ +0001f640: 2020 2020 2020 202d 2d63 6c69 656e 742d         --client-
│ │ │ │ +0001f650: 6e61 6d65 3d4e 414d 4520 2020 2020 2020  name=NAME       
│ │ │ │ +0001f660: 2020 2020 2020 2020 2020 2043 6c69 656e             Clien
│ │ │ │ +0001f670: 7420 6e61 6d65 2e20 4465 6661 756c 7420  t name. Default 
│ │ │ │ +0001f680: 6973 206c 6f67 696e 0a20 2020 2020 2020  is login.       
│ │ │ │  0001f690: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001f6a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001f6b0: 2020 2020 2020 2020 7573 6572 6e61 6d65          username
│ │ │ │ -0001f6c0: 2e0a 2020 2020 2020 202d 452c 202d 2d65  ..       -E, --e
│ │ │ │ -0001f6d0: 6e63 7279 7074 696f 6e2d 7479 7065 3d45  ncryption-type=E
│ │ │ │ -0001f6e0: 5459 5045 2c5b 4554 5950 452e 2e2e 5d20  TYPE,[ETYPE...] 
│ │ │ │ -0001f6f0: 2045 6e63 7279 7074 696f 6e20 7479 7065   Encryption type
│ │ │ │ -0001f700: 7320 746f 2075 7365 2e20 2045 5459 5045  s to use.  ETYPE
│ │ │ │ -0001f710: 2069 730a 2020 2020 2020 2020 2020 2020   is.            
│ │ │ │ +0001f6b0: 2020 2020 2020 2020 2020 7573 6572 6e61            userna
│ │ │ │ +0001f6c0: 6d65 2e0a 2020 2020 2020 202d 452c 202d  me..       -E, -
│ │ │ │ +0001f6d0: 2d65 6e63 7279 7074 696f 6e2d 7479 7065  -encryption-type
│ │ │ │ +0001f6e0: 3d45 5459 5045 2c5b 4554 5950 452e 2e2e  =ETYPE,[ETYPE...
│ │ │ │ +0001f6f0: 5d20 2045 6e63 7279 7074 696f 6e20 7479  ]  Encryption ty
│ │ │ │ +0001f700: 7065 7320 746f 2075 7365 2e20 2045 5459  pes to use.  ETY
│ │ │ │ +0001f710: 5045 2069 730a 2020 2020 2020 2020 2020  PE is.          
│ │ │ │  0001f720: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001f730: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001f740: 2020 2020 2065 6974 6865 7220 7265 6769       either regi
│ │ │ │ -0001f750: 7374 6572 6564 206e 616d 6520 6f72 2069  stered name or i
│ │ │ │ -0001f760: 6e74 6567 6572 2e0a 2020 2020 2020 2020  nteger..        
│ │ │ │ +0001f740: 2020 2020 2020 2065 6974 6865 7220 7265         either re
│ │ │ │ +0001f750: 6769 7374 6572 6564 206e 616d 6520 6f72  gistered name or
│ │ │ │ +0001f760: 2069 6e74 6567 6572 2e0a 2020 2020 2020   integer..      
│ │ │ │  0001f770: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001f780: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001f790: 2020 2020 2020 2020 2020 5661 6c69 6420            Valid 
│ │ │ │ -0001f7a0: 7661 6c75 6573 2069 6e63 6c75 6465 2027  values include '
│ │ │ │ -0001f7b0: 6165 7331 3238 272c 0a20 2020 2020 2020  aes128',.       
│ │ │ │ +0001f790: 2020 2020 2020 2020 2020 2020 5661 6c69              Vali
│ │ │ │ +0001f7a0: 6420 7661 6c75 6573 2069 6e63 6c75 6465  d values include
│ │ │ │ +0001f7b0: 2027 6165 7331 3238 272c 0a20 2020 2020   'aes128',.     
│ │ │ │  0001f7c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001f7d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001f7e0: 2020 2020 2020 2020 2020 2761 6573 3235            'aes25
│ │ │ │ -0001f7f0: 3627 2c20 2761 6573 2720 2873 616d 6520  6', 'aes' (same 
│ │ │ │ -0001f800: 6173 0a20 2020 2020 2020 2020 2020 2020  as.             
│ │ │ │ +0001f7e0: 2020 2020 2020 2020 2020 2020 2761 6573              'aes
│ │ │ │ +0001f7f0: 3235 3627 2c20 2761 6573 2720 2873 616d  256', 'aes' (sam
│ │ │ │ +0001f800: 6520 6173 0a20 2020 2020 2020 2020 2020  e as.           
│ │ │ │  0001f810: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001f820: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001f830: 2020 2020 2761 6573 3235 3627 292c 2027      'aes256'), '
│ │ │ │ -0001f840: 3364 6573 272c 2027 6465 732d 6d64 3527  3des', 'des-md5'
│ │ │ │ -0001f850: 2c0a 2020 2020 2020 2020 2020 2020 2020  ,.              
│ │ │ │ +0001f830: 2020 2020 2020 2761 6573 3235 3627 292c        'aes256'),
│ │ │ │ +0001f840: 2027 3364 6573 272c 2027 6465 732d 6d64   '3des', 'des-md
│ │ │ │ +0001f850: 3527 2c0a 2020 2020 2020 2020 2020 2020  5',.            
│ │ │ │  0001f860: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001f870: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001f880: 2020 2027 6465 732d 6d64 3427 2c20 2764     'des-md4', 'd
│ │ │ │ -0001f890: 6573 2d63 7263 272c 2027 6465 7327 2028  es-crc', 'des' (
│ │ │ │ -0001f8a0: 7361 6d65 0a20 2020 2020 2020 2020 2020  same.           
│ │ │ │ +0001f880: 2020 2020 2027 6465 732d 6d64 3427 2c20       'des-md4', 
│ │ │ │ +0001f890: 2764 6573 2d63 7263 272c 2027 6465 7327  'des-crc', 'des'
│ │ │ │ +0001f8a0: 2028 7361 6d65 0a20 2020 2020 2020 2020   (same.         
│ │ │ │  0001f8b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001f8c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001f8d0: 2020 2020 2020 6173 2027 6465 732d 6d64        as 'des-md
│ │ │ │ -0001f8e0: 3527 292c 2061 6e64 2027 6172 6366 6f75  5'), and 'arcfou
│ │ │ │ -0001f8f0: 7227 2e0a 2020 2020 2020 202d 652c 202d  r'..       -e, -
│ │ │ │ -0001f900: 2d65 6e64 7469 6d65 3d53 5452 494e 4720  -endtime=STRING 
│ │ │ │ -0001f910: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001f920: 2020 2053 7065 6369 6679 2077 6865 6e20     Specify when 
│ │ │ │ -0001f930: 7469 636b 6574 2076 616c 6964 6974 7920  ticket validity 
│ │ │ │ -0001f940: 7368 6f75 6c64 0a20 2020 2020 2020 2020  should.         
│ │ │ │ +0001f8d0: 2020 2020 2020 2020 6173 2027 6465 732d          as 'des-
│ │ │ │ +0001f8e0: 6d64 3527 292c 2061 6e64 2027 6172 6366  md5'), and 'arcf
│ │ │ │ +0001f8f0: 6f75 7227 2e0a 2020 2020 2020 202d 652c  our'..       -e,
│ │ │ │ +0001f900: 202d 2d65 6e64 7469 6d65 3d53 5452 494e   --endtime=STRIN
│ │ │ │ +0001f910: 4720 2020 2020 2020 2020 2020 2020 2020  G               
│ │ │ │ +0001f920: 2020 2020 2053 7065 6369 6679 2077 6865       Specify whe
│ │ │ │ +0001f930: 6e20 7469 636b 6574 2076 616c 6964 6974  n ticket validit
│ │ │ │ +0001f940: 7920 7368 6f75 6c64 0a20 2020 2020 2020  y should.       
│ │ │ │  0001f950: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001f960: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001f970: 2020 2020 2020 2020 6578 7069 7265 2e20          expire. 
│ │ │ │ -0001f980: 2054 6865 2074 696d 6520 7379 6e74 6178   The time syntax
│ │ │ │ -0001f990: 206d 6179 2062 650a 2020 2020 2020 2020   may be.        
│ │ │ │ +0001f970: 2020 2020 2020 2020 2020 6578 7069 7265            expire
│ │ │ │ +0001f980: 2e20 2054 6865 2074 696d 6520 7379 6e74  .  The time synt
│ │ │ │ +0001f990: 6178 206d 6179 2062 650a 2020 2020 2020  ax may be.      
│ │ │ │  0001f9a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001f9b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001f9c0: 2020 2020 2020 2020 2072 656c 6174 6976           relativ
│ │ │ │ -0001f9d0: 6520 2874 6f20 7468 6520 7374 6172 7420  e (to the start 
│ │ │ │ -0001f9e0: 7469 6d65 292c 2073 7563 680a 2020 2020  time), such.    
│ │ │ │ +0001f9c0: 2020 2020 2020 2020 2020 2072 656c 6174             relat
│ │ │ │ +0001f9d0: 6976 6520 2874 6f20 7468 6520 7374 6172  ive (to the star
│ │ │ │ +0001f9e0: 7420 7469 6d65 292c 2073 7563 680a 2020  t time), such.  
│ │ │ │  0001f9f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001fa00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001fa10: 2020 2020 2020 2020 2020 2020 2061 7320               as 
│ │ │ │ -0001fa20: 2732 3020 686f 7572 7327 2c20 6f72 2061  '20 hours', or a
│ │ │ │ -0001fa30: 6273 6f6c 7574 652c 2073 7563 680a 2020  bsolute, such.  
│ │ │ │ +0001fa10: 2020 2020 2020 2020 2020 2020 2020 2061                 a
│ │ │ │ +0001fa20: 7320 2732 3020 686f 7572 7327 2c20 6f72  s '20 hours', or
│ │ │ │ +0001fa30: 2061 6273 6f6c 7574 652c 2073 7563 680a   absolute, such.
│ │ │ │  0001fa40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001fa50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001fa60: 2020 2020 2020 2020 2020 2020 2020 2061                 a
│ │ │ │ -0001fa70: 7320 2732 3030 312d 3032 2d30 3320 3034  s '2001-02-03 04
│ │ │ │ -0001fa80: 3a30 353a 3036 2043 4554 272e 2054 6865  :05:06 CET'. The
│ │ │ │ -0001fa90: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ +0001fa60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0001fa70: 2061 7320 2732 3030 312d 3032 2d30 3320   as '2001-02-03 
│ │ │ │ +0001fa80: 3034 3a30 353a 3036 2043 4554 272e 2054  04:05:06 CET'. T
│ │ │ │ +0001fa90: 6865 0a20 2020 2020 2020 2020 2020 2020  he.             
│ │ │ │  0001faa0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001fab0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001fac0: 2020 6465 6661 756c 7420 6973 2038 2068    default is 8 h
│ │ │ │ -0001fad0: 6f75 7273 2061 6674 6572 2074 6865 2073  ours after the s
│ │ │ │ -0001fae0: 7461 7274 0a20 2020 2020 2020 2020 2020  tart.           
│ │ │ │ +0001fac0: 2020 2020 6465 6661 756c 7420 6973 2038      default is 8
│ │ │ │ +0001fad0: 2068 6f75 7273 2061 6674 6572 2074 6865   hours after the
│ │ │ │ +0001fae0: 2073 7461 7274 0a20 2020 2020 2020 2020   start.         
│ │ │ │  0001faf0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001fb00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001fb10: 2020 2020 2020 7469 6d65 2e0a 2020 2020        time..    
│ │ │ │ -0001fb20: 2020 2020 2020 202d 2d72 6561 6c6d 3d53         --realm=S
│ │ │ │ -0001fb30: 5452 494e 4720 2020 2020 2020 2020 2020  TRING           
│ │ │ │ -0001fb40: 2020 2020 2020 2020 2020 2053 6574 2064             Set d
│ │ │ │ -0001fb50: 6566 6175 6c74 2072 6561 6c6d 2e0a 2020  efault realm..  
│ │ │ │ -0001fb60: 2020 2020 2020 2020 202d 2d72 656e 6577           --renew
│ │ │ │ -0001fb70: 2d74 696c 6c3d 5354 5249 4e47 2020 2020  -till=STRING    
│ │ │ │ -0001fb80: 2020 2020 2020 2020 2020 2020 2053 7065               Spe
│ │ │ │ -0001fb90: 6369 6679 2072 656e 6577 6162 6c65 206c  cify renewable l
│ │ │ │ -0001fba0: 6966 6520 6f66 2074 6963 6b65 742e 0a20  ife of ticket.. 
│ │ │ │ -0001fbb0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0001fb10: 2020 2020 2020 2020 7469 6d65 2e0a 2020          time..  
│ │ │ │ +0001fb20: 2020 2020 2020 2020 202d 2d72 6561 6c6d           --realm
│ │ │ │ +0001fb30: 3d53 5452 494e 4720 2020 2020 2020 2020  =STRING         
│ │ │ │ +0001fb40: 2020 2020 2020 2020 2020 2020 2053 6574               Set
│ │ │ │ +0001fb50: 2064 6566 6175 6c74 2072 6561 6c6d 2e0a   default realm..
│ │ │ │ +0001fb60: 2020 2020 2020 2020 2020 202d 2d72 656e             --ren
│ │ │ │ +0001fb70: 6577 2d74 696c 6c3d 5354 5249 4e47 2020  ew-till=STRING  
│ │ │ │ +0001fb80: 2020 2020 2020 2020 2020 2020 2020 2053                 S
│ │ │ │ +0001fb90: 7065 6369 6679 2072 656e 6577 6162 6c65  pecify renewable
│ │ │ │ +0001fba0: 206c 6966 6520 6f66 2074 6963 6b65 742e   life of ticket.
│ │ │ │ +0001fbb0: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │  0001fbc0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001fbd0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001fbe0: 496d 706c 6965 7320 2d2d 7265 6e65 7761  Implies --renewa
│ │ │ │ -0001fbf0: 626c 652e 2020 4163 6365 7074 7320 7361  ble.  Accepts sa
│ │ │ │ -0001fc00: 6d65 0a20 2020 2020 2020 2020 2020 2020  me.             
│ │ │ │ +0001fbe0: 2020 496d 706c 6965 7320 2d2d 7265 6e65    Implies --rene
│ │ │ │ +0001fbf0: 7761 626c 652e 2020 4163 6365 7074 7320  wable.  Accepts 
│ │ │ │ +0001fc00: 7361 6d65 0a20 2020 2020 2020 2020 2020  same.           
│ │ │ │  0001fc10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001fc20: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001fc30: 2020 2020 7469 6d65 2073 796e 7461 7820      time syntax 
│ │ │ │ -0001fc40: 6173 202d 2d65 6e64 7469 6d65 2e20 2049  as --endtime.  I
│ │ │ │ -0001fc50: 660a 2020 2020 2020 2020 2020 2020 2020  f.              
│ │ │ │ +0001fc30: 2020 2020 2020 7469 6d65 2073 796e 7461        time synta
│ │ │ │ +0001fc40: 7820 6173 202d 2d65 6e64 7469 6d65 2e20  x as --endtime. 
│ │ │ │ +0001fc50: 2049 660a 2020 2020 2020 2020 2020 2020   If.            
│ │ │ │  0001fc60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001fc70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001fc80: 2020 202d 2d72 656e 6577 6162 6c65 2069     --renewable i
│ │ │ │ -0001fc90: 7320 7370 6563 6966 6965 642c 2074 6865  s specified, the
│ │ │ │ -0001fca0: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ +0001fc80: 2020 2020 202d 2d72 656e 6577 6162 6c65       --renewable
│ │ │ │ +0001fc90: 2069 7320 7370 6563 6966 6965 642c 2074   is specified, t
│ │ │ │ +0001fca0: 6865 0a20 2020 2020 2020 2020 2020 2020  he.             
│ │ │ │  0001fcb0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001fcc0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001fcd0: 2020 6465 6661 756c 7420 6973 2031 2077    default is 1 w
│ │ │ │ -0001fce0: 6565 6b20 6166 7465 7220 7468 6520 7374  eek after the st
│ │ │ │ -0001fcf0: 6172 740a 2020 2020 2020 2020 2020 2020  art.            
│ │ │ │ +0001fcd0: 2020 2020 6465 6661 756c 7420 6973 2031      default is 1
│ │ │ │ +0001fce0: 2077 6565 6b20 6166 7465 7220 7468 6520   week after the 
│ │ │ │ +0001fcf0: 7374 6172 740a 2020 2020 2020 2020 2020  start.          
│ │ │ │  0001fd00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001fd10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001fd20: 2020 2020 2074 696d 652e 0a20 2020 2020       time..     
│ │ │ │ -0001fd30: 2020 2020 2020 2d2d 7365 7276 6572 2d6e        --server-n
│ │ │ │ -0001fd40: 616d 653d 4e41 4d45 2020 2020 2020 2020  ame=NAME        
│ │ │ │ -0001fd50: 2020 2020 2020 2020 2020 5365 7276 6572            Server
│ │ │ │ -0001fd60: 206e 616d 652e 2044 6566 6175 6c74 2069   name. Default i
│ │ │ │ -0001fd70: 730a 2020 2020 2020 2020 2020 2020 2020  s.              
│ │ │ │ +0001fd20: 2020 2020 2020 2074 696d 652e 0a20 2020         time..   
│ │ │ │ +0001fd30: 2020 2020 2020 2020 2d2d 7365 7276 6572          --server
│ │ │ │ +0001fd40: 2d6e 616d 653d 4e41 4d45 2020 2020 2020  -name=NAME      
│ │ │ │ +0001fd50: 2020 2020 2020 2020 2020 2020 5365 7276              Serv
│ │ │ │ +0001fd60: 6572 206e 616d 652e 2044 6566 6175 6c74  er name. Default
│ │ │ │ +0001fd70: 2069 730a 2020 2020 2020 2020 2020 2020   is.            
│ │ │ │  0001fd80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001fd90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001fda0: 2020 2027 6b72 6274 6774 2f52 4541 4c4d     'krbtgt/REALM
│ │ │ │ -0001fdb0: 2720 7768 6572 6520 5245 414c 4d20 6973  ' where REALM is
│ │ │ │ -0001fdc0: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ +0001fda0: 2020 2020 2027 6b72 6274 6774 2f52 4541       'krbtgt/REA
│ │ │ │ +0001fdb0: 4c4d 2720 7768 6572 6520 5245 414c 4d20  LM' where REALM 
│ │ │ │ +0001fdc0: 6973 0a20 2020 2020 2020 2020 2020 2020  is.             
│ │ │ │  0001fdd0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001fde0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001fdf0: 2020 636c 6965 6e74 2072 6561 6c6d 2e0a    client realm..
│ │ │ │ -0001fe00: 2020 2020 2020 202d 732c 202d 2d73 7461         -s, --sta
│ │ │ │ -0001fe10: 7274 7469 6d65 3d53 5452 494e 4720 2020  rttime=STRING   
│ │ │ │ -0001fe20: 2020 2020 2020 2020 2020 2020 2020 2053                 S
│ │ │ │ -0001fe30: 7065 6369 6679 2077 6865 6e20 7469 636b  pecify when tick
│ │ │ │ -0001fe40: 6574 2073 686f 756c 6420 7374 6172 7420  et should start 
│ │ │ │ -0001fe50: 746f 0a20 2020 2020 2020 2020 2020 2020  to.             
│ │ │ │ +0001fdf0: 2020 2020 636c 6965 6e74 2072 6561 6c6d      client realm
│ │ │ │ +0001fe00: 2e0a 2020 2020 2020 202d 732c 202d 2d73  ..       -s, --s
│ │ │ │ +0001fe10: 7461 7274 7469 6d65 3d53 5452 494e 4720  tarttime=STRING 
│ │ │ │ +0001fe20: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0001fe30: 2053 7065 6369 6679 2077 6865 6e20 7469   Specify when ti
│ │ │ │ +0001fe40: 636b 6574 2073 686f 756c 6420 7374 6172  cket should star
│ │ │ │ +0001fe50: 7420 746f 0a20 2020 2020 2020 2020 2020  t to.           
│ │ │ │  0001fe60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001fe70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001fe80: 2020 2020 6265 2076 616c 6964 2e20 2041      be valid.  A
│ │ │ │ -0001fe90: 6363 6570 7473 2073 616d 6520 7469 6d65  ccepts same time
│ │ │ │ -0001fea0: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ +0001fe80: 2020 2020 2020 6265 2076 616c 6964 2e20        be valid. 
│ │ │ │ +0001fe90: 2041 6363 6570 7473 2073 616d 6520 7469   Accepts same ti
│ │ │ │ +0001fea0: 6d65 0a20 2020 2020 2020 2020 2020 2020  me.             
│ │ │ │  0001feb0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001fec0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001fed0: 2020 7379 6e74 6178 2061 7320 2d2d 656e    syntax as --en
│ │ │ │ -0001fee0: 6474 696d 652e 2054 6865 2064 6566 6175  dtime. The defau
│ │ │ │ -0001fef0: 6c74 0a20 2020 2020 2020 2020 2020 2020  lt.             
│ │ │ │ +0001fed0: 2020 2020 7379 6e74 6178 2061 7320 2d2d      syntax as --
│ │ │ │ +0001fee0: 656e 6474 696d 652e 2054 6865 2064 6566  endtime. The def
│ │ │ │ +0001fef0: 6175 6c74 0a20 2020 2020 2020 2020 2020  ault.           
│ │ │ │  0001ff00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001ff10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001ff20: 2020 2020 6973 2074 6f20 6265 636f 6d65      is to become
│ │ │ │ -0001ff30: 2076 616c 6964 2069 6d6d 6564 6961 7465   valid immediate
│ │ │ │ -0001ff40: 6c79 2e0a 2020 2020 2020 2020 2020 202d  ly..           -
│ │ │ │ -0001ff50: 2d74 6963 6b65 742d 6772 616e 7465 723d  -ticket-granter=
│ │ │ │ -0001ff60: 4e41 4d45 2020 2020 2020 2020 2020 2020  NAME            
│ │ │ │ -0001ff70: 2020 2053 6572 7669 6365 206e 616d 6520     Service name 
│ │ │ │ -0001ff80: 696e 2074 6963 6b65 7420 746f 2075 7365  in ticket to use
│ │ │ │ -0001ff90: 2066 6f72 0a20 2020 2020 2020 2020 2020   for.           
│ │ │ │ +0001ff20: 2020 2020 2020 6973 2074 6f20 6265 636f        is to beco
│ │ │ │ +0001ff30: 6d65 2076 616c 6964 2069 6d6d 6564 6961  me valid immedia
│ │ │ │ +0001ff40: 7465 6c79 2e0a 2020 2020 2020 2020 2020  tely..          
│ │ │ │ +0001ff50: 202d 2d74 6963 6b65 742d 6772 616e 7465   --ticket-grante
│ │ │ │ +0001ff60: 723d 4e41 4d45 2020 2020 2020 2020 2020  r=NAME          
│ │ │ │ +0001ff70: 2020 2020 2053 6572 7669 6365 206e 616d       Service nam
│ │ │ │ +0001ff80: 6520 696e 2074 6963 6b65 7420 746f 2075  e in ticket to u
│ │ │ │ +0001ff90: 7365 2066 6f72 0a20 2020 2020 2020 2020  se for.         
│ │ │ │  0001ffa0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001ffb0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001ffc0: 2020 2020 2020 6175 7468 656e 7469 6361        authentica
│ │ │ │ -0001ffd0: 7469 6e67 2072 6571 7565 7374 2e20 4f6e  ting request. On
│ │ │ │ -0001ffe0: 6c79 2066 6f72 0a20 2020 2020 2020 2020  ly for.         
│ │ │ │ +0001ffc0: 2020 2020 2020 2020 6175 7468 656e 7469          authenti
│ │ │ │ +0001ffd0: 6361 7469 6e67 2072 6571 7565 7374 2e20  cating request. 
│ │ │ │ +0001ffe0: 4f6e 6c79 2066 6f72 0a20 2020 2020 2020  Only for.       
│ │ │ │  0001fff0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00020000: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00020010: 2020 2020 2020 2020 5447 532e 2044 6566          TGS. Def
│ │ │ │ -00020020: 6175 6c74 7320 746f 0a20 2020 2020 2020  aults to.       
│ │ │ │ +00020010: 2020 2020 2020 2020 2020 5447 532e 2044            TGS. D
│ │ │ │ +00020020: 6566 6175 6c74 7320 746f 0a20 2020 2020  efaults to.     
│ │ │ │  00020030: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00020040: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00020050: 2020 2020 2020 2020 2020 276b 7262 7467            'krbtg
│ │ │ │ -00020060: 742f 5245 414c 4d40 5245 414c 4d27 2077  t/REALM@REALM' w
│ │ │ │ -00020070: 6865 7265 2052 4541 4c4d 0a20 2020 2020  here REALM.     
│ │ │ │ +00020050: 2020 2020 2020 2020 2020 2020 276b 7262              'krb
│ │ │ │ +00020060: 7467 742f 5245 414c 4d40 5245 414c 4d27  tgt/REALM@REALM'
│ │ │ │ +00020070: 2077 6865 7265 2052 4541 4c4d 0a20 2020   where REALM.   
│ │ │ │  00020080: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00020090: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000200a0: 2020 2020 2020 2020 2020 2020 6973 2063              is c
│ │ │ │ -000200b0: 6c69 656e 7420 7265 616c 6d2e 0a0a 2020  lient realm...  
│ │ │ │ -000200c0: 2020 204f 7468 6572 206f 7074 696f 6e73     Other options
│ │ │ │ -000200d0: 3a0a 2020 2020 2020 2020 2020 202d 2d63  :.           --c
│ │ │ │ -000200e0: 6f6e 6669 6775 7261 7469 6f6e 2d66 696c  onfiguration-fil
│ │ │ │ -000200f0: 653d 4649 4c45 2020 2020 2020 2020 2020  e=FILE          
│ │ │ │ -00020100: 2052 6561 6420 7573 6572 2063 6f6e 6669   Read user confi
│ │ │ │ -00020110: 6775 7261 7469 6f6e 2066 726f 6d20 4649  guration from FI
│ │ │ │ -00020120: 4c45 2e0a 2020 2020 2020 202d 632c 202d  LE..       -c, -
│ │ │ │ -00020130: 2d74 6963 6b65 742d 6669 6c65 3d46 494c  -ticket-file=FIL
│ │ │ │ -00020140: 4520 2020 2020 2020 2020 2020 2020 2020  E               
│ │ │ │ -00020150: 2020 2052 6561 6420 7469 636b 6574 7320     Read tickets 
│ │ │ │ -00020160: 6672 6f6d 2046 494c 452e 0a20 2020 2020  from FILE..     
│ │ │ │ -00020170: 2020 2d6f 2c20 2d2d 6c69 6272 6172 792d    -o, --library-
│ │ │ │ -00020180: 6f70 7469 6f6e 733d 5354 5249 4e47 2020  options=STRING  
│ │ │ │ -00020190: 2020 2020 2020 2020 2020 5061 7273 6520            Parse 
│ │ │ │ -000201a0: 5354 5249 4e47 2061 7320 6120 636f 6e66  STRING as a conf
│ │ │ │ -000201b0: 6967 7572 6174 696f 6e20 6669 6c65 0a20  iguration file. 
│ │ │ │ -000201c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +000200a0: 2020 2020 2020 2020 2020 2020 2020 6973                is
│ │ │ │ +000200b0: 2063 6c69 656e 7420 7265 616c 6d2e 0a0a   client realm...
│ │ │ │ +000200c0: 2020 2020 204f 7468 6572 206f 7074 696f       Other optio
│ │ │ │ +000200d0: 6e73 3a0a 2020 2020 2020 2020 2020 202d  ns:.           -
│ │ │ │ +000200e0: 2d63 6f6e 6669 6775 7261 7469 6f6e 2d66  -configuration-f
│ │ │ │ +000200f0: 696c 653d 4649 4c45 2020 2020 2020 2020  ile=FILE        
│ │ │ │ +00020100: 2020 2052 6561 6420 7573 6572 2063 6f6e     Read user con
│ │ │ │ +00020110: 6669 6775 7261 7469 6f6e 2066 726f 6d20  figuration from 
│ │ │ │ +00020120: 4649 4c45 2e0a 2020 2020 2020 202d 632c  FILE..       -c,
│ │ │ │ +00020130: 202d 2d74 6963 6b65 742d 6669 6c65 3d46   --ticket-file=F
│ │ │ │ +00020140: 494c 4520 2020 2020 2020 2020 2020 2020  ILE             
│ │ │ │ +00020150: 2020 2020 2052 6561 6420 7469 636b 6574       Read ticket
│ │ │ │ +00020160: 7320 6672 6f6d 2046 494c 452e 0a20 2020  s from FILE..   
│ │ │ │ +00020170: 2020 2020 2d6f 2c20 2d2d 6c69 6272 6172      -o, --librar
│ │ │ │ +00020180: 792d 6f70 7469 6f6e 733d 5354 5249 4e47  y-options=STRING
│ │ │ │ +00020190: 2020 2020 2020 2020 2020 2020 5061 7273              Pars
│ │ │ │ +000201a0: 6520 5354 5249 4e47 2061 7320 6120 636f  e STRING as a co
│ │ │ │ +000201b0: 6e66 6967 7572 6174 696f 6e20 6669 6c65  nfiguration file
│ │ │ │ +000201c0: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │  000201d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000201e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000201f0: 7374 6174 656d 656e 742e 0a20 2020 2020  statement..     
│ │ │ │ -00020200: 2020 2d71 2c20 2d2d 7175 6965 7420 2020    -q, --quiet   
│ │ │ │ +000201f0: 2020 7374 6174 656d 656e 742e 0a20 2020    statement..   
│ │ │ │ +00020200: 2020 2020 2d71 2c20 2d2d 7175 6965 7420      -q, --quiet 
│ │ │ │  00020210: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00020220: 2020 2020 2020 2020 2020 446f 6e27 7420            Don't 
│ │ │ │ -00020230: 7072 6f64 7563 6520 616e 7920 6469 6167  produce any diag
│ │ │ │ -00020240: 6e6f 7374 6963 206f 7574 7075 742e 0a20  nostic output.. 
│ │ │ │ -00020250: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +00020220: 2020 2020 2020 2020 2020 2020 446f 6e27              Don'
│ │ │ │ +00020230: 7420 7072 6f64 7563 6520 616e 7920 6469  t produce any di
│ │ │ │ +00020240: 6167 6e6f 7374 6963 206f 7574 7075 742e  agnostic output.
│ │ │ │ +00020250: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │  00020260: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00020270: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00020280: 2020 2864 6566 6175 6c74 3d6f 6666 290a    (default=off).
│ │ │ │ -00020290: 2020 2020 2020 2020 2020 202d 2d73 7973             --sys
│ │ │ │ -000202a0: 7465 6d2d 636f 6e66 6967 7572 6174 696f  tem-configuratio
│ │ │ │ -000202b0: 6e2d 6669 6c65 3d46 494c 4520 2020 2052  n-file=FILE    R
│ │ │ │ -000202c0: 6561 6420 7379 7374 656d 2063 6f6e 6669  ead system confi
│ │ │ │ -000202d0: 6775 7261 7469 6f6e 2066 726f 6d20 4649  guration from FI
│ │ │ │ -000202e0: 4c45 2e0a 2020 2020 2020 2020 2020 202d  LE..           -
│ │ │ │ -000202f0: 2d74 6963 6b65 742d 7772 6974 652d 6669  -ticket-write-fi
│ │ │ │ -00020300: 6c65 3d46 494c 4520 2020 2020 2020 2020  le=FILE         
│ │ │ │ -00020310: 2020 2057 7269 7465 2074 6963 6b65 7473     Write tickets
│ │ │ │ -00020320: 2066 726f 6d20 4649 4c45 2e20 2044 6566   from FILE.  Def
│ │ │ │ -00020330: 6175 6c74 2069 730a 2020 2020 2020 2020  ault is.        
│ │ │ │ +00020280: 2020 2020 2864 6566 6175 6c74 3d6f 6666      (default=off
│ │ │ │ +00020290: 290a 2020 2020 2020 2020 2020 202d 2d73  ).           --s
│ │ │ │ +000202a0: 7973 7465 6d2d 636f 6e66 6967 7572 6174  ystem-configurat
│ │ │ │ +000202b0: 696f 6e2d 6669 6c65 3d46 494c 4520 2020  ion-file=FILE   
│ │ │ │ +000202c0: 2052 6561 6420 7379 7374 656d 2063 6f6e   Read system con
│ │ │ │ +000202d0: 6669 6775 7261 7469 6f6e 2066 726f 6d20  figuration from 
│ │ │ │ +000202e0: 4649 4c45 2e0a 2020 2020 2020 2020 2020  FILE..          
│ │ │ │ +000202f0: 202d 2d74 6963 6b65 742d 7772 6974 652d   --ticket-write-
│ │ │ │ +00020300: 6669 6c65 3d46 494c 4520 2020 2020 2020  file=FILE       
│ │ │ │ +00020310: 2020 2020 2057 7269 7465 2074 6963 6b65       Write ticke
│ │ │ │ +00020320: 7473 2066 726f 6d20 4649 4c45 2e20 2044  ts from FILE.  D
│ │ │ │ +00020330: 6566 6175 6c74 2069 730a 2020 2020 2020  efault is.      
│ │ │ │  00020340: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00020350: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00020360: 2020 2020 2020 2020 2074 6f20 7772 6974           to writ
│ │ │ │ -00020370: 6520 7468 656d 2062 6163 6b20 746f 2077  e them back to w
│ │ │ │ -00020380: 6865 7265 2074 6865 790a 2020 2020 2020  here they.      
│ │ │ │ +00020360: 2020 2020 2020 2020 2020 2074 6f20 7772             to wr
│ │ │ │ +00020370: 6974 6520 7468 656d 2062 6163 6b20 746f  ite them back to
│ │ │ │ +00020380: 2077 6865 7265 2074 6865 790a 2020 2020   where they.    
│ │ │ │  00020390: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000203a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000203b0: 2020 2020 2020 2020 2020 2077 6572 6520             were 
│ │ │ │ -000203c0: 7265 6164 2066 726f 6d2e 0a20 2020 2020  read from..     
│ │ │ │ -000203d0: 2020 2d76 2c20 2d2d 7665 7262 6f73 6520    -v, --verbose 
│ │ │ │ -000203e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000203f0: 2020 2020 2020 2020 2020 5072 6f64 7563            Produc
│ │ │ │ -00020400: 6520 7665 7262 6f73 6520 6f75 7470 7574  e verbose output
│ │ │ │ -00020410: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │ +000203b0: 2020 2020 2020 2020 2020 2020 2077 6572               wer
│ │ │ │ +000203c0: 6520 7265 6164 2066 726f 6d2e 0a20 2020  e read from..   
│ │ │ │ +000203d0: 2020 2020 2d76 2c20 2d2d 7665 7262 6f73      -v, --verbos
│ │ │ │ +000203e0: 6520 2020 2020 2020 2020 2020 2020 2020  e               
│ │ │ │ +000203f0: 2020 2020 2020 2020 2020 2020 5072 6f64              Prod
│ │ │ │ +00020400: 7563 6520 7665 7262 6f73 6520 6f75 7470  uce verbose outp
│ │ │ │ +00020410: 7574 2e0a 2020 2020 2020 2020 2020 2020  ut..            
│ │ │ │  00020420: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00020430: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00020440: 2020 2020 2028 6465 6661 756c 743d 6f66       (default=of
│ │ │ │ -00020450: 6629 0a0a 1f0a 4669 6c65 3a20 7368 6973  f)....File: shis
│ │ │ │ -00020460: 6869 2e69 6e66 6f2c 2020 4e6f 6465 3a20  hi.info,  Node: 
│ │ │ │ -00020470: 5061 7261 6d65 7465 7273 2066 6f72 2073  Parameters for s
│ │ │ │ -00020480: 6869 7368 6964 2c20 204e 6578 743a 2050  hishid,  Next: P
│ │ │ │ -00020490: 6172 616d 6574 6572 7320 666f 7220 7368  arameters for sh
│ │ │ │ -000204a0: 6973 612c 2020 5072 6576 3a20 5061 7261  isa,  Prev: Para
│ │ │ │ -000204b0: 6d65 7465 7273 2066 6f72 2073 6869 7368  meters for shish
│ │ │ │ -000204c0: 692c 2020 5570 3a20 5265 6665 7265 6e63  i,  Up: Referenc
│ │ │ │ -000204d0: 6520 4d61 6e75 616c 0a0a 342e 3720 5061  e Manual..4.7 Pa
│ │ │ │ -000204e0: 7261 6d65 7465 7273 2066 6f72 2073 6869  rameters for shi
│ │ │ │ -000204f0: 7368 6964 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d  shid.===========
│ │ │ │ -00020500: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a  ===============.
│ │ │ │ -00020510: 0a49 6620 6e6f 2070 6172 616d 6574 6572  .If no parameter
│ │ │ │ -00020520: 7320 6172 6520 7370 6563 6966 6965 642c  s are specified,
│ │ │ │ -00020530: 20e2 8098 7368 6973 6869 64e2 8099 206c   ...shishid... l
│ │ │ │ -00020540: 6973 7465 6e73 206f 6e20 7468 6520 6465  istens on the de
│ │ │ │ -00020550: 6661 756c 7473 0a69 6e74 6572 6661 6365  faults.interface
│ │ │ │ -00020560: 7320 616e 6420 616e 7377 6572 7320 696e  s and answers in
│ │ │ │ -00020570: 636f 6d69 6e67 2072 6571 7565 7374 7320  coming requests 
│ │ │ │ -00020580: 7573 696e 6720 7468 6520 6b65 7973 2069  using the keys i
│ │ │ │ -00020590: 6e20 7468 6520 6465 6661 756c 740a 6b65  n the default.ke
│ │ │ │ -000205a0: 7920 6669 6c65 2e0a 0a20 2020 4d61 6e64  y file...   Mand
│ │ │ │ -000205b0: 6174 6f72 7920 6172 6775 6d65 6e74 7320  atory arguments 
│ │ │ │ -000205c0: 746f 206c 6f6e 6720 6f70 7469 6f6e 7320  to long options 
│ │ │ │ -000205d0: 6172 6520 6d61 6e64 6174 6f72 7920 666f  are mandatory fo
│ │ │ │ -000205e0: 7220 7368 6f72 7420 6f70 7469 6f6e 730a  r short options.
│ │ │ │ -000205f0: 746f 6f2e 0a0a 2020 2020 2055 7361 6765  too...     Usage
│ │ │ │ -00020600: 3a20 7368 6973 6869 6420 5b4f 5054 494f  : shishid [OPTIO
│ │ │ │ -00020610: 4e53 5d2e 2e2e 0a0a 2020 2020 2020 202d  NS].....       -
│ │ │ │ -00020620: 682c 202d 2d68 656c 7020 2020 2020 2020  h, --help       
│ │ │ │ -00020630: 2020 2020 2020 2020 2020 2020 2050 7269               Pri
│ │ │ │ -00020640: 6e74 2068 656c 7020 616e 6420 6578 6974  nt help and exit
│ │ │ │ -00020650: 0a20 2020 2020 2020 2d56 2c20 2d2d 7665  .       -V, --ve
│ │ │ │ -00020660: 7273 696f 6e20 2020 2020 2020 2020 2020  rsion           
│ │ │ │ -00020670: 2020 2020 2020 5072 696e 7420 7665 7273        Print vers
│ │ │ │ -00020680: 696f 6e20 616e 6420 6578 6974 0a0a 2020  ion and exit..  
│ │ │ │ -00020690: 2020 2043 6f6d 6d61 6e64 733a 0a20 2020     Commands:.   
│ │ │ │ -000206a0: 2020 2020 2d6c 2c20 2d2d 6c69 7374 656e      -l, --listen
│ │ │ │ -000206b0: 3d5b 4641 4d49 4c59 3a5d 4144 4452 3a50  =[FAMILY:]ADDR:P
│ │ │ │ -000206c0: 4f52 542f 5459 5045 0a20 2020 2020 2020  ORT/TYPE.       
│ │ │ │ +00020440: 2020 2020 2020 2028 6465 6661 756c 743d         (default=
│ │ │ │ +00020450: 6f66 6629 0a0a 1f0a 4669 6c65 3a20 7368  off)....File: sh
│ │ │ │ +00020460: 6973 6869 2e69 6e66 6f2c 2020 4e6f 6465  ishi.info,  Node
│ │ │ │ +00020470: 3a20 5061 7261 6d65 7465 7273 2066 6f72  : Parameters for
│ │ │ │ +00020480: 2073 6869 7368 6964 2c20 204e 6578 743a   shishid,  Next:
│ │ │ │ +00020490: 2050 6172 616d 6574 6572 7320 666f 7220   Parameters for 
│ │ │ │ +000204a0: 7368 6973 612c 2020 5072 6576 3a20 5061  shisa,  Prev: Pa
│ │ │ │ +000204b0: 7261 6d65 7465 7273 2066 6f72 2073 6869  rameters for shi
│ │ │ │ +000204c0: 7368 692c 2020 5570 3a20 5265 6665 7265  shi,  Up: Refere
│ │ │ │ +000204d0: 6e63 6520 4d61 6e75 616c 0a0a 342e 3720  nce Manual..4.7 
│ │ │ │ +000204e0: 5061 7261 6d65 7465 7273 2066 6f72 2073  Parameters for s
│ │ │ │ +000204f0: 6869 7368 6964 0a3d 3d3d 3d3d 3d3d 3d3d  hishid.=========
│ │ │ │ +00020500: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ +00020510: 3d0a 0a49 6620 6e6f 2070 6172 616d 6574  =..If no paramet
│ │ │ │ +00020520: 6572 7320 6172 6520 7370 6563 6966 6965  ers are specifie
│ │ │ │ +00020530: 642c 20e2 8098 7368 6973 6869 64e2 8099  d, ...shishid...
│ │ │ │ +00020540: 206c 6973 7465 6e73 206f 6e20 7468 6520   listens on the 
│ │ │ │ +00020550: 6465 6661 756c 7473 0a69 6e74 6572 6661  defaults.interfa
│ │ │ │ +00020560: 6365 7320 616e 6420 616e 7377 6572 7320  ces and answers 
│ │ │ │ +00020570: 696e 636f 6d69 6e67 2072 6571 7565 7374  incoming request
│ │ │ │ +00020580: 7320 7573 696e 6720 7468 6520 6b65 7973  s using the keys
│ │ │ │ +00020590: 2069 6e20 7468 6520 6465 6661 756c 740a   in the default.
│ │ │ │ +000205a0: 6b65 7920 6669 6c65 2e0a 0a20 2020 4d61  key file...   Ma
│ │ │ │ +000205b0: 6e64 6174 6f72 7920 6172 6775 6d65 6e74  ndatory argument
│ │ │ │ +000205c0: 7320 746f 206c 6f6e 6720 6f70 7469 6f6e  s to long option
│ │ │ │ +000205d0: 7320 6172 6520 6d61 6e64 6174 6f72 7920  s are mandatory 
│ │ │ │ +000205e0: 666f 7220 7368 6f72 7420 6f70 7469 6f6e  for short option
│ │ │ │ +000205f0: 730a 746f 6f2e 0a0a 2020 2020 2055 7361  s.too...     Usa
│ │ │ │ +00020600: 6765 3a20 7368 6973 6869 6420 5b4f 5054  ge: shishid [OPT
│ │ │ │ +00020610: 494f 4e53 5d2e 2e2e 0a0a 2020 2020 2020  IONS].....      
│ │ │ │ +00020620: 202d 682c 202d 2d68 656c 7020 2020 2020   -h, --help     
│ │ │ │ +00020630: 2020 2020 2020 2020 2020 2020 2020 2050                 P
│ │ │ │ +00020640: 7269 6e74 2068 656c 7020 616e 6420 6578  rint help and ex
│ │ │ │ +00020650: 6974 0a20 2020 2020 2020 2d56 2c20 2d2d  it.       -V, --
│ │ │ │ +00020660: 7665 7273 696f 6e20 2020 2020 2020 2020  version         
│ │ │ │ +00020670: 2020 2020 2020 2020 5072 696e 7420 7665          Print ve
│ │ │ │ +00020680: 7273 696f 6e20 616e 6420 6578 6974 0a0a  rsion and exit..
│ │ │ │ +00020690: 2020 2020 2043 6f6d 6d61 6e64 733a 0a20       Commands:. 
│ │ │ │ +000206a0: 2020 2020 2020 2d6c 2c20 2d2d 6c69 7374        -l, --list
│ │ │ │ +000206b0: 656e 3d5b 4641 4d49 4c59 3a5d 4144 4452  en=[FAMILY:]ADDR
│ │ │ │ +000206c0: 3a50 4f52 542f 5459 5045 0a20 2020 2020  :PORT/TYPE.     
│ │ │ │  000206d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000206e0: 2020 2020 2020 2020 2020 2020 2020 536f                So
│ │ │ │ -000206f0: 636b 6574 7320 746f 206c 6973 7465 6e20  ckets to listen 
│ │ │ │ -00020700: 666f 7220 7175 6572 6965 7320 6f6e 2e20  for queries on. 
│ │ │ │ -00020710: 2046 616d 696c 7920 6973 0a20 2020 2020   Family is.     
│ │ │ │ +000206e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +000206f0: 536f 636b 6574 7320 746f 206c 6973 7465  Sockets to liste
│ │ │ │ +00020700: 6e20 666f 7220 7175 6572 6965 7320 6f6e  n for queries on
│ │ │ │ +00020710: 2e20 2046 616d 696c 7920 6973 0a20 2020  .  Family is.   
│ │ │ │  00020720: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00020730: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00020740: 2020 6049 5076 3427 206f 7220 6049 5076    `IPv4' or `IPv
│ │ │ │ -00020750: 3627 2c20 6966 2061 6273 656e 7420 7468  6', if absent th
│ │ │ │ -00020760: 6520 6661 6d69 6c79 2069 730a 2020 2020  e family is.    
│ │ │ │ +00020740: 2020 2020 6049 5076 3427 206f 7220 6049      `IPv4' or `I
│ │ │ │ +00020750: 5076 3627 2c20 6966 2061 6273 656e 7420  Pv6', if absent 
│ │ │ │ +00020760: 7468 6520 6661 6d69 6c79 2069 730a 2020  the family is.  
│ │ │ │  00020770: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00020780: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00020790: 2020 2064 6563 6964 6564 2062 7920 6765     decided by ge
│ │ │ │ -000207a0: 7468 6f73 7462 796e 616d 6528 4144 4452  thostbyname(ADDR
│ │ │ │ -000207b0: 292e 2041 6e20 6164 6472 6573 7320 6f66  ). An address of
│ │ │ │ -000207c0: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ +00020790: 2020 2020 2064 6563 6964 6564 2062 7920       decided by 
│ │ │ │ +000207a0: 6765 7468 6f73 7462 796e 616d 6528 4144  gethostbyname(AD
│ │ │ │ +000207b0: 4452 292e 2041 6e20 6164 6472 6573 7320  DR). An address 
│ │ │ │ +000207c0: 6f66 0a20 2020 2020 2020 2020 2020 2020  of.             
│ │ │ │  000207d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000207e0: 2020 2020 2020 2020 602a 2720 696e 6469          `*' indi
│ │ │ │ -000207f0: 6361 7465 7320 616c 6c20 6164 6472 6573  cates all addres
│ │ │ │ -00020800: 7365 7320 6f6e 2074 6865 206c 6f63 616c  ses on the local
│ │ │ │ -00020810: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ +000207e0: 2020 2020 2020 2020 2020 602a 2720 696e            `*' in
│ │ │ │ +000207f0: 6469 6361 7465 7320 616c 6c20 6164 6472  dicates all addr
│ │ │ │ +00020800: 6573 7365 7320 6f6e 2074 6865 206c 6f63  esses on the loc
│ │ │ │ +00020810: 616c 0a20 2020 2020 2020 2020 2020 2020  al.             
│ │ │ │  00020820: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00020830: 2020 2020 2020 2020 686f 7374 2e20 5468          host. Th
│ │ │ │ -00020840: 6520 6465 6661 756c 7420 6973 2060 2a3a  e default is `*:
│ │ │ │ -00020850: 6b65 7262 6572 6f73 2f75 6470 2c0a 2020  kerberos/udp,.  
│ │ │ │ +00020830: 2020 2020 2020 2020 2020 686f 7374 2e20            host. 
│ │ │ │ +00020840: 5468 6520 6465 6661 756c 7420 6973 2060  The default is `
│ │ │ │ +00020850: 2a3a 6b65 7262 6572 6f73 2f75 6470 2c0a  *:kerberos/udp,.
│ │ │ │  00020860: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00020870: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00020880: 2020 2020 202a 3a6b 6572 6265 726f 732f       *:kerberos/
│ │ │ │ -00020890: 7463 7027 2e0a 2020 2020 2020 202d 752c  tcp'..       -u,
│ │ │ │ -000208a0: 202d 2d73 6574 7569 643d 4e41 4d45 2020   --setuid=NAME  
│ │ │ │ -000208b0: 2020 2020 2020 2020 2020 2041 6674 6572             After
│ │ │ │ -000208c0: 2062 696e 6469 6e67 2073 6f63 6b65 742c   binding socket,
│ │ │ │ -000208d0: 2073 6574 2075 7365 7220 6964 656e 7469   set user identi
│ │ │ │ -000208e0: 7479 2e0a 0a20 2020 2020 544c 5320 7365  ty...     TLS se
│ │ │ │ -000208f0: 7474 696e 6773 3a0a 2020 2020 2020 2020  ttings:.        
│ │ │ │ -00020900: 2020 202d 2d6e 6f2d 746c 7320 2020 2020     --no-tls     
│ │ │ │ -00020910: 2020 2020 2020 2020 2020 2020 2044 6973               Dis
│ │ │ │ -00020920: 6162 6c65 2054 4c53 2073 7570 706f 7274  able TLS support
│ │ │ │ -00020930: 2020 2864 6566 6175 6c74 3d6f 6666 290a    (default=off).
│ │ │ │ -00020940: 2020 2020 2020 2020 2020 202d 2d78 3530             --x50
│ │ │ │ -00020950: 3963 6166 696c 653d 4649 4c45 2020 2020  9cafile=FILE    
│ │ │ │ -00020960: 2020 2020 2058 2e35 3039 2063 6572 7469       X.509 certi
│ │ │ │ -00020970: 6669 6361 7465 2061 7574 686f 7269 7469  ficate authoriti
│ │ │ │ -00020980: 6573 2075 7365 6420 746f 2076 6572 6966  es used to verif
│ │ │ │ -00020990: 790a 2020 2020 2020 2020 2020 2020 2020  y.              
│ │ │ │ +00020880: 2020 2020 2020 202a 3a6b 6572 6265 726f         *:kerbero
│ │ │ │ +00020890: 732f 7463 7027 2e0a 2020 2020 2020 202d  s/tcp'..       -
│ │ │ │ +000208a0: 752c 202d 2d73 6574 7569 643d 4e41 4d45  u, --setuid=NAME
│ │ │ │ +000208b0: 2020 2020 2020 2020 2020 2020 2041 6674               Aft
│ │ │ │ +000208c0: 6572 2062 696e 6469 6e67 2073 6f63 6b65  er binding socke
│ │ │ │ +000208d0: 742c 2073 6574 2075 7365 7220 6964 656e  t, set user iden
│ │ │ │ +000208e0: 7469 7479 2e0a 0a20 2020 2020 544c 5320  tity...     TLS 
│ │ │ │ +000208f0: 7365 7474 696e 6773 3a0a 2020 2020 2020  settings:.      
│ │ │ │ +00020900: 2020 2020 202d 2d6e 6f2d 746c 7320 2020       --no-tls   
│ │ │ │ +00020910: 2020 2020 2020 2020 2020 2020 2020 2044                 D
│ │ │ │ +00020920: 6973 6162 6c65 2054 4c53 2073 7570 706f  isable TLS suppo
│ │ │ │ +00020930: 7274 2020 2864 6566 6175 6c74 3d6f 6666  rt  (default=off
│ │ │ │ +00020940: 290a 2020 2020 2020 2020 2020 202d 2d78  ).           --x
│ │ │ │ +00020950: 3530 3963 6166 696c 653d 4649 4c45 2020  509cafile=FILE  
│ │ │ │ +00020960: 2020 2020 2020 2058 2e35 3039 2063 6572         X.509 cer
│ │ │ │ +00020970: 7469 6669 6361 7465 2061 7574 686f 7269  tificate authori
│ │ │ │ +00020980: 7469 6573 2075 7365 6420 746f 2076 6572  ties used to ver
│ │ │ │ +00020990: 6966 790a 2020 2020 2020 2020 2020 2020  ify.            
│ │ │ │  000209a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000209b0: 2020 2020 2020 2020 2063 6c69 656e 7420           client 
│ │ │ │ -000209c0: 6365 7274 6966 6963 6174 6573 2c20 696e  certificates, in
│ │ │ │ -000209d0: 2050 454d 2066 6f72 6d61 742e 0a20 2020   PEM format..   
│ │ │ │ -000209e0: 2020 2020 2020 2020 2d2d 7835 3039 6365          --x509ce
│ │ │ │ -000209f0: 7274 6669 6c65 3d46 494c 4520 2020 2020  rtfile=FILE     
│ │ │ │ -00020a00: 2020 582e 3530 3920 7365 7276 6572 2063    X.509 server c
│ │ │ │ -00020a10: 6572 7469 6669 6361 7465 2c20 696e 2050  ertificate, in P
│ │ │ │ -00020a20: 454d 2066 6f72 6d61 742e 0a20 2020 2020  EM format..     
│ │ │ │ -00020a30: 2020 2020 2020 2d2d 7835 3039 6372 6c66        --x509crlf
│ │ │ │ -00020a40: 696c 653d 4649 4c45 2020 2020 2020 2020  ile=FILE        
│ │ │ │ -00020a50: 582e 3530 3920 6365 7274 6966 6963 6174  X.509 certificat
│ │ │ │ -00020a60: 6520 7265 766f 6361 7469 6f6e 206c 6973  e revocation lis
│ │ │ │ -00020a70: 7420 746f 2063 6865 636b 2066 6f72 0a20  t to check for. 
│ │ │ │ -00020a80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +000209b0: 2020 2020 2020 2020 2020 2063 6c69 656e             clien
│ │ │ │ +000209c0: 7420 6365 7274 6966 6963 6174 6573 2c20  t certificates, 
│ │ │ │ +000209d0: 696e 2050 454d 2066 6f72 6d61 742e 0a20  in PEM format.. 
│ │ │ │ +000209e0: 2020 2020 2020 2020 2020 2d2d 7835 3039            --x509
│ │ │ │ +000209f0: 6365 7274 6669 6c65 3d46 494c 4520 2020  certfile=FILE   
│ │ │ │ +00020a00: 2020 2020 582e 3530 3920 7365 7276 6572      X.509 server
│ │ │ │ +00020a10: 2063 6572 7469 6669 6361 7465 2c20 696e   certificate, in
│ │ │ │ +00020a20: 2050 454d 2066 6f72 6d61 742e 0a20 2020   PEM format..   
│ │ │ │ +00020a30: 2020 2020 2020 2020 2d2d 7835 3039 6372          --x509cr
│ │ │ │ +00020a40: 6c66 696c 653d 4649 4c45 2020 2020 2020  lfile=FILE      
│ │ │ │ +00020a50: 2020 582e 3530 3920 6365 7274 6966 6963    X.509 certific
│ │ │ │ +00020a60: 6174 6520 7265 766f 6361 7469 6f6e 206c  ate revocation l
│ │ │ │ +00020a70: 6973 7420 746f 2063 6865 636b 2066 6f72  ist to check for
│ │ │ │ +00020a80: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │  00020a90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00020aa0: 2020 2020 2020 7265 766f 6b65 6420 636c        revoked cl
│ │ │ │ -00020ab0: 6965 6e74 2063 6572 7469 6669 6361 7465  ient certificate
│ │ │ │ -00020ac0: 732c 2069 6e20 5045 4d20 666f 726d 6174  s, in PEM format
│ │ │ │ -00020ad0: 2e0a 2020 2020 2020 2020 2020 202d 2d78  ..           --x
│ │ │ │ -00020ae0: 3530 396b 6579 6669 6c65 3d46 494c 4520  509keyfile=FILE 
│ │ │ │ -00020af0: 2020 2020 2020 2058 2e35 3039 2073 6572         X.509 ser
│ │ │ │ -00020b00: 7665 7220 6365 7274 6966 6963 6174 6520  ver certificate 
│ │ │ │ -00020b10: 6b65 792c 2069 6e20 5045 4d20 666f 726d  key, in PEM form
│ │ │ │ -00020b20: 6174 2e0a 2020 2020 2020 2020 2020 202d  at..           -
│ │ │ │ -00020b30: 2d72 6573 756d 652d 6c69 6d69 743d 5348  -resume-limit=SH
│ │ │ │ -00020b40: 4f52 5420 2020 2020 204b 6565 7020 7472  ORT      Keep tr
│ │ │ │ -00020b50: 6163 6b20 6f66 2075 7020 746f 2074 6869  ack of up to thi
│ │ │ │ -00020b60: 7320 6d61 6e79 2054 4c53 2073 6573 7369  s many TLS sessi
│ │ │ │ -00020b70: 6f6e 7320 666f 720a 2020 2020 2020 2020  ons for.        
│ │ │ │ +00020aa0: 2020 2020 2020 2020 7265 766f 6b65 6420          revoked 
│ │ │ │ +00020ab0: 636c 6965 6e74 2063 6572 7469 6669 6361  client certifica
│ │ │ │ +00020ac0: 7465 732c 2069 6e20 5045 4d20 666f 726d  tes, in PEM form
│ │ │ │ +00020ad0: 6174 2e0a 2020 2020 2020 2020 2020 202d  at..           -
│ │ │ │ +00020ae0: 2d78 3530 396b 6579 6669 6c65 3d46 494c  -x509keyfile=FIL
│ │ │ │ +00020af0: 4520 2020 2020 2020 2058 2e35 3039 2073  E        X.509 s
│ │ │ │ +00020b00: 6572 7665 7220 6365 7274 6966 6963 6174  erver certificat
│ │ │ │ +00020b10: 6520 6b65 792c 2069 6e20 5045 4d20 666f  e key, in PEM fo
│ │ │ │ +00020b20: 726d 6174 2e0a 2020 2020 2020 2020 2020  rmat..          
│ │ │ │ +00020b30: 202d 2d72 6573 756d 652d 6c69 6d69 743d   --resume-limit=
│ │ │ │ +00020b40: 5348 4f52 5420 2020 2020 204b 6565 7020  SHORT      Keep 
│ │ │ │ +00020b50: 7472 6163 6b20 6f66 2075 7020 746f 2074  track of up to t
│ │ │ │ +00020b60: 6869 7320 6d61 6e79 2054 4c53 2073 6573  his many TLS ses
│ │ │ │ +00020b70: 7369 6f6e 7320 666f 720a 2020 2020 2020  sions for.      
│ │ │ │  00020b80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00020b90: 2020 2020 2020 2020 2020 2020 2020 2072                 r
│ │ │ │ -00020ba0: 6573 756d 6520 7075 7270 6f73 6573 2028  esume purposes (
│ │ │ │ -00020bb0: 3020 746f 2064 6973 6162 6c65 2054 4c53  0 to disable TLS
│ │ │ │ -00020bc0: 2072 6573 756d 6529 2e0a 2020 2020 2020   resume)..      
│ │ │ │ +00020b90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +00020ba0: 2072 6573 756d 6520 7075 7270 6f73 6573   resume purposes
│ │ │ │ +00020bb0: 2028 3020 746f 2064 6973 6162 6c65 2054   (0 to disable T
│ │ │ │ +00020bc0: 4c53 2072 6573 756d 6529 2e0a 2020 2020  LS resume)..    
│ │ │ │  00020bd0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00020be0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00020bf0: 2028 6465 6661 756c 743d 6035 3027 290a   (default=`50').
│ │ │ │ -00020c00: 0a20 2020 2020 4f74 6865 7220 6f70 7469  .     Other opti
│ │ │ │ -00020c10: 6f6e 733a 0a20 2020 2020 2020 2d63 2c20  ons:.       -c, 
│ │ │ │ -00020c20: 2d2d 636f 6e66 6967 7572 6174 696f 6e2d  --configuration-
│ │ │ │ -00020c30: 6669 6c65 3d46 494c 4520 5573 6520 7370  file=FILE Use sp
│ │ │ │ -00020c40: 6563 6966 6965 6420 636f 6e66 6967 7572  ecified configur
│ │ │ │ -00020c50: 6174 696f 6e20 6669 6c65 2e0a 2020 2020  ation file..    
│ │ │ │ -00020c60: 2020 202d 762c 202d 2d76 6572 626f 7365     -v, --verbose
│ │ │ │ -00020c70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00020c80: 2050 726f 6475 6365 2076 6572 626f 7365   Produce verbose
│ │ │ │ -00020c90: 206f 7574 7075 742e 0a20 2020 2020 2020   output..       
│ │ │ │ +00020bf0: 2020 2028 6465 6661 756c 743d 6035 3027     (default=`50'
│ │ │ │ +00020c00: 290a 0a20 2020 2020 4f74 6865 7220 6f70  )..     Other op
│ │ │ │ +00020c10: 7469 6f6e 733a 0a20 2020 2020 2020 2d63  tions:.       -c
│ │ │ │ +00020c20: 2c20 2d2d 636f 6e66 6967 7572 6174 696f  , --configuratio
│ │ │ │ +00020c30: 6e2d 6669 6c65 3d46 494c 4520 5573 6520  n-file=FILE Use 
│ │ │ │ +00020c40: 7370 6563 6966 6965 6420 636f 6e66 6967  specified config
│ │ │ │ +00020c50: 7572 6174 696f 6e20 6669 6c65 2e0a 2020  uration file..  
│ │ │ │ +00020c60: 2020 2020 202d 762c 202d 2d76 6572 626f       -v, --verbo
│ │ │ │ +00020c70: 7365 2020 2020 2020 2020 2020 2020 2020  se              
│ │ │ │ +00020c80: 2020 2050 726f 6475 6365 2076 6572 626f     Produce verbo
│ │ │ │ +00020c90: 7365 206f 7574 7075 742e 0a20 2020 2020  se output..     
│ │ │ │  00020ca0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00020cb0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00020cc0: 5573 6520 6d75 6c74 6970 6c65 2074 696d  Use multiple tim
│ │ │ │ -00020cd0: 6573 2074 6f20 696e 6372 6561 7365 2061  es to increase a
│ │ │ │ -00020ce0: 6d6f 756e 7420 6f66 0a20 2020 2020 2020  mount of.       
│ │ │ │ +00020cc0: 2020 5573 6520 6d75 6c74 6970 6c65 2074    Use multiple t
│ │ │ │ +00020cd0: 696d 6573 2074 6f20 696e 6372 6561 7365  imes to increase
│ │ │ │ +00020ce0: 2061 6d6f 756e 7420 6f66 0a20 2020 2020   amount of.     
│ │ │ │  00020cf0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00020d00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00020d10: 696e 666f 726d 6174 696f 6e2e 0a20 2020  information..   
│ │ │ │ -00020d20: 2020 2020 2d71 2c20 2d2d 7175 6965 7420      -q, --quiet 
│ │ │ │ -00020d30: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00020d40: 2020 446f 6e27 7420 7072 6f64 7563 6520    Don't produce 
│ │ │ │ -00020d50: 616e 7920 6469 6167 6e6f 7374 6963 206f  any diagnostic o
│ │ │ │ -00020d60: 7574 7075 742e 0a20 2020 2020 2020 2020  utput..         
│ │ │ │ +00020d10: 2020 696e 666f 726d 6174 696f 6e2e 0a20    information.. 
│ │ │ │ +00020d20: 2020 2020 2020 2d71 2c20 2d2d 7175 6965        -q, --quie
│ │ │ │ +00020d30: 7420 2020 2020 2020 2020 2020 2020 2020  t               
│ │ │ │ +00020d40: 2020 2020 446f 6e27 7420 7072 6f64 7563      Don't produc
│ │ │ │ +00020d50: 6520 616e 7920 6469 6167 6e6f 7374 6963  e any diagnostic
│ │ │ │ +00020d60: 206f 7574 7075 742e 0a20 2020 2020 2020   output..       
│ │ │ │  00020d70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00020d80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00020d90: 2864 6566 6175 6c74 3d6f 6666 290a 0a1f  (default=off)...
│ │ │ │ -00020da0: 0a46 696c 653a 2073 6869 7368 692e 696e  .File: shishi.in
│ │ │ │ -00020db0: 666f 2c20 204e 6f64 653a 2050 6172 616d  fo,  Node: Param
│ │ │ │ -00020dc0: 6574 6572 7320 666f 7220 7368 6973 612c  eters for shisa,
│ │ │ │ -00020dd0: 2020 4e65 7874 3a20 456e 7669 726f 6e6d    Next: Environm
│ │ │ │ -00020de0: 656e 7420 7661 7269 6162 6c65 732c 2020  ent variables,  
│ │ │ │ -00020df0: 5072 6576 3a20 5061 7261 6d65 7465 7273  Prev: Parameters
│ │ │ │ -00020e00: 2066 6f72 2073 6869 7368 6964 2c20 2055   for shishid,  U
│ │ │ │ -00020e10: 703a 2052 6566 6572 656e 6365 204d 616e  p: Reference Man
│ │ │ │ -00020e20: 7561 6c0a 0a34 2e38 2050 6172 616d 6574  ual..4.8 Paramet
│ │ │ │ -00020e30: 6572 7320 666f 7220 7368 6973 610a 3d3d  ers for shisa.==
│ │ │ │ +00020d90: 2020 2864 6566 6175 6c74 3d6f 6666 290a    (default=off).
│ │ │ │ +00020da0: 0a1f 0a46 696c 653a 2073 6869 7368 692e  ...File: shishi.
│ │ │ │ +00020db0: 696e 666f 2c20 204e 6f64 653a 2050 6172  info,  Node: Par
│ │ │ │ +00020dc0: 616d 6574 6572 7320 666f 7220 7368 6973  ameters for shis
│ │ │ │ +00020dd0: 612c 2020 4e65 7874 3a20 456e 7669 726f  a,  Next: Enviro
│ │ │ │ +00020de0: 6e6d 656e 7420 7661 7269 6162 6c65 732c  nment variables,
│ │ │ │ +00020df0: 2020 5072 6576 3a20 5061 7261 6d65 7465    Prev: Paramete
│ │ │ │ +00020e00: 7273 2066 6f72 2073 6869 7368 6964 2c20  rs for shishid, 
│ │ │ │ +00020e10: 2055 703a 2052 6566 6572 656e 6365 204d   Up: Reference M
│ │ │ │ +00020e20: 616e 7561 6c0a 0a34 2e38 2050 6172 616d  anual..4.8 Param
│ │ │ │ +00020e30: 6574 6572 7320 666f 7220 7368 6973 610a  eters for shisa.
│ │ │ │  00020e40: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ -00020e50: 3d3d 3d3d 3d3d 0a0a 5468 6520 7075 7270  ======..The purp
│ │ │ │ -00020e60: 6f73 6520 6f66 20e2 8098 7368 6973 61e2  ose of ...shisa.
│ │ │ │ -00020e70: 8099 2069 7320 746f 206d 616e 6970 756c  .. is to manipul
│ │ │ │ -00020e80: 6174 6520 696e 666f 726d 6174 696f 6e20  ate information 
│ │ │ │ -00020e90: 7374 6f72 6564 2069 6e20 7468 650a 4b65  stored in the.Ke
│ │ │ │ -00020ea0: 7262 6572 6f73 2035 2064 6174 6162 6173  rberos 5 databas
│ │ │ │ -00020eb0: 6520 7573 6564 2062 7920 5368 6973 6869  e used by Shishi
│ │ │ │ -00020ec0: 2e0a 0a20 2020 4d61 6e64 6174 6f72 7920  ...   Mandatory 
│ │ │ │ -00020ed0: 6172 6775 6d65 6e74 7320 746f 206c 6f6e  arguments to lon
│ │ │ │ -00020ee0: 6720 6f70 7469 6f6e 7320 6172 6520 6d61  g options are ma
│ │ │ │ -00020ef0: 6e64 6174 6f72 7920 666f 7220 7368 6f72  ndatory for shor
│ │ │ │ -00020f00: 7420 6f70 7469 6f6e 730a 746f 6f2e 0a0a  t options.too...
│ │ │ │ -00020f10: 2020 2020 2055 7361 6765 3a20 7368 6973       Usage: shis
│ │ │ │ -00020f20: 6120 5b4f 5054 494f 4e53 5d2e 2e2e 205b  a [OPTIONS]... [
│ │ │ │ -00020f30: 5245 414c 4d20 5b50 5249 4e43 4950 414c  REALM [PRINCIPAL
│ │ │ │ -00020f40: 5d5d 2e2e 2e0a 0a20 2020 2020 2020 2d68  ]].....       -h
│ │ │ │ -00020f50: 2c20 2d2d 6865 6c70 2020 2020 2020 2020  , --help        
│ │ │ │ +00020e50: 3d3d 3d3d 3d3d 3d3d 0a0a 5468 6520 7075  ========..The pu
│ │ │ │ +00020e60: 7270 6f73 6520 6f66 20e2 8098 7368 6973  rpose of ...shis
│ │ │ │ +00020e70: 61e2 8099 2069 7320 746f 206d 616e 6970  a... is to manip
│ │ │ │ +00020e80: 756c 6174 6520 696e 666f 726d 6174 696f  ulate informatio
│ │ │ │ +00020e90: 6e20 7374 6f72 6564 2069 6e20 7468 650a  n stored in the.
│ │ │ │ +00020ea0: 4b65 7262 6572 6f73 2035 2064 6174 6162  Kerberos 5 datab
│ │ │ │ +00020eb0: 6173 6520 7573 6564 2062 7920 5368 6973  ase used by Shis
│ │ │ │ +00020ec0: 6869 2e0a 0a20 2020 4d61 6e64 6174 6f72  hi...   Mandator
│ │ │ │ +00020ed0: 7920 6172 6775 6d65 6e74 7320 746f 206c  y arguments to l
│ │ │ │ +00020ee0: 6f6e 6720 6f70 7469 6f6e 7320 6172 6520  ong options are 
│ │ │ │ +00020ef0: 6d61 6e64 6174 6f72 7920 666f 7220 7368  mandatory for sh
│ │ │ │ +00020f00: 6f72 7420 6f70 7469 6f6e 730a 746f 6f2e  ort options.too.
│ │ │ │ +00020f10: 0a0a 2020 2020 2055 7361 6765 3a20 7368  ..     Usage: sh
│ │ │ │ +00020f20: 6973 6120 5b4f 5054 494f 4e53 5d2e 2e2e  isa [OPTIONS]...
│ │ │ │ +00020f30: 205b 5245 414c 4d20 5b50 5249 4e43 4950   [REALM [PRINCIP
│ │ │ │ +00020f40: 414c 5d5d 2e2e 2e0a 0a20 2020 2020 2020  AL]].....       
│ │ │ │ +00020f50: 2d68 2c20 2d2d 6865 6c70 2020 2020 2020  -h, --help      
│ │ │ │  00020f60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00020f70: 2050 7269 6e74 2068 656c 7020 616e 6420   Print help and 
│ │ │ │ -00020f80: 6578 6974 0a20 2020 2020 2020 2d56 2c20  exit.       -V, 
│ │ │ │ -00020f90: 2d2d 7665 7273 696f 6e20 2020 2020 2020  --version       
│ │ │ │ -00020fa0: 2020 2020 2020 2020 2020 2020 2020 2050                 P
│ │ │ │ -00020fb0: 7269 6e74 2076 6572 7369 6f6e 2061 6e64  rint version and
│ │ │ │ -00020fc0: 2065 7869 740a 0a20 2020 2020 4f70 6572   exit..     Oper
│ │ │ │ -00020fd0: 6174 696f 6e73 3a0a 2020 2020 2020 202d  ations:.       -
│ │ │ │ -00020fe0: 612c 202d 2d61 6464 2020 2020 2020 2020  a, --add        
│ │ │ │ +00020f70: 2020 2050 7269 6e74 2068 656c 7020 616e     Print help an
│ │ │ │ +00020f80: 6420 6578 6974 0a20 2020 2020 2020 2d56  d exit.       -V
│ │ │ │ +00020f90: 2c20 2d2d 7665 7273 696f 6e20 2020 2020  , --version     
│ │ │ │ +00020fa0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +00020fb0: 2050 7269 6e74 2076 6572 7369 6f6e 2061   Print version a
│ │ │ │ +00020fc0: 6e64 2065 7869 740a 0a20 2020 2020 4f70  nd exit..     Op
│ │ │ │ +00020fd0: 6572 6174 696f 6e73 3a0a 2020 2020 2020  erations:.      
│ │ │ │ +00020fe0: 202d 612c 202d 2d61 6464 2020 2020 2020   -a, --add      
│ │ │ │  00020ff0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00021000: 2020 4164 6420 7265 616c 6d20 6f72 2070    Add realm or p
│ │ │ │ -00021010: 7269 6e63 6970 616c 2074 6f20 6461 7461  rincipal to data
│ │ │ │ -00021020: 6261 7365 2e0a 2020 2020 2020 202d 642c  base..       -d,
│ │ │ │ -00021030: 202d 2d64 756d 7020 2020 2020 2020 2020   --dump         
│ │ │ │ +00021000: 2020 2020 4164 6420 7265 616c 6d20 6f72      Add realm or
│ │ │ │ +00021010: 2070 7269 6e63 6970 616c 2074 6f20 6461   principal to da
│ │ │ │ +00021020: 7461 6261 7365 2e0a 2020 2020 2020 202d  tabase..       -
│ │ │ │ +00021030: 642c 202d 2d64 756d 7020 2020 2020 2020  d, --dump       
│ │ │ │  00021040: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00021050: 4475 6d70 2065 6e74 7269 6573 2069 6e20  Dump entries in 
│ │ │ │ -00021060: 6461 7461 6261 7365 2e0a 2020 2020 2020  database..      
│ │ │ │ -00021070: 202d 6e2c 202d 2d6b 6579 2d61 6464 2020   -n, --key-add  
│ │ │ │ +00021050: 2020 4475 6d70 2065 6e74 7269 6573 2069    Dump entries i
│ │ │ │ +00021060: 6e20 6461 7461 6261 7365 2e0a 2020 2020  n database..    
│ │ │ │ +00021070: 2020 202d 6e2c 202d 2d6b 6579 2d61 6464     -n, --key-add
│ │ │ │  00021080: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00021090: 2020 2020 4164 6420 6e65 7720 6b65 7920      Add new key 
│ │ │ │ -000210a0: 746f 2061 2070 7269 6e63 6970 616c 2069  to a principal i
│ │ │ │ -000210b0: 6e20 6461 7461 6261 7365 2e0a 2020 2020  n database..    
│ │ │ │ -000210c0: 2020 2020 2020 202d 2d6b 6579 2d72 656d         --key-rem
│ │ │ │ -000210d0: 6f76 6520 2020 2020 2020 2020 2020 2020  ove             
│ │ │ │ -000210e0: 2020 2020 2020 5265 6d6f 7665 2061 206b        Remove a k
│ │ │ │ -000210f0: 6579 2066 726f 6d20 6120 7072 696e 6369  ey from a princi
│ │ │ │ -00021100: 7061 6c20 696e 0a20 2020 2020 2020 2020  pal in.         
│ │ │ │ +00021090: 2020 2020 2020 4164 6420 6e65 7720 6b65        Add new ke
│ │ │ │ +000210a0: 7920 746f 2061 2070 7269 6e63 6970 616c  y to a principal
│ │ │ │ +000210b0: 2069 6e20 6461 7461 6261 7365 2e0a 2020   in database..  
│ │ │ │ +000210c0: 2020 2020 2020 2020 202d 2d6b 6579 2d72           --key-r
│ │ │ │ +000210d0: 656d 6f76 6520 2020 2020 2020 2020 2020  emove           
│ │ │ │ +000210e0: 2020 2020 2020 2020 5265 6d6f 7665 2061          Remove a
│ │ │ │ +000210f0: 206b 6579 2066 726f 6d20 6120 7072 696e   key from a prin
│ │ │ │ +00021100: 6369 7061 6c20 696e 0a20 2020 2020 2020  cipal in.       
│ │ │ │  00021110: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00021120: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00021130: 2020 2064 6174 6162 6173 652e 0a20 2020     database..   
│ │ │ │ -00021140: 2020 2020 2d6c 2c20 2d2d 6c69 7374 2020      -l, --list  
│ │ │ │ +00021130: 2020 2020 2064 6174 6162 6173 652e 0a20       database.. 
│ │ │ │ +00021140: 2020 2020 2020 2d6c 2c20 2d2d 6c69 7374        -l, --list
│ │ │ │  00021150: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00021160: 2020 2020 2020 204c 6973 7420 656e 7472         List entr
│ │ │ │ -00021170: 6965 7320 696e 2064 6174 6162 6173 652e  ies in database.
│ │ │ │ -00021180: 0a20 2020 2020 2020 2d6d 2c20 2d2d 6d6f  .       -m, --mo
│ │ │ │ -00021190: 6469 6679 2020 2020 2020 2020 2020 2020  dify            
│ │ │ │ -000211a0: 2020 2020 2020 2020 2020 204d 6f64 6966             Modif
│ │ │ │ -000211b0: 7920 7072 696e 6369 7061 6c20 656e 7472  y principal entr
│ │ │ │ -000211c0: 7920 696e 2064 6174 6162 6173 652e 0a20  y in database.. 
│ │ │ │ -000211d0: 2020 2020 2020 2d72 2c20 2d2d 7265 6d6f        -r, --remo
│ │ │ │ -000211e0: 7665 2020 2020 2020 2020 2020 2020 2020  ve              
│ │ │ │ -000211f0: 2020 2020 2020 2020 2052 656d 6f76 6520           Remove 
│ │ │ │ -00021200: 7265 616c 6d20 6f72 2070 7269 6e63 6970  realm or princip
│ │ │ │ -00021210: 616c 2066 726f 6d20 6461 7461 6261 7365  al from database
│ │ │ │ -00021220: 2e0a 0a20 2020 2020 5061 7261 6d65 7465  ...     Paramete
│ │ │ │ -00021230: 7273 3a0a 2020 2020 2020 202d 662c 202d  rs:.       -f, -
│ │ │ │ -00021240: 2d66 6f72 6365 2020 2020 2020 2020 2020  -force          
│ │ │ │ -00021250: 2020 2020 2020 2020 2020 2020 2020 416c                Al
│ │ │ │ -00021260: 6c6f 7720 7265 6d6f 7661 6c20 6f66 206e  low removal of n
│ │ │ │ -00021270: 6f6e 2d65 6d70 7479 2072 6561 6c6d 732e  on-empty realms.
│ │ │ │ -00021280: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ +00021160: 2020 2020 2020 2020 204c 6973 7420 656e           List en
│ │ │ │ +00021170: 7472 6965 7320 696e 2064 6174 6162 6173  tries in databas
│ │ │ │ +00021180: 652e 0a20 2020 2020 2020 2d6d 2c20 2d2d  e..       -m, --
│ │ │ │ +00021190: 6d6f 6469 6679 2020 2020 2020 2020 2020  modify          
│ │ │ │ +000211a0: 2020 2020 2020 2020 2020 2020 204d 6f64               Mod
│ │ │ │ +000211b0: 6966 7920 7072 696e 6369 7061 6c20 656e  ify principal en
│ │ │ │ +000211c0: 7472 7920 696e 2064 6174 6162 6173 652e  try in database.
│ │ │ │ +000211d0: 0a20 2020 2020 2020 2d72 2c20 2d2d 7265  .       -r, --re
│ │ │ │ +000211e0: 6d6f 7665 2020 2020 2020 2020 2020 2020  move            
│ │ │ │ +000211f0: 2020 2020 2020 2020 2020 2052 656d 6f76             Remov
│ │ │ │ +00021200: 6520 7265 616c 6d20 6f72 2070 7269 6e63  e realm or princ
│ │ │ │ +00021210: 6970 616c 2066 726f 6d20 6461 7461 6261  ipal from databa
│ │ │ │ +00021220: 7365 2e0a 0a20 2020 2020 5061 7261 6d65  se...     Parame
│ │ │ │ +00021230: 7465 7273 3a0a 2020 2020 2020 202d 662c  ters:.       -f,
│ │ │ │ +00021240: 202d 2d66 6f72 6365 2020 2020 2020 2020   --force        
│ │ │ │ +00021250: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +00021260: 416c 6c6f 7720 7265 6d6f 7661 6c20 6f66  Allow removal of
│ │ │ │ +00021270: 206e 6f6e 2d65 6d70 7479 2072 6561 6c6d   non-empty realm
│ │ │ │ +00021280: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │  00021290: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000212a0: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ -000212b0: 6465 6661 756c 743d 6f66 6629 0a20 2020  default=off).   
│ │ │ │ -000212c0: 2020 2020 2020 2020 2d2d 656e 6162 6c65          --enable
│ │ │ │ -000212d0: 6420 2020 2020 2020 2020 2020 2020 2020  d               
│ │ │ │ -000212e0: 2020 2020 2020 204f 6e6c 7920 6475 6d70         Only dump
│ │ │ │ -000212f0: 206f 7220 6c69 7374 2065 6e61 626c 6564   or list enabled
│ │ │ │ -00021300: 2070 7269 6e63 6970 616c 732e 0a20 2020   principals..   
│ │ │ │ +000212a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +000212b0: 2028 6465 6661 756c 743d 6f66 6629 0a20   (default=off). 
│ │ │ │ +000212c0: 2020 2020 2020 2020 2020 2d2d 656e 6162            --enab
│ │ │ │ +000212d0: 6c65 6420 2020 2020 2020 2020 2020 2020  led             
│ │ │ │ +000212e0: 2020 2020 2020 2020 204f 6e6c 7920 6475           Only du
│ │ │ │ +000212f0: 6d70 206f 7220 6c69 7374 2065 6e61 626c  mp or list enabl
│ │ │ │ +00021300: 6564 2070 7269 6e63 6970 616c 732e 0a20  ed principals.. 
│ │ │ │  00021310: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00021320: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00021330: 2020 2020 2020 2020 2020 2028 6465 6661             (defa
│ │ │ │ -00021340: 756c 743d 6f66 6629 0a20 2020 2020 2020  ult=off).       
│ │ │ │ -00021350: 2020 2020 2d2d 6469 7361 626c 6564 2020      --disabled  
│ │ │ │ +00021330: 2020 2020 2020 2020 2020 2020 2028 6465               (de
│ │ │ │ +00021340: 6661 756c 743d 6f66 6629 0a20 2020 2020  fault=off).     
│ │ │ │ +00021350: 2020 2020 2020 2d2d 6469 7361 626c 6564        --disabled
│ │ │ │  00021360: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00021370: 2020 204f 6e6c 7920 6475 6d70 206f 7220     Only dump or 
│ │ │ │ -00021380: 6c69 7374 2064 6973 6162 6c65 6420 7072  list disabled pr
│ │ │ │ -00021390: 696e 6369 7061 6c73 2e0a 2020 2020 2020  incipals..      
│ │ │ │ +00021370: 2020 2020 204f 6e6c 7920 6475 6d70 206f       Only dump o
│ │ │ │ +00021380: 7220 6c69 7374 2064 6973 6162 6c65 6420  r list disabled 
│ │ │ │ +00021390: 7072 696e 6369 7061 6c73 2e0a 2020 2020  principals..    
│ │ │ │  000213a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000213b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000213c0: 2020 2020 2020 2020 2864 6566 6175 6c74          (default
│ │ │ │ -000213d0: 3d6f 6666 290a 2020 2020 2020 2020 2020  =off).          
│ │ │ │ -000213e0: 202d 2d6b 6579 7320 2020 2020 2020 2020   --keys         
│ │ │ │ +000213c0: 2020 2020 2020 2020 2020 2864 6566 6175            (defau
│ │ │ │ +000213d0: 6c74 3d6f 6666 290a 2020 2020 2020 2020  lt=off).        
│ │ │ │ +000213e0: 2020 202d 2d6b 6579 7320 2020 2020 2020     --keys       
│ │ │ │  000213f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00021400: 5072 696e 7420 6372 7970 746f 6772 6170  Print cryptograp
│ │ │ │ -00021410: 6869 6320 6b65 7920 616e 6420 7061 7373  hic key and pass
│ │ │ │ -00021420: 776f 7264 2069 6e0a 2020 2020 2020 2020  word in.        
│ │ │ │ +00021400: 2020 5072 696e 7420 6372 7970 746f 6772    Print cryptogr
│ │ │ │ +00021410: 6170 6869 6320 6b65 7920 616e 6420 7061  aphic key and pa
│ │ │ │ +00021420: 7373 776f 7264 2069 6e0a 2020 2020 2020  ssword in.      
│ │ │ │  00021430: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00021440: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00021450: 2020 2020 686f 7374 6b65 7920 666f 726d      hostkey form
│ │ │ │ -00021460: 6174 2e20 2028 6465 6661 756c 743d 6f66  at.  (default=of
│ │ │ │ -00021470: 6629 0a0a 2020 2020 2056 616c 7565 733a  f)..     Values:
│ │ │ │ -00021480: 0a20 2020 2020 2020 2d45 2c20 2d2d 656e  .       -E, --en
│ │ │ │ -00021490: 6372 7970 7469 6f6e 2d74 7970 653d 5354  cryption-type=ST
│ │ │ │ -000214a0: 5249 4e47 2020 2020 2020 204f 7665 7272  RING       Overr
│ │ │ │ -000214b0: 6964 6520 6465 6661 756c 7420 6b65 7920  ide default key 
│ │ │ │ -000214c0: 656e 6372 7970 7469 6f6e 2074 7970 652e  encryption type.
│ │ │ │ -000214d0: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ +00021450: 2020 2020 2020 686f 7374 6b65 7920 666f        hostkey fo
│ │ │ │ +00021460: 726d 6174 2e20 2028 6465 6661 756c 743d  rmat.  (default=
│ │ │ │ +00021470: 6f66 6629 0a0a 2020 2020 2056 616c 7565  off)..     Value
│ │ │ │ +00021480: 733a 0a20 2020 2020 2020 2d45 2c20 2d2d  s:.       -E, --
│ │ │ │ +00021490: 656e 6372 7970 7469 6f6e 2d74 7970 653d  encryption-type=
│ │ │ │ +000214a0: 5354 5249 4e47 2020 2020 2020 204f 7665  STRING       Ove
│ │ │ │ +000214b0: 7272 6964 6520 6465 6661 756c 7420 6b65  rride default ke
│ │ │ │ +000214c0: 7920 656e 6372 7970 7469 6f6e 2074 7970  y encryption typ
│ │ │ │ +000214d0: 652e 0a20 2020 2020 2020 2020 2020 2020  e..             
│ │ │ │  000214e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000214f0: 2020 2020 2020 2020 2020 2020 2056 616c               Val
│ │ │ │ -00021500: 6964 2076 616c 7565 7320 696e 636c 7564  id values includ
│ │ │ │ -00021510: 6520 2761 6573 3132 3827 2c0a 2020 2020  e 'aes128',.    
│ │ │ │ +000214f0: 2020 2020 2020 2020 2020 2020 2020 2056                 V
│ │ │ │ +00021500: 616c 6964 2076 616c 7565 7320 696e 636c  alid values incl
│ │ │ │ +00021510: 7564 6520 2761 6573 3132 3827 2c0a 2020  ude 'aes128',.  
│ │ │ │  00021520: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00021530: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00021540: 2020 2020 2020 2020 2761 6573 3235 3627          'aes256'
│ │ │ │ -00021550: 2c20 2761 6573 2720 2873 616d 6520 6173  , 'aes' (same as
│ │ │ │ -00021560: 2027 6165 7332 3536 2729 2c0a 2020 2020   'aes256'),.    
│ │ │ │ +00021540: 2020 2020 2020 2020 2020 2761 6573 3235            'aes25
│ │ │ │ +00021550: 3627 2c20 2761 6573 2720 2873 616d 6520  6', 'aes' (same 
│ │ │ │ +00021560: 6173 2027 6165 7332 3536 2729 2c0a 2020  as 'aes256'),.  
│ │ │ │  00021570: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00021580: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00021590: 2020 2020 2020 2020 2733 6465 7327 2c20          '3des', 
│ │ │ │ -000215a0: 2764 6573 2d6d 6435 272c 2027 6465 732d  'des-md5', 'des-
│ │ │ │ -000215b0: 6d64 3427 2c0a 2020 2020 2020 2020 2020  md4',.          
│ │ │ │ +00021590: 2020 2020 2020 2020 2020 2733 6465 7327            '3des'
│ │ │ │ +000215a0: 2c20 2764 6573 2d6d 6435 272c 2027 6465  , 'des-md5', 'de
│ │ │ │ +000215b0: 732d 6d64 3427 2c0a 2020 2020 2020 2020  s-md4',.        
│ │ │ │  000215c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000215d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000215e0: 2020 2764 6573 2d63 7263 272c 2027 6465    'des-crc', 'de
│ │ │ │ -000215f0: 7327 2028 7361 6d65 2061 7320 2764 6573  s' (same as 'des
│ │ │ │ -00021600: 2d6d 6435 2729 2c0a 2020 2020 2020 2020  -md5'),.        
│ │ │ │ +000215e0: 2020 2020 2764 6573 2d63 7263 272c 2027      'des-crc', '
│ │ │ │ +000215f0: 6465 7327 2028 7361 6d65 2061 7320 2764  des' (same as 'd
│ │ │ │ +00021600: 6573 2d6d 6435 2729 2c0a 2020 2020 2020  es-md5'),.      
│ │ │ │  00021610: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00021620: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00021630: 2020 2020 616e 6420 2761 7263 666f 7572      and 'arcfour
│ │ │ │ -00021640: 272e 0a20 2020 2020 2020 2020 2020 2d2d  '..           --
│ │ │ │ -00021650: 6b65 792d 7665 7273 696f 6e3d 4e55 4d42  key-version=NUMB
│ │ │ │ -00021660: 4552 2020 2020 2020 2020 2020 2056 6572  ER           Ver
│ │ │ │ -00021670: 7369 6f6e 206f 6620 6b65 792e 0a20 2020  sion of key..   
│ │ │ │ -00021680: 2020 2020 2020 2020 2d2d 7061 7373 776f          --passwo
│ │ │ │ -00021690: 7264 5b3d 5354 5249 4e47 5d20 2020 2020  rd[=STRING]     
│ │ │ │ -000216a0: 2020 2020 2020 2044 6572 6976 6520 6b65         Derive ke
│ │ │ │ -000216b0: 7920 6672 6f6d 2074 6869 7320 7061 7373  y from this pass
│ │ │ │ -000216c0: 776f 7264 2e0a 2020 2020 2020 2020 2020  word..          
│ │ │ │ -000216d0: 202d 2d72 616e 646f 6d20 2020 2020 2020   --random       
│ │ │ │ +00021630: 2020 2020 2020 616e 6420 2761 7263 666f        and 'arcfo
│ │ │ │ +00021640: 7572 272e 0a20 2020 2020 2020 2020 2020  ur'..           
│ │ │ │ +00021650: 2d2d 6b65 792d 7665 7273 696f 6e3d 4e55  --key-version=NU
│ │ │ │ +00021660: 4d42 4552 2020 2020 2020 2020 2020 2056  MBER           V
│ │ │ │ +00021670: 6572 7369 6f6e 206f 6620 6b65 792e 0a20  ersion of key.. 
│ │ │ │ +00021680: 2020 2020 2020 2020 2020 2d2d 7061 7373            --pass
│ │ │ │ +00021690: 776f 7264 5b3d 5354 5249 4e47 5d20 2020  word[=STRING]   
│ │ │ │ +000216a0: 2020 2020 2020 2020 2044 6572 6976 6520           Derive 
│ │ │ │ +000216b0: 6b65 7920 6672 6f6d 2074 6869 7320 7061  key from this pa
│ │ │ │ +000216c0: 7373 776f 7264 2e0a 2020 2020 2020 2020  ssword..        
│ │ │ │ +000216d0: 2020 202d 2d72 616e 646f 6d20 2020 2020     --random     
│ │ │ │  000216e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000216f0: 5573 6520 6120 7261 6e64 6f6d 206b 6579  Use a random key
│ │ │ │ -00021700: 2e20 2028 6465 6661 756c 7429 0a20 2020  .  (default).   
│ │ │ │ -00021710: 2020 2020 2020 2020 2d2d 7361 6c74 3d53          --salt=S
│ │ │ │ -00021720: 5452 494e 4720 2020 2020 2020 2020 2020  TRING           
│ │ │ │ -00021730: 2020 2020 2020 2055 7365 2073 7065 6369         Use speci
│ │ │ │ -00021740: 6669 6564 2073 616c 7420 666f 7220 6465  fied salt for de
│ │ │ │ -00021750: 7269 7669 6e67 206b 6579 2e0a 2020 2020  riving key..    
│ │ │ │ +000216f0: 2020 5573 6520 6120 7261 6e64 6f6d 206b    Use a random k
│ │ │ │ +00021700: 6579 2e20 2028 6465 6661 756c 7429 0a20  ey.  (default). 
│ │ │ │ +00021710: 2020 2020 2020 2020 2020 2d2d 7361 6c74            --salt
│ │ │ │ +00021720: 3d53 5452 494e 4720 2020 2020 2020 2020  =STRING         
│ │ │ │ +00021730: 2020 2020 2020 2020 2055 7365 2073 7065           Use spe
│ │ │ │ +00021740: 6369 6669 6564 2073 616c 7420 666f 7220  cified salt for 
│ │ │ │ +00021750: 6465 7269 7669 6e67 206b 6579 2e0a 2020  deriving key..  
│ │ │ │  00021760: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00021770: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00021780: 2020 2020 2020 2020 4465 6661 756c 7473          Defaults
│ │ │ │ -00021790: 2074 6f20 636f 6e63 6174 656e 6174 696f   to concatenatio
│ │ │ │ -000217a0: 6e20 6f66 2072 6561 6c6d 2061 6e64 0a20  n of realm and. 
│ │ │ │ -000217b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +00021780: 2020 2020 2020 2020 2020 4465 6661 756c            Defaul
│ │ │ │ +00021790: 7473 2074 6f20 636f 6e63 6174 656e 6174  ts to concatenat
│ │ │ │ +000217a0: 696f 6e20 6f66 2072 6561 6c6d 2061 6e64  ion of realm and
│ │ │ │ +000217b0: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │  000217c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000217d0: 2020 2020 2020 2020 2020 2028 756e 7772             (unwr
│ │ │ │ -000217e0: 6170 7065 6429 2070 7269 6e63 6970 616c  apped) principal
│ │ │ │ -000217f0: 206e 616d 652e 0a20 2020 2020 2020 2020   name..         
│ │ │ │ -00021800: 2020 2d2d 7374 7269 6e67 2d74 6f2d 6b65    --string-to-ke
│ │ │ │ -00021810: 792d 7061 7261 6d65 7465 723d 4845 5820  y-parameter=HEX 
│ │ │ │ -00021820: 2045 6e63 7279 7074 696f 6e20 616c 676f   Encryption algo
│ │ │ │ -00021830: 7269 7468 6d20 7370 6563 6966 6963 2070  rithm specific p
│ │ │ │ -00021840: 6172 616d 6574 6572 0a20 2020 2020 2020  arameter.       
│ │ │ │ +000217d0: 2020 2020 2020 2020 2020 2020 2028 756e               (un
│ │ │ │ +000217e0: 7772 6170 7065 6429 2070 7269 6e63 6970  wrapped) princip
│ │ │ │ +000217f0: 616c 206e 616d 652e 0a20 2020 2020 2020  al name..       
│ │ │ │ +00021800: 2020 2020 2d2d 7374 7269 6e67 2d74 6f2d      --string-to-
│ │ │ │ +00021810: 6b65 792d 7061 7261 6d65 7465 723d 4845  key-parameter=HE
│ │ │ │ +00021820: 5820 2045 6e63 7279 7074 696f 6e20 616c  X  Encryption al
│ │ │ │ +00021830: 676f 7269 7468 6d20 7370 6563 6966 6963  gorithm specific
│ │ │ │ +00021840: 2070 6172 616d 6574 6572 0a20 2020 2020   parameter.     
│ │ │ │  00021850: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00021860: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00021870: 2020 2020 2066 6f72 2070 6173 7377 6f72       for passwor
│ │ │ │ -00021880: 6420 6465 7269 7661 7469 6f6e 2e20 2043  d derivation.  C
│ │ │ │ -00021890: 7572 7265 6e74 6c79 0a20 2020 2020 2020  urrently.       
│ │ │ │ +00021870: 2020 2020 2020 2066 6f72 2070 6173 7377         for passw
│ │ │ │ +00021880: 6f72 6420 6465 7269 7661 7469 6f6e 2e20  ord derivation. 
│ │ │ │ +00021890: 2043 7572 7265 6e74 6c79 0a20 2020 2020   Currently.     
│ │ │ │  000218a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000218b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000218c0: 2020 2020 206f 6e6c 7920 7468 6520 4145       only the AE
│ │ │ │ -000218d0: 5320 616c 676f 7269 7468 6d20 6361 6e20  S algorithm can 
│ │ │ │ -000218e0: 7574 696c 697a 650a 2020 2020 2020 2020  utilize.        
│ │ │ │ +000218c0: 2020 2020 2020 206f 6e6c 7920 7468 6520         only the 
│ │ │ │ +000218d0: 4145 5320 616c 676f 7269 7468 6d20 6361  AES algorithm ca
│ │ │ │ +000218e0: 6e20 7574 696c 697a 650a 2020 2020 2020  n utilize.      
│ │ │ │  000218f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00021900: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00021910: 2020 2020 7468 6973 2c20 7768 6572 6520      this, where 
│ │ │ │ -00021920: 6974 2069 7320 696e 7465 7270 7265 7465  it is interprete
│ │ │ │ -00021930: 6420 6173 2074 6865 0a20 2020 2020 2020  d as the.       
│ │ │ │ +00021910: 2020 2020 2020 7468 6973 2c20 7768 6572        this, wher
│ │ │ │ +00021920: 6520 6974 2069 7320 696e 7465 7270 7265  e it is interpre
│ │ │ │ +00021930: 7465 6420 6173 2074 6865 0a20 2020 2020  ted as the.     
│ │ │ │  00021940: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00021950: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00021960: 2020 2020 2069 7465 7261 7469 6f6e 2063       iteration c
│ │ │ │ -00021970: 6f75 6e74 206f 6620 7468 6520 504b 4353  ount of the PKCS
│ │ │ │ -00021980: 2335 2050 424b 4446 320a 2020 2020 2020  #5 PBKDF2.      
│ │ │ │ +00021960: 2020 2020 2020 2069 7465 7261 7469 6f6e         iteration
│ │ │ │ +00021970: 2063 6f75 6e74 206f 6620 7468 6520 504b   count of the PK
│ │ │ │ +00021980: 4353 2335 2050 424b 4446 320a 2020 2020  CS#5 PBKDF2.    
│ │ │ │  00021990: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000219a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000219b0: 2020 2020 2020 6b65 7920 6465 7269 7665        key derive
│ │ │ │ -000219c0: 722e 0a0a 2020 2020 204f 7468 6572 206f  r...     Other o
│ │ │ │ -000219d0: 7074 696f 6e73 3a0a 2020 2020 2020 202d  ptions:.       -
│ │ │ │ -000219e0: 632c 202d 2d63 6f6e 6669 6775 7261 7469  c, --configurati
│ │ │ │ -000219f0: 6f6e 2d66 696c 653d 4649 4c45 2020 2020  on-file=FILE    
│ │ │ │ -00021a00: 2020 5573 6520 7370 6563 6966 6965 6420    Use specified 
│ │ │ │ -00021a10: 636f 6e66 6967 7572 6174 696f 6e20 6669  configuration fi
│ │ │ │ -00021a20: 6c65 2e0a 2020 2020 2020 202d 6f2c 202d  le..       -o, -
│ │ │ │ -00021a30: 2d6c 6962 7261 7279 2d6f 7074 696f 6e73  -library-options
│ │ │ │ -00021a40: 3d53 5452 494e 4720 2020 2020 2020 5061  =STRING       Pa
│ │ │ │ -00021a50: 7273 6520 7374 7269 6e67 2061 7320 636f  rse string as co
│ │ │ │ -00021a60: 6e66 6967 7572 6174 696f 6e20 6669 6c65  nfiguration file
│ │ │ │ -00021a70: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ +000219b0: 2020 2020 2020 2020 6b65 7920 6465 7269          key deri
│ │ │ │ +000219c0: 7665 722e 0a0a 2020 2020 204f 7468 6572  ver...     Other
│ │ │ │ +000219d0: 206f 7074 696f 6e73 3a0a 2020 2020 2020   options:.      
│ │ │ │ +000219e0: 202d 632c 202d 2d63 6f6e 6669 6775 7261   -c, --configura
│ │ │ │ +000219f0: 7469 6f6e 2d66 696c 653d 4649 4c45 2020  tion-file=FILE  
│ │ │ │ +00021a00: 2020 2020 5573 6520 7370 6563 6966 6965      Use specifie
│ │ │ │ +00021a10: 6420 636f 6e66 6967 7572 6174 696f 6e20  d configuration 
│ │ │ │ +00021a20: 6669 6c65 2e0a 2020 2020 2020 202d 6f2c  file..       -o,
│ │ │ │ +00021a30: 202d 2d6c 6962 7261 7279 2d6f 7074 696f   --library-optio
│ │ │ │ +00021a40: 6e73 3d53 5452 494e 4720 2020 2020 2020  ns=STRING       
│ │ │ │ +00021a50: 5061 7273 6520 7374 7269 6e67 2061 7320  Parse string as 
│ │ │ │ +00021a60: 636f 6e66 6967 7572 6174 696f 6e20 6669  configuration fi
│ │ │ │ +00021a70: 6c65 0a20 2020 2020 2020 2020 2020 2020  le.             
│ │ │ │  00021a80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00021a90: 2020 2020 2020 2020 2020 2020 2073 7461               sta
│ │ │ │ -00021aa0: 7465 6d65 6e74 2e0a 2020 2020 2020 202d  tement..       -
│ │ │ │ -00021ab0: 762c 202d 2d76 6572 626f 7365 2020 2020  v, --verbose    
│ │ │ │ +00021a90: 2020 2020 2020 2020 2020 2020 2020 2073                 s
│ │ │ │ +00021aa0: 7461 7465 6d65 6e74 2e0a 2020 2020 2020  tatement..      
│ │ │ │ +00021ab0: 202d 762c 202d 2d76 6572 626f 7365 2020   -v, --verbose  
│ │ │ │  00021ac0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00021ad0: 2020 5072 6f64 7563 6520 7665 7262 6f73    Produce verbos
│ │ │ │ -00021ae0: 6520 6f75 7470 7574 2e0a 2020 2020 2020  e output..      
│ │ │ │ +00021ad0: 2020 2020 5072 6f64 7563 6520 7665 7262      Produce verb
│ │ │ │ +00021ae0: 6f73 6520 6f75 7470 7574 2e0a 2020 2020  ose output..    
│ │ │ │  00021af0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00021b00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00021b10: 2020 2020 2020 2020 2864 6566 6175 6c74          (default
│ │ │ │ -00021b20: 3d6f 6666 290a 2020 2020 2020 202d 712c  =off).       -q,
│ │ │ │ -00021b30: 202d 2d71 7569 6574 2020 2020 2020 2020   --quiet        
│ │ │ │ +00021b10: 2020 2020 2020 2020 2020 2864 6566 6175            (defau
│ │ │ │ +00021b20: 6c74 3d6f 6666 290a 2020 2020 2020 202d  lt=off).       -
│ │ │ │ +00021b30: 712c 202d 2d71 7569 6574 2020 2020 2020  q, --quiet      
│ │ │ │  00021b40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00021b50: 446f 6e27 7420 7072 6f64 7563 6520 616e  Don't produce an
│ │ │ │ -00021b60: 7920 6469 6167 6e6f 7374 6963 206f 7574  y diagnostic out
│ │ │ │ -00021b70: 7075 742e 0a20 2020 2020 2020 2020 2020  put..           
│ │ │ │ +00021b50: 2020 446f 6e27 7420 7072 6f64 7563 6520    Don't produce 
│ │ │ │ +00021b60: 616e 7920 6469 6167 6e6f 7374 6963 206f  any diagnostic o
│ │ │ │ +00021b70: 7574 7075 742e 0a20 2020 2020 2020 2020  utput..         
│ │ │ │  00021b80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00021b90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00021ba0: 2020 2028 6465 6661 756c 743d 6f66 6629     (default=off)
│ │ │ │ -00021bb0: 0a0a 1f0a 4669 6c65 3a20 7368 6973 6869  ....File: shishi
│ │ │ │ -00021bc0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 456e  .info,  Node: En
│ │ │ │ -00021bd0: 7669 726f 6e6d 656e 7420 7661 7269 6162  vironment variab
│ │ │ │ -00021be0: 6c65 732c 2020 4e65 7874 3a20 4461 7465  les,  Next: Date
│ │ │ │ -00021bf0: 2069 6e70 7574 2066 6f72 6d61 7473 2c20   input formats, 
│ │ │ │ -00021c00: 2050 7265 763a 2050 6172 616d 6574 6572   Prev: Parameter
│ │ │ │ -00021c10: 7320 666f 7220 7368 6973 612c 2020 5570  s for shisa,  Up
│ │ │ │ -00021c20: 3a20 5265 6665 7265 6e63 6520 4d61 6e75  : Reference Manu
│ │ │ │ -00021c30: 616c 0a0a 342e 3920 456e 7669 726f 6e6d  al..4.9 Environm
│ │ │ │ -00021c40: 656e 7420 7661 7269 6162 6c65 730a 3d3d  ent variables.==
│ │ │ │ +00021ba0: 2020 2020 2028 6465 6661 756c 743d 6f66       (default=of
│ │ │ │ +00021bb0: 6629 0a0a 1f0a 4669 6c65 3a20 7368 6973  f)....File: shis
│ │ │ │ +00021bc0: 6869 2e69 6e66 6f2c 2020 4e6f 6465 3a20  hi.info,  Node: 
│ │ │ │ +00021bd0: 456e 7669 726f 6e6d 656e 7420 7661 7269  Environment vari
│ │ │ │ +00021be0: 6162 6c65 732c 2020 4e65 7874 3a20 4461  ables,  Next: Da
│ │ │ │ +00021bf0: 7465 2069 6e70 7574 2066 6f72 6d61 7473  te input formats
│ │ │ │ +00021c00: 2c20 2050 7265 763a 2050 6172 616d 6574  ,  Prev: Paramet
│ │ │ │ +00021c10: 6572 7320 666f 7220 7368 6973 612c 2020  ers for shisa,  
│ │ │ │ +00021c20: 5570 3a20 5265 6665 7265 6e63 6520 4d61  Up: Reference Ma
│ │ │ │ +00021c30: 6e75 616c 0a0a 342e 3920 456e 7669 726f  nual..4.9 Enviro
│ │ │ │ +00021c40: 6e6d 656e 7420 7661 7269 6162 6c65 730a  nment variables.
│ │ │ │  00021c50: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ -00021c60: 3d3d 3d3d 3d3d 3d0a 0a41 2066 6577 206f  =======..A few o
│ │ │ │ -00021c70: 6620 7468 6520 636f 6d70 696c 652d 7469  f the compile-ti
│ │ │ │ -00021c80: 6d65 2064 6566 6175 6c74 7320 6d61 7920  me defaults may 
│ │ │ │ -00021c90: 6265 206f 7665 7272 6964 6465 6e20 6174  be overridden at
│ │ │ │ -00021ca0: 2072 756e 2d74 696d 6520 6279 0a75 7369   run-time by.usi
│ │ │ │ -00021cb0: 6e67 2065 6e76 6972 6f6e 6d65 6e74 2076  ng environment v
│ │ │ │ -00021cc0: 6172 6961 626c 6573 2e20 2054 6865 2066  ariables.  The f
│ │ │ │ -00021cd0: 6f6c 6c6f 7769 6e67 2076 6172 6961 626c  ollowing variabl
│ │ │ │ -00021ce0: 6573 2061 7265 2073 7570 706f 7274 6564  es are supported
│ │ │ │ -00021cf0: 2e0a 0a20 2020 e280 a220 e280 9853 4849  ...   ... ...SHI
│ │ │ │ -00021d00: 5348 495f 434f 4e46 4947 e280 9920 5370  SHI_CONFIG... Sp
│ │ │ │ -00021d10: 6563 6966 7920 7468 6520 6c6f 6361 7469  ecify the locati
│ │ │ │ -00021d20: 6f6e 206f 6620 7468 6520 6465 6661 756c  on of the defaul
│ │ │ │ -00021d30: 7420 7379 7374 656d 0a20 2020 2020 636f  t system.     co
│ │ │ │ -00021d40: 6e66 6967 7572 6174 696f 6e20 6669 6c65  nfiguration file
│ │ │ │ -00021d50: 2e20 2055 7365 6420 6279 2074 6865 2053  .  Used by the S
│ │ │ │ -00021d60: 6869 7368 6920 6c69 6272 6172 792e 2020  hishi library.  
│ │ │ │ -00021d70: 4966 206e 6f74 2073 7065 6369 6669 6564  If not specified
│ │ │ │ -00021d80: 2c0a 2020 2020 2074 6865 2064 6566 6175  ,.     the defau
│ │ │ │ -00021d90: 6c74 2069 7320 7370 6563 6966 6965 6420  lt is specified 
│ │ │ │ -00021da0: 6174 2063 6f6d 7069 6c65 2d74 696d 6520  at compile-time 
│ │ │ │ -00021db0: 616e 6420 6973 2075 7375 616c 6c79 0a20  and is usually. 
│ │ │ │ -00021dc0: 2020 2020 e280 9824 7072 6566 6978 2f65      ...$prefix/e
│ │ │ │ -00021dd0: 7463 2f73 6869 7368 692e 636f 6e66 e280  tc/shishi.conf..
│ │ │ │ -00021de0: 992e 0a0a 2020 20e2 80a2 20e2 8098 5348  ....   ... ...SH
│ │ │ │ -00021df0: 4953 4849 5f48 4f4d 45e2 8099 2053 7065  ISHI_HOME... Spe
│ │ │ │ -00021e00: 6369 6679 2074 6865 2075 7365 7220 7370  cify the user sp
│ │ │ │ -00021e10: 6563 6966 6963 2064 6972 6563 746f 7279  ecific directory
│ │ │ │ -00021e20: 2066 6f72 2063 6f6e 6669 6775 7261 7469   for configurati
│ │ │ │ -00021e30: 6f6e 0a20 2020 2020 6669 6c65 732c 2074  on.     files, t
│ │ │ │ -00021e40: 6963 6b65 7420 6361 6368 652c 2065 7463  icket cache, etc
│ │ │ │ -00021e50: 2e20 2055 7365 6420 6279 2074 6865 2053  .  Used by the S
│ │ │ │ -00021e60: 6869 7368 6920 6c69 6272 6172 792e 2020  hishi library.  
│ │ │ │ -00021e70: 4966 206e 6f74 0a20 2020 2020 7370 6563  If not.     spec
│ │ │ │ -00021e80: 6966 6965 642c 2069 7420 6973 2063 6f6d  ified, it is com
│ │ │ │ -00021e90: 7075 7465 6420 6173 20e2 8098 2448 4f4d  puted as ...$HOM
│ │ │ │ -00021ea0: 452f 2e73 6869 7368 69e2 8099 2e0a 0a20  E/.shishi...... 
│ │ │ │ -00021eb0: 2020 e280 a220 e280 9853 4849 5348 495f    ... ...SHISHI_
│ │ │ │ -00021ec0: 5553 4552 e280 9920 5370 6563 6966 7920  USER... Specify 
│ │ │ │ -00021ed0: 7468 6520 6465 6661 756c 7420 7072 696e  the default prin
│ │ │ │ -00021ee0: 6369 7061 6c20 7573 6572 206e 616d 652e  cipal user name.
│ │ │ │ -00021ef0: 2020 5573 6564 2062 7920 7468 650a 2020    Used by the.  
│ │ │ │ -00021f00: 2020 2053 6869 7368 6920 6c69 6272 6172     Shishi librar
│ │ │ │ -00021f10: 792e 2020 4966 206e 6f74 2073 7065 6369  y.  If not speci
│ │ │ │ -00021f20: 6669 6564 2c20 6974 2069 7320 7461 6b65  fied, it is take
│ │ │ │ -00021f30: 6e20 6672 6f6d 2074 6865 2065 6e76 6972  n from the envir
│ │ │ │ -00021f40: 6f6e 6d65 6e74 0a20 2020 2020 7661 7269  onment.     vari
│ │ │ │ -00021f50: 6162 6c65 20e2 8098 5553 4552 e280 992e  able ...USER....
│ │ │ │ -00021f60: 0a0a 2020 20e2 80a2 20e2 8098 5348 4953  ..   ... ...SHIS
│ │ │ │ -00021f70: 4849 5f54 4943 4b45 5453 e280 9920 5370  HI_TICKETS... Sp
│ │ │ │ -00021f80: 6563 6966 7920 7468 6520 6669 6c65 206e  ecify the file n
│ │ │ │ -00021f90: 616d 6520 6f66 2074 6865 2074 6963 6b65  ame of the ticke
│ │ │ │ -00021fa0: 7420 6361 6368 652e 2020 5573 6564 0a20  t cache.  Used. 
│ │ │ │ -00021fb0: 2020 2020 6279 2074 6865 2053 6869 7368      by the Shish
│ │ │ │ -00021fc0: 6920 6c69 6272 6172 792e 2020 4966 206e  i library.  If n
│ │ │ │ -00021fd0: 6f74 2073 7065 6369 6669 6564 2c20 6974  ot specified, it
│ │ │ │ -00021fe0: 2077 696c 6c20 6265 0a20 2020 2020 e280   will be.     ..
│ │ │ │ -00021ff0: 9824 5348 4953 4849 5f48 4f4d 452f 7469  .$SHISHI_HOME/ti
│ │ │ │ -00022000: 636b 6574 73e2 8099 2c20 6f72 20e2 8098  ckets..., or ...
│ │ │ │ -00022010: 2448 4f4d 452f 2e73 6869 7368 692f 7469  $HOME/.shishi/ti
│ │ │ │ -00022020: 636b 6574 73e2 8099 2069 660a 2020 2020  ckets... if.    
│ │ │ │ -00022030: 20e2 8098 2453 4849 5348 495f 484f 4d45   ...$SHISHI_HOME
│ │ │ │ -00022040: e280 9920 6973 206e 6f74 2073 7065 6369  ... is not speci
│ │ │ │ -00022050: 6669 6564 2e0a 0a1f 0a46 696c 653a 2073  fied.....File: s
│ │ │ │ -00022060: 6869 7368 692e 696e 666f 2c20 204e 6f64  hishi.info,  Nod
│ │ │ │ -00022070: 653a 2044 6174 6520 696e 7075 7420 666f  e: Date input fo
│ │ │ │ -00022080: 726d 6174 732c 2020 5072 6576 3a20 456e  rmats,  Prev: En
│ │ │ │ -00022090: 7669 726f 6e6d 656e 7420 7661 7269 6162  vironment variab
│ │ │ │ -000220a0: 6c65 732c 2020 5570 3a20 5265 6665 7265  les,  Up: Refere
│ │ │ │ -000220b0: 6e63 6520 4d61 6e75 616c 0a0a 342e 3130  nce Manual..4.10
│ │ │ │ -000220c0: 2044 6174 6520 696e 7075 7420 666f 726d   Date input form
│ │ │ │ -000220d0: 6174 730a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ats.============
│ │ │ │ -000220e0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a46 6972  ===========..Fir
│ │ │ │ -000220f0: 7374 2c20 6120 7175 6f74 653a 0a0a 2020  st, a quote:..  
│ │ │ │ -00022100: 2020 204f 7572 2075 6e69 7473 206f 6620     Our units of 
│ │ │ │ -00022110: 7465 6d70 6f72 616c 206d 6561 7375 7265  temporal measure
│ │ │ │ -00022120: 6d65 6e74 2c20 6672 6f6d 2073 6563 6f6e  ment, from secon
│ │ │ │ -00022130: 6473 206f 6e20 7570 2074 6f20 6d6f 6e74  ds on up to mont
│ │ │ │ -00022140: 6873 2c0a 2020 2020 2061 7265 2073 6f20  hs,.     are so 
│ │ │ │ -00022150: 636f 6d70 6c69 6361 7465 642c 2061 7379  complicated, asy
│ │ │ │ -00022160: 6d6d 6574 7269 6361 6c20 616e 6420 6469  mmetrical and di
│ │ │ │ -00022170: 736a 756e 6374 6976 6520 736f 2061 7320  sjunctive so as 
│ │ │ │ -00022180: 746f 206d 616b 650a 2020 2020 2063 6f68  to make.     coh
│ │ │ │ -00022190: 6572 656e 7420 6d65 6e74 616c 2072 6563  erent mental rec
│ │ │ │ -000221a0: 6b6f 6e69 6e67 2069 6e20 7469 6d65 2061  koning in time a
│ │ │ │ -000221b0: 6c6c 2062 7574 2069 6d70 6f73 7369 626c  ll but impossibl
│ │ │ │ -000221c0: 652e 2020 496e 6465 6564 2c20 6861 640a  e.  Indeed, had.
│ │ │ │ -000221d0: 2020 2020 2073 6f6d 6520 7479 7261 6e6e       some tyrann
│ │ │ │ -000221e0: 6963 616c 2067 6f64 2063 6f6e 7472 6976  ical god contriv
│ │ │ │ -000221f0: 6564 2074 6f20 656e 736c 6176 6520 6f75  ed to enslave ou
│ │ │ │ -00022200: 7220 6d69 6e64 7320 746f 2074 696d 652c  r minds to time,
│ │ │ │ -00022210: 2074 6f20 6d61 6b65 0a20 2020 2020 6974   to make.     it
│ │ │ │ -00022220: 2061 6c6c 2062 7574 2069 6d70 6f73 7369   all but impossi
│ │ │ │ -00022230: 626c 6520 666f 7220 7573 2074 6f20 6573  ble for us to es
│ │ │ │ -00022240: 6361 7065 2073 7562 6a65 6374 696f 6e20  cape subjection 
│ │ │ │ -00022250: 746f 2073 6f64 6465 6e0a 2020 2020 2072  to sodden.     r
│ │ │ │ -00022260: 6f75 7469 6e65 7320 616e 6420 756e 706c  outines and unpl
│ │ │ │ -00022270: 6561 7361 6e74 2073 7572 7072 6973 6573  easant surprises
│ │ │ │ -00022280: 2c20 6865 2063 6f75 6c64 2068 6172 646c  , he could hardl
│ │ │ │ -00022290: 7920 6861 7665 2064 6f6e 6520 6265 7474  y have done bett
│ │ │ │ -000222a0: 6572 0a20 2020 2020 7468 616e 2068 616e  er.     than han
│ │ │ │ -000222b0: 6469 6e67 2064 6f77 6e20 6f75 7220 7072  ding down our pr
│ │ │ │ -000222c0: 6573 656e 7420 7379 7374 656d 2e20 2049  esent system.  I
│ │ │ │ -000222d0: 7420 6973 206c 696b 6520 6120 7365 7420  t is like a set 
│ │ │ │ -000222e0: 6f66 0a20 2020 2020 7472 6170 657a 6f69  of.     trapezoi
│ │ │ │ -000222f0: 6461 6c20 6275 696c 6469 6e67 2062 6c6f  dal building blo
│ │ │ │ -00022300: 636b 732c 2077 6974 6820 6e6f 2076 6572  cks, with no ver
│ │ │ │ -00022310: 7469 6361 6c20 6f72 2068 6f72 697a 6f6e  tical or horizon
│ │ │ │ -00022320: 7461 6c0a 2020 2020 2073 7572 6661 6365  tal.     surface
│ │ │ │ -00022330: 732c 206c 696b 6520 6120 6c61 6e67 7561  s, like a langua
│ │ │ │ -00022340: 6765 2069 6e20 7768 6963 6820 7468 6520  ge in which the 
│ │ │ │ -00022350: 7369 6d70 6c65 7374 2074 686f 7567 6874  simplest thought
│ │ │ │ -00022360: 2064 656d 616e 6473 0a20 2020 2020 6f72   demands.     or
│ │ │ │ -00022370: 6e61 7465 2063 6f6e 7374 7275 6374 696f  nate constructio
│ │ │ │ -00022380: 6e73 2c20 7573 656c 6573 7320 7061 7274  ns, useless part
│ │ │ │ -00022390: 6963 6c65 7320 616e 6420 6c65 6e67 7468  icles and length
│ │ │ │ -000223a0: 790a 2020 2020 2063 6972 6375 6d6c 6f63  y.     circumloc
│ │ │ │ -000223b0: 7574 696f 6e73 2e20 2055 6e6c 696b 6520  utions.  Unlike 
│ │ │ │ -000223c0: 7468 6520 6d6f 7265 2073 7563 6365 7373  the more success
│ │ │ │ -000223d0: 6675 6c20 7061 7474 6572 6e73 206f 6620  ful patterns of 
│ │ │ │ -000223e0: 6c61 6e67 7561 6765 0a20 2020 2020 616e  language.     an
│ │ │ │ -000223f0: 6420 7363 6965 6e63 652c 2077 6869 6368  d science, which
│ │ │ │ -00022400: 2065 6e61 626c 6520 7573 2074 6f20 6661   enable us to fa
│ │ │ │ -00022410: 6365 2065 7870 6572 6965 6e63 6520 626f  ce experience bo
│ │ │ │ -00022420: 6c64 6c79 206f 7220 6174 206c 6561 7374  ldly or at least
│ │ │ │ -00022430: 0a20 2020 2020 6c65 7665 6c2d 6865 6164  .     level-head
│ │ │ │ -00022440: 6564 6c79 2c20 6f75 7220 7379 7374 656d  edly, our system
│ │ │ │ -00022450: 206f 6620 7465 6d70 6f72 616c 2063 616c   of temporal cal
│ │ │ │ -00022460: 6375 6c61 7469 6f6e 2073 696c 656e 746c  culation silentl
│ │ │ │ -00022470: 7920 616e 640a 2020 2020 2070 6572 7369  y and.     persi
│ │ │ │ -00022480: 7374 656e 746c 7920 656e 636f 7572 6167  stently encourag
│ │ │ │ -00022490: 6573 206f 7572 2074 6572 726f 7220 6f66  es our terror of
│ │ │ │ -000224a0: 2074 696d 652e 0a0a 2020 2020 202e 2e2e   time...     ...
│ │ │ │ -000224b0: 2049 7420 6973 2061 7320 7468 6f75 6768   It is as though
│ │ │ │ -000224c0: 2061 7263 6869 7465 6374 7320 6861 6420   architects had 
│ │ │ │ -000224d0: 746f 206d 6561 7375 7265 206c 656e 6774  to measure lengt
│ │ │ │ -000224e0: 6820 696e 2066 6565 742c 2077 6964 7468  h in feet, width
│ │ │ │ -000224f0: 0a20 2020 2020 696e 206d 6574 6572 7320  .     in meters 
│ │ │ │ -00022500: 616e 6420 6865 6967 6874 2069 6e20 656c  and height in el
│ │ │ │ -00022510: 6c73 3b20 6173 2074 686f 7567 6820 6261  ls; as though ba
│ │ │ │ -00022520: 7369 6320 696e 7374 7275 6374 696f 6e20  sic instruction 
│ │ │ │ -00022530: 6d61 6e75 616c 730a 2020 2020 2064 656d  manuals.     dem
│ │ │ │ -00022540: 616e 6465 6420 6120 6b6e 6f77 6c65 6467  anded a knowledg
│ │ │ │ -00022550: 6520 6f66 2066 6976 6520 6469 6666 6572  e of five differ
│ │ │ │ -00022560: 656e 7420 6c61 6e67 7561 6765 732e 2020  ent languages.  
│ │ │ │ -00022570: 4974 2069 7320 6e6f 2077 6f6e 6465 720a  It is no wonder.
│ │ │ │ -00022580: 2020 2020 2074 6865 6e20 7468 6174 2077       then that w
│ │ │ │ -00022590: 6520 6f66 7465 6e20 6c6f 6f6b 2069 6e74  e often look int
│ │ │ │ -000225a0: 6f20 6f75 7220 6f77 6e20 696d 6d65 6469  o our own immedi
│ │ │ │ -000225b0: 6174 6520 7061 7374 206f 7220 6675 7475  ate past or futu
│ │ │ │ -000225c0: 7265 2c20 6c61 7374 0a20 2020 2020 5475  re, last.     Tu
│ │ │ │ -000225d0: 6573 6461 7920 6f72 2061 2077 6565 6b20  esday or a week 
│ │ │ │ -000225e0: 6672 6f6d 2053 756e 6461 792c 2077 6974  from Sunday, wit
│ │ │ │ -000225f0: 6820 6665 656c 696e 6773 206f 6620 6865  h feelings of he
│ │ │ │ -00022600: 6c70 6c65 7373 2063 6f6e 6675 7369 6f6e  lpless confusion
│ │ │ │ -00022610: 2e0a 2020 2020 202e 2e2e 0a0a 2020 2020  ..     .....    
│ │ │ │ -00022620: 202d 2d52 6f62 6572 7420 4772 7564 696e   --Robert Grudin
│ │ │ │ -00022630: 2c20 e280 9854 696d 6520 616e 6420 7468  , ...Time and th
│ │ │ │ -00022640: 6520 4172 7420 6f66 204c 6976 696e 67e2  e Art of Living.
│ │ │ │ -00022650: 8099 2e0a 0a20 2020 5468 6973 2073 6563  .....   This sec
│ │ │ │ -00022660: 7469 6f6e 2064 6573 6372 6962 6573 2074  tion describes t
│ │ │ │ -00022670: 6865 2074 6578 7475 616c 2064 6174 6520  he textual date 
│ │ │ │ -00022680: 7265 7072 6573 656e 7461 7469 6f6e 7320  representations 
│ │ │ │ -00022690: 7468 6174 2047 4e55 0a70 726f 6772 616d  that GNU.program
│ │ │ │ -000226a0: 7320 6163 6365 7074 2e20 2054 6865 7365  s accept.  These
│ │ │ │ -000226b0: 2061 7265 2074 6865 2073 7472 696e 6773   are the strings
│ │ │ │ -000226c0: 2079 6f75 2c20 6173 2061 2075 7365 722c   you, as a user,
│ │ │ │ -000226d0: 2063 616e 2073 7570 706c 7920 6173 0a61   can supply as.a
│ │ │ │ -000226e0: 7267 756d 656e 7473 2074 6f20 7468 6520  rguments to the 
│ │ │ │ -000226f0: 7661 7269 6f75 7320 7072 6f67 7261 6d73  various programs
│ │ │ │ -00022700: 2e20 2054 6865 2043 2069 6e74 6572 6661  .  The C interfa
│ │ │ │ -00022710: 6365 2028 7669 6120 7468 650a e280 9870  ce (via the....p
│ │ │ │ -00022720: 6172 7365 5f64 6174 6574 696d 65e2 8099  arse_datetime...
│ │ │ │ -00022730: 2066 756e 6374 696f 6e29 2069 7320 6e6f   function) is no
│ │ │ │ -00022740: 7420 6465 7363 7269 6265 6420 6865 7265  t described here
│ │ │ │ -00022750: 2e0a 0a2a 204d 656e 753a 0a0a 2a20 4765  ...* Menu:..* Ge
│ │ │ │ -00022760: 6e65 7261 6c20 6461 7465 2073 796e 7461  neral date synta
│ │ │ │ -00022770: 783a 3a20 2020 2020 2020 2020 2043 6f6d  x::          Com
│ │ │ │ -00022780: 6d6f 6e20 7275 6c65 730a 2a20 4361 6c65  mon rules.* Cale
│ │ │ │ -00022790: 6e64 6172 2064 6174 6520 6974 656d 733a  ndar date items:
│ │ │ │ -000227a0: 3a20 2020 2020 2020 2020 2032 3120 4a75  :          21 Ju
│ │ │ │ -000227b0: 6c20 3230 3230 0a2a 2054 696d 6520 6f66  l 2020.* Time of
│ │ │ │ -000227c0: 2064 6179 2069 7465 6d73 3a3a 2020 2020   day items::    
│ │ │ │ -000227d0: 2020 2020 2020 2020 393a 3230 706d 0a2a          9:20pm.*
│ │ │ │ -000227e0: 2054 696d 6520 7a6f 6e65 2069 7465 6d73   Time zone items
│ │ │ │ -000227f0: 3a3a 2020 2020 2020 2020 2020 2020 2020  ::              
│ │ │ │ -00022800: 5554 432c 202d 3037 3030 2c20 2b30 3930  UTC, -0700, +090
│ │ │ │ -00022810: 302c 202e 2e2e 0a2a 2043 6f6d 6269 6e65  0, ....* Combine
│ │ │ │ -00022820: 6420 6461 7465 2061 6e64 2074 696d 6520  d date and time 
│ │ │ │ -00022830: 6f66 2064 6179 2069 7465 6d73 3a3a 2032  of day items:: 2
│ │ │ │ -00022840: 3032 302d 3037 2d32 3154 3230 3a30 323a  020-07-21T20:02:
│ │ │ │ -00022850: 3030 2c30 3030 3030 302d 3034 3030 0a2a  00,000000-0400.*
│ │ │ │ -00022860: 2044 6179 206f 6620 7765 656b 2069 7465   Day of week ite
│ │ │ │ -00022870: 6d73 3a3a 2020 2020 2020 2020 2020 2020  ms::            
│ │ │ │ -00022880: 4d6f 6e64 6179 2061 6e64 206f 7468 6572  Monday and other
│ │ │ │ -00022890: 730a 2a20 5265 6c61 7469 7665 2069 7465  s.* Relative ite
│ │ │ │ -000228a0: 6d73 2069 6e20 6461 7465 2073 7472 696e  ms in date strin
│ │ │ │ -000228b0: 6773 3a3a 206e 6578 7420 7475 6573 6461  gs:: next tuesda
│ │ │ │ -000228c0: 792c 2032 2079 6561 7273 2061 676f 0a2a  y, 2 years ago.*
│ │ │ │ -000228d0: 2050 7572 6520 6e75 6d62 6572 7320 696e   Pure numbers in
│ │ │ │ -000228e0: 2064 6174 6520 7374 7269 6e67 733a 3a20   date strings:: 
│ │ │ │ -000228f0: 3230 3230 3037 3231 2c20 3134 3430 0a2a  20200721, 1440.*
│ │ │ │ -00022900: 2053 6563 6f6e 6473 2073 696e 6365 2074   Seconds since t
│ │ │ │ -00022910: 6865 2045 706f 6368 3a3a 2020 2020 2020  he Epoch::      
│ │ │ │ -00022920: 4031 3539 3532 3839 3630 300a 2a20 5370  @1595289600.* Sp
│ │ │ │ -00022930: 6563 6966 7969 6e67 2074 696d 6520 7a6f  ecifying time zo
│ │ │ │ -00022940: 6e65 2072 756c 6573 3a3a 2020 2054 5a3d  ne rules::   TZ=
│ │ │ │ -00022950: 2241 6d65 7269 6361 2f4e 6577 5f59 6f72  "America/New_Yor
│ │ │ │ -00022960: 6b22 2c20 545a 3d22 5554 4330 220a 2a20  k", TZ="UTC0".* 
│ │ │ │ -00022970: 4175 7468 6f72 7320 6f66 2070 6172 7365  Authors of parse
│ │ │ │ -00022980: 5f64 6174 6574 696d 653a 3a20 2020 2042  _datetime::    B
│ │ │ │ -00022990: 656c 6c6f 7669 6e2c 2045 6767 6572 742c  ellovin, Eggert,
│ │ │ │ -000229a0: 2053 616c 7a2c 2042 6572 6574 732c 2065   Salz, Berets, e
│ │ │ │ -000229b0: 7420 616c 2e0a 0a1f 0a46 696c 653a 2073  t al.....File: s
│ │ │ │ -000229c0: 6869 7368 692e 696e 666f 2c20 204e 6f64  hishi.info,  Nod
│ │ │ │ -000229d0: 653a 2047 656e 6572 616c 2064 6174 6520  e: General date 
│ │ │ │ -000229e0: 7379 6e74 6178 2c20 204e 6578 743a 2043  syntax,  Next: C
│ │ │ │ -000229f0: 616c 656e 6461 7220 6461 7465 2069 7465  alendar date ite
│ │ │ │ -00022a00: 6d73 2c20 2055 703a 2044 6174 6520 696e  ms,  Up: Date in
│ │ │ │ -00022a10: 7075 7420 666f 726d 6174 730a 0a34 2e31  put formats..4.1
│ │ │ │ -00022a20: 302e 3120 4765 6e65 7261 6c20 6461 7465  0.1 General date
│ │ │ │ -00022a30: 2073 796e 7461 780a 2d2d 2d2d 2d2d 2d2d   syntax.--------
│ │ │ │ +00021c60: 3d3d 3d3d 3d3d 3d3d 3d0a 0a41 2066 6577  =========..A few
│ │ │ │ +00021c70: 206f 6620 7468 6520 636f 6d70 696c 652d   of the compile-
│ │ │ │ +00021c80: 7469 6d65 2064 6566 6175 6c74 7320 6d61  time defaults ma
│ │ │ │ +00021c90: 7920 6265 206f 7665 7272 6964 6465 6e20  y be overridden 
│ │ │ │ +00021ca0: 6174 2072 756e 2d74 696d 6520 6279 0a75  at run-time by.u
│ │ │ │ +00021cb0: 7369 6e67 2065 6e76 6972 6f6e 6d65 6e74  sing environment
│ │ │ │ +00021cc0: 2076 6172 6961 626c 6573 2e20 2054 6865   variables.  The
│ │ │ │ +00021cd0: 2066 6f6c 6c6f 7769 6e67 2076 6172 6961   following varia
│ │ │ │ +00021ce0: 626c 6573 2061 7265 2073 7570 706f 7274  bles are support
│ │ │ │ +00021cf0: 6564 2e0a 0a20 2020 e280 a220 e280 9853  ed...   ... ...S
│ │ │ │ +00021d00: 4849 5348 495f 434f 4e46 4947 e280 9920  HISHI_CONFIG... 
│ │ │ │ +00021d10: 5370 6563 6966 7920 7468 6520 6c6f 6361  Specify the loca
│ │ │ │ +00021d20: 7469 6f6e 206f 6620 7468 6520 6465 6661  tion of the defa
│ │ │ │ +00021d30: 756c 7420 7379 7374 656d 0a20 2020 2020  ult system.     
│ │ │ │ +00021d40: 636f 6e66 6967 7572 6174 696f 6e20 6669  configuration fi
│ │ │ │ +00021d50: 6c65 2e20 2055 7365 6420 6279 2074 6865  le.  Used by the
│ │ │ │ +00021d60: 2053 6869 7368 6920 6c69 6272 6172 792e   Shishi library.
│ │ │ │ +00021d70: 2020 4966 206e 6f74 2073 7065 6369 6669    If not specifi
│ │ │ │ +00021d80: 6564 2c0a 2020 2020 2074 6865 2064 6566  ed,.     the def
│ │ │ │ +00021d90: 6175 6c74 2069 7320 7370 6563 6966 6965  ault is specifie
│ │ │ │ +00021da0: 6420 6174 2063 6f6d 7069 6c65 2d74 696d  d at compile-tim
│ │ │ │ +00021db0: 6520 616e 6420 6973 2075 7375 616c 6c79  e and is usually
│ │ │ │ +00021dc0: 0a20 2020 2020 e280 9824 7072 6566 6978  .     ...$prefix
│ │ │ │ +00021dd0: 2f65 7463 2f73 6869 7368 692e 636f 6e66  /etc/shishi.conf
│ │ │ │ +00021de0: e280 992e 0a0a 2020 20e2 80a2 20e2 8098  ......   ... ...
│ │ │ │ +00021df0: 5348 4953 4849 5f48 4f4d 45e2 8099 2053  SHISHI_HOME... S
│ │ │ │ +00021e00: 7065 6369 6679 2074 6865 2075 7365 7220  pecify the user 
│ │ │ │ +00021e10: 7370 6563 6966 6963 2064 6972 6563 746f  specific directo
│ │ │ │ +00021e20: 7279 2066 6f72 2063 6f6e 6669 6775 7261  ry for configura
│ │ │ │ +00021e30: 7469 6f6e 0a20 2020 2020 6669 6c65 732c  tion.     files,
│ │ │ │ +00021e40: 2074 6963 6b65 7420 6361 6368 652c 2065   ticket cache, e
│ │ │ │ +00021e50: 7463 2e20 2055 7365 6420 6279 2074 6865  tc.  Used by the
│ │ │ │ +00021e60: 2053 6869 7368 6920 6c69 6272 6172 792e   Shishi library.
│ │ │ │ +00021e70: 2020 4966 206e 6f74 0a20 2020 2020 7370    If not.     sp
│ │ │ │ +00021e80: 6563 6966 6965 642c 2069 7420 6973 2063  ecified, it is c
│ │ │ │ +00021e90: 6f6d 7075 7465 6420 6173 20e2 8098 2448  omputed as ...$H
│ │ │ │ +00021ea0: 4f4d 452f 2e73 6869 7368 69e2 8099 2e0a  OME/.shishi.....
│ │ │ │ +00021eb0: 0a20 2020 e280 a220 e280 9853 4849 5348  .   ... ...SHISH
│ │ │ │ +00021ec0: 495f 5553 4552 e280 9920 5370 6563 6966  I_USER... Specif
│ │ │ │ +00021ed0: 7920 7468 6520 6465 6661 756c 7420 7072  y the default pr
│ │ │ │ +00021ee0: 696e 6369 7061 6c20 7573 6572 206e 616d  incipal user nam
│ │ │ │ +00021ef0: 652e 2020 5573 6564 2062 7920 7468 650a  e.  Used by the.
│ │ │ │ +00021f00: 2020 2020 2053 6869 7368 6920 6c69 6272       Shishi libr
│ │ │ │ +00021f10: 6172 792e 2020 4966 206e 6f74 2073 7065  ary.  If not spe
│ │ │ │ +00021f20: 6369 6669 6564 2c20 6974 2069 7320 7461  cified, it is ta
│ │ │ │ +00021f30: 6b65 6e20 6672 6f6d 2074 6865 2065 6e76  ken from the env
│ │ │ │ +00021f40: 6972 6f6e 6d65 6e74 0a20 2020 2020 7661  ironment.     va
│ │ │ │ +00021f50: 7269 6162 6c65 20e2 8098 5553 4552 e280  riable ...USER..
│ │ │ │ +00021f60: 992e 0a0a 2020 20e2 80a2 20e2 8098 5348  ....   ... ...SH
│ │ │ │ +00021f70: 4953 4849 5f54 4943 4b45 5453 e280 9920  ISHI_TICKETS... 
│ │ │ │ +00021f80: 5370 6563 6966 7920 7468 6520 6669 6c65  Specify the file
│ │ │ │ +00021f90: 206e 616d 6520 6f66 2074 6865 2074 6963   name of the tic
│ │ │ │ +00021fa0: 6b65 7420 6361 6368 652e 2020 5573 6564  ket cache.  Used
│ │ │ │ +00021fb0: 0a20 2020 2020 6279 2074 6865 2053 6869  .     by the Shi
│ │ │ │ +00021fc0: 7368 6920 6c69 6272 6172 792e 2020 4966  shi library.  If
│ │ │ │ +00021fd0: 206e 6f74 2073 7065 6369 6669 6564 2c20   not specified, 
│ │ │ │ +00021fe0: 6974 2077 696c 6c20 6265 0a20 2020 2020  it will be.     
│ │ │ │ +00021ff0: e280 9824 5348 4953 4849 5f48 4f4d 452f  ...$SHISHI_HOME/
│ │ │ │ +00022000: 7469 636b 6574 73e2 8099 2c20 6f72 20e2  tickets..., or .
│ │ │ │ +00022010: 8098 2448 4f4d 452f 2e73 6869 7368 692f  ..$HOME/.shishi/
│ │ │ │ +00022020: 7469 636b 6574 73e2 8099 2069 660a 2020  tickets... if.  
│ │ │ │ +00022030: 2020 20e2 8098 2453 4849 5348 495f 484f     ...$SHISHI_HO
│ │ │ │ +00022040: 4d45 e280 9920 6973 206e 6f74 2073 7065  ME... is not spe
│ │ │ │ +00022050: 6369 6669 6564 2e0a 0a1f 0a46 696c 653a  cified.....File:
│ │ │ │ +00022060: 2073 6869 7368 692e 696e 666f 2c20 204e   shishi.info,  N
│ │ │ │ +00022070: 6f64 653a 2044 6174 6520 696e 7075 7420  ode: Date input 
│ │ │ │ +00022080: 666f 726d 6174 732c 2020 5072 6576 3a20  formats,  Prev: 
│ │ │ │ +00022090: 456e 7669 726f 6e6d 656e 7420 7661 7269  Environment vari
│ │ │ │ +000220a0: 6162 6c65 732c 2020 5570 3a20 5265 6665  ables,  Up: Refe
│ │ │ │ +000220b0: 7265 6e63 6520 4d61 6e75 616c 0a0a 342e  rence Manual..4.
│ │ │ │ +000220c0: 3130 2044 6174 6520 696e 7075 7420 666f  10 Date input fo
│ │ │ │ +000220d0: 726d 6174 730a 3d3d 3d3d 3d3d 3d3d 3d3d  rmats.==========
│ │ │ │ +000220e0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a46  =============..F
│ │ │ │ +000220f0: 6972 7374 2c20 6120 7175 6f74 653a 0a0a  irst, a quote:..
│ │ │ │ +00022100: 2020 2020 204f 7572 2075 6e69 7473 206f       Our units o
│ │ │ │ +00022110: 6620 7465 6d70 6f72 616c 206d 6561 7375  f temporal measu
│ │ │ │ +00022120: 7265 6d65 6e74 2c20 6672 6f6d 2073 6563  rement, from sec
│ │ │ │ +00022130: 6f6e 6473 206f 6e20 7570 2074 6f20 6d6f  onds on up to mo
│ │ │ │ +00022140: 6e74 6873 2c0a 2020 2020 2061 7265 2073  nths,.     are s
│ │ │ │ +00022150: 6f20 636f 6d70 6c69 6361 7465 642c 2061  o complicated, a
│ │ │ │ +00022160: 7379 6d6d 6574 7269 6361 6c20 616e 6420  symmetrical and 
│ │ │ │ +00022170: 6469 736a 756e 6374 6976 6520 736f 2061  disjunctive so a
│ │ │ │ +00022180: 7320 746f 206d 616b 650a 2020 2020 2063  s to make.     c
│ │ │ │ +00022190: 6f68 6572 656e 7420 6d65 6e74 616c 2072  oherent mental r
│ │ │ │ +000221a0: 6563 6b6f 6e69 6e67 2069 6e20 7469 6d65  eckoning in time
│ │ │ │ +000221b0: 2061 6c6c 2062 7574 2069 6d70 6f73 7369   all but impossi
│ │ │ │ +000221c0: 626c 652e 2020 496e 6465 6564 2c20 6861  ble.  Indeed, ha
│ │ │ │ +000221d0: 640a 2020 2020 2073 6f6d 6520 7479 7261  d.     some tyra
│ │ │ │ +000221e0: 6e6e 6963 616c 2067 6f64 2063 6f6e 7472  nnical god contr
│ │ │ │ +000221f0: 6976 6564 2074 6f20 656e 736c 6176 6520  ived to enslave 
│ │ │ │ +00022200: 6f75 7220 6d69 6e64 7320 746f 2074 696d  our minds to tim
│ │ │ │ +00022210: 652c 2074 6f20 6d61 6b65 0a20 2020 2020  e, to make.     
│ │ │ │ +00022220: 6974 2061 6c6c 2062 7574 2069 6d70 6f73  it all but impos
│ │ │ │ +00022230: 7369 626c 6520 666f 7220 7573 2074 6f20  sible for us to 
│ │ │ │ +00022240: 6573 6361 7065 2073 7562 6a65 6374 696f  escape subjectio
│ │ │ │ +00022250: 6e20 746f 2073 6f64 6465 6e0a 2020 2020  n to sodden.    
│ │ │ │ +00022260: 2072 6f75 7469 6e65 7320 616e 6420 756e   routines and un
│ │ │ │ +00022270: 706c 6561 7361 6e74 2073 7572 7072 6973  pleasant surpris
│ │ │ │ +00022280: 6573 2c20 6865 2063 6f75 6c64 2068 6172  es, he could har
│ │ │ │ +00022290: 646c 7920 6861 7665 2064 6f6e 6520 6265  dly have done be
│ │ │ │ +000222a0: 7474 6572 0a20 2020 2020 7468 616e 2068  tter.     than h
│ │ │ │ +000222b0: 616e 6469 6e67 2064 6f77 6e20 6f75 7220  anding down our 
│ │ │ │ +000222c0: 7072 6573 656e 7420 7379 7374 656d 2e20  present system. 
│ │ │ │ +000222d0: 2049 7420 6973 206c 696b 6520 6120 7365   It is like a se
│ │ │ │ +000222e0: 7420 6f66 0a20 2020 2020 7472 6170 657a  t of.     trapez
│ │ │ │ +000222f0: 6f69 6461 6c20 6275 696c 6469 6e67 2062  oidal building b
│ │ │ │ +00022300: 6c6f 636b 732c 2077 6974 6820 6e6f 2076  locks, with no v
│ │ │ │ +00022310: 6572 7469 6361 6c20 6f72 2068 6f72 697a  ertical or horiz
│ │ │ │ +00022320: 6f6e 7461 6c0a 2020 2020 2073 7572 6661  ontal.     surfa
│ │ │ │ +00022330: 6365 732c 206c 696b 6520 6120 6c61 6e67  ces, like a lang
│ │ │ │ +00022340: 7561 6765 2069 6e20 7768 6963 6820 7468  uage in which th
│ │ │ │ +00022350: 6520 7369 6d70 6c65 7374 2074 686f 7567  e simplest thoug
│ │ │ │ +00022360: 6874 2064 656d 616e 6473 0a20 2020 2020  ht demands.     
│ │ │ │ +00022370: 6f72 6e61 7465 2063 6f6e 7374 7275 6374  ornate construct
│ │ │ │ +00022380: 696f 6e73 2c20 7573 656c 6573 7320 7061  ions, useless pa
│ │ │ │ +00022390: 7274 6963 6c65 7320 616e 6420 6c65 6e67  rticles and leng
│ │ │ │ +000223a0: 7468 790a 2020 2020 2063 6972 6375 6d6c  thy.     circuml
│ │ │ │ +000223b0: 6f63 7574 696f 6e73 2e20 2055 6e6c 696b  ocutions.  Unlik
│ │ │ │ +000223c0: 6520 7468 6520 6d6f 7265 2073 7563 6365  e the more succe
│ │ │ │ +000223d0: 7373 6675 6c20 7061 7474 6572 6e73 206f  ssful patterns o
│ │ │ │ +000223e0: 6620 6c61 6e67 7561 6765 0a20 2020 2020  f language.     
│ │ │ │ +000223f0: 616e 6420 7363 6965 6e63 652c 2077 6869  and science, whi
│ │ │ │ +00022400: 6368 2065 6e61 626c 6520 7573 2074 6f20  ch enable us to 
│ │ │ │ +00022410: 6661 6365 2065 7870 6572 6965 6e63 6520  face experience 
│ │ │ │ +00022420: 626f 6c64 6c79 206f 7220 6174 206c 6561  boldly or at lea
│ │ │ │ +00022430: 7374 0a20 2020 2020 6c65 7665 6c2d 6865  st.     level-he
│ │ │ │ +00022440: 6164 6564 6c79 2c20 6f75 7220 7379 7374  adedly, our syst
│ │ │ │ +00022450: 656d 206f 6620 7465 6d70 6f72 616c 2063  em of temporal c
│ │ │ │ +00022460: 616c 6375 6c61 7469 6f6e 2073 696c 656e  alculation silen
│ │ │ │ +00022470: 746c 7920 616e 640a 2020 2020 2070 6572  tly and.     per
│ │ │ │ +00022480: 7369 7374 656e 746c 7920 656e 636f 7572  sistently encour
│ │ │ │ +00022490: 6167 6573 206f 7572 2074 6572 726f 7220  ages our terror 
│ │ │ │ +000224a0: 6f66 2074 696d 652e 0a0a 2020 2020 202e  of time...     .
│ │ │ │ +000224b0: 2e2e 2049 7420 6973 2061 7320 7468 6f75  .. It is as thou
│ │ │ │ +000224c0: 6768 2061 7263 6869 7465 6374 7320 6861  gh architects ha
│ │ │ │ +000224d0: 6420 746f 206d 6561 7375 7265 206c 656e  d to measure len
│ │ │ │ +000224e0: 6774 6820 696e 2066 6565 742c 2077 6964  gth in feet, wid
│ │ │ │ +000224f0: 7468 0a20 2020 2020 696e 206d 6574 6572  th.     in meter
│ │ │ │ +00022500: 7320 616e 6420 6865 6967 6874 2069 6e20  s and height in 
│ │ │ │ +00022510: 656c 6c73 3b20 6173 2074 686f 7567 6820  ells; as though 
│ │ │ │ +00022520: 6261 7369 6320 696e 7374 7275 6374 696f  basic instructio
│ │ │ │ +00022530: 6e20 6d61 6e75 616c 730a 2020 2020 2064  n manuals.     d
│ │ │ │ +00022540: 656d 616e 6465 6420 6120 6b6e 6f77 6c65  emanded a knowle
│ │ │ │ +00022550: 6467 6520 6f66 2066 6976 6520 6469 6666  dge of five diff
│ │ │ │ +00022560: 6572 656e 7420 6c61 6e67 7561 6765 732e  erent languages.
│ │ │ │ +00022570: 2020 4974 2069 7320 6e6f 2077 6f6e 6465    It is no wonde
│ │ │ │ +00022580: 720a 2020 2020 2074 6865 6e20 7468 6174  r.     then that
│ │ │ │ +00022590: 2077 6520 6f66 7465 6e20 6c6f 6f6b 2069   we often look i
│ │ │ │ +000225a0: 6e74 6f20 6f75 7220 6f77 6e20 696d 6d65  nto our own imme
│ │ │ │ +000225b0: 6469 6174 6520 7061 7374 206f 7220 6675  diate past or fu
│ │ │ │ +000225c0: 7475 7265 2c20 6c61 7374 0a20 2020 2020  ture, last.     
│ │ │ │ +000225d0: 5475 6573 6461 7920 6f72 2061 2077 6565  Tuesday or a wee
│ │ │ │ +000225e0: 6b20 6672 6f6d 2053 756e 6461 792c 2077  k from Sunday, w
│ │ │ │ +000225f0: 6974 6820 6665 656c 696e 6773 206f 6620  ith feelings of 
│ │ │ │ +00022600: 6865 6c70 6c65 7373 2063 6f6e 6675 7369  helpless confusi
│ │ │ │ +00022610: 6f6e 2e0a 2020 2020 202e 2e2e 0a0a 2020  on..     .....  
│ │ │ │ +00022620: 2020 202d 2d52 6f62 6572 7420 4772 7564     --Robert Grud
│ │ │ │ +00022630: 696e 2c20 e280 9854 696d 6520 616e 6420  in, ...Time and 
│ │ │ │ +00022640: 7468 6520 4172 7420 6f66 204c 6976 696e  the Art of Livin
│ │ │ │ +00022650: 67e2 8099 2e0a 0a20 2020 5468 6973 2073  g......   This s
│ │ │ │ +00022660: 6563 7469 6f6e 2064 6573 6372 6962 6573  ection describes
│ │ │ │ +00022670: 2074 6865 2074 6578 7475 616c 2064 6174   the textual dat
│ │ │ │ +00022680: 6520 7265 7072 6573 656e 7461 7469 6f6e  e representation
│ │ │ │ +00022690: 7320 7468 6174 2047 4e55 0a70 726f 6772  s that GNU.progr
│ │ │ │ +000226a0: 616d 7320 6163 6365 7074 2e20 2054 6865  ams accept.  The
│ │ │ │ +000226b0: 7365 2061 7265 2074 6865 2073 7472 696e  se are the strin
│ │ │ │ +000226c0: 6773 2079 6f75 2c20 6173 2061 2075 7365  gs you, as a use
│ │ │ │ +000226d0: 722c 2063 616e 2073 7570 706c 7920 6173  r, can supply as
│ │ │ │ +000226e0: 0a61 7267 756d 656e 7473 2074 6f20 7468  .arguments to th
│ │ │ │ +000226f0: 6520 7661 7269 6f75 7320 7072 6f67 7261  e various progra
│ │ │ │ +00022700: 6d73 2e20 2054 6865 2043 2069 6e74 6572  ms.  The C inter
│ │ │ │ +00022710: 6661 6365 2028 7669 6120 7468 650a e280  face (via the...
│ │ │ │ +00022720: 9870 6172 7365 5f64 6174 6574 696d 65e2  .parse_datetime.
│ │ │ │ +00022730: 8099 2066 756e 6374 696f 6e29 2069 7320  .. function) is 
│ │ │ │ +00022740: 6e6f 7420 6465 7363 7269 6265 6420 6865  not described he
│ │ │ │ +00022750: 7265 2e0a 0a2a 204d 656e 753a 0a0a 2a20  re...* Menu:..* 
│ │ │ │ +00022760: 4765 6e65 7261 6c20 6461 7465 2073 796e  General date syn
│ │ │ │ +00022770: 7461 783a 3a20 2020 2020 2020 2020 2043  tax::          C
│ │ │ │ +00022780: 6f6d 6d6f 6e20 7275 6c65 730a 2a20 4361  ommon rules.* Ca
│ │ │ │ +00022790: 6c65 6e64 6172 2064 6174 6520 6974 656d  lendar date item
│ │ │ │ +000227a0: 733a 3a20 2020 2020 2020 2020 2032 3120  s::          21 
│ │ │ │ +000227b0: 4a75 6c20 3230 3230 0a2a 2054 696d 6520  Jul 2020.* Time 
│ │ │ │ +000227c0: 6f66 2064 6179 2069 7465 6d73 3a3a 2020  of day items::  
│ │ │ │ +000227d0: 2020 2020 2020 2020 2020 393a 3230 706d            9:20pm
│ │ │ │ +000227e0: 0a2a 2054 696d 6520 7a6f 6e65 2069 7465  .* Time zone ite
│ │ │ │ +000227f0: 6d73 3a3a 2020 2020 2020 2020 2020 2020  ms::            
│ │ │ │ +00022800: 2020 5554 432c 202d 3037 3030 2c20 2b30    UTC, -0700, +0
│ │ │ │ +00022810: 3930 302c 202e 2e2e 0a2a 2043 6f6d 6269  900, ....* Combi
│ │ │ │ +00022820: 6e65 6420 6461 7465 2061 6e64 2074 696d  ned date and tim
│ │ │ │ +00022830: 6520 6f66 2064 6179 2069 7465 6d73 3a3a  e of day items::
│ │ │ │ +00022840: 2032 3032 302d 3037 2d32 3154 3230 3a30   2020-07-21T20:0
│ │ │ │ +00022850: 323a 3030 2c30 3030 3030 302d 3034 3030  2:00,000000-0400
│ │ │ │ +00022860: 0a2a 2044 6179 206f 6620 7765 656b 2069  .* Day of week i
│ │ │ │ +00022870: 7465 6d73 3a3a 2020 2020 2020 2020 2020  tems::          
│ │ │ │ +00022880: 2020 4d6f 6e64 6179 2061 6e64 206f 7468    Monday and oth
│ │ │ │ +00022890: 6572 730a 2a20 5265 6c61 7469 7665 2069  ers.* Relative i
│ │ │ │ +000228a0: 7465 6d73 2069 6e20 6461 7465 2073 7472  tems in date str
│ │ │ │ +000228b0: 696e 6773 3a3a 206e 6578 7420 7475 6573  ings:: next tues
│ │ │ │ +000228c0: 6461 792c 2032 2079 6561 7273 2061 676f  day, 2 years ago
│ │ │ │ +000228d0: 0a2a 2050 7572 6520 6e75 6d62 6572 7320  .* Pure numbers 
│ │ │ │ +000228e0: 696e 2064 6174 6520 7374 7269 6e67 733a  in date strings:
│ │ │ │ +000228f0: 3a20 3230 3230 3037 3231 2c20 3134 3430  : 20200721, 1440
│ │ │ │ +00022900: 0a2a 2053 6563 6f6e 6473 2073 696e 6365  .* Seconds since
│ │ │ │ +00022910: 2074 6865 2045 706f 6368 3a3a 2020 2020   the Epoch::    
│ │ │ │ +00022920: 2020 4031 3539 3532 3839 3630 300a 2a20    @1595289600.* 
│ │ │ │ +00022930: 5370 6563 6966 7969 6e67 2074 696d 6520  Specifying time 
│ │ │ │ +00022940: 7a6f 6e65 2072 756c 6573 3a3a 2020 2054  zone rules::   T
│ │ │ │ +00022950: 5a3d 2241 6d65 7269 6361 2f4e 6577 5f59  Z="America/New_Y
│ │ │ │ +00022960: 6f72 6b22 2c20 545a 3d22 5554 4330 220a  ork", TZ="UTC0".
│ │ │ │ +00022970: 2a20 4175 7468 6f72 7320 6f66 2070 6172  * Authors of par
│ │ │ │ +00022980: 7365 5f64 6174 6574 696d 653a 3a20 2020  se_datetime::   
│ │ │ │ +00022990: 2042 656c 6c6f 7669 6e2c 2045 6767 6572   Bellovin, Egger
│ │ │ │ +000229a0: 742c 2053 616c 7a2c 2042 6572 6574 732c  t, Salz, Berets,
│ │ │ │ +000229b0: 2065 7420 616c 2e0a 0a1f 0a46 696c 653a   et al.....File:
│ │ │ │ +000229c0: 2073 6869 7368 692e 696e 666f 2c20 204e   shishi.info,  N
│ │ │ │ +000229d0: 6f64 653a 2047 656e 6572 616c 2064 6174  ode: General dat
│ │ │ │ +000229e0: 6520 7379 6e74 6178 2c20 204e 6578 743a  e syntax,  Next:
│ │ │ │ +000229f0: 2043 616c 656e 6461 7220 6461 7465 2069   Calendar date i
│ │ │ │ +00022a00: 7465 6d73 2c20 2055 703a 2044 6174 6520  tems,  Up: Date 
│ │ │ │ +00022a10: 696e 7075 7420 666f 726d 6174 730a 0a34  input formats..4
│ │ │ │ +00022a20: 2e31 302e 3120 4765 6e65 7261 6c20 6461  .10.1 General da
│ │ │ │ +00022a30: 7465 2073 796e 7461 780a 2d2d 2d2d 2d2d  te syntax.------
│ │ │ │  00022a40: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00022a50: 2d2d 0a0a 4120 e280 9c64 6174 65e2 809d  --..A ...date...
│ │ │ │ -00022a60: 2069 7320 6120 7374 7269 6e67 2c20 706f   is a string, po
│ │ │ │ -00022a70: 7373 6962 6c79 2065 6d70 7479 2c20 636f  ssibly empty, co
│ │ │ │ -00022a80: 6e74 6169 6e69 6e67 206d 616e 7920 6974  ntaining many it
│ │ │ │ -00022a90: 656d 7320 7365 7061 7261 7465 6420 6279  ems separated by
│ │ │ │ -00022aa0: 0a77 6869 7465 7370 6163 652e 2020 5468  .whitespace.  Th
│ │ │ │ -00022ab0: 6520 7768 6974 6573 7061 6365 206d 6179  e whitespace may
│ │ │ │ -00022ac0: 2062 6520 6f6d 6974 7465 6420 7768 656e   be omitted when
│ │ │ │ -00022ad0: 206e 6f20 616d 6269 6775 6974 7920 6172   no ambiguity ar
│ │ │ │ -00022ae0: 6973 6573 2e0a 5468 6520 656d 7074 7920  ises..The empty 
│ │ │ │ -00022af0: 7374 7269 6e67 206d 6561 6e73 2074 6865  string means the
│ │ │ │ -00022b00: 2062 6567 696e 6e69 6e67 206f 6620 746f   beginning of to
│ │ │ │ -00022b10: 6461 7920 2869 2e65 2e2c 206d 6964 6e69  day (i.e., midni
│ │ │ │ -00022b20: 6768 7429 2e20 204f 7264 6572 0a6f 6620  ght).  Order.of 
│ │ │ │ -00022b30: 7468 6520 6974 656d 7320 6973 2069 6d6d  the items is imm
│ │ │ │ -00022b40: 6174 6572 6961 6c2e 2020 4120 6461 7465  aterial.  A date
│ │ │ │ -00022b50: 2073 7472 696e 6720 6d61 7920 636f 6e74   string may cont
│ │ │ │ -00022b60: 6169 6e20 6d61 6e79 2066 6c61 766f 7273  ain many flavors
│ │ │ │ -00022b70: 206f 660a 6974 656d 733a 0a0a 2020 20e2   of.items:..   .
│ │ │ │ -00022b80: 80a2 2063 616c 656e 6461 7220 6461 7465  .. calendar date
│ │ │ │ -00022b90: 2069 7465 6d73 0a20 2020 e280 a220 7469   items.   ... ti
│ │ │ │ -00022ba0: 6d65 206f 6620 6461 7920 6974 656d 730a  me of day items.
│ │ │ │ -00022bb0: 2020 20e2 80a2 2074 696d 6520 7a6f 6e65     ... time zone
│ │ │ │ -00022bc0: 2069 7465 6d73 0a20 2020 e280 a220 636f   items.   ... co
│ │ │ │ -00022bd0: 6d62 696e 6564 2064 6174 6520 616e 6420  mbined date and 
│ │ │ │ -00022be0: 7469 6d65 206f 6620 6461 7920 6974 656d  time of day item
│ │ │ │ -00022bf0: 730a 2020 20e2 80a2 2064 6179 206f 6620  s.   ... day of 
│ │ │ │ -00022c00: 7468 6520 7765 656b 2069 7465 6d73 0a20  the week items. 
│ │ │ │ -00022c10: 2020 e280 a220 7265 6c61 7469 7665 2069    ... relative i
│ │ │ │ -00022c20: 7465 6d73 0a20 2020 e280 a220 7075 7265  tems.   ... pure
│ │ │ │ -00022c30: 206e 756d 6265 7273 2e0a 0a57 6520 6465   numbers...We de
│ │ │ │ -00022c40: 7363 7269 6265 2065 6163 6820 6f66 2074  scribe each of t
│ │ │ │ -00022c50: 6865 7365 2069 7465 6d20 7479 7065 7320  hese item types 
│ │ │ │ -00022c60: 696e 2074 7572 6e2c 2062 656c 6f77 2e0a  in turn, below..
│ │ │ │ -00022c70: 0a20 2020 4120 6665 7720 6f72 6469 6e61  .   A few ordina
│ │ │ │ -00022c80: 6c20 6e75 6d62 6572 7320 6d61 7920 6265  l numbers may be
│ │ │ │ -00022c90: 2077 7269 7474 656e 206f 7574 2069 6e20   written out in 
│ │ │ │ -00022ca0: 776f 7264 7320 696e 2073 6f6d 6520 636f  words in some co
│ │ │ │ -00022cb0: 6e74 6578 7473 2e0a 5468 6973 2069 7320  ntexts..This is 
│ │ │ │ -00022cc0: 6d6f 7374 2075 7365 6675 6c20 666f 7220  most useful for 
│ │ │ │ -00022cd0: 7370 6563 6966 7969 6e67 2064 6179 206f  specifying day o
│ │ │ │ -00022ce0: 6620 7468 6520 7765 656b 2069 7465 6d73  f the week items
│ │ │ │ -00022cf0: 206f 7220 7265 6c61 7469 7665 0a69 7465   or relative.ite
│ │ │ │ -00022d00: 6d73 2028 7365 6520 6265 6c6f 7729 2e20  ms (see below). 
│ │ │ │ -00022d10: 2041 6d6f 6e67 2074 6865 206d 6f73 7420   Among the most 
│ │ │ │ -00022d20: 636f 6d6d 6f6e 6c79 2075 7365 6420 6f72  commonly used or
│ │ │ │ -00022d30: 6469 6e61 6c20 6e75 6d62 6572 732c 2074  dinal numbers, t
│ │ │ │ -00022d40: 6865 0a77 6f72 6420 e280 986c 6173 74e2  he.word ...last.
│ │ │ │ -00022d50: 8099 2073 7461 6e64 7320 666f 7220 2d31  .. stands for -1
│ │ │ │ -00022d60: 2c20 e280 9874 6869 73e2 8099 2073 7461  , ...this... sta
│ │ │ │ -00022d70: 6e64 7320 666f 7220 302c 2061 6e64 20e2  nds for 0, and .
│ │ │ │ -00022d80: 8098 6669 7273 74e2 8099 2061 6e64 20e2  ..first... and .
│ │ │ │ -00022d90: 8098 6e65 7874 e280 990a 626f 7468 2073  ..next....both s
│ │ │ │ -00022da0: 7461 6e64 2066 6f72 2031 2e20 2042 6563  tand for 1.  Bec
│ │ │ │ -00022db0: 6175 7365 2074 6865 2077 6f72 6420 e280  ause the word ..
│ │ │ │ -00022dc0: 9873 6563 6f6e 64e2 8099 2073 7461 6e64  .second... stand
│ │ │ │ -00022dd0: 7320 666f 7220 7468 6520 756e 6974 206f  s for the unit o
│ │ │ │ -00022de0: 6620 7469 6d65 0a74 6865 7265 2069 7320  f time.there is 
│ │ │ │ -00022df0: 6e6f 2077 6179 2074 6f20 7772 6974 6520  no way to write 
│ │ │ │ -00022e00: 7468 6520 6f72 6469 6e61 6c20 6e75 6d62  the ordinal numb
│ │ │ │ -00022e10: 6572 2032 2c20 6275 7420 666f 7220 636f  er 2, but for co
│ │ │ │ -00022e20: 6e76 656e 6965 6e63 650a e280 9874 6869  nvenience....thi
│ │ │ │ -00022e30: 7264 e280 9920 7374 616e 6473 2066 6f72  rd... stands for
│ │ │ │ -00022e40: 2033 2c20 e280 9866 6f75 7274 68e2 8099   3, ...fourth...
│ │ │ │ -00022e50: 2066 6f72 2034 2c20 e280 9866 6966 7468   for 4, ...fifth
│ │ │ │ -00022e60: e280 9920 666f 7220 352c 20e2 8098 7369  ... for 5, ...si
│ │ │ │ -00022e70: 7874 68e2 8099 2066 6f72 2036 2c0a e280  xth... for 6,...
│ │ │ │ -00022e80: 9873 6576 656e 7468 e280 9920 666f 7220  .seventh... for 
│ │ │ │ -00022e90: 372c 20e2 8098 6569 6768 7468 e280 9920  7, ...eighth... 
│ │ │ │ -00022ea0: 666f 7220 382c 20e2 8098 6e69 6e74 68e2  for 8, ...ninth.
│ │ │ │ -00022eb0: 8099 2066 6f72 2039 2c20 e280 9874 656e  .. for 9, ...ten
│ │ │ │ -00022ec0: 7468 e280 9920 666f 7220 3130 2c0a e280  th... for 10,...
│ │ │ │ -00022ed0: 9865 6c65 7665 6e74 68e2 8099 2066 6f72  .eleventh... for
│ │ │ │ -00022ee0: 2031 3120 616e 6420 e280 9874 7765 6c66   11 and ...twelf
│ │ │ │ -00022ef0: 7468 e280 9920 666f 7220 3132 2e0a 0a20  th... for 12... 
│ │ │ │ -00022f00: 2020 5768 656e 2061 206d 6f6e 7468 2069    When a month i
│ │ │ │ -00022f10: 7320 7772 6974 7465 6e20 7468 6973 2077  s written this w
│ │ │ │ -00022f20: 6179 2c20 6974 2069 7320 7374 696c 6c20  ay, it is still 
│ │ │ │ -00022f30: 636f 6e73 6964 6572 6564 2074 6f20 6265  considered to be
│ │ │ │ -00022f40: 0a77 7269 7474 656e 206e 756d 6572 6963  .written numeric
│ │ │ │ -00022f50: 616c 6c79 2c20 696e 7374 6561 6420 6f66  ally, instead of
│ │ │ │ -00022f60: 2062 6569 6e67 2022 7370 656c 6c65 6420   being "spelled 
│ │ │ │ -00022f70: 696e 2066 756c 6c22 3b20 7468 6973 2063  in full"; this c
│ │ │ │ -00022f80: 6861 6e67 6573 0a74 6865 2061 6c6c 6f77  hanges.the allow
│ │ │ │ -00022f90: 6564 2073 7472 696e 6773 2e0a 0a20 2020  ed strings...   
│ │ │ │ -00022fa0: 496e 2074 6865 2063 7572 7265 6e74 2069  In the current i
│ │ │ │ -00022fb0: 6d70 6c65 6d65 6e74 6174 696f 6e2c 206f  mplementation, o
│ │ │ │ -00022fc0: 6e6c 7920 456e 676c 6973 6820 6973 2073  nly English is s
│ │ │ │ -00022fd0: 7570 706f 7274 6564 2066 6f72 2077 6f72  upported for wor
│ │ │ │ -00022fe0: 6473 0a61 6e64 2061 6262 7265 7669 6174  ds.and abbreviat
│ │ │ │ -00022ff0: 696f 6e73 206c 696b 6520 e280 9841 4de2  ions like ...AM.
│ │ │ │ -00023000: 8099 2c20 e280 9844 5354 e280 992c 20e2  .., ...DST..., .
│ │ │ │ -00023010: 8098 4553 54e2 8099 2c20 e280 9866 6972  ..EST..., ...fir
│ │ │ │ -00023020: 7374 e280 992c 20e2 8098 4a61 6e75 6172  st..., ...Januar
│ │ │ │ -00023030: 79e2 8099 2c20 e280 9853 756e 6461 79e2  y..., ...Sunday.
│ │ │ │ -00023040: 8099 2c0a e280 9874 6f6d 6f72 726f 77e2  ..,....tomorrow.
│ │ │ │ -00023050: 8099 2c20 616e 6420 e280 9879 6561 72e2  .., and ...year.
│ │ │ │ -00023060: 8099 2e0a 0a20 2020 5468 6520 6f75 7470  .....   The outp
│ │ │ │ -00023070: 7574 206f 6620 7468 6520 e280 9864 6174  ut of the ...dat
│ │ │ │ -00023080: 65e2 8099 2063 6f6d 6d61 6e64 2069 7320  e... command is 
│ │ │ │ -00023090: 6e6f 7420 616c 7761 7973 2061 6363 6570  not always accep
│ │ │ │ -000230a0: 7461 626c 6520 6173 2061 2064 6174 650a  table as a date.
│ │ │ │ -000230b0: 7374 7269 6e67 2c20 6e6f 7420 6f6e 6c79  string, not only
│ │ │ │ -000230c0: 2062 6563 6175 7365 206f 6620 7468 6520   because of the 
│ │ │ │ -000230d0: 6c61 6e67 7561 6765 2070 726f 626c 656d  language problem
│ │ │ │ -000230e0: 2c20 6275 7420 616c 736f 2062 6563 6175  , but also becau
│ │ │ │ -000230f0: 7365 2074 6865 7265 0a69 7320 6e6f 2073  se there.is no s
│ │ │ │ -00023100: 7461 6e64 6172 6420 6d65 616e 696e 6720  tandard meaning 
│ │ │ │ -00023110: 666f 7220 7469 6d65 207a 6f6e 6520 6974  for time zone it
│ │ │ │ -00023120: 656d 7320 6c69 6b65 20e2 8098 4953 54e2  ems like ...IST.
│ │ │ │ -00023130: 8099 2e20 2057 6865 6e20 7573 696e 670a  ...  When using.
│ │ │ │ -00023140: e280 9864 6174 65e2 8099 2074 6f20 6765  ...date... to ge
│ │ │ │ -00023150: 6e65 7261 7465 2061 2064 6174 6520 7374  nerate a date st
│ │ │ │ -00023160: 7269 6e67 2069 6e74 656e 6465 6420 746f  ring intended to
│ │ │ │ -00023170: 2062 6520 7061 7273 6564 206c 6174 6572   be parsed later
│ │ │ │ -00023180: 2c20 7370 6563 6966 7920 610a 6461 7465  , specify a.date
│ │ │ │ -00023190: 2066 6f72 6d61 7420 7468 6174 2069 7320   format that is 
│ │ │ │ -000231a0: 696e 6465 7065 6e64 656e 7420 6f66 206c  independent of l
│ │ │ │ -000231b0: 616e 6775 6167 6520 616e 6420 7468 6174  anguage and that
│ │ │ │ -000231c0: 2064 6f65 7320 6e6f 7420 7573 6520 7469   does not use ti
│ │ │ │ -000231d0: 6d65 0a7a 6f6e 6520 6974 656d 7320 6f74  me.zone items ot
│ │ │ │ -000231e0: 6865 7220 7468 616e 20e2 8098 5554 43e2  her than ...UTC.
│ │ │ │ -000231f0: 8099 2061 6e64 20e2 8098 5ae2 8099 2e20  .. and ...Z.... 
│ │ │ │ -00023200: 2048 6572 6520 6172 6520 736f 6d65 2077   Here are some w
│ │ │ │ -00023210: 6179 7320 746f 2064 6f20 7468 6973 3a0a  ays to do this:.
│ │ │ │ -00023220: 0a20 2020 2020 2420 4c43 5f41 4c4c 3d43  .     $ LC_ALL=C
│ │ │ │ -00023230: 2054 5a3d 5554 4330 2064 6174 650a 2020   TZ=UTC0 date.  
│ │ │ │ -00023240: 2020 2054 7565 204a 756c 2032 3120 3233     Tue Jul 21 23
│ │ │ │ -00023250: 3a30 303a 3337 2055 5443 2032 3032 300a  :00:37 UTC 2020.
│ │ │ │ -00023260: 2020 2020 2024 2054 5a3d 5554 4330 2064       $ TZ=UTC0 d
│ │ │ │ -00023270: 6174 6520 2b27 2559 2d25 6d2d 2564 2025  ate +'%Y-%m-%d %
│ │ │ │ -00023280: 483a 254d 3a25 535a 270a 2020 2020 2032  H:%M:%SZ'.     2
│ │ │ │ -00023290: 3032 302d 3037 2d32 3120 3233 3a30 303a  020-07-21 23:00:
│ │ │ │ -000232a0: 3337 5a0a 2020 2020 2024 2064 6174 6520  37Z.     $ date 
│ │ │ │ -000232b0: 2d2d 7266 632d 3333 3339 3d6e 7320 2023  --rfc-3339=ns  #
│ │ │ │ -000232c0: 202d 2d72 6663 2d33 3333 3920 6973 2061   --rfc-3339 is a
│ │ │ │ -000232d0: 2047 4e55 2065 7874 656e 7369 6f6e 2e0a   GNU extension..
│ │ │ │ -000232e0: 2020 2020 2032 3032 302d 3037 2d32 3120       2020-07-21 
│ │ │ │ -000232f0: 3139 3a30 303a 3337 2e36 3932 3732 3231  19:00:37.6927221
│ │ │ │ -00023300: 3238 2d30 343a 3030 0a20 2020 2020 2420  28-04:00.     $ 
│ │ │ │ -00023310: 6461 7465 202d 2d72 6663 2d32 3832 3220  date --rfc-2822 
│ │ │ │ -00023320: 2023 2061 2047 4e55 2065 7874 656e 7369   # a GNU extensi
│ │ │ │ -00023330: 6f6e 0a20 2020 2020 5475 652c 2032 3120  on.     Tue, 21 
│ │ │ │ -00023340: 4a75 6c20 3230 3230 2031 393a 3030 3a33  Jul 2020 19:00:3
│ │ │ │ -00023350: 3720 2d30 3430 300a 2020 2020 2024 2064  7 -0400.     $ d
│ │ │ │ -00023360: 6174 6520 2b27 2559 2d25 6d2d 2564 2025  ate +'%Y-%m-%d %
│ │ │ │ -00023370: 483a 254d 3a25 5320 257a 2720 2023 2025  H:%M:%S %z'  # %
│ │ │ │ -00023380: 7a20 6973 2061 2047 4e55 2065 7874 656e  z is a GNU exten
│ │ │ │ -00023390: 7369 6f6e 2e0a 2020 2020 2032 3032 302d  sion..     2020-
│ │ │ │ -000233a0: 3037 2d32 3120 3139 3a30 303a 3337 202d  07-21 19:00:37 -
│ │ │ │ -000233b0: 3034 3030 0a20 2020 2020 2420 6461 7465  0400.     $ date
│ │ │ │ -000233c0: 202b 2740 2573 2e25 4e27 2020 2320 2573   +'@%s.%N'  # %s
│ │ │ │ -000233d0: 2061 6e64 2025 4e20 6172 6520 474e 5520   and %N are GNU 
│ │ │ │ -000233e0: 6578 7465 6e73 696f 6e73 2e0a 2020 2020  extensions..    
│ │ │ │ -000233f0: 2040 3135 3935 3337 3234 3337 2e36 3932   @1595372437.692
│ │ │ │ -00023400: 3732 3231 3238 0a0a 2020 2041 6c70 6861  722128..   Alpha
│ │ │ │ -00023410: 6265 7469 6320 6361 7365 2069 7320 636f  betic case is co
│ │ │ │ -00023420: 6d70 6c65 7465 6c79 2069 676e 6f72 6564  mpletely ignored
│ │ │ │ -00023430: 2069 6e20 6461 7465 732e 2020 436f 6d6d   in dates.  Comm
│ │ │ │ -00023440: 656e 7473 206d 6179 2062 650a 696e 7472  ents may be.intr
│ │ │ │ -00023450: 6f64 7563 6564 2062 6574 7765 656e 2072  oduced between r
│ │ │ │ -00023460: 6f75 6e64 2070 6172 656e 7468 6573 6573  ound parentheses
│ │ │ │ -00023470: 2c20 6173 206c 6f6e 6720 6173 2069 6e63  , as long as inc
│ │ │ │ -00023480: 6c75 6465 6420 7061 7265 6e74 6865 7365  luded parenthese
│ │ │ │ -00023490: 730a 6172 6520 7072 6f70 6572 6c79 206e  s.are properly n
│ │ │ │ -000234a0: 6573 7465 642e 2020 4879 7068 656e 7320  ested.  Hyphens 
│ │ │ │ -000234b0: 6e6f 7420 666f 6c6c 6f77 6564 2062 7920  not followed by 
│ │ │ │ -000234c0: 6120 6469 6769 7420 6172 6520 6375 7272  a digit are curr
│ │ │ │ -000234d0: 656e 746c 790a 6967 6e6f 7265 642e 2020  ently.ignored.  
│ │ │ │ -000234e0: 4c65 6164 696e 6720 7a65 726f 7320 6f6e  Leading zeros on
│ │ │ │ -000234f0: 206e 756d 6265 7273 2061 7265 2069 676e   numbers are ign
│ │ │ │ -00023500: 6f72 6564 2e0a 0a20 2020 496e 7661 6c69  ored...   Invali
│ │ │ │ -00023510: 6420 6461 7465 7320 6c69 6b65 20e2 8098  d dates like ...
│ │ │ │ -00023520: 3230 3139 2d30 322d 3239 e280 9920 6f72  2019-02-29... or
│ │ │ │ -00023530: 2074 696d 6573 206c 696b 6520 e280 9832   times like ...2
│ │ │ │ -00023540: 343a 3030 e280 9920 6172 6520 7265 6a65  4:00... are reje
│ │ │ │ -00023550: 6374 6564 2e0a 496e 2074 6865 2074 7970  cted..In the typ
│ │ │ │ -00023560: 6963 616c 2063 6173 6520 6f66 2061 2068  ical case of a h
│ │ │ │ -00023570: 6f73 7420 7468 6174 2064 6f65 7320 6e6f  ost that does no
│ │ │ │ -00023580: 7420 7375 7070 6f72 7420 6c65 6170 2073  t support leap s
│ │ │ │ -00023590: 6563 6f6e 6473 2c20 6120 7469 6d65 0a6c  econds, a time.l
│ │ │ │ -000235a0: 696b 6520 e280 9832 333a 3539 3a36 30e2  ike ...23:59:60.
│ │ │ │ -000235b0: 8099 2069 7320 7265 6a65 6374 6564 2065  .. is rejected e
│ │ │ │ -000235c0: 7665 6e20 6966 2069 7420 636f 7272 6573  ven if it corres
│ │ │ │ -000235d0: 706f 6e64 7320 746f 2061 2076 616c 6964  ponds to a valid
│ │ │ │ -000235e0: 206c 6561 700a 7365 636f 6e64 2e0a 0a1f   leap.second....
│ │ │ │ -000235f0: 0a46 696c 653a 2073 6869 7368 692e 696e  .File: shishi.in
│ │ │ │ -00023600: 666f 2c20 204e 6f64 653a 2043 616c 656e  fo,  Node: Calen
│ │ │ │ -00023610: 6461 7220 6461 7465 2069 7465 6d73 2c20  dar date items, 
│ │ │ │ -00023620: 204e 6578 743a 2054 696d 6520 6f66 2064   Next: Time of d
│ │ │ │ -00023630: 6179 2069 7465 6d73 2c20 2050 7265 763a  ay items,  Prev:
│ │ │ │ -00023640: 2047 656e 6572 616c 2064 6174 6520 7379   General date sy
│ │ │ │ -00023650: 6e74 6178 2c20 2055 703a 2044 6174 6520  ntax,  Up: Date 
│ │ │ │ -00023660: 696e 7075 7420 666f 726d 6174 730a 0a34  input formats..4
│ │ │ │ -00023670: 2e31 302e 3220 4361 6c65 6e64 6172 2064  .10.2 Calendar d
│ │ │ │ -00023680: 6174 6520 6974 656d 730a 2d2d 2d2d 2d2d  ate items.------
│ │ │ │ +00022a50: 2d2d 2d2d 0a0a 4120 e280 9c64 6174 65e2  ----..A ...date.
│ │ │ │ +00022a60: 809d 2069 7320 6120 7374 7269 6e67 2c20  .. is a string, 
│ │ │ │ +00022a70: 706f 7373 6962 6c79 2065 6d70 7479 2c20  possibly empty, 
│ │ │ │ +00022a80: 636f 6e74 6169 6e69 6e67 206d 616e 7920  containing many 
│ │ │ │ +00022a90: 6974 656d 7320 7365 7061 7261 7465 6420  items separated 
│ │ │ │ +00022aa0: 6279 0a77 6869 7465 7370 6163 652e 2020  by.whitespace.  
│ │ │ │ +00022ab0: 5468 6520 7768 6974 6573 7061 6365 206d  The whitespace m
│ │ │ │ +00022ac0: 6179 2062 6520 6f6d 6974 7465 6420 7768  ay be omitted wh
│ │ │ │ +00022ad0: 656e 206e 6f20 616d 6269 6775 6974 7920  en no ambiguity 
│ │ │ │ +00022ae0: 6172 6973 6573 2e0a 5468 6520 656d 7074  arises..The empt
│ │ │ │ +00022af0: 7920 7374 7269 6e67 206d 6561 6e73 2074  y string means t
│ │ │ │ +00022b00: 6865 2062 6567 696e 6e69 6e67 206f 6620  he beginning of 
│ │ │ │ +00022b10: 746f 6461 7920 2869 2e65 2e2c 206d 6964  today (i.e., mid
│ │ │ │ +00022b20: 6e69 6768 7429 2e20 204f 7264 6572 0a6f  night).  Order.o
│ │ │ │ +00022b30: 6620 7468 6520 6974 656d 7320 6973 2069  f the items is i
│ │ │ │ +00022b40: 6d6d 6174 6572 6961 6c2e 2020 4120 6461  mmaterial.  A da
│ │ │ │ +00022b50: 7465 2073 7472 696e 6720 6d61 7920 636f  te string may co
│ │ │ │ +00022b60: 6e74 6169 6e20 6d61 6e79 2066 6c61 766f  ntain many flavo
│ │ │ │ +00022b70: 7273 206f 660a 6974 656d 733a 0a0a 2020  rs of.items:..  
│ │ │ │ +00022b80: 20e2 80a2 2063 616c 656e 6461 7220 6461   ... calendar da
│ │ │ │ +00022b90: 7465 2069 7465 6d73 0a20 2020 e280 a220  te items.   ... 
│ │ │ │ +00022ba0: 7469 6d65 206f 6620 6461 7920 6974 656d  time of day item
│ │ │ │ +00022bb0: 730a 2020 20e2 80a2 2074 696d 6520 7a6f  s.   ... time zo
│ │ │ │ +00022bc0: 6e65 2069 7465 6d73 0a20 2020 e280 a220  ne items.   ... 
│ │ │ │ +00022bd0: 636f 6d62 696e 6564 2064 6174 6520 616e  combined date an
│ │ │ │ +00022be0: 6420 7469 6d65 206f 6620 6461 7920 6974  d time of day it
│ │ │ │ +00022bf0: 656d 730a 2020 20e2 80a2 2064 6179 206f  ems.   ... day o
│ │ │ │ +00022c00: 6620 7468 6520 7765 656b 2069 7465 6d73  f the week items
│ │ │ │ +00022c10: 0a20 2020 e280 a220 7265 6c61 7469 7665  .   ... relative
│ │ │ │ +00022c20: 2069 7465 6d73 0a20 2020 e280 a220 7075   items.   ... pu
│ │ │ │ +00022c30: 7265 206e 756d 6265 7273 2e0a 0a57 6520  re numbers...We 
│ │ │ │ +00022c40: 6465 7363 7269 6265 2065 6163 6820 6f66  describe each of
│ │ │ │ +00022c50: 2074 6865 7365 2069 7465 6d20 7479 7065   these item type
│ │ │ │ +00022c60: 7320 696e 2074 7572 6e2c 2062 656c 6f77  s in turn, below
│ │ │ │ +00022c70: 2e0a 0a20 2020 4120 6665 7720 6f72 6469  ...   A few ordi
│ │ │ │ +00022c80: 6e61 6c20 6e75 6d62 6572 7320 6d61 7920  nal numbers may 
│ │ │ │ +00022c90: 6265 2077 7269 7474 656e 206f 7574 2069  be written out i
│ │ │ │ +00022ca0: 6e20 776f 7264 7320 696e 2073 6f6d 6520  n words in some 
│ │ │ │ +00022cb0: 636f 6e74 6578 7473 2e0a 5468 6973 2069  contexts..This i
│ │ │ │ +00022cc0: 7320 6d6f 7374 2075 7365 6675 6c20 666f  s most useful fo
│ │ │ │ +00022cd0: 7220 7370 6563 6966 7969 6e67 2064 6179  r specifying day
│ │ │ │ +00022ce0: 206f 6620 7468 6520 7765 656b 2069 7465   of the week ite
│ │ │ │ +00022cf0: 6d73 206f 7220 7265 6c61 7469 7665 0a69  ms or relative.i
│ │ │ │ +00022d00: 7465 6d73 2028 7365 6520 6265 6c6f 7729  tems (see below)
│ │ │ │ +00022d10: 2e20 2041 6d6f 6e67 2074 6865 206d 6f73  .  Among the mos
│ │ │ │ +00022d20: 7420 636f 6d6d 6f6e 6c79 2075 7365 6420  t commonly used 
│ │ │ │ +00022d30: 6f72 6469 6e61 6c20 6e75 6d62 6572 732c  ordinal numbers,
│ │ │ │ +00022d40: 2074 6865 0a77 6f72 6420 e280 986c 6173   the.word ...las
│ │ │ │ +00022d50: 74e2 8099 2073 7461 6e64 7320 666f 7220  t... stands for 
│ │ │ │ +00022d60: 2d31 2c20 e280 9874 6869 73e2 8099 2073  -1, ...this... s
│ │ │ │ +00022d70: 7461 6e64 7320 666f 7220 302c 2061 6e64  tands for 0, and
│ │ │ │ +00022d80: 20e2 8098 6669 7273 74e2 8099 2061 6e64   ...first... and
│ │ │ │ +00022d90: 20e2 8098 6e65 7874 e280 990a 626f 7468   ...next....both
│ │ │ │ +00022da0: 2073 7461 6e64 2066 6f72 2031 2e20 2042   stand for 1.  B
│ │ │ │ +00022db0: 6563 6175 7365 2074 6865 2077 6f72 6420  ecause the word 
│ │ │ │ +00022dc0: e280 9873 6563 6f6e 64e2 8099 2073 7461  ...second... sta
│ │ │ │ +00022dd0: 6e64 7320 666f 7220 7468 6520 756e 6974  nds for the unit
│ │ │ │ +00022de0: 206f 6620 7469 6d65 0a74 6865 7265 2069   of time.there i
│ │ │ │ +00022df0: 7320 6e6f 2077 6179 2074 6f20 7772 6974  s no way to writ
│ │ │ │ +00022e00: 6520 7468 6520 6f72 6469 6e61 6c20 6e75  e the ordinal nu
│ │ │ │ +00022e10: 6d62 6572 2032 2c20 6275 7420 666f 7220  mber 2, but for 
│ │ │ │ +00022e20: 636f 6e76 656e 6965 6e63 650a e280 9874  convenience....t
│ │ │ │ +00022e30: 6869 7264 e280 9920 7374 616e 6473 2066  hird... stands f
│ │ │ │ +00022e40: 6f72 2033 2c20 e280 9866 6f75 7274 68e2  or 3, ...fourth.
│ │ │ │ +00022e50: 8099 2066 6f72 2034 2c20 e280 9866 6966  .. for 4, ...fif
│ │ │ │ +00022e60: 7468 e280 9920 666f 7220 352c 20e2 8098  th... for 5, ...
│ │ │ │ +00022e70: 7369 7874 68e2 8099 2066 6f72 2036 2c0a  sixth... for 6,.
│ │ │ │ +00022e80: e280 9873 6576 656e 7468 e280 9920 666f  ...seventh... fo
│ │ │ │ +00022e90: 7220 372c 20e2 8098 6569 6768 7468 e280  r 7, ...eighth..
│ │ │ │ +00022ea0: 9920 666f 7220 382c 20e2 8098 6e69 6e74  . for 8, ...nint
│ │ │ │ +00022eb0: 68e2 8099 2066 6f72 2039 2c20 e280 9874  h... for 9, ...t
│ │ │ │ +00022ec0: 656e 7468 e280 9920 666f 7220 3130 2c0a  enth... for 10,.
│ │ │ │ +00022ed0: e280 9865 6c65 7665 6e74 68e2 8099 2066  ...eleventh... f
│ │ │ │ +00022ee0: 6f72 2031 3120 616e 6420 e280 9874 7765  or 11 and ...twe
│ │ │ │ +00022ef0: 6c66 7468 e280 9920 666f 7220 3132 2e0a  lfth... for 12..
│ │ │ │ +00022f00: 0a20 2020 5768 656e 2061 206d 6f6e 7468  .   When a month
│ │ │ │ +00022f10: 2069 7320 7772 6974 7465 6e20 7468 6973   is written this
│ │ │ │ +00022f20: 2077 6179 2c20 6974 2069 7320 7374 696c   way, it is stil
│ │ │ │ +00022f30: 6c20 636f 6e73 6964 6572 6564 2074 6f20  l considered to 
│ │ │ │ +00022f40: 6265 0a77 7269 7474 656e 206e 756d 6572  be.written numer
│ │ │ │ +00022f50: 6963 616c 6c79 2c20 696e 7374 6561 6420  ically, instead 
│ │ │ │ +00022f60: 6f66 2062 6569 6e67 2022 7370 656c 6c65  of being "spelle
│ │ │ │ +00022f70: 6420 696e 2066 756c 6c22 3b20 7468 6973  d in full"; this
│ │ │ │ +00022f80: 2063 6861 6e67 6573 0a74 6865 2061 6c6c   changes.the all
│ │ │ │ +00022f90: 6f77 6564 2073 7472 696e 6773 2e0a 0a20  owed strings... 
│ │ │ │ +00022fa0: 2020 496e 2074 6865 2063 7572 7265 6e74    In the current
│ │ │ │ +00022fb0: 2069 6d70 6c65 6d65 6e74 6174 696f 6e2c   implementation,
│ │ │ │ +00022fc0: 206f 6e6c 7920 456e 676c 6973 6820 6973   only English is
│ │ │ │ +00022fd0: 2073 7570 706f 7274 6564 2066 6f72 2077   supported for w
│ │ │ │ +00022fe0: 6f72 6473 0a61 6e64 2061 6262 7265 7669  ords.and abbrevi
│ │ │ │ +00022ff0: 6174 696f 6e73 206c 696b 6520 e280 9841  ations like ...A
│ │ │ │ +00023000: 4de2 8099 2c20 e280 9844 5354 e280 992c  M..., ...DST...,
│ │ │ │ +00023010: 20e2 8098 4553 54e2 8099 2c20 e280 9866   ...EST..., ...f
│ │ │ │ +00023020: 6972 7374 e280 992c 20e2 8098 4a61 6e75  irst..., ...Janu
│ │ │ │ +00023030: 6172 79e2 8099 2c20 e280 9853 756e 6461  ary..., ...Sunda
│ │ │ │ +00023040: 79e2 8099 2c0a e280 9874 6f6d 6f72 726f  y...,....tomorro
│ │ │ │ +00023050: 77e2 8099 2c20 616e 6420 e280 9879 6561  w..., and ...yea
│ │ │ │ +00023060: 72e2 8099 2e0a 0a20 2020 5468 6520 6f75  r......   The ou
│ │ │ │ +00023070: 7470 7574 206f 6620 7468 6520 e280 9864  tput of the ...d
│ │ │ │ +00023080: 6174 65e2 8099 2063 6f6d 6d61 6e64 2069  ate... command i
│ │ │ │ +00023090: 7320 6e6f 7420 616c 7761 7973 2061 6363  s not always acc
│ │ │ │ +000230a0: 6570 7461 626c 6520 6173 2061 2064 6174  eptable as a dat
│ │ │ │ +000230b0: 650a 7374 7269 6e67 2c20 6e6f 7420 6f6e  e.string, not on
│ │ │ │ +000230c0: 6c79 2062 6563 6175 7365 206f 6620 7468  ly because of th
│ │ │ │ +000230d0: 6520 6c61 6e67 7561 6765 2070 726f 626c  e language probl
│ │ │ │ +000230e0: 656d 2c20 6275 7420 616c 736f 2062 6563  em, but also bec
│ │ │ │ +000230f0: 6175 7365 2074 6865 7265 0a69 7320 6e6f  ause there.is no
│ │ │ │ +00023100: 2073 7461 6e64 6172 6420 6d65 616e 696e   standard meanin
│ │ │ │ +00023110: 6720 666f 7220 7469 6d65 207a 6f6e 6520  g for time zone 
│ │ │ │ +00023120: 6974 656d 7320 6c69 6b65 20e2 8098 4953  items like ...IS
│ │ │ │ +00023130: 54e2 8099 2e20 2057 6865 6e20 7573 696e  T....  When usin
│ │ │ │ +00023140: 670a e280 9864 6174 65e2 8099 2074 6f20  g....date... to 
│ │ │ │ +00023150: 6765 6e65 7261 7465 2061 2064 6174 6520  generate a date 
│ │ │ │ +00023160: 7374 7269 6e67 2069 6e74 656e 6465 6420  string intended 
│ │ │ │ +00023170: 746f 2062 6520 7061 7273 6564 206c 6174  to be parsed lat
│ │ │ │ +00023180: 6572 2c20 7370 6563 6966 7920 610a 6461  er, specify a.da
│ │ │ │ +00023190: 7465 2066 6f72 6d61 7420 7468 6174 2069  te format that i
│ │ │ │ +000231a0: 7320 696e 6465 7065 6e64 656e 7420 6f66  s independent of
│ │ │ │ +000231b0: 206c 616e 6775 6167 6520 616e 6420 7468   language and th
│ │ │ │ +000231c0: 6174 2064 6f65 7320 6e6f 7420 7573 6520  at does not use 
│ │ │ │ +000231d0: 7469 6d65 0a7a 6f6e 6520 6974 656d 7320  time.zone items 
│ │ │ │ +000231e0: 6f74 6865 7220 7468 616e 20e2 8098 5554  other than ...UT
│ │ │ │ +000231f0: 43e2 8099 2061 6e64 20e2 8098 5ae2 8099  C... and ...Z...
│ │ │ │ +00023200: 2e20 2048 6572 6520 6172 6520 736f 6d65  .  Here are some
│ │ │ │ +00023210: 2077 6179 7320 746f 2064 6f20 7468 6973   ways to do this
│ │ │ │ +00023220: 3a0a 0a20 2020 2020 2420 4c43 5f41 4c4c  :..     $ LC_ALL
│ │ │ │ +00023230: 3d43 2054 5a3d 5554 4330 2064 6174 650a  =C TZ=UTC0 date.
│ │ │ │ +00023240: 2020 2020 2054 7565 204a 756c 2032 3120       Tue Jul 21 
│ │ │ │ +00023250: 3233 3a30 303a 3337 2055 5443 2032 3032  23:00:37 UTC 202
│ │ │ │ +00023260: 300a 2020 2020 2024 2054 5a3d 5554 4330  0.     $ TZ=UTC0
│ │ │ │ +00023270: 2064 6174 6520 2b27 2559 2d25 6d2d 2564   date +'%Y-%m-%d
│ │ │ │ +00023280: 2025 483a 254d 3a25 535a 270a 2020 2020   %H:%M:%SZ'.    
│ │ │ │ +00023290: 2032 3032 302d 3037 2d32 3120 3233 3a30   2020-07-21 23:0
│ │ │ │ +000232a0: 303a 3337 5a0a 2020 2020 2024 2064 6174  0:37Z.     $ dat
│ │ │ │ +000232b0: 6520 2d2d 7266 632d 3333 3339 3d6e 7320  e --rfc-3339=ns 
│ │ │ │ +000232c0: 2023 202d 2d72 6663 2d33 3333 3920 6973   # --rfc-3339 is
│ │ │ │ +000232d0: 2061 2047 4e55 2065 7874 656e 7369 6f6e   a GNU extension
│ │ │ │ +000232e0: 2e0a 2020 2020 2032 3032 302d 3037 2d32  ..     2020-07-2
│ │ │ │ +000232f0: 3120 3139 3a30 303a 3337 2e36 3932 3732  1 19:00:37.69272
│ │ │ │ +00023300: 3231 3238 2d30 343a 3030 0a20 2020 2020  2128-04:00.     
│ │ │ │ +00023310: 2420 6461 7465 202d 2d72 6663 2d32 3832  $ date --rfc-282
│ │ │ │ +00023320: 3220 2023 2061 2047 4e55 2065 7874 656e  2  # a GNU exten
│ │ │ │ +00023330: 7369 6f6e 0a20 2020 2020 5475 652c 2032  sion.     Tue, 2
│ │ │ │ +00023340: 3120 4a75 6c20 3230 3230 2031 393a 3030  1 Jul 2020 19:00
│ │ │ │ +00023350: 3a33 3720 2d30 3430 300a 2020 2020 2024  :37 -0400.     $
│ │ │ │ +00023360: 2064 6174 6520 2b27 2559 2d25 6d2d 2564   date +'%Y-%m-%d
│ │ │ │ +00023370: 2025 483a 254d 3a25 5320 257a 2720 2023   %H:%M:%S %z'  #
│ │ │ │ +00023380: 2025 7a20 6973 2061 2047 4e55 2065 7874   %z is a GNU ext
│ │ │ │ +00023390: 656e 7369 6f6e 2e0a 2020 2020 2032 3032  ension..     202
│ │ │ │ +000233a0: 302d 3037 2d32 3120 3139 3a30 303a 3337  0-07-21 19:00:37
│ │ │ │ +000233b0: 202d 3034 3030 0a20 2020 2020 2420 6461   -0400.     $ da
│ │ │ │ +000233c0: 7465 202b 2740 2573 2e25 4e27 2020 2320  te +'@%s.%N'  # 
│ │ │ │ +000233d0: 2573 2061 6e64 2025 4e20 6172 6520 474e  %s and %N are GN
│ │ │ │ +000233e0: 5520 6578 7465 6e73 696f 6e73 2e0a 2020  U extensions..  
│ │ │ │ +000233f0: 2020 2040 3135 3935 3337 3234 3337 2e36     @1595372437.6
│ │ │ │ +00023400: 3932 3732 3231 3238 0a0a 2020 2041 6c70  92722128..   Alp
│ │ │ │ +00023410: 6861 6265 7469 6320 6361 7365 2069 7320  habetic case is 
│ │ │ │ +00023420: 636f 6d70 6c65 7465 6c79 2069 676e 6f72  completely ignor
│ │ │ │ +00023430: 6564 2069 6e20 6461 7465 732e 2020 436f  ed in dates.  Co
│ │ │ │ +00023440: 6d6d 656e 7473 206d 6179 2062 650a 696e  mments may be.in
│ │ │ │ +00023450: 7472 6f64 7563 6564 2062 6574 7765 656e  troduced between
│ │ │ │ +00023460: 2072 6f75 6e64 2070 6172 656e 7468 6573   round parenthes
│ │ │ │ +00023470: 6573 2c20 6173 206c 6f6e 6720 6173 2069  es, as long as i
│ │ │ │ +00023480: 6e63 6c75 6465 6420 7061 7265 6e74 6865  ncluded parenthe
│ │ │ │ +00023490: 7365 730a 6172 6520 7072 6f70 6572 6c79  ses.are properly
│ │ │ │ +000234a0: 206e 6573 7465 642e 2020 4879 7068 656e   nested.  Hyphen
│ │ │ │ +000234b0: 7320 6e6f 7420 666f 6c6c 6f77 6564 2062  s not followed b
│ │ │ │ +000234c0: 7920 6120 6469 6769 7420 6172 6520 6375  y a digit are cu
│ │ │ │ +000234d0: 7272 656e 746c 790a 6967 6e6f 7265 642e  rrently.ignored.
│ │ │ │ +000234e0: 2020 4c65 6164 696e 6720 7a65 726f 7320    Leading zeros 
│ │ │ │ +000234f0: 6f6e 206e 756d 6265 7273 2061 7265 2069  on numbers are i
│ │ │ │ +00023500: 676e 6f72 6564 2e0a 0a20 2020 496e 7661  gnored...   Inva
│ │ │ │ +00023510: 6c69 6420 6461 7465 7320 6c69 6b65 20e2  lid dates like .
│ │ │ │ +00023520: 8098 3230 3139 2d30 322d 3239 e280 9920  ..2019-02-29... 
│ │ │ │ +00023530: 6f72 2074 696d 6573 206c 696b 6520 e280  or times like ..
│ │ │ │ +00023540: 9832 343a 3030 e280 9920 6172 6520 7265  .24:00... are re
│ │ │ │ +00023550: 6a65 6374 6564 2e0a 496e 2074 6865 2074  jected..In the t
│ │ │ │ +00023560: 7970 6963 616c 2063 6173 6520 6f66 2061  ypical case of a
│ │ │ │ +00023570: 2068 6f73 7420 7468 6174 2064 6f65 7320   host that does 
│ │ │ │ +00023580: 6e6f 7420 7375 7070 6f72 7420 6c65 6170  not support leap
│ │ │ │ +00023590: 2073 6563 6f6e 6473 2c20 6120 7469 6d65   seconds, a time
│ │ │ │ +000235a0: 0a6c 696b 6520 e280 9832 333a 3539 3a36  .like ...23:59:6
│ │ │ │ +000235b0: 30e2 8099 2069 7320 7265 6a65 6374 6564  0... is rejected
│ │ │ │ +000235c0: 2065 7665 6e20 6966 2069 7420 636f 7272   even if it corr
│ │ │ │ +000235d0: 6573 706f 6e64 7320 746f 2061 2076 616c  esponds to a val
│ │ │ │ +000235e0: 6964 206c 6561 700a 7365 636f 6e64 2e0a  id leap.second..
│ │ │ │ +000235f0: 0a1f 0a46 696c 653a 2073 6869 7368 692e  ...File: shishi.
│ │ │ │ +00023600: 696e 666f 2c20 204e 6f64 653a 2043 616c  info,  Node: Cal
│ │ │ │ +00023610: 656e 6461 7220 6461 7465 2069 7465 6d73  endar date items
│ │ │ │ +00023620: 2c20 204e 6578 743a 2054 696d 6520 6f66  ,  Next: Time of
│ │ │ │ +00023630: 2064 6179 2069 7465 6d73 2c20 2050 7265   day items,  Pre
│ │ │ │ +00023640: 763a 2047 656e 6572 616c 2064 6174 6520  v: General date 
│ │ │ │ +00023650: 7379 6e74 6178 2c20 2055 703a 2044 6174  syntax,  Up: Dat
│ │ │ │ +00023660: 6520 696e 7075 7420 666f 726d 6174 730a  e input formats.
│ │ │ │ +00023670: 0a34 2e31 302e 3220 4361 6c65 6e64 6172  .4.10.2 Calendar
│ │ │ │ +00023680: 2064 6174 6520 6974 656d 730a 2d2d 2d2d   date items.----
│ │ │ │  00023690: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000236a0: 2d2d 2d2d 0a0a 4120 e280 9c63 616c 656e  ----..A ...calen
│ │ │ │ -000236b0: 6461 7220 6461 7465 2069 7465 6de2 809d  dar date item...
│ │ │ │ -000236c0: 2073 7065 6369 6669 6573 2061 2064 6179   specifies a day
│ │ │ │ -000236d0: 206f 6620 7468 6520 7965 6172 2e20 2049   of the year.  I
│ │ │ │ -000236e0: 7420 6973 2073 7065 6369 6669 6564 0a64  t is specified.d
│ │ │ │ -000236f0: 6966 6665 7265 6e74 6c79 2c20 6465 7065  ifferently, depe
│ │ │ │ -00023700: 6e64 696e 6720 6f6e 2077 6865 7468 6572  nding on whether
│ │ │ │ -00023710: 2074 6865 206d 6f6e 7468 2069 7320 7370   the month is sp
│ │ │ │ -00023720: 6563 6966 6965 6420 6e75 6d65 7269 6361  ecified numerica
│ │ │ │ -00023730: 6c6c 7920 6f72 0a6c 6974 6572 616c 6c79  lly or.literally
│ │ │ │ -00023740: 2e20 2041 6c6c 2074 6865 7365 2073 7472  .  All these str
│ │ │ │ -00023750: 696e 6773 2073 7065 6369 6679 2074 6865  ings specify the
│ │ │ │ -00023760: 2073 616d 6520 6361 6c65 6e64 6172 2064   same calendar d
│ │ │ │ -00023770: 6174 653a 0a0a 2020 2020 2032 3032 302d  ate:..     2020-
│ │ │ │ -00023780: 3037 2d32 3020 2020 2020 2320 4953 4f20  07-20     # ISO 
│ │ │ │ -00023790: 3836 3031 2e0a 2020 2020 2032 302d 372d  8601..     20-7-
│ │ │ │ -000237a0: 3230 2020 2020 2020 2020 2320 4173 7375  20        # Assu
│ │ │ │ -000237b0: 6d65 2031 3978 7820 666f 7220 3639 2074  me 19xx for 69 t
│ │ │ │ -000237c0: 6872 6f75 6768 2039 392c 0a20 2020 2020  hrough 99,.     
│ │ │ │ -000237d0: 2020 2020 2020 2020 2020 2020 2020 2023                 #
│ │ │ │ -000237e0: 2032 3078 7820 666f 7220 3030 2074 6872   20xx for 00 thr
│ │ │ │ -000237f0: 6f75 6768 2036 3820 286e 6f74 2072 6563  ough 68 (not rec
│ │ │ │ -00023800: 6f6d 6d65 6e64 6564 292e 0a20 2020 2020  ommended)..     
│ │ │ │ -00023810: 372f 3230 2f32 3032 3020 2020 2020 2023  7/20/2020      #
│ │ │ │ -00023820: 2043 6f6d 6d6f 6e20 552e 532e 2077 7269   Common U.S. wri
│ │ │ │ -00023830: 7469 6e67 2e0a 2020 2020 2032 3020 4a75  ting..     20 Ju
│ │ │ │ -00023840: 6c79 2032 3032 300a 2020 2020 2032 3020  ly 2020.     20 
│ │ │ │ -00023850: 4a75 6c20 3230 3230 2020 2020 2320 5468  Jul 2020    # Th
│ │ │ │ -00023860: 7265 652d 6c65 7474 6572 2061 6262 7265  ree-letter abbre
│ │ │ │ -00023870: 7669 6174 696f 6e73 2061 6c77 6179 7320  viations always 
│ │ │ │ -00023880: 616c 6c6f 7765 642e 0a20 2020 2020 4a75  allowed..     Ju
│ │ │ │ -00023890: 6c20 3230 2c20 3230 3230 0a20 2020 2020  l 20, 2020.     
│ │ │ │ -000238a0: 3230 2d6a 756c 2d32 3032 300a 2020 2020  20-jul-2020.    
│ │ │ │ -000238b0: 2032 306a 756c 3230 3230 0a0a 2020 2054   20jul2020..   T
│ │ │ │ -000238c0: 6865 2079 6561 7220 6361 6e20 616c 736f  he year can also
│ │ │ │ -000238d0: 2062 6520 6f6d 6974 7465 642e 2020 496e   be omitted.  In
│ │ │ │ -000238e0: 2074 6869 7320 6361 7365 2c20 7468 6520   this case, the 
│ │ │ │ -000238f0: 6c61 7374 2073 7065 6369 6669 6564 2079  last specified y
│ │ │ │ -00023900: 6561 720a 6973 2075 7365 642c 206f 7220  ear.is used, or 
│ │ │ │ -00023910: 7468 6520 6375 7272 656e 7420 7965 6172  the current year
│ │ │ │ -00023920: 2069 6620 6e6f 6e65 2e20 2046 6f72 2065   if none.  For e
│ │ │ │ -00023930: 7861 6d70 6c65 3a0a 0a20 2020 2020 372f  xample:..     7/
│ │ │ │ -00023940: 3230 0a20 2020 2020 6a75 6c20 3230 0a0a  20.     jul 20..
│ │ │ │ -00023950: 2020 2048 6572 6520 6172 6520 7468 6520     Here are the 
│ │ │ │ -00023960: 7275 6c65 732e 0a0a 2020 2046 6f72 206e  rules...   For n
│ │ │ │ -00023970: 756d 6572 6963 206d 6f6e 7468 732c 2074  umeric months, t
│ │ │ │ -00023980: 6865 2049 534f 2038 3630 3120 666f 726d  he ISO 8601 form
│ │ │ │ -00023990: 6174 20e2 8098 5945 4152 2d4d 4f4e 5448  at ...YEAR-MONTH
│ │ │ │ -000239a0: 2d44 4159 e280 9920 6973 2061 6c6c 6f77  -DAY... is allow
│ │ │ │ -000239b0: 6564 2c0a 7768 6572 6520 5945 4152 2069  ed,.where YEAR i
│ │ │ │ -000239c0: 7320 616e 7920 706f 7369 7469 7665 206e  s any positive n
│ │ │ │ -000239d0: 756d 6265 722c 204d 4f4e 5448 2069 7320  umber, MONTH is 
│ │ │ │ -000239e0: 6120 6e75 6d62 6572 2062 6574 7765 656e  a number between
│ │ │ │ -000239f0: 2030 3120 616e 6420 3132 2c0a 616e 6420   01 and 12,.and 
│ │ │ │ -00023a00: 4441 5920 6973 2061 206e 756d 6265 7220  DAY is a number 
│ │ │ │ -00023a10: 6265 7477 6565 6e20 3031 2061 6e64 2033  between 01 and 3
│ │ │ │ -00023a20: 312e 2020 4120 6c65 6164 696e 6720 7a65  1.  A leading ze
│ │ │ │ -00023a30: 726f 206d 7573 7420 6265 2070 7265 7365  ro must be prese
│ │ │ │ -00023a40: 6e74 0a69 6620 6120 6e75 6d62 6572 2069  nt.if a number i
│ │ │ │ -00023a50: 7320 6c65 7373 2074 6861 6e20 7465 6e2e  s less than ten.
│ │ │ │ -00023a60: 2020 4966 2059 4541 5220 6973 2036 3820    If YEAR is 68 
│ │ │ │ -00023a70: 6f72 2073 6d61 6c6c 6572 2c20 7468 656e  or smaller, then
│ │ │ │ -00023a80: 2032 3030 3020 6973 0a61 6464 6564 2074   2000 is.added t
│ │ │ │ -00023a90: 6f20 6974 3b20 6f74 6865 7277 6973 652c  o it; otherwise,
│ │ │ │ -00023aa0: 2069 6620 5945 4152 2069 7320 6c65 7373   if YEAR is less
│ │ │ │ -00023ab0: 2074 6861 6e20 3130 302c 2074 6865 6e20   than 100, then 
│ │ │ │ -00023ac0: 3139 3030 2069 7320 6164 6465 6420 746f  1900 is added to
│ │ │ │ -00023ad0: 0a69 742e 2020 5468 6520 636f 6e73 7472  .it.  The constr
│ │ │ │ -00023ae0: 7563 7420 e280 984d 4f4e 5448 2f44 4159  uct ...MONTH/DAY
│ │ │ │ -00023af0: 2f59 4541 52e2 8099 2c20 706f 7075 6c61  /YEAR..., popula
│ │ │ │ -00023b00: 7220 696e 2074 6865 2055 6e69 7465 6420  r in the United 
│ │ │ │ -00023b10: 5374 6174 6573 2c20 6973 0a61 6363 6570  States, is.accep
│ │ │ │ -00023b20: 7465 642e 2020 416c 736f 20e2 8098 4d4f  ted.  Also ...MO
│ │ │ │ -00023b30: 4e54 482f 4441 59e2 8099 2c20 6f6d 6974  NTH/DAY..., omit
│ │ │ │ -00023b40: 7469 6e67 2074 6865 2079 6561 722e 0a0a  ting the year...
│ │ │ │ -00023b50: 2020 204c 6974 6572 616c 206d 6f6e 7468     Literal month
│ │ │ │ -00023b60: 7320 6d61 7920 6265 2073 7065 6c6c 6564  s may be spelled
│ │ │ │ -00023b70: 206f 7574 2069 6e20 6675 6c6c 3a20 e280   out in full: ..
│ │ │ │ -00023b80: 984a 616e 7561 7279 e280 992c 20e2 8098  .January..., ...
│ │ │ │ -00023b90: 4665 6272 7561 7279 e280 992c 0ae2 8098  February...,....
│ │ │ │ -00023ba0: 4d61 7263 68e2 8099 2c20 e280 9841 7072  March..., ...Apr
│ │ │ │ -00023bb0: 696c e280 992c 20e2 8098 4d61 79e2 8099  il..., ...May...
│ │ │ │ -00023bc0: 2c20 e280 984a 756e 65e2 8099 2c20 e280  , ...June..., ..
│ │ │ │ -00023bd0: 984a 756c 79e2 8099 2c20 e280 9841 7567  .July..., ...Aug
│ │ │ │ -00023be0: 7573 74e2 8099 2c20 e280 9853 6570 7465  ust..., ...Septe
│ │ │ │ -00023bf0: 6d62 6572 e280 992c 0ae2 8098 4f63 746f  mber...,....Octo
│ │ │ │ -00023c00: 6265 72e2 8099 2c20 e280 984e 6f76 656d  ber..., ...Novem
│ │ │ │ -00023c10: 6265 72e2 8099 206f 7220 e280 9844 6563  ber... or ...Dec
│ │ │ │ -00023c20: 656d 6265 72e2 8099 2e20 204c 6974 6572  ember....  Liter
│ │ │ │ -00023c30: 616c 206d 6f6e 7468 7320 6d61 7920 6265  al months may be
│ │ │ │ -00023c40: 2061 6262 7265 7669 6174 6564 0a74 6f20   abbreviated.to 
│ │ │ │ -00023c50: 7468 6569 7220 6669 7273 7420 7468 7265  their first thre
│ │ │ │ -00023c60: 6520 6c65 7474 6572 732c 2070 6f73 7369  e letters, possi
│ │ │ │ -00023c70: 626c 7920 666f 6c6c 6f77 6564 2062 7920  bly followed by 
│ │ │ │ -00023c80: 616e 2061 6262 7265 7669 6174 696e 6720  an abbreviating 
│ │ │ │ -00023c90: 646f 742e 0a49 7420 6973 2061 6c73 6f20  dot..It is also 
│ │ │ │ -00023ca0: 7065 726d 6974 7465 6420 746f 2077 7269  permitted to wri
│ │ │ │ -00023cb0: 7465 20e2 8098 5365 7074 e280 9920 696e  te ...Sept... in
│ │ │ │ -00023cc0: 7374 6561 6420 6f66 20e2 8098 5365 7074  stead of ...Sept
│ │ │ │ -00023cd0: 656d 6265 72e2 8099 2e0a 0a20 2020 5768  ember......   Wh
│ │ │ │ -00023ce0: 656e 206d 6f6e 7468 7320 6172 6520 7772  en months are wr
│ │ │ │ -00023cf0: 6974 7465 6e20 6c69 7465 7261 6c6c 792c  itten literally,
│ │ │ │ -00023d00: 2074 6865 2063 616c 656e 6461 7220 6461   the calendar da
│ │ │ │ -00023d10: 7465 206d 6179 2062 6520 6769 7665 6e20  te may be given 
│ │ │ │ -00023d20: 6173 0a61 6e79 206f 6620 7468 6520 666f  as.any of the fo
│ │ │ │ -00023d30: 6c6c 6f77 696e 673a 0a0a 2020 2020 2044  llowing:..     D
│ │ │ │ -00023d40: 4159 204d 4f4e 5448 2059 4541 520a 2020  AY MONTH YEAR.  
│ │ │ │ -00023d50: 2020 2044 4159 204d 4f4e 5448 0a20 2020     DAY MONTH.   
│ │ │ │ -00023d60: 2020 4d4f 4e54 4820 4441 5920 5945 4152    MONTH DAY YEAR
│ │ │ │ -00023d70: 0a20 2020 2020 4441 592d 4d4f 4e54 482d  .     DAY-MONTH-
│ │ │ │ -00023d80: 5945 4152 0a0a 2020 204f 722c 206f 6d69  YEAR..   Or, omi
│ │ │ │ -00023d90: 7474 696e 6720 7468 6520 7965 6172 3a0a  tting the year:.
│ │ │ │ -00023da0: 0a20 2020 2020 4d4f 4e54 4820 4441 590a  .     MONTH DAY.
│ │ │ │ -00023db0: 0a1f 0a46 696c 653a 2073 6869 7368 692e  ...File: shishi.
│ │ │ │ -00023dc0: 696e 666f 2c20 204e 6f64 653a 2054 696d  info,  Node: Tim
│ │ │ │ -00023dd0: 6520 6f66 2064 6179 2069 7465 6d73 2c20  e of day items, 
│ │ │ │ -00023de0: 204e 6578 743a 2054 696d 6520 7a6f 6e65   Next: Time zone
│ │ │ │ -00023df0: 2069 7465 6d73 2c20 2050 7265 763a 2043   items,  Prev: C
│ │ │ │ -00023e00: 616c 656e 6461 7220 6461 7465 2069 7465  alendar date ite
│ │ │ │ -00023e10: 6d73 2c20 2055 703a 2044 6174 6520 696e  ms,  Up: Date in
│ │ │ │ -00023e20: 7075 7420 666f 726d 6174 730a 0a34 2e31  put formats..4.1
│ │ │ │ -00023e30: 302e 3320 5469 6d65 206f 6620 6461 7920  0.3 Time of day 
│ │ │ │ -00023e40: 6974 656d 730a 2d2d 2d2d 2d2d 2d2d 2d2d  items.----------
│ │ │ │ -00023e50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -00023e60: 4120 e280 9c74 696d 6520 6f66 2064 6179  A ...time of day
│ │ │ │ -00023e70: 2069 7465 6de2 809d 2069 6e20 6461 7465   item... in date
│ │ │ │ -00023e80: 2073 7472 696e 6773 2073 7065 6369 6669   strings specifi
│ │ │ │ -00023e90: 6573 2074 6865 2074 696d 6520 6f6e 2061  es the time on a
│ │ │ │ -00023ea0: 2067 6976 656e 2064 6179 2e0a 4865 7265   given day..Here
│ │ │ │ -00023eb0: 2061 7265 2073 6f6d 6520 6578 616d 706c   are some exampl
│ │ │ │ -00023ec0: 6573 2c20 616c 6c20 6f66 2077 6869 6368  es, all of which
│ │ │ │ -00023ed0: 2072 6570 7265 7365 6e74 2074 6865 2073   represent the s
│ │ │ │ -00023ee0: 616d 6520 7469 6d65 3a0a 0a20 2020 2020  ame time:..     
│ │ │ │ -00023ef0: 3230 3a30 323a 3030 2e30 3030 3030 300a  20:02:00.000000.
│ │ │ │ -00023f00: 2020 2020 2032 303a 3032 0a20 2020 2020       20:02.     
│ │ │ │ -00023f10: 383a 3032 706d 0a20 2020 2020 3230 3a30  8:02pm.     20:0
│ │ │ │ -00023f20: 322d 3035 3030 2020 2020 2020 2320 496e  2-0500      # In
│ │ │ │ -00023f30: 2045 5354 2028 552e 532e 2045 6173 7465   EST (U.S. Easte
│ │ │ │ -00023f40: 726e 2053 7461 6e64 6172 6420 5469 6d65  rn Standard Time
│ │ │ │ -00023f50: 292e 0a0a 2020 204d 6f72 6520 6765 6e65  )...   More gene
│ │ │ │ -00023f60: 7261 6c6c 792c 2074 6865 2074 696d 6520  rally, the time 
│ │ │ │ -00023f70: 6f66 2064 6179 206d 6179 2062 6520 6769  of day may be gi
│ │ │ │ -00023f80: 7665 6e20 6173 20e2 8098 484f 5552 3a4d  ven as ...HOUR:M
│ │ │ │ -00023f90: 494e 5554 453a 5345 434f 4e44 e280 992c  INUTE:SECOND...,
│ │ │ │ -00023fa0: 0a77 6865 7265 2048 4f55 5220 6973 2061  .where HOUR is a
│ │ │ │ -00023fb0: 206e 756d 6265 7220 6265 7477 6565 6e20   number between 
│ │ │ │ -00023fc0: 3020 616e 6420 3233 2c20 4d49 4e55 5445  0 and 23, MINUTE
│ │ │ │ -00023fd0: 2069 7320 6120 6e75 6d62 6572 2062 6574   is a number bet
│ │ │ │ -00023fe0: 7765 656e 2030 0a61 6e64 2035 392c 2061  ween 0.and 59, a
│ │ │ │ -00023ff0: 6e64 2053 4543 4f4e 4420 6973 2061 206e  nd SECOND is a n
│ │ │ │ -00024000: 756d 6265 7220 6265 7477 6565 6e20 3020  umber between 0 
│ │ │ │ -00024010: 616e 6420 3539 2070 6f73 7369 626c 7920  and 59 possibly 
│ │ │ │ -00024020: 666f 6c6c 6f77 6564 2062 7920 e280 982e  followed by ....
│ │ │ │ -00024030: e280 990a 6f72 20e2 8098 2ce2 8099 2061  ....or ...,... a
│ │ │ │ -00024040: 6e64 2061 2066 7261 6374 696f 6e20 636f  nd a fraction co
│ │ │ │ -00024050: 6e74 6169 6e69 6e67 206f 6e65 206f 7220  ntaining one or 
│ │ │ │ -00024060: 6d6f 7265 2064 6967 6974 732e 2020 416c  more digits.  Al
│ │ │ │ -00024070: 7465 726e 6174 6976 656c 792c 0ae2 8098  ternatively,....
│ │ │ │ -00024080: 3a53 4543 4f4e 44e2 8099 2063 616e 2062  :SECOND... can b
│ │ │ │ -00024090: 6520 6f6d 6974 7465 642c 2069 6e20 7768  e omitted, in wh
│ │ │ │ -000240a0: 6963 6820 6361 7365 2069 7420 6973 2074  ich case it is t
│ │ │ │ -000240b0: 616b 656e 2074 6f20 6265 207a 6572 6f2e  aken to be zero.
│ │ │ │ -000240c0: 2020 4f6e 2074 6865 0a72 6172 6520 686f    On the.rare ho
│ │ │ │ -000240d0: 7374 7320 7468 6174 2073 7570 706f 7274  sts that support
│ │ │ │ -000240e0: 206c 6561 7020 7365 636f 6e64 732c 2053   leap seconds, S
│ │ │ │ -000240f0: 4543 4f4e 4420 6d61 7920 6265 2036 302e  ECOND may be 60.
│ │ │ │ -00024100: 0a0a 2020 2049 6620 7468 6520 7469 6d65  ..   If the time
│ │ │ │ -00024110: 2069 7320 666f 6c6c 6f77 6564 2062 7920   is followed by 
│ │ │ │ -00024120: e280 9861 6de2 8099 206f 7220 e280 9870  ...am... or ...p
│ │ │ │ -00024130: 6de2 8099 2028 6f72 20e2 8098 612e 6d2e  m... (or ...a.m.
│ │ │ │ -00024140: e280 9920 6f72 20e2 8098 702e 6d2e e280  ... or ...p.m...
│ │ │ │ -00024150: 9929 2c20 484f 5552 0a69 7320 7265 7374  .), HOUR.is rest
│ │ │ │ -00024160: 7269 6374 6564 2074 6f20 7275 6e20 6672  ricted to run fr
│ │ │ │ -00024170: 6f6d 2031 2074 6f20 3132 2c20 616e 6420  om 1 to 12, and 
│ │ │ │ -00024180: e280 983a 4d49 4e55 5445 e280 9920 6d61  ...:MINUTE... ma
│ │ │ │ -00024190: 7920 6265 206f 6d69 7474 6564 2028 7461  y be omitted (ta
│ │ │ │ -000241a0: 6b65 6e0a 746f 2062 6520 7a65 726f 292e  ken.to be zero).
│ │ │ │ -000241b0: 2020 e280 9861 6de2 8099 2069 6e64 6963    ...am... indic
│ │ │ │ -000241c0: 6174 6573 2074 6865 2066 6972 7374 2068  ates the first h
│ │ │ │ -000241d0: 616c 6620 6f66 2074 6865 2064 6179 2c20  alf of the day, 
│ │ │ │ -000241e0: e280 9870 6de2 8099 2069 6e64 6963 6174  ...pm... indicat
│ │ │ │ -000241f0: 6573 0a74 6865 2073 6563 6f6e 6420 6861  es.the second ha
│ │ │ │ -00024200: 6c66 206f 6620 7468 6520 6461 792e 2020  lf of the day.  
│ │ │ │ -00024210: 496e 2074 6869 7320 6e6f 7461 7469 6f6e  In this notation
│ │ │ │ -00024220: 2c20 3132 2069 7320 7468 6520 7072 6564  , 12 is the pred
│ │ │ │ -00024230: 6563 6573 736f 7220 6f66 0a31 3a20 6d69  ecessor of.1: mi
│ │ │ │ -00024240: 646e 6967 6874 2069 7320 e280 9831 3261  dnight is ...12a
│ │ │ │ -00024250: 6de2 8099 2077 6869 6c65 206e 6f6f 6e20  m... while noon 
│ │ │ │ -00024260: 6973 20e2 8098 3132 706d e280 992e 2020  is ...12pm....  
│ │ │ │ -00024270: 2854 6869 7320 6973 2074 6865 207a 6572  (This is the zer
│ │ │ │ -00024280: 6f2d 6f72 6965 6e74 6564 0a69 6e74 6572  o-oriented.inter
│ │ │ │ -00024290: 7072 6574 6174 696f 6e20 6f66 20e2 8098  pretation of ...
│ │ │ │ -000242a0: 3132 616d e280 9920 616e 6420 e280 9831  12am... and ...1
│ │ │ │ -000242b0: 3270 6de2 8099 2c20 6173 206f 7070 6f73  2pm..., as oppos
│ │ │ │ -000242c0: 6564 2074 6f20 7468 6520 6f6c 6420 7472  ed to the old tr
│ │ │ │ -000242d0: 6164 6974 696f 6e0a 6465 7269 7665 6420  adition.derived 
│ │ │ │ -000242e0: 6672 6f6d 204c 6174 696e 2077 6869 6368  from Latin which
│ │ │ │ -000242f0: 2075 7365 7320 e280 9831 326d e280 9920   uses ...12m... 
│ │ │ │ -00024300: 666f 7220 6e6f 6f6e 2061 6e64 20e2 8098  for noon and ...
│ │ │ │ -00024310: 3132 706d e280 9920 666f 7220 6d69 646e  12pm... for midn
│ │ │ │ -00024320: 6967 6874 2e29 0a0a 2020 2054 6865 2074  ight.)..   The t
│ │ │ │ -00024330: 696d 6520 6d61 7920 616c 7465 726e 6174  ime may alternat
│ │ │ │ -00024340: 6976 656c 7920 6265 2066 6f6c 6c6f 7765  ively be followe
│ │ │ │ -00024350: 6420 6279 2061 2074 696d 6520 7a6f 6e65  d by a time zone
│ │ │ │ -00024360: 2063 6f72 7265 6374 696f 6e2c 0a65 7870   correction,.exp
│ │ │ │ -00024370: 7265 7373 6564 2061 7320 e280 9853 4848  ressed as ...SHH
│ │ │ │ -00024380: 4d4d e280 992c 2077 6865 7265 2053 2069  MM..., where S i
│ │ │ │ -00024390: 7320 e280 982b e280 9920 6f72 20e2 8098  s ...+... or ...
│ │ │ │ -000243a0: 2de2 8099 2c20 4848 2069 7320 6120 6e75  -..., HH is a nu
│ │ │ │ -000243b0: 6d62 6572 206f 6620 7a6f 6e65 0a68 6f75  mber of zone.hou
│ │ │ │ -000243c0: 7273 2061 6e64 204d 4d20 6973 2061 206e  rs and MM is a n
│ │ │ │ -000243d0: 756d 6265 7220 6f66 207a 6f6e 6520 6d69  umber of zone mi
│ │ │ │ -000243e0: 6e75 7465 732e 2020 5468 6520 7a6f 6e65  nutes.  The zone
│ │ │ │ -000243f0: 206d 696e 7574 6573 2074 6572 6d2c 204d   minutes term, M
│ │ │ │ -00024400: 4d2c 0a6d 6179 2062 6520 6f6d 6974 7465  M,.may be omitte
│ │ │ │ -00024410: 642c 2069 6e20 7768 6963 6820 6361 7365  d, in which case
│ │ │ │ -00024420: 2074 6865 206f 6e65 2d20 6f72 2074 776f   the one- or two
│ │ │ │ -00024430: 2d64 6967 6974 2063 6f72 7265 6374 696f  -digit correctio
│ │ │ │ -00024440: 6e20 6973 0a69 6e74 6572 7072 6574 6564  n is.interpreted
│ │ │ │ -00024450: 2061 7320 6120 6e75 6d62 6572 206f 6620   as a number of 
│ │ │ │ -00024460: 686f 7572 732e 2020 596f 7520 6361 6e20  hours.  You can 
│ │ │ │ -00024470: 616c 736f 2073 6570 6172 6174 6520 4848  also separate HH
│ │ │ │ -00024480: 2066 726f 6d20 4d4d 2077 6974 680a 6120   from MM with.a 
│ │ │ │ -00024490: 636f 6c6f 6e2e 2020 5768 656e 2061 2074  colon.  When a t
│ │ │ │ -000244a0: 696d 6520 7a6f 6e65 2063 6f72 7265 6374  ime zone correct
│ │ │ │ -000244b0: 696f 6e20 6973 2067 6976 656e 2074 6869  ion is given thi
│ │ │ │ -000244c0: 7320 7761 792c 2069 7420 666f 7263 6573  s way, it forces
│ │ │ │ -000244d0: 0a69 6e74 6572 7072 6574 6174 696f 6e20  .interpretation 
│ │ │ │ -000244e0: 6f66 2074 6865 2074 696d 6520 7265 6c61  of the time rela
│ │ │ │ -000244f0: 7469 7665 2074 6f20 436f 6f72 6469 6e61  tive to Coordina
│ │ │ │ -00024500: 7465 6420 556e 6976 6572 7361 6c20 5469  ted Universal Ti
│ │ │ │ -00024510: 6d65 2028 5554 4329 2c0a 6f76 6572 7269  me (UTC),.overri
│ │ │ │ -00024520: 6469 6e67 2061 6e79 2070 7265 7669 6f75  ding any previou
│ │ │ │ -00024530: 7320 7370 6563 6966 6963 6174 696f 6e20  s specification 
│ │ │ │ -00024540: 666f 7220 7468 6520 7469 6d65 207a 6f6e  for the time zon
│ │ │ │ -00024550: 6520 6f72 2074 6865 206c 6f63 616c 0a74  e or the local.t
│ │ │ │ -00024560: 696d 6520 7a6f 6e65 2e20 2046 6f72 2065  ime zone.  For e
│ │ │ │ -00024570: 7861 6d70 6c65 2c20 e280 982b 3035 3330  xample, ...+0530
│ │ │ │ -00024580: e280 9920 616e 6420 e280 982b 3035 3a33  ... and ...+05:3
│ │ │ │ -00024590: 30e2 8099 2062 6f74 6820 7374 616e 6420  0... both stand 
│ │ │ │ -000245a0: 666f 7220 7468 6520 7469 6d65 0a7a 6f6e  for the time.zon
│ │ │ │ -000245b0: 6520 352e 3520 686f 7572 7320 6168 6561  e 5.5 hours ahea
│ │ │ │ -000245c0: 6420 6f66 2055 5443 2028 652e 672e 2c20  d of UTC (e.g., 
│ │ │ │ -000245d0: 496e 6469 6129 2e20 2054 6869 7320 6973  India).  This is
│ │ │ │ -000245e0: 2074 6865 2062 6573 7420 7761 7920 746f   the best way to
│ │ │ │ -000245f0: 0a73 7065 6369 6679 2061 2074 696d 6520  .specify a time 
│ │ │ │ -00024600: 7a6f 6e65 2063 6f72 7265 6374 696f 6e20  zone correction 
│ │ │ │ -00024610: 6279 2066 7261 6374 696f 6e61 6c20 7061  by fractional pa
│ │ │ │ -00024620: 7274 7320 6f66 2061 6e20 686f 7572 2e20  rts of an hour. 
│ │ │ │ -00024630: 2054 6865 0a6d 6178 696d 756d 207a 6f6e   The.maximum zon
│ │ │ │ -00024640: 6520 636f 7272 6563 7469 6f6e 2069 7320  e correction is 
│ │ │ │ -00024650: 3234 2068 6f75 7273 2e0a 0a20 2020 4569  24 hours...   Ei
│ │ │ │ -00024660: 7468 6572 20e2 8098 616d e280 992f e280  ther ...am.../..
│ │ │ │ -00024670: 9870 6de2 8099 206f 7220 6120 7469 6d65  .pm... or a time
│ │ │ │ -00024680: 207a 6f6e 6520 636f 7272 6563 7469 6f6e   zone correction
│ │ │ │ -00024690: 206d 6179 2062 6520 7370 6563 6966 6965   may be specifie
│ │ │ │ -000246a0: 642c 2062 7574 206e 6f74 0a62 6f74 682e  d, but not.both.
│ │ │ │ -000246b0: 0a0a 1f0a 4669 6c65 3a20 7368 6973 6869  ....File: shishi
│ │ │ │ -000246c0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 5469  .info,  Node: Ti
│ │ │ │ -000246d0: 6d65 207a 6f6e 6520 6974 656d 732c 2020  me zone items,  
│ │ │ │ -000246e0: 4e65 7874 3a20 436f 6d62 696e 6564 2064  Next: Combined d
│ │ │ │ -000246f0: 6174 6520 616e 6420 7469 6d65 206f 6620  ate and time of 
│ │ │ │ -00024700: 6461 7920 6974 656d 732c 2020 5072 6576  day items,  Prev
│ │ │ │ -00024710: 3a20 5469 6d65 206f 6620 6461 7920 6974  : Time of day it
│ │ │ │ -00024720: 656d 732c 2020 5570 3a20 4461 7465 2069  ems,  Up: Date i
│ │ │ │ -00024730: 6e70 7574 2066 6f72 6d61 7473 0a0a 342e  nput formats..4.
│ │ │ │ -00024740: 3130 2e34 2054 696d 6520 7a6f 6e65 2069  10.4 Time zone i
│ │ │ │ -00024750: 7465 6d73 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  tems.-----------
│ │ │ │ -00024760: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a41 20e2  -----------..A .
│ │ │ │ -00024770: 809c 7469 6d65 207a 6f6e 6520 6974 656d  ..time zone item
│ │ │ │ -00024780: e280 9d20 7370 6563 6966 6965 7320 616e  ... specifies an
│ │ │ │ -00024790: 2069 6e74 6572 6e61 7469 6f6e 616c 2074   international t
│ │ │ │ -000247a0: 696d 6520 7a6f 6e65 2c20 696e 6469 6361  ime zone, indica
│ │ │ │ -000247b0: 7465 6420 6279 2061 0a73 6d61 6c6c 2073  ted by a.small s
│ │ │ │ -000247c0: 6574 206f 6620 6c65 7474 6572 732c 2065  et of letters, e
│ │ │ │ -000247d0: 2e67 2e2c 20e2 8098 5554 43e2 8099 206f  .g., ...UTC... o
│ │ │ │ -000247e0: 7220 e280 985a e280 9920 666f 7220 436f  r ...Z... for Co
│ │ │ │ -000247f0: 6f72 6469 6e61 7465 6420 556e 6976 6572  ordinated Univer
│ │ │ │ -00024800: 7361 6c20 5469 6d65 2e0a 416e 7920 696e  sal Time..Any in
│ │ │ │ -00024810: 636c 7564 6564 2070 6572 696f 6473 2061  cluded periods a
│ │ │ │ -00024820: 7265 2069 676e 6f72 6564 2e20 2042 7920  re ignored.  By 
│ │ │ │ -00024830: 666f 6c6c 6f77 696e 6720 6120 6e6f 6e2d  following a non-
│ │ │ │ -00024840: 6461 796c 6967 6874 2d73 6176 696e 670a  daylight-saving.
│ │ │ │ -00024850: 7469 6d65 207a 6f6e 6520 6279 2074 6865  time zone by the
│ │ │ │ -00024860: 2073 7472 696e 6720 e280 9844 5354 e280   string ...DST..
│ │ │ │ -00024870: 9920 696e 2061 2073 6570 6172 6174 6520  . in a separate 
│ │ │ │ -00024880: 776f 7264 2028 7468 6174 2069 732c 2073  word (that is, s
│ │ │ │ -00024890: 6570 6172 6174 6564 2062 790a 736f 6d65  eparated by.some
│ │ │ │ -000248a0: 2077 6869 7465 2073 7061 6365 292c 2074   white space), t
│ │ │ │ -000248b0: 6865 2063 6f72 7265 7370 6f6e 6469 6e67  he corresponding
│ │ │ │ -000248c0: 2064 6179 6c69 6768 7420 7361 7669 6e67   daylight saving
│ │ │ │ -000248d0: 2074 696d 6520 7a6f 6e65 206d 6179 2062   time zone may b
│ │ │ │ -000248e0: 650a 7370 6563 6966 6965 642e 2020 416c  e.specified.  Al
│ │ │ │ -000248f0: 7465 726e 6174 6976 656c 792c 2061 206e  ternatively, a n
│ │ │ │ -00024900: 6f6e 2d64 6179 6c69 6768 742d 7361 7669  on-daylight-savi
│ │ │ │ -00024910: 6e67 2074 696d 6520 7a6f 6e65 2063 616e  ng time zone can
│ │ │ │ -00024920: 2062 650a 666f 6c6c 6f77 6564 2062 7920   be.followed by 
│ │ │ │ -00024930: 6120 7469 6d65 207a 6f6e 6520 636f 7272  a time zone corr
│ │ │ │ -00024940: 6563 7469 6f6e 2c20 746f 2061 6464 2074  ection, to add t
│ │ │ │ -00024950: 6865 2074 776f 2076 616c 7565 732e 2020  he two values.  
│ │ │ │ -00024960: 5468 6973 2069 730a 6e6f 726d 616c 6c79  This is.normally
│ │ │ │ -00024970: 2064 6f6e 6520 6f6e 6c79 2066 6f72 20e2   done only for .
│ │ │ │ -00024980: 8098 5554 43e2 8099 3b20 666f 7220 6578  ..UTC...; for ex
│ │ │ │ -00024990: 616d 706c 652c 20e2 8098 5554 432b 3035  ample, ...UTC+05
│ │ │ │ -000249a0: 3a33 30e2 8099 2069 7320 6571 7569 7661  :30... is equiva
│ │ │ │ -000249b0: 6c65 6e74 2074 6f0a e280 982b 3035 3a33  lent to....+05:3
│ │ │ │ -000249c0: 30e2 8099 2e0a 0a20 2020 5469 6d65 207a  0......   Time z
│ │ │ │ -000249d0: 6f6e 6520 6974 656d 7320 6f74 6865 7220  one items other 
│ │ │ │ -000249e0: 7468 616e 20e2 8098 5554 43e2 8099 2061  than ...UTC... a
│ │ │ │ -000249f0: 6e64 20e2 8098 5ae2 8099 2061 7265 206f  nd ...Z... are o
│ │ │ │ -00024a00: 6273 6f6c 6573 6365 6e74 2061 6e64 2061  bsolescent and a
│ │ │ │ -00024a10: 7265 206e 6f74 0a72 6563 6f6d 6d65 6e64  re not.recommend
│ │ │ │ -00024a20: 6564 2c20 6265 6361 7573 6520 7468 6579  ed, because they
│ │ │ │ -00024a30: 2061 7265 2061 6d62 6967 756f 7573 3b20   are ambiguous; 
│ │ │ │ -00024a40: 666f 7220 6578 616d 706c 652c 20e2 8098  for example, ...
│ │ │ │ -00024a50: 4553 54e2 8099 2068 6173 2061 0a64 6966  EST... has a.dif
│ │ │ │ -00024a60: 6665 7265 6e74 206d 6561 6e69 6e67 2069  ferent meaning i
│ │ │ │ -00024a70: 6e20 4175 7374 7261 6c69 6120 7468 616e  n Australia than
│ │ │ │ -00024a80: 2069 6e20 7468 6520 556e 6974 6564 2053   in the United S
│ │ │ │ -00024a90: 7461 7465 732c 2061 6e64 20e2 8098 41e2  tates, and ...A.
│ │ │ │ -00024aa0: 8099 2068 6173 0a64 6966 6665 7265 6e74  .. has.different
│ │ │ │ -00024ab0: 206d 6561 6e69 6e67 2061 7320 6120 6d69   meaning as a mi
│ │ │ │ -00024ac0: 6c69 7461 7279 2074 696d 6520 7a6f 6e65  litary time zone
│ │ │ │ -00024ad0: 2074 6861 6e20 6173 2061 6e20 6f62 736f   than as an obso
│ │ │ │ -00024ae0: 6c65 7465 2052 4643 2038 3232 0a74 696d  lete RFC 822.tim
│ │ │ │ -00024af0: 6520 7a6f 6e65 2e20 2049 6e73 7465 6164  e zone.  Instead
│ │ │ │ -00024b00: 2c20 6974 2773 2062 6574 7465 7220 746f  , it's better to
│ │ │ │ -00024b10: 2075 7365 2075 6e61 6d62 6967 756f 7573   use unambiguous
│ │ │ │ -00024b20: 206e 756d 6572 6963 2074 696d 6520 7a6f   numeric time zo
│ │ │ │ -00024b30: 6e65 0a63 6f72 7265 6374 696f 6e73 206c  ne.corrections l
│ │ │ │ -00024b40: 696b 6520 e280 982d 3035 3030 e280 992c  ike ...-0500...,
│ │ │ │ -00024b50: 2061 7320 6465 7363 7269 6265 6420 696e   as described in
│ │ │ │ -00024b60: 2074 6865 2070 7265 7669 6f75 7320 7365   the previous se
│ │ │ │ -00024b70: 6374 696f 6e2e 0a0a 2020 2049 6620 6e65  ction...   If ne
│ │ │ │ -00024b80: 6974 6865 7220 6120 7469 6d65 207a 6f6e  ither a time zon
│ │ │ │ -00024b90: 6520 6974 656d 206e 6f72 2061 2074 696d  e item nor a tim
│ │ │ │ -00024ba0: 6520 7a6f 6e65 2063 6f72 7265 6374 696f  e zone correctio
│ │ │ │ -00024bb0: 6e20 6973 2073 7570 706c 6965 642c 0a74  n is supplied,.t
│ │ │ │ -00024bc0: 696d 6573 7461 6d70 7320 6172 6520 696e  imestamps are in
│ │ │ │ -00024bd0: 7465 7270 7265 7465 6420 7573 696e 6720  terpreted using 
│ │ │ │ -00024be0: 7468 6520 7275 6c65 7320 6f66 2074 6865  the rules of the
│ │ │ │ -00024bf0: 2064 6566 6175 6c74 2074 696d 6520 7a6f   default time zo
│ │ │ │ -00024c00: 6e65 0a28 2a6e 6f74 6520 5370 6563 6966  ne.(*note Specif
│ │ │ │ -00024c10: 7969 6e67 2074 696d 6520 7a6f 6e65 2072  ying time zone r
│ │ │ │ -00024c20: 756c 6573 3a3a 292e 0a0a 1f0a 4669 6c65  ules::).....File
│ │ │ │ -00024c30: 3a20 7368 6973 6869 2e69 6e66 6f2c 2020  : shishi.info,  
│ │ │ │ -00024c40: 4e6f 6465 3a20 436f 6d62 696e 6564 2064  Node: Combined d
│ │ │ │ -00024c50: 6174 6520 616e 6420 7469 6d65 206f 6620  ate and time of 
│ │ │ │ -00024c60: 6461 7920 6974 656d 732c 2020 4e65 7874  day items,  Next
│ │ │ │ -00024c70: 3a20 4461 7920 6f66 2077 6565 6b20 6974  : Day of week it
│ │ │ │ -00024c80: 656d 732c 2020 5072 6576 3a20 5469 6d65  ems,  Prev: Time
│ │ │ │ -00024c90: 207a 6f6e 6520 6974 656d 732c 2020 5570   zone items,  Up
│ │ │ │ -00024ca0: 3a20 4461 7465 2069 6e70 7574 2066 6f72  : Date input for
│ │ │ │ -00024cb0: 6d61 7473 0a0a 342e 3130 2e35 2043 6f6d  mats..4.10.5 Com
│ │ │ │ -00024cc0: 6269 6e65 6420 6461 7465 2061 6e64 2074  bined date and t
│ │ │ │ -00024cd0: 696d 6520 6f66 2064 6179 2069 7465 6d73  ime of day items
│ │ │ │ -00024ce0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ +000236a0: 2d2d 2d2d 2d2d 0a0a 4120 e280 9c63 616c  ------..A ...cal
│ │ │ │ +000236b0: 656e 6461 7220 6461 7465 2069 7465 6de2  endar date item.
│ │ │ │ +000236c0: 809d 2073 7065 6369 6669 6573 2061 2064  .. specifies a d
│ │ │ │ +000236d0: 6179 206f 6620 7468 6520 7965 6172 2e20  ay of the year. 
│ │ │ │ +000236e0: 2049 7420 6973 2073 7065 6369 6669 6564   It is specified
│ │ │ │ +000236f0: 0a64 6966 6665 7265 6e74 6c79 2c20 6465  .differently, de
│ │ │ │ +00023700: 7065 6e64 696e 6720 6f6e 2077 6865 7468  pending on wheth
│ │ │ │ +00023710: 6572 2074 6865 206d 6f6e 7468 2069 7320  er the month is 
│ │ │ │ +00023720: 7370 6563 6966 6965 6420 6e75 6d65 7269  specified numeri
│ │ │ │ +00023730: 6361 6c6c 7920 6f72 0a6c 6974 6572 616c  cally or.literal
│ │ │ │ +00023740: 6c79 2e20 2041 6c6c 2074 6865 7365 2073  ly.  All these s
│ │ │ │ +00023750: 7472 696e 6773 2073 7065 6369 6679 2074  trings specify t
│ │ │ │ +00023760: 6865 2073 616d 6520 6361 6c65 6e64 6172  he same calendar
│ │ │ │ +00023770: 2064 6174 653a 0a0a 2020 2020 2032 3032   date:..     202
│ │ │ │ +00023780: 302d 3037 2d32 3020 2020 2020 2320 4953  0-07-20     # IS
│ │ │ │ +00023790: 4f20 3836 3031 2e0a 2020 2020 2032 302d  O 8601..     20-
│ │ │ │ +000237a0: 372d 3230 2020 2020 2020 2020 2320 4173  7-20        # As
│ │ │ │ +000237b0: 7375 6d65 2031 3978 7820 666f 7220 3639  sume 19xx for 69
│ │ │ │ +000237c0: 2074 6872 6f75 6768 2039 392c 0a20 2020   through 99,.   
│ │ │ │ +000237d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +000237e0: 2023 2032 3078 7820 666f 7220 3030 2074   # 20xx for 00 t
│ │ │ │ +000237f0: 6872 6f75 6768 2036 3820 286e 6f74 2072  hrough 68 (not r
│ │ │ │ +00023800: 6563 6f6d 6d65 6e64 6564 292e 0a20 2020  ecommended)..   
│ │ │ │ +00023810: 2020 372f 3230 2f32 3032 3020 2020 2020    7/20/2020     
│ │ │ │ +00023820: 2023 2043 6f6d 6d6f 6e20 552e 532e 2077   # Common U.S. w
│ │ │ │ +00023830: 7269 7469 6e67 2e0a 2020 2020 2032 3020  riting..     20 
│ │ │ │ +00023840: 4a75 6c79 2032 3032 300a 2020 2020 2032  July 2020.     2
│ │ │ │ +00023850: 3020 4a75 6c20 3230 3230 2020 2020 2320  0 Jul 2020    # 
│ │ │ │ +00023860: 5468 7265 652d 6c65 7474 6572 2061 6262  Three-letter abb
│ │ │ │ +00023870: 7265 7669 6174 696f 6e73 2061 6c77 6179  reviations alway
│ │ │ │ +00023880: 7320 616c 6c6f 7765 642e 0a20 2020 2020  s allowed..     
│ │ │ │ +00023890: 4a75 6c20 3230 2c20 3230 3230 0a20 2020  Jul 20, 2020.   
│ │ │ │ +000238a0: 2020 3230 2d6a 756c 2d32 3032 300a 2020    20-jul-2020.  
│ │ │ │ +000238b0: 2020 2032 306a 756c 3230 3230 0a0a 2020     20jul2020..  
│ │ │ │ +000238c0: 2054 6865 2079 6561 7220 6361 6e20 616c   The year can al
│ │ │ │ +000238d0: 736f 2062 6520 6f6d 6974 7465 642e 2020  so be omitted.  
│ │ │ │ +000238e0: 496e 2074 6869 7320 6361 7365 2c20 7468  In this case, th
│ │ │ │ +000238f0: 6520 6c61 7374 2073 7065 6369 6669 6564  e last specified
│ │ │ │ +00023900: 2079 6561 720a 6973 2075 7365 642c 206f   year.is used, o
│ │ │ │ +00023910: 7220 7468 6520 6375 7272 656e 7420 7965  r the current ye
│ │ │ │ +00023920: 6172 2069 6620 6e6f 6e65 2e20 2046 6f72  ar if none.  For
│ │ │ │ +00023930: 2065 7861 6d70 6c65 3a0a 0a20 2020 2020   example:..     
│ │ │ │ +00023940: 372f 3230 0a20 2020 2020 6a75 6c20 3230  7/20.     jul 20
│ │ │ │ +00023950: 0a0a 2020 2048 6572 6520 6172 6520 7468  ..   Here are th
│ │ │ │ +00023960: 6520 7275 6c65 732e 0a0a 2020 2046 6f72  e rules...   For
│ │ │ │ +00023970: 206e 756d 6572 6963 206d 6f6e 7468 732c   numeric months,
│ │ │ │ +00023980: 2074 6865 2049 534f 2038 3630 3120 666f   the ISO 8601 fo
│ │ │ │ +00023990: 726d 6174 20e2 8098 5945 4152 2d4d 4f4e  rmat ...YEAR-MON
│ │ │ │ +000239a0: 5448 2d44 4159 e280 9920 6973 2061 6c6c  TH-DAY... is all
│ │ │ │ +000239b0: 6f77 6564 2c0a 7768 6572 6520 5945 4152  owed,.where YEAR
│ │ │ │ +000239c0: 2069 7320 616e 7920 706f 7369 7469 7665   is any positive
│ │ │ │ +000239d0: 206e 756d 6265 722c 204d 4f4e 5448 2069   number, MONTH i
│ │ │ │ +000239e0: 7320 6120 6e75 6d62 6572 2062 6574 7765  s a number betwe
│ │ │ │ +000239f0: 656e 2030 3120 616e 6420 3132 2c0a 616e  en 01 and 12,.an
│ │ │ │ +00023a00: 6420 4441 5920 6973 2061 206e 756d 6265  d DAY is a numbe
│ │ │ │ +00023a10: 7220 6265 7477 6565 6e20 3031 2061 6e64  r between 01 and
│ │ │ │ +00023a20: 2033 312e 2020 4120 6c65 6164 696e 6720   31.  A leading 
│ │ │ │ +00023a30: 7a65 726f 206d 7573 7420 6265 2070 7265  zero must be pre
│ │ │ │ +00023a40: 7365 6e74 0a69 6620 6120 6e75 6d62 6572  sent.if a number
│ │ │ │ +00023a50: 2069 7320 6c65 7373 2074 6861 6e20 7465   is less than te
│ │ │ │ +00023a60: 6e2e 2020 4966 2059 4541 5220 6973 2036  n.  If YEAR is 6
│ │ │ │ +00023a70: 3820 6f72 2073 6d61 6c6c 6572 2c20 7468  8 or smaller, th
│ │ │ │ +00023a80: 656e 2032 3030 3020 6973 0a61 6464 6564  en 2000 is.added
│ │ │ │ +00023a90: 2074 6f20 6974 3b20 6f74 6865 7277 6973   to it; otherwis
│ │ │ │ +00023aa0: 652c 2069 6620 5945 4152 2069 7320 6c65  e, if YEAR is le
│ │ │ │ +00023ab0: 7373 2074 6861 6e20 3130 302c 2074 6865  ss than 100, the
│ │ │ │ +00023ac0: 6e20 3139 3030 2069 7320 6164 6465 6420  n 1900 is added 
│ │ │ │ +00023ad0: 746f 0a69 742e 2020 5468 6520 636f 6e73  to.it.  The cons
│ │ │ │ +00023ae0: 7472 7563 7420 e280 984d 4f4e 5448 2f44  truct ...MONTH/D
│ │ │ │ +00023af0: 4159 2f59 4541 52e2 8099 2c20 706f 7075  AY/YEAR..., popu
│ │ │ │ +00023b00: 6c61 7220 696e 2074 6865 2055 6e69 7465  lar in the Unite
│ │ │ │ +00023b10: 6420 5374 6174 6573 2c20 6973 0a61 6363  d States, is.acc
│ │ │ │ +00023b20: 6570 7465 642e 2020 416c 736f 20e2 8098  epted.  Also ...
│ │ │ │ +00023b30: 4d4f 4e54 482f 4441 59e2 8099 2c20 6f6d  MONTH/DAY..., om
│ │ │ │ +00023b40: 6974 7469 6e67 2074 6865 2079 6561 722e  itting the year.
│ │ │ │ +00023b50: 0a0a 2020 204c 6974 6572 616c 206d 6f6e  ..   Literal mon
│ │ │ │ +00023b60: 7468 7320 6d61 7920 6265 2073 7065 6c6c  ths may be spell
│ │ │ │ +00023b70: 6564 206f 7574 2069 6e20 6675 6c6c 3a20  ed out in full: 
│ │ │ │ +00023b80: e280 984a 616e 7561 7279 e280 992c 20e2  ...January..., .
│ │ │ │ +00023b90: 8098 4665 6272 7561 7279 e280 992c 0ae2  ..February...,..
│ │ │ │ +00023ba0: 8098 4d61 7263 68e2 8099 2c20 e280 9841  ..March..., ...A
│ │ │ │ +00023bb0: 7072 696c e280 992c 20e2 8098 4d61 79e2  pril..., ...May.
│ │ │ │ +00023bc0: 8099 2c20 e280 984a 756e 65e2 8099 2c20  .., ...June..., 
│ │ │ │ +00023bd0: e280 984a 756c 79e2 8099 2c20 e280 9841  ...July..., ...A
│ │ │ │ +00023be0: 7567 7573 74e2 8099 2c20 e280 9853 6570  ugust..., ...Sep
│ │ │ │ +00023bf0: 7465 6d62 6572 e280 992c 0ae2 8098 4f63  tember...,....Oc
│ │ │ │ +00023c00: 746f 6265 72e2 8099 2c20 e280 984e 6f76  tober..., ...Nov
│ │ │ │ +00023c10: 656d 6265 72e2 8099 206f 7220 e280 9844  ember... or ...D
│ │ │ │ +00023c20: 6563 656d 6265 72e2 8099 2e20 204c 6974  ecember....  Lit
│ │ │ │ +00023c30: 6572 616c 206d 6f6e 7468 7320 6d61 7920  eral months may 
│ │ │ │ +00023c40: 6265 2061 6262 7265 7669 6174 6564 0a74  be abbreviated.t
│ │ │ │ +00023c50: 6f20 7468 6569 7220 6669 7273 7420 7468  o their first th
│ │ │ │ +00023c60: 7265 6520 6c65 7474 6572 732c 2070 6f73  ree letters, pos
│ │ │ │ +00023c70: 7369 626c 7920 666f 6c6c 6f77 6564 2062  sibly followed b
│ │ │ │ +00023c80: 7920 616e 2061 6262 7265 7669 6174 696e  y an abbreviatin
│ │ │ │ +00023c90: 6720 646f 742e 0a49 7420 6973 2061 6c73  g dot..It is als
│ │ │ │ +00023ca0: 6f20 7065 726d 6974 7465 6420 746f 2077  o permitted to w
│ │ │ │ +00023cb0: 7269 7465 20e2 8098 5365 7074 e280 9920  rite ...Sept... 
│ │ │ │ +00023cc0: 696e 7374 6561 6420 6f66 20e2 8098 5365  instead of ...Se
│ │ │ │ +00023cd0: 7074 656d 6265 72e2 8099 2e0a 0a20 2020  ptember......   
│ │ │ │ +00023ce0: 5768 656e 206d 6f6e 7468 7320 6172 6520  When months are 
│ │ │ │ +00023cf0: 7772 6974 7465 6e20 6c69 7465 7261 6c6c  written literall
│ │ │ │ +00023d00: 792c 2074 6865 2063 616c 656e 6461 7220  y, the calendar 
│ │ │ │ +00023d10: 6461 7465 206d 6179 2062 6520 6769 7665  date may be give
│ │ │ │ +00023d20: 6e20 6173 0a61 6e79 206f 6620 7468 6520  n as.any of the 
│ │ │ │ +00023d30: 666f 6c6c 6f77 696e 673a 0a0a 2020 2020  following:..    
│ │ │ │ +00023d40: 2044 4159 204d 4f4e 5448 2059 4541 520a   DAY MONTH YEAR.
│ │ │ │ +00023d50: 2020 2020 2044 4159 204d 4f4e 5448 0a20       DAY MONTH. 
│ │ │ │ +00023d60: 2020 2020 4d4f 4e54 4820 4441 5920 5945      MONTH DAY YE
│ │ │ │ +00023d70: 4152 0a20 2020 2020 4441 592d 4d4f 4e54  AR.     DAY-MONT
│ │ │ │ +00023d80: 482d 5945 4152 0a0a 2020 204f 722c 206f  H-YEAR..   Or, o
│ │ │ │ +00023d90: 6d69 7474 696e 6720 7468 6520 7965 6172  mitting the year
│ │ │ │ +00023da0: 3a0a 0a20 2020 2020 4d4f 4e54 4820 4441  :..     MONTH DA
│ │ │ │ +00023db0: 590a 0a1f 0a46 696c 653a 2073 6869 7368  Y....File: shish
│ │ │ │ +00023dc0: 692e 696e 666f 2c20 204e 6f64 653a 2054  i.info,  Node: T
│ │ │ │ +00023dd0: 696d 6520 6f66 2064 6179 2069 7465 6d73  ime of day items
│ │ │ │ +00023de0: 2c20 204e 6578 743a 2054 696d 6520 7a6f  ,  Next: Time zo
│ │ │ │ +00023df0: 6e65 2069 7465 6d73 2c20 2050 7265 763a  ne items,  Prev:
│ │ │ │ +00023e00: 2043 616c 656e 6461 7220 6461 7465 2069   Calendar date i
│ │ │ │ +00023e10: 7465 6d73 2c20 2055 703a 2044 6174 6520  tems,  Up: Date 
│ │ │ │ +00023e20: 696e 7075 7420 666f 726d 6174 730a 0a34  input formats..4
│ │ │ │ +00023e30: 2e31 302e 3320 5469 6d65 206f 6620 6461  .10.3 Time of da
│ │ │ │ +00023e40: 7920 6974 656d 730a 2d2d 2d2d 2d2d 2d2d  y items.--------
│ │ │ │ +00023e50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +00023e60: 0a0a 4120 e280 9c74 696d 6520 6f66 2064  ..A ...time of d
│ │ │ │ +00023e70: 6179 2069 7465 6de2 809d 2069 6e20 6461  ay item... in da
│ │ │ │ +00023e80: 7465 2073 7472 696e 6773 2073 7065 6369  te strings speci
│ │ │ │ +00023e90: 6669 6573 2074 6865 2074 696d 6520 6f6e  fies the time on
│ │ │ │ +00023ea0: 2061 2067 6976 656e 2064 6179 2e0a 4865   a given day..He
│ │ │ │ +00023eb0: 7265 2061 7265 2073 6f6d 6520 6578 616d  re are some exam
│ │ │ │ +00023ec0: 706c 6573 2c20 616c 6c20 6f66 2077 6869  ples, all of whi
│ │ │ │ +00023ed0: 6368 2072 6570 7265 7365 6e74 2074 6865  ch represent the
│ │ │ │ +00023ee0: 2073 616d 6520 7469 6d65 3a0a 0a20 2020   same time:..   
│ │ │ │ +00023ef0: 2020 3230 3a30 323a 3030 2e30 3030 3030    20:02:00.00000
│ │ │ │ +00023f00: 300a 2020 2020 2032 303a 3032 0a20 2020  0.     20:02.   
│ │ │ │ +00023f10: 2020 383a 3032 706d 0a20 2020 2020 3230    8:02pm.     20
│ │ │ │ +00023f20: 3a30 322d 3035 3030 2020 2020 2020 2320  :02-0500      # 
│ │ │ │ +00023f30: 496e 2045 5354 2028 552e 532e 2045 6173  In EST (U.S. Eas
│ │ │ │ +00023f40: 7465 726e 2053 7461 6e64 6172 6420 5469  tern Standard Ti
│ │ │ │ +00023f50: 6d65 292e 0a0a 2020 204d 6f72 6520 6765  me)...   More ge
│ │ │ │ +00023f60: 6e65 7261 6c6c 792c 2074 6865 2074 696d  nerally, the tim
│ │ │ │ +00023f70: 6520 6f66 2064 6179 206d 6179 2062 6520  e of day may be 
│ │ │ │ +00023f80: 6769 7665 6e20 6173 20e2 8098 484f 5552  given as ...HOUR
│ │ │ │ +00023f90: 3a4d 494e 5554 453a 5345 434f 4e44 e280  :MINUTE:SECOND..
│ │ │ │ +00023fa0: 992c 0a77 6865 7265 2048 4f55 5220 6973  .,.where HOUR is
│ │ │ │ +00023fb0: 2061 206e 756d 6265 7220 6265 7477 6565   a number betwee
│ │ │ │ +00023fc0: 6e20 3020 616e 6420 3233 2c20 4d49 4e55  n 0 and 23, MINU
│ │ │ │ +00023fd0: 5445 2069 7320 6120 6e75 6d62 6572 2062  TE is a number b
│ │ │ │ +00023fe0: 6574 7765 656e 2030 0a61 6e64 2035 392c  etween 0.and 59,
│ │ │ │ +00023ff0: 2061 6e64 2053 4543 4f4e 4420 6973 2061   and SECOND is a
│ │ │ │ +00024000: 206e 756d 6265 7220 6265 7477 6565 6e20   number between 
│ │ │ │ +00024010: 3020 616e 6420 3539 2070 6f73 7369 626c  0 and 59 possibl
│ │ │ │ +00024020: 7920 666f 6c6c 6f77 6564 2062 7920 e280  y followed by ..
│ │ │ │ +00024030: 982e e280 990a 6f72 20e2 8098 2ce2 8099  ......or ...,...
│ │ │ │ +00024040: 2061 6e64 2061 2066 7261 6374 696f 6e20   and a fraction 
│ │ │ │ +00024050: 636f 6e74 6169 6e69 6e67 206f 6e65 206f  containing one o
│ │ │ │ +00024060: 7220 6d6f 7265 2064 6967 6974 732e 2020  r more digits.  
│ │ │ │ +00024070: 416c 7465 726e 6174 6976 656c 792c 0ae2  Alternatively,..
│ │ │ │ +00024080: 8098 3a53 4543 4f4e 44e2 8099 2063 616e  ..:SECOND... can
│ │ │ │ +00024090: 2062 6520 6f6d 6974 7465 642c 2069 6e20   be omitted, in 
│ │ │ │ +000240a0: 7768 6963 6820 6361 7365 2069 7420 6973  which case it is
│ │ │ │ +000240b0: 2074 616b 656e 2074 6f20 6265 207a 6572   taken to be zer
│ │ │ │ +000240c0: 6f2e 2020 4f6e 2074 6865 0a72 6172 6520  o.  On the.rare 
│ │ │ │ +000240d0: 686f 7374 7320 7468 6174 2073 7570 706f  hosts that suppo
│ │ │ │ +000240e0: 7274 206c 6561 7020 7365 636f 6e64 732c  rt leap seconds,
│ │ │ │ +000240f0: 2053 4543 4f4e 4420 6d61 7920 6265 2036   SECOND may be 6
│ │ │ │ +00024100: 302e 0a0a 2020 2049 6620 7468 6520 7469  0...   If the ti
│ │ │ │ +00024110: 6d65 2069 7320 666f 6c6c 6f77 6564 2062  me is followed b
│ │ │ │ +00024120: 7920 e280 9861 6de2 8099 206f 7220 e280  y ...am... or ..
│ │ │ │ +00024130: 9870 6de2 8099 2028 6f72 20e2 8098 612e  .pm... (or ...a.
│ │ │ │ +00024140: 6d2e e280 9920 6f72 20e2 8098 702e 6d2e  m.... or ...p.m.
│ │ │ │ +00024150: e280 9929 2c20 484f 5552 0a69 7320 7265  ...), HOUR.is re
│ │ │ │ +00024160: 7374 7269 6374 6564 2074 6f20 7275 6e20  stricted to run 
│ │ │ │ +00024170: 6672 6f6d 2031 2074 6f20 3132 2c20 616e  from 1 to 12, an
│ │ │ │ +00024180: 6420 e280 983a 4d49 4e55 5445 e280 9920  d ...:MINUTE... 
│ │ │ │ +00024190: 6d61 7920 6265 206f 6d69 7474 6564 2028  may be omitted (
│ │ │ │ +000241a0: 7461 6b65 6e0a 746f 2062 6520 7a65 726f  taken.to be zero
│ │ │ │ +000241b0: 292e 2020 e280 9861 6de2 8099 2069 6e64  ).  ...am... ind
│ │ │ │ +000241c0: 6963 6174 6573 2074 6865 2066 6972 7374  icates the first
│ │ │ │ +000241d0: 2068 616c 6620 6f66 2074 6865 2064 6179   half of the day
│ │ │ │ +000241e0: 2c20 e280 9870 6de2 8099 2069 6e64 6963  , ...pm... indic
│ │ │ │ +000241f0: 6174 6573 0a74 6865 2073 6563 6f6e 6420  ates.the second 
│ │ │ │ +00024200: 6861 6c66 206f 6620 7468 6520 6461 792e  half of the day.
│ │ │ │ +00024210: 2020 496e 2074 6869 7320 6e6f 7461 7469    In this notati
│ │ │ │ +00024220: 6f6e 2c20 3132 2069 7320 7468 6520 7072  on, 12 is the pr
│ │ │ │ +00024230: 6564 6563 6573 736f 7220 6f66 0a31 3a20  edecessor of.1: 
│ │ │ │ +00024240: 6d69 646e 6967 6874 2069 7320 e280 9831  midnight is ...1
│ │ │ │ +00024250: 3261 6de2 8099 2077 6869 6c65 206e 6f6f  2am... while noo
│ │ │ │ +00024260: 6e20 6973 20e2 8098 3132 706d e280 992e  n is ...12pm....
│ │ │ │ +00024270: 2020 2854 6869 7320 6973 2074 6865 207a    (This is the z
│ │ │ │ +00024280: 6572 6f2d 6f72 6965 6e74 6564 0a69 6e74  ero-oriented.int
│ │ │ │ +00024290: 6572 7072 6574 6174 696f 6e20 6f66 20e2  erpretation of .
│ │ │ │ +000242a0: 8098 3132 616d e280 9920 616e 6420 e280  ..12am... and ..
│ │ │ │ +000242b0: 9831 3270 6de2 8099 2c20 6173 206f 7070  .12pm..., as opp
│ │ │ │ +000242c0: 6f73 6564 2074 6f20 7468 6520 6f6c 6420  osed to the old 
│ │ │ │ +000242d0: 7472 6164 6974 696f 6e0a 6465 7269 7665  tradition.derive
│ │ │ │ +000242e0: 6420 6672 6f6d 204c 6174 696e 2077 6869  d from Latin whi
│ │ │ │ +000242f0: 6368 2075 7365 7320 e280 9831 326d e280  ch uses ...12m..
│ │ │ │ +00024300: 9920 666f 7220 6e6f 6f6e 2061 6e64 20e2  . for noon and .
│ │ │ │ +00024310: 8098 3132 706d e280 9920 666f 7220 6d69  ..12pm... for mi
│ │ │ │ +00024320: 646e 6967 6874 2e29 0a0a 2020 2054 6865  dnight.)..   The
│ │ │ │ +00024330: 2074 696d 6520 6d61 7920 616c 7465 726e   time may altern
│ │ │ │ +00024340: 6174 6976 656c 7920 6265 2066 6f6c 6c6f  atively be follo
│ │ │ │ +00024350: 7765 6420 6279 2061 2074 696d 6520 7a6f  wed by a time zo
│ │ │ │ +00024360: 6e65 2063 6f72 7265 6374 696f 6e2c 0a65  ne correction,.e
│ │ │ │ +00024370: 7870 7265 7373 6564 2061 7320 e280 9853  xpressed as ...S
│ │ │ │ +00024380: 4848 4d4d e280 992c 2077 6865 7265 2053  HHMM..., where S
│ │ │ │ +00024390: 2069 7320 e280 982b e280 9920 6f72 20e2   is ...+... or .
│ │ │ │ +000243a0: 8098 2de2 8099 2c20 4848 2069 7320 6120  ..-..., HH is a 
│ │ │ │ +000243b0: 6e75 6d62 6572 206f 6620 7a6f 6e65 0a68  number of zone.h
│ │ │ │ +000243c0: 6f75 7273 2061 6e64 204d 4d20 6973 2061  ours and MM is a
│ │ │ │ +000243d0: 206e 756d 6265 7220 6f66 207a 6f6e 6520   number of zone 
│ │ │ │ +000243e0: 6d69 6e75 7465 732e 2020 5468 6520 7a6f  minutes.  The zo
│ │ │ │ +000243f0: 6e65 206d 696e 7574 6573 2074 6572 6d2c  ne minutes term,
│ │ │ │ +00024400: 204d 4d2c 0a6d 6179 2062 6520 6f6d 6974   MM,.may be omit
│ │ │ │ +00024410: 7465 642c 2069 6e20 7768 6963 6820 6361  ted, in which ca
│ │ │ │ +00024420: 7365 2074 6865 206f 6e65 2d20 6f72 2074  se the one- or t
│ │ │ │ +00024430: 776f 2d64 6967 6974 2063 6f72 7265 6374  wo-digit correct
│ │ │ │ +00024440: 696f 6e20 6973 0a69 6e74 6572 7072 6574  ion is.interpret
│ │ │ │ +00024450: 6564 2061 7320 6120 6e75 6d62 6572 206f  ed as a number o
│ │ │ │ +00024460: 6620 686f 7572 732e 2020 596f 7520 6361  f hours.  You ca
│ │ │ │ +00024470: 6e20 616c 736f 2073 6570 6172 6174 6520  n also separate 
│ │ │ │ +00024480: 4848 2066 726f 6d20 4d4d 2077 6974 680a  HH from MM with.
│ │ │ │ +00024490: 6120 636f 6c6f 6e2e 2020 5768 656e 2061  a colon.  When a
│ │ │ │ +000244a0: 2074 696d 6520 7a6f 6e65 2063 6f72 7265   time zone corre
│ │ │ │ +000244b0: 6374 696f 6e20 6973 2067 6976 656e 2074  ction is given t
│ │ │ │ +000244c0: 6869 7320 7761 792c 2069 7420 666f 7263  his way, it forc
│ │ │ │ +000244d0: 6573 0a69 6e74 6572 7072 6574 6174 696f  es.interpretatio
│ │ │ │ +000244e0: 6e20 6f66 2074 6865 2074 696d 6520 7265  n of the time re
│ │ │ │ +000244f0: 6c61 7469 7665 2074 6f20 436f 6f72 6469  lative to Coordi
│ │ │ │ +00024500: 6e61 7465 6420 556e 6976 6572 7361 6c20  nated Universal 
│ │ │ │ +00024510: 5469 6d65 2028 5554 4329 2c0a 6f76 6572  Time (UTC),.over
│ │ │ │ +00024520: 7269 6469 6e67 2061 6e79 2070 7265 7669  riding any previ
│ │ │ │ +00024530: 6f75 7320 7370 6563 6966 6963 6174 696f  ous specificatio
│ │ │ │ +00024540: 6e20 666f 7220 7468 6520 7469 6d65 207a  n for the time z
│ │ │ │ +00024550: 6f6e 6520 6f72 2074 6865 206c 6f63 616c  one or the local
│ │ │ │ +00024560: 0a74 696d 6520 7a6f 6e65 2e20 2046 6f72  .time zone.  For
│ │ │ │ +00024570: 2065 7861 6d70 6c65 2c20 e280 982b 3035   example, ...+05
│ │ │ │ +00024580: 3330 e280 9920 616e 6420 e280 982b 3035  30... and ...+05
│ │ │ │ +00024590: 3a33 30e2 8099 2062 6f74 6820 7374 616e  :30... both stan
│ │ │ │ +000245a0: 6420 666f 7220 7468 6520 7469 6d65 0a7a  d for the time.z
│ │ │ │ +000245b0: 6f6e 6520 352e 3520 686f 7572 7320 6168  one 5.5 hours ah
│ │ │ │ +000245c0: 6561 6420 6f66 2055 5443 2028 652e 672e  ead of UTC (e.g.
│ │ │ │ +000245d0: 2c20 496e 6469 6129 2e20 2054 6869 7320  , India).  This 
│ │ │ │ +000245e0: 6973 2074 6865 2062 6573 7420 7761 7920  is the best way 
│ │ │ │ +000245f0: 746f 0a73 7065 6369 6679 2061 2074 696d  to.specify a tim
│ │ │ │ +00024600: 6520 7a6f 6e65 2063 6f72 7265 6374 696f  e zone correctio
│ │ │ │ +00024610: 6e20 6279 2066 7261 6374 696f 6e61 6c20  n by fractional 
│ │ │ │ +00024620: 7061 7274 7320 6f66 2061 6e20 686f 7572  parts of an hour
│ │ │ │ +00024630: 2e20 2054 6865 0a6d 6178 696d 756d 207a  .  The.maximum z
│ │ │ │ +00024640: 6f6e 6520 636f 7272 6563 7469 6f6e 2069  one correction i
│ │ │ │ +00024650: 7320 3234 2068 6f75 7273 2e0a 0a20 2020  s 24 hours...   
│ │ │ │ +00024660: 4569 7468 6572 20e2 8098 616d e280 992f  Either ...am.../
│ │ │ │ +00024670: e280 9870 6de2 8099 206f 7220 6120 7469  ...pm... or a ti
│ │ │ │ +00024680: 6d65 207a 6f6e 6520 636f 7272 6563 7469  me zone correcti
│ │ │ │ +00024690: 6f6e 206d 6179 2062 6520 7370 6563 6966  on may be specif
│ │ │ │ +000246a0: 6965 642c 2062 7574 206e 6f74 0a62 6f74  ied, but not.bot
│ │ │ │ +000246b0: 682e 0a0a 1f0a 4669 6c65 3a20 7368 6973  h.....File: shis
│ │ │ │ +000246c0: 6869 2e69 6e66 6f2c 2020 4e6f 6465 3a20  hi.info,  Node: 
│ │ │ │ +000246d0: 5469 6d65 207a 6f6e 6520 6974 656d 732c  Time zone items,
│ │ │ │ +000246e0: 2020 4e65 7874 3a20 436f 6d62 696e 6564    Next: Combined
│ │ │ │ +000246f0: 2064 6174 6520 616e 6420 7469 6d65 206f   date and time o
│ │ │ │ +00024700: 6620 6461 7920 6974 656d 732c 2020 5072  f day items,  Pr
│ │ │ │ +00024710: 6576 3a20 5469 6d65 206f 6620 6461 7920  ev: Time of day 
│ │ │ │ +00024720: 6974 656d 732c 2020 5570 3a20 4461 7465  items,  Up: Date
│ │ │ │ +00024730: 2069 6e70 7574 2066 6f72 6d61 7473 0a0a   input formats..
│ │ │ │ +00024740: 342e 3130 2e34 2054 696d 6520 7a6f 6e65  4.10.4 Time zone
│ │ │ │ +00024750: 2069 7465 6d73 0a2d 2d2d 2d2d 2d2d 2d2d   items.---------
│ │ │ │ +00024760: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a41  -------------..A
│ │ │ │ +00024770: 20e2 809c 7469 6d65 207a 6f6e 6520 6974   ...time zone it
│ │ │ │ +00024780: 656d e280 9d20 7370 6563 6966 6965 7320  em... specifies 
│ │ │ │ +00024790: 616e 2069 6e74 6572 6e61 7469 6f6e 616c  an international
│ │ │ │ +000247a0: 2074 696d 6520 7a6f 6e65 2c20 696e 6469   time zone, indi
│ │ │ │ +000247b0: 6361 7465 6420 6279 2061 0a73 6d61 6c6c  cated by a.small
│ │ │ │ +000247c0: 2073 6574 206f 6620 6c65 7474 6572 732c   set of letters,
│ │ │ │ +000247d0: 2065 2e67 2e2c 20e2 8098 5554 43e2 8099   e.g., ...UTC...
│ │ │ │ +000247e0: 206f 7220 e280 985a e280 9920 666f 7220   or ...Z... for 
│ │ │ │ +000247f0: 436f 6f72 6469 6e61 7465 6420 556e 6976  Coordinated Univ
│ │ │ │ +00024800: 6572 7361 6c20 5469 6d65 2e0a 416e 7920  ersal Time..Any 
│ │ │ │ +00024810: 696e 636c 7564 6564 2070 6572 696f 6473  included periods
│ │ │ │ +00024820: 2061 7265 2069 676e 6f72 6564 2e20 2042   are ignored.  B
│ │ │ │ +00024830: 7920 666f 6c6c 6f77 696e 6720 6120 6e6f  y following a no
│ │ │ │ +00024840: 6e2d 6461 796c 6967 6874 2d73 6176 696e  n-daylight-savin
│ │ │ │ +00024850: 670a 7469 6d65 207a 6f6e 6520 6279 2074  g.time zone by t
│ │ │ │ +00024860: 6865 2073 7472 696e 6720 e280 9844 5354  he string ...DST
│ │ │ │ +00024870: e280 9920 696e 2061 2073 6570 6172 6174  ... in a separat
│ │ │ │ +00024880: 6520 776f 7264 2028 7468 6174 2069 732c  e word (that is,
│ │ │ │ +00024890: 2073 6570 6172 6174 6564 2062 790a 736f   separated by.so
│ │ │ │ +000248a0: 6d65 2077 6869 7465 2073 7061 6365 292c  me white space),
│ │ │ │ +000248b0: 2074 6865 2063 6f72 7265 7370 6f6e 6469   the correspondi
│ │ │ │ +000248c0: 6e67 2064 6179 6c69 6768 7420 7361 7669  ng daylight savi
│ │ │ │ +000248d0: 6e67 2074 696d 6520 7a6f 6e65 206d 6179  ng time zone may
│ │ │ │ +000248e0: 2062 650a 7370 6563 6966 6965 642e 2020   be.specified.  
│ │ │ │ +000248f0: 416c 7465 726e 6174 6976 656c 792c 2061  Alternatively, a
│ │ │ │ +00024900: 206e 6f6e 2d64 6179 6c69 6768 742d 7361   non-daylight-sa
│ │ │ │ +00024910: 7669 6e67 2074 696d 6520 7a6f 6e65 2063  ving time zone c
│ │ │ │ +00024920: 616e 2062 650a 666f 6c6c 6f77 6564 2062  an be.followed b
│ │ │ │ +00024930: 7920 6120 7469 6d65 207a 6f6e 6520 636f  y a time zone co
│ │ │ │ +00024940: 7272 6563 7469 6f6e 2c20 746f 2061 6464  rrection, to add
│ │ │ │ +00024950: 2074 6865 2074 776f 2076 616c 7565 732e   the two values.
│ │ │ │ +00024960: 2020 5468 6973 2069 730a 6e6f 726d 616c    This is.normal
│ │ │ │ +00024970: 6c79 2064 6f6e 6520 6f6e 6c79 2066 6f72  ly done only for
│ │ │ │ +00024980: 20e2 8098 5554 43e2 8099 3b20 666f 7220   ...UTC...; for 
│ │ │ │ +00024990: 6578 616d 706c 652c 20e2 8098 5554 432b  example, ...UTC+
│ │ │ │ +000249a0: 3035 3a33 30e2 8099 2069 7320 6571 7569  05:30... is equi
│ │ │ │ +000249b0: 7661 6c65 6e74 2074 6f0a e280 982b 3035  valent to....+05
│ │ │ │ +000249c0: 3a33 30e2 8099 2e0a 0a20 2020 5469 6d65  :30......   Time
│ │ │ │ +000249d0: 207a 6f6e 6520 6974 656d 7320 6f74 6865   zone items othe
│ │ │ │ +000249e0: 7220 7468 616e 20e2 8098 5554 43e2 8099  r than ...UTC...
│ │ │ │ +000249f0: 2061 6e64 20e2 8098 5ae2 8099 2061 7265   and ...Z... are
│ │ │ │ +00024a00: 206f 6273 6f6c 6573 6365 6e74 2061 6e64   obsolescent and
│ │ │ │ +00024a10: 2061 7265 206e 6f74 0a72 6563 6f6d 6d65   are not.recomme
│ │ │ │ +00024a20: 6e64 6564 2c20 6265 6361 7573 6520 7468  nded, because th
│ │ │ │ +00024a30: 6579 2061 7265 2061 6d62 6967 756f 7573  ey are ambiguous
│ │ │ │ +00024a40: 3b20 666f 7220 6578 616d 706c 652c 20e2  ; for example, .
│ │ │ │ +00024a50: 8098 4553 54e2 8099 2068 6173 2061 0a64  ..EST... has a.d
│ │ │ │ +00024a60: 6966 6665 7265 6e74 206d 6561 6e69 6e67  ifferent meaning
│ │ │ │ +00024a70: 2069 6e20 4175 7374 7261 6c69 6120 7468   in Australia th
│ │ │ │ +00024a80: 616e 2069 6e20 7468 6520 556e 6974 6564  an in the United
│ │ │ │ +00024a90: 2053 7461 7465 732c 2061 6e64 20e2 8098   States, and ...
│ │ │ │ +00024aa0: 41e2 8099 2068 6173 0a64 6966 6665 7265  A... has.differe
│ │ │ │ +00024ab0: 6e74 206d 6561 6e69 6e67 2061 7320 6120  nt meaning as a 
│ │ │ │ +00024ac0: 6d69 6c69 7461 7279 2074 696d 6520 7a6f  military time zo
│ │ │ │ +00024ad0: 6e65 2074 6861 6e20 6173 2061 6e20 6f62  ne than as an ob
│ │ │ │ +00024ae0: 736f 6c65 7465 2052 4643 2038 3232 0a74  solete RFC 822.t
│ │ │ │ +00024af0: 696d 6520 7a6f 6e65 2e20 2049 6e73 7465  ime zone.  Inste
│ │ │ │ +00024b00: 6164 2c20 6974 2773 2062 6574 7465 7220  ad, it's better 
│ │ │ │ +00024b10: 746f 2075 7365 2075 6e61 6d62 6967 756f  to use unambiguo
│ │ │ │ +00024b20: 7573 206e 756d 6572 6963 2074 696d 6520  us numeric time 
│ │ │ │ +00024b30: 7a6f 6e65 0a63 6f72 7265 6374 696f 6e73  zone.corrections
│ │ │ │ +00024b40: 206c 696b 6520 e280 982d 3035 3030 e280   like ...-0500..
│ │ │ │ +00024b50: 992c 2061 7320 6465 7363 7269 6265 6420  ., as described 
│ │ │ │ +00024b60: 696e 2074 6865 2070 7265 7669 6f75 7320  in the previous 
│ │ │ │ +00024b70: 7365 6374 696f 6e2e 0a0a 2020 2049 6620  section...   If 
│ │ │ │ +00024b80: 6e65 6974 6865 7220 6120 7469 6d65 207a  neither a time z
│ │ │ │ +00024b90: 6f6e 6520 6974 656d 206e 6f72 2061 2074  one item nor a t
│ │ │ │ +00024ba0: 696d 6520 7a6f 6e65 2063 6f72 7265 6374  ime zone correct
│ │ │ │ +00024bb0: 696f 6e20 6973 2073 7570 706c 6965 642c  ion is supplied,
│ │ │ │ +00024bc0: 0a74 696d 6573 7461 6d70 7320 6172 6520  .timestamps are 
│ │ │ │ +00024bd0: 696e 7465 7270 7265 7465 6420 7573 696e  interpreted usin
│ │ │ │ +00024be0: 6720 7468 6520 7275 6c65 7320 6f66 2074  g the rules of t
│ │ │ │ +00024bf0: 6865 2064 6566 6175 6c74 2074 696d 6520  he default time 
│ │ │ │ +00024c00: 7a6f 6e65 0a28 2a6e 6f74 6520 5370 6563  zone.(*note Spec
│ │ │ │ +00024c10: 6966 7969 6e67 2074 696d 6520 7a6f 6e65  ifying time zone
│ │ │ │ +00024c20: 2072 756c 6573 3a3a 292e 0a0a 1f0a 4669   rules::).....Fi
│ │ │ │ +00024c30: 6c65 3a20 7368 6973 6869 2e69 6e66 6f2c  le: shishi.info,
│ │ │ │ +00024c40: 2020 4e6f 6465 3a20 436f 6d62 696e 6564    Node: Combined
│ │ │ │ +00024c50: 2064 6174 6520 616e 6420 7469 6d65 206f   date and time o
│ │ │ │ +00024c60: 6620 6461 7920 6974 656d 732c 2020 4e65  f day items,  Ne
│ │ │ │ +00024c70: 7874 3a20 4461 7920 6f66 2077 6565 6b20  xt: Day of week 
│ │ │ │ +00024c80: 6974 656d 732c 2020 5072 6576 3a20 5469  items,  Prev: Ti
│ │ │ │ +00024c90: 6d65 207a 6f6e 6520 6974 656d 732c 2020  me zone items,  
│ │ │ │ +00024ca0: 5570 3a20 4461 7465 2069 6e70 7574 2066  Up: Date input f
│ │ │ │ +00024cb0: 6f72 6d61 7473 0a0a 342e 3130 2e35 2043  ormats..4.10.5 C
│ │ │ │ +00024cc0: 6f6d 6269 6e65 6420 6461 7465 2061 6e64  ombined date and
│ │ │ │ +00024cd0: 2074 696d 6520 6f66 2064 6179 2069 7465   time of day ite
│ │ │ │ +00024ce0: 6d73 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ms.-------------
│ │ │ │  00024cf0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00024d00: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a54 6865  -----------..The
│ │ │ │ -00024d10: 2049 534f 2038 3630 3120 6461 7465 2061   ISO 8601 date a
│ │ │ │ -00024d20: 6e64 2074 696d 6520 6f66 2064 6179 2065  nd time of day e
│ │ │ │ -00024d30: 7874 656e 6465 6420 666f 726d 6174 2063  xtended format c
│ │ │ │ -00024d40: 6f6e 7369 7374 7320 6f66 2061 6e20 4953  onsists of an IS
│ │ │ │ -00024d50: 4f0a 3836 3031 2064 6174 652c 2061 20e2  O.8601 date, a .
│ │ │ │ -00024d60: 8098 54e2 8099 2063 6861 7261 6374 6572  ..T... character
│ │ │ │ -00024d70: 2073 6570 6172 6174 6f72 2c20 616e 6420   separator, and 
│ │ │ │ -00024d80: 616e 2049 534f 2038 3630 3120 7469 6d65  an ISO 8601 time
│ │ │ │ -00024d90: 206f 6620 6461 792e 2020 5468 6973 0a66   of day.  This.f
│ │ │ │ -00024da0: 6f72 6d61 7420 6973 2061 6c73 6f20 7265  ormat is also re
│ │ │ │ -00024db0: 636f 676e 697a 6564 2069 6620 7468 6520  cognized if the 
│ │ │ │ -00024dc0: e280 9854 e280 9920 6973 2072 6570 6c61  ...T... is repla
│ │ │ │ -00024dd0: 6365 6420 6279 2061 2073 7061 6365 2e0a  ced by a space..
│ │ │ │ -00024de0: 0a20 2020 496e 2074 6869 7320 666f 726d  .   In this form
│ │ │ │ -00024df0: 6174 2c20 7468 6520 7469 6d65 206f 6620  at, the time of 
│ │ │ │ -00024e00: 6461 7920 7368 6f75 6c64 2075 7365 2032  day should use 2
│ │ │ │ -00024e10: 342d 686f 7572 206e 6f74 6174 696f 6e2e  4-hour notation.
│ │ │ │ -00024e20: 0a46 7261 6374 696f 6e61 6c20 7365 636f  .Fractional seco
│ │ │ │ -00024e30: 6e64 7320 6172 6520 616c 6c6f 7765 642c  nds are allowed,
│ │ │ │ -00024e40: 2077 6974 6820 6569 7468 6572 2063 6f6d   with either com
│ │ │ │ -00024e50: 6d61 206f 7220 7065 7269 6f64 2070 7265  ma or period pre
│ │ │ │ -00024e60: 6365 6469 6e67 0a74 6865 2066 7261 6374  ceding.the fract
│ │ │ │ -00024e70: 696f 6e2e 2020 4953 4f20 3836 3031 2066  ion.  ISO 8601 f
│ │ │ │ -00024e80: 7261 6374 696f 6e61 6c20 6d69 6e75 7465  ractional minute
│ │ │ │ -00024e90: 7320 616e 6420 686f 7572 7320 6172 6520  s and hours are 
│ │ │ │ -00024ea0: 6e6f 7420 7375 7070 6f72 7465 642e 0a54  not supported..T
│ │ │ │ -00024eb0: 7970 6963 616c 6c79 2c20 686f 7374 7320  ypically, hosts 
│ │ │ │ -00024ec0: 7375 7070 6f72 7420 6e61 6e6f 7365 636f  support nanoseco
│ │ │ │ -00024ed0: 6e64 2074 696d 6573 7461 6d70 2072 6573  nd timestamp res
│ │ │ │ -00024ee0: 6f6c 7574 696f 6e3b 2065 7863 6573 730a  olution; excess.
│ │ │ │ -00024ef0: 7072 6563 6973 696f 6e20 6973 2073 696c  precision is sil
│ │ │ │ -00024f00: 656e 746c 7920 6469 7363 6172 6465 642e  ently discarded.
│ │ │ │ -00024f10: 0a0a 2020 2048 6572 6520 6172 6520 736f  ..   Here are so
│ │ │ │ -00024f20: 6d65 2065 7861 6d70 6c65 733a 0a0a 2020  me examples:..  
│ │ │ │ -00024f30: 2020 2032 3031 322d 3039 2d32 3454 3230     2012-09-24T20
│ │ │ │ -00024f40: 3a30 323a 3030 2e30 3532 2d30 353a 3030  :02:00.052-05:00
│ │ │ │ -00024f50: 0a20 2020 2020 3230 3132 2d31 322d 3331  .     2012-12-31
│ │ │ │ -00024f60: 5432 333a 3539 3a35 392c 3939 3939 3939  T23:59:59,999999
│ │ │ │ -00024f70: 3939 392b 3131 3a30 300a 2020 2020 2031  999+11:00.     1
│ │ │ │ -00024f80: 3937 302d 3031 2d30 3120 3030 3a30 305a  970-01-01 00:00Z
│ │ │ │ -00024f90: 0a0a 1f0a 4669 6c65 3a20 7368 6973 6869  ....File: shishi
│ │ │ │ -00024fa0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 4461  .info,  Node: Da
│ │ │ │ -00024fb0: 7920 6f66 2077 6565 6b20 6974 656d 732c  y of week items,
│ │ │ │ -00024fc0: 2020 4e65 7874 3a20 5265 6c61 7469 7665    Next: Relative
│ │ │ │ -00024fd0: 2069 7465 6d73 2069 6e20 6461 7465 2073   items in date s
│ │ │ │ -00024fe0: 7472 696e 6773 2c20 2050 7265 763a 2043  trings,  Prev: C
│ │ │ │ -00024ff0: 6f6d 6269 6e65 6420 6461 7465 2061 6e64  ombined date and
│ │ │ │ -00025000: 2074 696d 6520 6f66 2064 6179 2069 7465   time of day ite
│ │ │ │ -00025010: 6d73 2c20 2055 703a 2044 6174 6520 696e  ms,  Up: Date in
│ │ │ │ -00025020: 7075 7420 666f 726d 6174 730a 0a34 2e31  put formats..4.1
│ │ │ │ -00025030: 302e 3620 4461 7920 6f66 2077 6565 6b20  0.6 Day of week 
│ │ │ │ -00025040: 6974 656d 730a 2d2d 2d2d 2d2d 2d2d 2d2d  items.----------
│ │ │ │ -00025050: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -00025060: 5468 6520 6578 706c 6963 6974 206d 656e  The explicit men
│ │ │ │ -00025070: 7469 6f6e 206f 6620 6120 6461 7920 6f66  tion of a day of
│ │ │ │ -00025080: 2074 6865 2077 6565 6b20 7769 6c6c 2066   the week will f
│ │ │ │ -00025090: 6f72 7761 7264 2074 6865 2064 6174 6520  orward the date 
│ │ │ │ -000250a0: 286f 6e6c 7920 6966 0a6e 6563 6573 7361  (only if.necessa
│ │ │ │ -000250b0: 7279 2920 746f 2072 6561 6368 2074 6861  ry) to reach tha
│ │ │ │ -000250c0: 7420 6461 7920 6f66 2074 6865 2077 6565  t day of the wee
│ │ │ │ -000250d0: 6b20 696e 2074 6865 2066 7574 7572 652e  k in the future.
│ │ │ │ -000250e0: 0a0a 2020 2044 6179 7320 6f66 2074 6865  ..   Days of the
│ │ │ │ -000250f0: 2077 6565 6b20 6d61 7920 6265 2073 7065   week may be spe
│ │ │ │ -00025100: 6c6c 6564 206f 7574 2069 6e20 6675 6c6c  lled out in full
│ │ │ │ -00025110: 3a20 e280 9853 756e 6461 79e2 8099 2c20  : ...Sunday..., 
│ │ │ │ -00025120: e280 984d 6f6e 6461 79e2 8099 2c0a e280  ...Monday...,...
│ │ │ │ -00025130: 9854 7565 7364 6179 e280 992c 20e2 8098  .Tuesday..., ...
│ │ │ │ -00025140: 5765 646e 6573 6461 79e2 8099 2c20 e280  Wednesday..., ..
│ │ │ │ -00025150: 9854 6875 7273 6461 79e2 8099 2c20 e280  .Thursday..., ..
│ │ │ │ -00025160: 9846 7269 6461 79e2 8099 206f 7220 e280  .Friday... or ..
│ │ │ │ -00025170: 9853 6174 7572 6461 79e2 8099 2e20 2044  .Saturday....  D
│ │ │ │ -00025180: 6179 7320 6d61 7920 6265 0a61 6262 7265  ays may be.abbre
│ │ │ │ -00025190: 7669 6174 6564 2074 6f20 7468 6569 7220  viated to their 
│ │ │ │ -000251a0: 6669 7273 7420 7468 7265 6520 6c65 7474  first three lett
│ │ │ │ -000251b0: 6572 732c 206f 7074 696f 6e61 6c6c 7920  ers, optionally 
│ │ │ │ -000251c0: 666f 6c6c 6f77 6564 2062 7920 610a 7065  followed by a.pe
│ │ │ │ -000251d0: 7269 6f64 2e20 2054 6865 2073 7065 6369  riod.  The speci
│ │ │ │ -000251e0: 616c 2061 6262 7265 7669 6174 696f 6e73  al abbreviations
│ │ │ │ -000251f0: 20e2 8098 5475 6573 e280 9920 666f 7220   ...Tues... for 
│ │ │ │ -00025200: e280 9854 7565 7364 6179 e280 992c 20e2  ...Tuesday..., .
│ │ │ │ -00025210: 8098 5765 646e 6573 e280 9920 666f 720a  ..Wednes... for.
│ │ │ │ -00025220: e280 9857 6564 6e65 7364 6179 e280 9920  ...Wednesday... 
│ │ │ │ -00025230: 616e 6420 e280 9854 6875 72e2 8099 206f  and ...Thur... o
│ │ │ │ -00025240: 7220 e280 9854 6875 7273 e280 9920 666f  r ...Thurs... fo
│ │ │ │ -00025250: 7220 e280 9854 6875 7273 6461 79e2 8099  r ...Thursday...
│ │ │ │ -00025260: 2061 7265 2061 6c73 6f20 616c 6c6f 7765   are also allowe
│ │ │ │ -00025270: 642e 0a0a 2020 2041 206e 756d 6265 7220  d...   A number 
│ │ │ │ -00025280: 6d61 7920 7072 6563 6564 6520 6120 6461  may precede a da
│ │ │ │ -00025290: 7920 6f66 2074 6865 2077 6565 6b20 6974  y of the week it
│ │ │ │ -000252a0: 656d 2074 6f20 6d6f 7665 2066 6f72 7761  em to move forwa
│ │ │ │ -000252b0: 7264 0a73 7570 706c 656d 656e 7461 7279  rd.supplementary
│ │ │ │ -000252c0: 2077 6565 6b73 2e20 2049 7420 6973 2062   weeks.  It is b
│ │ │ │ -000252d0: 6573 7420 7573 6564 2069 6e20 6578 7072  est used in expr
│ │ │ │ -000252e0: 6573 7369 6f6e 206c 696b 6520 e280 9874  ession like ...t
│ │ │ │ -000252f0: 6869 7264 206d 6f6e 6461 79e2 8099 2e0a  hird monday.....
│ │ │ │ -00025300: 496e 2074 6869 7320 636f 6e74 6578 742c  In this context,
│ │ │ │ -00025310: 20e2 8098 6c61 7374 2044 4159 e280 9920   ...last DAY... 
│ │ │ │ -00025320: 6f72 20e2 8098 6e65 7874 2044 4159 e280  or ...next DAY..
│ │ │ │ -00025330: 9920 6973 2061 6c73 6f20 6163 6365 7074  . is also accept
│ │ │ │ -00025340: 6162 6c65 3b20 7468 6579 206d 6f76 650a  able; they move.
│ │ │ │ -00025350: 6f6e 6520 7765 656b 2062 6566 6f72 6520  one week before 
│ │ │ │ -00025360: 6f72 2061 6674 6572 2074 6865 2064 6179  or after the day
│ │ │ │ -00025370: 2074 6861 7420 4441 5920 6279 2069 7473   that DAY by its
│ │ │ │ -00025380: 656c 6620 776f 756c 6420 7265 7072 6573  elf would repres
│ │ │ │ -00025390: 656e 742e 0a0a 2020 2041 2063 6f6d 6d61  ent...   A comma
│ │ │ │ -000253a0: 2066 6f6c 6c6f 7769 6e67 2061 2064 6179   following a day
│ │ │ │ -000253b0: 206f 6620 7468 6520 7765 656b 2069 7465   of the week ite
│ │ │ │ -000253c0: 6d20 6973 2069 676e 6f72 6564 2e0a 0a1f  m is ignored....
│ │ │ │ -000253d0: 0a46 696c 653a 2073 6869 7368 692e 696e  .File: shishi.in
│ │ │ │ -000253e0: 666f 2c20 204e 6f64 653a 2052 656c 6174  fo,  Node: Relat
│ │ │ │ -000253f0: 6976 6520 6974 656d 7320 696e 2064 6174  ive items in dat
│ │ │ │ -00025400: 6520 7374 7269 6e67 732c 2020 4e65 7874  e strings,  Next
│ │ │ │ -00025410: 3a20 5075 7265 206e 756d 6265 7273 2069  : Pure numbers i
│ │ │ │ -00025420: 6e20 6461 7465 2073 7472 696e 6773 2c20  n date strings, 
│ │ │ │ -00025430: 2050 7265 763a 2044 6179 206f 6620 7765   Prev: Day of we
│ │ │ │ -00025440: 656b 2069 7465 6d73 2c20 2055 703a 2044  ek items,  Up: D
│ │ │ │ -00025450: 6174 6520 696e 7075 7420 666f 726d 6174  ate input format
│ │ │ │ -00025460: 730a 0a34 2e31 302e 3720 5265 6c61 7469  s..4.10.7 Relati
│ │ │ │ -00025470: 7665 2069 7465 6d73 2069 6e20 6461 7465  ve items in date
│ │ │ │ -00025480: 2073 7472 696e 6773 0a2d 2d2d 2d2d 2d2d   strings.-------
│ │ │ │ +00024d00: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a54  -------------..T
│ │ │ │ +00024d10: 6865 2049 534f 2038 3630 3120 6461 7465  he ISO 8601 date
│ │ │ │ +00024d20: 2061 6e64 2074 696d 6520 6f66 2064 6179   and time of day
│ │ │ │ +00024d30: 2065 7874 656e 6465 6420 666f 726d 6174   extended format
│ │ │ │ +00024d40: 2063 6f6e 7369 7374 7320 6f66 2061 6e20   consists of an 
│ │ │ │ +00024d50: 4953 4f0a 3836 3031 2064 6174 652c 2061  ISO.8601 date, a
│ │ │ │ +00024d60: 20e2 8098 54e2 8099 2063 6861 7261 6374   ...T... charact
│ │ │ │ +00024d70: 6572 2073 6570 6172 6174 6f72 2c20 616e  er separator, an
│ │ │ │ +00024d80: 6420 616e 2049 534f 2038 3630 3120 7469  d an ISO 8601 ti
│ │ │ │ +00024d90: 6d65 206f 6620 6461 792e 2020 5468 6973  me of day.  This
│ │ │ │ +00024da0: 0a66 6f72 6d61 7420 6973 2061 6c73 6f20  .format is also 
│ │ │ │ +00024db0: 7265 636f 676e 697a 6564 2069 6620 7468  recognized if th
│ │ │ │ +00024dc0: 6520 e280 9854 e280 9920 6973 2072 6570  e ...T... is rep
│ │ │ │ +00024dd0: 6c61 6365 6420 6279 2061 2073 7061 6365  laced by a space
│ │ │ │ +00024de0: 2e0a 0a20 2020 496e 2074 6869 7320 666f  ...   In this fo
│ │ │ │ +00024df0: 726d 6174 2c20 7468 6520 7469 6d65 206f  rmat, the time o
│ │ │ │ +00024e00: 6620 6461 7920 7368 6f75 6c64 2075 7365  f day should use
│ │ │ │ +00024e10: 2032 342d 686f 7572 206e 6f74 6174 696f   24-hour notatio
│ │ │ │ +00024e20: 6e2e 0a46 7261 6374 696f 6e61 6c20 7365  n..Fractional se
│ │ │ │ +00024e30: 636f 6e64 7320 6172 6520 616c 6c6f 7765  conds are allowe
│ │ │ │ +00024e40: 642c 2077 6974 6820 6569 7468 6572 2063  d, with either c
│ │ │ │ +00024e50: 6f6d 6d61 206f 7220 7065 7269 6f64 2070  omma or period p
│ │ │ │ +00024e60: 7265 6365 6469 6e67 0a74 6865 2066 7261  receding.the fra
│ │ │ │ +00024e70: 6374 696f 6e2e 2020 4953 4f20 3836 3031  ction.  ISO 8601
│ │ │ │ +00024e80: 2066 7261 6374 696f 6e61 6c20 6d69 6e75   fractional minu
│ │ │ │ +00024e90: 7465 7320 616e 6420 686f 7572 7320 6172  tes and hours ar
│ │ │ │ +00024ea0: 6520 6e6f 7420 7375 7070 6f72 7465 642e  e not supported.
│ │ │ │ +00024eb0: 0a54 7970 6963 616c 6c79 2c20 686f 7374  .Typically, host
│ │ │ │ +00024ec0: 7320 7375 7070 6f72 7420 6e61 6e6f 7365  s support nanose
│ │ │ │ +00024ed0: 636f 6e64 2074 696d 6573 7461 6d70 2072  cond timestamp r
│ │ │ │ +00024ee0: 6573 6f6c 7574 696f 6e3b 2065 7863 6573  esolution; exces
│ │ │ │ +00024ef0: 730a 7072 6563 6973 696f 6e20 6973 2073  s.precision is s
│ │ │ │ +00024f00: 696c 656e 746c 7920 6469 7363 6172 6465  ilently discarde
│ │ │ │ +00024f10: 642e 0a0a 2020 2048 6572 6520 6172 6520  d...   Here are 
│ │ │ │ +00024f20: 736f 6d65 2065 7861 6d70 6c65 733a 0a0a  some examples:..
│ │ │ │ +00024f30: 2020 2020 2032 3031 322d 3039 2d32 3454       2012-09-24T
│ │ │ │ +00024f40: 3230 3a30 323a 3030 2e30 3532 2d30 353a  20:02:00.052-05:
│ │ │ │ +00024f50: 3030 0a20 2020 2020 3230 3132 2d31 322d  00.     2012-12-
│ │ │ │ +00024f60: 3331 5432 333a 3539 3a35 392c 3939 3939  31T23:59:59,9999
│ │ │ │ +00024f70: 3939 3939 392b 3131 3a30 300a 2020 2020  99999+11:00.    
│ │ │ │ +00024f80: 2031 3937 302d 3031 2d30 3120 3030 3a30   1970-01-01 00:0
│ │ │ │ +00024f90: 305a 0a0a 1f0a 4669 6c65 3a20 7368 6973  0Z....File: shis
│ │ │ │ +00024fa0: 6869 2e69 6e66 6f2c 2020 4e6f 6465 3a20  hi.info,  Node: 
│ │ │ │ +00024fb0: 4461 7920 6f66 2077 6565 6b20 6974 656d  Day of week item
│ │ │ │ +00024fc0: 732c 2020 4e65 7874 3a20 5265 6c61 7469  s,  Next: Relati
│ │ │ │ +00024fd0: 7665 2069 7465 6d73 2069 6e20 6461 7465  ve items in date
│ │ │ │ +00024fe0: 2073 7472 696e 6773 2c20 2050 7265 763a   strings,  Prev:
│ │ │ │ +00024ff0: 2043 6f6d 6269 6e65 6420 6461 7465 2061   Combined date a
│ │ │ │ +00025000: 6e64 2074 696d 6520 6f66 2064 6179 2069  nd time of day i
│ │ │ │ +00025010: 7465 6d73 2c20 2055 703a 2044 6174 6520  tems,  Up: Date 
│ │ │ │ +00025020: 696e 7075 7420 666f 726d 6174 730a 0a34  input formats..4
│ │ │ │ +00025030: 2e31 302e 3620 4461 7920 6f66 2077 6565  .10.6 Day of wee
│ │ │ │ +00025040: 6b20 6974 656d 730a 2d2d 2d2d 2d2d 2d2d  k items.--------
│ │ │ │ +00025050: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +00025060: 0a0a 5468 6520 6578 706c 6963 6974 206d  ..The explicit m
│ │ │ │ +00025070: 656e 7469 6f6e 206f 6620 6120 6461 7920  ention of a day 
│ │ │ │ +00025080: 6f66 2074 6865 2077 6565 6b20 7769 6c6c  of the week will
│ │ │ │ +00025090: 2066 6f72 7761 7264 2074 6865 2064 6174   forward the dat
│ │ │ │ +000250a0: 6520 286f 6e6c 7920 6966 0a6e 6563 6573  e (only if.neces
│ │ │ │ +000250b0: 7361 7279 2920 746f 2072 6561 6368 2074  sary) to reach t
│ │ │ │ +000250c0: 6861 7420 6461 7920 6f66 2074 6865 2077  hat day of the w
│ │ │ │ +000250d0: 6565 6b20 696e 2074 6865 2066 7574 7572  eek in the futur
│ │ │ │ +000250e0: 652e 0a0a 2020 2044 6179 7320 6f66 2074  e...   Days of t
│ │ │ │ +000250f0: 6865 2077 6565 6b20 6d61 7920 6265 2073  he week may be s
│ │ │ │ +00025100: 7065 6c6c 6564 206f 7574 2069 6e20 6675  pelled out in fu
│ │ │ │ +00025110: 6c6c 3a20 e280 9853 756e 6461 79e2 8099  ll: ...Sunday...
│ │ │ │ +00025120: 2c20 e280 984d 6f6e 6461 79e2 8099 2c0a  , ...Monday...,.
│ │ │ │ +00025130: e280 9854 7565 7364 6179 e280 992c 20e2  ...Tuesday..., .
│ │ │ │ +00025140: 8098 5765 646e 6573 6461 79e2 8099 2c20  ..Wednesday..., 
│ │ │ │ +00025150: e280 9854 6875 7273 6461 79e2 8099 2c20  ...Thursday..., 
│ │ │ │ +00025160: e280 9846 7269 6461 79e2 8099 206f 7220  ...Friday... or 
│ │ │ │ +00025170: e280 9853 6174 7572 6461 79e2 8099 2e20  ...Saturday.... 
│ │ │ │ +00025180: 2044 6179 7320 6d61 7920 6265 0a61 6262   Days may be.abb
│ │ │ │ +00025190: 7265 7669 6174 6564 2074 6f20 7468 6569  reviated to thei
│ │ │ │ +000251a0: 7220 6669 7273 7420 7468 7265 6520 6c65  r first three le
│ │ │ │ +000251b0: 7474 6572 732c 206f 7074 696f 6e61 6c6c  tters, optionall
│ │ │ │ +000251c0: 7920 666f 6c6c 6f77 6564 2062 7920 610a  y followed by a.
│ │ │ │ +000251d0: 7065 7269 6f64 2e20 2054 6865 2073 7065  period.  The spe
│ │ │ │ +000251e0: 6369 616c 2061 6262 7265 7669 6174 696f  cial abbreviatio
│ │ │ │ +000251f0: 6e73 20e2 8098 5475 6573 e280 9920 666f  ns ...Tues... fo
│ │ │ │ +00025200: 7220 e280 9854 7565 7364 6179 e280 992c  r ...Tuesday...,
│ │ │ │ +00025210: 20e2 8098 5765 646e 6573 e280 9920 666f   ...Wednes... fo
│ │ │ │ +00025220: 720a e280 9857 6564 6e65 7364 6179 e280  r....Wednesday..
│ │ │ │ +00025230: 9920 616e 6420 e280 9854 6875 72e2 8099  . and ...Thur...
│ │ │ │ +00025240: 206f 7220 e280 9854 6875 7273 e280 9920   or ...Thurs... 
│ │ │ │ +00025250: 666f 7220 e280 9854 6875 7273 6461 79e2  for ...Thursday.
│ │ │ │ +00025260: 8099 2061 7265 2061 6c73 6f20 616c 6c6f  .. are also allo
│ │ │ │ +00025270: 7765 642e 0a0a 2020 2041 206e 756d 6265  wed...   A numbe
│ │ │ │ +00025280: 7220 6d61 7920 7072 6563 6564 6520 6120  r may precede a 
│ │ │ │ +00025290: 6461 7920 6f66 2074 6865 2077 6565 6b20  day of the week 
│ │ │ │ +000252a0: 6974 656d 2074 6f20 6d6f 7665 2066 6f72  item to move for
│ │ │ │ +000252b0: 7761 7264 0a73 7570 706c 656d 656e 7461  ward.supplementa
│ │ │ │ +000252c0: 7279 2077 6565 6b73 2e20 2049 7420 6973  ry weeks.  It is
│ │ │ │ +000252d0: 2062 6573 7420 7573 6564 2069 6e20 6578   best used in ex
│ │ │ │ +000252e0: 7072 6573 7369 6f6e 206c 696b 6520 e280  pression like ..
│ │ │ │ +000252f0: 9874 6869 7264 206d 6f6e 6461 79e2 8099  .third monday...
│ │ │ │ +00025300: 2e0a 496e 2074 6869 7320 636f 6e74 6578  ..In this contex
│ │ │ │ +00025310: 742c 20e2 8098 6c61 7374 2044 4159 e280  t, ...last DAY..
│ │ │ │ +00025320: 9920 6f72 20e2 8098 6e65 7874 2044 4159  . or ...next DAY
│ │ │ │ +00025330: e280 9920 6973 2061 6c73 6f20 6163 6365  ... is also acce
│ │ │ │ +00025340: 7074 6162 6c65 3b20 7468 6579 206d 6f76  ptable; they mov
│ │ │ │ +00025350: 650a 6f6e 6520 7765 656b 2062 6566 6f72  e.one week befor
│ │ │ │ +00025360: 6520 6f72 2061 6674 6572 2074 6865 2064  e or after the d
│ │ │ │ +00025370: 6179 2074 6861 7420 4441 5920 6279 2069  ay that DAY by i
│ │ │ │ +00025380: 7473 656c 6620 776f 756c 6420 7265 7072  tself would repr
│ │ │ │ +00025390: 6573 656e 742e 0a0a 2020 2041 2063 6f6d  esent...   A com
│ │ │ │ +000253a0: 6d61 2066 6f6c 6c6f 7769 6e67 2061 2064  ma following a d
│ │ │ │ +000253b0: 6179 206f 6620 7468 6520 7765 656b 2069  ay of the week i
│ │ │ │ +000253c0: 7465 6d20 6973 2069 676e 6f72 6564 2e0a  tem is ignored..
│ │ │ │ +000253d0: 0a1f 0a46 696c 653a 2073 6869 7368 692e  ...File: shishi.
│ │ │ │ +000253e0: 696e 666f 2c20 204e 6f64 653a 2052 656c  info,  Node: Rel
│ │ │ │ +000253f0: 6174 6976 6520 6974 656d 7320 696e 2064  ative items in d
│ │ │ │ +00025400: 6174 6520 7374 7269 6e67 732c 2020 4e65  ate strings,  Ne
│ │ │ │ +00025410: 7874 3a20 5075 7265 206e 756d 6265 7273  xt: Pure numbers
│ │ │ │ +00025420: 2069 6e20 6461 7465 2073 7472 696e 6773   in date strings
│ │ │ │ +00025430: 2c20 2050 7265 763a 2044 6179 206f 6620  ,  Prev: Day of 
│ │ │ │ +00025440: 7765 656b 2069 7465 6d73 2c20 2055 703a  week items,  Up:
│ │ │ │ +00025450: 2044 6174 6520 696e 7075 7420 666f 726d   Date input form
│ │ │ │ +00025460: 6174 730a 0a34 2e31 302e 3720 5265 6c61  ats..4.10.7 Rela
│ │ │ │ +00025470: 7469 7665 2069 7465 6d73 2069 6e20 6461  tive items in da
│ │ │ │ +00025480: 7465 2073 7472 696e 6773 0a2d 2d2d 2d2d  te strings.-----
│ │ │ │  00025490: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000254a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -000254b0: e280 9c52 656c 6174 6976 6520 6974 656d  ...Relative item
│ │ │ │ -000254c0: 73e2 809d 2061 646a 7573 7420 6120 6461  s... adjust a da
│ │ │ │ -000254d0: 7465 2028 6f72 2074 6865 2063 7572 7265  te (or the curre
│ │ │ │ -000254e0: 6e74 2064 6174 6520 6966 206e 6f6e 6529  nt date if none)
│ │ │ │ -000254f0: 2066 6f72 7761 7264 206f 720a 6261 636b   forward or.back
│ │ │ │ -00025500: 7761 7264 2e20 2054 6865 2065 6666 6563  ward.  The effec
│ │ │ │ -00025510: 7473 206f 6620 7265 6c61 7469 7665 2069  ts of relative i
│ │ │ │ -00025520: 7465 6d73 2061 6363 756d 756c 6174 652e  tems accumulate.
│ │ │ │ -00025530: 2020 4865 7265 2061 7265 2073 6f6d 650a    Here are some.
│ │ │ │ -00025540: 6578 616d 706c 6573 3a0a 0a20 2020 2020  examples:..     
│ │ │ │ -00025550: 3120 7965 6172 0a20 2020 2020 3120 7965  1 year.     1 ye
│ │ │ │ -00025560: 6172 2061 676f 0a20 2020 2020 3320 7965  ar ago.     3 ye
│ │ │ │ -00025570: 6172 730a 2020 2020 2032 2064 6179 730a  ars.     2 days.
│ │ │ │ -00025580: 0a20 2020 5468 6520 756e 6974 206f 6620  .   The unit of 
│ │ │ │ -00025590: 7469 6d65 2064 6973 706c 6163 656d 656e  time displacemen
│ │ │ │ -000255a0: 7420 6d61 7920 6265 2073 656c 6563 7465  t may be selecte
│ │ │ │ -000255b0: 6420 6279 2074 6865 2073 7472 696e 6720  d by the string 
│ │ │ │ -000255c0: e280 9879 6561 72e2 8099 206f 720a e280  ...year... or...
│ │ │ │ -000255d0: 986d 6f6e 7468 e280 9920 666f 7220 6d6f  .month... for mo
│ │ │ │ -000255e0: 7669 6e67 2062 7920 7768 6f6c 6520 7965  ving by whole ye
│ │ │ │ -000255f0: 6172 7320 6f72 206d 6f6e 7468 732e 2020  ars or months.  
│ │ │ │ -00025600: 5468 6573 6520 6172 6520 6675 7a7a 7920  These are fuzzy 
│ │ │ │ -00025610: 756e 6974 732c 2061 730a 7965 6172 7320  units, as.years 
│ │ │ │ -00025620: 616e 6420 6d6f 6e74 6873 2061 7265 206e  and months are n
│ │ │ │ -00025630: 6f74 2061 6c6c 206f 6620 6571 7561 6c20  ot all of equal 
│ │ │ │ -00025640: 6475 7261 7469 6f6e 2e20 204d 6f72 6520  duration.  More 
│ │ │ │ -00025650: 7072 6563 6973 6520 756e 6974 7320 6172  precise units ar
│ │ │ │ -00025660: 650a e280 9866 6f72 746e 6967 6874 e280  e....fortnight..
│ │ │ │ -00025670: 9920 7768 6963 6820 6973 2077 6f72 7468  . which is worth
│ │ │ │ -00025680: 2031 3420 6461 7973 2c20 e280 9877 6565   14 days, ...wee
│ │ │ │ -00025690: 6be2 8099 2077 6f72 7468 2037 2064 6179  k... worth 7 day
│ │ │ │ -000256a0: 732c 20e2 8098 6461 79e2 8099 2077 6f72  s, ...day... wor
│ │ │ │ -000256b0: 7468 2032 340a 686f 7572 732c 20e2 8098  th 24.hours, ...
│ │ │ │ -000256c0: 686f 7572 e280 9920 776f 7274 6820 3630  hour... worth 60
│ │ │ │ -000256d0: 206d 696e 7574 6573 2c20 e280 986d 696e   minutes, ...min
│ │ │ │ -000256e0: 7574 65e2 8099 206f 7220 e280 986d 696e  ute... or ...min
│ │ │ │ -000256f0: e280 9920 776f 7274 6820 3630 2073 6563  ... worth 60 sec
│ │ │ │ -00025700: 6f6e 6473 2c20 616e 640a e280 9873 6563  onds, and....sec
│ │ │ │ -00025710: 6f6e 64e2 8099 206f 7220 e280 9873 6563  ond... or ...sec
│ │ │ │ -00025720: e280 9920 776f 7274 6820 6f6e 6520 7365  ... worth one se
│ │ │ │ -00025730: 636f 6e64 2e20 2041 6e20 e280 9873 e280  cond.  An ...s..
│ │ │ │ -00025740: 9920 7375 6666 6978 206f 6e20 7468 6573  . suffix on thes
│ │ │ │ -00025750: 6520 756e 6974 7320 6973 0a61 6363 6570  e units is.accep
│ │ │ │ -00025760: 7465 6420 616e 6420 6967 6e6f 7265 642e  ted and ignored.
│ │ │ │ -00025770: 0a0a 2020 2054 6865 2075 6e69 7420 6f66  ..   The unit of
│ │ │ │ -00025780: 2074 696d 6520 6d61 7920 6265 2070 7265   time may be pre
│ │ │ │ -00025790: 6365 6465 6420 6279 2061 206d 756c 7469  ceded by a multi
│ │ │ │ -000257a0: 706c 6965 722c 2067 6976 656e 2061 7320  plier, given as 
│ │ │ │ -000257b0: 616e 0a6f 7074 696f 6e61 6c6c 7920 7369  an.optionally si
│ │ │ │ -000257c0: 676e 6564 206e 756d 6265 722e 2020 556e  gned number.  Un
│ │ │ │ -000257d0: 7369 676e 6564 206e 756d 6265 7273 2061  signed numbers a
│ │ │ │ -000257e0: 7265 2074 616b 656e 2061 7320 706f 7369  re taken as posi
│ │ │ │ -000257f0: 7469 7665 6c79 0a73 6967 6e65 642e 2020  tively.signed.  
│ │ │ │ -00025800: 4e6f 206e 756d 6265 7220 6174 2061 6c6c  No number at all
│ │ │ │ -00025810: 2069 6d70 6c69 6573 2031 2066 6f72 2061   implies 1 for a
│ │ │ │ -00025820: 206d 756c 7469 706c 6965 722e 2020 466f   multiplier.  Fo
│ │ │ │ -00025830: 6c6c 6f77 696e 6720 610a 7265 6c61 7469  llowing a.relati
│ │ │ │ -00025840: 7665 2069 7465 6d20 6279 2074 6865 2073  ve item by the s
│ │ │ │ -00025850: 7472 696e 6720 e280 9861 676f e280 9920  tring ...ago... 
│ │ │ │ -00025860: 6973 2065 7175 6976 616c 656e 7420 746f  is equivalent to
│ │ │ │ -00025870: 2070 7265 6365 6469 6e67 2074 6865 2075   preceding the u
│ │ │ │ -00025880: 6e69 7420 6279 0a61 206d 756c 7469 706c  nit by.a multipl
│ │ │ │ -00025890: 6965 7220 7769 7468 2076 616c 7565 202d  ier with value -
│ │ │ │ -000258a0: 312e 0a0a 2020 2054 6865 2073 7472 696e  1...   The strin
│ │ │ │ -000258b0: 6720 e280 9874 6f6d 6f72 726f 77e2 8099  g ...tomorrow...
│ │ │ │ -000258c0: 2069 7320 776f 7274 6820 6f6e 6520 6461   is worth one da
│ │ │ │ -000258d0: 7920 696e 2074 6865 2066 7574 7572 6520  y in the future 
│ │ │ │ -000258e0: 2865 7175 6976 616c 656e 7420 746f 0ae2  (equivalent to..
│ │ │ │ -000258f0: 8098 6461 79e2 8099 292c 2074 6865 2073  ..day...), the s
│ │ │ │ -00025900: 7472 696e 6720 e280 9879 6573 7465 7264  tring ...yesterd
│ │ │ │ -00025910: 6179 e280 9920 6973 2077 6f72 7468 206f  ay... is worth o
│ │ │ │ -00025920: 6e65 2064 6179 2069 6e20 7468 6520 7061  ne day in the pa
│ │ │ │ -00025930: 7374 2028 6571 7569 7661 6c65 6e74 0a74  st (equivalent.t
│ │ │ │ -00025940: 6f20 e280 9864 6179 2061 676f e280 9929  o ...day ago...)
│ │ │ │ -00025950: 2e0a 0a20 2020 5468 6520 7374 7269 6e67  ...   The string
│ │ │ │ -00025960: 7320 e280 986e 6f77 e280 9920 6f72 20e2  s ...now... or .
│ │ │ │ -00025970: 8098 746f 6461 79e2 8099 2061 7265 2072  ..today... are r
│ │ │ │ -00025980: 656c 6174 6976 6520 6974 656d 7320 636f  elative items co
│ │ │ │ -00025990: 7272 6573 706f 6e64 696e 6720 746f 0a7a  rresponding to.z
│ │ │ │ -000259a0: 6572 6f2d 7661 6c75 6564 2074 696d 6520  ero-valued time 
│ │ │ │ -000259b0: 6469 7370 6c61 6365 6d65 6e74 2c20 7468  displacement, th
│ │ │ │ -000259c0: 6573 6520 7374 7269 6e67 7320 636f 6d65  ese strings come
│ │ │ │ -000259d0: 2066 726f 6d20 7468 6520 6661 6374 2061   from the fact a
│ │ │ │ -000259e0: 0a7a 6572 6f2d 7661 6c75 6564 2074 696d  .zero-valued tim
│ │ │ │ -000259f0: 6520 6469 7370 6c61 6365 6d65 6e74 2072  e displacement r
│ │ │ │ -00025a00: 6570 7265 7365 6e74 7320 7468 6520 6375  epresents the cu
│ │ │ │ -00025a10: 7272 656e 7420 7469 6d65 2077 6865 6e20  rrent time when 
│ │ │ │ -00025a20: 6e6f 740a 6f74 6865 7277 6973 6520 6368  not.otherwise ch
│ │ │ │ -00025a30: 616e 6765 6420 6279 2070 7265 7669 6f75  anged by previou
│ │ │ │ -00025a40: 7320 6974 656d 732e 2020 5468 6579 206d  s items.  They m
│ │ │ │ -00025a50: 6179 2062 6520 7573 6564 2074 6f20 7374  ay be used to st
│ │ │ │ -00025a60: 7265 7373 206f 7468 6572 0a69 7465 6d73  ress other.items
│ │ │ │ -00025a70: 2c20 6c69 6b65 2069 6e20 e280 9831 323a  , like in ...12:
│ │ │ │ -00025a80: 3030 2074 6f64 6179 e280 992e 2020 5468  00 today....  Th
│ │ │ │ -00025a90: 6520 7374 7269 6e67 20e2 8098 7468 6973  e string ...this
│ │ │ │ -00025aa0: e280 9920 616c 736f 2068 6173 2074 6865  ... also has the
│ │ │ │ -00025ab0: 206d 6561 6e69 6e67 206f 660a 6120 7a65   meaning of.a ze
│ │ │ │ -00025ac0: 726f 2d76 616c 7565 6420 7469 6d65 2064  ro-valued time d
│ │ │ │ -00025ad0: 6973 706c 6163 656d 656e 742c 2062 7574  isplacement, but
│ │ │ │ -00025ae0: 2069 7320 7072 6566 6572 7265 6420 696e   is preferred in
│ │ │ │ -00025af0: 2064 6174 6520 7374 7269 6e67 7320 6c69   date strings li
│ │ │ │ -00025b00: 6b65 0ae2 8098 7468 6973 2074 6875 7273  ke....this thurs
│ │ │ │ -00025b10: 6461 79e2 8099 2e0a 0a20 2020 5768 656e  day......   When
│ │ │ │ -00025b20: 2061 2072 656c 6174 6976 6520 6974 656d   a relative item
│ │ │ │ -00025b30: 2063 6175 7365 7320 7468 6520 7265 7375   causes the resu
│ │ │ │ -00025b40: 6c74 696e 6720 6461 7465 2074 6f20 6372  lting date to cr
│ │ │ │ -00025b50: 6f73 7320 6120 626f 756e 6461 7279 0a77  oss a boundary.w
│ │ │ │ -00025b60: 6865 7265 2074 6865 2063 6c6f 636b 7320  here the clocks 
│ │ │ │ -00025b70: 7765 7265 2061 646a 7573 7465 642c 2074  were adjusted, t
│ │ │ │ -00025b80: 7970 6963 616c 6c79 2066 6f72 2064 6179  ypically for day
│ │ │ │ -00025b90: 6c69 6768 7420 7361 7669 6e67 2074 696d  light saving tim
│ │ │ │ -00025ba0: 652c 2074 6865 0a72 6573 756c 7469 6e67  e, the.resulting
│ │ │ │ -00025bb0: 2064 6174 6520 616e 6420 7469 6d65 2061   date and time a
│ │ │ │ -00025bc0: 7265 2061 646a 7573 7465 6420 6163 636f  re adjusted acco
│ │ │ │ -00025bd0: 7264 696e 676c 792e 0a0a 2020 2054 6865  rdingly...   The
│ │ │ │ -00025be0: 2066 757a 7a20 696e 2075 6e69 7473 2063   fuzz in units c
│ │ │ │ -00025bf0: 616e 2063 6175 7365 2070 726f 626c 656d  an cause problem
│ │ │ │ -00025c00: 7320 7769 7468 2072 656c 6174 6976 6520  s with relative 
│ │ │ │ -00025c10: 6974 656d 732e 2020 466f 720a 6578 616d  items.  For.exam
│ │ │ │ -00025c20: 706c 652c 20e2 8098 3230 3230 2d30 372d  ple, ...2020-07-
│ │ │ │ -00025c30: 3331 202d 3120 6d6f 6e74 68e2 8099 206d  31 -1 month... m
│ │ │ │ -00025c40: 6967 6874 2065 7661 6c75 6174 6520 746f  ight evaluate to
│ │ │ │ -00025c50: 2032 3032 302d 3037 2d30 312c 2062 6563   2020-07-01, bec
│ │ │ │ -00025c60: 6175 7365 0a32 3032 302d 3036 2d33 3120  ause.2020-06-31 
│ │ │ │ -00025c70: 6973 2061 6e20 696e 7661 6c69 6420 6461  is an invalid da
│ │ │ │ -00025c80: 7465 2e20 2054 6f20 6465 7465 726d 696e  te.  To determin
│ │ │ │ -00025c90: 6520 7468 6520 7072 6576 696f 7573 206d  e the previous m
│ │ │ │ -00025ca0: 6f6e 7468 206d 6f72 650a 7265 6c69 6162  onth more.reliab
│ │ │ │ -00025cb0: 6c79 2c20 796f 7520 6361 6e20 6173 6b20  ly, you can ask 
│ │ │ │ -00025cc0: 666f 7220 7468 6520 6d6f 6e74 6820 6265  for the month be
│ │ │ │ -00025cd0: 666f 7265 2074 6865 2031 3574 6820 6f66  fore the 15th of
│ │ │ │ -00025ce0: 2074 6865 2063 7572 7265 6e74 0a6d 6f6e   the current.mon
│ │ │ │ -00025cf0: 7468 2e20 2046 6f72 2065 7861 6d70 6c65  th.  For example
│ │ │ │ -00025d00: 3a0a 0a20 2020 2020 2420 6461 7465 202d  :..     $ date -
│ │ │ │ -00025d10: 520a 2020 2020 2054 6875 2c20 3331 204a  R.     Thu, 31 J
│ │ │ │ -00025d20: 756c 2032 3032 3020 3133 3a30 323a 3339  ul 2020 13:02:39
│ │ │ │ -00025d30: 202d 3034 3030 0a20 2020 2020 2420 6461   -0400.     $ da
│ │ │ │ -00025d40: 7465 202d 2d64 6174 653d 272d 3120 6d6f  te --date='-1 mo
│ │ │ │ -00025d50: 6e74 6827 202b 274c 6173 7420 6d6f 6e74  nth' +'Last mont
│ │ │ │ -00025d60: 6820 7761 7320 2542 3f27 0a20 2020 2020  h was %B?'.     
│ │ │ │ -00025d70: 4c61 7374 206d 6f6e 7468 2077 6173 204a  Last month was J
│ │ │ │ -00025d80: 756c 793f 0a20 2020 2020 2420 6461 7465  uly?.     $ date
│ │ │ │ -00025d90: 202d 2d64 6174 653d 2224 2864 6174 6520   --date="$(date 
│ │ │ │ -00025da0: 2b25 592d 256d 2d31 3529 202d 3120 6d6f  +%Y-%m-15) -1 mo
│ │ │ │ -00025db0: 6e74 6822 202b 274c 6173 7420 6d6f 6e74  nth" +'Last mont
│ │ │ │ -00025dc0: 6820 7761 7320 2542 2127 0a20 2020 2020  h was %B!'.     
│ │ │ │ -00025dd0: 4c61 7374 206d 6f6e 7468 2077 6173 204a  Last month was J
│ │ │ │ -00025de0: 756e 6521 0a0a 2020 2041 6c73 6f2c 2074  une!..   Also, t
│ │ │ │ -00025df0: 616b 6520 6361 7265 2077 6865 6e20 6d61  ake care when ma
│ │ │ │ -00025e00: 6e69 7075 6c61 7469 6e67 2064 6174 6573  nipulating dates
│ │ │ │ -00025e10: 2061 726f 756e 6420 636c 6f63 6b20 6368   around clock ch
│ │ │ │ -00025e20: 616e 6765 7320 7375 6368 2061 730a 6461  anges such as.da
│ │ │ │ -00025e30: 796c 6967 6874 2073 6176 696e 6720 6c65  ylight saving le
│ │ │ │ -00025e40: 6170 732e 2020 496e 2061 2066 6577 2063  aps.  In a few c
│ │ │ │ -00025e50: 6173 6573 2074 6865 7365 2068 6176 6520  ases these have 
│ │ │ │ -00025e60: 6164 6465 6420 6f72 2073 7562 7472 6163  added or subtrac
│ │ │ │ -00025e70: 7465 6420 6173 0a6d 7563 6820 6173 2032  ted as.much as 2
│ │ │ │ -00025e80: 3420 686f 7572 7320 6672 6f6d 2074 6865  4 hours from the
│ │ │ │ -00025e90: 2063 6c6f 636b 2c20 736f 2069 7420 6973   clock, so it is
│ │ │ │ -00025ea0: 206f 6674 656e 2077 6973 6520 746f 2061   often wise to a
│ │ │ │ -00025eb0: 646f 7074 2075 6e69 7665 7273 616c 0a74  dopt universal.t
│ │ │ │ -00025ec0: 696d 6520 6279 2073 6574 7469 6e67 2074  ime by setting t
│ │ │ │ -00025ed0: 6865 20e2 8098 545a e280 9920 656e 7669  he ...TZ... envi
│ │ │ │ -00025ee0: 726f 6e6d 656e 7420 7661 7269 6162 6c65  ronment variable
│ │ │ │ -00025ef0: 2074 6f20 e280 9855 5443 30e2 8099 2062   to ...UTC0... b
│ │ │ │ -00025f00: 6566 6f72 6520 656d 6261 726b 696e 670a  efore embarking.
│ │ │ │ -00025f10: 6f6e 2063 616c 656e 6472 6963 616c 2063  on calendrical c
│ │ │ │ -00025f20: 616c 6375 6c61 7469 6f6e 732e 0a0a 1f0a  alculations.....
│ │ │ │ -00025f30: 4669 6c65 3a20 7368 6973 6869 2e69 6e66  File: shishi.inf
│ │ │ │ -00025f40: 6f2c 2020 4e6f 6465 3a20 5075 7265 206e  o,  Node: Pure n
│ │ │ │ -00025f50: 756d 6265 7273 2069 6e20 6461 7465 2073  umbers in date s
│ │ │ │ -00025f60: 7472 696e 6773 2c20 204e 6578 743a 2053  trings,  Next: S
│ │ │ │ -00025f70: 6563 6f6e 6473 2073 696e 6365 2074 6865  econds since the
│ │ │ │ -00025f80: 2045 706f 6368 2c20 2050 7265 763a 2052   Epoch,  Prev: R
│ │ │ │ -00025f90: 656c 6174 6976 6520 6974 656d 7320 696e  elative items in
│ │ │ │ -00025fa0: 2064 6174 6520 7374 7269 6e67 732c 2020   date strings,  
│ │ │ │ -00025fb0: 5570 3a20 4461 7465 2069 6e70 7574 2066  Up: Date input f
│ │ │ │ -00025fc0: 6f72 6d61 7473 0a0a 342e 3130 2e38 2050  ormats..4.10.8 P
│ │ │ │ -00025fd0: 7572 6520 6e75 6d62 6572 7320 696e 2064  ure numbers in d
│ │ │ │ -00025fe0: 6174 6520 7374 7269 6e67 730a 2d2d 2d2d  ate strings.----
│ │ │ │ +000254a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +000254b0: 0a0a e280 9c52 656c 6174 6976 6520 6974  .....Relative it
│ │ │ │ +000254c0: 656d 73e2 809d 2061 646a 7573 7420 6120  ems... adjust a 
│ │ │ │ +000254d0: 6461 7465 2028 6f72 2074 6865 2063 7572  date (or the cur
│ │ │ │ +000254e0: 7265 6e74 2064 6174 6520 6966 206e 6f6e  rent date if non
│ │ │ │ +000254f0: 6529 2066 6f72 7761 7264 206f 720a 6261  e) forward or.ba
│ │ │ │ +00025500: 636b 7761 7264 2e20 2054 6865 2065 6666  ckward.  The eff
│ │ │ │ +00025510: 6563 7473 206f 6620 7265 6c61 7469 7665  ects of relative
│ │ │ │ +00025520: 2069 7465 6d73 2061 6363 756d 756c 6174   items accumulat
│ │ │ │ +00025530: 652e 2020 4865 7265 2061 7265 2073 6f6d  e.  Here are som
│ │ │ │ +00025540: 650a 6578 616d 706c 6573 3a0a 0a20 2020  e.examples:..   
│ │ │ │ +00025550: 2020 3120 7965 6172 0a20 2020 2020 3120    1 year.     1 
│ │ │ │ +00025560: 7965 6172 2061 676f 0a20 2020 2020 3320  year ago.     3 
│ │ │ │ +00025570: 7965 6172 730a 2020 2020 2032 2064 6179  years.     2 day
│ │ │ │ +00025580: 730a 0a20 2020 5468 6520 756e 6974 206f  s..   The unit o
│ │ │ │ +00025590: 6620 7469 6d65 2064 6973 706c 6163 656d  f time displacem
│ │ │ │ +000255a0: 656e 7420 6d61 7920 6265 2073 656c 6563  ent may be selec
│ │ │ │ +000255b0: 7465 6420 6279 2074 6865 2073 7472 696e  ted by the strin
│ │ │ │ +000255c0: 6720 e280 9879 6561 72e2 8099 206f 720a  g ...year... or.
│ │ │ │ +000255d0: e280 986d 6f6e 7468 e280 9920 666f 7220  ...month... for 
│ │ │ │ +000255e0: 6d6f 7669 6e67 2062 7920 7768 6f6c 6520  moving by whole 
│ │ │ │ +000255f0: 7965 6172 7320 6f72 206d 6f6e 7468 732e  years or months.
│ │ │ │ +00025600: 2020 5468 6573 6520 6172 6520 6675 7a7a    These are fuzz
│ │ │ │ +00025610: 7920 756e 6974 732c 2061 730a 7965 6172  y units, as.year
│ │ │ │ +00025620: 7320 616e 6420 6d6f 6e74 6873 2061 7265  s and months are
│ │ │ │ +00025630: 206e 6f74 2061 6c6c 206f 6620 6571 7561   not all of equa
│ │ │ │ +00025640: 6c20 6475 7261 7469 6f6e 2e20 204d 6f72  l duration.  Mor
│ │ │ │ +00025650: 6520 7072 6563 6973 6520 756e 6974 7320  e precise units 
│ │ │ │ +00025660: 6172 650a e280 9866 6f72 746e 6967 6874  are....fortnight
│ │ │ │ +00025670: e280 9920 7768 6963 6820 6973 2077 6f72  ... which is wor
│ │ │ │ +00025680: 7468 2031 3420 6461 7973 2c20 e280 9877  th 14 days, ...w
│ │ │ │ +00025690: 6565 6be2 8099 2077 6f72 7468 2037 2064  eek... worth 7 d
│ │ │ │ +000256a0: 6179 732c 20e2 8098 6461 79e2 8099 2077  ays, ...day... w
│ │ │ │ +000256b0: 6f72 7468 2032 340a 686f 7572 732c 20e2  orth 24.hours, .
│ │ │ │ +000256c0: 8098 686f 7572 e280 9920 776f 7274 6820  ..hour... worth 
│ │ │ │ +000256d0: 3630 206d 696e 7574 6573 2c20 e280 986d  60 minutes, ...m
│ │ │ │ +000256e0: 696e 7574 65e2 8099 206f 7220 e280 986d  inute... or ...m
│ │ │ │ +000256f0: 696e e280 9920 776f 7274 6820 3630 2073  in... worth 60 s
│ │ │ │ +00025700: 6563 6f6e 6473 2c20 616e 640a e280 9873  econds, and....s
│ │ │ │ +00025710: 6563 6f6e 64e2 8099 206f 7220 e280 9873  econd... or ...s
│ │ │ │ +00025720: 6563 e280 9920 776f 7274 6820 6f6e 6520  ec... worth one 
│ │ │ │ +00025730: 7365 636f 6e64 2e20 2041 6e20 e280 9873  second.  An ...s
│ │ │ │ +00025740: e280 9920 7375 6666 6978 206f 6e20 7468  ... suffix on th
│ │ │ │ +00025750: 6573 6520 756e 6974 7320 6973 0a61 6363  ese units is.acc
│ │ │ │ +00025760: 6570 7465 6420 616e 6420 6967 6e6f 7265  epted and ignore
│ │ │ │ +00025770: 642e 0a0a 2020 2054 6865 2075 6e69 7420  d...   The unit 
│ │ │ │ +00025780: 6f66 2074 696d 6520 6d61 7920 6265 2070  of time may be p
│ │ │ │ +00025790: 7265 6365 6465 6420 6279 2061 206d 756c  receded by a mul
│ │ │ │ +000257a0: 7469 706c 6965 722c 2067 6976 656e 2061  tiplier, given a
│ │ │ │ +000257b0: 7320 616e 0a6f 7074 696f 6e61 6c6c 7920  s an.optionally 
│ │ │ │ +000257c0: 7369 676e 6564 206e 756d 6265 722e 2020  signed number.  
│ │ │ │ +000257d0: 556e 7369 676e 6564 206e 756d 6265 7273  Unsigned numbers
│ │ │ │ +000257e0: 2061 7265 2074 616b 656e 2061 7320 706f   are taken as po
│ │ │ │ +000257f0: 7369 7469 7665 6c79 0a73 6967 6e65 642e  sitively.signed.
│ │ │ │ +00025800: 2020 4e6f 206e 756d 6265 7220 6174 2061    No number at a
│ │ │ │ +00025810: 6c6c 2069 6d70 6c69 6573 2031 2066 6f72  ll implies 1 for
│ │ │ │ +00025820: 2061 206d 756c 7469 706c 6965 722e 2020   a multiplier.  
│ │ │ │ +00025830: 466f 6c6c 6f77 696e 6720 610a 7265 6c61  Following a.rela
│ │ │ │ +00025840: 7469 7665 2069 7465 6d20 6279 2074 6865  tive item by the
│ │ │ │ +00025850: 2073 7472 696e 6720 e280 9861 676f e280   string ...ago..
│ │ │ │ +00025860: 9920 6973 2065 7175 6976 616c 656e 7420  . is equivalent 
│ │ │ │ +00025870: 746f 2070 7265 6365 6469 6e67 2074 6865  to preceding the
│ │ │ │ +00025880: 2075 6e69 7420 6279 0a61 206d 756c 7469   unit by.a multi
│ │ │ │ +00025890: 706c 6965 7220 7769 7468 2076 616c 7565  plier with value
│ │ │ │ +000258a0: 202d 312e 0a0a 2020 2054 6865 2073 7472   -1...   The str
│ │ │ │ +000258b0: 696e 6720 e280 9874 6f6d 6f72 726f 77e2  ing ...tomorrow.
│ │ │ │ +000258c0: 8099 2069 7320 776f 7274 6820 6f6e 6520  .. is worth one 
│ │ │ │ +000258d0: 6461 7920 696e 2074 6865 2066 7574 7572  day in the futur
│ │ │ │ +000258e0: 6520 2865 7175 6976 616c 656e 7420 746f  e (equivalent to
│ │ │ │ +000258f0: 0ae2 8098 6461 79e2 8099 292c 2074 6865  ....day...), the
│ │ │ │ +00025900: 2073 7472 696e 6720 e280 9879 6573 7465   string ...yeste
│ │ │ │ +00025910: 7264 6179 e280 9920 6973 2077 6f72 7468  rday... is worth
│ │ │ │ +00025920: 206f 6e65 2064 6179 2069 6e20 7468 6520   one day in the 
│ │ │ │ +00025930: 7061 7374 2028 6571 7569 7661 6c65 6e74  past (equivalent
│ │ │ │ +00025940: 0a74 6f20 e280 9864 6179 2061 676f e280  .to ...day ago..
│ │ │ │ +00025950: 9929 2e0a 0a20 2020 5468 6520 7374 7269  .)...   The stri
│ │ │ │ +00025960: 6e67 7320 e280 986e 6f77 e280 9920 6f72  ngs ...now... or
│ │ │ │ +00025970: 20e2 8098 746f 6461 79e2 8099 2061 7265   ...today... are
│ │ │ │ +00025980: 2072 656c 6174 6976 6520 6974 656d 7320   relative items 
│ │ │ │ +00025990: 636f 7272 6573 706f 6e64 696e 6720 746f  corresponding to
│ │ │ │ +000259a0: 0a7a 6572 6f2d 7661 6c75 6564 2074 696d  .zero-valued tim
│ │ │ │ +000259b0: 6520 6469 7370 6c61 6365 6d65 6e74 2c20  e displacement, 
│ │ │ │ +000259c0: 7468 6573 6520 7374 7269 6e67 7320 636f  these strings co
│ │ │ │ +000259d0: 6d65 2066 726f 6d20 7468 6520 6661 6374  me from the fact
│ │ │ │ +000259e0: 2061 0a7a 6572 6f2d 7661 6c75 6564 2074   a.zero-valued t
│ │ │ │ +000259f0: 696d 6520 6469 7370 6c61 6365 6d65 6e74  ime displacement
│ │ │ │ +00025a00: 2072 6570 7265 7365 6e74 7320 7468 6520   represents the 
│ │ │ │ +00025a10: 6375 7272 656e 7420 7469 6d65 2077 6865  current time whe
│ │ │ │ +00025a20: 6e20 6e6f 740a 6f74 6865 7277 6973 6520  n not.otherwise 
│ │ │ │ +00025a30: 6368 616e 6765 6420 6279 2070 7265 7669  changed by previ
│ │ │ │ +00025a40: 6f75 7320 6974 656d 732e 2020 5468 6579  ous items.  They
│ │ │ │ +00025a50: 206d 6179 2062 6520 7573 6564 2074 6f20   may be used to 
│ │ │ │ +00025a60: 7374 7265 7373 206f 7468 6572 0a69 7465  stress other.ite
│ │ │ │ +00025a70: 6d73 2c20 6c69 6b65 2069 6e20 e280 9831  ms, like in ...1
│ │ │ │ +00025a80: 323a 3030 2074 6f64 6179 e280 992e 2020  2:00 today....  
│ │ │ │ +00025a90: 5468 6520 7374 7269 6e67 20e2 8098 7468  The string ...th
│ │ │ │ +00025aa0: 6973 e280 9920 616c 736f 2068 6173 2074  is... also has t
│ │ │ │ +00025ab0: 6865 206d 6561 6e69 6e67 206f 660a 6120  he meaning of.a 
│ │ │ │ +00025ac0: 7a65 726f 2d76 616c 7565 6420 7469 6d65  zero-valued time
│ │ │ │ +00025ad0: 2064 6973 706c 6163 656d 656e 742c 2062   displacement, b
│ │ │ │ +00025ae0: 7574 2069 7320 7072 6566 6572 7265 6420  ut is preferred 
│ │ │ │ +00025af0: 696e 2064 6174 6520 7374 7269 6e67 7320  in date strings 
│ │ │ │ +00025b00: 6c69 6b65 0ae2 8098 7468 6973 2074 6875  like....this thu
│ │ │ │ +00025b10: 7273 6461 79e2 8099 2e0a 0a20 2020 5768  rsday......   Wh
│ │ │ │ +00025b20: 656e 2061 2072 656c 6174 6976 6520 6974  en a relative it
│ │ │ │ +00025b30: 656d 2063 6175 7365 7320 7468 6520 7265  em causes the re
│ │ │ │ +00025b40: 7375 6c74 696e 6720 6461 7465 2074 6f20  sulting date to 
│ │ │ │ +00025b50: 6372 6f73 7320 6120 626f 756e 6461 7279  cross a boundary
│ │ │ │ +00025b60: 0a77 6865 7265 2074 6865 2063 6c6f 636b  .where the clock
│ │ │ │ +00025b70: 7320 7765 7265 2061 646a 7573 7465 642c  s were adjusted,
│ │ │ │ +00025b80: 2074 7970 6963 616c 6c79 2066 6f72 2064   typically for d
│ │ │ │ +00025b90: 6179 6c69 6768 7420 7361 7669 6e67 2074  aylight saving t
│ │ │ │ +00025ba0: 696d 652c 2074 6865 0a72 6573 756c 7469  ime, the.resulti
│ │ │ │ +00025bb0: 6e67 2064 6174 6520 616e 6420 7469 6d65  ng date and time
│ │ │ │ +00025bc0: 2061 7265 2061 646a 7573 7465 6420 6163   are adjusted ac
│ │ │ │ +00025bd0: 636f 7264 696e 676c 792e 0a0a 2020 2054  cordingly...   T
│ │ │ │ +00025be0: 6865 2066 757a 7a20 696e 2075 6e69 7473  he fuzz in units
│ │ │ │ +00025bf0: 2063 616e 2063 6175 7365 2070 726f 626c   can cause probl
│ │ │ │ +00025c00: 656d 7320 7769 7468 2072 656c 6174 6976  ems with relativ
│ │ │ │ +00025c10: 6520 6974 656d 732e 2020 466f 720a 6578  e items.  For.ex
│ │ │ │ +00025c20: 616d 706c 652c 20e2 8098 3230 3230 2d30  ample, ...2020-0
│ │ │ │ +00025c30: 372d 3331 202d 3120 6d6f 6e74 68e2 8099  7-31 -1 month...
│ │ │ │ +00025c40: 206d 6967 6874 2065 7661 6c75 6174 6520   might evaluate 
│ │ │ │ +00025c50: 746f 2032 3032 302d 3037 2d30 312c 2062  to 2020-07-01, b
│ │ │ │ +00025c60: 6563 6175 7365 0a32 3032 302d 3036 2d33  ecause.2020-06-3
│ │ │ │ +00025c70: 3120 6973 2061 6e20 696e 7661 6c69 6420  1 is an invalid 
│ │ │ │ +00025c80: 6461 7465 2e20 2054 6f20 6465 7465 726d  date.  To determ
│ │ │ │ +00025c90: 696e 6520 7468 6520 7072 6576 696f 7573  ine the previous
│ │ │ │ +00025ca0: 206d 6f6e 7468 206d 6f72 650a 7265 6c69   month more.reli
│ │ │ │ +00025cb0: 6162 6c79 2c20 796f 7520 6361 6e20 6173  ably, you can as
│ │ │ │ +00025cc0: 6b20 666f 7220 7468 6520 6d6f 6e74 6820  k for the month 
│ │ │ │ +00025cd0: 6265 666f 7265 2074 6865 2031 3574 6820  before the 15th 
│ │ │ │ +00025ce0: 6f66 2074 6865 2063 7572 7265 6e74 0a6d  of the current.m
│ │ │ │ +00025cf0: 6f6e 7468 2e20 2046 6f72 2065 7861 6d70  onth.  For examp
│ │ │ │ +00025d00: 6c65 3a0a 0a20 2020 2020 2420 6461 7465  le:..     $ date
│ │ │ │ +00025d10: 202d 520a 2020 2020 2054 6875 2c20 3331   -R.     Thu, 31
│ │ │ │ +00025d20: 204a 756c 2032 3032 3020 3133 3a30 323a   Jul 2020 13:02:
│ │ │ │ +00025d30: 3339 202d 3034 3030 0a20 2020 2020 2420  39 -0400.     $ 
│ │ │ │ +00025d40: 6461 7465 202d 2d64 6174 653d 272d 3120  date --date='-1 
│ │ │ │ +00025d50: 6d6f 6e74 6827 202b 274c 6173 7420 6d6f  month' +'Last mo
│ │ │ │ +00025d60: 6e74 6820 7761 7320 2542 3f27 0a20 2020  nth was %B?'.   
│ │ │ │ +00025d70: 2020 4c61 7374 206d 6f6e 7468 2077 6173    Last month was
│ │ │ │ +00025d80: 204a 756c 793f 0a20 2020 2020 2420 6461   July?.     $ da
│ │ │ │ +00025d90: 7465 202d 2d64 6174 653d 2224 2864 6174  te --date="$(dat
│ │ │ │ +00025da0: 6520 2b25 592d 256d 2d31 3529 202d 3120  e +%Y-%m-15) -1 
│ │ │ │ +00025db0: 6d6f 6e74 6822 202b 274c 6173 7420 6d6f  month" +'Last mo
│ │ │ │ +00025dc0: 6e74 6820 7761 7320 2542 2127 0a20 2020  nth was %B!'.   
│ │ │ │ +00025dd0: 2020 4c61 7374 206d 6f6e 7468 2077 6173    Last month was
│ │ │ │ +00025de0: 204a 756e 6521 0a0a 2020 2041 6c73 6f2c   June!..   Also,
│ │ │ │ +00025df0: 2074 616b 6520 6361 7265 2077 6865 6e20   take care when 
│ │ │ │ +00025e00: 6d61 6e69 7075 6c61 7469 6e67 2064 6174  manipulating dat
│ │ │ │ +00025e10: 6573 2061 726f 756e 6420 636c 6f63 6b20  es around clock 
│ │ │ │ +00025e20: 6368 616e 6765 7320 7375 6368 2061 730a  changes such as.
│ │ │ │ +00025e30: 6461 796c 6967 6874 2073 6176 696e 6720  daylight saving 
│ │ │ │ +00025e40: 6c65 6170 732e 2020 496e 2061 2066 6577  leaps.  In a few
│ │ │ │ +00025e50: 2063 6173 6573 2074 6865 7365 2068 6176   cases these hav
│ │ │ │ +00025e60: 6520 6164 6465 6420 6f72 2073 7562 7472  e added or subtr
│ │ │ │ +00025e70: 6163 7465 6420 6173 0a6d 7563 6820 6173  acted as.much as
│ │ │ │ +00025e80: 2032 3420 686f 7572 7320 6672 6f6d 2074   24 hours from t
│ │ │ │ +00025e90: 6865 2063 6c6f 636b 2c20 736f 2069 7420  he clock, so it 
│ │ │ │ +00025ea0: 6973 206f 6674 656e 2077 6973 6520 746f  is often wise to
│ │ │ │ +00025eb0: 2061 646f 7074 2075 6e69 7665 7273 616c   adopt universal
│ │ │ │ +00025ec0: 0a74 696d 6520 6279 2073 6574 7469 6e67  .time by setting
│ │ │ │ +00025ed0: 2074 6865 20e2 8098 545a e280 9920 656e   the ...TZ... en
│ │ │ │ +00025ee0: 7669 726f 6e6d 656e 7420 7661 7269 6162  vironment variab
│ │ │ │ +00025ef0: 6c65 2074 6f20 e280 9855 5443 30e2 8099  le to ...UTC0...
│ │ │ │ +00025f00: 2062 6566 6f72 6520 656d 6261 726b 696e   before embarkin
│ │ │ │ +00025f10: 670a 6f6e 2063 616c 656e 6472 6963 616c  g.on calendrical
│ │ │ │ +00025f20: 2063 616c 6375 6c61 7469 6f6e 732e 0a0a   calculations...
│ │ │ │ +00025f30: 1f0a 4669 6c65 3a20 7368 6973 6869 2e69  ..File: shishi.i
│ │ │ │ +00025f40: 6e66 6f2c 2020 4e6f 6465 3a20 5075 7265  nfo,  Node: Pure
│ │ │ │ +00025f50: 206e 756d 6265 7273 2069 6e20 6461 7465   numbers in date
│ │ │ │ +00025f60: 2073 7472 696e 6773 2c20 204e 6578 743a   strings,  Next:
│ │ │ │ +00025f70: 2053 6563 6f6e 6473 2073 696e 6365 2074   Seconds since t
│ │ │ │ +00025f80: 6865 2045 706f 6368 2c20 2050 7265 763a  he Epoch,  Prev:
│ │ │ │ +00025f90: 2052 656c 6174 6976 6520 6974 656d 7320   Relative items 
│ │ │ │ +00025fa0: 696e 2064 6174 6520 7374 7269 6e67 732c  in date strings,
│ │ │ │ +00025fb0: 2020 5570 3a20 4461 7465 2069 6e70 7574    Up: Date input
│ │ │ │ +00025fc0: 2066 6f72 6d61 7473 0a0a 342e 3130 2e38   formats..4.10.8
│ │ │ │ +00025fd0: 2050 7572 6520 6e75 6d62 6572 7320 696e   Pure numbers in
│ │ │ │ +00025fe0: 2064 6174 6520 7374 7269 6e67 730a 2d2d   date strings.--
│ │ │ │  00025ff0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00026000: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -00026010: 0a54 6865 2070 7265 6369 7365 2069 6e74  .The precise int
│ │ │ │ -00026020: 6572 7072 6574 6174 696f 6e20 6f66 2061  erpretation of a
│ │ │ │ -00026030: 2070 7572 6520 6465 6369 6d61 6c20 6e75   pure decimal nu
│ │ │ │ -00026040: 6d62 6572 2064 6570 656e 6473 206f 6e20  mber depends on 
│ │ │ │ -00026050: 7468 650a 636f 6e74 6578 7420 696e 2074  the.context in t
│ │ │ │ -00026060: 6865 2064 6174 6520 7374 7269 6e67 2e0a  he date string..
│ │ │ │ -00026070: 0a20 2020 4966 2074 6865 2064 6563 696d  .   If the decim
│ │ │ │ -00026080: 616c 206e 756d 6265 7220 6973 206f 6620  al number is of 
│ │ │ │ -00026090: 7468 6520 666f 726d 2059 5959 594d 4d44  the form YYYYMMD
│ │ │ │ -000260a0: 4420 616e 6420 6e6f 206f 7468 6572 2063  D and no other c
│ │ │ │ -000260b0: 616c 656e 6461 720a 6461 7465 2069 7465  alendar.date ite
│ │ │ │ -000260c0: 6d20 282a 6e6f 7465 2043 616c 656e 6461  m (*note Calenda
│ │ │ │ -000260d0: 7220 6461 7465 2069 7465 6d73 3a3a 2920  r date items::) 
│ │ │ │ -000260e0: 6170 7065 6172 7320 6265 666f 7265 2069  appears before i
│ │ │ │ -000260f0: 7420 696e 2074 6865 2064 6174 650a 7374  t in the date.st
│ │ │ │ -00026100: 7269 6e67 2c20 7468 656e 2059 5959 5920  ring, then YYYY 
│ │ │ │ -00026110: 6973 2072 6561 6420 6173 2074 6865 2079  is read as the y
│ │ │ │ -00026120: 6561 722c 204d 4d20 6173 2074 6865 206d  ear, MM as the m
│ │ │ │ -00026130: 6f6e 7468 206e 756d 6265 7220 616e 6420  onth number and 
│ │ │ │ -00026140: 4444 2061 730a 7468 6520 6461 7920 6f66  DD as.the day of
│ │ │ │ -00026150: 2074 6865 206d 6f6e 7468 2c20 666f 7220   the month, for 
│ │ │ │ -00026160: 7468 6520 7370 6563 6966 6965 6420 6361  the specified ca
│ │ │ │ -00026170: 6c65 6e64 6172 2064 6174 652e 0a0a 2020  lendar date...  
│ │ │ │ -00026180: 2049 6620 7468 6520 6465 6369 6d61 6c20   If the decimal 
│ │ │ │ -00026190: 6e75 6d62 6572 2069 7320 6f66 2074 6865  number is of the
│ │ │ │ -000261a0: 2066 6f72 6d20 4848 4d4d 2061 6e64 206e   form HHMM and n
│ │ │ │ -000261b0: 6f20 6f74 6865 7220 7469 6d65 206f 6620  o other time of 
│ │ │ │ -000261c0: 6461 790a 6974 656d 2061 7070 6561 7273  day.item appears
│ │ │ │ -000261d0: 2062 6566 6f72 6520 6974 2069 6e20 7468   before it in th
│ │ │ │ -000261e0: 6520 6461 7465 2073 7472 696e 672c 2074  e date string, t
│ │ │ │ -000261f0: 6865 6e20 4848 2069 7320 7265 6164 2061  hen HH is read a
│ │ │ │ -00026200: 7320 7468 6520 686f 7572 0a6f 6620 7468  s the hour.of th
│ │ │ │ -00026210: 6520 6461 7920 616e 6420 4d4d 2061 7320  e day and MM as 
│ │ │ │ -00026220: 7468 6520 6d69 6e75 7465 206f 6620 7468  the minute of th
│ │ │ │ -00026230: 6520 686f 7572 2c20 666f 7220 7468 6520  e hour, for the 
│ │ │ │ -00026240: 7370 6563 6966 6965 6420 7469 6d65 206f  specified time o
│ │ │ │ -00026250: 660a 6461 792e 2020 4d4d 2063 616e 2061  f.day.  MM can a
│ │ │ │ -00026260: 6c73 6f20 6265 206f 6d69 7474 6564 2e0a  lso be omitted..
│ │ │ │ -00026270: 0a20 2020 4966 2062 6f74 6820 6120 6361  .   If both a ca
│ │ │ │ -00026280: 6c65 6e64 6172 2064 6174 6520 616e 6420  lendar date and 
│ │ │ │ -00026290: 6120 7469 6d65 206f 6620 6461 7920 6170  a time of day ap
│ │ │ │ -000262a0: 7065 6172 2074 6f20 7468 6520 6c65 6674  pear to the left
│ │ │ │ -000262b0: 206f 6620 610a 6e75 6d62 6572 2069 6e20   of a.number in 
│ │ │ │ -000262c0: 7468 6520 6461 7465 2073 7472 696e 672c  the date string,
│ │ │ │ -000262d0: 2062 7574 206e 6f20 7265 6c61 7469 7665   but no relative
│ │ │ │ -000262e0: 2069 7465 6d2c 2074 6865 6e20 7468 6520   item, then the 
│ │ │ │ -000262f0: 6e75 6d62 6572 0a6f 7665 7272 6964 6573  number.overrides
│ │ │ │ -00026300: 2074 6865 2079 6561 722e 0a0a 1f0a 4669   the year.....Fi
│ │ │ │ -00026310: 6c65 3a20 7368 6973 6869 2e69 6e66 6f2c  le: shishi.info,
│ │ │ │ -00026320: 2020 4e6f 6465 3a20 5365 636f 6e64 7320    Node: Seconds 
│ │ │ │ -00026330: 7369 6e63 6520 7468 6520 4570 6f63 682c  since the Epoch,
│ │ │ │ -00026340: 2020 4e65 7874 3a20 5370 6563 6966 7969    Next: Specifyi
│ │ │ │ -00026350: 6e67 2074 696d 6520 7a6f 6e65 2072 756c  ng time zone rul
│ │ │ │ -00026360: 6573 2c20 2050 7265 763a 2050 7572 6520  es,  Prev: Pure 
│ │ │ │ -00026370: 6e75 6d62 6572 7320 696e 2064 6174 6520  numbers in date 
│ │ │ │ -00026380: 7374 7269 6e67 732c 2020 5570 3a20 4461  strings,  Up: Da
│ │ │ │ -00026390: 7465 2069 6e70 7574 2066 6f72 6d61 7473  te input formats
│ │ │ │ -000263a0: 0a0a 342e 3130 2e39 2053 6563 6f6e 6473  ..4.10.9 Seconds
│ │ │ │ -000263b0: 2073 696e 6365 2074 6865 2045 706f 6368   since the Epoch
│ │ │ │ -000263c0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ -000263d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -000263e0: 0a49 6620 796f 7520 7072 6563 6564 6520  .If you precede 
│ │ │ │ -000263f0: 6120 6e75 6d62 6572 2077 6974 6820 e280  a number with ..
│ │ │ │ -00026400: 9840 e280 992c 2069 7420 7265 7072 6573  .@..., it repres
│ │ │ │ -00026410: 656e 7473 2061 6e20 696e 7465 726e 616c  ents an internal
│ │ │ │ -00026420: 2074 696d 6573 7461 6d70 2061 730a 6120   timestamp as.a 
│ │ │ │ -00026430: 636f 756e 7420 6f66 2073 6563 6f6e 6473  count of seconds
│ │ │ │ -00026440: 2e20 2054 6865 206e 756d 6265 7220 6361  .  The number ca
│ │ │ │ -00026450: 6e20 636f 6e74 6169 6e20 616e 2069 6e74  n contain an int
│ │ │ │ -00026460: 6572 6e61 6c20 6465 6369 6d61 6c20 706f  ernal decimal po
│ │ │ │ -00026470: 696e 740a 2865 6974 6865 7220 e280 982e  int.(either ....
│ │ │ │ -00026480: e280 9920 6f72 20e2 8098 2ce2 8099 293b  ... or ...,...);
│ │ │ │ -00026490: 2061 6e79 2065 7863 6573 7320 7072 6563   any excess prec
│ │ │ │ -000264a0: 6973 696f 6e20 6e6f 7420 7375 7070 6f72  ision not suppor
│ │ │ │ -000264b0: 7465 6420 6279 2074 6865 2069 6e74 6572  ted by the inter
│ │ │ │ -000264c0: 6e61 6c0a 7265 7072 6573 656e 7461 7469  nal.representati
│ │ │ │ -000264d0: 6f6e 2069 7320 7472 756e 6361 7465 6420  on is truncated 
│ │ │ │ -000264e0: 746f 7761 7264 206d 696e 7573 2069 6e66  toward minus inf
│ │ │ │ -000264f0: 696e 6974 792e 2020 5375 6368 2061 206e  inity.  Such a n
│ │ │ │ -00026500: 756d 6265 7220 6361 6e6e 6f74 0a62 6520  umber cannot.be 
│ │ │ │ -00026510: 636f 6d62 696e 6564 2077 6974 6820 616e  combined with an
│ │ │ │ -00026520: 7920 6f74 6865 7220 6461 7465 2069 7465  y other date ite
│ │ │ │ -00026530: 6d2c 2061 7320 6974 2073 7065 6369 6669  m, as it specifi
│ │ │ │ -00026540: 6573 2061 2063 6f6d 706c 6574 650a 7469  es a complete.ti
│ │ │ │ -00026550: 6d65 7374 616d 702e 0a0a 2020 2049 6e74  mestamp...   Int
│ │ │ │ -00026560: 6572 6e61 6c6c 792c 2063 6f6d 7075 7465  ernally, compute
│ │ │ │ -00026570: 7220 7469 6d65 7320 6172 6520 7265 7072  r times are repr
│ │ │ │ -00026580: 6573 656e 7465 6420 6173 2061 2063 6f75  esented as a cou
│ │ │ │ -00026590: 6e74 206f 6620 7365 636f 6e64 730a 7369  nt of seconds.si
│ │ │ │ -000265a0: 6e63 6520 616e 2045 706f 6368 2d2d 6120  nce an Epoch--a 
│ │ │ │ -000265b0: 7765 6c6c 2d64 6566 696e 6564 2070 6f69  well-defined poi
│ │ │ │ -000265c0: 6e74 206f 6620 7469 6d65 2e20 204f 6e20  nt of time.  On 
│ │ │ │ -000265d0: 474e 5520 616e 6420 504f 5349 5820 7379  GNU and POSIX sy
│ │ │ │ -000265e0: 7374 656d 732c 0a74 6865 2045 706f 6368  stems,.the Epoch
│ │ │ │ -000265f0: 2069 7320 3139 3730 2d30 312d 3031 2030   is 1970-01-01 0
│ │ │ │ -00026600: 303a 3030 3a30 3020 5554 432c 2073 6f20  0:00:00 UTC, so 
│ │ │ │ -00026610: e280 9840 30e2 8099 2072 6570 7265 7365  ...@0... represe
│ │ │ │ -00026620: 6e74 7320 7468 6973 2074 696d 652c 20e2  nts this time, .
│ │ │ │ -00026630: 8098 4031 e280 990a 7265 7072 6573 656e  ..@1....represen
│ │ │ │ -00026640: 7473 2031 3937 302d 3031 2d30 3120 3030  ts 1970-01-01 00
│ │ │ │ -00026650: 3a30 303a 3031 2055 5443 2c20 616e 6420  :00:01 UTC, and 
│ │ │ │ -00026660: 736f 2066 6f72 7468 2e20 2047 4e55 2061  so forth.  GNU a
│ │ │ │ -00026670: 6e64 206d 6f73 7420 6f74 6865 720a 504f  nd most other.PO
│ │ │ │ -00026680: 5349 582d 636f 6d70 6c69 616e 7420 7379  SIX-compliant sy
│ │ │ │ -00026690: 7374 656d 7320 7375 7070 6f72 7420 7375  stems support su
│ │ │ │ -000266a0: 6368 2074 696d 6573 2061 7320 616e 2065  ch times as an e
│ │ │ │ -000266b0: 7874 656e 7369 6f6e 2074 6f20 504f 5349  xtension to POSI
│ │ │ │ -000266c0: 582c 0a75 7369 6e67 206e 6567 6174 6976  X,.using negativ
│ │ │ │ -000266d0: 6520 636f 756e 7473 2c20 736f 2074 6861  e counts, so tha
│ │ │ │ -000266e0: 7420 e280 9840 2d31 e280 9920 7265 7072  t ...@-1... repr
│ │ │ │ -000266f0: 6573 656e 7473 2031 3936 392d 3132 2d33  esents 1969-12-3
│ │ │ │ -00026700: 3120 3233 3a35 393a 3539 2055 5443 2e0a  1 23:59:59 UTC..
│ │ │ │ -00026710: 0a20 2020 4d6f 7374 206d 6f64 6572 6e20  .   Most modern 
│ │ │ │ -00026720: 7379 7374 656d 7320 636f 756e 7420 7365  systems count se
│ │ │ │ -00026730: 636f 6e64 7320 7769 7468 2036 342d 6269  conds with 64-bi
│ │ │ │ -00026740: 7420 7477 6f27 732d 636f 6d70 6c65 6d65  t two's-compleme
│ │ │ │ -00026750: 6e74 0a69 6e74 6567 6572 7320 6f66 2073  nt.integers of s
│ │ │ │ -00026760: 6563 6f6e 6473 2077 6974 6820 6e61 6e6f  econds with nano
│ │ │ │ -00026770: 7365 636f 6e64 2073 7562 636f 756e 7473  second subcounts
│ │ │ │ -00026780: 2c20 7768 6963 6820 6973 2061 2072 616e  , which is a ran
│ │ │ │ -00026790: 6765 2074 6861 740a 696e 636c 7564 6573  ge that.includes
│ │ │ │ -000267a0: 2074 6865 206b 6e6f 776e 206c 6966 6574   the known lifet
│ │ │ │ -000267b0: 696d 6520 6f66 2074 6865 2075 6e69 7665  ime of the unive
│ │ │ │ -000267c0: 7273 6520 7769 7468 206e 616e 6f73 6563  rse with nanosec
│ │ │ │ -000267d0: 6f6e 6420 7265 736f 6c75 7469 6f6e 2e0a  ond resolution..
│ │ │ │ -000267e0: 536f 6d65 206f 6273 6f6c 6573 6365 6e74  Some obsolescent
│ │ │ │ -000267f0: 2073 7973 7465 6d73 2063 6f75 6e74 2073   systems count s
│ │ │ │ -00026800: 6563 6f6e 6473 2077 6974 6820 3332 2d62  econds with 32-b
│ │ │ │ -00026810: 6974 2074 776f 2773 2d63 6f6d 706c 656d  it two's-complem
│ │ │ │ -00026820: 656e 740a 696e 7465 6765 7273 2061 6e64  ent.integers and
│ │ │ │ -00026830: 2063 616e 2072 6570 7265 7365 6e74 2074   can represent t
│ │ │ │ -00026840: 696d 6573 2066 726f 6d20 3139 3031 2d31  imes from 1901-1
│ │ │ │ -00026850: 322d 3133 2032 303a 3435 3a35 3220 7468  2-13 20:45:52 th
│ │ │ │ -00026860: 726f 7567 680a 3230 3338 2d30 312d 3139  rough.2038-01-19
│ │ │ │ -00026870: 2030 333a 3134 3a30 3720 5554 432e 2020   03:14:07 UTC.  
│ │ │ │ -00026880: 4120 6665 7720 7379 7374 656d 7320 7370  A few systems sp
│ │ │ │ -00026890: 6f72 7420 6f74 6865 7220 7469 6d65 2072  ort other time r
│ │ │ │ -000268a0: 616e 6765 732e 0a0a 2020 204f 6e20 6d6f  anges...   On mo
│ │ │ │ -000268b0: 7374 2068 6f73 7473 2c20 7468 6573 6520  st hosts, these 
│ │ │ │ -000268c0: 636f 756e 7473 2069 676e 6f72 6520 7468  counts ignore th
│ │ │ │ -000268d0: 6520 7072 6573 656e 6365 206f 6620 6c65  e presence of le
│ │ │ │ -000268e0: 6170 2073 6563 6f6e 6473 2e20 2046 6f72  ap seconds.  For
│ │ │ │ -000268f0: 0a65 7861 6d70 6c65 2c20 6f6e 206d 6f73  .example, on mos
│ │ │ │ -00026900: 7420 686f 7374 7320 e280 9840 3134 3833  t hosts ...@1483
│ │ │ │ -00026910: 3232 3837 3939 e280 9920 7265 7072 6573  228799... repres
│ │ │ │ -00026920: 656e 7473 2032 3031 362d 3132 2d33 3120  ents 2016-12-31 
│ │ │ │ -00026930: 3233 3a35 393a 3539 2055 5443 2c0a e280  23:59:59 UTC,...
│ │ │ │ -00026940: 9840 3134 3833 3232 3838 3030 e280 9920  .@1483228800... 
│ │ │ │ -00026950: 7265 7072 6573 656e 7473 2032 3031 372d  represents 2017-
│ │ │ │ -00026960: 3031 2d30 3120 3030 3a30 303a 3030 2055  01-01 00:00:00 U
│ │ │ │ -00026970: 5443 2c20 616e 6420 7468 6572 6520 6973  TC, and there is
│ │ │ │ -00026980: 206e 6f20 7761 7920 746f 0a72 6570 7265   no way to.repre
│ │ │ │ -00026990: 7365 6e74 2074 6865 2069 6e74 6572 7665  sent the interve
│ │ │ │ -000269a0: 6e69 6e67 206c 6561 7020 7365 636f 6e64  ning leap second
│ │ │ │ -000269b0: 2032 3031 362d 3132 2d33 3120 3233 3a35   2016-12-31 23:5
│ │ │ │ -000269c0: 393a 3630 2055 5443 2e0a 0a1f 0a46 696c  9:60 UTC.....Fil
│ │ │ │ -000269d0: 653a 2073 6869 7368 692e 696e 666f 2c20  e: shishi.info, 
│ │ │ │ -000269e0: 204e 6f64 653a 2053 7065 6369 6679 696e   Node: Specifyin
│ │ │ │ -000269f0: 6720 7469 6d65 207a 6f6e 6520 7275 6c65  g time zone rule
│ │ │ │ -00026a00: 732c 2020 4e65 7874 3a20 4175 7468 6f72  s,  Next: Author
│ │ │ │ -00026a10: 7320 6f66 2070 6172 7365 5f64 6174 6574  s of parse_datet
│ │ │ │ -00026a20: 696d 652c 2020 5072 6576 3a20 5365 636f  ime,  Prev: Seco
│ │ │ │ -00026a30: 6e64 7320 7369 6e63 6520 7468 6520 4570  nds since the Ep
│ │ │ │ -00026a40: 6f63 682c 2020 5570 3a20 4461 7465 2069  och,  Up: Date i
│ │ │ │ -00026a50: 6e70 7574 2066 6f72 6d61 7473 0a0a 342e  nput formats..4.
│ │ │ │ -00026a60: 3130 2e31 3020 5370 6563 6966 7969 6e67  10.10 Specifying
│ │ │ │ -00026a70: 2074 696d 6520 7a6f 6e65 2072 756c 6573   time zone rules
│ │ │ │ -00026a80: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ +00026000: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +00026010: 2d0a 0a54 6865 2070 7265 6369 7365 2069  -..The precise i
│ │ │ │ +00026020: 6e74 6572 7072 6574 6174 696f 6e20 6f66  nterpretation of
│ │ │ │ +00026030: 2061 2070 7572 6520 6465 6369 6d61 6c20   a pure decimal 
│ │ │ │ +00026040: 6e75 6d62 6572 2064 6570 656e 6473 206f  number depends o
│ │ │ │ +00026050: 6e20 7468 650a 636f 6e74 6578 7420 696e  n the.context in
│ │ │ │ +00026060: 2074 6865 2064 6174 6520 7374 7269 6e67   the date string
│ │ │ │ +00026070: 2e0a 0a20 2020 4966 2074 6865 2064 6563  ...   If the dec
│ │ │ │ +00026080: 696d 616c 206e 756d 6265 7220 6973 206f  imal number is o
│ │ │ │ +00026090: 6620 7468 6520 666f 726d 2059 5959 594d  f the form YYYYM
│ │ │ │ +000260a0: 4d44 4420 616e 6420 6e6f 206f 7468 6572  MDD and no other
│ │ │ │ +000260b0: 2063 616c 656e 6461 720a 6461 7465 2069   calendar.date i
│ │ │ │ +000260c0: 7465 6d20 282a 6e6f 7465 2043 616c 656e  tem (*note Calen
│ │ │ │ +000260d0: 6461 7220 6461 7465 2069 7465 6d73 3a3a  dar date items::
│ │ │ │ +000260e0: 2920 6170 7065 6172 7320 6265 666f 7265  ) appears before
│ │ │ │ +000260f0: 2069 7420 696e 2074 6865 2064 6174 650a   it in the date.
│ │ │ │ +00026100: 7374 7269 6e67 2c20 7468 656e 2059 5959  string, then YYY
│ │ │ │ +00026110: 5920 6973 2072 6561 6420 6173 2074 6865  Y is read as the
│ │ │ │ +00026120: 2079 6561 722c 204d 4d20 6173 2074 6865   year, MM as the
│ │ │ │ +00026130: 206d 6f6e 7468 206e 756d 6265 7220 616e   month number an
│ │ │ │ +00026140: 6420 4444 2061 730a 7468 6520 6461 7920  d DD as.the day 
│ │ │ │ +00026150: 6f66 2074 6865 206d 6f6e 7468 2c20 666f  of the month, fo
│ │ │ │ +00026160: 7220 7468 6520 7370 6563 6966 6965 6420  r the specified 
│ │ │ │ +00026170: 6361 6c65 6e64 6172 2064 6174 652e 0a0a  calendar date...
│ │ │ │ +00026180: 2020 2049 6620 7468 6520 6465 6369 6d61     If the decima
│ │ │ │ +00026190: 6c20 6e75 6d62 6572 2069 7320 6f66 2074  l number is of t
│ │ │ │ +000261a0: 6865 2066 6f72 6d20 4848 4d4d 2061 6e64  he form HHMM and
│ │ │ │ +000261b0: 206e 6f20 6f74 6865 7220 7469 6d65 206f   no other time o
│ │ │ │ +000261c0: 6620 6461 790a 6974 656d 2061 7070 6561  f day.item appea
│ │ │ │ +000261d0: 7273 2062 6566 6f72 6520 6974 2069 6e20  rs before it in 
│ │ │ │ +000261e0: 7468 6520 6461 7465 2073 7472 696e 672c  the date string,
│ │ │ │ +000261f0: 2074 6865 6e20 4848 2069 7320 7265 6164   then HH is read
│ │ │ │ +00026200: 2061 7320 7468 6520 686f 7572 0a6f 6620   as the hour.of 
│ │ │ │ +00026210: 7468 6520 6461 7920 616e 6420 4d4d 2061  the day and MM a
│ │ │ │ +00026220: 7320 7468 6520 6d69 6e75 7465 206f 6620  s the minute of 
│ │ │ │ +00026230: 7468 6520 686f 7572 2c20 666f 7220 7468  the hour, for th
│ │ │ │ +00026240: 6520 7370 6563 6966 6965 6420 7469 6d65  e specified time
│ │ │ │ +00026250: 206f 660a 6461 792e 2020 4d4d 2063 616e   of.day.  MM can
│ │ │ │ +00026260: 2061 6c73 6f20 6265 206f 6d69 7474 6564   also be omitted
│ │ │ │ +00026270: 2e0a 0a20 2020 4966 2062 6f74 6820 6120  ...   If both a 
│ │ │ │ +00026280: 6361 6c65 6e64 6172 2064 6174 6520 616e  calendar date an
│ │ │ │ +00026290: 6420 6120 7469 6d65 206f 6620 6461 7920  d a time of day 
│ │ │ │ +000262a0: 6170 7065 6172 2074 6f20 7468 6520 6c65  appear to the le
│ │ │ │ +000262b0: 6674 206f 6620 610a 6e75 6d62 6572 2069  ft of a.number i
│ │ │ │ +000262c0: 6e20 7468 6520 6461 7465 2073 7472 696e  n the date strin
│ │ │ │ +000262d0: 672c 2062 7574 206e 6f20 7265 6c61 7469  g, but no relati
│ │ │ │ +000262e0: 7665 2069 7465 6d2c 2074 6865 6e20 7468  ve item, then th
│ │ │ │ +000262f0: 6520 6e75 6d62 6572 0a6f 7665 7272 6964  e number.overrid
│ │ │ │ +00026300: 6573 2074 6865 2079 6561 722e 0a0a 1f0a  es the year.....
│ │ │ │ +00026310: 4669 6c65 3a20 7368 6973 6869 2e69 6e66  File: shishi.inf
│ │ │ │ +00026320: 6f2c 2020 4e6f 6465 3a20 5365 636f 6e64  o,  Node: Second
│ │ │ │ +00026330: 7320 7369 6e63 6520 7468 6520 4570 6f63  s since the Epoc
│ │ │ │ +00026340: 682c 2020 4e65 7874 3a20 5370 6563 6966  h,  Next: Specif
│ │ │ │ +00026350: 7969 6e67 2074 696d 6520 7a6f 6e65 2072  ying time zone r
│ │ │ │ +00026360: 756c 6573 2c20 2050 7265 763a 2050 7572  ules,  Prev: Pur
│ │ │ │ +00026370: 6520 6e75 6d62 6572 7320 696e 2064 6174  e numbers in dat
│ │ │ │ +00026380: 6520 7374 7269 6e67 732c 2020 5570 3a20  e strings,  Up: 
│ │ │ │ +00026390: 4461 7465 2069 6e70 7574 2066 6f72 6d61  Date input forma
│ │ │ │ +000263a0: 7473 0a0a 342e 3130 2e39 2053 6563 6f6e  ts..4.10.9 Secon
│ │ │ │ +000263b0: 6473 2073 696e 6365 2074 6865 2045 706f  ds since the Epo
│ │ │ │ +000263c0: 6368 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ch.-------------
│ │ │ │ +000263d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +000263e0: 2d0a 0a49 6620 796f 7520 7072 6563 6564  -..If you preced
│ │ │ │ +000263f0: 6520 6120 6e75 6d62 6572 2077 6974 6820  e a number with 
│ │ │ │ +00026400: e280 9840 e280 992c 2069 7420 7265 7072  ...@..., it repr
│ │ │ │ +00026410: 6573 656e 7473 2061 6e20 696e 7465 726e  esents an intern
│ │ │ │ +00026420: 616c 2074 696d 6573 7461 6d70 2061 730a  al timestamp as.
│ │ │ │ +00026430: 6120 636f 756e 7420 6f66 2073 6563 6f6e  a count of secon
│ │ │ │ +00026440: 6473 2e20 2054 6865 206e 756d 6265 7220  ds.  The number 
│ │ │ │ +00026450: 6361 6e20 636f 6e74 6169 6e20 616e 2069  can contain an i
│ │ │ │ +00026460: 6e74 6572 6e61 6c20 6465 6369 6d61 6c20  nternal decimal 
│ │ │ │ +00026470: 706f 696e 740a 2865 6974 6865 7220 e280  point.(either ..
│ │ │ │ +00026480: 982e e280 9920 6f72 20e2 8098 2ce2 8099  ..... or ...,...
│ │ │ │ +00026490: 293b 2061 6e79 2065 7863 6573 7320 7072  ); any excess pr
│ │ │ │ +000264a0: 6563 6973 696f 6e20 6e6f 7420 7375 7070  ecision not supp
│ │ │ │ +000264b0: 6f72 7465 6420 6279 2074 6865 2069 6e74  orted by the int
│ │ │ │ +000264c0: 6572 6e61 6c0a 7265 7072 6573 656e 7461  ernal.representa
│ │ │ │ +000264d0: 7469 6f6e 2069 7320 7472 756e 6361 7465  tion is truncate
│ │ │ │ +000264e0: 6420 746f 7761 7264 206d 696e 7573 2069  d toward minus i
│ │ │ │ +000264f0: 6e66 696e 6974 792e 2020 5375 6368 2061  nfinity.  Such a
│ │ │ │ +00026500: 206e 756d 6265 7220 6361 6e6e 6f74 0a62   number cannot.b
│ │ │ │ +00026510: 6520 636f 6d62 696e 6564 2077 6974 6820  e combined with 
│ │ │ │ +00026520: 616e 7920 6f74 6865 7220 6461 7465 2069  any other date i
│ │ │ │ +00026530: 7465 6d2c 2061 7320 6974 2073 7065 6369  tem, as it speci
│ │ │ │ +00026540: 6669 6573 2061 2063 6f6d 706c 6574 650a  fies a complete.
│ │ │ │ +00026550: 7469 6d65 7374 616d 702e 0a0a 2020 2049  timestamp...   I
│ │ │ │ +00026560: 6e74 6572 6e61 6c6c 792c 2063 6f6d 7075  nternally, compu
│ │ │ │ +00026570: 7465 7220 7469 6d65 7320 6172 6520 7265  ter times are re
│ │ │ │ +00026580: 7072 6573 656e 7465 6420 6173 2061 2063  presented as a c
│ │ │ │ +00026590: 6f75 6e74 206f 6620 7365 636f 6e64 730a  ount of seconds.
│ │ │ │ +000265a0: 7369 6e63 6520 616e 2045 706f 6368 2d2d  since an Epoch--
│ │ │ │ +000265b0: 6120 7765 6c6c 2d64 6566 696e 6564 2070  a well-defined p
│ │ │ │ +000265c0: 6f69 6e74 206f 6620 7469 6d65 2e20 204f  oint of time.  O
│ │ │ │ +000265d0: 6e20 474e 5520 616e 6420 504f 5349 5820  n GNU and POSIX 
│ │ │ │ +000265e0: 7379 7374 656d 732c 0a74 6865 2045 706f  systems,.the Epo
│ │ │ │ +000265f0: 6368 2069 7320 3139 3730 2d30 312d 3031  ch is 1970-01-01
│ │ │ │ +00026600: 2030 303a 3030 3a30 3020 5554 432c 2073   00:00:00 UTC, s
│ │ │ │ +00026610: 6f20 e280 9840 30e2 8099 2072 6570 7265  o ...@0... repre
│ │ │ │ +00026620: 7365 6e74 7320 7468 6973 2074 696d 652c  sents this time,
│ │ │ │ +00026630: 20e2 8098 4031 e280 990a 7265 7072 6573   ...@1....repres
│ │ │ │ +00026640: 656e 7473 2031 3937 302d 3031 2d30 3120  ents 1970-01-01 
│ │ │ │ +00026650: 3030 3a30 303a 3031 2055 5443 2c20 616e  00:00:01 UTC, an
│ │ │ │ +00026660: 6420 736f 2066 6f72 7468 2e20 2047 4e55  d so forth.  GNU
│ │ │ │ +00026670: 2061 6e64 206d 6f73 7420 6f74 6865 720a   and most other.
│ │ │ │ +00026680: 504f 5349 582d 636f 6d70 6c69 616e 7420  POSIX-compliant 
│ │ │ │ +00026690: 7379 7374 656d 7320 7375 7070 6f72 7420  systems support 
│ │ │ │ +000266a0: 7375 6368 2074 696d 6573 2061 7320 616e  such times as an
│ │ │ │ +000266b0: 2065 7874 656e 7369 6f6e 2074 6f20 504f   extension to PO
│ │ │ │ +000266c0: 5349 582c 0a75 7369 6e67 206e 6567 6174  SIX,.using negat
│ │ │ │ +000266d0: 6976 6520 636f 756e 7473 2c20 736f 2074  ive counts, so t
│ │ │ │ +000266e0: 6861 7420 e280 9840 2d31 e280 9920 7265  hat ...@-1... re
│ │ │ │ +000266f0: 7072 6573 656e 7473 2031 3936 392d 3132  presents 1969-12
│ │ │ │ +00026700: 2d33 3120 3233 3a35 393a 3539 2055 5443  -31 23:59:59 UTC
│ │ │ │ +00026710: 2e0a 0a20 2020 4d6f 7374 206d 6f64 6572  ...   Most moder
│ │ │ │ +00026720: 6e20 7379 7374 656d 7320 636f 756e 7420  n systems count 
│ │ │ │ +00026730: 7365 636f 6e64 7320 7769 7468 2036 342d  seconds with 64-
│ │ │ │ +00026740: 6269 7420 7477 6f27 732d 636f 6d70 6c65  bit two's-comple
│ │ │ │ +00026750: 6d65 6e74 0a69 6e74 6567 6572 7320 6f66  ment.integers of
│ │ │ │ +00026760: 2073 6563 6f6e 6473 2077 6974 6820 6e61   seconds with na
│ │ │ │ +00026770: 6e6f 7365 636f 6e64 2073 7562 636f 756e  nosecond subcoun
│ │ │ │ +00026780: 7473 2c20 7768 6963 6820 6973 2061 2072  ts, which is a r
│ │ │ │ +00026790: 616e 6765 2074 6861 740a 696e 636c 7564  ange that.includ
│ │ │ │ +000267a0: 6573 2074 6865 206b 6e6f 776e 206c 6966  es the known lif
│ │ │ │ +000267b0: 6574 696d 6520 6f66 2074 6865 2075 6e69  etime of the uni
│ │ │ │ +000267c0: 7665 7273 6520 7769 7468 206e 616e 6f73  verse with nanos
│ │ │ │ +000267d0: 6563 6f6e 6420 7265 736f 6c75 7469 6f6e  econd resolution
│ │ │ │ +000267e0: 2e0a 536f 6d65 206f 6273 6f6c 6573 6365  ..Some obsolesce
│ │ │ │ +000267f0: 6e74 2073 7973 7465 6d73 2063 6f75 6e74  nt systems count
│ │ │ │ +00026800: 2073 6563 6f6e 6473 2077 6974 6820 3332   seconds with 32
│ │ │ │ +00026810: 2d62 6974 2074 776f 2773 2d63 6f6d 706c  -bit two's-compl
│ │ │ │ +00026820: 656d 656e 740a 696e 7465 6765 7273 2061  ement.integers a
│ │ │ │ +00026830: 6e64 2063 616e 2072 6570 7265 7365 6e74  nd can represent
│ │ │ │ +00026840: 2074 696d 6573 2066 726f 6d20 3139 3031   times from 1901
│ │ │ │ +00026850: 2d31 322d 3133 2032 303a 3435 3a35 3220  -12-13 20:45:52 
│ │ │ │ +00026860: 7468 726f 7567 680a 3230 3338 2d30 312d  through.2038-01-
│ │ │ │ +00026870: 3139 2030 333a 3134 3a30 3720 5554 432e  19 03:14:07 UTC.
│ │ │ │ +00026880: 2020 4120 6665 7720 7379 7374 656d 7320    A few systems 
│ │ │ │ +00026890: 7370 6f72 7420 6f74 6865 7220 7469 6d65  sport other time
│ │ │ │ +000268a0: 2072 616e 6765 732e 0a0a 2020 204f 6e20   ranges...   On 
│ │ │ │ +000268b0: 6d6f 7374 2068 6f73 7473 2c20 7468 6573  most hosts, thes
│ │ │ │ +000268c0: 6520 636f 756e 7473 2069 676e 6f72 6520  e counts ignore 
│ │ │ │ +000268d0: 7468 6520 7072 6573 656e 6365 206f 6620  the presence of 
│ │ │ │ +000268e0: 6c65 6170 2073 6563 6f6e 6473 2e20 2046  leap seconds.  F
│ │ │ │ +000268f0: 6f72 0a65 7861 6d70 6c65 2c20 6f6e 206d  or.example, on m
│ │ │ │ +00026900: 6f73 7420 686f 7374 7320 e280 9840 3134  ost hosts ...@14
│ │ │ │ +00026910: 3833 3232 3837 3939 e280 9920 7265 7072  83228799... repr
│ │ │ │ +00026920: 6573 656e 7473 2032 3031 362d 3132 2d33  esents 2016-12-3
│ │ │ │ +00026930: 3120 3233 3a35 393a 3539 2055 5443 2c0a  1 23:59:59 UTC,.
│ │ │ │ +00026940: e280 9840 3134 3833 3232 3838 3030 e280  ...@1483228800..
│ │ │ │ +00026950: 9920 7265 7072 6573 656e 7473 2032 3031  . represents 201
│ │ │ │ +00026960: 372d 3031 2d30 3120 3030 3a30 303a 3030  7-01-01 00:00:00
│ │ │ │ +00026970: 2055 5443 2c20 616e 6420 7468 6572 6520   UTC, and there 
│ │ │ │ +00026980: 6973 206e 6f20 7761 7920 746f 0a72 6570  is no way to.rep
│ │ │ │ +00026990: 7265 7365 6e74 2074 6865 2069 6e74 6572  resent the inter
│ │ │ │ +000269a0: 7665 6e69 6e67 206c 6561 7020 7365 636f  vening leap seco
│ │ │ │ +000269b0: 6e64 2032 3031 362d 3132 2d33 3120 3233  nd 2016-12-31 23
│ │ │ │ +000269c0: 3a35 393a 3630 2055 5443 2e0a 0a1f 0a46  :59:60 UTC.....F
│ │ │ │ +000269d0: 696c 653a 2073 6869 7368 692e 696e 666f  ile: shishi.info
│ │ │ │ +000269e0: 2c20 204e 6f64 653a 2053 7065 6369 6679  ,  Node: Specify
│ │ │ │ +000269f0: 696e 6720 7469 6d65 207a 6f6e 6520 7275  ing time zone ru
│ │ │ │ +00026a00: 6c65 732c 2020 4e65 7874 3a20 4175 7468  les,  Next: Auth
│ │ │ │ +00026a10: 6f72 7320 6f66 2070 6172 7365 5f64 6174  ors of parse_dat
│ │ │ │ +00026a20: 6574 696d 652c 2020 5072 6576 3a20 5365  etime,  Prev: Se
│ │ │ │ +00026a30: 636f 6e64 7320 7369 6e63 6520 7468 6520  conds since the 
│ │ │ │ +00026a40: 4570 6f63 682c 2020 5570 3a20 4461 7465  Epoch,  Up: Date
│ │ │ │ +00026a50: 2069 6e70 7574 2066 6f72 6d61 7473 0a0a   input formats..
│ │ │ │ +00026a60: 342e 3130 2e31 3020 5370 6563 6966 7969  4.10.10 Specifyi
│ │ │ │ +00026a70: 6e67 2074 696d 6520 7a6f 6e65 2072 756c  ng time zone rul
│ │ │ │ +00026a80: 6573 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  es.-------------
│ │ │ │  00026a90: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00026aa0: 2d2d 2d0a 0a4e 6f72 6d61 6c6c 792c 2064  ---..Normally, d
│ │ │ │ -00026ab0: 6174 6573 2061 7265 2069 6e74 6572 7072  ates are interpr
│ │ │ │ -00026ac0: 6574 6564 2075 7369 6e67 2074 6865 2072  eted using the r
│ │ │ │ -00026ad0: 756c 6573 206f 6620 7468 6520 6375 7272  ules of the curr
│ │ │ │ -00026ae0: 656e 7420 7469 6d65 0a7a 6f6e 652c 2077  ent time.zone, w
│ │ │ │ -00026af0: 6869 6368 2069 6e20 7475 726e 2061 7265  hich in turn are
│ │ │ │ -00026b00: 2073 7065 6369 6669 6564 2062 7920 7468   specified by th
│ │ │ │ -00026b10: 6520 e280 9854 5ae2 8099 2065 6e76 6972  e ...TZ... envir
│ │ │ │ -00026b20: 6f6e 6d65 6e74 2076 6172 6961 626c 652c  onment variable,
│ │ │ │ -00026b30: 206f 720a 6279 2061 2073 7973 7465 6d20   or.by a system 
│ │ │ │ -00026b40: 6465 6661 756c 7420 6966 20e2 8098 545a  default if ...TZ
│ │ │ │ -00026b50: e280 9920 6973 206e 6f74 2073 6574 2e20  ... is not set. 
│ │ │ │ -00026b60: 2054 6f20 7370 6563 6966 7920 6120 6469   To specify a di
│ │ │ │ -00026b70: 6666 6572 656e 7420 7365 7420 6f66 0a64  fferent set of.d
│ │ │ │ -00026b80: 6566 6175 6c74 2074 696d 6520 7a6f 6e65  efault time zone
│ │ │ │ -00026b90: 2072 756c 6573 2074 6861 7420 6170 706c   rules that appl
│ │ │ │ -00026ba0: 7920 6a75 7374 2074 6f20 6f6e 6520 6461  y just to one da
│ │ │ │ -00026bb0: 7465 2c20 7374 6172 7420 7468 6520 6461  te, start the da
│ │ │ │ -00026bc0: 7465 2077 6974 680a 6120 7374 7269 6e67  te with.a string
│ │ │ │ -00026bd0: 206f 6620 7468 6520 666f 726d 20e2 8098   of the form ...
│ │ │ │ -00026be0: 545a 3d22 5255 4c45 22e2 8099 2e20 2054  TZ="RULE"....  T
│ │ │ │ -00026bf0: 6865 2074 776f 2071 756f 7465 2063 6861  he two quote cha
│ │ │ │ -00026c00: 7261 6374 6572 7320 28e2 8098 22e2 8099  racters (..."...
│ │ │ │ -00026c10: 2920 6d75 7374 0a62 6520 7072 6573 656e  ) must.be presen
│ │ │ │ -00026c20: 7420 696e 2074 6865 2064 6174 652c 2061  t in the date, a
│ │ │ │ -00026c30: 6e64 2061 6e79 2071 756f 7465 7320 6f72  nd any quotes or
│ │ │ │ -00026c40: 2062 6163 6b73 6c61 7368 6573 2077 6974   backslashes wit
│ │ │ │ -00026c50: 6869 6e20 5255 4c45 206d 7573 740a 6265  hin RULE must.be
│ │ │ │ -00026c60: 2065 7363 6170 6564 2062 7920 6120 6261   escaped by a ba
│ │ │ │ -00026c70: 636b 736c 6173 682e 0a0a 2020 2046 6f72  ckslash...   For
│ │ │ │ -00026c80: 2065 7861 6d70 6c65 2c20 7769 7468 2074   example, with t
│ │ │ │ -00026c90: 6865 2047 4e55 20e2 8098 6461 7465 e280  he GNU ...date..
│ │ │ │ -00026ca0: 9920 636f 6d6d 616e 6420 796f 7520 6361  . command you ca
│ │ │ │ -00026cb0: 6e20 616e 7377 6572 2074 6865 2071 7565  n answer the que
│ │ │ │ -00026cc0: 7374 696f 6e0a 2257 6861 7420 7469 6d65  stion."What time
│ │ │ │ -00026cd0: 2069 7320 6974 2069 6e20 4e65 7720 596f   is it in New Yo
│ │ │ │ -00026ce0: 726b 2077 6865 6e20 6120 5061 7269 7320  rk when a Paris 
│ │ │ │ -00026cf0: 636c 6f63 6b20 7368 6f77 7320 363a 3330  clock shows 6:30
│ │ │ │ -00026d00: 616d 206f 6e20 4f63 746f 6265 720a 3331  am on October.31
│ │ │ │ -00026d10: 2c20 3230 3139 3f22 2020 6279 2075 7369  , 2019?"  by usi
│ │ │ │ -00026d20: 6e67 2061 2064 6174 6520 6265 6769 6e6e  ng a date beginn
│ │ │ │ -00026d30: 696e 6720 7769 7468 20e2 8098 545a 3d22  ing with ...TZ="
│ │ │ │ -00026d40: 4575 726f 7065 2f50 6172 6973 22e2 8099  Europe/Paris"...
│ │ │ │ -00026d50: 2061 7320 7368 6f77 6e0a 696e 2074 6865   as shown.in the
│ │ │ │ -00026d60: 2066 6f6c 6c6f 7769 6e67 2073 6865 6c6c   following shell
│ │ │ │ -00026d70: 2074 7261 6e73 6372 6970 743a 0a0a 2020   transcript:..  
│ │ │ │ -00026d80: 2020 2024 2065 7870 6f72 7420 545a 3d22     $ export TZ="
│ │ │ │ -00026d90: 416d 6572 6963 612f 4e65 775f 596f 726b  America/New_York
│ │ │ │ -00026da0: 220a 2020 2020 2024 2064 6174 6520 2d2d  ".     $ date --
│ │ │ │ -00026db0: 6461 7465 3d27 545a 3d22 4575 726f 7065  date='TZ="Europe
│ │ │ │ -00026dc0: 2f50 6172 6973 2220 3230 3139 2d31 302d  /Paris" 2019-10-
│ │ │ │ -00026dd0: 3331 2030 363a 3330 270a 2020 2020 2053  31 06:30'.     S
│ │ │ │ -00026de0: 756e 204f 6374 2033 3120 3031 3a33 303a  un Oct 31 01:30:
│ │ │ │ -00026df0: 3030 2045 4454 2032 3031 390a 0a20 2020  00 EDT 2019..   
│ │ │ │ -00026e00: 496e 2074 6869 7320 6578 616d 706c 652c  In this example,
│ │ │ │ -00026e10: 2074 6865 20e2 8098 2d2d 6461 7465 e280   the ...--date..
│ │ │ │ -00026e20: 9920 6f70 6572 616e 6420 6265 6769 6e73  . operand begins
│ │ │ │ -00026e30: 2077 6974 6820 6974 7320 6f77 6e20 e280   with its own ..
│ │ │ │ -00026e40: 9854 5ae2 8099 0a73 6574 7469 6e67 2c20  .TZ....setting, 
│ │ │ │ -00026e50: 736f 2074 6865 2072 6573 7420 6f66 2074  so the rest of t
│ │ │ │ -00026e60: 6861 7420 6f70 6572 616e 6420 6973 2070  hat operand is p
│ │ │ │ -00026e70: 726f 6365 7373 6564 2061 6363 6f72 6469  rocessed accordi
│ │ │ │ -00026e80: 6e67 2074 6f0a e280 9845 7572 6f70 652f  ng to....Europe/
│ │ │ │ -00026e90: 5061 7269 73e2 8099 2072 756c 6573 2c20  Paris... rules, 
│ │ │ │ -00026ea0: 7472 6561 7469 6e67 2074 6865 2073 7472  treating the str
│ │ │ │ -00026eb0: 696e 6720 e280 9832 3031 392d 3130 2d33  ing ...2019-10-3
│ │ │ │ -00026ec0: 3120 3036 3a33 30e2 8099 2061 7320 6966  1 06:30... as if
│ │ │ │ -00026ed0: 2069 740a 7765 7265 2069 6e20 5061 7269   it.were in Pari
│ │ │ │ -00026ee0: 732e 2020 486f 7765 7665 722c 2073 696e  s.  However, sin
│ │ │ │ -00026ef0: 6365 2074 6865 206f 7574 7075 7420 6f66  ce the output of
│ │ │ │ -00026f00: 2074 6865 20e2 8098 6461 7465 e280 9920   the ...date... 
│ │ │ │ -00026f10: 636f 6d6d 616e 6420 6973 0a70 726f 6365  command is.proce
│ │ │ │ -00026f20: 7373 6564 2061 6363 6f72 6469 6e67 2074  ssed according t
│ │ │ │ -00026f30: 6f20 7468 6520 6f76 6572 616c 6c20 7469  o the overall ti
│ │ │ │ -00026f40: 6d65 207a 6f6e 6520 7275 6c65 732c 2069  me zone rules, i
│ │ │ │ -00026f50: 7420 7573 6573 204e 6577 2059 6f72 6b0a  t uses New York.
│ │ │ │ -00026f60: 7469 6d65 2e20 2028 5061 7269 7320 7761  time.  (Paris wa
│ │ │ │ -00026f70: 7320 6e6f 726d 616c 6c79 2073 6978 2068  s normally six h
│ │ │ │ -00026f80: 6f75 7273 2061 6865 6164 206f 6620 4e65  ours ahead of Ne
│ │ │ │ -00026f90: 7720 596f 726b 2069 6e20 3230 3139 2c20  w York in 2019, 
│ │ │ │ -00026fa0: 6275 7420 7468 6973 0a65 7861 6d70 6c65  but this.example
│ │ │ │ -00026fb0: 2072 6566 6572 7320 746f 2061 2062 7269   refers to a bri
│ │ │ │ -00026fc0: 6566 2048 616c 6c6f 7765 656e 2070 6572  ef Halloween per
│ │ │ │ -00026fd0: 696f 6420 7768 656e 2074 6865 2067 6170  iod when the gap
│ │ │ │ -00026fe0: 2077 6173 2066 6976 6520 686f 7572 732e   was five hours.
│ │ │ │ -00026ff0: 290a 0a20 2020 4120 e280 9854 5ae2 8099  )..   A ...TZ...
│ │ │ │ -00027000: 2076 616c 7565 2069 7320 6120 7275 6c65   value is a rule
│ │ │ │ -00027010: 2074 6861 7420 7479 7069 6361 6c6c 7920   that typically 
│ │ │ │ -00027020: 6e61 6d65 7320 6120 6c6f 6361 7469 6f6e  names a location
│ │ │ │ -00027030: 2069 6e20 7468 6520 e280 9874 7ae2 8099   in the ...tz...
│ │ │ │ -00027040: 0a64 6174 6162 6173 6520 2868 7474 7073  .database (https
│ │ │ │ -00027050: 3a2f 2f77 7777 2e69 616e 612e 6f72 672f  ://www.iana.org/
│ │ │ │ -00027060: 7469 6d65 2d7a 6f6e 6573 292e 2020 4120  time-zones).  A 
│ │ │ │ -00027070: 7265 6365 6e74 2063 6174 616c 6f67 206f  recent catalog o
│ │ │ │ -00027080: 660a 6c6f 6361 7469 6f6e 206e 616d 6573  f.location names
│ │ │ │ -00027090: 2061 7070 6561 7273 2069 6e20 7468 6520   appears in the 
│ │ │ │ -000270a0: 5457 696b 6920 4461 7465 2061 6e64 2054  TWiki Date and T
│ │ │ │ -000270b0: 696d 6520 4761 7465 7761 790a 2868 7474  ime Gateway.(htt
│ │ │ │ -000270c0: 7073 3a2f 2f74 7769 6b69 2e6f 7267 2f63  ps://twiki.org/c
│ │ │ │ -000270d0: 6769 2d62 696e 2f78 7472 612f 747a 6461  gi-bin/xtra/tzda
│ │ │ │ -000270e0: 7465 7069 636b 2e68 746d 6c29 2e20 2041  tepick.html).  A
│ │ │ │ -000270f0: 2066 6577 206e 6f6e 2d47 4e55 2068 6f73   few non-GNU hos
│ │ │ │ -00027100: 7473 0a72 6571 7569 7265 2061 2063 6f6c  ts.require a col
│ │ │ │ -00027110: 6f6e 2062 6566 6f72 6520 6120 6c6f 6361  on before a loca
│ │ │ │ -00027120: 7469 6f6e 206e 616d 6520 696e 2061 20e2  tion name in a .
│ │ │ │ -00027130: 8098 545a e280 9920 7365 7474 696e 672c  ..TZ... setting,
│ │ │ │ -00027140: 2065 2e67 2e2c 0ae2 8098 545a 3d22 3a41   e.g.,....TZ=":A
│ │ │ │ -00027150: 6d65 7269 6361 2f4e 6577 5f59 6f72 6b22  merica/New_York"
│ │ │ │ -00027160: e280 992e 0a0a 2020 2054 6865 20e2 8098  ......   The ...
│ │ │ │ -00027170: 747a e280 9920 6461 7461 6261 7365 2069  tz... database i
│ │ │ │ -00027180: 6e63 6c75 6465 7320 6120 7769 6465 2076  ncludes a wide v
│ │ │ │ -00027190: 6172 6965 7479 206f 6620 6c6f 6361 7469  ariety of locati
│ │ │ │ -000271a0: 6f6e 7320 7261 6e67 696e 6720 6672 6f6d  ons ranging from
│ │ │ │ -000271b0: 0ae2 8098 4166 7269 6361 2f41 6269 646a  ....Africa/Abidj
│ │ │ │ -000271c0: 616e e280 9920 746f 20e2 8098 5061 6369  an... to ...Paci
│ │ │ │ -000271d0: 6669 632f 546f 6e67 6174 6170 75e2 8099  fic/Tongatapu...
│ │ │ │ -000271e0: 2c20 6275 7420 6966 2079 6f75 2061 7265  , but if you are
│ │ │ │ -000271f0: 2061 7420 7365 6120 616e 6420 6861 7665   at sea and have
│ │ │ │ -00027200: 0a79 6f75 7220 6f77 6e20 7072 6976 6174  .your own privat
│ │ │ │ -00027210: 6520 7469 6d65 207a 6f6e 652c 206f 7220  e time zone, or 
│ │ │ │ -00027220: 6966 2079 6f75 2061 7265 2075 7369 6e67  if you are using
│ │ │ │ -00027230: 2061 206e 6f6e 2d47 4e55 2068 6f73 7420   a non-GNU host 
│ │ │ │ -00027240: 7468 6174 2064 6f65 730a 6e6f 7420 7375  that does.not su
│ │ │ │ -00027250: 7070 6f72 7420 7468 6520 e280 9874 7ae2  pport the ...tz.
│ │ │ │ -00027260: 8099 2064 6174 6162 6173 652c 2079 6f75  .. database, you
│ │ │ │ -00027270: 206d 6179 206e 6565 6420 746f 2075 7365   may need to use
│ │ │ │ -00027280: 2061 2050 4f53 4958 2072 756c 6520 696e   a POSIX rule in
│ │ │ │ -00027290: 7374 6561 642e 0a54 6865 2070 7265 7669  stead..The previ
│ │ │ │ -000272a0: 6f75 736c 792d 6d65 6e74 696f 6e65 6420  ously-mentioned 
│ │ │ │ -000272b0: 504f 5349 5820 7275 6c65 20e2 8098 5554  POSIX rule ...UT
│ │ │ │ -000272c0: 4330 e280 9920 7361 7973 2074 6861 7420  C0... says that 
│ │ │ │ -000272d0: 7468 6520 7469 6d65 207a 6f6e 650a 6162  the time zone.ab
│ │ │ │ -000272e0: 6272 6576 6961 7469 6f6e 2069 7320 e280  breviation is ..
│ │ │ │ -000272f0: 9855 5443 e280 992c 2074 6865 207a 6f6e  .UTC..., the zon
│ │ │ │ -00027300: 6520 6973 207a 6572 6f20 686f 7572 7320  e is zero hours 
│ │ │ │ -00027310: 6177 6179 2066 726f 6d20 4772 6565 6e77  away from Greenw
│ │ │ │ -00027320: 6963 682c 2061 6e64 0a74 6865 7265 2069  ich, and.there i
│ │ │ │ -00027330: 7320 6e6f 2064 6179 6c69 6768 7420 7361  s no daylight sa
│ │ │ │ -00027340: 7669 6e67 2074 696d 652e 2020 504f 5349  ving time.  POSI
│ │ │ │ -00027350: 5820 7275 6c65 7320 6361 6e20 616c 736f  X rules can also
│ │ │ │ -00027360: 2073 7065 6369 6679 206e 6f6e 7a65 726f   specify nonzero
│ │ │ │ -00027370: 0a47 7265 656e 7769 6368 206f 6666 7365  .Greenwich offse
│ │ │ │ -00027380: 7473 2e20 2046 6f72 2065 7861 6d70 6c65  ts.  For example
│ │ │ │ -00027390: 2c20 7468 6520 666f 6c6c 6f77 696e 6720  , the following 
│ │ │ │ -000273a0: 7368 656c 6c20 7472 616e 7363 7269 7074  shell transcript
│ │ │ │ -000273b0: 2061 6e73 7765 7273 0a74 6865 2071 7565   answers.the que
│ │ │ │ -000273c0: 7374 696f 6e20 2257 6861 7420 7469 6d65  stion "What time
│ │ │ │ -000273d0: 2069 7320 6974 2066 6976 6520 616e 6420   is it five and 
│ │ │ │ -000273e0: 6120 6861 6c66 2068 6f75 7273 2065 6173  a half hours eas
│ │ │ │ -000273f0: 7420 6f66 2047 7265 656e 7769 6368 0a77  t of Greenwich.w
│ │ │ │ -00027400: 6865 6e20 6120 636c 6f63 6b20 7365 7665  hen a clock seve
│ │ │ │ -00027410: 6e20 686f 7572 7320 7765 7374 206f 6620  n hours west of 
│ │ │ │ -00027420: 4772 6565 6e77 6963 6820 7368 6f77 7320  Greenwich shows 
│ │ │ │ -00027430: 393a 3530 706d 206f 6e20 4a75 6c79 2031  9:50pm on July 1
│ │ │ │ -00027440: 322c 0a32 3032 323f 220a 0a20 2020 2020  2,.2022?"..     
│ │ │ │ -00027450: 2420 545a 3d22 3c2b 3035 3330 3e2d 353a  $ TZ="<+0530>-5:
│ │ │ │ -00027460: 3330 2220 6461 7465 202d 2d64 6174 653d  30" date --date=
│ │ │ │ -00027470: 2754 5a3d 223c 2d30 373e 2b37 2220 3230  'TZ="<-07>+7" 20
│ │ │ │ -00027480: 3232 2d30 372d 3132 2032 313a 3530 270a  22-07-12 21:50'.
│ │ │ │ -00027490: 2020 2020 2057 6564 204a 756c 2031 3320       Wed Jul 13 
│ │ │ │ -000274a0: 3130 3a32 303a 3030 202b 3035 3330 2032  10:20:00 +0530 2
│ │ │ │ -000274b0: 3032 320a 0a54 6869 7320 6578 616d 706c  022..This exampl
│ │ │ │ -000274c0: 6520 7573 6573 2074 6865 2073 6f6d 6577  e uses the somew
│ │ │ │ -000274d0: 6861 742d 636f 6e66 7573 696e 6720 504f  hat-confusing PO
│ │ │ │ -000274e0: 5349 5820 636f 6e76 656e 7469 6f6e 2066  SIX convention f
│ │ │ │ -000274f0: 6f72 2072 756c 6573 2e0a e280 9854 5a3d  or rules.....TZ=
│ │ │ │ -00027500: 223c 2d30 373e 2b37 22e2 8099 2073 6179  "<-07>+7"... say
│ │ │ │ -00027510: 7320 7468 6174 2074 6865 2074 696d 6520  s that the time 
│ │ │ │ -00027520: 7a6f 6e65 2061 6262 7265 7669 6174 696f  zone abbreviatio
│ │ │ │ -00027530: 6e20 6973 20e2 8098 2d30 37e2 8099 2061  n is ...-07... a
│ │ │ │ -00027540: 6e64 2074 6865 0a74 696d 6520 7a6f 6e65  nd the.time zone
│ │ │ │ -00027550: 2069 7320 3720 686f 7572 7320 7765 7374   is 7 hours west
│ │ │ │ -00027560: 206f 6620 4772 6565 6e77 6963 682c 2061   of Greenwich, a
│ │ │ │ -00027570: 6e64 20e2 8098 545a 3d22 3c2b 3035 3330  nd ...TZ="<+0530
│ │ │ │ -00027580: 3e2d 353a 3330 22e2 8099 2073 6179 730a  >-5:30"... says.
│ │ │ │ -00027590: 7468 6174 2074 6865 2074 696d 6520 7a6f  that the time zo
│ │ │ │ -000275a0: 6e65 2061 6262 7265 7669 6174 696f 6e20  ne abbreviation 
│ │ │ │ -000275b0: 6973 20e2 8098 2b30 3533 30e2 8099 2061  is ...+0530... a
│ │ │ │ -000275c0: 6e64 2074 6865 2074 696d 6520 7a6f 6e65  nd the time zone
│ │ │ │ -000275d0: 2069 7320 3520 686f 7572 730a 3330 206d   is 5 hours.30 m
│ │ │ │ -000275e0: 696e 7574 6573 2065 6173 7420 6f66 2047  inutes east of G
│ │ │ │ -000275f0: 7265 656e 7769 6368 2e20 2041 6c74 686f  reenwich.  Altho
│ │ │ │ -00027600: 7567 6820 7472 6963 6b69 6572 2050 4f53  ugh trickier POS
│ │ │ │ -00027610: 4958 20e2 8098 545a e280 9920 7365 7474  IX ...TZ... sett
│ │ │ │ -00027620: 696e 6773 0a6c 696b 6520 e280 9854 5a3d  ings.like ...TZ=
│ │ │ │ -00027630: 223c 2d30 353e 2b35 3c2d 3034 3e2c 4d33  "<-05>+5<-04>,M3
│ │ │ │ -00027640: 2e32 2e30 2f32 2c4d 3131 2e31 2e30 2f32  .2.0/2,M11.1.0/2
│ │ │ │ -00027650: 22e2 8099 2063 616e 2073 7065 6369 6679  "... can specify
│ │ │ │ -00027660: 2073 6f6d 6520 6461 796c 6967 6874 0a73   some daylight.s
│ │ │ │ -00027670: 6176 696e 6720 7265 6769 6d65 732c 206c  aving regimes, l
│ │ │ │ -00027680: 6f63 6174 696f 6e2d 6261 7365 6420 7365  ocation-based se
│ │ │ │ -00027690: 7474 696e 6773 206c 696b 6520 e280 9854  ttings like ...T
│ │ │ │ -000276a0: 5a3d 2241 6d65 7269 6361 2f4e 6577 5f59  Z="America/New_Y
│ │ │ │ -000276b0: 6f72 6b22 e280 9920 6172 650a 7479 7069  ork"... are.typi
│ │ │ │ -000276c0: 6361 6c6c 7920 7369 6d70 6c65 7220 616e  cally simpler an
│ │ │ │ -000276d0: 6420 6d6f 7265 2061 6363 7572 6174 6520  d more accurate 
│ │ │ │ -000276e0: 6869 7374 6f72 6963 616c 6c79 2e20 202a  historically.  *
│ │ │ │ -000276f0: 4e6f 7465 2053 7065 6369 6679 696e 6720  Note Specifying 
│ │ │ │ -00027700: 7468 650a 5469 6d65 205a 6f6e 6520 7769  the.Time Zone wi
│ │ │ │ -00027710: 7468 20e2 8098 545a e280 993a 2028 6c69  th ...TZ...: (li
│ │ │ │ -00027720: 6263 2954 5a20 5661 7269 6162 6c65 2e0a  bc)TZ Variable..
│ │ │ │ -00027730: 0a1f 0a46 696c 653a 2073 6869 7368 692e  ...File: shishi.
│ │ │ │ -00027740: 696e 666f 2c20 204e 6f64 653a 2041 7574  info,  Node: Aut
│ │ │ │ -00027750: 686f 7273 206f 6620 7061 7273 655f 6461  hors of parse_da
│ │ │ │ -00027760: 7465 7469 6d65 2c20 2050 7265 763a 2053  tetime,  Prev: S
│ │ │ │ -00027770: 7065 6369 6679 696e 6720 7469 6d65 207a  pecifying time z
│ │ │ │ -00027780: 6f6e 6520 7275 6c65 732c 2020 5570 3a20  one rules,  Up: 
│ │ │ │ -00027790: 4461 7465 2069 6e70 7574 2066 6f72 6d61  Date input forma
│ │ │ │ -000277a0: 7473 0a0a 342e 3130 2e31 3120 4175 7468  ts..4.10.11 Auth
│ │ │ │ -000277b0: 6f72 7320 6f66 20e2 8098 7061 7273 655f  ors of ...parse_
│ │ │ │ -000277c0: 6461 7465 7469 6d65 e280 990a 2d2d 2d2d  datetime....----
│ │ │ │ +00026aa0: 2d2d 2d2d 2d0a 0a4e 6f72 6d61 6c6c 792c  -----..Normally,
│ │ │ │ +00026ab0: 2064 6174 6573 2061 7265 2069 6e74 6572   dates are inter
│ │ │ │ +00026ac0: 7072 6574 6564 2075 7369 6e67 2074 6865  preted using the
│ │ │ │ +00026ad0: 2072 756c 6573 206f 6620 7468 6520 6375   rules of the cu
│ │ │ │ +00026ae0: 7272 656e 7420 7469 6d65 0a7a 6f6e 652c  rrent time.zone,
│ │ │ │ +00026af0: 2077 6869 6368 2069 6e20 7475 726e 2061   which in turn a
│ │ │ │ +00026b00: 7265 2073 7065 6369 6669 6564 2062 7920  re specified by 
│ │ │ │ +00026b10: 7468 6520 e280 9854 5ae2 8099 2065 6e76  the ...TZ... env
│ │ │ │ +00026b20: 6972 6f6e 6d65 6e74 2076 6172 6961 626c  ironment variabl
│ │ │ │ +00026b30: 652c 206f 720a 6279 2061 2073 7973 7465  e, or.by a syste
│ │ │ │ +00026b40: 6d20 6465 6661 756c 7420 6966 20e2 8098  m default if ...
│ │ │ │ +00026b50: 545a e280 9920 6973 206e 6f74 2073 6574  TZ... is not set
│ │ │ │ +00026b60: 2e20 2054 6f20 7370 6563 6966 7920 6120  .  To specify a 
│ │ │ │ +00026b70: 6469 6666 6572 656e 7420 7365 7420 6f66  different set of
│ │ │ │ +00026b80: 0a64 6566 6175 6c74 2074 696d 6520 7a6f  .default time zo
│ │ │ │ +00026b90: 6e65 2072 756c 6573 2074 6861 7420 6170  ne rules that ap
│ │ │ │ +00026ba0: 706c 7920 6a75 7374 2074 6f20 6f6e 6520  ply just to one 
│ │ │ │ +00026bb0: 6461 7465 2c20 7374 6172 7420 7468 6520  date, start the 
│ │ │ │ +00026bc0: 6461 7465 2077 6974 680a 6120 7374 7269  date with.a stri
│ │ │ │ +00026bd0: 6e67 206f 6620 7468 6520 666f 726d 20e2  ng of the form .
│ │ │ │ +00026be0: 8098 545a 3d22 5255 4c45 22e2 8099 2e20  ..TZ="RULE".... 
│ │ │ │ +00026bf0: 2054 6865 2074 776f 2071 756f 7465 2063   The two quote c
│ │ │ │ +00026c00: 6861 7261 6374 6572 7320 28e2 8098 22e2  haracters (...".
│ │ │ │ +00026c10: 8099 2920 6d75 7374 0a62 6520 7072 6573  ..) must.be pres
│ │ │ │ +00026c20: 656e 7420 696e 2074 6865 2064 6174 652c  ent in the date,
│ │ │ │ +00026c30: 2061 6e64 2061 6e79 2071 756f 7465 7320   and any quotes 
│ │ │ │ +00026c40: 6f72 2062 6163 6b73 6c61 7368 6573 2077  or backslashes w
│ │ │ │ +00026c50: 6974 6869 6e20 5255 4c45 206d 7573 740a  ithin RULE must.
│ │ │ │ +00026c60: 6265 2065 7363 6170 6564 2062 7920 6120  be escaped by a 
│ │ │ │ +00026c70: 6261 636b 736c 6173 682e 0a0a 2020 2046  backslash...   F
│ │ │ │ +00026c80: 6f72 2065 7861 6d70 6c65 2c20 7769 7468  or example, with
│ │ │ │ +00026c90: 2074 6865 2047 4e55 20e2 8098 6461 7465   the GNU ...date
│ │ │ │ +00026ca0: e280 9920 636f 6d6d 616e 6420 796f 7520  ... command you 
│ │ │ │ +00026cb0: 6361 6e20 616e 7377 6572 2074 6865 2071  can answer the q
│ │ │ │ +00026cc0: 7565 7374 696f 6e0a 2257 6861 7420 7469  uestion."What ti
│ │ │ │ +00026cd0: 6d65 2069 7320 6974 2069 6e20 4e65 7720  me is it in New 
│ │ │ │ +00026ce0: 596f 726b 2077 6865 6e20 6120 5061 7269  York when a Pari
│ │ │ │ +00026cf0: 7320 636c 6f63 6b20 7368 6f77 7320 363a  s clock shows 6:
│ │ │ │ +00026d00: 3330 616d 206f 6e20 4f63 746f 6265 720a  30am on October.
│ │ │ │ +00026d10: 3331 2c20 3230 3139 3f22 2020 6279 2075  31, 2019?"  by u
│ │ │ │ +00026d20: 7369 6e67 2061 2064 6174 6520 6265 6769  sing a date begi
│ │ │ │ +00026d30: 6e6e 696e 6720 7769 7468 20e2 8098 545a  nning with ...TZ
│ │ │ │ +00026d40: 3d22 4575 726f 7065 2f50 6172 6973 22e2  ="Europe/Paris".
│ │ │ │ +00026d50: 8099 2061 7320 7368 6f77 6e0a 696e 2074  .. as shown.in t
│ │ │ │ +00026d60: 6865 2066 6f6c 6c6f 7769 6e67 2073 6865  he following she
│ │ │ │ +00026d70: 6c6c 2074 7261 6e73 6372 6970 743a 0a0a  ll transcript:..
│ │ │ │ +00026d80: 2020 2020 2024 2065 7870 6f72 7420 545a       $ export TZ
│ │ │ │ +00026d90: 3d22 416d 6572 6963 612f 4e65 775f 596f  ="America/New_Yo
│ │ │ │ +00026da0: 726b 220a 2020 2020 2024 2064 6174 6520  rk".     $ date 
│ │ │ │ +00026db0: 2d2d 6461 7465 3d27 545a 3d22 4575 726f  --date='TZ="Euro
│ │ │ │ +00026dc0: 7065 2f50 6172 6973 2220 3230 3139 2d31  pe/Paris" 2019-1
│ │ │ │ +00026dd0: 302d 3331 2030 363a 3330 270a 2020 2020  0-31 06:30'.    
│ │ │ │ +00026de0: 2053 756e 204f 6374 2033 3120 3031 3a33   Sun Oct 31 01:3
│ │ │ │ +00026df0: 303a 3030 2045 4454 2032 3031 390a 0a20  0:00 EDT 2019.. 
│ │ │ │ +00026e00: 2020 496e 2074 6869 7320 6578 616d 706c    In this exampl
│ │ │ │ +00026e10: 652c 2074 6865 20e2 8098 2d2d 6461 7465  e, the ...--date
│ │ │ │ +00026e20: e280 9920 6f70 6572 616e 6420 6265 6769  ... operand begi
│ │ │ │ +00026e30: 6e73 2077 6974 6820 6974 7320 6f77 6e20  ns with its own 
│ │ │ │ +00026e40: e280 9854 5ae2 8099 0a73 6574 7469 6e67  ...TZ....setting
│ │ │ │ +00026e50: 2c20 736f 2074 6865 2072 6573 7420 6f66  , so the rest of
│ │ │ │ +00026e60: 2074 6861 7420 6f70 6572 616e 6420 6973   that operand is
│ │ │ │ +00026e70: 2070 726f 6365 7373 6564 2061 6363 6f72   processed accor
│ │ │ │ +00026e80: 6469 6e67 2074 6f0a e280 9845 7572 6f70  ding to....Europ
│ │ │ │ +00026e90: 652f 5061 7269 73e2 8099 2072 756c 6573  e/Paris... rules
│ │ │ │ +00026ea0: 2c20 7472 6561 7469 6e67 2074 6865 2073  , treating the s
│ │ │ │ +00026eb0: 7472 696e 6720 e280 9832 3031 392d 3130  tring ...2019-10
│ │ │ │ +00026ec0: 2d33 3120 3036 3a33 30e2 8099 2061 7320  -31 06:30... as 
│ │ │ │ +00026ed0: 6966 2069 740a 7765 7265 2069 6e20 5061  if it.were in Pa
│ │ │ │ +00026ee0: 7269 732e 2020 486f 7765 7665 722c 2073  ris.  However, s
│ │ │ │ +00026ef0: 696e 6365 2074 6865 206f 7574 7075 7420  ince the output 
│ │ │ │ +00026f00: 6f66 2074 6865 20e2 8098 6461 7465 e280  of the ...date..
│ │ │ │ +00026f10: 9920 636f 6d6d 616e 6420 6973 0a70 726f  . command is.pro
│ │ │ │ +00026f20: 6365 7373 6564 2061 6363 6f72 6469 6e67  cessed according
│ │ │ │ +00026f30: 2074 6f20 7468 6520 6f76 6572 616c 6c20   to the overall 
│ │ │ │ +00026f40: 7469 6d65 207a 6f6e 6520 7275 6c65 732c  time zone rules,
│ │ │ │ +00026f50: 2069 7420 7573 6573 204e 6577 2059 6f72   it uses New Yor
│ │ │ │ +00026f60: 6b0a 7469 6d65 2e20 2028 5061 7269 7320  k.time.  (Paris 
│ │ │ │ +00026f70: 7761 7320 6e6f 726d 616c 6c79 2073 6978  was normally six
│ │ │ │ +00026f80: 2068 6f75 7273 2061 6865 6164 206f 6620   hours ahead of 
│ │ │ │ +00026f90: 4e65 7720 596f 726b 2069 6e20 3230 3139  New York in 2019
│ │ │ │ +00026fa0: 2c20 6275 7420 7468 6973 0a65 7861 6d70  , but this.examp
│ │ │ │ +00026fb0: 6c65 2072 6566 6572 7320 746f 2061 2062  le refers to a b
│ │ │ │ +00026fc0: 7269 6566 2048 616c 6c6f 7765 656e 2070  rief Halloween p
│ │ │ │ +00026fd0: 6572 696f 6420 7768 656e 2074 6865 2067  eriod when the g
│ │ │ │ +00026fe0: 6170 2077 6173 2066 6976 6520 686f 7572  ap was five hour
│ │ │ │ +00026ff0: 732e 290a 0a20 2020 4120 e280 9854 5ae2  s.)..   A ...TZ.
│ │ │ │ +00027000: 8099 2076 616c 7565 2069 7320 6120 7275  .. value is a ru
│ │ │ │ +00027010: 6c65 2074 6861 7420 7479 7069 6361 6c6c  le that typicall
│ │ │ │ +00027020: 7920 6e61 6d65 7320 6120 6c6f 6361 7469  y names a locati
│ │ │ │ +00027030: 6f6e 2069 6e20 7468 6520 e280 9874 7ae2  on in the ...tz.
│ │ │ │ +00027040: 8099 0a64 6174 6162 6173 6520 2868 7474  ...database (htt
│ │ │ │ +00027050: 7073 3a2f 2f77 7777 2e69 616e 612e 6f72  ps://www.iana.or
│ │ │ │ +00027060: 672f 7469 6d65 2d7a 6f6e 6573 292e 2020  g/time-zones).  
│ │ │ │ +00027070: 4120 7265 6365 6e74 2063 6174 616c 6f67  A recent catalog
│ │ │ │ +00027080: 206f 660a 6c6f 6361 7469 6f6e 206e 616d   of.location nam
│ │ │ │ +00027090: 6573 2061 7070 6561 7273 2069 6e20 7468  es appears in th
│ │ │ │ +000270a0: 6520 5457 696b 6920 4461 7465 2061 6e64  e TWiki Date and
│ │ │ │ +000270b0: 2054 696d 6520 4761 7465 7761 790a 2868   Time Gateway.(h
│ │ │ │ +000270c0: 7474 7073 3a2f 2f74 7769 6b69 2e6f 7267  ttps://twiki.org
│ │ │ │ +000270d0: 2f63 6769 2d62 696e 2f78 7472 612f 747a  /cgi-bin/xtra/tz
│ │ │ │ +000270e0: 6461 7465 7069 636b 2e68 746d 6c29 2e20  datepick.html). 
│ │ │ │ +000270f0: 2041 2066 6577 206e 6f6e 2d47 4e55 2068   A few non-GNU h
│ │ │ │ +00027100: 6f73 7473 0a72 6571 7569 7265 2061 2063  osts.require a c
│ │ │ │ +00027110: 6f6c 6f6e 2062 6566 6f72 6520 6120 6c6f  olon before a lo
│ │ │ │ +00027120: 6361 7469 6f6e 206e 616d 6520 696e 2061  cation name in a
│ │ │ │ +00027130: 20e2 8098 545a e280 9920 7365 7474 696e   ...TZ... settin
│ │ │ │ +00027140: 672c 2065 2e67 2e2c 0ae2 8098 545a 3d22  g, e.g.,....TZ="
│ │ │ │ +00027150: 3a41 6d65 7269 6361 2f4e 6577 5f59 6f72  :America/New_Yor
│ │ │ │ +00027160: 6b22 e280 992e 0a0a 2020 2054 6865 20e2  k"......   The .
│ │ │ │ +00027170: 8098 747a e280 9920 6461 7461 6261 7365  ..tz... database
│ │ │ │ +00027180: 2069 6e63 6c75 6465 7320 6120 7769 6465   includes a wide
│ │ │ │ +00027190: 2076 6172 6965 7479 206f 6620 6c6f 6361   variety of loca
│ │ │ │ +000271a0: 7469 6f6e 7320 7261 6e67 696e 6720 6672  tions ranging fr
│ │ │ │ +000271b0: 6f6d 0ae2 8098 4166 7269 6361 2f41 6269  om....Africa/Abi
│ │ │ │ +000271c0: 646a 616e e280 9920 746f 20e2 8098 5061  djan... to ...Pa
│ │ │ │ +000271d0: 6369 6669 632f 546f 6e67 6174 6170 75e2  cific/Tongatapu.
│ │ │ │ +000271e0: 8099 2c20 6275 7420 6966 2079 6f75 2061  .., but if you a
│ │ │ │ +000271f0: 7265 2061 7420 7365 6120 616e 6420 6861  re at sea and ha
│ │ │ │ +00027200: 7665 0a79 6f75 7220 6f77 6e20 7072 6976  ve.your own priv
│ │ │ │ +00027210: 6174 6520 7469 6d65 207a 6f6e 652c 206f  ate time zone, o
│ │ │ │ +00027220: 7220 6966 2079 6f75 2061 7265 2075 7369  r if you are usi
│ │ │ │ +00027230: 6e67 2061 206e 6f6e 2d47 4e55 2068 6f73  ng a non-GNU hos
│ │ │ │ +00027240: 7420 7468 6174 2064 6f65 730a 6e6f 7420  t that does.not 
│ │ │ │ +00027250: 7375 7070 6f72 7420 7468 6520 e280 9874  support the ...t
│ │ │ │ +00027260: 7ae2 8099 2064 6174 6162 6173 652c 2079  z... database, y
│ │ │ │ +00027270: 6f75 206d 6179 206e 6565 6420 746f 2075  ou may need to u
│ │ │ │ +00027280: 7365 2061 2050 4f53 4958 2072 756c 6520  se a POSIX rule 
│ │ │ │ +00027290: 696e 7374 6561 642e 0a54 6865 2070 7265  instead..The pre
│ │ │ │ +000272a0: 7669 6f75 736c 792d 6d65 6e74 696f 6e65  viously-mentione
│ │ │ │ +000272b0: 6420 504f 5349 5820 7275 6c65 20e2 8098  d POSIX rule ...
│ │ │ │ +000272c0: 5554 4330 e280 9920 7361 7973 2074 6861  UTC0... says tha
│ │ │ │ +000272d0: 7420 7468 6520 7469 6d65 207a 6f6e 650a  t the time zone.
│ │ │ │ +000272e0: 6162 6272 6576 6961 7469 6f6e 2069 7320  abbreviation is 
│ │ │ │ +000272f0: e280 9855 5443 e280 992c 2074 6865 207a  ...UTC..., the z
│ │ │ │ +00027300: 6f6e 6520 6973 207a 6572 6f20 686f 7572  one is zero hour
│ │ │ │ +00027310: 7320 6177 6179 2066 726f 6d20 4772 6565  s away from Gree
│ │ │ │ +00027320: 6e77 6963 682c 2061 6e64 0a74 6865 7265  nwich, and.there
│ │ │ │ +00027330: 2069 7320 6e6f 2064 6179 6c69 6768 7420   is no daylight 
│ │ │ │ +00027340: 7361 7669 6e67 2074 696d 652e 2020 504f  saving time.  PO
│ │ │ │ +00027350: 5349 5820 7275 6c65 7320 6361 6e20 616c  SIX rules can al
│ │ │ │ +00027360: 736f 2073 7065 6369 6679 206e 6f6e 7a65  so specify nonze
│ │ │ │ +00027370: 726f 0a47 7265 656e 7769 6368 206f 6666  ro.Greenwich off
│ │ │ │ +00027380: 7365 7473 2e20 2046 6f72 2065 7861 6d70  sets.  For examp
│ │ │ │ +00027390: 6c65 2c20 7468 6520 666f 6c6c 6f77 696e  le, the followin
│ │ │ │ +000273a0: 6720 7368 656c 6c20 7472 616e 7363 7269  g shell transcri
│ │ │ │ +000273b0: 7074 2061 6e73 7765 7273 0a74 6865 2071  pt answers.the q
│ │ │ │ +000273c0: 7565 7374 696f 6e20 2257 6861 7420 7469  uestion "What ti
│ │ │ │ +000273d0: 6d65 2069 7320 6974 2066 6976 6520 616e  me is it five an
│ │ │ │ +000273e0: 6420 6120 6861 6c66 2068 6f75 7273 2065  d a half hours e
│ │ │ │ +000273f0: 6173 7420 6f66 2047 7265 656e 7769 6368  ast of Greenwich
│ │ │ │ +00027400: 0a77 6865 6e20 6120 636c 6f63 6b20 7365  .when a clock se
│ │ │ │ +00027410: 7665 6e20 686f 7572 7320 7765 7374 206f  ven hours west o
│ │ │ │ +00027420: 6620 4772 6565 6e77 6963 6820 7368 6f77  f Greenwich show
│ │ │ │ +00027430: 7320 393a 3530 706d 206f 6e20 4a75 6c79  s 9:50pm on July
│ │ │ │ +00027440: 2031 322c 0a32 3032 323f 220a 0a20 2020   12,.2022?"..   
│ │ │ │ +00027450: 2020 2420 545a 3d22 3c2b 3035 3330 3e2d    $ TZ="<+0530>-
│ │ │ │ +00027460: 353a 3330 2220 6461 7465 202d 2d64 6174  5:30" date --dat
│ │ │ │ +00027470: 653d 2754 5a3d 223c 2d30 373e 2b37 2220  e='TZ="<-07>+7" 
│ │ │ │ +00027480: 3230 3232 2d30 372d 3132 2032 313a 3530  2022-07-12 21:50
│ │ │ │ +00027490: 270a 2020 2020 2057 6564 204a 756c 2031  '.     Wed Jul 1
│ │ │ │ +000274a0: 3320 3130 3a32 303a 3030 202b 3035 3330  3 10:20:00 +0530
│ │ │ │ +000274b0: 2032 3032 320a 0a54 6869 7320 6578 616d   2022..This exam
│ │ │ │ +000274c0: 706c 6520 7573 6573 2074 6865 2073 6f6d  ple uses the som
│ │ │ │ +000274d0: 6577 6861 742d 636f 6e66 7573 696e 6720  ewhat-confusing 
│ │ │ │ +000274e0: 504f 5349 5820 636f 6e76 656e 7469 6f6e  POSIX convention
│ │ │ │ +000274f0: 2066 6f72 2072 756c 6573 2e0a e280 9854   for rules.....T
│ │ │ │ +00027500: 5a3d 223c 2d30 373e 2b37 22e2 8099 2073  Z="<-07>+7"... s
│ │ │ │ +00027510: 6179 7320 7468 6174 2074 6865 2074 696d  ays that the tim
│ │ │ │ +00027520: 6520 7a6f 6e65 2061 6262 7265 7669 6174  e zone abbreviat
│ │ │ │ +00027530: 696f 6e20 6973 20e2 8098 2d30 37e2 8099  ion is ...-07...
│ │ │ │ +00027540: 2061 6e64 2074 6865 0a74 696d 6520 7a6f   and the.time zo
│ │ │ │ +00027550: 6e65 2069 7320 3720 686f 7572 7320 7765  ne is 7 hours we
│ │ │ │ +00027560: 7374 206f 6620 4772 6565 6e77 6963 682c  st of Greenwich,
│ │ │ │ +00027570: 2061 6e64 20e2 8098 545a 3d22 3c2b 3035   and ...TZ="<+05
│ │ │ │ +00027580: 3330 3e2d 353a 3330 22e2 8099 2073 6179  30>-5:30"... say
│ │ │ │ +00027590: 730a 7468 6174 2074 6865 2074 696d 6520  s.that the time 
│ │ │ │ +000275a0: 7a6f 6e65 2061 6262 7265 7669 6174 696f  zone abbreviatio
│ │ │ │ +000275b0: 6e20 6973 20e2 8098 2b30 3533 30e2 8099  n is ...+0530...
│ │ │ │ +000275c0: 2061 6e64 2074 6865 2074 696d 6520 7a6f   and the time zo
│ │ │ │ +000275d0: 6e65 2069 7320 3520 686f 7572 730a 3330  ne is 5 hours.30
│ │ │ │ +000275e0: 206d 696e 7574 6573 2065 6173 7420 6f66   minutes east of
│ │ │ │ +000275f0: 2047 7265 656e 7769 6368 2e20 2041 6c74   Greenwich.  Alt
│ │ │ │ +00027600: 686f 7567 6820 7472 6963 6b69 6572 2050  hough trickier P
│ │ │ │ +00027610: 4f53 4958 20e2 8098 545a e280 9920 7365  OSIX ...TZ... se
│ │ │ │ +00027620: 7474 696e 6773 0a6c 696b 6520 e280 9854  ttings.like ...T
│ │ │ │ +00027630: 5a3d 223c 2d30 353e 2b35 3c2d 3034 3e2c  Z="<-05>+5<-04>,
│ │ │ │ +00027640: 4d33 2e32 2e30 2f32 2c4d 3131 2e31 2e30  M3.2.0/2,M11.1.0
│ │ │ │ +00027650: 2f32 22e2 8099 2063 616e 2073 7065 6369  /2"... can speci
│ │ │ │ +00027660: 6679 2073 6f6d 6520 6461 796c 6967 6874  fy some daylight
│ │ │ │ +00027670: 0a73 6176 696e 6720 7265 6769 6d65 732c  .saving regimes,
│ │ │ │ +00027680: 206c 6f63 6174 696f 6e2d 6261 7365 6420   location-based 
│ │ │ │ +00027690: 7365 7474 696e 6773 206c 696b 6520 e280  settings like ..
│ │ │ │ +000276a0: 9854 5a3d 2241 6d65 7269 6361 2f4e 6577  .TZ="America/New
│ │ │ │ +000276b0: 5f59 6f72 6b22 e280 9920 6172 650a 7479  _York"... are.ty
│ │ │ │ +000276c0: 7069 6361 6c6c 7920 7369 6d70 6c65 7220  pically simpler 
│ │ │ │ +000276d0: 616e 6420 6d6f 7265 2061 6363 7572 6174  and more accurat
│ │ │ │ +000276e0: 6520 6869 7374 6f72 6963 616c 6c79 2e20  e historically. 
│ │ │ │ +000276f0: 202a 4e6f 7465 2053 7065 6369 6679 696e   *Note Specifyin
│ │ │ │ +00027700: 6720 7468 650a 5469 6d65 205a 6f6e 6520  g the.Time Zone 
│ │ │ │ +00027710: 7769 7468 20e2 8098 545a e280 993a 2028  with ...TZ...: (
│ │ │ │ +00027720: 6c69 6263 2954 5a20 5661 7269 6162 6c65  libc)TZ Variable
│ │ │ │ +00027730: 2e0a 0a1f 0a46 696c 653a 2073 6869 7368  .....File: shish
│ │ │ │ +00027740: 692e 696e 666f 2c20 204e 6f64 653a 2041  i.info,  Node: A
│ │ │ │ +00027750: 7574 686f 7273 206f 6620 7061 7273 655f  uthors of parse_
│ │ │ │ +00027760: 6461 7465 7469 6d65 2c20 2050 7265 763a  datetime,  Prev:
│ │ │ │ +00027770: 2053 7065 6369 6679 696e 6720 7469 6d65   Specifying time
│ │ │ │ +00027780: 207a 6f6e 6520 7275 6c65 732c 2020 5570   zone rules,  Up
│ │ │ │ +00027790: 3a20 4461 7465 2069 6e70 7574 2066 6f72  : Date input for
│ │ │ │ +000277a0: 6d61 7473 0a0a 342e 3130 2e31 3120 4175  mats..4.10.11 Au
│ │ │ │ +000277b0: 7468 6f72 7320 6f66 20e2 8098 7061 7273  thors of ...pars
│ │ │ │ +000277c0: 655f 6461 7465 7469 6d65 e280 990a 2d2d  e_datetime....--
│ │ │ │  000277d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000277e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -000277f0: 0ae2 8098 7061 7273 655f 6461 7465 7469  ....parse_dateti
│ │ │ │ -00027800: 6d65 e280 9920 7374 6172 7465 6420 6c69  me... started li
│ │ │ │ -00027810: 6665 2061 7320 e280 9867 6574 6461 7465  fe as ...getdate
│ │ │ │ -00027820: e280 992c 2061 7320 6f72 6967 696e 616c  ..., as original
│ │ │ │ -00027830: 6c79 2069 6d70 6c65 6d65 6e74 6564 2062  ly implemented b
│ │ │ │ -00027840: 790a 5374 6576 656e 204d 2e20 4265 6c6c  y.Steven M. Bell
│ │ │ │ -00027850: 6f76 696e 2028 3c73 6d62 4072 6573 6561  ovin (<smb@resea
│ │ │ │ -00027860: 7263 682e 6174 742e 636f 6d3e 2920 7768  rch.att.com>) wh
│ │ │ │ -00027870: 696c 6520 6174 2074 6865 2055 6e69 7665  ile at the Unive
│ │ │ │ -00027880: 7273 6974 7920 6f66 0a4e 6f72 7468 2043  rsity of.North C
│ │ │ │ -00027890: 6172 6f6c 696e 6120 6174 2043 6861 7065  arolina at Chape
│ │ │ │ -000278a0: 6c20 4869 6c6c 2e20 2054 6865 2063 6f64  l Hill.  The cod
│ │ │ │ -000278b0: 6520 7761 7320 6c61 7465 7220 7477 6561  e was later twea
│ │ │ │ -000278c0: 6b65 6420 6279 2061 2063 6f75 706c 650a  ked by a couple.
│ │ │ │ -000278d0: 6f66 2070 656f 706c 6520 6f6e 2055 7365  of people on Use
│ │ │ │ -000278e0: 6e65 742c 2074 6865 6e20 636f 6d70 6c65  net, then comple
│ │ │ │ -000278f0: 7465 6c79 206f 7665 7268 6175 6c65 6420  tely overhauled 
│ │ │ │ -00027900: 6279 2052 6963 6820 2461 6c7a 0a28 3c72  by Rich $alz.(<r
│ │ │ │ -00027910: 7361 6c7a 4062 626e 2e63 6f6d 3e29 2061  salz@bbn.com>) a
│ │ │ │ -00027920: 6e64 204a 696d 2042 6572 6574 7320 283c  nd Jim Berets (<
│ │ │ │ -00027930: 6a62 6572 6574 7340 6262 6e2e 636f 6d3e  jberets@bbn.com>
│ │ │ │ -00027940: 2920 696e 2041 7567 7573 742c 2031 3939  ) in August, 199
│ │ │ │ -00027950: 302e 0a56 6172 696f 7573 2072 6576 6973  0..Various revis
│ │ │ │ -00027960: 696f 6e73 2066 6f72 2074 6865 2047 4e55  ions for the GNU
│ │ │ │ -00027970: 2073 7973 7465 6d20 7765 7265 206d 6164   system were mad
│ │ │ │ -00027980: 6520 6279 2044 6176 6964 204d 6163 4b65  e by David MacKe
│ │ │ │ -00027990: 6e7a 6965 2c20 4a69 6d0a 4d65 7965 7269  nzie, Jim.Meyeri
│ │ │ │ -000279a0: 6e67 2c20 5061 756c 2045 6767 6572 7420  ng, Paul Eggert 
│ │ │ │ -000279b0: 616e 6420 6f74 6865 7273 2c20 696e 636c  and others, incl
│ │ │ │ -000279c0: 7564 696e 6720 7265 6e61 6d69 6e67 2069  uding renaming i
│ │ │ │ -000279d0: 7420 746f 20e2 8098 6765 745f 6461 7465  t to ...get_date
│ │ │ │ -000279e0: e280 9920 746f 0a61 766f 6964 2061 2063  ... to.avoid a c
│ │ │ │ -000279f0: 6f6e 666c 6963 7420 7769 7468 2074 6865  onflict with the
│ │ │ │ -00027a00: 2061 6c74 6572 6e61 7469 7665 2050 6f73   alternative Pos
│ │ │ │ -00027a10: 6978 2066 756e 6374 696f 6e20 e280 9867  ix function ...g
│ │ │ │ -00027a20: 6574 6461 7465 e280 992c 2061 6e64 2061  etdate..., and a
│ │ │ │ -00027a30: 0a6c 6174 6572 2072 656e 616d 6520 746f  .later rename to
│ │ │ │ -00027a40: 20e2 8098 7061 7273 655f 6461 7465 7469   ...parse_dateti
│ │ │ │ -00027a50: 6d65 e280 992e 2020 5468 6520 506f 7369  me....  The Posi
│ │ │ │ -00027a60: 7820 6675 6e63 7469 6f6e 20e2 8098 6765  x function ...ge
│ │ │ │ -00027a70: 7464 6174 65e2 8099 2063 616e 0a70 6172  tdate... can.par
│ │ │ │ -00027a80: 7365 206d 6f72 6520 6c6f 6361 6c65 2d73  se more locale-s
│ │ │ │ -00027a90: 7065 6369 6669 6320 6461 7465 7320 7573  pecific dates us
│ │ │ │ -00027aa0: 696e 6720 e280 9873 7472 7074 696d 65e2  ing ...strptime.
│ │ │ │ -00027ab0: 8099 2c20 6275 7420 7265 6c69 6573 206f  .., but relies o
│ │ │ │ -00027ac0: 6e20 616e 0a65 6e76 6972 6f6e 6d65 6e74  n an.environment
│ │ │ │ -00027ad0: 2076 6172 6961 626c 6520 616e 6420 6578   variable and ex
│ │ │ │ -00027ae0: 7465 726e 616c 2066 696c 652c 2061 6e64  ternal file, and
│ │ │ │ -00027af0: 206c 6163 6b73 2074 6865 2074 6872 6561   lacks the threa
│ │ │ │ -00027b00: 642d 7361 6665 7479 206f 660a e280 9870  d-safety of....p
│ │ │ │ -00027b10: 6172 7365 5f64 6174 6574 696d 65e2 8099  arse_datetime...
│ │ │ │ -00027b20: 2e0a 0a20 2020 5468 6973 2063 6861 7074  ...   This chapt
│ │ │ │ -00027b30: 6572 2077 6173 206f 7269 6769 6e61 6c6c  er was originall
│ │ │ │ -00027b40: 7920 7072 6f64 7563 6564 2062 7920 4672  y produced by Fr
│ │ │ │ -00027b50: 616e c3a7 6f69 7320 5069 6e61 7264 0a28  an..ois Pinard.(
│ │ │ │ -00027b60: 3c70 696e 6172 6440 6972 6f2e 756d 6f6e  <pinard@iro.umon
│ │ │ │ -00027b70: 7472 6561 6c2e 6361 3e29 2066 726f 6d20  treal.ca>) from 
│ │ │ │ -00027b80: 7468 6520 e280 9870 6172 7365 5f64 6174  the ...parse_dat
│ │ │ │ -00027b90: 6574 696d 652e 79e2 8099 2073 6f75 7263  etime.y... sourc
│ │ │ │ -00027ba0: 6520 636f 6465 2c20 616e 640a 7468 656e  e code, and.then
│ │ │ │ -00027bb0: 2065 6469 7465 6420 6279 204b 2e20 4265   edited by K. Be
│ │ │ │ -00027bc0: 7272 7920 283c 6b62 4063 732e 756d 622e  rry (<kb@cs.umb.
│ │ │ │ -00027bd0: 6564 753e 292e 0a0a 1f0a 4669 6c65 3a20  edu>).....File: 
│ │ │ │ -00027be0: 7368 6973 6869 2e69 6e66 6f2c 2020 4e6f  shishi.info,  No
│ │ │ │ -00027bf0: 6465 3a20 5072 6f67 7261 6d6d 696e 6720  de: Programming 
│ │ │ │ -00027c00: 4d61 6e75 616c 2c20 204e 6578 743a 2041  Manual,  Next: A
│ │ │ │ -00027c10: 636b 6e6f 776c 6564 6765 6d65 6e74 732c  cknowledgements,
│ │ │ │ -00027c20: 2020 5072 6576 3a20 5265 6665 7265 6e63    Prev: Referenc
│ │ │ │ -00027c30: 6520 4d61 6e75 616c 2c20 2055 703a 2054  e Manual,  Up: T
│ │ │ │ -00027c40: 6f70 0a0a 3520 5072 6f67 7261 6d6d 696e  op..5 Programmin
│ │ │ │ -00027c50: 6720 4d61 6e75 616c 0a2a 2a2a 2a2a 2a2a  g Manual.*******
│ │ │ │ -00027c60: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a54  *************..T
│ │ │ │ -00027c70: 6869 7320 6368 6170 7465 7220 6465 7363  his chapter desc
│ │ │ │ -00027c80: 7269 6265 7320 616c 6c20 7468 6520 7075  ribes all the pu
│ │ │ │ -00027c90: 626c 6963 6c79 2061 7661 696c 6162 6c65  blicly available
│ │ │ │ -00027ca0: 2066 756e 6374 696f 6e73 2069 6e20 7468   functions in th
│ │ │ │ -00027cb0: 650a 6c69 6272 6172 792e 0a0a 2a20 4d65  e.library...* Me
│ │ │ │ -00027cc0: 6e75 3a0a 0a2a 2050 7265 7061 7261 7469  nu:..* Preparati
│ │ │ │ -00027cd0: 6f6e 3a3a 2020 2020 2020 2020 2020 2020  on::            
│ │ │ │ -00027ce0: 2020 2020 2057 6861 7420 796f 7520 7368       What you sh
│ │ │ │ -00027cf0: 6f75 6c64 2064 6f20 6265 666f 7265 2075  ould do before u
│ │ │ │ -00027d00: 7369 6e67 2074 6865 206c 6962 7261 7279  sing the library
│ │ │ │ -00027d10: 2e0a 2a20 496e 6974 6961 6c69 7a61 7469  ..* Initializati
│ │ │ │ -00027d20: 6f6e 2046 756e 6374 696f 6e73 3a3a 2020  on Functions::  
│ │ │ │ -00027d30: 2020 4372 6561 7469 6e67 206c 6962 7261    Creating libra
│ │ │ │ -00027d40: 7279 2068 616e 646c 652c 2063 6f6e 6669  ry handle, confi
│ │ │ │ -00027d50: 6775 7261 7469 6f6e 2066 696c 652e 0a2a  guration file..*
│ │ │ │ -00027d60: 2054 6963 6b65 7420 5365 7420 4675 6e63   Ticket Set Func
│ │ │ │ -00027d70: 7469 6f6e 733a 3a20 2020 2020 2020 2048  tions::        H
│ │ │ │ -00027d80: 6967 682d 6c65 7665 6c20 7469 636b 6574  igh-level ticket
│ │ │ │ -00027d90: 206d 616e 6167 656d 656e 7420 6675 6e63   management func
│ │ │ │ -00027da0: 7469 6f6e 732e 0a2a 2041 502d 5245 5120  tions..* AP-REQ 
│ │ │ │ -00027db0: 616e 6420 4150 2d52 4550 2046 756e 6374  and AP-REP Funct
│ │ │ │ -00027dc0: 696f 6e73 3a3a 2043 6c69 656e 742f 5365  ions:: Client/Se
│ │ │ │ -00027dd0: 7276 6572 2061 7574 6865 6e74 6963 6174  rver authenticat
│ │ │ │ -00027de0: 696f 6e20 6675 6e63 7469 6f6e 732e 0a2a  ion functions..*
│ │ │ │ -00027df0: 2053 4146 4520 616e 6420 5052 4956 2046   SAFE and PRIV F
│ │ │ │ -00027e00: 756e 6374 696f 6e73 3a3a 2020 2020 2043  unctions::     C
│ │ │ │ -00027e10: 6c69 656e 742f 5365 7276 6572 2073 6573  lient/Server ses
│ │ │ │ -00027e20: 7369 6f6e 2064 6174 6120 6675 6e63 7469  sion data functi
│ │ │ │ -00027e30: 6f6e 732e 0a2a 2054 6963 6b65 7420 4675  ons..* Ticket Fu
│ │ │ │ -00027e40: 6e63 7469 6f6e 733a 3a20 2020 2020 2020  nctions::       
│ │ │ │ -00027e50: 2020 2020 204d 6564 6975 6d2d 6c65 7665       Medium-leve
│ │ │ │ -00027e60: 6c20 7469 636b 6574 206d 616e 6970 756c  l ticket manipul
│ │ │ │ -00027e70: 6174 696f 6e20 6675 6e63 7469 6f6e 732e  ation functions.
│ │ │ │ -00027e80: 0a2a 2041 5320 4675 6e63 7469 6f6e 733a  .* AS Functions:
│ │ │ │ -00027e90: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ -00027ea0: 204d 6564 6975 6d2d 6c65 7665 6c20 696e   Medium-level in
│ │ │ │ -00027eb0: 6974 6961 6c20 6175 7468 656e 7469 6361  itial authentica
│ │ │ │ -00027ec0: 7469 6f6e 2066 756e 6374 696f 6e73 2e0a  tion functions..
│ │ │ │ -00027ed0: 2a20 5447 5320 4675 6e63 7469 6f6e 733a  * TGS Functions:
│ │ │ │ -00027ee0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ -00027ef0: 4d65 6469 756d 2d6c 6576 656c 2061 7574  Medium-level aut
│ │ │ │ -00027f00: 6865 6e74 6963 6174 696f 6e20 6675 6e63  hentication func
│ │ │ │ -00027f10: 7469 6f6e 732e 0a2a 2054 6963 6b65 7420  tions..* Ticket 
│ │ │ │ -00027f20: 2841 534e 2e31 2920 4675 6e63 7469 6f6e  (ASN.1) Function
│ │ │ │ -00027f30: 733a 3a20 2020 204c 6f77 2d6c 6576 656c  s::    Low-level
│ │ │ │ -00027f40: 2054 6963 6b65 7420 6675 6e63 7469 6f6e   Ticket function
│ │ │ │ -00027f50: 732e 0a2a 2041 532f 5447 5320 4675 6e63  s..* AS/TGS Func
│ │ │ │ -00027f60: 7469 6f6e 733a 3a20 2020 2020 2020 2020  tions::         
│ │ │ │ -00027f70: 2020 204c 6f77 2d6c 6576 656c 204b 4443     Low-level KDC
│ │ │ │ -00027f80: 2066 756e 6374 696f 6e73 3b20 4153 2061   functions; AS a
│ │ │ │ -00027f90: 6e64 2054 4753 2e0a 2a20 4175 7468 656e  nd TGS..* Authen
│ │ │ │ -00027fa0: 7469 6361 746f 7220 4675 6e63 7469 6f6e  ticator Function
│ │ │ │ -00027fb0: 733a 3a20 2020 2020 4c6f 772d 6c65 7665  s::     Low-leve
│ │ │ │ -00027fc0: 6c20 6175 7468 656e 7469 6361 746f 7220  l authenticator 
│ │ │ │ -00027fd0: 6675 6e63 7469 6f6e 732e 0a2a 204b 5242  functions..* KRB
│ │ │ │ -00027fe0: 2d45 5252 4f52 2046 756e 6374 696f 6e73  -ERROR Functions
│ │ │ │ -00027ff0: 3a3a 2020 2020 2020 2020 204c 6f77 2d6c  ::         Low-l
│ │ │ │ -00028000: 6576 656c 204b 5242 2d45 5252 4f52 2066  evel KRB-ERROR f
│ │ │ │ -00028010: 756e 6374 696f 6e73 2e0a 2a20 4372 7970  unctions..* Cryp
│ │ │ │ -00028020: 746f 6772 6170 6869 6320 4675 6e63 7469  tographic Functi
│ │ │ │ -00028030: 6f6e 733a 3a20 2020 2020 4c6f 772d 6c65  ons::     Low-le
│ │ │ │ -00028040: 7665 6c20 6372 7970 746f 6772 6170 6869  vel cryptographi
│ │ │ │ -00028050: 6320 6675 6e63 7469 6f6e 732e 0a2a 2058  c functions..* X
│ │ │ │ -00028060: 2e35 3039 2046 756e 6374 696f 6e73 3a3a  .509 Functions::
│ │ │ │ -00028070: 2020 2020 2020 2020 2020 2020 2055 7469               Uti
│ │ │ │ -00028080: 6c69 7479 2066 756e 6374 696f 6e73 2066  lity functions f
│ │ │ │ -00028090: 6f72 2058 2e35 3039 2073 7570 706f 7274  or X.509 support
│ │ │ │ -000280a0: 2e0a 2a20 5574 696c 6974 7920 4675 6e63  ..* Utility Func
│ │ │ │ -000280b0: 7469 6f6e 733a 3a20 2020 2020 2020 2020  tions::         
│ │ │ │ -000280c0: 2020 5574 696c 6974 6965 7320 666f 7220    Utilities for 
│ │ │ │ -000280d0: 7573 6520 696e 2074 6865 2067 6c6f 6261  use in the globa
│ │ │ │ -000280e0: 6c20 636f 6e74 6578 742e 0a2a 2041 534e  l context..* ASN
│ │ │ │ -000280f0: 2e31 2046 756e 6374 696f 6e73 3a3a 2020  .1 Functions::  
│ │ │ │ -00028100: 2020 2020 2020 2020 2020 2050 6572 666f             Perfo
│ │ │ │ -00028110: 726d 206c 6f77 2d6c 6576 656c 2041 534e  rm low-level ASN
│ │ │ │ -00028120: 2e31 206d 616e 6970 756c 6174 696f 6e73  .1 manipulations
│ │ │ │ -00028130: 2e0a 2a20 4572 726f 7220 4861 6e64 6c69  ..* Error Handli
│ │ │ │ -00028140: 6e67 3a3a 2020 2020 2020 2020 2020 2020  ng::            
│ │ │ │ -00028150: 2020 4572 726f 7220 636f 6465 7320 616e    Error codes an
│ │ │ │ -00028160: 6420 7375 6368 2e0a 2a20 4578 616d 706c  d such..* Exampl
│ │ │ │ -00028170: 6573 3a3a 2020 2020 2020 2020 2020 2020  es::            
│ │ │ │ -00028180: 2020 2020 2020 2020 4578 616d 706c 6520          Example 
│ │ │ │ -00028190: 636f 6465 2e0a 2a20 4b65 7262 6572 6f73  code..* Kerberos
│ │ │ │ -000281a0: 2044 6174 6162 6173 6520 4675 6e63 7469   Database Functi
│ │ │ │ -000281b0: 6f6e 733a 3a20 5468 6520 5368 6973 6120  ons:: The Shisa 
│ │ │ │ -000281c0: 6765 6e65 7269 6320 6461 7461 6261 7365  generic database
│ │ │ │ -000281d0: 2069 6e74 6572 6661 6365 2e0a 2a20 4765   interface..* Ge
│ │ │ │ -000281e0: 6e65 7269 6320 5365 6375 7269 7479 2053  neric Security S
│ │ │ │ -000281f0: 6572 7669 6365 3a3a 2020 2020 4966 2079  ervice::    If y
│ │ │ │ -00028200: 6f75 2077 616e 7420 746f 2075 7365 2074  ou want to use t
│ │ │ │ -00028210: 6865 2047 5353 2041 5049 2069 6e73 7465  he GSS API inste
│ │ │ │ -00028220: 6164 2e0a 0a1f 0a46 696c 653a 2073 6869  ad.....File: shi
│ │ │ │ -00028230: 7368 692e 696e 666f 2c20 204e 6f64 653a  shi.info,  Node:
│ │ │ │ -00028240: 2050 7265 7061 7261 7469 6f6e 2c20 204e   Preparation,  N
│ │ │ │ -00028250: 6578 743a 2049 6e69 7469 616c 697a 6174  ext: Initializat
│ │ │ │ -00028260: 696f 6e20 4675 6e63 7469 6f6e 732c 2020  ion Functions,  
│ │ │ │ -00028270: 5570 3a20 5072 6f67 7261 6d6d 696e 6720  Up: Programming 
│ │ │ │ -00028280: 4d61 6e75 616c 0a0a 352e 3120 5072 6570  Manual..5.1 Prep
│ │ │ │ -00028290: 6172 6174 696f 6e0a 3d3d 3d3d 3d3d 3d3d  aration.========
│ │ │ │ -000282a0: 3d3d 3d3d 3d3d 3d0a 0a54 6f20 7573 6520  =======..To use 
│ │ │ │ -000282b0: 274c 6962 7368 6973 6869 272c 2079 6f75  'Libshishi', you
│ │ │ │ -000282c0: 2068 6176 6520 746f 2070 6572 666f 726d   have to perform
│ │ │ │ -000282d0: 2073 6f6d 6520 6368 616e 6765 7320 746f   some changes to
│ │ │ │ -000282e0: 2079 6f75 7220 736f 7572 6365 7320 616e   your sources an
│ │ │ │ -000282f0: 640a 7468 6520 6275 696c 6420 7379 7374  d.the build syst
│ │ │ │ -00028300: 656d 2e20 2054 6865 206e 6563 6573 7361  em.  The necessa
│ │ │ │ -00028310: 7279 2063 6861 6e67 6573 2061 7265 2073  ry changes are s
│ │ │ │ -00028320: 6d61 6c6c 2061 6e64 2065 7870 6c61 696e  mall and explain
│ │ │ │ -00028330: 6564 2069 6e20 7468 650a 666f 6c6c 6f77  ed in the.follow
│ │ │ │ -00028340: 696e 6720 7365 6374 696f 6e73 2e20 2041  ing sections.  A
│ │ │ │ -00028350: 7420 7468 6520 656e 6420 6f66 2074 6869  t the end of thi
│ │ │ │ -00028360: 7320 6368 6170 7465 722c 2069 7420 6973  s chapter, it is
│ │ │ │ -00028370: 2064 6573 6372 6962 6564 2068 6f77 2074   described how t
│ │ │ │ -00028380: 6865 0a6c 6962 7261 7279 2069 7320 696e  he.library is in
│ │ │ │ -00028390: 6974 6961 6c69 7a65 642c 2061 6e64 2068  itialized, and h
│ │ │ │ -000283a0: 6f77 2074 6865 2072 6571 7569 7265 6d65  ow the requireme
│ │ │ │ -000283b0: 6e74 7320 6f66 2074 6865 206c 6962 7261  nts of the libra
│ │ │ │ -000283c0: 7279 2061 7265 0a76 6572 6966 6965 642e  ry are.verified.
│ │ │ │ -000283d0: 0a0a 2020 2041 2066 6173 7465 7220 7761  ..   A faster wa
│ │ │ │ -000283e0: 7920 746f 2066 696e 6420 6f75 7420 686f  y to find out ho
│ │ │ │ -000283f0: 7720 746f 2061 6461 7074 2079 6f75 7220  w to adapt your 
│ │ │ │ -00028400: 6170 706c 6963 6174 696f 6e20 666f 7220  application for 
│ │ │ │ -00028410: 7573 6520 7769 7468 0a27 4c69 6273 6869  use with.'Libshi
│ │ │ │ -00028420: 7368 6927 206d 6179 2062 6520 746f 206c  shi' may be to l
│ │ │ │ -00028430: 6f6f 6b20 6174 2074 6865 2065 7861 6d70  ook at the examp
│ │ │ │ -00028440: 6c65 7320 6174 2074 6865 2065 6e64 206f  les at the end o
│ │ │ │ -00028450: 6620 7468 6973 206d 616e 7561 6c0a 282a  f this manual.(*
│ │ │ │ -00028460: 6e6f 7465 2045 7861 6d70 6c65 733a 3a29  note Examples::)
│ │ │ │ -00028470: 2e0a 0a2a 204d 656e 753a 0a0a 2a20 4865  ...* Menu:..* He
│ │ │ │ -00028480: 6164 6572 3a3a 0a2a 2049 6e69 7469 616c  ader::.* Initial
│ │ │ │ -00028490: 697a 6174 696f 6e3a 3a0a 2a20 5665 7273  ization::.* Vers
│ │ │ │ -000284a0: 696f 6e20 4368 6563 6b3a 3a0a 2a20 4275  ion Check::.* Bu
│ │ │ │ -000284b0: 696c 6469 6e67 2074 6865 2073 6f75 7263  ilding the sourc
│ │ │ │ -000284c0: 653a 3a0a 2a20 4175 746f 636f 6e66 2074  e::.* Autoconf t
│ │ │ │ -000284d0: 6573 7473 3a3a 0a0a 1f0a 4669 6c65 3a20  ests::....File: 
│ │ │ │ -000284e0: 7368 6973 6869 2e69 6e66 6f2c 2020 4e6f  shishi.info,  No
│ │ │ │ -000284f0: 6465 3a20 4865 6164 6572 2c20 204e 6578  de: Header,  Nex
│ │ │ │ -00028500: 743a 2049 6e69 7469 616c 697a 6174 696f  t: Initializatio
│ │ │ │ -00028510: 6e2c 2020 5570 3a20 5072 6570 6172 6174  n,  Up: Preparat
│ │ │ │ -00028520: 696f 6e0a 0a35 2e31 2e31 2048 6561 6465  ion..5.1.1 Heade
│ │ │ │ -00028530: 720a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  r.------------..
│ │ │ │ -00028540: 416c 6c20 696e 7465 7266 6163 6573 2028  All interfaces (
│ │ │ │ -00028550: 6461 7461 2074 7970 6573 2061 6e64 2066  data types and f
│ │ │ │ -00028560: 756e 6374 696f 6e73 2920 6f66 2074 6865  unctions) of the
│ │ │ │ -00028570: 206c 6962 7261 7279 2061 7265 2064 6566   library are def
│ │ │ │ -00028580: 696e 6564 2069 6e0a 7468 6520 6865 6164  ined in.the head
│ │ │ │ -00028590: 6572 2066 696c 6520 2773 6869 7368 692e  er file 'shishi.
│ │ │ │ -000285a0: 6827 2e20 2059 6f75 206d 7573 7420 696e  h'.  You must in
│ │ │ │ -000285b0: 636c 7564 6520 7468 6973 2069 6e20 616c  clude this in al
│ │ │ │ -000285c0: 6c20 7072 6f67 7261 6d73 2075 7369 6e67  l programs using
│ │ │ │ -000285d0: 0a74 6865 206c 6962 7261 7279 2c20 6569  .the library, ei
│ │ │ │ -000285e0: 7468 6572 2064 6972 6563 746c 7920 6f72  ther directly or
│ │ │ │ -000285f0: 2074 6872 6f75 6768 2073 6f6d 6520 6f74   through some ot
│ │ │ │ -00028600: 6865 7220 6865 6164 6572 2066 696c 652c  her header file,
│ │ │ │ -00028610: 206c 696b 650a 7468 6973 3a0a 0a20 2020   like.this:..   
│ │ │ │ -00028620: 2020 2369 6e63 6c75 6465 203c 7368 6973    #include <shis
│ │ │ │ -00028630: 6869 2e68 3e0a 0a20 2020 5468 6520 6e61  hi.h>..   The na
│ │ │ │ -00028640: 6d65 2073 7061 6365 206f 6620 274c 6962  me space of 'Lib
│ │ │ │ -00028650: 7368 6973 6869 2720 6973 20e2 8098 7368  shishi' is ...sh
│ │ │ │ -00028660: 6973 6869 5f2a e280 9920 666f 7220 6675  ishi_*... for fu
│ │ │ │ -00028670: 6e63 7469 6f6e 206e 616d 6573 2c0a e280  nction names,...
│ │ │ │ -00028680: 9853 6869 7368 692a e280 9920 666f 7220  .Shishi*... for 
│ │ │ │ -00028690: 6461 7461 2074 7970 6573 2061 6e64 20e2  data types and .
│ │ │ │ -000286a0: 8098 5348 4953 4849 5f2a e280 9920 666f  ..SHISHI_*... fo
│ │ │ │ -000286b0: 7220 6f74 6865 7220 7379 6d62 6f6c 732e  r other symbols.
│ │ │ │ -000286c0: 2020 496e 2061 6464 6974 696f 6e0a 7468    In addition.th
│ │ │ │ -000286d0: 6520 7361 6d65 206e 616d 6520 7072 6566  e same name pref
│ │ │ │ -000286e0: 6978 6573 2077 6974 6820 6f6e 6520 7072  ixes with one pr
│ │ │ │ -000286f0: 6570 656e 6465 6420 756e 6465 7273 636f  epended undersco
│ │ │ │ -00028700: 7265 2061 7265 2072 6573 6572 7665 6420  re are reserved 
│ │ │ │ -00028710: 666f 720a 696e 7465 726e 616c 2075 7365  for.internal use
│ │ │ │ -00028720: 2061 6e64 2073 686f 756c 6420 6e65 7665   and should neve
│ │ │ │ -00028730: 7220 6265 2075 7365 6420 6279 2061 6e20  r be used by an 
│ │ │ │ -00028740: 6170 706c 6963 6174 696f 6e2e 0a0a 1f0a  application.....
│ │ │ │ -00028750: 4669 6c65 3a20 7368 6973 6869 2e69 6e66  File: shishi.inf
│ │ │ │ -00028760: 6f2c 2020 4e6f 6465 3a20 496e 6974 6961  o,  Node: Initia
│ │ │ │ -00028770: 6c69 7a61 7469 6f6e 2c20 204e 6578 743a  lization,  Next:
│ │ │ │ -00028780: 2056 6572 7369 6f6e 2043 6865 636b 2c20   Version Check, 
│ │ │ │ -00028790: 2050 7265 763a 2048 6561 6465 722c 2020   Prev: Header,  
│ │ │ │ -000287a0: 5570 3a20 5072 6570 6172 6174 696f 6e0a  Up: Preparation.
│ │ │ │ -000287b0: 0a35 2e31 2e32 2049 6e69 7469 616c 697a  .5.1.2 Initializ
│ │ │ │ -000287c0: 6174 696f 6e0a 2d2d 2d2d 2d2d 2d2d 2d2d  ation.----------
│ │ │ │ -000287d0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 274c 6962  ----------..'Lib
│ │ │ │ -000287e0: 7368 6973 6869 2720 6d75 7374 2062 6520  shishi' must be 
│ │ │ │ -000287f0: 696e 6974 6961 6c69 7a65 6420 6265 666f  initialized befo
│ │ │ │ -00028800: 7265 2069 7420 6361 6e20 6265 2075 7365  re it can be use
│ │ │ │ -00028810: 642e 2020 5468 6520 6c69 6272 6172 7920  d.  The library 
│ │ │ │ -00028820: 6973 0a69 6e69 7469 616c 697a 6564 2062  is.initialized b
│ │ │ │ -00028830: 7920 6361 6c6c 696e 6720 e280 9873 6869  y calling ...shi
│ │ │ │ -00028840: 7368 695f 696e 6974 e280 9920 282a 6e6f  shi_init... (*no
│ │ │ │ -00028850: 7465 2049 6e69 7469 616c 697a 6174 696f  te Initializatio
│ │ │ │ -00028860: 6e20 4675 6e63 7469 6f6e 733a 3a29 2e0a  n Functions::)..
│ │ │ │ -00028870: 5468 6520 7265 736f 7572 6365 7320 616c  The resources al
│ │ │ │ -00028880: 6c6f 6361 7465 6420 6279 2074 6865 2069  located by the i
│ │ │ │ -00028890: 6e69 7469 616c 697a 6174 696f 6e20 7072  nitialization pr
│ │ │ │ -000288a0: 6f63 6573 7320 6361 6e20 6265 2072 656c  ocess can be rel
│ │ │ │ -000288b0: 6561 7365 6420 6966 0a74 6865 2061 7070  eased if.the app
│ │ │ │ -000288c0: 6c69 6361 7469 6f6e 206e 6f20 6c6f 6e67  lication no long
│ │ │ │ -000288d0: 6572 2068 6173 2061 206e 6565 6420 746f  er has a need to
│ │ │ │ -000288e0: 2063 616c 6c20 274c 6962 7368 6973 6869   call 'Libshishi
│ │ │ │ -000288f0: 2720 6675 6e63 7469 6f6e 732c 2074 6869  ' functions, thi
│ │ │ │ -00028900: 730a 6973 2064 6f6e 6520 6279 2063 616c  s.is done by cal
│ │ │ │ -00028910: 6c69 6e67 20e2 8098 7368 6973 6869 5f64  ling ...shishi_d
│ │ │ │ -00028920: 6f6e 65e2 8099 2e0a 0a20 2020 496e 206f  one......   In o
│ │ │ │ -00028930: 7264 6572 2074 6f20 7461 6b65 2061 6476  rder to take adv
│ │ │ │ -00028940: 616e 7461 6765 206f 6620 7468 6520 696e  antage of the in
│ │ │ │ -00028950: 7465 726e 6174 696f 6e61 6c69 7361 7469  ternationalisati
│ │ │ │ -00028960: 6f6e 2066 6561 7475 7265 7320 696e 0a27  on features in.'
│ │ │ │ -00028970: 4c69 6273 6869 7368 6927 2c20 7375 6368  Libshishi', such
│ │ │ │ -00028980: 2061 7320 7472 616e 736c 6174 6564 2065   as translated e
│ │ │ │ -00028990: 7272 6f72 206d 6573 7361 6765 732c 2074  rror messages, t
│ │ │ │ -000289a0: 6865 2061 7070 6c69 6361 7469 6f6e 206d  he application m
│ │ │ │ -000289b0: 7573 7420 7365 740a 7468 6520 6375 7272  ust set.the curr
│ │ │ │ -000289c0: 656e 7420 6c6f 6361 6c65 2075 7369 6e67  ent locale using
│ │ │ │ -000289d0: 20e2 8098 7365 746c 6f63 616c 65e2 8099   ...setlocale...
│ │ │ │ -000289e0: 2062 6566 6f72 6520 696e 6974 6961 6c69   before initiali
│ │ │ │ -000289f0: 7a69 6e67 2027 4c69 6273 6869 7368 6927  zing 'Libshishi'
│ │ │ │ -00028a00: 2e0a 0a1f 0a46 696c 653a 2073 6869 7368  .....File: shish
│ │ │ │ -00028a10: 692e 696e 666f 2c20 204e 6f64 653a 2056  i.info,  Node: V
│ │ │ │ -00028a20: 6572 7369 6f6e 2043 6865 636b 2c20 204e  ersion Check,  N
│ │ │ │ -00028a30: 6578 743a 2042 7569 6c64 696e 6720 7468  ext: Building th
│ │ │ │ -00028a40: 6520 736f 7572 6365 2c20 2050 7265 763a  e source,  Prev:
│ │ │ │ -00028a50: 2049 6e69 7469 616c 697a 6174 696f 6e2c   Initialization,
│ │ │ │ -00028a60: 2020 5570 3a20 5072 6570 6172 6174 696f    Up: Preparatio
│ │ │ │ -00028a70: 6e0a 0a35 2e31 2e33 2056 6572 7369 6f6e  n..5.1.3 Version
│ │ │ │ -00028a80: 2043 6865 636b 0a2d 2d2d 2d2d 2d2d 2d2d   Check.---------
│ │ │ │ -00028a90: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 4974 2069  ----------..It i
│ │ │ │ -00028aa0: 7320 6f66 7465 6e20 6465 7369 7261 626c  s often desirabl
│ │ │ │ -00028ab0: 6520 746f 2063 6865 636b 2074 6861 7420  e to check that 
│ │ │ │ -00028ac0: 7468 6520 7665 7273 696f 6e20 6f66 2027  the version of '
│ │ │ │ -00028ad0: 4c69 6273 6869 7368 6927 2075 7365 6420  Libshishi' used 
│ │ │ │ -00028ae0: 6973 0a69 6e64 6565 6420 6f6e 6520 7768  is.indeed one wh
│ │ │ │ -00028af0: 6963 6820 6669 7473 2061 6c6c 2072 6571  ich fits all req
│ │ │ │ -00028b00: 7569 7265 6d65 6e74 732e 2020 4576 656e  uirements.  Even
│ │ │ │ -00028b10: 2077 6974 6820 6269 6e61 7279 2063 6f6d   with binary com
│ │ │ │ -00028b20: 7061 7469 6269 6c69 7479 0a6e 6577 2066  patibility.new f
│ │ │ │ -00028b30: 6561 7475 7265 7320 6d61 7920 6861 7665  eatures may have
│ │ │ │ -00028b40: 2062 6565 6e20 696e 7472 6f64 7563 6564   been introduced
│ │ │ │ -00028b50: 2062 7574 2064 7565 2074 6f20 7072 6f62   but due to prob
│ │ │ │ -00028b60: 6c65 6d20 7769 7468 2074 6865 0a64 796e  lem with the.dyn
│ │ │ │ -00028b70: 616d 6963 206c 696e 6b65 7220 616e 206f  amic linker an o
│ │ │ │ -00028b80: 6c64 2076 6572 7369 6f6e 2069 7320 6163  ld version is ac
│ │ │ │ -00028b90: 7475 616c 6c79 2075 7365 642e 2020 536f  tually used.  So
│ │ │ │ -00028ba0: 2079 6f75 206d 6179 2077 616e 7420 746f   you may want to
│ │ │ │ -00028bb0: 0a63 6865 636b 2074 6861 7420 7468 6520  .check that the 
│ │ │ │ -00028bc0: 7665 7273 696f 6e20 6973 206f 6b61 7920  version is okay 
│ │ │ │ -00028bd0: 7269 6768 7420 6166 7465 7220 7072 6f67  right after prog
│ │ │ │ -00028be0: 7261 6d20 7374 6172 7475 702e 0a0a 7368  ram startup...sh
│ │ │ │ -00028bf0: 6973 6869 5f63 6865 636b 5f76 6572 7369  ishi_check_versi
│ │ │ │ -00028c00: 6f6e 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  on.-------------
│ │ │ │ -00028c10: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ -00028c20: 6374 696f 6e3a 2063 6f6e 7374 2063 6861  ction: const cha
│ │ │ │ -00028c30: 7220 2a20 7368 6973 6869 5f63 6865 636b  r * shishi_check
│ │ │ │ -00028c40: 5f76 6572 7369 6f6e 0a20 2020 2020 2020  _version.       
│ │ │ │ -00028c50: 2020 2028 636f 6e73 7420 6368 6172 202a     (const char *
│ │ │ │ -00028c60: 2052 4551 5f56 4552 5349 4f4e 290a 2020   REQ_VERSION).  
│ │ │ │ -00028c70: 2020 2052 4551 5f56 4552 5349 4f4e 3a20     REQ_VERSION: 
│ │ │ │ -00028c80: 4f6c 6465 7374 2061 6363 6570 7461 626c  Oldest acceptabl
│ │ │ │ -00028c90: 6520 7665 7273 696f 6e2c 206f 7220 e280  e version, or ..
│ │ │ │ -00028ca0: 984e 554c 4ce2 8099 2e0a 0a20 2020 2020  .NULL......     
│ │ │ │ -00028cb0: 2a44 6573 6372 6970 7469 6f6e 3a2a 2043  *Description:* C
│ │ │ │ -00028cc0: 6865 636b 7320 7468 6174 2074 6865 2069  hecks that the i
│ │ │ │ -00028cd0: 6e73 7461 6c6c 6564 206c 6962 7261 7279  nstalled library
│ │ │ │ -00028ce0: 2076 6572 7369 6f6e 2069 7320 6174 0a20   version is at. 
│ │ │ │ -00028cf0: 2020 2020 6c65 6173 7420 6173 2072 6563      least as rec
│ │ │ │ -00028d00: 656e 7420 6173 2074 6865 206f 6e65 2070  ent as the one p
│ │ │ │ -00028d10: 726f 7669 6465 6420 696e 2052 4551 5f56  rovided in REQ_V
│ │ │ │ -00028d20: 4552 5349 4f4e 2e20 2054 6865 2076 6572  ERSION.  The ver
│ │ │ │ -00028d30: 7369 6f6e 0a20 2020 2020 7374 7269 6e67  sion.     string
│ │ │ │ -00028d40: 2069 7320 666f 726d 6174 7465 6420 6c69   is formatted li
│ │ │ │ -00028d50: 6b65 2022 312e 302e 3222 2e0a 0a20 2020  ke "1.0.2"...   
│ │ │ │ -00028d60: 2020 5768 656e 6576 6572 20e2 8098 4e55    Whenever ...NU
│ │ │ │ -00028d70: 4c4c e280 9920 6973 2070 6173 7365 6420  LL... is passed 
│ │ │ │ -00028d80: 746f 2074 6869 7320 6675 6e63 7469 6f6e  to this function
│ │ │ │ -00028d90: 2c20 7468 6520 6368 6563 6b20 6973 0a20  , the check is. 
│ │ │ │ -00028da0: 2020 2020 7375 7070 7265 7373 6564 2c20      suppressed, 
│ │ │ │ -00028db0: 6275 7420 7468 6520 6c69 6272 6172 7920  but the library 
│ │ │ │ -00028dc0: 7665 7273 696f 6e20 6973 2073 7469 6c6c  version is still
│ │ │ │ -00028dd0: 2072 6574 7572 6e65 642e 0a0a 2020 2020   returned...    
│ │ │ │ -00028de0: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ -00028df0: 2052 6574 7572 6e73 2074 6865 2061 6374   Returns the act
│ │ │ │ -00028e00: 6976 6520 6c69 6272 6172 7920 7665 7273  ive library vers
│ │ │ │ -00028e10: 696f 6e2c 206f 7220 e280 984e 554c 4ce2  ion, or ...NULL.
│ │ │ │ -00028e20: 8099 2c0a 2020 2020 2073 686f 756c 6420  ..,.     should 
│ │ │ │ -00028e30: 7468 6520 7275 6e6e 696e 6720 6c69 6272  the running libr
│ │ │ │ -00028e40: 6172 7920 6265 2074 6f6f 206f 6c64 2e0a  ary be too old..
│ │ │ │ -00028e50: 0a20 2020 5468 6520 6e6f 726d 616c 2077  .   The normal w
│ │ │ │ -00028e60: 6179 2074 6f20 7573 6520 7468 6520 6675  ay to use the fu
│ │ │ │ -00028e70: 6e63 7469 6f6e 2069 7320 746f 2070 7574  nction is to put
│ │ │ │ -00028e80: 2073 6f6d 6574 6869 6e67 2073 696d 696c   something simil
│ │ │ │ -00028e90: 6172 2074 6f20 7468 650a 666f 6c6c 6f77  ar to the.follow
│ │ │ │ -00028ea0: 696e 6720 6561 726c 7920 696e 2079 6f75  ing early in you
│ │ │ │ -00028eb0: 7220 e280 986d 6169 6ee2 8099 3a0a 0a20  r ...main...:.. 
│ │ │ │ -00028ec0: 2020 2020 2020 6966 2028 2173 6869 7368        if (!shish
│ │ │ │ -00028ed0: 695f 6368 6563 6b5f 7665 7273 696f 6e20  i_check_version 
│ │ │ │ -00028ee0: 2853 4849 5348 495f 5645 5253 494f 4e29  (SHISHI_VERSION)
│ │ │ │ -00028ef0: 290a 2020 2020 2020 2020 207b 0a20 2020  ).         {.   
│ │ │ │ -00028f00: 2020 2020 2020 2020 7072 696e 7466 2028          printf (
│ │ │ │ -00028f10: 2273 6869 7368 695f 6368 6563 6b5f 7665  "shishi_check_ve
│ │ │ │ -00028f20: 7273 696f 6e20 6661 696c 6564 3a5c 6e22  rsion failed:\n"
│ │ │ │ -00028f30: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ -00028f40: 2020 2020 2248 6561 6465 7220 6669 6c65      "Header file
│ │ │ │ -00028f50: 2069 6e63 6f6d 7061 7469 626c 6520 7769   incompatible wi
│ │ │ │ -00028f60: 7468 2073 6861 7265 6420 6c69 6272 6172  th shared librar
│ │ │ │ -00028f70: 792e 5c6e 2229 3b0a 2020 2020 2020 2020  y.\n");.        
│ │ │ │ -00028f80: 2020 2065 7869 7420 2845 5849 545f 4641     exit (EXIT_FA
│ │ │ │ -00028f90: 494c 5552 4529 3b0a 2020 2020 2020 2020  ILURE);.        
│ │ │ │ -00028fa0: 207d 0a0a 1f0a 4669 6c65 3a20 7368 6973   }....File: shis
│ │ │ │ -00028fb0: 6869 2e69 6e66 6f2c 2020 4e6f 6465 3a20  hi.info,  Node: 
│ │ │ │ -00028fc0: 4275 696c 6469 6e67 2074 6865 2073 6f75  Building the sou
│ │ │ │ -00028fd0: 7263 652c 2020 4e65 7874 3a20 4175 746f  rce,  Next: Auto
│ │ │ │ -00028fe0: 636f 6e66 2074 6573 7473 2c20 2050 7265  conf tests,  Pre
│ │ │ │ -00028ff0: 763a 2056 6572 7369 6f6e 2043 6865 636b  v: Version Check
│ │ │ │ -00029000: 2c20 2055 703a 2050 7265 7061 7261 7469  ,  Up: Preparati
│ │ │ │ -00029010: 6f6e 0a0a 352e 312e 3420 4275 696c 6469  on..5.1.4 Buildi
│ │ │ │ -00029020: 6e67 2074 6865 2073 6f75 7263 650a 2d2d  ng the source.--
│ │ │ │ +000277e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +000277f0: 2d0a 0ae2 8098 7061 7273 655f 6461 7465  -.....parse_date
│ │ │ │ +00027800: 7469 6d65 e280 9920 7374 6172 7465 6420  time... started 
│ │ │ │ +00027810: 6c69 6665 2061 7320 e280 9867 6574 6461  life as ...getda
│ │ │ │ +00027820: 7465 e280 992c 2061 7320 6f72 6967 696e  te..., as origin
│ │ │ │ +00027830: 616c 6c79 2069 6d70 6c65 6d65 6e74 6564  ally implemented
│ │ │ │ +00027840: 2062 790a 5374 6576 656e 204d 2e20 4265   by.Steven M. Be
│ │ │ │ +00027850: 6c6c 6f76 696e 2028 3c73 6d62 4072 6573  llovin (<smb@res
│ │ │ │ +00027860: 6561 7263 682e 6174 742e 636f 6d3e 2920  earch.att.com>) 
│ │ │ │ +00027870: 7768 696c 6520 6174 2074 6865 2055 6e69  while at the Uni
│ │ │ │ +00027880: 7665 7273 6974 7920 6f66 0a4e 6f72 7468  versity of.North
│ │ │ │ +00027890: 2043 6172 6f6c 696e 6120 6174 2043 6861   Carolina at Cha
│ │ │ │ +000278a0: 7065 6c20 4869 6c6c 2e20 2054 6865 2063  pel Hill.  The c
│ │ │ │ +000278b0: 6f64 6520 7761 7320 6c61 7465 7220 7477  ode was later tw
│ │ │ │ +000278c0: 6561 6b65 6420 6279 2061 2063 6f75 706c  eaked by a coupl
│ │ │ │ +000278d0: 650a 6f66 2070 656f 706c 6520 6f6e 2055  e.of people on U
│ │ │ │ +000278e0: 7365 6e65 742c 2074 6865 6e20 636f 6d70  senet, then comp
│ │ │ │ +000278f0: 6c65 7465 6c79 206f 7665 7268 6175 6c65  letely overhaule
│ │ │ │ +00027900: 6420 6279 2052 6963 6820 2461 6c7a 0a28  d by Rich $alz.(
│ │ │ │ +00027910: 3c72 7361 6c7a 4062 626e 2e63 6f6d 3e29  <rsalz@bbn.com>)
│ │ │ │ +00027920: 2061 6e64 204a 696d 2042 6572 6574 7320   and Jim Berets 
│ │ │ │ +00027930: 283c 6a62 6572 6574 7340 6262 6e2e 636f  (<jberets@bbn.co
│ │ │ │ +00027940: 6d3e 2920 696e 2041 7567 7573 742c 2031  m>) in August, 1
│ │ │ │ +00027950: 3939 302e 0a56 6172 696f 7573 2072 6576  990..Various rev
│ │ │ │ +00027960: 6973 696f 6e73 2066 6f72 2074 6865 2047  isions for the G
│ │ │ │ +00027970: 4e55 2073 7973 7465 6d20 7765 7265 206d  NU system were m
│ │ │ │ +00027980: 6164 6520 6279 2044 6176 6964 204d 6163  ade by David Mac
│ │ │ │ +00027990: 4b65 6e7a 6965 2c20 4a69 6d0a 4d65 7965  Kenzie, Jim.Meye
│ │ │ │ +000279a0: 7269 6e67 2c20 5061 756c 2045 6767 6572  ring, Paul Egger
│ │ │ │ +000279b0: 7420 616e 6420 6f74 6865 7273 2c20 696e  t and others, in
│ │ │ │ +000279c0: 636c 7564 696e 6720 7265 6e61 6d69 6e67  cluding renaming
│ │ │ │ +000279d0: 2069 7420 746f 20e2 8098 6765 745f 6461   it to ...get_da
│ │ │ │ +000279e0: 7465 e280 9920 746f 0a61 766f 6964 2061  te... to.avoid a
│ │ │ │ +000279f0: 2063 6f6e 666c 6963 7420 7769 7468 2074   conflict with t
│ │ │ │ +00027a00: 6865 2061 6c74 6572 6e61 7469 7665 2050  he alternative P
│ │ │ │ +00027a10: 6f73 6978 2066 756e 6374 696f 6e20 e280  osix function ..
│ │ │ │ +00027a20: 9867 6574 6461 7465 e280 992c 2061 6e64  .getdate..., and
│ │ │ │ +00027a30: 2061 0a6c 6174 6572 2072 656e 616d 6520   a.later rename 
│ │ │ │ +00027a40: 746f 20e2 8098 7061 7273 655f 6461 7465  to ...parse_date
│ │ │ │ +00027a50: 7469 6d65 e280 992e 2020 5468 6520 506f  time....  The Po
│ │ │ │ +00027a60: 7369 7820 6675 6e63 7469 6f6e 20e2 8098  six function ...
│ │ │ │ +00027a70: 6765 7464 6174 65e2 8099 2063 616e 0a70  getdate... can.p
│ │ │ │ +00027a80: 6172 7365 206d 6f72 6520 6c6f 6361 6c65  arse more locale
│ │ │ │ +00027a90: 2d73 7065 6369 6669 6320 6461 7465 7320  -specific dates 
│ │ │ │ +00027aa0: 7573 696e 6720 e280 9873 7472 7074 696d  using ...strptim
│ │ │ │ +00027ab0: 65e2 8099 2c20 6275 7420 7265 6c69 6573  e..., but relies
│ │ │ │ +00027ac0: 206f 6e20 616e 0a65 6e76 6972 6f6e 6d65   on an.environme
│ │ │ │ +00027ad0: 6e74 2076 6172 6961 626c 6520 616e 6420  nt variable and 
│ │ │ │ +00027ae0: 6578 7465 726e 616c 2066 696c 652c 2061  external file, a
│ │ │ │ +00027af0: 6e64 206c 6163 6b73 2074 6865 2074 6872  nd lacks the thr
│ │ │ │ +00027b00: 6561 642d 7361 6665 7479 206f 660a e280  ead-safety of...
│ │ │ │ +00027b10: 9870 6172 7365 5f64 6174 6574 696d 65e2  .parse_datetime.
│ │ │ │ +00027b20: 8099 2e0a 0a20 2020 5468 6973 2063 6861  .....   This cha
│ │ │ │ +00027b30: 7074 6572 2077 6173 206f 7269 6769 6e61  pter was origina
│ │ │ │ +00027b40: 6c6c 7920 7072 6f64 7563 6564 2062 7920  lly produced by 
│ │ │ │ +00027b50: 4672 616e c3a7 6f69 7320 5069 6e61 7264  Fran..ois Pinard
│ │ │ │ +00027b60: 0a28 3c70 696e 6172 6440 6972 6f2e 756d  .(<pinard@iro.um
│ │ │ │ +00027b70: 6f6e 7472 6561 6c2e 6361 3e29 2066 726f  ontreal.ca>) fro
│ │ │ │ +00027b80: 6d20 7468 6520 e280 9870 6172 7365 5f64  m the ...parse_d
│ │ │ │ +00027b90: 6174 6574 696d 652e 79e2 8099 2073 6f75  atetime.y... sou
│ │ │ │ +00027ba0: 7263 6520 636f 6465 2c20 616e 640a 7468  rce code, and.th
│ │ │ │ +00027bb0: 656e 2065 6469 7465 6420 6279 204b 2e20  en edited by K. 
│ │ │ │ +00027bc0: 4265 7272 7920 283c 6b62 4063 732e 756d  Berry (<kb@cs.um
│ │ │ │ +00027bd0: 622e 6564 753e 292e 0a0a 1f0a 4669 6c65  b.edu>).....File
│ │ │ │ +00027be0: 3a20 7368 6973 6869 2e69 6e66 6f2c 2020  : shishi.info,  
│ │ │ │ +00027bf0: 4e6f 6465 3a20 5072 6f67 7261 6d6d 696e  Node: Programmin
│ │ │ │ +00027c00: 6720 4d61 6e75 616c 2c20 204e 6578 743a  g Manual,  Next:
│ │ │ │ +00027c10: 2041 636b 6e6f 776c 6564 6765 6d65 6e74   Acknowledgement
│ │ │ │ +00027c20: 732c 2020 5072 6576 3a20 5265 6665 7265  s,  Prev: Refere
│ │ │ │ +00027c30: 6e63 6520 4d61 6e75 616c 2c20 2055 703a  nce Manual,  Up:
│ │ │ │ +00027c40: 2054 6f70 0a0a 3520 5072 6f67 7261 6d6d   Top..5 Programm
│ │ │ │ +00027c50: 696e 6720 4d61 6e75 616c 0a2a 2a2a 2a2a  ing Manual.*****
│ │ │ │ +00027c60: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a  ***************.
│ │ │ │ +00027c70: 0a54 6869 7320 6368 6170 7465 7220 6465  .This chapter de
│ │ │ │ +00027c80: 7363 7269 6265 7320 616c 6c20 7468 6520  scribes all the 
│ │ │ │ +00027c90: 7075 626c 6963 6c79 2061 7661 696c 6162  publicly availab
│ │ │ │ +00027ca0: 6c65 2066 756e 6374 696f 6e73 2069 6e20  le functions in 
│ │ │ │ +00027cb0: 7468 650a 6c69 6272 6172 792e 0a0a 2a20  the.library...* 
│ │ │ │ +00027cc0: 4d65 6e75 3a0a 0a2a 2050 7265 7061 7261  Menu:..* Prepara
│ │ │ │ +00027cd0: 7469 6f6e 3a3a 2020 2020 2020 2020 2020  tion::          
│ │ │ │ +00027ce0: 2020 2020 2020 2057 6861 7420 796f 7520         What you 
│ │ │ │ +00027cf0: 7368 6f75 6c64 2064 6f20 6265 666f 7265  should do before
│ │ │ │ +00027d00: 2075 7369 6e67 2074 6865 206c 6962 7261   using the libra
│ │ │ │ +00027d10: 7279 2e0a 2a20 496e 6974 6961 6c69 7a61  ry..* Initializa
│ │ │ │ +00027d20: 7469 6f6e 2046 756e 6374 696f 6e73 3a3a  tion Functions::
│ │ │ │ +00027d30: 2020 2020 4372 6561 7469 6e67 206c 6962      Creating lib
│ │ │ │ +00027d40: 7261 7279 2068 616e 646c 652c 2063 6f6e  rary handle, con
│ │ │ │ +00027d50: 6669 6775 7261 7469 6f6e 2066 696c 652e  figuration file.
│ │ │ │ +00027d60: 0a2a 2054 6963 6b65 7420 5365 7420 4675  .* Ticket Set Fu
│ │ │ │ +00027d70: 6e63 7469 6f6e 733a 3a20 2020 2020 2020  nctions::       
│ │ │ │ +00027d80: 2048 6967 682d 6c65 7665 6c20 7469 636b   High-level tick
│ │ │ │ +00027d90: 6574 206d 616e 6167 656d 656e 7420 6675  et management fu
│ │ │ │ +00027da0: 6e63 7469 6f6e 732e 0a2a 2041 502d 5245  nctions..* AP-RE
│ │ │ │ +00027db0: 5120 616e 6420 4150 2d52 4550 2046 756e  Q and AP-REP Fun
│ │ │ │ +00027dc0: 6374 696f 6e73 3a3a 2043 6c69 656e 742f  ctions:: Client/
│ │ │ │ +00027dd0: 5365 7276 6572 2061 7574 6865 6e74 6963  Server authentic
│ │ │ │ +00027de0: 6174 696f 6e20 6675 6e63 7469 6f6e 732e  ation functions.
│ │ │ │ +00027df0: 0a2a 2053 4146 4520 616e 6420 5052 4956  .* SAFE and PRIV
│ │ │ │ +00027e00: 2046 756e 6374 696f 6e73 3a3a 2020 2020   Functions::    
│ │ │ │ +00027e10: 2043 6c69 656e 742f 5365 7276 6572 2073   Client/Server s
│ │ │ │ +00027e20: 6573 7369 6f6e 2064 6174 6120 6675 6e63  ession data func
│ │ │ │ +00027e30: 7469 6f6e 732e 0a2a 2054 6963 6b65 7420  tions..* Ticket 
│ │ │ │ +00027e40: 4675 6e63 7469 6f6e 733a 3a20 2020 2020  Functions::     
│ │ │ │ +00027e50: 2020 2020 2020 204d 6564 6975 6d2d 6c65         Medium-le
│ │ │ │ +00027e60: 7665 6c20 7469 636b 6574 206d 616e 6970  vel ticket manip
│ │ │ │ +00027e70: 756c 6174 696f 6e20 6675 6e63 7469 6f6e  ulation function
│ │ │ │ +00027e80: 732e 0a2a 2041 5320 4675 6e63 7469 6f6e  s..* AS Function
│ │ │ │ +00027e90: 733a 3a20 2020 2020 2020 2020 2020 2020  s::             
│ │ │ │ +00027ea0: 2020 204d 6564 6975 6d2d 6c65 7665 6c20     Medium-level 
│ │ │ │ +00027eb0: 696e 6974 6961 6c20 6175 7468 656e 7469  initial authenti
│ │ │ │ +00027ec0: 6361 7469 6f6e 2066 756e 6374 696f 6e73  cation functions
│ │ │ │ +00027ed0: 2e0a 2a20 5447 5320 4675 6e63 7469 6f6e  ..* TGS Function
│ │ │ │ +00027ee0: 733a 3a20 2020 2020 2020 2020 2020 2020  s::             
│ │ │ │ +00027ef0: 2020 4d65 6469 756d 2d6c 6576 656c 2061    Medium-level a
│ │ │ │ +00027f00: 7574 6865 6e74 6963 6174 696f 6e20 6675  uthentication fu
│ │ │ │ +00027f10: 6e63 7469 6f6e 732e 0a2a 2054 6963 6b65  nctions..* Ticke
│ │ │ │ +00027f20: 7420 2841 534e 2e31 2920 4675 6e63 7469  t (ASN.1) Functi
│ │ │ │ +00027f30: 6f6e 733a 3a20 2020 204c 6f77 2d6c 6576  ons::    Low-lev
│ │ │ │ +00027f40: 656c 2054 6963 6b65 7420 6675 6e63 7469  el Ticket functi
│ │ │ │ +00027f50: 6f6e 732e 0a2a 2041 532f 5447 5320 4675  ons..* AS/TGS Fu
│ │ │ │ +00027f60: 6e63 7469 6f6e 733a 3a20 2020 2020 2020  nctions::       
│ │ │ │ +00027f70: 2020 2020 204c 6f77 2d6c 6576 656c 204b       Low-level K
│ │ │ │ +00027f80: 4443 2066 756e 6374 696f 6e73 3b20 4153  DC functions; AS
│ │ │ │ +00027f90: 2061 6e64 2054 4753 2e0a 2a20 4175 7468   and TGS..* Auth
│ │ │ │ +00027fa0: 656e 7469 6361 746f 7220 4675 6e63 7469  enticator Functi
│ │ │ │ +00027fb0: 6f6e 733a 3a20 2020 2020 4c6f 772d 6c65  ons::     Low-le
│ │ │ │ +00027fc0: 7665 6c20 6175 7468 656e 7469 6361 746f  vel authenticato
│ │ │ │ +00027fd0: 7220 6675 6e63 7469 6f6e 732e 0a2a 204b  r functions..* K
│ │ │ │ +00027fe0: 5242 2d45 5252 4f52 2046 756e 6374 696f  RB-ERROR Functio
│ │ │ │ +00027ff0: 6e73 3a3a 2020 2020 2020 2020 204c 6f77  ns::         Low
│ │ │ │ +00028000: 2d6c 6576 656c 204b 5242 2d45 5252 4f52  -level KRB-ERROR
│ │ │ │ +00028010: 2066 756e 6374 696f 6e73 2e0a 2a20 4372   functions..* Cr
│ │ │ │ +00028020: 7970 746f 6772 6170 6869 6320 4675 6e63  yptographic Func
│ │ │ │ +00028030: 7469 6f6e 733a 3a20 2020 2020 4c6f 772d  tions::     Low-
│ │ │ │ +00028040: 6c65 7665 6c20 6372 7970 746f 6772 6170  level cryptograp
│ │ │ │ +00028050: 6869 6320 6675 6e63 7469 6f6e 732e 0a2a  hic functions..*
│ │ │ │ +00028060: 2058 2e35 3039 2046 756e 6374 696f 6e73   X.509 Functions
│ │ │ │ +00028070: 3a3a 2020 2020 2020 2020 2020 2020 2055  ::             U
│ │ │ │ +00028080: 7469 6c69 7479 2066 756e 6374 696f 6e73  tility functions
│ │ │ │ +00028090: 2066 6f72 2058 2e35 3039 2073 7570 706f   for X.509 suppo
│ │ │ │ +000280a0: 7274 2e0a 2a20 5574 696c 6974 7920 4675  rt..* Utility Fu
│ │ │ │ +000280b0: 6e63 7469 6f6e 733a 3a20 2020 2020 2020  nctions::       
│ │ │ │ +000280c0: 2020 2020 5574 696c 6974 6965 7320 666f      Utilities fo
│ │ │ │ +000280d0: 7220 7573 6520 696e 2074 6865 2067 6c6f  r use in the glo
│ │ │ │ +000280e0: 6261 6c20 636f 6e74 6578 742e 0a2a 2041  bal context..* A
│ │ │ │ +000280f0: 534e 2e31 2046 756e 6374 696f 6e73 3a3a  SN.1 Functions::
│ │ │ │ +00028100: 2020 2020 2020 2020 2020 2020 2050 6572               Per
│ │ │ │ +00028110: 666f 726d 206c 6f77 2d6c 6576 656c 2041  form low-level A
│ │ │ │ +00028120: 534e 2e31 206d 616e 6970 756c 6174 696f  SN.1 manipulatio
│ │ │ │ +00028130: 6e73 2e0a 2a20 4572 726f 7220 4861 6e64  ns..* Error Hand
│ │ │ │ +00028140: 6c69 6e67 3a3a 2020 2020 2020 2020 2020  ling::          
│ │ │ │ +00028150: 2020 2020 4572 726f 7220 636f 6465 7320      Error codes 
│ │ │ │ +00028160: 616e 6420 7375 6368 2e0a 2a20 4578 616d  and such..* Exam
│ │ │ │ +00028170: 706c 6573 3a3a 2020 2020 2020 2020 2020  ples::          
│ │ │ │ +00028180: 2020 2020 2020 2020 2020 4578 616d 706c            Exampl
│ │ │ │ +00028190: 6520 636f 6465 2e0a 2a20 4b65 7262 6572  e code..* Kerber
│ │ │ │ +000281a0: 6f73 2044 6174 6162 6173 6520 4675 6e63  os Database Func
│ │ │ │ +000281b0: 7469 6f6e 733a 3a20 5468 6520 5368 6973  tions:: The Shis
│ │ │ │ +000281c0: 6120 6765 6e65 7269 6320 6461 7461 6261  a generic databa
│ │ │ │ +000281d0: 7365 2069 6e74 6572 6661 6365 2e0a 2a20  se interface..* 
│ │ │ │ +000281e0: 4765 6e65 7269 6320 5365 6375 7269 7479  Generic Security
│ │ │ │ +000281f0: 2053 6572 7669 6365 3a3a 2020 2020 4966   Service::    If
│ │ │ │ +00028200: 2079 6f75 2077 616e 7420 746f 2075 7365   you want to use
│ │ │ │ +00028210: 2074 6865 2047 5353 2041 5049 2069 6e73   the GSS API ins
│ │ │ │ +00028220: 7465 6164 2e0a 0a1f 0a46 696c 653a 2073  tead.....File: s
│ │ │ │ +00028230: 6869 7368 692e 696e 666f 2c20 204e 6f64  hishi.info,  Nod
│ │ │ │ +00028240: 653a 2050 7265 7061 7261 7469 6f6e 2c20  e: Preparation, 
│ │ │ │ +00028250: 204e 6578 743a 2049 6e69 7469 616c 697a   Next: Initializ
│ │ │ │ +00028260: 6174 696f 6e20 4675 6e63 7469 6f6e 732c  ation Functions,
│ │ │ │ +00028270: 2020 5570 3a20 5072 6f67 7261 6d6d 696e    Up: Programmin
│ │ │ │ +00028280: 6720 4d61 6e75 616c 0a0a 352e 3120 5072  g Manual..5.1 Pr
│ │ │ │ +00028290: 6570 6172 6174 696f 6e0a 3d3d 3d3d 3d3d  eparation.======
│ │ │ │ +000282a0: 3d3d 3d3d 3d3d 3d3d 3d0a 0a54 6f20 7573  =========..To us
│ │ │ │ +000282b0: 6520 274c 6962 7368 6973 6869 272c 2079  e 'Libshishi', y
│ │ │ │ +000282c0: 6f75 2068 6176 6520 746f 2070 6572 666f  ou have to perfo
│ │ │ │ +000282d0: 726d 2073 6f6d 6520 6368 616e 6765 7320  rm some changes 
│ │ │ │ +000282e0: 746f 2079 6f75 7220 736f 7572 6365 7320  to your sources 
│ │ │ │ +000282f0: 616e 640a 7468 6520 6275 696c 6420 7379  and.the build sy
│ │ │ │ +00028300: 7374 656d 2e20 2054 6865 206e 6563 6573  stem.  The neces
│ │ │ │ +00028310: 7361 7279 2063 6861 6e67 6573 2061 7265  sary changes are
│ │ │ │ +00028320: 2073 6d61 6c6c 2061 6e64 2065 7870 6c61   small and expla
│ │ │ │ +00028330: 696e 6564 2069 6e20 7468 650a 666f 6c6c  ined in the.foll
│ │ │ │ +00028340: 6f77 696e 6720 7365 6374 696f 6e73 2e20  owing sections. 
│ │ │ │ +00028350: 2041 7420 7468 6520 656e 6420 6f66 2074   At the end of t
│ │ │ │ +00028360: 6869 7320 6368 6170 7465 722c 2069 7420  his chapter, it 
│ │ │ │ +00028370: 6973 2064 6573 6372 6962 6564 2068 6f77  is described how
│ │ │ │ +00028380: 2074 6865 0a6c 6962 7261 7279 2069 7320   the.library is 
│ │ │ │ +00028390: 696e 6974 6961 6c69 7a65 642c 2061 6e64  initialized, and
│ │ │ │ +000283a0: 2068 6f77 2074 6865 2072 6571 7569 7265   how the require
│ │ │ │ +000283b0: 6d65 6e74 7320 6f66 2074 6865 206c 6962  ments of the lib
│ │ │ │ +000283c0: 7261 7279 2061 7265 0a76 6572 6966 6965  rary are.verifie
│ │ │ │ +000283d0: 642e 0a0a 2020 2041 2066 6173 7465 7220  d...   A faster 
│ │ │ │ +000283e0: 7761 7920 746f 2066 696e 6420 6f75 7420  way to find out 
│ │ │ │ +000283f0: 686f 7720 746f 2061 6461 7074 2079 6f75  how to adapt you
│ │ │ │ +00028400: 7220 6170 706c 6963 6174 696f 6e20 666f  r application fo
│ │ │ │ +00028410: 7220 7573 6520 7769 7468 0a27 4c69 6273  r use with.'Libs
│ │ │ │ +00028420: 6869 7368 6927 206d 6179 2062 6520 746f  hishi' may be to
│ │ │ │ +00028430: 206c 6f6f 6b20 6174 2074 6865 2065 7861   look at the exa
│ │ │ │ +00028440: 6d70 6c65 7320 6174 2074 6865 2065 6e64  mples at the end
│ │ │ │ +00028450: 206f 6620 7468 6973 206d 616e 7561 6c0a   of this manual.
│ │ │ │ +00028460: 282a 6e6f 7465 2045 7861 6d70 6c65 733a  (*note Examples:
│ │ │ │ +00028470: 3a29 2e0a 0a2a 204d 656e 753a 0a0a 2a20  :)...* Menu:..* 
│ │ │ │ +00028480: 4865 6164 6572 3a3a 0a2a 2049 6e69 7469  Header::.* Initi
│ │ │ │ +00028490: 616c 697a 6174 696f 6e3a 3a0a 2a20 5665  alization::.* Ve
│ │ │ │ +000284a0: 7273 696f 6e20 4368 6563 6b3a 3a0a 2a20  rsion Check::.* 
│ │ │ │ +000284b0: 4275 696c 6469 6e67 2074 6865 2073 6f75  Building the sou
│ │ │ │ +000284c0: 7263 653a 3a0a 2a20 4175 746f 636f 6e66  rce::.* Autoconf
│ │ │ │ +000284d0: 2074 6573 7473 3a3a 0a0a 1f0a 4669 6c65   tests::....File
│ │ │ │ +000284e0: 3a20 7368 6973 6869 2e69 6e66 6f2c 2020  : shishi.info,  
│ │ │ │ +000284f0: 4e6f 6465 3a20 4865 6164 6572 2c20 204e  Node: Header,  N
│ │ │ │ +00028500: 6578 743a 2049 6e69 7469 616c 697a 6174  ext: Initializat
│ │ │ │ +00028510: 696f 6e2c 2020 5570 3a20 5072 6570 6172  ion,  Up: Prepar
│ │ │ │ +00028520: 6174 696f 6e0a 0a35 2e31 2e31 2048 6561  ation..5.1.1 Hea
│ │ │ │ +00028530: 6465 720a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  der.------------
│ │ │ │ +00028540: 0a0a 416c 6c20 696e 7465 7266 6163 6573  ..All interfaces
│ │ │ │ +00028550: 2028 6461 7461 2074 7970 6573 2061 6e64   (data types and
│ │ │ │ +00028560: 2066 756e 6374 696f 6e73 2920 6f66 2074   functions) of t
│ │ │ │ +00028570: 6865 206c 6962 7261 7279 2061 7265 2064  he library are d
│ │ │ │ +00028580: 6566 696e 6564 2069 6e0a 7468 6520 6865  efined in.the he
│ │ │ │ +00028590: 6164 6572 2066 696c 6520 2773 6869 7368  ader file 'shish
│ │ │ │ +000285a0: 692e 6827 2e20 2059 6f75 206d 7573 7420  i.h'.  You must 
│ │ │ │ +000285b0: 696e 636c 7564 6520 7468 6973 2069 6e20  include this in 
│ │ │ │ +000285c0: 616c 6c20 7072 6f67 7261 6d73 2075 7369  all programs usi
│ │ │ │ +000285d0: 6e67 0a74 6865 206c 6962 7261 7279 2c20  ng.the library, 
│ │ │ │ +000285e0: 6569 7468 6572 2064 6972 6563 746c 7920  either directly 
│ │ │ │ +000285f0: 6f72 2074 6872 6f75 6768 2073 6f6d 6520  or through some 
│ │ │ │ +00028600: 6f74 6865 7220 6865 6164 6572 2066 696c  other header fil
│ │ │ │ +00028610: 652c 206c 696b 650a 7468 6973 3a0a 0a20  e, like.this:.. 
│ │ │ │ +00028620: 2020 2020 2369 6e63 6c75 6465 203c 7368      #include <sh
│ │ │ │ +00028630: 6973 6869 2e68 3e0a 0a20 2020 5468 6520  ishi.h>..   The 
│ │ │ │ +00028640: 6e61 6d65 2073 7061 6365 206f 6620 274c  name space of 'L
│ │ │ │ +00028650: 6962 7368 6973 6869 2720 6973 20e2 8098  ibshishi' is ...
│ │ │ │ +00028660: 7368 6973 6869 5f2a e280 9920 666f 7220  shishi_*... for 
│ │ │ │ +00028670: 6675 6e63 7469 6f6e 206e 616d 6573 2c0a  function names,.
│ │ │ │ +00028680: e280 9853 6869 7368 692a e280 9920 666f  ...Shishi*... fo
│ │ │ │ +00028690: 7220 6461 7461 2074 7970 6573 2061 6e64  r data types and
│ │ │ │ +000286a0: 20e2 8098 5348 4953 4849 5f2a e280 9920   ...SHISHI_*... 
│ │ │ │ +000286b0: 666f 7220 6f74 6865 7220 7379 6d62 6f6c  for other symbol
│ │ │ │ +000286c0: 732e 2020 496e 2061 6464 6974 696f 6e0a  s.  In addition.
│ │ │ │ +000286d0: 7468 6520 7361 6d65 206e 616d 6520 7072  the same name pr
│ │ │ │ +000286e0: 6566 6978 6573 2077 6974 6820 6f6e 6520  efixes with one 
│ │ │ │ +000286f0: 7072 6570 656e 6465 6420 756e 6465 7273  prepended unders
│ │ │ │ +00028700: 636f 7265 2061 7265 2072 6573 6572 7665  core are reserve
│ │ │ │ +00028710: 6420 666f 720a 696e 7465 726e 616c 2075  d for.internal u
│ │ │ │ +00028720: 7365 2061 6e64 2073 686f 756c 6420 6e65  se and should ne
│ │ │ │ +00028730: 7665 7220 6265 2075 7365 6420 6279 2061  ver be used by a
│ │ │ │ +00028740: 6e20 6170 706c 6963 6174 696f 6e2e 0a0a  n application...
│ │ │ │ +00028750: 1f0a 4669 6c65 3a20 7368 6973 6869 2e69  ..File: shishi.i
│ │ │ │ +00028760: 6e66 6f2c 2020 4e6f 6465 3a20 496e 6974  nfo,  Node: Init
│ │ │ │ +00028770: 6961 6c69 7a61 7469 6f6e 2c20 204e 6578  ialization,  Nex
│ │ │ │ +00028780: 743a 2056 6572 7369 6f6e 2043 6865 636b  t: Version Check
│ │ │ │ +00028790: 2c20 2050 7265 763a 2048 6561 6465 722c  ,  Prev: Header,
│ │ │ │ +000287a0: 2020 5570 3a20 5072 6570 6172 6174 696f    Up: Preparatio
│ │ │ │ +000287b0: 6e0a 0a35 2e31 2e32 2049 6e69 7469 616c  n..5.1.2 Initial
│ │ │ │ +000287c0: 697a 6174 696f 6e0a 2d2d 2d2d 2d2d 2d2d  ization.--------
│ │ │ │ +000287d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 274c  ------------..'L
│ │ │ │ +000287e0: 6962 7368 6973 6869 2720 6d75 7374 2062  ibshishi' must b
│ │ │ │ +000287f0: 6520 696e 6974 6961 6c69 7a65 6420 6265  e initialized be
│ │ │ │ +00028800: 666f 7265 2069 7420 6361 6e20 6265 2075  fore it can be u
│ │ │ │ +00028810: 7365 642e 2020 5468 6520 6c69 6272 6172  sed.  The librar
│ │ │ │ +00028820: 7920 6973 0a69 6e69 7469 616c 697a 6564  y is.initialized
│ │ │ │ +00028830: 2062 7920 6361 6c6c 696e 6720 e280 9873   by calling ...s
│ │ │ │ +00028840: 6869 7368 695f 696e 6974 e280 9920 282a  hishi_init... (*
│ │ │ │ +00028850: 6e6f 7465 2049 6e69 7469 616c 697a 6174  note Initializat
│ │ │ │ +00028860: 696f 6e20 4675 6e63 7469 6f6e 733a 3a29  ion Functions::)
│ │ │ │ +00028870: 2e0a 5468 6520 7265 736f 7572 6365 7320  ..The resources 
│ │ │ │ +00028880: 616c 6c6f 6361 7465 6420 6279 2074 6865  allocated by the
│ │ │ │ +00028890: 2069 6e69 7469 616c 697a 6174 696f 6e20   initialization 
│ │ │ │ +000288a0: 7072 6f63 6573 7320 6361 6e20 6265 2072  process can be r
│ │ │ │ +000288b0: 656c 6561 7365 6420 6966 0a74 6865 2061  eleased if.the a
│ │ │ │ +000288c0: 7070 6c69 6361 7469 6f6e 206e 6f20 6c6f  pplication no lo
│ │ │ │ +000288d0: 6e67 6572 2068 6173 2061 206e 6565 6420  nger has a need 
│ │ │ │ +000288e0: 746f 2063 616c 6c20 274c 6962 7368 6973  to call 'Libshis
│ │ │ │ +000288f0: 6869 2720 6675 6e63 7469 6f6e 732c 2074  hi' functions, t
│ │ │ │ +00028900: 6869 730a 6973 2064 6f6e 6520 6279 2063  his.is done by c
│ │ │ │ +00028910: 616c 6c69 6e67 20e2 8098 7368 6973 6869  alling ...shishi
│ │ │ │ +00028920: 5f64 6f6e 65e2 8099 2e0a 0a20 2020 496e  _done......   In
│ │ │ │ +00028930: 206f 7264 6572 2074 6f20 7461 6b65 2061   order to take a
│ │ │ │ +00028940: 6476 616e 7461 6765 206f 6620 7468 6520  dvantage of the 
│ │ │ │ +00028950: 696e 7465 726e 6174 696f 6e61 6c69 7361  internationalisa
│ │ │ │ +00028960: 7469 6f6e 2066 6561 7475 7265 7320 696e  tion features in
│ │ │ │ +00028970: 0a27 4c69 6273 6869 7368 6927 2c20 7375  .'Libshishi', su
│ │ │ │ +00028980: 6368 2061 7320 7472 616e 736c 6174 6564  ch as translated
│ │ │ │ +00028990: 2065 7272 6f72 206d 6573 7361 6765 732c   error messages,
│ │ │ │ +000289a0: 2074 6865 2061 7070 6c69 6361 7469 6f6e   the application
│ │ │ │ +000289b0: 206d 7573 7420 7365 740a 7468 6520 6375   must set.the cu
│ │ │ │ +000289c0: 7272 656e 7420 6c6f 6361 6c65 2075 7369  rrent locale usi
│ │ │ │ +000289d0: 6e67 20e2 8098 7365 746c 6f63 616c 65e2  ng ...setlocale.
│ │ │ │ +000289e0: 8099 2062 6566 6f72 6520 696e 6974 6961  .. before initia
│ │ │ │ +000289f0: 6c69 7a69 6e67 2027 4c69 6273 6869 7368  lizing 'Libshish
│ │ │ │ +00028a00: 6927 2e0a 0a1f 0a46 696c 653a 2073 6869  i'.....File: shi
│ │ │ │ +00028a10: 7368 692e 696e 666f 2c20 204e 6f64 653a  shi.info,  Node:
│ │ │ │ +00028a20: 2056 6572 7369 6f6e 2043 6865 636b 2c20   Version Check, 
│ │ │ │ +00028a30: 204e 6578 743a 2042 7569 6c64 696e 6720   Next: Building 
│ │ │ │ +00028a40: 7468 6520 736f 7572 6365 2c20 2050 7265  the source,  Pre
│ │ │ │ +00028a50: 763a 2049 6e69 7469 616c 697a 6174 696f  v: Initializatio
│ │ │ │ +00028a60: 6e2c 2020 5570 3a20 5072 6570 6172 6174  n,  Up: Preparat
│ │ │ │ +00028a70: 696f 6e0a 0a35 2e31 2e33 2056 6572 7369  ion..5.1.3 Versi
│ │ │ │ +00028a80: 6f6e 2043 6865 636b 0a2d 2d2d 2d2d 2d2d  on Check.-------
│ │ │ │ +00028a90: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 4974  ------------..It
│ │ │ │ +00028aa0: 2069 7320 6f66 7465 6e20 6465 7369 7261   is often desira
│ │ │ │ +00028ab0: 626c 6520 746f 2063 6865 636b 2074 6861  ble to check tha
│ │ │ │ +00028ac0: 7420 7468 6520 7665 7273 696f 6e20 6f66  t the version of
│ │ │ │ +00028ad0: 2027 4c69 6273 6869 7368 6927 2075 7365   'Libshishi' use
│ │ │ │ +00028ae0: 6420 6973 0a69 6e64 6565 6420 6f6e 6520  d is.indeed one 
│ │ │ │ +00028af0: 7768 6963 6820 6669 7473 2061 6c6c 2072  which fits all r
│ │ │ │ +00028b00: 6571 7569 7265 6d65 6e74 732e 2020 4576  equirements.  Ev
│ │ │ │ +00028b10: 656e 2077 6974 6820 6269 6e61 7279 2063  en with binary c
│ │ │ │ +00028b20: 6f6d 7061 7469 6269 6c69 7479 0a6e 6577  ompatibility.new
│ │ │ │ +00028b30: 2066 6561 7475 7265 7320 6d61 7920 6861   features may ha
│ │ │ │ +00028b40: 7665 2062 6565 6e20 696e 7472 6f64 7563  ve been introduc
│ │ │ │ +00028b50: 6564 2062 7574 2064 7565 2074 6f20 7072  ed but due to pr
│ │ │ │ +00028b60: 6f62 6c65 6d20 7769 7468 2074 6865 0a64  oblem with the.d
│ │ │ │ +00028b70: 796e 616d 6963 206c 696e 6b65 7220 616e  ynamic linker an
│ │ │ │ +00028b80: 206f 6c64 2076 6572 7369 6f6e 2069 7320   old version is 
│ │ │ │ +00028b90: 6163 7475 616c 6c79 2075 7365 642e 2020  actually used.  
│ │ │ │ +00028ba0: 536f 2079 6f75 206d 6179 2077 616e 7420  So you may want 
│ │ │ │ +00028bb0: 746f 0a63 6865 636b 2074 6861 7420 7468  to.check that th
│ │ │ │ +00028bc0: 6520 7665 7273 696f 6e20 6973 206f 6b61  e version is oka
│ │ │ │ +00028bd0: 7920 7269 6768 7420 6166 7465 7220 7072  y right after pr
│ │ │ │ +00028be0: 6f67 7261 6d20 7374 6172 7475 702e 0a0a  ogram startup...
│ │ │ │ +00028bf0: 7368 6973 6869 5f63 6865 636b 5f76 6572  shishi_check_ver
│ │ │ │ +00028c00: 7369 6f6e 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  sion.-----------
│ │ │ │ +00028c10: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +00028c20: 756e 6374 696f 6e3a 2063 6f6e 7374 2063  unction: const c
│ │ │ │ +00028c30: 6861 7220 2a20 7368 6973 6869 5f63 6865  har * shishi_che
│ │ │ │ +00028c40: 636b 5f76 6572 7369 6f6e 0a20 2020 2020  ck_version.     
│ │ │ │ +00028c50: 2020 2020 2028 636f 6e73 7420 6368 6172       (const char
│ │ │ │ +00028c60: 202a 2052 4551 5f56 4552 5349 4f4e 290a   * REQ_VERSION).
│ │ │ │ +00028c70: 2020 2020 2052 4551 5f56 4552 5349 4f4e       REQ_VERSION
│ │ │ │ +00028c80: 3a20 4f6c 6465 7374 2061 6363 6570 7461  : Oldest accepta
│ │ │ │ +00028c90: 626c 6520 7665 7273 696f 6e2c 206f 7220  ble version, or 
│ │ │ │ +00028ca0: e280 984e 554c 4ce2 8099 2e0a 0a20 2020  ...NULL......   
│ │ │ │ +00028cb0: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ +00028cc0: 2043 6865 636b 7320 7468 6174 2074 6865   Checks that the
│ │ │ │ +00028cd0: 2069 6e73 7461 6c6c 6564 206c 6962 7261   installed libra
│ │ │ │ +00028ce0: 7279 2076 6572 7369 6f6e 2069 7320 6174  ry version is at
│ │ │ │ +00028cf0: 0a20 2020 2020 6c65 6173 7420 6173 2072  .     least as r
│ │ │ │ +00028d00: 6563 656e 7420 6173 2074 6865 206f 6e65  ecent as the one
│ │ │ │ +00028d10: 2070 726f 7669 6465 6420 696e 2052 4551   provided in REQ
│ │ │ │ +00028d20: 5f56 4552 5349 4f4e 2e20 2054 6865 2076  _VERSION.  The v
│ │ │ │ +00028d30: 6572 7369 6f6e 0a20 2020 2020 7374 7269  ersion.     stri
│ │ │ │ +00028d40: 6e67 2069 7320 666f 726d 6174 7465 6420  ng is formatted 
│ │ │ │ +00028d50: 6c69 6b65 2022 312e 302e 3222 2e0a 0a20  like "1.0.2"... 
│ │ │ │ +00028d60: 2020 2020 5768 656e 6576 6572 20e2 8098      Whenever ...
│ │ │ │ +00028d70: 4e55 4c4c e280 9920 6973 2070 6173 7365  NULL... is passe
│ │ │ │ +00028d80: 6420 746f 2074 6869 7320 6675 6e63 7469  d to this functi
│ │ │ │ +00028d90: 6f6e 2c20 7468 6520 6368 6563 6b20 6973  on, the check is
│ │ │ │ +00028da0: 0a20 2020 2020 7375 7070 7265 7373 6564  .     suppressed
│ │ │ │ +00028db0: 2c20 6275 7420 7468 6520 6c69 6272 6172  , but the librar
│ │ │ │ +00028dc0: 7920 7665 7273 696f 6e20 6973 2073 7469  y version is sti
│ │ │ │ +00028dd0: 6c6c 2072 6574 7572 6e65 642e 0a0a 2020  ll returned...  
│ │ │ │ +00028de0: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ +00028df0: 3a2a 2052 6574 7572 6e73 2074 6865 2061  :* Returns the a
│ │ │ │ +00028e00: 6374 6976 6520 6c69 6272 6172 7920 7665  ctive library ve
│ │ │ │ +00028e10: 7273 696f 6e2c 206f 7220 e280 984e 554c  rsion, or ...NUL
│ │ │ │ +00028e20: 4ce2 8099 2c0a 2020 2020 2073 686f 756c  L...,.     shoul
│ │ │ │ +00028e30: 6420 7468 6520 7275 6e6e 696e 6720 6c69  d the running li
│ │ │ │ +00028e40: 6272 6172 7920 6265 2074 6f6f 206f 6c64  brary be too old
│ │ │ │ +00028e50: 2e0a 0a20 2020 5468 6520 6e6f 726d 616c  ...   The normal
│ │ │ │ +00028e60: 2077 6179 2074 6f20 7573 6520 7468 6520   way to use the 
│ │ │ │ +00028e70: 6675 6e63 7469 6f6e 2069 7320 746f 2070  function is to p
│ │ │ │ +00028e80: 7574 2073 6f6d 6574 6869 6e67 2073 696d  ut something sim
│ │ │ │ +00028e90: 696c 6172 2074 6f20 7468 650a 666f 6c6c  ilar to the.foll
│ │ │ │ +00028ea0: 6f77 696e 6720 6561 726c 7920 696e 2079  owing early in y
│ │ │ │ +00028eb0: 6f75 7220 e280 986d 6169 6ee2 8099 3a0a  our ...main...:.
│ │ │ │ +00028ec0: 0a20 2020 2020 2020 6966 2028 2173 6869  .       if (!shi
│ │ │ │ +00028ed0: 7368 695f 6368 6563 6b5f 7665 7273 696f  shi_check_versio
│ │ │ │ +00028ee0: 6e20 2853 4849 5348 495f 5645 5253 494f  n (SHISHI_VERSIO
│ │ │ │ +00028ef0: 4e29 290a 2020 2020 2020 2020 207b 0a20  N)).         {. 
│ │ │ │ +00028f00: 2020 2020 2020 2020 2020 7072 696e 7466            printf
│ │ │ │ +00028f10: 2028 2273 6869 7368 695f 6368 6563 6b5f   ("shishi_check_
│ │ │ │ +00028f20: 7665 7273 696f 6e20 6661 696c 6564 3a5c  version failed:\
│ │ │ │ +00028f30: 6e22 0a20 2020 2020 2020 2020 2020 2020  n".             
│ │ │ │ +00028f40: 2020 2020 2020 2248 6561 6465 7220 6669        "Header fi
│ │ │ │ +00028f50: 6c65 2069 6e63 6f6d 7061 7469 626c 6520  le incompatible 
│ │ │ │ +00028f60: 7769 7468 2073 6861 7265 6420 6c69 6272  with shared libr
│ │ │ │ +00028f70: 6172 792e 5c6e 2229 3b0a 2020 2020 2020  ary.\n");.      
│ │ │ │ +00028f80: 2020 2020 2065 7869 7420 2845 5849 545f       exit (EXIT_
│ │ │ │ +00028f90: 4641 494c 5552 4529 3b0a 2020 2020 2020  FAILURE);.      
│ │ │ │ +00028fa0: 2020 207d 0a0a 1f0a 4669 6c65 3a20 7368     }....File: sh
│ │ │ │ +00028fb0: 6973 6869 2e69 6e66 6f2c 2020 4e6f 6465  ishi.info,  Node
│ │ │ │ +00028fc0: 3a20 4275 696c 6469 6e67 2074 6865 2073  : Building the s
│ │ │ │ +00028fd0: 6f75 7263 652c 2020 4e65 7874 3a20 4175  ource,  Next: Au
│ │ │ │ +00028fe0: 746f 636f 6e66 2074 6573 7473 2c20 2050  toconf tests,  P
│ │ │ │ +00028ff0: 7265 763a 2056 6572 7369 6f6e 2043 6865  rev: Version Che
│ │ │ │ +00029000: 636b 2c20 2055 703a 2050 7265 7061 7261  ck,  Up: Prepara
│ │ │ │ +00029010: 7469 6f6e 0a0a 352e 312e 3420 4275 696c  tion..5.1.4 Buil
│ │ │ │ +00029020: 6469 6e67 2074 6865 2073 6f75 7263 650a  ding the source.
│ │ │ │  00029030: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00029040: 2d2d 2d2d 2d2d 2d0a 0a49 6620 796f 7520  -------..If you 
│ │ │ │ -00029050: 7761 6e74 2074 6f20 636f 6d70 696c 6520  want to compile 
│ │ │ │ -00029060: 6120 736f 7572 6365 2066 696c 6520 696e  a source file in
│ │ │ │ -00029070: 636c 7564 696e 6720 7468 6520 2773 6869  cluding the 'shi
│ │ │ │ -00029080: 7368 692e 6827 2068 6561 6465 720a 6669  shi.h' header.fi
│ │ │ │ -00029090: 6c65 2c20 796f 7520 6d75 7374 206d 616b  le, you must mak
│ │ │ │ -000290a0: 6520 7375 7265 2074 6861 7420 7468 6520  e sure that the 
│ │ │ │ -000290b0: 636f 6d70 696c 6572 2063 616e 2066 696e  compiler can fin
│ │ │ │ -000290c0: 6420 6974 2069 6e20 7468 6520 6469 7265  d it in the dire
│ │ │ │ -000290d0: 6374 6f72 790a 6869 6572 6172 6368 792e  ctory.hierarchy.
│ │ │ │ -000290e0: 2020 5468 6973 2069 7320 6163 636f 6d70    This is accomp
│ │ │ │ -000290f0: 6c69 7368 6564 2062 7920 6164 6469 6e67  lished by adding
│ │ │ │ -00029100: 2074 6865 2070 6174 6820 746f 2074 6865   the path to the
│ │ │ │ -00029110: 2064 6972 6563 746f 7279 2069 6e0a 7768   directory in.wh
│ │ │ │ -00029120: 6963 6820 7468 6520 6865 6164 6572 2066  ich the header f
│ │ │ │ -00029130: 696c 6520 6973 206c 6f63 6174 6564 2074  ile is located t
│ │ │ │ -00029140: 6f20 7468 6520 636f 6d70 696c 6572 7320  o the compilers 
│ │ │ │ -00029150: 696e 636c 7564 6520 6669 6c65 2073 6561  include file sea
│ │ │ │ -00029160: 7263 680a 7061 7468 2028 7669 6120 7468  rch.path (via th
│ │ │ │ -00029170: 6520 e280 982d 49e2 8099 206f 7074 696f  e ...-I... optio
│ │ │ │ -00029180: 6e29 2e0a 0a20 2020 486f 7765 7665 722c  n)...   However,
│ │ │ │ -00029190: 2074 6865 2070 6174 6820 746f 2074 6865   the path to the
│ │ │ │ -000291a0: 2069 6e63 6c75 6465 2066 696c 6520 6973   include file is
│ │ │ │ -000291b0: 2064 6574 6572 6d69 6e65 6420 6174 2074   determined at t
│ │ │ │ -000291c0: 6865 2074 696d 6520 7468 650a 736f 7572  he time the.sour
│ │ │ │ -000291d0: 6365 2069 7320 636f 6e66 6967 7572 6564  ce is configured
│ │ │ │ -000291e0: 2e20 2054 6f20 736f 6c76 6520 7468 6973  .  To solve this
│ │ │ │ -000291f0: 2070 726f 626c 656d 2c20 274c 6962 7368   problem, 'Libsh
│ │ │ │ -00029200: 6973 6869 2720 7573 6573 2074 6865 0a65  ishi' uses the.e
│ │ │ │ -00029210: 7874 6572 6e61 6c20 7061 636b 6167 6520  xternal package 
│ │ │ │ -00029220: e280 9870 6b67 2d63 6f6e 6669 67e2 8099  ...pkg-config...
│ │ │ │ -00029230: 2074 6861 7420 6b6e 6f77 7320 7468 6520   that knows the 
│ │ │ │ -00029240: 7061 7468 2074 6f20 7468 6520 696e 636c  path to the incl
│ │ │ │ -00029250: 7564 6520 6669 6c65 0a61 6e64 206f 7468  ude file.and oth
│ │ │ │ -00029260: 6572 2063 6f6e 6669 6775 7261 7469 6f6e  er configuration
│ │ │ │ -00029270: 206f 7074 696f 6e73 2e20 2054 6865 206f   options.  The o
│ │ │ │ -00029280: 7074 696f 6e73 2074 6861 7420 6e65 6564  ptions that need
│ │ │ │ -00029290: 2074 6f20 6265 2061 6464 6564 2074 6f0a   to be added to.
│ │ │ │ -000292a0: 7468 6520 636f 6d70 696c 6572 2069 6e76  the compiler inv
│ │ │ │ -000292b0: 6f63 6174 696f 6e20 6174 2063 6f6d 7069  ocation at compi
│ │ │ │ -000292c0: 6c65 2074 696d 6520 6172 6520 6f75 7470  le time are outp
│ │ │ │ -000292d0: 7574 2062 7920 7468 6520 e280 982d 2d63  ut by the ...--c
│ │ │ │ -000292e0: 666c 6167 73e2 8099 0a6f 7074 696f 6e20  flags....option 
│ │ │ │ -000292f0: 746f 20e2 8098 706b 672d 636f 6e66 6967  to ...pkg-config
│ │ │ │ -00029300: 2073 6869 7368 69e2 8099 2e20 2054 6865   shishi....  The
│ │ │ │ -00029310: 2066 6f6c 6c6f 7769 6e67 2065 7861 6d70   following examp
│ │ │ │ -00029320: 6c65 2073 686f 7773 2068 6f77 2069 7420  le shows how it 
│ │ │ │ -00029330: 6361 6e0a 6265 2075 7365 6420 6174 2074  can.be used at t
│ │ │ │ -00029340: 6865 2063 6f6d 6d61 6e64 206c 696e 653a  he command line:
│ │ │ │ -00029350: 0a0a 2020 2020 2067 6363 202d 6320 666f  ..     gcc -c fo
│ │ │ │ -00029360: 6f2e 6320 6070 6b67 2d63 6f6e 6669 6720  o.c `pkg-config 
│ │ │ │ -00029370: 7368 6973 6869 202d 2d63 666c 6167 7360  shishi --cflags`
│ │ │ │ -00029380: 0a0a 2020 2041 6464 696e 6720 7468 6520  ..   Adding the 
│ │ │ │ -00029390: 6f75 7470 7574 206f 6620 e280 9870 6b67  output of ...pkg
│ │ │ │ -000293a0: 2d63 6f6e 6669 6720 7368 6973 6869 202d  -config shishi -
│ │ │ │ -000293b0: 2d63 666c 6167 73e2 8099 2074 6f20 7468  -cflags... to th
│ │ │ │ -000293c0: 6520 636f 6d70 696c 6572 730a 636f 6d6d  e compilers.comm
│ │ │ │ -000293d0: 616e 6420 6c69 6e65 2077 696c 6c20 656e  and line will en
│ │ │ │ -000293e0: 7375 7265 2074 6861 7420 7468 6520 636f  sure that the co
│ │ │ │ -000293f0: 6d70 696c 6572 2063 616e 2066 696e 6420  mpiler can find 
│ │ │ │ -00029400: 7468 6520 274c 6962 7368 6973 6869 270a  the 'Libshishi'.
│ │ │ │ -00029410: 6865 6164 6572 2066 696c 652e 0a0a 2020  header file...  
│ │ │ │ -00029420: 2041 2073 696d 696c 6172 2070 726f 626c   A similar probl
│ │ │ │ -00029430: 656d 206f 6363 7572 7320 7768 656e 206c  em occurs when l
│ │ │ │ -00029440: 696e 6b69 6e67 2074 6865 2070 726f 6772  inking the progr
│ │ │ │ -00029450: 616d 2077 6974 6820 7468 6520 6c69 6272  am with the libr
│ │ │ │ -00029460: 6172 792e 0a41 6761 696e 2c20 7468 6520  ary..Again, the 
│ │ │ │ -00029470: 636f 6d70 696c 6572 2068 6173 2074 6f20  compiler has to 
│ │ │ │ -00029480: 6669 6e64 2074 6865 206c 6962 7261 7279  find the library
│ │ │ │ -00029490: 2066 696c 6573 2e20 2046 6f72 2074 6869   files.  For thi
│ │ │ │ -000294a0: 7320 746f 2077 6f72 6b2c 0a74 6865 2070  s to work,.the p
│ │ │ │ -000294b0: 6174 6820 746f 2074 6865 206c 6962 7261  ath to the libra
│ │ │ │ -000294c0: 7279 2066 696c 6573 2068 6173 2074 6f20  ry files has to 
│ │ │ │ -000294d0: 6265 2061 6464 6564 2074 6f20 7468 6520  be added to the 
│ │ │ │ -000294e0: 6c69 6272 6172 7920 7365 6172 6368 2070  library search p
│ │ │ │ -000294f0: 6174 680a 2876 6961 2074 6865 20e2 8098  ath.(via the ...
│ │ │ │ -00029500: 2d4c e280 9920 6f70 7469 6f6e 292e 2020  -L... option).  
│ │ │ │ -00029510: 466f 7220 7468 6973 2c20 7468 6520 6f70  For this, the op
│ │ │ │ -00029520: 7469 6f6e 20e2 8098 2d2d 6c69 6273 e280  tion ...--libs..
│ │ │ │ -00029530: 9920 746f 20e2 8098 706b 672d 636f 6e66  . to ...pkg-conf
│ │ │ │ -00029540: 6967 0a73 6869 7368 69e2 8099 2063 616e  ig.shishi... can
│ │ │ │ -00029550: 2062 6520 7573 6564 2e20 2046 6f72 2063   be used.  For c
│ │ │ │ -00029560: 6f6e 7665 6e69 656e 6365 2c20 7468 6973  onvenience, this
│ │ │ │ -00029570: 206f 7074 696f 6e20 616c 736f 206f 7574   option also out
│ │ │ │ -00029580: 7075 7473 2061 6c6c 0a6f 7468 6572 206f  puts all.other o
│ │ │ │ -00029590: 7074 696f 6e73 2074 6861 7420 6172 6520  ptions that are 
│ │ │ │ -000295a0: 7265 7175 6972 6564 2074 6f20 6c69 6e6b  required to link
│ │ │ │ -000295b0: 2074 6865 2070 726f 6772 616d 2077 6974   the program wit
│ │ │ │ -000295c0: 6820 7468 6520 274c 6962 7368 6973 6869  h the 'Libshishi
│ │ │ │ -000295d0: 270a 6c69 6261 7261 7269 6573 2028 696e  '.libararies (in
│ │ │ │ -000295e0: 2070 6172 7469 6375 6c61 722c 2074 6865   particular, the
│ │ │ │ -000295f0: 20e2 8098 2d6c 7368 6973 6869 e280 9920   ...-lshishi... 
│ │ │ │ -00029600: 6f70 7469 6f6e 292e 2020 5468 6520 6578  option).  The ex
│ │ │ │ -00029610: 616d 706c 6520 7368 6f77 730a 686f 7720  ample shows.how 
│ │ │ │ -00029620: 746f 206c 696e 6b20 e280 9866 6f6f 2e6f  to link ...foo.o
│ │ │ │ -00029630: e280 9920 7769 7468 2074 6865 2027 4c69  ... with the 'Li
│ │ │ │ -00029640: 6273 6869 7368 6927 206c 6962 7261 7279  bshishi' library
│ │ │ │ -00029650: 2074 6f20 6120 7072 6f67 7261 6d20 e280   to a program ..
│ │ │ │ -00029660: 9866 6f6f e280 992e 0a0a 2020 2020 2067  .foo......     g
│ │ │ │ -00029670: 6363 202d 6f20 666f 6f20 666f 6f2e 6f20  cc -o foo foo.o 
│ │ │ │ -00029680: 6070 6b67 2d63 6f6e 6669 6720 7368 6973  `pkg-config shis
│ │ │ │ -00029690: 6869 202d 2d6c 6962 7360 0a0a 2020 204f  hi --libs`..   O
│ │ │ │ -000296a0: 6620 636f 7572 7365 2079 6f75 2063 616e  f course you can
│ │ │ │ -000296b0: 2061 6c73 6f20 636f 6d62 696e 6520 626f   also combine bo
│ │ │ │ -000296c0: 7468 2065 7861 6d70 6c65 7320 746f 2061  th examples to a
│ │ │ │ -000296d0: 2073 696e 676c 6520 636f 6d6d 616e 6420   single command 
│ │ │ │ -000296e0: 6279 0a73 7065 6369 6679 696e 6720 626f  by.specifying bo
│ │ │ │ -000296f0: 7468 206f 7074 696f 6e73 2074 6f20 e280  th options to ..
│ │ │ │ -00029700: 9870 6b67 2d63 6f6e 6669 67e2 8099 3a0a  .pkg-config...:.
│ │ │ │ -00029710: 0a20 2020 2020 6763 6320 2d6f 2066 6f6f  .     gcc -o foo
│ │ │ │ -00029720: 2066 6f6f 2e63 2060 706b 672d 636f 6e66   foo.c `pkg-conf
│ │ │ │ -00029730: 6967 2073 6869 7368 6920 2d2d 6366 6c61  ig shishi --cfla
│ │ │ │ -00029740: 6773 202d 2d6c 6962 7360 0a0a 1f0a 4669  gs --libs`....Fi
│ │ │ │ -00029750: 6c65 3a20 7368 6973 6869 2e69 6e66 6f2c  le: shishi.info,
│ │ │ │ -00029760: 2020 4e6f 6465 3a20 4175 746f 636f 6e66    Node: Autoconf
│ │ │ │ -00029770: 2074 6573 7473 2c20 2050 7265 763a 2042   tests,  Prev: B
│ │ │ │ -00029780: 7569 6c64 696e 6720 7468 6520 736f 7572  uilding the sour
│ │ │ │ -00029790: 6365 2c20 2055 703a 2050 7265 7061 7261  ce,  Up: Prepara
│ │ │ │ -000297a0: 7469 6f6e 0a0a 352e 312e 3520 4175 746f  tion..5.1.5 Auto
│ │ │ │ -000297b0: 636f 6e66 2074 6573 7473 0a2d 2d2d 2d2d  conf tests.-----
│ │ │ │ -000297c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -000297d0: 0a49 6620 796f 7520 776f 726b 206f 6e20  .If you work on 
│ │ │ │ -000297e0: 6120 7072 6f6a 6563 7420 7468 6174 2075  a project that u
│ │ │ │ -000297f0: 7365 7320 4175 746f 636f 6e66 2028 2a6e  ses Autoconf (*n
│ │ │ │ -00029800: 6f74 6520 474e 5520 4175 746f 636f 6e66  ote GNU Autoconf
│ │ │ │ -00029810: 3a0a 2861 7574 6f63 6f6e 6629 746f 702e  :.(autoconf)top.
│ │ │ │ -00029820: 2920 746f 2068 656c 7020 6669 6e64 2069  ) to help find i
│ │ │ │ -00029830: 6e73 7461 6c6c 6564 206c 6962 7261 7269  nstalled librari
│ │ │ │ -00029840: 6573 2c20 7468 6520 7375 6767 6573 7469  es, the suggesti
│ │ │ │ -00029850: 6f6e 7320 696e 2074 6865 0a70 7265 7669  ons in the.previ
│ │ │ │ -00029860: 6f75 7320 7365 6374 696f 6e20 6172 6520  ous section are 
│ │ │ │ -00029870: 6e6f 7420 7468 6520 656e 7469 7265 2073  not the entire s
│ │ │ │ -00029880: 746f 7279 2e20 2054 6865 7265 2061 7265  tory.  There are
│ │ │ │ -00029890: 2061 2066 6577 206d 6574 686f 6473 2074   a few methods t
│ │ │ │ -000298a0: 6f0a 6465 7465 6374 2061 6e64 2069 6e63  o.detect and inc
│ │ │ │ -000298b0: 6f72 706f 7261 7465 2053 6869 7368 6920  orporate Shishi 
│ │ │ │ -000298c0: 696e 746f 2079 6f75 7220 4175 746f 636f  into your Autoco
│ │ │ │ -000298d0: 6e66 2062 6173 6564 2070 6163 6b61 6765  nf based package
│ │ │ │ -000298e0: 2e20 2054 6865 0a70 7265 6665 7272 6564  .  The.preferred
│ │ │ │ -000298f0: 2061 7070 726f 6163 682c 2069 7320 746f   approach, is to
│ │ │ │ -00029900: 2075 7365 204c 6962 746f 6f6c 2069 6e20   use Libtool in 
│ │ │ │ -00029910: 796f 7572 2070 726f 6a65 6374 2c20 616e  your project, an
│ │ │ │ -00029920: 6420 7573 6520 7468 650a 6e6f 726d 616c  d use the.normal
│ │ │ │ -00029930: 2041 7574 6f63 6f6e 6620 6865 6164 6572   Autoconf header
│ │ │ │ -00029940: 2066 696c 6520 616e 6420 6c69 6272 6172   file and librar
│ │ │ │ -00029950: 7920 7465 7374 732e 0a0a 352e 312e 352e  y tests...5.1.5.
│ │ │ │ -00029960: 3120 4175 746f 636f 6e66 2074 6573 7420  1 Autoconf test 
│ │ │ │ -00029970: 7669 6120 e280 9870 6b67 2d63 6f6e 6669  via ...pkg-confi
│ │ │ │ -00029980: 67e2 8099 0a2e 2e2e 2e2e 2e2e 2e2e 2e2e  g...............
│ │ │ │ +00029040: 2d2d 2d2d 2d2d 2d2d 2d0a 0a49 6620 796f  ---------..If yo
│ │ │ │ +00029050: 7520 7761 6e74 2074 6f20 636f 6d70 696c  u want to compil
│ │ │ │ +00029060: 6520 6120 736f 7572 6365 2066 696c 6520  e a source file 
│ │ │ │ +00029070: 696e 636c 7564 696e 6720 7468 6520 2773  including the 's
│ │ │ │ +00029080: 6869 7368 692e 6827 2068 6561 6465 720a  hishi.h' header.
│ │ │ │ +00029090: 6669 6c65 2c20 796f 7520 6d75 7374 206d  file, you must m
│ │ │ │ +000290a0: 616b 6520 7375 7265 2074 6861 7420 7468  ake sure that th
│ │ │ │ +000290b0: 6520 636f 6d70 696c 6572 2063 616e 2066  e compiler can f
│ │ │ │ +000290c0: 696e 6420 6974 2069 6e20 7468 6520 6469  ind it in the di
│ │ │ │ +000290d0: 7265 6374 6f72 790a 6869 6572 6172 6368  rectory.hierarch
│ │ │ │ +000290e0: 792e 2020 5468 6973 2069 7320 6163 636f  y.  This is acco
│ │ │ │ +000290f0: 6d70 6c69 7368 6564 2062 7920 6164 6469  mplished by addi
│ │ │ │ +00029100: 6e67 2074 6865 2070 6174 6820 746f 2074  ng the path to t
│ │ │ │ +00029110: 6865 2064 6972 6563 746f 7279 2069 6e0a  he directory in.
│ │ │ │ +00029120: 7768 6963 6820 7468 6520 6865 6164 6572  which the header
│ │ │ │ +00029130: 2066 696c 6520 6973 206c 6f63 6174 6564   file is located
│ │ │ │ +00029140: 2074 6f20 7468 6520 636f 6d70 696c 6572   to the compiler
│ │ │ │ +00029150: 7320 696e 636c 7564 6520 6669 6c65 2073  s include file s
│ │ │ │ +00029160: 6561 7263 680a 7061 7468 2028 7669 6120  earch.path (via 
│ │ │ │ +00029170: 7468 6520 e280 982d 49e2 8099 206f 7074  the ...-I... opt
│ │ │ │ +00029180: 696f 6e29 2e0a 0a20 2020 486f 7765 7665  ion)...   Howeve
│ │ │ │ +00029190: 722c 2074 6865 2070 6174 6820 746f 2074  r, the path to t
│ │ │ │ +000291a0: 6865 2069 6e63 6c75 6465 2066 696c 6520  he include file 
│ │ │ │ +000291b0: 6973 2064 6574 6572 6d69 6e65 6420 6174  is determined at
│ │ │ │ +000291c0: 2074 6865 2074 696d 6520 7468 650a 736f   the time the.so
│ │ │ │ +000291d0: 7572 6365 2069 7320 636f 6e66 6967 7572  urce is configur
│ │ │ │ +000291e0: 6564 2e20 2054 6f20 736f 6c76 6520 7468  ed.  To solve th
│ │ │ │ +000291f0: 6973 2070 726f 626c 656d 2c20 274c 6962  is problem, 'Lib
│ │ │ │ +00029200: 7368 6973 6869 2720 7573 6573 2074 6865  shishi' uses the
│ │ │ │ +00029210: 0a65 7874 6572 6e61 6c20 7061 636b 6167  .external packag
│ │ │ │ +00029220: 6520 e280 9870 6b67 2d63 6f6e 6669 67e2  e ...pkg-config.
│ │ │ │ +00029230: 8099 2074 6861 7420 6b6e 6f77 7320 7468  .. that knows th
│ │ │ │ +00029240: 6520 7061 7468 2074 6f20 7468 6520 696e  e path to the in
│ │ │ │ +00029250: 636c 7564 6520 6669 6c65 0a61 6e64 206f  clude file.and o
│ │ │ │ +00029260: 7468 6572 2063 6f6e 6669 6775 7261 7469  ther configurati
│ │ │ │ +00029270: 6f6e 206f 7074 696f 6e73 2e20 2054 6865  on options.  The
│ │ │ │ +00029280: 206f 7074 696f 6e73 2074 6861 7420 6e65   options that ne
│ │ │ │ +00029290: 6564 2074 6f20 6265 2061 6464 6564 2074  ed to be added t
│ │ │ │ +000292a0: 6f0a 7468 6520 636f 6d70 696c 6572 2069  o.the compiler i
│ │ │ │ +000292b0: 6e76 6f63 6174 696f 6e20 6174 2063 6f6d  nvocation at com
│ │ │ │ +000292c0: 7069 6c65 2074 696d 6520 6172 6520 6f75  pile time are ou
│ │ │ │ +000292d0: 7470 7574 2062 7920 7468 6520 e280 982d  tput by the ...-
│ │ │ │ +000292e0: 2d63 666c 6167 73e2 8099 0a6f 7074 696f  -cflags....optio
│ │ │ │ +000292f0: 6e20 746f 20e2 8098 706b 672d 636f 6e66  n to ...pkg-conf
│ │ │ │ +00029300: 6967 2073 6869 7368 69e2 8099 2e20 2054  ig shishi....  T
│ │ │ │ +00029310: 6865 2066 6f6c 6c6f 7769 6e67 2065 7861  he following exa
│ │ │ │ +00029320: 6d70 6c65 2073 686f 7773 2068 6f77 2069  mple shows how i
│ │ │ │ +00029330: 7420 6361 6e0a 6265 2075 7365 6420 6174  t can.be used at
│ │ │ │ +00029340: 2074 6865 2063 6f6d 6d61 6e64 206c 696e   the command lin
│ │ │ │ +00029350: 653a 0a0a 2020 2020 2067 6363 202d 6320  e:..     gcc -c 
│ │ │ │ +00029360: 666f 6f2e 6320 6070 6b67 2d63 6f6e 6669  foo.c `pkg-confi
│ │ │ │ +00029370: 6720 7368 6973 6869 202d 2d63 666c 6167  g shishi --cflag
│ │ │ │ +00029380: 7360 0a0a 2020 2041 6464 696e 6720 7468  s`..   Adding th
│ │ │ │ +00029390: 6520 6f75 7470 7574 206f 6620 e280 9870  e output of ...p
│ │ │ │ +000293a0: 6b67 2d63 6f6e 6669 6720 7368 6973 6869  kg-config shishi
│ │ │ │ +000293b0: 202d 2d63 666c 6167 73e2 8099 2074 6f20   --cflags... to 
│ │ │ │ +000293c0: 7468 6520 636f 6d70 696c 6572 730a 636f  the compilers.co
│ │ │ │ +000293d0: 6d6d 616e 6420 6c69 6e65 2077 696c 6c20  mmand line will 
│ │ │ │ +000293e0: 656e 7375 7265 2074 6861 7420 7468 6520  ensure that the 
│ │ │ │ +000293f0: 636f 6d70 696c 6572 2063 616e 2066 696e  compiler can fin
│ │ │ │ +00029400: 6420 7468 6520 274c 6962 7368 6973 6869  d the 'Libshishi
│ │ │ │ +00029410: 270a 6865 6164 6572 2066 696c 652e 0a0a  '.header file...
│ │ │ │ +00029420: 2020 2041 2073 696d 696c 6172 2070 726f     A similar pro
│ │ │ │ +00029430: 626c 656d 206f 6363 7572 7320 7768 656e  blem occurs when
│ │ │ │ +00029440: 206c 696e 6b69 6e67 2074 6865 2070 726f   linking the pro
│ │ │ │ +00029450: 6772 616d 2077 6974 6820 7468 6520 6c69  gram with the li
│ │ │ │ +00029460: 6272 6172 792e 0a41 6761 696e 2c20 7468  brary..Again, th
│ │ │ │ +00029470: 6520 636f 6d70 696c 6572 2068 6173 2074  e compiler has t
│ │ │ │ +00029480: 6f20 6669 6e64 2074 6865 206c 6962 7261  o find the libra
│ │ │ │ +00029490: 7279 2066 696c 6573 2e20 2046 6f72 2074  ry files.  For t
│ │ │ │ +000294a0: 6869 7320 746f 2077 6f72 6b2c 0a74 6865  his to work,.the
│ │ │ │ +000294b0: 2070 6174 6820 746f 2074 6865 206c 6962   path to the lib
│ │ │ │ +000294c0: 7261 7279 2066 696c 6573 2068 6173 2074  rary files has t
│ │ │ │ +000294d0: 6f20 6265 2061 6464 6564 2074 6f20 7468  o be added to th
│ │ │ │ +000294e0: 6520 6c69 6272 6172 7920 7365 6172 6368  e library search
│ │ │ │ +000294f0: 2070 6174 680a 2876 6961 2074 6865 20e2   path.(via the .
│ │ │ │ +00029500: 8098 2d4c e280 9920 6f70 7469 6f6e 292e  ..-L... option).
│ │ │ │ +00029510: 2020 466f 7220 7468 6973 2c20 7468 6520    For this, the 
│ │ │ │ +00029520: 6f70 7469 6f6e 20e2 8098 2d2d 6c69 6273  option ...--libs
│ │ │ │ +00029530: e280 9920 746f 20e2 8098 706b 672d 636f  ... to ...pkg-co
│ │ │ │ +00029540: 6e66 6967 0a73 6869 7368 69e2 8099 2063  nfig.shishi... c
│ │ │ │ +00029550: 616e 2062 6520 7573 6564 2e20 2046 6f72  an be used.  For
│ │ │ │ +00029560: 2063 6f6e 7665 6e69 656e 6365 2c20 7468   convenience, th
│ │ │ │ +00029570: 6973 206f 7074 696f 6e20 616c 736f 206f  is option also o
│ │ │ │ +00029580: 7574 7075 7473 2061 6c6c 0a6f 7468 6572  utputs all.other
│ │ │ │ +00029590: 206f 7074 696f 6e73 2074 6861 7420 6172   options that ar
│ │ │ │ +000295a0: 6520 7265 7175 6972 6564 2074 6f20 6c69  e required to li
│ │ │ │ +000295b0: 6e6b 2074 6865 2070 726f 6772 616d 2077  nk the program w
│ │ │ │ +000295c0: 6974 6820 7468 6520 274c 6962 7368 6973  ith the 'Libshis
│ │ │ │ +000295d0: 6869 270a 6c69 6261 7261 7269 6573 2028  hi'.libararies (
│ │ │ │ +000295e0: 696e 2070 6172 7469 6375 6c61 722c 2074  in particular, t
│ │ │ │ +000295f0: 6865 20e2 8098 2d6c 7368 6973 6869 e280  he ...-lshishi..
│ │ │ │ +00029600: 9920 6f70 7469 6f6e 292e 2020 5468 6520  . option).  The 
│ │ │ │ +00029610: 6578 616d 706c 6520 7368 6f77 730a 686f  example shows.ho
│ │ │ │ +00029620: 7720 746f 206c 696e 6b20 e280 9866 6f6f  w to link ...foo
│ │ │ │ +00029630: 2e6f e280 9920 7769 7468 2074 6865 2027  .o... with the '
│ │ │ │ +00029640: 4c69 6273 6869 7368 6927 206c 6962 7261  Libshishi' libra
│ │ │ │ +00029650: 7279 2074 6f20 6120 7072 6f67 7261 6d20  ry to a program 
│ │ │ │ +00029660: e280 9866 6f6f e280 992e 0a0a 2020 2020  ...foo......    
│ │ │ │ +00029670: 2067 6363 202d 6f20 666f 6f20 666f 6f2e   gcc -o foo foo.
│ │ │ │ +00029680: 6f20 6070 6b67 2d63 6f6e 6669 6720 7368  o `pkg-config sh
│ │ │ │ +00029690: 6973 6869 202d 2d6c 6962 7360 0a0a 2020  ishi --libs`..  
│ │ │ │ +000296a0: 204f 6620 636f 7572 7365 2079 6f75 2063   Of course you c
│ │ │ │ +000296b0: 616e 2061 6c73 6f20 636f 6d62 696e 6520  an also combine 
│ │ │ │ +000296c0: 626f 7468 2065 7861 6d70 6c65 7320 746f  both examples to
│ │ │ │ +000296d0: 2061 2073 696e 676c 6520 636f 6d6d 616e   a single comman
│ │ │ │ +000296e0: 6420 6279 0a73 7065 6369 6679 696e 6720  d by.specifying 
│ │ │ │ +000296f0: 626f 7468 206f 7074 696f 6e73 2074 6f20  both options to 
│ │ │ │ +00029700: e280 9870 6b67 2d63 6f6e 6669 67e2 8099  ...pkg-config...
│ │ │ │ +00029710: 3a0a 0a20 2020 2020 6763 6320 2d6f 2066  :..     gcc -o f
│ │ │ │ +00029720: 6f6f 2066 6f6f 2e63 2060 706b 672d 636f  oo foo.c `pkg-co
│ │ │ │ +00029730: 6e66 6967 2073 6869 7368 6920 2d2d 6366  nfig shishi --cf
│ │ │ │ +00029740: 6c61 6773 202d 2d6c 6962 7360 0a0a 1f0a  lags --libs`....
│ │ │ │ +00029750: 4669 6c65 3a20 7368 6973 6869 2e69 6e66  File: shishi.inf
│ │ │ │ +00029760: 6f2c 2020 4e6f 6465 3a20 4175 746f 636f  o,  Node: Autoco
│ │ │ │ +00029770: 6e66 2074 6573 7473 2c20 2050 7265 763a  nf tests,  Prev:
│ │ │ │ +00029780: 2042 7569 6c64 696e 6720 7468 6520 736f   Building the so
│ │ │ │ +00029790: 7572 6365 2c20 2055 703a 2050 7265 7061  urce,  Up: Prepa
│ │ │ │ +000297a0: 7261 7469 6f6e 0a0a 352e 312e 3520 4175  ration..5.1.5 Au
│ │ │ │ +000297b0: 746f 636f 6e66 2074 6573 7473 0a2d 2d2d  toconf tests.---
│ │ │ │ +000297c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +000297d0: 2d0a 0a49 6620 796f 7520 776f 726b 206f  -..If you work o
│ │ │ │ +000297e0: 6e20 6120 7072 6f6a 6563 7420 7468 6174  n a project that
│ │ │ │ +000297f0: 2075 7365 7320 4175 746f 636f 6e66 2028   uses Autoconf (
│ │ │ │ +00029800: 2a6e 6f74 6520 474e 5520 4175 746f 636f  *note GNU Autoco
│ │ │ │ +00029810: 6e66 3a0a 2861 7574 6f63 6f6e 6629 746f  nf:.(autoconf)to
│ │ │ │ +00029820: 702e 2920 746f 2068 656c 7020 6669 6e64  p.) to help find
│ │ │ │ +00029830: 2069 6e73 7461 6c6c 6564 206c 6962 7261   installed libra
│ │ │ │ +00029840: 7269 6573 2c20 7468 6520 7375 6767 6573  ries, the sugges
│ │ │ │ +00029850: 7469 6f6e 7320 696e 2074 6865 0a70 7265  tions in the.pre
│ │ │ │ +00029860: 7669 6f75 7320 7365 6374 696f 6e20 6172  vious section ar
│ │ │ │ +00029870: 6520 6e6f 7420 7468 6520 656e 7469 7265  e not the entire
│ │ │ │ +00029880: 2073 746f 7279 2e20 2054 6865 7265 2061   story.  There a
│ │ │ │ +00029890: 7265 2061 2066 6577 206d 6574 686f 6473  re a few methods
│ │ │ │ +000298a0: 2074 6f0a 6465 7465 6374 2061 6e64 2069   to.detect and i
│ │ │ │ +000298b0: 6e63 6f72 706f 7261 7465 2053 6869 7368  ncorporate Shish
│ │ │ │ +000298c0: 6920 696e 746f 2079 6f75 7220 4175 746f  i into your Auto
│ │ │ │ +000298d0: 636f 6e66 2062 6173 6564 2070 6163 6b61  conf based packa
│ │ │ │ +000298e0: 6765 2e20 2054 6865 0a70 7265 6665 7272  ge.  The.preferr
│ │ │ │ +000298f0: 6564 2061 7070 726f 6163 682c 2069 7320  ed approach, is 
│ │ │ │ +00029900: 746f 2075 7365 204c 6962 746f 6f6c 2069  to use Libtool i
│ │ │ │ +00029910: 6e20 796f 7572 2070 726f 6a65 6374 2c20  n your project, 
│ │ │ │ +00029920: 616e 6420 7573 6520 7468 650a 6e6f 726d  and use the.norm
│ │ │ │ +00029930: 616c 2041 7574 6f63 6f6e 6620 6865 6164  al Autoconf head
│ │ │ │ +00029940: 6572 2066 696c 6520 616e 6420 6c69 6272  er file and libr
│ │ │ │ +00029950: 6172 7920 7465 7374 732e 0a0a 352e 312e  ary tests...5.1.
│ │ │ │ +00029960: 352e 3120 4175 746f 636f 6e66 2074 6573  5.1 Autoconf tes
│ │ │ │ +00029970: 7420 7669 6120 e280 9870 6b67 2d63 6f6e  t via ...pkg-con
│ │ │ │ +00029980: 6669 67e2 8099 0a2e 2e2e 2e2e 2e2e 2e2e  fig.............
│ │ │ │  00029990: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e  ................
│ │ │ │ -000299a0: 2e2e 2e2e 2e2e 2e2e 2e2e 2e0a 0a49 6620  .............If 
│ │ │ │ -000299b0: 796f 7572 2061 7564 6965 6e63 6520 6973  your audience is
│ │ │ │ -000299c0: 2061 2074 7970 6963 616c 2047 4e55 2f4c   a typical GNU/L
│ │ │ │ -000299d0: 696e 7578 2064 6573 6b74 6f70 2c20 796f  inux desktop, yo
│ │ │ │ -000299e0: 7520 6361 6e20 6f66 7465 6e20 6173 7375  u can often assu
│ │ │ │ -000299f0: 6d65 0a74 6865 7920 6861 7665 2074 6865  me.they have the
│ │ │ │ -00029a00: 20e2 8098 706b 672d 636f 6e66 6967 e280   ...pkg-config..
│ │ │ │ -00029a10: 9920 746f 6f6c 2069 6e73 7461 6c6c 6564  . tool installed
│ │ │ │ -00029a20: 2c20 696e 2077 6869 6368 2079 6f75 2063  , in which you c
│ │ │ │ -00029a30: 616e 2075 7365 2069 7473 0a41 7574 6f63  an use its.Autoc
│ │ │ │ -00029a40: 6f6e 6620 4d34 206d 6163 726f 2074 6f20  onf M4 macro to 
│ │ │ │ -00029a50: 6669 6e64 2061 6e64 2073 6574 2075 7020  find and set up 
│ │ │ │ -00029a60: 796f 7572 2070 6163 6b61 6765 2066 6f72  your package for
│ │ │ │ -00029a70: 2075 7365 2077 6974 6820 5368 6973 6869   use with Shishi
│ │ │ │ -00029a80: 2e0a 5468 6520 666f 6c6c 6f77 696e 6720  ..The following 
│ │ │ │ -00029a90: 696c 6c75 7374 7261 7465 2074 6869 7320  illustrate this 
│ │ │ │ -00029aa0: 7363 656e 6172 696f 2e0a 0a20 2020 2020  scenario...     
│ │ │ │ -00029ab0: 4143 5f41 5247 5f45 4e41 424c 4528 6b65  AC_ARG_ENABLE(ke
│ │ │ │ -00029ac0: 7262 6572 6f73 5f76 352c 0a20 2020 2020  rberos_v5,.     
│ │ │ │ -00029ad0: 0941 435f 4845 4c50 5f53 5452 494e 4728  .AC_HELP_STRING(
│ │ │ │ -00029ae0: 5b2d 2d64 6973 6162 6c65 2d6b 6572 6265  [--disable-kerbe
│ │ │ │ -00029af0: 726f 735f 7635 5d2c 0a20 2020 2020 2020  ros_v5],.       
│ │ │ │ +000299a0: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e0a 0a49  ...............I
│ │ │ │ +000299b0: 6620 796f 7572 2061 7564 6965 6e63 6520  f your audience 
│ │ │ │ +000299c0: 6973 2061 2074 7970 6963 616c 2047 4e55  is a typical GNU
│ │ │ │ +000299d0: 2f4c 696e 7578 2064 6573 6b74 6f70 2c20  /Linux desktop, 
│ │ │ │ +000299e0: 796f 7520 6361 6e20 6f66 7465 6e20 6173  you can often as
│ │ │ │ +000299f0: 7375 6d65 0a74 6865 7920 6861 7665 2074  sume.they have t
│ │ │ │ +00029a00: 6865 20e2 8098 706b 672d 636f 6e66 6967  he ...pkg-config
│ │ │ │ +00029a10: e280 9920 746f 6f6c 2069 6e73 7461 6c6c  ... tool install
│ │ │ │ +00029a20: 6564 2c20 696e 2077 6869 6368 2079 6f75  ed, in which you
│ │ │ │ +00029a30: 2063 616e 2075 7365 2069 7473 0a41 7574   can use its.Aut
│ │ │ │ +00029a40: 6f63 6f6e 6620 4d34 206d 6163 726f 2074  oconf M4 macro t
│ │ │ │ +00029a50: 6f20 6669 6e64 2061 6e64 2073 6574 2075  o find and set u
│ │ │ │ +00029a60: 7020 796f 7572 2070 6163 6b61 6765 2066  p your package f
│ │ │ │ +00029a70: 6f72 2075 7365 2077 6974 6820 5368 6973  or use with Shis
│ │ │ │ +00029a80: 6869 2e0a 5468 6520 666f 6c6c 6f77 696e  hi..The followin
│ │ │ │ +00029a90: 6720 696c 6c75 7374 7261 7465 2074 6869  g illustrate thi
│ │ │ │ +00029aa0: 7320 7363 656e 6172 696f 2e0a 0a20 2020  s scenario...   
│ │ │ │ +00029ab0: 2020 4143 5f41 5247 5f45 4e41 424c 4528    AC_ARG_ENABLE(
│ │ │ │ +00029ac0: 6b65 7262 6572 6f73 5f76 352c 0a20 2020  kerberos_v5,.   
│ │ │ │ +00029ad0: 2020 0941 435f 4845 4c50 5f53 5452 494e    .AC_HELP_STRIN
│ │ │ │ +00029ae0: 4728 5b2d 2d64 6973 6162 6c65 2d6b 6572  G([--disable-ker
│ │ │ │ +00029af0: 6265 726f 735f 7635 5d2c 0a20 2020 2020  beros_v5],.     
│ │ │ │  00029b00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00029b10: 2020 2020 205b 646f 6e27 7420 7573 6520       [don't use 
│ │ │ │ -00029b20: 7468 6520 4b45 5242 4552 4f53 5f56 3520  the KERBEROS_V5 
│ │ │ │ -00029b30: 6d65 6368 616e 6973 6d5d 292c 0a20 2020  mechanism]),.   
│ │ │ │ -00029b40: 2020 096b 6572 6265 726f 735f 7635 3d24    .kerberos_v5=$
│ │ │ │ -00029b50: 656e 6162 6c65 7661 6c29 0a20 2020 2020  enableval).     
│ │ │ │ -00029b60: 6966 2074 6573 7420 2224 6b65 7262 6572  if test "$kerber
│ │ │ │ -00029b70: 6f73 5f76 3522 2021 3d20 226e 6f22 203b  os_v5" != "no" ;
│ │ │ │ -00029b80: 2074 6865 6e0a 2020 2020 2009 504b 475f   then.     .PKG_
│ │ │ │ -00029b90: 4348 4543 4b5f 4d4f 4455 4c45 5328 5348  CHECK_MODULES(SH
│ │ │ │ -00029ba0: 4953 4849 2c20 7368 6973 6869 203e 3d20  ISHI, shishi >= 
│ │ │ │ -00029bb0: 302e 302e 302c 0a20 2020 2020 0909 095b  0.0.0,.     ...[
│ │ │ │ -00029bc0: 6b65 7262 6572 6f73 5f76 353d 7965 735d  kerberos_v5=yes]
│ │ │ │ -00029bd0: 2c0a 2020 2020 2020 2020 2020 2020 2020  ,.              
│ │ │ │ -00029be0: 2020 2020 2020 2020 2020 2020 2020 205b                 [
│ │ │ │ -00029bf0: 6b65 7262 6572 6f73 5f76 353d 6e6f 5d29  kerberos_v5=no])
│ │ │ │ -00029c00: 0a20 2020 2020 0969 6620 7465 7374 2022  .     .if test "
│ │ │ │ -00029c10: 246b 6572 6265 726f 735f 7635 2220 213d  $kerberos_v5" !=
│ │ │ │ -00029c20: 2022 7965 7322 203b 2074 6865 6e0a 2020   "yes" ; then.  
│ │ │ │ -00029c30: 2020 2009 096b 6572 6265 726f 735f 7635     ..kerberos_v5
│ │ │ │ -00029c40: 3d6e 6f0a 2020 2020 2009 0941 435f 4d53  =no.     ..AC_MS
│ │ │ │ -00029c50: 475f 5741 524e 285b 7368 6973 6869 206e  G_WARN([shishi n
│ │ │ │ -00029c60: 6f74 2066 6f75 6e64 2c20 6469 7361 626c  ot found, disabl
│ │ │ │ -00029c70: 696e 6720 4b65 7262 6572 6f73 2035 5d29  ing Kerberos 5])
│ │ │ │ -00029c80: 0a20 2020 2020 0965 6c73 650a 2020 2020  .     .else.    
│ │ │ │ -00029c90: 2009 096b 6572 6265 726f 735f 7635 3d79   ..kerberos_v5=y
│ │ │ │ -00029ca0: 6573 0a20 2020 2020 0909 4143 5f44 4546  es.     ..AC_DEF
│ │ │ │ -00029cb0: 494e 4528 5553 455f 4b45 5242 4552 4f53  INE(USE_KERBEROS
│ │ │ │ -00029cc0: 5f56 352c 2031 2c0a 2020 2020 2020 2020  _V5, 1,.        
│ │ │ │ +00029b10: 2020 2020 2020 205b 646f 6e27 7420 7573         [don't us
│ │ │ │ +00029b20: 6520 7468 6520 4b45 5242 4552 4f53 5f56  e the KERBEROS_V
│ │ │ │ +00029b30: 3520 6d65 6368 616e 6973 6d5d 292c 0a20  5 mechanism]),. 
│ │ │ │ +00029b40: 2020 2020 096b 6572 6265 726f 735f 7635      .kerberos_v5
│ │ │ │ +00029b50: 3d24 656e 6162 6c65 7661 6c29 0a20 2020  =$enableval).   
│ │ │ │ +00029b60: 2020 6966 2074 6573 7420 2224 6b65 7262    if test "$kerb
│ │ │ │ +00029b70: 6572 6f73 5f76 3522 2021 3d20 226e 6f22  eros_v5" != "no"
│ │ │ │ +00029b80: 203b 2074 6865 6e0a 2020 2020 2009 504b   ; then.     .PK
│ │ │ │ +00029b90: 475f 4348 4543 4b5f 4d4f 4455 4c45 5328  G_CHECK_MODULES(
│ │ │ │ +00029ba0: 5348 4953 4849 2c20 7368 6973 6869 203e  SHISHI, shishi >
│ │ │ │ +00029bb0: 3d20 302e 302e 302c 0a20 2020 2020 0909  = 0.0.0,.     ..
│ │ │ │ +00029bc0: 095b 6b65 7262 6572 6f73 5f76 353d 7965  .[kerberos_v5=ye
│ │ │ │ +00029bd0: 735d 2c0a 2020 2020 2020 2020 2020 2020  s],.            
│ │ │ │ +00029be0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +00029bf0: 205b 6b65 7262 6572 6f73 5f76 353d 6e6f   [kerberos_v5=no
│ │ │ │ +00029c00: 5d29 0a20 2020 2020 0969 6620 7465 7374  ]).     .if test
│ │ │ │ +00029c10: 2022 246b 6572 6265 726f 735f 7635 2220   "$kerberos_v5" 
│ │ │ │ +00029c20: 213d 2022 7965 7322 203b 2074 6865 6e0a  != "yes" ; then.
│ │ │ │ +00029c30: 2020 2020 2009 096b 6572 6265 726f 735f       ..kerberos_
│ │ │ │ +00029c40: 7635 3d6e 6f0a 2020 2020 2009 0941 435f  v5=no.     ..AC_
│ │ │ │ +00029c50: 4d53 475f 5741 524e 285b 7368 6973 6869  MSG_WARN([shishi
│ │ │ │ +00029c60: 206e 6f74 2066 6f75 6e64 2c20 6469 7361   not found, disa
│ │ │ │ +00029c70: 626c 696e 6720 4b65 7262 6572 6f73 2035  bling Kerberos 5
│ │ │ │ +00029c80: 5d29 0a20 2020 2020 0965 6c73 650a 2020  ]).     .else.  
│ │ │ │ +00029c90: 2020 2009 096b 6572 6265 726f 735f 7635     ..kerberos_v5
│ │ │ │ +00029ca0: 3d79 6573 0a20 2020 2020 0909 4143 5f44  =yes.     ..AC_D
│ │ │ │ +00029cb0: 4546 494e 4528 5553 455f 4b45 5242 4552  EFINE(USE_KERBER
│ │ │ │ +00029cc0: 4f53 5f56 352c 2031 2c0a 2020 2020 2020  OS_V5, 1,.      
│ │ │ │  00029cd0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00029ce0: 2020 2020 2020 205b 4465 6669 6e65 2074         [Define t
│ │ │ │ -00029cf0: 6f20 3120 6966 2079 6f75 2077 616e 7420  o 1 if you want 
│ │ │ │ -00029d00: 4b65 7262 6572 6f73 2035 2e5d 290a 2020  Kerberos 5.]).  
│ │ │ │ -00029d10: 2020 2009 6669 0a20 2020 2020 6669 0a20     .fi.     fi. 
│ │ │ │ -00029d20: 2020 2020 4143 5f4d 5347 5f43 4845 434b      AC_MSG_CHECK
│ │ │ │ -00029d30: 494e 4728 5b69 6620 4b65 7262 6572 6f73  ING([if Kerberos
│ │ │ │ -00029d40: 2035 2073 686f 756c 6420 6265 2075 7365   5 should be use
│ │ │ │ -00029d50: 645d 290a 2020 2020 2041 435f 4d53 475f  d]).     AC_MSG_
│ │ │ │ -00029d60: 5245 5355 4c54 2824 6b65 7262 6572 6f73  RESULT($kerberos
│ │ │ │ -00029d70: 5f76 3529 0a0a 352e 312e 352e 3220 5374  _v5)..5.1.5.2 St
│ │ │ │ -00029d80: 616e 6461 6c6f 6e65 2041 7574 6f63 6f6e  andalone Autocon
│ │ │ │ -00029d90: 6620 7465 7374 2075 7369 6e67 204c 6962  f test using Lib
│ │ │ │ -00029da0: 746f 6f6c 0a2e 2e2e 2e2e 2e2e 2e2e 2e2e  tool............
│ │ │ │ +00029ce0: 2020 2020 2020 2020 205b 4465 6669 6e65           [Define
│ │ │ │ +00029cf0: 2074 6f20 3120 6966 2079 6f75 2077 616e   to 1 if you wan
│ │ │ │ +00029d00: 7420 4b65 7262 6572 6f73 2035 2e5d 290a  t Kerberos 5.]).
│ │ │ │ +00029d10: 2020 2020 2009 6669 0a20 2020 2020 6669       .fi.     fi
│ │ │ │ +00029d20: 0a20 2020 2020 4143 5f4d 5347 5f43 4845  .     AC_MSG_CHE
│ │ │ │ +00029d30: 434b 494e 4728 5b69 6620 4b65 7262 6572  CKING([if Kerber
│ │ │ │ +00029d40: 6f73 2035 2073 686f 756c 6420 6265 2075  os 5 should be u
│ │ │ │ +00029d50: 7365 645d 290a 2020 2020 2041 435f 4d53  sed]).     AC_MS
│ │ │ │ +00029d60: 475f 5245 5355 4c54 2824 6b65 7262 6572  G_RESULT($kerber
│ │ │ │ +00029d70: 6f73 5f76 3529 0a0a 352e 312e 352e 3220  os_v5)..5.1.5.2 
│ │ │ │ +00029d80: 5374 616e 6461 6c6f 6e65 2041 7574 6f63  Standalone Autoc
│ │ │ │ +00029d90: 6f6e 6620 7465 7374 2075 7369 6e67 204c  onf test using L
│ │ │ │ +00029da0: 6962 746f 6f6c 0a2e 2e2e 2e2e 2e2e 2e2e  ibtool..........
│ │ │ │  00029db0: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e  ................
│ │ │ │  00029dc0: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e  ................
│ │ │ │ -00029dd0: 2e2e 2e0a 0a49 6620 796f 7572 2070 6163  .....If your pac
│ │ │ │ -00029de0: 6b61 6765 2075 7365 7320 4c69 6274 6f6f  kage uses Libtoo
│ │ │ │ -00029df0: 6c28 2a6e 6f74 6520 474e 5520 4c69 6274  l(*note GNU Libt
│ │ │ │ -00029e00: 6f6f 6c3a 2028 6c69 6274 6f6f 6c29 746f  ool: (libtool)to
│ │ │ │ -00029e10: 702e 292c 2079 6f75 2063 616e 0a75 7365  p.), you can.use
│ │ │ │ -00029e20: 2074 6865 206e 6f72 6d61 6c20 4175 746f   the normal Auto
│ │ │ │ -00029e30: 636f 6e66 2074 6573 7473 2074 6f20 6669  conf tests to fi
│ │ │ │ -00029e40: 6e64 2074 6865 2053 6869 7368 6920 6c69  nd the Shishi li
│ │ │ │ -00029e50: 6272 6172 7920 616e 6420 7265 6c79 206f  brary and rely o
│ │ │ │ -00029e60: 6e20 7468 650a 4c69 6274 6f6f 6c20 6465  n the.Libtool de
│ │ │ │ -00029e70: 7065 6e64 656e 6379 2074 7261 636b 696e  pendency trackin
│ │ │ │ -00029e80: 6720 746f 2069 6e63 6c75 6465 2074 6865  g to include the
│ │ │ │ -00029e90: 2070 726f 7065 7220 6465 7065 6e64 656e   proper dependen
│ │ │ │ -00029ea0: 6379 206c 6962 7261 7269 6573 0a28 652e  cy libraries.(e.
│ │ │ │ -00029eb0: 672e 2c20 4c69 6269 646e 292e 2020 5468  g., Libidn).  Th
│ │ │ │ -00029ec0: 6520 666f 6c6c 6f77 696e 6720 696c 6c75  e following illu
│ │ │ │ -00029ed0: 7374 7261 7465 2074 6869 7320 7363 656e  strate this scen
│ │ │ │ -00029ee0: 6172 696f 2e0a 0a20 2020 2020 4143 5f43  ario...     AC_C
│ │ │ │ -00029ef0: 4845 434b 5f48 4541 4445 5228 7368 6973  HECK_HEADER(shis
│ │ │ │ -00029f00: 6869 2e68 2c0a 2020 2020 2009 4143 5f43  hi.h,.     .AC_C
│ │ │ │ -00029f10: 4845 434b 5f4c 4942 2873 6869 7368 692c  HECK_LIB(shishi,
│ │ │ │ -00029f20: 2073 6869 7368 695f 6368 6563 6b5f 7665   shishi_check_ve
│ │ │ │ -00029f30: 7273 696f 6e2c 0a20 2020 2020 0909 5b6b  rsion,.     ..[k
│ │ │ │ -00029f40: 6572 6265 726f 7335 3d79 6573 2041 435f  erberos5=yes AC_
│ │ │ │ -00029f50: 5355 4253 5428 5348 4953 4849 5f4c 4942  SUBST(SHISHI_LIB
│ │ │ │ -00029f60: 532c 202d 6c73 6869 7368 6929 5d2c 0a20  S, -lshishi)],. 
│ │ │ │ -00029f70: 2020 2020 0909 6b65 7262 6572 6f73 353d      ..kerberos5=
│ │ │ │ -00029f80: 6e6f 292c 0a20 2020 2020 096b 6572 6265  no),.     .kerbe
│ │ │ │ -00029f90: 726f 7335 3d6e 6f29 0a20 2020 2020 4143  ros5=no).     AC
│ │ │ │ -00029fa0: 5f41 5247 5f45 4e41 424c 4528 6b65 7262  _ARG_ENABLE(kerb
│ │ │ │ -00029fb0: 6572 6f73 352c 0a20 2020 2020 0941 435f  eros5,.     .AC_
│ │ │ │ -00029fc0: 4845 4c50 5f53 5452 494e 4728 5b2d 2d64  HELP_STRING([--d
│ │ │ │ -00029fd0: 6973 6162 6c65 2d6b 6572 6265 726f 7335  isable-kerberos5
│ │ │ │ -00029fe0: 5d2c 0a20 2020 2020 2020 2020 2020 2020  ],.             
│ │ │ │ -00029ff0: 2020 2020 2020 2020 2020 2020 2020 205b                 [
│ │ │ │ -0002a000: 6469 7361 626c 6520 4b65 7262 6572 6f73  disable Kerberos
│ │ │ │ -0002a010: 2035 2075 6e63 6f6e 6469 7469 6f6e 616c   5 unconditional
│ │ │ │ -0002a020: 6c79 5d29 2c0a 2020 2020 2009 6b65 7262  ly]),.     .kerb
│ │ │ │ -0002a030: 6572 6f73 353d 2465 6e61 626c 6576 616c  eros5=$enableval
│ │ │ │ -0002a040: 290a 2020 2020 2069 6620 7465 7374 2022  ).     if test "
│ │ │ │ -0002a050: 246b 6572 6265 726f 7335 2220 213d 2022  $kerberos5" != "
│ │ │ │ -0002a060: 6e6f 2220 3b20 7468 656e 0a20 2020 2020  no" ; then.     
│ │ │ │ -0002a070: 0941 435f 4445 4649 4e45 2855 5345 5f4b  .AC_DEFINE(USE_K
│ │ │ │ -0002a080: 4552 4245 524f 535f 5635 2c20 312c 0a20  ERBEROS_V5, 1,. 
│ │ │ │ -0002a090: 2020 2020 0909 2020 5b44 6566 696e 6520      ..  [Define 
│ │ │ │ -0002a0a0: 746f 2031 2069 6620 796f 7520 7761 6e74  to 1 if you want
│ │ │ │ -0002a0b0: 204b 6572 6265 726f 7320 352e 5d29 0a20   Kerberos 5.]). 
│ │ │ │ -0002a0c0: 2020 2020 656c 7365 0a20 2020 2020 0941      else.     .A
│ │ │ │ -0002a0d0: 435f 4d53 475f 5741 524e 285b 5368 6973  C_MSG_WARN([Shis
│ │ │ │ -0002a0e0: 6869 206e 6f74 2066 6f75 6e64 2c20 6469  hi not found, di
│ │ │ │ -0002a0f0: 7361 626c 696e 6720 4b65 7262 6572 6f73  sabling Kerberos
│ │ │ │ -0002a100: 2035 5d29 0a20 2020 2020 6669 0a20 2020   5]).     fi.   
│ │ │ │ -0002a110: 2020 4143 5f4d 5347 5f43 4845 434b 494e    AC_MSG_CHECKIN
│ │ │ │ -0002a120: 4728 5b69 6620 4b65 7262 6572 6f73 2035  G([if Kerberos 5
│ │ │ │ -0002a130: 2073 686f 756c 6420 6265 2075 7365 645d   should be used]
│ │ │ │ -0002a140: 290a 2020 2020 2041 435f 4d53 475f 5245  ).     AC_MSG_RE
│ │ │ │ -0002a150: 5355 4c54 2824 6b65 7262 6572 6f73 3529  SULT($kerberos5)
│ │ │ │ -0002a160: 0a0a 352e 312e 352e 3320 5374 616e 6461  ..5.1.5.3 Standa
│ │ │ │ -0002a170: 6c6f 6e65 2041 7574 6f63 6f6e 6620 7465  lone Autoconf te
│ │ │ │ -0002a180: 7374 0a2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e  st..............
│ │ │ │ +00029dd0: 2e2e 2e2e 2e0a 0a49 6620 796f 7572 2070  .......If your p
│ │ │ │ +00029de0: 6163 6b61 6765 2075 7365 7320 4c69 6274  ackage uses Libt
│ │ │ │ +00029df0: 6f6f 6c28 2a6e 6f74 6520 474e 5520 4c69  ool(*note GNU Li
│ │ │ │ +00029e00: 6274 6f6f 6c3a 2028 6c69 6274 6f6f 6c29  btool: (libtool)
│ │ │ │ +00029e10: 746f 702e 292c 2079 6f75 2063 616e 0a75  top.), you can.u
│ │ │ │ +00029e20: 7365 2074 6865 206e 6f72 6d61 6c20 4175  se the normal Au
│ │ │ │ +00029e30: 746f 636f 6e66 2074 6573 7473 2074 6f20  toconf tests to 
│ │ │ │ +00029e40: 6669 6e64 2074 6865 2053 6869 7368 6920  find the Shishi 
│ │ │ │ +00029e50: 6c69 6272 6172 7920 616e 6420 7265 6c79  library and rely
│ │ │ │ +00029e60: 206f 6e20 7468 650a 4c69 6274 6f6f 6c20   on the.Libtool 
│ │ │ │ +00029e70: 6465 7065 6e64 656e 6379 2074 7261 636b  dependency track
│ │ │ │ +00029e80: 696e 6720 746f 2069 6e63 6c75 6465 2074  ing to include t
│ │ │ │ +00029e90: 6865 2070 726f 7065 7220 6465 7065 6e64  he proper depend
│ │ │ │ +00029ea0: 656e 6379 206c 6962 7261 7269 6573 0a28  ency libraries.(
│ │ │ │ +00029eb0: 652e 672e 2c20 4c69 6269 646e 292e 2020  e.g., Libidn).  
│ │ │ │ +00029ec0: 5468 6520 666f 6c6c 6f77 696e 6720 696c  The following il
│ │ │ │ +00029ed0: 6c75 7374 7261 7465 2074 6869 7320 7363  lustrate this sc
│ │ │ │ +00029ee0: 656e 6172 696f 2e0a 0a20 2020 2020 4143  enario...     AC
│ │ │ │ +00029ef0: 5f43 4845 434b 5f48 4541 4445 5228 7368  _CHECK_HEADER(sh
│ │ │ │ +00029f00: 6973 6869 2e68 2c0a 2020 2020 2009 4143  ishi.h,.     .AC
│ │ │ │ +00029f10: 5f43 4845 434b 5f4c 4942 2873 6869 7368  _CHECK_LIB(shish
│ │ │ │ +00029f20: 692c 2073 6869 7368 695f 6368 6563 6b5f  i, shishi_check_
│ │ │ │ +00029f30: 7665 7273 696f 6e2c 0a20 2020 2020 0909  version,.     ..
│ │ │ │ +00029f40: 5b6b 6572 6265 726f 7335 3d79 6573 2041  [kerberos5=yes A
│ │ │ │ +00029f50: 435f 5355 4253 5428 5348 4953 4849 5f4c  C_SUBST(SHISHI_L
│ │ │ │ +00029f60: 4942 532c 202d 6c73 6869 7368 6929 5d2c  IBS, -lshishi)],
│ │ │ │ +00029f70: 0a20 2020 2020 0909 6b65 7262 6572 6f73  .     ..kerberos
│ │ │ │ +00029f80: 353d 6e6f 292c 0a20 2020 2020 096b 6572  5=no),.     .ker
│ │ │ │ +00029f90: 6265 726f 7335 3d6e 6f29 0a20 2020 2020  beros5=no).     
│ │ │ │ +00029fa0: 4143 5f41 5247 5f45 4e41 424c 4528 6b65  AC_ARG_ENABLE(ke
│ │ │ │ +00029fb0: 7262 6572 6f73 352c 0a20 2020 2020 0941  rberos5,.     .A
│ │ │ │ +00029fc0: 435f 4845 4c50 5f53 5452 494e 4728 5b2d  C_HELP_STRING([-
│ │ │ │ +00029fd0: 2d64 6973 6162 6c65 2d6b 6572 6265 726f  -disable-kerbero
│ │ │ │ +00029fe0: 7335 5d2c 0a20 2020 2020 2020 2020 2020  s5],.           
│ │ │ │ +00029ff0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0002a000: 205b 6469 7361 626c 6520 4b65 7262 6572   [disable Kerber
│ │ │ │ +0002a010: 6f73 2035 2075 6e63 6f6e 6469 7469 6f6e  os 5 uncondition
│ │ │ │ +0002a020: 616c 6c79 5d29 2c0a 2020 2020 2009 6b65  ally]),.     .ke
│ │ │ │ +0002a030: 7262 6572 6f73 353d 2465 6e61 626c 6576  rberos5=$enablev
│ │ │ │ +0002a040: 616c 290a 2020 2020 2069 6620 7465 7374  al).     if test
│ │ │ │ +0002a050: 2022 246b 6572 6265 726f 7335 2220 213d   "$kerberos5" !=
│ │ │ │ +0002a060: 2022 6e6f 2220 3b20 7468 656e 0a20 2020   "no" ; then.   
│ │ │ │ +0002a070: 2020 0941 435f 4445 4649 4e45 2855 5345    .AC_DEFINE(USE
│ │ │ │ +0002a080: 5f4b 4552 4245 524f 535f 5635 2c20 312c  _KERBEROS_V5, 1,
│ │ │ │ +0002a090: 0a20 2020 2020 0909 2020 5b44 6566 696e  .     ..  [Defin
│ │ │ │ +0002a0a0: 6520 746f 2031 2069 6620 796f 7520 7761  e to 1 if you wa
│ │ │ │ +0002a0b0: 6e74 204b 6572 6265 726f 7320 352e 5d29  nt Kerberos 5.])
│ │ │ │ +0002a0c0: 0a20 2020 2020 656c 7365 0a20 2020 2020  .     else.     
│ │ │ │ +0002a0d0: 0941 435f 4d53 475f 5741 524e 285b 5368  .AC_MSG_WARN([Sh
│ │ │ │ +0002a0e0: 6973 6869 206e 6f74 2066 6f75 6e64 2c20  ishi not found, 
│ │ │ │ +0002a0f0: 6469 7361 626c 696e 6720 4b65 7262 6572  disabling Kerber
│ │ │ │ +0002a100: 6f73 2035 5d29 0a20 2020 2020 6669 0a20  os 5]).     fi. 
│ │ │ │ +0002a110: 2020 2020 4143 5f4d 5347 5f43 4845 434b      AC_MSG_CHECK
│ │ │ │ +0002a120: 494e 4728 5b69 6620 4b65 7262 6572 6f73  ING([if Kerberos
│ │ │ │ +0002a130: 2035 2073 686f 756c 6420 6265 2075 7365   5 should be use
│ │ │ │ +0002a140: 645d 290a 2020 2020 2041 435f 4d53 475f  d]).     AC_MSG_
│ │ │ │ +0002a150: 5245 5355 4c54 2824 6b65 7262 6572 6f73  RESULT($kerberos
│ │ │ │ +0002a160: 3529 0a0a 352e 312e 352e 3320 5374 616e  5)..5.1.5.3 Stan
│ │ │ │ +0002a170: 6461 6c6f 6e65 2041 7574 6f63 6f6e 6620  dalone Autoconf 
│ │ │ │ +0002a180: 7465 7374 0a2e 2e2e 2e2e 2e2e 2e2e 2e2e  test............
│ │ │ │  0002a190: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e  ................
│ │ │ │ -0002a1a0: 2e2e 2e0a 0a49 6620 796f 7572 2070 6163  .....If your pac
│ │ │ │ -0002a1b0: 6b61 6765 2064 6f65 7320 6e6f 7420 7573  kage does not us
│ │ │ │ -0002a1c0: 6520 4c69 6274 6f6f 6c2c 2061 7320 7765  e Libtool, as we
│ │ │ │ -0002a1d0: 6c6c 2061 7320 6465 7465 6374 696e 6720  ll as detecting 
│ │ │ │ -0002a1e0: 7468 6520 5368 6973 6869 0a6c 6962 7261  the Shishi.libra
│ │ │ │ -0002a1f0: 7279 2061 7320 696e 2074 6865 2070 7265  ry as in the pre
│ │ │ │ -0002a200: 7669 6f75 7320 6361 7365 2c20 796f 7520  vious case, you 
│ │ │ │ -0002a210: 6d75 7374 2061 6c73 6f20 6465 7465 6374  must also detect
│ │ │ │ -0002a220: 2077 6861 7465 7665 720a 6465 7065 6e64   whatever.depend
│ │ │ │ -0002a230: 656e 6369 6573 2053 6869 7368 6920 7265  encies Shishi re
│ │ │ │ -0002a240: 7175 6972 6573 2074 6f20 776f 726b 2028  quires to work (
│ │ │ │ -0002a250: 652e 672e 2c20 6c69 6269 646e 292e 2020  e.g., libidn).  
│ │ │ │ -0002a260: 5369 6e63 6520 7468 650a 6465 7065 6e64  Since the.depend
│ │ │ │ -0002a270: 656e 6369 6573 2061 7265 2069 6e20 6120  encies are in a 
│ │ │ │ -0002a280: 7374 6174 6520 6f66 2066 6c75 782c 2077  state of flux, w
│ │ │ │ -0002a290: 6520 646f 206e 6f74 2070 726f 7669 6465  e do not provide
│ │ │ │ -0002a2a0: 2061 6e20 6578 616d 706c 6520 616e 6420   an example and 
│ │ │ │ -0002a2b0: 7765 0a64 6f20 6e6f 7420 7265 636f 6d6d  we.do not recomm
│ │ │ │ -0002a2c0: 656e 6420 7468 6973 2061 7070 726f 6163  end this approac
│ │ │ │ -0002a2d0: 682c 2075 6e6c 6573 7320 796f 7520 6172  h, unless you ar
│ │ │ │ -0002a2e0: 6520 6578 7065 7269 656e 6365 6420 6465  e experienced de
│ │ │ │ -0002a2f0: 7665 6c6f 7065 722e 0a0a 1f0a 4669 6c65  veloper.....File
│ │ │ │ -0002a300: 3a20 7368 6973 6869 2e69 6e66 6f2c 2020  : shishi.info,  
│ │ │ │ -0002a310: 4e6f 6465 3a20 496e 6974 6961 6c69 7a61  Node: Initializa
│ │ │ │ -0002a320: 7469 6f6e 2046 756e 6374 696f 6e73 2c20  tion Functions, 
│ │ │ │ -0002a330: 204e 6578 743a 2054 6963 6b65 7420 5365   Next: Ticket Se
│ │ │ │ -0002a340: 7420 4675 6e63 7469 6f6e 732c 2020 5072  t Functions,  Pr
│ │ │ │ -0002a350: 6576 3a20 5072 6570 6172 6174 696f 6e2c  ev: Preparation,
│ │ │ │ -0002a360: 2020 5570 3a20 5072 6f67 7261 6d6d 696e    Up: Programmin
│ │ │ │ -0002a370: 6720 4d61 6e75 616c 0a0a 352e 3220 496e  g Manual..5.2 In
│ │ │ │ -0002a380: 6974 6961 6c69 7a61 7469 6f6e 2046 756e  itialization Fun
│ │ │ │ -0002a390: 6374 696f 6e73 0a3d 3d3d 3d3d 3d3d 3d3d  ctions.=========
│ │ │ │ +0002a1a0: 2e2e 2e2e 2e0a 0a49 6620 796f 7572 2070  .......If your p
│ │ │ │ +0002a1b0: 6163 6b61 6765 2064 6f65 7320 6e6f 7420  ackage does not 
│ │ │ │ +0002a1c0: 7573 6520 4c69 6274 6f6f 6c2c 2061 7320  use Libtool, as 
│ │ │ │ +0002a1d0: 7765 6c6c 2061 7320 6465 7465 6374 696e  well as detectin
│ │ │ │ +0002a1e0: 6720 7468 6520 5368 6973 6869 0a6c 6962  g the Shishi.lib
│ │ │ │ +0002a1f0: 7261 7279 2061 7320 696e 2074 6865 2070  rary as in the p
│ │ │ │ +0002a200: 7265 7669 6f75 7320 6361 7365 2c20 796f  revious case, yo
│ │ │ │ +0002a210: 7520 6d75 7374 2061 6c73 6f20 6465 7465  u must also dete
│ │ │ │ +0002a220: 6374 2077 6861 7465 7665 720a 6465 7065  ct whatever.depe
│ │ │ │ +0002a230: 6e64 656e 6369 6573 2053 6869 7368 6920  ndencies Shishi 
│ │ │ │ +0002a240: 7265 7175 6972 6573 2074 6f20 776f 726b  requires to work
│ │ │ │ +0002a250: 2028 652e 672e 2c20 6c69 6269 646e 292e   (e.g., libidn).
│ │ │ │ +0002a260: 2020 5369 6e63 6520 7468 650a 6465 7065    Since the.depe
│ │ │ │ +0002a270: 6e64 656e 6369 6573 2061 7265 2069 6e20  ndencies are in 
│ │ │ │ +0002a280: 6120 7374 6174 6520 6f66 2066 6c75 782c  a state of flux,
│ │ │ │ +0002a290: 2077 6520 646f 206e 6f74 2070 726f 7669   we do not provi
│ │ │ │ +0002a2a0: 6465 2061 6e20 6578 616d 706c 6520 616e  de an example an
│ │ │ │ +0002a2b0: 6420 7765 0a64 6f20 6e6f 7420 7265 636f  d we.do not reco
│ │ │ │ +0002a2c0: 6d6d 656e 6420 7468 6973 2061 7070 726f  mmend this appro
│ │ │ │ +0002a2d0: 6163 682c 2075 6e6c 6573 7320 796f 7520  ach, unless you 
│ │ │ │ +0002a2e0: 6172 6520 6578 7065 7269 656e 6365 6420  are experienced 
│ │ │ │ +0002a2f0: 6465 7665 6c6f 7065 722e 0a0a 1f0a 4669  developer.....Fi
│ │ │ │ +0002a300: 6c65 3a20 7368 6973 6869 2e69 6e66 6f2c  le: shishi.info,
│ │ │ │ +0002a310: 2020 4e6f 6465 3a20 496e 6974 6961 6c69    Node: Initiali
│ │ │ │ +0002a320: 7a61 7469 6f6e 2046 756e 6374 696f 6e73  zation Functions
│ │ │ │ +0002a330: 2c20 204e 6578 743a 2054 6963 6b65 7420  ,  Next: Ticket 
│ │ │ │ +0002a340: 5365 7420 4675 6e63 7469 6f6e 732c 2020  Set Functions,  
│ │ │ │ +0002a350: 5072 6576 3a20 5072 6570 6172 6174 696f  Prev: Preparatio
│ │ │ │ +0002a360: 6e2c 2020 5570 3a20 5072 6f67 7261 6d6d  n,  Up: Programm
│ │ │ │ +0002a370: 696e 6720 4d61 6e75 616c 0a0a 352e 3220  ing Manual..5.2 
│ │ │ │ +0002a380: 496e 6974 6961 6c69 7a61 7469 6f6e 2046  Initialization F
│ │ │ │ +0002a390: 756e 6374 696f 6e73 0a3d 3d3d 3d3d 3d3d  unctions.=======
│ │ │ │  0002a3a0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ -0002a3b0: 3d3d 3d0a 0a73 6869 7368 690a 2d2d 2d2d  ===..shishi.----
│ │ │ │ -0002a3c0: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ -0002a3d0: 3a20 5368 6973 6869 202a 2073 6869 7368  : Shishi * shish
│ │ │ │ -0002a3e0: 6920 2829 0a0a 2020 2020 202a 4465 7363  i ()..     *Desc
│ │ │ │ -0002a3f0: 7269 7074 696f 6e3a 2a20 496e 6974 6961  ription:* Initia
│ │ │ │ -0002a400: 6c69 7a65 7320 7468 6520 5368 6973 6869  lizes the Shishi
│ │ │ │ -0002a410: 206c 6962 7261 7279 2c20 616e 6420 7072   library, and pr
│ │ │ │ -0002a420: 696d 6573 206c 6f67 6769 6e67 0a20 2020  imes logging.   
│ │ │ │ -0002a430: 2020 736f 2074 6861 7420 6675 7475 7265    so that future
│ │ │ │ -0002a440: 2077 6172 6e69 6e67 7320 616e 6420 696e   warnings and in
│ │ │ │ -0002a450: 666f 726d 6174 696f 6e61 6c20 6d65 7373  formational mess
│ │ │ │ -0002a460: 6167 6573 2061 7265 2070 7269 6e74 6564  ages are printed
│ │ │ │ -0002a470: 206f 6e0a 2020 2020 20e2 8098 7374 6465   on.     ...stde
│ │ │ │ -0002a480: 7272 e280 992e 2020 4966 2074 6869 7320  rr....  If this 
│ │ │ │ -0002a490: 6675 6e63 7469 6f6e 2066 6169 6c73 2c20  function fails, 
│ │ │ │ -0002a4a0: 6974 206d 6179 2073 656e 6420 6974 7320  it may send its 
│ │ │ │ -0002a4b0: 6f77 6e20 6469 6167 6e6f 7374 6963 0a20  own diagnostic. 
│ │ │ │ -0002a4c0: 2020 2020 6572 726f 7273 2074 6f20 e280      errors to ..
│ │ │ │ -0002a4d0: 9873 7464 6572 72e2 8099 2e0a 0a20 2020  .stderr......   
│ │ │ │ -0002a4e0: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ -0002a4f0: 2a20 5265 7475 726e 7320 6120 5368 6973  * Returns a Shis
│ │ │ │ -0002a500: 6869 206c 6962 7261 7279 2068 616e 646c  hi library handl
│ │ │ │ -0002a510: 652c 206f 7220 e280 984e 554c 4ce2 8099  e, or ...NULL...
│ │ │ │ -0002a520: 206f 6e0a 2020 2020 2065 7272 6f72 2e0a   on.     error..
│ │ │ │ -0002a530: 0a73 6869 7368 695f 7365 7276 6572 0a2d  .shishi_server.-
│ │ │ │ -0002a540: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ -0002a550: 2d20 4675 6e63 7469 6f6e 3a20 5368 6973  - Function: Shis
│ │ │ │ -0002a560: 6869 202a 2073 6869 7368 695f 7365 7276  hi * shishi_serv
│ │ │ │ -0002a570: 6572 2028 290a 0a20 2020 2020 2a44 6573  er ()..     *Des
│ │ │ │ -0002a580: 6372 6970 7469 6f6e 3a2a 2049 6e69 7469  cription:* Initi
│ │ │ │ -0002a590: 616c 697a 6573 2074 6865 2053 6869 7368  alizes the Shish
│ │ │ │ -0002a5a0: 6920 6c69 6272 6172 792c 2061 6e64 2070  i library, and p
│ │ │ │ -0002a5b0: 7269 6d65 7320 6c6f 6767 696e 670a 2020  rimes logging.  
│ │ │ │ -0002a5c0: 2020 2073 6f20 7468 6174 2066 7574 7572     so that futur
│ │ │ │ -0002a5d0: 6520 7761 726e 696e 6773 2061 6e64 2069  e warnings and i
│ │ │ │ -0002a5e0: 6e66 6f72 6d61 7469 6f6e 616c 206d 6573  nformational mes
│ │ │ │ -0002a5f0: 7361 6765 7320 6172 6520 7365 6e74 2074  sages are sent t
│ │ │ │ -0002a600: 6f20 7468 650a 2020 2020 2073 7973 6c6f  o the.     syslo
│ │ │ │ -0002a610: 6720 7379 7374 656d 2e20 2049 6620 7468  g system.  If th
│ │ │ │ -0002a620: 6973 2066 756e 6374 696f 6e20 6661 696c  is function fail
│ │ │ │ -0002a630: 732c 2069 7420 6d61 7920 7072 696e 7420  s, it may print 
│ │ │ │ -0002a640: 6469 6167 6e6f 7374 6963 0a20 2020 2020  diagnostic.     
│ │ │ │ -0002a650: 6572 726f 7273 2069 6e20 7468 6520 7379  errors in the sy
│ │ │ │ -0002a660: 736c 6f67 2e0a 0a20 2020 2020 2a52 6574  slog...     *Ret
│ │ │ │ -0002a670: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ -0002a680: 726e 7320 6120 5368 6973 6869 206c 6962  rns a Shishi lib
│ │ │ │ -0002a690: 7261 7279 2068 616e 646c 652c 206f 7220  rary handle, or 
│ │ │ │ -0002a6a0: e280 984e 554c 4ce2 8099 206f 6e0a 2020  ...NULL... on.  
│ │ │ │ -0002a6b0: 2020 2065 7272 6f72 2e0a 0a73 6869 7368     error...shish
│ │ │ │ -0002a6c0: 695f 646f 6e65 0a2d 2d2d 2d2d 2d2d 2d2d  i_done.---------
│ │ │ │ -0002a6d0: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ -0002a6e0: 3a20 766f 6964 2073 6869 7368 695f 646f  : void shishi_do
│ │ │ │ -0002a6f0: 6e65 2028 5368 6973 6869 202a 2048 414e  ne (Shishi * HAN
│ │ │ │ -0002a700: 444c 4529 0a20 2020 2020 4841 4e44 4c45  DLE).     HANDLE
│ │ │ │ -0002a710: 3a20 5368 6973 6869 2068 616e 646c 6520  : Shishi handle 
│ │ │ │ -0002a720: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ -0002a730: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ -0002a740: e280 992e 0a0a 2020 2020 202a 4465 7363  ......     *Desc
│ │ │ │ -0002a750: 7269 7074 696f 6e3a 2a20 4465 616c 6c6f  ription:* Deallo
│ │ │ │ -0002a760: 6361 7465 7320 7468 6520 5368 6973 6869  cates the Shishi
│ │ │ │ -0002a770: 206c 6962 7261 7279 2068 616e 646c 652e   library handle.
│ │ │ │ -0002a780: 2020 5468 6520 6861 6e64 6c65 0a20 2020    The handle.   
│ │ │ │ -0002a790: 2020 6d75 7374 206e 6f74 2062 6520 7573    must not be us
│ │ │ │ -0002a7a0: 6564 2069 6e20 616e 7920 6361 6c6c 2074  ed in any call t
│ │ │ │ -0002a7b0: 6f20 6120 7368 6973 6869 2066 756e 6374  o a shishi funct
│ │ │ │ -0002a7c0: 696f 6e20 6166 7465 7220 616e 0a20 2020  ion after an.   
│ │ │ │ -0002a7d0: 2020 6578 6563 7574 696f 6e20 6f66 20e2    execution of .
│ │ │ │ -0002a7e0: 8098 7368 6973 6869 5f64 6f6e 6528 29e2  ..shishi_done().
│ │ │ │ -0002a7f0: 8099 2e0a 0a20 2020 2020 4966 2074 6865  .....     If the
│ │ │ │ -0002a800: 7265 2069 7320 6120 6465 6661 756c 7420  re is a default 
│ │ │ │ -0002a810: e280 9874 6b74 73e2 8099 2c20 6974 2069  ...tkts..., it i
│ │ │ │ -0002a820: 7320 7772 6974 7465 6e20 746f 2074 6865  s written to the
│ │ │ │ -0002a830: 2064 6566 6175 6c74 2074 6b74 730a 2020   default tkts.  
│ │ │ │ -0002a840: 2020 2066 696c 652e 2020 4966 2079 6f75     file.  If you
│ │ │ │ -0002a850: 2064 6f20 6e6f 7420 7769 7368 2074 6f20   do not wish to 
│ │ │ │ -0002a860: 7772 6974 6520 7468 6520 6465 6661 756c  write the defaul
│ │ │ │ -0002a870: 7420 746b 7473 2066 696c 652c 2063 6c6f  t tkts file, clo
│ │ │ │ -0002a880: 7365 2074 6865 0a20 2020 2020 6465 6661  se the.     defa
│ │ │ │ -0002a890: 756c 7420 6669 6c65 2062 6566 6f72 6520  ult file before 
│ │ │ │ -0002a8a0: 6361 6c6c 696e 6720 7468 6973 2066 756e  calling this fun
│ │ │ │ -0002a8b0: 6374 696f 6e2e 2020 4974 2069 7320 636c  ction.  It is cl
│ │ │ │ -0002a8c0: 6f73 6564 2077 6974 6820 610a 2020 2020  osed with a.    
│ │ │ │ -0002a8d0: 2073 696d 706c 6520 e280 9873 6869 7368   simple ...shish
│ │ │ │ -0002a8e0: 695f 746b 7473 5f64 6f6e 65e2 8099 2848  i_tkts_done...(H
│ │ │ │ -0002a8f0: 414e 444c 452c 20e2 8098 4e55 4c4c e280  ANDLE, ...NULL..
│ │ │ │ -0002a900: 9929 2e20 2046 6f72 2072 656c 6174 6564  .).  For related
│ │ │ │ -0002a910: 0a20 2020 2020 696e 666f 726d 6174 696f  .     informatio
│ │ │ │ -0002a920: 6e2c 2073 6565 20e2 8098 7368 6973 6869  n, see ...shishi
│ │ │ │ -0002a930: 5f74 6b74 735f 6465 6661 756c 745f 6669  _tkts_default_fi
│ │ │ │ -0002a940: 6c65 5f73 6574 2829 e280 992e 0a0a 7368  le_set()......sh
│ │ │ │ -0002a950: 6973 6869 5f69 6e69 740a 2d2d 2d2d 2d2d  ishi_init.------
│ │ │ │ -0002a960: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ -0002a970: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ -0002a980: 696e 6974 2028 5368 6973 6869 202a 2a20  init (Shishi ** 
│ │ │ │ -0002a990: 4841 4e44 4c45 290a 2020 2020 2048 414e  HANDLE).     HAN
│ │ │ │ -0002a9a0: 444c 453a 2050 6f69 6e74 6572 2074 6f20  DLE: Pointer to 
│ │ │ │ -0002a9b0: 6120 5368 6973 6869 2068 616e 646c 6520  a Shishi handle 
│ │ │ │ -0002a9c0: 6372 6561 7465 6420 6279 2074 6869 7320  created by this 
│ │ │ │ -0002a9d0: 6361 6c6c 2e0a 0a20 2020 2020 2a44 6573  call...     *Des
│ │ │ │ -0002a9e0: 6372 6970 7469 6f6e 3a2a 2043 7265 6174  cription:* Creat
│ │ │ │ -0002a9f0: 6573 2061 2053 6869 7368 6920 6c69 6272  es a Shishi libr
│ │ │ │ -0002aa00: 6172 7920 6861 6e64 6c65 2c20 7573 696e  ary handle, usin
│ │ │ │ -0002aa10: 6720 e280 9873 6869 7368 6928 29e2 8099  g ...shishi()...
│ │ │ │ -0002aa20: 2c0a 2020 2020 2061 6e64 2072 6561 6473  ,.     and reads
│ │ │ │ -0002aa30: 2074 6865 2073 7973 7465 6d20 636f 6e66   the system conf
│ │ │ │ -0002aa40: 6967 7572 6174 696f 6e20 6669 6c65 2c20  iguration file, 
│ │ │ │ -0002aa50: 7573 6572 2063 6f6e 6669 6775 7261 7469  user configurati
│ │ │ │ -0002aa60: 6f6e 2066 696c 650a 2020 2020 2061 6e64  on file.     and
│ │ │ │ -0002aa70: 2075 7365 7220 7469 636b 6574 7320 6672   user tickets fr
│ │ │ │ -0002aa80: 6f6d 2074 6865 6972 2064 6566 6175 6c74  om their default
│ │ │ │ -0002aa90: 206c 6f63 6174 696f 6e73 2e20 2054 6865   locations.  The
│ │ │ │ -0002aaa0: 2070 6174 6873 2074 6f20 7468 650a 2020   paths to the.  
│ │ │ │ -0002aab0: 2020 2073 7973 7465 6d20 636f 6e66 6967     system config
│ │ │ │ -0002aac0: 7572 6174 696f 6e20 6669 6c65 2069 7320  uration file is 
│ │ │ │ -0002aad0: 6465 6369 6465 6420 6174 2063 6f6d 7069  decided at compi
│ │ │ │ -0002aae0: 6c65 2074 696d 652c 2061 6e64 2069 730a  le time, and is.
│ │ │ │ -0002aaf0: 2020 2020 20e2 8098 7379 7363 6f6e 6664       ...sysconfd
│ │ │ │ -0002ab00: 6972 e280 992f 7368 6973 6869 2e63 6f6e  ir.../shishi.con
│ │ │ │ -0002ab10: 662e 2020 5468 6520 7573 6572 2063 6f6e  f.  The user con
│ │ │ │ -0002ab20: 6669 6775 7261 7469 6f6e 2066 696c 6520  figuration file 
│ │ │ │ -0002ab30: 6973 0a20 2020 2020 e280 9848 4f4d 45e2  is.     ...HOME.
│ │ │ │ -0002ab40: 8099 2f2e 7368 6973 6869 2f63 6f6e 6669  ../.shishi/confi
│ │ │ │ -0002ab50: 672c 2061 6e64 2074 6865 2075 7365 7220  g, and the user 
│ │ │ │ -0002ab60: 7469 636b 6574 2066 696c 6520 6973 0a20  ticket file is. 
│ │ │ │ -0002ab70: 2020 2020 e280 9848 4f4d 45e2 8099 2f2e      ...HOME.../.
│ │ │ │ -0002ab80: 7368 6973 6869 2f74 6963 6b65 742e 0a0a  shishi/ticket...
│ │ │ │ -0002ab90: 2020 2020 2054 6865 2068 616e 646c 6520       The handle 
│ │ │ │ -0002aba0: 6973 2061 6c6c 6f63 6174 6564 2072 6567  is allocated reg
│ │ │ │ -0002abb0: 6172 646c 6573 7320 6f66 2072 6574 7572  ardless of retur
│ │ │ │ -0002abc0: 6e20 7661 6c75 652e 2020 5468 6520 7369  n value.  The si
│ │ │ │ -0002abd0: 6e67 6c65 0a20 2020 2020 6578 6365 7074  ngle.     except
│ │ │ │ -0002abe0: 696f 6e20 6265 696e 6720 e280 9853 4849  ion being ...SHI
│ │ │ │ -0002abf0: 5348 495f 4841 4e44 4c45 5f45 5252 4f52  SHI_HANDLE_ERROR
│ │ │ │ -0002ac00: e280 992c 2077 6869 6368 2069 6e64 6963  ..., which indic
│ │ │ │ -0002ac10: 6174 6573 2061 2070 726f 626c 656d 2069  ates a problem i
│ │ │ │ -0002ac20: 6e0a 2020 2020 2061 6c6c 6f63 6174 696e  n.     allocatin
│ │ │ │ -0002ac30: 6720 7468 6520 6861 6e64 6c65 2e20 204f  g the handle.  O
│ │ │ │ -0002ac40: 7468 6572 2065 7272 6f72 2063 6f6e 6469  ther error condi
│ │ │ │ -0002ac50: 7469 6f6e 7320 636f 756c 6420 6172 6973  tions could aris
│ │ │ │ -0002ac60: 6520 7768 696c 650a 2020 2020 2072 6561  e while.     rea
│ │ │ │ -0002ac70: 6469 6e67 2066 696c 6573 2e0a 0a20 2020  ding files...   
│ │ │ │ -0002ac80: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ -0002ac90: 2a20 5265 7475 726e 7320 e280 9853 4849  * Returns ...SHI
│ │ │ │ -0002aca0: 5348 495f 4f4b e280 9920 6966 6620 7375  SHI_OK... iff su
│ │ │ │ -0002acb0: 6363 6573 7366 756c 2e0a 0a73 6869 7368  ccessful...shish
│ │ │ │ -0002acc0: 695f 696e 6974 5f77 6974 685f 7061 7468  i_init_with_path
│ │ │ │ -0002acd0: 730a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  s.--------------
│ │ │ │ -0002ace0: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -0002acf0: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ -0002ad00: 6869 5f69 6e69 745f 7769 7468 5f70 6174  hi_init_with_pat
│ │ │ │ -0002ad10: 6873 2028 5368 6973 6869 202a 2a20 4841  hs (Shishi ** HA
│ │ │ │ -0002ad20: 4e44 4c45 2c0a 2020 2020 2020 2020 2020  NDLE,.          
│ │ │ │ -0002ad30: 636f 6e73 7420 6368 6172 202a 2054 4b54  const char * TKT
│ │ │ │ -0002ad40: 5346 494c 452c 2063 6f6e 7374 2063 6861  SFILE, const cha
│ │ │ │ -0002ad50: 7220 2a20 5359 5354 454d 4346 4746 494c  r * SYSTEMCFGFIL
│ │ │ │ -0002ad60: 452c 0a20 2020 2020 2020 2020 2063 6f6e  E,.          con
│ │ │ │ -0002ad70: 7374 2063 6861 7220 2a20 5553 4552 4346  st char * USERCF
│ │ │ │ -0002ad80: 4746 494c 4529 0a20 2020 2020 4841 4e44  GFILE).     HAND
│ │ │ │ -0002ad90: 4c45 3a20 506f 696e 7465 7220 746f 2061  LE: Pointer to a
│ │ │ │ -0002ada0: 2053 6869 7368 6920 6861 6e64 6c65 2063   Shishi handle c
│ │ │ │ -0002adb0: 7265 6174 6564 2062 7920 7468 6973 2063  reated by this c
│ │ │ │ -0002adc0: 616c 6c2e 0a20 2020 2020 544b 5453 4649  all..     TKTSFI
│ │ │ │ -0002add0: 4c45 3a20 4669 6c65 6e61 6d65 206f 6620  LE: Filename of 
│ │ │ │ -0002ade0: 7469 636b 6574 2066 696c 652c 206f 7220  ticket file, or 
│ │ │ │ -0002adf0: e280 984e 554c 4ce2 8099 2e0a 2020 2020  ...NULL.....    
│ │ │ │ -0002ae00: 2053 5953 5445 4d43 4647 4649 4c45 3a20   SYSTEMCFGFILE: 
│ │ │ │ -0002ae10: 4669 6c65 6e61 6d65 206f 6620 7379 7374  Filename of syst
│ │ │ │ -0002ae20: 656d 2063 6f6e 6669 6775 7261 7469 6f6e  em configuration
│ │ │ │ -0002ae30: 2c20 6f72 20e2 8098 4e55 4c4c e280 992e  , or ...NULL....
│ │ │ │ -0002ae40: 0a20 2020 2020 5553 4552 4346 4746 494c  .     USERCFGFIL
│ │ │ │ -0002ae50: 453a 2046 696c 656e 616d 6520 6f66 2075  E: Filename of u
│ │ │ │ -0002ae60: 7365 7220 636f 6e66 6967 7572 6174 696f  ser configuratio
│ │ │ │ -0002ae70: 6e2c 206f 7220 e280 984e 554c 4ce2 8099  n, or ...NULL...
│ │ │ │ -0002ae80: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ -0002ae90: 7469 6f6e 3a2a 2043 7265 6174 6573 2061  tion:* Creates a
│ │ │ │ -0002aea0: 2053 6869 7368 6920 6c69 6272 6172 7920   Shishi library 
│ │ │ │ -0002aeb0: 6861 6e64 6c65 2c20 7573 696e 6720 e280  handle, using ..
│ │ │ │ -0002aec0: 9873 6869 7368 6928 29e2 8099 2c0a 2020  .shishi()...,.  
│ │ │ │ -0002aed0: 2020 2061 6e64 2072 6561 6473 2074 6865     and reads the
│ │ │ │ -0002aee0: 2073 7973 7465 6d20 636f 6e66 6967 7572   system configur
│ │ │ │ -0002aef0: 6174 696f 6e20 6669 6c65 2c20 7573 6572  ation file, user
│ │ │ │ -0002af00: 2063 6f6e 6669 6775 7261 7469 6f6e 2066   configuration f
│ │ │ │ -0002af10: 696c 652c 0a20 2020 2020 616e 6420 7573  ile,.     and us
│ │ │ │ -0002af20: 6572 2074 6963 6b65 7473 2061 7420 7468  er tickets at th
│ │ │ │ -0002af30: 6520 7370 6563 6966 6965 6420 6c6f 6361  e specified loca
│ │ │ │ -0002af40: 7469 6f6e 732e 2020 4966 2061 6e79 206f  tions.  If any o
│ │ │ │ -0002af50: 6620 5553 4552 4346 4746 494c 450a 2020  f USERCFGFILE.  
│ │ │ │ -0002af60: 2020 206f 7220 5359 5354 454d 4346 4746     or SYSTEMCFGF
│ │ │ │ -0002af70: 494c 4520 6973 20e2 8098 4e55 4c4c e280  ILE is ...NULL..
│ │ │ │ -0002af80: 992c 2074 6865 2066 696c 6520 6973 2072  ., the file is r
│ │ │ │ -0002af90: 6561 6420 6672 6f6d 2069 7473 2064 6566  ead from its def
│ │ │ │ -0002afa0: 6175 6c74 0a20 2020 2020 6c6f 6361 7469  ault.     locati
│ │ │ │ -0002afb0: 6f6e 2c20 7768 6963 6820 666f 7220 7468  on, which for th
│ │ │ │ -0002afc0: 6520 7379 7374 656d 2063 6f6e 6669 6775  e system configu
│ │ │ │ -0002afd0: 7261 7469 6f6e 2069 7320 6465 6369 6465  ration is decide
│ │ │ │ -0002afe0: 6420 6174 2063 6f6d 7069 6c65 0a20 2020  d at compile.   
│ │ │ │ -0002aff0: 2020 7469 6d65 2c20 616e 6420 6973 20e2    time, and is .
│ │ │ │ -0002b000: 8098 7379 7363 6f6e 6664 6972 e280 992f  ..sysconfdir.../
│ │ │ │ -0002b010: 7368 6973 6869 2e63 6f6e 662c 2061 6e64  shishi.conf, and
│ │ │ │ -0002b020: 2066 6f72 2074 6865 2075 7365 720a 2020   for the user.  
│ │ │ │ -0002b030: 2020 2063 6f6e 6669 6775 7261 7469 6f6e     configuration
│ │ │ │ -0002b040: 2069 7420 6973 20e2 8098 484f 4d45 e280   it is ...HOME..
│ │ │ │ -0002b050: 992f 2e73 6869 7368 692f 636f 6e66 6967  ./.shishi/config
│ │ │ │ -0002b060: 2e20 2049 6620 7468 6520 7469 636b 6574  .  If the ticket
│ │ │ │ -0002b070: 2066 696c 6520 6e61 6d65 0a20 2020 2020   file name.     
│ │ │ │ -0002b080: 6973 20e2 8098 4e55 4c4c e280 992c 2061  is ...NULL..., a
│ │ │ │ -0002b090: 2074 6963 6b65 7420 6669 6c65 2069 7320   ticket file is 
│ │ │ │ -0002b0a0: 6e6f 7420 7265 6164 2061 7420 616c 6c2e  not read at all.
│ │ │ │ -0002b0b0: 0a0a 2020 2020 2054 6865 2068 616e 646c  ..     The handl
│ │ │ │ -0002b0c0: 6520 6973 2061 6c6c 6f63 6174 6564 2072  e is allocated r
│ │ │ │ -0002b0d0: 6567 6172 646c 6573 7320 6f66 2072 6574  egardless of ret
│ │ │ │ -0002b0e0: 7572 6e20 7661 6c75 652e 2020 5468 6520  urn value.  The 
│ │ │ │ -0002b0f0: 7369 6e67 6c65 0a20 2020 2020 6578 6365  single.     exce
│ │ │ │ -0002b100: 7074 696f 6e20 6265 696e 6720 e280 9853  ption being ...S
│ │ │ │ -0002b110: 4849 5348 495f 4841 4e44 4c45 5f45 5252  HISHI_HANDLE_ERR
│ │ │ │ -0002b120: 4f52 e280 992c 2077 6869 6368 2069 6e64  OR..., which ind
│ │ │ │ -0002b130: 6963 6174 6573 2061 2070 726f 626c 656d  icates a problem
│ │ │ │ -0002b140: 2069 6e0a 2020 2020 2061 6c6c 6f63 6174   in.     allocat
│ │ │ │ -0002b150: 696e 6720 7468 6520 6861 6e64 6c65 2e20  ing the handle. 
│ │ │ │ -0002b160: 204f 7468 6572 2065 7272 6f72 2063 6f6e   Other error con
│ │ │ │ -0002b170: 6469 7469 6f6e 7320 636f 756c 6420 6172  ditions could ar
│ │ │ │ -0002b180: 6973 6520 7768 696c 650a 2020 2020 2072  ise while.     r
│ │ │ │ -0002b190: 6561 6469 6e67 2066 696c 6573 2e0a 0a20  eading files... 
│ │ │ │ -0002b1a0: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ -0002b1b0: 653a 2a20 5265 7475 726e 7320 e280 9853  e:* Returns ...S
│ │ │ │ -0002b1c0: 4849 5348 495f 4f4b e280 9920 6966 6620  HISHI_OK... iff 
│ │ │ │ -0002b1d0: 7375 6363 6573 7366 756c 2e0a 0a73 6869  successful...shi
│ │ │ │ -0002b1e0: 7368 695f 696e 6974 5f73 6572 7665 720a  shi_init_server.
│ │ │ │ -0002b1f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0002b200: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ -0002b210: 3a20 696e 7420 7368 6973 6869 5f69 6e69  : int shishi_ini
│ │ │ │ -0002b220: 745f 7365 7276 6572 2028 5368 6973 6869  t_server (Shishi
│ │ │ │ -0002b230: 202a 2a20 4841 4e44 4c45 290a 2020 2020   ** HANDLE).    
│ │ │ │ -0002b240: 2048 414e 444c 453a 2050 6f69 6e74 6572   HANDLE: Pointer
│ │ │ │ -0002b250: 2074 6f20 6120 5368 6973 6869 2068 616e   to a Shishi han
│ │ │ │ -0002b260: 646c 6520 6372 6561 7465 6420 6279 2074  dle created by t
│ │ │ │ -0002b270: 6869 7320 6361 6c6c 2e0a 0a20 2020 2020  his call...     
│ │ │ │ -0002b280: 2a44 6573 6372 6970 7469 6f6e 3a2a 2043  *Description:* C
│ │ │ │ -0002b290: 7265 6174 6573 2061 2053 6869 7368 6920  reates a Shishi 
│ │ │ │ -0002b2a0: 6c69 6272 6172 7920 6861 6e64 6c65 2c20  library handle, 
│ │ │ │ -0002b2b0: 7573 696e 670a 2020 2020 20e2 8098 7368  using.     ...sh
│ │ │ │ -0002b2c0: 6973 6869 5f73 6572 7665 7228 29e2 8099  ishi_server()...
│ │ │ │ -0002b2d0: 2c20 616e 6420 7265 6164 7320 7468 6520  , and reads the 
│ │ │ │ -0002b2e0: 7379 7374 656d 2063 6f6e 6669 6775 7261  system configura
│ │ │ │ -0002b2f0: 7469 6f6e 2066 696c 652e 2020 5468 650a  tion file.  The.
│ │ │ │ -0002b300: 2020 2020 2070 6174 6820 746f 2074 6865       path to the
│ │ │ │ -0002b310: 2073 7973 7465 6d20 636f 6e66 6967 7572   system configur
│ │ │ │ -0002b320: 6174 696f 6e20 6669 6c65 2069 7320 6465  ation file is de
│ │ │ │ -0002b330: 6369 6465 6420 6174 2063 6f6d 7069 6c65  cided at compile
│ │ │ │ -0002b340: 2074 696d 652c 0a20 2020 2020 616e 6420   time,.     and 
│ │ │ │ -0002b350: 6973 20e2 8098 7379 7363 6f6e 6664 6972  is ...sysconfdir
│ │ │ │ -0002b360: e280 992f 7368 6973 6869 2e63 6f6e 662e  .../shishi.conf.
│ │ │ │ -0002b370: 0a0a 2020 2020 2054 6865 2068 616e 646c  ..     The handl
│ │ │ │ -0002b380: 6520 6973 2061 6c6c 6f63 6174 6564 2072  e is allocated r
│ │ │ │ -0002b390: 6567 6172 646c 6573 7320 6f66 2072 6574  egardless of ret
│ │ │ │ -0002b3a0: 7572 6e20 7661 6c75 652e 2020 5468 6520  urn value.  The 
│ │ │ │ -0002b3b0: 7369 6e67 6c65 0a20 2020 2020 6578 6365  single.     exce
│ │ │ │ -0002b3c0: 7074 696f 6e20 6265 696e 6720 e280 9853  ption being ...S
│ │ │ │ -0002b3d0: 4849 5348 495f 4841 4e44 4c45 5f45 5252  HISHI_HANDLE_ERR
│ │ │ │ -0002b3e0: 4f52 e280 992c 2077 6869 6368 2069 6e64  OR..., which ind
│ │ │ │ -0002b3f0: 6963 6174 6573 2061 2070 726f 626c 656d  icates a problem
│ │ │ │ -0002b400: 2069 6e0a 2020 2020 2061 6c6c 6f63 6174   in.     allocat
│ │ │ │ -0002b410: 696e 6720 7468 6520 6861 6e64 6c65 2e20  ing the handle. 
│ │ │ │ -0002b420: 204f 7468 6572 2065 7272 6f72 2063 6f6e   Other error con
│ │ │ │ -0002b430: 6469 7469 6f6e 7320 636f 756c 6420 6172  ditions could ar
│ │ │ │ -0002b440: 6973 6520 7768 696c 650a 2020 2020 2072  ise while.     r
│ │ │ │ -0002b450: 6561 6469 6e67 2074 6865 2066 696c 652e  eading the file.
│ │ │ │ -0002b460: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ -0002b470: 616c 7565 3a2a 2052 6574 7572 6e73 20e2  alue:* Returns .
│ │ │ │ -0002b480: 8098 5348 4953 4849 5f4f 4be2 8099 2069  ..SHISHI_OK... i
│ │ │ │ -0002b490: 6666 2073 7563 6365 7373 6675 6c2e 0a0a  ff successful...
│ │ │ │ -0002b4a0: 7368 6973 6869 5f69 6e69 745f 7365 7276  shishi_init_serv
│ │ │ │ -0002b4b0: 6572 5f77 6974 685f 7061 7468 730a 2d2d  er_with_paths.--
│ │ │ │ +0002a3b0: 3d3d 3d3d 3d0a 0a73 6869 7368 690a 2d2d  =====..shishi.--
│ │ │ │ +0002a3c0: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ +0002a3d0: 6f6e 3a20 5368 6973 6869 202a 2073 6869  on: Shishi * shi
│ │ │ │ +0002a3e0: 7368 6920 2829 0a0a 2020 2020 202a 4465  shi ()..     *De
│ │ │ │ +0002a3f0: 7363 7269 7074 696f 6e3a 2a20 496e 6974  scription:* Init
│ │ │ │ +0002a400: 6961 6c69 7a65 7320 7468 6520 5368 6973  ializes the Shis
│ │ │ │ +0002a410: 6869 206c 6962 7261 7279 2c20 616e 6420  hi library, and 
│ │ │ │ +0002a420: 7072 696d 6573 206c 6f67 6769 6e67 0a20  primes logging. 
│ │ │ │ +0002a430: 2020 2020 736f 2074 6861 7420 6675 7475      so that futu
│ │ │ │ +0002a440: 7265 2077 6172 6e69 6e67 7320 616e 6420  re warnings and 
│ │ │ │ +0002a450: 696e 666f 726d 6174 696f 6e61 6c20 6d65  informational me
│ │ │ │ +0002a460: 7373 6167 6573 2061 7265 2070 7269 6e74  ssages are print
│ │ │ │ +0002a470: 6564 206f 6e0a 2020 2020 20e2 8098 7374  ed on.     ...st
│ │ │ │ +0002a480: 6465 7272 e280 992e 2020 4966 2074 6869  derr....  If thi
│ │ │ │ +0002a490: 7320 6675 6e63 7469 6f6e 2066 6169 6c73  s function fails
│ │ │ │ +0002a4a0: 2c20 6974 206d 6179 2073 656e 6420 6974  , it may send it
│ │ │ │ +0002a4b0: 7320 6f77 6e20 6469 6167 6e6f 7374 6963  s own diagnostic
│ │ │ │ +0002a4c0: 0a20 2020 2020 6572 726f 7273 2074 6f20  .     errors to 
│ │ │ │ +0002a4d0: e280 9873 7464 6572 72e2 8099 2e0a 0a20  ...stderr...... 
│ │ │ │ +0002a4e0: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ +0002a4f0: 653a 2a20 5265 7475 726e 7320 6120 5368  e:* Returns a Sh
│ │ │ │ +0002a500: 6973 6869 206c 6962 7261 7279 2068 616e  ishi library han
│ │ │ │ +0002a510: 646c 652c 206f 7220 e280 984e 554c 4ce2  dle, or ...NULL.
│ │ │ │ +0002a520: 8099 206f 6e0a 2020 2020 2065 7272 6f72  .. on.     error
│ │ │ │ +0002a530: 2e0a 0a73 6869 7368 695f 7365 7276 6572  ...shishi_server
│ │ │ │ +0002a540: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  .-------------..
│ │ │ │ +0002a550: 202d 2d20 4675 6e63 7469 6f6e 3a20 5368   -- Function: Sh
│ │ │ │ +0002a560: 6973 6869 202a 2073 6869 7368 695f 7365  ishi * shishi_se
│ │ │ │ +0002a570: 7276 6572 2028 290a 0a20 2020 2020 2a44  rver ()..     *D
│ │ │ │ +0002a580: 6573 6372 6970 7469 6f6e 3a2a 2049 6e69  escription:* Ini
│ │ │ │ +0002a590: 7469 616c 697a 6573 2074 6865 2053 6869  tializes the Shi
│ │ │ │ +0002a5a0: 7368 6920 6c69 6272 6172 792c 2061 6e64  shi library, and
│ │ │ │ +0002a5b0: 2070 7269 6d65 7320 6c6f 6767 696e 670a   primes logging.
│ │ │ │ +0002a5c0: 2020 2020 2073 6f20 7468 6174 2066 7574       so that fut
│ │ │ │ +0002a5d0: 7572 6520 7761 726e 696e 6773 2061 6e64  ure warnings and
│ │ │ │ +0002a5e0: 2069 6e66 6f72 6d61 7469 6f6e 616c 206d   informational m
│ │ │ │ +0002a5f0: 6573 7361 6765 7320 6172 6520 7365 6e74  essages are sent
│ │ │ │ +0002a600: 2074 6f20 7468 650a 2020 2020 2073 7973   to the.     sys
│ │ │ │ +0002a610: 6c6f 6720 7379 7374 656d 2e20 2049 6620  log system.  If 
│ │ │ │ +0002a620: 7468 6973 2066 756e 6374 696f 6e20 6661  this function fa
│ │ │ │ +0002a630: 696c 732c 2069 7420 6d61 7920 7072 696e  ils, it may prin
│ │ │ │ +0002a640: 7420 6469 6167 6e6f 7374 6963 0a20 2020  t diagnostic.   
│ │ │ │ +0002a650: 2020 6572 726f 7273 2069 6e20 7468 6520    errors in the 
│ │ │ │ +0002a660: 7379 736c 6f67 2e0a 0a20 2020 2020 2a52  syslog...     *R
│ │ │ │ +0002a670: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +0002a680: 7475 726e 7320 6120 5368 6973 6869 206c  turns a Shishi l
│ │ │ │ +0002a690: 6962 7261 7279 2068 616e 646c 652c 206f  ibrary handle, o
│ │ │ │ +0002a6a0: 7220 e280 984e 554c 4ce2 8099 206f 6e0a  r ...NULL... on.
│ │ │ │ +0002a6b0: 2020 2020 2065 7272 6f72 2e0a 0a73 6869       error...shi
│ │ │ │ +0002a6c0: 7368 695f 646f 6e65 0a2d 2d2d 2d2d 2d2d  shi_done.-------
│ │ │ │ +0002a6d0: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ +0002a6e0: 6f6e 3a20 766f 6964 2073 6869 7368 695f  on: void shishi_
│ │ │ │ +0002a6f0: 646f 6e65 2028 5368 6973 6869 202a 2048  done (Shishi * H
│ │ │ │ +0002a700: 414e 444c 4529 0a20 2020 2020 4841 4e44  ANDLE).     HAND
│ │ │ │ +0002a710: 4c45 3a20 5368 6973 6869 2068 616e 646c  LE: Shishi handl
│ │ │ │ +0002a720: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ +0002a730: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ +0002a740: 2829 e280 992e 0a0a 2020 2020 202a 4465  ()......     *De
│ │ │ │ +0002a750: 7363 7269 7074 696f 6e3a 2a20 4465 616c  scription:* Deal
│ │ │ │ +0002a760: 6c6f 6361 7465 7320 7468 6520 5368 6973  locates the Shis
│ │ │ │ +0002a770: 6869 206c 6962 7261 7279 2068 616e 646c  hi library handl
│ │ │ │ +0002a780: 652e 2020 5468 6520 6861 6e64 6c65 0a20  e.  The handle. 
│ │ │ │ +0002a790: 2020 2020 6d75 7374 206e 6f74 2062 6520      must not be 
│ │ │ │ +0002a7a0: 7573 6564 2069 6e20 616e 7920 6361 6c6c  used in any call
│ │ │ │ +0002a7b0: 2074 6f20 6120 7368 6973 6869 2066 756e   to a shishi fun
│ │ │ │ +0002a7c0: 6374 696f 6e20 6166 7465 7220 616e 0a20  ction after an. 
│ │ │ │ +0002a7d0: 2020 2020 6578 6563 7574 696f 6e20 6f66      execution of
│ │ │ │ +0002a7e0: 20e2 8098 7368 6973 6869 5f64 6f6e 6528   ...shishi_done(
│ │ │ │ +0002a7f0: 29e2 8099 2e0a 0a20 2020 2020 4966 2074  )......     If t
│ │ │ │ +0002a800: 6865 7265 2069 7320 6120 6465 6661 756c  here is a defaul
│ │ │ │ +0002a810: 7420 e280 9874 6b74 73e2 8099 2c20 6974  t ...tkts..., it
│ │ │ │ +0002a820: 2069 7320 7772 6974 7465 6e20 746f 2074   is written to t
│ │ │ │ +0002a830: 6865 2064 6566 6175 6c74 2074 6b74 730a  he default tkts.
│ │ │ │ +0002a840: 2020 2020 2066 696c 652e 2020 4966 2079       file.  If y
│ │ │ │ +0002a850: 6f75 2064 6f20 6e6f 7420 7769 7368 2074  ou do not wish t
│ │ │ │ +0002a860: 6f20 7772 6974 6520 7468 6520 6465 6661  o write the defa
│ │ │ │ +0002a870: 756c 7420 746b 7473 2066 696c 652c 2063  ult tkts file, c
│ │ │ │ +0002a880: 6c6f 7365 2074 6865 0a20 2020 2020 6465  lose the.     de
│ │ │ │ +0002a890: 6661 756c 7420 6669 6c65 2062 6566 6f72  fault file befor
│ │ │ │ +0002a8a0: 6520 6361 6c6c 696e 6720 7468 6973 2066  e calling this f
│ │ │ │ +0002a8b0: 756e 6374 696f 6e2e 2020 4974 2069 7320  unction.  It is 
│ │ │ │ +0002a8c0: 636c 6f73 6564 2077 6974 6820 610a 2020  closed with a.  
│ │ │ │ +0002a8d0: 2020 2073 696d 706c 6520 e280 9873 6869     simple ...shi
│ │ │ │ +0002a8e0: 7368 695f 746b 7473 5f64 6f6e 65e2 8099  shi_tkts_done...
│ │ │ │ +0002a8f0: 2848 414e 444c 452c 20e2 8098 4e55 4c4c  (HANDLE, ...NULL
│ │ │ │ +0002a900: e280 9929 2e20 2046 6f72 2072 656c 6174  ...).  For relat
│ │ │ │ +0002a910: 6564 0a20 2020 2020 696e 666f 726d 6174  ed.     informat
│ │ │ │ +0002a920: 696f 6e2c 2073 6565 20e2 8098 7368 6973  ion, see ...shis
│ │ │ │ +0002a930: 6869 5f74 6b74 735f 6465 6661 756c 745f  hi_tkts_default_
│ │ │ │ +0002a940: 6669 6c65 5f73 6574 2829 e280 992e 0a0a  file_set()......
│ │ │ │ +0002a950: 7368 6973 6869 5f69 6e69 740a 2d2d 2d2d  shishi_init.----
│ │ │ │ +0002a960: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +0002a970: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ +0002a980: 695f 696e 6974 2028 5368 6973 6869 202a  i_init (Shishi *
│ │ │ │ +0002a990: 2a20 4841 4e44 4c45 290a 2020 2020 2048  * HANDLE).     H
│ │ │ │ +0002a9a0: 414e 444c 453a 2050 6f69 6e74 6572 2074  ANDLE: Pointer t
│ │ │ │ +0002a9b0: 6f20 6120 5368 6973 6869 2068 616e 646c  o a Shishi handl
│ │ │ │ +0002a9c0: 6520 6372 6561 7465 6420 6279 2074 6869  e created by thi
│ │ │ │ +0002a9d0: 7320 6361 6c6c 2e0a 0a20 2020 2020 2a44  s call...     *D
│ │ │ │ +0002a9e0: 6573 6372 6970 7469 6f6e 3a2a 2043 7265  escription:* Cre
│ │ │ │ +0002a9f0: 6174 6573 2061 2053 6869 7368 6920 6c69  ates a Shishi li
│ │ │ │ +0002aa00: 6272 6172 7920 6861 6e64 6c65 2c20 7573  brary handle, us
│ │ │ │ +0002aa10: 696e 6720 e280 9873 6869 7368 6928 29e2  ing ...shishi().
│ │ │ │ +0002aa20: 8099 2c0a 2020 2020 2061 6e64 2072 6561  ..,.     and rea
│ │ │ │ +0002aa30: 6473 2074 6865 2073 7973 7465 6d20 636f  ds the system co
│ │ │ │ +0002aa40: 6e66 6967 7572 6174 696f 6e20 6669 6c65  nfiguration file
│ │ │ │ +0002aa50: 2c20 7573 6572 2063 6f6e 6669 6775 7261  , user configura
│ │ │ │ +0002aa60: 7469 6f6e 2066 696c 650a 2020 2020 2061  tion file.     a
│ │ │ │ +0002aa70: 6e64 2075 7365 7220 7469 636b 6574 7320  nd user tickets 
│ │ │ │ +0002aa80: 6672 6f6d 2074 6865 6972 2064 6566 6175  from their defau
│ │ │ │ +0002aa90: 6c74 206c 6f63 6174 696f 6e73 2e20 2054  lt locations.  T
│ │ │ │ +0002aaa0: 6865 2070 6174 6873 2074 6f20 7468 650a  he paths to the.
│ │ │ │ +0002aab0: 2020 2020 2073 7973 7465 6d20 636f 6e66       system conf
│ │ │ │ +0002aac0: 6967 7572 6174 696f 6e20 6669 6c65 2069  iguration file i
│ │ │ │ +0002aad0: 7320 6465 6369 6465 6420 6174 2063 6f6d  s decided at com
│ │ │ │ +0002aae0: 7069 6c65 2074 696d 652c 2061 6e64 2069  pile time, and i
│ │ │ │ +0002aaf0: 730a 2020 2020 20e2 8098 7379 7363 6f6e  s.     ...syscon
│ │ │ │ +0002ab00: 6664 6972 e280 992f 7368 6973 6869 2e63  fdir.../shishi.c
│ │ │ │ +0002ab10: 6f6e 662e 2020 5468 6520 7573 6572 2063  onf.  The user c
│ │ │ │ +0002ab20: 6f6e 6669 6775 7261 7469 6f6e 2066 696c  onfiguration fil
│ │ │ │ +0002ab30: 6520 6973 0a20 2020 2020 e280 9848 4f4d  e is.     ...HOM
│ │ │ │ +0002ab40: 45e2 8099 2f2e 7368 6973 6869 2f63 6f6e  E.../.shishi/con
│ │ │ │ +0002ab50: 6669 672c 2061 6e64 2074 6865 2075 7365  fig, and the use
│ │ │ │ +0002ab60: 7220 7469 636b 6574 2066 696c 6520 6973  r ticket file is
│ │ │ │ +0002ab70: 0a20 2020 2020 e280 9848 4f4d 45e2 8099  .     ...HOME...
│ │ │ │ +0002ab80: 2f2e 7368 6973 6869 2f74 6963 6b65 742e  /.shishi/ticket.
│ │ │ │ +0002ab90: 0a0a 2020 2020 2054 6865 2068 616e 646c  ..     The handl
│ │ │ │ +0002aba0: 6520 6973 2061 6c6c 6f63 6174 6564 2072  e is allocated r
│ │ │ │ +0002abb0: 6567 6172 646c 6573 7320 6f66 2072 6574  egardless of ret
│ │ │ │ +0002abc0: 7572 6e20 7661 6c75 652e 2020 5468 6520  urn value.  The 
│ │ │ │ +0002abd0: 7369 6e67 6c65 0a20 2020 2020 6578 6365  single.     exce
│ │ │ │ +0002abe0: 7074 696f 6e20 6265 696e 6720 e280 9853  ption being ...S
│ │ │ │ +0002abf0: 4849 5348 495f 4841 4e44 4c45 5f45 5252  HISHI_HANDLE_ERR
│ │ │ │ +0002ac00: 4f52 e280 992c 2077 6869 6368 2069 6e64  OR..., which ind
│ │ │ │ +0002ac10: 6963 6174 6573 2061 2070 726f 626c 656d  icates a problem
│ │ │ │ +0002ac20: 2069 6e0a 2020 2020 2061 6c6c 6f63 6174   in.     allocat
│ │ │ │ +0002ac30: 696e 6720 7468 6520 6861 6e64 6c65 2e20  ing the handle. 
│ │ │ │ +0002ac40: 204f 7468 6572 2065 7272 6f72 2063 6f6e   Other error con
│ │ │ │ +0002ac50: 6469 7469 6f6e 7320 636f 756c 6420 6172  ditions could ar
│ │ │ │ +0002ac60: 6973 6520 7768 696c 650a 2020 2020 2072  ise while.     r
│ │ │ │ +0002ac70: 6561 6469 6e67 2066 696c 6573 2e0a 0a20  eading files... 
│ │ │ │ +0002ac80: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ +0002ac90: 653a 2a20 5265 7475 726e 7320 e280 9853  e:* Returns ...S
│ │ │ │ +0002aca0: 4849 5348 495f 4f4b e280 9920 6966 6620  HISHI_OK... iff 
│ │ │ │ +0002acb0: 7375 6363 6573 7366 756c 2e0a 0a73 6869  successful...shi
│ │ │ │ +0002acc0: 7368 695f 696e 6974 5f77 6974 685f 7061  shi_init_with_pa
│ │ │ │ +0002acd0: 7468 730a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ths.------------
│ │ │ │ +0002ace0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +0002acf0: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ +0002ad00: 6973 6869 5f69 6e69 745f 7769 7468 5f70  ishi_init_with_p
│ │ │ │ +0002ad10: 6174 6873 2028 5368 6973 6869 202a 2a20  aths (Shishi ** 
│ │ │ │ +0002ad20: 4841 4e44 4c45 2c0a 2020 2020 2020 2020  HANDLE,.        
│ │ │ │ +0002ad30: 2020 636f 6e73 7420 6368 6172 202a 2054    const char * T
│ │ │ │ +0002ad40: 4b54 5346 494c 452c 2063 6f6e 7374 2063  KTSFILE, const c
│ │ │ │ +0002ad50: 6861 7220 2a20 5359 5354 454d 4346 4746  har * SYSTEMCFGF
│ │ │ │ +0002ad60: 494c 452c 0a20 2020 2020 2020 2020 2063  ILE,.          c
│ │ │ │ +0002ad70: 6f6e 7374 2063 6861 7220 2a20 5553 4552  onst char * USER
│ │ │ │ +0002ad80: 4346 4746 494c 4529 0a20 2020 2020 4841  CFGFILE).     HA
│ │ │ │ +0002ad90: 4e44 4c45 3a20 506f 696e 7465 7220 746f  NDLE: Pointer to
│ │ │ │ +0002ada0: 2061 2053 6869 7368 6920 6861 6e64 6c65   a Shishi handle
│ │ │ │ +0002adb0: 2063 7265 6174 6564 2062 7920 7468 6973   created by this
│ │ │ │ +0002adc0: 2063 616c 6c2e 0a20 2020 2020 544b 5453   call..     TKTS
│ │ │ │ +0002add0: 4649 4c45 3a20 4669 6c65 6e61 6d65 206f  FILE: Filename o
│ │ │ │ +0002ade0: 6620 7469 636b 6574 2066 696c 652c 206f  f ticket file, o
│ │ │ │ +0002adf0: 7220 e280 984e 554c 4ce2 8099 2e0a 2020  r ...NULL.....  
│ │ │ │ +0002ae00: 2020 2053 5953 5445 4d43 4647 4649 4c45     SYSTEMCFGFILE
│ │ │ │ +0002ae10: 3a20 4669 6c65 6e61 6d65 206f 6620 7379  : Filename of sy
│ │ │ │ +0002ae20: 7374 656d 2063 6f6e 6669 6775 7261 7469  stem configurati
│ │ │ │ +0002ae30: 6f6e 2c20 6f72 20e2 8098 4e55 4c4c e280  on, or ...NULL..
│ │ │ │ +0002ae40: 992e 0a20 2020 2020 5553 4552 4346 4746  ...     USERCFGF
│ │ │ │ +0002ae50: 494c 453a 2046 696c 656e 616d 6520 6f66  ILE: Filename of
│ │ │ │ +0002ae60: 2075 7365 7220 636f 6e66 6967 7572 6174   user configurat
│ │ │ │ +0002ae70: 696f 6e2c 206f 7220 e280 984e 554c 4ce2  ion, or ...NULL.
│ │ │ │ +0002ae80: 8099 2e0a 0a20 2020 2020 2a44 6573 6372  .....     *Descr
│ │ │ │ +0002ae90: 6970 7469 6f6e 3a2a 2043 7265 6174 6573  iption:* Creates
│ │ │ │ +0002aea0: 2061 2053 6869 7368 6920 6c69 6272 6172   a Shishi librar
│ │ │ │ +0002aeb0: 7920 6861 6e64 6c65 2c20 7573 696e 6720  y handle, using 
│ │ │ │ +0002aec0: e280 9873 6869 7368 6928 29e2 8099 2c0a  ...shishi()...,.
│ │ │ │ +0002aed0: 2020 2020 2061 6e64 2072 6561 6473 2074       and reads t
│ │ │ │ +0002aee0: 6865 2073 7973 7465 6d20 636f 6e66 6967  he system config
│ │ │ │ +0002aef0: 7572 6174 696f 6e20 6669 6c65 2c20 7573  uration file, us
│ │ │ │ +0002af00: 6572 2063 6f6e 6669 6775 7261 7469 6f6e  er configuration
│ │ │ │ +0002af10: 2066 696c 652c 0a20 2020 2020 616e 6420   file,.     and 
│ │ │ │ +0002af20: 7573 6572 2074 6963 6b65 7473 2061 7420  user tickets at 
│ │ │ │ +0002af30: 7468 6520 7370 6563 6966 6965 6420 6c6f  the specified lo
│ │ │ │ +0002af40: 6361 7469 6f6e 732e 2020 4966 2061 6e79  cations.  If any
│ │ │ │ +0002af50: 206f 6620 5553 4552 4346 4746 494c 450a   of USERCFGFILE.
│ │ │ │ +0002af60: 2020 2020 206f 7220 5359 5354 454d 4346       or SYSTEMCF
│ │ │ │ +0002af70: 4746 494c 4520 6973 20e2 8098 4e55 4c4c  GFILE is ...NULL
│ │ │ │ +0002af80: e280 992c 2074 6865 2066 696c 6520 6973  ..., the file is
│ │ │ │ +0002af90: 2072 6561 6420 6672 6f6d 2069 7473 2064   read from its d
│ │ │ │ +0002afa0: 6566 6175 6c74 0a20 2020 2020 6c6f 6361  efault.     loca
│ │ │ │ +0002afb0: 7469 6f6e 2c20 7768 6963 6820 666f 7220  tion, which for 
│ │ │ │ +0002afc0: 7468 6520 7379 7374 656d 2063 6f6e 6669  the system confi
│ │ │ │ +0002afd0: 6775 7261 7469 6f6e 2069 7320 6465 6369  guration is deci
│ │ │ │ +0002afe0: 6465 6420 6174 2063 6f6d 7069 6c65 0a20  ded at compile. 
│ │ │ │ +0002aff0: 2020 2020 7469 6d65 2c20 616e 6420 6973      time, and is
│ │ │ │ +0002b000: 20e2 8098 7379 7363 6f6e 6664 6972 e280   ...sysconfdir..
│ │ │ │ +0002b010: 992f 7368 6973 6869 2e63 6f6e 662c 2061  ./shishi.conf, a
│ │ │ │ +0002b020: 6e64 2066 6f72 2074 6865 2075 7365 720a  nd for the user.
│ │ │ │ +0002b030: 2020 2020 2063 6f6e 6669 6775 7261 7469       configurati
│ │ │ │ +0002b040: 6f6e 2069 7420 6973 20e2 8098 484f 4d45  on it is ...HOME
│ │ │ │ +0002b050: e280 992f 2e73 6869 7368 692f 636f 6e66  .../.shishi/conf
│ │ │ │ +0002b060: 6967 2e20 2049 6620 7468 6520 7469 636b  ig.  If the tick
│ │ │ │ +0002b070: 6574 2066 696c 6520 6e61 6d65 0a20 2020  et file name.   
│ │ │ │ +0002b080: 2020 6973 20e2 8098 4e55 4c4c e280 992c    is ...NULL...,
│ │ │ │ +0002b090: 2061 2074 6963 6b65 7420 6669 6c65 2069   a ticket file i
│ │ │ │ +0002b0a0: 7320 6e6f 7420 7265 6164 2061 7420 616c  s not read at al
│ │ │ │ +0002b0b0: 6c2e 0a0a 2020 2020 2054 6865 2068 616e  l...     The han
│ │ │ │ +0002b0c0: 646c 6520 6973 2061 6c6c 6f63 6174 6564  dle is allocated
│ │ │ │ +0002b0d0: 2072 6567 6172 646c 6573 7320 6f66 2072   regardless of r
│ │ │ │ +0002b0e0: 6574 7572 6e20 7661 6c75 652e 2020 5468  eturn value.  Th
│ │ │ │ +0002b0f0: 6520 7369 6e67 6c65 0a20 2020 2020 6578  e single.     ex
│ │ │ │ +0002b100: 6365 7074 696f 6e20 6265 696e 6720 e280  ception being ..
│ │ │ │ +0002b110: 9853 4849 5348 495f 4841 4e44 4c45 5f45  .SHISHI_HANDLE_E
│ │ │ │ +0002b120: 5252 4f52 e280 992c 2077 6869 6368 2069  RROR..., which i
│ │ │ │ +0002b130: 6e64 6963 6174 6573 2061 2070 726f 626c  ndicates a probl
│ │ │ │ +0002b140: 656d 2069 6e0a 2020 2020 2061 6c6c 6f63  em in.     alloc
│ │ │ │ +0002b150: 6174 696e 6720 7468 6520 6861 6e64 6c65  ating the handle
│ │ │ │ +0002b160: 2e20 204f 7468 6572 2065 7272 6f72 2063  .  Other error c
│ │ │ │ +0002b170: 6f6e 6469 7469 6f6e 7320 636f 756c 6420  onditions could 
│ │ │ │ +0002b180: 6172 6973 6520 7768 696c 650a 2020 2020  arise while.    
│ │ │ │ +0002b190: 2072 6561 6469 6e67 2066 696c 6573 2e0a   reading files..
│ │ │ │ +0002b1a0: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ +0002b1b0: 6c75 653a 2a20 5265 7475 726e 7320 e280  lue:* Returns ..
│ │ │ │ +0002b1c0: 9853 4849 5348 495f 4f4b e280 9920 6966  .SHISHI_OK... if
│ │ │ │ +0002b1d0: 6620 7375 6363 6573 7366 756c 2e0a 0a73  f successful...s
│ │ │ │ +0002b1e0: 6869 7368 695f 696e 6974 5f73 6572 7665  hishi_init_serve
│ │ │ │ +0002b1f0: 720a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  r.--------------
│ │ │ │ +0002b200: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ +0002b210: 6f6e 3a20 696e 7420 7368 6973 6869 5f69  on: int shishi_i
│ │ │ │ +0002b220: 6e69 745f 7365 7276 6572 2028 5368 6973  nit_server (Shis
│ │ │ │ +0002b230: 6869 202a 2a20 4841 4e44 4c45 290a 2020  hi ** HANDLE).  
│ │ │ │ +0002b240: 2020 2048 414e 444c 453a 2050 6f69 6e74     HANDLE: Point
│ │ │ │ +0002b250: 6572 2074 6f20 6120 5368 6973 6869 2068  er to a Shishi h
│ │ │ │ +0002b260: 616e 646c 6520 6372 6561 7465 6420 6279  andle created by
│ │ │ │ +0002b270: 2074 6869 7320 6361 6c6c 2e0a 0a20 2020   this call...   
│ │ │ │ +0002b280: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ +0002b290: 2043 7265 6174 6573 2061 2053 6869 7368   Creates a Shish
│ │ │ │ +0002b2a0: 6920 6c69 6272 6172 7920 6861 6e64 6c65  i library handle
│ │ │ │ +0002b2b0: 2c20 7573 696e 670a 2020 2020 20e2 8098  , using.     ...
│ │ │ │ +0002b2c0: 7368 6973 6869 5f73 6572 7665 7228 29e2  shishi_server().
│ │ │ │ +0002b2d0: 8099 2c20 616e 6420 7265 6164 7320 7468  .., and reads th
│ │ │ │ +0002b2e0: 6520 7379 7374 656d 2063 6f6e 6669 6775  e system configu
│ │ │ │ +0002b2f0: 7261 7469 6f6e 2066 696c 652e 2020 5468  ration file.  Th
│ │ │ │ +0002b300: 650a 2020 2020 2070 6174 6820 746f 2074  e.     path to t
│ │ │ │ +0002b310: 6865 2073 7973 7465 6d20 636f 6e66 6967  he system config
│ │ │ │ +0002b320: 7572 6174 696f 6e20 6669 6c65 2069 7320  uration file is 
│ │ │ │ +0002b330: 6465 6369 6465 6420 6174 2063 6f6d 7069  decided at compi
│ │ │ │ +0002b340: 6c65 2074 696d 652c 0a20 2020 2020 616e  le time,.     an
│ │ │ │ +0002b350: 6420 6973 20e2 8098 7379 7363 6f6e 6664  d is ...sysconfd
│ │ │ │ +0002b360: 6972 e280 992f 7368 6973 6869 2e63 6f6e  ir.../shishi.con
│ │ │ │ +0002b370: 662e 0a0a 2020 2020 2054 6865 2068 616e  f...     The han
│ │ │ │ +0002b380: 646c 6520 6973 2061 6c6c 6f63 6174 6564  dle is allocated
│ │ │ │ +0002b390: 2072 6567 6172 646c 6573 7320 6f66 2072   regardless of r
│ │ │ │ +0002b3a0: 6574 7572 6e20 7661 6c75 652e 2020 5468  eturn value.  Th
│ │ │ │ +0002b3b0: 6520 7369 6e67 6c65 0a20 2020 2020 6578  e single.     ex
│ │ │ │ +0002b3c0: 6365 7074 696f 6e20 6265 696e 6720 e280  ception being ..
│ │ │ │ +0002b3d0: 9853 4849 5348 495f 4841 4e44 4c45 5f45  .SHISHI_HANDLE_E
│ │ │ │ +0002b3e0: 5252 4f52 e280 992c 2077 6869 6368 2069  RROR..., which i
│ │ │ │ +0002b3f0: 6e64 6963 6174 6573 2061 2070 726f 626c  ndicates a probl
│ │ │ │ +0002b400: 656d 2069 6e0a 2020 2020 2061 6c6c 6f63  em in.     alloc
│ │ │ │ +0002b410: 6174 696e 6720 7468 6520 6861 6e64 6c65  ating the handle
│ │ │ │ +0002b420: 2e20 204f 7468 6572 2065 7272 6f72 2063  .  Other error c
│ │ │ │ +0002b430: 6f6e 6469 7469 6f6e 7320 636f 756c 6420  onditions could 
│ │ │ │ +0002b440: 6172 6973 6520 7768 696c 650a 2020 2020  arise while.    
│ │ │ │ +0002b450: 2072 6561 6469 6e67 2074 6865 2066 696c   reading the fil
│ │ │ │ +0002b460: 652e 0a0a 2020 2020 202a 5265 7475 726e  e...     *Return
│ │ │ │ +0002b470: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ +0002b480: 20e2 8098 5348 4953 4849 5f4f 4be2 8099   ...SHISHI_OK...
│ │ │ │ +0002b490: 2069 6666 2073 7563 6365 7373 6675 6c2e   iff successful.
│ │ │ │ +0002b4a0: 0a0a 7368 6973 6869 5f69 6e69 745f 7365  ..shishi_init_se
│ │ │ │ +0002b4b0: 7276 6572 5f77 6974 685f 7061 7468 730a  rver_with_paths.
│ │ │ │  0002b4c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0002b4d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ -0002b4e0: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ -0002b4f0: 6869 7368 695f 696e 6974 5f73 6572 7665  hishi_init_serve
│ │ │ │ -0002b500: 725f 7769 7468 5f70 6174 6873 2028 5368  r_with_paths (Sh
│ │ │ │ -0002b510: 6973 6869 202a 2a20 4841 4e44 4c45 2c0a  ishi ** HANDLE,.
│ │ │ │ -0002b520: 2020 2020 2020 2020 2020 636f 6e73 7420            const 
│ │ │ │ -0002b530: 6368 6172 202a 2053 5953 5445 4d43 4647  char * SYSTEMCFG
│ │ │ │ -0002b540: 4649 4c45 290a 2020 2020 2048 414e 444c  FILE).     HANDL
│ │ │ │ -0002b550: 453a 2050 6f69 6e74 6572 2074 6f20 6120  E: Pointer to a 
│ │ │ │ -0002b560: 5368 6973 6869 2068 616e 646c 6520 6372  Shishi handle cr
│ │ │ │ -0002b570: 6561 7465 6420 6279 2074 6869 7320 6361  eated by this ca
│ │ │ │ -0002b580: 6c6c 2e0a 2020 2020 2053 5953 5445 4d43  ll..     SYSTEMC
│ │ │ │ -0002b590: 4647 4649 4c45 3a20 4669 6c65 6e61 6d65  FGFILE: Filename
│ │ │ │ -0002b5a0: 206f 6620 7379 7374 656d 2063 6f6e 6669   of system confi
│ │ │ │ -0002b5b0: 6775 7261 7469 6f6e 2c20 6f72 20e2 8098  guration, or ...
│ │ │ │ -0002b5c0: 4e55 4c4c e280 992e 0a0a 2020 2020 202a  NULL......     *
│ │ │ │ -0002b5d0: 4465 7363 7269 7074 696f 6e3a 2a20 4372  Description:* Cr
│ │ │ │ -0002b5e0: 6561 7465 7320 6120 5368 6973 6869 206c  eates a Shishi l
│ │ │ │ -0002b5f0: 6962 7261 7279 2068 616e 646c 652c 2075  ibrary handle, u
│ │ │ │ -0002b600: 7369 6e67 0a20 2020 2020 e280 9873 6869  sing.     ...shi
│ │ │ │ -0002b610: 7368 695f 7365 7276 6572 2829 e280 992c  shi_server()...,
│ │ │ │ -0002b620: 2061 6e64 2072 6561 6473 2074 6865 2073   and reads the s
│ │ │ │ -0002b630: 7973 7465 6d20 636f 6e66 6967 7572 6174  ystem configurat
│ │ │ │ -0002b640: 696f 6e20 6669 6c65 2066 726f 6d20 7468  ion file from th
│ │ │ │ -0002b650: 650a 2020 2020 2073 7065 6369 6669 6564  e.     specified
│ │ │ │ -0002b660: 206c 6f63 6174 696f 6e2e 2020 5468 6520   location.  The 
│ │ │ │ -0002b670: 7061 7468 2074 6f20 7468 6520 7379 7374  path to the syst
│ │ │ │ -0002b680: 656d 2063 6f6e 6669 6775 7261 7469 6f6e  em configuration
│ │ │ │ -0002b690: 2066 696c 6520 6973 0a20 2020 2020 6465   file is.     de
│ │ │ │ -0002b6a0: 6369 6465 6420 6174 2063 6f6d 7069 6c65  cided at compile
│ │ │ │ -0002b6b0: 2074 696d 652c 2061 6e64 2069 7320 e280   time, and is ..
│ │ │ │ -0002b6c0: 9873 7973 636f 6e66 6469 72e2 8099 2f73  .sysconfdir.../s
│ │ │ │ -0002b6d0: 6869 7368 692e 636f 6e66 2e0a 0a20 2020  hishi.conf...   
│ │ │ │ -0002b6e0: 2020 5468 6520 6861 6e64 6c65 2069 7320    The handle is 
│ │ │ │ -0002b6f0: 616c 6c6f 6361 7465 6420 7265 6761 7264  allocated regard
│ │ │ │ -0002b700: 6c65 7373 206f 6620 7265 7475 726e 2076  less of return v
│ │ │ │ -0002b710: 616c 7565 2e20 2054 6865 2073 696e 676c  alue.  The singl
│ │ │ │ -0002b720: 650a 2020 2020 2065 7863 6570 7469 6f6e  e.     exception
│ │ │ │ -0002b730: 2062 6569 6e67 20e2 8098 5348 4953 4849   being ...SHISHI
│ │ │ │ -0002b740: 5f48 414e 444c 455f 4552 524f 52e2 8099  _HANDLE_ERROR...
│ │ │ │ -0002b750: 2c20 7768 6963 6820 696e 6469 6361 7465  , which indicate
│ │ │ │ -0002b760: 7320 6120 7072 6f62 6c65 6d20 696e 0a20  s a problem in. 
│ │ │ │ -0002b770: 2020 2020 616c 6c6f 6361 7469 6e67 2074      allocating t
│ │ │ │ -0002b780: 6865 2068 616e 646c 652e 2020 4f74 6865  he handle.  Othe
│ │ │ │ -0002b790: 7220 6572 726f 7220 636f 6e64 6974 696f  r error conditio
│ │ │ │ -0002b7a0: 6e73 2063 6f75 6c64 2061 7269 7365 2077  ns could arise w
│ │ │ │ -0002b7b0: 6869 6c65 0a20 2020 2020 7265 6164 696e  hile.     readin
│ │ │ │ -0002b7c0: 6720 7468 6520 6669 6c65 2e0a 0a20 2020  g the file...   
│ │ │ │ -0002b7d0: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ -0002b7e0: 2a20 5265 7475 726e 7320 e280 9853 4849  * Returns ...SHI
│ │ │ │ -0002b7f0: 5348 495f 4f4b e280 9920 6966 6620 7375  SHI_OK... iff su
│ │ │ │ -0002b800: 6363 6573 7366 756c 2e0a 0a73 6869 7368  ccessful...shish
│ │ │ │ -0002b810: 695f 6366 670a 2d2d 2d2d 2d2d 2d2d 2d2d  i_cfg.----------
│ │ │ │ -0002b820: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ -0002b830: 696e 7420 7368 6973 6869 5f63 6667 2028  int shishi_cfg (
│ │ │ │ -0002b840: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ -0002b850: 2063 6f6e 7374 2063 6861 7220 2a20 4f50   const char * OP
│ │ │ │ -0002b860: 5449 4f4e 290a 2020 2020 2048 414e 444c  TION).     HANDL
│ │ │ │ -0002b870: 453a 2053 6869 7368 6920 6c69 6272 6172  E: Shishi librar
│ │ │ │ -0002b880: 7920 6861 6e64 6c65 2063 7265 6174 6564  y handle created
│ │ │ │ -0002b890: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ -0002b8a0: 6974 2829 e280 992e 0a20 2020 2020 4f50  it().....     OP
│ │ │ │ -0002b8b0: 5449 4f4e 3a20 5374 7269 6e67 2063 6f6e  TION: String con
│ │ │ │ -0002b8c0: 7461 696e 696e 6720 7368 6973 6869 206c  taining shishi l
│ │ │ │ -0002b8d0: 6962 7261 7279 206f 7074 696f 6e73 2e0a  ibrary options..
│ │ │ │ -0002b8e0: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -0002b8f0: 6f6e 3a2a 2043 6f6e 6669 6775 7265 7320  on:* Configures 
│ │ │ │ -0002b900: 7468 6520 7368 6973 6869 206c 6962 7261  the shishi libra
│ │ │ │ -0002b910: 7279 2061 6363 6f72 6469 6e67 2074 6f20  ry according to 
│ │ │ │ -0002b920: 7468 650a 2020 2020 206f 7074 696f 6e73  the.     options
│ │ │ │ -0002b930: 2067 6976 656e 2069 6e20 4f50 5449 4f4e   given in OPTION
│ │ │ │ -0002b940: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ -0002b950: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ -0002b960: e280 9853 4849 5348 495f 4f4b e280 9920  ...SHISHI_OK... 
│ │ │ │ -0002b970: 6966 204f 5054 494f 4e20 6973 2076 616c  if OPTION is val
│ │ │ │ -0002b980: 6964 2061 6e64 0a20 2020 2020 636f 6e66  id and.     conf
│ │ │ │ -0002b990: 6967 7572 6174 696f 6e20 7761 7320 7375  iguration was su
│ │ │ │ -0002b9a0: 6363 6573 7366 756c 2e0a 0a73 6869 7368  ccessful...shish
│ │ │ │ -0002b9b0: 695f 6366 675f 6672 6f6d 5f66 696c 650a  i_cfg_from_file.
│ │ │ │ -0002b9c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0002b9d0: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -0002b9e0: 6f6e 3a20 696e 7420 7368 6973 6869 5f63  on: int shishi_c
│ │ │ │ -0002b9f0: 6667 5f66 726f 6d5f 6669 6c65 2028 5368  fg_from_file (Sh
│ │ │ │ -0002ba00: 6973 6869 202a 2048 414e 444c 452c 0a20  ishi * HANDLE,. 
│ │ │ │ -0002ba10: 2020 2020 2020 2020 2063 6f6e 7374 2063           const c
│ │ │ │ -0002ba20: 6861 7220 2a20 4346 4729 0a20 2020 2020  har * CFG).     
│ │ │ │ -0002ba30: 4841 4e44 4c45 3a20 5368 6973 6869 206c  HANDLE: Shishi l
│ │ │ │ -0002ba40: 6962 7261 7279 2068 616e 646c 6520 6372  ibrary handle cr
│ │ │ │ -0002ba50: 6561 7465 6420 6279 20e2 8098 7368 6973  eated by ...shis
│ │ │ │ -0002ba60: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ -0002ba70: 2020 2043 4647 3a20 4e61 6d65 206f 6620     CFG: Name of 
│ │ │ │ -0002ba80: 636f 6e66 6967 7572 6174 696f 6e20 6669  configuration fi
│ │ │ │ -0002ba90: 6c65 2e0a 0a20 2020 2020 2a44 6573 6372  le...     *Descr
│ │ │ │ -0002baa0: 6970 7469 6f6e 3a2a 2043 6f6e 6669 6775  iption:* Configu
│ │ │ │ -0002bab0: 7265 7320 7468 6520 7368 6973 6869 206c  res the shishi l
│ │ │ │ -0002bac0: 6962 7261 7279 2075 7369 6e67 2061 2063  ibrary using a c
│ │ │ │ -0002bad0: 6f6e 6669 6775 7261 7469 6f6e 0a20 2020  onfiguration.   
│ │ │ │ -0002bae0: 2020 6669 6c65 206c 6f63 6174 6564 2061    file located a
│ │ │ │ -0002baf0: 7420 4346 472e 0a0a 2020 2020 202a 5265  t CFG...     *Re
│ │ │ │ -0002bb00: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ -0002bb10: 7572 6e73 20e2 8098 5348 4953 4849 5f4f  urns ...SHISHI_O
│ │ │ │ -0002bb20: 4be2 8099 2069 6620 7375 6363 6573 7366  K... if successf
│ │ │ │ -0002bb30: 756c 2e0a 0a73 6869 7368 695f 6366 675f  ul...shishi_cfg_
│ │ │ │ -0002bb40: 7072 696e 740a 2d2d 2d2d 2d2d 2d2d 2d2d  print.----------
│ │ │ │ -0002bb50: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ -0002bb60: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ -0002bb70: 5f63 6667 5f70 7269 6e74 2028 5368 6973  _cfg_print (Shis
│ │ │ │ -0002bb80: 6869 202a 2048 414e 444c 452c 2046 494c  hi * HANDLE, FIL
│ │ │ │ -0002bb90: 4520 2a20 4648 290a 2020 2020 2048 414e  E * FH).     HAN
│ │ │ │ -0002bba0: 444c 453a 2053 6869 7368 6920 6c69 6272  DLE: Shishi libr
│ │ │ │ -0002bbb0: 6172 7920 6861 6e64 6c65 2063 7265 6174  ary handle creat
│ │ │ │ -0002bbc0: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ -0002bbd0: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ -0002bbe0: 4648 3a20 4669 6c65 2073 7472 6561 6d20  FH: File stream 
│ │ │ │ -0002bbf0: 6861 6e64 6c65 206f 7065 6e65 6420 666f  handle opened fo
│ │ │ │ -0002bc00: 7220 7772 6974 696e 672e 0a0a 2020 2020  r writing...    
│ │ │ │ -0002bc10: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ -0002bc20: 5072 696e 7473 206c 6962 7261 7279 2063  Prints library c
│ │ │ │ -0002bc30: 6f6e 6669 6775 7261 7469 6f6e 2073 7461  onfiguration sta
│ │ │ │ -0002bc40: 7475 7320 746f 2046 482e 2020 5468 6973  tus to FH.  This
│ │ │ │ -0002bc50: 0a20 2020 2020 6675 6e63 7469 6f6e 2069  .     function i
│ │ │ │ -0002bc60: 7320 6d6f 7374 6c79 2069 6e74 656e 6465  s mostly intende
│ │ │ │ -0002bc70: 6420 666f 7220 6465 6275 6767 696e 6720  d for debugging 
│ │ │ │ -0002bc80: 7075 7270 6f73 6573 2e0a 0a20 2020 2020  purposes...     
│ │ │ │ -0002bc90: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ -0002bca0: 416c 7761 7973 2072 6574 7572 6e73 20e2  Always returns .
│ │ │ │ -0002bcb0: 8098 5348 4953 4849 5f4f 4be2 8099 2e0a  ..SHISHI_OK.....
│ │ │ │ -0002bcc0: 0a73 6869 7368 695f 6366 675f 6465 6661  .shishi_cfg_defa
│ │ │ │ -0002bcd0: 756c 745f 7379 7374 656d 6669 6c65 0a2d  ult_systemfile.-
│ │ │ │ -0002bce0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0002bcf0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ -0002bd00: 2d20 4675 6e63 7469 6f6e 3a20 636f 6e73  - Function: cons
│ │ │ │ -0002bd10: 7420 6368 6172 202a 2073 6869 7368 695f  t char * shishi_
│ │ │ │ -0002bd20: 6366 675f 6465 6661 756c 745f 7379 7374  cfg_default_syst
│ │ │ │ -0002bd30: 656d 6669 6c65 0a20 2020 2020 2020 2020  emfile.         
│ │ │ │ -0002bd40: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ -0002bd50: 4529 0a20 2020 2020 4841 4e44 4c45 3a20  E).     HANDLE: 
│ │ │ │ -0002bd60: 5368 6973 6869 206c 6962 7261 7279 2068  Shishi library h
│ │ │ │ -0002bd70: 616e 646c 6520 6372 6561 7465 6420 6279  andle created by
│ │ │ │ -0002bd80: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ -0002bd90: 29e2 8099 2e0a 0a20 2020 2020 2a44 6573  )......     *Des
│ │ │ │ -0002bda0: 6372 6970 7469 6f6e 3a2a 2054 6865 2073  cription:* The s
│ │ │ │ -0002bdb0: 7973 7465 6d20 636f 6e66 6967 7572 6174  ystem configurat
│ │ │ │ -0002bdc0: 696f 6e20 6669 6c65 206e 616d 6520 6973  ion file name is
│ │ │ │ -0002bdd0: 2064 6563 6964 6564 2061 740a 2020 2020   decided at.    
│ │ │ │ -0002bde0: 2063 6f6d 7069 6c65 2074 696d 652c 2062   compile time, b
│ │ │ │ -0002bdf0: 7574 2069 7320 7265 706c 6163 6564 2062  ut is replaced b
│ │ │ │ -0002be00: 7920 6173 7369 676e 696e 6720 616e 6f74  y assigning anot
│ │ │ │ -0002be10: 6865 7220 6669 6c65 206e 616d 6520 746f  her file name to
│ │ │ │ -0002be20: 2074 6865 0a20 2020 2020 656e 7669 726f   the.     enviro
│ │ │ │ -0002be30: 6e6d 656e 7420 7661 7269 6162 6c65 20e2  nment variable .
│ │ │ │ -0002be40: 8098 5348 4953 4849 5f43 4f4e 4649 47e2  ..SHISHI_CONFIG.
│ │ │ │ -0002be50: 8099 2e20 2054 6869 7320 6361 6c6c 206f  ...  This call o
│ │ │ │ -0002be60: 6666 6572 7320 6120 7369 6e67 6c65 0a20  ffers a single. 
│ │ │ │ -0002be70: 2020 2020 696e 7465 7266 6163 6520 666f      interface fo
│ │ │ │ -0002be80: 7220 6465 7465 726d 696e 696e 6720 7468  r determining th
│ │ │ │ -0002be90: 6520 6669 6c65 206e 616d 652c 2074 6f20  e file name, to 
│ │ │ │ -0002bea0: 7768 6963 6820 7468 6520 6c69 6272 6172  which the librar
│ │ │ │ -0002beb0: 7920 7475 726e 730a 2020 2020 2066 6f72  y turns.     for
│ │ │ │ -0002bec0: 2069 7473 2073 6574 7469 6e67 732e 0a0a   its settings...
│ │ │ │ -0002bed0: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ -0002bee0: 7565 3a2a 2052 6574 7572 6e73 2066 696c  ue:* Returns fil
│ │ │ │ -0002bef0: 6520 6e61 6d65 206f 6620 7072 6573 656e  e name of presen
│ │ │ │ -0002bf00: 7420 7379 7374 656d 2063 6f6e 6669 6775  t system configu
│ │ │ │ -0002bf10: 7261 7469 6f6e 2e0a 0a73 6869 7368 695f  ration...shishi_
│ │ │ │ -0002bf20: 6366 675f 6465 6661 756c 745f 7573 6572  cfg_default_user
│ │ │ │ -0002bf30: 6469 7265 6374 6f72 790a 2d2d 2d2d 2d2d  directory.------
│ │ │ │ +0002b4d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ +0002b4e0: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ +0002b4f0: 2073 6869 7368 695f 696e 6974 5f73 6572   shishi_init_ser
│ │ │ │ +0002b500: 7665 725f 7769 7468 5f70 6174 6873 2028  ver_with_paths (
│ │ │ │ +0002b510: 5368 6973 6869 202a 2a20 4841 4e44 4c45  Shishi ** HANDLE
│ │ │ │ +0002b520: 2c0a 2020 2020 2020 2020 2020 636f 6e73  ,.          cons
│ │ │ │ +0002b530: 7420 6368 6172 202a 2053 5953 5445 4d43  t char * SYSTEMC
│ │ │ │ +0002b540: 4647 4649 4c45 290a 2020 2020 2048 414e  FGFILE).     HAN
│ │ │ │ +0002b550: 444c 453a 2050 6f69 6e74 6572 2074 6f20  DLE: Pointer to 
│ │ │ │ +0002b560: 6120 5368 6973 6869 2068 616e 646c 6520  a Shishi handle 
│ │ │ │ +0002b570: 6372 6561 7465 6420 6279 2074 6869 7320  created by this 
│ │ │ │ +0002b580: 6361 6c6c 2e0a 2020 2020 2053 5953 5445  call..     SYSTE
│ │ │ │ +0002b590: 4d43 4647 4649 4c45 3a20 4669 6c65 6e61  MCFGFILE: Filena
│ │ │ │ +0002b5a0: 6d65 206f 6620 7379 7374 656d 2063 6f6e  me of system con
│ │ │ │ +0002b5b0: 6669 6775 7261 7469 6f6e 2c20 6f72 20e2  figuration, or .
│ │ │ │ +0002b5c0: 8098 4e55 4c4c e280 992e 0a0a 2020 2020  ..NULL......    
│ │ │ │ +0002b5d0: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ +0002b5e0: 4372 6561 7465 7320 6120 5368 6973 6869  Creates a Shishi
│ │ │ │ +0002b5f0: 206c 6962 7261 7279 2068 616e 646c 652c   library handle,
│ │ │ │ +0002b600: 2075 7369 6e67 0a20 2020 2020 e280 9873   using.     ...s
│ │ │ │ +0002b610: 6869 7368 695f 7365 7276 6572 2829 e280  hishi_server()..
│ │ │ │ +0002b620: 992c 2061 6e64 2072 6561 6473 2074 6865  ., and reads the
│ │ │ │ +0002b630: 2073 7973 7465 6d20 636f 6e66 6967 7572   system configur
│ │ │ │ +0002b640: 6174 696f 6e20 6669 6c65 2066 726f 6d20  ation file from 
│ │ │ │ +0002b650: 7468 650a 2020 2020 2073 7065 6369 6669  the.     specifi
│ │ │ │ +0002b660: 6564 206c 6f63 6174 696f 6e2e 2020 5468  ed location.  Th
│ │ │ │ +0002b670: 6520 7061 7468 2074 6f20 7468 6520 7379  e path to the sy
│ │ │ │ +0002b680: 7374 656d 2063 6f6e 6669 6775 7261 7469  stem configurati
│ │ │ │ +0002b690: 6f6e 2066 696c 6520 6973 0a20 2020 2020  on file is.     
│ │ │ │ +0002b6a0: 6465 6369 6465 6420 6174 2063 6f6d 7069  decided at compi
│ │ │ │ +0002b6b0: 6c65 2074 696d 652c 2061 6e64 2069 7320  le time, and is 
│ │ │ │ +0002b6c0: e280 9873 7973 636f 6e66 6469 72e2 8099  ...sysconfdir...
│ │ │ │ +0002b6d0: 2f73 6869 7368 692e 636f 6e66 2e0a 0a20  /shishi.conf... 
│ │ │ │ +0002b6e0: 2020 2020 5468 6520 6861 6e64 6c65 2069      The handle i
│ │ │ │ +0002b6f0: 7320 616c 6c6f 6361 7465 6420 7265 6761  s allocated rega
│ │ │ │ +0002b700: 7264 6c65 7373 206f 6620 7265 7475 726e  rdless of return
│ │ │ │ +0002b710: 2076 616c 7565 2e20 2054 6865 2073 696e   value.  The sin
│ │ │ │ +0002b720: 676c 650a 2020 2020 2065 7863 6570 7469  gle.     excepti
│ │ │ │ +0002b730: 6f6e 2062 6569 6e67 20e2 8098 5348 4953  on being ...SHIS
│ │ │ │ +0002b740: 4849 5f48 414e 444c 455f 4552 524f 52e2  HI_HANDLE_ERROR.
│ │ │ │ +0002b750: 8099 2c20 7768 6963 6820 696e 6469 6361  .., which indica
│ │ │ │ +0002b760: 7465 7320 6120 7072 6f62 6c65 6d20 696e  tes a problem in
│ │ │ │ +0002b770: 0a20 2020 2020 616c 6c6f 6361 7469 6e67  .     allocating
│ │ │ │ +0002b780: 2074 6865 2068 616e 646c 652e 2020 4f74   the handle.  Ot
│ │ │ │ +0002b790: 6865 7220 6572 726f 7220 636f 6e64 6974  her error condit
│ │ │ │ +0002b7a0: 696f 6e73 2063 6f75 6c64 2061 7269 7365  ions could arise
│ │ │ │ +0002b7b0: 2077 6869 6c65 0a20 2020 2020 7265 6164   while.     read
│ │ │ │ +0002b7c0: 696e 6720 7468 6520 6669 6c65 2e0a 0a20  ing the file... 
│ │ │ │ +0002b7d0: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ +0002b7e0: 653a 2a20 5265 7475 726e 7320 e280 9853  e:* Returns ...S
│ │ │ │ +0002b7f0: 4849 5348 495f 4f4b e280 9920 6966 6620  HISHI_OK... iff 
│ │ │ │ +0002b800: 7375 6363 6573 7366 756c 2e0a 0a73 6869  successful...shi
│ │ │ │ +0002b810: 7368 695f 6366 670a 2d2d 2d2d 2d2d 2d2d  shi_cfg.--------
│ │ │ │ +0002b820: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ +0002b830: 3a20 696e 7420 7368 6973 6869 5f63 6667  : int shishi_cfg
│ │ │ │ +0002b840: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ +0002b850: 452c 2063 6f6e 7374 2063 6861 7220 2a20  E, const char * 
│ │ │ │ +0002b860: 4f50 5449 4f4e 290a 2020 2020 2048 414e  OPTION).     HAN
│ │ │ │ +0002b870: 444c 453a 2053 6869 7368 6920 6c69 6272  DLE: Shishi libr
│ │ │ │ +0002b880: 6172 7920 6861 6e64 6c65 2063 7265 6174  ary handle creat
│ │ │ │ +0002b890: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ +0002b8a0: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ +0002b8b0: 4f50 5449 4f4e 3a20 5374 7269 6e67 2063  OPTION: String c
│ │ │ │ +0002b8c0: 6f6e 7461 696e 696e 6720 7368 6973 6869  ontaining shishi
│ │ │ │ +0002b8d0: 206c 6962 7261 7279 206f 7074 696f 6e73   library options
│ │ │ │ +0002b8e0: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ +0002b8f0: 7469 6f6e 3a2a 2043 6f6e 6669 6775 7265  tion:* Configure
│ │ │ │ +0002b900: 7320 7468 6520 7368 6973 6869 206c 6962  s the shishi lib
│ │ │ │ +0002b910: 7261 7279 2061 6363 6f72 6469 6e67 2074  rary according t
│ │ │ │ +0002b920: 6f20 7468 650a 2020 2020 206f 7074 696f  o the.     optio
│ │ │ │ +0002b930: 6e73 2067 6976 656e 2069 6e20 4f50 5449  ns given in OPTI
│ │ │ │ +0002b940: 4f4e 2e0a 0a20 2020 2020 2a52 6574 7572  ON...     *Retur
│ │ │ │ +0002b950: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ +0002b960: 7320 e280 9853 4849 5348 495f 4f4b e280  s ...SHISHI_OK..
│ │ │ │ +0002b970: 9920 6966 204f 5054 494f 4e20 6973 2076  . if OPTION is v
│ │ │ │ +0002b980: 616c 6964 2061 6e64 0a20 2020 2020 636f  alid and.     co
│ │ │ │ +0002b990: 6e66 6967 7572 6174 696f 6e20 7761 7320  nfiguration was 
│ │ │ │ +0002b9a0: 7375 6363 6573 7366 756c 2e0a 0a73 6869  successful...shi
│ │ │ │ +0002b9b0: 7368 695f 6366 675f 6672 6f6d 5f66 696c  shi_cfg_from_fil
│ │ │ │ +0002b9c0: 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  e.--------------
│ │ │ │ +0002b9d0: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ +0002b9e0: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ +0002b9f0: 5f63 6667 5f66 726f 6d5f 6669 6c65 2028  _cfg_from_file (
│ │ │ │ +0002ba00: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ +0002ba10: 0a20 2020 2020 2020 2020 2063 6f6e 7374  .          const
│ │ │ │ +0002ba20: 2063 6861 7220 2a20 4346 4729 0a20 2020   char * CFG).   
│ │ │ │ +0002ba30: 2020 4841 4e44 4c45 3a20 5368 6973 6869    HANDLE: Shishi
│ │ │ │ +0002ba40: 206c 6962 7261 7279 2068 616e 646c 6520   library handle 
│ │ │ │ +0002ba50: 6372 6561 7465 6420 6279 20e2 8098 7368  created by ...sh
│ │ │ │ +0002ba60: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ +0002ba70: 2020 2020 2043 4647 3a20 4e61 6d65 206f       CFG: Name o
│ │ │ │ +0002ba80: 6620 636f 6e66 6967 7572 6174 696f 6e20  f configuration 
│ │ │ │ +0002ba90: 6669 6c65 2e0a 0a20 2020 2020 2a44 6573  file...     *Des
│ │ │ │ +0002baa0: 6372 6970 7469 6f6e 3a2a 2043 6f6e 6669  cription:* Confi
│ │ │ │ +0002bab0: 6775 7265 7320 7468 6520 7368 6973 6869  gures the shishi
│ │ │ │ +0002bac0: 206c 6962 7261 7279 2075 7369 6e67 2061   library using a
│ │ │ │ +0002bad0: 2063 6f6e 6669 6775 7261 7469 6f6e 0a20   configuration. 
│ │ │ │ +0002bae0: 2020 2020 6669 6c65 206c 6f63 6174 6564      file located
│ │ │ │ +0002baf0: 2061 7420 4346 472e 0a0a 2020 2020 202a   at CFG...     *
│ │ │ │ +0002bb00: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ +0002bb10: 6574 7572 6e73 20e2 8098 5348 4953 4849  eturns ...SHISHI
│ │ │ │ +0002bb20: 5f4f 4be2 8099 2069 6620 7375 6363 6573  _OK... if succes
│ │ │ │ +0002bb30: 7366 756c 2e0a 0a73 6869 7368 695f 6366  sful...shishi_cf
│ │ │ │ +0002bb40: 675f 7072 696e 740a 2d2d 2d2d 2d2d 2d2d  g_print.--------
│ │ │ │ +0002bb50: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ +0002bb60: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ +0002bb70: 6869 5f63 6667 5f70 7269 6e74 2028 5368  hi_cfg_print (Sh
│ │ │ │ +0002bb80: 6973 6869 202a 2048 414e 444c 452c 2046  ishi * HANDLE, F
│ │ │ │ +0002bb90: 494c 4520 2a20 4648 290a 2020 2020 2048  ILE * FH).     H
│ │ │ │ +0002bba0: 414e 444c 453a 2053 6869 7368 6920 6c69  ANDLE: Shishi li
│ │ │ │ +0002bbb0: 6272 6172 7920 6861 6e64 6c65 2063 7265  brary handle cre
│ │ │ │ +0002bbc0: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ +0002bbd0: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ +0002bbe0: 2020 4648 3a20 4669 6c65 2073 7472 6561    FH: File strea
│ │ │ │ +0002bbf0: 6d20 6861 6e64 6c65 206f 7065 6e65 6420  m handle opened 
│ │ │ │ +0002bc00: 666f 7220 7772 6974 696e 672e 0a0a 2020  for writing...  
│ │ │ │ +0002bc10: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ +0002bc20: 2a20 5072 696e 7473 206c 6962 7261 7279  * Prints library
│ │ │ │ +0002bc30: 2063 6f6e 6669 6775 7261 7469 6f6e 2073   configuration s
│ │ │ │ +0002bc40: 7461 7475 7320 746f 2046 482e 2020 5468  tatus to FH.  Th
│ │ │ │ +0002bc50: 6973 0a20 2020 2020 6675 6e63 7469 6f6e  is.     function
│ │ │ │ +0002bc60: 2069 7320 6d6f 7374 6c79 2069 6e74 656e   is mostly inten
│ │ │ │ +0002bc70: 6465 6420 666f 7220 6465 6275 6767 696e  ded for debuggin
│ │ │ │ +0002bc80: 6720 7075 7270 6f73 6573 2e0a 0a20 2020  g purposes...   
│ │ │ │ +0002bc90: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ +0002bca0: 2a20 416c 7761 7973 2072 6574 7572 6e73  * Always returns
│ │ │ │ +0002bcb0: 20e2 8098 5348 4953 4849 5f4f 4be2 8099   ...SHISHI_OK...
│ │ │ │ +0002bcc0: 2e0a 0a73 6869 7368 695f 6366 675f 6465  ...shishi_cfg_de
│ │ │ │ +0002bcd0: 6661 756c 745f 7379 7374 656d 6669 6c65  fault_systemfile
│ │ │ │ +0002bce0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ +0002bcf0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ +0002bd00: 202d 2d20 4675 6e63 7469 6f6e 3a20 636f   -- Function: co
│ │ │ │ +0002bd10: 6e73 7420 6368 6172 202a 2073 6869 7368  nst char * shish
│ │ │ │ +0002bd20: 695f 6366 675f 6465 6661 756c 745f 7379  i_cfg_default_sy
│ │ │ │ +0002bd30: 7374 656d 6669 6c65 0a20 2020 2020 2020  stemfile.       
│ │ │ │ +0002bd40: 2020 2028 5368 6973 6869 202a 2048 414e     (Shishi * HAN
│ │ │ │ +0002bd50: 444c 4529 0a20 2020 2020 4841 4e44 4c45  DLE).     HANDLE
│ │ │ │ +0002bd60: 3a20 5368 6973 6869 206c 6962 7261 7279  : Shishi library
│ │ │ │ +0002bd70: 2068 616e 646c 6520 6372 6561 7465 6420   handle created 
│ │ │ │ +0002bd80: 6279 20e2 8098 7368 6973 6869 5f69 6e69  by ...shishi_ini
│ │ │ │ +0002bd90: 7428 29e2 8099 2e0a 0a20 2020 2020 2a44  t()......     *D
│ │ │ │ +0002bda0: 6573 6372 6970 7469 6f6e 3a2a 2054 6865  escription:* The
│ │ │ │ +0002bdb0: 2073 7973 7465 6d20 636f 6e66 6967 7572   system configur
│ │ │ │ +0002bdc0: 6174 696f 6e20 6669 6c65 206e 616d 6520  ation file name 
│ │ │ │ +0002bdd0: 6973 2064 6563 6964 6564 2061 740a 2020  is decided at.  
│ │ │ │ +0002bde0: 2020 2063 6f6d 7069 6c65 2074 696d 652c     compile time,
│ │ │ │ +0002bdf0: 2062 7574 2069 7320 7265 706c 6163 6564   but is replaced
│ │ │ │ +0002be00: 2062 7920 6173 7369 676e 696e 6720 616e   by assigning an
│ │ │ │ +0002be10: 6f74 6865 7220 6669 6c65 206e 616d 6520  other file name 
│ │ │ │ +0002be20: 746f 2074 6865 0a20 2020 2020 656e 7669  to the.     envi
│ │ │ │ +0002be30: 726f 6e6d 656e 7420 7661 7269 6162 6c65  ronment variable
│ │ │ │ +0002be40: 20e2 8098 5348 4953 4849 5f43 4f4e 4649   ...SHISHI_CONFI
│ │ │ │ +0002be50: 47e2 8099 2e20 2054 6869 7320 6361 6c6c  G....  This call
│ │ │ │ +0002be60: 206f 6666 6572 7320 6120 7369 6e67 6c65   offers a single
│ │ │ │ +0002be70: 0a20 2020 2020 696e 7465 7266 6163 6520  .     interface 
│ │ │ │ +0002be80: 666f 7220 6465 7465 726d 696e 696e 6720  for determining 
│ │ │ │ +0002be90: 7468 6520 6669 6c65 206e 616d 652c 2074  the file name, t
│ │ │ │ +0002bea0: 6f20 7768 6963 6820 7468 6520 6c69 6272  o which the libr
│ │ │ │ +0002beb0: 6172 7920 7475 726e 730a 2020 2020 2066  ary turns.     f
│ │ │ │ +0002bec0: 6f72 2069 7473 2073 6574 7469 6e67 732e  or its settings.
│ │ │ │ +0002bed0: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ +0002bee0: 616c 7565 3a2a 2052 6574 7572 6e73 2066  alue:* Returns f
│ │ │ │ +0002bef0: 696c 6520 6e61 6d65 206f 6620 7072 6573  ile name of pres
│ │ │ │ +0002bf00: 656e 7420 7379 7374 656d 2063 6f6e 6669  ent system confi
│ │ │ │ +0002bf10: 6775 7261 7469 6f6e 2e0a 0a73 6869 7368  guration...shish
│ │ │ │ +0002bf20: 695f 6366 675f 6465 6661 756c 745f 7573  i_cfg_default_us
│ │ │ │ +0002bf30: 6572 6469 7265 6374 6f72 790a 2d2d 2d2d  erdirectory.----
│ │ │ │  0002bf40: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0002bf50: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ -0002bf60: 4675 6e63 7469 6f6e 3a20 636f 6e73 7420  Function: const 
│ │ │ │ -0002bf70: 6368 6172 202a 2073 6869 7368 695f 6366  char * shishi_cf
│ │ │ │ -0002bf80: 675f 6465 6661 756c 745f 7573 6572 6469  g_default_userdi
│ │ │ │ -0002bf90: 7265 6374 6f72 790a 2020 2020 2020 2020  rectory.        
│ │ │ │ -0002bfa0: 2020 2853 6869 7368 6920 2a20 4841 4e44    (Shishi * HAND
│ │ │ │ -0002bfb0: 4c45 290a 2020 2020 2048 414e 444c 453a  LE).     HANDLE:
│ │ │ │ -0002bfc0: 2053 6869 7368 6920 6c69 6272 6172 7920   Shishi library 
│ │ │ │ -0002bfd0: 6861 6e64 6c65 2063 7265 6174 6564 2062  handle created b
│ │ │ │ -0002bfe0: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ -0002bff0: 2829 e280 992e 0a0a 2020 2020 202a 4465  ()......     *De
│ │ │ │ -0002c000: 7363 7269 7074 696f 6e3a 2a20 5468 6520  scription:* The 
│ │ │ │ -0002c010: 6465 6661 756c 7420 7573 6572 2064 6972  default user dir
│ │ │ │ -0002c020: 6563 746f 7279 2c20 7265 6665 7272 6564  ectory, referred
│ │ │ │ -0002c030: 2074 6f20 666f 7220 5368 6973 6869 0a20   to for Shishi. 
│ │ │ │ -0002c040: 2020 2020 7469 636b 6574 2063 6163 6865      ticket cache
│ │ │ │ -0002c050: 2061 6e64 206f 7468 6572 2070 7572 706f   and other purpo
│ │ │ │ -0002c060: 7365 732c 2069 7320 6e6f 726d 616c 6c79  ses, is normally
│ │ │ │ -0002c070: 2063 6f6d 7075 7465 6420 6279 2061 7070   computed by app
│ │ │ │ -0002c080: 656e 6469 6e67 0a20 2020 2020 7468 6520  ending.     the 
│ │ │ │ -0002c090: 6669 7865 6420 7374 7269 6e67 2022 2f2e  fixed string "/.
│ │ │ │ -0002c0a0: 7368 6973 6869 2220 746f 2074 6865 2063  shishi" to the c
│ │ │ │ -0002c0b0: 6f6e 7465 6e74 206f 6620 7468 6520 656e  ontent of the en
│ │ │ │ -0002c0c0: 7669 726f 6e6d 656e 740a 2020 2020 2076  vironment.     v
│ │ │ │ -0002c0d0: 6172 6961 626c 6520 e280 9848 4f4d 45e2  ariable ...HOME.
│ │ │ │ -0002c0e0: 8099 2e0a 0a20 2020 2020 5468 6973 2068  .....     This h
│ │ │ │ -0002c0f0: 6172 6420 636f 6465 6420 6469 7265 6374  ard coded direct
│ │ │ │ -0002c100: 6f72 792c 2069 2e65 2e2c 2022 e280 9848  ory, i.e., "...H
│ │ │ │ -0002c110: 4f4d 45e2 8099 2f2e 7368 6973 6869 2f22  OME.../.shishi/"
│ │ │ │ -0002c120: 2c20 6361 6e20 6265 2072 6570 6c61 6365  , can be replace
│ │ │ │ -0002c130: 640a 2020 2020 2062 7920 7768 6174 6576  d.     by whatev
│ │ │ │ -0002c140: 6572 2063 6f6d 706c 6574 6520 7061 7468  er complete path
│ │ │ │ -0002c150: 2069 7320 7374 6f72 6564 2069 6e20 7468   is stored in th
│ │ │ │ -0002c160: 6520 656e 7669 726f 6e6d 656e 7420 7661  e environment va
│ │ │ │ -0002c170: 7269 6162 6c65 0a20 2020 2020 e280 9853  riable.     ...S
│ │ │ │ -0002c180: 4849 5348 495f 484f 4d45 e280 992e 0a0a  HISHI_HOME......
│ │ │ │ -0002c190: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ -0002c1a0: 7565 3a2a 2052 6574 7572 6e73 2074 6865  ue:* Returns the
│ │ │ │ -0002c1b0: 2075 7365 7227 7320 6469 7265 6374 6f72   user's director
│ │ │ │ -0002c1c0: 7920 6e61 6d65 2077 6865 7265 2074 6865  y name where the
│ │ │ │ -0002c1d0: 2053 6869 7368 690a 2020 2020 206c 6962   Shishi.     lib
│ │ │ │ -0002c1e0: 7261 7279 2077 696c 6c20 7365 6172 6368  rary will search
│ │ │ │ -0002c1f0: 2066 6f72 2063 6f6e 6669 6775 7261 7469   for configurati
│ │ │ │ -0002c200: 6f6e 2066 696c 6573 2c20 7469 636b 6574  on files, ticket
│ │ │ │ -0002c210: 2063 6163 6865 732c 0a20 2020 2020 6574   caches,.     et
│ │ │ │ -0002c220: 6365 7465 7261 2e0a 0a73 6869 7368 695f  cetera...shishi_
│ │ │ │ -0002c230: 6366 675f 7573 6572 6469 7265 6374 6f72  cfg_userdirector
│ │ │ │ -0002c240: 795f 6669 6c65 0a2d 2d2d 2d2d 2d2d 2d2d  y_file.---------
│ │ │ │ +0002bf50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ +0002bf60: 2d20 4675 6e63 7469 6f6e 3a20 636f 6e73  - Function: cons
│ │ │ │ +0002bf70: 7420 6368 6172 202a 2073 6869 7368 695f  t char * shishi_
│ │ │ │ +0002bf80: 6366 675f 6465 6661 756c 745f 7573 6572  cfg_default_user
│ │ │ │ +0002bf90: 6469 7265 6374 6f72 790a 2020 2020 2020  directory.      
│ │ │ │ +0002bfa0: 2020 2020 2853 6869 7368 6920 2a20 4841      (Shishi * HA
│ │ │ │ +0002bfb0: 4e44 4c45 290a 2020 2020 2048 414e 444c  NDLE).     HANDL
│ │ │ │ +0002bfc0: 453a 2053 6869 7368 6920 6c69 6272 6172  E: Shishi librar
│ │ │ │ +0002bfd0: 7920 6861 6e64 6c65 2063 7265 6174 6564  y handle created
│ │ │ │ +0002bfe0: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ +0002bff0: 6974 2829 e280 992e 0a0a 2020 2020 202a  it()......     *
│ │ │ │ +0002c000: 4465 7363 7269 7074 696f 6e3a 2a20 5468  Description:* Th
│ │ │ │ +0002c010: 6520 6465 6661 756c 7420 7573 6572 2064  e default user d
│ │ │ │ +0002c020: 6972 6563 746f 7279 2c20 7265 6665 7272  irectory, referr
│ │ │ │ +0002c030: 6564 2074 6f20 666f 7220 5368 6973 6869  ed to for Shishi
│ │ │ │ +0002c040: 0a20 2020 2020 7469 636b 6574 2063 6163  .     ticket cac
│ │ │ │ +0002c050: 6865 2061 6e64 206f 7468 6572 2070 7572  he and other pur
│ │ │ │ +0002c060: 706f 7365 732c 2069 7320 6e6f 726d 616c  poses, is normal
│ │ │ │ +0002c070: 6c79 2063 6f6d 7075 7465 6420 6279 2061  ly computed by a
│ │ │ │ +0002c080: 7070 656e 6469 6e67 0a20 2020 2020 7468  ppending.     th
│ │ │ │ +0002c090: 6520 6669 7865 6420 7374 7269 6e67 2022  e fixed string "
│ │ │ │ +0002c0a0: 2f2e 7368 6973 6869 2220 746f 2074 6865  /.shishi" to the
│ │ │ │ +0002c0b0: 2063 6f6e 7465 6e74 206f 6620 7468 6520   content of the 
│ │ │ │ +0002c0c0: 656e 7669 726f 6e6d 656e 740a 2020 2020  environment.    
│ │ │ │ +0002c0d0: 2076 6172 6961 626c 6520 e280 9848 4f4d   variable ...HOM
│ │ │ │ +0002c0e0: 45e2 8099 2e0a 0a20 2020 2020 5468 6973  E......     This
│ │ │ │ +0002c0f0: 2068 6172 6420 636f 6465 6420 6469 7265   hard coded dire
│ │ │ │ +0002c100: 6374 6f72 792c 2069 2e65 2e2c 2022 e280  ctory, i.e., "..
│ │ │ │ +0002c110: 9848 4f4d 45e2 8099 2f2e 7368 6973 6869  .HOME.../.shishi
│ │ │ │ +0002c120: 2f22 2c20 6361 6e20 6265 2072 6570 6c61  /", can be repla
│ │ │ │ +0002c130: 6365 640a 2020 2020 2062 7920 7768 6174  ced.     by what
│ │ │ │ +0002c140: 6576 6572 2063 6f6d 706c 6574 6520 7061  ever complete pa
│ │ │ │ +0002c150: 7468 2069 7320 7374 6f72 6564 2069 6e20  th is stored in 
│ │ │ │ +0002c160: 7468 6520 656e 7669 726f 6e6d 656e 7420  the environment 
│ │ │ │ +0002c170: 7661 7269 6162 6c65 0a20 2020 2020 e280  variable.     ..
│ │ │ │ +0002c180: 9853 4849 5348 495f 484f 4d45 e280 992e  .SHISHI_HOME....
│ │ │ │ +0002c190: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ +0002c1a0: 616c 7565 3a2a 2052 6574 7572 6e73 2074  alue:* Returns t
│ │ │ │ +0002c1b0: 6865 2075 7365 7227 7320 6469 7265 6374  he user's direct
│ │ │ │ +0002c1c0: 6f72 7920 6e61 6d65 2077 6865 7265 2074  ory name where t
│ │ │ │ +0002c1d0: 6865 2053 6869 7368 690a 2020 2020 206c  he Shishi.     l
│ │ │ │ +0002c1e0: 6962 7261 7279 2077 696c 6c20 7365 6172  ibrary will sear
│ │ │ │ +0002c1f0: 6368 2066 6f72 2063 6f6e 6669 6775 7261  ch for configura
│ │ │ │ +0002c200: 7469 6f6e 2066 696c 6573 2c20 7469 636b  tion files, tick
│ │ │ │ +0002c210: 6574 2063 6163 6865 732c 0a20 2020 2020  et caches,.     
│ │ │ │ +0002c220: 6574 6365 7465 7261 2e0a 0a73 6869 7368  etcetera...shish
│ │ │ │ +0002c230: 695f 6366 675f 7573 6572 6469 7265 6374  i_cfg_userdirect
│ │ │ │ +0002c240: 6f72 795f 6669 6c65 0a2d 2d2d 2d2d 2d2d  ory_file.-------
│ │ │ │  0002c250: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0002c260: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -0002c270: 6f6e 3a20 6368 6172 202a 2073 6869 7368  on: char * shish
│ │ │ │ -0002c280: 695f 6366 675f 7573 6572 6469 7265 6374  i_cfg_userdirect
│ │ │ │ -0002c290: 6f72 795f 6669 6c65 2028 5368 6973 6869  ory_file (Shishi
│ │ │ │ -0002c2a0: 202a 2048 414e 444c 452c 0a20 2020 2020   * HANDLE,.     
│ │ │ │ -0002c2b0: 2020 2020 2063 6f6e 7374 2063 6861 7220       const char 
│ │ │ │ -0002c2c0: 2a20 4649 4c45 290a 2020 2020 2048 414e  * FILE).     HAN
│ │ │ │ -0002c2d0: 444c 453a 2053 6869 7368 6920 6c69 6272  DLE: Shishi libr
│ │ │ │ -0002c2e0: 6172 7920 6861 6e64 6c65 2063 7265 6174  ary handle creat
│ │ │ │ -0002c2f0: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ -0002c300: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ -0002c310: 4649 4c45 3a20 4261 7365 6e61 6d65 206f  FILE: Basename o
│ │ │ │ -0002c320: 6620 6669 6c65 2074 6f20 7573 6520 666f  f file to use fo
│ │ │ │ -0002c330: 7220 7468 6520 7573 6572 2773 2063 6f6e  r the user's con
│ │ │ │ -0002c340: 6669 6775 7261 7469 6f6e 2073 6574 7469  figuration setti
│ │ │ │ -0002c350: 6e67 730a 2020 2020 206f 6620 7468 6520  ngs.     of the 
│ │ │ │ -0002c360: 6c69 6272 6172 792e 0a0a 2020 2020 202a  library...     *
│ │ │ │ -0002c370: 4465 7363 7269 7074 696f 6e3a 2a20 5265  Description:* Re
│ │ │ │ -0002c380: 706f 7274 7320 7468 6520 6675 6c6c 2070  ports the full p
│ │ │ │ -0002c390: 6174 6820 746f 2074 6865 2066 696c 6520  ath to the file 
│ │ │ │ -0002c3a0: 7768 6572 6520 7468 6520 5368 6973 6869  where the Shishi
│ │ │ │ -0002c3b0: 0a20 2020 2020 6c69 6272 6172 7920 6578  .     library ex
│ │ │ │ -0002c3c0: 7065 6374 7320 746f 2066 696e 6420 7468  pects to find th
│ │ │ │ -0002c3d0: 6520 7573 6572 2773 206c 6962 7261 7279  e user's library
│ │ │ │ -0002c3e0: 2063 6f6e 6669 6775 7261 7469 6f6e 2c20   configuration, 
│ │ │ │ -0002c3f0: 6769 7665 6e0a 2020 2020 2074 6861 7420  given.     that 
│ │ │ │ -0002c400: 7468 6520 6669 6c65 2069 7473 656c 6620  the file itself 
│ │ │ │ -0002c410: 6973 206e 616d 6564 2062 7920 7468 6520  is named by the 
│ │ │ │ -0002c420: 7061 7261 6d65 7465 7220 4649 4c45 2e0a  parameter FILE..
│ │ │ │ -0002c430: 0a20 2020 2020 5468 6520 616e 7377 6572  .     The answer
│ │ │ │ -0002c440: 2069 7320 636f 6d70 6f73 6564 2066 726f   is composed fro
│ │ │ │ -0002c450: 6d20 7468 6520 7661 6c75 6520 6f66 2046  m the value of F
│ │ │ │ -0002c460: 494c 4520 616e 6420 7468 6520 6469 7265  ILE and the dire
│ │ │ │ -0002c470: 6374 6f72 790a 2020 2020 2072 6574 7572  ctory.     retur
│ │ │ │ -0002c480: 6e65 6420 6279 20e2 8098 7368 6973 6869  ned by ...shishi
│ │ │ │ -0002c490: 5f63 6667 5f64 6566 6175 6c74 5f75 7365  _cfg_default_use
│ │ │ │ -0002c4a0: 7264 6972 6563 746f 7279 2829 e280 992e  rdirectory()....
│ │ │ │ -0002c4b0: 2020 5479 7069 6361 6c6c 792c 2074 6865    Typically, the
│ │ │ │ -0002c4c0: 0a20 2020 2020 7265 7475 726e 6564 2073  .     returned s
│ │ │ │ -0002c4d0: 7472 696e 6720 776f 756c 6420 6265 2065  tring would be e
│ │ │ │ -0002c4e0: 7870 616e 6465 6420 6672 6f6d 2022 e280  xpanded from "..
│ │ │ │ -0002c4f0: 9848 4f4d 45e2 8099 2f2e 7368 6973 6869  .HOME.../.shishi
│ │ │ │ -0002c500: 2f46 494c 4522 2e0a 0a20 2020 2020 2a52  /FILE"...     *R
│ │ │ │ -0002c510: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ -0002c520: 7475 726e 7320 7468 6520 6162 736f 6c75  turns the absolu
│ │ │ │ -0002c530: 7465 2066 696c 656e 616d 6520 746f 2074  te filename to t
│ │ │ │ -0002c540: 6865 2061 7267 756d 656e 7420 4649 4c45  he argument FILE
│ │ │ │ -0002c550: 2c0a 2020 2020 2072 656c 6174 6976 6520  ,.     relative 
│ │ │ │ -0002c560: 746f 2074 6865 2075 7365 7220 7370 6563  to the user spec
│ │ │ │ -0002c570: 6966 6963 2053 6869 7368 6920 636f 6e66  ific Shishi conf
│ │ │ │ -0002c580: 6967 7572 6174 696f 6e20 6469 7265 6374  iguration direct
│ │ │ │ -0002c590: 6f72 792e 0a0a 7368 6973 6869 5f63 6667  ory...shishi_cfg
│ │ │ │ -0002c5a0: 5f64 6566 6175 6c74 5f75 7365 7266 696c  _default_userfil
│ │ │ │ -0002c5b0: 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  e.--------------
│ │ │ │ -0002c5c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -0002c5d0: 2d2d 2046 756e 6374 696f 6e3a 2063 6f6e  -- Function: con
│ │ │ │ -0002c5e0: 7374 2063 6861 7220 2a20 7368 6973 6869  st char * shishi
│ │ │ │ -0002c5f0: 5f63 6667 5f64 6566 6175 6c74 5f75 7365  _cfg_default_use
│ │ │ │ -0002c600: 7266 696c 6520 2853 6869 7368 6920 2a20  rfile (Shishi * 
│ │ │ │ -0002c610: 4841 4e44 4c45 290a 2020 2020 2048 414e  HANDLE).     HAN
│ │ │ │ -0002c620: 444c 453a 2053 6869 7368 6920 6c69 6272  DLE: Shishi libr
│ │ │ │ -0002c630: 6172 7920 6861 6e64 6c65 2063 7265 6174  ary handle creat
│ │ │ │ -0002c640: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ -0002c650: 696e 6974 2829 e280 992e 0a0a 2020 2020  init()......    
│ │ │ │ -0002c660: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ -0002c670: 5265 706f 7274 7320 7468 6520 6162 736f  Reports the abso
│ │ │ │ -0002c680: 6c75 7465 2066 696c 656e 616d 6520 6f66  lute filename of
│ │ │ │ -0002c690: 2074 6865 2064 6566 6175 6c74 2075 7365   the default use
│ │ │ │ -0002c6a0: 720a 2020 2020 2063 6f6e 6669 6775 7261  r.     configura
│ │ │ │ -0002c6b0: 7469 6f6e 2066 696c 652e 2020 5468 6973  tion file.  This
│ │ │ │ -0002c6c0: 2069 7320 7479 7069 6361 6c6c 790a 2020   is typically.  
│ │ │ │ -0002c6d0: 2020 2022 e280 9848 4f4d 45e2 8099 2f2e     "...HOME.../.
│ │ │ │ -0002c6e0: 7368 6973 6869 2f73 6869 7368 692e 636f  shishi/shishi.co
│ │ │ │ -0002c6f0: 6e66 222e 0a0a 2020 2020 2054 6865 2076  nf"...     The v
│ │ │ │ -0002c700: 616c 7565 206f 6620 e280 9853 4849 5348  alue of ...SHISH
│ │ │ │ -0002c710: 495f 484f 4d45 e280 9920 7769 6c6c 2063  I_HOME... will c
│ │ │ │ -0002c720: 6861 6e67 6520 7468 6520 6469 7265 6374  hange the direct
│ │ │ │ -0002c730: 6f72 7920 7061 7274 2c20 6173 0a20 2020  ory part, as.   
│ │ │ │ -0002c740: 2020 7374 6174 6564 2072 6567 6172 6469    stated regardi
│ │ │ │ -0002c750: 6e67 20e2 8098 7368 6973 6869 5f63 6667  ng ...shishi_cfg
│ │ │ │ -0002c760: 5f64 6566 6175 6c74 5f75 7365 7264 6972  _default_userdir
│ │ │ │ -0002c770: 6563 746f 7279 2829 e280 992e 0a0a 2020  ectory()......  
│ │ │ │ -0002c780: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ -0002c790: 3a2a 2052 6574 7572 6e73 2074 6865 2075  :* Returns the u
│ │ │ │ -0002c7a0: 7365 7227 7320 636f 6e66 6967 7572 6174  ser's configurat
│ │ │ │ -0002c7b0: 696f 6e20 6669 6c65 6e61 6d65 2e0a 0a73  ion filename...s
│ │ │ │ -0002c7c0: 6869 7368 695f 6366 675f 636c 6965 6e74  hishi_cfg_client
│ │ │ │ -0002c7d0: 6b64 6365 7479 7065 0a2d 2d2d 2d2d 2d2d  kdcetype.-------
│ │ │ │ +0002c260: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ +0002c270: 7469 6f6e 3a20 6368 6172 202a 2073 6869  tion: char * shi
│ │ │ │ +0002c280: 7368 695f 6366 675f 7573 6572 6469 7265  shi_cfg_userdire
│ │ │ │ +0002c290: 6374 6f72 795f 6669 6c65 2028 5368 6973  ctory_file (Shis
│ │ │ │ +0002c2a0: 6869 202a 2048 414e 444c 452c 0a20 2020  hi * HANDLE,.   
│ │ │ │ +0002c2b0: 2020 2020 2020 2063 6f6e 7374 2063 6861         const cha
│ │ │ │ +0002c2c0: 7220 2a20 4649 4c45 290a 2020 2020 2048  r * FILE).     H
│ │ │ │ +0002c2d0: 414e 444c 453a 2053 6869 7368 6920 6c69  ANDLE: Shishi li
│ │ │ │ +0002c2e0: 6272 6172 7920 6861 6e64 6c65 2063 7265  brary handle cre
│ │ │ │ +0002c2f0: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ +0002c300: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ +0002c310: 2020 4649 4c45 3a20 4261 7365 6e61 6d65    FILE: Basename
│ │ │ │ +0002c320: 206f 6620 6669 6c65 2074 6f20 7573 6520   of file to use 
│ │ │ │ +0002c330: 666f 7220 7468 6520 7573 6572 2773 2063  for the user's c
│ │ │ │ +0002c340: 6f6e 6669 6775 7261 7469 6f6e 2073 6574  onfiguration set
│ │ │ │ +0002c350: 7469 6e67 730a 2020 2020 206f 6620 7468  tings.     of th
│ │ │ │ +0002c360: 6520 6c69 6272 6172 792e 0a0a 2020 2020  e library...    
│ │ │ │ +0002c370: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ +0002c380: 5265 706f 7274 7320 7468 6520 6675 6c6c  Reports the full
│ │ │ │ +0002c390: 2070 6174 6820 746f 2074 6865 2066 696c   path to the fil
│ │ │ │ +0002c3a0: 6520 7768 6572 6520 7468 6520 5368 6973  e where the Shis
│ │ │ │ +0002c3b0: 6869 0a20 2020 2020 6c69 6272 6172 7920  hi.     library 
│ │ │ │ +0002c3c0: 6578 7065 6374 7320 746f 2066 696e 6420  expects to find 
│ │ │ │ +0002c3d0: 7468 6520 7573 6572 2773 206c 6962 7261  the user's libra
│ │ │ │ +0002c3e0: 7279 2063 6f6e 6669 6775 7261 7469 6f6e  ry configuration
│ │ │ │ +0002c3f0: 2c20 6769 7665 6e0a 2020 2020 2074 6861  , given.     tha
│ │ │ │ +0002c400: 7420 7468 6520 6669 6c65 2069 7473 656c  t the file itsel
│ │ │ │ +0002c410: 6620 6973 206e 616d 6564 2062 7920 7468  f is named by th
│ │ │ │ +0002c420: 6520 7061 7261 6d65 7465 7220 4649 4c45  e parameter FILE
│ │ │ │ +0002c430: 2e0a 0a20 2020 2020 5468 6520 616e 7377  ...     The answ
│ │ │ │ +0002c440: 6572 2069 7320 636f 6d70 6f73 6564 2066  er is composed f
│ │ │ │ +0002c450: 726f 6d20 7468 6520 7661 6c75 6520 6f66  rom the value of
│ │ │ │ +0002c460: 2046 494c 4520 616e 6420 7468 6520 6469   FILE and the di
│ │ │ │ +0002c470: 7265 6374 6f72 790a 2020 2020 2072 6574  rectory.     ret
│ │ │ │ +0002c480: 7572 6e65 6420 6279 20e2 8098 7368 6973  urned by ...shis
│ │ │ │ +0002c490: 6869 5f63 6667 5f64 6566 6175 6c74 5f75  hi_cfg_default_u
│ │ │ │ +0002c4a0: 7365 7264 6972 6563 746f 7279 2829 e280  serdirectory()..
│ │ │ │ +0002c4b0: 992e 2020 5479 7069 6361 6c6c 792c 2074  ..  Typically, t
│ │ │ │ +0002c4c0: 6865 0a20 2020 2020 7265 7475 726e 6564  he.     returned
│ │ │ │ +0002c4d0: 2073 7472 696e 6720 776f 756c 6420 6265   string would be
│ │ │ │ +0002c4e0: 2065 7870 616e 6465 6420 6672 6f6d 2022   expanded from "
│ │ │ │ +0002c4f0: e280 9848 4f4d 45e2 8099 2f2e 7368 6973  ...HOME.../.shis
│ │ │ │ +0002c500: 6869 2f46 494c 4522 2e0a 0a20 2020 2020  hi/FILE"...     
│ │ │ │ +0002c510: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ +0002c520: 5265 7475 726e 7320 7468 6520 6162 736f  Returns the abso
│ │ │ │ +0002c530: 6c75 7465 2066 696c 656e 616d 6520 746f  lute filename to
│ │ │ │ +0002c540: 2074 6865 2061 7267 756d 656e 7420 4649   the argument FI
│ │ │ │ +0002c550: 4c45 2c0a 2020 2020 2072 656c 6174 6976  LE,.     relativ
│ │ │ │ +0002c560: 6520 746f 2074 6865 2075 7365 7220 7370  e to the user sp
│ │ │ │ +0002c570: 6563 6966 6963 2053 6869 7368 6920 636f  ecific Shishi co
│ │ │ │ +0002c580: 6e66 6967 7572 6174 696f 6e20 6469 7265  nfiguration dire
│ │ │ │ +0002c590: 6374 6f72 792e 0a0a 7368 6973 6869 5f63  ctory...shishi_c
│ │ │ │ +0002c5a0: 6667 5f64 6566 6175 6c74 5f75 7365 7266  fg_default_userf
│ │ │ │ +0002c5b0: 696c 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ile.------------
│ │ │ │ +0002c5c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +0002c5d0: 0a20 2d2d 2046 756e 6374 696f 6e3a 2063  . -- Function: c
│ │ │ │ +0002c5e0: 6f6e 7374 2063 6861 7220 2a20 7368 6973  onst char * shis
│ │ │ │ +0002c5f0: 6869 5f63 6667 5f64 6566 6175 6c74 5f75  hi_cfg_default_u
│ │ │ │ +0002c600: 7365 7266 696c 6520 2853 6869 7368 6920  serfile (Shishi 
│ │ │ │ +0002c610: 2a20 4841 4e44 4c45 290a 2020 2020 2048  * HANDLE).     H
│ │ │ │ +0002c620: 414e 444c 453a 2053 6869 7368 6920 6c69  ANDLE: Shishi li
│ │ │ │ +0002c630: 6272 6172 7920 6861 6e64 6c65 2063 7265  brary handle cre
│ │ │ │ +0002c640: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ +0002c650: 695f 696e 6974 2829 e280 992e 0a0a 2020  i_init()......  
│ │ │ │ +0002c660: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ +0002c670: 2a20 5265 706f 7274 7320 7468 6520 6162  * Reports the ab
│ │ │ │ +0002c680: 736f 6c75 7465 2066 696c 656e 616d 6520  solute filename 
│ │ │ │ +0002c690: 6f66 2074 6865 2064 6566 6175 6c74 2075  of the default u
│ │ │ │ +0002c6a0: 7365 720a 2020 2020 2063 6f6e 6669 6775  ser.     configu
│ │ │ │ +0002c6b0: 7261 7469 6f6e 2066 696c 652e 2020 5468  ration file.  Th
│ │ │ │ +0002c6c0: 6973 2069 7320 7479 7069 6361 6c6c 790a  is is typically.
│ │ │ │ +0002c6d0: 2020 2020 2022 e280 9848 4f4d 45e2 8099       "...HOME...
│ │ │ │ +0002c6e0: 2f2e 7368 6973 6869 2f73 6869 7368 692e  /.shishi/shishi.
│ │ │ │ +0002c6f0: 636f 6e66 222e 0a0a 2020 2020 2054 6865  conf"...     The
│ │ │ │ +0002c700: 2076 616c 7565 206f 6620 e280 9853 4849   value of ...SHI
│ │ │ │ +0002c710: 5348 495f 484f 4d45 e280 9920 7769 6c6c  SHI_HOME... will
│ │ │ │ +0002c720: 2063 6861 6e67 6520 7468 6520 6469 7265   change the dire
│ │ │ │ +0002c730: 6374 6f72 7920 7061 7274 2c20 6173 0a20  ctory part, as. 
│ │ │ │ +0002c740: 2020 2020 7374 6174 6564 2072 6567 6172      stated regar
│ │ │ │ +0002c750: 6469 6e67 20e2 8098 7368 6973 6869 5f63  ding ...shishi_c
│ │ │ │ +0002c760: 6667 5f64 6566 6175 6c74 5f75 7365 7264  fg_default_userd
│ │ │ │ +0002c770: 6972 6563 746f 7279 2829 e280 992e 0a0a  irectory()......
│ │ │ │ +0002c780: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ +0002c790: 7565 3a2a 2052 6574 7572 6e73 2074 6865  ue:* Returns the
│ │ │ │ +0002c7a0: 2075 7365 7227 7320 636f 6e66 6967 7572   user's configur
│ │ │ │ +0002c7b0: 6174 696f 6e20 6669 6c65 6e61 6d65 2e0a  ation filename..
│ │ │ │ +0002c7c0: 0a73 6869 7368 695f 6366 675f 636c 6965  .shishi_cfg_clie
│ │ │ │ +0002c7d0: 6e74 6b64 6365 7479 7065 0a2d 2d2d 2d2d  ntkdcetype.-----
│ │ │ │  0002c7e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0002c7f0: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ -0002c800: 3a20 696e 7420 7368 6973 6869 5f63 6667  : int shishi_cfg
│ │ │ │ -0002c810: 5f63 6c69 656e 746b 6463 6574 7970 6520  _clientkdcetype 
│ │ │ │ -0002c820: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ -0002c830: 2c0a 2020 2020 2020 2020 2020 696e 7433  ,.          int3
│ │ │ │ -0002c840: 325f 7420 2a2a 2045 5459 5045 5329 0a20  2_t ** ETYPES). 
│ │ │ │ -0002c850: 2020 2020 4841 4e44 4c45 3a20 5368 6973      HANDLE: Shis
│ │ │ │ -0002c860: 6869 206c 6962 7261 7279 2068 616e 646c  hi library handl
│ │ │ │ -0002c870: 6520 6372 6561 7465 6420 6279 20e2 8098  e created by ...
│ │ │ │ -0002c880: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ -0002c890: 2e0a 2020 2020 2045 5459 5045 533a 2050  ..     ETYPES: P
│ │ │ │ -0002c8a0: 6f69 6e74 6572 2074 6f20 616e 2061 7272  ointer to an arr
│ │ │ │ -0002c8b0: 6179 206f 6620 656e 6372 7970 7469 6f6e  ay of encryption
│ │ │ │ -0002c8c0: 2074 7970 6573 2e0a 0a20 2020 2020 2a44   types...     *D
│ │ │ │ -0002c8d0: 6573 6372 6970 7469 6f6e 3a2a 2053 6574  escription:* Set
│ │ │ │ -0002c8e0: 7320 7468 6520 7661 7269 6162 6c65 2045  s the variable E
│ │ │ │ -0002c8f0: 5459 5045 5320 746f 2061 2073 7461 7469  TYPES to a stati
│ │ │ │ -0002c900: 6320 6172 7261 7920 6f66 0a20 2020 2020  c array of.     
│ │ │ │ -0002c910: 7072 6566 6572 7265 6420 656e 6372 7970  preferred encryp
│ │ │ │ -0002c920: 7469 6f6e 2074 7970 6573 2061 7070 6c69  tion types appli
│ │ │ │ -0002c930: 6361 626c 6520 746f 2063 6c69 656e 7473  cable to clients
│ │ │ │ -0002c940: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ -0002c950: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ -0002c960: 7468 6520 6e75 6d62 6572 206f 6620 656e  the number of en
│ │ │ │ -0002c970: 6372 7970 7469 6f6e 2074 7970 6573 2072  cryption types r
│ │ │ │ -0002c980: 6566 6572 7265 6420 746f 0a20 2020 2020  eferred to.     
│ │ │ │ -0002c990: 6279 2074 6865 2075 7064 6174 6564 2061  by the updated a
│ │ │ │ -0002c9a0: 7272 6179 2070 6f69 6e74 6572 2c20 6f72  rray pointer, or
│ │ │ │ -0002c9b0: 207a 6572 6f2c 2073 686f 756c 6420 6e6f   zero, should no
│ │ │ │ -0002c9c0: 2074 7970 6520 6578 6973 742e 0a0a 7368   type exist...sh
│ │ │ │ -0002c9d0: 6973 6869 5f63 6667 5f63 6c69 656e 746b  ishi_cfg_clientk
│ │ │ │ -0002c9e0: 6463 6574 7970 655f 6661 7374 0a2d 2d2d  dcetype_fast.---
│ │ │ │ +0002c7f0: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ +0002c800: 6f6e 3a20 696e 7420 7368 6973 6869 5f63  on: int shishi_c
│ │ │ │ +0002c810: 6667 5f63 6c69 656e 746b 6463 6574 7970  fg_clientkdcetyp
│ │ │ │ +0002c820: 6520 2853 6869 7368 6920 2a20 4841 4e44  e (Shishi * HAND
│ │ │ │ +0002c830: 4c45 2c0a 2020 2020 2020 2020 2020 696e  LE,.          in
│ │ │ │ +0002c840: 7433 325f 7420 2a2a 2045 5459 5045 5329  t32_t ** ETYPES)
│ │ │ │ +0002c850: 0a20 2020 2020 4841 4e44 4c45 3a20 5368  .     HANDLE: Sh
│ │ │ │ +0002c860: 6973 6869 206c 6962 7261 7279 2068 616e  ishi library han
│ │ │ │ +0002c870: 646c 6520 6372 6561 7465 6420 6279 20e2  dle created by .
│ │ │ │ +0002c880: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ +0002c890: 8099 2e0a 2020 2020 2045 5459 5045 533a  ....     ETYPES:
│ │ │ │ +0002c8a0: 2050 6f69 6e74 6572 2074 6f20 616e 2061   Pointer to an a
│ │ │ │ +0002c8b0: 7272 6179 206f 6620 656e 6372 7970 7469  rray of encrypti
│ │ │ │ +0002c8c0: 6f6e 2074 7970 6573 2e0a 0a20 2020 2020  on types...     
│ │ │ │ +0002c8d0: 2a44 6573 6372 6970 7469 6f6e 3a2a 2053  *Description:* S
│ │ │ │ +0002c8e0: 6574 7320 7468 6520 7661 7269 6162 6c65  ets the variable
│ │ │ │ +0002c8f0: 2045 5459 5045 5320 746f 2061 2073 7461   ETYPES to a sta
│ │ │ │ +0002c900: 7469 6320 6172 7261 7920 6f66 0a20 2020  tic array of.   
│ │ │ │ +0002c910: 2020 7072 6566 6572 7265 6420 656e 6372    preferred encr
│ │ │ │ +0002c920: 7970 7469 6f6e 2074 7970 6573 2061 7070  yption types app
│ │ │ │ +0002c930: 6c69 6361 626c 6520 746f 2063 6c69 656e  licable to clien
│ │ │ │ +0002c940: 7473 2e0a 0a20 2020 2020 2a52 6574 7572  ts...     *Retur
│ │ │ │ +0002c950: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ +0002c960: 7320 7468 6520 6e75 6d62 6572 206f 6620  s the number of 
│ │ │ │ +0002c970: 656e 6372 7970 7469 6f6e 2074 7970 6573  encryption types
│ │ │ │ +0002c980: 2072 6566 6572 7265 6420 746f 0a20 2020   referred to.   
│ │ │ │ +0002c990: 2020 6279 2074 6865 2075 7064 6174 6564    by the updated
│ │ │ │ +0002c9a0: 2061 7272 6179 2070 6f69 6e74 6572 2c20   array pointer, 
│ │ │ │ +0002c9b0: 6f72 207a 6572 6f2c 2073 686f 756c 6420  or zero, should 
│ │ │ │ +0002c9c0: 6e6f 2074 7970 6520 6578 6973 742e 0a0a  no type exist...
│ │ │ │ +0002c9d0: 7368 6973 6869 5f63 6667 5f63 6c69 656e  shishi_cfg_clien
│ │ │ │ +0002c9e0: 746b 6463 6574 7970 655f 6661 7374 0a2d  tkdcetype_fast.-
│ │ │ │  0002c9f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0002ca00: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ -0002ca10: 2046 756e 6374 696f 6e3a 2069 6e74 3332   Function: int32
│ │ │ │ -0002ca20: 5f74 2073 6869 7368 695f 6366 675f 636c  _t shishi_cfg_cl
│ │ │ │ -0002ca30: 6965 6e74 6b64 6365 7479 7065 5f66 6173  ientkdcetype_fas
│ │ │ │ -0002ca40: 7420 2853 6869 7368 6920 2a20 4841 4e44  t (Shishi * HAND
│ │ │ │ -0002ca50: 4c45 290a 2020 2020 2048 414e 444c 453a  LE).     HANDLE:
│ │ │ │ -0002ca60: 2053 6869 7368 6920 6c69 6272 6172 7920   Shishi library 
│ │ │ │ -0002ca70: 6861 6e64 6c65 2063 7265 6174 6564 2062  handle created b
│ │ │ │ -0002ca80: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ -0002ca90: 2829 e280 992e 0a0a 2020 2020 202a 4465  ()......     *De
│ │ │ │ -0002caa0: 7363 7269 7074 696f 6e3a 2a20 4578 7472  scription:* Extr
│ │ │ │ -0002cab0: 6163 7473 2074 6865 2064 6566 6175 6c74  acts the default
│ │ │ │ -0002cac0: 2065 6e63 7279 7074 696f 6e20 7479 7065   encryption type
│ │ │ │ -0002cad0: 2066 726f 6d20 7468 6520 6c69 7374 0a20   from the list. 
│ │ │ │ -0002cae0: 2020 2020 6f66 2070 7265 6665 7272 6564      of preferred
│ │ │ │ -0002caf0: 2065 6e63 7279 7074 696f 6e20 7479 7065   encryption type
│ │ │ │ -0002cb00: 7320 6163 6365 7074 6162 6c65 2074 6f20  s acceptable to 
│ │ │ │ -0002cb10: 7468 6520 636c 6965 6e74 2e0a 0a20 2020  the client...   
│ │ │ │ -0002cb20: 2020 5768 656e 2074 6865 2070 7265 6665    When the prefe
│ │ │ │ -0002cb30: 7272 6564 206c 6973 7420 6973 2065 6d70  rred list is emp
│ │ │ │ -0002cb40: 7479 2c20 e280 9853 4849 5348 495f 4145  ty, ...SHISHI_AE
│ │ │ │ -0002cb50: 5332 3536 5f43 5453 5f48 4d41 435f 5348  S256_CTS_HMAC_SH
│ │ │ │ -0002cb60: 4131 5f39 36e2 8099 0a20 2020 2020 6973  A1_96....     is
│ │ │ │ -0002cb70: 2072 6574 7572 6e65 6420 6173 2061 2073   returned as a s
│ │ │ │ -0002cb80: 656e 7369 626c 6520 6465 6661 756c 7420  ensible default 
│ │ │ │ -0002cb90: 7479 7065 2e0a 0a20 2020 2020 2a52 6574  type...     *Ret
│ │ │ │ -0002cba0: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ -0002cbb0: 726e 7320 7468 6520 6465 6661 756c 7420  rns the default 
│ │ │ │ -0002cbc0: 656e 6372 7970 7469 6f6e 2074 7970 652e  encryption type.
│ │ │ │ -0002cbd0: 0a0a 7368 6973 6869 5f63 6667 5f63 6c69  ..shishi_cfg_cli
│ │ │ │ -0002cbe0: 656e 746b 6463 6574 7970 655f 7365 740a  entkdcetype_set.
│ │ │ │ -0002cbf0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0002cc00: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -0002cc10: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ -0002cc20: 2073 6869 7368 695f 6366 675f 636c 6965   shishi_cfg_clie
│ │ │ │ -0002cc30: 6e74 6b64 6365 7479 7065 5f73 6574 2028  ntkdcetype_set (
│ │ │ │ -0002cc40: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ -0002cc50: 0a20 2020 2020 2020 2020 2063 6861 7220  .          char 
│ │ │ │ -0002cc60: 2a20 5641 4c55 4529 0a20 2020 2020 4841  * VALUE).     HA
│ │ │ │ -0002cc70: 4e44 4c45 3a20 5368 6973 6869 206c 6962  NDLE: Shishi lib
│ │ │ │ -0002cc80: 7261 7279 2068 616e 646c 6520 6372 6561  rary handle crea
│ │ │ │ -0002cc90: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ -0002cca0: 5f69 6e69 7428 29e2 8099 2e0a 2020 2020  _init().....    
│ │ │ │ -0002ccb0: 2056 414c 5545 3a20 5374 7269 6e67 206e   VALUE: String n
│ │ │ │ -0002ccc0: 616d 696e 6720 6163 6365 7074 6162 6c65  aming acceptable
│ │ │ │ -0002ccd0: 2065 6e63 7279 7074 696f 6e20 7479 7065   encryption type
│ │ │ │ -0002cce0: 732e 0a0a 2020 2020 202a 4465 7363 7269  s...     *Descri
│ │ │ │ -0002ccf0: 7074 696f 6e3a 2a20 5365 7473 2074 6865  ption:* Sets the
│ │ │ │ -0002cd00: 2063 6f6e 6669 6775 7261 7469 6f6e 206f   configuration o
│ │ │ │ -0002cd10: 7074 696f 6e20 2263 6c69 656e 742d 6b64  ption "client-kd
│ │ │ │ -0002cd20: 632d 6574 7970 6573 220a 2020 2020 2066  c-etypes".     f
│ │ │ │ -0002cd30: 726f 6d20 5641 4c55 452e 2020 5468 6520  rom VALUE.  The 
│ │ │ │ -0002cd40: 7374 7269 6e67 2063 6f6e 7461 696e 7320  string contains 
│ │ │ │ -0002cd50: 656e 6372 7970 7469 6f6e 2074 7970 6573  encryption types
│ │ │ │ -0002cd60: 2c20 696e 7465 6765 7273 206f 720a 2020  , integers or.  
│ │ │ │ -0002cd70: 2020 206e 616d 6573 2c20 7365 7061 7261     names, separa
│ │ │ │ -0002cd80: 7465 6420 6279 2063 6f6d 6d61 206f 7220  ted by comma or 
│ │ │ │ -0002cd90: 6279 2077 6869 7465 7370 6163 652e 2020  by whitespace.  
│ │ │ │ -0002cda0: 416e 2065 7861 6d70 6c65 206e 616d 696e  An example namin
│ │ │ │ -0002cdb0: 670a 2020 2020 2074 6872 6565 2065 6e63  g.     three enc
│ │ │ │ -0002cdc0: 7279 7074 696f 6e20 7479 7065 7320 636f  ryption types co
│ │ │ │ -0002cdd0: 756c 6420 6265 3a0a 0a20 2020 2020 6165  uld be:..     ae
│ │ │ │ -0002cde0: 7332 3536 2d63 7473 2d68 6d61 632d 7368  s256-cts-hmac-sh
│ │ │ │ -0002cdf0: 6131 2d39 3620 6465 7333 2d63 6263 2d73  a1-96 des3-cbc-s
│ │ │ │ -0002ce00: 6861 312d 6b64 2064 6573 2d63 6263 2d6d  ha1-kd des-cbc-m
│ │ │ │ -0002ce10: 6435 0a0a 2020 2020 202a 5265 7475 726e  d5..     *Return
│ │ │ │ -0002ce20: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ -0002ce30: 20e2 8098 5348 4953 4849 5f4f 4be2 8099   ...SHISHI_OK...
│ │ │ │ -0002ce40: 2069 6620 7375 6363 6573 7366 756c 2c20   if successful, 
│ │ │ │ -0002ce50: 616e 640a 2020 2020 20e2 8098 5348 4953  and.     ...SHIS
│ │ │ │ -0002ce60: 4849 5f49 4e56 414c 4944 5f41 5247 554d  HI_INVALID_ARGUM
│ │ │ │ -0002ce70: 454e 54e2 8099 206f 7468 6572 7769 7365  ENT... otherwise
│ │ │ │ -0002ce80: 2e0a 0a73 6869 7368 695f 6366 675f 6175  ...shishi_cfg_au
│ │ │ │ -0002ce90: 7468 6f72 697a 6174 696f 6e74 7970 655f  thorizationtype_
│ │ │ │ -0002cea0: 7365 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  set.------------
│ │ │ │ +0002ca00: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ +0002ca10: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ +0002ca20: 3332 5f74 2073 6869 7368 695f 6366 675f  32_t shishi_cfg_
│ │ │ │ +0002ca30: 636c 6965 6e74 6b64 6365 7479 7065 5f66  clientkdcetype_f
│ │ │ │ +0002ca40: 6173 7420 2853 6869 7368 6920 2a20 4841  ast (Shishi * HA
│ │ │ │ +0002ca50: 4e44 4c45 290a 2020 2020 2048 414e 444c  NDLE).     HANDL
│ │ │ │ +0002ca60: 453a 2053 6869 7368 6920 6c69 6272 6172  E: Shishi librar
│ │ │ │ +0002ca70: 7920 6861 6e64 6c65 2063 7265 6174 6564  y handle created
│ │ │ │ +0002ca80: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ +0002ca90: 6974 2829 e280 992e 0a0a 2020 2020 202a  it()......     *
│ │ │ │ +0002caa0: 4465 7363 7269 7074 696f 6e3a 2a20 4578  Description:* Ex
│ │ │ │ +0002cab0: 7472 6163 7473 2074 6865 2064 6566 6175  tracts the defau
│ │ │ │ +0002cac0: 6c74 2065 6e63 7279 7074 696f 6e20 7479  lt encryption ty
│ │ │ │ +0002cad0: 7065 2066 726f 6d20 7468 6520 6c69 7374  pe from the list
│ │ │ │ +0002cae0: 0a20 2020 2020 6f66 2070 7265 6665 7272  .     of preferr
│ │ │ │ +0002caf0: 6564 2065 6e63 7279 7074 696f 6e20 7479  ed encryption ty
│ │ │ │ +0002cb00: 7065 7320 6163 6365 7074 6162 6c65 2074  pes acceptable t
│ │ │ │ +0002cb10: 6f20 7468 6520 636c 6965 6e74 2e0a 0a20  o the client... 
│ │ │ │ +0002cb20: 2020 2020 5768 656e 2074 6865 2070 7265      When the pre
│ │ │ │ +0002cb30: 6665 7272 6564 206c 6973 7420 6973 2065  ferred list is e
│ │ │ │ +0002cb40: 6d70 7479 2c20 e280 9853 4849 5348 495f  mpty, ...SHISHI_
│ │ │ │ +0002cb50: 4145 5332 3536 5f43 5453 5f48 4d41 435f  AES256_CTS_HMAC_
│ │ │ │ +0002cb60: 5348 4131 5f39 36e2 8099 0a20 2020 2020  SHA1_96....     
│ │ │ │ +0002cb70: 6973 2072 6574 7572 6e65 6420 6173 2061  is returned as a
│ │ │ │ +0002cb80: 2073 656e 7369 626c 6520 6465 6661 756c   sensible defaul
│ │ │ │ +0002cb90: 7420 7479 7065 2e0a 0a20 2020 2020 2a52  t type...     *R
│ │ │ │ +0002cba0: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +0002cbb0: 7475 726e 7320 7468 6520 6465 6661 756c  turns the defaul
│ │ │ │ +0002cbc0: 7420 656e 6372 7970 7469 6f6e 2074 7970  t encryption typ
│ │ │ │ +0002cbd0: 652e 0a0a 7368 6973 6869 5f63 6667 5f63  e...shishi_cfg_c
│ │ │ │ +0002cbe0: 6c69 656e 746b 6463 6574 7970 655f 7365  lientkdcetype_se
│ │ │ │ +0002cbf0: 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  t.--------------
│ │ │ │ +0002cc00: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +0002cc10: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ +0002cc20: 6e74 2073 6869 7368 695f 6366 675f 636c  nt shishi_cfg_cl
│ │ │ │ +0002cc30: 6965 6e74 6b64 6365 7479 7065 5f73 6574  ientkdcetype_set
│ │ │ │ +0002cc40: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ +0002cc50: 452c 0a20 2020 2020 2020 2020 2063 6861  E,.          cha
│ │ │ │ +0002cc60: 7220 2a20 5641 4c55 4529 0a20 2020 2020  r * VALUE).     
│ │ │ │ +0002cc70: 4841 4e44 4c45 3a20 5368 6973 6869 206c  HANDLE: Shishi l
│ │ │ │ +0002cc80: 6962 7261 7279 2068 616e 646c 6520 6372  ibrary handle cr
│ │ │ │ +0002cc90: 6561 7465 6420 6279 20e2 8098 7368 6973  eated by ...shis
│ │ │ │ +0002cca0: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ +0002ccb0: 2020 2056 414c 5545 3a20 5374 7269 6e67     VALUE: String
│ │ │ │ +0002ccc0: 206e 616d 696e 6720 6163 6365 7074 6162   naming acceptab
│ │ │ │ +0002ccd0: 6c65 2065 6e63 7279 7074 696f 6e20 7479  le encryption ty
│ │ │ │ +0002cce0: 7065 732e 0a0a 2020 2020 202a 4465 7363  pes...     *Desc
│ │ │ │ +0002ccf0: 7269 7074 696f 6e3a 2a20 5365 7473 2074  ription:* Sets t
│ │ │ │ +0002cd00: 6865 2063 6f6e 6669 6775 7261 7469 6f6e  he configuration
│ │ │ │ +0002cd10: 206f 7074 696f 6e20 2263 6c69 656e 742d   option "client-
│ │ │ │ +0002cd20: 6b64 632d 6574 7970 6573 220a 2020 2020  kdc-etypes".    
│ │ │ │ +0002cd30: 2066 726f 6d20 5641 4c55 452e 2020 5468   from VALUE.  Th
│ │ │ │ +0002cd40: 6520 7374 7269 6e67 2063 6f6e 7461 696e  e string contain
│ │ │ │ +0002cd50: 7320 656e 6372 7970 7469 6f6e 2074 7970  s encryption typ
│ │ │ │ +0002cd60: 6573 2c20 696e 7465 6765 7273 206f 720a  es, integers or.
│ │ │ │ +0002cd70: 2020 2020 206e 616d 6573 2c20 7365 7061       names, sepa
│ │ │ │ +0002cd80: 7261 7465 6420 6279 2063 6f6d 6d61 206f  rated by comma o
│ │ │ │ +0002cd90: 7220 6279 2077 6869 7465 7370 6163 652e  r by whitespace.
│ │ │ │ +0002cda0: 2020 416e 2065 7861 6d70 6c65 206e 616d    An example nam
│ │ │ │ +0002cdb0: 696e 670a 2020 2020 2074 6872 6565 2065  ing.     three e
│ │ │ │ +0002cdc0: 6e63 7279 7074 696f 6e20 7479 7065 7320  ncryption types 
│ │ │ │ +0002cdd0: 636f 756c 6420 6265 3a0a 0a20 2020 2020  could be:..     
│ │ │ │ +0002cde0: 6165 7332 3536 2d63 7473 2d68 6d61 632d  aes256-cts-hmac-
│ │ │ │ +0002cdf0: 7368 6131 2d39 3620 6465 7333 2d63 6263  sha1-96 des3-cbc
│ │ │ │ +0002ce00: 2d73 6861 312d 6b64 2064 6573 2d63 6263  -sha1-kd des-cbc
│ │ │ │ +0002ce10: 2d6d 6435 0a0a 2020 2020 202a 5265 7475  -md5..     *Retu
│ │ │ │ +0002ce20: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ +0002ce30: 6e73 20e2 8098 5348 4953 4849 5f4f 4be2  ns ...SHISHI_OK.
│ │ │ │ +0002ce40: 8099 2069 6620 7375 6363 6573 7366 756c  .. if successful
│ │ │ │ +0002ce50: 2c20 616e 640a 2020 2020 20e2 8098 5348  , and.     ...SH
│ │ │ │ +0002ce60: 4953 4849 5f49 4e56 414c 4944 5f41 5247  ISHI_INVALID_ARG
│ │ │ │ +0002ce70: 554d 454e 54e2 8099 206f 7468 6572 7769  UMENT... otherwi
│ │ │ │ +0002ce80: 7365 2e0a 0a73 6869 7368 695f 6366 675f  se...shishi_cfg_
│ │ │ │ +0002ce90: 6175 7468 6f72 697a 6174 696f 6e74 7970  authorizationtyp
│ │ │ │ +0002cea0: 655f 7365 740a 2d2d 2d2d 2d2d 2d2d 2d2d  e_set.----------
│ │ │ │  0002ceb0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0002cec0: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -0002ced0: 6f6e 3a20 696e 7420 7368 6973 6869 5f63  on: int shishi_c
│ │ │ │ -0002cee0: 6667 5f61 7574 686f 7269 7a61 7469 6f6e  fg_authorization
│ │ │ │ -0002cef0: 7479 7065 5f73 6574 2028 5368 6973 6869  type_set (Shishi
│ │ │ │ -0002cf00: 202a 2048 414e 444c 452c 0a20 2020 2020   * HANDLE,.     
│ │ │ │ -0002cf10: 2020 2020 2063 6861 7220 2a20 5641 4c55       char * VALU
│ │ │ │ -0002cf20: 4529 0a20 2020 2020 4841 4e44 4c45 3a20  E).     HANDLE: 
│ │ │ │ -0002cf30: 5368 6973 6869 206c 6962 7261 7279 2068  Shishi library h
│ │ │ │ -0002cf40: 616e 646c 6520 6372 6561 7465 6420 6279  andle created by
│ │ │ │ -0002cf50: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ -0002cf60: 29e2 8099 2e0a 2020 2020 2056 414c 5545  ).....     VALUE
│ │ │ │ -0002cf70: 3a20 5374 7269 6e67 206c 6973 7469 6e67  : String listing
│ │ │ │ -0002cf80: 2061 6363 6570 7461 626c 6520 6175 7468   acceptable auth
│ │ │ │ -0002cf90: 6f72 697a 6174 696f 6e20 7479 7065 732e  orization types.
│ │ │ │ -0002cfa0: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ -0002cfb0: 696f 6e3a 2a20 5365 7473 2074 6865 2063  ion:* Sets the c
│ │ │ │ -0002cfc0: 6f6e 6669 6775 7261 7469 6f6e 206f 7074  onfiguration opt
│ │ │ │ -0002cfd0: 696f 6e20 2261 7574 686f 7269 7a61 7469  ion "authorizati
│ │ │ │ -0002cfe0: 6f6e 2d74 7970 6573 220a 2020 2020 2066  on-types".     f
│ │ │ │ -0002cff0: 726f 6d20 5641 4c55 452e 2020 5468 6520  rom VALUE.  The 
│ │ │ │ -0002d000: 7374 7269 6e67 2063 6f6e 7461 696e 7320  string contains 
│ │ │ │ -0002d010: 6175 7468 6f72 697a 6174 696f 6e20 7479  authorization ty
│ │ │ │ -0002d020: 7065 732c 2069 6e74 6567 6572 7320 6f72  pes, integers or
│ │ │ │ -0002d030: 0a20 2020 2020 6e61 6d65 732c 2073 6570  .     names, sep
│ │ │ │ -0002d040: 6172 6174 6564 2062 7920 636f 6d6d 6120  arated by comma 
│ │ │ │ -0002d050: 6f72 2077 6869 7465 7370 6163 652e 0a0a  or whitespace...
│ │ │ │ -0002d060: 2020 2020 2041 7320 616e 2065 7861 6d70       As an examp
│ │ │ │ -0002d070: 6c65 2c20 226b 356c 6f67 696e 2062 6173  le, "k5login bas
│ │ │ │ -0002d080: 6963 2220 776f 756c 6420 6669 7273 7420  ic" would first 
│ │ │ │ -0002d090: 6368 6563 6b20 4b65 7262 6572 6f73 350a  check Kerberos5.
│ │ │ │ -0002d0a0: 2020 2020 2061 7574 6865 6e74 6963 6174       authenticat
│ │ │ │ -0002d0b0: 696f 6e20 6261 7365 6420 6f6e 2070 7265  ion based on pre
│ │ │ │ -0002d0c0: 7365 7420 7072 696e 6369 7061 6c73 2c20  set principals, 
│ │ │ │ -0002d0d0: 616e 6420 7468 656e 2066 616c 6c20 6261  and then fall ba
│ │ │ │ -0002d0e0: 636b 2074 6f0a 2020 2020 2074 6865 2062  ck to.     the b
│ │ │ │ -0002d0f0: 6173 6963 2074 6573 7420 6f66 2069 6465  asic test of ide
│ │ │ │ -0002d100: 6e74 6963 616c 2070 7269 6e63 6970 616c  ntical principal
│ │ │ │ -0002d110: 206e 616d 6573 2e0a 0a20 2020 2020 2a52   names...     *R
│ │ │ │ -0002d120: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ -0002d130: 7475 726e 7320 e280 9853 4849 5348 495f  turns ...SHISHI_
│ │ │ │ -0002d140: 4f4b e280 9920 6966 2073 7563 6365 7373  OK... if success
│ │ │ │ -0002d150: 6675 6c2c 2061 6e64 0a20 2020 2020 e280  ful, and.     ..
│ │ │ │ -0002d160: 9853 4849 5348 495f 494e 5641 4c49 445f  .SHISHI_INVALID_
│ │ │ │ -0002d170: 4152 4755 4d45 4e54 e280 9920 6f74 6865  ARGUMENT... othe
│ │ │ │ -0002d180: 7277 6973 652e 0a0a 1f0a 4669 6c65 3a20  rwise.....File: 
│ │ │ │ -0002d190: 7368 6973 6869 2e69 6e66 6f2c 2020 4e6f  shishi.info,  No
│ │ │ │ -0002d1a0: 6465 3a20 5469 636b 6574 2053 6574 2046  de: Ticket Set F
│ │ │ │ -0002d1b0: 756e 6374 696f 6e73 2c20 204e 6578 743a  unctions,  Next:
│ │ │ │ -0002d1c0: 2041 502d 5245 5120 616e 6420 4150 2d52   AP-REQ and AP-R
│ │ │ │ -0002d1d0: 4550 2046 756e 6374 696f 6e73 2c20 2050  EP Functions,  P
│ │ │ │ -0002d1e0: 7265 763a 2049 6e69 7469 616c 697a 6174  rev: Initializat
│ │ │ │ -0002d1f0: 696f 6e20 4675 6e63 7469 6f6e 732c 2020  ion Functions,  
│ │ │ │ -0002d200: 5570 3a20 5072 6f67 7261 6d6d 696e 6720  Up: Programming 
│ │ │ │ -0002d210: 4d61 6e75 616c 0a0a 352e 3320 5469 636b  Manual..5.3 Tick
│ │ │ │ -0002d220: 6574 2053 6574 2046 756e 6374 696f 6e73  et Set Functions
│ │ │ │ -0002d230: 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  .===============
│ │ │ │ -0002d240: 3d3d 3d3d 3d3d 3d3d 3d0a 0a41 2022 7469  =========..A "ti
│ │ │ │ -0002d250: 636b 6574 2073 6574 2220 6973 2c20 6173  cket set" is, as
│ │ │ │ -0002d260: 2074 6865 206e 616d 6520 696d 706c 6965   the name implie
│ │ │ │ -0002d270: 732c 2061 2063 6f6c 6c65 6374 696f 6e20  s, a collection 
│ │ │ │ -0002d280: 6f66 2074 6963 6b65 7473 2e0a 4675 6e63  of tickets..Func
│ │ │ │ -0002d290: 7469 6f6e 7320 6172 6520 7072 6f76 6964  tions are provid
│ │ │ │ -0002d2a0: 6564 2074 6f20 7265 6164 2074 6963 6b65  ed to read ticke
│ │ │ │ -0002d2b0: 7473 2066 726f 6d20 6669 6c65 2069 6e74  ts from file int
│ │ │ │ -0002d2c0: 6f20 6120 7469 636b 6574 2073 6574 2c20  o a ticket set, 
│ │ │ │ -0002d2d0: 746f 0a71 7565 7279 206e 756d 6265 7220  to.query number 
│ │ │ │ -0002d2e0: 6f66 2074 6963 6b65 7473 2069 6e20 7468  of tickets in th
│ │ │ │ -0002d2f0: 6520 7365 742c 2074 6f20 6578 7472 6163  e set, to extrac
│ │ │ │ -0002d300: 7420 6120 6769 7665 6e20 7469 636b 6574  t a given ticket
│ │ │ │ -0002d310: 2066 726f 6d20 7468 650a 7365 742c 2074   from the.set, t
│ │ │ │ -0002d320: 6f20 7365 6172 6368 2074 6865 2074 6963  o search the tic
│ │ │ │ -0002d330: 6b65 7420 7365 7420 666f 7220 7469 636b  ket set for tick
│ │ │ │ -0002d340: 6574 7320 6d61 7463 6869 6e67 2063 6572  ets matching cer
│ │ │ │ -0002d350: 7461 696e 2063 7269 7465 7269 756d 2c20  tain criterium, 
│ │ │ │ -0002d360: 746f 0a77 7269 7465 2074 6865 2074 6963  to.write the tic
│ │ │ │ -0002d370: 6b65 7420 7365 7420 746f 2061 2066 696c  ket set to a fil
│ │ │ │ -0002d380: 652c 2065 7463 2e20 2048 6967 6820 6c65  e, etc.  High le
│ │ │ │ -0002d390: 7665 6c20 6675 6e63 7469 6f6e 7320 666f  vel functions fo
│ │ │ │ -0002d3a0: 720a 7065 7266 6f72 6d69 6e67 2061 2069  r.performing a i
│ │ │ │ -0002d3b0: 6e69 7469 616c 2061 7574 6865 6e74 6963  nitial authentic
│ │ │ │ -0002d3c0: 6174 696f 6e20 282a 6e6f 7465 2041 5320  ation (*note AS 
│ │ │ │ -0002d3d0: 4675 6e63 7469 6f6e 733a 3a29 206f 7220  Functions::) or 
│ │ │ │ -0002d3e0: 7375 6273 6571 7565 6e74 0a61 7574 6865  subsequent.authe
│ │ │ │ -0002d3f0: 6e74 6963 6174 696f 6e20 282a 6e6f 7465  ntication (*note
│ │ │ │ -0002d400: 2054 4753 2046 756e 6374 696f 6e73 3a3a   TGS Functions::
│ │ │ │ -0002d410: 2920 616e 6420 7374 6f72 696e 6720 7468  ) and storing th
│ │ │ │ -0002d420: 6520 6e65 7720 7469 636b 6574 2069 6e20  e new ticket in 
│ │ │ │ -0002d430: 7468 650a 7469 636b 6574 2073 6574 2061  the.ticket set a
│ │ │ │ -0002d440: 7265 2061 6c73 6f20 7072 6f76 6964 6564  re also provided
│ │ │ │ -0002d450: 2e0a 0a20 2020 2a4e 6f74 6520 5469 636b  ...   *Note Tick
│ │ │ │ -0002d460: 6574 2046 756e 6374 696f 6e73 3a3a 2c20  et Functions::, 
│ │ │ │ -0002d470: 746f 206d 616e 6970 756c 6174 6520 6561  to manipulate ea
│ │ │ │ -0002d480: 6368 2069 6e64 6976 6964 7561 6c20 7469  ch individual ti
│ │ │ │ -0002d490: 636b 6574 2e0a 2a4e 6f74 6520 5469 636b  cket..*Note Tick
│ │ │ │ -0002d4a0: 6574 2028 4153 4e2e 3129 2046 756e 6374  et (ASN.1) Funct
│ │ │ │ -0002d4b0: 696f 6e73 3a3a 2c20 666f 7220 6c6f 772d  ions::, for low-
│ │ │ │ -0002d4c0: 6c65 7665 6c20 4153 4e2e 3120 6d61 6e69  level ASN.1 mani
│ │ │ │ -0002d4d0: 7075 6c61 7469 6f6e 2e0a 0a73 6869 7368  pulation...shish
│ │ │ │ -0002d4e0: 695f 746b 7473 5f64 6566 6175 6c74 5f66  i_tkts_default_f
│ │ │ │ -0002d4f0: 696c 655f 6775 6573 730a 2d2d 2d2d 2d2d  ile_guess.------
│ │ │ │ +0002cec0: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ +0002ced0: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ +0002cee0: 5f63 6667 5f61 7574 686f 7269 7a61 7469  _cfg_authorizati
│ │ │ │ +0002cef0: 6f6e 7479 7065 5f73 6574 2028 5368 6973  ontype_set (Shis
│ │ │ │ +0002cf00: 6869 202a 2048 414e 444c 452c 0a20 2020  hi * HANDLE,.   
│ │ │ │ +0002cf10: 2020 2020 2020 2063 6861 7220 2a20 5641         char * VA
│ │ │ │ +0002cf20: 4c55 4529 0a20 2020 2020 4841 4e44 4c45  LUE).     HANDLE
│ │ │ │ +0002cf30: 3a20 5368 6973 6869 206c 6962 7261 7279  : Shishi library
│ │ │ │ +0002cf40: 2068 616e 646c 6520 6372 6561 7465 6420   handle created 
│ │ │ │ +0002cf50: 6279 20e2 8098 7368 6973 6869 5f69 6e69  by ...shishi_ini
│ │ │ │ +0002cf60: 7428 29e2 8099 2e0a 2020 2020 2056 414c  t().....     VAL
│ │ │ │ +0002cf70: 5545 3a20 5374 7269 6e67 206c 6973 7469  UE: String listi
│ │ │ │ +0002cf80: 6e67 2061 6363 6570 7461 626c 6520 6175  ng acceptable au
│ │ │ │ +0002cf90: 7468 6f72 697a 6174 696f 6e20 7479 7065  thorization type
│ │ │ │ +0002cfa0: 732e 0a0a 2020 2020 202a 4465 7363 7269  s...     *Descri
│ │ │ │ +0002cfb0: 7074 696f 6e3a 2a20 5365 7473 2074 6865  ption:* Sets the
│ │ │ │ +0002cfc0: 2063 6f6e 6669 6775 7261 7469 6f6e 206f   configuration o
│ │ │ │ +0002cfd0: 7074 696f 6e20 2261 7574 686f 7269 7a61  ption "authoriza
│ │ │ │ +0002cfe0: 7469 6f6e 2d74 7970 6573 220a 2020 2020  tion-types".    
│ │ │ │ +0002cff0: 2066 726f 6d20 5641 4c55 452e 2020 5468   from VALUE.  Th
│ │ │ │ +0002d000: 6520 7374 7269 6e67 2063 6f6e 7461 696e  e string contain
│ │ │ │ +0002d010: 7320 6175 7468 6f72 697a 6174 696f 6e20  s authorization 
│ │ │ │ +0002d020: 7479 7065 732c 2069 6e74 6567 6572 7320  types, integers 
│ │ │ │ +0002d030: 6f72 0a20 2020 2020 6e61 6d65 732c 2073  or.     names, s
│ │ │ │ +0002d040: 6570 6172 6174 6564 2062 7920 636f 6d6d  eparated by comm
│ │ │ │ +0002d050: 6120 6f72 2077 6869 7465 7370 6163 652e  a or whitespace.
│ │ │ │ +0002d060: 0a0a 2020 2020 2041 7320 616e 2065 7861  ..     As an exa
│ │ │ │ +0002d070: 6d70 6c65 2c20 226b 356c 6f67 696e 2062  mple, "k5login b
│ │ │ │ +0002d080: 6173 6963 2220 776f 756c 6420 6669 7273  asic" would firs
│ │ │ │ +0002d090: 7420 6368 6563 6b20 4b65 7262 6572 6f73  t check Kerberos
│ │ │ │ +0002d0a0: 350a 2020 2020 2061 7574 6865 6e74 6963  5.     authentic
│ │ │ │ +0002d0b0: 6174 696f 6e20 6261 7365 6420 6f6e 2070  ation based on p
│ │ │ │ +0002d0c0: 7265 7365 7420 7072 696e 6369 7061 6c73  reset principals
│ │ │ │ +0002d0d0: 2c20 616e 6420 7468 656e 2066 616c 6c20  , and then fall 
│ │ │ │ +0002d0e0: 6261 636b 2074 6f0a 2020 2020 2074 6865  back to.     the
│ │ │ │ +0002d0f0: 2062 6173 6963 2074 6573 7420 6f66 2069   basic test of i
│ │ │ │ +0002d100: 6465 6e74 6963 616c 2070 7269 6e63 6970  dentical princip
│ │ │ │ +0002d110: 616c 206e 616d 6573 2e0a 0a20 2020 2020  al names...     
│ │ │ │ +0002d120: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ +0002d130: 5265 7475 726e 7320 e280 9853 4849 5348  Returns ...SHISH
│ │ │ │ +0002d140: 495f 4f4b e280 9920 6966 2073 7563 6365  I_OK... if succe
│ │ │ │ +0002d150: 7373 6675 6c2c 2061 6e64 0a20 2020 2020  ssful, and.     
│ │ │ │ +0002d160: e280 9853 4849 5348 495f 494e 5641 4c49  ...SHISHI_INVALI
│ │ │ │ +0002d170: 445f 4152 4755 4d45 4e54 e280 9920 6f74  D_ARGUMENT... ot
│ │ │ │ +0002d180: 6865 7277 6973 652e 0a0a 1f0a 4669 6c65  herwise.....File
│ │ │ │ +0002d190: 3a20 7368 6973 6869 2e69 6e66 6f2c 2020  : shishi.info,  
│ │ │ │ +0002d1a0: 4e6f 6465 3a20 5469 636b 6574 2053 6574  Node: Ticket Set
│ │ │ │ +0002d1b0: 2046 756e 6374 696f 6e73 2c20 204e 6578   Functions,  Nex
│ │ │ │ +0002d1c0: 743a 2041 502d 5245 5120 616e 6420 4150  t: AP-REQ and AP
│ │ │ │ +0002d1d0: 2d52 4550 2046 756e 6374 696f 6e73 2c20  -REP Functions, 
│ │ │ │ +0002d1e0: 2050 7265 763a 2049 6e69 7469 616c 697a   Prev: Initializ
│ │ │ │ +0002d1f0: 6174 696f 6e20 4675 6e63 7469 6f6e 732c  ation Functions,
│ │ │ │ +0002d200: 2020 5570 3a20 5072 6f67 7261 6d6d 696e    Up: Programmin
│ │ │ │ +0002d210: 6720 4d61 6e75 616c 0a0a 352e 3320 5469  g Manual..5.3 Ti
│ │ │ │ +0002d220: 636b 6574 2053 6574 2046 756e 6374 696f  cket Set Functio
│ │ │ │ +0002d230: 6e73 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ns.=============
│ │ │ │ +0002d240: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a41 2022  ===========..A "
│ │ │ │ +0002d250: 7469 636b 6574 2073 6574 2220 6973 2c20  ticket set" is, 
│ │ │ │ +0002d260: 6173 2074 6865 206e 616d 6520 696d 706c  as the name impl
│ │ │ │ +0002d270: 6965 732c 2061 2063 6f6c 6c65 6374 696f  ies, a collectio
│ │ │ │ +0002d280: 6e20 6f66 2074 6963 6b65 7473 2e0a 4675  n of tickets..Fu
│ │ │ │ +0002d290: 6e63 7469 6f6e 7320 6172 6520 7072 6f76  nctions are prov
│ │ │ │ +0002d2a0: 6964 6564 2074 6f20 7265 6164 2074 6963  ided to read tic
│ │ │ │ +0002d2b0: 6b65 7473 2066 726f 6d20 6669 6c65 2069  kets from file i
│ │ │ │ +0002d2c0: 6e74 6f20 6120 7469 636b 6574 2073 6574  nto a ticket set
│ │ │ │ +0002d2d0: 2c20 746f 0a71 7565 7279 206e 756d 6265  , to.query numbe
│ │ │ │ +0002d2e0: 7220 6f66 2074 6963 6b65 7473 2069 6e20  r of tickets in 
│ │ │ │ +0002d2f0: 7468 6520 7365 742c 2074 6f20 6578 7472  the set, to extr
│ │ │ │ +0002d300: 6163 7420 6120 6769 7665 6e20 7469 636b  act a given tick
│ │ │ │ +0002d310: 6574 2066 726f 6d20 7468 650a 7365 742c  et from the.set,
│ │ │ │ +0002d320: 2074 6f20 7365 6172 6368 2074 6865 2074   to search the t
│ │ │ │ +0002d330: 6963 6b65 7420 7365 7420 666f 7220 7469  icket set for ti
│ │ │ │ +0002d340: 636b 6574 7320 6d61 7463 6869 6e67 2063  ckets matching c
│ │ │ │ +0002d350: 6572 7461 696e 2063 7269 7465 7269 756d  ertain criterium
│ │ │ │ +0002d360: 2c20 746f 0a77 7269 7465 2074 6865 2074  , to.write the t
│ │ │ │ +0002d370: 6963 6b65 7420 7365 7420 746f 2061 2066  icket set to a f
│ │ │ │ +0002d380: 696c 652c 2065 7463 2e20 2048 6967 6820  ile, etc.  High 
│ │ │ │ +0002d390: 6c65 7665 6c20 6675 6e63 7469 6f6e 7320  level functions 
│ │ │ │ +0002d3a0: 666f 720a 7065 7266 6f72 6d69 6e67 2061  for.performing a
│ │ │ │ +0002d3b0: 2069 6e69 7469 616c 2061 7574 6865 6e74   initial authent
│ │ │ │ +0002d3c0: 6963 6174 696f 6e20 282a 6e6f 7465 2041  ication (*note A
│ │ │ │ +0002d3d0: 5320 4675 6e63 7469 6f6e 733a 3a29 206f  S Functions::) o
│ │ │ │ +0002d3e0: 7220 7375 6273 6571 7565 6e74 0a61 7574  r subsequent.aut
│ │ │ │ +0002d3f0: 6865 6e74 6963 6174 696f 6e20 282a 6e6f  hentication (*no
│ │ │ │ +0002d400: 7465 2054 4753 2046 756e 6374 696f 6e73  te TGS Functions
│ │ │ │ +0002d410: 3a3a 2920 616e 6420 7374 6f72 696e 6720  ::) and storing 
│ │ │ │ +0002d420: 7468 6520 6e65 7720 7469 636b 6574 2069  the new ticket i
│ │ │ │ +0002d430: 6e20 7468 650a 7469 636b 6574 2073 6574  n the.ticket set
│ │ │ │ +0002d440: 2061 7265 2061 6c73 6f20 7072 6f76 6964   are also provid
│ │ │ │ +0002d450: 6564 2e0a 0a20 2020 2a4e 6f74 6520 5469  ed...   *Note Ti
│ │ │ │ +0002d460: 636b 6574 2046 756e 6374 696f 6e73 3a3a  cket Functions::
│ │ │ │ +0002d470: 2c20 746f 206d 616e 6970 756c 6174 6520  , to manipulate 
│ │ │ │ +0002d480: 6561 6368 2069 6e64 6976 6964 7561 6c20  each individual 
│ │ │ │ +0002d490: 7469 636b 6574 2e0a 2a4e 6f74 6520 5469  ticket..*Note Ti
│ │ │ │ +0002d4a0: 636b 6574 2028 4153 4e2e 3129 2046 756e  cket (ASN.1) Fun
│ │ │ │ +0002d4b0: 6374 696f 6e73 3a3a 2c20 666f 7220 6c6f  ctions::, for lo
│ │ │ │ +0002d4c0: 772d 6c65 7665 6c20 4153 4e2e 3120 6d61  w-level ASN.1 ma
│ │ │ │ +0002d4d0: 6e69 7075 6c61 7469 6f6e 2e0a 0a73 6869  nipulation...shi
│ │ │ │ +0002d4e0: 7368 695f 746b 7473 5f64 6566 6175 6c74  shi_tkts_default
│ │ │ │ +0002d4f0: 5f66 696c 655f 6775 6573 730a 2d2d 2d2d  _file_guess.----
│ │ │ │  0002d500: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0002d510: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -0002d520: 6e63 7469 6f6e 3a20 6368 6172 202a 2073  nction: char * s
│ │ │ │ -0002d530: 6869 7368 695f 746b 7473 5f64 6566 6175  hishi_tkts_defau
│ │ │ │ -0002d540: 6c74 5f66 696c 655f 6775 6573 7320 2853  lt_file_guess (S
│ │ │ │ -0002d550: 6869 7368 6920 2a20 4841 4e44 4c45 290a  hishi * HANDLE).
│ │ │ │ -0002d560: 2020 2020 2048 414e 444c 453a 2053 6869       HANDLE: Shi
│ │ │ │ -0002d570: 7368 6920 6c69 6272 6172 7920 6861 6e64  shi library hand
│ │ │ │ -0002d580: 6c65 2063 7265 6174 6520 6279 20e2 8098  le create by ...
│ │ │ │ -0002d590: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ -0002d5a0: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ -0002d5b0: 7469 6f6e 3a2a 2047 7565 7373 6573 2074  tion:* Guesses t
│ │ │ │ -0002d5c0: 6865 2064 6566 6175 6c74 2074 6963 6b65  he default ticke
│ │ │ │ -0002d5d0: 7420 6669 6c65 6e61 6d65 3b20 6974 2069  t filename; it i
│ │ │ │ -0002d5e0: 730a 2020 2020 20e2 8098 5348 4953 4849  s.     ...SHISHI
│ │ │ │ -0002d5f0: 5f54 4943 4b45 5453 e280 992c 20e2 8098  _TICKETS..., ...
│ │ │ │ -0002d600: 5348 4953 4849 5f48 4f4d 45e2 8099 2f74  SHISHI_HOME.../t
│ │ │ │ -0002d610: 6963 6b65 7473 2c20 6f72 20e2 8098 484f  ickets, or ...HO
│ │ │ │ -0002d620: 4d45 e280 992f 2e73 6869 7368 692f 7469  ME.../.shishi/ti
│ │ │ │ -0002d630: 636b 6574 732e 0a0a 2020 2020 202a 5265  ckets...     *Re
│ │ │ │ -0002d640: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ -0002d650: 7572 6e73 2064 6566 6175 6c74 2074 6b74  urns default tkt
│ │ │ │ -0002d660: 7320 6669 6c65 6e61 6d65 2061 7320 6120  s filename as a 
│ │ │ │ -0002d670: 7374 7269 6e67 2074 6861 7420 6861 730a  string that has.
│ │ │ │ -0002d680: 2020 2020 2074 6f20 6265 2064 6561 6c6c       to be deall
│ │ │ │ -0002d690: 6f63 6174 6564 2077 6974 6820 e280 9866  ocated with ...f
│ │ │ │ -0002d6a0: 7265 6528 29e2 8099 2062 7920 7468 6520  ree()... by the 
│ │ │ │ -0002d6b0: 6361 6c6c 6572 2e0a 0a73 6869 7368 695f  caller...shishi_
│ │ │ │ -0002d6c0: 746b 7473 5f64 6566 6175 6c74 5f66 696c  tkts_default_fil
│ │ │ │ -0002d6d0: 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  e.--------------
│ │ │ │ -0002d6e0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ -0002d6f0: 4675 6e63 7469 6f6e 3a20 636f 6e73 7420  Function: const 
│ │ │ │ -0002d700: 6368 6172 202a 2073 6869 7368 695f 746b  char * shishi_tk
│ │ │ │ -0002d710: 7473 5f64 6566 6175 6c74 5f66 696c 6520  ts_default_file 
│ │ │ │ -0002d720: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ -0002d730: 290a 2020 2020 2048 414e 444c 453a 2053  ).     HANDLE: S
│ │ │ │ -0002d740: 6869 7368 6920 6c69 6272 6172 7920 6861  hishi library ha
│ │ │ │ -0002d750: 6e64 6c65 2063 7265 6174 6520 6279 20e2  ndle create by .
│ │ │ │ -0002d760: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ -0002d770: 8099 2e0a 0a20 2020 2020 2a44 6573 6372  .....     *Descr
│ │ │ │ -0002d780: 6970 7469 6f6e 3a2a 2047 6574 2066 696c  iption:* Get fil
│ │ │ │ -0002d790: 656e 616d 6520 6f66 2064 6566 6175 6c74  ename of default
│ │ │ │ -0002d7a0: 2074 6963 6b65 7420 7365 742e 0a0a 2020   ticket set...  
│ │ │ │ -0002d7b0: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ -0002d7c0: 3a2a 2052 6574 7572 6e73 2074 6865 2064  :* Returns the d
│ │ │ │ -0002d7d0: 6566 6175 6c74 2074 6963 6b65 7420 7365  efault ticket se
│ │ │ │ -0002d7e0: 7420 6669 6c65 6e61 6d65 2075 7365 6420  t filename used 
│ │ │ │ -0002d7f0: 696e 2074 6865 0a20 2020 2020 6c69 6272  in the.     libr
│ │ │ │ -0002d800: 6172 792e 2020 5468 6520 7374 7269 6e67  ary.  The string
│ │ │ │ -0002d810: 2069 7320 6e6f 7420 6120 636f 7079 2c20   is not a copy, 
│ │ │ │ -0002d820: 736f 2064 6f6e 2774 206d 6f64 6966 7920  so don't modify 
│ │ │ │ -0002d830: 6f72 2064 6561 6c6c 6f63 6174 650a 2020  or deallocate.  
│ │ │ │ -0002d840: 2020 2069 742e 0a0a 7368 6973 6869 5f74     it...shishi_t
│ │ │ │ -0002d850: 6b74 735f 6465 6661 756c 745f 6669 6c65  kts_default_file
│ │ │ │ -0002d860: 5f73 6574 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  _set.-----------
│ │ │ │ +0002d510: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +0002d520: 4675 6e63 7469 6f6e 3a20 6368 6172 202a  Function: char *
│ │ │ │ +0002d530: 2073 6869 7368 695f 746b 7473 5f64 6566   shishi_tkts_def
│ │ │ │ +0002d540: 6175 6c74 5f66 696c 655f 6775 6573 7320  ault_file_guess 
│ │ │ │ +0002d550: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ +0002d560: 290a 2020 2020 2048 414e 444c 453a 2053  ).     HANDLE: S
│ │ │ │ +0002d570: 6869 7368 6920 6c69 6272 6172 7920 6861  hishi library ha
│ │ │ │ +0002d580: 6e64 6c65 2063 7265 6174 6520 6279 20e2  ndle create by .
│ │ │ │ +0002d590: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ +0002d5a0: 8099 2e0a 0a20 2020 2020 2a44 6573 6372  .....     *Descr
│ │ │ │ +0002d5b0: 6970 7469 6f6e 3a2a 2047 7565 7373 6573  iption:* Guesses
│ │ │ │ +0002d5c0: 2074 6865 2064 6566 6175 6c74 2074 6963   the default tic
│ │ │ │ +0002d5d0: 6b65 7420 6669 6c65 6e61 6d65 3b20 6974  ket filename; it
│ │ │ │ +0002d5e0: 2069 730a 2020 2020 20e2 8098 5348 4953   is.     ...SHIS
│ │ │ │ +0002d5f0: 4849 5f54 4943 4b45 5453 e280 992c 20e2  HI_TICKETS..., .
│ │ │ │ +0002d600: 8098 5348 4953 4849 5f48 4f4d 45e2 8099  ..SHISHI_HOME...
│ │ │ │ +0002d610: 2f74 6963 6b65 7473 2c20 6f72 20e2 8098  /tickets, or ...
│ │ │ │ +0002d620: 484f 4d45 e280 992f 2e73 6869 7368 692f  HOME.../.shishi/
│ │ │ │ +0002d630: 7469 636b 6574 732e 0a0a 2020 2020 202a  tickets...     *
│ │ │ │ +0002d640: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ +0002d650: 6574 7572 6e73 2064 6566 6175 6c74 2074  eturns default t
│ │ │ │ +0002d660: 6b74 7320 6669 6c65 6e61 6d65 2061 7320  kts filename as 
│ │ │ │ +0002d670: 6120 7374 7269 6e67 2074 6861 7420 6861  a string that ha
│ │ │ │ +0002d680: 730a 2020 2020 2074 6f20 6265 2064 6561  s.     to be dea
│ │ │ │ +0002d690: 6c6c 6f63 6174 6564 2077 6974 6820 e280  llocated with ..
│ │ │ │ +0002d6a0: 9866 7265 6528 29e2 8099 2062 7920 7468  .free()... by th
│ │ │ │ +0002d6b0: 6520 6361 6c6c 6572 2e0a 0a73 6869 7368  e caller...shish
│ │ │ │ +0002d6c0: 695f 746b 7473 5f64 6566 6175 6c74 5f66  i_tkts_default_f
│ │ │ │ +0002d6d0: 696c 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ile.------------
│ │ │ │ +0002d6e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ +0002d6f0: 2d20 4675 6e63 7469 6f6e 3a20 636f 6e73  - Function: cons
│ │ │ │ +0002d700: 7420 6368 6172 202a 2073 6869 7368 695f  t char * shishi_
│ │ │ │ +0002d710: 746b 7473 5f64 6566 6175 6c74 5f66 696c  tkts_default_fil
│ │ │ │ +0002d720: 6520 2853 6869 7368 6920 2a20 4841 4e44  e (Shishi * HAND
│ │ │ │ +0002d730: 4c45 290a 2020 2020 2048 414e 444c 453a  LE).     HANDLE:
│ │ │ │ +0002d740: 2053 6869 7368 6920 6c69 6272 6172 7920   Shishi library 
│ │ │ │ +0002d750: 6861 6e64 6c65 2063 7265 6174 6520 6279  handle create by
│ │ │ │ +0002d760: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ +0002d770: 29e2 8099 2e0a 0a20 2020 2020 2a44 6573  )......     *Des
│ │ │ │ +0002d780: 6372 6970 7469 6f6e 3a2a 2047 6574 2066  cription:* Get f
│ │ │ │ +0002d790: 696c 656e 616d 6520 6f66 2064 6566 6175  ilename of defau
│ │ │ │ +0002d7a0: 6c74 2074 6963 6b65 7420 7365 742e 0a0a  lt ticket set...
│ │ │ │ +0002d7b0: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ +0002d7c0: 7565 3a2a 2052 6574 7572 6e73 2074 6865  ue:* Returns the
│ │ │ │ +0002d7d0: 2064 6566 6175 6c74 2074 6963 6b65 7420   default ticket 
│ │ │ │ +0002d7e0: 7365 7420 6669 6c65 6e61 6d65 2075 7365  set filename use
│ │ │ │ +0002d7f0: 6420 696e 2074 6865 0a20 2020 2020 6c69  d in the.     li
│ │ │ │ +0002d800: 6272 6172 792e 2020 5468 6520 7374 7269  brary.  The stri
│ │ │ │ +0002d810: 6e67 2069 7320 6e6f 7420 6120 636f 7079  ng is not a copy
│ │ │ │ +0002d820: 2c20 736f 2064 6f6e 2774 206d 6f64 6966  , so don't modif
│ │ │ │ +0002d830: 7920 6f72 2064 6561 6c6c 6f63 6174 650a  y or deallocate.
│ │ │ │ +0002d840: 2020 2020 2069 742e 0a0a 7368 6973 6869       it...shishi
│ │ │ │ +0002d850: 5f74 6b74 735f 6465 6661 756c 745f 6669  _tkts_default_fi
│ │ │ │ +0002d860: 6c65 5f73 6574 0a2d 2d2d 2d2d 2d2d 2d2d  le_set.---------
│ │ │ │  0002d870: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0002d880: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ -0002d890: 2076 6f69 6420 7368 6973 6869 5f74 6b74   void shishi_tkt
│ │ │ │ -0002d8a0: 735f 6465 6661 756c 745f 6669 6c65 5f73  s_default_file_s
│ │ │ │ -0002d8b0: 6574 2028 5368 6973 6869 202a 2048 414e  et (Shishi * HAN
│ │ │ │ -0002d8c0: 444c 452c 0a20 2020 2020 2020 2020 2063  DLE,.          c
│ │ │ │ -0002d8d0: 6f6e 7374 2063 6861 7220 2a20 544b 5453  onst char * TKTS
│ │ │ │ -0002d8e0: 4649 4c45 290a 2020 2020 2048 414e 444c  FILE).     HANDL
│ │ │ │ -0002d8f0: 453a 2053 6869 7368 6920 6c69 6272 6172  E: Shishi librar
│ │ │ │ -0002d900: 7920 6861 6e64 6c65 2063 7265 6174 6520  y handle create 
│ │ │ │ -0002d910: 6279 20e2 8098 7368 6973 6869 5f69 6e69  by ...shishi_ini
│ │ │ │ -0002d920: 7428 29e2 8099 2e0a 2020 2020 2054 4b54  t().....     TKT
│ │ │ │ -0002d930: 5346 494c 453a 2073 7472 696e 6720 7769  SFILE: string wi
│ │ │ │ -0002d940: 7468 206e 6577 2064 6566 6175 6c74 2074  th new default t
│ │ │ │ -0002d950: 6b74 7320 6669 6c65 206e 616d 652c 206f  kts file name, o
│ │ │ │ -0002d960: 7220 4e55 4c4c 2074 6f20 7265 7365 740a  r NULL to reset.
│ │ │ │ -0002d970: 2020 2020 2074 6f20 6465 6661 756c 742e       to default.
│ │ │ │ -0002d980: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ -0002d990: 696f 6e3a 2a20 5365 7420 7468 6520 6465  ion:* Set the de
│ │ │ │ -0002d9a0: 6661 756c 7420 7469 636b 6574 2073 6574  fault ticket set
│ │ │ │ -0002d9b0: 2066 696c 656e 616d 6520 7573 6564 2069   filename used i
│ │ │ │ -0002d9c0: 6e20 7468 650a 2020 2020 206c 6962 7261  n the.     libra
│ │ │ │ -0002d9d0: 7279 2e20 2054 6865 2073 7472 696e 6720  ry.  The string 
│ │ │ │ -0002d9e0: 6973 2063 6f70 6965 6420 696e 746f 2074  is copied into t
│ │ │ │ -0002d9f0: 6865 206c 6962 7261 7279 2c20 736f 2079  he library, so y
│ │ │ │ -0002da00: 6f75 2063 616e 2064 6973 706f 7365 0a20  ou can dispose. 
│ │ │ │ -0002da10: 2020 2020 6f66 2074 6865 2076 6172 6961      of the varia
│ │ │ │ -0002da20: 626c 6520 696d 6d65 6469 6174 656c 7920  ble immediately 
│ │ │ │ -0002da30: 6166 7465 7220 6361 6c6c 696e 6720 7468  after calling th
│ │ │ │ -0002da40: 6973 2066 756e 6374 696f 6e2e 0a0a 7368  is function...sh
│ │ │ │ -0002da50: 6973 6869 5f74 6b74 735f 6465 6661 756c  ishi_tkts_defaul
│ │ │ │ -0002da60: 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  t.--------------
│ │ │ │ -0002da70: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ -0002da80: 696f 6e3a 2053 6869 7368 695f 746b 7473  ion: Shishi_tkts
│ │ │ │ -0002da90: 202a 2073 6869 7368 695f 746b 7473 5f64   * shishi_tkts_d
│ │ │ │ -0002daa0: 6566 6175 6c74 2028 5368 6973 6869 202a  efault (Shishi *
│ │ │ │ -0002dab0: 2048 414e 444c 4529 0a20 2020 2020 4841   HANDLE).     HA
│ │ │ │ -0002dac0: 4e44 4c45 3a20 5368 6973 6869 206c 6962  NDLE: Shishi lib
│ │ │ │ -0002dad0: 7261 7279 2068 616e 646c 6520 6372 6561  rary handle crea
│ │ │ │ -0002dae0: 7465 2062 7920 e280 9873 6869 7368 695f  te by ...shishi_
│ │ │ │ -0002daf0: 696e 6974 2829 e280 992e 0a0a 2020 2020  init()......    
│ │ │ │ -0002db00: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ -0002db10: 4765 7420 7468 6520 6465 6661 756c 7420  Get the default 
│ │ │ │ -0002db20: 7469 636b 6574 2073 6574 2066 6f72 206c  ticket set for l
│ │ │ │ -0002db30: 6962 7261 7279 2068 616e 646c 652e 0a0a  ibrary handle...
│ │ │ │ -0002db40: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ -0002db50: 7565 3a2a 2052 6574 7572 6e20 7468 6520  ue:* Return the 
│ │ │ │ -0002db60: 6861 6e64 6c65 2067 6c6f 6261 6c20 7469  handle global ti
│ │ │ │ -0002db70: 636b 6574 2073 6574 2e0a 0a73 6869 7368  cket set...shish
│ │ │ │ -0002db80: 695f 746b 7473 0a2d 2d2d 2d2d 2d2d 2d2d  i_tkts.---------
│ │ │ │ -0002db90: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ -0002dba0: 3a20 696e 7420 7368 6973 6869 5f74 6b74  : int shishi_tkt
│ │ │ │ -0002dbb0: 7320 2853 6869 7368 6920 2a20 4841 4e44  s (Shishi * HAND
│ │ │ │ -0002dbc0: 4c45 2c20 5368 6973 6869 5f74 6b74 7320  LE, Shishi_tkts 
│ │ │ │ -0002dbd0: 2a2a 2054 4b54 5329 0a20 2020 2020 4841  ** TKTS).     HA
│ │ │ │ -0002dbe0: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ -0002dbf0: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ -0002dc00: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ -0002dc10: 6974 2829 e280 992e 0a20 2020 2020 544b  it().....     TK
│ │ │ │ -0002dc20: 5453 3a20 6f75 7470 7574 2070 6f69 6e74  TS: output point
│ │ │ │ -0002dc30: 6572 2074 6f20 6e65 776c 7920 616c 6c6f  er to newly allo
│ │ │ │ -0002dc40: 6361 7465 6420 746b 7473 2068 616e 646c  cated tkts handl
│ │ │ │ -0002dc50: 652e 0a0a 2020 2020 202a 4465 7363 7269  e...     *Descri
│ │ │ │ -0002dc60: 7074 696f 6e3a 2a20 4765 7420 6120 6e65  ption:* Get a ne
│ │ │ │ -0002dc70: 7720 7469 636b 6574 2073 6574 2068 616e  w ticket set han
│ │ │ │ -0002dc80: 646c 652e 0a0a 2020 2020 202a 5265 7475  dle...     *Retu
│ │ │ │ -0002dc90: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ -0002dca0: 6e73 20e2 8098 5348 4953 4849 5f4f 4be2  ns ...SHISHI_OK.
│ │ │ │ -0002dcb0: 8099 2069 6666 2073 7563 6365 7373 6675  .. iff successfu
│ │ │ │ -0002dcc0: 6c2e 0a0a 7368 6973 6869 5f74 6b74 735f  l...shishi_tkts_
│ │ │ │ -0002dcd0: 646f 6e65 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  done.-----------
│ │ │ │ -0002dce0: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ -0002dcf0: 696f 6e3a 2076 6f69 6420 7368 6973 6869  ion: void shishi
│ │ │ │ -0002dd00: 5f74 6b74 735f 646f 6e65 2028 5368 6973  _tkts_done (Shis
│ │ │ │ -0002dd10: 6869 5f74 6b74 7320 2a2a 2054 4b54 5329  hi_tkts ** TKTS)
│ │ │ │ -0002dd20: 0a20 2020 2020 544b 5453 3a20 7469 636b  .     TKTS: tick
│ │ │ │ -0002dd30: 6574 2073 6574 2068 616e 646c 6520 6173  et set handle as
│ │ │ │ -0002dd40: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ -0002dd50: 9873 6869 7368 695f 746b 7473 2829 e280  .shishi_tkts()..
│ │ │ │ -0002dd60: 992e 0a0a 2020 2020 202a 4465 7363 7269  ....     *Descri
│ │ │ │ -0002dd70: 7074 696f 6e3a 2a20 4465 616c 6c6f 6361  ption:* Dealloca
│ │ │ │ -0002dd80: 7465 7320 616c 6c20 7265 736f 7572 6365  tes all resource
│ │ │ │ -0002dd90: 7320 6173 736f 6369 6174 6564 2077 6974  s associated wit
│ │ │ │ -0002dda0: 6820 7469 636b 6574 0a20 2020 2020 7365  h ticket.     se
│ │ │ │ -0002ddb0: 742e 2020 5468 6520 7469 636b 6574 2073  t.  The ticket s
│ │ │ │ -0002ddc0: 6574 2068 616e 646c 6520 6d75 7374 206e  et handle must n
│ │ │ │ -0002ddd0: 6f74 2062 6520 7573 6564 2069 6e20 6361  ot be used in ca
│ │ │ │ -0002dde0: 6c6c 7320 746f 206f 7468 6572 0a20 2020  lls to other.   
│ │ │ │ -0002ddf0: 2020 7368 6973 6869 5f74 6b74 735f 2a28    shishi_tkts_*(
│ │ │ │ -0002de00: 2920 6675 6e63 7469 6f6e 7320 6166 7465  ) functions afte
│ │ │ │ -0002de10: 7220 7468 6973 2e0a 0a73 6869 7368 695f  r this...shishi_
│ │ │ │ -0002de20: 746b 7473 5f73 697a 650a 2d2d 2d2d 2d2d  tkts_size.------
│ │ │ │ -0002de30: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ -0002de40: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ -0002de50: 6973 6869 5f74 6b74 735f 7369 7a65 2028  ishi_tkts_size (
│ │ │ │ -0002de60: 5368 6973 6869 5f74 6b74 7320 2a20 544b  Shishi_tkts * TK
│ │ │ │ -0002de70: 5453 290a 2020 2020 2054 4b54 533a 2074  TS).     TKTS: t
│ │ │ │ -0002de80: 6963 6b65 7420 7365 7420 6861 6e64 6c65  icket set handle
│ │ │ │ -0002de90: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ -0002dea0: 20e2 8098 7368 6973 6869 5f74 6b74 7328   ...shishi_tkts(
│ │ │ │ -0002deb0: 29e2 8099 2e0a 0a20 2020 2020 2a44 6573  )......     *Des
│ │ │ │ -0002dec0: 6372 6970 7469 6f6e 3a2a 2047 6574 2073  cription:* Get s
│ │ │ │ -0002ded0: 697a 6520 6f66 2074 6963 6b65 7420 7365  ize of ticket se
│ │ │ │ -0002dee0: 742e 0a0a 2020 2020 202a 5265 7475 726e  t...     *Return
│ │ │ │ -0002def0: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ -0002df00: 206e 756d 6265 7220 6f66 2074 6963 6b65   number of ticke
│ │ │ │ -0002df10: 7473 2073 746f 7265 6420 696e 2074 6963  ts stored in tic
│ │ │ │ -0002df20: 6b65 7420 7365 742e 0a0a 7368 6973 6869  ket set...shishi
│ │ │ │ -0002df30: 5f74 6b74 735f 6e74 680a 2d2d 2d2d 2d2d  _tkts_nth.------
│ │ │ │ -0002df40: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ -0002df50: 756e 6374 696f 6e3a 2053 6869 7368 695f  unction: Shishi_
│ │ │ │ -0002df60: 746b 7420 2a20 7368 6973 6869 5f74 6b74  tkt * shishi_tkt
│ │ │ │ -0002df70: 735f 6e74 6820 2853 6869 7368 695f 746b  s_nth (Shishi_tk
│ │ │ │ -0002df80: 7473 202a 2054 4b54 532c 0a20 2020 2020  ts * TKTS,.     
│ │ │ │ -0002df90: 2020 2020 2069 6e74 2054 4943 4b45 544e       int TICKETN
│ │ │ │ -0002dfa0: 4f29 0a20 2020 2020 544b 5453 3a20 7469  O).     TKTS: ti
│ │ │ │ -0002dfb0: 636b 6574 2073 6574 2068 616e 646c 6520  cket set handle 
│ │ │ │ -0002dfc0: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ -0002dfd0: e280 9873 6869 7368 695f 746b 7473 2829  ...shishi_tkts()
│ │ │ │ -0002dfe0: e280 992e 0a20 2020 2020 5449 434b 4554  .....     TICKET
│ │ │ │ -0002dff0: 4e4f 3a20 696e 7465 6765 7220 696e 6469  NO: integer indi
│ │ │ │ -0002e000: 6361 7469 6e67 2072 6571 7565 7374 6564  cating requested
│ │ │ │ -0002e010: 2074 6963 6b65 7420 696e 2074 6963 6b65   ticket in ticke
│ │ │ │ -0002e020: 7420 7365 742e 0a0a 2020 2020 202a 4765  t set...     *Ge
│ │ │ │ -0002e030: 7420 7468 6520 6e3a 2a20 7468 2074 6963  t the n:* th tic
│ │ │ │ -0002e040: 6b65 7420 696e 2074 6963 6b65 7420 7365  ket in ticket se
│ │ │ │ -0002e050: 742e 0a0a 2020 2020 202a 5265 7475 726e  t...     *Return
│ │ │ │ -0002e060: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ -0002e070: 2061 2074 6963 6b65 7420 6861 6e64 6c65   a ticket handle
│ │ │ │ -0002e080: 2074 6f20 7468 6520 7469 636b 6574 6e6f   to the ticketno
│ │ │ │ -0002e090: 3a74 6820 7469 636b 6574 0a20 2020 2020  :th ticket.     
│ │ │ │ -0002e0a0: 696e 2074 6865 2074 6963 6b65 7420 7365  in the ticket se
│ │ │ │ -0002e0b0: 742c 206f 7220 4e55 4c4c 2069 6620 7469  t, or NULL if ti
│ │ │ │ -0002e0c0: 636b 6574 2073 6574 2069 7320 696e 7661  cket set is inva
│ │ │ │ -0002e0d0: 6c69 6420 6f72 2074 6963 6b65 746e 6f20  lid or ticketno 
│ │ │ │ -0002e0e0: 6973 0a20 2020 2020 6f75 7420 6f66 2062  is.     out of b
│ │ │ │ -0002e0f0: 6f75 6e64 732e 2020 5468 6520 6669 7273  ounds.  The firs
│ │ │ │ -0002e100: 7420 7469 636b 6574 2069 7320 7469 636b  t ticket is tick
│ │ │ │ -0002e110: 6574 6e6f 2030 2c20 7468 6520 7365 636f  etno 0, the seco
│ │ │ │ -0002e120: 6e64 2074 6963 6b65 746e 6f0a 2020 2020  nd ticketno.    
│ │ │ │ -0002e130: 2031 2c20 616e 6420 736f 206f 6e2e 0a0a   1, and so on...
│ │ │ │ -0002e140: 7368 6973 6869 5f74 6b74 735f 7265 6d6f  shishi_tkts_remo
│ │ │ │ -0002e150: 7665 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ve.-------------
│ │ │ │ -0002e160: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ -0002e170: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ -0002e180: 746b 7473 5f72 656d 6f76 6520 2853 6869  tkts_remove (Shi
│ │ │ │ -0002e190: 7368 695f 746b 7473 202a 2054 4b54 532c  shi_tkts * TKTS,
│ │ │ │ -0002e1a0: 2069 6e74 2054 4943 4b45 544e 4f29 0a20   int TICKETNO). 
│ │ │ │ -0002e1b0: 2020 2020 544b 5453 3a20 7469 636b 6574      TKTS: ticket
│ │ │ │ -0002e1c0: 2073 6574 2068 616e 646c 6520 6173 2061   set handle as a
│ │ │ │ -0002e1d0: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ -0002e1e0: 6869 7368 695f 746b 7473 2829 e280 992e  hishi_tkts()....
│ │ │ │ -0002e1f0: 0a20 2020 2020 5449 434b 4554 4e4f 3a20  .     TICKETNO: 
│ │ │ │ -0002e200: 7469 636b 6574 206e 756d 6265 7220 6f66  ticket number of
│ │ │ │ -0002e210: 2074 6963 6b65 7420 696e 2074 6865 2073   ticket in the s
│ │ │ │ -0002e220: 6574 2074 6f20 7265 6d6f 7665 2e20 2054  et to remove.  T
│ │ │ │ -0002e230: 6865 2066 6972 7374 0a20 2020 2020 7469  he first.     ti
│ │ │ │ -0002e240: 636b 6574 2069 7320 7469 636b 6574 206e  cket is ticket n
│ │ │ │ -0002e250: 756d 6265 7220 302e 0a0a 2020 2020 202a  umber 0...     *
│ │ │ │ -0002e260: 4465 7363 7269 7074 696f 6e3a 2a20 5265  Description:* Re
│ │ │ │ -0002e270: 6d6f 7665 2061 2074 6963 6b65 742c 2069  move a ticket, i
│ │ │ │ -0002e280: 6e64 6578 6564 2062 7920 5449 434b 4554  ndexed by TICKET
│ │ │ │ -0002e290: 4e4f 2c20 696e 2074 6963 6b65 7420 7365  NO, in ticket se
│ │ │ │ -0002e2a0: 742e 0a0a 2020 2020 202a 5265 7475 726e  t...     *Return
│ │ │ │ -0002e2b0: 2076 616c 7565 3a2a 20e2 8098 5348 4953   value:* ...SHIS
│ │ │ │ -0002e2c0: 4849 5f4f 4be2 8099 2069 6620 7375 6363  HI_OK... if succ
│ │ │ │ -0002e2d0: 6573 7366 756c 206f 7220 6966 2054 4943  essful or if TIC
│ │ │ │ -0002e2e0: 4b45 544e 4f20 6c61 7267 6572 0a20 2020  KETNO larger.   
│ │ │ │ -0002e2f0: 2020 7468 616e 2073 697a 6520 6f66 2074    than size of t
│ │ │ │ -0002e300: 6963 6b65 7420 7365 742e 0a0a 7368 6973  icket set...shis
│ │ │ │ -0002e310: 6869 5f74 6b74 735f 6164 640a 2d2d 2d2d  hi_tkts_add.----
│ │ │ │ -0002e320: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ -0002e330: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ -0002e340: 6869 7368 695f 746b 7473 5f61 6464 2028  hishi_tkts_add (
│ │ │ │ -0002e350: 5368 6973 6869 5f74 6b74 7320 2a20 544b  Shishi_tkts * TK
│ │ │ │ -0002e360: 5453 2c20 5368 6973 6869 5f74 6b74 202a  TS, Shishi_tkt *
│ │ │ │ -0002e370: 2054 4b54 290a 2020 2020 2054 4b54 533a   TKT).     TKTS:
│ │ │ │ -0002e380: 2074 6963 6b65 7420 7365 7420 6861 6e64   ticket set hand
│ │ │ │ -0002e390: 6c65 2061 7320 616c 6c6f 6361 7465 6420  le as allocated 
│ │ │ │ -0002e3a0: 6279 20e2 8098 7368 6973 6869 5f74 6b74  by ...shishi_tkt
│ │ │ │ -0002e3b0: 7328 29e2 8099 2e0a 2020 2020 2054 4b54  s().....     TKT
│ │ │ │ -0002e3c0: 3a20 7469 636b 6574 2074 6f20 6265 2061  : ticket to be a
│ │ │ │ -0002e3d0: 6464 6564 2074 6f20 7469 636b 6574 2073  dded to ticket s
│ │ │ │ -0002e3e0: 6574 2e0a 0a20 2020 2020 2a44 6573 6372  et...     *Descr
│ │ │ │ -0002e3f0: 6970 7469 6f6e 3a2a 2041 6464 2061 2074  iption:* Add a t
│ │ │ │ -0002e400: 6963 6b65 7420 746f 2074 6865 2074 6963  icket to the tic
│ │ │ │ -0002e410: 6b65 7420 7365 742e 2020 4f6e 6c79 2074  ket set.  Only t
│ │ │ │ -0002e420: 6865 2070 6f69 6e74 6572 2069 730a 2020  he pointer is.  
│ │ │ │ -0002e430: 2020 2073 746f 7265 642c 2073 6f20 6966     stored, so if
│ │ │ │ -0002e440: 2079 6f75 206d 6f64 6966 7920 544b 542c   you modify TKT,
│ │ │ │ -0002e450: 2074 6865 2074 6963 6b65 7420 696e 2074   the ticket in t
│ │ │ │ -0002e460: 6865 2074 6963 6b65 7420 7365 7420 7769  he ticket set wi
│ │ │ │ -0002e470: 6c6c 0a20 2020 2020 616c 736f 2062 6520  ll.     also be 
│ │ │ │ -0002e480: 6d6f 6469 6669 6564 2e0a 0a20 2020 2020  modified...     
│ │ │ │ -0002e490: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ -0002e4a0: 5265 7475 726e 7320 e280 9853 4849 5348  Returns ...SHISH
│ │ │ │ -0002e4b0: 495f 4f4b e280 9920 6966 6620 7375 6363  I_OK... iff succ
│ │ │ │ -0002e4c0: 6573 7366 756c 2e0a 0a73 6869 7368 695f  essful...shishi_
│ │ │ │ -0002e4d0: 746b 7473 5f6e 6577 0a2d 2d2d 2d2d 2d2d  tkts_new.-------
│ │ │ │ -0002e4e0: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -0002e4f0: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ -0002e500: 6869 5f74 6b74 735f 6e65 7720 2853 6869  hi_tkts_new (Shi
│ │ │ │ -0002e510: 7368 695f 746b 7473 202a 2054 4b54 532c  shi_tkts * TKTS,
│ │ │ │ -0002e520: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ -0002e530: 695f 6173 6e31 2054 4943 4b45 542c 2053  i_asn1 TICKET, S
│ │ │ │ -0002e540: 6869 7368 695f 6173 6e31 2045 4e43 4b44  hishi_asn1 ENCKD
│ │ │ │ -0002e550: 4352 4550 5041 5254 2c0a 2020 2020 2020  CREPPART,.      
│ │ │ │ -0002e560: 2020 2020 5368 6973 6869 5f61 736e 3120      Shishi_asn1 
│ │ │ │ -0002e570: 4b44 4352 4550 290a 2020 2020 2054 4b54  KDCREP).     TKT
│ │ │ │ -0002e580: 533a 2074 6963 6b65 7420 7365 7420 6861  S: ticket set ha
│ │ │ │ -0002e590: 6e64 6c65 2061 7320 616c 6c6f 6361 7465  ndle as allocate
│ │ │ │ -0002e5a0: 6420 6279 20e2 8098 7368 6973 6869 5f74  d by ...shishi_t
│ │ │ │ -0002e5b0: 6b74 7328 29e2 8099 2e0a 2020 2020 2054  kts().....     T
│ │ │ │ -0002e5c0: 4943 4b45 543a 2069 6e70 7574 2074 6963  ICKET: input tic
│ │ │ │ -0002e5d0: 6b65 7420 7661 7269 6162 6c65 2e0a 2020  ket variable..  
│ │ │ │ -0002e5e0: 2020 2045 4e43 4b44 4352 4550 5041 5254     ENCKDCREPPART
│ │ │ │ -0002e5f0: 3a20 696e 7075 7420 7469 636b 6574 2064  : input ticket d
│ │ │ │ -0002e600: 6574 6169 6c20 7661 7269 6162 6c65 2e0a  etail variable..
│ │ │ │ -0002e610: 2020 2020 204b 4443 5245 503a 2069 6e70       KDCREP: inp
│ │ │ │ -0002e620: 7574 204b 4443 2d52 4550 2076 6172 6961  ut KDC-REP varia
│ │ │ │ -0002e630: 626c 652e 0a0a 2020 2020 202a 4465 7363  ble...     *Desc
│ │ │ │ -0002e640: 7269 7074 696f 6e3a 2a20 416c 6c6f 6361  ription:* Alloca
│ │ │ │ -0002e650: 7465 2061 206e 6577 2074 6963 6b65 7420  te a new ticket 
│ │ │ │ -0002e660: 616e 6420 6164 6420 6974 2074 6f20 7468  and add it to th
│ │ │ │ -0002e670: 6520 7469 636b 6574 2073 6574 2e0a 0a20  e ticket set... 
│ │ │ │ -0002e680: 2020 2020 4e6f 7465 2074 6861 7420 5449      Note that TI
│ │ │ │ -0002e690: 434b 4554 2c20 454e 434b 4443 5245 5050  CKET, ENCKDCREPP
│ │ │ │ -0002e6a0: 4152 5420 616e 6420 4b44 4352 4550 2061  ART and KDCREP a
│ │ │ │ -0002e6b0: 7265 2073 746f 7265 6420 6279 2072 6566  re stored by ref
│ │ │ │ -0002e6c0: 6572 656e 6365 2c0a 2020 2020 2073 6f20  erence,.     so 
│ │ │ │ -0002e6d0: 796f 7520 6d75 7374 206e 6f74 2064 652d  you must not de-
│ │ │ │ -0002e6e0: 616c 6c6f 6361 7465 2074 6865 6d20 6265  allocate them be
│ │ │ │ -0002e6f0: 666f 7265 2074 6865 2074 6963 6b65 7420  fore the ticket 
│ │ │ │ -0002e700: 6973 2072 656d 6f76 6564 2066 726f 6d0a  is removed from.
│ │ │ │ -0002e710: 2020 2020 2074 6865 2074 6963 6b65 7420       the ticket 
│ │ │ │ -0002e720: 7365 7420 616e 6420 6465 2d61 6c6c 6f63  set and de-alloc
│ │ │ │ -0002e730: 6174 6564 2e0a 0a20 2020 2020 2a52 6574  ated...     *Ret
│ │ │ │ -0002e740: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ -0002e750: 726e 7320 e280 9853 4849 5348 495f 4f4b  rns ...SHISHI_OK
│ │ │ │ -0002e760: e280 9920 6966 6620 7375 6363 6573 7366  ... iff successf
│ │ │ │ -0002e770: 756c 2e0a 0a73 6869 7368 695f 746b 7473  ul...shishi_tkts
│ │ │ │ -0002e780: 5f72 6561 640a 2d2d 2d2d 2d2d 2d2d 2d2d  _read.----------
│ │ │ │ -0002e790: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ -0002e7a0: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ -0002e7b0: 5f74 6b74 735f 7265 6164 2028 5368 6973  _tkts_read (Shis
│ │ │ │ -0002e7c0: 6869 5f74 6b74 7320 2a20 544b 5453 2c20  hi_tkts * TKTS, 
│ │ │ │ -0002e7d0: 4649 4c45 202a 2046 4829 0a20 2020 2020  FILE * FH).     
│ │ │ │ -0002e7e0: 544b 5453 3a20 7469 636b 6574 2073 6574  TKTS: ticket set
│ │ │ │ -0002e7f0: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ -0002e800: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ -0002e810: 695f 746b 7473 2829 e280 992e 0a20 2020  i_tkts().....   
│ │ │ │ -0002e820: 2020 4648 3a20 6669 6c65 2064 6573 6372    FH: file descr
│ │ │ │ -0002e830: 6970 746f 7220 746f 2072 6561 6420 6672  iptor to read fr
│ │ │ │ -0002e840: 6f6d 2e0a 0a20 2020 2020 2a44 6573 6372  om...     *Descr
│ │ │ │ -0002e850: 6970 7469 6f6e 3a2a 2052 6561 6420 7469  iption:* Read ti
│ │ │ │ -0002e860: 636b 6574 7320 6672 6f6d 2066 696c 6520  ckets from file 
│ │ │ │ -0002e870: 6465 7363 7269 7074 6f72 2061 6e64 2061  descriptor and a
│ │ │ │ -0002e880: 6464 2074 6865 6d20 746f 0a20 2020 2020  dd them to.     
│ │ │ │ -0002e890: 7468 6520 7469 636b 6574 2073 6574 2e0a  the ticket set..
│ │ │ │ -0002e8a0: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ -0002e8b0: 6c75 653a 2a20 5265 7475 726e 7320 e280  lue:* Returns ..
│ │ │ │ -0002e8c0: 9853 4849 5348 495f 4f4b e280 9920 6966  .SHISHI_OK... if
│ │ │ │ -0002e8d0: 6620 7375 6363 6573 7366 756c 2e0a 0a73  f successful...s
│ │ │ │ -0002e8e0: 6869 7368 695f 746b 7473 5f66 726f 6d5f  hishi_tkts_from_
│ │ │ │ -0002e8f0: 6669 6c65 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  file.-----------
│ │ │ │ -0002e900: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ -0002e910: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ -0002e920: 6973 6869 5f74 6b74 735f 6672 6f6d 5f66  ishi_tkts_from_f
│ │ │ │ -0002e930: 696c 6520 2853 6869 7368 695f 746b 7473  ile (Shishi_tkts
│ │ │ │ -0002e940: 202a 2054 4b54 532c 0a20 2020 2020 2020   * TKTS,.       
│ │ │ │ -0002e950: 2020 2063 6f6e 7374 2063 6861 7220 2a20     const char * 
│ │ │ │ -0002e960: 4649 4c45 4e41 4d45 290a 2020 2020 2054  FILENAME).     T
│ │ │ │ -0002e970: 4b54 533a 2074 6963 6b65 7420 7365 7420  KTS: ticket set 
│ │ │ │ -0002e980: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ -0002e990: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ -0002e9a0: 5f74 6b74 7328 29e2 8099 2e0a 2020 2020  _tkts().....    
│ │ │ │ -0002e9b0: 2046 494c 454e 414d 453a 2066 696c 656e   FILENAME: filen
│ │ │ │ -0002e9c0: 616d 6520 746f 2072 6561 6420 7469 636b  ame to read tick
│ │ │ │ -0002e9d0: 6574 7320 6672 6f6d 2e0a 0a20 2020 2020  ets from...     
│ │ │ │ -0002e9e0: 2a44 6573 6372 6970 7469 6f6e 3a2a 2052  *Description:* R
│ │ │ │ -0002e9f0: 6561 6420 7469 636b 6574 7320 6672 6f6d  ead tickets from
│ │ │ │ -0002ea00: 2066 696c 6520 616e 6420 6164 6420 7468   file and add th
│ │ │ │ -0002ea10: 656d 2074 6f20 7468 6520 7469 636b 6574  em to the ticket
│ │ │ │ -0002ea20: 0a20 2020 2020 7365 742e 0a0a 2020 2020  .     set...    
│ │ │ │ -0002ea30: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ -0002ea40: 2052 6574 7572 6e73 20e2 8098 5348 4953   Returns ...SHIS
│ │ │ │ -0002ea50: 4849 5f4f 4be2 8099 2069 6666 2073 7563  HI_OK... iff suc
│ │ │ │ -0002ea60: 6365 7373 6675 6c2e 0a0a 7368 6973 6869  cessful...shishi
│ │ │ │ -0002ea70: 5f74 6b74 735f 7772 6974 650a 2d2d 2d2d  _tkts_write.----
│ │ │ │ -0002ea80: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -0002ea90: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ -0002eaa0: 2073 6869 7368 695f 746b 7473 5f77 7269   shishi_tkts_wri
│ │ │ │ -0002eab0: 7465 2028 5368 6973 6869 5f74 6b74 7320  te (Shishi_tkts 
│ │ │ │ -0002eac0: 2a20 544b 5453 2c20 4649 4c45 202a 2046  * TKTS, FILE * F
│ │ │ │ -0002ead0: 4829 0a20 2020 2020 544b 5453 3a20 7469  H).     TKTS: ti
│ │ │ │ -0002eae0: 636b 6574 2073 6574 2068 616e 646c 6520  cket set handle 
│ │ │ │ -0002eaf0: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ -0002eb00: e280 9873 6869 7368 695f 746b 7473 2829  ...shishi_tkts()
│ │ │ │ -0002eb10: e280 992e 0a20 2020 2020 4648 3a20 6669  .....     FH: fi
│ │ │ │ -0002eb20: 6c65 2064 6573 6372 6970 746f 7220 746f  le descriptor to
│ │ │ │ -0002eb30: 2077 7269 7465 2074 6963 6b65 7473 2074   write tickets t
│ │ │ │ -0002eb40: 6f2e 0a0a 2020 2020 202a 4465 7363 7269  o...     *Descri
│ │ │ │ -0002eb50: 7074 696f 6e3a 2a20 5772 6974 6520 7469  ption:* Write ti
│ │ │ │ -0002eb60: 636b 6574 7320 696e 2073 6574 2074 6f20  ckets in set to 
│ │ │ │ -0002eb70: 6669 6c65 2064 6573 6372 6970 746f 722e  file descriptor.
│ │ │ │ -0002eb80: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ -0002eb90: 616c 7565 3a2a 2052 6574 7572 6e73 20e2  alue:* Returns .
│ │ │ │ -0002eba0: 8098 5348 4953 4849 5f4f 4be2 8099 2069  ..SHISHI_OK... i
│ │ │ │ -0002ebb0: 6666 2073 7563 6365 7373 6675 6c2e 0a0a  ff successful...
│ │ │ │ -0002ebc0: 7368 6973 6869 5f74 6b74 735f 6578 7069  shishi_tkts_expi
│ │ │ │ -0002ebd0: 7265 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  re.-------------
│ │ │ │ -0002ebe0: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ -0002ebf0: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ -0002ec00: 746b 7473 5f65 7870 6972 6520 2853 6869  tkts_expire (Shi
│ │ │ │ -0002ec10: 7368 695f 746b 7473 202a 2054 4b54 5329  shi_tkts * TKTS)
│ │ │ │ -0002ec20: 0a20 2020 2020 544b 5453 3a20 7469 636b  .     TKTS: tick
│ │ │ │ -0002ec30: 6574 2073 6574 2068 616e 646c 6520 6173  et set handle as
│ │ │ │ -0002ec40: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ -0002ec50: 9873 6869 7368 695f 746b 7473 2829 e280  .shishi_tkts()..
│ │ │ │ -0002ec60: 992e 0a0a 2020 2020 202a 4465 7363 7269  ....     *Descri
│ │ │ │ -0002ec70: 7074 696f 6e3a 2a20 5265 6d6f 7665 2065  ption:* Remove e
│ │ │ │ -0002ec80: 7870 6972 6564 2074 6963 6b65 7473 2066  xpired tickets f
│ │ │ │ -0002ec90: 726f 6d20 7469 636b 6574 2073 6574 2e0a  rom ticket set..
│ │ │ │ -0002eca0: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ -0002ecb0: 6c75 653a 2a20 5265 7475 726e 7320 e280  lue:* Returns ..
│ │ │ │ -0002ecc0: 9853 4849 5348 495f 4f4b e280 9920 6966  .SHISHI_OK... if
│ │ │ │ -0002ecd0: 6620 7375 6363 6573 7366 756c 2e0a 0a73  f successful...s
│ │ │ │ -0002ece0: 6869 7368 695f 746b 7473 5f74 6f5f 6669  hishi_tkts_to_fi
│ │ │ │ -0002ecf0: 6c65 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  le.-------------
│ │ │ │ -0002ed00: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ -0002ed10: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ -0002ed20: 5f74 6b74 735f 746f 5f66 696c 6520 2853  _tkts_to_file (S
│ │ │ │ -0002ed30: 6869 7368 695f 746b 7473 202a 2054 4b54  hishi_tkts * TKT
│ │ │ │ -0002ed40: 532c 0a20 2020 2020 2020 2020 2063 6f6e  S,.          con
│ │ │ │ -0002ed50: 7374 2063 6861 7220 2a20 4649 4c45 4e41  st char * FILENA
│ │ │ │ -0002ed60: 4d45 290a 2020 2020 2054 4b54 533a 2074  ME).     TKTS: t
│ │ │ │ -0002ed70: 6963 6b65 7420 7365 7420 6861 6e64 6c65  icket set handle
│ │ │ │ -0002ed80: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ -0002ed90: 20e2 8098 7368 6973 6869 5f74 6b74 7328   ...shishi_tkts(
│ │ │ │ -0002eda0: 29e2 8099 2e0a 2020 2020 2046 494c 454e  ).....     FILEN
│ │ │ │ -0002edb0: 414d 453a 2066 696c 656e 616d 6520 746f  AME: filename to
│ │ │ │ -0002edc0: 2077 7269 7465 2074 6963 6b65 7473 2074   write tickets t
│ │ │ │ -0002edd0: 6f2e 0a0a 2020 2020 202a 4465 7363 7269  o...     *Descri
│ │ │ │ -0002ede0: 7074 696f 6e3a 2a20 5772 6974 6520 7469  ption:* Write ti
│ │ │ │ -0002edf0: 636b 6574 7320 696e 2073 6574 2074 6f20  ckets in set to 
│ │ │ │ -0002ee00: 6669 6c65 2e0a 0a20 2020 2020 2a52 6574  file...     *Ret
│ │ │ │ -0002ee10: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ -0002ee20: 726e 7320 e280 9853 4849 5348 495f 4f4b  rns ...SHISHI_OK
│ │ │ │ -0002ee30: e280 9920 6966 6620 7375 6363 6573 7366  ... iff successf
│ │ │ │ -0002ee40: 756c 2e0a 0a73 6869 7368 695f 746b 7473  ul...shishi_tkts
│ │ │ │ -0002ee50: 5f70 7269 6e74 5f66 6f72 5f73 6572 7669  _print_for_servi
│ │ │ │ -0002ee60: 6365 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ce.-------------
│ │ │ │ +0002d880: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ +0002d890: 6e3a 2076 6f69 6420 7368 6973 6869 5f74  n: void shishi_t
│ │ │ │ +0002d8a0: 6b74 735f 6465 6661 756c 745f 6669 6c65  kts_default_file
│ │ │ │ +0002d8b0: 5f73 6574 2028 5368 6973 6869 202a 2048  _set (Shishi * H
│ │ │ │ +0002d8c0: 414e 444c 452c 0a20 2020 2020 2020 2020  ANDLE,.         
│ │ │ │ +0002d8d0: 2063 6f6e 7374 2063 6861 7220 2a20 544b   const char * TK
│ │ │ │ +0002d8e0: 5453 4649 4c45 290a 2020 2020 2048 414e  TSFILE).     HAN
│ │ │ │ +0002d8f0: 444c 453a 2053 6869 7368 6920 6c69 6272  DLE: Shishi libr
│ │ │ │ +0002d900: 6172 7920 6861 6e64 6c65 2063 7265 6174  ary handle creat
│ │ │ │ +0002d910: 6520 6279 20e2 8098 7368 6973 6869 5f69  e by ...shishi_i
│ │ │ │ +0002d920: 6e69 7428 29e2 8099 2e0a 2020 2020 2054  nit().....     T
│ │ │ │ +0002d930: 4b54 5346 494c 453a 2073 7472 696e 6720  KTSFILE: string 
│ │ │ │ +0002d940: 7769 7468 206e 6577 2064 6566 6175 6c74  with new default
│ │ │ │ +0002d950: 2074 6b74 7320 6669 6c65 206e 616d 652c   tkts file name,
│ │ │ │ +0002d960: 206f 7220 4e55 4c4c 2074 6f20 7265 7365   or NULL to rese
│ │ │ │ +0002d970: 740a 2020 2020 2074 6f20 6465 6661 756c  t.     to defaul
│ │ │ │ +0002d980: 742e 0a0a 2020 2020 202a 4465 7363 7269  t...     *Descri
│ │ │ │ +0002d990: 7074 696f 6e3a 2a20 5365 7420 7468 6520  ption:* Set the 
│ │ │ │ +0002d9a0: 6465 6661 756c 7420 7469 636b 6574 2073  default ticket s
│ │ │ │ +0002d9b0: 6574 2066 696c 656e 616d 6520 7573 6564  et filename used
│ │ │ │ +0002d9c0: 2069 6e20 7468 650a 2020 2020 206c 6962   in the.     lib
│ │ │ │ +0002d9d0: 7261 7279 2e20 2054 6865 2073 7472 696e  rary.  The strin
│ │ │ │ +0002d9e0: 6720 6973 2063 6f70 6965 6420 696e 746f  g is copied into
│ │ │ │ +0002d9f0: 2074 6865 206c 6962 7261 7279 2c20 736f   the library, so
│ │ │ │ +0002da00: 2079 6f75 2063 616e 2064 6973 706f 7365   you can dispose
│ │ │ │ +0002da10: 0a20 2020 2020 6f66 2074 6865 2076 6172  .     of the var
│ │ │ │ +0002da20: 6961 626c 6520 696d 6d65 6469 6174 656c  iable immediatel
│ │ │ │ +0002da30: 7920 6166 7465 7220 6361 6c6c 696e 6720  y after calling 
│ │ │ │ +0002da40: 7468 6973 2066 756e 6374 696f 6e2e 0a0a  this function...
│ │ │ │ +0002da50: 7368 6973 6869 5f74 6b74 735f 6465 6661  shishi_tkts_defa
│ │ │ │ +0002da60: 756c 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ult.------------
│ │ │ │ +0002da70: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +0002da80: 6374 696f 6e3a 2053 6869 7368 695f 746b  ction: Shishi_tk
│ │ │ │ +0002da90: 7473 202a 2073 6869 7368 695f 746b 7473  ts * shishi_tkts
│ │ │ │ +0002daa0: 5f64 6566 6175 6c74 2028 5368 6973 6869  _default (Shishi
│ │ │ │ +0002dab0: 202a 2048 414e 444c 4529 0a20 2020 2020   * HANDLE).     
│ │ │ │ +0002dac0: 4841 4e44 4c45 3a20 5368 6973 6869 206c  HANDLE: Shishi l
│ │ │ │ +0002dad0: 6962 7261 7279 2068 616e 646c 6520 6372  ibrary handle cr
│ │ │ │ +0002dae0: 6561 7465 2062 7920 e280 9873 6869 7368  eate by ...shish
│ │ │ │ +0002daf0: 695f 696e 6974 2829 e280 992e 0a0a 2020  i_init()......  
│ │ │ │ +0002db00: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ +0002db10: 2a20 4765 7420 7468 6520 6465 6661 756c  * Get the defaul
│ │ │ │ +0002db20: 7420 7469 636b 6574 2073 6574 2066 6f72  t ticket set for
│ │ │ │ +0002db30: 206c 6962 7261 7279 2068 616e 646c 652e   library handle.
│ │ │ │ +0002db40: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ +0002db50: 616c 7565 3a2a 2052 6574 7572 6e20 7468  alue:* Return th
│ │ │ │ +0002db60: 6520 6861 6e64 6c65 2067 6c6f 6261 6c20  e handle global 
│ │ │ │ +0002db70: 7469 636b 6574 2073 6574 2e0a 0a73 6869  ticket set...shi
│ │ │ │ +0002db80: 7368 695f 746b 7473 0a2d 2d2d 2d2d 2d2d  shi_tkts.-------
│ │ │ │ +0002db90: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ +0002dba0: 6f6e 3a20 696e 7420 7368 6973 6869 5f74  on: int shishi_t
│ │ │ │ +0002dbb0: 6b74 7320 2853 6869 7368 6920 2a20 4841  kts (Shishi * HA
│ │ │ │ +0002dbc0: 4e44 4c45 2c20 5368 6973 6869 5f74 6b74  NDLE, Shishi_tkt
│ │ │ │ +0002dbd0: 7320 2a2a 2054 4b54 5329 0a20 2020 2020  s ** TKTS).     
│ │ │ │ +0002dbe0: 4841 4e44 4c45 3a20 7368 6973 6869 2068  HANDLE: shishi h
│ │ │ │ +0002dbf0: 616e 646c 6520 6173 2061 6c6c 6f63 6174  andle as allocat
│ │ │ │ +0002dc00: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ +0002dc10: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ +0002dc20: 544b 5453 3a20 6f75 7470 7574 2070 6f69  TKTS: output poi
│ │ │ │ +0002dc30: 6e74 6572 2074 6f20 6e65 776c 7920 616c  nter to newly al
│ │ │ │ +0002dc40: 6c6f 6361 7465 6420 746b 7473 2068 616e  located tkts han
│ │ │ │ +0002dc50: 646c 652e 0a0a 2020 2020 202a 4465 7363  dle...     *Desc
│ │ │ │ +0002dc60: 7269 7074 696f 6e3a 2a20 4765 7420 6120  ription:* Get a 
│ │ │ │ +0002dc70: 6e65 7720 7469 636b 6574 2073 6574 2068  new ticket set h
│ │ │ │ +0002dc80: 616e 646c 652e 0a0a 2020 2020 202a 5265  andle...     *Re
│ │ │ │ +0002dc90: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ +0002dca0: 7572 6e73 20e2 8098 5348 4953 4849 5f4f  urns ...SHISHI_O
│ │ │ │ +0002dcb0: 4be2 8099 2069 6666 2073 7563 6365 7373  K... iff success
│ │ │ │ +0002dcc0: 6675 6c2e 0a0a 7368 6973 6869 5f74 6b74  ful...shishi_tkt
│ │ │ │ +0002dcd0: 735f 646f 6e65 0a2d 2d2d 2d2d 2d2d 2d2d  s_done.---------
│ │ │ │ +0002dce0: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +0002dcf0: 6374 696f 6e3a 2076 6f69 6420 7368 6973  ction: void shis
│ │ │ │ +0002dd00: 6869 5f74 6b74 735f 646f 6e65 2028 5368  hi_tkts_done (Sh
│ │ │ │ +0002dd10: 6973 6869 5f74 6b74 7320 2a2a 2054 4b54  ishi_tkts ** TKT
│ │ │ │ +0002dd20: 5329 0a20 2020 2020 544b 5453 3a20 7469  S).     TKTS: ti
│ │ │ │ +0002dd30: 636b 6574 2073 6574 2068 616e 646c 6520  cket set handle 
│ │ │ │ +0002dd40: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ +0002dd50: e280 9873 6869 7368 695f 746b 7473 2829  ...shishi_tkts()
│ │ │ │ +0002dd60: e280 992e 0a0a 2020 2020 202a 4465 7363  ......     *Desc
│ │ │ │ +0002dd70: 7269 7074 696f 6e3a 2a20 4465 616c 6c6f  ription:* Deallo
│ │ │ │ +0002dd80: 6361 7465 7320 616c 6c20 7265 736f 7572  cates all resour
│ │ │ │ +0002dd90: 6365 7320 6173 736f 6369 6174 6564 2077  ces associated w
│ │ │ │ +0002dda0: 6974 6820 7469 636b 6574 0a20 2020 2020  ith ticket.     
│ │ │ │ +0002ddb0: 7365 742e 2020 5468 6520 7469 636b 6574  set.  The ticket
│ │ │ │ +0002ddc0: 2073 6574 2068 616e 646c 6520 6d75 7374   set handle must
│ │ │ │ +0002ddd0: 206e 6f74 2062 6520 7573 6564 2069 6e20   not be used in 
│ │ │ │ +0002dde0: 6361 6c6c 7320 746f 206f 7468 6572 0a20  calls to other. 
│ │ │ │ +0002ddf0: 2020 2020 7368 6973 6869 5f74 6b74 735f      shishi_tkts_
│ │ │ │ +0002de00: 2a28 2920 6675 6e63 7469 6f6e 7320 6166  *() functions af
│ │ │ │ +0002de10: 7465 7220 7468 6973 2e0a 0a73 6869 7368  ter this...shish
│ │ │ │ +0002de20: 695f 746b 7473 5f73 697a 650a 2d2d 2d2d  i_tkts_size.----
│ │ │ │ +0002de30: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ +0002de40: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ +0002de50: 7368 6973 6869 5f74 6b74 735f 7369 7a65  shishi_tkts_size
│ │ │ │ +0002de60: 2028 5368 6973 6869 5f74 6b74 7320 2a20   (Shishi_tkts * 
│ │ │ │ +0002de70: 544b 5453 290a 2020 2020 2054 4b54 533a  TKTS).     TKTS:
│ │ │ │ +0002de80: 2074 6963 6b65 7420 7365 7420 6861 6e64   ticket set hand
│ │ │ │ +0002de90: 6c65 2061 7320 616c 6c6f 6361 7465 6420  le as allocated 
│ │ │ │ +0002dea0: 6279 20e2 8098 7368 6973 6869 5f74 6b74  by ...shishi_tkt
│ │ │ │ +0002deb0: 7328 29e2 8099 2e0a 0a20 2020 2020 2a44  s()......     *D
│ │ │ │ +0002dec0: 6573 6372 6970 7469 6f6e 3a2a 2047 6574  escription:* Get
│ │ │ │ +0002ded0: 2073 697a 6520 6f66 2074 6963 6b65 7420   size of ticket 
│ │ │ │ +0002dee0: 7365 742e 0a0a 2020 2020 202a 5265 7475  set...     *Retu
│ │ │ │ +0002def0: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ +0002df00: 6e73 206e 756d 6265 7220 6f66 2074 6963  ns number of tic
│ │ │ │ +0002df10: 6b65 7473 2073 746f 7265 6420 696e 2074  kets stored in t
│ │ │ │ +0002df20: 6963 6b65 7420 7365 742e 0a0a 7368 6973  icket set...shis
│ │ │ │ +0002df30: 6869 5f74 6b74 735f 6e74 680a 2d2d 2d2d  hi_tkts_nth.----
│ │ │ │ +0002df40: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ +0002df50: 2046 756e 6374 696f 6e3a 2053 6869 7368   Function: Shish
│ │ │ │ +0002df60: 695f 746b 7420 2a20 7368 6973 6869 5f74  i_tkt * shishi_t
│ │ │ │ +0002df70: 6b74 735f 6e74 6820 2853 6869 7368 695f  kts_nth (Shishi_
│ │ │ │ +0002df80: 746b 7473 202a 2054 4b54 532c 0a20 2020  tkts * TKTS,.   
│ │ │ │ +0002df90: 2020 2020 2020 2069 6e74 2054 4943 4b45         int TICKE
│ │ │ │ +0002dfa0: 544e 4f29 0a20 2020 2020 544b 5453 3a20  TNO).     TKTS: 
│ │ │ │ +0002dfb0: 7469 636b 6574 2073 6574 2068 616e 646c  ticket set handl
│ │ │ │ +0002dfc0: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ +0002dfd0: 7920 e280 9873 6869 7368 695f 746b 7473  y ...shishi_tkts
│ │ │ │ +0002dfe0: 2829 e280 992e 0a20 2020 2020 5449 434b  ().....     TICK
│ │ │ │ +0002dff0: 4554 4e4f 3a20 696e 7465 6765 7220 696e  ETNO: integer in
│ │ │ │ +0002e000: 6469 6361 7469 6e67 2072 6571 7565 7374  dicating request
│ │ │ │ +0002e010: 6564 2074 6963 6b65 7420 696e 2074 6963  ed ticket in tic
│ │ │ │ +0002e020: 6b65 7420 7365 742e 0a0a 2020 2020 202a  ket set...     *
│ │ │ │ +0002e030: 4765 7420 7468 6520 6e3a 2a20 7468 2074  Get the n:* th t
│ │ │ │ +0002e040: 6963 6b65 7420 696e 2074 6963 6b65 7420  icket in ticket 
│ │ │ │ +0002e050: 7365 742e 0a0a 2020 2020 202a 5265 7475  set...     *Retu
│ │ │ │ +0002e060: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ +0002e070: 6e73 2061 2074 6963 6b65 7420 6861 6e64  ns a ticket hand
│ │ │ │ +0002e080: 6c65 2074 6f20 7468 6520 7469 636b 6574  le to the ticket
│ │ │ │ +0002e090: 6e6f 3a74 6820 7469 636b 6574 0a20 2020  no:th ticket.   
│ │ │ │ +0002e0a0: 2020 696e 2074 6865 2074 6963 6b65 7420    in the ticket 
│ │ │ │ +0002e0b0: 7365 742c 206f 7220 4e55 4c4c 2069 6620  set, or NULL if 
│ │ │ │ +0002e0c0: 7469 636b 6574 2073 6574 2069 7320 696e  ticket set is in
│ │ │ │ +0002e0d0: 7661 6c69 6420 6f72 2074 6963 6b65 746e  valid or ticketn
│ │ │ │ +0002e0e0: 6f20 6973 0a20 2020 2020 6f75 7420 6f66  o is.     out of
│ │ │ │ +0002e0f0: 2062 6f75 6e64 732e 2020 5468 6520 6669   bounds.  The fi
│ │ │ │ +0002e100: 7273 7420 7469 636b 6574 2069 7320 7469  rst ticket is ti
│ │ │ │ +0002e110: 636b 6574 6e6f 2030 2c20 7468 6520 7365  cketno 0, the se
│ │ │ │ +0002e120: 636f 6e64 2074 6963 6b65 746e 6f0a 2020  cond ticketno.  
│ │ │ │ +0002e130: 2020 2031 2c20 616e 6420 736f 206f 6e2e     1, and so on.
│ │ │ │ +0002e140: 0a0a 7368 6973 6869 5f74 6b74 735f 7265  ..shishi_tkts_re
│ │ │ │ +0002e150: 6d6f 7665 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  move.-----------
│ │ │ │ +0002e160: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +0002e170: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ +0002e180: 695f 746b 7473 5f72 656d 6f76 6520 2853  i_tkts_remove (S
│ │ │ │ +0002e190: 6869 7368 695f 746b 7473 202a 2054 4b54  hishi_tkts * TKT
│ │ │ │ +0002e1a0: 532c 2069 6e74 2054 4943 4b45 544e 4f29  S, int TICKETNO)
│ │ │ │ +0002e1b0: 0a20 2020 2020 544b 5453 3a20 7469 636b  .     TKTS: tick
│ │ │ │ +0002e1c0: 6574 2073 6574 2068 616e 646c 6520 6173  et set handle as
│ │ │ │ +0002e1d0: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ +0002e1e0: 9873 6869 7368 695f 746b 7473 2829 e280  .shishi_tkts()..
│ │ │ │ +0002e1f0: 992e 0a20 2020 2020 5449 434b 4554 4e4f  ...     TICKETNO
│ │ │ │ +0002e200: 3a20 7469 636b 6574 206e 756d 6265 7220  : ticket number 
│ │ │ │ +0002e210: 6f66 2074 6963 6b65 7420 696e 2074 6865  of ticket in the
│ │ │ │ +0002e220: 2073 6574 2074 6f20 7265 6d6f 7665 2e20   set to remove. 
│ │ │ │ +0002e230: 2054 6865 2066 6972 7374 0a20 2020 2020   The first.     
│ │ │ │ +0002e240: 7469 636b 6574 2069 7320 7469 636b 6574  ticket is ticket
│ │ │ │ +0002e250: 206e 756d 6265 7220 302e 0a0a 2020 2020   number 0...    
│ │ │ │ +0002e260: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ +0002e270: 5265 6d6f 7665 2061 2074 6963 6b65 742c  Remove a ticket,
│ │ │ │ +0002e280: 2069 6e64 6578 6564 2062 7920 5449 434b   indexed by TICK
│ │ │ │ +0002e290: 4554 4e4f 2c20 696e 2074 6963 6b65 7420  ETNO, in ticket 
│ │ │ │ +0002e2a0: 7365 742e 0a0a 2020 2020 202a 5265 7475  set...     *Retu
│ │ │ │ +0002e2b0: 726e 2076 616c 7565 3a2a 20e2 8098 5348  rn value:* ...SH
│ │ │ │ +0002e2c0: 4953 4849 5f4f 4be2 8099 2069 6620 7375  ISHI_OK... if su
│ │ │ │ +0002e2d0: 6363 6573 7366 756c 206f 7220 6966 2054  ccessful or if T
│ │ │ │ +0002e2e0: 4943 4b45 544e 4f20 6c61 7267 6572 0a20  ICKETNO larger. 
│ │ │ │ +0002e2f0: 2020 2020 7468 616e 2073 697a 6520 6f66      than size of
│ │ │ │ +0002e300: 2074 6963 6b65 7420 7365 742e 0a0a 7368   ticket set...sh
│ │ │ │ +0002e310: 6973 6869 5f74 6b74 735f 6164 640a 2d2d  ishi_tkts_add.--
│ │ │ │ +0002e320: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ +0002e330: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ +0002e340: 2073 6869 7368 695f 746b 7473 5f61 6464   shishi_tkts_add
│ │ │ │ +0002e350: 2028 5368 6973 6869 5f74 6b74 7320 2a20   (Shishi_tkts * 
│ │ │ │ +0002e360: 544b 5453 2c20 5368 6973 6869 5f74 6b74  TKTS, Shishi_tkt
│ │ │ │ +0002e370: 202a 2054 4b54 290a 2020 2020 2054 4b54   * TKT).     TKT
│ │ │ │ +0002e380: 533a 2074 6963 6b65 7420 7365 7420 6861  S: ticket set ha
│ │ │ │ +0002e390: 6e64 6c65 2061 7320 616c 6c6f 6361 7465  ndle as allocate
│ │ │ │ +0002e3a0: 6420 6279 20e2 8098 7368 6973 6869 5f74  d by ...shishi_t
│ │ │ │ +0002e3b0: 6b74 7328 29e2 8099 2e0a 2020 2020 2054  kts().....     T
│ │ │ │ +0002e3c0: 4b54 3a20 7469 636b 6574 2074 6f20 6265  KT: ticket to be
│ │ │ │ +0002e3d0: 2061 6464 6564 2074 6f20 7469 636b 6574   added to ticket
│ │ │ │ +0002e3e0: 2073 6574 2e0a 0a20 2020 2020 2a44 6573   set...     *Des
│ │ │ │ +0002e3f0: 6372 6970 7469 6f6e 3a2a 2041 6464 2061  cription:* Add a
│ │ │ │ +0002e400: 2074 6963 6b65 7420 746f 2074 6865 2074   ticket to the t
│ │ │ │ +0002e410: 6963 6b65 7420 7365 742e 2020 4f6e 6c79  icket set.  Only
│ │ │ │ +0002e420: 2074 6865 2070 6f69 6e74 6572 2069 730a   the pointer is.
│ │ │ │ +0002e430: 2020 2020 2073 746f 7265 642c 2073 6f20       stored, so 
│ │ │ │ +0002e440: 6966 2079 6f75 206d 6f64 6966 7920 544b  if you modify TK
│ │ │ │ +0002e450: 542c 2074 6865 2074 6963 6b65 7420 696e  T, the ticket in
│ │ │ │ +0002e460: 2074 6865 2074 6963 6b65 7420 7365 7420   the ticket set 
│ │ │ │ +0002e470: 7769 6c6c 0a20 2020 2020 616c 736f 2062  will.     also b
│ │ │ │ +0002e480: 6520 6d6f 6469 6669 6564 2e0a 0a20 2020  e modified...   
│ │ │ │ +0002e490: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ +0002e4a0: 2a20 5265 7475 726e 7320 e280 9853 4849  * Returns ...SHI
│ │ │ │ +0002e4b0: 5348 495f 4f4b e280 9920 6966 6620 7375  SHI_OK... iff su
│ │ │ │ +0002e4c0: 6363 6573 7366 756c 2e0a 0a73 6869 7368  ccessful...shish
│ │ │ │ +0002e4d0: 695f 746b 7473 5f6e 6577 0a2d 2d2d 2d2d  i_tkts_new.-----
│ │ │ │ +0002e4e0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +0002e4f0: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ +0002e500: 6973 6869 5f74 6b74 735f 6e65 7720 2853  ishi_tkts_new (S
│ │ │ │ +0002e510: 6869 7368 695f 746b 7473 202a 2054 4b54  hishi_tkts * TKT
│ │ │ │ +0002e520: 532c 0a20 2020 2020 2020 2020 2053 6869  S,.          Shi
│ │ │ │ +0002e530: 7368 695f 6173 6e31 2054 4943 4b45 542c  shi_asn1 TICKET,
│ │ │ │ +0002e540: 2053 6869 7368 695f 6173 6e31 2045 4e43   Shishi_asn1 ENC
│ │ │ │ +0002e550: 4b44 4352 4550 5041 5254 2c0a 2020 2020  KDCREPPART,.    
│ │ │ │ +0002e560: 2020 2020 2020 5368 6973 6869 5f61 736e        Shishi_asn
│ │ │ │ +0002e570: 3120 4b44 4352 4550 290a 2020 2020 2054  1 KDCREP).     T
│ │ │ │ +0002e580: 4b54 533a 2074 6963 6b65 7420 7365 7420  KTS: ticket set 
│ │ │ │ +0002e590: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ +0002e5a0: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ +0002e5b0: 5f74 6b74 7328 29e2 8099 2e0a 2020 2020  _tkts().....    
│ │ │ │ +0002e5c0: 2054 4943 4b45 543a 2069 6e70 7574 2074   TICKET: input t
│ │ │ │ +0002e5d0: 6963 6b65 7420 7661 7269 6162 6c65 2e0a  icket variable..
│ │ │ │ +0002e5e0: 2020 2020 2045 4e43 4b44 4352 4550 5041       ENCKDCREPPA
│ │ │ │ +0002e5f0: 5254 3a20 696e 7075 7420 7469 636b 6574  RT: input ticket
│ │ │ │ +0002e600: 2064 6574 6169 6c20 7661 7269 6162 6c65   detail variable
│ │ │ │ +0002e610: 2e0a 2020 2020 204b 4443 5245 503a 2069  ..     KDCREP: i
│ │ │ │ +0002e620: 6e70 7574 204b 4443 2d52 4550 2076 6172  nput KDC-REP var
│ │ │ │ +0002e630: 6961 626c 652e 0a0a 2020 2020 202a 4465  iable...     *De
│ │ │ │ +0002e640: 7363 7269 7074 696f 6e3a 2a20 416c 6c6f  scription:* Allo
│ │ │ │ +0002e650: 6361 7465 2061 206e 6577 2074 6963 6b65  cate a new ticke
│ │ │ │ +0002e660: 7420 616e 6420 6164 6420 6974 2074 6f20  t and add it to 
│ │ │ │ +0002e670: 7468 6520 7469 636b 6574 2073 6574 2e0a  the ticket set..
│ │ │ │ +0002e680: 0a20 2020 2020 4e6f 7465 2074 6861 7420  .     Note that 
│ │ │ │ +0002e690: 5449 434b 4554 2c20 454e 434b 4443 5245  TICKET, ENCKDCRE
│ │ │ │ +0002e6a0: 5050 4152 5420 616e 6420 4b44 4352 4550  PPART and KDCREP
│ │ │ │ +0002e6b0: 2061 7265 2073 746f 7265 6420 6279 2072   are stored by r
│ │ │ │ +0002e6c0: 6566 6572 656e 6365 2c0a 2020 2020 2073  eference,.     s
│ │ │ │ +0002e6d0: 6f20 796f 7520 6d75 7374 206e 6f74 2064  o you must not d
│ │ │ │ +0002e6e0: 652d 616c 6c6f 6361 7465 2074 6865 6d20  e-allocate them 
│ │ │ │ +0002e6f0: 6265 666f 7265 2074 6865 2074 6963 6b65  before the ticke
│ │ │ │ +0002e700: 7420 6973 2072 656d 6f76 6564 2066 726f  t is removed fro
│ │ │ │ +0002e710: 6d0a 2020 2020 2074 6865 2074 6963 6b65  m.     the ticke
│ │ │ │ +0002e720: 7420 7365 7420 616e 6420 6465 2d61 6c6c  t set and de-all
│ │ │ │ +0002e730: 6f63 6174 6564 2e0a 0a20 2020 2020 2a52  ocated...     *R
│ │ │ │ +0002e740: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +0002e750: 7475 726e 7320 e280 9853 4849 5348 495f  turns ...SHISHI_
│ │ │ │ +0002e760: 4f4b e280 9920 6966 6620 7375 6363 6573  OK... iff succes
│ │ │ │ +0002e770: 7366 756c 2e0a 0a73 6869 7368 695f 746b  sful...shishi_tk
│ │ │ │ +0002e780: 7473 5f72 6561 640a 2d2d 2d2d 2d2d 2d2d  ts_read.--------
│ │ │ │ +0002e790: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ +0002e7a0: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ +0002e7b0: 6869 5f74 6b74 735f 7265 6164 2028 5368  hi_tkts_read (Sh
│ │ │ │ +0002e7c0: 6973 6869 5f74 6b74 7320 2a20 544b 5453  ishi_tkts * TKTS
│ │ │ │ +0002e7d0: 2c20 4649 4c45 202a 2046 4829 0a20 2020  , FILE * FH).   
│ │ │ │ +0002e7e0: 2020 544b 5453 3a20 7469 636b 6574 2073    TKTS: ticket s
│ │ │ │ +0002e7f0: 6574 2068 616e 646c 6520 6173 2061 6c6c  et handle as all
│ │ │ │ +0002e800: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ +0002e810: 7368 695f 746b 7473 2829 e280 992e 0a20  shi_tkts()..... 
│ │ │ │ +0002e820: 2020 2020 4648 3a20 6669 6c65 2064 6573      FH: file des
│ │ │ │ +0002e830: 6372 6970 746f 7220 746f 2072 6561 6420  criptor to read 
│ │ │ │ +0002e840: 6672 6f6d 2e0a 0a20 2020 2020 2a44 6573  from...     *Des
│ │ │ │ +0002e850: 6372 6970 7469 6f6e 3a2a 2052 6561 6420  cription:* Read 
│ │ │ │ +0002e860: 7469 636b 6574 7320 6672 6f6d 2066 696c  tickets from fil
│ │ │ │ +0002e870: 6520 6465 7363 7269 7074 6f72 2061 6e64  e descriptor and
│ │ │ │ +0002e880: 2061 6464 2074 6865 6d20 746f 0a20 2020   add them to.   
│ │ │ │ +0002e890: 2020 7468 6520 7469 636b 6574 2073 6574    the ticket set
│ │ │ │ +0002e8a0: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ +0002e8b0: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ +0002e8c0: e280 9853 4849 5348 495f 4f4b e280 9920  ...SHISHI_OK... 
│ │ │ │ +0002e8d0: 6966 6620 7375 6363 6573 7366 756c 2e0a  iff successful..
│ │ │ │ +0002e8e0: 0a73 6869 7368 695f 746b 7473 5f66 726f  .shishi_tkts_fro
│ │ │ │ +0002e8f0: 6d5f 6669 6c65 0a2d 2d2d 2d2d 2d2d 2d2d  m_file.---------
│ │ │ │ +0002e900: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ +0002e910: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ +0002e920: 7368 6973 6869 5f74 6b74 735f 6672 6f6d  shishi_tkts_from
│ │ │ │ +0002e930: 5f66 696c 6520 2853 6869 7368 695f 746b  _file (Shishi_tk
│ │ │ │ +0002e940: 7473 202a 2054 4b54 532c 0a20 2020 2020  ts * TKTS,.     
│ │ │ │ +0002e950: 2020 2020 2063 6f6e 7374 2063 6861 7220       const char 
│ │ │ │ +0002e960: 2a20 4649 4c45 4e41 4d45 290a 2020 2020  * FILENAME).    
│ │ │ │ +0002e970: 2054 4b54 533a 2074 6963 6b65 7420 7365   TKTS: ticket se
│ │ │ │ +0002e980: 7420 6861 6e64 6c65 2061 7320 616c 6c6f  t handle as allo
│ │ │ │ +0002e990: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ +0002e9a0: 6869 5f74 6b74 7328 29e2 8099 2e0a 2020  hi_tkts().....  
│ │ │ │ +0002e9b0: 2020 2046 494c 454e 414d 453a 2066 696c     FILENAME: fil
│ │ │ │ +0002e9c0: 656e 616d 6520 746f 2072 6561 6420 7469  ename to read ti
│ │ │ │ +0002e9d0: 636b 6574 7320 6672 6f6d 2e0a 0a20 2020  ckets from...   
│ │ │ │ +0002e9e0: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ +0002e9f0: 2052 6561 6420 7469 636b 6574 7320 6672   Read tickets fr
│ │ │ │ +0002ea00: 6f6d 2066 696c 6520 616e 6420 6164 6420  om file and add 
│ │ │ │ +0002ea10: 7468 656d 2074 6f20 7468 6520 7469 636b  them to the tick
│ │ │ │ +0002ea20: 6574 0a20 2020 2020 7365 742e 0a0a 2020  et.     set...  
│ │ │ │ +0002ea30: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ +0002ea40: 3a2a 2052 6574 7572 6e73 20e2 8098 5348  :* Returns ...SH
│ │ │ │ +0002ea50: 4953 4849 5f4f 4be2 8099 2069 6666 2073  ISHI_OK... iff s
│ │ │ │ +0002ea60: 7563 6365 7373 6675 6c2e 0a0a 7368 6973  uccessful...shis
│ │ │ │ +0002ea70: 6869 5f74 6b74 735f 7772 6974 650a 2d2d  hi_tkts_write.--
│ │ │ │ +0002ea80: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +0002ea90: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ +0002eaa0: 6e74 2073 6869 7368 695f 746b 7473 5f77  nt shishi_tkts_w
│ │ │ │ +0002eab0: 7269 7465 2028 5368 6973 6869 5f74 6b74  rite (Shishi_tkt
│ │ │ │ +0002eac0: 7320 2a20 544b 5453 2c20 4649 4c45 202a  s * TKTS, FILE *
│ │ │ │ +0002ead0: 2046 4829 0a20 2020 2020 544b 5453 3a20   FH).     TKTS: 
│ │ │ │ +0002eae0: 7469 636b 6574 2073 6574 2068 616e 646c  ticket set handl
│ │ │ │ +0002eaf0: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ +0002eb00: 7920 e280 9873 6869 7368 695f 746b 7473  y ...shishi_tkts
│ │ │ │ +0002eb10: 2829 e280 992e 0a20 2020 2020 4648 3a20  ().....     FH: 
│ │ │ │ +0002eb20: 6669 6c65 2064 6573 6372 6970 746f 7220  file descriptor 
│ │ │ │ +0002eb30: 746f 2077 7269 7465 2074 6963 6b65 7473  to write tickets
│ │ │ │ +0002eb40: 2074 6f2e 0a0a 2020 2020 202a 4465 7363   to...     *Desc
│ │ │ │ +0002eb50: 7269 7074 696f 6e3a 2a20 5772 6974 6520  ription:* Write 
│ │ │ │ +0002eb60: 7469 636b 6574 7320 696e 2073 6574 2074  tickets in set t
│ │ │ │ +0002eb70: 6f20 6669 6c65 2064 6573 6372 6970 746f  o file descripto
│ │ │ │ +0002eb80: 722e 0a0a 2020 2020 202a 5265 7475 726e  r...     *Return
│ │ │ │ +0002eb90: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ +0002eba0: 20e2 8098 5348 4953 4849 5f4f 4be2 8099   ...SHISHI_OK...
│ │ │ │ +0002ebb0: 2069 6666 2073 7563 6365 7373 6675 6c2e   iff successful.
│ │ │ │ +0002ebc0: 0a0a 7368 6973 6869 5f74 6b74 735f 6578  ..shishi_tkts_ex
│ │ │ │ +0002ebd0: 7069 7265 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  pire.-----------
│ │ │ │ +0002ebe0: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +0002ebf0: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ +0002ec00: 695f 746b 7473 5f65 7870 6972 6520 2853  i_tkts_expire (S
│ │ │ │ +0002ec10: 6869 7368 695f 746b 7473 202a 2054 4b54  hishi_tkts * TKT
│ │ │ │ +0002ec20: 5329 0a20 2020 2020 544b 5453 3a20 7469  S).     TKTS: ti
│ │ │ │ +0002ec30: 636b 6574 2073 6574 2068 616e 646c 6520  cket set handle 
│ │ │ │ +0002ec40: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ +0002ec50: e280 9873 6869 7368 695f 746b 7473 2829  ...shishi_tkts()
│ │ │ │ +0002ec60: e280 992e 0a0a 2020 2020 202a 4465 7363  ......     *Desc
│ │ │ │ +0002ec70: 7269 7074 696f 6e3a 2a20 5265 6d6f 7665  ription:* Remove
│ │ │ │ +0002ec80: 2065 7870 6972 6564 2074 6963 6b65 7473   expired tickets
│ │ │ │ +0002ec90: 2066 726f 6d20 7469 636b 6574 2073 6574   from ticket set
│ │ │ │ +0002eca0: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ +0002ecb0: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ +0002ecc0: e280 9853 4849 5348 495f 4f4b e280 9920  ...SHISHI_OK... 
│ │ │ │ +0002ecd0: 6966 6620 7375 6363 6573 7366 756c 2e0a  iff successful..
│ │ │ │ +0002ece0: 0a73 6869 7368 695f 746b 7473 5f74 6f5f  .shishi_tkts_to_
│ │ │ │ +0002ecf0: 6669 6c65 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  file.-----------
│ │ │ │ +0002ed00: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ +0002ed10: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ +0002ed20: 6869 5f74 6b74 735f 746f 5f66 696c 6520  hi_tkts_to_file 
│ │ │ │ +0002ed30: 2853 6869 7368 695f 746b 7473 202a 2054  (Shishi_tkts * T
│ │ │ │ +0002ed40: 4b54 532c 0a20 2020 2020 2020 2020 2063  KTS,.          c
│ │ │ │ +0002ed50: 6f6e 7374 2063 6861 7220 2a20 4649 4c45  onst char * FILE
│ │ │ │ +0002ed60: 4e41 4d45 290a 2020 2020 2054 4b54 533a  NAME).     TKTS:
│ │ │ │ +0002ed70: 2074 6963 6b65 7420 7365 7420 6861 6e64   ticket set hand
│ │ │ │ +0002ed80: 6c65 2061 7320 616c 6c6f 6361 7465 6420  le as allocated 
│ │ │ │ +0002ed90: 6279 20e2 8098 7368 6973 6869 5f74 6b74  by ...shishi_tkt
│ │ │ │ +0002eda0: 7328 29e2 8099 2e0a 2020 2020 2046 494c  s().....     FIL
│ │ │ │ +0002edb0: 454e 414d 453a 2066 696c 656e 616d 6520  ENAME: filename 
│ │ │ │ +0002edc0: 746f 2077 7269 7465 2074 6963 6b65 7473  to write tickets
│ │ │ │ +0002edd0: 2074 6f2e 0a0a 2020 2020 202a 4465 7363   to...     *Desc
│ │ │ │ +0002ede0: 7269 7074 696f 6e3a 2a20 5772 6974 6520  ription:* Write 
│ │ │ │ +0002edf0: 7469 636b 6574 7320 696e 2073 6574 2074  tickets in set t
│ │ │ │ +0002ee00: 6f20 6669 6c65 2e0a 0a20 2020 2020 2a52  o file...     *R
│ │ │ │ +0002ee10: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +0002ee20: 7475 726e 7320 e280 9853 4849 5348 495f  turns ...SHISHI_
│ │ │ │ +0002ee30: 4f4b e280 9920 6966 6620 7375 6363 6573  OK... iff succes
│ │ │ │ +0002ee40: 7366 756c 2e0a 0a73 6869 7368 695f 746b  sful...shishi_tk
│ │ │ │ +0002ee50: 7473 5f70 7269 6e74 5f66 6f72 5f73 6572  ts_print_for_ser
│ │ │ │ +0002ee60: 7669 6365 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  vice.-----------
│ │ │ │  0002ee70: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0002ee80: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ -0002ee90: 696e 7420 7368 6973 6869 5f74 6b74 735f  int shishi_tkts_
│ │ │ │ -0002eea0: 7072 696e 745f 666f 725f 7365 7276 6963  print_for_servic
│ │ │ │ -0002eeb0: 6520 2853 6869 7368 695f 746b 7473 202a  e (Shishi_tkts *
│ │ │ │ -0002eec0: 2054 4b54 532c 0a20 2020 2020 2020 2020   TKTS,.         
│ │ │ │ -0002eed0: 2046 494c 4520 2a20 4648 2c20 636f 6e73   FILE * FH, cons
│ │ │ │ -0002eee0: 7420 6368 6172 202a 2053 4552 5649 4345  t char * SERVICE
│ │ │ │ -0002eef0: 290a 2020 2020 2054 4b54 533a 2074 6963  ).     TKTS: tic
│ │ │ │ -0002ef00: 6b65 7420 7365 7420 6861 6e64 6c65 2061  ket set handle a
│ │ │ │ -0002ef10: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ -0002ef20: 8098 7368 6973 6869 5f74 6b74 7328 29e2  ..shishi_tkts().
│ │ │ │ -0002ef30: 8099 2e0a 2020 2020 2046 483a 2066 696c  ....     FH: fil
│ │ │ │ -0002ef40: 6520 6465 7363 7269 7074 6f72 2074 6f20  e descriptor to 
│ │ │ │ -0002ef50: 7072 696e 7420 746f 2e0a 2020 2020 2053  print to..     S
│ │ │ │ -0002ef60: 4552 5649 4345 3a20 7365 7276 6963 6520  ERVICE: service 
│ │ │ │ -0002ef70: 746f 206c 696d 6974 2074 6963 6b65 7473  to limit tickets
│ │ │ │ -0002ef80: 2070 7269 6e74 6564 2074 6f2c 206f 7220   printed to, or 
│ │ │ │ -0002ef90: 4e55 4c4c 2e0a 0a20 2020 2020 2a44 6573  NULL...     *Des
│ │ │ │ -0002efa0: 6372 6970 7469 6f6e 3a2a 2050 7269 6e74  cription:* Print
│ │ │ │ -0002efb0: 2064 6573 6372 6970 7469 6f6e 206f 6620   description of 
│ │ │ │ -0002efc0: 7469 636b 6574 7320 666f 7220 7370 6563  tickets for spec
│ │ │ │ -0002efd0: 6966 6965 6420 7365 7276 6963 650a 2020  ified service.  
│ │ │ │ -0002efe0: 2020 2074 6f20 6669 6c65 2064 6573 6372     to file descr
│ │ │ │ -0002eff0: 6970 746f 722e 2020 4966 2073 6572 7669  iptor.  If servi
│ │ │ │ -0002f000: 6365 2069 7320 4e55 4c4c 2c20 616c 6c20  ce is NULL, all 
│ │ │ │ -0002f010: 7469 636b 6574 7320 6172 6520 7072 696e  tickets are prin
│ │ │ │ -0002f020: 7465 642e 0a0a 2020 2020 202a 5265 7475  ted...     *Retu
│ │ │ │ -0002f030: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ -0002f040: 6e73 20e2 8098 5348 4953 4849 5f4f 4be2  ns ...SHISHI_OK.
│ │ │ │ -0002f050: 8099 2069 6666 2073 7563 6365 7373 6675  .. iff successfu
│ │ │ │ -0002f060: 6c2e 0a0a 7368 6973 6869 5f74 6b74 735f  l...shishi_tkts_
│ │ │ │ -0002f070: 7072 696e 740a 2d2d 2d2d 2d2d 2d2d 2d2d  print.----------
│ │ │ │ -0002f080: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ -0002f090: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ -0002f0a0: 695f 746b 7473 5f70 7269 6e74 2028 5368  i_tkts_print (Sh
│ │ │ │ -0002f0b0: 6973 6869 5f74 6b74 7320 2a20 544b 5453  ishi_tkts * TKTS
│ │ │ │ -0002f0c0: 2c20 4649 4c45 202a 2046 4829 0a20 2020  , FILE * FH).   
│ │ │ │ -0002f0d0: 2020 544b 5453 3a20 7469 636b 6574 2073    TKTS: ticket s
│ │ │ │ -0002f0e0: 6574 2068 616e 646c 6520 6173 2061 6c6c  et handle as all
│ │ │ │ -0002f0f0: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ -0002f100: 7368 695f 746b 7473 2829 e280 992e 0a20  shi_tkts()..... 
│ │ │ │ -0002f110: 2020 2020 4648 3a20 6669 6c65 2064 6573      FH: file des
│ │ │ │ -0002f120: 6372 6970 746f 7220 746f 2070 7269 6e74  criptor to print
│ │ │ │ -0002f130: 2074 6f2e 0a0a 2020 2020 202a 4465 7363   to...     *Desc
│ │ │ │ -0002f140: 7269 7074 696f 6e3a 2a20 5072 696e 7420  ription:* Print 
│ │ │ │ -0002f150: 6465 7363 7269 7074 696f 6e20 6f66 2061  description of a
│ │ │ │ -0002f160: 6c6c 2074 6963 6b65 7473 2074 6f20 6669  ll tickets to fi
│ │ │ │ -0002f170: 6c65 2064 6573 6372 6970 746f 722e 0a0a  le descriptor...
│ │ │ │ -0002f180: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ -0002f190: 7565 3a2a 2052 6574 7572 6e73 20e2 8098  ue:* Returns ...
│ │ │ │ -0002f1a0: 5348 4953 4849 5f4f 4be2 8099 2069 6666  SHISHI_OK... iff
│ │ │ │ -0002f1b0: 2073 7563 6365 7373 6675 6c2e 0a0a 7368   successful...sh
│ │ │ │ -0002f1c0: 6973 6869 5f74 6b74 5f6d 6174 6368 5f70  ishi_tkt_match_p
│ │ │ │ -0002f1d0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ -0002f1e0: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ -0002f1f0: 6e3a 2069 6e74 2073 6869 7368 695f 746b  n: int shishi_tk
│ │ │ │ -0002f200: 745f 6d61 7463 685f 7020 2853 6869 7368  t_match_p (Shish
│ │ │ │ -0002f210: 695f 746b 7420 2a20 544b 542c 0a20 2020  i_tkt * TKT,.   
│ │ │ │ -0002f220: 2020 2020 2020 2053 6869 7368 695f 746b         Shishi_tk
│ │ │ │ -0002f230: 7473 5f68 696e 7420 2a20 4849 4e54 290a  ts_hint * HINT).
│ │ │ │ -0002f240: 2020 2020 2054 4b54 3a20 7469 636b 6574       TKT: ticket
│ │ │ │ -0002f250: 2074 6f20 7465 7374 2068 696e 7473 206f   to test hints o
│ │ │ │ -0002f260: 6e2e 0a20 2020 2020 4849 4e54 3a20 7374  n..     HINT: st
│ │ │ │ -0002f270: 7275 6374 7572 6520 7769 7468 2063 6861  ructure with cha
│ │ │ │ -0002f280: 7261 6374 6572 6973 7469 6373 206f 6620  racteristics of 
│ │ │ │ -0002f290: 7469 636b 6574 2074 6f20 6265 2066 6f75  ticket to be fou
│ │ │ │ -0002f2a0: 6e64 2e0a 0a20 2020 2020 2a44 6573 6372  nd...     *Descr
│ │ │ │ -0002f2b0: 6970 7469 6f6e 3a2a 2054 6573 7420 6966  iption:* Test if
│ │ │ │ -0002f2c0: 2061 2074 6963 6b65 7420 6d61 7463 6865   a ticket matche
│ │ │ │ -0002f2d0: 7320 7370 6563 6966 6965 6420 6869 6e74  s specified hint
│ │ │ │ -0002f2e0: 732e 0a0a 2020 2020 202a 5265 7475 726e  s...     *Return
│ │ │ │ -0002f2f0: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ -0002f300: 2030 2069 6666 2074 6963 6b65 7420 6661   0 iff ticket fa
│ │ │ │ -0002f310: 696c 7320 746f 206d 6174 6368 2067 6976  ils to match giv
│ │ │ │ -0002f320: 656e 2063 7269 7465 7269 612e 0a0a 7368  en criteria...sh
│ │ │ │ -0002f330: 6973 6869 5f74 6b74 735f 6669 6e64 0a2d  ishi_tkts_find.-
│ │ │ │ -0002f340: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -0002f350: 0a20 2d2d 2046 756e 6374 696f 6e3a 2053  . -- Function: S
│ │ │ │ -0002f360: 6869 7368 695f 746b 7420 2a20 7368 6973  hishi_tkt * shis
│ │ │ │ -0002f370: 6869 5f74 6b74 735f 6669 6e64 2028 5368  hi_tkts_find (Sh
│ │ │ │ -0002f380: 6973 6869 5f74 6b74 7320 2a20 544b 5453  ishi_tkts * TKTS
│ │ │ │ -0002f390: 2c0a 2020 2020 2020 2020 2020 5368 6973  ,.          Shis
│ │ │ │ -0002f3a0: 6869 5f74 6b74 735f 6869 6e74 202a 2048  hi_tkts_hint * H
│ │ │ │ -0002f3b0: 494e 5429 0a20 2020 2020 544b 5453 3a20  INT).     TKTS: 
│ │ │ │ -0002f3c0: 7469 636b 6574 2073 6574 2068 616e 646c  ticket set handl
│ │ │ │ -0002f3d0: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ -0002f3e0: 7920 e280 9873 6869 7368 695f 746b 7473  y ...shishi_tkts
│ │ │ │ -0002f3f0: 2829 e280 992e 0a20 2020 2020 4849 4e54  ().....     HINT
│ │ │ │ -0002f400: 3a20 7374 7275 6374 7572 6520 7769 7468  : structure with
│ │ │ │ -0002f410: 2063 6861 7261 6374 6572 6973 7469 6373   characteristics
│ │ │ │ -0002f420: 206f 6620 7469 636b 6574 2074 6f20 6265   of ticket to be
│ │ │ │ -0002f430: 2066 6f75 6e64 2e0a 0a20 2020 2020 2a44   found...     *D
│ │ │ │ -0002f440: 6573 6372 6970 7469 6f6e 3a2a 2053 6561  escription:* Sea
│ │ │ │ -0002f450: 7263 6820 7468 6520 7469 636b 6574 7365  rch the ticketse
│ │ │ │ -0002f460: 7420 7365 7175 656e 7469 616c 6c79 2028  t sequentially (
│ │ │ │ -0002f470: 6672 6f6d 2074 6963 6b65 740a 2020 2020  from ticket.    
│ │ │ │ -0002f480: 206e 756d 6265 7220 3020 7468 726f 7567   number 0 throug
│ │ │ │ -0002f490: 6820 616c 6c20 7469 636b 6574 7320 696e  h all tickets in
│ │ │ │ -0002f4a0: 2074 6865 2073 6574 2920 666f 7220 6120   the set) for a 
│ │ │ │ -0002f4b0: 7469 636b 6574 2074 6861 7420 6669 7473  ticket that fits
│ │ │ │ -0002f4c0: 2074 6865 0a20 2020 2020 6769 7665 6e20   the.     given 
│ │ │ │ -0002f4d0: 6368 6172 6163 7465 7269 7374 6963 732e  characteristics.
│ │ │ │ -0002f4e0: 2020 4966 2061 2074 6963 6b65 7420 6973    If a ticket is
│ │ │ │ -0002f4f0: 2066 6f75 6e64 2c20 7468 6520 6869 6e74   found, the hint
│ │ │ │ -0002f500: 2d3e 7374 6172 7470 6f73 0a20 2020 2020  ->startpos.     
│ │ │ │ -0002f510: 6669 656c 6420 6973 2075 7064 6174 6564  field is updated
│ │ │ │ -0002f520: 2074 6f20 706f 696e 7420 746f 2074 6865   to point to the
│ │ │ │ -0002f530: 206e 6578 7420 7469 636b 6574 2069 6e20   next ticket in 
│ │ │ │ -0002f540: 7468 6520 7365 742c 2073 6f20 7468 6973  the set, so this
│ │ │ │ -0002f550: 0a20 2020 2020 6675 6e63 7469 6f6e 2063  .     function c
│ │ │ │ -0002f560: 616e 2062 6520 6361 6c6c 6564 2072 6570  an be called rep
│ │ │ │ -0002f570: 6561 7465 646c 7920 7769 7468 2074 6865  eatedly with the
│ │ │ │ -0002f580: 2073 616d 6520 6869 6e74 2061 7267 756d   same hint argum
│ │ │ │ -0002f590: 656e 7420 696e 0a20 2020 2020 6f72 6465  ent in.     orde
│ │ │ │ -0002f5a0: 7220 746f 2066 696e 6420 616c 6c20 7469  r to find all ti
│ │ │ │ -0002f5b0: 636b 6574 7320 6d61 7463 6869 6e67 2061  ckets matching a
│ │ │ │ -0002f5c0: 2063 6572 7461 696e 2063 7269 7465 7269   certain criteri
│ │ │ │ -0002f5d0: 756d 2e20 204e 6f74 6520 7468 6174 0a20  um.  Note that. 
│ │ │ │ -0002f5e0: 2020 2020 6966 2074 6963 6b65 7473 2061      if tickets a
│ │ │ │ -0002f5f0: 7265 2061 6464 6564 2074 6f2c 206f 7220  re added to, or 
│ │ │ │ -0002f600: 7265 6d6f 7665 6420 6672 6f6d 2c20 7468  removed from, th
│ │ │ │ -0002f610: 6520 7469 636b 6574 7365 7420 6475 7269  e ticketset duri
│ │ │ │ -0002f620: 6e67 2061 0a20 2020 2020 7175 6572 7920  ng a.     query 
│ │ │ │ -0002f630: 7769 7468 2074 6865 2073 616d 6520 6869  with the same hi
│ │ │ │ -0002f640: 6e74 2061 7267 756d 656e 742c 2074 6865  nt argument, the
│ │ │ │ -0002f650: 2068 696e 742d 3e73 7461 7274 706f 7320   hint->startpos 
│ │ │ │ -0002f660: 6669 656c 6420 6d75 7374 2062 650a 2020  field must be.  
│ │ │ │ -0002f670: 2020 2075 7064 6174 6564 2061 7070 726f     updated appro
│ │ │ │ -0002f680: 7072 6961 7465 6c79 2e0a 0a20 2020 2020  priately...     
│ │ │ │ -0002f690: 2a48 6572 6520 6973 2068 6f77 2079 6f75  *Here is how you
│ │ │ │ -0002f6a0: 2077 6f75 6c64 2074 7970 6963 616c 6c79   would typically
│ │ │ │ -0002f6b0: 2075 7365 2074 6869 7320 6675 6e63 7469   use this functi
│ │ │ │ -0002f6c0: 6f6e 3a2a 0a20 2020 2020 5368 6973 6869  on:*.     Shishi
│ │ │ │ -0002f6d0: 5f74 6b74 735f 6869 6e74 2068 696e 743b  _tkts_hint hint;
│ │ │ │ -0002f6e0: 0a0a 2020 2020 2053 6869 7368 695f 746b  ..     Shishi_tk
│ │ │ │ -0002f6f0: 7420 746b 743b 0a0a 2020 2020 206d 656d  t tkt;..     mem
│ │ │ │ -0002f700: 7365 7428 2668 696e 742c 2030 2c20 7369  set(&hint, 0, si
│ │ │ │ -0002f710: 7a65 6f66 2868 696e 7429 293b 0a0a 2020  zeof(hint));..  
│ │ │ │ -0002f720: 2020 2068 696e 742e 7365 7276 6572 203d     hint.server =
│ │ │ │ -0002f730: 2022 696d 6170 2f6d 6169 6c2e 6578 616d   "imap/mail.exam
│ │ │ │ -0002f740: 706c 652e 6f72 6722 3b0a 0a20 2020 2020  ple.org";..     
│ │ │ │ -0002f750: 746b 7420 3d20 7368 6973 6869 5f74 6b74  tkt = shishi_tkt
│ │ │ │ -0002f760: 735f 6669 6e64 2028 7368 6973 6869 5f74  s_find (shishi_t
│ │ │ │ -0002f770: 6b74 735f 6465 6661 756c 7428 6861 6e64  kts_default(hand
│ │ │ │ -0002f780: 6c65 292c 2026 6869 6e74 293b 0a0a 2020  le), &hint);..  
│ │ │ │ -0002f790: 2020 2069 6620 2821 746b 7429 0a0a 2020     if (!tkt)..  
│ │ │ │ -0002f7a0: 2020 2070 7269 6e74 6628 224e 6f20 7469     printf("No ti
│ │ │ │ -0002f7b0: 636b 6574 2066 6f75 6e64 2e2e 2e5c 6e22  cket found...\n"
│ │ │ │ -0002f7c0: 293b 0a0a 2020 2020 2065 6c73 650a 0a20  );..     else.. 
│ │ │ │ -0002f7d0: 2020 2020 646f 5f73 6f6d 6574 6869 6e67      do_something
│ │ │ │ -0002f7e0: 5f77 6974 685f 7469 636b 6574 2028 746b  _with_ticket (tk
│ │ │ │ -0002f7f0: 7429 3b0a 0a20 2020 2020 2a52 6574 7572  t);..     *Retur
│ │ │ │ -0002f800: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ -0002f810: 7320 6120 7469 636b 6574 2069 6620 666f  s a ticket if fo
│ │ │ │ -0002f820: 756e 642c 206f 7220 4e55 4c4c 2069 6620  und, or NULL if 
│ │ │ │ -0002f830: 6e6f 2066 7572 7468 6572 0a20 2020 2020  no further.     
│ │ │ │ -0002f840: 6d61 7463 6869 6e67 2074 6963 6b65 7473  matching tickets
│ │ │ │ -0002f850: 2063 6f75 6c64 2062 6520 666f 756e 642e   could be found.
│ │ │ │ -0002f860: 0a0a 7368 6973 6869 5f74 6b74 735f 6669  ..shishi_tkts_fi
│ │ │ │ -0002f870: 6e64 5f66 6f72 5f63 6c69 656e 7473 6572  nd_for_clientser
│ │ │ │ -0002f880: 7665 720a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ver.------------
│ │ │ │ +0002ee80: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ +0002ee90: 3a20 696e 7420 7368 6973 6869 5f74 6b74  : int shishi_tkt
│ │ │ │ +0002eea0: 735f 7072 696e 745f 666f 725f 7365 7276  s_print_for_serv
│ │ │ │ +0002eeb0: 6963 6520 2853 6869 7368 695f 746b 7473  ice (Shishi_tkts
│ │ │ │ +0002eec0: 202a 2054 4b54 532c 0a20 2020 2020 2020   * TKTS,.       
│ │ │ │ +0002eed0: 2020 2046 494c 4520 2a20 4648 2c20 636f     FILE * FH, co
│ │ │ │ +0002eee0: 6e73 7420 6368 6172 202a 2053 4552 5649  nst char * SERVI
│ │ │ │ +0002eef0: 4345 290a 2020 2020 2054 4b54 533a 2074  CE).     TKTS: t
│ │ │ │ +0002ef00: 6963 6b65 7420 7365 7420 6861 6e64 6c65  icket set handle
│ │ │ │ +0002ef10: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ +0002ef20: 20e2 8098 7368 6973 6869 5f74 6b74 7328   ...shishi_tkts(
│ │ │ │ +0002ef30: 29e2 8099 2e0a 2020 2020 2046 483a 2066  ).....     FH: f
│ │ │ │ +0002ef40: 696c 6520 6465 7363 7269 7074 6f72 2074  ile descriptor t
│ │ │ │ +0002ef50: 6f20 7072 696e 7420 746f 2e0a 2020 2020  o print to..    
│ │ │ │ +0002ef60: 2053 4552 5649 4345 3a20 7365 7276 6963   SERVICE: servic
│ │ │ │ +0002ef70: 6520 746f 206c 696d 6974 2074 6963 6b65  e to limit ticke
│ │ │ │ +0002ef80: 7473 2070 7269 6e74 6564 2074 6f2c 206f  ts printed to, o
│ │ │ │ +0002ef90: 7220 4e55 4c4c 2e0a 0a20 2020 2020 2a44  r NULL...     *D
│ │ │ │ +0002efa0: 6573 6372 6970 7469 6f6e 3a2a 2050 7269  escription:* Pri
│ │ │ │ +0002efb0: 6e74 2064 6573 6372 6970 7469 6f6e 206f  nt description o
│ │ │ │ +0002efc0: 6620 7469 636b 6574 7320 666f 7220 7370  f tickets for sp
│ │ │ │ +0002efd0: 6563 6966 6965 6420 7365 7276 6963 650a  ecified service.
│ │ │ │ +0002efe0: 2020 2020 2074 6f20 6669 6c65 2064 6573       to file des
│ │ │ │ +0002eff0: 6372 6970 746f 722e 2020 4966 2073 6572  criptor.  If ser
│ │ │ │ +0002f000: 7669 6365 2069 7320 4e55 4c4c 2c20 616c  vice is NULL, al
│ │ │ │ +0002f010: 6c20 7469 636b 6574 7320 6172 6520 7072  l tickets are pr
│ │ │ │ +0002f020: 696e 7465 642e 0a0a 2020 2020 202a 5265  inted...     *Re
│ │ │ │ +0002f030: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ +0002f040: 7572 6e73 20e2 8098 5348 4953 4849 5f4f  urns ...SHISHI_O
│ │ │ │ +0002f050: 4be2 8099 2069 6666 2073 7563 6365 7373  K... iff success
│ │ │ │ +0002f060: 6675 6c2e 0a0a 7368 6973 6869 5f74 6b74  ful...shishi_tkt
│ │ │ │ +0002f070: 735f 7072 696e 740a 2d2d 2d2d 2d2d 2d2d  s_print.--------
│ │ │ │ +0002f080: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +0002f090: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ +0002f0a0: 7368 695f 746b 7473 5f70 7269 6e74 2028  shi_tkts_print (
│ │ │ │ +0002f0b0: 5368 6973 6869 5f74 6b74 7320 2a20 544b  Shishi_tkts * TK
│ │ │ │ +0002f0c0: 5453 2c20 4649 4c45 202a 2046 4829 0a20  TS, FILE * FH). 
│ │ │ │ +0002f0d0: 2020 2020 544b 5453 3a20 7469 636b 6574      TKTS: ticket
│ │ │ │ +0002f0e0: 2073 6574 2068 616e 646c 6520 6173 2061   set handle as a
│ │ │ │ +0002f0f0: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ +0002f100: 6869 7368 695f 746b 7473 2829 e280 992e  hishi_tkts()....
│ │ │ │ +0002f110: 0a20 2020 2020 4648 3a20 6669 6c65 2064  .     FH: file d
│ │ │ │ +0002f120: 6573 6372 6970 746f 7220 746f 2070 7269  escriptor to pri
│ │ │ │ +0002f130: 6e74 2074 6f2e 0a0a 2020 2020 202a 4465  nt to...     *De
│ │ │ │ +0002f140: 7363 7269 7074 696f 6e3a 2a20 5072 696e  scription:* Prin
│ │ │ │ +0002f150: 7420 6465 7363 7269 7074 696f 6e20 6f66  t description of
│ │ │ │ +0002f160: 2061 6c6c 2074 6963 6b65 7473 2074 6f20   all tickets to 
│ │ │ │ +0002f170: 6669 6c65 2064 6573 6372 6970 746f 722e  file descriptor.
│ │ │ │ +0002f180: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ +0002f190: 616c 7565 3a2a 2052 6574 7572 6e73 20e2  alue:* Returns .
│ │ │ │ +0002f1a0: 8098 5348 4953 4849 5f4f 4be2 8099 2069  ..SHISHI_OK... i
│ │ │ │ +0002f1b0: 6666 2073 7563 6365 7373 6675 6c2e 0a0a  ff successful...
│ │ │ │ +0002f1c0: 7368 6973 6869 5f74 6b74 5f6d 6174 6368  shishi_tkt_match
│ │ │ │ +0002f1d0: 5f70 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  _p.-------------
│ │ │ │ +0002f1e0: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +0002f1f0: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ +0002f200: 746b 745f 6d61 7463 685f 7020 2853 6869  tkt_match_p (Shi
│ │ │ │ +0002f210: 7368 695f 746b 7420 2a20 544b 542c 0a20  shi_tkt * TKT,. 
│ │ │ │ +0002f220: 2020 2020 2020 2020 2053 6869 7368 695f           Shishi_
│ │ │ │ +0002f230: 746b 7473 5f68 696e 7420 2a20 4849 4e54  tkts_hint * HINT
│ │ │ │ +0002f240: 290a 2020 2020 2054 4b54 3a20 7469 636b  ).     TKT: tick
│ │ │ │ +0002f250: 6574 2074 6f20 7465 7374 2068 696e 7473  et to test hints
│ │ │ │ +0002f260: 206f 6e2e 0a20 2020 2020 4849 4e54 3a20   on..     HINT: 
│ │ │ │ +0002f270: 7374 7275 6374 7572 6520 7769 7468 2063  structure with c
│ │ │ │ +0002f280: 6861 7261 6374 6572 6973 7469 6373 206f  haracteristics o
│ │ │ │ +0002f290: 6620 7469 636b 6574 2074 6f20 6265 2066  f ticket to be f
│ │ │ │ +0002f2a0: 6f75 6e64 2e0a 0a20 2020 2020 2a44 6573  ound...     *Des
│ │ │ │ +0002f2b0: 6372 6970 7469 6f6e 3a2a 2054 6573 7420  cription:* Test 
│ │ │ │ +0002f2c0: 6966 2061 2074 6963 6b65 7420 6d61 7463  if a ticket matc
│ │ │ │ +0002f2d0: 6865 7320 7370 6563 6966 6965 6420 6869  hes specified hi
│ │ │ │ +0002f2e0: 6e74 732e 0a0a 2020 2020 202a 5265 7475  nts...     *Retu
│ │ │ │ +0002f2f0: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ +0002f300: 6e73 2030 2069 6666 2074 6963 6b65 7420  ns 0 iff ticket 
│ │ │ │ +0002f310: 6661 696c 7320 746f 206d 6174 6368 2067  fails to match g
│ │ │ │ +0002f320: 6976 656e 2063 7269 7465 7269 612e 0a0a  iven criteria...
│ │ │ │ +0002f330: 7368 6973 6869 5f74 6b74 735f 6669 6e64  shishi_tkts_find
│ │ │ │ +0002f340: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ +0002f350: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ +0002f360: 2053 6869 7368 695f 746b 7420 2a20 7368   Shishi_tkt * sh
│ │ │ │ +0002f370: 6973 6869 5f74 6b74 735f 6669 6e64 2028  ishi_tkts_find (
│ │ │ │ +0002f380: 5368 6973 6869 5f74 6b74 7320 2a20 544b  Shishi_tkts * TK
│ │ │ │ +0002f390: 5453 2c0a 2020 2020 2020 2020 2020 5368  TS,.          Sh
│ │ │ │ +0002f3a0: 6973 6869 5f74 6b74 735f 6869 6e74 202a  ishi_tkts_hint *
│ │ │ │ +0002f3b0: 2048 494e 5429 0a20 2020 2020 544b 5453   HINT).     TKTS
│ │ │ │ +0002f3c0: 3a20 7469 636b 6574 2073 6574 2068 616e  : ticket set han
│ │ │ │ +0002f3d0: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ +0002f3e0: 2062 7920 e280 9873 6869 7368 695f 746b   by ...shishi_tk
│ │ │ │ +0002f3f0: 7473 2829 e280 992e 0a20 2020 2020 4849  ts().....     HI
│ │ │ │ +0002f400: 4e54 3a20 7374 7275 6374 7572 6520 7769  NT: structure wi
│ │ │ │ +0002f410: 7468 2063 6861 7261 6374 6572 6973 7469  th characteristi
│ │ │ │ +0002f420: 6373 206f 6620 7469 636b 6574 2074 6f20  cs of ticket to 
│ │ │ │ +0002f430: 6265 2066 6f75 6e64 2e0a 0a20 2020 2020  be found...     
│ │ │ │ +0002f440: 2a44 6573 6372 6970 7469 6f6e 3a2a 2053  *Description:* S
│ │ │ │ +0002f450: 6561 7263 6820 7468 6520 7469 636b 6574  earch the ticket
│ │ │ │ +0002f460: 7365 7420 7365 7175 656e 7469 616c 6c79  set sequentially
│ │ │ │ +0002f470: 2028 6672 6f6d 2074 6963 6b65 740a 2020   (from ticket.  
│ │ │ │ +0002f480: 2020 206e 756d 6265 7220 3020 7468 726f     number 0 thro
│ │ │ │ +0002f490: 7567 6820 616c 6c20 7469 636b 6574 7320  ugh all tickets 
│ │ │ │ +0002f4a0: 696e 2074 6865 2073 6574 2920 666f 7220  in the set) for 
│ │ │ │ +0002f4b0: 6120 7469 636b 6574 2074 6861 7420 6669  a ticket that fi
│ │ │ │ +0002f4c0: 7473 2074 6865 0a20 2020 2020 6769 7665  ts the.     give
│ │ │ │ +0002f4d0: 6e20 6368 6172 6163 7465 7269 7374 6963  n characteristic
│ │ │ │ +0002f4e0: 732e 2020 4966 2061 2074 6963 6b65 7420  s.  If a ticket 
│ │ │ │ +0002f4f0: 6973 2066 6f75 6e64 2c20 7468 6520 6869  is found, the hi
│ │ │ │ +0002f500: 6e74 2d3e 7374 6172 7470 6f73 0a20 2020  nt->startpos.   
│ │ │ │ +0002f510: 2020 6669 656c 6420 6973 2075 7064 6174    field is updat
│ │ │ │ +0002f520: 6564 2074 6f20 706f 696e 7420 746f 2074  ed to point to t
│ │ │ │ +0002f530: 6865 206e 6578 7420 7469 636b 6574 2069  he next ticket i
│ │ │ │ +0002f540: 6e20 7468 6520 7365 742c 2073 6f20 7468  n the set, so th
│ │ │ │ +0002f550: 6973 0a20 2020 2020 6675 6e63 7469 6f6e  is.     function
│ │ │ │ +0002f560: 2063 616e 2062 6520 6361 6c6c 6564 2072   can be called r
│ │ │ │ +0002f570: 6570 6561 7465 646c 7920 7769 7468 2074  epeatedly with t
│ │ │ │ +0002f580: 6865 2073 616d 6520 6869 6e74 2061 7267  he same hint arg
│ │ │ │ +0002f590: 756d 656e 7420 696e 0a20 2020 2020 6f72  ument in.     or
│ │ │ │ +0002f5a0: 6465 7220 746f 2066 696e 6420 616c 6c20  der to find all 
│ │ │ │ +0002f5b0: 7469 636b 6574 7320 6d61 7463 6869 6e67  tickets matching
│ │ │ │ +0002f5c0: 2061 2063 6572 7461 696e 2063 7269 7465   a certain crite
│ │ │ │ +0002f5d0: 7269 756d 2e20 204e 6f74 6520 7468 6174  rium.  Note that
│ │ │ │ +0002f5e0: 0a20 2020 2020 6966 2074 6963 6b65 7473  .     if tickets
│ │ │ │ +0002f5f0: 2061 7265 2061 6464 6564 2074 6f2c 206f   are added to, o
│ │ │ │ +0002f600: 7220 7265 6d6f 7665 6420 6672 6f6d 2c20  r removed from, 
│ │ │ │ +0002f610: 7468 6520 7469 636b 6574 7365 7420 6475  the ticketset du
│ │ │ │ +0002f620: 7269 6e67 2061 0a20 2020 2020 7175 6572  ring a.     quer
│ │ │ │ +0002f630: 7920 7769 7468 2074 6865 2073 616d 6520  y with the same 
│ │ │ │ +0002f640: 6869 6e74 2061 7267 756d 656e 742c 2074  hint argument, t
│ │ │ │ +0002f650: 6865 2068 696e 742d 3e73 7461 7274 706f  he hint->startpo
│ │ │ │ +0002f660: 7320 6669 656c 6420 6d75 7374 2062 650a  s field must be.
│ │ │ │ +0002f670: 2020 2020 2075 7064 6174 6564 2061 7070       updated app
│ │ │ │ +0002f680: 726f 7072 6961 7465 6c79 2e0a 0a20 2020  ropriately...   
│ │ │ │ +0002f690: 2020 2a48 6572 6520 6973 2068 6f77 2079    *Here is how y
│ │ │ │ +0002f6a0: 6f75 2077 6f75 6c64 2074 7970 6963 616c  ou would typical
│ │ │ │ +0002f6b0: 6c79 2075 7365 2074 6869 7320 6675 6e63  ly use this func
│ │ │ │ +0002f6c0: 7469 6f6e 3a2a 0a20 2020 2020 5368 6973  tion:*.     Shis
│ │ │ │ +0002f6d0: 6869 5f74 6b74 735f 6869 6e74 2068 696e  hi_tkts_hint hin
│ │ │ │ +0002f6e0: 743b 0a0a 2020 2020 2053 6869 7368 695f  t;..     Shishi_
│ │ │ │ +0002f6f0: 746b 7420 746b 743b 0a0a 2020 2020 206d  tkt tkt;..     m
│ │ │ │ +0002f700: 656d 7365 7428 2668 696e 742c 2030 2c20  emset(&hint, 0, 
│ │ │ │ +0002f710: 7369 7a65 6f66 2868 696e 7429 293b 0a0a  sizeof(hint));..
│ │ │ │ +0002f720: 2020 2020 2068 696e 742e 7365 7276 6572       hint.server
│ │ │ │ +0002f730: 203d 2022 696d 6170 2f6d 6169 6c2e 6578   = "imap/mail.ex
│ │ │ │ +0002f740: 616d 706c 652e 6f72 6722 3b0a 0a20 2020  ample.org";..   
│ │ │ │ +0002f750: 2020 746b 7420 3d20 7368 6973 6869 5f74    tkt = shishi_t
│ │ │ │ +0002f760: 6b74 735f 6669 6e64 2028 7368 6973 6869  kts_find (shishi
│ │ │ │ +0002f770: 5f74 6b74 735f 6465 6661 756c 7428 6861  _tkts_default(ha
│ │ │ │ +0002f780: 6e64 6c65 292c 2026 6869 6e74 293b 0a0a  ndle), &hint);..
│ │ │ │ +0002f790: 2020 2020 2069 6620 2821 746b 7429 0a0a       if (!tkt)..
│ │ │ │ +0002f7a0: 2020 2020 2070 7269 6e74 6628 224e 6f20       printf("No 
│ │ │ │ +0002f7b0: 7469 636b 6574 2066 6f75 6e64 2e2e 2e5c  ticket found...\
│ │ │ │ +0002f7c0: 6e22 293b 0a0a 2020 2020 2065 6c73 650a  n");..     else.
│ │ │ │ +0002f7d0: 0a20 2020 2020 646f 5f73 6f6d 6574 6869  .     do_somethi
│ │ │ │ +0002f7e0: 6e67 5f77 6974 685f 7469 636b 6574 2028  ng_with_ticket (
│ │ │ │ +0002f7f0: 746b 7429 3b0a 0a20 2020 2020 2a52 6574  tkt);..     *Ret
│ │ │ │ +0002f800: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ +0002f810: 726e 7320 6120 7469 636b 6574 2069 6620  rns a ticket if 
│ │ │ │ +0002f820: 666f 756e 642c 206f 7220 4e55 4c4c 2069  found, or NULL i
│ │ │ │ +0002f830: 6620 6e6f 2066 7572 7468 6572 0a20 2020  f no further.   
│ │ │ │ +0002f840: 2020 6d61 7463 6869 6e67 2074 6963 6b65    matching ticke
│ │ │ │ +0002f850: 7473 2063 6f75 6c64 2062 6520 666f 756e  ts could be foun
│ │ │ │ +0002f860: 642e 0a0a 7368 6973 6869 5f74 6b74 735f  d...shishi_tkts_
│ │ │ │ +0002f870: 6669 6e64 5f66 6f72 5f63 6c69 656e 7473  find_for_clients
│ │ │ │ +0002f880: 6572 7665 720a 2d2d 2d2d 2d2d 2d2d 2d2d  erver.----------
│ │ │ │  0002f890: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0002f8a0: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ -0002f8b0: 696f 6e3a 2053 6869 7368 695f 746b 7420  ion: Shishi_tkt 
│ │ │ │ -0002f8c0: 2a20 7368 6973 6869 5f74 6b74 735f 6669  * shishi_tkts_fi
│ │ │ │ -0002f8d0: 6e64 5f66 6f72 5f63 6c69 656e 7473 6572  nd_for_clientser
│ │ │ │ -0002f8e0: 7665 720a 2020 2020 2020 2020 2020 2853  ver.          (S
│ │ │ │ -0002f8f0: 6869 7368 695f 746b 7473 202a 2054 4b54  hishi_tkts * TKT
│ │ │ │ -0002f900: 532c 2063 6f6e 7374 2063 6861 7220 2a20  S, const char * 
│ │ │ │ -0002f910: 434c 4945 4e54 2c20 636f 6e73 7420 6368  CLIENT, const ch
│ │ │ │ -0002f920: 6172 202a 2053 4552 5645 5229 0a20 2020  ar * SERVER).   
│ │ │ │ -0002f930: 2020 544b 5453 3a20 7469 636b 6574 2073    TKTS: ticket s
│ │ │ │ -0002f940: 6574 2068 616e 646c 6520 6173 2061 6c6c  et handle as all
│ │ │ │ -0002f950: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ -0002f960: 7368 695f 746b 7473 2829 e280 992e 0a20  shi_tkts()..... 
│ │ │ │ -0002f970: 2020 2020 434c 4945 4e54 3a20 636c 6965      CLIENT: clie
│ │ │ │ -0002f980: 6e74 206e 616d 6520 746f 2066 696e 6420  nt name to find 
│ │ │ │ -0002f990: 7469 636b 6574 2066 6f72 2e0a 2020 2020  ticket for..    
│ │ │ │ -0002f9a0: 2053 4552 5645 523a 2073 6572 7665 7220   SERVER: server 
│ │ │ │ -0002f9b0: 6e61 6d65 2074 6f20 6669 6e64 2074 6963  name to find tic
│ │ │ │ -0002f9c0: 6b65 7420 666f 722e 0a0a 2020 2020 202a  ket for...     *
│ │ │ │ -0002f9d0: 4465 7363 7269 7074 696f 6e3a 2a20 5368  Description:* Sh
│ │ │ │ -0002f9e0: 6f72 742d 6861 6e64 2066 756e 6374 696f  ort-hand functio
│ │ │ │ -0002f9f0: 6e20 666f 7220 7365 6172 6368 696e 6720  n for searching 
│ │ │ │ -0002fa00: 7468 6520 7469 636b 6574 2073 6574 2066  the ticket set f
│ │ │ │ -0002fa10: 6f72 0a20 2020 2020 6120 7469 636b 6574  or.     a ticket
│ │ │ │ -0002fa20: 2066 6f72 2074 6865 2067 6976 656e 2063   for the given c
│ │ │ │ -0002fa30: 6c69 656e 7420 616e 6420 7365 7276 6572  lient and server
│ │ │ │ -0002fa40: 2e20 2053 6565 0a20 2020 2020 e280 9873  .  See.     ...s
│ │ │ │ -0002fa50: 6869 7368 695f 746b 7473 5f66 696e 6428  hishi_tkts_find(
│ │ │ │ -0002fa60: 29e2 8099 2e0a 0a20 2020 2020 2a52 6574  )......     *Ret
│ │ │ │ -0002fa70: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ -0002fa80: 726e 7320 6120 7469 636b 6574 2069 6620  rns a ticket if 
│ │ │ │ -0002fa90: 666f 756e 642c 206f 7220 4e55 4c4c 2e0a  found, or NULL..
│ │ │ │ -0002faa0: 0a73 6869 7368 695f 746b 7473 5f66 696e  .shishi_tkts_fin
│ │ │ │ -0002fab0: 645f 666f 725f 7365 7276 6572 0a2d 2d2d  d_for_server.---
│ │ │ │ +0002f8a0: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +0002f8b0: 6374 696f 6e3a 2053 6869 7368 695f 746b  ction: Shishi_tk
│ │ │ │ +0002f8c0: 7420 2a20 7368 6973 6869 5f74 6b74 735f  t * shishi_tkts_
│ │ │ │ +0002f8d0: 6669 6e64 5f66 6f72 5f63 6c69 656e 7473  find_for_clients
│ │ │ │ +0002f8e0: 6572 7665 720a 2020 2020 2020 2020 2020  erver.          
│ │ │ │ +0002f8f0: 2853 6869 7368 695f 746b 7473 202a 2054  (Shishi_tkts * T
│ │ │ │ +0002f900: 4b54 532c 2063 6f6e 7374 2063 6861 7220  KTS, const char 
│ │ │ │ +0002f910: 2a20 434c 4945 4e54 2c20 636f 6e73 7420  * CLIENT, const 
│ │ │ │ +0002f920: 6368 6172 202a 2053 4552 5645 5229 0a20  char * SERVER). 
│ │ │ │ +0002f930: 2020 2020 544b 5453 3a20 7469 636b 6574      TKTS: ticket
│ │ │ │ +0002f940: 2073 6574 2068 616e 646c 6520 6173 2061   set handle as a
│ │ │ │ +0002f950: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ +0002f960: 6869 7368 695f 746b 7473 2829 e280 992e  hishi_tkts()....
│ │ │ │ +0002f970: 0a20 2020 2020 434c 4945 4e54 3a20 636c  .     CLIENT: cl
│ │ │ │ +0002f980: 6965 6e74 206e 616d 6520 746f 2066 696e  ient name to fin
│ │ │ │ +0002f990: 6420 7469 636b 6574 2066 6f72 2e0a 2020  d ticket for..  
│ │ │ │ +0002f9a0: 2020 2053 4552 5645 523a 2073 6572 7665     SERVER: serve
│ │ │ │ +0002f9b0: 7220 6e61 6d65 2074 6f20 6669 6e64 2074  r name to find t
│ │ │ │ +0002f9c0: 6963 6b65 7420 666f 722e 0a0a 2020 2020  icket for...    
│ │ │ │ +0002f9d0: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ +0002f9e0: 5368 6f72 742d 6861 6e64 2066 756e 6374  Short-hand funct
│ │ │ │ +0002f9f0: 696f 6e20 666f 7220 7365 6172 6368 696e  ion for searchin
│ │ │ │ +0002fa00: 6720 7468 6520 7469 636b 6574 2073 6574  g the ticket set
│ │ │ │ +0002fa10: 2066 6f72 0a20 2020 2020 6120 7469 636b   for.     a tick
│ │ │ │ +0002fa20: 6574 2066 6f72 2074 6865 2067 6976 656e  et for the given
│ │ │ │ +0002fa30: 2063 6c69 656e 7420 616e 6420 7365 7276   client and serv
│ │ │ │ +0002fa40: 6572 2e20 2053 6565 0a20 2020 2020 e280  er.  See.     ..
│ │ │ │ +0002fa50: 9873 6869 7368 695f 746b 7473 5f66 696e  .shishi_tkts_fin
│ │ │ │ +0002fa60: 6428 29e2 8099 2e0a 0a20 2020 2020 2a52  d()......     *R
│ │ │ │ +0002fa70: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +0002fa80: 7475 726e 7320 6120 7469 636b 6574 2069  turns a ticket i
│ │ │ │ +0002fa90: 6620 666f 756e 642c 206f 7220 4e55 4c4c  f found, or NULL
│ │ │ │ +0002faa0: 2e0a 0a73 6869 7368 695f 746b 7473 5f66  ...shishi_tkts_f
│ │ │ │ +0002fab0: 696e 645f 666f 725f 7365 7276 6572 0a2d  ind_for_server.-
│ │ │ │  0002fac0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0002fad0: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -0002fae0: 6e63 7469 6f6e 3a20 5368 6973 6869 5f74  nction: Shishi_t
│ │ │ │ -0002faf0: 6b74 202a 2073 6869 7368 695f 746b 7473  kt * shishi_tkts
│ │ │ │ -0002fb00: 5f66 696e 645f 666f 725f 7365 7276 6572  _find_for_server
│ │ │ │ -0002fb10: 0a20 2020 2020 2020 2020 2028 5368 6973  .          (Shis
│ │ │ │ -0002fb20: 6869 5f74 6b74 7320 2a20 544b 5453 2c20  hi_tkts * TKTS, 
│ │ │ │ -0002fb30: 636f 6e73 7420 6368 6172 202a 2053 4552  const char * SER
│ │ │ │ -0002fb40: 5645 5229 0a20 2020 2020 544b 5453 3a20  VER).     TKTS: 
│ │ │ │ -0002fb50: 7469 636b 6574 2073 6574 2068 616e 646c  ticket set handl
│ │ │ │ -0002fb60: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ -0002fb70: 7920 e280 9873 6869 7368 695f 746b 7473  y ...shishi_tkts
│ │ │ │ -0002fb80: 2829 e280 992e 0a20 2020 2020 5345 5256  ().....     SERV
│ │ │ │ -0002fb90: 4552 3a20 7365 7276 6572 206e 616d 6520  ER: server name 
│ │ │ │ -0002fba0: 746f 2066 696e 6420 7469 636b 6574 2066  to find ticket f
│ │ │ │ -0002fbb0: 6f72 2e0a 0a20 2020 2020 2a44 6573 6372  or...     *Descr
│ │ │ │ -0002fbc0: 6970 7469 6f6e 3a2a 2053 686f 7274 2d68  iption:* Short-h
│ │ │ │ -0002fbd0: 616e 6420 6675 6e63 7469 6f6e 2066 6f72  and function for
│ │ │ │ -0002fbe0: 2073 6561 7263 6869 6e67 2074 6865 2074   searching the t
│ │ │ │ -0002fbf0: 6963 6b65 7420 7365 7420 666f 720a 2020  icket set for.  
│ │ │ │ -0002fc00: 2020 2061 2074 6963 6b65 7420 666f 7220     a ticket for 
│ │ │ │ -0002fc10: 7468 6520 6769 7665 6e20 7365 7276 6572  the given server
│ │ │ │ -0002fc20: 2075 7369 6e67 2074 6865 2064 6566 6175   using the defau
│ │ │ │ -0002fc30: 6c74 2063 6c69 656e 7420 7072 696e 6369  lt client princi
│ │ │ │ -0002fc40: 7061 6c2e 0a20 2020 2020 5365 6520 e280  pal..     See ..
│ │ │ │ -0002fc50: 9873 6869 7368 695f 746b 7473 5f66 696e  .shishi_tkts_fin
│ │ │ │ -0002fc60: 645f 666f 725f 636c 6965 6e74 7365 7276  d_for_clientserv
│ │ │ │ -0002fc70: 6572 2829 e280 9920 616e 6420 e280 9873  er()... and ...s
│ │ │ │ -0002fc80: 6869 7368 695f 746b 7473 5f66 696e 6428  hishi_tkts_find(
│ │ │ │ -0002fc90: 29e2 8099 2e0a 0a20 2020 2020 2a52 6574  )......     *Ret
│ │ │ │ -0002fca0: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ -0002fcb0: 726e 7320 6120 7469 636b 6574 2069 6620  rns a ticket if 
│ │ │ │ -0002fcc0: 666f 756e 642c 206f 7220 4e55 4c4c 2e0a  found, or NULL..
│ │ │ │ -0002fcd0: 0a73 6869 7368 695f 746b 7473 5f67 6574  .shishi_tkts_get
│ │ │ │ -0002fce0: 5f74 6774 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  _tgt.-----------
│ │ │ │ -0002fcf0: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -0002fd00: 6e63 7469 6f6e 3a20 5368 6973 6869 5f74  nction: Shishi_t
│ │ │ │ -0002fd10: 6b74 202a 2073 6869 7368 695f 746b 7473  kt * shishi_tkts
│ │ │ │ -0002fd20: 5f67 6574 5f74 6774 2028 5368 6973 6869  _get_tgt (Shishi
│ │ │ │ -0002fd30: 5f74 6b74 7320 2a20 544b 5453 2c0a 2020  _tkts * TKTS,.  
│ │ │ │ -0002fd40: 2020 2020 2020 2020 5368 6973 6869 5f74          Shishi_t
│ │ │ │ -0002fd50: 6b74 735f 6869 6e74 202a 2048 494e 5429  kts_hint * HINT)
│ │ │ │ -0002fd60: 0a20 2020 2020 544b 5453 3a20 7469 636b  .     TKTS: tick
│ │ │ │ -0002fd70: 6574 2073 6574 2068 616e 646c 6520 6173  et set handle as
│ │ │ │ -0002fd80: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ -0002fd90: 9873 6869 7368 695f 746b 7473 2829 e280  .shishi_tkts()..
│ │ │ │ -0002fda0: 992e 0a20 2020 2020 4849 4e54 3a20 7374  ...     HINT: st
│ │ │ │ -0002fdb0: 7275 6374 7572 6520 7769 7468 2063 6861  ructure with cha
│ │ │ │ -0002fdc0: 7261 6374 6572 6973 7469 6373 206f 6620  racteristics of 
│ │ │ │ -0002fdd0: 7469 636b 6574 2074 6f20 6265 676f 742e  ticket to begot.
│ │ │ │ -0002fde0: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ -0002fdf0: 696f 6e3a 2a20 4765 7420 6120 7469 636b  ion:* Get a tick
│ │ │ │ -0002fe00: 6574 2067 7261 6e74 696e 6720 7469 636b  et granting tick
│ │ │ │ -0002fe10: 6574 2028 5447 5429 2073 7569 7461 626c  et (TGT) suitabl
│ │ │ │ -0002fe20: 6520 666f 720a 2020 2020 2061 6371 7569  e for.     acqui
│ │ │ │ -0002fe30: 7269 6e67 2074 6963 6b65 7420 6d61 7463  ring ticket matc
│ │ │ │ -0002fe40: 6869 6e67 2074 6865 2068 696e 742e 2020  hing the hint.  
│ │ │ │ -0002fe50: 492e 652e 2c20 6765 7420 6120 5447 5420  I.e., get a TGT 
│ │ │ │ -0002fe60: 666f 7220 7468 6520 7365 7276 6572 0a20  for the server. 
│ │ │ │ -0002fe70: 2020 2020 7265 616c 6d20 696e 2074 6865      realm in the
│ │ │ │ -0002fe80: 2068 696e 7420 7374 7275 6374 7572 6520   hint structure 
│ │ │ │ -0002fe90: 2868 696e 742d 3e73 6572 7665 7272 6561  (hint->serverrea
│ │ │ │ -0002fea0: 6c6d 292c 206f 7220 7468 6520 6465 6661  lm), or the defa
│ │ │ │ -0002feb0: 756c 740a 2020 2020 2072 6561 6c6d 2069  ult.     realm i
│ │ │ │ -0002fec0: 6620 7468 6520 7365 7276 6572 7265 616c  f the serverreal
│ │ │ │ -0002fed0: 6d20 6669 656c 6420 6973 204e 554c 4c2e  m field is NULL.
│ │ │ │ -0002fee0: 2043 616e 2072 6573 756c 7420 696e 2041   Can result in A
│ │ │ │ -0002fef0: 5320 6578 6368 616e 6765 2e0a 0a20 2020  S exchange...   
│ │ │ │ -0002ff00: 2020 4375 7272 656e 746c 7920 7468 6973    Currently this
│ │ │ │ -0002ff10: 2066 756e 6374 696f 6e20 646f 206e 6f74   function do not
│ │ │ │ -0002ff20: 2069 6d70 6c65 6d65 6e74 2063 726f 7373   implement cross
│ │ │ │ -0002ff30: 2072 6561 6c6d 206c 6f67 6963 2e0a 0a20   realm logic... 
│ │ │ │ -0002ff40: 2020 2020 5468 6973 2066 756e 6374 696f      This functio
│ │ │ │ -0002ff50: 6e20 6973 2075 7365 6420 6279 20e2 8098  n is used by ...
│ │ │ │ -0002ff60: 7368 6973 6869 5f74 6b74 735f 6765 7428  shishi_tkts_get(
│ │ │ │ -0002ff70: 29e2 8099 2c20 7768 6963 6820 6973 2070  )..., which is p
│ │ │ │ -0002ff80: 726f 6261 626c 790a 2020 2020 2077 6861  robably.     wha
│ │ │ │ -0002ff90: 7420 796f 7520 7265 616c 6c79 2077 616e  t you really wan
│ │ │ │ -0002ffa0: 7420 746f 2075 7365 2075 6e6c 6573 7320  t to use unless 
│ │ │ │ -0002ffb0: 796f 7520 6861 7665 2073 7065 6369 616c  you have special
│ │ │ │ -0002ffc0: 206e 6565 6473 2e0a 0a20 2020 2020 2a52   needs...     *R
│ │ │ │ -0002ffd0: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ -0002ffe0: 7475 726e 7320 6120 7469 636b 6574 2067  turns a ticket g
│ │ │ │ -0002fff0: 7261 6e74 696e 6720 7469 636b 6574 2069  ranting ticket i
│ │ │ │ -00030000: 6620 7375 6363 6573 7366 756c 2c20 6f72  f successful, or
│ │ │ │ -00030010: 0a20 2020 2020 4e55 4c4c 2069 6620 7468  .     NULL if th
│ │ │ │ -00030020: 6973 2066 756e 6374 696f 6e20 6973 2075  is function is u
│ │ │ │ -00030030: 6e61 626c 6520 746f 2061 6371 7569 7265  nable to acquire
│ │ │ │ -00030040: 206f 6e2e 0a0a 7368 6973 6869 5f74 6b74   on...shishi_tkt
│ │ │ │ -00030050: 735f 6765 745f 7467 730a 2d2d 2d2d 2d2d  s_get_tgs.------
│ │ │ │ -00030060: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -00030070: 2d2d 2046 756e 6374 696f 6e3a 2053 6869  -- Function: Shi
│ │ │ │ -00030080: 7368 695f 746b 7420 2a20 7368 6973 6869  shi_tkt * shishi
│ │ │ │ -00030090: 5f74 6b74 735f 6765 745f 7467 7320 2853  _tkts_get_tgs (S
│ │ │ │ -000300a0: 6869 7368 695f 746b 7473 202a 2054 4b54  hishi_tkts * TKT
│ │ │ │ -000300b0: 532c 0a20 2020 2020 2020 2020 2053 6869  S,.          Shi
│ │ │ │ -000300c0: 7368 695f 746b 7473 5f68 696e 7420 2a20  shi_tkts_hint * 
│ │ │ │ -000300d0: 4849 4e54 2c20 5368 6973 6869 5f74 6b74  HINT, Shishi_tkt
│ │ │ │ -000300e0: 202a 2054 4754 290a 2020 2020 2054 4b54   * TGT).     TKT
│ │ │ │ -000300f0: 533a 2074 6963 6b65 7420 7365 7420 6861  S: ticket set ha
│ │ │ │ -00030100: 6e64 6c65 2061 7320 616c 6c6f 6361 7465  ndle as allocate
│ │ │ │ -00030110: 6420 6279 20e2 8098 7368 6973 6869 5f74  d by ...shishi_t
│ │ │ │ -00030120: 6b74 7328 29e2 8099 2e0a 2020 2020 2048  kts().....     H
│ │ │ │ -00030130: 494e 543a 2073 7472 7563 7475 7265 2077  INT: structure w
│ │ │ │ -00030140: 6974 6820 6368 6172 6163 7465 7269 7374  ith characterist
│ │ │ │ -00030150: 6963 7320 6f66 2074 6963 6b65 7420 746f  ics of ticket to
│ │ │ │ -00030160: 2062 6567 6f74 2e0a 2020 2020 2054 4754   begot..     TGT
│ │ │ │ -00030170: 3a20 7469 636b 6574 2067 7261 6e74 696e  : ticket grantin
│ │ │ │ -00030180: 6720 7469 636b 6574 2074 6f20 7573 652e  g ticket to use.
│ │ │ │ -00030190: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ -000301a0: 696f 6e3a 2a20 4765 7420 6120 7469 636b  ion:* Get a tick
│ │ │ │ -000301b0: 6574 2076 6961 2054 4753 2065 7863 6861  et via TGS excha
│ │ │ │ -000301c0: 6e67 6520 7573 696e 6720 7370 6563 6966  nge using specif
│ │ │ │ -000301d0: 6965 6420 7469 636b 6574 0a20 2020 2020  ied ticket.     
│ │ │ │ -000301e0: 6772 616e 7469 6e67 2074 6963 6b65 742e  granting ticket.
│ │ │ │ -000301f0: 0a0a 2020 2020 2054 6869 7320 6675 6e63  ..     This func
│ │ │ │ -00030200: 7469 6f6e 2069 7320 7573 6564 2062 7920  tion is used by 
│ │ │ │ -00030210: e280 9873 6869 7368 695f 746b 7473 5f67  ...shishi_tkts_g
│ │ │ │ -00030220: 6574 2829 e280 992c 2077 6869 6368 2069  et()..., which i
│ │ │ │ -00030230: 7320 7072 6f62 6162 6c79 0a20 2020 2020  s probably.     
│ │ │ │ -00030240: 7768 6174 2079 6f75 2072 6561 6c6c 7920  what you really 
│ │ │ │ -00030250: 7761 6e74 2074 6f20 7573 6520 756e 6c65  want to use unle
│ │ │ │ -00030260: 7373 2079 6f75 2068 6176 6520 7370 6563  ss you have spec
│ │ │ │ -00030270: 6961 6c20 6e65 6564 732e 0a0a 2020 2020  ial needs...    
│ │ │ │ -00030280: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ -00030290: 2052 6574 7572 6e73 2061 2074 6963 6b65   Returns a ticke
│ │ │ │ -000302a0: 7420 6966 2073 7563 6365 7373 6675 6c2c  t if successful,
│ │ │ │ -000302b0: 206f 7220 4e55 4c4c 2069 6620 7468 6973   or NULL if this
│ │ │ │ -000302c0: 0a20 2020 2020 6675 6e63 7469 6f6e 2069  .     function i
│ │ │ │ -000302d0: 7320 756e 6162 6c65 2074 6f20 6163 7175  s unable to acqu
│ │ │ │ -000302e0: 6972 6520 6f6e 2e0a 0a73 6869 7368 695f  ire on...shishi_
│ │ │ │ -000302f0: 746b 7473 5f67 6574 0a2d 2d2d 2d2d 2d2d  tkts_get.-------
│ │ │ │ -00030300: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -00030310: 6e63 7469 6f6e 3a20 5368 6973 6869 5f74  nction: Shishi_t
│ │ │ │ -00030320: 6b74 202a 2073 6869 7368 695f 746b 7473  kt * shishi_tkts
│ │ │ │ -00030330: 5f67 6574 2028 5368 6973 6869 5f74 6b74  _get (Shishi_tkt
│ │ │ │ -00030340: 7320 2a20 544b 5453 2c0a 2020 2020 2020  s * TKTS,.      
│ │ │ │ -00030350: 2020 2020 5368 6973 6869 5f74 6b74 735f      Shishi_tkts_
│ │ │ │ -00030360: 6869 6e74 202a 2048 494e 5429 0a20 2020  hint * HINT).   
│ │ │ │ -00030370: 2020 544b 5453 3a20 7469 636b 6574 2073    TKTS: ticket s
│ │ │ │ -00030380: 6574 2068 616e 646c 6520 6173 2061 6c6c  et handle as all
│ │ │ │ -00030390: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ -000303a0: 7368 695f 746b 7473 2829 e280 992e 0a20  shi_tkts()..... 
│ │ │ │ -000303b0: 2020 2020 4849 4e54 3a20 7374 7275 6374      HINT: struct
│ │ │ │ -000303c0: 7572 6520 7769 7468 2063 6861 7261 6374  ure with charact
│ │ │ │ -000303d0: 6572 6973 7469 6373 206f 6620 7469 636b  eristics of tick
│ │ │ │ -000303e0: 6574 2074 6f20 6265 2066 6f75 6e64 2e0a  et to be found..
│ │ │ │ -000303f0: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -00030400: 6f6e 3a2a 2047 6574 2061 2074 6963 6b65  on:* Get a ticke
│ │ │ │ -00030410: 7420 6d61 7463 6869 6e67 2067 6976 656e  t matching given
│ │ │ │ -00030420: 2063 6861 7261 6374 6572 6973 7469 6373   characteristics
│ │ │ │ -00030430: 2e20 2054 6869 730a 2020 2020 2066 756e  .  This.     fun
│ │ │ │ -00030440: 6374 696f 6e20 6669 7273 7420 6c6f 6f6b  ction first look
│ │ │ │ -00030450: 7320 696e 2074 6865 2074 6963 6b65 7420  s in the ticket 
│ │ │ │ -00030460: 7365 7420 666f 7220 6120 7469 636b 6574  set for a ticket
│ │ │ │ -00030470: 2c20 7468 656e 2074 7269 6573 2074 6f0a  , then tries to.
│ │ │ │ -00030480: 2020 2020 2066 696e 6420 6120 7375 6974       find a suit
│ │ │ │ -00030490: 6162 6c65 2054 4754 2c20 706f 7373 6962  able TGT, possib
│ │ │ │ -000304a0: 6c79 2076 6961 2061 6e20 4153 2065 7863  ly via an AS exc
│ │ │ │ -000304b0: 6861 6e67 652c 2075 7369 6e67 0a20 2020  hange, using.   
│ │ │ │ -000304c0: 2020 e280 9873 6869 7368 695f 746b 7473    ...shishi_tkts
│ │ │ │ -000304d0: 5f67 6574 5f74 6774 2829 e280 992c 2061  _get_tgt()..., a
│ │ │ │ -000304e0: 6e64 2074 6865 6e20 7573 6573 2074 6861  nd then uses tha
│ │ │ │ -000304f0: 7420 5447 5420 696e 2061 2054 4753 2065  t TGT in a TGS e
│ │ │ │ -00030500: 7863 6861 6e67 650a 2020 2020 2074 6f20  xchange.     to 
│ │ │ │ -00030510: 6765 7420 7468 6520 7469 636b 6574 2e0a  get the ticket..
│ │ │ │ -00030520: 0a20 2020 2020 4375 7272 656e 746c 7920  .     Currently 
│ │ │ │ -00030530: 7468 6973 2066 756e 6374 696f 6e20 646f  this function do
│ │ │ │ -00030540: 6573 206e 6f74 2069 6d70 6c65 6d65 6e74  es not implement
│ │ │ │ -00030550: 2063 726f 7373 2072 6561 6c6d 206c 6f67   cross realm log
│ │ │ │ -00030560: 6963 2e0a 0a20 2020 2020 2a52 6574 7572  ic...     *Retur
│ │ │ │ -00030570: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ -00030580: 7320 6120 7469 636b 6574 2069 6620 666f  s a ticket if fo
│ │ │ │ -00030590: 756e 642c 206f 7220 4e55 4c4c 2069 6620  und, or NULL if 
│ │ │ │ -000305a0: 7468 6973 2066 756e 6374 696f 6e0a 2020  this function.  
│ │ │ │ -000305b0: 2020 2069 7320 756e 6162 6c65 2074 6f20     is unable to 
│ │ │ │ -000305c0: 6765 7420 7468 6520 7469 636b 6574 2e0a  get the ticket..
│ │ │ │ -000305d0: 0a73 6869 7368 695f 746b 7473 5f67 6574  .shishi_tkts_get
│ │ │ │ -000305e0: 5f66 6f72 5f63 6c69 656e 7473 6572 7665  _for_clientserve
│ │ │ │ -000305f0: 720a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  r.--------------
│ │ │ │ +0002fad0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +0002fae0: 4675 6e63 7469 6f6e 3a20 5368 6973 6869  Function: Shishi
│ │ │ │ +0002faf0: 5f74 6b74 202a 2073 6869 7368 695f 746b  _tkt * shishi_tk
│ │ │ │ +0002fb00: 7473 5f66 696e 645f 666f 725f 7365 7276  ts_find_for_serv
│ │ │ │ +0002fb10: 6572 0a20 2020 2020 2020 2020 2028 5368  er.          (Sh
│ │ │ │ +0002fb20: 6973 6869 5f74 6b74 7320 2a20 544b 5453  ishi_tkts * TKTS
│ │ │ │ +0002fb30: 2c20 636f 6e73 7420 6368 6172 202a 2053  , const char * S
│ │ │ │ +0002fb40: 4552 5645 5229 0a20 2020 2020 544b 5453  ERVER).     TKTS
│ │ │ │ +0002fb50: 3a20 7469 636b 6574 2073 6574 2068 616e  : ticket set han
│ │ │ │ +0002fb60: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ +0002fb70: 2062 7920 e280 9873 6869 7368 695f 746b   by ...shishi_tk
│ │ │ │ +0002fb80: 7473 2829 e280 992e 0a20 2020 2020 5345  ts().....     SE
│ │ │ │ +0002fb90: 5256 4552 3a20 7365 7276 6572 206e 616d  RVER: server nam
│ │ │ │ +0002fba0: 6520 746f 2066 696e 6420 7469 636b 6574  e to find ticket
│ │ │ │ +0002fbb0: 2066 6f72 2e0a 0a20 2020 2020 2a44 6573   for...     *Des
│ │ │ │ +0002fbc0: 6372 6970 7469 6f6e 3a2a 2053 686f 7274  cription:* Short
│ │ │ │ +0002fbd0: 2d68 616e 6420 6675 6e63 7469 6f6e 2066  -hand function f
│ │ │ │ +0002fbe0: 6f72 2073 6561 7263 6869 6e67 2074 6865  or searching the
│ │ │ │ +0002fbf0: 2074 6963 6b65 7420 7365 7420 666f 720a   ticket set for.
│ │ │ │ +0002fc00: 2020 2020 2061 2074 6963 6b65 7420 666f       a ticket fo
│ │ │ │ +0002fc10: 7220 7468 6520 6769 7665 6e20 7365 7276  r the given serv
│ │ │ │ +0002fc20: 6572 2075 7369 6e67 2074 6865 2064 6566  er using the def
│ │ │ │ +0002fc30: 6175 6c74 2063 6c69 656e 7420 7072 696e  ault client prin
│ │ │ │ +0002fc40: 6369 7061 6c2e 0a20 2020 2020 5365 6520  cipal..     See 
│ │ │ │ +0002fc50: e280 9873 6869 7368 695f 746b 7473 5f66  ...shishi_tkts_f
│ │ │ │ +0002fc60: 696e 645f 666f 725f 636c 6965 6e74 7365  ind_for_clientse
│ │ │ │ +0002fc70: 7276 6572 2829 e280 9920 616e 6420 e280  rver()... and ..
│ │ │ │ +0002fc80: 9873 6869 7368 695f 746b 7473 5f66 696e  .shishi_tkts_fin
│ │ │ │ +0002fc90: 6428 29e2 8099 2e0a 0a20 2020 2020 2a52  d()......     *R
│ │ │ │ +0002fca0: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +0002fcb0: 7475 726e 7320 6120 7469 636b 6574 2069  turns a ticket i
│ │ │ │ +0002fcc0: 6620 666f 756e 642c 206f 7220 4e55 4c4c  f found, or NULL
│ │ │ │ +0002fcd0: 2e0a 0a73 6869 7368 695f 746b 7473 5f67  ...shishi_tkts_g
│ │ │ │ +0002fce0: 6574 5f74 6774 0a2d 2d2d 2d2d 2d2d 2d2d  et_tgt.---------
│ │ │ │ +0002fcf0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +0002fd00: 4675 6e63 7469 6f6e 3a20 5368 6973 6869  Function: Shishi
│ │ │ │ +0002fd10: 5f74 6b74 202a 2073 6869 7368 695f 746b  _tkt * shishi_tk
│ │ │ │ +0002fd20: 7473 5f67 6574 5f74 6774 2028 5368 6973  ts_get_tgt (Shis
│ │ │ │ +0002fd30: 6869 5f74 6b74 7320 2a20 544b 5453 2c0a  hi_tkts * TKTS,.
│ │ │ │ +0002fd40: 2020 2020 2020 2020 2020 5368 6973 6869            Shishi
│ │ │ │ +0002fd50: 5f74 6b74 735f 6869 6e74 202a 2048 494e  _tkts_hint * HIN
│ │ │ │ +0002fd60: 5429 0a20 2020 2020 544b 5453 3a20 7469  T).     TKTS: ti
│ │ │ │ +0002fd70: 636b 6574 2073 6574 2068 616e 646c 6520  cket set handle 
│ │ │ │ +0002fd80: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ +0002fd90: e280 9873 6869 7368 695f 746b 7473 2829  ...shishi_tkts()
│ │ │ │ +0002fda0: e280 992e 0a20 2020 2020 4849 4e54 3a20  .....     HINT: 
│ │ │ │ +0002fdb0: 7374 7275 6374 7572 6520 7769 7468 2063  structure with c
│ │ │ │ +0002fdc0: 6861 7261 6374 6572 6973 7469 6373 206f  haracteristics o
│ │ │ │ +0002fdd0: 6620 7469 636b 6574 2074 6f20 6265 676f  f ticket to bego
│ │ │ │ +0002fde0: 742e 0a0a 2020 2020 202a 4465 7363 7269  t...     *Descri
│ │ │ │ +0002fdf0: 7074 696f 6e3a 2a20 4765 7420 6120 7469  ption:* Get a ti
│ │ │ │ +0002fe00: 636b 6574 2067 7261 6e74 696e 6720 7469  cket granting ti
│ │ │ │ +0002fe10: 636b 6574 2028 5447 5429 2073 7569 7461  cket (TGT) suita
│ │ │ │ +0002fe20: 626c 6520 666f 720a 2020 2020 2061 6371  ble for.     acq
│ │ │ │ +0002fe30: 7569 7269 6e67 2074 6963 6b65 7420 6d61  uiring ticket ma
│ │ │ │ +0002fe40: 7463 6869 6e67 2074 6865 2068 696e 742e  tching the hint.
│ │ │ │ +0002fe50: 2020 492e 652e 2c20 6765 7420 6120 5447    I.e., get a TG
│ │ │ │ +0002fe60: 5420 666f 7220 7468 6520 7365 7276 6572  T for the server
│ │ │ │ +0002fe70: 0a20 2020 2020 7265 616c 6d20 696e 2074  .     realm in t
│ │ │ │ +0002fe80: 6865 2068 696e 7420 7374 7275 6374 7572  he hint structur
│ │ │ │ +0002fe90: 6520 2868 696e 742d 3e73 6572 7665 7272  e (hint->serverr
│ │ │ │ +0002fea0: 6561 6c6d 292c 206f 7220 7468 6520 6465  ealm), or the de
│ │ │ │ +0002feb0: 6661 756c 740a 2020 2020 2072 6561 6c6d  fault.     realm
│ │ │ │ +0002fec0: 2069 6620 7468 6520 7365 7276 6572 7265   if the serverre
│ │ │ │ +0002fed0: 616c 6d20 6669 656c 6420 6973 204e 554c  alm field is NUL
│ │ │ │ +0002fee0: 4c2e 2043 616e 2072 6573 756c 7420 696e  L. Can result in
│ │ │ │ +0002fef0: 2041 5320 6578 6368 616e 6765 2e0a 0a20   AS exchange... 
│ │ │ │ +0002ff00: 2020 2020 4375 7272 656e 746c 7920 7468      Currently th
│ │ │ │ +0002ff10: 6973 2066 756e 6374 696f 6e20 646f 206e  is function do n
│ │ │ │ +0002ff20: 6f74 2069 6d70 6c65 6d65 6e74 2063 726f  ot implement cro
│ │ │ │ +0002ff30: 7373 2072 6561 6c6d 206c 6f67 6963 2e0a  ss realm logic..
│ │ │ │ +0002ff40: 0a20 2020 2020 5468 6973 2066 756e 6374  .     This funct
│ │ │ │ +0002ff50: 696f 6e20 6973 2075 7365 6420 6279 20e2  ion is used by .
│ │ │ │ +0002ff60: 8098 7368 6973 6869 5f74 6b74 735f 6765  ..shishi_tkts_ge
│ │ │ │ +0002ff70: 7428 29e2 8099 2c20 7768 6963 6820 6973  t()..., which is
│ │ │ │ +0002ff80: 2070 726f 6261 626c 790a 2020 2020 2077   probably.     w
│ │ │ │ +0002ff90: 6861 7420 796f 7520 7265 616c 6c79 2077  hat you really w
│ │ │ │ +0002ffa0: 616e 7420 746f 2075 7365 2075 6e6c 6573  ant to use unles
│ │ │ │ +0002ffb0: 7320 796f 7520 6861 7665 2073 7065 6369  s you have speci
│ │ │ │ +0002ffc0: 616c 206e 6565 6473 2e0a 0a20 2020 2020  al needs...     
│ │ │ │ +0002ffd0: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ +0002ffe0: 5265 7475 726e 7320 6120 7469 636b 6574  Returns a ticket
│ │ │ │ +0002fff0: 2067 7261 6e74 696e 6720 7469 636b 6574   granting ticket
│ │ │ │ +00030000: 2069 6620 7375 6363 6573 7366 756c 2c20   if successful, 
│ │ │ │ +00030010: 6f72 0a20 2020 2020 4e55 4c4c 2069 6620  or.     NULL if 
│ │ │ │ +00030020: 7468 6973 2066 756e 6374 696f 6e20 6973  this function is
│ │ │ │ +00030030: 2075 6e61 626c 6520 746f 2061 6371 7569   unable to acqui
│ │ │ │ +00030040: 7265 206f 6e2e 0a0a 7368 6973 6869 5f74  re on...shishi_t
│ │ │ │ +00030050: 6b74 735f 6765 745f 7467 730a 2d2d 2d2d  kts_get_tgs.----
│ │ │ │ +00030060: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +00030070: 0a20 2d2d 2046 756e 6374 696f 6e3a 2053  . -- Function: S
│ │ │ │ +00030080: 6869 7368 695f 746b 7420 2a20 7368 6973  hishi_tkt * shis
│ │ │ │ +00030090: 6869 5f74 6b74 735f 6765 745f 7467 7320  hi_tkts_get_tgs 
│ │ │ │ +000300a0: 2853 6869 7368 695f 746b 7473 202a 2054  (Shishi_tkts * T
│ │ │ │ +000300b0: 4b54 532c 0a20 2020 2020 2020 2020 2053  KTS,.          S
│ │ │ │ +000300c0: 6869 7368 695f 746b 7473 5f68 696e 7420  hishi_tkts_hint 
│ │ │ │ +000300d0: 2a20 4849 4e54 2c20 5368 6973 6869 5f74  * HINT, Shishi_t
│ │ │ │ +000300e0: 6b74 202a 2054 4754 290a 2020 2020 2054  kt * TGT).     T
│ │ │ │ +000300f0: 4b54 533a 2074 6963 6b65 7420 7365 7420  KTS: ticket set 
│ │ │ │ +00030100: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ +00030110: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ +00030120: 5f74 6b74 7328 29e2 8099 2e0a 2020 2020  _tkts().....    
│ │ │ │ +00030130: 2048 494e 543a 2073 7472 7563 7475 7265   HINT: structure
│ │ │ │ +00030140: 2077 6974 6820 6368 6172 6163 7465 7269   with characteri
│ │ │ │ +00030150: 7374 6963 7320 6f66 2074 6963 6b65 7420  stics of ticket 
│ │ │ │ +00030160: 746f 2062 6567 6f74 2e0a 2020 2020 2054  to begot..     T
│ │ │ │ +00030170: 4754 3a20 7469 636b 6574 2067 7261 6e74  GT: ticket grant
│ │ │ │ +00030180: 696e 6720 7469 636b 6574 2074 6f20 7573  ing ticket to us
│ │ │ │ +00030190: 652e 0a0a 2020 2020 202a 4465 7363 7269  e...     *Descri
│ │ │ │ +000301a0: 7074 696f 6e3a 2a20 4765 7420 6120 7469  ption:* Get a ti
│ │ │ │ +000301b0: 636b 6574 2076 6961 2054 4753 2065 7863  cket via TGS exc
│ │ │ │ +000301c0: 6861 6e67 6520 7573 696e 6720 7370 6563  hange using spec
│ │ │ │ +000301d0: 6966 6965 6420 7469 636b 6574 0a20 2020  ified ticket.   
│ │ │ │ +000301e0: 2020 6772 616e 7469 6e67 2074 6963 6b65    granting ticke
│ │ │ │ +000301f0: 742e 0a0a 2020 2020 2054 6869 7320 6675  t...     This fu
│ │ │ │ +00030200: 6e63 7469 6f6e 2069 7320 7573 6564 2062  nction is used b
│ │ │ │ +00030210: 7920 e280 9873 6869 7368 695f 746b 7473  y ...shishi_tkts
│ │ │ │ +00030220: 5f67 6574 2829 e280 992c 2077 6869 6368  _get()..., which
│ │ │ │ +00030230: 2069 7320 7072 6f62 6162 6c79 0a20 2020   is probably.   
│ │ │ │ +00030240: 2020 7768 6174 2079 6f75 2072 6561 6c6c    what you reall
│ │ │ │ +00030250: 7920 7761 6e74 2074 6f20 7573 6520 756e  y want to use un
│ │ │ │ +00030260: 6c65 7373 2079 6f75 2068 6176 6520 7370  less you have sp
│ │ │ │ +00030270: 6563 6961 6c20 6e65 6564 732e 0a0a 2020  ecial needs...  
│ │ │ │ +00030280: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ +00030290: 3a2a 2052 6574 7572 6e73 2061 2074 6963  :* Returns a tic
│ │ │ │ +000302a0: 6b65 7420 6966 2073 7563 6365 7373 6675  ket if successfu
│ │ │ │ +000302b0: 6c2c 206f 7220 4e55 4c4c 2069 6620 7468  l, or NULL if th
│ │ │ │ +000302c0: 6973 0a20 2020 2020 6675 6e63 7469 6f6e  is.     function
│ │ │ │ +000302d0: 2069 7320 756e 6162 6c65 2074 6f20 6163   is unable to ac
│ │ │ │ +000302e0: 7175 6972 6520 6f6e 2e0a 0a73 6869 7368  quire on...shish
│ │ │ │ +000302f0: 695f 746b 7473 5f67 6574 0a2d 2d2d 2d2d  i_tkts_get.-----
│ │ │ │ +00030300: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +00030310: 4675 6e63 7469 6f6e 3a20 5368 6973 6869  Function: Shishi
│ │ │ │ +00030320: 5f74 6b74 202a 2073 6869 7368 695f 746b  _tkt * shishi_tk
│ │ │ │ +00030330: 7473 5f67 6574 2028 5368 6973 6869 5f74  ts_get (Shishi_t
│ │ │ │ +00030340: 6b74 7320 2a20 544b 5453 2c0a 2020 2020  kts * TKTS,.    
│ │ │ │ +00030350: 2020 2020 2020 5368 6973 6869 5f74 6b74        Shishi_tkt
│ │ │ │ +00030360: 735f 6869 6e74 202a 2048 494e 5429 0a20  s_hint * HINT). 
│ │ │ │ +00030370: 2020 2020 544b 5453 3a20 7469 636b 6574      TKTS: ticket
│ │ │ │ +00030380: 2073 6574 2068 616e 646c 6520 6173 2061   set handle as a
│ │ │ │ +00030390: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ +000303a0: 6869 7368 695f 746b 7473 2829 e280 992e  hishi_tkts()....
│ │ │ │ +000303b0: 0a20 2020 2020 4849 4e54 3a20 7374 7275  .     HINT: stru
│ │ │ │ +000303c0: 6374 7572 6520 7769 7468 2063 6861 7261  cture with chara
│ │ │ │ +000303d0: 6374 6572 6973 7469 6373 206f 6620 7469  cteristics of ti
│ │ │ │ +000303e0: 636b 6574 2074 6f20 6265 2066 6f75 6e64  cket to be found
│ │ │ │ +000303f0: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ +00030400: 7469 6f6e 3a2a 2047 6574 2061 2074 6963  tion:* Get a tic
│ │ │ │ +00030410: 6b65 7420 6d61 7463 6869 6e67 2067 6976  ket matching giv
│ │ │ │ +00030420: 656e 2063 6861 7261 6374 6572 6973 7469  en characteristi
│ │ │ │ +00030430: 6373 2e20 2054 6869 730a 2020 2020 2066  cs.  This.     f
│ │ │ │ +00030440: 756e 6374 696f 6e20 6669 7273 7420 6c6f  unction first lo
│ │ │ │ +00030450: 6f6b 7320 696e 2074 6865 2074 6963 6b65  oks in the ticke
│ │ │ │ +00030460: 7420 7365 7420 666f 7220 6120 7469 636b  t set for a tick
│ │ │ │ +00030470: 6574 2c20 7468 656e 2074 7269 6573 2074  et, then tries t
│ │ │ │ +00030480: 6f0a 2020 2020 2066 696e 6420 6120 7375  o.     find a su
│ │ │ │ +00030490: 6974 6162 6c65 2054 4754 2c20 706f 7373  itable TGT, poss
│ │ │ │ +000304a0: 6962 6c79 2076 6961 2061 6e20 4153 2065  ibly via an AS e
│ │ │ │ +000304b0: 7863 6861 6e67 652c 2075 7369 6e67 0a20  xchange, using. 
│ │ │ │ +000304c0: 2020 2020 e280 9873 6869 7368 695f 746b      ...shishi_tk
│ │ │ │ +000304d0: 7473 5f67 6574 5f74 6774 2829 e280 992c  ts_get_tgt()...,
│ │ │ │ +000304e0: 2061 6e64 2074 6865 6e20 7573 6573 2074   and then uses t
│ │ │ │ +000304f0: 6861 7420 5447 5420 696e 2061 2054 4753  hat TGT in a TGS
│ │ │ │ +00030500: 2065 7863 6861 6e67 650a 2020 2020 2074   exchange.     t
│ │ │ │ +00030510: 6f20 6765 7420 7468 6520 7469 636b 6574  o get the ticket
│ │ │ │ +00030520: 2e0a 0a20 2020 2020 4375 7272 656e 746c  ...     Currentl
│ │ │ │ +00030530: 7920 7468 6973 2066 756e 6374 696f 6e20  y this function 
│ │ │ │ +00030540: 646f 6573 206e 6f74 2069 6d70 6c65 6d65  does not impleme
│ │ │ │ +00030550: 6e74 2063 726f 7373 2072 6561 6c6d 206c  nt cross realm l
│ │ │ │ +00030560: 6f67 6963 2e0a 0a20 2020 2020 2a52 6574  ogic...     *Ret
│ │ │ │ +00030570: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ +00030580: 726e 7320 6120 7469 636b 6574 2069 6620  rns a ticket if 
│ │ │ │ +00030590: 666f 756e 642c 206f 7220 4e55 4c4c 2069  found, or NULL i
│ │ │ │ +000305a0: 6620 7468 6973 2066 756e 6374 696f 6e0a  f this function.
│ │ │ │ +000305b0: 2020 2020 2069 7320 756e 6162 6c65 2074       is unable t
│ │ │ │ +000305c0: 6f20 6765 7420 7468 6520 7469 636b 6574  o get the ticket
│ │ │ │ +000305d0: 2e0a 0a73 6869 7368 695f 746b 7473 5f67  ...shishi_tkts_g
│ │ │ │ +000305e0: 6574 5f66 6f72 5f63 6c69 656e 7473 6572  et_for_clientser
│ │ │ │ +000305f0: 7665 720a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ver.------------
│ │ │ │  00030600: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00030610: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ -00030620: 3a20 5368 6973 6869 5f74 6b74 202a 2073  : Shishi_tkt * s
│ │ │ │ -00030630: 6869 7368 695f 746b 7473 5f67 6574 5f66  hishi_tkts_get_f
│ │ │ │ -00030640: 6f72 5f63 6c69 656e 7473 6572 7665 720a  or_clientserver.
│ │ │ │ -00030650: 2020 2020 2020 2020 2020 2853 6869 7368            (Shish
│ │ │ │ -00030660: 695f 746b 7473 202a 2054 4b54 532c 2063  i_tkts * TKTS, c
│ │ │ │ -00030670: 6f6e 7374 2063 6861 7220 2a20 434c 4945  onst char * CLIE
│ │ │ │ -00030680: 4e54 2c20 636f 6e73 7420 6368 6172 202a  NT, const char *
│ │ │ │ -00030690: 2053 4552 5645 5229 0a20 2020 2020 544b   SERVER).     TK
│ │ │ │ -000306a0: 5453 3a20 7469 636b 6574 2073 6574 2068  TS: ticket set h
│ │ │ │ -000306b0: 616e 646c 6520 6173 2061 6c6c 6f63 6174  andle as allocat
│ │ │ │ -000306c0: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ -000306d0: 746b 7473 2829 e280 992e 0a20 2020 2020  tkts().....     
│ │ │ │ -000306e0: 434c 4945 4e54 3a20 636c 6965 6e74 206e  CLIENT: client n
│ │ │ │ -000306f0: 616d 6520 746f 2067 6574 2074 6963 6b65  ame to get ticke
│ │ │ │ -00030700: 7420 666f 722e 0a20 2020 2020 5345 5256  t for..     SERV
│ │ │ │ -00030710: 4552 3a20 7365 7276 6572 206e 616d 6520  ER: server name 
│ │ │ │ -00030720: 746f 2067 6574 2074 6963 6b65 7420 666f  to get ticket fo
│ │ │ │ -00030730: 722e 0a0a 2020 2020 202a 4465 7363 7269  r...     *Descri
│ │ │ │ -00030740: 7074 696f 6e3a 2a20 5368 6f72 742d 6861  ption:* Short-ha
│ │ │ │ -00030750: 6e64 2066 756e 6374 696f 6e20 666f 7220  nd function for 
│ │ │ │ -00030760: 6765 7474 696e 6720 6120 7469 636b 6574  getting a ticket
│ │ │ │ -00030770: 2066 6f72 2074 6865 0a20 2020 2020 6769   for the.     gi
│ │ │ │ -00030780: 7665 6e20 636c 6965 6e74 2061 6e64 2073  ven client and s
│ │ │ │ -00030790: 6572 7665 722e 2020 5365 6520 e280 9873  erver.  See ...s
│ │ │ │ -000307a0: 6869 7368 695f 746b 7473 5f67 6574 2829  hishi_tkts_get()
│ │ │ │ -000307b0: e280 992e 0a0a 2020 2020 202a 5265 7475  ......     *Retu
│ │ │ │ -000307c0: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ -000307d0: 6e73 2061 2074 6963 6b65 7420 6966 2066  ns a ticket if f
│ │ │ │ -000307e0: 6f75 6e64 2c20 6f72 204e 554c 4c2e 0a0a  ound, or NULL...
│ │ │ │ -000307f0: 7368 6973 6869 5f74 6b74 735f 6765 745f  shishi_tkts_get_
│ │ │ │ -00030800: 666f 725f 7365 7276 6572 0a2d 2d2d 2d2d  for_server.-----
│ │ │ │ +00030610: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ +00030620: 6f6e 3a20 5368 6973 6869 5f74 6b74 202a  on: Shishi_tkt *
│ │ │ │ +00030630: 2073 6869 7368 695f 746b 7473 5f67 6574   shishi_tkts_get
│ │ │ │ +00030640: 5f66 6f72 5f63 6c69 656e 7473 6572 7665  _for_clientserve
│ │ │ │ +00030650: 720a 2020 2020 2020 2020 2020 2853 6869  r.          (Shi
│ │ │ │ +00030660: 7368 695f 746b 7473 202a 2054 4b54 532c  shi_tkts * TKTS,
│ │ │ │ +00030670: 2063 6f6e 7374 2063 6861 7220 2a20 434c   const char * CL
│ │ │ │ +00030680: 4945 4e54 2c20 636f 6e73 7420 6368 6172  IENT, const char
│ │ │ │ +00030690: 202a 2053 4552 5645 5229 0a20 2020 2020   * SERVER).     
│ │ │ │ +000306a0: 544b 5453 3a20 7469 636b 6574 2073 6574  TKTS: ticket set
│ │ │ │ +000306b0: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ +000306c0: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ +000306d0: 695f 746b 7473 2829 e280 992e 0a20 2020  i_tkts().....   
│ │ │ │ +000306e0: 2020 434c 4945 4e54 3a20 636c 6965 6e74    CLIENT: client
│ │ │ │ +000306f0: 206e 616d 6520 746f 2067 6574 2074 6963   name to get tic
│ │ │ │ +00030700: 6b65 7420 666f 722e 0a20 2020 2020 5345  ket for..     SE
│ │ │ │ +00030710: 5256 4552 3a20 7365 7276 6572 206e 616d  RVER: server nam
│ │ │ │ +00030720: 6520 746f 2067 6574 2074 6963 6b65 7420  e to get ticket 
│ │ │ │ +00030730: 666f 722e 0a0a 2020 2020 202a 4465 7363  for...     *Desc
│ │ │ │ +00030740: 7269 7074 696f 6e3a 2a20 5368 6f72 742d  ription:* Short-
│ │ │ │ +00030750: 6861 6e64 2066 756e 6374 696f 6e20 666f  hand function fo
│ │ │ │ +00030760: 7220 6765 7474 696e 6720 6120 7469 636b  r getting a tick
│ │ │ │ +00030770: 6574 2066 6f72 2074 6865 0a20 2020 2020  et for the.     
│ │ │ │ +00030780: 6769 7665 6e20 636c 6965 6e74 2061 6e64  given client and
│ │ │ │ +00030790: 2073 6572 7665 722e 2020 5365 6520 e280   server.  See ..
│ │ │ │ +000307a0: 9873 6869 7368 695f 746b 7473 5f67 6574  .shishi_tkts_get
│ │ │ │ +000307b0: 2829 e280 992e 0a0a 2020 2020 202a 5265  ()......     *Re
│ │ │ │ +000307c0: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ +000307d0: 7572 6e73 2061 2074 6963 6b65 7420 6966  urns a ticket if
│ │ │ │ +000307e0: 2066 6f75 6e64 2c20 6f72 204e 554c 4c2e   found, or NULL.
│ │ │ │ +000307f0: 0a0a 7368 6973 6869 5f74 6b74 735f 6765  ..shishi_tkts_ge
│ │ │ │ +00030800: 745f 666f 725f 7365 7276 6572 0a2d 2d2d  t_for_server.---
│ │ │ │  00030810: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00030820: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ -00030830: 696f 6e3a 2053 6869 7368 695f 746b 7420  ion: Shishi_tkt 
│ │ │ │ -00030840: 2a20 7368 6973 6869 5f74 6b74 735f 6765  * shishi_tkts_ge
│ │ │ │ -00030850: 745f 666f 725f 7365 7276 6572 0a20 2020  t_for_server.   
│ │ │ │ -00030860: 2020 2020 2020 2028 5368 6973 6869 5f74         (Shishi_t
│ │ │ │ -00030870: 6b74 7320 2a20 544b 5453 2c20 636f 6e73  kts * TKTS, cons
│ │ │ │ -00030880: 7420 6368 6172 202a 2053 4552 5645 5229  t char * SERVER)
│ │ │ │ -00030890: 0a20 2020 2020 544b 5453 3a20 7469 636b  .     TKTS: tick
│ │ │ │ -000308a0: 6574 2073 6574 2068 616e 646c 6520 6173  et set handle as
│ │ │ │ -000308b0: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ -000308c0: 9873 6869 7368 695f 746b 7473 2829 e280  .shishi_tkts()..
│ │ │ │ -000308d0: 992e 0a20 2020 2020 5345 5256 4552 3a20  ...     SERVER: 
│ │ │ │ -000308e0: 7365 7276 6572 206e 616d 6520 746f 2067  server name to g
│ │ │ │ -000308f0: 6574 2074 6963 6b65 7420 666f 722e 0a0a  et ticket for...
│ │ │ │ -00030900: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ -00030910: 6e3a 2a20 5368 6f72 742d 6861 6e64 2066  n:* Short-hand f
│ │ │ │ -00030920: 756e 6374 696f 6e20 666f 7220 6765 7474  unction for gett
│ │ │ │ -00030930: 696e 6720 6120 7469 636b 6574 2074 6f20  ing a ticket to 
│ │ │ │ -00030940: 7468 650a 2020 2020 2067 6976 656e 2073  the.     given s
│ │ │ │ -00030950: 6572 7665 7220 616e 6420 666f 7220 7468  erver and for th
│ │ │ │ -00030960: 6520 6465 6661 756c 7420 7072 696e 6369  e default princi
│ │ │ │ -00030970: 7061 6c20 636c 6965 6e74 2e20 2053 6565  pal client.  See
│ │ │ │ -00030980: 0a20 2020 2020 e280 9873 6869 7368 695f  .     ...shishi_
│ │ │ │ -00030990: 746b 7473 5f67 6574 2829 e280 992e 0a0a  tkts_get()......
│ │ │ │ -000309a0: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ -000309b0: 7565 3a2a 2052 6574 7572 6e73 2061 2074  ue:* Returns a t
│ │ │ │ -000309c0: 6963 6b65 7420 6966 2066 6f75 6e64 2c20  icket if found, 
│ │ │ │ -000309d0: 6f72 204e 554c 4c2e 0a0a 7368 6973 6869  or NULL...shishi
│ │ │ │ -000309e0: 5f74 6b74 735f 6765 745f 666f 725f 6c6f  _tkts_get_for_lo
│ │ │ │ -000309f0: 6361 6c73 6572 7669 6365 7061 7373 7764  calservicepasswd
│ │ │ │ -00030a00: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ +00030820: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +00030830: 6374 696f 6e3a 2053 6869 7368 695f 746b  ction: Shishi_tk
│ │ │ │ +00030840: 7420 2a20 7368 6973 6869 5f74 6b74 735f  t * shishi_tkts_
│ │ │ │ +00030850: 6765 745f 666f 725f 7365 7276 6572 0a20  get_for_server. 
│ │ │ │ +00030860: 2020 2020 2020 2020 2028 5368 6973 6869           (Shishi
│ │ │ │ +00030870: 5f74 6b74 7320 2a20 544b 5453 2c20 636f  _tkts * TKTS, co
│ │ │ │ +00030880: 6e73 7420 6368 6172 202a 2053 4552 5645  nst char * SERVE
│ │ │ │ +00030890: 5229 0a20 2020 2020 544b 5453 3a20 7469  R).     TKTS: ti
│ │ │ │ +000308a0: 636b 6574 2073 6574 2068 616e 646c 6520  cket set handle 
│ │ │ │ +000308b0: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ +000308c0: e280 9873 6869 7368 695f 746b 7473 2829  ...shishi_tkts()
│ │ │ │ +000308d0: e280 992e 0a20 2020 2020 5345 5256 4552  .....     SERVER
│ │ │ │ +000308e0: 3a20 7365 7276 6572 206e 616d 6520 746f  : server name to
│ │ │ │ +000308f0: 2067 6574 2074 6963 6b65 7420 666f 722e   get ticket for.
│ │ │ │ +00030900: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ +00030910: 696f 6e3a 2a20 5368 6f72 742d 6861 6e64  ion:* Short-hand
│ │ │ │ +00030920: 2066 756e 6374 696f 6e20 666f 7220 6765   function for ge
│ │ │ │ +00030930: 7474 696e 6720 6120 7469 636b 6574 2074  tting a ticket t
│ │ │ │ +00030940: 6f20 7468 650a 2020 2020 2067 6976 656e  o the.     given
│ │ │ │ +00030950: 2073 6572 7665 7220 616e 6420 666f 7220   server and for 
│ │ │ │ +00030960: 7468 6520 6465 6661 756c 7420 7072 696e  the default prin
│ │ │ │ +00030970: 6369 7061 6c20 636c 6965 6e74 2e20 2053  cipal client.  S
│ │ │ │ +00030980: 6565 0a20 2020 2020 e280 9873 6869 7368  ee.     ...shish
│ │ │ │ +00030990: 695f 746b 7473 5f67 6574 2829 e280 992e  i_tkts_get()....
│ │ │ │ +000309a0: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ +000309b0: 616c 7565 3a2a 2052 6574 7572 6e73 2061  alue:* Returns a
│ │ │ │ +000309c0: 2074 6963 6b65 7420 6966 2066 6f75 6e64   ticket if found
│ │ │ │ +000309d0: 2c20 6f72 204e 554c 4c2e 0a0a 7368 6973  , or NULL...shis
│ │ │ │ +000309e0: 6869 5f74 6b74 735f 6765 745f 666f 725f  hi_tkts_get_for_
│ │ │ │ +000309f0: 6c6f 6361 6c73 6572 7669 6365 7061 7373  localservicepass
│ │ │ │ +00030a00: 7764 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  wd.-------------
│ │ │ │  00030a10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00030a20: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ -00030a30: 6374 696f 6e3a 2053 6869 7368 695f 746b  ction: Shishi_tk
│ │ │ │ -00030a40: 7420 2a20 7368 6973 6869 5f74 6b74 735f  t * shishi_tkts_
│ │ │ │ -00030a50: 6765 745f 666f 725f 6c6f 6361 6c73 6572  get_for_localser
│ │ │ │ -00030a60: 7669 6365 7061 7373 7764 0a20 2020 2020  vicepasswd.     
│ │ │ │ -00030a70: 2020 2020 2028 5368 6973 6869 5f74 6b74       (Shishi_tkt
│ │ │ │ -00030a80: 7320 2a20 544b 5453 2c20 636f 6e73 7420  s * TKTS, const 
│ │ │ │ -00030a90: 6368 6172 202a 2053 4552 5649 4345 2c0a  char * SERVICE,.
│ │ │ │ -00030aa0: 2020 2020 2020 2020 2020 636f 6e73 7420            const 
│ │ │ │ -00030ab0: 6368 6172 202a 2050 4153 5357 4429 0a20  char * PASSWD). 
│ │ │ │ -00030ac0: 2020 2020 544b 5453 3a20 7469 636b 6574      TKTS: ticket
│ │ │ │ -00030ad0: 2073 6574 2068 616e 646c 6520 6173 2061   set handle as a
│ │ │ │ -00030ae0: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ -00030af0: 6869 7368 695f 746b 7473 2829 e280 992e  hishi_tkts()....
│ │ │ │ -00030b00: 0a20 2020 2020 5345 5256 4943 453a 2073  .     SERVICE: s
│ │ │ │ -00030b10: 6572 7669 6365 206e 616d 6520 746f 2067  ervice name to g
│ │ │ │ -00030b20: 6574 2074 6963 6b65 7420 666f 722e 0a20  et ticket for.. 
│ │ │ │ -00030b30: 2020 2020 5041 5353 5744 3a20 7061 7373      PASSWD: pass
│ │ │ │ -00030b40: 776f 7264 2066 6f72 2074 6865 2064 6566  word for the def
│ │ │ │ -00030b50: 6175 6c74 2063 6c69 656e 7420 7072 696e  ault client prin
│ │ │ │ -00030b60: 6369 7061 6c2e 0a0a 2020 2020 202a 4465  cipal...     *De
│ │ │ │ -00030b70: 7363 7269 7074 696f 6e3a 2a20 5368 6f72  scription:* Shor
│ │ │ │ -00030b80: 742d 6861 6e64 2066 756e 6374 696f 6e20  t-hand function 
│ │ │ │ -00030b90: 666f 7220 6765 7474 696e 6720 6120 7469  for getting a ti
│ │ │ │ -00030ba0: 636b 6574 2074 6f20 7468 650a 2020 2020  cket to the.    
│ │ │ │ -00030bb0: 2067 6976 656e 206c 6f63 616c 2073 6572   given local ser
│ │ │ │ -00030bc0: 7669 6365 2c20 616e 6420 666f 7220 7468  vice, and for th
│ │ │ │ -00030bd0: 6520 6465 6661 756c 7420 7072 696e 6369  e default princi
│ │ │ │ -00030be0: 7061 6c20 636c 6965 6e74 2e20 2054 6865  pal client.  The
│ │ │ │ -00030bf0: 0a20 2020 2020 6c61 7474 6572 2773 2070  .     latter's p
│ │ │ │ -00030c00: 6173 7377 6f72 6420 6973 2067 6976 656e  assword is given
│ │ │ │ -00030c10: 2061 7320 6172 6775 6d65 6e74 2e20 2053   as argument.  S
│ │ │ │ -00030c20: 6565 20e2 8098 7368 6973 6869 5f74 6b74  ee ...shishi_tkt
│ │ │ │ -00030c30: 735f 6765 7428 29e2 8099 2e0a 0a20 2020  s_get()......   
│ │ │ │ -00030c40: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ -00030c50: 2a20 5265 7475 726e 7320 6120 7469 636b  * Returns a tick
│ │ │ │ -00030c60: 6574 2069 6620 666f 756e 642c 206f 7220  et if found, or 
│ │ │ │ -00030c70: 4e55 4c4c 206f 7468 6572 7769 7365 2e0a  NULL otherwise..
│ │ │ │ -00030c80: 0a1f 0a46 696c 653a 2073 6869 7368 692e  ...File: shishi.
│ │ │ │ -00030c90: 696e 666f 2c20 204e 6f64 653a 2041 502d  info,  Node: AP-
│ │ │ │ -00030ca0: 5245 5120 616e 6420 4150 2d52 4550 2046  REQ and AP-REP F
│ │ │ │ -00030cb0: 756e 6374 696f 6e73 2c20 204e 6578 743a  unctions,  Next:
│ │ │ │ -00030cc0: 2053 4146 4520 616e 6420 5052 4956 2046   SAFE and PRIV F
│ │ │ │ -00030cd0: 756e 6374 696f 6e73 2c20 2050 7265 763a  unctions,  Prev:
│ │ │ │ -00030ce0: 2054 6963 6b65 7420 5365 7420 4675 6e63   Ticket Set Func
│ │ │ │ -00030cf0: 7469 6f6e 732c 2020 5570 3a20 5072 6f67  tions,  Up: Prog
│ │ │ │ -00030d00: 7261 6d6d 696e 6720 4d61 6e75 616c 0a0a  ramming Manual..
│ │ │ │ -00030d10: 352e 3420 4150 2d52 4551 2061 6e64 2041  5.4 AP-REQ and A
│ │ │ │ -00030d20: 502d 5245 5020 4675 6e63 7469 6f6e 730a  P-REP Functions.
│ │ │ │ -00030d30: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ -00030d40: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a  ===============.
│ │ │ │ -00030d50: 0a54 6865 2022 4150 2d52 4551 2220 616e  .The "AP-REQ" an
│ │ │ │ -00030d60: 6420 2241 502d 5245 5022 2061 7265 2041  d "AP-REP" are A
│ │ │ │ -00030d70: 534e 2e31 2073 7472 7563 7475 7265 7320  SN.1 structures 
│ │ │ │ -00030d80: 7573 6564 2062 7920 6170 706c 6963 6174  used by applicat
│ │ │ │ -00030d90: 696f 6e0a 636c 6965 6e74 2061 6e64 2073  ion.client and s
│ │ │ │ -00030da0: 6572 7665 7273 2074 6f20 7072 6f76 6520  ervers to prove 
│ │ │ │ -00030db0: 746f 2065 6163 6820 6f74 6865 7220 7768  to each other wh
│ │ │ │ -00030dc0: 6f20 7468 6579 2061 7265 2e20 2054 6865  o they are.  The
│ │ │ │ -00030dd0: 2073 7472 7563 7475 7265 730a 636f 6e74   structures.cont
│ │ │ │ -00030de0: 6169 6e20 6175 7869 6c6c 6961 7279 2069  ain auxilliary i
│ │ │ │ -00030df0: 6e66 6f72 6d61 7469 6f6e 2c20 746f 6765  nformation, toge
│ │ │ │ -00030e00: 7468 6572 2077 6974 6820 616e 2061 7574  ther with an aut
│ │ │ │ -00030e10: 6865 6e74 6963 6174 6f72 2028 2a6e 6f74  henticator (*not
│ │ │ │ -00030e20: 650a 4175 7468 656e 7469 6361 746f 7220  e.Authenticator 
│ │ │ │ -00030e30: 4675 6e63 7469 6f6e 733a 3a29 2077 6869  Functions::) whi
│ │ │ │ -00030e40: 6368 2069 7320 7468 6520 7265 616c 2063  ch is the real c
│ │ │ │ -00030e50: 7279 7074 6f67 7261 7068 6963 2070 726f  ryptographic pro
│ │ │ │ -00030e60: 6f66 2e20 2054 6865 0a66 6f6c 6c6f 7769  of.  The.followi
│ │ │ │ -00030e70: 6e67 2069 6c6c 7573 7472 6174 6573 2074  ng illustrates t
│ │ │ │ -00030e80: 6865 2041 502d 5245 5120 616e 6420 4150  he AP-REQ and AP
│ │ │ │ -00030e90: 2d52 4550 2041 534e 2e31 2073 7472 7563  -REP ASN.1 struc
│ │ │ │ -00030ea0: 7475 7265 732e 0a0a 4150 2d52 4551 0909  tures...AP-REQ..
│ │ │ │ -00030eb0: 3a3a 3d20 5b41 5050 4c49 4341 5449 4f4e  ::= [APPLICATION
│ │ │ │ -00030ec0: 2031 345d 2053 4551 5545 4e43 4520 7b0a   14] SEQUENCE {.
│ │ │ │ -00030ed0: 0970 766e 6f09 095b 305d 2049 4e54 4547  .pvno..[0] INTEG
│ │ │ │ -00030ee0: 4552 2028 3529 2c0a 096d 7367 2d74 7970  ER (5),..msg-typ
│ │ │ │ -00030ef0: 6509 5b31 5d20 494e 5445 4745 5220 2831  e.[1] INTEGER (1
│ │ │ │ -00030f00: 3429 2c0a 0961 702d 6f70 7469 6f6e 7309  4),..ap-options.
│ │ │ │ -00030f10: 5b32 5d20 4150 4f70 7469 6f6e 732c 0a09  [2] APOptions,..
│ │ │ │ -00030f20: 7469 636b 6574 0909 5b33 5d20 5469 636b  ticket..[3] Tick
│ │ │ │ -00030f30: 6574 2c0a 0961 7574 6865 6e74 6963 6174  et,..authenticat
│ │ │ │ -00030f40: 6f72 095b 345d 2045 6e63 7279 7074 6564  or.[4] Encrypted
│ │ │ │ -00030f50: 4461 7461 207b 4175 7468 656e 7469 6361  Data {Authentica
│ │ │ │ -00030f60: 746f 722c 0a09 0909 097b 206b 6579 7573  tor,.....{ keyus
│ │ │ │ -00030f70: 652d 7061 2d54 4753 5265 712d 6175 7468  e-pa-TGSReq-auth
│ │ │ │ -00030f80: 656e 7469 6361 746f 720a 0909 0909 2020  enticator.....  
│ │ │ │ -00030f90: 7c20 6b65 7975 7365 2d41 5052 6571 2d61  | keyuse-APReq-a
│ │ │ │ -00030fa0: 7574 6865 6e74 6963 6174 6f72 207d 7d0a  uthenticator }}.
│ │ │ │ -00030fb0: 7d0a 0a41 502d 5245 5009 093a 3a3d 205b  }..AP-REP..::= [
│ │ │ │ -00030fc0: 4150 504c 4943 4154 494f 4e20 3135 5d20  APPLICATION 15] 
│ │ │ │ -00030fd0: 5345 5155 454e 4345 207b 0a09 7076 6e6f  SEQUENCE {..pvno
│ │ │ │ -00030fe0: 0909 5b30 5d20 494e 5445 4745 5220 2835  ..[0] INTEGER (5
│ │ │ │ -00030ff0: 292c 0a09 6d73 672d 7479 7065 095b 315d  ),..msg-type.[1]
│ │ │ │ -00031000: 2049 4e54 4547 4552 2028 3135 292c 0a09   INTEGER (15),..
│ │ │ │ -00031010: 656e 632d 7061 7274 095b 325d 2045 6e63  enc-part.[2] Enc
│ │ │ │ -00031020: 7279 7074 6564 4461 7461 207b 456e 6341  ryptedData {EncA
│ │ │ │ -00031030: 5052 6570 5061 7274 2c0a 0909 0909 7b20  PRepPart,.....{ 
│ │ │ │ -00031040: 6b65 7975 7365 2d45 6e63 4150 5265 7050  keyuse-EncAPRepP
│ │ │ │ -00031050: 6172 7420 7d7d 0a7d 0a0a 456e 6341 5052  art }}.}..EncAPR
│ │ │ │ -00031060: 6570 5061 7274 093a 3a3d 205b 4150 504c  epPart.::= [APPL
│ │ │ │ -00031070: 4943 4154 494f 4e20 3237 5d20 5345 5155  ICATION 27] SEQU
│ │ │ │ -00031080: 454e 4345 207b 0a09 6374 696d 6509 095b  ENCE {..ctime..[
│ │ │ │ -00031090: 305d 204b 6572 6265 726f 7354 696d 652c  0] KerberosTime,
│ │ │ │ -000310a0: 0a09 6375 7365 6309 095b 315d 204d 6963  ..cusec..[1] Mic
│ │ │ │ -000310b0: 726f 7365 636f 6e64 732c 0a09 7375 626b  roseconds,..subk
│ │ │ │ -000310c0: 6579 0909 5b32 5d20 456e 6372 7970 7469  ey..[2] Encrypti
│ │ │ │ -000310d0: 6f6e 4b65 7920 4f50 5449 4f4e 414c 2c0a  onKey OPTIONAL,.
│ │ │ │ -000310e0: 0973 6571 2d6e 756d 6265 7209 5b33 5d20  .seq-number.[3] 
│ │ │ │ -000310f0: 5549 6e74 3332 204f 5054 494f 4e41 4c0a  UInt32 OPTIONAL.
│ │ │ │ -00031100: 7d0a 0a73 6869 7368 695f 6170 0a2d 2d2d  }..shishi_ap.---
│ │ │ │ -00031110: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ -00031120: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ -00031130: 5f61 7020 2853 6869 7368 6920 2a20 4841  _ap (Shishi * HA
│ │ │ │ -00031140: 4e44 4c45 2c20 5368 6973 6869 5f61 7020  NDLE, Shishi_ap 
│ │ │ │ -00031150: 2a2a 2041 5029 0a20 2020 2020 4841 4e44  ** AP).     HAND
│ │ │ │ -00031160: 4c45 3a20 7368 6973 6869 2068 616e 646c  LE: shishi handl
│ │ │ │ -00031170: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ -00031180: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ -00031190: 2829 e280 992e 0a20 2020 2020 4150 3a20  ().....     AP: 
│ │ │ │ -000311a0: 706f 696e 7465 7220 746f 206e 6577 2073  pointer to new s
│ │ │ │ -000311b0: 7472 7563 7475 7265 2074 6861 7420 686f  tructure that ho
│ │ │ │ -000311c0: 6c64 7320 696e 666f 726d 6174 696f 6e20  lds information 
│ │ │ │ -000311d0: 6162 6f75 7420 4150 0a20 2020 2020 6578  about AP.     ex
│ │ │ │ -000311e0: 6368 616e 6765 0a0a 2020 2020 202a 4465  change..     *De
│ │ │ │ -000311f0: 7363 7269 7074 696f 6e3a 2a20 4372 6561  scription:* Crea
│ │ │ │ -00031200: 7465 2061 206e 6577 2041 5020 6578 6368  te a new AP exch
│ │ │ │ -00031210: 616e 6765 2077 6974 6820 6120 7261 6e64  ange with a rand
│ │ │ │ -00031220: 6f6d 2073 7562 6b65 7920 6f66 2074 6865  om subkey of the
│ │ │ │ -00031230: 0a20 2020 2020 6465 6661 756c 7420 656e  .     default en
│ │ │ │ -00031240: 6372 7970 7469 6f6e 2074 7970 6520 6672  cryption type fr
│ │ │ │ -00031250: 6f6d 2063 6f6e 6669 6775 7261 7469 6f6e  om configuration
│ │ │ │ -00031260: 2e20 204e 6f74 6520 7468 6174 2074 6865  .  Note that the
│ │ │ │ -00031270: 7265 2069 7320 6e6f 0a20 2020 2020 6775  re is no.     gu
│ │ │ │ -00031280: 6172 616e 7465 6520 7468 6174 2074 6865  arantee that the
│ │ │ │ -00031290: 2072 6563 6569 7665 7220 7769 6c6c 2075   receiver will u
│ │ │ │ -000312a0: 6e64 6572 7374 616e 6420 7468 6174 206b  nderstand that k
│ │ │ │ -000312b0: 6579 2074 7970 652c 2079 6f75 0a20 2020  ey type, you.   
│ │ │ │ -000312c0: 2020 7368 6f75 6c64 2070 726f 6261 626c    should probabl
│ │ │ │ -000312d0: 7920 7573 6520 e280 9873 6869 7368 695f  y use ...shishi_
│ │ │ │ -000312e0: 6170 5f65 7479 7065 2829 e280 9920 6f72  ap_etype()... or
│ │ │ │ -000312f0: 20e2 8098 7368 6973 6869 5f61 705f 6e6f   ...shishi_ap_no
│ │ │ │ -00031300: 7375 626b 6579 2829 e280 990a 2020 2020  subkey()....    
│ │ │ │ -00031310: 2069 6e73 7465 6164 2e20 2049 6e20 7468   instead.  In th
│ │ │ │ -00031320: 6520 6675 7475 7265 2c20 7468 6973 2066  e future, this f
│ │ │ │ -00031330: 756e 6374 696f 6e20 7769 6c6c 206c 696b  unction will lik
│ │ │ │ -00031340: 656c 7920 6265 6861 7665 2061 730a 2020  ely behave as.  
│ │ │ │ -00031350: 2020 20e2 8098 7368 6973 6869 5f61 705f     ...shishi_ap_
│ │ │ │ -00031360: 6e6f 7375 626b 6579 2829 e280 9920 616e  nosubkey()... an
│ │ │ │ -00031370: 6420 e280 9873 6869 7368 695f 6170 5f6e  d ...shishi_ap_n
│ │ │ │ -00031380: 6f73 7562 6b65 7928 29e2 8099 2077 696c  osubkey()... wil
│ │ │ │ -00031390: 6c20 6265 2072 656d 6f76 6564 2e0a 0a20  l be removed... 
│ │ │ │ -000313a0: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ -000313b0: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ -000313c0: 4849 5f4f 4b20 6966 6620 7375 6363 6573  HI_OK iff succes
│ │ │ │ -000313d0: 7366 756c 2e0a 0a73 6869 7368 695f 6170  sful...shishi_ap
│ │ │ │ -000313e0: 5f65 7479 7065 0a2d 2d2d 2d2d 2d2d 2d2d  _etype.---------
│ │ │ │ -000313f0: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ -00031400: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ -00031410: 5f61 705f 6574 7970 6520 2853 6869 7368  _ap_etype (Shish
│ │ │ │ -00031420: 6920 2a20 4841 4e44 4c45 2c20 5368 6973  i * HANDLE, Shis
│ │ │ │ -00031430: 6869 5f61 7020 2a2a 2041 502c 0a20 2020  hi_ap ** AP,.   
│ │ │ │ -00031440: 2020 2020 2020 2069 6e74 2045 5459 5045         int ETYPE
│ │ │ │ -00031450: 290a 2020 2020 2048 414e 444c 453a 2073  ).     HANDLE: s
│ │ │ │ -00031460: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ -00031470: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ -00031480: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ -00031490: 2e0a 2020 2020 2041 503a 2070 6f69 6e74  ..     AP: point
│ │ │ │ -000314a0: 6572 2074 6f20 6e65 7720 7374 7275 6374  er to new struct
│ │ │ │ -000314b0: 7572 6520 7468 6174 2068 6f6c 6473 2069  ure that holds i
│ │ │ │ -000314c0: 6e66 6f72 6d61 7469 6f6e 2061 626f 7574  nformation about
│ │ │ │ -000314d0: 2041 500a 2020 2020 2065 7863 6861 6e67   AP.     exchang
│ │ │ │ -000314e0: 650a 2020 2020 2045 5459 5045 3a20 656e  e.     ETYPE: en
│ │ │ │ -000314f0: 6372 7970 7469 6f6e 2074 7970 6520 6f66  cryption type of
│ │ │ │ -00031500: 206e 6577 6c79 2067 656e 6572 6174 6564   newly generated
│ │ │ │ -00031510: 2072 616e 646f 6d20 7375 626b 6579 2e0a   random subkey..
│ │ │ │ -00031520: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -00031530: 6f6e 3a2a 2043 7265 6174 6520 6120 6e65  on:* Create a ne
│ │ │ │ -00031540: 7720 4150 2065 7863 6861 6e67 6520 7769  w AP exchange wi
│ │ │ │ -00031550: 7468 2061 2072 616e 646f 6d20 7375 626b  th a random subk
│ │ │ │ -00031560: 6579 206f 660a 2020 2020 2069 6e64 6963  ey of.     indic
│ │ │ │ -00031570: 6174 6564 2065 6e63 7279 7074 696f 6e20  ated encryption 
│ │ │ │ -00031580: 7479 7065 2e0a 0a20 2020 2020 2a52 6574  type...     *Ret
│ │ │ │ -00031590: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ -000315a0: 726e 7320 5348 4953 4849 5f4f 4b20 6966  rns SHISHI_OK if
│ │ │ │ -000315b0: 6620 7375 6363 6573 7366 756c 2e0a 0a73  f successful...s
│ │ │ │ -000315c0: 6869 7368 695f 6170 5f6e 6f73 7562 6b65  hishi_ap_nosubke
│ │ │ │ -000315d0: 790a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  y.--------------
│ │ │ │ -000315e0: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -000315f0: 6f6e 3a20 696e 7420 7368 6973 6869 5f61  on: int shishi_a
│ │ │ │ -00031600: 705f 6e6f 7375 626b 6579 2028 5368 6973  p_nosubkey (Shis
│ │ │ │ -00031610: 6869 202a 2048 414e 444c 452c 2053 6869  hi * HANDLE, Shi
│ │ │ │ -00031620: 7368 695f 6170 202a 2a20 4150 290a 2020  shi_ap ** AP).  
│ │ │ │ -00031630: 2020 2048 414e 444c 453a 2073 6869 7368     HANDLE: shish
│ │ │ │ -00031640: 6920 6861 6e64 6c65 2061 7320 616c 6c6f  i handle as allo
│ │ │ │ -00031650: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ -00031660: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ -00031670: 2020 2041 503a 2070 6f69 6e74 6572 2074     AP: pointer t
│ │ │ │ -00031680: 6f20 6e65 7720 7374 7275 6374 7572 6520  o new structure 
│ │ │ │ -00031690: 7468 6174 2068 6f6c 6473 2069 6e66 6f72  that holds infor
│ │ │ │ -000316a0: 6d61 7469 6f6e 2061 626f 7574 2041 500a  mation about AP.
│ │ │ │ -000316b0: 2020 2020 2065 7863 6861 6e67 650a 0a20       exchange.. 
│ │ │ │ -000316c0: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -000316d0: 3a2a 2043 7265 6174 6520 6120 6e65 7720  :* Create a new 
│ │ │ │ -000316e0: 4150 2065 7863 6861 6e67 6520 7769 7468  AP exchange with
│ │ │ │ -000316f0: 6f75 7420 7375 626b 6579 2069 6e0a 2020  out subkey in.  
│ │ │ │ -00031700: 2020 2061 7574 6865 6e74 6963 6174 6f72     authenticator
│ │ │ │ -00031710: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ -00031720: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ -00031730: 5348 4953 4849 5f4f 4b20 6966 6620 7375  SHISHI_OK iff su
│ │ │ │ -00031740: 6363 6573 7366 756c 2e0a 0a73 6869 7368  ccessful...shish
│ │ │ │ -00031750: 695f 6170 5f64 6f6e 650a 2d2d 2d2d 2d2d  i_ap_done.------
│ │ │ │ -00031760: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -00031770: 6e63 7469 6f6e 3a20 766f 6964 2073 6869  nction: void shi
│ │ │ │ -00031780: 7368 695f 6170 5f64 6f6e 6520 2853 6869  shi_ap_done (Shi
│ │ │ │ -00031790: 7368 695f 6170 202a 2041 5029 0a20 2020  shi_ap * AP).   
│ │ │ │ -000317a0: 2020 4150 3a20 7374 7275 6374 7572 6520    AP: structure 
│ │ │ │ -000317b0: 7468 6174 2068 6f6c 6473 2069 6e66 6f72  that holds infor
│ │ │ │ -000317c0: 6d61 7469 6f6e 2061 626f 7574 2041 5020  mation about AP 
│ │ │ │ -000317d0: 6578 6368 616e 6765 0a0a 2020 2020 202a  exchange..     *
│ │ │ │ -000317e0: 4465 7363 7269 7074 696f 6e3a 2a20 4465  Description:* De
│ │ │ │ -000317f0: 616c 6c6f 6361 7465 2072 6573 6f75 7263  allocate resourc
│ │ │ │ -00031800: 6573 2061 7373 6f63 6961 7465 6420 7769  es associated wi
│ │ │ │ -00031810: 7468 2041 5020 6578 6368 616e 6765 2e0a  th AP exchange..
│ │ │ │ -00031820: 2020 2020 2054 6869 7320 7368 6f75 6c64       This should
│ │ │ │ -00031830: 2062 6520 6361 6c6c 6564 2062 7920 7468   be called by th
│ │ │ │ -00031840: 6520 6170 706c 6963 6174 696f 6e20 7768  e application wh
│ │ │ │ -00031850: 656e 2069 7420 6e6f 206c 6f6e 6765 7220  en it no longer 
│ │ │ │ -00031860: 6e65 6564 2074 6f0a 2020 2020 2075 7469  need to.     uti
│ │ │ │ -00031870: 6c69 7a65 2074 6865 2041 5020 6578 6368  lize the AP exch
│ │ │ │ -00031880: 616e 6765 2068 616e 646c 652e 0a0a 7368  ange handle...sh
│ │ │ │ -00031890: 6973 6869 5f61 705f 7365 745f 746b 746f  ishi_ap_set_tkto
│ │ │ │ -000318a0: 7074 696f 6e73 0a2d 2d2d 2d2d 2d2d 2d2d  ptions.---------
│ │ │ │ -000318b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -000318c0: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ -000318d0: 6e74 2073 6869 7368 695f 6170 5f73 6574  nt shishi_ap_set
│ │ │ │ -000318e0: 5f74 6b74 6f70 7469 6f6e 7320 2853 6869  _tktoptions (Shi
│ │ │ │ -000318f0: 7368 695f 6170 202a 2041 502c 0a20 2020  shi_ap * AP,.   
│ │ │ │ -00031900: 2020 2020 2020 2053 6869 7368 695f 746b         Shishi_tk
│ │ │ │ -00031910: 7420 2a20 544b 542c 2069 6e74 204f 5054  t * TKT, int OPT
│ │ │ │ -00031920: 494f 4e53 290a 2020 2020 2041 503a 2073  IONS).     AP: s
│ │ │ │ -00031930: 7472 7563 7475 7265 2074 6861 7420 686f  tructure that ho
│ │ │ │ -00031940: 6c64 7320 696e 666f 726d 6174 696f 6e20  lds information 
│ │ │ │ -00031950: 6162 6f75 7420 4150 2065 7863 6861 6e67  about AP exchang
│ │ │ │ -00031960: 650a 2020 2020 2054 4b54 3a20 7469 636b  e.     TKT: tick
│ │ │ │ -00031970: 6574 2074 6f20 7365 7420 696e 2041 502e  et to set in AP.
│ │ │ │ -00031980: 0a20 2020 2020 4f50 5449 4f4e 533a 2041  .     OPTIONS: A
│ │ │ │ -00031990: 502d 5245 5120 6f70 7469 6f6e 7320 746f  P-REQ options to
│ │ │ │ -000319a0: 2073 6574 2069 6e20 4150 2e0a 0a20 2020   set in AP...   
│ │ │ │ -000319b0: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ -000319c0: 2053 6574 2074 6865 2074 6963 6b65 7420   Set the ticket 
│ │ │ │ -000319d0: 2873 6565 20e2 8098 7368 6973 6869 5f61  (see ...shishi_a
│ │ │ │ -000319e0: 705f 746b 745f 7365 7428 29e2 8099 2920  p_tkt_set()...) 
│ │ │ │ -000319f0: 616e 6420 7365 740a 2020 2020 2074 6865  and set.     the
│ │ │ │ -00031a00: 2041 502d 5245 5120 6170 6f70 7469 6f6e   AP-REQ apoption
│ │ │ │ -00031a10: 7320 2873 6565 20e2 8098 7368 6973 6869  s (see ...shishi
│ │ │ │ -00031a20: 5f61 7072 6571 5f6f 7074 696f 6e73 5f73  _apreq_options_s
│ │ │ │ -00031a30: 6574 2829 e280 9929 2e0a 0a20 2020 2020  et()...)...     
│ │ │ │ -00031a40: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ -00031a50: 5265 7475 726e 7320 5348 4953 4849 5f4f  Returns SHISHI_O
│ │ │ │ -00031a60: 4b20 6966 6620 7375 6363 6573 7366 756c  K iff successful
│ │ │ │ -00031a70: 2e0a 0a73 6869 7368 695f 6170 5f73 6574  ...shishi_ap_set
│ │ │ │ -00031a80: 5f74 6b74 6f70 7469 6f6e 7364 6174 610a  _tktoptionsdata.
│ │ │ │ -00031a90: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00031aa0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ -00031ab0: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ -00031ac0: 7368 6973 6869 5f61 705f 7365 745f 746b  shishi_ap_set_tk
│ │ │ │ -00031ad0: 746f 7074 696f 6e73 6461 7461 2028 5368  toptionsdata (Sh
│ │ │ │ -00031ae0: 6973 6869 5f61 7020 2a20 4150 2c0a 2020  ishi_ap * AP,.  
│ │ │ │ -00031af0: 2020 2020 2020 2020 5368 6973 6869 5f74          Shishi_t
│ │ │ │ -00031b00: 6b74 202a 2054 4b54 2c20 696e 7420 4f50  kt * TKT, int OP
│ │ │ │ -00031b10: 5449 4f4e 532c 2063 6f6e 7374 2063 6861  TIONS, const cha
│ │ │ │ -00031b20: 7220 2a20 4441 5441 2c20 7369 7a65 5f74  r * DATA, size_t
│ │ │ │ -00031b30: 204c 454e 290a 2020 2020 2041 503a 2073   LEN).     AP: s
│ │ │ │ -00031b40: 7472 7563 7475 7265 2074 6861 7420 686f  tructure that ho
│ │ │ │ -00031b50: 6c64 7320 696e 666f 726d 6174 696f 6e20  lds information 
│ │ │ │ -00031b60: 6162 6f75 7420 4150 2065 7863 6861 6e67  about AP exchang
│ │ │ │ -00031b70: 650a 2020 2020 2054 4b54 3a20 7469 636b  e.     TKT: tick
│ │ │ │ -00031b80: 6574 2074 6f20 7365 7420 696e 2041 502e  et to set in AP.
│ │ │ │ -00031b90: 0a20 2020 2020 4f50 5449 4f4e 533a 2041  .     OPTIONS: A
│ │ │ │ -00031ba0: 502d 5245 5120 6f70 7469 6f6e 7320 746f  P-REQ options to
│ │ │ │ -00031bb0: 2073 6574 2069 6e20 4150 2e0a 2020 2020   set in AP..    
│ │ │ │ -00031bc0: 2044 4154 413a 2069 6e70 7574 2061 7272   DATA: input arr
│ │ │ │ -00031bd0: 6179 2077 6974 6820 6461 7461 2074 6f20  ay with data to 
│ │ │ │ -00031be0: 6368 6563 6b73 756d 2069 6e20 4175 7468  checksum in Auth
│ │ │ │ -00031bf0: 656e 7469 6361 746f 722e 0a20 2020 2020  enticator..     
│ │ │ │ -00031c00: 4c45 4e3a 206c 656e 6774 6820 6f66 2069  LEN: length of i
│ │ │ │ -00031c10: 6e70 7574 2061 7272 6179 2077 6974 6820  nput array with 
│ │ │ │ -00031c20: 6461 7461 2074 6f20 6368 6563 6b73 756d  data to checksum
│ │ │ │ -00031c30: 2069 6e20 4175 7468 656e 7469 6361 746f   in Authenticato
│ │ │ │ -00031c40: 722e 0a0a 2020 2020 202a 4465 7363 7269  r...     *Descri
│ │ │ │ -00031c50: 7074 696f 6e3a 2a20 5365 7420 7468 6520  ption:* Set the 
│ │ │ │ -00031c60: 7469 636b 6574 2028 7365 6520 e280 9873  ticket (see ...s
│ │ │ │ -00031c70: 6869 7368 695f 6170 5f74 6b74 5f73 6574  hishi_ap_tkt_set
│ │ │ │ -00031c80: 2829 e280 9929 2061 6e64 2073 6574 0a20  ()...) and set. 
│ │ │ │ -00031c90: 2020 2020 7468 6520 4150 2d52 4551 2061      the AP-REQ a
│ │ │ │ -00031ca0: 706f 7074 696f 6e73 2028 7365 6520 e280  poptions (see ..
│ │ │ │ -00031cb0: 9873 6869 7368 695f 6170 7265 715f 6f70  .shishi_apreq_op
│ │ │ │ -00031cc0: 7469 6f6e 735f 7365 7428 29e2 8099 2920  tions_set()...) 
│ │ │ │ -00031cd0: 616e 6420 7365 7420 7468 650a 2020 2020  and set the.    
│ │ │ │ -00031ce0: 2041 7574 6865 6e74 6963 6174 6f72 2063   Authenticator c
│ │ │ │ -00031cf0: 6865 636b 7375 6d20 6461 7461 2e0a 0a20  hecksum data... 
│ │ │ │ -00031d00: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ -00031d10: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ -00031d20: 4849 5f4f 4b20 6966 6620 7375 6363 6573  HI_OK iff succes
│ │ │ │ -00031d30: 7366 756c 2e0a 0a73 6869 7368 695f 6170  sful...shishi_ap
│ │ │ │ -00031d40: 5f73 6574 5f74 6b74 6f70 7469 6f6e 7372  _set_tktoptionsr
│ │ │ │ -00031d50: 6177 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  aw.-------------
│ │ │ │ -00031d60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -00031d70: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ -00031d80: 7420 7368 6973 6869 5f61 705f 7365 745f  t shishi_ap_set_
│ │ │ │ -00031d90: 746b 746f 7074 696f 6e73 7261 7720 2853  tktoptionsraw (S
│ │ │ │ -00031da0: 6869 7368 695f 6170 202a 2041 502c 0a20  hishi_ap * AP,. 
│ │ │ │ -00031db0: 2020 2020 2020 2020 2053 6869 7368 695f           Shishi_
│ │ │ │ -00031dc0: 746b 7420 2a20 544b 542c 2069 6e74 204f  tkt * TKT, int O
│ │ │ │ -00031dd0: 5054 494f 4e53 2c20 696e 7433 325f 7420  PTIONS, int32_t 
│ │ │ │ -00031de0: 434b 5355 4d54 5950 452c 0a20 2020 2020  CKSUMTYPE,.     
│ │ │ │ -00031df0: 2020 2020 2063 6f6e 7374 2063 6861 7220       const char 
│ │ │ │ -00031e00: 2a20 4441 5441 2c20 7369 7a65 5f74 204c  * DATA, size_t L
│ │ │ │ -00031e10: 454e 290a 2020 2020 2041 503a 2073 7472  EN).     AP: str
│ │ │ │ -00031e20: 7563 7475 7265 2074 6861 7420 686f 6c64  ucture that hold
│ │ │ │ -00031e30: 7320 696e 666f 726d 6174 696f 6e20 6162  s information ab
│ │ │ │ -00031e40: 6f75 7420 4150 2065 7863 6861 6e67 650a  out AP exchange.
│ │ │ │ -00031e50: 2020 2020 2054 4b54 3a20 7469 636b 6574       TKT: ticket
│ │ │ │ -00031e60: 2074 6f20 7365 7420 696e 2041 502e 0a20   to set in AP.. 
│ │ │ │ -00031e70: 2020 2020 4f50 5449 4f4e 533a 2041 502d      OPTIONS: AP-
│ │ │ │ -00031e80: 5245 5120 6f70 7469 6f6e 7320 746f 2073  REQ options to s
│ │ │ │ -00031e90: 6574 2069 6e20 4150 2e0a 2020 2020 2043  et in AP..     C
│ │ │ │ -00031ea0: 4b53 554d 5459 5045 3a20 6175 7468 656e  KSUMTYPE: authen
│ │ │ │ -00031eb0: 7469 6361 746f 7220 6368 6563 6b73 756d  ticator checksum
│ │ │ │ -00031ec0: 2074 7970 6520 746f 2073 6574 2069 6e20   type to set in 
│ │ │ │ -00031ed0: 4150 2e0a 2020 2020 2044 4154 413a 2069  AP..     DATA: i
│ │ │ │ -00031ee0: 6e70 7574 2061 7272 6179 2077 6974 6820  nput array with 
│ │ │ │ -00031ef0: 6461 7461 2074 6f20 7374 6f72 6520 696e  data to store in
│ │ │ │ -00031f00: 2063 6865 636b 7375 6d20 6669 656c 6420   checksum field 
│ │ │ │ -00031f10: 696e 0a20 2020 2020 4175 7468 656e 7469  in.     Authenti
│ │ │ │ -00031f20: 6361 746f 722e 0a20 2020 2020 4c45 4e3a  cator..     LEN:
│ │ │ │ -00031f30: 206c 656e 6774 6820 6f66 2069 6e70 7574   length of input
│ │ │ │ -00031f40: 2061 7272 6179 2077 6974 6820 6461 7461   array with data
│ │ │ │ -00031f50: 2074 6f20 7374 6f72 6520 696e 2063 6865   to store in che
│ │ │ │ -00031f60: 636b 7375 6d20 6669 656c 6420 696e 0a20  cksum field in. 
│ │ │ │ -00031f70: 2020 2020 4175 7468 656e 7469 6361 746f      Authenticato
│ │ │ │ -00031f80: 722e 0a0a 2020 2020 202a 4465 7363 7269  r...     *Descri
│ │ │ │ -00031f90: 7074 696f 6e3a 2a20 5365 7420 7468 6520  ption:* Set the 
│ │ │ │ -00031fa0: 7469 636b 6574 2028 7365 6520 e280 9873  ticket (see ...s
│ │ │ │ -00031fb0: 6869 7368 695f 6170 5f74 6b74 5f73 6574  hishi_ap_tkt_set
│ │ │ │ -00031fc0: 2829 e280 9929 2061 6e64 2073 6574 0a20  ()...) and set. 
│ │ │ │ -00031fd0: 2020 2020 7468 6520 4150 2d52 4551 2061      the AP-REQ a
│ │ │ │ -00031fe0: 706f 7074 696f 6e73 2028 7365 6520 e280  poptions (see ..
│ │ │ │ -00031ff0: 9873 6869 7368 695f 6170 7265 715f 6f70  .shishi_apreq_op
│ │ │ │ -00032000: 7469 6f6e 735f 7365 7428 29e2 8099 2920  tions_set()...) 
│ │ │ │ -00032010: 616e 6420 7365 7420 7468 650a 2020 2020  and set the.    
│ │ │ │ -00032020: 2072 6177 2041 7574 6865 6e74 6963 6174   raw Authenticat
│ │ │ │ -00032030: 6f72 2063 6865 636b 7375 6d20 6461 7461  or checksum data
│ │ │ │ -00032040: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ -00032050: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ -00032060: 5348 4953 4849 5f4f 4b20 6966 6620 7375  SHISHI_OK iff su
│ │ │ │ -00032070: 6363 6573 7366 756c 2e0a 0a73 6869 7368  ccessful...shish
│ │ │ │ -00032080: 695f 6170 5f73 6574 5f74 6b74 6f70 7469  i_ap_set_tktopti
│ │ │ │ -00032090: 6f6e 7361 736e 3175 7361 6765 0a2d 2d2d  onsasn1usage.---
│ │ │ │ +00030a20: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +00030a30: 756e 6374 696f 6e3a 2053 6869 7368 695f  unction: Shishi_
│ │ │ │ +00030a40: 746b 7420 2a20 7368 6973 6869 5f74 6b74  tkt * shishi_tkt
│ │ │ │ +00030a50: 735f 6765 745f 666f 725f 6c6f 6361 6c73  s_get_for_locals
│ │ │ │ +00030a60: 6572 7669 6365 7061 7373 7764 0a20 2020  ervicepasswd.   
│ │ │ │ +00030a70: 2020 2020 2020 2028 5368 6973 6869 5f74         (Shishi_t
│ │ │ │ +00030a80: 6b74 7320 2a20 544b 5453 2c20 636f 6e73  kts * TKTS, cons
│ │ │ │ +00030a90: 7420 6368 6172 202a 2053 4552 5649 4345  t char * SERVICE
│ │ │ │ +00030aa0: 2c0a 2020 2020 2020 2020 2020 636f 6e73  ,.          cons
│ │ │ │ +00030ab0: 7420 6368 6172 202a 2050 4153 5357 4429  t char * PASSWD)
│ │ │ │ +00030ac0: 0a20 2020 2020 544b 5453 3a20 7469 636b  .     TKTS: tick
│ │ │ │ +00030ad0: 6574 2073 6574 2068 616e 646c 6520 6173  et set handle as
│ │ │ │ +00030ae0: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ +00030af0: 9873 6869 7368 695f 746b 7473 2829 e280  .shishi_tkts()..
│ │ │ │ +00030b00: 992e 0a20 2020 2020 5345 5256 4943 453a  ...     SERVICE:
│ │ │ │ +00030b10: 2073 6572 7669 6365 206e 616d 6520 746f   service name to
│ │ │ │ +00030b20: 2067 6574 2074 6963 6b65 7420 666f 722e   get ticket for.
│ │ │ │ +00030b30: 0a20 2020 2020 5041 5353 5744 3a20 7061  .     PASSWD: pa
│ │ │ │ +00030b40: 7373 776f 7264 2066 6f72 2074 6865 2064  ssword for the d
│ │ │ │ +00030b50: 6566 6175 6c74 2063 6c69 656e 7420 7072  efault client pr
│ │ │ │ +00030b60: 696e 6369 7061 6c2e 0a0a 2020 2020 202a  incipal...     *
│ │ │ │ +00030b70: 4465 7363 7269 7074 696f 6e3a 2a20 5368  Description:* Sh
│ │ │ │ +00030b80: 6f72 742d 6861 6e64 2066 756e 6374 696f  ort-hand functio
│ │ │ │ +00030b90: 6e20 666f 7220 6765 7474 696e 6720 6120  n for getting a 
│ │ │ │ +00030ba0: 7469 636b 6574 2074 6f20 7468 650a 2020  ticket to the.  
│ │ │ │ +00030bb0: 2020 2067 6976 656e 206c 6f63 616c 2073     given local s
│ │ │ │ +00030bc0: 6572 7669 6365 2c20 616e 6420 666f 7220  ervice, and for 
│ │ │ │ +00030bd0: 7468 6520 6465 6661 756c 7420 7072 696e  the default prin
│ │ │ │ +00030be0: 6369 7061 6c20 636c 6965 6e74 2e20 2054  cipal client.  T
│ │ │ │ +00030bf0: 6865 0a20 2020 2020 6c61 7474 6572 2773  he.     latter's
│ │ │ │ +00030c00: 2070 6173 7377 6f72 6420 6973 2067 6976   password is giv
│ │ │ │ +00030c10: 656e 2061 7320 6172 6775 6d65 6e74 2e20  en as argument. 
│ │ │ │ +00030c20: 2053 6565 20e2 8098 7368 6973 6869 5f74   See ...shishi_t
│ │ │ │ +00030c30: 6b74 735f 6765 7428 29e2 8099 2e0a 0a20  kts_get()...... 
│ │ │ │ +00030c40: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ +00030c50: 653a 2a20 5265 7475 726e 7320 6120 7469  e:* Returns a ti
│ │ │ │ +00030c60: 636b 6574 2069 6620 666f 756e 642c 206f  cket if found, o
│ │ │ │ +00030c70: 7220 4e55 4c4c 206f 7468 6572 7769 7365  r NULL otherwise
│ │ │ │ +00030c80: 2e0a 0a1f 0a46 696c 653a 2073 6869 7368  .....File: shish
│ │ │ │ +00030c90: 692e 696e 666f 2c20 204e 6f64 653a 2041  i.info,  Node: A
│ │ │ │ +00030ca0: 502d 5245 5120 616e 6420 4150 2d52 4550  P-REQ and AP-REP
│ │ │ │ +00030cb0: 2046 756e 6374 696f 6e73 2c20 204e 6578   Functions,  Nex
│ │ │ │ +00030cc0: 743a 2053 4146 4520 616e 6420 5052 4956  t: SAFE and PRIV
│ │ │ │ +00030cd0: 2046 756e 6374 696f 6e73 2c20 2050 7265   Functions,  Pre
│ │ │ │ +00030ce0: 763a 2054 6963 6b65 7420 5365 7420 4675  v: Ticket Set Fu
│ │ │ │ +00030cf0: 6e63 7469 6f6e 732c 2020 5570 3a20 5072  nctions,  Up: Pr
│ │ │ │ +00030d00: 6f67 7261 6d6d 696e 6720 4d61 6e75 616c  ogramming Manual
│ │ │ │ +00030d10: 0a0a 352e 3420 4150 2d52 4551 2061 6e64  ..5.4 AP-REQ and
│ │ │ │ +00030d20: 2041 502d 5245 5020 4675 6e63 7469 6f6e   AP-REP Function
│ │ │ │ +00030d30: 730a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  s.==============
│ │ │ │ +00030d40: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ +00030d50: 3d0a 0a54 6865 2022 4150 2d52 4551 2220  =..The "AP-REQ" 
│ │ │ │ +00030d60: 616e 6420 2241 502d 5245 5022 2061 7265  and "AP-REP" are
│ │ │ │ +00030d70: 2041 534e 2e31 2073 7472 7563 7475 7265   ASN.1 structure
│ │ │ │ +00030d80: 7320 7573 6564 2062 7920 6170 706c 6963  s used by applic
│ │ │ │ +00030d90: 6174 696f 6e0a 636c 6965 6e74 2061 6e64  ation.client and
│ │ │ │ +00030da0: 2073 6572 7665 7273 2074 6f20 7072 6f76   servers to prov
│ │ │ │ +00030db0: 6520 746f 2065 6163 6820 6f74 6865 7220  e to each other 
│ │ │ │ +00030dc0: 7768 6f20 7468 6579 2061 7265 2e20 2054  who they are.  T
│ │ │ │ +00030dd0: 6865 2073 7472 7563 7475 7265 730a 636f  he structures.co
│ │ │ │ +00030de0: 6e74 6169 6e20 6175 7869 6c6c 6961 7279  ntain auxilliary
│ │ │ │ +00030df0: 2069 6e66 6f72 6d61 7469 6f6e 2c20 746f   information, to
│ │ │ │ +00030e00: 6765 7468 6572 2077 6974 6820 616e 2061  gether with an a
│ │ │ │ +00030e10: 7574 6865 6e74 6963 6174 6f72 2028 2a6e  uthenticator (*n
│ │ │ │ +00030e20: 6f74 650a 4175 7468 656e 7469 6361 746f  ote.Authenticato
│ │ │ │ +00030e30: 7220 4675 6e63 7469 6f6e 733a 3a29 2077  r Functions::) w
│ │ │ │ +00030e40: 6869 6368 2069 7320 7468 6520 7265 616c  hich is the real
│ │ │ │ +00030e50: 2063 7279 7074 6f67 7261 7068 6963 2070   cryptographic p
│ │ │ │ +00030e60: 726f 6f66 2e20 2054 6865 0a66 6f6c 6c6f  roof.  The.follo
│ │ │ │ +00030e70: 7769 6e67 2069 6c6c 7573 7472 6174 6573  wing illustrates
│ │ │ │ +00030e80: 2074 6865 2041 502d 5245 5120 616e 6420   the AP-REQ and 
│ │ │ │ +00030e90: 4150 2d52 4550 2041 534e 2e31 2073 7472  AP-REP ASN.1 str
│ │ │ │ +00030ea0: 7563 7475 7265 732e 0a0a 4150 2d52 4551  uctures...AP-REQ
│ │ │ │ +00030eb0: 0909 3a3a 3d20 5b41 5050 4c49 4341 5449  ..::= [APPLICATI
│ │ │ │ +00030ec0: 4f4e 2031 345d 2053 4551 5545 4e43 4520  ON 14] SEQUENCE 
│ │ │ │ +00030ed0: 7b0a 0970 766e 6f09 095b 305d 2049 4e54  {..pvno..[0] INT
│ │ │ │ +00030ee0: 4547 4552 2028 3529 2c0a 096d 7367 2d74  EGER (5),..msg-t
│ │ │ │ +00030ef0: 7970 6509 5b31 5d20 494e 5445 4745 5220  ype.[1] INTEGER 
│ │ │ │ +00030f00: 2831 3429 2c0a 0961 702d 6f70 7469 6f6e  (14),..ap-option
│ │ │ │ +00030f10: 7309 5b32 5d20 4150 4f70 7469 6f6e 732c  s.[2] APOptions,
│ │ │ │ +00030f20: 0a09 7469 636b 6574 0909 5b33 5d20 5469  ..ticket..[3] Ti
│ │ │ │ +00030f30: 636b 6574 2c0a 0961 7574 6865 6e74 6963  cket,..authentic
│ │ │ │ +00030f40: 6174 6f72 095b 345d 2045 6e63 7279 7074  ator.[4] Encrypt
│ │ │ │ +00030f50: 6564 4461 7461 207b 4175 7468 656e 7469  edData {Authenti
│ │ │ │ +00030f60: 6361 746f 722c 0a09 0909 097b 206b 6579  cator,.....{ key
│ │ │ │ +00030f70: 7573 652d 7061 2d54 4753 5265 712d 6175  use-pa-TGSReq-au
│ │ │ │ +00030f80: 7468 656e 7469 6361 746f 720a 0909 0909  thenticator.....
│ │ │ │ +00030f90: 2020 7c20 6b65 7975 7365 2d41 5052 6571    | keyuse-APReq
│ │ │ │ +00030fa0: 2d61 7574 6865 6e74 6963 6174 6f72 207d  -authenticator }
│ │ │ │ +00030fb0: 7d0a 7d0a 0a41 502d 5245 5009 093a 3a3d  }.}..AP-REP..::=
│ │ │ │ +00030fc0: 205b 4150 504c 4943 4154 494f 4e20 3135   [APPLICATION 15
│ │ │ │ +00030fd0: 5d20 5345 5155 454e 4345 207b 0a09 7076  ] SEQUENCE {..pv
│ │ │ │ +00030fe0: 6e6f 0909 5b30 5d20 494e 5445 4745 5220  no..[0] INTEGER 
│ │ │ │ +00030ff0: 2835 292c 0a09 6d73 672d 7479 7065 095b  (5),..msg-type.[
│ │ │ │ +00031000: 315d 2049 4e54 4547 4552 2028 3135 292c  1] INTEGER (15),
│ │ │ │ +00031010: 0a09 656e 632d 7061 7274 095b 325d 2045  ..enc-part.[2] E
│ │ │ │ +00031020: 6e63 7279 7074 6564 4461 7461 207b 456e  ncryptedData {En
│ │ │ │ +00031030: 6341 5052 6570 5061 7274 2c0a 0909 0909  cAPRepPart,.....
│ │ │ │ +00031040: 7b20 6b65 7975 7365 2d45 6e63 4150 5265  { keyuse-EncAPRe
│ │ │ │ +00031050: 7050 6172 7420 7d7d 0a7d 0a0a 456e 6341  pPart }}.}..EncA
│ │ │ │ +00031060: 5052 6570 5061 7274 093a 3a3d 205b 4150  PRepPart.::= [AP
│ │ │ │ +00031070: 504c 4943 4154 494f 4e20 3237 5d20 5345  PLICATION 27] SE
│ │ │ │ +00031080: 5155 454e 4345 207b 0a09 6374 696d 6509  QUENCE {..ctime.
│ │ │ │ +00031090: 095b 305d 204b 6572 6265 726f 7354 696d  .[0] KerberosTim
│ │ │ │ +000310a0: 652c 0a09 6375 7365 6309 095b 315d 204d  e,..cusec..[1] M
│ │ │ │ +000310b0: 6963 726f 7365 636f 6e64 732c 0a09 7375  icroseconds,..su
│ │ │ │ +000310c0: 626b 6579 0909 5b32 5d20 456e 6372 7970  bkey..[2] Encryp
│ │ │ │ +000310d0: 7469 6f6e 4b65 7920 4f50 5449 4f4e 414c  tionKey OPTIONAL
│ │ │ │ +000310e0: 2c0a 0973 6571 2d6e 756d 6265 7209 5b33  ,..seq-number.[3
│ │ │ │ +000310f0: 5d20 5549 6e74 3332 204f 5054 494f 4e41  ] UInt32 OPTIONA
│ │ │ │ +00031100: 4c0a 7d0a 0a73 6869 7368 695f 6170 0a2d  L.}..shishi_ap.-
│ │ │ │ +00031110: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ +00031120: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ +00031130: 6869 5f61 7020 2853 6869 7368 6920 2a20  hi_ap (Shishi * 
│ │ │ │ +00031140: 4841 4e44 4c45 2c20 5368 6973 6869 5f61  HANDLE, Shishi_a
│ │ │ │ +00031150: 7020 2a2a 2041 5029 0a20 2020 2020 4841  p ** AP).     HA
│ │ │ │ +00031160: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ +00031170: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ +00031180: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ +00031190: 6974 2829 e280 992e 0a20 2020 2020 4150  it().....     AP
│ │ │ │ +000311a0: 3a20 706f 696e 7465 7220 746f 206e 6577  : pointer to new
│ │ │ │ +000311b0: 2073 7472 7563 7475 7265 2074 6861 7420   structure that 
│ │ │ │ +000311c0: 686f 6c64 7320 696e 666f 726d 6174 696f  holds informatio
│ │ │ │ +000311d0: 6e20 6162 6f75 7420 4150 0a20 2020 2020  n about AP.     
│ │ │ │ +000311e0: 6578 6368 616e 6765 0a0a 2020 2020 202a  exchange..     *
│ │ │ │ +000311f0: 4465 7363 7269 7074 696f 6e3a 2a20 4372  Description:* Cr
│ │ │ │ +00031200: 6561 7465 2061 206e 6577 2041 5020 6578  eate a new AP ex
│ │ │ │ +00031210: 6368 616e 6765 2077 6974 6820 6120 7261  change with a ra
│ │ │ │ +00031220: 6e64 6f6d 2073 7562 6b65 7920 6f66 2074  ndom subkey of t
│ │ │ │ +00031230: 6865 0a20 2020 2020 6465 6661 756c 7420  he.     default 
│ │ │ │ +00031240: 656e 6372 7970 7469 6f6e 2074 7970 6520  encryption type 
│ │ │ │ +00031250: 6672 6f6d 2063 6f6e 6669 6775 7261 7469  from configurati
│ │ │ │ +00031260: 6f6e 2e20 204e 6f74 6520 7468 6174 2074  on.  Note that t
│ │ │ │ +00031270: 6865 7265 2069 7320 6e6f 0a20 2020 2020  here is no.     
│ │ │ │ +00031280: 6775 6172 616e 7465 6520 7468 6174 2074  guarantee that t
│ │ │ │ +00031290: 6865 2072 6563 6569 7665 7220 7769 6c6c  he receiver will
│ │ │ │ +000312a0: 2075 6e64 6572 7374 616e 6420 7468 6174   understand that
│ │ │ │ +000312b0: 206b 6579 2074 7970 652c 2079 6f75 0a20   key type, you. 
│ │ │ │ +000312c0: 2020 2020 7368 6f75 6c64 2070 726f 6261      should proba
│ │ │ │ +000312d0: 626c 7920 7573 6520 e280 9873 6869 7368  bly use ...shish
│ │ │ │ +000312e0: 695f 6170 5f65 7479 7065 2829 e280 9920  i_ap_etype()... 
│ │ │ │ +000312f0: 6f72 20e2 8098 7368 6973 6869 5f61 705f  or ...shishi_ap_
│ │ │ │ +00031300: 6e6f 7375 626b 6579 2829 e280 990a 2020  nosubkey()....  
│ │ │ │ +00031310: 2020 2069 6e73 7465 6164 2e20 2049 6e20     instead.  In 
│ │ │ │ +00031320: 7468 6520 6675 7475 7265 2c20 7468 6973  the future, this
│ │ │ │ +00031330: 2066 756e 6374 696f 6e20 7769 6c6c 206c   function will l
│ │ │ │ +00031340: 696b 656c 7920 6265 6861 7665 2061 730a  ikely behave as.
│ │ │ │ +00031350: 2020 2020 20e2 8098 7368 6973 6869 5f61       ...shishi_a
│ │ │ │ +00031360: 705f 6e6f 7375 626b 6579 2829 e280 9920  p_nosubkey()... 
│ │ │ │ +00031370: 616e 6420 e280 9873 6869 7368 695f 6170  and ...shishi_ap
│ │ │ │ +00031380: 5f6e 6f73 7562 6b65 7928 29e2 8099 2077  _nosubkey()... w
│ │ │ │ +00031390: 696c 6c20 6265 2072 656d 6f76 6564 2e0a  ill be removed..
│ │ │ │ +000313a0: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ +000313b0: 6c75 653a 2a20 5265 7475 726e 7320 5348  lue:* Returns SH
│ │ │ │ +000313c0: 4953 4849 5f4f 4b20 6966 6620 7375 6363  ISHI_OK iff succ
│ │ │ │ +000313d0: 6573 7366 756c 2e0a 0a73 6869 7368 695f  essful...shishi_
│ │ │ │ +000313e0: 6170 5f65 7479 7065 0a2d 2d2d 2d2d 2d2d  ap_etype.-------
│ │ │ │ +000313f0: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ +00031400: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ +00031410: 6869 5f61 705f 6574 7970 6520 2853 6869  hi_ap_etype (Shi
│ │ │ │ +00031420: 7368 6920 2a20 4841 4e44 4c45 2c20 5368  shi * HANDLE, Sh
│ │ │ │ +00031430: 6973 6869 5f61 7020 2a2a 2041 502c 0a20  ishi_ap ** AP,. 
│ │ │ │ +00031440: 2020 2020 2020 2020 2069 6e74 2045 5459           int ETY
│ │ │ │ +00031450: 5045 290a 2020 2020 2048 414e 444c 453a  PE).     HANDLE:
│ │ │ │ +00031460: 2073 6869 7368 6920 6861 6e64 6c65 2061   shishi handle a
│ │ │ │ +00031470: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ +00031480: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ +00031490: 8099 2e0a 2020 2020 2041 503a 2070 6f69  ....     AP: poi
│ │ │ │ +000314a0: 6e74 6572 2074 6f20 6e65 7720 7374 7275  nter to new stru
│ │ │ │ +000314b0: 6374 7572 6520 7468 6174 2068 6f6c 6473  cture that holds
│ │ │ │ +000314c0: 2069 6e66 6f72 6d61 7469 6f6e 2061 626f   information abo
│ │ │ │ +000314d0: 7574 2041 500a 2020 2020 2065 7863 6861  ut AP.     excha
│ │ │ │ +000314e0: 6e67 650a 2020 2020 2045 5459 5045 3a20  nge.     ETYPE: 
│ │ │ │ +000314f0: 656e 6372 7970 7469 6f6e 2074 7970 6520  encryption type 
│ │ │ │ +00031500: 6f66 206e 6577 6c79 2067 656e 6572 6174  of newly generat
│ │ │ │ +00031510: 6564 2072 616e 646f 6d20 7375 626b 6579  ed random subkey
│ │ │ │ +00031520: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ +00031530: 7469 6f6e 3a2a 2043 7265 6174 6520 6120  tion:* Create a 
│ │ │ │ +00031540: 6e65 7720 4150 2065 7863 6861 6e67 6520  new AP exchange 
│ │ │ │ +00031550: 7769 7468 2061 2072 616e 646f 6d20 7375  with a random su
│ │ │ │ +00031560: 626b 6579 206f 660a 2020 2020 2069 6e64  bkey of.     ind
│ │ │ │ +00031570: 6963 6174 6564 2065 6e63 7279 7074 696f  icated encryptio
│ │ │ │ +00031580: 6e20 7479 7065 2e0a 0a20 2020 2020 2a52  n type...     *R
│ │ │ │ +00031590: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +000315a0: 7475 726e 7320 5348 4953 4849 5f4f 4b20  turns SHISHI_OK 
│ │ │ │ +000315b0: 6966 6620 7375 6363 6573 7366 756c 2e0a  iff successful..
│ │ │ │ +000315c0: 0a73 6869 7368 695f 6170 5f6e 6f73 7562  .shishi_ap_nosub
│ │ │ │ +000315d0: 6b65 790a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  key.------------
│ │ │ │ +000315e0: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ +000315f0: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ +00031600: 5f61 705f 6e6f 7375 626b 6579 2028 5368  _ap_nosubkey (Sh
│ │ │ │ +00031610: 6973 6869 202a 2048 414e 444c 452c 2053  ishi * HANDLE, S
│ │ │ │ +00031620: 6869 7368 695f 6170 202a 2a20 4150 290a  hishi_ap ** AP).
│ │ │ │ +00031630: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ +00031640: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ +00031650: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ +00031660: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ +00031670: 2020 2020 2041 503a 2070 6f69 6e74 6572       AP: pointer
│ │ │ │ +00031680: 2074 6f20 6e65 7720 7374 7275 6374 7572   to new structur
│ │ │ │ +00031690: 6520 7468 6174 2068 6f6c 6473 2069 6e66  e that holds inf
│ │ │ │ +000316a0: 6f72 6d61 7469 6f6e 2061 626f 7574 2041  ormation about A
│ │ │ │ +000316b0: 500a 2020 2020 2065 7863 6861 6e67 650a  P.     exchange.
│ │ │ │ +000316c0: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +000316d0: 6f6e 3a2a 2043 7265 6174 6520 6120 6e65  on:* Create a ne
│ │ │ │ +000316e0: 7720 4150 2065 7863 6861 6e67 6520 7769  w AP exchange wi
│ │ │ │ +000316f0: 7468 6f75 7420 7375 626b 6579 2069 6e0a  thout subkey in.
│ │ │ │ +00031700: 2020 2020 2061 7574 6865 6e74 6963 6174       authenticat
│ │ │ │ +00031710: 6f72 2e0a 0a20 2020 2020 2a52 6574 7572  or...     *Retur
│ │ │ │ +00031720: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ +00031730: 7320 5348 4953 4849 5f4f 4b20 6966 6620  s SHISHI_OK iff 
│ │ │ │ +00031740: 7375 6363 6573 7366 756c 2e0a 0a73 6869  successful...shi
│ │ │ │ +00031750: 7368 695f 6170 5f64 6f6e 650a 2d2d 2d2d  shi_ap_done.----
│ │ │ │ +00031760: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +00031770: 4675 6e63 7469 6f6e 3a20 766f 6964 2073  Function: void s
│ │ │ │ +00031780: 6869 7368 695f 6170 5f64 6f6e 6520 2853  hishi_ap_done (S
│ │ │ │ +00031790: 6869 7368 695f 6170 202a 2041 5029 0a20  hishi_ap * AP). 
│ │ │ │ +000317a0: 2020 2020 4150 3a20 7374 7275 6374 7572      AP: structur
│ │ │ │ +000317b0: 6520 7468 6174 2068 6f6c 6473 2069 6e66  e that holds inf
│ │ │ │ +000317c0: 6f72 6d61 7469 6f6e 2061 626f 7574 2041  ormation about A
│ │ │ │ +000317d0: 5020 6578 6368 616e 6765 0a0a 2020 2020  P exchange..    
│ │ │ │ +000317e0: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ +000317f0: 4465 616c 6c6f 6361 7465 2072 6573 6f75  Deallocate resou
│ │ │ │ +00031800: 7263 6573 2061 7373 6f63 6961 7465 6420  rces associated 
│ │ │ │ +00031810: 7769 7468 2041 5020 6578 6368 616e 6765  with AP exchange
│ │ │ │ +00031820: 2e0a 2020 2020 2054 6869 7320 7368 6f75  ..     This shou
│ │ │ │ +00031830: 6c64 2062 6520 6361 6c6c 6564 2062 7920  ld be called by 
│ │ │ │ +00031840: 7468 6520 6170 706c 6963 6174 696f 6e20  the application 
│ │ │ │ +00031850: 7768 656e 2069 7420 6e6f 206c 6f6e 6765  when it no longe
│ │ │ │ +00031860: 7220 6e65 6564 2074 6f0a 2020 2020 2075  r need to.     u
│ │ │ │ +00031870: 7469 6c69 7a65 2074 6865 2041 5020 6578  tilize the AP ex
│ │ │ │ +00031880: 6368 616e 6765 2068 616e 646c 652e 0a0a  change handle...
│ │ │ │ +00031890: 7368 6973 6869 5f61 705f 7365 745f 746b  shishi_ap_set_tk
│ │ │ │ +000318a0: 746f 7074 696f 6e73 0a2d 2d2d 2d2d 2d2d  toptions.-------
│ │ │ │ +000318b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +000318c0: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ +000318d0: 2069 6e74 2073 6869 7368 695f 6170 5f73   int shishi_ap_s
│ │ │ │ +000318e0: 6574 5f74 6b74 6f70 7469 6f6e 7320 2853  et_tktoptions (S
│ │ │ │ +000318f0: 6869 7368 695f 6170 202a 2041 502c 0a20  hishi_ap * AP,. 
│ │ │ │ +00031900: 2020 2020 2020 2020 2053 6869 7368 695f           Shishi_
│ │ │ │ +00031910: 746b 7420 2a20 544b 542c 2069 6e74 204f  tkt * TKT, int O
│ │ │ │ +00031920: 5054 494f 4e53 290a 2020 2020 2041 503a  PTIONS).     AP:
│ │ │ │ +00031930: 2073 7472 7563 7475 7265 2074 6861 7420   structure that 
│ │ │ │ +00031940: 686f 6c64 7320 696e 666f 726d 6174 696f  holds informatio
│ │ │ │ +00031950: 6e20 6162 6f75 7420 4150 2065 7863 6861  n about AP excha
│ │ │ │ +00031960: 6e67 650a 2020 2020 2054 4b54 3a20 7469  nge.     TKT: ti
│ │ │ │ +00031970: 636b 6574 2074 6f20 7365 7420 696e 2041  cket to set in A
│ │ │ │ +00031980: 502e 0a20 2020 2020 4f50 5449 4f4e 533a  P..     OPTIONS:
│ │ │ │ +00031990: 2041 502d 5245 5120 6f70 7469 6f6e 7320   AP-REQ options 
│ │ │ │ +000319a0: 746f 2073 6574 2069 6e20 4150 2e0a 0a20  to set in AP... 
│ │ │ │ +000319b0: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ +000319c0: 3a2a 2053 6574 2074 6865 2074 6963 6b65  :* Set the ticke
│ │ │ │ +000319d0: 7420 2873 6565 20e2 8098 7368 6973 6869  t (see ...shishi
│ │ │ │ +000319e0: 5f61 705f 746b 745f 7365 7428 29e2 8099  _ap_tkt_set()...
│ │ │ │ +000319f0: 2920 616e 6420 7365 740a 2020 2020 2074  ) and set.     t
│ │ │ │ +00031a00: 6865 2041 502d 5245 5120 6170 6f70 7469  he AP-REQ apopti
│ │ │ │ +00031a10: 6f6e 7320 2873 6565 20e2 8098 7368 6973  ons (see ...shis
│ │ │ │ +00031a20: 6869 5f61 7072 6571 5f6f 7074 696f 6e73  hi_apreq_options
│ │ │ │ +00031a30: 5f73 6574 2829 e280 9929 2e0a 0a20 2020  _set()...)...   
│ │ │ │ +00031a40: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ +00031a50: 2a20 5265 7475 726e 7320 5348 4953 4849  * Returns SHISHI
│ │ │ │ +00031a60: 5f4f 4b20 6966 6620 7375 6363 6573 7366  _OK iff successf
│ │ │ │ +00031a70: 756c 2e0a 0a73 6869 7368 695f 6170 5f73  ul...shishi_ap_s
│ │ │ │ +00031a80: 6574 5f74 6b74 6f70 7469 6f6e 7364 6174  et_tktoptionsdat
│ │ │ │ +00031a90: 610a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  a.--------------
│ │ │ │ +00031aa0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ +00031ab0: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ +00031ac0: 7420 7368 6973 6869 5f61 705f 7365 745f  t shishi_ap_set_
│ │ │ │ +00031ad0: 746b 746f 7074 696f 6e73 6461 7461 2028  tktoptionsdata (
│ │ │ │ +00031ae0: 5368 6973 6869 5f61 7020 2a20 4150 2c0a  Shishi_ap * AP,.
│ │ │ │ +00031af0: 2020 2020 2020 2020 2020 5368 6973 6869            Shishi
│ │ │ │ +00031b00: 5f74 6b74 202a 2054 4b54 2c20 696e 7420  _tkt * TKT, int 
│ │ │ │ +00031b10: 4f50 5449 4f4e 532c 2063 6f6e 7374 2063  OPTIONS, const c
│ │ │ │ +00031b20: 6861 7220 2a20 4441 5441 2c20 7369 7a65  har * DATA, size
│ │ │ │ +00031b30: 5f74 204c 454e 290a 2020 2020 2041 503a  _t LEN).     AP:
│ │ │ │ +00031b40: 2073 7472 7563 7475 7265 2074 6861 7420   structure that 
│ │ │ │ +00031b50: 686f 6c64 7320 696e 666f 726d 6174 696f  holds informatio
│ │ │ │ +00031b60: 6e20 6162 6f75 7420 4150 2065 7863 6861  n about AP excha
│ │ │ │ +00031b70: 6e67 650a 2020 2020 2054 4b54 3a20 7469  nge.     TKT: ti
│ │ │ │ +00031b80: 636b 6574 2074 6f20 7365 7420 696e 2041  cket to set in A
│ │ │ │ +00031b90: 502e 0a20 2020 2020 4f50 5449 4f4e 533a  P..     OPTIONS:
│ │ │ │ +00031ba0: 2041 502d 5245 5120 6f70 7469 6f6e 7320   AP-REQ options 
│ │ │ │ +00031bb0: 746f 2073 6574 2069 6e20 4150 2e0a 2020  to set in AP..  
│ │ │ │ +00031bc0: 2020 2044 4154 413a 2069 6e70 7574 2061     DATA: input a
│ │ │ │ +00031bd0: 7272 6179 2077 6974 6820 6461 7461 2074  rray with data t
│ │ │ │ +00031be0: 6f20 6368 6563 6b73 756d 2069 6e20 4175  o checksum in Au
│ │ │ │ +00031bf0: 7468 656e 7469 6361 746f 722e 0a20 2020  thenticator..   
│ │ │ │ +00031c00: 2020 4c45 4e3a 206c 656e 6774 6820 6f66    LEN: length of
│ │ │ │ +00031c10: 2069 6e70 7574 2061 7272 6179 2077 6974   input array wit
│ │ │ │ +00031c20: 6820 6461 7461 2074 6f20 6368 6563 6b73  h data to checks
│ │ │ │ +00031c30: 756d 2069 6e20 4175 7468 656e 7469 6361  um in Authentica
│ │ │ │ +00031c40: 746f 722e 0a0a 2020 2020 202a 4465 7363  tor...     *Desc
│ │ │ │ +00031c50: 7269 7074 696f 6e3a 2a20 5365 7420 7468  ription:* Set th
│ │ │ │ +00031c60: 6520 7469 636b 6574 2028 7365 6520 e280  e ticket (see ..
│ │ │ │ +00031c70: 9873 6869 7368 695f 6170 5f74 6b74 5f73  .shishi_ap_tkt_s
│ │ │ │ +00031c80: 6574 2829 e280 9929 2061 6e64 2073 6574  et()...) and set
│ │ │ │ +00031c90: 0a20 2020 2020 7468 6520 4150 2d52 4551  .     the AP-REQ
│ │ │ │ +00031ca0: 2061 706f 7074 696f 6e73 2028 7365 6520   apoptions (see 
│ │ │ │ +00031cb0: e280 9873 6869 7368 695f 6170 7265 715f  ...shishi_apreq_
│ │ │ │ +00031cc0: 6f70 7469 6f6e 735f 7365 7428 29e2 8099  options_set()...
│ │ │ │ +00031cd0: 2920 616e 6420 7365 7420 7468 650a 2020  ) and set the.  
│ │ │ │ +00031ce0: 2020 2041 7574 6865 6e74 6963 6174 6f72     Authenticator
│ │ │ │ +00031cf0: 2063 6865 636b 7375 6d20 6461 7461 2e0a   checksum data..
│ │ │ │ +00031d00: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ +00031d10: 6c75 653a 2a20 5265 7475 726e 7320 5348  lue:* Returns SH
│ │ │ │ +00031d20: 4953 4849 5f4f 4b20 6966 6620 7375 6363  ISHI_OK iff succ
│ │ │ │ +00031d30: 6573 7366 756c 2e0a 0a73 6869 7368 695f  essful...shishi_
│ │ │ │ +00031d40: 6170 5f73 6574 5f74 6b74 6f70 7469 6f6e  ap_set_tktoption
│ │ │ │ +00031d50: 7372 6177 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  sraw.-----------
│ │ │ │ +00031d60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +00031d70: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +00031d80: 696e 7420 7368 6973 6869 5f61 705f 7365  int shishi_ap_se
│ │ │ │ +00031d90: 745f 746b 746f 7074 696f 6e73 7261 7720  t_tktoptionsraw 
│ │ │ │ +00031da0: 2853 6869 7368 695f 6170 202a 2041 502c  (Shishi_ap * AP,
│ │ │ │ +00031db0: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ +00031dc0: 695f 746b 7420 2a20 544b 542c 2069 6e74  i_tkt * TKT, int
│ │ │ │ +00031dd0: 204f 5054 494f 4e53 2c20 696e 7433 325f   OPTIONS, int32_
│ │ │ │ +00031de0: 7420 434b 5355 4d54 5950 452c 0a20 2020  t CKSUMTYPE,.   
│ │ │ │ +00031df0: 2020 2020 2020 2063 6f6e 7374 2063 6861         const cha
│ │ │ │ +00031e00: 7220 2a20 4441 5441 2c20 7369 7a65 5f74  r * DATA, size_t
│ │ │ │ +00031e10: 204c 454e 290a 2020 2020 2041 503a 2073   LEN).     AP: s
│ │ │ │ +00031e20: 7472 7563 7475 7265 2074 6861 7420 686f  tructure that ho
│ │ │ │ +00031e30: 6c64 7320 696e 666f 726d 6174 696f 6e20  lds information 
│ │ │ │ +00031e40: 6162 6f75 7420 4150 2065 7863 6861 6e67  about AP exchang
│ │ │ │ +00031e50: 650a 2020 2020 2054 4b54 3a20 7469 636b  e.     TKT: tick
│ │ │ │ +00031e60: 6574 2074 6f20 7365 7420 696e 2041 502e  et to set in AP.
│ │ │ │ +00031e70: 0a20 2020 2020 4f50 5449 4f4e 533a 2041  .     OPTIONS: A
│ │ │ │ +00031e80: 502d 5245 5120 6f70 7469 6f6e 7320 746f  P-REQ options to
│ │ │ │ +00031e90: 2073 6574 2069 6e20 4150 2e0a 2020 2020   set in AP..    
│ │ │ │ +00031ea0: 2043 4b53 554d 5459 5045 3a20 6175 7468   CKSUMTYPE: auth
│ │ │ │ +00031eb0: 656e 7469 6361 746f 7220 6368 6563 6b73  enticator checks
│ │ │ │ +00031ec0: 756d 2074 7970 6520 746f 2073 6574 2069  um type to set i
│ │ │ │ +00031ed0: 6e20 4150 2e0a 2020 2020 2044 4154 413a  n AP..     DATA:
│ │ │ │ +00031ee0: 2069 6e70 7574 2061 7272 6179 2077 6974   input array wit
│ │ │ │ +00031ef0: 6820 6461 7461 2074 6f20 7374 6f72 6520  h data to store 
│ │ │ │ +00031f00: 696e 2063 6865 636b 7375 6d20 6669 656c  in checksum fiel
│ │ │ │ +00031f10: 6420 696e 0a20 2020 2020 4175 7468 656e  d in.     Authen
│ │ │ │ +00031f20: 7469 6361 746f 722e 0a20 2020 2020 4c45  ticator..     LE
│ │ │ │ +00031f30: 4e3a 206c 656e 6774 6820 6f66 2069 6e70  N: length of inp
│ │ │ │ +00031f40: 7574 2061 7272 6179 2077 6974 6820 6461  ut array with da
│ │ │ │ +00031f50: 7461 2074 6f20 7374 6f72 6520 696e 2063  ta to store in c
│ │ │ │ +00031f60: 6865 636b 7375 6d20 6669 656c 6420 696e  hecksum field in
│ │ │ │ +00031f70: 0a20 2020 2020 4175 7468 656e 7469 6361  .     Authentica
│ │ │ │ +00031f80: 746f 722e 0a0a 2020 2020 202a 4465 7363  tor...     *Desc
│ │ │ │ +00031f90: 7269 7074 696f 6e3a 2a20 5365 7420 7468  ription:* Set th
│ │ │ │ +00031fa0: 6520 7469 636b 6574 2028 7365 6520 e280  e ticket (see ..
│ │ │ │ +00031fb0: 9873 6869 7368 695f 6170 5f74 6b74 5f73  .shishi_ap_tkt_s
│ │ │ │ +00031fc0: 6574 2829 e280 9929 2061 6e64 2073 6574  et()...) and set
│ │ │ │ +00031fd0: 0a20 2020 2020 7468 6520 4150 2d52 4551  .     the AP-REQ
│ │ │ │ +00031fe0: 2061 706f 7074 696f 6e73 2028 7365 6520   apoptions (see 
│ │ │ │ +00031ff0: e280 9873 6869 7368 695f 6170 7265 715f  ...shishi_apreq_
│ │ │ │ +00032000: 6f70 7469 6f6e 735f 7365 7428 29e2 8099  options_set()...
│ │ │ │ +00032010: 2920 616e 6420 7365 7420 7468 650a 2020  ) and set the.  
│ │ │ │ +00032020: 2020 2072 6177 2041 7574 6865 6e74 6963     raw Authentic
│ │ │ │ +00032030: 6174 6f72 2063 6865 636b 7375 6d20 6461  ator checksum da
│ │ │ │ +00032040: 7461 2e0a 0a20 2020 2020 2a52 6574 7572  ta...     *Retur
│ │ │ │ +00032050: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ +00032060: 7320 5348 4953 4849 5f4f 4b20 6966 6620  s SHISHI_OK iff 
│ │ │ │ +00032070: 7375 6363 6573 7366 756c 2e0a 0a73 6869  successful...shi
│ │ │ │ +00032080: 7368 695f 6170 5f73 6574 5f74 6b74 6f70  shi_ap_set_tktop
│ │ │ │ +00032090: 7469 6f6e 7361 736e 3175 7361 6765 0a2d  tionsasn1usage.-
│ │ │ │  000320a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000320b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -000320c0: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ -000320d0: 7420 7368 6973 6869 5f61 705f 7365 745f  t shishi_ap_set_
│ │ │ │ -000320e0: 746b 746f 7074 696f 6e73 6173 6e31 7573  tktoptionsasn1us
│ │ │ │ -000320f0: 6167 6520 2853 6869 7368 695f 6170 202a  age (Shishi_ap *
│ │ │ │ -00032100: 2041 502c 0a20 2020 2020 2020 2020 2053   AP,.          S
│ │ │ │ -00032110: 6869 7368 695f 746b 7420 2a20 544b 542c  hishi_tkt * TKT,
│ │ │ │ -00032120: 2069 6e74 204f 5054 494f 4e53 2c20 5368   int OPTIONS, Sh
│ │ │ │ -00032130: 6973 6869 5f61 736e 3120 4e4f 4445 2c0a  ishi_asn1 NODE,.
│ │ │ │ -00032140: 2020 2020 2020 2020 2020 636f 6e73 7420            const 
│ │ │ │ -00032150: 6368 6172 202a 2046 4945 4c44 2c20 696e  char * FIELD, in
│ │ │ │ -00032160: 7420 4155 5448 454e 5449 4341 544f 5243  t AUTHENTICATORC
│ │ │ │ -00032170: 4b53 554d 4b45 5955 5341 4745 2c0a 2020  KSUMKEYUSAGE,.  
│ │ │ │ -00032180: 2020 2020 2020 2020 696e 7420 4155 5448          int AUTH
│ │ │ │ -00032190: 454e 5449 4341 544f 524b 4559 5553 4147  ENTICATORKEYUSAG
│ │ │ │ -000321a0: 4529 0a20 2020 2020 4150 3a20 7374 7275  E).     AP: stru
│ │ │ │ -000321b0: 6374 7572 6520 7468 6174 2068 6f6c 6473  cture that holds
│ │ │ │ -000321c0: 2069 6e66 6f72 6d61 7469 6f6e 2061 626f   information abo
│ │ │ │ -000321d0: 7574 2041 5020 6578 6368 616e 6765 0a20  ut AP exchange. 
│ │ │ │ -000321e0: 2020 2020 544b 543a 2074 6963 6b65 7420      TKT: ticket 
│ │ │ │ -000321f0: 746f 2073 6574 2069 6e20 4150 2e0a 2020  to set in AP..  
│ │ │ │ -00032200: 2020 204f 5054 494f 4e53 3a20 4150 2d52     OPTIONS: AP-R
│ │ │ │ -00032210: 4551 206f 7074 696f 6e73 2074 6f20 7365  EQ options to se
│ │ │ │ -00032220: 7420 696e 2041 502e 0a20 2020 2020 4e4f  t in AP..     NO
│ │ │ │ -00032230: 4445 3a20 696e 7075 7420 4153 4e2e 3120  DE: input ASN.1 
│ │ │ │ -00032240: 7374 7275 6374 7572 6520 746f 2073 746f  structure to sto
│ │ │ │ -00032250: 7265 2061 7320 6175 7468 656e 7469 6361  re as authentica
│ │ │ │ -00032260: 746f 7220 6368 6563 6b73 756d 0a20 2020  tor checksum.   
│ │ │ │ -00032270: 2020 6461 7461 2e0a 2020 2020 2046 4945    data..     FIE
│ │ │ │ -00032280: 4c44 3a20 6669 656c 6420 696e 2041 534e  LD: field in ASN
│ │ │ │ -00032290: 2e31 2073 7472 7563 7475 7265 2074 6f20  .1 structure to 
│ │ │ │ -000322a0: 7573 652e 0a20 2020 2020 4155 5448 454e  use..     AUTHEN
│ │ │ │ -000322b0: 5449 4341 544f 5243 4b53 554d 4b45 5955  TICATORCKSUMKEYU
│ │ │ │ -000322c0: 5341 4745 3a20 6b65 7920 7573 6167 6520  SAGE: key usage 
│ │ │ │ -000322d0: 666f 7220 6368 6563 6b73 756d 2069 6e0a  for checksum in.
│ │ │ │ -000322e0: 2020 2020 2061 7574 6865 6e74 6963 6174       authenticat
│ │ │ │ -000322f0: 6f72 2e0a 2020 2020 2041 5554 4845 4e54  or..     AUTHENT
│ │ │ │ -00032300: 4943 4154 4f52 4b45 5955 5341 4745 3a20  ICATORKEYUSAGE: 
│ │ │ │ -00032310: 6b65 7920 7573 6167 6520 666f 7220 6175  key usage for au
│ │ │ │ -00032320: 7468 656e 7469 6361 746f 722e 0a0a 2020  thenticator...  
│ │ │ │ -00032330: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ -00032340: 2a20 5365 7420 7469 636b 6574 2c20 6f70  * Set ticket, op
│ │ │ │ -00032350: 7469 6f6e 7320 616e 6420 6175 7468 656e  tions and authen
│ │ │ │ -00032360: 7469 6361 746f 7220 6368 6563 6b73 756d  ticator checksum
│ │ │ │ -00032370: 2064 6174 610a 2020 2020 2075 7369 6e67   data.     using
│ │ │ │ -00032380: 20e2 8098 7368 6973 6869 5f61 705f 7365   ...shishi_ap_se
│ │ │ │ -00032390: 745f 746b 746f 7074 696f 6e73 6461 7461  t_tktoptionsdata
│ │ │ │ -000323a0: 2829 e280 992e 2020 5468 6520 6175 7468  ()....  The auth
│ │ │ │ -000323b0: 656e 7469 6361 746f 7220 6368 6563 6b73  enticator checks
│ │ │ │ -000323c0: 756d 0a20 2020 2020 6461 7461 2069 7320  um.     data is 
│ │ │ │ -000323d0: 7468 6520 4445 5220 656e 636f 6469 6e67  the DER encoding
│ │ │ │ -000323e0: 206f 6620 7468 6520 4153 4e2e 3120 6669   of the ASN.1 fi
│ │ │ │ -000323f0: 656c 6420 7072 6f76 6964 6564 2e0a 0a20  eld provided... 
│ │ │ │ -00032400: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ -00032410: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ -00032420: 4849 5f4f 4b20 6966 6620 7375 6363 6573  HI_OK iff succes
│ │ │ │ -00032430: 7366 756c 2e0a 0a73 6869 7368 695f 6170  sful...shishi_ap
│ │ │ │ -00032440: 5f74 6b74 6f70 7469 6f6e 730a 2d2d 2d2d  _tktoptions.----
│ │ │ │ +000320b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +000320c0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +000320d0: 696e 7420 7368 6973 6869 5f61 705f 7365  int shishi_ap_se
│ │ │ │ +000320e0: 745f 746b 746f 7074 696f 6e73 6173 6e31  t_tktoptionsasn1
│ │ │ │ +000320f0: 7573 6167 6520 2853 6869 7368 695f 6170  usage (Shishi_ap
│ │ │ │ +00032100: 202a 2041 502c 0a20 2020 2020 2020 2020   * AP,.         
│ │ │ │ +00032110: 2053 6869 7368 695f 746b 7420 2a20 544b   Shishi_tkt * TK
│ │ │ │ +00032120: 542c 2069 6e74 204f 5054 494f 4e53 2c20  T, int OPTIONS, 
│ │ │ │ +00032130: 5368 6973 6869 5f61 736e 3120 4e4f 4445  Shishi_asn1 NODE
│ │ │ │ +00032140: 2c0a 2020 2020 2020 2020 2020 636f 6e73  ,.          cons
│ │ │ │ +00032150: 7420 6368 6172 202a 2046 4945 4c44 2c20  t char * FIELD, 
│ │ │ │ +00032160: 696e 7420 4155 5448 454e 5449 4341 544f  int AUTHENTICATO
│ │ │ │ +00032170: 5243 4b53 554d 4b45 5955 5341 4745 2c0a  RCKSUMKEYUSAGE,.
│ │ │ │ +00032180: 2020 2020 2020 2020 2020 696e 7420 4155            int AU
│ │ │ │ +00032190: 5448 454e 5449 4341 544f 524b 4559 5553  THENTICATORKEYUS
│ │ │ │ +000321a0: 4147 4529 0a20 2020 2020 4150 3a20 7374  AGE).     AP: st
│ │ │ │ +000321b0: 7275 6374 7572 6520 7468 6174 2068 6f6c  ructure that hol
│ │ │ │ +000321c0: 6473 2069 6e66 6f72 6d61 7469 6f6e 2061  ds information a
│ │ │ │ +000321d0: 626f 7574 2041 5020 6578 6368 616e 6765  bout AP exchange
│ │ │ │ +000321e0: 0a20 2020 2020 544b 543a 2074 6963 6b65  .     TKT: ticke
│ │ │ │ +000321f0: 7420 746f 2073 6574 2069 6e20 4150 2e0a  t to set in AP..
│ │ │ │ +00032200: 2020 2020 204f 5054 494f 4e53 3a20 4150       OPTIONS: AP
│ │ │ │ +00032210: 2d52 4551 206f 7074 696f 6e73 2074 6f20  -REQ options to 
│ │ │ │ +00032220: 7365 7420 696e 2041 502e 0a20 2020 2020  set in AP..     
│ │ │ │ +00032230: 4e4f 4445 3a20 696e 7075 7420 4153 4e2e  NODE: input ASN.
│ │ │ │ +00032240: 3120 7374 7275 6374 7572 6520 746f 2073  1 structure to s
│ │ │ │ +00032250: 746f 7265 2061 7320 6175 7468 656e 7469  tore as authenti
│ │ │ │ +00032260: 6361 746f 7220 6368 6563 6b73 756d 0a20  cator checksum. 
│ │ │ │ +00032270: 2020 2020 6461 7461 2e0a 2020 2020 2046      data..     F
│ │ │ │ +00032280: 4945 4c44 3a20 6669 656c 6420 696e 2041  IELD: field in A
│ │ │ │ +00032290: 534e 2e31 2073 7472 7563 7475 7265 2074  SN.1 structure t
│ │ │ │ +000322a0: 6f20 7573 652e 0a20 2020 2020 4155 5448  o use..     AUTH
│ │ │ │ +000322b0: 454e 5449 4341 544f 5243 4b53 554d 4b45  ENTICATORCKSUMKE
│ │ │ │ +000322c0: 5955 5341 4745 3a20 6b65 7920 7573 6167  YUSAGE: key usag
│ │ │ │ +000322d0: 6520 666f 7220 6368 6563 6b73 756d 2069  e for checksum i
│ │ │ │ +000322e0: 6e0a 2020 2020 2061 7574 6865 6e74 6963  n.     authentic
│ │ │ │ +000322f0: 6174 6f72 2e0a 2020 2020 2041 5554 4845  ator..     AUTHE
│ │ │ │ +00032300: 4e54 4943 4154 4f52 4b45 5955 5341 4745  NTICATORKEYUSAGE
│ │ │ │ +00032310: 3a20 6b65 7920 7573 6167 6520 666f 7220  : key usage for 
│ │ │ │ +00032320: 6175 7468 656e 7469 6361 746f 722e 0a0a  authenticator...
│ │ │ │ +00032330: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ +00032340: 6e3a 2a20 5365 7420 7469 636b 6574 2c20  n:* Set ticket, 
│ │ │ │ +00032350: 6f70 7469 6f6e 7320 616e 6420 6175 7468  options and auth
│ │ │ │ +00032360: 656e 7469 6361 746f 7220 6368 6563 6b73  enticator checks
│ │ │ │ +00032370: 756d 2064 6174 610a 2020 2020 2075 7369  um data.     usi
│ │ │ │ +00032380: 6e67 20e2 8098 7368 6973 6869 5f61 705f  ng ...shishi_ap_
│ │ │ │ +00032390: 7365 745f 746b 746f 7074 696f 6e73 6461  set_tktoptionsda
│ │ │ │ +000323a0: 7461 2829 e280 992e 2020 5468 6520 6175  ta()....  The au
│ │ │ │ +000323b0: 7468 656e 7469 6361 746f 7220 6368 6563  thenticator chec
│ │ │ │ +000323c0: 6b73 756d 0a20 2020 2020 6461 7461 2069  ksum.     data i
│ │ │ │ +000323d0: 7320 7468 6520 4445 5220 656e 636f 6469  s the DER encodi
│ │ │ │ +000323e0: 6e67 206f 6620 7468 6520 4153 4e2e 3120  ng of the ASN.1 
│ │ │ │ +000323f0: 6669 656c 6420 7072 6f76 6964 6564 2e0a  field provided..
│ │ │ │ +00032400: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ +00032410: 6c75 653a 2a20 5265 7475 726e 7320 5348  lue:* Returns SH
│ │ │ │ +00032420: 4953 4849 5f4f 4b20 6966 6620 7375 6363  ISHI_OK iff succ
│ │ │ │ +00032430: 6573 7366 756c 2e0a 0a73 6869 7368 695f  essful...shishi_
│ │ │ │ +00032440: 6170 5f74 6b74 6f70 7469 6f6e 730a 2d2d  ap_tktoptions.--
│ │ │ │  00032450: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00032460: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ -00032470: 696e 7420 7368 6973 6869 5f61 705f 746b  int shishi_ap_tk
│ │ │ │ -00032480: 746f 7074 696f 6e73 2028 5368 6973 6869  toptions (Shishi
│ │ │ │ -00032490: 202a 2048 414e 444c 452c 0a20 2020 2020   * HANDLE,.     
│ │ │ │ -000324a0: 2020 2020 2053 6869 7368 695f 6170 202a       Shishi_ap *
│ │ │ │ -000324b0: 2a20 4150 2c20 5368 6973 6869 5f74 6b74  * AP, Shishi_tkt
│ │ │ │ -000324c0: 202a 2054 4b54 2c20 696e 7420 4f50 5449   * TKT, int OPTI
│ │ │ │ -000324d0: 4f4e 5329 0a20 2020 2020 4841 4e44 4c45  ONS).     HANDLE
│ │ │ │ -000324e0: 3a20 7368 6973 6869 2068 616e 646c 6520  : shishi handle 
│ │ │ │ -000324f0: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ -00032500: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ -00032510: e280 992e 0a20 2020 2020 4150 3a20 706f  .....     AP: po
│ │ │ │ -00032520: 696e 7465 7220 746f 206e 6577 2073 7472  inter to new str
│ │ │ │ -00032530: 7563 7475 7265 2074 6861 7420 686f 6c64  ucture that hold
│ │ │ │ -00032540: 7320 696e 666f 726d 6174 696f 6e20 6162  s information ab
│ │ │ │ -00032550: 6f75 7420 4150 0a20 2020 2020 6578 6368  out AP.     exch
│ │ │ │ -00032560: 616e 6765 0a20 2020 2020 544b 543a 2074  ange.     TKT: t
│ │ │ │ -00032570: 6963 6b65 7420 746f 2073 6574 2069 6e20  icket to set in 
│ │ │ │ -00032580: 6e65 776c 7920 6372 6561 7465 6420 4150  newly created AP
│ │ │ │ -00032590: 2e0a 2020 2020 204f 5054 494f 4e53 3a20  ..     OPTIONS: 
│ │ │ │ -000325a0: 4150 2d52 4551 206f 7074 696f 6e73 2074  AP-REQ options t
│ │ │ │ -000325b0: 6f20 7365 7420 696e 206e 6577 6c79 2063  o set in newly c
│ │ │ │ -000325c0: 7265 6174 6564 2041 502e 0a0a 2020 2020  reated AP...    
│ │ │ │ -000325d0: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ -000325e0: 4372 6561 7465 2061 206e 6577 2041 5020  Create a new AP 
│ │ │ │ -000325f0: 6578 6368 616e 6765 2075 7369 6e67 20e2  exchange using .
│ │ │ │ -00032600: 8098 7368 6973 6869 5f61 7028 29e2 8099  ..shishi_ap()...
│ │ │ │ -00032610: 2c20 616e 640a 2020 2020 2073 6574 2074  , and.     set t
│ │ │ │ -00032620: 6865 2074 6963 6b65 7420 616e 6420 4150  he ticket and AP
│ │ │ │ -00032630: 2d52 4551 2061 706f 7074 696f 6e73 2075  -REQ apoptions u
│ │ │ │ -00032640: 7369 6e67 0a20 2020 2020 e280 9873 6869  sing.     ...shi
│ │ │ │ -00032650: 7368 695f 6170 5f73 6574 5f74 6b74 6f70  shi_ap_set_tktop
│ │ │ │ -00032660: 7469 6f6e 7328 29e2 8099 2e20 2041 2072  tions()....  A r
│ │ │ │ -00032670: 616e 646f 6d20 7365 7373 696f 6e20 6b65  andom session ke
│ │ │ │ -00032680: 7920 6973 2061 6464 6564 2074 6f20 7468  y is added to th
│ │ │ │ -00032690: 650a 2020 2020 2061 7574 6865 6e74 6963  e.     authentic
│ │ │ │ -000326a0: 6174 6f72 2c20 7573 696e 6720 7468 6520  ator, using the 
│ │ │ │ -000326b0: 7361 6d65 206b 6579 7479 7065 2061 7320  same keytype as 
│ │ │ │ -000326c0: 7468 6520 7469 636b 6574 2e0a 0a20 2020  the ticket...   
│ │ │ │ -000326d0: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ -000326e0: 2a20 5265 7475 726e 7320 5348 4953 4849  * Returns SHISHI
│ │ │ │ -000326f0: 5f4f 4b20 6966 6620 7375 6363 6573 7366  _OK iff successf
│ │ │ │ -00032700: 756c 2e0a 0a73 6869 7368 695f 6170 5f74  ul...shishi_ap_t
│ │ │ │ -00032710: 6b74 6f70 7469 6f6e 7364 6174 610a 2d2d  ktoptionsdata.--
│ │ │ │ +00032460: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ +00032470: 3a20 696e 7420 7368 6973 6869 5f61 705f  : int shishi_ap_
│ │ │ │ +00032480: 746b 746f 7074 696f 6e73 2028 5368 6973  tktoptions (Shis
│ │ │ │ +00032490: 6869 202a 2048 414e 444c 452c 0a20 2020  hi * HANDLE,.   
│ │ │ │ +000324a0: 2020 2020 2020 2053 6869 7368 695f 6170         Shishi_ap
│ │ │ │ +000324b0: 202a 2a20 4150 2c20 5368 6973 6869 5f74   ** AP, Shishi_t
│ │ │ │ +000324c0: 6b74 202a 2054 4b54 2c20 696e 7420 4f50  kt * TKT, int OP
│ │ │ │ +000324d0: 5449 4f4e 5329 0a20 2020 2020 4841 4e44  TIONS).     HAND
│ │ │ │ +000324e0: 4c45 3a20 7368 6973 6869 2068 616e 646c  LE: shishi handl
│ │ │ │ +000324f0: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ +00032500: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ +00032510: 2829 e280 992e 0a20 2020 2020 4150 3a20  ().....     AP: 
│ │ │ │ +00032520: 706f 696e 7465 7220 746f 206e 6577 2073  pointer to new s
│ │ │ │ +00032530: 7472 7563 7475 7265 2074 6861 7420 686f  tructure that ho
│ │ │ │ +00032540: 6c64 7320 696e 666f 726d 6174 696f 6e20  lds information 
│ │ │ │ +00032550: 6162 6f75 7420 4150 0a20 2020 2020 6578  about AP.     ex
│ │ │ │ +00032560: 6368 616e 6765 0a20 2020 2020 544b 543a  change.     TKT:
│ │ │ │ +00032570: 2074 6963 6b65 7420 746f 2073 6574 2069   ticket to set i
│ │ │ │ +00032580: 6e20 6e65 776c 7920 6372 6561 7465 6420  n newly created 
│ │ │ │ +00032590: 4150 2e0a 2020 2020 204f 5054 494f 4e53  AP..     OPTIONS
│ │ │ │ +000325a0: 3a20 4150 2d52 4551 206f 7074 696f 6e73  : AP-REQ options
│ │ │ │ +000325b0: 2074 6f20 7365 7420 696e 206e 6577 6c79   to set in newly
│ │ │ │ +000325c0: 2063 7265 6174 6564 2041 502e 0a0a 2020   created AP...  
│ │ │ │ +000325d0: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ +000325e0: 2a20 4372 6561 7465 2061 206e 6577 2041  * Create a new A
│ │ │ │ +000325f0: 5020 6578 6368 616e 6765 2075 7369 6e67  P exchange using
│ │ │ │ +00032600: 20e2 8098 7368 6973 6869 5f61 7028 29e2   ...shishi_ap().
│ │ │ │ +00032610: 8099 2c20 616e 640a 2020 2020 2073 6574  .., and.     set
│ │ │ │ +00032620: 2074 6865 2074 6963 6b65 7420 616e 6420   the ticket and 
│ │ │ │ +00032630: 4150 2d52 4551 2061 706f 7074 696f 6e73  AP-REQ apoptions
│ │ │ │ +00032640: 2075 7369 6e67 0a20 2020 2020 e280 9873   using.     ...s
│ │ │ │ +00032650: 6869 7368 695f 6170 5f73 6574 5f74 6b74  hishi_ap_set_tkt
│ │ │ │ +00032660: 6f70 7469 6f6e 7328 29e2 8099 2e20 2041  options()....  A
│ │ │ │ +00032670: 2072 616e 646f 6d20 7365 7373 696f 6e20   random session 
│ │ │ │ +00032680: 6b65 7920 6973 2061 6464 6564 2074 6f20  key is added to 
│ │ │ │ +00032690: 7468 650a 2020 2020 2061 7574 6865 6e74  the.     authent
│ │ │ │ +000326a0: 6963 6174 6f72 2c20 7573 696e 6720 7468  icator, using th
│ │ │ │ +000326b0: 6520 7361 6d65 206b 6579 7479 7065 2061  e same keytype a
│ │ │ │ +000326c0: 7320 7468 6520 7469 636b 6574 2e0a 0a20  s the ticket... 
│ │ │ │ +000326d0: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ +000326e0: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ +000326f0: 4849 5f4f 4b20 6966 6620 7375 6363 6573  HI_OK iff succes
│ │ │ │ +00032700: 7366 756c 2e0a 0a73 6869 7368 695f 6170  sful...shishi_ap
│ │ │ │ +00032710: 5f74 6b74 6f70 7469 6f6e 7364 6174 610a  _tktoptionsdata.
│ │ │ │  00032720: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00032730: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ -00032740: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ -00032750: 5f61 705f 746b 746f 7074 696f 6e73 6461  _ap_tktoptionsda
│ │ │ │ -00032760: 7461 2028 5368 6973 6869 202a 2048 414e  ta (Shishi * HAN
│ │ │ │ -00032770: 444c 452c 0a20 2020 2020 2020 2020 2053  DLE,.          S
│ │ │ │ -00032780: 6869 7368 695f 6170 202a 2a20 4150 2c20  hishi_ap ** AP, 
│ │ │ │ -00032790: 5368 6973 6869 5f74 6b74 202a 2054 4b54  Shishi_tkt * TKT
│ │ │ │ -000327a0: 2c20 696e 7420 4f50 5449 4f4e 532c 0a20  , int OPTIONS,. 
│ │ │ │ -000327b0: 2020 2020 2020 2020 2063 6f6e 7374 2063           const c
│ │ │ │ -000327c0: 6861 7220 2a20 4441 5441 2c20 7369 7a65  har * DATA, size
│ │ │ │ -000327d0: 5f74 204c 454e 290a 2020 2020 2048 414e  _t LEN).     HAN
│ │ │ │ -000327e0: 444c 453a 2073 6869 7368 6920 6861 6e64  DLE: shishi hand
│ │ │ │ -000327f0: 6c65 2061 7320 616c 6c6f 6361 7465 6420  le as allocated 
│ │ │ │ -00032800: 6279 20e2 8098 7368 6973 6869 5f69 6e69  by ...shishi_ini
│ │ │ │ -00032810: 7428 29e2 8099 2e0a 2020 2020 2041 503a  t().....     AP:
│ │ │ │ -00032820: 2070 6f69 6e74 6572 2074 6f20 6e65 7720   pointer to new 
│ │ │ │ -00032830: 7374 7275 6374 7572 6520 7468 6174 2068  structure that h
│ │ │ │ -00032840: 6f6c 6473 2069 6e66 6f72 6d61 7469 6f6e  olds information
│ │ │ │ -00032850: 2061 626f 7574 2041 500a 2020 2020 2065   about AP.     e
│ │ │ │ -00032860: 7863 6861 6e67 650a 2020 2020 2054 4b54  xchange.     TKT
│ │ │ │ -00032870: 3a20 7469 636b 6574 2074 6f20 7365 7420  : ticket to set 
│ │ │ │ -00032880: 696e 206e 6577 6c79 2063 7265 6174 6564  in newly created
│ │ │ │ -00032890: 2041 502e 0a20 2020 2020 4f50 5449 4f4e   AP..     OPTION
│ │ │ │ -000328a0: 533a 2041 502d 5245 5120 6f70 7469 6f6e  S: AP-REQ option
│ │ │ │ -000328b0: 7320 746f 2073 6574 2069 6e20 6e65 776c  s to set in newl
│ │ │ │ -000328c0: 7920 6372 6561 7465 6420 4150 2e0a 2020  y created AP..  
│ │ │ │ -000328d0: 2020 2044 4154 413a 2069 6e70 7574 2061     DATA: input a
│ │ │ │ -000328e0: 7272 6179 2077 6974 6820 6461 7461 2074  rray with data t
│ │ │ │ -000328f0: 6f20 6368 6563 6b73 756d 2069 6e20 4175  o checksum in Au
│ │ │ │ -00032900: 7468 656e 7469 6361 746f 722e 0a20 2020  thenticator..   
│ │ │ │ -00032910: 2020 4c45 4e3a 206c 656e 6774 6820 6f66    LEN: length of
│ │ │ │ -00032920: 2069 6e70 7574 2061 7272 6179 2077 6974   input array wit
│ │ │ │ -00032930: 6820 6461 7461 2074 6f20 6368 6563 6b73  h data to checks
│ │ │ │ -00032940: 756d 2069 6e20 4175 7468 656e 7469 6361  um in Authentica
│ │ │ │ -00032950: 746f 722e 0a0a 2020 2020 202a 4465 7363  tor...     *Desc
│ │ │ │ -00032960: 7269 7074 696f 6e3a 2a20 4372 6561 7465  ription:* Create
│ │ │ │ -00032970: 2061 206e 6577 2041 5020 6578 6368 616e   a new AP exchan
│ │ │ │ -00032980: 6765 2075 7369 6e67 20e2 8098 7368 6973  ge using ...shis
│ │ │ │ -00032990: 6869 5f61 7028 29e2 8099 2c20 616e 640a  hi_ap()..., and.
│ │ │ │ -000329a0: 2020 2020 2073 6574 2074 6865 2074 6963       set the tic
│ │ │ │ -000329b0: 6b65 742c 2041 502d 5245 5120 6170 6f70  ket, AP-REQ apop
│ │ │ │ -000329c0: 7469 6f6e 7320 616e 6420 7468 6520 4175  tions and the Au
│ │ │ │ -000329d0: 7468 656e 7469 6361 746f 7220 6368 6563  thenticator chec
│ │ │ │ -000329e0: 6b73 756d 0a20 2020 2020 6461 7461 2075  ksum.     data u
│ │ │ │ -000329f0: 7369 6e67 20e2 8098 7368 6973 6869 5f61  sing ...shishi_a
│ │ │ │ -00032a00: 705f 7365 745f 746b 746f 7074 696f 6e73  p_set_tktoptions
│ │ │ │ -00032a10: 6461 7461 2829 e280 992e 2020 4120 7261  data()....  A ra
│ │ │ │ -00032a20: 6e64 6f6d 2073 6573 7369 6f6e 206b 6579  ndom session key
│ │ │ │ -00032a30: 0a20 2020 2020 6973 2061 6464 6564 2074  .     is added t
│ │ │ │ -00032a40: 6f20 7468 6520 6175 7468 656e 7469 6361  o the authentica
│ │ │ │ -00032a50: 746f 722c 2075 7369 6e67 2074 6865 2073  tor, using the s
│ │ │ │ -00032a60: 616d 6520 6b65 7974 7970 6520 6173 2074  ame keytype as t
│ │ │ │ -00032a70: 6865 0a20 2020 2020 7469 636b 6574 2e0a  he.     ticket..
│ │ │ │ -00032a80: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ -00032a90: 6c75 653a 2a20 5265 7475 726e 7320 5348  lue:* Returns SH
│ │ │ │ -00032aa0: 4953 4849 5f4f 4b20 6966 6620 7375 6363  ISHI_OK iff succ
│ │ │ │ -00032ab0: 6573 7366 756c 2e0a 0a73 6869 7368 695f  essful...shishi_
│ │ │ │ -00032ac0: 6170 5f74 6b74 6f70 7469 6f6e 7372 6177  ap_tktoptionsraw
│ │ │ │ -00032ad0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ -00032ae0: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -00032af0: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ -00032b00: 6869 5f61 705f 746b 746f 7074 696f 6e73  hi_ap_tktoptions
│ │ │ │ -00032b10: 7261 7720 2853 6869 7368 6920 2a20 4841  raw (Shishi * HA
│ │ │ │ -00032b20: 4e44 4c45 2c0a 2020 2020 2020 2020 2020  NDLE,.          
│ │ │ │ -00032b30: 5368 6973 6869 5f61 7020 2a2a 2041 502c  Shishi_ap ** AP,
│ │ │ │ -00032b40: 2053 6869 7368 695f 746b 7420 2a20 544b   Shishi_tkt * TK
│ │ │ │ -00032b50: 542c 2069 6e74 204f 5054 494f 4e53 2c0a  T, int OPTIONS,.
│ │ │ │ -00032b60: 2020 2020 2020 2020 2020 696e 7433 325f            int32_
│ │ │ │ -00032b70: 7420 434b 5355 4d54 5950 452c 2063 6f6e  t CKSUMTYPE, con
│ │ │ │ -00032b80: 7374 2063 6861 7220 2a20 4441 5441 2c20  st char * DATA, 
│ │ │ │ -00032b90: 7369 7a65 5f74 204c 454e 290a 2020 2020  size_t LEN).    
│ │ │ │ -00032ba0: 2048 414e 444c 453a 2073 6869 7368 6920   HANDLE: shishi 
│ │ │ │ -00032bb0: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ -00032bc0: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ -00032bd0: 5f69 6e69 7428 29e2 8099 2e0a 2020 2020  _init().....    
│ │ │ │ -00032be0: 2041 503a 2070 6f69 6e74 6572 2074 6f20   AP: pointer to 
│ │ │ │ -00032bf0: 6e65 7720 7374 7275 6374 7572 6520 7468  new structure th
│ │ │ │ -00032c00: 6174 2068 6f6c 6473 2069 6e66 6f72 6d61  at holds informa
│ │ │ │ -00032c10: 7469 6f6e 2061 626f 7574 2041 500a 2020  tion about AP.  
│ │ │ │ -00032c20: 2020 2065 7863 6861 6e67 650a 2020 2020     exchange.    
│ │ │ │ -00032c30: 2054 4b54 3a20 7469 636b 6574 2074 6f20   TKT: ticket to 
│ │ │ │ -00032c40: 7365 7420 696e 206e 6577 6c79 2063 7265  set in newly cre
│ │ │ │ -00032c50: 6174 6564 2041 502e 0a20 2020 2020 4f50  ated AP..     OP
│ │ │ │ -00032c60: 5449 4f4e 533a 2041 502d 5245 5120 6f70  TIONS: AP-REQ op
│ │ │ │ -00032c70: 7469 6f6e 7320 746f 2073 6574 2069 6e20  tions to set in 
│ │ │ │ -00032c80: 6e65 776c 7920 6372 6561 7465 6420 4150  newly created AP
│ │ │ │ -00032c90: 2e0a 2020 2020 2043 4b53 554d 5459 5045  ..     CKSUMTYPE
│ │ │ │ -00032ca0: 3a20 6175 7468 656e 7469 6361 746f 7220  : authenticator 
│ │ │ │ -00032cb0: 6368 6563 6b73 756d 2074 7970 6520 746f  checksum type to
│ │ │ │ -00032cc0: 2073 6574 2069 6e20 4150 2e0a 2020 2020   set in AP..    
│ │ │ │ -00032cd0: 2044 4154 413a 2069 6e70 7574 2061 7272   DATA: input arr
│ │ │ │ -00032ce0: 6179 2077 6974 6820 6461 7461 2074 6f20  ay with data to 
│ │ │ │ -00032cf0: 7374 6f72 6520 696e 2063 6865 636b 7375  store in checksu
│ │ │ │ -00032d00: 6d20 6669 656c 6420 696e 0a20 2020 2020  m field in.     
│ │ │ │ -00032d10: 4175 7468 656e 7469 6361 746f 722e 0a20  Authenticator.. 
│ │ │ │ -00032d20: 2020 2020 4c45 4e3a 206c 656e 6774 6820      LEN: length 
│ │ │ │ -00032d30: 6f66 2069 6e70 7574 2061 7272 6179 2077  of input array w
│ │ │ │ -00032d40: 6974 6820 6461 7461 2074 6f20 7374 6f72  ith data to stor
│ │ │ │ -00032d50: 6520 696e 2063 6865 636b 7375 6d20 6669  e in checksum fi
│ │ │ │ -00032d60: 656c 6420 696e 0a20 2020 2020 4175 7468  eld in.     Auth
│ │ │ │ -00032d70: 656e 7469 6361 746f 722e 0a0a 2020 2020  enticator...    
│ │ │ │ -00032d80: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ -00032d90: 4372 6561 7465 2061 206e 6577 2041 5020  Create a new AP 
│ │ │ │ -00032da0: 6578 6368 616e 6765 2075 7369 6e67 20e2  exchange using .
│ │ │ │ -00032db0: 8098 7368 6973 6869 5f61 7028 29e2 8099  ..shishi_ap()...
│ │ │ │ -00032dc0: 2c20 616e 640a 2020 2020 2073 6574 2074  , and.     set t
│ │ │ │ -00032dd0: 6865 2074 6963 6b65 742c 2041 502d 5245  he ticket, AP-RE
│ │ │ │ -00032de0: 5120 6170 6f70 7469 6f6e 7320 616e 6420  Q apoptions and 
│ │ │ │ -00032df0: 7468 6520 7261 7720 4175 7468 656e 7469  the raw Authenti
│ │ │ │ -00032e00: 6361 746f 7220 6368 6563 6b73 756d 0a20  cator checksum. 
│ │ │ │ -00032e10: 2020 2020 6461 7461 2066 6965 6c64 2075      data field u
│ │ │ │ -00032e20: 7369 6e67 20e2 8098 7368 6973 6869 5f61  sing ...shishi_a
│ │ │ │ -00032e30: 705f 7365 745f 746b 746f 7074 696f 6e73  p_set_tktoptions
│ │ │ │ -00032e40: 7261 7728 29e2 8099 2e20 2041 2072 616e  raw()....  A ran
│ │ │ │ -00032e50: 646f 6d20 7365 7373 696f 6e0a 2020 2020  dom session.    
│ │ │ │ -00032e60: 206b 6579 2069 7320 6164 6465 6420 746f   key is added to
│ │ │ │ -00032e70: 2074 6865 2061 7574 6865 6e74 6963 6174   the authenticat
│ │ │ │ -00032e80: 6f72 2c20 7573 696e 6720 7468 6520 7361  or, using the sa
│ │ │ │ -00032e90: 6d65 206b 6579 7479 7065 2061 7320 7468  me keytype as th
│ │ │ │ -00032ea0: 650a 2020 2020 2074 6963 6b65 742e 0a0a  e.     ticket...
│ │ │ │ -00032eb0: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ -00032ec0: 7565 3a2a 2052 6574 7572 6e73 2053 4849  ue:* Returns SHI
│ │ │ │ -00032ed0: 5348 495f 4f4b 2069 6666 2073 7563 6365  SHI_OK iff succe
│ │ │ │ -00032ee0: 7373 6675 6c2e 0a0a 7368 6973 6869 5f61  ssful...shishi_a
│ │ │ │ -00032ef0: 705f 6574 7970 655f 746b 746f 7074 696f  p_etype_tktoptio
│ │ │ │ -00032f00: 6e73 6461 7461 0a2d 2d2d 2d2d 2d2d 2d2d  nsdata.---------
│ │ │ │ +00032730: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ +00032740: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ +00032750: 6869 5f61 705f 746b 746f 7074 696f 6e73  hi_ap_tktoptions
│ │ │ │ +00032760: 6461 7461 2028 5368 6973 6869 202a 2048  data (Shishi * H
│ │ │ │ +00032770: 414e 444c 452c 0a20 2020 2020 2020 2020  ANDLE,.         
│ │ │ │ +00032780: 2053 6869 7368 695f 6170 202a 2a20 4150   Shishi_ap ** AP
│ │ │ │ +00032790: 2c20 5368 6973 6869 5f74 6b74 202a 2054  , Shishi_tkt * T
│ │ │ │ +000327a0: 4b54 2c20 696e 7420 4f50 5449 4f4e 532c  KT, int OPTIONS,
│ │ │ │ +000327b0: 0a20 2020 2020 2020 2020 2063 6f6e 7374  .          const
│ │ │ │ +000327c0: 2063 6861 7220 2a20 4441 5441 2c20 7369   char * DATA, si
│ │ │ │ +000327d0: 7a65 5f74 204c 454e 290a 2020 2020 2048  ze_t LEN).     H
│ │ │ │ +000327e0: 414e 444c 453a 2073 6869 7368 6920 6861  ANDLE: shishi ha
│ │ │ │ +000327f0: 6e64 6c65 2061 7320 616c 6c6f 6361 7465  ndle as allocate
│ │ │ │ +00032800: 6420 6279 20e2 8098 7368 6973 6869 5f69  d by ...shishi_i
│ │ │ │ +00032810: 6e69 7428 29e2 8099 2e0a 2020 2020 2041  nit().....     A
│ │ │ │ +00032820: 503a 2070 6f69 6e74 6572 2074 6f20 6e65  P: pointer to ne
│ │ │ │ +00032830: 7720 7374 7275 6374 7572 6520 7468 6174  w structure that
│ │ │ │ +00032840: 2068 6f6c 6473 2069 6e66 6f72 6d61 7469   holds informati
│ │ │ │ +00032850: 6f6e 2061 626f 7574 2041 500a 2020 2020  on about AP.    
│ │ │ │ +00032860: 2065 7863 6861 6e67 650a 2020 2020 2054   exchange.     T
│ │ │ │ +00032870: 4b54 3a20 7469 636b 6574 2074 6f20 7365  KT: ticket to se
│ │ │ │ +00032880: 7420 696e 206e 6577 6c79 2063 7265 6174  t in newly creat
│ │ │ │ +00032890: 6564 2041 502e 0a20 2020 2020 4f50 5449  ed AP..     OPTI
│ │ │ │ +000328a0: 4f4e 533a 2041 502d 5245 5120 6f70 7469  ONS: AP-REQ opti
│ │ │ │ +000328b0: 6f6e 7320 746f 2073 6574 2069 6e20 6e65  ons to set in ne
│ │ │ │ +000328c0: 776c 7920 6372 6561 7465 6420 4150 2e0a  wly created AP..
│ │ │ │ +000328d0: 2020 2020 2044 4154 413a 2069 6e70 7574       DATA: input
│ │ │ │ +000328e0: 2061 7272 6179 2077 6974 6820 6461 7461   array with data
│ │ │ │ +000328f0: 2074 6f20 6368 6563 6b73 756d 2069 6e20   to checksum in 
│ │ │ │ +00032900: 4175 7468 656e 7469 6361 746f 722e 0a20  Authenticator.. 
│ │ │ │ +00032910: 2020 2020 4c45 4e3a 206c 656e 6774 6820      LEN: length 
│ │ │ │ +00032920: 6f66 2069 6e70 7574 2061 7272 6179 2077  of input array w
│ │ │ │ +00032930: 6974 6820 6461 7461 2074 6f20 6368 6563  ith data to chec
│ │ │ │ +00032940: 6b73 756d 2069 6e20 4175 7468 656e 7469  ksum in Authenti
│ │ │ │ +00032950: 6361 746f 722e 0a0a 2020 2020 202a 4465  cator...     *De
│ │ │ │ +00032960: 7363 7269 7074 696f 6e3a 2a20 4372 6561  scription:* Crea
│ │ │ │ +00032970: 7465 2061 206e 6577 2041 5020 6578 6368  te a new AP exch
│ │ │ │ +00032980: 616e 6765 2075 7369 6e67 20e2 8098 7368  ange using ...sh
│ │ │ │ +00032990: 6973 6869 5f61 7028 29e2 8099 2c20 616e  ishi_ap()..., an
│ │ │ │ +000329a0: 640a 2020 2020 2073 6574 2074 6865 2074  d.     set the t
│ │ │ │ +000329b0: 6963 6b65 742c 2041 502d 5245 5120 6170  icket, AP-REQ ap
│ │ │ │ +000329c0: 6f70 7469 6f6e 7320 616e 6420 7468 6520  options and the 
│ │ │ │ +000329d0: 4175 7468 656e 7469 6361 746f 7220 6368  Authenticator ch
│ │ │ │ +000329e0: 6563 6b73 756d 0a20 2020 2020 6461 7461  ecksum.     data
│ │ │ │ +000329f0: 2075 7369 6e67 20e2 8098 7368 6973 6869   using ...shishi
│ │ │ │ +00032a00: 5f61 705f 7365 745f 746b 746f 7074 696f  _ap_set_tktoptio
│ │ │ │ +00032a10: 6e73 6461 7461 2829 e280 992e 2020 4120  nsdata()....  A 
│ │ │ │ +00032a20: 7261 6e64 6f6d 2073 6573 7369 6f6e 206b  random session k
│ │ │ │ +00032a30: 6579 0a20 2020 2020 6973 2061 6464 6564  ey.     is added
│ │ │ │ +00032a40: 2074 6f20 7468 6520 6175 7468 656e 7469   to the authenti
│ │ │ │ +00032a50: 6361 746f 722c 2075 7369 6e67 2074 6865  cator, using the
│ │ │ │ +00032a60: 2073 616d 6520 6b65 7974 7970 6520 6173   same keytype as
│ │ │ │ +00032a70: 2074 6865 0a20 2020 2020 7469 636b 6574   the.     ticket
│ │ │ │ +00032a80: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ +00032a90: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ +00032aa0: 5348 4953 4849 5f4f 4b20 6966 6620 7375  SHISHI_OK iff su
│ │ │ │ +00032ab0: 6363 6573 7366 756c 2e0a 0a73 6869 7368  ccessful...shish
│ │ │ │ +00032ac0: 695f 6170 5f74 6b74 6f70 7469 6f6e 7372  i_ap_tktoptionsr
│ │ │ │ +00032ad0: 6177 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  aw.-------------
│ │ │ │ +00032ae0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +00032af0: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ +00032b00: 6973 6869 5f61 705f 746b 746f 7074 696f  ishi_ap_tktoptio
│ │ │ │ +00032b10: 6e73 7261 7720 2853 6869 7368 6920 2a20  nsraw (Shishi * 
│ │ │ │ +00032b20: 4841 4e44 4c45 2c0a 2020 2020 2020 2020  HANDLE,.        
│ │ │ │ +00032b30: 2020 5368 6973 6869 5f61 7020 2a2a 2041    Shishi_ap ** A
│ │ │ │ +00032b40: 502c 2053 6869 7368 695f 746b 7420 2a20  P, Shishi_tkt * 
│ │ │ │ +00032b50: 544b 542c 2069 6e74 204f 5054 494f 4e53  TKT, int OPTIONS
│ │ │ │ +00032b60: 2c0a 2020 2020 2020 2020 2020 696e 7433  ,.          int3
│ │ │ │ +00032b70: 325f 7420 434b 5355 4d54 5950 452c 2063  2_t CKSUMTYPE, c
│ │ │ │ +00032b80: 6f6e 7374 2063 6861 7220 2a20 4441 5441  onst char * DATA
│ │ │ │ +00032b90: 2c20 7369 7a65 5f74 204c 454e 290a 2020  , size_t LEN).  
│ │ │ │ +00032ba0: 2020 2048 414e 444c 453a 2073 6869 7368     HANDLE: shish
│ │ │ │ +00032bb0: 6920 6861 6e64 6c65 2061 7320 616c 6c6f  i handle as allo
│ │ │ │ +00032bc0: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ +00032bd0: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ +00032be0: 2020 2041 503a 2070 6f69 6e74 6572 2074     AP: pointer t
│ │ │ │ +00032bf0: 6f20 6e65 7720 7374 7275 6374 7572 6520  o new structure 
│ │ │ │ +00032c00: 7468 6174 2068 6f6c 6473 2069 6e66 6f72  that holds infor
│ │ │ │ +00032c10: 6d61 7469 6f6e 2061 626f 7574 2041 500a  mation about AP.
│ │ │ │ +00032c20: 2020 2020 2065 7863 6861 6e67 650a 2020       exchange.  
│ │ │ │ +00032c30: 2020 2054 4b54 3a20 7469 636b 6574 2074     TKT: ticket t
│ │ │ │ +00032c40: 6f20 7365 7420 696e 206e 6577 6c79 2063  o set in newly c
│ │ │ │ +00032c50: 7265 6174 6564 2041 502e 0a20 2020 2020  reated AP..     
│ │ │ │ +00032c60: 4f50 5449 4f4e 533a 2041 502d 5245 5120  OPTIONS: AP-REQ 
│ │ │ │ +00032c70: 6f70 7469 6f6e 7320 746f 2073 6574 2069  options to set i
│ │ │ │ +00032c80: 6e20 6e65 776c 7920 6372 6561 7465 6420  n newly created 
│ │ │ │ +00032c90: 4150 2e0a 2020 2020 2043 4b53 554d 5459  AP..     CKSUMTY
│ │ │ │ +00032ca0: 5045 3a20 6175 7468 656e 7469 6361 746f  PE: authenticato
│ │ │ │ +00032cb0: 7220 6368 6563 6b73 756d 2074 7970 6520  r checksum type 
│ │ │ │ +00032cc0: 746f 2073 6574 2069 6e20 4150 2e0a 2020  to set in AP..  
│ │ │ │ +00032cd0: 2020 2044 4154 413a 2069 6e70 7574 2061     DATA: input a
│ │ │ │ +00032ce0: 7272 6179 2077 6974 6820 6461 7461 2074  rray with data t
│ │ │ │ +00032cf0: 6f20 7374 6f72 6520 696e 2063 6865 636b  o store in check
│ │ │ │ +00032d00: 7375 6d20 6669 656c 6420 696e 0a20 2020  sum field in.   
│ │ │ │ +00032d10: 2020 4175 7468 656e 7469 6361 746f 722e    Authenticator.
│ │ │ │ +00032d20: 0a20 2020 2020 4c45 4e3a 206c 656e 6774  .     LEN: lengt
│ │ │ │ +00032d30: 6820 6f66 2069 6e70 7574 2061 7272 6179  h of input array
│ │ │ │ +00032d40: 2077 6974 6820 6461 7461 2074 6f20 7374   with data to st
│ │ │ │ +00032d50: 6f72 6520 696e 2063 6865 636b 7375 6d20  ore in checksum 
│ │ │ │ +00032d60: 6669 656c 6420 696e 0a20 2020 2020 4175  field in.     Au
│ │ │ │ +00032d70: 7468 656e 7469 6361 746f 722e 0a0a 2020  thenticator...  
│ │ │ │ +00032d80: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ +00032d90: 2a20 4372 6561 7465 2061 206e 6577 2041  * Create a new A
│ │ │ │ +00032da0: 5020 6578 6368 616e 6765 2075 7369 6e67  P exchange using
│ │ │ │ +00032db0: 20e2 8098 7368 6973 6869 5f61 7028 29e2   ...shishi_ap().
│ │ │ │ +00032dc0: 8099 2c20 616e 640a 2020 2020 2073 6574  .., and.     set
│ │ │ │ +00032dd0: 2074 6865 2074 6963 6b65 742c 2041 502d   the ticket, AP-
│ │ │ │ +00032de0: 5245 5120 6170 6f70 7469 6f6e 7320 616e  REQ apoptions an
│ │ │ │ +00032df0: 6420 7468 6520 7261 7720 4175 7468 656e  d the raw Authen
│ │ │ │ +00032e00: 7469 6361 746f 7220 6368 6563 6b73 756d  ticator checksum
│ │ │ │ +00032e10: 0a20 2020 2020 6461 7461 2066 6965 6c64  .     data field
│ │ │ │ +00032e20: 2075 7369 6e67 20e2 8098 7368 6973 6869   using ...shishi
│ │ │ │ +00032e30: 5f61 705f 7365 745f 746b 746f 7074 696f  _ap_set_tktoptio
│ │ │ │ +00032e40: 6e73 7261 7728 29e2 8099 2e20 2041 2072  nsraw()....  A r
│ │ │ │ +00032e50: 616e 646f 6d20 7365 7373 696f 6e0a 2020  andom session.  
│ │ │ │ +00032e60: 2020 206b 6579 2069 7320 6164 6465 6420     key is added 
│ │ │ │ +00032e70: 746f 2074 6865 2061 7574 6865 6e74 6963  to the authentic
│ │ │ │ +00032e80: 6174 6f72 2c20 7573 696e 6720 7468 6520  ator, using the 
│ │ │ │ +00032e90: 7361 6d65 206b 6579 7479 7065 2061 7320  same keytype as 
│ │ │ │ +00032ea0: 7468 650a 2020 2020 2074 6963 6b65 742e  the.     ticket.
│ │ │ │ +00032eb0: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ +00032ec0: 616c 7565 3a2a 2052 6574 7572 6e73 2053  alue:* Returns S
│ │ │ │ +00032ed0: 4849 5348 495f 4f4b 2069 6666 2073 7563  HISHI_OK iff suc
│ │ │ │ +00032ee0: 6365 7373 6675 6c2e 0a0a 7368 6973 6869  cessful...shishi
│ │ │ │ +00032ef0: 5f61 705f 6574 7970 655f 746b 746f 7074  _ap_etype_tktopt
│ │ │ │ +00032f00: 696f 6e73 6461 7461 0a2d 2d2d 2d2d 2d2d  ionsdata.-------
│ │ │ │  00032f10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00032f20: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ -00032f30: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ -00032f40: 6170 5f65 7479 7065 5f74 6b74 6f70 7469  ap_etype_tktopti
│ │ │ │ -00032f50: 6f6e 7364 6174 6120 2853 6869 7368 6920  onsdata (Shishi 
│ │ │ │ -00032f60: 2a20 4841 4e44 4c45 2c0a 2020 2020 2020  * HANDLE,.      
│ │ │ │ -00032f70: 2020 2020 5368 6973 6869 5f61 7020 2a2a      Shishi_ap **
│ │ │ │ -00032f80: 2041 502c 2069 6e74 3332 5f74 2045 5459   AP, int32_t ETY
│ │ │ │ -00032f90: 5045 2c20 5368 6973 6869 5f74 6b74 202a  PE, Shishi_tkt *
│ │ │ │ -00032fa0: 2054 4b54 2c20 696e 7420 4f50 5449 4f4e   TKT, int OPTION
│ │ │ │ -00032fb0: 532c 0a20 2020 2020 2020 2020 2063 6f6e  S,.          con
│ │ │ │ -00032fc0: 7374 2063 6861 7220 2a20 4441 5441 2c20  st char * DATA, 
│ │ │ │ -00032fd0: 7369 7a65 5f74 204c 454e 290a 2020 2020  size_t LEN).    
│ │ │ │ -00032fe0: 2048 414e 444c 453a 2073 6869 7368 6920   HANDLE: shishi 
│ │ │ │ -00032ff0: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ -00033000: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ -00033010: 5f69 6e69 7428 29e2 8099 2e0a 2020 2020  _init().....    
│ │ │ │ -00033020: 2041 503a 2070 6f69 6e74 6572 2074 6f20   AP: pointer to 
│ │ │ │ -00033030: 6e65 7720 7374 7275 6374 7572 6520 7468  new structure th
│ │ │ │ -00033040: 6174 2068 6f6c 6473 2069 6e66 6f72 6d61  at holds informa
│ │ │ │ -00033050: 7469 6f6e 2061 626f 7574 2041 500a 2020  tion about AP.  
│ │ │ │ -00033060: 2020 2065 7863 6861 6e67 650a 2020 2020     exchange.    
│ │ │ │ -00033070: 2045 5459 5045 3a20 656e 6372 7970 7469   ETYPE: encrypti
│ │ │ │ -00033080: 6f6e 2074 7970 6520 6f66 206e 6577 6c79  on type of newly
│ │ │ │ -00033090: 2067 656e 6572 6174 6564 2072 616e 646f   generated rando
│ │ │ │ -000330a0: 6d20 7375 626b 6579 2e0a 2020 2020 2054  m subkey..     T
│ │ │ │ -000330b0: 4b54 3a20 7469 636b 6574 2074 6f20 7365  KT: ticket to se
│ │ │ │ -000330c0: 7420 696e 206e 6577 6c79 2063 7265 6174  t in newly creat
│ │ │ │ -000330d0: 6564 2041 502e 0a20 2020 2020 4f50 5449  ed AP..     OPTI
│ │ │ │ -000330e0: 4f4e 533a 2041 502d 5245 5120 6f70 7469  ONS: AP-REQ opti
│ │ │ │ -000330f0: 6f6e 7320 746f 2073 6574 2069 6e20 6e65  ons to set in ne
│ │ │ │ -00033100: 776c 7920 6372 6561 7465 6420 4150 2e0a  wly created AP..
│ │ │ │ -00033110: 2020 2020 2044 4154 413a 2069 6e70 7574       DATA: input
│ │ │ │ -00033120: 2061 7272 6179 2077 6974 6820 6461 7461   array with data
│ │ │ │ -00033130: 2074 6f20 6368 6563 6b73 756d 2069 6e20   to checksum in 
│ │ │ │ -00033140: 4175 7468 656e 7469 6361 746f 722e 0a20  Authenticator.. 
│ │ │ │ -00033150: 2020 2020 4c45 4e3a 206c 656e 6774 6820      LEN: length 
│ │ │ │ -00033160: 6f66 2069 6e70 7574 2061 7272 6179 2077  of input array w
│ │ │ │ -00033170: 6974 6820 6461 7461 2074 6f20 6368 6563  ith data to chec
│ │ │ │ -00033180: 6b73 756d 2069 6e20 4175 7468 656e 7469  ksum in Authenti
│ │ │ │ -00033190: 6361 746f 722e 0a0a 2020 2020 202a 4465  cator...     *De
│ │ │ │ -000331a0: 7363 7269 7074 696f 6e3a 2a20 4372 6561  scription:* Crea
│ │ │ │ -000331b0: 7465 2061 206e 6577 2041 5020 6578 6368  te a new AP exch
│ │ │ │ -000331c0: 616e 6765 2075 7369 6e67 20e2 8098 7368  ange using ...sh
│ │ │ │ -000331d0: 6973 6869 5f61 7028 29e2 8099 2c20 616e  ishi_ap()..., an
│ │ │ │ -000331e0: 640a 2020 2020 2073 6574 2074 6865 2074  d.     set the t
│ │ │ │ -000331f0: 6963 6b65 742c 2041 502d 5245 5120 6170  icket, AP-REQ ap
│ │ │ │ -00033200: 6f70 7469 6f6e 7320 616e 6420 7468 6520  options and the 
│ │ │ │ -00033210: 4175 7468 656e 7469 6361 746f 7220 6368  Authenticator ch
│ │ │ │ -00033220: 6563 6b73 756d 0a20 2020 2020 6461 7461  ecksum.     data
│ │ │ │ -00033230: 2075 7369 6e67 20e2 8098 7368 6973 6869   using ...shishi
│ │ │ │ -00033240: 5f61 705f 7365 745f 746b 746f 7074 696f  _ap_set_tktoptio
│ │ │ │ -00033250: 6e73 6461 7461 2829 e280 992e 2020 4120  nsdata()....  A 
│ │ │ │ -00033260: 7261 6e64 6f6d 2073 6573 7369 6f6e 206b  random session k
│ │ │ │ -00033270: 6579 0a20 2020 2020 6973 2061 6464 6564  ey.     is added
│ │ │ │ -00033280: 2074 6f20 7468 6520 6175 7468 656e 7469   to the authenti
│ │ │ │ -00033290: 6361 746f 722c 2075 7369 6e67 2074 6865  cator, using the
│ │ │ │ -000332a0: 2073 616d 6520 6b65 7974 7970 6520 6173   same keytype as
│ │ │ │ -000332b0: 2074 6865 0a20 2020 2020 7469 636b 6574   the.     ticket
│ │ │ │ -000332c0: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ -000332d0: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ -000332e0: 5348 4953 4849 5f4f 4b20 6966 6620 7375  SHISHI_OK iff su
│ │ │ │ -000332f0: 6363 6573 7366 756c 2e0a 0a73 6869 7368  ccessful...shish
│ │ │ │ -00033300: 695f 6170 5f74 6b74 6f70 7469 6f6e 7361  i_ap_tktoptionsa
│ │ │ │ -00033310: 736e 3175 7361 6765 0a2d 2d2d 2d2d 2d2d  sn1usage.-------
│ │ │ │ +00032f20: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +00032f30: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ +00032f40: 695f 6170 5f65 7479 7065 5f74 6b74 6f70  i_ap_etype_tktop
│ │ │ │ +00032f50: 7469 6f6e 7364 6174 6120 2853 6869 7368  tionsdata (Shish
│ │ │ │ +00032f60: 6920 2a20 4841 4e44 4c45 2c0a 2020 2020  i * HANDLE,.    
│ │ │ │ +00032f70: 2020 2020 2020 5368 6973 6869 5f61 7020        Shishi_ap 
│ │ │ │ +00032f80: 2a2a 2041 502c 2069 6e74 3332 5f74 2045  ** AP, int32_t E
│ │ │ │ +00032f90: 5459 5045 2c20 5368 6973 6869 5f74 6b74  TYPE, Shishi_tkt
│ │ │ │ +00032fa0: 202a 2054 4b54 2c20 696e 7420 4f50 5449   * TKT, int OPTI
│ │ │ │ +00032fb0: 4f4e 532c 0a20 2020 2020 2020 2020 2063  ONS,.          c
│ │ │ │ +00032fc0: 6f6e 7374 2063 6861 7220 2a20 4441 5441  onst char * DATA
│ │ │ │ +00032fd0: 2c20 7369 7a65 5f74 204c 454e 290a 2020  , size_t LEN).  
│ │ │ │ +00032fe0: 2020 2048 414e 444c 453a 2073 6869 7368     HANDLE: shish
│ │ │ │ +00032ff0: 6920 6861 6e64 6c65 2061 7320 616c 6c6f  i handle as allo
│ │ │ │ +00033000: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ +00033010: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ +00033020: 2020 2041 503a 2070 6f69 6e74 6572 2074     AP: pointer t
│ │ │ │ +00033030: 6f20 6e65 7720 7374 7275 6374 7572 6520  o new structure 
│ │ │ │ +00033040: 7468 6174 2068 6f6c 6473 2069 6e66 6f72  that holds infor
│ │ │ │ +00033050: 6d61 7469 6f6e 2061 626f 7574 2041 500a  mation about AP.
│ │ │ │ +00033060: 2020 2020 2065 7863 6861 6e67 650a 2020       exchange.  
│ │ │ │ +00033070: 2020 2045 5459 5045 3a20 656e 6372 7970     ETYPE: encryp
│ │ │ │ +00033080: 7469 6f6e 2074 7970 6520 6f66 206e 6577  tion type of new
│ │ │ │ +00033090: 6c79 2067 656e 6572 6174 6564 2072 616e  ly generated ran
│ │ │ │ +000330a0: 646f 6d20 7375 626b 6579 2e0a 2020 2020  dom subkey..    
│ │ │ │ +000330b0: 2054 4b54 3a20 7469 636b 6574 2074 6f20   TKT: ticket to 
│ │ │ │ +000330c0: 7365 7420 696e 206e 6577 6c79 2063 7265  set in newly cre
│ │ │ │ +000330d0: 6174 6564 2041 502e 0a20 2020 2020 4f50  ated AP..     OP
│ │ │ │ +000330e0: 5449 4f4e 533a 2041 502d 5245 5120 6f70  TIONS: AP-REQ op
│ │ │ │ +000330f0: 7469 6f6e 7320 746f 2073 6574 2069 6e20  tions to set in 
│ │ │ │ +00033100: 6e65 776c 7920 6372 6561 7465 6420 4150  newly created AP
│ │ │ │ +00033110: 2e0a 2020 2020 2044 4154 413a 2069 6e70  ..     DATA: inp
│ │ │ │ +00033120: 7574 2061 7272 6179 2077 6974 6820 6461  ut array with da
│ │ │ │ +00033130: 7461 2074 6f20 6368 6563 6b73 756d 2069  ta to checksum i
│ │ │ │ +00033140: 6e20 4175 7468 656e 7469 6361 746f 722e  n Authenticator.
│ │ │ │ +00033150: 0a20 2020 2020 4c45 4e3a 206c 656e 6774  .     LEN: lengt
│ │ │ │ +00033160: 6820 6f66 2069 6e70 7574 2061 7272 6179  h of input array
│ │ │ │ +00033170: 2077 6974 6820 6461 7461 2074 6f20 6368   with data to ch
│ │ │ │ +00033180: 6563 6b73 756d 2069 6e20 4175 7468 656e  ecksum in Authen
│ │ │ │ +00033190: 7469 6361 746f 722e 0a0a 2020 2020 202a  ticator...     *
│ │ │ │ +000331a0: 4465 7363 7269 7074 696f 6e3a 2a20 4372  Description:* Cr
│ │ │ │ +000331b0: 6561 7465 2061 206e 6577 2041 5020 6578  eate a new AP ex
│ │ │ │ +000331c0: 6368 616e 6765 2075 7369 6e67 20e2 8098  change using ...
│ │ │ │ +000331d0: 7368 6973 6869 5f61 7028 29e2 8099 2c20  shishi_ap()..., 
│ │ │ │ +000331e0: 616e 640a 2020 2020 2073 6574 2074 6865  and.     set the
│ │ │ │ +000331f0: 2074 6963 6b65 742c 2041 502d 5245 5120   ticket, AP-REQ 
│ │ │ │ +00033200: 6170 6f70 7469 6f6e 7320 616e 6420 7468  apoptions and th
│ │ │ │ +00033210: 6520 4175 7468 656e 7469 6361 746f 7220  e Authenticator 
│ │ │ │ +00033220: 6368 6563 6b73 756d 0a20 2020 2020 6461  checksum.     da
│ │ │ │ +00033230: 7461 2075 7369 6e67 20e2 8098 7368 6973  ta using ...shis
│ │ │ │ +00033240: 6869 5f61 705f 7365 745f 746b 746f 7074  hi_ap_set_tktopt
│ │ │ │ +00033250: 696f 6e73 6461 7461 2829 e280 992e 2020  ionsdata()....  
│ │ │ │ +00033260: 4120 7261 6e64 6f6d 2073 6573 7369 6f6e  A random session
│ │ │ │ +00033270: 206b 6579 0a20 2020 2020 6973 2061 6464   key.     is add
│ │ │ │ +00033280: 6564 2074 6f20 7468 6520 6175 7468 656e  ed to the authen
│ │ │ │ +00033290: 7469 6361 746f 722c 2075 7369 6e67 2074  ticator, using t
│ │ │ │ +000332a0: 6865 2073 616d 6520 6b65 7974 7970 6520  he same keytype 
│ │ │ │ +000332b0: 6173 2074 6865 0a20 2020 2020 7469 636b  as the.     tick
│ │ │ │ +000332c0: 6574 2e0a 0a20 2020 2020 2a52 6574 7572  et...     *Retur
│ │ │ │ +000332d0: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ +000332e0: 7320 5348 4953 4849 5f4f 4b20 6966 6620  s SHISHI_OK iff 
│ │ │ │ +000332f0: 7375 6363 6573 7366 756c 2e0a 0a73 6869  successful...shi
│ │ │ │ +00033300: 7368 695f 6170 5f74 6b74 6f70 7469 6f6e  shi_ap_tktoption
│ │ │ │ +00033310: 7361 736e 3175 7361 6765 0a2d 2d2d 2d2d  sasn1usage.-----
│ │ │ │  00033320: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00033330: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ -00033340: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ -00033350: 5f61 705f 746b 746f 7074 696f 6e73 6173  _ap_tktoptionsas
│ │ │ │ -00033360: 6e31 7573 6167 6520 2853 6869 7368 6920  n1usage (Shishi 
│ │ │ │ -00033370: 2a20 4841 4e44 4c45 2c0a 2020 2020 2020  * HANDLE,.      
│ │ │ │ -00033380: 2020 2020 5368 6973 6869 5f61 7020 2a2a      Shishi_ap **
│ │ │ │ -00033390: 2041 502c 2053 6869 7368 695f 746b 7420   AP, Shishi_tkt 
│ │ │ │ -000333a0: 2a20 544b 542c 2069 6e74 204f 5054 494f  * TKT, int OPTIO
│ │ │ │ -000333b0: 4e53 2c0a 2020 2020 2020 2020 2020 5368  NS,.          Sh
│ │ │ │ -000333c0: 6973 6869 5f61 736e 3120 4e4f 4445 2c20  ishi_asn1 NODE, 
│ │ │ │ -000333d0: 636f 6e73 7420 6368 6172 202a 2046 4945  const char * FIE
│ │ │ │ -000333e0: 4c44 2c0a 2020 2020 2020 2020 2020 696e  LD,.          in
│ │ │ │ -000333f0: 7420 4155 5448 454e 5449 4341 544f 5243  t AUTHENTICATORC
│ │ │ │ -00033400: 4b53 554d 4b45 5955 5341 4745 2c20 696e  KSUMKEYUSAGE, in
│ │ │ │ -00033410: 7420 4155 5448 454e 5449 4341 544f 524b  t AUTHENTICATORK
│ │ │ │ -00033420: 4559 5553 4147 4529 0a20 2020 2020 4841  EYUSAGE).     HA
│ │ │ │ -00033430: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ -00033440: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ -00033450: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ -00033460: 6974 2829 e280 992e 0a20 2020 2020 4150  it().....     AP
│ │ │ │ -00033470: 3a20 706f 696e 7465 7220 746f 206e 6577  : pointer to new
│ │ │ │ -00033480: 2073 7472 7563 7475 7265 2074 6861 7420   structure that 
│ │ │ │ -00033490: 686f 6c64 7320 696e 666f 726d 6174 696f  holds informatio
│ │ │ │ -000334a0: 6e20 6162 6f75 7420 4150 0a20 2020 2020  n about AP.     
│ │ │ │ -000334b0: 6578 6368 616e 6765 0a20 2020 2020 544b  exchange.     TK
│ │ │ │ -000334c0: 543a 2074 6963 6b65 7420 746f 2073 6574  T: ticket to set
│ │ │ │ -000334d0: 2069 6e20 6e65 776c 7920 6372 6561 7465   in newly create
│ │ │ │ -000334e0: 6420 4150 2e0a 2020 2020 204f 5054 494f  d AP..     OPTIO
│ │ │ │ -000334f0: 4e53 3a20 4150 2d52 4551 206f 7074 696f  NS: AP-REQ optio
│ │ │ │ -00033500: 6e73 2074 6f20 7365 7420 696e 206e 6577  ns to set in new
│ │ │ │ -00033510: 6c79 2063 7265 6174 6564 2041 502e 0a20  ly created AP.. 
│ │ │ │ -00033520: 2020 2020 4e4f 4445 3a20 696e 7075 7420      NODE: input 
│ │ │ │ -00033530: 4153 4e2e 3120 7374 7275 6374 7572 6520  ASN.1 structure 
│ │ │ │ -00033540: 746f 2073 746f 7265 2061 7320 6175 7468  to store as auth
│ │ │ │ -00033550: 656e 7469 6361 746f 7220 6368 6563 6b73  enticator checks
│ │ │ │ -00033560: 756d 0a20 2020 2020 6461 7461 2e0a 2020  um.     data..  
│ │ │ │ -00033570: 2020 2046 4945 4c44 3a20 6669 656c 6420     FIELD: field 
│ │ │ │ -00033580: 696e 2041 534e 2e31 2073 7472 7563 7475  in ASN.1 structu
│ │ │ │ -00033590: 7265 2074 6f20 7573 652e 0a20 2020 2020  re to use..     
│ │ │ │ -000335a0: 4155 5448 454e 5449 4341 544f 5243 4b53  AUTHENTICATORCKS
│ │ │ │ -000335b0: 554d 4b45 5955 5341 4745 3a20 6b65 7920  UMKEYUSAGE: key 
│ │ │ │ -000335c0: 7573 6167 6520 666f 7220 6368 6563 6b73  usage for checks
│ │ │ │ -000335d0: 756d 2069 6e0a 2020 2020 2061 7574 6865  um in.     authe
│ │ │ │ -000335e0: 6e74 6963 6174 6f72 2e0a 2020 2020 2041  nticator..     A
│ │ │ │ -000335f0: 5554 4845 4e54 4943 4154 4f52 4b45 5955  UTHENTICATORKEYU
│ │ │ │ -00033600: 5341 4745 3a20 6b65 7920 7573 6167 6520  SAGE: key usage 
│ │ │ │ -00033610: 666f 7220 6175 7468 656e 7469 6361 746f  for authenticato
│ │ │ │ -00033620: 722e 0a0a 2020 2020 202a 4465 7363 7269  r...     *Descri
│ │ │ │ -00033630: 7074 696f 6e3a 2a20 4372 6561 7465 2061  ption:* Create a
│ │ │ │ -00033640: 206e 6577 2041 5020 6578 6368 616e 6765   new AP exchange
│ │ │ │ -00033650: 2075 7369 6e67 20e2 8098 7368 6973 6869   using ...shishi
│ │ │ │ -00033660: 5f61 7028 29e2 8099 2c20 616e 640a 2020  _ap()..., and.  
│ │ │ │ -00033670: 2020 2073 6574 2074 6963 6b65 742c 206f     set ticket, o
│ │ │ │ -00033680: 7074 696f 6e73 2061 6e64 2061 7574 6865  ptions and authe
│ │ │ │ -00033690: 6e74 6963 6174 6f72 2063 6865 636b 7375  nticator checksu
│ │ │ │ -000336a0: 6d20 6461 7461 2066 726f 6d20 7468 6520  m data from the 
│ │ │ │ -000336b0: 4445 520a 2020 2020 2065 6e63 6f64 696e  DER.     encodin
│ │ │ │ -000336c0: 6720 6f66 2074 6865 2041 534e 2e31 2066  g of the ASN.1 f
│ │ │ │ -000336d0: 6965 6c64 2075 7369 6e67 0a20 2020 2020  ield using.     
│ │ │ │ -000336e0: e280 9873 6869 7368 695f 6170 5f73 6574  ...shishi_ap_set
│ │ │ │ -000336f0: 5f74 6b74 6f70 7469 6f6e 7361 736e 3175  _tktoptionsasn1u
│ │ │ │ -00033700: 7361 6765 2829 e280 992e 2020 4120 7261  sage()....  A ra
│ │ │ │ -00033710: 6e64 6f6d 2073 6573 7369 6f6e 206b 6579  ndom session key
│ │ │ │ -00033720: 2069 730a 2020 2020 2061 6464 6564 2074   is.     added t
│ │ │ │ -00033730: 6f20 7468 6520 6175 7468 656e 7469 6361  o the authentica
│ │ │ │ -00033740: 746f 722c 2075 7369 6e67 2074 6865 2073  tor, using the s
│ │ │ │ -00033750: 616d 6520 6b65 7974 7970 6520 6173 2074  ame keytype as t
│ │ │ │ -00033760: 6865 2074 6963 6b65 742e 0a0a 2020 2020  he ticket...    
│ │ │ │ -00033770: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ -00033780: 2052 6574 7572 6e73 2053 4849 5348 495f   Returns SHISHI_
│ │ │ │ -00033790: 4f4b 2069 6666 2073 7563 6365 7373 6675  OK iff successfu
│ │ │ │ -000337a0: 6c2e 0a0a 7368 6973 6869 5f61 705f 746b  l...shishi_ap_tk
│ │ │ │ -000337b0: 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  t.-------------.
│ │ │ │ -000337c0: 0a20 2d2d 2046 756e 6374 696f 6e3a 2053  . -- Function: S
│ │ │ │ -000337d0: 6869 7368 695f 746b 7420 2a20 7368 6973  hishi_tkt * shis
│ │ │ │ -000337e0: 6869 5f61 705f 746b 7420 2853 6869 7368  hi_ap_tkt (Shish
│ │ │ │ -000337f0: 695f 6170 202a 2041 5029 0a20 2020 2020  i_ap * AP).     
│ │ │ │ -00033800: 4150 3a20 7374 7275 6374 7572 6520 7468  AP: structure th
│ │ │ │ -00033810: 6174 2068 6f6c 6473 2069 6e66 6f72 6d61  at holds informa
│ │ │ │ -00033820: 7469 6f6e 2061 626f 7574 2041 5020 6578  tion about AP ex
│ │ │ │ -00033830: 6368 616e 6765 0a0a 2020 2020 202a 4465  change..     *De
│ │ │ │ -00033840: 7363 7269 7074 696f 6e3a 2a20 4765 7420  scription:* Get 
│ │ │ │ -00033850: 5469 636b 6574 2066 726f 6d20 4150 2065  Ticket from AP e
│ │ │ │ -00033860: 7863 6861 6e67 652e 0a0a 2020 2020 202a  xchange...     *
│ │ │ │ -00033870: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ -00033880: 6574 7572 6e73 2074 6865 2074 6963 6b65  eturns the ticke
│ │ │ │ -00033890: 7420 6672 6f6d 2074 6865 2041 5020 6578  t from the AP ex
│ │ │ │ -000338a0: 6368 616e 6765 2c20 6f72 204e 554c 4c20  change, or NULL 
│ │ │ │ -000338b0: 6966 0a20 2020 2020 6e6f 7420 7965 7420  if.     not yet 
│ │ │ │ -000338c0: 7365 7420 6f72 2061 6e20 6572 726f 7220  set or an error 
│ │ │ │ -000338d0: 6f63 6375 7265 642e 0a0a 7368 6973 6869  occured...shishi
│ │ │ │ -000338e0: 5f61 705f 746b 745f 7365 740a 2d2d 2d2d  _ap_tkt_set.----
│ │ │ │ -000338f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -00033900: 2d2d 2046 756e 6374 696f 6e3a 2076 6f69  -- Function: voi
│ │ │ │ -00033910: 6420 7368 6973 6869 5f61 705f 746b 745f  d shishi_ap_tkt_
│ │ │ │ -00033920: 7365 7420 2853 6869 7368 695f 6170 202a  set (Shishi_ap *
│ │ │ │ -00033930: 2041 502c 2053 6869 7368 695f 746b 7420   AP, Shishi_tkt 
│ │ │ │ -00033940: 2a20 544b 5429 0a20 2020 2020 4150 3a20  * TKT).     AP: 
│ │ │ │ -00033950: 7374 7275 6374 7572 6520 7468 6174 2068  structure that h
│ │ │ │ -00033960: 6f6c 6473 2069 6e66 6f72 6d61 7469 6f6e  olds information
│ │ │ │ -00033970: 2061 626f 7574 2041 5020 6578 6368 616e   about AP exchan
│ │ │ │ -00033980: 6765 0a20 2020 2020 544b 543a 2074 6963  ge.     TKT: tic
│ │ │ │ -00033990: 6b65 7420 746f 2073 746f 7265 2069 6e20  ket to store in 
│ │ │ │ -000339a0: 4150 2e0a 0a20 2020 2020 2a44 6573 6372  AP...     *Descr
│ │ │ │ -000339b0: 6970 7469 6f6e 3a2a 2053 6574 2074 6865  iption:* Set the
│ │ │ │ -000339c0: 2054 6963 6b65 7420 696e 2074 6865 2041   Ticket in the A
│ │ │ │ -000339d0: 5020 6578 6368 616e 6765 2e0a 0a73 6869  P exchange...shi
│ │ │ │ -000339e0: 7368 695f 6170 5f61 7574 6865 6e74 6963  shi_ap_authentic
│ │ │ │ -000339f0: 6174 6f72 5f63 6b73 756d 6461 7461 0a2d  ator_cksumdata.-
│ │ │ │ -00033a00: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +00033330: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ +00033340: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ +00033350: 6869 5f61 705f 746b 746f 7074 696f 6e73  hi_ap_tktoptions
│ │ │ │ +00033360: 6173 6e31 7573 6167 6520 2853 6869 7368  asn1usage (Shish
│ │ │ │ +00033370: 6920 2a20 4841 4e44 4c45 2c0a 2020 2020  i * HANDLE,.    
│ │ │ │ +00033380: 2020 2020 2020 5368 6973 6869 5f61 7020        Shishi_ap 
│ │ │ │ +00033390: 2a2a 2041 502c 2053 6869 7368 695f 746b  ** AP, Shishi_tk
│ │ │ │ +000333a0: 7420 2a20 544b 542c 2069 6e74 204f 5054  t * TKT, int OPT
│ │ │ │ +000333b0: 494f 4e53 2c0a 2020 2020 2020 2020 2020  IONS,.          
│ │ │ │ +000333c0: 5368 6973 6869 5f61 736e 3120 4e4f 4445  Shishi_asn1 NODE
│ │ │ │ +000333d0: 2c20 636f 6e73 7420 6368 6172 202a 2046  , const char * F
│ │ │ │ +000333e0: 4945 4c44 2c0a 2020 2020 2020 2020 2020  IELD,.          
│ │ │ │ +000333f0: 696e 7420 4155 5448 454e 5449 4341 544f  int AUTHENTICATO
│ │ │ │ +00033400: 5243 4b53 554d 4b45 5955 5341 4745 2c20  RCKSUMKEYUSAGE, 
│ │ │ │ +00033410: 696e 7420 4155 5448 454e 5449 4341 544f  int AUTHENTICATO
│ │ │ │ +00033420: 524b 4559 5553 4147 4529 0a20 2020 2020  RKEYUSAGE).     
│ │ │ │ +00033430: 4841 4e44 4c45 3a20 7368 6973 6869 2068  HANDLE: shishi h
│ │ │ │ +00033440: 616e 646c 6520 6173 2061 6c6c 6f63 6174  andle as allocat
│ │ │ │ +00033450: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ +00033460: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ +00033470: 4150 3a20 706f 696e 7465 7220 746f 206e  AP: pointer to n
│ │ │ │ +00033480: 6577 2073 7472 7563 7475 7265 2074 6861  ew structure tha
│ │ │ │ +00033490: 7420 686f 6c64 7320 696e 666f 726d 6174  t holds informat
│ │ │ │ +000334a0: 696f 6e20 6162 6f75 7420 4150 0a20 2020  ion about AP.   
│ │ │ │ +000334b0: 2020 6578 6368 616e 6765 0a20 2020 2020    exchange.     
│ │ │ │ +000334c0: 544b 543a 2074 6963 6b65 7420 746f 2073  TKT: ticket to s
│ │ │ │ +000334d0: 6574 2069 6e20 6e65 776c 7920 6372 6561  et in newly crea
│ │ │ │ +000334e0: 7465 6420 4150 2e0a 2020 2020 204f 5054  ted AP..     OPT
│ │ │ │ +000334f0: 494f 4e53 3a20 4150 2d52 4551 206f 7074  IONS: AP-REQ opt
│ │ │ │ +00033500: 696f 6e73 2074 6f20 7365 7420 696e 206e  ions to set in n
│ │ │ │ +00033510: 6577 6c79 2063 7265 6174 6564 2041 502e  ewly created AP.
│ │ │ │ +00033520: 0a20 2020 2020 4e4f 4445 3a20 696e 7075  .     NODE: inpu
│ │ │ │ +00033530: 7420 4153 4e2e 3120 7374 7275 6374 7572  t ASN.1 structur
│ │ │ │ +00033540: 6520 746f 2073 746f 7265 2061 7320 6175  e to store as au
│ │ │ │ +00033550: 7468 656e 7469 6361 746f 7220 6368 6563  thenticator chec
│ │ │ │ +00033560: 6b73 756d 0a20 2020 2020 6461 7461 2e0a  ksum.     data..
│ │ │ │ +00033570: 2020 2020 2046 4945 4c44 3a20 6669 656c       FIELD: fiel
│ │ │ │ +00033580: 6420 696e 2041 534e 2e31 2073 7472 7563  d in ASN.1 struc
│ │ │ │ +00033590: 7475 7265 2074 6f20 7573 652e 0a20 2020  ture to use..   
│ │ │ │ +000335a0: 2020 4155 5448 454e 5449 4341 544f 5243    AUTHENTICATORC
│ │ │ │ +000335b0: 4b53 554d 4b45 5955 5341 4745 3a20 6b65  KSUMKEYUSAGE: ke
│ │ │ │ +000335c0: 7920 7573 6167 6520 666f 7220 6368 6563  y usage for chec
│ │ │ │ +000335d0: 6b73 756d 2069 6e0a 2020 2020 2061 7574  ksum in.     aut
│ │ │ │ +000335e0: 6865 6e74 6963 6174 6f72 2e0a 2020 2020  henticator..    
│ │ │ │ +000335f0: 2041 5554 4845 4e54 4943 4154 4f52 4b45   AUTHENTICATORKE
│ │ │ │ +00033600: 5955 5341 4745 3a20 6b65 7920 7573 6167  YUSAGE: key usag
│ │ │ │ +00033610: 6520 666f 7220 6175 7468 656e 7469 6361  e for authentica
│ │ │ │ +00033620: 746f 722e 0a0a 2020 2020 202a 4465 7363  tor...     *Desc
│ │ │ │ +00033630: 7269 7074 696f 6e3a 2a20 4372 6561 7465  ription:* Create
│ │ │ │ +00033640: 2061 206e 6577 2041 5020 6578 6368 616e   a new AP exchan
│ │ │ │ +00033650: 6765 2075 7369 6e67 20e2 8098 7368 6973  ge using ...shis
│ │ │ │ +00033660: 6869 5f61 7028 29e2 8099 2c20 616e 640a  hi_ap()..., and.
│ │ │ │ +00033670: 2020 2020 2073 6574 2074 6963 6b65 742c       set ticket,
│ │ │ │ +00033680: 206f 7074 696f 6e73 2061 6e64 2061 7574   options and aut
│ │ │ │ +00033690: 6865 6e74 6963 6174 6f72 2063 6865 636b  henticator check
│ │ │ │ +000336a0: 7375 6d20 6461 7461 2066 726f 6d20 7468  sum data from th
│ │ │ │ +000336b0: 6520 4445 520a 2020 2020 2065 6e63 6f64  e DER.     encod
│ │ │ │ +000336c0: 696e 6720 6f66 2074 6865 2041 534e 2e31  ing of the ASN.1
│ │ │ │ +000336d0: 2066 6965 6c64 2075 7369 6e67 0a20 2020   field using.   
│ │ │ │ +000336e0: 2020 e280 9873 6869 7368 695f 6170 5f73    ...shishi_ap_s
│ │ │ │ +000336f0: 6574 5f74 6b74 6f70 7469 6f6e 7361 736e  et_tktoptionsasn
│ │ │ │ +00033700: 3175 7361 6765 2829 e280 992e 2020 4120  1usage()....  A 
│ │ │ │ +00033710: 7261 6e64 6f6d 2073 6573 7369 6f6e 206b  random session k
│ │ │ │ +00033720: 6579 2069 730a 2020 2020 2061 6464 6564  ey is.     added
│ │ │ │ +00033730: 2074 6f20 7468 6520 6175 7468 656e 7469   to the authenti
│ │ │ │ +00033740: 6361 746f 722c 2075 7369 6e67 2074 6865  cator, using the
│ │ │ │ +00033750: 2073 616d 6520 6b65 7974 7970 6520 6173   same keytype as
│ │ │ │ +00033760: 2074 6865 2074 6963 6b65 742e 0a0a 2020   the ticket...  
│ │ │ │ +00033770: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ +00033780: 3a2a 2052 6574 7572 6e73 2053 4849 5348  :* Returns SHISH
│ │ │ │ +00033790: 495f 4f4b 2069 6666 2073 7563 6365 7373  I_OK iff success
│ │ │ │ +000337a0: 6675 6c2e 0a0a 7368 6973 6869 5f61 705f  ful...shishi_ap_
│ │ │ │ +000337b0: 746b 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  tkt.------------
│ │ │ │ +000337c0: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ +000337d0: 2053 6869 7368 695f 746b 7420 2a20 7368   Shishi_tkt * sh
│ │ │ │ +000337e0: 6973 6869 5f61 705f 746b 7420 2853 6869  ishi_ap_tkt (Shi
│ │ │ │ +000337f0: 7368 695f 6170 202a 2041 5029 0a20 2020  shi_ap * AP).   
│ │ │ │ +00033800: 2020 4150 3a20 7374 7275 6374 7572 6520    AP: structure 
│ │ │ │ +00033810: 7468 6174 2068 6f6c 6473 2069 6e66 6f72  that holds infor
│ │ │ │ +00033820: 6d61 7469 6f6e 2061 626f 7574 2041 5020  mation about AP 
│ │ │ │ +00033830: 6578 6368 616e 6765 0a0a 2020 2020 202a  exchange..     *
│ │ │ │ +00033840: 4465 7363 7269 7074 696f 6e3a 2a20 4765  Description:* Ge
│ │ │ │ +00033850: 7420 5469 636b 6574 2066 726f 6d20 4150  t Ticket from AP
│ │ │ │ +00033860: 2065 7863 6861 6e67 652e 0a0a 2020 2020   exchange...    
│ │ │ │ +00033870: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ +00033880: 2052 6574 7572 6e73 2074 6865 2074 6963   Returns the tic
│ │ │ │ +00033890: 6b65 7420 6672 6f6d 2074 6865 2041 5020  ket from the AP 
│ │ │ │ +000338a0: 6578 6368 616e 6765 2c20 6f72 204e 554c  exchange, or NUL
│ │ │ │ +000338b0: 4c20 6966 0a20 2020 2020 6e6f 7420 7965  L if.     not ye
│ │ │ │ +000338c0: 7420 7365 7420 6f72 2061 6e20 6572 726f  t set or an erro
│ │ │ │ +000338d0: 7220 6f63 6375 7265 642e 0a0a 7368 6973  r occured...shis
│ │ │ │ +000338e0: 6869 5f61 705f 746b 745f 7365 740a 2d2d  hi_ap_tkt_set.--
│ │ │ │ +000338f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +00033900: 0a20 2d2d 2046 756e 6374 696f 6e3a 2076  . -- Function: v
│ │ │ │ +00033910: 6f69 6420 7368 6973 6869 5f61 705f 746b  oid shishi_ap_tk
│ │ │ │ +00033920: 745f 7365 7420 2853 6869 7368 695f 6170  t_set (Shishi_ap
│ │ │ │ +00033930: 202a 2041 502c 2053 6869 7368 695f 746b   * AP, Shishi_tk
│ │ │ │ +00033940: 7420 2a20 544b 5429 0a20 2020 2020 4150  t * TKT).     AP
│ │ │ │ +00033950: 3a20 7374 7275 6374 7572 6520 7468 6174  : structure that
│ │ │ │ +00033960: 2068 6f6c 6473 2069 6e66 6f72 6d61 7469   holds informati
│ │ │ │ +00033970: 6f6e 2061 626f 7574 2041 5020 6578 6368  on about AP exch
│ │ │ │ +00033980: 616e 6765 0a20 2020 2020 544b 543a 2074  ange.     TKT: t
│ │ │ │ +00033990: 6963 6b65 7420 746f 2073 746f 7265 2069  icket to store i
│ │ │ │ +000339a0: 6e20 4150 2e0a 0a20 2020 2020 2a44 6573  n AP...     *Des
│ │ │ │ +000339b0: 6372 6970 7469 6f6e 3a2a 2053 6574 2074  cription:* Set t
│ │ │ │ +000339c0: 6865 2054 6963 6b65 7420 696e 2074 6865  he Ticket in the
│ │ │ │ +000339d0: 2041 5020 6578 6368 616e 6765 2e0a 0a73   AP exchange...s
│ │ │ │ +000339e0: 6869 7368 695f 6170 5f61 7574 6865 6e74  hishi_ap_authent
│ │ │ │ +000339f0: 6963 6174 6f72 5f63 6b73 756d 6461 7461  icator_cksumdata
│ │ │ │ +00033a00: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │  00033a10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00033a20: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ -00033a30: 696e 7420 7368 6973 6869 5f61 705f 6175  int shishi_ap_au
│ │ │ │ -00033a40: 7468 656e 7469 6361 746f 725f 636b 7375  thenticator_cksu
│ │ │ │ -00033a50: 6d64 6174 6120 2853 6869 7368 695f 6170  mdata (Shishi_ap
│ │ │ │ -00033a60: 202a 2041 502c 0a20 2020 2020 2020 2020   * AP,.         
│ │ │ │ -00033a70: 2063 6861 7220 2a20 4f55 542c 2073 697a   char * OUT, siz
│ │ │ │ -00033a80: 655f 7420 2a20 4c45 4e29 0a20 2020 2020  e_t * LEN).     
│ │ │ │ -00033a90: 4150 3a20 7374 7275 6374 7572 6520 7468  AP: structure th
│ │ │ │ -00033aa0: 6174 2068 6f6c 6473 2069 6e66 6f72 6d61  at holds informa
│ │ │ │ -00033ab0: 7469 6f6e 2061 626f 7574 2041 5020 6578  tion about AP ex
│ │ │ │ -00033ac0: 6368 616e 6765 0a20 2020 2020 4f55 543a  change.     OUT:
│ │ │ │ -00033ad0: 206f 7574 7075 7420 6172 7261 7920 7468   output array th
│ │ │ │ -00033ae0: 6174 2068 6f6c 6473 2061 7574 6865 6e74  at holds authent
│ │ │ │ -00033af0: 6963 6174 6f72 2063 6865 636b 7375 6d20  icator checksum 
│ │ │ │ -00033b00: 6461 7461 2e0a 2020 2020 204c 454e 3a20  data..     LEN: 
│ │ │ │ -00033b10: 6f6e 2069 6e70 7574 2c20 6d61 7869 6d75  on input, maximu
│ │ │ │ -00033b20: 6d20 6c65 6e67 7468 206f 6620 6f75 7470  m length of outp
│ │ │ │ -00033b30: 7574 2061 7272 6179 2074 6861 7420 686f  ut array that ho
│ │ │ │ -00033b40: 6c64 730a 2020 2020 2061 7574 6865 6e74  lds.     authent
│ │ │ │ -00033b50: 6963 6174 6f72 2063 6865 636b 7375 6d20  icator checksum 
│ │ │ │ -00033b60: 6461 7461 2c20 6f6e 206f 7574 7075 7420  data, on output 
│ │ │ │ -00033b70: 6163 7475 616c 206c 656e 6774 6820 6f66  actual length of
│ │ │ │ -00033b80: 206f 7574 7075 740a 2020 2020 2061 7272   output.     arr
│ │ │ │ -00033b90: 6179 2074 6861 7420 686f 6c64 7320 6175  ay that holds au
│ │ │ │ -00033ba0: 7468 656e 7469 6361 746f 7220 6368 6563  thenticator chec
│ │ │ │ -00033bb0: 6b73 756d 2064 6174 612e 0a0a 2020 2020  ksum data...    
│ │ │ │ -00033bc0: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ -00033bd0: 4765 7420 6368 6563 6b73 756d 2064 6174  Get checksum dat
│ │ │ │ -00033be0: 6120 6672 6f6d 2041 7574 6865 6e74 6963  a from Authentic
│ │ │ │ -00033bf0: 6174 6f72 2e0a 0a20 2020 2020 2a52 6574  ator...     *Ret
│ │ │ │ -00033c00: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ -00033c10: 726e 7320 e280 9853 4849 5348 495f 4f4b  rns ...SHISHI_OK
│ │ │ │ -00033c20: e280 9920 6966 2073 7563 6365 7373 6675  ... if successfu
│ │ │ │ -00033c30: 6c2c 206f 720a 2020 2020 20e2 8098 5348  l, or.     ...SH
│ │ │ │ -00033c40: 4953 4849 5f54 4f4f 5f53 4d41 4c4c 5f42  ISHI_TOO_SMALL_B
│ │ │ │ -00033c50: 5546 4645 52e2 8099 2069 6620 6275 6666  UFFER... if buff
│ │ │ │ -00033c60: 6572 2070 726f 7669 6465 6420 7761 7320  er provided was 
│ │ │ │ -00033c70: 746f 6f20 736d 616c 6c20 2874 6865 6e0a  too small (then.
│ │ │ │ -00033c80: 2020 2020 204c 454e 2077 696c 6c20 686f       LEN will ho
│ │ │ │ -00033c90: 6c64 206e 6563 6573 7361 7279 2062 7566  ld necessary buf
│ │ │ │ -00033ca0: 6665 7220 7369 7a65 292e 0a0a 7368 6973  fer size)...shis
│ │ │ │ -00033cb0: 6869 5f61 705f 6175 7468 656e 7469 6361  hi_ap_authentica
│ │ │ │ -00033cc0: 746f 725f 636b 7375 6d64 6174 615f 7365  tor_cksumdata_se
│ │ │ │ -00033cd0: 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  t.--------------
│ │ │ │ +00033a20: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ +00033a30: 3a20 696e 7420 7368 6973 6869 5f61 705f  : int shishi_ap_
│ │ │ │ +00033a40: 6175 7468 656e 7469 6361 746f 725f 636b  authenticator_ck
│ │ │ │ +00033a50: 7375 6d64 6174 6120 2853 6869 7368 695f  sumdata (Shishi_
│ │ │ │ +00033a60: 6170 202a 2041 502c 0a20 2020 2020 2020  ap * AP,.       
│ │ │ │ +00033a70: 2020 2063 6861 7220 2a20 4f55 542c 2073     char * OUT, s
│ │ │ │ +00033a80: 697a 655f 7420 2a20 4c45 4e29 0a20 2020  ize_t * LEN).   
│ │ │ │ +00033a90: 2020 4150 3a20 7374 7275 6374 7572 6520    AP: structure 
│ │ │ │ +00033aa0: 7468 6174 2068 6f6c 6473 2069 6e66 6f72  that holds infor
│ │ │ │ +00033ab0: 6d61 7469 6f6e 2061 626f 7574 2041 5020  mation about AP 
│ │ │ │ +00033ac0: 6578 6368 616e 6765 0a20 2020 2020 4f55  exchange.     OU
│ │ │ │ +00033ad0: 543a 206f 7574 7075 7420 6172 7261 7920  T: output array 
│ │ │ │ +00033ae0: 7468 6174 2068 6f6c 6473 2061 7574 6865  that holds authe
│ │ │ │ +00033af0: 6e74 6963 6174 6f72 2063 6865 636b 7375  nticator checksu
│ │ │ │ +00033b00: 6d20 6461 7461 2e0a 2020 2020 204c 454e  m data..     LEN
│ │ │ │ +00033b10: 3a20 6f6e 2069 6e70 7574 2c20 6d61 7869  : on input, maxi
│ │ │ │ +00033b20: 6d75 6d20 6c65 6e67 7468 206f 6620 6f75  mum length of ou
│ │ │ │ +00033b30: 7470 7574 2061 7272 6179 2074 6861 7420  tput array that 
│ │ │ │ +00033b40: 686f 6c64 730a 2020 2020 2061 7574 6865  holds.     authe
│ │ │ │ +00033b50: 6e74 6963 6174 6f72 2063 6865 636b 7375  nticator checksu
│ │ │ │ +00033b60: 6d20 6461 7461 2c20 6f6e 206f 7574 7075  m data, on outpu
│ │ │ │ +00033b70: 7420 6163 7475 616c 206c 656e 6774 6820  t actual length 
│ │ │ │ +00033b80: 6f66 206f 7574 7075 740a 2020 2020 2061  of output.     a
│ │ │ │ +00033b90: 7272 6179 2074 6861 7420 686f 6c64 7320  rray that holds 
│ │ │ │ +00033ba0: 6175 7468 656e 7469 6361 746f 7220 6368  authenticator ch
│ │ │ │ +00033bb0: 6563 6b73 756d 2064 6174 612e 0a0a 2020  ecksum data...  
│ │ │ │ +00033bc0: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ +00033bd0: 2a20 4765 7420 6368 6563 6b73 756d 2064  * Get checksum d
│ │ │ │ +00033be0: 6174 6120 6672 6f6d 2041 7574 6865 6e74  ata from Authent
│ │ │ │ +00033bf0: 6963 6174 6f72 2e0a 0a20 2020 2020 2a52  icator...     *R
│ │ │ │ +00033c00: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +00033c10: 7475 726e 7320 e280 9853 4849 5348 495f  turns ...SHISHI_
│ │ │ │ +00033c20: 4f4b e280 9920 6966 2073 7563 6365 7373  OK... if success
│ │ │ │ +00033c30: 6675 6c2c 206f 720a 2020 2020 20e2 8098  ful, or.     ...
│ │ │ │ +00033c40: 5348 4953 4849 5f54 4f4f 5f53 4d41 4c4c  SHISHI_TOO_SMALL
│ │ │ │ +00033c50: 5f42 5546 4645 52e2 8099 2069 6620 6275  _BUFFER... if bu
│ │ │ │ +00033c60: 6666 6572 2070 726f 7669 6465 6420 7761  ffer provided wa
│ │ │ │ +00033c70: 7320 746f 6f20 736d 616c 6c20 2874 6865  s too small (the
│ │ │ │ +00033c80: 6e0a 2020 2020 204c 454e 2077 696c 6c20  n.     LEN will 
│ │ │ │ +00033c90: 686f 6c64 206e 6563 6573 7361 7279 2062  hold necessary b
│ │ │ │ +00033ca0: 7566 6665 7220 7369 7a65 292e 0a0a 7368  uffer size)...sh
│ │ │ │ +00033cb0: 6973 6869 5f61 705f 6175 7468 656e 7469  ishi_ap_authenti
│ │ │ │ +00033cc0: 6361 746f 725f 636b 7375 6d64 6174 615f  cator_cksumdata_
│ │ │ │ +00033cd0: 7365 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  set.------------
│ │ │ │  00033ce0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00033cf0: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ -00033d00: 6374 696f 6e3a 2076 6f69 6420 7368 6973  ction: void shis
│ │ │ │ -00033d10: 6869 5f61 705f 6175 7468 656e 7469 6361  hi_ap_authentica
│ │ │ │ -00033d20: 746f 725f 636b 7375 6d64 6174 615f 7365  tor_cksumdata_se
│ │ │ │ -00033d30: 740a 2020 2020 2020 2020 2020 2853 6869  t.          (Shi
│ │ │ │ -00033d40: 7368 695f 6170 202a 2041 502c 2063 6f6e  shi_ap * AP, con
│ │ │ │ -00033d50: 7374 2063 6861 7220 2a20 4155 5448 454e  st char * AUTHEN
│ │ │ │ -00033d60: 5449 4341 544f 5243 4b53 554d 4441 5441  TICATORCKSUMDATA
│ │ │ │ -00033d70: 2c0a 2020 2020 2020 2020 2020 7369 7a65  ,.          size
│ │ │ │ -00033d80: 5f74 2041 5554 4845 4e54 4943 4154 4f52  _t AUTHENTICATOR
│ │ │ │ -00033d90: 434b 5355 4d44 4154 414c 454e 290a 2020  CKSUMDATALEN).  
│ │ │ │ -00033da0: 2020 2041 503a 2073 7472 7563 7475 7265     AP: structure
│ │ │ │ -00033db0: 2074 6861 7420 686f 6c64 7320 696e 666f   that holds info
│ │ │ │ -00033dc0: 726d 6174 696f 6e20 6162 6f75 7420 4150  rmation about AP
│ │ │ │ -00033dd0: 2065 7863 6861 6e67 650a 2020 2020 2041   exchange.     A
│ │ │ │ -00033de0: 5554 4845 4e54 4943 4154 4f52 434b 5355  UTHENTICATORCKSU
│ │ │ │ -00033df0: 4d44 4154 413a 2069 6e70 7574 2061 7272  MDATA: input arr
│ │ │ │ -00033e00: 6179 2077 6974 6820 6461 7461 2074 6f20  ay with data to 
│ │ │ │ -00033e10: 636f 6d70 7574 6520 6368 6563 6b73 756d  compute checksum
│ │ │ │ -00033e20: 0a20 2020 2020 6f6e 2061 6e64 2073 746f  .     on and sto
│ │ │ │ -00033e30: 7265 2069 6e20 4175 7468 656e 7469 6361  re in Authentica
│ │ │ │ -00033e40: 746f 7220 696e 2041 502d 5245 512e 0a20  tor in AP-REQ.. 
│ │ │ │ -00033e50: 2020 2020 4155 5448 454e 5449 4341 544f      AUTHENTICATO
│ │ │ │ -00033e60: 5243 4b53 554d 4441 5441 4c45 4e3a 206c  RCKSUMDATALEN: l
│ │ │ │ -00033e70: 656e 6774 6820 6f66 2069 6e70 7574 2061  ength of input a
│ │ │ │ -00033e80: 7272 6179 2077 6974 6820 6461 7461 2074  rray with data t
│ │ │ │ -00033e90: 6f0a 2020 2020 2063 6f6d 7075 7465 2063  o.     compute c
│ │ │ │ -00033ea0: 6865 636b 7375 6d20 6f6e 2061 6e64 2073  hecksum on and s
│ │ │ │ -00033eb0: 746f 7265 2069 6e20 4175 7468 656e 7469  tore in Authenti
│ │ │ │ -00033ec0: 6361 746f 7220 696e 2041 502d 5245 512e  cator in AP-REQ.
│ │ │ │ -00033ed0: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ -00033ee0: 696f 6e3a 2a20 5365 7420 7468 6520 4175  ion:* Set the Au
│ │ │ │ -00033ef0: 7468 656e 7469 6361 746f 7220 4368 6563  thenticator Chec
│ │ │ │ -00033f00: 6b73 756d 2044 6174 6120 696e 2074 6865  ksum Data in the
│ │ │ │ -00033f10: 2041 500a 2020 2020 2065 7863 6861 6e67   AP.     exchang
│ │ │ │ -00033f20: 652e 2020 5468 6973 2069 7320 7468 6520  e.  This is the 
│ │ │ │ -00033f30: 6461 7461 2074 6861 7420 7769 6c6c 2062  data that will b
│ │ │ │ -00033f40: 6520 6368 6563 6b73 756d 6564 2c20 616e  e checksumed, an
│ │ │ │ -00033f50: 6420 7468 650a 2020 2020 2063 6865 636b  d the.     check
│ │ │ │ -00033f60: 7375 6d20 706c 6163 6564 2069 6e20 7468  sum placed in th
│ │ │ │ -00033f70: 6520 6368 6563 6b73 756d 2066 6965 6c64  e checksum field
│ │ │ │ -00033f80: 2e20 2049 7420 6973 206e 6f74 2074 6865  .  It is not the
│ │ │ │ -00033f90: 2061 6374 7561 6c0a 2020 2020 2063 6865   actual.     che
│ │ │ │ -00033fa0: 636b 7375 6d20 6669 656c 642e 2020 5365  cksum field.  Se
│ │ │ │ -00033fb0: 6520 616c 736f 2073 6869 7368 695f 6170  e also shishi_ap
│ │ │ │ -00033fc0: 5f61 7574 6865 6e74 6963 6174 6f72 5f63  _authenticator_c
│ │ │ │ -00033fd0: 6b73 756d 7261 775f 7365 742e 0a0a 7368  ksumraw_set...sh
│ │ │ │ -00033fe0: 6973 6869 5f61 705f 6175 7468 656e 7469  ishi_ap_authenti
│ │ │ │ -00033ff0: 6361 746f 725f 636b 7375 6d72 6177 5f73  cator_cksumraw_s
│ │ │ │ -00034000: 6574 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  et.-------------
│ │ │ │ +00033cf0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +00033d00: 756e 6374 696f 6e3a 2076 6f69 6420 7368  unction: void sh
│ │ │ │ +00033d10: 6973 6869 5f61 705f 6175 7468 656e 7469  ishi_ap_authenti
│ │ │ │ +00033d20: 6361 746f 725f 636b 7375 6d64 6174 615f  cator_cksumdata_
│ │ │ │ +00033d30: 7365 740a 2020 2020 2020 2020 2020 2853  set.          (S
│ │ │ │ +00033d40: 6869 7368 695f 6170 202a 2041 502c 2063  hishi_ap * AP, c
│ │ │ │ +00033d50: 6f6e 7374 2063 6861 7220 2a20 4155 5448  onst char * AUTH
│ │ │ │ +00033d60: 454e 5449 4341 544f 5243 4b53 554d 4441  ENTICATORCKSUMDA
│ │ │ │ +00033d70: 5441 2c0a 2020 2020 2020 2020 2020 7369  TA,.          si
│ │ │ │ +00033d80: 7a65 5f74 2041 5554 4845 4e54 4943 4154  ze_t AUTHENTICAT
│ │ │ │ +00033d90: 4f52 434b 5355 4d44 4154 414c 454e 290a  ORCKSUMDATALEN).
│ │ │ │ +00033da0: 2020 2020 2041 503a 2073 7472 7563 7475       AP: structu
│ │ │ │ +00033db0: 7265 2074 6861 7420 686f 6c64 7320 696e  re that holds in
│ │ │ │ +00033dc0: 666f 726d 6174 696f 6e20 6162 6f75 7420  formation about 
│ │ │ │ +00033dd0: 4150 2065 7863 6861 6e67 650a 2020 2020  AP exchange.    
│ │ │ │ +00033de0: 2041 5554 4845 4e54 4943 4154 4f52 434b   AUTHENTICATORCK
│ │ │ │ +00033df0: 5355 4d44 4154 413a 2069 6e70 7574 2061  SUMDATA: input a
│ │ │ │ +00033e00: 7272 6179 2077 6974 6820 6461 7461 2074  rray with data t
│ │ │ │ +00033e10: 6f20 636f 6d70 7574 6520 6368 6563 6b73  o compute checks
│ │ │ │ +00033e20: 756d 0a20 2020 2020 6f6e 2061 6e64 2073  um.     on and s
│ │ │ │ +00033e30: 746f 7265 2069 6e20 4175 7468 656e 7469  tore in Authenti
│ │ │ │ +00033e40: 6361 746f 7220 696e 2041 502d 5245 512e  cator in AP-REQ.
│ │ │ │ +00033e50: 0a20 2020 2020 4155 5448 454e 5449 4341  .     AUTHENTICA
│ │ │ │ +00033e60: 544f 5243 4b53 554d 4441 5441 4c45 4e3a  TORCKSUMDATALEN:
│ │ │ │ +00033e70: 206c 656e 6774 6820 6f66 2069 6e70 7574   length of input
│ │ │ │ +00033e80: 2061 7272 6179 2077 6974 6820 6461 7461   array with data
│ │ │ │ +00033e90: 2074 6f0a 2020 2020 2063 6f6d 7075 7465   to.     compute
│ │ │ │ +00033ea0: 2063 6865 636b 7375 6d20 6f6e 2061 6e64   checksum on and
│ │ │ │ +00033eb0: 2073 746f 7265 2069 6e20 4175 7468 656e   store in Authen
│ │ │ │ +00033ec0: 7469 6361 746f 7220 696e 2041 502d 5245  ticator in AP-RE
│ │ │ │ +00033ed0: 512e 0a0a 2020 2020 202a 4465 7363 7269  Q...     *Descri
│ │ │ │ +00033ee0: 7074 696f 6e3a 2a20 5365 7420 7468 6520  ption:* Set the 
│ │ │ │ +00033ef0: 4175 7468 656e 7469 6361 746f 7220 4368  Authenticator Ch
│ │ │ │ +00033f00: 6563 6b73 756d 2044 6174 6120 696e 2074  ecksum Data in t
│ │ │ │ +00033f10: 6865 2041 500a 2020 2020 2065 7863 6861  he AP.     excha
│ │ │ │ +00033f20: 6e67 652e 2020 5468 6973 2069 7320 7468  nge.  This is th
│ │ │ │ +00033f30: 6520 6461 7461 2074 6861 7420 7769 6c6c  e data that will
│ │ │ │ +00033f40: 2062 6520 6368 6563 6b73 756d 6564 2c20   be checksumed, 
│ │ │ │ +00033f50: 616e 6420 7468 650a 2020 2020 2063 6865  and the.     che
│ │ │ │ +00033f60: 636b 7375 6d20 706c 6163 6564 2069 6e20  cksum placed in 
│ │ │ │ +00033f70: 7468 6520 6368 6563 6b73 756d 2066 6965  the checksum fie
│ │ │ │ +00033f80: 6c64 2e20 2049 7420 6973 206e 6f74 2074  ld.  It is not t
│ │ │ │ +00033f90: 6865 2061 6374 7561 6c0a 2020 2020 2063  he actual.     c
│ │ │ │ +00033fa0: 6865 636b 7375 6d20 6669 656c 642e 2020  hecksum field.  
│ │ │ │ +00033fb0: 5365 6520 616c 736f 2073 6869 7368 695f  See also shishi_
│ │ │ │ +00033fc0: 6170 5f61 7574 6865 6e74 6963 6174 6f72  ap_authenticator
│ │ │ │ +00033fd0: 5f63 6b73 756d 7261 775f 7365 742e 0a0a  _cksumraw_set...
│ │ │ │ +00033fe0: 7368 6973 6869 5f61 705f 6175 7468 656e  shishi_ap_authen
│ │ │ │ +00033ff0: 7469 6361 746f 725f 636b 7375 6d72 6177  ticator_cksumraw
│ │ │ │ +00034000: 5f73 6574 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  _set.-----------
│ │ │ │  00034010: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00034020: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ -00034030: 6374 696f 6e3a 2076 6f69 6420 7368 6973  ction: void shis
│ │ │ │ -00034040: 6869 5f61 705f 6175 7468 656e 7469 6361  hi_ap_authentica
│ │ │ │ -00034050: 746f 725f 636b 7375 6d72 6177 5f73 6574  tor_cksumraw_set
│ │ │ │ -00034060: 2028 5368 6973 6869 5f61 7020 2a20 4150   (Shishi_ap * AP
│ │ │ │ -00034070: 2c0a 2020 2020 2020 2020 2020 696e 7433  ,.          int3
│ │ │ │ -00034080: 325f 7420 4155 5448 454e 5449 4341 544f  2_t AUTHENTICATO
│ │ │ │ -00034090: 5243 4b53 554d 5459 5045 2c0a 2020 2020  RCKSUMTYPE,.    
│ │ │ │ -000340a0: 2020 2020 2020 636f 6e73 7420 6368 6172        const char
│ │ │ │ -000340b0: 202a 2041 5554 4845 4e54 4943 4154 4f52   * AUTHENTICATOR
│ │ │ │ -000340c0: 434b 5355 4d52 4157 2c0a 2020 2020 2020  CKSUMRAW,.      
│ │ │ │ -000340d0: 2020 2020 7369 7a65 5f74 2041 5554 4845      size_t AUTHE
│ │ │ │ -000340e0: 4e54 4943 4154 4f52 434b 5355 4d52 4157  NTICATORCKSUMRAW
│ │ │ │ -000340f0: 4c45 4e29 0a20 2020 2020 4150 3a20 7374  LEN).     AP: st
│ │ │ │ -00034100: 7275 6374 7572 6520 7468 6174 2068 6f6c  ructure that hol
│ │ │ │ -00034110: 6473 2069 6e66 6f72 6d61 7469 6f6e 2061  ds information a
│ │ │ │ -00034120: 626f 7574 2041 5020 6578 6368 616e 6765  bout AP exchange
│ │ │ │ -00034130: 0a20 2020 2020 4155 5448 454e 5449 4341  .     AUTHENTICA
│ │ │ │ -00034140: 544f 5243 4b53 554d 5459 5045 3a20 6175  TORCKSUMTYPE: au
│ │ │ │ -00034150: 7468 656e 7469 6361 746f 7220 6368 6563  thenticator chec
│ │ │ │ -00034160: 6b73 756d 2074 7970 6520 746f 2073 6574  ksum type to set
│ │ │ │ -00034170: 2069 6e20 4150 2e0a 2020 2020 2041 5554   in AP..     AUT
│ │ │ │ -00034180: 4845 4e54 4943 4154 4f52 434b 5355 4d52  HENTICATORCKSUMR
│ │ │ │ -00034190: 4157 3a20 696e 7075 7420 6172 7261 7920  AW: input array 
│ │ │ │ -000341a0: 7769 7468 2061 7574 6865 6e74 6963 6174  with authenticat
│ │ │ │ -000341b0: 6f72 2063 6865 636b 7375 6d0a 2020 2020  or checksum.    
│ │ │ │ -000341c0: 2066 6965 6c64 2076 616c 7565 2074 6f20   field value to 
│ │ │ │ -000341d0: 7365 7420 696e 2041 7574 6865 6e74 6963  set in Authentic
│ │ │ │ -000341e0: 6174 6f72 2069 6e20 4150 2d52 4551 2e0a  ator in AP-REQ..
│ │ │ │ -000341f0: 2020 2020 2041 5554 4845 4e54 4943 4154       AUTHENTICAT
│ │ │ │ -00034200: 4f52 434b 5355 4d52 4157 4c45 4e3a 206c  ORCKSUMRAWLEN: l
│ │ │ │ -00034210: 656e 6774 6820 6f66 2069 6e70 7574 2061  ength of input a
│ │ │ │ -00034220: 7272 6179 2077 6974 6820 6175 7468 656e  rray with authen
│ │ │ │ -00034230: 7469 6361 746f 720a 2020 2020 2063 6865  ticator.     che
│ │ │ │ -00034240: 636b 7375 6d20 6669 656c 6420 7661 6c75  cksum field valu
│ │ │ │ -00034250: 6520 746f 2073 6574 2069 6e20 4175 7468  e to set in Auth
│ │ │ │ -00034260: 656e 7469 6361 746f 7220 696e 2041 502d  enticator in AP-
│ │ │ │ -00034270: 5245 512e 0a0a 2020 2020 202a 4465 7363  REQ...     *Desc
│ │ │ │ -00034280: 7269 7074 696f 6e3a 2a20 5365 7420 7468  ription:* Set th
│ │ │ │ -00034290: 6520 4175 7468 656e 7469 6361 746f 7220  e Authenticator 
│ │ │ │ -000342a0: 4368 6563 6b73 756d 2044 6174 6120 696e  Checksum Data in
│ │ │ │ -000342b0: 2074 6865 2041 500a 2020 2020 2065 7863   the AP.     exc
│ │ │ │ -000342c0: 6861 6e67 652e 2020 5468 6973 2069 7320  hange.  This is 
│ │ │ │ -000342d0: 7468 6520 6163 7475 616c 2063 6865 636b  the actual check
│ │ │ │ -000342e0: 7375 6d20 6669 656c 642c 206e 6f74 2064  sum field, not d
│ │ │ │ -000342f0: 6174 6120 746f 2063 6f6d 7075 7465 0a20  ata to compute. 
│ │ │ │ -00034300: 2020 2020 6368 6563 6b73 756d 206f 6e20      checksum on 
│ │ │ │ -00034310: 616e 6420 7468 656e 2073 746f 7265 2069  and then store i
│ │ │ │ -00034320: 6e20 7468 6520 6368 6563 6b73 756d 2066  n the checksum f
│ │ │ │ -00034330: 6965 6c64 2e20 2053 6565 2061 6c73 6f0a  ield.  See also.
│ │ │ │ -00034340: 2020 2020 2073 6869 7368 695f 6170 5f61       shishi_ap_a
│ │ │ │ -00034350: 7574 6865 6e74 6963 6174 6f72 5f63 6b73  uthenticator_cks
│ │ │ │ -00034360: 756d 6461 7461 5f73 6574 2e0a 0a73 6869  umdata_set...shi
│ │ │ │ -00034370: 7368 695f 6170 5f61 7574 6865 6e74 6963  shi_ap_authentic
│ │ │ │ -00034380: 6174 6f72 5f63 6b73 756d 7479 7065 0a2d  ator_cksumtype.-
│ │ │ │ -00034390: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +00034020: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +00034030: 756e 6374 696f 6e3a 2076 6f69 6420 7368  unction: void sh
│ │ │ │ +00034040: 6973 6869 5f61 705f 6175 7468 656e 7469  ishi_ap_authenti
│ │ │ │ +00034050: 6361 746f 725f 636b 7375 6d72 6177 5f73  cator_cksumraw_s
│ │ │ │ +00034060: 6574 2028 5368 6973 6869 5f61 7020 2a20  et (Shishi_ap * 
│ │ │ │ +00034070: 4150 2c0a 2020 2020 2020 2020 2020 696e  AP,.          in
│ │ │ │ +00034080: 7433 325f 7420 4155 5448 454e 5449 4341  t32_t AUTHENTICA
│ │ │ │ +00034090: 544f 5243 4b53 554d 5459 5045 2c0a 2020  TORCKSUMTYPE,.  
│ │ │ │ +000340a0: 2020 2020 2020 2020 636f 6e73 7420 6368          const ch
│ │ │ │ +000340b0: 6172 202a 2041 5554 4845 4e54 4943 4154  ar * AUTHENTICAT
│ │ │ │ +000340c0: 4f52 434b 5355 4d52 4157 2c0a 2020 2020  ORCKSUMRAW,.    
│ │ │ │ +000340d0: 2020 2020 2020 7369 7a65 5f74 2041 5554        size_t AUT
│ │ │ │ +000340e0: 4845 4e54 4943 4154 4f52 434b 5355 4d52  HENTICATORCKSUMR
│ │ │ │ +000340f0: 4157 4c45 4e29 0a20 2020 2020 4150 3a20  AWLEN).     AP: 
│ │ │ │ +00034100: 7374 7275 6374 7572 6520 7468 6174 2068  structure that h
│ │ │ │ +00034110: 6f6c 6473 2069 6e66 6f72 6d61 7469 6f6e  olds information
│ │ │ │ +00034120: 2061 626f 7574 2041 5020 6578 6368 616e   about AP exchan
│ │ │ │ +00034130: 6765 0a20 2020 2020 4155 5448 454e 5449  ge.     AUTHENTI
│ │ │ │ +00034140: 4341 544f 5243 4b53 554d 5459 5045 3a20  CATORCKSUMTYPE: 
│ │ │ │ +00034150: 6175 7468 656e 7469 6361 746f 7220 6368  authenticator ch
│ │ │ │ +00034160: 6563 6b73 756d 2074 7970 6520 746f 2073  ecksum type to s
│ │ │ │ +00034170: 6574 2069 6e20 4150 2e0a 2020 2020 2041  et in AP..     A
│ │ │ │ +00034180: 5554 4845 4e54 4943 4154 4f52 434b 5355  UTHENTICATORCKSU
│ │ │ │ +00034190: 4d52 4157 3a20 696e 7075 7420 6172 7261  MRAW: input arra
│ │ │ │ +000341a0: 7920 7769 7468 2061 7574 6865 6e74 6963  y with authentic
│ │ │ │ +000341b0: 6174 6f72 2063 6865 636b 7375 6d0a 2020  ator checksum.  
│ │ │ │ +000341c0: 2020 2066 6965 6c64 2076 616c 7565 2074     field value t
│ │ │ │ +000341d0: 6f20 7365 7420 696e 2041 7574 6865 6e74  o set in Authent
│ │ │ │ +000341e0: 6963 6174 6f72 2069 6e20 4150 2d52 4551  icator in AP-REQ
│ │ │ │ +000341f0: 2e0a 2020 2020 2041 5554 4845 4e54 4943  ..     AUTHENTIC
│ │ │ │ +00034200: 4154 4f52 434b 5355 4d52 4157 4c45 4e3a  ATORCKSUMRAWLEN:
│ │ │ │ +00034210: 206c 656e 6774 6820 6f66 2069 6e70 7574   length of input
│ │ │ │ +00034220: 2061 7272 6179 2077 6974 6820 6175 7468   array with auth
│ │ │ │ +00034230: 656e 7469 6361 746f 720a 2020 2020 2063  enticator.     c
│ │ │ │ +00034240: 6865 636b 7375 6d20 6669 656c 6420 7661  hecksum field va
│ │ │ │ +00034250: 6c75 6520 746f 2073 6574 2069 6e20 4175  lue to set in Au
│ │ │ │ +00034260: 7468 656e 7469 6361 746f 7220 696e 2041  thenticator in A
│ │ │ │ +00034270: 502d 5245 512e 0a0a 2020 2020 202a 4465  P-REQ...     *De
│ │ │ │ +00034280: 7363 7269 7074 696f 6e3a 2a20 5365 7420  scription:* Set 
│ │ │ │ +00034290: 7468 6520 4175 7468 656e 7469 6361 746f  the Authenticato
│ │ │ │ +000342a0: 7220 4368 6563 6b73 756d 2044 6174 6120  r Checksum Data 
│ │ │ │ +000342b0: 696e 2074 6865 2041 500a 2020 2020 2065  in the AP.     e
│ │ │ │ +000342c0: 7863 6861 6e67 652e 2020 5468 6973 2069  xchange.  This i
│ │ │ │ +000342d0: 7320 7468 6520 6163 7475 616c 2063 6865  s the actual che
│ │ │ │ +000342e0: 636b 7375 6d20 6669 656c 642c 206e 6f74  cksum field, not
│ │ │ │ +000342f0: 2064 6174 6120 746f 2063 6f6d 7075 7465   data to compute
│ │ │ │ +00034300: 0a20 2020 2020 6368 6563 6b73 756d 206f  .     checksum o
│ │ │ │ +00034310: 6e20 616e 6420 7468 656e 2073 746f 7265  n and then store
│ │ │ │ +00034320: 2069 6e20 7468 6520 6368 6563 6b73 756d   in the checksum
│ │ │ │ +00034330: 2066 6965 6c64 2e20 2053 6565 2061 6c73   field.  See als
│ │ │ │ +00034340: 6f0a 2020 2020 2073 6869 7368 695f 6170  o.     shishi_ap
│ │ │ │ +00034350: 5f61 7574 6865 6e74 6963 6174 6f72 5f63  _authenticator_c
│ │ │ │ +00034360: 6b73 756d 6461 7461 5f73 6574 2e0a 0a73  ksumdata_set...s
│ │ │ │ +00034370: 6869 7368 695f 6170 5f61 7574 6865 6e74  hishi_ap_authent
│ │ │ │ +00034380: 6963 6174 6f72 5f63 6b73 756d 7479 7065  icator_cksumtype
│ │ │ │ +00034390: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │  000343a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000343b0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ -000343c0: 696e 7433 325f 7420 7368 6973 6869 5f61  int32_t shishi_a
│ │ │ │ -000343d0: 705f 6175 7468 656e 7469 6361 746f 725f  p_authenticator_
│ │ │ │ -000343e0: 636b 7375 6d74 7970 6520 2853 6869 7368  cksumtype (Shish
│ │ │ │ -000343f0: 695f 6170 202a 2041 5029 0a20 2020 2020  i_ap * AP).     
│ │ │ │ -00034400: 4150 3a20 7374 7275 6374 7572 6520 7468  AP: structure th
│ │ │ │ -00034410: 6174 2068 6f6c 6473 2069 6e66 6f72 6d61  at holds informa
│ │ │ │ -00034420: 7469 6f6e 2061 626f 7574 2041 5020 6578  tion about AP ex
│ │ │ │ -00034430: 6368 616e 6765 0a0a 2020 2020 202a 4465  change..     *De
│ │ │ │ -00034440: 7363 7269 7074 696f 6e3a 2a20 4765 7420  scription:* Get 
│ │ │ │ -00034450: 7468 6520 4175 7468 656e 7469 6361 746f  the Authenticato
│ │ │ │ -00034460: 7220 4368 6563 6b73 756d 2054 7970 6520  r Checksum Type 
│ │ │ │ -00034470: 696e 2074 6865 2041 500a 2020 2020 2065  in the AP.     e
│ │ │ │ -00034480: 7863 6861 6e67 652e 0a0a 2020 2020 202a  xchange...     *
│ │ │ │ -00034490: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ -000344a0: 6574 7572 6e20 7468 6520 6175 7468 656e  eturn the authen
│ │ │ │ -000344b0: 7469 6361 746f 7220 6368 6563 6b73 756d  ticator checksum
│ │ │ │ -000344c0: 2074 7970 652e 0a0a 7368 6973 6869 5f61   type...shishi_a
│ │ │ │ -000344d0: 705f 6175 7468 656e 7469 6361 746f 725f  p_authenticator_
│ │ │ │ -000344e0: 636b 7375 6d74 7970 655f 7365 740a 2d2d  cksumtype_set.--
│ │ │ │ +000343b0: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ +000343c0: 3a20 696e 7433 325f 7420 7368 6973 6869  : int32_t shishi
│ │ │ │ +000343d0: 5f61 705f 6175 7468 656e 7469 6361 746f  _ap_authenticato
│ │ │ │ +000343e0: 725f 636b 7375 6d74 7970 6520 2853 6869  r_cksumtype (Shi
│ │ │ │ +000343f0: 7368 695f 6170 202a 2041 5029 0a20 2020  shi_ap * AP).   
│ │ │ │ +00034400: 2020 4150 3a20 7374 7275 6374 7572 6520    AP: structure 
│ │ │ │ +00034410: 7468 6174 2068 6f6c 6473 2069 6e66 6f72  that holds infor
│ │ │ │ +00034420: 6d61 7469 6f6e 2061 626f 7574 2041 5020  mation about AP 
│ │ │ │ +00034430: 6578 6368 616e 6765 0a0a 2020 2020 202a  exchange..     *
│ │ │ │ +00034440: 4465 7363 7269 7074 696f 6e3a 2a20 4765  Description:* Ge
│ │ │ │ +00034450: 7420 7468 6520 4175 7468 656e 7469 6361  t the Authentica
│ │ │ │ +00034460: 746f 7220 4368 6563 6b73 756d 2054 7970  tor Checksum Typ
│ │ │ │ +00034470: 6520 696e 2074 6865 2041 500a 2020 2020  e in the AP.    
│ │ │ │ +00034480: 2065 7863 6861 6e67 652e 0a0a 2020 2020   exchange...    
│ │ │ │ +00034490: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ +000344a0: 2052 6574 7572 6e20 7468 6520 6175 7468   Return the auth
│ │ │ │ +000344b0: 656e 7469 6361 746f 7220 6368 6563 6b73  enticator checks
│ │ │ │ +000344c0: 756d 2074 7970 652e 0a0a 7368 6973 6869  um type...shishi
│ │ │ │ +000344d0: 5f61 705f 6175 7468 656e 7469 6361 746f  _ap_authenticato
│ │ │ │ +000344e0: 725f 636b 7375 6d74 7970 655f 7365 740a  r_cksumtype_set.
│ │ │ │  000344f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │  00034500: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00034510: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ -00034520: 6e3a 2076 6f69 6420 7368 6973 6869 5f61  n: void shishi_a
│ │ │ │ -00034530: 705f 6175 7468 656e 7469 6361 746f 725f  p_authenticator_
│ │ │ │ -00034540: 636b 7375 6d74 7970 655f 7365 740a 2020  cksumtype_set.  
│ │ │ │ -00034550: 2020 2020 2020 2020 2853 6869 7368 695f          (Shishi_
│ │ │ │ -00034560: 6170 202a 2041 502c 2069 6e74 3332 5f74  ap * AP, int32_t
│ │ │ │ -00034570: 2043 4b53 554d 5459 5045 290a 2020 2020   CKSUMTYPE).    
│ │ │ │ -00034580: 2041 503a 2073 7472 7563 7475 7265 2074   AP: structure t
│ │ │ │ -00034590: 6861 7420 686f 6c64 7320 696e 666f 726d  hat holds inform
│ │ │ │ -000345a0: 6174 696f 6e20 6162 6f75 7420 4150 2065  ation about AP e
│ │ │ │ -000345b0: 7863 6861 6e67 650a 2020 2020 2043 4b53  xchange.     CKS
│ │ │ │ -000345c0: 554d 5459 5045 3a20 6175 7468 656e 7469  UMTYPE: authenti
│ │ │ │ -000345d0: 6361 746f 7220 6368 6563 6b73 756d 2074  cator checksum t
│ │ │ │ -000345e0: 7970 6520 746f 2073 6574 2069 6e20 4150  ype to set in AP
│ │ │ │ -000345f0: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ -00034600: 7469 6f6e 3a2a 2053 6574 2074 6865 2041  tion:* Set the A
│ │ │ │ -00034610: 7574 6865 6e74 6963 6174 6f72 2043 6865  uthenticator Che
│ │ │ │ -00034620: 636b 7375 6d20 5479 7065 2069 6e20 7468  cksum Type in th
│ │ │ │ -00034630: 6520 4150 0a20 2020 2020 6578 6368 616e  e AP.     exchan
│ │ │ │ -00034640: 6765 2e0a 0a73 6869 7368 695f 6170 5f61  ge...shishi_ap_a
│ │ │ │ -00034650: 7574 6865 6e74 6963 6174 6f72 0a2d 2d2d  uthenticator.---
│ │ │ │ +00034510: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +00034520: 696f 6e3a 2076 6f69 6420 7368 6973 6869  ion: void shishi
│ │ │ │ +00034530: 5f61 705f 6175 7468 656e 7469 6361 746f  _ap_authenticato
│ │ │ │ +00034540: 725f 636b 7375 6d74 7970 655f 7365 740a  r_cksumtype_set.
│ │ │ │ +00034550: 2020 2020 2020 2020 2020 2853 6869 7368            (Shish
│ │ │ │ +00034560: 695f 6170 202a 2041 502c 2069 6e74 3332  i_ap * AP, int32
│ │ │ │ +00034570: 5f74 2043 4b53 554d 5459 5045 290a 2020  _t CKSUMTYPE).  
│ │ │ │ +00034580: 2020 2041 503a 2073 7472 7563 7475 7265     AP: structure
│ │ │ │ +00034590: 2074 6861 7420 686f 6c64 7320 696e 666f   that holds info
│ │ │ │ +000345a0: 726d 6174 696f 6e20 6162 6f75 7420 4150  rmation about AP
│ │ │ │ +000345b0: 2065 7863 6861 6e67 650a 2020 2020 2043   exchange.     C
│ │ │ │ +000345c0: 4b53 554d 5459 5045 3a20 6175 7468 656e  KSUMTYPE: authen
│ │ │ │ +000345d0: 7469 6361 746f 7220 6368 6563 6b73 756d  ticator checksum
│ │ │ │ +000345e0: 2074 7970 6520 746f 2073 6574 2069 6e20   type to set in 
│ │ │ │ +000345f0: 4150 2e0a 0a20 2020 2020 2a44 6573 6372  AP...     *Descr
│ │ │ │ +00034600: 6970 7469 6f6e 3a2a 2053 6574 2074 6865  iption:* Set the
│ │ │ │ +00034610: 2041 7574 6865 6e74 6963 6174 6f72 2043   Authenticator C
│ │ │ │ +00034620: 6865 636b 7375 6d20 5479 7065 2069 6e20  hecksum Type in 
│ │ │ │ +00034630: 7468 6520 4150 0a20 2020 2020 6578 6368  the AP.     exch
│ │ │ │ +00034640: 616e 6765 2e0a 0a73 6869 7368 695f 6170  ange...shishi_ap
│ │ │ │ +00034650: 5f61 7574 6865 6e74 6963 6174 6f72 0a2d  _authenticator.-
│ │ │ │  00034660: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00034670: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -00034680: 6f6e 3a20 5368 6973 6869 5f61 736e 3120  on: Shishi_asn1 
│ │ │ │ -00034690: 7368 6973 6869 5f61 705f 6175 7468 656e  shishi_ap_authen
│ │ │ │ -000346a0: 7469 6361 746f 7220 2853 6869 7368 695f  ticator (Shishi_
│ │ │ │ -000346b0: 6170 202a 2041 5029 0a20 2020 2020 4150  ap * AP).     AP
│ │ │ │ -000346c0: 3a20 7374 7275 6374 7572 6520 7468 6174  : structure that
│ │ │ │ -000346d0: 2068 6f6c 6473 2069 6e66 6f72 6d61 7469   holds informati
│ │ │ │ -000346e0: 6f6e 2061 626f 7574 2041 5020 6578 6368  on about AP exch
│ │ │ │ -000346f0: 616e 6765 0a0a 2020 2020 202a 4465 7363  ange..     *Desc
│ │ │ │ -00034700: 7269 7074 696f 6e3a 2a20 4765 7420 4153  ription:* Get AS
│ │ │ │ -00034710: 4e2e 3120 4175 7468 656e 7469 6361 746f  N.1 Authenticato
│ │ │ │ -00034720: 7220 7374 7275 6374 7572 6520 6672 6f6d  r structure from
│ │ │ │ -00034730: 2041 5020 6578 6368 616e 6765 2e0a 0a20   AP exchange... 
│ │ │ │ -00034740: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ -00034750: 653a 2a20 5265 7475 726e 7320 7468 6520  e:* Returns the 
│ │ │ │ -00034760: 4175 7468 656e 7469 6361 746f 7220 6672  Authenticator fr
│ │ │ │ -00034770: 6f6d 2074 6865 2041 5020 6578 6368 616e  om the AP exchan
│ │ │ │ -00034780: 6765 2c20 6f72 0a20 2020 2020 4e55 4c4c  ge, or.     NULL
│ │ │ │ -00034790: 2069 6620 6e6f 7420 7965 7420 7365 7420   if not yet set 
│ │ │ │ -000347a0: 6f72 2061 6e20 6572 726f 7220 6f63 6375  or an error occu
│ │ │ │ -000347b0: 7265 642e 0a0a 7368 6973 6869 5f61 705f  red...shishi_ap_
│ │ │ │ -000347c0: 6175 7468 656e 7469 6361 746f 725f 7365  authenticator_se
│ │ │ │ -000347d0: 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  t.--------------
│ │ │ │ -000347e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -000347f0: 2d2d 2046 756e 6374 696f 6e3a 2076 6f69  -- Function: voi
│ │ │ │ -00034800: 6420 7368 6973 6869 5f61 705f 6175 7468  d shishi_ap_auth
│ │ │ │ -00034810: 656e 7469 6361 746f 725f 7365 7420 2853  enticator_set (S
│ │ │ │ -00034820: 6869 7368 695f 6170 202a 2041 502c 0a20  hishi_ap * AP,. 
│ │ │ │ -00034830: 2020 2020 2020 2020 2053 6869 7368 695f           Shishi_
│ │ │ │ -00034840: 6173 6e31 2041 5554 4845 4e54 4943 4154  asn1 AUTHENTICAT
│ │ │ │ -00034850: 4f52 290a 2020 2020 2041 503a 2073 7472  OR).     AP: str
│ │ │ │ -00034860: 7563 7475 7265 2074 6861 7420 686f 6c64  ucture that hold
│ │ │ │ -00034870: 7320 696e 666f 726d 6174 696f 6e20 6162  s information ab
│ │ │ │ -00034880: 6f75 7420 4150 2065 7863 6861 6e67 650a  out AP exchange.
│ │ │ │ -00034890: 2020 2020 2041 5554 4845 4e54 4943 4154       AUTHENTICAT
│ │ │ │ -000348a0: 4f52 3a20 6175 7468 656e 7469 6361 746f  OR: authenticato
│ │ │ │ -000348b0: 7220 746f 2073 746f 7265 2069 6e20 4150  r to store in AP
│ │ │ │ -000348c0: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ -000348d0: 7469 6f6e 3a2a 2053 6574 2074 6865 2041  tion:* Set the A
│ │ │ │ -000348e0: 7574 6865 6e74 6963 6174 6f72 2069 6e20  uthenticator in 
│ │ │ │ -000348f0: 7468 6520 4150 2065 7863 6861 6e67 652e  the AP exchange.
│ │ │ │ -00034900: 0a0a 7368 6973 6869 5f61 705f 7265 710a  ..shishi_ap_req.
│ │ │ │ -00034910: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -00034920: 2d2d 2046 756e 6374 696f 6e3a 2053 6869  -- Function: Shi
│ │ │ │ -00034930: 7368 695f 6173 6e31 2073 6869 7368 695f  shi_asn1 shishi_
│ │ │ │ -00034940: 6170 5f72 6571 2028 5368 6973 6869 5f61  ap_req (Shishi_a
│ │ │ │ -00034950: 7020 2a20 4150 290a 2020 2020 2041 503a  p * AP).     AP:
│ │ │ │ -00034960: 2073 7472 7563 7475 7265 2074 6861 7420   structure that 
│ │ │ │ -00034970: 686f 6c64 7320 696e 666f 726d 6174 696f  holds informatio
│ │ │ │ -00034980: 6e20 6162 6f75 7420 4150 2065 7863 6861  n about AP excha
│ │ │ │ -00034990: 6e67 650a 0a20 2020 2020 2a44 6573 6372  nge..     *Descr
│ │ │ │ -000349a0: 6970 7469 6f6e 3a2a 2047 6574 2041 534e  iption:* Get ASN
│ │ │ │ -000349b0: 2e31 2041 502d 5245 5120 7374 7275 6374  .1 AP-REQ struct
│ │ │ │ -000349c0: 7572 6520 6672 6f6d 2041 5020 6578 6368  ure from AP exch
│ │ │ │ -000349d0: 616e 6765 2e0a 0a20 2020 2020 2a52 6574  ange...     *Ret
│ │ │ │ -000349e0: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ -000349f0: 726e 7320 7468 6520 4150 2d52 4551 2066  rns the AP-REQ f
│ │ │ │ -00034a00: 726f 6d20 7468 6520 4150 2065 7863 6861  rom the AP excha
│ │ │ │ -00034a10: 6e67 652c 206f 7220 4e55 4c4c 2069 660a  nge, or NULL if.
│ │ │ │ -00034a20: 2020 2020 206e 6f74 2079 6574 2073 6574       not yet set
│ │ │ │ -00034a30: 206f 7220 616e 2065 7272 6f72 206f 6363   or an error occ
│ │ │ │ -00034a40: 7572 6564 2e0a 0a73 6869 7368 695f 6170  ured...shishi_ap
│ │ │ │ -00034a50: 5f72 6571 5f73 6574 0a2d 2d2d 2d2d 2d2d  _req_set.-------
│ │ │ │ -00034a60: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ -00034a70: 4675 6e63 7469 6f6e 3a20 766f 6964 2073  Function: void s
│ │ │ │ -00034a80: 6869 7368 695f 6170 5f72 6571 5f73 6574  hishi_ap_req_set
│ │ │ │ -00034a90: 2028 5368 6973 6869 5f61 7020 2a20 4150   (Shishi_ap * AP
│ │ │ │ -00034aa0: 2c20 5368 6973 6869 5f61 736e 3120 4150  , Shishi_asn1 AP
│ │ │ │ -00034ab0: 5245 5129 0a20 2020 2020 4150 3a20 7374  REQ).     AP: st
│ │ │ │ -00034ac0: 7275 6374 7572 6520 7468 6174 2068 6f6c  ructure that hol
│ │ │ │ -00034ad0: 6473 2069 6e66 6f72 6d61 7469 6f6e 2061  ds information a
│ │ │ │ -00034ae0: 626f 7574 2041 5020 6578 6368 616e 6765  bout AP exchange
│ │ │ │ -00034af0: 0a20 2020 2020 4150 5245 513a 2061 7072  .     APREQ: apr
│ │ │ │ -00034b00: 6571 2074 6f20 7374 6f72 6520 696e 2041  eq to store in A
│ │ │ │ -00034b10: 502e 0a0a 2020 2020 202a 4465 7363 7269  P...     *Descri
│ │ │ │ -00034b20: 7074 696f 6e3a 2a20 5365 7420 7468 6520  ption:* Set the 
│ │ │ │ -00034b30: 4150 2d52 4551 2069 6e20 7468 6520 4150  AP-REQ in the AP
│ │ │ │ -00034b40: 2065 7863 6861 6e67 652e 0a0a 7368 6973   exchange...shis
│ │ │ │ -00034b50: 6869 5f61 705f 7265 715f 6465 720a 2d2d  hi_ap_req_der.--
│ │ │ │ -00034b60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -00034b70: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ -00034b80: 6e74 2073 6869 7368 695f 6170 5f72 6571  nt shishi_ap_req
│ │ │ │ -00034b90: 5f64 6572 2028 5368 6973 6869 5f61 7020  _der (Shishi_ap 
│ │ │ │ -00034ba0: 2a20 4150 2c20 6368 6172 202a 2a20 4f55  * AP, char ** OU
│ │ │ │ -00034bb0: 542c 0a20 2020 2020 2020 2020 2073 697a  T,.          siz
│ │ │ │ -00034bc0: 655f 7420 2a20 4f55 544c 454e 290a 2020  e_t * OUTLEN).  
│ │ │ │ -00034bd0: 2020 2041 503a 2073 7472 7563 7475 7265     AP: structure
│ │ │ │ -00034be0: 2074 6861 7420 686f 6c64 7320 696e 666f   that holds info
│ │ │ │ -00034bf0: 726d 6174 696f 6e20 6162 6f75 7420 4150  rmation about AP
│ │ │ │ -00034c00: 2065 7863 6861 6e67 650a 2020 2020 204f   exchange.     O
│ │ │ │ -00034c10: 5554 3a20 706f 696e 7465 7220 746f 206f  UT: pointer to o
│ │ │ │ -00034c20: 7574 7075 7420 6172 7261 7920 7769 7468  utput array with
│ │ │ │ -00034c30: 2064 6572 2065 6e63 6f64 696e 6720 6f66   der encoding of
│ │ │ │ -00034c40: 2041 502d 5245 512e 0a20 2020 2020 4f55   AP-REQ..     OU
│ │ │ │ -00034c50: 544c 454e 3a20 706f 696e 7465 7220 746f  TLEN: pointer to
│ │ │ │ -00034c60: 206c 656e 6774 6820 6f66 206f 7574 7075   length of outpu
│ │ │ │ -00034c70: 7420 6172 7261 7920 7769 7468 2064 6572  t array with der
│ │ │ │ -00034c80: 2065 6e63 6f64 696e 6720 6f66 0a20 2020   encoding of.   
│ │ │ │ -00034c90: 2020 4150 2d52 4551 2e0a 0a20 2020 2020    AP-REQ...     
│ │ │ │ -00034ca0: 2a44 6573 6372 6970 7469 6f6e 3a2a 2042  *Description:* B
│ │ │ │ -00034cb0: 7569 6c64 2041 502d 5245 5120 7573 696e  uild AP-REQ usin
│ │ │ │ -00034cc0: 6720 e280 9873 6869 7368 695f 6170 5f72  g ...shishi_ap_r
│ │ │ │ -00034cd0: 6571 5f62 7569 6c64 2829 e280 9920 616e  eq_build()... an
│ │ │ │ -00034ce0: 6420 4445 520a 2020 2020 2065 6e63 6f64  d DER.     encod
│ │ │ │ -00034cf0: 6520 6974 2e20 204f 5554 2069 7320 616c  e it.  OUT is al
│ │ │ │ -00034d00: 6c6f 6361 7465 6420 6279 2074 6869 7320  located by this 
│ │ │ │ -00034d10: 6675 6e63 7469 6f6e 2c20 616e 6420 6974  function, and it
│ │ │ │ -00034d20: 2069 7320 7468 650a 2020 2020 2072 6573   is the.     res
│ │ │ │ -00034d30: 706f 6e73 6962 696c 6974 7920 6f66 2063  ponsibility of c
│ │ │ │ -00034d40: 616c 6c65 7220 746f 2064 6561 6c6c 6f63  aller to dealloc
│ │ │ │ -00034d50: 6174 6520 6974 2e0a 0a20 2020 2020 2a52  ate it...     *R
│ │ │ │ -00034d60: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ -00034d70: 7475 726e 7320 5348 4953 4849 5f4f 4b20  turns SHISHI_OK 
│ │ │ │ -00034d80: 6966 6620 7375 6363 6573 7366 756c 2e0a  iff successful..
│ │ │ │ -00034d90: 0a73 6869 7368 695f 6170 5f72 6571 5f64  .shishi_ap_req_d
│ │ │ │ -00034da0: 6572 5f73 6574 0a2d 2d2d 2d2d 2d2d 2d2d  er_set.---------
│ │ │ │ -00034db0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ -00034dc0: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ -00034dd0: 7368 6973 6869 5f61 705f 7265 715f 6465  shishi_ap_req_de
│ │ │ │ -00034de0: 725f 7365 7420 2853 6869 7368 695f 6170  r_set (Shishi_ap
│ │ │ │ -00034df0: 202a 2041 502c 2063 6861 7220 2a20 4445   * AP, char * DE
│ │ │ │ -00034e00: 522c 0a20 2020 2020 2020 2020 2073 697a  R,.          siz
│ │ │ │ -00034e10: 655f 7420 4445 524c 454e 290a 2020 2020  e_t DERLEN).    
│ │ │ │ -00034e20: 2041 503a 2073 7472 7563 7475 7265 2074   AP: structure t
│ │ │ │ -00034e30: 6861 7420 686f 6c64 7320 696e 666f 726d  hat holds inform
│ │ │ │ -00034e40: 6174 696f 6e20 6162 6f75 7420 4150 2065  ation about AP e
│ │ │ │ -00034e50: 7863 6861 6e67 650a 2020 2020 2044 4552  xchange.     DER
│ │ │ │ -00034e60: 3a20 696e 7075 7420 6172 7261 7920 7769  : input array wi
│ │ │ │ -00034e70: 7468 2044 4552 2065 6e63 6f64 6564 2041  th DER encoded A
│ │ │ │ -00034e80: 502d 5245 512e 0a20 2020 2020 4445 524c  P-REQ..     DERL
│ │ │ │ -00034e90: 454e 3a20 6c65 6e67 7468 206f 6620 696e  EN: length of in
│ │ │ │ -00034ea0: 7075 7420 6172 7261 7920 7769 7468 2044  put array with D
│ │ │ │ -00034eb0: 4552 2065 6e63 6f64 6564 2041 502d 5245  ER encoded AP-RE
│ │ │ │ -00034ec0: 512e 0a0a 2020 2020 202a 4465 7363 7269  Q...     *Descri
│ │ │ │ -00034ed0: 7074 696f 6e3a 2a20 4445 5220 6465 636f  ption:* DER deco
│ │ │ │ -00034ee0: 6465 2041 502d 5245 5120 616e 6420 7365  de AP-REQ and se
│ │ │ │ -00034ef0: 7420 6974 2041 5020 6578 6368 616e 6765  t it AP exchange
│ │ │ │ -00034f00: 2e20 2049 660a 2020 2020 2064 6563 6f64  .  If.     decod
│ │ │ │ -00034f10: 696e 6720 6661 696c 732c 2074 6865 2041  ing fails, the A
│ │ │ │ -00034f20: 502d 5245 5120 696e 2074 6865 2041 5020  P-REQ in the AP 
│ │ │ │ -00034f30: 6578 6368 616e 6765 2069 7320 6c6f 7374  exchange is lost
│ │ │ │ -00034f40: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ -00034f50: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ -00034f60: 5348 4953 4849 5f4f 4b2e 0a0a 7368 6973  SHISHI_OK...shis
│ │ │ │ -00034f70: 6869 5f61 705f 7265 715f 6275 696c 640a  hi_ap_req_build.
│ │ │ │ -00034f80: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00034f90: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ -00034fa0: 6e3a 2069 6e74 2073 6869 7368 695f 6170  n: int shishi_ap
│ │ │ │ -00034fb0: 5f72 6571 5f62 7569 6c64 2028 5368 6973  _req_build (Shis
│ │ │ │ -00034fc0: 6869 5f61 7020 2a20 4150 290a 2020 2020  hi_ap * AP).    
│ │ │ │ -00034fd0: 2041 503a 2073 7472 7563 7475 7265 2074   AP: structure t
│ │ │ │ -00034fe0: 6861 7420 686f 6c64 7320 696e 666f 726d  hat holds inform
│ │ │ │ -00034ff0: 6174 696f 6e20 6162 6f75 7420 4150 2065  ation about AP e
│ │ │ │ -00035000: 7863 6861 6e67 650a 0a20 2020 2020 2a44  xchange..     *D
│ │ │ │ -00035010: 6573 6372 6970 7469 6f6e 3a2a 2043 6865  escription:* Che
│ │ │ │ -00035020: 636b 7375 6d20 6461 7461 2069 6e20 6175  cksum data in au
│ │ │ │ -00035030: 7468 656e 7469 6361 746f 7220 616e 6420  thenticator and 
│ │ │ │ -00035040: 6164 6420 7469 636b 6574 2061 6e64 0a20  add ticket and. 
│ │ │ │ -00035050: 2020 2020 6175 7468 656e 7469 6361 746f      authenticato
│ │ │ │ -00035060: 7220 746f 2041 502d 5245 512e 0a0a 2020  r to AP-REQ...  
│ │ │ │ -00035070: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ -00035080: 3a2a 2052 6574 7572 6e73 2053 4849 5348  :* Returns SHISH
│ │ │ │ -00035090: 495f 4f4b 2069 6666 2073 7563 6365 7373  I_OK iff success
│ │ │ │ -000350a0: 6675 6c2e 0a0a 7368 6973 6869 5f61 705f  ful...shishi_ap_
│ │ │ │ -000350b0: 7265 715f 6465 636f 6465 0a2d 2d2d 2d2d  req_decode.-----
│ │ │ │ -000350c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -000350d0: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ -000350e0: 6e74 2073 6869 7368 695f 6170 5f72 6571  nt shishi_ap_req
│ │ │ │ -000350f0: 5f64 6563 6f64 6520 2853 6869 7368 695f  _decode (Shishi_
│ │ │ │ -00035100: 6170 202a 2041 5029 0a20 2020 2020 4150  ap * AP).     AP
│ │ │ │ -00035110: 3a20 7374 7275 6374 7572 6520 7468 6174  : structure that
│ │ │ │ -00035120: 2068 6f6c 6473 2069 6e66 6f72 6d61 7469   holds informati
│ │ │ │ -00035130: 6f6e 2061 626f 7574 2041 5020 6578 6368  on about AP exch
│ │ │ │ -00035140: 616e 6765 0a0a 2020 2020 202a 4465 7363  ange..     *Desc
│ │ │ │ -00035150: 7269 7074 696f 6e3a 2a20 4465 636f 6465  ription:* Decode
│ │ │ │ -00035160: 2074 6963 6b65 7420 696e 2041 502d 5245   ticket in AP-RE
│ │ │ │ -00035170: 5120 616e 6420 7365 7420 7468 6520 5469  Q and set the Ti
│ │ │ │ -00035180: 636b 6574 2066 6965 6c64 7320 696e 0a20  cket fields in. 
│ │ │ │ -00035190: 2020 2020 7468 6520 4150 2065 7863 6861      the AP excha
│ │ │ │ -000351a0: 6e67 652e 0a0a 2020 2020 202a 5265 7475  nge...     *Retu
│ │ │ │ -000351b0: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ -000351c0: 6e73 2053 4849 5348 495f 4f4b 2069 6666  ns SHISHI_OK iff
│ │ │ │ -000351d0: 2073 7563 6365 7373 6675 6c2e 0a0a 7368   successful...sh
│ │ │ │ -000351e0: 6973 6869 5f61 705f 7265 715f 7072 6f63  ishi_ap_req_proc
│ │ │ │ -000351f0: 6573 735f 6b65 7975 7361 6765 0a2d 2d2d  ess_keyusage.---
│ │ │ │ +00034670: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ +00034680: 7469 6f6e 3a20 5368 6973 6869 5f61 736e  tion: Shishi_asn
│ │ │ │ +00034690: 3120 7368 6973 6869 5f61 705f 6175 7468  1 shishi_ap_auth
│ │ │ │ +000346a0: 656e 7469 6361 746f 7220 2853 6869 7368  enticator (Shish
│ │ │ │ +000346b0: 695f 6170 202a 2041 5029 0a20 2020 2020  i_ap * AP).     
│ │ │ │ +000346c0: 4150 3a20 7374 7275 6374 7572 6520 7468  AP: structure th
│ │ │ │ +000346d0: 6174 2068 6f6c 6473 2069 6e66 6f72 6d61  at holds informa
│ │ │ │ +000346e0: 7469 6f6e 2061 626f 7574 2041 5020 6578  tion about AP ex
│ │ │ │ +000346f0: 6368 616e 6765 0a0a 2020 2020 202a 4465  change..     *De
│ │ │ │ +00034700: 7363 7269 7074 696f 6e3a 2a20 4765 7420  scription:* Get 
│ │ │ │ +00034710: 4153 4e2e 3120 4175 7468 656e 7469 6361  ASN.1 Authentica
│ │ │ │ +00034720: 746f 7220 7374 7275 6374 7572 6520 6672  tor structure fr
│ │ │ │ +00034730: 6f6d 2041 5020 6578 6368 616e 6765 2e0a  om AP exchange..
│ │ │ │ +00034740: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ +00034750: 6c75 653a 2a20 5265 7475 726e 7320 7468  lue:* Returns th
│ │ │ │ +00034760: 6520 4175 7468 656e 7469 6361 746f 7220  e Authenticator 
│ │ │ │ +00034770: 6672 6f6d 2074 6865 2041 5020 6578 6368  from the AP exch
│ │ │ │ +00034780: 616e 6765 2c20 6f72 0a20 2020 2020 4e55  ange, or.     NU
│ │ │ │ +00034790: 4c4c 2069 6620 6e6f 7420 7965 7420 7365  LL if not yet se
│ │ │ │ +000347a0: 7420 6f72 2061 6e20 6572 726f 7220 6f63  t or an error oc
│ │ │ │ +000347b0: 6375 7265 642e 0a0a 7368 6973 6869 5f61  cured...shishi_a
│ │ │ │ +000347c0: 705f 6175 7468 656e 7469 6361 746f 725f  p_authenticator_
│ │ │ │ +000347d0: 7365 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  set.------------
│ │ │ │ +000347e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +000347f0: 0a20 2d2d 2046 756e 6374 696f 6e3a 2076  . -- Function: v
│ │ │ │ +00034800: 6f69 6420 7368 6973 6869 5f61 705f 6175  oid shishi_ap_au
│ │ │ │ +00034810: 7468 656e 7469 6361 746f 725f 7365 7420  thenticator_set 
│ │ │ │ +00034820: 2853 6869 7368 695f 6170 202a 2041 502c  (Shishi_ap * AP,
│ │ │ │ +00034830: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ +00034840: 695f 6173 6e31 2041 5554 4845 4e54 4943  i_asn1 AUTHENTIC
│ │ │ │ +00034850: 4154 4f52 290a 2020 2020 2041 503a 2073  ATOR).     AP: s
│ │ │ │ +00034860: 7472 7563 7475 7265 2074 6861 7420 686f  tructure that ho
│ │ │ │ +00034870: 6c64 7320 696e 666f 726d 6174 696f 6e20  lds information 
│ │ │ │ +00034880: 6162 6f75 7420 4150 2065 7863 6861 6e67  about AP exchang
│ │ │ │ +00034890: 650a 2020 2020 2041 5554 4845 4e54 4943  e.     AUTHENTIC
│ │ │ │ +000348a0: 4154 4f52 3a20 6175 7468 656e 7469 6361  ATOR: authentica
│ │ │ │ +000348b0: 746f 7220 746f 2073 746f 7265 2069 6e20  tor to store in 
│ │ │ │ +000348c0: 4150 2e0a 0a20 2020 2020 2a44 6573 6372  AP...     *Descr
│ │ │ │ +000348d0: 6970 7469 6f6e 3a2a 2053 6574 2074 6865  iption:* Set the
│ │ │ │ +000348e0: 2041 7574 6865 6e74 6963 6174 6f72 2069   Authenticator i
│ │ │ │ +000348f0: 6e20 7468 6520 4150 2065 7863 6861 6e67  n the AP exchang
│ │ │ │ +00034900: 652e 0a0a 7368 6973 6869 5f61 705f 7265  e...shishi_ap_re
│ │ │ │ +00034910: 710a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  q.-------------.
│ │ │ │ +00034920: 0a20 2d2d 2046 756e 6374 696f 6e3a 2053  . -- Function: S
│ │ │ │ +00034930: 6869 7368 695f 6173 6e31 2073 6869 7368  hishi_asn1 shish
│ │ │ │ +00034940: 695f 6170 5f72 6571 2028 5368 6973 6869  i_ap_req (Shishi
│ │ │ │ +00034950: 5f61 7020 2a20 4150 290a 2020 2020 2041  _ap * AP).     A
│ │ │ │ +00034960: 503a 2073 7472 7563 7475 7265 2074 6861  P: structure tha
│ │ │ │ +00034970: 7420 686f 6c64 7320 696e 666f 726d 6174  t holds informat
│ │ │ │ +00034980: 696f 6e20 6162 6f75 7420 4150 2065 7863  ion about AP exc
│ │ │ │ +00034990: 6861 6e67 650a 0a20 2020 2020 2a44 6573  hange..     *Des
│ │ │ │ +000349a0: 6372 6970 7469 6f6e 3a2a 2047 6574 2041  cription:* Get A
│ │ │ │ +000349b0: 534e 2e31 2041 502d 5245 5120 7374 7275  SN.1 AP-REQ stru
│ │ │ │ +000349c0: 6374 7572 6520 6672 6f6d 2041 5020 6578  cture from AP ex
│ │ │ │ +000349d0: 6368 616e 6765 2e0a 0a20 2020 2020 2a52  change...     *R
│ │ │ │ +000349e0: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +000349f0: 7475 726e 7320 7468 6520 4150 2d52 4551  turns the AP-REQ
│ │ │ │ +00034a00: 2066 726f 6d20 7468 6520 4150 2065 7863   from the AP exc
│ │ │ │ +00034a10: 6861 6e67 652c 206f 7220 4e55 4c4c 2069  hange, or NULL i
│ │ │ │ +00034a20: 660a 2020 2020 206e 6f74 2079 6574 2073  f.     not yet s
│ │ │ │ +00034a30: 6574 206f 7220 616e 2065 7272 6f72 206f  et or an error o
│ │ │ │ +00034a40: 6363 7572 6564 2e0a 0a73 6869 7368 695f  ccured...shishi_
│ │ │ │ +00034a50: 6170 5f72 6571 5f73 6574 0a2d 2d2d 2d2d  ap_req_set.-----
│ │ │ │ +00034a60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ +00034a70: 2d20 4675 6e63 7469 6f6e 3a20 766f 6964  - Function: void
│ │ │ │ +00034a80: 2073 6869 7368 695f 6170 5f72 6571 5f73   shishi_ap_req_s
│ │ │ │ +00034a90: 6574 2028 5368 6973 6869 5f61 7020 2a20  et (Shishi_ap * 
│ │ │ │ +00034aa0: 4150 2c20 5368 6973 6869 5f61 736e 3120  AP, Shishi_asn1 
│ │ │ │ +00034ab0: 4150 5245 5129 0a20 2020 2020 4150 3a20  APREQ).     AP: 
│ │ │ │ +00034ac0: 7374 7275 6374 7572 6520 7468 6174 2068  structure that h
│ │ │ │ +00034ad0: 6f6c 6473 2069 6e66 6f72 6d61 7469 6f6e  olds information
│ │ │ │ +00034ae0: 2061 626f 7574 2041 5020 6578 6368 616e   about AP exchan
│ │ │ │ +00034af0: 6765 0a20 2020 2020 4150 5245 513a 2061  ge.     APREQ: a
│ │ │ │ +00034b00: 7072 6571 2074 6f20 7374 6f72 6520 696e  preq to store in
│ │ │ │ +00034b10: 2041 502e 0a0a 2020 2020 202a 4465 7363   AP...     *Desc
│ │ │ │ +00034b20: 7269 7074 696f 6e3a 2a20 5365 7420 7468  ription:* Set th
│ │ │ │ +00034b30: 6520 4150 2d52 4551 2069 6e20 7468 6520  e AP-REQ in the 
│ │ │ │ +00034b40: 4150 2065 7863 6861 6e67 652e 0a0a 7368  AP exchange...sh
│ │ │ │ +00034b50: 6973 6869 5f61 705f 7265 715f 6465 720a  ishi_ap_req_der.
│ │ │ │ +00034b60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +00034b70: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ +00034b80: 2069 6e74 2073 6869 7368 695f 6170 5f72   int shishi_ap_r
│ │ │ │ +00034b90: 6571 5f64 6572 2028 5368 6973 6869 5f61  eq_der (Shishi_a
│ │ │ │ +00034ba0: 7020 2a20 4150 2c20 6368 6172 202a 2a20  p * AP, char ** 
│ │ │ │ +00034bb0: 4f55 542c 0a20 2020 2020 2020 2020 2073  OUT,.          s
│ │ │ │ +00034bc0: 697a 655f 7420 2a20 4f55 544c 454e 290a  ize_t * OUTLEN).
│ │ │ │ +00034bd0: 2020 2020 2041 503a 2073 7472 7563 7475       AP: structu
│ │ │ │ +00034be0: 7265 2074 6861 7420 686f 6c64 7320 696e  re that holds in
│ │ │ │ +00034bf0: 666f 726d 6174 696f 6e20 6162 6f75 7420  formation about 
│ │ │ │ +00034c00: 4150 2065 7863 6861 6e67 650a 2020 2020  AP exchange.    
│ │ │ │ +00034c10: 204f 5554 3a20 706f 696e 7465 7220 746f   OUT: pointer to
│ │ │ │ +00034c20: 206f 7574 7075 7420 6172 7261 7920 7769   output array wi
│ │ │ │ +00034c30: 7468 2064 6572 2065 6e63 6f64 696e 6720  th der encoding 
│ │ │ │ +00034c40: 6f66 2041 502d 5245 512e 0a20 2020 2020  of AP-REQ..     
│ │ │ │ +00034c50: 4f55 544c 454e 3a20 706f 696e 7465 7220  OUTLEN: pointer 
│ │ │ │ +00034c60: 746f 206c 656e 6774 6820 6f66 206f 7574  to length of out
│ │ │ │ +00034c70: 7075 7420 6172 7261 7920 7769 7468 2064  put array with d
│ │ │ │ +00034c80: 6572 2065 6e63 6f64 696e 6720 6f66 0a20  er encoding of. 
│ │ │ │ +00034c90: 2020 2020 4150 2d52 4551 2e0a 0a20 2020      AP-REQ...   
│ │ │ │ +00034ca0: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ +00034cb0: 2042 7569 6c64 2041 502d 5245 5120 7573   Build AP-REQ us
│ │ │ │ +00034cc0: 696e 6720 e280 9873 6869 7368 695f 6170  ing ...shishi_ap
│ │ │ │ +00034cd0: 5f72 6571 5f62 7569 6c64 2829 e280 9920  _req_build()... 
│ │ │ │ +00034ce0: 616e 6420 4445 520a 2020 2020 2065 6e63  and DER.     enc
│ │ │ │ +00034cf0: 6f64 6520 6974 2e20 204f 5554 2069 7320  ode it.  OUT is 
│ │ │ │ +00034d00: 616c 6c6f 6361 7465 6420 6279 2074 6869  allocated by thi
│ │ │ │ +00034d10: 7320 6675 6e63 7469 6f6e 2c20 616e 6420  s function, and 
│ │ │ │ +00034d20: 6974 2069 7320 7468 650a 2020 2020 2072  it is the.     r
│ │ │ │ +00034d30: 6573 706f 6e73 6962 696c 6974 7920 6f66  esponsibility of
│ │ │ │ +00034d40: 2063 616c 6c65 7220 746f 2064 6561 6c6c   caller to deall
│ │ │ │ +00034d50: 6f63 6174 6520 6974 2e0a 0a20 2020 2020  ocate it...     
│ │ │ │ +00034d60: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ +00034d70: 5265 7475 726e 7320 5348 4953 4849 5f4f  Returns SHISHI_O
│ │ │ │ +00034d80: 4b20 6966 6620 7375 6363 6573 7366 756c  K iff successful
│ │ │ │ +00034d90: 2e0a 0a73 6869 7368 695f 6170 5f72 6571  ...shishi_ap_req
│ │ │ │ +00034da0: 5f64 6572 5f73 6574 0a2d 2d2d 2d2d 2d2d  _der_set.-------
│ │ │ │ +00034db0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ +00034dc0: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ +00034dd0: 7420 7368 6973 6869 5f61 705f 7265 715f  t shishi_ap_req_
│ │ │ │ +00034de0: 6465 725f 7365 7420 2853 6869 7368 695f  der_set (Shishi_
│ │ │ │ +00034df0: 6170 202a 2041 502c 2063 6861 7220 2a20  ap * AP, char * 
│ │ │ │ +00034e00: 4445 522c 0a20 2020 2020 2020 2020 2073  DER,.          s
│ │ │ │ +00034e10: 697a 655f 7420 4445 524c 454e 290a 2020  ize_t DERLEN).  
│ │ │ │ +00034e20: 2020 2041 503a 2073 7472 7563 7475 7265     AP: structure
│ │ │ │ +00034e30: 2074 6861 7420 686f 6c64 7320 696e 666f   that holds info
│ │ │ │ +00034e40: 726d 6174 696f 6e20 6162 6f75 7420 4150  rmation about AP
│ │ │ │ +00034e50: 2065 7863 6861 6e67 650a 2020 2020 2044   exchange.     D
│ │ │ │ +00034e60: 4552 3a20 696e 7075 7420 6172 7261 7920  ER: input array 
│ │ │ │ +00034e70: 7769 7468 2044 4552 2065 6e63 6f64 6564  with DER encoded
│ │ │ │ +00034e80: 2041 502d 5245 512e 0a20 2020 2020 4445   AP-REQ..     DE
│ │ │ │ +00034e90: 524c 454e 3a20 6c65 6e67 7468 206f 6620  RLEN: length of 
│ │ │ │ +00034ea0: 696e 7075 7420 6172 7261 7920 7769 7468  input array with
│ │ │ │ +00034eb0: 2044 4552 2065 6e63 6f64 6564 2041 502d   DER encoded AP-
│ │ │ │ +00034ec0: 5245 512e 0a0a 2020 2020 202a 4465 7363  REQ...     *Desc
│ │ │ │ +00034ed0: 7269 7074 696f 6e3a 2a20 4445 5220 6465  ription:* DER de
│ │ │ │ +00034ee0: 636f 6465 2041 502d 5245 5120 616e 6420  code AP-REQ and 
│ │ │ │ +00034ef0: 7365 7420 6974 2041 5020 6578 6368 616e  set it AP exchan
│ │ │ │ +00034f00: 6765 2e20 2049 660a 2020 2020 2064 6563  ge.  If.     dec
│ │ │ │ +00034f10: 6f64 696e 6720 6661 696c 732c 2074 6865  oding fails, the
│ │ │ │ +00034f20: 2041 502d 5245 5120 696e 2074 6865 2041   AP-REQ in the A
│ │ │ │ +00034f30: 5020 6578 6368 616e 6765 2069 7320 6c6f  P exchange is lo
│ │ │ │ +00034f40: 7374 2e0a 0a20 2020 2020 2a52 6574 7572  st...     *Retur
│ │ │ │ +00034f50: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ +00034f60: 7320 5348 4953 4849 5f4f 4b2e 0a0a 7368  s SHISHI_OK...sh
│ │ │ │ +00034f70: 6973 6869 5f61 705f 7265 715f 6275 696c  ishi_ap_req_buil
│ │ │ │ +00034f80: 640a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  d.--------------
│ │ │ │ +00034f90: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +00034fa0: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ +00034fb0: 6170 5f72 6571 5f62 7569 6c64 2028 5368  ap_req_build (Sh
│ │ │ │ +00034fc0: 6973 6869 5f61 7020 2a20 4150 290a 2020  ishi_ap * AP).  
│ │ │ │ +00034fd0: 2020 2041 503a 2073 7472 7563 7475 7265     AP: structure
│ │ │ │ +00034fe0: 2074 6861 7420 686f 6c64 7320 696e 666f   that holds info
│ │ │ │ +00034ff0: 726d 6174 696f 6e20 6162 6f75 7420 4150  rmation about AP
│ │ │ │ +00035000: 2065 7863 6861 6e67 650a 0a20 2020 2020   exchange..     
│ │ │ │ +00035010: 2a44 6573 6372 6970 7469 6f6e 3a2a 2043  *Description:* C
│ │ │ │ +00035020: 6865 636b 7375 6d20 6461 7461 2069 6e20  hecksum data in 
│ │ │ │ +00035030: 6175 7468 656e 7469 6361 746f 7220 616e  authenticator an
│ │ │ │ +00035040: 6420 6164 6420 7469 636b 6574 2061 6e64  d add ticket and
│ │ │ │ +00035050: 0a20 2020 2020 6175 7468 656e 7469 6361  .     authentica
│ │ │ │ +00035060: 746f 7220 746f 2041 502d 5245 512e 0a0a  tor to AP-REQ...
│ │ │ │ +00035070: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ +00035080: 7565 3a2a 2052 6574 7572 6e73 2053 4849  ue:* Returns SHI
│ │ │ │ +00035090: 5348 495f 4f4b 2069 6666 2073 7563 6365  SHI_OK iff succe
│ │ │ │ +000350a0: 7373 6675 6c2e 0a0a 7368 6973 6869 5f61  ssful...shishi_a
│ │ │ │ +000350b0: 705f 7265 715f 6465 636f 6465 0a2d 2d2d  p_req_decode.---
│ │ │ │ +000350c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +000350d0: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ +000350e0: 2069 6e74 2073 6869 7368 695f 6170 5f72   int shishi_ap_r
│ │ │ │ +000350f0: 6571 5f64 6563 6f64 6520 2853 6869 7368  eq_decode (Shish
│ │ │ │ +00035100: 695f 6170 202a 2041 5029 0a20 2020 2020  i_ap * AP).     
│ │ │ │ +00035110: 4150 3a20 7374 7275 6374 7572 6520 7468  AP: structure th
│ │ │ │ +00035120: 6174 2068 6f6c 6473 2069 6e66 6f72 6d61  at holds informa
│ │ │ │ +00035130: 7469 6f6e 2061 626f 7574 2041 5020 6578  tion about AP ex
│ │ │ │ +00035140: 6368 616e 6765 0a0a 2020 2020 202a 4465  change..     *De
│ │ │ │ +00035150: 7363 7269 7074 696f 6e3a 2a20 4465 636f  scription:* Deco
│ │ │ │ +00035160: 6465 2074 6963 6b65 7420 696e 2041 502d  de ticket in AP-
│ │ │ │ +00035170: 5245 5120 616e 6420 7365 7420 7468 6520  REQ and set the 
│ │ │ │ +00035180: 5469 636b 6574 2066 6965 6c64 7320 696e  Ticket fields in
│ │ │ │ +00035190: 0a20 2020 2020 7468 6520 4150 2065 7863  .     the AP exc
│ │ │ │ +000351a0: 6861 6e67 652e 0a0a 2020 2020 202a 5265  hange...     *Re
│ │ │ │ +000351b0: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ +000351c0: 7572 6e73 2053 4849 5348 495f 4f4b 2069  urns SHISHI_OK i
│ │ │ │ +000351d0: 6666 2073 7563 6365 7373 6675 6c2e 0a0a  ff successful...
│ │ │ │ +000351e0: 7368 6973 6869 5f61 705f 7265 715f 7072  shishi_ap_req_pr
│ │ │ │ +000351f0: 6f63 6573 735f 6b65 7975 7361 6765 0a2d  ocess_keyusage.-
│ │ │ │  00035200: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00035210: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ -00035220: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ -00035230: 6869 7368 695f 6170 5f72 6571 5f70 726f  hishi_ap_req_pro
│ │ │ │ -00035240: 6365 7373 5f6b 6579 7573 6167 6520 2853  cess_keyusage (S
│ │ │ │ -00035250: 6869 7368 695f 6170 202a 2041 502c 0a20  hishi_ap * AP,. 
│ │ │ │ -00035260: 2020 2020 2020 2020 2053 6869 7368 695f           Shishi_
│ │ │ │ -00035270: 6b65 7920 2a20 4b45 592c 2069 6e74 3332  key * KEY, int32
│ │ │ │ -00035280: 5f74 204b 4559 5553 4147 4529 0a20 2020  _t KEYUSAGE).   
│ │ │ │ -00035290: 2020 4150 3a20 7374 7275 6374 7572 6520    AP: structure 
│ │ │ │ -000352a0: 7468 6174 2068 6f6c 6473 2069 6e66 6f72  that holds infor
│ │ │ │ -000352b0: 6d61 7469 6f6e 2061 626f 7574 2041 5020  mation about AP 
│ │ │ │ -000352c0: 6578 6368 616e 6765 0a20 2020 2020 4b45  exchange.     KE
│ │ │ │ -000352d0: 593a 2063 7279 7074 6f67 7261 7068 6963  Y: cryptographic
│ │ │ │ -000352e0: 206b 6579 2075 7365 6420 746f 2064 6563   key used to dec
│ │ │ │ -000352f0: 7279 7074 2074 6963 6b65 7420 696e 2041  rypt ticket in A
│ │ │ │ -00035300: 502d 5245 512e 0a20 2020 2020 4b45 5955  P-REQ..     KEYU
│ │ │ │ -00035310: 5341 4745 3a20 6b65 7920 7573 6167 6520  SAGE: key usage 
│ │ │ │ -00035320: 746f 2075 7365 2064 7572 696e 6720 6465  to use during de
│ │ │ │ -00035330: 6372 7970 7469 6f6e 2c20 666f 7220 6e6f  cryption, for no
│ │ │ │ -00035340: 726d 616c 2041 502d 5245 5127 730a 2020  rmal AP-REQ's.  
│ │ │ │ -00035350: 2020 2074 6869 7320 6973 206e 6f72 6d61     this is norma
│ │ │ │ -00035360: 6c6c 7920 5348 4953 4849 5f4b 4559 5553  lly SHISHI_KEYUS
│ │ │ │ -00035370: 4147 455f 4150 5245 515f 4155 5448 454e  AGE_APREQ_AUTHEN
│ │ │ │ -00035380: 5449 4341 544f 522c 2066 6f72 2041 502d  TICATOR, for AP-
│ │ │ │ -00035390: 5245 5127 730a 2020 2020 2070 6172 7420  REQ's.     part 
│ │ │ │ -000353a0: 6f66 2054 4753 2d52 4551 2773 2c20 7468  of TGS-REQ's, th
│ │ │ │ -000353b0: 6973 2069 7320 6e6f 726d 616c 6c79 0a20  is is normally. 
│ │ │ │ -000353c0: 2020 2020 5348 4953 4849 5f4b 4559 5553      SHISHI_KEYUS
│ │ │ │ -000353d0: 4147 455f 5447 5352 4551 5f41 5052 4551  AGE_TGSREQ_APREQ
│ │ │ │ -000353e0: 5f41 5554 4845 4e54 4943 4154 4f52 2e0a  _AUTHENTICATOR..
│ │ │ │ -000353f0: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -00035400: 6f6e 3a2a 2044 6563 7279 7074 2074 6963  on:* Decrypt tic
│ │ │ │ -00035410: 6b65 7420 696e 2041 502d 5245 5120 7573  ket in AP-REQ us
│ │ │ │ -00035420: 696e 6720 7375 7070 6c69 6564 206b 6579  ing supplied key
│ │ │ │ -00035430: 2061 6e64 0a20 2020 2020 6465 6372 7970   and.     decryp
│ │ │ │ -00035440: 7420 4175 7468 656e 7469 6361 746f 7220  t Authenticator 
│ │ │ │ -00035450: 696e 2041 502d 5245 5120 7573 696e 6720  in AP-REQ using 
│ │ │ │ -00035460: 6b65 7920 696e 2064 6563 7279 7074 6564  key in decrypted
│ │ │ │ -00035470: 2074 6963 6b65 742c 2061 6e64 0a20 2020   ticket, and.   
│ │ │ │ -00035480: 2020 6f6e 2073 7563 6365 7373 2073 6574    on success set
│ │ │ │ -00035490: 2074 6865 2054 6963 6b65 7420 616e 6420   the Ticket and 
│ │ │ │ -000354a0: 4175 7468 656e 7469 6361 746f 7220 6669  Authenticator fi
│ │ │ │ -000354b0: 656c 6473 2069 6e20 7468 6520 4150 0a20  elds in the AP. 
│ │ │ │ -000354c0: 2020 2020 6578 6368 616e 6765 2e0a 0a20      exchange... 
│ │ │ │ -000354d0: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ -000354e0: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ -000354f0: 4849 5f4f 4b20 6966 6620 7375 6363 6573  HI_OK iff succes
│ │ │ │ -00035500: 7366 756c 2e0a 0a73 6869 7368 695f 6170  sful...shishi_ap
│ │ │ │ -00035510: 5f72 6571 5f70 726f 6365 7373 0a2d 2d2d  _req_process.---
│ │ │ │ +00035210: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ +00035220: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ +00035230: 2073 6869 7368 695f 6170 5f72 6571 5f70   shishi_ap_req_p
│ │ │ │ +00035240: 726f 6365 7373 5f6b 6579 7573 6167 6520  rocess_keyusage 
│ │ │ │ +00035250: 2853 6869 7368 695f 6170 202a 2041 502c  (Shishi_ap * AP,
│ │ │ │ +00035260: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ +00035270: 695f 6b65 7920 2a20 4b45 592c 2069 6e74  i_key * KEY, int
│ │ │ │ +00035280: 3332 5f74 204b 4559 5553 4147 4529 0a20  32_t KEYUSAGE). 
│ │ │ │ +00035290: 2020 2020 4150 3a20 7374 7275 6374 7572      AP: structur
│ │ │ │ +000352a0: 6520 7468 6174 2068 6f6c 6473 2069 6e66  e that holds inf
│ │ │ │ +000352b0: 6f72 6d61 7469 6f6e 2061 626f 7574 2041  ormation about A
│ │ │ │ +000352c0: 5020 6578 6368 616e 6765 0a20 2020 2020  P exchange.     
│ │ │ │ +000352d0: 4b45 593a 2063 7279 7074 6f67 7261 7068  KEY: cryptograph
│ │ │ │ +000352e0: 6963 206b 6579 2075 7365 6420 746f 2064  ic key used to d
│ │ │ │ +000352f0: 6563 7279 7074 2074 6963 6b65 7420 696e  ecrypt ticket in
│ │ │ │ +00035300: 2041 502d 5245 512e 0a20 2020 2020 4b45   AP-REQ..     KE
│ │ │ │ +00035310: 5955 5341 4745 3a20 6b65 7920 7573 6167  YUSAGE: key usag
│ │ │ │ +00035320: 6520 746f 2075 7365 2064 7572 696e 6720  e to use during 
│ │ │ │ +00035330: 6465 6372 7970 7469 6f6e 2c20 666f 7220  decryption, for 
│ │ │ │ +00035340: 6e6f 726d 616c 2041 502d 5245 5127 730a  normal AP-REQ's.
│ │ │ │ +00035350: 2020 2020 2074 6869 7320 6973 206e 6f72       this is nor
│ │ │ │ +00035360: 6d61 6c6c 7920 5348 4953 4849 5f4b 4559  mally SHISHI_KEY
│ │ │ │ +00035370: 5553 4147 455f 4150 5245 515f 4155 5448  USAGE_APREQ_AUTH
│ │ │ │ +00035380: 454e 5449 4341 544f 522c 2066 6f72 2041  ENTICATOR, for A
│ │ │ │ +00035390: 502d 5245 5127 730a 2020 2020 2070 6172  P-REQ's.     par
│ │ │ │ +000353a0: 7420 6f66 2054 4753 2d52 4551 2773 2c20  t of TGS-REQ's, 
│ │ │ │ +000353b0: 7468 6973 2069 7320 6e6f 726d 616c 6c79  this is normally
│ │ │ │ +000353c0: 0a20 2020 2020 5348 4953 4849 5f4b 4559  .     SHISHI_KEY
│ │ │ │ +000353d0: 5553 4147 455f 5447 5352 4551 5f41 5052  USAGE_TGSREQ_APR
│ │ │ │ +000353e0: 4551 5f41 5554 4845 4e54 4943 4154 4f52  EQ_AUTHENTICATOR
│ │ │ │ +000353f0: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ +00035400: 7469 6f6e 3a2a 2044 6563 7279 7074 2074  tion:* Decrypt t
│ │ │ │ +00035410: 6963 6b65 7420 696e 2041 502d 5245 5120  icket in AP-REQ 
│ │ │ │ +00035420: 7573 696e 6720 7375 7070 6c69 6564 206b  using supplied k
│ │ │ │ +00035430: 6579 2061 6e64 0a20 2020 2020 6465 6372  ey and.     decr
│ │ │ │ +00035440: 7970 7420 4175 7468 656e 7469 6361 746f  ypt Authenticato
│ │ │ │ +00035450: 7220 696e 2041 502d 5245 5120 7573 696e  r in AP-REQ usin
│ │ │ │ +00035460: 6720 6b65 7920 696e 2064 6563 7279 7074  g key in decrypt
│ │ │ │ +00035470: 6564 2074 6963 6b65 742c 2061 6e64 0a20  ed ticket, and. 
│ │ │ │ +00035480: 2020 2020 6f6e 2073 7563 6365 7373 2073      on success s
│ │ │ │ +00035490: 6574 2074 6865 2054 6963 6b65 7420 616e  et the Ticket an
│ │ │ │ +000354a0: 6420 4175 7468 656e 7469 6361 746f 7220  d Authenticator 
│ │ │ │ +000354b0: 6669 656c 6473 2069 6e20 7468 6520 4150  fields in the AP
│ │ │ │ +000354c0: 0a20 2020 2020 6578 6368 616e 6765 2e0a  .     exchange..
│ │ │ │ +000354d0: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ +000354e0: 6c75 653a 2a20 5265 7475 726e 7320 5348  lue:* Returns SH
│ │ │ │ +000354f0: 4953 4849 5f4f 4b20 6966 6620 7375 6363  ISHI_OK iff succ
│ │ │ │ +00035500: 6573 7366 756c 2e0a 0a73 6869 7368 695f  essful...shishi_
│ │ │ │ +00035510: 6170 5f72 6571 5f70 726f 6365 7373 0a2d  ap_req_process.-
│ │ │ │  00035520: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00035530: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ -00035540: 3a20 696e 7420 7368 6973 6869 5f61 705f  : int shishi_ap_
│ │ │ │ -00035550: 7265 715f 7072 6f63 6573 7320 2853 6869  req_process (Shi
│ │ │ │ -00035560: 7368 695f 6170 202a 2041 502c 0a20 2020  shi_ap * AP,.   
│ │ │ │ -00035570: 2020 2020 2020 2053 6869 7368 695f 6b65         Shishi_ke
│ │ │ │ -00035580: 7920 2a20 4b45 5929 0a20 2020 2020 4150  y * KEY).     AP
│ │ │ │ -00035590: 3a20 7374 7275 6374 7572 6520 7468 6174  : structure that
│ │ │ │ -000355a0: 2068 6f6c 6473 2069 6e66 6f72 6d61 7469   holds informati
│ │ │ │ -000355b0: 6f6e 2061 626f 7574 2041 5020 6578 6368  on about AP exch
│ │ │ │ -000355c0: 616e 6765 0a20 2020 2020 4b45 593a 2063  ange.     KEY: c
│ │ │ │ -000355d0: 7279 7074 6f67 7261 7068 6963 206b 6579  ryptographic key
│ │ │ │ -000355e0: 2075 7365 6420 746f 2064 6563 7279 7074   used to decrypt
│ │ │ │ -000355f0: 2074 6963 6b65 7420 696e 2041 502d 5245   ticket in AP-RE
│ │ │ │ -00035600: 512e 0a0a 2020 2020 202a 4465 7363 7269  Q...     *Descri
│ │ │ │ -00035610: 7074 696f 6e3a 2a20 4465 6372 7970 7420  ption:* Decrypt 
│ │ │ │ -00035620: 7469 636b 6574 2069 6e20 4150 2d52 4551  ticket in AP-REQ
│ │ │ │ -00035630: 2075 7369 6e67 2073 7570 706c 6965 6420   using supplied 
│ │ │ │ -00035640: 6b65 7920 616e 640a 2020 2020 2064 6563  key and.     dec
│ │ │ │ -00035650: 7279 7074 2041 7574 6865 6e74 6963 6174  rypt Authenticat
│ │ │ │ -00035660: 6f72 2069 6e20 4150 2d52 4551 2075 7369  or in AP-REQ usi
│ │ │ │ -00035670: 6e67 206b 6579 2069 6e20 6465 6372 7970  ng key in decryp
│ │ │ │ -00035680: 7465 6420 7469 636b 6574 2c20 616e 640a  ted ticket, and.
│ │ │ │ -00035690: 2020 2020 206f 6e20 7375 6363 6573 7320       on success 
│ │ │ │ -000356a0: 7365 7420 7468 6520 5469 636b 6574 2061  set the Ticket a
│ │ │ │ -000356b0: 6e64 2041 7574 6865 6e74 6963 6174 6f72  nd Authenticator
│ │ │ │ -000356c0: 2066 6965 6c64 7320 696e 2074 6865 2041   fields in the A
│ │ │ │ -000356d0: 500a 2020 2020 2065 7863 6861 6e67 652e  P.     exchange.
│ │ │ │ -000356e0: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ -000356f0: 616c 7565 3a2a 2052 6574 7572 6e73 2053  alue:* Returns S
│ │ │ │ -00035700: 4849 5348 495f 4f4b 2069 6666 2073 7563  HISHI_OK iff suc
│ │ │ │ -00035710: 6365 7373 6675 6c2e 0a0a 7368 6973 6869  cessful...shishi
│ │ │ │ -00035720: 5f61 705f 7265 715f 6173 6e31 0a2d 2d2d  _ap_req_asn1.---
│ │ │ │ -00035730: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -00035740: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ -00035750: 6e74 2073 6869 7368 695f 6170 5f72 6571  nt shishi_ap_req
│ │ │ │ -00035760: 5f61 736e 3120 2853 6869 7368 695f 6170  _asn1 (Shishi_ap
│ │ │ │ -00035770: 202a 2041 502c 0a20 2020 2020 2020 2020   * AP,.         
│ │ │ │ -00035780: 2053 6869 7368 695f 6173 6e31 202a 2041   Shishi_asn1 * A
│ │ │ │ -00035790: 5052 4551 290a 2020 2020 2041 503a 2073  PREQ).     AP: s
│ │ │ │ -000357a0: 7472 7563 7475 7265 2074 6861 7420 686f  tructure that ho
│ │ │ │ -000357b0: 6c64 7320 696e 666f 726d 6174 696f 6e20  lds information 
│ │ │ │ -000357c0: 6162 6f75 7420 4150 2065 7863 6861 6e67  about AP exchang
│ │ │ │ -000357d0: 650a 2020 2020 2041 5052 4551 3a20 6f75  e.     APREQ: ou
│ │ │ │ -000357e0: 7470 7574 2041 502d 5245 5120 7661 7269  tput AP-REQ vari
│ │ │ │ -000357f0: 6162 6c65 2e0a 0a20 2020 2020 2a44 6573  able...     *Des
│ │ │ │ -00035800: 6372 6970 7469 6f6e 3a2a 2042 7569 6c64  cription:* Build
│ │ │ │ -00035810: 2041 502d 5245 5120 7573 696e 6720 e280   AP-REQ using ..
│ │ │ │ -00035820: 9873 6869 7368 695f 6170 5f72 6571 5f62  .shishi_ap_req_b
│ │ │ │ -00035830: 7569 6c64 2829 e280 9920 616e 640a 2020  uild()... and.  
│ │ │ │ -00035840: 2020 2072 6574 7572 6e20 6974 2e0a 0a20     return it... 
│ │ │ │ -00035850: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ -00035860: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ -00035870: 4849 5f4f 4b20 6966 6620 7375 6363 6573  HI_OK iff succes
│ │ │ │ -00035880: 7366 756c 2e0a 0a73 6869 7368 695f 6170  sful...shishi_ap
│ │ │ │ -00035890: 5f6b 6579 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  _key.-----------
│ │ │ │ -000358a0: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ -000358b0: 3a20 5368 6973 6869 5f6b 6579 202a 2073  : Shishi_key * s
│ │ │ │ -000358c0: 6869 7368 695f 6170 5f6b 6579 2028 5368  hishi_ap_key (Sh
│ │ │ │ -000358d0: 6973 6869 5f61 7020 2a20 4150 290a 2020  ishi_ap * AP).  
│ │ │ │ -000358e0: 2020 2041 503a 2073 7472 7563 7475 7265     AP: structure
│ │ │ │ -000358f0: 2074 6861 7420 686f 6c64 7320 696e 666f   that holds info
│ │ │ │ -00035900: 726d 6174 696f 6e20 6162 6f75 7420 4150  rmation about AP
│ │ │ │ -00035910: 2065 7863 6861 6e67 650a 0a20 2020 2020   exchange..     
│ │ │ │ -00035920: 2a44 6573 6372 6970 7469 6f6e 3a2a 2045  *Description:* E
│ │ │ │ -00035930: 7874 7261 6374 2074 6865 2061 7070 6c69  xtract the appli
│ │ │ │ -00035940: 6361 7469 6f6e 206b 6579 2066 726f 6d20  cation key from 
│ │ │ │ -00035950: 4150 2e20 4966 2073 7562 6b65 7973 2061  AP. If subkeys a
│ │ │ │ -00035960: 7265 0a20 2020 2020 7573 6564 2c20 6974  re.     used, it
│ │ │ │ -00035970: 2069 7320 7461 6b65 6e20 6672 6f6d 2074   is taken from t
│ │ │ │ -00035980: 6865 2041 7574 6865 6e74 6963 6174 6f72  he Authenticator
│ │ │ │ -00035990: 2c20 6f74 6865 7277 6973 6520 7468 6520  , otherwise the 
│ │ │ │ -000359a0: 7365 7373 696f 6e20 6b65 790a 2020 2020  session key.    
│ │ │ │ -000359b0: 2069 7320 7573 6564 2e0a 0a20 2020 2020   is used...     
│ │ │ │ -000359c0: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ -000359d0: 5265 7475 726e 2061 7070 6c69 6361 7469  Return applicati
│ │ │ │ -000359e0: 6f6e 206b 6579 2066 726f 6d20 4150 2e0a  on key from AP..
│ │ │ │ -000359f0: 0a73 6869 7368 695f 6170 5f72 6570 0a2d  .shishi_ap_rep.-
│ │ │ │ -00035a00: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ -00035a10: 2d20 4675 6e63 7469 6f6e 3a20 5368 6973  - Function: Shis
│ │ │ │ -00035a20: 6869 5f61 736e 3120 7368 6973 6869 5f61  hi_asn1 shishi_a
│ │ │ │ -00035a30: 705f 7265 7020 2853 6869 7368 695f 6170  p_rep (Shishi_ap
│ │ │ │ -00035a40: 202a 2041 5029 0a20 2020 2020 4150 3a20   * AP).     AP: 
│ │ │ │ -00035a50: 7374 7275 6374 7572 6520 7468 6174 2068  structure that h
│ │ │ │ -00035a60: 6f6c 6473 2069 6e66 6f72 6d61 7469 6f6e  olds information
│ │ │ │ -00035a70: 2061 626f 7574 2041 5020 6578 6368 616e   about AP exchan
│ │ │ │ -00035a80: 6765 0a0a 2020 2020 202a 4465 7363 7269  ge..     *Descri
│ │ │ │ -00035a90: 7074 696f 6e3a 2a20 4765 7420 4153 4e2e  ption:* Get ASN.
│ │ │ │ -00035aa0: 3120 4150 2d52 4550 2073 7472 7563 7475  1 AP-REP structu
│ │ │ │ -00035ab0: 7265 2066 726f 6d20 4150 2065 7863 6861  re from AP excha
│ │ │ │ -00035ac0: 6e67 652e 0a0a 2020 2020 202a 5265 7475  nge...     *Retu
│ │ │ │ -00035ad0: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ -00035ae0: 6e73 2074 6865 2041 502d 5245 5020 6672  ns the AP-REP fr
│ │ │ │ -00035af0: 6f6d 2074 6865 2041 5020 6578 6368 616e  om the AP exchan
│ │ │ │ -00035b00: 6765 2c20 6f72 204e 554c 4c20 6966 0a20  ge, or NULL if. 
│ │ │ │ -00035b10: 2020 2020 6e6f 7420 7965 7420 7365 7420      not yet set 
│ │ │ │ -00035b20: 6f72 2061 6e20 6572 726f 7220 6f63 6375  or an error occu
│ │ │ │ -00035b30: 7265 642e 0a0a 7368 6973 6869 5f61 705f  red...shishi_ap_
│ │ │ │ -00035b40: 7265 705f 7365 740a 2d2d 2d2d 2d2d 2d2d  rep_set.--------
│ │ │ │ -00035b50: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ -00035b60: 756e 6374 696f 6e3a 2076 6f69 6420 7368  unction: void sh
│ │ │ │ -00035b70: 6973 6869 5f61 705f 7265 705f 7365 7420  ishi_ap_rep_set 
│ │ │ │ -00035b80: 2853 6869 7368 695f 6170 202a 2041 502c  (Shishi_ap * AP,
│ │ │ │ -00035b90: 2053 6869 7368 695f 6173 6e31 2041 5052   Shishi_asn1 APR
│ │ │ │ -00035ba0: 4550 290a 2020 2020 2041 503a 2073 7472  EP).     AP: str
│ │ │ │ -00035bb0: 7563 7475 7265 2074 6861 7420 686f 6c64  ucture that hold
│ │ │ │ -00035bc0: 7320 696e 666f 726d 6174 696f 6e20 6162  s information ab
│ │ │ │ -00035bd0: 6f75 7420 4150 2065 7863 6861 6e67 650a  out AP exchange.
│ │ │ │ -00035be0: 2020 2020 2041 5052 4550 3a20 6170 7265       APREP: apre
│ │ │ │ -00035bf0: 7020 746f 2073 746f 7265 2069 6e20 4150  p to store in AP
│ │ │ │ -00035c00: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ -00035c10: 7469 6f6e 3a2a 2053 6574 2074 6865 2041  tion:* Set the A
│ │ │ │ -00035c20: 502d 5245 5020 696e 2074 6865 2041 5020  P-REP in the AP 
│ │ │ │ -00035c30: 6578 6368 616e 6765 2e0a 0a73 6869 7368  exchange...shish
│ │ │ │ -00035c40: 695f 6170 5f72 6570 5f64 6572 0a2d 2d2d  i_ap_rep_der.---
│ │ │ │ -00035c50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -00035c60: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ -00035c70: 7420 7368 6973 6869 5f61 705f 7265 705f  t shishi_ap_rep_
│ │ │ │ -00035c80: 6465 7220 2853 6869 7368 695f 6170 202a  der (Shishi_ap *
│ │ │ │ -00035c90: 2041 502c 2063 6861 7220 2a2a 204f 5554   AP, char ** OUT
│ │ │ │ -00035ca0: 2c0a 2020 2020 2020 2020 2020 7369 7a65  ,.          size
│ │ │ │ -00035cb0: 5f74 202a 204f 5554 4c45 4e29 0a20 2020  _t * OUTLEN).   
│ │ │ │ -00035cc0: 2020 4150 3a20 7374 7275 6374 7572 6520    AP: structure 
│ │ │ │ -00035cd0: 7468 6174 2068 6f6c 6473 2069 6e66 6f72  that holds infor
│ │ │ │ -00035ce0: 6d61 7469 6f6e 2061 626f 7574 2041 5020  mation about AP 
│ │ │ │ -00035cf0: 6578 6368 616e 6765 0a20 2020 2020 4f55  exchange.     OU
│ │ │ │ -00035d00: 543a 206f 7574 7075 7420 6172 7261 7920  T: output array 
│ │ │ │ -00035d10: 7769 7468 206e 6577 6c79 2061 6c6c 6f63  with newly alloc
│ │ │ │ -00035d20: 6174 6564 2044 4552 2065 6e63 6f64 696e  ated DER encodin
│ │ │ │ -00035d30: 6720 6f66 2041 502d 5245 502e 0a20 2020  g of AP-REP..   
│ │ │ │ -00035d40: 2020 4f55 544c 454e 3a20 6c65 6e67 7468    OUTLEN: length
│ │ │ │ -00035d50: 206f 6620 6f75 7470 7574 2061 7272 6179   of output array
│ │ │ │ -00035d60: 2077 6974 6820 4445 5220 656e 636f 6469   with DER encodi
│ │ │ │ -00035d70: 6e67 206f 6620 4150 2d52 4550 2e0a 0a20  ng of AP-REP... 
│ │ │ │ -00035d80: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -00035d90: 3a2a 2042 7569 6c64 2041 502d 5245 5020  :* Build AP-REP 
│ │ │ │ -00035da0: 7573 696e 6720 e280 9873 6869 7368 695f  using ...shishi_
│ │ │ │ -00035db0: 6170 5f72 6570 5f62 7569 6c64 2829 e280  ap_rep_build()..
│ │ │ │ -00035dc0: 9920 616e 6420 4445 520a 2020 2020 2065  . and DER.     e
│ │ │ │ -00035dd0: 6e63 6f64 6520 6974 2e20 204f 5554 2069  ncode it.  OUT i
│ │ │ │ -00035de0: 7320 616c 6c6f 6361 7465 6420 6279 2074  s allocated by t
│ │ │ │ -00035df0: 6869 7320 6675 6e63 7469 6f6e 2c20 616e  his function, an
│ │ │ │ -00035e00: 6420 6974 2069 7320 7468 650a 2020 2020  d it is the.    
│ │ │ │ -00035e10: 2072 6573 706f 6e73 6962 696c 6974 7920   responsibility 
│ │ │ │ -00035e20: 6f66 2063 616c 6c65 7220 746f 2064 6561  of caller to dea
│ │ │ │ -00035e30: 6c6c 6f63 6174 6520 6974 2e0a 0a20 2020  llocate it...   
│ │ │ │ -00035e40: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ -00035e50: 2a20 5265 7475 726e 7320 5348 4953 4849  * Returns SHISHI
│ │ │ │ -00035e60: 5f4f 4b20 6966 6620 7375 6363 6573 7366  _OK iff successf
│ │ │ │ -00035e70: 756c 2e0a 0a73 6869 7368 695f 6170 5f72  ul...shishi_ap_r
│ │ │ │ -00035e80: 6570 5f64 6572 5f73 6574 0a2d 2d2d 2d2d  ep_der_set.-----
│ │ │ │ +00035530: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ +00035540: 6f6e 3a20 696e 7420 7368 6973 6869 5f61  on: int shishi_a
│ │ │ │ +00035550: 705f 7265 715f 7072 6f63 6573 7320 2853  p_req_process (S
│ │ │ │ +00035560: 6869 7368 695f 6170 202a 2041 502c 0a20  hishi_ap * AP,. 
│ │ │ │ +00035570: 2020 2020 2020 2020 2053 6869 7368 695f           Shishi_
│ │ │ │ +00035580: 6b65 7920 2a20 4b45 5929 0a20 2020 2020  key * KEY).     
│ │ │ │ +00035590: 4150 3a20 7374 7275 6374 7572 6520 7468  AP: structure th
│ │ │ │ +000355a0: 6174 2068 6f6c 6473 2069 6e66 6f72 6d61  at holds informa
│ │ │ │ +000355b0: 7469 6f6e 2061 626f 7574 2041 5020 6578  tion about AP ex
│ │ │ │ +000355c0: 6368 616e 6765 0a20 2020 2020 4b45 593a  change.     KEY:
│ │ │ │ +000355d0: 2063 7279 7074 6f67 7261 7068 6963 206b   cryptographic k
│ │ │ │ +000355e0: 6579 2075 7365 6420 746f 2064 6563 7279  ey used to decry
│ │ │ │ +000355f0: 7074 2074 6963 6b65 7420 696e 2041 502d  pt ticket in AP-
│ │ │ │ +00035600: 5245 512e 0a0a 2020 2020 202a 4465 7363  REQ...     *Desc
│ │ │ │ +00035610: 7269 7074 696f 6e3a 2a20 4465 6372 7970  ription:* Decryp
│ │ │ │ +00035620: 7420 7469 636b 6574 2069 6e20 4150 2d52  t ticket in AP-R
│ │ │ │ +00035630: 4551 2075 7369 6e67 2073 7570 706c 6965  EQ using supplie
│ │ │ │ +00035640: 6420 6b65 7920 616e 640a 2020 2020 2064  d key and.     d
│ │ │ │ +00035650: 6563 7279 7074 2041 7574 6865 6e74 6963  ecrypt Authentic
│ │ │ │ +00035660: 6174 6f72 2069 6e20 4150 2d52 4551 2075  ator in AP-REQ u
│ │ │ │ +00035670: 7369 6e67 206b 6579 2069 6e20 6465 6372  sing key in decr
│ │ │ │ +00035680: 7970 7465 6420 7469 636b 6574 2c20 616e  ypted ticket, an
│ │ │ │ +00035690: 640a 2020 2020 206f 6e20 7375 6363 6573  d.     on succes
│ │ │ │ +000356a0: 7320 7365 7420 7468 6520 5469 636b 6574  s set the Ticket
│ │ │ │ +000356b0: 2061 6e64 2041 7574 6865 6e74 6963 6174   and Authenticat
│ │ │ │ +000356c0: 6f72 2066 6965 6c64 7320 696e 2074 6865  or fields in the
│ │ │ │ +000356d0: 2041 500a 2020 2020 2065 7863 6861 6e67   AP.     exchang
│ │ │ │ +000356e0: 652e 0a0a 2020 2020 202a 5265 7475 726e  e...     *Return
│ │ │ │ +000356f0: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ +00035700: 2053 4849 5348 495f 4f4b 2069 6666 2073   SHISHI_OK iff s
│ │ │ │ +00035710: 7563 6365 7373 6675 6c2e 0a0a 7368 6973  uccessful...shis
│ │ │ │ +00035720: 6869 5f61 705f 7265 715f 6173 6e31 0a2d  hi_ap_req_asn1.-
│ │ │ │ +00035730: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +00035740: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ +00035750: 2069 6e74 2073 6869 7368 695f 6170 5f72   int shishi_ap_r
│ │ │ │ +00035760: 6571 5f61 736e 3120 2853 6869 7368 695f  eq_asn1 (Shishi_
│ │ │ │ +00035770: 6170 202a 2041 502c 0a20 2020 2020 2020  ap * AP,.       
│ │ │ │ +00035780: 2020 2053 6869 7368 695f 6173 6e31 202a     Shishi_asn1 *
│ │ │ │ +00035790: 2041 5052 4551 290a 2020 2020 2041 503a   APREQ).     AP:
│ │ │ │ +000357a0: 2073 7472 7563 7475 7265 2074 6861 7420   structure that 
│ │ │ │ +000357b0: 686f 6c64 7320 696e 666f 726d 6174 696f  holds informatio
│ │ │ │ +000357c0: 6e20 6162 6f75 7420 4150 2065 7863 6861  n about AP excha
│ │ │ │ +000357d0: 6e67 650a 2020 2020 2041 5052 4551 3a20  nge.     APREQ: 
│ │ │ │ +000357e0: 6f75 7470 7574 2041 502d 5245 5120 7661  output AP-REQ va
│ │ │ │ +000357f0: 7269 6162 6c65 2e0a 0a20 2020 2020 2a44  riable...     *D
│ │ │ │ +00035800: 6573 6372 6970 7469 6f6e 3a2a 2042 7569  escription:* Bui
│ │ │ │ +00035810: 6c64 2041 502d 5245 5120 7573 696e 6720  ld AP-REQ using 
│ │ │ │ +00035820: e280 9873 6869 7368 695f 6170 5f72 6571  ...shishi_ap_req
│ │ │ │ +00035830: 5f62 7569 6c64 2829 e280 9920 616e 640a  _build()... and.
│ │ │ │ +00035840: 2020 2020 2072 6574 7572 6e20 6974 2e0a       return it..
│ │ │ │ +00035850: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ +00035860: 6c75 653a 2a20 5265 7475 726e 7320 5348  lue:* Returns SH
│ │ │ │ +00035870: 4953 4849 5f4f 4b20 6966 6620 7375 6363  ISHI_OK iff succ
│ │ │ │ +00035880: 6573 7366 756c 2e0a 0a73 6869 7368 695f  essful...shishi_
│ │ │ │ +00035890: 6170 5f6b 6579 0a2d 2d2d 2d2d 2d2d 2d2d  ap_key.---------
│ │ │ │ +000358a0: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ +000358b0: 6f6e 3a20 5368 6973 6869 5f6b 6579 202a  on: Shishi_key *
│ │ │ │ +000358c0: 2073 6869 7368 695f 6170 5f6b 6579 2028   shishi_ap_key (
│ │ │ │ +000358d0: 5368 6973 6869 5f61 7020 2a20 4150 290a  Shishi_ap * AP).
│ │ │ │ +000358e0: 2020 2020 2041 503a 2073 7472 7563 7475       AP: structu
│ │ │ │ +000358f0: 7265 2074 6861 7420 686f 6c64 7320 696e  re that holds in
│ │ │ │ +00035900: 666f 726d 6174 696f 6e20 6162 6f75 7420  formation about 
│ │ │ │ +00035910: 4150 2065 7863 6861 6e67 650a 0a20 2020  AP exchange..   
│ │ │ │ +00035920: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ +00035930: 2045 7874 7261 6374 2074 6865 2061 7070   Extract the app
│ │ │ │ +00035940: 6c69 6361 7469 6f6e 206b 6579 2066 726f  lication key fro
│ │ │ │ +00035950: 6d20 4150 2e20 4966 2073 7562 6b65 7973  m AP. If subkeys
│ │ │ │ +00035960: 2061 7265 0a20 2020 2020 7573 6564 2c20   are.     used, 
│ │ │ │ +00035970: 6974 2069 7320 7461 6b65 6e20 6672 6f6d  it is taken from
│ │ │ │ +00035980: 2074 6865 2041 7574 6865 6e74 6963 6174   the Authenticat
│ │ │ │ +00035990: 6f72 2c20 6f74 6865 7277 6973 6520 7468  or, otherwise th
│ │ │ │ +000359a0: 6520 7365 7373 696f 6e20 6b65 790a 2020  e session key.  
│ │ │ │ +000359b0: 2020 2069 7320 7573 6564 2e0a 0a20 2020     is used...   
│ │ │ │ +000359c0: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ +000359d0: 2a20 5265 7475 726e 2061 7070 6c69 6361  * Return applica
│ │ │ │ +000359e0: 7469 6f6e 206b 6579 2066 726f 6d20 4150  tion key from AP
│ │ │ │ +000359f0: 2e0a 0a73 6869 7368 695f 6170 5f72 6570  ...shishi_ap_rep
│ │ │ │ +00035a00: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  .-------------..
│ │ │ │ +00035a10: 202d 2d20 4675 6e63 7469 6f6e 3a20 5368   -- Function: Sh
│ │ │ │ +00035a20: 6973 6869 5f61 736e 3120 7368 6973 6869  ishi_asn1 shishi
│ │ │ │ +00035a30: 5f61 705f 7265 7020 2853 6869 7368 695f  _ap_rep (Shishi_
│ │ │ │ +00035a40: 6170 202a 2041 5029 0a20 2020 2020 4150  ap * AP).     AP
│ │ │ │ +00035a50: 3a20 7374 7275 6374 7572 6520 7468 6174  : structure that
│ │ │ │ +00035a60: 2068 6f6c 6473 2069 6e66 6f72 6d61 7469   holds informati
│ │ │ │ +00035a70: 6f6e 2061 626f 7574 2041 5020 6578 6368  on about AP exch
│ │ │ │ +00035a80: 616e 6765 0a0a 2020 2020 202a 4465 7363  ange..     *Desc
│ │ │ │ +00035a90: 7269 7074 696f 6e3a 2a20 4765 7420 4153  ription:* Get AS
│ │ │ │ +00035aa0: 4e2e 3120 4150 2d52 4550 2073 7472 7563  N.1 AP-REP struc
│ │ │ │ +00035ab0: 7475 7265 2066 726f 6d20 4150 2065 7863  ture from AP exc
│ │ │ │ +00035ac0: 6861 6e67 652e 0a0a 2020 2020 202a 5265  hange...     *Re
│ │ │ │ +00035ad0: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ +00035ae0: 7572 6e73 2074 6865 2041 502d 5245 5020  urns the AP-REP 
│ │ │ │ +00035af0: 6672 6f6d 2074 6865 2041 5020 6578 6368  from the AP exch
│ │ │ │ +00035b00: 616e 6765 2c20 6f72 204e 554c 4c20 6966  ange, or NULL if
│ │ │ │ +00035b10: 0a20 2020 2020 6e6f 7420 7965 7420 7365  .     not yet se
│ │ │ │ +00035b20: 7420 6f72 2061 6e20 6572 726f 7220 6f63  t or an error oc
│ │ │ │ +00035b30: 6375 7265 642e 0a0a 7368 6973 6869 5f61  cured...shishi_a
│ │ │ │ +00035b40: 705f 7265 705f 7365 740a 2d2d 2d2d 2d2d  p_rep_set.------
│ │ │ │ +00035b50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ +00035b60: 2046 756e 6374 696f 6e3a 2076 6f69 6420   Function: void 
│ │ │ │ +00035b70: 7368 6973 6869 5f61 705f 7265 705f 7365  shishi_ap_rep_se
│ │ │ │ +00035b80: 7420 2853 6869 7368 695f 6170 202a 2041  t (Shishi_ap * A
│ │ │ │ +00035b90: 502c 2053 6869 7368 695f 6173 6e31 2041  P, Shishi_asn1 A
│ │ │ │ +00035ba0: 5052 4550 290a 2020 2020 2041 503a 2073  PREP).     AP: s
│ │ │ │ +00035bb0: 7472 7563 7475 7265 2074 6861 7420 686f  tructure that ho
│ │ │ │ +00035bc0: 6c64 7320 696e 666f 726d 6174 696f 6e20  lds information 
│ │ │ │ +00035bd0: 6162 6f75 7420 4150 2065 7863 6861 6e67  about AP exchang
│ │ │ │ +00035be0: 650a 2020 2020 2041 5052 4550 3a20 6170  e.     APREP: ap
│ │ │ │ +00035bf0: 7265 7020 746f 2073 746f 7265 2069 6e20  rep to store in 
│ │ │ │ +00035c00: 4150 2e0a 0a20 2020 2020 2a44 6573 6372  AP...     *Descr
│ │ │ │ +00035c10: 6970 7469 6f6e 3a2a 2053 6574 2074 6865  iption:* Set the
│ │ │ │ +00035c20: 2041 502d 5245 5020 696e 2074 6865 2041   AP-REP in the A
│ │ │ │ +00035c30: 5020 6578 6368 616e 6765 2e0a 0a73 6869  P exchange...shi
│ │ │ │ +00035c40: 7368 695f 6170 5f72 6570 5f64 6572 0a2d  shi_ap_rep_der.-
│ │ │ │ +00035c50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +00035c60: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +00035c70: 696e 7420 7368 6973 6869 5f61 705f 7265  int shishi_ap_re
│ │ │ │ +00035c80: 705f 6465 7220 2853 6869 7368 695f 6170  p_der (Shishi_ap
│ │ │ │ +00035c90: 202a 2041 502c 2063 6861 7220 2a2a 204f   * AP, char ** O
│ │ │ │ +00035ca0: 5554 2c0a 2020 2020 2020 2020 2020 7369  UT,.          si
│ │ │ │ +00035cb0: 7a65 5f74 202a 204f 5554 4c45 4e29 0a20  ze_t * OUTLEN). 
│ │ │ │ +00035cc0: 2020 2020 4150 3a20 7374 7275 6374 7572      AP: structur
│ │ │ │ +00035cd0: 6520 7468 6174 2068 6f6c 6473 2069 6e66  e that holds inf
│ │ │ │ +00035ce0: 6f72 6d61 7469 6f6e 2061 626f 7574 2041  ormation about A
│ │ │ │ +00035cf0: 5020 6578 6368 616e 6765 0a20 2020 2020  P exchange.     
│ │ │ │ +00035d00: 4f55 543a 206f 7574 7075 7420 6172 7261  OUT: output arra
│ │ │ │ +00035d10: 7920 7769 7468 206e 6577 6c79 2061 6c6c  y with newly all
│ │ │ │ +00035d20: 6f63 6174 6564 2044 4552 2065 6e63 6f64  ocated DER encod
│ │ │ │ +00035d30: 696e 6720 6f66 2041 502d 5245 502e 0a20  ing of AP-REP.. 
│ │ │ │ +00035d40: 2020 2020 4f55 544c 454e 3a20 6c65 6e67      OUTLEN: leng
│ │ │ │ +00035d50: 7468 206f 6620 6f75 7470 7574 2061 7272  th of output arr
│ │ │ │ +00035d60: 6179 2077 6974 6820 4445 5220 656e 636f  ay with DER enco
│ │ │ │ +00035d70: 6469 6e67 206f 6620 4150 2d52 4550 2e0a  ding of AP-REP..
│ │ │ │ +00035d80: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +00035d90: 6f6e 3a2a 2042 7569 6c64 2041 502d 5245  on:* Build AP-RE
│ │ │ │ +00035da0: 5020 7573 696e 6720 e280 9873 6869 7368  P using ...shish
│ │ │ │ +00035db0: 695f 6170 5f72 6570 5f62 7569 6c64 2829  i_ap_rep_build()
│ │ │ │ +00035dc0: e280 9920 616e 6420 4445 520a 2020 2020  ... and DER.    
│ │ │ │ +00035dd0: 2065 6e63 6f64 6520 6974 2e20 204f 5554   encode it.  OUT
│ │ │ │ +00035de0: 2069 7320 616c 6c6f 6361 7465 6420 6279   is allocated by
│ │ │ │ +00035df0: 2074 6869 7320 6675 6e63 7469 6f6e 2c20   this function, 
│ │ │ │ +00035e00: 616e 6420 6974 2069 7320 7468 650a 2020  and it is the.  
│ │ │ │ +00035e10: 2020 2072 6573 706f 6e73 6962 696c 6974     responsibilit
│ │ │ │ +00035e20: 7920 6f66 2063 616c 6c65 7220 746f 2064  y of caller to d
│ │ │ │ +00035e30: 6561 6c6c 6f63 6174 6520 6974 2e0a 0a20  eallocate it... 
│ │ │ │ +00035e40: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ +00035e50: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ +00035e60: 4849 5f4f 4b20 6966 6620 7375 6363 6573  HI_OK iff succes
│ │ │ │ +00035e70: 7366 756c 2e0a 0a73 6869 7368 695f 6170  sful...shishi_ap
│ │ │ │ +00035e80: 5f72 6570 5f64 6572 5f73 6574 0a2d 2d2d  _rep_der_set.---
│ │ │ │  00035e90: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00035ea0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ -00035eb0: 696e 7420 7368 6973 6869 5f61 705f 7265  int shishi_ap_re
│ │ │ │ -00035ec0: 705f 6465 725f 7365 7420 2853 6869 7368  p_der_set (Shish
│ │ │ │ -00035ed0: 695f 6170 202a 2041 502c 2063 6861 7220  i_ap * AP, char 
│ │ │ │ -00035ee0: 2a20 4445 522c 0a20 2020 2020 2020 2020  * DER,.         
│ │ │ │ -00035ef0: 2073 697a 655f 7420 4445 524c 454e 290a   size_t DERLEN).
│ │ │ │ -00035f00: 2020 2020 2041 503a 2073 7472 7563 7475       AP: structu
│ │ │ │ -00035f10: 7265 2074 6861 7420 686f 6c64 7320 696e  re that holds in
│ │ │ │ -00035f20: 666f 726d 6174 696f 6e20 6162 6f75 7420  formation about 
│ │ │ │ -00035f30: 4150 2065 7863 6861 6e67 650a 2020 2020  AP exchange.    
│ │ │ │ -00035f40: 2044 4552 3a20 696e 7075 7420 6172 7261   DER: input arra
│ │ │ │ -00035f50: 7920 7769 7468 2044 4552 2065 6e63 6f64  y with DER encod
│ │ │ │ -00035f60: 6564 2041 502d 5245 502e 0a20 2020 2020  ed AP-REP..     
│ │ │ │ -00035f70: 4445 524c 454e 3a20 6c65 6e67 7468 206f  DERLEN: length o
│ │ │ │ -00035f80: 6620 696e 7075 7420 6172 7261 7920 7769  f input array wi
│ │ │ │ -00035f90: 7468 2044 4552 2065 6e63 6f64 6564 2041  th DER encoded A
│ │ │ │ -00035fa0: 502d 5245 502e 0a0a 2020 2020 202a 4465  P-REP...     *De
│ │ │ │ -00035fb0: 7363 7269 7074 696f 6e3a 2a20 4445 5220  scription:* DER 
│ │ │ │ -00035fc0: 6465 636f 6465 2041 502d 5245 5020 616e  decode AP-REP an
│ │ │ │ -00035fd0: 6420 7365 7420 6974 2041 5020 6578 6368  d set it AP exch
│ │ │ │ -00035fe0: 616e 6765 2e20 2049 660a 2020 2020 2064  ange.  If.     d
│ │ │ │ -00035ff0: 6563 6f64 696e 6720 6661 696c 732c 2074  ecoding fails, t
│ │ │ │ -00036000: 6865 2041 502d 5245 5020 696e 2074 6865  he AP-REP in the
│ │ │ │ -00036010: 2041 5020 6578 6368 616e 6765 2072 656d   AP exchange rem
│ │ │ │ -00036020: 6169 6e73 2e0a 0a20 2020 2020 2a52 6574  ains...     *Ret
│ │ │ │ -00036030: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ -00036040: 726e 7320 5348 4953 4849 5f4f 4b2e 0a0a  rns SHISHI_OK...
│ │ │ │ -00036050: 7368 6973 6869 5f61 705f 7265 705f 6275  shishi_ap_rep_bu
│ │ │ │ -00036060: 696c 640a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ild.------------
│ │ │ │ -00036070: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ -00036080: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ -00036090: 695f 6170 5f72 6570 5f62 7569 6c64 2028  i_ap_rep_build (
│ │ │ │ -000360a0: 5368 6973 6869 5f61 7020 2a20 4150 290a  Shishi_ap * AP).
│ │ │ │ -000360b0: 2020 2020 2041 503a 2073 7472 7563 7475       AP: structu
│ │ │ │ -000360c0: 7265 2074 6861 7420 686f 6c64 7320 696e  re that holds in
│ │ │ │ -000360d0: 666f 726d 6174 696f 6e20 6162 6f75 7420  formation about 
│ │ │ │ -000360e0: 4150 2065 7863 6861 6e67 650a 0a20 2020  AP exchange..   
│ │ │ │ -000360f0: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ -00036100: 2043 6865 636b 7375 6d20 6461 7461 2069   Checksum data i
│ │ │ │ -00036110: 6e20 6175 7468 656e 7469 6361 746f 7220  n authenticator 
│ │ │ │ -00036120: 616e 6420 6164 6420 7469 636b 6574 2061  and add ticket a
│ │ │ │ -00036130: 6e64 0a20 2020 2020 6175 7468 656e 7469  nd.     authenti
│ │ │ │ -00036140: 6361 746f 7220 746f 2041 502d 5245 502e  cator to AP-REP.
│ │ │ │ -00036150: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ -00036160: 616c 7565 3a2a 2052 6574 7572 6e73 2053  alue:* Returns S
│ │ │ │ -00036170: 4849 5348 495f 4f4b 2069 6666 2073 7563  HISHI_OK iff suc
│ │ │ │ -00036180: 6365 7373 6675 6c2e 0a0a 7368 6973 6869  cessful...shishi
│ │ │ │ -00036190: 5f61 705f 7265 705f 6173 6e31 0a2d 2d2d  _ap_rep_asn1.---
│ │ │ │ -000361a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -000361b0: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ -000361c0: 6e74 2073 6869 7368 695f 6170 5f72 6570  nt shishi_ap_rep
│ │ │ │ -000361d0: 5f61 736e 3120 2853 6869 7368 695f 6170  _asn1 (Shishi_ap
│ │ │ │ -000361e0: 202a 2041 502c 0a20 2020 2020 2020 2020   * AP,.         
│ │ │ │ -000361f0: 2053 6869 7368 695f 6173 6e31 202a 2041   Shishi_asn1 * A
│ │ │ │ -00036200: 5052 4550 290a 2020 2020 2041 503a 2073  PREP).     AP: s
│ │ │ │ -00036210: 7472 7563 7475 7265 2074 6861 7420 686f  tructure that ho
│ │ │ │ -00036220: 6c64 7320 696e 666f 726d 6174 696f 6e20  lds information 
│ │ │ │ -00036230: 6162 6f75 7420 4150 2065 7863 6861 6e67  about AP exchang
│ │ │ │ -00036240: 650a 2020 2020 2041 5052 4550 3a20 6f75  e.     APREP: ou
│ │ │ │ -00036250: 7470 7574 2041 502d 5245 5020 7661 7269  tput AP-REP vari
│ │ │ │ -00036260: 6162 6c65 2e0a 0a20 2020 2020 2a44 6573  able...     *Des
│ │ │ │ -00036270: 6372 6970 7469 6f6e 3a2a 2042 7569 6c64  cription:* Build
│ │ │ │ -00036280: 2041 502d 5245 5020 7573 696e 6720 e280   AP-REP using ..
│ │ │ │ -00036290: 9873 6869 7368 695f 6170 5f72 6570 5f62  .shishi_ap_rep_b
│ │ │ │ -000362a0: 7569 6c64 2829 e280 9920 616e 640a 2020  uild()... and.  
│ │ │ │ -000362b0: 2020 2072 6574 7572 6e20 6974 2e0a 0a20     return it... 
│ │ │ │ -000362c0: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ -000362d0: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ -000362e0: 4849 5f4f 4b20 6966 6620 7375 6363 6573  HI_OK iff succes
│ │ │ │ -000362f0: 7366 756c 2e0a 0a73 6869 7368 695f 6170  sful...shishi_ap
│ │ │ │ -00036300: 5f72 6570 5f76 6572 6966 790a 2d2d 2d2d  _rep_verify.----
│ │ │ │ +00035ea0: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ +00035eb0: 3a20 696e 7420 7368 6973 6869 5f61 705f  : int shishi_ap_
│ │ │ │ +00035ec0: 7265 705f 6465 725f 7365 7420 2853 6869  rep_der_set (Shi
│ │ │ │ +00035ed0: 7368 695f 6170 202a 2041 502c 2063 6861  shi_ap * AP, cha
│ │ │ │ +00035ee0: 7220 2a20 4445 522c 0a20 2020 2020 2020  r * DER,.       
│ │ │ │ +00035ef0: 2020 2073 697a 655f 7420 4445 524c 454e     size_t DERLEN
│ │ │ │ +00035f00: 290a 2020 2020 2041 503a 2073 7472 7563  ).     AP: struc
│ │ │ │ +00035f10: 7475 7265 2074 6861 7420 686f 6c64 7320  ture that holds 
│ │ │ │ +00035f20: 696e 666f 726d 6174 696f 6e20 6162 6f75  information abou
│ │ │ │ +00035f30: 7420 4150 2065 7863 6861 6e67 650a 2020  t AP exchange.  
│ │ │ │ +00035f40: 2020 2044 4552 3a20 696e 7075 7420 6172     DER: input ar
│ │ │ │ +00035f50: 7261 7920 7769 7468 2044 4552 2065 6e63  ray with DER enc
│ │ │ │ +00035f60: 6f64 6564 2041 502d 5245 502e 0a20 2020  oded AP-REP..   
│ │ │ │ +00035f70: 2020 4445 524c 454e 3a20 6c65 6e67 7468    DERLEN: length
│ │ │ │ +00035f80: 206f 6620 696e 7075 7420 6172 7261 7920   of input array 
│ │ │ │ +00035f90: 7769 7468 2044 4552 2065 6e63 6f64 6564  with DER encoded
│ │ │ │ +00035fa0: 2041 502d 5245 502e 0a0a 2020 2020 202a   AP-REP...     *
│ │ │ │ +00035fb0: 4465 7363 7269 7074 696f 6e3a 2a20 4445  Description:* DE
│ │ │ │ +00035fc0: 5220 6465 636f 6465 2041 502d 5245 5020  R decode AP-REP 
│ │ │ │ +00035fd0: 616e 6420 7365 7420 6974 2041 5020 6578  and set it AP ex
│ │ │ │ +00035fe0: 6368 616e 6765 2e20 2049 660a 2020 2020  change.  If.    
│ │ │ │ +00035ff0: 2064 6563 6f64 696e 6720 6661 696c 732c   decoding fails,
│ │ │ │ +00036000: 2074 6865 2041 502d 5245 5020 696e 2074   the AP-REP in t
│ │ │ │ +00036010: 6865 2041 5020 6578 6368 616e 6765 2072  he AP exchange r
│ │ │ │ +00036020: 656d 6169 6e73 2e0a 0a20 2020 2020 2a52  emains...     *R
│ │ │ │ +00036030: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +00036040: 7475 726e 7320 5348 4953 4849 5f4f 4b2e  turns SHISHI_OK.
│ │ │ │ +00036050: 0a0a 7368 6973 6869 5f61 705f 7265 705f  ..shishi_ap_rep_
│ │ │ │ +00036060: 6275 696c 640a 2d2d 2d2d 2d2d 2d2d 2d2d  build.----------
│ │ │ │ +00036070: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +00036080: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ +00036090: 7368 695f 6170 5f72 6570 5f62 7569 6c64  shi_ap_rep_build
│ │ │ │ +000360a0: 2028 5368 6973 6869 5f61 7020 2a20 4150   (Shishi_ap * AP
│ │ │ │ +000360b0: 290a 2020 2020 2041 503a 2073 7472 7563  ).     AP: struc
│ │ │ │ +000360c0: 7475 7265 2074 6861 7420 686f 6c64 7320  ture that holds 
│ │ │ │ +000360d0: 696e 666f 726d 6174 696f 6e20 6162 6f75  information abou
│ │ │ │ +000360e0: 7420 4150 2065 7863 6861 6e67 650a 0a20  t AP exchange.. 
│ │ │ │ +000360f0: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ +00036100: 3a2a 2043 6865 636b 7375 6d20 6461 7461  :* Checksum data
│ │ │ │ +00036110: 2069 6e20 6175 7468 656e 7469 6361 746f   in authenticato
│ │ │ │ +00036120: 7220 616e 6420 6164 6420 7469 636b 6574  r and add ticket
│ │ │ │ +00036130: 2061 6e64 0a20 2020 2020 6175 7468 656e   and.     authen
│ │ │ │ +00036140: 7469 6361 746f 7220 746f 2041 502d 5245  ticator to AP-RE
│ │ │ │ +00036150: 502e 0a0a 2020 2020 202a 5265 7475 726e  P...     *Return
│ │ │ │ +00036160: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ +00036170: 2053 4849 5348 495f 4f4b 2069 6666 2073   SHISHI_OK iff s
│ │ │ │ +00036180: 7563 6365 7373 6675 6c2e 0a0a 7368 6973  uccessful...shis
│ │ │ │ +00036190: 6869 5f61 705f 7265 705f 6173 6e31 0a2d  hi_ap_rep_asn1.-
│ │ │ │ +000361a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +000361b0: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ +000361c0: 2069 6e74 2073 6869 7368 695f 6170 5f72   int shishi_ap_r
│ │ │ │ +000361d0: 6570 5f61 736e 3120 2853 6869 7368 695f  ep_asn1 (Shishi_
│ │ │ │ +000361e0: 6170 202a 2041 502c 0a20 2020 2020 2020  ap * AP,.       
│ │ │ │ +000361f0: 2020 2053 6869 7368 695f 6173 6e31 202a     Shishi_asn1 *
│ │ │ │ +00036200: 2041 5052 4550 290a 2020 2020 2041 503a   APREP).     AP:
│ │ │ │ +00036210: 2073 7472 7563 7475 7265 2074 6861 7420   structure that 
│ │ │ │ +00036220: 686f 6c64 7320 696e 666f 726d 6174 696f  holds informatio
│ │ │ │ +00036230: 6e20 6162 6f75 7420 4150 2065 7863 6861  n about AP excha
│ │ │ │ +00036240: 6e67 650a 2020 2020 2041 5052 4550 3a20  nge.     APREP: 
│ │ │ │ +00036250: 6f75 7470 7574 2041 502d 5245 5020 7661  output AP-REP va
│ │ │ │ +00036260: 7269 6162 6c65 2e0a 0a20 2020 2020 2a44  riable...     *D
│ │ │ │ +00036270: 6573 6372 6970 7469 6f6e 3a2a 2042 7569  escription:* Bui
│ │ │ │ +00036280: 6c64 2041 502d 5245 5020 7573 696e 6720  ld AP-REP using 
│ │ │ │ +00036290: e280 9873 6869 7368 695f 6170 5f72 6570  ...shishi_ap_rep
│ │ │ │ +000362a0: 5f62 7569 6c64 2829 e280 9920 616e 640a  _build()... and.
│ │ │ │ +000362b0: 2020 2020 2072 6574 7572 6e20 6974 2e0a       return it..
│ │ │ │ +000362c0: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ +000362d0: 6c75 653a 2a20 5265 7475 726e 7320 5348  lue:* Returns SH
│ │ │ │ +000362e0: 4953 4849 5f4f 4b20 6966 6620 7375 6363  ISHI_OK iff succ
│ │ │ │ +000362f0: 6573 7366 756c 2e0a 0a73 6869 7368 695f  essful...shishi_
│ │ │ │ +00036300: 6170 5f72 6570 5f76 6572 6966 790a 2d2d  ap_rep_verify.--
│ │ │ │  00036310: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00036320: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ -00036330: 696e 7420 7368 6973 6869 5f61 705f 7265  int shishi_ap_re
│ │ │ │ -00036340: 705f 7665 7269 6679 2028 5368 6973 6869  p_verify (Shishi
│ │ │ │ -00036350: 5f61 7020 2a20 4150 290a 2020 2020 2041  _ap * AP).     A
│ │ │ │ -00036360: 503a 2073 7472 7563 7475 7265 2074 6861  P: structure tha
│ │ │ │ -00036370: 7420 686f 6c64 7320 696e 666f 726d 6174  t holds informat
│ │ │ │ -00036380: 696f 6e20 6162 6f75 7420 4150 2065 7863  ion about AP exc
│ │ │ │ -00036390: 6861 6e67 650a 0a20 2020 2020 2a44 6573  hange..     *Des
│ │ │ │ -000363a0: 6372 6970 7469 6f6e 3a2a 2056 6572 6966  cription:* Verif
│ │ │ │ -000363b0: 7920 4150 2d52 4550 2063 6f6d 7061 7265  y AP-REP compare
│ │ │ │ -000363c0: 6420 746f 2041 7574 6865 6e74 6963 6174  d to Authenticat
│ │ │ │ -000363d0: 6f72 2e0a 0a20 2020 2020 2a52 6574 7572  or...     *Retur
│ │ │ │ -000363e0: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ -000363f0: 7320 5348 4953 4849 5f4f 4b2c 2053 4849  s SHISHI_OK, SHI
│ │ │ │ -00036400: 5348 495f 4150 5245 505f 5645 5249 4659  SHI_APREP_VERIFY
│ │ │ │ -00036410: 5f46 4149 4c45 4420 6f72 2061 6e0a 2020  _FAILED or an.  
│ │ │ │ -00036420: 2020 2065 7272 6f72 2e0a 0a73 6869 7368     error...shish
│ │ │ │ -00036430: 695f 6170 5f72 6570 5f76 6572 6966 795f  i_ap_rep_verify_
│ │ │ │ -00036440: 6465 720a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  der.------------
│ │ │ │ -00036450: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ -00036460: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ -00036470: 7368 6973 6869 5f61 705f 7265 705f 7665  shishi_ap_rep_ve
│ │ │ │ -00036480: 7269 6679 5f64 6572 2028 5368 6973 6869  rify_der (Shishi
│ │ │ │ -00036490: 5f61 7020 2a20 4150 2c20 6368 6172 202a  _ap * AP, char *
│ │ │ │ -000364a0: 2044 4552 2c0a 2020 2020 2020 2020 2020   DER,.          
│ │ │ │ -000364b0: 7369 7a65 5f74 2044 4552 4c45 4e29 0a20  size_t DERLEN). 
│ │ │ │ -000364c0: 2020 2020 4150 3a20 7374 7275 6374 7572      AP: structur
│ │ │ │ -000364d0: 6520 7468 6174 2068 6f6c 6473 2069 6e66  e that holds inf
│ │ │ │ -000364e0: 6f72 6d61 7469 6f6e 2061 626f 7574 2041  ormation about A
│ │ │ │ -000364f0: 5020 6578 6368 616e 6765 0a20 2020 2020  P exchange.     
│ │ │ │ -00036500: 4445 523a 2069 6e70 7574 2061 7272 6179  DER: input array
│ │ │ │ -00036510: 2077 6974 6820 4445 5220 656e 636f 6465   with DER encode
│ │ │ │ -00036520: 6420 4150 2d52 4550 2e0a 2020 2020 2044  d AP-REP..     D
│ │ │ │ -00036530: 4552 4c45 4e3a 206c 656e 6774 6820 6f66  ERLEN: length of
│ │ │ │ -00036540: 2069 6e70 7574 2061 7272 6179 2077 6974   input array wit
│ │ │ │ -00036550: 6820 4445 5220 656e 636f 6465 6420 4150  h DER encoded AP
│ │ │ │ -00036560: 2d52 4550 2e0a 0a20 2020 2020 2a44 6573  -REP...     *Des
│ │ │ │ -00036570: 6372 6970 7469 6f6e 3a2a 2044 4552 2064  cription:* DER d
│ │ │ │ -00036580: 6563 6f64 6520 4150 2d52 4550 2061 6e64  ecode AP-REP and
│ │ │ │ -00036590: 2073 6574 2069 7420 696e 2041 5020 6578   set it in AP ex
│ │ │ │ -000365a0: 6368 616e 6765 2075 7369 6e67 0a20 2020  change using.   
│ │ │ │ -000365b0: 2020 e280 9873 6869 7368 695f 6170 5f72    ...shishi_ap_r
│ │ │ │ -000365c0: 6570 5f64 6572 5f73 6574 2829 e280 9920  ep_der_set()... 
│ │ │ │ -000365d0: 616e 6420 7665 7269 6679 2069 7420 7573  and verify it us
│ │ │ │ -000365e0: 696e 670a 2020 2020 20e2 8098 7368 6973  ing.     ...shis
│ │ │ │ -000365f0: 6869 5f61 705f 7265 705f 7665 7269 6679  hi_ap_rep_verify
│ │ │ │ -00036600: 2829 e280 992e 0a0a 2020 2020 202a 5265  ()......     *Re
│ │ │ │ -00036610: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ -00036620: 7572 6e73 2053 4849 5348 495f 4f4b 2c20  urns SHISHI_OK, 
│ │ │ │ -00036630: 5348 4953 4849 5f41 5052 4550 5f56 4552  SHISHI_APREP_VER
│ │ │ │ -00036640: 4946 595f 4641 494c 4544 206f 7220 616e  IFY_FAILED or an
│ │ │ │ -00036650: 0a20 2020 2020 6572 726f 722e 0a0a 7368  .     error...sh
│ │ │ │ -00036660: 6973 6869 5f61 705f 7265 705f 7665 7269  ishi_ap_rep_veri
│ │ │ │ -00036670: 6679 5f61 736e 310a 2d2d 2d2d 2d2d 2d2d  fy_asn1.--------
│ │ │ │ +00036320: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ +00036330: 3a20 696e 7420 7368 6973 6869 5f61 705f  : int shishi_ap_
│ │ │ │ +00036340: 7265 705f 7665 7269 6679 2028 5368 6973  rep_verify (Shis
│ │ │ │ +00036350: 6869 5f61 7020 2a20 4150 290a 2020 2020  hi_ap * AP).    
│ │ │ │ +00036360: 2041 503a 2073 7472 7563 7475 7265 2074   AP: structure t
│ │ │ │ +00036370: 6861 7420 686f 6c64 7320 696e 666f 726d  hat holds inform
│ │ │ │ +00036380: 6174 696f 6e20 6162 6f75 7420 4150 2065  ation about AP e
│ │ │ │ +00036390: 7863 6861 6e67 650a 0a20 2020 2020 2a44  xchange..     *D
│ │ │ │ +000363a0: 6573 6372 6970 7469 6f6e 3a2a 2056 6572  escription:* Ver
│ │ │ │ +000363b0: 6966 7920 4150 2d52 4550 2063 6f6d 7061  ify AP-REP compa
│ │ │ │ +000363c0: 7265 6420 746f 2041 7574 6865 6e74 6963  red to Authentic
│ │ │ │ +000363d0: 6174 6f72 2e0a 0a20 2020 2020 2a52 6574  ator...     *Ret
│ │ │ │ +000363e0: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ +000363f0: 726e 7320 5348 4953 4849 5f4f 4b2c 2053  rns SHISHI_OK, S
│ │ │ │ +00036400: 4849 5348 495f 4150 5245 505f 5645 5249  HISHI_APREP_VERI
│ │ │ │ +00036410: 4659 5f46 4149 4c45 4420 6f72 2061 6e0a  FY_FAILED or an.
│ │ │ │ +00036420: 2020 2020 2065 7272 6f72 2e0a 0a73 6869       error...shi
│ │ │ │ +00036430: 7368 695f 6170 5f72 6570 5f76 6572 6966  shi_ap_rep_verif
│ │ │ │ +00036440: 795f 6465 720a 2d2d 2d2d 2d2d 2d2d 2d2d  y_der.----------
│ │ │ │ +00036450: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ +00036460: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ +00036470: 7420 7368 6973 6869 5f61 705f 7265 705f  t shishi_ap_rep_
│ │ │ │ +00036480: 7665 7269 6679 5f64 6572 2028 5368 6973  verify_der (Shis
│ │ │ │ +00036490: 6869 5f61 7020 2a20 4150 2c20 6368 6172  hi_ap * AP, char
│ │ │ │ +000364a0: 202a 2044 4552 2c0a 2020 2020 2020 2020   * DER,.        
│ │ │ │ +000364b0: 2020 7369 7a65 5f74 2044 4552 4c45 4e29    size_t DERLEN)
│ │ │ │ +000364c0: 0a20 2020 2020 4150 3a20 7374 7275 6374  .     AP: struct
│ │ │ │ +000364d0: 7572 6520 7468 6174 2068 6f6c 6473 2069  ure that holds i
│ │ │ │ +000364e0: 6e66 6f72 6d61 7469 6f6e 2061 626f 7574  nformation about
│ │ │ │ +000364f0: 2041 5020 6578 6368 616e 6765 0a20 2020   AP exchange.   
│ │ │ │ +00036500: 2020 4445 523a 2069 6e70 7574 2061 7272    DER: input arr
│ │ │ │ +00036510: 6179 2077 6974 6820 4445 5220 656e 636f  ay with DER enco
│ │ │ │ +00036520: 6465 6420 4150 2d52 4550 2e0a 2020 2020  ded AP-REP..    
│ │ │ │ +00036530: 2044 4552 4c45 4e3a 206c 656e 6774 6820   DERLEN: length 
│ │ │ │ +00036540: 6f66 2069 6e70 7574 2061 7272 6179 2077  of input array w
│ │ │ │ +00036550: 6974 6820 4445 5220 656e 636f 6465 6420  ith DER encoded 
│ │ │ │ +00036560: 4150 2d52 4550 2e0a 0a20 2020 2020 2a44  AP-REP...     *D
│ │ │ │ +00036570: 6573 6372 6970 7469 6f6e 3a2a 2044 4552  escription:* DER
│ │ │ │ +00036580: 2064 6563 6f64 6520 4150 2d52 4550 2061   decode AP-REP a
│ │ │ │ +00036590: 6e64 2073 6574 2069 7420 696e 2041 5020  nd set it in AP 
│ │ │ │ +000365a0: 6578 6368 616e 6765 2075 7369 6e67 0a20  exchange using. 
│ │ │ │ +000365b0: 2020 2020 e280 9873 6869 7368 695f 6170      ...shishi_ap
│ │ │ │ +000365c0: 5f72 6570 5f64 6572 5f73 6574 2829 e280  _rep_der_set()..
│ │ │ │ +000365d0: 9920 616e 6420 7665 7269 6679 2069 7420  . and verify it 
│ │ │ │ +000365e0: 7573 696e 670a 2020 2020 20e2 8098 7368  using.     ...sh
│ │ │ │ +000365f0: 6973 6869 5f61 705f 7265 705f 7665 7269  ishi_ap_rep_veri
│ │ │ │ +00036600: 6679 2829 e280 992e 0a0a 2020 2020 202a  fy()......     *
│ │ │ │ +00036610: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ +00036620: 6574 7572 6e73 2053 4849 5348 495f 4f4b  eturns SHISHI_OK
│ │ │ │ +00036630: 2c20 5348 4953 4849 5f41 5052 4550 5f56  , SHISHI_APREP_V
│ │ │ │ +00036640: 4552 4946 595f 4641 494c 4544 206f 7220  ERIFY_FAILED or 
│ │ │ │ +00036650: 616e 0a20 2020 2020 6572 726f 722e 0a0a  an.     error...
│ │ │ │ +00036660: 7368 6973 6869 5f61 705f 7265 705f 7665  shishi_ap_rep_ve
│ │ │ │ +00036670: 7269 6679 5f61 736e 310a 2d2d 2d2d 2d2d  rify_asn1.------
│ │ │ │  00036680: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00036690: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ -000366a0: 2069 6e74 2073 6869 7368 695f 6170 5f72   int shishi_ap_r
│ │ │ │ -000366b0: 6570 5f76 6572 6966 795f 6173 6e31 2028  ep_verify_asn1 (
│ │ │ │ -000366c0: 5368 6973 6869 5f61 7020 2a20 4150 2c0a  Shishi_ap * AP,.
│ │ │ │ -000366d0: 2020 2020 2020 2020 2020 5368 6973 6869            Shishi
│ │ │ │ -000366e0: 5f61 736e 3120 4150 5245 5029 0a20 2020  _asn1 APREP).   
│ │ │ │ -000366f0: 2020 4150 3a20 7374 7275 6374 7572 6520    AP: structure 
│ │ │ │ -00036700: 7468 6174 2068 6f6c 6473 2069 6e66 6f72  that holds infor
│ │ │ │ -00036710: 6d61 7469 6f6e 2061 626f 7574 2041 5020  mation about AP 
│ │ │ │ -00036720: 6578 6368 616e 6765 0a20 2020 2020 4150  exchange.     AP
│ │ │ │ -00036730: 5245 503a 2069 6e70 7574 2041 502d 5245  REP: input AP-RE
│ │ │ │ -00036740: 502e 0a0a 2020 2020 202a 4465 7363 7269  P...     *Descri
│ │ │ │ -00036750: 7074 696f 6e3a 2a20 5365 7420 7468 6520  ption:* Set the 
│ │ │ │ -00036760: 4150 2d52 4550 2069 6e20 7468 6520 4150  AP-REP in the AP
│ │ │ │ -00036770: 2065 7863 6861 6e67 6520 7573 696e 670a   exchange using.
│ │ │ │ -00036780: 2020 2020 20e2 8098 7368 6973 6869 5f61       ...shishi_a
│ │ │ │ -00036790: 705f 7265 705f 7365 7428 29e2 8099 2061  p_rep_set()... a
│ │ │ │ -000367a0: 6e64 2076 6572 6966 7920 6974 2075 7369  nd verify it usi
│ │ │ │ -000367b0: 6e67 20e2 8098 7368 6973 6869 5f61 705f  ng ...shishi_ap_
│ │ │ │ -000367c0: 7265 705f 7665 7269 6679 2829 e280 992e  rep_verify()....
│ │ │ │ -000367d0: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ -000367e0: 616c 7565 3a2a 2052 6574 7572 6e73 2053  alue:* Returns S
│ │ │ │ -000367f0: 4849 5348 495f 4f4b 2c20 5348 4953 4849  HISHI_OK, SHISHI
│ │ │ │ -00036800: 5f41 5052 4550 5f56 4552 4946 595f 4641  _APREP_VERIFY_FA
│ │ │ │ -00036810: 494c 4544 206f 7220 616e 0a20 2020 2020  ILED or an.     
│ │ │ │ -00036820: 6572 726f 722e 0a0a 7368 6973 6869 5f61  error...shishi_a
│ │ │ │ -00036830: 705f 656e 6361 7072 6570 7061 7274 0a2d  p_encapreppart.-
│ │ │ │ -00036840: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00036850: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ -00036860: 696f 6e3a 2053 6869 7368 695f 6173 6e31  ion: Shishi_asn1
│ │ │ │ -00036870: 2073 6869 7368 695f 6170 5f65 6e63 6170   shishi_ap_encap
│ │ │ │ -00036880: 7265 7070 6172 7420 2853 6869 7368 695f  reppart (Shishi_
│ │ │ │ -00036890: 6170 202a 2041 5029 0a20 2020 2020 4150  ap * AP).     AP
│ │ │ │ -000368a0: 3a20 7374 7275 6374 7572 6520 7468 6174  : structure that
│ │ │ │ -000368b0: 2068 6f6c 6473 2069 6e66 6f72 6d61 7469   holds informati
│ │ │ │ -000368c0: 6f6e 2061 626f 7574 2041 5020 6578 6368  on about AP exch
│ │ │ │ -000368d0: 616e 6765 0a0a 2020 2020 202a 4465 7363  ange..     *Desc
│ │ │ │ -000368e0: 7269 7074 696f 6e3a 2a20 4765 7420 4153  ription:* Get AS
│ │ │ │ -000368f0: 4e2e 3120 456e 6341 5052 6570 5061 7274  N.1 EncAPRepPart
│ │ │ │ -00036900: 2073 7472 7563 7475 7265 2066 726f 6d20   structure from 
│ │ │ │ -00036910: 4150 2065 7863 6861 6e67 652e 0a0a 2020  AP exchange...  
│ │ │ │ -00036920: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ -00036930: 3a2a 2052 6574 7572 6e73 2074 6865 2045  :* Returns the E
│ │ │ │ -00036940: 6e63 4150 5245 5050 6172 7420 6672 6f6d  ncAPREPPart from
│ │ │ │ -00036950: 2074 6865 2041 5020 6578 6368 616e 6765   the AP exchange
│ │ │ │ -00036960: 2c20 6f72 0a20 2020 2020 4e55 4c4c 2069  , or.     NULL i
│ │ │ │ -00036970: 6620 6e6f 7420 7965 7420 7365 7420 6f72  f not yet set or
│ │ │ │ -00036980: 2061 6e20 6572 726f 7220 6f63 6375 7265   an error occure
│ │ │ │ -00036990: 642e 0a0a 7368 6973 6869 5f61 705f 656e  d...shishi_ap_en
│ │ │ │ -000369a0: 6361 7072 6570 7061 7274 5f73 6574 0a2d  capreppart_set.-
│ │ │ │ -000369b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000369c0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ -000369d0: 756e 6374 696f 6e3a 2076 6f69 6420 7368  unction: void sh
│ │ │ │ -000369e0: 6973 6869 5f61 705f 656e 6361 7072 6570  ishi_ap_encaprep
│ │ │ │ -000369f0: 7061 7274 5f73 6574 2028 5368 6973 6869  part_set (Shishi
│ │ │ │ -00036a00: 5f61 7020 2a20 4150 2c0a 2020 2020 2020  _ap * AP,.      
│ │ │ │ -00036a10: 2020 2020 5368 6973 6869 5f61 736e 3120      Shishi_asn1 
│ │ │ │ -00036a20: 454e 4341 5052 4550 5041 5254 290a 2020  ENCAPREPPART).  
│ │ │ │ -00036a30: 2020 2041 503a 2073 7472 7563 7475 7265     AP: structure
│ │ │ │ -00036a40: 2074 6861 7420 686f 6c64 7320 696e 666f   that holds info
│ │ │ │ -00036a50: 726d 6174 696f 6e20 6162 6f75 7420 4150  rmation about AP
│ │ │ │ -00036a60: 2065 7863 6861 6e67 650a 2020 2020 2045   exchange.     E
│ │ │ │ -00036a70: 4e43 4150 5245 5050 4152 543a 2045 6e63  NCAPREPPART: Enc
│ │ │ │ -00036a80: 4150 5265 7050 6172 7420 746f 2073 746f  APRepPart to sto
│ │ │ │ -00036a90: 7265 2069 6e20 4150 2e0a 0a20 2020 2020  re in AP...     
│ │ │ │ -00036aa0: 2a44 6573 6372 6970 7469 6f6e 3a2a 2053  *Description:* S
│ │ │ │ -00036ab0: 6574 2074 6865 2045 6e63 4150 5265 7050  et the EncAPRepP
│ │ │ │ -00036ac0: 6172 7420 696e 2074 6865 2041 5020 6578  art in the AP ex
│ │ │ │ -00036ad0: 6368 616e 6765 2e0a 0a73 6869 7368 695f  change...shishi_
│ │ │ │ -00036ae0: 6170 5f6f 7074 696f 6e32 7374 7269 6e67  ap_option2string
│ │ │ │ -00036af0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ -00036b00: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -00036b10: 6e63 7469 6f6e 3a20 636f 6e73 7420 6368  nction: const ch
│ │ │ │ -00036b20: 6172 202a 2073 6869 7368 695f 6170 5f6f  ar * shishi_ap_o
│ │ │ │ -00036b30: 7074 696f 6e32 7374 7269 6e67 0a20 2020  ption2string.   
│ │ │ │ -00036b40: 2020 2020 2020 2028 5368 6973 6869 5f61         (Shishi_a
│ │ │ │ -00036b50: 706f 7074 696f 6e73 204f 5054 494f 4e29  poptions OPTION)
│ │ │ │ -00036b60: 0a20 2020 2020 4f50 5449 4f4e 3a20 656e  .     OPTION: en
│ │ │ │ -00036b70: 756d 6572 6174 6564 2041 502d 4f70 7469  umerated AP-Opti
│ │ │ │ -00036b80: 6f6e 2074 7970 652c 2073 6565 2053 6869  on type, see Shi
│ │ │ │ -00036b90: 7368 695f 6170 6f70 7469 6f6e 732e 0a0a  shi_apoptions...
│ │ │ │ -00036ba0: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ -00036bb0: 6e3a 2a20 436f 6e76 6572 7420 4150 2d4f  n:* Convert AP-O
│ │ │ │ -00036bc0: 7074 696f 6e20 7479 7065 2074 6f20 4150  ption type to AP
│ │ │ │ -00036bd0: 2d4f 7074 696f 6e20 6e61 6d65 2073 7472  -Option name str
│ │ │ │ -00036be0: 696e 672e 0a20 2020 2020 4e6f 7465 2074  ing..     Note t
│ │ │ │ -00036bf0: 6861 7420 4f50 5449 4f4e 206d 7573 7420  hat OPTION must 
│ │ │ │ -00036c00: 6265 206a 7573 7420 6f6e 6520 6f66 2074  be just one of t
│ │ │ │ -00036c10: 6865 2041 502d 4f70 7469 6f6e 2074 7970  he AP-Option typ
│ │ │ │ -00036c20: 6573 2c20 6974 2063 616e 6e6f 740a 2020  es, it cannot.  
│ │ │ │ -00036c30: 2020 2062 6520 616e 2062 696e 6172 7920     be an binary 
│ │ │ │ -00036c40: 4f52 6564 2069 6e64 6963 6174 696e 6720  ORed indicating 
│ │ │ │ -00036c50: 7365 7665 7261 6c20 4150 2d4f 7074 696f  several AP-Optio
│ │ │ │ -00036c60: 6e73 2e0a 0a20 2020 2020 2a52 6574 7572  ns...     *Retur
│ │ │ │ -00036c70: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ -00036c80: 7320 7374 6174 6963 2073 7472 696e 6720  s static string 
│ │ │ │ -00036c90: 7769 7468 206e 616d 6520 6f66 2041 502d  with name of AP-
│ │ │ │ -00036ca0: 4f70 7469 6f6e 2074 6861 740a 2020 2020  Option that.    
│ │ │ │ -00036cb0: 206d 7573 7420 6e6f 7420 6265 2064 6561   must not be dea
│ │ │ │ -00036cc0: 6c6c 6f63 6174 6564 2c20 6f72 2022 756e  llocated, or "un
│ │ │ │ -00036cd0: 6b6e 6f77 6e22 2069 6620 4150 2d4f 7074  known" if AP-Opt
│ │ │ │ -00036ce0: 696f 6e20 7761 7320 6e6f 740a 2020 2020  ion was not.    
│ │ │ │ -00036cf0: 2075 6e64 6572 7374 6f6f 642e 0a0a 7368   understood...sh
│ │ │ │ -00036d00: 6973 6869 5f61 705f 7374 7269 6e67 326f  ishi_ap_string2o
│ │ │ │ -00036d10: 7074 696f 6e0a 2d2d 2d2d 2d2d 2d2d 2d2d  ption.----------
│ │ │ │ -00036d20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -00036d30: 2d2d 2046 756e 6374 696f 6e3a 2053 6869  -- Function: Shi
│ │ │ │ -00036d40: 7368 695f 6170 6f70 7469 6f6e 7320 7368  shi_apoptions sh
│ │ │ │ -00036d50: 6973 6869 5f61 705f 7374 7269 6e67 326f  ishi_ap_string2o
│ │ │ │ -00036d60: 7074 696f 6e0a 2020 2020 2020 2020 2020  ption.          
│ │ │ │ -00036d70: 2863 6f6e 7374 2063 6861 7220 2a20 5354  (const char * ST
│ │ │ │ -00036d80: 5229 0a20 2020 2020 5354 523a 207a 6572  R).     STR: zer
│ │ │ │ -00036d90: 6f20 7465 726d 696e 6174 6564 2063 6861  o terminated cha
│ │ │ │ -00036da0: 7261 6374 6572 2061 7272 6179 2077 6974  racter array wit
│ │ │ │ -00036db0: 6820 6e61 6d65 206f 6620 4150 2d4f 7074  h name of AP-Opt
│ │ │ │ -00036dc0: 696f 6e2c 2065 2e67 2e0a 2020 2020 2022  ion, e.g..     "
│ │ │ │ -00036dd0: 7573 652d 7365 7373 696f 6e2d 6b65 7922  use-session-key"
│ │ │ │ -00036de0: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ -00036df0: 7469 6f6e 3a2a 2043 6f6e 7665 7274 2041  tion:* Convert A
│ │ │ │ -00036e00: 502d 4f70 7469 6f6e 206e 616d 6520 746f  P-Option name to
│ │ │ │ -00036e10: 2041 502d 4f70 7469 6f6e 2074 7970 652e   AP-Option type.
│ │ │ │ -00036e20: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ -00036e30: 616c 7565 3a2a 2052 6574 7572 6e73 2065  alue:* Returns e
│ │ │ │ -00036e40: 6e75 6d65 7261 7465 6420 7479 7065 206d  numerated type m
│ │ │ │ -00036e50: 656d 6265 7220 636f 7272 6573 706f 6e64  ember correspond
│ │ │ │ -00036e60: 696e 6720 746f 0a20 2020 2020 4150 2d4f  ing to.     AP-O
│ │ │ │ -00036e70: 7074 696f 6e2c 206f 7220 3020 6966 2073  ption, or 0 if s
│ │ │ │ -00036e80: 7472 696e 6720 7761 7320 6e6f 7420 756e  tring was not un
│ │ │ │ -00036e90: 6465 7273 746f 6f64 2e0a 0a73 6869 7368  derstood...shish
│ │ │ │ -00036ea0: 695f 6170 7265 710a 2d2d 2d2d 2d2d 2d2d  i_apreq.--------
│ │ │ │ -00036eb0: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -00036ec0: 6f6e 3a20 5368 6973 6869 5f61 736e 3120  on: Shishi_asn1 
│ │ │ │ -00036ed0: 7368 6973 6869 5f61 7072 6571 2028 5368  shishi_apreq (Sh
│ │ │ │ -00036ee0: 6973 6869 202a 2048 414e 444c 4529 0a20  ishi * HANDLE). 
│ │ │ │ -00036ef0: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ -00036f00: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ -00036f10: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ -00036f20: 7368 695f 696e 6974 2829 e280 992e 0a0a  shi_init()......
│ │ │ │ -00036f30: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ -00036f40: 6e3a 2a20 5468 6973 2066 756e 6374 696f  n:* This functio
│ │ │ │ -00036f50: 6e20 6372 6561 7465 7320 6120 6e65 7720  n creates a new 
│ │ │ │ -00036f60: 4150 2d52 4551 2c20 706f 7075 6c61 7465  AP-REQ, populate
│ │ │ │ -00036f70: 6420 7769 7468 0a20 2020 2020 736f 6d65  d with.     some
│ │ │ │ -00036f80: 2064 6566 6175 6c74 2076 616c 7565 732e   default values.
│ │ │ │ -00036f90: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ -00036fa0: 616c 7565 3a2a 2052 6574 7572 6e73 2074  alue:* Returns t
│ │ │ │ -00036fb0: 6865 2041 502d 5245 5120 6f72 204e 554c  he AP-REQ or NUL
│ │ │ │ -00036fc0: 4c20 6f6e 2066 6169 6c75 7265 2e0a 0a73  L on failure...s
│ │ │ │ -00036fd0: 6869 7368 695f 6170 7265 715f 7072 696e  hishi_apreq_prin
│ │ │ │ -00036fe0: 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  t.--------------
│ │ │ │ -00036ff0: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -00037000: 6f6e 3a20 696e 7420 7368 6973 6869 5f61  on: int shishi_a
│ │ │ │ -00037010: 7072 6571 5f70 7269 6e74 2028 5368 6973  preq_print (Shis
│ │ │ │ -00037020: 6869 202a 2048 414e 444c 452c 2046 494c  hi * HANDLE, FIL
│ │ │ │ -00037030: 4520 2a20 4648 2c0a 2020 2020 2020 2020  E * FH,.        
│ │ │ │ -00037040: 2020 5368 6973 6869 5f61 736e 3120 4150    Shishi_asn1 AP
│ │ │ │ -00037050: 5245 5129 0a20 2020 2020 4841 4e44 4c45  REQ).     HANDLE
│ │ │ │ -00037060: 3a20 7368 6973 6869 2068 616e 646c 6520  : shishi handle 
│ │ │ │ -00037070: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ -00037080: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ -00037090: e280 992e 0a20 2020 2020 4648 3a20 6669  .....     FH: fi
│ │ │ │ -000370a0: 6c65 2068 616e 646c 6520 6f70 656e 2066  le handle open f
│ │ │ │ -000370b0: 6f72 2077 7269 7469 6e67 2e0a 2020 2020  or writing..    
│ │ │ │ -000370c0: 2041 5052 4551 3a20 4150 2d52 4551 2074   APREQ: AP-REQ t
│ │ │ │ -000370d0: 6f20 7072 696e 742e 0a0a 2020 2020 202a  o print...     *
│ │ │ │ -000370e0: 4465 7363 7269 7074 696f 6e3a 2a20 5072  Description:* Pr
│ │ │ │ -000370f0: 696e 7420 4153 4349 4920 6172 6d6f 7265  int ASCII armore
│ │ │ │ -00037100: 6420 4445 5220 656e 636f 6469 6e67 206f  d DER encoding o
│ │ │ │ -00037110: 6620 4150 2d52 4551 2074 6f20 6669 6c65  f AP-REQ to file
│ │ │ │ -00037120: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ -00037130: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ -00037140: 5348 4953 4849 5f4f 4b20 6966 6620 7375  SHISHI_OK iff su
│ │ │ │ -00037150: 6363 6573 7366 756c 2e0a 0a73 6869 7368  ccessful...shish
│ │ │ │ -00037160: 695f 6170 7265 715f 7361 7665 0a2d 2d2d  i_apreq_save.---
│ │ │ │ -00037170: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -00037180: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ -00037190: 7420 7368 6973 6869 5f61 7072 6571 5f73  t shishi_apreq_s
│ │ │ │ -000371a0: 6176 6520 2853 6869 7368 6920 2a20 4841  ave (Shishi * HA
│ │ │ │ -000371b0: 4e44 4c45 2c20 4649 4c45 202a 2046 482c  NDLE, FILE * FH,
│ │ │ │ -000371c0: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ -000371d0: 695f 6173 6e31 2041 5052 4551 290a 2020  i_asn1 APREQ).  
│ │ │ │ -000371e0: 2020 2048 414e 444c 453a 2073 6869 7368     HANDLE: shish
│ │ │ │ -000371f0: 6920 6861 6e64 6c65 2061 7320 616c 6c6f  i handle as allo
│ │ │ │ -00037200: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ -00037210: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ -00037220: 2020 2046 483a 2066 696c 6520 6861 6e64     FH: file hand
│ │ │ │ -00037230: 6c65 206f 7065 6e20 666f 7220 7772 6974  le open for writ
│ │ │ │ -00037240: 696e 672e 0a20 2020 2020 4150 5245 513a  ing..     APREQ:
│ │ │ │ -00037250: 2041 502d 5245 5120 746f 2073 6176 652e   AP-REQ to save.
│ │ │ │ -00037260: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ -00037270: 696f 6e3a 2a20 5361 7665 2044 4552 2065  ion:* Save DER e
│ │ │ │ -00037280: 6e63 6f64 696e 6720 6f66 2041 502d 5245  ncoding of AP-RE
│ │ │ │ -00037290: 5120 746f 2066 696c 652e 0a0a 2020 2020  Q to file...    
│ │ │ │ -000372a0: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ -000372b0: 2052 6574 7572 6e73 2053 4849 5348 495f   Returns SHISHI_
│ │ │ │ -000372c0: 4f4b 2069 6666 2073 7563 6365 7373 6675  OK iff successfu
│ │ │ │ -000372d0: 6c2e 0a0a 7368 6973 6869 5f61 7072 6571  l...shishi_apreq
│ │ │ │ -000372e0: 5f74 6f5f 6669 6c65 0a2d 2d2d 2d2d 2d2d  _to_file.-------
│ │ │ │ -000372f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -00037300: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ -00037310: 2073 6869 7368 695f 6170 7265 715f 746f   shishi_apreq_to
│ │ │ │ -00037320: 5f66 696c 6520 2853 6869 7368 6920 2a20  _file (Shishi * 
│ │ │ │ -00037330: 4841 4e44 4c45 2c0a 2020 2020 2020 2020  HANDLE,.        
│ │ │ │ -00037340: 2020 5368 6973 6869 5f61 736e 3120 4150    Shishi_asn1 AP
│ │ │ │ -00037350: 5245 512c 2069 6e74 2046 494c 4554 5950  REQ, int FILETYP
│ │ │ │ -00037360: 452c 2063 6f6e 7374 2063 6861 7220 2a20  E, const char * 
│ │ │ │ -00037370: 4649 4c45 4e41 4d45 290a 2020 2020 2048  FILENAME).     H
│ │ │ │ -00037380: 414e 444c 453a 2073 6869 7368 6920 6861  ANDLE: shishi ha
│ │ │ │ -00037390: 6e64 6c65 2061 7320 616c 6c6f 6361 7465  ndle as allocate
│ │ │ │ -000373a0: 6420 6279 20e2 8098 7368 6973 6869 5f69  d by ...shishi_i
│ │ │ │ -000373b0: 6e69 7428 29e2 8099 2e0a 2020 2020 2041  nit().....     A
│ │ │ │ -000373c0: 5052 4551 3a20 4150 2d52 4551 2074 6f20  PREQ: AP-REQ to 
│ │ │ │ -000373d0: 7361 7665 2e0a 2020 2020 2046 494c 4554  save..     FILET
│ │ │ │ -000373e0: 5950 453a 2069 6e70 7574 2076 6172 6961  YPE: input varia
│ │ │ │ -000373f0: 626c 6520 7370 6563 6966 7969 6e67 2074  ble specifying t
│ │ │ │ -00037400: 7970 6520 6f66 2066 696c 6520 746f 2062  ype of file to b
│ │ │ │ -00037410: 6520 7772 6974 7465 6e2c 2073 6565 0a20  e written, see. 
│ │ │ │ -00037420: 2020 2020 5368 6973 6869 5f66 696c 6574      Shishi_filet
│ │ │ │ -00037430: 7970 652e 0a20 2020 2020 4649 4c45 4e41  ype..     FILENA
│ │ │ │ -00037440: 4d45 3a20 696e 7075 7420 7661 7269 6162  ME: input variab
│ │ │ │ -00037450: 6c65 2077 6974 6820 6669 6c65 6e61 6d65  le with filename
│ │ │ │ -00037460: 2074 6f20 7772 6974 6520 746f 2e0a 0a20   to write to... 
│ │ │ │ -00037470: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -00037480: 3a2a 2057 7269 7465 2041 502d 5245 5120  :* Write AP-REQ 
│ │ │ │ -00037490: 746f 2066 696c 6520 696e 2073 7065 6369  to file in speci
│ │ │ │ -000374a0: 6669 6564 2054 5950 452e 2054 6865 2066  fied TYPE. The f
│ │ │ │ -000374b0: 696c 650a 2020 2020 2077 696c 6c20 6265  ile.     will be
│ │ │ │ -000374c0: 2074 7275 6e63 6174 6564 2069 6620 6974   truncated if it
│ │ │ │ -000374d0: 2065 7869 7374 732e 0a0a 2020 2020 202a   exists...     *
│ │ │ │ -000374e0: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ -000374f0: 6574 7572 6e73 2053 4849 5348 495f 4f4b  eturns SHISHI_OK
│ │ │ │ -00037500: 2069 6666 2073 7563 6365 7373 6675 6c2e   iff successful.
│ │ │ │ -00037510: 0a0a 7368 6973 6869 5f61 7072 6571 5f70  ..shishi_apreq_p
│ │ │ │ -00037520: 6172 7365 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  arse.-----------
│ │ │ │ -00037530: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ -00037540: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ -00037550: 695f 6170 7265 715f 7061 7273 6520 2853  i_apreq_parse (S
│ │ │ │ -00037560: 6869 7368 6920 2a20 4841 4e44 4c45 2c20  hishi * HANDLE, 
│ │ │ │ -00037570: 4649 4c45 202a 2046 482c 0a20 2020 2020  FILE * FH,.     
│ │ │ │ -00037580: 2020 2020 2053 6869 7368 695f 6173 6e31       Shishi_asn1
│ │ │ │ -00037590: 202a 2041 5052 4551 290a 2020 2020 2048   * APREQ).     H
│ │ │ │ -000375a0: 414e 444c 453a 2073 6869 7368 6920 6861  ANDLE: shishi ha
│ │ │ │ -000375b0: 6e64 6c65 2061 7320 616c 6c6f 6361 7465  ndle as allocate
│ │ │ │ -000375c0: 6420 6279 20e2 8098 7368 6973 6869 5f69  d by ...shishi_i
│ │ │ │ -000375d0: 6e69 7428 29e2 8099 2e0a 2020 2020 2046  nit().....     F
│ │ │ │ -000375e0: 483a 2066 696c 6520 6861 6e64 6c65 206f  H: file handle o
│ │ │ │ -000375f0: 7065 6e20 666f 7220 7265 6164 696e 672e  pen for reading.
│ │ │ │ -00037600: 0a20 2020 2020 4150 5245 513a 206f 7574  .     APREQ: out
│ │ │ │ -00037610: 7075 7420 7661 7269 6162 6c65 2077 6974  put variable wit
│ │ │ │ -00037620: 6820 6e65 776c 7920 616c 6c6f 6361 7465  h newly allocate
│ │ │ │ -00037630: 6420 4150 2d52 4551 2e0a 0a20 2020 2020  d AP-REQ...     
│ │ │ │ -00037640: 2a44 6573 6372 6970 7469 6f6e 3a2a 2052  *Description:* R
│ │ │ │ -00037650: 6561 6420 4153 4349 4920 6172 6d6f 7265  ead ASCII armore
│ │ │ │ -00037660: 6420 4445 5220 656e 636f 6465 6420 4150  d DER encoded AP
│ │ │ │ -00037670: 2d52 4551 2066 726f 6d20 6669 6c65 2061  -REQ from file a
│ │ │ │ -00037680: 6e64 0a20 2020 2020 706f 7075 6c61 7465  nd.     populate
│ │ │ │ -00037690: 2067 6976 656e 2076 6172 6961 626c 652e   given variable.
│ │ │ │ -000376a0: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ -000376b0: 616c 7565 3a2a 2052 6574 7572 6e73 2053  alue:* Returns S
│ │ │ │ -000376c0: 4849 5348 495f 4f4b 2069 6666 2073 7563  HISHI_OK iff suc
│ │ │ │ -000376d0: 6365 7373 6675 6c2e 0a0a 7368 6973 6869  cessful...shishi
│ │ │ │ -000376e0: 5f61 7072 6571 5f72 6561 640a 2d2d 2d2d  _apreq_read.----
│ │ │ │ -000376f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -00037700: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ -00037710: 2073 6869 7368 695f 6170 7265 715f 7265   shishi_apreq_re
│ │ │ │ -00037720: 6164 2028 5368 6973 6869 202a 2048 414e  ad (Shishi * HAN
│ │ │ │ -00037730: 444c 452c 2046 494c 4520 2a20 4648 2c0a  DLE, FILE * FH,.
│ │ │ │ -00037740: 2020 2020 2020 2020 2020 5368 6973 6869            Shishi
│ │ │ │ -00037750: 5f61 736e 3120 2a20 4150 5245 5129 0a20  _asn1 * APREQ). 
│ │ │ │ -00037760: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ -00037770: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ -00037780: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ -00037790: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ -000377a0: 2020 2020 4648 3a20 6669 6c65 2068 616e      FH: file han
│ │ │ │ -000377b0: 646c 6520 6f70 656e 2066 6f72 2072 6561  dle open for rea
│ │ │ │ -000377c0: 6469 6e67 2e0a 2020 2020 2041 5052 4551  ding..     APREQ
│ │ │ │ -000377d0: 3a20 6f75 7470 7574 2076 6172 6961 626c  : output variabl
│ │ │ │ -000377e0: 6520 7769 7468 206e 6577 6c79 2061 6c6c  e with newly all
│ │ │ │ -000377f0: 6f63 6174 6564 2041 502d 5245 512e 0a0a  ocated AP-REQ...
│ │ │ │ -00037800: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ -00037810: 6e3a 2a20 5265 6164 2044 4552 2065 6e63  n:* Read DER enc
│ │ │ │ -00037820: 6f64 6564 2041 502d 5245 5120 6672 6f6d  oded AP-REQ from
│ │ │ │ -00037830: 2066 696c 6520 616e 6420 706f 7075 6c61   file and popula
│ │ │ │ -00037840: 7465 2067 6976 656e 0a20 2020 2020 7661  te given.     va
│ │ │ │ -00037850: 7269 6162 6c65 2e0a 0a20 2020 2020 2a52  riable...     *R
│ │ │ │ -00037860: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ -00037870: 7475 726e 7320 5348 4953 4849 5f4f 4b20  turns SHISHI_OK 
│ │ │ │ -00037880: 6966 6620 7375 6363 6573 7366 756c 2e0a  iff successful..
│ │ │ │ -00037890: 0a73 6869 7368 695f 6170 7265 715f 6672  .shishi_apreq_fr
│ │ │ │ -000378a0: 6f6d 5f66 696c 650a 2d2d 2d2d 2d2d 2d2d  om_file.--------
│ │ │ │ -000378b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -000378c0: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ -000378d0: 7420 7368 6973 6869 5f61 7072 6571 5f66  t shishi_apreq_f
│ │ │ │ -000378e0: 726f 6d5f 6669 6c65 2028 5368 6973 6869  rom_file (Shishi
│ │ │ │ -000378f0: 202a 2048 414e 444c 452c 0a20 2020 2020   * HANDLE,.     
│ │ │ │ -00037900: 2020 2020 2053 6869 7368 695f 6173 6e31       Shishi_asn1
│ │ │ │ -00037910: 202a 2041 5052 4551 2c20 696e 7420 4649   * APREQ, int FI
│ │ │ │ -00037920: 4c45 5459 5045 2c20 636f 6e73 7420 6368  LETYPE, const ch
│ │ │ │ -00037930: 6172 202a 2046 494c 454e 414d 4529 0a20  ar * FILENAME). 
│ │ │ │ -00037940: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ -00037950: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ -00037960: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ -00037970: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ -00037980: 2020 2020 4150 5245 513a 206f 7574 7075      APREQ: outpu
│ │ │ │ -00037990: 7420 7661 7269 6162 6c65 2077 6974 6820  t variable with 
│ │ │ │ -000379a0: 6e65 776c 7920 616c 6c6f 6361 7465 6420  newly allocated 
│ │ │ │ -000379b0: 4150 2d52 4551 2e0a 2020 2020 2046 494c  AP-REQ..     FIL
│ │ │ │ -000379c0: 4554 5950 453a 2069 6e70 7574 2076 6172  ETYPE: input var
│ │ │ │ -000379d0: 6961 626c 6520 7370 6563 6966 7969 6e67  iable specifying
│ │ │ │ -000379e0: 2074 7970 6520 6f66 2066 696c 6520 746f   type of file to
│ │ │ │ -000379f0: 2062 6520 7265 6164 2c20 7365 650a 2020   be read, see.  
│ │ │ │ -00037a00: 2020 2053 6869 7368 695f 6669 6c65 7479     Shishi_filety
│ │ │ │ -00037a10: 7065 2e0a 2020 2020 2046 494c 454e 414d  pe..     FILENAM
│ │ │ │ -00037a20: 453a 2069 6e70 7574 2076 6172 6961 626c  E: input variabl
│ │ │ │ -00037a30: 6520 7769 7468 2066 696c 656e 616d 6520  e with filename 
│ │ │ │ -00037a40: 746f 2072 6561 6420 6672 6f6d 2e0a 0a20  to read from... 
│ │ │ │ -00037a50: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -00037a60: 3a2a 2052 6561 6420 4150 2d52 4551 2066  :* Read AP-REQ f
│ │ │ │ -00037a70: 726f 6d20 6669 6c65 2069 6e20 7370 6563  rom file in spec
│ │ │ │ -00037a80: 6966 6965 6420 5459 5045 2e0a 0a20 2020  ified TYPE...   
│ │ │ │ -00037a90: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ -00037aa0: 2a20 5265 7475 726e 7320 5348 4953 4849  * Returns SHISHI
│ │ │ │ -00037ab0: 5f4f 4b20 6966 6620 7375 6363 6573 7366  _OK iff successf
│ │ │ │ -00037ac0: 756c 2e0a 0a73 6869 7368 695f 6170 7265  ul...shishi_apre
│ │ │ │ -00037ad0: 715f 7365 745f 6175 7468 656e 7469 6361  q_set_authentica
│ │ │ │ -00037ae0: 746f 720a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  tor.------------
│ │ │ │ +00036690: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ +000366a0: 6e3a 2069 6e74 2073 6869 7368 695f 6170  n: int shishi_ap
│ │ │ │ +000366b0: 5f72 6570 5f76 6572 6966 795f 6173 6e31  _rep_verify_asn1
│ │ │ │ +000366c0: 2028 5368 6973 6869 5f61 7020 2a20 4150   (Shishi_ap * AP
│ │ │ │ +000366d0: 2c0a 2020 2020 2020 2020 2020 5368 6973  ,.          Shis
│ │ │ │ +000366e0: 6869 5f61 736e 3120 4150 5245 5029 0a20  hi_asn1 APREP). 
│ │ │ │ +000366f0: 2020 2020 4150 3a20 7374 7275 6374 7572      AP: structur
│ │ │ │ +00036700: 6520 7468 6174 2068 6f6c 6473 2069 6e66  e that holds inf
│ │ │ │ +00036710: 6f72 6d61 7469 6f6e 2061 626f 7574 2041  ormation about A
│ │ │ │ +00036720: 5020 6578 6368 616e 6765 0a20 2020 2020  P exchange.     
│ │ │ │ +00036730: 4150 5245 503a 2069 6e70 7574 2041 502d  APREP: input AP-
│ │ │ │ +00036740: 5245 502e 0a0a 2020 2020 202a 4465 7363  REP...     *Desc
│ │ │ │ +00036750: 7269 7074 696f 6e3a 2a20 5365 7420 7468  ription:* Set th
│ │ │ │ +00036760: 6520 4150 2d52 4550 2069 6e20 7468 6520  e AP-REP in the 
│ │ │ │ +00036770: 4150 2065 7863 6861 6e67 6520 7573 696e  AP exchange usin
│ │ │ │ +00036780: 670a 2020 2020 20e2 8098 7368 6973 6869  g.     ...shishi
│ │ │ │ +00036790: 5f61 705f 7265 705f 7365 7428 29e2 8099  _ap_rep_set()...
│ │ │ │ +000367a0: 2061 6e64 2076 6572 6966 7920 6974 2075   and verify it u
│ │ │ │ +000367b0: 7369 6e67 20e2 8098 7368 6973 6869 5f61  sing ...shishi_a
│ │ │ │ +000367c0: 705f 7265 705f 7665 7269 6679 2829 e280  p_rep_verify()..
│ │ │ │ +000367d0: 992e 0a0a 2020 2020 202a 5265 7475 726e  ....     *Return
│ │ │ │ +000367e0: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ +000367f0: 2053 4849 5348 495f 4f4b 2c20 5348 4953   SHISHI_OK, SHIS
│ │ │ │ +00036800: 4849 5f41 5052 4550 5f56 4552 4946 595f  HI_APREP_VERIFY_
│ │ │ │ +00036810: 4641 494c 4544 206f 7220 616e 0a20 2020  FAILED or an.   
│ │ │ │ +00036820: 2020 6572 726f 722e 0a0a 7368 6973 6869    error...shishi
│ │ │ │ +00036830: 5f61 705f 656e 6361 7072 6570 7061 7274  _ap_encapreppart
│ │ │ │ +00036840: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ +00036850: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +00036860: 6374 696f 6e3a 2053 6869 7368 695f 6173  ction: Shishi_as
│ │ │ │ +00036870: 6e31 2073 6869 7368 695f 6170 5f65 6e63  n1 shishi_ap_enc
│ │ │ │ +00036880: 6170 7265 7070 6172 7420 2853 6869 7368  apreppart (Shish
│ │ │ │ +00036890: 695f 6170 202a 2041 5029 0a20 2020 2020  i_ap * AP).     
│ │ │ │ +000368a0: 4150 3a20 7374 7275 6374 7572 6520 7468  AP: structure th
│ │ │ │ +000368b0: 6174 2068 6f6c 6473 2069 6e66 6f72 6d61  at holds informa
│ │ │ │ +000368c0: 7469 6f6e 2061 626f 7574 2041 5020 6578  tion about AP ex
│ │ │ │ +000368d0: 6368 616e 6765 0a0a 2020 2020 202a 4465  change..     *De
│ │ │ │ +000368e0: 7363 7269 7074 696f 6e3a 2a20 4765 7420  scription:* Get 
│ │ │ │ +000368f0: 4153 4e2e 3120 456e 6341 5052 6570 5061  ASN.1 EncAPRepPa
│ │ │ │ +00036900: 7274 2073 7472 7563 7475 7265 2066 726f  rt structure fro
│ │ │ │ +00036910: 6d20 4150 2065 7863 6861 6e67 652e 0a0a  m AP exchange...
│ │ │ │ +00036920: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ +00036930: 7565 3a2a 2052 6574 7572 6e73 2074 6865  ue:* Returns the
│ │ │ │ +00036940: 2045 6e63 4150 5245 5050 6172 7420 6672   EncAPREPPart fr
│ │ │ │ +00036950: 6f6d 2074 6865 2041 5020 6578 6368 616e  om the AP exchan
│ │ │ │ +00036960: 6765 2c20 6f72 0a20 2020 2020 4e55 4c4c  ge, or.     NULL
│ │ │ │ +00036970: 2069 6620 6e6f 7420 7965 7420 7365 7420   if not yet set 
│ │ │ │ +00036980: 6f72 2061 6e20 6572 726f 7220 6f63 6375  or an error occu
│ │ │ │ +00036990: 7265 642e 0a0a 7368 6973 6869 5f61 705f  red...shishi_ap_
│ │ │ │ +000369a0: 656e 6361 7072 6570 7061 7274 5f73 6574  encapreppart_set
│ │ │ │ +000369b0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ +000369c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ +000369d0: 2046 756e 6374 696f 6e3a 2076 6f69 6420   Function: void 
│ │ │ │ +000369e0: 7368 6973 6869 5f61 705f 656e 6361 7072  shishi_ap_encapr
│ │ │ │ +000369f0: 6570 7061 7274 5f73 6574 2028 5368 6973  eppart_set (Shis
│ │ │ │ +00036a00: 6869 5f61 7020 2a20 4150 2c0a 2020 2020  hi_ap * AP,.    
│ │ │ │ +00036a10: 2020 2020 2020 5368 6973 6869 5f61 736e        Shishi_asn
│ │ │ │ +00036a20: 3120 454e 4341 5052 4550 5041 5254 290a  1 ENCAPREPPART).
│ │ │ │ +00036a30: 2020 2020 2041 503a 2073 7472 7563 7475       AP: structu
│ │ │ │ +00036a40: 7265 2074 6861 7420 686f 6c64 7320 696e  re that holds in
│ │ │ │ +00036a50: 666f 726d 6174 696f 6e20 6162 6f75 7420  formation about 
│ │ │ │ +00036a60: 4150 2065 7863 6861 6e67 650a 2020 2020  AP exchange.    
│ │ │ │ +00036a70: 2045 4e43 4150 5245 5050 4152 543a 2045   ENCAPREPPART: E
│ │ │ │ +00036a80: 6e63 4150 5265 7050 6172 7420 746f 2073  ncAPRepPart to s
│ │ │ │ +00036a90: 746f 7265 2069 6e20 4150 2e0a 0a20 2020  tore in AP...   
│ │ │ │ +00036aa0: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ +00036ab0: 2053 6574 2074 6865 2045 6e63 4150 5265   Set the EncAPRe
│ │ │ │ +00036ac0: 7050 6172 7420 696e 2074 6865 2041 5020  pPart in the AP 
│ │ │ │ +00036ad0: 6578 6368 616e 6765 2e0a 0a73 6869 7368  exchange...shish
│ │ │ │ +00036ae0: 695f 6170 5f6f 7074 696f 6e32 7374 7269  i_ap_option2stri
│ │ │ │ +00036af0: 6e67 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ng.-------------
│ │ │ │ +00036b00: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +00036b10: 4675 6e63 7469 6f6e 3a20 636f 6e73 7420  Function: const 
│ │ │ │ +00036b20: 6368 6172 202a 2073 6869 7368 695f 6170  char * shishi_ap
│ │ │ │ +00036b30: 5f6f 7074 696f 6e32 7374 7269 6e67 0a20  _option2string. 
│ │ │ │ +00036b40: 2020 2020 2020 2020 2028 5368 6973 6869           (Shishi
│ │ │ │ +00036b50: 5f61 706f 7074 696f 6e73 204f 5054 494f  _apoptions OPTIO
│ │ │ │ +00036b60: 4e29 0a20 2020 2020 4f50 5449 4f4e 3a20  N).     OPTION: 
│ │ │ │ +00036b70: 656e 756d 6572 6174 6564 2041 502d 4f70  enumerated AP-Op
│ │ │ │ +00036b80: 7469 6f6e 2074 7970 652c 2073 6565 2053  tion type, see S
│ │ │ │ +00036b90: 6869 7368 695f 6170 6f70 7469 6f6e 732e  hishi_apoptions.
│ │ │ │ +00036ba0: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ +00036bb0: 696f 6e3a 2a20 436f 6e76 6572 7420 4150  ion:* Convert AP
│ │ │ │ +00036bc0: 2d4f 7074 696f 6e20 7479 7065 2074 6f20  -Option type to 
│ │ │ │ +00036bd0: 4150 2d4f 7074 696f 6e20 6e61 6d65 2073  AP-Option name s
│ │ │ │ +00036be0: 7472 696e 672e 0a20 2020 2020 4e6f 7465  tring..     Note
│ │ │ │ +00036bf0: 2074 6861 7420 4f50 5449 4f4e 206d 7573   that OPTION mus
│ │ │ │ +00036c00: 7420 6265 206a 7573 7420 6f6e 6520 6f66  t be just one of
│ │ │ │ +00036c10: 2074 6865 2041 502d 4f70 7469 6f6e 2074   the AP-Option t
│ │ │ │ +00036c20: 7970 6573 2c20 6974 2063 616e 6e6f 740a  ypes, it cannot.
│ │ │ │ +00036c30: 2020 2020 2062 6520 616e 2062 696e 6172       be an binar
│ │ │ │ +00036c40: 7920 4f52 6564 2069 6e64 6963 6174 696e  y ORed indicatin
│ │ │ │ +00036c50: 6720 7365 7665 7261 6c20 4150 2d4f 7074  g several AP-Opt
│ │ │ │ +00036c60: 696f 6e73 2e0a 0a20 2020 2020 2a52 6574  ions...     *Ret
│ │ │ │ +00036c70: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ +00036c80: 726e 7320 7374 6174 6963 2073 7472 696e  rns static strin
│ │ │ │ +00036c90: 6720 7769 7468 206e 616d 6520 6f66 2041  g with name of A
│ │ │ │ +00036ca0: 502d 4f70 7469 6f6e 2074 6861 740a 2020  P-Option that.  
│ │ │ │ +00036cb0: 2020 206d 7573 7420 6e6f 7420 6265 2064     must not be d
│ │ │ │ +00036cc0: 6561 6c6c 6f63 6174 6564 2c20 6f72 2022  eallocated, or "
│ │ │ │ +00036cd0: 756e 6b6e 6f77 6e22 2069 6620 4150 2d4f  unknown" if AP-O
│ │ │ │ +00036ce0: 7074 696f 6e20 7761 7320 6e6f 740a 2020  ption was not.  
│ │ │ │ +00036cf0: 2020 2075 6e64 6572 7374 6f6f 642e 0a0a     understood...
│ │ │ │ +00036d00: 7368 6973 6869 5f61 705f 7374 7269 6e67  shishi_ap_string
│ │ │ │ +00036d10: 326f 7074 696f 6e0a 2d2d 2d2d 2d2d 2d2d  2option.--------
│ │ │ │ +00036d20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +00036d30: 0a20 2d2d 2046 756e 6374 696f 6e3a 2053  . -- Function: S
│ │ │ │ +00036d40: 6869 7368 695f 6170 6f70 7469 6f6e 7320  hishi_apoptions 
│ │ │ │ +00036d50: 7368 6973 6869 5f61 705f 7374 7269 6e67  shishi_ap_string
│ │ │ │ +00036d60: 326f 7074 696f 6e0a 2020 2020 2020 2020  2option.        
│ │ │ │ +00036d70: 2020 2863 6f6e 7374 2063 6861 7220 2a20    (const char * 
│ │ │ │ +00036d80: 5354 5229 0a20 2020 2020 5354 523a 207a  STR).     STR: z
│ │ │ │ +00036d90: 6572 6f20 7465 726d 696e 6174 6564 2063  ero terminated c
│ │ │ │ +00036da0: 6861 7261 6374 6572 2061 7272 6179 2077  haracter array w
│ │ │ │ +00036db0: 6974 6820 6e61 6d65 206f 6620 4150 2d4f  ith name of AP-O
│ │ │ │ +00036dc0: 7074 696f 6e2c 2065 2e67 2e0a 2020 2020  ption, e.g..    
│ │ │ │ +00036dd0: 2022 7573 652d 7365 7373 696f 6e2d 6b65   "use-session-ke
│ │ │ │ +00036de0: 7922 2e0a 0a20 2020 2020 2a44 6573 6372  y"...     *Descr
│ │ │ │ +00036df0: 6970 7469 6f6e 3a2a 2043 6f6e 7665 7274  iption:* Convert
│ │ │ │ +00036e00: 2041 502d 4f70 7469 6f6e 206e 616d 6520   AP-Option name 
│ │ │ │ +00036e10: 746f 2041 502d 4f70 7469 6f6e 2074 7970  to AP-Option typ
│ │ │ │ +00036e20: 652e 0a0a 2020 2020 202a 5265 7475 726e  e...     *Return
│ │ │ │ +00036e30: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ +00036e40: 2065 6e75 6d65 7261 7465 6420 7479 7065   enumerated type
│ │ │ │ +00036e50: 206d 656d 6265 7220 636f 7272 6573 706f   member correspo
│ │ │ │ +00036e60: 6e64 696e 6720 746f 0a20 2020 2020 4150  nding to.     AP
│ │ │ │ +00036e70: 2d4f 7074 696f 6e2c 206f 7220 3020 6966  -Option, or 0 if
│ │ │ │ +00036e80: 2073 7472 696e 6720 7761 7320 6e6f 7420   string was not 
│ │ │ │ +00036e90: 756e 6465 7273 746f 6f64 2e0a 0a73 6869  understood...shi
│ │ │ │ +00036ea0: 7368 695f 6170 7265 710a 2d2d 2d2d 2d2d  shi_apreq.------
│ │ │ │ +00036eb0: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ +00036ec0: 7469 6f6e 3a20 5368 6973 6869 5f61 736e  tion: Shishi_asn
│ │ │ │ +00036ed0: 3120 7368 6973 6869 5f61 7072 6571 2028  1 shishi_apreq (
│ │ │ │ +00036ee0: 5368 6973 6869 202a 2048 414e 444c 4529  Shishi * HANDLE)
│ │ │ │ +00036ef0: 0a20 2020 2020 4841 4e44 4c45 3a20 7368  .     HANDLE: sh
│ │ │ │ +00036f00: 6973 6869 2068 616e 646c 6520 6173 2061  ishi handle as a
│ │ │ │ +00036f10: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ +00036f20: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ +00036f30: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ +00036f40: 696f 6e3a 2a20 5468 6973 2066 756e 6374  ion:* This funct
│ │ │ │ +00036f50: 696f 6e20 6372 6561 7465 7320 6120 6e65  ion creates a ne
│ │ │ │ +00036f60: 7720 4150 2d52 4551 2c20 706f 7075 6c61  w AP-REQ, popula
│ │ │ │ +00036f70: 7465 6420 7769 7468 0a20 2020 2020 736f  ted with.     so
│ │ │ │ +00036f80: 6d65 2064 6566 6175 6c74 2076 616c 7565  me default value
│ │ │ │ +00036f90: 732e 0a0a 2020 2020 202a 5265 7475 726e  s...     *Return
│ │ │ │ +00036fa0: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ +00036fb0: 2074 6865 2041 502d 5245 5120 6f72 204e   the AP-REQ or N
│ │ │ │ +00036fc0: 554c 4c20 6f6e 2066 6169 6c75 7265 2e0a  ULL on failure..
│ │ │ │ +00036fd0: 0a73 6869 7368 695f 6170 7265 715f 7072  .shishi_apreq_pr
│ │ │ │ +00036fe0: 696e 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  int.------------
│ │ │ │ +00036ff0: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ +00037000: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ +00037010: 5f61 7072 6571 5f70 7269 6e74 2028 5368  _apreq_print (Sh
│ │ │ │ +00037020: 6973 6869 202a 2048 414e 444c 452c 2046  ishi * HANDLE, F
│ │ │ │ +00037030: 494c 4520 2a20 4648 2c0a 2020 2020 2020  ILE * FH,.      
│ │ │ │ +00037040: 2020 2020 5368 6973 6869 5f61 736e 3120      Shishi_asn1 
│ │ │ │ +00037050: 4150 5245 5129 0a20 2020 2020 4841 4e44  APREQ).     HAND
│ │ │ │ +00037060: 4c45 3a20 7368 6973 6869 2068 616e 646c  LE: shishi handl
│ │ │ │ +00037070: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ +00037080: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ +00037090: 2829 e280 992e 0a20 2020 2020 4648 3a20  ().....     FH: 
│ │ │ │ +000370a0: 6669 6c65 2068 616e 646c 6520 6f70 656e  file handle open
│ │ │ │ +000370b0: 2066 6f72 2077 7269 7469 6e67 2e0a 2020   for writing..  
│ │ │ │ +000370c0: 2020 2041 5052 4551 3a20 4150 2d52 4551     APREQ: AP-REQ
│ │ │ │ +000370d0: 2074 6f20 7072 696e 742e 0a0a 2020 2020   to print...    
│ │ │ │ +000370e0: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ +000370f0: 5072 696e 7420 4153 4349 4920 6172 6d6f  Print ASCII armo
│ │ │ │ +00037100: 7265 6420 4445 5220 656e 636f 6469 6e67  red DER encoding
│ │ │ │ +00037110: 206f 6620 4150 2d52 4551 2074 6f20 6669   of AP-REQ to fi
│ │ │ │ +00037120: 6c65 2e0a 0a20 2020 2020 2a52 6574 7572  le...     *Retur
│ │ │ │ +00037130: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ +00037140: 7320 5348 4953 4849 5f4f 4b20 6966 6620  s SHISHI_OK iff 
│ │ │ │ +00037150: 7375 6363 6573 7366 756c 2e0a 0a73 6869  successful...shi
│ │ │ │ +00037160: 7368 695f 6170 7265 715f 7361 7665 0a2d  shi_apreq_save.-
│ │ │ │ +00037170: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +00037180: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +00037190: 696e 7420 7368 6973 6869 5f61 7072 6571  int shishi_apreq
│ │ │ │ +000371a0: 5f73 6176 6520 2853 6869 7368 6920 2a20  _save (Shishi * 
│ │ │ │ +000371b0: 4841 4e44 4c45 2c20 4649 4c45 202a 2046  HANDLE, FILE * F
│ │ │ │ +000371c0: 482c 0a20 2020 2020 2020 2020 2053 6869  H,.          Shi
│ │ │ │ +000371d0: 7368 695f 6173 6e31 2041 5052 4551 290a  shi_asn1 APREQ).
│ │ │ │ +000371e0: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ +000371f0: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ +00037200: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ +00037210: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ +00037220: 2020 2020 2046 483a 2066 696c 6520 6861       FH: file ha
│ │ │ │ +00037230: 6e64 6c65 206f 7065 6e20 666f 7220 7772  ndle open for wr
│ │ │ │ +00037240: 6974 696e 672e 0a20 2020 2020 4150 5245  iting..     APRE
│ │ │ │ +00037250: 513a 2041 502d 5245 5120 746f 2073 6176  Q: AP-REQ to sav
│ │ │ │ +00037260: 652e 0a0a 2020 2020 202a 4465 7363 7269  e...     *Descri
│ │ │ │ +00037270: 7074 696f 6e3a 2a20 5361 7665 2044 4552  ption:* Save DER
│ │ │ │ +00037280: 2065 6e63 6f64 696e 6720 6f66 2041 502d   encoding of AP-
│ │ │ │ +00037290: 5245 5120 746f 2066 696c 652e 0a0a 2020  REQ to file...  
│ │ │ │ +000372a0: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ +000372b0: 3a2a 2052 6574 7572 6e73 2053 4849 5348  :* Returns SHISH
│ │ │ │ +000372c0: 495f 4f4b 2069 6666 2073 7563 6365 7373  I_OK iff success
│ │ │ │ +000372d0: 6675 6c2e 0a0a 7368 6973 6869 5f61 7072  ful...shishi_apr
│ │ │ │ +000372e0: 6571 5f74 6f5f 6669 6c65 0a2d 2d2d 2d2d  eq_to_file.-----
│ │ │ │ +000372f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +00037300: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ +00037310: 6e74 2073 6869 7368 695f 6170 7265 715f  nt shishi_apreq_
│ │ │ │ +00037320: 746f 5f66 696c 6520 2853 6869 7368 6920  to_file (Shishi 
│ │ │ │ +00037330: 2a20 4841 4e44 4c45 2c0a 2020 2020 2020  * HANDLE,.      
│ │ │ │ +00037340: 2020 2020 5368 6973 6869 5f61 736e 3120      Shishi_asn1 
│ │ │ │ +00037350: 4150 5245 512c 2069 6e74 2046 494c 4554  APREQ, int FILET
│ │ │ │ +00037360: 5950 452c 2063 6f6e 7374 2063 6861 7220  YPE, const char 
│ │ │ │ +00037370: 2a20 4649 4c45 4e41 4d45 290a 2020 2020  * FILENAME).    
│ │ │ │ +00037380: 2048 414e 444c 453a 2073 6869 7368 6920   HANDLE: shishi 
│ │ │ │ +00037390: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ +000373a0: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ +000373b0: 5f69 6e69 7428 29e2 8099 2e0a 2020 2020  _init().....    
│ │ │ │ +000373c0: 2041 5052 4551 3a20 4150 2d52 4551 2074   APREQ: AP-REQ t
│ │ │ │ +000373d0: 6f20 7361 7665 2e0a 2020 2020 2046 494c  o save..     FIL
│ │ │ │ +000373e0: 4554 5950 453a 2069 6e70 7574 2076 6172  ETYPE: input var
│ │ │ │ +000373f0: 6961 626c 6520 7370 6563 6966 7969 6e67  iable specifying
│ │ │ │ +00037400: 2074 7970 6520 6f66 2066 696c 6520 746f   type of file to
│ │ │ │ +00037410: 2062 6520 7772 6974 7465 6e2c 2073 6565   be written, see
│ │ │ │ +00037420: 0a20 2020 2020 5368 6973 6869 5f66 696c  .     Shishi_fil
│ │ │ │ +00037430: 6574 7970 652e 0a20 2020 2020 4649 4c45  etype..     FILE
│ │ │ │ +00037440: 4e41 4d45 3a20 696e 7075 7420 7661 7269  NAME: input vari
│ │ │ │ +00037450: 6162 6c65 2077 6974 6820 6669 6c65 6e61  able with filena
│ │ │ │ +00037460: 6d65 2074 6f20 7772 6974 6520 746f 2e0a  me to write to..
│ │ │ │ +00037470: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +00037480: 6f6e 3a2a 2057 7269 7465 2041 502d 5245  on:* Write AP-RE
│ │ │ │ +00037490: 5120 746f 2066 696c 6520 696e 2073 7065  Q to file in spe
│ │ │ │ +000374a0: 6369 6669 6564 2054 5950 452e 2054 6865  cified TYPE. The
│ │ │ │ +000374b0: 2066 696c 650a 2020 2020 2077 696c 6c20   file.     will 
│ │ │ │ +000374c0: 6265 2074 7275 6e63 6174 6564 2069 6620  be truncated if 
│ │ │ │ +000374d0: 6974 2065 7869 7374 732e 0a0a 2020 2020  it exists...    
│ │ │ │ +000374e0: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ +000374f0: 2052 6574 7572 6e73 2053 4849 5348 495f   Returns SHISHI_
│ │ │ │ +00037500: 4f4b 2069 6666 2073 7563 6365 7373 6675  OK iff successfu
│ │ │ │ +00037510: 6c2e 0a0a 7368 6973 6869 5f61 7072 6571  l...shishi_apreq
│ │ │ │ +00037520: 5f70 6172 7365 0a2d 2d2d 2d2d 2d2d 2d2d  _parse.---------
│ │ │ │ +00037530: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +00037540: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ +00037550: 7368 695f 6170 7265 715f 7061 7273 6520  shi_apreq_parse 
│ │ │ │ +00037560: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ +00037570: 2c20 4649 4c45 202a 2046 482c 0a20 2020  , FILE * FH,.   
│ │ │ │ +00037580: 2020 2020 2020 2053 6869 7368 695f 6173         Shishi_as
│ │ │ │ +00037590: 6e31 202a 2041 5052 4551 290a 2020 2020  n1 * APREQ).    
│ │ │ │ +000375a0: 2048 414e 444c 453a 2073 6869 7368 6920   HANDLE: shishi 
│ │ │ │ +000375b0: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ +000375c0: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ +000375d0: 5f69 6e69 7428 29e2 8099 2e0a 2020 2020  _init().....    
│ │ │ │ +000375e0: 2046 483a 2066 696c 6520 6861 6e64 6c65   FH: file handle
│ │ │ │ +000375f0: 206f 7065 6e20 666f 7220 7265 6164 696e   open for readin
│ │ │ │ +00037600: 672e 0a20 2020 2020 4150 5245 513a 206f  g..     APREQ: o
│ │ │ │ +00037610: 7574 7075 7420 7661 7269 6162 6c65 2077  utput variable w
│ │ │ │ +00037620: 6974 6820 6e65 776c 7920 616c 6c6f 6361  ith newly alloca
│ │ │ │ +00037630: 7465 6420 4150 2d52 4551 2e0a 0a20 2020  ted AP-REQ...   
│ │ │ │ +00037640: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ +00037650: 2052 6561 6420 4153 4349 4920 6172 6d6f   Read ASCII armo
│ │ │ │ +00037660: 7265 6420 4445 5220 656e 636f 6465 6420  red DER encoded 
│ │ │ │ +00037670: 4150 2d52 4551 2066 726f 6d20 6669 6c65  AP-REQ from file
│ │ │ │ +00037680: 2061 6e64 0a20 2020 2020 706f 7075 6c61   and.     popula
│ │ │ │ +00037690: 7465 2067 6976 656e 2076 6172 6961 626c  te given variabl
│ │ │ │ +000376a0: 652e 0a0a 2020 2020 202a 5265 7475 726e  e...     *Return
│ │ │ │ +000376b0: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ +000376c0: 2053 4849 5348 495f 4f4b 2069 6666 2073   SHISHI_OK iff s
│ │ │ │ +000376d0: 7563 6365 7373 6675 6c2e 0a0a 7368 6973  uccessful...shis
│ │ │ │ +000376e0: 6869 5f61 7072 6571 5f72 6561 640a 2d2d  hi_apreq_read.--
│ │ │ │ +000376f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +00037700: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ +00037710: 6e74 2073 6869 7368 695f 6170 7265 715f  nt shishi_apreq_
│ │ │ │ +00037720: 7265 6164 2028 5368 6973 6869 202a 2048  read (Shishi * H
│ │ │ │ +00037730: 414e 444c 452c 2046 494c 4520 2a20 4648  ANDLE, FILE * FH
│ │ │ │ +00037740: 2c0a 2020 2020 2020 2020 2020 5368 6973  ,.          Shis
│ │ │ │ +00037750: 6869 5f61 736e 3120 2a20 4150 5245 5129  hi_asn1 * APREQ)
│ │ │ │ +00037760: 0a20 2020 2020 4841 4e44 4c45 3a20 7368  .     HANDLE: sh
│ │ │ │ +00037770: 6973 6869 2068 616e 646c 6520 6173 2061  ishi handle as a
│ │ │ │ +00037780: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ +00037790: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ +000377a0: 0a20 2020 2020 4648 3a20 6669 6c65 2068  .     FH: file h
│ │ │ │ +000377b0: 616e 646c 6520 6f70 656e 2066 6f72 2072  andle open for r
│ │ │ │ +000377c0: 6561 6469 6e67 2e0a 2020 2020 2041 5052  eading..     APR
│ │ │ │ +000377d0: 4551 3a20 6f75 7470 7574 2076 6172 6961  EQ: output varia
│ │ │ │ +000377e0: 626c 6520 7769 7468 206e 6577 6c79 2061  ble with newly a
│ │ │ │ +000377f0: 6c6c 6f63 6174 6564 2041 502d 5245 512e  llocated AP-REQ.
│ │ │ │ +00037800: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ +00037810: 696f 6e3a 2a20 5265 6164 2044 4552 2065  ion:* Read DER e
│ │ │ │ +00037820: 6e63 6f64 6564 2041 502d 5245 5120 6672  ncoded AP-REQ fr
│ │ │ │ +00037830: 6f6d 2066 696c 6520 616e 6420 706f 7075  om file and popu
│ │ │ │ +00037840: 6c61 7465 2067 6976 656e 0a20 2020 2020  late given.     
│ │ │ │ +00037850: 7661 7269 6162 6c65 2e0a 0a20 2020 2020  variable...     
│ │ │ │ +00037860: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ +00037870: 5265 7475 726e 7320 5348 4953 4849 5f4f  Returns SHISHI_O
│ │ │ │ +00037880: 4b20 6966 6620 7375 6363 6573 7366 756c  K iff successful
│ │ │ │ +00037890: 2e0a 0a73 6869 7368 695f 6170 7265 715f  ...shishi_apreq_
│ │ │ │ +000378a0: 6672 6f6d 5f66 696c 650a 2d2d 2d2d 2d2d  from_file.------
│ │ │ │ +000378b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +000378c0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +000378d0: 696e 7420 7368 6973 6869 5f61 7072 6571  int shishi_apreq
│ │ │ │ +000378e0: 5f66 726f 6d5f 6669 6c65 2028 5368 6973  _from_file (Shis
│ │ │ │ +000378f0: 6869 202a 2048 414e 444c 452c 0a20 2020  hi * HANDLE,.   
│ │ │ │ +00037900: 2020 2020 2020 2053 6869 7368 695f 6173         Shishi_as
│ │ │ │ +00037910: 6e31 202a 2041 5052 4551 2c20 696e 7420  n1 * APREQ, int 
│ │ │ │ +00037920: 4649 4c45 5459 5045 2c20 636f 6e73 7420  FILETYPE, const 
│ │ │ │ +00037930: 6368 6172 202a 2046 494c 454e 414d 4529  char * FILENAME)
│ │ │ │ +00037940: 0a20 2020 2020 4841 4e44 4c45 3a20 7368  .     HANDLE: sh
│ │ │ │ +00037950: 6973 6869 2068 616e 646c 6520 6173 2061  ishi handle as a
│ │ │ │ +00037960: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ +00037970: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ +00037980: 0a20 2020 2020 4150 5245 513a 206f 7574  .     APREQ: out
│ │ │ │ +00037990: 7075 7420 7661 7269 6162 6c65 2077 6974  put variable wit
│ │ │ │ +000379a0: 6820 6e65 776c 7920 616c 6c6f 6361 7465  h newly allocate
│ │ │ │ +000379b0: 6420 4150 2d52 4551 2e0a 2020 2020 2046  d AP-REQ..     F
│ │ │ │ +000379c0: 494c 4554 5950 453a 2069 6e70 7574 2076  ILETYPE: input v
│ │ │ │ +000379d0: 6172 6961 626c 6520 7370 6563 6966 7969  ariable specifyi
│ │ │ │ +000379e0: 6e67 2074 7970 6520 6f66 2066 696c 6520  ng type of file 
│ │ │ │ +000379f0: 746f 2062 6520 7265 6164 2c20 7365 650a  to be read, see.
│ │ │ │ +00037a00: 2020 2020 2053 6869 7368 695f 6669 6c65       Shishi_file
│ │ │ │ +00037a10: 7479 7065 2e0a 2020 2020 2046 494c 454e  type..     FILEN
│ │ │ │ +00037a20: 414d 453a 2069 6e70 7574 2076 6172 6961  AME: input varia
│ │ │ │ +00037a30: 626c 6520 7769 7468 2066 696c 656e 616d  ble with filenam
│ │ │ │ +00037a40: 6520 746f 2072 6561 6420 6672 6f6d 2e0a  e to read from..
│ │ │ │ +00037a50: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +00037a60: 6f6e 3a2a 2052 6561 6420 4150 2d52 4551  on:* Read AP-REQ
│ │ │ │ +00037a70: 2066 726f 6d20 6669 6c65 2069 6e20 7370   from file in sp
│ │ │ │ +00037a80: 6563 6966 6965 6420 5459 5045 2e0a 0a20  ecified TYPE... 
│ │ │ │ +00037a90: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ +00037aa0: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ +00037ab0: 4849 5f4f 4b20 6966 6620 7375 6363 6573  HI_OK iff succes
│ │ │ │ +00037ac0: 7366 756c 2e0a 0a73 6869 7368 695f 6170  sful...shishi_ap
│ │ │ │ +00037ad0: 7265 715f 7365 745f 6175 7468 656e 7469  req_set_authenti
│ │ │ │ +00037ae0: 6361 746f 720a 2d2d 2d2d 2d2d 2d2d 2d2d  cator.----------
│ │ │ │  00037af0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00037b00: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ -00037b10: 3a20 696e 7420 7368 6973 6869 5f61 7072  : int shishi_apr
│ │ │ │ -00037b20: 6571 5f73 6574 5f61 7574 6865 6e74 6963  eq_set_authentic
│ │ │ │ -00037b30: 6174 6f72 2028 5368 6973 6869 202a 2048  ator (Shishi * H
│ │ │ │ -00037b40: 414e 444c 452c 0a20 2020 2020 2020 2020  ANDLE,.         
│ │ │ │ -00037b50: 2053 6869 7368 695f 6173 6e31 2041 5052   Shishi_asn1 APR
│ │ │ │ -00037b60: 4551 2c20 696e 7433 325f 7420 4554 5950  EQ, int32_t ETYP
│ │ │ │ -00037b70: 452c 2075 696e 7433 325f 7420 4b56 4e4f  E, uint32_t KVNO
│ │ │ │ -00037b80: 2c0a 2020 2020 2020 2020 2020 636f 6e73  ,.          cons
│ │ │ │ -00037b90: 7420 6368 6172 202a 2042 5546 2c20 7369  t char * BUF, si
│ │ │ │ -00037ba0: 7a65 5f74 2042 5546 4c45 4e29 0a20 2020  ze_t BUFLEN).   
│ │ │ │ -00037bb0: 2020 4841 4e44 4c45 3a20 7368 6973 6869    HANDLE: shishi
│ │ │ │ -00037bc0: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ -00037bd0: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ -00037be0: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ -00037bf0: 2020 4150 5245 513a 2041 502d 5245 5120    APREQ: AP-REQ 
│ │ │ │ -00037c00: 746f 2061 6464 2061 7574 6865 6e74 6963  to add authentic
│ │ │ │ -00037c10: 6174 6f72 2066 6965 6c64 2074 6f2e 0a20  ator field to.. 
│ │ │ │ -00037c20: 2020 2020 4554 5950 453a 2065 6e63 7279      ETYPE: encry
│ │ │ │ -00037c30: 7074 696f 6e20 7479 7065 2075 7365 6420  ption type used 
│ │ │ │ -00037c40: 746f 2065 6e63 7279 7074 2061 7574 6865  to encrypt authe
│ │ │ │ -00037c50: 6e74 6963 6174 6f72 2e0a 2020 2020 204b  nticator..     K
│ │ │ │ -00037c60: 564e 4f3a 2076 6572 7369 6f6e 206f 6620  VNO: version of 
│ │ │ │ -00037c70: 7468 6520 6b65 7920 7573 6564 2074 6f20  the key used to 
│ │ │ │ -00037c80: 656e 6372 7970 7420 6175 7468 656e 7469  encrypt authenti
│ │ │ │ -00037c90: 6361 746f 722e 0a20 2020 2020 4255 463a  cator..     BUF:
│ │ │ │ -00037ca0: 2069 6e70 7574 2061 7272 6179 2077 6974   input array wit
│ │ │ │ -00037cb0: 6820 656e 6372 7970 7465 6420 6175 7468  h encrypted auth
│ │ │ │ -00037cc0: 656e 7469 6361 746f 722e 0a20 2020 2020  enticator..     
│ │ │ │ -00037cd0: 4255 464c 454e 3a20 7369 7a65 206f 6620  BUFLEN: size of 
│ │ │ │ -00037ce0: 696e 7075 7420 6172 7261 7920 7769 7468  input array with
│ │ │ │ -00037cf0: 2065 6e63 7279 7074 6564 2061 7574 6865   encrypted authe
│ │ │ │ -00037d00: 6e74 6963 6174 6f72 2e0a 0a20 2020 2020  nticator...     
│ │ │ │ -00037d10: 2a44 6573 6372 6970 7469 6f6e 3a2a 2053  *Description:* S
│ │ │ │ -00037d20: 6574 2074 6865 2065 6e63 7279 7074 6564  et the encrypted
│ │ │ │ -00037d30: 2061 7574 6865 6e74 6963 6174 6f72 2066   authenticator f
│ │ │ │ -00037d40: 6965 6c64 2069 6e20 7468 6520 4150 2d52  ield in the AP-R
│ │ │ │ -00037d50: 4550 2e0a 2020 2020 2054 6865 2065 6e63  EP..     The enc
│ │ │ │ -00037d60: 7279 7074 6564 2064 6174 6120 6973 2075  rypted data is u
│ │ │ │ -00037d70: 7375 616c 6c79 2063 7265 6174 6564 2062  sually created b
│ │ │ │ -00037d80: 7920 6361 6c6c 696e 6720 e280 9873 6869  y calling ...shi
│ │ │ │ -00037d90: 7368 695f 656e 6372 7970 7428 29e2 8099  shi_encrypt()...
│ │ │ │ -00037da0: 0a20 2020 2020 6f6e 2074 6865 2044 4552  .     on the DER
│ │ │ │ -00037db0: 2065 6e63 6f64 6564 2061 7574 6865 6e74   encoded authent
│ │ │ │ -00037dc0: 6963 6174 6f72 2e20 2054 6f20 7361 7665  icator.  To save
│ │ │ │ -00037dd0: 2074 696d 652c 2079 6f75 206d 6179 2077   time, you may w
│ │ │ │ -00037de0: 616e 7420 746f 0a20 2020 2020 7573 6520  ant to.     use 
│ │ │ │ -00037df0: e280 9873 6869 7368 695f 6170 7265 715f  ...shishi_apreq_
│ │ │ │ -00037e00: 6164 645f 6175 7468 656e 7469 6361 746f  add_authenticato
│ │ │ │ -00037e10: 7228 29e2 8099 2069 6e73 7465 6164 2c20  r()... instead, 
│ │ │ │ -00037e20: 7768 6963 6820 6361 6c63 756c 6174 6573  which calculates
│ │ │ │ -00037e30: 0a20 2020 2020 7468 6520 656e 6372 7970  .     the encryp
│ │ │ │ -00037e40: 7465 6420 6461 7461 2061 6e64 2063 616c  ted data and cal
│ │ │ │ -00037e50: 6c73 2074 6869 7320 6675 6e63 7469 6f6e  ls this function
│ │ │ │ -00037e60: 2069 6e20 6f6e 6520 7374 6570 2e0a 0a20   in one step... 
│ │ │ │ -00037e70: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ -00037e80: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ -00037e90: 4849 5f4f 4b20 6f6e 2073 7563 6365 7373  HI_OK on success
│ │ │ │ -00037ea0: 2e0a 0a73 6869 7368 695f 6170 7265 715f  ...shishi_apreq_
│ │ │ │ -00037eb0: 6164 645f 6175 7468 656e 7469 6361 746f  add_authenticato
│ │ │ │ -00037ec0: 720a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  r.--------------
│ │ │ │ +00037b00: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ +00037b10: 6f6e 3a20 696e 7420 7368 6973 6869 5f61  on: int shishi_a
│ │ │ │ +00037b20: 7072 6571 5f73 6574 5f61 7574 6865 6e74  preq_set_authent
│ │ │ │ +00037b30: 6963 6174 6f72 2028 5368 6973 6869 202a  icator (Shishi *
│ │ │ │ +00037b40: 2048 414e 444c 452c 0a20 2020 2020 2020   HANDLE,.       
│ │ │ │ +00037b50: 2020 2053 6869 7368 695f 6173 6e31 2041     Shishi_asn1 A
│ │ │ │ +00037b60: 5052 4551 2c20 696e 7433 325f 7420 4554  PREQ, int32_t ET
│ │ │ │ +00037b70: 5950 452c 2075 696e 7433 325f 7420 4b56  YPE, uint32_t KV
│ │ │ │ +00037b80: 4e4f 2c0a 2020 2020 2020 2020 2020 636f  NO,.          co
│ │ │ │ +00037b90: 6e73 7420 6368 6172 202a 2042 5546 2c20  nst char * BUF, 
│ │ │ │ +00037ba0: 7369 7a65 5f74 2042 5546 4c45 4e29 0a20  size_t BUFLEN). 
│ │ │ │ +00037bb0: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ +00037bc0: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ +00037bd0: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ +00037be0: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ +00037bf0: 2020 2020 4150 5245 513a 2041 502d 5245      APREQ: AP-RE
│ │ │ │ +00037c00: 5120 746f 2061 6464 2061 7574 6865 6e74  Q to add authent
│ │ │ │ +00037c10: 6963 6174 6f72 2066 6965 6c64 2074 6f2e  icator field to.
│ │ │ │ +00037c20: 0a20 2020 2020 4554 5950 453a 2065 6e63  .     ETYPE: enc
│ │ │ │ +00037c30: 7279 7074 696f 6e20 7479 7065 2075 7365  ryption type use
│ │ │ │ +00037c40: 6420 746f 2065 6e63 7279 7074 2061 7574  d to encrypt aut
│ │ │ │ +00037c50: 6865 6e74 6963 6174 6f72 2e0a 2020 2020  henticator..    
│ │ │ │ +00037c60: 204b 564e 4f3a 2076 6572 7369 6f6e 206f   KVNO: version o
│ │ │ │ +00037c70: 6620 7468 6520 6b65 7920 7573 6564 2074  f the key used t
│ │ │ │ +00037c80: 6f20 656e 6372 7970 7420 6175 7468 656e  o encrypt authen
│ │ │ │ +00037c90: 7469 6361 746f 722e 0a20 2020 2020 4255  ticator..     BU
│ │ │ │ +00037ca0: 463a 2069 6e70 7574 2061 7272 6179 2077  F: input array w
│ │ │ │ +00037cb0: 6974 6820 656e 6372 7970 7465 6420 6175  ith encrypted au
│ │ │ │ +00037cc0: 7468 656e 7469 6361 746f 722e 0a20 2020  thenticator..   
│ │ │ │ +00037cd0: 2020 4255 464c 454e 3a20 7369 7a65 206f    BUFLEN: size o
│ │ │ │ +00037ce0: 6620 696e 7075 7420 6172 7261 7920 7769  f input array wi
│ │ │ │ +00037cf0: 7468 2065 6e63 7279 7074 6564 2061 7574  th encrypted aut
│ │ │ │ +00037d00: 6865 6e74 6963 6174 6f72 2e0a 0a20 2020  henticator...   
│ │ │ │ +00037d10: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ +00037d20: 2053 6574 2074 6865 2065 6e63 7279 7074   Set the encrypt
│ │ │ │ +00037d30: 6564 2061 7574 6865 6e74 6963 6174 6f72  ed authenticator
│ │ │ │ +00037d40: 2066 6965 6c64 2069 6e20 7468 6520 4150   field in the AP
│ │ │ │ +00037d50: 2d52 4550 2e0a 2020 2020 2054 6865 2065  -REP..     The e
│ │ │ │ +00037d60: 6e63 7279 7074 6564 2064 6174 6120 6973  ncrypted data is
│ │ │ │ +00037d70: 2075 7375 616c 6c79 2063 7265 6174 6564   usually created
│ │ │ │ +00037d80: 2062 7920 6361 6c6c 696e 6720 e280 9873   by calling ...s
│ │ │ │ +00037d90: 6869 7368 695f 656e 6372 7970 7428 29e2  hishi_encrypt().
│ │ │ │ +00037da0: 8099 0a20 2020 2020 6f6e 2074 6865 2044  ...     on the D
│ │ │ │ +00037db0: 4552 2065 6e63 6f64 6564 2061 7574 6865  ER encoded authe
│ │ │ │ +00037dc0: 6e74 6963 6174 6f72 2e20 2054 6f20 7361  nticator.  To sa
│ │ │ │ +00037dd0: 7665 2074 696d 652c 2079 6f75 206d 6179  ve time, you may
│ │ │ │ +00037de0: 2077 616e 7420 746f 0a20 2020 2020 7573   want to.     us
│ │ │ │ +00037df0: 6520 e280 9873 6869 7368 695f 6170 7265  e ...shishi_apre
│ │ │ │ +00037e00: 715f 6164 645f 6175 7468 656e 7469 6361  q_add_authentica
│ │ │ │ +00037e10: 746f 7228 29e2 8099 2069 6e73 7465 6164  tor()... instead
│ │ │ │ +00037e20: 2c20 7768 6963 6820 6361 6c63 756c 6174  , which calculat
│ │ │ │ +00037e30: 6573 0a20 2020 2020 7468 6520 656e 6372  es.     the encr
│ │ │ │ +00037e40: 7970 7465 6420 6461 7461 2061 6e64 2063  ypted data and c
│ │ │ │ +00037e50: 616c 6c73 2074 6869 7320 6675 6e63 7469  alls this functi
│ │ │ │ +00037e60: 6f6e 2069 6e20 6f6e 6520 7374 6570 2e0a  on in one step..
│ │ │ │ +00037e70: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ +00037e80: 6c75 653a 2a20 5265 7475 726e 7320 5348  lue:* Returns SH
│ │ │ │ +00037e90: 4953 4849 5f4f 4b20 6f6e 2073 7563 6365  ISHI_OK on succe
│ │ │ │ +00037ea0: 7373 2e0a 0a73 6869 7368 695f 6170 7265  ss...shishi_apre
│ │ │ │ +00037eb0: 715f 6164 645f 6175 7468 656e 7469 6361  q_add_authentica
│ │ │ │ +00037ec0: 746f 720a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  tor.------------
│ │ │ │  00037ed0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00037ee0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ -00037ef0: 696e 7420 7368 6973 6869 5f61 7072 6571  int shishi_apreq
│ │ │ │ -00037f00: 5f61 6464 5f61 7574 6865 6e74 6963 6174  _add_authenticat
│ │ │ │ -00037f10: 6f72 2028 5368 6973 6869 202a 2048 414e  or (Shishi * HAN
│ │ │ │ -00037f20: 444c 452c 0a20 2020 2020 2020 2020 2053  DLE,.          S
│ │ │ │ -00037f30: 6869 7368 695f 6173 6e31 2041 5052 4551  hishi_asn1 APREQ
│ │ │ │ -00037f40: 2c20 5368 6973 6869 5f6b 6579 202a 204b  , Shishi_key * K
│ │ │ │ -00037f50: 4559 2c20 696e 7420 4b45 5955 5341 4745  EY, int KEYUSAGE
│ │ │ │ -00037f60: 2c0a 2020 2020 2020 2020 2020 5368 6973  ,.          Shis
│ │ │ │ -00037f70: 6869 5f61 736e 3120 4155 5448 454e 5449  hi_asn1 AUTHENTI
│ │ │ │ -00037f80: 4341 544f 5229 0a20 2020 2020 4841 4e44  CATOR).     HAND
│ │ │ │ -00037f90: 4c45 3a20 7368 6973 6869 2068 616e 646c  LE: shishi handl
│ │ │ │ -00037fa0: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ -00037fb0: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ -00037fc0: 2829 e280 992e 0a20 2020 2020 4150 5245  ().....     APRE
│ │ │ │ -00037fd0: 513a 2041 502d 5245 5120 746f 2061 6464  Q: AP-REQ to add
│ │ │ │ -00037fe0: 2061 7574 6865 6e74 6963 6174 6f72 2066   authenticator f
│ │ │ │ -00037ff0: 6965 6c64 2074 6f2e 0a20 2020 2020 4b45  ield to..     KE
│ │ │ │ -00038000: 593a 206b 6579 2074 6f20 746f 2075 7365  Y: key to to use
│ │ │ │ -00038010: 2066 6f72 2065 6e63 7279 7074 696f 6e2e   for encryption.
│ │ │ │ -00038020: 0a20 2020 2020 4b45 5955 5341 4745 3a20  .     KEYUSAGE: 
│ │ │ │ -00038030: 6372 7970 746f 6772 6170 6869 6320 6b65  cryptographic ke
│ │ │ │ -00038040: 7920 7573 6167 6520 7661 6c75 6520 746f  y usage value to
│ │ │ │ -00038050: 2075 7365 2069 6e20 656e 6372 7970 7469   use in encrypti
│ │ │ │ -00038060: 6f6e 2e0a 2020 2020 2041 5554 4845 4e54  on..     AUTHENT
│ │ │ │ -00038070: 4943 4154 4f52 3a20 6175 7468 656e 7469  ICATOR: authenti
│ │ │ │ -00038080: 6361 746f 7220 6173 2061 6c6c 6f63 6174  cator as allocat
│ │ │ │ -00038090: 6564 2062 790a 2020 2020 20e2 8098 7368  ed by.     ...sh
│ │ │ │ -000380a0: 6973 6869 5f61 7574 6865 6e74 6963 6174  ishi_authenticat
│ │ │ │ -000380b0: 6f72 2829 e280 992e 0a0a 2020 2020 202a  or()......     *
│ │ │ │ -000380c0: 4465 7363 7269 7074 696f 6e3a 2a20 456e  Description:* En
│ │ │ │ -000380d0: 6372 7970 7473 2044 4552 2065 6e63 6f64  crypts DER encod
│ │ │ │ -000380e0: 6564 2061 7574 6865 6e74 6963 6174 6f72  ed authenticator
│ │ │ │ -000380f0: 2075 7369 6e67 206b 6579 2061 6e64 0a20   using key and. 
│ │ │ │ -00038100: 2020 2020 7374 6f72 6520 6974 2069 6e20      store it in 
│ │ │ │ -00038110: 7468 6520 4150 2d52 4551 2e0a 0a20 2020  the AP-REQ...   
│ │ │ │ -00038120: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ -00038130: 2a20 5265 7475 726e 7320 5348 4953 4849  * Returns SHISHI
│ │ │ │ -00038140: 5f4f 4b20 6966 6620 7375 6363 6573 7366  _OK iff successf
│ │ │ │ -00038150: 756c 2e0a 0a73 6869 7368 695f 6170 7265  ul...shishi_apre
│ │ │ │ -00038160: 715f 7365 745f 7469 636b 6574 0a2d 2d2d  q_set_ticket.---
│ │ │ │ +00037ee0: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ +00037ef0: 3a20 696e 7420 7368 6973 6869 5f61 7072  : int shishi_apr
│ │ │ │ +00037f00: 6571 5f61 6464 5f61 7574 6865 6e74 6963  eq_add_authentic
│ │ │ │ +00037f10: 6174 6f72 2028 5368 6973 6869 202a 2048  ator (Shishi * H
│ │ │ │ +00037f20: 414e 444c 452c 0a20 2020 2020 2020 2020  ANDLE,.         
│ │ │ │ +00037f30: 2053 6869 7368 695f 6173 6e31 2041 5052   Shishi_asn1 APR
│ │ │ │ +00037f40: 4551 2c20 5368 6973 6869 5f6b 6579 202a  EQ, Shishi_key *
│ │ │ │ +00037f50: 204b 4559 2c20 696e 7420 4b45 5955 5341   KEY, int KEYUSA
│ │ │ │ +00037f60: 4745 2c0a 2020 2020 2020 2020 2020 5368  GE,.          Sh
│ │ │ │ +00037f70: 6973 6869 5f61 736e 3120 4155 5448 454e  ishi_asn1 AUTHEN
│ │ │ │ +00037f80: 5449 4341 544f 5229 0a20 2020 2020 4841  TICATOR).     HA
│ │ │ │ +00037f90: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ +00037fa0: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ +00037fb0: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ +00037fc0: 6974 2829 e280 992e 0a20 2020 2020 4150  it().....     AP
│ │ │ │ +00037fd0: 5245 513a 2041 502d 5245 5120 746f 2061  REQ: AP-REQ to a
│ │ │ │ +00037fe0: 6464 2061 7574 6865 6e74 6963 6174 6f72  dd authenticator
│ │ │ │ +00037ff0: 2066 6965 6c64 2074 6f2e 0a20 2020 2020   field to..     
│ │ │ │ +00038000: 4b45 593a 206b 6579 2074 6f20 746f 2075  KEY: key to to u
│ │ │ │ +00038010: 7365 2066 6f72 2065 6e63 7279 7074 696f  se for encryptio
│ │ │ │ +00038020: 6e2e 0a20 2020 2020 4b45 5955 5341 4745  n..     KEYUSAGE
│ │ │ │ +00038030: 3a20 6372 7970 746f 6772 6170 6869 6320  : cryptographic 
│ │ │ │ +00038040: 6b65 7920 7573 6167 6520 7661 6c75 6520  key usage value 
│ │ │ │ +00038050: 746f 2075 7365 2069 6e20 656e 6372 7970  to use in encryp
│ │ │ │ +00038060: 7469 6f6e 2e0a 2020 2020 2041 5554 4845  tion..     AUTHE
│ │ │ │ +00038070: 4e54 4943 4154 4f52 3a20 6175 7468 656e  NTICATOR: authen
│ │ │ │ +00038080: 7469 6361 746f 7220 6173 2061 6c6c 6f63  ticator as alloc
│ │ │ │ +00038090: 6174 6564 2062 790a 2020 2020 20e2 8098  ated by.     ...
│ │ │ │ +000380a0: 7368 6973 6869 5f61 7574 6865 6e74 6963  shishi_authentic
│ │ │ │ +000380b0: 6174 6f72 2829 e280 992e 0a0a 2020 2020  ator()......    
│ │ │ │ +000380c0: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ +000380d0: 456e 6372 7970 7473 2044 4552 2065 6e63  Encrypts DER enc
│ │ │ │ +000380e0: 6f64 6564 2061 7574 6865 6e74 6963 6174  oded authenticat
│ │ │ │ +000380f0: 6f72 2075 7369 6e67 206b 6579 2061 6e64  or using key and
│ │ │ │ +00038100: 0a20 2020 2020 7374 6f72 6520 6974 2069  .     store it i
│ │ │ │ +00038110: 6e20 7468 6520 4150 2d52 4551 2e0a 0a20  n the AP-REQ... 
│ │ │ │ +00038120: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ +00038130: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ +00038140: 4849 5f4f 4b20 6966 6620 7375 6363 6573  HI_OK iff succes
│ │ │ │ +00038150: 7366 756c 2e0a 0a73 6869 7368 695f 6170  sful...shishi_ap
│ │ │ │ +00038160: 7265 715f 7365 745f 7469 636b 6574 0a2d  req_set_ticket.-
│ │ │ │  00038170: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00038180: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -00038190: 6f6e 3a20 696e 7420 7368 6973 6869 5f61  on: int shishi_a
│ │ │ │ -000381a0: 7072 6571 5f73 6574 5f74 6963 6b65 7420  preq_set_ticket 
│ │ │ │ -000381b0: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ -000381c0: 2c0a 2020 2020 2020 2020 2020 5368 6973  ,.          Shis
│ │ │ │ -000381d0: 6869 5f61 736e 3120 4150 5245 512c 2053  hi_asn1 APREQ, S
│ │ │ │ -000381e0: 6869 7368 695f 6173 6e31 2054 4943 4b45  hishi_asn1 TICKE
│ │ │ │ -000381f0: 5429 0a20 2020 2020 4841 4e44 4c45 3a20  T).     HANDLE: 
│ │ │ │ -00038200: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ -00038210: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ -00038220: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ -00038230: 992e 0a20 2020 2020 4150 5245 513a 2041  ...     APREQ: A
│ │ │ │ -00038240: 502d 5245 5120 746f 2061 6464 2074 6963  P-REQ to add tic
│ │ │ │ -00038250: 6b65 7420 6669 656c 6420 746f 2e0a 2020  ket field to..  
│ │ │ │ -00038260: 2020 2054 4943 4b45 543a 2069 6e70 7574     TICKET: input
│ │ │ │ -00038270: 2074 6963 6b65 7420 746f 2063 6f70 7920   ticket to copy 
│ │ │ │ -00038280: 696e 746f 2041 502d 5245 5120 7469 636b  into AP-REQ tick
│ │ │ │ -00038290: 6574 2066 6965 6c64 2e0a 0a20 2020 2020  et field...     
│ │ │ │ -000382a0: 2a44 6573 6372 6970 7469 6f6e 3a2a 2043  *Description:* C
│ │ │ │ -000382b0: 6f70 7920 7469 636b 6574 2069 6e74 6f20  opy ticket into 
│ │ │ │ -000382c0: 4150 2d52 4551 2e0a 0a20 2020 2020 2a52  AP-REQ...     *R
│ │ │ │ -000382d0: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ -000382e0: 7475 726e 7320 5348 4953 4849 5f4f 4b20  turns SHISHI_OK 
│ │ │ │ -000382f0: 6966 6620 7375 6363 6573 7366 756c 2e0a  iff successful..
│ │ │ │ -00038300: 0a73 6869 7368 695f 6170 7265 715f 6f70  .shishi_apreq_op
│ │ │ │ -00038310: 7469 6f6e 730a 2d2d 2d2d 2d2d 2d2d 2d2d  tions.----------
│ │ │ │ -00038320: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ -00038330: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ -00038340: 6973 6869 5f61 7072 6571 5f6f 7074 696f  ishi_apreq_optio
│ │ │ │ -00038350: 6e73 2028 5368 6973 6869 202a 2048 414e  ns (Shishi * HAN
│ │ │ │ -00038360: 444c 452c 0a20 2020 2020 2020 2020 2053  DLE,.          S
│ │ │ │ -00038370: 6869 7368 695f 6173 6e31 2041 5052 4551  hishi_asn1 APREQ
│ │ │ │ -00038380: 2c20 7569 6e74 3332 5f74 202a 2046 4c41  , uint32_t * FLA
│ │ │ │ -00038390: 4753 290a 2020 2020 2048 414e 444c 453a  GS).     HANDLE:
│ │ │ │ -000383a0: 2073 6869 7368 6920 6861 6e64 6c65 2061   shishi handle a
│ │ │ │ -000383b0: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ -000383c0: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ -000383d0: 8099 2e0a 2020 2020 2041 5052 4551 3a20  ....     APREQ: 
│ │ │ │ -000383e0: 4150 2d52 4551 2074 6f20 6765 7420 6f70  AP-REQ to get op
│ │ │ │ -000383f0: 7469 6f6e 7320 6672 6f6d 2e0a 2020 2020  tions from..    
│ │ │ │ -00038400: 2046 4c41 4753 3a20 4f75 7470 7574 2069   FLAGS: Output i
│ │ │ │ -00038410: 6e74 6567 6572 2063 6f6e 7461 696e 696e  nteger containin
│ │ │ │ -00038420: 6720 6f70 7469 6f6e 7320 6672 6f6d 2041  g options from A
│ │ │ │ -00038430: 502d 5245 512e 0a0a 2020 2020 202a 4465  P-REQ...     *De
│ │ │ │ -00038440: 7363 7269 7074 696f 6e3a 2a20 4578 7472  scription:* Extr
│ │ │ │ -00038450: 6163 7420 7468 6520 4150 2d4f 7074 696f  act the AP-Optio
│ │ │ │ -00038460: 6e73 2066 726f 6d20 4150 2d52 4551 2069  ns from AP-REQ i
│ │ │ │ -00038470: 6e74 6f20 6f75 7470 7574 0a20 2020 2020  nto output.     
│ │ │ │ -00038480: 696e 7465 6765 722e 0a0a 2020 2020 202a  integer...     *
│ │ │ │ -00038490: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ -000384a0: 6574 7572 6e73 2053 4849 5348 495f 4f4b  eturns SHISHI_OK
│ │ │ │ -000384b0: 2069 6666 2073 7563 6365 7373 6675 6c2e   iff successful.
│ │ │ │ -000384c0: 0a0a 7368 6973 6869 5f61 7072 6571 5f75  ..shishi_apreq_u
│ │ │ │ -000384d0: 7365 5f73 6573 7369 6f6e 5f6b 6579 5f70  se_session_key_p
│ │ │ │ -000384e0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ -000384f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -00038500: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ -00038510: 6e74 2073 6869 7368 695f 6170 7265 715f  nt shishi_apreq_
│ │ │ │ -00038520: 7573 655f 7365 7373 696f 6e5f 6b65 795f  use_session_key_
│ │ │ │ -00038530: 7020 2853 6869 7368 6920 2a20 4841 4e44  p (Shishi * HAND
│ │ │ │ -00038540: 4c45 2c0a 2020 2020 2020 2020 2020 5368  LE,.          Sh
│ │ │ │ -00038550: 6973 6869 5f61 736e 3120 4150 5245 5129  ishi_asn1 APREQ)
│ │ │ │ -00038560: 0a20 2020 2020 4841 4e44 4c45 3a20 7368  .     HANDLE: sh
│ │ │ │ -00038570: 6973 6869 2068 616e 646c 6520 6173 2061  ishi handle as a
│ │ │ │ -00038580: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ -00038590: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ -000385a0: 0a20 2020 2020 4150 5245 513a 2041 502d  .     APREQ: AP-
│ │ │ │ -000385b0: 5245 5120 6173 2061 6c6c 6f63 6174 6564  REQ as allocated
│ │ │ │ -000385c0: 2062 7920 e280 9873 6869 7368 695f 6170   by ...shishi_ap
│ │ │ │ -000385d0: 7265 7128 29e2 8099 2e0a 0a20 2020 2020  req()......     
│ │ │ │ -000385e0: 2a44 6573 6372 6970 7469 6f6e 3a2a 2052  *Description:* R
│ │ │ │ -000385f0: 6574 7572 6e20 6e6f 6e2d 3020 6966 6620  eturn non-0 iff 
│ │ │ │ -00038600: 7468 6520 2255 7365 2073 6573 7369 6f6e  the "Use session
│ │ │ │ -00038610: 206b 6579 2220 6f70 7469 6f6e 2069 7320   key" option is 
│ │ │ │ -00038620: 7365 740a 2020 2020 2069 6e20 7468 6520  set.     in the 
│ │ │ │ -00038630: 4150 2d52 4551 2e0a 0a20 2020 2020 2a52  AP-REQ...     *R
│ │ │ │ -00038640: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ -00038650: 7475 726e 7320 5348 4953 4849 5f4f 4b20  turns SHISHI_OK 
│ │ │ │ -00038660: 6966 6620 7375 6363 6573 7366 756c 2e0a  iff successful..
│ │ │ │ -00038670: 0a73 6869 7368 695f 6170 7265 715f 6d75  .shishi_apreq_mu
│ │ │ │ -00038680: 7475 616c 5f72 6571 7569 7265 645f 700a  tual_required_p.
│ │ │ │ -00038690: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000386a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -000386b0: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ -000386c0: 7420 7368 6973 6869 5f61 7072 6571 5f6d  t shishi_apreq_m
│ │ │ │ -000386d0: 7574 7561 6c5f 7265 7175 6972 6564 5f70  utual_required_p
│ │ │ │ -000386e0: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ -000386f0: 452c 0a20 2020 2020 2020 2020 2053 6869  E,.          Shi
│ │ │ │ -00038700: 7368 695f 6173 6e31 2041 5052 4551 290a  shi_asn1 APREQ).
│ │ │ │ -00038710: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ -00038720: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ -00038730: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ -00038740: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ -00038750: 2020 2020 2041 5052 4551 3a20 4150 2d52       APREQ: AP-R
│ │ │ │ -00038760: 4551 2061 7320 616c 6c6f 6361 7465 6420  EQ as allocated 
│ │ │ │ -00038770: 6279 20e2 8098 7368 6973 6869 5f61 7072  by ...shishi_apr
│ │ │ │ -00038780: 6571 2829 e280 992e 0a0a 2020 2020 202a  eq()......     *
│ │ │ │ -00038790: 4465 7363 7269 7074 696f 6e3a 2a20 5265  Description:* Re
│ │ │ │ -000387a0: 7475 726e 206e 6f6e 2d30 2069 6666 2074  turn non-0 iff t
│ │ │ │ -000387b0: 6865 2022 4d75 7475 616c 2072 6571 7569  he "Mutual requi
│ │ │ │ -000387c0: 7265 6422 206f 7074 696f 6e20 6973 2073  red" option is s
│ │ │ │ -000387d0: 6574 0a20 2020 2020 696e 2074 6865 2041  et.     in the A
│ │ │ │ -000387e0: 502d 5245 512e 0a0a 2020 2020 202a 5265  P-REQ...     *Re
│ │ │ │ -000387f0: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ -00038800: 7572 6e73 2053 4849 5348 495f 4f4b 2069  urns SHISHI_OK i
│ │ │ │ -00038810: 6666 2073 7563 6365 7373 6675 6c2e 0a0a  ff successful...
│ │ │ │ -00038820: 7368 6973 6869 5f61 7072 6571 5f6f 7074  shishi_apreq_opt
│ │ │ │ -00038830: 696f 6e73 5f73 6574 0a2d 2d2d 2d2d 2d2d  ions_set.-------
│ │ │ │ +00038180: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ +00038190: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ +000381a0: 5f61 7072 6571 5f73 6574 5f74 6963 6b65  _apreq_set_ticke
│ │ │ │ +000381b0: 7420 2853 6869 7368 6920 2a20 4841 4e44  t (Shishi * HAND
│ │ │ │ +000381c0: 4c45 2c0a 2020 2020 2020 2020 2020 5368  LE,.          Sh
│ │ │ │ +000381d0: 6973 6869 5f61 736e 3120 4150 5245 512c  ishi_asn1 APREQ,
│ │ │ │ +000381e0: 2053 6869 7368 695f 6173 6e31 2054 4943   Shishi_asn1 TIC
│ │ │ │ +000381f0: 4b45 5429 0a20 2020 2020 4841 4e44 4c45  KET).     HANDLE
│ │ │ │ +00038200: 3a20 7368 6973 6869 2068 616e 646c 6520  : shishi handle 
│ │ │ │ +00038210: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ +00038220: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ +00038230: e280 992e 0a20 2020 2020 4150 5245 513a  .....     APREQ:
│ │ │ │ +00038240: 2041 502d 5245 5120 746f 2061 6464 2074   AP-REQ to add t
│ │ │ │ +00038250: 6963 6b65 7420 6669 656c 6420 746f 2e0a  icket field to..
│ │ │ │ +00038260: 2020 2020 2054 4943 4b45 543a 2069 6e70       TICKET: inp
│ │ │ │ +00038270: 7574 2074 6963 6b65 7420 746f 2063 6f70  ut ticket to cop
│ │ │ │ +00038280: 7920 696e 746f 2041 502d 5245 5120 7469  y into AP-REQ ti
│ │ │ │ +00038290: 636b 6574 2066 6965 6c64 2e0a 0a20 2020  cket field...   
│ │ │ │ +000382a0: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ +000382b0: 2043 6f70 7920 7469 636b 6574 2069 6e74   Copy ticket int
│ │ │ │ +000382c0: 6f20 4150 2d52 4551 2e0a 0a20 2020 2020  o AP-REQ...     
│ │ │ │ +000382d0: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ +000382e0: 5265 7475 726e 7320 5348 4953 4849 5f4f  Returns SHISHI_O
│ │ │ │ +000382f0: 4b20 6966 6620 7375 6363 6573 7366 756c  K iff successful
│ │ │ │ +00038300: 2e0a 0a73 6869 7368 695f 6170 7265 715f  ...shishi_apreq_
│ │ │ │ +00038310: 6f70 7469 6f6e 730a 2d2d 2d2d 2d2d 2d2d  options.--------
│ │ │ │ +00038320: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ +00038330: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ +00038340: 7368 6973 6869 5f61 7072 6571 5f6f 7074  shishi_apreq_opt
│ │ │ │ +00038350: 696f 6e73 2028 5368 6973 6869 202a 2048  ions (Shishi * H
│ │ │ │ +00038360: 414e 444c 452c 0a20 2020 2020 2020 2020  ANDLE,.         
│ │ │ │ +00038370: 2053 6869 7368 695f 6173 6e31 2041 5052   Shishi_asn1 APR
│ │ │ │ +00038380: 4551 2c20 7569 6e74 3332 5f74 202a 2046  EQ, uint32_t * F
│ │ │ │ +00038390: 4c41 4753 290a 2020 2020 2048 414e 444c  LAGS).     HANDL
│ │ │ │ +000383a0: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ +000383b0: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ +000383c0: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ +000383d0: 29e2 8099 2e0a 2020 2020 2041 5052 4551  ).....     APREQ
│ │ │ │ +000383e0: 3a20 4150 2d52 4551 2074 6f20 6765 7420  : AP-REQ to get 
│ │ │ │ +000383f0: 6f70 7469 6f6e 7320 6672 6f6d 2e0a 2020  options from..  
│ │ │ │ +00038400: 2020 2046 4c41 4753 3a20 4f75 7470 7574     FLAGS: Output
│ │ │ │ +00038410: 2069 6e74 6567 6572 2063 6f6e 7461 696e   integer contain
│ │ │ │ +00038420: 696e 6720 6f70 7469 6f6e 7320 6672 6f6d  ing options from
│ │ │ │ +00038430: 2041 502d 5245 512e 0a0a 2020 2020 202a   AP-REQ...     *
│ │ │ │ +00038440: 4465 7363 7269 7074 696f 6e3a 2a20 4578  Description:* Ex
│ │ │ │ +00038450: 7472 6163 7420 7468 6520 4150 2d4f 7074  tract the AP-Opt
│ │ │ │ +00038460: 696f 6e73 2066 726f 6d20 4150 2d52 4551  ions from AP-REQ
│ │ │ │ +00038470: 2069 6e74 6f20 6f75 7470 7574 0a20 2020   into output.   
│ │ │ │ +00038480: 2020 696e 7465 6765 722e 0a0a 2020 2020    integer...    
│ │ │ │ +00038490: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ +000384a0: 2052 6574 7572 6e73 2053 4849 5348 495f   Returns SHISHI_
│ │ │ │ +000384b0: 4f4b 2069 6666 2073 7563 6365 7373 6675  OK iff successfu
│ │ │ │ +000384c0: 6c2e 0a0a 7368 6973 6869 5f61 7072 6571  l...shishi_apreq
│ │ │ │ +000384d0: 5f75 7365 5f73 6573 7369 6f6e 5f6b 6579  _use_session_key
│ │ │ │ +000384e0: 5f70 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  _p.-------------
│ │ │ │ +000384f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +00038500: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ +00038510: 2069 6e74 2073 6869 7368 695f 6170 7265   int shishi_apre
│ │ │ │ +00038520: 715f 7573 655f 7365 7373 696f 6e5f 6b65  q_use_session_ke
│ │ │ │ +00038530: 795f 7020 2853 6869 7368 6920 2a20 4841  y_p (Shishi * HA
│ │ │ │ +00038540: 4e44 4c45 2c0a 2020 2020 2020 2020 2020  NDLE,.          
│ │ │ │ +00038550: 5368 6973 6869 5f61 736e 3120 4150 5245  Shishi_asn1 APRE
│ │ │ │ +00038560: 5129 0a20 2020 2020 4841 4e44 4c45 3a20  Q).     HANDLE: 
│ │ │ │ +00038570: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ +00038580: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ +00038590: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ +000385a0: 992e 0a20 2020 2020 4150 5245 513a 2041  ...     APREQ: A
│ │ │ │ +000385b0: 502d 5245 5120 6173 2061 6c6c 6f63 6174  P-REQ as allocat
│ │ │ │ +000385c0: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ +000385d0: 6170 7265 7128 29e2 8099 2e0a 0a20 2020  apreq()......   
│ │ │ │ +000385e0: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ +000385f0: 2052 6574 7572 6e20 6e6f 6e2d 3020 6966   Return non-0 if
│ │ │ │ +00038600: 6620 7468 6520 2255 7365 2073 6573 7369  f the "Use sessi
│ │ │ │ +00038610: 6f6e 206b 6579 2220 6f70 7469 6f6e 2069  on key" option i
│ │ │ │ +00038620: 7320 7365 740a 2020 2020 2069 6e20 7468  s set.     in th
│ │ │ │ +00038630: 6520 4150 2d52 4551 2e0a 0a20 2020 2020  e AP-REQ...     
│ │ │ │ +00038640: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ +00038650: 5265 7475 726e 7320 5348 4953 4849 5f4f  Returns SHISHI_O
│ │ │ │ +00038660: 4b20 6966 6620 7375 6363 6573 7366 756c  K iff successful
│ │ │ │ +00038670: 2e0a 0a73 6869 7368 695f 6170 7265 715f  ...shishi_apreq_
│ │ │ │ +00038680: 6d75 7475 616c 5f72 6571 7569 7265 645f  mutual_required_
│ │ │ │ +00038690: 700a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  p.--------------
│ │ │ │ +000386a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +000386b0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +000386c0: 696e 7420 7368 6973 6869 5f61 7072 6571  int shishi_apreq
│ │ │ │ +000386d0: 5f6d 7574 7561 6c5f 7265 7175 6972 6564  _mutual_required
│ │ │ │ +000386e0: 5f70 2028 5368 6973 6869 202a 2048 414e  _p (Shishi * HAN
│ │ │ │ +000386f0: 444c 452c 0a20 2020 2020 2020 2020 2053  DLE,.          S
│ │ │ │ +00038700: 6869 7368 695f 6173 6e31 2041 5052 4551  hishi_asn1 APREQ
│ │ │ │ +00038710: 290a 2020 2020 2048 414e 444c 453a 2073  ).     HANDLE: s
│ │ │ │ +00038720: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ +00038730: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ +00038740: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ +00038750: 2e0a 2020 2020 2041 5052 4551 3a20 4150  ..     APREQ: AP
│ │ │ │ +00038760: 2d52 4551 2061 7320 616c 6c6f 6361 7465  -REQ as allocate
│ │ │ │ +00038770: 6420 6279 20e2 8098 7368 6973 6869 5f61  d by ...shishi_a
│ │ │ │ +00038780: 7072 6571 2829 e280 992e 0a0a 2020 2020  preq()......    
│ │ │ │ +00038790: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ +000387a0: 5265 7475 726e 206e 6f6e 2d30 2069 6666  Return non-0 iff
│ │ │ │ +000387b0: 2074 6865 2022 4d75 7475 616c 2072 6571   the "Mutual req
│ │ │ │ +000387c0: 7569 7265 6422 206f 7074 696f 6e20 6973  uired" option is
│ │ │ │ +000387d0: 2073 6574 0a20 2020 2020 696e 2074 6865   set.     in the
│ │ │ │ +000387e0: 2041 502d 5245 512e 0a0a 2020 2020 202a   AP-REQ...     *
│ │ │ │ +000387f0: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ +00038800: 6574 7572 6e73 2053 4849 5348 495f 4f4b  eturns SHISHI_OK
│ │ │ │ +00038810: 2069 6666 2073 7563 6365 7373 6675 6c2e   iff successful.
│ │ │ │ +00038820: 0a0a 7368 6973 6869 5f61 7072 6571 5f6f  ..shishi_apreq_o
│ │ │ │ +00038830: 7074 696f 6e73 5f73 6574 0a2d 2d2d 2d2d  ptions_set.-----
│ │ │ │  00038840: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00038850: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ -00038860: 2069 6e74 2073 6869 7368 695f 6170 7265   int shishi_apre
│ │ │ │ -00038870: 715f 6f70 7469 6f6e 735f 7365 7420 2853  q_options_set (S
│ │ │ │ -00038880: 6869 7368 6920 2a20 4841 4e44 4c45 2c0a  hishi * HANDLE,.
│ │ │ │ -00038890: 2020 2020 2020 2020 2020 5368 6973 6869            Shishi
│ │ │ │ -000388a0: 5f61 736e 3120 4150 5245 512c 2075 696e  _asn1 APREQ, uin
│ │ │ │ -000388b0: 7433 325f 7420 4f50 5449 4f4e 5329 0a20  t32_t OPTIONS). 
│ │ │ │ -000388c0: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ -000388d0: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ -000388e0: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ -000388f0: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ -00038900: 2020 2020 4150 5245 513a 2041 502d 5245      APREQ: AP-RE
│ │ │ │ -00038910: 5120 6173 2061 6c6c 6f63 6174 6564 2062  Q as allocated b
│ │ │ │ -00038920: 7920 e280 9873 6869 7368 695f 6170 7265  y ...shishi_apre
│ │ │ │ -00038930: 7128 29e2 8099 2e0a 2020 2020 204f 5054  q().....     OPT
│ │ │ │ -00038940: 494f 4e53 3a20 4f70 7469 6f6e 7320 746f  IONS: Options to
│ │ │ │ -00038950: 2073 6574 2069 6e20 4150 2d52 4551 2e0a   set in AP-REQ..
│ │ │ │ -00038960: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -00038970: 6f6e 3a2a 2053 6574 2074 6865 2041 502d  on:* Set the AP-
│ │ │ │ -00038980: 4f70 7469 6f6e 7320 696e 2041 502d 5245  Options in AP-RE
│ │ │ │ -00038990: 5120 746f 2069 6e64 6963 6174 6520 696e  Q to indicate in
│ │ │ │ -000389a0: 7465 6765 722e 0a0a 2020 2020 202a 5265  teger...     *Re
│ │ │ │ -000389b0: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ -000389c0: 7572 6e73 2053 4849 5348 495f 4f4b 2069  urns SHISHI_OK i
│ │ │ │ -000389d0: 6666 2073 7563 6365 7373 6675 6c2e 0a0a  ff successful...
│ │ │ │ -000389e0: 7368 6973 6869 5f61 7072 6571 5f6f 7074  shishi_apreq_opt
│ │ │ │ -000389f0: 696f 6e73 5f61 6464 0a2d 2d2d 2d2d 2d2d  ions_add.-------
│ │ │ │ +00038850: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ +00038860: 6e3a 2069 6e74 2073 6869 7368 695f 6170  n: int shishi_ap
│ │ │ │ +00038870: 7265 715f 6f70 7469 6f6e 735f 7365 7420  req_options_set 
│ │ │ │ +00038880: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ +00038890: 2c0a 2020 2020 2020 2020 2020 5368 6973  ,.          Shis
│ │ │ │ +000388a0: 6869 5f61 736e 3120 4150 5245 512c 2075  hi_asn1 APREQ, u
│ │ │ │ +000388b0: 696e 7433 325f 7420 4f50 5449 4f4e 5329  int32_t OPTIONS)
│ │ │ │ +000388c0: 0a20 2020 2020 4841 4e44 4c45 3a20 7368  .     HANDLE: sh
│ │ │ │ +000388d0: 6973 6869 2068 616e 646c 6520 6173 2061  ishi handle as a
│ │ │ │ +000388e0: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ +000388f0: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ +00038900: 0a20 2020 2020 4150 5245 513a 2041 502d  .     APREQ: AP-
│ │ │ │ +00038910: 5245 5120 6173 2061 6c6c 6f63 6174 6564  REQ as allocated
│ │ │ │ +00038920: 2062 7920 e280 9873 6869 7368 695f 6170   by ...shishi_ap
│ │ │ │ +00038930: 7265 7128 29e2 8099 2e0a 2020 2020 204f  req().....     O
│ │ │ │ +00038940: 5054 494f 4e53 3a20 4f70 7469 6f6e 7320  PTIONS: Options 
│ │ │ │ +00038950: 746f 2073 6574 2069 6e20 4150 2d52 4551  to set in AP-REQ
│ │ │ │ +00038960: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ +00038970: 7469 6f6e 3a2a 2053 6574 2074 6865 2041  tion:* Set the A
│ │ │ │ +00038980: 502d 4f70 7469 6f6e 7320 696e 2041 502d  P-Options in AP-
│ │ │ │ +00038990: 5245 5120 746f 2069 6e64 6963 6174 6520  REQ to indicate 
│ │ │ │ +000389a0: 696e 7465 6765 722e 0a0a 2020 2020 202a  integer...     *
│ │ │ │ +000389b0: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ +000389c0: 6574 7572 6e73 2053 4849 5348 495f 4f4b  eturns SHISHI_OK
│ │ │ │ +000389d0: 2069 6666 2073 7563 6365 7373 6675 6c2e   iff successful.
│ │ │ │ +000389e0: 0a0a 7368 6973 6869 5f61 7072 6571 5f6f  ..shishi_apreq_o
│ │ │ │ +000389f0: 7074 696f 6e73 5f61 6464 0a2d 2d2d 2d2d  ptions_add.-----
│ │ │ │  00038a00: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00038a10: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ -00038a20: 2069 6e74 2073 6869 7368 695f 6170 7265   int shishi_apre
│ │ │ │ -00038a30: 715f 6f70 7469 6f6e 735f 6164 6420 2853  q_options_add (S
│ │ │ │ -00038a40: 6869 7368 6920 2a20 4841 4e44 4c45 2c0a  hishi * HANDLE,.
│ │ │ │ -00038a50: 2020 2020 2020 2020 2020 5368 6973 6869            Shishi
│ │ │ │ -00038a60: 5f61 736e 3120 4150 5245 512c 2075 696e  _asn1 APREQ, uin
│ │ │ │ -00038a70: 7433 325f 7420 4f50 5449 4f4e 290a 2020  t32_t OPTION).  
│ │ │ │ -00038a80: 2020 2048 414e 444c 453a 2073 6869 7368     HANDLE: shish
│ │ │ │ -00038a90: 6920 6861 6e64 6c65 2061 7320 616c 6c6f  i handle as allo
│ │ │ │ -00038aa0: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ -00038ab0: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ -00038ac0: 2020 2041 5052 4551 3a20 4150 2d52 4551     APREQ: AP-REQ
│ │ │ │ -00038ad0: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ -00038ae0: 20e2 8098 7368 6973 6869 5f61 7072 6571   ...shishi_apreq
│ │ │ │ -00038af0: 2829 e280 992e 0a20 2020 2020 4f50 5449  ().....     OPTI
│ │ │ │ -00038b00: 4f4e 3a20 4f70 7469 6f6e 7320 746f 2061  ON: Options to a
│ │ │ │ -00038b10: 6464 2069 6e20 4150 2d52 4551 2e0a 0a20  dd in AP-REQ... 
│ │ │ │ -00038b20: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -00038b30: 3a2a 2041 6464 2074 6865 2041 502d 4f70  :* Add the AP-Op
│ │ │ │ -00038b40: 7469 6f6e 7320 696e 2041 502d 5245 512e  tions in AP-REQ.
│ │ │ │ -00038b50: 204f 7074 696f 6e73 206e 6f74 2073 6574   Options not set
│ │ │ │ -00038b60: 2069 6e0a 2020 2020 2069 6e70 7574 2070   in.     input p
│ │ │ │ -00038b70: 6172 616d 6574 6572 204f 5054 494f 4e20  arameter OPTION 
│ │ │ │ -00038b80: 6172 6520 7072 6573 6572 7665 6420 696e  are preserved in
│ │ │ │ -00038b90: 2074 6865 2041 502d 5245 512e 0a0a 2020   the AP-REQ...  
│ │ │ │ -00038ba0: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ -00038bb0: 3a2a 2052 6574 7572 6e73 2053 4849 5348  :* Returns SHISH
│ │ │ │ -00038bc0: 495f 4f4b 2069 6666 2073 7563 6365 7373  I_OK iff success
│ │ │ │ -00038bd0: 6675 6c2e 0a0a 7368 6973 6869 5f61 7072  ful...shishi_apr
│ │ │ │ -00038be0: 6571 5f6f 7074 696f 6e73 5f72 656d 6f76  eq_options_remov
│ │ │ │ -00038bf0: 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  e.--------------
│ │ │ │ -00038c00: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -00038c10: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ -00038c20: 2073 6869 7368 695f 6170 7265 715f 6f70   shishi_apreq_op
│ │ │ │ -00038c30: 7469 6f6e 735f 7265 6d6f 7665 2028 5368  tions_remove (Sh
│ │ │ │ -00038c40: 6973 6869 202a 2048 414e 444c 452c 0a20  ishi * HANDLE,. 
│ │ │ │ -00038c50: 2020 2020 2020 2020 2053 6869 7368 695f           Shishi_
│ │ │ │ -00038c60: 6173 6e31 2041 5052 4551 2c20 7569 6e74  asn1 APREQ, uint
│ │ │ │ -00038c70: 3332 5f74 204f 5054 494f 4e29 0a20 2020  32_t OPTION).   
│ │ │ │ -00038c80: 2020 4841 4e44 4c45 3a20 7368 6973 6869    HANDLE: shishi
│ │ │ │ -00038c90: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ -00038ca0: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ -00038cb0: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ -00038cc0: 2020 4150 5245 513a 2041 502d 5245 5120    APREQ: AP-REQ 
│ │ │ │ -00038cd0: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ -00038ce0: e280 9873 6869 7368 695f 6170 7265 7128  ...shishi_apreq(
│ │ │ │ -00038cf0: 29e2 8099 2e0a 2020 2020 204f 5054 494f  ).....     OPTIO
│ │ │ │ -00038d00: 4e3a 204f 7074 696f 6e73 2074 6f20 7265  N: Options to re
│ │ │ │ -00038d10: 6d6f 7665 2066 726f 6d20 4150 2d52 4551  move from AP-REQ
│ │ │ │ -00038d20: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ -00038d30: 7469 6f6e 3a2a 2052 656d 6f76 6520 7468  tion:* Remove th
│ │ │ │ -00038d40: 6520 4150 2d4f 7074 696f 6e73 2066 726f  e AP-Options fro
│ │ │ │ -00038d50: 6d20 4150 2d52 4551 2e20 4f70 7469 6f6e  m AP-REQ. Option
│ │ │ │ -00038d60: 7320 6e6f 7420 7365 740a 2020 2020 2069  s not set.     i
│ │ │ │ -00038d70: 6e20 696e 7075 7420 7061 7261 6d65 7465  n input paramete
│ │ │ │ -00038d80: 7220 4f50 5449 4f4e 2061 7265 2070 7265  r OPTION are pre
│ │ │ │ -00038d90: 7365 7276 6564 2069 6e20 7468 6520 4150  served in the AP
│ │ │ │ -00038da0: 2d52 4551 2e0a 0a20 2020 2020 2a52 6574  -REQ...     *Ret
│ │ │ │ -00038db0: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ -00038dc0: 726e 7320 5348 4953 4849 5f4f 4b20 6966  rns SHISHI_OK if
│ │ │ │ -00038dd0: 6620 7375 6363 6573 7366 756c 2e0a 0a73  f successful...s
│ │ │ │ -00038de0: 6869 7368 695f 6170 7265 715f 6765 745f  hishi_apreq_get_
│ │ │ │ -00038df0: 6175 7468 656e 7469 6361 746f 725f 6574  authenticator_et
│ │ │ │ -00038e00: 7970 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ype.------------
│ │ │ │ +00038a10: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ +00038a20: 6e3a 2069 6e74 2073 6869 7368 695f 6170  n: int shishi_ap
│ │ │ │ +00038a30: 7265 715f 6f70 7469 6f6e 735f 6164 6420  req_options_add 
│ │ │ │ +00038a40: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ +00038a50: 2c0a 2020 2020 2020 2020 2020 5368 6973  ,.          Shis
│ │ │ │ +00038a60: 6869 5f61 736e 3120 4150 5245 512c 2075  hi_asn1 APREQ, u
│ │ │ │ +00038a70: 696e 7433 325f 7420 4f50 5449 4f4e 290a  int32_t OPTION).
│ │ │ │ +00038a80: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ +00038a90: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ +00038aa0: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ +00038ab0: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ +00038ac0: 2020 2020 2041 5052 4551 3a20 4150 2d52       APREQ: AP-R
│ │ │ │ +00038ad0: 4551 2061 7320 616c 6c6f 6361 7465 6420  EQ as allocated 
│ │ │ │ +00038ae0: 6279 20e2 8098 7368 6973 6869 5f61 7072  by ...shishi_apr
│ │ │ │ +00038af0: 6571 2829 e280 992e 0a20 2020 2020 4f50  eq().....     OP
│ │ │ │ +00038b00: 5449 4f4e 3a20 4f70 7469 6f6e 7320 746f  TION: Options to
│ │ │ │ +00038b10: 2061 6464 2069 6e20 4150 2d52 4551 2e0a   add in AP-REQ..
│ │ │ │ +00038b20: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +00038b30: 6f6e 3a2a 2041 6464 2074 6865 2041 502d  on:* Add the AP-
│ │ │ │ +00038b40: 4f70 7469 6f6e 7320 696e 2041 502d 5245  Options in AP-RE
│ │ │ │ +00038b50: 512e 204f 7074 696f 6e73 206e 6f74 2073  Q. Options not s
│ │ │ │ +00038b60: 6574 2069 6e0a 2020 2020 2069 6e70 7574  et in.     input
│ │ │ │ +00038b70: 2070 6172 616d 6574 6572 204f 5054 494f   parameter OPTIO
│ │ │ │ +00038b80: 4e20 6172 6520 7072 6573 6572 7665 6420  N are preserved 
│ │ │ │ +00038b90: 696e 2074 6865 2041 502d 5245 512e 0a0a  in the AP-REQ...
│ │ │ │ +00038ba0: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ +00038bb0: 7565 3a2a 2052 6574 7572 6e73 2053 4849  ue:* Returns SHI
│ │ │ │ +00038bc0: 5348 495f 4f4b 2069 6666 2073 7563 6365  SHI_OK iff succe
│ │ │ │ +00038bd0: 7373 6675 6c2e 0a0a 7368 6973 6869 5f61  ssful...shishi_a
│ │ │ │ +00038be0: 7072 6571 5f6f 7074 696f 6e73 5f72 656d  preq_options_rem
│ │ │ │ +00038bf0: 6f76 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ove.------------
│ │ │ │ +00038c00: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +00038c10: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ +00038c20: 6e74 2073 6869 7368 695f 6170 7265 715f  nt shishi_apreq_
│ │ │ │ +00038c30: 6f70 7469 6f6e 735f 7265 6d6f 7665 2028  options_remove (
│ │ │ │ +00038c40: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ +00038c50: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ +00038c60: 695f 6173 6e31 2041 5052 4551 2c20 7569  i_asn1 APREQ, ui
│ │ │ │ +00038c70: 6e74 3332 5f74 204f 5054 494f 4e29 0a20  nt32_t OPTION). 
│ │ │ │ +00038c80: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ +00038c90: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ +00038ca0: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ +00038cb0: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ +00038cc0: 2020 2020 4150 5245 513a 2041 502d 5245      APREQ: AP-RE
│ │ │ │ +00038cd0: 5120 6173 2061 6c6c 6f63 6174 6564 2062  Q as allocated b
│ │ │ │ +00038ce0: 7920 e280 9873 6869 7368 695f 6170 7265  y ...shishi_apre
│ │ │ │ +00038cf0: 7128 29e2 8099 2e0a 2020 2020 204f 5054  q().....     OPT
│ │ │ │ +00038d00: 494f 4e3a 204f 7074 696f 6e73 2074 6f20  ION: Options to 
│ │ │ │ +00038d10: 7265 6d6f 7665 2066 726f 6d20 4150 2d52  remove from AP-R
│ │ │ │ +00038d20: 4551 2e0a 0a20 2020 2020 2a44 6573 6372  EQ...     *Descr
│ │ │ │ +00038d30: 6970 7469 6f6e 3a2a 2052 656d 6f76 6520  iption:* Remove 
│ │ │ │ +00038d40: 7468 6520 4150 2d4f 7074 696f 6e73 2066  the AP-Options f
│ │ │ │ +00038d50: 726f 6d20 4150 2d52 4551 2e20 4f70 7469  rom AP-REQ. Opti
│ │ │ │ +00038d60: 6f6e 7320 6e6f 7420 7365 740a 2020 2020  ons not set.    
│ │ │ │ +00038d70: 2069 6e20 696e 7075 7420 7061 7261 6d65   in input parame
│ │ │ │ +00038d80: 7465 7220 4f50 5449 4f4e 2061 7265 2070  ter OPTION are p
│ │ │ │ +00038d90: 7265 7365 7276 6564 2069 6e20 7468 6520  reserved in the 
│ │ │ │ +00038da0: 4150 2d52 4551 2e0a 0a20 2020 2020 2a52  AP-REQ...     *R
│ │ │ │ +00038db0: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +00038dc0: 7475 726e 7320 5348 4953 4849 5f4f 4b20  turns SHISHI_OK 
│ │ │ │ +00038dd0: 6966 6620 7375 6363 6573 7366 756c 2e0a  iff successful..
│ │ │ │ +00038de0: 0a73 6869 7368 695f 6170 7265 715f 6765  .shishi_apreq_ge
│ │ │ │ +00038df0: 745f 6175 7468 656e 7469 6361 746f 725f  t_authenticator_
│ │ │ │ +00038e00: 6574 7970 650a 2d2d 2d2d 2d2d 2d2d 2d2d  etype.----------
│ │ │ │  00038e10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00038e20: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -00038e30: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ -00038e40: 6869 5f61 7072 6571 5f67 6574 5f61 7574  hi_apreq_get_aut
│ │ │ │ -00038e50: 6865 6e74 6963 6174 6f72 5f65 7479 7065  henticator_etype
│ │ │ │ -00038e60: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ -00038e70: 452c 0a20 2020 2020 2020 2020 2053 6869  E,.          Shi
│ │ │ │ -00038e80: 7368 695f 6173 6e31 2041 5052 4551 2c20  shi_asn1 APREQ, 
│ │ │ │ -00038e90: 696e 7433 325f 7420 2a20 4554 5950 4529  int32_t * ETYPE)
│ │ │ │ -00038ea0: 0a20 2020 2020 4841 4e44 4c45 3a20 7368  .     HANDLE: sh
│ │ │ │ -00038eb0: 6973 6869 2068 616e 646c 6520 6173 2061  ishi handle as a
│ │ │ │ -00038ec0: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ -00038ed0: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ -00038ee0: 0a20 2020 2020 4150 5245 513a 2041 502d  .     APREQ: AP-
│ │ │ │ -00038ef0: 5245 5120 7661 7269 6162 6c65 2074 6f20  REQ variable to 
│ │ │ │ -00038f00: 6765 7420 7661 6c75 6520 6672 6f6d 2e0a  get value from..
│ │ │ │ -00038f10: 2020 2020 2045 5459 5045 3a20 6f75 7470       ETYPE: outp
│ │ │ │ -00038f20: 7574 2076 6172 6961 626c 6520 7468 6174  ut variable that
│ │ │ │ -00038f30: 2068 6f6c 6473 2074 6865 2076 616c 7565   holds the value
│ │ │ │ -00038f40: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ -00038f50: 7469 6f6e 3a2a 2045 7874 7261 6374 2041  tion:* Extract A
│ │ │ │ -00038f60: 502d 5245 512e 6175 7468 656e 7469 6361  P-REQ.authentica
│ │ │ │ -00038f70: 746f 722e 6574 7970 652e 0a0a 2020 2020  tor.etype...    
│ │ │ │ -00038f80: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ -00038f90: 2052 6574 7572 6e73 2053 4849 5348 495f   Returns SHISHI_
│ │ │ │ -00038fa0: 4f4b 2069 6666 2073 7563 6365 7373 6675  OK iff successfu
│ │ │ │ -00038fb0: 6c2e 0a0a 7368 6973 6869 5f61 7072 6571  l...shishi_apreq
│ │ │ │ -00038fc0: 5f67 6574 5f74 6963 6b65 740a 2d2d 2d2d  _get_ticket.----
│ │ │ │ +00038e20: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +00038e30: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ +00038e40: 6973 6869 5f61 7072 6571 5f67 6574 5f61  ishi_apreq_get_a
│ │ │ │ +00038e50: 7574 6865 6e74 6963 6174 6f72 5f65 7479  uthenticator_ety
│ │ │ │ +00038e60: 7065 2028 5368 6973 6869 202a 2048 414e  pe (Shishi * HAN
│ │ │ │ +00038e70: 444c 452c 0a20 2020 2020 2020 2020 2053  DLE,.          S
│ │ │ │ +00038e80: 6869 7368 695f 6173 6e31 2041 5052 4551  hishi_asn1 APREQ
│ │ │ │ +00038e90: 2c20 696e 7433 325f 7420 2a20 4554 5950  , int32_t * ETYP
│ │ │ │ +00038ea0: 4529 0a20 2020 2020 4841 4e44 4c45 3a20  E).     HANDLE: 
│ │ │ │ +00038eb0: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ +00038ec0: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ +00038ed0: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ +00038ee0: 992e 0a20 2020 2020 4150 5245 513a 2041  ...     APREQ: A
│ │ │ │ +00038ef0: 502d 5245 5120 7661 7269 6162 6c65 2074  P-REQ variable t
│ │ │ │ +00038f00: 6f20 6765 7420 7661 6c75 6520 6672 6f6d  o get value from
│ │ │ │ +00038f10: 2e0a 2020 2020 2045 5459 5045 3a20 6f75  ..     ETYPE: ou
│ │ │ │ +00038f20: 7470 7574 2076 6172 6961 626c 6520 7468  tput variable th
│ │ │ │ +00038f30: 6174 2068 6f6c 6473 2074 6865 2076 616c  at holds the val
│ │ │ │ +00038f40: 7565 2e0a 0a20 2020 2020 2a44 6573 6372  ue...     *Descr
│ │ │ │ +00038f50: 6970 7469 6f6e 3a2a 2045 7874 7261 6374  iption:* Extract
│ │ │ │ +00038f60: 2041 502d 5245 512e 6175 7468 656e 7469   AP-REQ.authenti
│ │ │ │ +00038f70: 6361 746f 722e 6574 7970 652e 0a0a 2020  cator.etype...  
│ │ │ │ +00038f80: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ +00038f90: 3a2a 2052 6574 7572 6e73 2053 4849 5348  :* Returns SHISH
│ │ │ │ +00038fa0: 495f 4f4b 2069 6666 2073 7563 6365 7373  I_OK iff success
│ │ │ │ +00038fb0: 6675 6c2e 0a0a 7368 6973 6869 5f61 7072  ful...shishi_apr
│ │ │ │ +00038fc0: 6571 5f67 6574 5f74 6963 6b65 740a 2d2d  eq_get_ticket.--
│ │ │ │  00038fd0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00038fe0: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ -00038ff0: 6e3a 2069 6e74 2073 6869 7368 695f 6170  n: int shishi_ap
│ │ │ │ -00039000: 7265 715f 6765 745f 7469 636b 6574 2028  req_get_ticket (
│ │ │ │ -00039010: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ -00039020: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ -00039030: 695f 6173 6e31 2041 5052 4551 2c20 5368  i_asn1 APREQ, Sh
│ │ │ │ -00039040: 6973 6869 5f61 736e 3120 2a20 5449 434b  ishi_asn1 * TICK
│ │ │ │ -00039050: 4554 290a 2020 2020 2048 414e 444c 453a  ET).     HANDLE:
│ │ │ │ -00039060: 2073 6869 7368 6920 6861 6e64 6c65 2061   shishi handle a
│ │ │ │ -00039070: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ -00039080: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ -00039090: 8099 2e0a 2020 2020 2041 5052 4551 3a20  ....     APREQ: 
│ │ │ │ -000390a0: 4150 2d52 4551 2076 6172 6961 626c 6520  AP-REQ variable 
│ │ │ │ -000390b0: 746f 2067 6574 2074 6963 6b65 7420 6672  to get ticket fr
│ │ │ │ -000390c0: 6f6d 2e0a 2020 2020 2054 4943 4b45 543a  om..     TICKET:
│ │ │ │ -000390d0: 206f 7574 7075 7420 7661 7269 6162 6c65   output variable
│ │ │ │ -000390e0: 2074 6f20 686f 6c64 2065 7874 7261 6374   to hold extract
│ │ │ │ -000390f0: 6564 2074 6963 6b65 742e 0a0a 2020 2020  ed ticket...    
│ │ │ │ -00039100: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ -00039110: 4578 7472 6163 7420 7469 636b 6574 2066  Extract ticket f
│ │ │ │ -00039120: 726f 6d20 4150 2d52 4551 2e0a 0a20 2020  rom AP-REQ...   
│ │ │ │ -00039130: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ -00039140: 2a20 5265 7475 726e 7320 5348 4953 4849  * Returns SHISHI
│ │ │ │ -00039150: 5f4f 4b20 6966 6620 7375 6363 6573 7366  _OK iff successf
│ │ │ │ -00039160: 756c 2e0a 0a73 6869 7368 695f 6170 7265  ul...shishi_apre
│ │ │ │ -00039170: 700a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  p.------------..
│ │ │ │ -00039180: 202d 2d20 4675 6e63 7469 6f6e 3a20 5368   -- Function: Sh
│ │ │ │ -00039190: 6973 6869 5f61 736e 3120 7368 6973 6869  ishi_asn1 shishi
│ │ │ │ -000391a0: 5f61 7072 6570 2028 5368 6973 6869 202a  _aprep (Shishi *
│ │ │ │ -000391b0: 2048 414e 444c 4529 0a20 2020 2020 4841   HANDLE).     HA
│ │ │ │ -000391c0: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ -000391d0: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ -000391e0: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ -000391f0: 6974 2829 e280 992e 0a0a 2020 2020 202a  it()......     *
│ │ │ │ -00039200: 4465 7363 7269 7074 696f 6e3a 2a20 5468  Description:* Th
│ │ │ │ -00039210: 6973 2066 756e 6374 696f 6e20 6372 6561  is function crea
│ │ │ │ -00039220: 7465 7320 6120 6e65 7720 4150 2d52 4550  tes a new AP-REP
│ │ │ │ -00039230: 2c20 706f 7075 6c61 7465 6420 7769 7468  , populated with
│ │ │ │ -00039240: 0a20 2020 2020 736f 6d65 2064 6566 6175  .     some defau
│ │ │ │ -00039250: 6c74 2076 616c 7565 732e 0a0a 2020 2020  lt values...    
│ │ │ │ -00039260: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ -00039270: 2052 6574 7572 6e73 2074 6865 2061 7574   Returns the aut
│ │ │ │ -00039280: 6865 6e74 6963 6174 6f72 206f 7220 4e55  henticator or NU
│ │ │ │ -00039290: 4c4c 206f 6e20 6661 696c 7572 652e 0a0a  LL on failure...
│ │ │ │ -000392a0: 7368 6973 6869 5f61 7072 6570 5f70 7269  shishi_aprep_pri
│ │ │ │ -000392b0: 6e74 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  nt.-------------
│ │ │ │ -000392c0: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ -000392d0: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ -000392e0: 6170 7265 705f 7072 696e 7420 2853 6869  aprep_print (Shi
│ │ │ │ -000392f0: 7368 6920 2a20 4841 4e44 4c45 2c20 4649  shi * HANDLE, FI
│ │ │ │ -00039300: 4c45 202a 2046 482c 0a20 2020 2020 2020  LE * FH,.       
│ │ │ │ -00039310: 2020 2053 6869 7368 695f 6173 6e31 2041     Shishi_asn1 A
│ │ │ │ -00039320: 5052 4550 290a 2020 2020 2048 414e 444c  PREP).     HANDL
│ │ │ │ -00039330: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ -00039340: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ -00039350: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ -00039360: 29e2 8099 2e0a 2020 2020 2046 483a 2066  ).....     FH: f
│ │ │ │ -00039370: 696c 6520 6861 6e64 6c65 206f 7065 6e20  ile handle open 
│ │ │ │ -00039380: 666f 7220 7772 6974 696e 672e 0a20 2020  for writing..   
│ │ │ │ -00039390: 2020 4150 5245 503a 2041 502d 5245 5020    APREP: AP-REP 
│ │ │ │ -000393a0: 746f 2070 7269 6e74 2e0a 0a20 2020 2020  to print...     
│ │ │ │ -000393b0: 2a44 6573 6372 6970 7469 6f6e 3a2a 2050  *Description:* P
│ │ │ │ -000393c0: 7269 6e74 2041 5343 4949 2061 726d 6f72  rint ASCII armor
│ │ │ │ -000393d0: 6564 2044 4552 2065 6e63 6f64 696e 6720  ed DER encoding 
│ │ │ │ -000393e0: 6f66 2041 502d 5245 5020 746f 2066 696c  of AP-REP to fil
│ │ │ │ -000393f0: 652e 0a0a 2020 2020 202a 5265 7475 726e  e...     *Return
│ │ │ │ -00039400: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ -00039410: 2053 4849 5348 495f 4f4b 2069 6666 2073   SHISHI_OK iff s
│ │ │ │ -00039420: 7563 6365 7373 6675 6c2e 0a0a 7368 6973  uccessful...shis
│ │ │ │ -00039430: 6869 5f61 7072 6570 5f73 6176 650a 2d2d  hi_aprep_save.--
│ │ │ │ -00039440: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -00039450: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ -00039460: 6e74 2073 6869 7368 695f 6170 7265 705f  nt shishi_aprep_
│ │ │ │ -00039470: 7361 7665 2028 5368 6973 6869 202a 2048  save (Shishi * H
│ │ │ │ -00039480: 414e 444c 452c 2046 494c 4520 2a20 4648  ANDLE, FILE * FH
│ │ │ │ -00039490: 2c0a 2020 2020 2020 2020 2020 5368 6973  ,.          Shis
│ │ │ │ -000394a0: 6869 5f61 736e 3120 4150 5245 5029 0a20  hi_asn1 APREP). 
│ │ │ │ -000394b0: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ -000394c0: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ -000394d0: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ -000394e0: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ -000394f0: 2020 2020 4648 3a20 6669 6c65 2068 616e      FH: file han
│ │ │ │ -00039500: 646c 6520 6f70 656e 2066 6f72 2077 7269  dle open for wri
│ │ │ │ -00039510: 7469 6e67 2e0a 2020 2020 2041 5052 4550  ting..     APREP
│ │ │ │ -00039520: 3a20 4150 2d52 4550 2074 6f20 7361 7665  : AP-REP to save
│ │ │ │ -00039530: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ -00039540: 7469 6f6e 3a2a 2053 6176 6520 4445 5220  tion:* Save DER 
│ │ │ │ -00039550: 656e 636f 6469 6e67 206f 6620 4150 2d52  encoding of AP-R
│ │ │ │ -00039560: 4550 2074 6f20 6669 6c65 2e0a 0a20 2020  EP to file...   
│ │ │ │ -00039570: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ -00039580: 2a20 5265 7475 726e 7320 5348 4953 4849  * Returns SHISHI
│ │ │ │ -00039590: 5f4f 4b20 6966 6620 7375 6363 6573 7366  _OK iff successf
│ │ │ │ -000395a0: 756c 2e0a 0a73 6869 7368 695f 6170 7265  ul...shishi_apre
│ │ │ │ -000395b0: 705f 746f 5f66 696c 650a 2d2d 2d2d 2d2d  p_to_file.------
│ │ │ │ -000395c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -000395d0: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ -000395e0: 7420 7368 6973 6869 5f61 7072 6570 5f74  t shishi_aprep_t
│ │ │ │ -000395f0: 6f5f 6669 6c65 2028 5368 6973 6869 202a  o_file (Shishi *
│ │ │ │ -00039600: 2048 414e 444c 452c 0a20 2020 2020 2020   HANDLE,.       
│ │ │ │ -00039610: 2020 2053 6869 7368 695f 6173 6e31 2041     Shishi_asn1 A
│ │ │ │ -00039620: 5052 4550 2c20 696e 7420 4649 4c45 5459  PREP, int FILETY
│ │ │ │ -00039630: 5045 2c20 636f 6e73 7420 6368 6172 202a  PE, const char *
│ │ │ │ -00039640: 2046 494c 454e 414d 4529 0a20 2020 2020   FILENAME).     
│ │ │ │ -00039650: 4841 4e44 4c45 3a20 7368 6973 6869 2068  HANDLE: shishi h
│ │ │ │ -00039660: 616e 646c 6520 6173 2061 6c6c 6f63 6174  andle as allocat
│ │ │ │ -00039670: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ -00039680: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ -00039690: 4150 5245 503a 2041 502d 5245 5020 746f  APREP: AP-REP to
│ │ │ │ -000396a0: 2073 6176 652e 0a20 2020 2020 4649 4c45   save..     FILE
│ │ │ │ -000396b0: 5459 5045 3a20 696e 7075 7420 7661 7269  TYPE: input vari
│ │ │ │ -000396c0: 6162 6c65 2073 7065 6369 6679 696e 6720  able specifying 
│ │ │ │ -000396d0: 7479 7065 206f 6620 6669 6c65 2074 6f20  type of file to 
│ │ │ │ -000396e0: 6265 2077 7269 7474 656e 2c20 7365 650a  be written, see.
│ │ │ │ -000396f0: 2020 2020 2053 6869 7368 695f 6669 6c65       Shishi_file
│ │ │ │ -00039700: 7479 7065 2e0a 2020 2020 2046 494c 454e  type..     FILEN
│ │ │ │ -00039710: 414d 453a 2069 6e70 7574 2076 6172 6961  AME: input varia
│ │ │ │ -00039720: 626c 6520 7769 7468 2066 696c 656e 616d  ble with filenam
│ │ │ │ -00039730: 6520 746f 2077 7269 7465 2074 6f2e 0a0a  e to write to...
│ │ │ │ -00039740: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ -00039750: 6e3a 2a20 5772 6974 6520 4150 2d52 4550  n:* Write AP-REP
│ │ │ │ -00039760: 2074 6f20 6669 6c65 2069 6e20 7370 6563   to file in spec
│ │ │ │ -00039770: 6966 6965 6420 5459 5045 2e20 5468 6520  ified TYPE. The 
│ │ │ │ -00039780: 6669 6c65 0a20 2020 2020 7769 6c6c 2062  file.     will b
│ │ │ │ -00039790: 6520 7472 756e 6361 7465 6420 6966 2069  e truncated if i
│ │ │ │ -000397a0: 7420 6578 6973 7473 2e0a 0a20 2020 2020  t exists...     
│ │ │ │ -000397b0: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ -000397c0: 5265 7475 726e 7320 5348 4953 4849 5f4f  Returns SHISHI_O
│ │ │ │ -000397d0: 4b20 6966 6620 7375 6363 6573 7366 756c  K iff successful
│ │ │ │ -000397e0: 2e0a 0a73 6869 7368 695f 6170 7265 705f  ...shishi_aprep_
│ │ │ │ -000397f0: 7061 7273 650a 2d2d 2d2d 2d2d 2d2d 2d2d  parse.----------
│ │ │ │ -00039800: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -00039810: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ -00039820: 6869 5f61 7072 6570 5f70 6172 7365 2028  hi_aprep_parse (
│ │ │ │ -00039830: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ -00039840: 2046 494c 4520 2a20 4648 2c0a 2020 2020   FILE * FH,.    
│ │ │ │ -00039850: 2020 2020 2020 5368 6973 6869 5f61 736e        Shishi_asn
│ │ │ │ -00039860: 3120 2a20 4150 5245 5029 0a20 2020 2020  1 * APREP).     
│ │ │ │ -00039870: 4841 4e44 4c45 3a20 7368 6973 6869 2068  HANDLE: shishi h
│ │ │ │ -00039880: 616e 646c 6520 6173 2061 6c6c 6f63 6174  andle as allocat
│ │ │ │ -00039890: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ -000398a0: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ -000398b0: 4648 3a20 6669 6c65 2068 616e 646c 6520  FH: file handle 
│ │ │ │ -000398c0: 6f70 656e 2066 6f72 2072 6561 6469 6e67  open for reading
│ │ │ │ -000398d0: 2e0a 2020 2020 2041 5052 4550 3a20 6f75  ..     APREP: ou
│ │ │ │ -000398e0: 7470 7574 2076 6172 6961 626c 6520 7769  tput variable wi
│ │ │ │ -000398f0: 7468 206e 6577 6c79 2061 6c6c 6f63 6174  th newly allocat
│ │ │ │ -00039900: 6564 2041 502d 5245 502e 0a0a 2020 2020  ed AP-REP...    
│ │ │ │ -00039910: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ -00039920: 5265 6164 2041 5343 4949 2061 726d 6f72  Read ASCII armor
│ │ │ │ -00039930: 6564 2044 4552 2065 6e63 6f64 6564 2041  ed DER encoded A
│ │ │ │ -00039940: 502d 5245 5020 6672 6f6d 2066 696c 6520  P-REP from file 
│ │ │ │ -00039950: 616e 640a 2020 2020 2070 6f70 756c 6174  and.     populat
│ │ │ │ -00039960: 6520 6769 7665 6e20 7661 7269 6162 6c65  e given variable
│ │ │ │ -00039970: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ -00039980: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ -00039990: 5348 4953 4849 5f4f 4b20 6966 6620 7375  SHISHI_OK iff su
│ │ │ │ -000399a0: 6363 6573 7366 756c 2e0a 0a73 6869 7368  ccessful...shish
│ │ │ │ -000399b0: 695f 6170 7265 705f 7265 6164 0a2d 2d2d  i_aprep_read.---
│ │ │ │ -000399c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -000399d0: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ -000399e0: 7420 7368 6973 6869 5f61 7072 6570 5f72  t shishi_aprep_r
│ │ │ │ -000399f0: 6561 6420 2853 6869 7368 6920 2a20 4841  ead (Shishi * HA
│ │ │ │ -00039a00: 4e44 4c45 2c20 4649 4c45 202a 2046 482c  NDLE, FILE * FH,
│ │ │ │ -00039a10: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ -00039a20: 695f 6173 6e31 202a 2041 5052 4550 290a  i_asn1 * APREP).
│ │ │ │ -00039a30: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ -00039a40: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ -00039a50: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ -00039a60: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ -00039a70: 2020 2020 2046 483a 2066 696c 6520 6861       FH: file ha
│ │ │ │ -00039a80: 6e64 6c65 206f 7065 6e20 666f 7220 7265  ndle open for re
│ │ │ │ -00039a90: 6164 696e 672e 0a20 2020 2020 4150 5245  ading..     APRE
│ │ │ │ -00039aa0: 503a 206f 7574 7075 7420 7661 7269 6162  P: output variab
│ │ │ │ -00039ab0: 6c65 2077 6974 6820 6e65 776c 7920 616c  le with newly al
│ │ │ │ -00039ac0: 6c6f 6361 7465 6420 4150 2d52 4550 2e0a  located AP-REP..
│ │ │ │ -00039ad0: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -00039ae0: 6f6e 3a2a 2052 6561 6420 4445 5220 656e  on:* Read DER en
│ │ │ │ -00039af0: 636f 6465 6420 4150 2d52 4550 2066 726f  coded AP-REP fro
│ │ │ │ -00039b00: 6d20 6669 6c65 2061 6e64 2070 6f70 756c  m file and popul
│ │ │ │ -00039b10: 6174 6520 6769 7665 6e0a 2020 2020 2076  ate given.     v
│ │ │ │ -00039b20: 6172 6961 626c 652e 0a0a 2020 2020 202a  ariable...     *
│ │ │ │ -00039b30: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ -00039b40: 6574 7572 6e73 2053 4849 5348 495f 4f4b  eturns SHISHI_OK
│ │ │ │ -00039b50: 2069 6666 2073 7563 6365 7373 6675 6c2e   iff successful.
│ │ │ │ -00039b60: 0a0a 7368 6973 6869 5f61 7072 6570 5f66  ..shishi_aprep_f
│ │ │ │ -00039b70: 726f 6d5f 6669 6c65 0a2d 2d2d 2d2d 2d2d  rom_file.-------
│ │ │ │ -00039b80: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -00039b90: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ -00039ba0: 6e74 2073 6869 7368 695f 6170 7265 705f  nt shishi_aprep_
│ │ │ │ -00039bb0: 6672 6f6d 5f66 696c 6520 2853 6869 7368  from_file (Shish
│ │ │ │ -00039bc0: 6920 2a20 4841 4e44 4c45 2c0a 2020 2020  i * HANDLE,.    
│ │ │ │ -00039bd0: 2020 2020 2020 5368 6973 6869 5f61 736e        Shishi_asn
│ │ │ │ -00039be0: 3120 2a20 4150 5245 502c 2069 6e74 2046  1 * APREP, int F
│ │ │ │ -00039bf0: 494c 4554 5950 452c 2063 6f6e 7374 2063  ILETYPE, const c
│ │ │ │ -00039c00: 6861 7220 2a20 4649 4c45 4e41 4d45 290a  har * FILENAME).
│ │ │ │ -00039c10: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ -00039c20: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ -00039c30: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ -00039c40: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ -00039c50: 2020 2020 2041 5052 4550 3a20 6f75 7470       APREP: outp
│ │ │ │ -00039c60: 7574 2076 6172 6961 626c 6520 7769 7468  ut variable with
│ │ │ │ -00039c70: 206e 6577 6c79 2061 6c6c 6f63 6174 6564   newly allocated
│ │ │ │ -00039c80: 2041 502d 5245 502e 0a20 2020 2020 4649   AP-REP..     FI
│ │ │ │ -00039c90: 4c45 5459 5045 3a20 696e 7075 7420 7661  LETYPE: input va
│ │ │ │ -00039ca0: 7269 6162 6c65 2073 7065 6369 6679 696e  riable specifyin
│ │ │ │ -00039cb0: 6720 7479 7065 206f 6620 6669 6c65 2074  g type of file t
│ │ │ │ -00039cc0: 6f20 6265 2072 6561 642c 2073 6565 0a20  o be read, see. 
│ │ │ │ -00039cd0: 2020 2020 5368 6973 6869 5f66 696c 6574      Shishi_filet
│ │ │ │ -00039ce0: 7970 652e 0a20 2020 2020 4649 4c45 4e41  ype..     FILENA
│ │ │ │ -00039cf0: 4d45 3a20 696e 7075 7420 7661 7269 6162  ME: input variab
│ │ │ │ -00039d00: 6c65 2077 6974 6820 6669 6c65 6e61 6d65  le with filename
│ │ │ │ -00039d10: 2074 6f20 7265 6164 2066 726f 6d2e 0a0a   to read from...
│ │ │ │ -00039d20: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ -00039d30: 6e3a 2a20 5265 6164 2041 502d 5245 5020  n:* Read AP-REP 
│ │ │ │ -00039d40: 6672 6f6d 2066 696c 6520 696e 2073 7065  from file in spe
│ │ │ │ -00039d50: 6369 6669 6564 2054 5950 452e 0a0a 2020  cified TYPE...  
│ │ │ │ -00039d60: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ -00039d70: 3a2a 2052 6574 7572 6e73 2053 4849 5348  :* Returns SHISH
│ │ │ │ -00039d80: 495f 4f4b 2069 6666 2073 7563 6365 7373  I_OK iff success
│ │ │ │ -00039d90: 6675 6c2e 0a0a 7368 6973 6869 5f61 7072  ful...shishi_apr
│ │ │ │ -00039da0: 6570 5f67 6574 5f65 6e63 5f70 6172 745f  ep_get_enc_part_
│ │ │ │ -00039db0: 6574 7970 650a 2d2d 2d2d 2d2d 2d2d 2d2d  etype.----------
│ │ │ │ +00038fe0: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +00038ff0: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ +00039000: 6170 7265 715f 6765 745f 7469 636b 6574  apreq_get_ticket
│ │ │ │ +00039010: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ +00039020: 452c 0a20 2020 2020 2020 2020 2053 6869  E,.          Shi
│ │ │ │ +00039030: 7368 695f 6173 6e31 2041 5052 4551 2c20  shi_asn1 APREQ, 
│ │ │ │ +00039040: 5368 6973 6869 5f61 736e 3120 2a20 5449  Shishi_asn1 * TI
│ │ │ │ +00039050: 434b 4554 290a 2020 2020 2048 414e 444c  CKET).     HANDL
│ │ │ │ +00039060: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ +00039070: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ +00039080: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ +00039090: 29e2 8099 2e0a 2020 2020 2041 5052 4551  ).....     APREQ
│ │ │ │ +000390a0: 3a20 4150 2d52 4551 2076 6172 6961 626c  : AP-REQ variabl
│ │ │ │ +000390b0: 6520 746f 2067 6574 2074 6963 6b65 7420  e to get ticket 
│ │ │ │ +000390c0: 6672 6f6d 2e0a 2020 2020 2054 4943 4b45  from..     TICKE
│ │ │ │ +000390d0: 543a 206f 7574 7075 7420 7661 7269 6162  T: output variab
│ │ │ │ +000390e0: 6c65 2074 6f20 686f 6c64 2065 7874 7261  le to hold extra
│ │ │ │ +000390f0: 6374 6564 2074 6963 6b65 742e 0a0a 2020  cted ticket...  
│ │ │ │ +00039100: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ +00039110: 2a20 4578 7472 6163 7420 7469 636b 6574  * Extract ticket
│ │ │ │ +00039120: 2066 726f 6d20 4150 2d52 4551 2e0a 0a20   from AP-REQ... 
│ │ │ │ +00039130: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ +00039140: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ +00039150: 4849 5f4f 4b20 6966 6620 7375 6363 6573  HI_OK iff succes
│ │ │ │ +00039160: 7366 756c 2e0a 0a73 6869 7368 695f 6170  sful...shishi_ap
│ │ │ │ +00039170: 7265 700a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  rep.------------
│ │ │ │ +00039180: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +00039190: 5368 6973 6869 5f61 736e 3120 7368 6973  Shishi_asn1 shis
│ │ │ │ +000391a0: 6869 5f61 7072 6570 2028 5368 6973 6869  hi_aprep (Shishi
│ │ │ │ +000391b0: 202a 2048 414e 444c 4529 0a20 2020 2020   * HANDLE).     
│ │ │ │ +000391c0: 4841 4e44 4c45 3a20 7368 6973 6869 2068  HANDLE: shishi h
│ │ │ │ +000391d0: 616e 646c 6520 6173 2061 6c6c 6f63 6174  andle as allocat
│ │ │ │ +000391e0: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ +000391f0: 696e 6974 2829 e280 992e 0a0a 2020 2020  init()......    
│ │ │ │ +00039200: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ +00039210: 5468 6973 2066 756e 6374 696f 6e20 6372  This function cr
│ │ │ │ +00039220: 6561 7465 7320 6120 6e65 7720 4150 2d52  eates a new AP-R
│ │ │ │ +00039230: 4550 2c20 706f 7075 6c61 7465 6420 7769  EP, populated wi
│ │ │ │ +00039240: 7468 0a20 2020 2020 736f 6d65 2064 6566  th.     some def
│ │ │ │ +00039250: 6175 6c74 2076 616c 7565 732e 0a0a 2020  ault values...  
│ │ │ │ +00039260: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ +00039270: 3a2a 2052 6574 7572 6e73 2074 6865 2061  :* Returns the a
│ │ │ │ +00039280: 7574 6865 6e74 6963 6174 6f72 206f 7220  uthenticator or 
│ │ │ │ +00039290: 4e55 4c4c 206f 6e20 6661 696c 7572 652e  NULL on failure.
│ │ │ │ +000392a0: 0a0a 7368 6973 6869 5f61 7072 6570 5f70  ..shishi_aprep_p
│ │ │ │ +000392b0: 7269 6e74 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  rint.-----------
│ │ │ │ +000392c0: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +000392d0: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ +000392e0: 695f 6170 7265 705f 7072 696e 7420 2853  i_aprep_print (S
│ │ │ │ +000392f0: 6869 7368 6920 2a20 4841 4e44 4c45 2c20  hishi * HANDLE, 
│ │ │ │ +00039300: 4649 4c45 202a 2046 482c 0a20 2020 2020  FILE * FH,.     
│ │ │ │ +00039310: 2020 2020 2053 6869 7368 695f 6173 6e31       Shishi_asn1
│ │ │ │ +00039320: 2041 5052 4550 290a 2020 2020 2048 414e   APREP).     HAN
│ │ │ │ +00039330: 444c 453a 2073 6869 7368 6920 6861 6e64  DLE: shishi hand
│ │ │ │ +00039340: 6c65 2061 7320 616c 6c6f 6361 7465 6420  le as allocated 
│ │ │ │ +00039350: 6279 20e2 8098 7368 6973 6869 5f69 6e69  by ...shishi_ini
│ │ │ │ +00039360: 7428 29e2 8099 2e0a 2020 2020 2046 483a  t().....     FH:
│ │ │ │ +00039370: 2066 696c 6520 6861 6e64 6c65 206f 7065   file handle ope
│ │ │ │ +00039380: 6e20 666f 7220 7772 6974 696e 672e 0a20  n for writing.. 
│ │ │ │ +00039390: 2020 2020 4150 5245 503a 2041 502d 5245      APREP: AP-RE
│ │ │ │ +000393a0: 5020 746f 2070 7269 6e74 2e0a 0a20 2020  P to print...   
│ │ │ │ +000393b0: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ +000393c0: 2050 7269 6e74 2041 5343 4949 2061 726d   Print ASCII arm
│ │ │ │ +000393d0: 6f72 6564 2044 4552 2065 6e63 6f64 696e  ored DER encodin
│ │ │ │ +000393e0: 6720 6f66 2041 502d 5245 5020 746f 2066  g of AP-REP to f
│ │ │ │ +000393f0: 696c 652e 0a0a 2020 2020 202a 5265 7475  ile...     *Retu
│ │ │ │ +00039400: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ +00039410: 6e73 2053 4849 5348 495f 4f4b 2069 6666  ns SHISHI_OK iff
│ │ │ │ +00039420: 2073 7563 6365 7373 6675 6c2e 0a0a 7368   successful...sh
│ │ │ │ +00039430: 6973 6869 5f61 7072 6570 5f73 6176 650a  ishi_aprep_save.
│ │ │ │ +00039440: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +00039450: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ +00039460: 2069 6e74 2073 6869 7368 695f 6170 7265   int shishi_apre
│ │ │ │ +00039470: 705f 7361 7665 2028 5368 6973 6869 202a  p_save (Shishi *
│ │ │ │ +00039480: 2048 414e 444c 452c 2046 494c 4520 2a20   HANDLE, FILE * 
│ │ │ │ +00039490: 4648 2c0a 2020 2020 2020 2020 2020 5368  FH,.          Sh
│ │ │ │ +000394a0: 6973 6869 5f61 736e 3120 4150 5245 5029  ishi_asn1 APREP)
│ │ │ │ +000394b0: 0a20 2020 2020 4841 4e44 4c45 3a20 7368  .     HANDLE: sh
│ │ │ │ +000394c0: 6973 6869 2068 616e 646c 6520 6173 2061  ishi handle as a
│ │ │ │ +000394d0: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ +000394e0: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ +000394f0: 0a20 2020 2020 4648 3a20 6669 6c65 2068  .     FH: file h
│ │ │ │ +00039500: 616e 646c 6520 6f70 656e 2066 6f72 2077  andle open for w
│ │ │ │ +00039510: 7269 7469 6e67 2e0a 2020 2020 2041 5052  riting..     APR
│ │ │ │ +00039520: 4550 3a20 4150 2d52 4550 2074 6f20 7361  EP: AP-REP to sa
│ │ │ │ +00039530: 7665 2e0a 0a20 2020 2020 2a44 6573 6372  ve...     *Descr
│ │ │ │ +00039540: 6970 7469 6f6e 3a2a 2053 6176 6520 4445  iption:* Save DE
│ │ │ │ +00039550: 5220 656e 636f 6469 6e67 206f 6620 4150  R encoding of AP
│ │ │ │ +00039560: 2d52 4550 2074 6f20 6669 6c65 2e0a 0a20  -REP to file... 
│ │ │ │ +00039570: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ +00039580: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ +00039590: 4849 5f4f 4b20 6966 6620 7375 6363 6573  HI_OK iff succes
│ │ │ │ +000395a0: 7366 756c 2e0a 0a73 6869 7368 695f 6170  sful...shishi_ap
│ │ │ │ +000395b0: 7265 705f 746f 5f66 696c 650a 2d2d 2d2d  rep_to_file.----
│ │ │ │ +000395c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +000395d0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +000395e0: 696e 7420 7368 6973 6869 5f61 7072 6570  int shishi_aprep
│ │ │ │ +000395f0: 5f74 6f5f 6669 6c65 2028 5368 6973 6869  _to_file (Shishi
│ │ │ │ +00039600: 202a 2048 414e 444c 452c 0a20 2020 2020   * HANDLE,.     
│ │ │ │ +00039610: 2020 2020 2053 6869 7368 695f 6173 6e31       Shishi_asn1
│ │ │ │ +00039620: 2041 5052 4550 2c20 696e 7420 4649 4c45   APREP, int FILE
│ │ │ │ +00039630: 5459 5045 2c20 636f 6e73 7420 6368 6172  TYPE, const char
│ │ │ │ +00039640: 202a 2046 494c 454e 414d 4529 0a20 2020   * FILENAME).   
│ │ │ │ +00039650: 2020 4841 4e44 4c45 3a20 7368 6973 6869    HANDLE: shishi
│ │ │ │ +00039660: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ +00039670: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ +00039680: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ +00039690: 2020 4150 5245 503a 2041 502d 5245 5020    APREP: AP-REP 
│ │ │ │ +000396a0: 746f 2073 6176 652e 0a20 2020 2020 4649  to save..     FI
│ │ │ │ +000396b0: 4c45 5459 5045 3a20 696e 7075 7420 7661  LETYPE: input va
│ │ │ │ +000396c0: 7269 6162 6c65 2073 7065 6369 6679 696e  riable specifyin
│ │ │ │ +000396d0: 6720 7479 7065 206f 6620 6669 6c65 2074  g type of file t
│ │ │ │ +000396e0: 6f20 6265 2077 7269 7474 656e 2c20 7365  o be written, se
│ │ │ │ +000396f0: 650a 2020 2020 2053 6869 7368 695f 6669  e.     Shishi_fi
│ │ │ │ +00039700: 6c65 7479 7065 2e0a 2020 2020 2046 494c  letype..     FIL
│ │ │ │ +00039710: 454e 414d 453a 2069 6e70 7574 2076 6172  ENAME: input var
│ │ │ │ +00039720: 6961 626c 6520 7769 7468 2066 696c 656e  iable with filen
│ │ │ │ +00039730: 616d 6520 746f 2077 7269 7465 2074 6f2e  ame to write to.
│ │ │ │ +00039740: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ +00039750: 696f 6e3a 2a20 5772 6974 6520 4150 2d52  ion:* Write AP-R
│ │ │ │ +00039760: 4550 2074 6f20 6669 6c65 2069 6e20 7370  EP to file in sp
│ │ │ │ +00039770: 6563 6966 6965 6420 5459 5045 2e20 5468  ecified TYPE. Th
│ │ │ │ +00039780: 6520 6669 6c65 0a20 2020 2020 7769 6c6c  e file.     will
│ │ │ │ +00039790: 2062 6520 7472 756e 6361 7465 6420 6966   be truncated if
│ │ │ │ +000397a0: 2069 7420 6578 6973 7473 2e0a 0a20 2020   it exists...   
│ │ │ │ +000397b0: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ +000397c0: 2a20 5265 7475 726e 7320 5348 4953 4849  * Returns SHISHI
│ │ │ │ +000397d0: 5f4f 4b20 6966 6620 7375 6363 6573 7366  _OK iff successf
│ │ │ │ +000397e0: 756c 2e0a 0a73 6869 7368 695f 6170 7265  ul...shishi_apre
│ │ │ │ +000397f0: 705f 7061 7273 650a 2d2d 2d2d 2d2d 2d2d  p_parse.--------
│ │ │ │ +00039800: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +00039810: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ +00039820: 6973 6869 5f61 7072 6570 5f70 6172 7365  ishi_aprep_parse
│ │ │ │ +00039830: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ +00039840: 452c 2046 494c 4520 2a20 4648 2c0a 2020  E, FILE * FH,.  
│ │ │ │ +00039850: 2020 2020 2020 2020 5368 6973 6869 5f61          Shishi_a
│ │ │ │ +00039860: 736e 3120 2a20 4150 5245 5029 0a20 2020  sn1 * APREP).   
│ │ │ │ +00039870: 2020 4841 4e44 4c45 3a20 7368 6973 6869    HANDLE: shishi
│ │ │ │ +00039880: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ +00039890: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ +000398a0: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ +000398b0: 2020 4648 3a20 6669 6c65 2068 616e 646c    FH: file handl
│ │ │ │ +000398c0: 6520 6f70 656e 2066 6f72 2072 6561 6469  e open for readi
│ │ │ │ +000398d0: 6e67 2e0a 2020 2020 2041 5052 4550 3a20  ng..     APREP: 
│ │ │ │ +000398e0: 6f75 7470 7574 2076 6172 6961 626c 6520  output variable 
│ │ │ │ +000398f0: 7769 7468 206e 6577 6c79 2061 6c6c 6f63  with newly alloc
│ │ │ │ +00039900: 6174 6564 2041 502d 5245 502e 0a0a 2020  ated AP-REP...  
│ │ │ │ +00039910: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ +00039920: 2a20 5265 6164 2041 5343 4949 2061 726d  * Read ASCII arm
│ │ │ │ +00039930: 6f72 6564 2044 4552 2065 6e63 6f64 6564  ored DER encoded
│ │ │ │ +00039940: 2041 502d 5245 5020 6672 6f6d 2066 696c   AP-REP from fil
│ │ │ │ +00039950: 6520 616e 640a 2020 2020 2070 6f70 756c  e and.     popul
│ │ │ │ +00039960: 6174 6520 6769 7665 6e20 7661 7269 6162  ate given variab
│ │ │ │ +00039970: 6c65 2e0a 0a20 2020 2020 2a52 6574 7572  le...     *Retur
│ │ │ │ +00039980: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ +00039990: 7320 5348 4953 4849 5f4f 4b20 6966 6620  s SHISHI_OK iff 
│ │ │ │ +000399a0: 7375 6363 6573 7366 756c 2e0a 0a73 6869  successful...shi
│ │ │ │ +000399b0: 7368 695f 6170 7265 705f 7265 6164 0a2d  shi_aprep_read.-
│ │ │ │ +000399c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +000399d0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +000399e0: 696e 7420 7368 6973 6869 5f61 7072 6570  int shishi_aprep
│ │ │ │ +000399f0: 5f72 6561 6420 2853 6869 7368 6920 2a20  _read (Shishi * 
│ │ │ │ +00039a00: 4841 4e44 4c45 2c20 4649 4c45 202a 2046  HANDLE, FILE * F
│ │ │ │ +00039a10: 482c 0a20 2020 2020 2020 2020 2053 6869  H,.          Shi
│ │ │ │ +00039a20: 7368 695f 6173 6e31 202a 2041 5052 4550  shi_asn1 * APREP
│ │ │ │ +00039a30: 290a 2020 2020 2048 414e 444c 453a 2073  ).     HANDLE: s
│ │ │ │ +00039a40: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ +00039a50: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ +00039a60: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ +00039a70: 2e0a 2020 2020 2046 483a 2066 696c 6520  ..     FH: file 
│ │ │ │ +00039a80: 6861 6e64 6c65 206f 7065 6e20 666f 7220  handle open for 
│ │ │ │ +00039a90: 7265 6164 696e 672e 0a20 2020 2020 4150  reading..     AP
│ │ │ │ +00039aa0: 5245 503a 206f 7574 7075 7420 7661 7269  REP: output vari
│ │ │ │ +00039ab0: 6162 6c65 2077 6974 6820 6e65 776c 7920  able with newly 
│ │ │ │ +00039ac0: 616c 6c6f 6361 7465 6420 4150 2d52 4550  allocated AP-REP
│ │ │ │ +00039ad0: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ +00039ae0: 7469 6f6e 3a2a 2052 6561 6420 4445 5220  tion:* Read DER 
│ │ │ │ +00039af0: 656e 636f 6465 6420 4150 2d52 4550 2066  encoded AP-REP f
│ │ │ │ +00039b00: 726f 6d20 6669 6c65 2061 6e64 2070 6f70  rom file and pop
│ │ │ │ +00039b10: 756c 6174 6520 6769 7665 6e0a 2020 2020  ulate given.    
│ │ │ │ +00039b20: 2076 6172 6961 626c 652e 0a0a 2020 2020   variable...    
│ │ │ │ +00039b30: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ +00039b40: 2052 6574 7572 6e73 2053 4849 5348 495f   Returns SHISHI_
│ │ │ │ +00039b50: 4f4b 2069 6666 2073 7563 6365 7373 6675  OK iff successfu
│ │ │ │ +00039b60: 6c2e 0a0a 7368 6973 6869 5f61 7072 6570  l...shishi_aprep
│ │ │ │ +00039b70: 5f66 726f 6d5f 6669 6c65 0a2d 2d2d 2d2d  _from_file.-----
│ │ │ │ +00039b80: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +00039b90: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ +00039ba0: 2069 6e74 2073 6869 7368 695f 6170 7265   int shishi_apre
│ │ │ │ +00039bb0: 705f 6672 6f6d 5f66 696c 6520 2853 6869  p_from_file (Shi
│ │ │ │ +00039bc0: 7368 6920 2a20 4841 4e44 4c45 2c0a 2020  shi * HANDLE,.  
│ │ │ │ +00039bd0: 2020 2020 2020 2020 5368 6973 6869 5f61          Shishi_a
│ │ │ │ +00039be0: 736e 3120 2a20 4150 5245 502c 2069 6e74  sn1 * APREP, int
│ │ │ │ +00039bf0: 2046 494c 4554 5950 452c 2063 6f6e 7374   FILETYPE, const
│ │ │ │ +00039c00: 2063 6861 7220 2a20 4649 4c45 4e41 4d45   char * FILENAME
│ │ │ │ +00039c10: 290a 2020 2020 2048 414e 444c 453a 2073  ).     HANDLE: s
│ │ │ │ +00039c20: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ +00039c30: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ +00039c40: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ +00039c50: 2e0a 2020 2020 2041 5052 4550 3a20 6f75  ..     APREP: ou
│ │ │ │ +00039c60: 7470 7574 2076 6172 6961 626c 6520 7769  tput variable wi
│ │ │ │ +00039c70: 7468 206e 6577 6c79 2061 6c6c 6f63 6174  th newly allocat
│ │ │ │ +00039c80: 6564 2041 502d 5245 502e 0a20 2020 2020  ed AP-REP..     
│ │ │ │ +00039c90: 4649 4c45 5459 5045 3a20 696e 7075 7420  FILETYPE: input 
│ │ │ │ +00039ca0: 7661 7269 6162 6c65 2073 7065 6369 6679  variable specify
│ │ │ │ +00039cb0: 696e 6720 7479 7065 206f 6620 6669 6c65  ing type of file
│ │ │ │ +00039cc0: 2074 6f20 6265 2072 6561 642c 2073 6565   to be read, see
│ │ │ │ +00039cd0: 0a20 2020 2020 5368 6973 6869 5f66 696c  .     Shishi_fil
│ │ │ │ +00039ce0: 6574 7970 652e 0a20 2020 2020 4649 4c45  etype..     FILE
│ │ │ │ +00039cf0: 4e41 4d45 3a20 696e 7075 7420 7661 7269  NAME: input vari
│ │ │ │ +00039d00: 6162 6c65 2077 6974 6820 6669 6c65 6e61  able with filena
│ │ │ │ +00039d10: 6d65 2074 6f20 7265 6164 2066 726f 6d2e  me to read from.
│ │ │ │ +00039d20: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ +00039d30: 696f 6e3a 2a20 5265 6164 2041 502d 5245  ion:* Read AP-RE
│ │ │ │ +00039d40: 5020 6672 6f6d 2066 696c 6520 696e 2073  P from file in s
│ │ │ │ +00039d50: 7065 6369 6669 6564 2054 5950 452e 0a0a  pecified TYPE...
│ │ │ │ +00039d60: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ +00039d70: 7565 3a2a 2052 6574 7572 6e73 2053 4849  ue:* Returns SHI
│ │ │ │ +00039d80: 5348 495f 4f4b 2069 6666 2073 7563 6365  SHI_OK iff succe
│ │ │ │ +00039d90: 7373 6675 6c2e 0a0a 7368 6973 6869 5f61  ssful...shishi_a
│ │ │ │ +00039da0: 7072 6570 5f67 6574 5f65 6e63 5f70 6172  prep_get_enc_par
│ │ │ │ +00039db0: 745f 6574 7970 650a 2d2d 2d2d 2d2d 2d2d  t_etype.--------
│ │ │ │  00039dc0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00039dd0: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ -00039de0: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ -00039df0: 6170 7265 705f 6765 745f 656e 635f 7061  aprep_get_enc_pa
│ │ │ │ -00039e00: 7274 5f65 7479 7065 2028 5368 6973 6869  rt_etype (Shishi
│ │ │ │ -00039e10: 202a 2048 414e 444c 452c 0a20 2020 2020   * HANDLE,.     
│ │ │ │ -00039e20: 2020 2020 2053 6869 7368 695f 6173 6e31       Shishi_asn1
│ │ │ │ -00039e30: 2041 5052 4550 2c20 696e 7433 325f 7420   APREP, int32_t 
│ │ │ │ -00039e40: 2a20 4554 5950 4529 0a20 2020 2020 4841  * ETYPE).     HA
│ │ │ │ -00039e50: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ -00039e60: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ -00039e70: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ -00039e80: 6974 2829 e280 992e 0a20 2020 2020 4150  it().....     AP
│ │ │ │ -00039e90: 5245 503a 2041 502d 5245 5020 7661 7269  REP: AP-REP vari
│ │ │ │ -00039ea0: 6162 6c65 2074 6f20 6765 7420 7661 6c75  able to get valu
│ │ │ │ -00039eb0: 6520 6672 6f6d 2e0a 2020 2020 2045 5459  e from..     ETY
│ │ │ │ -00039ec0: 5045 3a20 6f75 7470 7574 2076 6172 6961  PE: output varia
│ │ │ │ -00039ed0: 626c 6520 7468 6174 2068 6f6c 6473 2074  ble that holds t
│ │ │ │ -00039ee0: 6865 2076 616c 7565 2e0a 0a20 2020 2020  he value...     
│ │ │ │ -00039ef0: 2a44 6573 6372 6970 7469 6f6e 3a2a 2045  *Description:* E
│ │ │ │ -00039f00: 7874 7261 6374 2041 502d 5245 502e 656e  xtract AP-REP.en
│ │ │ │ -00039f10: 632d 7061 7274 2e65 7479 7065 2e0a 0a20  c-part.etype... 
│ │ │ │ -00039f20: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ -00039f30: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ -00039f40: 4849 5f4f 4b20 6966 6620 7375 6363 6573  HI_OK iff succes
│ │ │ │ -00039f50: 7366 756c 2e0a 0a73 6869 7368 695f 656e  sful...shishi_en
│ │ │ │ -00039f60: 6361 7072 6570 7061 7274 0a2d 2d2d 2d2d  capreppart.-----
│ │ │ │ -00039f70: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -00039f80: 202d 2d20 4675 6e63 7469 6f6e 3a20 5368   -- Function: Sh
│ │ │ │ -00039f90: 6973 6869 5f61 736e 3120 7368 6973 6869  ishi_asn1 shishi
│ │ │ │ -00039fa0: 5f65 6e63 6170 7265 7070 6172 7420 2853  _encapreppart (S
│ │ │ │ -00039fb0: 6869 7368 6920 2a20 4841 4e44 4c45 290a  hishi * HANDLE).
│ │ │ │ -00039fc0: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ -00039fd0: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ -00039fe0: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ -00039ff0: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ -0003a000: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -0003a010: 6f6e 3a2a 2054 6869 7320 6675 6e63 7469  on:* This functi
│ │ │ │ -0003a020: 6f6e 2063 7265 6174 6573 2061 206e 6577  on creates a new
│ │ │ │ -0003a030: 2045 6e63 4150 5265 7050 6172 742c 2070   EncAPRepPart, p
│ │ │ │ -0003a040: 6f70 756c 6174 6564 0a20 2020 2020 7769  opulated.     wi
│ │ │ │ -0003a050: 7468 2073 6f6d 6520 6465 6661 756c 7420  th some default 
│ │ │ │ -0003a060: 7661 6c75 6573 2e20 2049 7420 7573 6573  values.  It uses
│ │ │ │ -0003a070: 2074 6865 2063 7572 7265 6e74 2074 696d   the current tim
│ │ │ │ -0003a080: 6520 6173 2072 6574 7572 6e65 6420 6279  e as returned by
│ │ │ │ -0003a090: 0a20 2020 2020 7468 6520 7379 7374 656d  .     the system
│ │ │ │ -0003a0a0: 2066 6f72 2074 6865 2063 7469 6d65 2061   for the ctime a
│ │ │ │ -0003a0b0: 6e64 2063 7573 6563 2066 6965 6c64 732e  nd cusec fields.
│ │ │ │ -0003a0c0: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ -0003a0d0: 616c 7565 3a2a 2052 6574 7572 6e73 2074  alue:* Returns t
│ │ │ │ -0003a0e0: 6865 2065 6e63 6170 7265 7070 6172 7420  he encapreppart 
│ │ │ │ -0003a0f0: 6f72 204e 554c 4c20 6f6e 2066 6169 6c75  or NULL on failu
│ │ │ │ -0003a100: 7265 2e0a 0a73 6869 7368 695f 656e 6361  re...shishi_enca
│ │ │ │ -0003a110: 7072 6570 7061 7274 5f70 7269 6e74 0a2d  preppart_print.-
│ │ │ │ -0003a120: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0003a130: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -0003a140: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ -0003a150: 6869 5f65 6e63 6170 7265 7070 6172 745f  hi_encapreppart_
│ │ │ │ -0003a160: 7072 696e 7420 2853 6869 7368 6920 2a20  print (Shishi * 
│ │ │ │ -0003a170: 4841 4e44 4c45 2c20 4649 4c45 202a 2046  HANDLE, FILE * F
│ │ │ │ -0003a180: 482c 0a20 2020 2020 2020 2020 2053 6869  H,.          Shi
│ │ │ │ -0003a190: 7368 695f 6173 6e31 2045 4e43 4150 5245  shi_asn1 ENCAPRE
│ │ │ │ -0003a1a0: 5050 4152 5429 0a20 2020 2020 4841 4e44  PPART).     HAND
│ │ │ │ -0003a1b0: 4c45 3a20 7368 6973 6869 2068 616e 646c  LE: shishi handl
│ │ │ │ -0003a1c0: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ -0003a1d0: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ -0003a1e0: 2829 e280 992e 0a20 2020 2020 4648 3a20  ().....     FH: 
│ │ │ │ -0003a1f0: 6669 6c65 2068 616e 646c 6520 6f70 656e  file handle open
│ │ │ │ -0003a200: 2066 6f72 2077 7269 7469 6e67 2e0a 2020   for writing..  
│ │ │ │ -0003a210: 2020 2045 4e43 4150 5245 5050 4152 543a     ENCAPREPPART:
│ │ │ │ -0003a220: 2045 6e63 4150 5265 7050 6172 7420 746f   EncAPRepPart to
│ │ │ │ -0003a230: 2070 7269 6e74 2e0a 0a20 2020 2020 2a44   print...     *D
│ │ │ │ -0003a240: 6573 6372 6970 7469 6f6e 3a2a 2050 7269  escription:* Pri
│ │ │ │ -0003a250: 6e74 2041 5343 4949 2061 726d 6f72 6564  nt ASCII armored
│ │ │ │ -0003a260: 2044 4552 2065 6e63 6f64 696e 6720 6f66   DER encoding of
│ │ │ │ -0003a270: 2045 6e63 4150 5265 7050 6172 7420 746f   EncAPRepPart to
│ │ │ │ -0003a280: 0a20 2020 2020 6669 6c65 2e0a 0a20 2020  .     file...   
│ │ │ │ -0003a290: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ -0003a2a0: 2a20 5265 7475 726e 7320 5348 4953 4849  * Returns SHISHI
│ │ │ │ -0003a2b0: 5f4f 4b20 6966 6620 7375 6363 6573 7366  _OK iff successf
│ │ │ │ -0003a2c0: 756c 2e0a 0a73 6869 7368 695f 656e 6361  ul...shishi_enca
│ │ │ │ -0003a2d0: 7072 6570 7061 7274 5f73 6176 650a 2d2d  preppart_save.--
│ │ │ │ +00039dd0: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +00039de0: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ +00039df0: 695f 6170 7265 705f 6765 745f 656e 635f  i_aprep_get_enc_
│ │ │ │ +00039e00: 7061 7274 5f65 7479 7065 2028 5368 6973  part_etype (Shis
│ │ │ │ +00039e10: 6869 202a 2048 414e 444c 452c 0a20 2020  hi * HANDLE,.   
│ │ │ │ +00039e20: 2020 2020 2020 2053 6869 7368 695f 6173         Shishi_as
│ │ │ │ +00039e30: 6e31 2041 5052 4550 2c20 696e 7433 325f  n1 APREP, int32_
│ │ │ │ +00039e40: 7420 2a20 4554 5950 4529 0a20 2020 2020  t * ETYPE).     
│ │ │ │ +00039e50: 4841 4e44 4c45 3a20 7368 6973 6869 2068  HANDLE: shishi h
│ │ │ │ +00039e60: 616e 646c 6520 6173 2061 6c6c 6f63 6174  andle as allocat
│ │ │ │ +00039e70: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ +00039e80: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ +00039e90: 4150 5245 503a 2041 502d 5245 5020 7661  APREP: AP-REP va
│ │ │ │ +00039ea0: 7269 6162 6c65 2074 6f20 6765 7420 7661  riable to get va
│ │ │ │ +00039eb0: 6c75 6520 6672 6f6d 2e0a 2020 2020 2045  lue from..     E
│ │ │ │ +00039ec0: 5459 5045 3a20 6f75 7470 7574 2076 6172  TYPE: output var
│ │ │ │ +00039ed0: 6961 626c 6520 7468 6174 2068 6f6c 6473  iable that holds
│ │ │ │ +00039ee0: 2074 6865 2076 616c 7565 2e0a 0a20 2020   the value...   
│ │ │ │ +00039ef0: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ +00039f00: 2045 7874 7261 6374 2041 502d 5245 502e   Extract AP-REP.
│ │ │ │ +00039f10: 656e 632d 7061 7274 2e65 7479 7065 2e0a  enc-part.etype..
│ │ │ │ +00039f20: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ +00039f30: 6c75 653a 2a20 5265 7475 726e 7320 5348  lue:* Returns SH
│ │ │ │ +00039f40: 4953 4849 5f4f 4b20 6966 6620 7375 6363  ISHI_OK iff succ
│ │ │ │ +00039f50: 6573 7366 756c 2e0a 0a73 6869 7368 695f  essful...shishi_
│ │ │ │ +00039f60: 656e 6361 7072 6570 7061 7274 0a2d 2d2d  encapreppart.---
│ │ │ │ +00039f70: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +00039f80: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +00039f90: 5368 6973 6869 5f61 736e 3120 7368 6973  Shishi_asn1 shis
│ │ │ │ +00039fa0: 6869 5f65 6e63 6170 7265 7070 6172 7420  hi_encapreppart 
│ │ │ │ +00039fb0: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ +00039fc0: 290a 2020 2020 2048 414e 444c 453a 2073  ).     HANDLE: s
│ │ │ │ +00039fd0: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ +00039fe0: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ +00039ff0: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ +0003a000: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ +0003a010: 7469 6f6e 3a2a 2054 6869 7320 6675 6e63  tion:* This func
│ │ │ │ +0003a020: 7469 6f6e 2063 7265 6174 6573 2061 206e  tion creates a n
│ │ │ │ +0003a030: 6577 2045 6e63 4150 5265 7050 6172 742c  ew EncAPRepPart,
│ │ │ │ +0003a040: 2070 6f70 756c 6174 6564 0a20 2020 2020   populated.     
│ │ │ │ +0003a050: 7769 7468 2073 6f6d 6520 6465 6661 756c  with some defaul
│ │ │ │ +0003a060: 7420 7661 6c75 6573 2e20 2049 7420 7573  t values.  It us
│ │ │ │ +0003a070: 6573 2074 6865 2063 7572 7265 6e74 2074  es the current t
│ │ │ │ +0003a080: 696d 6520 6173 2072 6574 7572 6e65 6420  ime as returned 
│ │ │ │ +0003a090: 6279 0a20 2020 2020 7468 6520 7379 7374  by.     the syst
│ │ │ │ +0003a0a0: 656d 2066 6f72 2074 6865 2063 7469 6d65  em for the ctime
│ │ │ │ +0003a0b0: 2061 6e64 2063 7573 6563 2066 6965 6c64   and cusec field
│ │ │ │ +0003a0c0: 732e 0a0a 2020 2020 202a 5265 7475 726e  s...     *Return
│ │ │ │ +0003a0d0: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ +0003a0e0: 2074 6865 2065 6e63 6170 7265 7070 6172   the encapreppar
│ │ │ │ +0003a0f0: 7420 6f72 204e 554c 4c20 6f6e 2066 6169  t or NULL on fai
│ │ │ │ +0003a100: 6c75 7265 2e0a 0a73 6869 7368 695f 656e  lure...shishi_en
│ │ │ │ +0003a110: 6361 7072 6570 7061 7274 5f70 7269 6e74  capreppart_print
│ │ │ │ +0003a120: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ +0003a130: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +0003a140: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ +0003a150: 6973 6869 5f65 6e63 6170 7265 7070 6172  ishi_encapreppar
│ │ │ │ +0003a160: 745f 7072 696e 7420 2853 6869 7368 6920  t_print (Shishi 
│ │ │ │ +0003a170: 2a20 4841 4e44 4c45 2c20 4649 4c45 202a  * HANDLE, FILE *
│ │ │ │ +0003a180: 2046 482c 0a20 2020 2020 2020 2020 2053   FH,.          S
│ │ │ │ +0003a190: 6869 7368 695f 6173 6e31 2045 4e43 4150  hishi_asn1 ENCAP
│ │ │ │ +0003a1a0: 5245 5050 4152 5429 0a20 2020 2020 4841  REPPART).     HA
│ │ │ │ +0003a1b0: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ +0003a1c0: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ +0003a1d0: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ +0003a1e0: 6974 2829 e280 992e 0a20 2020 2020 4648  it().....     FH
│ │ │ │ +0003a1f0: 3a20 6669 6c65 2068 616e 646c 6520 6f70  : file handle op
│ │ │ │ +0003a200: 656e 2066 6f72 2077 7269 7469 6e67 2e0a  en for writing..
│ │ │ │ +0003a210: 2020 2020 2045 4e43 4150 5245 5050 4152       ENCAPREPPAR
│ │ │ │ +0003a220: 543a 2045 6e63 4150 5265 7050 6172 7420  T: EncAPRepPart 
│ │ │ │ +0003a230: 746f 2070 7269 6e74 2e0a 0a20 2020 2020  to print...     
│ │ │ │ +0003a240: 2a44 6573 6372 6970 7469 6f6e 3a2a 2050  *Description:* P
│ │ │ │ +0003a250: 7269 6e74 2041 5343 4949 2061 726d 6f72  rint ASCII armor
│ │ │ │ +0003a260: 6564 2044 4552 2065 6e63 6f64 696e 6720  ed DER encoding 
│ │ │ │ +0003a270: 6f66 2045 6e63 4150 5265 7050 6172 7420  of EncAPRepPart 
│ │ │ │ +0003a280: 746f 0a20 2020 2020 6669 6c65 2e0a 0a20  to.     file... 
│ │ │ │ +0003a290: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ +0003a2a0: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ +0003a2b0: 4849 5f4f 4b20 6966 6620 7375 6363 6573  HI_OK iff succes
│ │ │ │ +0003a2c0: 7366 756c 2e0a 0a73 6869 7368 695f 656e  sful...shishi_en
│ │ │ │ +0003a2d0: 6361 7072 6570 7061 7274 5f73 6176 650a  capreppart_save.
│ │ │ │  0003a2e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0003a2f0: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ -0003a300: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ -0003a310: 5f65 6e63 6170 7265 7070 6172 745f 7361  _encapreppart_sa
│ │ │ │ -0003a320: 7665 2028 5368 6973 6869 202a 2048 414e  ve (Shishi * HAN
│ │ │ │ -0003a330: 444c 452c 2046 494c 4520 2a20 4648 2c0a  DLE, FILE * FH,.
│ │ │ │ -0003a340: 2020 2020 2020 2020 2020 5368 6973 6869            Shishi
│ │ │ │ -0003a350: 5f61 736e 3120 454e 4341 5052 4550 5041  _asn1 ENCAPREPPA
│ │ │ │ -0003a360: 5254 290a 2020 2020 2048 414e 444c 453a  RT).     HANDLE:
│ │ │ │ -0003a370: 2073 6869 7368 6920 6861 6e64 6c65 2061   shishi handle a
│ │ │ │ -0003a380: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ -0003a390: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ -0003a3a0: 8099 2e0a 2020 2020 2046 483a 2066 696c  ....     FH: fil
│ │ │ │ -0003a3b0: 6520 6861 6e64 6c65 206f 7065 6e20 666f  e handle open fo
│ │ │ │ -0003a3c0: 7220 7772 6974 696e 672e 0a20 2020 2020  r writing..     
│ │ │ │ -0003a3d0: 454e 4341 5052 4550 5041 5254 3a20 456e  ENCAPREPPART: En
│ │ │ │ -0003a3e0: 6341 5052 6570 5061 7274 2074 6f20 7361  cAPRepPart to sa
│ │ │ │ -0003a3f0: 7665 2e0a 0a20 2020 2020 2a44 6573 6372  ve...     *Descr
│ │ │ │ -0003a400: 6970 7469 6f6e 3a2a 2053 6176 6520 4445  iption:* Save DE
│ │ │ │ -0003a410: 5220 656e 636f 6469 6e67 206f 6620 456e  R encoding of En
│ │ │ │ -0003a420: 6341 5052 6570 5061 7274 2074 6f20 6669  cAPRepPart to fi
│ │ │ │ -0003a430: 6c65 2e0a 0a20 2020 2020 2a52 6574 7572  le...     *Retur
│ │ │ │ -0003a440: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ -0003a450: 7320 5348 4953 4849 5f4f 4b20 6966 6620  s SHISHI_OK iff 
│ │ │ │ -0003a460: 7375 6363 6573 7366 756c 2e0a 0a73 6869  successful...shi
│ │ │ │ -0003a470: 7368 695f 656e 6361 7072 6570 7061 7274  shi_encapreppart
│ │ │ │ -0003a480: 5f74 6f5f 6669 6c65 0a2d 2d2d 2d2d 2d2d  _to_file.-------
│ │ │ │ +0003a2f0: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ +0003a300: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ +0003a310: 6869 5f65 6e63 6170 7265 7070 6172 745f  hi_encapreppart_
│ │ │ │ +0003a320: 7361 7665 2028 5368 6973 6869 202a 2048  save (Shishi * H
│ │ │ │ +0003a330: 414e 444c 452c 2046 494c 4520 2a20 4648  ANDLE, FILE * FH
│ │ │ │ +0003a340: 2c0a 2020 2020 2020 2020 2020 5368 6973  ,.          Shis
│ │ │ │ +0003a350: 6869 5f61 736e 3120 454e 4341 5052 4550  hi_asn1 ENCAPREP
│ │ │ │ +0003a360: 5041 5254 290a 2020 2020 2048 414e 444c  PART).     HANDL
│ │ │ │ +0003a370: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ +0003a380: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ +0003a390: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ +0003a3a0: 29e2 8099 2e0a 2020 2020 2046 483a 2066  ).....     FH: f
│ │ │ │ +0003a3b0: 696c 6520 6861 6e64 6c65 206f 7065 6e20  ile handle open 
│ │ │ │ +0003a3c0: 666f 7220 7772 6974 696e 672e 0a20 2020  for writing..   
│ │ │ │ +0003a3d0: 2020 454e 4341 5052 4550 5041 5254 3a20    ENCAPREPPART: 
│ │ │ │ +0003a3e0: 456e 6341 5052 6570 5061 7274 2074 6f20  EncAPRepPart to 
│ │ │ │ +0003a3f0: 7361 7665 2e0a 0a20 2020 2020 2a44 6573  save...     *Des
│ │ │ │ +0003a400: 6372 6970 7469 6f6e 3a2a 2053 6176 6520  cription:* Save 
│ │ │ │ +0003a410: 4445 5220 656e 636f 6469 6e67 206f 6620  DER encoding of 
│ │ │ │ +0003a420: 456e 6341 5052 6570 5061 7274 2074 6f20  EncAPRepPart to 
│ │ │ │ +0003a430: 6669 6c65 2e0a 0a20 2020 2020 2a52 6574  file...     *Ret
│ │ │ │ +0003a440: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ +0003a450: 726e 7320 5348 4953 4849 5f4f 4b20 6966  rns SHISHI_OK if
│ │ │ │ +0003a460: 6620 7375 6363 6573 7366 756c 2e0a 0a73  f successful...s
│ │ │ │ +0003a470: 6869 7368 695f 656e 6361 7072 6570 7061  hishi_encapreppa
│ │ │ │ +0003a480: 7274 5f74 6f5f 6669 6c65 0a2d 2d2d 2d2d  rt_to_file.-----
│ │ │ │  0003a490: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0003a4a0: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -0003a4b0: 6f6e 3a20 696e 7420 7368 6973 6869 5f65  on: int shishi_e
│ │ │ │ -0003a4c0: 6e63 6170 7265 7070 6172 745f 746f 5f66  ncapreppart_to_f
│ │ │ │ -0003a4d0: 696c 6520 2853 6869 7368 6920 2a20 4841  ile (Shishi * HA
│ │ │ │ -0003a4e0: 4e44 4c45 2c0a 2020 2020 2020 2020 2020  NDLE,.          
│ │ │ │ -0003a4f0: 5368 6973 6869 5f61 736e 3120 454e 4341  Shishi_asn1 ENCA
│ │ │ │ -0003a500: 5052 4550 5041 5254 2c20 696e 7420 4649  PREPPART, int FI
│ │ │ │ -0003a510: 4c45 5459 5045 2c20 636f 6e73 7420 6368  LETYPE, const ch
│ │ │ │ -0003a520: 6172 202a 2046 494c 454e 414d 4529 0a20  ar * FILENAME). 
│ │ │ │ -0003a530: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ -0003a540: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ -0003a550: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ -0003a560: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ -0003a570: 2020 2020 454e 4341 5052 4550 5041 5254      ENCAPREPPART
│ │ │ │ -0003a580: 3a20 456e 6341 5052 6570 5061 7274 2074  : EncAPRepPart t
│ │ │ │ -0003a590: 6f20 7361 7665 2e0a 2020 2020 2046 494c  o save..     FIL
│ │ │ │ -0003a5a0: 4554 5950 453a 2069 6e70 7574 2076 6172  ETYPE: input var
│ │ │ │ -0003a5b0: 6961 626c 6520 7370 6563 6966 7969 6e67  iable specifying
│ │ │ │ -0003a5c0: 2074 7970 6520 6f66 2066 696c 6520 746f   type of file to
│ │ │ │ -0003a5d0: 2062 6520 7772 6974 7465 6e2c 2073 6565   be written, see
│ │ │ │ -0003a5e0: 0a20 2020 2020 5368 6973 6869 5f66 696c  .     Shishi_fil
│ │ │ │ -0003a5f0: 6574 7970 652e 0a20 2020 2020 4649 4c45  etype..     FILE
│ │ │ │ -0003a600: 4e41 4d45 3a20 696e 7075 7420 7661 7269  NAME: input vari
│ │ │ │ -0003a610: 6162 6c65 2077 6974 6820 6669 6c65 6e61  able with filena
│ │ │ │ -0003a620: 6d65 2074 6f20 7772 6974 6520 746f 2e0a  me to write to..
│ │ │ │ -0003a630: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -0003a640: 6f6e 3a2a 2057 7269 7465 2045 6e63 4150  on:* Write EncAP
│ │ │ │ -0003a650: 5265 7050 6172 7420 746f 2066 696c 6520  RepPart to file 
│ │ │ │ -0003a660: 696e 2073 7065 6369 6669 6564 2054 5950  in specified TYP
│ │ │ │ -0003a670: 452e 2054 6865 0a20 2020 2020 6669 6c65  E. The.     file
│ │ │ │ -0003a680: 2077 696c 6c20 6265 2074 7275 6e63 6174   will be truncat
│ │ │ │ -0003a690: 6564 2069 6620 6974 2065 7869 7374 732e  ed if it exists.
│ │ │ │ -0003a6a0: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ -0003a6b0: 616c 7565 3a2a 2052 6574 7572 6e73 2053  alue:* Returns S
│ │ │ │ -0003a6c0: 4849 5348 495f 4f4b 2069 6666 2073 7563  HISHI_OK iff suc
│ │ │ │ -0003a6d0: 6365 7373 6675 6c2e 0a0a 7368 6973 6869  cessful...shishi
│ │ │ │ -0003a6e0: 5f65 6e63 6170 7265 7070 6172 745f 7061  _encapreppart_pa
│ │ │ │ -0003a6f0: 7273 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  rse.------------
│ │ │ │ -0003a700: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -0003a710: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ -0003a720: 2073 6869 7368 695f 656e 6361 7072 6570   shishi_encaprep
│ │ │ │ -0003a730: 7061 7274 5f70 6172 7365 2028 5368 6973  part_parse (Shis
│ │ │ │ -0003a740: 6869 202a 2048 414e 444c 452c 2046 494c  hi * HANDLE, FIL
│ │ │ │ -0003a750: 4520 2a20 4648 2c0a 2020 2020 2020 2020  E * FH,.        
│ │ │ │ -0003a760: 2020 5368 6973 6869 5f61 736e 3120 2a20    Shishi_asn1 * 
│ │ │ │ -0003a770: 454e 4341 5052 4550 5041 5254 290a 2020  ENCAPREPPART).  
│ │ │ │ -0003a780: 2020 2048 414e 444c 453a 2073 6869 7368     HANDLE: shish
│ │ │ │ -0003a790: 6920 6861 6e64 6c65 2061 7320 616c 6c6f  i handle as allo
│ │ │ │ -0003a7a0: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ -0003a7b0: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ -0003a7c0: 2020 2046 483a 2066 696c 6520 6861 6e64     FH: file hand
│ │ │ │ -0003a7d0: 6c65 206f 7065 6e20 666f 7220 7265 6164  le open for read
│ │ │ │ -0003a7e0: 696e 672e 0a20 2020 2020 454e 4341 5052  ing..     ENCAPR
│ │ │ │ -0003a7f0: 4550 5041 5254 3a20 6f75 7470 7574 2076  EPPART: output v
│ │ │ │ -0003a800: 6172 6961 626c 6520 7769 7468 206e 6577  ariable with new
│ │ │ │ -0003a810: 6c79 2061 6c6c 6f63 6174 6564 2045 6e63  ly allocated Enc
│ │ │ │ -0003a820: 4150 5265 7050 6172 742e 0a0a 2020 2020  APRepPart...    
│ │ │ │ -0003a830: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ -0003a840: 5265 6164 2041 5343 4949 2061 726d 6f72  Read ASCII armor
│ │ │ │ -0003a850: 6564 2044 4552 2065 6e63 6f64 6564 2045  ed DER encoded E
│ │ │ │ -0003a860: 6e63 4150 5265 7050 6172 7420 6672 6f6d  ncAPRepPart from
│ │ │ │ -0003a870: 0a20 2020 2020 6669 6c65 2061 6e64 2070  .     file and p
│ │ │ │ -0003a880: 6f70 756c 6174 6520 6769 7665 6e20 7661  opulate given va
│ │ │ │ -0003a890: 7269 6162 6c65 2e0a 0a20 2020 2020 2a52  riable...     *R
│ │ │ │ -0003a8a0: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ -0003a8b0: 7475 726e 7320 5348 4953 4849 5f4f 4b20  turns SHISHI_OK 
│ │ │ │ -0003a8c0: 6966 6620 7375 6363 6573 7366 756c 2e0a  iff successful..
│ │ │ │ -0003a8d0: 0a73 6869 7368 695f 656e 6361 7072 6570  .shishi_encaprep
│ │ │ │ -0003a8e0: 7061 7274 5f72 6561 640a 2d2d 2d2d 2d2d  part_read.------
│ │ │ │ +0003a4a0: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ +0003a4b0: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ +0003a4c0: 5f65 6e63 6170 7265 7070 6172 745f 746f  _encapreppart_to
│ │ │ │ +0003a4d0: 5f66 696c 6520 2853 6869 7368 6920 2a20  _file (Shishi * 
│ │ │ │ +0003a4e0: 4841 4e44 4c45 2c0a 2020 2020 2020 2020  HANDLE,.        
│ │ │ │ +0003a4f0: 2020 5368 6973 6869 5f61 736e 3120 454e    Shishi_asn1 EN
│ │ │ │ +0003a500: 4341 5052 4550 5041 5254 2c20 696e 7420  CAPREPPART, int 
│ │ │ │ +0003a510: 4649 4c45 5459 5045 2c20 636f 6e73 7420  FILETYPE, const 
│ │ │ │ +0003a520: 6368 6172 202a 2046 494c 454e 414d 4529  char * FILENAME)
│ │ │ │ +0003a530: 0a20 2020 2020 4841 4e44 4c45 3a20 7368  .     HANDLE: sh
│ │ │ │ +0003a540: 6973 6869 2068 616e 646c 6520 6173 2061  ishi handle as a
│ │ │ │ +0003a550: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ +0003a560: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ +0003a570: 0a20 2020 2020 454e 4341 5052 4550 5041  .     ENCAPREPPA
│ │ │ │ +0003a580: 5254 3a20 456e 6341 5052 6570 5061 7274  RT: EncAPRepPart
│ │ │ │ +0003a590: 2074 6f20 7361 7665 2e0a 2020 2020 2046   to save..     F
│ │ │ │ +0003a5a0: 494c 4554 5950 453a 2069 6e70 7574 2076  ILETYPE: input v
│ │ │ │ +0003a5b0: 6172 6961 626c 6520 7370 6563 6966 7969  ariable specifyi
│ │ │ │ +0003a5c0: 6e67 2074 7970 6520 6f66 2066 696c 6520  ng type of file 
│ │ │ │ +0003a5d0: 746f 2062 6520 7772 6974 7465 6e2c 2073  to be written, s
│ │ │ │ +0003a5e0: 6565 0a20 2020 2020 5368 6973 6869 5f66  ee.     Shishi_f
│ │ │ │ +0003a5f0: 696c 6574 7970 652e 0a20 2020 2020 4649  iletype..     FI
│ │ │ │ +0003a600: 4c45 4e41 4d45 3a20 696e 7075 7420 7661  LENAME: input va
│ │ │ │ +0003a610: 7269 6162 6c65 2077 6974 6820 6669 6c65  riable with file
│ │ │ │ +0003a620: 6e61 6d65 2074 6f20 7772 6974 6520 746f  name to write to
│ │ │ │ +0003a630: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ +0003a640: 7469 6f6e 3a2a 2057 7269 7465 2045 6e63  tion:* Write Enc
│ │ │ │ +0003a650: 4150 5265 7050 6172 7420 746f 2066 696c  APRepPart to fil
│ │ │ │ +0003a660: 6520 696e 2073 7065 6369 6669 6564 2054  e in specified T
│ │ │ │ +0003a670: 5950 452e 2054 6865 0a20 2020 2020 6669  YPE. The.     fi
│ │ │ │ +0003a680: 6c65 2077 696c 6c20 6265 2074 7275 6e63  le will be trunc
│ │ │ │ +0003a690: 6174 6564 2069 6620 6974 2065 7869 7374  ated if it exist
│ │ │ │ +0003a6a0: 732e 0a0a 2020 2020 202a 5265 7475 726e  s...     *Return
│ │ │ │ +0003a6b0: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ +0003a6c0: 2053 4849 5348 495f 4f4b 2069 6666 2073   SHISHI_OK iff s
│ │ │ │ +0003a6d0: 7563 6365 7373 6675 6c2e 0a0a 7368 6973  uccessful...shis
│ │ │ │ +0003a6e0: 6869 5f65 6e63 6170 7265 7070 6172 745f  hi_encapreppart_
│ │ │ │ +0003a6f0: 7061 7273 650a 2d2d 2d2d 2d2d 2d2d 2d2d  parse.----------
│ │ │ │ +0003a700: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +0003a710: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ +0003a720: 6e74 2073 6869 7368 695f 656e 6361 7072  nt shishi_encapr
│ │ │ │ +0003a730: 6570 7061 7274 5f70 6172 7365 2028 5368  eppart_parse (Sh
│ │ │ │ +0003a740: 6973 6869 202a 2048 414e 444c 452c 2046  ishi * HANDLE, F
│ │ │ │ +0003a750: 494c 4520 2a20 4648 2c0a 2020 2020 2020  ILE * FH,.      
│ │ │ │ +0003a760: 2020 2020 5368 6973 6869 5f61 736e 3120      Shishi_asn1 
│ │ │ │ +0003a770: 2a20 454e 4341 5052 4550 5041 5254 290a  * ENCAPREPPART).
│ │ │ │ +0003a780: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ +0003a790: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ +0003a7a0: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ +0003a7b0: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ +0003a7c0: 2020 2020 2046 483a 2066 696c 6520 6861       FH: file ha
│ │ │ │ +0003a7d0: 6e64 6c65 206f 7065 6e20 666f 7220 7265  ndle open for re
│ │ │ │ +0003a7e0: 6164 696e 672e 0a20 2020 2020 454e 4341  ading..     ENCA
│ │ │ │ +0003a7f0: 5052 4550 5041 5254 3a20 6f75 7470 7574  PREPPART: output
│ │ │ │ +0003a800: 2076 6172 6961 626c 6520 7769 7468 206e   variable with n
│ │ │ │ +0003a810: 6577 6c79 2061 6c6c 6f63 6174 6564 2045  ewly allocated E
│ │ │ │ +0003a820: 6e63 4150 5265 7050 6172 742e 0a0a 2020  ncAPRepPart...  
│ │ │ │ +0003a830: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ +0003a840: 2a20 5265 6164 2041 5343 4949 2061 726d  * Read ASCII arm
│ │ │ │ +0003a850: 6f72 6564 2044 4552 2065 6e63 6f64 6564  ored DER encoded
│ │ │ │ +0003a860: 2045 6e63 4150 5265 7050 6172 7420 6672   EncAPRepPart fr
│ │ │ │ +0003a870: 6f6d 0a20 2020 2020 6669 6c65 2061 6e64  om.     file and
│ │ │ │ +0003a880: 2070 6f70 756c 6174 6520 6769 7665 6e20   populate given 
│ │ │ │ +0003a890: 7661 7269 6162 6c65 2e0a 0a20 2020 2020  variable...     
│ │ │ │ +0003a8a0: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ +0003a8b0: 5265 7475 726e 7320 5348 4953 4849 5f4f  Returns SHISHI_O
│ │ │ │ +0003a8c0: 4b20 6966 6620 7375 6363 6573 7366 756c  K iff successful
│ │ │ │ +0003a8d0: 2e0a 0a73 6869 7368 695f 656e 6361 7072  ...shishi_encapr
│ │ │ │ +0003a8e0: 6570 7061 7274 5f72 6561 640a 2d2d 2d2d  eppart_read.----
│ │ │ │  0003a8f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0003a900: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ -0003a910: 3a20 696e 7420 7368 6973 6869 5f65 6e63  : int shishi_enc
│ │ │ │ -0003a920: 6170 7265 7070 6172 745f 7265 6164 2028  apreppart_read (
│ │ │ │ -0003a930: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ -0003a940: 2046 494c 4520 2a20 4648 2c0a 2020 2020   FILE * FH,.    
│ │ │ │ -0003a950: 2020 2020 2020 5368 6973 6869 5f61 736e        Shishi_asn
│ │ │ │ -0003a960: 3120 2a20 454e 4341 5052 4550 5041 5254  1 * ENCAPREPPART
│ │ │ │ -0003a970: 290a 2020 2020 2048 414e 444c 453a 2073  ).     HANDLE: s
│ │ │ │ -0003a980: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ -0003a990: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ -0003a9a0: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ -0003a9b0: 2e0a 2020 2020 2046 483a 2066 696c 6520  ..     FH: file 
│ │ │ │ -0003a9c0: 6861 6e64 6c65 206f 7065 6e20 666f 7220  handle open for 
│ │ │ │ -0003a9d0: 7265 6164 696e 672e 0a20 2020 2020 454e  reading..     EN
│ │ │ │ -0003a9e0: 4341 5052 4550 5041 5254 3a20 6f75 7470  CAPREPPART: outp
│ │ │ │ -0003a9f0: 7574 2076 6172 6961 626c 6520 7769 7468  ut variable with
│ │ │ │ -0003aa00: 206e 6577 6c79 2061 6c6c 6f63 6174 6564   newly allocated
│ │ │ │ -0003aa10: 2045 6e63 4150 5265 7050 6172 742e 0a0a   EncAPRepPart...
│ │ │ │ -0003aa20: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ -0003aa30: 6e3a 2a20 5265 6164 2044 4552 2065 6e63  n:* Read DER enc
│ │ │ │ -0003aa40: 6f64 6564 2045 6e63 4150 5265 7050 6172  oded EncAPRepPar
│ │ │ │ -0003aa50: 7420 6672 6f6d 2066 696c 6520 616e 6420  t from file and 
│ │ │ │ -0003aa60: 706f 7075 6c61 7465 0a20 2020 2020 6769  populate.     gi
│ │ │ │ -0003aa70: 7665 6e20 7661 7269 6162 6c65 2e0a 0a20  ven variable... 
│ │ │ │ -0003aa80: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ -0003aa90: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ -0003aaa0: 4849 5f4f 4b20 6966 6620 7375 6363 6573  HI_OK iff succes
│ │ │ │ -0003aab0: 7366 756c 2e0a 0a73 6869 7368 695f 656e  sful...shishi_en
│ │ │ │ -0003aac0: 6361 7072 6570 7061 7274 5f66 726f 6d5f  capreppart_from_
│ │ │ │ -0003aad0: 6669 6c65 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  file.-----------
│ │ │ │ +0003a900: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ +0003a910: 6f6e 3a20 696e 7420 7368 6973 6869 5f65  on: int shishi_e
│ │ │ │ +0003a920: 6e63 6170 7265 7070 6172 745f 7265 6164  ncapreppart_read
│ │ │ │ +0003a930: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ +0003a940: 452c 2046 494c 4520 2a20 4648 2c0a 2020  E, FILE * FH,.  
│ │ │ │ +0003a950: 2020 2020 2020 2020 5368 6973 6869 5f61          Shishi_a
│ │ │ │ +0003a960: 736e 3120 2a20 454e 4341 5052 4550 5041  sn1 * ENCAPREPPA
│ │ │ │ +0003a970: 5254 290a 2020 2020 2048 414e 444c 453a  RT).     HANDLE:
│ │ │ │ +0003a980: 2073 6869 7368 6920 6861 6e64 6c65 2061   shishi handle a
│ │ │ │ +0003a990: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ +0003a9a0: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ +0003a9b0: 8099 2e0a 2020 2020 2046 483a 2066 696c  ....     FH: fil
│ │ │ │ +0003a9c0: 6520 6861 6e64 6c65 206f 7065 6e20 666f  e handle open fo
│ │ │ │ +0003a9d0: 7220 7265 6164 696e 672e 0a20 2020 2020  r reading..     
│ │ │ │ +0003a9e0: 454e 4341 5052 4550 5041 5254 3a20 6f75  ENCAPREPPART: ou
│ │ │ │ +0003a9f0: 7470 7574 2076 6172 6961 626c 6520 7769  tput variable wi
│ │ │ │ +0003aa00: 7468 206e 6577 6c79 2061 6c6c 6f63 6174  th newly allocat
│ │ │ │ +0003aa10: 6564 2045 6e63 4150 5265 7050 6172 742e  ed EncAPRepPart.
│ │ │ │ +0003aa20: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ +0003aa30: 696f 6e3a 2a20 5265 6164 2044 4552 2065  ion:* Read DER e
│ │ │ │ +0003aa40: 6e63 6f64 6564 2045 6e63 4150 5265 7050  ncoded EncAPRepP
│ │ │ │ +0003aa50: 6172 7420 6672 6f6d 2066 696c 6520 616e  art from file an
│ │ │ │ +0003aa60: 6420 706f 7075 6c61 7465 0a20 2020 2020  d populate.     
│ │ │ │ +0003aa70: 6769 7665 6e20 7661 7269 6162 6c65 2e0a  given variable..
│ │ │ │ +0003aa80: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ +0003aa90: 6c75 653a 2a20 5265 7475 726e 7320 5348  lue:* Returns SH
│ │ │ │ +0003aaa0: 4953 4849 5f4f 4b20 6966 6620 7375 6363  ISHI_OK iff succ
│ │ │ │ +0003aab0: 6573 7366 756c 2e0a 0a73 6869 7368 695f  essful...shishi_
│ │ │ │ +0003aac0: 656e 6361 7072 6570 7061 7274 5f66 726f  encapreppart_fro
│ │ │ │ +0003aad0: 6d5f 6669 6c65 0a2d 2d2d 2d2d 2d2d 2d2d  m_file.---------
│ │ │ │  0003aae0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0003aaf0: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ -0003ab00: 3a20 696e 7420 7368 6973 6869 5f65 6e63  : int shishi_enc
│ │ │ │ -0003ab10: 6170 7265 7070 6172 745f 6672 6f6d 5f66  apreppart_from_f
│ │ │ │ -0003ab20: 696c 6520 2853 6869 7368 6920 2a20 4841  ile (Shishi * HA
│ │ │ │ -0003ab30: 4e44 4c45 2c0a 2020 2020 2020 2020 2020  NDLE,.          
│ │ │ │ -0003ab40: 5368 6973 6869 5f61 736e 3120 2a20 454e  Shishi_asn1 * EN
│ │ │ │ -0003ab50: 4341 5052 4550 5041 5254 2c20 696e 7420  CAPREPPART, int 
│ │ │ │ -0003ab60: 4649 4c45 5459 5045 2c0a 2020 2020 2020  FILETYPE,.      
│ │ │ │ -0003ab70: 2020 2020 636f 6e73 7420 6368 6172 202a      const char *
│ │ │ │ -0003ab80: 2046 494c 454e 414d 4529 0a20 2020 2020   FILENAME).     
│ │ │ │ -0003ab90: 4841 4e44 4c45 3a20 7368 6973 6869 2068  HANDLE: shishi h
│ │ │ │ -0003aba0: 616e 646c 6520 6173 2061 6c6c 6f63 6174  andle as allocat
│ │ │ │ -0003abb0: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ -0003abc0: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ -0003abd0: 454e 4341 5052 4550 5041 5254 3a20 6f75  ENCAPREPPART: ou
│ │ │ │ -0003abe0: 7470 7574 2076 6172 6961 626c 6520 7769  tput variable wi
│ │ │ │ -0003abf0: 7468 206e 6577 6c79 2061 6c6c 6f63 6174  th newly allocat
│ │ │ │ -0003ac00: 6564 2045 6e63 4150 5265 7050 6172 742e  ed EncAPRepPart.
│ │ │ │ -0003ac10: 0a20 2020 2020 4649 4c45 5459 5045 3a20  .     FILETYPE: 
│ │ │ │ -0003ac20: 696e 7075 7420 7661 7269 6162 6c65 2073  input variable s
│ │ │ │ -0003ac30: 7065 6369 6679 696e 6720 7479 7065 206f  pecifying type o
│ │ │ │ -0003ac40: 6620 6669 6c65 2074 6f20 6265 2072 6561  f file to be rea
│ │ │ │ -0003ac50: 642c 2073 6565 0a20 2020 2020 5368 6973  d, see.     Shis
│ │ │ │ -0003ac60: 6869 5f66 696c 6574 7970 652e 0a20 2020  hi_filetype..   
│ │ │ │ -0003ac70: 2020 4649 4c45 4e41 4d45 3a20 696e 7075    FILENAME: inpu
│ │ │ │ -0003ac80: 7420 7661 7269 6162 6c65 2077 6974 6820  t variable with 
│ │ │ │ -0003ac90: 6669 6c65 6e61 6d65 2074 6f20 7265 6164  filename to read
│ │ │ │ -0003aca0: 2066 726f 6d2e 0a0a 2020 2020 202a 4465   from...     *De
│ │ │ │ -0003acb0: 7363 7269 7074 696f 6e3a 2a20 5265 6164  scription:* Read
│ │ │ │ -0003acc0: 2045 6e63 4150 5265 7050 6172 7420 6672   EncAPRepPart fr
│ │ │ │ -0003acd0: 6f6d 2066 696c 6520 696e 2073 7065 6369  om file in speci
│ │ │ │ -0003ace0: 6669 6564 2054 5950 452e 0a0a 2020 2020  fied TYPE...    
│ │ │ │ -0003acf0: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ -0003ad00: 2052 6574 7572 6e73 2053 4849 5348 495f   Returns SHISHI_
│ │ │ │ -0003ad10: 4f4b 2069 6666 2073 7563 6365 7373 6675  OK iff successfu
│ │ │ │ -0003ad20: 6c2e 0a0a 7368 6973 6869 5f65 6e63 6170  l...shishi_encap
│ │ │ │ -0003ad30: 7265 7070 6172 745f 6765 745f 6b65 790a  reppart_get_key.
│ │ │ │ -0003ad40: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0003ad50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ -0003ad60: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ -0003ad70: 6869 7368 695f 656e 6361 7072 6570 7061  hishi_encapreppa
│ │ │ │ -0003ad80: 7274 5f67 6574 5f6b 6579 2028 5368 6973  rt_get_key (Shis
│ │ │ │ -0003ad90: 6869 202a 2048 414e 444c 452c 0a20 2020  hi * HANDLE,.   
│ │ │ │ -0003ada0: 2020 2020 2020 2053 6869 7368 695f 6173         Shishi_as
│ │ │ │ -0003adb0: 6e31 2045 4e43 4150 5245 5050 4152 542c  n1 ENCAPREPPART,
│ │ │ │ -0003adc0: 2053 6869 7368 695f 6b65 7920 2a2a 204b   Shishi_key ** K
│ │ │ │ -0003add0: 4559 290a 2020 2020 2048 414e 444c 453a  EY).     HANDLE:
│ │ │ │ -0003ade0: 2073 6869 7368 6920 6861 6e64 6c65 2061   shishi handle a
│ │ │ │ -0003adf0: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ -0003ae00: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ -0003ae10: 8099 2e0a 2020 2020 2045 4e43 4150 5245  ....     ENCAPRE
│ │ │ │ -0003ae20: 5050 4152 543a 2069 6e70 7574 2045 6e63  PPART: input Enc
│ │ │ │ -0003ae30: 4150 5265 7050 6172 7420 7661 7269 6162  APRepPart variab
│ │ │ │ -0003ae40: 6c65 2e0a 2020 2020 204b 4559 3a20 6e65  le..     KEY: ne
│ │ │ │ -0003ae50: 776c 7920 616c 6c6f 6361 7465 6420 6b65  wly allocated ke
│ │ │ │ -0003ae60: 792e 0a0a 2020 2020 202a 4465 7363 7269  y...     *Descri
│ │ │ │ -0003ae70: 7074 696f 6e3a 2a20 4578 7472 6163 7420  ption:* Extract 
│ │ │ │ -0003ae80: 7468 6520 7375 626b 6579 2066 726f 6d20  the subkey from 
│ │ │ │ -0003ae90: 7468 6520 656e 6372 7970 7465 6420 4150  the encrypted AP
│ │ │ │ -0003aea0: 2d52 4550 2070 6172 742e 0a0a 2020 2020  -REP part...    
│ │ │ │ -0003aeb0: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ -0003aec0: 2052 6574 7572 6e73 20e2 8098 5348 4953   Returns ...SHIS
│ │ │ │ -0003aed0: 4849 5f4f 4be2 8099 2069 6666 2073 7563  HI_OK... iff suc
│ │ │ │ -0003aee0: 6365 7373 6675 6c2e 0a0a 7368 6973 6869  cessful...shishi
│ │ │ │ -0003aef0: 5f65 6e63 6170 7265 7070 6172 745f 6374  _encapreppart_ct
│ │ │ │ -0003af00: 696d 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ime.------------
│ │ │ │ -0003af10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -0003af20: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ -0003af30: 2073 6869 7368 695f 656e 6361 7072 6570   shishi_encaprep
│ │ │ │ -0003af40: 7061 7274 5f63 7469 6d65 2028 5368 6973  part_ctime (Shis
│ │ │ │ -0003af50: 6869 202a 2048 414e 444c 452c 0a20 2020  hi * HANDLE,.   
│ │ │ │ -0003af60: 2020 2020 2020 2053 6869 7368 695f 6173         Shishi_as
│ │ │ │ -0003af70: 6e31 2045 4e43 4150 5245 5050 4152 542c  n1 ENCAPREPPART,
│ │ │ │ -0003af80: 2063 6861 7220 2a2a 2054 290a 2020 2020   char ** T).    
│ │ │ │ -0003af90: 2048 414e 444c 453a 2073 6869 7368 6920   HANDLE: shishi 
│ │ │ │ -0003afa0: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ -0003afb0: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ -0003afc0: 5f69 6e69 7428 29e2 8099 2e0a 2020 2020  _init().....    
│ │ │ │ -0003afd0: 2045 4e43 4150 5245 5050 4152 543a 2045   ENCAPREPPART: E
│ │ │ │ -0003afe0: 6e63 4150 5265 7050 6172 7420 6173 2061  ncAPRepPart as a
│ │ │ │ -0003aff0: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ -0003b000: 6869 7368 695f 656e 6361 7072 6570 7061  hishi_encapreppa
│ │ │ │ -0003b010: 7274 2829 e280 992e 0a0a 2020 2020 2054  rt()......     T
│ │ │ │ -0003b020: 3a20 6e65 776c 7920 616c 6c6f 6361 7465  : newly allocate
│ │ │ │ -0003b030: 6420 7a65 726f 2d74 6572 6d69 6e61 7465  d zero-terminate
│ │ │ │ -0003b040: 6420 6368 6172 6163 7465 7220 6172 7261  d character arra
│ │ │ │ -0003b050: 7920 7769 7468 2063 6c69 656e 740a 2020  y with client.  
│ │ │ │ -0003b060: 2020 2074 696d 652e 0a0a 2020 2020 202a     time...     *
│ │ │ │ -0003b070: 4465 7363 7269 7074 696f 6e3a 2a20 4578  Description:* Ex
│ │ │ │ -0003b080: 7472 6163 7420 636c 6965 6e74 2074 696d  tract client tim
│ │ │ │ -0003b090: 6520 6672 6f6d 2045 6e63 4150 5265 7050  e from EncAPRepP
│ │ │ │ -0003b0a0: 6172 742e 0a0a 2020 2020 202a 5265 7475  art...     *Retu
│ │ │ │ -0003b0b0: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ -0003b0c0: 6e73 2053 4849 5348 495f 4f4b 2069 6666  ns SHISHI_OK iff
│ │ │ │ -0003b0d0: 2073 7563 6365 7373 6675 6c2e 0a0a 7368   successful...sh
│ │ │ │ -0003b0e0: 6973 6869 5f65 6e63 6170 7265 7070 6172  ishi_encapreppar
│ │ │ │ -0003b0f0: 745f 6374 696d 655f 7365 740a 2d2d 2d2d  t_ctime_set.----
│ │ │ │ +0003aaf0: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ +0003ab00: 6f6e 3a20 696e 7420 7368 6973 6869 5f65  on: int shishi_e
│ │ │ │ +0003ab10: 6e63 6170 7265 7070 6172 745f 6672 6f6d  ncapreppart_from
│ │ │ │ +0003ab20: 5f66 696c 6520 2853 6869 7368 6920 2a20  _file (Shishi * 
│ │ │ │ +0003ab30: 4841 4e44 4c45 2c0a 2020 2020 2020 2020  HANDLE,.        
│ │ │ │ +0003ab40: 2020 5368 6973 6869 5f61 736e 3120 2a20    Shishi_asn1 * 
│ │ │ │ +0003ab50: 454e 4341 5052 4550 5041 5254 2c20 696e  ENCAPREPPART, in
│ │ │ │ +0003ab60: 7420 4649 4c45 5459 5045 2c0a 2020 2020  t FILETYPE,.    
│ │ │ │ +0003ab70: 2020 2020 2020 636f 6e73 7420 6368 6172        const char
│ │ │ │ +0003ab80: 202a 2046 494c 454e 414d 4529 0a20 2020   * FILENAME).   
│ │ │ │ +0003ab90: 2020 4841 4e44 4c45 3a20 7368 6973 6869    HANDLE: shishi
│ │ │ │ +0003aba0: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ +0003abb0: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ +0003abc0: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ +0003abd0: 2020 454e 4341 5052 4550 5041 5254 3a20    ENCAPREPPART: 
│ │ │ │ +0003abe0: 6f75 7470 7574 2076 6172 6961 626c 6520  output variable 
│ │ │ │ +0003abf0: 7769 7468 206e 6577 6c79 2061 6c6c 6f63  with newly alloc
│ │ │ │ +0003ac00: 6174 6564 2045 6e63 4150 5265 7050 6172  ated EncAPRepPar
│ │ │ │ +0003ac10: 742e 0a20 2020 2020 4649 4c45 5459 5045  t..     FILETYPE
│ │ │ │ +0003ac20: 3a20 696e 7075 7420 7661 7269 6162 6c65  : input variable
│ │ │ │ +0003ac30: 2073 7065 6369 6679 696e 6720 7479 7065   specifying type
│ │ │ │ +0003ac40: 206f 6620 6669 6c65 2074 6f20 6265 2072   of file to be r
│ │ │ │ +0003ac50: 6561 642c 2073 6565 0a20 2020 2020 5368  ead, see.     Sh
│ │ │ │ +0003ac60: 6973 6869 5f66 696c 6574 7970 652e 0a20  ishi_filetype.. 
│ │ │ │ +0003ac70: 2020 2020 4649 4c45 4e41 4d45 3a20 696e      FILENAME: in
│ │ │ │ +0003ac80: 7075 7420 7661 7269 6162 6c65 2077 6974  put variable wit
│ │ │ │ +0003ac90: 6820 6669 6c65 6e61 6d65 2074 6f20 7265  h filename to re
│ │ │ │ +0003aca0: 6164 2066 726f 6d2e 0a0a 2020 2020 202a  ad from...     *
│ │ │ │ +0003acb0: 4465 7363 7269 7074 696f 6e3a 2a20 5265  Description:* Re
│ │ │ │ +0003acc0: 6164 2045 6e63 4150 5265 7050 6172 7420  ad EncAPRepPart 
│ │ │ │ +0003acd0: 6672 6f6d 2066 696c 6520 696e 2073 7065  from file in spe
│ │ │ │ +0003ace0: 6369 6669 6564 2054 5950 452e 0a0a 2020  cified TYPE...  
│ │ │ │ +0003acf0: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ +0003ad00: 3a2a 2052 6574 7572 6e73 2053 4849 5348  :* Returns SHISH
│ │ │ │ +0003ad10: 495f 4f4b 2069 6666 2073 7563 6365 7373  I_OK iff success
│ │ │ │ +0003ad20: 6675 6c2e 0a0a 7368 6973 6869 5f65 6e63  ful...shishi_enc
│ │ │ │ +0003ad30: 6170 7265 7070 6172 745f 6765 745f 6b65  apreppart_get_ke
│ │ │ │ +0003ad40: 790a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  y.--------------
│ │ │ │ +0003ad50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ +0003ad60: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ +0003ad70: 2073 6869 7368 695f 656e 6361 7072 6570   shishi_encaprep
│ │ │ │ +0003ad80: 7061 7274 5f67 6574 5f6b 6579 2028 5368  part_get_key (Sh
│ │ │ │ +0003ad90: 6973 6869 202a 2048 414e 444c 452c 0a20  ishi * HANDLE,. 
│ │ │ │ +0003ada0: 2020 2020 2020 2020 2053 6869 7368 695f           Shishi_
│ │ │ │ +0003adb0: 6173 6e31 2045 4e43 4150 5245 5050 4152  asn1 ENCAPREPPAR
│ │ │ │ +0003adc0: 542c 2053 6869 7368 695f 6b65 7920 2a2a  T, Shishi_key **
│ │ │ │ +0003add0: 204b 4559 290a 2020 2020 2048 414e 444c   KEY).     HANDL
│ │ │ │ +0003ade0: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ +0003adf0: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ +0003ae00: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ +0003ae10: 29e2 8099 2e0a 2020 2020 2045 4e43 4150  ).....     ENCAP
│ │ │ │ +0003ae20: 5245 5050 4152 543a 2069 6e70 7574 2045  REPPART: input E
│ │ │ │ +0003ae30: 6e63 4150 5265 7050 6172 7420 7661 7269  ncAPRepPart vari
│ │ │ │ +0003ae40: 6162 6c65 2e0a 2020 2020 204b 4559 3a20  able..     KEY: 
│ │ │ │ +0003ae50: 6e65 776c 7920 616c 6c6f 6361 7465 6420  newly allocated 
│ │ │ │ +0003ae60: 6b65 792e 0a0a 2020 2020 202a 4465 7363  key...     *Desc
│ │ │ │ +0003ae70: 7269 7074 696f 6e3a 2a20 4578 7472 6163  ription:* Extrac
│ │ │ │ +0003ae80: 7420 7468 6520 7375 626b 6579 2066 726f  t the subkey fro
│ │ │ │ +0003ae90: 6d20 7468 6520 656e 6372 7970 7465 6420  m the encrypted 
│ │ │ │ +0003aea0: 4150 2d52 4550 2070 6172 742e 0a0a 2020  AP-REP part...  
│ │ │ │ +0003aeb0: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ +0003aec0: 3a2a 2052 6574 7572 6e73 20e2 8098 5348  :* Returns ...SH
│ │ │ │ +0003aed0: 4953 4849 5f4f 4be2 8099 2069 6666 2073  ISHI_OK... iff s
│ │ │ │ +0003aee0: 7563 6365 7373 6675 6c2e 0a0a 7368 6973  uccessful...shis
│ │ │ │ +0003aef0: 6869 5f65 6e63 6170 7265 7070 6172 745f  hi_encapreppart_
│ │ │ │ +0003af00: 6374 696d 650a 2d2d 2d2d 2d2d 2d2d 2d2d  ctime.----------
│ │ │ │ +0003af10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +0003af20: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ +0003af30: 6e74 2073 6869 7368 695f 656e 6361 7072  nt shishi_encapr
│ │ │ │ +0003af40: 6570 7061 7274 5f63 7469 6d65 2028 5368  eppart_ctime (Sh
│ │ │ │ +0003af50: 6973 6869 202a 2048 414e 444c 452c 0a20  ishi * HANDLE,. 
│ │ │ │ +0003af60: 2020 2020 2020 2020 2053 6869 7368 695f           Shishi_
│ │ │ │ +0003af70: 6173 6e31 2045 4e43 4150 5245 5050 4152  asn1 ENCAPREPPAR
│ │ │ │ +0003af80: 542c 2063 6861 7220 2a2a 2054 290a 2020  T, char ** T).  
│ │ │ │ +0003af90: 2020 2048 414e 444c 453a 2073 6869 7368     HANDLE: shish
│ │ │ │ +0003afa0: 6920 6861 6e64 6c65 2061 7320 616c 6c6f  i handle as allo
│ │ │ │ +0003afb0: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ +0003afc0: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ +0003afd0: 2020 2045 4e43 4150 5245 5050 4152 543a     ENCAPREPPART:
│ │ │ │ +0003afe0: 2045 6e63 4150 5265 7050 6172 7420 6173   EncAPRepPart as
│ │ │ │ +0003aff0: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ +0003b000: 9873 6869 7368 695f 656e 6361 7072 6570  .shishi_encaprep
│ │ │ │ +0003b010: 7061 7274 2829 e280 992e 0a0a 2020 2020  part()......    
│ │ │ │ +0003b020: 2054 3a20 6e65 776c 7920 616c 6c6f 6361   T: newly alloca
│ │ │ │ +0003b030: 7465 6420 7a65 726f 2d74 6572 6d69 6e61  ted zero-termina
│ │ │ │ +0003b040: 7465 6420 6368 6172 6163 7465 7220 6172  ted character ar
│ │ │ │ +0003b050: 7261 7920 7769 7468 2063 6c69 656e 740a  ray with client.
│ │ │ │ +0003b060: 2020 2020 2074 696d 652e 0a0a 2020 2020       time...    
│ │ │ │ +0003b070: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ +0003b080: 4578 7472 6163 7420 636c 6965 6e74 2074  Extract client t
│ │ │ │ +0003b090: 696d 6520 6672 6f6d 2045 6e63 4150 5265  ime from EncAPRe
│ │ │ │ +0003b0a0: 7050 6172 742e 0a0a 2020 2020 202a 5265  pPart...     *Re
│ │ │ │ +0003b0b0: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ +0003b0c0: 7572 6e73 2053 4849 5348 495f 4f4b 2069  urns SHISHI_OK i
│ │ │ │ +0003b0d0: 6666 2073 7563 6365 7373 6675 6c2e 0a0a  ff successful...
│ │ │ │ +0003b0e0: 7368 6973 6869 5f65 6e63 6170 7265 7070  shishi_encaprepp
│ │ │ │ +0003b0f0: 6172 745f 6374 696d 655f 7365 740a 2d2d  art_ctime_set.--
│ │ │ │  0003b100: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0003b110: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ -0003b120: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ -0003b130: 7368 695f 656e 6361 7072 6570 7061 7274  shi_encapreppart
│ │ │ │ -0003b140: 5f63 7469 6d65 5f73 6574 2028 5368 6973  _ctime_set (Shis
│ │ │ │ -0003b150: 6869 202a 2048 414e 444c 452c 0a20 2020  hi * HANDLE,.   
│ │ │ │ -0003b160: 2020 2020 2020 2053 6869 7368 695f 6173         Shishi_as
│ │ │ │ -0003b170: 6e31 2045 4e43 4150 5245 5050 4152 542c  n1 ENCAPREPPART,
│ │ │ │ -0003b180: 2063 6f6e 7374 2063 6861 7220 2a20 5429   const char * T)
│ │ │ │ -0003b190: 0a20 2020 2020 4841 4e44 4c45 3a20 7368  .     HANDLE: sh
│ │ │ │ -0003b1a0: 6973 6869 2068 616e 646c 6520 6173 2061  ishi handle as a
│ │ │ │ -0003b1b0: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ -0003b1c0: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ -0003b1d0: 0a20 2020 2020 454e 4341 5052 4550 5041  .     ENCAPREPPA
│ │ │ │ -0003b1e0: 5254 3a20 456e 6341 5052 6570 5061 7274  RT: EncAPRepPart
│ │ │ │ -0003b1f0: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ -0003b200: 20e2 8098 7368 6973 6869 5f65 6e63 6170   ...shishi_encap
│ │ │ │ -0003b210: 7265 7070 6172 7428 29e2 8099 2e0a 0a20  reppart()...... 
│ │ │ │ -0003b220: 2020 2020 543a 2073 7472 696e 6720 7769      T: string wi
│ │ │ │ -0003b230: 7468 2067 656e 6572 616c 697a 6564 2074  th generalized t
│ │ │ │ -0003b240: 696d 6520 7661 6c75 6520 746f 2073 746f  ime value to sto
│ │ │ │ -0003b250: 7265 2069 6e20 456e 6341 5052 6570 5061  re in EncAPRepPa
│ │ │ │ -0003b260: 7274 2e0a 0a20 2020 2020 2a44 6573 6372  rt...     *Descr
│ │ │ │ -0003b270: 6970 7469 6f6e 3a2a 2053 746f 7265 2063  iption:* Store c
│ │ │ │ -0003b280: 6c69 656e 7420 7469 6d65 2069 6e20 456e  lient time in En
│ │ │ │ -0003b290: 6341 5052 6570 5061 7274 2e0a 0a20 2020  cAPRepPart...   
│ │ │ │ -0003b2a0: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ -0003b2b0: 2a20 5265 7475 726e 7320 5348 4953 4849  * Returns SHISHI
│ │ │ │ -0003b2c0: 5f4f 4b20 6966 6620 7375 6363 6573 7366  _OK iff successf
│ │ │ │ -0003b2d0: 756c 2e0a 0a73 6869 7368 695f 656e 6361  ul...shishi_enca
│ │ │ │ -0003b2e0: 7072 6570 7061 7274 5f63 7573 6563 5f67  preppart_cusec_g
│ │ │ │ -0003b2f0: 6574 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  et.-------------
│ │ │ │ +0003b110: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ +0003b120: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ +0003b130: 6869 7368 695f 656e 6361 7072 6570 7061  hishi_encapreppa
│ │ │ │ +0003b140: 7274 5f63 7469 6d65 5f73 6574 2028 5368  rt_ctime_set (Sh
│ │ │ │ +0003b150: 6973 6869 202a 2048 414e 444c 452c 0a20  ishi * HANDLE,. 
│ │ │ │ +0003b160: 2020 2020 2020 2020 2053 6869 7368 695f           Shishi_
│ │ │ │ +0003b170: 6173 6e31 2045 4e43 4150 5245 5050 4152  asn1 ENCAPREPPAR
│ │ │ │ +0003b180: 542c 2063 6f6e 7374 2063 6861 7220 2a20  T, const char * 
│ │ │ │ +0003b190: 5429 0a20 2020 2020 4841 4e44 4c45 3a20  T).     HANDLE: 
│ │ │ │ +0003b1a0: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ +0003b1b0: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ +0003b1c0: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ +0003b1d0: 992e 0a20 2020 2020 454e 4341 5052 4550  ...     ENCAPREP
│ │ │ │ +0003b1e0: 5041 5254 3a20 456e 6341 5052 6570 5061  PART: EncAPRepPa
│ │ │ │ +0003b1f0: 7274 2061 7320 616c 6c6f 6361 7465 6420  rt as allocated 
│ │ │ │ +0003b200: 6279 20e2 8098 7368 6973 6869 5f65 6e63  by ...shishi_enc
│ │ │ │ +0003b210: 6170 7265 7070 6172 7428 29e2 8099 2e0a  apreppart().....
│ │ │ │ +0003b220: 0a20 2020 2020 543a 2073 7472 696e 6720  .     T: string 
│ │ │ │ +0003b230: 7769 7468 2067 656e 6572 616c 697a 6564  with generalized
│ │ │ │ +0003b240: 2074 696d 6520 7661 6c75 6520 746f 2073   time value to s
│ │ │ │ +0003b250: 746f 7265 2069 6e20 456e 6341 5052 6570  tore in EncAPRep
│ │ │ │ +0003b260: 5061 7274 2e0a 0a20 2020 2020 2a44 6573  Part...     *Des
│ │ │ │ +0003b270: 6372 6970 7469 6f6e 3a2a 2053 746f 7265  cription:* Store
│ │ │ │ +0003b280: 2063 6c69 656e 7420 7469 6d65 2069 6e20   client time in 
│ │ │ │ +0003b290: 456e 6341 5052 6570 5061 7274 2e0a 0a20  EncAPRepPart... 
│ │ │ │ +0003b2a0: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ +0003b2b0: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ +0003b2c0: 4849 5f4f 4b20 6966 6620 7375 6363 6573  HI_OK iff succes
│ │ │ │ +0003b2d0: 7366 756c 2e0a 0a73 6869 7368 695f 656e  sful...shishi_en
│ │ │ │ +0003b2e0: 6361 7072 6570 7061 7274 5f63 7573 6563  capreppart_cusec
│ │ │ │ +0003b2f0: 5f67 6574 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  _get.-----------
│ │ │ │  0003b300: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0003b310: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ -0003b320: 696e 7420 7368 6973 6869 5f65 6e63 6170  int shishi_encap
│ │ │ │ -0003b330: 7265 7070 6172 745f 6375 7365 635f 6765  reppart_cusec_ge
│ │ │ │ -0003b340: 7420 2853 6869 7368 6920 2a20 4841 4e44  t (Shishi * HAND
│ │ │ │ -0003b350: 4c45 2c0a 2020 2020 2020 2020 2020 5368  LE,.          Sh
│ │ │ │ -0003b360: 6973 6869 5f61 736e 3120 454e 4341 5052  ishi_asn1 ENCAPR
│ │ │ │ -0003b370: 4550 5041 5254 2c20 7569 6e74 3332 5f74  EPPART, uint32_t
│ │ │ │ -0003b380: 202a 2043 5553 4543 290a 2020 2020 2048   * CUSEC).     H
│ │ │ │ -0003b390: 414e 444c 453a 2073 6869 7368 6920 6861  ANDLE: shishi ha
│ │ │ │ -0003b3a0: 6e64 6c65 2061 7320 616c 6c6f 6361 7465  ndle as allocate
│ │ │ │ -0003b3b0: 6420 6279 20e2 8098 7368 6973 6869 5f69  d by ...shishi_i
│ │ │ │ -0003b3c0: 6e69 7428 29e2 8099 2e0a 2020 2020 2045  nit().....     E
│ │ │ │ -0003b3d0: 4e43 4150 5245 5050 4152 543a 2045 6e63  NCAPREPPART: Enc
│ │ │ │ -0003b3e0: 4150 5265 7050 6172 7420 6173 2061 6c6c  APRepPart as all
│ │ │ │ -0003b3f0: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ -0003b400: 7368 695f 656e 6361 7072 6570 7061 7274  shi_encapreppart
│ │ │ │ -0003b410: 2829 e280 992e 0a0a 2020 2020 2043 5553  ()......     CUS
│ │ │ │ -0003b420: 4543 3a20 6f75 7470 7574 2069 6e74 6567  EC: output integ
│ │ │ │ -0003b430: 6572 2077 6974 6820 636c 6965 6e74 206d  er with client m
│ │ │ │ -0003b440: 6963 726f 7365 636f 6e64 7320 6669 656c  icroseconds fiel
│ │ │ │ -0003b450: 642e 0a0a 2020 2020 202a 4465 7363 7269  d...     *Descri
│ │ │ │ -0003b460: 7074 696f 6e3a 2a20 4578 7472 6163 7420  ption:* Extract 
│ │ │ │ -0003b470: 636c 6965 6e74 206d 6963 726f 7365 636f  client microseco
│ │ │ │ -0003b480: 6e64 7320 6669 656c 6420 6672 6f6d 2045  nds field from E
│ │ │ │ -0003b490: 6e63 4150 5265 7050 6172 742e 0a0a 2020  ncAPRepPart...  
│ │ │ │ -0003b4a0: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ -0003b4b0: 3a2a 2052 6574 7572 6e73 2053 4849 5348  :* Returns SHISH
│ │ │ │ -0003b4c0: 495f 4f4b 2069 6666 2073 7563 6365 7373  I_OK iff success
│ │ │ │ -0003b4d0: 6675 6c2e 0a0a 7368 6973 6869 5f65 6e63  ful...shishi_enc
│ │ │ │ -0003b4e0: 6170 7265 7070 6172 745f 6375 7365 635f  apreppart_cusec_
│ │ │ │ -0003b4f0: 7365 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  set.------------
│ │ │ │ +0003b310: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ +0003b320: 3a20 696e 7420 7368 6973 6869 5f65 6e63  : int shishi_enc
│ │ │ │ +0003b330: 6170 7265 7070 6172 745f 6375 7365 635f  apreppart_cusec_
│ │ │ │ +0003b340: 6765 7420 2853 6869 7368 6920 2a20 4841  get (Shishi * HA
│ │ │ │ +0003b350: 4e44 4c45 2c0a 2020 2020 2020 2020 2020  NDLE,.          
│ │ │ │ +0003b360: 5368 6973 6869 5f61 736e 3120 454e 4341  Shishi_asn1 ENCA
│ │ │ │ +0003b370: 5052 4550 5041 5254 2c20 7569 6e74 3332  PREPPART, uint32
│ │ │ │ +0003b380: 5f74 202a 2043 5553 4543 290a 2020 2020  _t * CUSEC).    
│ │ │ │ +0003b390: 2048 414e 444c 453a 2073 6869 7368 6920   HANDLE: shishi 
│ │ │ │ +0003b3a0: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ +0003b3b0: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ +0003b3c0: 5f69 6e69 7428 29e2 8099 2e0a 2020 2020  _init().....    
│ │ │ │ +0003b3d0: 2045 4e43 4150 5245 5050 4152 543a 2045   ENCAPREPPART: E
│ │ │ │ +0003b3e0: 6e63 4150 5265 7050 6172 7420 6173 2061  ncAPRepPart as a
│ │ │ │ +0003b3f0: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ +0003b400: 6869 7368 695f 656e 6361 7072 6570 7061  hishi_encapreppa
│ │ │ │ +0003b410: 7274 2829 e280 992e 0a0a 2020 2020 2043  rt()......     C
│ │ │ │ +0003b420: 5553 4543 3a20 6f75 7470 7574 2069 6e74  USEC: output int
│ │ │ │ +0003b430: 6567 6572 2077 6974 6820 636c 6965 6e74  eger with client
│ │ │ │ +0003b440: 206d 6963 726f 7365 636f 6e64 7320 6669   microseconds fi
│ │ │ │ +0003b450: 656c 642e 0a0a 2020 2020 202a 4465 7363  eld...     *Desc
│ │ │ │ +0003b460: 7269 7074 696f 6e3a 2a20 4578 7472 6163  ription:* Extrac
│ │ │ │ +0003b470: 7420 636c 6965 6e74 206d 6963 726f 7365  t client microse
│ │ │ │ +0003b480: 636f 6e64 7320 6669 656c 6420 6672 6f6d  conds field from
│ │ │ │ +0003b490: 2045 6e63 4150 5265 7050 6172 742e 0a0a   EncAPRepPart...
│ │ │ │ +0003b4a0: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ +0003b4b0: 7565 3a2a 2052 6574 7572 6e73 2053 4849  ue:* Returns SHI
│ │ │ │ +0003b4c0: 5348 495f 4f4b 2069 6666 2073 7563 6365  SHI_OK iff succe
│ │ │ │ +0003b4d0: 7373 6675 6c2e 0a0a 7368 6973 6869 5f65  ssful...shishi_e
│ │ │ │ +0003b4e0: 6e63 6170 7265 7070 6172 745f 6375 7365  ncapreppart_cuse
│ │ │ │ +0003b4f0: 635f 7365 740a 2d2d 2d2d 2d2d 2d2d 2d2d  c_set.----------
│ │ │ │  0003b500: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0003b510: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ -0003b520: 2069 6e74 2073 6869 7368 695f 656e 6361   int shishi_enca
│ │ │ │ -0003b530: 7072 6570 7061 7274 5f63 7573 6563 5f73  preppart_cusec_s
│ │ │ │ -0003b540: 6574 2028 5368 6973 6869 202a 2048 414e  et (Shishi * HAN
│ │ │ │ -0003b550: 444c 452c 0a20 2020 2020 2020 2020 2053  DLE,.          S
│ │ │ │ -0003b560: 6869 7368 695f 6173 6e31 2045 4e43 4150  hishi_asn1 ENCAP
│ │ │ │ -0003b570: 5245 5050 4152 542c 2075 696e 7433 325f  REPPART, uint32_
│ │ │ │ -0003b580: 7420 4355 5345 4329 0a20 2020 2020 4841  t CUSEC).     HA
│ │ │ │ -0003b590: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ -0003b5a0: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ -0003b5b0: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ -0003b5c0: 6974 2829 e280 992e 0a20 2020 2020 454e  it().....     EN
│ │ │ │ -0003b5d0: 4341 5052 4550 5041 5254 3a20 456e 6341  CAPREPPART: EncA
│ │ │ │ -0003b5e0: 5052 6570 5061 7274 2061 7320 616c 6c6f  PRepPart as allo
│ │ │ │ -0003b5f0: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ -0003b600: 6869 5f65 6e63 6170 7265 7070 6172 7428  hi_encapreppart(
│ │ │ │ -0003b610: 29e2 8099 2e0a 0a20 2020 2020 4355 5345  )......     CUSE
│ │ │ │ -0003b620: 433a 2063 6c69 656e 7420 6d69 6372 6f73  C: client micros
│ │ │ │ -0003b630: 6563 6f6e 6473 2074 6f20 7365 7420 696e  econds to set in
│ │ │ │ -0003b640: 2061 7574 6865 6e74 6963 6174 6f72 2c20   authenticator, 
│ │ │ │ -0003b650: 302d 3939 3939 3939 2e0a 0a20 2020 2020  0-999999...     
│ │ │ │ -0003b660: 2a44 6573 6372 6970 7469 6f6e 3a2a 2053  *Description:* S
│ │ │ │ -0003b670: 6574 2074 6865 2063 7573 6563 2066 6965  et the cusec fie
│ │ │ │ -0003b680: 6c64 2069 6e20 7468 6520 4175 7468 656e  ld in the Authen
│ │ │ │ -0003b690: 7469 6361 746f 722e 0a0a 2020 2020 202a  ticator...     *
│ │ │ │ -0003b6a0: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ -0003b6b0: 6574 7572 6e73 2053 4849 5348 495f 4f4b  eturns SHISHI_OK
│ │ │ │ -0003b6c0: 2069 6666 2073 7563 6365 7373 6675 6c2e   iff successful.
│ │ │ │ -0003b6d0: 0a0a 7368 6973 6869 5f65 6e63 6170 7265  ..shishi_encapre
│ │ │ │ -0003b6e0: 7070 6172 745f 7365 716e 756d 6265 725f  ppart_seqnumber_
│ │ │ │ -0003b6f0: 6765 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  get.------------
│ │ │ │ +0003b510: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ +0003b520: 6e3a 2069 6e74 2073 6869 7368 695f 656e  n: int shishi_en
│ │ │ │ +0003b530: 6361 7072 6570 7061 7274 5f63 7573 6563  capreppart_cusec
│ │ │ │ +0003b540: 5f73 6574 2028 5368 6973 6869 202a 2048  _set (Shishi * H
│ │ │ │ +0003b550: 414e 444c 452c 0a20 2020 2020 2020 2020  ANDLE,.         
│ │ │ │ +0003b560: 2053 6869 7368 695f 6173 6e31 2045 4e43   Shishi_asn1 ENC
│ │ │ │ +0003b570: 4150 5245 5050 4152 542c 2075 696e 7433  APREPPART, uint3
│ │ │ │ +0003b580: 325f 7420 4355 5345 4329 0a20 2020 2020  2_t CUSEC).     
│ │ │ │ +0003b590: 4841 4e44 4c45 3a20 7368 6973 6869 2068  HANDLE: shishi h
│ │ │ │ +0003b5a0: 616e 646c 6520 6173 2061 6c6c 6f63 6174  andle as allocat
│ │ │ │ +0003b5b0: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ +0003b5c0: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ +0003b5d0: 454e 4341 5052 4550 5041 5254 3a20 456e  ENCAPREPPART: En
│ │ │ │ +0003b5e0: 6341 5052 6570 5061 7274 2061 7320 616c  cAPRepPart as al
│ │ │ │ +0003b5f0: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ +0003b600: 6973 6869 5f65 6e63 6170 7265 7070 6172  ishi_encapreppar
│ │ │ │ +0003b610: 7428 29e2 8099 2e0a 0a20 2020 2020 4355  t()......     CU
│ │ │ │ +0003b620: 5345 433a 2063 6c69 656e 7420 6d69 6372  SEC: client micr
│ │ │ │ +0003b630: 6f73 6563 6f6e 6473 2074 6f20 7365 7420  oseconds to set 
│ │ │ │ +0003b640: 696e 2061 7574 6865 6e74 6963 6174 6f72  in authenticator
│ │ │ │ +0003b650: 2c20 302d 3939 3939 3939 2e0a 0a20 2020  , 0-999999...   
│ │ │ │ +0003b660: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ +0003b670: 2053 6574 2074 6865 2063 7573 6563 2066   Set the cusec f
│ │ │ │ +0003b680: 6965 6c64 2069 6e20 7468 6520 4175 7468  ield in the Auth
│ │ │ │ +0003b690: 656e 7469 6361 746f 722e 0a0a 2020 2020  enticator...    
│ │ │ │ +0003b6a0: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ +0003b6b0: 2052 6574 7572 6e73 2053 4849 5348 495f   Returns SHISHI_
│ │ │ │ +0003b6c0: 4f4b 2069 6666 2073 7563 6365 7373 6675  OK iff successfu
│ │ │ │ +0003b6d0: 6c2e 0a0a 7368 6973 6869 5f65 6e63 6170  l...shishi_encap
│ │ │ │ +0003b6e0: 7265 7070 6172 745f 7365 716e 756d 6265  reppart_seqnumbe
│ │ │ │ +0003b6f0: 725f 6765 740a 2d2d 2d2d 2d2d 2d2d 2d2d  r_get.----------
│ │ │ │  0003b700: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0003b710: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ -0003b720: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ -0003b730: 656e 6361 7072 6570 7061 7274 5f73 6571  encapreppart_seq
│ │ │ │ -0003b740: 6e75 6d62 6572 5f67 6574 2028 5368 6973  number_get (Shis
│ │ │ │ -0003b750: 6869 202a 2048 414e 444c 452c 0a20 2020  hi * HANDLE,.   
│ │ │ │ -0003b760: 2020 2020 2020 2053 6869 7368 695f 6173         Shishi_as
│ │ │ │ -0003b770: 6e31 2045 4e43 4150 5245 5050 4152 542c  n1 ENCAPREPPART,
│ │ │ │ -0003b780: 2075 696e 7433 325f 7420 2a20 5345 514e   uint32_t * SEQN
│ │ │ │ -0003b790: 554d 4245 5229 0a20 2020 2020 4841 4e44  UMBER).     HAND
│ │ │ │ -0003b7a0: 4c45 3a20 7368 6973 6869 2068 616e 646c  LE: shishi handl
│ │ │ │ -0003b7b0: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ -0003b7c0: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ -0003b7d0: 2829 e280 992e 0a20 2020 2020 454e 4341  ().....     ENCA
│ │ │ │ -0003b7e0: 5052 4550 5041 5254 3a20 456e 6341 5052  PREPPART: EncAPR
│ │ │ │ -0003b7f0: 6570 5061 7274 2061 7320 616c 6c6f 6361  epPart as alloca
│ │ │ │ -0003b800: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ -0003b810: 5f65 6e63 6170 7265 7070 6172 7428 29e2  _encapreppart().
│ │ │ │ -0003b820: 8099 2e0a 0a20 2020 2020 5345 514e 554d  .....     SEQNUM
│ │ │ │ -0003b830: 4245 523a 206f 7574 7075 7420 696e 7465  BER: output inte
│ │ │ │ -0003b840: 6765 7220 7769 7468 2073 6571 7565 6e63  ger with sequenc
│ │ │ │ -0003b850: 6520 6e75 6d62 6572 2066 6965 6c64 2e0a  e number field..
│ │ │ │ -0003b860: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -0003b870: 6f6e 3a2a 2045 7874 7261 6374 2073 6571  on:* Extract seq
│ │ │ │ -0003b880: 7565 6e63 6520 6e75 6d62 6572 2066 6965  uence number fie
│ │ │ │ -0003b890: 6c64 2066 726f 6d20 456e 6341 5052 6570  ld from EncAPRep
│ │ │ │ -0003b8a0: 5061 7274 2e0a 0a20 2020 2020 2a52 6574  Part...     *Ret
│ │ │ │ -0003b8b0: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ -0003b8c0: 726e 7320 5348 4953 4849 5f4f 4b20 6966  rns SHISHI_OK if
│ │ │ │ -0003b8d0: 6620 7375 6363 6573 7366 756c 2e0a 0a73  f successful...s
│ │ │ │ -0003b8e0: 6869 7368 695f 656e 6361 7072 6570 7061  hishi_encapreppa
│ │ │ │ -0003b8f0: 7274 5f73 6571 6e75 6d62 6572 5f72 656d  rt_seqnumber_rem
│ │ │ │ -0003b900: 6f76 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ove.------------
│ │ │ │ +0003b710: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +0003b720: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ +0003b730: 695f 656e 6361 7072 6570 7061 7274 5f73  i_encapreppart_s
│ │ │ │ +0003b740: 6571 6e75 6d62 6572 5f67 6574 2028 5368  eqnumber_get (Sh
│ │ │ │ +0003b750: 6973 6869 202a 2048 414e 444c 452c 0a20  ishi * HANDLE,. 
│ │ │ │ +0003b760: 2020 2020 2020 2020 2053 6869 7368 695f           Shishi_
│ │ │ │ +0003b770: 6173 6e31 2045 4e43 4150 5245 5050 4152  asn1 ENCAPREPPAR
│ │ │ │ +0003b780: 542c 2075 696e 7433 325f 7420 2a20 5345  T, uint32_t * SE
│ │ │ │ +0003b790: 514e 554d 4245 5229 0a20 2020 2020 4841  QNUMBER).     HA
│ │ │ │ +0003b7a0: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ +0003b7b0: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ +0003b7c0: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ +0003b7d0: 6974 2829 e280 992e 0a20 2020 2020 454e  it().....     EN
│ │ │ │ +0003b7e0: 4341 5052 4550 5041 5254 3a20 456e 6341  CAPREPPART: EncA
│ │ │ │ +0003b7f0: 5052 6570 5061 7274 2061 7320 616c 6c6f  PRepPart as allo
│ │ │ │ +0003b800: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ +0003b810: 6869 5f65 6e63 6170 7265 7070 6172 7428  hi_encapreppart(
│ │ │ │ +0003b820: 29e2 8099 2e0a 0a20 2020 2020 5345 514e  )......     SEQN
│ │ │ │ +0003b830: 554d 4245 523a 206f 7574 7075 7420 696e  UMBER: output in
│ │ │ │ +0003b840: 7465 6765 7220 7769 7468 2073 6571 7565  teger with seque
│ │ │ │ +0003b850: 6e63 6520 6e75 6d62 6572 2066 6965 6c64  nce number field
│ │ │ │ +0003b860: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ +0003b870: 7469 6f6e 3a2a 2045 7874 7261 6374 2073  tion:* Extract s
│ │ │ │ +0003b880: 6571 7565 6e63 6520 6e75 6d62 6572 2066  equence number f
│ │ │ │ +0003b890: 6965 6c64 2066 726f 6d20 456e 6341 5052  ield from EncAPR
│ │ │ │ +0003b8a0: 6570 5061 7274 2e0a 0a20 2020 2020 2a52  epPart...     *R
│ │ │ │ +0003b8b0: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +0003b8c0: 7475 726e 7320 5348 4953 4849 5f4f 4b20  turns SHISHI_OK 
│ │ │ │ +0003b8d0: 6966 6620 7375 6363 6573 7366 756c 2e0a  iff successful..
│ │ │ │ +0003b8e0: 0a73 6869 7368 695f 656e 6361 7072 6570  .shishi_encaprep
│ │ │ │ +0003b8f0: 7061 7274 5f73 6571 6e75 6d62 6572 5f72  part_seqnumber_r
│ │ │ │ +0003b900: 656d 6f76 650a 2d2d 2d2d 2d2d 2d2d 2d2d  emove.----------
│ │ │ │  0003b910: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0003b920: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -0003b930: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ -0003b940: 6869 5f65 6e63 6170 7265 7070 6172 745f  hi_encapreppart_
│ │ │ │ -0003b950: 7365 716e 756d 6265 725f 7265 6d6f 7665  seqnumber_remove
│ │ │ │ -0003b960: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ -0003b970: 452c 0a20 2020 2020 2020 2020 2053 6869  E,.          Shi
│ │ │ │ -0003b980: 7368 695f 6173 6e31 2045 4e43 4150 5245  shi_asn1 ENCAPRE
│ │ │ │ -0003b990: 5050 4152 5429 0a20 2020 2020 4841 4e44  PPART).     HAND
│ │ │ │ -0003b9a0: 4c45 3a20 7368 6973 6869 2068 616e 646c  LE: shishi handl
│ │ │ │ -0003b9b0: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ -0003b9c0: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ -0003b9d0: 2829 e280 992e 0a20 2020 2020 454e 4341  ().....     ENCA
│ │ │ │ -0003b9e0: 5052 4550 5041 5254 3a20 656e 6361 7072  PREPPART: encapr
│ │ │ │ -0003b9f0: 6570 7061 7274 2061 7320 616c 6c6f 6361  eppart as alloca
│ │ │ │ -0003ba00: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ -0003ba10: 5f65 6e63 6170 7265 7070 6172 7428 29e2  _encapreppart().
│ │ │ │ -0003ba20: 8099 2e0a 0a20 2020 2020 2a44 6573 6372  .....     *Descr
│ │ │ │ -0003ba30: 6970 7469 6f6e 3a2a 2052 656d 6f76 6520  iption:* Remove 
│ │ │ │ -0003ba40: 7365 7175 656e 6365 206e 756d 6265 7220  sequence number 
│ │ │ │ -0003ba50: 6669 656c 6420 696e 2045 6e63 4150 5265  field in EncAPRe
│ │ │ │ -0003ba60: 7050 6172 742e 0a0a 2020 2020 202a 5265  pPart...     *Re
│ │ │ │ -0003ba70: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ -0003ba80: 7572 6e73 20e2 8098 5348 4953 4849 5f4f  urns ...SHISHI_O
│ │ │ │ -0003ba90: 4be2 8099 2069 6666 2073 7563 6365 7373  K... iff success
│ │ │ │ -0003baa0: 6675 6c2e 0a0a 7368 6973 6869 5f65 6e63  ful...shishi_enc
│ │ │ │ -0003bab0: 6170 7265 7070 6172 745f 7365 716e 756d  apreppart_seqnum
│ │ │ │ -0003bac0: 6265 725f 7365 740a 2d2d 2d2d 2d2d 2d2d  ber_set.--------
│ │ │ │ +0003b920: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +0003b930: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ +0003b940: 6973 6869 5f65 6e63 6170 7265 7070 6172  ishi_encapreppar
│ │ │ │ +0003b950: 745f 7365 716e 756d 6265 725f 7265 6d6f  t_seqnumber_remo
│ │ │ │ +0003b960: 7665 2028 5368 6973 6869 202a 2048 414e  ve (Shishi * HAN
│ │ │ │ +0003b970: 444c 452c 0a20 2020 2020 2020 2020 2053  DLE,.          S
│ │ │ │ +0003b980: 6869 7368 695f 6173 6e31 2045 4e43 4150  hishi_asn1 ENCAP
│ │ │ │ +0003b990: 5245 5050 4152 5429 0a20 2020 2020 4841  REPPART).     HA
│ │ │ │ +0003b9a0: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ +0003b9b0: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ +0003b9c0: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ +0003b9d0: 6974 2829 e280 992e 0a20 2020 2020 454e  it().....     EN
│ │ │ │ +0003b9e0: 4341 5052 4550 5041 5254 3a20 656e 6361  CAPREPPART: enca
│ │ │ │ +0003b9f0: 7072 6570 7061 7274 2061 7320 616c 6c6f  preppart as allo
│ │ │ │ +0003ba00: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ +0003ba10: 6869 5f65 6e63 6170 7265 7070 6172 7428  hi_encapreppart(
│ │ │ │ +0003ba20: 29e2 8099 2e0a 0a20 2020 2020 2a44 6573  )......     *Des
│ │ │ │ +0003ba30: 6372 6970 7469 6f6e 3a2a 2052 656d 6f76  cription:* Remov
│ │ │ │ +0003ba40: 6520 7365 7175 656e 6365 206e 756d 6265  e sequence numbe
│ │ │ │ +0003ba50: 7220 6669 656c 6420 696e 2045 6e63 4150  r field in EncAP
│ │ │ │ +0003ba60: 5265 7050 6172 742e 0a0a 2020 2020 202a  RepPart...     *
│ │ │ │ +0003ba70: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ +0003ba80: 6574 7572 6e73 20e2 8098 5348 4953 4849  eturns ...SHISHI
│ │ │ │ +0003ba90: 5f4f 4be2 8099 2069 6666 2073 7563 6365  _OK... iff succe
│ │ │ │ +0003baa0: 7373 6675 6c2e 0a0a 7368 6973 6869 5f65  ssful...shishi_e
│ │ │ │ +0003bab0: 6e63 6170 7265 7070 6172 745f 7365 716e  ncapreppart_seqn
│ │ │ │ +0003bac0: 756d 6265 725f 7365 740a 2d2d 2d2d 2d2d  umber_set.------
│ │ │ │  0003bad0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0003bae0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ -0003baf0: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ -0003bb00: 7368 695f 656e 6361 7072 6570 7061 7274  shi_encapreppart
│ │ │ │ -0003bb10: 5f73 6571 6e75 6d62 6572 5f73 6574 2028  _seqnumber_set (
│ │ │ │ -0003bb20: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ -0003bb30: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ -0003bb40: 695f 6173 6e31 2045 4e43 4150 5245 5050  i_asn1 ENCAPREPP
│ │ │ │ -0003bb50: 4152 542c 2075 696e 7433 325f 7420 5345  ART, uint32_t SE
│ │ │ │ -0003bb60: 514e 554d 4245 5229 0a20 2020 2020 4841  QNUMBER).     HA
│ │ │ │ -0003bb70: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ -0003bb80: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ -0003bb90: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ -0003bba0: 6974 2829 e280 992e 0a20 2020 2020 454e  it().....     EN
│ │ │ │ -0003bbb0: 4341 5052 4550 5041 5254 3a20 656e 6361  CAPREPPART: enca
│ │ │ │ -0003bbc0: 7072 6570 7061 7274 2061 7320 616c 6c6f  preppart as allo
│ │ │ │ -0003bbd0: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ -0003bbe0: 6869 5f65 6e63 6170 7265 7070 6172 7428  hi_encapreppart(
│ │ │ │ -0003bbf0: 29e2 8099 2e0a 0a20 2020 2020 5345 514e  )......     SEQN
│ │ │ │ -0003bc00: 554d 4245 523a 2069 6e74 6567 6572 2077  UMBER: integer w
│ │ │ │ -0003bc10: 6974 6820 7365 7175 656e 6365 206e 756d  ith sequence num
│ │ │ │ -0003bc20: 6265 7220 6669 656c 6420 746f 2073 746f  ber field to sto
│ │ │ │ -0003bc30: 7265 2069 6e0a 2020 2020 2065 6e63 6170  re in.     encap
│ │ │ │ -0003bc40: 7265 7070 6172 742e 0a0a 2020 2020 202a  reppart...     *
│ │ │ │ -0003bc50: 4465 7363 7269 7074 696f 6e3a 2a20 5374  Description:* St
│ │ │ │ -0003bc60: 6f72 6520 7365 7175 656e 6365 206e 756d  ore sequence num
│ │ │ │ -0003bc70: 6265 7220 6669 656c 6420 696e 2045 6e63  ber field in Enc
│ │ │ │ -0003bc80: 4150 5265 7050 6172 742e 0a0a 2020 2020  APRepPart...    
│ │ │ │ -0003bc90: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ -0003bca0: 2052 6574 7572 6e73 20e2 8098 5348 4953   Returns ...SHIS
│ │ │ │ -0003bcb0: 4849 5f4f 4be2 8099 2069 6666 2073 7563  HI_OK... iff suc
│ │ │ │ -0003bcc0: 6365 7373 6675 6c2e 0a0a 7368 6973 6869  cessful...shishi
│ │ │ │ -0003bcd0: 5f65 6e63 6170 7265 7070 6172 745f 7469  _encapreppart_ti
│ │ │ │ -0003bce0: 6d65 5f63 6f70 790a 2d2d 2d2d 2d2d 2d2d  me_copy.--------
│ │ │ │ +0003bae0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ +0003baf0: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ +0003bb00: 6869 7368 695f 656e 6361 7072 6570 7061  hishi_encapreppa
│ │ │ │ +0003bb10: 7274 5f73 6571 6e75 6d62 6572 5f73 6574  rt_seqnumber_set
│ │ │ │ +0003bb20: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ +0003bb30: 452c 0a20 2020 2020 2020 2020 2053 6869  E,.          Shi
│ │ │ │ +0003bb40: 7368 695f 6173 6e31 2045 4e43 4150 5245  shi_asn1 ENCAPRE
│ │ │ │ +0003bb50: 5050 4152 542c 2075 696e 7433 325f 7420  PPART, uint32_t 
│ │ │ │ +0003bb60: 5345 514e 554d 4245 5229 0a20 2020 2020  SEQNUMBER).     
│ │ │ │ +0003bb70: 4841 4e44 4c45 3a20 7368 6973 6869 2068  HANDLE: shishi h
│ │ │ │ +0003bb80: 616e 646c 6520 6173 2061 6c6c 6f63 6174  andle as allocat
│ │ │ │ +0003bb90: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ +0003bba0: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ +0003bbb0: 454e 4341 5052 4550 5041 5254 3a20 656e  ENCAPREPPART: en
│ │ │ │ +0003bbc0: 6361 7072 6570 7061 7274 2061 7320 616c  capreppart as al
│ │ │ │ +0003bbd0: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ +0003bbe0: 6973 6869 5f65 6e63 6170 7265 7070 6172  ishi_encapreppar
│ │ │ │ +0003bbf0: 7428 29e2 8099 2e0a 0a20 2020 2020 5345  t()......     SE
│ │ │ │ +0003bc00: 514e 554d 4245 523a 2069 6e74 6567 6572  QNUMBER: integer
│ │ │ │ +0003bc10: 2077 6974 6820 7365 7175 656e 6365 206e   with sequence n
│ │ │ │ +0003bc20: 756d 6265 7220 6669 656c 6420 746f 2073  umber field to s
│ │ │ │ +0003bc30: 746f 7265 2069 6e0a 2020 2020 2065 6e63  tore in.     enc
│ │ │ │ +0003bc40: 6170 7265 7070 6172 742e 0a0a 2020 2020  apreppart...    
│ │ │ │ +0003bc50: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ +0003bc60: 5374 6f72 6520 7365 7175 656e 6365 206e  Store sequence n
│ │ │ │ +0003bc70: 756d 6265 7220 6669 656c 6420 696e 2045  umber field in E
│ │ │ │ +0003bc80: 6e63 4150 5265 7050 6172 742e 0a0a 2020  ncAPRepPart...  
│ │ │ │ +0003bc90: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ +0003bca0: 3a2a 2052 6574 7572 6e73 20e2 8098 5348  :* Returns ...SH
│ │ │ │ +0003bcb0: 4953 4849 5f4f 4be2 8099 2069 6666 2073  ISHI_OK... iff s
│ │ │ │ +0003bcc0: 7563 6365 7373 6675 6c2e 0a0a 7368 6973  uccessful...shis
│ │ │ │ +0003bcd0: 6869 5f65 6e63 6170 7265 7070 6172 745f  hi_encapreppart_
│ │ │ │ +0003bce0: 7469 6d65 5f63 6f70 790a 2d2d 2d2d 2d2d  time_copy.------
│ │ │ │  0003bcf0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0003bd00: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ -0003bd10: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ -0003bd20: 656e 6361 7072 6570 7061 7274 5f74 696d  encapreppart_tim
│ │ │ │ -0003bd30: 655f 636f 7079 2028 5368 6973 6869 202a  e_copy (Shishi *
│ │ │ │ -0003bd40: 2048 414e 444c 452c 0a20 2020 2020 2020   HANDLE,.       
│ │ │ │ -0003bd50: 2020 2053 6869 7368 695f 6173 6e31 2045     Shishi_asn1 E
│ │ │ │ -0003bd60: 4e43 4150 5245 5050 4152 542c 2053 6869  NCAPREPPART, Shi
│ │ │ │ -0003bd70: 7368 695f 6173 6e31 2041 5554 4845 4e54  shi_asn1 AUTHENT
│ │ │ │ -0003bd80: 4943 4154 4f52 290a 2020 2020 2048 414e  ICATOR).     HAN
│ │ │ │ -0003bd90: 444c 453a 2073 6869 7368 6920 6861 6e64  DLE: shishi hand
│ │ │ │ -0003bda0: 6c65 2061 7320 616c 6c6f 6361 7465 6420  le as allocated 
│ │ │ │ -0003bdb0: 6279 20e2 8098 7368 6973 6869 5f69 6e69  by ...shishi_ini
│ │ │ │ -0003bdc0: 7428 29e2 8099 2e0a 2020 2020 2045 4e43  t().....     ENC
│ │ │ │ -0003bdd0: 4150 5245 5050 4152 543a 2045 6e63 4150  APREPPART: EncAP
│ │ │ │ -0003bde0: 5265 7050 6172 7420 6173 2061 6c6c 6f63  RepPart as alloc
│ │ │ │ -0003bdf0: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ -0003be00: 695f 656e 6361 7072 6570 7061 7274 2829  i_encapreppart()
│ │ │ │ -0003be10: e280 992e 0a0a 2020 2020 2041 5554 4845  ......     AUTHE
│ │ │ │ -0003be20: 4e54 4943 4154 4f52 3a20 4175 7468 656e  NTICATOR: Authen
│ │ │ │ -0003be30: 7469 6361 746f 7220 746f 2063 6f70 7920  ticator to copy 
│ │ │ │ -0003be40: 7469 6d65 2066 6965 6c64 7320 6672 6f6d  time fields from
│ │ │ │ -0003be50: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ -0003be60: 7469 6f6e 3a2a 2043 6f70 7920 7469 6d65  tion:* Copy time
│ │ │ │ -0003be70: 2066 6965 6c64 7320 6672 6f6d 2041 7574   fields from Aut
│ │ │ │ -0003be80: 6865 6e74 6963 6174 6f72 2069 6e74 6f0a  henticator into.
│ │ │ │ -0003be90: 2020 2020 2045 6e63 4150 5265 7050 6172       EncAPRepPar
│ │ │ │ -0003bea0: 742e 0a0a 2020 2020 202a 5265 7475 726e  t...     *Return
│ │ │ │ -0003beb0: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ -0003bec0: 2053 4849 5348 495f 4f4b 2069 6666 2073   SHISHI_OK iff s
│ │ │ │ -0003bed0: 7563 6365 7373 6675 6c2e 0a0a 1f0a 4669  uccessful.....Fi
│ │ │ │ -0003bee0: 6c65 3a20 7368 6973 6869 2e69 6e66 6f2c  le: shishi.info,
│ │ │ │ -0003bef0: 2020 4e6f 6465 3a20 5341 4645 2061 6e64    Node: SAFE and
│ │ │ │ -0003bf00: 2050 5249 5620 4675 6e63 7469 6f6e 732c   PRIV Functions,
│ │ │ │ -0003bf10: 2020 4e65 7874 3a20 5469 636b 6574 2046    Next: Ticket F
│ │ │ │ -0003bf20: 756e 6374 696f 6e73 2c20 2050 7265 763a  unctions,  Prev:
│ │ │ │ -0003bf30: 2041 502d 5245 5120 616e 6420 4150 2d52   AP-REQ and AP-R
│ │ │ │ -0003bf40: 4550 2046 756e 6374 696f 6e73 2c20 2055  EP Functions,  U
│ │ │ │ -0003bf50: 703a 2050 726f 6772 616d 6d69 6e67 204d  p: Programming M
│ │ │ │ -0003bf60: 616e 7561 6c0a 0a35 2e35 2053 4146 4520  anual..5.5 SAFE 
│ │ │ │ -0003bf70: 616e 6420 5052 4956 2046 756e 6374 696f  and PRIV Functio
│ │ │ │ -0003bf80: 6e73 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ns.=============
│ │ │ │ -0003bf90: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a  ==============..
│ │ │ │ -0003bfa0: 5468 6520 224b 5242 2d53 4146 4522 2069  The "KRB-SAFE" i
│ │ │ │ -0003bfb0: 7320 616e 2041 534e 2e31 2073 7472 7563  s an ASN.1 struc
│ │ │ │ -0003bfc0: 7475 7265 2075 7365 6420 6279 2061 7070  ture used by app
│ │ │ │ -0003bfd0: 6c69 6361 7469 6f6e 2063 6c69 656e 7420  lication client 
│ │ │ │ -0003bfe0: 616e 640a 7365 7276 6572 7320 746f 2065  and.servers to e
│ │ │ │ -0003bff0: 7863 6861 6e67 6520 696e 7465 6772 6974  xchange integrit
│ │ │ │ -0003c000: 7920 7072 6f74 6563 7465 6420 6461 7461  y protected data
│ │ │ │ -0003c010: 2e20 2054 6865 2069 6e74 6567 7269 7479  .  The integrity
│ │ │ │ -0003c020: 2070 726f 7465 6374 696f 6e0a 6973 206b   protection.is k
│ │ │ │ -0003c030: 6579 6564 2c20 7573 7561 6c6c 7920 7769  eyed, usually wi
│ │ │ │ -0003c040: 7468 2061 206b 6579 2061 6772 6565 6420  th a key agreed 
│ │ │ │ -0003c050: 6f6e 2076 6961 2074 6865 2041 5020 6578  on via the AP ex
│ │ │ │ -0003c060: 6368 616e 6765 2028 2a6e 6f74 6520 4150  change (*note AP
│ │ │ │ -0003c070: 2d52 4551 0a61 6e64 2041 502d 5245 5020  -REQ.and AP-REP 
│ │ │ │ -0003c080: 4675 6e63 7469 6f6e 733a 3a29 2e20 2054  Functions::).  T
│ │ │ │ -0003c090: 6865 2066 6f6c 6c6f 7769 6e67 2069 6c6c  he following ill
│ │ │ │ -0003c0a0: 7573 7472 6174 6573 2074 6865 204b 5242  ustrates the KRB
│ │ │ │ -0003c0b0: 2d53 4146 4520 4153 4e2e 310a 7374 7275  -SAFE ASN.1.stru
│ │ │ │ -0003c0c0: 6374 7572 652e 0a0a 2020 204b 5242 2d53  cture...   KRB-S
│ │ │ │ -0003c0d0: 4146 4520 2020 2020 2020 203a 3a3d 205b  AFE        ::= [
│ │ │ │ -0003c0e0: 4150 504c 4943 4154 494f 4e20 3230 5d20  APPLICATION 20] 
│ │ │ │ -0003c0f0: 5345 5155 454e 4345 207b 0a20 2020 2020  SEQUENCE {.     
│ │ │ │ -0003c100: 2020 2020 2020 7076 6e6f 2020 2020 2020        pvno      
│ │ │ │ -0003c110: 2020 2020 2020 5b30 5d20 494e 5445 4745        [0] INTEGE
│ │ │ │ -0003c120: 5220 2835 292c 0a20 2020 2020 2020 2020  R (5),.         
│ │ │ │ -0003c130: 2020 6d73 672d 7479 7065 2020 2020 2020    msg-type      
│ │ │ │ -0003c140: 2020 5b31 5d20 494e 5445 4745 5220 2832    [1] INTEGER (2
│ │ │ │ -0003c150: 3029 2c0a 2020 2020 2020 2020 2020 2073  0),.           s
│ │ │ │ -0003c160: 6166 652d 626f 6479 2020 2020 2020 205b  afe-body       [
│ │ │ │ -0003c170: 325d 204b 5242 2d53 4146 452d 424f 4459  2] KRB-SAFE-BODY
│ │ │ │ -0003c180: 2c0a 2020 2020 2020 2020 2020 2063 6b73  ,.           cks
│ │ │ │ -0003c190: 756d 2020 2020 2020 2020 2020 205b 335d  um           [3]
│ │ │ │ -0003c1a0: 2043 6865 636b 7375 6d0a 2020 207d 0a0a   Checksum.   }..
│ │ │ │ -0003c1b0: 2020 204b 5242 2d53 4146 452d 424f 4459     KRB-SAFE-BODY
│ │ │ │ -0003c1c0: 2020 203a 3a3d 2053 4551 5545 4e43 4520     ::= SEQUENCE 
│ │ │ │ -0003c1d0: 7b0a 2020 2020 2020 2020 2020 2075 7365  {.           use
│ │ │ │ -0003c1e0: 722d 6461 7461 2020 2020 2020 205b 305d  r-data       [0]
│ │ │ │ -0003c1f0: 204f 4354 4554 2053 5452 494e 472c 0a20   OCTET STRING,. 
│ │ │ │ -0003c200: 2020 2020 2020 2020 2020 7469 6d65 7374            timest
│ │ │ │ -0003c210: 616d 7020 2020 2020 2020 5b31 5d20 4b65  amp       [1] Ke
│ │ │ │ -0003c220: 7262 6572 6f73 5469 6d65 204f 5054 494f  rberosTime OPTIO
│ │ │ │ -0003c230: 4e41 4c2c 0a20 2020 2020 2020 2020 2020  NAL,.           
│ │ │ │ -0003c240: 7573 6563 2020 2020 2020 2020 2020 2020  usec            
│ │ │ │ -0003c250: 5b32 5d20 4d69 6372 6f73 6563 6f6e 6473  [2] Microseconds
│ │ │ │ -0003c260: 204f 5054 494f 4e41 4c2c 0a20 2020 2020   OPTIONAL,.     
│ │ │ │ -0003c270: 2020 2020 2020 7365 712d 6e75 6d62 6572        seq-number
│ │ │ │ -0003c280: 2020 2020 2020 5b33 5d20 5549 6e74 3332        [3] UInt32
│ │ │ │ -0003c290: 204f 5054 494f 4e41 4c2c 0a20 2020 2020   OPTIONAL,.     
│ │ │ │ -0003c2a0: 2020 2020 2020 732d 6164 6472 6573 7320        s-address 
│ │ │ │ -0003c2b0: 2020 2020 2020 5b34 5d20 486f 7374 4164        [4] HostAd
│ │ │ │ -0003c2c0: 6472 6573 732c 0a20 2020 2020 2020 2020  dress,.         
│ │ │ │ -0003c2d0: 2020 722d 6164 6472 6573 7320 2020 2020    r-address     
│ │ │ │ -0003c2e0: 2020 5b35 5d20 486f 7374 4164 6472 6573    [5] HostAddres
│ │ │ │ -0003c2f0: 7320 4f50 5449 4f4e 414c 0a20 2020 7d0a  s OPTIONAL.   }.
│ │ │ │ -0003c300: 0a73 6869 7368 695f 7361 6665 0a2d 2d2d  .shishi_safe.---
│ │ │ │ -0003c310: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -0003c320: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ -0003c330: 6869 5f73 6166 6520 2853 6869 7368 6920  hi_safe (Shishi 
│ │ │ │ -0003c340: 2a20 4841 4e44 4c45 2c20 5368 6973 6869  * HANDLE, Shishi
│ │ │ │ -0003c350: 5f73 6166 6520 2a2a 2053 4146 4529 0a20  _safe ** SAFE). 
│ │ │ │ -0003c360: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ -0003c370: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ -0003c380: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ -0003c390: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ -0003c3a0: 2020 2020 5341 4645 3a20 706f 696e 7465      SAFE: pointe
│ │ │ │ -0003c3b0: 7220 746f 206e 6577 2073 7472 7563 7475  r to new structu
│ │ │ │ -0003c3c0: 7265 2074 6861 7420 686f 6c64 7320 696e  re that holds in
│ │ │ │ -0003c3d0: 666f 726d 6174 696f 6e20 6162 6f75 7420  formation about 
│ │ │ │ -0003c3e0: 5341 4645 0a20 2020 2020 6578 6368 616e  SAFE.     exchan
│ │ │ │ -0003c3f0: 6765 0a0a 2020 2020 202a 4465 7363 7269  ge..     *Descri
│ │ │ │ -0003c400: 7074 696f 6e3a 2a20 4372 6561 7465 2061  ption:* Create a
│ │ │ │ -0003c410: 206e 6577 2053 4146 4520 6578 6368 616e   new SAFE exchan
│ │ │ │ -0003c420: 6765 2e0a 0a20 2020 2020 2a52 6574 7572  ge...     *Retur
│ │ │ │ -0003c430: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ -0003c440: 7320 5348 4953 4849 5f4f 4b20 6966 6620  s SHISHI_OK iff 
│ │ │ │ -0003c450: 7375 6363 6573 7366 756c 2e0a 0a73 6869  successful...shi
│ │ │ │ -0003c460: 7368 695f 7361 6665 5f64 6f6e 650a 2d2d  shi_safe_done.--
│ │ │ │ -0003c470: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -0003c480: 202d 2d20 4675 6e63 7469 6f6e 3a20 766f   -- Function: vo
│ │ │ │ -0003c490: 6964 2073 6869 7368 695f 7361 6665 5f64  id shishi_safe_d
│ │ │ │ -0003c4a0: 6f6e 6520 2853 6869 7368 695f 7361 6665  one (Shishi_safe
│ │ │ │ -0003c4b0: 202a 2053 4146 4529 0a20 2020 2020 5341   * SAFE).     SA
│ │ │ │ -0003c4c0: 4645 3a20 7374 7275 6374 7572 6520 7468  FE: structure th
│ │ │ │ -0003c4d0: 6174 2068 6f6c 6473 2069 6e66 6f72 6d61  at holds informa
│ │ │ │ -0003c4e0: 7469 6f6e 2061 626f 7574 2053 4146 4520  tion about SAFE 
│ │ │ │ -0003c4f0: 6578 6368 616e 6765 0a0a 2020 2020 202a  exchange..     *
│ │ │ │ -0003c500: 4465 7363 7269 7074 696f 6e3a 2a20 4465  Description:* De
│ │ │ │ -0003c510: 616c 6c6f 6361 7465 2072 6573 6f75 7263  allocate resourc
│ │ │ │ -0003c520: 6573 2061 7373 6f63 6961 7465 6420 7769  es associated wi
│ │ │ │ -0003c530: 7468 2053 4146 4520 6578 6368 616e 6765  th SAFE exchange
│ │ │ │ -0003c540: 2e0a 2020 2020 2054 6869 7320 7368 6f75  ..     This shou
│ │ │ │ -0003c550: 6c64 2062 6520 6361 6c6c 6564 2062 7920  ld be called by 
│ │ │ │ -0003c560: 7468 6520 6170 706c 6963 6174 696f 6e20  the application 
│ │ │ │ -0003c570: 7768 656e 2069 7420 6e6f 206c 6f6e 6765  when it no longe
│ │ │ │ -0003c580: 7220 6e65 6564 2074 6f0a 2020 2020 2075  r need to.     u
│ │ │ │ -0003c590: 7469 6c69 7a65 2074 6865 2053 4146 4520  tilize the SAFE 
│ │ │ │ -0003c5a0: 6578 6368 616e 6765 2068 616e 646c 652e  exchange handle.
│ │ │ │ -0003c5b0: 0a0a 7368 6973 6869 5f73 6166 655f 6b65  ..shishi_safe_ke
│ │ │ │ -0003c5c0: 790a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  y.--------------
│ │ │ │ -0003c5d0: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ -0003c5e0: 2053 6869 7368 695f 6b65 7920 2a20 7368   Shishi_key * sh
│ │ │ │ -0003c5f0: 6973 6869 5f73 6166 655f 6b65 7920 2853  ishi_safe_key (S
│ │ │ │ -0003c600: 6869 7368 695f 7361 6665 202a 2053 4146  hishi_safe * SAF
│ │ │ │ -0003c610: 4529 0a20 2020 2020 5341 4645 3a20 7374  E).     SAFE: st
│ │ │ │ -0003c620: 7275 6374 7572 6520 7468 6174 2068 6f6c  ructure that hol
│ │ │ │ -0003c630: 6473 2069 6e66 6f72 6d61 7469 6f6e 2061  ds information a
│ │ │ │ -0003c640: 626f 7574 2053 4146 4520 6578 6368 616e  bout SAFE exchan
│ │ │ │ -0003c650: 6765 0a0a 2020 2020 202a 4465 7363 7269  ge..     *Descri
│ │ │ │ -0003c660: 7074 696f 6e3a 2a20 4765 7420 6b65 7920  ption:* Get key 
│ │ │ │ -0003c670: 7374 7275 6374 7572 6564 2066 726f 6d20  structured from 
│ │ │ │ -0003c680: 5341 4645 2065 7863 6861 6e67 652e 0a0a  SAFE exchange...
│ │ │ │ -0003c690: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ -0003c6a0: 7565 3a2a 2052 6574 7572 6e73 2074 6865  ue:* Returns the
│ │ │ │ -0003c6b0: 206b 6579 2075 7365 6420 696e 2074 6865   key used in the
│ │ │ │ -0003c6c0: 2053 4146 4520 6578 6368 616e 6765 2c20   SAFE exchange, 
│ │ │ │ -0003c6d0: 6f72 204e 554c 4c0a 2020 2020 2069 6620  or NULL.     if 
│ │ │ │ -0003c6e0: 6e6f 7420 7965 7420 7365 7420 6f72 2061  not yet set or a
│ │ │ │ -0003c6f0: 6e20 6572 726f 7220 6f63 6375 7265 642e  n error occured.
│ │ │ │ -0003c700: 0a0a 7368 6973 6869 5f73 6166 655f 6b65  ..shishi_safe_ke
│ │ │ │ -0003c710: 795f 7365 740a 2d2d 2d2d 2d2d 2d2d 2d2d  y_set.----------
│ │ │ │ -0003c720: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ -0003c730: 756e 6374 696f 6e3a 2076 6f69 6420 7368  unction: void sh
│ │ │ │ -0003c740: 6973 6869 5f73 6166 655f 6b65 795f 7365  ishi_safe_key_se
│ │ │ │ -0003c750: 7420 2853 6869 7368 695f 7361 6665 202a  t (Shishi_safe *
│ │ │ │ -0003c760: 2053 4146 452c 0a20 2020 2020 2020 2020   SAFE,.         
│ │ │ │ -0003c770: 2053 6869 7368 695f 6b65 7920 2a20 4b45   Shishi_key * KE
│ │ │ │ -0003c780: 5929 0a20 2020 2020 5341 4645 3a20 7374  Y).     SAFE: st
│ │ │ │ -0003c790: 7275 6374 7572 6520 7468 6174 2068 6f6c  ructure that hol
│ │ │ │ -0003c7a0: 6473 2069 6e66 6f72 6d61 7469 6f6e 2061  ds information a
│ │ │ │ -0003c7b0: 626f 7574 2053 4146 4520 6578 6368 616e  bout SAFE exchan
│ │ │ │ -0003c7c0: 6765 0a20 2020 2020 4b45 593a 206b 6579  ge.     KEY: key
│ │ │ │ -0003c7d0: 2074 6f20 7374 6f72 6520 696e 2053 4146   to store in SAF
│ │ │ │ -0003c7e0: 452e 0a0a 2020 2020 202a 4465 7363 7269  E...     *Descri
│ │ │ │ -0003c7f0: 7074 696f 6e3a 2a20 5365 7420 7468 6520  ption:* Set the 
│ │ │ │ -0003c800: 4b65 7920 696e 2074 6865 2053 4146 4520  Key in the SAFE 
│ │ │ │ -0003c810: 6578 6368 616e 6765 2e0a 0a73 6869 7368  exchange...shish
│ │ │ │ -0003c820: 695f 7361 6665 5f73 6166 650a 2d2d 2d2d  i_safe_safe.----
│ │ │ │ -0003c830: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ -0003c840: 2d20 4675 6e63 7469 6f6e 3a20 5368 6973  - Function: Shis
│ │ │ │ -0003c850: 6869 5f61 736e 3120 7368 6973 6869 5f73  hi_asn1 shishi_s
│ │ │ │ -0003c860: 6166 655f 7361 6665 2028 5368 6973 6869  afe_safe (Shishi
│ │ │ │ -0003c870: 5f73 6166 6520 2a20 5341 4645 290a 2020  _safe * SAFE).  
│ │ │ │ -0003c880: 2020 2053 4146 453a 2073 7472 7563 7475     SAFE: structu
│ │ │ │ -0003c890: 7265 2074 6861 7420 686f 6c64 7320 696e  re that holds in
│ │ │ │ -0003c8a0: 666f 726d 6174 696f 6e20 6162 6f75 7420  formation about 
│ │ │ │ -0003c8b0: 5341 4645 2065 7863 6861 6e67 650a 0a20  SAFE exchange.. 
│ │ │ │ -0003c8c0: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -0003c8d0: 3a2a 2047 6574 2041 534e 2e31 2053 4146  :* Get ASN.1 SAF
│ │ │ │ -0003c8e0: 4520 7374 7275 6374 7572 6564 2066 726f  E structured fro
│ │ │ │ -0003c8f0: 6d20 5341 4645 2065 7863 6861 6e67 652e  m SAFE exchange.
│ │ │ │ -0003c900: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ -0003c910: 616c 7565 3a2a 2052 6574 7572 6e73 2074  alue:* Returns t
│ │ │ │ -0003c920: 6865 2041 534e 2e31 2073 6166 6520 696e  he ASN.1 safe in
│ │ │ │ -0003c930: 2074 6865 2053 4146 4520 6578 6368 616e   the SAFE exchan
│ │ │ │ -0003c940: 6765 2c20 6f72 0a20 2020 2020 4e55 4c4c  ge, or.     NULL
│ │ │ │ -0003c950: 2069 6620 6e6f 7420 7965 7420 7365 7420   if not yet set 
│ │ │ │ -0003c960: 6f72 2061 6e20 6572 726f 7220 6f63 6375  or an error occu
│ │ │ │ -0003c970: 7265 642e 0a0a 7368 6973 6869 5f73 6166  red...shishi_saf
│ │ │ │ -0003c980: 655f 7361 6665 5f73 6574 0a2d 2d2d 2d2d  e_safe_set.-----
│ │ │ │ -0003c990: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -0003c9a0: 0a20 2d2d 2046 756e 6374 696f 6e3a 2076  . -- Function: v
│ │ │ │ -0003c9b0: 6f69 6420 7368 6973 6869 5f73 6166 655f  oid shishi_safe_
│ │ │ │ -0003c9c0: 7361 6665 5f73 6574 2028 5368 6973 6869  safe_set (Shishi
│ │ │ │ -0003c9d0: 5f73 6166 6520 2a20 5341 4645 2c0a 2020  _safe * SAFE,.  
│ │ │ │ -0003c9e0: 2020 2020 2020 2020 5368 6973 6869 5f61          Shishi_a
│ │ │ │ -0003c9f0: 736e 3120 4153 4e31 5341 4645 290a 2020  sn1 ASN1SAFE).  
│ │ │ │ -0003ca00: 2020 2053 4146 453a 2073 7472 7563 7475     SAFE: structu
│ │ │ │ -0003ca10: 7265 2074 6861 7420 686f 6c64 7320 696e  re that holds in
│ │ │ │ -0003ca20: 666f 726d 6174 696f 6e20 6162 6f75 7420  formation about 
│ │ │ │ -0003ca30: 5341 4645 2065 7863 6861 6e67 650a 2020  SAFE exchange.  
│ │ │ │ -0003ca40: 2020 2041 534e 3153 4146 453a 204b 5242     ASN1SAFE: KRB
│ │ │ │ -0003ca50: 2d53 4146 4520 746f 2073 746f 7265 2069  -SAFE to store i
│ │ │ │ -0003ca60: 6e20 5341 4645 2065 7863 6861 6e67 652e  n SAFE exchange.
│ │ │ │ -0003ca70: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ -0003ca80: 696f 6e3a 2a20 5365 7420 7468 6520 4b52  ion:* Set the KR
│ │ │ │ -0003ca90: 422d 5341 4645 2069 6e20 7468 6520 5341  B-SAFE in the SA
│ │ │ │ -0003caa0: 4645 2065 7863 6861 6e67 652e 0a0a 7368  FE exchange...sh
│ │ │ │ -0003cab0: 6973 6869 5f73 6166 655f 7361 6665 5f64  ishi_safe_safe_d
│ │ │ │ -0003cac0: 6572 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  er.-------------
│ │ │ │ -0003cad0: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ -0003cae0: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ -0003caf0: 695f 7361 6665 5f73 6166 655f 6465 7220  i_safe_safe_der 
│ │ │ │ -0003cb00: 2853 6869 7368 695f 7361 6665 202a 2053  (Shishi_safe * S
│ │ │ │ -0003cb10: 4146 452c 2063 6861 7220 2a2a 204f 5554  AFE, char ** OUT
│ │ │ │ -0003cb20: 2c0a 2020 2020 2020 2020 2020 7369 7a65  ,.          size
│ │ │ │ -0003cb30: 5f74 202a 204f 5554 4c45 4e29 0a20 2020  _t * OUTLEN).   
│ │ │ │ -0003cb40: 2020 5341 4645 3a20 7361 6665 2061 7320    SAFE: safe as 
│ │ │ │ -0003cb50: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ -0003cb60: 7368 6973 6869 5f73 6166 6528 29e2 8099  shishi_safe()...
│ │ │ │ -0003cb70: 2e0a 2020 2020 204f 5554 3a20 6f75 7470  ..     OUT: outp
│ │ │ │ -0003cb80: 7574 2061 7272 6179 2077 6974 6820 6e65  ut array with ne
│ │ │ │ -0003cb90: 776c 7920 616c 6c6f 6361 7465 6420 4445  wly allocated DE
│ │ │ │ -0003cba0: 5220 656e 636f 6469 6e67 206f 6620 5341  R encoding of SA
│ │ │ │ -0003cbb0: 4645 2e0a 2020 2020 204f 5554 4c45 4e3a  FE..     OUTLEN:
│ │ │ │ -0003cbc0: 206c 656e 6774 6820 6f66 206f 7574 7075   length of outpu
│ │ │ │ -0003cbd0: 7420 6172 7261 7920 7769 7468 2044 4552  t array with DER
│ │ │ │ -0003cbe0: 2065 6e63 6f64 696e 6720 6f66 2053 4146   encoding of SAF
│ │ │ │ -0003cbf0: 452e 0a0a 2020 2020 202a 4465 7363 7269  E...     *Descri
│ │ │ │ -0003cc00: 7074 696f 6e3a 2a20 4445 5220 656e 636f  ption:* DER enco
│ │ │ │ -0003cc10: 6465 2053 4146 4520 7374 7275 6374 7572  de SAFE structur
│ │ │ │ -0003cc20: 652e 2020 5479 7069 6361 6c6c 790a 2020  e.  Typically.  
│ │ │ │ -0003cc30: 2020 20e2 8098 7368 6973 6869 5f73 6166     ...shishi_saf
│ │ │ │ -0003cc40: 655f 6275 696c 6428 29e2 8099 2069 7320  e_build()... is 
│ │ │ │ -0003cc50: 7573 6564 2074 6f20 6275 696c 6420 7468  used to build th
│ │ │ │ -0003cc60: 6520 5341 4645 2073 7472 7563 7475 7265  e SAFE structure
│ │ │ │ -0003cc70: 2066 6972 7374 2e0a 2020 2020 204f 5554   first..     OUT
│ │ │ │ -0003cc80: 2069 7320 616c 6c6f 6361 7465 6420 6279   is allocated by
│ │ │ │ -0003cc90: 2074 6869 7320 6675 6e63 7469 6f6e 2c20   this function, 
│ │ │ │ -0003cca0: 616e 6420 6974 2069 7320 7468 6520 7265  and it is the re
│ │ │ │ -0003ccb0: 7370 6f6e 7369 6269 6c69 7479 206f 660a  sponsibility of.
│ │ │ │ -0003ccc0: 2020 2020 2063 616c 6c65 7220 746f 2064       caller to d
│ │ │ │ -0003ccd0: 6561 6c6c 6f63 6174 6520 6974 2e0a 0a20  eallocate it... 
│ │ │ │ -0003cce0: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ -0003ccf0: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ -0003cd00: 4849 5f4f 4b20 6966 6620 7375 6363 6573  HI_OK iff succes
│ │ │ │ -0003cd10: 7366 756c 2e0a 0a73 6869 7368 695f 7361  sful...shishi_sa
│ │ │ │ -0003cd20: 6665 5f73 6166 655f 6465 725f 7365 740a  fe_safe_der_set.
│ │ │ │ -0003cd30: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0003cd40: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -0003cd50: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ -0003cd60: 6869 5f73 6166 655f 7361 6665 5f64 6572  hi_safe_safe_der
│ │ │ │ -0003cd70: 5f73 6574 2028 5368 6973 6869 5f73 6166  _set (Shishi_saf
│ │ │ │ -0003cd80: 6520 2a20 5341 4645 2c0a 2020 2020 2020  e * SAFE,.      
│ │ │ │ -0003cd90: 2020 2020 6368 6172 202a 2044 4552 2c20      char * DER, 
│ │ │ │ -0003cda0: 7369 7a65 5f74 2044 4552 4c45 4e29 0a20  size_t DERLEN). 
│ │ │ │ -0003cdb0: 2020 2020 5341 4645 3a20 7361 6665 2061      SAFE: safe a
│ │ │ │ -0003cdc0: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ -0003cdd0: 8098 7368 6973 6869 5f73 6166 6528 29e2  ..shishi_safe().
│ │ │ │ -0003cde0: 8099 2e0a 2020 2020 2044 4552 3a20 696e  ....     DER: in
│ │ │ │ -0003cdf0: 7075 7420 6172 7261 7920 7769 7468 2044  put array with D
│ │ │ │ -0003ce00: 4552 2065 6e63 6f64 6564 204b 5242 2d53  ER encoded KRB-S
│ │ │ │ -0003ce10: 4146 452e 0a20 2020 2020 4445 524c 454e  AFE..     DERLEN
│ │ │ │ -0003ce20: 3a20 6c65 6e67 7468 206f 6620 696e 7075  : length of inpu
│ │ │ │ -0003ce30: 7420 6172 7261 7920 7769 7468 2044 4552  t array with DER
│ │ │ │ -0003ce40: 2065 6e63 6f64 6564 204b 5242 2d53 4146   encoded KRB-SAF
│ │ │ │ -0003ce50: 452e 0a0a 2020 2020 202a 4465 7363 7269  E...     *Descri
│ │ │ │ -0003ce60: 7074 696f 6e3a 2a20 4445 5220 6465 636f  ption:* DER deco
│ │ │ │ -0003ce70: 6465 204b 5242 2d53 4146 4520 616e 6420  de KRB-SAFE and 
│ │ │ │ -0003ce80: 7365 7420 6974 2053 4146 4520 6578 6368  set it SAFE exch
│ │ │ │ -0003ce90: 616e 6765 2e20 2049 660a 2020 2020 2064  ange.  If.     d
│ │ │ │ -0003cea0: 6563 6f64 696e 6720 6661 696c 732c 2074  ecoding fails, t
│ │ │ │ -0003ceb0: 6865 204b 5242 2d53 4146 4520 696e 2074  he KRB-SAFE in t
│ │ │ │ -0003cec0: 6865 2053 4146 4520 6578 6368 616e 6765  he SAFE exchange
│ │ │ │ -0003ced0: 2072 656d 6169 6e73 2e0a 0a20 2020 2020   remains...     
│ │ │ │ -0003cee0: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ -0003cef0: 5265 7475 726e 7320 5348 4953 4849 5f4f  Returns SHISHI_O
│ │ │ │ -0003cf00: 4b2e 0a0a 7368 6973 6869 5f73 6166 655f  K...shishi_safe_
│ │ │ │ -0003cf10: 7072 696e 740a 2d2d 2d2d 2d2d 2d2d 2d2d  print.----------
│ │ │ │ -0003cf20: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ -0003cf30: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ -0003cf40: 695f 7361 6665 5f70 7269 6e74 2028 5368  i_safe_print (Sh
│ │ │ │ -0003cf50: 6973 6869 202a 2048 414e 444c 452c 2046  ishi * HANDLE, F
│ │ │ │ -0003cf60: 494c 4520 2a20 4648 2c0a 2020 2020 2020  ILE * FH,.      
│ │ │ │ -0003cf70: 2020 2020 5368 6973 6869 5f61 736e 3120      Shishi_asn1 
│ │ │ │ -0003cf80: 5341 4645 290a 2020 2020 2048 414e 444c  SAFE).     HANDL
│ │ │ │ -0003cf90: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ -0003cfa0: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ -0003cfb0: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ -0003cfc0: 29e2 8099 2e0a 2020 2020 2046 483a 2066  ).....     FH: f
│ │ │ │ -0003cfd0: 696c 6520 6861 6e64 6c65 206f 7065 6e20  ile handle open 
│ │ │ │ -0003cfe0: 666f 7220 7772 6974 696e 672e 0a20 2020  for writing..   
│ │ │ │ -0003cff0: 2020 5341 4645 3a20 5341 4645 2074 6f20    SAFE: SAFE to 
│ │ │ │ -0003d000: 7072 696e 742e 0a0a 2020 2020 202a 4465  print...     *De
│ │ │ │ -0003d010: 7363 7269 7074 696f 6e3a 2a20 5072 696e  scription:* Prin
│ │ │ │ -0003d020: 7420 4153 4349 4920 6172 6d6f 7265 6420  t ASCII armored 
│ │ │ │ -0003d030: 4445 5220 656e 636f 6469 6e67 206f 6620  DER encoding of 
│ │ │ │ -0003d040: 5341 4645 2074 6f20 6669 6c65 2e0a 0a20  SAFE to file... 
│ │ │ │ -0003d050: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ -0003d060: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ -0003d070: 4849 5f4f 4b20 6966 6620 7375 6363 6573  HI_OK iff succes
│ │ │ │ -0003d080: 7366 756c 2e0a 0a73 6869 7368 695f 7361  sful...shishi_sa
│ │ │ │ -0003d090: 6665 5f73 6176 650a 2d2d 2d2d 2d2d 2d2d  fe_save.--------
│ │ │ │ -0003d0a0: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -0003d0b0: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ -0003d0c0: 6869 5f73 6166 655f 7361 7665 2028 5368  hi_safe_save (Sh
│ │ │ │ -0003d0d0: 6973 6869 202a 2048 414e 444c 452c 2046  ishi * HANDLE, F
│ │ │ │ -0003d0e0: 494c 4520 2a20 4648 2c0a 2020 2020 2020  ILE * FH,.      
│ │ │ │ -0003d0f0: 2020 2020 5368 6973 6869 5f61 736e 3120      Shishi_asn1 
│ │ │ │ -0003d100: 5341 4645 290a 2020 2020 2048 414e 444c  SAFE).     HANDL
│ │ │ │ -0003d110: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ -0003d120: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ -0003d130: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ -0003d140: 29e2 8099 2e0a 2020 2020 2046 483a 2066  ).....     FH: f
│ │ │ │ -0003d150: 696c 6520 6861 6e64 6c65 206f 7065 6e20  ile handle open 
│ │ │ │ -0003d160: 666f 7220 7772 6974 696e 672e 0a20 2020  for writing..   
│ │ │ │ -0003d170: 2020 5341 4645 3a20 5341 4645 2074 6f20    SAFE: SAFE to 
│ │ │ │ -0003d180: 7361 7665 2e0a 0a20 2020 2020 2a44 6573  save...     *Des
│ │ │ │ -0003d190: 6372 6970 7469 6f6e 3a2a 2053 6176 6520  cription:* Save 
│ │ │ │ -0003d1a0: 4445 5220 656e 636f 6469 6e67 206f 6620  DER encoding of 
│ │ │ │ -0003d1b0: 5341 4645 2074 6f20 6669 6c65 2e0a 0a20  SAFE to file... 
│ │ │ │ -0003d1c0: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ -0003d1d0: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ -0003d1e0: 4849 5f4f 4b20 6966 6620 7375 6363 6573  HI_OK iff succes
│ │ │ │ -0003d1f0: 7366 756c 2e0a 0a73 6869 7368 695f 7361  sful...shishi_sa
│ │ │ │ -0003d200: 6665 5f74 6f5f 6669 6c65 0a2d 2d2d 2d2d  fe_to_file.-----
│ │ │ │ -0003d210: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -0003d220: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ -0003d230: 7420 7368 6973 6869 5f73 6166 655f 746f  t shishi_safe_to
│ │ │ │ -0003d240: 5f66 696c 6520 2853 6869 7368 6920 2a20  _file (Shishi * 
│ │ │ │ -0003d250: 4841 4e44 4c45 2c0a 2020 2020 2020 2020  HANDLE,.        
│ │ │ │ -0003d260: 2020 5368 6973 6869 5f61 736e 3120 5341    Shishi_asn1 SA
│ │ │ │ -0003d270: 4645 2c20 696e 7420 4649 4c45 5459 5045  FE, int FILETYPE
│ │ │ │ -0003d280: 2c20 636f 6e73 7420 6368 6172 202a 2046  , const char * F
│ │ │ │ -0003d290: 494c 454e 414d 4529 0a20 2020 2020 4841  ILENAME).     HA
│ │ │ │ -0003d2a0: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ -0003d2b0: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ -0003d2c0: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ -0003d2d0: 6974 2829 e280 992e 0a20 2020 2020 5341  it().....     SA
│ │ │ │ -0003d2e0: 4645 3a20 5341 4645 2074 6f20 7361 7665  FE: SAFE to save
│ │ │ │ -0003d2f0: 2e0a 2020 2020 2046 494c 4554 5950 453a  ..     FILETYPE:
│ │ │ │ -0003d300: 2069 6e70 7574 2076 6172 6961 626c 6520   input variable 
│ │ │ │ -0003d310: 7370 6563 6966 7969 6e67 2074 7970 6520  specifying type 
│ │ │ │ -0003d320: 6f66 2066 696c 6520 746f 2062 6520 7772  of file to be wr
│ │ │ │ -0003d330: 6974 7465 6e2c 2073 6565 0a20 2020 2020  itten, see.     
│ │ │ │ -0003d340: 5368 6973 6869 5f66 696c 6574 7970 652e  Shishi_filetype.
│ │ │ │ -0003d350: 0a20 2020 2020 4649 4c45 4e41 4d45 3a20  .     FILENAME: 
│ │ │ │ -0003d360: 696e 7075 7420 7661 7269 6162 6c65 2077  input variable w
│ │ │ │ -0003d370: 6974 6820 6669 6c65 6e61 6d65 2074 6f20  ith filename to 
│ │ │ │ -0003d380: 7772 6974 6520 746f 2e0a 0a20 2020 2020  write to...     
│ │ │ │ -0003d390: 2a44 6573 6372 6970 7469 6f6e 3a2a 2057  *Description:* W
│ │ │ │ -0003d3a0: 7269 7465 2053 4146 4520 746f 2066 696c  rite SAFE to fil
│ │ │ │ -0003d3b0: 6520 696e 2073 7065 6369 6669 6564 2054  e in specified T
│ │ │ │ -0003d3c0: 5950 452e 2054 6865 2066 696c 6520 7769  YPE. The file wi
│ │ │ │ -0003d3d0: 6c6c 0a20 2020 2020 6265 2074 7275 6e63  ll.     be trunc
│ │ │ │ -0003d3e0: 6174 6564 2069 6620 6974 2065 7869 7374  ated if it exist
│ │ │ │ -0003d3f0: 732e 0a0a 2020 2020 202a 5265 7475 726e  s...     *Return
│ │ │ │ -0003d400: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ -0003d410: 2053 4849 5348 495f 4f4b 2069 6666 2073   SHISHI_OK iff s
│ │ │ │ -0003d420: 7563 6365 7373 6675 6c2e 0a0a 7368 6973  uccessful...shis
│ │ │ │ -0003d430: 6869 5f73 6166 655f 7061 7273 650a 2d2d  hi_safe_parse.--
│ │ │ │ -0003d440: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -0003d450: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ -0003d460: 6e74 2073 6869 7368 695f 7361 6665 5f70  nt shishi_safe_p
│ │ │ │ -0003d470: 6172 7365 2028 5368 6973 6869 202a 2048  arse (Shishi * H
│ │ │ │ -0003d480: 414e 444c 452c 2046 494c 4520 2a20 4648  ANDLE, FILE * FH
│ │ │ │ -0003d490: 2c0a 2020 2020 2020 2020 2020 5368 6973  ,.          Shis
│ │ │ │ -0003d4a0: 6869 5f61 736e 3120 2a20 5341 4645 290a  hi_asn1 * SAFE).
│ │ │ │ -0003d4b0: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ -0003d4c0: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ -0003d4d0: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ -0003d4e0: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ -0003d4f0: 2020 2020 2046 483a 2066 696c 6520 6861       FH: file ha
│ │ │ │ -0003d500: 6e64 6c65 206f 7065 6e20 666f 7220 7265  ndle open for re
│ │ │ │ -0003d510: 6164 696e 672e 0a20 2020 2020 5341 4645  ading..     SAFE
│ │ │ │ -0003d520: 3a20 6f75 7470 7574 2076 6172 6961 626c  : output variabl
│ │ │ │ -0003d530: 6520 7769 7468 206e 6577 6c79 2061 6c6c  e with newly all
│ │ │ │ -0003d540: 6f63 6174 6564 2053 4146 452e 0a0a 2020  ocated SAFE...  
│ │ │ │ -0003d550: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ -0003d560: 2a20 5265 6164 2041 5343 4949 2061 726d  * Read ASCII arm
│ │ │ │ -0003d570: 6f72 6564 2044 4552 2065 6e63 6f64 6564  ored DER encoded
│ │ │ │ -0003d580: 2053 4146 4520 6672 6f6d 2066 696c 6520   SAFE from file 
│ │ │ │ -0003d590: 616e 640a 2020 2020 2070 6f70 756c 6174  and.     populat
│ │ │ │ -0003d5a0: 6520 6769 7665 6e20 7661 7269 6162 6c65  e given variable
│ │ │ │ -0003d5b0: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ -0003d5c0: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ -0003d5d0: 5348 4953 4849 5f4f 4b20 6966 6620 7375  SHISHI_OK iff su
│ │ │ │ -0003d5e0: 6363 6573 7366 756c 2e0a 0a73 6869 7368  ccessful...shish
│ │ │ │ -0003d5f0: 695f 7361 6665 5f72 6561 640a 2d2d 2d2d  i_safe_read.----
│ │ │ │ -0003d600: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ -0003d610: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ -0003d620: 7368 6973 6869 5f73 6166 655f 7265 6164  shishi_safe_read
│ │ │ │ -0003d630: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ -0003d640: 452c 2046 494c 4520 2a20 4648 2c0a 2020  E, FILE * FH,.  
│ │ │ │ -0003d650: 2020 2020 2020 2020 5368 6973 6869 5f61          Shishi_a
│ │ │ │ -0003d660: 736e 3120 2a20 5341 4645 290a 2020 2020  sn1 * SAFE).    
│ │ │ │ -0003d670: 2048 414e 444c 453a 2073 6869 7368 6920   HANDLE: shishi 
│ │ │ │ -0003d680: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ -0003d690: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ -0003d6a0: 5f69 6e69 7428 29e2 8099 2e0a 2020 2020  _init().....    
│ │ │ │ -0003d6b0: 2046 483a 2066 696c 6520 6861 6e64 6c65   FH: file handle
│ │ │ │ -0003d6c0: 206f 7065 6e20 666f 7220 7265 6164 696e   open for readin
│ │ │ │ -0003d6d0: 672e 0a20 2020 2020 5341 4645 3a20 6f75  g..     SAFE: ou
│ │ │ │ -0003d6e0: 7470 7574 2076 6172 6961 626c 6520 7769  tput variable wi
│ │ │ │ -0003d6f0: 7468 206e 6577 6c79 2061 6c6c 6f63 6174  th newly allocat
│ │ │ │ -0003d700: 6564 2053 4146 452e 0a0a 2020 2020 202a  ed SAFE...     *
│ │ │ │ -0003d710: 4465 7363 7269 7074 696f 6e3a 2a20 5265  Description:* Re
│ │ │ │ -0003d720: 6164 2044 4552 2065 6e63 6f64 6564 2053  ad DER encoded S
│ │ │ │ -0003d730: 4146 4520 6672 6f6d 2066 696c 6520 616e  AFE from file an
│ │ │ │ -0003d740: 6420 706f 7075 6c61 7465 2067 6976 656e  d populate given
│ │ │ │ -0003d750: 0a20 2020 2020 7661 7269 6162 6c65 2e0a  .     variable..
│ │ │ │ -0003d760: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ -0003d770: 6c75 653a 2a20 5265 7475 726e 7320 5348  lue:* Returns SH
│ │ │ │ -0003d780: 4953 4849 5f4f 4b20 6966 6620 7375 6363  ISHI_OK iff succ
│ │ │ │ -0003d790: 6573 7366 756c 2e0a 0a73 6869 7368 695f  essful...shishi_
│ │ │ │ -0003d7a0: 7361 6665 5f66 726f 6d5f 6669 6c65 0a2d  safe_from_file.-
│ │ │ │ -0003d7b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0003d7c0: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -0003d7d0: 6f6e 3a20 696e 7420 7368 6973 6869 5f73  on: int shishi_s
│ │ │ │ -0003d7e0: 6166 655f 6672 6f6d 5f66 696c 6520 2853  afe_from_file (S
│ │ │ │ -0003d7f0: 6869 7368 6920 2a20 4841 4e44 4c45 2c0a  hishi * HANDLE,.
│ │ │ │ -0003d800: 2020 2020 2020 2020 2020 5368 6973 6869            Shishi
│ │ │ │ -0003d810: 5f61 736e 3120 2a20 5341 4645 2c20 696e  _asn1 * SAFE, in
│ │ │ │ -0003d820: 7420 4649 4c45 5459 5045 2c20 636f 6e73  t FILETYPE, cons
│ │ │ │ -0003d830: 7420 6368 6172 202a 2046 494c 454e 414d  t char * FILENAM
│ │ │ │ -0003d840: 4529 0a20 2020 2020 4841 4e44 4c45 3a20  E).     HANDLE: 
│ │ │ │ -0003d850: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ -0003d860: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ -0003d870: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ -0003d880: 992e 0a20 2020 2020 5341 4645 3a20 6f75  ...     SAFE: ou
│ │ │ │ -0003d890: 7470 7574 2076 6172 6961 626c 6520 7769  tput variable wi
│ │ │ │ -0003d8a0: 7468 206e 6577 6c79 2061 6c6c 6f63 6174  th newly allocat
│ │ │ │ -0003d8b0: 6564 2053 4146 452e 0a20 2020 2020 4649  ed SAFE..     FI
│ │ │ │ -0003d8c0: 4c45 5459 5045 3a20 696e 7075 7420 7661  LETYPE: input va
│ │ │ │ -0003d8d0: 7269 6162 6c65 2073 7065 6369 6679 696e  riable specifyin
│ │ │ │ -0003d8e0: 6720 7479 7065 206f 6620 6669 6c65 2074  g type of file t
│ │ │ │ -0003d8f0: 6f20 6265 2072 6561 642c 2073 6565 0a20  o be read, see. 
│ │ │ │ -0003d900: 2020 2020 5368 6973 6869 5f66 696c 6574      Shishi_filet
│ │ │ │ -0003d910: 7970 652e 0a20 2020 2020 4649 4c45 4e41  ype..     FILENA
│ │ │ │ -0003d920: 4d45 3a20 696e 7075 7420 7661 7269 6162  ME: input variab
│ │ │ │ -0003d930: 6c65 2077 6974 6820 6669 6c65 6e61 6d65  le with filename
│ │ │ │ -0003d940: 2074 6f20 7265 6164 2066 726f 6d2e 0a0a   to read from...
│ │ │ │ -0003d950: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ -0003d960: 6e3a 2a20 5265 6164 2053 4146 4520 6672  n:* Read SAFE fr
│ │ │ │ -0003d970: 6f6d 2066 696c 6520 696e 2073 7065 6369  om file in speci
│ │ │ │ -0003d980: 6669 6564 2054 5950 452e 0a0a 2020 2020  fied TYPE...    
│ │ │ │ -0003d990: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ -0003d9a0: 2052 6574 7572 6e73 2053 4849 5348 495f   Returns SHISHI_
│ │ │ │ -0003d9b0: 4f4b 2069 6666 2073 7563 6365 7373 6675  OK iff successfu
│ │ │ │ -0003d9c0: 6c2e 0a0a 7368 6973 6869 5f73 6166 655f  l...shishi_safe_
│ │ │ │ -0003d9d0: 636b 7375 6d0a 2d2d 2d2d 2d2d 2d2d 2d2d  cksum.----------
│ │ │ │ -0003d9e0: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ -0003d9f0: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ -0003da00: 695f 7361 6665 5f63 6b73 756d 2028 5368  i_safe_cksum (Sh
│ │ │ │ -0003da10: 6973 6869 202a 2048 414e 444c 452c 2053  ishi * HANDLE, S
│ │ │ │ -0003da20: 6869 7368 695f 6173 6e31 2053 4146 452c  hishi_asn1 SAFE,
│ │ │ │ -0003da30: 0a20 2020 2020 2020 2020 2069 6e74 3332  .          int32
│ │ │ │ -0003da40: 5f74 202a 2043 4b53 554d 5459 5045 2c20  _t * CKSUMTYPE, 
│ │ │ │ -0003da50: 6368 6172 202a 2a20 434b 5355 4d2c 2073  char ** CKSUM, s
│ │ │ │ -0003da60: 697a 655f 7420 2a20 434b 5355 4d4c 454e  ize_t * CKSUMLEN
│ │ │ │ -0003da70: 290a 2020 2020 2048 414e 444c 453a 2073  ).     HANDLE: s
│ │ │ │ -0003da80: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ -0003da90: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ -0003daa0: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ -0003dab0: 2e0a 2020 2020 2053 4146 453a 2073 6166  ..     SAFE: saf
│ │ │ │ -0003dac0: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ -0003dad0: 7920 e280 9873 6869 7368 695f 7361 6665  y ...shishi_safe
│ │ │ │ -0003dae0: 2829 e280 992e 0a20 2020 2020 434b 5355  ().....     CKSU
│ │ │ │ -0003daf0: 4d54 5950 453a 206f 7574 7075 7420 6368  MTYPE: output ch
│ │ │ │ -0003db00: 6563 6b73 756d 2074 7970 652e 0a20 2020  ecksum type..   
│ │ │ │ -0003db10: 2020 434b 5355 4d3a 206f 7574 7075 7420    CKSUM: output 
│ │ │ │ -0003db20: 6172 7261 7920 7769 7468 206e 6577 6c79  array with newly
│ │ │ │ -0003db30: 2061 6c6c 6f63 6174 6564 2063 6865 636b   allocated check
│ │ │ │ -0003db40: 7375 6d20 6461 7461 2066 726f 6d20 5341  sum data from SA
│ │ │ │ -0003db50: 4645 2e0a 2020 2020 2043 4b53 554d 4c45  FE..     CKSUMLE
│ │ │ │ -0003db60: 4e3a 206f 7574 7075 7420 7369 7a65 206f  N: output size o
│ │ │ │ -0003db70: 6620 6f75 7470 7574 2063 6865 636b 7375  f output checksu
│ │ │ │ -0003db80: 6d20 6461 7461 2062 7566 6665 722e 0a0a  m data buffer...
│ │ │ │ -0003db90: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ -0003dba0: 6e3a 2a20 5265 6164 2063 6865 636b 7375  n:* Read checksu
│ │ │ │ -0003dbb0: 6d20 7661 6c75 6520 6672 6f6d 204b 5242  m value from KRB
│ │ │ │ -0003dbc0: 2d53 4146 452e 2043 4b53 554d 2069 730a  -SAFE. CKSUM is.
│ │ │ │ -0003dbd0: 2020 2020 2061 6c6c 6f63 6174 6564 2062       allocated b
│ │ │ │ -0003dbe0: 7920 7468 6973 2066 756e 6374 696f 6e2c  y this function,
│ │ │ │ -0003dbf0: 2061 6e64 2069 7420 6973 2074 6865 2072   and it is the r
│ │ │ │ -0003dc00: 6573 706f 6e73 6962 696c 6974 7920 6f66  esponsibility of
│ │ │ │ -0003dc10: 2063 616c 6c65 720a 2020 2020 2074 6f20   caller.     to 
│ │ │ │ -0003dc20: 6465 616c 6c6f 6361 7465 2069 742e 0a0a  deallocate it...
│ │ │ │ -0003dc30: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ -0003dc40: 7565 3a2a 2052 6574 7572 6e73 2053 4849  ue:* Returns SHI
│ │ │ │ -0003dc50: 5348 495f 4f4b 2069 6666 2073 7563 6365  SHI_OK iff succe
│ │ │ │ -0003dc60: 7373 6675 6c2e 0a0a 7368 6973 6869 5f73  ssful...shishi_s
│ │ │ │ -0003dc70: 6166 655f 7365 745f 636b 7375 6d0a 2d2d  afe_set_cksum.--
│ │ │ │ +0003bd00: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +0003bd10: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ +0003bd20: 695f 656e 6361 7072 6570 7061 7274 5f74  i_encapreppart_t
│ │ │ │ +0003bd30: 696d 655f 636f 7079 2028 5368 6973 6869  ime_copy (Shishi
│ │ │ │ +0003bd40: 202a 2048 414e 444c 452c 0a20 2020 2020   * HANDLE,.     
│ │ │ │ +0003bd50: 2020 2020 2053 6869 7368 695f 6173 6e31       Shishi_asn1
│ │ │ │ +0003bd60: 2045 4e43 4150 5245 5050 4152 542c 2053   ENCAPREPPART, S
│ │ │ │ +0003bd70: 6869 7368 695f 6173 6e31 2041 5554 4845  hishi_asn1 AUTHE
│ │ │ │ +0003bd80: 4e54 4943 4154 4f52 290a 2020 2020 2048  NTICATOR).     H
│ │ │ │ +0003bd90: 414e 444c 453a 2073 6869 7368 6920 6861  ANDLE: shishi ha
│ │ │ │ +0003bda0: 6e64 6c65 2061 7320 616c 6c6f 6361 7465  ndle as allocate
│ │ │ │ +0003bdb0: 6420 6279 20e2 8098 7368 6973 6869 5f69  d by ...shishi_i
│ │ │ │ +0003bdc0: 6e69 7428 29e2 8099 2e0a 2020 2020 2045  nit().....     E
│ │ │ │ +0003bdd0: 4e43 4150 5245 5050 4152 543a 2045 6e63  NCAPREPPART: Enc
│ │ │ │ +0003bde0: 4150 5265 7050 6172 7420 6173 2061 6c6c  APRepPart as all
│ │ │ │ +0003bdf0: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ +0003be00: 7368 695f 656e 6361 7072 6570 7061 7274  shi_encapreppart
│ │ │ │ +0003be10: 2829 e280 992e 0a0a 2020 2020 2041 5554  ()......     AUT
│ │ │ │ +0003be20: 4845 4e54 4943 4154 4f52 3a20 4175 7468  HENTICATOR: Auth
│ │ │ │ +0003be30: 656e 7469 6361 746f 7220 746f 2063 6f70  enticator to cop
│ │ │ │ +0003be40: 7920 7469 6d65 2066 6965 6c64 7320 6672  y time fields fr
│ │ │ │ +0003be50: 6f6d 2e0a 0a20 2020 2020 2a44 6573 6372  om...     *Descr
│ │ │ │ +0003be60: 6970 7469 6f6e 3a2a 2043 6f70 7920 7469  iption:* Copy ti
│ │ │ │ +0003be70: 6d65 2066 6965 6c64 7320 6672 6f6d 2041  me fields from A
│ │ │ │ +0003be80: 7574 6865 6e74 6963 6174 6f72 2069 6e74  uthenticator int
│ │ │ │ +0003be90: 6f0a 2020 2020 2045 6e63 4150 5265 7050  o.     EncAPRepP
│ │ │ │ +0003bea0: 6172 742e 0a0a 2020 2020 202a 5265 7475  art...     *Retu
│ │ │ │ +0003beb0: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ +0003bec0: 6e73 2053 4849 5348 495f 4f4b 2069 6666  ns SHISHI_OK iff
│ │ │ │ +0003bed0: 2073 7563 6365 7373 6675 6c2e 0a0a 1f0a   successful.....
│ │ │ │ +0003bee0: 4669 6c65 3a20 7368 6973 6869 2e69 6e66  File: shishi.inf
│ │ │ │ +0003bef0: 6f2c 2020 4e6f 6465 3a20 5341 4645 2061  o,  Node: SAFE a
│ │ │ │ +0003bf00: 6e64 2050 5249 5620 4675 6e63 7469 6f6e  nd PRIV Function
│ │ │ │ +0003bf10: 732c 2020 4e65 7874 3a20 5469 636b 6574  s,  Next: Ticket
│ │ │ │ +0003bf20: 2046 756e 6374 696f 6e73 2c20 2050 7265   Functions,  Pre
│ │ │ │ +0003bf30: 763a 2041 502d 5245 5120 616e 6420 4150  v: AP-REQ and AP
│ │ │ │ +0003bf40: 2d52 4550 2046 756e 6374 696f 6e73 2c20  -REP Functions, 
│ │ │ │ +0003bf50: 2055 703a 2050 726f 6772 616d 6d69 6e67   Up: Programming
│ │ │ │ +0003bf60: 204d 616e 7561 6c0a 0a35 2e35 2053 4146   Manual..5.5 SAF
│ │ │ │ +0003bf70: 4520 616e 6420 5052 4956 2046 756e 6374  E and PRIV Funct
│ │ │ │ +0003bf80: 696f 6e73 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d  ions.===========
│ │ │ │ +0003bf90: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ +0003bfa0: 0a0a 5468 6520 224b 5242 2d53 4146 4522  ..The "KRB-SAFE"
│ │ │ │ +0003bfb0: 2069 7320 616e 2041 534e 2e31 2073 7472   is an ASN.1 str
│ │ │ │ +0003bfc0: 7563 7475 7265 2075 7365 6420 6279 2061  ucture used by a
│ │ │ │ +0003bfd0: 7070 6c69 6361 7469 6f6e 2063 6c69 656e  pplication clien
│ │ │ │ +0003bfe0: 7420 616e 640a 7365 7276 6572 7320 746f  t and.servers to
│ │ │ │ +0003bff0: 2065 7863 6861 6e67 6520 696e 7465 6772   exchange integr
│ │ │ │ +0003c000: 6974 7920 7072 6f74 6563 7465 6420 6461  ity protected da
│ │ │ │ +0003c010: 7461 2e20 2054 6865 2069 6e74 6567 7269  ta.  The integri
│ │ │ │ +0003c020: 7479 2070 726f 7465 6374 696f 6e0a 6973  ty protection.is
│ │ │ │ +0003c030: 206b 6579 6564 2c20 7573 7561 6c6c 7920   keyed, usually 
│ │ │ │ +0003c040: 7769 7468 2061 206b 6579 2061 6772 6565  with a key agree
│ │ │ │ +0003c050: 6420 6f6e 2076 6961 2074 6865 2041 5020  d on via the AP 
│ │ │ │ +0003c060: 6578 6368 616e 6765 2028 2a6e 6f74 6520  exchange (*note 
│ │ │ │ +0003c070: 4150 2d52 4551 0a61 6e64 2041 502d 5245  AP-REQ.and AP-RE
│ │ │ │ +0003c080: 5020 4675 6e63 7469 6f6e 733a 3a29 2e20  P Functions::). 
│ │ │ │ +0003c090: 2054 6865 2066 6f6c 6c6f 7769 6e67 2069   The following i
│ │ │ │ +0003c0a0: 6c6c 7573 7472 6174 6573 2074 6865 204b  llustrates the K
│ │ │ │ +0003c0b0: 5242 2d53 4146 4520 4153 4e2e 310a 7374  RB-SAFE ASN.1.st
│ │ │ │ +0003c0c0: 7275 6374 7572 652e 0a0a 2020 204b 5242  ructure...   KRB
│ │ │ │ +0003c0d0: 2d53 4146 4520 2020 2020 2020 203a 3a3d  -SAFE        ::=
│ │ │ │ +0003c0e0: 205b 4150 504c 4943 4154 494f 4e20 3230   [APPLICATION 20
│ │ │ │ +0003c0f0: 5d20 5345 5155 454e 4345 207b 0a20 2020  ] SEQUENCE {.   
│ │ │ │ +0003c100: 2020 2020 2020 2020 7076 6e6f 2020 2020          pvno    
│ │ │ │ +0003c110: 2020 2020 2020 2020 5b30 5d20 494e 5445          [0] INTE
│ │ │ │ +0003c120: 4745 5220 2835 292c 0a20 2020 2020 2020  GER (5),.       
│ │ │ │ +0003c130: 2020 2020 6d73 672d 7479 7065 2020 2020      msg-type    
│ │ │ │ +0003c140: 2020 2020 5b31 5d20 494e 5445 4745 5220      [1] INTEGER 
│ │ │ │ +0003c150: 2832 3029 2c0a 2020 2020 2020 2020 2020  (20),.          
│ │ │ │ +0003c160: 2073 6166 652d 626f 6479 2020 2020 2020   safe-body      
│ │ │ │ +0003c170: 205b 325d 204b 5242 2d53 4146 452d 424f   [2] KRB-SAFE-BO
│ │ │ │ +0003c180: 4459 2c0a 2020 2020 2020 2020 2020 2063  DY,.           c
│ │ │ │ +0003c190: 6b73 756d 2020 2020 2020 2020 2020 205b  ksum           [
│ │ │ │ +0003c1a0: 335d 2043 6865 636b 7375 6d0a 2020 207d  3] Checksum.   }
│ │ │ │ +0003c1b0: 0a0a 2020 204b 5242 2d53 4146 452d 424f  ..   KRB-SAFE-BO
│ │ │ │ +0003c1c0: 4459 2020 203a 3a3d 2053 4551 5545 4e43  DY   ::= SEQUENC
│ │ │ │ +0003c1d0: 4520 7b0a 2020 2020 2020 2020 2020 2075  E {.           u
│ │ │ │ +0003c1e0: 7365 722d 6461 7461 2020 2020 2020 205b  ser-data       [
│ │ │ │ +0003c1f0: 305d 204f 4354 4554 2053 5452 494e 472c  0] OCTET STRING,
│ │ │ │ +0003c200: 0a20 2020 2020 2020 2020 2020 7469 6d65  .           time
│ │ │ │ +0003c210: 7374 616d 7020 2020 2020 2020 5b31 5d20  stamp       [1] 
│ │ │ │ +0003c220: 4b65 7262 6572 6f73 5469 6d65 204f 5054  KerberosTime OPT
│ │ │ │ +0003c230: 494f 4e41 4c2c 0a20 2020 2020 2020 2020  IONAL,.         
│ │ │ │ +0003c240: 2020 7573 6563 2020 2020 2020 2020 2020    usec          
│ │ │ │ +0003c250: 2020 5b32 5d20 4d69 6372 6f73 6563 6f6e    [2] Microsecon
│ │ │ │ +0003c260: 6473 204f 5054 494f 4e41 4c2c 0a20 2020  ds OPTIONAL,.   
│ │ │ │ +0003c270: 2020 2020 2020 2020 7365 712d 6e75 6d62          seq-numb
│ │ │ │ +0003c280: 6572 2020 2020 2020 5b33 5d20 5549 6e74  er      [3] UInt
│ │ │ │ +0003c290: 3332 204f 5054 494f 4e41 4c2c 0a20 2020  32 OPTIONAL,.   
│ │ │ │ +0003c2a0: 2020 2020 2020 2020 732d 6164 6472 6573          s-addres
│ │ │ │ +0003c2b0: 7320 2020 2020 2020 5b34 5d20 486f 7374  s       [4] Host
│ │ │ │ +0003c2c0: 4164 6472 6573 732c 0a20 2020 2020 2020  Address,.       
│ │ │ │ +0003c2d0: 2020 2020 722d 6164 6472 6573 7320 2020      r-address   
│ │ │ │ +0003c2e0: 2020 2020 5b35 5d20 486f 7374 4164 6472      [5] HostAddr
│ │ │ │ +0003c2f0: 6573 7320 4f50 5449 4f4e 414c 0a20 2020  ess OPTIONAL.   
│ │ │ │ +0003c300: 7d0a 0a73 6869 7368 695f 7361 6665 0a2d  }..shishi_safe.-
│ │ │ │ +0003c310: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +0003c320: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ +0003c330: 6973 6869 5f73 6166 6520 2853 6869 7368  ishi_safe (Shish
│ │ │ │ +0003c340: 6920 2a20 4841 4e44 4c45 2c20 5368 6973  i * HANDLE, Shis
│ │ │ │ +0003c350: 6869 5f73 6166 6520 2a2a 2053 4146 4529  hi_safe ** SAFE)
│ │ │ │ +0003c360: 0a20 2020 2020 4841 4e44 4c45 3a20 7368  .     HANDLE: sh
│ │ │ │ +0003c370: 6973 6869 2068 616e 646c 6520 6173 2061  ishi handle as a
│ │ │ │ +0003c380: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ +0003c390: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ +0003c3a0: 0a20 2020 2020 5341 4645 3a20 706f 696e  .     SAFE: poin
│ │ │ │ +0003c3b0: 7465 7220 746f 206e 6577 2073 7472 7563  ter to new struc
│ │ │ │ +0003c3c0: 7475 7265 2074 6861 7420 686f 6c64 7320  ture that holds 
│ │ │ │ +0003c3d0: 696e 666f 726d 6174 696f 6e20 6162 6f75  information abou
│ │ │ │ +0003c3e0: 7420 5341 4645 0a20 2020 2020 6578 6368  t SAFE.     exch
│ │ │ │ +0003c3f0: 616e 6765 0a0a 2020 2020 202a 4465 7363  ange..     *Desc
│ │ │ │ +0003c400: 7269 7074 696f 6e3a 2a20 4372 6561 7465  ription:* Create
│ │ │ │ +0003c410: 2061 206e 6577 2053 4146 4520 6578 6368   a new SAFE exch
│ │ │ │ +0003c420: 616e 6765 2e0a 0a20 2020 2020 2a52 6574  ange...     *Ret
│ │ │ │ +0003c430: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ +0003c440: 726e 7320 5348 4953 4849 5f4f 4b20 6966  rns SHISHI_OK if
│ │ │ │ +0003c450: 6620 7375 6363 6573 7366 756c 2e0a 0a73  f successful...s
│ │ │ │ +0003c460: 6869 7368 695f 7361 6665 5f64 6f6e 650a  hishi_safe_done.
│ │ │ │ +0003c470: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +0003c480: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +0003c490: 766f 6964 2073 6869 7368 695f 7361 6665  void shishi_safe
│ │ │ │ +0003c4a0: 5f64 6f6e 6520 2853 6869 7368 695f 7361  _done (Shishi_sa
│ │ │ │ +0003c4b0: 6665 202a 2053 4146 4529 0a20 2020 2020  fe * SAFE).     
│ │ │ │ +0003c4c0: 5341 4645 3a20 7374 7275 6374 7572 6520  SAFE: structure 
│ │ │ │ +0003c4d0: 7468 6174 2068 6f6c 6473 2069 6e66 6f72  that holds infor
│ │ │ │ +0003c4e0: 6d61 7469 6f6e 2061 626f 7574 2053 4146  mation about SAF
│ │ │ │ +0003c4f0: 4520 6578 6368 616e 6765 0a0a 2020 2020  E exchange..    
│ │ │ │ +0003c500: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ +0003c510: 4465 616c 6c6f 6361 7465 2072 6573 6f75  Deallocate resou
│ │ │ │ +0003c520: 7263 6573 2061 7373 6f63 6961 7465 6420  rces associated 
│ │ │ │ +0003c530: 7769 7468 2053 4146 4520 6578 6368 616e  with SAFE exchan
│ │ │ │ +0003c540: 6765 2e0a 2020 2020 2054 6869 7320 7368  ge..     This sh
│ │ │ │ +0003c550: 6f75 6c64 2062 6520 6361 6c6c 6564 2062  ould be called b
│ │ │ │ +0003c560: 7920 7468 6520 6170 706c 6963 6174 696f  y the applicatio
│ │ │ │ +0003c570: 6e20 7768 656e 2069 7420 6e6f 206c 6f6e  n when it no lon
│ │ │ │ +0003c580: 6765 7220 6e65 6564 2074 6f0a 2020 2020  ger need to.    
│ │ │ │ +0003c590: 2075 7469 6c69 7a65 2074 6865 2053 4146   utilize the SAF
│ │ │ │ +0003c5a0: 4520 6578 6368 616e 6765 2068 616e 646c  E exchange handl
│ │ │ │ +0003c5b0: 652e 0a0a 7368 6973 6869 5f73 6166 655f  e...shishi_safe_
│ │ │ │ +0003c5c0: 6b65 790a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  key.------------
│ │ │ │ +0003c5d0: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ +0003c5e0: 6e3a 2053 6869 7368 695f 6b65 7920 2a20  n: Shishi_key * 
│ │ │ │ +0003c5f0: 7368 6973 6869 5f73 6166 655f 6b65 7920  shishi_safe_key 
│ │ │ │ +0003c600: 2853 6869 7368 695f 7361 6665 202a 2053  (Shishi_safe * S
│ │ │ │ +0003c610: 4146 4529 0a20 2020 2020 5341 4645 3a20  AFE).     SAFE: 
│ │ │ │ +0003c620: 7374 7275 6374 7572 6520 7468 6174 2068  structure that h
│ │ │ │ +0003c630: 6f6c 6473 2069 6e66 6f72 6d61 7469 6f6e  olds information
│ │ │ │ +0003c640: 2061 626f 7574 2053 4146 4520 6578 6368   about SAFE exch
│ │ │ │ +0003c650: 616e 6765 0a0a 2020 2020 202a 4465 7363  ange..     *Desc
│ │ │ │ +0003c660: 7269 7074 696f 6e3a 2a20 4765 7420 6b65  ription:* Get ke
│ │ │ │ +0003c670: 7920 7374 7275 6374 7572 6564 2066 726f  y structured fro
│ │ │ │ +0003c680: 6d20 5341 4645 2065 7863 6861 6e67 652e  m SAFE exchange.
│ │ │ │ +0003c690: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ +0003c6a0: 616c 7565 3a2a 2052 6574 7572 6e73 2074  alue:* Returns t
│ │ │ │ +0003c6b0: 6865 206b 6579 2075 7365 6420 696e 2074  he key used in t
│ │ │ │ +0003c6c0: 6865 2053 4146 4520 6578 6368 616e 6765  he SAFE exchange
│ │ │ │ +0003c6d0: 2c20 6f72 204e 554c 4c0a 2020 2020 2069  , or NULL.     i
│ │ │ │ +0003c6e0: 6620 6e6f 7420 7965 7420 7365 7420 6f72  f not yet set or
│ │ │ │ +0003c6f0: 2061 6e20 6572 726f 7220 6f63 6375 7265   an error occure
│ │ │ │ +0003c700: 642e 0a0a 7368 6973 6869 5f73 6166 655f  d...shishi_safe_
│ │ │ │ +0003c710: 6b65 795f 7365 740a 2d2d 2d2d 2d2d 2d2d  key_set.--------
│ │ │ │ +0003c720: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ +0003c730: 2046 756e 6374 696f 6e3a 2076 6f69 6420   Function: void 
│ │ │ │ +0003c740: 7368 6973 6869 5f73 6166 655f 6b65 795f  shishi_safe_key_
│ │ │ │ +0003c750: 7365 7420 2853 6869 7368 695f 7361 6665  set (Shishi_safe
│ │ │ │ +0003c760: 202a 2053 4146 452c 0a20 2020 2020 2020   * SAFE,.       
│ │ │ │ +0003c770: 2020 2053 6869 7368 695f 6b65 7920 2a20     Shishi_key * 
│ │ │ │ +0003c780: 4b45 5929 0a20 2020 2020 5341 4645 3a20  KEY).     SAFE: 
│ │ │ │ +0003c790: 7374 7275 6374 7572 6520 7468 6174 2068  structure that h
│ │ │ │ +0003c7a0: 6f6c 6473 2069 6e66 6f72 6d61 7469 6f6e  olds information
│ │ │ │ +0003c7b0: 2061 626f 7574 2053 4146 4520 6578 6368   about SAFE exch
│ │ │ │ +0003c7c0: 616e 6765 0a20 2020 2020 4b45 593a 206b  ange.     KEY: k
│ │ │ │ +0003c7d0: 6579 2074 6f20 7374 6f72 6520 696e 2053  ey to store in S
│ │ │ │ +0003c7e0: 4146 452e 0a0a 2020 2020 202a 4465 7363  AFE...     *Desc
│ │ │ │ +0003c7f0: 7269 7074 696f 6e3a 2a20 5365 7420 7468  ription:* Set th
│ │ │ │ +0003c800: 6520 4b65 7920 696e 2074 6865 2053 4146  e Key in the SAF
│ │ │ │ +0003c810: 4520 6578 6368 616e 6765 2e0a 0a73 6869  E exchange...shi
│ │ │ │ +0003c820: 7368 695f 7361 6665 5f73 6166 650a 2d2d  shi_safe_safe.--
│ │ │ │ +0003c830: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ +0003c840: 202d 2d20 4675 6e63 7469 6f6e 3a20 5368   -- Function: Sh
│ │ │ │ +0003c850: 6973 6869 5f61 736e 3120 7368 6973 6869  ishi_asn1 shishi
│ │ │ │ +0003c860: 5f73 6166 655f 7361 6665 2028 5368 6973  _safe_safe (Shis
│ │ │ │ +0003c870: 6869 5f73 6166 6520 2a20 5341 4645 290a  hi_safe * SAFE).
│ │ │ │ +0003c880: 2020 2020 2053 4146 453a 2073 7472 7563       SAFE: struc
│ │ │ │ +0003c890: 7475 7265 2074 6861 7420 686f 6c64 7320  ture that holds 
│ │ │ │ +0003c8a0: 696e 666f 726d 6174 696f 6e20 6162 6f75  information abou
│ │ │ │ +0003c8b0: 7420 5341 4645 2065 7863 6861 6e67 650a  t SAFE exchange.
│ │ │ │ +0003c8c0: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +0003c8d0: 6f6e 3a2a 2047 6574 2041 534e 2e31 2053  on:* Get ASN.1 S
│ │ │ │ +0003c8e0: 4146 4520 7374 7275 6374 7572 6564 2066  AFE structured f
│ │ │ │ +0003c8f0: 726f 6d20 5341 4645 2065 7863 6861 6e67  rom SAFE exchang
│ │ │ │ +0003c900: 652e 0a0a 2020 2020 202a 5265 7475 726e  e...     *Return
│ │ │ │ +0003c910: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ +0003c920: 2074 6865 2041 534e 2e31 2073 6166 6520   the ASN.1 safe 
│ │ │ │ +0003c930: 696e 2074 6865 2053 4146 4520 6578 6368  in the SAFE exch
│ │ │ │ +0003c940: 616e 6765 2c20 6f72 0a20 2020 2020 4e55  ange, or.     NU
│ │ │ │ +0003c950: 4c4c 2069 6620 6e6f 7420 7965 7420 7365  LL if not yet se
│ │ │ │ +0003c960: 7420 6f72 2061 6e20 6572 726f 7220 6f63  t or an error oc
│ │ │ │ +0003c970: 6375 7265 642e 0a0a 7368 6973 6869 5f73  cured...shishi_s
│ │ │ │ +0003c980: 6166 655f 7361 6665 5f73 6574 0a2d 2d2d  afe_safe_set.---
│ │ │ │ +0003c990: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +0003c9a0: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ +0003c9b0: 2076 6f69 6420 7368 6973 6869 5f73 6166   void shishi_saf
│ │ │ │ +0003c9c0: 655f 7361 6665 5f73 6574 2028 5368 6973  e_safe_set (Shis
│ │ │ │ +0003c9d0: 6869 5f73 6166 6520 2a20 5341 4645 2c0a  hi_safe * SAFE,.
│ │ │ │ +0003c9e0: 2020 2020 2020 2020 2020 5368 6973 6869            Shishi
│ │ │ │ +0003c9f0: 5f61 736e 3120 4153 4e31 5341 4645 290a  _asn1 ASN1SAFE).
│ │ │ │ +0003ca00: 2020 2020 2053 4146 453a 2073 7472 7563       SAFE: struc
│ │ │ │ +0003ca10: 7475 7265 2074 6861 7420 686f 6c64 7320  ture that holds 
│ │ │ │ +0003ca20: 696e 666f 726d 6174 696f 6e20 6162 6f75  information abou
│ │ │ │ +0003ca30: 7420 5341 4645 2065 7863 6861 6e67 650a  t SAFE exchange.
│ │ │ │ +0003ca40: 2020 2020 2041 534e 3153 4146 453a 204b       ASN1SAFE: K
│ │ │ │ +0003ca50: 5242 2d53 4146 4520 746f 2073 746f 7265  RB-SAFE to store
│ │ │ │ +0003ca60: 2069 6e20 5341 4645 2065 7863 6861 6e67   in SAFE exchang
│ │ │ │ +0003ca70: 652e 0a0a 2020 2020 202a 4465 7363 7269  e...     *Descri
│ │ │ │ +0003ca80: 7074 696f 6e3a 2a20 5365 7420 7468 6520  ption:* Set the 
│ │ │ │ +0003ca90: 4b52 422d 5341 4645 2069 6e20 7468 6520  KRB-SAFE in the 
│ │ │ │ +0003caa0: 5341 4645 2065 7863 6861 6e67 652e 0a0a  SAFE exchange...
│ │ │ │ +0003cab0: 7368 6973 6869 5f73 6166 655f 7361 6665  shishi_safe_safe
│ │ │ │ +0003cac0: 5f64 6572 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  _der.-----------
│ │ │ │ +0003cad0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +0003cae0: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ +0003caf0: 7368 695f 7361 6665 5f73 6166 655f 6465  shi_safe_safe_de
│ │ │ │ +0003cb00: 7220 2853 6869 7368 695f 7361 6665 202a  r (Shishi_safe *
│ │ │ │ +0003cb10: 2053 4146 452c 2063 6861 7220 2a2a 204f   SAFE, char ** O
│ │ │ │ +0003cb20: 5554 2c0a 2020 2020 2020 2020 2020 7369  UT,.          si
│ │ │ │ +0003cb30: 7a65 5f74 202a 204f 5554 4c45 4e29 0a20  ze_t * OUTLEN). 
│ │ │ │ +0003cb40: 2020 2020 5341 4645 3a20 7361 6665 2061      SAFE: safe a
│ │ │ │ +0003cb50: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ +0003cb60: 8098 7368 6973 6869 5f73 6166 6528 29e2  ..shishi_safe().
│ │ │ │ +0003cb70: 8099 2e0a 2020 2020 204f 5554 3a20 6f75  ....     OUT: ou
│ │ │ │ +0003cb80: 7470 7574 2061 7272 6179 2077 6974 6820  tput array with 
│ │ │ │ +0003cb90: 6e65 776c 7920 616c 6c6f 6361 7465 6420  newly allocated 
│ │ │ │ +0003cba0: 4445 5220 656e 636f 6469 6e67 206f 6620  DER encoding of 
│ │ │ │ +0003cbb0: 5341 4645 2e0a 2020 2020 204f 5554 4c45  SAFE..     OUTLE
│ │ │ │ +0003cbc0: 4e3a 206c 656e 6774 6820 6f66 206f 7574  N: length of out
│ │ │ │ +0003cbd0: 7075 7420 6172 7261 7920 7769 7468 2044  put array with D
│ │ │ │ +0003cbe0: 4552 2065 6e63 6f64 696e 6720 6f66 2053  ER encoding of S
│ │ │ │ +0003cbf0: 4146 452e 0a0a 2020 2020 202a 4465 7363  AFE...     *Desc
│ │ │ │ +0003cc00: 7269 7074 696f 6e3a 2a20 4445 5220 656e  ription:* DER en
│ │ │ │ +0003cc10: 636f 6465 2053 4146 4520 7374 7275 6374  code SAFE struct
│ │ │ │ +0003cc20: 7572 652e 2020 5479 7069 6361 6c6c 790a  ure.  Typically.
│ │ │ │ +0003cc30: 2020 2020 20e2 8098 7368 6973 6869 5f73       ...shishi_s
│ │ │ │ +0003cc40: 6166 655f 6275 696c 6428 29e2 8099 2069  afe_build()... i
│ │ │ │ +0003cc50: 7320 7573 6564 2074 6f20 6275 696c 6420  s used to build 
│ │ │ │ +0003cc60: 7468 6520 5341 4645 2073 7472 7563 7475  the SAFE structu
│ │ │ │ +0003cc70: 7265 2066 6972 7374 2e0a 2020 2020 204f  re first..     O
│ │ │ │ +0003cc80: 5554 2069 7320 616c 6c6f 6361 7465 6420  UT is allocated 
│ │ │ │ +0003cc90: 6279 2074 6869 7320 6675 6e63 7469 6f6e  by this function
│ │ │ │ +0003cca0: 2c20 616e 6420 6974 2069 7320 7468 6520  , and it is the 
│ │ │ │ +0003ccb0: 7265 7370 6f6e 7369 6269 6c69 7479 206f  responsibility o
│ │ │ │ +0003ccc0: 660a 2020 2020 2063 616c 6c65 7220 746f  f.     caller to
│ │ │ │ +0003ccd0: 2064 6561 6c6c 6f63 6174 6520 6974 2e0a   deallocate it..
│ │ │ │ +0003cce0: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ +0003ccf0: 6c75 653a 2a20 5265 7475 726e 7320 5348  lue:* Returns SH
│ │ │ │ +0003cd00: 4953 4849 5f4f 4b20 6966 6620 7375 6363  ISHI_OK iff succ
│ │ │ │ +0003cd10: 6573 7366 756c 2e0a 0a73 6869 7368 695f  essful...shishi_
│ │ │ │ +0003cd20: 7361 6665 5f73 6166 655f 6465 725f 7365  safe_safe_der_se
│ │ │ │ +0003cd30: 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  t.--------------
│ │ │ │ +0003cd40: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +0003cd50: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ +0003cd60: 6973 6869 5f73 6166 655f 7361 6665 5f64  ishi_safe_safe_d
│ │ │ │ +0003cd70: 6572 5f73 6574 2028 5368 6973 6869 5f73  er_set (Shishi_s
│ │ │ │ +0003cd80: 6166 6520 2a20 5341 4645 2c0a 2020 2020  afe * SAFE,.    
│ │ │ │ +0003cd90: 2020 2020 2020 6368 6172 202a 2044 4552        char * DER
│ │ │ │ +0003cda0: 2c20 7369 7a65 5f74 2044 4552 4c45 4e29  , size_t DERLEN)
│ │ │ │ +0003cdb0: 0a20 2020 2020 5341 4645 3a20 7361 6665  .     SAFE: safe
│ │ │ │ +0003cdc0: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ +0003cdd0: 20e2 8098 7368 6973 6869 5f73 6166 6528   ...shishi_safe(
│ │ │ │ +0003cde0: 29e2 8099 2e0a 2020 2020 2044 4552 3a20  ).....     DER: 
│ │ │ │ +0003cdf0: 696e 7075 7420 6172 7261 7920 7769 7468  input array with
│ │ │ │ +0003ce00: 2044 4552 2065 6e63 6f64 6564 204b 5242   DER encoded KRB
│ │ │ │ +0003ce10: 2d53 4146 452e 0a20 2020 2020 4445 524c  -SAFE..     DERL
│ │ │ │ +0003ce20: 454e 3a20 6c65 6e67 7468 206f 6620 696e  EN: length of in
│ │ │ │ +0003ce30: 7075 7420 6172 7261 7920 7769 7468 2044  put array with D
│ │ │ │ +0003ce40: 4552 2065 6e63 6f64 6564 204b 5242 2d53  ER encoded KRB-S
│ │ │ │ +0003ce50: 4146 452e 0a0a 2020 2020 202a 4465 7363  AFE...     *Desc
│ │ │ │ +0003ce60: 7269 7074 696f 6e3a 2a20 4445 5220 6465  ription:* DER de
│ │ │ │ +0003ce70: 636f 6465 204b 5242 2d53 4146 4520 616e  code KRB-SAFE an
│ │ │ │ +0003ce80: 6420 7365 7420 6974 2053 4146 4520 6578  d set it SAFE ex
│ │ │ │ +0003ce90: 6368 616e 6765 2e20 2049 660a 2020 2020  change.  If.    
│ │ │ │ +0003cea0: 2064 6563 6f64 696e 6720 6661 696c 732c   decoding fails,
│ │ │ │ +0003ceb0: 2074 6865 204b 5242 2d53 4146 4520 696e   the KRB-SAFE in
│ │ │ │ +0003cec0: 2074 6865 2053 4146 4520 6578 6368 616e   the SAFE exchan
│ │ │ │ +0003ced0: 6765 2072 656d 6169 6e73 2e0a 0a20 2020  ge remains...   
│ │ │ │ +0003cee0: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ +0003cef0: 2a20 5265 7475 726e 7320 5348 4953 4849  * Returns SHISHI
│ │ │ │ +0003cf00: 5f4f 4b2e 0a0a 7368 6973 6869 5f73 6166  _OK...shishi_saf
│ │ │ │ +0003cf10: 655f 7072 696e 740a 2d2d 2d2d 2d2d 2d2d  e_print.--------
│ │ │ │ +0003cf20: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +0003cf30: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ +0003cf40: 7368 695f 7361 6665 5f70 7269 6e74 2028  shi_safe_print (
│ │ │ │ +0003cf50: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ +0003cf60: 2046 494c 4520 2a20 4648 2c0a 2020 2020   FILE * FH,.    
│ │ │ │ +0003cf70: 2020 2020 2020 5368 6973 6869 5f61 736e        Shishi_asn
│ │ │ │ +0003cf80: 3120 5341 4645 290a 2020 2020 2048 414e  1 SAFE).     HAN
│ │ │ │ +0003cf90: 444c 453a 2073 6869 7368 6920 6861 6e64  DLE: shishi hand
│ │ │ │ +0003cfa0: 6c65 2061 7320 616c 6c6f 6361 7465 6420  le as allocated 
│ │ │ │ +0003cfb0: 6279 20e2 8098 7368 6973 6869 5f69 6e69  by ...shishi_ini
│ │ │ │ +0003cfc0: 7428 29e2 8099 2e0a 2020 2020 2046 483a  t().....     FH:
│ │ │ │ +0003cfd0: 2066 696c 6520 6861 6e64 6c65 206f 7065   file handle ope
│ │ │ │ +0003cfe0: 6e20 666f 7220 7772 6974 696e 672e 0a20  n for writing.. 
│ │ │ │ +0003cff0: 2020 2020 5341 4645 3a20 5341 4645 2074      SAFE: SAFE t
│ │ │ │ +0003d000: 6f20 7072 696e 742e 0a0a 2020 2020 202a  o print...     *
│ │ │ │ +0003d010: 4465 7363 7269 7074 696f 6e3a 2a20 5072  Description:* Pr
│ │ │ │ +0003d020: 696e 7420 4153 4349 4920 6172 6d6f 7265  int ASCII armore
│ │ │ │ +0003d030: 6420 4445 5220 656e 636f 6469 6e67 206f  d DER encoding o
│ │ │ │ +0003d040: 6620 5341 4645 2074 6f20 6669 6c65 2e0a  f SAFE to file..
│ │ │ │ +0003d050: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ +0003d060: 6c75 653a 2a20 5265 7475 726e 7320 5348  lue:* Returns SH
│ │ │ │ +0003d070: 4953 4849 5f4f 4b20 6966 6620 7375 6363  ISHI_OK iff succ
│ │ │ │ +0003d080: 6573 7366 756c 2e0a 0a73 6869 7368 695f  essful...shishi_
│ │ │ │ +0003d090: 7361 6665 5f73 6176 650a 2d2d 2d2d 2d2d  safe_save.------
│ │ │ │ +0003d0a0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +0003d0b0: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ +0003d0c0: 6973 6869 5f73 6166 655f 7361 7665 2028  ishi_safe_save (
│ │ │ │ +0003d0d0: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ +0003d0e0: 2046 494c 4520 2a20 4648 2c0a 2020 2020   FILE * FH,.    
│ │ │ │ +0003d0f0: 2020 2020 2020 5368 6973 6869 5f61 736e        Shishi_asn
│ │ │ │ +0003d100: 3120 5341 4645 290a 2020 2020 2048 414e  1 SAFE).     HAN
│ │ │ │ +0003d110: 444c 453a 2073 6869 7368 6920 6861 6e64  DLE: shishi hand
│ │ │ │ +0003d120: 6c65 2061 7320 616c 6c6f 6361 7465 6420  le as allocated 
│ │ │ │ +0003d130: 6279 20e2 8098 7368 6973 6869 5f69 6e69  by ...shishi_ini
│ │ │ │ +0003d140: 7428 29e2 8099 2e0a 2020 2020 2046 483a  t().....     FH:
│ │ │ │ +0003d150: 2066 696c 6520 6861 6e64 6c65 206f 7065   file handle ope
│ │ │ │ +0003d160: 6e20 666f 7220 7772 6974 696e 672e 0a20  n for writing.. 
│ │ │ │ +0003d170: 2020 2020 5341 4645 3a20 5341 4645 2074      SAFE: SAFE t
│ │ │ │ +0003d180: 6f20 7361 7665 2e0a 0a20 2020 2020 2a44  o save...     *D
│ │ │ │ +0003d190: 6573 6372 6970 7469 6f6e 3a2a 2053 6176  escription:* Sav
│ │ │ │ +0003d1a0: 6520 4445 5220 656e 636f 6469 6e67 206f  e DER encoding o
│ │ │ │ +0003d1b0: 6620 5341 4645 2074 6f20 6669 6c65 2e0a  f SAFE to file..
│ │ │ │ +0003d1c0: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ +0003d1d0: 6c75 653a 2a20 5265 7475 726e 7320 5348  lue:* Returns SH
│ │ │ │ +0003d1e0: 4953 4849 5f4f 4b20 6966 6620 7375 6363  ISHI_OK iff succ
│ │ │ │ +0003d1f0: 6573 7366 756c 2e0a 0a73 6869 7368 695f  essful...shishi_
│ │ │ │ +0003d200: 7361 6665 5f74 6f5f 6669 6c65 0a2d 2d2d  safe_to_file.---
│ │ │ │ +0003d210: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +0003d220: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +0003d230: 696e 7420 7368 6973 6869 5f73 6166 655f  int shishi_safe_
│ │ │ │ +0003d240: 746f 5f66 696c 6520 2853 6869 7368 6920  to_file (Shishi 
│ │ │ │ +0003d250: 2a20 4841 4e44 4c45 2c0a 2020 2020 2020  * HANDLE,.      
│ │ │ │ +0003d260: 2020 2020 5368 6973 6869 5f61 736e 3120      Shishi_asn1 
│ │ │ │ +0003d270: 5341 4645 2c20 696e 7420 4649 4c45 5459  SAFE, int FILETY
│ │ │ │ +0003d280: 5045 2c20 636f 6e73 7420 6368 6172 202a  PE, const char *
│ │ │ │ +0003d290: 2046 494c 454e 414d 4529 0a20 2020 2020   FILENAME).     
│ │ │ │ +0003d2a0: 4841 4e44 4c45 3a20 7368 6973 6869 2068  HANDLE: shishi h
│ │ │ │ +0003d2b0: 616e 646c 6520 6173 2061 6c6c 6f63 6174  andle as allocat
│ │ │ │ +0003d2c0: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ +0003d2d0: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ +0003d2e0: 5341 4645 3a20 5341 4645 2074 6f20 7361  SAFE: SAFE to sa
│ │ │ │ +0003d2f0: 7665 2e0a 2020 2020 2046 494c 4554 5950  ve..     FILETYP
│ │ │ │ +0003d300: 453a 2069 6e70 7574 2076 6172 6961 626c  E: input variabl
│ │ │ │ +0003d310: 6520 7370 6563 6966 7969 6e67 2074 7970  e specifying typ
│ │ │ │ +0003d320: 6520 6f66 2066 696c 6520 746f 2062 6520  e of file to be 
│ │ │ │ +0003d330: 7772 6974 7465 6e2c 2073 6565 0a20 2020  written, see.   
│ │ │ │ +0003d340: 2020 5368 6973 6869 5f66 696c 6574 7970    Shishi_filetyp
│ │ │ │ +0003d350: 652e 0a20 2020 2020 4649 4c45 4e41 4d45  e..     FILENAME
│ │ │ │ +0003d360: 3a20 696e 7075 7420 7661 7269 6162 6c65  : input variable
│ │ │ │ +0003d370: 2077 6974 6820 6669 6c65 6e61 6d65 2074   with filename t
│ │ │ │ +0003d380: 6f20 7772 6974 6520 746f 2e0a 0a20 2020  o write to...   
│ │ │ │ +0003d390: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ +0003d3a0: 2057 7269 7465 2053 4146 4520 746f 2066   Write SAFE to f
│ │ │ │ +0003d3b0: 696c 6520 696e 2073 7065 6369 6669 6564  ile in specified
│ │ │ │ +0003d3c0: 2054 5950 452e 2054 6865 2066 696c 6520   TYPE. The file 
│ │ │ │ +0003d3d0: 7769 6c6c 0a20 2020 2020 6265 2074 7275  will.     be tru
│ │ │ │ +0003d3e0: 6e63 6174 6564 2069 6620 6974 2065 7869  ncated if it exi
│ │ │ │ +0003d3f0: 7374 732e 0a0a 2020 2020 202a 5265 7475  sts...     *Retu
│ │ │ │ +0003d400: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ +0003d410: 6e73 2053 4849 5348 495f 4f4b 2069 6666  ns SHISHI_OK iff
│ │ │ │ +0003d420: 2073 7563 6365 7373 6675 6c2e 0a0a 7368   successful...sh
│ │ │ │ +0003d430: 6973 6869 5f73 6166 655f 7061 7273 650a  ishi_safe_parse.
│ │ │ │ +0003d440: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +0003d450: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ +0003d460: 2069 6e74 2073 6869 7368 695f 7361 6665   int shishi_safe
│ │ │ │ +0003d470: 5f70 6172 7365 2028 5368 6973 6869 202a  _parse (Shishi *
│ │ │ │ +0003d480: 2048 414e 444c 452c 2046 494c 4520 2a20   HANDLE, FILE * 
│ │ │ │ +0003d490: 4648 2c0a 2020 2020 2020 2020 2020 5368  FH,.          Sh
│ │ │ │ +0003d4a0: 6973 6869 5f61 736e 3120 2a20 5341 4645  ishi_asn1 * SAFE
│ │ │ │ +0003d4b0: 290a 2020 2020 2048 414e 444c 453a 2073  ).     HANDLE: s
│ │ │ │ +0003d4c0: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ +0003d4d0: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ +0003d4e0: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ +0003d4f0: 2e0a 2020 2020 2046 483a 2066 696c 6520  ..     FH: file 
│ │ │ │ +0003d500: 6861 6e64 6c65 206f 7065 6e20 666f 7220  handle open for 
│ │ │ │ +0003d510: 7265 6164 696e 672e 0a20 2020 2020 5341  reading..     SA
│ │ │ │ +0003d520: 4645 3a20 6f75 7470 7574 2076 6172 6961  FE: output varia
│ │ │ │ +0003d530: 626c 6520 7769 7468 206e 6577 6c79 2061  ble with newly a
│ │ │ │ +0003d540: 6c6c 6f63 6174 6564 2053 4146 452e 0a0a  llocated SAFE...
│ │ │ │ +0003d550: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ +0003d560: 6e3a 2a20 5265 6164 2041 5343 4949 2061  n:* Read ASCII a
│ │ │ │ +0003d570: 726d 6f72 6564 2044 4552 2065 6e63 6f64  rmored DER encod
│ │ │ │ +0003d580: 6564 2053 4146 4520 6672 6f6d 2066 696c  ed SAFE from fil
│ │ │ │ +0003d590: 6520 616e 640a 2020 2020 2070 6f70 756c  e and.     popul
│ │ │ │ +0003d5a0: 6174 6520 6769 7665 6e20 7661 7269 6162  ate given variab
│ │ │ │ +0003d5b0: 6c65 2e0a 0a20 2020 2020 2a52 6574 7572  le...     *Retur
│ │ │ │ +0003d5c0: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ +0003d5d0: 7320 5348 4953 4849 5f4f 4b20 6966 6620  s SHISHI_OK iff 
│ │ │ │ +0003d5e0: 7375 6363 6573 7366 756c 2e0a 0a73 6869  successful...shi
│ │ │ │ +0003d5f0: 7368 695f 7361 6665 5f72 6561 640a 2d2d  shi_safe_read.--
│ │ │ │ +0003d600: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ +0003d610: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ +0003d620: 7420 7368 6973 6869 5f73 6166 655f 7265  t shishi_safe_re
│ │ │ │ +0003d630: 6164 2028 5368 6973 6869 202a 2048 414e  ad (Shishi * HAN
│ │ │ │ +0003d640: 444c 452c 2046 494c 4520 2a20 4648 2c0a  DLE, FILE * FH,.
│ │ │ │ +0003d650: 2020 2020 2020 2020 2020 5368 6973 6869            Shishi
│ │ │ │ +0003d660: 5f61 736e 3120 2a20 5341 4645 290a 2020  _asn1 * SAFE).  
│ │ │ │ +0003d670: 2020 2048 414e 444c 453a 2073 6869 7368     HANDLE: shish
│ │ │ │ +0003d680: 6920 6861 6e64 6c65 2061 7320 616c 6c6f  i handle as allo
│ │ │ │ +0003d690: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ +0003d6a0: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ +0003d6b0: 2020 2046 483a 2066 696c 6520 6861 6e64     FH: file hand
│ │ │ │ +0003d6c0: 6c65 206f 7065 6e20 666f 7220 7265 6164  le open for read
│ │ │ │ +0003d6d0: 696e 672e 0a20 2020 2020 5341 4645 3a20  ing..     SAFE: 
│ │ │ │ +0003d6e0: 6f75 7470 7574 2076 6172 6961 626c 6520  output variable 
│ │ │ │ +0003d6f0: 7769 7468 206e 6577 6c79 2061 6c6c 6f63  with newly alloc
│ │ │ │ +0003d700: 6174 6564 2053 4146 452e 0a0a 2020 2020  ated SAFE...    
│ │ │ │ +0003d710: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ +0003d720: 5265 6164 2044 4552 2065 6e63 6f64 6564  Read DER encoded
│ │ │ │ +0003d730: 2053 4146 4520 6672 6f6d 2066 696c 6520   SAFE from file 
│ │ │ │ +0003d740: 616e 6420 706f 7075 6c61 7465 2067 6976  and populate giv
│ │ │ │ +0003d750: 656e 0a20 2020 2020 7661 7269 6162 6c65  en.     variable
│ │ │ │ +0003d760: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ +0003d770: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ +0003d780: 5348 4953 4849 5f4f 4b20 6966 6620 7375  SHISHI_OK iff su
│ │ │ │ +0003d790: 6363 6573 7366 756c 2e0a 0a73 6869 7368  ccessful...shish
│ │ │ │ +0003d7a0: 695f 7361 6665 5f66 726f 6d5f 6669 6c65  i_safe_from_file
│ │ │ │ +0003d7b0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ +0003d7c0: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ +0003d7d0: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ +0003d7e0: 5f73 6166 655f 6672 6f6d 5f66 696c 6520  _safe_from_file 
│ │ │ │ +0003d7f0: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ +0003d800: 2c0a 2020 2020 2020 2020 2020 5368 6973  ,.          Shis
│ │ │ │ +0003d810: 6869 5f61 736e 3120 2a20 5341 4645 2c20  hi_asn1 * SAFE, 
│ │ │ │ +0003d820: 696e 7420 4649 4c45 5459 5045 2c20 636f  int FILETYPE, co
│ │ │ │ +0003d830: 6e73 7420 6368 6172 202a 2046 494c 454e  nst char * FILEN
│ │ │ │ +0003d840: 414d 4529 0a20 2020 2020 4841 4e44 4c45  AME).     HANDLE
│ │ │ │ +0003d850: 3a20 7368 6973 6869 2068 616e 646c 6520  : shishi handle 
│ │ │ │ +0003d860: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ +0003d870: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ +0003d880: e280 992e 0a20 2020 2020 5341 4645 3a20  .....     SAFE: 
│ │ │ │ +0003d890: 6f75 7470 7574 2076 6172 6961 626c 6520  output variable 
│ │ │ │ +0003d8a0: 7769 7468 206e 6577 6c79 2061 6c6c 6f63  with newly alloc
│ │ │ │ +0003d8b0: 6174 6564 2053 4146 452e 0a20 2020 2020  ated SAFE..     
│ │ │ │ +0003d8c0: 4649 4c45 5459 5045 3a20 696e 7075 7420  FILETYPE: input 
│ │ │ │ +0003d8d0: 7661 7269 6162 6c65 2073 7065 6369 6679  variable specify
│ │ │ │ +0003d8e0: 696e 6720 7479 7065 206f 6620 6669 6c65  ing type of file
│ │ │ │ +0003d8f0: 2074 6f20 6265 2072 6561 642c 2073 6565   to be read, see
│ │ │ │ +0003d900: 0a20 2020 2020 5368 6973 6869 5f66 696c  .     Shishi_fil
│ │ │ │ +0003d910: 6574 7970 652e 0a20 2020 2020 4649 4c45  etype..     FILE
│ │ │ │ +0003d920: 4e41 4d45 3a20 696e 7075 7420 7661 7269  NAME: input vari
│ │ │ │ +0003d930: 6162 6c65 2077 6974 6820 6669 6c65 6e61  able with filena
│ │ │ │ +0003d940: 6d65 2074 6f20 7265 6164 2066 726f 6d2e  me to read from.
│ │ │ │ +0003d950: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ +0003d960: 696f 6e3a 2a20 5265 6164 2053 4146 4520  ion:* Read SAFE 
│ │ │ │ +0003d970: 6672 6f6d 2066 696c 6520 696e 2073 7065  from file in spe
│ │ │ │ +0003d980: 6369 6669 6564 2054 5950 452e 0a0a 2020  cified TYPE...  
│ │ │ │ +0003d990: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ +0003d9a0: 3a2a 2052 6574 7572 6e73 2053 4849 5348  :* Returns SHISH
│ │ │ │ +0003d9b0: 495f 4f4b 2069 6666 2073 7563 6365 7373  I_OK iff success
│ │ │ │ +0003d9c0: 6675 6c2e 0a0a 7368 6973 6869 5f73 6166  ful...shishi_saf
│ │ │ │ +0003d9d0: 655f 636b 7375 6d0a 2d2d 2d2d 2d2d 2d2d  e_cksum.--------
│ │ │ │ +0003d9e0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +0003d9f0: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ +0003da00: 7368 695f 7361 6665 5f63 6b73 756d 2028  shi_safe_cksum (
│ │ │ │ +0003da10: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ +0003da20: 2053 6869 7368 695f 6173 6e31 2053 4146   Shishi_asn1 SAF
│ │ │ │ +0003da30: 452c 0a20 2020 2020 2020 2020 2069 6e74  E,.          int
│ │ │ │ +0003da40: 3332 5f74 202a 2043 4b53 554d 5459 5045  32_t * CKSUMTYPE
│ │ │ │ +0003da50: 2c20 6368 6172 202a 2a20 434b 5355 4d2c  , char ** CKSUM,
│ │ │ │ +0003da60: 2073 697a 655f 7420 2a20 434b 5355 4d4c   size_t * CKSUML
│ │ │ │ +0003da70: 454e 290a 2020 2020 2048 414e 444c 453a  EN).     HANDLE:
│ │ │ │ +0003da80: 2073 6869 7368 6920 6861 6e64 6c65 2061   shishi handle a
│ │ │ │ +0003da90: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ +0003daa0: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ +0003dab0: 8099 2e0a 2020 2020 2053 4146 453a 2073  ....     SAFE: s
│ │ │ │ +0003dac0: 6166 6520 6173 2061 6c6c 6f63 6174 6564  afe as allocated
│ │ │ │ +0003dad0: 2062 7920 e280 9873 6869 7368 695f 7361   by ...shishi_sa
│ │ │ │ +0003dae0: 6665 2829 e280 992e 0a20 2020 2020 434b  fe().....     CK
│ │ │ │ +0003daf0: 5355 4d54 5950 453a 206f 7574 7075 7420  SUMTYPE: output 
│ │ │ │ +0003db00: 6368 6563 6b73 756d 2074 7970 652e 0a20  checksum type.. 
│ │ │ │ +0003db10: 2020 2020 434b 5355 4d3a 206f 7574 7075      CKSUM: outpu
│ │ │ │ +0003db20: 7420 6172 7261 7920 7769 7468 206e 6577  t array with new
│ │ │ │ +0003db30: 6c79 2061 6c6c 6f63 6174 6564 2063 6865  ly allocated che
│ │ │ │ +0003db40: 636b 7375 6d20 6461 7461 2066 726f 6d20  cksum data from 
│ │ │ │ +0003db50: 5341 4645 2e0a 2020 2020 2043 4b53 554d  SAFE..     CKSUM
│ │ │ │ +0003db60: 4c45 4e3a 206f 7574 7075 7420 7369 7a65  LEN: output size
│ │ │ │ +0003db70: 206f 6620 6f75 7470 7574 2063 6865 636b   of output check
│ │ │ │ +0003db80: 7375 6d20 6461 7461 2062 7566 6665 722e  sum data buffer.
│ │ │ │ +0003db90: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ +0003dba0: 696f 6e3a 2a20 5265 6164 2063 6865 636b  ion:* Read check
│ │ │ │ +0003dbb0: 7375 6d20 7661 6c75 6520 6672 6f6d 204b  sum value from K
│ │ │ │ +0003dbc0: 5242 2d53 4146 452e 2043 4b53 554d 2069  RB-SAFE. CKSUM i
│ │ │ │ +0003dbd0: 730a 2020 2020 2061 6c6c 6f63 6174 6564  s.     allocated
│ │ │ │ +0003dbe0: 2062 7920 7468 6973 2066 756e 6374 696f   by this functio
│ │ │ │ +0003dbf0: 6e2c 2061 6e64 2069 7420 6973 2074 6865  n, and it is the
│ │ │ │ +0003dc00: 2072 6573 706f 6e73 6962 696c 6974 7920   responsibility 
│ │ │ │ +0003dc10: 6f66 2063 616c 6c65 720a 2020 2020 2074  of caller.     t
│ │ │ │ +0003dc20: 6f20 6465 616c 6c6f 6361 7465 2069 742e  o deallocate it.
│ │ │ │ +0003dc30: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ +0003dc40: 616c 7565 3a2a 2052 6574 7572 6e73 2053  alue:* Returns S
│ │ │ │ +0003dc50: 4849 5348 495f 4f4b 2069 6666 2073 7563  HISHI_OK iff suc
│ │ │ │ +0003dc60: 6365 7373 6675 6c2e 0a0a 7368 6973 6869  cessful...shishi
│ │ │ │ +0003dc70: 5f73 6166 655f 7365 745f 636b 7375 6d0a  _safe_set_cksum.
│ │ │ │  0003dc80: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0003dc90: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ -0003dca0: 6e3a 2069 6e74 2073 6869 7368 695f 7361  n: int shishi_sa
│ │ │ │ -0003dcb0: 6665 5f73 6574 5f63 6b73 756d 2028 5368  fe_set_cksum (Sh
│ │ │ │ -0003dcc0: 6973 6869 202a 2048 414e 444c 452c 0a20  ishi * HANDLE,. 
│ │ │ │ -0003dcd0: 2020 2020 2020 2020 2053 6869 7368 695f           Shishi_
│ │ │ │ -0003dce0: 6173 6e31 2053 4146 452c 2069 6e74 3332  asn1 SAFE, int32
│ │ │ │ -0003dcf0: 5f74 2043 4b53 554d 5459 5045 2c20 636f  _t CKSUMTYPE, co
│ │ │ │ -0003dd00: 6e73 7420 6368 6172 202a 2043 4b53 554d  nst char * CKSUM
│ │ │ │ -0003dd10: 2c0a 2020 2020 2020 2020 2020 7369 7a65  ,.          size
│ │ │ │ -0003dd20: 5f74 2043 4b53 554d 4c45 4e29 0a20 2020  _t CKSUMLEN).   
│ │ │ │ -0003dd30: 2020 4841 4e44 4c45 3a20 7368 6973 6869    HANDLE: shishi
│ │ │ │ -0003dd40: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ -0003dd50: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ -0003dd60: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ -0003dd70: 2020 5341 4645 3a20 7361 6665 2061 7320    SAFE: safe as 
│ │ │ │ -0003dd80: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ -0003dd90: 7368 6973 6869 5f73 6166 6528 29e2 8099  shishi_safe()...
│ │ │ │ -0003dda0: 2e0a 2020 2020 2043 4b53 554d 5459 5045  ..     CKSUMTYPE
│ │ │ │ -0003ddb0: 3a20 696e 7075 7420 6368 6563 6b73 756d  : input checksum
│ │ │ │ -0003ddc0: 2074 7970 6520 746f 2073 746f 7265 2069   type to store i
│ │ │ │ -0003ddd0: 6e20 5341 4645 2e0a 2020 2020 2043 4b53  n SAFE..     CKS
│ │ │ │ -0003dde0: 554d 3a20 696e 7075 7420 6368 6563 6b73  UM: input checks
│ │ │ │ -0003ddf0: 756d 2064 6174 6120 746f 2073 746f 7265  um data to store
│ │ │ │ -0003de00: 2069 6e20 5341 4645 2e0a 2020 2020 2043   in SAFE..     C
│ │ │ │ -0003de10: 4b53 554d 4c45 4e3a 2073 697a 6520 6f66  KSUMLEN: size of
│ │ │ │ -0003de20: 2069 6e70 7574 2063 6865 636b 7375 6d20   input checksum 
│ │ │ │ -0003de30: 6461 7461 2074 6f20 7374 6f72 6520 696e  data to store in
│ │ │ │ -0003de40: 2053 4146 452e 0a0a 2020 2020 202a 4465   SAFE...     *De
│ │ │ │ -0003de50: 7363 7269 7074 696f 6e3a 2a20 5374 6f72  scription:* Stor
│ │ │ │ -0003de60: 6520 6368 6563 6b73 756d 2076 616c 7565  e checksum value
│ │ │ │ -0003de70: 2069 6e20 5341 4645 2e20 4120 6368 6563   in SAFE. A chec
│ │ │ │ -0003de80: 6b73 756d 2069 7320 7573 7561 6c6c 790a  ksum is usually.
│ │ │ │ -0003de90: 2020 2020 2063 7265 6174 6564 2062 7920       created by 
│ │ │ │ -0003dea0: 6361 6c6c 696e 6720 e280 9873 6869 7368  calling ...shish
│ │ │ │ -0003deb0: 695f 6368 6563 6b73 756d 2829 e280 9920  i_checksum()... 
│ │ │ │ -0003dec0: 6f6e 2073 6f6d 6520 6170 706c 6963 6174  on some applicat
│ │ │ │ -0003ded0: 696f 6e20 7370 6563 6966 6963 0a20 2020  ion specific.   
│ │ │ │ -0003dee0: 2020 6461 7461 2075 7369 6e67 2074 6865    data using the
│ │ │ │ -0003def0: 206b 6579 2066 726f 6d20 7468 6520 7469   key from the ti
│ │ │ │ -0003df00: 636b 6574 2074 6861 7420 6973 2062 6569  cket that is bei
│ │ │ │ -0003df10: 6e67 2075 7365 642e 2020 546f 2073 6176  ng used.  To sav
│ │ │ │ -0003df20: 650a 2020 2020 2074 696d 652c 2079 6f75  e.     time, you
│ │ │ │ -0003df30: 206d 6179 2077 616e 7420 746f 2075 7365   may want to use
│ │ │ │ -0003df40: 20e2 8098 7368 6973 6869 5f73 6166 655f   ...shishi_safe_
│ │ │ │ -0003df50: 6275 696c 6428 29e2 8099 2069 6e73 7465  build()... inste
│ │ │ │ -0003df60: 6164 2c20 7768 6963 680a 2020 2020 2063  ad, which.     c
│ │ │ │ -0003df70: 616c 6375 6c61 7465 7320 7468 6520 6368  alculates the ch
│ │ │ │ -0003df80: 6563 6b73 756d 2061 6e64 2063 616c 6c73  ecksum and calls
│ │ │ │ -0003df90: 2074 6869 7320 6675 6e63 7469 6f6e 2069   this function i
│ │ │ │ -0003dfa0: 6e20 6f6e 6520 7374 6570 2e0a 0a20 2020  n one step...   
│ │ │ │ -0003dfb0: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ -0003dfc0: 2a20 5265 7475 726e 7320 5348 4953 4849  * Returns SHISHI
│ │ │ │ -0003dfd0: 5f4f 4b20 6966 6620 7375 6363 6573 7366  _OK iff successf
│ │ │ │ -0003dfe0: 756c 2e0a 0a73 6869 7368 695f 7361 6665  ul...shishi_safe
│ │ │ │ -0003dff0: 5f75 7365 725f 6461 7461 0a2d 2d2d 2d2d  _user_data.-----
│ │ │ │ +0003dc90: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +0003dca0: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ +0003dcb0: 7361 6665 5f73 6574 5f63 6b73 756d 2028  safe_set_cksum (
│ │ │ │ +0003dcc0: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ +0003dcd0: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ +0003dce0: 695f 6173 6e31 2053 4146 452c 2069 6e74  i_asn1 SAFE, int
│ │ │ │ +0003dcf0: 3332 5f74 2043 4b53 554d 5459 5045 2c20  32_t CKSUMTYPE, 
│ │ │ │ +0003dd00: 636f 6e73 7420 6368 6172 202a 2043 4b53  const char * CKS
│ │ │ │ +0003dd10: 554d 2c0a 2020 2020 2020 2020 2020 7369  UM,.          si
│ │ │ │ +0003dd20: 7a65 5f74 2043 4b53 554d 4c45 4e29 0a20  ze_t CKSUMLEN). 
│ │ │ │ +0003dd30: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ +0003dd40: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ +0003dd50: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ +0003dd60: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ +0003dd70: 2020 2020 5341 4645 3a20 7361 6665 2061      SAFE: safe a
│ │ │ │ +0003dd80: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ +0003dd90: 8098 7368 6973 6869 5f73 6166 6528 29e2  ..shishi_safe().
│ │ │ │ +0003dda0: 8099 2e0a 2020 2020 2043 4b53 554d 5459  ....     CKSUMTY
│ │ │ │ +0003ddb0: 5045 3a20 696e 7075 7420 6368 6563 6b73  PE: input checks
│ │ │ │ +0003ddc0: 756d 2074 7970 6520 746f 2073 746f 7265  um type to store
│ │ │ │ +0003ddd0: 2069 6e20 5341 4645 2e0a 2020 2020 2043   in SAFE..     C
│ │ │ │ +0003dde0: 4b53 554d 3a20 696e 7075 7420 6368 6563  KSUM: input chec
│ │ │ │ +0003ddf0: 6b73 756d 2064 6174 6120 746f 2073 746f  ksum data to sto
│ │ │ │ +0003de00: 7265 2069 6e20 5341 4645 2e0a 2020 2020  re in SAFE..    
│ │ │ │ +0003de10: 2043 4b53 554d 4c45 4e3a 2073 697a 6520   CKSUMLEN: size 
│ │ │ │ +0003de20: 6f66 2069 6e70 7574 2063 6865 636b 7375  of input checksu
│ │ │ │ +0003de30: 6d20 6461 7461 2074 6f20 7374 6f72 6520  m data to store 
│ │ │ │ +0003de40: 696e 2053 4146 452e 0a0a 2020 2020 202a  in SAFE...     *
│ │ │ │ +0003de50: 4465 7363 7269 7074 696f 6e3a 2a20 5374  Description:* St
│ │ │ │ +0003de60: 6f72 6520 6368 6563 6b73 756d 2076 616c  ore checksum val
│ │ │ │ +0003de70: 7565 2069 6e20 5341 4645 2e20 4120 6368  ue in SAFE. A ch
│ │ │ │ +0003de80: 6563 6b73 756d 2069 7320 7573 7561 6c6c  ecksum is usuall
│ │ │ │ +0003de90: 790a 2020 2020 2063 7265 6174 6564 2062  y.     created b
│ │ │ │ +0003dea0: 7920 6361 6c6c 696e 6720 e280 9873 6869  y calling ...shi
│ │ │ │ +0003deb0: 7368 695f 6368 6563 6b73 756d 2829 e280  shi_checksum()..
│ │ │ │ +0003dec0: 9920 6f6e 2073 6f6d 6520 6170 706c 6963  . on some applic
│ │ │ │ +0003ded0: 6174 696f 6e20 7370 6563 6966 6963 0a20  ation specific. 
│ │ │ │ +0003dee0: 2020 2020 6461 7461 2075 7369 6e67 2074      data using t
│ │ │ │ +0003def0: 6865 206b 6579 2066 726f 6d20 7468 6520  he key from the 
│ │ │ │ +0003df00: 7469 636b 6574 2074 6861 7420 6973 2062  ticket that is b
│ │ │ │ +0003df10: 6569 6e67 2075 7365 642e 2020 546f 2073  eing used.  To s
│ │ │ │ +0003df20: 6176 650a 2020 2020 2074 696d 652c 2079  ave.     time, y
│ │ │ │ +0003df30: 6f75 206d 6179 2077 616e 7420 746f 2075  ou may want to u
│ │ │ │ +0003df40: 7365 20e2 8098 7368 6973 6869 5f73 6166  se ...shishi_saf
│ │ │ │ +0003df50: 655f 6275 696c 6428 29e2 8099 2069 6e73  e_build()... ins
│ │ │ │ +0003df60: 7465 6164 2c20 7768 6963 680a 2020 2020  tead, which.    
│ │ │ │ +0003df70: 2063 616c 6375 6c61 7465 7320 7468 6520   calculates the 
│ │ │ │ +0003df80: 6368 6563 6b73 756d 2061 6e64 2063 616c  checksum and cal
│ │ │ │ +0003df90: 6c73 2074 6869 7320 6675 6e63 7469 6f6e  ls this function
│ │ │ │ +0003dfa0: 2069 6e20 6f6e 6520 7374 6570 2e0a 0a20   in one step... 
│ │ │ │ +0003dfb0: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ +0003dfc0: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ +0003dfd0: 4849 5f4f 4b20 6966 6620 7375 6363 6573  HI_OK iff succes
│ │ │ │ +0003dfe0: 7366 756c 2e0a 0a73 6869 7368 695f 7361  sful...shishi_sa
│ │ │ │ +0003dff0: 6665 5f75 7365 725f 6461 7461 0a2d 2d2d  fe_user_data.---
│ │ │ │  0003e000: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0003e010: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ -0003e020: 696e 7420 7368 6973 6869 5f73 6166 655f  int shishi_safe_
│ │ │ │ -0003e030: 7573 6572 5f64 6174 6120 2853 6869 7368  user_data (Shish
│ │ │ │ -0003e040: 6920 2a20 4841 4e44 4c45 2c0a 2020 2020  i * HANDLE,.    
│ │ │ │ -0003e050: 2020 2020 2020 5368 6973 6869 5f61 736e        Shishi_asn
│ │ │ │ -0003e060: 3120 5341 4645 2c20 6368 6172 202a 2a20  1 SAFE, char ** 
│ │ │ │ -0003e070: 5553 4552 4441 5441 2c20 7369 7a65 5f74  USERDATA, size_t
│ │ │ │ -0003e080: 202a 2055 5345 5244 4154 414c 454e 290a   * USERDATALEN).
│ │ │ │ -0003e090: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ -0003e0a0: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ -0003e0b0: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ -0003e0c0: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ -0003e0d0: 2020 2020 2053 4146 453a 2073 6166 6520       SAFE: safe 
│ │ │ │ -0003e0e0: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ -0003e0f0: e280 9873 6869 7368 695f 7361 6665 2829  ...shishi_safe()
│ │ │ │ -0003e100: e280 992e 0a20 2020 2020 5553 4552 4441  .....     USERDA
│ │ │ │ -0003e110: 5441 3a20 6f75 7470 7574 2061 7272 6179  TA: output array
│ │ │ │ -0003e120: 2077 6974 6820 6e65 776c 7920 616c 6c6f   with newly allo
│ │ │ │ -0003e130: 6361 7465 6420 7573 6572 2064 6174 6120  cated user data 
│ │ │ │ -0003e140: 6672 6f6d 0a20 2020 2020 4b52 422d 5341  from.     KRB-SA
│ │ │ │ -0003e150: 4645 2e0a 2020 2020 2055 5345 5244 4154  FE..     USERDAT
│ │ │ │ -0003e160: 414c 454e 3a20 6f75 7470 7574 2073 697a  ALEN: output siz
│ │ │ │ -0003e170: 6520 6f66 206f 7574 7075 7420 7573 6572  e of output user
│ │ │ │ -0003e180: 2064 6174 6120 6275 6666 6572 2e0a 0a20   data buffer... 
│ │ │ │ -0003e190: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -0003e1a0: 3a2a 2052 6561 6420 7573 6572 2064 6174  :* Read user dat
│ │ │ │ -0003e1b0: 6120 7661 6c75 6520 6672 6f6d 204b 5242  a value from KRB
│ │ │ │ -0003e1c0: 2d53 4146 452e 2055 5345 5244 4154 4120  -SAFE. USERDATA 
│ │ │ │ -0003e1d0: 6973 0a20 2020 2020 616c 6c6f 6361 7465  is.     allocate
│ │ │ │ -0003e1e0: 6420 6279 2074 6869 7320 6675 6e63 7469  d by this functi
│ │ │ │ -0003e1f0: 6f6e 2c20 616e 6420 6974 2069 7320 7468  on, and it is th
│ │ │ │ -0003e200: 6520 7265 7370 6f6e 7369 6269 6c69 7479  e responsibility
│ │ │ │ -0003e210: 206f 6620 6361 6c6c 6572 0a20 2020 2020   of caller.     
│ │ │ │ -0003e220: 746f 2064 6561 6c6c 6f63 6174 6520 6974  to deallocate it
│ │ │ │ -0003e230: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ -0003e240: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ -0003e250: 5348 4953 4849 5f4f 4b20 6966 6620 7375  SHISHI_OK iff su
│ │ │ │ -0003e260: 6363 6573 7366 756c 2e0a 0a73 6869 7368  ccessful...shish
│ │ │ │ -0003e270: 695f 7361 6665 5f73 6574 5f75 7365 725f  i_safe_set_user_
│ │ │ │ -0003e280: 6461 7461 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  data.-----------
│ │ │ │ -0003e290: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -0003e2a0: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ -0003e2b0: 7420 7368 6973 6869 5f73 6166 655f 7365  t shishi_safe_se
│ │ │ │ -0003e2c0: 745f 7573 6572 5f64 6174 6120 2853 6869  t_user_data (Shi
│ │ │ │ -0003e2d0: 7368 6920 2a20 4841 4e44 4c45 2c0a 2020  shi * HANDLE,.  
│ │ │ │ -0003e2e0: 2020 2020 2020 2020 5368 6973 6869 5f61          Shishi_a
│ │ │ │ -0003e2f0: 736e 3120 5341 4645 2c20 636f 6e73 7420  sn1 SAFE, const 
│ │ │ │ -0003e300: 6368 6172 202a 2055 5345 5244 4154 412c  char * USERDATA,
│ │ │ │ -0003e310: 2073 697a 655f 7420 5553 4552 4441 5441   size_t USERDATA
│ │ │ │ -0003e320: 4c45 4e29 0a20 2020 2020 4841 4e44 4c45  LEN).     HANDLE
│ │ │ │ -0003e330: 3a20 7368 6973 6869 2068 616e 646c 6520  : shishi handle 
│ │ │ │ -0003e340: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ -0003e350: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ -0003e360: e280 992e 0a20 2020 2020 5341 4645 3a20  .....     SAFE: 
│ │ │ │ -0003e370: 7361 6665 2061 7320 616c 6c6f 6361 7465  safe as allocate
│ │ │ │ -0003e380: 6420 6279 20e2 8098 7368 6973 6869 5f73  d by ...shishi_s
│ │ │ │ -0003e390: 6166 6528 29e2 8099 2e0a 2020 2020 2055  afe().....     U
│ │ │ │ -0003e3a0: 5345 5244 4154 413a 2069 6e70 7574 2075  SERDATA: input u
│ │ │ │ -0003e3b0: 7365 7220 6170 706c 6963 6174 696f 6e20  ser application 
│ │ │ │ -0003e3c0: 746f 2073 746f 7265 2069 6e20 5341 4645  to store in SAFE
│ │ │ │ -0003e3d0: 2e0a 2020 2020 2055 5345 5244 4154 414c  ..     USERDATAL
│ │ │ │ -0003e3e0: 454e 3a20 7369 7a65 206f 6620 696e 7075  EN: size of inpu
│ │ │ │ -0003e3f0: 7420 7573 6572 2061 7070 6c69 6361 7469  t user applicati
│ │ │ │ -0003e400: 6f6e 2074 6f20 7374 6f72 6520 696e 2053  on to store in S
│ │ │ │ -0003e410: 4146 452e 0a0a 2020 2020 202a 4465 7363  AFE...     *Desc
│ │ │ │ -0003e420: 7269 7074 696f 6e3a 2a20 5365 7420 7468  ription:* Set th
│ │ │ │ -0003e430: 6520 6170 706c 6963 6174 696f 6e20 6461  e application da
│ │ │ │ -0003e440: 7461 2069 6e20 5341 4645 2e0a 0a20 2020  ta in SAFE...   
│ │ │ │ -0003e450: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ -0003e460: 2a20 5265 7475 726e 7320 5348 4953 4849  * Returns SHISHI
│ │ │ │ -0003e470: 5f4f 4b20 6966 6620 7375 6363 6573 7366  _OK iff successf
│ │ │ │ -0003e480: 756c 2e0a 0a73 6869 7368 695f 7361 6665  ul...shishi_safe
│ │ │ │ -0003e490: 5f62 7569 6c64 0a2d 2d2d 2d2d 2d2d 2d2d  _build.---------
│ │ │ │ -0003e4a0: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -0003e4b0: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ -0003e4c0: 6869 5f73 6166 655f 6275 696c 6420 2853  hi_safe_build (S
│ │ │ │ -0003e4d0: 6869 7368 695f 7361 6665 202a 2053 4146  hishi_safe * SAF
│ │ │ │ -0003e4e0: 452c 0a20 2020 2020 2020 2020 2053 6869  E,.          Shi
│ │ │ │ -0003e4f0: 7368 695f 6b65 7920 2a20 4b45 5929 0a20  shi_key * KEY). 
│ │ │ │ -0003e500: 2020 2020 5341 4645 3a20 7361 6665 2061      SAFE: safe a
│ │ │ │ -0003e510: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ -0003e520: 8098 7368 6973 6869 5f73 6166 6528 29e2  ..shishi_safe().
│ │ │ │ -0003e530: 8099 2e0a 2020 2020 204b 4559 3a20 6b65  ....     KEY: ke
│ │ │ │ -0003e540: 7920 666f 7220 7365 7373 696f 6e2c 2075  y for session, u
│ │ │ │ -0003e550: 7365 6420 746f 2063 6f6d 7075 7465 2063  sed to compute c
│ │ │ │ -0003e560: 6865 636b 7375 6d2e 0a0a 2020 2020 202a  hecksum...     *
│ │ │ │ -0003e570: 4465 7363 7269 7074 696f 6e3a 2a20 4275  Description:* Bu
│ │ │ │ -0003e580: 696c 6420 6368 6563 6b73 756d 2061 6e64  ild checksum and
│ │ │ │ -0003e590: 2073 6574 2069 7420 696e 204b 5242 2d53   set it in KRB-S
│ │ │ │ -0003e5a0: 4146 452e 204e 6f74 6520 7468 6174 0a20  AFE. Note that. 
│ │ │ │ -0003e5b0: 2020 2020 7468 6973 2066 6f6c 6c6f 7773      this follows
│ │ │ │ -0003e5c0: 2052 4643 2031 3531 3062 6973 2061 6e64   RFC 1510bis and
│ │ │ │ -0003e5d0: 2069 7320 696e 636f 6d70 6174 6962 6c65   is incompatible
│ │ │ │ -0003e5e0: 2077 6974 6820 5246 4320 3135 3130 2c0a   with RFC 1510,.
│ │ │ │ -0003e5f0: 2020 2020 2061 6c74 686f 7567 6820 7072       although pr
│ │ │ │ -0003e600: 6573 756d 6162 6c79 2066 6577 2069 6d70  esumably few imp
│ │ │ │ -0003e610: 6c65 6d65 6e74 6174 696f 6e73 2075 7365  lementations use
│ │ │ │ -0003e620: 2074 6865 2052 4643 3135 3130 2061 6c67   the RFC1510 alg
│ │ │ │ -0003e630: 6f72 6974 686d 2e0a 0a20 2020 2020 2a52  orithm...     *R
│ │ │ │ -0003e640: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ -0003e650: 7475 726e 7320 5348 4953 4849 5f4f 4b20  turns SHISHI_OK 
│ │ │ │ -0003e660: 6966 6620 7375 6363 6573 7366 756c 2e0a  iff successful..
│ │ │ │ -0003e670: 0a73 6869 7368 695f 7361 6665 5f76 6572  .shishi_safe_ver
│ │ │ │ -0003e680: 6966 790a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ify.------------
│ │ │ │ -0003e690: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ -0003e6a0: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ -0003e6b0: 5f73 6166 655f 7665 7269 6679 2028 5368  _safe_verify (Sh
│ │ │ │ -0003e6c0: 6973 6869 5f73 6166 6520 2a20 5341 4645  ishi_safe * SAFE
│ │ │ │ -0003e6d0: 2c0a 2020 2020 2020 2020 2020 5368 6973  ,.          Shis
│ │ │ │ -0003e6e0: 6869 5f6b 6579 202a 204b 4559 290a 2020  hi_key * KEY).  
│ │ │ │ -0003e6f0: 2020 2053 4146 453a 2073 6166 6520 6173     SAFE: safe as
│ │ │ │ -0003e700: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ -0003e710: 9873 6869 7368 695f 7361 6665 2829 e280  .shishi_safe()..
│ │ │ │ -0003e720: 992e 0a20 2020 2020 4b45 593a 206b 6579  ...     KEY: key
│ │ │ │ -0003e730: 2066 6f72 2073 6573 7369 6f6e 2c20 7573   for session, us
│ │ │ │ -0003e740: 6564 2074 6f20 7665 7269 6679 2063 6865  ed to verify che
│ │ │ │ -0003e750: 636b 7375 6d2e 0a0a 2020 2020 202a 4465  cksum...     *De
│ │ │ │ -0003e760: 7363 7269 7074 696f 6e3a 2a20 5665 7269  scription:* Veri
│ │ │ │ -0003e770: 6679 2063 6865 636b 7375 6d20 696e 204b  fy checksum in K
│ │ │ │ -0003e780: 5242 2d53 4146 452e 204e 6f74 6520 7468  RB-SAFE. Note th
│ │ │ │ -0003e790: 6174 2074 6869 7320 666f 6c6c 6f77 730a  at this follows.
│ │ │ │ -0003e7a0: 2020 2020 2052 4643 2031 3531 3062 6973       RFC 1510bis
│ │ │ │ -0003e7b0: 2061 6e64 2069 7320 696e 636f 6d70 6174   and is incompat
│ │ │ │ -0003e7c0: 6962 6c65 2077 6974 6820 5246 4320 3135  ible with RFC 15
│ │ │ │ -0003e7d0: 3130 2c20 616c 7468 6f75 6768 2070 7265  10, although pre
│ │ │ │ -0003e7e0: 7375 6d61 626c 790a 2020 2020 2066 6577  sumably.     few
│ │ │ │ -0003e7f0: 2069 6d70 6c65 6d65 6e74 6174 696f 6e73   implementations
│ │ │ │ -0003e800: 2075 7365 2074 6865 2052 4643 3135 3130   use the RFC1510
│ │ │ │ -0003e810: 2061 6c67 6f72 6974 686d 2e0a 0a20 2020   algorithm...   
│ │ │ │ -0003e820: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ -0003e830: 2a20 5265 7475 726e 7320 5348 4953 4849  * Returns SHISHI
│ │ │ │ -0003e840: 5f4f 4b20 6966 6620 7375 6363 6573 7366  _OK iff successf
│ │ │ │ -0003e850: 756c 2c0a 2020 2020 2053 4849 5348 495f  ul,.     SHISHI_
│ │ │ │ -0003e860: 5341 4645 5f42 4144 5f4b 4559 5459 5045  SAFE_BAD_KEYTYPE
│ │ │ │ -0003e870: 2069 6620 616e 2069 6e63 6f6d 7061 7469   if an incompati
│ │ │ │ -0003e880: 626c 6520 6b65 7920 7479 7065 2069 7320  ble key type is 
│ │ │ │ -0003e890: 7573 6564 2c20 6f72 0a20 2020 2020 5348  used, or.     SH
│ │ │ │ -0003e8a0: 4953 4849 5f53 4146 455f 5645 5249 4659  ISHI_SAFE_VERIFY
│ │ │ │ -0003e8b0: 5f46 4149 4c45 4420 6966 2074 6865 2061  _FAILED if the a
│ │ │ │ -0003e8c0: 6374 7561 6c20 7665 7269 6669 6361 7469  ctual verificati
│ │ │ │ -0003e8d0: 6f6e 2066 6169 6c65 642e 0a0a 2020 2054  on failed...   T
│ │ │ │ -0003e8e0: 6865 2022 4b52 422d 5052 4956 2220 6973  he "KRB-PRIV" is
│ │ │ │ -0003e8f0: 2061 6e20 4153 4e2e 3120 7374 7275 6374   an ASN.1 struct
│ │ │ │ -0003e900: 7572 6520 7573 6564 2062 7920 6170 706c  ure used by appl
│ │ │ │ -0003e910: 6963 6174 696f 6e20 636c 6965 6e74 2061  ication client a
│ │ │ │ -0003e920: 6e64 0a73 6572 7665 7273 2074 6f20 6578  nd.servers to ex
│ │ │ │ -0003e930: 6368 616e 6765 2063 6f6e 6669 6465 6e74  change confident
│ │ │ │ -0003e940: 6961 6c20 6461 7461 2e20 2054 6865 2063  ial data.  The c
│ │ │ │ -0003e950: 6f6e 6669 6465 6e74 6961 6c69 7479 2069  onfidentiality i
│ │ │ │ -0003e960: 7320 6b65 7965 642c 0a75 7375 616c 6c79  s keyed,.usually
│ │ │ │ -0003e970: 2077 6974 6820 6120 6b65 7920 6167 7265   with a key agre
│ │ │ │ -0003e980: 6564 206f 6e20 7669 6120 7468 6520 4150  ed on via the AP
│ │ │ │ -0003e990: 2065 7863 6861 6e67 6520 282a 6e6f 7465   exchange (*note
│ │ │ │ -0003e9a0: 2041 502d 5245 5120 616e 640a 4150 2d52   AP-REQ and.AP-R
│ │ │ │ -0003e9b0: 4550 2046 756e 6374 696f 6e73 3a3a 292e  EP Functions::).
│ │ │ │ -0003e9c0: 2020 5468 6520 666f 6c6c 6f77 696e 6720    The following 
│ │ │ │ -0003e9d0: 696c 6c75 7374 7261 7465 7320 7468 6520  illustrates the 
│ │ │ │ -0003e9e0: 4b52 422d 5052 4956 2041 534e 2e31 0a73  KRB-PRIV ASN.1.s
│ │ │ │ -0003e9f0: 7472 7563 7475 7265 2e0a 0a20 2020 4b52  tructure...   KR
│ │ │ │ -0003ea00: 422d 5052 4956 2020 2020 2020 2020 3a3a  B-PRIV        ::
│ │ │ │ -0003ea10: 3d20 5b41 5050 4c49 4341 5449 4f4e 2032  = [APPLICATION 2
│ │ │ │ -0003ea20: 315d 2053 4551 5545 4e43 4520 7b0a 2020  1] SEQUENCE {.  
│ │ │ │ -0003ea30: 2020 2020 2020 2020 2070 766e 6f20 2020           pvno   
│ │ │ │ -0003ea40: 2020 2020 2020 2020 205b 305d 2049 4e54           [0] INT
│ │ │ │ -0003ea50: 4547 4552 2028 3529 2c0a 2020 2020 2020  EGER (5),.      
│ │ │ │ -0003ea60: 2020 2020 206d 7367 2d74 7970 6520 2020       msg-type   
│ │ │ │ -0003ea70: 2020 2020 205b 315d 2049 4e54 4547 4552       [1] INTEGER
│ │ │ │ -0003ea80: 2028 3231 292c 0a20 2020 2020 2020 2020   (21),.         
│ │ │ │ +0003e010: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ +0003e020: 3a20 696e 7420 7368 6973 6869 5f73 6166  : int shishi_saf
│ │ │ │ +0003e030: 655f 7573 6572 5f64 6174 6120 2853 6869  e_user_data (Shi
│ │ │ │ +0003e040: 7368 6920 2a20 4841 4e44 4c45 2c0a 2020  shi * HANDLE,.  
│ │ │ │ +0003e050: 2020 2020 2020 2020 5368 6973 6869 5f61          Shishi_a
│ │ │ │ +0003e060: 736e 3120 5341 4645 2c20 6368 6172 202a  sn1 SAFE, char *
│ │ │ │ +0003e070: 2a20 5553 4552 4441 5441 2c20 7369 7a65  * USERDATA, size
│ │ │ │ +0003e080: 5f74 202a 2055 5345 5244 4154 414c 454e  _t * USERDATALEN
│ │ │ │ +0003e090: 290a 2020 2020 2048 414e 444c 453a 2073  ).     HANDLE: s
│ │ │ │ +0003e0a0: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ +0003e0b0: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ +0003e0c0: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ +0003e0d0: 2e0a 2020 2020 2053 4146 453a 2073 6166  ..     SAFE: saf
│ │ │ │ +0003e0e0: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ +0003e0f0: 7920 e280 9873 6869 7368 695f 7361 6665  y ...shishi_safe
│ │ │ │ +0003e100: 2829 e280 992e 0a20 2020 2020 5553 4552  ().....     USER
│ │ │ │ +0003e110: 4441 5441 3a20 6f75 7470 7574 2061 7272  DATA: output arr
│ │ │ │ +0003e120: 6179 2077 6974 6820 6e65 776c 7920 616c  ay with newly al
│ │ │ │ +0003e130: 6c6f 6361 7465 6420 7573 6572 2064 6174  located user dat
│ │ │ │ +0003e140: 6120 6672 6f6d 0a20 2020 2020 4b52 422d  a from.     KRB-
│ │ │ │ +0003e150: 5341 4645 2e0a 2020 2020 2055 5345 5244  SAFE..     USERD
│ │ │ │ +0003e160: 4154 414c 454e 3a20 6f75 7470 7574 2073  ATALEN: output s
│ │ │ │ +0003e170: 697a 6520 6f66 206f 7574 7075 7420 7573  ize of output us
│ │ │ │ +0003e180: 6572 2064 6174 6120 6275 6666 6572 2e0a  er data buffer..
│ │ │ │ +0003e190: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +0003e1a0: 6f6e 3a2a 2052 6561 6420 7573 6572 2064  on:* Read user d
│ │ │ │ +0003e1b0: 6174 6120 7661 6c75 6520 6672 6f6d 204b  ata value from K
│ │ │ │ +0003e1c0: 5242 2d53 4146 452e 2055 5345 5244 4154  RB-SAFE. USERDAT
│ │ │ │ +0003e1d0: 4120 6973 0a20 2020 2020 616c 6c6f 6361  A is.     alloca
│ │ │ │ +0003e1e0: 7465 6420 6279 2074 6869 7320 6675 6e63  ted by this func
│ │ │ │ +0003e1f0: 7469 6f6e 2c20 616e 6420 6974 2069 7320  tion, and it is 
│ │ │ │ +0003e200: 7468 6520 7265 7370 6f6e 7369 6269 6c69  the responsibili
│ │ │ │ +0003e210: 7479 206f 6620 6361 6c6c 6572 0a20 2020  ty of caller.   
│ │ │ │ +0003e220: 2020 746f 2064 6561 6c6c 6f63 6174 6520    to deallocate 
│ │ │ │ +0003e230: 6974 2e0a 0a20 2020 2020 2a52 6574 7572  it...     *Retur
│ │ │ │ +0003e240: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ +0003e250: 7320 5348 4953 4849 5f4f 4b20 6966 6620  s SHISHI_OK iff 
│ │ │ │ +0003e260: 7375 6363 6573 7366 756c 2e0a 0a73 6869  successful...shi
│ │ │ │ +0003e270: 7368 695f 7361 6665 5f73 6574 5f75 7365  shi_safe_set_use
│ │ │ │ +0003e280: 725f 6461 7461 0a2d 2d2d 2d2d 2d2d 2d2d  r_data.---------
│ │ │ │ +0003e290: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +0003e2a0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +0003e2b0: 696e 7420 7368 6973 6869 5f73 6166 655f  int shishi_safe_
│ │ │ │ +0003e2c0: 7365 745f 7573 6572 5f64 6174 6120 2853  set_user_data (S
│ │ │ │ +0003e2d0: 6869 7368 6920 2a20 4841 4e44 4c45 2c0a  hishi * HANDLE,.
│ │ │ │ +0003e2e0: 2020 2020 2020 2020 2020 5368 6973 6869            Shishi
│ │ │ │ +0003e2f0: 5f61 736e 3120 5341 4645 2c20 636f 6e73  _asn1 SAFE, cons
│ │ │ │ +0003e300: 7420 6368 6172 202a 2055 5345 5244 4154  t char * USERDAT
│ │ │ │ +0003e310: 412c 2073 697a 655f 7420 5553 4552 4441  A, size_t USERDA
│ │ │ │ +0003e320: 5441 4c45 4e29 0a20 2020 2020 4841 4e44  TALEN).     HAND
│ │ │ │ +0003e330: 4c45 3a20 7368 6973 6869 2068 616e 646c  LE: shishi handl
│ │ │ │ +0003e340: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ +0003e350: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ +0003e360: 2829 e280 992e 0a20 2020 2020 5341 4645  ().....     SAFE
│ │ │ │ +0003e370: 3a20 7361 6665 2061 7320 616c 6c6f 6361  : safe as alloca
│ │ │ │ +0003e380: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ +0003e390: 5f73 6166 6528 29e2 8099 2e0a 2020 2020  _safe().....    
│ │ │ │ +0003e3a0: 2055 5345 5244 4154 413a 2069 6e70 7574   USERDATA: input
│ │ │ │ +0003e3b0: 2075 7365 7220 6170 706c 6963 6174 696f   user applicatio
│ │ │ │ +0003e3c0: 6e20 746f 2073 746f 7265 2069 6e20 5341  n to store in SA
│ │ │ │ +0003e3d0: 4645 2e0a 2020 2020 2055 5345 5244 4154  FE..     USERDAT
│ │ │ │ +0003e3e0: 414c 454e 3a20 7369 7a65 206f 6620 696e  ALEN: size of in
│ │ │ │ +0003e3f0: 7075 7420 7573 6572 2061 7070 6c69 6361  put user applica
│ │ │ │ +0003e400: 7469 6f6e 2074 6f20 7374 6f72 6520 696e  tion to store in
│ │ │ │ +0003e410: 2053 4146 452e 0a0a 2020 2020 202a 4465   SAFE...     *De
│ │ │ │ +0003e420: 7363 7269 7074 696f 6e3a 2a20 5365 7420  scription:* Set 
│ │ │ │ +0003e430: 7468 6520 6170 706c 6963 6174 696f 6e20  the application 
│ │ │ │ +0003e440: 6461 7461 2069 6e20 5341 4645 2e0a 0a20  data in SAFE... 
│ │ │ │ +0003e450: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ +0003e460: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ +0003e470: 4849 5f4f 4b20 6966 6620 7375 6363 6573  HI_OK iff succes
│ │ │ │ +0003e480: 7366 756c 2e0a 0a73 6869 7368 695f 7361  sful...shishi_sa
│ │ │ │ +0003e490: 6665 5f62 7569 6c64 0a2d 2d2d 2d2d 2d2d  fe_build.-------
│ │ │ │ +0003e4a0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +0003e4b0: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ +0003e4c0: 6973 6869 5f73 6166 655f 6275 696c 6420  ishi_safe_build 
│ │ │ │ +0003e4d0: 2853 6869 7368 695f 7361 6665 202a 2053  (Shishi_safe * S
│ │ │ │ +0003e4e0: 4146 452c 0a20 2020 2020 2020 2020 2053  AFE,.          S
│ │ │ │ +0003e4f0: 6869 7368 695f 6b65 7920 2a20 4b45 5929  hishi_key * KEY)
│ │ │ │ +0003e500: 0a20 2020 2020 5341 4645 3a20 7361 6665  .     SAFE: safe
│ │ │ │ +0003e510: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ +0003e520: 20e2 8098 7368 6973 6869 5f73 6166 6528   ...shishi_safe(
│ │ │ │ +0003e530: 29e2 8099 2e0a 2020 2020 204b 4559 3a20  ).....     KEY: 
│ │ │ │ +0003e540: 6b65 7920 666f 7220 7365 7373 696f 6e2c  key for session,
│ │ │ │ +0003e550: 2075 7365 6420 746f 2063 6f6d 7075 7465   used to compute
│ │ │ │ +0003e560: 2063 6865 636b 7375 6d2e 0a0a 2020 2020   checksum...    
│ │ │ │ +0003e570: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ +0003e580: 4275 696c 6420 6368 6563 6b73 756d 2061  Build checksum a
│ │ │ │ +0003e590: 6e64 2073 6574 2069 7420 696e 204b 5242  nd set it in KRB
│ │ │ │ +0003e5a0: 2d53 4146 452e 204e 6f74 6520 7468 6174  -SAFE. Note that
│ │ │ │ +0003e5b0: 0a20 2020 2020 7468 6973 2066 6f6c 6c6f  .     this follo
│ │ │ │ +0003e5c0: 7773 2052 4643 2031 3531 3062 6973 2061  ws RFC 1510bis a
│ │ │ │ +0003e5d0: 6e64 2069 7320 696e 636f 6d70 6174 6962  nd is incompatib
│ │ │ │ +0003e5e0: 6c65 2077 6974 6820 5246 4320 3135 3130  le with RFC 1510
│ │ │ │ +0003e5f0: 2c0a 2020 2020 2061 6c74 686f 7567 6820  ,.     although 
│ │ │ │ +0003e600: 7072 6573 756d 6162 6c79 2066 6577 2069  presumably few i
│ │ │ │ +0003e610: 6d70 6c65 6d65 6e74 6174 696f 6e73 2075  mplementations u
│ │ │ │ +0003e620: 7365 2074 6865 2052 4643 3135 3130 2061  se the RFC1510 a
│ │ │ │ +0003e630: 6c67 6f72 6974 686d 2e0a 0a20 2020 2020  lgorithm...     
│ │ │ │ +0003e640: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ +0003e650: 5265 7475 726e 7320 5348 4953 4849 5f4f  Returns SHISHI_O
│ │ │ │ +0003e660: 4b20 6966 6620 7375 6363 6573 7366 756c  K iff successful
│ │ │ │ +0003e670: 2e0a 0a73 6869 7368 695f 7361 6665 5f76  ...shishi_safe_v
│ │ │ │ +0003e680: 6572 6966 790a 2d2d 2d2d 2d2d 2d2d 2d2d  erify.----------
│ │ │ │ +0003e690: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ +0003e6a0: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ +0003e6b0: 6869 5f73 6166 655f 7665 7269 6679 2028  hi_safe_verify (
│ │ │ │ +0003e6c0: 5368 6973 6869 5f73 6166 6520 2a20 5341  Shishi_safe * SA
│ │ │ │ +0003e6d0: 4645 2c0a 2020 2020 2020 2020 2020 5368  FE,.          Sh
│ │ │ │ +0003e6e0: 6973 6869 5f6b 6579 202a 204b 4559 290a  ishi_key * KEY).
│ │ │ │ +0003e6f0: 2020 2020 2053 4146 453a 2073 6166 6520       SAFE: safe 
│ │ │ │ +0003e700: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ +0003e710: e280 9873 6869 7368 695f 7361 6665 2829  ...shishi_safe()
│ │ │ │ +0003e720: e280 992e 0a20 2020 2020 4b45 593a 206b  .....     KEY: k
│ │ │ │ +0003e730: 6579 2066 6f72 2073 6573 7369 6f6e 2c20  ey for session, 
│ │ │ │ +0003e740: 7573 6564 2074 6f20 7665 7269 6679 2063  used to verify c
│ │ │ │ +0003e750: 6865 636b 7375 6d2e 0a0a 2020 2020 202a  hecksum...     *
│ │ │ │ +0003e760: 4465 7363 7269 7074 696f 6e3a 2a20 5665  Description:* Ve
│ │ │ │ +0003e770: 7269 6679 2063 6865 636b 7375 6d20 696e  rify checksum in
│ │ │ │ +0003e780: 204b 5242 2d53 4146 452e 204e 6f74 6520   KRB-SAFE. Note 
│ │ │ │ +0003e790: 7468 6174 2074 6869 7320 666f 6c6c 6f77  that this follow
│ │ │ │ +0003e7a0: 730a 2020 2020 2052 4643 2031 3531 3062  s.     RFC 1510b
│ │ │ │ +0003e7b0: 6973 2061 6e64 2069 7320 696e 636f 6d70  is and is incomp
│ │ │ │ +0003e7c0: 6174 6962 6c65 2077 6974 6820 5246 4320  atible with RFC 
│ │ │ │ +0003e7d0: 3135 3130 2c20 616c 7468 6f75 6768 2070  1510, although p
│ │ │ │ +0003e7e0: 7265 7375 6d61 626c 790a 2020 2020 2066  resumably.     f
│ │ │ │ +0003e7f0: 6577 2069 6d70 6c65 6d65 6e74 6174 696f  ew implementatio
│ │ │ │ +0003e800: 6e73 2075 7365 2074 6865 2052 4643 3135  ns use the RFC15
│ │ │ │ +0003e810: 3130 2061 6c67 6f72 6974 686d 2e0a 0a20  10 algorithm... 
│ │ │ │ +0003e820: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ +0003e830: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ +0003e840: 4849 5f4f 4b20 6966 6620 7375 6363 6573  HI_OK iff succes
│ │ │ │ +0003e850: 7366 756c 2c0a 2020 2020 2053 4849 5348  sful,.     SHISH
│ │ │ │ +0003e860: 495f 5341 4645 5f42 4144 5f4b 4559 5459  I_SAFE_BAD_KEYTY
│ │ │ │ +0003e870: 5045 2069 6620 616e 2069 6e63 6f6d 7061  PE if an incompa
│ │ │ │ +0003e880: 7469 626c 6520 6b65 7920 7479 7065 2069  tible key type i
│ │ │ │ +0003e890: 7320 7573 6564 2c20 6f72 0a20 2020 2020  s used, or.     
│ │ │ │ +0003e8a0: 5348 4953 4849 5f53 4146 455f 5645 5249  SHISHI_SAFE_VERI
│ │ │ │ +0003e8b0: 4659 5f46 4149 4c45 4420 6966 2074 6865  FY_FAILED if the
│ │ │ │ +0003e8c0: 2061 6374 7561 6c20 7665 7269 6669 6361   actual verifica
│ │ │ │ +0003e8d0: 7469 6f6e 2066 6169 6c65 642e 0a0a 2020  tion failed...  
│ │ │ │ +0003e8e0: 2054 6865 2022 4b52 422d 5052 4956 2220   The "KRB-PRIV" 
│ │ │ │ +0003e8f0: 6973 2061 6e20 4153 4e2e 3120 7374 7275  is an ASN.1 stru
│ │ │ │ +0003e900: 6374 7572 6520 7573 6564 2062 7920 6170  cture used by ap
│ │ │ │ +0003e910: 706c 6963 6174 696f 6e20 636c 6965 6e74  plication client
│ │ │ │ +0003e920: 2061 6e64 0a73 6572 7665 7273 2074 6f20   and.servers to 
│ │ │ │ +0003e930: 6578 6368 616e 6765 2063 6f6e 6669 6465  exchange confide
│ │ │ │ +0003e940: 6e74 6961 6c20 6461 7461 2e20 2054 6865  ntial data.  The
│ │ │ │ +0003e950: 2063 6f6e 6669 6465 6e74 6961 6c69 7479   confidentiality
│ │ │ │ +0003e960: 2069 7320 6b65 7965 642c 0a75 7375 616c   is keyed,.usual
│ │ │ │ +0003e970: 6c79 2077 6974 6820 6120 6b65 7920 6167  ly with a key ag
│ │ │ │ +0003e980: 7265 6564 206f 6e20 7669 6120 7468 6520  reed on via the 
│ │ │ │ +0003e990: 4150 2065 7863 6861 6e67 6520 282a 6e6f  AP exchange (*no
│ │ │ │ +0003e9a0: 7465 2041 502d 5245 5120 616e 640a 4150  te AP-REQ and.AP
│ │ │ │ +0003e9b0: 2d52 4550 2046 756e 6374 696f 6e73 3a3a  -REP Functions::
│ │ │ │ +0003e9c0: 292e 2020 5468 6520 666f 6c6c 6f77 696e  ).  The followin
│ │ │ │ +0003e9d0: 6720 696c 6c75 7374 7261 7465 7320 7468  g illustrates th
│ │ │ │ +0003e9e0: 6520 4b52 422d 5052 4956 2041 534e 2e31  e KRB-PRIV ASN.1
│ │ │ │ +0003e9f0: 0a73 7472 7563 7475 7265 2e0a 0a20 2020  .structure...   
│ │ │ │ +0003ea00: 4b52 422d 5052 4956 2020 2020 2020 2020  KRB-PRIV        
│ │ │ │ +0003ea10: 3a3a 3d20 5b41 5050 4c49 4341 5449 4f4e  ::= [APPLICATION
│ │ │ │ +0003ea20: 2032 315d 2053 4551 5545 4e43 4520 7b0a   21] SEQUENCE {.
│ │ │ │ +0003ea30: 2020 2020 2020 2020 2020 2070 766e 6f20             pvno 
│ │ │ │ +0003ea40: 2020 2020 2020 2020 2020 205b 305d 2049             [0] I
│ │ │ │ +0003ea50: 4e54 4547 4552 2028 3529 2c0a 2020 2020  NTEGER (5),.    
│ │ │ │ +0003ea60: 2020 2020 2020 206d 7367 2d74 7970 6520         msg-type 
│ │ │ │ +0003ea70: 2020 2020 2020 205b 315d 2049 4e54 4547         [1] INTEG
│ │ │ │ +0003ea80: 4552 2028 3231 292c 0a20 2020 2020 2020  ER (21),.       
│ │ │ │  0003ea90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0003eaa0: 2020 2d2d 204e 4f54 453a 2074 6865 7265    -- NOTE: there
│ │ │ │ -0003eab0: 2069 7320 6e6f 205b 325d 2074 6167 0a20   is no [2] tag. 
│ │ │ │ -0003eac0: 2020 2020 2020 2020 2020 656e 632d 7061            enc-pa
│ │ │ │ -0003ead0: 7274 2020 2020 2020 2020 5b33 5d20 456e  rt        [3] En
│ │ │ │ -0003eae0: 6372 7970 7465 6444 6174 6120 2d2d 2045  cryptedData -- E
│ │ │ │ -0003eaf0: 6e63 4b72 6250 7269 7650 6172 740a 2020  ncKrbPrivPart.  
│ │ │ │ -0003eb00: 207d 0a0a 2020 2045 6e63 4b72 6250 7269   }..   EncKrbPri
│ │ │ │ -0003eb10: 7650 6172 7420 203a 3a3d 205b 4150 504c  vPart  ::= [APPL
│ │ │ │ -0003eb20: 4943 4154 494f 4e20 3238 5d20 5345 5155  ICATION 28] SEQU
│ │ │ │ -0003eb30: 454e 4345 207b 0a20 2020 2020 2020 2020  ENCE {.         
│ │ │ │ -0003eb40: 2020 7573 6572 2d64 6174 6120 2020 2020    user-data     
│ │ │ │ -0003eb50: 2020 5b30 5d20 4f43 5445 5420 5354 5249    [0] OCTET STRI
│ │ │ │ -0003eb60: 4e47 2c0a 2020 2020 2020 2020 2020 2074  NG,.           t
│ │ │ │ -0003eb70: 696d 6573 7461 6d70 2020 2020 2020 205b  imestamp       [
│ │ │ │ -0003eb80: 315d 204b 6572 6265 726f 7354 696d 6520  1] KerberosTime 
│ │ │ │ -0003eb90: 4f50 5449 4f4e 414c 2c0a 2020 2020 2020  OPTIONAL,.      
│ │ │ │ -0003eba0: 2020 2020 2075 7365 6320 2020 2020 2020       usec       
│ │ │ │ -0003ebb0: 2020 2020 205b 325d 204d 6963 726f 7365       [2] Microse
│ │ │ │ -0003ebc0: 636f 6e64 7320 4f50 5449 4f4e 414c 2c0a  conds OPTIONAL,.
│ │ │ │ -0003ebd0: 2020 2020 2020 2020 2020 2073 6571 2d6e             seq-n
│ │ │ │ -0003ebe0: 756d 6265 7220 2020 2020 205b 335d 2055  umber      [3] U
│ │ │ │ -0003ebf0: 496e 7433 3220 4f50 5449 4f4e 414c 2c0a  Int32 OPTIONAL,.
│ │ │ │ -0003ec00: 2020 2020 2020 2020 2020 2073 2d61 6464             s-add
│ │ │ │ -0003ec10: 7265 7373 2020 2020 2020 205b 345d 2048  ress       [4] H
│ │ │ │ -0003ec20: 6f73 7441 6464 7265 7373 202d 2d20 7365  ostAddress -- se
│ │ │ │ -0003ec30: 6e64 6572 2773 2061 6464 7220 2d2d 2c0a  nder's addr --,.
│ │ │ │ -0003ec40: 2020 2020 2020 2020 2020 2072 2d61 6464             r-add
│ │ │ │ -0003ec50: 7265 7373 2020 2020 2020 205b 355d 2048  ress       [5] H
│ │ │ │ -0003ec60: 6f73 7441 6464 7265 7373 204f 5054 494f  ostAddress OPTIO
│ │ │ │ -0003ec70: 4e41 4c20 2d2d 2072 6563 6970 2773 2061  NAL -- recip's a
│ │ │ │ -0003ec80: 6464 720a 2020 207d 0a0a 7368 6973 6869  ddr.   }..shishi
│ │ │ │ -0003ec90: 5f70 7269 760a 2d2d 2d2d 2d2d 2d2d 2d2d  _priv.----------
│ │ │ │ -0003eca0: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ -0003ecb0: 2069 6e74 2073 6869 7368 695f 7072 6976   int shishi_priv
│ │ │ │ -0003ecc0: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ -0003ecd0: 452c 2053 6869 7368 695f 7072 6976 202a  E, Shishi_priv *
│ │ │ │ -0003ece0: 2a20 5052 4956 290a 2020 2020 2048 414e  * PRIV).     HAN
│ │ │ │ -0003ecf0: 444c 453a 2073 6869 7368 6920 6861 6e64  DLE: shishi hand
│ │ │ │ -0003ed00: 6c65 2061 7320 616c 6c6f 6361 7465 6420  le as allocated 
│ │ │ │ -0003ed10: 6279 20e2 8098 7368 6973 6869 5f69 6e69  by ...shishi_ini
│ │ │ │ -0003ed20: 7428 29e2 8099 2e0a 2020 2020 2050 5249  t().....     PRI
│ │ │ │ -0003ed30: 563a 2070 6f69 6e74 6572 2074 6f20 6e65  V: pointer to ne
│ │ │ │ -0003ed40: 7720 7374 7275 6374 7572 6520 7468 6174  w structure that
│ │ │ │ -0003ed50: 2068 6f6c 6473 2069 6e66 6f72 6d61 7469   holds informati
│ │ │ │ -0003ed60: 6f6e 2061 626f 7574 2050 5249 560a 2020  on about PRIV.  
│ │ │ │ -0003ed70: 2020 2065 7863 6861 6e67 650a 0a20 2020     exchange..   
│ │ │ │ -0003ed80: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ -0003ed90: 2043 7265 6174 6520 6120 6e65 7720 5052   Create a new PR
│ │ │ │ -0003eda0: 4956 2065 7863 6861 6e67 652e 0a0a 2020  IV exchange...  
│ │ │ │ -0003edb0: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ -0003edc0: 3a2a 2052 6574 7572 6e73 2053 4849 5348  :* Returns SHISH
│ │ │ │ -0003edd0: 495f 4f4b 2069 6666 2073 7563 6365 7373  I_OK iff success
│ │ │ │ -0003ede0: 6675 6c2e 0a0a 7368 6973 6869 5f70 7269  ful...shishi_pri
│ │ │ │ -0003edf0: 765f 646f 6e65 0a2d 2d2d 2d2d 2d2d 2d2d  v_done.---------
│ │ │ │ -0003ee00: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ -0003ee10: 6374 696f 6e3a 2076 6f69 6420 7368 6973  ction: void shis
│ │ │ │ -0003ee20: 6869 5f70 7269 765f 646f 6e65 2028 5368  hi_priv_done (Sh
│ │ │ │ -0003ee30: 6973 6869 5f70 7269 7620 2a20 5052 4956  ishi_priv * PRIV
│ │ │ │ -0003ee40: 290a 2020 2020 2050 5249 563a 2073 7472  ).     PRIV: str
│ │ │ │ -0003ee50: 7563 7475 7265 2074 6861 7420 686f 6c64  ucture that hold
│ │ │ │ -0003ee60: 7320 696e 666f 726d 6174 696f 6e20 6162  s information ab
│ │ │ │ -0003ee70: 6f75 7420 5052 4956 2065 7863 6861 6e67  out PRIV exchang
│ │ │ │ -0003ee80: 650a 0a20 2020 2020 2a44 6573 6372 6970  e..     *Descrip
│ │ │ │ -0003ee90: 7469 6f6e 3a2a 2044 6561 6c6c 6f63 6174  tion:* Deallocat
│ │ │ │ -0003eea0: 6520 7265 736f 7572 6365 7320 6173 736f  e resources asso
│ │ │ │ -0003eeb0: 6369 6174 6564 2077 6974 6820 5052 4956  ciated with PRIV
│ │ │ │ -0003eec0: 2065 7863 6861 6e67 652e 0a20 2020 2020   exchange..     
│ │ │ │ -0003eed0: 5468 6973 2073 686f 756c 6420 6265 2063  This should be c
│ │ │ │ -0003eee0: 616c 6c65 6420 6279 2074 6865 2061 7070  alled by the app
│ │ │ │ -0003eef0: 6c69 6361 7469 6f6e 2077 6865 6e20 6974  lication when it
│ │ │ │ -0003ef00: 206e 6f20 6c6f 6e67 6572 206e 6565 6420   no longer need 
│ │ │ │ -0003ef10: 746f 0a20 2020 2020 7574 696c 697a 6520  to.     utilize 
│ │ │ │ -0003ef20: 7468 6520 5052 4956 2065 7863 6861 6e67  the PRIV exchang
│ │ │ │ -0003ef30: 6520 6861 6e64 6c65 2e0a 0a73 6869 7368  e handle...shish
│ │ │ │ -0003ef40: 695f 7072 6976 5f6b 6579 0a2d 2d2d 2d2d  i_priv_key.-----
│ │ │ │ -0003ef50: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ -0003ef60: 4675 6e63 7469 6f6e 3a20 5368 6973 6869  Function: Shishi
│ │ │ │ -0003ef70: 5f6b 6579 202a 2073 6869 7368 695f 7072  _key * shishi_pr
│ │ │ │ -0003ef80: 6976 5f6b 6579 2028 5368 6973 6869 5f70  iv_key (Shishi_p
│ │ │ │ -0003ef90: 7269 7620 2a20 5052 4956 290a 2020 2020  riv * PRIV).    
│ │ │ │ -0003efa0: 2050 5249 563a 2073 7472 7563 7475 7265   PRIV: structure
│ │ │ │ -0003efb0: 2074 6861 7420 686f 6c64 7320 696e 666f   that holds info
│ │ │ │ -0003efc0: 726d 6174 696f 6e20 6162 6f75 7420 5052  rmation about PR
│ │ │ │ -0003efd0: 4956 2065 7863 6861 6e67 650a 0a20 2020  IV exchange..   
│ │ │ │ -0003efe0: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ -0003eff0: 2047 6574 206b 6579 2066 726f 6d20 5052   Get key from PR
│ │ │ │ -0003f000: 4956 2065 7863 6861 6e67 652e 0a0a 2020  IV exchange...  
│ │ │ │ -0003f010: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ -0003f020: 3a2a 2052 6574 7572 6e73 2074 6865 206b  :* Returns the k
│ │ │ │ -0003f030: 6579 2075 7365 6420 696e 2074 6865 2050  ey used in the P
│ │ │ │ -0003f040: 5249 5620 6578 6368 616e 6765 2c20 6f72  RIV exchange, or
│ │ │ │ -0003f050: 204e 554c 4c0a 2020 2020 2069 6620 6e6f   NULL.     if no
│ │ │ │ -0003f060: 7420 7965 7420 7365 7420 6f72 2061 6e20  t yet set or an 
│ │ │ │ -0003f070: 6572 726f 7220 6f63 6375 7265 642e 0a0a  error occured...
│ │ │ │ -0003f080: 7368 6973 6869 5f70 7269 765f 6b65 795f  shishi_priv_key_
│ │ │ │ -0003f090: 7365 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  set.------------
│ │ │ │ -0003f0a0: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ -0003f0b0: 6374 696f 6e3a 2076 6f69 6420 7368 6973  ction: void shis
│ │ │ │ -0003f0c0: 6869 5f70 7269 765f 6b65 795f 7365 7420  hi_priv_key_set 
│ │ │ │ -0003f0d0: 2853 6869 7368 695f 7072 6976 202a 2050  (Shishi_priv * P
│ │ │ │ -0003f0e0: 5249 562c 0a20 2020 2020 2020 2020 2053  RIV,.          S
│ │ │ │ -0003f0f0: 6869 7368 695f 6b65 7920 2a20 4b45 5929  hishi_key * KEY)
│ │ │ │ -0003f100: 0a20 2020 2020 5052 4956 3a20 7374 7275  .     PRIV: stru
│ │ │ │ -0003f110: 6374 7572 6520 7468 6174 2068 6f6c 6473  cture that holds
│ │ │ │ -0003f120: 2069 6e66 6f72 6d61 7469 6f6e 2061 626f   information abo
│ │ │ │ -0003f130: 7574 2050 5249 5620 6578 6368 616e 6765  ut PRIV exchange
│ │ │ │ -0003f140: 0a20 2020 2020 4b45 593a 206b 6579 2074  .     KEY: key t
│ │ │ │ -0003f150: 6f20 7374 6f72 6520 696e 2050 5249 562e  o store in PRIV.
│ │ │ │ -0003f160: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ -0003f170: 696f 6e3a 2a20 5365 7420 7468 6520 4b65  ion:* Set the Ke
│ │ │ │ -0003f180: 7920 696e 2074 6865 2050 5249 5620 6578  y in the PRIV ex
│ │ │ │ -0003f190: 6368 616e 6765 2e0a 0a73 6869 7368 695f  change...shishi_
│ │ │ │ -0003f1a0: 7072 6976 5f70 7269 760a 2d2d 2d2d 2d2d  priv_priv.------
│ │ │ │ -0003f1b0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ -0003f1c0: 4675 6e63 7469 6f6e 3a20 5368 6973 6869  Function: Shishi
│ │ │ │ -0003f1d0: 5f61 736e 3120 7368 6973 6869 5f70 7269  _asn1 shishi_pri
│ │ │ │ -0003f1e0: 765f 7072 6976 2028 5368 6973 6869 5f70  v_priv (Shishi_p
│ │ │ │ -0003f1f0: 7269 7620 2a20 5052 4956 290a 2020 2020  riv * PRIV).    
│ │ │ │ -0003f200: 2050 5249 563a 2073 7472 7563 7475 7265   PRIV: structure
│ │ │ │ -0003f210: 2074 6861 7420 686f 6c64 7320 696e 666f   that holds info
│ │ │ │ -0003f220: 726d 6174 696f 6e20 6162 6f75 7420 5052  rmation about PR
│ │ │ │ -0003f230: 4956 2065 7863 6861 6e67 650a 0a20 2020  IV exchange..   
│ │ │ │ -0003f240: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ -0003f250: 2047 6574 2041 534e 2e31 2050 5249 5620   Get ASN.1 PRIV 
│ │ │ │ -0003f260: 7374 7275 6374 7572 6520 696e 2050 5249  structure in PRI
│ │ │ │ -0003f270: 5620 6578 6368 616e 6765 2e0a 0a20 2020  V exchange...   
│ │ │ │ -0003f280: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ -0003f290: 2a20 5265 7475 726e 7320 7468 6520 4153  * Returns the AS
│ │ │ │ -0003f2a0: 4e2e 3120 7072 6976 2069 6e20 7468 6520  N.1 priv in the 
│ │ │ │ -0003f2b0: 5052 4956 2065 7863 6861 6e67 652c 206f  PRIV exchange, o
│ │ │ │ -0003f2c0: 720a 2020 2020 204e 554c 4c20 6966 206e  r.     NULL if n
│ │ │ │ -0003f2d0: 6f74 2079 6574 2073 6574 206f 7220 616e  ot yet set or an
│ │ │ │ -0003f2e0: 2065 7272 6f72 206f 6363 7572 6564 2e0a   error occured..
│ │ │ │ -0003f2f0: 0a73 6869 7368 695f 7072 6976 5f70 7269  .shishi_priv_pri
│ │ │ │ -0003f300: 765f 7365 740a 2d2d 2d2d 2d2d 2d2d 2d2d  v_set.----------
│ │ │ │ -0003f310: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ -0003f320: 4675 6e63 7469 6f6e 3a20 766f 6964 2073  Function: void s
│ │ │ │ -0003f330: 6869 7368 695f 7072 6976 5f70 7269 765f  hishi_priv_priv_
│ │ │ │ -0003f340: 7365 7420 2853 6869 7368 695f 7072 6976  set (Shishi_priv
│ │ │ │ -0003f350: 202a 2050 5249 562c 0a20 2020 2020 2020   * PRIV,.       
│ │ │ │ -0003f360: 2020 2053 6869 7368 695f 6173 6e31 2041     Shishi_asn1 A
│ │ │ │ -0003f370: 534e 3150 5249 5629 0a20 2020 2020 5052  SN1PRIV).     PR
│ │ │ │ -0003f380: 4956 3a20 7374 7275 6374 7572 6520 7468  IV: structure th
│ │ │ │ -0003f390: 6174 2068 6f6c 6473 2069 6e66 6f72 6d61  at holds informa
│ │ │ │ -0003f3a0: 7469 6f6e 2061 626f 7574 2050 5249 5620  tion about PRIV 
│ │ │ │ -0003f3b0: 6578 6368 616e 6765 0a20 2020 2020 4153  exchange.     AS
│ │ │ │ -0003f3c0: 4e31 5052 4956 3a20 4b52 422d 5052 4956  N1PRIV: KRB-PRIV
│ │ │ │ -0003f3d0: 2074 6f20 7374 6f72 6520 696e 2050 5249   to store in PRI
│ │ │ │ -0003f3e0: 5620 6578 6368 616e 6765 2e0a 0a20 2020  V exchange...   
│ │ │ │ -0003f3f0: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ -0003f400: 2053 6574 2074 6865 204b 5242 2d50 5249   Set the KRB-PRI
│ │ │ │ -0003f410: 5620 696e 2074 6865 2050 5249 5620 6578  V in the PRIV ex
│ │ │ │ -0003f420: 6368 616e 6765 2e0a 0a73 6869 7368 695f  change...shishi_
│ │ │ │ -0003f430: 7072 6976 5f70 7269 765f 6465 720a 2d2d  priv_priv_der.--
│ │ │ │ +0003eaa0: 2020 2020 2d2d 204e 4f54 453a 2074 6865      -- NOTE: the
│ │ │ │ +0003eab0: 7265 2069 7320 6e6f 205b 325d 2074 6167  re is no [2] tag
│ │ │ │ +0003eac0: 0a20 2020 2020 2020 2020 2020 656e 632d  .           enc-
│ │ │ │ +0003ead0: 7061 7274 2020 2020 2020 2020 5b33 5d20  part        [3] 
│ │ │ │ +0003eae0: 456e 6372 7970 7465 6444 6174 6120 2d2d  EncryptedData --
│ │ │ │ +0003eaf0: 2045 6e63 4b72 6250 7269 7650 6172 740a   EncKrbPrivPart.
│ │ │ │ +0003eb00: 2020 207d 0a0a 2020 2045 6e63 4b72 6250     }..   EncKrbP
│ │ │ │ +0003eb10: 7269 7650 6172 7420 203a 3a3d 205b 4150  rivPart  ::= [AP
│ │ │ │ +0003eb20: 504c 4943 4154 494f 4e20 3238 5d20 5345  PLICATION 28] SE
│ │ │ │ +0003eb30: 5155 454e 4345 207b 0a20 2020 2020 2020  QUENCE {.       
│ │ │ │ +0003eb40: 2020 2020 7573 6572 2d64 6174 6120 2020      user-data   
│ │ │ │ +0003eb50: 2020 2020 5b30 5d20 4f43 5445 5420 5354      [0] OCTET ST
│ │ │ │ +0003eb60: 5249 4e47 2c0a 2020 2020 2020 2020 2020  RING,.          
│ │ │ │ +0003eb70: 2074 696d 6573 7461 6d70 2020 2020 2020   timestamp      
│ │ │ │ +0003eb80: 205b 315d 204b 6572 6265 726f 7354 696d   [1] KerberosTim
│ │ │ │ +0003eb90: 6520 4f50 5449 4f4e 414c 2c0a 2020 2020  e OPTIONAL,.    
│ │ │ │ +0003eba0: 2020 2020 2020 2075 7365 6320 2020 2020         usec     
│ │ │ │ +0003ebb0: 2020 2020 2020 205b 325d 204d 6963 726f         [2] Micro
│ │ │ │ +0003ebc0: 7365 636f 6e64 7320 4f50 5449 4f4e 414c  seconds OPTIONAL
│ │ │ │ +0003ebd0: 2c0a 2020 2020 2020 2020 2020 2073 6571  ,.           seq
│ │ │ │ +0003ebe0: 2d6e 756d 6265 7220 2020 2020 205b 335d  -number      [3]
│ │ │ │ +0003ebf0: 2055 496e 7433 3220 4f50 5449 4f4e 414c   UInt32 OPTIONAL
│ │ │ │ +0003ec00: 2c0a 2020 2020 2020 2020 2020 2073 2d61  ,.           s-a
│ │ │ │ +0003ec10: 6464 7265 7373 2020 2020 2020 205b 345d  ddress       [4]
│ │ │ │ +0003ec20: 2048 6f73 7441 6464 7265 7373 202d 2d20   HostAddress -- 
│ │ │ │ +0003ec30: 7365 6e64 6572 2773 2061 6464 7220 2d2d  sender's addr --
│ │ │ │ +0003ec40: 2c0a 2020 2020 2020 2020 2020 2072 2d61  ,.           r-a
│ │ │ │ +0003ec50: 6464 7265 7373 2020 2020 2020 205b 355d  ddress       [5]
│ │ │ │ +0003ec60: 2048 6f73 7441 6464 7265 7373 204f 5054   HostAddress OPT
│ │ │ │ +0003ec70: 494f 4e41 4c20 2d2d 2072 6563 6970 2773  IONAL -- recip's
│ │ │ │ +0003ec80: 2061 6464 720a 2020 207d 0a0a 7368 6973   addr.   }..shis
│ │ │ │ +0003ec90: 6869 5f70 7269 760a 2d2d 2d2d 2d2d 2d2d  hi_priv.--------
│ │ │ │ +0003eca0: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ +0003ecb0: 6e3a 2069 6e74 2073 6869 7368 695f 7072  n: int shishi_pr
│ │ │ │ +0003ecc0: 6976 2028 5368 6973 6869 202a 2048 414e  iv (Shishi * HAN
│ │ │ │ +0003ecd0: 444c 452c 2053 6869 7368 695f 7072 6976  DLE, Shishi_priv
│ │ │ │ +0003ece0: 202a 2a20 5052 4956 290a 2020 2020 2048   ** PRIV).     H
│ │ │ │ +0003ecf0: 414e 444c 453a 2073 6869 7368 6920 6861  ANDLE: shishi ha
│ │ │ │ +0003ed00: 6e64 6c65 2061 7320 616c 6c6f 6361 7465  ndle as allocate
│ │ │ │ +0003ed10: 6420 6279 20e2 8098 7368 6973 6869 5f69  d by ...shishi_i
│ │ │ │ +0003ed20: 6e69 7428 29e2 8099 2e0a 2020 2020 2050  nit().....     P
│ │ │ │ +0003ed30: 5249 563a 2070 6f69 6e74 6572 2074 6f20  RIV: pointer to 
│ │ │ │ +0003ed40: 6e65 7720 7374 7275 6374 7572 6520 7468  new structure th
│ │ │ │ +0003ed50: 6174 2068 6f6c 6473 2069 6e66 6f72 6d61  at holds informa
│ │ │ │ +0003ed60: 7469 6f6e 2061 626f 7574 2050 5249 560a  tion about PRIV.
│ │ │ │ +0003ed70: 2020 2020 2065 7863 6861 6e67 650a 0a20       exchange.. 
│ │ │ │ +0003ed80: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ +0003ed90: 3a2a 2043 7265 6174 6520 6120 6e65 7720  :* Create a new 
│ │ │ │ +0003eda0: 5052 4956 2065 7863 6861 6e67 652e 0a0a  PRIV exchange...
│ │ │ │ +0003edb0: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ +0003edc0: 7565 3a2a 2052 6574 7572 6e73 2053 4849  ue:* Returns SHI
│ │ │ │ +0003edd0: 5348 495f 4f4b 2069 6666 2073 7563 6365  SHI_OK iff succe
│ │ │ │ +0003ede0: 7373 6675 6c2e 0a0a 7368 6973 6869 5f70  ssful...shishi_p
│ │ │ │ +0003edf0: 7269 765f 646f 6e65 0a2d 2d2d 2d2d 2d2d  riv_done.-------
│ │ │ │ +0003ee00: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +0003ee10: 756e 6374 696f 6e3a 2076 6f69 6420 7368  unction: void sh
│ │ │ │ +0003ee20: 6973 6869 5f70 7269 765f 646f 6e65 2028  ishi_priv_done (
│ │ │ │ +0003ee30: 5368 6973 6869 5f70 7269 7620 2a20 5052  Shishi_priv * PR
│ │ │ │ +0003ee40: 4956 290a 2020 2020 2050 5249 563a 2073  IV).     PRIV: s
│ │ │ │ +0003ee50: 7472 7563 7475 7265 2074 6861 7420 686f  tructure that ho
│ │ │ │ +0003ee60: 6c64 7320 696e 666f 726d 6174 696f 6e20  lds information 
│ │ │ │ +0003ee70: 6162 6f75 7420 5052 4956 2065 7863 6861  about PRIV excha
│ │ │ │ +0003ee80: 6e67 650a 0a20 2020 2020 2a44 6573 6372  nge..     *Descr
│ │ │ │ +0003ee90: 6970 7469 6f6e 3a2a 2044 6561 6c6c 6f63  iption:* Dealloc
│ │ │ │ +0003eea0: 6174 6520 7265 736f 7572 6365 7320 6173  ate resources as
│ │ │ │ +0003eeb0: 736f 6369 6174 6564 2077 6974 6820 5052  sociated with PR
│ │ │ │ +0003eec0: 4956 2065 7863 6861 6e67 652e 0a20 2020  IV exchange..   
│ │ │ │ +0003eed0: 2020 5468 6973 2073 686f 756c 6420 6265    This should be
│ │ │ │ +0003eee0: 2063 616c 6c65 6420 6279 2074 6865 2061   called by the a
│ │ │ │ +0003eef0: 7070 6c69 6361 7469 6f6e 2077 6865 6e20  pplication when 
│ │ │ │ +0003ef00: 6974 206e 6f20 6c6f 6e67 6572 206e 6565  it no longer nee
│ │ │ │ +0003ef10: 6420 746f 0a20 2020 2020 7574 696c 697a  d to.     utiliz
│ │ │ │ +0003ef20: 6520 7468 6520 5052 4956 2065 7863 6861  e the PRIV excha
│ │ │ │ +0003ef30: 6e67 6520 6861 6e64 6c65 2e0a 0a73 6869  nge handle...shi
│ │ │ │ +0003ef40: 7368 695f 7072 6976 5f6b 6579 0a2d 2d2d  shi_priv_key.---
│ │ │ │ +0003ef50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ +0003ef60: 2d20 4675 6e63 7469 6f6e 3a20 5368 6973  - Function: Shis
│ │ │ │ +0003ef70: 6869 5f6b 6579 202a 2073 6869 7368 695f  hi_key * shishi_
│ │ │ │ +0003ef80: 7072 6976 5f6b 6579 2028 5368 6973 6869  priv_key (Shishi
│ │ │ │ +0003ef90: 5f70 7269 7620 2a20 5052 4956 290a 2020  _priv * PRIV).  
│ │ │ │ +0003efa0: 2020 2050 5249 563a 2073 7472 7563 7475     PRIV: structu
│ │ │ │ +0003efb0: 7265 2074 6861 7420 686f 6c64 7320 696e  re that holds in
│ │ │ │ +0003efc0: 666f 726d 6174 696f 6e20 6162 6f75 7420  formation about 
│ │ │ │ +0003efd0: 5052 4956 2065 7863 6861 6e67 650a 0a20  PRIV exchange.. 
│ │ │ │ +0003efe0: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ +0003eff0: 3a2a 2047 6574 206b 6579 2066 726f 6d20  :* Get key from 
│ │ │ │ +0003f000: 5052 4956 2065 7863 6861 6e67 652e 0a0a  PRIV exchange...
│ │ │ │ +0003f010: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ +0003f020: 7565 3a2a 2052 6574 7572 6e73 2074 6865  ue:* Returns the
│ │ │ │ +0003f030: 206b 6579 2075 7365 6420 696e 2074 6865   key used in the
│ │ │ │ +0003f040: 2050 5249 5620 6578 6368 616e 6765 2c20   PRIV exchange, 
│ │ │ │ +0003f050: 6f72 204e 554c 4c0a 2020 2020 2069 6620  or NULL.     if 
│ │ │ │ +0003f060: 6e6f 7420 7965 7420 7365 7420 6f72 2061  not yet set or a
│ │ │ │ +0003f070: 6e20 6572 726f 7220 6f63 6375 7265 642e  n error occured.
│ │ │ │ +0003f080: 0a0a 7368 6973 6869 5f70 7269 765f 6b65  ..shishi_priv_ke
│ │ │ │ +0003f090: 795f 7365 740a 2d2d 2d2d 2d2d 2d2d 2d2d  y_set.----------
│ │ │ │ +0003f0a0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +0003f0b0: 756e 6374 696f 6e3a 2076 6f69 6420 7368  unction: void sh
│ │ │ │ +0003f0c0: 6973 6869 5f70 7269 765f 6b65 795f 7365  ishi_priv_key_se
│ │ │ │ +0003f0d0: 7420 2853 6869 7368 695f 7072 6976 202a  t (Shishi_priv *
│ │ │ │ +0003f0e0: 2050 5249 562c 0a20 2020 2020 2020 2020   PRIV,.         
│ │ │ │ +0003f0f0: 2053 6869 7368 695f 6b65 7920 2a20 4b45   Shishi_key * KE
│ │ │ │ +0003f100: 5929 0a20 2020 2020 5052 4956 3a20 7374  Y).     PRIV: st
│ │ │ │ +0003f110: 7275 6374 7572 6520 7468 6174 2068 6f6c  ructure that hol
│ │ │ │ +0003f120: 6473 2069 6e66 6f72 6d61 7469 6f6e 2061  ds information a
│ │ │ │ +0003f130: 626f 7574 2050 5249 5620 6578 6368 616e  bout PRIV exchan
│ │ │ │ +0003f140: 6765 0a20 2020 2020 4b45 593a 206b 6579  ge.     KEY: key
│ │ │ │ +0003f150: 2074 6f20 7374 6f72 6520 696e 2050 5249   to store in PRI
│ │ │ │ +0003f160: 562e 0a0a 2020 2020 202a 4465 7363 7269  V...     *Descri
│ │ │ │ +0003f170: 7074 696f 6e3a 2a20 5365 7420 7468 6520  ption:* Set the 
│ │ │ │ +0003f180: 4b65 7920 696e 2074 6865 2050 5249 5620  Key in the PRIV 
│ │ │ │ +0003f190: 6578 6368 616e 6765 2e0a 0a73 6869 7368  exchange...shish
│ │ │ │ +0003f1a0: 695f 7072 6976 5f70 7269 760a 2d2d 2d2d  i_priv_priv.----
│ │ │ │ +0003f1b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ +0003f1c0: 2d20 4675 6e63 7469 6f6e 3a20 5368 6973  - Function: Shis
│ │ │ │ +0003f1d0: 6869 5f61 736e 3120 7368 6973 6869 5f70  hi_asn1 shishi_p
│ │ │ │ +0003f1e0: 7269 765f 7072 6976 2028 5368 6973 6869  riv_priv (Shishi
│ │ │ │ +0003f1f0: 5f70 7269 7620 2a20 5052 4956 290a 2020  _priv * PRIV).  
│ │ │ │ +0003f200: 2020 2050 5249 563a 2073 7472 7563 7475     PRIV: structu
│ │ │ │ +0003f210: 7265 2074 6861 7420 686f 6c64 7320 696e  re that holds in
│ │ │ │ +0003f220: 666f 726d 6174 696f 6e20 6162 6f75 7420  formation about 
│ │ │ │ +0003f230: 5052 4956 2065 7863 6861 6e67 650a 0a20  PRIV exchange.. 
│ │ │ │ +0003f240: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ +0003f250: 3a2a 2047 6574 2041 534e 2e31 2050 5249  :* Get ASN.1 PRI
│ │ │ │ +0003f260: 5620 7374 7275 6374 7572 6520 696e 2050  V structure in P
│ │ │ │ +0003f270: 5249 5620 6578 6368 616e 6765 2e0a 0a20  RIV exchange... 
│ │ │ │ +0003f280: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ +0003f290: 653a 2a20 5265 7475 726e 7320 7468 6520  e:* Returns the 
│ │ │ │ +0003f2a0: 4153 4e2e 3120 7072 6976 2069 6e20 7468  ASN.1 priv in th
│ │ │ │ +0003f2b0: 6520 5052 4956 2065 7863 6861 6e67 652c  e PRIV exchange,
│ │ │ │ +0003f2c0: 206f 720a 2020 2020 204e 554c 4c20 6966   or.     NULL if
│ │ │ │ +0003f2d0: 206e 6f74 2079 6574 2073 6574 206f 7220   not yet set or 
│ │ │ │ +0003f2e0: 616e 2065 7272 6f72 206f 6363 7572 6564  an error occured
│ │ │ │ +0003f2f0: 2e0a 0a73 6869 7368 695f 7072 6976 5f70  ...shishi_priv_p
│ │ │ │ +0003f300: 7269 765f 7365 740a 2d2d 2d2d 2d2d 2d2d  riv_set.--------
│ │ │ │ +0003f310: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ +0003f320: 2d20 4675 6e63 7469 6f6e 3a20 766f 6964  - Function: void
│ │ │ │ +0003f330: 2073 6869 7368 695f 7072 6976 5f70 7269   shishi_priv_pri
│ │ │ │ +0003f340: 765f 7365 7420 2853 6869 7368 695f 7072  v_set (Shishi_pr
│ │ │ │ +0003f350: 6976 202a 2050 5249 562c 0a20 2020 2020  iv * PRIV,.     
│ │ │ │ +0003f360: 2020 2020 2053 6869 7368 695f 6173 6e31       Shishi_asn1
│ │ │ │ +0003f370: 2041 534e 3150 5249 5629 0a20 2020 2020   ASN1PRIV).     
│ │ │ │ +0003f380: 5052 4956 3a20 7374 7275 6374 7572 6520  PRIV: structure 
│ │ │ │ +0003f390: 7468 6174 2068 6f6c 6473 2069 6e66 6f72  that holds infor
│ │ │ │ +0003f3a0: 6d61 7469 6f6e 2061 626f 7574 2050 5249  mation about PRI
│ │ │ │ +0003f3b0: 5620 6578 6368 616e 6765 0a20 2020 2020  V exchange.     
│ │ │ │ +0003f3c0: 4153 4e31 5052 4956 3a20 4b52 422d 5052  ASN1PRIV: KRB-PR
│ │ │ │ +0003f3d0: 4956 2074 6f20 7374 6f72 6520 696e 2050  IV to store in P
│ │ │ │ +0003f3e0: 5249 5620 6578 6368 616e 6765 2e0a 0a20  RIV exchange... 
│ │ │ │ +0003f3f0: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ +0003f400: 3a2a 2053 6574 2074 6865 204b 5242 2d50  :* Set the KRB-P
│ │ │ │ +0003f410: 5249 5620 696e 2074 6865 2050 5249 5620  RIV in the PRIV 
│ │ │ │ +0003f420: 6578 6368 616e 6765 2e0a 0a73 6869 7368  exchange...shish
│ │ │ │ +0003f430: 695f 7072 6976 5f70 7269 765f 6465 720a  i_priv_priv_der.
│ │ │ │  0003f440: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0003f450: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ -0003f460: 3a20 696e 7420 7368 6973 6869 5f70 7269  : int shishi_pri
│ │ │ │ -0003f470: 765f 7072 6976 5f64 6572 2028 5368 6973  v_priv_der (Shis
│ │ │ │ -0003f480: 6869 5f70 7269 7620 2a20 5052 4956 2c20  hi_priv * PRIV, 
│ │ │ │ -0003f490: 6368 6172 202a 2a20 4f55 542c 0a20 2020  char ** OUT,.   
│ │ │ │ -0003f4a0: 2020 2020 2020 2073 697a 655f 7420 2a20         size_t * 
│ │ │ │ -0003f4b0: 4f55 544c 454e 290a 2020 2020 2050 5249  OUTLEN).     PRI
│ │ │ │ -0003f4c0: 563a 2070 7269 7620 6173 2061 6c6c 6f63  V: priv as alloc
│ │ │ │ -0003f4d0: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ -0003f4e0: 695f 7072 6976 2829 e280 992e 0a20 2020  i_priv().....   
│ │ │ │ -0003f4f0: 2020 4f55 543a 206f 7574 7075 7420 6172    OUT: output ar
│ │ │ │ -0003f500: 7261 7920 7769 7468 206e 6577 6c79 2061  ray with newly a
│ │ │ │ -0003f510: 6c6c 6f63 6174 6564 2044 4552 2065 6e63  llocated DER enc
│ │ │ │ -0003f520: 6f64 696e 6720 6f66 2050 5249 562e 0a20  oding of PRIV.. 
│ │ │ │ -0003f530: 2020 2020 4f55 544c 454e 3a20 6c65 6e67      OUTLEN: leng
│ │ │ │ -0003f540: 7468 206f 6620 6f75 7470 7574 2061 7272  th of output arr
│ │ │ │ -0003f550: 6179 2077 6974 6820 4445 5220 656e 636f  ay with DER enco
│ │ │ │ -0003f560: 6469 6e67 206f 6620 5052 4956 2e0a 0a20  ding of PRIV... 
│ │ │ │ -0003f570: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -0003f580: 3a2a 2044 4552 2065 6e63 6f64 6520 5052  :* DER encode PR
│ │ │ │ -0003f590: 4956 2073 7472 7563 7475 7265 2e20 2054  IV structure.  T
│ │ │ │ -0003f5a0: 7970 6963 616c 6c79 0a20 2020 2020 e280  ypically.     ..
│ │ │ │ -0003f5b0: 9873 6869 7368 695f 7072 6976 5f62 7569  .shishi_priv_bui
│ │ │ │ -0003f5c0: 6c64 2829 e280 9920 6973 2075 7365 6420  ld()... is used 
│ │ │ │ -0003f5d0: 746f 2062 7569 6c64 2074 6865 2050 5249  to build the PRI
│ │ │ │ -0003f5e0: 5620 7374 7275 6374 7572 6520 6669 7273  V structure firs
│ │ │ │ -0003f5f0: 742e 0a20 2020 2020 4f55 5420 6973 2061  t..     OUT is a
│ │ │ │ -0003f600: 6c6c 6f63 6174 6564 2062 7920 7468 6973  llocated by this
│ │ │ │ -0003f610: 2066 756e 6374 696f 6e2c 2061 6e64 2069   function, and i
│ │ │ │ -0003f620: 7420 6973 2074 6865 2072 6573 706f 6e73  t is the respons
│ │ │ │ -0003f630: 6962 696c 6974 7920 6f66 0a20 2020 2020  ibility of.     
│ │ │ │ -0003f640: 6361 6c6c 6572 2074 6f20 6465 616c 6c6f  caller to deallo
│ │ │ │ -0003f650: 6361 7465 2069 742e 0a0a 2020 2020 202a  cate it...     *
│ │ │ │ -0003f660: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ -0003f670: 6574 7572 6e73 2053 4849 5348 495f 4f4b  eturns SHISHI_OK
│ │ │ │ -0003f680: 2069 6666 2073 7563 6365 7373 6675 6c2e   iff successful.
│ │ │ │ -0003f690: 0a0a 7368 6973 6869 5f70 7269 765f 7072  ..shishi_priv_pr
│ │ │ │ -0003f6a0: 6976 5f64 6572 5f73 6574 0a2d 2d2d 2d2d  iv_der_set.-----
│ │ │ │ +0003f450: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ +0003f460: 6f6e 3a20 696e 7420 7368 6973 6869 5f70  on: int shishi_p
│ │ │ │ +0003f470: 7269 765f 7072 6976 5f64 6572 2028 5368  riv_priv_der (Sh
│ │ │ │ +0003f480: 6973 6869 5f70 7269 7620 2a20 5052 4956  ishi_priv * PRIV
│ │ │ │ +0003f490: 2c20 6368 6172 202a 2a20 4f55 542c 0a20  , char ** OUT,. 
│ │ │ │ +0003f4a0: 2020 2020 2020 2020 2073 697a 655f 7420           size_t 
│ │ │ │ +0003f4b0: 2a20 4f55 544c 454e 290a 2020 2020 2050  * OUTLEN).     P
│ │ │ │ +0003f4c0: 5249 563a 2070 7269 7620 6173 2061 6c6c  RIV: priv as all
│ │ │ │ +0003f4d0: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ +0003f4e0: 7368 695f 7072 6976 2829 e280 992e 0a20  shi_priv()..... 
│ │ │ │ +0003f4f0: 2020 2020 4f55 543a 206f 7574 7075 7420      OUT: output 
│ │ │ │ +0003f500: 6172 7261 7920 7769 7468 206e 6577 6c79  array with newly
│ │ │ │ +0003f510: 2061 6c6c 6f63 6174 6564 2044 4552 2065   allocated DER e
│ │ │ │ +0003f520: 6e63 6f64 696e 6720 6f66 2050 5249 562e  ncoding of PRIV.
│ │ │ │ +0003f530: 0a20 2020 2020 4f55 544c 454e 3a20 6c65  .     OUTLEN: le
│ │ │ │ +0003f540: 6e67 7468 206f 6620 6f75 7470 7574 2061  ngth of output a
│ │ │ │ +0003f550: 7272 6179 2077 6974 6820 4445 5220 656e  rray with DER en
│ │ │ │ +0003f560: 636f 6469 6e67 206f 6620 5052 4956 2e0a  coding of PRIV..
│ │ │ │ +0003f570: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +0003f580: 6f6e 3a2a 2044 4552 2065 6e63 6f64 6520  on:* DER encode 
│ │ │ │ +0003f590: 5052 4956 2073 7472 7563 7475 7265 2e20  PRIV structure. 
│ │ │ │ +0003f5a0: 2054 7970 6963 616c 6c79 0a20 2020 2020   Typically.     
│ │ │ │ +0003f5b0: e280 9873 6869 7368 695f 7072 6976 5f62  ...shishi_priv_b
│ │ │ │ +0003f5c0: 7569 6c64 2829 e280 9920 6973 2075 7365  uild()... is use
│ │ │ │ +0003f5d0: 6420 746f 2062 7569 6c64 2074 6865 2050  d to build the P
│ │ │ │ +0003f5e0: 5249 5620 7374 7275 6374 7572 6520 6669  RIV structure fi
│ │ │ │ +0003f5f0: 7273 742e 0a20 2020 2020 4f55 5420 6973  rst..     OUT is
│ │ │ │ +0003f600: 2061 6c6c 6f63 6174 6564 2062 7920 7468   allocated by th
│ │ │ │ +0003f610: 6973 2066 756e 6374 696f 6e2c 2061 6e64  is function, and
│ │ │ │ +0003f620: 2069 7420 6973 2074 6865 2072 6573 706f   it is the respo
│ │ │ │ +0003f630: 6e73 6962 696c 6974 7920 6f66 0a20 2020  nsibility of.   
│ │ │ │ +0003f640: 2020 6361 6c6c 6572 2074 6f20 6465 616c    caller to deal
│ │ │ │ +0003f650: 6c6f 6361 7465 2069 742e 0a0a 2020 2020  locate it...    
│ │ │ │ +0003f660: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ +0003f670: 2052 6574 7572 6e73 2053 4849 5348 495f   Returns SHISHI_
│ │ │ │ +0003f680: 4f4b 2069 6666 2073 7563 6365 7373 6675  OK iff successfu
│ │ │ │ +0003f690: 6c2e 0a0a 7368 6973 6869 5f70 7269 765f  l...shishi_priv_
│ │ │ │ +0003f6a0: 7072 6976 5f64 6572 5f73 6574 0a2d 2d2d  priv_der_set.---
│ │ │ │  0003f6b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0003f6c0: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ -0003f6d0: 6e3a 2069 6e74 2073 6869 7368 695f 7072  n: int shishi_pr
│ │ │ │ -0003f6e0: 6976 5f70 7269 765f 6465 725f 7365 7420  iv_priv_der_set 
│ │ │ │ -0003f6f0: 2853 6869 7368 695f 7072 6976 202a 2050  (Shishi_priv * P
│ │ │ │ -0003f700: 5249 562c 0a20 2020 2020 2020 2020 2063  RIV,.          c
│ │ │ │ -0003f710: 6861 7220 2a20 4445 522c 2073 697a 655f  har * DER, size_
│ │ │ │ -0003f720: 7420 4445 524c 454e 290a 2020 2020 2050  t DERLEN).     P
│ │ │ │ -0003f730: 5249 563a 2070 7269 7620 6173 2061 6c6c  RIV: priv as all
│ │ │ │ -0003f740: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ -0003f750: 7368 695f 7072 6976 2829 e280 992e 0a20  shi_priv()..... 
│ │ │ │ -0003f760: 2020 2020 4445 523a 2069 6e70 7574 2061      DER: input a
│ │ │ │ -0003f770: 7272 6179 2077 6974 6820 4445 5220 656e  rray with DER en
│ │ │ │ -0003f780: 636f 6465 6420 4b52 422d 5052 4956 2e0a  coded KRB-PRIV..
│ │ │ │ -0003f790: 2020 2020 2044 4552 4c45 4e3a 206c 656e       DERLEN: len
│ │ │ │ -0003f7a0: 6774 6820 6f66 2069 6e70 7574 2061 7272  gth of input arr
│ │ │ │ -0003f7b0: 6179 2077 6974 6820 4445 5220 656e 636f  ay with DER enco
│ │ │ │ -0003f7c0: 6465 6420 4b52 422d 5052 4956 2e0a 0a20  ded KRB-PRIV... 
│ │ │ │ -0003f7d0: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -0003f7e0: 3a2a 2044 4552 2064 6563 6f64 6520 4b52  :* DER decode KR
│ │ │ │ -0003f7f0: 422d 5052 4956 2061 6e64 2073 6574 2069  B-PRIV and set i
│ │ │ │ -0003f800: 7420 5052 4956 2065 7863 6861 6e67 652e  t PRIV exchange.
│ │ │ │ -0003f810: 2020 4966 0a20 2020 2020 6465 636f 6469    If.     decodi
│ │ │ │ -0003f820: 6e67 2066 6169 6c73 2c20 7468 6520 4b52  ng fails, the KR
│ │ │ │ -0003f830: 422d 5052 4956 2069 6e20 7468 6520 5052  B-PRIV in the PR
│ │ │ │ -0003f840: 4956 2065 7863 6861 6e67 6520 7265 6d61  IV exchange rema
│ │ │ │ -0003f850: 696e 732e 0a0a 2020 2020 202a 5265 7475  ins...     *Retu
│ │ │ │ -0003f860: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ -0003f870: 6e73 2053 4849 5348 495f 4f4b 2e0a 0a73  ns SHISHI_OK...s
│ │ │ │ -0003f880: 6869 7368 695f 7072 6976 5f65 6e63 7072  hishi_priv_encpr
│ │ │ │ -0003f890: 6976 7061 7274 0a2d 2d2d 2d2d 2d2d 2d2d  ivpart.---------
│ │ │ │ -0003f8a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -0003f8b0: 202d 2d20 4675 6e63 7469 6f6e 3a20 5368   -- Function: Sh
│ │ │ │ -0003f8c0: 6973 6869 5f61 736e 3120 7368 6973 6869  ishi_asn1 shishi
│ │ │ │ -0003f8d0: 5f70 7269 765f 656e 6370 7269 7670 6172  _priv_encprivpar
│ │ │ │ -0003f8e0: 7420 2853 6869 7368 695f 7072 6976 202a  t (Shishi_priv *
│ │ │ │ -0003f8f0: 2050 5249 5629 0a20 2020 2020 5052 4956   PRIV).     PRIV
│ │ │ │ -0003f900: 3a20 7374 7275 6374 7572 6520 7468 6174  : structure that
│ │ │ │ -0003f910: 2068 6f6c 6473 2069 6e66 6f72 6d61 7469   holds informati
│ │ │ │ -0003f920: 6f6e 2061 626f 7574 2050 5249 5620 6578  on about PRIV ex
│ │ │ │ -0003f930: 6368 616e 6765 0a0a 2020 2020 202a 4465  change..     *De
│ │ │ │ -0003f940: 7363 7269 7074 696f 6e3a 2a20 4765 7420  scription:* Get 
│ │ │ │ -0003f950: 4153 4e2e 3120 456e 6350 7269 7650 6172  ASN.1 EncPrivPar
│ │ │ │ -0003f960: 7420 7374 7275 6374 7572 6520 6672 6f6d  t structure from
│ │ │ │ -0003f970: 2050 5249 5620 6578 6368 616e 6765 2e0a   PRIV exchange..
│ │ │ │ -0003f980: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ -0003f990: 6c75 653a 2a20 5265 7475 726e 7320 7468  lue:* Returns th
│ │ │ │ -0003f9a0: 6520 4153 4e2e 3120 656e 6370 7269 7670  e ASN.1 encprivp
│ │ │ │ -0003f9b0: 6172 7420 696e 2074 6865 2050 5249 5620  art in the PRIV 
│ │ │ │ -0003f9c0: 6578 6368 616e 6765 2c0a 2020 2020 206f  exchange,.     o
│ │ │ │ -0003f9d0: 7220 4e55 4c4c 2069 6620 6e6f 7420 7965  r NULL if not ye
│ │ │ │ -0003f9e0: 7420 7365 7420 6f72 2061 6e20 6572 726f  t set or an erro
│ │ │ │ -0003f9f0: 7220 6f63 6375 7265 642e 0a0a 7368 6973  r occured...shis
│ │ │ │ -0003fa00: 6869 5f70 7269 765f 656e 6370 7269 7670  hi_priv_encprivp
│ │ │ │ -0003fa10: 6172 745f 7365 740a 2d2d 2d2d 2d2d 2d2d  art_set.--------
│ │ │ │ +0003f6c0: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +0003f6d0: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ +0003f6e0: 7072 6976 5f70 7269 765f 6465 725f 7365  priv_priv_der_se
│ │ │ │ +0003f6f0: 7420 2853 6869 7368 695f 7072 6976 202a  t (Shishi_priv *
│ │ │ │ +0003f700: 2050 5249 562c 0a20 2020 2020 2020 2020   PRIV,.         
│ │ │ │ +0003f710: 2063 6861 7220 2a20 4445 522c 2073 697a   char * DER, siz
│ │ │ │ +0003f720: 655f 7420 4445 524c 454e 290a 2020 2020  e_t DERLEN).    
│ │ │ │ +0003f730: 2050 5249 563a 2070 7269 7620 6173 2061   PRIV: priv as a
│ │ │ │ +0003f740: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ +0003f750: 6869 7368 695f 7072 6976 2829 e280 992e  hishi_priv()....
│ │ │ │ +0003f760: 0a20 2020 2020 4445 523a 2069 6e70 7574  .     DER: input
│ │ │ │ +0003f770: 2061 7272 6179 2077 6974 6820 4445 5220   array with DER 
│ │ │ │ +0003f780: 656e 636f 6465 6420 4b52 422d 5052 4956  encoded KRB-PRIV
│ │ │ │ +0003f790: 2e0a 2020 2020 2044 4552 4c45 4e3a 206c  ..     DERLEN: l
│ │ │ │ +0003f7a0: 656e 6774 6820 6f66 2069 6e70 7574 2061  ength of input a
│ │ │ │ +0003f7b0: 7272 6179 2077 6974 6820 4445 5220 656e  rray with DER en
│ │ │ │ +0003f7c0: 636f 6465 6420 4b52 422d 5052 4956 2e0a  coded KRB-PRIV..
│ │ │ │ +0003f7d0: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +0003f7e0: 6f6e 3a2a 2044 4552 2064 6563 6f64 6520  on:* DER decode 
│ │ │ │ +0003f7f0: 4b52 422d 5052 4956 2061 6e64 2073 6574  KRB-PRIV and set
│ │ │ │ +0003f800: 2069 7420 5052 4956 2065 7863 6861 6e67   it PRIV exchang
│ │ │ │ +0003f810: 652e 2020 4966 0a20 2020 2020 6465 636f  e.  If.     deco
│ │ │ │ +0003f820: 6469 6e67 2066 6169 6c73 2c20 7468 6520  ding fails, the 
│ │ │ │ +0003f830: 4b52 422d 5052 4956 2069 6e20 7468 6520  KRB-PRIV in the 
│ │ │ │ +0003f840: 5052 4956 2065 7863 6861 6e67 6520 7265  PRIV exchange re
│ │ │ │ +0003f850: 6d61 696e 732e 0a0a 2020 2020 202a 5265  mains...     *Re
│ │ │ │ +0003f860: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ +0003f870: 7572 6e73 2053 4849 5348 495f 4f4b 2e0a  urns SHISHI_OK..
│ │ │ │ +0003f880: 0a73 6869 7368 695f 7072 6976 5f65 6e63  .shishi_priv_enc
│ │ │ │ +0003f890: 7072 6976 7061 7274 0a2d 2d2d 2d2d 2d2d  privpart.-------
│ │ │ │ +0003f8a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +0003f8b0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +0003f8c0: 5368 6973 6869 5f61 736e 3120 7368 6973  Shishi_asn1 shis
│ │ │ │ +0003f8d0: 6869 5f70 7269 765f 656e 6370 7269 7670  hi_priv_encprivp
│ │ │ │ +0003f8e0: 6172 7420 2853 6869 7368 695f 7072 6976  art (Shishi_priv
│ │ │ │ +0003f8f0: 202a 2050 5249 5629 0a20 2020 2020 5052   * PRIV).     PR
│ │ │ │ +0003f900: 4956 3a20 7374 7275 6374 7572 6520 7468  IV: structure th
│ │ │ │ +0003f910: 6174 2068 6f6c 6473 2069 6e66 6f72 6d61  at holds informa
│ │ │ │ +0003f920: 7469 6f6e 2061 626f 7574 2050 5249 5620  tion about PRIV 
│ │ │ │ +0003f930: 6578 6368 616e 6765 0a0a 2020 2020 202a  exchange..     *
│ │ │ │ +0003f940: 4465 7363 7269 7074 696f 6e3a 2a20 4765  Description:* Ge
│ │ │ │ +0003f950: 7420 4153 4e2e 3120 456e 6350 7269 7650  t ASN.1 EncPrivP
│ │ │ │ +0003f960: 6172 7420 7374 7275 6374 7572 6520 6672  art structure fr
│ │ │ │ +0003f970: 6f6d 2050 5249 5620 6578 6368 616e 6765  om PRIV exchange
│ │ │ │ +0003f980: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ +0003f990: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ +0003f9a0: 7468 6520 4153 4e2e 3120 656e 6370 7269  the ASN.1 encpri
│ │ │ │ +0003f9b0: 7670 6172 7420 696e 2074 6865 2050 5249  vpart in the PRI
│ │ │ │ +0003f9c0: 5620 6578 6368 616e 6765 2c0a 2020 2020  V exchange,.    
│ │ │ │ +0003f9d0: 206f 7220 4e55 4c4c 2069 6620 6e6f 7420   or NULL if not 
│ │ │ │ +0003f9e0: 7965 7420 7365 7420 6f72 2061 6e20 6572  yet set or an er
│ │ │ │ +0003f9f0: 726f 7220 6f63 6375 7265 642e 0a0a 7368  ror occured...sh
│ │ │ │ +0003fa00: 6973 6869 5f70 7269 765f 656e 6370 7269  ishi_priv_encpri
│ │ │ │ +0003fa10: 7670 6172 745f 7365 740a 2d2d 2d2d 2d2d  vpart_set.------
│ │ │ │  0003fa20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0003fa30: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ -0003fa40: 6e3a 2076 6f69 6420 7368 6973 6869 5f70  n: void shishi_p
│ │ │ │ -0003fa50: 7269 765f 656e 6370 7269 7670 6172 745f  riv_encprivpart_
│ │ │ │ -0003fa60: 7365 7420 2853 6869 7368 695f 7072 6976  set (Shishi_priv
│ │ │ │ -0003fa70: 202a 2050 5249 562c 0a20 2020 2020 2020   * PRIV,.       
│ │ │ │ -0003fa80: 2020 2053 6869 7368 695f 6173 6e31 2041     Shishi_asn1 A
│ │ │ │ -0003fa90: 534e 3145 4e43 5052 4956 5041 5254 290a  SN1ENCPRIVPART).
│ │ │ │ -0003faa0: 2020 2020 2050 5249 563a 2073 7472 7563       PRIV: struc
│ │ │ │ -0003fab0: 7475 7265 2074 6861 7420 686f 6c64 7320  ture that holds 
│ │ │ │ -0003fac0: 696e 666f 726d 6174 696f 6e20 6162 6f75  information abou
│ │ │ │ -0003fad0: 7420 5052 4956 2065 7863 6861 6e67 650a  t PRIV exchange.
│ │ │ │ -0003fae0: 2020 2020 2041 534e 3145 4e43 5052 4956       ASN1ENCPRIV
│ │ │ │ -0003faf0: 5041 5254 3a20 454e 4350 5249 5650 4152  PART: ENCPRIVPAR
│ │ │ │ -0003fb00: 5420 746f 2073 746f 7265 2069 6e20 5052  T to store in PR
│ │ │ │ -0003fb10: 4956 2065 7863 6861 6e67 652e 0a0a 2020  IV exchange...  
│ │ │ │ -0003fb20: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ -0003fb30: 2a20 5365 7420 7468 6520 454e 4350 5249  * Set the ENCPRI
│ │ │ │ -0003fb40: 5650 4152 5420 696e 2074 6865 2050 5249  VPART in the PRI
│ │ │ │ -0003fb50: 5620 6578 6368 616e 6765 2e0a 0a73 6869  V exchange...shi
│ │ │ │ -0003fb60: 7368 695f 7072 6976 5f65 6e63 7072 6976  shi_priv_encpriv
│ │ │ │ -0003fb70: 7061 7274 5f64 6572 0a2d 2d2d 2d2d 2d2d  part_der.-------
│ │ │ │ +0003fa30: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +0003fa40: 696f 6e3a 2076 6f69 6420 7368 6973 6869  ion: void shishi
│ │ │ │ +0003fa50: 5f70 7269 765f 656e 6370 7269 7670 6172  _priv_encprivpar
│ │ │ │ +0003fa60: 745f 7365 7420 2853 6869 7368 695f 7072  t_set (Shishi_pr
│ │ │ │ +0003fa70: 6976 202a 2050 5249 562c 0a20 2020 2020  iv * PRIV,.     
│ │ │ │ +0003fa80: 2020 2020 2053 6869 7368 695f 6173 6e31       Shishi_asn1
│ │ │ │ +0003fa90: 2041 534e 3145 4e43 5052 4956 5041 5254   ASN1ENCPRIVPART
│ │ │ │ +0003faa0: 290a 2020 2020 2050 5249 563a 2073 7472  ).     PRIV: str
│ │ │ │ +0003fab0: 7563 7475 7265 2074 6861 7420 686f 6c64  ucture that hold
│ │ │ │ +0003fac0: 7320 696e 666f 726d 6174 696f 6e20 6162  s information ab
│ │ │ │ +0003fad0: 6f75 7420 5052 4956 2065 7863 6861 6e67  out PRIV exchang
│ │ │ │ +0003fae0: 650a 2020 2020 2041 534e 3145 4e43 5052  e.     ASN1ENCPR
│ │ │ │ +0003faf0: 4956 5041 5254 3a20 454e 4350 5249 5650  IVPART: ENCPRIVP
│ │ │ │ +0003fb00: 4152 5420 746f 2073 746f 7265 2069 6e20  ART to store in 
│ │ │ │ +0003fb10: 5052 4956 2065 7863 6861 6e67 652e 0a0a  PRIV exchange...
│ │ │ │ +0003fb20: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ +0003fb30: 6e3a 2a20 5365 7420 7468 6520 454e 4350  n:* Set the ENCP
│ │ │ │ +0003fb40: 5249 5650 4152 5420 696e 2074 6865 2050  RIVPART in the P
│ │ │ │ +0003fb50: 5249 5620 6578 6368 616e 6765 2e0a 0a73  RIV exchange...s
│ │ │ │ +0003fb60: 6869 7368 695f 7072 6976 5f65 6e63 7072  hishi_priv_encpr
│ │ │ │ +0003fb70: 6976 7061 7274 5f64 6572 0a2d 2d2d 2d2d  ivpart_der.-----
│ │ │ │  0003fb80: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0003fb90: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -0003fba0: 6f6e 3a20 696e 7420 7368 6973 6869 5f70  on: int shishi_p
│ │ │ │ -0003fbb0: 7269 765f 656e 6370 7269 7670 6172 745f  riv_encprivpart_
│ │ │ │ -0003fbc0: 6465 7220 2853 6869 7368 695f 7072 6976  der (Shishi_priv
│ │ │ │ -0003fbd0: 202a 2050 5249 562c 0a20 2020 2020 2020   * PRIV,.       
│ │ │ │ -0003fbe0: 2020 2063 6861 7220 2a2a 204f 5554 2c20     char ** OUT, 
│ │ │ │ -0003fbf0: 7369 7a65 5f74 202a 204f 5554 4c45 4e29  size_t * OUTLEN)
│ │ │ │ -0003fc00: 0a20 2020 2020 5052 4956 3a20 7072 6976  .     PRIV: priv
│ │ │ │ -0003fc10: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ -0003fc20: 20e2 8098 7368 6973 6869 5f70 7269 7628   ...shishi_priv(
│ │ │ │ -0003fc30: 29e2 8099 2e0a 2020 2020 204f 5554 3a20  ).....     OUT: 
│ │ │ │ -0003fc40: 6f75 7470 7574 2061 7272 6179 2077 6974  output array wit
│ │ │ │ -0003fc50: 6820 6e65 776c 7920 616c 6c6f 6361 7465  h newly allocate
│ │ │ │ -0003fc60: 6420 4445 5220 656e 636f 6469 6e67 206f  d DER encoding o
│ │ │ │ -0003fc70: 6620 454e 4350 5249 5650 4152 542e 0a0a  f ENCPRIVPART...
│ │ │ │ -0003fc80: 2020 2020 204f 5554 4c45 4e3a 206c 656e       OUTLEN: len
│ │ │ │ -0003fc90: 6774 6820 6f66 206f 7574 7075 7420 6172  gth of output ar
│ │ │ │ -0003fca0: 7261 7920 7769 7468 2044 4552 2065 6e63  ray with DER enc
│ │ │ │ -0003fcb0: 6f64 696e 6720 6f66 2045 4e43 5052 4956  oding of ENCPRIV
│ │ │ │ -0003fcc0: 5041 5254 2e0a 0a20 2020 2020 2a44 6573  PART...     *Des
│ │ │ │ -0003fcd0: 6372 6970 7469 6f6e 3a2a 2044 4552 2065  cription:* DER e
│ │ │ │ -0003fce0: 6e63 6f64 6520 454e 4350 5249 5650 4152  ncode ENCPRIVPAR
│ │ │ │ -0003fcf0: 5420 7374 7275 6374 7572 652e 2020 4f55  T structure.  OU
│ │ │ │ -0003fd00: 5420 6973 2061 6c6c 6f63 6174 6564 0a20  T is allocated. 
│ │ │ │ -0003fd10: 2020 2020 6279 2074 6869 7320 6675 6e63      by this func
│ │ │ │ -0003fd20: 7469 6f6e 2c20 616e 6420 6974 2069 7320  tion, and it is 
│ │ │ │ -0003fd30: 7468 6520 7265 7370 6f6e 7369 6269 6c69  the responsibili
│ │ │ │ -0003fd40: 7479 206f 6620 6361 6c6c 6572 2074 6f0a  ty of caller to.
│ │ │ │ -0003fd50: 2020 2020 2064 6561 6c6c 6f63 6174 6520       deallocate 
│ │ │ │ -0003fd60: 6974 2e0a 0a20 2020 2020 2a52 6574 7572  it...     *Retur
│ │ │ │ -0003fd70: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ -0003fd80: 7320 5348 4953 4849 5f4f 4b20 6966 6620  s SHISHI_OK iff 
│ │ │ │ -0003fd90: 7375 6363 6573 7366 756c 2e0a 0a73 6869  successful...shi
│ │ │ │ -0003fda0: 7368 695f 7072 6976 5f65 6e63 7072 6976  shi_priv_encpriv
│ │ │ │ -0003fdb0: 7061 7274 5f64 6572 5f73 6574 0a2d 2d2d  part_der_set.---
│ │ │ │ +0003fb90: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ +0003fba0: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ +0003fbb0: 5f70 7269 765f 656e 6370 7269 7670 6172  _priv_encprivpar
│ │ │ │ +0003fbc0: 745f 6465 7220 2853 6869 7368 695f 7072  t_der (Shishi_pr
│ │ │ │ +0003fbd0: 6976 202a 2050 5249 562c 0a20 2020 2020  iv * PRIV,.     
│ │ │ │ +0003fbe0: 2020 2020 2063 6861 7220 2a2a 204f 5554       char ** OUT
│ │ │ │ +0003fbf0: 2c20 7369 7a65 5f74 202a 204f 5554 4c45  , size_t * OUTLE
│ │ │ │ +0003fc00: 4e29 0a20 2020 2020 5052 4956 3a20 7072  N).     PRIV: pr
│ │ │ │ +0003fc10: 6976 2061 7320 616c 6c6f 6361 7465 6420  iv as allocated 
│ │ │ │ +0003fc20: 6279 20e2 8098 7368 6973 6869 5f70 7269  by ...shishi_pri
│ │ │ │ +0003fc30: 7628 29e2 8099 2e0a 2020 2020 204f 5554  v().....     OUT
│ │ │ │ +0003fc40: 3a20 6f75 7470 7574 2061 7272 6179 2077  : output array w
│ │ │ │ +0003fc50: 6974 6820 6e65 776c 7920 616c 6c6f 6361  ith newly alloca
│ │ │ │ +0003fc60: 7465 6420 4445 5220 656e 636f 6469 6e67  ted DER encoding
│ │ │ │ +0003fc70: 206f 6620 454e 4350 5249 5650 4152 542e   of ENCPRIVPART.
│ │ │ │ +0003fc80: 0a0a 2020 2020 204f 5554 4c45 4e3a 206c  ..     OUTLEN: l
│ │ │ │ +0003fc90: 656e 6774 6820 6f66 206f 7574 7075 7420  ength of output 
│ │ │ │ +0003fca0: 6172 7261 7920 7769 7468 2044 4552 2065  array with DER e
│ │ │ │ +0003fcb0: 6e63 6f64 696e 6720 6f66 2045 4e43 5052  ncoding of ENCPR
│ │ │ │ +0003fcc0: 4956 5041 5254 2e0a 0a20 2020 2020 2a44  IVPART...     *D
│ │ │ │ +0003fcd0: 6573 6372 6970 7469 6f6e 3a2a 2044 4552  escription:* DER
│ │ │ │ +0003fce0: 2065 6e63 6f64 6520 454e 4350 5249 5650   encode ENCPRIVP
│ │ │ │ +0003fcf0: 4152 5420 7374 7275 6374 7572 652e 2020  ART structure.  
│ │ │ │ +0003fd00: 4f55 5420 6973 2061 6c6c 6f63 6174 6564  OUT is allocated
│ │ │ │ +0003fd10: 0a20 2020 2020 6279 2074 6869 7320 6675  .     by this fu
│ │ │ │ +0003fd20: 6e63 7469 6f6e 2c20 616e 6420 6974 2069  nction, and it i
│ │ │ │ +0003fd30: 7320 7468 6520 7265 7370 6f6e 7369 6269  s the responsibi
│ │ │ │ +0003fd40: 6c69 7479 206f 6620 6361 6c6c 6572 2074  lity of caller t
│ │ │ │ +0003fd50: 6f0a 2020 2020 2064 6561 6c6c 6f63 6174  o.     deallocat
│ │ │ │ +0003fd60: 6520 6974 2e0a 0a20 2020 2020 2a52 6574  e it...     *Ret
│ │ │ │ +0003fd70: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ +0003fd80: 726e 7320 5348 4953 4849 5f4f 4b20 6966  rns SHISHI_OK if
│ │ │ │ +0003fd90: 6620 7375 6363 6573 7366 756c 2e0a 0a73  f successful...s
│ │ │ │ +0003fda0: 6869 7368 695f 7072 6976 5f65 6e63 7072  hishi_priv_encpr
│ │ │ │ +0003fdb0: 6976 7061 7274 5f64 6572 5f73 6574 0a2d  ivpart_der_set.-
│ │ │ │  0003fdc0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0003fdd0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ -0003fde0: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ -0003fdf0: 7368 6973 6869 5f70 7269 765f 656e 6370  shishi_priv_encp
│ │ │ │ -0003fe00: 7269 7670 6172 745f 6465 725f 7365 7420  rivpart_der_set 
│ │ │ │ -0003fe10: 2853 6869 7368 695f 7072 6976 202a 2050  (Shishi_priv * P
│ │ │ │ -0003fe20: 5249 562c 0a20 2020 2020 2020 2020 2063  RIV,.          c
│ │ │ │ -0003fe30: 6861 7220 2a20 4445 522c 2073 697a 655f  har * DER, size_
│ │ │ │ -0003fe40: 7420 4445 524c 454e 290a 2020 2020 2050  t DERLEN).     P
│ │ │ │ -0003fe50: 5249 563a 2070 7269 7620 6173 2061 6c6c  RIV: priv as all
│ │ │ │ -0003fe60: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ -0003fe70: 7368 695f 7072 6976 2829 e280 992e 0a20  shi_priv()..... 
│ │ │ │ -0003fe80: 2020 2020 4445 523a 2069 6e70 7574 2061      DER: input a
│ │ │ │ -0003fe90: 7272 6179 2077 6974 6820 4445 5220 656e  rray with DER en
│ │ │ │ -0003fea0: 636f 6465 6420 454e 4350 5249 5650 4152  coded ENCPRIVPAR
│ │ │ │ -0003feb0: 542e 0a20 2020 2020 4445 524c 454e 3a20  T..     DERLEN: 
│ │ │ │ -0003fec0: 6c65 6e67 7468 206f 6620 696e 7075 7420  length of input 
│ │ │ │ -0003fed0: 6172 7261 7920 7769 7468 2044 4552 2065  array with DER e
│ │ │ │ -0003fee0: 6e63 6f64 6564 2045 4e43 5052 4956 5041  ncoded ENCPRIVPA
│ │ │ │ -0003fef0: 5254 2e0a 0a20 2020 2020 2a44 6573 6372  RT...     *Descr
│ │ │ │ -0003ff00: 6970 7469 6f6e 3a2a 2044 4552 2064 6563  iption:* DER dec
│ │ │ │ -0003ff10: 6f64 6520 454e 4350 5249 5650 4152 5420  ode ENCPRIVPART 
│ │ │ │ -0003ff20: 616e 6420 7365 7420 6974 2050 5249 5620  and set it PRIV 
│ │ │ │ -0003ff30: 6578 6368 616e 6765 2e20 2049 660a 2020  exchange.  If.  
│ │ │ │ -0003ff40: 2020 2064 6563 6f64 696e 6720 6661 696c     decoding fail
│ │ │ │ -0003ff50: 732c 2074 6865 2045 4e43 5052 4956 5041  s, the ENCPRIVPA
│ │ │ │ -0003ff60: 5254 2069 6e20 7468 6520 5052 4956 2065  RT in the PRIV e
│ │ │ │ -0003ff70: 7863 6861 6e67 6520 7265 6d61 696e 732e  xchange remains.
│ │ │ │ -0003ff80: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ -0003ff90: 616c 7565 3a2a 2052 6574 7572 6e73 2053  alue:* Returns S
│ │ │ │ -0003ffa0: 4849 5348 495f 4f4b 2e0a 0a73 6869 7368  HISHI_OK...shish
│ │ │ │ -0003ffb0: 695f 7072 6976 5f70 7269 6e74 0a2d 2d2d  i_priv_print.---
│ │ │ │ -0003ffc0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -0003ffd0: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ -0003ffe0: 7420 7368 6973 6869 5f70 7269 765f 7072  t shishi_priv_pr
│ │ │ │ -0003fff0: 696e 7420 2853 6869 7368 6920 2a20 4841  int (Shishi * HA
│ │ │ │ -00040000: 4e44 4c45 2c20 4649 4c45 202a 2046 482c  NDLE, FILE * FH,
│ │ │ │ -00040010: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ -00040020: 695f 6173 6e31 2050 5249 5629 0a20 2020  i_asn1 PRIV).   
│ │ │ │ -00040030: 2020 4841 4e44 4c45 3a20 7368 6973 6869    HANDLE: shishi
│ │ │ │ -00040040: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ -00040050: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ -00040060: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ -00040070: 2020 4648 3a20 6669 6c65 2068 616e 646c    FH: file handl
│ │ │ │ -00040080: 6520 6f70 656e 2066 6f72 2077 7269 7469  e open for writi
│ │ │ │ -00040090: 6e67 2e0a 2020 2020 2050 5249 563a 2050  ng..     PRIV: P
│ │ │ │ -000400a0: 5249 5620 746f 2070 7269 6e74 2e0a 0a20  RIV to print... 
│ │ │ │ -000400b0: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -000400c0: 3a2a 2050 7269 6e74 2041 5343 4949 2061  :* Print ASCII a
│ │ │ │ -000400d0: 726d 6f72 6564 2044 4552 2065 6e63 6f64  rmored DER encod
│ │ │ │ -000400e0: 696e 6720 6f66 2050 5249 5620 746f 2066  ing of PRIV to f
│ │ │ │ -000400f0: 696c 652e 0a0a 2020 2020 202a 5265 7475  ile...     *Retu
│ │ │ │ -00040100: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ -00040110: 6e73 2053 4849 5348 495f 4f4b 2069 6666  ns SHISHI_OK iff
│ │ │ │ -00040120: 2073 7563 6365 7373 6675 6c2e 0a0a 7368   successful...sh
│ │ │ │ -00040130: 6973 6869 5f70 7269 765f 7361 7665 0a2d  ishi_priv_save.-
│ │ │ │ -00040140: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -00040150: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ -00040160: 6e74 2073 6869 7368 695f 7072 6976 5f73  nt shishi_priv_s
│ │ │ │ -00040170: 6176 6520 2853 6869 7368 6920 2a20 4841  ave (Shishi * HA
│ │ │ │ -00040180: 4e44 4c45 2c20 4649 4c45 202a 2046 482c  NDLE, FILE * FH,
│ │ │ │ -00040190: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ -000401a0: 695f 6173 6e31 2050 5249 5629 0a20 2020  i_asn1 PRIV).   
│ │ │ │ -000401b0: 2020 4841 4e44 4c45 3a20 7368 6973 6869    HANDLE: shishi
│ │ │ │ -000401c0: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ -000401d0: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ -000401e0: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ -000401f0: 2020 4648 3a20 6669 6c65 2068 616e 646c    FH: file handl
│ │ │ │ -00040200: 6520 6f70 656e 2066 6f72 2077 7269 7469  e open for writi
│ │ │ │ -00040210: 6e67 2e0a 2020 2020 2050 5249 563a 2050  ng..     PRIV: P
│ │ │ │ -00040220: 5249 5620 746f 2073 6176 652e 0a0a 2020  RIV to save...  
│ │ │ │ -00040230: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ -00040240: 2a20 5361 7665 2044 4552 2065 6e63 6f64  * Save DER encod
│ │ │ │ -00040250: 696e 6720 6f66 2050 5249 5620 746f 2066  ing of PRIV to f
│ │ │ │ -00040260: 696c 652e 0a0a 2020 2020 202a 5265 7475  ile...     *Retu
│ │ │ │ -00040270: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ -00040280: 6e73 2053 4849 5348 495f 4f4b 2069 6666  ns SHISHI_OK iff
│ │ │ │ -00040290: 2073 7563 6365 7373 6675 6c2e 0a0a 7368   successful...sh
│ │ │ │ -000402a0: 6973 6869 5f70 7269 765f 746f 5f66 696c  ishi_priv_to_fil
│ │ │ │ -000402b0: 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  e.--------------
│ │ │ │ -000402c0: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ -000402d0: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ -000402e0: 7072 6976 5f74 6f5f 6669 6c65 2028 5368  priv_to_file (Sh
│ │ │ │ -000402f0: 6973 6869 202a 2048 414e 444c 452c 0a20  ishi * HANDLE,. 
│ │ │ │ -00040300: 2020 2020 2020 2020 2053 6869 7368 695f           Shishi_
│ │ │ │ -00040310: 6173 6e31 2050 5249 562c 2069 6e74 2046  asn1 PRIV, int F
│ │ │ │ -00040320: 494c 4554 5950 452c 2063 6f6e 7374 2063  ILETYPE, const c
│ │ │ │ -00040330: 6861 7220 2a20 4649 4c45 4e41 4d45 290a  har * FILENAME).
│ │ │ │ -00040340: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ -00040350: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ -00040360: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ -00040370: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ -00040380: 2020 2020 2050 5249 563a 2050 5249 5620       PRIV: PRIV 
│ │ │ │ -00040390: 746f 2073 6176 652e 0a20 2020 2020 4649  to save..     FI
│ │ │ │ -000403a0: 4c45 5459 5045 3a20 696e 7075 7420 7661  LETYPE: input va
│ │ │ │ -000403b0: 7269 6162 6c65 2073 7065 6369 6679 696e  riable specifyin
│ │ │ │ -000403c0: 6720 7479 7065 206f 6620 6669 6c65 2074  g type of file t
│ │ │ │ -000403d0: 6f20 6265 2077 7269 7474 656e 2c20 7365  o be written, se
│ │ │ │ -000403e0: 650a 2020 2020 2053 6869 7368 695f 6669  e.     Shishi_fi
│ │ │ │ -000403f0: 6c65 7479 7065 2e0a 2020 2020 2046 494c  letype..     FIL
│ │ │ │ -00040400: 454e 414d 453a 2069 6e70 7574 2076 6172  ENAME: input var
│ │ │ │ -00040410: 6961 626c 6520 7769 7468 2066 696c 656e  iable with filen
│ │ │ │ -00040420: 616d 6520 746f 2077 7269 7465 2074 6f2e  ame to write to.
│ │ │ │ -00040430: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ -00040440: 696f 6e3a 2a20 5772 6974 6520 5052 4956  ion:* Write PRIV
│ │ │ │ -00040450: 2074 6f20 6669 6c65 2069 6e20 7370 6563   to file in spec
│ │ │ │ -00040460: 6966 6965 6420 5459 5045 2e20 5468 6520  ified TYPE. The 
│ │ │ │ -00040470: 6669 6c65 2077 696c 6c0a 2020 2020 2062  file will.     b
│ │ │ │ -00040480: 6520 7472 756e 6361 7465 6420 6966 2069  e truncated if i
│ │ │ │ -00040490: 7420 6578 6973 7473 2e0a 0a20 2020 2020  t exists...     
│ │ │ │ -000404a0: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ -000404b0: 5265 7475 726e 7320 5348 4953 4849 5f4f  Returns SHISHI_O
│ │ │ │ -000404c0: 4b20 6966 6620 7375 6363 6573 7366 756c  K iff successful
│ │ │ │ -000404d0: 2e0a 0a73 6869 7368 695f 7072 6976 5f70  ...shishi_priv_p
│ │ │ │ -000404e0: 6172 7365 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  arse.-----------
│ │ │ │ -000404f0: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ -00040500: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ -00040510: 5f70 7269 765f 7061 7273 6520 2853 6869  _priv_parse (Shi
│ │ │ │ -00040520: 7368 6920 2a20 4841 4e44 4c45 2c20 4649  shi * HANDLE, FI
│ │ │ │ -00040530: 4c45 202a 2046 482c 0a20 2020 2020 2020  LE * FH,.       
│ │ │ │ -00040540: 2020 2053 6869 7368 695f 6173 6e31 202a     Shishi_asn1 *
│ │ │ │ -00040550: 2050 5249 5629 0a20 2020 2020 4841 4e44   PRIV).     HAND
│ │ │ │ -00040560: 4c45 3a20 7368 6973 6869 2068 616e 646c  LE: shishi handl
│ │ │ │ -00040570: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ -00040580: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ -00040590: 2829 e280 992e 0a20 2020 2020 4648 3a20  ().....     FH: 
│ │ │ │ -000405a0: 6669 6c65 2068 616e 646c 6520 6f70 656e  file handle open
│ │ │ │ -000405b0: 2066 6f72 2072 6561 6469 6e67 2e0a 2020   for reading..  
│ │ │ │ -000405c0: 2020 2050 5249 563a 206f 7574 7075 7420     PRIV: output 
│ │ │ │ -000405d0: 7661 7269 6162 6c65 2077 6974 6820 6e65  variable with ne
│ │ │ │ -000405e0: 776c 7920 616c 6c6f 6361 7465 6420 5052  wly allocated PR
│ │ │ │ -000405f0: 4956 2e0a 0a20 2020 2020 2a44 6573 6372  IV...     *Descr
│ │ │ │ -00040600: 6970 7469 6f6e 3a2a 2052 6561 6420 4153  iption:* Read AS
│ │ │ │ -00040610: 4349 4920 6172 6d6f 7265 6420 4445 5220  CII armored DER 
│ │ │ │ -00040620: 656e 636f 6465 6420 5052 4956 2066 726f  encoded PRIV fro
│ │ │ │ -00040630: 6d20 6669 6c65 2061 6e64 0a20 2020 2020  m file and.     
│ │ │ │ -00040640: 706f 7075 6c61 7465 2067 6976 656e 2076  populate given v
│ │ │ │ -00040650: 6172 6961 626c 652e 0a0a 2020 2020 202a  ariable...     *
│ │ │ │ -00040660: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ -00040670: 6574 7572 6e73 2053 4849 5348 495f 4f4b  eturns SHISHI_OK
│ │ │ │ -00040680: 2069 6666 2073 7563 6365 7373 6675 6c2e   iff successful.
│ │ │ │ -00040690: 0a0a 7368 6973 6869 5f70 7269 765f 7265  ..shishi_priv_re
│ │ │ │ -000406a0: 6164 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ad.-------------
│ │ │ │ -000406b0: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ -000406c0: 6e3a 2069 6e74 2073 6869 7368 695f 7072  n: int shishi_pr
│ │ │ │ -000406d0: 6976 5f72 6561 6420 2853 6869 7368 6920  iv_read (Shishi 
│ │ │ │ -000406e0: 2a20 4841 4e44 4c45 2c20 4649 4c45 202a  * HANDLE, FILE *
│ │ │ │ -000406f0: 2046 482c 0a20 2020 2020 2020 2020 2053   FH,.          S
│ │ │ │ -00040700: 6869 7368 695f 6173 6e31 202a 2050 5249  hishi_asn1 * PRI
│ │ │ │ -00040710: 5629 0a20 2020 2020 4841 4e44 4c45 3a20  V).     HANDLE: 
│ │ │ │ -00040720: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ -00040730: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ -00040740: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ -00040750: 992e 0a20 2020 2020 4648 3a20 6669 6c65  ...     FH: file
│ │ │ │ -00040760: 2068 616e 646c 6520 6f70 656e 2066 6f72   handle open for
│ │ │ │ -00040770: 2072 6561 6469 6e67 2e0a 2020 2020 2050   reading..     P
│ │ │ │ -00040780: 5249 563a 206f 7574 7075 7420 7661 7269  RIV: output vari
│ │ │ │ -00040790: 6162 6c65 2077 6974 6820 6e65 776c 7920  able with newly 
│ │ │ │ -000407a0: 616c 6c6f 6361 7465 6420 5052 4956 2e0a  allocated PRIV..
│ │ │ │ -000407b0: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -000407c0: 6f6e 3a2a 2052 6561 6420 4445 5220 656e  on:* Read DER en
│ │ │ │ -000407d0: 636f 6465 6420 5052 4956 2066 726f 6d20  coded PRIV from 
│ │ │ │ -000407e0: 6669 6c65 2061 6e64 2070 6f70 756c 6174  file and populat
│ │ │ │ -000407f0: 6520 6769 7665 6e0a 2020 2020 2076 6172  e given.     var
│ │ │ │ -00040800: 6961 626c 652e 0a0a 2020 2020 202a 5265  iable...     *Re
│ │ │ │ -00040810: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ -00040820: 7572 6e73 2053 4849 5348 495f 4f4b 2069  urns SHISHI_OK i
│ │ │ │ -00040830: 6666 2073 7563 6365 7373 6675 6c2e 0a0a  ff successful...
│ │ │ │ -00040840: 7368 6973 6869 5f70 7269 765f 6672 6f6d  shishi_priv_from
│ │ │ │ -00040850: 5f66 696c 650a 2d2d 2d2d 2d2d 2d2d 2d2d  _file.----------
│ │ │ │ -00040860: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ -00040870: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ -00040880: 6869 7368 695f 7072 6976 5f66 726f 6d5f  hishi_priv_from_
│ │ │ │ -00040890: 6669 6c65 2028 5368 6973 6869 202a 2048  file (Shishi * H
│ │ │ │ -000408a0: 414e 444c 452c 0a20 2020 2020 2020 2020  ANDLE,.         
│ │ │ │ -000408b0: 2053 6869 7368 695f 6173 6e31 202a 2050   Shishi_asn1 * P
│ │ │ │ -000408c0: 5249 562c 2069 6e74 2046 494c 4554 5950  RIV, int FILETYP
│ │ │ │ -000408d0: 452c 2063 6f6e 7374 2063 6861 7220 2a20  E, const char * 
│ │ │ │ -000408e0: 4649 4c45 4e41 4d45 290a 2020 2020 2048  FILENAME).     H
│ │ │ │ -000408f0: 414e 444c 453a 2073 6869 7368 6920 6861  ANDLE: shishi ha
│ │ │ │ -00040900: 6e64 6c65 2061 7320 616c 6c6f 6361 7465  ndle as allocate
│ │ │ │ -00040910: 6420 6279 20e2 8098 7368 6973 6869 5f69  d by ...shishi_i
│ │ │ │ -00040920: 6e69 7428 29e2 8099 2e0a 2020 2020 2050  nit().....     P
│ │ │ │ -00040930: 5249 563a 206f 7574 7075 7420 7661 7269  RIV: output vari
│ │ │ │ -00040940: 6162 6c65 2077 6974 6820 6e65 776c 7920  able with newly 
│ │ │ │ -00040950: 616c 6c6f 6361 7465 6420 5052 4956 2e0a  allocated PRIV..
│ │ │ │ -00040960: 2020 2020 2046 494c 4554 5950 453a 2069       FILETYPE: i
│ │ │ │ -00040970: 6e70 7574 2076 6172 6961 626c 6520 7370  nput variable sp
│ │ │ │ -00040980: 6563 6966 7969 6e67 2074 7970 6520 6f66  ecifying type of
│ │ │ │ -00040990: 2066 696c 6520 746f 2062 6520 7265 6164   file to be read
│ │ │ │ -000409a0: 2c20 7365 650a 2020 2020 2053 6869 7368  , see.     Shish
│ │ │ │ -000409b0: 695f 6669 6c65 7479 7065 2e0a 2020 2020  i_filetype..    
│ │ │ │ -000409c0: 2046 494c 454e 414d 453a 2069 6e70 7574   FILENAME: input
│ │ │ │ -000409d0: 2076 6172 6961 626c 6520 7769 7468 2066   variable with f
│ │ │ │ -000409e0: 696c 656e 616d 6520 746f 2072 6561 6420  ilename to read 
│ │ │ │ -000409f0: 6672 6f6d 2e0a 0a20 2020 2020 2a44 6573  from...     *Des
│ │ │ │ -00040a00: 6372 6970 7469 6f6e 3a2a 2052 6561 6420  cription:* Read 
│ │ │ │ -00040a10: 5052 4956 2066 726f 6d20 6669 6c65 2069  PRIV from file i
│ │ │ │ -00040a20: 6e20 7370 6563 6966 6965 6420 5459 5045  n specified TYPE
│ │ │ │ -00040a30: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ -00040a40: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ -00040a50: 5348 4953 4849 5f4f 4b20 6966 6620 7375  SHISHI_OK iff su
│ │ │ │ -00040a60: 6363 6573 7366 756c 2e0a 0a73 6869 7368  ccessful...shish
│ │ │ │ -00040a70: 695f 7072 6976 5f65 6e63 5f70 6172 745f  i_priv_enc_part_
│ │ │ │ -00040a80: 6574 7970 650a 2d2d 2d2d 2d2d 2d2d 2d2d  etype.----------
│ │ │ │ +0003fdd0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ +0003fde0: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ +0003fdf0: 7420 7368 6973 6869 5f70 7269 765f 656e  t shishi_priv_en
│ │ │ │ +0003fe00: 6370 7269 7670 6172 745f 6465 725f 7365  cprivpart_der_se
│ │ │ │ +0003fe10: 7420 2853 6869 7368 695f 7072 6976 202a  t (Shishi_priv *
│ │ │ │ +0003fe20: 2050 5249 562c 0a20 2020 2020 2020 2020   PRIV,.         
│ │ │ │ +0003fe30: 2063 6861 7220 2a20 4445 522c 2073 697a   char * DER, siz
│ │ │ │ +0003fe40: 655f 7420 4445 524c 454e 290a 2020 2020  e_t DERLEN).    
│ │ │ │ +0003fe50: 2050 5249 563a 2070 7269 7620 6173 2061   PRIV: priv as a
│ │ │ │ +0003fe60: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ +0003fe70: 6869 7368 695f 7072 6976 2829 e280 992e  hishi_priv()....
│ │ │ │ +0003fe80: 0a20 2020 2020 4445 523a 2069 6e70 7574  .     DER: input
│ │ │ │ +0003fe90: 2061 7272 6179 2077 6974 6820 4445 5220   array with DER 
│ │ │ │ +0003fea0: 656e 636f 6465 6420 454e 4350 5249 5650  encoded ENCPRIVP
│ │ │ │ +0003feb0: 4152 542e 0a20 2020 2020 4445 524c 454e  ART..     DERLEN
│ │ │ │ +0003fec0: 3a20 6c65 6e67 7468 206f 6620 696e 7075  : length of inpu
│ │ │ │ +0003fed0: 7420 6172 7261 7920 7769 7468 2044 4552  t array with DER
│ │ │ │ +0003fee0: 2065 6e63 6f64 6564 2045 4e43 5052 4956   encoded ENCPRIV
│ │ │ │ +0003fef0: 5041 5254 2e0a 0a20 2020 2020 2a44 6573  PART...     *Des
│ │ │ │ +0003ff00: 6372 6970 7469 6f6e 3a2a 2044 4552 2064  cription:* DER d
│ │ │ │ +0003ff10: 6563 6f64 6520 454e 4350 5249 5650 4152  ecode ENCPRIVPAR
│ │ │ │ +0003ff20: 5420 616e 6420 7365 7420 6974 2050 5249  T and set it PRI
│ │ │ │ +0003ff30: 5620 6578 6368 616e 6765 2e20 2049 660a  V exchange.  If.
│ │ │ │ +0003ff40: 2020 2020 2064 6563 6f64 696e 6720 6661       decoding fa
│ │ │ │ +0003ff50: 696c 732c 2074 6865 2045 4e43 5052 4956  ils, the ENCPRIV
│ │ │ │ +0003ff60: 5041 5254 2069 6e20 7468 6520 5052 4956  PART in the PRIV
│ │ │ │ +0003ff70: 2065 7863 6861 6e67 6520 7265 6d61 696e   exchange remain
│ │ │ │ +0003ff80: 732e 0a0a 2020 2020 202a 5265 7475 726e  s...     *Return
│ │ │ │ +0003ff90: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ +0003ffa0: 2053 4849 5348 495f 4f4b 2e0a 0a73 6869   SHISHI_OK...shi
│ │ │ │ +0003ffb0: 7368 695f 7072 6976 5f70 7269 6e74 0a2d  shi_priv_print.-
│ │ │ │ +0003ffc0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +0003ffd0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +0003ffe0: 696e 7420 7368 6973 6869 5f70 7269 765f  int shishi_priv_
│ │ │ │ +0003fff0: 7072 696e 7420 2853 6869 7368 6920 2a20  print (Shishi * 
│ │ │ │ +00040000: 4841 4e44 4c45 2c20 4649 4c45 202a 2046  HANDLE, FILE * F
│ │ │ │ +00040010: 482c 0a20 2020 2020 2020 2020 2053 6869  H,.          Shi
│ │ │ │ +00040020: 7368 695f 6173 6e31 2050 5249 5629 0a20  shi_asn1 PRIV). 
│ │ │ │ +00040030: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ +00040040: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ +00040050: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ +00040060: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ +00040070: 2020 2020 4648 3a20 6669 6c65 2068 616e      FH: file han
│ │ │ │ +00040080: 646c 6520 6f70 656e 2066 6f72 2077 7269  dle open for wri
│ │ │ │ +00040090: 7469 6e67 2e0a 2020 2020 2050 5249 563a  ting..     PRIV:
│ │ │ │ +000400a0: 2050 5249 5620 746f 2070 7269 6e74 2e0a   PRIV to print..
│ │ │ │ +000400b0: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +000400c0: 6f6e 3a2a 2050 7269 6e74 2041 5343 4949  on:* Print ASCII
│ │ │ │ +000400d0: 2061 726d 6f72 6564 2044 4552 2065 6e63   armored DER enc
│ │ │ │ +000400e0: 6f64 696e 6720 6f66 2050 5249 5620 746f  oding of PRIV to
│ │ │ │ +000400f0: 2066 696c 652e 0a0a 2020 2020 202a 5265   file...     *Re
│ │ │ │ +00040100: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ +00040110: 7572 6e73 2053 4849 5348 495f 4f4b 2069  urns SHISHI_OK i
│ │ │ │ +00040120: 6666 2073 7563 6365 7373 6675 6c2e 0a0a  ff successful...
│ │ │ │ +00040130: 7368 6973 6869 5f70 7269 765f 7361 7665  shishi_priv_save
│ │ │ │ +00040140: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ +00040150: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ +00040160: 2069 6e74 2073 6869 7368 695f 7072 6976   int shishi_priv
│ │ │ │ +00040170: 5f73 6176 6520 2853 6869 7368 6920 2a20  _save (Shishi * 
│ │ │ │ +00040180: 4841 4e44 4c45 2c20 4649 4c45 202a 2046  HANDLE, FILE * F
│ │ │ │ +00040190: 482c 0a20 2020 2020 2020 2020 2053 6869  H,.          Shi
│ │ │ │ +000401a0: 7368 695f 6173 6e31 2050 5249 5629 0a20  shi_asn1 PRIV). 
│ │ │ │ +000401b0: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ +000401c0: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ +000401d0: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ +000401e0: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ +000401f0: 2020 2020 4648 3a20 6669 6c65 2068 616e      FH: file han
│ │ │ │ +00040200: 646c 6520 6f70 656e 2066 6f72 2077 7269  dle open for wri
│ │ │ │ +00040210: 7469 6e67 2e0a 2020 2020 2050 5249 563a  ting..     PRIV:
│ │ │ │ +00040220: 2050 5249 5620 746f 2073 6176 652e 0a0a   PRIV to save...
│ │ │ │ +00040230: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ +00040240: 6e3a 2a20 5361 7665 2044 4552 2065 6e63  n:* Save DER enc
│ │ │ │ +00040250: 6f64 696e 6720 6f66 2050 5249 5620 746f  oding of PRIV to
│ │ │ │ +00040260: 2066 696c 652e 0a0a 2020 2020 202a 5265   file...     *Re
│ │ │ │ +00040270: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ +00040280: 7572 6e73 2053 4849 5348 495f 4f4b 2069  urns SHISHI_OK i
│ │ │ │ +00040290: 6666 2073 7563 6365 7373 6675 6c2e 0a0a  ff successful...
│ │ │ │ +000402a0: 7368 6973 6869 5f70 7269 765f 746f 5f66  shishi_priv_to_f
│ │ │ │ +000402b0: 696c 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ile.------------
│ │ │ │ +000402c0: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +000402d0: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ +000402e0: 695f 7072 6976 5f74 6f5f 6669 6c65 2028  i_priv_to_file (
│ │ │ │ +000402f0: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ +00040300: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ +00040310: 695f 6173 6e31 2050 5249 562c 2069 6e74  i_asn1 PRIV, int
│ │ │ │ +00040320: 2046 494c 4554 5950 452c 2063 6f6e 7374   FILETYPE, const
│ │ │ │ +00040330: 2063 6861 7220 2a20 4649 4c45 4e41 4d45   char * FILENAME
│ │ │ │ +00040340: 290a 2020 2020 2048 414e 444c 453a 2073  ).     HANDLE: s
│ │ │ │ +00040350: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ +00040360: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ +00040370: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ +00040380: 2e0a 2020 2020 2050 5249 563a 2050 5249  ..     PRIV: PRI
│ │ │ │ +00040390: 5620 746f 2073 6176 652e 0a20 2020 2020  V to save..     
│ │ │ │ +000403a0: 4649 4c45 5459 5045 3a20 696e 7075 7420  FILETYPE: input 
│ │ │ │ +000403b0: 7661 7269 6162 6c65 2073 7065 6369 6679  variable specify
│ │ │ │ +000403c0: 696e 6720 7479 7065 206f 6620 6669 6c65  ing type of file
│ │ │ │ +000403d0: 2074 6f20 6265 2077 7269 7474 656e 2c20   to be written, 
│ │ │ │ +000403e0: 7365 650a 2020 2020 2053 6869 7368 695f  see.     Shishi_
│ │ │ │ +000403f0: 6669 6c65 7479 7065 2e0a 2020 2020 2046  filetype..     F
│ │ │ │ +00040400: 494c 454e 414d 453a 2069 6e70 7574 2076  ILENAME: input v
│ │ │ │ +00040410: 6172 6961 626c 6520 7769 7468 2066 696c  ariable with fil
│ │ │ │ +00040420: 656e 616d 6520 746f 2077 7269 7465 2074  ename to write t
│ │ │ │ +00040430: 6f2e 0a0a 2020 2020 202a 4465 7363 7269  o...     *Descri
│ │ │ │ +00040440: 7074 696f 6e3a 2a20 5772 6974 6520 5052  ption:* Write PR
│ │ │ │ +00040450: 4956 2074 6f20 6669 6c65 2069 6e20 7370  IV to file in sp
│ │ │ │ +00040460: 6563 6966 6965 6420 5459 5045 2e20 5468  ecified TYPE. Th
│ │ │ │ +00040470: 6520 6669 6c65 2077 696c 6c0a 2020 2020  e file will.    
│ │ │ │ +00040480: 2062 6520 7472 756e 6361 7465 6420 6966   be truncated if
│ │ │ │ +00040490: 2069 7420 6578 6973 7473 2e0a 0a20 2020   it exists...   
│ │ │ │ +000404a0: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ +000404b0: 2a20 5265 7475 726e 7320 5348 4953 4849  * Returns SHISHI
│ │ │ │ +000404c0: 5f4f 4b20 6966 6620 7375 6363 6573 7366  _OK iff successf
│ │ │ │ +000404d0: 756c 2e0a 0a73 6869 7368 695f 7072 6976  ul...shishi_priv
│ │ │ │ +000404e0: 5f70 6172 7365 0a2d 2d2d 2d2d 2d2d 2d2d  _parse.---------
│ │ │ │ +000404f0: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ +00040500: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ +00040510: 6869 5f70 7269 765f 7061 7273 6520 2853  hi_priv_parse (S
│ │ │ │ +00040520: 6869 7368 6920 2a20 4841 4e44 4c45 2c20  hishi * HANDLE, 
│ │ │ │ +00040530: 4649 4c45 202a 2046 482c 0a20 2020 2020  FILE * FH,.     
│ │ │ │ +00040540: 2020 2020 2053 6869 7368 695f 6173 6e31       Shishi_asn1
│ │ │ │ +00040550: 202a 2050 5249 5629 0a20 2020 2020 4841   * PRIV).     HA
│ │ │ │ +00040560: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ +00040570: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ +00040580: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ +00040590: 6974 2829 e280 992e 0a20 2020 2020 4648  it().....     FH
│ │ │ │ +000405a0: 3a20 6669 6c65 2068 616e 646c 6520 6f70  : file handle op
│ │ │ │ +000405b0: 656e 2066 6f72 2072 6561 6469 6e67 2e0a  en for reading..
│ │ │ │ +000405c0: 2020 2020 2050 5249 563a 206f 7574 7075       PRIV: outpu
│ │ │ │ +000405d0: 7420 7661 7269 6162 6c65 2077 6974 6820  t variable with 
│ │ │ │ +000405e0: 6e65 776c 7920 616c 6c6f 6361 7465 6420  newly allocated 
│ │ │ │ +000405f0: 5052 4956 2e0a 0a20 2020 2020 2a44 6573  PRIV...     *Des
│ │ │ │ +00040600: 6372 6970 7469 6f6e 3a2a 2052 6561 6420  cription:* Read 
│ │ │ │ +00040610: 4153 4349 4920 6172 6d6f 7265 6420 4445  ASCII armored DE
│ │ │ │ +00040620: 5220 656e 636f 6465 6420 5052 4956 2066  R encoded PRIV f
│ │ │ │ +00040630: 726f 6d20 6669 6c65 2061 6e64 0a20 2020  rom file and.   
│ │ │ │ +00040640: 2020 706f 7075 6c61 7465 2067 6976 656e    populate given
│ │ │ │ +00040650: 2076 6172 6961 626c 652e 0a0a 2020 2020   variable...    
│ │ │ │ +00040660: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ +00040670: 2052 6574 7572 6e73 2053 4849 5348 495f   Returns SHISHI_
│ │ │ │ +00040680: 4f4b 2069 6666 2073 7563 6365 7373 6675  OK iff successfu
│ │ │ │ +00040690: 6c2e 0a0a 7368 6973 6869 5f70 7269 765f  l...shishi_priv_
│ │ │ │ +000406a0: 7265 6164 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  read.-----------
│ │ │ │ +000406b0: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +000406c0: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ +000406d0: 7072 6976 5f72 6561 6420 2853 6869 7368  priv_read (Shish
│ │ │ │ +000406e0: 6920 2a20 4841 4e44 4c45 2c20 4649 4c45  i * HANDLE, FILE
│ │ │ │ +000406f0: 202a 2046 482c 0a20 2020 2020 2020 2020   * FH,.         
│ │ │ │ +00040700: 2053 6869 7368 695f 6173 6e31 202a 2050   Shishi_asn1 * P
│ │ │ │ +00040710: 5249 5629 0a20 2020 2020 4841 4e44 4c45  RIV).     HANDLE
│ │ │ │ +00040720: 3a20 7368 6973 6869 2068 616e 646c 6520  : shishi handle 
│ │ │ │ +00040730: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ +00040740: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ +00040750: e280 992e 0a20 2020 2020 4648 3a20 6669  .....     FH: fi
│ │ │ │ +00040760: 6c65 2068 616e 646c 6520 6f70 656e 2066  le handle open f
│ │ │ │ +00040770: 6f72 2072 6561 6469 6e67 2e0a 2020 2020  or reading..    
│ │ │ │ +00040780: 2050 5249 563a 206f 7574 7075 7420 7661   PRIV: output va
│ │ │ │ +00040790: 7269 6162 6c65 2077 6974 6820 6e65 776c  riable with newl
│ │ │ │ +000407a0: 7920 616c 6c6f 6361 7465 6420 5052 4956  y allocated PRIV
│ │ │ │ +000407b0: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ +000407c0: 7469 6f6e 3a2a 2052 6561 6420 4445 5220  tion:* Read DER 
│ │ │ │ +000407d0: 656e 636f 6465 6420 5052 4956 2066 726f  encoded PRIV fro
│ │ │ │ +000407e0: 6d20 6669 6c65 2061 6e64 2070 6f70 756c  m file and popul
│ │ │ │ +000407f0: 6174 6520 6769 7665 6e0a 2020 2020 2076  ate given.     v
│ │ │ │ +00040800: 6172 6961 626c 652e 0a0a 2020 2020 202a  ariable...     *
│ │ │ │ +00040810: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ +00040820: 6574 7572 6e73 2053 4849 5348 495f 4f4b  eturns SHISHI_OK
│ │ │ │ +00040830: 2069 6666 2073 7563 6365 7373 6675 6c2e   iff successful.
│ │ │ │ +00040840: 0a0a 7368 6973 6869 5f70 7269 765f 6672  ..shishi_priv_fr
│ │ │ │ +00040850: 6f6d 5f66 696c 650a 2d2d 2d2d 2d2d 2d2d  om_file.--------
│ │ │ │ +00040860: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ +00040870: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ +00040880: 2073 6869 7368 695f 7072 6976 5f66 726f   shishi_priv_fro
│ │ │ │ +00040890: 6d5f 6669 6c65 2028 5368 6973 6869 202a  m_file (Shishi *
│ │ │ │ +000408a0: 2048 414e 444c 452c 0a20 2020 2020 2020   HANDLE,.       
│ │ │ │ +000408b0: 2020 2053 6869 7368 695f 6173 6e31 202a     Shishi_asn1 *
│ │ │ │ +000408c0: 2050 5249 562c 2069 6e74 2046 494c 4554   PRIV, int FILET
│ │ │ │ +000408d0: 5950 452c 2063 6f6e 7374 2063 6861 7220  YPE, const char 
│ │ │ │ +000408e0: 2a20 4649 4c45 4e41 4d45 290a 2020 2020  * FILENAME).    
│ │ │ │ +000408f0: 2048 414e 444c 453a 2073 6869 7368 6920   HANDLE: shishi 
│ │ │ │ +00040900: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ +00040910: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ +00040920: 5f69 6e69 7428 29e2 8099 2e0a 2020 2020  _init().....    
│ │ │ │ +00040930: 2050 5249 563a 206f 7574 7075 7420 7661   PRIV: output va
│ │ │ │ +00040940: 7269 6162 6c65 2077 6974 6820 6e65 776c  riable with newl
│ │ │ │ +00040950: 7920 616c 6c6f 6361 7465 6420 5052 4956  y allocated PRIV
│ │ │ │ +00040960: 2e0a 2020 2020 2046 494c 4554 5950 453a  ..     FILETYPE:
│ │ │ │ +00040970: 2069 6e70 7574 2076 6172 6961 626c 6520   input variable 
│ │ │ │ +00040980: 7370 6563 6966 7969 6e67 2074 7970 6520  specifying type 
│ │ │ │ +00040990: 6f66 2066 696c 6520 746f 2062 6520 7265  of file to be re
│ │ │ │ +000409a0: 6164 2c20 7365 650a 2020 2020 2053 6869  ad, see.     Shi
│ │ │ │ +000409b0: 7368 695f 6669 6c65 7479 7065 2e0a 2020  shi_filetype..  
│ │ │ │ +000409c0: 2020 2046 494c 454e 414d 453a 2069 6e70     FILENAME: inp
│ │ │ │ +000409d0: 7574 2076 6172 6961 626c 6520 7769 7468  ut variable with
│ │ │ │ +000409e0: 2066 696c 656e 616d 6520 746f 2072 6561   filename to rea
│ │ │ │ +000409f0: 6420 6672 6f6d 2e0a 0a20 2020 2020 2a44  d from...     *D
│ │ │ │ +00040a00: 6573 6372 6970 7469 6f6e 3a2a 2052 6561  escription:* Rea
│ │ │ │ +00040a10: 6420 5052 4956 2066 726f 6d20 6669 6c65  d PRIV from file
│ │ │ │ +00040a20: 2069 6e20 7370 6563 6966 6965 6420 5459   in specified TY
│ │ │ │ +00040a30: 5045 2e0a 0a20 2020 2020 2a52 6574 7572  PE...     *Retur
│ │ │ │ +00040a40: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ +00040a50: 7320 5348 4953 4849 5f4f 4b20 6966 6620  s SHISHI_OK iff 
│ │ │ │ +00040a60: 7375 6363 6573 7366 756c 2e0a 0a73 6869  successful...shi
│ │ │ │ +00040a70: 7368 695f 7072 6976 5f65 6e63 5f70 6172  shi_priv_enc_par
│ │ │ │ +00040a80: 745f 6574 7970 650a 2d2d 2d2d 2d2d 2d2d  t_etype.--------
│ │ │ │  00040a90: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00040aa0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ -00040ab0: 696e 7420 7368 6973 6869 5f70 7269 765f  int shishi_priv_
│ │ │ │ -00040ac0: 656e 635f 7061 7274 5f65 7479 7065 2028  enc_part_etype (
│ │ │ │ -00040ad0: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ -00040ae0: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ -00040af0: 695f 6173 6e31 2050 5249 562c 2069 6e74  i_asn1 PRIV, int
│ │ │ │ -00040b00: 3332 5f74 202a 2045 5459 5045 290a 2020  32_t * ETYPE).  
│ │ │ │ -00040b10: 2020 2048 414e 444c 453a 2073 6869 7368     HANDLE: shish
│ │ │ │ -00040b20: 6920 6861 6e64 6c65 2061 7320 616c 6c6f  i handle as allo
│ │ │ │ -00040b30: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ -00040b40: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ -00040b50: 2020 2050 5249 563a 2050 5249 5620 7661     PRIV: PRIV va
│ │ │ │ -00040b60: 7269 6162 6c65 2074 6f20 6765 7420 7661  riable to get va
│ │ │ │ -00040b70: 6c75 6520 6672 6f6d 2e0a 2020 2020 2045  lue from..     E
│ │ │ │ -00040b80: 5459 5045 3a20 6f75 7470 7574 2076 6172  TYPE: output var
│ │ │ │ -00040b90: 6961 626c 6520 7468 6174 2068 6f6c 6473  iable that holds
│ │ │ │ -00040ba0: 2074 6865 2076 616c 7565 2e0a 0a20 2020   the value...   
│ │ │ │ -00040bb0: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ -00040bc0: 2045 7874 7261 6374 2050 5249 562e 656e   Extract PRIV.en
│ │ │ │ -00040bd0: 632d 7061 7274 2e65 7479 7065 2e0a 0a20  c-part.etype... 
│ │ │ │ -00040be0: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ -00040bf0: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ -00040c00: 4849 5f4f 4b20 6966 6620 7375 6363 6573  HI_OK iff succes
│ │ │ │ -00040c10: 7366 756c 2e0a 0a73 6869 7368 695f 7072  sful...shishi_pr
│ │ │ │ -00040c20: 6976 5f73 6574 5f65 6e63 5f70 6172 740a  iv_set_enc_part.
│ │ │ │ -00040c30: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00040c40: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -00040c50: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ -00040c60: 6869 5f70 7269 765f 7365 745f 656e 635f  hi_priv_set_enc_
│ │ │ │ -00040c70: 7061 7274 2028 5368 6973 6869 202a 2048  part (Shishi * H
│ │ │ │ -00040c80: 414e 444c 452c 0a20 2020 2020 2020 2020  ANDLE,.         
│ │ │ │ -00040c90: 2053 6869 7368 695f 6173 6e31 2050 5249   Shishi_asn1 PRI
│ │ │ │ -00040ca0: 562c 2069 6e74 3332 5f74 2045 5459 5045  V, int32_t ETYPE
│ │ │ │ -00040cb0: 2c20 636f 6e73 7420 6368 6172 202a 2045  , const char * E
│ │ │ │ -00040cc0: 4e43 5041 5254 2c0a 2020 2020 2020 2020  NCPART,.        
│ │ │ │ -00040cd0: 2020 7369 7a65 5f74 2045 4e43 5041 5254    size_t ENCPART
│ │ │ │ -00040ce0: 4c45 4e29 0a20 2020 2020 4841 4e44 4c45  LEN).     HANDLE
│ │ │ │ -00040cf0: 3a20 7368 6973 6869 2068 616e 646c 6520  : shishi handle 
│ │ │ │ -00040d00: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ -00040d10: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ -00040d20: e280 992e 0a20 2020 2020 5052 4956 3a20  .....     PRIV: 
│ │ │ │ -00040d30: 7072 6976 2061 7320 616c 6c6f 6361 7465  priv as allocate
│ │ │ │ -00040d40: 6420 6279 20e2 8098 7368 6973 6869 5f70  d by ...shishi_p
│ │ │ │ -00040d50: 7269 7628 29e2 8099 2e0a 2020 2020 2045  riv().....     E
│ │ │ │ -00040d60: 5459 5045 3a20 696e 7075 7420 656e 6372  TYPE: input encr
│ │ │ │ -00040d70: 7970 7469 6f6e 2074 7970 6520 746f 2073  yption type to s
│ │ │ │ -00040d80: 746f 7265 2069 6e20 5052 4956 2e0a 2020  tore in PRIV..  
│ │ │ │ -00040d90: 2020 2045 4e43 5041 5254 3a20 696e 7075     ENCPART: inpu
│ │ │ │ -00040da0: 7420 656e 6372 7970 7465 6420 6461 7461  t encrypted data
│ │ │ │ -00040db0: 2074 6f20 7374 6f72 6520 696e 2050 5249   to store in PRI
│ │ │ │ -00040dc0: 562e 0a20 2020 2020 454e 4350 4152 544c  V..     ENCPARTL
│ │ │ │ -00040dd0: 454e 3a20 7369 7a65 206f 6620 696e 7075  EN: size of inpu
│ │ │ │ -00040de0: 7420 656e 6372 7970 7465 6420 6461 7461  t encrypted data
│ │ │ │ -00040df0: 2074 6f20 7374 6f72 6520 696e 2050 5249   to store in PRI
│ │ │ │ -00040e00: 562e 0a0a 2020 2020 202a 4465 7363 7269  V...     *Descri
│ │ │ │ -00040e10: 7074 696f 6e3a 2a20 5374 6f72 6520 656e  ption:* Store en
│ │ │ │ -00040e20: 6372 7970 7465 6420 6461 7461 2069 6e20  crypted data in 
│ │ │ │ -00040e30: 5052 4956 2e20 5468 6520 656e 6372 7970  PRIV. The encryp
│ │ │ │ -00040e40: 7465 6420 6461 7461 2069 730a 2020 2020  ted data is.    
│ │ │ │ -00040e50: 2075 7375 616c 6c79 2063 7265 6174 6564   usually created
│ │ │ │ -00040e60: 2062 7920 6361 6c6c 696e 6720 e280 9873   by calling ...s
│ │ │ │ -00040e70: 6869 7368 695f 656e 6372 7970 7428 29e2  hishi_encrypt().
│ │ │ │ -00040e80: 8099 206f 6e20 736f 6d65 2061 7070 6c69  .. on some appli
│ │ │ │ -00040e90: 6361 7469 6f6e 0a20 2020 2020 7370 6563  cation.     spec
│ │ │ │ -00040ea0: 6966 6963 2064 6174 6120 7573 696e 6720  ific data using 
│ │ │ │ -00040eb0: 7468 6520 6b65 7920 6672 6f6d 2074 6865  the key from the
│ │ │ │ -00040ec0: 2074 6963 6b65 7420 7468 6174 2069 7320   ticket that is 
│ │ │ │ -00040ed0: 6265 696e 6720 7573 6564 2e20 2054 6f0a  being used.  To.
│ │ │ │ -00040ee0: 2020 2020 2073 6176 6520 7469 6d65 2c20       save time, 
│ │ │ │ -00040ef0: 796f 7520 6d61 7920 7761 6e74 2074 6f20  you may want to 
│ │ │ │ -00040f00: 7573 6520 e280 9873 6869 7368 695f 7072  use ...shishi_pr
│ │ │ │ -00040f10: 6976 5f62 7569 6c64 2829 e280 9920 696e  iv_build()... in
│ │ │ │ -00040f20: 7374 6561 642c 2077 6869 6368 0a20 2020  stead, which.   
│ │ │ │ -00040f30: 2020 656e 6372 7970 7465 7320 7468 6520    encryptes the 
│ │ │ │ -00040f40: 6461 7461 2061 6e64 2063 616c 6c73 2074  data and calls t
│ │ │ │ -00040f50: 6869 7320 6675 6e63 7469 6f6e 2069 6e20  his function in 
│ │ │ │ -00040f60: 6f6e 6520 7374 6570 2e0a 0a20 2020 2020  one step...     
│ │ │ │ -00040f70: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ -00040f80: 5265 7475 726e 7320 5348 4953 4849 5f4f  Returns SHISHI_O
│ │ │ │ -00040f90: 4b20 6966 6620 7375 6363 6573 7366 756c  K iff successful
│ │ │ │ -00040fa0: 2e0a 0a73 6869 7368 695f 656e 6370 7269  ...shishi_encpri
│ │ │ │ -00040fb0: 7670 6172 745f 7573 6572 5f64 6174 610a  vpart_user_data.
│ │ │ │ -00040fc0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00040fd0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ -00040fe0: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ -00040ff0: 7368 6973 6869 5f65 6e63 7072 6976 7061  shishi_encprivpa
│ │ │ │ -00041000: 7274 5f75 7365 725f 6461 7461 2028 5368  rt_user_data (Sh
│ │ │ │ -00041010: 6973 6869 202a 2048 414e 444c 452c 0a20  ishi * HANDLE,. 
│ │ │ │ -00041020: 2020 2020 2020 2020 2053 6869 7368 695f           Shishi_
│ │ │ │ -00041030: 6173 6e31 2045 4e43 5052 4956 5041 5254  asn1 ENCPRIVPART
│ │ │ │ -00041040: 2c20 6368 6172 202a 2a20 5553 4552 4441  , char ** USERDA
│ │ │ │ -00041050: 5441 2c0a 2020 2020 2020 2020 2020 7369  TA,.          si
│ │ │ │ -00041060: 7a65 5f74 202a 2055 5345 5244 4154 414c  ze_t * USERDATAL
│ │ │ │ -00041070: 454e 290a 2020 2020 2048 414e 444c 453a  EN).     HANDLE:
│ │ │ │ -00041080: 2073 6869 7368 6920 6861 6e64 6c65 2061   shishi handle a
│ │ │ │ -00041090: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ -000410a0: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ -000410b0: 8099 2e0a 2020 2020 2045 4e43 5052 4956  ....     ENCPRIV
│ │ │ │ -000410c0: 5041 5254 3a20 656e 6370 7269 7670 6172  PART: encprivpar
│ │ │ │ -000410d0: 7420 6173 2061 6c6c 6f63 6174 6564 2062  t as allocated b
│ │ │ │ -000410e0: 7920 e280 9873 6869 7368 695f 7072 6976  y ...shishi_priv
│ │ │ │ -000410f0: 2829 e280 992e 0a20 2020 2020 5553 4552  ().....     USER
│ │ │ │ -00041100: 4441 5441 3a20 6f75 7470 7574 2061 7272  DATA: output arr
│ │ │ │ -00041110: 6179 2077 6974 6820 6e65 776c 7920 616c  ay with newly al
│ │ │ │ -00041120: 6c6f 6361 7465 6420 7573 6572 2064 6174  located user dat
│ │ │ │ -00041130: 6120 6672 6f6d 0a20 2020 2020 4b52 422d  a from.     KRB-
│ │ │ │ -00041140: 5052 4956 2e0a 2020 2020 2055 5345 5244  PRIV..     USERD
│ │ │ │ -00041150: 4154 414c 454e 3a20 6f75 7470 7574 2073  ATALEN: output s
│ │ │ │ -00041160: 697a 6520 6f66 206f 7574 7075 7420 7573  ize of output us
│ │ │ │ -00041170: 6572 2064 6174 6120 6275 6666 6572 2e0a  er data buffer..
│ │ │ │ -00041180: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -00041190: 6f6e 3a2a 2052 6561 6420 7573 6572 2064  on:* Read user d
│ │ │ │ -000411a0: 6174 6120 7661 6c75 6520 6672 6f6d 204b  ata value from K
│ │ │ │ -000411b0: 5242 2d50 5249 562e 2055 5345 5244 4154  RB-PRIV. USERDAT
│ │ │ │ -000411c0: 4120 6973 0a20 2020 2020 616c 6c6f 6361  A is.     alloca
│ │ │ │ -000411d0: 7465 6420 6279 2074 6869 7320 6675 6e63  ted by this func
│ │ │ │ -000411e0: 7469 6f6e 2c20 616e 6420 6974 2069 7320  tion, and it is 
│ │ │ │ -000411f0: 7468 6520 7265 7370 6f6e 7369 6269 6c69  the responsibili
│ │ │ │ -00041200: 7479 206f 6620 6361 6c6c 6572 0a20 2020  ty of caller.   
│ │ │ │ -00041210: 2020 746f 2064 6561 6c6c 6f63 6174 6520    to deallocate 
│ │ │ │ -00041220: 6974 2e0a 0a20 2020 2020 2a52 6574 7572  it...     *Retur
│ │ │ │ -00041230: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ -00041240: 7320 5348 4953 4849 5f4f 4b20 6966 6620  s SHISHI_OK iff 
│ │ │ │ -00041250: 7375 6363 6573 7366 756c 2e0a 0a73 6869  successful...shi
│ │ │ │ -00041260: 7368 695f 656e 6370 7269 7670 6172 745f  shi_encprivpart_
│ │ │ │ -00041270: 7365 745f 7573 6572 5f64 6174 610a 2d2d  set_user_data.--
│ │ │ │ +00040aa0: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ +00040ab0: 3a20 696e 7420 7368 6973 6869 5f70 7269  : int shishi_pri
│ │ │ │ +00040ac0: 765f 656e 635f 7061 7274 5f65 7479 7065  v_enc_part_etype
│ │ │ │ +00040ad0: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ +00040ae0: 452c 0a20 2020 2020 2020 2020 2053 6869  E,.          Shi
│ │ │ │ +00040af0: 7368 695f 6173 6e31 2050 5249 562c 2069  shi_asn1 PRIV, i
│ │ │ │ +00040b00: 6e74 3332 5f74 202a 2045 5459 5045 290a  nt32_t * ETYPE).
│ │ │ │ +00040b10: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ +00040b20: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ +00040b30: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ +00040b40: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ +00040b50: 2020 2020 2050 5249 563a 2050 5249 5620       PRIV: PRIV 
│ │ │ │ +00040b60: 7661 7269 6162 6c65 2074 6f20 6765 7420  variable to get 
│ │ │ │ +00040b70: 7661 6c75 6520 6672 6f6d 2e0a 2020 2020  value from..    
│ │ │ │ +00040b80: 2045 5459 5045 3a20 6f75 7470 7574 2076   ETYPE: output v
│ │ │ │ +00040b90: 6172 6961 626c 6520 7468 6174 2068 6f6c  ariable that hol
│ │ │ │ +00040ba0: 6473 2074 6865 2076 616c 7565 2e0a 0a20  ds the value... 
│ │ │ │ +00040bb0: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ +00040bc0: 3a2a 2045 7874 7261 6374 2050 5249 562e  :* Extract PRIV.
│ │ │ │ +00040bd0: 656e 632d 7061 7274 2e65 7479 7065 2e0a  enc-part.etype..
│ │ │ │ +00040be0: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ +00040bf0: 6c75 653a 2a20 5265 7475 726e 7320 5348  lue:* Returns SH
│ │ │ │ +00040c00: 4953 4849 5f4f 4b20 6966 6620 7375 6363  ISHI_OK iff succ
│ │ │ │ +00040c10: 6573 7366 756c 2e0a 0a73 6869 7368 695f  essful...shishi_
│ │ │ │ +00040c20: 7072 6976 5f73 6574 5f65 6e63 5f70 6172  priv_set_enc_par
│ │ │ │ +00040c30: 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  t.--------------
│ │ │ │ +00040c40: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +00040c50: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ +00040c60: 6973 6869 5f70 7269 765f 7365 745f 656e  ishi_priv_set_en
│ │ │ │ +00040c70: 635f 7061 7274 2028 5368 6973 6869 202a  c_part (Shishi *
│ │ │ │ +00040c80: 2048 414e 444c 452c 0a20 2020 2020 2020   HANDLE,.       
│ │ │ │ +00040c90: 2020 2053 6869 7368 695f 6173 6e31 2050     Shishi_asn1 P
│ │ │ │ +00040ca0: 5249 562c 2069 6e74 3332 5f74 2045 5459  RIV, int32_t ETY
│ │ │ │ +00040cb0: 5045 2c20 636f 6e73 7420 6368 6172 202a  PE, const char *
│ │ │ │ +00040cc0: 2045 4e43 5041 5254 2c0a 2020 2020 2020   ENCPART,.      
│ │ │ │ +00040cd0: 2020 2020 7369 7a65 5f74 2045 4e43 5041      size_t ENCPA
│ │ │ │ +00040ce0: 5254 4c45 4e29 0a20 2020 2020 4841 4e44  RTLEN).     HAND
│ │ │ │ +00040cf0: 4c45 3a20 7368 6973 6869 2068 616e 646c  LE: shishi handl
│ │ │ │ +00040d00: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ +00040d10: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ +00040d20: 2829 e280 992e 0a20 2020 2020 5052 4956  ().....     PRIV
│ │ │ │ +00040d30: 3a20 7072 6976 2061 7320 616c 6c6f 6361  : priv as alloca
│ │ │ │ +00040d40: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ +00040d50: 5f70 7269 7628 29e2 8099 2e0a 2020 2020  _priv().....    
│ │ │ │ +00040d60: 2045 5459 5045 3a20 696e 7075 7420 656e   ETYPE: input en
│ │ │ │ +00040d70: 6372 7970 7469 6f6e 2074 7970 6520 746f  cryption type to
│ │ │ │ +00040d80: 2073 746f 7265 2069 6e20 5052 4956 2e0a   store in PRIV..
│ │ │ │ +00040d90: 2020 2020 2045 4e43 5041 5254 3a20 696e       ENCPART: in
│ │ │ │ +00040da0: 7075 7420 656e 6372 7970 7465 6420 6461  put encrypted da
│ │ │ │ +00040db0: 7461 2074 6f20 7374 6f72 6520 696e 2050  ta to store in P
│ │ │ │ +00040dc0: 5249 562e 0a20 2020 2020 454e 4350 4152  RIV..     ENCPAR
│ │ │ │ +00040dd0: 544c 454e 3a20 7369 7a65 206f 6620 696e  TLEN: size of in
│ │ │ │ +00040de0: 7075 7420 656e 6372 7970 7465 6420 6461  put encrypted da
│ │ │ │ +00040df0: 7461 2074 6f20 7374 6f72 6520 696e 2050  ta to store in P
│ │ │ │ +00040e00: 5249 562e 0a0a 2020 2020 202a 4465 7363  RIV...     *Desc
│ │ │ │ +00040e10: 7269 7074 696f 6e3a 2a20 5374 6f72 6520  ription:* Store 
│ │ │ │ +00040e20: 656e 6372 7970 7465 6420 6461 7461 2069  encrypted data i
│ │ │ │ +00040e30: 6e20 5052 4956 2e20 5468 6520 656e 6372  n PRIV. The encr
│ │ │ │ +00040e40: 7970 7465 6420 6461 7461 2069 730a 2020  ypted data is.  
│ │ │ │ +00040e50: 2020 2075 7375 616c 6c79 2063 7265 6174     usually creat
│ │ │ │ +00040e60: 6564 2062 7920 6361 6c6c 696e 6720 e280  ed by calling ..
│ │ │ │ +00040e70: 9873 6869 7368 695f 656e 6372 7970 7428  .shishi_encrypt(
│ │ │ │ +00040e80: 29e2 8099 206f 6e20 736f 6d65 2061 7070  )... on some app
│ │ │ │ +00040e90: 6c69 6361 7469 6f6e 0a20 2020 2020 7370  lication.     sp
│ │ │ │ +00040ea0: 6563 6966 6963 2064 6174 6120 7573 696e  ecific data usin
│ │ │ │ +00040eb0: 6720 7468 6520 6b65 7920 6672 6f6d 2074  g the key from t
│ │ │ │ +00040ec0: 6865 2074 6963 6b65 7420 7468 6174 2069  he ticket that i
│ │ │ │ +00040ed0: 7320 6265 696e 6720 7573 6564 2e20 2054  s being used.  T
│ │ │ │ +00040ee0: 6f0a 2020 2020 2073 6176 6520 7469 6d65  o.     save time
│ │ │ │ +00040ef0: 2c20 796f 7520 6d61 7920 7761 6e74 2074  , you may want t
│ │ │ │ +00040f00: 6f20 7573 6520 e280 9873 6869 7368 695f  o use ...shishi_
│ │ │ │ +00040f10: 7072 6976 5f62 7569 6c64 2829 e280 9920  priv_build()... 
│ │ │ │ +00040f20: 696e 7374 6561 642c 2077 6869 6368 0a20  instead, which. 
│ │ │ │ +00040f30: 2020 2020 656e 6372 7970 7465 7320 7468      encryptes th
│ │ │ │ +00040f40: 6520 6461 7461 2061 6e64 2063 616c 6c73  e data and calls
│ │ │ │ +00040f50: 2074 6869 7320 6675 6e63 7469 6f6e 2069   this function i
│ │ │ │ +00040f60: 6e20 6f6e 6520 7374 6570 2e0a 0a20 2020  n one step...   
│ │ │ │ +00040f70: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ +00040f80: 2a20 5265 7475 726e 7320 5348 4953 4849  * Returns SHISHI
│ │ │ │ +00040f90: 5f4f 4b20 6966 6620 7375 6363 6573 7366  _OK iff successf
│ │ │ │ +00040fa0: 756c 2e0a 0a73 6869 7368 695f 656e 6370  ul...shishi_encp
│ │ │ │ +00040fb0: 7269 7670 6172 745f 7573 6572 5f64 6174  rivpart_user_dat
│ │ │ │ +00040fc0: 610a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  a.--------------
│ │ │ │ +00040fd0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ +00040fe0: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ +00040ff0: 7420 7368 6973 6869 5f65 6e63 7072 6976  t shishi_encpriv
│ │ │ │ +00041000: 7061 7274 5f75 7365 725f 6461 7461 2028  part_user_data (
│ │ │ │ +00041010: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ +00041020: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ +00041030: 695f 6173 6e31 2045 4e43 5052 4956 5041  i_asn1 ENCPRIVPA
│ │ │ │ +00041040: 5254 2c20 6368 6172 202a 2a20 5553 4552  RT, char ** USER
│ │ │ │ +00041050: 4441 5441 2c0a 2020 2020 2020 2020 2020  DATA,.          
│ │ │ │ +00041060: 7369 7a65 5f74 202a 2055 5345 5244 4154  size_t * USERDAT
│ │ │ │ +00041070: 414c 454e 290a 2020 2020 2048 414e 444c  ALEN).     HANDL
│ │ │ │ +00041080: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ +00041090: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ +000410a0: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ +000410b0: 29e2 8099 2e0a 2020 2020 2045 4e43 5052  ).....     ENCPR
│ │ │ │ +000410c0: 4956 5041 5254 3a20 656e 6370 7269 7670  IVPART: encprivp
│ │ │ │ +000410d0: 6172 7420 6173 2061 6c6c 6f63 6174 6564  art as allocated
│ │ │ │ +000410e0: 2062 7920 e280 9873 6869 7368 695f 7072   by ...shishi_pr
│ │ │ │ +000410f0: 6976 2829 e280 992e 0a20 2020 2020 5553  iv().....     US
│ │ │ │ +00041100: 4552 4441 5441 3a20 6f75 7470 7574 2061  ERDATA: output a
│ │ │ │ +00041110: 7272 6179 2077 6974 6820 6e65 776c 7920  rray with newly 
│ │ │ │ +00041120: 616c 6c6f 6361 7465 6420 7573 6572 2064  allocated user d
│ │ │ │ +00041130: 6174 6120 6672 6f6d 0a20 2020 2020 4b52  ata from.     KR
│ │ │ │ +00041140: 422d 5052 4956 2e0a 2020 2020 2055 5345  B-PRIV..     USE
│ │ │ │ +00041150: 5244 4154 414c 454e 3a20 6f75 7470 7574  RDATALEN: output
│ │ │ │ +00041160: 2073 697a 6520 6f66 206f 7574 7075 7420   size of output 
│ │ │ │ +00041170: 7573 6572 2064 6174 6120 6275 6666 6572  user data buffer
│ │ │ │ +00041180: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ +00041190: 7469 6f6e 3a2a 2052 6561 6420 7573 6572  tion:* Read user
│ │ │ │ +000411a0: 2064 6174 6120 7661 6c75 6520 6672 6f6d   data value from
│ │ │ │ +000411b0: 204b 5242 2d50 5249 562e 2055 5345 5244   KRB-PRIV. USERD
│ │ │ │ +000411c0: 4154 4120 6973 0a20 2020 2020 616c 6c6f  ATA is.     allo
│ │ │ │ +000411d0: 6361 7465 6420 6279 2074 6869 7320 6675  cated by this fu
│ │ │ │ +000411e0: 6e63 7469 6f6e 2c20 616e 6420 6974 2069  nction, and it i
│ │ │ │ +000411f0: 7320 7468 6520 7265 7370 6f6e 7369 6269  s the responsibi
│ │ │ │ +00041200: 6c69 7479 206f 6620 6361 6c6c 6572 0a20  lity of caller. 
│ │ │ │ +00041210: 2020 2020 746f 2064 6561 6c6c 6f63 6174      to deallocat
│ │ │ │ +00041220: 6520 6974 2e0a 0a20 2020 2020 2a52 6574  e it...     *Ret
│ │ │ │ +00041230: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ +00041240: 726e 7320 5348 4953 4849 5f4f 4b20 6966  rns SHISHI_OK if
│ │ │ │ +00041250: 6620 7375 6363 6573 7366 756c 2e0a 0a73  f successful...s
│ │ │ │ +00041260: 6869 7368 695f 656e 6370 7269 7670 6172  hishi_encprivpar
│ │ │ │ +00041270: 745f 7365 745f 7573 6572 5f64 6174 610a  t_set_user_data.
│ │ │ │  00041280: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00041290: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -000412a0: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ -000412b0: 7420 7368 6973 6869 5f65 6e63 7072 6976  t shishi_encpriv
│ │ │ │ -000412c0: 7061 7274 5f73 6574 5f75 7365 725f 6461  part_set_user_da
│ │ │ │ -000412d0: 7461 2028 5368 6973 6869 202a 2048 414e  ta (Shishi * HAN
│ │ │ │ -000412e0: 444c 452c 0a20 2020 2020 2020 2020 2053  DLE,.          S
│ │ │ │ -000412f0: 6869 7368 695f 6173 6e31 2045 4e43 5052  hishi_asn1 ENCPR
│ │ │ │ -00041300: 4956 5041 5254 2c20 636f 6e73 7420 6368  IVPART, const ch
│ │ │ │ -00041310: 6172 202a 2055 5345 5244 4154 412c 0a20  ar * USERDATA,. 
│ │ │ │ -00041320: 2020 2020 2020 2020 2073 697a 655f 7420           size_t 
│ │ │ │ -00041330: 5553 4552 4441 5441 4c45 4e29 0a20 2020  USERDATALEN).   
│ │ │ │ -00041340: 2020 4841 4e44 4c45 3a20 7368 6973 6869    HANDLE: shishi
│ │ │ │ -00041350: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ -00041360: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ -00041370: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ -00041380: 2020 454e 4350 5249 5650 4152 543a 2065    ENCPRIVPART: e
│ │ │ │ -00041390: 6e63 7072 6976 7061 7274 2061 7320 616c  ncprivpart as al
│ │ │ │ -000413a0: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ -000413b0: 6973 6869 5f70 7269 7628 29e2 8099 2e0a  ishi_priv().....
│ │ │ │ -000413c0: 2020 2020 2055 5345 5244 4154 413a 2069       USERDATA: i
│ │ │ │ -000413d0: 6e70 7574 2075 7365 7220 6170 706c 6963  nput user applic
│ │ │ │ -000413e0: 6174 696f 6e20 746f 2073 746f 7265 2069  ation to store i
│ │ │ │ -000413f0: 6e20 5052 4956 2e0a 2020 2020 2055 5345  n PRIV..     USE
│ │ │ │ -00041400: 5244 4154 414c 454e 3a20 7369 7a65 206f  RDATALEN: size o
│ │ │ │ -00041410: 6620 696e 7075 7420 7573 6572 2061 7070  f input user app
│ │ │ │ -00041420: 6c69 6361 7469 6f6e 2074 6f20 7374 6f72  lication to stor
│ │ │ │ -00041430: 6520 696e 2050 5249 562e 0a0a 2020 2020  e in PRIV...    
│ │ │ │ -00041440: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ -00041450: 5365 7420 7468 6520 6170 706c 6963 6174  Set the applicat
│ │ │ │ -00041460: 696f 6e20 6461 7461 2069 6e20 5052 4956  ion data in PRIV
│ │ │ │ -00041470: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ -00041480: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ -00041490: 5348 4953 4849 5f4f 4b20 6966 6620 7375  SHISHI_OK iff su
│ │ │ │ -000414a0: 6363 6573 7366 756c 2e0a 0a73 6869 7368  ccessful...shish
│ │ │ │ -000414b0: 695f 7072 6976 5f62 7569 6c64 0a2d 2d2d  i_priv_build.---
│ │ │ │ -000414c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -000414d0: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ -000414e0: 7420 7368 6973 6869 5f70 7269 765f 6275  t shishi_priv_bu
│ │ │ │ -000414f0: 696c 6420 2853 6869 7368 695f 7072 6976  ild (Shishi_priv
│ │ │ │ -00041500: 202a 2050 5249 562c 0a20 2020 2020 2020   * PRIV,.       
│ │ │ │ -00041510: 2020 2053 6869 7368 695f 6b65 7920 2a20     Shishi_key * 
│ │ │ │ -00041520: 4b45 5929 0a20 2020 2020 5052 4956 3a20  KEY).     PRIV: 
│ │ │ │ -00041530: 7072 6976 2061 7320 616c 6c6f 6361 7465  priv as allocate
│ │ │ │ -00041540: 6420 6279 20e2 8098 7368 6973 6869 5f70  d by ...shishi_p
│ │ │ │ -00041550: 7269 7628 29e2 8099 2e0a 2020 2020 204b  riv().....     K
│ │ │ │ -00041560: 4559 3a20 6b65 7920 666f 7220 7365 7373  EY: key for sess
│ │ │ │ -00041570: 696f 6e2c 2075 7365 6420 746f 2065 6e63  ion, used to enc
│ │ │ │ -00041580: 7279 7074 2064 6174 612e 0a0a 2020 2020  rypt data...    
│ │ │ │ -00041590: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ -000415a0: 4275 696c 6420 6368 6563 6b73 756d 2061  Build checksum a
│ │ │ │ -000415b0: 6e64 2073 6574 2069 7420 696e 204b 5242  nd set it in KRB
│ │ │ │ -000415c0: 2d50 5249 562e 204e 6f74 6520 7468 6174  -PRIV. Note that
│ │ │ │ -000415d0: 0a20 2020 2020 7468 6973 2066 6f6c 6c6f  .     this follo
│ │ │ │ -000415e0: 7773 2052 4643 2031 3531 3062 6973 2061  ws RFC 1510bis a
│ │ │ │ -000415f0: 6e64 2069 7320 696e 636f 6d70 6174 6962  nd is incompatib
│ │ │ │ -00041600: 6c65 2077 6974 6820 5246 4320 3135 3130  le with RFC 1510
│ │ │ │ -00041610: 2c0a 2020 2020 2061 6c74 686f 7567 6820  ,.     although 
│ │ │ │ -00041620: 7072 6573 756d 6162 6c79 2066 6577 2069  presumably few i
│ │ │ │ -00041630: 6d70 6c65 6d65 6e74 6174 696f 6e73 2075  mplementations u
│ │ │ │ -00041640: 7365 2074 6865 2052 4643 3135 3130 2061  se the RFC1510 a
│ │ │ │ -00041650: 6c67 6f72 6974 686d 2e0a 0a20 2020 2020  lgorithm...     
│ │ │ │ -00041660: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ -00041670: 5265 7475 726e 7320 5348 4953 4849 5f4f  Returns SHISHI_O
│ │ │ │ -00041680: 4b20 6966 6620 7375 6363 6573 7366 756c  K iff successful
│ │ │ │ -00041690: 2e0a 0a73 6869 7368 695f 7072 6976 5f70  ...shishi_priv_p
│ │ │ │ -000416a0: 726f 6365 7373 0a2d 2d2d 2d2d 2d2d 2d2d  rocess.---------
│ │ │ │ -000416b0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ -000416c0: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ -000416d0: 6973 6869 5f70 7269 765f 7072 6f63 6573  ishi_priv_proces
│ │ │ │ -000416e0: 7320 2853 6869 7368 695f 7072 6976 202a  s (Shishi_priv *
│ │ │ │ -000416f0: 2050 5249 562c 0a20 2020 2020 2020 2020   PRIV,.         
│ │ │ │ -00041700: 2053 6869 7368 695f 6b65 7920 2a20 4b45   Shishi_key * KE
│ │ │ │ -00041710: 5929 0a20 2020 2020 5052 4956 3a20 7072  Y).     PRIV: pr
│ │ │ │ -00041720: 6976 2061 7320 616c 6c6f 6361 7465 6420  iv as allocated 
│ │ │ │ -00041730: 6279 20e2 8098 7368 6973 6869 5f70 7269  by ...shishi_pri
│ │ │ │ -00041740: 7628 29e2 8099 2e0a 2020 2020 204b 4559  v().....     KEY
│ │ │ │ -00041750: 3a20 6b65 7920 746f 2075 7365 2074 6f20  : key to use to 
│ │ │ │ -00041760: 6465 6372 7970 7420 456e 6350 7269 7650  decrypt EncPrivP
│ │ │ │ -00041770: 6172 742e 0a0a 2020 2020 202a 4465 7363  art...     *Desc
│ │ │ │ -00041780: 7269 7074 696f 6e3a 2a20 4465 6372 7970  ription:* Decryp
│ │ │ │ -00041790: 7420 656e 6372 7970 7465 6420 6461 7461  t encrypted data
│ │ │ │ -000417a0: 2069 6e20 4b52 422d 5052 4956 2061 6e64   in KRB-PRIV and
│ │ │ │ -000417b0: 2073 6574 2074 6865 0a20 2020 2020 456e   set the.     En
│ │ │ │ -000417c0: 6350 7269 7650 6172 7420 696e 2074 6865  cPrivPart in the
│ │ │ │ -000417d0: 2050 5249 5620 6578 6368 616e 6765 2e0a   PRIV exchange..
│ │ │ │ -000417e0: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ -000417f0: 6c75 653a 2a20 5265 7475 726e 7320 5348  lue:* Returns SH
│ │ │ │ -00041800: 4953 4849 5f4f 4b20 6966 6620 7375 6363  ISHI_OK iff succ
│ │ │ │ -00041810: 6573 7366 756c 2c0a 2020 2020 2053 4849  essful,.     SHI
│ │ │ │ -00041820: 5348 495f 5052 4956 5f42 4144 5f4b 4559  SHI_PRIV_BAD_KEY
│ │ │ │ -00041830: 5459 5045 2069 6620 616e 2069 6e63 6f6d  TYPE if an incom
│ │ │ │ -00041840: 7061 7469 626c 6520 6b65 7920 7479 7065  patible key type
│ │ │ │ -00041850: 2069 7320 7573 6564 2c20 6f72 0a20 2020   is used, or.   
│ │ │ │ -00041860: 2020 5348 4953 4849 5f43 5259 5054 4f5f    SHISHI_CRYPTO_
│ │ │ │ -00041870: 4552 524f 5220 6966 2074 6865 2061 6374  ERROR if the act
│ │ │ │ -00041880: 7561 6c20 6465 6372 7970 7469 6f6e 2066  ual decryption f
│ │ │ │ -00041890: 6169 6c65 642e 0a0a 1f0a 4669 6c65 3a20  ailed.....File: 
│ │ │ │ -000418a0: 7368 6973 6869 2e69 6e66 6f2c 2020 4e6f  shishi.info,  No
│ │ │ │ -000418b0: 6465 3a20 5469 636b 6574 2046 756e 6374  de: Ticket Funct
│ │ │ │ -000418c0: 696f 6e73 2c20 204e 6578 743a 2041 5320  ions,  Next: AS 
│ │ │ │ -000418d0: 4675 6e63 7469 6f6e 732c 2020 5072 6576  Functions,  Prev
│ │ │ │ -000418e0: 3a20 5341 4645 2061 6e64 2050 5249 5620  : SAFE and PRIV 
│ │ │ │ -000418f0: 4675 6e63 7469 6f6e 732c 2020 5570 3a20  Functions,  Up: 
│ │ │ │ -00041900: 5072 6f67 7261 6d6d 696e 6720 4d61 6e75  Programming Manu
│ │ │ │ -00041910: 616c 0a0a 352e 3620 5469 636b 6574 2046  al..5.6 Ticket F
│ │ │ │ -00041920: 756e 6374 696f 6e73 0a3d 3d3d 3d3d 3d3d  unctions.=======
│ │ │ │ -00041930: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a41  =============..A
│ │ │ │ -00041940: 2054 6963 6b65 7420 6973 2061 6e20 4153   Ticket is an AS
│ │ │ │ -00041950: 4e2e 3120 7374 7275 6374 7572 6564 2074  N.1 structured t
│ │ │ │ -00041960: 6861 7420 6361 6e20 6265 2075 7365 6420  hat can be used 
│ │ │ │ -00041970: 746f 2061 7574 6865 6e74 6963 6174 6520  to authenticate 
│ │ │ │ -00041980: 7468 650a 686f 6c64 6572 2074 6f20 7365  the.holder to se
│ │ │ │ -00041990: 7276 6963 6573 2e20 2049 7420 636f 6e74  rvices.  It cont
│ │ │ │ -000419a0: 6169 6e20 616e 2065 6e63 7279 7074 6564  ain an encrypted
│ │ │ │ -000419b0: 2070 6172 742c 2077 6869 6368 2074 6865   part, which the
│ │ │ │ -000419c0: 2074 6963 6b65 740a 686f 6c64 6572 2063   ticket.holder c
│ │ │ │ -000419d0: 616e 6e6f 7420 7365 652c 2062 7574 2063  annot see, but c
│ │ │ │ -000419e0: 616e 2062 6520 656e 6372 7970 7465 6420  an be encrypted 
│ │ │ │ -000419f0: 6279 2074 6865 2073 6572 7669 6365 2c20  by the service, 
│ │ │ │ -00041a00: 616e 6420 7661 7269 6f75 730a 696e 666f  and various.info
│ │ │ │ -00041a10: 726d 6174 696f 6e20 6162 6f75 7420 7468  rmation about th
│ │ │ │ -00041a20: 6520 7573 6572 2061 6e64 2073 6572 7669  e user and servi
│ │ │ │ -00041a30: 6365 2c20 696e 636c 7564 696e 6720 616e  ce, including an
│ │ │ │ -00041a40: 2065 6e63 7279 7074 696f 6e20 6b65 7920   encryption key 
│ │ │ │ -00041a50: 746f 0a75 7365 2066 6f72 2074 6865 2063  to.use for the c
│ │ │ │ -00041a60: 6f6e 6e65 6374 696f 6e2e 2020 2a4e 6f74  onnection.  *Not
│ │ │ │ -00041a70: 6520 5469 636b 6574 2028 4153 4e2e 3129  e Ticket (ASN.1)
│ │ │ │ -00041a80: 2046 756e 6374 696f 6e73 3a3a 2c20 666f   Functions::, fo
│ │ │ │ -00041a90: 7220 6d6f 7265 0a64 6574 6169 6c73 206f  r more.details o
│ │ │ │ -00041aa0: 6e20 7468 6520 4153 4e2e 3120 7374 7275  n the ASN.1 stru
│ │ │ │ -00041ab0: 6374 7572 6520 6f66 2061 2074 6963 6b65  cture of a ticke
│ │ │ │ -00041ac0: 742e 0a0a 7368 6973 6869 5f74 6b74 0a2d  t...shishi_tkt.-
│ │ │ │ -00041ad0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ -00041ae0: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ -00041af0: 7368 695f 746b 7420 2853 6869 7368 6920  shi_tkt (Shishi 
│ │ │ │ -00041b00: 2a20 4841 4e44 4c45 2c20 5368 6973 6869  * HANDLE, Shishi
│ │ │ │ -00041b10: 5f74 6b74 202a 2a20 544b 5429 0a20 2020  _tkt ** TKT).   
│ │ │ │ -00041b20: 2020 4841 4e44 4c45 3a20 7368 6973 6869    HANDLE: shishi
│ │ │ │ -00041b30: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ -00041b40: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ -00041b50: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ -00041b60: 2020 544b 543a 206f 7574 7075 7420 7661    TKT: output va
│ │ │ │ -00041b70: 7269 6162 6c65 2077 6974 6820 6e65 776c  riable with newl
│ │ │ │ -00041b80: 7920 616c 6c6f 6361 7465 6420 7469 636b  y allocated tick
│ │ │ │ -00041b90: 6574 2e0a 0a20 2020 2020 2a44 6573 6372  et...     *Descr
│ │ │ │ -00041ba0: 6970 7469 6f6e 3a2a 2043 7265 6174 6520  iption:* Create 
│ │ │ │ -00041bb0: 6120 6e65 7720 7469 636b 6574 2068 616e  a new ticket han
│ │ │ │ -00041bc0: 646c 652e 0a0a 2020 2020 202a 5265 7475  dle...     *Retu
│ │ │ │ -00041bd0: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ -00041be0: 6e73 2053 4849 5348 495f 4f4b 2069 6666  ns SHISHI_OK iff
│ │ │ │ -00041bf0: 2073 7563 6365 7373 6675 6c2e 0a0a 7368   successful...sh
│ │ │ │ -00041c00: 6973 6869 5f74 6b74 320a 2d2d 2d2d 2d2d  ishi_tkt2.------
│ │ │ │ -00041c10: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ -00041c20: 696f 6e3a 2053 6869 7368 695f 746b 7420  ion: Shishi_tkt 
│ │ │ │ -00041c30: 2a20 7368 6973 6869 5f74 6b74 3220 2853  * shishi_tkt2 (S
│ │ │ │ -00041c40: 6869 7368 6920 2a20 4841 4e44 4c45 2c0a  hishi * HANDLE,.
│ │ │ │ -00041c50: 2020 2020 2020 2020 2020 5368 6973 6869            Shishi
│ │ │ │ -00041c60: 5f61 736e 3120 5449 434b 4554 2c20 5368  _asn1 TICKET, Sh
│ │ │ │ -00041c70: 6973 6869 5f61 736e 3120 454e 434b 4443  ishi_asn1 ENCKDC
│ │ │ │ -00041c80: 5245 5050 4152 542c 0a20 2020 2020 2020  REPPART,.       
│ │ │ │ -00041c90: 2020 2053 6869 7368 695f 6173 6e31 204b     Shishi_asn1 K
│ │ │ │ -00041ca0: 4443 5245 5029 0a20 2020 2020 4841 4e44  DCREP).     HAND
│ │ │ │ -00041cb0: 4c45 3a20 7368 6973 6869 2068 616e 646c  LE: shishi handl
│ │ │ │ -00041cc0: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ -00041cd0: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ -00041ce0: 2829 e280 992e 0a20 2020 2020 5449 434b  ().....     TICK
│ │ │ │ -00041cf0: 4554 3a20 696e 7075 7420 7661 7269 6162  ET: input variab
│ │ │ │ -00041d00: 6c65 2077 6974 6820 7469 636b 6574 2e0a  le with ticket..
│ │ │ │ -00041d10: 2020 2020 2045 4e43 4b44 4352 4550 5041       ENCKDCREPPA
│ │ │ │ -00041d20: 5254 3a20 696e 7075 7420 7661 7269 6162  RT: input variab
│ │ │ │ -00041d30: 6c65 2077 6974 6820 6175 7869 6c69 6172  le with auxiliar
│ │ │ │ -00041d40: 7920 7469 636b 6574 2069 6e66 6f72 6d61  y ticket informa
│ │ │ │ -00041d50: 7469 6f6e 2e0a 2020 2020 204b 4443 5245  tion..     KDCRE
│ │ │ │ -00041d60: 503a 2069 6e70 7574 2076 6172 6961 626c  P: input variabl
│ │ │ │ -00041d70: 6520 7769 7468 204b 4443 2d52 4550 2074  e with KDC-REP t
│ │ │ │ -00041d80: 6963 6b65 7420 696e 666f 726d 6174 696f  icket informatio
│ │ │ │ -00041d90: 6e2e 0a0a 2020 2020 202a 4465 7363 7269  n...     *Descri
│ │ │ │ -00041da0: 7074 696f 6e3a 2a20 4372 6561 7465 2061  ption:* Create a
│ │ │ │ -00041db0: 206e 6577 2074 6963 6b65 7420 6861 6e64   new ticket hand
│ │ │ │ -00041dc0: 6c65 2e0a 0a20 2020 2020 2a52 6574 7572  le...     *Retur
│ │ │ │ -00041dd0: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ -00041de0: 7320 6e65 7720 7469 636b 6574 2068 616e  s new ticket han
│ │ │ │ -00041df0: 646c 652c 206f 7220 e280 984e 554c 4ce2  dle, or ...NULL.
│ │ │ │ -00041e00: 8099 206f 6e20 6572 726f 722e 0a0a 7368  .. on error...sh
│ │ │ │ -00041e10: 6973 6869 5f74 6b74 5f64 6f6e 650a 2d2d  ishi_tkt_done.--
│ │ │ │ -00041e20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -00041e30: 2d2d 2046 756e 6374 696f 6e3a 2076 6f69  -- Function: voi
│ │ │ │ -00041e40: 6420 7368 6973 6869 5f74 6b74 5f64 6f6e  d shishi_tkt_don
│ │ │ │ -00041e50: 6520 2853 6869 7368 695f 746b 7420 2a20  e (Shishi_tkt * 
│ │ │ │ -00041e60: 544b 5429 0a20 2020 2020 544b 543a 2069  TKT).     TKT: i
│ │ │ │ -00041e70: 6e70 7574 2076 6172 6961 626c 6520 7769  nput variable wi
│ │ │ │ -00041e80: 7468 2074 6963 6b65 7420 696e 666f 2e0a  th ticket info..
│ │ │ │ -00041e90: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -00041ea0: 6f6e 3a2a 2044 6561 6c6c 6f63 6174 6520  on:* Deallocate 
│ │ │ │ -00041eb0: 7265 736f 7572 6365 7320 6173 736f 6369  resources associ
│ │ │ │ -00041ec0: 6174 6564 2077 6974 6820 7469 636b 6574  ated with ticket
│ │ │ │ -00041ed0: 2e20 2054 6865 0a20 2020 2020 7469 636b  .  The.     tick
│ │ │ │ -00041ee0: 6574 206d 7573 7420 6e6f 7420 6265 2075  et must not be u
│ │ │ │ -00041ef0: 7365 6420 6167 6169 6e20 6166 7465 7220  sed again after 
│ │ │ │ -00041f00: 7468 6973 2063 616c 6c2e 0a0a 7368 6973  this call...shis
│ │ │ │ -00041f10: 6869 5f74 6b74 5f74 6963 6b65 740a 2d2d  hi_tkt_ticket.--
│ │ │ │ -00041f20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -00041f30: 0a20 2d2d 2046 756e 6374 696f 6e3a 2053  . -- Function: S
│ │ │ │ -00041f40: 6869 7368 695f 6173 6e31 2073 6869 7368  hishi_asn1 shish
│ │ │ │ -00041f50: 695f 746b 745f 7469 636b 6574 2028 5368  i_tkt_ticket (Sh
│ │ │ │ -00041f60: 6973 6869 5f74 6b74 202a 2054 4b54 290a  ishi_tkt * TKT).
│ │ │ │ -00041f70: 2020 2020 2054 4b54 3a20 696e 7075 7420       TKT: input 
│ │ │ │ -00041f80: 7661 7269 6162 6c65 2077 6974 6820 7469  variable with ti
│ │ │ │ -00041f90: 636b 6574 2069 6e66 6f2e 0a0a 2020 2020  cket info...    
│ │ │ │ -00041fa0: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ -00041fb0: 4765 7420 4153 4e2e 3120 5469 636b 6574  Get ASN.1 Ticket
│ │ │ │ -00041fc0: 2073 7472 7563 7475 7265 2066 726f 6d20   structure from 
│ │ │ │ -00041fd0: 7469 636b 6574 2e0a 0a20 2020 2020 2a52  ticket...     *R
│ │ │ │ -00041fe0: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ -00041ff0: 7475 726e 7320 6163 7475 616c 2074 6963  turns actual tic
│ │ │ │ -00042000: 6b65 742e 0a0a 7368 6973 6869 5f74 6b74  ket...shishi_tkt
│ │ │ │ -00042010: 5f74 6963 6b65 745f 7365 740a 2d2d 2d2d  _ticket_set.----
│ │ │ │ +00041290: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +000412a0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +000412b0: 696e 7420 7368 6973 6869 5f65 6e63 7072  int shishi_encpr
│ │ │ │ +000412c0: 6976 7061 7274 5f73 6574 5f75 7365 725f  ivpart_set_user_
│ │ │ │ +000412d0: 6461 7461 2028 5368 6973 6869 202a 2048  data (Shishi * H
│ │ │ │ +000412e0: 414e 444c 452c 0a20 2020 2020 2020 2020  ANDLE,.         
│ │ │ │ +000412f0: 2053 6869 7368 695f 6173 6e31 2045 4e43   Shishi_asn1 ENC
│ │ │ │ +00041300: 5052 4956 5041 5254 2c20 636f 6e73 7420  PRIVPART, const 
│ │ │ │ +00041310: 6368 6172 202a 2055 5345 5244 4154 412c  char * USERDATA,
│ │ │ │ +00041320: 0a20 2020 2020 2020 2020 2073 697a 655f  .          size_
│ │ │ │ +00041330: 7420 5553 4552 4441 5441 4c45 4e29 0a20  t USERDATALEN). 
│ │ │ │ +00041340: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ +00041350: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ +00041360: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ +00041370: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ +00041380: 2020 2020 454e 4350 5249 5650 4152 543a      ENCPRIVPART:
│ │ │ │ +00041390: 2065 6e63 7072 6976 7061 7274 2061 7320   encprivpart as 
│ │ │ │ +000413a0: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ +000413b0: 7368 6973 6869 5f70 7269 7628 29e2 8099  shishi_priv()...
│ │ │ │ +000413c0: 2e0a 2020 2020 2055 5345 5244 4154 413a  ..     USERDATA:
│ │ │ │ +000413d0: 2069 6e70 7574 2075 7365 7220 6170 706c   input user appl
│ │ │ │ +000413e0: 6963 6174 696f 6e20 746f 2073 746f 7265  ication to store
│ │ │ │ +000413f0: 2069 6e20 5052 4956 2e0a 2020 2020 2055   in PRIV..     U
│ │ │ │ +00041400: 5345 5244 4154 414c 454e 3a20 7369 7a65  SERDATALEN: size
│ │ │ │ +00041410: 206f 6620 696e 7075 7420 7573 6572 2061   of input user a
│ │ │ │ +00041420: 7070 6c69 6361 7469 6f6e 2074 6f20 7374  pplication to st
│ │ │ │ +00041430: 6f72 6520 696e 2050 5249 562e 0a0a 2020  ore in PRIV...  
│ │ │ │ +00041440: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ +00041450: 2a20 5365 7420 7468 6520 6170 706c 6963  * Set the applic
│ │ │ │ +00041460: 6174 696f 6e20 6461 7461 2069 6e20 5052  ation data in PR
│ │ │ │ +00041470: 4956 2e0a 0a20 2020 2020 2a52 6574 7572  IV...     *Retur
│ │ │ │ +00041480: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ +00041490: 7320 5348 4953 4849 5f4f 4b20 6966 6620  s SHISHI_OK iff 
│ │ │ │ +000414a0: 7375 6363 6573 7366 756c 2e0a 0a73 6869  successful...shi
│ │ │ │ +000414b0: 7368 695f 7072 6976 5f62 7569 6c64 0a2d  shi_priv_build.-
│ │ │ │ +000414c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +000414d0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +000414e0: 696e 7420 7368 6973 6869 5f70 7269 765f  int shishi_priv_
│ │ │ │ +000414f0: 6275 696c 6420 2853 6869 7368 695f 7072  build (Shishi_pr
│ │ │ │ +00041500: 6976 202a 2050 5249 562c 0a20 2020 2020  iv * PRIV,.     
│ │ │ │ +00041510: 2020 2020 2053 6869 7368 695f 6b65 7920       Shishi_key 
│ │ │ │ +00041520: 2a20 4b45 5929 0a20 2020 2020 5052 4956  * KEY).     PRIV
│ │ │ │ +00041530: 3a20 7072 6976 2061 7320 616c 6c6f 6361  : priv as alloca
│ │ │ │ +00041540: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ +00041550: 5f70 7269 7628 29e2 8099 2e0a 2020 2020  _priv().....    
│ │ │ │ +00041560: 204b 4559 3a20 6b65 7920 666f 7220 7365   KEY: key for se
│ │ │ │ +00041570: 7373 696f 6e2c 2075 7365 6420 746f 2065  ssion, used to e
│ │ │ │ +00041580: 6e63 7279 7074 2064 6174 612e 0a0a 2020  ncrypt data...  
│ │ │ │ +00041590: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ +000415a0: 2a20 4275 696c 6420 6368 6563 6b73 756d  * Build checksum
│ │ │ │ +000415b0: 2061 6e64 2073 6574 2069 7420 696e 204b   and set it in K
│ │ │ │ +000415c0: 5242 2d50 5249 562e 204e 6f74 6520 7468  RB-PRIV. Note th
│ │ │ │ +000415d0: 6174 0a20 2020 2020 7468 6973 2066 6f6c  at.     this fol
│ │ │ │ +000415e0: 6c6f 7773 2052 4643 2031 3531 3062 6973  lows RFC 1510bis
│ │ │ │ +000415f0: 2061 6e64 2069 7320 696e 636f 6d70 6174   and is incompat
│ │ │ │ +00041600: 6962 6c65 2077 6974 6820 5246 4320 3135  ible with RFC 15
│ │ │ │ +00041610: 3130 2c0a 2020 2020 2061 6c74 686f 7567  10,.     althoug
│ │ │ │ +00041620: 6820 7072 6573 756d 6162 6c79 2066 6577  h presumably few
│ │ │ │ +00041630: 2069 6d70 6c65 6d65 6e74 6174 696f 6e73   implementations
│ │ │ │ +00041640: 2075 7365 2074 6865 2052 4643 3135 3130   use the RFC1510
│ │ │ │ +00041650: 2061 6c67 6f72 6974 686d 2e0a 0a20 2020   algorithm...   
│ │ │ │ +00041660: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ +00041670: 2a20 5265 7475 726e 7320 5348 4953 4849  * Returns SHISHI
│ │ │ │ +00041680: 5f4f 4b20 6966 6620 7375 6363 6573 7366  _OK iff successf
│ │ │ │ +00041690: 756c 2e0a 0a73 6869 7368 695f 7072 6976  ul...shishi_priv
│ │ │ │ +000416a0: 5f70 726f 6365 7373 0a2d 2d2d 2d2d 2d2d  _process.-------
│ │ │ │ +000416b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ +000416c0: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ +000416d0: 7368 6973 6869 5f70 7269 765f 7072 6f63  shishi_priv_proc
│ │ │ │ +000416e0: 6573 7320 2853 6869 7368 695f 7072 6976  ess (Shishi_priv
│ │ │ │ +000416f0: 202a 2050 5249 562c 0a20 2020 2020 2020   * PRIV,.       
│ │ │ │ +00041700: 2020 2053 6869 7368 695f 6b65 7920 2a20     Shishi_key * 
│ │ │ │ +00041710: 4b45 5929 0a20 2020 2020 5052 4956 3a20  KEY).     PRIV: 
│ │ │ │ +00041720: 7072 6976 2061 7320 616c 6c6f 6361 7465  priv as allocate
│ │ │ │ +00041730: 6420 6279 20e2 8098 7368 6973 6869 5f70  d by ...shishi_p
│ │ │ │ +00041740: 7269 7628 29e2 8099 2e0a 2020 2020 204b  riv().....     K
│ │ │ │ +00041750: 4559 3a20 6b65 7920 746f 2075 7365 2074  EY: key to use t
│ │ │ │ +00041760: 6f20 6465 6372 7970 7420 456e 6350 7269  o decrypt EncPri
│ │ │ │ +00041770: 7650 6172 742e 0a0a 2020 2020 202a 4465  vPart...     *De
│ │ │ │ +00041780: 7363 7269 7074 696f 6e3a 2a20 4465 6372  scription:* Decr
│ │ │ │ +00041790: 7970 7420 656e 6372 7970 7465 6420 6461  ypt encrypted da
│ │ │ │ +000417a0: 7461 2069 6e20 4b52 422d 5052 4956 2061  ta in KRB-PRIV a
│ │ │ │ +000417b0: 6e64 2073 6574 2074 6865 0a20 2020 2020  nd set the.     
│ │ │ │ +000417c0: 456e 6350 7269 7650 6172 7420 696e 2074  EncPrivPart in t
│ │ │ │ +000417d0: 6865 2050 5249 5620 6578 6368 616e 6765  he PRIV exchange
│ │ │ │ +000417e0: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ +000417f0: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ +00041800: 5348 4953 4849 5f4f 4b20 6966 6620 7375  SHISHI_OK iff su
│ │ │ │ +00041810: 6363 6573 7366 756c 2c0a 2020 2020 2053  ccessful,.     S
│ │ │ │ +00041820: 4849 5348 495f 5052 4956 5f42 4144 5f4b  HISHI_PRIV_BAD_K
│ │ │ │ +00041830: 4559 5459 5045 2069 6620 616e 2069 6e63  EYTYPE if an inc
│ │ │ │ +00041840: 6f6d 7061 7469 626c 6520 6b65 7920 7479  ompatible key ty
│ │ │ │ +00041850: 7065 2069 7320 7573 6564 2c20 6f72 0a20  pe is used, or. 
│ │ │ │ +00041860: 2020 2020 5348 4953 4849 5f43 5259 5054      SHISHI_CRYPT
│ │ │ │ +00041870: 4f5f 4552 524f 5220 6966 2074 6865 2061  O_ERROR if the a
│ │ │ │ +00041880: 6374 7561 6c20 6465 6372 7970 7469 6f6e  ctual decryption
│ │ │ │ +00041890: 2066 6169 6c65 642e 0a0a 1f0a 4669 6c65   failed.....File
│ │ │ │ +000418a0: 3a20 7368 6973 6869 2e69 6e66 6f2c 2020  : shishi.info,  
│ │ │ │ +000418b0: 4e6f 6465 3a20 5469 636b 6574 2046 756e  Node: Ticket Fun
│ │ │ │ +000418c0: 6374 696f 6e73 2c20 204e 6578 743a 2041  ctions,  Next: A
│ │ │ │ +000418d0: 5320 4675 6e63 7469 6f6e 732c 2020 5072  S Functions,  Pr
│ │ │ │ +000418e0: 6576 3a20 5341 4645 2061 6e64 2050 5249  ev: SAFE and PRI
│ │ │ │ +000418f0: 5620 4675 6e63 7469 6f6e 732c 2020 5570  V Functions,  Up
│ │ │ │ +00041900: 3a20 5072 6f67 7261 6d6d 696e 6720 4d61  : Programming Ma
│ │ │ │ +00041910: 6e75 616c 0a0a 352e 3620 5469 636b 6574  nual..5.6 Ticket
│ │ │ │ +00041920: 2046 756e 6374 696f 6e73 0a3d 3d3d 3d3d   Functions.=====
│ │ │ │ +00041930: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a  ===============.
│ │ │ │ +00041940: 0a41 2054 6963 6b65 7420 6973 2061 6e20  .A Ticket is an 
│ │ │ │ +00041950: 4153 4e2e 3120 7374 7275 6374 7572 6564  ASN.1 structured
│ │ │ │ +00041960: 2074 6861 7420 6361 6e20 6265 2075 7365   that can be use
│ │ │ │ +00041970: 6420 746f 2061 7574 6865 6e74 6963 6174  d to authenticat
│ │ │ │ +00041980: 6520 7468 650a 686f 6c64 6572 2074 6f20  e the.holder to 
│ │ │ │ +00041990: 7365 7276 6963 6573 2e20 2049 7420 636f  services.  It co
│ │ │ │ +000419a0: 6e74 6169 6e20 616e 2065 6e63 7279 7074  ntain an encrypt
│ │ │ │ +000419b0: 6564 2070 6172 742c 2077 6869 6368 2074  ed part, which t
│ │ │ │ +000419c0: 6865 2074 6963 6b65 740a 686f 6c64 6572  he ticket.holder
│ │ │ │ +000419d0: 2063 616e 6e6f 7420 7365 652c 2062 7574   cannot see, but
│ │ │ │ +000419e0: 2063 616e 2062 6520 656e 6372 7970 7465   can be encrypte
│ │ │ │ +000419f0: 6420 6279 2074 6865 2073 6572 7669 6365  d by the service
│ │ │ │ +00041a00: 2c20 616e 6420 7661 7269 6f75 730a 696e  , and various.in
│ │ │ │ +00041a10: 666f 726d 6174 696f 6e20 6162 6f75 7420  formation about 
│ │ │ │ +00041a20: 7468 6520 7573 6572 2061 6e64 2073 6572  the user and ser
│ │ │ │ +00041a30: 7669 6365 2c20 696e 636c 7564 696e 6720  vice, including 
│ │ │ │ +00041a40: 616e 2065 6e63 7279 7074 696f 6e20 6b65  an encryption ke
│ │ │ │ +00041a50: 7920 746f 0a75 7365 2066 6f72 2074 6865  y to.use for the
│ │ │ │ +00041a60: 2063 6f6e 6e65 6374 696f 6e2e 2020 2a4e   connection.  *N
│ │ │ │ +00041a70: 6f74 6520 5469 636b 6574 2028 4153 4e2e  ote Ticket (ASN.
│ │ │ │ +00041a80: 3129 2046 756e 6374 696f 6e73 3a3a 2c20  1) Functions::, 
│ │ │ │ +00041a90: 666f 7220 6d6f 7265 0a64 6574 6169 6c73  for more.details
│ │ │ │ +00041aa0: 206f 6e20 7468 6520 4153 4e2e 3120 7374   on the ASN.1 st
│ │ │ │ +00041ab0: 7275 6374 7572 6520 6f66 2061 2074 6963  ructure of a tic
│ │ │ │ +00041ac0: 6b65 742e 0a0a 7368 6973 6869 5f74 6b74  ket...shishi_tkt
│ │ │ │ +00041ad0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  .----------.. --
│ │ │ │ +00041ae0: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ +00041af0: 6869 7368 695f 746b 7420 2853 6869 7368  hishi_tkt (Shish
│ │ │ │ +00041b00: 6920 2a20 4841 4e44 4c45 2c20 5368 6973  i * HANDLE, Shis
│ │ │ │ +00041b10: 6869 5f74 6b74 202a 2a20 544b 5429 0a20  hi_tkt ** TKT). 
│ │ │ │ +00041b20: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ +00041b30: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ +00041b40: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ +00041b50: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ +00041b60: 2020 2020 544b 543a 206f 7574 7075 7420      TKT: output 
│ │ │ │ +00041b70: 7661 7269 6162 6c65 2077 6974 6820 6e65  variable with ne
│ │ │ │ +00041b80: 776c 7920 616c 6c6f 6361 7465 6420 7469  wly allocated ti
│ │ │ │ +00041b90: 636b 6574 2e0a 0a20 2020 2020 2a44 6573  cket...     *Des
│ │ │ │ +00041ba0: 6372 6970 7469 6f6e 3a2a 2043 7265 6174  cription:* Creat
│ │ │ │ +00041bb0: 6520 6120 6e65 7720 7469 636b 6574 2068  e a new ticket h
│ │ │ │ +00041bc0: 616e 646c 652e 0a0a 2020 2020 202a 5265  andle...     *Re
│ │ │ │ +00041bd0: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ +00041be0: 7572 6e73 2053 4849 5348 495f 4f4b 2069  urns SHISHI_OK i
│ │ │ │ +00041bf0: 6666 2073 7563 6365 7373 6675 6c2e 0a0a  ff successful...
│ │ │ │ +00041c00: 7368 6973 6869 5f74 6b74 320a 2d2d 2d2d  shishi_tkt2.----
│ │ │ │ +00041c10: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +00041c20: 6374 696f 6e3a 2053 6869 7368 695f 746b  ction: Shishi_tk
│ │ │ │ +00041c30: 7420 2a20 7368 6973 6869 5f74 6b74 3220  t * shishi_tkt2 
│ │ │ │ +00041c40: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ +00041c50: 2c0a 2020 2020 2020 2020 2020 5368 6973  ,.          Shis
│ │ │ │ +00041c60: 6869 5f61 736e 3120 5449 434b 4554 2c20  hi_asn1 TICKET, 
│ │ │ │ +00041c70: 5368 6973 6869 5f61 736e 3120 454e 434b  Shishi_asn1 ENCK
│ │ │ │ +00041c80: 4443 5245 5050 4152 542c 0a20 2020 2020  DCREPPART,.     
│ │ │ │ +00041c90: 2020 2020 2053 6869 7368 695f 6173 6e31       Shishi_asn1
│ │ │ │ +00041ca0: 204b 4443 5245 5029 0a20 2020 2020 4841   KDCREP).     HA
│ │ │ │ +00041cb0: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ +00041cc0: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ +00041cd0: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ +00041ce0: 6974 2829 e280 992e 0a20 2020 2020 5449  it().....     TI
│ │ │ │ +00041cf0: 434b 4554 3a20 696e 7075 7420 7661 7269  CKET: input vari
│ │ │ │ +00041d00: 6162 6c65 2077 6974 6820 7469 636b 6574  able with ticket
│ │ │ │ +00041d10: 2e0a 2020 2020 2045 4e43 4b44 4352 4550  ..     ENCKDCREP
│ │ │ │ +00041d20: 5041 5254 3a20 696e 7075 7420 7661 7269  PART: input vari
│ │ │ │ +00041d30: 6162 6c65 2077 6974 6820 6175 7869 6c69  able with auxili
│ │ │ │ +00041d40: 6172 7920 7469 636b 6574 2069 6e66 6f72  ary ticket infor
│ │ │ │ +00041d50: 6d61 7469 6f6e 2e0a 2020 2020 204b 4443  mation..     KDC
│ │ │ │ +00041d60: 5245 503a 2069 6e70 7574 2076 6172 6961  REP: input varia
│ │ │ │ +00041d70: 626c 6520 7769 7468 204b 4443 2d52 4550  ble with KDC-REP
│ │ │ │ +00041d80: 2074 6963 6b65 7420 696e 666f 726d 6174   ticket informat
│ │ │ │ +00041d90: 696f 6e2e 0a0a 2020 2020 202a 4465 7363  ion...     *Desc
│ │ │ │ +00041da0: 7269 7074 696f 6e3a 2a20 4372 6561 7465  ription:* Create
│ │ │ │ +00041db0: 2061 206e 6577 2074 6963 6b65 7420 6861   a new ticket ha
│ │ │ │ +00041dc0: 6e64 6c65 2e0a 0a20 2020 2020 2a52 6574  ndle...     *Ret
│ │ │ │ +00041dd0: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ +00041de0: 726e 7320 6e65 7720 7469 636b 6574 2068  rns new ticket h
│ │ │ │ +00041df0: 616e 646c 652c 206f 7220 e280 984e 554c  andle, or ...NUL
│ │ │ │ +00041e00: 4ce2 8099 206f 6e20 6572 726f 722e 0a0a  L... on error...
│ │ │ │ +00041e10: 7368 6973 6869 5f74 6b74 5f64 6f6e 650a  shishi_tkt_done.
│ │ │ │ +00041e20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +00041e30: 0a20 2d2d 2046 756e 6374 696f 6e3a 2076  . -- Function: v
│ │ │ │ +00041e40: 6f69 6420 7368 6973 6869 5f74 6b74 5f64  oid shishi_tkt_d
│ │ │ │ +00041e50: 6f6e 6520 2853 6869 7368 695f 746b 7420  one (Shishi_tkt 
│ │ │ │ +00041e60: 2a20 544b 5429 0a20 2020 2020 544b 543a  * TKT).     TKT:
│ │ │ │ +00041e70: 2069 6e70 7574 2076 6172 6961 626c 6520   input variable 
│ │ │ │ +00041e80: 7769 7468 2074 6963 6b65 7420 696e 666f  with ticket info
│ │ │ │ +00041e90: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ +00041ea0: 7469 6f6e 3a2a 2044 6561 6c6c 6f63 6174  tion:* Deallocat
│ │ │ │ +00041eb0: 6520 7265 736f 7572 6365 7320 6173 736f  e resources asso
│ │ │ │ +00041ec0: 6369 6174 6564 2077 6974 6820 7469 636b  ciated with tick
│ │ │ │ +00041ed0: 6574 2e20 2054 6865 0a20 2020 2020 7469  et.  The.     ti
│ │ │ │ +00041ee0: 636b 6574 206d 7573 7420 6e6f 7420 6265  cket must not be
│ │ │ │ +00041ef0: 2075 7365 6420 6167 6169 6e20 6166 7465   used again afte
│ │ │ │ +00041f00: 7220 7468 6973 2063 616c 6c2e 0a0a 7368  r this call...sh
│ │ │ │ +00041f10: 6973 6869 5f74 6b74 5f74 6963 6b65 740a  ishi_tkt_ticket.
│ │ │ │ +00041f20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +00041f30: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ +00041f40: 2053 6869 7368 695f 6173 6e31 2073 6869   Shishi_asn1 shi
│ │ │ │ +00041f50: 7368 695f 746b 745f 7469 636b 6574 2028  shi_tkt_ticket (
│ │ │ │ +00041f60: 5368 6973 6869 5f74 6b74 202a 2054 4b54  Shishi_tkt * TKT
│ │ │ │ +00041f70: 290a 2020 2020 2054 4b54 3a20 696e 7075  ).     TKT: inpu
│ │ │ │ +00041f80: 7420 7661 7269 6162 6c65 2077 6974 6820  t variable with 
│ │ │ │ +00041f90: 7469 636b 6574 2069 6e66 6f2e 0a0a 2020  ticket info...  
│ │ │ │ +00041fa0: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ +00041fb0: 2a20 4765 7420 4153 4e2e 3120 5469 636b  * Get ASN.1 Tick
│ │ │ │ +00041fc0: 6574 2073 7472 7563 7475 7265 2066 726f  et structure fro
│ │ │ │ +00041fd0: 6d20 7469 636b 6574 2e0a 0a20 2020 2020  m ticket...     
│ │ │ │ +00041fe0: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ +00041ff0: 5265 7475 726e 7320 6163 7475 616c 2074  Returns actual t
│ │ │ │ +00042000: 6963 6b65 742e 0a0a 7368 6973 6869 5f74  icket...shishi_t
│ │ │ │ +00042010: 6b74 5f74 6963 6b65 745f 7365 740a 2d2d  kt_ticket_set.--
│ │ │ │  00042020: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00042030: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ -00042040: 2076 6f69 6420 7368 6973 6869 5f74 6b74   void shishi_tkt
│ │ │ │ -00042050: 5f74 6963 6b65 745f 7365 7420 2853 6869  _ticket_set (Shi
│ │ │ │ -00042060: 7368 695f 746b 7420 2a20 544b 542c 0a20  shi_tkt * TKT,. 
│ │ │ │ -00042070: 2020 2020 2020 2020 2053 6869 7368 695f           Shishi_
│ │ │ │ -00042080: 6173 6e31 2054 4943 4b45 5429 0a20 2020  asn1 TICKET).   
│ │ │ │ -00042090: 2020 544b 543a 2069 6e70 7574 2076 6172    TKT: input var
│ │ │ │ -000420a0: 6961 626c 6520 7769 7468 2074 6963 6b65  iable with ticke
│ │ │ │ -000420b0: 7420 696e 666f 2e0a 2020 2020 2054 4943  t info..     TIC
│ │ │ │ -000420c0: 4b45 543a 2041 534e 2e31 2054 6963 6b65  KET: ASN.1 Ticke
│ │ │ │ -000420d0: 7420 746f 2073 746f 7265 2069 6e20 7469  t to store in ti
│ │ │ │ -000420e0: 636b 6574 2e0a 0a20 2020 2020 2a44 6573  cket...     *Des
│ │ │ │ -000420f0: 6372 6970 7469 6f6e 3a2a 2053 6574 2074  cription:* Set t
│ │ │ │ -00042100: 6865 2041 534e 2e31 2054 6963 6b65 7420  he ASN.1 Ticket 
│ │ │ │ -00042110: 696e 2074 6865 2054 6963 6b65 742e 0a0a  in the Ticket...
│ │ │ │ -00042120: 7368 6973 6869 5f74 6b74 5f65 6e63 6b64  shishi_tkt_enckd
│ │ │ │ -00042130: 6372 6570 7061 7274 0a2d 2d2d 2d2d 2d2d  creppart.-------
│ │ │ │ +00042030: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ +00042040: 6e3a 2076 6f69 6420 7368 6973 6869 5f74  n: void shishi_t
│ │ │ │ +00042050: 6b74 5f74 6963 6b65 745f 7365 7420 2853  kt_ticket_set (S
│ │ │ │ +00042060: 6869 7368 695f 746b 7420 2a20 544b 542c  hishi_tkt * TKT,
│ │ │ │ +00042070: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ +00042080: 695f 6173 6e31 2054 4943 4b45 5429 0a20  i_asn1 TICKET). 
│ │ │ │ +00042090: 2020 2020 544b 543a 2069 6e70 7574 2076      TKT: input v
│ │ │ │ +000420a0: 6172 6961 626c 6520 7769 7468 2074 6963  ariable with tic
│ │ │ │ +000420b0: 6b65 7420 696e 666f 2e0a 2020 2020 2054  ket info..     T
│ │ │ │ +000420c0: 4943 4b45 543a 2041 534e 2e31 2054 6963  ICKET: ASN.1 Tic
│ │ │ │ +000420d0: 6b65 7420 746f 2073 746f 7265 2069 6e20  ket to store in 
│ │ │ │ +000420e0: 7469 636b 6574 2e0a 0a20 2020 2020 2a44  ticket...     *D
│ │ │ │ +000420f0: 6573 6372 6970 7469 6f6e 3a2a 2053 6574  escription:* Set
│ │ │ │ +00042100: 2074 6865 2041 534e 2e31 2054 6963 6b65   the ASN.1 Ticke
│ │ │ │ +00042110: 7420 696e 2074 6865 2054 6963 6b65 742e  t in the Ticket.
│ │ │ │ +00042120: 0a0a 7368 6973 6869 5f74 6b74 5f65 6e63  ..shishi_tkt_enc
│ │ │ │ +00042130: 6b64 6372 6570 7061 7274 0a2d 2d2d 2d2d  kdcreppart.-----
│ │ │ │  00042140: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00042150: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ -00042160: 2053 6869 7368 695f 6173 6e31 2073 6869   Shishi_asn1 shi
│ │ │ │ -00042170: 7368 695f 746b 745f 656e 636b 6463 7265  shi_tkt_enckdcre
│ │ │ │ -00042180: 7070 6172 7420 2853 6869 7368 695f 746b  ppart (Shishi_tk
│ │ │ │ -00042190: 7420 2a20 544b 5429 0a20 2020 2020 544b  t * TKT).     TK
│ │ │ │ -000421a0: 543a 2069 6e70 7574 2076 6172 6961 626c  T: input variabl
│ │ │ │ -000421b0: 6520 7769 7468 2074 6963 6b65 7420 696e  e with ticket in
│ │ │ │ -000421c0: 666f 2e0a 0a20 2020 2020 2a44 6573 6372  fo...     *Descr
│ │ │ │ -000421d0: 6970 7469 6f6e 3a2a 2047 6574 2041 534e  iption:* Get ASN
│ │ │ │ -000421e0: 2e31 2045 6e63 4b44 4352 6570 5061 7274  .1 EncKDCRepPart
│ │ │ │ -000421f0: 2073 7472 7563 7475 7265 2066 726f 6d20   structure from 
│ │ │ │ -00042200: 7469 636b 6574 2e0a 0a20 2020 2020 2a52  ticket...     *R
│ │ │ │ -00042210: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ -00042220: 7475 726e 7320 6175 7869 6c69 6172 7920  turns auxiliary 
│ │ │ │ -00042230: 7469 636b 6574 2069 6e66 6f72 6d61 7469  ticket informati
│ │ │ │ -00042240: 6f6e 2e0a 0a73 6869 7368 695f 746b 745f  on...shishi_tkt_
│ │ │ │ -00042250: 656e 636b 6463 7265 7070 6172 745f 7365  enckdcreppart_se
│ │ │ │ -00042260: 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  t.--------------
│ │ │ │ -00042270: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -00042280: 202d 2d20 4675 6e63 7469 6f6e 3a20 766f   -- Function: vo
│ │ │ │ -00042290: 6964 2073 6869 7368 695f 746b 745f 656e  id shishi_tkt_en
│ │ │ │ -000422a0: 636b 6463 7265 7070 6172 745f 7365 7420  ckdcreppart_set 
│ │ │ │ -000422b0: 2853 6869 7368 695f 746b 7420 2a20 544b  (Shishi_tkt * TK
│ │ │ │ -000422c0: 542c 0a20 2020 2020 2020 2020 2053 6869  T,.          Shi
│ │ │ │ -000422d0: 7368 695f 6173 6e31 2045 4e43 4b44 4352  shi_asn1 ENCKDCR
│ │ │ │ -000422e0: 4550 5041 5254 290a 2020 2020 2054 4b54  EPPART).     TKT
│ │ │ │ -000422f0: 3a20 7374 7275 6374 7572 6520 7468 6174  : structure that
│ │ │ │ -00042300: 2068 6f6c 6473 2069 6e66 6f72 6d61 7469   holds informati
│ │ │ │ -00042310: 6f6e 2061 626f 7574 2054 6963 6b65 7420  on about Ticket 
│ │ │ │ -00042320: 6578 6368 616e 6765 0a20 2020 2020 454e  exchange.     EN
│ │ │ │ -00042330: 434b 4443 5245 5050 4152 543a 2045 6e63  CKDCREPPART: Enc
│ │ │ │ -00042340: 4b44 4352 6570 5061 7274 2074 6f20 7374  KDCRepPart to st
│ │ │ │ -00042350: 6f72 6520 696e 2054 6963 6b65 742e 0a0a  ore in Ticket...
│ │ │ │ -00042360: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ -00042370: 6e3a 2a20 5365 7420 7468 6520 456e 634b  n:* Set the EncK
│ │ │ │ -00042380: 4443 5265 7050 6172 7420 696e 2074 6865  DCRepPart in the
│ │ │ │ -00042390: 2054 6963 6b65 742e 0a0a 7368 6973 6869   Ticket...shishi
│ │ │ │ -000423a0: 5f74 6b74 5f6b 6463 7265 700a 2d2d 2d2d  _tkt_kdcrep.----
│ │ │ │ -000423b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -000423c0: 2d2d 2046 756e 6374 696f 6e3a 2053 6869  -- Function: Shi
│ │ │ │ -000423d0: 7368 695f 6173 6e31 2073 6869 7368 695f  shi_asn1 shishi_
│ │ │ │ -000423e0: 746b 745f 6b64 6372 6570 2028 5368 6973  tkt_kdcrep (Shis
│ │ │ │ -000423f0: 6869 5f74 6b74 202a 2054 4b54 290a 2020  hi_tkt * TKT).  
│ │ │ │ -00042400: 2020 2054 4b54 3a20 696e 7075 7420 7661     TKT: input va
│ │ │ │ -00042410: 7269 6162 6c65 2077 6974 6820 7469 636b  riable with tick
│ │ │ │ -00042420: 6574 2069 6e66 6f2e 0a0a 2020 2020 202a  et info...     *
│ │ │ │ -00042430: 4465 7363 7269 7074 696f 6e3a 2a20 4765  Description:* Ge
│ │ │ │ -00042440: 7420 4153 4e2e 3120 4b44 4352 6570 2073  t ASN.1 KDCRep s
│ │ │ │ -00042450: 7472 7563 7475 7265 2066 726f 6d20 7469  tructure from ti
│ │ │ │ -00042460: 636b 6574 2e0a 0a20 2020 2020 2a52 6574  cket...     *Ret
│ │ │ │ -00042470: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ -00042480: 726e 7320 4b44 432d 5245 5020 696e 666f  rns KDC-REP info
│ │ │ │ -00042490: 726d 6174 696f 6e2e 0a0a 7368 6973 6869  rmation...shishi
│ │ │ │ -000424a0: 5f74 6b74 5f65 6e63 7469 636b 6574 7061  _tkt_encticketpa
│ │ │ │ -000424b0: 7274 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  rt.-------------
│ │ │ │ -000424c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ -000424d0: 2046 756e 6374 696f 6e3a 2053 6869 7368   Function: Shish
│ │ │ │ -000424e0: 695f 6173 6e31 2073 6869 7368 695f 746b  i_asn1 shishi_tk
│ │ │ │ -000424f0: 745f 656e 6374 6963 6b65 7470 6172 7420  t_encticketpart 
│ │ │ │ -00042500: 2853 6869 7368 695f 746b 7420 2a20 544b  (Shishi_tkt * TK
│ │ │ │ -00042510: 5429 0a20 2020 2020 544b 543a 2069 6e70  T).     TKT: inp
│ │ │ │ -00042520: 7574 2076 6172 6961 626c 6520 7769 7468  ut variable with
│ │ │ │ -00042530: 2074 6963 6b65 7420 696e 666f 2e0a 0a20   ticket info... 
│ │ │ │ -00042540: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -00042550: 3a2a 2047 6574 2041 534e 2e31 2045 6e63  :* Get ASN.1 Enc
│ │ │ │ -00042560: 5469 636b 6574 5061 7274 2073 7472 7563  TicketPart struc
│ │ │ │ -00042570: 7475 7265 2066 726f 6d20 7469 636b 6574  ture from ticket
│ │ │ │ -00042580: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ -00042590: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ -000425a0: 456e 6354 6963 6b65 7450 6172 7420 696e  EncTicketPart in
│ │ │ │ -000425b0: 666f 726d 6174 696f 6e2e 0a0a 7368 6973  formation...shis
│ │ │ │ -000425c0: 6869 5f74 6b74 5f65 6e63 7469 636b 6574  hi_tkt_encticket
│ │ │ │ -000425d0: 7061 7274 5f73 6574 0a2d 2d2d 2d2d 2d2d  part_set.-------
│ │ │ │ +00042150: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ +00042160: 6e3a 2053 6869 7368 695f 6173 6e31 2073  n: Shishi_asn1 s
│ │ │ │ +00042170: 6869 7368 695f 746b 745f 656e 636b 6463  hishi_tkt_enckdc
│ │ │ │ +00042180: 7265 7070 6172 7420 2853 6869 7368 695f  reppart (Shishi_
│ │ │ │ +00042190: 746b 7420 2a20 544b 5429 0a20 2020 2020  tkt * TKT).     
│ │ │ │ +000421a0: 544b 543a 2069 6e70 7574 2076 6172 6961  TKT: input varia
│ │ │ │ +000421b0: 626c 6520 7769 7468 2074 6963 6b65 7420  ble with ticket 
│ │ │ │ +000421c0: 696e 666f 2e0a 0a20 2020 2020 2a44 6573  info...     *Des
│ │ │ │ +000421d0: 6372 6970 7469 6f6e 3a2a 2047 6574 2041  cription:* Get A
│ │ │ │ +000421e0: 534e 2e31 2045 6e63 4b44 4352 6570 5061  SN.1 EncKDCRepPa
│ │ │ │ +000421f0: 7274 2073 7472 7563 7475 7265 2066 726f  rt structure fro
│ │ │ │ +00042200: 6d20 7469 636b 6574 2e0a 0a20 2020 2020  m ticket...     
│ │ │ │ +00042210: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ +00042220: 5265 7475 726e 7320 6175 7869 6c69 6172  Returns auxiliar
│ │ │ │ +00042230: 7920 7469 636b 6574 2069 6e66 6f72 6d61  y ticket informa
│ │ │ │ +00042240: 7469 6f6e 2e0a 0a73 6869 7368 695f 746b  tion...shishi_tk
│ │ │ │ +00042250: 745f 656e 636b 6463 7265 7070 6172 745f  t_enckdcreppart_
│ │ │ │ +00042260: 7365 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  set.------------
│ │ │ │ +00042270: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +00042280: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +00042290: 766f 6964 2073 6869 7368 695f 746b 745f  void shishi_tkt_
│ │ │ │ +000422a0: 656e 636b 6463 7265 7070 6172 745f 7365  enckdcreppart_se
│ │ │ │ +000422b0: 7420 2853 6869 7368 695f 746b 7420 2a20  t (Shishi_tkt * 
│ │ │ │ +000422c0: 544b 542c 0a20 2020 2020 2020 2020 2053  TKT,.          S
│ │ │ │ +000422d0: 6869 7368 695f 6173 6e31 2045 4e43 4b44  hishi_asn1 ENCKD
│ │ │ │ +000422e0: 4352 4550 5041 5254 290a 2020 2020 2054  CREPPART).     T
│ │ │ │ +000422f0: 4b54 3a20 7374 7275 6374 7572 6520 7468  KT: structure th
│ │ │ │ +00042300: 6174 2068 6f6c 6473 2069 6e66 6f72 6d61  at holds informa
│ │ │ │ +00042310: 7469 6f6e 2061 626f 7574 2054 6963 6b65  tion about Ticke
│ │ │ │ +00042320: 7420 6578 6368 616e 6765 0a20 2020 2020  t exchange.     
│ │ │ │ +00042330: 454e 434b 4443 5245 5050 4152 543a 2045  ENCKDCREPPART: E
│ │ │ │ +00042340: 6e63 4b44 4352 6570 5061 7274 2074 6f20  ncKDCRepPart to 
│ │ │ │ +00042350: 7374 6f72 6520 696e 2054 6963 6b65 742e  store in Ticket.
│ │ │ │ +00042360: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ +00042370: 696f 6e3a 2a20 5365 7420 7468 6520 456e  ion:* Set the En
│ │ │ │ +00042380: 634b 4443 5265 7050 6172 7420 696e 2074  cKDCRepPart in t
│ │ │ │ +00042390: 6865 2054 6963 6b65 742e 0a0a 7368 6973  he Ticket...shis
│ │ │ │ +000423a0: 6869 5f74 6b74 5f6b 6463 7265 700a 2d2d  hi_tkt_kdcrep.--
│ │ │ │ +000423b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +000423c0: 0a20 2d2d 2046 756e 6374 696f 6e3a 2053  . -- Function: S
│ │ │ │ +000423d0: 6869 7368 695f 6173 6e31 2073 6869 7368  hishi_asn1 shish
│ │ │ │ +000423e0: 695f 746b 745f 6b64 6372 6570 2028 5368  i_tkt_kdcrep (Sh
│ │ │ │ +000423f0: 6973 6869 5f74 6b74 202a 2054 4b54 290a  ishi_tkt * TKT).
│ │ │ │ +00042400: 2020 2020 2054 4b54 3a20 696e 7075 7420       TKT: input 
│ │ │ │ +00042410: 7661 7269 6162 6c65 2077 6974 6820 7469  variable with ti
│ │ │ │ +00042420: 636b 6574 2069 6e66 6f2e 0a0a 2020 2020  cket info...    
│ │ │ │ +00042430: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ +00042440: 4765 7420 4153 4e2e 3120 4b44 4352 6570  Get ASN.1 KDCRep
│ │ │ │ +00042450: 2073 7472 7563 7475 7265 2066 726f 6d20   structure from 
│ │ │ │ +00042460: 7469 636b 6574 2e0a 0a20 2020 2020 2a52  ticket...     *R
│ │ │ │ +00042470: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +00042480: 7475 726e 7320 4b44 432d 5245 5020 696e  turns KDC-REP in
│ │ │ │ +00042490: 666f 726d 6174 696f 6e2e 0a0a 7368 6973  formation...shis
│ │ │ │ +000424a0: 6869 5f74 6b74 5f65 6e63 7469 636b 6574  hi_tkt_encticket
│ │ │ │ +000424b0: 7061 7274 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  part.-----------
│ │ │ │ +000424c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ +000424d0: 2d2d 2046 756e 6374 696f 6e3a 2053 6869  -- Function: Shi
│ │ │ │ +000424e0: 7368 695f 6173 6e31 2073 6869 7368 695f  shi_asn1 shishi_
│ │ │ │ +000424f0: 746b 745f 656e 6374 6963 6b65 7470 6172  tkt_encticketpar
│ │ │ │ +00042500: 7420 2853 6869 7368 695f 746b 7420 2a20  t (Shishi_tkt * 
│ │ │ │ +00042510: 544b 5429 0a20 2020 2020 544b 543a 2069  TKT).     TKT: i
│ │ │ │ +00042520: 6e70 7574 2076 6172 6961 626c 6520 7769  nput variable wi
│ │ │ │ +00042530: 7468 2074 6963 6b65 7420 696e 666f 2e0a  th ticket info..
│ │ │ │ +00042540: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +00042550: 6f6e 3a2a 2047 6574 2041 534e 2e31 2045  on:* Get ASN.1 E
│ │ │ │ +00042560: 6e63 5469 636b 6574 5061 7274 2073 7472  ncTicketPart str
│ │ │ │ +00042570: 7563 7475 7265 2066 726f 6d20 7469 636b  ucture from tick
│ │ │ │ +00042580: 6574 2e0a 0a20 2020 2020 2a52 6574 7572  et...     *Retur
│ │ │ │ +00042590: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ +000425a0: 7320 456e 6354 6963 6b65 7450 6172 7420  s EncTicketPart 
│ │ │ │ +000425b0: 696e 666f 726d 6174 696f 6e2e 0a0a 7368  information...sh
│ │ │ │ +000425c0: 6973 6869 5f74 6b74 5f65 6e63 7469 636b  ishi_tkt_enctick
│ │ │ │ +000425d0: 6574 7061 7274 5f73 6574 0a2d 2d2d 2d2d  etpart_set.-----
│ │ │ │  000425e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000425f0: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ -00042600: 696f 6e3a 2076 6f69 6420 7368 6973 6869  ion: void shishi
│ │ │ │ -00042610: 5f74 6b74 5f65 6e63 7469 636b 6574 7061  _tkt_encticketpa
│ │ │ │ -00042620: 7274 5f73 6574 2028 5368 6973 6869 5f74  rt_set (Shishi_t
│ │ │ │ -00042630: 6b74 202a 2054 4b54 2c0a 2020 2020 2020  kt * TKT,.      
│ │ │ │ -00042640: 2020 2020 5368 6973 6869 5f61 736e 3120      Shishi_asn1 
│ │ │ │ -00042650: 454e 4354 4943 4b45 5450 4152 5429 0a20  ENCTICKETPART). 
│ │ │ │ -00042660: 2020 2020 544b 543a 2069 6e70 7574 2076      TKT: input v
│ │ │ │ -00042670: 6172 6961 626c 6520 7769 7468 2074 6963  ariable with tic
│ │ │ │ -00042680: 6b65 7420 696e 666f 2e0a 2020 2020 2045  ket info..     E
│ │ │ │ -00042690: 4e43 5449 434b 4554 5041 5254 3a20 656e  NCTICKETPART: en
│ │ │ │ -000426a0: 6374 6963 6b65 7470 6172 7420 746f 2073  cticketpart to s
│ │ │ │ -000426b0: 746f 7265 2069 6e20 7469 636b 6574 2e0a  tore in ticket..
│ │ │ │ -000426c0: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -000426d0: 6f6e 3a2a 2053 6574 2074 6865 2045 6e63  on:* Set the Enc
│ │ │ │ -000426e0: 5469 636b 6574 5061 7274 2069 6e20 7468  TicketPart in th
│ │ │ │ -000426f0: 6520 5469 636b 6574 2e0a 0a73 6869 7368  e Ticket...shish
│ │ │ │ -00042700: 695f 746b 745f 6b65 790a 2d2d 2d2d 2d2d  i_tkt_key.------
│ │ │ │ -00042710: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -00042720: 6e63 7469 6f6e 3a20 5368 6973 6869 5f6b  nction: Shishi_k
│ │ │ │ -00042730: 6579 202a 2073 6869 7368 695f 746b 745f  ey * shishi_tkt_
│ │ │ │ -00042740: 6b65 7920 2853 6869 7368 695f 746b 7420  key (Shishi_tkt 
│ │ │ │ -00042750: 2a20 544b 5429 0a20 2020 2020 544b 543a  * TKT).     TKT:
│ │ │ │ -00042760: 2069 6e70 7574 2076 6172 6961 626c 6520   input variable 
│ │ │ │ -00042770: 7769 7468 2074 6963 6b65 7420 696e 666f  with ticket info
│ │ │ │ -00042780: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ -00042790: 7469 6f6e 3a2a 2047 6574 206b 6579 2075  tion:* Get key u
│ │ │ │ -000427a0: 7365 6420 696e 2074 6963 6b65 742c 2062  sed in ticket, b
│ │ │ │ -000427b0: 7920 6c6f 6f6b 696e 6720 6669 7273 7420  y looking first 
│ │ │ │ -000427c0: 696e 0a20 2020 2020 456e 634b 4443 5265  in.     EncKDCRe
│ │ │ │ -000427d0: 7050 6172 7420 616e 6420 7468 656e 2069  pPart and then i
│ │ │ │ -000427e0: 6e20 456e 6354 6963 6b65 7450 6172 742e  n EncTicketPart.
│ │ │ │ -000427f0: 2020 4966 206b 6579 2069 7320 616c 7265    If key is alre
│ │ │ │ -00042800: 6164 790a 2020 2020 2070 6f70 756c 6174  ady.     populat
│ │ │ │ -00042810: 6564 2c20 6974 2069 7320 6e6f 7420 6578  ed, it is not ex
│ │ │ │ -00042820: 7472 6163 7465 6420 6167 6169 6e2e 0a0a  tracted again...
│ │ │ │ -00042830: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ -00042840: 7565 3a2a 2052 6574 7572 6e73 206b 6579  ue:* Returns key
│ │ │ │ -00042850: 2065 7874 7261 6374 6564 2066 726f 6d20   extracted from 
│ │ │ │ -00042860: 456e 634b 4443 5265 7050 6172 7420 6f72  EncKDCRepPart or
│ │ │ │ -00042870: 0a20 2020 2020 456e 6354 6963 6b65 7450  .     EncTicketP
│ │ │ │ -00042880: 6172 742e 0a0a 7368 6973 6869 5f74 6b74  art...shishi_tkt
│ │ │ │ -00042890: 5f6b 6579 5f73 6574 0a2d 2d2d 2d2d 2d2d  _key_set.-------
│ │ │ │ -000428a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ -000428b0: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ -000428c0: 6869 7368 695f 746b 745f 6b65 795f 7365  hishi_tkt_key_se
│ │ │ │ -000428d0: 7420 2853 6869 7368 695f 746b 7420 2a20  t (Shishi_tkt * 
│ │ │ │ -000428e0: 544b 542c 0a20 2020 2020 2020 2020 2053  TKT,.          S
│ │ │ │ -000428f0: 6869 7368 695f 6b65 7920 2a20 4b45 5929  hishi_key * KEY)
│ │ │ │ -00042900: 0a20 2020 2020 544b 543a 2069 6e70 7574  .     TKT: input
│ │ │ │ -00042910: 2076 6172 6961 626c 6520 7769 7468 2074   variable with t
│ │ │ │ -00042920: 6963 6b65 7420 696e 666f 2e0a 2020 2020  icket info..    
│ │ │ │ -00042930: 204b 4559 3a20 6b65 7920 746f 2073 746f   KEY: key to sto
│ │ │ │ -00042940: 7265 2069 6e20 7469 636b 6574 2e0a 0a20  re in ticket... 
│ │ │ │ -00042950: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -00042960: 3a2a 2053 6574 2074 6865 206b 6579 2069  :* Set the key i
│ │ │ │ -00042970: 6e20 7468 6520 456e 6354 6963 6b65 7450  n the EncTicketP
│ │ │ │ -00042980: 6172 742e 0a0a 2020 2020 202a 5265 7475  art...     *Retu
│ │ │ │ -00042990: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ -000429a0: 6e73 2053 4849 5348 495f 4f4b 2069 6666  ns SHISHI_OK iff
│ │ │ │ -000429b0: 2073 7563 6365 7373 6675 6c2e 0a0a 7368   successful...sh
│ │ │ │ -000429c0: 6973 6869 5f74 6b74 5f63 6c69 656e 740a  ishi_tkt_client.
│ │ │ │ -000429d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000429e0: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ -000429f0: 2069 6e74 2073 6869 7368 695f 746b 745f   int shishi_tkt_
│ │ │ │ -00042a00: 636c 6965 6e74 2028 5368 6973 6869 5f74  client (Shishi_t
│ │ │ │ -00042a10: 6b74 202a 2054 4b54 2c20 6368 6172 202a  kt * TKT, char *
│ │ │ │ -00042a20: 2a20 434c 4945 4e54 2c0a 2020 2020 2020  * CLIENT,.      
│ │ │ │ -00042a30: 2020 2020 7369 7a65 5f74 202a 2043 4c49      size_t * CLI
│ │ │ │ -00042a40: 454e 544c 454e 290a 2020 2020 2054 4b54  ENTLEN).     TKT
│ │ │ │ -00042a50: 3a20 696e 7075 7420 7661 7269 6162 6c65  : input variable
│ │ │ │ -00042a60: 2077 6974 6820 7469 636b 6574 2069 6e66   with ticket inf
│ │ │ │ -00042a70: 6f2e 0a20 2020 2020 434c 4945 4e54 3a20  o..     CLIENT: 
│ │ │ │ -00042a80: 706f 696e 7465 7220 746f 206e 6577 6c79  pointer to newly
│ │ │ │ -00042a90: 2061 6c6c 6f63 6174 6564 207a 6572 6f20   allocated zero 
│ │ │ │ -00042aa0: 7465 726d 696e 6174 6564 2073 7472 696e  terminated strin
│ │ │ │ -00042ab0: 670a 2020 2020 2063 6f6e 7461 696e 696e  g.     containin
│ │ │ │ -00042ac0: 6720 7072 696e 6369 7061 6c20 6e61 6d65  g principal name
│ │ │ │ -00042ad0: 2e20 204d 6179 2062 6520 e280 984e 554c  .  May be ...NUL
│ │ │ │ -00042ae0: 4ce2 8099 2028 746f 206f 6e6c 7920 706f  L... (to only po
│ │ │ │ -00042af0: 7075 6c61 7465 0a20 2020 2020 434c 4945  pulate.     CLIE
│ │ │ │ -00042b00: 4e54 4c45 4e29 2e0a 2020 2020 2043 4c49  NTLEN)..     CLI
│ │ │ │ -00042b10: 454e 544c 454e 3a20 706f 696e 7465 7220  ENTLEN: pointer 
│ │ │ │ -00042b20: 746f 206c 656e 6774 6820 6f66 2043 4c49  to length of CLI
│ │ │ │ -00042b30: 454e 5420 6f6e 206f 7574 7075 742c 2065  ENT on output, e
│ │ │ │ -00042b40: 7863 6c75 6469 6e67 0a20 2020 2020 7465  xcluding.     te
│ │ │ │ -00042b50: 726d 696e 6174 696e 6720 7a65 726f 2e20  rminating zero. 
│ │ │ │ -00042b60: 204d 6179 2062 6520 e280 984e 554c 4ce2   May be ...NULL.
│ │ │ │ -00042b70: 8099 2028 746f 206f 6e6c 7920 706f 7075  .. (to only popu
│ │ │ │ -00042b80: 6c61 7465 2043 4c49 454e 5429 2e0a 0a20  late CLIENT)... 
│ │ │ │ -00042b90: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -00042ba0: 3a2a 2052 6570 7265 7365 6e74 2063 6c69  :* Represent cli
│ │ │ │ -00042bb0: 656e 7420 7072 696e 6369 7061 6c20 6e61  ent principal na
│ │ │ │ -00042bc0: 6d65 2069 6e20 5469 636b 6574 204b 4443  me in Ticket KDC
│ │ │ │ -00042bd0: 2d52 4550 2061 730a 2020 2020 207a 6572  -REP as.     zer
│ │ │ │ -00042be0: 6f2d 7465 726d 696e 6174 6564 2073 7472  o-terminated str
│ │ │ │ -00042bf0: 696e 672e 2020 5468 6520 7374 7269 6e67  ing.  The string
│ │ │ │ -00042c00: 2069 7320 616c 6c6f 6361 7465 2062 7920   is allocate by 
│ │ │ │ -00042c10: 7468 6973 2066 756e 6374 696f 6e2c 0a20  this function,. 
│ │ │ │ -00042c20: 2020 2020 616e 6420 6974 2069 7320 7468      and it is th
│ │ │ │ -00042c30: 6520 7265 7370 6f6e 7369 6269 6c69 7479  e responsibility
│ │ │ │ -00042c40: 206f 6620 7468 6520 6361 6c6c 6572 2074   of the caller t
│ │ │ │ -00042c50: 6f20 6465 616c 6c6f 6361 7465 2069 742e  o deallocate it.
│ │ │ │ -00042c60: 2020 4e6f 7465 0a20 2020 2020 7468 6174    Note.     that
│ │ │ │ -00042c70: 2074 6865 206f 7574 7075 7420 6c65 6e67   the output leng
│ │ │ │ -00042c80: 7468 2043 4c49 454e 544c 454e 2064 6f65  th CLIENTLEN doe
│ │ │ │ -00042c90: 7320 6e6f 7420 696e 636c 7564 6520 7468  s not include th
│ │ │ │ -00042ca0: 6520 7465 726d 696e 6174 696e 670a 2020  e terminating.  
│ │ │ │ -00042cb0: 2020 207a 6572 6f2e 0a0a 2020 2020 202a     zero...     *
│ │ │ │ -00042cc0: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ -00042cd0: 6574 7572 6e73 2053 4849 5348 495f 4f4b  eturns SHISHI_OK
│ │ │ │ -00042ce0: 2069 6666 2073 7563 6365 7373 6675 6c2e   iff successful.
│ │ │ │ -00042cf0: 0a0a 7368 6973 6869 5f74 6b74 5f63 6c69  ..shishi_tkt_cli
│ │ │ │ -00042d00: 656e 745f 700a 2d2d 2d2d 2d2d 2d2d 2d2d  ent_p.----------
│ │ │ │ -00042d10: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ -00042d20: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ -00042d30: 7368 695f 746b 745f 636c 6965 6e74 5f70  shi_tkt_client_p
│ │ │ │ -00042d40: 2028 5368 6973 6869 5f74 6b74 202a 2054   (Shishi_tkt * T
│ │ │ │ -00042d50: 4b54 2c0a 2020 2020 2020 2020 2020 636f  KT,.          co
│ │ │ │ -00042d60: 6e73 7420 6368 6172 202a 2043 4c49 454e  nst char * CLIEN
│ │ │ │ -00042d70: 5429 0a20 2020 2020 544b 543a 2069 6e70  T).     TKT: inp
│ │ │ │ -00042d80: 7574 2076 6172 6961 626c 6520 7769 7468  ut variable with
│ │ │ │ -00042d90: 2074 6963 6b65 7420 696e 666f 2e0a 2020   ticket info..  
│ │ │ │ -00042da0: 2020 2043 4c49 454e 543a 2063 6c69 656e     CLIENT: clien
│ │ │ │ -00042db0: 7420 6e61 6d65 206f 6620 7469 636b 6574  t name of ticket
│ │ │ │ -00042dc0: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ -00042dd0: 7469 6f6e 3a2a 2044 6574 6572 6d69 6e65  tion:* Determine
│ │ │ │ -00042de0: 2069 6620 7469 636b 6574 2069 7320 666f   if ticket is fo
│ │ │ │ -00042df0: 7220 7370 6563 6966 6965 6420 636c 6965  r specified clie
│ │ │ │ -00042e00: 6e74 2e0a 0a20 2020 2020 2a52 6574 7572  nt...     *Retur
│ │ │ │ -00042e10: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ -00042e20: 7320 6e6f 6e2d 3020 6966 6620 7469 636b  s non-0 iff tick
│ │ │ │ -00042e30: 6574 2069 7320 666f 7220 7370 6563 6966  et is for specif
│ │ │ │ -00042e40: 6965 6420 636c 6965 6e74 2e0a 0a73 6869  ied client...shi
│ │ │ │ -00042e50: 7368 695f 746b 745f 636c 6965 6e74 7265  shi_tkt_clientre
│ │ │ │ -00042e60: 616c 6d0a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  alm.------------
│ │ │ │ -00042e70: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ -00042e80: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ -00042e90: 6973 6869 5f74 6b74 5f63 6c69 656e 7472  ishi_tkt_clientr
│ │ │ │ -00042ea0: 6561 6c6d 2028 5368 6973 6869 5f74 6b74  ealm (Shishi_tkt
│ │ │ │ -00042eb0: 202a 2054 4b54 2c0a 2020 2020 2020 2020   * TKT,.        
│ │ │ │ -00042ec0: 2020 6368 6172 202a 2a20 434c 4945 4e54    char ** CLIENT
│ │ │ │ -00042ed0: 2c20 7369 7a65 5f74 202a 2043 4c49 454e  , size_t * CLIEN
│ │ │ │ -00042ee0: 544c 454e 290a 2020 2020 2054 4b54 3a20  TLEN).     TKT: 
│ │ │ │ -00042ef0: 696e 7075 7420 7661 7269 6162 6c65 2077  input variable w
│ │ │ │ -00042f00: 6974 6820 7469 636b 6574 2069 6e66 6f2e  ith ticket info.
│ │ │ │ -00042f10: 0a20 2020 2020 434c 4945 4e54 3a20 706f  .     CLIENT: po
│ │ │ │ -00042f20: 696e 7465 7220 746f 206e 6577 6c79 2061  inter to newly a
│ │ │ │ -00042f30: 6c6c 6f63 6174 6564 207a 6572 6f20 7465  llocated zero te
│ │ │ │ -00042f40: 726d 696e 6174 6564 2073 7472 696e 670a  rminated string.
│ │ │ │ -00042f50: 2020 2020 2063 6f6e 7461 696e 696e 6720       containing 
│ │ │ │ -00042f60: 7072 696e 6369 7061 6c20 6e61 6d65 2061  principal name a
│ │ │ │ -00042f70: 6e64 2072 6561 6c6d 2e20 204d 6179 2062  nd realm.  May b
│ │ │ │ -00042f80: 6520 e280 984e 554c 4ce2 8099 2028 746f  e ...NULL... (to
│ │ │ │ -00042f90: 206f 6e6c 790a 2020 2020 2070 6f70 756c   only.     popul
│ │ │ │ -00042fa0: 6174 6520 434c 4945 4e54 4c45 4e29 2e0a  ate CLIENTLEN)..
│ │ │ │ -00042fb0: 2020 2020 2043 4c49 454e 544c 454e 3a20       CLIENTLEN: 
│ │ │ │ -00042fc0: 706f 696e 7465 7220 746f 206c 656e 6774  pointer to lengt
│ │ │ │ -00042fd0: 6820 6f66 2043 4c49 454e 5420 6f6e 206f  h of CLIENT on o
│ │ │ │ -00042fe0: 7574 7075 742c 2065 7863 6c75 6469 6e67  utput, excluding
│ │ │ │ -00042ff0: 0a20 2020 2020 7465 726d 696e 6174 696e  .     terminatin
│ │ │ │ -00043000: 6720 7a65 726f 2e20 204d 6179 2062 6520  g zero.  May be 
│ │ │ │ -00043010: e280 984e 554c 4ce2 8099 2028 746f 206f  ...NULL... (to o
│ │ │ │ -00043020: 6e6c 7920 706f 7075 6c61 7465 2043 4c49  nly populate CLI
│ │ │ │ -00043030: 454e 5429 2e0a 0a20 2020 2020 2a44 6573  ENT)...     *Des
│ │ │ │ -00043040: 6372 6970 7469 6f6e 3a2a 2043 6f6e 7665  cription:* Conve
│ │ │ │ -00043050: 7274 2063 6e61 6d65 2061 6e64 2072 6561  rt cname and rea
│ │ │ │ -00043060: 6c6d 2066 6965 6c64 7320 6672 6f6d 2041  lm fields from A
│ │ │ │ -00043070: 532d 5245 5120 746f 0a20 2020 2020 7072  S-REQ to.     pr
│ │ │ │ -00043080: 696e 7461 626c 6520 7072 696e 6369 7061  intable principa
│ │ │ │ -00043090: 6c20 6e61 6d65 2066 6f72 6d61 742e 2020  l name format.  
│ │ │ │ -000430a0: 5468 6520 7374 7269 6e67 2069 7320 616c  The string is al
│ │ │ │ -000430b0: 6c6f 6361 7465 2062 7920 7468 6973 0a20  locate by this. 
│ │ │ │ -000430c0: 2020 2020 6675 6e63 7469 6f6e 2c20 616e      function, an
│ │ │ │ -000430d0: 6420 6974 2069 7320 7468 6520 7265 7370  d it is the resp
│ │ │ │ -000430e0: 6f6e 7369 6269 6c69 7479 206f 6620 7468  onsibility of th
│ │ │ │ -000430f0: 6520 6361 6c6c 6572 2074 6f20 6465 616c  e caller to deal
│ │ │ │ -00043100: 6c6f 6361 7465 0a20 2020 2020 6974 2e20  locate.     it. 
│ │ │ │ -00043110: 204e 6f74 6520 7468 6174 2074 6865 206f   Note that the o
│ │ │ │ -00043120: 7574 7075 7420 6c65 6e67 7468 2043 4c49  utput length CLI
│ │ │ │ -00043130: 454e 544c 454e 2064 6f65 7320 6e6f 7420  ENTLEN does not 
│ │ │ │ -00043140: 696e 636c 7564 6520 7468 650a 2020 2020  include the.    
│ │ │ │ -00043150: 2074 6572 6d69 6e61 7469 6e67 207a 6572   terminating zer
│ │ │ │ -00043160: 6f2e 0a0a 2020 2020 202a 5265 7475 726e  o...     *Return
│ │ │ │ -00043170: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ -00043180: 2053 4849 5348 495f 4f4b 2069 6666 2073   SHISHI_OK iff s
│ │ │ │ -00043190: 7563 6365 7373 6675 6c2e 0a0a 7368 6973  uccessful...shis
│ │ │ │ -000431a0: 6869 5f74 6b74 5f63 6c69 656e 7472 6561  hi_tkt_clientrea
│ │ │ │ -000431b0: 6c6d 5f70 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  lm_p.-----------
│ │ │ │ -000431c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -000431d0: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ -000431e0: 2073 6869 7368 695f 746b 745f 636c 6965   shishi_tkt_clie
│ │ │ │ -000431f0: 6e74 7265 616c 6d5f 7020 2853 6869 7368  ntrealm_p (Shish
│ │ │ │ -00043200: 695f 746b 7420 2a20 544b 542c 0a20 2020  i_tkt * TKT,.   
│ │ │ │ -00043210: 2020 2020 2020 2063 6f6e 7374 2063 6861         const cha
│ │ │ │ -00043220: 7220 2a20 434c 4945 4e54 290a 2020 2020  r * CLIENT).    
│ │ │ │ -00043230: 2054 4b54 3a20 696e 7075 7420 7661 7269   TKT: input vari
│ │ │ │ -00043240: 6162 6c65 2077 6974 6820 7469 636b 6574  able with ticket
│ │ │ │ -00043250: 2069 6e66 6f2e 0a20 2020 2020 434c 4945   info..     CLIE
│ │ │ │ -00043260: 4e54 3a20 7072 696e 6369 7061 6c20 6e61  NT: principal na
│ │ │ │ -00043270: 6d65 2028 636c 6965 6e74 206e 616d 6520  me (client name 
│ │ │ │ -00043280: 616e 6420 7265 616c 6d29 206f 6620 7469  and realm) of ti
│ │ │ │ -00043290: 636b 6574 2e0a 0a20 2020 2020 2a44 6573  cket...     *Des
│ │ │ │ -000432a0: 6372 6970 7469 6f6e 3a2a 2044 6574 6572  cription:* Deter
│ │ │ │ -000432b0: 6d69 6e65 2069 6620 7469 636b 6574 2069  mine if ticket i
│ │ │ │ -000432c0: 7320 666f 7220 7370 6563 6966 6965 6420  s for specified 
│ │ │ │ -000432d0: 636c 6965 6e74 0a20 2020 2020 7072 696e  client.     prin
│ │ │ │ -000432e0: 6369 7061 6c2e 0a0a 2020 2020 202a 5265  cipal...     *Re
│ │ │ │ -000432f0: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ -00043300: 7572 6e73 206e 6f6e 2d30 2069 6666 2074  urns non-0 iff t
│ │ │ │ -00043310: 6963 6b65 7420 6973 2066 6f72 2073 7065  icket is for spe
│ │ │ │ -00043320: 6369 6669 6564 2063 6c69 656e 740a 2020  cified client.  
│ │ │ │ -00043330: 2020 2070 7269 6e63 6970 616c 2e0a 0a73     principal...s
│ │ │ │ -00043340: 6869 7368 695f 746b 745f 7265 616c 6d0a  hishi_tkt_realm.
│ │ │ │ -00043350: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00043360: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ -00043370: 696e 7420 7368 6973 6869 5f74 6b74 5f72  int shishi_tkt_r
│ │ │ │ -00043380: 6561 6c6d 2028 5368 6973 6869 5f74 6b74  ealm (Shishi_tkt
│ │ │ │ -00043390: 202a 2054 4b54 2c20 6368 6172 202a 2a20   * TKT, char ** 
│ │ │ │ -000433a0: 5245 414c 4d2c 0a20 2020 2020 2020 2020  REALM,.         
│ │ │ │ -000433b0: 2073 697a 655f 7420 2a20 5245 414c 4d4c   size_t * REALML
│ │ │ │ -000433c0: 454e 290a 2020 2020 2054 4b54 3a20 696e  EN).     TKT: in
│ │ │ │ -000433d0: 7075 7420 7661 7269 6162 6c65 2077 6974  put variable wit
│ │ │ │ -000433e0: 6820 7469 636b 6574 2069 6e66 6f2e 0a20  h ticket info.. 
│ │ │ │ -000433f0: 2020 2020 5245 414c 4d3a 2070 6f69 6e74      REALM: point
│ │ │ │ -00043400: 6572 2074 6f20 6e65 776c 7920 616c 6c6f  er to newly allo
│ │ │ │ -00043410: 6361 7465 6420 6368 6172 6163 7465 7220  cated character 
│ │ │ │ -00043420: 6172 7261 7920 7769 7468 2072 6561 6c6d  array with realm
│ │ │ │ -00043430: 206e 616d 652e 0a0a 2020 2020 2052 4541   name...     REA
│ │ │ │ -00043440: 4c4d 4c45 4e3a 206c 656e 6774 6820 6f66  LMLEN: length of
│ │ │ │ -00043450: 206e 6577 6c79 2061 6c6c 6f63 6174 6564   newly allocated
│ │ │ │ -00043460: 2063 6861 7261 6374 6572 2061 7272 6179   character array
│ │ │ │ -00043470: 2077 6974 6820 7265 616c 6d0a 2020 2020   with realm.    
│ │ │ │ -00043480: 206e 616d 652e 0a0a 2020 2020 202a 4465   name...     *De
│ │ │ │ -00043490: 7363 7269 7074 696f 6e3a 2a20 4578 7472  scription:* Extr
│ │ │ │ -000434a0: 6163 7420 7265 616c 6d20 6f66 2073 6572  act realm of ser
│ │ │ │ -000434b0: 7665 7220 696e 2074 6963 6b65 742e 0a0a  ver in ticket...
│ │ │ │ -000434c0: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ -000434d0: 7565 3a2a 2052 6574 7572 6e73 2053 4849  ue:* Returns SHI
│ │ │ │ -000434e0: 5348 495f 4f4b 2069 6666 2073 7563 6365  SHI_OK iff succe
│ │ │ │ -000434f0: 7373 6675 6c2e 0a0a 7368 6973 6869 5f74  ssful...shishi_t
│ │ │ │ -00043500: 6b74 5f73 6572 7665 720a 2d2d 2d2d 2d2d  kt_server.------
│ │ │ │ -00043510: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ -00043520: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ -00043530: 6869 7368 695f 746b 745f 7365 7276 6572  hishi_tkt_server
│ │ │ │ -00043540: 2028 5368 6973 6869 5f74 6b74 202a 2054   (Shishi_tkt * T
│ │ │ │ -00043550: 4b54 2c20 6368 6172 202a 2a20 5345 5256  KT, char ** SERV
│ │ │ │ -00043560: 4552 2c0a 2020 2020 2020 2020 2020 7369  ER,.          si
│ │ │ │ -00043570: 7a65 5f74 202a 2053 4552 5645 524c 454e  ze_t * SERVERLEN
│ │ │ │ -00043580: 290a 2020 2020 2054 4b54 3a20 696e 7075  ).     TKT: inpu
│ │ │ │ -00043590: 7420 7661 7269 6162 6c65 2077 6974 6820  t variable with 
│ │ │ │ -000435a0: 7469 636b 6574 2069 6e66 6f2e 0a20 2020  ticket info..   
│ │ │ │ -000435b0: 2020 5345 5256 4552 3a20 706f 696e 7465    SERVER: pointe
│ │ │ │ -000435c0: 7220 746f 206e 6577 6c79 2061 6c6c 6f63  r to newly alloc
│ │ │ │ -000435d0: 6174 6564 207a 6572 6f20 7465 726d 696e  ated zero termin
│ │ │ │ -000435e0: 6174 6564 2073 7472 696e 670a 2020 2020  ated string.    
│ │ │ │ -000435f0: 2063 6f6e 7461 696e 696e 6720 7072 696e   containing prin
│ │ │ │ -00043600: 6369 7061 6c20 6e61 6d65 2e20 204d 6179  cipal name.  May
│ │ │ │ -00043610: 2062 6520 e280 984e 554c 4ce2 8099 2028   be ...NULL... (
│ │ │ │ -00043620: 746f 206f 6e6c 7920 706f 7075 6c61 7465  to only populate
│ │ │ │ -00043630: 0a20 2020 2020 5345 5256 4552 4c45 4e29  .     SERVERLEN)
│ │ │ │ -00043640: 2e0a 2020 2020 2053 4552 5645 524c 454e  ..     SERVERLEN
│ │ │ │ -00043650: 3a20 706f 696e 7465 7220 746f 206c 656e  : pointer to len
│ │ │ │ -00043660: 6774 6820 6f66 2053 4552 5645 5220 6f6e  gth of SERVER on
│ │ │ │ -00043670: 206f 7574 7075 742c 2065 7863 6c75 6469   output, excludi
│ │ │ │ -00043680: 6e67 0a20 2020 2020 7465 726d 696e 6174  ng.     terminat
│ │ │ │ -00043690: 696e 6720 7a65 726f 2e20 204d 6179 2062  ing zero.  May b
│ │ │ │ -000436a0: 6520 e280 984e 554c 4ce2 8099 2028 746f  e ...NULL... (to
│ │ │ │ -000436b0: 206f 6e6c 7920 706f 7075 6c61 7465 2053   only populate S
│ │ │ │ -000436c0: 4552 5645 5229 2e0a 0a20 2020 2020 2a44  ERVER)...     *D
│ │ │ │ -000436d0: 6573 6372 6970 7469 6f6e 3a2a 2052 6570  escription:* Rep
│ │ │ │ -000436e0: 7265 7365 6e74 2073 6572 7665 7220 7072  resent server pr
│ │ │ │ -000436f0: 696e 6369 7061 6c20 6e61 6d65 2069 6e20  incipal name in 
│ │ │ │ -00043700: 5469 636b 6574 2061 730a 2020 2020 207a  Ticket as.     z
│ │ │ │ -00043710: 6572 6f2d 7465 726d 696e 6174 6564 2073  ero-terminated s
│ │ │ │ -00043720: 7472 696e 672e 2020 5468 6520 7374 7269  tring.  The stri
│ │ │ │ -00043730: 6e67 2069 7320 616c 6c6f 6361 7465 2062  ng is allocate b
│ │ │ │ -00043740: 7920 7468 6973 2066 756e 6374 696f 6e2c  y this function,
│ │ │ │ -00043750: 0a20 2020 2020 616e 6420 6974 2069 7320  .     and it is 
│ │ │ │ -00043760: 7468 6520 7265 7370 6f6e 7369 6269 6c69  the responsibili
│ │ │ │ -00043770: 7479 206f 6620 7468 6520 6361 6c6c 6572  ty of the caller
│ │ │ │ -00043780: 2074 6f20 6465 616c 6c6f 6361 7465 2069   to deallocate i
│ │ │ │ -00043790: 742e 2020 4e6f 7465 0a20 2020 2020 7468  t.  Note.     th
│ │ │ │ -000437a0: 6174 2074 6865 206f 7574 7075 7420 6c65  at the output le
│ │ │ │ -000437b0: 6e67 7468 2053 4552 5645 524c 454e 2064  ngth SERVERLEN d
│ │ │ │ -000437c0: 6f65 7320 6e6f 7420 696e 636c 7564 6520  oes not include 
│ │ │ │ -000437d0: 7468 6520 7465 726d 696e 6174 696e 670a  the terminating.
│ │ │ │ -000437e0: 2020 2020 207a 6572 6f2e 0a0a 2020 2020       zero...    
│ │ │ │ -000437f0: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ -00043800: 2052 6574 7572 6e73 2053 4849 5348 495f   Returns SHISHI_
│ │ │ │ -00043810: 4f4b 2069 6666 2073 7563 6365 7373 6675  OK iff successfu
│ │ │ │ -00043820: 6c2e 0a0a 7368 6973 6869 5f74 6b74 5f73  l...shishi_tkt_s
│ │ │ │ -00043830: 6572 7665 725f 700a 2d2d 2d2d 2d2d 2d2d  erver_p.--------
│ │ │ │ -00043840: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ -00043850: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ -00043860: 6869 7368 695f 746b 745f 7365 7276 6572  hishi_tkt_server
│ │ │ │ -00043870: 5f70 2028 5368 6973 6869 5f74 6b74 202a  _p (Shishi_tkt *
│ │ │ │ -00043880: 2054 4b54 2c0a 2020 2020 2020 2020 2020   TKT,.          
│ │ │ │ -00043890: 636f 6e73 7420 6368 6172 202a 2053 4552  const char * SER
│ │ │ │ -000438a0: 5645 5229 0a20 2020 2020 544b 543a 2069  VER).     TKT: i
│ │ │ │ -000438b0: 6e70 7574 2076 6172 6961 626c 6520 7769  nput variable wi
│ │ │ │ -000438c0: 7468 2074 6963 6b65 7420 696e 666f 2e0a  th ticket info..
│ │ │ │ -000438d0: 2020 2020 2053 4552 5645 523a 2073 6572       SERVER: ser
│ │ │ │ -000438e0: 7665 7220 6e61 6d65 206f 6620 7469 636b  ver name of tick
│ │ │ │ -000438f0: 6574 2e0a 0a20 2020 2020 2a44 6573 6372  et...     *Descr
│ │ │ │ -00043900: 6970 7469 6f6e 3a2a 2044 6574 6572 6d69  iption:* Determi
│ │ │ │ -00043910: 6e65 2069 6620 7469 636b 6574 2069 7320  ne if ticket is 
│ │ │ │ -00043920: 666f 7220 7370 6563 6966 6965 6420 7365  for specified se
│ │ │ │ -00043930: 7276 6572 2e0a 0a20 2020 2020 2a52 6574  rver...     *Ret
│ │ │ │ -00043940: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ -00043950: 726e 7320 6e6f 6e2d 3020 6966 6620 7469  rns non-0 iff ti
│ │ │ │ -00043960: 636b 6574 2069 7320 666f 7220 7370 6563  cket is for spec
│ │ │ │ -00043970: 6966 6965 6420 7365 7276 6572 2e0a 0a73  ified server...s
│ │ │ │ -00043980: 6869 7368 695f 746b 745f 666c 6167 730a  hishi_tkt_flags.
│ │ │ │ -00043990: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000439a0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ -000439b0: 696e 7420 7368 6973 6869 5f74 6b74 5f66  int shishi_tkt_f
│ │ │ │ -000439c0: 6c61 6773 2028 5368 6973 6869 5f74 6b74  lags (Shishi_tkt
│ │ │ │ -000439d0: 202a 2054 4b54 2c20 7569 6e74 3332 5f74   * TKT, uint32_t
│ │ │ │ -000439e0: 202a 2046 4c41 4753 290a 2020 2020 2054   * FLAGS).     T
│ │ │ │ -000439f0: 4b54 3a20 696e 7075 7420 7661 7269 6162  KT: input variab
│ │ │ │ -00043a00: 6c65 2077 6974 6820 7469 636b 6574 2069  le with ticket i
│ │ │ │ -00043a10: 6e66 6f2e 0a20 2020 2020 464c 4147 533a  nfo..     FLAGS:
│ │ │ │ -00043a20: 2070 6f69 6e74 6572 2074 6f20 6f75 7470   pointer to outp
│ │ │ │ -00043a30: 7574 2069 6e74 6567 6572 2077 6974 6820  ut integer with 
│ │ │ │ -00043a40: 666c 6167 732e 0a0a 2020 2020 202a 4465  flags...     *De
│ │ │ │ -00043a50: 7363 7269 7074 696f 6e3a 2a20 4578 7472  scription:* Extr
│ │ │ │ -00043a60: 6163 7420 666c 6167 7320 696e 2074 6963  act flags in tic
│ │ │ │ -00043a70: 6b65 7420 2869 2e65 2e2c 2045 6e63 4b44  ket (i.e., EncKD
│ │ │ │ -00043a80: 4352 6570 5061 7274 292e 0a0a 2020 2020  CRepPart)...    
│ │ │ │ -00043a90: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ -00043aa0: 2052 6574 7572 6e73 2053 4849 5348 495f   Returns SHISHI_
│ │ │ │ -00043ab0: 4f4b 2069 6666 2073 7563 6365 7373 6675  OK iff successfu
│ │ │ │ -00043ac0: 6c2e 0a0a 7368 6973 6869 5f74 6b74 5f66  l...shishi_tkt_f
│ │ │ │ -00043ad0: 6c61 6773 5f73 6574 0a2d 2d2d 2d2d 2d2d  lags_set.-------
│ │ │ │ -00043ae0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -00043af0: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ -00043b00: 2073 6869 7368 695f 746b 745f 666c 6167   shishi_tkt_flag
│ │ │ │ -00043b10: 735f 7365 7420 2853 6869 7368 695f 746b  s_set (Shishi_tk
│ │ │ │ -00043b20: 7420 2a20 544b 542c 0a20 2020 2020 2020  t * TKT,.       
│ │ │ │ -00043b30: 2020 2075 696e 7433 325f 7420 464c 4147     uint32_t FLAG
│ │ │ │ -00043b40: 5329 0a20 2020 2020 544b 543a 2069 6e70  S).     TKT: inp
│ │ │ │ -00043b50: 7574 2076 6172 6961 626c 6520 7769 7468  ut variable with
│ │ │ │ -00043b60: 2074 6963 6b65 7420 696e 666f 2e0a 2020   ticket info..  
│ │ │ │ -00043b70: 2020 2046 4c41 4753 3a20 696e 7465 6765     FLAGS: intege
│ │ │ │ -00043b80: 7220 7769 7468 2066 6c61 6773 2074 6f20  r with flags to 
│ │ │ │ -00043b90: 7374 6f72 6520 696e 2074 6963 6b65 742e  store in ticket.
│ │ │ │ -00043ba0: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ -00043bb0: 696f 6e3a 2a20 5365 7420 666c 6167 7320  ion:* Set flags 
│ │ │ │ -00043bc0: 696e 2074 6963 6b65 742c 2069 2e65 2e2c  in ticket, i.e.,
│ │ │ │ -00043bd0: 2062 6f74 6820 456e 6354 6963 6b65 7450   both EncTicketP
│ │ │ │ -00043be0: 6172 7420 616e 640a 2020 2020 2045 6e63  art and.     Enc
│ │ │ │ -00043bf0: 4b44 4352 6570 5061 7274 2e20 204e 6f74  KDCRepPart.  Not
│ │ │ │ -00043c00: 6520 7468 6174 2074 6869 7320 7265 7365  e that this rese
│ │ │ │ -00043c10: 7420 616e 7920 616c 7265 6164 7920 6578  t any already ex
│ │ │ │ -00043c20: 6973 7469 6e67 2066 6c61 6773 2e0a 0a20  isting flags... 
│ │ │ │ -00043c30: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ -00043c40: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ -00043c50: 4849 5f4f 4b20 6966 6620 7375 6363 6573  HI_OK iff succes
│ │ │ │ -00043c60: 7366 756c 2e0a 0a73 6869 7368 695f 746b  sful...shishi_tk
│ │ │ │ -00043c70: 745f 666c 6167 735f 6164 640a 2d2d 2d2d  t_flags_add.----
│ │ │ │ +000425f0: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +00042600: 6374 696f 6e3a 2076 6f69 6420 7368 6973  ction: void shis
│ │ │ │ +00042610: 6869 5f74 6b74 5f65 6e63 7469 636b 6574  hi_tkt_encticket
│ │ │ │ +00042620: 7061 7274 5f73 6574 2028 5368 6973 6869  part_set (Shishi
│ │ │ │ +00042630: 5f74 6b74 202a 2054 4b54 2c0a 2020 2020  _tkt * TKT,.    
│ │ │ │ +00042640: 2020 2020 2020 5368 6973 6869 5f61 736e        Shishi_asn
│ │ │ │ +00042650: 3120 454e 4354 4943 4b45 5450 4152 5429  1 ENCTICKETPART)
│ │ │ │ +00042660: 0a20 2020 2020 544b 543a 2069 6e70 7574  .     TKT: input
│ │ │ │ +00042670: 2076 6172 6961 626c 6520 7769 7468 2074   variable with t
│ │ │ │ +00042680: 6963 6b65 7420 696e 666f 2e0a 2020 2020  icket info..    
│ │ │ │ +00042690: 2045 4e43 5449 434b 4554 5041 5254 3a20   ENCTICKETPART: 
│ │ │ │ +000426a0: 656e 6374 6963 6b65 7470 6172 7420 746f  encticketpart to
│ │ │ │ +000426b0: 2073 746f 7265 2069 6e20 7469 636b 6574   store in ticket
│ │ │ │ +000426c0: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ +000426d0: 7469 6f6e 3a2a 2053 6574 2074 6865 2045  tion:* Set the E
│ │ │ │ +000426e0: 6e63 5469 636b 6574 5061 7274 2069 6e20  ncTicketPart in 
│ │ │ │ +000426f0: 7468 6520 5469 636b 6574 2e0a 0a73 6869  the Ticket...shi
│ │ │ │ +00042700: 7368 695f 746b 745f 6b65 790a 2d2d 2d2d  shi_tkt_key.----
│ │ │ │ +00042710: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +00042720: 4675 6e63 7469 6f6e 3a20 5368 6973 6869  Function: Shishi
│ │ │ │ +00042730: 5f6b 6579 202a 2073 6869 7368 695f 746b  _key * shishi_tk
│ │ │ │ +00042740: 745f 6b65 7920 2853 6869 7368 695f 746b  t_key (Shishi_tk
│ │ │ │ +00042750: 7420 2a20 544b 5429 0a20 2020 2020 544b  t * TKT).     TK
│ │ │ │ +00042760: 543a 2069 6e70 7574 2076 6172 6961 626c  T: input variabl
│ │ │ │ +00042770: 6520 7769 7468 2074 6963 6b65 7420 696e  e with ticket in
│ │ │ │ +00042780: 666f 2e0a 0a20 2020 2020 2a44 6573 6372  fo...     *Descr
│ │ │ │ +00042790: 6970 7469 6f6e 3a2a 2047 6574 206b 6579  iption:* Get key
│ │ │ │ +000427a0: 2075 7365 6420 696e 2074 6963 6b65 742c   used in ticket,
│ │ │ │ +000427b0: 2062 7920 6c6f 6f6b 696e 6720 6669 7273   by looking firs
│ │ │ │ +000427c0: 7420 696e 0a20 2020 2020 456e 634b 4443  t in.     EncKDC
│ │ │ │ +000427d0: 5265 7050 6172 7420 616e 6420 7468 656e  RepPart and then
│ │ │ │ +000427e0: 2069 6e20 456e 6354 6963 6b65 7450 6172   in EncTicketPar
│ │ │ │ +000427f0: 742e 2020 4966 206b 6579 2069 7320 616c  t.  If key is al
│ │ │ │ +00042800: 7265 6164 790a 2020 2020 2070 6f70 756c  ready.     popul
│ │ │ │ +00042810: 6174 6564 2c20 6974 2069 7320 6e6f 7420  ated, it is not 
│ │ │ │ +00042820: 6578 7472 6163 7465 6420 6167 6169 6e2e  extracted again.
│ │ │ │ +00042830: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ +00042840: 616c 7565 3a2a 2052 6574 7572 6e73 206b  alue:* Returns k
│ │ │ │ +00042850: 6579 2065 7874 7261 6374 6564 2066 726f  ey extracted fro
│ │ │ │ +00042860: 6d20 456e 634b 4443 5265 7050 6172 7420  m EncKDCRepPart 
│ │ │ │ +00042870: 6f72 0a20 2020 2020 456e 6354 6963 6b65  or.     EncTicke
│ │ │ │ +00042880: 7450 6172 742e 0a0a 7368 6973 6869 5f74  tPart...shishi_t
│ │ │ │ +00042890: 6b74 5f6b 6579 5f73 6574 0a2d 2d2d 2d2d  kt_key_set.-----
│ │ │ │ +000428a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ +000428b0: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ +000428c0: 2073 6869 7368 695f 746b 745f 6b65 795f   shishi_tkt_key_
│ │ │ │ +000428d0: 7365 7420 2853 6869 7368 695f 746b 7420  set (Shishi_tkt 
│ │ │ │ +000428e0: 2a20 544b 542c 0a20 2020 2020 2020 2020  * TKT,.         
│ │ │ │ +000428f0: 2053 6869 7368 695f 6b65 7920 2a20 4b45   Shishi_key * KE
│ │ │ │ +00042900: 5929 0a20 2020 2020 544b 543a 2069 6e70  Y).     TKT: inp
│ │ │ │ +00042910: 7574 2076 6172 6961 626c 6520 7769 7468  ut variable with
│ │ │ │ +00042920: 2074 6963 6b65 7420 696e 666f 2e0a 2020   ticket info..  
│ │ │ │ +00042930: 2020 204b 4559 3a20 6b65 7920 746f 2073     KEY: key to s
│ │ │ │ +00042940: 746f 7265 2069 6e20 7469 636b 6574 2e0a  tore in ticket..
│ │ │ │ +00042950: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +00042960: 6f6e 3a2a 2053 6574 2074 6865 206b 6579  on:* Set the key
│ │ │ │ +00042970: 2069 6e20 7468 6520 456e 6354 6963 6b65   in the EncTicke
│ │ │ │ +00042980: 7450 6172 742e 0a0a 2020 2020 202a 5265  tPart...     *Re
│ │ │ │ +00042990: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ +000429a0: 7572 6e73 2053 4849 5348 495f 4f4b 2069  urns SHISHI_OK i
│ │ │ │ +000429b0: 6666 2073 7563 6365 7373 6675 6c2e 0a0a  ff successful...
│ │ │ │ +000429c0: 7368 6973 6869 5f74 6b74 5f63 6c69 656e  shishi_tkt_clien
│ │ │ │ +000429d0: 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  t.--------------
│ │ │ │ +000429e0: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ +000429f0: 6e3a 2069 6e74 2073 6869 7368 695f 746b  n: int shishi_tk
│ │ │ │ +00042a00: 745f 636c 6965 6e74 2028 5368 6973 6869  t_client (Shishi
│ │ │ │ +00042a10: 5f74 6b74 202a 2054 4b54 2c20 6368 6172  _tkt * TKT, char
│ │ │ │ +00042a20: 202a 2a20 434c 4945 4e54 2c0a 2020 2020   ** CLIENT,.    
│ │ │ │ +00042a30: 2020 2020 2020 7369 7a65 5f74 202a 2043        size_t * C
│ │ │ │ +00042a40: 4c49 454e 544c 454e 290a 2020 2020 2054  LIENTLEN).     T
│ │ │ │ +00042a50: 4b54 3a20 696e 7075 7420 7661 7269 6162  KT: input variab
│ │ │ │ +00042a60: 6c65 2077 6974 6820 7469 636b 6574 2069  le with ticket i
│ │ │ │ +00042a70: 6e66 6f2e 0a20 2020 2020 434c 4945 4e54  nfo..     CLIENT
│ │ │ │ +00042a80: 3a20 706f 696e 7465 7220 746f 206e 6577  : pointer to new
│ │ │ │ +00042a90: 6c79 2061 6c6c 6f63 6174 6564 207a 6572  ly allocated zer
│ │ │ │ +00042aa0: 6f20 7465 726d 696e 6174 6564 2073 7472  o terminated str
│ │ │ │ +00042ab0: 696e 670a 2020 2020 2063 6f6e 7461 696e  ing.     contain
│ │ │ │ +00042ac0: 696e 6720 7072 696e 6369 7061 6c20 6e61  ing principal na
│ │ │ │ +00042ad0: 6d65 2e20 204d 6179 2062 6520 e280 984e  me.  May be ...N
│ │ │ │ +00042ae0: 554c 4ce2 8099 2028 746f 206f 6e6c 7920  ULL... (to only 
│ │ │ │ +00042af0: 706f 7075 6c61 7465 0a20 2020 2020 434c  populate.     CL
│ │ │ │ +00042b00: 4945 4e54 4c45 4e29 2e0a 2020 2020 2043  IENTLEN)..     C
│ │ │ │ +00042b10: 4c49 454e 544c 454e 3a20 706f 696e 7465  LIENTLEN: pointe
│ │ │ │ +00042b20: 7220 746f 206c 656e 6774 6820 6f66 2043  r to length of C
│ │ │ │ +00042b30: 4c49 454e 5420 6f6e 206f 7574 7075 742c  LIENT on output,
│ │ │ │ +00042b40: 2065 7863 6c75 6469 6e67 0a20 2020 2020   excluding.     
│ │ │ │ +00042b50: 7465 726d 696e 6174 696e 6720 7a65 726f  terminating zero
│ │ │ │ +00042b60: 2e20 204d 6179 2062 6520 e280 984e 554c  .  May be ...NUL
│ │ │ │ +00042b70: 4ce2 8099 2028 746f 206f 6e6c 7920 706f  L... (to only po
│ │ │ │ +00042b80: 7075 6c61 7465 2043 4c49 454e 5429 2e0a  pulate CLIENT)..
│ │ │ │ +00042b90: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +00042ba0: 6f6e 3a2a 2052 6570 7265 7365 6e74 2063  on:* Represent c
│ │ │ │ +00042bb0: 6c69 656e 7420 7072 696e 6369 7061 6c20  lient principal 
│ │ │ │ +00042bc0: 6e61 6d65 2069 6e20 5469 636b 6574 204b  name in Ticket K
│ │ │ │ +00042bd0: 4443 2d52 4550 2061 730a 2020 2020 207a  DC-REP as.     z
│ │ │ │ +00042be0: 6572 6f2d 7465 726d 696e 6174 6564 2073  ero-terminated s
│ │ │ │ +00042bf0: 7472 696e 672e 2020 5468 6520 7374 7269  tring.  The stri
│ │ │ │ +00042c00: 6e67 2069 7320 616c 6c6f 6361 7465 2062  ng is allocate b
│ │ │ │ +00042c10: 7920 7468 6973 2066 756e 6374 696f 6e2c  y this function,
│ │ │ │ +00042c20: 0a20 2020 2020 616e 6420 6974 2069 7320  .     and it is 
│ │ │ │ +00042c30: 7468 6520 7265 7370 6f6e 7369 6269 6c69  the responsibili
│ │ │ │ +00042c40: 7479 206f 6620 7468 6520 6361 6c6c 6572  ty of the caller
│ │ │ │ +00042c50: 2074 6f20 6465 616c 6c6f 6361 7465 2069   to deallocate i
│ │ │ │ +00042c60: 742e 2020 4e6f 7465 0a20 2020 2020 7468  t.  Note.     th
│ │ │ │ +00042c70: 6174 2074 6865 206f 7574 7075 7420 6c65  at the output le
│ │ │ │ +00042c80: 6e67 7468 2043 4c49 454e 544c 454e 2064  ngth CLIENTLEN d
│ │ │ │ +00042c90: 6f65 7320 6e6f 7420 696e 636c 7564 6520  oes not include 
│ │ │ │ +00042ca0: 7468 6520 7465 726d 696e 6174 696e 670a  the terminating.
│ │ │ │ +00042cb0: 2020 2020 207a 6572 6f2e 0a0a 2020 2020       zero...    
│ │ │ │ +00042cc0: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ +00042cd0: 2052 6574 7572 6e73 2053 4849 5348 495f   Returns SHISHI_
│ │ │ │ +00042ce0: 4f4b 2069 6666 2073 7563 6365 7373 6675  OK iff successfu
│ │ │ │ +00042cf0: 6c2e 0a0a 7368 6973 6869 5f74 6b74 5f63  l...shishi_tkt_c
│ │ │ │ +00042d00: 6c69 656e 745f 700a 2d2d 2d2d 2d2d 2d2d  lient_p.--------
│ │ │ │ +00042d10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ +00042d20: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ +00042d30: 6869 7368 695f 746b 745f 636c 6965 6e74  hishi_tkt_client
│ │ │ │ +00042d40: 5f70 2028 5368 6973 6869 5f74 6b74 202a  _p (Shishi_tkt *
│ │ │ │ +00042d50: 2054 4b54 2c0a 2020 2020 2020 2020 2020   TKT,.          
│ │ │ │ +00042d60: 636f 6e73 7420 6368 6172 202a 2043 4c49  const char * CLI
│ │ │ │ +00042d70: 454e 5429 0a20 2020 2020 544b 543a 2069  ENT).     TKT: i
│ │ │ │ +00042d80: 6e70 7574 2076 6172 6961 626c 6520 7769  nput variable wi
│ │ │ │ +00042d90: 7468 2074 6963 6b65 7420 696e 666f 2e0a  th ticket info..
│ │ │ │ +00042da0: 2020 2020 2043 4c49 454e 543a 2063 6c69       CLIENT: cli
│ │ │ │ +00042db0: 656e 7420 6e61 6d65 206f 6620 7469 636b  ent name of tick
│ │ │ │ +00042dc0: 6574 2e0a 0a20 2020 2020 2a44 6573 6372  et...     *Descr
│ │ │ │ +00042dd0: 6970 7469 6f6e 3a2a 2044 6574 6572 6d69  iption:* Determi
│ │ │ │ +00042de0: 6e65 2069 6620 7469 636b 6574 2069 7320  ne if ticket is 
│ │ │ │ +00042df0: 666f 7220 7370 6563 6966 6965 6420 636c  for specified cl
│ │ │ │ +00042e00: 6965 6e74 2e0a 0a20 2020 2020 2a52 6574  ient...     *Ret
│ │ │ │ +00042e10: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ +00042e20: 726e 7320 6e6f 6e2d 3020 6966 6620 7469  rns non-0 iff ti
│ │ │ │ +00042e30: 636b 6574 2069 7320 666f 7220 7370 6563  cket is for spec
│ │ │ │ +00042e40: 6966 6965 6420 636c 6965 6e74 2e0a 0a73  ified client...s
│ │ │ │ +00042e50: 6869 7368 695f 746b 745f 636c 6965 6e74  hishi_tkt_client
│ │ │ │ +00042e60: 7265 616c 6d0a 2d2d 2d2d 2d2d 2d2d 2d2d  realm.----------
│ │ │ │ +00042e70: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ +00042e80: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ +00042e90: 7368 6973 6869 5f74 6b74 5f63 6c69 656e  shishi_tkt_clien
│ │ │ │ +00042ea0: 7472 6561 6c6d 2028 5368 6973 6869 5f74  trealm (Shishi_t
│ │ │ │ +00042eb0: 6b74 202a 2054 4b54 2c0a 2020 2020 2020  kt * TKT,.      
│ │ │ │ +00042ec0: 2020 2020 6368 6172 202a 2a20 434c 4945      char ** CLIE
│ │ │ │ +00042ed0: 4e54 2c20 7369 7a65 5f74 202a 2043 4c49  NT, size_t * CLI
│ │ │ │ +00042ee0: 454e 544c 454e 290a 2020 2020 2054 4b54  ENTLEN).     TKT
│ │ │ │ +00042ef0: 3a20 696e 7075 7420 7661 7269 6162 6c65  : input variable
│ │ │ │ +00042f00: 2077 6974 6820 7469 636b 6574 2069 6e66   with ticket inf
│ │ │ │ +00042f10: 6f2e 0a20 2020 2020 434c 4945 4e54 3a20  o..     CLIENT: 
│ │ │ │ +00042f20: 706f 696e 7465 7220 746f 206e 6577 6c79  pointer to newly
│ │ │ │ +00042f30: 2061 6c6c 6f63 6174 6564 207a 6572 6f20   allocated zero 
│ │ │ │ +00042f40: 7465 726d 696e 6174 6564 2073 7472 696e  terminated strin
│ │ │ │ +00042f50: 670a 2020 2020 2063 6f6e 7461 696e 696e  g.     containin
│ │ │ │ +00042f60: 6720 7072 696e 6369 7061 6c20 6e61 6d65  g principal name
│ │ │ │ +00042f70: 2061 6e64 2072 6561 6c6d 2e20 204d 6179   and realm.  May
│ │ │ │ +00042f80: 2062 6520 e280 984e 554c 4ce2 8099 2028   be ...NULL... (
│ │ │ │ +00042f90: 746f 206f 6e6c 790a 2020 2020 2070 6f70  to only.     pop
│ │ │ │ +00042fa0: 756c 6174 6520 434c 4945 4e54 4c45 4e29  ulate CLIENTLEN)
│ │ │ │ +00042fb0: 2e0a 2020 2020 2043 4c49 454e 544c 454e  ..     CLIENTLEN
│ │ │ │ +00042fc0: 3a20 706f 696e 7465 7220 746f 206c 656e  : pointer to len
│ │ │ │ +00042fd0: 6774 6820 6f66 2043 4c49 454e 5420 6f6e  gth of CLIENT on
│ │ │ │ +00042fe0: 206f 7574 7075 742c 2065 7863 6c75 6469   output, excludi
│ │ │ │ +00042ff0: 6e67 0a20 2020 2020 7465 726d 696e 6174  ng.     terminat
│ │ │ │ +00043000: 696e 6720 7a65 726f 2e20 204d 6179 2062  ing zero.  May b
│ │ │ │ +00043010: 6520 e280 984e 554c 4ce2 8099 2028 746f  e ...NULL... (to
│ │ │ │ +00043020: 206f 6e6c 7920 706f 7075 6c61 7465 2043   only populate C
│ │ │ │ +00043030: 4c49 454e 5429 2e0a 0a20 2020 2020 2a44  LIENT)...     *D
│ │ │ │ +00043040: 6573 6372 6970 7469 6f6e 3a2a 2043 6f6e  escription:* Con
│ │ │ │ +00043050: 7665 7274 2063 6e61 6d65 2061 6e64 2072  vert cname and r
│ │ │ │ +00043060: 6561 6c6d 2066 6965 6c64 7320 6672 6f6d  ealm fields from
│ │ │ │ +00043070: 2041 532d 5245 5120 746f 0a20 2020 2020   AS-REQ to.     
│ │ │ │ +00043080: 7072 696e 7461 626c 6520 7072 696e 6369  printable princi
│ │ │ │ +00043090: 7061 6c20 6e61 6d65 2066 6f72 6d61 742e  pal name format.
│ │ │ │ +000430a0: 2020 5468 6520 7374 7269 6e67 2069 7320    The string is 
│ │ │ │ +000430b0: 616c 6c6f 6361 7465 2062 7920 7468 6973  allocate by this
│ │ │ │ +000430c0: 0a20 2020 2020 6675 6e63 7469 6f6e 2c20  .     function, 
│ │ │ │ +000430d0: 616e 6420 6974 2069 7320 7468 6520 7265  and it is the re
│ │ │ │ +000430e0: 7370 6f6e 7369 6269 6c69 7479 206f 6620  sponsibility of 
│ │ │ │ +000430f0: 7468 6520 6361 6c6c 6572 2074 6f20 6465  the caller to de
│ │ │ │ +00043100: 616c 6c6f 6361 7465 0a20 2020 2020 6974  allocate.     it
│ │ │ │ +00043110: 2e20 204e 6f74 6520 7468 6174 2074 6865  .  Note that the
│ │ │ │ +00043120: 206f 7574 7075 7420 6c65 6e67 7468 2043   output length C
│ │ │ │ +00043130: 4c49 454e 544c 454e 2064 6f65 7320 6e6f  LIENTLEN does no
│ │ │ │ +00043140: 7420 696e 636c 7564 6520 7468 650a 2020  t include the.  
│ │ │ │ +00043150: 2020 2074 6572 6d69 6e61 7469 6e67 207a     terminating z
│ │ │ │ +00043160: 6572 6f2e 0a0a 2020 2020 202a 5265 7475  ero...     *Retu
│ │ │ │ +00043170: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ +00043180: 6e73 2053 4849 5348 495f 4f4b 2069 6666  ns SHISHI_OK iff
│ │ │ │ +00043190: 2073 7563 6365 7373 6675 6c2e 0a0a 7368   successful...sh
│ │ │ │ +000431a0: 6973 6869 5f74 6b74 5f63 6c69 656e 7472  ishi_tkt_clientr
│ │ │ │ +000431b0: 6561 6c6d 5f70 0a2d 2d2d 2d2d 2d2d 2d2d  ealm_p.---------
│ │ │ │ +000431c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +000431d0: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ +000431e0: 6e74 2073 6869 7368 695f 746b 745f 636c  nt shishi_tkt_cl
│ │ │ │ +000431f0: 6965 6e74 7265 616c 6d5f 7020 2853 6869  ientrealm_p (Shi
│ │ │ │ +00043200: 7368 695f 746b 7420 2a20 544b 542c 0a20  shi_tkt * TKT,. 
│ │ │ │ +00043210: 2020 2020 2020 2020 2063 6f6e 7374 2063           const c
│ │ │ │ +00043220: 6861 7220 2a20 434c 4945 4e54 290a 2020  har * CLIENT).  
│ │ │ │ +00043230: 2020 2054 4b54 3a20 696e 7075 7420 7661     TKT: input va
│ │ │ │ +00043240: 7269 6162 6c65 2077 6974 6820 7469 636b  riable with tick
│ │ │ │ +00043250: 6574 2069 6e66 6f2e 0a20 2020 2020 434c  et info..     CL
│ │ │ │ +00043260: 4945 4e54 3a20 7072 696e 6369 7061 6c20  IENT: principal 
│ │ │ │ +00043270: 6e61 6d65 2028 636c 6965 6e74 206e 616d  name (client nam
│ │ │ │ +00043280: 6520 616e 6420 7265 616c 6d29 206f 6620  e and realm) of 
│ │ │ │ +00043290: 7469 636b 6574 2e0a 0a20 2020 2020 2a44  ticket...     *D
│ │ │ │ +000432a0: 6573 6372 6970 7469 6f6e 3a2a 2044 6574  escription:* Det
│ │ │ │ +000432b0: 6572 6d69 6e65 2069 6620 7469 636b 6574  ermine if ticket
│ │ │ │ +000432c0: 2069 7320 666f 7220 7370 6563 6966 6965   is for specifie
│ │ │ │ +000432d0: 6420 636c 6965 6e74 0a20 2020 2020 7072  d client.     pr
│ │ │ │ +000432e0: 696e 6369 7061 6c2e 0a0a 2020 2020 202a  incipal...     *
│ │ │ │ +000432f0: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ +00043300: 6574 7572 6e73 206e 6f6e 2d30 2069 6666  eturns non-0 iff
│ │ │ │ +00043310: 2074 6963 6b65 7420 6973 2066 6f72 2073   ticket is for s
│ │ │ │ +00043320: 7065 6369 6669 6564 2063 6c69 656e 740a  pecified client.
│ │ │ │ +00043330: 2020 2020 2070 7269 6e63 6970 616c 2e0a       principal..
│ │ │ │ +00043340: 0a73 6869 7368 695f 746b 745f 7265 616c  .shishi_tkt_real
│ │ │ │ +00043350: 6d0a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  m.--------------
│ │ │ │ +00043360: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ +00043370: 3a20 696e 7420 7368 6973 6869 5f74 6b74  : int shishi_tkt
│ │ │ │ +00043380: 5f72 6561 6c6d 2028 5368 6973 6869 5f74  _realm (Shishi_t
│ │ │ │ +00043390: 6b74 202a 2054 4b54 2c20 6368 6172 202a  kt * TKT, char *
│ │ │ │ +000433a0: 2a20 5245 414c 4d2c 0a20 2020 2020 2020  * REALM,.       
│ │ │ │ +000433b0: 2020 2073 697a 655f 7420 2a20 5245 414c     size_t * REAL
│ │ │ │ +000433c0: 4d4c 454e 290a 2020 2020 2054 4b54 3a20  MLEN).     TKT: 
│ │ │ │ +000433d0: 696e 7075 7420 7661 7269 6162 6c65 2077  input variable w
│ │ │ │ +000433e0: 6974 6820 7469 636b 6574 2069 6e66 6f2e  ith ticket info.
│ │ │ │ +000433f0: 0a20 2020 2020 5245 414c 4d3a 2070 6f69  .     REALM: poi
│ │ │ │ +00043400: 6e74 6572 2074 6f20 6e65 776c 7920 616c  nter to newly al
│ │ │ │ +00043410: 6c6f 6361 7465 6420 6368 6172 6163 7465  located characte
│ │ │ │ +00043420: 7220 6172 7261 7920 7769 7468 2072 6561  r array with rea
│ │ │ │ +00043430: 6c6d 206e 616d 652e 0a0a 2020 2020 2052  lm name...     R
│ │ │ │ +00043440: 4541 4c4d 4c45 4e3a 206c 656e 6774 6820  EALMLEN: length 
│ │ │ │ +00043450: 6f66 206e 6577 6c79 2061 6c6c 6f63 6174  of newly allocat
│ │ │ │ +00043460: 6564 2063 6861 7261 6374 6572 2061 7272  ed character arr
│ │ │ │ +00043470: 6179 2077 6974 6820 7265 616c 6d0a 2020  ay with realm.  
│ │ │ │ +00043480: 2020 206e 616d 652e 0a0a 2020 2020 202a     name...     *
│ │ │ │ +00043490: 4465 7363 7269 7074 696f 6e3a 2a20 4578  Description:* Ex
│ │ │ │ +000434a0: 7472 6163 7420 7265 616c 6d20 6f66 2073  tract realm of s
│ │ │ │ +000434b0: 6572 7665 7220 696e 2074 6963 6b65 742e  erver in ticket.
│ │ │ │ +000434c0: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ +000434d0: 616c 7565 3a2a 2052 6574 7572 6e73 2053  alue:* Returns S
│ │ │ │ +000434e0: 4849 5348 495f 4f4b 2069 6666 2073 7563  HISHI_OK iff suc
│ │ │ │ +000434f0: 6365 7373 6675 6c2e 0a0a 7368 6973 6869  cessful...shishi
│ │ │ │ +00043500: 5f74 6b74 5f73 6572 7665 720a 2d2d 2d2d  _tkt_server.----
│ │ │ │ +00043510: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ +00043520: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ +00043530: 2073 6869 7368 695f 746b 745f 7365 7276   shishi_tkt_serv
│ │ │ │ +00043540: 6572 2028 5368 6973 6869 5f74 6b74 202a  er (Shishi_tkt *
│ │ │ │ +00043550: 2054 4b54 2c20 6368 6172 202a 2a20 5345   TKT, char ** SE
│ │ │ │ +00043560: 5256 4552 2c0a 2020 2020 2020 2020 2020  RVER,.          
│ │ │ │ +00043570: 7369 7a65 5f74 202a 2053 4552 5645 524c  size_t * SERVERL
│ │ │ │ +00043580: 454e 290a 2020 2020 2054 4b54 3a20 696e  EN).     TKT: in
│ │ │ │ +00043590: 7075 7420 7661 7269 6162 6c65 2077 6974  put variable wit
│ │ │ │ +000435a0: 6820 7469 636b 6574 2069 6e66 6f2e 0a20  h ticket info.. 
│ │ │ │ +000435b0: 2020 2020 5345 5256 4552 3a20 706f 696e      SERVER: poin
│ │ │ │ +000435c0: 7465 7220 746f 206e 6577 6c79 2061 6c6c  ter to newly all
│ │ │ │ +000435d0: 6f63 6174 6564 207a 6572 6f20 7465 726d  ocated zero term
│ │ │ │ +000435e0: 696e 6174 6564 2073 7472 696e 670a 2020  inated string.  
│ │ │ │ +000435f0: 2020 2063 6f6e 7461 696e 696e 6720 7072     containing pr
│ │ │ │ +00043600: 696e 6369 7061 6c20 6e61 6d65 2e20 204d  incipal name.  M
│ │ │ │ +00043610: 6179 2062 6520 e280 984e 554c 4ce2 8099  ay be ...NULL...
│ │ │ │ +00043620: 2028 746f 206f 6e6c 7920 706f 7075 6c61   (to only popula
│ │ │ │ +00043630: 7465 0a20 2020 2020 5345 5256 4552 4c45  te.     SERVERLE
│ │ │ │ +00043640: 4e29 2e0a 2020 2020 2053 4552 5645 524c  N)..     SERVERL
│ │ │ │ +00043650: 454e 3a20 706f 696e 7465 7220 746f 206c  EN: pointer to l
│ │ │ │ +00043660: 656e 6774 6820 6f66 2053 4552 5645 5220  ength of SERVER 
│ │ │ │ +00043670: 6f6e 206f 7574 7075 742c 2065 7863 6c75  on output, exclu
│ │ │ │ +00043680: 6469 6e67 0a20 2020 2020 7465 726d 696e  ding.     termin
│ │ │ │ +00043690: 6174 696e 6720 7a65 726f 2e20 204d 6179  ating zero.  May
│ │ │ │ +000436a0: 2062 6520 e280 984e 554c 4ce2 8099 2028   be ...NULL... (
│ │ │ │ +000436b0: 746f 206f 6e6c 7920 706f 7075 6c61 7465  to only populate
│ │ │ │ +000436c0: 2053 4552 5645 5229 2e0a 0a20 2020 2020   SERVER)...     
│ │ │ │ +000436d0: 2a44 6573 6372 6970 7469 6f6e 3a2a 2052  *Description:* R
│ │ │ │ +000436e0: 6570 7265 7365 6e74 2073 6572 7665 7220  epresent server 
│ │ │ │ +000436f0: 7072 696e 6369 7061 6c20 6e61 6d65 2069  principal name i
│ │ │ │ +00043700: 6e20 5469 636b 6574 2061 730a 2020 2020  n Ticket as.    
│ │ │ │ +00043710: 207a 6572 6f2d 7465 726d 696e 6174 6564   zero-terminated
│ │ │ │ +00043720: 2073 7472 696e 672e 2020 5468 6520 7374   string.  The st
│ │ │ │ +00043730: 7269 6e67 2069 7320 616c 6c6f 6361 7465  ring is allocate
│ │ │ │ +00043740: 2062 7920 7468 6973 2066 756e 6374 696f   by this functio
│ │ │ │ +00043750: 6e2c 0a20 2020 2020 616e 6420 6974 2069  n,.     and it i
│ │ │ │ +00043760: 7320 7468 6520 7265 7370 6f6e 7369 6269  s the responsibi
│ │ │ │ +00043770: 6c69 7479 206f 6620 7468 6520 6361 6c6c  lity of the call
│ │ │ │ +00043780: 6572 2074 6f20 6465 616c 6c6f 6361 7465  er to deallocate
│ │ │ │ +00043790: 2069 742e 2020 4e6f 7465 0a20 2020 2020   it.  Note.     
│ │ │ │ +000437a0: 7468 6174 2074 6865 206f 7574 7075 7420  that the output 
│ │ │ │ +000437b0: 6c65 6e67 7468 2053 4552 5645 524c 454e  length SERVERLEN
│ │ │ │ +000437c0: 2064 6f65 7320 6e6f 7420 696e 636c 7564   does not includ
│ │ │ │ +000437d0: 6520 7468 6520 7465 726d 696e 6174 696e  e the terminatin
│ │ │ │ +000437e0: 670a 2020 2020 207a 6572 6f2e 0a0a 2020  g.     zero...  
│ │ │ │ +000437f0: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ +00043800: 3a2a 2052 6574 7572 6e73 2053 4849 5348  :* Returns SHISH
│ │ │ │ +00043810: 495f 4f4b 2069 6666 2073 7563 6365 7373  I_OK iff success
│ │ │ │ +00043820: 6675 6c2e 0a0a 7368 6973 6869 5f74 6b74  ful...shishi_tkt
│ │ │ │ +00043830: 5f73 6572 7665 725f 700a 2d2d 2d2d 2d2d  _server_p.------
│ │ │ │ +00043840: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ +00043850: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ +00043860: 2073 6869 7368 695f 746b 745f 7365 7276   shishi_tkt_serv
│ │ │ │ +00043870: 6572 5f70 2028 5368 6973 6869 5f74 6b74  er_p (Shishi_tkt
│ │ │ │ +00043880: 202a 2054 4b54 2c0a 2020 2020 2020 2020   * TKT,.        
│ │ │ │ +00043890: 2020 636f 6e73 7420 6368 6172 202a 2053    const char * S
│ │ │ │ +000438a0: 4552 5645 5229 0a20 2020 2020 544b 543a  ERVER).     TKT:
│ │ │ │ +000438b0: 2069 6e70 7574 2076 6172 6961 626c 6520   input variable 
│ │ │ │ +000438c0: 7769 7468 2074 6963 6b65 7420 696e 666f  with ticket info
│ │ │ │ +000438d0: 2e0a 2020 2020 2053 4552 5645 523a 2073  ..     SERVER: s
│ │ │ │ +000438e0: 6572 7665 7220 6e61 6d65 206f 6620 7469  erver name of ti
│ │ │ │ +000438f0: 636b 6574 2e0a 0a20 2020 2020 2a44 6573  cket...     *Des
│ │ │ │ +00043900: 6372 6970 7469 6f6e 3a2a 2044 6574 6572  cription:* Deter
│ │ │ │ +00043910: 6d69 6e65 2069 6620 7469 636b 6574 2069  mine if ticket i
│ │ │ │ +00043920: 7320 666f 7220 7370 6563 6966 6965 6420  s for specified 
│ │ │ │ +00043930: 7365 7276 6572 2e0a 0a20 2020 2020 2a52  server...     *R
│ │ │ │ +00043940: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +00043950: 7475 726e 7320 6e6f 6e2d 3020 6966 6620  turns non-0 iff 
│ │ │ │ +00043960: 7469 636b 6574 2069 7320 666f 7220 7370  ticket is for sp
│ │ │ │ +00043970: 6563 6966 6965 6420 7365 7276 6572 2e0a  ecified server..
│ │ │ │ +00043980: 0a73 6869 7368 695f 746b 745f 666c 6167  .shishi_tkt_flag
│ │ │ │ +00043990: 730a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  s.--------------
│ │ │ │ +000439a0: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ +000439b0: 3a20 696e 7420 7368 6973 6869 5f74 6b74  : int shishi_tkt
│ │ │ │ +000439c0: 5f66 6c61 6773 2028 5368 6973 6869 5f74  _flags (Shishi_t
│ │ │ │ +000439d0: 6b74 202a 2054 4b54 2c20 7569 6e74 3332  kt * TKT, uint32
│ │ │ │ +000439e0: 5f74 202a 2046 4c41 4753 290a 2020 2020  _t * FLAGS).    
│ │ │ │ +000439f0: 2054 4b54 3a20 696e 7075 7420 7661 7269   TKT: input vari
│ │ │ │ +00043a00: 6162 6c65 2077 6974 6820 7469 636b 6574  able with ticket
│ │ │ │ +00043a10: 2069 6e66 6f2e 0a20 2020 2020 464c 4147   info..     FLAG
│ │ │ │ +00043a20: 533a 2070 6f69 6e74 6572 2074 6f20 6f75  S: pointer to ou
│ │ │ │ +00043a30: 7470 7574 2069 6e74 6567 6572 2077 6974  tput integer wit
│ │ │ │ +00043a40: 6820 666c 6167 732e 0a0a 2020 2020 202a  h flags...     *
│ │ │ │ +00043a50: 4465 7363 7269 7074 696f 6e3a 2a20 4578  Description:* Ex
│ │ │ │ +00043a60: 7472 6163 7420 666c 6167 7320 696e 2074  tract flags in t
│ │ │ │ +00043a70: 6963 6b65 7420 2869 2e65 2e2c 2045 6e63  icket (i.e., Enc
│ │ │ │ +00043a80: 4b44 4352 6570 5061 7274 292e 0a0a 2020  KDCRepPart)...  
│ │ │ │ +00043a90: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ +00043aa0: 3a2a 2052 6574 7572 6e73 2053 4849 5348  :* Returns SHISH
│ │ │ │ +00043ab0: 495f 4f4b 2069 6666 2073 7563 6365 7373  I_OK iff success
│ │ │ │ +00043ac0: 6675 6c2e 0a0a 7368 6973 6869 5f74 6b74  ful...shishi_tkt
│ │ │ │ +00043ad0: 5f66 6c61 6773 5f73 6574 0a2d 2d2d 2d2d  _flags_set.-----
│ │ │ │ +00043ae0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +00043af0: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ +00043b00: 6e74 2073 6869 7368 695f 746b 745f 666c  nt shishi_tkt_fl
│ │ │ │ +00043b10: 6167 735f 7365 7420 2853 6869 7368 695f  ags_set (Shishi_
│ │ │ │ +00043b20: 746b 7420 2a20 544b 542c 0a20 2020 2020  tkt * TKT,.     
│ │ │ │ +00043b30: 2020 2020 2075 696e 7433 325f 7420 464c       uint32_t FL
│ │ │ │ +00043b40: 4147 5329 0a20 2020 2020 544b 543a 2069  AGS).     TKT: i
│ │ │ │ +00043b50: 6e70 7574 2076 6172 6961 626c 6520 7769  nput variable wi
│ │ │ │ +00043b60: 7468 2074 6963 6b65 7420 696e 666f 2e0a  th ticket info..
│ │ │ │ +00043b70: 2020 2020 2046 4c41 4753 3a20 696e 7465       FLAGS: inte
│ │ │ │ +00043b80: 6765 7220 7769 7468 2066 6c61 6773 2074  ger with flags t
│ │ │ │ +00043b90: 6f20 7374 6f72 6520 696e 2074 6963 6b65  o store in ticke
│ │ │ │ +00043ba0: 742e 0a0a 2020 2020 202a 4465 7363 7269  t...     *Descri
│ │ │ │ +00043bb0: 7074 696f 6e3a 2a20 5365 7420 666c 6167  ption:* Set flag
│ │ │ │ +00043bc0: 7320 696e 2074 6963 6b65 742c 2069 2e65  s in ticket, i.e
│ │ │ │ +00043bd0: 2e2c 2062 6f74 6820 456e 6354 6963 6b65  ., both EncTicke
│ │ │ │ +00043be0: 7450 6172 7420 616e 640a 2020 2020 2045  tPart and.     E
│ │ │ │ +00043bf0: 6e63 4b44 4352 6570 5061 7274 2e20 204e  ncKDCRepPart.  N
│ │ │ │ +00043c00: 6f74 6520 7468 6174 2074 6869 7320 7265  ote that this re
│ │ │ │ +00043c10: 7365 7420 616e 7920 616c 7265 6164 7920  set any already 
│ │ │ │ +00043c20: 6578 6973 7469 6e67 2066 6c61 6773 2e0a  existing flags..
│ │ │ │ +00043c30: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ +00043c40: 6c75 653a 2a20 5265 7475 726e 7320 5348  lue:* Returns SH
│ │ │ │ +00043c50: 4953 4849 5f4f 4b20 6966 6620 7375 6363  ISHI_OK iff succ
│ │ │ │ +00043c60: 6573 7366 756c 2e0a 0a73 6869 7368 695f  essful...shishi_
│ │ │ │ +00043c70: 746b 745f 666c 6167 735f 6164 640a 2d2d  tkt_flags_add.--
│ │ │ │  00043c80: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00043c90: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ -00043ca0: 696e 7420 7368 6973 6869 5f74 6b74 5f66  int shishi_tkt_f
│ │ │ │ -00043cb0: 6c61 6773 5f61 6464 2028 5368 6973 6869  lags_add (Shishi
│ │ │ │ -00043cc0: 5f74 6b74 202a 2054 4b54 2c20 7569 6e74  _tkt * TKT, uint
│ │ │ │ -00043cd0: 3332 5f74 2046 4c41 4729 0a20 2020 2020  32_t FLAG).     
│ │ │ │ -00043ce0: 544b 543a 2069 6e70 7574 2076 6172 6961  TKT: input varia
│ │ │ │ -00043cf0: 626c 6520 7769 7468 2074 6963 6b65 7420  ble with ticket 
│ │ │ │ -00043d00: 696e 666f 2e0a 2020 2020 2046 4c41 473a  info..     FLAG:
│ │ │ │ -00043d10: 2069 6e74 6567 6572 2077 6974 6820 666c   integer with fl
│ │ │ │ -00043d20: 6167 7320 746f 2073 746f 7265 2069 6e20  ags to store in 
│ │ │ │ -00043d30: 7469 636b 6574 2e0a 0a20 2020 2020 2a44  ticket...     *D
│ │ │ │ -00043d40: 6573 6372 6970 7469 6f6e 3a2a 2041 6464  escription:* Add
│ │ │ │ -00043d50: 2074 6963 6b65 7420 666c 6167 7320 746f   ticket flags to
│ │ │ │ -00043d60: 2054 6963 6b65 7420 616e 6420 456e 634b   Ticket and EncK
│ │ │ │ -00043d70: 4443 5265 7050 6172 742e 2020 5468 6973  DCRepPart.  This
│ │ │ │ -00043d80: 0a20 2020 2020 7072 6573 6572 7665 7320  .     preserves 
│ │ │ │ -00043d90: 616c 6c20 6578 6973 7469 6e67 206f 7074  all existing opt
│ │ │ │ -00043da0: 696f 6e73 2e0a 0a20 2020 2020 2a52 6574  ions...     *Ret
│ │ │ │ -00043db0: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ -00043dc0: 726e 7320 5348 4953 4849 5f4f 4b20 6966  rns SHISHI_OK if
│ │ │ │ -00043dd0: 6620 7375 6363 6573 7366 756c 2e0a 0a73  f successful...s
│ │ │ │ -00043de0: 6869 7368 695f 746b 745f 666f 7277 6172  hishi_tkt_forwar
│ │ │ │ -00043df0: 6461 626c 655f 700a 2d2d 2d2d 2d2d 2d2d  dable_p.--------
│ │ │ │ +00043c90: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ +00043ca0: 3a20 696e 7420 7368 6973 6869 5f74 6b74  : int shishi_tkt
│ │ │ │ +00043cb0: 5f66 6c61 6773 5f61 6464 2028 5368 6973  _flags_add (Shis
│ │ │ │ +00043cc0: 6869 5f74 6b74 202a 2054 4b54 2c20 7569  hi_tkt * TKT, ui
│ │ │ │ +00043cd0: 6e74 3332 5f74 2046 4c41 4729 0a20 2020  nt32_t FLAG).   
│ │ │ │ +00043ce0: 2020 544b 543a 2069 6e70 7574 2076 6172    TKT: input var
│ │ │ │ +00043cf0: 6961 626c 6520 7769 7468 2074 6963 6b65  iable with ticke
│ │ │ │ +00043d00: 7420 696e 666f 2e0a 2020 2020 2046 4c41  t info..     FLA
│ │ │ │ +00043d10: 473a 2069 6e74 6567 6572 2077 6974 6820  G: integer with 
│ │ │ │ +00043d20: 666c 6167 7320 746f 2073 746f 7265 2069  flags to store i
│ │ │ │ +00043d30: 6e20 7469 636b 6574 2e0a 0a20 2020 2020  n ticket...     
│ │ │ │ +00043d40: 2a44 6573 6372 6970 7469 6f6e 3a2a 2041  *Description:* A
│ │ │ │ +00043d50: 6464 2074 6963 6b65 7420 666c 6167 7320  dd ticket flags 
│ │ │ │ +00043d60: 746f 2054 6963 6b65 7420 616e 6420 456e  to Ticket and En
│ │ │ │ +00043d70: 634b 4443 5265 7050 6172 742e 2020 5468  cKDCRepPart.  Th
│ │ │ │ +00043d80: 6973 0a20 2020 2020 7072 6573 6572 7665  is.     preserve
│ │ │ │ +00043d90: 7320 616c 6c20 6578 6973 7469 6e67 206f  s all existing o
│ │ │ │ +00043da0: 7074 696f 6e73 2e0a 0a20 2020 2020 2a52  ptions...     *R
│ │ │ │ +00043db0: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +00043dc0: 7475 726e 7320 5348 4953 4849 5f4f 4b20  turns SHISHI_OK 
│ │ │ │ +00043dd0: 6966 6620 7375 6363 6573 7366 756c 2e0a  iff successful..
│ │ │ │ +00043de0: 0a73 6869 7368 695f 746b 745f 666f 7277  .shishi_tkt_forw
│ │ │ │ +00043df0: 6172 6461 626c 655f 700a 2d2d 2d2d 2d2d  ardable_p.------
│ │ │ │  00043e00: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00043e10: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ -00043e20: 696e 7420 7368 6973 6869 5f74 6b74 5f66  int shishi_tkt_f
│ │ │ │ -00043e30: 6f72 7761 7264 6162 6c65 5f70 2028 5368  orwardable_p (Sh
│ │ │ │ -00043e40: 6973 6869 5f74 6b74 202a 2054 4b54 290a  ishi_tkt * TKT).
│ │ │ │ -00043e50: 2020 2020 2054 4b54 3a20 696e 7075 7420       TKT: input 
│ │ │ │ -00043e60: 7661 7269 6162 6c65 2077 6974 6820 7469  variable with ti
│ │ │ │ -00043e70: 636b 6574 2069 6e66 6f2e 0a0a 2020 2020  cket info...    
│ │ │ │ -00043e80: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ -00043e90: 4465 7465 726d 696e 6520 6966 2074 6963  Determine if tic
│ │ │ │ -00043ea0: 6b65 7420 6973 2066 6f72 7761 7264 6162  ket is forwardab
│ │ │ │ -00043eb0: 6c65 2e0a 0a20 2020 2020 5468 6520 464f  le...     The FO
│ │ │ │ -00043ec0: 5257 4152 4441 424c 4520 666c 6167 2069  RWARDABLE flag i
│ │ │ │ -00043ed0: 6e20 6120 7469 636b 6574 2069 7320 6e6f  n a ticket is no
│ │ │ │ -00043ee0: 726d 616c 6c79 206f 6e6c 7920 696e 7465  rmally only inte
│ │ │ │ -00043ef0: 7270 7265 7465 6420 6279 0a20 2020 2020  rpreted by.     
│ │ │ │ -00043f00: 7468 6520 7469 636b 6574 2d67 7261 6e74  the ticket-grant
│ │ │ │ -00043f10: 696e 6720 7365 7276 6963 652e 2020 4974  ing service.  It
│ │ │ │ -00043f20: 2063 616e 2062 6520 6967 6e6f 7265 6420   can be ignored 
│ │ │ │ -00043f30: 6279 2061 7070 6c69 6361 7469 6f6e 0a20  by application. 
│ │ │ │ -00043f40: 2020 2020 7365 7276 6572 732e 2020 5468      servers.  Th
│ │ │ │ -00043f50: 6520 464f 5257 4152 4441 424c 4520 666c  e FORWARDABLE fl
│ │ │ │ -00043f60: 6167 2068 6173 2061 6e20 696e 7465 7270  ag has an interp
│ │ │ │ -00043f70: 7265 7461 7469 6f6e 2073 696d 696c 6172  retation similar
│ │ │ │ -00043f80: 2074 6f0a 2020 2020 2074 6861 7420 6f66   to.     that of
│ │ │ │ -00043f90: 2074 6865 2050 524f 5849 4142 4c45 2066   the PROXIABLE f
│ │ │ │ -00043fa0: 6c61 672c 2065 7863 6570 7420 7469 636b  lag, except tick
│ │ │ │ -00043fb0: 6574 2d67 7261 6e74 696e 6720 7469 636b  et-granting tick
│ │ │ │ -00043fc0: 6574 7320 6d61 7920 616c 736f 0a20 2020  ets may also.   
│ │ │ │ -00043fd0: 2020 6265 2069 7373 7565 6420 7769 7468    be issued with
│ │ │ │ -00043fe0: 2064 6966 6665 7265 6e74 206e 6574 776f   different netwo
│ │ │ │ -00043ff0: 726b 2061 6464 7265 7373 6573 2e20 2054  rk addresses.  T
│ │ │ │ -00044000: 6869 7320 666c 6167 2069 7320 7265 7365  his flag is rese
│ │ │ │ -00044010: 7420 6279 0a20 2020 2020 6465 6661 756c  t by.     defaul
│ │ │ │ -00044020: 742c 2062 7574 2075 7365 7273 204d 4159  t, but users MAY
│ │ │ │ -00044030: 2072 6571 7565 7374 2074 6861 7420 6974   request that it
│ │ │ │ -00044040: 2062 6520 7365 7420 6279 2073 6574 7469   be set by setti
│ │ │ │ -00044050: 6e67 2074 6865 0a20 2020 2020 464f 5257  ng the.     FORW
│ │ │ │ -00044060: 4152 4441 424c 4520 6f70 7469 6f6e 2069  ARDABLE option i
│ │ │ │ -00044070: 6e20 7468 6520 4153 2072 6571 7565 7374  n the AS request
│ │ │ │ -00044080: 2077 6865 6e20 7468 6579 2072 6571 7565   when they reque
│ │ │ │ -00044090: 7374 2074 6865 6972 0a20 2020 2020 696e  st their.     in
│ │ │ │ -000440a0: 6974 6961 6c20 7469 636b 6574 2d67 7261  itial ticket-gra
│ │ │ │ -000440b0: 6e74 696e 6720 7469 636b 6574 2e0a 0a20  nting ticket... 
│ │ │ │ -000440c0: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ -000440d0: 653a 2a20 5265 7475 726e 7320 6e6f 6e2d  e:* Returns non-
│ │ │ │ -000440e0: 3020 6966 6620 666f 7277 6172 6461 626c  0 iff forwardabl
│ │ │ │ -000440f0: 6520 666c 6167 2069 7320 7365 7420 696e  e flag is set in
│ │ │ │ -00044100: 0a20 2020 2020 7469 636b 6574 2e0a 0a73  .     ticket...s
│ │ │ │ -00044110: 6869 7368 695f 746b 745f 666f 7277 6172  hishi_tkt_forwar
│ │ │ │ -00044120: 6465 645f 700a 2d2d 2d2d 2d2d 2d2d 2d2d  ded_p.----------
│ │ │ │ -00044130: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ -00044140: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ -00044150: 7368 6973 6869 5f74 6b74 5f66 6f72 7761  shishi_tkt_forwa
│ │ │ │ -00044160: 7264 6564 5f70 2028 5368 6973 6869 5f74  rded_p (Shishi_t
│ │ │ │ -00044170: 6b74 202a 2054 4b54 290a 2020 2020 2054  kt * TKT).     T
│ │ │ │ -00044180: 4b54 3a20 696e 7075 7420 7661 7269 6162  KT: input variab
│ │ │ │ -00044190: 6c65 2077 6974 6820 7469 636b 6574 2069  le with ticket i
│ │ │ │ -000441a0: 6e66 6f2e 0a0a 2020 2020 202a 4465 7363  nfo...     *Desc
│ │ │ │ -000441b0: 7269 7074 696f 6e3a 2a20 4465 7465 726d  ription:* Determ
│ │ │ │ -000441c0: 696e 6520 6966 2074 6963 6b65 7420 6973  ine if ticket is
│ │ │ │ -000441d0: 2066 6f72 7761 7264 6564 2e0a 0a20 2020   forwarded...   
│ │ │ │ -000441e0: 2020 5468 6520 464f 5257 4152 4445 4420    The FORWARDED 
│ │ │ │ -000441f0: 666c 6167 2069 7320 7365 7420 6279 2074  flag is set by t
│ │ │ │ -00044200: 6865 2054 4753 2077 6865 6e20 6120 636c  he TGS when a cl
│ │ │ │ -00044210: 6965 6e74 2070 7265 7365 6e74 7320 610a  ient presents a.
│ │ │ │ -00044220: 2020 2020 2074 6963 6b65 7420 7769 7468       ticket with
│ │ │ │ -00044230: 2074 6865 2046 4f52 5741 5244 4142 4c45   the FORWARDABLE
│ │ │ │ -00044240: 2066 6c61 6720 7365 7420 616e 6420 7265   flag set and re
│ │ │ │ -00044250: 7175 6573 7473 2061 2066 6f72 7761 7264  quests a forward
│ │ │ │ -00044260: 6564 0a20 2020 2020 7469 636b 6574 2062  ed.     ticket b
│ │ │ │ -00044270: 7920 7370 6563 6966 7969 6e67 2074 6865  y specifying the
│ │ │ │ -00044280: 2046 4f52 5741 5244 4544 204b 4443 206f   FORWARDED KDC o
│ │ │ │ -00044290: 7074 696f 6e20 616e 6420 7375 7070 6c79  ption and supply
│ │ │ │ -000442a0: 696e 6720 6120 7365 740a 2020 2020 206f  ing a set.     o
│ │ │ │ -000442b0: 6620 6164 6472 6573 7365 7320 666f 7220  f addresses for 
│ │ │ │ -000442c0: 7468 6520 6e65 7720 7469 636b 6574 2e20  the new ticket. 
│ │ │ │ -000442d0: 2049 7420 6973 2061 6c73 6f20 7365 7420   It is also set 
│ │ │ │ -000442e0: 696e 2061 6c6c 2074 6963 6b65 7473 0a20  in all tickets. 
│ │ │ │ -000442f0: 2020 2020 6973 7375 6564 2062 6173 6564      issued based
│ │ │ │ -00044300: 206f 6e20 7469 636b 6574 7320 7769 7468   on tickets with
│ │ │ │ -00044310: 2074 6865 2046 4f52 5741 5244 4544 2066   the FORWARDED f
│ │ │ │ -00044320: 6c61 6720 7365 742e 2020 4170 706c 6963  lag set.  Applic
│ │ │ │ -00044330: 6174 696f 6e0a 2020 2020 2073 6572 7665  ation.     serve
│ │ │ │ -00044340: 7273 206d 6179 2063 686f 6f73 6520 746f  rs may choose to
│ │ │ │ -00044350: 2070 726f 6365 7373 2046 4f52 5741 5244   process FORWARD
│ │ │ │ -00044360: 4544 2074 6963 6b65 7473 2064 6966 6665  ED tickets diffe
│ │ │ │ -00044370: 7265 6e74 6c79 2074 6861 6e0a 2020 2020  rently than.    
│ │ │ │ -00044380: 206e 6f6e 2d46 4f52 5741 5244 4544 2074   non-FORWARDED t
│ │ │ │ -00044390: 6963 6b65 7473 2e0a 0a20 2020 2020 2a52  ickets...     *R
│ │ │ │ -000443a0: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ -000443b0: 7475 726e 7320 6e6f 6e2d 3020 6966 6620  turns non-0 iff 
│ │ │ │ -000443c0: 666f 7277 6172 6465 6420 666c 6167 2069  forwarded flag i
│ │ │ │ -000443d0: 7320 7365 7420 696e 2074 6963 6b65 742e  s set in ticket.
│ │ │ │ -000443e0: 0a0a 7368 6973 6869 5f74 6b74 5f70 726f  ..shishi_tkt_pro
│ │ │ │ -000443f0: 7869 6162 6c65 5f70 0a2d 2d2d 2d2d 2d2d  xiable_p.-------
│ │ │ │ -00044400: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -00044410: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ -00044420: 6e74 2073 6869 7368 695f 746b 745f 7072  nt shishi_tkt_pr
│ │ │ │ -00044430: 6f78 6961 626c 655f 7020 2853 6869 7368  oxiable_p (Shish
│ │ │ │ -00044440: 695f 746b 7420 2a20 544b 5429 0a20 2020  i_tkt * TKT).   
│ │ │ │ -00044450: 2020 544b 543a 2069 6e70 7574 2076 6172    TKT: input var
│ │ │ │ -00044460: 6961 626c 6520 7769 7468 2074 6963 6b65  iable with ticke
│ │ │ │ -00044470: 7420 696e 666f 2e0a 0a20 2020 2020 2a44  t info...     *D
│ │ │ │ -00044480: 6573 6372 6970 7469 6f6e 3a2a 2044 6574  escription:* Det
│ │ │ │ -00044490: 6572 6d69 6e65 2069 6620 7469 636b 6574  ermine if ticket
│ │ │ │ -000444a0: 2069 7320 7072 6f78 6961 626c 652e 0a0a   is proxiable...
│ │ │ │ -000444b0: 2020 2020 2054 6865 2050 524f 5849 4142       The PROXIAB
│ │ │ │ -000444c0: 4c45 2066 6c61 6720 696e 2061 2074 6963  LE flag in a tic
│ │ │ │ -000444d0: 6b65 7420 6973 206e 6f72 6d61 6c6c 7920  ket is normally 
│ │ │ │ -000444e0: 6f6e 6c79 2069 6e74 6572 7072 6574 6564  only interpreted
│ │ │ │ -000444f0: 2062 7920 7468 650a 2020 2020 2074 6963   by the.     tic
│ │ │ │ -00044500: 6b65 742d 6772 616e 7469 6e67 2073 6572  ket-granting ser
│ │ │ │ -00044510: 7669 6365 2e20 2049 7420 6361 6e20 6265  vice.  It can be
│ │ │ │ -00044520: 2069 676e 6f72 6564 2062 7920 6170 706c   ignored by appl
│ │ │ │ -00044530: 6963 6174 696f 6e20 7365 7276 6572 732e  ication servers.
│ │ │ │ -00044540: 0a20 2020 2020 5768 656e 2073 6574 2c20  .     When set, 
│ │ │ │ -00044550: 7468 6973 2066 6c61 6720 7465 6c6c 7320  this flag tells 
│ │ │ │ -00044560: 7468 6520 7469 636b 6574 2d67 7261 6e74  the ticket-grant
│ │ │ │ -00044570: 696e 6720 7365 7276 6572 2074 6861 7420  ing server that 
│ │ │ │ -00044580: 6974 2069 7320 4f4b 0a20 2020 2020 746f  it is OK.     to
│ │ │ │ -00044590: 2069 7373 7565 2061 206e 6577 2074 6963   issue a new tic
│ │ │ │ -000445a0: 6b65 7420 2862 7574 206e 6f74 2061 2074  ket (but not a t
│ │ │ │ -000445b0: 6963 6b65 742d 6772 616e 7469 6e67 2074  icket-granting t
│ │ │ │ -000445c0: 6963 6b65 7429 2077 6974 6820 610a 2020  icket) with a.  
│ │ │ │ -000445d0: 2020 2064 6966 6665 7265 6e74 206e 6574     different net
│ │ │ │ -000445e0: 776f 726b 2061 6464 7265 7373 2062 6173  work address bas
│ │ │ │ -000445f0: 6564 206f 6e20 7468 6973 2074 6963 6b65  ed on this ticke
│ │ │ │ -00044600: 742e 2020 5468 6973 2066 6c61 6720 6973  t.  This flag is
│ │ │ │ -00044610: 2073 6574 0a20 2020 2020 6966 2072 6571   set.     if req
│ │ │ │ -00044620: 7565 7374 6564 2062 7920 7468 6520 636c  uested by the cl
│ │ │ │ -00044630: 6965 6e74 206f 6e20 696e 6974 6961 6c20  ient on initial 
│ │ │ │ -00044640: 6175 7468 656e 7469 6361 7469 6f6e 2e20  authentication. 
│ │ │ │ -00044650: 2042 7920 6465 6661 756c 742c 0a20 2020   By default,.   
│ │ │ │ -00044660: 2020 7468 6520 636c 6965 6e74 2077 696c    the client wil
│ │ │ │ -00044670: 6c20 7265 7175 6573 7420 7468 6174 2069  l request that i
│ │ │ │ -00044680: 7420 6265 2073 6574 2077 6865 6e20 7265  t be set when re
│ │ │ │ -00044690: 7175 6573 7469 6e67 2061 0a20 2020 2020  questing a.     
│ │ │ │ -000446a0: 7469 636b 6574 2d67 7261 6e74 696e 6720  ticket-granting 
│ │ │ │ -000446b0: 7469 636b 6574 2c20 616e 6420 7265 7365  ticket, and rese
│ │ │ │ -000446c0: 7420 7768 656e 2072 6571 7565 7374 696e  t when requestin
│ │ │ │ -000446d0: 6720 616e 7920 6f74 6865 7220 7469 636b  g any other tick
│ │ │ │ -000446e0: 6574 2e0a 0a20 2020 2020 2a52 6574 7572  et...     *Retur
│ │ │ │ -000446f0: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ -00044700: 7320 6e6f 6e2d 3020 6966 6620 7072 6f78  s non-0 iff prox
│ │ │ │ -00044710: 6961 626c 6520 666c 6167 2069 7320 7365  iable flag is se
│ │ │ │ -00044720: 7420 696e 2074 6963 6b65 742e 0a0a 7368  t in ticket...sh
│ │ │ │ -00044730: 6973 6869 5f74 6b74 5f70 726f 7879 5f70  ishi_tkt_proxy_p
│ │ │ │ -00044740: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ -00044750: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ -00044760: 6e3a 2069 6e74 2073 6869 7368 695f 746b  n: int shishi_tk
│ │ │ │ -00044770: 745f 7072 6f78 795f 7020 2853 6869 7368  t_proxy_p (Shish
│ │ │ │ -00044780: 695f 746b 7420 2a20 544b 5429 0a20 2020  i_tkt * TKT).   
│ │ │ │ -00044790: 2020 544b 543a 2069 6e70 7574 2076 6172    TKT: input var
│ │ │ │ -000447a0: 6961 626c 6520 7769 7468 2074 6963 6b65  iable with ticke
│ │ │ │ -000447b0: 7420 696e 666f 2e0a 0a20 2020 2020 2a44  t info...     *D
│ │ │ │ -000447c0: 6573 6372 6970 7469 6f6e 3a2a 2044 6574  escription:* Det
│ │ │ │ -000447d0: 6572 6d69 6e65 2069 6620 7469 636b 6574  ermine if ticket
│ │ │ │ -000447e0: 2069 7320 7072 6f78 7920 7469 636b 6574   is proxy ticket
│ │ │ │ -000447f0: 2e0a 0a20 2020 2020 5468 6520 5052 4f58  ...     The PROX
│ │ │ │ -00044800: 5920 666c 6167 2069 7320 7365 7420 696e  Y flag is set in
│ │ │ │ -00044810: 2061 2074 6963 6b65 7420 6279 2074 6865   a ticket by the
│ │ │ │ -00044820: 2054 4753 2077 6865 6e20 6974 2069 7373   TGS when it iss
│ │ │ │ -00044830: 7565 7320 6120 7072 6f78 790a 2020 2020  ues a proxy.    
│ │ │ │ -00044840: 2074 6963 6b65 742e 2020 4170 706c 6963   ticket.  Applic
│ │ │ │ -00044850: 6174 696f 6e20 7365 7276 6572 7320 4d41  ation servers MA
│ │ │ │ -00044860: 5920 6368 6563 6b20 7468 6973 2066 6c61  Y check this fla
│ │ │ │ -00044870: 6720 616e 6420 6174 2074 6865 6972 0a20  g and at their. 
│ │ │ │ -00044880: 2020 2020 6f70 7469 6f6e 2074 6865 7920      option they 
│ │ │ │ -00044890: 4d41 5920 7265 7175 6972 6520 6164 6469  MAY require addi
│ │ │ │ -000448a0: 7469 6f6e 616c 2061 7574 6865 6e74 6963  tional authentic
│ │ │ │ -000448b0: 6174 696f 6e20 6672 6f6d 2074 6865 2061  ation from the a
│ │ │ │ -000448c0: 6765 6e74 0a20 2020 2020 7072 6573 656e  gent.     presen
│ │ │ │ -000448d0: 7469 6e67 2074 6865 2070 726f 7879 2069  ting the proxy i
│ │ │ │ -000448e0: 6e20 6f72 6465 7220 746f 2070 726f 7669  n order to provi
│ │ │ │ -000448f0: 6465 2061 6e20 6175 6469 7420 7472 6169  de an audit trai
│ │ │ │ -00044900: 6c2e 0a0a 2020 2020 202a 5265 7475 726e  l...     *Return
│ │ │ │ -00044910: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ -00044920: 206e 6f6e 2d30 2069 6666 2070 726f 7879   non-0 iff proxy
│ │ │ │ -00044930: 2066 6c61 6720 6973 2073 6574 2069 6e20   flag is set in 
│ │ │ │ -00044940: 7469 636b 6574 2e0a 0a73 6869 7368 695f  ticket...shishi_
│ │ │ │ -00044950: 746b 745f 6d61 795f 706f 7374 6461 7465  tkt_may_postdate
│ │ │ │ -00044960: 5f70 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  _p.-------------
│ │ │ │ -00044970: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ -00044980: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ -00044990: 7368 6973 6869 5f74 6b74 5f6d 6179 5f70  shishi_tkt_may_p
│ │ │ │ -000449a0: 6f73 7464 6174 655f 7020 2853 6869 7368  ostdate_p (Shish
│ │ │ │ -000449b0: 695f 746b 7420 2a20 544b 5429 0a20 2020  i_tkt * TKT).   
│ │ │ │ -000449c0: 2020 544b 543a 2069 6e70 7574 2076 6172    TKT: input var
│ │ │ │ -000449d0: 6961 626c 6520 7769 7468 2074 6963 6b65  iable with ticke
│ │ │ │ -000449e0: 7420 696e 666f 2e0a 0a20 2020 2020 2a44  t info...     *D
│ │ │ │ -000449f0: 6573 6372 6970 7469 6f6e 3a2a 2044 6574  escription:* Det
│ │ │ │ -00044a00: 6572 6d69 6e65 2069 6620 7469 636b 6574  ermine if ticket
│ │ │ │ -00044a10: 206d 6179 2062 6520 7573 6564 2074 6f20   may be used to 
│ │ │ │ -00044a20: 6772 616e 7420 706f 7374 6461 7465 640a  grant postdated.
│ │ │ │ -00044a30: 2020 2020 2074 6963 6b65 7473 2e0a 0a20       tickets... 
│ │ │ │ -00044a40: 2020 2020 5468 6520 4d41 592d 504f 5354      The MAY-POST
│ │ │ │ -00044a50: 4441 5445 2066 6c61 6720 696e 2061 2074  DATE flag in a t
│ │ │ │ -00044a60: 6963 6b65 7420 6973 206e 6f72 6d61 6c6c  icket is normall
│ │ │ │ -00044a70: 7920 6f6e 6c79 2069 6e74 6572 7072 6574  y only interpret
│ │ │ │ -00044a80: 6564 2062 790a 2020 2020 2074 6865 2074  ed by.     the t
│ │ │ │ -00044a90: 6963 6b65 742d 6772 616e 7469 6e67 2073  icket-granting s
│ │ │ │ -00044aa0: 6572 7669 6365 2e20 2049 7420 6361 6e20  ervice.  It can 
│ │ │ │ -00044ab0: 6265 2069 676e 6f72 6564 2062 7920 6170  be ignored by ap
│ │ │ │ -00044ac0: 706c 6963 6174 696f 6e0a 2020 2020 2073  plication.     s
│ │ │ │ -00044ad0: 6572 7665 7273 2e20 2054 6869 7320 666c  ervers.  This fl
│ │ │ │ -00044ae0: 6167 204d 5553 5420 6265 2073 6574 2069  ag MUST be set i
│ │ │ │ -00044af0: 6e20 6120 7469 636b 6574 2d67 7261 6e74  n a ticket-grant
│ │ │ │ -00044b00: 696e 6720 7469 636b 6574 2069 6e0a 2020  ing ticket in.  
│ │ │ │ -00044b10: 2020 206f 7264 6572 2074 6f20 6973 7375     order to issu
│ │ │ │ -00044b20: 6520 6120 706f 7374 6461 7465 6420 7469  e a postdated ti
│ │ │ │ -00044b30: 636b 6574 2062 6173 6564 206f 6e20 7468  cket based on th
│ │ │ │ -00044b40: 6520 7072 6573 656e 7465 6420 7469 636b  e presented tick
│ │ │ │ -00044b50: 6574 2e0a 2020 2020 2049 7420 6973 2072  et..     It is r
│ │ │ │ -00044b60: 6573 6574 2062 7920 6465 6661 756c 743b  eset by default;
│ │ │ │ -00044b70: 2069 7420 4d41 5920 6265 2072 6571 7565   it MAY be reque
│ │ │ │ -00044b80: 7374 6564 2062 7920 6120 636c 6965 6e74  sted by a client
│ │ │ │ -00044b90: 2062 7920 7365 7474 696e 670a 2020 2020   by setting.    
│ │ │ │ -00044ba0: 2074 6865 2041 4c4c 4f57 2d20 504f 5354   the ALLOW- POST
│ │ │ │ -00044bb0: 4441 5445 206f 7074 696f 6e20 696e 2074  DATE option in t
│ │ │ │ -00044bc0: 6865 204b 5242 5f41 535f 5245 5120 6d65  he KRB_AS_REQ me
│ │ │ │ -00044bd0: 7373 6167 652e 2020 5468 6973 2066 6c61  ssage.  This fla
│ │ │ │ -00044be0: 670a 2020 2020 2064 6f65 7320 6e6f 7420  g.     does not 
│ │ │ │ -00044bf0: 616c 6c6f 7720 6120 636c 6965 6e74 2074  allow a client t
│ │ │ │ -00044c00: 6f20 6f62 7461 696e 2061 2070 6f73 7464  o obtain a postd
│ │ │ │ -00044c10: 6174 6564 2074 6963 6b65 742d 6772 616e  ated ticket-gran
│ │ │ │ -00044c20: 7469 6e67 0a20 2020 2020 7469 636b 6574  ting.     ticket
│ │ │ │ -00044c30: 3b20 706f 7374 6461 7465 6420 7469 636b  ; postdated tick
│ │ │ │ -00044c40: 6574 2d67 7261 6e74 696e 6720 7469 636b  et-granting tick
│ │ │ │ -00044c50: 6574 7320 6361 6e20 6f6e 6c79 2062 7920  ets can only by 
│ │ │ │ -00044c60: 6f62 7461 696e 6564 2062 790a 2020 2020  obtained by.    
│ │ │ │ -00044c70: 2072 6571 7565 7374 696e 6720 7468 6520   requesting the 
│ │ │ │ -00044c80: 706f 7374 6461 7469 6e67 2069 6e20 7468  postdating in th
│ │ │ │ -00044c90: 6520 4b52 425f 4153 5f52 4551 206d 6573  e KRB_AS_REQ mes
│ │ │ │ -00044ca0: 7361 6765 2e20 2054 6865 206c 6966 650a  sage.  The life.
│ │ │ │ -00044cb0: 2020 2020 2028 656e 6474 696d 652d 7374       (endtime-st
│ │ │ │ -00044cc0: 6172 7474 696d 6529 206f 6620 6120 706f  arttime) of a po
│ │ │ │ -00044cd0: 7374 6461 7465 6420 7469 636b 6574 2077  stdated ticket w
│ │ │ │ -00044ce0: 696c 6c20 6265 2074 6865 2072 656d 6169  ill be the remai
│ │ │ │ -00044cf0: 6e69 6e67 0a20 2020 2020 6c69 6665 206f  ning.     life o
│ │ │ │ -00044d00: 6620 7468 6520 7469 636b 6574 2d67 7261  f the ticket-gra
│ │ │ │ -00044d10: 6e74 696e 6720 7469 636b 6574 2061 7420  nting ticket at 
│ │ │ │ -00044d20: 7468 6520 7469 6d65 206f 6620 7468 6520  the time of the 
│ │ │ │ -00044d30: 7265 7175 6573 742c 0a20 2020 2020 756e  request,.     un
│ │ │ │ -00044d40: 6c65 7373 2074 6865 2052 454e 4557 4142  less the RENEWAB
│ │ │ │ -00044d50: 4c45 206f 7074 696f 6e20 6973 2061 6c73  LE option is als
│ │ │ │ -00044d60: 6f20 7365 742c 2069 6e20 7768 6963 6820  o set, in which 
│ │ │ │ -00044d70: 6361 7365 2069 7420 6361 6e20 6265 0a20  case it can be. 
│ │ │ │ -00044d80: 2020 2020 7468 6520 6675 6c6c 206c 6966      the full lif
│ │ │ │ -00044d90: 6520 2865 6e64 7469 6d65 2d73 7461 7274  e (endtime-start
│ │ │ │ -00044da0: 7469 6d65 2920 6f66 2074 6865 2074 6963  time) of the tic
│ │ │ │ -00044db0: 6b65 742d 6772 616e 7469 6e67 2074 6963  ket-granting tic
│ │ │ │ -00044dc0: 6b65 742e 0a20 2020 2020 5468 6520 4b44  ket..     The KD
│ │ │ │ -00044dd0: 4320 4d41 5920 6c69 6d69 7420 686f 7720  C MAY limit how 
│ │ │ │ -00044de0: 6661 7220 696e 2074 6865 2066 7574 7572  far in the futur
│ │ │ │ -00044df0: 6520 6120 7469 636b 6574 206d 6179 2062  e a ticket may b
│ │ │ │ -00044e00: 6520 706f 7374 6461 7465 642e 0a0a 2020  e postdated...  
│ │ │ │ -00044e10: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ -00044e20: 3a2a 2052 6574 7572 6e73 206e 6f6e 2d30  :* Returns non-0
│ │ │ │ -00044e30: 2069 6666 206d 6179 2d70 6f73 7464 6174   iff may-postdat
│ │ │ │ -00044e40: 6520 666c 6167 2069 7320 7365 7420 696e  e flag is set in
│ │ │ │ -00044e50: 0a20 2020 2020 7469 636b 6574 2e0a 0a73  .     ticket...s
│ │ │ │ -00044e60: 6869 7368 695f 746b 745f 706f 7374 6461  hishi_tkt_postda
│ │ │ │ -00044e70: 7465 645f 700a 2d2d 2d2d 2d2d 2d2d 2d2d  ted_p.----------
│ │ │ │ -00044e80: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ -00044e90: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ -00044ea0: 7368 6973 6869 5f74 6b74 5f70 6f73 7464  shishi_tkt_postd
│ │ │ │ -00044eb0: 6174 6564 5f70 2028 5368 6973 6869 5f74  ated_p (Shishi_t
│ │ │ │ -00044ec0: 6b74 202a 2054 4b54 290a 2020 2020 2054  kt * TKT).     T
│ │ │ │ -00044ed0: 4b54 3a20 696e 7075 7420 7661 7269 6162  KT: input variab
│ │ │ │ -00044ee0: 6c65 2077 6974 6820 7469 636b 6574 2069  le with ticket i
│ │ │ │ -00044ef0: 6e66 6f2e 0a0a 2020 2020 202a 4465 7363  nfo...     *Desc
│ │ │ │ -00044f00: 7269 7074 696f 6e3a 2a20 4465 7465 726d  ription:* Determ
│ │ │ │ -00044f10: 696e 6520 6966 2074 6963 6b65 7420 6973  ine if ticket is
│ │ │ │ -00044f20: 2070 6f73 7464 6174 6564 2e0a 0a20 2020   postdated...   
│ │ │ │ -00044f30: 2020 5468 6520 504f 5354 4441 5445 4420    The POSTDATED 
│ │ │ │ -00044f40: 666c 6167 2069 6e64 6963 6174 6573 2074  flag indicates t
│ │ │ │ -00044f50: 6861 7420 6120 7469 636b 6574 2068 6173  hat a ticket has
│ │ │ │ -00044f60: 2062 6565 6e20 706f 7374 6461 7465 642e   been postdated.
│ │ │ │ -00044f70: 2020 5468 650a 2020 2020 2061 7070 6c69    The.     appli
│ │ │ │ -00044f80: 6361 7469 6f6e 2073 6572 7665 7220 6361  cation server ca
│ │ │ │ -00044f90: 6e20 6368 6563 6b20 7468 6520 6175 7468  n check the auth
│ │ │ │ -00044fa0: 7469 6d65 2066 6965 6c64 2069 6e20 7468  time field in th
│ │ │ │ -00044fb0: 6520 7469 636b 6574 2074 6f0a 2020 2020  e ticket to.    
│ │ │ │ -00044fc0: 2073 6565 2077 6865 6e20 7468 6520 6f72   see when the or
│ │ │ │ -00044fd0: 6967 696e 616c 2061 7574 6865 6e74 6963  iginal authentic
│ │ │ │ -00044fe0: 6174 696f 6e20 6f63 6375 7272 6564 2e20  ation occurred. 
│ │ │ │ -00044ff0: 2053 6f6d 6520 7365 7276 6963 6573 204d   Some services M
│ │ │ │ -00045000: 4159 0a20 2020 2020 6368 6f6f 7365 2074  AY.     choose t
│ │ │ │ -00045010: 6f20 7265 6a65 6374 2070 6f73 7464 6174  o reject postdat
│ │ │ │ -00045020: 6564 2074 6963 6b65 7473 2c20 6f72 2074  ed tickets, or t
│ │ │ │ -00045030: 6865 7920 6d61 7920 6f6e 6c79 2061 6363  hey may only acc
│ │ │ │ -00045040: 6570 7420 7468 656d 0a20 2020 2020 7769  ept them.     wi
│ │ │ │ -00045050: 7468 696e 2061 2063 6572 7461 696e 2070  thin a certain p
│ │ │ │ -00045060: 6572 696f 6420 6166 7465 7220 7468 6520  eriod after the 
│ │ │ │ -00045070: 6f72 6967 696e 616c 2061 7574 6865 6e74  original authent
│ │ │ │ -00045080: 6963 6174 696f 6e2e 2020 5768 656e 0a20  ication.  When. 
│ │ │ │ -00045090: 2020 2020 7468 6520 4b44 4320 6973 7375      the KDC issu
│ │ │ │ -000450a0: 6573 2061 2050 4f53 5444 4154 4544 2074  es a POSTDATED t
│ │ │ │ -000450b0: 6963 6b65 742c 2069 7420 7769 6c6c 2061  icket, it will a
│ │ │ │ -000450c0: 6c73 6f20 6265 206d 6172 6b65 6420 6173  lso be marked as
│ │ │ │ -000450d0: 0a20 2020 2020 494e 5641 4c49 442c 2073  .     INVALID, s
│ │ │ │ -000450e0: 6f20 7468 6174 2074 6865 2061 7070 6c69  o that the appli
│ │ │ │ -000450f0: 6361 7469 6f6e 2063 6c69 656e 7420 4d55  cation client MU
│ │ │ │ -00045100: 5354 2070 7265 7365 6e74 2074 6865 2074  ST present the t
│ │ │ │ -00045110: 6963 6b65 7420 746f 0a20 2020 2020 7468  icket to.     th
│ │ │ │ -00045120: 6520 4b44 4320 746f 2062 6520 7661 6c69  e KDC to be vali
│ │ │ │ -00045130: 6461 7465 6420 6265 666f 7265 2075 7365  dated before use
│ │ │ │ -00045140: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ -00045150: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ -00045160: 6e6f 6e2d 3020 6966 6620 706f 7374 6461  non-0 iff postda
│ │ │ │ -00045170: 7465 6420 666c 6167 2069 7320 7365 7420  ted flag is set 
│ │ │ │ -00045180: 696e 2074 6963 6b65 742e 0a0a 7368 6973  in ticket...shis
│ │ │ │ -00045190: 6869 5f74 6b74 5f69 6e76 616c 6964 5f70  hi_tkt_invalid_p
│ │ │ │ -000451a0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ -000451b0: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ -000451c0: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ -000451d0: 746b 745f 696e 7661 6c69 645f 7020 2853  tkt_invalid_p (S
│ │ │ │ -000451e0: 6869 7368 695f 746b 7420 2a20 544b 5429  hishi_tkt * TKT)
│ │ │ │ -000451f0: 0a20 2020 2020 544b 543a 2069 6e70 7574  .     TKT: input
│ │ │ │ -00045200: 2076 6172 6961 626c 6520 7769 7468 2074   variable with t
│ │ │ │ -00045210: 6963 6b65 7420 696e 666f 2e0a 0a20 2020  icket info...   
│ │ │ │ -00045220: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ -00045230: 2044 6574 6572 6d69 6e65 2069 6620 7469   Determine if ti
│ │ │ │ -00045240: 636b 6574 2069 7320 696e 7661 6c69 642e  cket is invalid.
│ │ │ │ -00045250: 0a0a 2020 2020 2054 6865 2049 4e56 414c  ..     The INVAL
│ │ │ │ -00045260: 4944 2066 6c61 6720 696e 6469 6361 7465  ID flag indicate
│ │ │ │ -00045270: 7320 7468 6174 2061 2074 6963 6b65 7420  s that a ticket 
│ │ │ │ -00045280: 6973 2069 6e76 616c 6964 2e20 2041 7070  is invalid.  App
│ │ │ │ -00045290: 6c69 6361 7469 6f6e 0a20 2020 2020 7365  lication.     se
│ │ │ │ -000452a0: 7276 6572 7320 4d55 5354 2072 656a 6563  rvers MUST rejec
│ │ │ │ -000452b0: 7420 7469 636b 6574 7320 7768 6963 6820  t tickets which 
│ │ │ │ -000452c0: 6861 7665 2074 6869 7320 666c 6167 2073  have this flag s
│ │ │ │ -000452d0: 6574 2e20 2041 2070 6f73 7464 6174 6564  et.  A postdated
│ │ │ │ -000452e0: 0a20 2020 2020 7469 636b 6574 2077 696c  .     ticket wil
│ │ │ │ -000452f0: 6c20 6265 2069 7373 7565 6420 696e 2074  l be issued in t
│ │ │ │ -00045300: 6869 7320 666f 726d 2e20 2049 6e76 616c  his form.  Inval
│ │ │ │ -00045310: 6964 2074 6963 6b65 7473 204d 5553 5420  id tickets MUST 
│ │ │ │ -00045320: 6265 0a20 2020 2020 7661 6c69 6461 7465  be.     validate
│ │ │ │ -00045330: 6420 6279 2074 6865 204b 4443 2062 6566  d by the KDC bef
│ │ │ │ -00045340: 6f72 6520 7573 652c 2062 7920 7072 6573  ore use, by pres
│ │ │ │ -00045350: 656e 7469 6e67 2074 6865 6d20 746f 2074  enting them to t
│ │ │ │ -00045360: 6865 204b 4443 2069 6e20 610a 2020 2020  he KDC in a.    
│ │ │ │ -00045370: 2054 4753 2072 6571 7565 7374 2077 6974   TGS request wit
│ │ │ │ -00045380: 6820 7468 6520 5641 4c49 4441 5445 206f  h the VALIDATE o
│ │ │ │ -00045390: 7074 696f 6e20 7370 6563 6966 6965 642e  ption specified.
│ │ │ │ -000453a0: 2020 5468 6520 4b44 4320 7769 6c6c 206f    The KDC will o
│ │ │ │ -000453b0: 6e6c 790a 2020 2020 2076 616c 6964 6174  nly.     validat
│ │ │ │ -000453c0: 6520 7469 636b 6574 7320 6166 7465 7220  e tickets after 
│ │ │ │ -000453d0: 7468 6569 7220 7374 6172 7474 696d 6520  their starttime 
│ │ │ │ -000453e0: 6861 7320 7061 7373 6564 2e20 2054 6865  has passed.  The
│ │ │ │ -000453f0: 2076 616c 6964 6174 696f 6e0a 2020 2020   validation.    
│ │ │ │ -00045400: 2069 7320 7265 7175 6972 6564 2073 6f20   is required so 
│ │ │ │ -00045410: 7468 6174 2070 6f73 7464 6174 6564 2074  that postdated t
│ │ │ │ -00045420: 6963 6b65 7473 2077 6869 6368 2068 6176  ickets which hav
│ │ │ │ -00045430: 6520 6265 656e 2073 746f 6c65 6e20 6265  e been stolen be
│ │ │ │ -00045440: 666f 7265 0a20 2020 2020 7468 6569 7220  fore.     their 
│ │ │ │ -00045450: 7374 6172 7474 696d 6520 6361 6e20 6265  starttime can be
│ │ │ │ -00045460: 2072 656e 6465 7265 6420 7065 726d 616e   rendered perman
│ │ │ │ -00045470: 656e 746c 7920 696e 7661 6c69 6420 2874  ently invalid (t
│ │ │ │ -00045480: 6872 6f75 6768 2061 0a20 2020 2020 686f  hrough a.     ho
│ │ │ │ -00045490: 742d 6c69 7374 206d 6563 6861 6e69 736d  t-list mechanism
│ │ │ │ -000454a0: 292e 0a0a 2020 2020 202a 5265 7475 726e  )...     *Return
│ │ │ │ -000454b0: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ -000454c0: 206e 6f6e 2d30 2069 6666 2069 6e76 616c   non-0 iff inval
│ │ │ │ -000454d0: 6964 2066 6c61 6720 6973 2073 6574 2069  id flag is set i
│ │ │ │ -000454e0: 6e20 7469 636b 6574 2e0a 0a73 6869 7368  n ticket...shish
│ │ │ │ -000454f0: 695f 746b 745f 7265 6e65 7761 626c 655f  i_tkt_renewable_
│ │ │ │ -00045500: 700a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  p.--------------
│ │ │ │ -00045510: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -00045520: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ -00045530: 6869 5f74 6b74 5f72 656e 6577 6162 6c65  hi_tkt_renewable
│ │ │ │ -00045540: 5f70 2028 5368 6973 6869 5f74 6b74 202a  _p (Shishi_tkt *
│ │ │ │ -00045550: 2054 4b54 290a 2020 2020 2054 4b54 3a20   TKT).     TKT: 
│ │ │ │ -00045560: 696e 7075 7420 7661 7269 6162 6c65 2077  input variable w
│ │ │ │ -00045570: 6974 6820 7469 636b 6574 2069 6e66 6f2e  ith ticket info.
│ │ │ │ -00045580: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ -00045590: 696f 6e3a 2a20 4465 7465 726d 696e 6520  ion:* Determine 
│ │ │ │ -000455a0: 6966 2074 6963 6b65 7420 6973 2072 656e  if ticket is ren
│ │ │ │ -000455b0: 6577 6162 6c65 2e0a 0a20 2020 2020 5468  ewable...     Th
│ │ │ │ -000455c0: 6520 5245 4e45 5741 424c 4520 666c 6167  e RENEWABLE flag
│ │ │ │ -000455d0: 2069 6e20 6120 7469 636b 6574 2069 7320   in a ticket is 
│ │ │ │ -000455e0: 6e6f 726d 616c 6c79 206f 6e6c 7920 696e  normally only in
│ │ │ │ -000455f0: 7465 7270 7265 7465 6420 6279 2074 6865  terpreted by the
│ │ │ │ -00045600: 0a20 2020 2020 7469 636b 6574 2d67 7261  .     ticket-gra
│ │ │ │ -00045610: 6e74 696e 6720 7365 7276 6963 6520 2864  nting service (d
│ │ │ │ -00045620: 6973 6375 7373 6564 2062 656c 6f77 2069  iscussed below i
│ │ │ │ -00045630: 6e20 7365 6374 696f 6e20 332e 3329 2e20  n section 3.3). 
│ │ │ │ -00045640: 2049 7420 6361 6e0a 2020 2020 2075 7375   It can.     usu
│ │ │ │ -00045650: 616c 6c79 2062 6520 6967 6e6f 7265 6420  ally be ignored 
│ │ │ │ -00045660: 6279 2061 7070 6c69 6361 7469 6f6e 2073  by application s
│ │ │ │ -00045670: 6572 7665 7273 2e20 2048 6f77 6576 6572  ervers.  However
│ │ │ │ -00045680: 2c20 736f 6d65 0a20 2020 2020 7061 7274  , some.     part
│ │ │ │ -00045690: 6963 756c 6172 6c79 2063 6172 6566 756c  icularly careful
│ │ │ │ -000456a0: 2061 7070 6c69 6361 7469 6f6e 2073 6572   application ser
│ │ │ │ -000456b0: 7665 7273 204d 4159 2064 6973 616c 6c6f  vers MAY disallo
│ │ │ │ -000456c0: 7720 7265 6e65 7761 626c 650a 2020 2020  w renewable.    
│ │ │ │ -000456d0: 2074 6963 6b65 7473 2e0a 0a20 2020 2020   tickets...     
│ │ │ │ -000456e0: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ -000456f0: 5265 7475 726e 7320 6e6f 6e2d 3020 6966  Returns non-0 if
│ │ │ │ -00045700: 6620 7265 6e65 7761 626c 6520 666c 6167  f renewable flag
│ │ │ │ -00045710: 2069 7320 7365 7420 696e 2074 6963 6b65   is set in ticke
│ │ │ │ -00045720: 742e 0a0a 7368 6973 6869 5f74 6b74 5f69  t...shishi_tkt_i
│ │ │ │ -00045730: 6e69 7469 616c 5f70 0a2d 2d2d 2d2d 2d2d  nitial_p.-------
│ │ │ │ -00045740: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -00045750: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ -00045760: 2073 6869 7368 695f 746b 745f 696e 6974   shishi_tkt_init
│ │ │ │ -00045770: 6961 6c5f 7020 2853 6869 7368 695f 746b  ial_p (Shishi_tk
│ │ │ │ -00045780: 7420 2a20 544b 5429 0a20 2020 2020 544b  t * TKT).     TK
│ │ │ │ -00045790: 543a 2069 6e70 7574 2076 6172 6961 626c  T: input variabl
│ │ │ │ -000457a0: 6520 7769 7468 2074 6963 6b65 7420 696e  e with ticket in
│ │ │ │ -000457b0: 666f 2e0a 0a20 2020 2020 2a44 6573 6372  fo...     *Descr
│ │ │ │ -000457c0: 6970 7469 6f6e 3a2a 2044 6574 6572 6d69  iption:* Determi
│ │ │ │ -000457d0: 6e65 2069 6620 7469 636b 6574 2077 6173  ne if ticket was
│ │ │ │ -000457e0: 2069 7373 7565 6420 7573 696e 6720 4153   issued using AS
│ │ │ │ -000457f0: 2065 7863 6861 6e67 652e 0a0a 2020 2020   exchange...    
│ │ │ │ -00045800: 2054 6865 2049 4e49 5449 414c 2066 6c61   The INITIAL fla
│ │ │ │ -00045810: 6720 696e 6469 6361 7465 7320 7468 6174  g indicates that
│ │ │ │ -00045820: 2061 2074 6963 6b65 7420 7761 7320 6973   a ticket was is
│ │ │ │ -00045830: 7375 6564 2075 7369 6e67 2074 6865 2041  sued using the A
│ │ │ │ -00045840: 530a 2020 2020 2070 726f 746f 636f 6c2c  S.     protocol,
│ │ │ │ -00045850: 2072 6174 6865 7220 7468 616e 2069 7373   rather than iss
│ │ │ │ -00045860: 7565 6420 6261 7365 6420 6f6e 2061 2074  ued based on a t
│ │ │ │ -00045870: 6963 6b65 742d 6772 616e 7469 6e67 2074  icket-granting t
│ │ │ │ -00045880: 6963 6b65 742e 0a20 2020 2020 4170 706c  icket..     Appl
│ │ │ │ -00045890: 6963 6174 696f 6e20 7365 7276 6572 7320  ication servers 
│ │ │ │ -000458a0: 7468 6174 2077 616e 7420 746f 2072 6571  that want to req
│ │ │ │ -000458b0: 7569 7265 2074 6865 2064 656d 6f6e 7374  uire the demonst
│ │ │ │ -000458c0: 7261 7465 6420 6b6e 6f77 6c65 6467 650a  rated knowledge.
│ │ │ │ -000458d0: 2020 2020 206f 6620 6120 636c 6965 6e74       of a client
│ │ │ │ -000458e0: 2773 2073 6563 7265 7420 6b65 7920 2865  's secret key (e
│ │ │ │ -000458f0: 2e67 2e20 2061 2070 6173 7377 6f72 642d  .g.  a password-
│ │ │ │ -00045900: 6368 616e 6769 6e67 2070 726f 6772 616d  changing program
│ │ │ │ -00045910: 2920 6361 6e0a 2020 2020 2069 6e73 6973  ) can.     insis
│ │ │ │ -00045920: 7420 7468 6174 2074 6869 7320 666c 6167  t that this flag
│ │ │ │ -00045930: 2062 6520 7365 7420 696e 2061 6e79 2074   be set in any t
│ │ │ │ -00045940: 6963 6b65 7473 2074 6865 7920 6163 6365  ickets they acce
│ │ │ │ -00045950: 7074 2c20 616e 6420 7468 7573 0a20 2020  pt, and thus.   
│ │ │ │ -00045960: 2020 6265 2061 7373 7572 6564 2074 6861    be assured tha
│ │ │ │ -00045970: 7420 7468 6520 636c 6965 6e74 2773 206b  t the client's k
│ │ │ │ -00045980: 6579 2077 6173 2072 6563 656e 746c 7920  ey was recently 
│ │ │ │ -00045990: 7072 6573 656e 7465 6420 746f 2074 6865  presented to the
│ │ │ │ -000459a0: 0a20 2020 2020 6170 706c 6963 6174 696f  .     applicatio
│ │ │ │ -000459b0: 6e20 636c 6965 6e74 2e0a 0a20 2020 2020  n client...     
│ │ │ │ -000459c0: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ -000459d0: 5265 7475 726e 7320 6e6f 6e2d 3020 6966  Returns non-0 if
│ │ │ │ -000459e0: 6620 696e 6974 6961 6c20 666c 6167 2069  f initial flag i
│ │ │ │ -000459f0: 7320 7365 7420 696e 2074 6963 6b65 742e  s set in ticket.
│ │ │ │ -00045a00: 0a0a 7368 6973 6869 5f74 6b74 5f70 7265  ..shishi_tkt_pre
│ │ │ │ -00045a10: 5f61 7574 6865 6e74 5f70 0a2d 2d2d 2d2d  _authent_p.-----
│ │ │ │ +00043e10: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ +00043e20: 3a20 696e 7420 7368 6973 6869 5f74 6b74  : int shishi_tkt
│ │ │ │ +00043e30: 5f66 6f72 7761 7264 6162 6c65 5f70 2028  _forwardable_p (
│ │ │ │ +00043e40: 5368 6973 6869 5f74 6b74 202a 2054 4b54  Shishi_tkt * TKT
│ │ │ │ +00043e50: 290a 2020 2020 2054 4b54 3a20 696e 7075  ).     TKT: inpu
│ │ │ │ +00043e60: 7420 7661 7269 6162 6c65 2077 6974 6820  t variable with 
│ │ │ │ +00043e70: 7469 636b 6574 2069 6e66 6f2e 0a0a 2020  ticket info...  
│ │ │ │ +00043e80: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ +00043e90: 2a20 4465 7465 726d 696e 6520 6966 2074  * Determine if t
│ │ │ │ +00043ea0: 6963 6b65 7420 6973 2066 6f72 7761 7264  icket is forward
│ │ │ │ +00043eb0: 6162 6c65 2e0a 0a20 2020 2020 5468 6520  able...     The 
│ │ │ │ +00043ec0: 464f 5257 4152 4441 424c 4520 666c 6167  FORWARDABLE flag
│ │ │ │ +00043ed0: 2069 6e20 6120 7469 636b 6574 2069 7320   in a ticket is 
│ │ │ │ +00043ee0: 6e6f 726d 616c 6c79 206f 6e6c 7920 696e  normally only in
│ │ │ │ +00043ef0: 7465 7270 7265 7465 6420 6279 0a20 2020  terpreted by.   
│ │ │ │ +00043f00: 2020 7468 6520 7469 636b 6574 2d67 7261    the ticket-gra
│ │ │ │ +00043f10: 6e74 696e 6720 7365 7276 6963 652e 2020  nting service.  
│ │ │ │ +00043f20: 4974 2063 616e 2062 6520 6967 6e6f 7265  It can be ignore
│ │ │ │ +00043f30: 6420 6279 2061 7070 6c69 6361 7469 6f6e  d by application
│ │ │ │ +00043f40: 0a20 2020 2020 7365 7276 6572 732e 2020  .     servers.  
│ │ │ │ +00043f50: 5468 6520 464f 5257 4152 4441 424c 4520  The FORWARDABLE 
│ │ │ │ +00043f60: 666c 6167 2068 6173 2061 6e20 696e 7465  flag has an inte
│ │ │ │ +00043f70: 7270 7265 7461 7469 6f6e 2073 696d 696c  rpretation simil
│ │ │ │ +00043f80: 6172 2074 6f0a 2020 2020 2074 6861 7420  ar to.     that 
│ │ │ │ +00043f90: 6f66 2074 6865 2050 524f 5849 4142 4c45  of the PROXIABLE
│ │ │ │ +00043fa0: 2066 6c61 672c 2065 7863 6570 7420 7469   flag, except ti
│ │ │ │ +00043fb0: 636b 6574 2d67 7261 6e74 696e 6720 7469  cket-granting ti
│ │ │ │ +00043fc0: 636b 6574 7320 6d61 7920 616c 736f 0a20  ckets may also. 
│ │ │ │ +00043fd0: 2020 2020 6265 2069 7373 7565 6420 7769      be issued wi
│ │ │ │ +00043fe0: 7468 2064 6966 6665 7265 6e74 206e 6574  th different net
│ │ │ │ +00043ff0: 776f 726b 2061 6464 7265 7373 6573 2e20  work addresses. 
│ │ │ │ +00044000: 2054 6869 7320 666c 6167 2069 7320 7265   This flag is re
│ │ │ │ +00044010: 7365 7420 6279 0a20 2020 2020 6465 6661  set by.     defa
│ │ │ │ +00044020: 756c 742c 2062 7574 2075 7365 7273 204d  ult, but users M
│ │ │ │ +00044030: 4159 2072 6571 7565 7374 2074 6861 7420  AY request that 
│ │ │ │ +00044040: 6974 2062 6520 7365 7420 6279 2073 6574  it be set by set
│ │ │ │ +00044050: 7469 6e67 2074 6865 0a20 2020 2020 464f  ting the.     FO
│ │ │ │ +00044060: 5257 4152 4441 424c 4520 6f70 7469 6f6e  RWARDABLE option
│ │ │ │ +00044070: 2069 6e20 7468 6520 4153 2072 6571 7565   in the AS reque
│ │ │ │ +00044080: 7374 2077 6865 6e20 7468 6579 2072 6571  st when they req
│ │ │ │ +00044090: 7565 7374 2074 6865 6972 0a20 2020 2020  uest their.     
│ │ │ │ +000440a0: 696e 6974 6961 6c20 7469 636b 6574 2d67  initial ticket-g
│ │ │ │ +000440b0: 7261 6e74 696e 6720 7469 636b 6574 2e0a  ranting ticket..
│ │ │ │ +000440c0: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ +000440d0: 6c75 653a 2a20 5265 7475 726e 7320 6e6f  lue:* Returns no
│ │ │ │ +000440e0: 6e2d 3020 6966 6620 666f 7277 6172 6461  n-0 iff forwarda
│ │ │ │ +000440f0: 626c 6520 666c 6167 2069 7320 7365 7420  ble flag is set 
│ │ │ │ +00044100: 696e 0a20 2020 2020 7469 636b 6574 2e0a  in.     ticket..
│ │ │ │ +00044110: 0a73 6869 7368 695f 746b 745f 666f 7277  .shishi_tkt_forw
│ │ │ │ +00044120: 6172 6465 645f 700a 2d2d 2d2d 2d2d 2d2d  arded_p.--------
│ │ │ │ +00044130: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ +00044140: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ +00044150: 7420 7368 6973 6869 5f74 6b74 5f66 6f72  t shishi_tkt_for
│ │ │ │ +00044160: 7761 7264 6564 5f70 2028 5368 6973 6869  warded_p (Shishi
│ │ │ │ +00044170: 5f74 6b74 202a 2054 4b54 290a 2020 2020  _tkt * TKT).    
│ │ │ │ +00044180: 2054 4b54 3a20 696e 7075 7420 7661 7269   TKT: input vari
│ │ │ │ +00044190: 6162 6c65 2077 6974 6820 7469 636b 6574  able with ticket
│ │ │ │ +000441a0: 2069 6e66 6f2e 0a0a 2020 2020 202a 4465   info...     *De
│ │ │ │ +000441b0: 7363 7269 7074 696f 6e3a 2a20 4465 7465  scription:* Dete
│ │ │ │ +000441c0: 726d 696e 6520 6966 2074 6963 6b65 7420  rmine if ticket 
│ │ │ │ +000441d0: 6973 2066 6f72 7761 7264 6564 2e0a 0a20  is forwarded... 
│ │ │ │ +000441e0: 2020 2020 5468 6520 464f 5257 4152 4445      The FORWARDE
│ │ │ │ +000441f0: 4420 666c 6167 2069 7320 7365 7420 6279  D flag is set by
│ │ │ │ +00044200: 2074 6865 2054 4753 2077 6865 6e20 6120   the TGS when a 
│ │ │ │ +00044210: 636c 6965 6e74 2070 7265 7365 6e74 7320  client presents 
│ │ │ │ +00044220: 610a 2020 2020 2074 6963 6b65 7420 7769  a.     ticket wi
│ │ │ │ +00044230: 7468 2074 6865 2046 4f52 5741 5244 4142  th the FORWARDAB
│ │ │ │ +00044240: 4c45 2066 6c61 6720 7365 7420 616e 6420  LE flag set and 
│ │ │ │ +00044250: 7265 7175 6573 7473 2061 2066 6f72 7761  requests a forwa
│ │ │ │ +00044260: 7264 6564 0a20 2020 2020 7469 636b 6574  rded.     ticket
│ │ │ │ +00044270: 2062 7920 7370 6563 6966 7969 6e67 2074   by specifying t
│ │ │ │ +00044280: 6865 2046 4f52 5741 5244 4544 204b 4443  he FORWARDED KDC
│ │ │ │ +00044290: 206f 7074 696f 6e20 616e 6420 7375 7070   option and supp
│ │ │ │ +000442a0: 6c79 696e 6720 6120 7365 740a 2020 2020  lying a set.    
│ │ │ │ +000442b0: 206f 6620 6164 6472 6573 7365 7320 666f   of addresses fo
│ │ │ │ +000442c0: 7220 7468 6520 6e65 7720 7469 636b 6574  r the new ticket
│ │ │ │ +000442d0: 2e20 2049 7420 6973 2061 6c73 6f20 7365  .  It is also se
│ │ │ │ +000442e0: 7420 696e 2061 6c6c 2074 6963 6b65 7473  t in all tickets
│ │ │ │ +000442f0: 0a20 2020 2020 6973 7375 6564 2062 6173  .     issued bas
│ │ │ │ +00044300: 6564 206f 6e20 7469 636b 6574 7320 7769  ed on tickets wi
│ │ │ │ +00044310: 7468 2074 6865 2046 4f52 5741 5244 4544  th the FORWARDED
│ │ │ │ +00044320: 2066 6c61 6720 7365 742e 2020 4170 706c   flag set.  Appl
│ │ │ │ +00044330: 6963 6174 696f 6e0a 2020 2020 2073 6572  ication.     ser
│ │ │ │ +00044340: 7665 7273 206d 6179 2063 686f 6f73 6520  vers may choose 
│ │ │ │ +00044350: 746f 2070 726f 6365 7373 2046 4f52 5741  to process FORWA
│ │ │ │ +00044360: 5244 4544 2074 6963 6b65 7473 2064 6966  RDED tickets dif
│ │ │ │ +00044370: 6665 7265 6e74 6c79 2074 6861 6e0a 2020  ferently than.  
│ │ │ │ +00044380: 2020 206e 6f6e 2d46 4f52 5741 5244 4544     non-FORWARDED
│ │ │ │ +00044390: 2074 6963 6b65 7473 2e0a 0a20 2020 2020   tickets...     
│ │ │ │ +000443a0: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ +000443b0: 5265 7475 726e 7320 6e6f 6e2d 3020 6966  Returns non-0 if
│ │ │ │ +000443c0: 6620 666f 7277 6172 6465 6420 666c 6167  f forwarded flag
│ │ │ │ +000443d0: 2069 7320 7365 7420 696e 2074 6963 6b65   is set in ticke
│ │ │ │ +000443e0: 742e 0a0a 7368 6973 6869 5f74 6b74 5f70  t...shishi_tkt_p
│ │ │ │ +000443f0: 726f 7869 6162 6c65 5f70 0a2d 2d2d 2d2d  roxiable_p.-----
│ │ │ │ +00044400: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +00044410: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ +00044420: 2069 6e74 2073 6869 7368 695f 746b 745f   int shishi_tkt_
│ │ │ │ +00044430: 7072 6f78 6961 626c 655f 7020 2853 6869  proxiable_p (Shi
│ │ │ │ +00044440: 7368 695f 746b 7420 2a20 544b 5429 0a20  shi_tkt * TKT). 
│ │ │ │ +00044450: 2020 2020 544b 543a 2069 6e70 7574 2076      TKT: input v
│ │ │ │ +00044460: 6172 6961 626c 6520 7769 7468 2074 6963  ariable with tic
│ │ │ │ +00044470: 6b65 7420 696e 666f 2e0a 0a20 2020 2020  ket info...     
│ │ │ │ +00044480: 2a44 6573 6372 6970 7469 6f6e 3a2a 2044  *Description:* D
│ │ │ │ +00044490: 6574 6572 6d69 6e65 2069 6620 7469 636b  etermine if tick
│ │ │ │ +000444a0: 6574 2069 7320 7072 6f78 6961 626c 652e  et is proxiable.
│ │ │ │ +000444b0: 0a0a 2020 2020 2054 6865 2050 524f 5849  ..     The PROXI
│ │ │ │ +000444c0: 4142 4c45 2066 6c61 6720 696e 2061 2074  ABLE flag in a t
│ │ │ │ +000444d0: 6963 6b65 7420 6973 206e 6f72 6d61 6c6c  icket is normall
│ │ │ │ +000444e0: 7920 6f6e 6c79 2069 6e74 6572 7072 6574  y only interpret
│ │ │ │ +000444f0: 6564 2062 7920 7468 650a 2020 2020 2074  ed by the.     t
│ │ │ │ +00044500: 6963 6b65 742d 6772 616e 7469 6e67 2073  icket-granting s
│ │ │ │ +00044510: 6572 7669 6365 2e20 2049 7420 6361 6e20  ervice.  It can 
│ │ │ │ +00044520: 6265 2069 676e 6f72 6564 2062 7920 6170  be ignored by ap
│ │ │ │ +00044530: 706c 6963 6174 696f 6e20 7365 7276 6572  plication server
│ │ │ │ +00044540: 732e 0a20 2020 2020 5768 656e 2073 6574  s..     When set
│ │ │ │ +00044550: 2c20 7468 6973 2066 6c61 6720 7465 6c6c  , this flag tell
│ │ │ │ +00044560: 7320 7468 6520 7469 636b 6574 2d67 7261  s the ticket-gra
│ │ │ │ +00044570: 6e74 696e 6720 7365 7276 6572 2074 6861  nting server tha
│ │ │ │ +00044580: 7420 6974 2069 7320 4f4b 0a20 2020 2020  t it is OK.     
│ │ │ │ +00044590: 746f 2069 7373 7565 2061 206e 6577 2074  to issue a new t
│ │ │ │ +000445a0: 6963 6b65 7420 2862 7574 206e 6f74 2061  icket (but not a
│ │ │ │ +000445b0: 2074 6963 6b65 742d 6772 616e 7469 6e67   ticket-granting
│ │ │ │ +000445c0: 2074 6963 6b65 7429 2077 6974 6820 610a   ticket) with a.
│ │ │ │ +000445d0: 2020 2020 2064 6966 6665 7265 6e74 206e       different n
│ │ │ │ +000445e0: 6574 776f 726b 2061 6464 7265 7373 2062  etwork address b
│ │ │ │ +000445f0: 6173 6564 206f 6e20 7468 6973 2074 6963  ased on this tic
│ │ │ │ +00044600: 6b65 742e 2020 5468 6973 2066 6c61 6720  ket.  This flag 
│ │ │ │ +00044610: 6973 2073 6574 0a20 2020 2020 6966 2072  is set.     if r
│ │ │ │ +00044620: 6571 7565 7374 6564 2062 7920 7468 6520  equested by the 
│ │ │ │ +00044630: 636c 6965 6e74 206f 6e20 696e 6974 6961  client on initia
│ │ │ │ +00044640: 6c20 6175 7468 656e 7469 6361 7469 6f6e  l authentication
│ │ │ │ +00044650: 2e20 2042 7920 6465 6661 756c 742c 0a20  .  By default,. 
│ │ │ │ +00044660: 2020 2020 7468 6520 636c 6965 6e74 2077      the client w
│ │ │ │ +00044670: 696c 6c20 7265 7175 6573 7420 7468 6174  ill request that
│ │ │ │ +00044680: 2069 7420 6265 2073 6574 2077 6865 6e20   it be set when 
│ │ │ │ +00044690: 7265 7175 6573 7469 6e67 2061 0a20 2020  requesting a.   
│ │ │ │ +000446a0: 2020 7469 636b 6574 2d67 7261 6e74 696e    ticket-grantin
│ │ │ │ +000446b0: 6720 7469 636b 6574 2c20 616e 6420 7265  g ticket, and re
│ │ │ │ +000446c0: 7365 7420 7768 656e 2072 6571 7565 7374  set when request
│ │ │ │ +000446d0: 696e 6720 616e 7920 6f74 6865 7220 7469  ing any other ti
│ │ │ │ +000446e0: 636b 6574 2e0a 0a20 2020 2020 2a52 6574  cket...     *Ret
│ │ │ │ +000446f0: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ +00044700: 726e 7320 6e6f 6e2d 3020 6966 6620 7072  rns non-0 iff pr
│ │ │ │ +00044710: 6f78 6961 626c 6520 666c 6167 2069 7320  oxiable flag is 
│ │ │ │ +00044720: 7365 7420 696e 2074 6963 6b65 742e 0a0a  set in ticket...
│ │ │ │ +00044730: 7368 6973 6869 5f74 6b74 5f70 726f 7879  shishi_tkt_proxy
│ │ │ │ +00044740: 5f70 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  _p.-------------
│ │ │ │ +00044750: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +00044760: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ +00044770: 746b 745f 7072 6f78 795f 7020 2853 6869  tkt_proxy_p (Shi
│ │ │ │ +00044780: 7368 695f 746b 7420 2a20 544b 5429 0a20  shi_tkt * TKT). 
│ │ │ │ +00044790: 2020 2020 544b 543a 2069 6e70 7574 2076      TKT: input v
│ │ │ │ +000447a0: 6172 6961 626c 6520 7769 7468 2074 6963  ariable with tic
│ │ │ │ +000447b0: 6b65 7420 696e 666f 2e0a 0a20 2020 2020  ket info...     
│ │ │ │ +000447c0: 2a44 6573 6372 6970 7469 6f6e 3a2a 2044  *Description:* D
│ │ │ │ +000447d0: 6574 6572 6d69 6e65 2069 6620 7469 636b  etermine if tick
│ │ │ │ +000447e0: 6574 2069 7320 7072 6f78 7920 7469 636b  et is proxy tick
│ │ │ │ +000447f0: 6574 2e0a 0a20 2020 2020 5468 6520 5052  et...     The PR
│ │ │ │ +00044800: 4f58 5920 666c 6167 2069 7320 7365 7420  OXY flag is set 
│ │ │ │ +00044810: 696e 2061 2074 6963 6b65 7420 6279 2074  in a ticket by t
│ │ │ │ +00044820: 6865 2054 4753 2077 6865 6e20 6974 2069  he TGS when it i
│ │ │ │ +00044830: 7373 7565 7320 6120 7072 6f78 790a 2020  ssues a proxy.  
│ │ │ │ +00044840: 2020 2074 6963 6b65 742e 2020 4170 706c     ticket.  Appl
│ │ │ │ +00044850: 6963 6174 696f 6e20 7365 7276 6572 7320  ication servers 
│ │ │ │ +00044860: 4d41 5920 6368 6563 6b20 7468 6973 2066  MAY check this f
│ │ │ │ +00044870: 6c61 6720 616e 6420 6174 2074 6865 6972  lag and at their
│ │ │ │ +00044880: 0a20 2020 2020 6f70 7469 6f6e 2074 6865  .     option the
│ │ │ │ +00044890: 7920 4d41 5920 7265 7175 6972 6520 6164  y MAY require ad
│ │ │ │ +000448a0: 6469 7469 6f6e 616c 2061 7574 6865 6e74  ditional authent
│ │ │ │ +000448b0: 6963 6174 696f 6e20 6672 6f6d 2074 6865  ication from the
│ │ │ │ +000448c0: 2061 6765 6e74 0a20 2020 2020 7072 6573   agent.     pres
│ │ │ │ +000448d0: 656e 7469 6e67 2074 6865 2070 726f 7879  enting the proxy
│ │ │ │ +000448e0: 2069 6e20 6f72 6465 7220 746f 2070 726f   in order to pro
│ │ │ │ +000448f0: 7669 6465 2061 6e20 6175 6469 7420 7472  vide an audit tr
│ │ │ │ +00044900: 6169 6c2e 0a0a 2020 2020 202a 5265 7475  ail...     *Retu
│ │ │ │ +00044910: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ +00044920: 6e73 206e 6f6e 2d30 2069 6666 2070 726f  ns non-0 iff pro
│ │ │ │ +00044930: 7879 2066 6c61 6720 6973 2073 6574 2069  xy flag is set i
│ │ │ │ +00044940: 6e20 7469 636b 6574 2e0a 0a73 6869 7368  n ticket...shish
│ │ │ │ +00044950: 695f 746b 745f 6d61 795f 706f 7374 6461  i_tkt_may_postda
│ │ │ │ +00044960: 7465 5f70 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  te_p.-----------
│ │ │ │ +00044970: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ +00044980: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ +00044990: 7420 7368 6973 6869 5f74 6b74 5f6d 6179  t shishi_tkt_may
│ │ │ │ +000449a0: 5f70 6f73 7464 6174 655f 7020 2853 6869  _postdate_p (Shi
│ │ │ │ +000449b0: 7368 695f 746b 7420 2a20 544b 5429 0a20  shi_tkt * TKT). 
│ │ │ │ +000449c0: 2020 2020 544b 543a 2069 6e70 7574 2076      TKT: input v
│ │ │ │ +000449d0: 6172 6961 626c 6520 7769 7468 2074 6963  ariable with tic
│ │ │ │ +000449e0: 6b65 7420 696e 666f 2e0a 0a20 2020 2020  ket info...     
│ │ │ │ +000449f0: 2a44 6573 6372 6970 7469 6f6e 3a2a 2044  *Description:* D
│ │ │ │ +00044a00: 6574 6572 6d69 6e65 2069 6620 7469 636b  etermine if tick
│ │ │ │ +00044a10: 6574 206d 6179 2062 6520 7573 6564 2074  et may be used t
│ │ │ │ +00044a20: 6f20 6772 616e 7420 706f 7374 6461 7465  o grant postdate
│ │ │ │ +00044a30: 640a 2020 2020 2074 6963 6b65 7473 2e0a  d.     tickets..
│ │ │ │ +00044a40: 0a20 2020 2020 5468 6520 4d41 592d 504f  .     The MAY-PO
│ │ │ │ +00044a50: 5354 4441 5445 2066 6c61 6720 696e 2061  STDATE flag in a
│ │ │ │ +00044a60: 2074 6963 6b65 7420 6973 206e 6f72 6d61   ticket is norma
│ │ │ │ +00044a70: 6c6c 7920 6f6e 6c79 2069 6e74 6572 7072  lly only interpr
│ │ │ │ +00044a80: 6574 6564 2062 790a 2020 2020 2074 6865  eted by.     the
│ │ │ │ +00044a90: 2074 6963 6b65 742d 6772 616e 7469 6e67   ticket-granting
│ │ │ │ +00044aa0: 2073 6572 7669 6365 2e20 2049 7420 6361   service.  It ca
│ │ │ │ +00044ab0: 6e20 6265 2069 676e 6f72 6564 2062 7920  n be ignored by 
│ │ │ │ +00044ac0: 6170 706c 6963 6174 696f 6e0a 2020 2020  application.    
│ │ │ │ +00044ad0: 2073 6572 7665 7273 2e20 2054 6869 7320   servers.  This 
│ │ │ │ +00044ae0: 666c 6167 204d 5553 5420 6265 2073 6574  flag MUST be set
│ │ │ │ +00044af0: 2069 6e20 6120 7469 636b 6574 2d67 7261   in a ticket-gra
│ │ │ │ +00044b00: 6e74 696e 6720 7469 636b 6574 2069 6e0a  nting ticket in.
│ │ │ │ +00044b10: 2020 2020 206f 7264 6572 2074 6f20 6973       order to is
│ │ │ │ +00044b20: 7375 6520 6120 706f 7374 6461 7465 6420  sue a postdated 
│ │ │ │ +00044b30: 7469 636b 6574 2062 6173 6564 206f 6e20  ticket based on 
│ │ │ │ +00044b40: 7468 6520 7072 6573 656e 7465 6420 7469  the presented ti
│ │ │ │ +00044b50: 636b 6574 2e0a 2020 2020 2049 7420 6973  cket..     It is
│ │ │ │ +00044b60: 2072 6573 6574 2062 7920 6465 6661 756c   reset by defaul
│ │ │ │ +00044b70: 743b 2069 7420 4d41 5920 6265 2072 6571  t; it MAY be req
│ │ │ │ +00044b80: 7565 7374 6564 2062 7920 6120 636c 6965  uested by a clie
│ │ │ │ +00044b90: 6e74 2062 7920 7365 7474 696e 670a 2020  nt by setting.  
│ │ │ │ +00044ba0: 2020 2074 6865 2041 4c4c 4f57 2d20 504f     the ALLOW- PO
│ │ │ │ +00044bb0: 5354 4441 5445 206f 7074 696f 6e20 696e  STDATE option in
│ │ │ │ +00044bc0: 2074 6865 204b 5242 5f41 535f 5245 5120   the KRB_AS_REQ 
│ │ │ │ +00044bd0: 6d65 7373 6167 652e 2020 5468 6973 2066  message.  This f
│ │ │ │ +00044be0: 6c61 670a 2020 2020 2064 6f65 7320 6e6f  lag.     does no
│ │ │ │ +00044bf0: 7420 616c 6c6f 7720 6120 636c 6965 6e74  t allow a client
│ │ │ │ +00044c00: 2074 6f20 6f62 7461 696e 2061 2070 6f73   to obtain a pos
│ │ │ │ +00044c10: 7464 6174 6564 2074 6963 6b65 742d 6772  tdated ticket-gr
│ │ │ │ +00044c20: 616e 7469 6e67 0a20 2020 2020 7469 636b  anting.     tick
│ │ │ │ +00044c30: 6574 3b20 706f 7374 6461 7465 6420 7469  et; postdated ti
│ │ │ │ +00044c40: 636b 6574 2d67 7261 6e74 696e 6720 7469  cket-granting ti
│ │ │ │ +00044c50: 636b 6574 7320 6361 6e20 6f6e 6c79 2062  ckets can only b
│ │ │ │ +00044c60: 7920 6f62 7461 696e 6564 2062 790a 2020  y obtained by.  
│ │ │ │ +00044c70: 2020 2072 6571 7565 7374 696e 6720 7468     requesting th
│ │ │ │ +00044c80: 6520 706f 7374 6461 7469 6e67 2069 6e20  e postdating in 
│ │ │ │ +00044c90: 7468 6520 4b52 425f 4153 5f52 4551 206d  the KRB_AS_REQ m
│ │ │ │ +00044ca0: 6573 7361 6765 2e20 2054 6865 206c 6966  essage.  The lif
│ │ │ │ +00044cb0: 650a 2020 2020 2028 656e 6474 696d 652d  e.     (endtime-
│ │ │ │ +00044cc0: 7374 6172 7474 696d 6529 206f 6620 6120  starttime) of a 
│ │ │ │ +00044cd0: 706f 7374 6461 7465 6420 7469 636b 6574  postdated ticket
│ │ │ │ +00044ce0: 2077 696c 6c20 6265 2074 6865 2072 656d   will be the rem
│ │ │ │ +00044cf0: 6169 6e69 6e67 0a20 2020 2020 6c69 6665  aining.     life
│ │ │ │ +00044d00: 206f 6620 7468 6520 7469 636b 6574 2d67   of the ticket-g
│ │ │ │ +00044d10: 7261 6e74 696e 6720 7469 636b 6574 2061  ranting ticket a
│ │ │ │ +00044d20: 7420 7468 6520 7469 6d65 206f 6620 7468  t the time of th
│ │ │ │ +00044d30: 6520 7265 7175 6573 742c 0a20 2020 2020  e request,.     
│ │ │ │ +00044d40: 756e 6c65 7373 2074 6865 2052 454e 4557  unless the RENEW
│ │ │ │ +00044d50: 4142 4c45 206f 7074 696f 6e20 6973 2061  ABLE option is a
│ │ │ │ +00044d60: 6c73 6f20 7365 742c 2069 6e20 7768 6963  lso set, in whic
│ │ │ │ +00044d70: 6820 6361 7365 2069 7420 6361 6e20 6265  h case it can be
│ │ │ │ +00044d80: 0a20 2020 2020 7468 6520 6675 6c6c 206c  .     the full l
│ │ │ │ +00044d90: 6966 6520 2865 6e64 7469 6d65 2d73 7461  ife (endtime-sta
│ │ │ │ +00044da0: 7274 7469 6d65 2920 6f66 2074 6865 2074  rttime) of the t
│ │ │ │ +00044db0: 6963 6b65 742d 6772 616e 7469 6e67 2074  icket-granting t
│ │ │ │ +00044dc0: 6963 6b65 742e 0a20 2020 2020 5468 6520  icket..     The 
│ │ │ │ +00044dd0: 4b44 4320 4d41 5920 6c69 6d69 7420 686f  KDC MAY limit ho
│ │ │ │ +00044de0: 7720 6661 7220 696e 2074 6865 2066 7574  w far in the fut
│ │ │ │ +00044df0: 7572 6520 6120 7469 636b 6574 206d 6179  ure a ticket may
│ │ │ │ +00044e00: 2062 6520 706f 7374 6461 7465 642e 0a0a   be postdated...
│ │ │ │ +00044e10: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ +00044e20: 7565 3a2a 2052 6574 7572 6e73 206e 6f6e  ue:* Returns non
│ │ │ │ +00044e30: 2d30 2069 6666 206d 6179 2d70 6f73 7464  -0 iff may-postd
│ │ │ │ +00044e40: 6174 6520 666c 6167 2069 7320 7365 7420  ate flag is set 
│ │ │ │ +00044e50: 696e 0a20 2020 2020 7469 636b 6574 2e0a  in.     ticket..
│ │ │ │ +00044e60: 0a73 6869 7368 695f 746b 745f 706f 7374  .shishi_tkt_post
│ │ │ │ +00044e70: 6461 7465 645f 700a 2d2d 2d2d 2d2d 2d2d  dated_p.--------
│ │ │ │ +00044e80: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ +00044e90: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ +00044ea0: 7420 7368 6973 6869 5f74 6b74 5f70 6f73  t shishi_tkt_pos
│ │ │ │ +00044eb0: 7464 6174 6564 5f70 2028 5368 6973 6869  tdated_p (Shishi
│ │ │ │ +00044ec0: 5f74 6b74 202a 2054 4b54 290a 2020 2020  _tkt * TKT).    
│ │ │ │ +00044ed0: 2054 4b54 3a20 696e 7075 7420 7661 7269   TKT: input vari
│ │ │ │ +00044ee0: 6162 6c65 2077 6974 6820 7469 636b 6574  able with ticket
│ │ │ │ +00044ef0: 2069 6e66 6f2e 0a0a 2020 2020 202a 4465   info...     *De
│ │ │ │ +00044f00: 7363 7269 7074 696f 6e3a 2a20 4465 7465  scription:* Dete
│ │ │ │ +00044f10: 726d 696e 6520 6966 2074 6963 6b65 7420  rmine if ticket 
│ │ │ │ +00044f20: 6973 2070 6f73 7464 6174 6564 2e0a 0a20  is postdated... 
│ │ │ │ +00044f30: 2020 2020 5468 6520 504f 5354 4441 5445      The POSTDATE
│ │ │ │ +00044f40: 4420 666c 6167 2069 6e64 6963 6174 6573  D flag indicates
│ │ │ │ +00044f50: 2074 6861 7420 6120 7469 636b 6574 2068   that a ticket h
│ │ │ │ +00044f60: 6173 2062 6565 6e20 706f 7374 6461 7465  as been postdate
│ │ │ │ +00044f70: 642e 2020 5468 650a 2020 2020 2061 7070  d.  The.     app
│ │ │ │ +00044f80: 6c69 6361 7469 6f6e 2073 6572 7665 7220  lication server 
│ │ │ │ +00044f90: 6361 6e20 6368 6563 6b20 7468 6520 6175  can check the au
│ │ │ │ +00044fa0: 7468 7469 6d65 2066 6965 6c64 2069 6e20  thtime field in 
│ │ │ │ +00044fb0: 7468 6520 7469 636b 6574 2074 6f0a 2020  the ticket to.  
│ │ │ │ +00044fc0: 2020 2073 6565 2077 6865 6e20 7468 6520     see when the 
│ │ │ │ +00044fd0: 6f72 6967 696e 616c 2061 7574 6865 6e74  original authent
│ │ │ │ +00044fe0: 6963 6174 696f 6e20 6f63 6375 7272 6564  ication occurred
│ │ │ │ +00044ff0: 2e20 2053 6f6d 6520 7365 7276 6963 6573  .  Some services
│ │ │ │ +00045000: 204d 4159 0a20 2020 2020 6368 6f6f 7365   MAY.     choose
│ │ │ │ +00045010: 2074 6f20 7265 6a65 6374 2070 6f73 7464   to reject postd
│ │ │ │ +00045020: 6174 6564 2074 6963 6b65 7473 2c20 6f72  ated tickets, or
│ │ │ │ +00045030: 2074 6865 7920 6d61 7920 6f6e 6c79 2061   they may only a
│ │ │ │ +00045040: 6363 6570 7420 7468 656d 0a20 2020 2020  ccept them.     
│ │ │ │ +00045050: 7769 7468 696e 2061 2063 6572 7461 696e  within a certain
│ │ │ │ +00045060: 2070 6572 696f 6420 6166 7465 7220 7468   period after th
│ │ │ │ +00045070: 6520 6f72 6967 696e 616c 2061 7574 6865  e original authe
│ │ │ │ +00045080: 6e74 6963 6174 696f 6e2e 2020 5768 656e  ntication.  When
│ │ │ │ +00045090: 0a20 2020 2020 7468 6520 4b44 4320 6973  .     the KDC is
│ │ │ │ +000450a0: 7375 6573 2061 2050 4f53 5444 4154 4544  sues a POSTDATED
│ │ │ │ +000450b0: 2074 6963 6b65 742c 2069 7420 7769 6c6c   ticket, it will
│ │ │ │ +000450c0: 2061 6c73 6f20 6265 206d 6172 6b65 6420   also be marked 
│ │ │ │ +000450d0: 6173 0a20 2020 2020 494e 5641 4c49 442c  as.     INVALID,
│ │ │ │ +000450e0: 2073 6f20 7468 6174 2074 6865 2061 7070   so that the app
│ │ │ │ +000450f0: 6c69 6361 7469 6f6e 2063 6c69 656e 7420  lication client 
│ │ │ │ +00045100: 4d55 5354 2070 7265 7365 6e74 2074 6865  MUST present the
│ │ │ │ +00045110: 2074 6963 6b65 7420 746f 0a20 2020 2020   ticket to.     
│ │ │ │ +00045120: 7468 6520 4b44 4320 746f 2062 6520 7661  the KDC to be va
│ │ │ │ +00045130: 6c69 6461 7465 6420 6265 666f 7265 2075  lidated before u
│ │ │ │ +00045140: 7365 2e0a 0a20 2020 2020 2a52 6574 7572  se...     *Retur
│ │ │ │ +00045150: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ +00045160: 7320 6e6f 6e2d 3020 6966 6620 706f 7374  s non-0 iff post
│ │ │ │ +00045170: 6461 7465 6420 666c 6167 2069 7320 7365  dated flag is se
│ │ │ │ +00045180: 7420 696e 2074 6963 6b65 742e 0a0a 7368  t in ticket...sh
│ │ │ │ +00045190: 6973 6869 5f74 6b74 5f69 6e76 616c 6964  ishi_tkt_invalid
│ │ │ │ +000451a0: 5f70 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  _p.-------------
│ │ │ │ +000451b0: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +000451c0: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ +000451d0: 695f 746b 745f 696e 7661 6c69 645f 7020  i_tkt_invalid_p 
│ │ │ │ +000451e0: 2853 6869 7368 695f 746b 7420 2a20 544b  (Shishi_tkt * TK
│ │ │ │ +000451f0: 5429 0a20 2020 2020 544b 543a 2069 6e70  T).     TKT: inp
│ │ │ │ +00045200: 7574 2076 6172 6961 626c 6520 7769 7468  ut variable with
│ │ │ │ +00045210: 2074 6963 6b65 7420 696e 666f 2e0a 0a20   ticket info... 
│ │ │ │ +00045220: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ +00045230: 3a2a 2044 6574 6572 6d69 6e65 2069 6620  :* Determine if 
│ │ │ │ +00045240: 7469 636b 6574 2069 7320 696e 7661 6c69  ticket is invali
│ │ │ │ +00045250: 642e 0a0a 2020 2020 2054 6865 2049 4e56  d...     The INV
│ │ │ │ +00045260: 414c 4944 2066 6c61 6720 696e 6469 6361  ALID flag indica
│ │ │ │ +00045270: 7465 7320 7468 6174 2061 2074 6963 6b65  tes that a ticke
│ │ │ │ +00045280: 7420 6973 2069 6e76 616c 6964 2e20 2041  t is invalid.  A
│ │ │ │ +00045290: 7070 6c69 6361 7469 6f6e 0a20 2020 2020  pplication.     
│ │ │ │ +000452a0: 7365 7276 6572 7320 4d55 5354 2072 656a  servers MUST rej
│ │ │ │ +000452b0: 6563 7420 7469 636b 6574 7320 7768 6963  ect tickets whic
│ │ │ │ +000452c0: 6820 6861 7665 2074 6869 7320 666c 6167  h have this flag
│ │ │ │ +000452d0: 2073 6574 2e20 2041 2070 6f73 7464 6174   set.  A postdat
│ │ │ │ +000452e0: 6564 0a20 2020 2020 7469 636b 6574 2077  ed.     ticket w
│ │ │ │ +000452f0: 696c 6c20 6265 2069 7373 7565 6420 696e  ill be issued in
│ │ │ │ +00045300: 2074 6869 7320 666f 726d 2e20 2049 6e76   this form.  Inv
│ │ │ │ +00045310: 616c 6964 2074 6963 6b65 7473 204d 5553  alid tickets MUS
│ │ │ │ +00045320: 5420 6265 0a20 2020 2020 7661 6c69 6461  T be.     valida
│ │ │ │ +00045330: 7465 6420 6279 2074 6865 204b 4443 2062  ted by the KDC b
│ │ │ │ +00045340: 6566 6f72 6520 7573 652c 2062 7920 7072  efore use, by pr
│ │ │ │ +00045350: 6573 656e 7469 6e67 2074 6865 6d20 746f  esenting them to
│ │ │ │ +00045360: 2074 6865 204b 4443 2069 6e20 610a 2020   the KDC in a.  
│ │ │ │ +00045370: 2020 2054 4753 2072 6571 7565 7374 2077     TGS request w
│ │ │ │ +00045380: 6974 6820 7468 6520 5641 4c49 4441 5445  ith the VALIDATE
│ │ │ │ +00045390: 206f 7074 696f 6e20 7370 6563 6966 6965   option specifie
│ │ │ │ +000453a0: 642e 2020 5468 6520 4b44 4320 7769 6c6c  d.  The KDC will
│ │ │ │ +000453b0: 206f 6e6c 790a 2020 2020 2076 616c 6964   only.     valid
│ │ │ │ +000453c0: 6174 6520 7469 636b 6574 7320 6166 7465  ate tickets afte
│ │ │ │ +000453d0: 7220 7468 6569 7220 7374 6172 7474 696d  r their starttim
│ │ │ │ +000453e0: 6520 6861 7320 7061 7373 6564 2e20 2054  e has passed.  T
│ │ │ │ +000453f0: 6865 2076 616c 6964 6174 696f 6e0a 2020  he validation.  
│ │ │ │ +00045400: 2020 2069 7320 7265 7175 6972 6564 2073     is required s
│ │ │ │ +00045410: 6f20 7468 6174 2070 6f73 7464 6174 6564  o that postdated
│ │ │ │ +00045420: 2074 6963 6b65 7473 2077 6869 6368 2068   tickets which h
│ │ │ │ +00045430: 6176 6520 6265 656e 2073 746f 6c65 6e20  ave been stolen 
│ │ │ │ +00045440: 6265 666f 7265 0a20 2020 2020 7468 6569  before.     thei
│ │ │ │ +00045450: 7220 7374 6172 7474 696d 6520 6361 6e20  r starttime can 
│ │ │ │ +00045460: 6265 2072 656e 6465 7265 6420 7065 726d  be rendered perm
│ │ │ │ +00045470: 616e 656e 746c 7920 696e 7661 6c69 6420  anently invalid 
│ │ │ │ +00045480: 2874 6872 6f75 6768 2061 0a20 2020 2020  (through a.     
│ │ │ │ +00045490: 686f 742d 6c69 7374 206d 6563 6861 6e69  hot-list mechani
│ │ │ │ +000454a0: 736d 292e 0a0a 2020 2020 202a 5265 7475  sm)...     *Retu
│ │ │ │ +000454b0: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ +000454c0: 6e73 206e 6f6e 2d30 2069 6666 2069 6e76  ns non-0 iff inv
│ │ │ │ +000454d0: 616c 6964 2066 6c61 6720 6973 2073 6574  alid flag is set
│ │ │ │ +000454e0: 2069 6e20 7469 636b 6574 2e0a 0a73 6869   in ticket...shi
│ │ │ │ +000454f0: 7368 695f 746b 745f 7265 6e65 7761 626c  shi_tkt_renewabl
│ │ │ │ +00045500: 655f 700a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  e_p.------------
│ │ │ │ +00045510: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +00045520: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ +00045530: 6973 6869 5f74 6b74 5f72 656e 6577 6162  ishi_tkt_renewab
│ │ │ │ +00045540: 6c65 5f70 2028 5368 6973 6869 5f74 6b74  le_p (Shishi_tkt
│ │ │ │ +00045550: 202a 2054 4b54 290a 2020 2020 2054 4b54   * TKT).     TKT
│ │ │ │ +00045560: 3a20 696e 7075 7420 7661 7269 6162 6c65  : input variable
│ │ │ │ +00045570: 2077 6974 6820 7469 636b 6574 2069 6e66   with ticket inf
│ │ │ │ +00045580: 6f2e 0a0a 2020 2020 202a 4465 7363 7269  o...     *Descri
│ │ │ │ +00045590: 7074 696f 6e3a 2a20 4465 7465 726d 696e  ption:* Determin
│ │ │ │ +000455a0: 6520 6966 2074 6963 6b65 7420 6973 2072  e if ticket is r
│ │ │ │ +000455b0: 656e 6577 6162 6c65 2e0a 0a20 2020 2020  enewable...     
│ │ │ │ +000455c0: 5468 6520 5245 4e45 5741 424c 4520 666c  The RENEWABLE fl
│ │ │ │ +000455d0: 6167 2069 6e20 6120 7469 636b 6574 2069  ag in a ticket i
│ │ │ │ +000455e0: 7320 6e6f 726d 616c 6c79 206f 6e6c 7920  s normally only 
│ │ │ │ +000455f0: 696e 7465 7270 7265 7465 6420 6279 2074  interpreted by t
│ │ │ │ +00045600: 6865 0a20 2020 2020 7469 636b 6574 2d67  he.     ticket-g
│ │ │ │ +00045610: 7261 6e74 696e 6720 7365 7276 6963 6520  ranting service 
│ │ │ │ +00045620: 2864 6973 6375 7373 6564 2062 656c 6f77  (discussed below
│ │ │ │ +00045630: 2069 6e20 7365 6374 696f 6e20 332e 3329   in section 3.3)
│ │ │ │ +00045640: 2e20 2049 7420 6361 6e0a 2020 2020 2075  .  It can.     u
│ │ │ │ +00045650: 7375 616c 6c79 2062 6520 6967 6e6f 7265  sually be ignore
│ │ │ │ +00045660: 6420 6279 2061 7070 6c69 6361 7469 6f6e  d by application
│ │ │ │ +00045670: 2073 6572 7665 7273 2e20 2048 6f77 6576   servers.  Howev
│ │ │ │ +00045680: 6572 2c20 736f 6d65 0a20 2020 2020 7061  er, some.     pa
│ │ │ │ +00045690: 7274 6963 756c 6172 6c79 2063 6172 6566  rticularly caref
│ │ │ │ +000456a0: 756c 2061 7070 6c69 6361 7469 6f6e 2073  ul application s
│ │ │ │ +000456b0: 6572 7665 7273 204d 4159 2064 6973 616c  ervers MAY disal
│ │ │ │ +000456c0: 6c6f 7720 7265 6e65 7761 626c 650a 2020  low renewable.  
│ │ │ │ +000456d0: 2020 2074 6963 6b65 7473 2e0a 0a20 2020     tickets...   
│ │ │ │ +000456e0: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ +000456f0: 2a20 5265 7475 726e 7320 6e6f 6e2d 3020  * Returns non-0 
│ │ │ │ +00045700: 6966 6620 7265 6e65 7761 626c 6520 666c  iff renewable fl
│ │ │ │ +00045710: 6167 2069 7320 7365 7420 696e 2074 6963  ag is set in tic
│ │ │ │ +00045720: 6b65 742e 0a0a 7368 6973 6869 5f74 6b74  ket...shishi_tkt
│ │ │ │ +00045730: 5f69 6e69 7469 616c 5f70 0a2d 2d2d 2d2d  _initial_p.-----
│ │ │ │ +00045740: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +00045750: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ +00045760: 6e74 2073 6869 7368 695f 746b 745f 696e  nt shishi_tkt_in
│ │ │ │ +00045770: 6974 6961 6c5f 7020 2853 6869 7368 695f  itial_p (Shishi_
│ │ │ │ +00045780: 746b 7420 2a20 544b 5429 0a20 2020 2020  tkt * TKT).     
│ │ │ │ +00045790: 544b 543a 2069 6e70 7574 2076 6172 6961  TKT: input varia
│ │ │ │ +000457a0: 626c 6520 7769 7468 2074 6963 6b65 7420  ble with ticket 
│ │ │ │ +000457b0: 696e 666f 2e0a 0a20 2020 2020 2a44 6573  info...     *Des
│ │ │ │ +000457c0: 6372 6970 7469 6f6e 3a2a 2044 6574 6572  cription:* Deter
│ │ │ │ +000457d0: 6d69 6e65 2069 6620 7469 636b 6574 2077  mine if ticket w
│ │ │ │ +000457e0: 6173 2069 7373 7565 6420 7573 696e 6720  as issued using 
│ │ │ │ +000457f0: 4153 2065 7863 6861 6e67 652e 0a0a 2020  AS exchange...  
│ │ │ │ +00045800: 2020 2054 6865 2049 4e49 5449 414c 2066     The INITIAL f
│ │ │ │ +00045810: 6c61 6720 696e 6469 6361 7465 7320 7468  lag indicates th
│ │ │ │ +00045820: 6174 2061 2074 6963 6b65 7420 7761 7320  at a ticket was 
│ │ │ │ +00045830: 6973 7375 6564 2075 7369 6e67 2074 6865  issued using the
│ │ │ │ +00045840: 2041 530a 2020 2020 2070 726f 746f 636f   AS.     protoco
│ │ │ │ +00045850: 6c2c 2072 6174 6865 7220 7468 616e 2069  l, rather than i
│ │ │ │ +00045860: 7373 7565 6420 6261 7365 6420 6f6e 2061  ssued based on a
│ │ │ │ +00045870: 2074 6963 6b65 742d 6772 616e 7469 6e67   ticket-granting
│ │ │ │ +00045880: 2074 6963 6b65 742e 0a20 2020 2020 4170   ticket..     Ap
│ │ │ │ +00045890: 706c 6963 6174 696f 6e20 7365 7276 6572  plication server
│ │ │ │ +000458a0: 7320 7468 6174 2077 616e 7420 746f 2072  s that want to r
│ │ │ │ +000458b0: 6571 7569 7265 2074 6865 2064 656d 6f6e  equire the demon
│ │ │ │ +000458c0: 7374 7261 7465 6420 6b6e 6f77 6c65 6467  strated knowledg
│ │ │ │ +000458d0: 650a 2020 2020 206f 6620 6120 636c 6965  e.     of a clie
│ │ │ │ +000458e0: 6e74 2773 2073 6563 7265 7420 6b65 7920  nt's secret key 
│ │ │ │ +000458f0: 2865 2e67 2e20 2061 2070 6173 7377 6f72  (e.g.  a passwor
│ │ │ │ +00045900: 642d 6368 616e 6769 6e67 2070 726f 6772  d-changing progr
│ │ │ │ +00045910: 616d 2920 6361 6e0a 2020 2020 2069 6e73  am) can.     ins
│ │ │ │ +00045920: 6973 7420 7468 6174 2074 6869 7320 666c  ist that this fl
│ │ │ │ +00045930: 6167 2062 6520 7365 7420 696e 2061 6e79  ag be set in any
│ │ │ │ +00045940: 2074 6963 6b65 7473 2074 6865 7920 6163   tickets they ac
│ │ │ │ +00045950: 6365 7074 2c20 616e 6420 7468 7573 0a20  cept, and thus. 
│ │ │ │ +00045960: 2020 2020 6265 2061 7373 7572 6564 2074      be assured t
│ │ │ │ +00045970: 6861 7420 7468 6520 636c 6965 6e74 2773  hat the client's
│ │ │ │ +00045980: 206b 6579 2077 6173 2072 6563 656e 746c   key was recentl
│ │ │ │ +00045990: 7920 7072 6573 656e 7465 6420 746f 2074  y presented to t
│ │ │ │ +000459a0: 6865 0a20 2020 2020 6170 706c 6963 6174  he.     applicat
│ │ │ │ +000459b0: 696f 6e20 636c 6965 6e74 2e0a 0a20 2020  ion client...   
│ │ │ │ +000459c0: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ +000459d0: 2a20 5265 7475 726e 7320 6e6f 6e2d 3020  * Returns non-0 
│ │ │ │ +000459e0: 6966 6620 696e 6974 6961 6c20 666c 6167  iff initial flag
│ │ │ │ +000459f0: 2069 7320 7365 7420 696e 2074 6963 6b65   is set in ticke
│ │ │ │ +00045a00: 742e 0a0a 7368 6973 6869 5f74 6b74 5f70  t...shishi_tkt_p
│ │ │ │ +00045a10: 7265 5f61 7574 6865 6e74 5f70 0a2d 2d2d  re_authent_p.---
│ │ │ │  00045a20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00045a30: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ -00045a40: 6e3a 2069 6e74 2073 6869 7368 695f 746b  n: int shishi_tk
│ │ │ │ -00045a50: 745f 7072 655f 6175 7468 656e 745f 7020  t_pre_authent_p 
│ │ │ │ -00045a60: 2853 6869 7368 695f 746b 7420 2a20 544b  (Shishi_tkt * TK
│ │ │ │ -00045a70: 5429 0a20 2020 2020 544b 543a 2069 6e70  T).     TKT: inp
│ │ │ │ -00045a80: 7574 2076 6172 6961 626c 6520 7769 7468  ut variable with
│ │ │ │ -00045a90: 2074 6963 6b65 7420 696e 666f 2e0a 0a20   ticket info... 
│ │ │ │ -00045aa0: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -00045ab0: 3a2a 2044 6574 6572 6d69 6e65 2069 6620  :* Determine if 
│ │ │ │ -00045ac0: 7469 636b 6574 2077 6173 2070 7265 2d61  ticket was pre-a
│ │ │ │ -00045ad0: 7574 6865 6e74 6963 6174 6564 2e0a 0a20  uthenticated... 
│ │ │ │ -00045ae0: 2020 2020 5468 6520 5052 452d 4155 5448      The PRE-AUTH
│ │ │ │ -00045af0: 454e 5420 616e 6420 4857 2d41 5554 4845  ENT and HW-AUTHE
│ │ │ │ -00045b00: 4e54 2066 6c61 6773 2070 726f 7669 6465  NT flags provide
│ │ │ │ -00045b10: 2061 6464 6974 696f 6e61 6c20 696e 666f   additional info
│ │ │ │ -00045b20: 726d 6174 696f 6e0a 2020 2020 2061 626f  rmation.     abo
│ │ │ │ -00045b30: 7574 2074 6865 2069 6e69 7469 616c 2061  ut the initial a
│ │ │ │ -00045b40: 7574 6865 6e74 6963 6174 696f 6e2c 2072  uthentication, r
│ │ │ │ -00045b50: 6567 6172 646c 6573 7320 6f66 2077 6865  egardless of whe
│ │ │ │ -00045b60: 7468 6572 2074 6865 2063 7572 7265 6e74  ther the current
│ │ │ │ -00045b70: 0a20 2020 2020 7469 636b 6574 2077 6173  .     ticket was
│ │ │ │ -00045b80: 2069 7373 7565 6420 6469 7265 6374 6c79   issued directly
│ │ │ │ -00045b90: 2028 696e 2077 6869 6368 2063 6173 6520   (in which case 
│ │ │ │ -00045ba0: 494e 4954 4941 4c20 7769 6c6c 2061 6c73  INITIAL will als
│ │ │ │ -00045bb0: 6f20 6265 2073 6574 290a 2020 2020 206f  o be set).     o
│ │ │ │ -00045bc0: 7220 6973 7375 6564 206f 6e20 7468 6520  r issued on the 
│ │ │ │ -00045bd0: 6261 7369 7320 6f66 2061 2074 6963 6b65  basis of a ticke
│ │ │ │ -00045be0: 742d 6772 616e 7469 6e67 2074 6963 6b65  t-granting ticke
│ │ │ │ -00045bf0: 7420 2869 6e20 7768 6963 6820 6361 7365  t (in which case
│ │ │ │ -00045c00: 0a20 2020 2020 7468 6520 494e 4954 4941  .     the INITIA
│ │ │ │ -00045c10: 4c20 666c 6167 2069 7320 636c 6561 722c  L flag is clear,
│ │ │ │ -00045c20: 2062 7574 2074 6865 2050 5245 2d41 5554   but the PRE-AUT
│ │ │ │ -00045c30: 4845 4e54 2061 6e64 2048 572d 4155 5448  HENT and HW-AUTH
│ │ │ │ -00045c40: 454e 5420 666c 6167 730a 2020 2020 2061  ENT flags.     a
│ │ │ │ -00045c50: 7265 2063 6172 7269 6564 2066 6f72 7761  re carried forwa
│ │ │ │ -00045c60: 7264 2066 726f 6d20 7468 6520 7469 636b  rd from the tick
│ │ │ │ -00045c70: 6574 2d67 7261 6e74 696e 6720 7469 636b  et-granting tick
│ │ │ │ -00045c80: 6574 292e 0a0a 2020 2020 202a 5265 7475  et)...     *Retu
│ │ │ │ -00045c90: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ -00045ca0: 6e73 206e 6f6e 2d30 2069 6666 2070 7265  ns non-0 iff pre
│ │ │ │ -00045cb0: 2d61 7574 6865 6e74 2066 6c61 6720 6973  -authent flag is
│ │ │ │ -00045cc0: 2073 6574 2069 6e0a 2020 2020 2074 6963   set in.     tic
│ │ │ │ -00045cd0: 6b65 742e 0a0a 7368 6973 6869 5f74 6b74  ket...shishi_tkt
│ │ │ │ -00045ce0: 5f68 775f 6175 7468 656e 745f 700a 2d2d  _hw_authent_p.--
│ │ │ │ +00045a30: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +00045a40: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ +00045a50: 746b 745f 7072 655f 6175 7468 656e 745f  tkt_pre_authent_
│ │ │ │ +00045a60: 7020 2853 6869 7368 695f 746b 7420 2a20  p (Shishi_tkt * 
│ │ │ │ +00045a70: 544b 5429 0a20 2020 2020 544b 543a 2069  TKT).     TKT: i
│ │ │ │ +00045a80: 6e70 7574 2076 6172 6961 626c 6520 7769  nput variable wi
│ │ │ │ +00045a90: 7468 2074 6963 6b65 7420 696e 666f 2e0a  th ticket info..
│ │ │ │ +00045aa0: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +00045ab0: 6f6e 3a2a 2044 6574 6572 6d69 6e65 2069  on:* Determine i
│ │ │ │ +00045ac0: 6620 7469 636b 6574 2077 6173 2070 7265  f ticket was pre
│ │ │ │ +00045ad0: 2d61 7574 6865 6e74 6963 6174 6564 2e0a  -authenticated..
│ │ │ │ +00045ae0: 0a20 2020 2020 5468 6520 5052 452d 4155  .     The PRE-AU
│ │ │ │ +00045af0: 5448 454e 5420 616e 6420 4857 2d41 5554  THENT and HW-AUT
│ │ │ │ +00045b00: 4845 4e54 2066 6c61 6773 2070 726f 7669  HENT flags provi
│ │ │ │ +00045b10: 6465 2061 6464 6974 696f 6e61 6c20 696e  de additional in
│ │ │ │ +00045b20: 666f 726d 6174 696f 6e0a 2020 2020 2061  formation.     a
│ │ │ │ +00045b30: 626f 7574 2074 6865 2069 6e69 7469 616c  bout the initial
│ │ │ │ +00045b40: 2061 7574 6865 6e74 6963 6174 696f 6e2c   authentication,
│ │ │ │ +00045b50: 2072 6567 6172 646c 6573 7320 6f66 2077   regardless of w
│ │ │ │ +00045b60: 6865 7468 6572 2074 6865 2063 7572 7265  hether the curre
│ │ │ │ +00045b70: 6e74 0a20 2020 2020 7469 636b 6574 2077  nt.     ticket w
│ │ │ │ +00045b80: 6173 2069 7373 7565 6420 6469 7265 6374  as issued direct
│ │ │ │ +00045b90: 6c79 2028 696e 2077 6869 6368 2063 6173  ly (in which cas
│ │ │ │ +00045ba0: 6520 494e 4954 4941 4c20 7769 6c6c 2061  e INITIAL will a
│ │ │ │ +00045bb0: 6c73 6f20 6265 2073 6574 290a 2020 2020  lso be set).    
│ │ │ │ +00045bc0: 206f 7220 6973 7375 6564 206f 6e20 7468   or issued on th
│ │ │ │ +00045bd0: 6520 6261 7369 7320 6f66 2061 2074 6963  e basis of a tic
│ │ │ │ +00045be0: 6b65 742d 6772 616e 7469 6e67 2074 6963  ket-granting tic
│ │ │ │ +00045bf0: 6b65 7420 2869 6e20 7768 6963 6820 6361  ket (in which ca
│ │ │ │ +00045c00: 7365 0a20 2020 2020 7468 6520 494e 4954  se.     the INIT
│ │ │ │ +00045c10: 4941 4c20 666c 6167 2069 7320 636c 6561  IAL flag is clea
│ │ │ │ +00045c20: 722c 2062 7574 2074 6865 2050 5245 2d41  r, but the PRE-A
│ │ │ │ +00045c30: 5554 4845 4e54 2061 6e64 2048 572d 4155  UTHENT and HW-AU
│ │ │ │ +00045c40: 5448 454e 5420 666c 6167 730a 2020 2020  THENT flags.    
│ │ │ │ +00045c50: 2061 7265 2063 6172 7269 6564 2066 6f72   are carried for
│ │ │ │ +00045c60: 7761 7264 2066 726f 6d20 7468 6520 7469  ward from the ti
│ │ │ │ +00045c70: 636b 6574 2d67 7261 6e74 696e 6720 7469  cket-granting ti
│ │ │ │ +00045c80: 636b 6574 292e 0a0a 2020 2020 202a 5265  cket)...     *Re
│ │ │ │ +00045c90: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ +00045ca0: 7572 6e73 206e 6f6e 2d30 2069 6666 2070  urns non-0 iff p
│ │ │ │ +00045cb0: 7265 2d61 7574 6865 6e74 2066 6c61 6720  re-authent flag 
│ │ │ │ +00045cc0: 6973 2073 6574 2069 6e0a 2020 2020 2074  is set in.     t
│ │ │ │ +00045cd0: 6963 6b65 742e 0a0a 7368 6973 6869 5f74  icket...shishi_t
│ │ │ │ +00045ce0: 6b74 5f68 775f 6175 7468 656e 745f 700a  kt_hw_authent_p.
│ │ │ │  00045cf0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00045d00: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ -00045d10: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ -00045d20: 746b 745f 6877 5f61 7574 6865 6e74 5f70  tkt_hw_authent_p
│ │ │ │ -00045d30: 2028 5368 6973 6869 5f74 6b74 202a 2054   (Shishi_tkt * T
│ │ │ │ -00045d40: 4b54 290a 2020 2020 2054 4b54 3a20 696e  KT).     TKT: in
│ │ │ │ -00045d50: 7075 7420 7661 7269 6162 6c65 2077 6974  put variable wit
│ │ │ │ -00045d60: 6820 7469 636b 6574 2069 6e66 6f2e 0a0a  h ticket info...
│ │ │ │ -00045d70: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ -00045d80: 6e3a 2a20 4465 7465 726d 696e 6520 6966  n:* Determine if
│ │ │ │ -00045d90: 2074 6963 6b65 7420 6973 2061 7574 6865   ticket is authe
│ │ │ │ -00045da0: 6e74 6963 6174 6564 2075 7369 6e67 2061  nticated using a
│ │ │ │ -00045db0: 0a20 2020 2020 6861 7264 7761 7265 2074  .     hardware t
│ │ │ │ -00045dc0: 6f6b 656e 2e0a 0a20 2020 2020 5468 6520  oken...     The 
│ │ │ │ -00045dd0: 5052 452d 4155 5448 454e 5420 616e 6420  PRE-AUTHENT and 
│ │ │ │ -00045de0: 4857 2d41 5554 4845 4e54 2066 6c61 6773  HW-AUTHENT flags
│ │ │ │ -00045df0: 2070 726f 7669 6465 2061 6464 6974 696f   provide additio
│ │ │ │ -00045e00: 6e61 6c20 696e 666f 726d 6174 696f 6e0a  nal information.
│ │ │ │ -00045e10: 2020 2020 2061 626f 7574 2074 6865 2069       about the i
│ │ │ │ -00045e20: 6e69 7469 616c 2061 7574 6865 6e74 6963  nitial authentic
│ │ │ │ -00045e30: 6174 696f 6e2c 2072 6567 6172 646c 6573  ation, regardles
│ │ │ │ -00045e40: 7320 6f66 2077 6865 7468 6572 2074 6865  s of whether the
│ │ │ │ -00045e50: 2063 7572 7265 6e74 0a20 2020 2020 7469   current.     ti
│ │ │ │ -00045e60: 636b 6574 2077 6173 2069 7373 7565 6420  cket was issued 
│ │ │ │ -00045e70: 6469 7265 6374 6c79 2028 696e 2077 6869  directly (in whi
│ │ │ │ -00045e80: 6368 2063 6173 6520 494e 4954 4941 4c20  ch case INITIAL 
│ │ │ │ -00045e90: 7769 6c6c 2061 6c73 6f20 6265 2073 6574  will also be set
│ │ │ │ -00045ea0: 290a 2020 2020 206f 7220 6973 7375 6564  ).     or issued
│ │ │ │ -00045eb0: 206f 6e20 7468 6520 6261 7369 7320 6f66   on the basis of
│ │ │ │ -00045ec0: 2061 2074 6963 6b65 742d 6772 616e 7469   a ticket-granti
│ │ │ │ -00045ed0: 6e67 2074 6963 6b65 7420 2869 6e20 7768  ng ticket (in wh
│ │ │ │ -00045ee0: 6963 6820 6361 7365 0a20 2020 2020 7468  ich case.     th
│ │ │ │ -00045ef0: 6520 494e 4954 4941 4c20 666c 6167 2069  e INITIAL flag i
│ │ │ │ -00045f00: 7320 636c 6561 722c 2062 7574 2074 6865  s clear, but the
│ │ │ │ -00045f10: 2050 5245 2d41 5554 4845 4e54 2061 6e64   PRE-AUTHENT and
│ │ │ │ -00045f20: 2048 572d 4155 5448 454e 5420 666c 6167   HW-AUTHENT flag
│ │ │ │ -00045f30: 730a 2020 2020 2061 7265 2063 6172 7269  s.     are carri
│ │ │ │ -00045f40: 6564 2066 6f72 7761 7264 2066 726f 6d20  ed forward from 
│ │ │ │ -00045f50: 7468 6520 7469 636b 6574 2d67 7261 6e74  the ticket-grant
│ │ │ │ -00045f60: 696e 6720 7469 636b 6574 292e 0a0a 2020  ing ticket)...  
│ │ │ │ -00045f70: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ -00045f80: 3a2a 2052 6574 7572 6e73 206e 6f6e 2d30  :* Returns non-0
│ │ │ │ -00045f90: 2069 6666 2068 772d 6175 7468 656e 7420   iff hw-authent 
│ │ │ │ -00045fa0: 666c 6167 2069 7320 7365 7420 696e 2074  flag is set in t
│ │ │ │ -00045fb0: 6963 6b65 742e 0a0a 7368 6973 6869 5f74  icket...shishi_t
│ │ │ │ -00045fc0: 6b74 5f74 7261 6e73 6974 6564 5f70 6f6c  kt_transited_pol
│ │ │ │ -00045fd0: 6963 795f 6368 6563 6b65 645f 700a 2d2d  icy_checked_p.--
│ │ │ │ +00045d00: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +00045d10: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ +00045d20: 695f 746b 745f 6877 5f61 7574 6865 6e74  i_tkt_hw_authent
│ │ │ │ +00045d30: 5f70 2028 5368 6973 6869 5f74 6b74 202a  _p (Shishi_tkt *
│ │ │ │ +00045d40: 2054 4b54 290a 2020 2020 2054 4b54 3a20   TKT).     TKT: 
│ │ │ │ +00045d50: 696e 7075 7420 7661 7269 6162 6c65 2077  input variable w
│ │ │ │ +00045d60: 6974 6820 7469 636b 6574 2069 6e66 6f2e  ith ticket info.
│ │ │ │ +00045d70: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ +00045d80: 696f 6e3a 2a20 4465 7465 726d 696e 6520  ion:* Determine 
│ │ │ │ +00045d90: 6966 2074 6963 6b65 7420 6973 2061 7574  if ticket is aut
│ │ │ │ +00045da0: 6865 6e74 6963 6174 6564 2075 7369 6e67  henticated using
│ │ │ │ +00045db0: 2061 0a20 2020 2020 6861 7264 7761 7265   a.     hardware
│ │ │ │ +00045dc0: 2074 6f6b 656e 2e0a 0a20 2020 2020 5468   token...     Th
│ │ │ │ +00045dd0: 6520 5052 452d 4155 5448 454e 5420 616e  e PRE-AUTHENT an
│ │ │ │ +00045de0: 6420 4857 2d41 5554 4845 4e54 2066 6c61  d HW-AUTHENT fla
│ │ │ │ +00045df0: 6773 2070 726f 7669 6465 2061 6464 6974  gs provide addit
│ │ │ │ +00045e00: 696f 6e61 6c20 696e 666f 726d 6174 696f  ional informatio
│ │ │ │ +00045e10: 6e0a 2020 2020 2061 626f 7574 2074 6865  n.     about the
│ │ │ │ +00045e20: 2069 6e69 7469 616c 2061 7574 6865 6e74   initial authent
│ │ │ │ +00045e30: 6963 6174 696f 6e2c 2072 6567 6172 646c  ication, regardl
│ │ │ │ +00045e40: 6573 7320 6f66 2077 6865 7468 6572 2074  ess of whether t
│ │ │ │ +00045e50: 6865 2063 7572 7265 6e74 0a20 2020 2020  he current.     
│ │ │ │ +00045e60: 7469 636b 6574 2077 6173 2069 7373 7565  ticket was issue
│ │ │ │ +00045e70: 6420 6469 7265 6374 6c79 2028 696e 2077  d directly (in w
│ │ │ │ +00045e80: 6869 6368 2063 6173 6520 494e 4954 4941  hich case INITIA
│ │ │ │ +00045e90: 4c20 7769 6c6c 2061 6c73 6f20 6265 2073  L will also be s
│ │ │ │ +00045ea0: 6574 290a 2020 2020 206f 7220 6973 7375  et).     or issu
│ │ │ │ +00045eb0: 6564 206f 6e20 7468 6520 6261 7369 7320  ed on the basis 
│ │ │ │ +00045ec0: 6f66 2061 2074 6963 6b65 742d 6772 616e  of a ticket-gran
│ │ │ │ +00045ed0: 7469 6e67 2074 6963 6b65 7420 2869 6e20  ting ticket (in 
│ │ │ │ +00045ee0: 7768 6963 6820 6361 7365 0a20 2020 2020  which case.     
│ │ │ │ +00045ef0: 7468 6520 494e 4954 4941 4c20 666c 6167  the INITIAL flag
│ │ │ │ +00045f00: 2069 7320 636c 6561 722c 2062 7574 2074   is clear, but t
│ │ │ │ +00045f10: 6865 2050 5245 2d41 5554 4845 4e54 2061  he PRE-AUTHENT a
│ │ │ │ +00045f20: 6e64 2048 572d 4155 5448 454e 5420 666c  nd HW-AUTHENT fl
│ │ │ │ +00045f30: 6167 730a 2020 2020 2061 7265 2063 6172  ags.     are car
│ │ │ │ +00045f40: 7269 6564 2066 6f72 7761 7264 2066 726f  ried forward fro
│ │ │ │ +00045f50: 6d20 7468 6520 7469 636b 6574 2d67 7261  m the ticket-gra
│ │ │ │ +00045f60: 6e74 696e 6720 7469 636b 6574 292e 0a0a  nting ticket)...
│ │ │ │ +00045f70: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ +00045f80: 7565 3a2a 2052 6574 7572 6e73 206e 6f6e  ue:* Returns non
│ │ │ │ +00045f90: 2d30 2069 6666 2068 772d 6175 7468 656e  -0 iff hw-authen
│ │ │ │ +00045fa0: 7420 666c 6167 2069 7320 7365 7420 696e  t flag is set in
│ │ │ │ +00045fb0: 2074 6963 6b65 742e 0a0a 7368 6973 6869   ticket...shishi
│ │ │ │ +00045fc0: 5f74 6b74 5f74 7261 6e73 6974 6564 5f70  _tkt_transited_p
│ │ │ │ +00045fd0: 6f6c 6963 795f 6368 6563 6b65 645f 700a  olicy_checked_p.
│ │ │ │  00045fe0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │  00045ff0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00046000: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ -00046010: 6e3a 2069 6e74 2073 6869 7368 695f 746b  n: int shishi_tk
│ │ │ │ -00046020: 745f 7472 616e 7369 7465 645f 706f 6c69  t_transited_poli
│ │ │ │ -00046030: 6379 5f63 6865 636b 6564 5f70 0a20 2020  cy_checked_p.   
│ │ │ │ -00046040: 2020 2020 2020 2028 5368 6973 6869 5f74         (Shishi_t
│ │ │ │ -00046050: 6b74 202a 2054 4b54 290a 2020 2020 2054  kt * TKT).     T
│ │ │ │ -00046060: 4b54 3a20 696e 7075 7420 7661 7269 6162  KT: input variab
│ │ │ │ -00046070: 6c65 2077 6974 6820 7469 636b 6574 2069  le with ticket i
│ │ │ │ -00046080: 6e66 6f2e 0a0a 2020 2020 202a 4465 7363  nfo...     *Desc
│ │ │ │ -00046090: 7269 7074 696f 6e3a 2a20 4465 7465 726d  ription:* Determ
│ │ │ │ -000460a0: 696e 6520 6966 2074 6963 6b65 7420 6861  ine if ticket ha
│ │ │ │ -000460b0: 7320 6265 656e 2070 6f6c 6963 7920 6368  s been policy ch
│ │ │ │ -000460c0: 6563 6b65 6420 666f 720a 2020 2020 2074  ecked for.     t
│ │ │ │ -000460d0: 7261 6e73 6974 2e0a 0a20 2020 2020 5468  ransit...     Th
│ │ │ │ -000460e0: 6520 6170 706c 6963 6174 696f 6e20 7365  e application se
│ │ │ │ -000460f0: 7276 6572 2069 7320 756c 7469 6d61 7465  rver is ultimate
│ │ │ │ -00046100: 6c79 2072 6573 706f 6e73 6962 6c65 2066  ly responsible f
│ │ │ │ -00046110: 6f72 2061 6363 6570 7469 6e67 206f 720a  or accepting or.
│ │ │ │ -00046120: 2020 2020 2072 656a 6563 7469 6e67 2061       rejecting a
│ │ │ │ -00046130: 7574 6865 6e74 6963 6174 696f 6e20 616e  uthentication an
│ │ │ │ -00046140: 6420 5348 4f55 4c44 2063 6865 636b 2074  d SHOULD check t
│ │ │ │ -00046150: 6861 7420 6f6e 6c79 2073 7569 7461 626c  hat only suitabl
│ │ │ │ -00046160: 790a 2020 2020 2074 7275 7374 6564 204b  y.     trusted K
│ │ │ │ -00046170: 4443 7320 6172 6520 7265 6c69 6564 2075  DCs are relied u
│ │ │ │ -00046180: 706f 6e20 746f 2061 7574 6865 6e74 6963  pon to authentic
│ │ │ │ -00046190: 6174 6520 6120 7072 696e 6369 7061 6c2e  ate a principal.
│ │ │ │ -000461a0: 2020 5468 650a 2020 2020 2074 7261 6e73    The.     trans
│ │ │ │ -000461b0: 6974 6564 2066 6965 6c64 2069 6e20 7468  ited field in th
│ │ │ │ -000461c0: 6520 7469 636b 6574 2069 6465 6e74 6966  e ticket identif
│ │ │ │ -000461d0: 6965 7320 7768 6963 6820 7265 616c 6d73  ies which realms
│ │ │ │ -000461e0: 2028 616e 6420 7468 7573 0a20 2020 2020   (and thus.     
│ │ │ │ -000461f0: 7768 6963 6820 4b44 4373 2920 7765 7265  which KDCs) were
│ │ │ │ -00046200: 2069 6e76 6f6c 7665 6420 696e 2074 6865   involved in the
│ │ │ │ -00046210: 2061 7574 6865 6e74 6963 6174 696f 6e20   authentication 
│ │ │ │ -00046220: 7072 6f63 6573 7320 616e 6420 616e 0a20  process and an. 
│ │ │ │ -00046230: 2020 2020 6170 706c 6963 6174 696f 6e20      application 
│ │ │ │ -00046240: 7365 7276 6572 2077 6f75 6c64 206e 6f72  server would nor
│ │ │ │ -00046250: 6d61 6c6c 7920 6368 6563 6b20 7468 6973  mally check this
│ │ │ │ -00046260: 2066 6965 6c64 2e20 2049 6620 616e 7920   field.  If any 
│ │ │ │ -00046270: 6f66 0a20 2020 2020 7468 6573 6520 6172  of.     these ar
│ │ │ │ -00046280: 6520 756e 7472 7573 7465 6420 746f 2061  e untrusted to a
│ │ │ │ -00046290: 7574 6865 6e74 6963 6174 6520 7468 6520  uthenticate the 
│ │ │ │ -000462a0: 696e 6469 6361 7465 6420 636c 6965 6e74  indicated client
│ │ │ │ -000462b0: 2070 7269 6e63 6970 616c 0a20 2020 2020   principal.     
│ │ │ │ -000462c0: 2870 726f 6261 626c 7920 6465 7465 726d  (probably determ
│ │ │ │ -000462d0: 696e 6564 2062 7920 6120 7265 616c 6d2d  ined by a realm-
│ │ │ │ -000462e0: 6261 7365 6420 706f 6c69 6379 292c 2074  based policy), t
│ │ │ │ -000462f0: 6865 2061 7574 6865 6e74 6963 6174 696f  he authenticatio
│ │ │ │ -00046300: 6e0a 2020 2020 2061 7474 656d 7074 204d  n.     attempt M
│ │ │ │ -00046310: 5553 5420 6265 2072 656a 6563 7465 642e  UST be rejected.
│ │ │ │ -00046320: 2020 5468 6520 7072 6573 656e 6365 206f    The presence o
│ │ │ │ -00046330: 6620 7472 7573 7465 6420 4b44 4373 2069  f trusted KDCs i
│ │ │ │ -00046340: 6e20 7468 6973 0a20 2020 2020 6c69 7374  n this.     list
│ │ │ │ -00046350: 2064 6f65 7320 6e6f 7420 7072 6f76 6964   does not provid
│ │ │ │ -00046360: 6520 616e 7920 6775 6172 616e 7465 653b  e any guarantee;
│ │ │ │ -00046370: 2061 6e20 756e 7472 7573 7465 6420 4b44   an untrusted KD
│ │ │ │ -00046380: 4320 6d61 7920 6861 7665 0a20 2020 2020  C may have.     
│ │ │ │ -00046390: 6661 6272 6963 6174 6564 2074 6865 206c  fabricated the l
│ │ │ │ -000463a0: 6973 742e 0a0a 2020 2020 2057 6869 6c65  ist...     While
│ │ │ │ -000463b0: 2074 6865 2065 6e64 2073 6572 7665 7220   the end server 
│ │ │ │ -000463c0: 756c 7469 6d61 7465 6c79 2064 6563 6964  ultimately decid
│ │ │ │ -000463d0: 6573 2077 6865 7468 6572 2061 7574 6865  es whether authe
│ │ │ │ -000463e0: 6e74 6963 6174 696f 6e20 6973 0a20 2020  ntication is.   
│ │ │ │ -000463f0: 2020 7661 6c69 642c 2074 6865 204b 4443    valid, the KDC
│ │ │ │ -00046400: 2066 6f72 2074 6865 2065 6e64 2073 6572   for the end ser
│ │ │ │ -00046410: 7665 7227 7320 7265 616c 6d20 4d41 5920  ver's realm MAY 
│ │ │ │ -00046420: 6170 706c 7920 6120 7265 616c 6d0a 2020  apply a realm.  
│ │ │ │ -00046430: 2020 2073 7065 6369 6669 6320 706f 6c69     specific poli
│ │ │ │ -00046440: 6379 2066 6f72 2076 616c 6964 6174 696e  cy for validatin
│ │ │ │ -00046450: 6720 7468 6520 7472 616e 7369 7465 6420  g the transited 
│ │ │ │ -00046460: 6669 656c 6420 616e 6420 6163 6365 7074  field and accept
│ │ │ │ -00046470: 696e 670a 2020 2020 2063 7265 6465 6e74  ing.     credent
│ │ │ │ -00046480: 6961 6c73 2066 6f72 2063 726f 7373 2d72  ials for cross-r
│ │ │ │ -00046490: 6561 6c6d 2061 7574 6865 6e74 6963 6174  ealm authenticat
│ │ │ │ -000464a0: 696f 6e2e 2020 5768 656e 2074 6865 204b  ion.  When the K
│ │ │ │ -000464b0: 4443 2061 7070 6c69 6573 0a20 2020 2020  DC applies.     
│ │ │ │ -000464c0: 7375 6368 2063 6865 636b 7320 616e 6420  such checks and 
│ │ │ │ -000464d0: 6163 6365 7074 7320 7375 6368 2063 726f  accepts such cro
│ │ │ │ -000464e0: 7373 2d72 6561 6c6d 2061 7574 6865 6e74  ss-realm authent
│ │ │ │ -000464f0: 6963 6174 696f 6e20 6974 2077 696c 6c20  ication it will 
│ │ │ │ -00046500: 7365 740a 2020 2020 2074 6865 2054 5241  set.     the TRA
│ │ │ │ -00046510: 4e53 4954 4544 2d50 4f4c 4943 592d 4348  NSITED-POLICY-CH
│ │ │ │ -00046520: 4543 4b45 4420 666c 6167 2069 6e20 7468  ECKED flag in th
│ │ │ │ -00046530: 6520 7365 7276 6963 6520 7469 636b 6574  e service ticket
│ │ │ │ -00046540: 7320 6974 2069 7373 7565 730a 2020 2020  s it issues.    
│ │ │ │ -00046550: 2062 6173 6564 206f 6e20 7468 6520 6372   based on the cr
│ │ │ │ -00046560: 6f73 732d 7265 616c 6d20 5447 542e 2041  oss-realm TGT. A
│ │ │ │ -00046570: 2063 6c69 656e 7420 4d41 5920 7265 7175   client MAY requ
│ │ │ │ -00046580: 6573 7420 7468 6174 2074 6865 204b 4443  est that the KDC
│ │ │ │ -00046590: 730a 2020 2020 206e 6f74 2063 6865 636b  s.     not check
│ │ │ │ -000465a0: 2074 6865 2074 7261 6e73 6974 6564 2066   the transited f
│ │ │ │ -000465b0: 6965 6c64 2062 7920 7365 7474 696e 6720  ield by setting 
│ │ │ │ -000465c0: 7468 650a 2020 2020 2044 4953 4142 4c45  the.     DISABLE
│ │ │ │ -000465d0: 2d54 5241 4e53 4954 4544 2d43 4845 434b  -TRANSITED-CHECK
│ │ │ │ -000465e0: 2066 6c61 672e 2020 4b44 4373 2061 7265   flag.  KDCs are
│ │ │ │ -000465f0: 2065 6e63 6f75 7261 6765 6420 6275 7420   encouraged but 
│ │ │ │ -00046600: 6e6f 7420 7265 7175 6972 6564 0a20 2020  not required.   
│ │ │ │ -00046610: 2020 746f 2068 6f6e 6f72 2074 6869 7320    to honor this 
│ │ │ │ -00046620: 666c 6167 2e0a 0a20 2020 2020 4170 706c  flag...     Appl
│ │ │ │ -00046630: 6963 6174 696f 6e20 7365 7276 6572 7320  ication servers 
│ │ │ │ -00046640: 4d55 5354 2065 6974 6865 7220 646f 2074  MUST either do t
│ │ │ │ -00046650: 6865 2074 7261 6e73 6974 6564 2d72 6561  he transited-rea
│ │ │ │ -00046660: 6c6d 2063 6865 636b 730a 2020 2020 2074  lm checks.     t
│ │ │ │ -00046670: 6865 6d73 656c 7665 732c 206f 7220 7265  hemselves, or re
│ │ │ │ -00046680: 6a65 6374 2063 726f 7373 2d72 6561 6c6d  ject cross-realm
│ │ │ │ -00046690: 2074 6963 6b65 7473 2077 6974 686f 7574   tickets without
│ │ │ │ -000466a0: 2054 5241 4e53 4954 4544 2d50 4f4c 4943   TRANSITED-POLIC
│ │ │ │ -000466b0: 592d 0a20 2020 2020 4348 4543 4b45 4420  Y-.     CHECKED 
│ │ │ │ -000466c0: 7365 742e 0a0a 2020 2020 202a 5265 7475  set...     *Retu
│ │ │ │ -000466d0: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ -000466e0: 6e73 206e 6f6e 2d30 2069 6666 2074 7261  ns non-0 iff tra
│ │ │ │ -000466f0: 6e73 6974 6564 2d70 6f6c 6963 792d 6368  nsited-policy-ch
│ │ │ │ -00046700: 6563 6b65 6420 666c 6167 2069 730a 2020  ecked flag is.  
│ │ │ │ -00046710: 2020 2073 6574 2069 6e20 7469 636b 6574     set in ticket
│ │ │ │ -00046720: 2e0a 0a73 6869 7368 695f 746b 745f 6f6b  ...shishi_tkt_ok
│ │ │ │ -00046730: 5f61 735f 6465 6c65 6761 7465 5f70 0a2d  _as_delegate_p.-
│ │ │ │ -00046740: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00046750: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ -00046760: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ -00046770: 6973 6869 5f74 6b74 5f6f 6b5f 6173 5f64  ishi_tkt_ok_as_d
│ │ │ │ -00046780: 656c 6567 6174 655f 7020 2853 6869 7368  elegate_p (Shish
│ │ │ │ -00046790: 695f 746b 7420 2a20 544b 5429 0a20 2020  i_tkt * TKT).   
│ │ │ │ -000467a0: 2020 544b 543a 2069 6e70 7574 2076 6172    TKT: input var
│ │ │ │ -000467b0: 6961 626c 6520 7769 7468 2074 6963 6b65  iable with ticke
│ │ │ │ -000467c0: 7420 696e 666f 2e0a 0a20 2020 2020 2a44  t info...     *D
│ │ │ │ -000467d0: 6573 6372 6970 7469 6f6e 3a2a 2044 6574  escription:* Det
│ │ │ │ -000467e0: 6572 6d69 6e65 2069 6620 7469 636b 6574  ermine if ticket
│ │ │ │ -000467f0: 2069 7320 6f6b 2061 7320 6465 6c65 6761   is ok as delega
│ │ │ │ -00046800: 7465 6420 7469 636b 6574 2e0a 0a20 2020  ted ticket...   
│ │ │ │ -00046810: 2020 5468 6520 636f 7079 206f 6620 7468    The copy of th
│ │ │ │ -00046820: 6520 7469 636b 6574 2066 6c61 6773 2069  e ticket flags i
│ │ │ │ -00046830: 6e20 7468 6520 656e 6372 7970 7465 6420  n the encrypted 
│ │ │ │ -00046840: 7061 7274 206f 6620 7468 6520 4b44 4320  part of the KDC 
│ │ │ │ -00046850: 7265 706c 790a 2020 2020 206d 6179 2068  reply.     may h
│ │ │ │ -00046860: 6176 6520 7468 6520 4f4b 2d41 532d 4445  ave the OK-AS-DE
│ │ │ │ -00046870: 4c45 4741 5445 2066 6c61 6720 7365 7420  LEGATE flag set 
│ │ │ │ -00046880: 746f 2069 6e64 6963 6174 6573 2074 6f20  to indicates to 
│ │ │ │ -00046890: 7468 6520 636c 6965 6e74 0a20 2020 2020  the client.     
│ │ │ │ -000468a0: 7468 6174 2074 6865 2073 6572 7665 7220  that the server 
│ │ │ │ -000468b0: 7370 6563 6966 6965 6420 696e 2074 6865  specified in the
│ │ │ │ -000468c0: 2074 6963 6b65 7420 6861 7320 6265 656e   ticket has been
│ │ │ │ -000468d0: 2064 6574 6572 6d69 6e65 6420 6279 0a20   determined by. 
│ │ │ │ -000468e0: 2020 2020 706f 6c69 6379 206f 6620 7468      policy of th
│ │ │ │ -000468f0: 6520 7265 616c 6d20 746f 2062 6520 6120  e realm to be a 
│ │ │ │ -00046900: 7375 6974 6162 6c65 2072 6563 6970 6965  suitable recipie
│ │ │ │ -00046910: 6e74 206f 6620 6465 6c65 6761 7469 6f6e  nt of delegation
│ │ │ │ -00046920: 2e20 2041 0a20 2020 2020 636c 6965 6e74  .  A.     client
│ │ │ │ -00046930: 2063 616e 2075 7365 2074 6865 2070 7265   can use the pre
│ │ │ │ -00046940: 7365 6e63 6520 6f66 2074 6869 7320 666c  sence of this fl
│ │ │ │ -00046950: 6167 2074 6f20 6865 6c70 2069 7420 6d61  ag to help it ma
│ │ │ │ -00046960: 6b65 2061 2064 6563 6973 696f 6e0a 2020  ke a decision.  
│ │ │ │ -00046970: 2020 2077 6865 7468 6572 2074 6f20 6465     whether to de
│ │ │ │ -00046980: 6c65 6761 7465 2063 7265 6465 6e74 6961  legate credentia
│ │ │ │ -00046990: 6c73 2028 6569 7468 6572 2067 7261 6e74  ls (either grant
│ │ │ │ -000469a0: 2061 2070 726f 7879 206f 7220 610a 2020   a proxy or a.  
│ │ │ │ -000469b0: 2020 2066 6f72 7761 7264 6564 2074 6963     forwarded tic
│ │ │ │ -000469c0: 6b65 742d 2067 7261 6e74 696e 6720 7469  ket- granting ti
│ │ │ │ -000469d0: 636b 6574 2920 746f 2074 6869 7320 7365  cket) to this se
│ │ │ │ -000469e0: 7276 6572 2e20 2049 7420 6973 0a20 2020  rver.  It is.   
│ │ │ │ -000469f0: 2020 6163 6365 7074 6162 6c65 2074 6f20    acceptable to 
│ │ │ │ -00046a00: 6967 6e6f 7265 2074 6865 2076 616c 7565  ignore the value
│ │ │ │ -00046a10: 206f 6620 7468 6973 2066 6c61 672e 2020   of this flag.  
│ │ │ │ -00046a20: 5768 656e 2073 6574 7469 6e67 2074 6869  When setting thi
│ │ │ │ -00046a30: 730a 2020 2020 2066 6c61 672c 2061 6e20  s.     flag, an 
│ │ │ │ -00046a40: 6164 6d69 6e69 7374 7261 746f 7220 7368  administrator sh
│ │ │ │ -00046a50: 6f75 6c64 2063 6f6e 7369 6465 7220 7468  ould consider th
│ │ │ │ -00046a60: 6520 7365 6375 7269 7479 2061 6e64 2070  e security and p
│ │ │ │ -00046a70: 6c61 6365 6d65 6e74 0a20 2020 2020 6f66  lacement.     of
│ │ │ │ -00046a80: 2074 6865 2073 6572 7665 7220 6f6e 2077   the server on w
│ │ │ │ -00046a90: 6869 6368 2074 6865 2073 6572 7669 6365  hich the service
│ │ │ │ -00046aa0: 2077 696c 6c20 7275 6e2c 2061 7320 7765   will run, as we
│ │ │ │ -00046ab0: 6c6c 2061 7320 7768 6574 6865 7220 7468  ll as whether th
│ │ │ │ -00046ac0: 650a 2020 2020 2073 6572 7669 6365 2072  e.     service r
│ │ │ │ -00046ad0: 6571 7569 7265 7320 7468 6520 7573 6520  equires the use 
│ │ │ │ -00046ae0: 6f66 2064 656c 6567 6174 6564 2063 7265  of delegated cre
│ │ │ │ -00046af0: 6465 6e74 6961 6c73 2e0a 0a20 2020 2020  dentials...     
│ │ │ │ -00046b00: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ -00046b10: 5265 7475 726e 7320 6e6f 6e2d 3020 6966  Returns non-0 if
│ │ │ │ -00046b20: 6620 6f6b 2d61 732d 6465 6c65 6761 7465  f ok-as-delegate
│ │ │ │ -00046b30: 2066 6c61 6720 6973 2073 6574 2069 6e0a   flag is set in.
│ │ │ │ -00046b40: 2020 2020 2074 6963 6b65 742e 0a0a 7368       ticket...sh
│ │ │ │ -00046b50: 6973 6869 5f74 6b74 5f6b 6579 7479 7065  ishi_tkt_keytype
│ │ │ │ -00046b60: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ -00046b70: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ -00046b80: 6e3a 2069 6e74 2073 6869 7368 695f 746b  n: int shishi_tk
│ │ │ │ -00046b90: 745f 6b65 7974 7970 6520 2853 6869 7368  t_keytype (Shish
│ │ │ │ -00046ba0: 695f 746b 7420 2a20 544b 542c 2069 6e74  i_tkt * TKT, int
│ │ │ │ -00046bb0: 3332 5f74 202a 2045 5459 5045 290a 2020  32_t * ETYPE).  
│ │ │ │ -00046bc0: 2020 2054 4b54 3a20 696e 7075 7420 7661     TKT: input va
│ │ │ │ -00046bd0: 7269 6162 6c65 2077 6974 6820 7469 636b  riable with tick
│ │ │ │ -00046be0: 6574 2069 6e66 6f2e 0a20 2020 2020 4554  et info..     ET
│ │ │ │ -00046bf0: 5950 453a 2070 6f69 6e74 6572 2074 6f20  YPE: pointer to 
│ │ │ │ -00046c00: 656e 6372 7970 7469 6f6e 2074 7970 6520  encryption type 
│ │ │ │ -00046c10: 7468 6174 2069 7320 7365 742c 2073 6565  that is set, see
│ │ │ │ -00046c20: 2053 6869 7368 695f 6574 7970 652e 0a0a   Shishi_etype...
│ │ │ │ -00046c30: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ -00046c40: 6e3a 2a20 4578 7472 6163 7420 656e 6372  n:* Extract encr
│ │ │ │ -00046c50: 7970 7469 6f6e 2074 7970 6520 6f66 206b  yption type of k
│ │ │ │ -00046c60: 6579 2069 6e20 7469 636b 6574 2028 7265  ey in ticket (re
│ │ │ │ -00046c70: 616c 6c79 0a20 2020 2020 456e 634b 4443  ally.     EncKDC
│ │ │ │ -00046c80: 5265 7050 6172 7429 2e0a 0a20 2020 2020  RepPart)...     
│ │ │ │ -00046c90: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ -00046ca0: 5265 7475 726e 7320 5348 4953 4849 5f4f  Returns SHISHI_O
│ │ │ │ -00046cb0: 4b20 6966 6620 7375 6363 6573 7366 756c  K iff successful
│ │ │ │ -00046cc0: 2e0a 0a73 6869 7368 695f 746b 745f 6b65  ...shishi_tkt_ke
│ │ │ │ -00046cd0: 7974 7970 655f 6661 7374 0a2d 2d2d 2d2d  ytype_fast.-----
│ │ │ │ +00046000: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +00046010: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ +00046020: 746b 745f 7472 616e 7369 7465 645f 706f  tkt_transited_po
│ │ │ │ +00046030: 6c69 6379 5f63 6865 636b 6564 5f70 0a20  licy_checked_p. 
│ │ │ │ +00046040: 2020 2020 2020 2020 2028 5368 6973 6869           (Shishi
│ │ │ │ +00046050: 5f74 6b74 202a 2054 4b54 290a 2020 2020  _tkt * TKT).    
│ │ │ │ +00046060: 2054 4b54 3a20 696e 7075 7420 7661 7269   TKT: input vari
│ │ │ │ +00046070: 6162 6c65 2077 6974 6820 7469 636b 6574  able with ticket
│ │ │ │ +00046080: 2069 6e66 6f2e 0a0a 2020 2020 202a 4465   info...     *De
│ │ │ │ +00046090: 7363 7269 7074 696f 6e3a 2a20 4465 7465  scription:* Dete
│ │ │ │ +000460a0: 726d 696e 6520 6966 2074 6963 6b65 7420  rmine if ticket 
│ │ │ │ +000460b0: 6861 7320 6265 656e 2070 6f6c 6963 7920  has been policy 
│ │ │ │ +000460c0: 6368 6563 6b65 6420 666f 720a 2020 2020  checked for.    
│ │ │ │ +000460d0: 2074 7261 6e73 6974 2e0a 0a20 2020 2020   transit...     
│ │ │ │ +000460e0: 5468 6520 6170 706c 6963 6174 696f 6e20  The application 
│ │ │ │ +000460f0: 7365 7276 6572 2069 7320 756c 7469 6d61  server is ultima
│ │ │ │ +00046100: 7465 6c79 2072 6573 706f 6e73 6962 6c65  tely responsible
│ │ │ │ +00046110: 2066 6f72 2061 6363 6570 7469 6e67 206f   for accepting o
│ │ │ │ +00046120: 720a 2020 2020 2072 656a 6563 7469 6e67  r.     rejecting
│ │ │ │ +00046130: 2061 7574 6865 6e74 6963 6174 696f 6e20   authentication 
│ │ │ │ +00046140: 616e 6420 5348 4f55 4c44 2063 6865 636b  and SHOULD check
│ │ │ │ +00046150: 2074 6861 7420 6f6e 6c79 2073 7569 7461   that only suita
│ │ │ │ +00046160: 626c 790a 2020 2020 2074 7275 7374 6564  bly.     trusted
│ │ │ │ +00046170: 204b 4443 7320 6172 6520 7265 6c69 6564   KDCs are relied
│ │ │ │ +00046180: 2075 706f 6e20 746f 2061 7574 6865 6e74   upon to authent
│ │ │ │ +00046190: 6963 6174 6520 6120 7072 696e 6369 7061  icate a principa
│ │ │ │ +000461a0: 6c2e 2020 5468 650a 2020 2020 2074 7261  l.  The.     tra
│ │ │ │ +000461b0: 6e73 6974 6564 2066 6965 6c64 2069 6e20  nsited field in 
│ │ │ │ +000461c0: 7468 6520 7469 636b 6574 2069 6465 6e74  the ticket ident
│ │ │ │ +000461d0: 6966 6965 7320 7768 6963 6820 7265 616c  ifies which real
│ │ │ │ +000461e0: 6d73 2028 616e 6420 7468 7573 0a20 2020  ms (and thus.   
│ │ │ │ +000461f0: 2020 7768 6963 6820 4b44 4373 2920 7765    which KDCs) we
│ │ │ │ +00046200: 7265 2069 6e76 6f6c 7665 6420 696e 2074  re involved in t
│ │ │ │ +00046210: 6865 2061 7574 6865 6e74 6963 6174 696f  he authenticatio
│ │ │ │ +00046220: 6e20 7072 6f63 6573 7320 616e 6420 616e  n process and an
│ │ │ │ +00046230: 0a20 2020 2020 6170 706c 6963 6174 696f  .     applicatio
│ │ │ │ +00046240: 6e20 7365 7276 6572 2077 6f75 6c64 206e  n server would n
│ │ │ │ +00046250: 6f72 6d61 6c6c 7920 6368 6563 6b20 7468  ormally check th
│ │ │ │ +00046260: 6973 2066 6965 6c64 2e20 2049 6620 616e  is field.  If an
│ │ │ │ +00046270: 7920 6f66 0a20 2020 2020 7468 6573 6520  y of.     these 
│ │ │ │ +00046280: 6172 6520 756e 7472 7573 7465 6420 746f  are untrusted to
│ │ │ │ +00046290: 2061 7574 6865 6e74 6963 6174 6520 7468   authenticate th
│ │ │ │ +000462a0: 6520 696e 6469 6361 7465 6420 636c 6965  e indicated clie
│ │ │ │ +000462b0: 6e74 2070 7269 6e63 6970 616c 0a20 2020  nt principal.   
│ │ │ │ +000462c0: 2020 2870 726f 6261 626c 7920 6465 7465    (probably dete
│ │ │ │ +000462d0: 726d 696e 6564 2062 7920 6120 7265 616c  rmined by a real
│ │ │ │ +000462e0: 6d2d 6261 7365 6420 706f 6c69 6379 292c  m-based policy),
│ │ │ │ +000462f0: 2074 6865 2061 7574 6865 6e74 6963 6174   the authenticat
│ │ │ │ +00046300: 696f 6e0a 2020 2020 2061 7474 656d 7074  ion.     attempt
│ │ │ │ +00046310: 204d 5553 5420 6265 2072 656a 6563 7465   MUST be rejecte
│ │ │ │ +00046320: 642e 2020 5468 6520 7072 6573 656e 6365  d.  The presence
│ │ │ │ +00046330: 206f 6620 7472 7573 7465 6420 4b44 4373   of trusted KDCs
│ │ │ │ +00046340: 2069 6e20 7468 6973 0a20 2020 2020 6c69   in this.     li
│ │ │ │ +00046350: 7374 2064 6f65 7320 6e6f 7420 7072 6f76  st does not prov
│ │ │ │ +00046360: 6964 6520 616e 7920 6775 6172 616e 7465  ide any guarante
│ │ │ │ +00046370: 653b 2061 6e20 756e 7472 7573 7465 6420  e; an untrusted 
│ │ │ │ +00046380: 4b44 4320 6d61 7920 6861 7665 0a20 2020  KDC may have.   
│ │ │ │ +00046390: 2020 6661 6272 6963 6174 6564 2074 6865    fabricated the
│ │ │ │ +000463a0: 206c 6973 742e 0a0a 2020 2020 2057 6869   list...     Whi
│ │ │ │ +000463b0: 6c65 2074 6865 2065 6e64 2073 6572 7665  le the end serve
│ │ │ │ +000463c0: 7220 756c 7469 6d61 7465 6c79 2064 6563  r ultimately dec
│ │ │ │ +000463d0: 6964 6573 2077 6865 7468 6572 2061 7574  ides whether aut
│ │ │ │ +000463e0: 6865 6e74 6963 6174 696f 6e20 6973 0a20  hentication is. 
│ │ │ │ +000463f0: 2020 2020 7661 6c69 642c 2074 6865 204b      valid, the K
│ │ │ │ +00046400: 4443 2066 6f72 2074 6865 2065 6e64 2073  DC for the end s
│ │ │ │ +00046410: 6572 7665 7227 7320 7265 616c 6d20 4d41  erver's realm MA
│ │ │ │ +00046420: 5920 6170 706c 7920 6120 7265 616c 6d0a  Y apply a realm.
│ │ │ │ +00046430: 2020 2020 2073 7065 6369 6669 6320 706f       specific po
│ │ │ │ +00046440: 6c69 6379 2066 6f72 2076 616c 6964 6174  licy for validat
│ │ │ │ +00046450: 696e 6720 7468 6520 7472 616e 7369 7465  ing the transite
│ │ │ │ +00046460: 6420 6669 656c 6420 616e 6420 6163 6365  d field and acce
│ │ │ │ +00046470: 7074 696e 670a 2020 2020 2063 7265 6465  pting.     crede
│ │ │ │ +00046480: 6e74 6961 6c73 2066 6f72 2063 726f 7373  ntials for cross
│ │ │ │ +00046490: 2d72 6561 6c6d 2061 7574 6865 6e74 6963  -realm authentic
│ │ │ │ +000464a0: 6174 696f 6e2e 2020 5768 656e 2074 6865  ation.  When the
│ │ │ │ +000464b0: 204b 4443 2061 7070 6c69 6573 0a20 2020   KDC applies.   
│ │ │ │ +000464c0: 2020 7375 6368 2063 6865 636b 7320 616e    such checks an
│ │ │ │ +000464d0: 6420 6163 6365 7074 7320 7375 6368 2063  d accepts such c
│ │ │ │ +000464e0: 726f 7373 2d72 6561 6c6d 2061 7574 6865  ross-realm authe
│ │ │ │ +000464f0: 6e74 6963 6174 696f 6e20 6974 2077 696c  ntication it wil
│ │ │ │ +00046500: 6c20 7365 740a 2020 2020 2074 6865 2054  l set.     the T
│ │ │ │ +00046510: 5241 4e53 4954 4544 2d50 4f4c 4943 592d  RANSITED-POLICY-
│ │ │ │ +00046520: 4348 4543 4b45 4420 666c 6167 2069 6e20  CHECKED flag in 
│ │ │ │ +00046530: 7468 6520 7365 7276 6963 6520 7469 636b  the service tick
│ │ │ │ +00046540: 6574 7320 6974 2069 7373 7565 730a 2020  ets it issues.  
│ │ │ │ +00046550: 2020 2062 6173 6564 206f 6e20 7468 6520     based on the 
│ │ │ │ +00046560: 6372 6f73 732d 7265 616c 6d20 5447 542e  cross-realm TGT.
│ │ │ │ +00046570: 2041 2063 6c69 656e 7420 4d41 5920 7265   A client MAY re
│ │ │ │ +00046580: 7175 6573 7420 7468 6174 2074 6865 204b  quest that the K
│ │ │ │ +00046590: 4443 730a 2020 2020 206e 6f74 2063 6865  DCs.     not che
│ │ │ │ +000465a0: 636b 2074 6865 2074 7261 6e73 6974 6564  ck the transited
│ │ │ │ +000465b0: 2066 6965 6c64 2062 7920 7365 7474 696e   field by settin
│ │ │ │ +000465c0: 6720 7468 650a 2020 2020 2044 4953 4142  g the.     DISAB
│ │ │ │ +000465d0: 4c45 2d54 5241 4e53 4954 4544 2d43 4845  LE-TRANSITED-CHE
│ │ │ │ +000465e0: 434b 2066 6c61 672e 2020 4b44 4373 2061  CK flag.  KDCs a
│ │ │ │ +000465f0: 7265 2065 6e63 6f75 7261 6765 6420 6275  re encouraged bu
│ │ │ │ +00046600: 7420 6e6f 7420 7265 7175 6972 6564 0a20  t not required. 
│ │ │ │ +00046610: 2020 2020 746f 2068 6f6e 6f72 2074 6869      to honor thi
│ │ │ │ +00046620: 7320 666c 6167 2e0a 0a20 2020 2020 4170  s flag...     Ap
│ │ │ │ +00046630: 706c 6963 6174 696f 6e20 7365 7276 6572  plication server
│ │ │ │ +00046640: 7320 4d55 5354 2065 6974 6865 7220 646f  s MUST either do
│ │ │ │ +00046650: 2074 6865 2074 7261 6e73 6974 6564 2d72   the transited-r
│ │ │ │ +00046660: 6561 6c6d 2063 6865 636b 730a 2020 2020  ealm checks.    
│ │ │ │ +00046670: 2074 6865 6d73 656c 7665 732c 206f 7220   themselves, or 
│ │ │ │ +00046680: 7265 6a65 6374 2063 726f 7373 2d72 6561  reject cross-rea
│ │ │ │ +00046690: 6c6d 2074 6963 6b65 7473 2077 6974 686f  lm tickets witho
│ │ │ │ +000466a0: 7574 2054 5241 4e53 4954 4544 2d50 4f4c  ut TRANSITED-POL
│ │ │ │ +000466b0: 4943 592d 0a20 2020 2020 4348 4543 4b45  ICY-.     CHECKE
│ │ │ │ +000466c0: 4420 7365 742e 0a0a 2020 2020 202a 5265  D set...     *Re
│ │ │ │ +000466d0: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ +000466e0: 7572 6e73 206e 6f6e 2d30 2069 6666 2074  urns non-0 iff t
│ │ │ │ +000466f0: 7261 6e73 6974 6564 2d70 6f6c 6963 792d  ransited-policy-
│ │ │ │ +00046700: 6368 6563 6b65 6420 666c 6167 2069 730a  checked flag is.
│ │ │ │ +00046710: 2020 2020 2073 6574 2069 6e20 7469 636b       set in tick
│ │ │ │ +00046720: 6574 2e0a 0a73 6869 7368 695f 746b 745f  et...shishi_tkt_
│ │ │ │ +00046730: 6f6b 5f61 735f 6465 6c65 6761 7465 5f70  ok_as_delegate_p
│ │ │ │ +00046740: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ +00046750: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ +00046760: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ +00046770: 7368 6973 6869 5f74 6b74 5f6f 6b5f 6173  shishi_tkt_ok_as
│ │ │ │ +00046780: 5f64 656c 6567 6174 655f 7020 2853 6869  _delegate_p (Shi
│ │ │ │ +00046790: 7368 695f 746b 7420 2a20 544b 5429 0a20  shi_tkt * TKT). 
│ │ │ │ +000467a0: 2020 2020 544b 543a 2069 6e70 7574 2076      TKT: input v
│ │ │ │ +000467b0: 6172 6961 626c 6520 7769 7468 2074 6963  ariable with tic
│ │ │ │ +000467c0: 6b65 7420 696e 666f 2e0a 0a20 2020 2020  ket info...     
│ │ │ │ +000467d0: 2a44 6573 6372 6970 7469 6f6e 3a2a 2044  *Description:* D
│ │ │ │ +000467e0: 6574 6572 6d69 6e65 2069 6620 7469 636b  etermine if tick
│ │ │ │ +000467f0: 6574 2069 7320 6f6b 2061 7320 6465 6c65  et is ok as dele
│ │ │ │ +00046800: 6761 7465 6420 7469 636b 6574 2e0a 0a20  gated ticket... 
│ │ │ │ +00046810: 2020 2020 5468 6520 636f 7079 206f 6620      The copy of 
│ │ │ │ +00046820: 7468 6520 7469 636b 6574 2066 6c61 6773  the ticket flags
│ │ │ │ +00046830: 2069 6e20 7468 6520 656e 6372 7970 7465   in the encrypte
│ │ │ │ +00046840: 6420 7061 7274 206f 6620 7468 6520 4b44  d part of the KD
│ │ │ │ +00046850: 4320 7265 706c 790a 2020 2020 206d 6179  C reply.     may
│ │ │ │ +00046860: 2068 6176 6520 7468 6520 4f4b 2d41 532d   have the OK-AS-
│ │ │ │ +00046870: 4445 4c45 4741 5445 2066 6c61 6720 7365  DELEGATE flag se
│ │ │ │ +00046880: 7420 746f 2069 6e64 6963 6174 6573 2074  t to indicates t
│ │ │ │ +00046890: 6f20 7468 6520 636c 6965 6e74 0a20 2020  o the client.   
│ │ │ │ +000468a0: 2020 7468 6174 2074 6865 2073 6572 7665    that the serve
│ │ │ │ +000468b0: 7220 7370 6563 6966 6965 6420 696e 2074  r specified in t
│ │ │ │ +000468c0: 6865 2074 6963 6b65 7420 6861 7320 6265  he ticket has be
│ │ │ │ +000468d0: 656e 2064 6574 6572 6d69 6e65 6420 6279  en determined by
│ │ │ │ +000468e0: 0a20 2020 2020 706f 6c69 6379 206f 6620  .     policy of 
│ │ │ │ +000468f0: 7468 6520 7265 616c 6d20 746f 2062 6520  the realm to be 
│ │ │ │ +00046900: 6120 7375 6974 6162 6c65 2072 6563 6970  a suitable recip
│ │ │ │ +00046910: 6965 6e74 206f 6620 6465 6c65 6761 7469  ient of delegati
│ │ │ │ +00046920: 6f6e 2e20 2041 0a20 2020 2020 636c 6965  on.  A.     clie
│ │ │ │ +00046930: 6e74 2063 616e 2075 7365 2074 6865 2070  nt can use the p
│ │ │ │ +00046940: 7265 7365 6e63 6520 6f66 2074 6869 7320  resence of this 
│ │ │ │ +00046950: 666c 6167 2074 6f20 6865 6c70 2069 7420  flag to help it 
│ │ │ │ +00046960: 6d61 6b65 2061 2064 6563 6973 696f 6e0a  make a decision.
│ │ │ │ +00046970: 2020 2020 2077 6865 7468 6572 2074 6f20       whether to 
│ │ │ │ +00046980: 6465 6c65 6761 7465 2063 7265 6465 6e74  delegate credent
│ │ │ │ +00046990: 6961 6c73 2028 6569 7468 6572 2067 7261  ials (either gra
│ │ │ │ +000469a0: 6e74 2061 2070 726f 7879 206f 7220 610a  nt a proxy or a.
│ │ │ │ +000469b0: 2020 2020 2066 6f72 7761 7264 6564 2074       forwarded t
│ │ │ │ +000469c0: 6963 6b65 742d 2067 7261 6e74 696e 6720  icket- granting 
│ │ │ │ +000469d0: 7469 636b 6574 2920 746f 2074 6869 7320  ticket) to this 
│ │ │ │ +000469e0: 7365 7276 6572 2e20 2049 7420 6973 0a20  server.  It is. 
│ │ │ │ +000469f0: 2020 2020 6163 6365 7074 6162 6c65 2074      acceptable t
│ │ │ │ +00046a00: 6f20 6967 6e6f 7265 2074 6865 2076 616c  o ignore the val
│ │ │ │ +00046a10: 7565 206f 6620 7468 6973 2066 6c61 672e  ue of this flag.
│ │ │ │ +00046a20: 2020 5768 656e 2073 6574 7469 6e67 2074    When setting t
│ │ │ │ +00046a30: 6869 730a 2020 2020 2066 6c61 672c 2061  his.     flag, a
│ │ │ │ +00046a40: 6e20 6164 6d69 6e69 7374 7261 746f 7220  n administrator 
│ │ │ │ +00046a50: 7368 6f75 6c64 2063 6f6e 7369 6465 7220  should consider 
│ │ │ │ +00046a60: 7468 6520 7365 6375 7269 7479 2061 6e64  the security and
│ │ │ │ +00046a70: 2070 6c61 6365 6d65 6e74 0a20 2020 2020   placement.     
│ │ │ │ +00046a80: 6f66 2074 6865 2073 6572 7665 7220 6f6e  of the server on
│ │ │ │ +00046a90: 2077 6869 6368 2074 6865 2073 6572 7669   which the servi
│ │ │ │ +00046aa0: 6365 2077 696c 6c20 7275 6e2c 2061 7320  ce will run, as 
│ │ │ │ +00046ab0: 7765 6c6c 2061 7320 7768 6574 6865 7220  well as whether 
│ │ │ │ +00046ac0: 7468 650a 2020 2020 2073 6572 7669 6365  the.     service
│ │ │ │ +00046ad0: 2072 6571 7569 7265 7320 7468 6520 7573   requires the us
│ │ │ │ +00046ae0: 6520 6f66 2064 656c 6567 6174 6564 2063  e of delegated c
│ │ │ │ +00046af0: 7265 6465 6e74 6961 6c73 2e0a 0a20 2020  redentials...   
│ │ │ │ +00046b00: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ +00046b10: 2a20 5265 7475 726e 7320 6e6f 6e2d 3020  * Returns non-0 
│ │ │ │ +00046b20: 6966 6620 6f6b 2d61 732d 6465 6c65 6761  iff ok-as-delega
│ │ │ │ +00046b30: 7465 2066 6c61 6720 6973 2073 6574 2069  te flag is set i
│ │ │ │ +00046b40: 6e0a 2020 2020 2074 6963 6b65 742e 0a0a  n.     ticket...
│ │ │ │ +00046b50: 7368 6973 6869 5f74 6b74 5f6b 6579 7479  shishi_tkt_keyty
│ │ │ │ +00046b60: 7065 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  pe.-------------
│ │ │ │ +00046b70: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +00046b80: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ +00046b90: 746b 745f 6b65 7974 7970 6520 2853 6869  tkt_keytype (Shi
│ │ │ │ +00046ba0: 7368 695f 746b 7420 2a20 544b 542c 2069  shi_tkt * TKT, i
│ │ │ │ +00046bb0: 6e74 3332 5f74 202a 2045 5459 5045 290a  nt32_t * ETYPE).
│ │ │ │ +00046bc0: 2020 2020 2054 4b54 3a20 696e 7075 7420       TKT: input 
│ │ │ │ +00046bd0: 7661 7269 6162 6c65 2077 6974 6820 7469  variable with ti
│ │ │ │ +00046be0: 636b 6574 2069 6e66 6f2e 0a20 2020 2020  cket info..     
│ │ │ │ +00046bf0: 4554 5950 453a 2070 6f69 6e74 6572 2074  ETYPE: pointer t
│ │ │ │ +00046c00: 6f20 656e 6372 7970 7469 6f6e 2074 7970  o encryption typ
│ │ │ │ +00046c10: 6520 7468 6174 2069 7320 7365 742c 2073  e that is set, s
│ │ │ │ +00046c20: 6565 2053 6869 7368 695f 6574 7970 652e  ee Shishi_etype.
│ │ │ │ +00046c30: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ +00046c40: 696f 6e3a 2a20 4578 7472 6163 7420 656e  ion:* Extract en
│ │ │ │ +00046c50: 6372 7970 7469 6f6e 2074 7970 6520 6f66  cryption type of
│ │ │ │ +00046c60: 206b 6579 2069 6e20 7469 636b 6574 2028   key in ticket (
│ │ │ │ +00046c70: 7265 616c 6c79 0a20 2020 2020 456e 634b  really.     EncK
│ │ │ │ +00046c80: 4443 5265 7050 6172 7429 2e0a 0a20 2020  DCRepPart)...   
│ │ │ │ +00046c90: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ +00046ca0: 2a20 5265 7475 726e 7320 5348 4953 4849  * Returns SHISHI
│ │ │ │ +00046cb0: 5f4f 4b20 6966 6620 7375 6363 6573 7366  _OK iff successf
│ │ │ │ +00046cc0: 756c 2e0a 0a73 6869 7368 695f 746b 745f  ul...shishi_tkt_
│ │ │ │ +00046cd0: 6b65 7974 7970 655f 6661 7374 0a2d 2d2d  keytype_fast.---
│ │ │ │  00046ce0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00046cf0: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ -00046d00: 3a20 696e 7433 325f 7420 7368 6973 6869  : int32_t shishi
│ │ │ │ -00046d10: 5f74 6b74 5f6b 6579 7479 7065 5f66 6173  _tkt_keytype_fas
│ │ │ │ -00046d20: 7420 2853 6869 7368 695f 746b 7420 2a20  t (Shishi_tkt * 
│ │ │ │ -00046d30: 544b 5429 0a20 2020 2020 544b 543a 2069  TKT).     TKT: i
│ │ │ │ -00046d40: 6e70 7574 2076 6172 6961 626c 6520 7769  nput variable wi
│ │ │ │ -00046d50: 7468 2074 6963 6b65 7420 696e 666f 2e0a  th ticket info..
│ │ │ │ -00046d60: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -00046d70: 6f6e 3a2a 2045 7874 7261 6374 2065 6e63  on:* Extract enc
│ │ │ │ -00046d80: 7279 7074 696f 6e20 7479 7065 206f 6620  ryption type of 
│ │ │ │ -00046d90: 6b65 7920 696e 2074 6963 6b65 7420 2872  key in ticket (r
│ │ │ │ -00046da0: 6561 6c6c 790a 2020 2020 2045 6e63 4b44  eally.     EncKD
│ │ │ │ -00046db0: 4352 6570 5061 7274 292e 0a0a 2020 2020  CRepPart)...    
│ │ │ │ -00046dc0: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ -00046dd0: 2052 6574 7572 6e73 2065 6e63 7279 7074   Returns encrypt
│ │ │ │ -00046de0: 696f 6e20 7479 7065 206f 6620 7365 7373  ion type of sess
│ │ │ │ -00046df0: 696f 6e20 6b65 7920 696e 2074 6963 6b65  ion key in ticke
│ │ │ │ -00046e00: 740a 2020 2020 2028 7265 616c 6c79 2045  t.     (really E
│ │ │ │ -00046e10: 6e63 4b44 4352 6570 5061 7274 292c 206f  ncKDCRepPart), o
│ │ │ │ -00046e20: 7220 2d31 206f 6e20 6572 726f 722e 0a0a  r -1 on error...
│ │ │ │ -00046e30: 7368 6973 6869 5f74 6b74 5f6b 6579 7479  shishi_tkt_keyty
│ │ │ │ -00046e40: 7065 5f70 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  pe_p.-----------
│ │ │ │ -00046e50: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ -00046e60: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ -00046e70: 7368 695f 746b 745f 6b65 7974 7970 655f  shi_tkt_keytype_
│ │ │ │ -00046e80: 7020 2853 6869 7368 695f 746b 7420 2a20  p (Shishi_tkt * 
│ │ │ │ -00046e90: 544b 542c 2069 6e74 3332 5f74 2045 5459  TKT, int32_t ETY
│ │ │ │ -00046ea0: 5045 290a 2020 2020 2054 4b54 3a20 696e  PE).     TKT: in
│ │ │ │ -00046eb0: 7075 7420 7661 7269 6162 6c65 2077 6974  put variable wit
│ │ │ │ -00046ec0: 6820 7469 636b 6574 2069 6e66 6f2e 0a20  h ticket info.. 
│ │ │ │ -00046ed0: 2020 2020 4554 5950 453a 2065 6e63 7279      ETYPE: encry
│ │ │ │ -00046ee0: 7074 696f 6e20 7479 7065 2c20 7365 6520  ption type, see 
│ │ │ │ -00046ef0: 5368 6973 6869 5f65 7479 7065 2e0a 0a20  Shishi_etype... 
│ │ │ │ -00046f00: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -00046f10: 3a2a 2044 6574 6572 6d69 6e65 2069 6620  :* Determine if 
│ │ │ │ -00046f20: 6b65 7920 696e 2074 6963 6b65 7420 2872  key in ticket (r
│ │ │ │ -00046f30: 6561 6c6c 7920 456e 634b 4443 5265 7050  eally EncKDCRepP
│ │ │ │ -00046f40: 6172 7429 2069 730a 2020 2020 206f 6620  art) is.     of 
│ │ │ │ -00046f50: 7370 6563 6966 6965 6420 6b65 7920 7479  specified key ty
│ │ │ │ -00046f60: 7065 2028 7265 616c 6c79 2065 6e63 7279  pe (really encry
│ │ │ │ -00046f70: 7074 696f 6e20 7479 7065 292e 0a0a 2020  ption type)...  
│ │ │ │ -00046f80: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ -00046f90: 3a2a 2052 6574 7572 6e73 206e 6f6e 2d30  :* Returns non-0
│ │ │ │ -00046fa0: 2069 6666 206b 6579 2069 6e20 7469 636b   iff key in tick
│ │ │ │ -00046fb0: 6574 2069 7320 6f66 2073 7065 6369 6669  et is of specifi
│ │ │ │ -00046fc0: 6564 0a20 2020 2020 656e 6372 7970 7469  ed.     encrypti
│ │ │ │ -00046fd0: 6f6e 2074 7970 652e 0a0a 7368 6973 6869  on type...shishi
│ │ │ │ -00046fe0: 5f74 6b74 5f6c 6173 7472 6571 630a 2d2d  _tkt_lastreqc.--
│ │ │ │ +00046cf0: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ +00046d00: 6f6e 3a20 696e 7433 325f 7420 7368 6973  on: int32_t shis
│ │ │ │ +00046d10: 6869 5f74 6b74 5f6b 6579 7479 7065 5f66  hi_tkt_keytype_f
│ │ │ │ +00046d20: 6173 7420 2853 6869 7368 695f 746b 7420  ast (Shishi_tkt 
│ │ │ │ +00046d30: 2a20 544b 5429 0a20 2020 2020 544b 543a  * TKT).     TKT:
│ │ │ │ +00046d40: 2069 6e70 7574 2076 6172 6961 626c 6520   input variable 
│ │ │ │ +00046d50: 7769 7468 2074 6963 6b65 7420 696e 666f  with ticket info
│ │ │ │ +00046d60: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ +00046d70: 7469 6f6e 3a2a 2045 7874 7261 6374 2065  tion:* Extract e
│ │ │ │ +00046d80: 6e63 7279 7074 696f 6e20 7479 7065 206f  ncryption type o
│ │ │ │ +00046d90: 6620 6b65 7920 696e 2074 6963 6b65 7420  f key in ticket 
│ │ │ │ +00046da0: 2872 6561 6c6c 790a 2020 2020 2045 6e63  (really.     Enc
│ │ │ │ +00046db0: 4b44 4352 6570 5061 7274 292e 0a0a 2020  KDCRepPart)...  
│ │ │ │ +00046dc0: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ +00046dd0: 3a2a 2052 6574 7572 6e73 2065 6e63 7279  :* Returns encry
│ │ │ │ +00046de0: 7074 696f 6e20 7479 7065 206f 6620 7365  ption type of se
│ │ │ │ +00046df0: 7373 696f 6e20 6b65 7920 696e 2074 6963  ssion key in tic
│ │ │ │ +00046e00: 6b65 740a 2020 2020 2028 7265 616c 6c79  ket.     (really
│ │ │ │ +00046e10: 2045 6e63 4b44 4352 6570 5061 7274 292c   EncKDCRepPart),
│ │ │ │ +00046e20: 206f 7220 2d31 206f 6e20 6572 726f 722e   or -1 on error.
│ │ │ │ +00046e30: 0a0a 7368 6973 6869 5f74 6b74 5f6b 6579  ..shishi_tkt_key
│ │ │ │ +00046e40: 7479 7065 5f70 0a2d 2d2d 2d2d 2d2d 2d2d  type_p.---------
│ │ │ │ +00046e50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ +00046e60: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ +00046e70: 6869 7368 695f 746b 745f 6b65 7974 7970  hishi_tkt_keytyp
│ │ │ │ +00046e80: 655f 7020 2853 6869 7368 695f 746b 7420  e_p (Shishi_tkt 
│ │ │ │ +00046e90: 2a20 544b 542c 2069 6e74 3332 5f74 2045  * TKT, int32_t E
│ │ │ │ +00046ea0: 5459 5045 290a 2020 2020 2054 4b54 3a20  TYPE).     TKT: 
│ │ │ │ +00046eb0: 696e 7075 7420 7661 7269 6162 6c65 2077  input variable w
│ │ │ │ +00046ec0: 6974 6820 7469 636b 6574 2069 6e66 6f2e  ith ticket info.
│ │ │ │ +00046ed0: 0a20 2020 2020 4554 5950 453a 2065 6e63  .     ETYPE: enc
│ │ │ │ +00046ee0: 7279 7074 696f 6e20 7479 7065 2c20 7365  ryption type, se
│ │ │ │ +00046ef0: 6520 5368 6973 6869 5f65 7479 7065 2e0a  e Shishi_etype..
│ │ │ │ +00046f00: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +00046f10: 6f6e 3a2a 2044 6574 6572 6d69 6e65 2069  on:* Determine i
│ │ │ │ +00046f20: 6620 6b65 7920 696e 2074 6963 6b65 7420  f key in ticket 
│ │ │ │ +00046f30: 2872 6561 6c6c 7920 456e 634b 4443 5265  (really EncKDCRe
│ │ │ │ +00046f40: 7050 6172 7429 2069 730a 2020 2020 206f  pPart) is.     o
│ │ │ │ +00046f50: 6620 7370 6563 6966 6965 6420 6b65 7920  f specified key 
│ │ │ │ +00046f60: 7479 7065 2028 7265 616c 6c79 2065 6e63  type (really enc
│ │ │ │ +00046f70: 7279 7074 696f 6e20 7479 7065 292e 0a0a  ryption type)...
│ │ │ │ +00046f80: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ +00046f90: 7565 3a2a 2052 6574 7572 6e73 206e 6f6e  ue:* Returns non
│ │ │ │ +00046fa0: 2d30 2069 6666 206b 6579 2069 6e20 7469  -0 iff key in ti
│ │ │ │ +00046fb0: 636b 6574 2069 7320 6f66 2073 7065 6369  cket is of speci
│ │ │ │ +00046fc0: 6669 6564 0a20 2020 2020 656e 6372 7970  fied.     encryp
│ │ │ │ +00046fd0: 7469 6f6e 2074 7970 652e 0a0a 7368 6973  tion type...shis
│ │ │ │ +00046fe0: 6869 5f74 6b74 5f6c 6173 7472 6571 630a  hi_tkt_lastreqc.
│ │ │ │  00046ff0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00047000: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ -00047010: 2074 696d 655f 7420 7368 6973 6869 5f74   time_t shishi_t
│ │ │ │ -00047020: 6b74 5f6c 6173 7472 6571 6320 2853 6869  kt_lastreqc (Shi
│ │ │ │ -00047030: 7368 695f 746b 7420 2a20 544b 542c 0a20  shi_tkt * TKT,. 
│ │ │ │ -00047040: 2020 2020 2020 2020 2053 6869 7368 695f           Shishi_
│ │ │ │ -00047050: 6c72 7479 7065 204c 5254 5950 4529 0a20  lrtype LRTYPE). 
│ │ │ │ -00047060: 2020 2020 544b 543a 2069 6e70 7574 2076      TKT: input v
│ │ │ │ -00047070: 6172 6961 626c 6520 7769 7468 2074 6963  ariable with tic
│ │ │ │ -00047080: 6b65 7420 696e 666f 2e0a 2020 2020 204c  ket info..     L
│ │ │ │ -00047090: 5254 5950 453a 206c 6173 7472 6571 2074  RTYPE: lastreq t
│ │ │ │ -000470a0: 7970 6520 746f 2065 7874 7261 6374 2c20  ype to extract, 
│ │ │ │ -000470b0: 7365 6520 5368 6973 6869 5f6c 7274 7970  see Shishi_lrtyp
│ │ │ │ -000470c0: 652e 2020 452e 672e 2c0a 2020 2020 2053  e.  E.g.,.     S
│ │ │ │ -000470d0: 4849 5348 495f 4c52 5459 5045 5f4c 4153  HISHI_LRTYPE_LAS
│ │ │ │ -000470e0: 545f 5245 5155 4553 542e 0a0a 2020 2020  T_REQUEST...    
│ │ │ │ -000470f0: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ -00047100: 4578 7472 6163 7420 4320 7469 6d65 2063  Extract C time c
│ │ │ │ -00047110: 6f72 7265 7370 6f6e 6469 6e67 2074 6f20  orresponding to 
│ │ │ │ -00047120: 6769 7665 6e20 6c61 7374 7265 7120 7479  given lastreq ty
│ │ │ │ -00047130: 7065 0a20 2020 2020 6669 656c 6420 696e  pe.     field in
│ │ │ │ -00047140: 2074 6865 2074 6963 6b65 742e 0a0a 2020   the ticket...  
│ │ │ │ -00047150: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ -00047160: 3a2a 2052 6574 7572 6e73 2043 2074 696d  :* Returns C tim
│ │ │ │ -00047170: 6520 696e 7465 7270 7265 7461 7469 6f6e  e interpretation
│ │ │ │ -00047180: 206f 6620 7468 6520 7370 6563 6966 6965   of the specifie
│ │ │ │ -00047190: 640a 2020 2020 206c 6173 7472 6571 2066  d.     lastreq f
│ │ │ │ -000471a0: 6965 6c64 2c20 6f72 2028 7469 6d65 5f74  ield, or (time_t
│ │ │ │ -000471b0: 2920 2d31 2e0a 0a73 6869 7368 695f 746b  ) -1...shishi_tk
│ │ │ │ -000471c0: 745f 6175 7468 6374 696d 650a 2d2d 2d2d  t_authctime.----
│ │ │ │ +00047000: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ +00047010: 6e3a 2074 696d 655f 7420 7368 6973 6869  n: time_t shishi
│ │ │ │ +00047020: 5f74 6b74 5f6c 6173 7472 6571 6320 2853  _tkt_lastreqc (S
│ │ │ │ +00047030: 6869 7368 695f 746b 7420 2a20 544b 542c  hishi_tkt * TKT,
│ │ │ │ +00047040: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ +00047050: 695f 6c72 7479 7065 204c 5254 5950 4529  i_lrtype LRTYPE)
│ │ │ │ +00047060: 0a20 2020 2020 544b 543a 2069 6e70 7574  .     TKT: input
│ │ │ │ +00047070: 2076 6172 6961 626c 6520 7769 7468 2074   variable with t
│ │ │ │ +00047080: 6963 6b65 7420 696e 666f 2e0a 2020 2020  icket info..    
│ │ │ │ +00047090: 204c 5254 5950 453a 206c 6173 7472 6571   LRTYPE: lastreq
│ │ │ │ +000470a0: 2074 7970 6520 746f 2065 7874 7261 6374   type to extract
│ │ │ │ +000470b0: 2c20 7365 6520 5368 6973 6869 5f6c 7274  , see Shishi_lrt
│ │ │ │ +000470c0: 7970 652e 2020 452e 672e 2c0a 2020 2020  ype.  E.g.,.    
│ │ │ │ +000470d0: 2053 4849 5348 495f 4c52 5459 5045 5f4c   SHISHI_LRTYPE_L
│ │ │ │ +000470e0: 4153 545f 5245 5155 4553 542e 0a0a 2020  AST_REQUEST...  
│ │ │ │ +000470f0: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ +00047100: 2a20 4578 7472 6163 7420 4320 7469 6d65  * Extract C time
│ │ │ │ +00047110: 2063 6f72 7265 7370 6f6e 6469 6e67 2074   corresponding t
│ │ │ │ +00047120: 6f20 6769 7665 6e20 6c61 7374 7265 7120  o given lastreq 
│ │ │ │ +00047130: 7479 7065 0a20 2020 2020 6669 656c 6420  type.     field 
│ │ │ │ +00047140: 696e 2074 6865 2074 6963 6b65 742e 0a0a  in the ticket...
│ │ │ │ +00047150: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ +00047160: 7565 3a2a 2052 6574 7572 6e73 2043 2074  ue:* Returns C t
│ │ │ │ +00047170: 696d 6520 696e 7465 7270 7265 7461 7469  ime interpretati
│ │ │ │ +00047180: 6f6e 206f 6620 7468 6520 7370 6563 6966  on of the specif
│ │ │ │ +00047190: 6965 640a 2020 2020 206c 6173 7472 6571  ied.     lastreq
│ │ │ │ +000471a0: 2066 6965 6c64 2c20 6f72 2028 7469 6d65   field, or (time
│ │ │ │ +000471b0: 5f74 2920 2d31 2e0a 0a73 6869 7368 695f  _t) -1...shishi_
│ │ │ │ +000471c0: 746b 745f 6175 7468 6374 696d 650a 2d2d  tkt_authctime.--
│ │ │ │  000471d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000471e0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ -000471f0: 7469 6d65 5f74 2073 6869 7368 695f 746b  time_t shishi_tk
│ │ │ │ -00047200: 745f 6175 7468 6374 696d 6520 2853 6869  t_authctime (Shi
│ │ │ │ -00047210: 7368 695f 746b 7420 2a20 544b 5429 0a20  shi_tkt * TKT). 
│ │ │ │ -00047220: 2020 2020 544b 543a 2069 6e70 7574 2076      TKT: input v
│ │ │ │ -00047230: 6172 6961 626c 6520 7769 7468 2074 6963  ariable with tic
│ │ │ │ -00047240: 6b65 7420 696e 666f 2e0a 0a20 2020 2020  ket info...     
│ │ │ │ -00047250: 2a44 6573 6372 6970 7469 6f6e 3a2a 2045  *Description:* E
│ │ │ │ -00047260: 7874 7261 6374 2043 2074 696d 6520 636f  xtract C time co
│ │ │ │ -00047270: 7272 6573 706f 6e64 696e 6720 746f 2074  rresponding to t
│ │ │ │ -00047280: 6865 2061 7574 6874 696d 6520 6669 656c  he authtime fiel
│ │ │ │ -00047290: 642e 0a20 2020 2020 5468 6520 6669 656c  d..     The fiel
│ │ │ │ -000472a0: 6420 686f 6c64 7320 7468 6520 7469 6d65  d holds the time
│ │ │ │ -000472b0: 2077 6865 6e20 7468 6520 6f72 6967 696e   when the origin
│ │ │ │ -000472c0: 616c 2061 7574 6865 6e74 6963 6174 696f  al authenticatio
│ │ │ │ -000472d0: 6e20 746f 6f6b 0a20 2020 2020 706c 6163  n took.     plac
│ │ │ │ -000472e0: 6520 7468 6174 206c 6174 6572 2072 6573  e that later res
│ │ │ │ -000472f0: 756c 7465 6420 696e 2074 6869 7320 7469  ulted in this ti
│ │ │ │ -00047300: 636b 6574 2e0a 0a20 2020 2020 2a52 6574  cket...     *Ret
│ │ │ │ -00047310: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ -00047320: 726e 7320 4320 7469 6d65 2069 6e74 6572  rns C time inter
│ │ │ │ -00047330: 7072 6574 6174 696f 6e20 6f66 2074 6865  pretation of the
│ │ │ │ -00047340: 2065 6e64 7469 6d65 2069 6e0a 2020 2020   endtime in.    
│ │ │ │ -00047350: 2074 6963 6b65 742e 0a0a 7368 6973 6869   ticket...shishi
│ │ │ │ -00047360: 5f74 6b74 5f73 7461 7274 6374 696d 650a  _tkt_startctime.
│ │ │ │ -00047370: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00047380: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ -00047390: 696f 6e3a 2074 696d 655f 7420 7368 6973  ion: time_t shis
│ │ │ │ -000473a0: 6869 5f74 6b74 5f73 7461 7274 6374 696d  hi_tkt_startctim
│ │ │ │ -000473b0: 6520 2853 6869 7368 695f 746b 7420 2a20  e (Shishi_tkt * 
│ │ │ │ -000473c0: 544b 5429 0a20 2020 2020 544b 543a 2069  TKT).     TKT: i
│ │ │ │ -000473d0: 6e70 7574 2076 6172 6961 626c 6520 7769  nput variable wi
│ │ │ │ -000473e0: 7468 2074 6963 6b65 7420 696e 666f 2e0a  th ticket info..
│ │ │ │ -000473f0: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -00047400: 6f6e 3a2a 2045 7874 7261 6374 2043 2074  on:* Extract C t
│ │ │ │ -00047410: 696d 6520 636f 7272 6573 706f 6e64 696e  ime correspondin
│ │ │ │ -00047420: 6720 746f 2074 6865 2073 7461 7274 7469  g to the startti
│ │ │ │ -00047430: 6d65 2066 6965 6c64 2e0a 2020 2020 2054  me field..     T
│ │ │ │ -00047440: 6865 2066 6965 6c64 2068 6f6c 6473 2074  he field holds t
│ │ │ │ -00047450: 6865 2074 696d 6520 7768 6572 6520 7468  he time where th
│ │ │ │ -00047460: 6520 7469 636b 6574 2073 7461 7274 2074  e ticket start t
│ │ │ │ -00047470: 6f20 6265 2076 616c 6964 0a20 2020 2020  o be valid.     
│ │ │ │ -00047480: 2874 7970 6963 616c 6c79 2069 6e20 7468  (typically in th
│ │ │ │ -00047490: 6520 7061 7374 292e 0a0a 2020 2020 202a  e past)...     *
│ │ │ │ -000474a0: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ -000474b0: 6574 7572 6e73 2043 2074 696d 6520 696e  eturns C time in
│ │ │ │ -000474c0: 7465 7270 7265 7461 7469 6f6e 206f 6620  terpretation of 
│ │ │ │ -000474d0: 7468 6520 656e 6474 696d 6520 696e 0a20  the endtime in. 
│ │ │ │ -000474e0: 2020 2020 7469 636b 6574 2e0a 0a73 6869      ticket...shi
│ │ │ │ -000474f0: 7368 695f 746b 745f 656e 6463 7469 6d65  shi_tkt_endctime
│ │ │ │ -00047500: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ -00047510: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -00047520: 6f6e 3a20 7469 6d65 5f74 2073 6869 7368  on: time_t shish
│ │ │ │ -00047530: 695f 746b 745f 656e 6463 7469 6d65 2028  i_tkt_endctime (
│ │ │ │ -00047540: 5368 6973 6869 5f74 6b74 202a 2054 4b54  Shishi_tkt * TKT
│ │ │ │ -00047550: 290a 2020 2020 2054 4b54 3a20 696e 7075  ).     TKT: inpu
│ │ │ │ -00047560: 7420 7661 7269 6162 6c65 2077 6974 6820  t variable with 
│ │ │ │ -00047570: 7469 636b 6574 2069 6e66 6f2e 0a0a 2020  ticket info...  
│ │ │ │ -00047580: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ -00047590: 2a20 4578 7472 6163 7420 4320 7469 6d65  * Extract C time
│ │ │ │ -000475a0: 2063 6f72 7265 7370 6f6e 6469 6e67 2074   corresponding t
│ │ │ │ -000475b0: 6f20 7468 6520 656e 6474 696d 6520 6669  o the endtime fi
│ │ │ │ -000475c0: 656c 642e 0a20 2020 2020 5468 6520 6669  eld..     The fi
│ │ │ │ -000475d0: 656c 6420 686f 6c64 7320 7468 6520 7469  eld holds the ti
│ │ │ │ -000475e0: 6d65 2077 6865 7265 2074 6865 2074 6963  me where the tic
│ │ │ │ -000475f0: 6b65 7420 7374 6f70 2062 6569 6e67 2076  ket stop being v
│ │ │ │ -00047600: 616c 6964 2e0a 0a20 2020 2020 2a52 6574  alid...     *Ret
│ │ │ │ -00047610: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ -00047620: 726e 7320 4320 7469 6d65 2069 6e74 6572  rns C time inter
│ │ │ │ -00047630: 7072 6574 6174 696f 6e20 6f66 2074 6865  pretation of the
│ │ │ │ -00047640: 2065 6e64 7469 6d65 2069 6e0a 2020 2020   endtime in.    
│ │ │ │ -00047650: 2074 6963 6b65 742e 0a0a 7368 6973 6869   ticket...shishi
│ │ │ │ -00047660: 5f74 6b74 5f72 656e 6577 5f74 696c 6c63  _tkt_renew_tillc
│ │ │ │ -00047670: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ -00047680: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ -00047690: 6374 696f 6e3a 2074 696d 655f 7420 7368  ction: time_t sh
│ │ │ │ -000476a0: 6973 6869 5f74 6b74 5f72 656e 6577 5f74  ishi_tkt_renew_t
│ │ │ │ -000476b0: 696c 6c63 2028 5368 6973 6869 5f74 6b74  illc (Shishi_tkt
│ │ │ │ -000476c0: 202a 2054 4b54 290a 2020 2020 2054 4b54   * TKT).     TKT
│ │ │ │ -000476d0: 3a20 696e 7075 7420 7661 7269 6162 6c65  : input variable
│ │ │ │ -000476e0: 2077 6974 6820 7469 636b 6574 2069 6e66   with ticket inf
│ │ │ │ -000476f0: 6f2e 0a0a 2020 2020 202a 4465 7363 7269  o...     *Descri
│ │ │ │ -00047700: 7074 696f 6e3a 2a20 4578 7472 6163 7420  ption:* Extract 
│ │ │ │ -00047710: 4320 7469 6d65 2063 6f72 7265 7370 6f6e  C time correspon
│ │ │ │ -00047720: 6469 6e67 2074 6f20 7468 6520 7265 6e65  ding to the rene
│ │ │ │ -00047730: 772d 7469 6c6c 0a20 2020 2020 6669 656c  w-till.     fiel
│ │ │ │ -00047740: 642e 2020 5468 6520 6669 656c 6420 686f  d.  The field ho
│ │ │ │ -00047750: 6c64 7320 7468 6520 7469 6d65 2077 6865  lds the time whe
│ │ │ │ -00047760: 7265 2074 6865 2074 6963 6b65 7420 7374  re the ticket st
│ │ │ │ -00047770: 6f70 2062 6569 6e67 2076 616c 6964 0a20  op being valid. 
│ │ │ │ -00047780: 2020 2020 666f 7220 7265 6e65 7761 6c2e      for renewal.
│ │ │ │ -00047790: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ -000477a0: 616c 7565 3a2a 2052 6574 7572 6e73 2043  alue:* Returns C
│ │ │ │ -000477b0: 2074 696d 6520 696e 7465 7270 7265 7461   time interpreta
│ │ │ │ -000477c0: 7469 6f6e 206f 6620 7468 6520 7265 6e65  tion of the rene
│ │ │ │ -000477d0: 772d 7469 6c6c 2069 6e0a 2020 2020 2074  w-till in.     t
│ │ │ │ -000477e0: 6963 6b65 742e 0a0a 7368 6973 6869 5f74  icket...shishi_t
│ │ │ │ -000477f0: 6b74 5f76 616c 6964 5f61 745f 7469 6d65  kt_valid_at_time
│ │ │ │ -00047800: 5f70 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  _p.-------------
│ │ │ │ -00047810: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -00047820: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ -00047830: 2073 6869 7368 695f 746b 745f 7661 6c69   shishi_tkt_vali
│ │ │ │ -00047840: 645f 6174 5f74 696d 655f 7020 2853 6869  d_at_time_p (Shi
│ │ │ │ -00047850: 7368 695f 746b 7420 2a20 544b 542c 0a20  shi_tkt * TKT,. 
│ │ │ │ -00047860: 2020 2020 2020 2020 2074 696d 655f 7420           time_t 
│ │ │ │ -00047870: 4e4f 5729 0a20 2020 2020 544b 543a 2069  NOW).     TKT: i
│ │ │ │ -00047880: 6e70 7574 2076 6172 6961 626c 6520 7769  nput variable wi
│ │ │ │ -00047890: 7468 2074 6963 6b65 7420 696e 666f 2e0a  th ticket info..
│ │ │ │ -000478a0: 2020 2020 204e 4f57 3a20 7469 6d65 2074       NOW: time t
│ │ │ │ -000478b0: 6f20 6368 6563 6b20 666f 722e 0a0a 2020  o check for...  
│ │ │ │ -000478c0: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ -000478d0: 2a20 4465 7465 726d 696e 6520 6966 2074  * Determine if t
│ │ │ │ -000478e0: 6963 6b65 7420 6973 2076 616c 6964 2061  icket is valid a
│ │ │ │ -000478f0: 7420 6120 7370 6563 6966 6963 2070 6f69  t a specific poi
│ │ │ │ -00047900: 6e74 2069 6e0a 2020 2020 2074 696d 652e  nt in.     time.
│ │ │ │ -00047910: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ -00047920: 616c 7565 3a2a 2052 6574 7572 6e73 206e  alue:* Returns n
│ │ │ │ -00047930: 6f6e 2d30 2069 6666 2074 6963 6b65 7420  on-0 iff ticket 
│ │ │ │ -00047940: 6973 2076 616c 6964 2028 6e6f 7420 6578  is valid (not ex
│ │ │ │ -00047950: 7069 7265 6420 616e 640a 2020 2020 2061  pired and.     a
│ │ │ │ -00047960: 6674 6572 2073 7461 7274 7469 6d65 2920  fter starttime) 
│ │ │ │ -00047970: 6174 2073 7065 6369 6669 6564 2074 696d  at specified tim
│ │ │ │ -00047980: 652e 0a0a 7368 6973 6869 5f74 6b74 5f76  e...shishi_tkt_v
│ │ │ │ -00047990: 616c 6964 5f6e 6f77 5f70 0a2d 2d2d 2d2d  alid_now_p.-----
│ │ │ │ +000471e0: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ +000471f0: 3a20 7469 6d65 5f74 2073 6869 7368 695f  : time_t shishi_
│ │ │ │ +00047200: 746b 745f 6175 7468 6374 696d 6520 2853  tkt_authctime (S
│ │ │ │ +00047210: 6869 7368 695f 746b 7420 2a20 544b 5429  hishi_tkt * TKT)
│ │ │ │ +00047220: 0a20 2020 2020 544b 543a 2069 6e70 7574  .     TKT: input
│ │ │ │ +00047230: 2076 6172 6961 626c 6520 7769 7468 2074   variable with t
│ │ │ │ +00047240: 6963 6b65 7420 696e 666f 2e0a 0a20 2020  icket info...   
│ │ │ │ +00047250: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ +00047260: 2045 7874 7261 6374 2043 2074 696d 6520   Extract C time 
│ │ │ │ +00047270: 636f 7272 6573 706f 6e64 696e 6720 746f  corresponding to
│ │ │ │ +00047280: 2074 6865 2061 7574 6874 696d 6520 6669   the authtime fi
│ │ │ │ +00047290: 656c 642e 0a20 2020 2020 5468 6520 6669  eld..     The fi
│ │ │ │ +000472a0: 656c 6420 686f 6c64 7320 7468 6520 7469  eld holds the ti
│ │ │ │ +000472b0: 6d65 2077 6865 6e20 7468 6520 6f72 6967  me when the orig
│ │ │ │ +000472c0: 696e 616c 2061 7574 6865 6e74 6963 6174  inal authenticat
│ │ │ │ +000472d0: 696f 6e20 746f 6f6b 0a20 2020 2020 706c  ion took.     pl
│ │ │ │ +000472e0: 6163 6520 7468 6174 206c 6174 6572 2072  ace that later r
│ │ │ │ +000472f0: 6573 756c 7465 6420 696e 2074 6869 7320  esulted in this 
│ │ │ │ +00047300: 7469 636b 6574 2e0a 0a20 2020 2020 2a52  ticket...     *R
│ │ │ │ +00047310: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +00047320: 7475 726e 7320 4320 7469 6d65 2069 6e74  turns C time int
│ │ │ │ +00047330: 6572 7072 6574 6174 696f 6e20 6f66 2074  erpretation of t
│ │ │ │ +00047340: 6865 2065 6e64 7469 6d65 2069 6e0a 2020  he endtime in.  
│ │ │ │ +00047350: 2020 2074 6963 6b65 742e 0a0a 7368 6973     ticket...shis
│ │ │ │ +00047360: 6869 5f74 6b74 5f73 7461 7274 6374 696d  hi_tkt_startctim
│ │ │ │ +00047370: 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  e.--------------
│ │ │ │ +00047380: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +00047390: 6374 696f 6e3a 2074 696d 655f 7420 7368  ction: time_t sh
│ │ │ │ +000473a0: 6973 6869 5f74 6b74 5f73 7461 7274 6374  ishi_tkt_startct
│ │ │ │ +000473b0: 696d 6520 2853 6869 7368 695f 746b 7420  ime (Shishi_tkt 
│ │ │ │ +000473c0: 2a20 544b 5429 0a20 2020 2020 544b 543a  * TKT).     TKT:
│ │ │ │ +000473d0: 2069 6e70 7574 2076 6172 6961 626c 6520   input variable 
│ │ │ │ +000473e0: 7769 7468 2074 6963 6b65 7420 696e 666f  with ticket info
│ │ │ │ +000473f0: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ +00047400: 7469 6f6e 3a2a 2045 7874 7261 6374 2043  tion:* Extract C
│ │ │ │ +00047410: 2074 696d 6520 636f 7272 6573 706f 6e64   time correspond
│ │ │ │ +00047420: 696e 6720 746f 2074 6865 2073 7461 7274  ing to the start
│ │ │ │ +00047430: 7469 6d65 2066 6965 6c64 2e0a 2020 2020  time field..    
│ │ │ │ +00047440: 2054 6865 2066 6965 6c64 2068 6f6c 6473   The field holds
│ │ │ │ +00047450: 2074 6865 2074 696d 6520 7768 6572 6520   the time where 
│ │ │ │ +00047460: 7468 6520 7469 636b 6574 2073 7461 7274  the ticket start
│ │ │ │ +00047470: 2074 6f20 6265 2076 616c 6964 0a20 2020   to be valid.   
│ │ │ │ +00047480: 2020 2874 7970 6963 616c 6c79 2069 6e20    (typically in 
│ │ │ │ +00047490: 7468 6520 7061 7374 292e 0a0a 2020 2020  the past)...    
│ │ │ │ +000474a0: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ +000474b0: 2052 6574 7572 6e73 2043 2074 696d 6520   Returns C time 
│ │ │ │ +000474c0: 696e 7465 7270 7265 7461 7469 6f6e 206f  interpretation o
│ │ │ │ +000474d0: 6620 7468 6520 656e 6474 696d 6520 696e  f the endtime in
│ │ │ │ +000474e0: 0a20 2020 2020 7469 636b 6574 2e0a 0a73  .     ticket...s
│ │ │ │ +000474f0: 6869 7368 695f 746b 745f 656e 6463 7469  hishi_tkt_endcti
│ │ │ │ +00047500: 6d65 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  me.-------------
│ │ │ │ +00047510: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ +00047520: 7469 6f6e 3a20 7469 6d65 5f74 2073 6869  tion: time_t shi
│ │ │ │ +00047530: 7368 695f 746b 745f 656e 6463 7469 6d65  shi_tkt_endctime
│ │ │ │ +00047540: 2028 5368 6973 6869 5f74 6b74 202a 2054   (Shishi_tkt * T
│ │ │ │ +00047550: 4b54 290a 2020 2020 2054 4b54 3a20 696e  KT).     TKT: in
│ │ │ │ +00047560: 7075 7420 7661 7269 6162 6c65 2077 6974  put variable wit
│ │ │ │ +00047570: 6820 7469 636b 6574 2069 6e66 6f2e 0a0a  h ticket info...
│ │ │ │ +00047580: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ +00047590: 6e3a 2a20 4578 7472 6163 7420 4320 7469  n:* Extract C ti
│ │ │ │ +000475a0: 6d65 2063 6f72 7265 7370 6f6e 6469 6e67  me corresponding
│ │ │ │ +000475b0: 2074 6f20 7468 6520 656e 6474 696d 6520   to the endtime 
│ │ │ │ +000475c0: 6669 656c 642e 0a20 2020 2020 5468 6520  field..     The 
│ │ │ │ +000475d0: 6669 656c 6420 686f 6c64 7320 7468 6520  field holds the 
│ │ │ │ +000475e0: 7469 6d65 2077 6865 7265 2074 6865 2074  time where the t
│ │ │ │ +000475f0: 6963 6b65 7420 7374 6f70 2062 6569 6e67  icket stop being
│ │ │ │ +00047600: 2076 616c 6964 2e0a 0a20 2020 2020 2a52   valid...     *R
│ │ │ │ +00047610: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +00047620: 7475 726e 7320 4320 7469 6d65 2069 6e74  turns C time int
│ │ │ │ +00047630: 6572 7072 6574 6174 696f 6e20 6f66 2074  erpretation of t
│ │ │ │ +00047640: 6865 2065 6e64 7469 6d65 2069 6e0a 2020  he endtime in.  
│ │ │ │ +00047650: 2020 2074 6963 6b65 742e 0a0a 7368 6973     ticket...shis
│ │ │ │ +00047660: 6869 5f74 6b74 5f72 656e 6577 5f74 696c  hi_tkt_renew_til
│ │ │ │ +00047670: 6c63 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  lc.-------------
│ │ │ │ +00047680: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +00047690: 756e 6374 696f 6e3a 2074 696d 655f 7420  unction: time_t 
│ │ │ │ +000476a0: 7368 6973 6869 5f74 6b74 5f72 656e 6577  shishi_tkt_renew
│ │ │ │ +000476b0: 5f74 696c 6c63 2028 5368 6973 6869 5f74  _tillc (Shishi_t
│ │ │ │ +000476c0: 6b74 202a 2054 4b54 290a 2020 2020 2054  kt * TKT).     T
│ │ │ │ +000476d0: 4b54 3a20 696e 7075 7420 7661 7269 6162  KT: input variab
│ │ │ │ +000476e0: 6c65 2077 6974 6820 7469 636b 6574 2069  le with ticket i
│ │ │ │ +000476f0: 6e66 6f2e 0a0a 2020 2020 202a 4465 7363  nfo...     *Desc
│ │ │ │ +00047700: 7269 7074 696f 6e3a 2a20 4578 7472 6163  ription:* Extrac
│ │ │ │ +00047710: 7420 4320 7469 6d65 2063 6f72 7265 7370  t C time corresp
│ │ │ │ +00047720: 6f6e 6469 6e67 2074 6f20 7468 6520 7265  onding to the re
│ │ │ │ +00047730: 6e65 772d 7469 6c6c 0a20 2020 2020 6669  new-till.     fi
│ │ │ │ +00047740: 656c 642e 2020 5468 6520 6669 656c 6420  eld.  The field 
│ │ │ │ +00047750: 686f 6c64 7320 7468 6520 7469 6d65 2077  holds the time w
│ │ │ │ +00047760: 6865 7265 2074 6865 2074 6963 6b65 7420  here the ticket 
│ │ │ │ +00047770: 7374 6f70 2062 6569 6e67 2076 616c 6964  stop being valid
│ │ │ │ +00047780: 0a20 2020 2020 666f 7220 7265 6e65 7761  .     for renewa
│ │ │ │ +00047790: 6c2e 0a0a 2020 2020 202a 5265 7475 726e  l...     *Return
│ │ │ │ +000477a0: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ +000477b0: 2043 2074 696d 6520 696e 7465 7270 7265   C time interpre
│ │ │ │ +000477c0: 7461 7469 6f6e 206f 6620 7468 6520 7265  tation of the re
│ │ │ │ +000477d0: 6e65 772d 7469 6c6c 2069 6e0a 2020 2020  new-till in.    
│ │ │ │ +000477e0: 2074 6963 6b65 742e 0a0a 7368 6973 6869   ticket...shishi
│ │ │ │ +000477f0: 5f74 6b74 5f76 616c 6964 5f61 745f 7469  _tkt_valid_at_ti
│ │ │ │ +00047800: 6d65 5f70 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  me_p.-----------
│ │ │ │ +00047810: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +00047820: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ +00047830: 6e74 2073 6869 7368 695f 746b 745f 7661  nt shishi_tkt_va
│ │ │ │ +00047840: 6c69 645f 6174 5f74 696d 655f 7020 2853  lid_at_time_p (S
│ │ │ │ +00047850: 6869 7368 695f 746b 7420 2a20 544b 542c  hishi_tkt * TKT,
│ │ │ │ +00047860: 0a20 2020 2020 2020 2020 2074 696d 655f  .          time_
│ │ │ │ +00047870: 7420 4e4f 5729 0a20 2020 2020 544b 543a  t NOW).     TKT:
│ │ │ │ +00047880: 2069 6e70 7574 2076 6172 6961 626c 6520   input variable 
│ │ │ │ +00047890: 7769 7468 2074 6963 6b65 7420 696e 666f  with ticket info
│ │ │ │ +000478a0: 2e0a 2020 2020 204e 4f57 3a20 7469 6d65  ..     NOW: time
│ │ │ │ +000478b0: 2074 6f20 6368 6563 6b20 666f 722e 0a0a   to check for...
│ │ │ │ +000478c0: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ +000478d0: 6e3a 2a20 4465 7465 726d 696e 6520 6966  n:* Determine if
│ │ │ │ +000478e0: 2074 6963 6b65 7420 6973 2076 616c 6964   ticket is valid
│ │ │ │ +000478f0: 2061 7420 6120 7370 6563 6966 6963 2070   at a specific p
│ │ │ │ +00047900: 6f69 6e74 2069 6e0a 2020 2020 2074 696d  oint in.     tim
│ │ │ │ +00047910: 652e 0a0a 2020 2020 202a 5265 7475 726e  e...     *Return
│ │ │ │ +00047920: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ +00047930: 206e 6f6e 2d30 2069 6666 2074 6963 6b65   non-0 iff ticke
│ │ │ │ +00047940: 7420 6973 2076 616c 6964 2028 6e6f 7420  t is valid (not 
│ │ │ │ +00047950: 6578 7069 7265 6420 616e 640a 2020 2020  expired and.    
│ │ │ │ +00047960: 2061 6674 6572 2073 7461 7274 7469 6d65   after starttime
│ │ │ │ +00047970: 2920 6174 2073 7065 6369 6669 6564 2074  ) at specified t
│ │ │ │ +00047980: 696d 652e 0a0a 7368 6973 6869 5f74 6b74  ime...shishi_tkt
│ │ │ │ +00047990: 5f76 616c 6964 5f6e 6f77 5f70 0a2d 2d2d  _valid_now_p.---
│ │ │ │  000479a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000479b0: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ -000479c0: 2069 6e74 2073 6869 7368 695f 746b 745f   int shishi_tkt_
│ │ │ │ -000479d0: 7661 6c69 645f 6e6f 775f 7020 2853 6869  valid_now_p (Shi
│ │ │ │ -000479e0: 7368 695f 746b 7420 2a20 544b 5429 0a20  shi_tkt * TKT). 
│ │ │ │ -000479f0: 2020 2020 544b 543a 2069 6e70 7574 2076      TKT: input v
│ │ │ │ -00047a00: 6172 6961 626c 6520 7769 7468 2074 6963  ariable with tic
│ │ │ │ -00047a10: 6b65 7420 696e 666f 2e0a 0a20 2020 2020  ket info...     
│ │ │ │ -00047a20: 2a44 6573 6372 6970 7469 6f6e 3a2a 2044  *Description:* D
│ │ │ │ -00047a30: 6574 6572 6d69 6e65 2069 6620 7469 636b  etermine if tick
│ │ │ │ -00047a40: 6574 2069 7320 7661 6c69 6420 6e6f 772e  et is valid now.
│ │ │ │ -00047a50: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ -00047a60: 616c 7565 3a2a 2052 6574 7572 6e73 2030  alue:* Returns 0
│ │ │ │ -00047a70: 2069 6666 2074 6963 6b65 7420 6973 2069   iff ticket is i
│ │ │ │ -00047a80: 6e76 616c 6964 2028 6578 7069 7265 6420  nvalid (expired 
│ │ │ │ -00047a90: 6f72 206e 6f74 2079 6574 0a20 2020 2020  or not yet.     
│ │ │ │ -00047aa0: 7661 6c69 6429 2e0a 0a73 6869 7368 695f  valid)...shishi_
│ │ │ │ -00047ab0: 746b 745f 6578 7069 7265 645f 700a 2d2d  tkt_expired_p.--
│ │ │ │ +000479b0: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ +000479c0: 6e3a 2069 6e74 2073 6869 7368 695f 746b  n: int shishi_tk
│ │ │ │ +000479d0: 745f 7661 6c69 645f 6e6f 775f 7020 2853  t_valid_now_p (S
│ │ │ │ +000479e0: 6869 7368 695f 746b 7420 2a20 544b 5429  hishi_tkt * TKT)
│ │ │ │ +000479f0: 0a20 2020 2020 544b 543a 2069 6e70 7574  .     TKT: input
│ │ │ │ +00047a00: 2076 6172 6961 626c 6520 7769 7468 2074   variable with t
│ │ │ │ +00047a10: 6963 6b65 7420 696e 666f 2e0a 0a20 2020  icket info...   
│ │ │ │ +00047a20: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ +00047a30: 2044 6574 6572 6d69 6e65 2069 6620 7469   Determine if ti
│ │ │ │ +00047a40: 636b 6574 2069 7320 7661 6c69 6420 6e6f  cket is valid no
│ │ │ │ +00047a50: 772e 0a0a 2020 2020 202a 5265 7475 726e  w...     *Return
│ │ │ │ +00047a60: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ +00047a70: 2030 2069 6666 2074 6963 6b65 7420 6973   0 iff ticket is
│ │ │ │ +00047a80: 2069 6e76 616c 6964 2028 6578 7069 7265   invalid (expire
│ │ │ │ +00047a90: 6420 6f72 206e 6f74 2079 6574 0a20 2020  d or not yet.   
│ │ │ │ +00047aa0: 2020 7661 6c69 6429 2e0a 0a73 6869 7368    valid)...shish
│ │ │ │ +00047ab0: 695f 746b 745f 6578 7069 7265 645f 700a  i_tkt_expired_p.
│ │ │ │  00047ac0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00047ad0: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ -00047ae0: 3a20 696e 7420 7368 6973 6869 5f74 6b74  : int shishi_tkt
│ │ │ │ -00047af0: 5f65 7870 6972 6564 5f70 2028 5368 6973  _expired_p (Shis
│ │ │ │ -00047b00: 6869 5f74 6b74 202a 2054 4b54 290a 2020  hi_tkt * TKT).  
│ │ │ │ -00047b10: 2020 2054 4b54 3a20 696e 7075 7420 7661     TKT: input va
│ │ │ │ -00047b20: 7269 6162 6c65 2077 6974 6820 7469 636b  riable with tick
│ │ │ │ -00047b30: 6574 2069 6e66 6f2e 0a0a 2020 2020 202a  et info...     *
│ │ │ │ -00047b40: 4465 7363 7269 7074 696f 6e3a 2a20 4465  Description:* De
│ │ │ │ -00047b50: 7465 726d 696e 6520 6966 2074 6963 6b65  termine if ticke
│ │ │ │ -00047b60: 7420 6861 7320 6578 7069 7265 6420 2869  t has expired (i
│ │ │ │ -00047b70: 2e65 2e2c 2065 6e64 7469 6d65 2069 7320  .e., endtime is 
│ │ │ │ -00047b80: 696e 0a20 2020 2020 7468 6520 7061 7374  in.     the past
│ │ │ │ -00047b90: 292e 0a0a 2020 2020 202a 5265 7475 726e  )...     *Return
│ │ │ │ -00047ba0: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ -00047bb0: 2030 2069 6666 2074 6963 6b65 7420 6861   0 iff ticket ha
│ │ │ │ -00047bc0: 7320 6578 7069 7265 642e 0a0a 7368 6973  s expired...shis
│ │ │ │ -00047bd0: 6869 5f74 6b74 5f6c 6173 7472 6571 5f70  hi_tkt_lastreq_p
│ │ │ │ -00047be0: 7265 7474 795f 7072 696e 740a 2d2d 2d2d  retty_print.----
│ │ │ │ +00047ad0: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ +00047ae0: 6f6e 3a20 696e 7420 7368 6973 6869 5f74  on: int shishi_t
│ │ │ │ +00047af0: 6b74 5f65 7870 6972 6564 5f70 2028 5368  kt_expired_p (Sh
│ │ │ │ +00047b00: 6973 6869 5f74 6b74 202a 2054 4b54 290a  ishi_tkt * TKT).
│ │ │ │ +00047b10: 2020 2020 2054 4b54 3a20 696e 7075 7420       TKT: input 
│ │ │ │ +00047b20: 7661 7269 6162 6c65 2077 6974 6820 7469  variable with ti
│ │ │ │ +00047b30: 636b 6574 2069 6e66 6f2e 0a0a 2020 2020  cket info...    
│ │ │ │ +00047b40: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ +00047b50: 4465 7465 726d 696e 6520 6966 2074 6963  Determine if tic
│ │ │ │ +00047b60: 6b65 7420 6861 7320 6578 7069 7265 6420  ket has expired 
│ │ │ │ +00047b70: 2869 2e65 2e2c 2065 6e64 7469 6d65 2069  (i.e., endtime i
│ │ │ │ +00047b80: 7320 696e 0a20 2020 2020 7468 6520 7061  s in.     the pa
│ │ │ │ +00047b90: 7374 292e 0a0a 2020 2020 202a 5265 7475  st)...     *Retu
│ │ │ │ +00047ba0: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ +00047bb0: 6e73 2030 2069 6666 2074 6963 6b65 7420  ns 0 iff ticket 
│ │ │ │ +00047bc0: 6861 7320 6578 7069 7265 642e 0a0a 7368  has expired...sh
│ │ │ │ +00047bd0: 6973 6869 5f74 6b74 5f6c 6173 7472 6571  ishi_tkt_lastreq
│ │ │ │ +00047be0: 5f70 7265 7474 795f 7072 696e 740a 2d2d  _pretty_print.--
│ │ │ │  00047bf0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00047c00: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ -00047c10: 2046 756e 6374 696f 6e3a 2076 6f69 6420   Function: void 
│ │ │ │ -00047c20: 7368 6973 6869 5f74 6b74 5f6c 6173 7472  shishi_tkt_lastr
│ │ │ │ -00047c30: 6571 5f70 7265 7474 795f 7072 696e 7420  eq_pretty_print 
│ │ │ │ -00047c40: 2853 6869 7368 695f 746b 7420 2a20 544b  (Shishi_tkt * TK
│ │ │ │ -00047c50: 542c 0a20 2020 2020 2020 2020 2046 494c  T,.          FIL
│ │ │ │ -00047c60: 4520 2a20 4648 290a 2020 2020 2054 4b54  E * FH).     TKT
│ │ │ │ -00047c70: 3a20 696e 7075 7420 7661 7269 6162 6c65  : input variable
│ │ │ │ -00047c80: 2077 6974 6820 7469 636b 6574 2069 6e66   with ticket inf
│ │ │ │ -00047c90: 6f2e 0a20 2020 2020 4648 3a20 6669 6c65  o..     FH: file
│ │ │ │ -00047ca0: 2068 616e 646c 6520 6f70 656e 2066 6f72   handle open for
│ │ │ │ -00047cb0: 2077 7269 7469 6e67 2e0a 0a20 2020 2020   writing...     
│ │ │ │ -00047cc0: 2a44 6573 6372 6970 7469 6f6e 3a2a 2050  *Description:* P
│ │ │ │ -00047cd0: 7269 6e74 2061 2068 756d 616e 2072 6561  rint a human rea
│ │ │ │ -00047ce0: 6461 626c 6520 7265 7072 6573 656e 7461  dable representa
│ │ │ │ -00047cf0: 7469 6f6e 206f 6620 7468 6520 7661 7269  tion of the vari
│ │ │ │ -00047d00: 6f75 730a 2020 2020 206c 6173 7472 6571  ous.     lastreq
│ │ │ │ -00047d10: 2066 6965 6c64 7320 696e 2074 6865 2074   fields in the t
│ │ │ │ -00047d20: 6963 6b65 7420 2872 6561 6c6c 7920 456e  icket (really En
│ │ │ │ -00047d30: 634b 4443 5265 7050 6172 7429 2e0a 0a73  cKDCRepPart)...s
│ │ │ │ -00047d40: 6869 7368 695f 746b 745f 7072 6574 7479  hishi_tkt_pretty
│ │ │ │ -00047d50: 5f70 7269 6e74 0a2d 2d2d 2d2d 2d2d 2d2d  _print.---------
│ │ │ │ -00047d60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -00047d70: 202d 2d20 4675 6e63 7469 6f6e 3a20 766f   -- Function: vo
│ │ │ │ -00047d80: 6964 2073 6869 7368 695f 746b 745f 7072  id shishi_tkt_pr
│ │ │ │ -00047d90: 6574 7479 5f70 7269 6e74 2028 5368 6973  etty_print (Shis
│ │ │ │ -00047da0: 6869 5f74 6b74 202a 2054 4b54 2c20 4649  hi_tkt * TKT, FI
│ │ │ │ -00047db0: 4c45 202a 2046 4829 0a20 2020 2020 544b  LE * FH).     TK
│ │ │ │ -00047dc0: 543a 2069 6e70 7574 2076 6172 6961 626c  T: input variabl
│ │ │ │ -00047dd0: 6520 7769 7468 2074 6963 6b65 7420 696e  e with ticket in
│ │ │ │ -00047de0: 666f 2e0a 2020 2020 2046 483a 2066 696c  fo..     FH: fil
│ │ │ │ -00047df0: 6520 6861 6e64 6c65 206f 7065 6e20 666f  e handle open fo
│ │ │ │ -00047e00: 7220 7772 6974 696e 672e 0a0a 2020 2020  r writing...    
│ │ │ │ -00047e10: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ -00047e20: 5072 696e 7420 6120 6875 6d61 6e20 7265  Print a human re
│ │ │ │ -00047e30: 6164 6162 6c65 2072 6570 7265 7365 6e74  adable represent
│ │ │ │ -00047e40: 6174 696f 6e20 6f66 2061 2074 6963 6b65  ation of a ticke
│ │ │ │ -00047e50: 7420 746f 0a20 2020 2020 6669 6c65 2068  t to.     file h
│ │ │ │ -00047e60: 616e 646c 652e 0a0a 1f0a 4669 6c65 3a20  andle.....File: 
│ │ │ │ -00047e70: 7368 6973 6869 2e69 6e66 6f2c 2020 4e6f  shishi.info,  No
│ │ │ │ -00047e80: 6465 3a20 4153 2046 756e 6374 696f 6e73  de: AS Functions
│ │ │ │ -00047e90: 2c20 204e 6578 743a 2054 4753 2046 756e  ,  Next: TGS Fun
│ │ │ │ -00047ea0: 6374 696f 6e73 2c20 2050 7265 763a 2054  ctions,  Prev: T
│ │ │ │ -00047eb0: 6963 6b65 7420 4675 6e63 7469 6f6e 732c  icket Functions,
│ │ │ │ -00047ec0: 2020 5570 3a20 5072 6f67 7261 6d6d 696e    Up: Programmin
│ │ │ │ -00047ed0: 6720 4d61 6e75 616c 0a0a 352e 3720 4153  g Manual..5.7 AS
│ │ │ │ -00047ee0: 2046 756e 6374 696f 6e73 0a3d 3d3d 3d3d   Functions.=====
│ │ │ │ -00047ef0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a54 6865  ===========..The
│ │ │ │ -00047f00: 2041 7574 6865 6e74 6963 6174 696f 6e20   Authentication 
│ │ │ │ -00047f10: 5365 7276 6963 6520 2841 5329 2069 7320  Service (AS) is 
│ │ │ │ -00047f20: 7573 6564 2074 6f20 6765 7420 616e 2069  used to get an i
│ │ │ │ -00047f30: 6e69 7469 616c 2074 6963 6b65 7420 7573  nitial ticket us
│ │ │ │ -00047f40: 696e 670a 652e 672e 2020 796f 7572 2070  ing.e.g.  your p
│ │ │ │ -00047f50: 6173 7377 6f72 642e 2020 5468 6520 666f  assword.  The fo
│ │ │ │ -00047f60: 6c6c 6f77 696e 6720 696c 6c75 7374 7261  llowing illustra
│ │ │ │ -00047f70: 7465 7320 7468 6520 4153 2d52 4551 2061  tes the AS-REQ a
│ │ │ │ -00047f80: 6e64 2041 532d 5245 500a 4153 4e2e 3120  nd AS-REP.ASN.1 
│ │ │ │ -00047f90: 7374 7275 6374 7572 6573 2e0a 0a2d 2d20  structures...-- 
│ │ │ │ -00047fa0: 5265 7175 6573 7420 2d2d 0a0a 4153 2d52  Request --..AS-R
│ │ │ │ -00047fb0: 4551 0909 3a3a 3d20 4b44 432d 5245 5120  EQ..::= KDC-REQ 
│ │ │ │ -00047fc0: 7b31 307d 0a0a 4b44 432d 5245 5120 7b49  {10}..KDC-REQ {I
│ │ │ │ -00047fd0: 4e54 4547 4552 3a74 6167 6e75 6d7d 093a  NTEGER:tagnum}.:
│ │ │ │ -00047fe0: 3a3d 205b 4150 504c 4943 4154 494f 4e20  := [APPLICATION 
│ │ │ │ -00047ff0: 7461 676e 756d 5d20 5345 5155 454e 4345  tagnum] SEQUENCE
│ │ │ │ -00048000: 207b 0a09 7076 6e6f 0909 5b31 5d20 494e   {..pvno..[1] IN
│ │ │ │ -00048010: 5445 4745 5220 2835 2920 2d2d 2066 6972  TEGER (5) -- fir
│ │ │ │ -00048020: 7374 2074 6167 2069 7320 5b31 5d2c 206e  st tag is [1], n
│ │ │ │ -00048030: 6f74 205b 305d 202d 2d2c 0a09 6d73 672d  ot [0] --,..msg-
│ │ │ │ -00048040: 7479 7065 095b 325d 2049 4e54 4547 4552  type.[2] INTEGER
│ │ │ │ -00048050: 2028 7461 676e 756d 292c 0a09 7061 6461   (tagnum),..pada
│ │ │ │ -00048060: 7461 0909 5b33 5d20 5345 5155 454e 4345  ta..[3] SEQUENCE
│ │ │ │ -00048070: 204f 4620 5041 2d44 4154 4120 4f50 5449   OF PA-DATA OPTI
│ │ │ │ -00048080: 4f4e 414c 2c0a 0972 6571 2d62 6f64 7909  ONAL,..req-body.
│ │ │ │ -00048090: 5b34 5d20 4b44 432d 5245 512d 424f 4459  [4] KDC-REQ-BODY
│ │ │ │ -000480a0: 0a7d 0a0a 4b44 432d 5245 512d 424f 4459  .}..KDC-REQ-BODY
│ │ │ │ -000480b0: 093a 3a3d 2053 4551 5545 4e43 4520 7b0a  .::= SEQUENCE {.
│ │ │ │ -000480c0: 096b 6463 2d6f 7074 696f 6e73 0909 5b30  .kdc-options..[0
│ │ │ │ -000480d0: 5d20 4b44 434f 7074 696f 6e73 2c0a 0963  ] KDCOptions,..c
│ │ │ │ -000480e0: 6e61 6d65 0909 095b 315d 2050 7269 6e63  name...[1] Princ
│ │ │ │ -000480f0: 6970 616c 4e61 6d65 204f 5054 494f 4e41  ipalName OPTIONA
│ │ │ │ -00048100: 4c0a 0909 0909 2020 2020 2d2d 2055 7365  L.....    -- Use
│ │ │ │ -00048110: 6420 6f6e 6c79 2069 6e20 4153 2d52 4551  d only in AS-REQ
│ │ │ │ -00048120: 202d 2d2c 0a09 7265 616c 6d09 0909 5b32   --,..realm...[2
│ │ │ │ -00048130: 5d20 5265 616c 6d0a 0909 0909 2020 2020  ] Realm.....    
│ │ │ │ -00048140: 2d2d 2053 6572 7665 7227 7320 7265 616c  -- Server's real
│ │ │ │ -00048150: 6d0a 0909 0909 2020 2020 2d2d 2041 6c73  m.....    -- Als
│ │ │ │ -00048160: 6f20 636c 6965 6e74 2773 2069 6e20 4153  o client's in AS
│ │ │ │ -00048170: 2d52 4551 202d 2d2c 0a09 736e 616d 6509  -REQ --,..sname.
│ │ │ │ -00048180: 0909 5b33 5d20 5072 696e 6369 7061 6c4e  ..[3] PrincipalN
│ │ │ │ -00048190: 616d 6520 4f50 5449 4f4e 414c 2c0a 0966  ame OPTIONAL,..f
│ │ │ │ -000481a0: 726f 6d09 0909 5b34 5d20 4b65 7262 6572  rom...[4] Kerber
│ │ │ │ -000481b0: 6f73 5469 6d65 204f 5054 494f 4e41 4c2c  osTime OPTIONAL,
│ │ │ │ -000481c0: 0a09 7469 6c6c 0909 095b 355d 204b 6572  ..till...[5] Ker
│ │ │ │ -000481d0: 6265 726f 7354 696d 652c 0a09 7274 696d  berosTime,..rtim
│ │ │ │ -000481e0: 6509 0909 5b36 5d20 4b65 7262 6572 6f73  e...[6] Kerberos
│ │ │ │ -000481f0: 5469 6d65 204f 5054 494f 4e41 4c2c 0a09  Time OPTIONAL,..
│ │ │ │ -00048200: 6e6f 6e63 6509 0909 5b37 5d20 5549 6e74  nonce...[7] UInt
│ │ │ │ -00048210: 3332 2c0a 0965 7479 7065 0909 095b 385d  32,..etype...[8]
│ │ │ │ -00048220: 2053 4551 5545 4e43 4520 4f46 2049 6e74   SEQUENCE OF Int
│ │ │ │ -00048230: 3332 202d 2d20 456e 6372 7970 7469 6f6e  32 -- Encryption
│ │ │ │ -00048240: 5479 7065 0a09 0909 0920 2020 202d 2d20  Type.....    -- 
│ │ │ │ -00048250: 696e 2070 7265 6665 7265 6e63 6520 6f72  in preference or
│ │ │ │ -00048260: 6465 7220 2d2d 2c0a 0961 6464 7265 7373  der --,..address
│ │ │ │ -00048270: 6573 0909 5b39 5d20 486f 7374 4164 6472  es..[9] HostAddr
│ │ │ │ -00048280: 6573 7365 7320 4f50 5449 4f4e 414c 2c0a  esses OPTIONAL,.
│ │ │ │ -00048290: 0965 6e63 2d61 7574 686f 7269 7a61 7469  .enc-authorizati
│ │ │ │ -000482a0: 6f6e 2d64 6174 6109 5b31 305d 2045 6e63  on-data.[10] Enc
│ │ │ │ -000482b0: 7279 7074 6564 4461 7461 207b 0a09 0909  ryptedData {....
│ │ │ │ -000482c0: 0909 4175 7468 6f72 697a 6174 696f 6e44  ..AuthorizationD
│ │ │ │ -000482d0: 6174 612c 0a09 0909 0909 7b20 6b65 7975  ata,......{ keyu
│ │ │ │ -000482e0: 7365 2d54 4753 5265 7141 7574 6844 6174  se-TGSReqAuthDat
│ │ │ │ -000482f0: 612d 7365 7373 6b65 790a 0909 0909 0920  a-sesskey...... 
│ │ │ │ -00048300: 207c 206b 6579 7573 652d 5447 5352 6571   | keyuse-TGSReq
│ │ │ │ -00048310: 4175 7468 4461 7461 2d73 7562 6b65 7920  AuthData-subkey 
│ │ │ │ -00048320: 7d0a 0909 0909 2020 2020 207d 204f 5054  }.....     } OPT
│ │ │ │ -00048330: 494f 4e41 4c2c 0a09 6164 6469 7469 6f6e  IONAL,..addition
│ │ │ │ -00048340: 616c 2d74 6963 6b65 7473 095b 3131 5d20  al-tickets.[11] 
│ │ │ │ -00048350: 5345 5155 454e 4345 204f 4620 5469 636b  SEQUENCE OF Tick
│ │ │ │ -00048360: 6574 204f 5054 494f 4e41 4c0a 7d0a 0a2d  et OPTIONAL.}..-
│ │ │ │ -00048370: 2d20 5265 706c 7920 2d2d 0a0a 4153 2d52  - Reply --..AS-R
│ │ │ │ -00048380: 4550 0909 3a3a 3d20 4b44 432d 5245 5020  EP..::= KDC-REP 
│ │ │ │ -00048390: 7b31 312c 2045 6e63 4153 5265 7050 6172  {11, EncASRepPar
│ │ │ │ -000483a0: 742c 207b 6b65 7975 7365 2d45 6e63 4153  t, {keyuse-EncAS
│ │ │ │ -000483b0: 5265 7050 6172 747d 7d0a 0a4b 4443 2d52  RepPart}}..KDC-R
│ │ │ │ -000483c0: 4550 207b 494e 5445 4745 523a 7461 676e  EP {INTEGER:tagn
│ │ │ │ -000483d0: 756d 2c0a 0920 5479 7065 546f 456e 6372  um,.. TypeToEncr
│ │ │ │ -000483e0: 7970 742c 0a09 2055 496e 7433 323a 4b65  ypt,.. UInt32:Ke
│ │ │ │ -000483f0: 7955 7361 6765 737d 093a 3a3d 205b 4150  yUsages}.::= [AP
│ │ │ │ -00048400: 504c 4943 4154 494f 4e20 7461 676e 756d  PLICATION tagnum
│ │ │ │ -00048410: 5d20 5345 5155 454e 4345 207b 0a09 7076  ] SEQUENCE {..pv
│ │ │ │ -00048420: 6e6f 0909 5b30 5d20 494e 5445 4745 5220  no..[0] INTEGER 
│ │ │ │ -00048430: 2835 292c 0a09 6d73 672d 7479 7065 095b  (5),..msg-type.[
│ │ │ │ -00048440: 315d 2049 4e54 4547 4552 2028 7461 676e  1] INTEGER (tagn
│ │ │ │ -00048450: 756d 292c 0a09 7061 6461 7461 0909 5b32  um),..padata..[2
│ │ │ │ -00048460: 5d20 5345 5155 454e 4345 204f 4620 5041  ] SEQUENCE OF PA
│ │ │ │ -00048470: 2d44 4154 4120 4f50 5449 4f4e 414c 2c0a  -DATA OPTIONAL,.
│ │ │ │ -00048480: 0963 7265 616c 6d09 095b 335d 2052 6561  .crealm..[3] Rea
│ │ │ │ -00048490: 6c6d 2c0a 0963 6e61 6d65 0909 5b34 5d20  lm,..cname..[4] 
│ │ │ │ -000484a0: 5072 696e 6369 7061 6c4e 616d 652c 0a09  PrincipalName,..
│ │ │ │ -000484b0: 7469 636b 6574 0909 5b35 5d20 5469 636b  ticket..[5] Tick
│ │ │ │ -000484c0: 6574 2c0a 0965 6e63 2d70 6172 7409 5b36  et,..enc-part.[6
│ │ │ │ -000484d0: 5d20 456e 6372 7970 7465 6444 6174 6120  ] EncryptedData 
│ │ │ │ -000484e0: 7b54 7970 6554 6f45 6e63 7279 7074 2c20  {TypeToEncrypt, 
│ │ │ │ -000484f0: 4b65 7955 7361 6765 737d 0a7d 0a0a 456e  KeyUsages}.}..En
│ │ │ │ -00048500: 6341 5352 6570 5061 7274 093a 3a3d 205b  cASRepPart.::= [
│ │ │ │ -00048510: 4150 504c 4943 4154 494f 4e20 3235 5d20  APPLICATION 25] 
│ │ │ │ -00048520: 456e 634b 4443 5265 7050 6172 740a 0a45  EncKDCRepPart..E
│ │ │ │ -00048530: 6e63 4b44 4352 6570 5061 7274 093a 3a3d  ncKDCRepPart.::=
│ │ │ │ -00048540: 2053 4551 5545 4e43 4520 7b0a 096b 6579   SEQUENCE {..key
│ │ │ │ -00048550: 0909 5b30 5d20 456e 6372 7970 7469 6f6e  ..[0] Encryption
│ │ │ │ -00048560: 4b65 792c 0a09 6c61 7374 2d72 6571 095b  Key,..last-req.[
│ │ │ │ -00048570: 315d 204c 6173 7452 6571 2c0a 096e 6f6e  1] LastReq,..non
│ │ │ │ -00048580: 6365 0909 5b32 5d20 5549 6e74 3332 2c0a  ce..[2] UInt32,.
│ │ │ │ -00048590: 096b 6579 2d65 7870 6972 6174 696f 6e09  .key-expiration.
│ │ │ │ -000485a0: 5b33 5d20 4b65 7262 6572 6f73 5469 6d65  [3] KerberosTime
│ │ │ │ -000485b0: 204f 5054 494f 4e41 4c2c 0a09 666c 6167   OPTIONAL,..flag
│ │ │ │ -000485c0: 7309 095b 345d 2054 6963 6b65 7446 6c61  s..[4] TicketFla
│ │ │ │ -000485d0: 6773 2c0a 0961 7574 6874 696d 6509 5b35  gs,..authtime.[5
│ │ │ │ -000485e0: 5d20 4b65 7262 6572 6f73 5469 6d65 2c0a  ] KerberosTime,.
│ │ │ │ -000485f0: 0973 7461 7274 7469 6d65 095b 365d 204b  .starttime.[6] K
│ │ │ │ -00048600: 6572 6265 726f 7354 696d 6520 4f50 5449  erberosTime OPTI
│ │ │ │ -00048610: 4f4e 414c 2c0a 0965 6e64 7469 6d65 0909  ONAL,..endtime..
│ │ │ │ -00048620: 5b37 5d20 4b65 7262 6572 6f73 5469 6d65  [7] KerberosTime
│ │ │ │ -00048630: 2c0a 0972 656e 6577 2d74 696c 6c09 5b38  ,..renew-till.[8
│ │ │ │ -00048640: 5d20 4b65 7262 6572 6f73 5469 6d65 204f  ] KerberosTime O
│ │ │ │ -00048650: 5054 494f 4e41 4c2c 0a09 7372 6561 6c6d  PTIONAL,..srealm
│ │ │ │ -00048660: 0909 5b39 5d20 5265 616c 6d2c 0a09 736e  ..[9] Realm,..sn
│ │ │ │ -00048670: 616d 6509 095b 3130 5d20 5072 696e 6369  ame..[10] Princi
│ │ │ │ -00048680: 7061 6c4e 616d 652c 0a09 6361 6464 7209  palName,..caddr.
│ │ │ │ -00048690: 095b 3131 5d20 486f 7374 4164 6472 6573  .[11] HostAddres
│ │ │ │ -000486a0: 7365 7320 4f50 5449 4f4e 414c 0a7d 0a0a  ses OPTIONAL.}..
│ │ │ │ -000486b0: 7368 6973 6869 5f61 730a 2d2d 2d2d 2d2d  shishi_as.------
│ │ │ │ -000486c0: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ -000486d0: 6e3a 2069 6e74 2073 6869 7368 695f 6173  n: int shishi_as
│ │ │ │ -000486e0: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ -000486f0: 452c 2053 6869 7368 695f 6173 202a 2a20  E, Shishi_as ** 
│ │ │ │ -00048700: 4153 290a 2020 2020 2048 414e 444c 453a  AS).     HANDLE:
│ │ │ │ -00048710: 2073 6869 7368 6920 6861 6e64 6c65 2061   shishi handle a
│ │ │ │ -00048720: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ -00048730: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ -00048740: 8099 2e0a 2020 2020 2041 533a 2068 6f6c  ....     AS: hol
│ │ │ │ -00048750: 6473 2070 6f69 6e74 6572 2074 6f20 6e65  ds pointer to ne
│ │ │ │ -00048760: 776c 7920 616c 6c6f 6361 7465 2053 6869  wly allocate Shi
│ │ │ │ -00048770: 7368 695f 6173 2073 7472 7563 7475 7265  shi_as structure
│ │ │ │ -00048780: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ -00048790: 7469 6f6e 3a2a 2041 6c6c 6f63 6174 6520  tion:* Allocate 
│ │ │ │ -000487a0: 6120 6e65 7720 4153 2065 7863 6861 6e67  a new AS exchang
│ │ │ │ -000487b0: 6520 7661 7269 6162 6c65 2e0a 0a20 2020  e variable...   
│ │ │ │ -000487c0: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ -000487d0: 2a20 5265 7475 726e 7320 5348 4953 4849  * Returns SHISHI
│ │ │ │ -000487e0: 5f4f 4b20 6966 6620 7375 6363 6573 7366  _OK iff successf
│ │ │ │ -000487f0: 756c 2e0a 0a73 6869 7368 695f 6173 5f64  ul...shishi_as_d
│ │ │ │ -00048800: 6f6e 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  one.------------
│ │ │ │ -00048810: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ -00048820: 3a20 766f 6964 2073 6869 7368 695f 6173  : void shishi_as
│ │ │ │ -00048830: 5f64 6f6e 6520 2853 6869 7368 695f 6173  _done (Shishi_as
│ │ │ │ -00048840: 202a 2041 5329 0a20 2020 2020 4153 3a20   * AS).     AS: 
│ │ │ │ -00048850: 7374 7275 6374 7572 6520 7468 6174 2068  structure that h
│ │ │ │ -00048860: 6f6c 6473 2069 6e66 6f72 6d61 7469 6f6e  olds information
│ │ │ │ -00048870: 2061 626f 7574 2041 5320 6578 6368 616e   about AS exchan
│ │ │ │ -00048880: 6765 0a0a 2020 2020 202a 4465 7363 7269  ge..     *Descri
│ │ │ │ -00048890: 7074 696f 6e3a 2a20 4465 616c 6c6f 6361  ption:* Dealloca
│ │ │ │ -000488a0: 7465 2072 6573 6f75 7263 6573 2061 7373  te resources ass
│ │ │ │ -000488b0: 6f63 6961 7465 6420 7769 7468 2041 5320  ociated with AS 
│ │ │ │ -000488c0: 6578 6368 616e 6765 2e0a 2020 2020 2054  exchange..     T
│ │ │ │ -000488d0: 6869 7320 7368 6f75 6c64 2062 6520 6361  his should be ca
│ │ │ │ -000488e0: 6c6c 6564 2062 7920 7468 6520 6170 706c  lled by the appl
│ │ │ │ -000488f0: 6963 6174 696f 6e20 7768 656e 2069 7420  ication when it 
│ │ │ │ -00048900: 6e6f 206c 6f6e 6765 7220 6e65 6564 2074  no longer need t
│ │ │ │ -00048910: 6f0a 2020 2020 2075 7469 6c69 7a65 2074  o.     utilize t
│ │ │ │ -00048920: 6865 2041 5320 6578 6368 616e 6765 2068  he AS exchange h
│ │ │ │ -00048930: 616e 646c 652e 0a0a 7368 6973 6869 5f61  andle...shishi_a
│ │ │ │ -00048940: 735f 7265 710a 2d2d 2d2d 2d2d 2d2d 2d2d  s_req.----------
│ │ │ │ -00048950: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ -00048960: 6e3a 2053 6869 7368 695f 6173 6e31 2073  n: Shishi_asn1 s
│ │ │ │ -00048970: 6869 7368 695f 6173 5f72 6571 2028 5368  hishi_as_req (Sh
│ │ │ │ -00048980: 6973 6869 5f61 7320 2a20 4153 290a 2020  ishi_as * AS).  
│ │ │ │ -00048990: 2020 2041 533a 2073 7472 7563 7475 7265     AS: structure
│ │ │ │ -000489a0: 2074 6861 7420 686f 6c64 7320 696e 666f   that holds info
│ │ │ │ -000489b0: 726d 6174 696f 6e20 6162 6f75 7420 4153  rmation about AS
│ │ │ │ -000489c0: 2065 7863 6861 6e67 650a 0a20 2020 2020   exchange..     
│ │ │ │ -000489d0: 2a44 6573 6372 6970 7469 6f6e 3a2a 2047  *Description:* G
│ │ │ │ -000489e0: 6574 2041 534e 2e31 2041 532d 5245 5120  et ASN.1 AS-REQ 
│ │ │ │ -000489f0: 7374 7275 6374 7572 6520 6672 6f6d 2041  structure from A
│ │ │ │ -00048a00: 5320 6578 6368 616e 6765 2e0a 0a20 2020  S exchange...   
│ │ │ │ -00048a10: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ -00048a20: 2a20 5265 7475 726e 7320 7468 6520 6765  * Returns the ge
│ │ │ │ -00048a30: 6e65 7261 7465 6420 4153 2d52 4551 2070  nerated AS-REQ p
│ │ │ │ -00048a40: 6163 6b65 7420 6672 6f6d 2074 6865 2041  acket from the A
│ │ │ │ -00048a50: 530a 2020 2020 2065 7863 6861 6e67 652c  S.     exchange,
│ │ │ │ -00048a60: 206f 7220 4e55 4c4c 2069 6620 6e6f 7420   or NULL if not 
│ │ │ │ -00048a70: 7965 7420 7365 7420 6f72 2061 6e20 6572  yet set or an er
│ │ │ │ -00048a80: 726f 7220 6f63 6375 7265 642e 0a0a 7368  ror occured...sh
│ │ │ │ -00048a90: 6973 6869 5f61 735f 7265 715f 6275 696c  ishi_as_req_buil
│ │ │ │ -00048aa0: 640a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  d.--------------
│ │ │ │ -00048ab0: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ -00048ac0: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ -00048ad0: 6173 5f72 6571 5f62 7569 6c64 2028 5368  as_req_build (Sh
│ │ │ │ -00048ae0: 6973 6869 5f61 7320 2a20 4153 290a 2020  ishi_as * AS).  
│ │ │ │ -00048af0: 2020 2041 533a 2073 7472 7563 7475 7265     AS: structure
│ │ │ │ -00048b00: 2074 6861 7420 686f 6c64 7320 696e 666f   that holds info
│ │ │ │ -00048b10: 726d 6174 696f 6e20 6162 6f75 7420 4153  rmation about AS
│ │ │ │ -00048b20: 2065 7863 6861 6e67 650a 0a20 2020 2020   exchange..     
│ │ │ │ -00048b30: 2a44 6573 6372 6970 7469 6f6e 3a2a 2050  *Description:* P
│ │ │ │ -00048b40: 6f73 7369 626c 7920 7265 6d6f 7665 2075  ossibly remove u
│ │ │ │ -00048b50: 6e73 6574 2066 6965 6c64 7320 2865 2e67  nset fields (e.g
│ │ │ │ -00048b60: 2e2c 2072 7469 6d65 292e 0a0a 2020 2020  ., rtime)...    
│ │ │ │ -00048b70: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ -00048b80: 2052 6574 7572 6e73 2053 4849 5348 495f   Returns SHISHI_
│ │ │ │ -00048b90: 4f4b 2069 6666 2073 7563 6365 7373 6675  OK iff successfu
│ │ │ │ -00048ba0: 6c2e 0a0a 7368 6973 6869 5f61 735f 7265  l...shishi_as_re
│ │ │ │ -00048bb0: 715f 7365 740a 2d2d 2d2d 2d2d 2d2d 2d2d  q_set.----------
│ │ │ │ -00048bc0: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ -00048bd0: 6374 696f 6e3a 2076 6f69 6420 7368 6973  ction: void shis
│ │ │ │ -00048be0: 6869 5f61 735f 7265 715f 7365 7420 2853  hi_as_req_set (S
│ │ │ │ -00048bf0: 6869 7368 695f 6173 202a 2041 532c 2053  hishi_as * AS, S
│ │ │ │ -00048c00: 6869 7368 695f 6173 6e31 2041 5352 4551  hishi_asn1 ASREQ
│ │ │ │ -00048c10: 290a 2020 2020 2041 533a 2073 7472 7563  ).     AS: struc
│ │ │ │ -00048c20: 7475 7265 2074 6861 7420 686f 6c64 7320  ture that holds 
│ │ │ │ -00048c30: 696e 666f 726d 6174 696f 6e20 6162 6f75  information abou
│ │ │ │ -00048c40: 7420 4153 2065 7863 6861 6e67 650a 2020  t AS exchange.  
│ │ │ │ -00048c50: 2020 2041 5352 4551 3a20 6173 7265 7120     ASREQ: asreq 
│ │ │ │ -00048c60: 746f 2073 746f 7265 2069 6e20 4153 2e0a  to store in AS..
│ │ │ │ -00048c70: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -00048c80: 6f6e 3a2a 2053 6574 2074 6865 2041 532d  on:* Set the AS-
│ │ │ │ -00048c90: 5245 5120 696e 2074 6865 2041 5320 6578  REQ in the AS ex
│ │ │ │ -00048ca0: 6368 616e 6765 2e0a 0a73 6869 7368 695f  change...shishi_
│ │ │ │ -00048cb0: 6173 5f72 6571 5f64 6572 0a2d 2d2d 2d2d  as_req_der.-----
│ │ │ │ -00048cc0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ -00048cd0: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ -00048ce0: 7368 6973 6869 5f61 735f 7265 715f 6465  shishi_as_req_de
│ │ │ │ -00048cf0: 7220 2853 6869 7368 695f 6173 202a 2041  r (Shishi_as * A
│ │ │ │ -00048d00: 532c 2063 6861 7220 2a2a 204f 5554 2c0a  S, char ** OUT,.
│ │ │ │ -00048d10: 2020 2020 2020 2020 2020 7369 7a65 5f74            size_t
│ │ │ │ -00048d20: 202a 204f 5554 4c45 4e29 0a20 2020 2020   * OUTLEN).     
│ │ │ │ -00048d30: 4153 3a20 7374 7275 6374 7572 6520 7468  AS: structure th
│ │ │ │ -00048d40: 6174 2068 6f6c 6473 2069 6e66 6f72 6d61  at holds informa
│ │ │ │ -00048d50: 7469 6f6e 2061 626f 7574 2041 5320 6578  tion about AS ex
│ │ │ │ -00048d60: 6368 616e 6765 0a20 2020 2020 4f55 543a  change.     OUT:
│ │ │ │ -00048d70: 206f 7574 7075 7420 6172 7261 7920 7769   output array wi
│ │ │ │ -00048d80: 7468 206e 6577 6c79 2061 6c6c 6f63 6174  th newly allocat
│ │ │ │ -00048d90: 6564 2044 4552 2065 6e63 6f64 696e 6720  ed DER encoding 
│ │ │ │ -00048da0: 6f66 2041 532d 5245 512e 0a20 2020 2020  of AS-REQ..     
│ │ │ │ -00048db0: 4f55 544c 454e 3a20 6c65 6e67 7468 206f  OUTLEN: length o
│ │ │ │ -00048dc0: 6620 6f75 7470 7574 2061 7272 6179 2077  f output array w
│ │ │ │ -00048dd0: 6974 6820 4445 5220 656e 636f 6469 6e67  ith DER encoding
│ │ │ │ -00048de0: 206f 6620 4153 2d52 4551 2e0a 0a20 2020   of AS-REQ...   
│ │ │ │ -00048df0: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ -00048e00: 2044 4552 2065 6e63 6f64 6520 4153 2d52   DER encode AS-R
│ │ │ │ -00048e10: 4551 2e20 4f55 5420 6973 2061 6c6c 6f63  EQ. OUT is alloc
│ │ │ │ -00048e20: 6174 6564 2062 7920 7468 6973 0a20 2020  ated by this.   
│ │ │ │ -00048e30: 2020 6675 6e63 7469 6f6e 2c20 616e 6420    function, and 
│ │ │ │ -00048e40: 6974 2069 7320 7468 6520 7265 7370 6f6e  it is the respon
│ │ │ │ -00048e50: 7369 6269 6c69 7479 206f 6620 6361 6c6c  sibility of call
│ │ │ │ -00048e60: 6572 2074 6f20 6465 616c 6c6f 6361 7465  er to deallocate
│ │ │ │ -00048e70: 2069 742e 0a0a 2020 2020 202a 5265 7475   it...     *Retu
│ │ │ │ -00048e80: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ -00048e90: 6e73 2053 4849 5348 495f 4f4b 2069 6666  ns SHISHI_OK iff
│ │ │ │ -00048ea0: 2073 7563 6365 7373 6675 6c2e 0a0a 7368   successful...sh
│ │ │ │ -00048eb0: 6973 6869 5f61 735f 7265 715f 6465 725f  ishi_as_req_der_
│ │ │ │ -00048ec0: 7365 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  set.------------
│ │ │ │ -00048ed0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ -00048ee0: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ -00048ef0: 7368 695f 6173 5f72 6571 5f64 6572 5f73  shi_as_req_der_s
│ │ │ │ -00048f00: 6574 2028 5368 6973 6869 5f61 7320 2a20  et (Shishi_as * 
│ │ │ │ -00048f10: 4153 2c20 6368 6172 202a 2044 4552 2c0a  AS, char * DER,.
│ │ │ │ -00048f20: 2020 2020 2020 2020 2020 7369 7a65 5f74            size_t
│ │ │ │ -00048f30: 2044 4552 4c45 4e29 0a20 2020 2020 4153   DERLEN).     AS
│ │ │ │ -00048f40: 3a20 7374 7275 6374 7572 6520 7468 6174  : structure that
│ │ │ │ -00048f50: 2068 6f6c 6473 2069 6e66 6f72 6d61 7469   holds informati
│ │ │ │ -00048f60: 6f6e 2061 626f 7574 2041 5320 6578 6368  on about AS exch
│ │ │ │ -00048f70: 616e 6765 0a20 2020 2020 4445 523a 2069  ange.     DER: i
│ │ │ │ -00048f80: 6e70 7574 2061 7272 6179 2077 6974 6820  nput array with 
│ │ │ │ -00048f90: 4445 5220 656e 636f 6465 6420 4150 2d52  DER encoded AP-R
│ │ │ │ -00048fa0: 4551 2e0a 2020 2020 2044 4552 4c45 4e3a  EQ..     DERLEN:
│ │ │ │ -00048fb0: 206c 656e 6774 6820 6f66 2069 6e70 7574   length of input
│ │ │ │ -00048fc0: 2061 7272 6179 2077 6974 6820 4445 5220   array with DER 
│ │ │ │ -00048fd0: 656e 636f 6465 6420 4150 2d52 4551 2e0a  encoded AP-REQ..
│ │ │ │ -00048fe0: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -00048ff0: 6f6e 3a2a 2044 4552 2064 6563 6f64 6520  on:* DER decode 
│ │ │ │ -00049000: 4153 2d52 4551 2061 6e64 2073 6574 2069  AS-REQ and set i
│ │ │ │ -00049010: 7420 4153 2065 7863 6861 6e67 652e 2020  t AS exchange.  
│ │ │ │ -00049020: 4966 0a20 2020 2020 6465 636f 6469 6e67  If.     decoding
│ │ │ │ -00049030: 2066 6169 6c73 2c20 7468 6520 4153 2d52   fails, the AS-R
│ │ │ │ -00049040: 4551 2069 6e20 7468 6520 4153 2065 7863  EQ in the AS exc
│ │ │ │ -00049050: 6861 6e67 6520 7265 6d61 696e 732e 0a0a  hange remains...
│ │ │ │ -00049060: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ -00049070: 7565 3a2a 2052 6574 7572 6e73 2053 4849  ue:* Returns SHI
│ │ │ │ -00049080: 5348 495f 4f4b 2e0a 0a73 6869 7368 695f  SHI_OK...shishi_
│ │ │ │ -00049090: 6173 5f72 6570 0a2d 2d2d 2d2d 2d2d 2d2d  as_rep.---------
│ │ │ │ -000490a0: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -000490b0: 6f6e 3a20 5368 6973 6869 5f61 736e 3120  on: Shishi_asn1 
│ │ │ │ -000490c0: 7368 6973 6869 5f61 735f 7265 7020 2853  shishi_as_rep (S
│ │ │ │ -000490d0: 6869 7368 695f 6173 202a 2041 5329 0a20  hishi_as * AS). 
│ │ │ │ -000490e0: 2020 2020 4153 3a20 7374 7275 6374 7572      AS: structur
│ │ │ │ -000490f0: 6520 7468 6174 2068 6f6c 6473 2069 6e66  e that holds inf
│ │ │ │ -00049100: 6f72 6d61 7469 6f6e 2061 626f 7574 2041  ormation about A
│ │ │ │ -00049110: 5320 6578 6368 616e 6765 0a0a 2020 2020  S exchange..    
│ │ │ │ -00049120: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ -00049130: 4765 7420 4153 4e2e 3120 4153 2d52 4550  Get ASN.1 AS-REP
│ │ │ │ -00049140: 2073 7472 7563 7475 7265 2066 726f 6d20   structure from 
│ │ │ │ -00049150: 4153 2065 7863 6861 6e67 652e 0a0a 2020  AS exchange...  
│ │ │ │ -00049160: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ -00049170: 3a2a 2052 6574 7572 6e73 2074 6865 2072  :* Returns the r
│ │ │ │ -00049180: 6563 6569 7665 6420 4153 2d52 4550 2070  eceived AS-REP p
│ │ │ │ -00049190: 6163 6b65 7420 6672 6f6d 2074 6865 2041  acket from the A
│ │ │ │ -000491a0: 530a 2020 2020 2065 7863 6861 6e67 652c  S.     exchange,
│ │ │ │ -000491b0: 206f 7220 4e55 4c4c 2069 6620 6e6f 7420   or NULL if not 
│ │ │ │ -000491c0: 7965 7420 7365 7420 6f72 2061 6e20 6572  yet set or an er
│ │ │ │ -000491d0: 726f 7220 6f63 6375 7265 642e 0a0a 7368  ror occured...sh
│ │ │ │ -000491e0: 6973 6869 5f61 735f 7265 705f 7072 6f63  ishi_as_rep_proc
│ │ │ │ -000491f0: 6573 730a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ess.------------
│ │ │ │ -00049200: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ -00049210: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ -00049220: 7368 695f 6173 5f72 6570 5f70 726f 6365  shi_as_rep_proce
│ │ │ │ -00049230: 7373 2028 5368 6973 6869 5f61 7320 2a20  ss (Shishi_as * 
│ │ │ │ -00049240: 4153 2c0a 2020 2020 2020 2020 2020 5368  AS,.          Sh
│ │ │ │ -00049250: 6973 6869 5f6b 6579 202a 204b 4559 2c20  ishi_key * KEY, 
│ │ │ │ -00049260: 636f 6e73 7420 6368 6172 202a 2050 4153  const char * PAS
│ │ │ │ -00049270: 5357 4f52 4429 0a20 2020 2020 4153 3a20  SWORD).     AS: 
│ │ │ │ -00049280: 7374 7275 6374 7572 6520 7468 6174 2068  structure that h
│ │ │ │ -00049290: 6f6c 6473 2069 6e66 6f72 6d61 7469 6f6e  olds information
│ │ │ │ -000492a0: 2061 626f 7574 2041 5320 6578 6368 616e   about AS exchan
│ │ │ │ -000492b0: 6765 0a20 2020 2020 4b45 593a 2075 7365  ge.     KEY: use
│ │ │ │ -000492c0: 7227 7320 6b65 792c 2075 7365 6420 746f  r's key, used to
│ │ │ │ -000492d0: 2065 6e63 7279 7074 2074 6865 2065 6e63   encrypt the enc
│ │ │ │ -000492e0: 7279 7074 6564 2070 6172 7420 6f66 2074  rypted part of t
│ │ │ │ -000492f0: 6865 2041 532d 5245 502e 0a20 2020 2020  he AS-REP..     
│ │ │ │ -00049300: 5041 5353 574f 5244 3a20 7573 6572 2773  PASSWORD: user's
│ │ │ │ -00049310: 2070 6173 7377 6f72 642c 2075 7365 6420   password, used 
│ │ │ │ -00049320: 6966 206b 6579 2069 7320 4e55 4c4c 2e0a  if key is NULL..
│ │ │ │ -00049330: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -00049340: 6f6e 3a2a 2050 726f 6365 7373 206e 6577  on:* Process new
│ │ │ │ -00049350: 2041 532d 5245 5020 616e 6420 7365 7420   AS-REP and set 
│ │ │ │ -00049360: 7469 636b 6574 2e20 2054 6865 206b 6579  ticket.  The key
│ │ │ │ -00049370: 2069 7320 7573 6564 0a20 2020 2020 746f   is used.     to
│ │ │ │ -00049380: 2064 6563 7279 7074 2074 6865 2041 502d   decrypt the AP-
│ │ │ │ -00049390: 5245 502e 2049 6620 626f 7468 206b 6579  REP. If both key
│ │ │ │ -000493a0: 2061 6e64 2070 6173 7377 6f72 6420 6973   and password is
│ │ │ │ -000493b0: 204e 554c 4c2c 2074 6865 2075 7365 720a   NULL, the user.
│ │ │ │ -000493c0: 2020 2020 2069 7320 7175 6572 6965 6420       is queried 
│ │ │ │ -000493d0: 666f 7220 6974 2e0a 0a20 2020 2020 2a52  for it...     *R
│ │ │ │ -000493e0: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ -000493f0: 7475 726e 7320 5348 4953 4849 5f4f 4b20  turns SHISHI_OK 
│ │ │ │ -00049400: 6966 6620 7375 6363 6573 7366 756c 2e0a  iff successful..
│ │ │ │ -00049410: 0a73 6869 7368 695f 6173 5f72 6570 5f62  .shishi_as_rep_b
│ │ │ │ -00049420: 7569 6c64 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  uild.-----------
│ │ │ │ -00049430: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -00049440: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ -00049450: 6869 5f61 735f 7265 705f 6275 696c 6420  hi_as_rep_build 
│ │ │ │ -00049460: 2853 6869 7368 695f 6173 202a 2041 532c  (Shishi_as * AS,
│ │ │ │ -00049470: 2053 6869 7368 695f 6b65 7920 2a20 4b45   Shishi_key * KE
│ │ │ │ -00049480: 5929 0a20 2020 2020 4153 3a20 7374 7275  Y).     AS: stru
│ │ │ │ -00049490: 6374 7572 6520 7468 6174 2068 6f6c 6473  cture that holds
│ │ │ │ -000494a0: 2069 6e66 6f72 6d61 7469 6f6e 2061 626f   information abo
│ │ │ │ -000494b0: 7574 2041 5320 6578 6368 616e 6765 0a20  ut AS exchange. 
│ │ │ │ -000494c0: 2020 2020 4b45 593a 2075 7365 7227 7320      KEY: user's 
│ │ │ │ -000494d0: 6b65 792c 2075 7365 6420 746f 2065 6e63  key, used to enc
│ │ │ │ -000494e0: 7279 7074 2074 6865 2065 6e63 7279 7074  rypt the encrypt
│ │ │ │ -000494f0: 6564 2070 6172 7420 6f66 2074 6865 2041  ed part of the A
│ │ │ │ -00049500: 532d 5245 502e 0a0a 2020 2020 202a 4465  S-REP...     *De
│ │ │ │ -00049510: 7363 7269 7074 696f 6e3a 2a20 4275 696c  scription:* Buil
│ │ │ │ -00049520: 6420 4153 2d52 4550 2e0a 0a20 2020 2020  d AS-REP...     
│ │ │ │ -00049530: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ -00049540: 5265 7475 726e 7320 5348 4953 4849 5f4f  Returns SHISHI_O
│ │ │ │ -00049550: 4b20 6966 6620 7375 6363 6573 7366 756c  K iff successful
│ │ │ │ -00049560: 2e0a 0a73 6869 7368 695f 6173 5f72 6570  ...shishi_as_rep
│ │ │ │ -00049570: 5f64 6572 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  _der.-----------
│ │ │ │ -00049580: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ -00049590: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ -000495a0: 5f61 735f 7265 705f 6465 7220 2853 6869  _as_rep_der (Shi
│ │ │ │ -000495b0: 7368 695f 6173 202a 2041 532c 2063 6861  shi_as * AS, cha
│ │ │ │ -000495c0: 7220 2a2a 204f 5554 2c0a 2020 2020 2020  r ** OUT,.      
│ │ │ │ -000495d0: 2020 2020 7369 7a65 5f74 202a 204f 5554      size_t * OUT
│ │ │ │ -000495e0: 4c45 4e29 0a20 2020 2020 4153 3a20 7374  LEN).     AS: st
│ │ │ │ -000495f0: 7275 6374 7572 6520 7468 6174 2068 6f6c  ructure that hol
│ │ │ │ -00049600: 6473 2069 6e66 6f72 6d61 7469 6f6e 2061  ds information a
│ │ │ │ -00049610: 626f 7574 2041 5320 6578 6368 616e 6765  bout AS exchange
│ │ │ │ -00049620: 0a20 2020 2020 4f55 543a 206f 7574 7075  .     OUT: outpu
│ │ │ │ -00049630: 7420 6172 7261 7920 7769 7468 206e 6577  t array with new
│ │ │ │ -00049640: 6c79 2061 6c6c 6f63 6174 6564 2044 4552  ly allocated DER
│ │ │ │ -00049650: 2065 6e63 6f64 696e 6720 6f66 2041 532d   encoding of AS-
│ │ │ │ -00049660: 5245 502e 0a20 2020 2020 4f55 544c 454e  REP..     OUTLEN
│ │ │ │ -00049670: 3a20 6c65 6e67 7468 206f 6620 6f75 7470  : length of outp
│ │ │ │ -00049680: 7574 2061 7272 6179 2077 6974 6820 4445  ut array with DE
│ │ │ │ -00049690: 5220 656e 636f 6469 6e67 206f 6620 4153  R encoding of AS
│ │ │ │ -000496a0: 2d52 4550 2e0a 0a20 2020 2020 2a44 6573  -REP...     *Des
│ │ │ │ -000496b0: 6372 6970 7469 6f6e 3a2a 2044 4552 2065  cription:* DER e
│ │ │ │ -000496c0: 6e63 6f64 6520 4153 2d52 4550 2e20 4f55  ncode AS-REP. OU
│ │ │ │ -000496d0: 5420 6973 2061 6c6c 6f63 6174 6564 2062  T is allocated b
│ │ │ │ -000496e0: 7920 7468 6973 0a20 2020 2020 6675 6e63  y this.     func
│ │ │ │ -000496f0: 7469 6f6e 2c20 616e 6420 6974 2069 7320  tion, and it is 
│ │ │ │ -00049700: 7468 6520 7265 7370 6f6e 7369 6269 6c69  the responsibili
│ │ │ │ -00049710: 7479 206f 6620 6361 6c6c 6572 2074 6f20  ty of caller to 
│ │ │ │ -00049720: 6465 616c 6c6f 6361 7465 2069 742e 0a0a  deallocate it...
│ │ │ │ -00049730: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ -00049740: 7565 3a2a 2052 6574 7572 6e73 2053 4849  ue:* Returns SHI
│ │ │ │ -00049750: 5348 495f 4f4b 2069 6666 2073 7563 6365  SHI_OK iff succe
│ │ │ │ -00049760: 7373 6675 6c2e 0a0a 7368 6973 6869 5f61  ssful...shishi_a
│ │ │ │ -00049770: 735f 7265 705f 7365 740a 2d2d 2d2d 2d2d  s_rep_set.------
│ │ │ │ -00049780: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ -00049790: 2046 756e 6374 696f 6e3a 2076 6f69 6420   Function: void 
│ │ │ │ -000497a0: 7368 6973 6869 5f61 735f 7265 705f 7365  shishi_as_rep_se
│ │ │ │ -000497b0: 7420 2853 6869 7368 695f 6173 202a 2041  t (Shishi_as * A
│ │ │ │ -000497c0: 532c 2053 6869 7368 695f 6173 6e31 2041  S, Shishi_asn1 A
│ │ │ │ -000497d0: 5352 4550 290a 2020 2020 2041 533a 2073  SREP).     AS: s
│ │ │ │ -000497e0: 7472 7563 7475 7265 2074 6861 7420 686f  tructure that ho
│ │ │ │ -000497f0: 6c64 7320 696e 666f 726d 6174 696f 6e20  lds information 
│ │ │ │ -00049800: 6162 6f75 7420 4153 2065 7863 6861 6e67  about AS exchang
│ │ │ │ -00049810: 650a 2020 2020 2041 5352 4550 3a20 6173  e.     ASREP: as
│ │ │ │ -00049820: 7265 7020 746f 2073 746f 7265 2069 6e20  rep to store in 
│ │ │ │ -00049830: 4153 2e0a 0a20 2020 2020 2a44 6573 6372  AS...     *Descr
│ │ │ │ -00049840: 6970 7469 6f6e 3a2a 2053 6574 2074 6865  iption:* Set the
│ │ │ │ -00049850: 2041 532d 5245 5020 696e 2074 6865 2041   AS-REP in the A
│ │ │ │ -00049860: 5320 6578 6368 616e 6765 2e0a 0a73 6869  S exchange...shi
│ │ │ │ -00049870: 7368 695f 6173 5f72 6570 5f64 6572 5f73  shi_as_rep_der_s
│ │ │ │ -00049880: 6574 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  et.-------------
│ │ │ │ -00049890: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -000498a0: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ -000498b0: 6869 5f61 735f 7265 705f 6465 725f 7365  hi_as_rep_der_se
│ │ │ │ -000498c0: 7420 2853 6869 7368 695f 6173 202a 2041  t (Shishi_as * A
│ │ │ │ -000498d0: 532c 2063 6861 7220 2a20 4445 522c 0a20  S, char * DER,. 
│ │ │ │ -000498e0: 2020 2020 2020 2020 2073 697a 655f 7420           size_t 
│ │ │ │ -000498f0: 4445 524c 454e 290a 2020 2020 2041 533a  DERLEN).     AS:
│ │ │ │ -00049900: 2073 7472 7563 7475 7265 2074 6861 7420   structure that 
│ │ │ │ -00049910: 686f 6c64 7320 696e 666f 726d 6174 696f  holds informatio
│ │ │ │ -00049920: 6e20 6162 6f75 7420 4153 2065 7863 6861  n about AS excha
│ │ │ │ -00049930: 6e67 650a 2020 2020 2044 4552 3a20 696e  nge.     DER: in
│ │ │ │ -00049940: 7075 7420 6172 7261 7920 7769 7468 2044  put array with D
│ │ │ │ -00049950: 4552 2065 6e63 6f64 6564 2041 502d 5245  ER encoded AP-RE
│ │ │ │ -00049960: 502e 0a20 2020 2020 4445 524c 454e 3a20  P..     DERLEN: 
│ │ │ │ -00049970: 6c65 6e67 7468 206f 6620 696e 7075 7420  length of input 
│ │ │ │ -00049980: 6172 7261 7920 7769 7468 2044 4552 2065  array with DER e
│ │ │ │ -00049990: 6e63 6f64 6564 2041 502d 5245 502e 0a0a  ncoded AP-REP...
│ │ │ │ -000499a0: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ -000499b0: 6e3a 2a20 4445 5220 6465 636f 6465 2041  n:* DER decode A
│ │ │ │ -000499c0: 532d 5245 5020 616e 6420 7365 7420 6974  S-REP and set it
│ │ │ │ -000499d0: 2041 5320 6578 6368 616e 6765 2e20 2049   AS exchange.  I
│ │ │ │ -000499e0: 660a 2020 2020 2064 6563 6f64 696e 6720  f.     decoding 
│ │ │ │ -000499f0: 6661 696c 732c 2074 6865 2041 532d 5245  fails, the AS-RE
│ │ │ │ -00049a00: 5020 696e 2074 6865 2041 5320 6578 6368  P in the AS exch
│ │ │ │ -00049a10: 616e 6765 2072 656d 6169 6e73 2e0a 0a20  ange remains... 
│ │ │ │ -00049a20: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ -00049a30: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ -00049a40: 4849 5f4f 4b2e 0a0a 7368 6973 6869 5f61  HI_OK...shishi_a
│ │ │ │ -00049a50: 735f 6b72 6265 7272 6f72 0a2d 2d2d 2d2d  s_krberror.-----
│ │ │ │ -00049a60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -00049a70: 2d2d 2046 756e 6374 696f 6e3a 2053 6869  -- Function: Shi
│ │ │ │ -00049a80: 7368 695f 6173 6e31 2073 6869 7368 695f  shi_asn1 shishi_
│ │ │ │ -00049a90: 6173 5f6b 7262 6572 726f 7220 2853 6869  as_krberror (Shi
│ │ │ │ -00049aa0: 7368 695f 6173 202a 2041 5329 0a20 2020  shi_as * AS).   
│ │ │ │ -00049ab0: 2020 4153 3a20 7374 7275 6374 7572 6520    AS: structure 
│ │ │ │ -00049ac0: 7468 6174 2068 6f6c 6473 2069 6e66 6f72  that holds infor
│ │ │ │ -00049ad0: 6d61 7469 6f6e 2061 626f 7574 2041 5320  mation about AS 
│ │ │ │ -00049ae0: 6578 6368 616e 6765 0a0a 2020 2020 202a  exchange..     *
│ │ │ │ -00049af0: 4465 7363 7269 7074 696f 6e3a 2a20 4765  Description:* Ge
│ │ │ │ -00049b00: 7420 4153 4e2e 3120 4b52 422d 4552 524f  t ASN.1 KRB-ERRO
│ │ │ │ -00049b10: 5220 7374 7275 6374 7572 6520 6672 6f6d  R structure from
│ │ │ │ -00049b20: 2041 5320 6578 6368 616e 6765 2e0a 0a20   AS exchange... 
│ │ │ │ -00049b30: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ -00049b40: 653a 2a20 5265 7475 726e 7320 7468 6520  e:* Returns the 
│ │ │ │ -00049b50: 7265 6365 6976 6564 204b 5242 2d45 5252  received KRB-ERR
│ │ │ │ -00049b60: 4f52 2070 6163 6b65 7420 6672 6f6d 2074  OR packet from t
│ │ │ │ -00049b70: 6865 2041 530a 2020 2020 2065 7863 6861  he AS.     excha
│ │ │ │ -00049b80: 6e67 652c 206f 7220 4e55 4c4c 2069 6620  nge, or NULL if 
│ │ │ │ -00049b90: 6e6f 7420 7965 7420 7365 7420 6f72 2061  not yet set or a
│ │ │ │ -00049ba0: 6e20 6572 726f 7220 6f63 6375 7265 642e  n error occured.
│ │ │ │ -00049bb0: 0a0a 7368 6973 6869 5f61 735f 6b72 6265  ..shishi_as_krbe
│ │ │ │ -00049bc0: 7272 6f72 5f64 6572 0a2d 2d2d 2d2d 2d2d  rror_der.-------
│ │ │ │ -00049bd0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -00049be0: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ -00049bf0: 6e74 2073 6869 7368 695f 6173 5f6b 7262  nt shishi_as_krb
│ │ │ │ -00049c00: 6572 726f 725f 6465 7220 2853 6869 7368  error_der (Shish
│ │ │ │ -00049c10: 695f 6173 202a 2041 532c 2063 6861 7220  i_as * AS, char 
│ │ │ │ -00049c20: 2a2a 204f 5554 2c0a 2020 2020 2020 2020  ** OUT,.        
│ │ │ │ -00049c30: 2020 7369 7a65 5f74 202a 204f 5554 4c45    size_t * OUTLE
│ │ │ │ -00049c40: 4e29 0a20 2020 2020 4153 3a20 7374 7275  N).     AS: stru
│ │ │ │ -00049c50: 6374 7572 6520 7468 6174 2068 6f6c 6473  cture that holds
│ │ │ │ -00049c60: 2069 6e66 6f72 6d61 7469 6f6e 2061 626f   information abo
│ │ │ │ -00049c70: 7574 2041 5320 6578 6368 616e 6765 0a20  ut AS exchange. 
│ │ │ │ -00049c80: 2020 2020 4f55 543a 206f 7574 7075 7420      OUT: output 
│ │ │ │ -00049c90: 6172 7261 7920 7769 7468 206e 6577 6c79  array with newly
│ │ │ │ -00049ca0: 2061 6c6c 6f63 6174 6564 2044 4552 2065   allocated DER e
│ │ │ │ -00049cb0: 6e63 6f64 696e 6720 6f66 204b 5242 2d45  ncoding of KRB-E
│ │ │ │ -00049cc0: 5252 4f52 2e0a 2020 2020 204f 5554 4c45  RROR..     OUTLE
│ │ │ │ -00049cd0: 4e3a 206c 656e 6774 6820 6f66 206f 7574  N: length of out
│ │ │ │ -00049ce0: 7075 7420 6172 7261 7920 7769 7468 2044  put array with D
│ │ │ │ -00049cf0: 4552 2065 6e63 6f64 696e 6720 6f66 204b  ER encoding of K
│ │ │ │ -00049d00: 5242 2d45 5252 4f52 2e0a 0a20 2020 2020  RB-ERROR...     
│ │ │ │ -00049d10: 2a44 6573 6372 6970 7469 6f6e 3a2a 2044  *Description:* D
│ │ │ │ -00049d20: 4552 2065 6e63 6f64 6520 4b52 422d 4552  ER encode KRB-ER
│ │ │ │ -00049d30: 524f 522e 204f 5554 2069 7320 616c 6c6f  ROR. OUT is allo
│ │ │ │ -00049d40: 6361 7465 6420 6279 2074 6869 730a 2020  cated by this.  
│ │ │ │ -00049d50: 2020 2066 756e 6374 696f 6e2c 2061 6e64     function, and
│ │ │ │ -00049d60: 2069 7420 6973 2074 6865 2072 6573 706f   it is the respo
│ │ │ │ -00049d70: 6e73 6962 696c 6974 7920 6f66 2063 616c  nsibility of cal
│ │ │ │ -00049d80: 6c65 7220 746f 2064 6561 6c6c 6f63 6174  ler to deallocat
│ │ │ │ -00049d90: 6520 6974 2e0a 0a20 2020 2020 2a52 6574  e it...     *Ret
│ │ │ │ -00049da0: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ -00049db0: 726e 7320 5348 4953 4849 5f4f 4b20 6966  rns SHISHI_OK if
│ │ │ │ -00049dc0: 6620 7375 6363 6573 7366 756c 2e0a 0a73  f successful...s
│ │ │ │ -00049dd0: 6869 7368 695f 6173 5f6b 7262 6572 726f  hishi_as_krberro
│ │ │ │ -00049de0: 725f 7365 740a 2d2d 2d2d 2d2d 2d2d 2d2d  r_set.----------
│ │ │ │ -00049df0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ -00049e00: 2d20 4675 6e63 7469 6f6e 3a20 766f 6964  - Function: void
│ │ │ │ -00049e10: 2073 6869 7368 695f 6173 5f6b 7262 6572   shishi_as_krber
│ │ │ │ -00049e20: 726f 725f 7365 7420 2853 6869 7368 695f  ror_set (Shishi_
│ │ │ │ -00049e30: 6173 202a 2041 532c 0a20 2020 2020 2020  as * AS,.       
│ │ │ │ -00049e40: 2020 2053 6869 7368 695f 6173 6e31 204b     Shishi_asn1 K
│ │ │ │ -00049e50: 5242 4552 524f 5229 0a20 2020 2020 4153  RBERROR).     AS
│ │ │ │ -00049e60: 3a20 7374 7275 6374 7572 6520 7468 6174  : structure that
│ │ │ │ -00049e70: 2068 6f6c 6473 2069 6e66 6f72 6d61 7469   holds informati
│ │ │ │ -00049e80: 6f6e 2061 626f 7574 2041 5320 6578 6368  on about AS exch
│ │ │ │ -00049e90: 616e 6765 0a20 2020 2020 4b52 4245 5252  ange.     KRBERR
│ │ │ │ -00049ea0: 4f52 3a20 6b72 6265 7272 6f72 2074 6f20  OR: krberror to 
│ │ │ │ -00049eb0: 7374 6f72 6520 696e 2041 532e 0a0a 2020  store in AS...  
│ │ │ │ -00049ec0: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ -00049ed0: 2a20 5365 7420 7468 6520 4b52 422d 4552  * Set the KRB-ER
│ │ │ │ -00049ee0: 524f 5220 696e 2074 6865 2041 5320 6578  ROR in the AS ex
│ │ │ │ -00049ef0: 6368 616e 6765 2e0a 0a73 6869 7368 695f  change...shishi_
│ │ │ │ -00049f00: 6173 5f74 6b74 0a2d 2d2d 2d2d 2d2d 2d2d  as_tkt.---------
│ │ │ │ -00049f10: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -00049f20: 6f6e 3a20 5368 6973 6869 5f74 6b74 202a  on: Shishi_tkt *
│ │ │ │ -00049f30: 2073 6869 7368 695f 6173 5f74 6b74 2028   shishi_as_tkt (
│ │ │ │ -00049f40: 5368 6973 6869 5f61 7320 2a20 4153 290a  Shishi_as * AS).
│ │ │ │ -00049f50: 2020 2020 2041 533a 2073 7472 7563 7475       AS: structu
│ │ │ │ -00049f60: 7265 2074 6861 7420 686f 6c64 7320 696e  re that holds in
│ │ │ │ -00049f70: 666f 726d 6174 696f 6e20 6162 6f75 7420  formation about 
│ │ │ │ -00049f80: 4153 2065 7863 6861 6e67 650a 0a20 2020  AS exchange..   
│ │ │ │ -00049f90: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ -00049fa0: 2047 6574 2054 6963 6b65 7420 696e 2041   Get Ticket in A
│ │ │ │ -00049fb0: 5320 6578 6368 616e 6765 2e0a 0a20 2020  S exchange...   
│ │ │ │ -00049fc0: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ -00049fd0: 2a20 5265 7475 726e 7320 7468 6520 6e65  * Returns the ne
│ │ │ │ -00049fe0: 776c 7920 6163 7175 6972 6564 2074 6b74  wly acquired tkt
│ │ │ │ -00049ff0: 2066 726f 6d20 7468 6520 4153 0a20 2020   from the AS.   
│ │ │ │ -0004a000: 2020 6578 6368 616e 6765 2c20 6f72 204e    exchange, or N
│ │ │ │ -0004a010: 554c 4c20 6966 206e 6f74 2079 6574 2073  ULL if not yet s
│ │ │ │ -0004a020: 6574 206f 7220 616e 2065 7272 6f72 206f  et or an error o
│ │ │ │ -0004a030: 6363 7572 6564 2e0a 0a73 6869 7368 695f  ccured...shishi_
│ │ │ │ -0004a040: 6173 5f74 6b74 5f73 6574 0a2d 2d2d 2d2d  as_tkt_set.-----
│ │ │ │ -0004a050: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ -0004a060: 2d20 4675 6e63 7469 6f6e 3a20 766f 6964  - Function: void
│ │ │ │ -0004a070: 2073 6869 7368 695f 6173 5f74 6b74 5f73   shishi_as_tkt_s
│ │ │ │ -0004a080: 6574 2028 5368 6973 6869 5f61 7320 2a20  et (Shishi_as * 
│ │ │ │ -0004a090: 4153 2c20 5368 6973 6869 5f74 6b74 202a  AS, Shishi_tkt *
│ │ │ │ -0004a0a0: 2054 4b54 290a 2020 2020 2041 533a 2073   TKT).     AS: s
│ │ │ │ -0004a0b0: 7472 7563 7475 7265 2074 6861 7420 686f  tructure that ho
│ │ │ │ -0004a0c0: 6c64 7320 696e 666f 726d 6174 696f 6e20  lds information 
│ │ │ │ -0004a0d0: 6162 6f75 7420 4153 2065 7863 6861 6e67  about AS exchang
│ │ │ │ -0004a0e0: 650a 2020 2020 2054 4b54 3a20 746b 7420  e.     TKT: tkt 
│ │ │ │ -0004a0f0: 746f 2073 746f 7265 2069 6e20 4153 2e0a  to store in AS..
│ │ │ │ -0004a100: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -0004a110: 6f6e 3a2a 2053 6574 2074 6865 2054 6b74  on:* Set the Tkt
│ │ │ │ -0004a120: 2069 6e20 7468 6520 4153 2065 7863 6861   in the AS excha
│ │ │ │ -0004a130: 6e67 652e 0a0a 7368 6973 6869 5f61 735f  nge...shishi_as_
│ │ │ │ -0004a140: 7365 6e64 7265 6376 5f68 696e 740a 2d2d  sendrecv_hint.--
│ │ │ │ +00047c00: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ +00047c10: 2d2d 2046 756e 6374 696f 6e3a 2076 6f69  -- Function: voi
│ │ │ │ +00047c20: 6420 7368 6973 6869 5f74 6b74 5f6c 6173  d shishi_tkt_las
│ │ │ │ +00047c30: 7472 6571 5f70 7265 7474 795f 7072 696e  treq_pretty_prin
│ │ │ │ +00047c40: 7420 2853 6869 7368 695f 746b 7420 2a20  t (Shishi_tkt * 
│ │ │ │ +00047c50: 544b 542c 0a20 2020 2020 2020 2020 2046  TKT,.          F
│ │ │ │ +00047c60: 494c 4520 2a20 4648 290a 2020 2020 2054  ILE * FH).     T
│ │ │ │ +00047c70: 4b54 3a20 696e 7075 7420 7661 7269 6162  KT: input variab
│ │ │ │ +00047c80: 6c65 2077 6974 6820 7469 636b 6574 2069  le with ticket i
│ │ │ │ +00047c90: 6e66 6f2e 0a20 2020 2020 4648 3a20 6669  nfo..     FH: fi
│ │ │ │ +00047ca0: 6c65 2068 616e 646c 6520 6f70 656e 2066  le handle open f
│ │ │ │ +00047cb0: 6f72 2077 7269 7469 6e67 2e0a 0a20 2020  or writing...   
│ │ │ │ +00047cc0: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ +00047cd0: 2050 7269 6e74 2061 2068 756d 616e 2072   Print a human r
│ │ │ │ +00047ce0: 6561 6461 626c 6520 7265 7072 6573 656e  eadable represen
│ │ │ │ +00047cf0: 7461 7469 6f6e 206f 6620 7468 6520 7661  tation of the va
│ │ │ │ +00047d00: 7269 6f75 730a 2020 2020 206c 6173 7472  rious.     lastr
│ │ │ │ +00047d10: 6571 2066 6965 6c64 7320 696e 2074 6865  eq fields in the
│ │ │ │ +00047d20: 2074 6963 6b65 7420 2872 6561 6c6c 7920   ticket (really 
│ │ │ │ +00047d30: 456e 634b 4443 5265 7050 6172 7429 2e0a  EncKDCRepPart)..
│ │ │ │ +00047d40: 0a73 6869 7368 695f 746b 745f 7072 6574  .shishi_tkt_pret
│ │ │ │ +00047d50: 7479 5f70 7269 6e74 0a2d 2d2d 2d2d 2d2d  ty_print.-------
│ │ │ │ +00047d60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +00047d70: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +00047d80: 766f 6964 2073 6869 7368 695f 746b 745f  void shishi_tkt_
│ │ │ │ +00047d90: 7072 6574 7479 5f70 7269 6e74 2028 5368  pretty_print (Sh
│ │ │ │ +00047da0: 6973 6869 5f74 6b74 202a 2054 4b54 2c20  ishi_tkt * TKT, 
│ │ │ │ +00047db0: 4649 4c45 202a 2046 4829 0a20 2020 2020  FILE * FH).     
│ │ │ │ +00047dc0: 544b 543a 2069 6e70 7574 2076 6172 6961  TKT: input varia
│ │ │ │ +00047dd0: 626c 6520 7769 7468 2074 6963 6b65 7420  ble with ticket 
│ │ │ │ +00047de0: 696e 666f 2e0a 2020 2020 2046 483a 2066  info..     FH: f
│ │ │ │ +00047df0: 696c 6520 6861 6e64 6c65 206f 7065 6e20  ile handle open 
│ │ │ │ +00047e00: 666f 7220 7772 6974 696e 672e 0a0a 2020  for writing...  
│ │ │ │ +00047e10: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ +00047e20: 2a20 5072 696e 7420 6120 6875 6d61 6e20  * Print a human 
│ │ │ │ +00047e30: 7265 6164 6162 6c65 2072 6570 7265 7365  readable represe
│ │ │ │ +00047e40: 6e74 6174 696f 6e20 6f66 2061 2074 6963  ntation of a tic
│ │ │ │ +00047e50: 6b65 7420 746f 0a20 2020 2020 6669 6c65  ket to.     file
│ │ │ │ +00047e60: 2068 616e 646c 652e 0a0a 1f0a 4669 6c65   handle.....File
│ │ │ │ +00047e70: 3a20 7368 6973 6869 2e69 6e66 6f2c 2020  : shishi.info,  
│ │ │ │ +00047e80: 4e6f 6465 3a20 4153 2046 756e 6374 696f  Node: AS Functio
│ │ │ │ +00047e90: 6e73 2c20 204e 6578 743a 2054 4753 2046  ns,  Next: TGS F
│ │ │ │ +00047ea0: 756e 6374 696f 6e73 2c20 2050 7265 763a  unctions,  Prev:
│ │ │ │ +00047eb0: 2054 6963 6b65 7420 4675 6e63 7469 6f6e   Ticket Function
│ │ │ │ +00047ec0: 732c 2020 5570 3a20 5072 6f67 7261 6d6d  s,  Up: Programm
│ │ │ │ +00047ed0: 696e 6720 4d61 6e75 616c 0a0a 352e 3720  ing Manual..5.7 
│ │ │ │ +00047ee0: 4153 2046 756e 6374 696f 6e73 0a3d 3d3d  AS Functions.===
│ │ │ │ +00047ef0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a54  =============..T
│ │ │ │ +00047f00: 6865 2041 7574 6865 6e74 6963 6174 696f  he Authenticatio
│ │ │ │ +00047f10: 6e20 5365 7276 6963 6520 2841 5329 2069  n Service (AS) i
│ │ │ │ +00047f20: 7320 7573 6564 2074 6f20 6765 7420 616e  s used to get an
│ │ │ │ +00047f30: 2069 6e69 7469 616c 2074 6963 6b65 7420   initial ticket 
│ │ │ │ +00047f40: 7573 696e 670a 652e 672e 2020 796f 7572  using.e.g.  your
│ │ │ │ +00047f50: 2070 6173 7377 6f72 642e 2020 5468 6520   password.  The 
│ │ │ │ +00047f60: 666f 6c6c 6f77 696e 6720 696c 6c75 7374  following illust
│ │ │ │ +00047f70: 7261 7465 7320 7468 6520 4153 2d52 4551  rates the AS-REQ
│ │ │ │ +00047f80: 2061 6e64 2041 532d 5245 500a 4153 4e2e   and AS-REP.ASN.
│ │ │ │ +00047f90: 3120 7374 7275 6374 7572 6573 2e0a 0a2d  1 structures...-
│ │ │ │ +00047fa0: 2d20 5265 7175 6573 7420 2d2d 0a0a 4153  - Request --..AS
│ │ │ │ +00047fb0: 2d52 4551 0909 3a3a 3d20 4b44 432d 5245  -REQ..::= KDC-RE
│ │ │ │ +00047fc0: 5120 7b31 307d 0a0a 4b44 432d 5245 5120  Q {10}..KDC-REQ 
│ │ │ │ +00047fd0: 7b49 4e54 4547 4552 3a74 6167 6e75 6d7d  {INTEGER:tagnum}
│ │ │ │ +00047fe0: 093a 3a3d 205b 4150 504c 4943 4154 494f  .::= [APPLICATIO
│ │ │ │ +00047ff0: 4e20 7461 676e 756d 5d20 5345 5155 454e  N tagnum] SEQUEN
│ │ │ │ +00048000: 4345 207b 0a09 7076 6e6f 0909 5b31 5d20  CE {..pvno..[1] 
│ │ │ │ +00048010: 494e 5445 4745 5220 2835 2920 2d2d 2066  INTEGER (5) -- f
│ │ │ │ +00048020: 6972 7374 2074 6167 2069 7320 5b31 5d2c  irst tag is [1],
│ │ │ │ +00048030: 206e 6f74 205b 305d 202d 2d2c 0a09 6d73   not [0] --,..ms
│ │ │ │ +00048040: 672d 7479 7065 095b 325d 2049 4e54 4547  g-type.[2] INTEG
│ │ │ │ +00048050: 4552 2028 7461 676e 756d 292c 0a09 7061  ER (tagnum),..pa
│ │ │ │ +00048060: 6461 7461 0909 5b33 5d20 5345 5155 454e  data..[3] SEQUEN
│ │ │ │ +00048070: 4345 204f 4620 5041 2d44 4154 4120 4f50  CE OF PA-DATA OP
│ │ │ │ +00048080: 5449 4f4e 414c 2c0a 0972 6571 2d62 6f64  TIONAL,..req-bod
│ │ │ │ +00048090: 7909 5b34 5d20 4b44 432d 5245 512d 424f  y.[4] KDC-REQ-BO
│ │ │ │ +000480a0: 4459 0a7d 0a0a 4b44 432d 5245 512d 424f  DY.}..KDC-REQ-BO
│ │ │ │ +000480b0: 4459 093a 3a3d 2053 4551 5545 4e43 4520  DY.::= SEQUENCE 
│ │ │ │ +000480c0: 7b0a 096b 6463 2d6f 7074 696f 6e73 0909  {..kdc-options..
│ │ │ │ +000480d0: 5b30 5d20 4b44 434f 7074 696f 6e73 2c0a  [0] KDCOptions,.
│ │ │ │ +000480e0: 0963 6e61 6d65 0909 095b 315d 2050 7269  .cname...[1] Pri
│ │ │ │ +000480f0: 6e63 6970 616c 4e61 6d65 204f 5054 494f  ncipalName OPTIO
│ │ │ │ +00048100: 4e41 4c0a 0909 0909 2020 2020 2d2d 2055  NAL.....    -- U
│ │ │ │ +00048110: 7365 6420 6f6e 6c79 2069 6e20 4153 2d52  sed only in AS-R
│ │ │ │ +00048120: 4551 202d 2d2c 0a09 7265 616c 6d09 0909  EQ --,..realm...
│ │ │ │ +00048130: 5b32 5d20 5265 616c 6d0a 0909 0909 2020  [2] Realm.....  
│ │ │ │ +00048140: 2020 2d2d 2053 6572 7665 7227 7320 7265    -- Server's re
│ │ │ │ +00048150: 616c 6d0a 0909 0909 2020 2020 2d2d 2041  alm.....    -- A
│ │ │ │ +00048160: 6c73 6f20 636c 6965 6e74 2773 2069 6e20  lso client's in 
│ │ │ │ +00048170: 4153 2d52 4551 202d 2d2c 0a09 736e 616d  AS-REQ --,..snam
│ │ │ │ +00048180: 6509 0909 5b33 5d20 5072 696e 6369 7061  e...[3] Principa
│ │ │ │ +00048190: 6c4e 616d 6520 4f50 5449 4f4e 414c 2c0a  lName OPTIONAL,.
│ │ │ │ +000481a0: 0966 726f 6d09 0909 5b34 5d20 4b65 7262  .from...[4] Kerb
│ │ │ │ +000481b0: 6572 6f73 5469 6d65 204f 5054 494f 4e41  erosTime OPTIONA
│ │ │ │ +000481c0: 4c2c 0a09 7469 6c6c 0909 095b 355d 204b  L,..till...[5] K
│ │ │ │ +000481d0: 6572 6265 726f 7354 696d 652c 0a09 7274  erberosTime,..rt
│ │ │ │ +000481e0: 696d 6509 0909 5b36 5d20 4b65 7262 6572  ime...[6] Kerber
│ │ │ │ +000481f0: 6f73 5469 6d65 204f 5054 494f 4e41 4c2c  osTime OPTIONAL,
│ │ │ │ +00048200: 0a09 6e6f 6e63 6509 0909 5b37 5d20 5549  ..nonce...[7] UI
│ │ │ │ +00048210: 6e74 3332 2c0a 0965 7479 7065 0909 095b  nt32,..etype...[
│ │ │ │ +00048220: 385d 2053 4551 5545 4e43 4520 4f46 2049  8] SEQUENCE OF I
│ │ │ │ +00048230: 6e74 3332 202d 2d20 456e 6372 7970 7469  nt32 -- Encrypti
│ │ │ │ +00048240: 6f6e 5479 7065 0a09 0909 0920 2020 202d  onType.....    -
│ │ │ │ +00048250: 2d20 696e 2070 7265 6665 7265 6e63 6520  - in preference 
│ │ │ │ +00048260: 6f72 6465 7220 2d2d 2c0a 0961 6464 7265  order --,..addre
│ │ │ │ +00048270: 7373 6573 0909 5b39 5d20 486f 7374 4164  sses..[9] HostAd
│ │ │ │ +00048280: 6472 6573 7365 7320 4f50 5449 4f4e 414c  dresses OPTIONAL
│ │ │ │ +00048290: 2c0a 0965 6e63 2d61 7574 686f 7269 7a61  ,..enc-authoriza
│ │ │ │ +000482a0: 7469 6f6e 2d64 6174 6109 5b31 305d 2045  tion-data.[10] E
│ │ │ │ +000482b0: 6e63 7279 7074 6564 4461 7461 207b 0a09  ncryptedData {..
│ │ │ │ +000482c0: 0909 0909 4175 7468 6f72 697a 6174 696f  ....Authorizatio
│ │ │ │ +000482d0: 6e44 6174 612c 0a09 0909 0909 7b20 6b65  nData,......{ ke
│ │ │ │ +000482e0: 7975 7365 2d54 4753 5265 7141 7574 6844  yuse-TGSReqAuthD
│ │ │ │ +000482f0: 6174 612d 7365 7373 6b65 790a 0909 0909  ata-sesskey.....
│ │ │ │ +00048300: 0920 207c 206b 6579 7573 652d 5447 5352  .  | keyuse-TGSR
│ │ │ │ +00048310: 6571 4175 7468 4461 7461 2d73 7562 6b65  eqAuthData-subke
│ │ │ │ +00048320: 7920 7d0a 0909 0909 2020 2020 207d 204f  y }.....     } O
│ │ │ │ +00048330: 5054 494f 4e41 4c2c 0a09 6164 6469 7469  PTIONAL,..additi
│ │ │ │ +00048340: 6f6e 616c 2d74 6963 6b65 7473 095b 3131  onal-tickets.[11
│ │ │ │ +00048350: 5d20 5345 5155 454e 4345 204f 4620 5469  ] SEQUENCE OF Ti
│ │ │ │ +00048360: 636b 6574 204f 5054 494f 4e41 4c0a 7d0a  cket OPTIONAL.}.
│ │ │ │ +00048370: 0a2d 2d20 5265 706c 7920 2d2d 0a0a 4153  .-- Reply --..AS
│ │ │ │ +00048380: 2d52 4550 0909 3a3a 3d20 4b44 432d 5245  -REP..::= KDC-RE
│ │ │ │ +00048390: 5020 7b31 312c 2045 6e63 4153 5265 7050  P {11, EncASRepP
│ │ │ │ +000483a0: 6172 742c 207b 6b65 7975 7365 2d45 6e63  art, {keyuse-Enc
│ │ │ │ +000483b0: 4153 5265 7050 6172 747d 7d0a 0a4b 4443  ASRepPart}}..KDC
│ │ │ │ +000483c0: 2d52 4550 207b 494e 5445 4745 523a 7461  -REP {INTEGER:ta
│ │ │ │ +000483d0: 676e 756d 2c0a 0920 5479 7065 546f 456e  gnum,.. TypeToEn
│ │ │ │ +000483e0: 6372 7970 742c 0a09 2055 496e 7433 323a  crypt,.. UInt32:
│ │ │ │ +000483f0: 4b65 7955 7361 6765 737d 093a 3a3d 205b  KeyUsages}.::= [
│ │ │ │ +00048400: 4150 504c 4943 4154 494f 4e20 7461 676e  APPLICATION tagn
│ │ │ │ +00048410: 756d 5d20 5345 5155 454e 4345 207b 0a09  um] SEQUENCE {..
│ │ │ │ +00048420: 7076 6e6f 0909 5b30 5d20 494e 5445 4745  pvno..[0] INTEGE
│ │ │ │ +00048430: 5220 2835 292c 0a09 6d73 672d 7479 7065  R (5),..msg-type
│ │ │ │ +00048440: 095b 315d 2049 4e54 4547 4552 2028 7461  .[1] INTEGER (ta
│ │ │ │ +00048450: 676e 756d 292c 0a09 7061 6461 7461 0909  gnum),..padata..
│ │ │ │ +00048460: 5b32 5d20 5345 5155 454e 4345 204f 4620  [2] SEQUENCE OF 
│ │ │ │ +00048470: 5041 2d44 4154 4120 4f50 5449 4f4e 414c  PA-DATA OPTIONAL
│ │ │ │ +00048480: 2c0a 0963 7265 616c 6d09 095b 335d 2052  ,..crealm..[3] R
│ │ │ │ +00048490: 6561 6c6d 2c0a 0963 6e61 6d65 0909 5b34  ealm,..cname..[4
│ │ │ │ +000484a0: 5d20 5072 696e 6369 7061 6c4e 616d 652c  ] PrincipalName,
│ │ │ │ +000484b0: 0a09 7469 636b 6574 0909 5b35 5d20 5469  ..ticket..[5] Ti
│ │ │ │ +000484c0: 636b 6574 2c0a 0965 6e63 2d70 6172 7409  cket,..enc-part.
│ │ │ │ +000484d0: 5b36 5d20 456e 6372 7970 7465 6444 6174  [6] EncryptedDat
│ │ │ │ +000484e0: 6120 7b54 7970 6554 6f45 6e63 7279 7074  a {TypeToEncrypt
│ │ │ │ +000484f0: 2c20 4b65 7955 7361 6765 737d 0a7d 0a0a  , KeyUsages}.}..
│ │ │ │ +00048500: 456e 6341 5352 6570 5061 7274 093a 3a3d  EncASRepPart.::=
│ │ │ │ +00048510: 205b 4150 504c 4943 4154 494f 4e20 3235   [APPLICATION 25
│ │ │ │ +00048520: 5d20 456e 634b 4443 5265 7050 6172 740a  ] EncKDCRepPart.
│ │ │ │ +00048530: 0a45 6e63 4b44 4352 6570 5061 7274 093a  .EncKDCRepPart.:
│ │ │ │ +00048540: 3a3d 2053 4551 5545 4e43 4520 7b0a 096b  := SEQUENCE {..k
│ │ │ │ +00048550: 6579 0909 5b30 5d20 456e 6372 7970 7469  ey..[0] Encrypti
│ │ │ │ +00048560: 6f6e 4b65 792c 0a09 6c61 7374 2d72 6571  onKey,..last-req
│ │ │ │ +00048570: 095b 315d 204c 6173 7452 6571 2c0a 096e  .[1] LastReq,..n
│ │ │ │ +00048580: 6f6e 6365 0909 5b32 5d20 5549 6e74 3332  once..[2] UInt32
│ │ │ │ +00048590: 2c0a 096b 6579 2d65 7870 6972 6174 696f  ,..key-expiratio
│ │ │ │ +000485a0: 6e09 5b33 5d20 4b65 7262 6572 6f73 5469  n.[3] KerberosTi
│ │ │ │ +000485b0: 6d65 204f 5054 494f 4e41 4c2c 0a09 666c  me OPTIONAL,..fl
│ │ │ │ +000485c0: 6167 7309 095b 345d 2054 6963 6b65 7446  ags..[4] TicketF
│ │ │ │ +000485d0: 6c61 6773 2c0a 0961 7574 6874 696d 6509  lags,..authtime.
│ │ │ │ +000485e0: 5b35 5d20 4b65 7262 6572 6f73 5469 6d65  [5] KerberosTime
│ │ │ │ +000485f0: 2c0a 0973 7461 7274 7469 6d65 095b 365d  ,..starttime.[6]
│ │ │ │ +00048600: 204b 6572 6265 726f 7354 696d 6520 4f50   KerberosTime OP
│ │ │ │ +00048610: 5449 4f4e 414c 2c0a 0965 6e64 7469 6d65  TIONAL,..endtime
│ │ │ │ +00048620: 0909 5b37 5d20 4b65 7262 6572 6f73 5469  ..[7] KerberosTi
│ │ │ │ +00048630: 6d65 2c0a 0972 656e 6577 2d74 696c 6c09  me,..renew-till.
│ │ │ │ +00048640: 5b38 5d20 4b65 7262 6572 6f73 5469 6d65  [8] KerberosTime
│ │ │ │ +00048650: 204f 5054 494f 4e41 4c2c 0a09 7372 6561   OPTIONAL,..srea
│ │ │ │ +00048660: 6c6d 0909 5b39 5d20 5265 616c 6d2c 0a09  lm..[9] Realm,..
│ │ │ │ +00048670: 736e 616d 6509 095b 3130 5d20 5072 696e  sname..[10] Prin
│ │ │ │ +00048680: 6369 7061 6c4e 616d 652c 0a09 6361 6464  cipalName,..cadd
│ │ │ │ +00048690: 7209 095b 3131 5d20 486f 7374 4164 6472  r..[11] HostAddr
│ │ │ │ +000486a0: 6573 7365 7320 4f50 5449 4f4e 414c 0a7d  esses OPTIONAL.}
│ │ │ │ +000486b0: 0a0a 7368 6973 6869 5f61 730a 2d2d 2d2d  ..shishi_as.----
│ │ │ │ +000486c0: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +000486d0: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ +000486e0: 6173 2028 5368 6973 6869 202a 2048 414e  as (Shishi * HAN
│ │ │ │ +000486f0: 444c 452c 2053 6869 7368 695f 6173 202a  DLE, Shishi_as *
│ │ │ │ +00048700: 2a20 4153 290a 2020 2020 2048 414e 444c  * AS).     HANDL
│ │ │ │ +00048710: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ +00048720: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ +00048730: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ +00048740: 29e2 8099 2e0a 2020 2020 2041 533a 2068  ).....     AS: h
│ │ │ │ +00048750: 6f6c 6473 2070 6f69 6e74 6572 2074 6f20  olds pointer to 
│ │ │ │ +00048760: 6e65 776c 7920 616c 6c6f 6361 7465 2053  newly allocate S
│ │ │ │ +00048770: 6869 7368 695f 6173 2073 7472 7563 7475  hishi_as structu
│ │ │ │ +00048780: 7265 2e0a 0a20 2020 2020 2a44 6573 6372  re...     *Descr
│ │ │ │ +00048790: 6970 7469 6f6e 3a2a 2041 6c6c 6f63 6174  iption:* Allocat
│ │ │ │ +000487a0: 6520 6120 6e65 7720 4153 2065 7863 6861  e a new AS excha
│ │ │ │ +000487b0: 6e67 6520 7661 7269 6162 6c65 2e0a 0a20  nge variable... 
│ │ │ │ +000487c0: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ +000487d0: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ +000487e0: 4849 5f4f 4b20 6966 6620 7375 6363 6573  HI_OK iff succes
│ │ │ │ +000487f0: 7366 756c 2e0a 0a73 6869 7368 695f 6173  sful...shishi_as
│ │ │ │ +00048800: 5f64 6f6e 650a 2d2d 2d2d 2d2d 2d2d 2d2d  _done.----------
│ │ │ │ +00048810: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ +00048820: 6f6e 3a20 766f 6964 2073 6869 7368 695f  on: void shishi_
│ │ │ │ +00048830: 6173 5f64 6f6e 6520 2853 6869 7368 695f  as_done (Shishi_
│ │ │ │ +00048840: 6173 202a 2041 5329 0a20 2020 2020 4153  as * AS).     AS
│ │ │ │ +00048850: 3a20 7374 7275 6374 7572 6520 7468 6174  : structure that
│ │ │ │ +00048860: 2068 6f6c 6473 2069 6e66 6f72 6d61 7469   holds informati
│ │ │ │ +00048870: 6f6e 2061 626f 7574 2041 5320 6578 6368  on about AS exch
│ │ │ │ +00048880: 616e 6765 0a0a 2020 2020 202a 4465 7363  ange..     *Desc
│ │ │ │ +00048890: 7269 7074 696f 6e3a 2a20 4465 616c 6c6f  ription:* Deallo
│ │ │ │ +000488a0: 6361 7465 2072 6573 6f75 7263 6573 2061  cate resources a
│ │ │ │ +000488b0: 7373 6f63 6961 7465 6420 7769 7468 2041  ssociated with A
│ │ │ │ +000488c0: 5320 6578 6368 616e 6765 2e0a 2020 2020  S exchange..    
│ │ │ │ +000488d0: 2054 6869 7320 7368 6f75 6c64 2062 6520   This should be 
│ │ │ │ +000488e0: 6361 6c6c 6564 2062 7920 7468 6520 6170  called by the ap
│ │ │ │ +000488f0: 706c 6963 6174 696f 6e20 7768 656e 2069  plication when i
│ │ │ │ +00048900: 7420 6e6f 206c 6f6e 6765 7220 6e65 6564  t no longer need
│ │ │ │ +00048910: 2074 6f0a 2020 2020 2075 7469 6c69 7a65   to.     utilize
│ │ │ │ +00048920: 2074 6865 2041 5320 6578 6368 616e 6765   the AS exchange
│ │ │ │ +00048930: 2068 616e 646c 652e 0a0a 7368 6973 6869   handle...shishi
│ │ │ │ +00048940: 5f61 735f 7265 710a 2d2d 2d2d 2d2d 2d2d  _as_req.--------
│ │ │ │ +00048950: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +00048960: 696f 6e3a 2053 6869 7368 695f 6173 6e31  ion: Shishi_asn1
│ │ │ │ +00048970: 2073 6869 7368 695f 6173 5f72 6571 2028   shishi_as_req (
│ │ │ │ +00048980: 5368 6973 6869 5f61 7320 2a20 4153 290a  Shishi_as * AS).
│ │ │ │ +00048990: 2020 2020 2041 533a 2073 7472 7563 7475       AS: structu
│ │ │ │ +000489a0: 7265 2074 6861 7420 686f 6c64 7320 696e  re that holds in
│ │ │ │ +000489b0: 666f 726d 6174 696f 6e20 6162 6f75 7420  formation about 
│ │ │ │ +000489c0: 4153 2065 7863 6861 6e67 650a 0a20 2020  AS exchange..   
│ │ │ │ +000489d0: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ +000489e0: 2047 6574 2041 534e 2e31 2041 532d 5245   Get ASN.1 AS-RE
│ │ │ │ +000489f0: 5120 7374 7275 6374 7572 6520 6672 6f6d  Q structure from
│ │ │ │ +00048a00: 2041 5320 6578 6368 616e 6765 2e0a 0a20   AS exchange... 
│ │ │ │ +00048a10: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ +00048a20: 653a 2a20 5265 7475 726e 7320 7468 6520  e:* Returns the 
│ │ │ │ +00048a30: 6765 6e65 7261 7465 6420 4153 2d52 4551  generated AS-REQ
│ │ │ │ +00048a40: 2070 6163 6b65 7420 6672 6f6d 2074 6865   packet from the
│ │ │ │ +00048a50: 2041 530a 2020 2020 2065 7863 6861 6e67   AS.     exchang
│ │ │ │ +00048a60: 652c 206f 7220 4e55 4c4c 2069 6620 6e6f  e, or NULL if no
│ │ │ │ +00048a70: 7420 7965 7420 7365 7420 6f72 2061 6e20  t yet set or an 
│ │ │ │ +00048a80: 6572 726f 7220 6f63 6375 7265 642e 0a0a  error occured...
│ │ │ │ +00048a90: 7368 6973 6869 5f61 735f 7265 715f 6275  shishi_as_req_bu
│ │ │ │ +00048aa0: 696c 640a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ild.------------
│ │ │ │ +00048ab0: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +00048ac0: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ +00048ad0: 695f 6173 5f72 6571 5f62 7569 6c64 2028  i_as_req_build (
│ │ │ │ +00048ae0: 5368 6973 6869 5f61 7320 2a20 4153 290a  Shishi_as * AS).
│ │ │ │ +00048af0: 2020 2020 2041 533a 2073 7472 7563 7475       AS: structu
│ │ │ │ +00048b00: 7265 2074 6861 7420 686f 6c64 7320 696e  re that holds in
│ │ │ │ +00048b10: 666f 726d 6174 696f 6e20 6162 6f75 7420  formation about 
│ │ │ │ +00048b20: 4153 2065 7863 6861 6e67 650a 0a20 2020  AS exchange..   
│ │ │ │ +00048b30: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ +00048b40: 2050 6f73 7369 626c 7920 7265 6d6f 7665   Possibly remove
│ │ │ │ +00048b50: 2075 6e73 6574 2066 6965 6c64 7320 2865   unset fields (e
│ │ │ │ +00048b60: 2e67 2e2c 2072 7469 6d65 292e 0a0a 2020  .g., rtime)...  
│ │ │ │ +00048b70: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ +00048b80: 3a2a 2052 6574 7572 6e73 2053 4849 5348  :* Returns SHISH
│ │ │ │ +00048b90: 495f 4f4b 2069 6666 2073 7563 6365 7373  I_OK iff success
│ │ │ │ +00048ba0: 6675 6c2e 0a0a 7368 6973 6869 5f61 735f  ful...shishi_as_
│ │ │ │ +00048bb0: 7265 715f 7365 740a 2d2d 2d2d 2d2d 2d2d  req_set.--------
│ │ │ │ +00048bc0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +00048bd0: 756e 6374 696f 6e3a 2076 6f69 6420 7368  unction: void sh
│ │ │ │ +00048be0: 6973 6869 5f61 735f 7265 715f 7365 7420  ishi_as_req_set 
│ │ │ │ +00048bf0: 2853 6869 7368 695f 6173 202a 2041 532c  (Shishi_as * AS,
│ │ │ │ +00048c00: 2053 6869 7368 695f 6173 6e31 2041 5352   Shishi_asn1 ASR
│ │ │ │ +00048c10: 4551 290a 2020 2020 2041 533a 2073 7472  EQ).     AS: str
│ │ │ │ +00048c20: 7563 7475 7265 2074 6861 7420 686f 6c64  ucture that hold
│ │ │ │ +00048c30: 7320 696e 666f 726d 6174 696f 6e20 6162  s information ab
│ │ │ │ +00048c40: 6f75 7420 4153 2065 7863 6861 6e67 650a  out AS exchange.
│ │ │ │ +00048c50: 2020 2020 2041 5352 4551 3a20 6173 7265       ASREQ: asre
│ │ │ │ +00048c60: 7120 746f 2073 746f 7265 2069 6e20 4153  q to store in AS
│ │ │ │ +00048c70: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ +00048c80: 7469 6f6e 3a2a 2053 6574 2074 6865 2041  tion:* Set the A
│ │ │ │ +00048c90: 532d 5245 5120 696e 2074 6865 2041 5320  S-REQ in the AS 
│ │ │ │ +00048ca0: 6578 6368 616e 6765 2e0a 0a73 6869 7368  exchange...shish
│ │ │ │ +00048cb0: 695f 6173 5f72 6571 5f64 6572 0a2d 2d2d  i_as_req_der.---
│ │ │ │ +00048cc0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ +00048cd0: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ +00048ce0: 7420 7368 6973 6869 5f61 735f 7265 715f  t shishi_as_req_
│ │ │ │ +00048cf0: 6465 7220 2853 6869 7368 695f 6173 202a  der (Shishi_as *
│ │ │ │ +00048d00: 2041 532c 2063 6861 7220 2a2a 204f 5554   AS, char ** OUT
│ │ │ │ +00048d10: 2c0a 2020 2020 2020 2020 2020 7369 7a65  ,.          size
│ │ │ │ +00048d20: 5f74 202a 204f 5554 4c45 4e29 0a20 2020  _t * OUTLEN).   
│ │ │ │ +00048d30: 2020 4153 3a20 7374 7275 6374 7572 6520    AS: structure 
│ │ │ │ +00048d40: 7468 6174 2068 6f6c 6473 2069 6e66 6f72  that holds infor
│ │ │ │ +00048d50: 6d61 7469 6f6e 2061 626f 7574 2041 5320  mation about AS 
│ │ │ │ +00048d60: 6578 6368 616e 6765 0a20 2020 2020 4f55  exchange.     OU
│ │ │ │ +00048d70: 543a 206f 7574 7075 7420 6172 7261 7920  T: output array 
│ │ │ │ +00048d80: 7769 7468 206e 6577 6c79 2061 6c6c 6f63  with newly alloc
│ │ │ │ +00048d90: 6174 6564 2044 4552 2065 6e63 6f64 696e  ated DER encodin
│ │ │ │ +00048da0: 6720 6f66 2041 532d 5245 512e 0a20 2020  g of AS-REQ..   
│ │ │ │ +00048db0: 2020 4f55 544c 454e 3a20 6c65 6e67 7468    OUTLEN: length
│ │ │ │ +00048dc0: 206f 6620 6f75 7470 7574 2061 7272 6179   of output array
│ │ │ │ +00048dd0: 2077 6974 6820 4445 5220 656e 636f 6469   with DER encodi
│ │ │ │ +00048de0: 6e67 206f 6620 4153 2d52 4551 2e0a 0a20  ng of AS-REQ... 
│ │ │ │ +00048df0: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ +00048e00: 3a2a 2044 4552 2065 6e63 6f64 6520 4153  :* DER encode AS
│ │ │ │ +00048e10: 2d52 4551 2e20 4f55 5420 6973 2061 6c6c  -REQ. OUT is all
│ │ │ │ +00048e20: 6f63 6174 6564 2062 7920 7468 6973 0a20  ocated by this. 
│ │ │ │ +00048e30: 2020 2020 6675 6e63 7469 6f6e 2c20 616e      function, an
│ │ │ │ +00048e40: 6420 6974 2069 7320 7468 6520 7265 7370  d it is the resp
│ │ │ │ +00048e50: 6f6e 7369 6269 6c69 7479 206f 6620 6361  onsibility of ca
│ │ │ │ +00048e60: 6c6c 6572 2074 6f20 6465 616c 6c6f 6361  ller to dealloca
│ │ │ │ +00048e70: 7465 2069 742e 0a0a 2020 2020 202a 5265  te it...     *Re
│ │ │ │ +00048e80: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ +00048e90: 7572 6e73 2053 4849 5348 495f 4f4b 2069  urns SHISHI_OK i
│ │ │ │ +00048ea0: 6666 2073 7563 6365 7373 6675 6c2e 0a0a  ff successful...
│ │ │ │ +00048eb0: 7368 6973 6869 5f61 735f 7265 715f 6465  shishi_as_req_de
│ │ │ │ +00048ec0: 725f 7365 740a 2d2d 2d2d 2d2d 2d2d 2d2d  r_set.----------
│ │ │ │ +00048ed0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ +00048ee0: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ +00048ef0: 6869 7368 695f 6173 5f72 6571 5f64 6572  hishi_as_req_der
│ │ │ │ +00048f00: 5f73 6574 2028 5368 6973 6869 5f61 7320  _set (Shishi_as 
│ │ │ │ +00048f10: 2a20 4153 2c20 6368 6172 202a 2044 4552  * AS, char * DER
│ │ │ │ +00048f20: 2c0a 2020 2020 2020 2020 2020 7369 7a65  ,.          size
│ │ │ │ +00048f30: 5f74 2044 4552 4c45 4e29 0a20 2020 2020  _t DERLEN).     
│ │ │ │ +00048f40: 4153 3a20 7374 7275 6374 7572 6520 7468  AS: structure th
│ │ │ │ +00048f50: 6174 2068 6f6c 6473 2069 6e66 6f72 6d61  at holds informa
│ │ │ │ +00048f60: 7469 6f6e 2061 626f 7574 2041 5320 6578  tion about AS ex
│ │ │ │ +00048f70: 6368 616e 6765 0a20 2020 2020 4445 523a  change.     DER:
│ │ │ │ +00048f80: 2069 6e70 7574 2061 7272 6179 2077 6974   input array wit
│ │ │ │ +00048f90: 6820 4445 5220 656e 636f 6465 6420 4150  h DER encoded AP
│ │ │ │ +00048fa0: 2d52 4551 2e0a 2020 2020 2044 4552 4c45  -REQ..     DERLE
│ │ │ │ +00048fb0: 4e3a 206c 656e 6774 6820 6f66 2069 6e70  N: length of inp
│ │ │ │ +00048fc0: 7574 2061 7272 6179 2077 6974 6820 4445  ut array with DE
│ │ │ │ +00048fd0: 5220 656e 636f 6465 6420 4150 2d52 4551  R encoded AP-REQ
│ │ │ │ +00048fe0: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ +00048ff0: 7469 6f6e 3a2a 2044 4552 2064 6563 6f64  tion:* DER decod
│ │ │ │ +00049000: 6520 4153 2d52 4551 2061 6e64 2073 6574  e AS-REQ and set
│ │ │ │ +00049010: 2069 7420 4153 2065 7863 6861 6e67 652e   it AS exchange.
│ │ │ │ +00049020: 2020 4966 0a20 2020 2020 6465 636f 6469    If.     decodi
│ │ │ │ +00049030: 6e67 2066 6169 6c73 2c20 7468 6520 4153  ng fails, the AS
│ │ │ │ +00049040: 2d52 4551 2069 6e20 7468 6520 4153 2065  -REQ in the AS e
│ │ │ │ +00049050: 7863 6861 6e67 6520 7265 6d61 696e 732e  xchange remains.
│ │ │ │ +00049060: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ +00049070: 616c 7565 3a2a 2052 6574 7572 6e73 2053  alue:* Returns S
│ │ │ │ +00049080: 4849 5348 495f 4f4b 2e0a 0a73 6869 7368  HISHI_OK...shish
│ │ │ │ +00049090: 695f 6173 5f72 6570 0a2d 2d2d 2d2d 2d2d  i_as_rep.-------
│ │ │ │ +000490a0: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ +000490b0: 7469 6f6e 3a20 5368 6973 6869 5f61 736e  tion: Shishi_asn
│ │ │ │ +000490c0: 3120 7368 6973 6869 5f61 735f 7265 7020  1 shishi_as_rep 
│ │ │ │ +000490d0: 2853 6869 7368 695f 6173 202a 2041 5329  (Shishi_as * AS)
│ │ │ │ +000490e0: 0a20 2020 2020 4153 3a20 7374 7275 6374  .     AS: struct
│ │ │ │ +000490f0: 7572 6520 7468 6174 2068 6f6c 6473 2069  ure that holds i
│ │ │ │ +00049100: 6e66 6f72 6d61 7469 6f6e 2061 626f 7574  nformation about
│ │ │ │ +00049110: 2041 5320 6578 6368 616e 6765 0a0a 2020   AS exchange..  
│ │ │ │ +00049120: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ +00049130: 2a20 4765 7420 4153 4e2e 3120 4153 2d52  * Get ASN.1 AS-R
│ │ │ │ +00049140: 4550 2073 7472 7563 7475 7265 2066 726f  EP structure fro
│ │ │ │ +00049150: 6d20 4153 2065 7863 6861 6e67 652e 0a0a  m AS exchange...
│ │ │ │ +00049160: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ +00049170: 7565 3a2a 2052 6574 7572 6e73 2074 6865  ue:* Returns the
│ │ │ │ +00049180: 2072 6563 6569 7665 6420 4153 2d52 4550   received AS-REP
│ │ │ │ +00049190: 2070 6163 6b65 7420 6672 6f6d 2074 6865   packet from the
│ │ │ │ +000491a0: 2041 530a 2020 2020 2065 7863 6861 6e67   AS.     exchang
│ │ │ │ +000491b0: 652c 206f 7220 4e55 4c4c 2069 6620 6e6f  e, or NULL if no
│ │ │ │ +000491c0: 7420 7965 7420 7365 7420 6f72 2061 6e20  t yet set or an 
│ │ │ │ +000491d0: 6572 726f 7220 6f63 6375 7265 642e 0a0a  error occured...
│ │ │ │ +000491e0: 7368 6973 6869 5f61 735f 7265 705f 7072  shishi_as_rep_pr
│ │ │ │ +000491f0: 6f63 6573 730a 2d2d 2d2d 2d2d 2d2d 2d2d  ocess.----------
│ │ │ │ +00049200: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ +00049210: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ +00049220: 6869 7368 695f 6173 5f72 6570 5f70 726f  hishi_as_rep_pro
│ │ │ │ +00049230: 6365 7373 2028 5368 6973 6869 5f61 7320  cess (Shishi_as 
│ │ │ │ +00049240: 2a20 4153 2c0a 2020 2020 2020 2020 2020  * AS,.          
│ │ │ │ +00049250: 5368 6973 6869 5f6b 6579 202a 204b 4559  Shishi_key * KEY
│ │ │ │ +00049260: 2c20 636f 6e73 7420 6368 6172 202a 2050  , const char * P
│ │ │ │ +00049270: 4153 5357 4f52 4429 0a20 2020 2020 4153  ASSWORD).     AS
│ │ │ │ +00049280: 3a20 7374 7275 6374 7572 6520 7468 6174  : structure that
│ │ │ │ +00049290: 2068 6f6c 6473 2069 6e66 6f72 6d61 7469   holds informati
│ │ │ │ +000492a0: 6f6e 2061 626f 7574 2041 5320 6578 6368  on about AS exch
│ │ │ │ +000492b0: 616e 6765 0a20 2020 2020 4b45 593a 2075  ange.     KEY: u
│ │ │ │ +000492c0: 7365 7227 7320 6b65 792c 2075 7365 6420  ser's key, used 
│ │ │ │ +000492d0: 746f 2065 6e63 7279 7074 2074 6865 2065  to encrypt the e
│ │ │ │ +000492e0: 6e63 7279 7074 6564 2070 6172 7420 6f66  ncrypted part of
│ │ │ │ +000492f0: 2074 6865 2041 532d 5245 502e 0a20 2020   the AS-REP..   
│ │ │ │ +00049300: 2020 5041 5353 574f 5244 3a20 7573 6572    PASSWORD: user
│ │ │ │ +00049310: 2773 2070 6173 7377 6f72 642c 2075 7365  's password, use
│ │ │ │ +00049320: 6420 6966 206b 6579 2069 7320 4e55 4c4c  d if key is NULL
│ │ │ │ +00049330: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ +00049340: 7469 6f6e 3a2a 2050 726f 6365 7373 206e  tion:* Process n
│ │ │ │ +00049350: 6577 2041 532d 5245 5020 616e 6420 7365  ew AS-REP and se
│ │ │ │ +00049360: 7420 7469 636b 6574 2e20 2054 6865 206b  t ticket.  The k
│ │ │ │ +00049370: 6579 2069 7320 7573 6564 0a20 2020 2020  ey is used.     
│ │ │ │ +00049380: 746f 2064 6563 7279 7074 2074 6865 2041  to decrypt the A
│ │ │ │ +00049390: 502d 5245 502e 2049 6620 626f 7468 206b  P-REP. If both k
│ │ │ │ +000493a0: 6579 2061 6e64 2070 6173 7377 6f72 6420  ey and password 
│ │ │ │ +000493b0: 6973 204e 554c 4c2c 2074 6865 2075 7365  is NULL, the use
│ │ │ │ +000493c0: 720a 2020 2020 2069 7320 7175 6572 6965  r.     is querie
│ │ │ │ +000493d0: 6420 666f 7220 6974 2e0a 0a20 2020 2020  d for it...     
│ │ │ │ +000493e0: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ +000493f0: 5265 7475 726e 7320 5348 4953 4849 5f4f  Returns SHISHI_O
│ │ │ │ +00049400: 4b20 6966 6620 7375 6363 6573 7366 756c  K iff successful
│ │ │ │ +00049410: 2e0a 0a73 6869 7368 695f 6173 5f72 6570  ...shishi_as_rep
│ │ │ │ +00049420: 5f62 7569 6c64 0a2d 2d2d 2d2d 2d2d 2d2d  _build.---------
│ │ │ │ +00049430: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +00049440: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ +00049450: 6973 6869 5f61 735f 7265 705f 6275 696c  ishi_as_rep_buil
│ │ │ │ +00049460: 6420 2853 6869 7368 695f 6173 202a 2041  d (Shishi_as * A
│ │ │ │ +00049470: 532c 2053 6869 7368 695f 6b65 7920 2a20  S, Shishi_key * 
│ │ │ │ +00049480: 4b45 5929 0a20 2020 2020 4153 3a20 7374  KEY).     AS: st
│ │ │ │ +00049490: 7275 6374 7572 6520 7468 6174 2068 6f6c  ructure that hol
│ │ │ │ +000494a0: 6473 2069 6e66 6f72 6d61 7469 6f6e 2061  ds information a
│ │ │ │ +000494b0: 626f 7574 2041 5320 6578 6368 616e 6765  bout AS exchange
│ │ │ │ +000494c0: 0a20 2020 2020 4b45 593a 2075 7365 7227  .     KEY: user'
│ │ │ │ +000494d0: 7320 6b65 792c 2075 7365 6420 746f 2065  s key, used to e
│ │ │ │ +000494e0: 6e63 7279 7074 2074 6865 2065 6e63 7279  ncrypt the encry
│ │ │ │ +000494f0: 7074 6564 2070 6172 7420 6f66 2074 6865  pted part of the
│ │ │ │ +00049500: 2041 532d 5245 502e 0a0a 2020 2020 202a   AS-REP...     *
│ │ │ │ +00049510: 4465 7363 7269 7074 696f 6e3a 2a20 4275  Description:* Bu
│ │ │ │ +00049520: 696c 6420 4153 2d52 4550 2e0a 0a20 2020  ild AS-REP...   
│ │ │ │ +00049530: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ +00049540: 2a20 5265 7475 726e 7320 5348 4953 4849  * Returns SHISHI
│ │ │ │ +00049550: 5f4f 4b20 6966 6620 7375 6363 6573 7366  _OK iff successf
│ │ │ │ +00049560: 756c 2e0a 0a73 6869 7368 695f 6173 5f72  ul...shishi_as_r
│ │ │ │ +00049570: 6570 5f64 6572 0a2d 2d2d 2d2d 2d2d 2d2d  ep_der.---------
│ │ │ │ +00049580: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ +00049590: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ +000495a0: 6869 5f61 735f 7265 705f 6465 7220 2853  hi_as_rep_der (S
│ │ │ │ +000495b0: 6869 7368 695f 6173 202a 2041 532c 2063  hishi_as * AS, c
│ │ │ │ +000495c0: 6861 7220 2a2a 204f 5554 2c0a 2020 2020  har ** OUT,.    
│ │ │ │ +000495d0: 2020 2020 2020 7369 7a65 5f74 202a 204f        size_t * O
│ │ │ │ +000495e0: 5554 4c45 4e29 0a20 2020 2020 4153 3a20  UTLEN).     AS: 
│ │ │ │ +000495f0: 7374 7275 6374 7572 6520 7468 6174 2068  structure that h
│ │ │ │ +00049600: 6f6c 6473 2069 6e66 6f72 6d61 7469 6f6e  olds information
│ │ │ │ +00049610: 2061 626f 7574 2041 5320 6578 6368 616e   about AS exchan
│ │ │ │ +00049620: 6765 0a20 2020 2020 4f55 543a 206f 7574  ge.     OUT: out
│ │ │ │ +00049630: 7075 7420 6172 7261 7920 7769 7468 206e  put array with n
│ │ │ │ +00049640: 6577 6c79 2061 6c6c 6f63 6174 6564 2044  ewly allocated D
│ │ │ │ +00049650: 4552 2065 6e63 6f64 696e 6720 6f66 2041  ER encoding of A
│ │ │ │ +00049660: 532d 5245 502e 0a20 2020 2020 4f55 544c  S-REP..     OUTL
│ │ │ │ +00049670: 454e 3a20 6c65 6e67 7468 206f 6620 6f75  EN: length of ou
│ │ │ │ +00049680: 7470 7574 2061 7272 6179 2077 6974 6820  tput array with 
│ │ │ │ +00049690: 4445 5220 656e 636f 6469 6e67 206f 6620  DER encoding of 
│ │ │ │ +000496a0: 4153 2d52 4550 2e0a 0a20 2020 2020 2a44  AS-REP...     *D
│ │ │ │ +000496b0: 6573 6372 6970 7469 6f6e 3a2a 2044 4552  escription:* DER
│ │ │ │ +000496c0: 2065 6e63 6f64 6520 4153 2d52 4550 2e20   encode AS-REP. 
│ │ │ │ +000496d0: 4f55 5420 6973 2061 6c6c 6f63 6174 6564  OUT is allocated
│ │ │ │ +000496e0: 2062 7920 7468 6973 0a20 2020 2020 6675   by this.     fu
│ │ │ │ +000496f0: 6e63 7469 6f6e 2c20 616e 6420 6974 2069  nction, and it i
│ │ │ │ +00049700: 7320 7468 6520 7265 7370 6f6e 7369 6269  s the responsibi
│ │ │ │ +00049710: 6c69 7479 206f 6620 6361 6c6c 6572 2074  lity of caller t
│ │ │ │ +00049720: 6f20 6465 616c 6c6f 6361 7465 2069 742e  o deallocate it.
│ │ │ │ +00049730: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ +00049740: 616c 7565 3a2a 2052 6574 7572 6e73 2053  alue:* Returns S
│ │ │ │ +00049750: 4849 5348 495f 4f4b 2069 6666 2073 7563  HISHI_OK iff suc
│ │ │ │ +00049760: 6365 7373 6675 6c2e 0a0a 7368 6973 6869  cessful...shishi
│ │ │ │ +00049770: 5f61 735f 7265 705f 7365 740a 2d2d 2d2d  _as_rep_set.----
│ │ │ │ +00049780: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ +00049790: 2d2d 2046 756e 6374 696f 6e3a 2076 6f69  -- Function: voi
│ │ │ │ +000497a0: 6420 7368 6973 6869 5f61 735f 7265 705f  d shishi_as_rep_
│ │ │ │ +000497b0: 7365 7420 2853 6869 7368 695f 6173 202a  set (Shishi_as *
│ │ │ │ +000497c0: 2041 532c 2053 6869 7368 695f 6173 6e31   AS, Shishi_asn1
│ │ │ │ +000497d0: 2041 5352 4550 290a 2020 2020 2041 533a   ASREP).     AS:
│ │ │ │ +000497e0: 2073 7472 7563 7475 7265 2074 6861 7420   structure that 
│ │ │ │ +000497f0: 686f 6c64 7320 696e 666f 726d 6174 696f  holds informatio
│ │ │ │ +00049800: 6e20 6162 6f75 7420 4153 2065 7863 6861  n about AS excha
│ │ │ │ +00049810: 6e67 650a 2020 2020 2041 5352 4550 3a20  nge.     ASREP: 
│ │ │ │ +00049820: 6173 7265 7020 746f 2073 746f 7265 2069  asrep to store i
│ │ │ │ +00049830: 6e20 4153 2e0a 0a20 2020 2020 2a44 6573  n AS...     *Des
│ │ │ │ +00049840: 6372 6970 7469 6f6e 3a2a 2053 6574 2074  cription:* Set t
│ │ │ │ +00049850: 6865 2041 532d 5245 5020 696e 2074 6865  he AS-REP in the
│ │ │ │ +00049860: 2041 5320 6578 6368 616e 6765 2e0a 0a73   AS exchange...s
│ │ │ │ +00049870: 6869 7368 695f 6173 5f72 6570 5f64 6572  hishi_as_rep_der
│ │ │ │ +00049880: 5f73 6574 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  _set.-----------
│ │ │ │ +00049890: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +000498a0: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ +000498b0: 6973 6869 5f61 735f 7265 705f 6465 725f  ishi_as_rep_der_
│ │ │ │ +000498c0: 7365 7420 2853 6869 7368 695f 6173 202a  set (Shishi_as *
│ │ │ │ +000498d0: 2041 532c 2063 6861 7220 2a20 4445 522c   AS, char * DER,
│ │ │ │ +000498e0: 0a20 2020 2020 2020 2020 2073 697a 655f  .          size_
│ │ │ │ +000498f0: 7420 4445 524c 454e 290a 2020 2020 2041  t DERLEN).     A
│ │ │ │ +00049900: 533a 2073 7472 7563 7475 7265 2074 6861  S: structure tha
│ │ │ │ +00049910: 7420 686f 6c64 7320 696e 666f 726d 6174  t holds informat
│ │ │ │ +00049920: 696f 6e20 6162 6f75 7420 4153 2065 7863  ion about AS exc
│ │ │ │ +00049930: 6861 6e67 650a 2020 2020 2044 4552 3a20  hange.     DER: 
│ │ │ │ +00049940: 696e 7075 7420 6172 7261 7920 7769 7468  input array with
│ │ │ │ +00049950: 2044 4552 2065 6e63 6f64 6564 2041 502d   DER encoded AP-
│ │ │ │ +00049960: 5245 502e 0a20 2020 2020 4445 524c 454e  REP..     DERLEN
│ │ │ │ +00049970: 3a20 6c65 6e67 7468 206f 6620 696e 7075  : length of inpu
│ │ │ │ +00049980: 7420 6172 7261 7920 7769 7468 2044 4552  t array with DER
│ │ │ │ +00049990: 2065 6e63 6f64 6564 2041 502d 5245 502e   encoded AP-REP.
│ │ │ │ +000499a0: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ +000499b0: 696f 6e3a 2a20 4445 5220 6465 636f 6465  ion:* DER decode
│ │ │ │ +000499c0: 2041 532d 5245 5020 616e 6420 7365 7420   AS-REP and set 
│ │ │ │ +000499d0: 6974 2041 5320 6578 6368 616e 6765 2e20  it AS exchange. 
│ │ │ │ +000499e0: 2049 660a 2020 2020 2064 6563 6f64 696e   If.     decodin
│ │ │ │ +000499f0: 6720 6661 696c 732c 2074 6865 2041 532d  g fails, the AS-
│ │ │ │ +00049a00: 5245 5020 696e 2074 6865 2041 5320 6578  REP in the AS ex
│ │ │ │ +00049a10: 6368 616e 6765 2072 656d 6169 6e73 2e0a  change remains..
│ │ │ │ +00049a20: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ +00049a30: 6c75 653a 2a20 5265 7475 726e 7320 5348  lue:* Returns SH
│ │ │ │ +00049a40: 4953 4849 5f4f 4b2e 0a0a 7368 6973 6869  ISHI_OK...shishi
│ │ │ │ +00049a50: 5f61 735f 6b72 6265 7272 6f72 0a2d 2d2d  _as_krberror.---
│ │ │ │ +00049a60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +00049a70: 0a20 2d2d 2046 756e 6374 696f 6e3a 2053  . -- Function: S
│ │ │ │ +00049a80: 6869 7368 695f 6173 6e31 2073 6869 7368  hishi_asn1 shish
│ │ │ │ +00049a90: 695f 6173 5f6b 7262 6572 726f 7220 2853  i_as_krberror (S
│ │ │ │ +00049aa0: 6869 7368 695f 6173 202a 2041 5329 0a20  hishi_as * AS). 
│ │ │ │ +00049ab0: 2020 2020 4153 3a20 7374 7275 6374 7572      AS: structur
│ │ │ │ +00049ac0: 6520 7468 6174 2068 6f6c 6473 2069 6e66  e that holds inf
│ │ │ │ +00049ad0: 6f72 6d61 7469 6f6e 2061 626f 7574 2041  ormation about A
│ │ │ │ +00049ae0: 5320 6578 6368 616e 6765 0a0a 2020 2020  S exchange..    
│ │ │ │ +00049af0: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ +00049b00: 4765 7420 4153 4e2e 3120 4b52 422d 4552  Get ASN.1 KRB-ER
│ │ │ │ +00049b10: 524f 5220 7374 7275 6374 7572 6520 6672  ROR structure fr
│ │ │ │ +00049b20: 6f6d 2041 5320 6578 6368 616e 6765 2e0a  om AS exchange..
│ │ │ │ +00049b30: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ +00049b40: 6c75 653a 2a20 5265 7475 726e 7320 7468  lue:* Returns th
│ │ │ │ +00049b50: 6520 7265 6365 6976 6564 204b 5242 2d45  e received KRB-E
│ │ │ │ +00049b60: 5252 4f52 2070 6163 6b65 7420 6672 6f6d  RROR packet from
│ │ │ │ +00049b70: 2074 6865 2041 530a 2020 2020 2065 7863   the AS.     exc
│ │ │ │ +00049b80: 6861 6e67 652c 206f 7220 4e55 4c4c 2069  hange, or NULL i
│ │ │ │ +00049b90: 6620 6e6f 7420 7965 7420 7365 7420 6f72  f not yet set or
│ │ │ │ +00049ba0: 2061 6e20 6572 726f 7220 6f63 6375 7265   an error occure
│ │ │ │ +00049bb0: 642e 0a0a 7368 6973 6869 5f61 735f 6b72  d...shishi_as_kr
│ │ │ │ +00049bc0: 6265 7272 6f72 5f64 6572 0a2d 2d2d 2d2d  berror_der.-----
│ │ │ │ +00049bd0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +00049be0: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ +00049bf0: 2069 6e74 2073 6869 7368 695f 6173 5f6b   int shishi_as_k
│ │ │ │ +00049c00: 7262 6572 726f 725f 6465 7220 2853 6869  rberror_der (Shi
│ │ │ │ +00049c10: 7368 695f 6173 202a 2041 532c 2063 6861  shi_as * AS, cha
│ │ │ │ +00049c20: 7220 2a2a 204f 5554 2c0a 2020 2020 2020  r ** OUT,.      
│ │ │ │ +00049c30: 2020 2020 7369 7a65 5f74 202a 204f 5554      size_t * OUT
│ │ │ │ +00049c40: 4c45 4e29 0a20 2020 2020 4153 3a20 7374  LEN).     AS: st
│ │ │ │ +00049c50: 7275 6374 7572 6520 7468 6174 2068 6f6c  ructure that hol
│ │ │ │ +00049c60: 6473 2069 6e66 6f72 6d61 7469 6f6e 2061  ds information a
│ │ │ │ +00049c70: 626f 7574 2041 5320 6578 6368 616e 6765  bout AS exchange
│ │ │ │ +00049c80: 0a20 2020 2020 4f55 543a 206f 7574 7075  .     OUT: outpu
│ │ │ │ +00049c90: 7420 6172 7261 7920 7769 7468 206e 6577  t array with new
│ │ │ │ +00049ca0: 6c79 2061 6c6c 6f63 6174 6564 2044 4552  ly allocated DER
│ │ │ │ +00049cb0: 2065 6e63 6f64 696e 6720 6f66 204b 5242   encoding of KRB
│ │ │ │ +00049cc0: 2d45 5252 4f52 2e0a 2020 2020 204f 5554  -ERROR..     OUT
│ │ │ │ +00049cd0: 4c45 4e3a 206c 656e 6774 6820 6f66 206f  LEN: length of o
│ │ │ │ +00049ce0: 7574 7075 7420 6172 7261 7920 7769 7468  utput array with
│ │ │ │ +00049cf0: 2044 4552 2065 6e63 6f64 696e 6720 6f66   DER encoding of
│ │ │ │ +00049d00: 204b 5242 2d45 5252 4f52 2e0a 0a20 2020   KRB-ERROR...   
│ │ │ │ +00049d10: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ +00049d20: 2044 4552 2065 6e63 6f64 6520 4b52 422d   DER encode KRB-
│ │ │ │ +00049d30: 4552 524f 522e 204f 5554 2069 7320 616c  ERROR. OUT is al
│ │ │ │ +00049d40: 6c6f 6361 7465 6420 6279 2074 6869 730a  located by this.
│ │ │ │ +00049d50: 2020 2020 2066 756e 6374 696f 6e2c 2061       function, a
│ │ │ │ +00049d60: 6e64 2069 7420 6973 2074 6865 2072 6573  nd it is the res
│ │ │ │ +00049d70: 706f 6e73 6962 696c 6974 7920 6f66 2063  ponsibility of c
│ │ │ │ +00049d80: 616c 6c65 7220 746f 2064 6561 6c6c 6f63  aller to dealloc
│ │ │ │ +00049d90: 6174 6520 6974 2e0a 0a20 2020 2020 2a52  ate it...     *R
│ │ │ │ +00049da0: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +00049db0: 7475 726e 7320 5348 4953 4849 5f4f 4b20  turns SHISHI_OK 
│ │ │ │ +00049dc0: 6966 6620 7375 6363 6573 7366 756c 2e0a  iff successful..
│ │ │ │ +00049dd0: 0a73 6869 7368 695f 6173 5f6b 7262 6572  .shishi_as_krber
│ │ │ │ +00049de0: 726f 725f 7365 740a 2d2d 2d2d 2d2d 2d2d  ror_set.--------
│ │ │ │ +00049df0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ +00049e00: 202d 2d20 4675 6e63 7469 6f6e 3a20 766f   -- Function: vo
│ │ │ │ +00049e10: 6964 2073 6869 7368 695f 6173 5f6b 7262  id shishi_as_krb
│ │ │ │ +00049e20: 6572 726f 725f 7365 7420 2853 6869 7368  error_set (Shish
│ │ │ │ +00049e30: 695f 6173 202a 2041 532c 0a20 2020 2020  i_as * AS,.     
│ │ │ │ +00049e40: 2020 2020 2053 6869 7368 695f 6173 6e31       Shishi_asn1
│ │ │ │ +00049e50: 204b 5242 4552 524f 5229 0a20 2020 2020   KRBERROR).     
│ │ │ │ +00049e60: 4153 3a20 7374 7275 6374 7572 6520 7468  AS: structure th
│ │ │ │ +00049e70: 6174 2068 6f6c 6473 2069 6e66 6f72 6d61  at holds informa
│ │ │ │ +00049e80: 7469 6f6e 2061 626f 7574 2041 5320 6578  tion about AS ex
│ │ │ │ +00049e90: 6368 616e 6765 0a20 2020 2020 4b52 4245  change.     KRBE
│ │ │ │ +00049ea0: 5252 4f52 3a20 6b72 6265 7272 6f72 2074  RROR: krberror t
│ │ │ │ +00049eb0: 6f20 7374 6f72 6520 696e 2041 532e 0a0a  o store in AS...
│ │ │ │ +00049ec0: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ +00049ed0: 6e3a 2a20 5365 7420 7468 6520 4b52 422d  n:* Set the KRB-
│ │ │ │ +00049ee0: 4552 524f 5220 696e 2074 6865 2041 5320  ERROR in the AS 
│ │ │ │ +00049ef0: 6578 6368 616e 6765 2e0a 0a73 6869 7368  exchange...shish
│ │ │ │ +00049f00: 695f 6173 5f74 6b74 0a2d 2d2d 2d2d 2d2d  i_as_tkt.-------
│ │ │ │ +00049f10: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ +00049f20: 7469 6f6e 3a20 5368 6973 6869 5f74 6b74  tion: Shishi_tkt
│ │ │ │ +00049f30: 202a 2073 6869 7368 695f 6173 5f74 6b74   * shishi_as_tkt
│ │ │ │ +00049f40: 2028 5368 6973 6869 5f61 7320 2a20 4153   (Shishi_as * AS
│ │ │ │ +00049f50: 290a 2020 2020 2041 533a 2073 7472 7563  ).     AS: struc
│ │ │ │ +00049f60: 7475 7265 2074 6861 7420 686f 6c64 7320  ture that holds 
│ │ │ │ +00049f70: 696e 666f 726d 6174 696f 6e20 6162 6f75  information abou
│ │ │ │ +00049f80: 7420 4153 2065 7863 6861 6e67 650a 0a20  t AS exchange.. 
│ │ │ │ +00049f90: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ +00049fa0: 3a2a 2047 6574 2054 6963 6b65 7420 696e  :* Get Ticket in
│ │ │ │ +00049fb0: 2041 5320 6578 6368 616e 6765 2e0a 0a20   AS exchange... 
│ │ │ │ +00049fc0: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ +00049fd0: 653a 2a20 5265 7475 726e 7320 7468 6520  e:* Returns the 
│ │ │ │ +00049fe0: 6e65 776c 7920 6163 7175 6972 6564 2074  newly acquired t
│ │ │ │ +00049ff0: 6b74 2066 726f 6d20 7468 6520 4153 0a20  kt from the AS. 
│ │ │ │ +0004a000: 2020 2020 6578 6368 616e 6765 2c20 6f72      exchange, or
│ │ │ │ +0004a010: 204e 554c 4c20 6966 206e 6f74 2079 6574   NULL if not yet
│ │ │ │ +0004a020: 2073 6574 206f 7220 616e 2065 7272 6f72   set or an error
│ │ │ │ +0004a030: 206f 6363 7572 6564 2e0a 0a73 6869 7368   occured...shish
│ │ │ │ +0004a040: 695f 6173 5f74 6b74 5f73 6574 0a2d 2d2d  i_as_tkt_set.---
│ │ │ │ +0004a050: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ +0004a060: 202d 2d20 4675 6e63 7469 6f6e 3a20 766f   -- Function: vo
│ │ │ │ +0004a070: 6964 2073 6869 7368 695f 6173 5f74 6b74  id shishi_as_tkt
│ │ │ │ +0004a080: 5f73 6574 2028 5368 6973 6869 5f61 7320  _set (Shishi_as 
│ │ │ │ +0004a090: 2a20 4153 2c20 5368 6973 6869 5f74 6b74  * AS, Shishi_tkt
│ │ │ │ +0004a0a0: 202a 2054 4b54 290a 2020 2020 2041 533a   * TKT).     AS:
│ │ │ │ +0004a0b0: 2073 7472 7563 7475 7265 2074 6861 7420   structure that 
│ │ │ │ +0004a0c0: 686f 6c64 7320 696e 666f 726d 6174 696f  holds informatio
│ │ │ │ +0004a0d0: 6e20 6162 6f75 7420 4153 2065 7863 6861  n about AS excha
│ │ │ │ +0004a0e0: 6e67 650a 2020 2020 2054 4b54 3a20 746b  nge.     TKT: tk
│ │ │ │ +0004a0f0: 7420 746f 2073 746f 7265 2069 6e20 4153  t to store in AS
│ │ │ │ +0004a100: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ +0004a110: 7469 6f6e 3a2a 2053 6574 2074 6865 2054  tion:* Set the T
│ │ │ │ +0004a120: 6b74 2069 6e20 7468 6520 4153 2065 7863  kt in the AS exc
│ │ │ │ +0004a130: 6861 6e67 652e 0a0a 7368 6973 6869 5f61  hange...shishi_a
│ │ │ │ +0004a140: 735f 7365 6e64 7265 6376 5f68 696e 740a  s_sendrecv_hint.
│ │ │ │  0004a150: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0004a160: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ -0004a170: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ -0004a180: 6173 5f73 656e 6472 6563 765f 6869 6e74  as_sendrecv_hint
│ │ │ │ -0004a190: 2028 5368 6973 6869 5f61 7320 2a20 4153   (Shishi_as * AS
│ │ │ │ -0004a1a0: 2c0a 2020 2020 2020 2020 2020 5368 6973  ,.          Shis
│ │ │ │ -0004a1b0: 6869 5f74 6b74 735f 6869 6e74 202a 2048  hi_tkts_hint * H
│ │ │ │ -0004a1c0: 494e 5429 0a20 2020 2020 4153 3a20 7374  INT).     AS: st
│ │ │ │ -0004a1d0: 7275 6374 7572 6520 7468 6174 2068 6f6c  ructure that hol
│ │ │ │ -0004a1e0: 6473 2069 6e66 6f72 6d61 7469 6f6e 2061  ds information a
│ │ │ │ -0004a1f0: 626f 7574 2041 5320 6578 6368 616e 6765  bout AS exchange
│ │ │ │ -0004a200: 0a20 2020 2020 4849 4e54 3a20 6164 6469  .     HINT: addi
│ │ │ │ -0004a210: 7469 6f6e 616c 2070 6172 616d 6574 6572  tional parameter
│ │ │ │ -0004a220: 7320 7468 6174 206d 6f64 6966 7920 636f  s that modify co
│ │ │ │ -0004a230: 6e6e 6563 7469 6f6e 2062 6568 6176 696f  nnection behavio
│ │ │ │ -0004a240: 7572 2c20 6f72 0a20 2020 2020 e280 984e  ur, or.     ...N
│ │ │ │ -0004a250: 554c 4ce2 8099 2e0a 0a20 2020 2020 2a44  ULL......     *D
│ │ │ │ -0004a260: 6573 6372 6970 7469 6f6e 3a2a 2053 656e  escription:* Sen
│ │ │ │ -0004a270: 6420 4153 2d52 4551 2061 6e64 2072 6563  d AS-REQ and rec
│ │ │ │ -0004a280: 6569 7665 2041 532d 5245 5020 6f72 204b  eive AS-REP or K
│ │ │ │ -0004a290: 5242 2d45 5252 4f52 2e20 5468 6973 2069  RB-ERROR. This i
│ │ │ │ -0004a2a0: 730a 2020 2020 2074 6865 2069 6e69 7469  s.     the initi
│ │ │ │ -0004a2b0: 616c 2061 7574 6865 6e74 6963 6174 696f  al authenticatio
│ │ │ │ -0004a2c0: 6e2c 2075 7375 616c 6c79 2075 7365 6420  n, usually used 
│ │ │ │ -0004a2d0: 746f 2061 6371 7569 7265 2061 2054 6963  to acquire a Tic
│ │ │ │ -0004a2e0: 6b65 740a 2020 2020 2047 7261 6e74 696e  ket.     Grantin
│ │ │ │ -0004a2f0: 6720 5469 636b 6574 2e20 2054 6865 2048  g Ticket.  The H
│ │ │ │ -0004a300: 494e 5420 7374 7275 6374 7572 6520 6361  INT structure ca
│ │ │ │ -0004a310: 6e20 6265 2075 7365 6420 746f 2073 6574  n be used to set
│ │ │ │ -0004a320: 2c20 652e 672e 2c0a 2020 2020 2070 6172  , e.g.,.     par
│ │ │ │ -0004a330: 616d 6574 6572 7320 666f 7220 544c 5320  ameters for TLS 
│ │ │ │ -0004a340: 6175 7468 656e 7469 6361 7469 6f6e 2e0a  authentication..
│ │ │ │ -0004a350: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ -0004a360: 6c75 653a 2a20 5265 7475 726e 7320 5348  lue:* Returns SH
│ │ │ │ -0004a370: 4953 4849 5f4f 4b20 6966 6620 7375 6363  ISHI_OK iff succ
│ │ │ │ -0004a380: 6573 7366 756c 2e0a 0a73 6869 7368 695f  essful...shishi_
│ │ │ │ -0004a390: 6173 5f73 656e 6472 6563 760a 2d2d 2d2d  as_sendrecv.----
│ │ │ │ -0004a3a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -0004a3b0: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ -0004a3c0: 7420 7368 6973 6869 5f61 735f 7365 6e64  t shishi_as_send
│ │ │ │ -0004a3d0: 7265 6376 2028 5368 6973 6869 5f61 7320  recv (Shishi_as 
│ │ │ │ -0004a3e0: 2a20 4153 290a 2020 2020 2041 533a 2073  * AS).     AS: s
│ │ │ │ -0004a3f0: 7472 7563 7475 7265 2074 6861 7420 686f  tructure that ho
│ │ │ │ -0004a400: 6c64 7320 696e 666f 726d 6174 696f 6e20  lds information 
│ │ │ │ -0004a410: 6162 6f75 7420 4153 2065 7863 6861 6e67  about AS exchang
│ │ │ │ -0004a420: 650a 0a20 2020 2020 2a44 6573 6372 6970  e..     *Descrip
│ │ │ │ -0004a430: 7469 6f6e 3a2a 2053 656e 6420 4153 2d52  tion:* Send AS-R
│ │ │ │ -0004a440: 4551 2061 6e64 2072 6563 6569 7665 2041  EQ and receive A
│ │ │ │ -0004a450: 532d 5245 5020 6f72 204b 5242 2d45 5252  S-REP or KRB-ERR
│ │ │ │ -0004a460: 4f52 2e20 5468 6973 2069 730a 2020 2020  OR. This is.    
│ │ │ │ -0004a470: 2074 6865 2069 6e69 7469 616c 2061 7574   the initial aut
│ │ │ │ -0004a480: 6865 6e74 6963 6174 696f 6e2c 2075 7375  hentication, usu
│ │ │ │ -0004a490: 616c 6c79 2075 7365 6420 746f 2061 6371  ally used to acq
│ │ │ │ -0004a4a0: 7569 7265 2061 2054 6963 6b65 740a 2020  uire a Ticket.  
│ │ │ │ -0004a4b0: 2020 2047 7261 6e74 696e 6720 5469 636b     Granting Tick
│ │ │ │ -0004a4c0: 6574 2e0a 0a20 2020 2020 2a52 6574 7572  et...     *Retur
│ │ │ │ -0004a4d0: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ -0004a4e0: 7320 5348 4953 4849 5f4f 4b20 6966 6620  s SHISHI_OK iff 
│ │ │ │ -0004a4f0: 7375 6363 6573 7366 756c 2e0a 0a         successful...
│ │ │ │ +0004a160: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +0004a170: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ +0004a180: 695f 6173 5f73 656e 6472 6563 765f 6869  i_as_sendrecv_hi
│ │ │ │ +0004a190: 6e74 2028 5368 6973 6869 5f61 7320 2a20  nt (Shishi_as * 
│ │ │ │ +0004a1a0: 4153 2c0a 2020 2020 2020 2020 2020 5368  AS,.          Sh
│ │ │ │ +0004a1b0: 6973 6869 5f74 6b74 735f 6869 6e74 202a  ishi_tkts_hint *
│ │ │ │ +0004a1c0: 2048 494e 5429 0a20 2020 2020 4153 3a20   HINT).     AS: 
│ │ │ │ +0004a1d0: 7374 7275 6374 7572 6520 7468 6174 2068  structure that h
│ │ │ │ +0004a1e0: 6f6c 6473 2069 6e66 6f72 6d61 7469 6f6e  olds information
│ │ │ │ +0004a1f0: 2061 626f 7574 2041 5320 6578 6368 616e   about AS exchan
│ │ │ │ +0004a200: 6765 0a20 2020 2020 4849 4e54 3a20 6164  ge.     HINT: ad
│ │ │ │ +0004a210: 6469 7469 6f6e 616c 2070 6172 616d 6574  ditional paramet
│ │ │ │ +0004a220: 6572 7320 7468 6174 206d 6f64 6966 7920  ers that modify 
│ │ │ │ +0004a230: 636f 6e6e 6563 7469 6f6e 2062 6568 6176  connection behav
│ │ │ │ +0004a240: 696f 7572 2c20 6f72 0a20 2020 2020 e280  iour, or.     ..
│ │ │ │ +0004a250: 984e 554c 4ce2 8099 2e0a 0a20 2020 2020  .NULL......     
│ │ │ │ +0004a260: 2a44 6573 6372 6970 7469 6f6e 3a2a 2053  *Description:* S
│ │ │ │ +0004a270: 656e 6420 4153 2d52 4551 2061 6e64 2072  end AS-REQ and r
│ │ │ │ +0004a280: 6563 6569 7665 2041 532d 5245 5020 6f72  eceive AS-REP or
│ │ │ │ +0004a290: 204b 5242 2d45 5252 4f52 2e20 5468 6973   KRB-ERROR. This
│ │ │ │ +0004a2a0: 2069 730a 2020 2020 2074 6865 2069 6e69   is.     the ini
│ │ │ │ +0004a2b0: 7469 616c 2061 7574 6865 6e74 6963 6174  tial authenticat
│ │ │ │ +0004a2c0: 696f 6e2c 2075 7375 616c 6c79 2075 7365  ion, usually use
│ │ │ │ +0004a2d0: 6420 746f 2061 6371 7569 7265 2061 2054  d to acquire a T
│ │ │ │ +0004a2e0: 6963 6b65 740a 2020 2020 2047 7261 6e74  icket.     Grant
│ │ │ │ +0004a2f0: 696e 6720 5469 636b 6574 2e20 2054 6865  ing Ticket.  The
│ │ │ │ +0004a300: 2048 494e 5420 7374 7275 6374 7572 6520   HINT structure 
│ │ │ │ +0004a310: 6361 6e20 6265 2075 7365 6420 746f 2073  can be used to s
│ │ │ │ +0004a320: 6574 2c20 652e 672e 2c0a 2020 2020 2070  et, e.g.,.     p
│ │ │ │ +0004a330: 6172 616d 6574 6572 7320 666f 7220 544c  arameters for TL
│ │ │ │ +0004a340: 5320 6175 7468 656e 7469 6361 7469 6f6e  S authentication
│ │ │ │ +0004a350: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ +0004a360: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ +0004a370: 5348 4953 4849 5f4f 4b20 6966 6620 7375  SHISHI_OK iff su
│ │ │ │ +0004a380: 6363 6573 7366 756c 2e0a 0a73 6869 7368  ccessful...shish
│ │ │ │ +0004a390: 695f 6173 5f73 656e 6472 6563 760a 2d2d  i_as_sendrecv.--
│ │ │ │ +0004a3a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +0004a3b0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +0004a3c0: 696e 7420 7368 6973 6869 5f61 735f 7365  int shishi_as_se
│ │ │ │ +0004a3d0: 6e64 7265 6376 2028 5368 6973 6869 5f61  ndrecv (Shishi_a
│ │ │ │ +0004a3e0: 7320 2a20 4153 290a 2020 2020 2041 533a  s * AS).     AS:
│ │ │ │ +0004a3f0: 2073 7472 7563 7475 7265 2074 6861 7420   structure that 
│ │ │ │ +0004a400: 686f 6c64 7320 696e 666f 726d 6174 696f  holds informatio
│ │ │ │ +0004a410: 6e20 6162 6f75 7420 4153 2065 7863 6861  n about AS excha
│ │ │ │ +0004a420: 6e67 650a 0a20 2020 2020 2a44 6573 6372  nge..     *Descr
│ │ │ │ +0004a430: 6970 7469 6f6e 3a2a 2053 656e 6420 4153  iption:* Send AS
│ │ │ │ +0004a440: 2d52 4551 2061 6e64 2072 6563 6569 7665  -REQ and receive
│ │ │ │ +0004a450: 2041 532d 5245 5020 6f72 204b 5242 2d45   AS-REP or KRB-E
│ │ │ │ +0004a460: 5252 4f52 2e20 5468 6973 2069 730a 2020  RROR. This is.  
│ │ │ │ +0004a470: 2020 2074 6865 2069 6e69 7469 616c 2061     the initial a
│ │ │ │ +0004a480: 7574 6865 6e74 6963 6174 696f 6e2c 2075  uthentication, u
│ │ │ │ +0004a490: 7375 616c 6c79 2075 7365 6420 746f 2061  sually used to a
│ │ │ │ +0004a4a0: 6371 7569 7265 2061 2054 6963 6b65 740a  cquire a Ticket.
│ │ │ │ +0004a4b0: 2020 2020 2047 7261 6e74 696e 6720 5469       Granting Ti
│ │ │ │ +0004a4c0: 636b 6574 2e0a 0a20 2020 2020 2a52 6574  cket...     *Ret
│ │ │ │ +0004a4d0: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ +0004a4e0: 726e 7320 5348 4953 4849 5f4f 4b20 6966  rns SHISHI_OK if
│ │ │ │ +0004a4f0: 6620 7375 6363 6573 7366 756c 2e0a 0a    f successful...
│ │ ├── ./usr/share/info/shishi.info-2.gz
│ │ │ ├── shishi.info-2
│ │ │ │ @@ -1,19218 +1,19218 @@
│ │ │ │  00000000: 5468 6973 2069 7320 7368 6973 6869 2e69  This is shishi.i
│ │ │ │  00000010: 6e66 6f2c 2070 726f 6475 6365 6420 6279  nfo, produced by
│ │ │ │  00000020: 206d 616b 6569 6e66 6f20 7665 7273 696f   makeinfo versio
│ │ │ │  00000030: 6e20 372e 3220 6672 6f6d 2073 6869 7368  n 7.2 from shish
│ │ │ │  00000040: 692e 7465 7869 2e0a 0a54 6869 7320 6d61  i.texi...This ma
│ │ │ │  00000050: 6e75 616c 2069 7320 6c61 7374 2075 7064  nual is last upd
│ │ │ │ -00000060: 6174 6564 2038 204d 6172 6368 2032 3032  ated 8 March 202
│ │ │ │ -00000070: 3620 666f 7220 7665 7273 696f 6e20 312e  6 for version 1.
│ │ │ │ -00000080: 302e 3320 6f66 2053 6869 7368 692e 0a0a  0.3 of Shishi...
│ │ │ │ -00000090: 2020 2043 6f70 7972 6967 6874 20c2 a920     Copyright .. 
│ │ │ │ -000000a0: 3230 3032 2d32 3032 3220 5369 6d6f 6e20  2002-2022 Simon 
│ │ │ │ -000000b0: 4a6f 7365 6673 736f 6e2e 0a0a 2020 2020  Josefsson...    
│ │ │ │ -000000c0: 2050 6572 6d69 7373 696f 6e20 6973 2067   Permission is g
│ │ │ │ -000000d0: 7261 6e74 6564 2074 6f20 636f 7079 2c20  ranted to copy, 
│ │ │ │ -000000e0: 6469 7374 7269 6275 7465 2061 6e64 2f6f  distribute and/o
│ │ │ │ -000000f0: 7220 6d6f 6469 6679 2074 6869 730a 2020  r modify this.  
│ │ │ │ -00000100: 2020 2064 6f63 756d 656e 7420 756e 6465     document unde
│ │ │ │ -00000110: 7220 7468 6520 7465 726d 7320 6f66 2074  r the terms of t
│ │ │ │ -00000120: 6865 2047 4e55 2046 7265 6520 446f 6375  he GNU Free Docu
│ │ │ │ -00000130: 6d65 6e74 6174 696f 6e20 4c69 6365 6e73  mentation Licens
│ │ │ │ -00000140: 652c 0a20 2020 2020 5665 7273 696f 6e20  e,.     Version 
│ │ │ │ -00000150: 312e 3320 6f72 2061 6e79 206c 6174 6572  1.3 or any later
│ │ │ │ -00000160: 2076 6572 7369 6f6e 2070 7562 6c69 7368   version publish
│ │ │ │ -00000170: 6564 2062 7920 7468 6520 4672 6565 2053  ed by the Free S
│ │ │ │ -00000180: 6f66 7477 6172 650a 2020 2020 2046 6f75  oftware.     Fou
│ │ │ │ -00000190: 6e64 6174 696f 6e3b 2077 6974 6820 6e6f  ndation; with no
│ │ │ │ -000001a0: 2049 6e76 6172 6961 6e74 2053 6563 7469   Invariant Secti
│ │ │ │ -000001b0: 6f6e 732c 206e 6f20 4672 6f6e 742d 436f  ons, no Front-Co
│ │ │ │ -000001c0: 7665 7220 5465 7874 732c 2061 6e64 0a20  ver Texts, and. 
│ │ │ │ -000001d0: 2020 2020 6e6f 2042 6163 6b2d 436f 7665      no Back-Cove
│ │ │ │ -000001e0: 7220 5465 7874 732e 2020 4120 636f 7079  r Texts.  A copy
│ │ │ │ -000001f0: 206f 6620 7468 6520 6c69 6365 6e73 6520   of the license 
│ │ │ │ -00000200: 6973 2069 6e63 6c75 6465 6420 696e 2074  is included in t
│ │ │ │ -00000210: 6865 0a20 2020 2020 7365 6374 696f 6e20  he.     section 
│ │ │ │ -00000220: 656e 7469 746c 6564 2022 474e 5520 4672  entitled "GNU Fr
│ │ │ │ -00000230: 6565 2044 6f63 756d 656e 7461 7469 6f6e  ee Documentation
│ │ │ │ -00000240: 204c 6963 656e 7365 222e 0a49 4e46 4f2d   License"..INFO-
│ │ │ │ -00000250: 4449 522d 5345 4354 494f 4e20 474e 5520  DIR-SECTION GNU 
│ │ │ │ -00000260: 7574 696c 6974 6965 730a 5354 4152 542d  utilities.START-
│ │ │ │ -00000270: 494e 464f 2d44 4952 2d45 4e54 5259 0a2a  INFO-DIR-ENTRY.*
│ │ │ │ -00000280: 2073 6869 7368 693a 2028 7368 6973 6869   shishi: (shishi
│ │ │ │ -00000290: 292e 0909 4120 4b65 7262 6572 6f73 2035  )...A Kerberos 5
│ │ │ │ -000002a0: 2069 6d70 6c65 6d65 6e74 6174 696f 6e0a   implementation.
│ │ │ │ -000002b0: 454e 442d 494e 464f 2d44 4952 2d45 4e54  END-INFO-DIR-ENT
│ │ │ │ -000002c0: 5259 0a0a 494e 464f 2d44 4952 2d53 4543  RY..INFO-DIR-SEC
│ │ │ │ -000002d0: 5449 4f4e 2047 4e55 204c 6962 7261 7269  TION GNU Librari
│ │ │ │ -000002e0: 6573 0a53 5441 5254 2d49 4e46 4f2d 4449  es.START-INFO-DI
│ │ │ │ -000002f0: 522d 454e 5452 590a 2a20 6c69 6273 6869  R-ENTRY.* libshi
│ │ │ │ -00000300: 7368 693a 2028 7368 6973 6869 292e 0909  shi: (shishi)...
│ │ │ │ -00000310: 4c69 6272 6172 7920 696d 706c 656d 656e  Library implemen
│ │ │ │ -00000320: 7469 6e67 204b 6572 6265 726f 7320 352e  ting Kerberos 5.
│ │ │ │ -00000330: 0a45 4e44 2d49 4e46 4f2d 4449 522d 454e  .END-INFO-DIR-EN
│ │ │ │ -00000340: 5452 590a 0a1f 0a46 696c 653a 2073 6869  TRY....File: shi
│ │ │ │ -00000350: 7368 692e 696e 666f 2c20 204e 6f64 653a  shi.info,  Node:
│ │ │ │ -00000360: 2054 4753 2046 756e 6374 696f 6e73 2c20   TGS Functions, 
│ │ │ │ -00000370: 204e 6578 743a 2054 6963 6b65 7420 2841   Next: Ticket (A
│ │ │ │ -00000380: 534e 2e31 2920 4675 6e63 7469 6f6e 732c  SN.1) Functions,
│ │ │ │ -00000390: 2020 5072 6576 3a20 4153 2046 756e 6374    Prev: AS Funct
│ │ │ │ -000003a0: 696f 6e73 2c20 2055 703a 2050 726f 6772  ions,  Up: Progr
│ │ │ │ -000003b0: 616d 6d69 6e67 204d 616e 7561 6c0a 0a35  amming Manual..5
│ │ │ │ -000003c0: 2e38 2054 4753 2046 756e 6374 696f 6e73  .8 TGS Functions
│ │ │ │ -000003d0: 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  .===============
│ │ │ │ -000003e0: 3d3d 0a0a 5468 6520 5469 636b 6574 2047  ==..The Ticket G
│ │ │ │ -000003f0: 7261 6e74 696e 6720 5365 7276 6963 6520  ranting Service 
│ │ │ │ -00000400: 2854 4753 2920 6973 2075 7365 6420 746f  (TGS) is used to
│ │ │ │ -00000410: 2067 6574 2073 7562 7365 7175 656e 7420   get subsequent 
│ │ │ │ -00000420: 7469 636b 6574 732c 0a61 7574 6865 6e74  tickets,.authent
│ │ │ │ -00000430: 6963 6174 6564 2062 7920 6f74 6865 7220  icated by other 
│ │ │ │ -00000440: 7469 636b 6574 7320 2873 6f20 6361 6c6c  tickets (so call
│ │ │ │ -00000450: 6564 2074 6963 6b65 7420 6772 616e 7469  ed ticket granti
│ │ │ │ -00000460: 6e67 2074 6963 6b65 7473 292e 2020 5468  ng tickets).  Th
│ │ │ │ -00000470: 650a 666f 6c6c 6f77 696e 6720 696c 6c75  e.following illu
│ │ │ │ -00000480: 7374 7261 7465 7320 7468 6520 5447 532d  strates the TGS-
│ │ │ │ -00000490: 5245 5120 616e 6420 5447 532d 5245 5020  REQ and TGS-REP 
│ │ │ │ -000004a0: 4153 4e2e 3120 7374 7275 6374 7572 6573  ASN.1 structures
│ │ │ │ -000004b0: 2e0a 0a2d 2d20 5265 7175 6573 7420 2d2d  ...-- Request --
│ │ │ │ -000004c0: 0a0a 5447 532d 5245 5109 093a 3a3d 204b  ..TGS-REQ..::= K
│ │ │ │ -000004d0: 4443 2d52 4551 207b 3132 7d0a 0a4b 4443  DC-REQ {12}..KDC
│ │ │ │ -000004e0: 2d52 4551 207b 494e 5445 4745 523a 7461  -REQ {INTEGER:ta
│ │ │ │ -000004f0: 676e 756d 7d09 3a3a 3d20 5b41 5050 4c49  gnum}.::= [APPLI
│ │ │ │ -00000500: 4341 5449 4f4e 2074 6167 6e75 6d5d 2053  CATION tagnum] S
│ │ │ │ -00000510: 4551 5545 4e43 4520 7b0a 0970 766e 6f09  EQUENCE {..pvno.
│ │ │ │ -00000520: 095b 315d 2049 4e54 4547 4552 2028 3529  .[1] INTEGER (5)
│ │ │ │ -00000530: 202d 2d20 6669 7273 7420 7461 6720 6973   -- first tag is
│ │ │ │ -00000540: 205b 315d 2c20 6e6f 7420 5b30 5d20 2d2d   [1], not [0] --
│ │ │ │ -00000550: 2c0a 096d 7367 2d74 7970 6509 5b32 5d20  ,..msg-type.[2] 
│ │ │ │ -00000560: 494e 5445 4745 5220 2874 6167 6e75 6d29  INTEGER (tagnum)
│ │ │ │ -00000570: 2c0a 0970 6164 6174 6109 095b 335d 2053  ,..padata..[3] S
│ │ │ │ -00000580: 4551 5545 4e43 4520 4f46 2050 412d 4441  EQUENCE OF PA-DA
│ │ │ │ -00000590: 5441 204f 5054 494f 4e41 4c2c 0a09 7265  TA OPTIONAL,..re
│ │ │ │ -000005a0: 712d 626f 6479 095b 345d 204b 4443 2d52  q-body.[4] KDC-R
│ │ │ │ -000005b0: 4551 2d42 4f44 590a 7d0a 0a4b 4443 2d52  EQ-BODY.}..KDC-R
│ │ │ │ -000005c0: 4551 2d42 4f44 5909 3a3a 3d20 5345 5155  EQ-BODY.::= SEQU
│ │ │ │ -000005d0: 454e 4345 207b 0a09 6b64 632d 6f70 7469  ENCE {..kdc-opti
│ │ │ │ -000005e0: 6f6e 7309 095b 305d 204b 4443 4f70 7469  ons..[0] KDCOpti
│ │ │ │ -000005f0: 6f6e 732c 0a09 636e 616d 6509 0909 5b31  ons,..cname...[1
│ │ │ │ -00000600: 5d20 5072 696e 6369 7061 6c4e 616d 6520  ] PrincipalName 
│ │ │ │ -00000610: 4f50 5449 4f4e 414c 0a09 0909 0920 2020  OPTIONAL.....   
│ │ │ │ -00000620: 202d 2d20 5573 6564 206f 6e6c 7920 696e   -- Used only in
│ │ │ │ -00000630: 2041 532d 5245 5120 2d2d 2c0a 0972 6561   AS-REQ --,..rea
│ │ │ │ -00000640: 6c6d 0909 095b 325d 2052 6561 6c6d 0a09  lm...[2] Realm..
│ │ │ │ -00000650: 0909 0920 2020 202d 2d20 5365 7276 6572  ...    -- Server
│ │ │ │ -00000660: 2773 2072 6561 6c6d 0a09 0909 0920 2020  's realm.....   
│ │ │ │ -00000670: 202d 2d20 416c 736f 2063 6c69 656e 7427   -- Also client'
│ │ │ │ -00000680: 7320 696e 2041 532d 5245 5120 2d2d 2c0a  s in AS-REQ --,.
│ │ │ │ -00000690: 0973 6e61 6d65 0909 095b 335d 2050 7269  .sname...[3] Pri
│ │ │ │ -000006a0: 6e63 6970 616c 4e61 6d65 204f 5054 494f  ncipalName OPTIO
│ │ │ │ -000006b0: 4e41 4c2c 0a09 6672 6f6d 0909 095b 345d  NAL,..from...[4]
│ │ │ │ -000006c0: 204b 6572 6265 726f 7354 696d 6520 4f50   KerberosTime OP
│ │ │ │ -000006d0: 5449 4f4e 414c 2c0a 0974 696c 6c09 0909  TIONAL,..till...
│ │ │ │ -000006e0: 5b35 5d20 4b65 7262 6572 6f73 5469 6d65  [5] KerberosTime
│ │ │ │ -000006f0: 2c0a 0972 7469 6d65 0909 095b 365d 204b  ,..rtime...[6] K
│ │ │ │ -00000700: 6572 6265 726f 7354 696d 6520 4f50 5449  erberosTime OPTI
│ │ │ │ -00000710: 4f4e 414c 2c0a 096e 6f6e 6365 0909 095b  ONAL,..nonce...[
│ │ │ │ -00000720: 375d 2055 496e 7433 322c 0a09 6574 7970  7] UInt32,..etyp
│ │ │ │ -00000730: 6509 0909 5b38 5d20 5345 5155 454e 4345  e...[8] SEQUENCE
│ │ │ │ -00000740: 204f 4620 496e 7433 3220 2d2d 2045 6e63   OF Int32 -- Enc
│ │ │ │ -00000750: 7279 7074 696f 6e54 7970 650a 0909 0909  ryptionType.....
│ │ │ │ -00000760: 2020 2020 2d2d 2069 6e20 7072 6566 6572      -- in prefer
│ │ │ │ -00000770: 656e 6365 206f 7264 6572 202d 2d2c 0a09  ence order --,..
│ │ │ │ -00000780: 6164 6472 6573 7365 7309 095b 395d 2048  addresses..[9] H
│ │ │ │ -00000790: 6f73 7441 6464 7265 7373 6573 204f 5054  ostAddresses OPT
│ │ │ │ -000007a0: 494f 4e41 4c2c 0a09 656e 632d 6175 7468  IONAL,..enc-auth
│ │ │ │ -000007b0: 6f72 697a 6174 696f 6e2d 6461 7461 095b  orization-data.[
│ │ │ │ -000007c0: 3130 5d20 456e 6372 7970 7465 6444 6174  10] EncryptedDat
│ │ │ │ -000007d0: 6120 7b0a 0909 0909 0941 7574 686f 7269  a {......Authori
│ │ │ │ -000007e0: 7a61 7469 6f6e 4461 7461 2c0a 0909 0909  zationData,.....
│ │ │ │ -000007f0: 097b 206b 6579 7573 652d 5447 5352 6571  .{ keyuse-TGSReq
│ │ │ │ -00000800: 4175 7468 4461 7461 2d73 6573 736b 6579  AuthData-sesskey
│ │ │ │ -00000810: 0a09 0909 0909 2020 7c20 6b65 7975 7365  ......  | keyuse
│ │ │ │ -00000820: 2d54 4753 5265 7141 7574 6844 6174 612d  -TGSReqAuthData-
│ │ │ │ -00000830: 7375 626b 6579 207d 0a09 0909 0920 2020  subkey }.....   
│ │ │ │ -00000840: 2020 7d20 4f50 5449 4f4e 414c 2c0a 0961    } OPTIONAL,..a
│ │ │ │ -00000850: 6464 6974 696f 6e61 6c2d 7469 636b 6574  dditional-ticket
│ │ │ │ -00000860: 7309 5b31 315d 2053 4551 5545 4e43 4520  s.[11] SEQUENCE 
│ │ │ │ -00000870: 4f46 2054 6963 6b65 7420 4f50 5449 4f4e  OF Ticket OPTION
│ │ │ │ -00000880: 414c 0a7d 0a0a 2d2d 2052 6570 6c79 202d  AL.}..-- Reply -
│ │ │ │ -00000890: 2d0a 0a54 4753 2d52 4550 0909 3a3a 3d20  -..TGS-REP..::= 
│ │ │ │ -000008a0: 4b44 432d 5245 5020 7b31 332c 2045 6e63  KDC-REP {13, Enc
│ │ │ │ -000008b0: 5447 5352 6570 5061 7274 2c0a 0909 097b  TGSRepPart,....{
│ │ │ │ -000008c0: 206b 6579 7573 652d 456e 6354 4753 5265   keyuse-EncTGSRe
│ │ │ │ -000008d0: 7050 6172 742d 7365 7373 6b65 790a 0909  pPart-sesskey...
│ │ │ │ -000008e0: 0920 207c 206b 6579 7573 652d 456e 6354  .  | keyuse-EncT
│ │ │ │ -000008f0: 4753 5265 7050 6172 742d 7375 626b 6579  GSRepPart-subkey
│ │ │ │ -00000900: 207d 7d0a 0a4b 4443 2d52 4550 207b 494e   }}..KDC-REP {IN
│ │ │ │ -00000910: 5445 4745 523a 7461 676e 756d 2c0a 0920  TEGER:tagnum,.. 
│ │ │ │ -00000920: 5479 7065 546f 456e 6372 7970 742c 0a09  TypeToEncrypt,..
│ │ │ │ -00000930: 2055 496e 7433 323a 4b65 7955 7361 6765   UInt32:KeyUsage
│ │ │ │ -00000940: 737d 093a 3a3d 205b 4150 504c 4943 4154  s}.::= [APPLICAT
│ │ │ │ -00000950: 494f 4e20 7461 676e 756d 5d20 5345 5155  ION tagnum] SEQU
│ │ │ │ -00000960: 454e 4345 207b 0a09 7076 6e6f 0909 5b30  ENCE {..pvno..[0
│ │ │ │ -00000970: 5d20 494e 5445 4745 5220 2835 292c 0a09  ] INTEGER (5),..
│ │ │ │ -00000980: 6d73 672d 7479 7065 095b 315d 2049 4e54  msg-type.[1] INT
│ │ │ │ -00000990: 4547 4552 2028 7461 676e 756d 292c 0a09  EGER (tagnum),..
│ │ │ │ -000009a0: 7061 6461 7461 0909 5b32 5d20 5345 5155  padata..[2] SEQU
│ │ │ │ -000009b0: 454e 4345 204f 4620 5041 2d44 4154 4120  ENCE OF PA-DATA 
│ │ │ │ -000009c0: 4f50 5449 4f4e 414c 2c0a 0963 7265 616c  OPTIONAL,..creal
│ │ │ │ -000009d0: 6d09 095b 335d 2052 6561 6c6d 2c0a 0963  m..[3] Realm,..c
│ │ │ │ -000009e0: 6e61 6d65 0909 5b34 5d20 5072 696e 6369  name..[4] Princi
│ │ │ │ -000009f0: 7061 6c4e 616d 652c 0a09 7469 636b 6574  palName,..ticket
│ │ │ │ -00000a00: 0909 5b35 5d20 5469 636b 6574 2c0a 0965  ..[5] Ticket,..e
│ │ │ │ -00000a10: 6e63 2d70 6172 7409 5b36 5d20 456e 6372  nc-part.[6] Encr
│ │ │ │ -00000a20: 7970 7465 6444 6174 6120 7b54 7970 6554  yptedData {TypeT
│ │ │ │ -00000a30: 6f45 6e63 7279 7074 2c20 4b65 7955 7361  oEncrypt, KeyUsa
│ │ │ │ -00000a40: 6765 737d 0a7d 0a0a 456e 6354 4753 5265  ges}.}..EncTGSRe
│ │ │ │ -00000a50: 7050 6172 7409 3a3a 3d20 5b41 5050 4c49  pPart.::= [APPLI
│ │ │ │ -00000a60: 4341 5449 4f4e 2032 365d 2045 6e63 4b44  CATION 26] EncKD
│ │ │ │ -00000a70: 4352 6570 5061 7274 0a0a 456e 634b 4443  CRepPart..EncKDC
│ │ │ │ -00000a80: 5265 7050 6172 7409 3a3a 3d20 5345 5155  RepPart.::= SEQU
│ │ │ │ -00000a90: 454e 4345 207b 0a09 6b65 7909 095b 305d  ENCE {..key..[0]
│ │ │ │ -00000aa0: 2045 6e63 7279 7074 696f 6e4b 6579 2c0a   EncryptionKey,.
│ │ │ │ -00000ab0: 096c 6173 742d 7265 7109 5b31 5d20 4c61  .last-req.[1] La
│ │ │ │ -00000ac0: 7374 5265 712c 0a09 6e6f 6e63 6509 095b  stReq,..nonce..[
│ │ │ │ -00000ad0: 325d 2055 496e 7433 322c 0a09 6b65 792d  2] UInt32,..key-
│ │ │ │ -00000ae0: 6578 7069 7261 7469 6f6e 095b 335d 204b  expiration.[3] K
│ │ │ │ -00000af0: 6572 6265 726f 7354 696d 6520 4f50 5449  erberosTime OPTI
│ │ │ │ -00000b00: 4f4e 414c 2c0a 0966 6c61 6773 0909 5b34  ONAL,..flags..[4
│ │ │ │ -00000b10: 5d20 5469 636b 6574 466c 6167 732c 0a09  ] TicketFlags,..
│ │ │ │ -00000b20: 6175 7468 7469 6d65 095b 355d 204b 6572  authtime.[5] Ker
│ │ │ │ -00000b30: 6265 726f 7354 696d 652c 0a09 7374 6172  berosTime,..star
│ │ │ │ -00000b40: 7474 696d 6509 5b36 5d20 4b65 7262 6572  ttime.[6] Kerber
│ │ │ │ -00000b50: 6f73 5469 6d65 204f 5054 494f 4e41 4c2c  osTime OPTIONAL,
│ │ │ │ -00000b60: 0a09 656e 6474 696d 6509 095b 375d 204b  ..endtime..[7] K
│ │ │ │ -00000b70: 6572 6265 726f 7354 696d 652c 0a09 7265  erberosTime,..re
│ │ │ │ -00000b80: 6e65 772d 7469 6c6c 095b 385d 204b 6572  new-till.[8] Ker
│ │ │ │ -00000b90: 6265 726f 7354 696d 6520 4f50 5449 4f4e  berosTime OPTION
│ │ │ │ -00000ba0: 414c 2c0a 0973 7265 616c 6d09 095b 395d  AL,..srealm..[9]
│ │ │ │ -00000bb0: 2052 6561 6c6d 2c0a 0973 6e61 6d65 0909   Realm,..sname..
│ │ │ │ -00000bc0: 5b31 305d 2050 7269 6e63 6970 616c 4e61  [10] PrincipalNa
│ │ │ │ -00000bd0: 6d65 2c0a 0963 6164 6472 0909 5b31 315d  me,..caddr..[11]
│ │ │ │ -00000be0: 2048 6f73 7441 6464 7265 7373 6573 204f   HostAddresses O
│ │ │ │ -00000bf0: 5054 494f 4e41 4c0a 7d0a 0a73 6869 7368  PTIONAL.}..shish
│ │ │ │ -00000c00: 695f 7467 730a 2d2d 2d2d 2d2d 2d2d 2d2d  i_tgs.----------
│ │ │ │ -00000c10: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ -00000c20: 696e 7420 7368 6973 6869 5f74 6773 2028  int shishi_tgs (
│ │ │ │ -00000c30: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ -00000c40: 2053 6869 7368 695f 7467 7320 2a2a 2054   Shishi_tgs ** T
│ │ │ │ -00000c50: 4753 290a 2020 2020 2048 414e 444c 453a  GS).     HANDLE:
│ │ │ │ -00000c60: 2073 6869 7368 6920 6861 6e64 6c65 2061   shishi handle a
│ │ │ │ -00000c70: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ -00000c80: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ -00000c90: 8099 2e0a 2020 2020 2054 4753 3a20 686f  ....     TGS: ho
│ │ │ │ -00000ca0: 6c64 7320 706f 696e 7465 7220 746f 206e  lds pointer to n
│ │ │ │ -00000cb0: 6577 6c79 2061 6c6c 6f63 6174 6520 5368  ewly allocate Sh
│ │ │ │ -00000cc0: 6973 6869 5f74 6773 2073 7472 7563 7475  ishi_tgs structu
│ │ │ │ -00000cd0: 7265 2e0a 0a20 2020 2020 2a44 6573 6372  re...     *Descr
│ │ │ │ -00000ce0: 6970 7469 6f6e 3a2a 2041 6c6c 6f63 6174  iption:* Allocat
│ │ │ │ -00000cf0: 6520 6120 6e65 7720 5447 5320 6578 6368  e a new TGS exch
│ │ │ │ -00000d00: 616e 6765 2076 6172 6961 626c 652e 0a0a  ange variable...
│ │ │ │ -00000d10: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ -00000d20: 7565 3a2a 2052 6574 7572 6e73 2053 4849  ue:* Returns SHI
│ │ │ │ -00000d30: 5348 495f 4f4b 2069 6666 2073 7563 6365  SHI_OK iff succe
│ │ │ │ -00000d40: 7373 6675 6c2e 0a0a 7368 6973 6869 5f74  ssful...shishi_t
│ │ │ │ -00000d50: 6773 5f64 6f6e 650a 2d2d 2d2d 2d2d 2d2d  gs_done.--------
│ │ │ │ -00000d60: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ -00000d70: 6374 696f 6e3a 2076 6f69 6420 7368 6973  ction: void shis
│ │ │ │ -00000d80: 6869 5f74 6773 5f64 6f6e 6520 2853 6869  hi_tgs_done (Shi
│ │ │ │ -00000d90: 7368 695f 7467 7320 2a20 5447 5329 0a20  shi_tgs * TGS). 
│ │ │ │ -00000da0: 2020 2020 5447 533a 2073 7472 7563 7475      TGS: structu
│ │ │ │ -00000db0: 7265 2074 6861 7420 686f 6c64 7320 696e  re that holds in
│ │ │ │ -00000dc0: 666f 726d 6174 696f 6e20 6162 6f75 7420  formation about 
│ │ │ │ -00000dd0: 4153 2065 7863 6861 6e67 650a 0a20 2020  AS exchange..   
│ │ │ │ -00000de0: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ -00000df0: 2044 6561 6c6c 6f63 6174 6520 7265 736f   Deallocate reso
│ │ │ │ -00000e00: 7572 6365 7320 6173 736f 6369 6174 6564  urces associated
│ │ │ │ -00000e10: 2077 6974 6820 5447 5320 6578 6368 616e   with TGS exchan
│ │ │ │ -00000e20: 6765 2e0a 2020 2020 2054 6869 7320 7368  ge..     This sh
│ │ │ │ -00000e30: 6f75 6c64 2062 6520 6361 6c6c 6564 2062  ould be called b
│ │ │ │ -00000e40: 7920 7468 6520 6170 706c 6963 6174 696f  y the applicatio
│ │ │ │ -00000e50: 6e20 7768 656e 2069 7420 6e6f 206c 6f6e  n when it no lon
│ │ │ │ -00000e60: 6765 7220 6e65 6564 2074 6f0a 2020 2020  ger need to.    
│ │ │ │ -00000e70: 2075 7469 6c69 7a65 2074 6865 2054 4753   utilize the TGS
│ │ │ │ -00000e80: 2065 7863 6861 6e67 6520 6861 6e64 6c65   exchange handle
│ │ │ │ -00000e90: 2e0a 0a73 6869 7368 695f 7467 735f 7467  ...shishi_tgs_tg
│ │ │ │ -00000ea0: 746b 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  tkt.------------
│ │ │ │ -00000eb0: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -00000ec0: 6f6e 3a20 5368 6973 6869 5f74 6b74 202a  on: Shishi_tkt *
│ │ │ │ -00000ed0: 2073 6869 7368 695f 7467 735f 7467 746b   shishi_tgs_tgtk
│ │ │ │ -00000ee0: 7420 2853 6869 7368 695f 7467 7320 2a20  t (Shishi_tgs * 
│ │ │ │ -00000ef0: 5447 5329 0a20 2020 2020 5447 533a 2073  TGS).     TGS: s
│ │ │ │ -00000f00: 7472 7563 7475 7265 2074 6861 7420 686f  tructure that ho
│ │ │ │ -00000f10: 6c64 7320 696e 666f 726d 6174 696f 6e20  lds information 
│ │ │ │ -00000f20: 6162 6f75 7420 5447 5320 6578 6368 616e  about TGS exchan
│ │ │ │ -00000f30: 6765 0a0a 2020 2020 202a 4465 7363 7269  ge..     *Descri
│ │ │ │ -00000f40: 7074 696f 6e3a 2a20 4765 7420 5469 636b  ption:* Get Tick
│ │ │ │ -00000f50: 6574 2d67 7261 6e74 696e 672d 7469 636b  et-granting-tick
│ │ │ │ -00000f60: 6574 2066 726f 6d20 5447 5320 6578 6368  et from TGS exch
│ │ │ │ -00000f70: 616e 6765 2e0a 0a20 2020 2020 2a52 6574  ange...     *Ret
│ │ │ │ -00000f80: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ -00000f90: 726e 7320 7468 6520 7469 636b 6574 2d67  rns the ticket-g
│ │ │ │ -00000fa0: 7261 6e74 696e 672d 7469 636b 6574 2075  ranting-ticket u
│ │ │ │ -00000fb0: 7365 6420 696e 2074 6865 2054 4753 0a20  sed in the TGS. 
│ │ │ │ -00000fc0: 2020 2020 6578 6368 616e 6765 2c20 6f72      exchange, or
│ │ │ │ -00000fd0: 204e 554c 4c20 6966 206e 6f74 2079 6574   NULL if not yet
│ │ │ │ -00000fe0: 2073 6574 206f 7220 616e 2065 7272 6f72   set or an error
│ │ │ │ -00000ff0: 206f 6363 7572 6564 2e0a 0a73 6869 7368   occured...shish
│ │ │ │ -00001000: 695f 7467 735f 7467 746b 745f 7365 740a  i_tgs_tgtkt_set.
│ │ │ │ -00001010: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00001020: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -00001030: 6f6e 3a20 766f 6964 2073 6869 7368 695f  on: void shishi_
│ │ │ │ -00001040: 7467 735f 7467 746b 745f 7365 7420 2853  tgs_tgtkt_set (S
│ │ │ │ -00001050: 6869 7368 695f 7467 7320 2a20 5447 532c  hishi_tgs * TGS,
│ │ │ │ -00001060: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ -00001070: 695f 746b 7420 2a20 5447 544b 5429 0a20  i_tkt * TGTKT). 
│ │ │ │ -00001080: 2020 2020 5447 533a 2073 7472 7563 7475      TGS: structu
│ │ │ │ -00001090: 7265 2074 6861 7420 686f 6c64 7320 696e  re that holds in
│ │ │ │ -000010a0: 666f 726d 6174 696f 6e20 6162 6f75 7420  formation about 
│ │ │ │ -000010b0: 5447 5320 6578 6368 616e 6765 0a20 2020  TGS exchange.   
│ │ │ │ -000010c0: 2020 5447 544b 543a 2074 6963 6b65 7420    TGTKT: ticket 
│ │ │ │ -000010d0: 6772 616e 7469 6e67 2074 6963 6b65 7420  granting ticket 
│ │ │ │ -000010e0: 746f 2073 746f 7265 2069 6e20 5447 532e  to store in TGS.
│ │ │ │ -000010f0: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ -00001100: 696f 6e3a 2a20 5365 7420 7468 6520 5469  ion:* Set the Ti
│ │ │ │ -00001110: 636b 6574 2069 6e20 7468 6520 5447 5320  cket in the TGS 
│ │ │ │ -00001120: 6578 6368 616e 6765 2e0a 0a73 6869 7368  exchange...shish
│ │ │ │ -00001130: 695f 7467 735f 6170 0a2d 2d2d 2d2d 2d2d  i_tgs_ap.-------
│ │ │ │ -00001140: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ -00001150: 7469 6f6e 3a20 5368 6973 6869 5f61 7020  tion: Shishi_ap 
│ │ │ │ -00001160: 2a20 7368 6973 6869 5f74 6773 5f61 7020  * shishi_tgs_ap 
│ │ │ │ -00001170: 2853 6869 7368 695f 7467 7320 2a20 5447  (Shishi_tgs * TG
│ │ │ │ -00001180: 5329 0a20 2020 2020 5447 533a 2073 7472  S).     TGS: str
│ │ │ │ -00001190: 7563 7475 7265 2074 6861 7420 686f 6c64  ucture that hold
│ │ │ │ -000011a0: 7320 696e 666f 726d 6174 696f 6e20 6162  s information ab
│ │ │ │ -000011b0: 6f75 7420 5447 5320 6578 6368 616e 6765  out TGS exchange
│ │ │ │ -000011c0: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ -000011d0: 696f 6e3a 2a20 4765 7420 7468 6520 4150  ion:* Get the AP
│ │ │ │ -000011e0: 2066 726f 6d20 5447 5320 6578 6368 616e   from TGS exchan
│ │ │ │ -000011f0: 6765 2e0a 0a20 2020 2020 2a52 6574 7572  ge...     *Retur
│ │ │ │ -00001200: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ -00001210: 7320 7468 6520 4150 2065 7863 6861 6e67  s the AP exchang
│ │ │ │ -00001220: 6520 2870 6172 7420 6f66 2054 4753 2d52  e (part of TGS-R
│ │ │ │ -00001230: 4551 2920 6672 6f6d 2074 6865 0a20 2020  EQ) from the.   
│ │ │ │ -00001240: 2020 5447 5320 6578 6368 616e 6765 2c20    TGS exchange, 
│ │ │ │ -00001250: 6f72 204e 554c 4c20 6966 206e 6f74 2079  or NULL if not y
│ │ │ │ -00001260: 6574 2073 6574 206f 7220 616e 2065 7272  et set or an err
│ │ │ │ -00001270: 6f72 206f 6363 7572 6564 2e0a 0a73 6869  or occured...shi
│ │ │ │ -00001280: 7368 695f 7467 735f 7265 710a 2d2d 2d2d  shi_tgs_req.----
│ │ │ │ -00001290: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ -000012a0: 4675 6e63 7469 6f6e 3a20 5368 6973 6869  Function: Shishi
│ │ │ │ -000012b0: 5f61 736e 3120 7368 6973 6869 5f74 6773  _asn1 shishi_tgs
│ │ │ │ -000012c0: 5f72 6571 2028 5368 6973 6869 5f74 6773  _req (Shishi_tgs
│ │ │ │ -000012d0: 202a 2054 4753 290a 2020 2020 2054 4753   * TGS).     TGS
│ │ │ │ -000012e0: 3a20 7374 7275 6374 7572 6520 7468 6174  : structure that
│ │ │ │ -000012f0: 2068 6f6c 6473 2069 6e66 6f72 6d61 7469   holds informati
│ │ │ │ -00001300: 6f6e 2061 626f 7574 2054 4753 2065 7863  on about TGS exc
│ │ │ │ -00001310: 6861 6e67 650a 0a20 2020 2020 2a44 6573  hange..     *Des
│ │ │ │ -00001320: 6372 6970 7469 6f6e 3a2a 2047 6574 2074  cription:* Get t
│ │ │ │ -00001330: 6865 2054 4753 2d52 4551 2066 726f 6d20  he TGS-REQ from 
│ │ │ │ -00001340: 5447 5320 6578 6368 616e 6765 2e0a 0a20  TGS exchange... 
│ │ │ │ -00001350: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ -00001360: 653a 2a20 5265 7475 726e 7320 7468 6520  e:* Returns the 
│ │ │ │ -00001370: 6765 6e65 7261 7465 6420 5447 532d 5245  generated TGS-RE
│ │ │ │ -00001380: 5120 6672 6f6d 2074 6865 2054 4753 0a20  Q from the TGS. 
│ │ │ │ -00001390: 2020 2020 6578 6368 616e 6765 2c20 6f72      exchange, or
│ │ │ │ -000013a0: 204e 554c 4c20 6966 206e 6f74 2079 6574   NULL if not yet
│ │ │ │ -000013b0: 2073 6574 206f 7220 616e 2065 7272 6f72   set or an error
│ │ │ │ -000013c0: 206f 6363 7572 6564 2e0a 0a73 6869 7368   occured...shish
│ │ │ │ -000013d0: 695f 7467 735f 7265 715f 7365 740a 2d2d  i_tgs_req_set.--
│ │ │ │ +00000060: 6174 6564 2031 3420 4d61 7263 6820 3230  ated 14 March 20
│ │ │ │ +00000070: 3236 2066 6f72 2076 6572 7369 6f6e 2031  26 for version 1
│ │ │ │ +00000080: 2e30 2e33 206f 6620 5368 6973 6869 2e0a  .0.3 of Shishi..
│ │ │ │ +00000090: 0a20 2020 436f 7079 7269 6768 7420 c2a9  .   Copyright ..
│ │ │ │ +000000a0: 2032 3030 322d 3230 3232 2053 696d 6f6e   2002-2022 Simon
│ │ │ │ +000000b0: 204a 6f73 6566 7373 6f6e 2e0a 0a20 2020   Josefsson...   
│ │ │ │ +000000c0: 2020 5065 726d 6973 7369 6f6e 2069 7320    Permission is 
│ │ │ │ +000000d0: 6772 616e 7465 6420 746f 2063 6f70 792c  granted to copy,
│ │ │ │ +000000e0: 2064 6973 7472 6962 7574 6520 616e 642f   distribute and/
│ │ │ │ +000000f0: 6f72 206d 6f64 6966 7920 7468 6973 0a20  or modify this. 
│ │ │ │ +00000100: 2020 2020 646f 6375 6d65 6e74 2075 6e64      document und
│ │ │ │ +00000110: 6572 2074 6865 2074 6572 6d73 206f 6620  er the terms of 
│ │ │ │ +00000120: 7468 6520 474e 5520 4672 6565 2044 6f63  the GNU Free Doc
│ │ │ │ +00000130: 756d 656e 7461 7469 6f6e 204c 6963 656e  umentation Licen
│ │ │ │ +00000140: 7365 2c0a 2020 2020 2056 6572 7369 6f6e  se,.     Version
│ │ │ │ +00000150: 2031 2e33 206f 7220 616e 7920 6c61 7465   1.3 or any late
│ │ │ │ +00000160: 7220 7665 7273 696f 6e20 7075 626c 6973  r version publis
│ │ │ │ +00000170: 6865 6420 6279 2074 6865 2046 7265 6520  hed by the Free 
│ │ │ │ +00000180: 536f 6674 7761 7265 0a20 2020 2020 466f  Software.     Fo
│ │ │ │ +00000190: 756e 6461 7469 6f6e 3b20 7769 7468 206e  undation; with n
│ │ │ │ +000001a0: 6f20 496e 7661 7269 616e 7420 5365 6374  o Invariant Sect
│ │ │ │ +000001b0: 696f 6e73 2c20 6e6f 2046 726f 6e74 2d43  ions, no Front-C
│ │ │ │ +000001c0: 6f76 6572 2054 6578 7473 2c20 616e 640a  over Texts, and.
│ │ │ │ +000001d0: 2020 2020 206e 6f20 4261 636b 2d43 6f76       no Back-Cov
│ │ │ │ +000001e0: 6572 2054 6578 7473 2e20 2041 2063 6f70  er Texts.  A cop
│ │ │ │ +000001f0: 7920 6f66 2074 6865 206c 6963 656e 7365  y of the license
│ │ │ │ +00000200: 2069 7320 696e 636c 7564 6564 2069 6e20   is included in 
│ │ │ │ +00000210: 7468 650a 2020 2020 2073 6563 7469 6f6e  the.     section
│ │ │ │ +00000220: 2065 6e74 6974 6c65 6420 2247 4e55 2046   entitled "GNU F
│ │ │ │ +00000230: 7265 6520 446f 6375 6d65 6e74 6174 696f  ree Documentatio
│ │ │ │ +00000240: 6e20 4c69 6365 6e73 6522 2e0a 494e 464f  n License"..INFO
│ │ │ │ +00000250: 2d44 4952 2d53 4543 5449 4f4e 2047 4e55  -DIR-SECTION GNU
│ │ │ │ +00000260: 2075 7469 6c69 7469 6573 0a53 5441 5254   utilities.START
│ │ │ │ +00000270: 2d49 4e46 4f2d 4449 522d 454e 5452 590a  -INFO-DIR-ENTRY.
│ │ │ │ +00000280: 2a20 7368 6973 6869 3a20 2873 6869 7368  * shishi: (shish
│ │ │ │ +00000290: 6929 2e09 0941 204b 6572 6265 726f 7320  i)...A Kerberos 
│ │ │ │ +000002a0: 3520 696d 706c 656d 656e 7461 7469 6f6e  5 implementation
│ │ │ │ +000002b0: 0a45 4e44 2d49 4e46 4f2d 4449 522d 454e  .END-INFO-DIR-EN
│ │ │ │ +000002c0: 5452 590a 0a49 4e46 4f2d 4449 522d 5345  TRY..INFO-DIR-SE
│ │ │ │ +000002d0: 4354 494f 4e20 474e 5520 4c69 6272 6172  CTION GNU Librar
│ │ │ │ +000002e0: 6965 730a 5354 4152 542d 494e 464f 2d44  ies.START-INFO-D
│ │ │ │ +000002f0: 4952 2d45 4e54 5259 0a2a 206c 6962 7368  IR-ENTRY.* libsh
│ │ │ │ +00000300: 6973 6869 3a20 2873 6869 7368 6929 2e09  ishi: (shishi)..
│ │ │ │ +00000310: 094c 6962 7261 7279 2069 6d70 6c65 6d65  .Library impleme
│ │ │ │ +00000320: 6e74 696e 6720 4b65 7262 6572 6f73 2035  nting Kerberos 5
│ │ │ │ +00000330: 2e0a 454e 442d 494e 464f 2d44 4952 2d45  ..END-INFO-DIR-E
│ │ │ │ +00000340: 4e54 5259 0a0a 1f0a 4669 6c65 3a20 7368  NTRY....File: sh
│ │ │ │ +00000350: 6973 6869 2e69 6e66 6f2c 2020 4e6f 6465  ishi.info,  Node
│ │ │ │ +00000360: 3a20 5447 5320 4675 6e63 7469 6f6e 732c  : TGS Functions,
│ │ │ │ +00000370: 2020 4e65 7874 3a20 5469 636b 6574 2028    Next: Ticket (
│ │ │ │ +00000380: 4153 4e2e 3129 2046 756e 6374 696f 6e73  ASN.1) Functions
│ │ │ │ +00000390: 2c20 2050 7265 763a 2041 5320 4675 6e63  ,  Prev: AS Func
│ │ │ │ +000003a0: 7469 6f6e 732c 2020 5570 3a20 5072 6f67  tions,  Up: Prog
│ │ │ │ +000003b0: 7261 6d6d 696e 6720 4d61 6e75 616c 0a0a  ramming Manual..
│ │ │ │ +000003c0: 352e 3820 5447 5320 4675 6e63 7469 6f6e  5.8 TGS Function
│ │ │ │ +000003d0: 730a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  s.==============
│ │ │ │ +000003e0: 3d3d 3d0a 0a54 6865 2054 6963 6b65 7420  ===..The Ticket 
│ │ │ │ +000003f0: 4772 616e 7469 6e67 2053 6572 7669 6365  Granting Service
│ │ │ │ +00000400: 2028 5447 5329 2069 7320 7573 6564 2074   (TGS) is used t
│ │ │ │ +00000410: 6f20 6765 7420 7375 6273 6571 7565 6e74  o get subsequent
│ │ │ │ +00000420: 2074 6963 6b65 7473 2c0a 6175 7468 656e   tickets,.authen
│ │ │ │ +00000430: 7469 6361 7465 6420 6279 206f 7468 6572  ticated by other
│ │ │ │ +00000440: 2074 6963 6b65 7473 2028 736f 2063 616c   tickets (so cal
│ │ │ │ +00000450: 6c65 6420 7469 636b 6574 2067 7261 6e74  led ticket grant
│ │ │ │ +00000460: 696e 6720 7469 636b 6574 7329 2e20 2054  ing tickets).  T
│ │ │ │ +00000470: 6865 0a66 6f6c 6c6f 7769 6e67 2069 6c6c  he.following ill
│ │ │ │ +00000480: 7573 7472 6174 6573 2074 6865 2054 4753  ustrates the TGS
│ │ │ │ +00000490: 2d52 4551 2061 6e64 2054 4753 2d52 4550  -REQ and TGS-REP
│ │ │ │ +000004a0: 2041 534e 2e31 2073 7472 7563 7475 7265   ASN.1 structure
│ │ │ │ +000004b0: 732e 0a0a 2d2d 2052 6571 7565 7374 202d  s...-- Request -
│ │ │ │ +000004c0: 2d0a 0a54 4753 2d52 4551 0909 3a3a 3d20  -..TGS-REQ..::= 
│ │ │ │ +000004d0: 4b44 432d 5245 5120 7b31 327d 0a0a 4b44  KDC-REQ {12}..KD
│ │ │ │ +000004e0: 432d 5245 5120 7b49 4e54 4547 4552 3a74  C-REQ {INTEGER:t
│ │ │ │ +000004f0: 6167 6e75 6d7d 093a 3a3d 205b 4150 504c  agnum}.::= [APPL
│ │ │ │ +00000500: 4943 4154 494f 4e20 7461 676e 756d 5d20  ICATION tagnum] 
│ │ │ │ +00000510: 5345 5155 454e 4345 207b 0a09 7076 6e6f  SEQUENCE {..pvno
│ │ │ │ +00000520: 0909 5b31 5d20 494e 5445 4745 5220 2835  ..[1] INTEGER (5
│ │ │ │ +00000530: 2920 2d2d 2066 6972 7374 2074 6167 2069  ) -- first tag i
│ │ │ │ +00000540: 7320 5b31 5d2c 206e 6f74 205b 305d 202d  s [1], not [0] -
│ │ │ │ +00000550: 2d2c 0a09 6d73 672d 7479 7065 095b 325d  -,..msg-type.[2]
│ │ │ │ +00000560: 2049 4e54 4547 4552 2028 7461 676e 756d   INTEGER (tagnum
│ │ │ │ +00000570: 292c 0a09 7061 6461 7461 0909 5b33 5d20  ),..padata..[3] 
│ │ │ │ +00000580: 5345 5155 454e 4345 204f 4620 5041 2d44  SEQUENCE OF PA-D
│ │ │ │ +00000590: 4154 4120 4f50 5449 4f4e 414c 2c0a 0972  ATA OPTIONAL,..r
│ │ │ │ +000005a0: 6571 2d62 6f64 7909 5b34 5d20 4b44 432d  eq-body.[4] KDC-
│ │ │ │ +000005b0: 5245 512d 424f 4459 0a7d 0a0a 4b44 432d  REQ-BODY.}..KDC-
│ │ │ │ +000005c0: 5245 512d 424f 4459 093a 3a3d 2053 4551  REQ-BODY.::= SEQ
│ │ │ │ +000005d0: 5545 4e43 4520 7b0a 096b 6463 2d6f 7074  UENCE {..kdc-opt
│ │ │ │ +000005e0: 696f 6e73 0909 5b30 5d20 4b44 434f 7074  ions..[0] KDCOpt
│ │ │ │ +000005f0: 696f 6e73 2c0a 0963 6e61 6d65 0909 095b  ions,..cname...[
│ │ │ │ +00000600: 315d 2050 7269 6e63 6970 616c 4e61 6d65  1] PrincipalName
│ │ │ │ +00000610: 204f 5054 494f 4e41 4c0a 0909 0909 2020   OPTIONAL.....  
│ │ │ │ +00000620: 2020 2d2d 2055 7365 6420 6f6e 6c79 2069    -- Used only i
│ │ │ │ +00000630: 6e20 4153 2d52 4551 202d 2d2c 0a09 7265  n AS-REQ --,..re
│ │ │ │ +00000640: 616c 6d09 0909 5b32 5d20 5265 616c 6d0a  alm...[2] Realm.
│ │ │ │ +00000650: 0909 0909 2020 2020 2d2d 2053 6572 7665  ....    -- Serve
│ │ │ │ +00000660: 7227 7320 7265 616c 6d0a 0909 0909 2020  r's realm.....  
│ │ │ │ +00000670: 2020 2d2d 2041 6c73 6f20 636c 6965 6e74    -- Also client
│ │ │ │ +00000680: 2773 2069 6e20 4153 2d52 4551 202d 2d2c  's in AS-REQ --,
│ │ │ │ +00000690: 0a09 736e 616d 6509 0909 5b33 5d20 5072  ..sname...[3] Pr
│ │ │ │ +000006a0: 696e 6369 7061 6c4e 616d 6520 4f50 5449  incipalName OPTI
│ │ │ │ +000006b0: 4f4e 414c 2c0a 0966 726f 6d09 0909 5b34  ONAL,..from...[4
│ │ │ │ +000006c0: 5d20 4b65 7262 6572 6f73 5469 6d65 204f  ] KerberosTime O
│ │ │ │ +000006d0: 5054 494f 4e41 4c2c 0a09 7469 6c6c 0909  PTIONAL,..till..
│ │ │ │ +000006e0: 095b 355d 204b 6572 6265 726f 7354 696d  .[5] KerberosTim
│ │ │ │ +000006f0: 652c 0a09 7274 696d 6509 0909 5b36 5d20  e,..rtime...[6] 
│ │ │ │ +00000700: 4b65 7262 6572 6f73 5469 6d65 204f 5054  KerberosTime OPT
│ │ │ │ +00000710: 494f 4e41 4c2c 0a09 6e6f 6e63 6509 0909  IONAL,..nonce...
│ │ │ │ +00000720: 5b37 5d20 5549 6e74 3332 2c0a 0965 7479  [7] UInt32,..ety
│ │ │ │ +00000730: 7065 0909 095b 385d 2053 4551 5545 4e43  pe...[8] SEQUENC
│ │ │ │ +00000740: 4520 4f46 2049 6e74 3332 202d 2d20 456e  E OF Int32 -- En
│ │ │ │ +00000750: 6372 7970 7469 6f6e 5479 7065 0a09 0909  cryptionType....
│ │ │ │ +00000760: 0920 2020 202d 2d20 696e 2070 7265 6665  .    -- in prefe
│ │ │ │ +00000770: 7265 6e63 6520 6f72 6465 7220 2d2d 2c0a  rence order --,.
│ │ │ │ +00000780: 0961 6464 7265 7373 6573 0909 5b39 5d20  .addresses..[9] 
│ │ │ │ +00000790: 486f 7374 4164 6472 6573 7365 7320 4f50  HostAddresses OP
│ │ │ │ +000007a0: 5449 4f4e 414c 2c0a 0965 6e63 2d61 7574  TIONAL,..enc-aut
│ │ │ │ +000007b0: 686f 7269 7a61 7469 6f6e 2d64 6174 6109  horization-data.
│ │ │ │ +000007c0: 5b31 305d 2045 6e63 7279 7074 6564 4461  [10] EncryptedDa
│ │ │ │ +000007d0: 7461 207b 0a09 0909 0909 4175 7468 6f72  ta {......Author
│ │ │ │ +000007e0: 697a 6174 696f 6e44 6174 612c 0a09 0909  izationData,....
│ │ │ │ +000007f0: 0909 7b20 6b65 7975 7365 2d54 4753 5265  ..{ keyuse-TGSRe
│ │ │ │ +00000800: 7141 7574 6844 6174 612d 7365 7373 6b65  qAuthData-sesske
│ │ │ │ +00000810: 790a 0909 0909 0920 207c 206b 6579 7573  y......  | keyus
│ │ │ │ +00000820: 652d 5447 5352 6571 4175 7468 4461 7461  e-TGSReqAuthData
│ │ │ │ +00000830: 2d73 7562 6b65 7920 7d0a 0909 0909 2020  -subkey }.....  
│ │ │ │ +00000840: 2020 207d 204f 5054 494f 4e41 4c2c 0a09     } OPTIONAL,..
│ │ │ │ +00000850: 6164 6469 7469 6f6e 616c 2d74 6963 6b65  additional-ticke
│ │ │ │ +00000860: 7473 095b 3131 5d20 5345 5155 454e 4345  ts.[11] SEQUENCE
│ │ │ │ +00000870: 204f 4620 5469 636b 6574 204f 5054 494f   OF Ticket OPTIO
│ │ │ │ +00000880: 4e41 4c0a 7d0a 0a2d 2d20 5265 706c 7920  NAL.}..-- Reply 
│ │ │ │ +00000890: 2d2d 0a0a 5447 532d 5245 5009 093a 3a3d  --..TGS-REP..::=
│ │ │ │ +000008a0: 204b 4443 2d52 4550 207b 3133 2c20 456e   KDC-REP {13, En
│ │ │ │ +000008b0: 6354 4753 5265 7050 6172 742c 0a09 0909  cTGSRepPart,....
│ │ │ │ +000008c0: 7b20 6b65 7975 7365 2d45 6e63 5447 5352  { keyuse-EncTGSR
│ │ │ │ +000008d0: 6570 5061 7274 2d73 6573 736b 6579 0a09  epPart-sesskey..
│ │ │ │ +000008e0: 0909 2020 7c20 6b65 7975 7365 2d45 6e63  ..  | keyuse-Enc
│ │ │ │ +000008f0: 5447 5352 6570 5061 7274 2d73 7562 6b65  TGSRepPart-subke
│ │ │ │ +00000900: 7920 7d7d 0a0a 4b44 432d 5245 5020 7b49  y }}..KDC-REP {I
│ │ │ │ +00000910: 4e54 4547 4552 3a74 6167 6e75 6d2c 0a09  NTEGER:tagnum,..
│ │ │ │ +00000920: 2054 7970 6554 6f45 6e63 7279 7074 2c0a   TypeToEncrypt,.
│ │ │ │ +00000930: 0920 5549 6e74 3332 3a4b 6579 5573 6167  . UInt32:KeyUsag
│ │ │ │ +00000940: 6573 7d09 3a3a 3d20 5b41 5050 4c49 4341  es}.::= [APPLICA
│ │ │ │ +00000950: 5449 4f4e 2074 6167 6e75 6d5d 2053 4551  TION tagnum] SEQ
│ │ │ │ +00000960: 5545 4e43 4520 7b0a 0970 766e 6f09 095b  UENCE {..pvno..[
│ │ │ │ +00000970: 305d 2049 4e54 4547 4552 2028 3529 2c0a  0] INTEGER (5),.
│ │ │ │ +00000980: 096d 7367 2d74 7970 6509 5b31 5d20 494e  .msg-type.[1] IN
│ │ │ │ +00000990: 5445 4745 5220 2874 6167 6e75 6d29 2c0a  TEGER (tagnum),.
│ │ │ │ +000009a0: 0970 6164 6174 6109 095b 325d 2053 4551  .padata..[2] SEQ
│ │ │ │ +000009b0: 5545 4e43 4520 4f46 2050 412d 4441 5441  UENCE OF PA-DATA
│ │ │ │ +000009c0: 204f 5054 494f 4e41 4c2c 0a09 6372 6561   OPTIONAL,..crea
│ │ │ │ +000009d0: 6c6d 0909 5b33 5d20 5265 616c 6d2c 0a09  lm..[3] Realm,..
│ │ │ │ +000009e0: 636e 616d 6509 095b 345d 2050 7269 6e63  cname..[4] Princ
│ │ │ │ +000009f0: 6970 616c 4e61 6d65 2c0a 0974 6963 6b65  ipalName,..ticke
│ │ │ │ +00000a00: 7409 095b 355d 2054 6963 6b65 742c 0a09  t..[5] Ticket,..
│ │ │ │ +00000a10: 656e 632d 7061 7274 095b 365d 2045 6e63  enc-part.[6] Enc
│ │ │ │ +00000a20: 7279 7074 6564 4461 7461 207b 5479 7065  ryptedData {Type
│ │ │ │ +00000a30: 546f 456e 6372 7970 742c 204b 6579 5573  ToEncrypt, KeyUs
│ │ │ │ +00000a40: 6167 6573 7d0a 7d0a 0a45 6e63 5447 5352  ages}.}..EncTGSR
│ │ │ │ +00000a50: 6570 5061 7274 093a 3a3d 205b 4150 504c  epPart.::= [APPL
│ │ │ │ +00000a60: 4943 4154 494f 4e20 3236 5d20 456e 634b  ICATION 26] EncK
│ │ │ │ +00000a70: 4443 5265 7050 6172 740a 0a45 6e63 4b44  DCRepPart..EncKD
│ │ │ │ +00000a80: 4352 6570 5061 7274 093a 3a3d 2053 4551  CRepPart.::= SEQ
│ │ │ │ +00000a90: 5545 4e43 4520 7b0a 096b 6579 0909 5b30  UENCE {..key..[0
│ │ │ │ +00000aa0: 5d20 456e 6372 7970 7469 6f6e 4b65 792c  ] EncryptionKey,
│ │ │ │ +00000ab0: 0a09 6c61 7374 2d72 6571 095b 315d 204c  ..last-req.[1] L
│ │ │ │ +00000ac0: 6173 7452 6571 2c0a 096e 6f6e 6365 0909  astReq,..nonce..
│ │ │ │ +00000ad0: 5b32 5d20 5549 6e74 3332 2c0a 096b 6579  [2] UInt32,..key
│ │ │ │ +00000ae0: 2d65 7870 6972 6174 696f 6e09 5b33 5d20  -expiration.[3] 
│ │ │ │ +00000af0: 4b65 7262 6572 6f73 5469 6d65 204f 5054  KerberosTime OPT
│ │ │ │ +00000b00: 494f 4e41 4c2c 0a09 666c 6167 7309 095b  IONAL,..flags..[
│ │ │ │ +00000b10: 345d 2054 6963 6b65 7446 6c61 6773 2c0a  4] TicketFlags,.
│ │ │ │ +00000b20: 0961 7574 6874 696d 6509 5b35 5d20 4b65  .authtime.[5] Ke
│ │ │ │ +00000b30: 7262 6572 6f73 5469 6d65 2c0a 0973 7461  rberosTime,..sta
│ │ │ │ +00000b40: 7274 7469 6d65 095b 365d 204b 6572 6265  rttime.[6] Kerbe
│ │ │ │ +00000b50: 726f 7354 696d 6520 4f50 5449 4f4e 414c  rosTime OPTIONAL
│ │ │ │ +00000b60: 2c0a 0965 6e64 7469 6d65 0909 5b37 5d20  ,..endtime..[7] 
│ │ │ │ +00000b70: 4b65 7262 6572 6f73 5469 6d65 2c0a 0972  KerberosTime,..r
│ │ │ │ +00000b80: 656e 6577 2d74 696c 6c09 5b38 5d20 4b65  enew-till.[8] Ke
│ │ │ │ +00000b90: 7262 6572 6f73 5469 6d65 204f 5054 494f  rberosTime OPTIO
│ │ │ │ +00000ba0: 4e41 4c2c 0a09 7372 6561 6c6d 0909 5b39  NAL,..srealm..[9
│ │ │ │ +00000bb0: 5d20 5265 616c 6d2c 0a09 736e 616d 6509  ] Realm,..sname.
│ │ │ │ +00000bc0: 095b 3130 5d20 5072 696e 6369 7061 6c4e  .[10] PrincipalN
│ │ │ │ +00000bd0: 616d 652c 0a09 6361 6464 7209 095b 3131  ame,..caddr..[11
│ │ │ │ +00000be0: 5d20 486f 7374 4164 6472 6573 7365 7320  ] HostAddresses 
│ │ │ │ +00000bf0: 4f50 5449 4f4e 414c 0a7d 0a0a 7368 6973  OPTIONAL.}..shis
│ │ │ │ +00000c00: 6869 5f74 6773 0a2d 2d2d 2d2d 2d2d 2d2d  hi_tgs.---------
│ │ │ │ +00000c10: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ +00000c20: 2069 6e74 2073 6869 7368 695f 7467 7320   int shishi_tgs 
│ │ │ │ +00000c30: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ +00000c40: 2c20 5368 6973 6869 5f74 6773 202a 2a20  , Shishi_tgs ** 
│ │ │ │ +00000c50: 5447 5329 0a20 2020 2020 4841 4e44 4c45  TGS).     HANDLE
│ │ │ │ +00000c60: 3a20 7368 6973 6869 2068 616e 646c 6520  : shishi handle 
│ │ │ │ +00000c70: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ +00000c80: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ +00000c90: e280 992e 0a20 2020 2020 5447 533a 2068  .....     TGS: h
│ │ │ │ +00000ca0: 6f6c 6473 2070 6f69 6e74 6572 2074 6f20  olds pointer to 
│ │ │ │ +00000cb0: 6e65 776c 7920 616c 6c6f 6361 7465 2053  newly allocate S
│ │ │ │ +00000cc0: 6869 7368 695f 7467 7320 7374 7275 6374  hishi_tgs struct
│ │ │ │ +00000cd0: 7572 652e 0a0a 2020 2020 202a 4465 7363  ure...     *Desc
│ │ │ │ +00000ce0: 7269 7074 696f 6e3a 2a20 416c 6c6f 6361  ription:* Alloca
│ │ │ │ +00000cf0: 7465 2061 206e 6577 2054 4753 2065 7863  te a new TGS exc
│ │ │ │ +00000d00: 6861 6e67 6520 7661 7269 6162 6c65 2e0a  hange variable..
│ │ │ │ +00000d10: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ +00000d20: 6c75 653a 2a20 5265 7475 726e 7320 5348  lue:* Returns SH
│ │ │ │ +00000d30: 4953 4849 5f4f 4b20 6966 6620 7375 6363  ISHI_OK iff succ
│ │ │ │ +00000d40: 6573 7366 756c 2e0a 0a73 6869 7368 695f  essful...shishi_
│ │ │ │ +00000d50: 7467 735f 646f 6e65 0a2d 2d2d 2d2d 2d2d  tgs_done.-------
│ │ │ │ +00000d60: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ +00000d70: 6e63 7469 6f6e 3a20 766f 6964 2073 6869  nction: void shi
│ │ │ │ +00000d80: 7368 695f 7467 735f 646f 6e65 2028 5368  shi_tgs_done (Sh
│ │ │ │ +00000d90: 6973 6869 5f74 6773 202a 2054 4753 290a  ishi_tgs * TGS).
│ │ │ │ +00000da0: 2020 2020 2054 4753 3a20 7374 7275 6374       TGS: struct
│ │ │ │ +00000db0: 7572 6520 7468 6174 2068 6f6c 6473 2069  ure that holds i
│ │ │ │ +00000dc0: 6e66 6f72 6d61 7469 6f6e 2061 626f 7574  nformation about
│ │ │ │ +00000dd0: 2041 5320 6578 6368 616e 6765 0a0a 2020   AS exchange..  
│ │ │ │ +00000de0: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ +00000df0: 2a20 4465 616c 6c6f 6361 7465 2072 6573  * Deallocate res
│ │ │ │ +00000e00: 6f75 7263 6573 2061 7373 6f63 6961 7465  ources associate
│ │ │ │ +00000e10: 6420 7769 7468 2054 4753 2065 7863 6861  d with TGS excha
│ │ │ │ +00000e20: 6e67 652e 0a20 2020 2020 5468 6973 2073  nge..     This s
│ │ │ │ +00000e30: 686f 756c 6420 6265 2063 616c 6c65 6420  hould be called 
│ │ │ │ +00000e40: 6279 2074 6865 2061 7070 6c69 6361 7469  by the applicati
│ │ │ │ +00000e50: 6f6e 2077 6865 6e20 6974 206e 6f20 6c6f  on when it no lo
│ │ │ │ +00000e60: 6e67 6572 206e 6565 6420 746f 0a20 2020  nger need to.   
│ │ │ │ +00000e70: 2020 7574 696c 697a 6520 7468 6520 5447    utilize the TG
│ │ │ │ +00000e80: 5320 6578 6368 616e 6765 2068 616e 646c  S exchange handl
│ │ │ │ +00000e90: 652e 0a0a 7368 6973 6869 5f74 6773 5f74  e...shishi_tgs_t
│ │ │ │ +00000ea0: 6774 6b74 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  gtkt.-----------
│ │ │ │ +00000eb0: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +00000ec0: 696f 6e3a 2053 6869 7368 695f 746b 7420  ion: Shishi_tkt 
│ │ │ │ +00000ed0: 2a20 7368 6973 6869 5f74 6773 5f74 6774  * shishi_tgs_tgt
│ │ │ │ +00000ee0: 6b74 2028 5368 6973 6869 5f74 6773 202a  kt (Shishi_tgs *
│ │ │ │ +00000ef0: 2054 4753 290a 2020 2020 2054 4753 3a20   TGS).     TGS: 
│ │ │ │ +00000f00: 7374 7275 6374 7572 6520 7468 6174 2068  structure that h
│ │ │ │ +00000f10: 6f6c 6473 2069 6e66 6f72 6d61 7469 6f6e  olds information
│ │ │ │ +00000f20: 2061 626f 7574 2054 4753 2065 7863 6861   about TGS excha
│ │ │ │ +00000f30: 6e67 650a 0a20 2020 2020 2a44 6573 6372  nge..     *Descr
│ │ │ │ +00000f40: 6970 7469 6f6e 3a2a 2047 6574 2054 6963  iption:* Get Tic
│ │ │ │ +00000f50: 6b65 742d 6772 616e 7469 6e67 2d74 6963  ket-granting-tic
│ │ │ │ +00000f60: 6b65 7420 6672 6f6d 2054 4753 2065 7863  ket from TGS exc
│ │ │ │ +00000f70: 6861 6e67 652e 0a0a 2020 2020 202a 5265  hange...     *Re
│ │ │ │ +00000f80: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ +00000f90: 7572 6e73 2074 6865 2074 6963 6b65 742d  urns the ticket-
│ │ │ │ +00000fa0: 6772 616e 7469 6e67 2d74 6963 6b65 7420  granting-ticket 
│ │ │ │ +00000fb0: 7573 6564 2069 6e20 7468 6520 5447 530a  used in the TGS.
│ │ │ │ +00000fc0: 2020 2020 2065 7863 6861 6e67 652c 206f       exchange, o
│ │ │ │ +00000fd0: 7220 4e55 4c4c 2069 6620 6e6f 7420 7965  r NULL if not ye
│ │ │ │ +00000fe0: 7420 7365 7420 6f72 2061 6e20 6572 726f  t set or an erro
│ │ │ │ +00000ff0: 7220 6f63 6375 7265 642e 0a0a 7368 6973  r occured...shis
│ │ │ │ +00001000: 6869 5f74 6773 5f74 6774 6b74 5f73 6574  hi_tgs_tgtkt_set
│ │ │ │ +00001010: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ +00001020: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +00001030: 696f 6e3a 2076 6f69 6420 7368 6973 6869  ion: void shishi
│ │ │ │ +00001040: 5f74 6773 5f74 6774 6b74 5f73 6574 2028  _tgs_tgtkt_set (
│ │ │ │ +00001050: 5368 6973 6869 5f74 6773 202a 2054 4753  Shishi_tgs * TGS
│ │ │ │ +00001060: 2c0a 2020 2020 2020 2020 2020 5368 6973  ,.          Shis
│ │ │ │ +00001070: 6869 5f74 6b74 202a 2054 4754 4b54 290a  hi_tkt * TGTKT).
│ │ │ │ +00001080: 2020 2020 2054 4753 3a20 7374 7275 6374       TGS: struct
│ │ │ │ +00001090: 7572 6520 7468 6174 2068 6f6c 6473 2069  ure that holds i
│ │ │ │ +000010a0: 6e66 6f72 6d61 7469 6f6e 2061 626f 7574  nformation about
│ │ │ │ +000010b0: 2054 4753 2065 7863 6861 6e67 650a 2020   TGS exchange.  
│ │ │ │ +000010c0: 2020 2054 4754 4b54 3a20 7469 636b 6574     TGTKT: ticket
│ │ │ │ +000010d0: 2067 7261 6e74 696e 6720 7469 636b 6574   granting ticket
│ │ │ │ +000010e0: 2074 6f20 7374 6f72 6520 696e 2054 4753   to store in TGS
│ │ │ │ +000010f0: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ +00001100: 7469 6f6e 3a2a 2053 6574 2074 6865 2054  tion:* Set the T
│ │ │ │ +00001110: 6963 6b65 7420 696e 2074 6865 2054 4753  icket in the TGS
│ │ │ │ +00001120: 2065 7863 6861 6e67 652e 0a0a 7368 6973   exchange...shis
│ │ │ │ +00001130: 6869 5f74 6773 5f61 700a 2d2d 2d2d 2d2d  hi_tgs_ap.------
│ │ │ │ +00001140: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +00001150: 6374 696f 6e3a 2053 6869 7368 695f 6170  ction: Shishi_ap
│ │ │ │ +00001160: 202a 2073 6869 7368 695f 7467 735f 6170   * shishi_tgs_ap
│ │ │ │ +00001170: 2028 5368 6973 6869 5f74 6773 202a 2054   (Shishi_tgs * T
│ │ │ │ +00001180: 4753 290a 2020 2020 2054 4753 3a20 7374  GS).     TGS: st
│ │ │ │ +00001190: 7275 6374 7572 6520 7468 6174 2068 6f6c  ructure that hol
│ │ │ │ +000011a0: 6473 2069 6e66 6f72 6d61 7469 6f6e 2061  ds information a
│ │ │ │ +000011b0: 626f 7574 2054 4753 2065 7863 6861 6e67  bout TGS exchang
│ │ │ │ +000011c0: 650a 0a20 2020 2020 2a44 6573 6372 6970  e..     *Descrip
│ │ │ │ +000011d0: 7469 6f6e 3a2a 2047 6574 2074 6865 2041  tion:* Get the A
│ │ │ │ +000011e0: 5020 6672 6f6d 2054 4753 2065 7863 6861  P from TGS excha
│ │ │ │ +000011f0: 6e67 652e 0a0a 2020 2020 202a 5265 7475  nge...     *Retu
│ │ │ │ +00001200: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ +00001210: 6e73 2074 6865 2041 5020 6578 6368 616e  ns the AP exchan
│ │ │ │ +00001220: 6765 2028 7061 7274 206f 6620 5447 532d  ge (part of TGS-
│ │ │ │ +00001230: 5245 5129 2066 726f 6d20 7468 650a 2020  REQ) from the.  
│ │ │ │ +00001240: 2020 2054 4753 2065 7863 6861 6e67 652c     TGS exchange,
│ │ │ │ +00001250: 206f 7220 4e55 4c4c 2069 6620 6e6f 7420   or NULL if not 
│ │ │ │ +00001260: 7965 7420 7365 7420 6f72 2061 6e20 6572  yet set or an er
│ │ │ │ +00001270: 726f 7220 6f63 6375 7265 642e 0a0a 7368  ror occured...sh
│ │ │ │ +00001280: 6973 6869 5f74 6773 5f72 6571 0a2d 2d2d  ishi_tgs_req.---
│ │ │ │ +00001290: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ +000012a0: 2046 756e 6374 696f 6e3a 2053 6869 7368   Function: Shish
│ │ │ │ +000012b0: 695f 6173 6e31 2073 6869 7368 695f 7467  i_asn1 shishi_tg
│ │ │ │ +000012c0: 735f 7265 7120 2853 6869 7368 695f 7467  s_req (Shishi_tg
│ │ │ │ +000012d0: 7320 2a20 5447 5329 0a20 2020 2020 5447  s * TGS).     TG
│ │ │ │ +000012e0: 533a 2073 7472 7563 7475 7265 2074 6861  S: structure tha
│ │ │ │ +000012f0: 7420 686f 6c64 7320 696e 666f 726d 6174  t holds informat
│ │ │ │ +00001300: 696f 6e20 6162 6f75 7420 5447 5320 6578  ion about TGS ex
│ │ │ │ +00001310: 6368 616e 6765 0a0a 2020 2020 202a 4465  change..     *De
│ │ │ │ +00001320: 7363 7269 7074 696f 6e3a 2a20 4765 7420  scription:* Get 
│ │ │ │ +00001330: 7468 6520 5447 532d 5245 5120 6672 6f6d  the TGS-REQ from
│ │ │ │ +00001340: 2054 4753 2065 7863 6861 6e67 652e 0a0a   TGS exchange...
│ │ │ │ +00001350: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ +00001360: 7565 3a2a 2052 6574 7572 6e73 2074 6865  ue:* Returns the
│ │ │ │ +00001370: 2067 656e 6572 6174 6564 2054 4753 2d52   generated TGS-R
│ │ │ │ +00001380: 4551 2066 726f 6d20 7468 6520 5447 530a  EQ from the TGS.
│ │ │ │ +00001390: 2020 2020 2065 7863 6861 6e67 652c 206f       exchange, o
│ │ │ │ +000013a0: 7220 4e55 4c4c 2069 6620 6e6f 7420 7965  r NULL if not ye
│ │ │ │ +000013b0: 7420 7365 7420 6f72 2061 6e20 6572 726f  t set or an erro
│ │ │ │ +000013c0: 7220 6f63 6375 7265 642e 0a0a 7368 6973  r occured...shis
│ │ │ │ +000013d0: 6869 5f74 6773 5f72 6571 5f73 6574 0a2d  hi_tgs_req_set.-
│ │ │ │  000013e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000013f0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ -00001400: 766f 6964 2073 6869 7368 695f 7467 735f  void shishi_tgs_
│ │ │ │ -00001410: 7265 715f 7365 7420 2853 6869 7368 695f  req_set (Shishi_
│ │ │ │ -00001420: 7467 7320 2a20 5447 532c 0a20 2020 2020  tgs * TGS,.     
│ │ │ │ -00001430: 2020 2020 2053 6869 7368 695f 6173 6e31       Shishi_asn1
│ │ │ │ -00001440: 2054 4753 5245 5129 0a20 2020 2020 5447   TGSREQ).     TG
│ │ │ │ -00001450: 533a 2073 7472 7563 7475 7265 2074 6861  S: structure tha
│ │ │ │ -00001460: 7420 686f 6c64 7320 696e 666f 726d 6174  t holds informat
│ │ │ │ -00001470: 696f 6e20 6162 6f75 7420 5447 5320 6578  ion about TGS ex
│ │ │ │ -00001480: 6368 616e 6765 0a20 2020 2020 5447 5352  change.     TGSR
│ │ │ │ -00001490: 4551 3a20 7467 7372 6571 2074 6f20 7374  EQ: tgsreq to st
│ │ │ │ -000014a0: 6f72 6520 696e 2054 4753 2e0a 0a20 2020  ore in TGS...   
│ │ │ │ -000014b0: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ -000014c0: 2053 6574 2074 6865 2054 4753 2d52 4551   Set the TGS-REQ
│ │ │ │ -000014d0: 2069 6e20 7468 6520 5447 5320 6578 6368   in the TGS exch
│ │ │ │ -000014e0: 616e 6765 2e0a 0a73 6869 7368 695f 7467  ange...shishi_tg
│ │ │ │ -000014f0: 735f 7265 715f 6465 720a 2d2d 2d2d 2d2d  s_req_der.------
│ │ │ │ -00001500: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ -00001510: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ -00001520: 7368 6973 6869 5f74 6773 5f72 6571 5f64  shishi_tgs_req_d
│ │ │ │ -00001530: 6572 2028 5368 6973 6869 5f74 6773 202a  er (Shishi_tgs *
│ │ │ │ -00001540: 2054 4753 2c20 6368 6172 202a 2a20 4f55   TGS, char ** OU
│ │ │ │ -00001550: 542c 0a20 2020 2020 2020 2020 2073 697a  T,.          siz
│ │ │ │ -00001560: 655f 7420 2a20 4f55 544c 454e 290a 2020  e_t * OUTLEN).  
│ │ │ │ -00001570: 2020 2054 4753 3a20 7374 7275 6374 7572     TGS: structur
│ │ │ │ -00001580: 6520 7468 6174 2068 6f6c 6473 2069 6e66  e that holds inf
│ │ │ │ -00001590: 6f72 6d61 7469 6f6e 2061 626f 7574 2054  ormation about T
│ │ │ │ -000015a0: 4753 2065 7863 6861 6e67 650a 2020 2020  GS exchange.    
│ │ │ │ -000015b0: 204f 5554 3a20 6f75 7470 7574 2061 7272   OUT: output arr
│ │ │ │ -000015c0: 6179 2077 6974 6820 6e65 776c 7920 616c  ay with newly al
│ │ │ │ -000015d0: 6c6f 6361 7465 6420 4445 5220 656e 636f  located DER enco
│ │ │ │ -000015e0: 6469 6e67 206f 6620 5447 532d 5245 512e  ding of TGS-REQ.
│ │ │ │ -000015f0: 0a20 2020 2020 4f55 544c 454e 3a20 6c65  .     OUTLEN: le
│ │ │ │ -00001600: 6e67 7468 206f 6620 6f75 7470 7574 2061  ngth of output a
│ │ │ │ -00001610: 7272 6179 2077 6974 6820 4445 5220 656e  rray with DER en
│ │ │ │ -00001620: 636f 6469 6e67 206f 6620 5447 532d 5245  coding of TGS-RE
│ │ │ │ -00001630: 512e 0a0a 2020 2020 202a 4465 7363 7269  Q...     *Descri
│ │ │ │ -00001640: 7074 696f 6e3a 2a20 4445 5220 656e 636f  ption:* DER enco
│ │ │ │ -00001650: 6465 2054 4753 2d52 4551 2e20 4f55 5420  de TGS-REQ. OUT 
│ │ │ │ -00001660: 6973 2061 6c6c 6f63 6174 6564 2062 7920  is allocated by 
│ │ │ │ -00001670: 7468 6973 0a20 2020 2020 6675 6e63 7469  this.     functi
│ │ │ │ -00001680: 6f6e 2c20 616e 6420 6974 2069 7320 7468  on, and it is th
│ │ │ │ -00001690: 6520 7265 7370 6f6e 7369 6269 6c69 7479  e responsibility
│ │ │ │ -000016a0: 206f 6620 6361 6c6c 6572 2074 6f20 6465   of caller to de
│ │ │ │ -000016b0: 616c 6c6f 6361 7465 2069 742e 0a0a 2020  allocate it...  
│ │ │ │ -000016c0: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ -000016d0: 3a2a 2052 6574 7572 6e73 2053 4849 5348  :* Returns SHISH
│ │ │ │ -000016e0: 495f 4f4b 2069 6666 2073 7563 6365 7373  I_OK iff success
│ │ │ │ -000016f0: 6675 6c2e 0a0a 7368 6973 6869 5f74 6773  ful...shishi_tgs
│ │ │ │ -00001700: 5f72 6571 5f64 6572 5f73 6574 0a2d 2d2d  _req_der_set.---
│ │ │ │ +000013f0: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ +00001400: 2076 6f69 6420 7368 6973 6869 5f74 6773   void shishi_tgs
│ │ │ │ +00001410: 5f72 6571 5f73 6574 2028 5368 6973 6869  _req_set (Shishi
│ │ │ │ +00001420: 5f74 6773 202a 2054 4753 2c0a 2020 2020  _tgs * TGS,.    
│ │ │ │ +00001430: 2020 2020 2020 5368 6973 6869 5f61 736e        Shishi_asn
│ │ │ │ +00001440: 3120 5447 5352 4551 290a 2020 2020 2054  1 TGSREQ).     T
│ │ │ │ +00001450: 4753 3a20 7374 7275 6374 7572 6520 7468  GS: structure th
│ │ │ │ +00001460: 6174 2068 6f6c 6473 2069 6e66 6f72 6d61  at holds informa
│ │ │ │ +00001470: 7469 6f6e 2061 626f 7574 2054 4753 2065  tion about TGS e
│ │ │ │ +00001480: 7863 6861 6e67 650a 2020 2020 2054 4753  xchange.     TGS
│ │ │ │ +00001490: 5245 513a 2074 6773 7265 7120 746f 2073  REQ: tgsreq to s
│ │ │ │ +000014a0: 746f 7265 2069 6e20 5447 532e 0a0a 2020  tore in TGS...  
│ │ │ │ +000014b0: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ +000014c0: 2a20 5365 7420 7468 6520 5447 532d 5245  * Set the TGS-RE
│ │ │ │ +000014d0: 5120 696e 2074 6865 2054 4753 2065 7863  Q in the TGS exc
│ │ │ │ +000014e0: 6861 6e67 652e 0a0a 7368 6973 6869 5f74  hange...shishi_t
│ │ │ │ +000014f0: 6773 5f72 6571 5f64 6572 0a2d 2d2d 2d2d  gs_req_der.-----
│ │ │ │ +00001500: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ +00001510: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ +00001520: 2073 6869 7368 695f 7467 735f 7265 715f   shishi_tgs_req_
│ │ │ │ +00001530: 6465 7220 2853 6869 7368 695f 7467 7320  der (Shishi_tgs 
│ │ │ │ +00001540: 2a20 5447 532c 2063 6861 7220 2a2a 204f  * TGS, char ** O
│ │ │ │ +00001550: 5554 2c0a 2020 2020 2020 2020 2020 7369  UT,.          si
│ │ │ │ +00001560: 7a65 5f74 202a 204f 5554 4c45 4e29 0a20  ze_t * OUTLEN). 
│ │ │ │ +00001570: 2020 2020 5447 533a 2073 7472 7563 7475      TGS: structu
│ │ │ │ +00001580: 7265 2074 6861 7420 686f 6c64 7320 696e  re that holds in
│ │ │ │ +00001590: 666f 726d 6174 696f 6e20 6162 6f75 7420  formation about 
│ │ │ │ +000015a0: 5447 5320 6578 6368 616e 6765 0a20 2020  TGS exchange.   
│ │ │ │ +000015b0: 2020 4f55 543a 206f 7574 7075 7420 6172    OUT: output ar
│ │ │ │ +000015c0: 7261 7920 7769 7468 206e 6577 6c79 2061  ray with newly a
│ │ │ │ +000015d0: 6c6c 6f63 6174 6564 2044 4552 2065 6e63  llocated DER enc
│ │ │ │ +000015e0: 6f64 696e 6720 6f66 2054 4753 2d52 4551  oding of TGS-REQ
│ │ │ │ +000015f0: 2e0a 2020 2020 204f 5554 4c45 4e3a 206c  ..     OUTLEN: l
│ │ │ │ +00001600: 656e 6774 6820 6f66 206f 7574 7075 7420  ength of output 
│ │ │ │ +00001610: 6172 7261 7920 7769 7468 2044 4552 2065  array with DER e
│ │ │ │ +00001620: 6e63 6f64 696e 6720 6f66 2054 4753 2d52  ncoding of TGS-R
│ │ │ │ +00001630: 4551 2e0a 0a20 2020 2020 2a44 6573 6372  EQ...     *Descr
│ │ │ │ +00001640: 6970 7469 6f6e 3a2a 2044 4552 2065 6e63  iption:* DER enc
│ │ │ │ +00001650: 6f64 6520 5447 532d 5245 512e 204f 5554  ode TGS-REQ. OUT
│ │ │ │ +00001660: 2069 7320 616c 6c6f 6361 7465 6420 6279   is allocated by
│ │ │ │ +00001670: 2074 6869 730a 2020 2020 2066 756e 6374   this.     funct
│ │ │ │ +00001680: 696f 6e2c 2061 6e64 2069 7420 6973 2074  ion, and it is t
│ │ │ │ +00001690: 6865 2072 6573 706f 6e73 6962 696c 6974  he responsibilit
│ │ │ │ +000016a0: 7920 6f66 2063 616c 6c65 7220 746f 2064  y of caller to d
│ │ │ │ +000016b0: 6561 6c6c 6f63 6174 6520 6974 2e0a 0a20  eallocate it... 
│ │ │ │ +000016c0: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ +000016d0: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ +000016e0: 4849 5f4f 4b20 6966 6620 7375 6363 6573  HI_OK iff succes
│ │ │ │ +000016f0: 7366 756c 2e0a 0a73 6869 7368 695f 7467  sful...shishi_tg
│ │ │ │ +00001700: 735f 7265 715f 6465 725f 7365 740a 2d2d  s_req_der_set.--
│ │ │ │  00001710: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00001720: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ -00001730: 6e3a 2069 6e74 2073 6869 7368 695f 7467  n: int shishi_tg
│ │ │ │ -00001740: 735f 7265 715f 6465 725f 7365 7420 2853  s_req_der_set (S
│ │ │ │ -00001750: 6869 7368 695f 7467 7320 2a20 5447 532c  hishi_tgs * TGS,
│ │ │ │ -00001760: 2063 6861 7220 2a20 4445 522c 0a20 2020   char * DER,.   
│ │ │ │ -00001770: 2020 2020 2020 2073 697a 655f 7420 4445         size_t DE
│ │ │ │ -00001780: 524c 454e 290a 2020 2020 2054 4753 3a20  RLEN).     TGS: 
│ │ │ │ -00001790: 7374 7275 6374 7572 6520 7468 6174 2068  structure that h
│ │ │ │ -000017a0: 6f6c 6473 2069 6e66 6f72 6d61 7469 6f6e  olds information
│ │ │ │ -000017b0: 2061 626f 7574 2054 4753 2065 7863 6861   about TGS excha
│ │ │ │ -000017c0: 6e67 650a 2020 2020 2044 4552 3a20 696e  nge.     DER: in
│ │ │ │ -000017d0: 7075 7420 6172 7261 7920 7769 7468 2044  put array with D
│ │ │ │ -000017e0: 4552 2065 6e63 6f64 6564 2041 502d 5245  ER encoded AP-RE
│ │ │ │ -000017f0: 512e 0a20 2020 2020 4445 524c 454e 3a20  Q..     DERLEN: 
│ │ │ │ -00001800: 6c65 6e67 7468 206f 6620 696e 7075 7420  length of input 
│ │ │ │ -00001810: 6172 7261 7920 7769 7468 2044 4552 2065  array with DER e
│ │ │ │ -00001820: 6e63 6f64 6564 2041 502d 5245 512e 0a0a  ncoded AP-REQ...
│ │ │ │ -00001830: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ -00001840: 6e3a 2a20 4445 5220 6465 636f 6465 2054  n:* DER decode T
│ │ │ │ -00001850: 4753 2d52 4551 2061 6e64 2073 6574 2069  GS-REQ and set i
│ │ │ │ -00001860: 7420 5447 5320 6578 6368 616e 6765 2e20  t TGS exchange. 
│ │ │ │ -00001870: 2049 660a 2020 2020 2064 6563 6f64 696e   If.     decodin
│ │ │ │ -00001880: 6720 6661 696c 732c 2074 6865 2054 4753  g fails, the TGS
│ │ │ │ -00001890: 2d52 4551 2069 6e20 7468 6520 5447 5320  -REQ in the TGS 
│ │ │ │ -000018a0: 6578 6368 616e 6765 2072 656d 6169 6e73  exchange remains
│ │ │ │ -000018b0: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ -000018c0: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ -000018d0: 5348 4953 4849 5f4f 4b2e 0a0a 7368 6973  SHISHI_OK...shis
│ │ │ │ -000018e0: 6869 5f74 6773 5f72 6571 5f70 726f 6365  hi_tgs_req_proce
│ │ │ │ -000018f0: 7373 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ss.-------------
│ │ │ │ -00001900: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ -00001910: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ -00001920: 7368 695f 7467 735f 7265 715f 7072 6f63  shi_tgs_req_proc
│ │ │ │ -00001930: 6573 7320 2853 6869 7368 695f 7467 7320  ess (Shishi_tgs 
│ │ │ │ -00001940: 2a20 5447 5329 0a20 2020 2020 5447 533a  * TGS).     TGS:
│ │ │ │ -00001950: 2073 7472 7563 7475 7265 2074 6861 7420   structure that 
│ │ │ │ -00001960: 686f 6c64 7320 696e 666f 726d 6174 696f  holds informatio
│ │ │ │ -00001970: 6e20 6162 6f75 7420 5447 5320 6578 6368  n about TGS exch
│ │ │ │ -00001980: 616e 6765 0a0a 2020 2020 202a 4465 7363  ange..     *Desc
│ │ │ │ -00001990: 7269 7074 696f 6e3a 2a20 5072 6f63 6573  ription:* Proces
│ │ │ │ -000019a0: 7320 6e65 7720 5447 532d 5245 5120 616e  s new TGS-REQ an
│ │ │ │ -000019b0: 6420 7365 7420 7469 636b 6574 2e20 2054  d set ticket.  T
│ │ │ │ -000019c0: 6865 206b 6579 2074 6f0a 2020 2020 2064  he key to.     d
│ │ │ │ -000019d0: 6563 7279 7074 2074 6865 2054 4753 2d52  ecrypt the TGS-R
│ │ │ │ -000019e0: 4551 2069 7320 7461 6b65 6e20 6672 6f6d  EQ is taken from
│ │ │ │ -000019f0: 2074 6865 2045 6e63 4b44 4352 6571 5061   the EncKDCReqPa
│ │ │ │ -00001a00: 7274 206f 6620 7468 6520 5447 530a 2020  rt of the TGS.  
│ │ │ │ -00001a10: 2020 2074 6774 6963 6b65 742e 0a0a 2020     tgticket...  
│ │ │ │ -00001a20: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ -00001a30: 3a2a 2052 6574 7572 6e73 2053 4849 5348  :* Returns SHISH
│ │ │ │ -00001a40: 495f 4f4b 2069 6666 2073 7563 6365 7373  I_OK iff success
│ │ │ │ -00001a50: 6675 6c2e 0a0a 7368 6973 6869 5f74 6773  ful...shishi_tgs
│ │ │ │ -00001a60: 5f72 6571 5f62 7569 6c64 0a2d 2d2d 2d2d  _req_build.-----
│ │ │ │ -00001a70: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -00001a80: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ -00001a90: 6e74 2073 6869 7368 695f 7467 735f 7265  nt shishi_tgs_re
│ │ │ │ -00001aa0: 715f 6275 696c 6420 2853 6869 7368 695f  q_build (Shishi_
│ │ │ │ -00001ab0: 7467 7320 2a20 5447 5329 0a20 2020 2020  tgs * TGS).     
│ │ │ │ -00001ac0: 5447 533a 2073 7472 7563 7475 7265 2074  TGS: structure t
│ │ │ │ -00001ad0: 6861 7420 686f 6c64 7320 696e 666f 726d  hat holds inform
│ │ │ │ -00001ae0: 6174 696f 6e20 6162 6f75 7420 5447 5320  ation about TGS 
│ │ │ │ -00001af0: 6578 6368 616e 6765 0a0a 2020 2020 202a  exchange..     *
│ │ │ │ -00001b00: 4465 7363 7269 7074 696f 6e3a 2a20 4368  Description:* Ch
│ │ │ │ -00001b10: 6563 6b73 756d 2064 6174 6120 696e 2061  ecksum data in a
│ │ │ │ -00001b20: 7574 6865 6e74 6963 6174 6f72 2061 6e64  uthenticator and
│ │ │ │ -00001b30: 2061 6464 2074 6963 6b65 7420 616e 640a   add ticket and.
│ │ │ │ -00001b40: 2020 2020 2061 7574 6865 6e74 6963 6174       authenticat
│ │ │ │ -00001b50: 6f72 2074 6f20 5447 532d 5245 512e 0a0a  or to TGS-REQ...
│ │ │ │ -00001b60: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ -00001b70: 7565 3a2a 2052 6574 7572 6e73 2053 4849  ue:* Returns SHI
│ │ │ │ -00001b80: 5348 495f 4f4b 2069 6666 2073 7563 6365  SHI_OK iff succe
│ │ │ │ -00001b90: 7373 6675 6c2e 0a0a 7368 6973 6869 5f74  ssful...shishi_t
│ │ │ │ -00001ba0: 6773 5f72 6570 0a2d 2d2d 2d2d 2d2d 2d2d  gs_rep.---------
│ │ │ │ -00001bb0: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ -00001bc0: 696f 6e3a 2053 6869 7368 695f 6173 6e31  ion: Shishi_asn1
│ │ │ │ -00001bd0: 2073 6869 7368 695f 7467 735f 7265 7020   shishi_tgs_rep 
│ │ │ │ -00001be0: 2853 6869 7368 695f 7467 7320 2a20 5447  (Shishi_tgs * TG
│ │ │ │ -00001bf0: 5329 0a20 2020 2020 5447 533a 2073 7472  S).     TGS: str
│ │ │ │ -00001c00: 7563 7475 7265 2074 6861 7420 686f 6c64  ucture that hold
│ │ │ │ -00001c10: 7320 696e 666f 726d 6174 696f 6e20 6162  s information ab
│ │ │ │ -00001c20: 6f75 7420 5447 5320 6578 6368 616e 6765  out TGS exchange
│ │ │ │ -00001c30: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ -00001c40: 696f 6e3a 2a20 4765 7420 5447 532d 5245  ion:* Get TGS-RE
│ │ │ │ -00001c50: 5020 6672 6f6d 2054 4753 2065 7863 6861  P from TGS excha
│ │ │ │ -00001c60: 6e67 652e 0a0a 2020 2020 202a 5265 7475  nge...     *Retu
│ │ │ │ -00001c70: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ -00001c80: 6e73 2074 6865 2072 6563 6569 7665 6420  ns the received 
│ │ │ │ -00001c90: 5447 532d 5245 5020 6672 6f6d 2074 6865  TGS-REP from the
│ │ │ │ -00001ca0: 2054 4753 2065 7863 6861 6e67 652c 0a20   TGS exchange,. 
│ │ │ │ -00001cb0: 2020 2020 6f72 204e 554c 4c20 6966 206e      or NULL if n
│ │ │ │ -00001cc0: 6f74 2079 6574 2073 6574 206f 7220 616e  ot yet set or an
│ │ │ │ -00001cd0: 2065 7272 6f72 206f 6363 7572 6564 2e0a   error occured..
│ │ │ │ -00001ce0: 0a73 6869 7368 695f 7467 735f 7265 705f  .shishi_tgs_rep_
│ │ │ │ -00001cf0: 6465 720a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  der.------------
│ │ │ │ -00001d00: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ -00001d10: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ -00001d20: 5f74 6773 5f72 6570 5f64 6572 2028 5368  _tgs_rep_der (Sh
│ │ │ │ -00001d30: 6973 6869 5f74 6773 202a 2054 4753 2c20  ishi_tgs * TGS, 
│ │ │ │ -00001d40: 6368 6172 202a 2a20 4f55 542c 0a20 2020  char ** OUT,.   
│ │ │ │ -00001d50: 2020 2020 2020 2073 697a 655f 7420 2a20         size_t * 
│ │ │ │ -00001d60: 4f55 544c 454e 290a 2020 2020 2054 4753  OUTLEN).     TGS
│ │ │ │ -00001d70: 3a20 7374 7275 6374 7572 6520 7468 6174  : structure that
│ │ │ │ -00001d80: 2068 6f6c 6473 2069 6e66 6f72 6d61 7469   holds informati
│ │ │ │ -00001d90: 6f6e 2061 626f 7574 2054 4753 2065 7863  on about TGS exc
│ │ │ │ -00001da0: 6861 6e67 650a 2020 2020 204f 5554 3a20  hange.     OUT: 
│ │ │ │ -00001db0: 6f75 7470 7574 2061 7272 6179 2077 6974  output array wit
│ │ │ │ -00001dc0: 6820 6e65 776c 7920 616c 6c6f 6361 7465  h newly allocate
│ │ │ │ -00001dd0: 6420 4445 5220 656e 636f 6469 6e67 206f  d DER encoding o
│ │ │ │ -00001de0: 6620 5447 532d 5245 502e 0a20 2020 2020  f TGS-REP..     
│ │ │ │ -00001df0: 4f55 544c 454e 3a20 6c65 6e67 7468 206f  OUTLEN: length o
│ │ │ │ -00001e00: 6620 6f75 7470 7574 2061 7272 6179 2077  f output array w
│ │ │ │ -00001e10: 6974 6820 4445 5220 656e 636f 6469 6e67  ith DER encoding
│ │ │ │ -00001e20: 206f 6620 5447 532d 5245 502e 0a0a 2020   of TGS-REP...  
│ │ │ │ -00001e30: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ -00001e40: 2a20 4445 5220 656e 636f 6465 2054 4753  * DER encode TGS
│ │ │ │ -00001e50: 2d52 4550 2e20 4f55 5420 6973 2061 6c6c  -REP. OUT is all
│ │ │ │ -00001e60: 6f63 6174 6564 2062 7920 7468 6973 0a20  ocated by this. 
│ │ │ │ -00001e70: 2020 2020 6675 6e63 7469 6f6e 2c20 616e      function, an
│ │ │ │ -00001e80: 6420 6974 2069 7320 7468 6520 7265 7370  d it is the resp
│ │ │ │ -00001e90: 6f6e 7369 6269 6c69 7479 206f 6620 6361  onsibility of ca
│ │ │ │ -00001ea0: 6c6c 6572 2074 6f20 6465 616c 6c6f 6361  ller to dealloca
│ │ │ │ -00001eb0: 7465 2069 742e 0a0a 2020 2020 202a 5265  te it...     *Re
│ │ │ │ -00001ec0: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ -00001ed0: 7572 6e73 2053 4849 5348 495f 4f4b 2069  urns SHISHI_OK i
│ │ │ │ -00001ee0: 6666 2073 7563 6365 7373 6675 6c2e 0a0a  ff successful...
│ │ │ │ -00001ef0: 7368 6973 6869 5f74 6773 5f72 6570 5f70  shishi_tgs_rep_p
│ │ │ │ -00001f00: 726f 6365 7373 0a2d 2d2d 2d2d 2d2d 2d2d  rocess.---------
│ │ │ │ -00001f10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -00001f20: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ -00001f30: 2073 6869 7368 695f 7467 735f 7265 705f   shishi_tgs_rep_
│ │ │ │ -00001f40: 7072 6f63 6573 7320 2853 6869 7368 695f  process (Shishi_
│ │ │ │ -00001f50: 7467 7320 2a20 5447 5329 0a20 2020 2020  tgs * TGS).     
│ │ │ │ -00001f60: 5447 533a 2073 7472 7563 7475 7265 2074  TGS: structure t
│ │ │ │ -00001f70: 6861 7420 686f 6c64 7320 696e 666f 726d  hat holds inform
│ │ │ │ -00001f80: 6174 696f 6e20 6162 6f75 7420 5447 5320  ation about TGS 
│ │ │ │ -00001f90: 6578 6368 616e 6765 0a0a 2020 2020 202a  exchange..     *
│ │ │ │ -00001fa0: 4465 7363 7269 7074 696f 6e3a 2a20 5072  Description:* Pr
│ │ │ │ -00001fb0: 6f63 6573 7320 6e65 7720 5447 532d 5245  ocess new TGS-RE
│ │ │ │ -00001fc0: 5020 616e 6420 7365 7420 7469 636b 6574  P and set ticket
│ │ │ │ -00001fd0: 2e20 2054 6865 206b 6579 2074 6f0a 2020  .  The key to.  
│ │ │ │ -00001fe0: 2020 2064 6563 7279 7074 2074 6865 2054     decrypt the T
│ │ │ │ -00001ff0: 4753 2d52 4550 2069 7320 7461 6b65 6e20  GS-REP is taken 
│ │ │ │ -00002000: 6672 6f6d 2074 6865 2045 6e63 4b44 4352  from the EncKDCR
│ │ │ │ -00002010: 6570 5061 7274 206f 6620 7468 6520 5447  epPart of the TG
│ │ │ │ -00002020: 530a 2020 2020 2074 6774 6963 6b65 742e  S.     tgticket.
│ │ │ │ -00002030: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ -00002040: 616c 7565 3a2a 2052 6574 7572 6e73 2053  alue:* Returns S
│ │ │ │ -00002050: 4849 5348 495f 4f4b 2069 6666 2073 7563  HISHI_OK iff suc
│ │ │ │ -00002060: 6365 7373 6675 6c2e 0a0a 7368 6973 6869  cessful...shishi
│ │ │ │ -00002070: 5f74 6773 5f72 6570 5f62 7569 6c64 0a2d  _tgs_rep_build.-
│ │ │ │ +00001720: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ +00001730: 6f6e 3a20 696e 7420 7368 6973 6869 5f74  on: int shishi_t
│ │ │ │ +00001740: 6773 5f72 6571 5f64 6572 5f73 6574 2028  gs_req_der_set (
│ │ │ │ +00001750: 5368 6973 6869 5f74 6773 202a 2054 4753  Shishi_tgs * TGS
│ │ │ │ +00001760: 2c20 6368 6172 202a 2044 4552 2c0a 2020  , char * DER,.  
│ │ │ │ +00001770: 2020 2020 2020 2020 7369 7a65 5f74 2044          size_t D
│ │ │ │ +00001780: 4552 4c45 4e29 0a20 2020 2020 5447 533a  ERLEN).     TGS:
│ │ │ │ +00001790: 2073 7472 7563 7475 7265 2074 6861 7420   structure that 
│ │ │ │ +000017a0: 686f 6c64 7320 696e 666f 726d 6174 696f  holds informatio
│ │ │ │ +000017b0: 6e20 6162 6f75 7420 5447 5320 6578 6368  n about TGS exch
│ │ │ │ +000017c0: 616e 6765 0a20 2020 2020 4445 523a 2069  ange.     DER: i
│ │ │ │ +000017d0: 6e70 7574 2061 7272 6179 2077 6974 6820  nput array with 
│ │ │ │ +000017e0: 4445 5220 656e 636f 6465 6420 4150 2d52  DER encoded AP-R
│ │ │ │ +000017f0: 4551 2e0a 2020 2020 2044 4552 4c45 4e3a  EQ..     DERLEN:
│ │ │ │ +00001800: 206c 656e 6774 6820 6f66 2069 6e70 7574   length of input
│ │ │ │ +00001810: 2061 7272 6179 2077 6974 6820 4445 5220   array with DER 
│ │ │ │ +00001820: 656e 636f 6465 6420 4150 2d52 4551 2e0a  encoded AP-REQ..
│ │ │ │ +00001830: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +00001840: 6f6e 3a2a 2044 4552 2064 6563 6f64 6520  on:* DER decode 
│ │ │ │ +00001850: 5447 532d 5245 5120 616e 6420 7365 7420  TGS-REQ and set 
│ │ │ │ +00001860: 6974 2054 4753 2065 7863 6861 6e67 652e  it TGS exchange.
│ │ │ │ +00001870: 2020 4966 0a20 2020 2020 6465 636f 6469    If.     decodi
│ │ │ │ +00001880: 6e67 2066 6169 6c73 2c20 7468 6520 5447  ng fails, the TG
│ │ │ │ +00001890: 532d 5245 5120 696e 2074 6865 2054 4753  S-REQ in the TGS
│ │ │ │ +000018a0: 2065 7863 6861 6e67 6520 7265 6d61 696e   exchange remain
│ │ │ │ +000018b0: 732e 0a0a 2020 2020 202a 5265 7475 726e  s...     *Return
│ │ │ │ +000018c0: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ +000018d0: 2053 4849 5348 495f 4f4b 2e0a 0a73 6869   SHISHI_OK...shi
│ │ │ │ +000018e0: 7368 695f 7467 735f 7265 715f 7072 6f63  shi_tgs_req_proc
│ │ │ │ +000018f0: 6573 730a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ess.------------
│ │ │ │ +00001900: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +00001910: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ +00001920: 6973 6869 5f74 6773 5f72 6571 5f70 726f  ishi_tgs_req_pro
│ │ │ │ +00001930: 6365 7373 2028 5368 6973 6869 5f74 6773  cess (Shishi_tgs
│ │ │ │ +00001940: 202a 2054 4753 290a 2020 2020 2054 4753   * TGS).     TGS
│ │ │ │ +00001950: 3a20 7374 7275 6374 7572 6520 7468 6174  : structure that
│ │ │ │ +00001960: 2068 6f6c 6473 2069 6e66 6f72 6d61 7469   holds informati
│ │ │ │ +00001970: 6f6e 2061 626f 7574 2054 4753 2065 7863  on about TGS exc
│ │ │ │ +00001980: 6861 6e67 650a 0a20 2020 2020 2a44 6573  hange..     *Des
│ │ │ │ +00001990: 6372 6970 7469 6f6e 3a2a 2050 726f 6365  cription:* Proce
│ │ │ │ +000019a0: 7373 206e 6577 2054 4753 2d52 4551 2061  ss new TGS-REQ a
│ │ │ │ +000019b0: 6e64 2073 6574 2074 6963 6b65 742e 2020  nd set ticket.  
│ │ │ │ +000019c0: 5468 6520 6b65 7920 746f 0a20 2020 2020  The key to.     
│ │ │ │ +000019d0: 6465 6372 7970 7420 7468 6520 5447 532d  decrypt the TGS-
│ │ │ │ +000019e0: 5245 5120 6973 2074 616b 656e 2066 726f  REQ is taken fro
│ │ │ │ +000019f0: 6d20 7468 6520 456e 634b 4443 5265 7150  m the EncKDCReqP
│ │ │ │ +00001a00: 6172 7420 6f66 2074 6865 2054 4753 0a20  art of the TGS. 
│ │ │ │ +00001a10: 2020 2020 7467 7469 636b 6574 2e0a 0a20      tgticket... 
│ │ │ │ +00001a20: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ +00001a30: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ +00001a40: 4849 5f4f 4b20 6966 6620 7375 6363 6573  HI_OK iff succes
│ │ │ │ +00001a50: 7366 756c 2e0a 0a73 6869 7368 695f 7467  sful...shishi_tg
│ │ │ │ +00001a60: 735f 7265 715f 6275 696c 640a 2d2d 2d2d  s_req_build.----
│ │ │ │ +00001a70: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +00001a80: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +00001a90: 696e 7420 7368 6973 6869 5f74 6773 5f72  int shishi_tgs_r
│ │ │ │ +00001aa0: 6571 5f62 7569 6c64 2028 5368 6973 6869  eq_build (Shishi
│ │ │ │ +00001ab0: 5f74 6773 202a 2054 4753 290a 2020 2020  _tgs * TGS).    
│ │ │ │ +00001ac0: 2054 4753 3a20 7374 7275 6374 7572 6520   TGS: structure 
│ │ │ │ +00001ad0: 7468 6174 2068 6f6c 6473 2069 6e66 6f72  that holds infor
│ │ │ │ +00001ae0: 6d61 7469 6f6e 2061 626f 7574 2054 4753  mation about TGS
│ │ │ │ +00001af0: 2065 7863 6861 6e67 650a 0a20 2020 2020   exchange..     
│ │ │ │ +00001b00: 2a44 6573 6372 6970 7469 6f6e 3a2a 2043  *Description:* C
│ │ │ │ +00001b10: 6865 636b 7375 6d20 6461 7461 2069 6e20  hecksum data in 
│ │ │ │ +00001b20: 6175 7468 656e 7469 6361 746f 7220 616e  authenticator an
│ │ │ │ +00001b30: 6420 6164 6420 7469 636b 6574 2061 6e64  d add ticket and
│ │ │ │ +00001b40: 0a20 2020 2020 6175 7468 656e 7469 6361  .     authentica
│ │ │ │ +00001b50: 746f 7220 746f 2054 4753 2d52 4551 2e0a  tor to TGS-REQ..
│ │ │ │ +00001b60: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ +00001b70: 6c75 653a 2a20 5265 7475 726e 7320 5348  lue:* Returns SH
│ │ │ │ +00001b80: 4953 4849 5f4f 4b20 6966 6620 7375 6363  ISHI_OK iff succ
│ │ │ │ +00001b90: 6573 7366 756c 2e0a 0a73 6869 7368 695f  essful...shishi_
│ │ │ │ +00001ba0: 7467 735f 7265 700a 2d2d 2d2d 2d2d 2d2d  tgs_rep.--------
│ │ │ │ +00001bb0: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ +00001bc0: 7469 6f6e 3a20 5368 6973 6869 5f61 736e  tion: Shishi_asn
│ │ │ │ +00001bd0: 3120 7368 6973 6869 5f74 6773 5f72 6570  1 shishi_tgs_rep
│ │ │ │ +00001be0: 2028 5368 6973 6869 5f74 6773 202a 2054   (Shishi_tgs * T
│ │ │ │ +00001bf0: 4753 290a 2020 2020 2054 4753 3a20 7374  GS).     TGS: st
│ │ │ │ +00001c00: 7275 6374 7572 6520 7468 6174 2068 6f6c  ructure that hol
│ │ │ │ +00001c10: 6473 2069 6e66 6f72 6d61 7469 6f6e 2061  ds information a
│ │ │ │ +00001c20: 626f 7574 2054 4753 2065 7863 6861 6e67  bout TGS exchang
│ │ │ │ +00001c30: 650a 0a20 2020 2020 2a44 6573 6372 6970  e..     *Descrip
│ │ │ │ +00001c40: 7469 6f6e 3a2a 2047 6574 2054 4753 2d52  tion:* Get TGS-R
│ │ │ │ +00001c50: 4550 2066 726f 6d20 5447 5320 6578 6368  EP from TGS exch
│ │ │ │ +00001c60: 616e 6765 2e0a 0a20 2020 2020 2a52 6574  ange...     *Ret
│ │ │ │ +00001c70: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ +00001c80: 726e 7320 7468 6520 7265 6365 6976 6564  rns the received
│ │ │ │ +00001c90: 2054 4753 2d52 4550 2066 726f 6d20 7468   TGS-REP from th
│ │ │ │ +00001ca0: 6520 5447 5320 6578 6368 616e 6765 2c0a  e TGS exchange,.
│ │ │ │ +00001cb0: 2020 2020 206f 7220 4e55 4c4c 2069 6620       or NULL if 
│ │ │ │ +00001cc0: 6e6f 7420 7965 7420 7365 7420 6f72 2061  not yet set or a
│ │ │ │ +00001cd0: 6e20 6572 726f 7220 6f63 6375 7265 642e  n error occured.
│ │ │ │ +00001ce0: 0a0a 7368 6973 6869 5f74 6773 5f72 6570  ..shishi_tgs_rep
│ │ │ │ +00001cf0: 5f64 6572 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  _der.-----------
│ │ │ │ +00001d00: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +00001d10: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ +00001d20: 695f 7467 735f 7265 705f 6465 7220 2853  i_tgs_rep_der (S
│ │ │ │ +00001d30: 6869 7368 695f 7467 7320 2a20 5447 532c  hishi_tgs * TGS,
│ │ │ │ +00001d40: 2063 6861 7220 2a2a 204f 5554 2c0a 2020   char ** OUT,.  
│ │ │ │ +00001d50: 2020 2020 2020 2020 7369 7a65 5f74 202a          size_t *
│ │ │ │ +00001d60: 204f 5554 4c45 4e29 0a20 2020 2020 5447   OUTLEN).     TG
│ │ │ │ +00001d70: 533a 2073 7472 7563 7475 7265 2074 6861  S: structure tha
│ │ │ │ +00001d80: 7420 686f 6c64 7320 696e 666f 726d 6174  t holds informat
│ │ │ │ +00001d90: 696f 6e20 6162 6f75 7420 5447 5320 6578  ion about TGS ex
│ │ │ │ +00001da0: 6368 616e 6765 0a20 2020 2020 4f55 543a  change.     OUT:
│ │ │ │ +00001db0: 206f 7574 7075 7420 6172 7261 7920 7769   output array wi
│ │ │ │ +00001dc0: 7468 206e 6577 6c79 2061 6c6c 6f63 6174  th newly allocat
│ │ │ │ +00001dd0: 6564 2044 4552 2065 6e63 6f64 696e 6720  ed DER encoding 
│ │ │ │ +00001de0: 6f66 2054 4753 2d52 4550 2e0a 2020 2020  of TGS-REP..    
│ │ │ │ +00001df0: 204f 5554 4c45 4e3a 206c 656e 6774 6820   OUTLEN: length 
│ │ │ │ +00001e00: 6f66 206f 7574 7075 7420 6172 7261 7920  of output array 
│ │ │ │ +00001e10: 7769 7468 2044 4552 2065 6e63 6f64 696e  with DER encodin
│ │ │ │ +00001e20: 6720 6f66 2054 4753 2d52 4550 2e0a 0a20  g of TGS-REP... 
│ │ │ │ +00001e30: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ +00001e40: 3a2a 2044 4552 2065 6e63 6f64 6520 5447  :* DER encode TG
│ │ │ │ +00001e50: 532d 5245 502e 204f 5554 2069 7320 616c  S-REP. OUT is al
│ │ │ │ +00001e60: 6c6f 6361 7465 6420 6279 2074 6869 730a  located by this.
│ │ │ │ +00001e70: 2020 2020 2066 756e 6374 696f 6e2c 2061       function, a
│ │ │ │ +00001e80: 6e64 2069 7420 6973 2074 6865 2072 6573  nd it is the res
│ │ │ │ +00001e90: 706f 6e73 6962 696c 6974 7920 6f66 2063  ponsibility of c
│ │ │ │ +00001ea0: 616c 6c65 7220 746f 2064 6561 6c6c 6f63  aller to dealloc
│ │ │ │ +00001eb0: 6174 6520 6974 2e0a 0a20 2020 2020 2a52  ate it...     *R
│ │ │ │ +00001ec0: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +00001ed0: 7475 726e 7320 5348 4953 4849 5f4f 4b20  turns SHISHI_OK 
│ │ │ │ +00001ee0: 6966 6620 7375 6363 6573 7366 756c 2e0a  iff successful..
│ │ │ │ +00001ef0: 0a73 6869 7368 695f 7467 735f 7265 705f  .shishi_tgs_rep_
│ │ │ │ +00001f00: 7072 6f63 6573 730a 2d2d 2d2d 2d2d 2d2d  process.--------
│ │ │ │ +00001f10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ +00001f20: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ +00001f30: 7420 7368 6973 6869 5f74 6773 5f72 6570  t shishi_tgs_rep
│ │ │ │ +00001f40: 5f70 726f 6365 7373 2028 5368 6973 6869  _process (Shishi
│ │ │ │ +00001f50: 5f74 6773 202a 2054 4753 290a 2020 2020  _tgs * TGS).    
│ │ │ │ +00001f60: 2054 4753 3a20 7374 7275 6374 7572 6520   TGS: structure 
│ │ │ │ +00001f70: 7468 6174 2068 6f6c 6473 2069 6e66 6f72  that holds infor
│ │ │ │ +00001f80: 6d61 7469 6f6e 2061 626f 7574 2054 4753  mation about TGS
│ │ │ │ +00001f90: 2065 7863 6861 6e67 650a 0a20 2020 2020   exchange..     
│ │ │ │ +00001fa0: 2a44 6573 6372 6970 7469 6f6e 3a2a 2050  *Description:* P
│ │ │ │ +00001fb0: 726f 6365 7373 206e 6577 2054 4753 2d52  rocess new TGS-R
│ │ │ │ +00001fc0: 4550 2061 6e64 2073 6574 2074 6963 6b65  EP and set ticke
│ │ │ │ +00001fd0: 742e 2020 5468 6520 6b65 7920 746f 0a20  t.  The key to. 
│ │ │ │ +00001fe0: 2020 2020 6465 6372 7970 7420 7468 6520      decrypt the 
│ │ │ │ +00001ff0: 5447 532d 5245 5020 6973 2074 616b 656e  TGS-REP is taken
│ │ │ │ +00002000: 2066 726f 6d20 7468 6520 456e 634b 4443   from the EncKDC
│ │ │ │ +00002010: 5265 7050 6172 7420 6f66 2074 6865 2054  RepPart of the T
│ │ │ │ +00002020: 4753 0a20 2020 2020 7467 7469 636b 6574  GS.     tgticket
│ │ │ │ +00002030: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ +00002040: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ +00002050: 5348 4953 4849 5f4f 4b20 6966 6620 7375  SHISHI_OK iff su
│ │ │ │ +00002060: 6363 6573 7366 756c 2e0a 0a73 6869 7368  ccessful...shish
│ │ │ │ +00002070: 695f 7467 735f 7265 705f 6275 696c 640a  i_tgs_rep_build.
│ │ │ │  00002080: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00002090: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ -000020a0: 6e3a 2069 6e74 2073 6869 7368 695f 7467  n: int shishi_tg
│ │ │ │ -000020b0: 735f 7265 705f 6275 696c 6420 2853 6869  s_rep_build (Shi
│ │ │ │ -000020c0: 7368 695f 7467 7320 2a20 5447 532c 2069  shi_tgs * TGS, i
│ │ │ │ -000020d0: 6e74 204b 4559 5553 4147 452c 0a20 2020  nt KEYUSAGE,.   
│ │ │ │ -000020e0: 2020 2020 2020 2053 6869 7368 695f 6b65         Shishi_ke
│ │ │ │ -000020f0: 7920 2a20 4b45 5929 0a20 2020 2020 5447  y * KEY).     TG
│ │ │ │ -00002100: 533a 2073 7472 7563 7475 7265 2074 6861  S: structure tha
│ │ │ │ -00002110: 7420 686f 6c64 7320 696e 666f 726d 6174  t holds informat
│ │ │ │ -00002120: 696f 6e20 6162 6f75 7420 5447 5320 6578  ion about TGS ex
│ │ │ │ -00002130: 6368 616e 6765 0a20 2020 2020 4b45 5955  change.     KEYU
│ │ │ │ -00002140: 5341 4745 3a20 6b65 7975 7361 6765 2069  SAGE: keyusage i
│ │ │ │ -00002150: 6e74 6567 6572 2e0a 2020 2020 204b 4559  nteger..     KEY
│ │ │ │ -00002160: 3a20 7573 6572 2773 206b 6579 2c20 7573  : user's key, us
│ │ │ │ -00002170: 6564 2074 6f20 656e 6372 7970 7420 7468  ed to encrypt th
│ │ │ │ -00002180: 6520 656e 6372 7970 7465 6420 7061 7274  e encrypted part
│ │ │ │ -00002190: 206f 6620 7468 6520 5447 532d 5245 502e   of the TGS-REP.
│ │ │ │ -000021a0: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ -000021b0: 696f 6e3a 2a20 4275 696c 6420 5447 532d  ion:* Build TGS-
│ │ │ │ -000021c0: 5245 502e 0a0a 2020 2020 202a 5265 7475  REP...     *Retu
│ │ │ │ -000021d0: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ -000021e0: 6e73 2053 4849 5348 495f 4f4b 2069 6666  ns SHISHI_OK iff
│ │ │ │ -000021f0: 2073 7563 6365 7373 6675 6c2e 0a0a 7368   successful...sh
│ │ │ │ -00002200: 6973 6869 5f74 6773 5f6b 7262 6572 726f  ishi_tgs_krberro
│ │ │ │ -00002210: 720a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  r.--------------
│ │ │ │ -00002220: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ -00002230: 696f 6e3a 2053 6869 7368 695f 6173 6e31  ion: Shishi_asn1
│ │ │ │ -00002240: 2073 6869 7368 695f 7467 735f 6b72 6265   shishi_tgs_krbe
│ │ │ │ -00002250: 7272 6f72 2028 5368 6973 6869 5f74 6773  rror (Shishi_tgs
│ │ │ │ -00002260: 202a 2054 4753 290a 2020 2020 2054 4753   * TGS).     TGS
│ │ │ │ -00002270: 3a20 7374 7275 6374 7572 6520 7468 6174  : structure that
│ │ │ │ -00002280: 2068 6f6c 6473 2069 6e66 6f72 6d61 7469   holds informati
│ │ │ │ -00002290: 6f6e 2061 626f 7574 2054 4753 2065 7863  on about TGS exc
│ │ │ │ -000022a0: 6861 6e67 650a 0a20 2020 2020 2a44 6573  hange..     *Des
│ │ │ │ -000022b0: 6372 6970 7469 6f6e 3a2a 2047 6574 204b  cription:* Get K
│ │ │ │ -000022c0: 5242 2d45 5252 4f52 2066 726f 6d20 5447  RB-ERROR from TG
│ │ │ │ -000022d0: 5320 6578 6368 616e 6765 2e0a 0a20 2020  S exchange...   
│ │ │ │ -000022e0: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ -000022f0: 2a20 5265 7475 726e 7320 7468 6520 7265  * Returns the re
│ │ │ │ -00002300: 6365 6976 6564 2054 4753 2d52 4550 2066  ceived TGS-REP f
│ │ │ │ -00002310: 726f 6d20 7468 6520 5447 5320 6578 6368  rom the TGS exch
│ │ │ │ -00002320: 616e 6765 2c0a 2020 2020 206f 7220 4e55  ange,.     or NU
│ │ │ │ -00002330: 4c4c 2069 6620 6e6f 7420 7965 7420 7365  LL if not yet se
│ │ │ │ -00002340: 7420 6f72 2061 6e20 6572 726f 7220 6f63  t or an error oc
│ │ │ │ -00002350: 6375 7265 642e 0a0a 7368 6973 6869 5f74  cured...shishi_t
│ │ │ │ -00002360: 6773 5f6b 7262 6572 726f 725f 6465 720a  gs_krberror_der.
│ │ │ │ -00002370: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00002380: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ -00002390: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ -000023a0: 695f 7467 735f 6b72 6265 7272 6f72 5f64  i_tgs_krberror_d
│ │ │ │ -000023b0: 6572 2028 5368 6973 6869 5f74 6773 202a  er (Shishi_tgs *
│ │ │ │ -000023c0: 2054 4753 2c0a 2020 2020 2020 2020 2020   TGS,.          
│ │ │ │ -000023d0: 6368 6172 202a 2a20 4f55 542c 2073 697a  char ** OUT, siz
│ │ │ │ -000023e0: 655f 7420 2a20 4f55 544c 454e 290a 2020  e_t * OUTLEN).  
│ │ │ │ -000023f0: 2020 2054 4753 3a20 7374 7275 6374 7572     TGS: structur
│ │ │ │ -00002400: 6520 7468 6174 2068 6f6c 6473 2069 6e66  e that holds inf
│ │ │ │ -00002410: 6f72 6d61 7469 6f6e 2061 626f 7574 2054  ormation about T
│ │ │ │ -00002420: 4753 2065 7863 6861 6e67 650a 2020 2020  GS exchange.    
│ │ │ │ -00002430: 204f 5554 3a20 6f75 7470 7574 2061 7272   OUT: output arr
│ │ │ │ -00002440: 6179 2077 6974 6820 6e65 776c 7920 616c  ay with newly al
│ │ │ │ -00002450: 6c6f 6361 7465 6420 4445 5220 656e 636f  located DER enco
│ │ │ │ -00002460: 6469 6e67 206f 6620 4b52 422d 4552 524f  ding of KRB-ERRO
│ │ │ │ -00002470: 522e 0a20 2020 2020 4f55 544c 454e 3a20  R..     OUTLEN: 
│ │ │ │ -00002480: 6c65 6e67 7468 206f 6620 6f75 7470 7574  length of output
│ │ │ │ -00002490: 2061 7272 6179 2077 6974 6820 4445 5220   array with DER 
│ │ │ │ -000024a0: 656e 636f 6469 6e67 206f 6620 4b52 422d  encoding of KRB-
│ │ │ │ -000024b0: 4552 524f 522e 0a0a 2020 2020 202a 4465  ERROR...     *De
│ │ │ │ -000024c0: 7363 7269 7074 696f 6e3a 2a20 4445 5220  scription:* DER 
│ │ │ │ -000024d0: 656e 636f 6465 204b 5242 2d45 5252 4f52  encode KRB-ERROR
│ │ │ │ -000024e0: 2e20 4f55 5420 6973 2061 6c6c 6f63 6174  . OUT is allocat
│ │ │ │ -000024f0: 6564 2062 7920 7468 6973 0a20 2020 2020  ed by this.     
│ │ │ │ -00002500: 6675 6e63 7469 6f6e 2c20 616e 6420 6974  function, and it
│ │ │ │ -00002510: 2069 7320 7468 6520 7265 7370 6f6e 7369   is the responsi
│ │ │ │ -00002520: 6269 6c69 7479 206f 6620 6361 6c6c 6572  bility of caller
│ │ │ │ -00002530: 2074 6f20 6465 616c 6c6f 6361 7465 2069   to deallocate i
│ │ │ │ -00002540: 742e 0a0a 2020 2020 202a 5265 7475 726e  t...     *Return
│ │ │ │ -00002550: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ -00002560: 2053 4849 5348 495f 4f4b 2069 6666 2073   SHISHI_OK iff s
│ │ │ │ -00002570: 7563 6365 7373 6675 6c2e 0a0a 7368 6973  uccessful...shis
│ │ │ │ -00002580: 6869 5f74 6773 5f6b 7262 6572 726f 725f  hi_tgs_krberror_
│ │ │ │ -00002590: 7365 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  set.------------
│ │ │ │ -000025a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ -000025b0: 2046 756e 6374 696f 6e3a 2076 6f69 6420   Function: void 
│ │ │ │ -000025c0: 7368 6973 6869 5f74 6773 5f6b 7262 6572  shishi_tgs_krber
│ │ │ │ -000025d0: 726f 725f 7365 7420 2853 6869 7368 695f  ror_set (Shishi_
│ │ │ │ -000025e0: 7467 7320 2a20 5447 532c 0a20 2020 2020  tgs * TGS,.     
│ │ │ │ -000025f0: 2020 2020 2053 6869 7368 695f 6173 6e31       Shishi_asn1
│ │ │ │ -00002600: 204b 5242 4552 524f 5229 0a20 2020 2020   KRBERROR).     
│ │ │ │ -00002610: 5447 533a 2073 7472 7563 7475 7265 2074  TGS: structure t
│ │ │ │ -00002620: 6861 7420 686f 6c64 7320 696e 666f 726d  hat holds inform
│ │ │ │ -00002630: 6174 696f 6e20 6162 6f75 7420 5447 5320  ation about TGS 
│ │ │ │ -00002640: 6578 6368 616e 6765 0a20 2020 2020 4b52  exchange.     KR
│ │ │ │ -00002650: 4245 5252 4f52 3a20 6b72 6265 7272 6f72  BERROR: krberror
│ │ │ │ -00002660: 2074 6f20 7374 6f72 6520 696e 2054 4753   to store in TGS
│ │ │ │ -00002670: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ -00002680: 7469 6f6e 3a2a 2053 6574 2074 6865 204b  tion:* Set the K
│ │ │ │ -00002690: 5242 2d45 5252 4f52 2069 6e20 7468 6520  RB-ERROR in the 
│ │ │ │ -000026a0: 5447 5320 6578 6368 616e 6765 2e0a 0a73  TGS exchange...s
│ │ │ │ -000026b0: 6869 7368 695f 7467 735f 746b 740a 2d2d  hishi_tgs_tkt.--
│ │ │ │ -000026c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ -000026d0: 2d20 4675 6e63 7469 6f6e 3a20 5368 6973  - Function: Shis
│ │ │ │ -000026e0: 6869 5f74 6b74 202a 2073 6869 7368 695f  hi_tkt * shishi_
│ │ │ │ -000026f0: 7467 735f 746b 7420 2853 6869 7368 695f  tgs_tkt (Shishi_
│ │ │ │ -00002700: 7467 7320 2a20 5447 5329 0a20 2020 2020  tgs * TGS).     
│ │ │ │ -00002710: 5447 533a 2073 7472 7563 7475 7265 2074  TGS: structure t
│ │ │ │ -00002720: 6861 7420 686f 6c64 7320 696e 666f 726d  hat holds inform
│ │ │ │ -00002730: 6174 696f 6e20 6162 6f75 7420 5447 5320  ation about TGS 
│ │ │ │ -00002740: 6578 6368 616e 6765 0a0a 2020 2020 202a  exchange..     *
│ │ │ │ -00002750: 4465 7363 7269 7074 696f 6e3a 2a20 4765  Description:* Ge
│ │ │ │ -00002760: 7420 5469 636b 6574 2066 726f 6d20 5447  t Ticket from TG
│ │ │ │ -00002770: 5320 6578 6368 616e 6765 2e0a 0a20 2020  S exchange...   
│ │ │ │ -00002780: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ -00002790: 2a20 5265 7475 726e 7320 7468 6520 6e65  * Returns the ne
│ │ │ │ -000027a0: 776c 7920 6163 7175 6972 6564 2074 6963  wly acquired tic
│ │ │ │ -000027b0: 6b65 7420 6672 6f6d 2074 6865 2054 4753  ket from the TGS
│ │ │ │ -000027c0: 0a20 2020 2020 6578 6368 616e 6765 2c20  .     exchange, 
│ │ │ │ -000027d0: 6f72 204e 554c 4c20 6966 206e 6f74 2079  or NULL if not y
│ │ │ │ -000027e0: 6574 2073 6574 206f 7220 616e 2065 7272  et set or an err
│ │ │ │ -000027f0: 6f72 206f 6363 7572 6564 2e0a 0a73 6869  or occured...shi
│ │ │ │ -00002800: 7368 695f 7467 735f 746b 745f 7365 740a  shi_tgs_tkt_set.
│ │ │ │ -00002810: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00002820: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ -00002830: 3a20 766f 6964 2073 6869 7368 695f 7467  : void shishi_tg
│ │ │ │ -00002840: 735f 746b 745f 7365 7420 2853 6869 7368  s_tkt_set (Shish
│ │ │ │ -00002850: 695f 7467 7320 2a20 5447 532c 0a20 2020  i_tgs * TGS,.   
│ │ │ │ -00002860: 2020 2020 2020 2053 6869 7368 695f 746b         Shishi_tk
│ │ │ │ -00002870: 7420 2a20 544b 5429 0a20 2020 2020 5447  t * TKT).     TG
│ │ │ │ -00002880: 533a 2073 7472 7563 7475 7265 2074 6861  S: structure tha
│ │ │ │ -00002890: 7420 686f 6c64 7320 696e 666f 726d 6174  t holds informat
│ │ │ │ -000028a0: 696f 6e20 6162 6f75 7420 5447 5320 6578  ion about TGS ex
│ │ │ │ -000028b0: 6368 616e 6765 0a20 2020 2020 544b 543a  change.     TKT:
│ │ │ │ -000028c0: 2074 6963 6b65 7420 746f 2073 746f 7265   ticket to store
│ │ │ │ -000028d0: 2069 6e20 5447 532e 0a0a 2020 2020 202a   in TGS...     *
│ │ │ │ -000028e0: 4465 7363 7269 7074 696f 6e3a 2a20 5365  Description:* Se
│ │ │ │ -000028f0: 7420 7468 6520 5469 636b 6574 2069 6e20  t the Ticket in 
│ │ │ │ -00002900: 7468 6520 5447 5320 6578 6368 616e 6765  the TGS exchange
│ │ │ │ -00002910: 2e0a 0a73 6869 7368 695f 7467 735f 7365  ...shishi_tgs_se
│ │ │ │ -00002920: 6e64 7265 6376 5f68 696e 740a 2d2d 2d2d  ndrecv_hint.----
│ │ │ │ +00002090: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ +000020a0: 6f6e 3a20 696e 7420 7368 6973 6869 5f74  on: int shishi_t
│ │ │ │ +000020b0: 6773 5f72 6570 5f62 7569 6c64 2028 5368  gs_rep_build (Sh
│ │ │ │ +000020c0: 6973 6869 5f74 6773 202a 2054 4753 2c20  ishi_tgs * TGS, 
│ │ │ │ +000020d0: 696e 7420 4b45 5955 5341 4745 2c0a 2020  int KEYUSAGE,.  
│ │ │ │ +000020e0: 2020 2020 2020 2020 5368 6973 6869 5f6b          Shishi_k
│ │ │ │ +000020f0: 6579 202a 204b 4559 290a 2020 2020 2054  ey * KEY).     T
│ │ │ │ +00002100: 4753 3a20 7374 7275 6374 7572 6520 7468  GS: structure th
│ │ │ │ +00002110: 6174 2068 6f6c 6473 2069 6e66 6f72 6d61  at holds informa
│ │ │ │ +00002120: 7469 6f6e 2061 626f 7574 2054 4753 2065  tion about TGS e
│ │ │ │ +00002130: 7863 6861 6e67 650a 2020 2020 204b 4559  xchange.     KEY
│ │ │ │ +00002140: 5553 4147 453a 206b 6579 7573 6167 6520  USAGE: keyusage 
│ │ │ │ +00002150: 696e 7465 6765 722e 0a20 2020 2020 4b45  integer..     KE
│ │ │ │ +00002160: 593a 2075 7365 7227 7320 6b65 792c 2075  Y: user's key, u
│ │ │ │ +00002170: 7365 6420 746f 2065 6e63 7279 7074 2074  sed to encrypt t
│ │ │ │ +00002180: 6865 2065 6e63 7279 7074 6564 2070 6172  he encrypted par
│ │ │ │ +00002190: 7420 6f66 2074 6865 2054 4753 2d52 4550  t of the TGS-REP
│ │ │ │ +000021a0: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ +000021b0: 7469 6f6e 3a2a 2042 7569 6c64 2054 4753  tion:* Build TGS
│ │ │ │ +000021c0: 2d52 4550 2e0a 0a20 2020 2020 2a52 6574  -REP...     *Ret
│ │ │ │ +000021d0: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ +000021e0: 726e 7320 5348 4953 4849 5f4f 4b20 6966  rns SHISHI_OK if
│ │ │ │ +000021f0: 6620 7375 6363 6573 7366 756c 2e0a 0a73  f successful...s
│ │ │ │ +00002200: 6869 7368 695f 7467 735f 6b72 6265 7272  hishi_tgs_krberr
│ │ │ │ +00002210: 6f72 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  or.-------------
│ │ │ │ +00002220: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ +00002230: 7469 6f6e 3a20 5368 6973 6869 5f61 736e  tion: Shishi_asn
│ │ │ │ +00002240: 3120 7368 6973 6869 5f74 6773 5f6b 7262  1 shishi_tgs_krb
│ │ │ │ +00002250: 6572 726f 7220 2853 6869 7368 695f 7467  error (Shishi_tg
│ │ │ │ +00002260: 7320 2a20 5447 5329 0a20 2020 2020 5447  s * TGS).     TG
│ │ │ │ +00002270: 533a 2073 7472 7563 7475 7265 2074 6861  S: structure tha
│ │ │ │ +00002280: 7420 686f 6c64 7320 696e 666f 726d 6174  t holds informat
│ │ │ │ +00002290: 696f 6e20 6162 6f75 7420 5447 5320 6578  ion about TGS ex
│ │ │ │ +000022a0: 6368 616e 6765 0a0a 2020 2020 202a 4465  change..     *De
│ │ │ │ +000022b0: 7363 7269 7074 696f 6e3a 2a20 4765 7420  scription:* Get 
│ │ │ │ +000022c0: 4b52 422d 4552 524f 5220 6672 6f6d 2054  KRB-ERROR from T
│ │ │ │ +000022d0: 4753 2065 7863 6861 6e67 652e 0a0a 2020  GS exchange...  
│ │ │ │ +000022e0: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ +000022f0: 3a2a 2052 6574 7572 6e73 2074 6865 2072  :* Returns the r
│ │ │ │ +00002300: 6563 6569 7665 6420 5447 532d 5245 5020  eceived TGS-REP 
│ │ │ │ +00002310: 6672 6f6d 2074 6865 2054 4753 2065 7863  from the TGS exc
│ │ │ │ +00002320: 6861 6e67 652c 0a20 2020 2020 6f72 204e  hange,.     or N
│ │ │ │ +00002330: 554c 4c20 6966 206e 6f74 2079 6574 2073  ULL if not yet s
│ │ │ │ +00002340: 6574 206f 7220 616e 2065 7272 6f72 206f  et or an error o
│ │ │ │ +00002350: 6363 7572 6564 2e0a 0a73 6869 7368 695f  ccured...shishi_
│ │ │ │ +00002360: 7467 735f 6b72 6265 7272 6f72 5f64 6572  tgs_krberror_der
│ │ │ │ +00002370: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ +00002380: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ +00002390: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ +000023a0: 6869 5f74 6773 5f6b 7262 6572 726f 725f  hi_tgs_krberror_
│ │ │ │ +000023b0: 6465 7220 2853 6869 7368 695f 7467 7320  der (Shishi_tgs 
│ │ │ │ +000023c0: 2a20 5447 532c 0a20 2020 2020 2020 2020  * TGS,.         
│ │ │ │ +000023d0: 2063 6861 7220 2a2a 204f 5554 2c20 7369   char ** OUT, si
│ │ │ │ +000023e0: 7a65 5f74 202a 204f 5554 4c45 4e29 0a20  ze_t * OUTLEN). 
│ │ │ │ +000023f0: 2020 2020 5447 533a 2073 7472 7563 7475      TGS: structu
│ │ │ │ +00002400: 7265 2074 6861 7420 686f 6c64 7320 696e  re that holds in
│ │ │ │ +00002410: 666f 726d 6174 696f 6e20 6162 6f75 7420  formation about 
│ │ │ │ +00002420: 5447 5320 6578 6368 616e 6765 0a20 2020  TGS exchange.   
│ │ │ │ +00002430: 2020 4f55 543a 206f 7574 7075 7420 6172    OUT: output ar
│ │ │ │ +00002440: 7261 7920 7769 7468 206e 6577 6c79 2061  ray with newly a
│ │ │ │ +00002450: 6c6c 6f63 6174 6564 2044 4552 2065 6e63  llocated DER enc
│ │ │ │ +00002460: 6f64 696e 6720 6f66 204b 5242 2d45 5252  oding of KRB-ERR
│ │ │ │ +00002470: 4f52 2e0a 2020 2020 204f 5554 4c45 4e3a  OR..     OUTLEN:
│ │ │ │ +00002480: 206c 656e 6774 6820 6f66 206f 7574 7075   length of outpu
│ │ │ │ +00002490: 7420 6172 7261 7920 7769 7468 2044 4552  t array with DER
│ │ │ │ +000024a0: 2065 6e63 6f64 696e 6720 6f66 204b 5242   encoding of KRB
│ │ │ │ +000024b0: 2d45 5252 4f52 2e0a 0a20 2020 2020 2a44  -ERROR...     *D
│ │ │ │ +000024c0: 6573 6372 6970 7469 6f6e 3a2a 2044 4552  escription:* DER
│ │ │ │ +000024d0: 2065 6e63 6f64 6520 4b52 422d 4552 524f   encode KRB-ERRO
│ │ │ │ +000024e0: 522e 204f 5554 2069 7320 616c 6c6f 6361  R. OUT is alloca
│ │ │ │ +000024f0: 7465 6420 6279 2074 6869 730a 2020 2020  ted by this.    
│ │ │ │ +00002500: 2066 756e 6374 696f 6e2c 2061 6e64 2069   function, and i
│ │ │ │ +00002510: 7420 6973 2074 6865 2072 6573 706f 6e73  t is the respons
│ │ │ │ +00002520: 6962 696c 6974 7920 6f66 2063 616c 6c65  ibility of calle
│ │ │ │ +00002530: 7220 746f 2064 6561 6c6c 6f63 6174 6520  r to deallocate 
│ │ │ │ +00002540: 6974 2e0a 0a20 2020 2020 2a52 6574 7572  it...     *Retur
│ │ │ │ +00002550: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ +00002560: 7320 5348 4953 4849 5f4f 4b20 6966 6620  s SHISHI_OK iff 
│ │ │ │ +00002570: 7375 6363 6573 7366 756c 2e0a 0a73 6869  successful...shi
│ │ │ │ +00002580: 7368 695f 7467 735f 6b72 6265 7272 6f72  shi_tgs_krberror
│ │ │ │ +00002590: 5f73 6574 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  _set.-----------
│ │ │ │ +000025a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ +000025b0: 2d20 4675 6e63 7469 6f6e 3a20 766f 6964  - Function: void
│ │ │ │ +000025c0: 2073 6869 7368 695f 7467 735f 6b72 6265   shishi_tgs_krbe
│ │ │ │ +000025d0: 7272 6f72 5f73 6574 2028 5368 6973 6869  rror_set (Shishi
│ │ │ │ +000025e0: 5f74 6773 202a 2054 4753 2c0a 2020 2020  _tgs * TGS,.    
│ │ │ │ +000025f0: 2020 2020 2020 5368 6973 6869 5f61 736e        Shishi_asn
│ │ │ │ +00002600: 3120 4b52 4245 5252 4f52 290a 2020 2020  1 KRBERROR).    
│ │ │ │ +00002610: 2054 4753 3a20 7374 7275 6374 7572 6520   TGS: structure 
│ │ │ │ +00002620: 7468 6174 2068 6f6c 6473 2069 6e66 6f72  that holds infor
│ │ │ │ +00002630: 6d61 7469 6f6e 2061 626f 7574 2054 4753  mation about TGS
│ │ │ │ +00002640: 2065 7863 6861 6e67 650a 2020 2020 204b   exchange.     K
│ │ │ │ +00002650: 5242 4552 524f 523a 206b 7262 6572 726f  RBERROR: krberro
│ │ │ │ +00002660: 7220 746f 2073 746f 7265 2069 6e20 5447  r to store in TG
│ │ │ │ +00002670: 532e 0a0a 2020 2020 202a 4465 7363 7269  S...     *Descri
│ │ │ │ +00002680: 7074 696f 6e3a 2a20 5365 7420 7468 6520  ption:* Set the 
│ │ │ │ +00002690: 4b52 422d 4552 524f 5220 696e 2074 6865  KRB-ERROR in the
│ │ │ │ +000026a0: 2054 4753 2065 7863 6861 6e67 652e 0a0a   TGS exchange...
│ │ │ │ +000026b0: 7368 6973 6869 5f74 6773 5f74 6b74 0a2d  shishi_tgs_tkt.-
│ │ │ │ +000026c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ +000026d0: 2d2d 2046 756e 6374 696f 6e3a 2053 6869  -- Function: Shi
│ │ │ │ +000026e0: 7368 695f 746b 7420 2a20 7368 6973 6869  shi_tkt * shishi
│ │ │ │ +000026f0: 5f74 6773 5f74 6b74 2028 5368 6973 6869  _tgs_tkt (Shishi
│ │ │ │ +00002700: 5f74 6773 202a 2054 4753 290a 2020 2020  _tgs * TGS).    
│ │ │ │ +00002710: 2054 4753 3a20 7374 7275 6374 7572 6520   TGS: structure 
│ │ │ │ +00002720: 7468 6174 2068 6f6c 6473 2069 6e66 6f72  that holds infor
│ │ │ │ +00002730: 6d61 7469 6f6e 2061 626f 7574 2054 4753  mation about TGS
│ │ │ │ +00002740: 2065 7863 6861 6e67 650a 0a20 2020 2020   exchange..     
│ │ │ │ +00002750: 2a44 6573 6372 6970 7469 6f6e 3a2a 2047  *Description:* G
│ │ │ │ +00002760: 6574 2054 6963 6b65 7420 6672 6f6d 2054  et Ticket from T
│ │ │ │ +00002770: 4753 2065 7863 6861 6e67 652e 0a0a 2020  GS exchange...  
│ │ │ │ +00002780: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ +00002790: 3a2a 2052 6574 7572 6e73 2074 6865 206e  :* Returns the n
│ │ │ │ +000027a0: 6577 6c79 2061 6371 7569 7265 6420 7469  ewly acquired ti
│ │ │ │ +000027b0: 636b 6574 2066 726f 6d20 7468 6520 5447  cket from the TG
│ │ │ │ +000027c0: 530a 2020 2020 2065 7863 6861 6e67 652c  S.     exchange,
│ │ │ │ +000027d0: 206f 7220 4e55 4c4c 2069 6620 6e6f 7420   or NULL if not 
│ │ │ │ +000027e0: 7965 7420 7365 7420 6f72 2061 6e20 6572  yet set or an er
│ │ │ │ +000027f0: 726f 7220 6f63 6375 7265 642e 0a0a 7368  ror occured...sh
│ │ │ │ +00002800: 6973 6869 5f74 6773 5f74 6b74 5f73 6574  ishi_tgs_tkt_set
│ │ │ │ +00002810: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ +00002820: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ +00002830: 6e3a 2076 6f69 6420 7368 6973 6869 5f74  n: void shishi_t
│ │ │ │ +00002840: 6773 5f74 6b74 5f73 6574 2028 5368 6973  gs_tkt_set (Shis
│ │ │ │ +00002850: 6869 5f74 6773 202a 2054 4753 2c0a 2020  hi_tgs * TGS,.  
│ │ │ │ +00002860: 2020 2020 2020 2020 5368 6973 6869 5f74          Shishi_t
│ │ │ │ +00002870: 6b74 202a 2054 4b54 290a 2020 2020 2054  kt * TKT).     T
│ │ │ │ +00002880: 4753 3a20 7374 7275 6374 7572 6520 7468  GS: structure th
│ │ │ │ +00002890: 6174 2068 6f6c 6473 2069 6e66 6f72 6d61  at holds informa
│ │ │ │ +000028a0: 7469 6f6e 2061 626f 7574 2054 4753 2065  tion about TGS e
│ │ │ │ +000028b0: 7863 6861 6e67 650a 2020 2020 2054 4b54  xchange.     TKT
│ │ │ │ +000028c0: 3a20 7469 636b 6574 2074 6f20 7374 6f72  : ticket to stor
│ │ │ │ +000028d0: 6520 696e 2054 4753 2e0a 0a20 2020 2020  e in TGS...     
│ │ │ │ +000028e0: 2a44 6573 6372 6970 7469 6f6e 3a2a 2053  *Description:* S
│ │ │ │ +000028f0: 6574 2074 6865 2054 6963 6b65 7420 696e  et the Ticket in
│ │ │ │ +00002900: 2074 6865 2054 4753 2065 7863 6861 6e67   the TGS exchang
│ │ │ │ +00002910: 652e 0a0a 7368 6973 6869 5f74 6773 5f73  e...shishi_tgs_s
│ │ │ │ +00002920: 656e 6472 6563 765f 6869 6e74 0a2d 2d2d  endrecv_hint.---
│ │ │ │  00002930: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00002940: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -00002950: 6f6e 3a20 696e 7420 7368 6973 6869 5f74  on: int shishi_t
│ │ │ │ -00002960: 6773 5f73 656e 6472 6563 765f 6869 6e74  gs_sendrecv_hint
│ │ │ │ -00002970: 2028 5368 6973 6869 5f74 6773 202a 2054   (Shishi_tgs * T
│ │ │ │ -00002980: 4753 2c0a 2020 2020 2020 2020 2020 5368  GS,.          Sh
│ │ │ │ -00002990: 6973 6869 5f74 6b74 735f 6869 6e74 202a  ishi_tkts_hint *
│ │ │ │ -000029a0: 2048 494e 5429 0a20 2020 2020 5447 533a   HINT).     TGS:
│ │ │ │ -000029b0: 2073 7472 7563 7475 7265 2074 6861 7420   structure that 
│ │ │ │ -000029c0: 686f 6c64 7320 696e 666f 726d 6174 696f  holds informatio
│ │ │ │ -000029d0: 6e20 6162 6f75 7420 5447 5320 6578 6368  n about TGS exch
│ │ │ │ -000029e0: 616e 6765 0a20 2020 2020 4849 4e54 3a20  ange.     HINT: 
│ │ │ │ -000029f0: 6164 6469 7469 6f6e 616c 2070 6172 616d  additional param
│ │ │ │ -00002a00: 6574 6572 7320 7468 6174 206d 6f64 6966  eters that modif
│ │ │ │ -00002a10: 7920 636f 6e6e 6563 7469 6f6e 2062 6568  y connection beh
│ │ │ │ -00002a20: 6176 696f 7572 2c20 6f72 0a20 2020 2020  aviour, or.     
│ │ │ │ -00002a30: e280 984e 554c 4ce2 8099 2e0a 0a20 2020  ...NULL......   
│ │ │ │ -00002a40: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ -00002a50: 2053 656e 6420 5447 532d 5245 5120 616e   Send TGS-REQ an
│ │ │ │ -00002a60: 6420 7265 6365 6976 6520 5447 532d 5245  d receive TGS-RE
│ │ │ │ -00002a70: 5020 6f72 204b 5242 2d45 5252 4f52 2e20  P or KRB-ERROR. 
│ │ │ │ -00002a80: 5468 6973 0a20 2020 2020 6973 2074 6865  This.     is the
│ │ │ │ -00002a90: 2073 7562 7365 7175 656e 7420 6175 7468   subsequent auth
│ │ │ │ -00002aa0: 656e 7469 6361 7469 6f6e 2c20 7573 7561  entication, usua
│ │ │ │ -00002ab0: 6c6c 7920 7573 6564 2074 6f20 6163 7175  lly used to acqu
│ │ │ │ -00002ac0: 6972 6520 7365 7276 6572 0a20 2020 2020  ire server.     
│ │ │ │ -00002ad0: 7469 636b 6574 732e 2020 5468 6520 4849  tickets.  The HI
│ │ │ │ -00002ae0: 4e54 2073 7472 7563 7475 7265 2063 616e  NT structure can
│ │ │ │ -00002af0: 2062 6520 7573 6564 2074 6f20 7365 742c   be used to set,
│ │ │ │ -00002b00: 2065 2e67 2e2c 2070 6172 616d 6574 6572   e.g., parameter
│ │ │ │ -00002b10: 730a 2020 2020 2066 6f72 2054 4c53 2061  s.     for TLS a
│ │ │ │ -00002b20: 7574 6865 6e74 6963 6174 696f 6e2e 0a0a  uthentication...
│ │ │ │ -00002b30: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ -00002b40: 7565 3a2a 2052 6574 7572 6e73 2053 4849  ue:* Returns SHI
│ │ │ │ -00002b50: 5348 495f 4f4b 2069 6666 2073 7563 6365  SHI_OK iff succe
│ │ │ │ -00002b60: 7373 6675 6c2e 0a0a 7368 6973 6869 5f74  ssful...shishi_t
│ │ │ │ -00002b70: 6773 5f73 656e 6472 6563 760a 2d2d 2d2d  gs_sendrecv.----
│ │ │ │ -00002b80: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -00002b90: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ -00002ba0: 6e74 2073 6869 7368 695f 7467 735f 7365  nt shishi_tgs_se
│ │ │ │ -00002bb0: 6e64 7265 6376 2028 5368 6973 6869 5f74  ndrecv (Shishi_t
│ │ │ │ -00002bc0: 6773 202a 2054 4753 290a 2020 2020 2054  gs * TGS).     T
│ │ │ │ -00002bd0: 4753 3a20 7374 7275 6374 7572 6520 7468  GS: structure th
│ │ │ │ -00002be0: 6174 2068 6f6c 6473 2069 6e66 6f72 6d61  at holds informa
│ │ │ │ -00002bf0: 7469 6f6e 2061 626f 7574 2054 4753 2065  tion about TGS e
│ │ │ │ -00002c00: 7863 6861 6e67 650a 0a20 2020 2020 2a44  xchange..     *D
│ │ │ │ -00002c10: 6573 6372 6970 7469 6f6e 3a2a 2053 656e  escription:* Sen
│ │ │ │ -00002c20: 6420 5447 532d 5245 5120 616e 6420 7265  d TGS-REQ and re
│ │ │ │ -00002c30: 6365 6976 6520 5447 532d 5245 5020 6f72  ceive TGS-REP or
│ │ │ │ -00002c40: 204b 5242 2d45 5252 4f52 2e20 5468 6973   KRB-ERROR. This
│ │ │ │ -00002c50: 0a20 2020 2020 6973 2074 6865 2073 7562  .     is the sub
│ │ │ │ -00002c60: 7365 7175 656e 7420 6175 7468 656e 7469  sequent authenti
│ │ │ │ -00002c70: 6361 7469 6f6e 2c20 7573 7561 6c6c 7920  cation, usually 
│ │ │ │ -00002c80: 7573 6564 2074 6f20 6163 7175 6972 6520  used to acquire 
│ │ │ │ -00002c90: 7365 7276 6572 0a20 2020 2020 7469 636b  server.     tick
│ │ │ │ -00002ca0: 6574 732e 0a0a 2020 2020 202a 5265 7475  ets...     *Retu
│ │ │ │ -00002cb0: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ -00002cc0: 6e73 2053 4849 5348 495f 4f4b 2069 6666  ns SHISHI_OK iff
│ │ │ │ -00002cd0: 2073 7563 6365 7373 6675 6c2e 0a0a 7368   successful...sh
│ │ │ │ -00002ce0: 6973 6869 5f74 6773 5f73 6574 5f73 6572  ishi_tgs_set_ser
│ │ │ │ -00002cf0: 7665 720a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ver.------------
│ │ │ │ -00002d00: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ -00002d10: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ -00002d20: 7368 695f 7467 735f 7365 745f 7365 7276  shi_tgs_set_serv
│ │ │ │ -00002d30: 6572 2028 5368 6973 6869 5f74 6773 202a  er (Shishi_tgs *
│ │ │ │ -00002d40: 2054 4753 2c0a 2020 2020 2020 2020 2020   TGS,.          
│ │ │ │ -00002d50: 636f 6e73 7420 6368 6172 202a 2053 4552  const char * SER
│ │ │ │ -00002d60: 5645 5229 0a20 2020 2020 5447 533a 2073  VER).     TGS: s
│ │ │ │ -00002d70: 7472 7563 7475 7265 2074 6861 7420 686f  tructure that ho
│ │ │ │ -00002d80: 6c64 7320 696e 666f 726d 6174 696f 6e20  lds information 
│ │ │ │ -00002d90: 6162 6f75 7420 5447 5320 6578 6368 616e  about TGS exchan
│ │ │ │ -00002da0: 6765 0a20 2020 2020 5345 5256 4552 3a20  ge.     SERVER: 
│ │ │ │ -00002db0: 696e 6469 6361 7465 7320 7468 6520 7365  indicates the se
│ │ │ │ -00002dc0: 7276 6572 2074 6f20 6163 7175 6972 6520  rver to acquire 
│ │ │ │ -00002dd0: 7469 636b 6574 2066 6f72 2e0a 0a20 2020  ticket for...   
│ │ │ │ -00002de0: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ -00002df0: 2053 6574 2074 6865 2073 6572 7665 7220   Set the server 
│ │ │ │ -00002e00: 696e 2074 6865 2054 4753 2d52 4551 2e0a  in the TGS-REQ..
│ │ │ │ -00002e10: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ -00002e20: 6c75 653a 2a20 5265 7475 726e 7320 5348  lue:* Returns SH
│ │ │ │ -00002e30: 4953 4849 5f4f 4b20 6966 6620 7375 6363  ISHI_OK iff succ
│ │ │ │ -00002e40: 6573 7366 756c 2e0a 0a73 6869 7368 695f  essful...shishi_
│ │ │ │ -00002e50: 7467 735f 7365 745f 7265 616c 6d0a 2d2d  tgs_set_realm.--
│ │ │ │ +00002940: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +00002950: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ +00002960: 7467 735f 7365 6e64 7265 6376 5f68 696e  tgs_sendrecv_hin
│ │ │ │ +00002970: 7420 2853 6869 7368 695f 7467 7320 2a20  t (Shishi_tgs * 
│ │ │ │ +00002980: 5447 532c 0a20 2020 2020 2020 2020 2053  TGS,.          S
│ │ │ │ +00002990: 6869 7368 695f 746b 7473 5f68 696e 7420  hishi_tkts_hint 
│ │ │ │ +000029a0: 2a20 4849 4e54 290a 2020 2020 2054 4753  * HINT).     TGS
│ │ │ │ +000029b0: 3a20 7374 7275 6374 7572 6520 7468 6174  : structure that
│ │ │ │ +000029c0: 2068 6f6c 6473 2069 6e66 6f72 6d61 7469   holds informati
│ │ │ │ +000029d0: 6f6e 2061 626f 7574 2054 4753 2065 7863  on about TGS exc
│ │ │ │ +000029e0: 6861 6e67 650a 2020 2020 2048 494e 543a  hange.     HINT:
│ │ │ │ +000029f0: 2061 6464 6974 696f 6e61 6c20 7061 7261   additional para
│ │ │ │ +00002a00: 6d65 7465 7273 2074 6861 7420 6d6f 6469  meters that modi
│ │ │ │ +00002a10: 6679 2063 6f6e 6e65 6374 696f 6e20 6265  fy connection be
│ │ │ │ +00002a20: 6861 7669 6f75 722c 206f 720a 2020 2020  haviour, or.    
│ │ │ │ +00002a30: 20e2 8098 4e55 4c4c e280 992e 0a0a 2020   ...NULL......  
│ │ │ │ +00002a40: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ +00002a50: 2a20 5365 6e64 2054 4753 2d52 4551 2061  * Send TGS-REQ a
│ │ │ │ +00002a60: 6e64 2072 6563 6569 7665 2054 4753 2d52  nd receive TGS-R
│ │ │ │ +00002a70: 4550 206f 7220 4b52 422d 4552 524f 522e  EP or KRB-ERROR.
│ │ │ │ +00002a80: 2054 6869 730a 2020 2020 2069 7320 7468   This.     is th
│ │ │ │ +00002a90: 6520 7375 6273 6571 7565 6e74 2061 7574  e subsequent aut
│ │ │ │ +00002aa0: 6865 6e74 6963 6174 696f 6e2c 2075 7375  hentication, usu
│ │ │ │ +00002ab0: 616c 6c79 2075 7365 6420 746f 2061 6371  ally used to acq
│ │ │ │ +00002ac0: 7569 7265 2073 6572 7665 720a 2020 2020  uire server.    
│ │ │ │ +00002ad0: 2074 6963 6b65 7473 2e20 2054 6865 2048   tickets.  The H
│ │ │ │ +00002ae0: 494e 5420 7374 7275 6374 7572 6520 6361  INT structure ca
│ │ │ │ +00002af0: 6e20 6265 2075 7365 6420 746f 2073 6574  n be used to set
│ │ │ │ +00002b00: 2c20 652e 672e 2c20 7061 7261 6d65 7465  , e.g., paramete
│ │ │ │ +00002b10: 7273 0a20 2020 2020 666f 7220 544c 5320  rs.     for TLS 
│ │ │ │ +00002b20: 6175 7468 656e 7469 6361 7469 6f6e 2e0a  authentication..
│ │ │ │ +00002b30: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ +00002b40: 6c75 653a 2a20 5265 7475 726e 7320 5348  lue:* Returns SH
│ │ │ │ +00002b50: 4953 4849 5f4f 4b20 6966 6620 7375 6363  ISHI_OK iff succ
│ │ │ │ +00002b60: 6573 7366 756c 2e0a 0a73 6869 7368 695f  essful...shishi_
│ │ │ │ +00002b70: 7467 735f 7365 6e64 7265 6376 0a2d 2d2d  tgs_sendrecv.---
│ │ │ │ +00002b80: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +00002b90: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +00002ba0: 696e 7420 7368 6973 6869 5f74 6773 5f73  int shishi_tgs_s
│ │ │ │ +00002bb0: 656e 6472 6563 7620 2853 6869 7368 695f  endrecv (Shishi_
│ │ │ │ +00002bc0: 7467 7320 2a20 5447 5329 0a20 2020 2020  tgs * TGS).     
│ │ │ │ +00002bd0: 5447 533a 2073 7472 7563 7475 7265 2074  TGS: structure t
│ │ │ │ +00002be0: 6861 7420 686f 6c64 7320 696e 666f 726d  hat holds inform
│ │ │ │ +00002bf0: 6174 696f 6e20 6162 6f75 7420 5447 5320  ation about TGS 
│ │ │ │ +00002c00: 6578 6368 616e 6765 0a0a 2020 2020 202a  exchange..     *
│ │ │ │ +00002c10: 4465 7363 7269 7074 696f 6e3a 2a20 5365  Description:* Se
│ │ │ │ +00002c20: 6e64 2054 4753 2d52 4551 2061 6e64 2072  nd TGS-REQ and r
│ │ │ │ +00002c30: 6563 6569 7665 2054 4753 2d52 4550 206f  eceive TGS-REP o
│ │ │ │ +00002c40: 7220 4b52 422d 4552 524f 522e 2054 6869  r KRB-ERROR. Thi
│ │ │ │ +00002c50: 730a 2020 2020 2069 7320 7468 6520 7375  s.     is the su
│ │ │ │ +00002c60: 6273 6571 7565 6e74 2061 7574 6865 6e74  bsequent authent
│ │ │ │ +00002c70: 6963 6174 696f 6e2c 2075 7375 616c 6c79  ication, usually
│ │ │ │ +00002c80: 2075 7365 6420 746f 2061 6371 7569 7265   used to acquire
│ │ │ │ +00002c90: 2073 6572 7665 720a 2020 2020 2074 6963   server.     tic
│ │ │ │ +00002ca0: 6b65 7473 2e0a 0a20 2020 2020 2a52 6574  kets...     *Ret
│ │ │ │ +00002cb0: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ +00002cc0: 726e 7320 5348 4953 4849 5f4f 4b20 6966  rns SHISHI_OK if
│ │ │ │ +00002cd0: 6620 7375 6363 6573 7366 756c 2e0a 0a73  f successful...s
│ │ │ │ +00002ce0: 6869 7368 695f 7467 735f 7365 745f 7365  hishi_tgs_set_se
│ │ │ │ +00002cf0: 7276 6572 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  rver.-----------
│ │ │ │ +00002d00: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +00002d10: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ +00002d20: 6973 6869 5f74 6773 5f73 6574 5f73 6572  ishi_tgs_set_ser
│ │ │ │ +00002d30: 7665 7220 2853 6869 7368 695f 7467 7320  ver (Shishi_tgs 
│ │ │ │ +00002d40: 2a20 5447 532c 0a20 2020 2020 2020 2020  * TGS,.         
│ │ │ │ +00002d50: 2063 6f6e 7374 2063 6861 7220 2a20 5345   const char * SE
│ │ │ │ +00002d60: 5256 4552 290a 2020 2020 2054 4753 3a20  RVER).     TGS: 
│ │ │ │ +00002d70: 7374 7275 6374 7572 6520 7468 6174 2068  structure that h
│ │ │ │ +00002d80: 6f6c 6473 2069 6e66 6f72 6d61 7469 6f6e  olds information
│ │ │ │ +00002d90: 2061 626f 7574 2054 4753 2065 7863 6861   about TGS excha
│ │ │ │ +00002da0: 6e67 650a 2020 2020 2053 4552 5645 523a  nge.     SERVER:
│ │ │ │ +00002db0: 2069 6e64 6963 6174 6573 2074 6865 2073   indicates the s
│ │ │ │ +00002dc0: 6572 7665 7220 746f 2061 6371 7569 7265  erver to acquire
│ │ │ │ +00002dd0: 2074 6963 6b65 7420 666f 722e 0a0a 2020   ticket for...  
│ │ │ │ +00002de0: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ +00002df0: 2a20 5365 7420 7468 6520 7365 7276 6572  * Set the server
│ │ │ │ +00002e00: 2069 6e20 7468 6520 5447 532d 5245 512e   in the TGS-REQ.
│ │ │ │ +00002e10: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ +00002e20: 616c 7565 3a2a 2052 6574 7572 6e73 2053  alue:* Returns S
│ │ │ │ +00002e30: 4849 5348 495f 4f4b 2069 6666 2073 7563  HISHI_OK iff suc
│ │ │ │ +00002e40: 6365 7373 6675 6c2e 0a0a 7368 6973 6869  cessful...shishi
│ │ │ │ +00002e50: 5f74 6773 5f73 6574 5f72 6561 6c6d 0a2d  _tgs_set_realm.-
│ │ │ │  00002e60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00002e70: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ -00002e80: 3a20 696e 7420 7368 6973 6869 5f74 6773  : int shishi_tgs
│ │ │ │ -00002e90: 5f73 6574 5f72 6561 6c6d 2028 5368 6973  _set_realm (Shis
│ │ │ │ -00002ea0: 6869 5f74 6773 202a 2054 4753 2c0a 2020  hi_tgs * TGS,.  
│ │ │ │ -00002eb0: 2020 2020 2020 2020 636f 6e73 7420 6368          const ch
│ │ │ │ -00002ec0: 6172 202a 2052 4541 4c4d 290a 2020 2020  ar * REALM).    
│ │ │ │ -00002ed0: 2054 4753 3a20 7374 7275 6374 7572 6520   TGS: structure 
│ │ │ │ -00002ee0: 7468 6174 2068 6f6c 6473 2069 6e66 6f72  that holds infor
│ │ │ │ -00002ef0: 6d61 7469 6f6e 2061 626f 7574 2054 4753  mation about TGS
│ │ │ │ -00002f00: 2065 7863 6861 6e67 650a 2020 2020 2052   exchange.     R
│ │ │ │ -00002f10: 4541 4c4d 3a20 696e 6469 6361 7465 7320  EALM: indicates 
│ │ │ │ -00002f20: 7468 6520 7265 616c 6d20 746f 2061 6371  the realm to acq
│ │ │ │ -00002f30: 7569 7265 2074 6963 6b65 7420 666f 722e  uire ticket for.
│ │ │ │ -00002f40: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ -00002f50: 696f 6e3a 2a20 5365 7420 7468 6520 7365  ion:* Set the se
│ │ │ │ -00002f60: 7276 6572 2069 6e20 7468 6520 5447 532d  rver in the TGS-
│ │ │ │ -00002f70: 5245 512e 0a0a 2020 2020 202a 5265 7475  REQ...     *Retu
│ │ │ │ -00002f80: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ -00002f90: 6e73 2053 4849 5348 495f 4f4b 2069 6666  ns SHISHI_OK iff
│ │ │ │ -00002fa0: 2073 7563 6365 7373 6675 6c2e 0a0a 7368   successful...sh
│ │ │ │ -00002fb0: 6973 6869 5f74 6773 5f73 6574 5f72 6561  ishi_tgs_set_rea
│ │ │ │ -00002fc0: 6c6d 7365 7276 6572 0a2d 2d2d 2d2d 2d2d  lmserver.-------
│ │ │ │ +00002e70: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ +00002e80: 6e3a 2069 6e74 2073 6869 7368 695f 7467  n: int shishi_tg
│ │ │ │ +00002e90: 735f 7365 745f 7265 616c 6d20 2853 6869  s_set_realm (Shi
│ │ │ │ +00002ea0: 7368 695f 7467 7320 2a20 5447 532c 0a20  shi_tgs * TGS,. 
│ │ │ │ +00002eb0: 2020 2020 2020 2020 2063 6f6e 7374 2063           const c
│ │ │ │ +00002ec0: 6861 7220 2a20 5245 414c 4d29 0a20 2020  har * REALM).   
│ │ │ │ +00002ed0: 2020 5447 533a 2073 7472 7563 7475 7265    TGS: structure
│ │ │ │ +00002ee0: 2074 6861 7420 686f 6c64 7320 696e 666f   that holds info
│ │ │ │ +00002ef0: 726d 6174 696f 6e20 6162 6f75 7420 5447  rmation about TG
│ │ │ │ +00002f00: 5320 6578 6368 616e 6765 0a20 2020 2020  S exchange.     
│ │ │ │ +00002f10: 5245 414c 4d3a 2069 6e64 6963 6174 6573  REALM: indicates
│ │ │ │ +00002f20: 2074 6865 2072 6561 6c6d 2074 6f20 6163   the realm to ac
│ │ │ │ +00002f30: 7175 6972 6520 7469 636b 6574 2066 6f72  quire ticket for
│ │ │ │ +00002f40: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ +00002f50: 7469 6f6e 3a2a 2053 6574 2074 6865 2073  tion:* Set the s
│ │ │ │ +00002f60: 6572 7665 7220 696e 2074 6865 2054 4753  erver in the TGS
│ │ │ │ +00002f70: 2d52 4551 2e0a 0a20 2020 2020 2a52 6574  -REQ...     *Ret
│ │ │ │ +00002f80: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ +00002f90: 726e 7320 5348 4953 4849 5f4f 4b20 6966  rns SHISHI_OK if
│ │ │ │ +00002fa0: 6620 7375 6363 6573 7366 756c 2e0a 0a73  f successful...s
│ │ │ │ +00002fb0: 6869 7368 695f 7467 735f 7365 745f 7265  hishi_tgs_set_re
│ │ │ │ +00002fc0: 616c 6d73 6572 7665 720a 2d2d 2d2d 2d2d  almserver.------
│ │ │ │  00002fd0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00002fe0: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ -00002ff0: 6e3a 2069 6e74 2073 6869 7368 695f 7467  n: int shishi_tg
│ │ │ │ -00003000: 735f 7365 745f 7265 616c 6d73 6572 7665  s_set_realmserve
│ │ │ │ -00003010: 7220 2853 6869 7368 695f 7467 7320 2a20  r (Shishi_tgs * 
│ │ │ │ -00003020: 5447 532c 0a20 2020 2020 2020 2020 2063  TGS,.          c
│ │ │ │ -00003030: 6f6e 7374 2063 6861 7220 2a20 5245 414c  onst char * REAL
│ │ │ │ -00003040: 4d2c 2063 6f6e 7374 2063 6861 7220 2a20  M, const char * 
│ │ │ │ -00003050: 5345 5256 4552 290a 2020 2020 2054 4753  SERVER).     TGS
│ │ │ │ -00003060: 3a20 7374 7275 6374 7572 6520 7468 6174  : structure that
│ │ │ │ -00003070: 2068 6f6c 6473 2069 6e66 6f72 6d61 7469   holds informati
│ │ │ │ -00003080: 6f6e 2061 626f 7574 2054 4753 2065 7863  on about TGS exc
│ │ │ │ -00003090: 6861 6e67 650a 2020 2020 2052 4541 4c4d  hange.     REALM
│ │ │ │ -000030a0: 3a20 696e 6469 6361 7465 7320 7468 6520  : indicates the 
│ │ │ │ -000030b0: 7265 616c 6d20 746f 2061 6371 7569 7265  realm to acquire
│ │ │ │ -000030c0: 2074 6963 6b65 7420 666f 722e 0a20 2020   ticket for..   
│ │ │ │ -000030d0: 2020 5345 5256 4552 3a20 696e 6469 6361    SERVER: indica
│ │ │ │ -000030e0: 7465 7320 7468 6520 7365 7276 6572 2074  tes the server t
│ │ │ │ -000030f0: 6f20 6163 7175 6972 6520 7469 636b 6574  o acquire ticket
│ │ │ │ -00003100: 2066 6f72 2e0a 0a20 2020 2020 2a44 6573   for...     *Des
│ │ │ │ -00003110: 6372 6970 7469 6f6e 3a2a 2053 6574 2074  cription:* Set t
│ │ │ │ -00003120: 6865 2072 6561 6c6d 2061 6e64 2073 6572  he realm and ser
│ │ │ │ -00003130: 7665 7220 696e 2074 6865 2054 4753 2d52  ver in the TGS-R
│ │ │ │ -00003140: 4551 2e0a 0a20 2020 2020 2a52 6574 7572  EQ...     *Retur
│ │ │ │ -00003150: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ -00003160: 7320 5348 4953 4849 5f4f 4b20 6966 6620  s SHISHI_OK iff 
│ │ │ │ -00003170: 7375 6363 6573 7366 756c 2e0a 0a1f 0a46  successful.....F
│ │ │ │ -00003180: 696c 653a 2073 6869 7368 692e 696e 666f  ile: shishi.info
│ │ │ │ -00003190: 2c20 204e 6f64 653a 2054 6963 6b65 7420  ,  Node: Ticket 
│ │ │ │ -000031a0: 2841 534e 2e31 2920 4675 6e63 7469 6f6e  (ASN.1) Function
│ │ │ │ -000031b0: 732c 2020 4e65 7874 3a20 4153 2f54 4753  s,  Next: AS/TGS
│ │ │ │ -000031c0: 2046 756e 6374 696f 6e73 2c20 2050 7265   Functions,  Pre
│ │ │ │ -000031d0: 763a 2054 4753 2046 756e 6374 696f 6e73  v: TGS Functions
│ │ │ │ -000031e0: 2c20 2055 703a 2050 726f 6772 616d 6d69  ,  Up: Programmi
│ │ │ │ -000031f0: 6e67 204d 616e 7561 6c0a 0a35 2e39 2054  ng Manual..5.9 T
│ │ │ │ -00003200: 6963 6b65 7420 2841 534e 2e31 2920 4675  icket (ASN.1) Fu
│ │ │ │ -00003210: 6e63 7469 6f6e 730a 3d3d 3d3d 3d3d 3d3d  nctions.========
│ │ │ │ +00002fe0: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ +00002ff0: 6f6e 3a20 696e 7420 7368 6973 6869 5f74  on: int shishi_t
│ │ │ │ +00003000: 6773 5f73 6574 5f72 6561 6c6d 7365 7276  gs_set_realmserv
│ │ │ │ +00003010: 6572 2028 5368 6973 6869 5f74 6773 202a  er (Shishi_tgs *
│ │ │ │ +00003020: 2054 4753 2c0a 2020 2020 2020 2020 2020   TGS,.          
│ │ │ │ +00003030: 636f 6e73 7420 6368 6172 202a 2052 4541  const char * REA
│ │ │ │ +00003040: 4c4d 2c20 636f 6e73 7420 6368 6172 202a  LM, const char *
│ │ │ │ +00003050: 2053 4552 5645 5229 0a20 2020 2020 5447   SERVER).     TG
│ │ │ │ +00003060: 533a 2073 7472 7563 7475 7265 2074 6861  S: structure tha
│ │ │ │ +00003070: 7420 686f 6c64 7320 696e 666f 726d 6174  t holds informat
│ │ │ │ +00003080: 696f 6e20 6162 6f75 7420 5447 5320 6578  ion about TGS ex
│ │ │ │ +00003090: 6368 616e 6765 0a20 2020 2020 5245 414c  change.     REAL
│ │ │ │ +000030a0: 4d3a 2069 6e64 6963 6174 6573 2074 6865  M: indicates the
│ │ │ │ +000030b0: 2072 6561 6c6d 2074 6f20 6163 7175 6972   realm to acquir
│ │ │ │ +000030c0: 6520 7469 636b 6574 2066 6f72 2e0a 2020  e ticket for..  
│ │ │ │ +000030d0: 2020 2053 4552 5645 523a 2069 6e64 6963     SERVER: indic
│ │ │ │ +000030e0: 6174 6573 2074 6865 2073 6572 7665 7220  ates the server 
│ │ │ │ +000030f0: 746f 2061 6371 7569 7265 2074 6963 6b65  to acquire ticke
│ │ │ │ +00003100: 7420 666f 722e 0a0a 2020 2020 202a 4465  t for...     *De
│ │ │ │ +00003110: 7363 7269 7074 696f 6e3a 2a20 5365 7420  scription:* Set 
│ │ │ │ +00003120: 7468 6520 7265 616c 6d20 616e 6420 7365  the realm and se
│ │ │ │ +00003130: 7276 6572 2069 6e20 7468 6520 5447 532d  rver in the TGS-
│ │ │ │ +00003140: 5245 512e 0a0a 2020 2020 202a 5265 7475  REQ...     *Retu
│ │ │ │ +00003150: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ +00003160: 6e73 2053 4849 5348 495f 4f4b 2069 6666  ns SHISHI_OK iff
│ │ │ │ +00003170: 2073 7563 6365 7373 6675 6c2e 0a0a 1f0a   successful.....
│ │ │ │ +00003180: 4669 6c65 3a20 7368 6973 6869 2e69 6e66  File: shishi.inf
│ │ │ │ +00003190: 6f2c 2020 4e6f 6465 3a20 5469 636b 6574  o,  Node: Ticket
│ │ │ │ +000031a0: 2028 4153 4e2e 3129 2046 756e 6374 696f   (ASN.1) Functio
│ │ │ │ +000031b0: 6e73 2c20 204e 6578 743a 2041 532f 5447  ns,  Next: AS/TG
│ │ │ │ +000031c0: 5320 4675 6e63 7469 6f6e 732c 2020 5072  S Functions,  Pr
│ │ │ │ +000031d0: 6576 3a20 5447 5320 4675 6e63 7469 6f6e  ev: TGS Function
│ │ │ │ +000031e0: 732c 2020 5570 3a20 5072 6f67 7261 6d6d  s,  Up: Programm
│ │ │ │ +000031f0: 696e 6720 4d61 6e75 616c 0a0a 352e 3920  ing Manual..5.9 
│ │ │ │ +00003200: 5469 636b 6574 2028 4153 4e2e 3129 2046  Ticket (ASN.1) F
│ │ │ │ +00003210: 756e 6374 696f 6e73 0a3d 3d3d 3d3d 3d3d  unctions.=======
│ │ │ │  00003220: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ -00003230: 3d3d 3d3d 0a0a 2a4e 6f74 6520 5469 636b  ====..*Note Tick
│ │ │ │ -00003240: 6574 2046 756e 6374 696f 6e73 3a3a 2c20  et Functions::, 
│ │ │ │ -00003250: 666f 7220 616e 2068 6967 682d 6c65 7665  for an high-leve
│ │ │ │ -00003260: 6c20 6f76 6572 7669 6577 206f 6620 7469  l overview of ti
│ │ │ │ -00003270: 636b 6574 732e 2020 5468 650a 666f 6c6c  ckets.  The.foll
│ │ │ │ -00003280: 6f77 696e 6720 696c 6c75 7374 7261 7465  owing illustrate
│ │ │ │ -00003290: 7320 7468 6520 5469 636b 6574 2061 6e64  s the Ticket and
│ │ │ │ -000032a0: 2045 6e63 5469 636b 6574 5061 7274 2041   EncTicketPart A
│ │ │ │ -000032b0: 534e 2e31 2073 7472 7563 7475 7265 732e  SN.1 structures.
│ │ │ │ -000032c0: 0a0a 5469 636b 6574 2020 2020 2020 2020  ..Ticket        
│ │ │ │ -000032d0: 2020 3a3a 3d20 5b41 5050 4c49 4341 5449    ::= [APPLICATI
│ │ │ │ -000032e0: 4f4e 2031 5d20 5345 5155 454e 4345 207b  ON 1] SEQUENCE {
│ │ │ │ -000032f0: 0a20 2020 2020 2020 2074 6b74 2d76 6e6f  .        tkt-vno
│ │ │ │ -00003300: 2020 2020 2020 2020 205b 305d 2049 4e54           [0] INT
│ │ │ │ -00003310: 4547 4552 2028 3529 2c0a 2020 2020 2020  EGER (5),.      
│ │ │ │ -00003320: 2020 7265 616c 6d20 2020 2020 2020 2020    realm         
│ │ │ │ -00003330: 2020 5b31 5d20 5265 616c 6d2c 0a20 2020    [1] Realm,.   
│ │ │ │ -00003340: 2020 2020 2073 6e61 6d65 2020 2020 2020       sname      
│ │ │ │ -00003350: 2020 2020 205b 325d 2050 7269 6e63 6970       [2] Princip
│ │ │ │ -00003360: 616c 4e61 6d65 2c0a 2020 2020 2020 2020  alName,.        
│ │ │ │ -00003370: 656e 632d 7061 7274 2020 2020 2020 2020  enc-part        
│ │ │ │ -00003380: 5b33 5d20 456e 6372 7970 7465 6444 6174  [3] EncryptedDat
│ │ │ │ -00003390: 6120 2d2d 2045 6e63 5469 636b 6574 5061  a -- EncTicketPa
│ │ │ │ -000033a0: 7274 0a7d 0a0a 2d2d 2045 6e63 7279 7074  rt.}..-- Encrypt
│ │ │ │ -000033b0: 6564 2070 6172 7420 6f66 2074 6963 6b65  ed part of ticke
│ │ │ │ -000033c0: 740a 456e 6354 6963 6b65 7450 6172 7420  t.EncTicketPart 
│ │ │ │ -000033d0: 2020 3a3a 3d20 5b41 5050 4c49 4341 5449    ::= [APPLICATI
│ │ │ │ -000033e0: 4f4e 2033 5d20 5345 5155 454e 4345 207b  ON 3] SEQUENCE {
│ │ │ │ -000033f0: 0a20 2020 2020 2020 2066 6c61 6773 2020  .        flags  
│ │ │ │ +00003230: 3d3d 3d3d 3d0a 0a2a 4e6f 7465 2054 6963  =====..*Note Tic
│ │ │ │ +00003240: 6b65 7420 4675 6e63 7469 6f6e 733a 3a2c  ket Functions::,
│ │ │ │ +00003250: 2066 6f72 2061 6e20 6869 6768 2d6c 6576   for an high-lev
│ │ │ │ +00003260: 656c 206f 7665 7276 6965 7720 6f66 2074  el overview of t
│ │ │ │ +00003270: 6963 6b65 7473 2e20 2054 6865 0a66 6f6c  ickets.  The.fol
│ │ │ │ +00003280: 6c6f 7769 6e67 2069 6c6c 7573 7472 6174  lowing illustrat
│ │ │ │ +00003290: 6573 2074 6865 2054 6963 6b65 7420 616e  es the Ticket an
│ │ │ │ +000032a0: 6420 456e 6354 6963 6b65 7450 6172 7420  d EncTicketPart 
│ │ │ │ +000032b0: 4153 4e2e 3120 7374 7275 6374 7572 6573  ASN.1 structures
│ │ │ │ +000032c0: 2e0a 0a54 6963 6b65 7420 2020 2020 2020  ...Ticket       
│ │ │ │ +000032d0: 2020 203a 3a3d 205b 4150 504c 4943 4154     ::= [APPLICAT
│ │ │ │ +000032e0: 494f 4e20 315d 2053 4551 5545 4e43 4520  ION 1] SEQUENCE 
│ │ │ │ +000032f0: 7b0a 2020 2020 2020 2020 746b 742d 766e  {.        tkt-vn
│ │ │ │ +00003300: 6f20 2020 2020 2020 2020 5b30 5d20 494e  o         [0] IN
│ │ │ │ +00003310: 5445 4745 5220 2835 292c 0a20 2020 2020  TEGER (5),.     
│ │ │ │ +00003320: 2020 2072 6561 6c6d 2020 2020 2020 2020     realm        
│ │ │ │ +00003330: 2020 205b 315d 2052 6561 6c6d 2c0a 2020     [1] Realm,.  
│ │ │ │ +00003340: 2020 2020 2020 736e 616d 6520 2020 2020        sname     
│ │ │ │ +00003350: 2020 2020 2020 5b32 5d20 5072 696e 6369        [2] Princi
│ │ │ │ +00003360: 7061 6c4e 616d 652c 0a20 2020 2020 2020  palName,.       
│ │ │ │ +00003370: 2065 6e63 2d70 6172 7420 2020 2020 2020   enc-part       
│ │ │ │ +00003380: 205b 335d 2045 6e63 7279 7074 6564 4461   [3] EncryptedDa
│ │ │ │ +00003390: 7461 202d 2d20 456e 6354 6963 6b65 7450  ta -- EncTicketP
│ │ │ │ +000033a0: 6172 740a 7d0a 0a2d 2d20 456e 6372 7970  art.}..-- Encryp
│ │ │ │ +000033b0: 7465 6420 7061 7274 206f 6620 7469 636b  ted part of tick
│ │ │ │ +000033c0: 6574 0a45 6e63 5469 636b 6574 5061 7274  et.EncTicketPart
│ │ │ │ +000033d0: 2020 203a 3a3d 205b 4150 504c 4943 4154     ::= [APPLICAT
│ │ │ │ +000033e0: 494f 4e20 335d 2053 4551 5545 4e43 4520  ION 3] SEQUENCE 
│ │ │ │ +000033f0: 7b0a 2020 2020 2020 2020 666c 6167 7320  {.        flags 
│ │ │ │  00003400: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00003410: 205b 305d 2054 6963 6b65 7446 6c61 6773   [0] TicketFlags
│ │ │ │ -00003420: 2c0a 2020 2020 2020 2020 6b65 7920 2020  ,.        key   
│ │ │ │ +00003410: 2020 5b30 5d20 5469 636b 6574 466c 6167    [0] TicketFlag
│ │ │ │ +00003420: 732c 0a20 2020 2020 2020 206b 6579 2020  s,.        key  
│ │ │ │  00003430: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00003440: 2020 5b31 5d20 456e 6372 7970 7469 6f6e    [1] Encryption
│ │ │ │ -00003450: 4b65 792c 0a20 2020 2020 2020 2063 7265  Key,.        cre
│ │ │ │ -00003460: 616c 6d20 2020 2020 2020 2020 2020 2020  alm             
│ │ │ │ -00003470: 2020 2020 205b 325d 2052 6561 6c6d 2c0a       [2] Realm,.
│ │ │ │ -00003480: 2020 2020 2020 2020 636e 616d 6520 2020          cname   
│ │ │ │ +00003440: 2020 205b 315d 2045 6e63 7279 7074 696f     [1] Encryptio
│ │ │ │ +00003450: 6e4b 6579 2c0a 2020 2020 2020 2020 6372  nKey,.        cr
│ │ │ │ +00003460: 6561 6c6d 2020 2020 2020 2020 2020 2020  ealm            
│ │ │ │ +00003470: 2020 2020 2020 5b32 5d20 5265 616c 6d2c        [2] Realm,
│ │ │ │ +00003480: 0a20 2020 2020 2020 2063 6e61 6d65 2020  .        cname  
│ │ │ │  00003490: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000034a0: 5b33 5d20 5072 696e 6369 7061 6c4e 616d  [3] PrincipalNam
│ │ │ │ -000034b0: 652c 0a20 2020 2020 2020 2074 7261 6e73  e,.        trans
│ │ │ │ -000034c0: 6974 6564 2020 2020 2020 2020 2020 2020  ited            
│ │ │ │ -000034d0: 2020 205b 345d 2054 7261 6e73 6974 6564     [4] Transited
│ │ │ │ -000034e0: 456e 636f 6469 6e67 2c0a 2020 2020 2020  Encoding,.      
│ │ │ │ -000034f0: 2020 6175 7468 7469 6d65 2020 2020 2020    authtime      
│ │ │ │ -00003500: 2020 2020 2020 2020 2020 5b35 5d20 4b65            [5] Ke
│ │ │ │ -00003510: 7262 6572 6f73 5469 6d65 2c0a 2020 2020  rberosTime,.    
│ │ │ │ -00003520: 2020 2020 7374 6172 7474 696d 6520 2020      starttime   
│ │ │ │ -00003530: 2020 2020 2020 2020 2020 2020 5b36 5d20              [6] 
│ │ │ │ -00003540: 4b65 7262 6572 6f73 5469 6d65 204f 5054  KerberosTime OPT
│ │ │ │ -00003550: 494f 4e41 4c2c 0a20 2020 2020 2020 2065  IONAL,.        e
│ │ │ │ -00003560: 6e64 7469 6d65 2020 2020 2020 2020 2020  ndtime          
│ │ │ │ -00003570: 2020 2020 2020 205b 375d 204b 6572 6265         [7] Kerbe
│ │ │ │ -00003580: 726f 7354 696d 652c 0a20 2020 2020 2020  rosTime,.       
│ │ │ │ -00003590: 2072 656e 6577 2d74 696c 6c20 2020 2020   renew-till     
│ │ │ │ -000035a0: 2020 2020 2020 2020 205b 385d 204b 6572           [8] Ker
│ │ │ │ -000035b0: 6265 726f 7354 696d 6520 4f50 5449 4f4e  berosTime OPTION
│ │ │ │ -000035c0: 414c 2c0a 2020 2020 2020 2020 6361 6464  AL,.        cadd
│ │ │ │ -000035d0: 7220 2020 2020 2020 2020 2020 2020 2020  r               
│ │ │ │ -000035e0: 2020 2020 5b39 5d20 486f 7374 4164 6472      [9] HostAddr
│ │ │ │ -000035f0: 6573 7365 7320 4f50 5449 4f4e 414c 2c0a  esses OPTIONAL,.
│ │ │ │ -00003600: 2020 2020 2020 2020 6175 7468 6f72 697a          authoriz
│ │ │ │ -00003610: 6174 696f 6e2d 6461 7461 2020 2020 2020  ation-data      
│ │ │ │ -00003620: 5b31 305d 2041 7574 686f 7269 7a61 7469  [10] Authorizati
│ │ │ │ -00003630: 6f6e 4461 7461 204f 5054 494f 4e41 4c0a  onData OPTIONAL.
│ │ │ │ -00003640: 7d0a 0a73 6869 7368 695f 7469 636b 6574  }..shishi_ticket
│ │ │ │ -00003650: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  .-------------..
│ │ │ │ -00003660: 202d 2d20 4675 6e63 7469 6f6e 3a20 5368   -- Function: Sh
│ │ │ │ -00003670: 6973 6869 5f61 736e 3120 7368 6973 6869  ishi_asn1 shishi
│ │ │ │ -00003680: 5f74 6963 6b65 7420 2853 6869 7368 6920  _ticket (Shishi 
│ │ │ │ -00003690: 2a20 4841 4e44 4c45 290a 2020 2020 2048  * HANDLE).     H
│ │ │ │ -000036a0: 414e 444c 453a 2073 6869 7368 6920 6861  ANDLE: shishi ha
│ │ │ │ -000036b0: 6e64 6c65 2061 7320 616c 6c6f 6361 7465  ndle as allocate
│ │ │ │ -000036c0: 6420 6279 20e2 8098 7368 6973 6869 5f69  d by ...shishi_i
│ │ │ │ -000036d0: 6e69 7428 29e2 8099 2e0a 0a20 2020 2020  nit()......     
│ │ │ │ -000036e0: 2a44 6573 6372 6970 7469 6f6e 3a2a 2054  *Description:* T
│ │ │ │ -000036f0: 6869 7320 6675 6e63 7469 6f6e 2063 7265  his function cre
│ │ │ │ -00003700: 6174 6573 2061 206e 6577 2041 534e 2e31  ates a new ASN.1
│ │ │ │ -00003710: 2054 6963 6b65 742c 2070 6f70 756c 6174   Ticket, populat
│ │ │ │ -00003720: 6564 0a20 2020 2020 7769 7468 2073 6f6d  ed.     with som
│ │ │ │ -00003730: 6520 6465 6661 756c 7420 7661 6c75 6573  e default values
│ │ │ │ -00003740: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ -00003750: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ -00003760: 7468 6520 7469 636b 6574 206f 7220 4e55  the ticket or NU
│ │ │ │ -00003770: 4c4c 206f 6e20 6661 696c 7572 652e 0a0a  LL on failure...
│ │ │ │ -00003780: 7368 6973 6869 5f74 6963 6b65 745f 7265  shishi_ticket_re
│ │ │ │ -00003790: 616c 6d5f 6765 740a 2d2d 2d2d 2d2d 2d2d  alm_get.--------
│ │ │ │ -000037a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -000037b0: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ -000037c0: 6e74 2073 6869 7368 695f 7469 636b 6574  nt shishi_ticket
│ │ │ │ -000037d0: 5f72 6561 6c6d 5f67 6574 2028 5368 6973  _realm_get (Shis
│ │ │ │ -000037e0: 6869 202a 2048 414e 444c 452c 0a20 2020  hi * HANDLE,.   
│ │ │ │ -000037f0: 2020 2020 2020 2053 6869 7368 695f 6173         Shishi_as
│ │ │ │ -00003800: 6e31 2054 4943 4b45 542c 2063 6861 7220  n1 TICKET, char 
│ │ │ │ -00003810: 2a2a 2052 4541 4c4d 2c20 7369 7a65 5f74  ** REALM, size_t
│ │ │ │ -00003820: 202a 2052 4541 4c4d 4c45 4e29 0a20 2020   * REALMLEN).   
│ │ │ │ -00003830: 2020 4841 4e44 4c45 3a20 7368 6973 6869    HANDLE: shishi
│ │ │ │ -00003840: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ -00003850: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ -00003860: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ -00003870: 2020 5449 434b 4554 3a20 696e 7075 7420    TICKET: input 
│ │ │ │ -00003880: 7661 7269 6162 6c65 2077 6974 6820 7469  variable with ti
│ │ │ │ -00003890: 636b 6574 2069 6e66 6f2e 0a20 2020 2020  cket info..     
│ │ │ │ -000038a0: 5245 414c 4d3a 206f 7574 7075 7420 6172  REALM: output ar
│ │ │ │ -000038b0: 7261 7920 7769 7468 206e 6577 6c79 2061  ray with newly a
│ │ │ │ -000038c0: 6c6c 6f63 6174 6564 206e 616d 6520 6f66  llocated name of
│ │ │ │ -000038d0: 2072 6561 6c6d 2069 6e20 7469 636b 6574   realm in ticket
│ │ │ │ -000038e0: 2e0a 2020 2020 2052 4541 4c4d 4c45 4e3a  ..     REALMLEN:
│ │ │ │ -000038f0: 2073 697a 6520 6f66 206f 7574 7075 7420   size of output 
│ │ │ │ -00003900: 6172 7261 792e 0a0a 2020 2020 202a 4465  array...     *De
│ │ │ │ -00003910: 7363 7269 7074 696f 6e3a 2a20 4578 7472  scription:* Extr
│ │ │ │ -00003920: 6163 7420 7265 616c 6d20 6672 6f6d 2074  act realm from t
│ │ │ │ -00003930: 6963 6b65 742e 0a0a 2020 2020 202a 5265  icket...     *Re
│ │ │ │ -00003940: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ -00003950: 7572 6e73 2053 4849 5348 495f 4f4b 2069  urns SHISHI_OK i
│ │ │ │ -00003960: 6666 2073 7563 6365 7373 6675 6c2e 0a0a  ff successful...
│ │ │ │ -00003970: 7368 6973 6869 5f74 6963 6b65 745f 7265  shishi_ticket_re
│ │ │ │ -00003980: 616c 6d5f 7365 740a 2d2d 2d2d 2d2d 2d2d  alm_set.--------
│ │ │ │ -00003990: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -000039a0: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ -000039b0: 6e74 2073 6869 7368 695f 7469 636b 6574  nt shishi_ticket
│ │ │ │ -000039c0: 5f72 6561 6c6d 5f73 6574 2028 5368 6973  _realm_set (Shis
│ │ │ │ -000039d0: 6869 202a 2048 414e 444c 452c 0a20 2020  hi * HANDLE,.   
│ │ │ │ -000039e0: 2020 2020 2020 2053 6869 7368 695f 6173         Shishi_as
│ │ │ │ -000039f0: 6e31 2054 4943 4b45 542c 2063 6f6e 7374  n1 TICKET, const
│ │ │ │ -00003a00: 2063 6861 7220 2a20 5245 414c 4d29 0a20   char * REALM). 
│ │ │ │ -00003a10: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ -00003a20: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ -00003a30: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ -00003a40: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ -00003a50: 2020 2020 5449 434b 4554 3a20 696e 7075      TICKET: inpu
│ │ │ │ -00003a60: 7420 7661 7269 6162 6c65 2077 6974 6820  t variable with 
│ │ │ │ -00003a70: 7469 636b 6574 2069 6e66 6f2e 0a20 2020  ticket info..   
│ │ │ │ -00003a80: 2020 5245 414c 4d3a 2069 6e70 7574 2061    REALM: input a
│ │ │ │ -00003a90: 7272 6179 2077 6974 6820 6e61 6d65 206f  rray with name o
│ │ │ │ -00003aa0: 6620 7265 616c 6d2e 0a0a 2020 2020 202a  f realm...     *
│ │ │ │ -00003ab0: 4465 7363 7269 7074 696f 6e3a 2a20 5365  Description:* Se
│ │ │ │ -00003ac0: 7420 7468 6520 7265 616c 6d20 6669 656c  t the realm fiel
│ │ │ │ -00003ad0: 6420 696e 2074 6865 2054 6963 6b65 742e  d in the Ticket.
│ │ │ │ -00003ae0: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ -00003af0: 616c 7565 3a2a 2052 6574 7572 6e73 2053  alue:* Returns S
│ │ │ │ -00003b00: 4849 5348 495f 4f4b 2069 6666 2073 7563  HISHI_OK iff suc
│ │ │ │ -00003b10: 6365 7373 6675 6c2e 0a0a 7368 6973 6869  cessful...shishi
│ │ │ │ -00003b20: 5f74 6963 6b65 745f 7365 7276 6572 0a2d  _ticket_server.-
│ │ │ │ +000034a0: 205b 335d 2050 7269 6e63 6970 616c 4e61   [3] PrincipalNa
│ │ │ │ +000034b0: 6d65 2c0a 2020 2020 2020 2020 7472 616e  me,.        tran
│ │ │ │ +000034c0: 7369 7465 6420 2020 2020 2020 2020 2020  sited           
│ │ │ │ +000034d0: 2020 2020 5b34 5d20 5472 616e 7369 7465      [4] Transite
│ │ │ │ +000034e0: 6445 6e63 6f64 696e 672c 0a20 2020 2020  dEncoding,.     
│ │ │ │ +000034f0: 2020 2061 7574 6874 696d 6520 2020 2020     authtime     
│ │ │ │ +00003500: 2020 2020 2020 2020 2020 205b 355d 204b             [5] K
│ │ │ │ +00003510: 6572 6265 726f 7354 696d 652c 0a20 2020  erberosTime,.   
│ │ │ │ +00003520: 2020 2020 2073 7461 7274 7469 6d65 2020       starttime  
│ │ │ │ +00003530: 2020 2020 2020 2020 2020 2020 205b 365d               [6]
│ │ │ │ +00003540: 204b 6572 6265 726f 7354 696d 6520 4f50   KerberosTime OP
│ │ │ │ +00003550: 5449 4f4e 414c 2c0a 2020 2020 2020 2020  TIONAL,.        
│ │ │ │ +00003560: 656e 6474 696d 6520 2020 2020 2020 2020  endtime         
│ │ │ │ +00003570: 2020 2020 2020 2020 5b37 5d20 4b65 7262          [7] Kerb
│ │ │ │ +00003580: 6572 6f73 5469 6d65 2c0a 2020 2020 2020  erosTime,.      
│ │ │ │ +00003590: 2020 7265 6e65 772d 7469 6c6c 2020 2020    renew-till    
│ │ │ │ +000035a0: 2020 2020 2020 2020 2020 5b38 5d20 4b65            [8] Ke
│ │ │ │ +000035b0: 7262 6572 6f73 5469 6d65 204f 5054 494f  rberosTime OPTIO
│ │ │ │ +000035c0: 4e41 4c2c 0a20 2020 2020 2020 2063 6164  NAL,.        cad
│ │ │ │ +000035d0: 6472 2020 2020 2020 2020 2020 2020 2020  dr              
│ │ │ │ +000035e0: 2020 2020 205b 395d 2048 6f73 7441 6464       [9] HostAdd
│ │ │ │ +000035f0: 7265 7373 6573 204f 5054 494f 4e41 4c2c  resses OPTIONAL,
│ │ │ │ +00003600: 0a20 2020 2020 2020 2061 7574 686f 7269  .        authori
│ │ │ │ +00003610: 7a61 7469 6f6e 2d64 6174 6120 2020 2020  zation-data     
│ │ │ │ +00003620: 205b 3130 5d20 4175 7468 6f72 697a 6174   [10] Authorizat
│ │ │ │ +00003630: 696f 6e44 6174 6120 4f50 5449 4f4e 414c  ionData OPTIONAL
│ │ │ │ +00003640: 0a7d 0a0a 7368 6973 6869 5f74 6963 6b65  .}..shishi_ticke
│ │ │ │ +00003650: 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  t.-------------.
│ │ │ │ +00003660: 0a20 2d2d 2046 756e 6374 696f 6e3a 2053  . -- Function: S
│ │ │ │ +00003670: 6869 7368 695f 6173 6e31 2073 6869 7368  hishi_asn1 shish
│ │ │ │ +00003680: 695f 7469 636b 6574 2028 5368 6973 6869  i_ticket (Shishi
│ │ │ │ +00003690: 202a 2048 414e 444c 4529 0a20 2020 2020   * HANDLE).     
│ │ │ │ +000036a0: 4841 4e44 4c45 3a20 7368 6973 6869 2068  HANDLE: shishi h
│ │ │ │ +000036b0: 616e 646c 6520 6173 2061 6c6c 6f63 6174  andle as allocat
│ │ │ │ +000036c0: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ +000036d0: 696e 6974 2829 e280 992e 0a0a 2020 2020  init()......    
│ │ │ │ +000036e0: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ +000036f0: 5468 6973 2066 756e 6374 696f 6e20 6372  This function cr
│ │ │ │ +00003700: 6561 7465 7320 6120 6e65 7720 4153 4e2e  eates a new ASN.
│ │ │ │ +00003710: 3120 5469 636b 6574 2c20 706f 7075 6c61  1 Ticket, popula
│ │ │ │ +00003720: 7465 640a 2020 2020 2077 6974 6820 736f  ted.     with so
│ │ │ │ +00003730: 6d65 2064 6566 6175 6c74 2076 616c 7565  me default value
│ │ │ │ +00003740: 732e 0a0a 2020 2020 202a 5265 7475 726e  s...     *Return
│ │ │ │ +00003750: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ +00003760: 2074 6865 2074 6963 6b65 7420 6f72 204e   the ticket or N
│ │ │ │ +00003770: 554c 4c20 6f6e 2066 6169 6c75 7265 2e0a  ULL on failure..
│ │ │ │ +00003780: 0a73 6869 7368 695f 7469 636b 6574 5f72  .shishi_ticket_r
│ │ │ │ +00003790: 6561 6c6d 5f67 6574 0a2d 2d2d 2d2d 2d2d  ealm_get.-------
│ │ │ │ +000037a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +000037b0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +000037c0: 696e 7420 7368 6973 6869 5f74 6963 6b65  int shishi_ticke
│ │ │ │ +000037d0: 745f 7265 616c 6d5f 6765 7420 2853 6869  t_realm_get (Shi
│ │ │ │ +000037e0: 7368 6920 2a20 4841 4e44 4c45 2c0a 2020  shi * HANDLE,.  
│ │ │ │ +000037f0: 2020 2020 2020 2020 5368 6973 6869 5f61          Shishi_a
│ │ │ │ +00003800: 736e 3120 5449 434b 4554 2c20 6368 6172  sn1 TICKET, char
│ │ │ │ +00003810: 202a 2a20 5245 414c 4d2c 2073 697a 655f   ** REALM, size_
│ │ │ │ +00003820: 7420 2a20 5245 414c 4d4c 454e 290a 2020  t * REALMLEN).  
│ │ │ │ +00003830: 2020 2048 414e 444c 453a 2073 6869 7368     HANDLE: shish
│ │ │ │ +00003840: 6920 6861 6e64 6c65 2061 7320 616c 6c6f  i handle as allo
│ │ │ │ +00003850: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ +00003860: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ +00003870: 2020 2054 4943 4b45 543a 2069 6e70 7574     TICKET: input
│ │ │ │ +00003880: 2076 6172 6961 626c 6520 7769 7468 2074   variable with t
│ │ │ │ +00003890: 6963 6b65 7420 696e 666f 2e0a 2020 2020  icket info..    
│ │ │ │ +000038a0: 2052 4541 4c4d 3a20 6f75 7470 7574 2061   REALM: output a
│ │ │ │ +000038b0: 7272 6179 2077 6974 6820 6e65 776c 7920  rray with newly 
│ │ │ │ +000038c0: 616c 6c6f 6361 7465 6420 6e61 6d65 206f  allocated name o
│ │ │ │ +000038d0: 6620 7265 616c 6d20 696e 2074 6963 6b65  f realm in ticke
│ │ │ │ +000038e0: 742e 0a20 2020 2020 5245 414c 4d4c 454e  t..     REALMLEN
│ │ │ │ +000038f0: 3a20 7369 7a65 206f 6620 6f75 7470 7574  : size of output
│ │ │ │ +00003900: 2061 7272 6179 2e0a 0a20 2020 2020 2a44   array...     *D
│ │ │ │ +00003910: 6573 6372 6970 7469 6f6e 3a2a 2045 7874  escription:* Ext
│ │ │ │ +00003920: 7261 6374 2072 6561 6c6d 2066 726f 6d20  ract realm from 
│ │ │ │ +00003930: 7469 636b 6574 2e0a 0a20 2020 2020 2a52  ticket...     *R
│ │ │ │ +00003940: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +00003950: 7475 726e 7320 5348 4953 4849 5f4f 4b20  turns SHISHI_OK 
│ │ │ │ +00003960: 6966 6620 7375 6363 6573 7366 756c 2e0a  iff successful..
│ │ │ │ +00003970: 0a73 6869 7368 695f 7469 636b 6574 5f72  .shishi_ticket_r
│ │ │ │ +00003980: 6561 6c6d 5f73 6574 0a2d 2d2d 2d2d 2d2d  ealm_set.-------
│ │ │ │ +00003990: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +000039a0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +000039b0: 696e 7420 7368 6973 6869 5f74 6963 6b65  int shishi_ticke
│ │ │ │ +000039c0: 745f 7265 616c 6d5f 7365 7420 2853 6869  t_realm_set (Shi
│ │ │ │ +000039d0: 7368 6920 2a20 4841 4e44 4c45 2c0a 2020  shi * HANDLE,.  
│ │ │ │ +000039e0: 2020 2020 2020 2020 5368 6973 6869 5f61          Shishi_a
│ │ │ │ +000039f0: 736e 3120 5449 434b 4554 2c20 636f 6e73  sn1 TICKET, cons
│ │ │ │ +00003a00: 7420 6368 6172 202a 2052 4541 4c4d 290a  t char * REALM).
│ │ │ │ +00003a10: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ +00003a20: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ +00003a30: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ +00003a40: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ +00003a50: 2020 2020 2054 4943 4b45 543a 2069 6e70       TICKET: inp
│ │ │ │ +00003a60: 7574 2076 6172 6961 626c 6520 7769 7468  ut variable with
│ │ │ │ +00003a70: 2074 6963 6b65 7420 696e 666f 2e0a 2020   ticket info..  
│ │ │ │ +00003a80: 2020 2052 4541 4c4d 3a20 696e 7075 7420     REALM: input 
│ │ │ │ +00003a90: 6172 7261 7920 7769 7468 206e 616d 6520  array with name 
│ │ │ │ +00003aa0: 6f66 2072 6561 6c6d 2e0a 0a20 2020 2020  of realm...     
│ │ │ │ +00003ab0: 2a44 6573 6372 6970 7469 6f6e 3a2a 2053  *Description:* S
│ │ │ │ +00003ac0: 6574 2074 6865 2072 6561 6c6d 2066 6965  et the realm fie
│ │ │ │ +00003ad0: 6c64 2069 6e20 7468 6520 5469 636b 6574  ld in the Ticket
│ │ │ │ +00003ae0: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ +00003af0: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ +00003b00: 5348 4953 4849 5f4f 4b20 6966 6620 7375  SHISHI_OK iff su
│ │ │ │ +00003b10: 6363 6573 7366 756c 2e0a 0a73 6869 7368  ccessful...shish
│ │ │ │ +00003b20: 695f 7469 636b 6574 5f73 6572 7665 720a  i_ticket_server.
│ │ │ │  00003b30: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00003b40: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ -00003b50: 6e3a 2069 6e74 2073 6869 7368 695f 7469  n: int shishi_ti
│ │ │ │ -00003b60: 636b 6574 5f73 6572 7665 7220 2853 6869  cket_server (Shi
│ │ │ │ -00003b70: 7368 6920 2a20 4841 4e44 4c45 2c0a 2020  shi * HANDLE,.  
│ │ │ │ -00003b80: 2020 2020 2020 2020 5368 6973 6869 5f61          Shishi_a
│ │ │ │ -00003b90: 736e 3120 5449 434b 4554 2c20 6368 6172  sn1 TICKET, char
│ │ │ │ -00003ba0: 202a 2a20 5345 5256 4552 2c20 7369 7a65   ** SERVER, size
│ │ │ │ -00003bb0: 5f74 202a 2053 4552 5645 524c 454e 290a  _t * SERVERLEN).
│ │ │ │ -00003bc0: 2020 2020 2048 414e 444c 453a 2053 6869       HANDLE: Shi
│ │ │ │ -00003bd0: 7368 6920 6c69 6272 6172 7920 6861 6e64  shi library hand
│ │ │ │ -00003be0: 6c65 2063 7265 6174 6520 6279 20e2 8098  le create by ...
│ │ │ │ -00003bf0: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ -00003c00: 2e0a 2020 2020 2054 4943 4b45 543a 2041  ..     TICKET: A
│ │ │ │ -00003c10: 534e 2e31 2054 6963 6b65 7420 7661 7269  SN.1 Ticket vari
│ │ │ │ -00003c20: 6162 6c65 2074 6f20 6765 7420 7365 7276  able to get serv
│ │ │ │ -00003c30: 6572 206e 616d 6520 6672 6f6d 2e0a 2020  er name from..  
│ │ │ │ -00003c40: 2020 2053 4552 5645 523a 2070 6f69 6e74     SERVER: point
│ │ │ │ -00003c50: 6572 2074 6f20 6e65 776c 7920 616c 6c6f  er to newly allo
│ │ │ │ -00003c60: 6361 7465 6420 7a65 726f 2074 6572 6d69  cated zero termi
│ │ │ │ -00003c70: 6e61 7465 6420 7374 7269 6e67 0a20 2020  nated string.   
│ │ │ │ -00003c80: 2020 636f 6e74 6169 6e69 6e67 2070 7269    containing pri
│ │ │ │ -00003c90: 6e63 6970 616c 206e 616d 652e 2020 4d61  ncipal name.  Ma
│ │ │ │ -00003ca0: 7920 6265 20e2 8098 4e55 4c4c e280 9920  y be ...NULL... 
│ │ │ │ -00003cb0: 2874 6f20 6f6e 6c79 2070 6f70 756c 6174  (to only populat
│ │ │ │ -00003cc0: 650a 2020 2020 2053 4552 5645 524c 454e  e.     SERVERLEN
│ │ │ │ -00003cd0: 292e 0a20 2020 2020 5345 5256 4552 4c45  )..     SERVERLE
│ │ │ │ -00003ce0: 4e3a 2070 6f69 6e74 6572 2074 6f20 6c65  N: pointer to le
│ │ │ │ -00003cf0: 6e67 7468 206f 6620 5345 5256 4552 206f  ngth of SERVER o
│ │ │ │ -00003d00: 6e20 6f75 7470 7574 2c20 6578 636c 7564  n output, exclud
│ │ │ │ -00003d10: 696e 670a 2020 2020 2074 6572 6d69 6e61  ing.     termina
│ │ │ │ -00003d20: 7469 6e67 207a 6572 6f2e 2020 4d61 7920  ting zero.  May 
│ │ │ │ -00003d30: 6265 20e2 8098 4e55 4c4c e280 9920 2874  be ...NULL... (t
│ │ │ │ -00003d40: 6f20 6f6e 6c79 2070 6f70 756c 6174 6520  o only populate 
│ │ │ │ -00003d50: 5345 5256 4552 292e 0a0a 2020 2020 202a  SERVER)...     *
│ │ │ │ -00003d60: 4465 7363 7269 7074 696f 6e3a 2a20 5265  Description:* Re
│ │ │ │ -00003d70: 7072 6573 656e 7420 7365 7276 6572 2070  present server p
│ │ │ │ -00003d80: 7269 6e63 6970 616c 206e 616d 6520 696e  rincipal name in
│ │ │ │ -00003d90: 2054 6963 6b65 7420 6173 0a20 2020 2020   Ticket as.     
│ │ │ │ -00003da0: 7a65 726f 2d74 6572 6d69 6e61 7465 6420  zero-terminated 
│ │ │ │ -00003db0: 7374 7269 6e67 2e20 2054 6865 2073 7472  string.  The str
│ │ │ │ -00003dc0: 696e 6720 6973 2061 6c6c 6f63 6174 6520  ing is allocate 
│ │ │ │ -00003dd0: 6279 2074 6869 7320 6675 6e63 7469 6f6e  by this function
│ │ │ │ -00003de0: 2c0a 2020 2020 2061 6e64 2069 7420 6973  ,.     and it is
│ │ │ │ -00003df0: 2074 6865 2072 6573 706f 6e73 6962 696c   the responsibil
│ │ │ │ -00003e00: 6974 7920 6f66 2074 6865 2063 616c 6c65  ity of the calle
│ │ │ │ -00003e10: 7220 746f 2064 6561 6c6c 6f63 6174 6520  r to deallocate 
│ │ │ │ -00003e20: 6974 2e20 204e 6f74 650a 2020 2020 2074  it.  Note.     t
│ │ │ │ -00003e30: 6861 7420 7468 6520 6f75 7470 7574 206c  hat the output l
│ │ │ │ -00003e40: 656e 6774 6820 5345 5256 4552 4c45 4e20  ength SERVERLEN 
│ │ │ │ -00003e50: 646f 6573 206e 6f74 2069 6e63 6c75 6465  does not include
│ │ │ │ -00003e60: 2074 6865 2074 6572 6d69 6e61 7469 6e67   the terminating
│ │ │ │ -00003e70: 0a20 2020 2020 7a65 726f 2e0a 0a20 2020  .     zero...   
│ │ │ │ -00003e80: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ -00003e90: 2a20 5265 7475 726e 7320 5348 4953 4849  * Returns SHISHI
│ │ │ │ -00003ea0: 5f4f 4b20 6966 6620 7375 6363 6573 7366  _OK iff successf
│ │ │ │ -00003eb0: 756c 2e0a 0a73 6869 7368 695f 7469 636b  ul...shishi_tick
│ │ │ │ -00003ec0: 6574 5f73 6e61 6d65 5f73 6574 0a2d 2d2d  et_sname_set.---
│ │ │ │ +00003b40: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ +00003b50: 6f6e 3a20 696e 7420 7368 6973 6869 5f74  on: int shishi_t
│ │ │ │ +00003b60: 6963 6b65 745f 7365 7276 6572 2028 5368  icket_server (Sh
│ │ │ │ +00003b70: 6973 6869 202a 2048 414e 444c 452c 0a20  ishi * HANDLE,. 
│ │ │ │ +00003b80: 2020 2020 2020 2020 2053 6869 7368 695f           Shishi_
│ │ │ │ +00003b90: 6173 6e31 2054 4943 4b45 542c 2063 6861  asn1 TICKET, cha
│ │ │ │ +00003ba0: 7220 2a2a 2053 4552 5645 522c 2073 697a  r ** SERVER, siz
│ │ │ │ +00003bb0: 655f 7420 2a20 5345 5256 4552 4c45 4e29  e_t * SERVERLEN)
│ │ │ │ +00003bc0: 0a20 2020 2020 4841 4e44 4c45 3a20 5368  .     HANDLE: Sh
│ │ │ │ +00003bd0: 6973 6869 206c 6962 7261 7279 2068 616e  ishi library han
│ │ │ │ +00003be0: 646c 6520 6372 6561 7465 2062 7920 e280  dle create by ..
│ │ │ │ +00003bf0: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ +00003c00: 992e 0a20 2020 2020 5449 434b 4554 3a20  ...     TICKET: 
│ │ │ │ +00003c10: 4153 4e2e 3120 5469 636b 6574 2076 6172  ASN.1 Ticket var
│ │ │ │ +00003c20: 6961 626c 6520 746f 2067 6574 2073 6572  iable to get ser
│ │ │ │ +00003c30: 7665 7220 6e61 6d65 2066 726f 6d2e 0a20  ver name from.. 
│ │ │ │ +00003c40: 2020 2020 5345 5256 4552 3a20 706f 696e      SERVER: poin
│ │ │ │ +00003c50: 7465 7220 746f 206e 6577 6c79 2061 6c6c  ter to newly all
│ │ │ │ +00003c60: 6f63 6174 6564 207a 6572 6f20 7465 726d  ocated zero term
│ │ │ │ +00003c70: 696e 6174 6564 2073 7472 696e 670a 2020  inated string.  
│ │ │ │ +00003c80: 2020 2063 6f6e 7461 696e 696e 6720 7072     containing pr
│ │ │ │ +00003c90: 696e 6369 7061 6c20 6e61 6d65 2e20 204d  incipal name.  M
│ │ │ │ +00003ca0: 6179 2062 6520 e280 984e 554c 4ce2 8099  ay be ...NULL...
│ │ │ │ +00003cb0: 2028 746f 206f 6e6c 7920 706f 7075 6c61   (to only popula
│ │ │ │ +00003cc0: 7465 0a20 2020 2020 5345 5256 4552 4c45  te.     SERVERLE
│ │ │ │ +00003cd0: 4e29 2e0a 2020 2020 2053 4552 5645 524c  N)..     SERVERL
│ │ │ │ +00003ce0: 454e 3a20 706f 696e 7465 7220 746f 206c  EN: pointer to l
│ │ │ │ +00003cf0: 656e 6774 6820 6f66 2053 4552 5645 5220  ength of SERVER 
│ │ │ │ +00003d00: 6f6e 206f 7574 7075 742c 2065 7863 6c75  on output, exclu
│ │ │ │ +00003d10: 6469 6e67 0a20 2020 2020 7465 726d 696e  ding.     termin
│ │ │ │ +00003d20: 6174 696e 6720 7a65 726f 2e20 204d 6179  ating zero.  May
│ │ │ │ +00003d30: 2062 6520 e280 984e 554c 4ce2 8099 2028   be ...NULL... (
│ │ │ │ +00003d40: 746f 206f 6e6c 7920 706f 7075 6c61 7465  to only populate
│ │ │ │ +00003d50: 2053 4552 5645 5229 2e0a 0a20 2020 2020   SERVER)...     
│ │ │ │ +00003d60: 2a44 6573 6372 6970 7469 6f6e 3a2a 2052  *Description:* R
│ │ │ │ +00003d70: 6570 7265 7365 6e74 2073 6572 7665 7220  epresent server 
│ │ │ │ +00003d80: 7072 696e 6369 7061 6c20 6e61 6d65 2069  principal name i
│ │ │ │ +00003d90: 6e20 5469 636b 6574 2061 730a 2020 2020  n Ticket as.    
│ │ │ │ +00003da0: 207a 6572 6f2d 7465 726d 696e 6174 6564   zero-terminated
│ │ │ │ +00003db0: 2073 7472 696e 672e 2020 5468 6520 7374   string.  The st
│ │ │ │ +00003dc0: 7269 6e67 2069 7320 616c 6c6f 6361 7465  ring is allocate
│ │ │ │ +00003dd0: 2062 7920 7468 6973 2066 756e 6374 696f   by this functio
│ │ │ │ +00003de0: 6e2c 0a20 2020 2020 616e 6420 6974 2069  n,.     and it i
│ │ │ │ +00003df0: 7320 7468 6520 7265 7370 6f6e 7369 6269  s the responsibi
│ │ │ │ +00003e00: 6c69 7479 206f 6620 7468 6520 6361 6c6c  lity of the call
│ │ │ │ +00003e10: 6572 2074 6f20 6465 616c 6c6f 6361 7465  er to deallocate
│ │ │ │ +00003e20: 2069 742e 2020 4e6f 7465 0a20 2020 2020   it.  Note.     
│ │ │ │ +00003e30: 7468 6174 2074 6865 206f 7574 7075 7420  that the output 
│ │ │ │ +00003e40: 6c65 6e67 7468 2053 4552 5645 524c 454e  length SERVERLEN
│ │ │ │ +00003e50: 2064 6f65 7320 6e6f 7420 696e 636c 7564   does not includ
│ │ │ │ +00003e60: 6520 7468 6520 7465 726d 696e 6174 696e  e the terminatin
│ │ │ │ +00003e70: 670a 2020 2020 207a 6572 6f2e 0a0a 2020  g.     zero...  
│ │ │ │ +00003e80: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ +00003e90: 3a2a 2052 6574 7572 6e73 2053 4849 5348  :* Returns SHISH
│ │ │ │ +00003ea0: 495f 4f4b 2069 6666 2073 7563 6365 7373  I_OK iff success
│ │ │ │ +00003eb0: 6675 6c2e 0a0a 7368 6973 6869 5f74 6963  ful...shishi_tic
│ │ │ │ +00003ec0: 6b65 745f 736e 616d 655f 7365 740a 2d2d  ket_sname_set.--
│ │ │ │  00003ed0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00003ee0: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -00003ef0: 6f6e 3a20 696e 7420 7368 6973 6869 5f74  on: int shishi_t
│ │ │ │ -00003f00: 6963 6b65 745f 736e 616d 655f 7365 7420  icket_sname_set 
│ │ │ │ -00003f10: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ -00003f20: 2c0a 2020 2020 2020 2020 2020 5368 6973  ,.          Shis
│ │ │ │ -00003f30: 6869 5f61 736e 3120 5449 434b 4554 2c20  hi_asn1 TICKET, 
│ │ │ │ -00003f40: 5368 6973 6869 5f6e 616d 655f 7479 7065  Shishi_name_type
│ │ │ │ -00003f50: 204e 414d 455f 5459 5045 2c0a 2020 2020   NAME_TYPE,.    
│ │ │ │ -00003f60: 2020 2020 2020 6368 6172 202a 2053 4e41        char * SNA
│ │ │ │ -00003f70: 4d45 5b5d 290a 2020 2020 2048 414e 444c  ME[]).     HANDL
│ │ │ │ -00003f80: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ -00003f90: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ -00003fa0: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ -00003fb0: 29e2 8099 2e0a 2020 2020 2054 4943 4b45  ).....     TICKE
│ │ │ │ -00003fc0: 543a 2054 6963 6b65 7420 7661 7269 6162  T: Ticket variab
│ │ │ │ -00003fd0: 6c65 2074 6f20 7365 7420 7365 7276 6572  le to set server
│ │ │ │ -00003fe0: 206e 616d 6520 6669 656c 6420 696e 2e0a   name field in..
│ │ │ │ -00003ff0: 2020 2020 204e 414d 455f 5459 5045 3a20       NAME_TYPE: 
│ │ │ │ -00004000: 7479 7065 206f 6620 7072 696e 6369 7069  type of principi
│ │ │ │ -00004010: 616c 2c20 7365 6520 5368 6973 6869 5f6e  al, see Shishi_n
│ │ │ │ -00004020: 616d 655f 7479 7065 2c20 7573 7561 6c6c  ame_type, usuall
│ │ │ │ -00004030: 790a 2020 2020 2053 4849 5348 495f 4e54  y.     SHISHI_NT
│ │ │ │ -00004040: 5f55 4e4b 4e4f 574e 2e0a 2020 2020 2053  _UNKNOWN..     S
│ │ │ │ -00004050: 4e41 4d45 3a20 696e 7075 7420 6172 7261  NAME: input arra
│ │ │ │ -00004060: 7920 7769 7468 2070 7269 6e63 6970 616c  y with principal
│ │ │ │ -00004070: 206e 616d 652e 0a0a 2020 2020 202a 4465   name...     *De
│ │ │ │ -00004080: 7363 7269 7074 696f 6e3a 2a20 5365 7420  scription:* Set 
│ │ │ │ -00004090: 7468 6520 7365 7276 6572 206e 616d 6520  the server name 
│ │ │ │ -000040a0: 6669 656c 6420 696e 2074 6865 2054 6963  field in the Tic
│ │ │ │ -000040b0: 6b65 742e 0a0a 2020 2020 202a 5265 7475  ket...     *Retu
│ │ │ │ -000040c0: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ -000040d0: 6e73 2053 4849 5348 495f 4f4b 2069 6666  ns SHISHI_OK iff
│ │ │ │ -000040e0: 2073 7563 6365 7373 6675 6c2e 0a0a 7368   successful...sh
│ │ │ │ -000040f0: 6973 6869 5f74 6963 6b65 745f 6765 745f  ishi_ticket_get_
│ │ │ │ -00004100: 656e 635f 7061 7274 5f65 7479 7065 0a2d  enc_part_etype.-
│ │ │ │ +00003ee0: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +00003ef0: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ +00003f00: 7469 636b 6574 5f73 6e61 6d65 5f73 6574  ticket_sname_set
│ │ │ │ +00003f10: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ +00003f20: 452c 0a20 2020 2020 2020 2020 2053 6869  E,.          Shi
│ │ │ │ +00003f30: 7368 695f 6173 6e31 2054 4943 4b45 542c  shi_asn1 TICKET,
│ │ │ │ +00003f40: 2053 6869 7368 695f 6e61 6d65 5f74 7970   Shishi_name_typ
│ │ │ │ +00003f50: 6520 4e41 4d45 5f54 5950 452c 0a20 2020  e NAME_TYPE,.   
│ │ │ │ +00003f60: 2020 2020 2020 2063 6861 7220 2a20 534e         char * SN
│ │ │ │ +00003f70: 414d 455b 5d29 0a20 2020 2020 4841 4e44  AME[]).     HAND
│ │ │ │ +00003f80: 4c45 3a20 7368 6973 6869 2068 616e 646c  LE: shishi handl
│ │ │ │ +00003f90: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ +00003fa0: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ +00003fb0: 2829 e280 992e 0a20 2020 2020 5449 434b  ().....     TICK
│ │ │ │ +00003fc0: 4554 3a20 5469 636b 6574 2076 6172 6961  ET: Ticket varia
│ │ │ │ +00003fd0: 626c 6520 746f 2073 6574 2073 6572 7665  ble to set serve
│ │ │ │ +00003fe0: 7220 6e61 6d65 2066 6965 6c64 2069 6e2e  r name field in.
│ │ │ │ +00003ff0: 0a20 2020 2020 4e41 4d45 5f54 5950 453a  .     NAME_TYPE:
│ │ │ │ +00004000: 2074 7970 6520 6f66 2070 7269 6e63 6970   type of princip
│ │ │ │ +00004010: 6961 6c2c 2073 6565 2053 6869 7368 695f  ial, see Shishi_
│ │ │ │ +00004020: 6e61 6d65 5f74 7970 652c 2075 7375 616c  name_type, usual
│ │ │ │ +00004030: 6c79 0a20 2020 2020 5348 4953 4849 5f4e  ly.     SHISHI_N
│ │ │ │ +00004040: 545f 554e 4b4e 4f57 4e2e 0a20 2020 2020  T_UNKNOWN..     
│ │ │ │ +00004050: 534e 414d 453a 2069 6e70 7574 2061 7272  SNAME: input arr
│ │ │ │ +00004060: 6179 2077 6974 6820 7072 696e 6369 7061  ay with principa
│ │ │ │ +00004070: 6c20 6e61 6d65 2e0a 0a20 2020 2020 2a44  l name...     *D
│ │ │ │ +00004080: 6573 6372 6970 7469 6f6e 3a2a 2053 6574  escription:* Set
│ │ │ │ +00004090: 2074 6865 2073 6572 7665 7220 6e61 6d65   the server name
│ │ │ │ +000040a0: 2066 6965 6c64 2069 6e20 7468 6520 5469   field in the Ti
│ │ │ │ +000040b0: 636b 6574 2e0a 0a20 2020 2020 2a52 6574  cket...     *Ret
│ │ │ │ +000040c0: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ +000040d0: 726e 7320 5348 4953 4849 5f4f 4b20 6966  rns SHISHI_OK if
│ │ │ │ +000040e0: 6620 7375 6363 6573 7366 756c 2e0a 0a73  f successful...s
│ │ │ │ +000040f0: 6869 7368 695f 7469 636b 6574 5f67 6574  hishi_ticket_get
│ │ │ │ +00004100: 5f65 6e63 5f70 6172 745f 6574 7970 650a  _enc_part_etype.
│ │ │ │  00004110: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00004120: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -00004130: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ -00004140: 6e74 2073 6869 7368 695f 7469 636b 6574  nt shishi_ticket
│ │ │ │ -00004150: 5f67 6574 5f65 6e63 5f70 6172 745f 6574  _get_enc_part_et
│ │ │ │ -00004160: 7970 6520 2853 6869 7368 6920 2a20 4841  ype (Shishi * HA
│ │ │ │ -00004170: 4e44 4c45 2c0a 2020 2020 2020 2020 2020  NDLE,.          
│ │ │ │ -00004180: 5368 6973 6869 5f61 736e 3120 5449 434b  Shishi_asn1 TICK
│ │ │ │ -00004190: 4554 2c20 696e 7433 325f 7420 2a20 4554  ET, int32_t * ET
│ │ │ │ -000041a0: 5950 4529 0a20 2020 2020 4841 4e44 4c45  YPE).     HANDLE
│ │ │ │ -000041b0: 3a20 7368 6973 6869 2068 616e 646c 6520  : shishi handle 
│ │ │ │ -000041c0: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ -000041d0: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ -000041e0: e280 992e 0a20 2020 2020 5449 434b 4554  .....     TICKET
│ │ │ │ -000041f0: 3a20 5469 636b 6574 2076 6172 6961 626c  : Ticket variabl
│ │ │ │ -00004200: 6520 746f 2067 6574 2076 616c 7565 2066  e to get value f
│ │ │ │ -00004210: 726f 6d2e 0a20 2020 2020 4554 5950 453a  rom..     ETYPE:
│ │ │ │ -00004220: 206f 7574 7075 7420 7661 7269 6162 6c65   output variable
│ │ │ │ -00004230: 2074 6861 7420 686f 6c64 7320 7468 6520   that holds the 
│ │ │ │ -00004240: 7661 6c75 652e 0a0a 2020 2020 202a 4465  value...     *De
│ │ │ │ -00004250: 7363 7269 7074 696f 6e3a 2a20 4578 7472  scription:* Extr
│ │ │ │ -00004260: 6163 7420 5469 636b 6574 2e65 6e63 2d70  act Ticket.enc-p
│ │ │ │ -00004270: 6172 742e 6574 7970 652e 0a0a 2020 2020  art.etype...    
│ │ │ │ -00004280: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ -00004290: 2052 6574 7572 6e73 2053 4849 5348 495f   Returns SHISHI_
│ │ │ │ -000042a0: 4f4b 2069 6666 2073 7563 6365 7373 6675  OK iff successfu
│ │ │ │ -000042b0: 6c2e 0a0a 7368 6973 6869 5f74 6963 6b65  l...shishi_ticke
│ │ │ │ -000042c0: 745f 7365 745f 656e 635f 7061 7274 0a2d  t_set_enc_part.-
│ │ │ │ +00004120: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +00004130: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +00004140: 696e 7420 7368 6973 6869 5f74 6963 6b65  int shishi_ticke
│ │ │ │ +00004150: 745f 6765 745f 656e 635f 7061 7274 5f65  t_get_enc_part_e
│ │ │ │ +00004160: 7479 7065 2028 5368 6973 6869 202a 2048  type (Shishi * H
│ │ │ │ +00004170: 414e 444c 452c 0a20 2020 2020 2020 2020  ANDLE,.         
│ │ │ │ +00004180: 2053 6869 7368 695f 6173 6e31 2054 4943   Shishi_asn1 TIC
│ │ │ │ +00004190: 4b45 542c 2069 6e74 3332 5f74 202a 2045  KET, int32_t * E
│ │ │ │ +000041a0: 5459 5045 290a 2020 2020 2048 414e 444c  TYPE).     HANDL
│ │ │ │ +000041b0: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ +000041c0: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ +000041d0: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ +000041e0: 29e2 8099 2e0a 2020 2020 2054 4943 4b45  ).....     TICKE
│ │ │ │ +000041f0: 543a 2054 6963 6b65 7420 7661 7269 6162  T: Ticket variab
│ │ │ │ +00004200: 6c65 2074 6f20 6765 7420 7661 6c75 6520  le to get value 
│ │ │ │ +00004210: 6672 6f6d 2e0a 2020 2020 2045 5459 5045  from..     ETYPE
│ │ │ │ +00004220: 3a20 6f75 7470 7574 2076 6172 6961 626c  : output variabl
│ │ │ │ +00004230: 6520 7468 6174 2068 6f6c 6473 2074 6865  e that holds the
│ │ │ │ +00004240: 2076 616c 7565 2e0a 0a20 2020 2020 2a44   value...     *D
│ │ │ │ +00004250: 6573 6372 6970 7469 6f6e 3a2a 2045 7874  escription:* Ext
│ │ │ │ +00004260: 7261 6374 2054 6963 6b65 742e 656e 632d  ract Ticket.enc-
│ │ │ │ +00004270: 7061 7274 2e65 7479 7065 2e0a 0a20 2020  part.etype...   
│ │ │ │ +00004280: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ +00004290: 2a20 5265 7475 726e 7320 5348 4953 4849  * Returns SHISHI
│ │ │ │ +000042a0: 5f4f 4b20 6966 6620 7375 6363 6573 7366  _OK iff successf
│ │ │ │ +000042b0: 756c 2e0a 0a73 6869 7368 695f 7469 636b  ul...shishi_tick
│ │ │ │ +000042c0: 6574 5f73 6574 5f65 6e63 5f70 6172 740a  et_set_enc_part.
│ │ │ │  000042d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000042e0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ -000042f0: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ -00004300: 7368 695f 7469 636b 6574 5f73 6574 5f65  shi_ticket_set_e
│ │ │ │ -00004310: 6e63 5f70 6172 7420 2853 6869 7368 6920  nc_part (Shishi 
│ │ │ │ -00004320: 2a20 4841 4e44 4c45 2c0a 2020 2020 2020  * HANDLE,.      
│ │ │ │ -00004330: 2020 2020 5368 6973 6869 5f61 736e 3120      Shishi_asn1 
│ │ │ │ -00004340: 5449 434b 4554 2c20 696e 7433 325f 7420  TICKET, int32_t 
│ │ │ │ -00004350: 4554 5950 452c 2075 696e 7433 325f 7420  ETYPE, uint32_t 
│ │ │ │ -00004360: 4b56 4e4f 2c0a 2020 2020 2020 2020 2020  KVNO,.          
│ │ │ │ -00004370: 636f 6e73 7420 6368 6172 202a 2042 5546  const char * BUF
│ │ │ │ -00004380: 2c20 7369 7a65 5f74 2042 5546 4c45 4e29  , size_t BUFLEN)
│ │ │ │ -00004390: 0a20 2020 2020 4841 4e44 4c45 3a20 7368  .     HANDLE: sh
│ │ │ │ -000043a0: 6973 6869 2068 616e 646c 6520 6173 2061  ishi handle as a
│ │ │ │ -000043b0: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ -000043c0: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ -000043d0: 0a20 2020 2020 5449 434b 4554 3a20 5469  .     TICKET: Ti
│ │ │ │ -000043e0: 636b 6574 2074 6f20 6164 6420 656e 632d  cket to add enc-
│ │ │ │ -000043f0: 7061 7274 2066 6965 6c64 2074 6f2e 0a20  part field to.. 
│ │ │ │ -00004400: 2020 2020 4554 5950 453a 2065 6e63 7279      ETYPE: encry
│ │ │ │ -00004410: 7074 696f 6e20 7479 7065 2075 7365 6420  ption type used 
│ │ │ │ -00004420: 746f 2065 6e63 7279 7074 2065 6e63 2d70  to encrypt enc-p
│ │ │ │ -00004430: 6172 742e 0a20 2020 2020 4b56 4e4f 3a20  art..     KVNO: 
│ │ │ │ -00004440: 6b65 7920 7665 7273 696f 6e20 6e75 6d62  key version numb
│ │ │ │ -00004450: 6572 2e0a 2020 2020 2042 5546 3a20 696e  er..     BUF: in
│ │ │ │ -00004460: 7075 7420 6172 7261 7920 7769 7468 2065  put array with e
│ │ │ │ -00004470: 6e63 7279 7074 6564 2065 6e63 2d70 6172  ncrypted enc-par
│ │ │ │ -00004480: 742e 0a20 2020 2020 4255 464c 454e 3a20  t..     BUFLEN: 
│ │ │ │ -00004490: 7369 7a65 206f 6620 696e 7075 7420 6172  size of input ar
│ │ │ │ -000044a0: 7261 7920 7769 7468 2065 6e63 7279 7074  ray with encrypt
│ │ │ │ -000044b0: 6564 2065 6e63 2d70 6172 742e 0a0a 2020  ed enc-part...  
│ │ │ │ -000044c0: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ -000044d0: 2a20 5365 7420 7468 6520 656e 6372 7970  * Set the encryp
│ │ │ │ -000044e0: 7465 6420 656e 632d 7061 7274 2066 6965  ted enc-part fie
│ │ │ │ -000044f0: 6c64 2069 6e20 7468 6520 5469 636b 6574  ld in the Ticket
│ │ │ │ -00004500: 2e20 2054 6865 0a20 2020 2020 656e 6372  .  The.     encr
│ │ │ │ -00004510: 7970 7465 6420 6461 7461 2069 7320 7573  ypted data is us
│ │ │ │ -00004520: 7561 6c6c 7920 6372 6561 7465 6420 6279  ually created by
│ │ │ │ -00004530: 2063 616c 6c69 6e67 20e2 8098 7368 6973   calling ...shis
│ │ │ │ -00004540: 6869 5f65 6e63 7279 7074 2829 e280 9920  hi_encrypt()... 
│ │ │ │ -00004550: 6f6e 0a20 2020 2020 7468 6520 4445 5220  on.     the DER 
│ │ │ │ -00004560: 656e 636f 6465 6420 656e 632d 7061 7274  encoded enc-part
│ │ │ │ -00004570: 2e20 2054 6f20 7361 7665 2074 696d 652c  .  To save time,
│ │ │ │ -00004580: 2079 6f75 206d 6179 2077 616e 7420 746f   you may want to
│ │ │ │ -00004590: 2075 7365 0a20 2020 2020 e280 9873 6869   use.     ...shi
│ │ │ │ -000045a0: 7368 695f 7469 636b 6574 5f61 6464 5f65  shi_ticket_add_e
│ │ │ │ -000045b0: 6e63 5f70 6172 7428 29e2 8099 2069 6e73  nc_part()... ins
│ │ │ │ -000045c0: 7465 6164 2c20 7768 6963 6820 6361 6c63  tead, which calc
│ │ │ │ -000045d0: 756c 6174 6573 2074 6865 0a20 2020 2020  ulates the.     
│ │ │ │ -000045e0: 656e 6372 7970 7465 6420 6461 7461 2061  encrypted data a
│ │ │ │ -000045f0: 6e64 2063 616c 6c73 2074 6869 7320 6675  nd calls this fu
│ │ │ │ -00004600: 6e63 7469 6f6e 2069 6e20 6f6e 6520 7374  nction in one st
│ │ │ │ -00004610: 6570 2e0a 0a20 2020 2020 2a52 6574 7572  ep...     *Retur
│ │ │ │ -00004620: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ -00004630: 7320 5348 4953 4849 5f4f 4b20 6966 6620  s SHISHI_OK iff 
│ │ │ │ -00004640: 7375 6363 6573 7366 756c 2e0a 0a73 6869  successful...shi
│ │ │ │ -00004650: 7368 695f 7469 636b 6574 5f61 6464 5f65  shi_ticket_add_e
│ │ │ │ -00004660: 6e63 5f70 6172 740a 2d2d 2d2d 2d2d 2d2d  nc_part.--------
│ │ │ │ +000042e0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +000042f0: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ +00004300: 6973 6869 5f74 6963 6b65 745f 7365 745f  ishi_ticket_set_
│ │ │ │ +00004310: 656e 635f 7061 7274 2028 5368 6973 6869  enc_part (Shishi
│ │ │ │ +00004320: 202a 2048 414e 444c 452c 0a20 2020 2020   * HANDLE,.     
│ │ │ │ +00004330: 2020 2020 2053 6869 7368 695f 6173 6e31       Shishi_asn1
│ │ │ │ +00004340: 2054 4943 4b45 542c 2069 6e74 3332 5f74   TICKET, int32_t
│ │ │ │ +00004350: 2045 5459 5045 2c20 7569 6e74 3332 5f74   ETYPE, uint32_t
│ │ │ │ +00004360: 204b 564e 4f2c 0a20 2020 2020 2020 2020   KVNO,.         
│ │ │ │ +00004370: 2063 6f6e 7374 2063 6861 7220 2a20 4255   const char * BU
│ │ │ │ +00004380: 462c 2073 697a 655f 7420 4255 464c 454e  F, size_t BUFLEN
│ │ │ │ +00004390: 290a 2020 2020 2048 414e 444c 453a 2073  ).     HANDLE: s
│ │ │ │ +000043a0: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ +000043b0: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ +000043c0: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ +000043d0: 2e0a 2020 2020 2054 4943 4b45 543a 2054  ..     TICKET: T
│ │ │ │ +000043e0: 6963 6b65 7420 746f 2061 6464 2065 6e63  icket to add enc
│ │ │ │ +000043f0: 2d70 6172 7420 6669 656c 6420 746f 2e0a  -part field to..
│ │ │ │ +00004400: 2020 2020 2045 5459 5045 3a20 656e 6372       ETYPE: encr
│ │ │ │ +00004410: 7970 7469 6f6e 2074 7970 6520 7573 6564  yption type used
│ │ │ │ +00004420: 2074 6f20 656e 6372 7970 7420 656e 632d   to encrypt enc-
│ │ │ │ +00004430: 7061 7274 2e0a 2020 2020 204b 564e 4f3a  part..     KVNO:
│ │ │ │ +00004440: 206b 6579 2076 6572 7369 6f6e 206e 756d   key version num
│ │ │ │ +00004450: 6265 722e 0a20 2020 2020 4255 463a 2069  ber..     BUF: i
│ │ │ │ +00004460: 6e70 7574 2061 7272 6179 2077 6974 6820  nput array with 
│ │ │ │ +00004470: 656e 6372 7970 7465 6420 656e 632d 7061  encrypted enc-pa
│ │ │ │ +00004480: 7274 2e0a 2020 2020 2042 5546 4c45 4e3a  rt..     BUFLEN:
│ │ │ │ +00004490: 2073 697a 6520 6f66 2069 6e70 7574 2061   size of input a
│ │ │ │ +000044a0: 7272 6179 2077 6974 6820 656e 6372 7970  rray with encryp
│ │ │ │ +000044b0: 7465 6420 656e 632d 7061 7274 2e0a 0a20  ted enc-part... 
│ │ │ │ +000044c0: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ +000044d0: 3a2a 2053 6574 2074 6865 2065 6e63 7279  :* Set the encry
│ │ │ │ +000044e0: 7074 6564 2065 6e63 2d70 6172 7420 6669  pted enc-part fi
│ │ │ │ +000044f0: 656c 6420 696e 2074 6865 2054 6963 6b65  eld in the Ticke
│ │ │ │ +00004500: 742e 2020 5468 650a 2020 2020 2065 6e63  t.  The.     enc
│ │ │ │ +00004510: 7279 7074 6564 2064 6174 6120 6973 2075  rypted data is u
│ │ │ │ +00004520: 7375 616c 6c79 2063 7265 6174 6564 2062  sually created b
│ │ │ │ +00004530: 7920 6361 6c6c 696e 6720 e280 9873 6869  y calling ...shi
│ │ │ │ +00004540: 7368 695f 656e 6372 7970 7428 29e2 8099  shi_encrypt()...
│ │ │ │ +00004550: 206f 6e0a 2020 2020 2074 6865 2044 4552   on.     the DER
│ │ │ │ +00004560: 2065 6e63 6f64 6564 2065 6e63 2d70 6172   encoded enc-par
│ │ │ │ +00004570: 742e 2020 546f 2073 6176 6520 7469 6d65  t.  To save time
│ │ │ │ +00004580: 2c20 796f 7520 6d61 7920 7761 6e74 2074  , you may want t
│ │ │ │ +00004590: 6f20 7573 650a 2020 2020 20e2 8098 7368  o use.     ...sh
│ │ │ │ +000045a0: 6973 6869 5f74 6963 6b65 745f 6164 645f  ishi_ticket_add_
│ │ │ │ +000045b0: 656e 635f 7061 7274 2829 e280 9920 696e  enc_part()... in
│ │ │ │ +000045c0: 7374 6561 642c 2077 6869 6368 2063 616c  stead, which cal
│ │ │ │ +000045d0: 6375 6c61 7465 7320 7468 650a 2020 2020  culates the.    
│ │ │ │ +000045e0: 2065 6e63 7279 7074 6564 2064 6174 6120   encrypted data 
│ │ │ │ +000045f0: 616e 6420 6361 6c6c 7320 7468 6973 2066  and calls this f
│ │ │ │ +00004600: 756e 6374 696f 6e20 696e 206f 6e65 2073  unction in one s
│ │ │ │ +00004610: 7465 702e 0a0a 2020 2020 202a 5265 7475  tep...     *Retu
│ │ │ │ +00004620: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ +00004630: 6e73 2053 4849 5348 495f 4f4b 2069 6666  ns SHISHI_OK iff
│ │ │ │ +00004640: 2073 7563 6365 7373 6675 6c2e 0a0a 7368   successful...sh
│ │ │ │ +00004650: 6973 6869 5f74 6963 6b65 745f 6164 645f  ishi_ticket_add_
│ │ │ │ +00004660: 656e 635f 7061 7274 0a2d 2d2d 2d2d 2d2d  enc_part.-------
│ │ │ │  00004670: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00004680: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ -00004690: 3a20 696e 7420 7368 6973 6869 5f74 6963  : int shishi_tic
│ │ │ │ -000046a0: 6b65 745f 6164 645f 656e 635f 7061 7274  ket_add_enc_part
│ │ │ │ -000046b0: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ -000046c0: 452c 0a20 2020 2020 2020 2020 2053 6869  E,.          Shi
│ │ │ │ -000046d0: 7368 695f 6173 6e31 2054 4943 4b45 542c  shi_asn1 TICKET,
│ │ │ │ -000046e0: 2053 6869 7368 695f 6b65 7920 2a20 4b45   Shishi_key * KE
│ │ │ │ -000046f0: 592c 0a20 2020 2020 2020 2020 2053 6869  Y,.          Shi
│ │ │ │ -00004700: 7368 695f 6173 6e31 2045 4e43 5449 434b  shi_asn1 ENCTICK
│ │ │ │ -00004710: 4554 5041 5254 290a 2020 2020 2048 414e  ETPART).     HAN
│ │ │ │ -00004720: 444c 453a 2073 6869 7368 6920 6861 6e64  DLE: shishi hand
│ │ │ │ -00004730: 6c65 2061 7320 616c 6c6f 6361 7465 6420  le as allocated 
│ │ │ │ -00004740: 6279 20e2 8098 7368 6973 6869 5f69 6e69  by ...shishi_ini
│ │ │ │ -00004750: 7428 29e2 8099 2e0a 2020 2020 2054 4943  t().....     TIC
│ │ │ │ -00004760: 4b45 543a 2054 6963 6b65 7420 746f 2061  KET: Ticket to a
│ │ │ │ -00004770: 6464 2065 6e63 2d70 6172 7420 6669 656c  dd enc-part fiel
│ │ │ │ -00004780: 6420 746f 2e0a 2020 2020 204b 4559 3a20  d to..     KEY: 
│ │ │ │ -00004790: 6b65 7920 7573 6564 2074 6f20 656e 6372  key used to encr
│ │ │ │ -000047a0: 7970 7420 656e 632d 7061 7274 2e0a 2020  ypt enc-part..  
│ │ │ │ -000047b0: 2020 2045 4e43 5449 434b 4554 5041 5254     ENCTICKETPART
│ │ │ │ -000047c0: 3a20 456e 6354 6963 6b65 7450 6172 7420  : EncTicketPart 
│ │ │ │ -000047d0: 746f 2061 6464 2e0a 0a20 2020 2020 2a44  to add...     *D
│ │ │ │ -000047e0: 6573 6372 6970 7469 6f6e 3a2a 2045 6e63  escription:* Enc
│ │ │ │ -000047f0: 7279 7074 7320 4445 5220 656e 636f 6465  rypts DER encode
│ │ │ │ -00004800: 6420 456e 6354 6963 6b65 7450 6172 7420  d EncTicketPart 
│ │ │ │ -00004810: 7573 696e 6720 6b65 7920 616e 640a 2020  using key and.  
│ │ │ │ -00004820: 2020 2073 746f 7265 7320 6974 2069 6e20     stores it in 
│ │ │ │ -00004830: 7468 6520 5469 636b 6574 2e0a 0a20 2020  the Ticket...   
│ │ │ │ -00004840: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ -00004850: 2a20 5265 7475 726e 7320 5348 4953 4849  * Returns SHISHI
│ │ │ │ -00004860: 5f4f 4b20 6966 6620 7375 6363 6573 7366  _OK iff successf
│ │ │ │ -00004870: 756c 2e0a 0a73 6869 7368 695f 656e 6374  ul...shishi_enct
│ │ │ │ -00004880: 6963 6b65 7470 6172 745f 6765 745f 6b65  icketpart_get_ke
│ │ │ │ -00004890: 790a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  y.--------------
│ │ │ │ -000048a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -000048b0: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ -000048c0: 7420 7368 6973 6869 5f65 6e63 7469 636b  t shishi_enctick
│ │ │ │ -000048d0: 6574 7061 7274 5f67 6574 5f6b 6579 2028  etpart_get_key (
│ │ │ │ -000048e0: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ -000048f0: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ -00004900: 695f 6173 6e31 2045 4e43 5449 434b 4554  i_asn1 ENCTICKET
│ │ │ │ -00004910: 5041 5254 2c20 5368 6973 6869 5f6b 6579  PART, Shishi_key
│ │ │ │ -00004920: 202a 2a20 4b45 5929 0a20 2020 2020 4841   ** KEY).     HA
│ │ │ │ -00004930: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ -00004940: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ -00004950: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ -00004960: 6974 2829 e280 992e 0a20 2020 2020 454e  it().....     EN
│ │ │ │ -00004970: 4354 4943 4b45 5450 4152 543a 2069 6e70  CTICKETPART: inp
│ │ │ │ -00004980: 7574 2045 6e63 5469 636b 6574 5061 7274  ut EncTicketPart
│ │ │ │ -00004990: 2076 6172 6961 626c 652e 0a20 2020 2020   variable..     
│ │ │ │ -000049a0: 4b45 593a 206e 6577 6c79 2061 6c6c 6f63  KEY: newly alloc
│ │ │ │ -000049b0: 6174 6564 206b 6579 2e0a 0a20 2020 2020  ated key...     
│ │ │ │ -000049c0: 2a44 6573 6372 6970 7469 6f6e 3a2a 2045  *Description:* E
│ │ │ │ -000049d0: 7874 7261 6374 2074 6865 2073 6573 7369  xtract the sessi
│ │ │ │ -000049e0: 6f6e 206b 6579 2069 6e20 7468 6520 5469  on key in the Ti
│ │ │ │ -000049f0: 636b 6574 2e0a 0a20 2020 2020 2a52 6574  cket...     *Ret
│ │ │ │ -00004a00: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ -00004a10: 726e 7320 e280 9853 4849 5348 495f 4f4b  rns ...SHISHI_OK
│ │ │ │ -00004a20: e280 9920 6966 6620 7375 6363 6573 7366  ... iff successf
│ │ │ │ -00004a30: 756c 2e0a 0a73 6869 7368 695f 656e 6374  ul...shishi_enct
│ │ │ │ -00004a40: 6963 6b65 7470 6172 745f 6b65 795f 7365  icketpart_key_se
│ │ │ │ -00004a50: 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  t.--------------
│ │ │ │ -00004a60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -00004a70: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ -00004a80: 7420 7368 6973 6869 5f65 6e63 7469 636b  t shishi_enctick
│ │ │ │ -00004a90: 6574 7061 7274 5f6b 6579 5f73 6574 2028  etpart_key_set (
│ │ │ │ -00004aa0: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ -00004ab0: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ -00004ac0: 695f 6173 6e31 2045 4e43 5449 434b 4554  i_asn1 ENCTICKET
│ │ │ │ -00004ad0: 5041 5254 2c20 5368 6973 6869 5f6b 6579  PART, Shishi_key
│ │ │ │ -00004ae0: 202a 204b 4559 290a 2020 2020 2048 414e   * KEY).     HAN
│ │ │ │ -00004af0: 444c 453a 2073 6869 7368 6920 6861 6e64  DLE: shishi hand
│ │ │ │ -00004b00: 6c65 2061 7320 616c 6c6f 6361 7465 6420  le as allocated 
│ │ │ │ -00004b10: 6279 20e2 8098 7368 6973 6869 5f69 6e69  by ...shishi_ini
│ │ │ │ -00004b20: 7428 29e2 8099 2e0a 2020 2020 2045 4e43  t().....     ENC
│ │ │ │ -00004b30: 5449 434b 4554 5041 5254 3a20 696e 7075  TICKETPART: inpu
│ │ │ │ -00004b40: 7420 456e 6354 6963 6b65 7450 6172 7420  t EncTicketPart 
│ │ │ │ -00004b50: 7661 7269 6162 6c65 2e0a 2020 2020 204b  variable..     K
│ │ │ │ -00004b60: 4559 3a20 6b65 7920 6861 6e64 6c65 2077  EY: key handle w
│ │ │ │ -00004b70: 6974 6820 696e 666f 726d 6174 696f 6e20  ith information 
│ │ │ │ -00004b80: 746f 2073 746f 7265 2069 6e20 656e 6374  to store in enct
│ │ │ │ -00004b90: 6963 6b65 7470 6172 742e 0a0a 2020 2020  icketpart...    
│ │ │ │ -00004ba0: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ -00004bb0: 5365 7420 7468 6520 456e 6354 6963 6b65  Set the EncTicke
│ │ │ │ -00004bc0: 7450 6172 742e 6b65 7920 6669 656c 6420  tPart.key field 
│ │ │ │ -00004bd0: 746f 206b 6579 2074 7970 6520 616e 640a  to key type and.
│ │ │ │ -00004be0: 2020 2020 2076 616c 7565 206f 6620 7375       value of su
│ │ │ │ -00004bf0: 7070 6c69 6564 206b 6579 2e0a 0a20 2020  pplied key...   
│ │ │ │ -00004c00: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ -00004c10: 2a20 5265 7475 726e 7320 e280 9853 4849  * Returns ...SHI
│ │ │ │ -00004c20: 5348 495f 4f4b e280 9920 6966 6620 7375  SHI_OK... iff su
│ │ │ │ -00004c30: 6363 6573 7366 756c 2e0a 0a73 6869 7368  ccessful...shish
│ │ │ │ -00004c40: 695f 656e 6374 6963 6b65 7470 6172 745f  i_encticketpart_
│ │ │ │ -00004c50: 666c 6167 735f 7365 740a 2d2d 2d2d 2d2d  flags_set.------
│ │ │ │ +00004680: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ +00004690: 6e3a 2069 6e74 2073 6869 7368 695f 7469  n: int shishi_ti
│ │ │ │ +000046a0: 636b 6574 5f61 6464 5f65 6e63 5f70 6172  cket_add_enc_par
│ │ │ │ +000046b0: 7420 2853 6869 7368 6920 2a20 4841 4e44  t (Shishi * HAND
│ │ │ │ +000046c0: 4c45 2c0a 2020 2020 2020 2020 2020 5368  LE,.          Sh
│ │ │ │ +000046d0: 6973 6869 5f61 736e 3120 5449 434b 4554  ishi_asn1 TICKET
│ │ │ │ +000046e0: 2c20 5368 6973 6869 5f6b 6579 202a 204b  , Shishi_key * K
│ │ │ │ +000046f0: 4559 2c0a 2020 2020 2020 2020 2020 5368  EY,.          Sh
│ │ │ │ +00004700: 6973 6869 5f61 736e 3120 454e 4354 4943  ishi_asn1 ENCTIC
│ │ │ │ +00004710: 4b45 5450 4152 5429 0a20 2020 2020 4841  KETPART).     HA
│ │ │ │ +00004720: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ +00004730: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ +00004740: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ +00004750: 6974 2829 e280 992e 0a20 2020 2020 5449  it().....     TI
│ │ │ │ +00004760: 434b 4554 3a20 5469 636b 6574 2074 6f20  CKET: Ticket to 
│ │ │ │ +00004770: 6164 6420 656e 632d 7061 7274 2066 6965  add enc-part fie
│ │ │ │ +00004780: 6c64 2074 6f2e 0a20 2020 2020 4b45 593a  ld to..     KEY:
│ │ │ │ +00004790: 206b 6579 2075 7365 6420 746f 2065 6e63   key used to enc
│ │ │ │ +000047a0: 7279 7074 2065 6e63 2d70 6172 742e 0a20  rypt enc-part.. 
│ │ │ │ +000047b0: 2020 2020 454e 4354 4943 4b45 5450 4152      ENCTICKETPAR
│ │ │ │ +000047c0: 543a 2045 6e63 5469 636b 6574 5061 7274  T: EncTicketPart
│ │ │ │ +000047d0: 2074 6f20 6164 642e 0a0a 2020 2020 202a   to add...     *
│ │ │ │ +000047e0: 4465 7363 7269 7074 696f 6e3a 2a20 456e  Description:* En
│ │ │ │ +000047f0: 6372 7970 7473 2044 4552 2065 6e63 6f64  crypts DER encod
│ │ │ │ +00004800: 6564 2045 6e63 5469 636b 6574 5061 7274  ed EncTicketPart
│ │ │ │ +00004810: 2075 7369 6e67 206b 6579 2061 6e64 0a20   using key and. 
│ │ │ │ +00004820: 2020 2020 7374 6f72 6573 2069 7420 696e      stores it in
│ │ │ │ +00004830: 2074 6865 2054 6963 6b65 742e 0a0a 2020   the Ticket...  
│ │ │ │ +00004840: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ +00004850: 3a2a 2052 6574 7572 6e73 2053 4849 5348  :* Returns SHISH
│ │ │ │ +00004860: 495f 4f4b 2069 6666 2073 7563 6365 7373  I_OK iff success
│ │ │ │ +00004870: 6675 6c2e 0a0a 7368 6973 6869 5f65 6e63  ful...shishi_enc
│ │ │ │ +00004880: 7469 636b 6574 7061 7274 5f67 6574 5f6b  ticketpart_get_k
│ │ │ │ +00004890: 6579 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ey.-------------
│ │ │ │ +000048a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +000048b0: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ +000048c0: 6e74 2073 6869 7368 695f 656e 6374 6963  nt shishi_enctic
│ │ │ │ +000048d0: 6b65 7470 6172 745f 6765 745f 6b65 7920  ketpart_get_key 
│ │ │ │ +000048e0: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ +000048f0: 2c0a 2020 2020 2020 2020 2020 5368 6973  ,.          Shis
│ │ │ │ +00004900: 6869 5f61 736e 3120 454e 4354 4943 4b45  hi_asn1 ENCTICKE
│ │ │ │ +00004910: 5450 4152 542c 2053 6869 7368 695f 6b65  TPART, Shishi_ke
│ │ │ │ +00004920: 7920 2a2a 204b 4559 290a 2020 2020 2048  y ** KEY).     H
│ │ │ │ +00004930: 414e 444c 453a 2073 6869 7368 6920 6861  ANDLE: shishi ha
│ │ │ │ +00004940: 6e64 6c65 2061 7320 616c 6c6f 6361 7465  ndle as allocate
│ │ │ │ +00004950: 6420 6279 20e2 8098 7368 6973 6869 5f69  d by ...shishi_i
│ │ │ │ +00004960: 6e69 7428 29e2 8099 2e0a 2020 2020 2045  nit().....     E
│ │ │ │ +00004970: 4e43 5449 434b 4554 5041 5254 3a20 696e  NCTICKETPART: in
│ │ │ │ +00004980: 7075 7420 456e 6354 6963 6b65 7450 6172  put EncTicketPar
│ │ │ │ +00004990: 7420 7661 7269 6162 6c65 2e0a 2020 2020  t variable..    
│ │ │ │ +000049a0: 204b 4559 3a20 6e65 776c 7920 616c 6c6f   KEY: newly allo
│ │ │ │ +000049b0: 6361 7465 6420 6b65 792e 0a0a 2020 2020  cated key...    
│ │ │ │ +000049c0: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ +000049d0: 4578 7472 6163 7420 7468 6520 7365 7373  Extract the sess
│ │ │ │ +000049e0: 696f 6e20 6b65 7920 696e 2074 6865 2054  ion key in the T
│ │ │ │ +000049f0: 6963 6b65 742e 0a0a 2020 2020 202a 5265  icket...     *Re
│ │ │ │ +00004a00: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ +00004a10: 7572 6e73 20e2 8098 5348 4953 4849 5f4f  urns ...SHISHI_O
│ │ │ │ +00004a20: 4be2 8099 2069 6666 2073 7563 6365 7373  K... iff success
│ │ │ │ +00004a30: 6675 6c2e 0a0a 7368 6973 6869 5f65 6e63  ful...shishi_enc
│ │ │ │ +00004a40: 7469 636b 6574 7061 7274 5f6b 6579 5f73  ticketpart_key_s
│ │ │ │ +00004a50: 6574 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  et.-------------
│ │ │ │ +00004a60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +00004a70: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ +00004a80: 6e74 2073 6869 7368 695f 656e 6374 6963  nt shishi_enctic
│ │ │ │ +00004a90: 6b65 7470 6172 745f 6b65 795f 7365 7420  ketpart_key_set 
│ │ │ │ +00004aa0: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ +00004ab0: 2c0a 2020 2020 2020 2020 2020 5368 6973  ,.          Shis
│ │ │ │ +00004ac0: 6869 5f61 736e 3120 454e 4354 4943 4b45  hi_asn1 ENCTICKE
│ │ │ │ +00004ad0: 5450 4152 542c 2053 6869 7368 695f 6b65  TPART, Shishi_ke
│ │ │ │ +00004ae0: 7920 2a20 4b45 5929 0a20 2020 2020 4841  y * KEY).     HA
│ │ │ │ +00004af0: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ +00004b00: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ +00004b10: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ +00004b20: 6974 2829 e280 992e 0a20 2020 2020 454e  it().....     EN
│ │ │ │ +00004b30: 4354 4943 4b45 5450 4152 543a 2069 6e70  CTICKETPART: inp
│ │ │ │ +00004b40: 7574 2045 6e63 5469 636b 6574 5061 7274  ut EncTicketPart
│ │ │ │ +00004b50: 2076 6172 6961 626c 652e 0a20 2020 2020   variable..     
│ │ │ │ +00004b60: 4b45 593a 206b 6579 2068 616e 646c 6520  KEY: key handle 
│ │ │ │ +00004b70: 7769 7468 2069 6e66 6f72 6d61 7469 6f6e  with information
│ │ │ │ +00004b80: 2074 6f20 7374 6f72 6520 696e 2065 6e63   to store in enc
│ │ │ │ +00004b90: 7469 636b 6574 7061 7274 2e0a 0a20 2020  ticketpart...   
│ │ │ │ +00004ba0: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ +00004bb0: 2053 6574 2074 6865 2045 6e63 5469 636b   Set the EncTick
│ │ │ │ +00004bc0: 6574 5061 7274 2e6b 6579 2066 6965 6c64  etPart.key field
│ │ │ │ +00004bd0: 2074 6f20 6b65 7920 7479 7065 2061 6e64   to key type and
│ │ │ │ +00004be0: 0a20 2020 2020 7661 6c75 6520 6f66 2073  .     value of s
│ │ │ │ +00004bf0: 7570 706c 6965 6420 6b65 792e 0a0a 2020  upplied key...  
│ │ │ │ +00004c00: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ +00004c10: 3a2a 2052 6574 7572 6e73 20e2 8098 5348  :* Returns ...SH
│ │ │ │ +00004c20: 4953 4849 5f4f 4be2 8099 2069 6666 2073  ISHI_OK... iff s
│ │ │ │ +00004c30: 7563 6365 7373 6675 6c2e 0a0a 7368 6973  uccessful...shis
│ │ │ │ +00004c40: 6869 5f65 6e63 7469 636b 6574 7061 7274  hi_encticketpart
│ │ │ │ +00004c50: 5f66 6c61 6773 5f73 6574 0a2d 2d2d 2d2d  _flags_set.-----
│ │ │ │  00004c60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00004c70: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -00004c80: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ -00004c90: 6869 5f65 6e63 7469 636b 6574 7061 7274  hi_encticketpart
│ │ │ │ -00004ca0: 5f66 6c61 6773 5f73 6574 2028 5368 6973  _flags_set (Shis
│ │ │ │ -00004cb0: 6869 202a 2048 414e 444c 452c 0a20 2020  hi * HANDLE,.   
│ │ │ │ -00004cc0: 2020 2020 2020 2053 6869 7368 695f 6173         Shishi_as
│ │ │ │ -00004cd0: 6e31 2045 4e43 5449 434b 4554 5041 5254  n1 ENCTICKETPART
│ │ │ │ -00004ce0: 2c20 696e 7420 464c 4147 5329 0a20 2020  , int FLAGS).   
│ │ │ │ -00004cf0: 2020 4841 4e44 4c45 3a20 7368 6973 6869    HANDLE: shishi
│ │ │ │ -00004d00: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ -00004d10: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ -00004d20: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ -00004d30: 2020 454e 4354 4943 4b45 5450 4152 543a    ENCTICKETPART:
│ │ │ │ -00004d40: 2069 6e70 7574 2045 6e63 5469 636b 6574   input EncTicket
│ │ │ │ -00004d50: 5061 7274 2076 6172 6961 626c 652e 0a20  Part variable.. 
│ │ │ │ -00004d60: 2020 2020 464c 4147 533a 2066 6c61 6773      FLAGS: flags
│ │ │ │ -00004d70: 2074 6f20 7365 7420 696e 2065 6e63 7469   to set in encti
│ │ │ │ -00004d80: 636b 6574 7061 7274 2e0a 0a20 2020 2020  cketpart...     
│ │ │ │ -00004d90: 2a44 6573 6372 6970 7469 6f6e 3a2a 2053  *Description:* S
│ │ │ │ -00004da0: 6574 2074 6865 2045 6e63 5469 636b 6574  et the EncTicket
│ │ │ │ -00004db0: 5061 7274 2e66 6c61 6773 2074 6f20 7375  Part.flags to su
│ │ │ │ -00004dc0: 7070 6c69 6564 2076 616c 7565 2e0a 0a20  pplied value... 
│ │ │ │ -00004dd0: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ -00004de0: 653a 2a20 5265 7475 726e 7320 e280 9853  e:* Returns ...S
│ │ │ │ -00004df0: 4849 5348 495f 4f4b e280 9920 6966 6620  HISHI_OK... iff 
│ │ │ │ -00004e00: 7375 6363 6573 7366 756c 2e0a 0a73 6869  successful...shi
│ │ │ │ -00004e10: 7368 695f 656e 6374 6963 6b65 7470 6172  shi_encticketpar
│ │ │ │ -00004e20: 745f 6372 6561 6c6d 5f73 6574 0a2d 2d2d  t_crealm_set.---
│ │ │ │ +00004c70: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +00004c80: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ +00004c90: 7368 695f 656e 6374 6963 6b65 7470 6172  shi_encticketpar
│ │ │ │ +00004ca0: 745f 666c 6167 735f 7365 7420 2853 6869  t_flags_set (Shi
│ │ │ │ +00004cb0: 7368 6920 2a20 4841 4e44 4c45 2c0a 2020  shi * HANDLE,.  
│ │ │ │ +00004cc0: 2020 2020 2020 2020 5368 6973 6869 5f61          Shishi_a
│ │ │ │ +00004cd0: 736e 3120 454e 4354 4943 4b45 5450 4152  sn1 ENCTICKETPAR
│ │ │ │ +00004ce0: 542c 2069 6e74 2046 4c41 4753 290a 2020  T, int FLAGS).  
│ │ │ │ +00004cf0: 2020 2048 414e 444c 453a 2073 6869 7368     HANDLE: shish
│ │ │ │ +00004d00: 6920 6861 6e64 6c65 2061 7320 616c 6c6f  i handle as allo
│ │ │ │ +00004d10: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ +00004d20: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ +00004d30: 2020 2045 4e43 5449 434b 4554 5041 5254     ENCTICKETPART
│ │ │ │ +00004d40: 3a20 696e 7075 7420 456e 6354 6963 6b65  : input EncTicke
│ │ │ │ +00004d50: 7450 6172 7420 7661 7269 6162 6c65 2e0a  tPart variable..
│ │ │ │ +00004d60: 2020 2020 2046 4c41 4753 3a20 666c 6167       FLAGS: flag
│ │ │ │ +00004d70: 7320 746f 2073 6574 2069 6e20 656e 6374  s to set in enct
│ │ │ │ +00004d80: 6963 6b65 7470 6172 742e 0a0a 2020 2020  icketpart...    
│ │ │ │ +00004d90: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ +00004da0: 5365 7420 7468 6520 456e 6354 6963 6b65  Set the EncTicke
│ │ │ │ +00004db0: 7450 6172 742e 666c 6167 7320 746f 2073  tPart.flags to s
│ │ │ │ +00004dc0: 7570 706c 6965 6420 7661 6c75 652e 0a0a  upplied value...
│ │ │ │ +00004dd0: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ +00004de0: 7565 3a2a 2052 6574 7572 6e73 20e2 8098  ue:* Returns ...
│ │ │ │ +00004df0: 5348 4953 4849 5f4f 4be2 8099 2069 6666  SHISHI_OK... iff
│ │ │ │ +00004e00: 2073 7563 6365 7373 6675 6c2e 0a0a 7368   successful...sh
│ │ │ │ +00004e10: 6973 6869 5f65 6e63 7469 636b 6574 7061  ishi_encticketpa
│ │ │ │ +00004e20: 7274 5f63 7265 616c 6d5f 7365 740a 2d2d  rt_crealm_set.--
│ │ │ │  00004e30: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00004e40: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ -00004e50: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ -00004e60: 7368 6973 6869 5f65 6e63 7469 636b 6574  shishi_encticket
│ │ │ │ -00004e70: 7061 7274 5f63 7265 616c 6d5f 7365 7420  part_crealm_set 
│ │ │ │ -00004e80: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ -00004e90: 2c0a 2020 2020 2020 2020 2020 5368 6973  ,.          Shis
│ │ │ │ -00004ea0: 6869 5f61 736e 3120 454e 4354 4943 4b45  hi_asn1 ENCTICKE
│ │ │ │ -00004eb0: 5450 4152 542c 2063 6f6e 7374 2063 6861  TPART, const cha
│ │ │ │ -00004ec0: 7220 2a20 5245 414c 4d29 0a20 2020 2020  r * REALM).     
│ │ │ │ -00004ed0: 4841 4e44 4c45 3a20 7368 6973 6869 2068  HANDLE: shishi h
│ │ │ │ -00004ee0: 616e 646c 6520 6173 2061 6c6c 6f63 6174  andle as allocat
│ │ │ │ -00004ef0: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ -00004f00: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ -00004f10: 454e 4354 4943 4b45 5450 4152 543a 2069  ENCTICKETPART: i
│ │ │ │ -00004f20: 6e70 7574 2045 6e63 5469 636b 6574 5061  nput EncTicketPa
│ │ │ │ -00004f30: 7274 2076 6172 6961 626c 652e 0a20 2020  rt variable..   
│ │ │ │ -00004f40: 2020 5245 414c 4d3a 2069 6e70 7574 2061    REALM: input a
│ │ │ │ -00004f50: 7272 6179 2077 6974 6820 6e61 6d65 206f  rray with name o
│ │ │ │ -00004f60: 6620 7265 616c 6d2e 0a0a 2020 2020 202a  f realm...     *
│ │ │ │ -00004f70: 4465 7363 7269 7074 696f 6e3a 2a20 5365  Description:* Se
│ │ │ │ -00004f80: 7420 7468 6520 7265 616c 6d20 6669 656c  t the realm fiel
│ │ │ │ -00004f90: 6420 696e 2074 6865 204b 4443 2d52 4551  d in the KDC-REQ
│ │ │ │ -00004fa0: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ -00004fb0: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ -00004fc0: 5348 4953 4849 5f4f 4b20 6966 6620 7375  SHISHI_OK iff su
│ │ │ │ -00004fd0: 6363 6573 7366 756c 2e0a 0a73 6869 7368  ccessful...shish
│ │ │ │ -00004fe0: 695f 656e 6374 6963 6b65 7470 6172 745f  i_encticketpart_
│ │ │ │ -00004ff0: 636e 616d 655f 7365 740a 2d2d 2d2d 2d2d  cname_set.------
│ │ │ │ +00004e40: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ +00004e50: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ +00004e60: 2073 6869 7368 695f 656e 6374 6963 6b65   shishi_encticke
│ │ │ │ +00004e70: 7470 6172 745f 6372 6561 6c6d 5f73 6574  tpart_crealm_set
│ │ │ │ +00004e80: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ +00004e90: 452c 0a20 2020 2020 2020 2020 2053 6869  E,.          Shi
│ │ │ │ +00004ea0: 7368 695f 6173 6e31 2045 4e43 5449 434b  shi_asn1 ENCTICK
│ │ │ │ +00004eb0: 4554 5041 5254 2c20 636f 6e73 7420 6368  ETPART, const ch
│ │ │ │ +00004ec0: 6172 202a 2052 4541 4c4d 290a 2020 2020  ar * REALM).    
│ │ │ │ +00004ed0: 2048 414e 444c 453a 2073 6869 7368 6920   HANDLE: shishi 
│ │ │ │ +00004ee0: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ +00004ef0: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ +00004f00: 5f69 6e69 7428 29e2 8099 2e0a 2020 2020  _init().....    
│ │ │ │ +00004f10: 2045 4e43 5449 434b 4554 5041 5254 3a20   ENCTICKETPART: 
│ │ │ │ +00004f20: 696e 7075 7420 456e 6354 6963 6b65 7450  input EncTicketP
│ │ │ │ +00004f30: 6172 7420 7661 7269 6162 6c65 2e0a 2020  art variable..  
│ │ │ │ +00004f40: 2020 2052 4541 4c4d 3a20 696e 7075 7420     REALM: input 
│ │ │ │ +00004f50: 6172 7261 7920 7769 7468 206e 616d 6520  array with name 
│ │ │ │ +00004f60: 6f66 2072 6561 6c6d 2e0a 0a20 2020 2020  of realm...     
│ │ │ │ +00004f70: 2a44 6573 6372 6970 7469 6f6e 3a2a 2053  *Description:* S
│ │ │ │ +00004f80: 6574 2074 6865 2072 6561 6c6d 2066 6965  et the realm fie
│ │ │ │ +00004f90: 6c64 2069 6e20 7468 6520 4b44 432d 5245  ld in the KDC-RE
│ │ │ │ +00004fa0: 512e 0a0a 2020 2020 202a 5265 7475 726e  Q...     *Return
│ │ │ │ +00004fb0: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ +00004fc0: 2053 4849 5348 495f 4f4b 2069 6666 2073   SHISHI_OK iff s
│ │ │ │ +00004fd0: 7563 6365 7373 6675 6c2e 0a0a 7368 6973  uccessful...shis
│ │ │ │ +00004fe0: 6869 5f65 6e63 7469 636b 6574 7061 7274  hi_encticketpart
│ │ │ │ +00004ff0: 5f63 6e61 6d65 5f73 6574 0a2d 2d2d 2d2d  _cname_set.-----
│ │ │ │  00005000: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00005010: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -00005020: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ -00005030: 6869 5f65 6e63 7469 636b 6574 7061 7274  hi_encticketpart
│ │ │ │ -00005040: 5f63 6e61 6d65 5f73 6574 2028 5368 6973  _cname_set (Shis
│ │ │ │ -00005050: 6869 202a 2048 414e 444c 452c 0a20 2020  hi * HANDLE,.   
│ │ │ │ -00005060: 2020 2020 2020 2053 6869 7368 695f 6173         Shishi_as
│ │ │ │ -00005070: 6e31 2045 4e43 5449 434b 4554 5041 5254  n1 ENCTICKETPART
│ │ │ │ -00005080: 2c20 5368 6973 6869 5f6e 616d 655f 7479  , Shishi_name_ty
│ │ │ │ -00005090: 7065 204e 414d 455f 5459 5045 2c0a 2020  pe NAME_TYPE,.  
│ │ │ │ -000050a0: 2020 2020 2020 2020 636f 6e73 7420 6368          const ch
│ │ │ │ -000050b0: 6172 202a 2050 5249 4e43 4950 414c 290a  ar * PRINCIPAL).
│ │ │ │ -000050c0: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ -000050d0: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ -000050e0: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ -000050f0: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ -00005100: 2020 2020 2045 4e43 5449 434b 4554 5041       ENCTICKETPA
│ │ │ │ -00005110: 5254 3a20 696e 7075 7420 456e 6354 6963  RT: input EncTic
│ │ │ │ -00005120: 6b65 7450 6172 7420 7661 7269 6162 6c65  ketPart variable
│ │ │ │ -00005130: 2e0a 2020 2020 204e 414d 455f 5459 5045  ..     NAME_TYPE
│ │ │ │ -00005140: 3a20 7479 7065 206f 6620 7072 696e 6369  : type of princi
│ │ │ │ -00005150: 7069 616c 2c20 7365 6520 5368 6973 6869  pial, see Shishi
│ │ │ │ -00005160: 5f6e 616d 655f 7479 7065 2c20 7573 7561  _name_type, usua
│ │ │ │ -00005170: 6c6c 790a 2020 2020 2053 4849 5348 495f  lly.     SHISHI_
│ │ │ │ -00005180: 4e54 5f55 4e4b 4e4f 574e 2e0a 2020 2020  NT_UNKNOWN..    
│ │ │ │ -00005190: 2050 5249 4e43 4950 414c 3a20 696e 7075   PRINCIPAL: inpu
│ │ │ │ -000051a0: 7420 6172 7261 7920 7769 7468 2070 7269  t array with pri
│ │ │ │ -000051b0: 6e63 6970 616c 206e 616d 652e 0a0a 2020  ncipal name...  
│ │ │ │ -000051c0: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ -000051d0: 2a20 5365 7420 7468 6520 636c 6965 6e74  * Set the client
│ │ │ │ -000051e0: 206e 616d 6520 6669 656c 6420 696e 2074   name field in t
│ │ │ │ -000051f0: 6865 2045 6e63 5469 636b 6574 5061 7274  he EncTicketPart
│ │ │ │ -00005200: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ -00005210: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ -00005220: 5348 4953 4849 5f4f 4b20 6966 6620 7375  SHISHI_OK iff su
│ │ │ │ -00005230: 6363 6573 7366 756c 2e0a 0a73 6869 7368  ccessful...shish
│ │ │ │ -00005240: 695f 656e 6374 6963 6b65 7470 6172 745f  i_encticketpart_
│ │ │ │ -00005250: 7472 616e 7369 7465 645f 7365 740a 2d2d  transited_set.--
│ │ │ │ +00005010: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +00005020: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ +00005030: 7368 695f 656e 6374 6963 6b65 7470 6172  shi_encticketpar
│ │ │ │ +00005040: 745f 636e 616d 655f 7365 7420 2853 6869  t_cname_set (Shi
│ │ │ │ +00005050: 7368 6920 2a20 4841 4e44 4c45 2c0a 2020  shi * HANDLE,.  
│ │ │ │ +00005060: 2020 2020 2020 2020 5368 6973 6869 5f61          Shishi_a
│ │ │ │ +00005070: 736e 3120 454e 4354 4943 4b45 5450 4152  sn1 ENCTICKETPAR
│ │ │ │ +00005080: 542c 2053 6869 7368 695f 6e61 6d65 5f74  T, Shishi_name_t
│ │ │ │ +00005090: 7970 6520 4e41 4d45 5f54 5950 452c 0a20  ype NAME_TYPE,. 
│ │ │ │ +000050a0: 2020 2020 2020 2020 2063 6f6e 7374 2063           const c
│ │ │ │ +000050b0: 6861 7220 2a20 5052 494e 4349 5041 4c29  har * PRINCIPAL)
│ │ │ │ +000050c0: 0a20 2020 2020 4841 4e44 4c45 3a20 7368  .     HANDLE: sh
│ │ │ │ +000050d0: 6973 6869 2068 616e 646c 6520 6173 2061  ishi handle as a
│ │ │ │ +000050e0: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ +000050f0: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ +00005100: 0a20 2020 2020 454e 4354 4943 4b45 5450  .     ENCTICKETP
│ │ │ │ +00005110: 4152 543a 2069 6e70 7574 2045 6e63 5469  ART: input EncTi
│ │ │ │ +00005120: 636b 6574 5061 7274 2076 6172 6961 626c  cketPart variabl
│ │ │ │ +00005130: 652e 0a20 2020 2020 4e41 4d45 5f54 5950  e..     NAME_TYP
│ │ │ │ +00005140: 453a 2074 7970 6520 6f66 2070 7269 6e63  E: type of princ
│ │ │ │ +00005150: 6970 6961 6c2c 2073 6565 2053 6869 7368  ipial, see Shish
│ │ │ │ +00005160: 695f 6e61 6d65 5f74 7970 652c 2075 7375  i_name_type, usu
│ │ │ │ +00005170: 616c 6c79 0a20 2020 2020 5348 4953 4849  ally.     SHISHI
│ │ │ │ +00005180: 5f4e 545f 554e 4b4e 4f57 4e2e 0a20 2020  _NT_UNKNOWN..   
│ │ │ │ +00005190: 2020 5052 494e 4349 5041 4c3a 2069 6e70    PRINCIPAL: inp
│ │ │ │ +000051a0: 7574 2061 7272 6179 2077 6974 6820 7072  ut array with pr
│ │ │ │ +000051b0: 696e 6369 7061 6c20 6e61 6d65 2e0a 0a20  incipal name... 
│ │ │ │ +000051c0: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ +000051d0: 3a2a 2053 6574 2074 6865 2063 6c69 656e  :* Set the clien
│ │ │ │ +000051e0: 7420 6e61 6d65 2066 6965 6c64 2069 6e20  t name field in 
│ │ │ │ +000051f0: 7468 6520 456e 6354 6963 6b65 7450 6172  the EncTicketPar
│ │ │ │ +00005200: 742e 0a0a 2020 2020 202a 5265 7475 726e  t...     *Return
│ │ │ │ +00005210: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ +00005220: 2053 4849 5348 495f 4f4b 2069 6666 2073   SHISHI_OK iff s
│ │ │ │ +00005230: 7563 6365 7373 6675 6c2e 0a0a 7368 6973  uccessful...shis
│ │ │ │ +00005240: 6869 5f65 6e63 7469 636b 6574 7061 7274  hi_encticketpart
│ │ │ │ +00005250: 5f74 7261 6e73 6974 6564 5f73 6574 0a2d  _transited_set.-
│ │ │ │  00005260: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │  00005270: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00005280: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ -00005290: 696e 7420 7368 6973 6869 5f65 6e63 7469  int shishi_encti
│ │ │ │ -000052a0: 636b 6574 7061 7274 5f74 7261 6e73 6974  cketpart_transit
│ │ │ │ -000052b0: 6564 5f73 6574 2028 5368 6973 6869 202a  ed_set (Shishi *
│ │ │ │ -000052c0: 2048 414e 444c 452c 0a20 2020 2020 2020   HANDLE,.       
│ │ │ │ -000052d0: 2020 2053 6869 7368 695f 6173 6e31 2045     Shishi_asn1 E
│ │ │ │ -000052e0: 4e43 5449 434b 4554 5041 5254 2c20 696e  NCTICKETPART, in
│ │ │ │ -000052f0: 7433 325f 7420 5452 5459 5045 2c0a 2020  t32_t TRTYPE,.  
│ │ │ │ -00005300: 2020 2020 2020 2020 636f 6e73 7420 6368          const ch
│ │ │ │ -00005310: 6172 202a 2054 5244 4154 412c 2073 697a  ar * TRDATA, siz
│ │ │ │ -00005320: 655f 7420 5452 4441 5441 4c45 4e29 0a20  e_t TRDATALEN). 
│ │ │ │ -00005330: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ -00005340: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ -00005350: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ -00005360: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ -00005370: 2020 2020 454e 4354 4943 4b45 5450 4152      ENCTICKETPAR
│ │ │ │ -00005380: 543a 2069 6e70 7574 2045 6e63 5469 636b  T: input EncTick
│ │ │ │ -00005390: 6574 5061 7274 2076 6172 6961 626c 652e  etPart variable.
│ │ │ │ -000053a0: 0a20 2020 2020 5452 5459 5045 3a20 7472  .     TRTYPE: tr
│ │ │ │ -000053b0: 616e 7369 7465 6465 6e63 6f64 696e 6720  ansitedencoding 
│ │ │ │ -000053c0: 7479 7065 2c20 652e 672e 0a20 2020 2020  type, e.g..     
│ │ │ │ -000053d0: 5348 4953 4849 5f54 525f 444f 4d41 494e  SHISHI_TR_DOMAIN
│ │ │ │ -000053e0: 5f58 3530 305f 434f 4d50 5245 5353 2e0a  _X500_COMPRESS..
│ │ │ │ -000053f0: 2020 2020 2054 5244 4154 413a 2061 6374       TRDATA: act
│ │ │ │ -00005400: 7561 6c20 7472 616e 7369 7465 6420 7265  ual transited re
│ │ │ │ -00005410: 616c 6d20 6461 7461 2e0a 2020 2020 2054  alm data..     T
│ │ │ │ -00005420: 5244 4154 414c 454e 3a20 6c65 6e67 7468  RDATALEN: length
│ │ │ │ -00005430: 206f 6620 6163 7475 616c 2074 7261 6e73   of actual trans
│ │ │ │ -00005440: 6974 6564 2072 6561 6c6d 2064 6174 612e  ited realm data.
│ │ │ │ -00005450: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ -00005460: 696f 6e3a 2a20 5365 7420 7468 6520 456e  ion:* Set the En
│ │ │ │ -00005470: 6354 6963 6b65 7450 6172 742e 7472 616e  cTicketPart.tran
│ │ │ │ -00005480: 7369 7465 6420 6669 656c 6420 746f 2073  sited field to s
│ │ │ │ -00005490: 7570 706c 6965 640a 2020 2020 2076 616c  upplied.     val
│ │ │ │ -000054a0: 7565 2e0a 0a20 2020 2020 2a52 6574 7572  ue...     *Retur
│ │ │ │ -000054b0: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ -000054c0: 7320 e280 9853 4849 5348 495f 4f4b e280  s ...SHISHI_OK..
│ │ │ │ -000054d0: 9920 6966 6620 7375 6363 6573 7366 756c  . iff successful
│ │ │ │ -000054e0: 2e0a 0a73 6869 7368 695f 656e 6374 6963  ...shishi_enctic
│ │ │ │ -000054f0: 6b65 7470 6172 745f 6175 7468 7469 6d65  ketpart_authtime
│ │ │ │ -00005500: 5f73 6574 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  _set.-----------
│ │ │ │ +00005280: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ +00005290: 2069 6e74 2073 6869 7368 695f 656e 6374   int shishi_enct
│ │ │ │ +000052a0: 6963 6b65 7470 6172 745f 7472 616e 7369  icketpart_transi
│ │ │ │ +000052b0: 7465 645f 7365 7420 2853 6869 7368 6920  ted_set (Shishi 
│ │ │ │ +000052c0: 2a20 4841 4e44 4c45 2c0a 2020 2020 2020  * HANDLE,.      
│ │ │ │ +000052d0: 2020 2020 5368 6973 6869 5f61 736e 3120      Shishi_asn1 
│ │ │ │ +000052e0: 454e 4354 4943 4b45 5450 4152 542c 2069  ENCTICKETPART, i
│ │ │ │ +000052f0: 6e74 3332 5f74 2054 5254 5950 452c 0a20  nt32_t TRTYPE,. 
│ │ │ │ +00005300: 2020 2020 2020 2020 2063 6f6e 7374 2063           const c
│ │ │ │ +00005310: 6861 7220 2a20 5452 4441 5441 2c20 7369  har * TRDATA, si
│ │ │ │ +00005320: 7a65 5f74 2054 5244 4154 414c 454e 290a  ze_t TRDATALEN).
│ │ │ │ +00005330: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ +00005340: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ +00005350: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ +00005360: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ +00005370: 2020 2020 2045 4e43 5449 434b 4554 5041       ENCTICKETPA
│ │ │ │ +00005380: 5254 3a20 696e 7075 7420 456e 6354 6963  RT: input EncTic
│ │ │ │ +00005390: 6b65 7450 6172 7420 7661 7269 6162 6c65  ketPart variable
│ │ │ │ +000053a0: 2e0a 2020 2020 2054 5254 5950 453a 2074  ..     TRTYPE: t
│ │ │ │ +000053b0: 7261 6e73 6974 6564 656e 636f 6469 6e67  ransitedencoding
│ │ │ │ +000053c0: 2074 7970 652c 2065 2e67 2e0a 2020 2020   type, e.g..    
│ │ │ │ +000053d0: 2053 4849 5348 495f 5452 5f44 4f4d 4149   SHISHI_TR_DOMAI
│ │ │ │ +000053e0: 4e5f 5835 3030 5f43 4f4d 5052 4553 532e  N_X500_COMPRESS.
│ │ │ │ +000053f0: 0a20 2020 2020 5452 4441 5441 3a20 6163  .     TRDATA: ac
│ │ │ │ +00005400: 7475 616c 2074 7261 6e73 6974 6564 2072  tual transited r
│ │ │ │ +00005410: 6561 6c6d 2064 6174 612e 0a20 2020 2020  ealm data..     
│ │ │ │ +00005420: 5452 4441 5441 4c45 4e3a 206c 656e 6774  TRDATALEN: lengt
│ │ │ │ +00005430: 6820 6f66 2061 6374 7561 6c20 7472 616e  h of actual tran
│ │ │ │ +00005440: 7369 7465 6420 7265 616c 6d20 6461 7461  sited realm data
│ │ │ │ +00005450: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ +00005460: 7469 6f6e 3a2a 2053 6574 2074 6865 2045  tion:* Set the E
│ │ │ │ +00005470: 6e63 5469 636b 6574 5061 7274 2e74 7261  ncTicketPart.tra
│ │ │ │ +00005480: 6e73 6974 6564 2066 6965 6c64 2074 6f20  nsited field to 
│ │ │ │ +00005490: 7375 7070 6c69 6564 0a20 2020 2020 7661  supplied.     va
│ │ │ │ +000054a0: 6c75 652e 0a0a 2020 2020 202a 5265 7475  lue...     *Retu
│ │ │ │ +000054b0: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ +000054c0: 6e73 20e2 8098 5348 4953 4849 5f4f 4be2  ns ...SHISHI_OK.
│ │ │ │ +000054d0: 8099 2069 6666 2073 7563 6365 7373 6675  .. iff successfu
│ │ │ │ +000054e0: 6c2e 0a0a 7368 6973 6869 5f65 6e63 7469  l...shishi_encti
│ │ │ │ +000054f0: 636b 6574 7061 7274 5f61 7574 6874 696d  cketpart_authtim
│ │ │ │ +00005500: 655f 7365 740a 2d2d 2d2d 2d2d 2d2d 2d2d  e_set.----------
│ │ │ │  00005510: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00005520: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ -00005530: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ -00005540: 5f65 6e63 7469 636b 6574 7061 7274 5f61  _encticketpart_a
│ │ │ │ -00005550: 7574 6874 696d 655f 7365 7420 2853 6869  uthtime_set (Shi
│ │ │ │ -00005560: 7368 6920 2a20 4841 4e44 4c45 2c0a 2020  shi * HANDLE,.  
│ │ │ │ -00005570: 2020 2020 2020 2020 5368 6973 6869 5f61          Shishi_a
│ │ │ │ -00005580: 736e 3120 454e 4354 4943 4b45 5450 4152  sn1 ENCTICKETPAR
│ │ │ │ -00005590: 542c 2063 6f6e 7374 2063 6861 7220 2a20  T, const char * 
│ │ │ │ -000055a0: 4155 5448 5449 4d45 290a 2020 2020 2048  AUTHTIME).     H
│ │ │ │ -000055b0: 414e 444c 453a 2073 6869 7368 6920 6861  ANDLE: shishi ha
│ │ │ │ -000055c0: 6e64 6c65 2061 7320 616c 6c6f 6361 7465  ndle as allocate
│ │ │ │ -000055d0: 6420 6279 20e2 8098 7368 6973 6869 5f69  d by ...shishi_i
│ │ │ │ -000055e0: 6e69 7428 29e2 8099 2e0a 2020 2020 2045  nit().....     E
│ │ │ │ -000055f0: 4e43 5449 434b 4554 5041 5254 3a20 696e  NCTICKETPART: in
│ │ │ │ -00005600: 7075 7420 456e 6354 6963 6b65 7450 6172  put EncTicketPar
│ │ │ │ -00005610: 7420 7661 7269 6162 6c65 2e0a 2020 2020  t variable..    
│ │ │ │ -00005620: 2041 5554 4854 494d 453a 2063 6861 7261   AUTHTIME: chara
│ │ │ │ -00005630: 6374 6572 2062 7566 6665 7220 636f 6e74  cter buffer cont
│ │ │ │ -00005640: 6169 6e69 6e67 2061 2067 656e 6572 616c  aining a general
│ │ │ │ -00005650: 697a 6564 2074 696d 6520 7374 7269 6e67  ized time string
│ │ │ │ -00005660: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ -00005670: 7469 6f6e 3a2a 2053 6574 2074 6865 2045  tion:* Set the E
│ │ │ │ -00005680: 6e63 5469 636b 6574 5061 7274 2e61 7574  ncTicketPart.aut
│ │ │ │ -00005690: 6874 696d 6520 746f 2073 7570 706c 6965  htime to supplie
│ │ │ │ -000056a0: 6420 7661 6c75 652e 0a0a 2020 2020 202a  d value...     *
│ │ │ │ -000056b0: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ -000056c0: 6574 7572 6e73 20e2 8098 5348 4953 4849  eturns ...SHISHI
│ │ │ │ -000056d0: 5f4f 4be2 8099 2069 6666 2073 7563 6365  _OK... iff succe
│ │ │ │ -000056e0: 7373 6675 6c2e 0a0a 7368 6973 6869 5f65  ssful...shishi_e
│ │ │ │ -000056f0: 6e63 7469 636b 6574 7061 7274 5f65 6e64  ncticketpart_end
│ │ │ │ -00005700: 7469 6d65 5f73 6574 0a2d 2d2d 2d2d 2d2d  time_set.-------
│ │ │ │ +00005520: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +00005530: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ +00005540: 695f 656e 6374 6963 6b65 7470 6172 745f  i_encticketpart_
│ │ │ │ +00005550: 6175 7468 7469 6d65 5f73 6574 2028 5368  authtime_set (Sh
│ │ │ │ +00005560: 6973 6869 202a 2048 414e 444c 452c 0a20  ishi * HANDLE,. 
│ │ │ │ +00005570: 2020 2020 2020 2020 2053 6869 7368 695f           Shishi_
│ │ │ │ +00005580: 6173 6e31 2045 4e43 5449 434b 4554 5041  asn1 ENCTICKETPA
│ │ │ │ +00005590: 5254 2c20 636f 6e73 7420 6368 6172 202a  RT, const char *
│ │ │ │ +000055a0: 2041 5554 4854 494d 4529 0a20 2020 2020   AUTHTIME).     
│ │ │ │ +000055b0: 4841 4e44 4c45 3a20 7368 6973 6869 2068  HANDLE: shishi h
│ │ │ │ +000055c0: 616e 646c 6520 6173 2061 6c6c 6f63 6174  andle as allocat
│ │ │ │ +000055d0: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ +000055e0: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ +000055f0: 454e 4354 4943 4b45 5450 4152 543a 2069  ENCTICKETPART: i
│ │ │ │ +00005600: 6e70 7574 2045 6e63 5469 636b 6574 5061  nput EncTicketPa
│ │ │ │ +00005610: 7274 2076 6172 6961 626c 652e 0a20 2020  rt variable..   
│ │ │ │ +00005620: 2020 4155 5448 5449 4d45 3a20 6368 6172    AUTHTIME: char
│ │ │ │ +00005630: 6163 7465 7220 6275 6666 6572 2063 6f6e  acter buffer con
│ │ │ │ +00005640: 7461 696e 696e 6720 6120 6765 6e65 7261  taining a genera
│ │ │ │ +00005650: 6c69 7a65 6420 7469 6d65 2073 7472 696e  lized time strin
│ │ │ │ +00005660: 672e 0a0a 2020 2020 202a 4465 7363 7269  g...     *Descri
│ │ │ │ +00005670: 7074 696f 6e3a 2a20 5365 7420 7468 6520  ption:* Set the 
│ │ │ │ +00005680: 456e 6354 6963 6b65 7450 6172 742e 6175  EncTicketPart.au
│ │ │ │ +00005690: 7468 7469 6d65 2074 6f20 7375 7070 6c69  thtime to suppli
│ │ │ │ +000056a0: 6564 2076 616c 7565 2e0a 0a20 2020 2020  ed value...     
│ │ │ │ +000056b0: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ +000056c0: 5265 7475 726e 7320 e280 9853 4849 5348  Returns ...SHISH
│ │ │ │ +000056d0: 495f 4f4b e280 9920 6966 6620 7375 6363  I_OK... iff succ
│ │ │ │ +000056e0: 6573 7366 756c 2e0a 0a73 6869 7368 695f  essful...shishi_
│ │ │ │ +000056f0: 656e 6374 6963 6b65 7470 6172 745f 656e  encticketpart_en
│ │ │ │ +00005700: 6474 696d 655f 7365 740a 2d2d 2d2d 2d2d  dtime_set.------
│ │ │ │  00005710: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00005720: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ -00005730: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ -00005740: 7368 695f 656e 6374 6963 6b65 7470 6172  shi_encticketpar
│ │ │ │ -00005750: 745f 656e 6474 696d 655f 7365 7420 2853  t_endtime_set (S
│ │ │ │ -00005760: 6869 7368 6920 2a20 4841 4e44 4c45 2c0a  hishi * HANDLE,.
│ │ │ │ -00005770: 2020 2020 2020 2020 2020 5368 6973 6869            Shishi
│ │ │ │ -00005780: 5f61 736e 3120 454e 4354 4943 4b45 5450  _asn1 ENCTICKETP
│ │ │ │ -00005790: 4152 542c 2063 6f6e 7374 2063 6861 7220  ART, const char 
│ │ │ │ -000057a0: 2a20 454e 4454 494d 4529 0a20 2020 2020  * ENDTIME).     
│ │ │ │ -000057b0: 4841 4e44 4c45 3a20 7368 6973 6869 2068  HANDLE: shishi h
│ │ │ │ -000057c0: 616e 646c 6520 6173 2061 6c6c 6f63 6174  andle as allocat
│ │ │ │ -000057d0: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ -000057e0: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ -000057f0: 454e 4354 4943 4b45 5450 4152 543a 2069  ENCTICKETPART: i
│ │ │ │ -00005800: 6e70 7574 2045 6e63 5469 636b 6574 5061  nput EncTicketPa
│ │ │ │ -00005810: 7274 2076 6172 6961 626c 652e 0a20 2020  rt variable..   
│ │ │ │ -00005820: 2020 454e 4454 494d 453a 2063 6861 7261    ENDTIME: chara
│ │ │ │ -00005830: 6374 6572 2062 7566 6665 7220 636f 6e74  cter buffer cont
│ │ │ │ -00005840: 6169 6e69 6e67 2061 2067 656e 6572 616c  aining a general
│ │ │ │ -00005850: 697a 6564 2074 696d 6520 7374 7269 6e67  ized time string
│ │ │ │ -00005860: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ -00005870: 7469 6f6e 3a2a 2053 6574 2074 6865 2045  tion:* Set the E
│ │ │ │ -00005880: 6e63 5469 636b 6574 5061 7274 2e65 6e64  ncTicketPart.end
│ │ │ │ -00005890: 7469 6d65 2074 6f20 7375 7070 6c69 6564  time to supplied
│ │ │ │ -000058a0: 2076 616c 7565 2e0a 0a20 2020 2020 2a52   value...     *R
│ │ │ │ -000058b0: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ -000058c0: 7475 726e 7320 e280 9853 4849 5348 495f  turns ...SHISHI_
│ │ │ │ -000058d0: 4f4b e280 9920 6966 6620 7375 6363 6573  OK... iff succes
│ │ │ │ -000058e0: 7366 756c 2e0a 0a73 6869 7368 695f 656e  sful...shishi_en
│ │ │ │ -000058f0: 6374 6963 6b65 7470 6172 745f 636c 6965  cticketpart_clie
│ │ │ │ -00005900: 6e74 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  nt.-------------
│ │ │ │ -00005910: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -00005920: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ -00005930: 7420 7368 6973 6869 5f65 6e63 7469 636b  t shishi_enctick
│ │ │ │ -00005940: 6574 7061 7274 5f63 6c69 656e 7420 2853  etpart_client (S
│ │ │ │ -00005950: 6869 7368 6920 2a20 4841 4e44 4c45 2c0a  hishi * HANDLE,.
│ │ │ │ -00005960: 2020 2020 2020 2020 2020 5368 6973 6869            Shishi
│ │ │ │ -00005970: 5f61 736e 3120 454e 4354 4943 4b45 5450  _asn1 ENCTICKETP
│ │ │ │ -00005980: 4152 542c 2063 6861 7220 2a2a 2043 4c49  ART, char ** CLI
│ │ │ │ -00005990: 454e 542c 2073 697a 655f 7420 2a20 434c  ENT, size_t * CL
│ │ │ │ -000059a0: 4945 4e54 4c45 4e29 0a20 2020 2020 4841  IENTLEN).     HA
│ │ │ │ -000059b0: 4e44 4c45 3a20 5368 6973 6869 206c 6962  NDLE: Shishi lib
│ │ │ │ -000059c0: 7261 7279 2068 616e 646c 6520 6372 6561  rary handle crea
│ │ │ │ -000059d0: 7465 2062 7920 e280 9873 6869 7368 695f  te by ...shishi_
│ │ │ │ -000059e0: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ -000059f0: 454e 4354 4943 4b45 5450 4152 543a 2045  ENCTICKETPART: E
│ │ │ │ -00005a00: 6e63 5469 636b 6574 5061 7274 2076 6172  ncTicketPart var
│ │ │ │ -00005a10: 6961 626c 6520 746f 2067 6574 2063 6c69  iable to get cli
│ │ │ │ -00005a20: 656e 7420 6e61 6d65 2066 726f 6d2e 0a20  ent name from.. 
│ │ │ │ -00005a30: 2020 2020 434c 4945 4e54 3a20 706f 696e      CLIENT: poin
│ │ │ │ -00005a40: 7465 7220 746f 206e 6577 6c79 2061 6c6c  ter to newly all
│ │ │ │ -00005a50: 6f63 6174 6564 207a 6572 6f20 7465 726d  ocated zero term
│ │ │ │ -00005a60: 696e 6174 6564 2073 7472 696e 670a 2020  inated string.  
│ │ │ │ -00005a70: 2020 2063 6f6e 7461 696e 696e 6720 7072     containing pr
│ │ │ │ -00005a80: 696e 6369 7061 6c20 6e61 6d65 2e20 204d  incipal name.  M
│ │ │ │ -00005a90: 6179 2062 6520 e280 984e 554c 4ce2 8099  ay be ...NULL...
│ │ │ │ -00005aa0: 2028 746f 206f 6e6c 7920 706f 7075 6c61   (to only popula
│ │ │ │ -00005ab0: 7465 0a20 2020 2020 434c 4945 4e54 4c45  te.     CLIENTLE
│ │ │ │ -00005ac0: 4e29 2e0a 2020 2020 2043 4c49 454e 544c  N)..     CLIENTL
│ │ │ │ -00005ad0: 454e 3a20 706f 696e 7465 7220 746f 206c  EN: pointer to l
│ │ │ │ -00005ae0: 656e 6774 6820 6f66 2043 4c49 454e 5420  ength of CLIENT 
│ │ │ │ -00005af0: 6f6e 206f 7574 7075 742c 2065 7863 6c75  on output, exclu
│ │ │ │ -00005b00: 6469 6e67 0a20 2020 2020 7465 726d 696e  ding.     termin
│ │ │ │ -00005b10: 6174 696e 6720 7a65 726f 2e20 204d 6179  ating zero.  May
│ │ │ │ -00005b20: 2062 6520 e280 984e 554c 4ce2 8099 2028   be ...NULL... (
│ │ │ │ -00005b30: 746f 206f 6e6c 7920 706f 7075 6c61 7465  to only populate
│ │ │ │ -00005b40: 2043 4c49 454e 5429 2e0a 0a20 2020 2020   CLIENT)...     
│ │ │ │ -00005b50: 2a44 6573 6372 6970 7469 6f6e 3a2a 2052  *Description:* R
│ │ │ │ -00005b60: 6570 7265 7365 6e74 2063 6c69 656e 7420  epresent client 
│ │ │ │ -00005b70: 7072 696e 6369 7061 6c20 6e61 6d65 2069  principal name i
│ │ │ │ -00005b80: 6e20 456e 6354 6963 6b65 7450 6172 7420  n EncTicketPart 
│ │ │ │ -00005b90: 6173 0a20 2020 2020 7a65 726f 2d74 6572  as.     zero-ter
│ │ │ │ -00005ba0: 6d69 6e61 7465 6420 7374 7269 6e67 2e20  minated string. 
│ │ │ │ -00005bb0: 2054 6865 2073 7472 696e 6720 6973 2061   The string is a
│ │ │ │ -00005bc0: 6c6c 6f63 6174 6520 6279 2074 6869 7320  llocate by this 
│ │ │ │ -00005bd0: 6675 6e63 7469 6f6e 2c0a 2020 2020 2061  function,.     a
│ │ │ │ -00005be0: 6e64 2069 7420 6973 2074 6865 2072 6573  nd it is the res
│ │ │ │ -00005bf0: 706f 6e73 6962 696c 6974 7920 6f66 2074  ponsibility of t
│ │ │ │ -00005c00: 6865 2063 616c 6c65 7220 746f 2064 6561  he caller to dea
│ │ │ │ -00005c10: 6c6c 6f63 6174 6520 6974 2e20 204e 6f74  llocate it.  Not
│ │ │ │ -00005c20: 650a 2020 2020 2074 6861 7420 7468 6520  e.     that the 
│ │ │ │ -00005c30: 6f75 7470 7574 206c 656e 6774 6820 434c  output length CL
│ │ │ │ -00005c40: 4945 4e54 4c45 4e20 646f 6573 206e 6f74  IENTLEN does not
│ │ │ │ -00005c50: 2069 6e63 6c75 6465 2074 6865 2074 6572   include the ter
│ │ │ │ -00005c60: 6d69 6e61 7469 6e67 0a20 2020 2020 7a65  minating.     ze
│ │ │ │ -00005c70: 726f 2e0a 0a20 2020 2020 2a52 6574 7572  ro...     *Retur
│ │ │ │ -00005c80: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ -00005c90: 7320 5348 4953 4849 5f4f 4b20 6966 6620  s SHISHI_OK iff 
│ │ │ │ -00005ca0: 7375 6363 6573 7366 756c 2e0a 0a73 6869  successful...shi
│ │ │ │ -00005cb0: 7368 695f 656e 6374 6963 6b65 7470 6172  shi_encticketpar
│ │ │ │ -00005cc0: 745f 636c 6965 6e74 7265 616c 6d0a 2d2d  t_clientrealm.--
│ │ │ │ +00005720: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +00005730: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ +00005740: 6973 6869 5f65 6e63 7469 636b 6574 7061  ishi_encticketpa
│ │ │ │ +00005750: 7274 5f65 6e64 7469 6d65 5f73 6574 2028  rt_endtime_set (
│ │ │ │ +00005760: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ +00005770: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ +00005780: 695f 6173 6e31 2045 4e43 5449 434b 4554  i_asn1 ENCTICKET
│ │ │ │ +00005790: 5041 5254 2c20 636f 6e73 7420 6368 6172  PART, const char
│ │ │ │ +000057a0: 202a 2045 4e44 5449 4d45 290a 2020 2020   * ENDTIME).    
│ │ │ │ +000057b0: 2048 414e 444c 453a 2073 6869 7368 6920   HANDLE: shishi 
│ │ │ │ +000057c0: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ +000057d0: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ +000057e0: 5f69 6e69 7428 29e2 8099 2e0a 2020 2020  _init().....    
│ │ │ │ +000057f0: 2045 4e43 5449 434b 4554 5041 5254 3a20   ENCTICKETPART: 
│ │ │ │ +00005800: 696e 7075 7420 456e 6354 6963 6b65 7450  input EncTicketP
│ │ │ │ +00005810: 6172 7420 7661 7269 6162 6c65 2e0a 2020  art variable..  
│ │ │ │ +00005820: 2020 2045 4e44 5449 4d45 3a20 6368 6172     ENDTIME: char
│ │ │ │ +00005830: 6163 7465 7220 6275 6666 6572 2063 6f6e  acter buffer con
│ │ │ │ +00005840: 7461 696e 696e 6720 6120 6765 6e65 7261  taining a genera
│ │ │ │ +00005850: 6c69 7a65 6420 7469 6d65 2073 7472 696e  lized time strin
│ │ │ │ +00005860: 672e 0a0a 2020 2020 202a 4465 7363 7269  g...     *Descri
│ │ │ │ +00005870: 7074 696f 6e3a 2a20 5365 7420 7468 6520  ption:* Set the 
│ │ │ │ +00005880: 456e 6354 6963 6b65 7450 6172 742e 656e  EncTicketPart.en
│ │ │ │ +00005890: 6474 696d 6520 746f 2073 7570 706c 6965  dtime to supplie
│ │ │ │ +000058a0: 6420 7661 6c75 652e 0a0a 2020 2020 202a  d value...     *
│ │ │ │ +000058b0: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ +000058c0: 6574 7572 6e73 20e2 8098 5348 4953 4849  eturns ...SHISHI
│ │ │ │ +000058d0: 5f4f 4be2 8099 2069 6666 2073 7563 6365  _OK... iff succe
│ │ │ │ +000058e0: 7373 6675 6c2e 0a0a 7368 6973 6869 5f65  ssful...shishi_e
│ │ │ │ +000058f0: 6e63 7469 636b 6574 7061 7274 5f63 6c69  ncticketpart_cli
│ │ │ │ +00005900: 656e 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ent.------------
│ │ │ │ +00005910: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +00005920: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ +00005930: 6e74 2073 6869 7368 695f 656e 6374 6963  nt shishi_enctic
│ │ │ │ +00005940: 6b65 7470 6172 745f 636c 6965 6e74 2028  ketpart_client (
│ │ │ │ +00005950: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ +00005960: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ +00005970: 695f 6173 6e31 2045 4e43 5449 434b 4554  i_asn1 ENCTICKET
│ │ │ │ +00005980: 5041 5254 2c20 6368 6172 202a 2a20 434c  PART, char ** CL
│ │ │ │ +00005990: 4945 4e54 2c20 7369 7a65 5f74 202a 2043  IENT, size_t * C
│ │ │ │ +000059a0: 4c49 454e 544c 454e 290a 2020 2020 2048  LIENTLEN).     H
│ │ │ │ +000059b0: 414e 444c 453a 2053 6869 7368 6920 6c69  ANDLE: Shishi li
│ │ │ │ +000059c0: 6272 6172 7920 6861 6e64 6c65 2063 7265  brary handle cre
│ │ │ │ +000059d0: 6174 6520 6279 20e2 8098 7368 6973 6869  ate by ...shishi
│ │ │ │ +000059e0: 5f69 6e69 7428 29e2 8099 2e0a 2020 2020  _init().....    
│ │ │ │ +000059f0: 2045 4e43 5449 434b 4554 5041 5254 3a20   ENCTICKETPART: 
│ │ │ │ +00005a00: 456e 6354 6963 6b65 7450 6172 7420 7661  EncTicketPart va
│ │ │ │ +00005a10: 7269 6162 6c65 2074 6f20 6765 7420 636c  riable to get cl
│ │ │ │ +00005a20: 6965 6e74 206e 616d 6520 6672 6f6d 2e0a  ient name from..
│ │ │ │ +00005a30: 2020 2020 2043 4c49 454e 543a 2070 6f69       CLIENT: poi
│ │ │ │ +00005a40: 6e74 6572 2074 6f20 6e65 776c 7920 616c  nter to newly al
│ │ │ │ +00005a50: 6c6f 6361 7465 6420 7a65 726f 2074 6572  located zero ter
│ │ │ │ +00005a60: 6d69 6e61 7465 6420 7374 7269 6e67 0a20  minated string. 
│ │ │ │ +00005a70: 2020 2020 636f 6e74 6169 6e69 6e67 2070      containing p
│ │ │ │ +00005a80: 7269 6e63 6970 616c 206e 616d 652e 2020  rincipal name.  
│ │ │ │ +00005a90: 4d61 7920 6265 20e2 8098 4e55 4c4c e280  May be ...NULL..
│ │ │ │ +00005aa0: 9920 2874 6f20 6f6e 6c79 2070 6f70 756c  . (to only popul
│ │ │ │ +00005ab0: 6174 650a 2020 2020 2043 4c49 454e 544c  ate.     CLIENTL
│ │ │ │ +00005ac0: 454e 292e 0a20 2020 2020 434c 4945 4e54  EN)..     CLIENT
│ │ │ │ +00005ad0: 4c45 4e3a 2070 6f69 6e74 6572 2074 6f20  LEN: pointer to 
│ │ │ │ +00005ae0: 6c65 6e67 7468 206f 6620 434c 4945 4e54  length of CLIENT
│ │ │ │ +00005af0: 206f 6e20 6f75 7470 7574 2c20 6578 636c   on output, excl
│ │ │ │ +00005b00: 7564 696e 670a 2020 2020 2074 6572 6d69  uding.     termi
│ │ │ │ +00005b10: 6e61 7469 6e67 207a 6572 6f2e 2020 4d61  nating zero.  Ma
│ │ │ │ +00005b20: 7920 6265 20e2 8098 4e55 4c4c e280 9920  y be ...NULL... 
│ │ │ │ +00005b30: 2874 6f20 6f6e 6c79 2070 6f70 756c 6174  (to only populat
│ │ │ │ +00005b40: 6520 434c 4945 4e54 292e 0a0a 2020 2020  e CLIENT)...    
│ │ │ │ +00005b50: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ +00005b60: 5265 7072 6573 656e 7420 636c 6965 6e74  Represent client
│ │ │ │ +00005b70: 2070 7269 6e63 6970 616c 206e 616d 6520   principal name 
│ │ │ │ +00005b80: 696e 2045 6e63 5469 636b 6574 5061 7274  in EncTicketPart
│ │ │ │ +00005b90: 2061 730a 2020 2020 207a 6572 6f2d 7465   as.     zero-te
│ │ │ │ +00005ba0: 726d 696e 6174 6564 2073 7472 696e 672e  rminated string.
│ │ │ │ +00005bb0: 2020 5468 6520 7374 7269 6e67 2069 7320    The string is 
│ │ │ │ +00005bc0: 616c 6c6f 6361 7465 2062 7920 7468 6973  allocate by this
│ │ │ │ +00005bd0: 2066 756e 6374 696f 6e2c 0a20 2020 2020   function,.     
│ │ │ │ +00005be0: 616e 6420 6974 2069 7320 7468 6520 7265  and it is the re
│ │ │ │ +00005bf0: 7370 6f6e 7369 6269 6c69 7479 206f 6620  sponsibility of 
│ │ │ │ +00005c00: 7468 6520 6361 6c6c 6572 2074 6f20 6465  the caller to de
│ │ │ │ +00005c10: 616c 6c6f 6361 7465 2069 742e 2020 4e6f  allocate it.  No
│ │ │ │ +00005c20: 7465 0a20 2020 2020 7468 6174 2074 6865  te.     that the
│ │ │ │ +00005c30: 206f 7574 7075 7420 6c65 6e67 7468 2043   output length C
│ │ │ │ +00005c40: 4c49 454e 544c 454e 2064 6f65 7320 6e6f  LIENTLEN does no
│ │ │ │ +00005c50: 7420 696e 636c 7564 6520 7468 6520 7465  t include the te
│ │ │ │ +00005c60: 726d 696e 6174 696e 670a 2020 2020 207a  rminating.     z
│ │ │ │ +00005c70: 6572 6f2e 0a0a 2020 2020 202a 5265 7475  ero...     *Retu
│ │ │ │ +00005c80: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ +00005c90: 6e73 2053 4849 5348 495f 4f4b 2069 6666  ns SHISHI_OK iff
│ │ │ │ +00005ca0: 2073 7563 6365 7373 6675 6c2e 0a0a 7368   successful...sh
│ │ │ │ +00005cb0: 6973 6869 5f65 6e63 7469 636b 6574 7061  ishi_encticketpa
│ │ │ │ +00005cc0: 7274 5f63 6c69 656e 7472 6561 6c6d 0a2d  rt_clientrealm.-
│ │ │ │  00005cd0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00005ce0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -00005cf0: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ -00005d00: 7420 7368 6973 6869 5f65 6e63 7469 636b  t shishi_enctick
│ │ │ │ -00005d10: 6574 7061 7274 5f63 6c69 656e 7472 6561  etpart_clientrea
│ │ │ │ -00005d20: 6c6d 2028 5368 6973 6869 202a 2048 414e  lm (Shishi * HAN
│ │ │ │ -00005d30: 444c 452c 0a20 2020 2020 2020 2020 2053  DLE,.          S
│ │ │ │ -00005d40: 6869 7368 695f 6173 6e31 2045 4e43 5449  hishi_asn1 ENCTI
│ │ │ │ -00005d50: 434b 4554 5041 5254 2c20 6368 6172 202a  CKETPART, char *
│ │ │ │ -00005d60: 2a20 434c 4945 4e54 2c20 7369 7a65 5f74  * CLIENT, size_t
│ │ │ │ -00005d70: 202a 2043 4c49 454e 544c 454e 290a 2020   * CLIENTLEN).  
│ │ │ │ -00005d80: 2020 2048 414e 444c 453a 2053 6869 7368     HANDLE: Shish
│ │ │ │ -00005d90: 6920 6c69 6272 6172 7920 6861 6e64 6c65  i library handle
│ │ │ │ -00005da0: 2063 7265 6174 6520 6279 20e2 8098 7368   create by ...sh
│ │ │ │ -00005db0: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ -00005dc0: 2020 2020 2045 4e43 5449 434b 4554 5041       ENCTICKETPA
│ │ │ │ -00005dd0: 5254 3a20 456e 6354 6963 6b65 7450 6172  RT: EncTicketPar
│ │ │ │ -00005de0: 7420 7661 7269 6162 6c65 2074 6f20 6765  t variable to ge
│ │ │ │ -00005df0: 7420 636c 6965 6e74 206e 616d 6520 616e  t client name an
│ │ │ │ -00005e00: 6420 7265 616c 6d0a 2020 2020 2066 726f  d realm.     fro
│ │ │ │ -00005e10: 6d2e 0a20 2020 2020 434c 4945 4e54 3a20  m..     CLIENT: 
│ │ │ │ -00005e20: 706f 696e 7465 7220 746f 206e 6577 6c79  pointer to newly
│ │ │ │ -00005e30: 2061 6c6c 6f63 6174 6564 207a 6572 6f20   allocated zero 
│ │ │ │ -00005e40: 7465 726d 696e 6174 6564 2073 7472 696e  terminated strin
│ │ │ │ -00005e50: 670a 2020 2020 2063 6f6e 7461 696e 696e  g.     containin
│ │ │ │ -00005e60: 6720 7072 696e 6369 7061 6c20 6e61 6d65  g principal name
│ │ │ │ -00005e70: 2061 6e64 2072 6561 6c6d 2e20 204d 6179   and realm.  May
│ │ │ │ -00005e80: 2062 6520 e280 984e 554c 4ce2 8099 2028   be ...NULL... (
│ │ │ │ -00005e90: 746f 206f 6e6c 790a 2020 2020 2070 6f70  to only.     pop
│ │ │ │ -00005ea0: 756c 6174 6520 434c 4945 4e54 4c45 4e29  ulate CLIENTLEN)
│ │ │ │ -00005eb0: 2e0a 2020 2020 2043 4c49 454e 544c 454e  ..     CLIENTLEN
│ │ │ │ -00005ec0: 3a20 706f 696e 7465 7220 746f 206c 656e  : pointer to len
│ │ │ │ -00005ed0: 6774 6820 6f66 2043 4c49 454e 5420 6f6e  gth of CLIENT on
│ │ │ │ -00005ee0: 206f 7574 7075 742c 2065 7863 6c75 6469   output, excludi
│ │ │ │ -00005ef0: 6e67 0a20 2020 2020 7465 726d 696e 6174  ng.     terminat
│ │ │ │ -00005f00: 696e 6720 7a65 726f 2e20 204d 6179 2062  ing zero.  May b
│ │ │ │ -00005f10: 6520 e280 984e 554c 4ce2 8099 2028 746f  e ...NULL... (to
│ │ │ │ -00005f20: 206f 6e6c 7920 706f 7075 6c61 7465 2043   only populate C
│ │ │ │ -00005f30: 4c49 454e 5429 2e0a 0a20 2020 2020 2a44  LIENT)...     *D
│ │ │ │ -00005f40: 6573 6372 6970 7469 6f6e 3a2a 2043 6f6e  escription:* Con
│ │ │ │ -00005f50: 7665 7274 2063 6e61 6d65 2061 6e64 2072  vert cname and r
│ │ │ │ -00005f60: 6561 6c6d 2066 6965 6c64 7320 6672 6f6d  ealm fields from
│ │ │ │ -00005f70: 2045 6e63 5469 636b 6574 5061 7274 2074   EncTicketPart t
│ │ │ │ -00005f80: 6f0a 2020 2020 2070 7269 6e74 6162 6c65  o.     printable
│ │ │ │ -00005f90: 2070 7269 6e63 6970 616c 206e 616d 6520   principal name 
│ │ │ │ -00005fa0: 666f 726d 6174 2e20 2054 6865 2073 7472  format.  The str
│ │ │ │ -00005fb0: 696e 6720 6973 2061 6c6c 6f63 6174 6520  ing is allocate 
│ │ │ │ -00005fc0: 6279 2074 6869 730a 2020 2020 2066 756e  by this.     fun
│ │ │ │ -00005fd0: 6374 696f 6e2c 2061 6e64 2069 7420 6973  ction, and it is
│ │ │ │ -00005fe0: 2074 6865 2072 6573 706f 6e73 6962 696c   the responsibil
│ │ │ │ -00005ff0: 6974 7920 6f66 2074 6865 2063 616c 6c65  ity of the calle
│ │ │ │ -00006000: 7220 746f 2064 6561 6c6c 6f63 6174 650a  r to deallocate.
│ │ │ │ -00006010: 2020 2020 2069 742e 2020 4e6f 7465 2074       it.  Note t
│ │ │ │ -00006020: 6861 7420 7468 6520 6f75 7470 7574 206c  hat the output l
│ │ │ │ -00006030: 656e 6774 6820 434c 4945 4e54 4c45 4e20  ength CLIENTLEN 
│ │ │ │ -00006040: 646f 6573 206e 6f74 2069 6e63 6c75 6465  does not include
│ │ │ │ -00006050: 2074 6865 0a20 2020 2020 7465 726d 696e   the.     termin
│ │ │ │ -00006060: 6174 696e 6720 7a65 726f 2e0a 0a20 2020  ating zero...   
│ │ │ │ -00006070: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ -00006080: 2a20 5265 7475 726e 7320 5348 4953 4849  * Returns SHISHI
│ │ │ │ -00006090: 5f4f 4b20 6966 6620 7375 6363 6573 7366  _OK iff successf
│ │ │ │ -000060a0: 756c 2e0a 0a1f 0a46 696c 653a 2073 6869  ul.....File: shi
│ │ │ │ -000060b0: 7368 692e 696e 666f 2c20 204e 6f64 653a  shi.info,  Node:
│ │ │ │ -000060c0: 2041 532f 5447 5320 4675 6e63 7469 6f6e   AS/TGS Function
│ │ │ │ -000060d0: 732c 2020 4e65 7874 3a20 4175 7468 656e  s,  Next: Authen
│ │ │ │ -000060e0: 7469 6361 746f 7220 4675 6e63 7469 6f6e  ticator Function
│ │ │ │ -000060f0: 732c 2020 5072 6576 3a20 5469 636b 6574  s,  Prev: Ticket
│ │ │ │ -00006100: 2028 4153 4e2e 3129 2046 756e 6374 696f   (ASN.1) Functio
│ │ │ │ -00006110: 6e73 2c20 2055 703a 2050 726f 6772 616d  ns,  Up: Program
│ │ │ │ -00006120: 6d69 6e67 204d 616e 7561 6c0a 0a35 2e31  ming Manual..5.1
│ │ │ │ -00006130: 3020 4153 2f54 4753 2046 756e 6374 696f  0 AS/TGS Functio
│ │ │ │ -00006140: 6e73 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ns.=============
│ │ │ │ -00006150: 3d3d 3d3d 3d3d 3d3d 0a0a 5468 6520 4175  ========..The Au
│ │ │ │ -00006160: 7468 656e 7469 6361 7469 6f6e 2053 6572  thentication Ser
│ │ │ │ -00006170: 7669 6365 2028 4153 2920 6973 2075 7365  vice (AS) is use
│ │ │ │ -00006180: 6420 746f 2067 6574 2061 6e20 696e 6974  d to get an init
│ │ │ │ -00006190: 6961 6c20 7469 636b 6574 2075 7369 6e67  ial ticket using
│ │ │ │ -000061a0: 0a65 2e67 2e20 2079 6f75 7220 7061 7373  .e.g.  your pass
│ │ │ │ -000061b0: 776f 7264 2e20 2054 6865 2054 6963 6b65  word.  The Ticke
│ │ │ │ -000061c0: 7420 4772 616e 7469 6e67 2053 6572 7669  t Granting Servi
│ │ │ │ -000061d0: 6365 2028 5447 5329 2069 7320 7573 6564  ce (TGS) is used
│ │ │ │ -000061e0: 2074 6f20 6765 740a 7375 6273 6571 7565   to get.subseque
│ │ │ │ -000061f0: 6e74 2074 6963 6b65 7473 2075 7369 6e67  nt tickets using
│ │ │ │ -00006200: 206f 7468 6572 2074 6963 6b65 7473 2e20   other tickets. 
│ │ │ │ -00006210: 2050 726f 746f 636f 6c20 7769 7365 2074   Protocol wise t
│ │ │ │ -00006220: 6865 2070 726f 6365 6475 7265 730a 6172  he procedures.ar
│ │ │ │ -00006230: 6520 7665 7279 2073 696d 696c 6172 2c20  e very similar, 
│ │ │ │ -00006240: 7768 6963 6820 6973 2074 6865 2072 6561  which is the rea
│ │ │ │ -00006250: 736f 6e20 7468 6579 2061 7265 2064 6573  son they are des
│ │ │ │ -00006260: 6372 6962 6564 2074 6f67 6574 6865 722e  cribed together.
│ │ │ │ -00006270: 2020 5468 650a 666f 6c6c 6f77 696e 6720    The.following 
│ │ │ │ -00006280: 696c 6c75 7374 7261 7465 7320 7468 6520  illustrates the 
│ │ │ │ -00006290: 4153 2d52 4551 2c20 5447 532d 5245 5120  AS-REQ, TGS-REQ 
│ │ │ │ -000062a0: 616e 6420 4153 2d52 4550 2c20 5447 532d  and AS-REP, TGS-
│ │ │ │ -000062b0: 5245 5020 4153 4e2e 310a 7374 7275 6374  REP ASN.1.struct
│ │ │ │ -000062c0: 7572 6573 2e20 204d 6f73 7420 6f66 2074  ures.  Most of t
│ │ │ │ -000062d0: 6865 2066 756e 6374 696f 6e73 2075 7365  he functions use
│ │ │ │ -000062e0: 2074 6865 206d 6e65 6d6f 6e69 6320 224b   the mnemonic "K
│ │ │ │ -000062f0: 4443 2220 696e 7374 6561 6420 6f66 0a65  DC" instead of.e
│ │ │ │ -00006300: 6974 6865 7220 4153 206f 7220 5447 532c  ither AS or TGS,
│ │ │ │ -00006310: 2077 6869 6368 206d 6561 6e73 2074 6865   which means the
│ │ │ │ -00006320: 2066 756e 6374 696f 6e20 6f70 6572 6174   function operat
│ │ │ │ -00006330: 6573 206f 6e20 626f 7468 2041 5320 616e  es on both AS an
│ │ │ │ -00006340: 6420 5447 530a 7479 7065 732e 2020 4f6e  d TGS.types.  On
│ │ │ │ -00006350: 6c79 2077 6865 7265 2074 6865 2064 6973  ly where the dis
│ │ │ │ -00006360: 7469 6e63 7469 6f6e 2062 6574 7765 656e  tinction between
│ │ │ │ -00006370: 2041 5320 616e 6420 5447 5320 6973 2069   AS and TGS is i
│ │ │ │ -00006380: 6d70 6f72 7461 6e74 2061 7265 0a74 6865  mportant are.the
│ │ │ │ -00006390: 2041 5320 616e 6420 5447 5320 6e61 6d65   AS and TGS name
│ │ │ │ -000063a0: 7320 7573 6564 2e20 2052 656d 656d 6265  s used.  Remembe
│ │ │ │ -000063b0: 722c 2074 6865 7365 2061 7265 206c 6f77  r, these are low
│ │ │ │ -000063c0: 2d6c 6576 656c 2066 756e 6374 696f 6e73  -level functions
│ │ │ │ -000063d0: 2c20 616e 640a 6e6f 726d 616c 2061 7070  , and.normal app
│ │ │ │ -000063e0: 6c69 6361 7469 6f6e 7320 7769 6c6c 206c  lications will l
│ │ │ │ -000063f0: 696b 656c 7920 6265 2073 6174 6973 6669  ikely be satisfi
│ │ │ │ -00006400: 6564 2077 6974 6820 7468 6520 4153 2028  ed with the AS (
│ │ │ │ -00006410: 2a6e 6f74 6520 4153 0a46 756e 6374 696f  *note AS.Functio
│ │ │ │ -00006420: 6e73 3a3a 2920 616e 6420 5447 5320 282a  ns::) and TGS (*
│ │ │ │ -00006430: 6e6f 7465 2054 4753 2046 756e 6374 696f  note TGS Functio
│ │ │ │ -00006440: 6e73 3a3a 2920 696e 7465 7266 6163 6573  ns::) interfaces
│ │ │ │ -00006450: 2c20 6f72 2074 6865 2065 7665 6e0a 6d6f  , or the even.mo
│ │ │ │ -00006460: 7265 2068 6967 682d 6c65 7665 6c20 5469  re high-level Ti
│ │ │ │ -00006470: 636b 6574 2053 6574 2028 2a6e 6f74 6520  cket Set (*note 
│ │ │ │ -00006480: 5469 636b 6574 2053 6574 2046 756e 6374  Ticket Set Funct
│ │ │ │ -00006490: 696f 6e73 3a3a 2920 696e 7465 7266 6163  ions::) interfac
│ │ │ │ -000064a0: 652e 0a0a 2d2d 2052 6571 7565 7374 202d  e...-- Request -
│ │ │ │ -000064b0: 2d0a 0a41 532d 5245 5109 093a 3a3d 204b  -..AS-REQ..::= K
│ │ │ │ -000064c0: 4443 2d52 4551 207b 3130 7d0a 5447 532d  DC-REQ {10}.TGS-
│ │ │ │ -000064d0: 5245 5109 093a 3a3d 204b 4443 2d52 4551  REQ..::= KDC-REQ
│ │ │ │ -000064e0: 207b 3132 7d0a 0a4b 4443 2d52 4551 207b   {12}..KDC-REQ {
│ │ │ │ -000064f0: 494e 5445 4745 523a 7461 676e 756d 7d09  INTEGER:tagnum}.
│ │ │ │ -00006500: 3a3a 3d20 5b41 5050 4c49 4341 5449 4f4e  ::= [APPLICATION
│ │ │ │ -00006510: 2074 6167 6e75 6d5d 2053 4551 5545 4e43   tagnum] SEQUENC
│ │ │ │ -00006520: 4520 7b0a 0970 766e 6f09 095b 315d 2049  E {..pvno..[1] I
│ │ │ │ -00006530: 4e54 4547 4552 2028 3529 202d 2d20 6669  NTEGER (5) -- fi
│ │ │ │ -00006540: 7273 7420 7461 6720 6973 205b 315d 2c20  rst tag is [1], 
│ │ │ │ -00006550: 6e6f 7420 5b30 5d20 2d2d 2c0a 096d 7367  not [0] --,..msg
│ │ │ │ -00006560: 2d74 7970 6509 5b32 5d20 494e 5445 4745  -type.[2] INTEGE
│ │ │ │ -00006570: 5220 2874 6167 6e75 6d29 2c0a 0970 6164  R (tagnum),..pad
│ │ │ │ -00006580: 6174 6109 095b 335d 2053 4551 5545 4e43  ata..[3] SEQUENC
│ │ │ │ -00006590: 4520 4f46 2050 412d 4441 5441 204f 5054  E OF PA-DATA OPT
│ │ │ │ -000065a0: 494f 4e41 4c2c 0a09 7265 712d 626f 6479  IONAL,..req-body
│ │ │ │ -000065b0: 095b 345d 204b 4443 2d52 4551 2d42 4f44  .[4] KDC-REQ-BOD
│ │ │ │ -000065c0: 590a 7d0a 0a4b 4443 2d52 4551 2d42 4f44  Y.}..KDC-REQ-BOD
│ │ │ │ -000065d0: 5909 3a3a 3d20 5345 5155 454e 4345 207b  Y.::= SEQUENCE {
│ │ │ │ -000065e0: 0a09 6b64 632d 6f70 7469 6f6e 7309 095b  ..kdc-options..[
│ │ │ │ -000065f0: 305d 204b 4443 4f70 7469 6f6e 732c 0a09  0] KDCOptions,..
│ │ │ │ -00006600: 636e 616d 6509 0909 5b31 5d20 5072 696e  cname...[1] Prin
│ │ │ │ -00006610: 6369 7061 6c4e 616d 6520 4f50 5449 4f4e  cipalName OPTION
│ │ │ │ -00006620: 414c 0a09 0909 0920 2020 202d 2d20 5573  AL.....    -- Us
│ │ │ │ -00006630: 6564 206f 6e6c 7920 696e 2041 532d 5245  ed only in AS-RE
│ │ │ │ -00006640: 5120 2d2d 2c0a 0972 6561 6c6d 0909 095b  Q --,..realm...[
│ │ │ │ -00006650: 325d 2052 6561 6c6d 0a09 0909 0920 2020  2] Realm.....   
│ │ │ │ -00006660: 202d 2d20 5365 7276 6572 2773 2072 6561   -- Server's rea
│ │ │ │ -00006670: 6c6d 0a09 0909 0920 2020 202d 2d20 416c  lm.....    -- Al
│ │ │ │ -00006680: 736f 2063 6c69 656e 7427 7320 696e 2041  so client's in A
│ │ │ │ -00006690: 532d 5245 5120 2d2d 2c0a 0973 6e61 6d65  S-REQ --,..sname
│ │ │ │ -000066a0: 0909 095b 335d 2050 7269 6e63 6970 616c  ...[3] Principal
│ │ │ │ -000066b0: 4e61 6d65 204f 5054 494f 4e41 4c2c 0a09  Name OPTIONAL,..
│ │ │ │ -000066c0: 6672 6f6d 0909 095b 345d 204b 6572 6265  from...[4] Kerbe
│ │ │ │ -000066d0: 726f 7354 696d 6520 4f50 5449 4f4e 414c  rosTime OPTIONAL
│ │ │ │ -000066e0: 2c0a 0974 696c 6c09 0909 5b35 5d20 4b65  ,..till...[5] Ke
│ │ │ │ -000066f0: 7262 6572 6f73 5469 6d65 2c0a 0972 7469  rberosTime,..rti
│ │ │ │ -00006700: 6d65 0909 095b 365d 204b 6572 6265 726f  me...[6] Kerbero
│ │ │ │ -00006710: 7354 696d 6520 4f50 5449 4f4e 414c 2c0a  sTime OPTIONAL,.
│ │ │ │ -00006720: 096e 6f6e 6365 0909 095b 375d 2055 496e  .nonce...[7] UIn
│ │ │ │ -00006730: 7433 322c 0a09 6574 7970 6509 0909 5b38  t32,..etype...[8
│ │ │ │ -00006740: 5d20 5345 5155 454e 4345 204f 4620 496e  ] SEQUENCE OF In
│ │ │ │ -00006750: 7433 3220 2d2d 2045 6e63 7279 7074 696f  t32 -- Encryptio
│ │ │ │ -00006760: 6e54 7970 650a 0909 0909 2020 2020 2d2d  nType.....    --
│ │ │ │ -00006770: 2069 6e20 7072 6566 6572 656e 6365 206f   in preference o
│ │ │ │ -00006780: 7264 6572 202d 2d2c 0a09 6164 6472 6573  rder --,..addres
│ │ │ │ -00006790: 7365 7309 095b 395d 2048 6f73 7441 6464  ses..[9] HostAdd
│ │ │ │ -000067a0: 7265 7373 6573 204f 5054 494f 4e41 4c2c  resses OPTIONAL,
│ │ │ │ -000067b0: 0a09 656e 632d 6175 7468 6f72 697a 6174  ..enc-authorizat
│ │ │ │ -000067c0: 696f 6e2d 6461 7461 095b 3130 5d20 456e  ion-data.[10] En
│ │ │ │ -000067d0: 6372 7970 7465 6444 6174 6120 7b0a 0909  cryptedData {...
│ │ │ │ -000067e0: 0909 0941 7574 686f 7269 7a61 7469 6f6e  ...Authorization
│ │ │ │ -000067f0: 4461 7461 2c0a 0909 0909 097b 206b 6579  Data,......{ key
│ │ │ │ -00006800: 7573 652d 5447 5352 6571 4175 7468 4461  use-TGSReqAuthDa
│ │ │ │ -00006810: 7461 2d73 6573 736b 6579 0a09 0909 0909  ta-sesskey......
│ │ │ │ -00006820: 2020 7c20 6b65 7975 7365 2d54 4753 5265    | keyuse-TGSRe
│ │ │ │ -00006830: 7141 7574 6844 6174 612d 7375 626b 6579  qAuthData-subkey
│ │ │ │ -00006840: 207d 0a09 0909 0920 2020 2020 7d20 4f50   }.....     } OP
│ │ │ │ -00006850: 5449 4f4e 414c 2c0a 0961 6464 6974 696f  TIONAL,..additio
│ │ │ │ -00006860: 6e61 6c2d 7469 636b 6574 7309 5b31 315d  nal-tickets.[11]
│ │ │ │ -00006870: 2053 4551 5545 4e43 4520 4f46 2054 6963   SEQUENCE OF Tic
│ │ │ │ -00006880: 6b65 7420 4f50 5449 4f4e 414c 0a7d 0a0a  ket OPTIONAL.}..
│ │ │ │ -00006890: 2d2d 2052 6570 6c79 202d 2d0a 0a41 532d  -- Reply --..AS-
│ │ │ │ -000068a0: 5245 5009 093a 3a3d 204b 4443 2d52 4550  REP..::= KDC-REP
│ │ │ │ -000068b0: 207b 3131 2c20 456e 6341 5352 6570 5061   {11, EncASRepPa
│ │ │ │ -000068c0: 7274 2c20 7b6b 6579 7573 652d 456e 6341  rt, {keyuse-EncA
│ │ │ │ -000068d0: 5352 6570 5061 7274 7d7d 0a54 4753 2d52  SRepPart}}.TGS-R
│ │ │ │ -000068e0: 4550 0909 3a3a 3d20 4b44 432d 5245 5020  EP..::= KDC-REP 
│ │ │ │ -000068f0: 7b31 332c 2045 6e63 5447 5352 6570 5061  {13, EncTGSRepPa
│ │ │ │ -00006900: 7274 2c0a 0909 097b 206b 6579 7573 652d  rt,....{ keyuse-
│ │ │ │ -00006910: 456e 6354 4753 5265 7050 6172 742d 7365  EncTGSRepPart-se
│ │ │ │ -00006920: 7373 6b65 790a 0909 0920 207c 206b 6579  sskey....  | key
│ │ │ │ -00006930: 7573 652d 456e 6354 4753 5265 7050 6172  use-EncTGSRepPar
│ │ │ │ -00006940: 742d 7375 626b 6579 207d 7d0a 0a4b 4443  t-subkey }}..KDC
│ │ │ │ -00006950: 2d52 4550 207b 494e 5445 4745 523a 7461  -REP {INTEGER:ta
│ │ │ │ -00006960: 676e 756d 2c0a 0920 5479 7065 546f 456e  gnum,.. TypeToEn
│ │ │ │ -00006970: 6372 7970 742c 0a09 2055 496e 7433 323a  crypt,.. UInt32:
│ │ │ │ -00006980: 4b65 7955 7361 6765 737d 093a 3a3d 205b  KeyUsages}.::= [
│ │ │ │ -00006990: 4150 504c 4943 4154 494f 4e20 7461 676e  APPLICATION tagn
│ │ │ │ -000069a0: 756d 5d20 5345 5155 454e 4345 207b 0a09  um] SEQUENCE {..
│ │ │ │ -000069b0: 7076 6e6f 0909 5b30 5d20 494e 5445 4745  pvno..[0] INTEGE
│ │ │ │ -000069c0: 5220 2835 292c 0a09 6d73 672d 7479 7065  R (5),..msg-type
│ │ │ │ -000069d0: 095b 315d 2049 4e54 4547 4552 2028 7461  .[1] INTEGER (ta
│ │ │ │ -000069e0: 676e 756d 292c 0a09 7061 6461 7461 0909  gnum),..padata..
│ │ │ │ -000069f0: 5b32 5d20 5345 5155 454e 4345 204f 4620  [2] SEQUENCE OF 
│ │ │ │ -00006a00: 5041 2d44 4154 4120 4f50 5449 4f4e 414c  PA-DATA OPTIONAL
│ │ │ │ -00006a10: 2c0a 0963 7265 616c 6d09 095b 335d 2052  ,..crealm..[3] R
│ │ │ │ -00006a20: 6561 6c6d 2c0a 0963 6e61 6d65 0909 5b34  ealm,..cname..[4
│ │ │ │ -00006a30: 5d20 5072 696e 6369 7061 6c4e 616d 652c  ] PrincipalName,
│ │ │ │ -00006a40: 0a09 7469 636b 6574 0909 5b35 5d20 5469  ..ticket..[5] Ti
│ │ │ │ -00006a50: 636b 6574 2c0a 0965 6e63 2d70 6172 7409  cket,..enc-part.
│ │ │ │ -00006a60: 5b36 5d20 456e 6372 7970 7465 6444 6174  [6] EncryptedDat
│ │ │ │ -00006a70: 6120 7b54 7970 6554 6f45 6e63 7279 7074  a {TypeToEncrypt
│ │ │ │ -00006a80: 2c20 4b65 7955 7361 6765 737d 0a7d 0a0a  , KeyUsages}.}..
│ │ │ │ -00006a90: 456e 6341 5352 6570 5061 7274 093a 3a3d  EncASRepPart.::=
│ │ │ │ -00006aa0: 205b 4150 504c 4943 4154 494f 4e20 3235   [APPLICATION 25
│ │ │ │ -00006ab0: 5d20 456e 634b 4443 5265 7050 6172 740a  ] EncKDCRepPart.
│ │ │ │ -00006ac0: 456e 6354 4753 5265 7050 6172 7409 3a3a  EncTGSRepPart.::
│ │ │ │ -00006ad0: 3d20 5b41 5050 4c49 4341 5449 4f4e 2032  = [APPLICATION 2
│ │ │ │ -00006ae0: 365d 2045 6e63 4b44 4352 6570 5061 7274  6] EncKDCRepPart
│ │ │ │ -00006af0: 0a0a 456e 634b 4443 5265 7050 6172 7409  ..EncKDCRepPart.
│ │ │ │ -00006b00: 3a3a 3d20 5345 5155 454e 4345 207b 0a09  ::= SEQUENCE {..
│ │ │ │ -00006b10: 6b65 7909 095b 305d 2045 6e63 7279 7074  key..[0] Encrypt
│ │ │ │ -00006b20: 696f 6e4b 6579 2c0a 096c 6173 742d 7265  ionKey,..last-re
│ │ │ │ -00006b30: 7109 5b31 5d20 4c61 7374 5265 712c 0a09  q.[1] LastReq,..
│ │ │ │ -00006b40: 6e6f 6e63 6509 095b 325d 2055 496e 7433  nonce..[2] UInt3
│ │ │ │ -00006b50: 322c 0a09 6b65 792d 6578 7069 7261 7469  2,..key-expirati
│ │ │ │ -00006b60: 6f6e 095b 335d 204b 6572 6265 726f 7354  on.[3] KerberosT
│ │ │ │ -00006b70: 696d 6520 4f50 5449 4f4e 414c 2c0a 0966  ime OPTIONAL,..f
│ │ │ │ -00006b80: 6c61 6773 0909 5b34 5d20 5469 636b 6574  lags..[4] Ticket
│ │ │ │ -00006b90: 466c 6167 732c 0a09 6175 7468 7469 6d65  Flags,..authtime
│ │ │ │ -00006ba0: 095b 355d 204b 6572 6265 726f 7354 696d  .[5] KerberosTim
│ │ │ │ -00006bb0: 652c 0a09 7374 6172 7474 696d 6509 5b36  e,..starttime.[6
│ │ │ │ -00006bc0: 5d20 4b65 7262 6572 6f73 5469 6d65 204f  ] KerberosTime O
│ │ │ │ -00006bd0: 5054 494f 4e41 4c2c 0a09 656e 6474 696d  PTIONAL,..endtim
│ │ │ │ -00006be0: 6509 095b 375d 204b 6572 6265 726f 7354  e..[7] KerberosT
│ │ │ │ -00006bf0: 696d 652c 0a09 7265 6e65 772d 7469 6c6c  ime,..renew-till
│ │ │ │ -00006c00: 095b 385d 204b 6572 6265 726f 7354 696d  .[8] KerberosTim
│ │ │ │ -00006c10: 6520 4f50 5449 4f4e 414c 2c0a 0973 7265  e OPTIONAL,..sre
│ │ │ │ -00006c20: 616c 6d09 095b 395d 2052 6561 6c6d 2c0a  alm..[9] Realm,.
│ │ │ │ -00006c30: 0973 6e61 6d65 0909 5b31 305d 2050 7269  .sname..[10] Pri
│ │ │ │ -00006c40: 6e63 6970 616c 4e61 6d65 2c0a 0963 6164  ncipalName,..cad
│ │ │ │ -00006c50: 6472 0909 5b31 315d 2048 6f73 7441 6464  dr..[11] HostAdd
│ │ │ │ -00006c60: 7265 7373 6573 204f 5054 494f 4e41 4c0a  resses OPTIONAL.
│ │ │ │ -00006c70: 7d0a 0a73 6869 7368 695f 6173 5f64 6572  }..shishi_as_der
│ │ │ │ -00006c80: 6976 655f 7361 6c74 0a2d 2d2d 2d2d 2d2d  ive_salt.-------
│ │ │ │ -00006c90: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -00006ca0: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ -00006cb0: 7420 7368 6973 6869 5f61 735f 6465 7269  t shishi_as_deri
│ │ │ │ -00006cc0: 7665 5f73 616c 7420 2853 6869 7368 6920  ve_salt (Shishi 
│ │ │ │ -00006cd0: 2a20 4841 4e44 4c45 2c0a 2020 2020 2020  * HANDLE,.      
│ │ │ │ -00006ce0: 2020 2020 5368 6973 6869 5f61 736e 3120      Shishi_asn1 
│ │ │ │ -00006cf0: 4153 5245 512c 2053 6869 7368 695f 6173  ASREQ, Shishi_as
│ │ │ │ -00006d00: 6e31 2041 5352 4550 2c20 6368 6172 202a  n1 ASREP, char *
│ │ │ │ -00006d10: 2a20 5341 4c54 2c0a 2020 2020 2020 2020  * SALT,.        
│ │ │ │ -00006d20: 2020 7369 7a65 5f74 202a 2053 414c 544c    size_t * SALTL
│ │ │ │ -00006d30: 454e 290a 2020 2020 2048 414e 444c 453a  EN).     HANDLE:
│ │ │ │ -00006d40: 2053 6869 7368 6920 6861 6e64 6c65 2061   Shishi handle a
│ │ │ │ -00006d50: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ -00006d60: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ -00006d70: 8099 2e0a 2020 2020 2041 5352 4551 3a20  ....     ASREQ: 
│ │ │ │ -00006d80: 496e 7075 7420 4153 2d52 4551 2076 6172  Input AS-REQ var
│ │ │ │ -00006d90: 6961 626c 652e 0a20 2020 2020 4153 5245  iable..     ASRE
│ │ │ │ -00006da0: 503a 2049 6e70 7574 2041 532d 5245 5020  P: Input AS-REP 
│ │ │ │ -00006db0: 7661 7269 6162 6c65 2e0a 2020 2020 2053  variable..     S
│ │ │ │ -00006dc0: 414c 543a 2052 6574 7572 6e65 6420 706f  ALT: Returned po
│ │ │ │ -00006dd0: 696e 7465 7220 746f 206e 6577 6c79 2061  inter to newly a
│ │ │ │ -00006de0: 6c6c 6f63 6174 6564 206f 7574 7075 7420  llocated output 
│ │ │ │ -00006df0: 6172 7261 792e 0a20 2020 2020 5341 4c54  array..     SALT
│ │ │ │ -00006e00: 4c45 4e3a 2050 6f69 6e74 6572 2074 6f20  LEN: Pointer to 
│ │ │ │ -00006e10: 696e 7465 6765 722c 2072 6574 7572 6e69  integer, returni
│ │ │ │ -00006e20: 6e67 2073 697a 6520 6f66 206f 7574 7075  ng size of outpu
│ │ │ │ -00006e30: 7420 6172 7261 792e 0a0a 2020 2020 202a  t array...     *
│ │ │ │ -00006e40: 4465 7363 7269 7074 696f 6e3a 2a20 436f  Description:* Co
│ │ │ │ -00006e50: 6d70 7574 6573 2074 6865 2073 616c 7420  mputes the salt 
│ │ │ │ -00006e60: 7468 6174 2073 686f 756c 6420 6265 2075  that should be u
│ │ │ │ -00006e70: 7365 6420 7768 656e 2064 6572 6976 696e  sed when derivin
│ │ │ │ -00006e80: 670a 2020 2020 2061 206b 6579 2076 6961  g.     a key via
│ │ │ │ -00006e90: 20e2 8098 7368 6973 6869 5f73 7472 696e   ...shishi_strin
│ │ │ │ -00006ea0: 675f 746f 5f6b 6579 2829 e280 9920 666f  g_to_key()... fo
│ │ │ │ -00006eb0: 7220 616e 2041 5320 6578 6368 616e 6765  r an AS exchange
│ │ │ │ -00006ec0: 2e20 2043 7572 7265 6e74 6c79 0a20 2020  .  Currently.   
│ │ │ │ -00006ed0: 2020 7468 6973 2073 6561 7263 6865 7320    this searches 
│ │ │ │ -00006ee0: 666f 7220 5041 2d44 4154 4120 6f66 2074  for PA-DATA of t
│ │ │ │ -00006ef0: 7970 6520 e280 9853 4849 5348 495f 5041  ype ...SHISHI_PA
│ │ │ │ -00006f00: 5f50 575f 5341 4c54 e280 9920 696e 2074  _PW_SALT... in t
│ │ │ │ -00006f10: 6865 2041 532d 5245 500a 2020 2020 2070  he AS-REP.     p
│ │ │ │ -00006f20: 726f 7669 6465 6420 6279 2041 5352 4550  rovided by ASREP
│ │ │ │ -00006f30: 2c20 616e 6420 6966 2070 7265 7365 6e74  , and if present
│ │ │ │ -00006f40: 2072 6574 7572 6e73 2069 742e 2020 4f74   returns it.  Ot
│ │ │ │ -00006f50: 6865 7277 6973 6520 7468 6520 7361 6c74  herwise the salt
│ │ │ │ -00006f60: 0a20 2020 2020 6973 2063 6f6d 706f 7365  .     is compose
│ │ │ │ -00006f70: 6420 6672 6f6d 2074 6865 2063 6c69 656e  d from the clien
│ │ │ │ -00006f80: 7420 6e61 6d65 2061 6e64 2074 6865 2072  t name and the r
│ │ │ │ -00006f90: 6561 6c6d 2c20 626f 7468 2061 7265 2065  ealm, both are e
│ │ │ │ -00006fa0: 7874 7261 6374 6564 0a20 2020 2020 6672  xtracted.     fr
│ │ │ │ -00006fb0: 6f6d 2074 6865 2072 6571 7565 7374 2041  om the request A
│ │ │ │ -00006fc0: 5352 4551 2e0a 0a20 2020 2020 2a52 6574  SREQ...     *Ret
│ │ │ │ -00006fd0: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ -00006fe0: 726e 7320 e280 9853 4849 5348 495f 4f4b  rns ...SHISHI_OK
│ │ │ │ -00006ff0: e280 9920 6966 2073 7563 6365 7373 6675  ... if successfu
│ │ │ │ -00007000: 6c2e 2020 4661 696c 7572 650a 2020 2020  l.  Failure.    
│ │ │ │ -00007010: 2063 6f6e 6469 7469 6f6e 7320 696e 636c   conditions incl
│ │ │ │ -00007020: 7564 6520 7661 7269 6f75 7320 4153 4e2e  ude various ASN.
│ │ │ │ -00007030: 3120 6973 7375 6573 2e0a 0a73 6869 7368  1 issues...shish
│ │ │ │ -00007040: 695f 6b64 6372 6571 5f73 656e 6472 6563  i_kdcreq_sendrec
│ │ │ │ -00007050: 765f 6869 6e74 0a2d 2d2d 2d2d 2d2d 2d2d  v_hint.---------
│ │ │ │ +00005ce0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +00005cf0: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ +00005d00: 6e74 2073 6869 7368 695f 656e 6374 6963  nt shishi_enctic
│ │ │ │ +00005d10: 6b65 7470 6172 745f 636c 6965 6e74 7265  ketpart_clientre
│ │ │ │ +00005d20: 616c 6d20 2853 6869 7368 6920 2a20 4841  alm (Shishi * HA
│ │ │ │ +00005d30: 4e44 4c45 2c0a 2020 2020 2020 2020 2020  NDLE,.          
│ │ │ │ +00005d40: 5368 6973 6869 5f61 736e 3120 454e 4354  Shishi_asn1 ENCT
│ │ │ │ +00005d50: 4943 4b45 5450 4152 542c 2063 6861 7220  ICKETPART, char 
│ │ │ │ +00005d60: 2a2a 2043 4c49 454e 542c 2073 697a 655f  ** CLIENT, size_
│ │ │ │ +00005d70: 7420 2a20 434c 4945 4e54 4c45 4e29 0a20  t * CLIENTLEN). 
│ │ │ │ +00005d80: 2020 2020 4841 4e44 4c45 3a20 5368 6973      HANDLE: Shis
│ │ │ │ +00005d90: 6869 206c 6962 7261 7279 2068 616e 646c  hi library handl
│ │ │ │ +00005da0: 6520 6372 6561 7465 2062 7920 e280 9873  e create by ...s
│ │ │ │ +00005db0: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ +00005dc0: 0a20 2020 2020 454e 4354 4943 4b45 5450  .     ENCTICKETP
│ │ │ │ +00005dd0: 4152 543a 2045 6e63 5469 636b 6574 5061  ART: EncTicketPa
│ │ │ │ +00005de0: 7274 2076 6172 6961 626c 6520 746f 2067  rt variable to g
│ │ │ │ +00005df0: 6574 2063 6c69 656e 7420 6e61 6d65 2061  et client name a
│ │ │ │ +00005e00: 6e64 2072 6561 6c6d 0a20 2020 2020 6672  nd realm.     fr
│ │ │ │ +00005e10: 6f6d 2e0a 2020 2020 2043 4c49 454e 543a  om..     CLIENT:
│ │ │ │ +00005e20: 2070 6f69 6e74 6572 2074 6f20 6e65 776c   pointer to newl
│ │ │ │ +00005e30: 7920 616c 6c6f 6361 7465 6420 7a65 726f  y allocated zero
│ │ │ │ +00005e40: 2074 6572 6d69 6e61 7465 6420 7374 7269   terminated stri
│ │ │ │ +00005e50: 6e67 0a20 2020 2020 636f 6e74 6169 6e69  ng.     containi
│ │ │ │ +00005e60: 6e67 2070 7269 6e63 6970 616c 206e 616d  ng principal nam
│ │ │ │ +00005e70: 6520 616e 6420 7265 616c 6d2e 2020 4d61  e and realm.  Ma
│ │ │ │ +00005e80: 7920 6265 20e2 8098 4e55 4c4c e280 9920  y be ...NULL... 
│ │ │ │ +00005e90: 2874 6f20 6f6e 6c79 0a20 2020 2020 706f  (to only.     po
│ │ │ │ +00005ea0: 7075 6c61 7465 2043 4c49 454e 544c 454e  pulate CLIENTLEN
│ │ │ │ +00005eb0: 292e 0a20 2020 2020 434c 4945 4e54 4c45  )..     CLIENTLE
│ │ │ │ +00005ec0: 4e3a 2070 6f69 6e74 6572 2074 6f20 6c65  N: pointer to le
│ │ │ │ +00005ed0: 6e67 7468 206f 6620 434c 4945 4e54 206f  ngth of CLIENT o
│ │ │ │ +00005ee0: 6e20 6f75 7470 7574 2c20 6578 636c 7564  n output, exclud
│ │ │ │ +00005ef0: 696e 670a 2020 2020 2074 6572 6d69 6e61  ing.     termina
│ │ │ │ +00005f00: 7469 6e67 207a 6572 6f2e 2020 4d61 7920  ting zero.  May 
│ │ │ │ +00005f10: 6265 20e2 8098 4e55 4c4c e280 9920 2874  be ...NULL... (t
│ │ │ │ +00005f20: 6f20 6f6e 6c79 2070 6f70 756c 6174 6520  o only populate 
│ │ │ │ +00005f30: 434c 4945 4e54 292e 0a0a 2020 2020 202a  CLIENT)...     *
│ │ │ │ +00005f40: 4465 7363 7269 7074 696f 6e3a 2a20 436f  Description:* Co
│ │ │ │ +00005f50: 6e76 6572 7420 636e 616d 6520 616e 6420  nvert cname and 
│ │ │ │ +00005f60: 7265 616c 6d20 6669 656c 6473 2066 726f  realm fields fro
│ │ │ │ +00005f70: 6d20 456e 6354 6963 6b65 7450 6172 7420  m EncTicketPart 
│ │ │ │ +00005f80: 746f 0a20 2020 2020 7072 696e 7461 626c  to.     printabl
│ │ │ │ +00005f90: 6520 7072 696e 6369 7061 6c20 6e61 6d65  e principal name
│ │ │ │ +00005fa0: 2066 6f72 6d61 742e 2020 5468 6520 7374   format.  The st
│ │ │ │ +00005fb0: 7269 6e67 2069 7320 616c 6c6f 6361 7465  ring is allocate
│ │ │ │ +00005fc0: 2062 7920 7468 6973 0a20 2020 2020 6675   by this.     fu
│ │ │ │ +00005fd0: 6e63 7469 6f6e 2c20 616e 6420 6974 2069  nction, and it i
│ │ │ │ +00005fe0: 7320 7468 6520 7265 7370 6f6e 7369 6269  s the responsibi
│ │ │ │ +00005ff0: 6c69 7479 206f 6620 7468 6520 6361 6c6c  lity of the call
│ │ │ │ +00006000: 6572 2074 6f20 6465 616c 6c6f 6361 7465  er to deallocate
│ │ │ │ +00006010: 0a20 2020 2020 6974 2e20 204e 6f74 6520  .     it.  Note 
│ │ │ │ +00006020: 7468 6174 2074 6865 206f 7574 7075 7420  that the output 
│ │ │ │ +00006030: 6c65 6e67 7468 2043 4c49 454e 544c 454e  length CLIENTLEN
│ │ │ │ +00006040: 2064 6f65 7320 6e6f 7420 696e 636c 7564   does not includ
│ │ │ │ +00006050: 6520 7468 650a 2020 2020 2074 6572 6d69  e the.     termi
│ │ │ │ +00006060: 6e61 7469 6e67 207a 6572 6f2e 0a0a 2020  nating zero...  
│ │ │ │ +00006070: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ +00006080: 3a2a 2052 6574 7572 6e73 2053 4849 5348  :* Returns SHISH
│ │ │ │ +00006090: 495f 4f4b 2069 6666 2073 7563 6365 7373  I_OK iff success
│ │ │ │ +000060a0: 6675 6c2e 0a0a 1f0a 4669 6c65 3a20 7368  ful.....File: sh
│ │ │ │ +000060b0: 6973 6869 2e69 6e66 6f2c 2020 4e6f 6465  ishi.info,  Node
│ │ │ │ +000060c0: 3a20 4153 2f54 4753 2046 756e 6374 696f  : AS/TGS Functio
│ │ │ │ +000060d0: 6e73 2c20 204e 6578 743a 2041 7574 6865  ns,  Next: Authe
│ │ │ │ +000060e0: 6e74 6963 6174 6f72 2046 756e 6374 696f  nticator Functio
│ │ │ │ +000060f0: 6e73 2c20 2050 7265 763a 2054 6963 6b65  ns,  Prev: Ticke
│ │ │ │ +00006100: 7420 2841 534e 2e31 2920 4675 6e63 7469  t (ASN.1) Functi
│ │ │ │ +00006110: 6f6e 732c 2020 5570 3a20 5072 6f67 7261  ons,  Up: Progra
│ │ │ │ +00006120: 6d6d 696e 6720 4d61 6e75 616c 0a0a 352e  mming Manual..5.
│ │ │ │ +00006130: 3130 2041 532f 5447 5320 4675 6e63 7469  10 AS/TGS Functi
│ │ │ │ +00006140: 6f6e 730a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ons.============
│ │ │ │ +00006150: 3d3d 3d3d 3d3d 3d3d 3d0a 0a54 6865 2041  =========..The A
│ │ │ │ +00006160: 7574 6865 6e74 6963 6174 696f 6e20 5365  uthentication Se
│ │ │ │ +00006170: 7276 6963 6520 2841 5329 2069 7320 7573  rvice (AS) is us
│ │ │ │ +00006180: 6564 2074 6f20 6765 7420 616e 2069 6e69  ed to get an ini
│ │ │ │ +00006190: 7469 616c 2074 6963 6b65 7420 7573 696e  tial ticket usin
│ │ │ │ +000061a0: 670a 652e 672e 2020 796f 7572 2070 6173  g.e.g.  your pas
│ │ │ │ +000061b0: 7377 6f72 642e 2020 5468 6520 5469 636b  sword.  The Tick
│ │ │ │ +000061c0: 6574 2047 7261 6e74 696e 6720 5365 7276  et Granting Serv
│ │ │ │ +000061d0: 6963 6520 2854 4753 2920 6973 2075 7365  ice (TGS) is use
│ │ │ │ +000061e0: 6420 746f 2067 6574 0a73 7562 7365 7175  d to get.subsequ
│ │ │ │ +000061f0: 656e 7420 7469 636b 6574 7320 7573 696e  ent tickets usin
│ │ │ │ +00006200: 6720 6f74 6865 7220 7469 636b 6574 732e  g other tickets.
│ │ │ │ +00006210: 2020 5072 6f74 6f63 6f6c 2077 6973 6520    Protocol wise 
│ │ │ │ +00006220: 7468 6520 7072 6f63 6564 7572 6573 0a61  the procedures.a
│ │ │ │ +00006230: 7265 2076 6572 7920 7369 6d69 6c61 722c  re very similar,
│ │ │ │ +00006240: 2077 6869 6368 2069 7320 7468 6520 7265   which is the re
│ │ │ │ +00006250: 6173 6f6e 2074 6865 7920 6172 6520 6465  ason they are de
│ │ │ │ +00006260: 7363 7269 6265 6420 746f 6765 7468 6572  scribed together
│ │ │ │ +00006270: 2e20 2054 6865 0a66 6f6c 6c6f 7769 6e67  .  The.following
│ │ │ │ +00006280: 2069 6c6c 7573 7472 6174 6573 2074 6865   illustrates the
│ │ │ │ +00006290: 2041 532d 5245 512c 2054 4753 2d52 4551   AS-REQ, TGS-REQ
│ │ │ │ +000062a0: 2061 6e64 2041 532d 5245 502c 2054 4753   and AS-REP, TGS
│ │ │ │ +000062b0: 2d52 4550 2041 534e 2e31 0a73 7472 7563  -REP ASN.1.struc
│ │ │ │ +000062c0: 7475 7265 732e 2020 4d6f 7374 206f 6620  tures.  Most of 
│ │ │ │ +000062d0: 7468 6520 6675 6e63 7469 6f6e 7320 7573  the functions us
│ │ │ │ +000062e0: 6520 7468 6520 6d6e 656d 6f6e 6963 2022  e the mnemonic "
│ │ │ │ +000062f0: 4b44 4322 2069 6e73 7465 6164 206f 660a  KDC" instead of.
│ │ │ │ +00006300: 6569 7468 6572 2041 5320 6f72 2054 4753  either AS or TGS
│ │ │ │ +00006310: 2c20 7768 6963 6820 6d65 616e 7320 7468  , which means th
│ │ │ │ +00006320: 6520 6675 6e63 7469 6f6e 206f 7065 7261  e function opera
│ │ │ │ +00006330: 7465 7320 6f6e 2062 6f74 6820 4153 2061  tes on both AS a
│ │ │ │ +00006340: 6e64 2054 4753 0a74 7970 6573 2e20 204f  nd TGS.types.  O
│ │ │ │ +00006350: 6e6c 7920 7768 6572 6520 7468 6520 6469  nly where the di
│ │ │ │ +00006360: 7374 696e 6374 696f 6e20 6265 7477 6565  stinction betwee
│ │ │ │ +00006370: 6e20 4153 2061 6e64 2054 4753 2069 7320  n AS and TGS is 
│ │ │ │ +00006380: 696d 706f 7274 616e 7420 6172 650a 7468  important are.th
│ │ │ │ +00006390: 6520 4153 2061 6e64 2054 4753 206e 616d  e AS and TGS nam
│ │ │ │ +000063a0: 6573 2075 7365 642e 2020 5265 6d65 6d62  es used.  Rememb
│ │ │ │ +000063b0: 6572 2c20 7468 6573 6520 6172 6520 6c6f  er, these are lo
│ │ │ │ +000063c0: 772d 6c65 7665 6c20 6675 6e63 7469 6f6e  w-level function
│ │ │ │ +000063d0: 732c 2061 6e64 0a6e 6f72 6d61 6c20 6170  s, and.normal ap
│ │ │ │ +000063e0: 706c 6963 6174 696f 6e73 2077 696c 6c20  plications will 
│ │ │ │ +000063f0: 6c69 6b65 6c79 2062 6520 7361 7469 7366  likely be satisf
│ │ │ │ +00006400: 6965 6420 7769 7468 2074 6865 2041 5320  ied with the AS 
│ │ │ │ +00006410: 282a 6e6f 7465 2041 530a 4675 6e63 7469  (*note AS.Functi
│ │ │ │ +00006420: 6f6e 733a 3a29 2061 6e64 2054 4753 2028  ons::) and TGS (
│ │ │ │ +00006430: 2a6e 6f74 6520 5447 5320 4675 6e63 7469  *note TGS Functi
│ │ │ │ +00006440: 6f6e 733a 3a29 2069 6e74 6572 6661 6365  ons::) interface
│ │ │ │ +00006450: 732c 206f 7220 7468 6520 6576 656e 0a6d  s, or the even.m
│ │ │ │ +00006460: 6f72 6520 6869 6768 2d6c 6576 656c 2054  ore high-level T
│ │ │ │ +00006470: 6963 6b65 7420 5365 7420 282a 6e6f 7465  icket Set (*note
│ │ │ │ +00006480: 2054 6963 6b65 7420 5365 7420 4675 6e63   Ticket Set Func
│ │ │ │ +00006490: 7469 6f6e 733a 3a29 2069 6e74 6572 6661  tions::) interfa
│ │ │ │ +000064a0: 6365 2e0a 0a2d 2d20 5265 7175 6573 7420  ce...-- Request 
│ │ │ │ +000064b0: 2d2d 0a0a 4153 2d52 4551 0909 3a3a 3d20  --..AS-REQ..::= 
│ │ │ │ +000064c0: 4b44 432d 5245 5120 7b31 307d 0a54 4753  KDC-REQ {10}.TGS
│ │ │ │ +000064d0: 2d52 4551 0909 3a3a 3d20 4b44 432d 5245  -REQ..::= KDC-RE
│ │ │ │ +000064e0: 5120 7b31 327d 0a0a 4b44 432d 5245 5120  Q {12}..KDC-REQ 
│ │ │ │ +000064f0: 7b49 4e54 4547 4552 3a74 6167 6e75 6d7d  {INTEGER:tagnum}
│ │ │ │ +00006500: 093a 3a3d 205b 4150 504c 4943 4154 494f  .::= [APPLICATIO
│ │ │ │ +00006510: 4e20 7461 676e 756d 5d20 5345 5155 454e  N tagnum] SEQUEN
│ │ │ │ +00006520: 4345 207b 0a09 7076 6e6f 0909 5b31 5d20  CE {..pvno..[1] 
│ │ │ │ +00006530: 494e 5445 4745 5220 2835 2920 2d2d 2066  INTEGER (5) -- f
│ │ │ │ +00006540: 6972 7374 2074 6167 2069 7320 5b31 5d2c  irst tag is [1],
│ │ │ │ +00006550: 206e 6f74 205b 305d 202d 2d2c 0a09 6d73   not [0] --,..ms
│ │ │ │ +00006560: 672d 7479 7065 095b 325d 2049 4e54 4547  g-type.[2] INTEG
│ │ │ │ +00006570: 4552 2028 7461 676e 756d 292c 0a09 7061  ER (tagnum),..pa
│ │ │ │ +00006580: 6461 7461 0909 5b33 5d20 5345 5155 454e  data..[3] SEQUEN
│ │ │ │ +00006590: 4345 204f 4620 5041 2d44 4154 4120 4f50  CE OF PA-DATA OP
│ │ │ │ +000065a0: 5449 4f4e 414c 2c0a 0972 6571 2d62 6f64  TIONAL,..req-bod
│ │ │ │ +000065b0: 7909 5b34 5d20 4b44 432d 5245 512d 424f  y.[4] KDC-REQ-BO
│ │ │ │ +000065c0: 4459 0a7d 0a0a 4b44 432d 5245 512d 424f  DY.}..KDC-REQ-BO
│ │ │ │ +000065d0: 4459 093a 3a3d 2053 4551 5545 4e43 4520  DY.::= SEQUENCE 
│ │ │ │ +000065e0: 7b0a 096b 6463 2d6f 7074 696f 6e73 0909  {..kdc-options..
│ │ │ │ +000065f0: 5b30 5d20 4b44 434f 7074 696f 6e73 2c0a  [0] KDCOptions,.
│ │ │ │ +00006600: 0963 6e61 6d65 0909 095b 315d 2050 7269  .cname...[1] Pri
│ │ │ │ +00006610: 6e63 6970 616c 4e61 6d65 204f 5054 494f  ncipalName OPTIO
│ │ │ │ +00006620: 4e41 4c0a 0909 0909 2020 2020 2d2d 2055  NAL.....    -- U
│ │ │ │ +00006630: 7365 6420 6f6e 6c79 2069 6e20 4153 2d52  sed only in AS-R
│ │ │ │ +00006640: 4551 202d 2d2c 0a09 7265 616c 6d09 0909  EQ --,..realm...
│ │ │ │ +00006650: 5b32 5d20 5265 616c 6d0a 0909 0909 2020  [2] Realm.....  
│ │ │ │ +00006660: 2020 2d2d 2053 6572 7665 7227 7320 7265    -- Server's re
│ │ │ │ +00006670: 616c 6d0a 0909 0909 2020 2020 2d2d 2041  alm.....    -- A
│ │ │ │ +00006680: 6c73 6f20 636c 6965 6e74 2773 2069 6e20  lso client's in 
│ │ │ │ +00006690: 4153 2d52 4551 202d 2d2c 0a09 736e 616d  AS-REQ --,..snam
│ │ │ │ +000066a0: 6509 0909 5b33 5d20 5072 696e 6369 7061  e...[3] Principa
│ │ │ │ +000066b0: 6c4e 616d 6520 4f50 5449 4f4e 414c 2c0a  lName OPTIONAL,.
│ │ │ │ +000066c0: 0966 726f 6d09 0909 5b34 5d20 4b65 7262  .from...[4] Kerb
│ │ │ │ +000066d0: 6572 6f73 5469 6d65 204f 5054 494f 4e41  erosTime OPTIONA
│ │ │ │ +000066e0: 4c2c 0a09 7469 6c6c 0909 095b 355d 204b  L,..till...[5] K
│ │ │ │ +000066f0: 6572 6265 726f 7354 696d 652c 0a09 7274  erberosTime,..rt
│ │ │ │ +00006700: 696d 6509 0909 5b36 5d20 4b65 7262 6572  ime...[6] Kerber
│ │ │ │ +00006710: 6f73 5469 6d65 204f 5054 494f 4e41 4c2c  osTime OPTIONAL,
│ │ │ │ +00006720: 0a09 6e6f 6e63 6509 0909 5b37 5d20 5549  ..nonce...[7] UI
│ │ │ │ +00006730: 6e74 3332 2c0a 0965 7479 7065 0909 095b  nt32,..etype...[
│ │ │ │ +00006740: 385d 2053 4551 5545 4e43 4520 4f46 2049  8] SEQUENCE OF I
│ │ │ │ +00006750: 6e74 3332 202d 2d20 456e 6372 7970 7469  nt32 -- Encrypti
│ │ │ │ +00006760: 6f6e 5479 7065 0a09 0909 0920 2020 202d  onType.....    -
│ │ │ │ +00006770: 2d20 696e 2070 7265 6665 7265 6e63 6520  - in preference 
│ │ │ │ +00006780: 6f72 6465 7220 2d2d 2c0a 0961 6464 7265  order --,..addre
│ │ │ │ +00006790: 7373 6573 0909 5b39 5d20 486f 7374 4164  sses..[9] HostAd
│ │ │ │ +000067a0: 6472 6573 7365 7320 4f50 5449 4f4e 414c  dresses OPTIONAL
│ │ │ │ +000067b0: 2c0a 0965 6e63 2d61 7574 686f 7269 7a61  ,..enc-authoriza
│ │ │ │ +000067c0: 7469 6f6e 2d64 6174 6109 5b31 305d 2045  tion-data.[10] E
│ │ │ │ +000067d0: 6e63 7279 7074 6564 4461 7461 207b 0a09  ncryptedData {..
│ │ │ │ +000067e0: 0909 0909 4175 7468 6f72 697a 6174 696f  ....Authorizatio
│ │ │ │ +000067f0: 6e44 6174 612c 0a09 0909 0909 7b20 6b65  nData,......{ ke
│ │ │ │ +00006800: 7975 7365 2d54 4753 5265 7141 7574 6844  yuse-TGSReqAuthD
│ │ │ │ +00006810: 6174 612d 7365 7373 6b65 790a 0909 0909  ata-sesskey.....
│ │ │ │ +00006820: 0920 207c 206b 6579 7573 652d 5447 5352  .  | keyuse-TGSR
│ │ │ │ +00006830: 6571 4175 7468 4461 7461 2d73 7562 6b65  eqAuthData-subke
│ │ │ │ +00006840: 7920 7d0a 0909 0909 2020 2020 207d 204f  y }.....     } O
│ │ │ │ +00006850: 5054 494f 4e41 4c2c 0a09 6164 6469 7469  PTIONAL,..additi
│ │ │ │ +00006860: 6f6e 616c 2d74 6963 6b65 7473 095b 3131  onal-tickets.[11
│ │ │ │ +00006870: 5d20 5345 5155 454e 4345 204f 4620 5469  ] SEQUENCE OF Ti
│ │ │ │ +00006880: 636b 6574 204f 5054 494f 4e41 4c0a 7d0a  cket OPTIONAL.}.
│ │ │ │ +00006890: 0a2d 2d20 5265 706c 7920 2d2d 0a0a 4153  .-- Reply --..AS
│ │ │ │ +000068a0: 2d52 4550 0909 3a3a 3d20 4b44 432d 5245  -REP..::= KDC-RE
│ │ │ │ +000068b0: 5020 7b31 312c 2045 6e63 4153 5265 7050  P {11, EncASRepP
│ │ │ │ +000068c0: 6172 742c 207b 6b65 7975 7365 2d45 6e63  art, {keyuse-Enc
│ │ │ │ +000068d0: 4153 5265 7050 6172 747d 7d0a 5447 532d  ASRepPart}}.TGS-
│ │ │ │ +000068e0: 5245 5009 093a 3a3d 204b 4443 2d52 4550  REP..::= KDC-REP
│ │ │ │ +000068f0: 207b 3133 2c20 456e 6354 4753 5265 7050   {13, EncTGSRepP
│ │ │ │ +00006900: 6172 742c 0a09 0909 7b20 6b65 7975 7365  art,....{ keyuse
│ │ │ │ +00006910: 2d45 6e63 5447 5352 6570 5061 7274 2d73  -EncTGSRepPart-s
│ │ │ │ +00006920: 6573 736b 6579 0a09 0909 2020 7c20 6b65  esskey....  | ke
│ │ │ │ +00006930: 7975 7365 2d45 6e63 5447 5352 6570 5061  yuse-EncTGSRepPa
│ │ │ │ +00006940: 7274 2d73 7562 6b65 7920 7d7d 0a0a 4b44  rt-subkey }}..KD
│ │ │ │ +00006950: 432d 5245 5020 7b49 4e54 4547 4552 3a74  C-REP {INTEGER:t
│ │ │ │ +00006960: 6167 6e75 6d2c 0a09 2054 7970 6554 6f45  agnum,.. TypeToE
│ │ │ │ +00006970: 6e63 7279 7074 2c0a 0920 5549 6e74 3332  ncrypt,.. UInt32
│ │ │ │ +00006980: 3a4b 6579 5573 6167 6573 7d09 3a3a 3d20  :KeyUsages}.::= 
│ │ │ │ +00006990: 5b41 5050 4c49 4341 5449 4f4e 2074 6167  [APPLICATION tag
│ │ │ │ +000069a0: 6e75 6d5d 2053 4551 5545 4e43 4520 7b0a  num] SEQUENCE {.
│ │ │ │ +000069b0: 0970 766e 6f09 095b 305d 2049 4e54 4547  .pvno..[0] INTEG
│ │ │ │ +000069c0: 4552 2028 3529 2c0a 096d 7367 2d74 7970  ER (5),..msg-typ
│ │ │ │ +000069d0: 6509 5b31 5d20 494e 5445 4745 5220 2874  e.[1] INTEGER (t
│ │ │ │ +000069e0: 6167 6e75 6d29 2c0a 0970 6164 6174 6109  agnum),..padata.
│ │ │ │ +000069f0: 095b 325d 2053 4551 5545 4e43 4520 4f46  .[2] SEQUENCE OF
│ │ │ │ +00006a00: 2050 412d 4441 5441 204f 5054 494f 4e41   PA-DATA OPTIONA
│ │ │ │ +00006a10: 4c2c 0a09 6372 6561 6c6d 0909 5b33 5d20  L,..crealm..[3] 
│ │ │ │ +00006a20: 5265 616c 6d2c 0a09 636e 616d 6509 095b  Realm,..cname..[
│ │ │ │ +00006a30: 345d 2050 7269 6e63 6970 616c 4e61 6d65  4] PrincipalName
│ │ │ │ +00006a40: 2c0a 0974 6963 6b65 7409 095b 355d 2054  ,..ticket..[5] T
│ │ │ │ +00006a50: 6963 6b65 742c 0a09 656e 632d 7061 7274  icket,..enc-part
│ │ │ │ +00006a60: 095b 365d 2045 6e63 7279 7074 6564 4461  .[6] EncryptedDa
│ │ │ │ +00006a70: 7461 207b 5479 7065 546f 456e 6372 7970  ta {TypeToEncryp
│ │ │ │ +00006a80: 742c 204b 6579 5573 6167 6573 7d0a 7d0a  t, KeyUsages}.}.
│ │ │ │ +00006a90: 0a45 6e63 4153 5265 7050 6172 7409 3a3a  .EncASRepPart.::
│ │ │ │ +00006aa0: 3d20 5b41 5050 4c49 4341 5449 4f4e 2032  = [APPLICATION 2
│ │ │ │ +00006ab0: 355d 2045 6e63 4b44 4352 6570 5061 7274  5] EncKDCRepPart
│ │ │ │ +00006ac0: 0a45 6e63 5447 5352 6570 5061 7274 093a  .EncTGSRepPart.:
│ │ │ │ +00006ad0: 3a3d 205b 4150 504c 4943 4154 494f 4e20  := [APPLICATION 
│ │ │ │ +00006ae0: 3236 5d20 456e 634b 4443 5265 7050 6172  26] EncKDCRepPar
│ │ │ │ +00006af0: 740a 0a45 6e63 4b44 4352 6570 5061 7274  t..EncKDCRepPart
│ │ │ │ +00006b00: 093a 3a3d 2053 4551 5545 4e43 4520 7b0a  .::= SEQUENCE {.
│ │ │ │ +00006b10: 096b 6579 0909 5b30 5d20 456e 6372 7970  .key..[0] Encryp
│ │ │ │ +00006b20: 7469 6f6e 4b65 792c 0a09 6c61 7374 2d72  tionKey,..last-r
│ │ │ │ +00006b30: 6571 095b 315d 204c 6173 7452 6571 2c0a  eq.[1] LastReq,.
│ │ │ │ +00006b40: 096e 6f6e 6365 0909 5b32 5d20 5549 6e74  .nonce..[2] UInt
│ │ │ │ +00006b50: 3332 2c0a 096b 6579 2d65 7870 6972 6174  32,..key-expirat
│ │ │ │ +00006b60: 696f 6e09 5b33 5d20 4b65 7262 6572 6f73  ion.[3] Kerberos
│ │ │ │ +00006b70: 5469 6d65 204f 5054 494f 4e41 4c2c 0a09  Time OPTIONAL,..
│ │ │ │ +00006b80: 666c 6167 7309 095b 345d 2054 6963 6b65  flags..[4] Ticke
│ │ │ │ +00006b90: 7446 6c61 6773 2c0a 0961 7574 6874 696d  tFlags,..authtim
│ │ │ │ +00006ba0: 6509 5b35 5d20 4b65 7262 6572 6f73 5469  e.[5] KerberosTi
│ │ │ │ +00006bb0: 6d65 2c0a 0973 7461 7274 7469 6d65 095b  me,..starttime.[
│ │ │ │ +00006bc0: 365d 204b 6572 6265 726f 7354 696d 6520  6] KerberosTime 
│ │ │ │ +00006bd0: 4f50 5449 4f4e 414c 2c0a 0965 6e64 7469  OPTIONAL,..endti
│ │ │ │ +00006be0: 6d65 0909 5b37 5d20 4b65 7262 6572 6f73  me..[7] Kerberos
│ │ │ │ +00006bf0: 5469 6d65 2c0a 0972 656e 6577 2d74 696c  Time,..renew-til
│ │ │ │ +00006c00: 6c09 5b38 5d20 4b65 7262 6572 6f73 5469  l.[8] KerberosTi
│ │ │ │ +00006c10: 6d65 204f 5054 494f 4e41 4c2c 0a09 7372  me OPTIONAL,..sr
│ │ │ │ +00006c20: 6561 6c6d 0909 5b39 5d20 5265 616c 6d2c  ealm..[9] Realm,
│ │ │ │ +00006c30: 0a09 736e 616d 6509 095b 3130 5d20 5072  ..sname..[10] Pr
│ │ │ │ +00006c40: 696e 6369 7061 6c4e 616d 652c 0a09 6361  incipalName,..ca
│ │ │ │ +00006c50: 6464 7209 095b 3131 5d20 486f 7374 4164  ddr..[11] HostAd
│ │ │ │ +00006c60: 6472 6573 7365 7320 4f50 5449 4f4e 414c  dresses OPTIONAL
│ │ │ │ +00006c70: 0a7d 0a0a 7368 6973 6869 5f61 735f 6465  .}..shishi_as_de
│ │ │ │ +00006c80: 7269 7665 5f73 616c 740a 2d2d 2d2d 2d2d  rive_salt.------
│ │ │ │ +00006c90: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +00006ca0: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ +00006cb0: 6e74 2073 6869 7368 695f 6173 5f64 6572  nt shishi_as_der
│ │ │ │ +00006cc0: 6976 655f 7361 6c74 2028 5368 6973 6869  ive_salt (Shishi
│ │ │ │ +00006cd0: 202a 2048 414e 444c 452c 0a20 2020 2020   * HANDLE,.     
│ │ │ │ +00006ce0: 2020 2020 2053 6869 7368 695f 6173 6e31       Shishi_asn1
│ │ │ │ +00006cf0: 2041 5352 4551 2c20 5368 6973 6869 5f61   ASREQ, Shishi_a
│ │ │ │ +00006d00: 736e 3120 4153 5245 502c 2063 6861 7220  sn1 ASREP, char 
│ │ │ │ +00006d10: 2a2a 2053 414c 542c 0a20 2020 2020 2020  ** SALT,.       
│ │ │ │ +00006d20: 2020 2073 697a 655f 7420 2a20 5341 4c54     size_t * SALT
│ │ │ │ +00006d30: 4c45 4e29 0a20 2020 2020 4841 4e44 4c45  LEN).     HANDLE
│ │ │ │ +00006d40: 3a20 5368 6973 6869 2068 616e 646c 6520  : Shishi handle 
│ │ │ │ +00006d50: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ +00006d60: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ +00006d70: e280 992e 0a20 2020 2020 4153 5245 513a  .....     ASREQ:
│ │ │ │ +00006d80: 2049 6e70 7574 2041 532d 5245 5120 7661   Input AS-REQ va
│ │ │ │ +00006d90: 7269 6162 6c65 2e0a 2020 2020 2041 5352  riable..     ASR
│ │ │ │ +00006da0: 4550 3a20 496e 7075 7420 4153 2d52 4550  EP: Input AS-REP
│ │ │ │ +00006db0: 2076 6172 6961 626c 652e 0a20 2020 2020   variable..     
│ │ │ │ +00006dc0: 5341 4c54 3a20 5265 7475 726e 6564 2070  SALT: Returned p
│ │ │ │ +00006dd0: 6f69 6e74 6572 2074 6f20 6e65 776c 7920  ointer to newly 
│ │ │ │ +00006de0: 616c 6c6f 6361 7465 6420 6f75 7470 7574  allocated output
│ │ │ │ +00006df0: 2061 7272 6179 2e0a 2020 2020 2053 414c   array..     SAL
│ │ │ │ +00006e00: 544c 454e 3a20 506f 696e 7465 7220 746f  TLEN: Pointer to
│ │ │ │ +00006e10: 2069 6e74 6567 6572 2c20 7265 7475 726e   integer, return
│ │ │ │ +00006e20: 696e 6720 7369 7a65 206f 6620 6f75 7470  ing size of outp
│ │ │ │ +00006e30: 7574 2061 7272 6179 2e0a 0a20 2020 2020  ut array...     
│ │ │ │ +00006e40: 2a44 6573 6372 6970 7469 6f6e 3a2a 2043  *Description:* C
│ │ │ │ +00006e50: 6f6d 7075 7465 7320 7468 6520 7361 6c74  omputes the salt
│ │ │ │ +00006e60: 2074 6861 7420 7368 6f75 6c64 2062 6520   that should be 
│ │ │ │ +00006e70: 7573 6564 2077 6865 6e20 6465 7269 7669  used when derivi
│ │ │ │ +00006e80: 6e67 0a20 2020 2020 6120 6b65 7920 7669  ng.     a key vi
│ │ │ │ +00006e90: 6120 e280 9873 6869 7368 695f 7374 7269  a ...shishi_stri
│ │ │ │ +00006ea0: 6e67 5f74 6f5f 6b65 7928 29e2 8099 2066  ng_to_key()... f
│ │ │ │ +00006eb0: 6f72 2061 6e20 4153 2065 7863 6861 6e67  or an AS exchang
│ │ │ │ +00006ec0: 652e 2020 4375 7272 656e 746c 790a 2020  e.  Currently.  
│ │ │ │ +00006ed0: 2020 2074 6869 7320 7365 6172 6368 6573     this searches
│ │ │ │ +00006ee0: 2066 6f72 2050 412d 4441 5441 206f 6620   for PA-DATA of 
│ │ │ │ +00006ef0: 7479 7065 20e2 8098 5348 4953 4849 5f50  type ...SHISHI_P
│ │ │ │ +00006f00: 415f 5057 5f53 414c 54e2 8099 2069 6e20  A_PW_SALT... in 
│ │ │ │ +00006f10: 7468 6520 4153 2d52 4550 0a20 2020 2020  the AS-REP.     
│ │ │ │ +00006f20: 7072 6f76 6964 6564 2062 7920 4153 5245  provided by ASRE
│ │ │ │ +00006f30: 502c 2061 6e64 2069 6620 7072 6573 656e  P, and if presen
│ │ │ │ +00006f40: 7420 7265 7475 726e 7320 6974 2e20 204f  t returns it.  O
│ │ │ │ +00006f50: 7468 6572 7769 7365 2074 6865 2073 616c  therwise the sal
│ │ │ │ +00006f60: 740a 2020 2020 2069 7320 636f 6d70 6f73  t.     is compos
│ │ │ │ +00006f70: 6564 2066 726f 6d20 7468 6520 636c 6965  ed from the clie
│ │ │ │ +00006f80: 6e74 206e 616d 6520 616e 6420 7468 6520  nt name and the 
│ │ │ │ +00006f90: 7265 616c 6d2c 2062 6f74 6820 6172 6520  realm, both are 
│ │ │ │ +00006fa0: 6578 7472 6163 7465 640a 2020 2020 2066  extracted.     f
│ │ │ │ +00006fb0: 726f 6d20 7468 6520 7265 7175 6573 7420  rom the request 
│ │ │ │ +00006fc0: 4153 5245 512e 0a0a 2020 2020 202a 5265  ASREQ...     *Re
│ │ │ │ +00006fd0: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ +00006fe0: 7572 6e73 20e2 8098 5348 4953 4849 5f4f  urns ...SHISHI_O
│ │ │ │ +00006ff0: 4be2 8099 2069 6620 7375 6363 6573 7366  K... if successf
│ │ │ │ +00007000: 756c 2e20 2046 6169 6c75 7265 0a20 2020  ul.  Failure.   
│ │ │ │ +00007010: 2020 636f 6e64 6974 696f 6e73 2069 6e63    conditions inc
│ │ │ │ +00007020: 6c75 6465 2076 6172 696f 7573 2041 534e  lude various ASN
│ │ │ │ +00007030: 2e31 2069 7373 7565 732e 0a0a 7368 6973  .1 issues...shis
│ │ │ │ +00007040: 6869 5f6b 6463 7265 715f 7365 6e64 7265  hi_kdcreq_sendre
│ │ │ │ +00007050: 6376 5f68 696e 740a 2d2d 2d2d 2d2d 2d2d  cv_hint.--------
│ │ │ │  00007060: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00007070: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ -00007080: 3a20 696e 7420 7368 6973 6869 5f6b 6463  : int shishi_kdc
│ │ │ │ -00007090: 7265 715f 7365 6e64 7265 6376 5f68 696e  req_sendrecv_hin
│ │ │ │ -000070a0: 7420 2853 6869 7368 6920 2a20 4841 4e44  t (Shishi * HAND
│ │ │ │ -000070b0: 4c45 2c0a 2020 2020 2020 2020 2020 5368  LE,.          Sh
│ │ │ │ -000070c0: 6973 6869 5f61 736e 3120 4b44 4352 4551  ishi_asn1 KDCREQ
│ │ │ │ -000070d0: 2c20 5368 6973 6869 5f61 736e 3120 2a20  , Shishi_asn1 * 
│ │ │ │ -000070e0: 4b44 4352 4550 2c0a 2020 2020 2020 2020  KDCREP,.        
│ │ │ │ -000070f0: 2020 5368 6973 6869 5f74 6b74 735f 6869    Shishi_tkts_hi
│ │ │ │ -00007100: 6e74 202a 2048 494e 5429 0a20 2020 2020  nt * HINT).     
│ │ │ │ -00007110: 4841 4e44 4c45 3a20 5368 6973 6869 206c  HANDLE: Shishi l
│ │ │ │ -00007120: 6962 7261 7279 2068 616e 646c 6520 6372  ibrary handle cr
│ │ │ │ -00007130: 6561 7465 6420 6279 20e2 8098 7368 6973  eated by ...shis
│ │ │ │ -00007140: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ -00007150: 2020 204b 4443 5245 513a 2049 6e70 7574     KDCREQ: Input
│ │ │ │ -00007160: 2076 6172 6961 626c 6520 7769 7468 2061   variable with a
│ │ │ │ -00007170: 2070 7265 7061 7265 6420 4153 2d52 4551   prepared AS-REQ
│ │ │ │ -00007180: 2e0a 2020 2020 204b 4443 5245 503a 204f  ..     KDCREP: O
│ │ │ │ -00007190: 7574 7075 7420 706f 696e 7465 7220 7661  utput pointer va
│ │ │ │ -000071a0: 7269 6162 6c65 2066 6f72 2064 6563 6f64  riable for decod
│ │ │ │ -000071b0: 6564 2041 532d 5245 502e 0a20 2020 2020  ed AS-REP..     
│ │ │ │ -000071c0: 4849 4e54 3a20 496e 7075 7420 e280 9853  HINT: Input ...S
│ │ │ │ -000071d0: 6869 7368 695f 746b 7473 5f68 696e 74e2  hishi_tkts_hint.
│ │ │ │ -000071e0: 8099 2073 7472 7563 7475 7265 2077 6974  .. structure wit
│ │ │ │ -000071f0: 6820 666c 6167 732e 0a0a 2020 2020 202a  h flags...     *
│ │ │ │ -00007200: 4465 7363 7269 7074 696f 6e3a 2a20 5365  Description:* Se
│ │ │ │ -00007210: 6e64 7320 6120 7265 7175 6573 7420 746f  nds a request to
│ │ │ │ -00007220: 204b 4443 2c20 616e 6420 7265 6365 6976   KDC, and receiv
│ │ │ │ -00007230: 6573 2074 6865 2072 6573 706f 6e73 652e  es the response.
│ │ │ │ -00007240: 0a20 2020 2020 5468 6520 7072 6f76 6964  .     The provid
│ │ │ │ -00007250: 6564 2072 6571 7565 7374 204b 4443 5245  ed request KDCRE
│ │ │ │ -00007260: 5120 616e 6420 7468 6520 6869 6e74 7320  Q and the hints 
│ │ │ │ -00007270: 7374 7275 6374 7572 6520 4849 4e54 2c20  structure HINT, 
│ │ │ │ -00007280: 746f 6765 7468 6572 0a20 2020 2020 6465  together.     de
│ │ │ │ -00007290: 7465 726d 696e 6520 7472 616e 736d 6974  termine transmit
│ │ │ │ -000072a0: 7465 6420 6461 7461 2e20 204f 6e20 7265  ted data.  On re
│ │ │ │ -000072b0: 6365 7074 696f 6e20 7468 6520 7265 706c  ception the repl
│ │ │ │ -000072c0: 7920 6973 2064 6563 6f64 6564 2061 730a  y is decoded as.
│ │ │ │ -000072d0: 2020 2020 2041 532d 5245 5020 696e 746f       AS-REP into
│ │ │ │ -000072e0: 204b 4443 5245 502e 0a0a 2020 2020 202a   KDCREP...     *
│ │ │ │ -000072f0: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ -00007300: 6574 7572 6e20 636f 6465 2069 7320 e280  eturn code is ..
│ │ │ │ -00007310: 9853 4849 5348 495f 4f4b e280 9920 6f6e  .SHISHI_OK... on
│ │ │ │ -00007320: 2073 7563 6365 7373 2c0a 2020 2020 20e2   success,.     .
│ │ │ │ -00007330: 8098 5348 4953 4849 5f4b 4443 5f54 494d  ..SHISHI_KDC_TIM
│ │ │ │ -00007340: 454f 5554 e280 9920 6f6e 2074 696d 656f  EOUT... on timeo
│ │ │ │ -00007350: 7574 732c 20e2 8098 5348 4953 4849 5f41  uts, ...SHISHI_A
│ │ │ │ -00007360: 534e 315f 4552 524f 52e2 8099 206f 6e0a  SN1_ERROR... on.
│ │ │ │ -00007370: 2020 2020 2074 7261 6e73 6c61 7469 6f6e       translation
│ │ │ │ -00007380: 2065 7272 6f72 732c 2061 6e64 20e2 8098   errors, and ...
│ │ │ │ -00007390: 5348 4953 4849 5f47 4f54 5f4b 5242 4552  SHISHI_GOT_KRBER
│ │ │ │ -000073a0: 524f 52e2 8099 2066 6f72 206f 7468 6572  ROR... for other
│ │ │ │ -000073b0: 0a20 2020 2020 636f 7272 7570 7469 6f6e  .     corruption
│ │ │ │ -000073c0: 732e 0a0a 7368 6973 6869 5f6b 6463 7265  s...shishi_kdcre
│ │ │ │ -000073d0: 715f 7365 6e64 7265 6376 0a2d 2d2d 2d2d  q_sendrecv.-----
│ │ │ │ +00007070: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ +00007080: 6e3a 2069 6e74 2073 6869 7368 695f 6b64  n: int shishi_kd
│ │ │ │ +00007090: 6372 6571 5f73 656e 6472 6563 765f 6869  creq_sendrecv_hi
│ │ │ │ +000070a0: 6e74 2028 5368 6973 6869 202a 2048 414e  nt (Shishi * HAN
│ │ │ │ +000070b0: 444c 452c 0a20 2020 2020 2020 2020 2053  DLE,.          S
│ │ │ │ +000070c0: 6869 7368 695f 6173 6e31 204b 4443 5245  hishi_asn1 KDCRE
│ │ │ │ +000070d0: 512c 2053 6869 7368 695f 6173 6e31 202a  Q, Shishi_asn1 *
│ │ │ │ +000070e0: 204b 4443 5245 502c 0a20 2020 2020 2020   KDCREP,.       
│ │ │ │ +000070f0: 2020 2053 6869 7368 695f 746b 7473 5f68     Shishi_tkts_h
│ │ │ │ +00007100: 696e 7420 2a20 4849 4e54 290a 2020 2020  int * HINT).    
│ │ │ │ +00007110: 2048 414e 444c 453a 2053 6869 7368 6920   HANDLE: Shishi 
│ │ │ │ +00007120: 6c69 6272 6172 7920 6861 6e64 6c65 2063  library handle c
│ │ │ │ +00007130: 7265 6174 6564 2062 7920 e280 9873 6869  reated by ...shi
│ │ │ │ +00007140: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ +00007150: 2020 2020 4b44 4352 4551 3a20 496e 7075      KDCREQ: Inpu
│ │ │ │ +00007160: 7420 7661 7269 6162 6c65 2077 6974 6820  t variable with 
│ │ │ │ +00007170: 6120 7072 6570 6172 6564 2041 532d 5245  a prepared AS-RE
│ │ │ │ +00007180: 512e 0a20 2020 2020 4b44 4352 4550 3a20  Q..     KDCREP: 
│ │ │ │ +00007190: 4f75 7470 7574 2070 6f69 6e74 6572 2076  Output pointer v
│ │ │ │ +000071a0: 6172 6961 626c 6520 666f 7220 6465 636f  ariable for deco
│ │ │ │ +000071b0: 6465 6420 4153 2d52 4550 2e0a 2020 2020  ded AS-REP..    
│ │ │ │ +000071c0: 2048 494e 543a 2049 6e70 7574 20e2 8098   HINT: Input ...
│ │ │ │ +000071d0: 5368 6973 6869 5f74 6b74 735f 6869 6e74  Shishi_tkts_hint
│ │ │ │ +000071e0: e280 9920 7374 7275 6374 7572 6520 7769  ... structure wi
│ │ │ │ +000071f0: 7468 2066 6c61 6773 2e0a 0a20 2020 2020  th flags...     
│ │ │ │ +00007200: 2a44 6573 6372 6970 7469 6f6e 3a2a 2053  *Description:* S
│ │ │ │ +00007210: 656e 6473 2061 2072 6571 7565 7374 2074  ends a request t
│ │ │ │ +00007220: 6f20 4b44 432c 2061 6e64 2072 6563 6569  o KDC, and recei
│ │ │ │ +00007230: 7665 7320 7468 6520 7265 7370 6f6e 7365  ves the response
│ │ │ │ +00007240: 2e0a 2020 2020 2054 6865 2070 726f 7669  ..     The provi
│ │ │ │ +00007250: 6465 6420 7265 7175 6573 7420 4b44 4352  ded request KDCR
│ │ │ │ +00007260: 4551 2061 6e64 2074 6865 2068 696e 7473  EQ and the hints
│ │ │ │ +00007270: 2073 7472 7563 7475 7265 2048 494e 542c   structure HINT,
│ │ │ │ +00007280: 2074 6f67 6574 6865 720a 2020 2020 2064   together.     d
│ │ │ │ +00007290: 6574 6572 6d69 6e65 2074 7261 6e73 6d69  etermine transmi
│ │ │ │ +000072a0: 7474 6564 2064 6174 612e 2020 4f6e 2072  tted data.  On r
│ │ │ │ +000072b0: 6563 6570 7469 6f6e 2074 6865 2072 6570  eception the rep
│ │ │ │ +000072c0: 6c79 2069 7320 6465 636f 6465 6420 6173  ly is decoded as
│ │ │ │ +000072d0: 0a20 2020 2020 4153 2d52 4550 2069 6e74  .     AS-REP int
│ │ │ │ +000072e0: 6f20 4b44 4352 4550 2e0a 0a20 2020 2020  o KDCREP...     
│ │ │ │ +000072f0: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ +00007300: 5265 7475 726e 2063 6f64 6520 6973 20e2  Return code is .
│ │ │ │ +00007310: 8098 5348 4953 4849 5f4f 4be2 8099 206f  ..SHISHI_OK... o
│ │ │ │ +00007320: 6e20 7375 6363 6573 732c 0a20 2020 2020  n success,.     
│ │ │ │ +00007330: e280 9853 4849 5348 495f 4b44 435f 5449  ...SHISHI_KDC_TI
│ │ │ │ +00007340: 4d45 4f55 54e2 8099 206f 6e20 7469 6d65  MEOUT... on time
│ │ │ │ +00007350: 6f75 7473 2c20 e280 9853 4849 5348 495f  outs, ...SHISHI_
│ │ │ │ +00007360: 4153 4e31 5f45 5252 4f52 e280 9920 6f6e  ASN1_ERROR... on
│ │ │ │ +00007370: 0a20 2020 2020 7472 616e 736c 6174 696f  .     translatio
│ │ │ │ +00007380: 6e20 6572 726f 7273 2c20 616e 6420 e280  n errors, and ..
│ │ │ │ +00007390: 9853 4849 5348 495f 474f 545f 4b52 4245  .SHISHI_GOT_KRBE
│ │ │ │ +000073a0: 5252 4f52 e280 9920 666f 7220 6f74 6865  RROR... for othe
│ │ │ │ +000073b0: 720a 2020 2020 2063 6f72 7275 7074 696f  r.     corruptio
│ │ │ │ +000073c0: 6e73 2e0a 0a73 6869 7368 695f 6b64 6372  ns...shishi_kdcr
│ │ │ │ +000073d0: 6571 5f73 656e 6472 6563 760a 2d2d 2d2d  eq_sendrecv.----
│ │ │ │  000073e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000073f0: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ -00007400: 2069 6e74 2073 6869 7368 695f 6b64 6372   int shishi_kdcr
│ │ │ │ -00007410: 6571 5f73 656e 6472 6563 7620 2853 6869  eq_sendrecv (Shi
│ │ │ │ -00007420: 7368 6920 2a20 4841 4e44 4c45 2c0a 2020  shi * HANDLE,.  
│ │ │ │ -00007430: 2020 2020 2020 2020 5368 6973 6869 5f61          Shishi_a
│ │ │ │ -00007440: 736e 3120 4b44 4352 4551 2c20 5368 6973  sn1 KDCREQ, Shis
│ │ │ │ -00007450: 6869 5f61 736e 3120 2a20 4b44 4352 4550  hi_asn1 * KDCREP
│ │ │ │ -00007460: 290a 2020 2020 2048 414e 444c 453a 2053  ).     HANDLE: S
│ │ │ │ -00007470: 6869 7368 6920 6c69 6272 6172 7920 6861  hishi library ha
│ │ │ │ -00007480: 6e64 6c65 2063 7265 6174 6564 2062 7920  ndle created by 
│ │ │ │ -00007490: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ -000074a0: e280 992e 0a20 2020 2020 4b44 4352 4551  .....     KDCREQ
│ │ │ │ -000074b0: 3a20 496e 7075 7420 7661 7269 6162 6c65  : Input variable
│ │ │ │ -000074c0: 2077 6974 6820 6120 7072 6570 6172 6564   with a prepared
│ │ │ │ -000074d0: 2041 532d 5245 512e 0a20 2020 2020 4b44   AS-REQ..     KD
│ │ │ │ -000074e0: 4352 4550 3a20 4f75 7470 7574 2070 6f69  CREP: Output poi
│ │ │ │ -000074f0: 6e74 6572 2076 6172 6961 626c 6520 7265  nter variable re
│ │ │ │ -00007500: 7475 726e 696e 6720 7265 6365 6976 6564  turning received
│ │ │ │ -00007510: 2041 532d 5245 502e 0a0a 2020 2020 202a   AS-REP...     *
│ │ │ │ -00007520: 4465 7363 7269 7074 696f 6e3a 2a20 5365  Description:* Se
│ │ │ │ -00007530: 6e64 7320 6120 7265 7175 6573 7420 746f  nds a request to
│ │ │ │ -00007540: 204b 4443 2c20 616e 6420 7265 6365 6976   KDC, and receiv
│ │ │ │ -00007550: 6573 2074 6865 2072 6573 706f 6e73 652e  es the response.
│ │ │ │ -00007560: 0a20 2020 2020 5468 6520 7072 6f76 6964  .     The provid
│ │ │ │ -00007570: 6564 2041 532d 5245 512c 2069 6e20 4b44  ed AS-REQ, in KD
│ │ │ │ -00007580: 4352 4551 2c20 7365 7473 2061 6c6c 2064  CREQ, sets all d
│ │ │ │ -00007590: 6174 6120 666f 7220 7468 6520 7265 7175  ata for the requ
│ │ │ │ -000075a0: 6573 742e 2020 4f6e 0a20 2020 2020 7265  est.  On.     re
│ │ │ │ -000075b0: 6365 7074 696f 6e20 7468 6520 7265 706c  ception the repl
│ │ │ │ -000075c0: 7920 6973 2064 6563 6f64 6564 2061 7320  y is decoded as 
│ │ │ │ -000075d0: 4153 2d52 4550 2069 6e74 6f20 4b44 4352  AS-REP into KDCR
│ │ │ │ -000075e0: 4550 2e0a 0a20 2020 2020 2a52 6574 7572  EP...     *Retur
│ │ │ │ -000075f0: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ -00007600: 2063 6f64 6520 6973 20e2 8098 5348 4953   code is ...SHIS
│ │ │ │ -00007610: 4849 5f4f 4be2 8099 206f 6e20 7375 6363  HI_OK... on succ
│ │ │ │ -00007620: 6573 732c 0a20 2020 2020 e280 9853 4849  ess,.     ...SHI
│ │ │ │ -00007630: 5348 495f 4b44 435f 5449 4d45 4f55 54e2  SHI_KDC_TIMEOUT.
│ │ │ │ -00007640: 8099 206f 6e20 7469 6d65 6f75 7473 2c20  .. on timeouts, 
│ │ │ │ -00007650: e280 9853 4849 5348 495f 4153 4e31 5f45  ...SHISHI_ASN1_E
│ │ │ │ -00007660: 5252 4f52 e280 9920 6f6e 0a20 2020 2020  RROR... on.     
│ │ │ │ -00007670: 7472 616e 736c 6174 696f 6e20 6572 726f  translation erro
│ │ │ │ -00007680: 7273 2c20 616e 6420 e280 9853 4849 5348  rs, and ...SHISH
│ │ │ │ -00007690: 495f 474f 545f 4b52 4245 5252 4f52 e280  I_GOT_KRBERROR..
│ │ │ │ -000076a0: 9920 666f 7220 6f74 6865 720a 2020 2020  . for other.    
│ │ │ │ -000076b0: 2063 6f72 7275 7074 696f 6e73 2e0a 0a73   corruptions...s
│ │ │ │ -000076c0: 6869 7368 695f 6b64 635f 636f 7079 5f63  hishi_kdc_copy_c
│ │ │ │ -000076d0: 7265 616c 6d0a 2d2d 2d2d 2d2d 2d2d 2d2d  realm.----------
│ │ │ │ -000076e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ -000076f0: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ -00007700: 7368 6973 6869 5f6b 6463 5f63 6f70 795f  shishi_kdc_copy_
│ │ │ │ -00007710: 6372 6561 6c6d 2028 5368 6973 6869 202a  crealm (Shishi *
│ │ │ │ -00007720: 2048 414e 444c 452c 0a20 2020 2020 2020   HANDLE,.       
│ │ │ │ -00007730: 2020 2053 6869 7368 695f 6173 6e31 204b     Shishi_asn1 K
│ │ │ │ -00007740: 4443 5245 502c 2053 6869 7368 695f 6173  DCREP, Shishi_as
│ │ │ │ -00007750: 6e31 2045 4e43 5449 434b 4554 5041 5254  n1 ENCTICKETPART
│ │ │ │ -00007760: 290a 2020 2020 2048 414e 444c 453a 2053  ).     HANDLE: S
│ │ │ │ -00007770: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ -00007780: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ -00007790: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ -000077a0: 2e0a 2020 2020 204b 4443 5245 503a 204b  ..     KDCREP: K
│ │ │ │ -000077b0: 4443 2d52 4550 2077 6865 7265 2074 6865  DC-REP where the
│ │ │ │ -000077c0: 2066 6965 6c64 2022 6372 6561 6c6d 2220   field "crealm" 
│ │ │ │ -000077d0: 6973 2075 7064 6174 6564 2e0a 2020 2020  is updated..    
│ │ │ │ -000077e0: 2045 4e43 5449 434b 4554 5041 5254 3a20   ENCTICKETPART: 
│ │ │ │ -000077f0: 456e 6354 6963 6b65 7450 6172 7420 7072  EncTicketPart pr
│ │ │ │ -00007800: 6f76 6964 696e 6720 2263 7265 616c 6d22  oviding "crealm"
│ │ │ │ -00007810: 2066 6965 6c64 2e0a 0a20 2020 2020 2a44   field...     *D
│ │ │ │ -00007820: 6573 6372 6970 7469 6f6e 3a2a 2052 6561  escription:* Rea
│ │ │ │ -00007830: 6473 2074 6865 2066 6965 6c64 2022 6372  ds the field "cr
│ │ │ │ -00007840: 6561 6c6d 2220 6672 6f6d 2074 6865 2074  ealm" from the t
│ │ │ │ -00007850: 6963 6b65 740a 2020 2020 2045 4e43 5449  icket.     ENCTI
│ │ │ │ -00007860: 434b 4554 5041 5254 2061 6e64 2063 6f70  CKETPART and cop
│ │ │ │ -00007870: 6965 7320 7468 6520 7661 6c75 6520 696e  ies the value in
│ │ │ │ -00007880: 746f 2074 6865 2072 6570 6c79 204b 4443  to the reply KDC
│ │ │ │ -00007890: 5245 502e 0a0a 2020 2020 202a 5265 7475  REP...     *Retu
│ │ │ │ -000078a0: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ -000078b0: 6e73 20e2 8098 5348 4953 4849 5f4f 4be2  ns ...SHISHI_OK.
│ │ │ │ -000078c0: 8099 2069 6620 7375 6363 6573 7366 756c  .. if successful
│ │ │ │ -000078d0: 2c20 616e 6420 4153 4e2e 310a 2020 2020  , and ASN.1.    
│ │ │ │ -000078e0: 2066 6169 6c75 7265 7320 6f74 6865 7277   failures otherw
│ │ │ │ -000078f0: 6973 652e 0a0a 7368 6973 6869 5f61 735f  ise...shishi_as_
│ │ │ │ -00007900: 6368 6563 6b5f 6372 6561 6c6d 0a2d 2d2d  check_crealm.---
│ │ │ │ +000073f0: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ +00007400: 3a20 696e 7420 7368 6973 6869 5f6b 6463  : int shishi_kdc
│ │ │ │ +00007410: 7265 715f 7365 6e64 7265 6376 2028 5368  req_sendrecv (Sh
│ │ │ │ +00007420: 6973 6869 202a 2048 414e 444c 452c 0a20  ishi * HANDLE,. 
│ │ │ │ +00007430: 2020 2020 2020 2020 2053 6869 7368 695f           Shishi_
│ │ │ │ +00007440: 6173 6e31 204b 4443 5245 512c 2053 6869  asn1 KDCREQ, Shi
│ │ │ │ +00007450: 7368 695f 6173 6e31 202a 204b 4443 5245  shi_asn1 * KDCRE
│ │ │ │ +00007460: 5029 0a20 2020 2020 4841 4e44 4c45 3a20  P).     HANDLE: 
│ │ │ │ +00007470: 5368 6973 6869 206c 6962 7261 7279 2068  Shishi library h
│ │ │ │ +00007480: 616e 646c 6520 6372 6561 7465 6420 6279  andle created by
│ │ │ │ +00007490: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ +000074a0: 29e2 8099 2e0a 2020 2020 204b 4443 5245  ).....     KDCRE
│ │ │ │ +000074b0: 513a 2049 6e70 7574 2076 6172 6961 626c  Q: Input variabl
│ │ │ │ +000074c0: 6520 7769 7468 2061 2070 7265 7061 7265  e with a prepare
│ │ │ │ +000074d0: 6420 4153 2d52 4551 2e0a 2020 2020 204b  d AS-REQ..     K
│ │ │ │ +000074e0: 4443 5245 503a 204f 7574 7075 7420 706f  DCREP: Output po
│ │ │ │ +000074f0: 696e 7465 7220 7661 7269 6162 6c65 2072  inter variable r
│ │ │ │ +00007500: 6574 7572 6e69 6e67 2072 6563 6569 7665  eturning receive
│ │ │ │ +00007510: 6420 4153 2d52 4550 2e0a 0a20 2020 2020  d AS-REP...     
│ │ │ │ +00007520: 2a44 6573 6372 6970 7469 6f6e 3a2a 2053  *Description:* S
│ │ │ │ +00007530: 656e 6473 2061 2072 6571 7565 7374 2074  ends a request t
│ │ │ │ +00007540: 6f20 4b44 432c 2061 6e64 2072 6563 6569  o KDC, and recei
│ │ │ │ +00007550: 7665 7320 7468 6520 7265 7370 6f6e 7365  ves the response
│ │ │ │ +00007560: 2e0a 2020 2020 2054 6865 2070 726f 7669  ..     The provi
│ │ │ │ +00007570: 6465 6420 4153 2d52 4551 2c20 696e 204b  ded AS-REQ, in K
│ │ │ │ +00007580: 4443 5245 512c 2073 6574 7320 616c 6c20  DCREQ, sets all 
│ │ │ │ +00007590: 6461 7461 2066 6f72 2074 6865 2072 6571  data for the req
│ │ │ │ +000075a0: 7565 7374 2e20 204f 6e0a 2020 2020 2072  uest.  On.     r
│ │ │ │ +000075b0: 6563 6570 7469 6f6e 2074 6865 2072 6570  eception the rep
│ │ │ │ +000075c0: 6c79 2069 7320 6465 636f 6465 6420 6173  ly is decoded as
│ │ │ │ +000075d0: 2041 532d 5245 5020 696e 746f 204b 4443   AS-REP into KDC
│ │ │ │ +000075e0: 5245 502e 0a0a 2020 2020 202a 5265 7475  REP...     *Retu
│ │ │ │ +000075f0: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ +00007600: 6e20 636f 6465 2069 7320 e280 9853 4849  n code is ...SHI
│ │ │ │ +00007610: 5348 495f 4f4b e280 9920 6f6e 2073 7563  SHI_OK... on suc
│ │ │ │ +00007620: 6365 7373 2c0a 2020 2020 20e2 8098 5348  cess,.     ...SH
│ │ │ │ +00007630: 4953 4849 5f4b 4443 5f54 494d 454f 5554  ISHI_KDC_TIMEOUT
│ │ │ │ +00007640: e280 9920 6f6e 2074 696d 656f 7574 732c  ... on timeouts,
│ │ │ │ +00007650: 20e2 8098 5348 4953 4849 5f41 534e 315f   ...SHISHI_ASN1_
│ │ │ │ +00007660: 4552 524f 52e2 8099 206f 6e0a 2020 2020  ERROR... on.    
│ │ │ │ +00007670: 2074 7261 6e73 6c61 7469 6f6e 2065 7272   translation err
│ │ │ │ +00007680: 6f72 732c 2061 6e64 20e2 8098 5348 4953  ors, and ...SHIS
│ │ │ │ +00007690: 4849 5f47 4f54 5f4b 5242 4552 524f 52e2  HI_GOT_KRBERROR.
│ │ │ │ +000076a0: 8099 2066 6f72 206f 7468 6572 0a20 2020  .. for other.   
│ │ │ │ +000076b0: 2020 636f 7272 7570 7469 6f6e 732e 0a0a    corruptions...
│ │ │ │ +000076c0: 7368 6973 6869 5f6b 6463 5f63 6f70 795f  shishi_kdc_copy_
│ │ │ │ +000076d0: 6372 6561 6c6d 0a2d 2d2d 2d2d 2d2d 2d2d  crealm.---------
│ │ │ │ +000076e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ +000076f0: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ +00007700: 2073 6869 7368 695f 6b64 635f 636f 7079   shishi_kdc_copy
│ │ │ │ +00007710: 5f63 7265 616c 6d20 2853 6869 7368 6920  _crealm (Shishi 
│ │ │ │ +00007720: 2a20 4841 4e44 4c45 2c0a 2020 2020 2020  * HANDLE,.      
│ │ │ │ +00007730: 2020 2020 5368 6973 6869 5f61 736e 3120      Shishi_asn1 
│ │ │ │ +00007740: 4b44 4352 4550 2c20 5368 6973 6869 5f61  KDCREP, Shishi_a
│ │ │ │ +00007750: 736e 3120 454e 4354 4943 4b45 5450 4152  sn1 ENCTICKETPAR
│ │ │ │ +00007760: 5429 0a20 2020 2020 4841 4e44 4c45 3a20  T).     HANDLE: 
│ │ │ │ +00007770: 5368 6973 6869 2068 616e 646c 6520 6173  Shishi handle as
│ │ │ │ +00007780: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ +00007790: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ +000077a0: 992e 0a20 2020 2020 4b44 4352 4550 3a20  ...     KDCREP: 
│ │ │ │ +000077b0: 4b44 432d 5245 5020 7768 6572 6520 7468  KDC-REP where th
│ │ │ │ +000077c0: 6520 6669 656c 6420 2263 7265 616c 6d22  e field "crealm"
│ │ │ │ +000077d0: 2069 7320 7570 6461 7465 642e 0a20 2020   is updated..   
│ │ │ │ +000077e0: 2020 454e 4354 4943 4b45 5450 4152 543a    ENCTICKETPART:
│ │ │ │ +000077f0: 2045 6e63 5469 636b 6574 5061 7274 2070   EncTicketPart p
│ │ │ │ +00007800: 726f 7669 6469 6e67 2022 6372 6561 6c6d  roviding "crealm
│ │ │ │ +00007810: 2220 6669 656c 642e 0a0a 2020 2020 202a  " field...     *
│ │ │ │ +00007820: 4465 7363 7269 7074 696f 6e3a 2a20 5265  Description:* Re
│ │ │ │ +00007830: 6164 7320 7468 6520 6669 656c 6420 2263  ads the field "c
│ │ │ │ +00007840: 7265 616c 6d22 2066 726f 6d20 7468 6520  realm" from the 
│ │ │ │ +00007850: 7469 636b 6574 0a20 2020 2020 454e 4354  ticket.     ENCT
│ │ │ │ +00007860: 4943 4b45 5450 4152 5420 616e 6420 636f  ICKETPART and co
│ │ │ │ +00007870: 7069 6573 2074 6865 2076 616c 7565 2069  pies the value i
│ │ │ │ +00007880: 6e74 6f20 7468 6520 7265 706c 7920 4b44  nto the reply KD
│ │ │ │ +00007890: 4352 4550 2e0a 0a20 2020 2020 2a52 6574  CREP...     *Ret
│ │ │ │ +000078a0: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ +000078b0: 726e 7320 e280 9853 4849 5348 495f 4f4b  rns ...SHISHI_OK
│ │ │ │ +000078c0: e280 9920 6966 2073 7563 6365 7373 6675  ... if successfu
│ │ │ │ +000078d0: 6c2c 2061 6e64 2041 534e 2e31 0a20 2020  l, and ASN.1.   
│ │ │ │ +000078e0: 2020 6661 696c 7572 6573 206f 7468 6572    failures other
│ │ │ │ +000078f0: 7769 7365 2e0a 0a73 6869 7368 695f 6173  wise...shishi_as
│ │ │ │ +00007900: 5f63 6865 636b 5f63 7265 616c 6d0a 2d2d  _check_crealm.--
│ │ │ │  00007910: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00007920: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ -00007930: 6e3a 2069 6e74 2073 6869 7368 695f 6173  n: int shishi_as
│ │ │ │ -00007940: 5f63 6865 636b 5f63 7265 616c 6d20 2853  _check_crealm (S
│ │ │ │ -00007950: 6869 7368 6920 2a20 4841 4e44 4c45 2c0a  hishi * HANDLE,.
│ │ │ │ -00007960: 2020 2020 2020 2020 2020 5368 6973 6869            Shishi
│ │ │ │ -00007970: 5f61 736e 3120 4153 5245 512c 2053 6869  _asn1 ASREQ, Shi
│ │ │ │ -00007980: 7368 695f 6173 6e31 2041 5352 4550 290a  shi_asn1 ASREP).
│ │ │ │ -00007990: 2020 2020 2048 414e 444c 453a 2053 6869       HANDLE: Shi
│ │ │ │ -000079a0: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ -000079b0: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ -000079c0: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ -000079d0: 2020 2020 2041 5352 4551 3a20 5265 7175       ASREQ: Requ
│ │ │ │ -000079e0: 6573 7420 6f66 2074 7970 6520 4153 2d52  est of type AS-R
│ │ │ │ -000079f0: 4551 2e0a 2020 2020 2041 5352 4550 3a20  EQ..     ASREP: 
│ │ │ │ -00007a00: 5265 706c 7920 7374 7275 6374 7572 6520  Reply structure 
│ │ │ │ -00007a10: 6f66 2074 7970 6520 4153 2d52 4550 2e0a  of type AS-REP..
│ │ │ │ -00007a20: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -00007a30: 6f6e 3a2a 2056 6572 6966 6965 7320 7468  on:* Verifies th
│ │ │ │ -00007a40: 6174 2074 6865 2066 6965 6c64 7320 4153  at the fields AS
│ │ │ │ -00007a50: 5245 512e 7265 712d 626f 6479 2e72 6561  REQ.req-body.rea
│ │ │ │ -00007a60: 6c6d 2061 6e64 0a20 2020 2020 4153 5245  lm and.     ASRE
│ │ │ │ -00007a70: 502e 6372 6561 6c6d 2063 6f6e 7461 696e  P.crealm contain
│ │ │ │ -00007a80: 2069 6465 6e74 6963 616c 2072 6561 6c6d   identical realm
│ │ │ │ -00007a90: 206e 616d 6573 2e20 2054 6869 7320 6973   names.  This is
│ │ │ │ -00007aa0: 206f 6e65 206f 6620 7468 650a 2020 2020   one of the.    
│ │ │ │ -00007ab0: 2073 7465 7073 2074 6861 7420 6861 7320   steps that has 
│ │ │ │ -00007ac0: 746f 2062 6520 7065 7266 6f72 6d65 6420  to be performed 
│ │ │ │ -00007ad0: 7768 656e 2070 726f 6365 7373 696e 6720  when processing 
│ │ │ │ -00007ae0: 616e 2065 7863 6861 6e67 6520 6f66 0a20  an exchange of. 
│ │ │ │ -00007af0: 2020 2020 4153 2d52 4551 2061 6e64 2041      AS-REQ and A
│ │ │ │ -00007b00: 532d 5245 503b 2073 6565 20e2 8098 7368  S-REP; see ...sh
│ │ │ │ -00007b10: 6973 6869 5f6b 6463 5f70 726f 6365 7373  ishi_kdc_process
│ │ │ │ -00007b20: 2829 e280 9920 666f 7220 6d6f 7265 2064  ()... for more d
│ │ │ │ -00007b30: 6574 6169 6c73 2e0a 0a20 2020 2020 2a52  etails...     *R
│ │ │ │ -00007b40: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ -00007b50: 7475 726e 7320 e280 9853 4849 5348 495f  turns ...SHISHI_
│ │ │ │ -00007b60: 4f4b e280 9920 6966 2073 7563 6365 7373  OK... if success
│ │ │ │ -00007b70: 6675 6c2c 0a20 2020 2020 e280 9853 4849  ful,.     ...SHI
│ │ │ │ -00007b80: 5348 495f 5245 414c 4d5f 4d49 534d 4154  SHI_REALM_MISMAT
│ │ │ │ -00007b90: 4348 e280 9920 7768 656e 6576 6572 2074  CH... whenever t
│ │ │ │ -00007ba0: 6865 2072 6561 6c6d 206e 616d 6573 2064  he realm names d
│ │ │ │ -00007bb0: 6966 6665 722c 2061 6e64 2061 6e0a 2020  iffer, and an.  
│ │ │ │ -00007bc0: 2020 2065 7272 6f72 2063 6f64 6520 6f74     error code ot
│ │ │ │ -00007bd0: 6865 7277 6973 652e 0a0a 7368 6973 6869  herwise...shishi
│ │ │ │ -00007be0: 5f6b 6463 5f63 6f70 795f 636e 616d 650a  _kdc_copy_cname.
│ │ │ │ -00007bf0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00007c00: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ -00007c10: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ -00007c20: 6b64 635f 636f 7079 5f63 6e61 6d65 2028  kdc_copy_cname (
│ │ │ │ -00007c30: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ -00007c40: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ -00007c50: 695f 6173 6e31 204b 4443 5245 502c 2053  i_asn1 KDCREP, S
│ │ │ │ -00007c60: 6869 7368 695f 6173 6e31 2045 4e43 5449  hishi_asn1 ENCTI
│ │ │ │ -00007c70: 434b 4554 5041 5254 290a 2020 2020 2048  CKETPART).     H
│ │ │ │ -00007c80: 414e 444c 453a 2053 6869 7368 6920 6861  ANDLE: Shishi ha
│ │ │ │ -00007c90: 6e64 6c65 2061 7320 616c 6c6f 6361 7465  ndle as allocate
│ │ │ │ -00007ca0: 6420 6279 20e2 8098 7368 6973 6869 5f69  d by ...shishi_i
│ │ │ │ -00007cb0: 6e69 7428 29e2 8099 2e0a 2020 2020 204b  nit().....     K
│ │ │ │ -00007cc0: 4443 5245 503a 204b 4443 2d52 4550 2077  DCREP: KDC-REP w
│ │ │ │ -00007cd0: 6865 7265 2074 6865 2066 6965 6c64 2022  here the field "
│ │ │ │ -00007ce0: 636e 616d 6522 2069 7320 7570 6461 7465  cname" is update
│ │ │ │ -00007cf0: 642e 0a20 2020 2020 454e 4354 4943 4b45  d..     ENCTICKE
│ │ │ │ -00007d00: 5450 4152 543a 2045 6e63 5469 636b 6574  TPART: EncTicket
│ │ │ │ -00007d10: 5061 7274 2070 726f 7669 6469 6e67 2022  Part providing "
│ │ │ │ -00007d20: 636e 616d 6522 2066 6965 6c64 2e0a 0a20  cname" field... 
│ │ │ │ -00007d30: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -00007d40: 3a2a 2052 6561 6473 2074 6865 2066 6965  :* Reads the fie
│ │ │ │ -00007d50: 6c64 2022 636e 616d 6522 2066 726f 6d20  ld "cname" from 
│ │ │ │ -00007d60: 7468 6520 7469 636b 6574 0a20 2020 2020  the ticket.     
│ │ │ │ -00007d70: 454e 4354 4943 4b45 5450 4152 5420 616e  ENCTICKETPART an
│ │ │ │ -00007d80: 6420 636f 7069 6573 2074 6865 2076 616c  d copies the val
│ │ │ │ -00007d90: 7565 2069 6e74 6f20 7468 6520 7265 706c  ue into the repl
│ │ │ │ -00007da0: 7920 4b44 4352 4550 2e0a 0a20 2020 2020  y KDCREP...     
│ │ │ │ -00007db0: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ -00007dc0: 5265 7475 726e 7320 e280 9853 4849 5348  Returns ...SHISH
│ │ │ │ -00007dd0: 495f 4f4b e280 9920 6966 2073 7563 6365  I_OK... if succe
│ │ │ │ -00007de0: 7373 6675 6c2c 2061 6e64 2041 534e 2e31  ssful, and ASN.1
│ │ │ │ -00007df0: 0a20 2020 2020 6661 696c 7572 6573 206f  .     failures o
│ │ │ │ -00007e00: 7468 6572 7769 7365 2e0a 0a73 6869 7368  therwise...shish
│ │ │ │ -00007e10: 695f 6173 5f63 6865 636b 5f63 6e61 6d65  i_as_check_cname
│ │ │ │ -00007e20: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ -00007e30: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ -00007e40: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ -00007e50: 5f61 735f 6368 6563 6b5f 636e 616d 6520  _as_check_cname 
│ │ │ │ -00007e60: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ -00007e70: 2c0a 2020 2020 2020 2020 2020 5368 6973  ,.          Shis
│ │ │ │ -00007e80: 6869 5f61 736e 3120 4153 5245 512c 2053  hi_asn1 ASREQ, S
│ │ │ │ -00007e90: 6869 7368 695f 6173 6e31 2041 5352 4550  hishi_asn1 ASREP
│ │ │ │ -00007ea0: 290a 2020 2020 2048 414e 444c 453a 2053  ).     HANDLE: S
│ │ │ │ -00007eb0: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ -00007ec0: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ -00007ed0: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ -00007ee0: 2e0a 2020 2020 2041 5352 4551 3a20 5265  ..     ASREQ: Re
│ │ │ │ -00007ef0: 7175 6573 7420 6f66 2074 7970 6520 4153  quest of type AS
│ │ │ │ -00007f00: 2d52 4551 2e0a 2020 2020 2041 5352 4550  -REQ..     ASREP
│ │ │ │ -00007f10: 3a20 5265 706c 7920 7374 7275 6374 7572  : Reply structur
│ │ │ │ -00007f20: 6520 6f66 2074 7970 6520 4153 2d52 4550  e of type AS-REP
│ │ │ │ -00007f30: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ -00007f40: 7469 6f6e 3a2a 2056 6572 6966 6965 7320  tion:* Verifies 
│ │ │ │ -00007f50: 7468 6174 2074 6865 2066 6965 6c64 7320  that the fields 
│ │ │ │ -00007f60: 4153 5245 512e 7265 712d 626f 6479 2e63  ASREQ.req-body.c
│ │ │ │ -00007f70: 6e61 6d65 2061 6e64 0a20 2020 2020 4153  name and.     AS
│ │ │ │ -00007f80: 5245 502e 636e 616d 6520 636f 6e74 6169  REP.cname contai
│ │ │ │ -00007f90: 6e20 6964 656e 7469 6361 6c20 6e61 6d65  n identical name
│ │ │ │ -00007fa0: 732e 2020 5468 6973 2069 7320 6f6e 6520  s.  This is one 
│ │ │ │ -00007fb0: 6f66 2074 6865 2073 7465 7073 2074 6861  of the steps tha
│ │ │ │ -00007fc0: 740a 2020 2020 2068 6173 2074 6f20 6265  t.     has to be
│ │ │ │ -00007fd0: 2070 6572 666f 726d 6564 2077 6865 6e20   performed when 
│ │ │ │ -00007fe0: 7072 6f63 6573 7369 6e67 2061 6e20 6578  processing an ex
│ │ │ │ -00007ff0: 6368 616e 6765 206f 6620 4153 2d52 4551  change of AS-REQ
│ │ │ │ -00008000: 2061 6e64 0a20 2020 2020 4153 2d52 4550   and.     AS-REP
│ │ │ │ -00008010: 3b20 7365 6520 e280 9873 6869 7368 695f  ; see ...shishi_
│ │ │ │ -00008020: 6b64 635f 7072 6f63 6573 7328 29e2 8099  kdc_process()...
│ │ │ │ -00008030: 2066 6f72 206d 6f72 6520 6465 7461 696c   for more detail
│ │ │ │ -00008040: 732e 0a0a 2020 2020 202a 5265 7475 726e  s...     *Return
│ │ │ │ -00008050: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ -00008060: 20e2 8098 5348 4953 4849 5f4f 4be2 8099   ...SHISHI_OK...
│ │ │ │ -00008070: 2069 6620 7375 6363 6573 7366 756c 2c0a   if successful,.
│ │ │ │ -00008080: 2020 2020 20e2 8098 5348 4953 4849 5f43       ...SHISHI_C
│ │ │ │ -00008090: 4e41 4d45 5f4d 4953 4d41 5443 48e2 8099  NAME_MISMATCH...
│ │ │ │ -000080a0: 2069 6620 7468 6520 6e61 6d65 7320 6469   if the names di
│ │ │ │ -000080b0: 6666 6572 2c20 616e 6420 616e 2065 7272  ffer, and an err
│ │ │ │ -000080c0: 6f72 2063 6f64 650a 2020 2020 206f 7468  or code.     oth
│ │ │ │ -000080d0: 6572 7769 7365 2e0a 0a73 6869 7368 695f  erwise...shishi_
│ │ │ │ -000080e0: 6b64 635f 636f 7079 5f6e 6f6e 6365 0a2d  kdc_copy_nonce.-
│ │ │ │ +00007920: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ +00007930: 6f6e 3a20 696e 7420 7368 6973 6869 5f61  on: int shishi_a
│ │ │ │ +00007940: 735f 6368 6563 6b5f 6372 6561 6c6d 2028  s_check_crealm (
│ │ │ │ +00007950: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ +00007960: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ +00007970: 695f 6173 6e31 2041 5352 4551 2c20 5368  i_asn1 ASREQ, Sh
│ │ │ │ +00007980: 6973 6869 5f61 736e 3120 4153 5245 5029  ishi_asn1 ASREP)
│ │ │ │ +00007990: 0a20 2020 2020 4841 4e44 4c45 3a20 5368  .     HANDLE: Sh
│ │ │ │ +000079a0: 6973 6869 2068 616e 646c 6520 6173 2061  ishi handle as a
│ │ │ │ +000079b0: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ +000079c0: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ +000079d0: 0a20 2020 2020 4153 5245 513a 2052 6571  .     ASREQ: Req
│ │ │ │ +000079e0: 7565 7374 206f 6620 7479 7065 2041 532d  uest of type AS-
│ │ │ │ +000079f0: 5245 512e 0a20 2020 2020 4153 5245 503a  REQ..     ASREP:
│ │ │ │ +00007a00: 2052 6570 6c79 2073 7472 7563 7475 7265   Reply structure
│ │ │ │ +00007a10: 206f 6620 7479 7065 2041 532d 5245 502e   of type AS-REP.
│ │ │ │ +00007a20: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ +00007a30: 696f 6e3a 2a20 5665 7269 6669 6573 2074  ion:* Verifies t
│ │ │ │ +00007a40: 6861 7420 7468 6520 6669 656c 6473 2041  hat the fields A
│ │ │ │ +00007a50: 5352 4551 2e72 6571 2d62 6f64 792e 7265  SREQ.req-body.re
│ │ │ │ +00007a60: 616c 6d20 616e 640a 2020 2020 2041 5352  alm and.     ASR
│ │ │ │ +00007a70: 4550 2e63 7265 616c 6d20 636f 6e74 6169  EP.crealm contai
│ │ │ │ +00007a80: 6e20 6964 656e 7469 6361 6c20 7265 616c  n identical real
│ │ │ │ +00007a90: 6d20 6e61 6d65 732e 2020 5468 6973 2069  m names.  This i
│ │ │ │ +00007aa0: 7320 6f6e 6520 6f66 2074 6865 0a20 2020  s one of the.   
│ │ │ │ +00007ab0: 2020 7374 6570 7320 7468 6174 2068 6173    steps that has
│ │ │ │ +00007ac0: 2074 6f20 6265 2070 6572 666f 726d 6564   to be performed
│ │ │ │ +00007ad0: 2077 6865 6e20 7072 6f63 6573 7369 6e67   when processing
│ │ │ │ +00007ae0: 2061 6e20 6578 6368 616e 6765 206f 660a   an exchange of.
│ │ │ │ +00007af0: 2020 2020 2041 532d 5245 5120 616e 6420       AS-REQ and 
│ │ │ │ +00007b00: 4153 2d52 4550 3b20 7365 6520 e280 9873  AS-REP; see ...s
│ │ │ │ +00007b10: 6869 7368 695f 6b64 635f 7072 6f63 6573  hishi_kdc_proces
│ │ │ │ +00007b20: 7328 29e2 8099 2066 6f72 206d 6f72 6520  s()... for more 
│ │ │ │ +00007b30: 6465 7461 696c 732e 0a0a 2020 2020 202a  details...     *
│ │ │ │ +00007b40: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ +00007b50: 6574 7572 6e73 20e2 8098 5348 4953 4849  eturns ...SHISHI
│ │ │ │ +00007b60: 5f4f 4be2 8099 2069 6620 7375 6363 6573  _OK... if succes
│ │ │ │ +00007b70: 7366 756c 2c0a 2020 2020 20e2 8098 5348  sful,.     ...SH
│ │ │ │ +00007b80: 4953 4849 5f52 4541 4c4d 5f4d 4953 4d41  ISHI_REALM_MISMA
│ │ │ │ +00007b90: 5443 48e2 8099 2077 6865 6e65 7665 7220  TCH... whenever 
│ │ │ │ +00007ba0: 7468 6520 7265 616c 6d20 6e61 6d65 7320  the realm names 
│ │ │ │ +00007bb0: 6469 6666 6572 2c20 616e 6420 616e 0a20  differ, and an. 
│ │ │ │ +00007bc0: 2020 2020 6572 726f 7220 636f 6465 206f      error code o
│ │ │ │ +00007bd0: 7468 6572 7769 7365 2e0a 0a73 6869 7368  therwise...shish
│ │ │ │ +00007be0: 695f 6b64 635f 636f 7079 5f63 6e61 6d65  i_kdc_copy_cname
│ │ │ │ +00007bf0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ +00007c00: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ +00007c10: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ +00007c20: 5f6b 6463 5f63 6f70 795f 636e 616d 6520  _kdc_copy_cname 
│ │ │ │ +00007c30: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ +00007c40: 2c0a 2020 2020 2020 2020 2020 5368 6973  ,.          Shis
│ │ │ │ +00007c50: 6869 5f61 736e 3120 4b44 4352 4550 2c20  hi_asn1 KDCREP, 
│ │ │ │ +00007c60: 5368 6973 6869 5f61 736e 3120 454e 4354  Shishi_asn1 ENCT
│ │ │ │ +00007c70: 4943 4b45 5450 4152 5429 0a20 2020 2020  ICKETPART).     
│ │ │ │ +00007c80: 4841 4e44 4c45 3a20 5368 6973 6869 2068  HANDLE: Shishi h
│ │ │ │ +00007c90: 616e 646c 6520 6173 2061 6c6c 6f63 6174  andle as allocat
│ │ │ │ +00007ca0: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ +00007cb0: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ +00007cc0: 4b44 4352 4550 3a20 4b44 432d 5245 5020  KDCREP: KDC-REP 
│ │ │ │ +00007cd0: 7768 6572 6520 7468 6520 6669 656c 6420  where the field 
│ │ │ │ +00007ce0: 2263 6e61 6d65 2220 6973 2075 7064 6174  "cname" is updat
│ │ │ │ +00007cf0: 6564 2e0a 2020 2020 2045 4e43 5449 434b  ed..     ENCTICK
│ │ │ │ +00007d00: 4554 5041 5254 3a20 456e 6354 6963 6b65  ETPART: EncTicke
│ │ │ │ +00007d10: 7450 6172 7420 7072 6f76 6964 696e 6720  tPart providing 
│ │ │ │ +00007d20: 2263 6e61 6d65 2220 6669 656c 642e 0a0a  "cname" field...
│ │ │ │ +00007d30: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ +00007d40: 6e3a 2a20 5265 6164 7320 7468 6520 6669  n:* Reads the fi
│ │ │ │ +00007d50: 656c 6420 2263 6e61 6d65 2220 6672 6f6d  eld "cname" from
│ │ │ │ +00007d60: 2074 6865 2074 6963 6b65 740a 2020 2020   the ticket.    
│ │ │ │ +00007d70: 2045 4e43 5449 434b 4554 5041 5254 2061   ENCTICKETPART a
│ │ │ │ +00007d80: 6e64 2063 6f70 6965 7320 7468 6520 7661  nd copies the va
│ │ │ │ +00007d90: 6c75 6520 696e 746f 2074 6865 2072 6570  lue into the rep
│ │ │ │ +00007da0: 6c79 204b 4443 5245 502e 0a0a 2020 2020  ly KDCREP...    
│ │ │ │ +00007db0: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ +00007dc0: 2052 6574 7572 6e73 20e2 8098 5348 4953   Returns ...SHIS
│ │ │ │ +00007dd0: 4849 5f4f 4be2 8099 2069 6620 7375 6363  HI_OK... if succ
│ │ │ │ +00007de0: 6573 7366 756c 2c20 616e 6420 4153 4e2e  essful, and ASN.
│ │ │ │ +00007df0: 310a 2020 2020 2066 6169 6c75 7265 7320  1.     failures 
│ │ │ │ +00007e00: 6f74 6865 7277 6973 652e 0a0a 7368 6973  otherwise...shis
│ │ │ │ +00007e10: 6869 5f61 735f 6368 6563 6b5f 636e 616d  hi_as_check_cnam
│ │ │ │ +00007e20: 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  e.--------------
│ │ │ │ +00007e30: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +00007e40: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ +00007e50: 695f 6173 5f63 6865 636b 5f63 6e61 6d65  i_as_check_cname
│ │ │ │ +00007e60: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ +00007e70: 452c 0a20 2020 2020 2020 2020 2053 6869  E,.          Shi
│ │ │ │ +00007e80: 7368 695f 6173 6e31 2041 5352 4551 2c20  shi_asn1 ASREQ, 
│ │ │ │ +00007e90: 5368 6973 6869 5f61 736e 3120 4153 5245  Shishi_asn1 ASRE
│ │ │ │ +00007ea0: 5029 0a20 2020 2020 4841 4e44 4c45 3a20  P).     HANDLE: 
│ │ │ │ +00007eb0: 5368 6973 6869 2068 616e 646c 6520 6173  Shishi handle as
│ │ │ │ +00007ec0: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ +00007ed0: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ +00007ee0: 992e 0a20 2020 2020 4153 5245 513a 2052  ...     ASREQ: R
│ │ │ │ +00007ef0: 6571 7565 7374 206f 6620 7479 7065 2041  equest of type A
│ │ │ │ +00007f00: 532d 5245 512e 0a20 2020 2020 4153 5245  S-REQ..     ASRE
│ │ │ │ +00007f10: 503a 2052 6570 6c79 2073 7472 7563 7475  P: Reply structu
│ │ │ │ +00007f20: 7265 206f 6620 7479 7065 2041 532d 5245  re of type AS-RE
│ │ │ │ +00007f30: 502e 0a0a 2020 2020 202a 4465 7363 7269  P...     *Descri
│ │ │ │ +00007f40: 7074 696f 6e3a 2a20 5665 7269 6669 6573  ption:* Verifies
│ │ │ │ +00007f50: 2074 6861 7420 7468 6520 6669 656c 6473   that the fields
│ │ │ │ +00007f60: 2041 5352 4551 2e72 6571 2d62 6f64 792e   ASREQ.req-body.
│ │ │ │ +00007f70: 636e 616d 6520 616e 640a 2020 2020 2041  cname and.     A
│ │ │ │ +00007f80: 5352 4550 2e63 6e61 6d65 2063 6f6e 7461  SREP.cname conta
│ │ │ │ +00007f90: 696e 2069 6465 6e74 6963 616c 206e 616d  in identical nam
│ │ │ │ +00007fa0: 6573 2e20 2054 6869 7320 6973 206f 6e65  es.  This is one
│ │ │ │ +00007fb0: 206f 6620 7468 6520 7374 6570 7320 7468   of the steps th
│ │ │ │ +00007fc0: 6174 0a20 2020 2020 6861 7320 746f 2062  at.     has to b
│ │ │ │ +00007fd0: 6520 7065 7266 6f72 6d65 6420 7768 656e  e performed when
│ │ │ │ +00007fe0: 2070 726f 6365 7373 696e 6720 616e 2065   processing an e
│ │ │ │ +00007ff0: 7863 6861 6e67 6520 6f66 2041 532d 5245  xchange of AS-RE
│ │ │ │ +00008000: 5120 616e 640a 2020 2020 2041 532d 5245  Q and.     AS-RE
│ │ │ │ +00008010: 503b 2073 6565 20e2 8098 7368 6973 6869  P; see ...shishi
│ │ │ │ +00008020: 5f6b 6463 5f70 726f 6365 7373 2829 e280  _kdc_process()..
│ │ │ │ +00008030: 9920 666f 7220 6d6f 7265 2064 6574 6169  . for more detai
│ │ │ │ +00008040: 6c73 2e0a 0a20 2020 2020 2a52 6574 7572  ls...     *Retur
│ │ │ │ +00008050: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ +00008060: 7320 e280 9853 4849 5348 495f 4f4b e280  s ...SHISHI_OK..
│ │ │ │ +00008070: 9920 6966 2073 7563 6365 7373 6675 6c2c  . if successful,
│ │ │ │ +00008080: 0a20 2020 2020 e280 9853 4849 5348 495f  .     ...SHISHI_
│ │ │ │ +00008090: 434e 414d 455f 4d49 534d 4154 4348 e280  CNAME_MISMATCH..
│ │ │ │ +000080a0: 9920 6966 2074 6865 206e 616d 6573 2064  . if the names d
│ │ │ │ +000080b0: 6966 6665 722c 2061 6e64 2061 6e20 6572  iffer, and an er
│ │ │ │ +000080c0: 726f 7220 636f 6465 0a20 2020 2020 6f74  ror code.     ot
│ │ │ │ +000080d0: 6865 7277 6973 652e 0a0a 7368 6973 6869  herwise...shishi
│ │ │ │ +000080e0: 5f6b 6463 5f63 6f70 795f 6e6f 6e63 650a  _kdc_copy_nonce.
│ │ │ │  000080f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00008100: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -00008110: 6f6e 3a20 696e 7420 7368 6973 6869 5f6b  on: int shishi_k
│ │ │ │ -00008120: 6463 5f63 6f70 795f 6e6f 6e63 6520 2853  dc_copy_nonce (S
│ │ │ │ -00008130: 6869 7368 6920 2a20 4841 4e44 4c45 2c0a  hishi * HANDLE,.
│ │ │ │ -00008140: 2020 2020 2020 2020 2020 5368 6973 6869            Shishi
│ │ │ │ -00008150: 5f61 736e 3120 4b44 4352 4551 2c20 5368  _asn1 KDCREQ, Sh
│ │ │ │ -00008160: 6973 6869 5f61 736e 3120 454e 434b 4443  ishi_asn1 ENCKDC
│ │ │ │ -00008170: 5245 5050 4152 5429 0a20 2020 2020 4841  REPPART).     HA
│ │ │ │ -00008180: 4e44 4c45 3a20 5368 6973 6869 2068 616e  NDLE: Shishi han
│ │ │ │ -00008190: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ -000081a0: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ -000081b0: 6974 2829 e280 992e 0a20 2020 2020 4b44  it().....     KD
│ │ │ │ -000081c0: 4352 4551 3a20 4b44 432d 5245 5120 7072  CREQ: KDC-REQ pr
│ │ │ │ -000081d0: 6f76 6964 696e 6720 226e 6f6e 6365 2220  oviding "nonce" 
│ │ │ │ -000081e0: 6669 656c 642e 0a20 2020 2020 454e 434b  field..     ENCK
│ │ │ │ -000081f0: 4443 5245 5050 4152 543a 2045 6e63 4b44  DCREPPART: EncKD
│ │ │ │ -00008200: 4352 6570 5061 7274 2077 6865 7265 2022  CRepPart where "
│ │ │ │ -00008210: 6e6f 6e63 6522 2066 6965 6c64 2069 7320  nonce" field is 
│ │ │ │ -00008220: 7570 6461 7465 642e 0a0a 2020 2020 202a  updated...     *
│ │ │ │ -00008230: 4465 7363 7269 7074 696f 6e3a 2a20 5365  Description:* Se
│ │ │ │ -00008240: 7473 2074 6865 2066 6965 6c64 2022 6e6f  ts the field "no
│ │ │ │ -00008250: 6e63 6522 2069 6e20 454e 434b 4443 5245  nce" in ENCKDCRE
│ │ │ │ -00008260: 5050 4152 5420 746f 2061 2076 616c 7565  PPART to a value
│ │ │ │ -00008270: 0a20 2020 2020 7265 7472 6569 7665 6420  .     retreived 
│ │ │ │ -00008280: 6672 6f6d 2074 6865 2063 6f72 7265 7370  from the corresp
│ │ │ │ -00008290: 6f6e 6469 6e67 2066 6965 6c64 2069 6e20  onding field in 
│ │ │ │ -000082a0: 4b44 4352 4551 2e0a 0a20 2020 2020 2a52  KDCREQ...     *R
│ │ │ │ -000082b0: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ -000082c0: 7475 726e 7320 e280 9853 4849 5348 495f  turns ...SHISHI_
│ │ │ │ -000082d0: 4f4b e280 9920 6966 2073 7563 6365 7373  OK... if success
│ │ │ │ -000082e0: 6675 6c2e 0a0a 7368 6973 6869 5f6b 6463  ful...shishi_kdc
│ │ │ │ -000082f0: 5f63 6865 636b 5f6e 6f6e 6365 0a2d 2d2d  _check_nonce.---
│ │ │ │ +00008100: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +00008110: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ +00008120: 6b64 635f 636f 7079 5f6e 6f6e 6365 2028  kdc_copy_nonce (
│ │ │ │ +00008130: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ +00008140: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ +00008150: 695f 6173 6e31 204b 4443 5245 512c 2053  i_asn1 KDCREQ, S
│ │ │ │ +00008160: 6869 7368 695f 6173 6e31 2045 4e43 4b44  hishi_asn1 ENCKD
│ │ │ │ +00008170: 4352 4550 5041 5254 290a 2020 2020 2048  CREPPART).     H
│ │ │ │ +00008180: 414e 444c 453a 2053 6869 7368 6920 6861  ANDLE: Shishi ha
│ │ │ │ +00008190: 6e64 6c65 2061 7320 616c 6c6f 6361 7465  ndle as allocate
│ │ │ │ +000081a0: 6420 6279 20e2 8098 7368 6973 6869 5f69  d by ...shishi_i
│ │ │ │ +000081b0: 6e69 7428 29e2 8099 2e0a 2020 2020 204b  nit().....     K
│ │ │ │ +000081c0: 4443 5245 513a 204b 4443 2d52 4551 2070  DCREQ: KDC-REQ p
│ │ │ │ +000081d0: 726f 7669 6469 6e67 2022 6e6f 6e63 6522  roviding "nonce"
│ │ │ │ +000081e0: 2066 6965 6c64 2e0a 2020 2020 2045 4e43   field..     ENC
│ │ │ │ +000081f0: 4b44 4352 4550 5041 5254 3a20 456e 634b  KDCREPPART: EncK
│ │ │ │ +00008200: 4443 5265 7050 6172 7420 7768 6572 6520  DCRepPart where 
│ │ │ │ +00008210: 226e 6f6e 6365 2220 6669 656c 6420 6973  "nonce" field is
│ │ │ │ +00008220: 2075 7064 6174 6564 2e0a 0a20 2020 2020   updated...     
│ │ │ │ +00008230: 2a44 6573 6372 6970 7469 6f6e 3a2a 2053  *Description:* S
│ │ │ │ +00008240: 6574 7320 7468 6520 6669 656c 6420 226e  ets the field "n
│ │ │ │ +00008250: 6f6e 6365 2220 696e 2045 4e43 4b44 4352  once" in ENCKDCR
│ │ │ │ +00008260: 4550 5041 5254 2074 6f20 6120 7661 6c75  EPPART to a valu
│ │ │ │ +00008270: 650a 2020 2020 2072 6574 7265 6976 6564  e.     retreived
│ │ │ │ +00008280: 2066 726f 6d20 7468 6520 636f 7272 6573   from the corres
│ │ │ │ +00008290: 706f 6e64 696e 6720 6669 656c 6420 696e  ponding field in
│ │ │ │ +000082a0: 204b 4443 5245 512e 0a0a 2020 2020 202a   KDCREQ...     *
│ │ │ │ +000082b0: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ +000082c0: 6574 7572 6e73 20e2 8098 5348 4953 4849  eturns ...SHISHI
│ │ │ │ +000082d0: 5f4f 4be2 8099 2069 6620 7375 6363 6573  _OK... if succes
│ │ │ │ +000082e0: 7366 756c 2e0a 0a73 6869 7368 695f 6b64  sful...shishi_kd
│ │ │ │ +000082f0: 635f 6368 6563 6b5f 6e6f 6e63 650a 2d2d  c_check_nonce.--
│ │ │ │  00008300: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00008310: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ -00008320: 6e3a 2069 6e74 2073 6869 7368 695f 6b64  n: int shishi_kd
│ │ │ │ -00008330: 635f 6368 6563 6b5f 6e6f 6e63 6520 2853  c_check_nonce (S
│ │ │ │ -00008340: 6869 7368 6920 2a20 4841 4e44 4c45 2c0a  hishi * HANDLE,.
│ │ │ │ -00008350: 2020 2020 2020 2020 2020 5368 6973 6869            Shishi
│ │ │ │ -00008360: 5f61 736e 3120 4b44 4352 4551 2c20 5368  _asn1 KDCREQ, Sh
│ │ │ │ -00008370: 6973 6869 5f61 736e 3120 454e 434b 4443  ishi_asn1 ENCKDC
│ │ │ │ -00008380: 5245 5050 4152 5429 0a20 2020 2020 4841  REPPART).     HA
│ │ │ │ -00008390: 4e44 4c45 3a20 5368 6973 6869 2068 616e  NDLE: Shishi han
│ │ │ │ -000083a0: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ -000083b0: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ -000083c0: 6974 2829 e280 992e 0a20 2020 2020 4b44  it().....     KD
│ │ │ │ -000083d0: 4352 4551 3a20 5265 7175 6573 7420 6f66  CREQ: Request of
│ │ │ │ -000083e0: 2074 7970 6520 4b44 432d 5245 512e 0a20   type KDC-REQ.. 
│ │ │ │ -000083f0: 2020 2020 454e 434b 4443 5245 5050 4152      ENCKDCREPPAR
│ │ │ │ -00008400: 543a 2045 6e63 7279 7074 6564 204b 4443  T: Encrypted KDC
│ │ │ │ -00008410: 2d52 4550 2070 6172 742e 0a0a 2020 2020  -REP part...    
│ │ │ │ -00008420: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ -00008430: 5665 7269 6669 6573 2074 6861 7420 4b44  Verifies that KD
│ │ │ │ -00008440: 4352 4551 2e72 6571 2d62 6f64 792e 6e6f  CREQ.req-body.no
│ │ │ │ -00008450: 6e63 6520 616e 640a 2020 2020 2045 4e43  nce and.     ENC
│ │ │ │ -00008460: 4b44 4352 4550 5041 5254 2e6e 6f6e 6365  KDCREPPART.nonce
│ │ │ │ -00008470: 2063 6f6e 7461 696e 206d 6174 6368 696e   contain matchin
│ │ │ │ -00008480: 6720 7661 6c75 6573 2e20 2054 6869 7320  g values.  This 
│ │ │ │ -00008490: 6973 206f 6e65 206f 6620 7468 650a 2020  is one of the.  
│ │ │ │ -000084a0: 2020 2073 7465 7073 2074 6861 7420 6861     steps that ha
│ │ │ │ -000084b0: 7320 746f 2062 6520 7065 7266 6f72 6d65  s to be performe
│ │ │ │ -000084c0: 6420 7768 656e 2070 726f 6365 7373 696e  d when processin
│ │ │ │ -000084d0: 6720 616e 2065 7863 6861 6e67 6520 6f66  g an exchange of
│ │ │ │ -000084e0: 0a20 2020 2020 4b44 432d 5245 5120 616e  .     KDC-REQ an
│ │ │ │ -000084f0: 6420 4b44 432d 5245 502e 0a0a 2020 2020  d KDC-REP...    
│ │ │ │ -00008500: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ -00008510: 2052 6574 7572 6e73 20e2 8098 5348 4953   Returns ...SHIS
│ │ │ │ -00008520: 4849 5f4f 4be2 8099 2069 6620 7375 6363  HI_OK... if succ
│ │ │ │ -00008530: 6573 7366 756c 2c0a 2020 2020 20e2 8098  essful,.     ...
│ │ │ │ -00008540: 5348 4953 4849 5f4e 4f4e 4345 5f4d 4953  SHISHI_NONCE_MIS
│ │ │ │ -00008550: 4d41 5443 48e2 8099 2077 6865 6e65 7665  MATCH... wheneve
│ │ │ │ -00008560: 7220 7468 6520 6e6f 6e63 6573 2061 7265  r the nonces are
│ │ │ │ -00008570: 206f 6620 6469 6666 6572 696e 670a 2020   of differing.  
│ │ │ │ -00008580: 2020 206c 656e 6774 6873 2028 7573 7561     lengths (usua
│ │ │ │ -00008590: 6c6c 7920 6120 7369 676e 2074 6861 7420  lly a sign that 
│ │ │ │ -000085a0: 6120 6275 6767 7920 7365 7276 6572 2074  a buggy server t
│ │ │ │ -000085b0: 7275 6e63 6174 6573 2074 6865 206e 6f6e  runcates the non
│ │ │ │ -000085c0: 6365 2074 6f0a 2020 2020 2034 2062 7974  ce to.     4 byt
│ │ │ │ -000085d0: 6573 2920 616e 6420 7468 6520 7361 6d65  es) and the same
│ │ │ │ -000085e0: 2063 6f64 6520 6966 2074 6865 206e 6f6e   code if the non
│ │ │ │ -000085f0: 6365 2076 616c 7565 7320 6469 6666 6572  ce values differ
│ │ │ │ -00008600: 2c20 6f72 2061 6e20 6572 726f 720a 2020  , or an error.  
│ │ │ │ -00008610: 2020 2063 6f64 6520 6f74 6865 7277 6973     code otherwis
│ │ │ │ -00008620: 652e 0a0a 7368 6973 6869 5f74 6773 5f70  e...shishi_tgs_p
│ │ │ │ -00008630: 726f 6365 7373 0a2d 2d2d 2d2d 2d2d 2d2d  rocess.---------
│ │ │ │ -00008640: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ -00008650: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ -00008660: 7368 695f 7467 735f 7072 6f63 6573 7320  shi_tgs_process 
│ │ │ │ -00008670: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ -00008680: 2c0a 2020 2020 2020 2020 2020 5368 6973  ,.          Shis
│ │ │ │ -00008690: 6869 5f61 736e 3120 5447 5352 4551 2c20  hi_asn1 TGSREQ, 
│ │ │ │ -000086a0: 5368 6973 6869 5f61 736e 3120 5447 5352  Shishi_asn1 TGSR
│ │ │ │ -000086b0: 4550 2c0a 2020 2020 2020 2020 2020 5368  EP,.          Sh
│ │ │ │ -000086c0: 6973 6869 5f61 736e 3120 4155 5448 454e  ishi_asn1 AUTHEN
│ │ │ │ -000086d0: 5449 4341 544f 522c 2053 6869 7368 695f  TICATOR, Shishi_
│ │ │ │ -000086e0: 6173 6e31 204f 4c44 454e 434b 4443 5245  asn1 OLDENCKDCRE
│ │ │ │ -000086f0: 5050 4152 542c 0a20 2020 2020 2020 2020  PPART,.         
│ │ │ │ -00008700: 2053 6869 7368 695f 6173 6e31 202a 2045   Shishi_asn1 * E
│ │ │ │ -00008710: 4e43 4b44 4352 4550 5041 5254 290a 2020  NCKDCREPPART).  
│ │ │ │ -00008720: 2020 2048 414e 444c 453a 2053 6869 7368     HANDLE: Shish
│ │ │ │ -00008730: 6920 6861 6e64 6c65 2061 7320 616c 6c6f  i handle as allo
│ │ │ │ -00008740: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ -00008750: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ -00008760: 2020 2054 4753 5245 513a 2049 6e70 7574     TGSREQ: Input
│ │ │ │ -00008770: 2076 6172 6961 626c 6520 686f 6c64 696e   variable holdin
│ │ │ │ -00008780: 6720 7468 6520 7472 616e 736d 6974 7465  g the transmitte
│ │ │ │ -00008790: 6420 4b44 432d 5245 512e 0a20 2020 2020  d KDC-REQ..     
│ │ │ │ -000087a0: 5447 5352 4550 3a20 496e 7075 7420 7661  TGSREP: Input va
│ │ │ │ -000087b0: 7269 6162 6c65 2068 6f6c 6469 6e67 2074  riable holding t
│ │ │ │ -000087c0: 6865 2072 6563 6569 7665 6420 4b44 432d  he received KDC-
│ │ │ │ -000087d0: 5245 502e 0a20 2020 2020 4155 5448 454e  REP..     AUTHEN
│ │ │ │ -000087e0: 5449 4341 544f 523a 2049 6e70 7574 2076  TICATOR: Input v
│ │ │ │ -000087f0: 6172 6961 626c 6520 7769 7468 2061 6e20  ariable with an 
│ │ │ │ -00008800: 6175 7468 656e 7469 6361 746f 7220 6578  authenticator ex
│ │ │ │ -00008810: 7472 6163 7465 6420 6672 6f6d 0a20 2020  tracted from.   
│ │ │ │ -00008820: 2020 7468 6520 4150 2d52 4551 2070 6172    the AP-REQ par
│ │ │ │ -00008830: 7420 6f66 2054 4753 5245 512e 0a20 2020  t of TGSREQ..   
│ │ │ │ -00008840: 2020 4f4c 4445 4e43 4b44 4352 4550 5041    OLDENCKDCREPPA
│ │ │ │ -00008850: 5254 3a20 496e 7075 7420 7661 7269 6162  RT: Input variab
│ │ │ │ -00008860: 6c65 2077 6974 6820 456e 634b 4443 5265  le with EncKDCRe
│ │ │ │ -00008870: 7050 6172 7420 7573 6564 2069 6e20 7468  pPart used in th
│ │ │ │ -00008880: 650a 2020 2020 2072 6571 7565 7374 2e0a  e.     request..
│ │ │ │ -00008890: 2020 2020 2045 4e43 4b44 4352 4550 5041       ENCKDCREPPA
│ │ │ │ -000088a0: 5254 3a20 4f75 7470 7574 2076 6172 6961  RT: Output varia
│ │ │ │ -000088b0: 626c 6520 686f 6c64 696e 6720 7468 6520  ble holding the 
│ │ │ │ -000088c0: 6e65 7720 456e 634b 4443 5265 7050 6172  new EncKDCRepPar
│ │ │ │ -000088d0: 742e 0a0a 2020 2020 202a 4465 7363 7269  t...     *Descri
│ │ │ │ -000088e0: 7074 696f 6e3a 2a20 5072 6f63 6573 7365  ption:* Processe
│ │ │ │ -000088f0: 7320 6120 5447 5320 636c 6965 6e74 2065  s a TGS client e
│ │ │ │ -00008900: 7863 6861 6e67 6520 616e 6420 6f75 7470  xchange and outp
│ │ │ │ -00008910: 7574 7320 7468 650a 2020 2020 2064 6563  uts the.     dec
│ │ │ │ -00008920: 7279 7074 6564 2045 6e63 4b44 4352 6570  rypted EncKDCRep
│ │ │ │ -00008930: 5061 7274 2c20 686f 6c64 696e 6720 6465  Part, holding de
│ │ │ │ -00008940: 7461 696c 7320 6162 6f75 7420 7468 6520  tails about the 
│ │ │ │ -00008950: 7265 6365 6976 6564 2074 6963 6b65 742e  received ticket.
│ │ │ │ -00008960: 0a20 2020 2020 5468 6973 2066 756e 6374  .     This funct
│ │ │ │ -00008970: 696f 6e20 7369 6d70 6c79 2064 6572 6976  ion simply deriv
│ │ │ │ -00008980: 6573 2074 6865 2065 6e63 7279 7074 696f  es the encryptio
│ │ │ │ -00008990: 6e20 6b65 7920 6672 6f6d 2074 6865 2074  n key from the t
│ │ │ │ -000089a0: 6963 6b65 740a 2020 2020 2075 7365 6420  icket.     used 
│ │ │ │ -000089b0: 746f 2063 6f6e 7374 7275 6374 2074 6865  to construct the
│ │ │ │ -000089c0: 206f 7269 6769 6e61 6c20 5447 5320 7265   original TGS re
│ │ │ │ -000089d0: 7175 6573 742c 2061 6e64 2074 6865 6e20  quest, and then 
│ │ │ │ -000089e0: 6361 6c6c 730a 2020 2020 20e2 8098 7368  calls.     ...sh
│ │ │ │ -000089f0: 6973 6869 5f6b 6463 5f70 726f 6365 7373  ishi_kdc_process
│ │ │ │ -00008a00: 2829 e280 992e 0a0a 2020 2020 202a 5265  ()......     *Re
│ │ │ │ -00008a10: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ -00008a20: 7572 6e73 20e2 8098 5348 4953 4849 5f4f  urns ...SHISHI_O
│ │ │ │ -00008a30: 4be2 8099 2069 6620 7468 6520 5447 5320  K... if the TGS 
│ │ │ │ -00008a40: 636c 6965 6e74 2065 7863 6861 6e67 6520  client exchange 
│ │ │ │ -00008a50: 7761 730a 2020 2020 2073 7563 6365 7373  was.     success
│ │ │ │ -00008a60: 6675 6c2e 2020 4661 696c 7572 6573 2069  ful.  Failures i
│ │ │ │ -00008a70: 6e63 6c75 6465 2041 534e 2e31 2061 6e64  nclude ASN.1 and
│ │ │ │ -00008a80: 2054 4753 2063 6f6e 6469 7469 6f6e 732e   TGS conditions.
│ │ │ │ -00008a90: 0a0a 7368 6973 6869 5f61 735f 7072 6f63  ..shishi_as_proc
│ │ │ │ -00008aa0: 6573 730a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ess.------------
│ │ │ │ -00008ab0: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ -00008ac0: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ -00008ad0: 6173 5f70 726f 6365 7373 2028 5368 6973  as_process (Shis
│ │ │ │ -00008ae0: 6869 202a 2048 414e 444c 452c 2053 6869  hi * HANDLE, Shi
│ │ │ │ -00008af0: 7368 695f 6173 6e31 2041 5352 4551 2c0a  shi_asn1 ASREQ,.
│ │ │ │ -00008b00: 2020 2020 2020 2020 2020 5368 6973 6869            Shishi
│ │ │ │ -00008b10: 5f61 736e 3120 4153 5245 502c 2063 6f6e  _asn1 ASREP, con
│ │ │ │ -00008b20: 7374 2063 6861 7220 2a20 5354 5249 4e47  st char * STRING
│ │ │ │ -00008b30: 2c0a 2020 2020 2020 2020 2020 5368 6973  ,.          Shis
│ │ │ │ -00008b40: 6869 5f61 736e 3120 2a20 454e 434b 4443  hi_asn1 * ENCKDC
│ │ │ │ -00008b50: 5245 5050 4152 5429 0a20 2020 2020 4841  REPPART).     HA
│ │ │ │ -00008b60: 4e44 4c45 3a20 5368 6973 6869 2068 616e  NDLE: Shishi han
│ │ │ │ -00008b70: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ -00008b80: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ -00008b90: 6974 2829 e280 992e 0a20 2020 2020 4153  it().....     AS
│ │ │ │ -00008ba0: 5245 513a 2049 6e70 7574 2076 6172 6961  REQ: Input varia
│ │ │ │ -00008bb0: 626c 6520 686f 6c64 696e 6720 7468 6520  ble holding the 
│ │ │ │ -00008bc0: 7472 616e 736d 6974 7465 6420 4b44 432d  transmitted KDC-
│ │ │ │ -00008bd0: 5245 512e 0a20 2020 2020 4153 5245 503a  REQ..     ASREP:
│ │ │ │ -00008be0: 2049 6e70 7574 2076 6172 6961 626c 6520   Input variable 
│ │ │ │ -00008bf0: 686f 6c64 696e 6720 7468 6520 7265 6365  holding the rece
│ │ │ │ -00008c00: 6976 6564 204b 4443 2d52 4550 2e0a 2020  ived KDC-REP..  
│ │ │ │ -00008c10: 2020 2053 5452 494e 473a 2049 6e70 7574     STRING: Input
│ │ │ │ -00008c20: 2076 6172 6961 626c 6520 7769 7468 2061   variable with a
│ │ │ │ -00008c30: 206e 756c 6c20 7465 726d 696e 6174 6564   null terminated
│ │ │ │ -00008c40: 2070 6173 7377 6f72 642e 0a20 2020 2020   password..     
│ │ │ │ -00008c50: 454e 434b 4443 5245 5050 4152 543a 204f  ENCKDCREPPART: O
│ │ │ │ -00008c60: 7574 7075 7420 7661 7269 6162 6c65 2072  utput variable r
│ │ │ │ -00008c70: 6574 7572 6e69 6e67 2061 206e 6577 2045  eturning a new E
│ │ │ │ -00008c80: 6e63 4b44 4352 6570 5061 7274 2e0a 0a20  ncKDCRepPart... 
│ │ │ │ -00008c90: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -00008ca0: 3a2a 2050 726f 6365 7373 6573 2061 6e20  :* Processes an 
│ │ │ │ -00008cb0: 4153 2063 6c69 656e 7420 6578 6368 616e  AS client exchan
│ │ │ │ -00008cc0: 6765 2061 6e64 2072 6574 7572 6e73 2074  ge and returns t
│ │ │ │ -00008cd0: 6865 0a20 2020 2020 6465 6372 7970 7465  he.     decrypte
│ │ │ │ -00008ce0: 6420 456e 634b 4443 5265 7050 6172 742c  d EncKDCRepPart,
│ │ │ │ -00008cf0: 2068 6f6c 6469 6e67 2064 6574 6169 6c73   holding details
│ │ │ │ -00008d00: 2061 626f 7574 2074 6865 2072 6563 6569   about the recei
│ │ │ │ -00008d10: 7665 6420 7469 636b 6574 2e0a 2020 2020  ved ticket..    
│ │ │ │ -00008d20: 2054 6869 7320 6675 6e63 7469 6f6e 2073   This function s
│ │ │ │ -00008d30: 696d 706c 7920 6465 7269 7665 7320 7468  imply derives th
│ │ │ │ -00008d40: 6520 656e 6372 7970 7469 6f6e 206b 6579  e encryption key
│ │ │ │ -00008d50: 2066 726f 6d20 7468 6520 7061 7373 776f   from the passwo
│ │ │ │ -00008d60: 7264 2c0a 2020 2020 2061 6e64 2074 6865  rd,.     and the
│ │ │ │ -00008d70: 6e20 6361 6c6c 7320 e280 9873 6869 7368  n calls ...shish
│ │ │ │ -00008d80: 695f 6b64 635f 7072 6f63 6573 7328 29e2  i_kdc_process().
│ │ │ │ -00008d90: 8099 2e0a 0a20 2020 2020 2a52 6574 7572  .....     *Retur
│ │ │ │ -00008da0: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ -00008db0: 7320 e280 9853 4849 5348 495f 4f4b e280  s ...SHISHI_OK..
│ │ │ │ -00008dc0: 9920 6966 2074 6865 2041 5320 636c 6965  . if the AS clie
│ │ │ │ -00008dd0: 6e74 2065 7863 6861 6e67 6520 7761 730a  nt exchange was.
│ │ │ │ -00008de0: 2020 2020 2073 7563 6365 7373 6675 6c2e       successful.
│ │ │ │ -00008df0: 2020 4d75 6c74 6970 6c65 2066 6169 6c75    Multiple failu
│ │ │ │ -00008e00: 7265 2063 6f6e 6469 7469 6f6e 7320 6172  re conditions ar
│ │ │ │ -00008e10: 6520 706f 7373 6962 6c65 2e0a 0a73 6869  e possible...shi
│ │ │ │ -00008e20: 7368 695f 6b64 635f 7072 6f63 6573 730a  shi_kdc_process.
│ │ │ │ -00008e30: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00008e40: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ -00008e50: 3a20 696e 7420 7368 6973 6869 5f6b 6463  : int shishi_kdc
│ │ │ │ -00008e60: 5f70 726f 6365 7373 2028 5368 6973 6869  _process (Shishi
│ │ │ │ -00008e70: 202a 2048 414e 444c 452c 0a20 2020 2020   * HANDLE,.     
│ │ │ │ -00008e80: 2020 2020 2053 6869 7368 695f 6173 6e31       Shishi_asn1
│ │ │ │ -00008e90: 204b 4443 5245 512c 2053 6869 7368 695f   KDCREQ, Shishi_
│ │ │ │ -00008ea0: 6173 6e31 204b 4443 5245 502c 2053 6869  asn1 KDCREP, Shi
│ │ │ │ -00008eb0: 7368 695f 6b65 7920 2a20 4b45 592c 0a20  shi_key * KEY,. 
│ │ │ │ -00008ec0: 2020 2020 2020 2020 2069 6e74 204b 4559           int KEY
│ │ │ │ -00008ed0: 5553 4147 452c 2053 6869 7368 695f 6173  USAGE, Shishi_as
│ │ │ │ -00008ee0: 6e31 202a 2045 4e43 4b44 4352 4550 5041  n1 * ENCKDCREPPA
│ │ │ │ -00008ef0: 5254 290a 2020 2020 2048 414e 444c 453a  RT).     HANDLE:
│ │ │ │ -00008f00: 2053 6869 7368 6920 6861 6e64 6c65 2061   Shishi handle a
│ │ │ │ -00008f10: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ -00008f20: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ -00008f30: 8099 2e0a 2020 2020 204b 4443 5245 513a  ....     KDCREQ:
│ │ │ │ -00008f40: 2049 6e70 7574 2076 6172 6961 626c 6520   Input variable 
│ │ │ │ -00008f50: 686f 6c64 696e 6720 7468 6520 7472 616e  holding the tran
│ │ │ │ -00008f60: 736d 6974 7465 6420 4b44 432d 5245 512e  smitted KDC-REQ.
│ │ │ │ -00008f70: 0a20 2020 2020 4b44 4352 4550 3a20 496e  .     KDCREP: In
│ │ │ │ -00008f80: 7075 7420 7661 7269 6162 6c65 2068 6f6c  put variable hol
│ │ │ │ -00008f90: 6469 6e67 2074 6865 2072 6563 6569 7665  ding the receive
│ │ │ │ -00008fa0: 6420 4b44 432d 5245 502e 0a20 2020 2020  d KDC-REP..     
│ │ │ │ -00008fb0: 4b45 593a 2049 6e70 7574 2070 6f69 6e74  KEY: Input point
│ │ │ │ -00008fc0: 6574 2074 6f20 6b65 7920 666f 7220 6465  et to key for de
│ │ │ │ -00008fd0: 6372 7970 7469 6e67 2070 6172 7473 206f  crypting parts o
│ │ │ │ -00008fe0: 6620 4b44 4352 4550 2e0a 2020 2020 204b  f KDCREP..     K
│ │ │ │ -00008ff0: 4559 5553 4147 453a 204b 6572 6265 726f  EYUSAGE: Kerbero
│ │ │ │ -00009000: 7320 6b65 7920 7573 6167 6520 636f 6465  s key usage code
│ │ │ │ -00009010: 2e0a 2020 2020 2045 4e43 4b44 4352 4550  ..     ENCKDCREP
│ │ │ │ -00009020: 5041 5254 3a20 4f75 7470 7574 2070 6f69  PART: Output poi
│ │ │ │ -00009030: 6e74 6572 2066 6f72 2074 6865 2065 7874  nter for the ext
│ │ │ │ -00009040: 7261 6374 6564 2045 6e63 4b44 4352 6570  racted EncKDCRep
│ │ │ │ -00009050: 5061 7274 2e0a 0a20 2020 2020 2a44 6573  Part...     *Des
│ │ │ │ -00009060: 6372 6970 7469 6f6e 3a2a 2050 726f 6365  cription:* Proce
│ │ │ │ -00009070: 7373 6573 2061 204b 4443 2063 6c69 656e  sses a KDC clien
│ │ │ │ -00009080: 7420 6578 6368 616e 6765 2061 6e64 2065  t exchange and e
│ │ │ │ -00009090: 7874 7261 6374 7320 610a 2020 2020 2064  xtracts a.     d
│ │ │ │ -000090a0: 6563 7279 7074 6564 2045 6e63 4b44 4352  ecrypted EncKDCR
│ │ │ │ -000090b0: 6570 5061 7274 2c20 686f 6c64 696e 6720  epPart, holding 
│ │ │ │ -000090c0: 6465 7461 696c 7320 6162 6f75 7420 7468  details about th
│ │ │ │ -000090d0: 6520 7265 6365 6976 6564 2074 6963 6b65  e received ticke
│ │ │ │ -000090e0: 742e 0a20 2020 2020 5573 6520 e280 9873  t..     Use ...s
│ │ │ │ -000090f0: 6869 7368 695f 6b64 6372 6570 5f67 6574  hishi_kdcrep_get
│ │ │ │ -00009100: 5f74 6963 6b65 7428 29e2 8099 2074 6f20  _ticket()... to 
│ │ │ │ -00009110: 6578 7472 6163 7420 7468 6520 7469 636b  extract the tick
│ │ │ │ -00009120: 6574 2069 7473 656c 662e 0a20 2020 2020  et itself..     
│ │ │ │ -00009130: 5468 6973 2066 756e 6374 696f 6e20 7665  This function ve
│ │ │ │ -00009140: 7269 6669 6573 2074 6865 2076 6172 696f  rifies the vario
│ │ │ │ -00009150: 7573 2063 6f6e 6469 7469 6f6e 7320 7468  us conditions th
│ │ │ │ -00009160: 6174 206d 7573 7420 686f 6c64 2069 6620  at must hold if 
│ │ │ │ -00009170: 7468 650a 2020 2020 2072 6573 706f 6e73  the.     respons
│ │ │ │ -00009180: 6520 6973 2074 6f20 6265 2063 6f6e 7369  e is to be consi
│ │ │ │ -00009190: 6465 7265 6420 7661 6c69 642e 2020 496e  dered valid.  In
│ │ │ │ -000091a0: 2070 6172 7469 6375 6c61 722c 2069 7420   particular, it 
│ │ │ │ -000091b0: 636f 6d70 6172 6573 0a20 2020 2020 6e6f  compares.     no
│ │ │ │ -000091c0: 6e63 6573 2028 7573 696e 6720 e280 9873  nces (using ...s
│ │ │ │ -000091d0: 6869 7368 695f 6b64 635f 6368 6563 6b5f  hishi_kdc_check_
│ │ │ │ -000091e0: 6e6f 6e63 6528 29e2 8099 292c 2061 6e64  nonce()...), and
│ │ │ │ -000091f0: 2069 6620 7468 6520 6578 6368 616e 6765   if the exchange
│ │ │ │ -00009200: 2077 6173 0a20 2020 2020 616e 2041 5320   was.     an AS 
│ │ │ │ -00009210: 6578 6368 616e 6765 2c20 6974 2061 6c73  exchange, it als
│ │ │ │ -00009220: 6f20 6368 6563 6b73 2063 6e61 6d65 2061  o checks cname a
│ │ │ │ -00009230: 6e64 2063 7265 616c 6d20 2875 7369 6e67  nd crealm (using
│ │ │ │ -00009240: 0a20 2020 2020 e280 9873 6869 7368 695f  .     ...shishi_
│ │ │ │ -00009250: 6173 5f63 6865 636b 5f63 6e61 6d65 2829  as_check_cname()
│ │ │ │ -00009260: e280 992c 20e2 8098 7368 6973 6869 5f61  ..., ...shishi_a
│ │ │ │ -00009270: 735f 6368 6563 6b5f 6372 6561 6c6d 2829  s_check_crealm()
│ │ │ │ -00009280: e280 9929 2e0a 0a20 2020 2020 5573 7561  ...)...     Usua
│ │ │ │ -00009290: 6c6c 7920 e280 9873 6869 7368 695f 6173  lly ...shishi_as
│ │ │ │ -000092a0: 5f70 726f 6365 7373 2829 e280 9920 616e  _process()... an
│ │ │ │ -000092b0: 6420 e280 9873 6869 7368 695f 7467 735f  d ...shishi_tgs_
│ │ │ │ -000092c0: 7072 6f63 6573 7328 29e2 8099 2073 686f  process()... sho
│ │ │ │ -000092d0: 756c 6420 6265 0a20 2020 2020 7573 6564  uld be.     used
│ │ │ │ -000092e0: 2069 6e73 7465 6164 206f 6620 7468 6973   instead of this
│ │ │ │ -000092f0: 2063 616c 6c2c 2073 696e 6365 2074 6865   call, since the
│ │ │ │ -00009300: 7920 7369 6d70 6c69 6679 2063 6f6d 7075  y simplify compu
│ │ │ │ -00009310: 7461 7469 6f6e 206f 6620 7468 650a 2020  tation of the.  
│ │ │ │ -00009320: 2020 2064 6563 7279 7074 696f 6e20 6b65     decryption ke
│ │ │ │ -00009330: 792e 0a0a 2020 2020 202a 5265 7475 726e  y...     *Return
│ │ │ │ -00009340: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ -00009350: 20e2 8098 5348 4953 4849 5f4f 4be2 8099   ...SHISHI_OK...
│ │ │ │ -00009360: 2069 6620 7468 6520 4b44 4320 636c 6965   if the KDC clie
│ │ │ │ -00009370: 6e74 2065 7863 6861 6e67 6520 7761 730a  nt exchange was.
│ │ │ │ -00009380: 2020 2020 2073 7563 6365 7373 6675 6c2e       successful.
│ │ │ │ -00009390: 2020 4d75 6c74 6970 6c65 2066 6169 6c75    Multiple failu
│ │ │ │ -000093a0: 7265 2063 6f6e 6469 7469 6f6e 7320 6172  re conditions ar
│ │ │ │ -000093b0: 6520 706f 7373 6962 6c65 2e0a 0a73 6869  e possible...shi
│ │ │ │ -000093c0: 7368 695f 6173 7265 710a 2d2d 2d2d 2d2d  shi_asreq.------
│ │ │ │ -000093d0: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ -000093e0: 7469 6f6e 3a20 5368 6973 6869 5f61 736e  tion: Shishi_asn
│ │ │ │ -000093f0: 3120 7368 6973 6869 5f61 7372 6571 2028  1 shishi_asreq (
│ │ │ │ -00009400: 5368 6973 6869 202a 2048 414e 444c 4529  Shishi * HANDLE)
│ │ │ │ -00009410: 0a20 2020 2020 4841 4e44 4c45 3a20 7368  .     HANDLE: sh
│ │ │ │ -00009420: 6973 6869 2068 616e 646c 6520 6173 2061  ishi handle as a
│ │ │ │ -00009430: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ -00009440: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ -00009450: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ -00009460: 696f 6e3a 2a20 5468 6973 2066 756e 6374  ion:* This funct
│ │ │ │ -00009470: 696f 6e20 6372 6561 7465 7320 6120 6e65  ion creates a ne
│ │ │ │ -00009480: 7720 4153 2d52 4551 2c20 706f 7075 6c61  w AS-REQ, popula
│ │ │ │ -00009490: 7465 6420 7769 7468 0a20 2020 2020 736f  ted with.     so
│ │ │ │ -000094a0: 6d65 2064 6566 6175 6c74 2076 616c 7565  me default value
│ │ │ │ -000094b0: 732e 0a0a 2020 2020 202a 5265 7475 726e  s...     *Return
│ │ │ │ -000094c0: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ -000094d0: 2074 6865 2041 532d 5245 5120 6f72 204e   the AS-REQ or N
│ │ │ │ -000094e0: 554c 4c20 6f6e 2066 6169 6c75 7265 2e0a  ULL on failure..
│ │ │ │ -000094f0: 0a73 6869 7368 695f 7467 7372 6571 0a2d  .shishi_tgsreq.-
│ │ │ │ -00009500: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ -00009510: 2d20 4675 6e63 7469 6f6e 3a20 5368 6973  - Function: Shis
│ │ │ │ -00009520: 6869 5f61 736e 3120 7368 6973 6869 5f74  hi_asn1 shishi_t
│ │ │ │ -00009530: 6773 7265 7120 2853 6869 7368 6920 2a20  gsreq (Shishi * 
│ │ │ │ -00009540: 4841 4e44 4c45 290a 2020 2020 2048 414e  HANDLE).     HAN
│ │ │ │ -00009550: 444c 453a 2073 6869 7368 6920 6861 6e64  DLE: shishi hand
│ │ │ │ -00009560: 6c65 2061 7320 616c 6c6f 6361 7465 6420  le as allocated 
│ │ │ │ -00009570: 6279 20e2 8098 7368 6973 6869 5f69 6e69  by ...shishi_ini
│ │ │ │ -00009580: 7428 29e2 8099 2e0a 0a20 2020 2020 2a44  t()......     *D
│ │ │ │ -00009590: 6573 6372 6970 7469 6f6e 3a2a 2054 6869  escription:* Thi
│ │ │ │ -000095a0: 7320 6675 6e63 7469 6f6e 2063 7265 6174  s function creat
│ │ │ │ -000095b0: 6573 2061 206e 6577 2054 4753 2d52 4551  es a new TGS-REQ
│ │ │ │ -000095c0: 2c20 706f 7075 6c61 7465 6420 7769 7468  , populated with
│ │ │ │ -000095d0: 0a20 2020 2020 736f 6d65 2064 6566 6175  .     some defau
│ │ │ │ -000095e0: 6c74 2076 616c 7565 732e 0a0a 2020 2020  lt values...    
│ │ │ │ -000095f0: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ -00009600: 2052 6574 7572 6e73 2074 6865 2054 4753   Returns the TGS
│ │ │ │ -00009610: 2d52 4551 206f 7220 4e55 4c4c 206f 6e20  -REQ or NULL on 
│ │ │ │ -00009620: 6661 696c 7572 652e 0a0a 7368 6973 6869  failure...shishi
│ │ │ │ -00009630: 5f6b 6463 7265 715f 7072 696e 740a 2d2d  _kdcreq_print.--
│ │ │ │ +00008310: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ +00008320: 6f6e 3a20 696e 7420 7368 6973 6869 5f6b  on: int shishi_k
│ │ │ │ +00008330: 6463 5f63 6865 636b 5f6e 6f6e 6365 2028  dc_check_nonce (
│ │ │ │ +00008340: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ +00008350: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ +00008360: 695f 6173 6e31 204b 4443 5245 512c 2053  i_asn1 KDCREQ, S
│ │ │ │ +00008370: 6869 7368 695f 6173 6e31 2045 4e43 4b44  hishi_asn1 ENCKD
│ │ │ │ +00008380: 4352 4550 5041 5254 290a 2020 2020 2048  CREPPART).     H
│ │ │ │ +00008390: 414e 444c 453a 2053 6869 7368 6920 6861  ANDLE: Shishi ha
│ │ │ │ +000083a0: 6e64 6c65 2061 7320 616c 6c6f 6361 7465  ndle as allocate
│ │ │ │ +000083b0: 6420 6279 20e2 8098 7368 6973 6869 5f69  d by ...shishi_i
│ │ │ │ +000083c0: 6e69 7428 29e2 8099 2e0a 2020 2020 204b  nit().....     K
│ │ │ │ +000083d0: 4443 5245 513a 2052 6571 7565 7374 206f  DCREQ: Request o
│ │ │ │ +000083e0: 6620 7479 7065 204b 4443 2d52 4551 2e0a  f type KDC-REQ..
│ │ │ │ +000083f0: 2020 2020 2045 4e43 4b44 4352 4550 5041       ENCKDCREPPA
│ │ │ │ +00008400: 5254 3a20 456e 6372 7970 7465 6420 4b44  RT: Encrypted KD
│ │ │ │ +00008410: 432d 5245 5020 7061 7274 2e0a 0a20 2020  C-REP part...   
│ │ │ │ +00008420: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ +00008430: 2056 6572 6966 6965 7320 7468 6174 204b   Verifies that K
│ │ │ │ +00008440: 4443 5245 512e 7265 712d 626f 6479 2e6e  DCREQ.req-body.n
│ │ │ │ +00008450: 6f6e 6365 2061 6e64 0a20 2020 2020 454e  once and.     EN
│ │ │ │ +00008460: 434b 4443 5245 5050 4152 542e 6e6f 6e63  CKDCREPPART.nonc
│ │ │ │ +00008470: 6520 636f 6e74 6169 6e20 6d61 7463 6869  e contain matchi
│ │ │ │ +00008480: 6e67 2076 616c 7565 732e 2020 5468 6973  ng values.  This
│ │ │ │ +00008490: 2069 7320 6f6e 6520 6f66 2074 6865 0a20   is one of the. 
│ │ │ │ +000084a0: 2020 2020 7374 6570 7320 7468 6174 2068      steps that h
│ │ │ │ +000084b0: 6173 2074 6f20 6265 2070 6572 666f 726d  as to be perform
│ │ │ │ +000084c0: 6564 2077 6865 6e20 7072 6f63 6573 7369  ed when processi
│ │ │ │ +000084d0: 6e67 2061 6e20 6578 6368 616e 6765 206f  ng an exchange o
│ │ │ │ +000084e0: 660a 2020 2020 204b 4443 2d52 4551 2061  f.     KDC-REQ a
│ │ │ │ +000084f0: 6e64 204b 4443 2d52 4550 2e0a 0a20 2020  nd KDC-REP...   
│ │ │ │ +00008500: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ +00008510: 2a20 5265 7475 726e 7320 e280 9853 4849  * Returns ...SHI
│ │ │ │ +00008520: 5348 495f 4f4b e280 9920 6966 2073 7563  SHI_OK... if suc
│ │ │ │ +00008530: 6365 7373 6675 6c2c 0a20 2020 2020 e280  cessful,.     ..
│ │ │ │ +00008540: 9853 4849 5348 495f 4e4f 4e43 455f 4d49  .SHISHI_NONCE_MI
│ │ │ │ +00008550: 534d 4154 4348 e280 9920 7768 656e 6576  SMATCH... whenev
│ │ │ │ +00008560: 6572 2074 6865 206e 6f6e 6365 7320 6172  er the nonces ar
│ │ │ │ +00008570: 6520 6f66 2064 6966 6665 7269 6e67 0a20  e of differing. 
│ │ │ │ +00008580: 2020 2020 6c65 6e67 7468 7320 2875 7375      lengths (usu
│ │ │ │ +00008590: 616c 6c79 2061 2073 6967 6e20 7468 6174  ally a sign that
│ │ │ │ +000085a0: 2061 2062 7567 6779 2073 6572 7665 7220   a buggy server 
│ │ │ │ +000085b0: 7472 756e 6361 7465 7320 7468 6520 6e6f  truncates the no
│ │ │ │ +000085c0: 6e63 6520 746f 0a20 2020 2020 3420 6279  nce to.     4 by
│ │ │ │ +000085d0: 7465 7329 2061 6e64 2074 6865 2073 616d  tes) and the sam
│ │ │ │ +000085e0: 6520 636f 6465 2069 6620 7468 6520 6e6f  e code if the no
│ │ │ │ +000085f0: 6e63 6520 7661 6c75 6573 2064 6966 6665  nce values diffe
│ │ │ │ +00008600: 722c 206f 7220 616e 2065 7272 6f72 0a20  r, or an error. 
│ │ │ │ +00008610: 2020 2020 636f 6465 206f 7468 6572 7769      code otherwi
│ │ │ │ +00008620: 7365 2e0a 0a73 6869 7368 695f 7467 735f  se...shishi_tgs_
│ │ │ │ +00008630: 7072 6f63 6573 730a 2d2d 2d2d 2d2d 2d2d  process.--------
│ │ │ │ +00008640: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +00008650: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ +00008660: 6973 6869 5f74 6773 5f70 726f 6365 7373  ishi_tgs_process
│ │ │ │ +00008670: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ +00008680: 452c 0a20 2020 2020 2020 2020 2053 6869  E,.          Shi
│ │ │ │ +00008690: 7368 695f 6173 6e31 2054 4753 5245 512c  shi_asn1 TGSREQ,
│ │ │ │ +000086a0: 2053 6869 7368 695f 6173 6e31 2054 4753   Shishi_asn1 TGS
│ │ │ │ +000086b0: 5245 502c 0a20 2020 2020 2020 2020 2053  REP,.          S
│ │ │ │ +000086c0: 6869 7368 695f 6173 6e31 2041 5554 4845  hishi_asn1 AUTHE
│ │ │ │ +000086d0: 4e54 4943 4154 4f52 2c20 5368 6973 6869  NTICATOR, Shishi
│ │ │ │ +000086e0: 5f61 736e 3120 4f4c 4445 4e43 4b44 4352  _asn1 OLDENCKDCR
│ │ │ │ +000086f0: 4550 5041 5254 2c0a 2020 2020 2020 2020  EPPART,.        
│ │ │ │ +00008700: 2020 5368 6973 6869 5f61 736e 3120 2a20    Shishi_asn1 * 
│ │ │ │ +00008710: 454e 434b 4443 5245 5050 4152 5429 0a20  ENCKDCREPPART). 
│ │ │ │ +00008720: 2020 2020 4841 4e44 4c45 3a20 5368 6973      HANDLE: Shis
│ │ │ │ +00008730: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ +00008740: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ +00008750: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ +00008760: 2020 2020 5447 5352 4551 3a20 496e 7075      TGSREQ: Inpu
│ │ │ │ +00008770: 7420 7661 7269 6162 6c65 2068 6f6c 6469  t variable holdi
│ │ │ │ +00008780: 6e67 2074 6865 2074 7261 6e73 6d69 7474  ng the transmitt
│ │ │ │ +00008790: 6564 204b 4443 2d52 4551 2e0a 2020 2020  ed KDC-REQ..    
│ │ │ │ +000087a0: 2054 4753 5245 503a 2049 6e70 7574 2076   TGSREP: Input v
│ │ │ │ +000087b0: 6172 6961 626c 6520 686f 6c64 696e 6720  ariable holding 
│ │ │ │ +000087c0: 7468 6520 7265 6365 6976 6564 204b 4443  the received KDC
│ │ │ │ +000087d0: 2d52 4550 2e0a 2020 2020 2041 5554 4845  -REP..     AUTHE
│ │ │ │ +000087e0: 4e54 4943 4154 4f52 3a20 496e 7075 7420  NTICATOR: Input 
│ │ │ │ +000087f0: 7661 7269 6162 6c65 2077 6974 6820 616e  variable with an
│ │ │ │ +00008800: 2061 7574 6865 6e74 6963 6174 6f72 2065   authenticator e
│ │ │ │ +00008810: 7874 7261 6374 6564 2066 726f 6d0a 2020  xtracted from.  
│ │ │ │ +00008820: 2020 2074 6865 2041 502d 5245 5120 7061     the AP-REQ pa
│ │ │ │ +00008830: 7274 206f 6620 5447 5352 4551 2e0a 2020  rt of TGSREQ..  
│ │ │ │ +00008840: 2020 204f 4c44 454e 434b 4443 5245 5050     OLDENCKDCREPP
│ │ │ │ +00008850: 4152 543a 2049 6e70 7574 2076 6172 6961  ART: Input varia
│ │ │ │ +00008860: 626c 6520 7769 7468 2045 6e63 4b44 4352  ble with EncKDCR
│ │ │ │ +00008870: 6570 5061 7274 2075 7365 6420 696e 2074  epPart used in t
│ │ │ │ +00008880: 6865 0a20 2020 2020 7265 7175 6573 742e  he.     request.
│ │ │ │ +00008890: 0a20 2020 2020 454e 434b 4443 5245 5050  .     ENCKDCREPP
│ │ │ │ +000088a0: 4152 543a 204f 7574 7075 7420 7661 7269  ART: Output vari
│ │ │ │ +000088b0: 6162 6c65 2068 6f6c 6469 6e67 2074 6865  able holding the
│ │ │ │ +000088c0: 206e 6577 2045 6e63 4b44 4352 6570 5061   new EncKDCRepPa
│ │ │ │ +000088d0: 7274 2e0a 0a20 2020 2020 2a44 6573 6372  rt...     *Descr
│ │ │ │ +000088e0: 6970 7469 6f6e 3a2a 2050 726f 6365 7373  iption:* Process
│ │ │ │ +000088f0: 6573 2061 2054 4753 2063 6c69 656e 7420  es a TGS client 
│ │ │ │ +00008900: 6578 6368 616e 6765 2061 6e64 206f 7574  exchange and out
│ │ │ │ +00008910: 7075 7473 2074 6865 0a20 2020 2020 6465  puts the.     de
│ │ │ │ +00008920: 6372 7970 7465 6420 456e 634b 4443 5265  crypted EncKDCRe
│ │ │ │ +00008930: 7050 6172 742c 2068 6f6c 6469 6e67 2064  pPart, holding d
│ │ │ │ +00008940: 6574 6169 6c73 2061 626f 7574 2074 6865  etails about the
│ │ │ │ +00008950: 2072 6563 6569 7665 6420 7469 636b 6574   received ticket
│ │ │ │ +00008960: 2e0a 2020 2020 2054 6869 7320 6675 6e63  ..     This func
│ │ │ │ +00008970: 7469 6f6e 2073 696d 706c 7920 6465 7269  tion simply deri
│ │ │ │ +00008980: 7665 7320 7468 6520 656e 6372 7970 7469  ves the encrypti
│ │ │ │ +00008990: 6f6e 206b 6579 2066 726f 6d20 7468 6520  on key from the 
│ │ │ │ +000089a0: 7469 636b 6574 0a20 2020 2020 7573 6564  ticket.     used
│ │ │ │ +000089b0: 2074 6f20 636f 6e73 7472 7563 7420 7468   to construct th
│ │ │ │ +000089c0: 6520 6f72 6967 696e 616c 2054 4753 2072  e original TGS r
│ │ │ │ +000089d0: 6571 7565 7374 2c20 616e 6420 7468 656e  equest, and then
│ │ │ │ +000089e0: 2063 616c 6c73 0a20 2020 2020 e280 9873   calls.     ...s
│ │ │ │ +000089f0: 6869 7368 695f 6b64 635f 7072 6f63 6573  hishi_kdc_proces
│ │ │ │ +00008a00: 7328 29e2 8099 2e0a 0a20 2020 2020 2a52  s()......     *R
│ │ │ │ +00008a10: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +00008a20: 7475 726e 7320 e280 9853 4849 5348 495f  turns ...SHISHI_
│ │ │ │ +00008a30: 4f4b e280 9920 6966 2074 6865 2054 4753  OK... if the TGS
│ │ │ │ +00008a40: 2063 6c69 656e 7420 6578 6368 616e 6765   client exchange
│ │ │ │ +00008a50: 2077 6173 0a20 2020 2020 7375 6363 6573   was.     succes
│ │ │ │ +00008a60: 7366 756c 2e20 2046 6169 6c75 7265 7320  sful.  Failures 
│ │ │ │ +00008a70: 696e 636c 7564 6520 4153 4e2e 3120 616e  include ASN.1 an
│ │ │ │ +00008a80: 6420 5447 5320 636f 6e64 6974 696f 6e73  d TGS conditions
│ │ │ │ +00008a90: 2e0a 0a73 6869 7368 695f 6173 5f70 726f  ...shishi_as_pro
│ │ │ │ +00008aa0: 6365 7373 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  cess.-----------
│ │ │ │ +00008ab0: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ +00008ac0: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ +00008ad0: 5f61 735f 7072 6f63 6573 7320 2853 6869  _as_process (Shi
│ │ │ │ +00008ae0: 7368 6920 2a20 4841 4e44 4c45 2c20 5368  shi * HANDLE, Sh
│ │ │ │ +00008af0: 6973 6869 5f61 736e 3120 4153 5245 512c  ishi_asn1 ASREQ,
│ │ │ │ +00008b00: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ +00008b10: 695f 6173 6e31 2041 5352 4550 2c20 636f  i_asn1 ASREP, co
│ │ │ │ +00008b20: 6e73 7420 6368 6172 202a 2053 5452 494e  nst char * STRIN
│ │ │ │ +00008b30: 472c 0a20 2020 2020 2020 2020 2053 6869  G,.          Shi
│ │ │ │ +00008b40: 7368 695f 6173 6e31 202a 2045 4e43 4b44  shi_asn1 * ENCKD
│ │ │ │ +00008b50: 4352 4550 5041 5254 290a 2020 2020 2048  CREPPART).     H
│ │ │ │ +00008b60: 414e 444c 453a 2053 6869 7368 6920 6861  ANDLE: Shishi ha
│ │ │ │ +00008b70: 6e64 6c65 2061 7320 616c 6c6f 6361 7465  ndle as allocate
│ │ │ │ +00008b80: 6420 6279 20e2 8098 7368 6973 6869 5f69  d by ...shishi_i
│ │ │ │ +00008b90: 6e69 7428 29e2 8099 2e0a 2020 2020 2041  nit().....     A
│ │ │ │ +00008ba0: 5352 4551 3a20 496e 7075 7420 7661 7269  SREQ: Input vari
│ │ │ │ +00008bb0: 6162 6c65 2068 6f6c 6469 6e67 2074 6865  able holding the
│ │ │ │ +00008bc0: 2074 7261 6e73 6d69 7474 6564 204b 4443   transmitted KDC
│ │ │ │ +00008bd0: 2d52 4551 2e0a 2020 2020 2041 5352 4550  -REQ..     ASREP
│ │ │ │ +00008be0: 3a20 496e 7075 7420 7661 7269 6162 6c65  : Input variable
│ │ │ │ +00008bf0: 2068 6f6c 6469 6e67 2074 6865 2072 6563   holding the rec
│ │ │ │ +00008c00: 6569 7665 6420 4b44 432d 5245 502e 0a20  eived KDC-REP.. 
│ │ │ │ +00008c10: 2020 2020 5354 5249 4e47 3a20 496e 7075      STRING: Inpu
│ │ │ │ +00008c20: 7420 7661 7269 6162 6c65 2077 6974 6820  t variable with 
│ │ │ │ +00008c30: 6120 6e75 6c6c 2074 6572 6d69 6e61 7465  a null terminate
│ │ │ │ +00008c40: 6420 7061 7373 776f 7264 2e0a 2020 2020  d password..    
│ │ │ │ +00008c50: 2045 4e43 4b44 4352 4550 5041 5254 3a20   ENCKDCREPPART: 
│ │ │ │ +00008c60: 4f75 7470 7574 2076 6172 6961 626c 6520  Output variable 
│ │ │ │ +00008c70: 7265 7475 726e 696e 6720 6120 6e65 7720  returning a new 
│ │ │ │ +00008c80: 456e 634b 4443 5265 7050 6172 742e 0a0a  EncKDCRepPart...
│ │ │ │ +00008c90: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ +00008ca0: 6e3a 2a20 5072 6f63 6573 7365 7320 616e  n:* Processes an
│ │ │ │ +00008cb0: 2041 5320 636c 6965 6e74 2065 7863 6861   AS client excha
│ │ │ │ +00008cc0: 6e67 6520 616e 6420 7265 7475 726e 7320  nge and returns 
│ │ │ │ +00008cd0: 7468 650a 2020 2020 2064 6563 7279 7074  the.     decrypt
│ │ │ │ +00008ce0: 6564 2045 6e63 4b44 4352 6570 5061 7274  ed EncKDCRepPart
│ │ │ │ +00008cf0: 2c20 686f 6c64 696e 6720 6465 7461 696c  , holding detail
│ │ │ │ +00008d00: 7320 6162 6f75 7420 7468 6520 7265 6365  s about the rece
│ │ │ │ +00008d10: 6976 6564 2074 6963 6b65 742e 0a20 2020  ived ticket..   
│ │ │ │ +00008d20: 2020 5468 6973 2066 756e 6374 696f 6e20    This function 
│ │ │ │ +00008d30: 7369 6d70 6c79 2064 6572 6976 6573 2074  simply derives t
│ │ │ │ +00008d40: 6865 2065 6e63 7279 7074 696f 6e20 6b65  he encryption ke
│ │ │ │ +00008d50: 7920 6672 6f6d 2074 6865 2070 6173 7377  y from the passw
│ │ │ │ +00008d60: 6f72 642c 0a20 2020 2020 616e 6420 7468  ord,.     and th
│ │ │ │ +00008d70: 656e 2063 616c 6c73 20e2 8098 7368 6973  en calls ...shis
│ │ │ │ +00008d80: 6869 5f6b 6463 5f70 726f 6365 7373 2829  hi_kdc_process()
│ │ │ │ +00008d90: e280 992e 0a0a 2020 2020 202a 5265 7475  ......     *Retu
│ │ │ │ +00008da0: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ +00008db0: 6e73 20e2 8098 5348 4953 4849 5f4f 4be2  ns ...SHISHI_OK.
│ │ │ │ +00008dc0: 8099 2069 6620 7468 6520 4153 2063 6c69  .. if the AS cli
│ │ │ │ +00008dd0: 656e 7420 6578 6368 616e 6765 2077 6173  ent exchange was
│ │ │ │ +00008de0: 0a20 2020 2020 7375 6363 6573 7366 756c  .     successful
│ │ │ │ +00008df0: 2e20 204d 756c 7469 706c 6520 6661 696c  .  Multiple fail
│ │ │ │ +00008e00: 7572 6520 636f 6e64 6974 696f 6e73 2061  ure conditions a
│ │ │ │ +00008e10: 7265 2070 6f73 7369 626c 652e 0a0a 7368  re possible...sh
│ │ │ │ +00008e20: 6973 6869 5f6b 6463 5f70 726f 6365 7373  ishi_kdc_process
│ │ │ │ +00008e30: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ +00008e40: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ +00008e50: 6e3a 2069 6e74 2073 6869 7368 695f 6b64  n: int shishi_kd
│ │ │ │ +00008e60: 635f 7072 6f63 6573 7320 2853 6869 7368  c_process (Shish
│ │ │ │ +00008e70: 6920 2a20 4841 4e44 4c45 2c0a 2020 2020  i * HANDLE,.    
│ │ │ │ +00008e80: 2020 2020 2020 5368 6973 6869 5f61 736e        Shishi_asn
│ │ │ │ +00008e90: 3120 4b44 4352 4551 2c20 5368 6973 6869  1 KDCREQ, Shishi
│ │ │ │ +00008ea0: 5f61 736e 3120 4b44 4352 4550 2c20 5368  _asn1 KDCREP, Sh
│ │ │ │ +00008eb0: 6973 6869 5f6b 6579 202a 204b 4559 2c0a  ishi_key * KEY,.
│ │ │ │ +00008ec0: 2020 2020 2020 2020 2020 696e 7420 4b45            int KE
│ │ │ │ +00008ed0: 5955 5341 4745 2c20 5368 6973 6869 5f61  YUSAGE, Shishi_a
│ │ │ │ +00008ee0: 736e 3120 2a20 454e 434b 4443 5245 5050  sn1 * ENCKDCREPP
│ │ │ │ +00008ef0: 4152 5429 0a20 2020 2020 4841 4e44 4c45  ART).     HANDLE
│ │ │ │ +00008f00: 3a20 5368 6973 6869 2068 616e 646c 6520  : Shishi handle 
│ │ │ │ +00008f10: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ +00008f20: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ +00008f30: e280 992e 0a20 2020 2020 4b44 4352 4551  .....     KDCREQ
│ │ │ │ +00008f40: 3a20 496e 7075 7420 7661 7269 6162 6c65  : Input variable
│ │ │ │ +00008f50: 2068 6f6c 6469 6e67 2074 6865 2074 7261   holding the tra
│ │ │ │ +00008f60: 6e73 6d69 7474 6564 204b 4443 2d52 4551  nsmitted KDC-REQ
│ │ │ │ +00008f70: 2e0a 2020 2020 204b 4443 5245 503a 2049  ..     KDCREP: I
│ │ │ │ +00008f80: 6e70 7574 2076 6172 6961 626c 6520 686f  nput variable ho
│ │ │ │ +00008f90: 6c64 696e 6720 7468 6520 7265 6365 6976  lding the receiv
│ │ │ │ +00008fa0: 6564 204b 4443 2d52 4550 2e0a 2020 2020  ed KDC-REP..    
│ │ │ │ +00008fb0: 204b 4559 3a20 496e 7075 7420 706f 696e   KEY: Input poin
│ │ │ │ +00008fc0: 7465 7420 746f 206b 6579 2066 6f72 2064  tet to key for d
│ │ │ │ +00008fd0: 6563 7279 7074 696e 6720 7061 7274 7320  ecrypting parts 
│ │ │ │ +00008fe0: 6f66 204b 4443 5245 502e 0a20 2020 2020  of KDCREP..     
│ │ │ │ +00008ff0: 4b45 5955 5341 4745 3a20 4b65 7262 6572  KEYUSAGE: Kerber
│ │ │ │ +00009000: 6f73 206b 6579 2075 7361 6765 2063 6f64  os key usage cod
│ │ │ │ +00009010: 652e 0a20 2020 2020 454e 434b 4443 5245  e..     ENCKDCRE
│ │ │ │ +00009020: 5050 4152 543a 204f 7574 7075 7420 706f  PPART: Output po
│ │ │ │ +00009030: 696e 7465 7220 666f 7220 7468 6520 6578  inter for the ex
│ │ │ │ +00009040: 7472 6163 7465 6420 456e 634b 4443 5265  tracted EncKDCRe
│ │ │ │ +00009050: 7050 6172 742e 0a0a 2020 2020 202a 4465  pPart...     *De
│ │ │ │ +00009060: 7363 7269 7074 696f 6e3a 2a20 5072 6f63  scription:* Proc
│ │ │ │ +00009070: 6573 7365 7320 6120 4b44 4320 636c 6965  esses a KDC clie
│ │ │ │ +00009080: 6e74 2065 7863 6861 6e67 6520 616e 6420  nt exchange and 
│ │ │ │ +00009090: 6578 7472 6163 7473 2061 0a20 2020 2020  extracts a.     
│ │ │ │ +000090a0: 6465 6372 7970 7465 6420 456e 634b 4443  decrypted EncKDC
│ │ │ │ +000090b0: 5265 7050 6172 742c 2068 6f6c 6469 6e67  RepPart, holding
│ │ │ │ +000090c0: 2064 6574 6169 6c73 2061 626f 7574 2074   details about t
│ │ │ │ +000090d0: 6865 2072 6563 6569 7665 6420 7469 636b  he received tick
│ │ │ │ +000090e0: 6574 2e0a 2020 2020 2055 7365 20e2 8098  et..     Use ...
│ │ │ │ +000090f0: 7368 6973 6869 5f6b 6463 7265 705f 6765  shishi_kdcrep_ge
│ │ │ │ +00009100: 745f 7469 636b 6574 2829 e280 9920 746f  t_ticket()... to
│ │ │ │ +00009110: 2065 7874 7261 6374 2074 6865 2074 6963   extract the tic
│ │ │ │ +00009120: 6b65 7420 6974 7365 6c66 2e0a 2020 2020  ket itself..    
│ │ │ │ +00009130: 2054 6869 7320 6675 6e63 7469 6f6e 2076   This function v
│ │ │ │ +00009140: 6572 6966 6965 7320 7468 6520 7661 7269  erifies the vari
│ │ │ │ +00009150: 6f75 7320 636f 6e64 6974 696f 6e73 2074  ous conditions t
│ │ │ │ +00009160: 6861 7420 6d75 7374 2068 6f6c 6420 6966  hat must hold if
│ │ │ │ +00009170: 2074 6865 0a20 2020 2020 7265 7370 6f6e   the.     respon
│ │ │ │ +00009180: 7365 2069 7320 746f 2062 6520 636f 6e73  se is to be cons
│ │ │ │ +00009190: 6964 6572 6564 2076 616c 6964 2e20 2049  idered valid.  I
│ │ │ │ +000091a0: 6e20 7061 7274 6963 756c 6172 2c20 6974  n particular, it
│ │ │ │ +000091b0: 2063 6f6d 7061 7265 730a 2020 2020 206e   compares.     n
│ │ │ │ +000091c0: 6f6e 6365 7320 2875 7369 6e67 20e2 8098  onces (using ...
│ │ │ │ +000091d0: 7368 6973 6869 5f6b 6463 5f63 6865 636b  shishi_kdc_check
│ │ │ │ +000091e0: 5f6e 6f6e 6365 2829 e280 9929 2c20 616e  _nonce()...), an
│ │ │ │ +000091f0: 6420 6966 2074 6865 2065 7863 6861 6e67  d if the exchang
│ │ │ │ +00009200: 6520 7761 730a 2020 2020 2061 6e20 4153  e was.     an AS
│ │ │ │ +00009210: 2065 7863 6861 6e67 652c 2069 7420 616c   exchange, it al
│ │ │ │ +00009220: 736f 2063 6865 636b 7320 636e 616d 6520  so checks cname 
│ │ │ │ +00009230: 616e 6420 6372 6561 6c6d 2028 7573 696e  and crealm (usin
│ │ │ │ +00009240: 670a 2020 2020 20e2 8098 7368 6973 6869  g.     ...shishi
│ │ │ │ +00009250: 5f61 735f 6368 6563 6b5f 636e 616d 6528  _as_check_cname(
│ │ │ │ +00009260: 29e2 8099 2c20 e280 9873 6869 7368 695f  )..., ...shishi_
│ │ │ │ +00009270: 6173 5f63 6865 636b 5f63 7265 616c 6d28  as_check_crealm(
│ │ │ │ +00009280: 29e2 8099 292e 0a0a 2020 2020 2055 7375  )...)...     Usu
│ │ │ │ +00009290: 616c 6c79 20e2 8098 7368 6973 6869 5f61  ally ...shishi_a
│ │ │ │ +000092a0: 735f 7072 6f63 6573 7328 29e2 8099 2061  s_process()... a
│ │ │ │ +000092b0: 6e64 20e2 8098 7368 6973 6869 5f74 6773  nd ...shishi_tgs
│ │ │ │ +000092c0: 5f70 726f 6365 7373 2829 e280 9920 7368  _process()... sh
│ │ │ │ +000092d0: 6f75 6c64 2062 650a 2020 2020 2075 7365  ould be.     use
│ │ │ │ +000092e0: 6420 696e 7374 6561 6420 6f66 2074 6869  d instead of thi
│ │ │ │ +000092f0: 7320 6361 6c6c 2c20 7369 6e63 6520 7468  s call, since th
│ │ │ │ +00009300: 6579 2073 696d 706c 6966 7920 636f 6d70  ey simplify comp
│ │ │ │ +00009310: 7574 6174 696f 6e20 6f66 2074 6865 0a20  utation of the. 
│ │ │ │ +00009320: 2020 2020 6465 6372 7970 7469 6f6e 206b      decryption k
│ │ │ │ +00009330: 6579 2e0a 0a20 2020 2020 2a52 6574 7572  ey...     *Retur
│ │ │ │ +00009340: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ +00009350: 7320 e280 9853 4849 5348 495f 4f4b e280  s ...SHISHI_OK..
│ │ │ │ +00009360: 9920 6966 2074 6865 204b 4443 2063 6c69  . if the KDC cli
│ │ │ │ +00009370: 656e 7420 6578 6368 616e 6765 2077 6173  ent exchange was
│ │ │ │ +00009380: 0a20 2020 2020 7375 6363 6573 7366 756c  .     successful
│ │ │ │ +00009390: 2e20 204d 756c 7469 706c 6520 6661 696c  .  Multiple fail
│ │ │ │ +000093a0: 7572 6520 636f 6e64 6974 696f 6e73 2061  ure conditions a
│ │ │ │ +000093b0: 7265 2070 6f73 7369 626c 652e 0a0a 7368  re possible...sh
│ │ │ │ +000093c0: 6973 6869 5f61 7372 6571 0a2d 2d2d 2d2d  ishi_asreq.-----
│ │ │ │ +000093d0: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +000093e0: 6374 696f 6e3a 2053 6869 7368 695f 6173  ction: Shishi_as
│ │ │ │ +000093f0: 6e31 2073 6869 7368 695f 6173 7265 7120  n1 shishi_asreq 
│ │ │ │ +00009400: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ +00009410: 290a 2020 2020 2048 414e 444c 453a 2073  ).     HANDLE: s
│ │ │ │ +00009420: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ +00009430: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ +00009440: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ +00009450: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ +00009460: 7469 6f6e 3a2a 2054 6869 7320 6675 6e63  tion:* This func
│ │ │ │ +00009470: 7469 6f6e 2063 7265 6174 6573 2061 206e  tion creates a n
│ │ │ │ +00009480: 6577 2041 532d 5245 512c 2070 6f70 756c  ew AS-REQ, popul
│ │ │ │ +00009490: 6174 6564 2077 6974 680a 2020 2020 2073  ated with.     s
│ │ │ │ +000094a0: 6f6d 6520 6465 6661 756c 7420 7661 6c75  ome default valu
│ │ │ │ +000094b0: 6573 2e0a 0a20 2020 2020 2a52 6574 7572  es...     *Retur
│ │ │ │ +000094c0: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ +000094d0: 7320 7468 6520 4153 2d52 4551 206f 7220  s the AS-REQ or 
│ │ │ │ +000094e0: 4e55 4c4c 206f 6e20 6661 696c 7572 652e  NULL on failure.
│ │ │ │ +000094f0: 0a0a 7368 6973 6869 5f74 6773 7265 710a  ..shishi_tgsreq.
│ │ │ │ +00009500: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ +00009510: 2d2d 2046 756e 6374 696f 6e3a 2053 6869  -- Function: Shi
│ │ │ │ +00009520: 7368 695f 6173 6e31 2073 6869 7368 695f  shi_asn1 shishi_
│ │ │ │ +00009530: 7467 7372 6571 2028 5368 6973 6869 202a  tgsreq (Shishi *
│ │ │ │ +00009540: 2048 414e 444c 4529 0a20 2020 2020 4841   HANDLE).     HA
│ │ │ │ +00009550: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ +00009560: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ +00009570: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ +00009580: 6974 2829 e280 992e 0a0a 2020 2020 202a  it()......     *
│ │ │ │ +00009590: 4465 7363 7269 7074 696f 6e3a 2a20 5468  Description:* Th
│ │ │ │ +000095a0: 6973 2066 756e 6374 696f 6e20 6372 6561  is function crea
│ │ │ │ +000095b0: 7465 7320 6120 6e65 7720 5447 532d 5245  tes a new TGS-RE
│ │ │ │ +000095c0: 512c 2070 6f70 756c 6174 6564 2077 6974  Q, populated wit
│ │ │ │ +000095d0: 680a 2020 2020 2073 6f6d 6520 6465 6661  h.     some defa
│ │ │ │ +000095e0: 756c 7420 7661 6c75 6573 2e0a 0a20 2020  ult values...   
│ │ │ │ +000095f0: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ +00009600: 2a20 5265 7475 726e 7320 7468 6520 5447  * Returns the TG
│ │ │ │ +00009610: 532d 5245 5120 6f72 204e 554c 4c20 6f6e  S-REQ or NULL on
│ │ │ │ +00009620: 2066 6169 6c75 7265 2e0a 0a73 6869 7368   failure...shish
│ │ │ │ +00009630: 695f 6b64 6372 6571 5f70 7269 6e74 0a2d  i_kdcreq_print.-
│ │ │ │  00009640: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00009650: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ -00009660: 2069 6e74 2073 6869 7368 695f 6b64 6372   int shishi_kdcr
│ │ │ │ -00009670: 6571 5f70 7269 6e74 2028 5368 6973 6869  eq_print (Shishi
│ │ │ │ -00009680: 202a 2048 414e 444c 452c 2046 494c 4520   * HANDLE, FILE 
│ │ │ │ -00009690: 2a20 4648 2c0a 2020 2020 2020 2020 2020  * FH,.          
│ │ │ │ -000096a0: 5368 6973 6869 5f61 736e 3120 4b44 4352  Shishi_asn1 KDCR
│ │ │ │ -000096b0: 4551 290a 2020 2020 2048 414e 444c 453a  EQ).     HANDLE:
│ │ │ │ -000096c0: 2073 6869 7368 6920 6861 6e64 6c65 2061   shishi handle a
│ │ │ │ -000096d0: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ -000096e0: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ -000096f0: 8099 2e0a 2020 2020 2046 483a 2066 696c  ....     FH: fil
│ │ │ │ -00009700: 6520 6861 6e64 6c65 206f 7065 6e20 666f  e handle open fo
│ │ │ │ -00009710: 7220 7772 6974 696e 672e 0a20 2020 2020  r writing..     
│ │ │ │ -00009720: 4b44 4352 4551 3a20 4b44 432d 5245 5120  KDCREQ: KDC-REQ 
│ │ │ │ -00009730: 746f 2070 7269 6e74 2e0a 0a20 2020 2020  to print...     
│ │ │ │ -00009740: 2a44 6573 6372 6970 7469 6f6e 3a2a 2050  *Description:* P
│ │ │ │ -00009750: 7269 6e74 2041 5343 4949 2061 726d 6f72  rint ASCII armor
│ │ │ │ -00009760: 6564 2044 4552 2065 6e63 6f64 696e 6720  ed DER encoding 
│ │ │ │ -00009770: 6f66 204b 4443 2d52 4551 2074 6f20 6669  of KDC-REQ to fi
│ │ │ │ -00009780: 6c65 2e0a 0a20 2020 2020 2a52 6574 7572  le...     *Retur
│ │ │ │ -00009790: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ -000097a0: 7320 5348 4953 4849 5f4f 4b20 6966 6620  s SHISHI_OK iff 
│ │ │ │ -000097b0: 7375 6363 6573 7366 756c 2e0a 0a73 6869  successful...shi
│ │ │ │ -000097c0: 7368 695f 6b64 6372 6571 5f73 6176 650a  shi_kdcreq_save.
│ │ │ │ -000097d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000097e0: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ -000097f0: 3a20 696e 7420 7368 6973 6869 5f6b 6463  : int shishi_kdc
│ │ │ │ -00009800: 7265 715f 7361 7665 2028 5368 6973 6869  req_save (Shishi
│ │ │ │ -00009810: 202a 2048 414e 444c 452c 2046 494c 4520   * HANDLE, FILE 
│ │ │ │ -00009820: 2a20 4648 2c0a 2020 2020 2020 2020 2020  * FH,.          
│ │ │ │ -00009830: 5368 6973 6869 5f61 736e 3120 4b44 4352  Shishi_asn1 KDCR
│ │ │ │ -00009840: 4551 290a 2020 2020 2048 414e 444c 453a  EQ).     HANDLE:
│ │ │ │ -00009850: 2073 6869 7368 6920 6861 6e64 6c65 2061   shishi handle a
│ │ │ │ -00009860: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ -00009870: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ -00009880: 8099 2e0a 2020 2020 2046 483a 2066 696c  ....     FH: fil
│ │ │ │ -00009890: 6520 6861 6e64 6c65 206f 7065 6e20 666f  e handle open fo
│ │ │ │ -000098a0: 7220 7772 6974 696e 672e 0a20 2020 2020  r writing..     
│ │ │ │ -000098b0: 4b44 4352 4551 3a20 4b44 432d 5245 5120  KDCREQ: KDC-REQ 
│ │ │ │ -000098c0: 746f 2073 6176 652e 0a0a 2020 2020 202a  to save...     *
│ │ │ │ -000098d0: 4465 7363 7269 7074 696f 6e3a 2a20 5072  Description:* Pr
│ │ │ │ -000098e0: 696e 7420 4445 5220 656e 636f 6469 6e67  int DER encoding
│ │ │ │ -000098f0: 206f 6620 4b44 432d 5245 5120 746f 2066   of KDC-REQ to f
│ │ │ │ -00009900: 696c 652e 0a0a 2020 2020 202a 5265 7475  ile...     *Retu
│ │ │ │ -00009910: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ -00009920: 6e73 2053 4849 5348 495f 4f4b 2069 6666  ns SHISHI_OK iff
│ │ │ │ -00009930: 2073 7563 6365 7373 6675 6c2e 0a0a 7368   successful...sh
│ │ │ │ -00009940: 6973 6869 5f6b 6463 7265 715f 746f 5f66  ishi_kdcreq_to_f
│ │ │ │ -00009950: 696c 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ile.------------
│ │ │ │ -00009960: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ -00009970: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ -00009980: 7368 695f 6b64 6372 6571 5f74 6f5f 6669  shi_kdcreq_to_fi
│ │ │ │ -00009990: 6c65 2028 5368 6973 6869 202a 2048 414e  le (Shishi * HAN
│ │ │ │ -000099a0: 444c 452c 0a20 2020 2020 2020 2020 2053  DLE,.          S
│ │ │ │ -000099b0: 6869 7368 695f 6173 6e31 204b 4443 5245  hishi_asn1 KDCRE
│ │ │ │ -000099c0: 512c 2069 6e74 2046 494c 4554 5950 452c  Q, int FILETYPE,
│ │ │ │ -000099d0: 2063 6f6e 7374 2063 6861 7220 2a20 4649   const char * FI
│ │ │ │ -000099e0: 4c45 4e41 4d45 290a 2020 2020 2048 414e  LENAME).     HAN
│ │ │ │ -000099f0: 444c 453a 2073 6869 7368 6920 6861 6e64  DLE: shishi hand
│ │ │ │ -00009a00: 6c65 2061 7320 616c 6c6f 6361 7465 6420  le as allocated 
│ │ │ │ -00009a10: 6279 20e2 8098 7368 6973 6869 5f69 6e69  by ...shishi_ini
│ │ │ │ -00009a20: 7428 29e2 8099 2e0a 2020 2020 204b 4443  t().....     KDC
│ │ │ │ -00009a30: 5245 513a 204b 4443 2d52 4551 2074 6f20  REQ: KDC-REQ to 
│ │ │ │ -00009a40: 7361 7665 2e0a 2020 2020 2046 494c 4554  save..     FILET
│ │ │ │ -00009a50: 5950 453a 2069 6e70 7574 2076 6172 6961  YPE: input varia
│ │ │ │ -00009a60: 626c 6520 7370 6563 6966 7969 6e67 2074  ble specifying t
│ │ │ │ -00009a70: 7970 6520 6f66 2066 696c 6520 746f 2062  ype of file to b
│ │ │ │ -00009a80: 6520 7772 6974 7465 6e2c 2073 6565 0a20  e written, see. 
│ │ │ │ -00009a90: 2020 2020 5368 6973 6869 5f66 696c 6574      Shishi_filet
│ │ │ │ -00009aa0: 7970 652e 0a20 2020 2020 4649 4c45 4e41  ype..     FILENA
│ │ │ │ -00009ab0: 4d45 3a20 696e 7075 7420 7661 7269 6162  ME: input variab
│ │ │ │ -00009ac0: 6c65 2077 6974 6820 6669 6c65 6e61 6d65  le with filename
│ │ │ │ -00009ad0: 2074 6f20 7772 6974 6520 746f 2e0a 0a20   to write to... 
│ │ │ │ -00009ae0: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -00009af0: 3a2a 2057 7269 7465 204b 4443 2d52 4551  :* Write KDC-REQ
│ │ │ │ -00009b00: 2074 6f20 6669 6c65 2069 6e20 7370 6563   to file in spec
│ │ │ │ -00009b10: 6966 6965 6420 5459 5045 2e20 5468 6520  ified TYPE. The 
│ │ │ │ -00009b20: 6669 6c65 0a20 2020 2020 7769 6c6c 2062  file.     will b
│ │ │ │ -00009b30: 6520 7472 756e 6361 7465 6420 6966 2069  e truncated if i
│ │ │ │ -00009b40: 7420 6578 6973 7473 2e0a 0a20 2020 2020  t exists...     
│ │ │ │ -00009b50: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ -00009b60: 5265 7475 726e 7320 5348 4953 4849 5f4f  Returns SHISHI_O
│ │ │ │ -00009b70: 4b20 6966 6620 7375 6363 6573 7366 756c  K iff successful
│ │ │ │ -00009b80: 2e0a 0a73 6869 7368 695f 6b64 6372 6571  ...shishi_kdcreq
│ │ │ │ -00009b90: 5f70 6172 7365 0a2d 2d2d 2d2d 2d2d 2d2d  _parse.---------
│ │ │ │ -00009ba0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ -00009bb0: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ -00009bc0: 6973 6869 5f6b 6463 7265 715f 7061 7273  ishi_kdcreq_pars
│ │ │ │ -00009bd0: 6520 2853 6869 7368 6920 2a20 4841 4e44  e (Shishi * HAND
│ │ │ │ -00009be0: 4c45 2c20 4649 4c45 202a 2046 482c 0a20  LE, FILE * FH,. 
│ │ │ │ -00009bf0: 2020 2020 2020 2020 2053 6869 7368 695f           Shishi_
│ │ │ │ -00009c00: 6173 6e31 202a 204b 4443 5245 5129 0a20  asn1 * KDCREQ). 
│ │ │ │ -00009c10: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ -00009c20: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ -00009c30: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ -00009c40: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ -00009c50: 2020 2020 4648 3a20 6669 6c65 2068 616e      FH: file han
│ │ │ │ -00009c60: 646c 6520 6f70 656e 2066 6f72 2072 6561  dle open for rea
│ │ │ │ -00009c70: 6469 6e67 2e0a 2020 2020 204b 4443 5245  ding..     KDCRE
│ │ │ │ -00009c80: 513a 206f 7574 7075 7420 7661 7269 6162  Q: output variab
│ │ │ │ -00009c90: 6c65 2077 6974 6820 6e65 776c 7920 616c  le with newly al
│ │ │ │ -00009ca0: 6c6f 6361 7465 6420 4b44 432d 5245 512e  located KDC-REQ.
│ │ │ │ -00009cb0: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ -00009cc0: 696f 6e3a 2a20 5265 6164 2041 5343 4949  ion:* Read ASCII
│ │ │ │ -00009cd0: 2061 726d 6f72 6564 2044 4552 2065 6e63   armored DER enc
│ │ │ │ -00009ce0: 6f64 6564 204b 4443 2d52 4551 2066 726f  oded KDC-REQ fro
│ │ │ │ -00009cf0: 6d20 6669 6c65 2061 6e64 0a20 2020 2020  m file and.     
│ │ │ │ -00009d00: 706f 7075 6c61 7465 2067 6976 656e 2076  populate given v
│ │ │ │ -00009d10: 6172 6961 626c 652e 0a0a 2020 2020 202a  ariable...     *
│ │ │ │ -00009d20: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ -00009d30: 6574 7572 6e73 2053 4849 5348 495f 4f4b  eturns SHISHI_OK
│ │ │ │ -00009d40: 2069 6666 2073 7563 6365 7373 6675 6c2e   iff successful.
│ │ │ │ -00009d50: 0a0a 7368 6973 6869 5f6b 6463 7265 715f  ..shishi_kdcreq_
│ │ │ │ -00009d60: 7265 6164 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  read.-----------
│ │ │ │ -00009d70: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ -00009d80: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ -00009d90: 695f 6b64 6372 6571 5f72 6561 6420 2853  i_kdcreq_read (S
│ │ │ │ -00009da0: 6869 7368 6920 2a20 4841 4e44 4c45 2c20  hishi * HANDLE, 
│ │ │ │ -00009db0: 4649 4c45 202a 2046 482c 0a20 2020 2020  FILE * FH,.     
│ │ │ │ -00009dc0: 2020 2020 2053 6869 7368 695f 6173 6e31       Shishi_asn1
│ │ │ │ -00009dd0: 202a 204b 4443 5245 5129 0a20 2020 2020   * KDCREQ).     
│ │ │ │ -00009de0: 4841 4e44 4c45 3a20 7368 6973 6869 2068  HANDLE: shishi h
│ │ │ │ -00009df0: 616e 646c 6520 6173 2061 6c6c 6f63 6174  andle as allocat
│ │ │ │ -00009e00: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ -00009e10: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ -00009e20: 4648 3a20 6669 6c65 2068 616e 646c 6520  FH: file handle 
│ │ │ │ -00009e30: 6f70 656e 2066 6f72 2072 6561 6469 6e67  open for reading
│ │ │ │ -00009e40: 2e0a 2020 2020 204b 4443 5245 513a 206f  ..     KDCREQ: o
│ │ │ │ -00009e50: 7574 7075 7420 7661 7269 6162 6c65 2077  utput variable w
│ │ │ │ -00009e60: 6974 6820 6e65 776c 7920 616c 6c6f 6361  ith newly alloca
│ │ │ │ -00009e70: 7465 6420 4b44 432d 5245 512e 0a0a 2020  ted KDC-REQ...  
│ │ │ │ -00009e80: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ -00009e90: 2a20 5265 6164 2044 4552 2065 6e63 6f64  * Read DER encod
│ │ │ │ -00009ea0: 6564 204b 4443 2d52 4551 2066 726f 6d20  ed KDC-REQ from 
│ │ │ │ -00009eb0: 6669 6c65 2061 6e64 2070 6f70 756c 6174  file and populat
│ │ │ │ -00009ec0: 650a 2020 2020 2067 6976 656e 2076 6172  e.     given var
│ │ │ │ -00009ed0: 6961 626c 652e 0a0a 2020 2020 202a 5265  iable...     *Re
│ │ │ │ -00009ee0: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ -00009ef0: 7572 6e73 2053 4849 5348 495f 4f4b 2069  urns SHISHI_OK i
│ │ │ │ -00009f00: 6666 2073 7563 6365 7373 6675 6c2e 0a0a  ff successful...
│ │ │ │ -00009f10: 7368 6973 6869 5f6b 6463 7265 715f 6672  shishi_kdcreq_fr
│ │ │ │ -00009f20: 6f6d 5f66 696c 650a 2d2d 2d2d 2d2d 2d2d  om_file.--------
│ │ │ │ -00009f30: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -00009f40: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ -00009f50: 6e74 2073 6869 7368 695f 6b64 6372 6571  nt shishi_kdcreq
│ │ │ │ -00009f60: 5f66 726f 6d5f 6669 6c65 2028 5368 6973  _from_file (Shis
│ │ │ │ -00009f70: 6869 202a 2048 414e 444c 452c 0a20 2020  hi * HANDLE,.   
│ │ │ │ -00009f80: 2020 2020 2020 2053 6869 7368 695f 6173         Shishi_as
│ │ │ │ -00009f90: 6e31 202a 204b 4443 5245 512c 2069 6e74  n1 * KDCREQ, int
│ │ │ │ -00009fa0: 2046 494c 4554 5950 452c 2063 6f6e 7374   FILETYPE, const
│ │ │ │ -00009fb0: 2063 6861 7220 2a20 4649 4c45 4e41 4d45   char * FILENAME
│ │ │ │ -00009fc0: 290a 2020 2020 2048 414e 444c 453a 2073  ).     HANDLE: s
│ │ │ │ -00009fd0: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ -00009fe0: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ -00009ff0: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ -0000a000: 2e0a 2020 2020 204b 4443 5245 513a 206f  ..     KDCREQ: o
│ │ │ │ -0000a010: 7574 7075 7420 7661 7269 6162 6c65 2077  utput variable w
│ │ │ │ -0000a020: 6974 6820 6e65 776c 7920 616c 6c6f 6361  ith newly alloca
│ │ │ │ -0000a030: 7465 6420 4b44 432d 5245 512e 0a20 2020  ted KDC-REQ..   
│ │ │ │ -0000a040: 2020 4649 4c45 5459 5045 3a20 696e 7075    FILETYPE: inpu
│ │ │ │ -0000a050: 7420 7661 7269 6162 6c65 2073 7065 6369  t variable speci
│ │ │ │ -0000a060: 6679 696e 6720 7479 7065 206f 6620 6669  fying type of fi
│ │ │ │ -0000a070: 6c65 2074 6f20 6265 2072 6561 642c 2073  le to be read, s
│ │ │ │ -0000a080: 6565 0a20 2020 2020 5368 6973 6869 5f66  ee.     Shishi_f
│ │ │ │ -0000a090: 696c 6574 7970 652e 0a20 2020 2020 4649  iletype..     FI
│ │ │ │ -0000a0a0: 4c45 4e41 4d45 3a20 696e 7075 7420 7661  LENAME: input va
│ │ │ │ -0000a0b0: 7269 6162 6c65 2077 6974 6820 6669 6c65  riable with file
│ │ │ │ -0000a0c0: 6e61 6d65 2074 6f20 7265 6164 2066 726f  name to read fro
│ │ │ │ -0000a0d0: 6d2e 0a0a 2020 2020 202a 4465 7363 7269  m...     *Descri
│ │ │ │ -0000a0e0: 7074 696f 6e3a 2a20 5265 6164 204b 4443  ption:* Read KDC
│ │ │ │ -0000a0f0: 2d52 4551 2066 726f 6d20 6669 6c65 2069  -REQ from file i
│ │ │ │ -0000a100: 6e20 7370 6563 6966 6965 6420 5459 5045  n specified TYPE
│ │ │ │ -0000a110: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ -0000a120: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ -0000a130: 5348 4953 4849 5f4f 4b20 6966 6620 7375  SHISHI_OK iff su
│ │ │ │ -0000a140: 6363 6573 7366 756c 2e0a 0a73 6869 7368  ccessful...shish
│ │ │ │ -0000a150: 695f 6b64 6372 6571 5f6e 6f6e 6365 5f73  i_kdcreq_nonce_s
│ │ │ │ -0000a160: 6574 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  et.-------------
│ │ │ │ -0000a170: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ -0000a180: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ -0000a190: 6973 6869 5f6b 6463 7265 715f 6e6f 6e63  ishi_kdcreq_nonc
│ │ │ │ -0000a1a0: 655f 7365 7420 2853 6869 7368 6920 2a20  e_set (Shishi * 
│ │ │ │ -0000a1b0: 4841 4e44 4c45 2c0a 2020 2020 2020 2020  HANDLE,.        
│ │ │ │ -0000a1c0: 2020 5368 6973 6869 5f61 736e 3120 4b44    Shishi_asn1 KD
│ │ │ │ -0000a1d0: 4352 4551 2c20 7569 6e74 3332 5f74 204e  CREQ, uint32_t N
│ │ │ │ -0000a1e0: 4f4e 4345 290a 2020 2020 2048 414e 444c  ONCE).     HANDL
│ │ │ │ -0000a1f0: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ -0000a200: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ -0000a210: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ -0000a220: 29e2 8099 2e0a 2020 2020 204b 4443 5245  ).....     KDCRE
│ │ │ │ -0000a230: 513a 204b 4443 2d52 4551 2076 6172 6961  Q: KDC-REQ varia
│ │ │ │ -0000a240: 626c 6520 746f 2073 6574 2063 6c69 656e  ble to set clien
│ │ │ │ -0000a250: 7420 6e61 6d65 2066 6965 6c64 2069 6e2e  t name field in.
│ │ │ │ -0000a260: 0a20 2020 2020 4e4f 4e43 453a 2069 6e74  .     NONCE: int
│ │ │ │ -0000a270: 6567 6572 206e 6f6e 6365 2074 6f20 7374  eger nonce to st
│ │ │ │ -0000a280: 6f72 6520 696e 204b 4443 2d52 4551 2e0a  ore in KDC-REQ..
│ │ │ │ -0000a290: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -0000a2a0: 6f6e 3a2a 2053 746f 7265 206e 6f6e 6365  on:* Store nonce
│ │ │ │ -0000a2b0: 206e 756d 6265 7220 6669 656c 6420 696e   number field in
│ │ │ │ -0000a2c0: 204b 4443 2d52 4551 2e0a 0a20 2020 2020   KDC-REQ...     
│ │ │ │ -0000a2d0: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ -0000a2e0: 5265 7475 726e 7320 e280 9853 4849 5348  Returns ...SHISH
│ │ │ │ -0000a2f0: 495f 4f4b e280 9920 6966 6620 7375 6363  I_OK... iff succ
│ │ │ │ -0000a300: 6573 7366 756c 2e0a 0a73 6869 7368 695f  essful...shishi_
│ │ │ │ -0000a310: 6b64 6372 6571 5f73 6574 5f63 6e61 6d65  kdcreq_set_cname
│ │ │ │ -0000a320: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ -0000a330: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -0000a340: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ -0000a350: 6869 5f6b 6463 7265 715f 7365 745f 636e  hi_kdcreq_set_cn
│ │ │ │ -0000a360: 616d 6520 2853 6869 7368 6920 2a20 4841  ame (Shishi * HA
│ │ │ │ -0000a370: 4e44 4c45 2c0a 2020 2020 2020 2020 2020  NDLE,.          
│ │ │ │ -0000a380: 5368 6973 6869 5f61 736e 3120 4b44 4352  Shishi_asn1 KDCR
│ │ │ │ -0000a390: 4551 2c20 5368 6973 6869 5f6e 616d 655f  EQ, Shishi_name_
│ │ │ │ -0000a3a0: 7479 7065 204e 414d 455f 5459 5045 2c0a  type NAME_TYPE,.
│ │ │ │ -0000a3b0: 2020 2020 2020 2020 2020 636f 6e73 7420            const 
│ │ │ │ -0000a3c0: 6368 6172 202a 2050 5249 4e43 4950 414c  char * PRINCIPAL
│ │ │ │ -0000a3d0: 290a 2020 2020 2048 414e 444c 453a 2073  ).     HANDLE: s
│ │ │ │ -0000a3e0: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ -0000a3f0: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ -0000a400: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ -0000a410: 2e0a 2020 2020 204b 4443 5245 513a 204b  ..     KDCREQ: K
│ │ │ │ -0000a420: 4443 2d52 4551 2076 6172 6961 626c 6520  DC-REQ variable 
│ │ │ │ -0000a430: 746f 2073 6574 2063 6c69 656e 7420 6e61  to set client na
│ │ │ │ -0000a440: 6d65 2066 6965 6c64 2069 6e2e 0a20 2020  me field in..   
│ │ │ │ -0000a450: 2020 4e41 4d45 5f54 5950 453a 2074 7970    NAME_TYPE: typ
│ │ │ │ -0000a460: 6520 6f66 2070 7269 6e63 6970 6961 6c2c  e of principial,
│ │ │ │ -0000a470: 2073 6565 2053 6869 7368 695f 6e61 6d65   see Shishi_name
│ │ │ │ -0000a480: 5f74 7970 652c 2075 7375 616c 6c79 0a20  _type, usually. 
│ │ │ │ -0000a490: 2020 2020 5348 4953 4849 5f4e 545f 554e      SHISHI_NT_UN
│ │ │ │ -0000a4a0: 4b4e 4f57 4e2e 0a20 2020 2020 5052 494e  KNOWN..     PRIN
│ │ │ │ -0000a4b0: 4349 5041 4c3a 2069 6e70 7574 2061 7272  CIPAL: input arr
│ │ │ │ -0000a4c0: 6179 2077 6974 6820 7072 696e 6369 7061  ay with principa
│ │ │ │ -0000a4d0: 6c20 6e61 6d65 2e0a 0a20 2020 2020 2a44  l name...     *D
│ │ │ │ -0000a4e0: 6573 6372 6970 7469 6f6e 3a2a 2053 6574  escription:* Set
│ │ │ │ -0000a4f0: 2074 6865 2063 6c69 656e 7420 6e61 6d65   the client name
│ │ │ │ -0000a500: 2066 6965 6c64 2069 6e20 7468 6520 4b44   field in the KD
│ │ │ │ -0000a510: 432d 5245 512e 0a0a 2020 2020 202a 5265  C-REQ...     *Re
│ │ │ │ -0000a520: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ -0000a530: 7572 6e73 2053 4849 5348 495f 4f4b 2069  urns SHISHI_OK i
│ │ │ │ -0000a540: 6666 2073 7563 6365 7373 6675 6c2e 0a0a  ff successful...
│ │ │ │ -0000a550: 7368 6973 6869 5f6b 6463 7265 715f 636c  shishi_kdcreq_cl
│ │ │ │ -0000a560: 6965 6e74 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  ient.-----------
│ │ │ │ -0000a570: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ -0000a580: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ -0000a590: 7368 695f 6b64 6372 6571 5f63 6c69 656e  shi_kdcreq_clien
│ │ │ │ -0000a5a0: 7420 2853 6869 7368 6920 2a20 4841 4e44  t (Shishi * HAND
│ │ │ │ -0000a5b0: 4c45 2c0a 2020 2020 2020 2020 2020 5368  LE,.          Sh
│ │ │ │ -0000a5c0: 6973 6869 5f61 736e 3120 4b44 4352 4551  ishi_asn1 KDCREQ
│ │ │ │ -0000a5d0: 2c20 6368 6172 202a 2a20 434c 4945 4e54  , char ** CLIENT
│ │ │ │ -0000a5e0: 2c20 7369 7a65 5f74 202a 2043 4c49 454e  , size_t * CLIEN
│ │ │ │ -0000a5f0: 544c 454e 290a 2020 2020 2048 414e 444c  TLEN).     HANDL
│ │ │ │ -0000a600: 453a 2053 6869 7368 6920 6c69 6272 6172  E: Shishi librar
│ │ │ │ -0000a610: 7920 6861 6e64 6c65 2063 7265 6174 6520  y handle create 
│ │ │ │ -0000a620: 6279 20e2 8098 7368 6973 6869 5f69 6e69  by ...shishi_ini
│ │ │ │ -0000a630: 7428 29e2 8099 2e0a 2020 2020 204b 4443  t().....     KDC
│ │ │ │ -0000a640: 5245 513a 204b 4443 2d52 4551 2076 6172  REQ: KDC-REQ var
│ │ │ │ -0000a650: 6961 626c 6520 746f 2067 6574 2063 6c69  iable to get cli
│ │ │ │ -0000a660: 656e 7420 6e61 6d65 2066 726f 6d2e 0a20  ent name from.. 
│ │ │ │ -0000a670: 2020 2020 434c 4945 4e54 3a20 706f 696e      CLIENT: poin
│ │ │ │ -0000a680: 7465 7220 746f 206e 6577 6c79 2061 6c6c  ter to newly all
│ │ │ │ -0000a690: 6f63 6174 6564 207a 6572 6f20 7465 726d  ocated zero term
│ │ │ │ -0000a6a0: 696e 6174 6564 2073 7472 696e 670a 2020  inated string.  
│ │ │ │ -0000a6b0: 2020 2063 6f6e 7461 696e 696e 6720 7072     containing pr
│ │ │ │ -0000a6c0: 696e 6369 7061 6c20 6e61 6d65 2e20 204d  incipal name.  M
│ │ │ │ -0000a6d0: 6179 2062 6520 e280 984e 554c 4ce2 8099  ay be ...NULL...
│ │ │ │ -0000a6e0: 2028 746f 206f 6e6c 7920 706f 7075 6c61   (to only popula
│ │ │ │ -0000a6f0: 7465 0a20 2020 2020 434c 4945 4e54 4c45  te.     CLIENTLE
│ │ │ │ -0000a700: 4e29 2e0a 2020 2020 2043 4c49 454e 544c  N)..     CLIENTL
│ │ │ │ -0000a710: 454e 3a20 706f 696e 7465 7220 746f 206c  EN: pointer to l
│ │ │ │ -0000a720: 656e 6774 6820 6f66 2043 4c49 454e 5420  ength of CLIENT 
│ │ │ │ -0000a730: 6f6e 206f 7574 7075 742c 2065 7863 6c75  on output, exclu
│ │ │ │ -0000a740: 6469 6e67 0a20 2020 2020 7465 726d 696e  ding.     termin
│ │ │ │ -0000a750: 6174 696e 6720 7a65 726f 2e20 204d 6179  ating zero.  May
│ │ │ │ -0000a760: 2062 6520 e280 984e 554c 4ce2 8099 2028   be ...NULL... (
│ │ │ │ -0000a770: 746f 206f 6e6c 7920 706f 7075 6c61 7465  to only populate
│ │ │ │ -0000a780: 2043 4c49 454e 5429 2e0a 0a20 2020 2020   CLIENT)...     
│ │ │ │ -0000a790: 2a44 6573 6372 6970 7469 6f6e 3a2a 2052  *Description:* R
│ │ │ │ -0000a7a0: 6570 7265 7365 6e74 2063 6c69 656e 7420  epresent client 
│ │ │ │ -0000a7b0: 7072 696e 6369 7061 6c20 6e61 6d65 2069  principal name i
│ │ │ │ -0000a7c0: 6e20 4b44 432d 5245 5120 6173 0a20 2020  n KDC-REQ as.   
│ │ │ │ -0000a7d0: 2020 7a65 726f 2d74 6572 6d69 6e61 7465    zero-terminate
│ │ │ │ -0000a7e0: 6420 7374 7269 6e67 2e20 2054 6865 2073  d string.  The s
│ │ │ │ -0000a7f0: 7472 696e 6720 6973 2061 6c6c 6f63 6174  tring is allocat
│ │ │ │ -0000a800: 6520 6279 2074 6869 7320 6675 6e63 7469  e by this functi
│ │ │ │ -0000a810: 6f6e 2c0a 2020 2020 2061 6e64 2069 7420  on,.     and it 
│ │ │ │ -0000a820: 6973 2074 6865 2072 6573 706f 6e73 6962  is the responsib
│ │ │ │ -0000a830: 696c 6974 7920 6f66 2074 6865 2063 616c  ility of the cal
│ │ │ │ -0000a840: 6c65 7220 746f 2064 6561 6c6c 6f63 6174  ler to deallocat
│ │ │ │ -0000a850: 6520 6974 2e20 204e 6f74 650a 2020 2020  e it.  Note.    
│ │ │ │ -0000a860: 2074 6861 7420 7468 6520 6f75 7470 7574   that the output
│ │ │ │ -0000a870: 206c 656e 6774 6820 434c 4945 4e54 4c45   length CLIENTLE
│ │ │ │ -0000a880: 4e20 646f 6573 206e 6f74 2069 6e63 6c75  N does not inclu
│ │ │ │ -0000a890: 6465 2074 6865 2074 6572 6d69 6e61 7469  de the terminati
│ │ │ │ -0000a8a0: 6e67 0a20 2020 2020 7a65 726f 2e0a 0a20  ng.     zero... 
│ │ │ │ -0000a8b0: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ -0000a8c0: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ -0000a8d0: 4849 5f4f 4b20 6966 6620 7375 6363 6573  HI_OK iff succes
│ │ │ │ -0000a8e0: 7366 756c 2e0a 0a73 6869 7368 695f 6173  sful...shishi_as
│ │ │ │ -0000a8f0: 7265 715f 636c 6965 6e74 7265 616c 6d0a  req_clientrealm.
│ │ │ │ -0000a900: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0000a910: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -0000a920: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ -0000a930: 6869 5f61 7372 6571 5f63 6c69 656e 7472  hi_asreq_clientr
│ │ │ │ -0000a940: 6561 6c6d 2028 5368 6973 6869 202a 2048  ealm (Shishi * H
│ │ │ │ -0000a950: 414e 444c 452c 0a20 2020 2020 2020 2020  ANDLE,.         
│ │ │ │ -0000a960: 2053 6869 7368 695f 6173 6e31 2041 5352   Shishi_asn1 ASR
│ │ │ │ -0000a970: 4551 2c20 6368 6172 202a 2a20 434c 4945  EQ, char ** CLIE
│ │ │ │ -0000a980: 4e54 2c20 7369 7a65 5f74 202a 2043 4c49  NT, size_t * CLI
│ │ │ │ -0000a990: 454e 544c 454e 290a 2020 2020 2048 414e  ENTLEN).     HAN
│ │ │ │ -0000a9a0: 444c 453a 2053 6869 7368 6920 6c69 6272  DLE: Shishi libr
│ │ │ │ -0000a9b0: 6172 7920 6861 6e64 6c65 2063 7265 6174  ary handle creat
│ │ │ │ -0000a9c0: 6520 6279 20e2 8098 7368 6973 6869 5f69  e by ...shishi_i
│ │ │ │ -0000a9d0: 6e69 7428 29e2 8099 2e0a 2020 2020 2041  nit().....     A
│ │ │ │ -0000a9e0: 5352 4551 3a20 4153 2d52 4551 2076 6172  SREQ: AS-REQ var
│ │ │ │ -0000a9f0: 6961 626c 6520 746f 2067 6574 2063 6c69  iable to get cli
│ │ │ │ -0000aa00: 656e 7420 6e61 6d65 2061 6e64 2072 6561  ent name and rea
│ │ │ │ -0000aa10: 6c6d 2066 726f 6d2e 0a20 2020 2020 434c  lm from..     CL
│ │ │ │ -0000aa20: 4945 4e54 3a20 706f 696e 7465 7220 746f  IENT: pointer to
│ │ │ │ -0000aa30: 206e 6577 6c79 2061 6c6c 6f63 6174 6564   newly allocated
│ │ │ │ -0000aa40: 207a 6572 6f20 7465 726d 696e 6174 6564   zero terminated
│ │ │ │ -0000aa50: 2073 7472 696e 670a 2020 2020 2063 6f6e   string.     con
│ │ │ │ -0000aa60: 7461 696e 696e 6720 7072 696e 6369 7061  taining principa
│ │ │ │ -0000aa70: 6c20 6e61 6d65 2061 6e64 2072 6561 6c6d  l name and realm
│ │ │ │ -0000aa80: 2e20 204d 6179 2062 6520 e280 984e 554c  .  May be ...NUL
│ │ │ │ -0000aa90: 4ce2 8099 2028 746f 206f 6e6c 790a 2020  L... (to only.  
│ │ │ │ -0000aaa0: 2020 2070 6f70 756c 6174 6520 434c 4945     populate CLIE
│ │ │ │ -0000aab0: 4e54 4c45 4e29 2e0a 2020 2020 2043 4c49  NTLEN)..     CLI
│ │ │ │ -0000aac0: 454e 544c 454e 3a20 706f 696e 7465 7220  ENTLEN: pointer 
│ │ │ │ -0000aad0: 746f 206c 656e 6774 6820 6f66 2043 4c49  to length of CLI
│ │ │ │ -0000aae0: 454e 5420 6f6e 206f 7574 7075 742c 2065  ENT on output, e
│ │ │ │ -0000aaf0: 7863 6c75 6469 6e67 0a20 2020 2020 7465  xcluding.     te
│ │ │ │ -0000ab00: 726d 696e 6174 696e 6720 7a65 726f 2e20  rminating zero. 
│ │ │ │ -0000ab10: 204d 6179 2062 6520 e280 984e 554c 4ce2   May be ...NULL.
│ │ │ │ -0000ab20: 8099 2028 746f 206f 6e6c 7920 706f 7075  .. (to only popu
│ │ │ │ -0000ab30: 6c61 7465 2043 4c49 454e 5429 2e0a 0a20  late CLIENT)... 
│ │ │ │ -0000ab40: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -0000ab50: 3a2a 2043 6f6e 7665 7274 2063 6e61 6d65  :* Convert cname
│ │ │ │ -0000ab60: 2061 6e64 2072 6561 6c6d 2066 6965 6c64   and realm field
│ │ │ │ -0000ab70: 7320 6672 6f6d 2041 532d 5245 5120 746f  s from AS-REQ to
│ │ │ │ -0000ab80: 0a20 2020 2020 7072 696e 7461 626c 6520  .     printable 
│ │ │ │ -0000ab90: 7072 696e 6369 7061 6c20 6e61 6d65 2066  principal name f
│ │ │ │ -0000aba0: 6f72 6d61 742e 2020 5468 6520 7374 7269  ormat.  The stri
│ │ │ │ -0000abb0: 6e67 2069 7320 616c 6c6f 6361 7465 2062  ng is allocate b
│ │ │ │ -0000abc0: 7920 7468 6973 0a20 2020 2020 6675 6e63  y this.     func
│ │ │ │ -0000abd0: 7469 6f6e 2c20 616e 6420 6974 2069 7320  tion, and it is 
│ │ │ │ -0000abe0: 7468 6520 7265 7370 6f6e 7369 6269 6c69  the responsibili
│ │ │ │ -0000abf0: 7479 206f 6620 7468 6520 6361 6c6c 6572  ty of the caller
│ │ │ │ -0000ac00: 2074 6f20 6465 616c 6c6f 6361 7465 0a20   to deallocate. 
│ │ │ │ -0000ac10: 2020 2020 6974 2e20 204e 6f74 6520 7468      it.  Note th
│ │ │ │ -0000ac20: 6174 2074 6865 206f 7574 7075 7420 6c65  at the output le
│ │ │ │ -0000ac30: 6e67 7468 2043 4c49 454e 544c 454e 2064  ngth CLIENTLEN d
│ │ │ │ -0000ac40: 6f65 7320 6e6f 7420 696e 636c 7564 6520  oes not include 
│ │ │ │ -0000ac50: 7468 650a 2020 2020 2074 6572 6d69 6e61  the.     termina
│ │ │ │ -0000ac60: 7469 6e67 207a 6572 6f2e 0a0a 2020 2020  ting zero...    
│ │ │ │ -0000ac70: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ -0000ac80: 2052 6574 7572 6e73 2053 4849 5348 495f   Returns SHISHI_
│ │ │ │ -0000ac90: 4f4b 2069 6666 2073 7563 6365 7373 6675  OK iff successfu
│ │ │ │ -0000aca0: 6c2e 0a0a 7368 6973 6869 5f6b 6463 7265  l...shishi_kdcre
│ │ │ │ -0000acb0: 715f 7265 616c 6d0a 2d2d 2d2d 2d2d 2d2d  q_realm.--------
│ │ │ │ -0000acc0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ -0000acd0: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ -0000ace0: 6869 7368 695f 6b64 6372 6571 5f72 6561  hishi_kdcreq_rea
│ │ │ │ -0000acf0: 6c6d 2028 5368 6973 6869 202a 2048 414e  lm (Shishi * HAN
│ │ │ │ -0000ad00: 444c 452c 0a20 2020 2020 2020 2020 2053  DLE,.          S
│ │ │ │ -0000ad10: 6869 7368 695f 6173 6e31 204b 4443 5245  hishi_asn1 KDCRE
│ │ │ │ -0000ad20: 512c 2063 6861 7220 2a2a 2052 4541 4c4d  Q, char ** REALM
│ │ │ │ -0000ad30: 2c20 7369 7a65 5f74 202a 2052 4541 4c4d  , size_t * REALM
│ │ │ │ -0000ad40: 4c45 4e29 0a20 2020 2020 4841 4e44 4c45  LEN).     HANDLE
│ │ │ │ -0000ad50: 3a20 5368 6973 6869 206c 6962 7261 7279  : Shishi library
│ │ │ │ -0000ad60: 2068 616e 646c 6520 6372 6561 7465 2062   handle create b
│ │ │ │ -0000ad70: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ -0000ad80: 2829 e280 992e 0a20 2020 2020 4b44 4352  ().....     KDCR
│ │ │ │ -0000ad90: 4551 3a20 4b44 432d 5245 5120 7661 7269  EQ: KDC-REQ vari
│ │ │ │ -0000ada0: 6162 6c65 2074 6f20 6765 7420 636c 6965  able to get clie
│ │ │ │ -0000adb0: 6e74 206e 616d 6520 6672 6f6d 2e0a 2020  nt name from..  
│ │ │ │ -0000adc0: 2020 2052 4541 4c4d 3a20 706f 696e 7465     REALM: pointe
│ │ │ │ -0000add0: 7220 746f 206e 6577 6c79 2061 6c6c 6f63  r to newly alloc
│ │ │ │ -0000ade0: 6174 6564 207a 6572 6f20 7465 726d 696e  ated zero termin
│ │ │ │ -0000adf0: 6174 6564 2073 7472 696e 6720 636f 6e74  ated string cont
│ │ │ │ -0000ae00: 6169 6e69 6e67 0a20 2020 2020 7265 616c  aining.     real
│ │ │ │ -0000ae10: 6d2e 2020 4d61 7920 6265 20e2 8098 4e55  m.  May be ...NU
│ │ │ │ -0000ae20: 4c4c e280 9920 2874 6f20 6f6e 6c79 2070  LL... (to only p
│ │ │ │ -0000ae30: 6f70 756c 6174 6520 5245 414c 4d4c 454e  opulate REALMLEN
│ │ │ │ -0000ae40: 292e 0a20 2020 2020 5245 414c 4d4c 454e  )..     REALMLEN
│ │ │ │ -0000ae50: 3a20 706f 696e 7465 7220 746f 206c 656e  : pointer to len
│ │ │ │ -0000ae60: 6774 6820 6f66 2052 4541 4c4d 206f 6e20  gth of REALM on 
│ │ │ │ -0000ae70: 6f75 7470 7574 2c20 6578 636c 7564 696e  output, excludin
│ │ │ │ -0000ae80: 670a 2020 2020 2074 6572 6d69 6e61 7469  g.     terminati
│ │ │ │ -0000ae90: 6e67 207a 6572 6f2e 2020 4d61 7920 6265  ng zero.  May be
│ │ │ │ -0000aea0: 20e2 8098 4e55 4c4c e280 9920 2874 6f20   ...NULL... (to 
│ │ │ │ -0000aeb0: 6f6e 6c79 2070 6f70 756c 6174 6520 5245  only populate RE
│ │ │ │ -0000aec0: 414c 4d4c 454e 292e 0a0a 2020 2020 202a  ALMLEN)...     *
│ │ │ │ -0000aed0: 4465 7363 7269 7074 696f 6e3a 2a20 4765  Description:* Ge
│ │ │ │ -0000aee0: 7420 7265 616c 6d20 6669 656c 6420 696e  t realm field in
│ │ │ │ -0000aef0: 204b 4443 2d52 4551 2061 7320 7a65 726f   KDC-REQ as zero
│ │ │ │ -0000af00: 2d74 6572 6d69 6e61 7465 640a 2020 2020  -terminated.    
│ │ │ │ -0000af10: 2073 7472 696e 672e 2020 5468 6520 7374   string.  The st
│ │ │ │ -0000af20: 7269 6e67 2069 7320 616c 6c6f 6361 7465  ring is allocate
│ │ │ │ -0000af30: 2062 7920 7468 6973 2066 756e 6374 696f   by this functio
│ │ │ │ -0000af40: 6e2c 2061 6e64 2069 7420 6973 2074 6865  n, and it is the
│ │ │ │ -0000af50: 0a20 2020 2020 7265 7370 6f6e 7369 6269  .     responsibi
│ │ │ │ -0000af60: 6c69 7479 206f 6620 7468 6520 6361 6c6c  lity of the call
│ │ │ │ -0000af70: 6572 2074 6f20 6465 616c 6c6f 6361 7465  er to deallocate
│ │ │ │ -0000af80: 2069 742e 2020 4e6f 7465 2074 6861 7420   it.  Note that 
│ │ │ │ -0000af90: 7468 650a 2020 2020 206f 7574 7075 7420  the.     output 
│ │ │ │ -0000afa0: 6c65 6e67 7468 2052 4541 4c4d 4c45 4e20  length REALMLEN 
│ │ │ │ -0000afb0: 646f 6573 206e 6f74 2069 6e63 6c75 6465  does not include
│ │ │ │ -0000afc0: 2074 6865 2074 6572 6d69 6e61 7469 6e67   the terminating
│ │ │ │ -0000afd0: 207a 6572 6f2e 0a0a 2020 2020 202a 5265   zero...     *Re
│ │ │ │ -0000afe0: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ -0000aff0: 7572 6e73 2053 4849 5348 495f 4f4b 2069  urns SHISHI_OK i
│ │ │ │ -0000b000: 6666 2073 7563 6365 7373 6675 6c2e 0a0a  ff successful...
│ │ │ │ -0000b010: 7368 6973 6869 5f6b 6463 7265 715f 7365  shishi_kdcreq_se
│ │ │ │ -0000b020: 745f 7265 616c 6d0a 2d2d 2d2d 2d2d 2d2d  t_realm.--------
│ │ │ │ -0000b030: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -0000b040: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ -0000b050: 6e74 2073 6869 7368 695f 6b64 6372 6571  nt shishi_kdcreq
│ │ │ │ -0000b060: 5f73 6574 5f72 6561 6c6d 2028 5368 6973  _set_realm (Shis
│ │ │ │ -0000b070: 6869 202a 2048 414e 444c 452c 0a20 2020  hi * HANDLE,.   
│ │ │ │ -0000b080: 2020 2020 2020 2053 6869 7368 695f 6173         Shishi_as
│ │ │ │ -0000b090: 6e31 204b 4443 5245 512c 2063 6f6e 7374  n1 KDCREQ, const
│ │ │ │ -0000b0a0: 2063 6861 7220 2a20 5245 414c 4d29 0a20   char * REALM). 
│ │ │ │ -0000b0b0: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ -0000b0c0: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ -0000b0d0: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ -0000b0e0: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ -0000b0f0: 2020 2020 4b44 4352 4551 3a20 4b44 432d      KDCREQ: KDC-
│ │ │ │ -0000b100: 5245 5120 7661 7269 6162 6c65 2074 6f20  REQ variable to 
│ │ │ │ -0000b110: 7365 7420 7265 616c 6d20 6669 656c 6420  set realm field 
│ │ │ │ -0000b120: 696e 2e0a 2020 2020 2052 4541 4c4d 3a20  in..     REALM: 
│ │ │ │ -0000b130: 696e 7075 7420 6172 7261 7920 7769 7468  input array with
│ │ │ │ -0000b140: 206e 616d 6520 6f66 2072 6561 6c6d 2e0a   name of realm..
│ │ │ │ -0000b150: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -0000b160: 6f6e 3a2a 2053 6574 2074 6865 2072 6561  on:* Set the rea
│ │ │ │ -0000b170: 6c6d 2066 6965 6c64 2069 6e20 7468 6520  lm field in the 
│ │ │ │ -0000b180: 4b44 432d 5245 512e 0a0a 2020 2020 202a  KDC-REQ...     *
│ │ │ │ -0000b190: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ -0000b1a0: 6574 7572 6e73 2053 4849 5348 495f 4f4b  eturns SHISHI_OK
│ │ │ │ -0000b1b0: 2069 6666 2073 7563 6365 7373 6675 6c2e   iff successful.
│ │ │ │ -0000b1c0: 0a0a 7368 6973 6869 5f6b 6463 7265 715f  ..shishi_kdcreq_
│ │ │ │ -0000b1d0: 7365 7276 6572 0a2d 2d2d 2d2d 2d2d 2d2d  server.---------
│ │ │ │ -0000b1e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ -0000b1f0: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ -0000b200: 6869 7368 695f 6b64 6372 6571 5f73 6572  hishi_kdcreq_ser
│ │ │ │ -0000b210: 7665 7220 2853 6869 7368 6920 2a20 4841  ver (Shishi * HA
│ │ │ │ -0000b220: 4e44 4c45 2c0a 2020 2020 2020 2020 2020  NDLE,.          
│ │ │ │ -0000b230: 5368 6973 6869 5f61 736e 3120 4b44 4352  Shishi_asn1 KDCR
│ │ │ │ -0000b240: 4551 2c20 6368 6172 202a 2a20 5345 5256  EQ, char ** SERV
│ │ │ │ -0000b250: 4552 2c20 7369 7a65 5f74 202a 2053 4552  ER, size_t * SER
│ │ │ │ -0000b260: 5645 524c 454e 290a 2020 2020 2048 414e  VERLEN).     HAN
│ │ │ │ -0000b270: 444c 453a 2053 6869 7368 6920 6c69 6272  DLE: Shishi libr
│ │ │ │ -0000b280: 6172 7920 6861 6e64 6c65 2063 7265 6174  ary handle creat
│ │ │ │ -0000b290: 6520 6279 20e2 8098 7368 6973 6869 5f69  e by ...shishi_i
│ │ │ │ -0000b2a0: 6e69 7428 29e2 8099 2e0a 2020 2020 204b  nit().....     K
│ │ │ │ -0000b2b0: 4443 5245 513a 204b 4443 2d52 4551 2076  DCREQ: KDC-REQ v
│ │ │ │ -0000b2c0: 6172 6961 626c 6520 746f 2067 6574 2073  ariable to get s
│ │ │ │ -0000b2d0: 6572 7665 7220 6e61 6d65 2066 726f 6d2e  erver name from.
│ │ │ │ -0000b2e0: 0a20 2020 2020 5345 5256 4552 3a20 706f  .     SERVER: po
│ │ │ │ -0000b2f0: 696e 7465 7220 746f 206e 6577 6c79 2061  inter to newly a
│ │ │ │ -0000b300: 6c6c 6f63 6174 6564 207a 6572 6f20 7465  llocated zero te
│ │ │ │ -0000b310: 726d 696e 6174 6564 2073 7472 696e 670a  rminated string.
│ │ │ │ -0000b320: 2020 2020 2063 6f6e 7461 696e 696e 6720       containing 
│ │ │ │ -0000b330: 7072 696e 6369 7061 6c20 6e61 6d65 2e20  principal name. 
│ │ │ │ -0000b340: 204d 6179 2062 6520 e280 984e 554c 4ce2   May be ...NULL.
│ │ │ │ -0000b350: 8099 2028 746f 206f 6e6c 7920 706f 7075  .. (to only popu
│ │ │ │ -0000b360: 6c61 7465 0a20 2020 2020 5345 5256 4552  late.     SERVER
│ │ │ │ -0000b370: 4c45 4e29 2e0a 2020 2020 2053 4552 5645  LEN)..     SERVE
│ │ │ │ -0000b380: 524c 454e 3a20 706f 696e 7465 7220 746f  RLEN: pointer to
│ │ │ │ -0000b390: 206c 656e 6774 6820 6f66 2053 4552 5645   length of SERVE
│ │ │ │ -0000b3a0: 5220 6f6e 206f 7574 7075 742c 2065 7863  R on output, exc
│ │ │ │ -0000b3b0: 6c75 6469 6e67 0a20 2020 2020 7465 726d  luding.     term
│ │ │ │ -0000b3c0: 696e 6174 696e 6720 7a65 726f 2e20 204d  inating zero.  M
│ │ │ │ -0000b3d0: 6179 2062 6520 e280 984e 554c 4ce2 8099  ay be ...NULL...
│ │ │ │ -0000b3e0: 2028 746f 206f 6e6c 7920 706f 7075 6c61   (to only popula
│ │ │ │ -0000b3f0: 7465 2053 4552 5645 5229 2e0a 0a20 2020  te SERVER)...   
│ │ │ │ -0000b400: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ -0000b410: 2052 6570 7265 7365 6e74 2073 6572 7665   Represent serve
│ │ │ │ -0000b420: 7220 7072 696e 6369 7061 6c20 6e61 6d65  r principal name
│ │ │ │ -0000b430: 2069 6e20 4b44 432d 5245 5120 6173 0a20   in KDC-REQ as. 
│ │ │ │ -0000b440: 2020 2020 7a65 726f 2d74 6572 6d69 6e61      zero-termina
│ │ │ │ -0000b450: 7465 6420 7374 7269 6e67 2e20 2054 6865  ted string.  The
│ │ │ │ -0000b460: 2073 7472 696e 6720 6973 2061 6c6c 6f63   string is alloc
│ │ │ │ -0000b470: 6174 6520 6279 2074 6869 7320 6675 6e63  ate by this func
│ │ │ │ -0000b480: 7469 6f6e 2c0a 2020 2020 2061 6e64 2069  tion,.     and i
│ │ │ │ -0000b490: 7420 6973 2074 6865 2072 6573 706f 6e73  t is the respons
│ │ │ │ -0000b4a0: 6962 696c 6974 7920 6f66 2074 6865 2063  ibility of the c
│ │ │ │ -0000b4b0: 616c 6c65 7220 746f 2064 6561 6c6c 6f63  aller to dealloc
│ │ │ │ -0000b4c0: 6174 6520 6974 2e20 204e 6f74 650a 2020  ate it.  Note.  
│ │ │ │ -0000b4d0: 2020 2074 6861 7420 7468 6520 6f75 7470     that the outp
│ │ │ │ -0000b4e0: 7574 206c 656e 6774 6820 5345 5256 4552  ut length SERVER
│ │ │ │ -0000b4f0: 4c45 4e20 646f 6573 206e 6f74 2069 6e63  LEN does not inc
│ │ │ │ -0000b500: 6c75 6465 2074 6865 2074 6572 6d69 6e61  lude the termina
│ │ │ │ -0000b510: 7469 6e67 0a20 2020 2020 7a65 726f 2e0a  ting.     zero..
│ │ │ │ -0000b520: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ -0000b530: 6c75 653a 2a20 5265 7475 726e 7320 5348  lue:* Returns SH
│ │ │ │ -0000b540: 4953 4849 5f4f 4b20 6966 6620 7375 6363  ISHI_OK iff succ
│ │ │ │ -0000b550: 6573 7366 756c 2e0a 0a73 6869 7368 695f  essful...shishi_
│ │ │ │ -0000b560: 6b64 6372 6571 5f73 6574 5f73 6e61 6d65  kdcreq_set_sname
│ │ │ │ -0000b570: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ -0000b580: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -0000b590: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ -0000b5a0: 6869 5f6b 6463 7265 715f 7365 745f 736e  hi_kdcreq_set_sn
│ │ │ │ -0000b5b0: 616d 6520 2853 6869 7368 6920 2a20 4841  ame (Shishi * HA
│ │ │ │ -0000b5c0: 4e44 4c45 2c0a 2020 2020 2020 2020 2020  NDLE,.          
│ │ │ │ -0000b5d0: 5368 6973 6869 5f61 736e 3120 4b44 4352  Shishi_asn1 KDCR
│ │ │ │ -0000b5e0: 4551 2c20 5368 6973 6869 5f6e 616d 655f  EQ, Shishi_name_
│ │ │ │ -0000b5f0: 7479 7065 204e 414d 455f 5459 5045 2c0a  type NAME_TYPE,.
│ │ │ │ -0000b600: 2020 2020 2020 2020 2020 636f 6e73 7420            const 
│ │ │ │ -0000b610: 6368 6172 202a 2053 4e41 4d45 5b5d 290a  char * SNAME[]).
│ │ │ │ -0000b620: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ -0000b630: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ -0000b640: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ -0000b650: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ -0000b660: 2020 2020 204b 4443 5245 513a 204b 4443       KDCREQ: KDC
│ │ │ │ -0000b670: 2d52 4551 2076 6172 6961 626c 6520 746f  -REQ variable to
│ │ │ │ -0000b680: 2073 6574 2073 6572 7665 7220 6e61 6d65   set server name
│ │ │ │ -0000b690: 2066 6965 6c64 2069 6e2e 0a20 2020 2020   field in..     
│ │ │ │ -0000b6a0: 4e41 4d45 5f54 5950 453a 2074 7970 6520  NAME_TYPE: type 
│ │ │ │ -0000b6b0: 6f66 2070 7269 6e63 6970 6961 6c2c 2073  of principial, s
│ │ │ │ -0000b6c0: 6565 2053 6869 7368 695f 6e61 6d65 5f74  ee Shishi_name_t
│ │ │ │ -0000b6d0: 7970 652c 2075 7375 616c 6c79 0a20 2020  ype, usually.   
│ │ │ │ -0000b6e0: 2020 5348 4953 4849 5f4e 545f 554e 4b4e    SHISHI_NT_UNKN
│ │ │ │ -0000b6f0: 4f57 4e2e 0a20 2020 2020 534e 414d 453a  OWN..     SNAME:
│ │ │ │ -0000b700: 2069 6e70 7574 2061 7272 6179 2077 6974   input array wit
│ │ │ │ -0000b710: 6820 7072 696e 6369 7061 6c20 6e61 6d65  h principal name
│ │ │ │ -0000b720: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ -0000b730: 7469 6f6e 3a2a 2053 6574 2074 6865 2073  tion:* Set the s
│ │ │ │ -0000b740: 6572 7665 7220 6e61 6d65 2066 6965 6c64  erver name field
│ │ │ │ -0000b750: 2069 6e20 7468 6520 4b44 432d 5245 512e   in the KDC-REQ.
│ │ │ │ -0000b760: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ -0000b770: 616c 7565 3a2a 2052 6574 7572 6e73 2053  alue:* Returns S
│ │ │ │ -0000b780: 4849 5348 495f 4f4b 2069 6666 2073 7563  HISHI_OK iff suc
│ │ │ │ -0000b790: 6365 7373 6675 6c2e 0a0a 7368 6973 6869  cessful...shishi
│ │ │ │ -0000b7a0: 5f6b 6463 7265 715f 7469 6c6c 0a2d 2d2d  _kdcreq_till.---
│ │ │ │ -0000b7b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -0000b7c0: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ -0000b7d0: 6e74 2073 6869 7368 695f 6b64 6372 6571  nt shishi_kdcreq
│ │ │ │ -0000b7e0: 5f74 696c 6c20 2853 6869 7368 6920 2a20  _till (Shishi * 
│ │ │ │ -0000b7f0: 4841 4e44 4c45 2c0a 2020 2020 2020 2020  HANDLE,.        
│ │ │ │ -0000b800: 2020 5368 6973 6869 5f61 736e 3120 4b44    Shishi_asn1 KD
│ │ │ │ -0000b810: 4352 4551 2c20 6368 6172 202a 2a20 5449  CREQ, char ** TI
│ │ │ │ -0000b820: 4c4c 2c20 7369 7a65 5f74 202a 2054 494c  LL, size_t * TIL
│ │ │ │ -0000b830: 4c4c 454e 290a 2020 2020 2048 414e 444c  LLEN).     HANDL
│ │ │ │ -0000b840: 453a 2053 6869 7368 6920 6c69 6272 6172  E: Shishi librar
│ │ │ │ -0000b850: 7920 6861 6e64 6c65 2063 7265 6174 6564  y handle created
│ │ │ │ -0000b860: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ -0000b870: 6974 2829 e280 992e 0a20 2020 2020 4b44  it().....     KD
│ │ │ │ -0000b880: 4352 4551 3a20 4b44 432d 5245 5120 7661  CREQ: KDC-REQ va
│ │ │ │ -0000b890: 7269 6162 6c65 2074 6f20 6765 7420 656e  riable to get en
│ │ │ │ -0000b8a0: 6474 696d 6520 6672 6f6d 2e0a 2020 2020  dtime from..    
│ │ │ │ -0000b8b0: 2054 494c 4c3a 2070 6f69 6e74 6572 2074   TILL: pointer t
│ │ │ │ -0000b8c0: 6f20 6e65 776c 7920 616c 6c6f 6361 7465  o newly allocate
│ │ │ │ -0000b8d0: 6420 6e75 6c6c 2074 6572 6d69 6e61 7465  d null terminate
│ │ │ │ -0000b8e0: 6420 7374 7269 6e67 2063 6f6e 7461 696e  d string contain
│ │ │ │ -0000b8f0: 696e 670a 2020 2020 2022 7469 6c6c 2220  ing.     "till" 
│ │ │ │ -0000b900: 6669 656c 6420 7769 7468 2067 656e 6572  field with gener
│ │ │ │ -0000b910: 616c 697a 6564 2074 696d 652e 2020 4d61  alized time.  Ma
│ │ │ │ -0000b920: 7920 6265 2070 6173 7365 6420 6173 20e2  y be passed as .
│ │ │ │ -0000b930: 8098 4e55 4c4c e280 9920 746f 0a20 2020  ..NULL... to.   
│ │ │ │ -0000b940: 2020 6f6e 6c79 2070 6f70 756c 6174 6520    only populate 
│ │ │ │ -0000b950: 5449 4c4c 4c45 4e2e 0a20 2020 2020 5449  TILLLEN..     TI
│ │ │ │ -0000b960: 4c4c 4c45 4e3a 2070 6f69 6e74 6572 2074  LLLEN: pointer t
│ │ │ │ -0000b970: 6f20 6c65 6e67 7468 206f 6620 5449 4c4c  o length of TILL
│ │ │ │ -0000b980: 2066 6f72 206f 7574 7075 742c 2065 7863   for output, exc
│ │ │ │ -0000b990: 6c75 6469 6e67 2074 6865 0a20 2020 2020  luding the.     
│ │ │ │ -0000b9a0: 7465 726d 696e 6174 696e 6720 6e75 6c6c  terminating null
│ │ │ │ -0000b9b0: 2e20 2053 6574 2074 6f20 e280 984e 554c  .  Set to ...NUL
│ │ │ │ -0000b9c0: 4ce2 8099 2c20 6f6e 6c79 2054 494c 4c20  L..., only TILL 
│ │ │ │ -0000b9d0: 6973 2070 6f70 756c 6174 6564 2e0a 0a20  is populated... 
│ │ │ │ -0000b9e0: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -0000b9f0: 3a2a 2047 6574 2022 7469 6c6c 2220 6669  :* Get "till" fi
│ │ │ │ -0000ba00: 656c 642c 2069 2e65 2e2c 2022 656e 6474  eld, i.e., "endt
│ │ │ │ -0000ba10: 696d 6522 2c20 696e 204b 4443 2d52 4551  ime", in KDC-REQ
│ │ │ │ -0000ba20: 2061 7320 610a 2020 2020 206e 756c 6c2d   as a.     null-
│ │ │ │ -0000ba30: 7465 726d 696e 6174 6564 2073 7472 696e  terminated strin
│ │ │ │ -0000ba40: 672e 2020 5468 6520 7374 7269 6e67 2069  g.  The string i
│ │ │ │ -0000ba50: 7320 7479 7069 6361 6c6c 7920 3135 2063  s typically 15 c
│ │ │ │ -0000ba60: 6861 7261 6374 6572 7320 6c6f 6e67 0a20  haracters long. 
│ │ │ │ -0000ba70: 2020 2020 616e 6420 6973 2061 6c6c 6f63      and is alloc
│ │ │ │ -0000ba80: 6174 6564 2062 7920 7468 6973 2066 756e  ated by this fun
│ │ │ │ -0000ba90: 6374 696f 6e2e 2020 4974 2069 7320 7468  ction.  It is th
│ │ │ │ -0000baa0: 6520 7265 7370 6f6e 7369 6269 6c69 7479  e responsibility
│ │ │ │ -0000bab0: 206f 6620 7468 650a 2020 2020 2063 616c   of the.     cal
│ │ │ │ -0000bac0: 6c65 7220 746f 2064 6561 6c6c 6f63 6174  ler to deallocat
│ │ │ │ -0000bad0: 6520 6974 2e20 204e 6f74 6520 7468 6174  e it.  Note that
│ │ │ │ -0000bae0: 2074 6865 206f 7574 7075 7420 6c65 6e67   the output leng
│ │ │ │ -0000baf0: 7468 2054 494c 4c4c 454e 2064 6f65 730a  th TILLLEN does.
│ │ │ │ -0000bb00: 2020 2020 206e 6f74 2069 6e63 6c75 6465       not include
│ │ │ │ -0000bb10: 2074 6865 2074 6572 6d69 6e61 7469 6e67   the terminating
│ │ │ │ -0000bb20: 207a 6572 6f2e 0a0a 2020 2020 202a 5265   zero...     *Re
│ │ │ │ -0000bb30: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ -0000bb40: 7572 6e73 2053 4849 5348 495f 4f4b 2069  urns SHISHI_OK i
│ │ │ │ -0000bb50: 6666 2073 7563 6365 7373 6675 6c2e 0a0a  ff successful...
│ │ │ │ -0000bb60: 7368 6973 6869 5f6b 6463 7265 715f 7469  shishi_kdcreq_ti
│ │ │ │ -0000bb70: 6c6c 630a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  llc.------------
│ │ │ │ -0000bb80: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ -0000bb90: 6374 696f 6e3a 2074 696d 655f 7420 7368  ction: time_t sh
│ │ │ │ -0000bba0: 6973 6869 5f6b 6463 7265 715f 7469 6c6c  ishi_kdcreq_till
│ │ │ │ -0000bbb0: 6320 2853 6869 7368 6920 2a20 4841 4e44  c (Shishi * HAND
│ │ │ │ -0000bbc0: 4c45 2c0a 2020 2020 2020 2020 2020 5368  LE,.          Sh
│ │ │ │ -0000bbd0: 6973 6869 5f61 736e 3120 4b44 4352 4551  ishi_asn1 KDCREQ
│ │ │ │ -0000bbe0: 290a 2020 2020 2048 414e 444c 453a 2053  ).     HANDLE: S
│ │ │ │ -0000bbf0: 6869 7368 6920 6c69 6272 6172 7920 6861  hishi library ha
│ │ │ │ -0000bc00: 6e64 6c65 2063 7265 6174 6564 2062 7920  ndle created by 
│ │ │ │ -0000bc10: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ -0000bc20: e280 992e 0a20 2020 2020 4b44 4352 4551  .....     KDCREQ
│ │ │ │ -0000bc30: 3a20 4b44 432d 5245 5120 7661 7269 6162  : KDC-REQ variab
│ │ │ │ -0000bc40: 6c65 2074 6f20 6765 7420 2274 696c 6c22  le to get "till"
│ │ │ │ -0000bc50: 2066 6965 6c64 2066 726f 6d2e 0a0a 2020   field from...  
│ │ │ │ -0000bc60: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ -0000bc70: 2a20 4578 7472 6163 7420 4320 7469 6d65  * Extract C time
│ │ │ │ -0000bc80: 2063 6f72 7265 7370 6f6e 6469 6e67 2074   corresponding t
│ │ │ │ -0000bc90: 6f20 7468 6520 2274 696c 6c22 2066 6965  o the "till" fie
│ │ │ │ -0000bca0: 6c64 2e0a 0a20 2020 2020 2a52 6574 7572  ld...     *Retur
│ │ │ │ -0000bcb0: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ -0000bcc0: 7320 7468 6520 4320 7469 6d65 2069 6e74  s the C time int
│ │ │ │ -0000bcd0: 6572 7072 6574 6174 696f 6e20 6f66 2074  erpretation of t
│ │ │ │ -0000bce0: 6865 2022 7469 6c6c 220a 2020 2020 2066  he "till".     f
│ │ │ │ -0000bcf0: 6965 6c64 2069 6e20 4b44 432d 5245 512e  ield in KDC-REQ.
│ │ │ │ -0000bd00: 0a0a 7368 6973 6869 5f6b 6463 7265 715f  ..shishi_kdcreq_
│ │ │ │ -0000bd10: 6574 7970 650a 2d2d 2d2d 2d2d 2d2d 2d2d  etype.----------
│ │ │ │ -0000bd20: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ -0000bd30: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ -0000bd40: 7368 695f 6b64 6372 6571 5f65 7479 7065  shi_kdcreq_etype
│ │ │ │ -0000bd50: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ -0000bd60: 452c 0a20 2020 2020 2020 2020 2053 6869  E,.          Shi
│ │ │ │ -0000bd70: 7368 695f 6173 6e31 204b 4443 5245 512c  shi_asn1 KDCREQ,
│ │ │ │ -0000bd80: 2069 6e74 3332 5f74 202a 2045 5459 5045   int32_t * ETYPE
│ │ │ │ -0000bd90: 2c20 696e 7420 4e45 5459 5045 290a 2020  , int NETYPE).  
│ │ │ │ -0000bda0: 2020 2048 414e 444c 453a 2073 6869 7368     HANDLE: shish
│ │ │ │ -0000bdb0: 6920 6861 6e64 6c65 2061 7320 616c 6c6f  i handle as allo
│ │ │ │ -0000bdc0: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ -0000bdd0: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ -0000bde0: 2020 204b 4443 5245 513a 204b 4443 2d52     KDCREQ: KDC-R
│ │ │ │ -0000bdf0: 4551 2076 6172 6961 626c 6520 746f 2067  EQ variable to g
│ │ │ │ -0000be00: 6574 2065 7479 7065 2066 6965 6c64 2066  et etype field f
│ │ │ │ -0000be10: 726f 6d2e 0a20 2020 2020 4554 5950 453a  rom..     ETYPE:
│ │ │ │ -0000be20: 206f 7574 7075 7420 656e 6372 7970 7469   output encrypti
│ │ │ │ -0000be30: 6f6e 2074 7970 652e 0a20 2020 2020 4e45  on type..     NE
│ │ │ │ -0000be40: 5459 5045 3a20 656c 656d 656e 7420 6e75  TYPE: element nu
│ │ │ │ -0000be50: 6d62 6572 2074 6f20 7265 7475 726e 2e0a  mber to return..
│ │ │ │ -0000be60: 0a20 2020 2020 2a52 6574 7572 6e20 7468  .     *Return th
│ │ │ │ -0000be70: 6520 6e65 7479 7065 3a2a 2074 6820 656e  e netype:* th en
│ │ │ │ -0000be80: 6372 7970 7469 6f6e 2074 7970 6520 6672  cryption type fr
│ │ │ │ -0000be90: 6f6d 204b 4443 2d52 4551 2e20 5468 6520  om KDC-REQ. The 
│ │ │ │ -0000bea0: 6669 7273 740a 2020 2020 2065 7479 7065  first.     etype
│ │ │ │ -0000beb0: 2069 7320 6e75 6d62 6572 2031 2e0a 0a20   is number 1... 
│ │ │ │ -0000bec0: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ -0000bed0: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ -0000bee0: 4849 5f4f 4b20 6966 6620 6574 7970 6520  HI_OK iff etype 
│ │ │ │ -0000bef0: 7375 6363 6573 7366 756c 2073 6574 2e0a  successful set..
│ │ │ │ -0000bf00: 0a73 6869 7368 695f 6b64 6372 6571 5f73  .shishi_kdcreq_s
│ │ │ │ -0000bf10: 6574 5f65 7479 7065 0a2d 2d2d 2d2d 2d2d  et_etype.-------
│ │ │ │ +00009650: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ +00009660: 3a20 696e 7420 7368 6973 6869 5f6b 6463  : int shishi_kdc
│ │ │ │ +00009670: 7265 715f 7072 696e 7420 2853 6869 7368  req_print (Shish
│ │ │ │ +00009680: 6920 2a20 4841 4e44 4c45 2c20 4649 4c45  i * HANDLE, FILE
│ │ │ │ +00009690: 202a 2046 482c 0a20 2020 2020 2020 2020   * FH,.         
│ │ │ │ +000096a0: 2053 6869 7368 695f 6173 6e31 204b 4443   Shishi_asn1 KDC
│ │ │ │ +000096b0: 5245 5129 0a20 2020 2020 4841 4e44 4c45  REQ).     HANDLE
│ │ │ │ +000096c0: 3a20 7368 6973 6869 2068 616e 646c 6520  : shishi handle 
│ │ │ │ +000096d0: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ +000096e0: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ +000096f0: e280 992e 0a20 2020 2020 4648 3a20 6669  .....     FH: fi
│ │ │ │ +00009700: 6c65 2068 616e 646c 6520 6f70 656e 2066  le handle open f
│ │ │ │ +00009710: 6f72 2077 7269 7469 6e67 2e0a 2020 2020  or writing..    
│ │ │ │ +00009720: 204b 4443 5245 513a 204b 4443 2d52 4551   KDCREQ: KDC-REQ
│ │ │ │ +00009730: 2074 6f20 7072 696e 742e 0a0a 2020 2020   to print...    
│ │ │ │ +00009740: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ +00009750: 5072 696e 7420 4153 4349 4920 6172 6d6f  Print ASCII armo
│ │ │ │ +00009760: 7265 6420 4445 5220 656e 636f 6469 6e67  red DER encoding
│ │ │ │ +00009770: 206f 6620 4b44 432d 5245 5120 746f 2066   of KDC-REQ to f
│ │ │ │ +00009780: 696c 652e 0a0a 2020 2020 202a 5265 7475  ile...     *Retu
│ │ │ │ +00009790: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ +000097a0: 6e73 2053 4849 5348 495f 4f4b 2069 6666  ns SHISHI_OK iff
│ │ │ │ +000097b0: 2073 7563 6365 7373 6675 6c2e 0a0a 7368   successful...sh
│ │ │ │ +000097c0: 6973 6869 5f6b 6463 7265 715f 7361 7665  ishi_kdcreq_save
│ │ │ │ +000097d0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ +000097e0: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ +000097f0: 6e3a 2069 6e74 2073 6869 7368 695f 6b64  n: int shishi_kd
│ │ │ │ +00009800: 6372 6571 5f73 6176 6520 2853 6869 7368  creq_save (Shish
│ │ │ │ +00009810: 6920 2a20 4841 4e44 4c45 2c20 4649 4c45  i * HANDLE, FILE
│ │ │ │ +00009820: 202a 2046 482c 0a20 2020 2020 2020 2020   * FH,.         
│ │ │ │ +00009830: 2053 6869 7368 695f 6173 6e31 204b 4443   Shishi_asn1 KDC
│ │ │ │ +00009840: 5245 5129 0a20 2020 2020 4841 4e44 4c45  REQ).     HANDLE
│ │ │ │ +00009850: 3a20 7368 6973 6869 2068 616e 646c 6520  : shishi handle 
│ │ │ │ +00009860: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ +00009870: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ +00009880: e280 992e 0a20 2020 2020 4648 3a20 6669  .....     FH: fi
│ │ │ │ +00009890: 6c65 2068 616e 646c 6520 6f70 656e 2066  le handle open f
│ │ │ │ +000098a0: 6f72 2077 7269 7469 6e67 2e0a 2020 2020  or writing..    
│ │ │ │ +000098b0: 204b 4443 5245 513a 204b 4443 2d52 4551   KDCREQ: KDC-REQ
│ │ │ │ +000098c0: 2074 6f20 7361 7665 2e0a 0a20 2020 2020   to save...     
│ │ │ │ +000098d0: 2a44 6573 6372 6970 7469 6f6e 3a2a 2050  *Description:* P
│ │ │ │ +000098e0: 7269 6e74 2044 4552 2065 6e63 6f64 696e  rint DER encodin
│ │ │ │ +000098f0: 6720 6f66 204b 4443 2d52 4551 2074 6f20  g of KDC-REQ to 
│ │ │ │ +00009900: 6669 6c65 2e0a 0a20 2020 2020 2a52 6574  file...     *Ret
│ │ │ │ +00009910: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ +00009920: 726e 7320 5348 4953 4849 5f4f 4b20 6966  rns SHISHI_OK if
│ │ │ │ +00009930: 6620 7375 6363 6573 7366 756c 2e0a 0a73  f successful...s
│ │ │ │ +00009940: 6869 7368 695f 6b64 6372 6571 5f74 6f5f  hishi_kdcreq_to_
│ │ │ │ +00009950: 6669 6c65 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  file.-----------
│ │ │ │ +00009960: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +00009970: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ +00009980: 6973 6869 5f6b 6463 7265 715f 746f 5f66  ishi_kdcreq_to_f
│ │ │ │ +00009990: 696c 6520 2853 6869 7368 6920 2a20 4841  ile (Shishi * HA
│ │ │ │ +000099a0: 4e44 4c45 2c0a 2020 2020 2020 2020 2020  NDLE,.          
│ │ │ │ +000099b0: 5368 6973 6869 5f61 736e 3120 4b44 4352  Shishi_asn1 KDCR
│ │ │ │ +000099c0: 4551 2c20 696e 7420 4649 4c45 5459 5045  EQ, int FILETYPE
│ │ │ │ +000099d0: 2c20 636f 6e73 7420 6368 6172 202a 2046  , const char * F
│ │ │ │ +000099e0: 494c 454e 414d 4529 0a20 2020 2020 4841  ILENAME).     HA
│ │ │ │ +000099f0: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ +00009a00: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ +00009a10: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ +00009a20: 6974 2829 e280 992e 0a20 2020 2020 4b44  it().....     KD
│ │ │ │ +00009a30: 4352 4551 3a20 4b44 432d 5245 5120 746f  CREQ: KDC-REQ to
│ │ │ │ +00009a40: 2073 6176 652e 0a20 2020 2020 4649 4c45   save..     FILE
│ │ │ │ +00009a50: 5459 5045 3a20 696e 7075 7420 7661 7269  TYPE: input vari
│ │ │ │ +00009a60: 6162 6c65 2073 7065 6369 6679 696e 6720  able specifying 
│ │ │ │ +00009a70: 7479 7065 206f 6620 6669 6c65 2074 6f20  type of file to 
│ │ │ │ +00009a80: 6265 2077 7269 7474 656e 2c20 7365 650a  be written, see.
│ │ │ │ +00009a90: 2020 2020 2053 6869 7368 695f 6669 6c65       Shishi_file
│ │ │ │ +00009aa0: 7479 7065 2e0a 2020 2020 2046 494c 454e  type..     FILEN
│ │ │ │ +00009ab0: 414d 453a 2069 6e70 7574 2076 6172 6961  AME: input varia
│ │ │ │ +00009ac0: 626c 6520 7769 7468 2066 696c 656e 616d  ble with filenam
│ │ │ │ +00009ad0: 6520 746f 2077 7269 7465 2074 6f2e 0a0a  e to write to...
│ │ │ │ +00009ae0: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ +00009af0: 6e3a 2a20 5772 6974 6520 4b44 432d 5245  n:* Write KDC-RE
│ │ │ │ +00009b00: 5120 746f 2066 696c 6520 696e 2073 7065  Q to file in spe
│ │ │ │ +00009b10: 6369 6669 6564 2054 5950 452e 2054 6865  cified TYPE. The
│ │ │ │ +00009b20: 2066 696c 650a 2020 2020 2077 696c 6c20   file.     will 
│ │ │ │ +00009b30: 6265 2074 7275 6e63 6174 6564 2069 6620  be truncated if 
│ │ │ │ +00009b40: 6974 2065 7869 7374 732e 0a0a 2020 2020  it exists...    
│ │ │ │ +00009b50: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ +00009b60: 2052 6574 7572 6e73 2053 4849 5348 495f   Returns SHISHI_
│ │ │ │ +00009b70: 4f4b 2069 6666 2073 7563 6365 7373 6675  OK iff successfu
│ │ │ │ +00009b80: 6c2e 0a0a 7368 6973 6869 5f6b 6463 7265  l...shishi_kdcre
│ │ │ │ +00009b90: 715f 7061 7273 650a 2d2d 2d2d 2d2d 2d2d  q_parse.--------
│ │ │ │ +00009ba0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ +00009bb0: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ +00009bc0: 6869 7368 695f 6b64 6372 6571 5f70 6172  hishi_kdcreq_par
│ │ │ │ +00009bd0: 7365 2028 5368 6973 6869 202a 2048 414e  se (Shishi * HAN
│ │ │ │ +00009be0: 444c 452c 2046 494c 4520 2a20 4648 2c0a  DLE, FILE * FH,.
│ │ │ │ +00009bf0: 2020 2020 2020 2020 2020 5368 6973 6869            Shishi
│ │ │ │ +00009c00: 5f61 736e 3120 2a20 4b44 4352 4551 290a  _asn1 * KDCREQ).
│ │ │ │ +00009c10: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ +00009c20: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ +00009c30: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ +00009c40: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ +00009c50: 2020 2020 2046 483a 2066 696c 6520 6861       FH: file ha
│ │ │ │ +00009c60: 6e64 6c65 206f 7065 6e20 666f 7220 7265  ndle open for re
│ │ │ │ +00009c70: 6164 696e 672e 0a20 2020 2020 4b44 4352  ading..     KDCR
│ │ │ │ +00009c80: 4551 3a20 6f75 7470 7574 2076 6172 6961  EQ: output varia
│ │ │ │ +00009c90: 626c 6520 7769 7468 206e 6577 6c79 2061  ble with newly a
│ │ │ │ +00009ca0: 6c6c 6f63 6174 6564 204b 4443 2d52 4551  llocated KDC-REQ
│ │ │ │ +00009cb0: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ +00009cc0: 7469 6f6e 3a2a 2052 6561 6420 4153 4349  tion:* Read ASCI
│ │ │ │ +00009cd0: 4920 6172 6d6f 7265 6420 4445 5220 656e  I armored DER en
│ │ │ │ +00009ce0: 636f 6465 6420 4b44 432d 5245 5120 6672  coded KDC-REQ fr
│ │ │ │ +00009cf0: 6f6d 2066 696c 6520 616e 640a 2020 2020  om file and.    
│ │ │ │ +00009d00: 2070 6f70 756c 6174 6520 6769 7665 6e20   populate given 
│ │ │ │ +00009d10: 7661 7269 6162 6c65 2e0a 0a20 2020 2020  variable...     
│ │ │ │ +00009d20: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ +00009d30: 5265 7475 726e 7320 5348 4953 4849 5f4f  Returns SHISHI_O
│ │ │ │ +00009d40: 4b20 6966 6620 7375 6363 6573 7366 756c  K iff successful
│ │ │ │ +00009d50: 2e0a 0a73 6869 7368 695f 6b64 6372 6571  ...shishi_kdcreq
│ │ │ │ +00009d60: 5f72 6561 640a 2d2d 2d2d 2d2d 2d2d 2d2d  _read.----------
│ │ │ │ +00009d70: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ +00009d80: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ +00009d90: 6869 5f6b 6463 7265 715f 7265 6164 2028  hi_kdcreq_read (
│ │ │ │ +00009da0: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ +00009db0: 2046 494c 4520 2a20 4648 2c0a 2020 2020   FILE * FH,.    
│ │ │ │ +00009dc0: 2020 2020 2020 5368 6973 6869 5f61 736e        Shishi_asn
│ │ │ │ +00009dd0: 3120 2a20 4b44 4352 4551 290a 2020 2020  1 * KDCREQ).    
│ │ │ │ +00009de0: 2048 414e 444c 453a 2073 6869 7368 6920   HANDLE: shishi 
│ │ │ │ +00009df0: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ +00009e00: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ +00009e10: 5f69 6e69 7428 29e2 8099 2e0a 2020 2020  _init().....    
│ │ │ │ +00009e20: 2046 483a 2066 696c 6520 6861 6e64 6c65   FH: file handle
│ │ │ │ +00009e30: 206f 7065 6e20 666f 7220 7265 6164 696e   open for readin
│ │ │ │ +00009e40: 672e 0a20 2020 2020 4b44 4352 4551 3a20  g..     KDCREQ: 
│ │ │ │ +00009e50: 6f75 7470 7574 2076 6172 6961 626c 6520  output variable 
│ │ │ │ +00009e60: 7769 7468 206e 6577 6c79 2061 6c6c 6f63  with newly alloc
│ │ │ │ +00009e70: 6174 6564 204b 4443 2d52 4551 2e0a 0a20  ated KDC-REQ... 
│ │ │ │ +00009e80: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ +00009e90: 3a2a 2052 6561 6420 4445 5220 656e 636f  :* Read DER enco
│ │ │ │ +00009ea0: 6465 6420 4b44 432d 5245 5120 6672 6f6d  ded KDC-REQ from
│ │ │ │ +00009eb0: 2066 696c 6520 616e 6420 706f 7075 6c61   file and popula
│ │ │ │ +00009ec0: 7465 0a20 2020 2020 6769 7665 6e20 7661  te.     given va
│ │ │ │ +00009ed0: 7269 6162 6c65 2e0a 0a20 2020 2020 2a52  riable...     *R
│ │ │ │ +00009ee0: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +00009ef0: 7475 726e 7320 5348 4953 4849 5f4f 4b20  turns SHISHI_OK 
│ │ │ │ +00009f00: 6966 6620 7375 6363 6573 7366 756c 2e0a  iff successful..
│ │ │ │ +00009f10: 0a73 6869 7368 695f 6b64 6372 6571 5f66  .shishi_kdcreq_f
│ │ │ │ +00009f20: 726f 6d5f 6669 6c65 0a2d 2d2d 2d2d 2d2d  rom_file.-------
│ │ │ │ +00009f30: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +00009f40: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +00009f50: 696e 7420 7368 6973 6869 5f6b 6463 7265  int shishi_kdcre
│ │ │ │ +00009f60: 715f 6672 6f6d 5f66 696c 6520 2853 6869  q_from_file (Shi
│ │ │ │ +00009f70: 7368 6920 2a20 4841 4e44 4c45 2c0a 2020  shi * HANDLE,.  
│ │ │ │ +00009f80: 2020 2020 2020 2020 5368 6973 6869 5f61          Shishi_a
│ │ │ │ +00009f90: 736e 3120 2a20 4b44 4352 4551 2c20 696e  sn1 * KDCREQ, in
│ │ │ │ +00009fa0: 7420 4649 4c45 5459 5045 2c20 636f 6e73  t FILETYPE, cons
│ │ │ │ +00009fb0: 7420 6368 6172 202a 2046 494c 454e 414d  t char * FILENAM
│ │ │ │ +00009fc0: 4529 0a20 2020 2020 4841 4e44 4c45 3a20  E).     HANDLE: 
│ │ │ │ +00009fd0: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ +00009fe0: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ +00009ff0: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ +0000a000: 992e 0a20 2020 2020 4b44 4352 4551 3a20  ...     KDCREQ: 
│ │ │ │ +0000a010: 6f75 7470 7574 2076 6172 6961 626c 6520  output variable 
│ │ │ │ +0000a020: 7769 7468 206e 6577 6c79 2061 6c6c 6f63  with newly alloc
│ │ │ │ +0000a030: 6174 6564 204b 4443 2d52 4551 2e0a 2020  ated KDC-REQ..  
│ │ │ │ +0000a040: 2020 2046 494c 4554 5950 453a 2069 6e70     FILETYPE: inp
│ │ │ │ +0000a050: 7574 2076 6172 6961 626c 6520 7370 6563  ut variable spec
│ │ │ │ +0000a060: 6966 7969 6e67 2074 7970 6520 6f66 2066  ifying type of f
│ │ │ │ +0000a070: 696c 6520 746f 2062 6520 7265 6164 2c20  ile to be read, 
│ │ │ │ +0000a080: 7365 650a 2020 2020 2053 6869 7368 695f  see.     Shishi_
│ │ │ │ +0000a090: 6669 6c65 7479 7065 2e0a 2020 2020 2046  filetype..     F
│ │ │ │ +0000a0a0: 494c 454e 414d 453a 2069 6e70 7574 2076  ILENAME: input v
│ │ │ │ +0000a0b0: 6172 6961 626c 6520 7769 7468 2066 696c  ariable with fil
│ │ │ │ +0000a0c0: 656e 616d 6520 746f 2072 6561 6420 6672  ename to read fr
│ │ │ │ +0000a0d0: 6f6d 2e0a 0a20 2020 2020 2a44 6573 6372  om...     *Descr
│ │ │ │ +0000a0e0: 6970 7469 6f6e 3a2a 2052 6561 6420 4b44  iption:* Read KD
│ │ │ │ +0000a0f0: 432d 5245 5120 6672 6f6d 2066 696c 6520  C-REQ from file 
│ │ │ │ +0000a100: 696e 2073 7065 6369 6669 6564 2054 5950  in specified TYP
│ │ │ │ +0000a110: 452e 0a0a 2020 2020 202a 5265 7475 726e  E...     *Return
│ │ │ │ +0000a120: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ +0000a130: 2053 4849 5348 495f 4f4b 2069 6666 2073   SHISHI_OK iff s
│ │ │ │ +0000a140: 7563 6365 7373 6675 6c2e 0a0a 7368 6973  uccessful...shis
│ │ │ │ +0000a150: 6869 5f6b 6463 7265 715f 6e6f 6e63 655f  hi_kdcreq_nonce_
│ │ │ │ +0000a160: 7365 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  set.------------
│ │ │ │ +0000a170: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ +0000a180: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ +0000a190: 6869 7368 695f 6b64 6372 6571 5f6e 6f6e  hishi_kdcreq_non
│ │ │ │ +0000a1a0: 6365 5f73 6574 2028 5368 6973 6869 202a  ce_set (Shishi *
│ │ │ │ +0000a1b0: 2048 414e 444c 452c 0a20 2020 2020 2020   HANDLE,.       
│ │ │ │ +0000a1c0: 2020 2053 6869 7368 695f 6173 6e31 204b     Shishi_asn1 K
│ │ │ │ +0000a1d0: 4443 5245 512c 2075 696e 7433 325f 7420  DCREQ, uint32_t 
│ │ │ │ +0000a1e0: 4e4f 4e43 4529 0a20 2020 2020 4841 4e44  NONCE).     HAND
│ │ │ │ +0000a1f0: 4c45 3a20 7368 6973 6869 2068 616e 646c  LE: shishi handl
│ │ │ │ +0000a200: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ +0000a210: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ +0000a220: 2829 e280 992e 0a20 2020 2020 4b44 4352  ().....     KDCR
│ │ │ │ +0000a230: 4551 3a20 4b44 432d 5245 5120 7661 7269  EQ: KDC-REQ vari
│ │ │ │ +0000a240: 6162 6c65 2074 6f20 7365 7420 636c 6965  able to set clie
│ │ │ │ +0000a250: 6e74 206e 616d 6520 6669 656c 6420 696e  nt name field in
│ │ │ │ +0000a260: 2e0a 2020 2020 204e 4f4e 4345 3a20 696e  ..     NONCE: in
│ │ │ │ +0000a270: 7465 6765 7220 6e6f 6e63 6520 746f 2073  teger nonce to s
│ │ │ │ +0000a280: 746f 7265 2069 6e20 4b44 432d 5245 512e  tore in KDC-REQ.
│ │ │ │ +0000a290: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ +0000a2a0: 696f 6e3a 2a20 5374 6f72 6520 6e6f 6e63  ion:* Store nonc
│ │ │ │ +0000a2b0: 6520 6e75 6d62 6572 2066 6965 6c64 2069  e number field i
│ │ │ │ +0000a2c0: 6e20 4b44 432d 5245 512e 0a0a 2020 2020  n KDC-REQ...    
│ │ │ │ +0000a2d0: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ +0000a2e0: 2052 6574 7572 6e73 20e2 8098 5348 4953   Returns ...SHIS
│ │ │ │ +0000a2f0: 4849 5f4f 4be2 8099 2069 6666 2073 7563  HI_OK... iff suc
│ │ │ │ +0000a300: 6365 7373 6675 6c2e 0a0a 7368 6973 6869  cessful...shishi
│ │ │ │ +0000a310: 5f6b 6463 7265 715f 7365 745f 636e 616d  _kdcreq_set_cnam
│ │ │ │ +0000a320: 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  e.--------------
│ │ │ │ +0000a330: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +0000a340: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ +0000a350: 7368 695f 6b64 6372 6571 5f73 6574 5f63  shi_kdcreq_set_c
│ │ │ │ +0000a360: 6e61 6d65 2028 5368 6973 6869 202a 2048  name (Shishi * H
│ │ │ │ +0000a370: 414e 444c 452c 0a20 2020 2020 2020 2020  ANDLE,.         
│ │ │ │ +0000a380: 2053 6869 7368 695f 6173 6e31 204b 4443   Shishi_asn1 KDC
│ │ │ │ +0000a390: 5245 512c 2053 6869 7368 695f 6e61 6d65  REQ, Shishi_name
│ │ │ │ +0000a3a0: 5f74 7970 6520 4e41 4d45 5f54 5950 452c  _type NAME_TYPE,
│ │ │ │ +0000a3b0: 0a20 2020 2020 2020 2020 2063 6f6e 7374  .          const
│ │ │ │ +0000a3c0: 2063 6861 7220 2a20 5052 494e 4349 5041   char * PRINCIPA
│ │ │ │ +0000a3d0: 4c29 0a20 2020 2020 4841 4e44 4c45 3a20  L).     HANDLE: 
│ │ │ │ +0000a3e0: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ +0000a3f0: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ +0000a400: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ +0000a410: 992e 0a20 2020 2020 4b44 4352 4551 3a20  ...     KDCREQ: 
│ │ │ │ +0000a420: 4b44 432d 5245 5120 7661 7269 6162 6c65  KDC-REQ variable
│ │ │ │ +0000a430: 2074 6f20 7365 7420 636c 6965 6e74 206e   to set client n
│ │ │ │ +0000a440: 616d 6520 6669 656c 6420 696e 2e0a 2020  ame field in..  
│ │ │ │ +0000a450: 2020 204e 414d 455f 5459 5045 3a20 7479     NAME_TYPE: ty
│ │ │ │ +0000a460: 7065 206f 6620 7072 696e 6369 7069 616c  pe of principial
│ │ │ │ +0000a470: 2c20 7365 6520 5368 6973 6869 5f6e 616d  , see Shishi_nam
│ │ │ │ +0000a480: 655f 7479 7065 2c20 7573 7561 6c6c 790a  e_type, usually.
│ │ │ │ +0000a490: 2020 2020 2053 4849 5348 495f 4e54 5f55       SHISHI_NT_U
│ │ │ │ +0000a4a0: 4e4b 4e4f 574e 2e0a 2020 2020 2050 5249  NKNOWN..     PRI
│ │ │ │ +0000a4b0: 4e43 4950 414c 3a20 696e 7075 7420 6172  NCIPAL: input ar
│ │ │ │ +0000a4c0: 7261 7920 7769 7468 2070 7269 6e63 6970  ray with princip
│ │ │ │ +0000a4d0: 616c 206e 616d 652e 0a0a 2020 2020 202a  al name...     *
│ │ │ │ +0000a4e0: 4465 7363 7269 7074 696f 6e3a 2a20 5365  Description:* Se
│ │ │ │ +0000a4f0: 7420 7468 6520 636c 6965 6e74 206e 616d  t the client nam
│ │ │ │ +0000a500: 6520 6669 656c 6420 696e 2074 6865 204b  e field in the K
│ │ │ │ +0000a510: 4443 2d52 4551 2e0a 0a20 2020 2020 2a52  DC-REQ...     *R
│ │ │ │ +0000a520: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +0000a530: 7475 726e 7320 5348 4953 4849 5f4f 4b20  turns SHISHI_OK 
│ │ │ │ +0000a540: 6966 6620 7375 6363 6573 7366 756c 2e0a  iff successful..
│ │ │ │ +0000a550: 0a73 6869 7368 695f 6b64 6372 6571 5f63  .shishi_kdcreq_c
│ │ │ │ +0000a560: 6c69 656e 740a 2d2d 2d2d 2d2d 2d2d 2d2d  lient.----------
│ │ │ │ +0000a570: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +0000a580: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ +0000a590: 6973 6869 5f6b 6463 7265 715f 636c 6965  ishi_kdcreq_clie
│ │ │ │ +0000a5a0: 6e74 2028 5368 6973 6869 202a 2048 414e  nt (Shishi * HAN
│ │ │ │ +0000a5b0: 444c 452c 0a20 2020 2020 2020 2020 2053  DLE,.          S
│ │ │ │ +0000a5c0: 6869 7368 695f 6173 6e31 204b 4443 5245  hishi_asn1 KDCRE
│ │ │ │ +0000a5d0: 512c 2063 6861 7220 2a2a 2043 4c49 454e  Q, char ** CLIEN
│ │ │ │ +0000a5e0: 542c 2073 697a 655f 7420 2a20 434c 4945  T, size_t * CLIE
│ │ │ │ +0000a5f0: 4e54 4c45 4e29 0a20 2020 2020 4841 4e44  NTLEN).     HAND
│ │ │ │ +0000a600: 4c45 3a20 5368 6973 6869 206c 6962 7261  LE: Shishi libra
│ │ │ │ +0000a610: 7279 2068 616e 646c 6520 6372 6561 7465  ry handle create
│ │ │ │ +0000a620: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ +0000a630: 6974 2829 e280 992e 0a20 2020 2020 4b44  it().....     KD
│ │ │ │ +0000a640: 4352 4551 3a20 4b44 432d 5245 5120 7661  CREQ: KDC-REQ va
│ │ │ │ +0000a650: 7269 6162 6c65 2074 6f20 6765 7420 636c  riable to get cl
│ │ │ │ +0000a660: 6965 6e74 206e 616d 6520 6672 6f6d 2e0a  ient name from..
│ │ │ │ +0000a670: 2020 2020 2043 4c49 454e 543a 2070 6f69       CLIENT: poi
│ │ │ │ +0000a680: 6e74 6572 2074 6f20 6e65 776c 7920 616c  nter to newly al
│ │ │ │ +0000a690: 6c6f 6361 7465 6420 7a65 726f 2074 6572  located zero ter
│ │ │ │ +0000a6a0: 6d69 6e61 7465 6420 7374 7269 6e67 0a20  minated string. 
│ │ │ │ +0000a6b0: 2020 2020 636f 6e74 6169 6e69 6e67 2070      containing p
│ │ │ │ +0000a6c0: 7269 6e63 6970 616c 206e 616d 652e 2020  rincipal name.  
│ │ │ │ +0000a6d0: 4d61 7920 6265 20e2 8098 4e55 4c4c e280  May be ...NULL..
│ │ │ │ +0000a6e0: 9920 2874 6f20 6f6e 6c79 2070 6f70 756c  . (to only popul
│ │ │ │ +0000a6f0: 6174 650a 2020 2020 2043 4c49 454e 544c  ate.     CLIENTL
│ │ │ │ +0000a700: 454e 292e 0a20 2020 2020 434c 4945 4e54  EN)..     CLIENT
│ │ │ │ +0000a710: 4c45 4e3a 2070 6f69 6e74 6572 2074 6f20  LEN: pointer to 
│ │ │ │ +0000a720: 6c65 6e67 7468 206f 6620 434c 4945 4e54  length of CLIENT
│ │ │ │ +0000a730: 206f 6e20 6f75 7470 7574 2c20 6578 636c   on output, excl
│ │ │ │ +0000a740: 7564 696e 670a 2020 2020 2074 6572 6d69  uding.     termi
│ │ │ │ +0000a750: 6e61 7469 6e67 207a 6572 6f2e 2020 4d61  nating zero.  Ma
│ │ │ │ +0000a760: 7920 6265 20e2 8098 4e55 4c4c e280 9920  y be ...NULL... 
│ │ │ │ +0000a770: 2874 6f20 6f6e 6c79 2070 6f70 756c 6174  (to only populat
│ │ │ │ +0000a780: 6520 434c 4945 4e54 292e 0a0a 2020 2020  e CLIENT)...    
│ │ │ │ +0000a790: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ +0000a7a0: 5265 7072 6573 656e 7420 636c 6965 6e74  Represent client
│ │ │ │ +0000a7b0: 2070 7269 6e63 6970 616c 206e 616d 6520   principal name 
│ │ │ │ +0000a7c0: 696e 204b 4443 2d52 4551 2061 730a 2020  in KDC-REQ as.  
│ │ │ │ +0000a7d0: 2020 207a 6572 6f2d 7465 726d 696e 6174     zero-terminat
│ │ │ │ +0000a7e0: 6564 2073 7472 696e 672e 2020 5468 6520  ed string.  The 
│ │ │ │ +0000a7f0: 7374 7269 6e67 2069 7320 616c 6c6f 6361  string is alloca
│ │ │ │ +0000a800: 7465 2062 7920 7468 6973 2066 756e 6374  te by this funct
│ │ │ │ +0000a810: 696f 6e2c 0a20 2020 2020 616e 6420 6974  ion,.     and it
│ │ │ │ +0000a820: 2069 7320 7468 6520 7265 7370 6f6e 7369   is the responsi
│ │ │ │ +0000a830: 6269 6c69 7479 206f 6620 7468 6520 6361  bility of the ca
│ │ │ │ +0000a840: 6c6c 6572 2074 6f20 6465 616c 6c6f 6361  ller to dealloca
│ │ │ │ +0000a850: 7465 2069 742e 2020 4e6f 7465 0a20 2020  te it.  Note.   
│ │ │ │ +0000a860: 2020 7468 6174 2074 6865 206f 7574 7075    that the outpu
│ │ │ │ +0000a870: 7420 6c65 6e67 7468 2043 4c49 454e 544c  t length CLIENTL
│ │ │ │ +0000a880: 454e 2064 6f65 7320 6e6f 7420 696e 636c  EN does not incl
│ │ │ │ +0000a890: 7564 6520 7468 6520 7465 726d 696e 6174  ude the terminat
│ │ │ │ +0000a8a0: 696e 670a 2020 2020 207a 6572 6f2e 0a0a  ing.     zero...
│ │ │ │ +0000a8b0: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ +0000a8c0: 7565 3a2a 2052 6574 7572 6e73 2053 4849  ue:* Returns SHI
│ │ │ │ +0000a8d0: 5348 495f 4f4b 2069 6666 2073 7563 6365  SHI_OK iff succe
│ │ │ │ +0000a8e0: 7373 6675 6c2e 0a0a 7368 6973 6869 5f61  ssful...shishi_a
│ │ │ │ +0000a8f0: 7372 6571 5f63 6c69 656e 7472 6561 6c6d  sreq_clientrealm
│ │ │ │ +0000a900: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ +0000a910: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +0000a920: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ +0000a930: 7368 695f 6173 7265 715f 636c 6965 6e74  shi_asreq_client
│ │ │ │ +0000a940: 7265 616c 6d20 2853 6869 7368 6920 2a20  realm (Shishi * 
│ │ │ │ +0000a950: 4841 4e44 4c45 2c0a 2020 2020 2020 2020  HANDLE,.        
│ │ │ │ +0000a960: 2020 5368 6973 6869 5f61 736e 3120 4153    Shishi_asn1 AS
│ │ │ │ +0000a970: 5245 512c 2063 6861 7220 2a2a 2043 4c49  REQ, char ** CLI
│ │ │ │ +0000a980: 454e 542c 2073 697a 655f 7420 2a20 434c  ENT, size_t * CL
│ │ │ │ +0000a990: 4945 4e54 4c45 4e29 0a20 2020 2020 4841  IENTLEN).     HA
│ │ │ │ +0000a9a0: 4e44 4c45 3a20 5368 6973 6869 206c 6962  NDLE: Shishi lib
│ │ │ │ +0000a9b0: 7261 7279 2068 616e 646c 6520 6372 6561  rary handle crea
│ │ │ │ +0000a9c0: 7465 2062 7920 e280 9873 6869 7368 695f  te by ...shishi_
│ │ │ │ +0000a9d0: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ +0000a9e0: 4153 5245 513a 2041 532d 5245 5120 7661  ASREQ: AS-REQ va
│ │ │ │ +0000a9f0: 7269 6162 6c65 2074 6f20 6765 7420 636c  riable to get cl
│ │ │ │ +0000aa00: 6965 6e74 206e 616d 6520 616e 6420 7265  ient name and re
│ │ │ │ +0000aa10: 616c 6d20 6672 6f6d 2e0a 2020 2020 2043  alm from..     C
│ │ │ │ +0000aa20: 4c49 454e 543a 2070 6f69 6e74 6572 2074  LIENT: pointer t
│ │ │ │ +0000aa30: 6f20 6e65 776c 7920 616c 6c6f 6361 7465  o newly allocate
│ │ │ │ +0000aa40: 6420 7a65 726f 2074 6572 6d69 6e61 7465  d zero terminate
│ │ │ │ +0000aa50: 6420 7374 7269 6e67 0a20 2020 2020 636f  d string.     co
│ │ │ │ +0000aa60: 6e74 6169 6e69 6e67 2070 7269 6e63 6970  ntaining princip
│ │ │ │ +0000aa70: 616c 206e 616d 6520 616e 6420 7265 616c  al name and real
│ │ │ │ +0000aa80: 6d2e 2020 4d61 7920 6265 20e2 8098 4e55  m.  May be ...NU
│ │ │ │ +0000aa90: 4c4c e280 9920 2874 6f20 6f6e 6c79 0a20  LL... (to only. 
│ │ │ │ +0000aaa0: 2020 2020 706f 7075 6c61 7465 2043 4c49      populate CLI
│ │ │ │ +0000aab0: 454e 544c 454e 292e 0a20 2020 2020 434c  ENTLEN)..     CL
│ │ │ │ +0000aac0: 4945 4e54 4c45 4e3a 2070 6f69 6e74 6572  IENTLEN: pointer
│ │ │ │ +0000aad0: 2074 6f20 6c65 6e67 7468 206f 6620 434c   to length of CL
│ │ │ │ +0000aae0: 4945 4e54 206f 6e20 6f75 7470 7574 2c20  IENT on output, 
│ │ │ │ +0000aaf0: 6578 636c 7564 696e 670a 2020 2020 2074  excluding.     t
│ │ │ │ +0000ab00: 6572 6d69 6e61 7469 6e67 207a 6572 6f2e  erminating zero.
│ │ │ │ +0000ab10: 2020 4d61 7920 6265 20e2 8098 4e55 4c4c    May be ...NULL
│ │ │ │ +0000ab20: e280 9920 2874 6f20 6f6e 6c79 2070 6f70  ... (to only pop
│ │ │ │ +0000ab30: 756c 6174 6520 434c 4945 4e54 292e 0a0a  ulate CLIENT)...
│ │ │ │ +0000ab40: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ +0000ab50: 6e3a 2a20 436f 6e76 6572 7420 636e 616d  n:* Convert cnam
│ │ │ │ +0000ab60: 6520 616e 6420 7265 616c 6d20 6669 656c  e and realm fiel
│ │ │ │ +0000ab70: 6473 2066 726f 6d20 4153 2d52 4551 2074  ds from AS-REQ t
│ │ │ │ +0000ab80: 6f0a 2020 2020 2070 7269 6e74 6162 6c65  o.     printable
│ │ │ │ +0000ab90: 2070 7269 6e63 6970 616c 206e 616d 6520   principal name 
│ │ │ │ +0000aba0: 666f 726d 6174 2e20 2054 6865 2073 7472  format.  The str
│ │ │ │ +0000abb0: 696e 6720 6973 2061 6c6c 6f63 6174 6520  ing is allocate 
│ │ │ │ +0000abc0: 6279 2074 6869 730a 2020 2020 2066 756e  by this.     fun
│ │ │ │ +0000abd0: 6374 696f 6e2c 2061 6e64 2069 7420 6973  ction, and it is
│ │ │ │ +0000abe0: 2074 6865 2072 6573 706f 6e73 6962 696c   the responsibil
│ │ │ │ +0000abf0: 6974 7920 6f66 2074 6865 2063 616c 6c65  ity of the calle
│ │ │ │ +0000ac00: 7220 746f 2064 6561 6c6c 6f63 6174 650a  r to deallocate.
│ │ │ │ +0000ac10: 2020 2020 2069 742e 2020 4e6f 7465 2074       it.  Note t
│ │ │ │ +0000ac20: 6861 7420 7468 6520 6f75 7470 7574 206c  hat the output l
│ │ │ │ +0000ac30: 656e 6774 6820 434c 4945 4e54 4c45 4e20  ength CLIENTLEN 
│ │ │ │ +0000ac40: 646f 6573 206e 6f74 2069 6e63 6c75 6465  does not include
│ │ │ │ +0000ac50: 2074 6865 0a20 2020 2020 7465 726d 696e   the.     termin
│ │ │ │ +0000ac60: 6174 696e 6720 7a65 726f 2e0a 0a20 2020  ating zero...   
│ │ │ │ +0000ac70: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ +0000ac80: 2a20 5265 7475 726e 7320 5348 4953 4849  * Returns SHISHI
│ │ │ │ +0000ac90: 5f4f 4b20 6966 6620 7375 6363 6573 7366  _OK iff successf
│ │ │ │ +0000aca0: 756c 2e0a 0a73 6869 7368 695f 6b64 6372  ul...shishi_kdcr
│ │ │ │ +0000acb0: 6571 5f72 6561 6c6d 0a2d 2d2d 2d2d 2d2d  eq_realm.-------
│ │ │ │ +0000acc0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ +0000acd0: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ +0000ace0: 7368 6973 6869 5f6b 6463 7265 715f 7265  shishi_kdcreq_re
│ │ │ │ +0000acf0: 616c 6d20 2853 6869 7368 6920 2a20 4841  alm (Shishi * HA
│ │ │ │ +0000ad00: 4e44 4c45 2c0a 2020 2020 2020 2020 2020  NDLE,.          
│ │ │ │ +0000ad10: 5368 6973 6869 5f61 736e 3120 4b44 4352  Shishi_asn1 KDCR
│ │ │ │ +0000ad20: 4551 2c20 6368 6172 202a 2a20 5245 414c  EQ, char ** REAL
│ │ │ │ +0000ad30: 4d2c 2073 697a 655f 7420 2a20 5245 414c  M, size_t * REAL
│ │ │ │ +0000ad40: 4d4c 454e 290a 2020 2020 2048 414e 444c  MLEN).     HANDL
│ │ │ │ +0000ad50: 453a 2053 6869 7368 6920 6c69 6272 6172  E: Shishi librar
│ │ │ │ +0000ad60: 7920 6861 6e64 6c65 2063 7265 6174 6520  y handle create 
│ │ │ │ +0000ad70: 6279 20e2 8098 7368 6973 6869 5f69 6e69  by ...shishi_ini
│ │ │ │ +0000ad80: 7428 29e2 8099 2e0a 2020 2020 204b 4443  t().....     KDC
│ │ │ │ +0000ad90: 5245 513a 204b 4443 2d52 4551 2076 6172  REQ: KDC-REQ var
│ │ │ │ +0000ada0: 6961 626c 6520 746f 2067 6574 2063 6c69  iable to get cli
│ │ │ │ +0000adb0: 656e 7420 6e61 6d65 2066 726f 6d2e 0a20  ent name from.. 
│ │ │ │ +0000adc0: 2020 2020 5245 414c 4d3a 2070 6f69 6e74      REALM: point
│ │ │ │ +0000add0: 6572 2074 6f20 6e65 776c 7920 616c 6c6f  er to newly allo
│ │ │ │ +0000ade0: 6361 7465 6420 7a65 726f 2074 6572 6d69  cated zero termi
│ │ │ │ +0000adf0: 6e61 7465 6420 7374 7269 6e67 2063 6f6e  nated string con
│ │ │ │ +0000ae00: 7461 696e 696e 670a 2020 2020 2072 6561  taining.     rea
│ │ │ │ +0000ae10: 6c6d 2e20 204d 6179 2062 6520 e280 984e  lm.  May be ...N
│ │ │ │ +0000ae20: 554c 4ce2 8099 2028 746f 206f 6e6c 7920  ULL... (to only 
│ │ │ │ +0000ae30: 706f 7075 6c61 7465 2052 4541 4c4d 4c45  populate REALMLE
│ │ │ │ +0000ae40: 4e29 2e0a 2020 2020 2052 4541 4c4d 4c45  N)..     REALMLE
│ │ │ │ +0000ae50: 4e3a 2070 6f69 6e74 6572 2074 6f20 6c65  N: pointer to le
│ │ │ │ +0000ae60: 6e67 7468 206f 6620 5245 414c 4d20 6f6e  ngth of REALM on
│ │ │ │ +0000ae70: 206f 7574 7075 742c 2065 7863 6c75 6469   output, excludi
│ │ │ │ +0000ae80: 6e67 0a20 2020 2020 7465 726d 696e 6174  ng.     terminat
│ │ │ │ +0000ae90: 696e 6720 7a65 726f 2e20 204d 6179 2062  ing zero.  May b
│ │ │ │ +0000aea0: 6520 e280 984e 554c 4ce2 8099 2028 746f  e ...NULL... (to
│ │ │ │ +0000aeb0: 206f 6e6c 7920 706f 7075 6c61 7465 2052   only populate R
│ │ │ │ +0000aec0: 4541 4c4d 4c45 4e29 2e0a 0a20 2020 2020  EALMLEN)...     
│ │ │ │ +0000aed0: 2a44 6573 6372 6970 7469 6f6e 3a2a 2047  *Description:* G
│ │ │ │ +0000aee0: 6574 2072 6561 6c6d 2066 6965 6c64 2069  et realm field i
│ │ │ │ +0000aef0: 6e20 4b44 432d 5245 5120 6173 207a 6572  n KDC-REQ as zer
│ │ │ │ +0000af00: 6f2d 7465 726d 696e 6174 6564 0a20 2020  o-terminated.   
│ │ │ │ +0000af10: 2020 7374 7269 6e67 2e20 2054 6865 2073    string.  The s
│ │ │ │ +0000af20: 7472 696e 6720 6973 2061 6c6c 6f63 6174  tring is allocat
│ │ │ │ +0000af30: 6520 6279 2074 6869 7320 6675 6e63 7469  e by this functi
│ │ │ │ +0000af40: 6f6e 2c20 616e 6420 6974 2069 7320 7468  on, and it is th
│ │ │ │ +0000af50: 650a 2020 2020 2072 6573 706f 6e73 6962  e.     responsib
│ │ │ │ +0000af60: 696c 6974 7920 6f66 2074 6865 2063 616c  ility of the cal
│ │ │ │ +0000af70: 6c65 7220 746f 2064 6561 6c6c 6f63 6174  ler to deallocat
│ │ │ │ +0000af80: 6520 6974 2e20 204e 6f74 6520 7468 6174  e it.  Note that
│ │ │ │ +0000af90: 2074 6865 0a20 2020 2020 6f75 7470 7574   the.     output
│ │ │ │ +0000afa0: 206c 656e 6774 6820 5245 414c 4d4c 454e   length REALMLEN
│ │ │ │ +0000afb0: 2064 6f65 7320 6e6f 7420 696e 636c 7564   does not includ
│ │ │ │ +0000afc0: 6520 7468 6520 7465 726d 696e 6174 696e  e the terminatin
│ │ │ │ +0000afd0: 6720 7a65 726f 2e0a 0a20 2020 2020 2a52  g zero...     *R
│ │ │ │ +0000afe0: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +0000aff0: 7475 726e 7320 5348 4953 4849 5f4f 4b20  turns SHISHI_OK 
│ │ │ │ +0000b000: 6966 6620 7375 6363 6573 7366 756c 2e0a  iff successful..
│ │ │ │ +0000b010: 0a73 6869 7368 695f 6b64 6372 6571 5f73  .shishi_kdcreq_s
│ │ │ │ +0000b020: 6574 5f72 6561 6c6d 0a2d 2d2d 2d2d 2d2d  et_realm.-------
│ │ │ │ +0000b030: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +0000b040: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +0000b050: 696e 7420 7368 6973 6869 5f6b 6463 7265  int shishi_kdcre
│ │ │ │ +0000b060: 715f 7365 745f 7265 616c 6d20 2853 6869  q_set_realm (Shi
│ │ │ │ +0000b070: 7368 6920 2a20 4841 4e44 4c45 2c0a 2020  shi * HANDLE,.  
│ │ │ │ +0000b080: 2020 2020 2020 2020 5368 6973 6869 5f61          Shishi_a
│ │ │ │ +0000b090: 736e 3120 4b44 4352 4551 2c20 636f 6e73  sn1 KDCREQ, cons
│ │ │ │ +0000b0a0: 7420 6368 6172 202a 2052 4541 4c4d 290a  t char * REALM).
│ │ │ │ +0000b0b0: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ +0000b0c0: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ +0000b0d0: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ +0000b0e0: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ +0000b0f0: 2020 2020 204b 4443 5245 513a 204b 4443       KDCREQ: KDC
│ │ │ │ +0000b100: 2d52 4551 2076 6172 6961 626c 6520 746f  -REQ variable to
│ │ │ │ +0000b110: 2073 6574 2072 6561 6c6d 2066 6965 6c64   set realm field
│ │ │ │ +0000b120: 2069 6e2e 0a20 2020 2020 5245 414c 4d3a   in..     REALM:
│ │ │ │ +0000b130: 2069 6e70 7574 2061 7272 6179 2077 6974   input array wit
│ │ │ │ +0000b140: 6820 6e61 6d65 206f 6620 7265 616c 6d2e  h name of realm.
│ │ │ │ +0000b150: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ +0000b160: 696f 6e3a 2a20 5365 7420 7468 6520 7265  ion:* Set the re
│ │ │ │ +0000b170: 616c 6d20 6669 656c 6420 696e 2074 6865  alm field in the
│ │ │ │ +0000b180: 204b 4443 2d52 4551 2e0a 0a20 2020 2020   KDC-REQ...     
│ │ │ │ +0000b190: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ +0000b1a0: 5265 7475 726e 7320 5348 4953 4849 5f4f  Returns SHISHI_O
│ │ │ │ +0000b1b0: 4b20 6966 6620 7375 6363 6573 7366 756c  K iff successful
│ │ │ │ +0000b1c0: 2e0a 0a73 6869 7368 695f 6b64 6372 6571  ...shishi_kdcreq
│ │ │ │ +0000b1d0: 5f73 6572 7665 720a 2d2d 2d2d 2d2d 2d2d  _server.--------
│ │ │ │ +0000b1e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ +0000b1f0: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ +0000b200: 7368 6973 6869 5f6b 6463 7265 715f 7365  shishi_kdcreq_se
│ │ │ │ +0000b210: 7276 6572 2028 5368 6973 6869 202a 2048  rver (Shishi * H
│ │ │ │ +0000b220: 414e 444c 452c 0a20 2020 2020 2020 2020  ANDLE,.         
│ │ │ │ +0000b230: 2053 6869 7368 695f 6173 6e31 204b 4443   Shishi_asn1 KDC
│ │ │ │ +0000b240: 5245 512c 2063 6861 7220 2a2a 2053 4552  REQ, char ** SER
│ │ │ │ +0000b250: 5645 522c 2073 697a 655f 7420 2a20 5345  VER, size_t * SE
│ │ │ │ +0000b260: 5256 4552 4c45 4e29 0a20 2020 2020 4841  RVERLEN).     HA
│ │ │ │ +0000b270: 4e44 4c45 3a20 5368 6973 6869 206c 6962  NDLE: Shishi lib
│ │ │ │ +0000b280: 7261 7279 2068 616e 646c 6520 6372 6561  rary handle crea
│ │ │ │ +0000b290: 7465 2062 7920 e280 9873 6869 7368 695f  te by ...shishi_
│ │ │ │ +0000b2a0: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ +0000b2b0: 4b44 4352 4551 3a20 4b44 432d 5245 5120  KDCREQ: KDC-REQ 
│ │ │ │ +0000b2c0: 7661 7269 6162 6c65 2074 6f20 6765 7420  variable to get 
│ │ │ │ +0000b2d0: 7365 7276 6572 206e 616d 6520 6672 6f6d  server name from
│ │ │ │ +0000b2e0: 2e0a 2020 2020 2053 4552 5645 523a 2070  ..     SERVER: p
│ │ │ │ +0000b2f0: 6f69 6e74 6572 2074 6f20 6e65 776c 7920  ointer to newly 
│ │ │ │ +0000b300: 616c 6c6f 6361 7465 6420 7a65 726f 2074  allocated zero t
│ │ │ │ +0000b310: 6572 6d69 6e61 7465 6420 7374 7269 6e67  erminated string
│ │ │ │ +0000b320: 0a20 2020 2020 636f 6e74 6169 6e69 6e67  .     containing
│ │ │ │ +0000b330: 2070 7269 6e63 6970 616c 206e 616d 652e   principal name.
│ │ │ │ +0000b340: 2020 4d61 7920 6265 20e2 8098 4e55 4c4c    May be ...NULL
│ │ │ │ +0000b350: e280 9920 2874 6f20 6f6e 6c79 2070 6f70  ... (to only pop
│ │ │ │ +0000b360: 756c 6174 650a 2020 2020 2053 4552 5645  ulate.     SERVE
│ │ │ │ +0000b370: 524c 454e 292e 0a20 2020 2020 5345 5256  RLEN)..     SERV
│ │ │ │ +0000b380: 4552 4c45 4e3a 2070 6f69 6e74 6572 2074  ERLEN: pointer t
│ │ │ │ +0000b390: 6f20 6c65 6e67 7468 206f 6620 5345 5256  o length of SERV
│ │ │ │ +0000b3a0: 4552 206f 6e20 6f75 7470 7574 2c20 6578  ER on output, ex
│ │ │ │ +0000b3b0: 636c 7564 696e 670a 2020 2020 2074 6572  cluding.     ter
│ │ │ │ +0000b3c0: 6d69 6e61 7469 6e67 207a 6572 6f2e 2020  minating zero.  
│ │ │ │ +0000b3d0: 4d61 7920 6265 20e2 8098 4e55 4c4c e280  May be ...NULL..
│ │ │ │ +0000b3e0: 9920 2874 6f20 6f6e 6c79 2070 6f70 756c  . (to only popul
│ │ │ │ +0000b3f0: 6174 6520 5345 5256 4552 292e 0a0a 2020  ate SERVER)...  
│ │ │ │ +0000b400: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ +0000b410: 2a20 5265 7072 6573 656e 7420 7365 7276  * Represent serv
│ │ │ │ +0000b420: 6572 2070 7269 6e63 6970 616c 206e 616d  er principal nam
│ │ │ │ +0000b430: 6520 696e 204b 4443 2d52 4551 2061 730a  e in KDC-REQ as.
│ │ │ │ +0000b440: 2020 2020 207a 6572 6f2d 7465 726d 696e       zero-termin
│ │ │ │ +0000b450: 6174 6564 2073 7472 696e 672e 2020 5468  ated string.  Th
│ │ │ │ +0000b460: 6520 7374 7269 6e67 2069 7320 616c 6c6f  e string is allo
│ │ │ │ +0000b470: 6361 7465 2062 7920 7468 6973 2066 756e  cate by this fun
│ │ │ │ +0000b480: 6374 696f 6e2c 0a20 2020 2020 616e 6420  ction,.     and 
│ │ │ │ +0000b490: 6974 2069 7320 7468 6520 7265 7370 6f6e  it is the respon
│ │ │ │ +0000b4a0: 7369 6269 6c69 7479 206f 6620 7468 6520  sibility of the 
│ │ │ │ +0000b4b0: 6361 6c6c 6572 2074 6f20 6465 616c 6c6f  caller to deallo
│ │ │ │ +0000b4c0: 6361 7465 2069 742e 2020 4e6f 7465 0a20  cate it.  Note. 
│ │ │ │ +0000b4d0: 2020 2020 7468 6174 2074 6865 206f 7574      that the out
│ │ │ │ +0000b4e0: 7075 7420 6c65 6e67 7468 2053 4552 5645  put length SERVE
│ │ │ │ +0000b4f0: 524c 454e 2064 6f65 7320 6e6f 7420 696e  RLEN does not in
│ │ │ │ +0000b500: 636c 7564 6520 7468 6520 7465 726d 696e  clude the termin
│ │ │ │ +0000b510: 6174 696e 670a 2020 2020 207a 6572 6f2e  ating.     zero.
│ │ │ │ +0000b520: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ +0000b530: 616c 7565 3a2a 2052 6574 7572 6e73 2053  alue:* Returns S
│ │ │ │ +0000b540: 4849 5348 495f 4f4b 2069 6666 2073 7563  HISHI_OK iff suc
│ │ │ │ +0000b550: 6365 7373 6675 6c2e 0a0a 7368 6973 6869  cessful...shishi
│ │ │ │ +0000b560: 5f6b 6463 7265 715f 7365 745f 736e 616d  _kdcreq_set_snam
│ │ │ │ +0000b570: 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  e.--------------
│ │ │ │ +0000b580: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +0000b590: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ +0000b5a0: 7368 695f 6b64 6372 6571 5f73 6574 5f73  shi_kdcreq_set_s
│ │ │ │ +0000b5b0: 6e61 6d65 2028 5368 6973 6869 202a 2048  name (Shishi * H
│ │ │ │ +0000b5c0: 414e 444c 452c 0a20 2020 2020 2020 2020  ANDLE,.         
│ │ │ │ +0000b5d0: 2053 6869 7368 695f 6173 6e31 204b 4443   Shishi_asn1 KDC
│ │ │ │ +0000b5e0: 5245 512c 2053 6869 7368 695f 6e61 6d65  REQ, Shishi_name
│ │ │ │ +0000b5f0: 5f74 7970 6520 4e41 4d45 5f54 5950 452c  _type NAME_TYPE,
│ │ │ │ +0000b600: 0a20 2020 2020 2020 2020 2063 6f6e 7374  .          const
│ │ │ │ +0000b610: 2063 6861 7220 2a20 534e 414d 455b 5d29   char * SNAME[])
│ │ │ │ +0000b620: 0a20 2020 2020 4841 4e44 4c45 3a20 7368  .     HANDLE: sh
│ │ │ │ +0000b630: 6973 6869 2068 616e 646c 6520 6173 2061  ishi handle as a
│ │ │ │ +0000b640: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ +0000b650: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ +0000b660: 0a20 2020 2020 4b44 4352 4551 3a20 4b44  .     KDCREQ: KD
│ │ │ │ +0000b670: 432d 5245 5120 7661 7269 6162 6c65 2074  C-REQ variable t
│ │ │ │ +0000b680: 6f20 7365 7420 7365 7276 6572 206e 616d  o set server nam
│ │ │ │ +0000b690: 6520 6669 656c 6420 696e 2e0a 2020 2020  e field in..    
│ │ │ │ +0000b6a0: 204e 414d 455f 5459 5045 3a20 7479 7065   NAME_TYPE: type
│ │ │ │ +0000b6b0: 206f 6620 7072 696e 6369 7069 616c 2c20   of principial, 
│ │ │ │ +0000b6c0: 7365 6520 5368 6973 6869 5f6e 616d 655f  see Shishi_name_
│ │ │ │ +0000b6d0: 7479 7065 2c20 7573 7561 6c6c 790a 2020  type, usually.  
│ │ │ │ +0000b6e0: 2020 2053 4849 5348 495f 4e54 5f55 4e4b     SHISHI_NT_UNK
│ │ │ │ +0000b6f0: 4e4f 574e 2e0a 2020 2020 2053 4e41 4d45  NOWN..     SNAME
│ │ │ │ +0000b700: 3a20 696e 7075 7420 6172 7261 7920 7769  : input array wi
│ │ │ │ +0000b710: 7468 2070 7269 6e63 6970 616c 206e 616d  th principal nam
│ │ │ │ +0000b720: 652e 0a0a 2020 2020 202a 4465 7363 7269  e...     *Descri
│ │ │ │ +0000b730: 7074 696f 6e3a 2a20 5365 7420 7468 6520  ption:* Set the 
│ │ │ │ +0000b740: 7365 7276 6572 206e 616d 6520 6669 656c  server name fiel
│ │ │ │ +0000b750: 6420 696e 2074 6865 204b 4443 2d52 4551  d in the KDC-REQ
│ │ │ │ +0000b760: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ +0000b770: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ +0000b780: 5348 4953 4849 5f4f 4b20 6966 6620 7375  SHISHI_OK iff su
│ │ │ │ +0000b790: 6363 6573 7366 756c 2e0a 0a73 6869 7368  ccessful...shish
│ │ │ │ +0000b7a0: 695f 6b64 6372 6571 5f74 696c 6c0a 2d2d  i_kdcreq_till.--
│ │ │ │ +0000b7b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +0000b7c0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +0000b7d0: 696e 7420 7368 6973 6869 5f6b 6463 7265  int shishi_kdcre
│ │ │ │ +0000b7e0: 715f 7469 6c6c 2028 5368 6973 6869 202a  q_till (Shishi *
│ │ │ │ +0000b7f0: 2048 414e 444c 452c 0a20 2020 2020 2020   HANDLE,.       
│ │ │ │ +0000b800: 2020 2053 6869 7368 695f 6173 6e31 204b     Shishi_asn1 K
│ │ │ │ +0000b810: 4443 5245 512c 2063 6861 7220 2a2a 2054  DCREQ, char ** T
│ │ │ │ +0000b820: 494c 4c2c 2073 697a 655f 7420 2a20 5449  ILL, size_t * TI
│ │ │ │ +0000b830: 4c4c 4c45 4e29 0a20 2020 2020 4841 4e44  LLLEN).     HAND
│ │ │ │ +0000b840: 4c45 3a20 5368 6973 6869 206c 6962 7261  LE: Shishi libra
│ │ │ │ +0000b850: 7279 2068 616e 646c 6520 6372 6561 7465  ry handle create
│ │ │ │ +0000b860: 6420 6279 20e2 8098 7368 6973 6869 5f69  d by ...shishi_i
│ │ │ │ +0000b870: 6e69 7428 29e2 8099 2e0a 2020 2020 204b  nit().....     K
│ │ │ │ +0000b880: 4443 5245 513a 204b 4443 2d52 4551 2076  DCREQ: KDC-REQ v
│ │ │ │ +0000b890: 6172 6961 626c 6520 746f 2067 6574 2065  ariable to get e
│ │ │ │ +0000b8a0: 6e64 7469 6d65 2066 726f 6d2e 0a20 2020  ndtime from..   
│ │ │ │ +0000b8b0: 2020 5449 4c4c 3a20 706f 696e 7465 7220    TILL: pointer 
│ │ │ │ +0000b8c0: 746f 206e 6577 6c79 2061 6c6c 6f63 6174  to newly allocat
│ │ │ │ +0000b8d0: 6564 206e 756c 6c20 7465 726d 696e 6174  ed null terminat
│ │ │ │ +0000b8e0: 6564 2073 7472 696e 6720 636f 6e74 6169  ed string contai
│ │ │ │ +0000b8f0: 6e69 6e67 0a20 2020 2020 2274 696c 6c22  ning.     "till"
│ │ │ │ +0000b900: 2066 6965 6c64 2077 6974 6820 6765 6e65   field with gene
│ │ │ │ +0000b910: 7261 6c69 7a65 6420 7469 6d65 2e20 204d  ralized time.  M
│ │ │ │ +0000b920: 6179 2062 6520 7061 7373 6564 2061 7320  ay be passed as 
│ │ │ │ +0000b930: e280 984e 554c 4ce2 8099 2074 6f0a 2020  ...NULL... to.  
│ │ │ │ +0000b940: 2020 206f 6e6c 7920 706f 7075 6c61 7465     only populate
│ │ │ │ +0000b950: 2054 494c 4c4c 454e 2e0a 2020 2020 2054   TILLLEN..     T
│ │ │ │ +0000b960: 494c 4c4c 454e 3a20 706f 696e 7465 7220  ILLLEN: pointer 
│ │ │ │ +0000b970: 746f 206c 656e 6774 6820 6f66 2054 494c  to length of TIL
│ │ │ │ +0000b980: 4c20 666f 7220 6f75 7470 7574 2c20 6578  L for output, ex
│ │ │ │ +0000b990: 636c 7564 696e 6720 7468 650a 2020 2020  cluding the.    
│ │ │ │ +0000b9a0: 2074 6572 6d69 6e61 7469 6e67 206e 756c   terminating nul
│ │ │ │ +0000b9b0: 6c2e 2020 5365 7420 746f 20e2 8098 4e55  l.  Set to ...NU
│ │ │ │ +0000b9c0: 4c4c e280 992c 206f 6e6c 7920 5449 4c4c  LL..., only TILL
│ │ │ │ +0000b9d0: 2069 7320 706f 7075 6c61 7465 642e 0a0a   is populated...
│ │ │ │ +0000b9e0: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ +0000b9f0: 6e3a 2a20 4765 7420 2274 696c 6c22 2066  n:* Get "till" f
│ │ │ │ +0000ba00: 6965 6c64 2c20 692e 652e 2c20 2265 6e64  ield, i.e., "end
│ │ │ │ +0000ba10: 7469 6d65 222c 2069 6e20 4b44 432d 5245  time", in KDC-RE
│ │ │ │ +0000ba20: 5120 6173 2061 0a20 2020 2020 6e75 6c6c  Q as a.     null
│ │ │ │ +0000ba30: 2d74 6572 6d69 6e61 7465 6420 7374 7269  -terminated stri
│ │ │ │ +0000ba40: 6e67 2e20 2054 6865 2073 7472 696e 6720  ng.  The string 
│ │ │ │ +0000ba50: 6973 2074 7970 6963 616c 6c79 2031 3520  is typically 15 
│ │ │ │ +0000ba60: 6368 6172 6163 7465 7273 206c 6f6e 670a  characters long.
│ │ │ │ +0000ba70: 2020 2020 2061 6e64 2069 7320 616c 6c6f       and is allo
│ │ │ │ +0000ba80: 6361 7465 6420 6279 2074 6869 7320 6675  cated by this fu
│ │ │ │ +0000ba90: 6e63 7469 6f6e 2e20 2049 7420 6973 2074  nction.  It is t
│ │ │ │ +0000baa0: 6865 2072 6573 706f 6e73 6962 696c 6974  he responsibilit
│ │ │ │ +0000bab0: 7920 6f66 2074 6865 0a20 2020 2020 6361  y of the.     ca
│ │ │ │ +0000bac0: 6c6c 6572 2074 6f20 6465 616c 6c6f 6361  ller to dealloca
│ │ │ │ +0000bad0: 7465 2069 742e 2020 4e6f 7465 2074 6861  te it.  Note tha
│ │ │ │ +0000bae0: 7420 7468 6520 6f75 7470 7574 206c 656e  t the output len
│ │ │ │ +0000baf0: 6774 6820 5449 4c4c 4c45 4e20 646f 6573  gth TILLLEN does
│ │ │ │ +0000bb00: 0a20 2020 2020 6e6f 7420 696e 636c 7564  .     not includ
│ │ │ │ +0000bb10: 6520 7468 6520 7465 726d 696e 6174 696e  e the terminatin
│ │ │ │ +0000bb20: 6720 7a65 726f 2e0a 0a20 2020 2020 2a52  g zero...     *R
│ │ │ │ +0000bb30: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +0000bb40: 7475 726e 7320 5348 4953 4849 5f4f 4b20  turns SHISHI_OK 
│ │ │ │ +0000bb50: 6966 6620 7375 6363 6573 7366 756c 2e0a  iff successful..
│ │ │ │ +0000bb60: 0a73 6869 7368 695f 6b64 6372 6571 5f74  .shishi_kdcreq_t
│ │ │ │ +0000bb70: 696c 6c63 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  illc.-----------
│ │ │ │ +0000bb80: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ +0000bb90: 6e63 7469 6f6e 3a20 7469 6d65 5f74 2073  nction: time_t s
│ │ │ │ +0000bba0: 6869 7368 695f 6b64 6372 6571 5f74 696c  hishi_kdcreq_til
│ │ │ │ +0000bbb0: 6c63 2028 5368 6973 6869 202a 2048 414e  lc (Shishi * HAN
│ │ │ │ +0000bbc0: 444c 452c 0a20 2020 2020 2020 2020 2053  DLE,.          S
│ │ │ │ +0000bbd0: 6869 7368 695f 6173 6e31 204b 4443 5245  hishi_asn1 KDCRE
│ │ │ │ +0000bbe0: 5129 0a20 2020 2020 4841 4e44 4c45 3a20  Q).     HANDLE: 
│ │ │ │ +0000bbf0: 5368 6973 6869 206c 6962 7261 7279 2068  Shishi library h
│ │ │ │ +0000bc00: 616e 646c 6520 6372 6561 7465 6420 6279  andle created by
│ │ │ │ +0000bc10: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ +0000bc20: 29e2 8099 2e0a 2020 2020 204b 4443 5245  ).....     KDCRE
│ │ │ │ +0000bc30: 513a 204b 4443 2d52 4551 2076 6172 6961  Q: KDC-REQ varia
│ │ │ │ +0000bc40: 626c 6520 746f 2067 6574 2022 7469 6c6c  ble to get "till
│ │ │ │ +0000bc50: 2220 6669 656c 6420 6672 6f6d 2e0a 0a20  " field from... 
│ │ │ │ +0000bc60: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ +0000bc70: 3a2a 2045 7874 7261 6374 2043 2074 696d  :* Extract C tim
│ │ │ │ +0000bc80: 6520 636f 7272 6573 706f 6e64 696e 6720  e corresponding 
│ │ │ │ +0000bc90: 746f 2074 6865 2022 7469 6c6c 2220 6669  to the "till" fi
│ │ │ │ +0000bca0: 656c 642e 0a0a 2020 2020 202a 5265 7475  eld...     *Retu
│ │ │ │ +0000bcb0: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ +0000bcc0: 6e73 2074 6865 2043 2074 696d 6520 696e  ns the C time in
│ │ │ │ +0000bcd0: 7465 7270 7265 7461 7469 6f6e 206f 6620  terpretation of 
│ │ │ │ +0000bce0: 7468 6520 2274 696c 6c22 0a20 2020 2020  the "till".     
│ │ │ │ +0000bcf0: 6669 656c 6420 696e 204b 4443 2d52 4551  field in KDC-REQ
│ │ │ │ +0000bd00: 2e0a 0a73 6869 7368 695f 6b64 6372 6571  ...shishi_kdcreq
│ │ │ │ +0000bd10: 5f65 7479 7065 0a2d 2d2d 2d2d 2d2d 2d2d  _etype.---------
│ │ │ │ +0000bd20: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +0000bd30: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ +0000bd40: 6973 6869 5f6b 6463 7265 715f 6574 7970  ishi_kdcreq_etyp
│ │ │ │ +0000bd50: 6520 2853 6869 7368 6920 2a20 4841 4e44  e (Shishi * HAND
│ │ │ │ +0000bd60: 4c45 2c0a 2020 2020 2020 2020 2020 5368  LE,.          Sh
│ │ │ │ +0000bd70: 6973 6869 5f61 736e 3120 4b44 4352 4551  ishi_asn1 KDCREQ
│ │ │ │ +0000bd80: 2c20 696e 7433 325f 7420 2a20 4554 5950  , int32_t * ETYP
│ │ │ │ +0000bd90: 452c 2069 6e74 204e 4554 5950 4529 0a20  E, int NETYPE). 
│ │ │ │ +0000bda0: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ +0000bdb0: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ +0000bdc0: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ +0000bdd0: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ +0000bde0: 2020 2020 4b44 4352 4551 3a20 4b44 432d      KDCREQ: KDC-
│ │ │ │ +0000bdf0: 5245 5120 7661 7269 6162 6c65 2074 6f20  REQ variable to 
│ │ │ │ +0000be00: 6765 7420 6574 7970 6520 6669 656c 6420  get etype field 
│ │ │ │ +0000be10: 6672 6f6d 2e0a 2020 2020 2045 5459 5045  from..     ETYPE
│ │ │ │ +0000be20: 3a20 6f75 7470 7574 2065 6e63 7279 7074  : output encrypt
│ │ │ │ +0000be30: 696f 6e20 7479 7065 2e0a 2020 2020 204e  ion type..     N
│ │ │ │ +0000be40: 4554 5950 453a 2065 6c65 6d65 6e74 206e  ETYPE: element n
│ │ │ │ +0000be50: 756d 6265 7220 746f 2072 6574 7572 6e2e  umber to return.
│ │ │ │ +0000be60: 0a0a 2020 2020 202a 5265 7475 726e 2074  ..     *Return t
│ │ │ │ +0000be70: 6865 206e 6574 7970 653a 2a20 7468 2065  he netype:* th e
│ │ │ │ +0000be80: 6e63 7279 7074 696f 6e20 7479 7065 2066  ncryption type f
│ │ │ │ +0000be90: 726f 6d20 4b44 432d 5245 512e 2054 6865  rom KDC-REQ. The
│ │ │ │ +0000bea0: 2066 6972 7374 0a20 2020 2020 6574 7970   first.     etyp
│ │ │ │ +0000beb0: 6520 6973 206e 756d 6265 7220 312e 0a0a  e is number 1...
│ │ │ │ +0000bec0: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ +0000bed0: 7565 3a2a 2052 6574 7572 6e73 2053 4849  ue:* Returns SHI
│ │ │ │ +0000bee0: 5348 495f 4f4b 2069 6666 2065 7479 7065  SHI_OK iff etype
│ │ │ │ +0000bef0: 2073 7563 6365 7373 6675 6c20 7365 742e   successful set.
│ │ │ │ +0000bf00: 0a0a 7368 6973 6869 5f6b 6463 7265 715f  ..shishi_kdcreq_
│ │ │ │ +0000bf10: 7365 745f 6574 7970 650a 2d2d 2d2d 2d2d  set_etype.------
│ │ │ │  0000bf20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0000bf30: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ -0000bf40: 696e 7420 7368 6973 6869 5f6b 6463 7265  int shishi_kdcre
│ │ │ │ -0000bf50: 715f 7365 745f 6574 7970 6520 2853 6869  q_set_etype (Shi
│ │ │ │ -0000bf60: 7368 6920 2a20 4841 4e44 4c45 2c0a 2020  shi * HANDLE,.  
│ │ │ │ -0000bf70: 2020 2020 2020 2020 5368 6973 6869 5f61          Shishi_a
│ │ │ │ -0000bf80: 736e 3120 4b44 4352 4551 2c20 696e 7433  sn1 KDCREQ, int3
│ │ │ │ -0000bf90: 325f 7420 2a20 4554 5950 452c 2069 6e74  2_t * ETYPE, int
│ │ │ │ -0000bfa0: 204e 4554 5950 4529 0a20 2020 2020 4841   NETYPE).     HA
│ │ │ │ -0000bfb0: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ -0000bfc0: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ -0000bfd0: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ -0000bfe0: 6974 2829 e280 992e 0a20 2020 2020 4b44  it().....     KD
│ │ │ │ -0000bff0: 4352 4551 3a20 4b44 432d 5245 5120 7661  CREQ: KDC-REQ va
│ │ │ │ -0000c000: 7269 6162 6c65 2074 6f20 7365 7420 6574  riable to set et
│ │ │ │ -0000c010: 7970 6520 6669 656c 6420 696e 2e0a 2020  ype field in..  
│ │ │ │ -0000c020: 2020 2045 5459 5045 3a20 696e 7075 7420     ETYPE: input 
│ │ │ │ -0000c030: 6172 7261 7920 7769 7468 2065 6e63 7279  array with encry
│ │ │ │ -0000c040: 7074 696f 6e20 7479 7065 732e 0a20 2020  ption types..   
│ │ │ │ -0000c050: 2020 4e45 5459 5045 3a20 6e75 6d62 6572    NETYPE: number
│ │ │ │ -0000c060: 206f 6620 656c 656d 656e 7473 2069 6e20   of elements in 
│ │ │ │ -0000c070: 696e 7075 7420 6172 7261 7920 7769 7468  input array with
│ │ │ │ -0000c080: 2065 6e63 7279 7074 696f 6e20 7479 7065   encryption type
│ │ │ │ -0000c090: 732e 0a0a 2020 2020 202a 4465 7363 7269  s...     *Descri
│ │ │ │ -0000c0a0: 7074 696f 6e3a 2a20 5365 7420 7468 6520  ption:* Set the 
│ │ │ │ -0000c0b0: 6c69 7374 206f 6620 7375 7070 6f72 7465  list of supporte
│ │ │ │ -0000c0c0: 6420 6f72 2077 616e 7465 6420 656e 6372  d or wanted encr
│ │ │ │ -0000c0d0: 7970 7469 6f6e 2074 7970 6573 0a20 2020  yption types.   
│ │ │ │ -0000c0e0: 2020 696e 2074 6865 2072 6571 7565 7374    in the request
│ │ │ │ -0000c0f0: 2e20 2054 6865 206c 6973 7420 7368 6f75  .  The list shou
│ │ │ │ -0000c100: 6c64 2062 6520 736f 7274 6564 2069 6e20  ld be sorted in 
│ │ │ │ -0000c110: 7072 696f 7269 7479 206f 7264 6572 2e0a  priority order..
│ │ │ │ -0000c120: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ -0000c130: 6c75 653a 2a20 5265 7475 726e 7320 5348  lue:* Returns SH
│ │ │ │ -0000c140: 4953 4849 5f4f 4b20 6966 6620 7375 6363  ISHI_OK iff succ
│ │ │ │ -0000c150: 6573 7366 756c 2e0a 0a73 6869 7368 695f  essful...shishi_
│ │ │ │ -0000c160: 6b64 6372 6571 5f6f 7074 696f 6e73 0a2d  kdcreq_options.-
│ │ │ │ +0000bf30: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ +0000bf40: 2069 6e74 2073 6869 7368 695f 6b64 6372   int shishi_kdcr
│ │ │ │ +0000bf50: 6571 5f73 6574 5f65 7479 7065 2028 5368  eq_set_etype (Sh
│ │ │ │ +0000bf60: 6973 6869 202a 2048 414e 444c 452c 0a20  ishi * HANDLE,. 
│ │ │ │ +0000bf70: 2020 2020 2020 2020 2053 6869 7368 695f           Shishi_
│ │ │ │ +0000bf80: 6173 6e31 204b 4443 5245 512c 2069 6e74  asn1 KDCREQ, int
│ │ │ │ +0000bf90: 3332 5f74 202a 2045 5459 5045 2c20 696e  32_t * ETYPE, in
│ │ │ │ +0000bfa0: 7420 4e45 5459 5045 290a 2020 2020 2048  t NETYPE).     H
│ │ │ │ +0000bfb0: 414e 444c 453a 2073 6869 7368 6920 6861  ANDLE: shishi ha
│ │ │ │ +0000bfc0: 6e64 6c65 2061 7320 616c 6c6f 6361 7465  ndle as allocate
│ │ │ │ +0000bfd0: 6420 6279 20e2 8098 7368 6973 6869 5f69  d by ...shishi_i
│ │ │ │ +0000bfe0: 6e69 7428 29e2 8099 2e0a 2020 2020 204b  nit().....     K
│ │ │ │ +0000bff0: 4443 5245 513a 204b 4443 2d52 4551 2076  DCREQ: KDC-REQ v
│ │ │ │ +0000c000: 6172 6961 626c 6520 746f 2073 6574 2065  ariable to set e
│ │ │ │ +0000c010: 7479 7065 2066 6965 6c64 2069 6e2e 0a20  type field in.. 
│ │ │ │ +0000c020: 2020 2020 4554 5950 453a 2069 6e70 7574      ETYPE: input
│ │ │ │ +0000c030: 2061 7272 6179 2077 6974 6820 656e 6372   array with encr
│ │ │ │ +0000c040: 7970 7469 6f6e 2074 7970 6573 2e0a 2020  yption types..  
│ │ │ │ +0000c050: 2020 204e 4554 5950 453a 206e 756d 6265     NETYPE: numbe
│ │ │ │ +0000c060: 7220 6f66 2065 6c65 6d65 6e74 7320 696e  r of elements in
│ │ │ │ +0000c070: 2069 6e70 7574 2061 7272 6179 2077 6974   input array wit
│ │ │ │ +0000c080: 6820 656e 6372 7970 7469 6f6e 2074 7970  h encryption typ
│ │ │ │ +0000c090: 6573 2e0a 0a20 2020 2020 2a44 6573 6372  es...     *Descr
│ │ │ │ +0000c0a0: 6970 7469 6f6e 3a2a 2053 6574 2074 6865  iption:* Set the
│ │ │ │ +0000c0b0: 206c 6973 7420 6f66 2073 7570 706f 7274   list of support
│ │ │ │ +0000c0c0: 6564 206f 7220 7761 6e74 6564 2065 6e63  ed or wanted enc
│ │ │ │ +0000c0d0: 7279 7074 696f 6e20 7479 7065 730a 2020  ryption types.  
│ │ │ │ +0000c0e0: 2020 2069 6e20 7468 6520 7265 7175 6573     in the reques
│ │ │ │ +0000c0f0: 742e 2020 5468 6520 6c69 7374 2073 686f  t.  The list sho
│ │ │ │ +0000c100: 756c 6420 6265 2073 6f72 7465 6420 696e  uld be sorted in
│ │ │ │ +0000c110: 2070 7269 6f72 6974 7920 6f72 6465 722e   priority order.
│ │ │ │ +0000c120: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ +0000c130: 616c 7565 3a2a 2052 6574 7572 6e73 2053  alue:* Returns S
│ │ │ │ +0000c140: 4849 5348 495f 4f4b 2069 6666 2073 7563  HISHI_OK iff suc
│ │ │ │ +0000c150: 6365 7373 6675 6c2e 0a0a 7368 6973 6869  cessful...shishi
│ │ │ │ +0000c160: 5f6b 6463 7265 715f 6f70 7469 6f6e 730a  _kdcreq_options.
│ │ │ │  0000c170: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0000c180: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -0000c190: 6f6e 3a20 696e 7420 7368 6973 6869 5f6b  on: int shishi_k
│ │ │ │ -0000c1a0: 6463 7265 715f 6f70 7469 6f6e 7320 2853  dcreq_options (S
│ │ │ │ -0000c1b0: 6869 7368 6920 2a20 4841 4e44 4c45 2c0a  hishi * HANDLE,.
│ │ │ │ -0000c1c0: 2020 2020 2020 2020 2020 5368 6973 6869            Shishi
│ │ │ │ -0000c1d0: 5f61 736e 3120 4b44 4352 4551 2c20 7569  _asn1 KDCREQ, ui
│ │ │ │ -0000c1e0: 6e74 3332 5f74 202a 2046 4c41 4753 290a  nt32_t * FLAGS).
│ │ │ │ -0000c1f0: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ -0000c200: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ -0000c210: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ -0000c220: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ -0000c230: 2020 2020 204b 4443 5245 513a 204b 4443       KDCREQ: KDC
│ │ │ │ -0000c240: 2d52 4551 2076 6172 6961 626c 6520 746f  -REQ variable to
│ │ │ │ -0000c250: 2067 6574 206b 6463 2d6f 7074 696f 6e73   get kdc-options
│ │ │ │ -0000c260: 2066 6965 6c64 2066 726f 6d2e 0a20 2020   field from..   
│ │ │ │ -0000c270: 2020 464c 4147 533a 2070 6f69 6e74 6572    FLAGS: pointer
│ │ │ │ -0000c280: 2074 6f20 6f75 7470 7574 2069 6e74 6567   to output integ
│ │ │ │ -0000c290: 6572 2077 6974 6820 666c 6167 732e 0a0a  er with flags...
│ │ │ │ -0000c2a0: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ -0000c2b0: 6e3a 2a20 4578 7472 6163 7420 4b44 432d  n:* Extract KDC-
│ │ │ │ -0000c2c0: 4f70 7469 6f6e 7320 6672 6f6d 204b 4443  Options from KDC
│ │ │ │ -0000c2d0: 2d52 4551 2e0a 0a20 2020 2020 2a52 6574  -REQ...     *Ret
│ │ │ │ -0000c2e0: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ -0000c2f0: 726e 7320 5348 4953 4849 5f4f 4b20 6966  rns SHISHI_OK if
│ │ │ │ -0000c300: 6620 7375 6363 6573 7366 756c 2e0a 0a73  f successful...s
│ │ │ │ -0000c310: 6869 7368 695f 6b64 6372 6571 5f66 6f72  hishi_kdcreq_for
│ │ │ │ -0000c320: 7761 7264 6162 6c65 5f70 0a2d 2d2d 2d2d  wardable_p.-----
│ │ │ │ +0000c180: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +0000c190: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ +0000c1a0: 6b64 6372 6571 5f6f 7074 696f 6e73 2028  kdcreq_options (
│ │ │ │ +0000c1b0: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ +0000c1c0: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ +0000c1d0: 695f 6173 6e31 204b 4443 5245 512c 2075  i_asn1 KDCREQ, u
│ │ │ │ +0000c1e0: 696e 7433 325f 7420 2a20 464c 4147 5329  int32_t * FLAGS)
│ │ │ │ +0000c1f0: 0a20 2020 2020 4841 4e44 4c45 3a20 7368  .     HANDLE: sh
│ │ │ │ +0000c200: 6973 6869 2068 616e 646c 6520 6173 2061  ishi handle as a
│ │ │ │ +0000c210: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ +0000c220: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ +0000c230: 0a20 2020 2020 4b44 4352 4551 3a20 4b44  .     KDCREQ: KD
│ │ │ │ +0000c240: 432d 5245 5120 7661 7269 6162 6c65 2074  C-REQ variable t
│ │ │ │ +0000c250: 6f20 6765 7420 6b64 632d 6f70 7469 6f6e  o get kdc-option
│ │ │ │ +0000c260: 7320 6669 656c 6420 6672 6f6d 2e0a 2020  s field from..  
│ │ │ │ +0000c270: 2020 2046 4c41 4753 3a20 706f 696e 7465     FLAGS: pointe
│ │ │ │ +0000c280: 7220 746f 206f 7574 7075 7420 696e 7465  r to output inte
│ │ │ │ +0000c290: 6765 7220 7769 7468 2066 6c61 6773 2e0a  ger with flags..
│ │ │ │ +0000c2a0: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +0000c2b0: 6f6e 3a2a 2045 7874 7261 6374 204b 4443  on:* Extract KDC
│ │ │ │ +0000c2c0: 2d4f 7074 696f 6e73 2066 726f 6d20 4b44  -Options from KD
│ │ │ │ +0000c2d0: 432d 5245 512e 0a0a 2020 2020 202a 5265  C-REQ...     *Re
│ │ │ │ +0000c2e0: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ +0000c2f0: 7572 6e73 2053 4849 5348 495f 4f4b 2069  urns SHISHI_OK i
│ │ │ │ +0000c300: 6666 2073 7563 6365 7373 6675 6c2e 0a0a  ff successful...
│ │ │ │ +0000c310: 7368 6973 6869 5f6b 6463 7265 715f 666f  shishi_kdcreq_fo
│ │ │ │ +0000c320: 7277 6172 6461 626c 655f 700a 2d2d 2d2d  rwardable_p.----
│ │ │ │  0000c330: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0000c340: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ -0000c350: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ -0000c360: 5f6b 6463 7265 715f 666f 7277 6172 6461  _kdcreq_forwarda
│ │ │ │ -0000c370: 626c 655f 7020 2853 6869 7368 6920 2a20  ble_p (Shishi * 
│ │ │ │ -0000c380: 4841 4e44 4c45 2c0a 2020 2020 2020 2020  HANDLE,.        
│ │ │ │ -0000c390: 2020 5368 6973 6869 5f61 736e 3120 4b44    Shishi_asn1 KD
│ │ │ │ -0000c3a0: 4352 4551 290a 2020 2020 2048 414e 444c  CREQ).     HANDL
│ │ │ │ -0000c3b0: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ -0000c3c0: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ -0000c3d0: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ -0000c3e0: 29e2 8099 2e0a 2020 2020 204b 4443 5245  ).....     KDCRE
│ │ │ │ -0000c3f0: 513a 204b 4443 2d52 4551 2076 6172 6961  Q: KDC-REQ varia
│ │ │ │ -0000c400: 626c 6520 746f 2067 6574 206b 6463 2d6f  ble to get kdc-o
│ │ │ │ -0000c410: 7074 696f 6e73 2066 6965 6c64 2066 726f  ptions field fro
│ │ │ │ -0000c420: 6d2e 0a0a 2020 2020 202a 4465 7363 7269  m...     *Descri
│ │ │ │ -0000c430: 7074 696f 6e3a 2a20 4465 7465 726d 696e  ption:* Determin
│ │ │ │ -0000c440: 6520 6966 204b 4443 2d4f 7074 696f 6e20  e if KDC-Option 
│ │ │ │ -0000c450: 666f 7277 6172 6461 626c 6520 666c 6167  forwardable flag
│ │ │ │ -0000c460: 2069 7320 7365 742e 0a0a 2020 2020 2054   is set...     T
│ │ │ │ -0000c470: 6865 2046 4f52 5741 5244 4142 4c45 206f  he FORWARDABLE o
│ │ │ │ -0000c480: 7074 696f 6e20 696e 6469 6361 7465 7320  ption indicates 
│ │ │ │ -0000c490: 7468 6174 2074 6865 2074 6963 6b65 7420  that the ticket 
│ │ │ │ -0000c4a0: 746f 2062 6520 6973 7375 6564 2069 7320  to be issued is 
│ │ │ │ -0000c4b0: 746f 0a20 2020 2020 6861 7665 2069 7473  to.     have its
│ │ │ │ -0000c4c0: 2066 6f72 7761 7264 6162 6c65 2066 6c61   forwardable fla
│ │ │ │ -0000c4d0: 6720 7365 742e 2020 4974 206d 6179 206f  g set.  It may o
│ │ │ │ -0000c4e0: 6e6c 7920 6265 2073 6574 206f 6e20 7468  nly be set on th
│ │ │ │ -0000c4f0: 6520 696e 6974 6961 6c0a 2020 2020 2072  e initial.     r
│ │ │ │ -0000c500: 6571 7565 7374 2c20 6f72 2069 6e20 6120  equest, or in a 
│ │ │ │ -0000c510: 7375 6273 6571 7565 6e74 2072 6571 7565  subsequent reque
│ │ │ │ -0000c520: 7374 2069 6620 7468 6520 7469 636b 6574  st if the ticket
│ │ │ │ -0000c530: 2d67 7261 6e74 696e 6720 7469 636b 6574  -granting ticket
│ │ │ │ -0000c540: 0a20 2020 2020 6f6e 2077 6869 6368 2069  .     on which i
│ │ │ │ -0000c550: 7420 6973 2062 6173 6564 2069 7320 616c  t is based is al
│ │ │ │ -0000c560: 736f 2066 6f72 7761 7264 6162 6c65 2e0a  so forwardable..
│ │ │ │ -0000c570: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ -0000c580: 6c75 653a 2a20 5265 7475 726e 7320 6e6f  lue:* Returns no
│ │ │ │ -0000c590: 6e2d 3020 6966 6620 666f 7277 6172 6461  n-0 iff forwarda
│ │ │ │ -0000c5a0: 626c 6520 666c 6167 2069 7320 7365 7420  ble flag is set 
│ │ │ │ -0000c5b0: 696e 0a20 2020 2020 4b44 432d 5245 512e  in.     KDC-REQ.
│ │ │ │ -0000c5c0: 0a0a 7368 6973 6869 5f6b 6463 7265 715f  ..shishi_kdcreq_
│ │ │ │ -0000c5d0: 666f 7277 6172 6465 645f 700a 2d2d 2d2d  forwarded_p.----
│ │ │ │ +0000c340: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +0000c350: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ +0000c360: 695f 6b64 6372 6571 5f66 6f72 7761 7264  i_kdcreq_forward
│ │ │ │ +0000c370: 6162 6c65 5f70 2028 5368 6973 6869 202a  able_p (Shishi *
│ │ │ │ +0000c380: 2048 414e 444c 452c 0a20 2020 2020 2020   HANDLE,.       
│ │ │ │ +0000c390: 2020 2053 6869 7368 695f 6173 6e31 204b     Shishi_asn1 K
│ │ │ │ +0000c3a0: 4443 5245 5129 0a20 2020 2020 4841 4e44  DCREQ).     HAND
│ │ │ │ +0000c3b0: 4c45 3a20 7368 6973 6869 2068 616e 646c  LE: shishi handl
│ │ │ │ +0000c3c0: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ +0000c3d0: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ +0000c3e0: 2829 e280 992e 0a20 2020 2020 4b44 4352  ().....     KDCR
│ │ │ │ +0000c3f0: 4551 3a20 4b44 432d 5245 5120 7661 7269  EQ: KDC-REQ vari
│ │ │ │ +0000c400: 6162 6c65 2074 6f20 6765 7420 6b64 632d  able to get kdc-
│ │ │ │ +0000c410: 6f70 7469 6f6e 7320 6669 656c 6420 6672  options field fr
│ │ │ │ +0000c420: 6f6d 2e0a 0a20 2020 2020 2a44 6573 6372  om...     *Descr
│ │ │ │ +0000c430: 6970 7469 6f6e 3a2a 2044 6574 6572 6d69  iption:* Determi
│ │ │ │ +0000c440: 6e65 2069 6620 4b44 432d 4f70 7469 6f6e  ne if KDC-Option
│ │ │ │ +0000c450: 2066 6f72 7761 7264 6162 6c65 2066 6c61   forwardable fla
│ │ │ │ +0000c460: 6720 6973 2073 6574 2e0a 0a20 2020 2020  g is set...     
│ │ │ │ +0000c470: 5468 6520 464f 5257 4152 4441 424c 4520  The FORWARDABLE 
│ │ │ │ +0000c480: 6f70 7469 6f6e 2069 6e64 6963 6174 6573  option indicates
│ │ │ │ +0000c490: 2074 6861 7420 7468 6520 7469 636b 6574   that the ticket
│ │ │ │ +0000c4a0: 2074 6f20 6265 2069 7373 7565 6420 6973   to be issued is
│ │ │ │ +0000c4b0: 2074 6f0a 2020 2020 2068 6176 6520 6974   to.     have it
│ │ │ │ +0000c4c0: 7320 666f 7277 6172 6461 626c 6520 666c  s forwardable fl
│ │ │ │ +0000c4d0: 6167 2073 6574 2e20 2049 7420 6d61 7920  ag set.  It may 
│ │ │ │ +0000c4e0: 6f6e 6c79 2062 6520 7365 7420 6f6e 2074  only be set on t
│ │ │ │ +0000c4f0: 6865 2069 6e69 7469 616c 0a20 2020 2020  he initial.     
│ │ │ │ +0000c500: 7265 7175 6573 742c 206f 7220 696e 2061  request, or in a
│ │ │ │ +0000c510: 2073 7562 7365 7175 656e 7420 7265 7175   subsequent requ
│ │ │ │ +0000c520: 6573 7420 6966 2074 6865 2074 6963 6b65  est if the ticke
│ │ │ │ +0000c530: 742d 6772 616e 7469 6e67 2074 6963 6b65  t-granting ticke
│ │ │ │ +0000c540: 740a 2020 2020 206f 6e20 7768 6963 6820  t.     on which 
│ │ │ │ +0000c550: 6974 2069 7320 6261 7365 6420 6973 2061  it is based is a
│ │ │ │ +0000c560: 6c73 6f20 666f 7277 6172 6461 626c 652e  lso forwardable.
│ │ │ │ +0000c570: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ +0000c580: 616c 7565 3a2a 2052 6574 7572 6e73 206e  alue:* Returns n
│ │ │ │ +0000c590: 6f6e 2d30 2069 6666 2066 6f72 7761 7264  on-0 iff forward
│ │ │ │ +0000c5a0: 6162 6c65 2066 6c61 6720 6973 2073 6574  able flag is set
│ │ │ │ +0000c5b0: 2069 6e0a 2020 2020 204b 4443 2d52 4551   in.     KDC-REQ
│ │ │ │ +0000c5c0: 2e0a 0a73 6869 7368 695f 6b64 6372 6571  ...shishi_kdcreq
│ │ │ │ +0000c5d0: 5f66 6f72 7761 7264 6564 5f70 0a2d 2d2d  _forwarded_p.---
│ │ │ │  0000c5e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0000c5f0: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ -0000c600: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ -0000c610: 6b64 6372 6571 5f66 6f72 7761 7264 6564  kdcreq_forwarded
│ │ │ │ -0000c620: 5f70 2028 5368 6973 6869 202a 2048 414e  _p (Shishi * HAN
│ │ │ │ -0000c630: 444c 452c 0a20 2020 2020 2020 2020 2053  DLE,.          S
│ │ │ │ -0000c640: 6869 7368 695f 6173 6e31 204b 4443 5245  hishi_asn1 KDCRE
│ │ │ │ -0000c650: 5129 0a20 2020 2020 4841 4e44 4c45 3a20  Q).     HANDLE: 
│ │ │ │ -0000c660: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ -0000c670: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ -0000c680: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ -0000c690: 992e 0a20 2020 2020 4b44 4352 4551 3a20  ...     KDCREQ: 
│ │ │ │ -0000c6a0: 4b44 432d 5245 5120 7661 7269 6162 6c65  KDC-REQ variable
│ │ │ │ -0000c6b0: 2074 6f20 6765 7420 6b64 632d 6f70 7469   to get kdc-opti
│ │ │ │ -0000c6c0: 6f6e 7320 6669 656c 6420 6672 6f6d 2e0a  ons field from..
│ │ │ │ -0000c6d0: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -0000c6e0: 6f6e 3a2a 2044 6574 6572 6d69 6e65 2069  on:* Determine i
│ │ │ │ -0000c6f0: 6620 4b44 432d 4f70 7469 6f6e 2066 6f72  f KDC-Option for
│ │ │ │ -0000c700: 7761 7264 6564 2066 6c61 6720 6973 2073  warded flag is s
│ │ │ │ -0000c710: 6574 2e0a 0a20 2020 2020 5468 6520 464f  et...     The FO
│ │ │ │ -0000c720: 5257 4152 4445 4420 6f70 7469 6f6e 2069  RWARDED option i
│ │ │ │ -0000c730: 7320 6f6e 6c79 2073 7065 6369 6669 6564  s only specified
│ │ │ │ -0000c740: 2069 6e20 6120 7265 7175 6573 7420 746f   in a request to
│ │ │ │ -0000c750: 2074 6865 0a20 2020 2020 7469 636b 6574   the.     ticket
│ │ │ │ -0000c760: 2d67 7261 6e74 696e 6720 7365 7276 6572  -granting server
│ │ │ │ -0000c770: 2061 6e64 2077 696c 6c20 6f6e 6c79 2062   and will only b
│ │ │ │ -0000c780: 6520 686f 6e6f 7265 6420 6966 2074 6865  e honored if the
│ │ │ │ -0000c790: 0a20 2020 2020 7469 636b 6574 2d67 7261  .     ticket-gra
│ │ │ │ -0000c7a0: 6e74 696e 6720 7469 636b 6574 2069 6e20  nting ticket in 
│ │ │ │ -0000c7b0: 7468 6520 7265 7175 6573 7420 6861 7320  the request has 
│ │ │ │ -0000c7c0: 6974 7320 464f 5257 4152 4441 424c 4520  its FORWARDABLE 
│ │ │ │ -0000c7d0: 6269 7420 7365 742e 0a20 2020 2020 5468  bit set..     Th
│ │ │ │ -0000c7e0: 6973 206f 7074 696f 6e20 696e 6469 6361  is option indica
│ │ │ │ -0000c7f0: 7465 7320 7468 6174 2074 6869 7320 6973  tes that this is
│ │ │ │ -0000c800: 2061 2072 6571 7565 7374 2066 6f72 2066   a request for f
│ │ │ │ -0000c810: 6f72 7761 7264 696e 672e 2020 5468 650a  orwarding.  The.
│ │ │ │ -0000c820: 2020 2020 2061 6464 7265 7373 2865 7329       address(es)
│ │ │ │ -0000c830: 206f 6620 7468 6520 686f 7374 2066 726f   of the host fro
│ │ │ │ -0000c840: 6d20 7768 6963 6820 7468 6520 7265 7375  m which the resu
│ │ │ │ -0000c850: 6c74 696e 6720 7469 636b 6574 2069 7320  lting ticket is 
│ │ │ │ -0000c860: 746f 2062 650a 2020 2020 2076 616c 6964  to be.     valid
│ │ │ │ -0000c870: 2061 7265 2069 6e63 6c75 6465 6420 696e   are included in
│ │ │ │ -0000c880: 2074 6865 2061 6464 7265 7373 6573 2066   the addresses f
│ │ │ │ -0000c890: 6965 6c64 206f 6620 7468 6520 7265 7175  ield of the requ
│ │ │ │ -0000c8a0: 6573 742e 0a0a 2020 2020 202a 5265 7475  est...     *Retu
│ │ │ │ -0000c8b0: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ -0000c8c0: 6e73 206e 6f6e 2d30 2069 6666 2066 6f72  ns non-0 iff for
│ │ │ │ -0000c8d0: 7761 7264 6564 2066 6c61 6720 6973 2073  warded flag is s
│ │ │ │ -0000c8e0: 6574 2069 6e20 4b44 432d 5245 512e 0a0a  et in KDC-REQ...
│ │ │ │ -0000c8f0: 7368 6973 6869 5f6b 6463 7265 715f 7072  shishi_kdcreq_pr
│ │ │ │ -0000c900: 6f78 6961 626c 655f 700a 2d2d 2d2d 2d2d  oxiable_p.------
│ │ │ │ +0000c5f0: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ +0000c600: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ +0000c610: 5f6b 6463 7265 715f 666f 7277 6172 6465  _kdcreq_forwarde
│ │ │ │ +0000c620: 645f 7020 2853 6869 7368 6920 2a20 4841  d_p (Shishi * HA
│ │ │ │ +0000c630: 4e44 4c45 2c0a 2020 2020 2020 2020 2020  NDLE,.          
│ │ │ │ +0000c640: 5368 6973 6869 5f61 736e 3120 4b44 4352  Shishi_asn1 KDCR
│ │ │ │ +0000c650: 4551 290a 2020 2020 2048 414e 444c 453a  EQ).     HANDLE:
│ │ │ │ +0000c660: 2073 6869 7368 6920 6861 6e64 6c65 2061   shishi handle a
│ │ │ │ +0000c670: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ +0000c680: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ +0000c690: 8099 2e0a 2020 2020 204b 4443 5245 513a  ....     KDCREQ:
│ │ │ │ +0000c6a0: 204b 4443 2d52 4551 2076 6172 6961 626c   KDC-REQ variabl
│ │ │ │ +0000c6b0: 6520 746f 2067 6574 206b 6463 2d6f 7074  e to get kdc-opt
│ │ │ │ +0000c6c0: 696f 6e73 2066 6965 6c64 2066 726f 6d2e  ions field from.
│ │ │ │ +0000c6d0: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ +0000c6e0: 696f 6e3a 2a20 4465 7465 726d 696e 6520  ion:* Determine 
│ │ │ │ +0000c6f0: 6966 204b 4443 2d4f 7074 696f 6e20 666f  if KDC-Option fo
│ │ │ │ +0000c700: 7277 6172 6465 6420 666c 6167 2069 7320  rwarded flag is 
│ │ │ │ +0000c710: 7365 742e 0a0a 2020 2020 2054 6865 2046  set...     The F
│ │ │ │ +0000c720: 4f52 5741 5244 4544 206f 7074 696f 6e20  ORWARDED option 
│ │ │ │ +0000c730: 6973 206f 6e6c 7920 7370 6563 6966 6965  is only specifie
│ │ │ │ +0000c740: 6420 696e 2061 2072 6571 7565 7374 2074  d in a request t
│ │ │ │ +0000c750: 6f20 7468 650a 2020 2020 2074 6963 6b65  o the.     ticke
│ │ │ │ +0000c760: 742d 6772 616e 7469 6e67 2073 6572 7665  t-granting serve
│ │ │ │ +0000c770: 7220 616e 6420 7769 6c6c 206f 6e6c 7920  r and will only 
│ │ │ │ +0000c780: 6265 2068 6f6e 6f72 6564 2069 6620 7468  be honored if th
│ │ │ │ +0000c790: 650a 2020 2020 2074 6963 6b65 742d 6772  e.     ticket-gr
│ │ │ │ +0000c7a0: 616e 7469 6e67 2074 6963 6b65 7420 696e  anting ticket in
│ │ │ │ +0000c7b0: 2074 6865 2072 6571 7565 7374 2068 6173   the request has
│ │ │ │ +0000c7c0: 2069 7473 2046 4f52 5741 5244 4142 4c45   its FORWARDABLE
│ │ │ │ +0000c7d0: 2062 6974 2073 6574 2e0a 2020 2020 2054   bit set..     T
│ │ │ │ +0000c7e0: 6869 7320 6f70 7469 6f6e 2069 6e64 6963  his option indic
│ │ │ │ +0000c7f0: 6174 6573 2074 6861 7420 7468 6973 2069  ates that this i
│ │ │ │ +0000c800: 7320 6120 7265 7175 6573 7420 666f 7220  s a request for 
│ │ │ │ +0000c810: 666f 7277 6172 6469 6e67 2e20 2054 6865  forwarding.  The
│ │ │ │ +0000c820: 0a20 2020 2020 6164 6472 6573 7328 6573  .     address(es
│ │ │ │ +0000c830: 2920 6f66 2074 6865 2068 6f73 7420 6672  ) of the host fr
│ │ │ │ +0000c840: 6f6d 2077 6869 6368 2074 6865 2072 6573  om which the res
│ │ │ │ +0000c850: 756c 7469 6e67 2074 6963 6b65 7420 6973  ulting ticket is
│ │ │ │ +0000c860: 2074 6f20 6265 0a20 2020 2020 7661 6c69   to be.     vali
│ │ │ │ +0000c870: 6420 6172 6520 696e 636c 7564 6564 2069  d are included i
│ │ │ │ +0000c880: 6e20 7468 6520 6164 6472 6573 7365 7320  n the addresses 
│ │ │ │ +0000c890: 6669 656c 6420 6f66 2074 6865 2072 6571  field of the req
│ │ │ │ +0000c8a0: 7565 7374 2e0a 0a20 2020 2020 2a52 6574  uest...     *Ret
│ │ │ │ +0000c8b0: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ +0000c8c0: 726e 7320 6e6f 6e2d 3020 6966 6620 666f  rns non-0 iff fo
│ │ │ │ +0000c8d0: 7277 6172 6465 6420 666c 6167 2069 7320  rwarded flag is 
│ │ │ │ +0000c8e0: 7365 7420 696e 204b 4443 2d52 4551 2e0a  set in KDC-REQ..
│ │ │ │ +0000c8f0: 0a73 6869 7368 695f 6b64 6372 6571 5f70  .shishi_kdcreq_p
│ │ │ │ +0000c900: 726f 7869 6162 6c65 5f70 0a2d 2d2d 2d2d  roxiable_p.-----
│ │ │ │  0000c910: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0000c920: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ -0000c930: 6e3a 2069 6e74 2073 6869 7368 695f 6b64  n: int shishi_kd
│ │ │ │ -0000c940: 6372 6571 5f70 726f 7869 6162 6c65 5f70  creq_proxiable_p
│ │ │ │ -0000c950: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ -0000c960: 452c 0a20 2020 2020 2020 2020 2053 6869  E,.          Shi
│ │ │ │ -0000c970: 7368 695f 6173 6e31 204b 4443 5245 5129  shi_asn1 KDCREQ)
│ │ │ │ -0000c980: 0a20 2020 2020 4841 4e44 4c45 3a20 7368  .     HANDLE: sh
│ │ │ │ -0000c990: 6973 6869 2068 616e 646c 6520 6173 2061  ishi handle as a
│ │ │ │ -0000c9a0: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ -0000c9b0: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ -0000c9c0: 0a20 2020 2020 4b44 4352 4551 3a20 4b44  .     KDCREQ: KD
│ │ │ │ -0000c9d0: 432d 5245 5120 7661 7269 6162 6c65 2074  C-REQ variable t
│ │ │ │ -0000c9e0: 6f20 6765 7420 6b64 632d 6f70 7469 6f6e  o get kdc-option
│ │ │ │ -0000c9f0: 7320 6669 656c 6420 6672 6f6d 2e0a 0a20  s field from... 
│ │ │ │ -0000ca00: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -0000ca10: 3a2a 2044 6574 6572 6d69 6e65 2069 6620  :* Determine if 
│ │ │ │ -0000ca20: 4b44 432d 4f70 7469 6f6e 2070 726f 7869  KDC-Option proxi
│ │ │ │ -0000ca30: 6162 6c65 2066 6c61 6720 6973 2073 6574  able flag is set
│ │ │ │ -0000ca40: 2e0a 0a20 2020 2020 5468 6520 5052 4f58  ...     The PROX
│ │ │ │ -0000ca50: 4941 424c 4520 6f70 7469 6f6e 2069 6e64  IABLE option ind
│ │ │ │ -0000ca60: 6963 6174 6573 2074 6861 7420 7468 6520  icates that the 
│ │ │ │ -0000ca70: 7469 636b 6574 2074 6f20 6265 2069 7373  ticket to be iss
│ │ │ │ -0000ca80: 7565 6420 6973 2074 6f0a 2020 2020 2068  ued is to.     h
│ │ │ │ -0000ca90: 6176 6520 6974 7320 7072 6f78 6961 626c  ave its proxiabl
│ │ │ │ -0000caa0: 6520 666c 6167 2073 6574 2e20 2049 7420  e flag set.  It 
│ │ │ │ -0000cab0: 6d61 7920 6f6e 6c79 2062 6520 7365 7420  may only be set 
│ │ │ │ -0000cac0: 6f6e 2074 6865 2069 6e69 7469 616c 0a20  on the initial. 
│ │ │ │ -0000cad0: 2020 2020 7265 7175 6573 742c 206f 7220      request, or 
│ │ │ │ -0000cae0: 696e 2061 2073 7562 7365 7175 656e 7420  in a subsequent 
│ │ │ │ -0000caf0: 7265 7175 6573 7420 6966 2074 6865 2074  request if the t
│ │ │ │ -0000cb00: 6963 6b65 742d 6772 616e 7469 6e67 2074  icket-granting t
│ │ │ │ -0000cb10: 6963 6b65 740a 2020 2020 206f 6e20 7768  icket.     on wh
│ │ │ │ -0000cb20: 6963 6820 6974 2069 7320 6261 7365 6420  ich it is based 
│ │ │ │ -0000cb30: 6973 2061 6c73 6f20 7072 6f78 6961 626c  is also proxiabl
│ │ │ │ -0000cb40: 652e 0a0a 2020 2020 202a 5265 7475 726e  e...     *Return
│ │ │ │ -0000cb50: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ -0000cb60: 206e 6f6e 2d30 2069 6666 2070 726f 7869   non-0 iff proxi
│ │ │ │ -0000cb70: 6162 6c65 2066 6c61 6720 6973 2073 6574  able flag is set
│ │ │ │ -0000cb80: 2069 6e20 4b44 432d 5245 512e 0a0a 7368   in KDC-REQ...sh
│ │ │ │ -0000cb90: 6973 6869 5f6b 6463 7265 715f 7072 6f78  ishi_kdcreq_prox
│ │ │ │ -0000cba0: 795f 700a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  y_p.------------
│ │ │ │ -0000cbb0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ -0000cbc0: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ -0000cbd0: 7368 695f 6b64 6372 6571 5f70 726f 7879  shi_kdcreq_proxy
│ │ │ │ -0000cbe0: 5f70 2028 5368 6973 6869 202a 2048 414e  _p (Shishi * HAN
│ │ │ │ -0000cbf0: 444c 452c 0a20 2020 2020 2020 2020 2053  DLE,.          S
│ │ │ │ -0000cc00: 6869 7368 695f 6173 6e31 204b 4443 5245  hishi_asn1 KDCRE
│ │ │ │ -0000cc10: 5129 0a20 2020 2020 4841 4e44 4c45 3a20  Q).     HANDLE: 
│ │ │ │ -0000cc20: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ -0000cc30: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ -0000cc40: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ -0000cc50: 992e 0a20 2020 2020 4b44 4352 4551 3a20  ...     KDCREQ: 
│ │ │ │ -0000cc60: 4b44 432d 5245 5120 7661 7269 6162 6c65  KDC-REQ variable
│ │ │ │ -0000cc70: 2074 6f20 6765 7420 6b64 632d 6f70 7469   to get kdc-opti
│ │ │ │ -0000cc80: 6f6e 7320 6669 656c 6420 6672 6f6d 2e0a  ons field from..
│ │ │ │ -0000cc90: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -0000cca0: 6f6e 3a2a 2044 6574 6572 6d69 6e65 2069  on:* Determine i
│ │ │ │ -0000ccb0: 6620 4b44 432d 4f70 7469 6f6e 2070 726f  f KDC-Option pro
│ │ │ │ -0000ccc0: 7879 2066 6c61 6720 6973 2073 6574 2e0a  xy flag is set..
│ │ │ │ -0000ccd0: 0a20 2020 2020 5468 6520 5052 4f58 5920  .     The PROXY 
│ │ │ │ -0000cce0: 6f70 7469 6f6e 2069 6e64 6963 6174 6573  option indicates
│ │ │ │ -0000ccf0: 2074 6861 7420 7468 6973 2069 7320 6120   that this is a 
│ │ │ │ -0000cd00: 7265 7175 6573 7420 666f 7220 6120 7072  request for a pr
│ │ │ │ -0000cd10: 6f78 792e 0a20 2020 2020 5468 6973 206f  oxy..     This o
│ │ │ │ -0000cd20: 7074 696f 6e20 7769 6c6c 206f 6e6c 7920  ption will only 
│ │ │ │ -0000cd30: 6265 2068 6f6e 6f72 6564 2069 6620 7468  be honored if th
│ │ │ │ -0000cd40: 6520 7469 636b 6574 2d67 7261 6e74 696e  e ticket-grantin
│ │ │ │ -0000cd50: 6720 7469 636b 6574 2069 6e0a 2020 2020  g ticket in.    
│ │ │ │ -0000cd60: 2074 6865 2072 6571 7565 7374 2068 6173   the request has
│ │ │ │ -0000cd70: 2069 7473 2050 524f 5849 4142 4c45 2062   its PROXIABLE b
│ │ │ │ -0000cd80: 6974 2073 6574 2e20 2054 6865 2061 6464  it set.  The add
│ │ │ │ -0000cd90: 7265 7373 2865 7329 206f 6620 7468 6520  ress(es) of the 
│ │ │ │ -0000cda0: 686f 7374 0a20 2020 2020 6672 6f6d 2077  host.     from w
│ │ │ │ -0000cdb0: 6869 6368 2074 6865 2072 6573 756c 7469  hich the resulti
│ │ │ │ -0000cdc0: 6e67 2074 6963 6b65 7420 6973 2074 6f20  ng ticket is to 
│ │ │ │ -0000cdd0: 6265 2076 616c 6964 2061 7265 2069 6e63  be valid are inc
│ │ │ │ -0000cde0: 6c75 6465 6420 696e 2074 6865 0a20 2020  luded in the.   
│ │ │ │ -0000cdf0: 2020 6164 6472 6573 7365 7320 6669 656c    addresses fiel
│ │ │ │ -0000ce00: 6420 6f66 2074 6865 2072 6571 7565 7374  d of the request
│ │ │ │ -0000ce10: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ -0000ce20: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ -0000ce30: 6e6f 6e2d 3020 6966 6620 7072 6f78 7920  non-0 iff proxy 
│ │ │ │ -0000ce40: 666c 6167 2069 7320 7365 7420 696e 204b  flag is set in K
│ │ │ │ -0000ce50: 4443 2d52 4551 2e0a 0a73 6869 7368 695f  DC-REQ...shishi_
│ │ │ │ -0000ce60: 6b64 6372 6571 5f61 6c6c 6f77 5f70 6f73  kdcreq_allow_pos
│ │ │ │ -0000ce70: 7464 6174 655f 700a 2d2d 2d2d 2d2d 2d2d  tdate_p.--------
│ │ │ │ +0000c920: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ +0000c930: 6f6e 3a20 696e 7420 7368 6973 6869 5f6b  on: int shishi_k
│ │ │ │ +0000c940: 6463 7265 715f 7072 6f78 6961 626c 655f  dcreq_proxiable_
│ │ │ │ +0000c950: 7020 2853 6869 7368 6920 2a20 4841 4e44  p (Shishi * HAND
│ │ │ │ +0000c960: 4c45 2c0a 2020 2020 2020 2020 2020 5368  LE,.          Sh
│ │ │ │ +0000c970: 6973 6869 5f61 736e 3120 4b44 4352 4551  ishi_asn1 KDCREQ
│ │ │ │ +0000c980: 290a 2020 2020 2048 414e 444c 453a 2073  ).     HANDLE: s
│ │ │ │ +0000c990: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ +0000c9a0: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ +0000c9b0: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ +0000c9c0: 2e0a 2020 2020 204b 4443 5245 513a 204b  ..     KDCREQ: K
│ │ │ │ +0000c9d0: 4443 2d52 4551 2076 6172 6961 626c 6520  DC-REQ variable 
│ │ │ │ +0000c9e0: 746f 2067 6574 206b 6463 2d6f 7074 696f  to get kdc-optio
│ │ │ │ +0000c9f0: 6e73 2066 6965 6c64 2066 726f 6d2e 0a0a  ns field from...
│ │ │ │ +0000ca00: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ +0000ca10: 6e3a 2a20 4465 7465 726d 696e 6520 6966  n:* Determine if
│ │ │ │ +0000ca20: 204b 4443 2d4f 7074 696f 6e20 7072 6f78   KDC-Option prox
│ │ │ │ +0000ca30: 6961 626c 6520 666c 6167 2069 7320 7365  iable flag is se
│ │ │ │ +0000ca40: 742e 0a0a 2020 2020 2054 6865 2050 524f  t...     The PRO
│ │ │ │ +0000ca50: 5849 4142 4c45 206f 7074 696f 6e20 696e  XIABLE option in
│ │ │ │ +0000ca60: 6469 6361 7465 7320 7468 6174 2074 6865  dicates that the
│ │ │ │ +0000ca70: 2074 6963 6b65 7420 746f 2062 6520 6973   ticket to be is
│ │ │ │ +0000ca80: 7375 6564 2069 7320 746f 0a20 2020 2020  sued is to.     
│ │ │ │ +0000ca90: 6861 7665 2069 7473 2070 726f 7869 6162  have its proxiab
│ │ │ │ +0000caa0: 6c65 2066 6c61 6720 7365 742e 2020 4974  le flag set.  It
│ │ │ │ +0000cab0: 206d 6179 206f 6e6c 7920 6265 2073 6574   may only be set
│ │ │ │ +0000cac0: 206f 6e20 7468 6520 696e 6974 6961 6c0a   on the initial.
│ │ │ │ +0000cad0: 2020 2020 2072 6571 7565 7374 2c20 6f72       request, or
│ │ │ │ +0000cae0: 2069 6e20 6120 7375 6273 6571 7565 6e74   in a subsequent
│ │ │ │ +0000caf0: 2072 6571 7565 7374 2069 6620 7468 6520   request if the 
│ │ │ │ +0000cb00: 7469 636b 6574 2d67 7261 6e74 696e 6720  ticket-granting 
│ │ │ │ +0000cb10: 7469 636b 6574 0a20 2020 2020 6f6e 2077  ticket.     on w
│ │ │ │ +0000cb20: 6869 6368 2069 7420 6973 2062 6173 6564  hich it is based
│ │ │ │ +0000cb30: 2069 7320 616c 736f 2070 726f 7869 6162   is also proxiab
│ │ │ │ +0000cb40: 6c65 2e0a 0a20 2020 2020 2a52 6574 7572  le...     *Retur
│ │ │ │ +0000cb50: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ +0000cb60: 7320 6e6f 6e2d 3020 6966 6620 7072 6f78  s non-0 iff prox
│ │ │ │ +0000cb70: 6961 626c 6520 666c 6167 2069 7320 7365  iable flag is se
│ │ │ │ +0000cb80: 7420 696e 204b 4443 2d52 4551 2e0a 0a73  t in KDC-REQ...s
│ │ │ │ +0000cb90: 6869 7368 695f 6b64 6372 6571 5f70 726f  hishi_kdcreq_pro
│ │ │ │ +0000cba0: 7879 5f70 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  xy_p.-----------
│ │ │ │ +0000cbb0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +0000cbc0: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ +0000cbd0: 6973 6869 5f6b 6463 7265 715f 7072 6f78  ishi_kdcreq_prox
│ │ │ │ +0000cbe0: 795f 7020 2853 6869 7368 6920 2a20 4841  y_p (Shishi * HA
│ │ │ │ +0000cbf0: 4e44 4c45 2c0a 2020 2020 2020 2020 2020  NDLE,.          
│ │ │ │ +0000cc00: 5368 6973 6869 5f61 736e 3120 4b44 4352  Shishi_asn1 KDCR
│ │ │ │ +0000cc10: 4551 290a 2020 2020 2048 414e 444c 453a  EQ).     HANDLE:
│ │ │ │ +0000cc20: 2073 6869 7368 6920 6861 6e64 6c65 2061   shishi handle a
│ │ │ │ +0000cc30: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ +0000cc40: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ +0000cc50: 8099 2e0a 2020 2020 204b 4443 5245 513a  ....     KDCREQ:
│ │ │ │ +0000cc60: 204b 4443 2d52 4551 2076 6172 6961 626c   KDC-REQ variabl
│ │ │ │ +0000cc70: 6520 746f 2067 6574 206b 6463 2d6f 7074  e to get kdc-opt
│ │ │ │ +0000cc80: 696f 6e73 2066 6965 6c64 2066 726f 6d2e  ions field from.
│ │ │ │ +0000cc90: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ +0000cca0: 696f 6e3a 2a20 4465 7465 726d 696e 6520  ion:* Determine 
│ │ │ │ +0000ccb0: 6966 204b 4443 2d4f 7074 696f 6e20 7072  if KDC-Option pr
│ │ │ │ +0000ccc0: 6f78 7920 666c 6167 2069 7320 7365 742e  oxy flag is set.
│ │ │ │ +0000ccd0: 0a0a 2020 2020 2054 6865 2050 524f 5859  ..     The PROXY
│ │ │ │ +0000cce0: 206f 7074 696f 6e20 696e 6469 6361 7465   option indicate
│ │ │ │ +0000ccf0: 7320 7468 6174 2074 6869 7320 6973 2061  s that this is a
│ │ │ │ +0000cd00: 2072 6571 7565 7374 2066 6f72 2061 2070   request for a p
│ │ │ │ +0000cd10: 726f 7879 2e0a 2020 2020 2054 6869 7320  roxy..     This 
│ │ │ │ +0000cd20: 6f70 7469 6f6e 2077 696c 6c20 6f6e 6c79  option will only
│ │ │ │ +0000cd30: 2062 6520 686f 6e6f 7265 6420 6966 2074   be honored if t
│ │ │ │ +0000cd40: 6865 2074 6963 6b65 742d 6772 616e 7469  he ticket-granti
│ │ │ │ +0000cd50: 6e67 2074 6963 6b65 7420 696e 0a20 2020  ng ticket in.   
│ │ │ │ +0000cd60: 2020 7468 6520 7265 7175 6573 7420 6861    the request ha
│ │ │ │ +0000cd70: 7320 6974 7320 5052 4f58 4941 424c 4520  s its PROXIABLE 
│ │ │ │ +0000cd80: 6269 7420 7365 742e 2020 5468 6520 6164  bit set.  The ad
│ │ │ │ +0000cd90: 6472 6573 7328 6573 2920 6f66 2074 6865  dress(es) of the
│ │ │ │ +0000cda0: 2068 6f73 740a 2020 2020 2066 726f 6d20   host.     from 
│ │ │ │ +0000cdb0: 7768 6963 6820 7468 6520 7265 7375 6c74  which the result
│ │ │ │ +0000cdc0: 696e 6720 7469 636b 6574 2069 7320 746f  ing ticket is to
│ │ │ │ +0000cdd0: 2062 6520 7661 6c69 6420 6172 6520 696e   be valid are in
│ │ │ │ +0000cde0: 636c 7564 6564 2069 6e20 7468 650a 2020  cluded in the.  
│ │ │ │ +0000cdf0: 2020 2061 6464 7265 7373 6573 2066 6965     addresses fie
│ │ │ │ +0000ce00: 6c64 206f 6620 7468 6520 7265 7175 6573  ld of the reques
│ │ │ │ +0000ce10: 742e 0a0a 2020 2020 202a 5265 7475 726e  t...     *Return
│ │ │ │ +0000ce20: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ +0000ce30: 206e 6f6e 2d30 2069 6666 2070 726f 7879   non-0 iff proxy
│ │ │ │ +0000ce40: 2066 6c61 6720 6973 2073 6574 2069 6e20   flag is set in 
│ │ │ │ +0000ce50: 4b44 432d 5245 512e 0a0a 7368 6973 6869  KDC-REQ...shishi
│ │ │ │ +0000ce60: 5f6b 6463 7265 715f 616c 6c6f 775f 706f  _kdcreq_allow_po
│ │ │ │ +0000ce70: 7374 6461 7465 5f70 0a2d 2d2d 2d2d 2d2d  stdate_p.-------
│ │ │ │  0000ce80: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0000ce90: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ -0000cea0: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ -0000ceb0: 5f6b 6463 7265 715f 616c 6c6f 775f 706f  _kdcreq_allow_po
│ │ │ │ -0000cec0: 7374 6461 7465 5f70 2028 5368 6973 6869  stdate_p (Shishi
│ │ │ │ -0000ced0: 202a 2048 414e 444c 452c 0a20 2020 2020   * HANDLE,.     
│ │ │ │ -0000cee0: 2020 2020 2053 6869 7368 695f 6173 6e31       Shishi_asn1
│ │ │ │ -0000cef0: 204b 4443 5245 5129 0a20 2020 2020 4841   KDCREQ).     HA
│ │ │ │ -0000cf00: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ -0000cf10: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ -0000cf20: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ -0000cf30: 6974 2829 e280 992e 0a20 2020 2020 4b44  it().....     KD
│ │ │ │ -0000cf40: 4352 4551 3a20 4b44 432d 5245 5120 7661  CREQ: KDC-REQ va
│ │ │ │ -0000cf50: 7269 6162 6c65 2074 6f20 6765 7420 6b64  riable to get kd
│ │ │ │ -0000cf60: 632d 6f70 7469 6f6e 7320 6669 656c 6420  c-options field 
│ │ │ │ -0000cf70: 6672 6f6d 2e0a 0a20 2020 2020 2a44 6573  from...     *Des
│ │ │ │ -0000cf80: 6372 6970 7469 6f6e 3a2a 2044 6574 6572  cription:* Deter
│ │ │ │ -0000cf90: 6d69 6e65 2069 6620 4b44 432d 4f70 7469  mine if KDC-Opti
│ │ │ │ -0000cfa0: 6f6e 2061 6c6c 6f77 2d70 6f73 7464 6174  on allow-postdat
│ │ │ │ -0000cfb0: 6520 666c 6167 2069 7320 7365 742e 0a0a  e flag is set...
│ │ │ │ -0000cfc0: 2020 2020 2054 6865 2041 4c4c 4f57 2d50       The ALLOW-P
│ │ │ │ -0000cfd0: 4f53 5444 4154 4520 6f70 7469 6f6e 2069  OSTDATE option i
│ │ │ │ -0000cfe0: 6e64 6963 6174 6573 2074 6861 7420 7468  ndicates that th
│ │ │ │ -0000cff0: 6520 7469 636b 6574 2074 6f20 6265 2069  e ticket to be i
│ │ │ │ -0000d000: 7373 7565 6420 6973 0a20 2020 2020 746f  ssued is.     to
│ │ │ │ -0000d010: 2068 6176 6520 6974 7320 4d41 592d 504f   have its MAY-PO
│ │ │ │ -0000d020: 5354 4441 5445 2066 6c61 6720 7365 742e  STDATE flag set.
│ │ │ │ -0000d030: 2020 4974 206d 6179 206f 6e6c 7920 6265    It may only be
│ │ │ │ -0000d040: 2073 6574 206f 6e20 7468 650a 2020 2020   set on the.    
│ │ │ │ -0000d050: 2069 6e69 7469 616c 2072 6571 7565 7374   initial request
│ │ │ │ -0000d060: 2c20 6f72 2069 6e20 6120 7375 6273 6571  , or in a subseq
│ │ │ │ -0000d070: 7565 6e74 2072 6571 7565 7374 2069 6620  uent request if 
│ │ │ │ -0000d080: 7468 6520 7469 636b 6574 2d67 7261 6e74  the ticket-grant
│ │ │ │ -0000d090: 696e 670a 2020 2020 2074 6963 6b65 7420  ing.     ticket 
│ │ │ │ -0000d0a0: 6f6e 2077 6869 6368 2069 7420 6973 2062  on which it is b
│ │ │ │ -0000d0b0: 6173 6564 2061 6c73 6f20 6861 7320 6974  ased also has it
│ │ │ │ -0000d0c0: 7320 4d41 592d 504f 5354 4441 5445 2066  s MAY-POSTDATE f
│ │ │ │ -0000d0d0: 6c61 6720 7365 742e 0a0a 2020 2020 202a  lag set...     *
│ │ │ │ -0000d0e0: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ -0000d0f0: 6574 7572 6e73 206e 6f6e 2d30 2069 6666  eturns non-0 iff
│ │ │ │ -0000d100: 2061 6c6c 6f77 2d70 6f73 7464 6174 6520   allow-postdate 
│ │ │ │ -0000d110: 666c 6167 2069 7320 7365 7420 696e 0a20  flag is set in. 
│ │ │ │ -0000d120: 2020 2020 4b44 432d 5245 512e 0a0a 7368      KDC-REQ...sh
│ │ │ │ -0000d130: 6973 6869 5f6b 6463 7265 715f 706f 7374  ishi_kdcreq_post
│ │ │ │ -0000d140: 6461 7465 645f 700a 2d2d 2d2d 2d2d 2d2d  dated_p.--------
│ │ │ │ +0000ce90: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +0000cea0: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ +0000ceb0: 695f 6b64 6372 6571 5f61 6c6c 6f77 5f70  i_kdcreq_allow_p
│ │ │ │ +0000cec0: 6f73 7464 6174 655f 7020 2853 6869 7368  ostdate_p (Shish
│ │ │ │ +0000ced0: 6920 2a20 4841 4e44 4c45 2c0a 2020 2020  i * HANDLE,.    
│ │ │ │ +0000cee0: 2020 2020 2020 5368 6973 6869 5f61 736e        Shishi_asn
│ │ │ │ +0000cef0: 3120 4b44 4352 4551 290a 2020 2020 2048  1 KDCREQ).     H
│ │ │ │ +0000cf00: 414e 444c 453a 2073 6869 7368 6920 6861  ANDLE: shishi ha
│ │ │ │ +0000cf10: 6e64 6c65 2061 7320 616c 6c6f 6361 7465  ndle as allocate
│ │ │ │ +0000cf20: 6420 6279 20e2 8098 7368 6973 6869 5f69  d by ...shishi_i
│ │ │ │ +0000cf30: 6e69 7428 29e2 8099 2e0a 2020 2020 204b  nit().....     K
│ │ │ │ +0000cf40: 4443 5245 513a 204b 4443 2d52 4551 2076  DCREQ: KDC-REQ v
│ │ │ │ +0000cf50: 6172 6961 626c 6520 746f 2067 6574 206b  ariable to get k
│ │ │ │ +0000cf60: 6463 2d6f 7074 696f 6e73 2066 6965 6c64  dc-options field
│ │ │ │ +0000cf70: 2066 726f 6d2e 0a0a 2020 2020 202a 4465   from...     *De
│ │ │ │ +0000cf80: 7363 7269 7074 696f 6e3a 2a20 4465 7465  scription:* Dete
│ │ │ │ +0000cf90: 726d 696e 6520 6966 204b 4443 2d4f 7074  rmine if KDC-Opt
│ │ │ │ +0000cfa0: 696f 6e20 616c 6c6f 772d 706f 7374 6461  ion allow-postda
│ │ │ │ +0000cfb0: 7465 2066 6c61 6720 6973 2073 6574 2e0a  te flag is set..
│ │ │ │ +0000cfc0: 0a20 2020 2020 5468 6520 414c 4c4f 572d  .     The ALLOW-
│ │ │ │ +0000cfd0: 504f 5354 4441 5445 206f 7074 696f 6e20  POSTDATE option 
│ │ │ │ +0000cfe0: 696e 6469 6361 7465 7320 7468 6174 2074  indicates that t
│ │ │ │ +0000cff0: 6865 2074 6963 6b65 7420 746f 2062 6520  he ticket to be 
│ │ │ │ +0000d000: 6973 7375 6564 2069 730a 2020 2020 2074  issued is.     t
│ │ │ │ +0000d010: 6f20 6861 7665 2069 7473 204d 4159 2d50  o have its MAY-P
│ │ │ │ +0000d020: 4f53 5444 4154 4520 666c 6167 2073 6574  OSTDATE flag set
│ │ │ │ +0000d030: 2e20 2049 7420 6d61 7920 6f6e 6c79 2062  .  It may only b
│ │ │ │ +0000d040: 6520 7365 7420 6f6e 2074 6865 0a20 2020  e set on the.   
│ │ │ │ +0000d050: 2020 696e 6974 6961 6c20 7265 7175 6573    initial reques
│ │ │ │ +0000d060: 742c 206f 7220 696e 2061 2073 7562 7365  t, or in a subse
│ │ │ │ +0000d070: 7175 656e 7420 7265 7175 6573 7420 6966  quent request if
│ │ │ │ +0000d080: 2074 6865 2074 6963 6b65 742d 6772 616e   the ticket-gran
│ │ │ │ +0000d090: 7469 6e67 0a20 2020 2020 7469 636b 6574  ting.     ticket
│ │ │ │ +0000d0a0: 206f 6e20 7768 6963 6820 6974 2069 7320   on which it is 
│ │ │ │ +0000d0b0: 6261 7365 6420 616c 736f 2068 6173 2069  based also has i
│ │ │ │ +0000d0c0: 7473 204d 4159 2d50 4f53 5444 4154 4520  ts MAY-POSTDATE 
│ │ │ │ +0000d0d0: 666c 6167 2073 6574 2e0a 0a20 2020 2020  flag set...     
│ │ │ │ +0000d0e0: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ +0000d0f0: 5265 7475 726e 7320 6e6f 6e2d 3020 6966  Returns non-0 if
│ │ │ │ +0000d100: 6620 616c 6c6f 772d 706f 7374 6461 7465  f allow-postdate
│ │ │ │ +0000d110: 2066 6c61 6720 6973 2073 6574 2069 6e0a   flag is set in.
│ │ │ │ +0000d120: 2020 2020 204b 4443 2d52 4551 2e0a 0a73       KDC-REQ...s
│ │ │ │ +0000d130: 6869 7368 695f 6b64 6372 6571 5f70 6f73  hishi_kdcreq_pos
│ │ │ │ +0000d140: 7464 6174 6564 5f70 0a2d 2d2d 2d2d 2d2d  tdated_p.-------
│ │ │ │  0000d150: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0000d160: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ -0000d170: 2069 6e74 2073 6869 7368 695f 6b64 6372   int shishi_kdcr
│ │ │ │ -0000d180: 6571 5f70 6f73 7464 6174 6564 5f70 2028  eq_postdated_p (
│ │ │ │ -0000d190: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ -0000d1a0: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ -0000d1b0: 695f 6173 6e31 204b 4443 5245 5129 0a20  i_asn1 KDCREQ). 
│ │ │ │ -0000d1c0: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ -0000d1d0: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ -0000d1e0: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ -0000d1f0: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ -0000d200: 2020 2020 4b44 4352 4551 3a20 4b44 432d      KDCREQ: KDC-
│ │ │ │ -0000d210: 5245 5120 7661 7269 6162 6c65 2074 6f20  REQ variable to 
│ │ │ │ -0000d220: 6765 7420 6b64 632d 6f70 7469 6f6e 7320  get kdc-options 
│ │ │ │ -0000d230: 6669 656c 6420 6672 6f6d 2e0a 0a20 2020  field from...   
│ │ │ │ -0000d240: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ -0000d250: 2044 6574 6572 6d69 6e65 2069 6620 4b44   Determine if KD
│ │ │ │ -0000d260: 432d 4f70 7469 6f6e 2070 6f73 7464 6174  C-Option postdat
│ │ │ │ -0000d270: 6564 2066 6c61 6720 6973 2073 6574 2e0a  ed flag is set..
│ │ │ │ -0000d280: 0a20 2020 2020 5468 6520 504f 5354 4441  .     The POSTDA
│ │ │ │ -0000d290: 5445 4420 6f70 7469 6f6e 2069 6e64 6963  TED option indic
│ │ │ │ -0000d2a0: 6174 6573 2074 6861 7420 7468 6973 2069  ates that this i
│ │ │ │ -0000d2b0: 7320 6120 7265 7175 6573 7420 666f 7220  s a request for 
│ │ │ │ -0000d2c0: 610a 2020 2020 2070 6f73 7464 6174 6564  a.     postdated
│ │ │ │ -0000d2d0: 2074 6963 6b65 742e 2020 5468 6973 206f   ticket.  This o
│ │ │ │ -0000d2e0: 7074 696f 6e20 7769 6c6c 206f 6e6c 7920  ption will only 
│ │ │ │ -0000d2f0: 6265 2068 6f6e 6f72 6564 2069 6620 7468  be honored if th
│ │ │ │ -0000d300: 650a 2020 2020 2074 6963 6b65 742d 6772  e.     ticket-gr
│ │ │ │ -0000d310: 616e 7469 6e67 2074 6963 6b65 7420 6f6e  anting ticket on
│ │ │ │ -0000d320: 2077 6869 6368 2069 7420 6973 2062 6173   which it is bas
│ │ │ │ -0000d330: 6564 2068 6173 2069 7473 204d 4159 2d50  ed has its MAY-P
│ │ │ │ -0000d340: 4f53 5444 4154 450a 2020 2020 2066 6c61  OSTDATE.     fla
│ │ │ │ -0000d350: 6720 7365 742e 2020 5468 6520 7265 7375  g set.  The resu
│ │ │ │ -0000d360: 6c74 696e 6720 7469 636b 6574 2077 696c  lting ticket wil
│ │ │ │ -0000d370: 6c20 616c 736f 2068 6176 6520 6974 7320  l also have its 
│ │ │ │ -0000d380: 494e 5641 4c49 4420 666c 6167 0a20 2020  INVALID flag.   
│ │ │ │ -0000d390: 2020 7365 742c 2061 6e64 2074 6861 7420    set, and that 
│ │ │ │ -0000d3a0: 666c 6167 206d 6179 2062 6520 7265 7365  flag may be rese
│ │ │ │ -0000d3b0: 7420 6279 2061 2073 7562 7365 7175 656e  t by a subsequen
│ │ │ │ -0000d3c0: 7420 7265 7175 6573 7420 746f 2074 6865  t request to the
│ │ │ │ -0000d3d0: 204b 4443 0a20 2020 2020 6166 7465 7220   KDC.     after 
│ │ │ │ -0000d3e0: 7468 6520 7374 6172 7474 696d 6520 696e  the starttime in
│ │ │ │ -0000d3f0: 2074 6865 2074 6963 6b65 7420 6861 7320   the ticket has 
│ │ │ │ -0000d400: 6265 656e 2072 6561 6368 6564 2e0a 0a20  been reached... 
│ │ │ │ -0000d410: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ -0000d420: 653a 2a20 5265 7475 726e 7320 6e6f 6e2d  e:* Returns non-
│ │ │ │ -0000d430: 3020 6966 6620 706f 7374 6461 7465 6420  0 iff postdated 
│ │ │ │ -0000d440: 666c 6167 2069 7320 7365 7420 696e 204b  flag is set in K
│ │ │ │ -0000d450: 4443 2d52 4551 2e0a 0a73 6869 7368 695f  DC-REQ...shishi_
│ │ │ │ -0000d460: 6b64 6372 6571 5f72 656e 6577 6162 6c65  kdcreq_renewable
│ │ │ │ -0000d470: 5f70 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  _p.-------------
│ │ │ │ -0000d480: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ -0000d490: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ -0000d4a0: 7368 6973 6869 5f6b 6463 7265 715f 7265  shishi_kdcreq_re
│ │ │ │ -0000d4b0: 6e65 7761 626c 655f 7020 2853 6869 7368  newable_p (Shish
│ │ │ │ -0000d4c0: 6920 2a20 4841 4e44 4c45 2c0a 2020 2020  i * HANDLE,.    
│ │ │ │ -0000d4d0: 2020 2020 2020 5368 6973 6869 5f61 736e        Shishi_asn
│ │ │ │ -0000d4e0: 3120 4b44 4352 4551 290a 2020 2020 2048  1 KDCREQ).     H
│ │ │ │ -0000d4f0: 414e 444c 453a 2073 6869 7368 6920 6861  ANDLE: shishi ha
│ │ │ │ -0000d500: 6e64 6c65 2061 7320 616c 6c6f 6361 7465  ndle as allocate
│ │ │ │ -0000d510: 6420 6279 20e2 8098 7368 6973 6869 5f69  d by ...shishi_i
│ │ │ │ -0000d520: 6e69 7428 29e2 8099 2e0a 2020 2020 204b  nit().....     K
│ │ │ │ -0000d530: 4443 5245 513a 204b 4443 2d52 4551 2076  DCREQ: KDC-REQ v
│ │ │ │ -0000d540: 6172 6961 626c 6520 746f 2067 6574 206b  ariable to get k
│ │ │ │ -0000d550: 6463 2d6f 7074 696f 6e73 2066 6965 6c64  dc-options field
│ │ │ │ -0000d560: 2066 726f 6d2e 0a0a 2020 2020 202a 4465   from...     *De
│ │ │ │ -0000d570: 7363 7269 7074 696f 6e3a 2a20 4465 7465  scription:* Dete
│ │ │ │ -0000d580: 726d 696e 6520 6966 204b 4443 2d4f 7074  rmine if KDC-Opt
│ │ │ │ -0000d590: 696f 6e20 7265 6e65 7761 626c 6520 666c  ion renewable fl
│ │ │ │ -0000d5a0: 6167 2069 7320 7365 742e 0a0a 2020 2020  ag is set...    
│ │ │ │ -0000d5b0: 2054 6865 2052 454e 4557 4142 4c45 206f   The RENEWABLE o
│ │ │ │ -0000d5c0: 7074 696f 6e20 696e 6469 6361 7465 7320  ption indicates 
│ │ │ │ -0000d5d0: 7468 6174 2074 6865 2074 6963 6b65 7420  that the ticket 
│ │ │ │ -0000d5e0: 746f 2062 6520 6973 7375 6564 2069 7320  to be issued is 
│ │ │ │ -0000d5f0: 746f 0a20 2020 2020 6861 7665 2069 7473  to.     have its
│ │ │ │ -0000d600: 2052 454e 4557 4142 4c45 2066 6c61 6720   RENEWABLE flag 
│ │ │ │ -0000d610: 7365 742e 2020 4974 206d 6179 206f 6e6c  set.  It may onl
│ │ │ │ -0000d620: 7920 6265 2073 6574 206f 6e20 7468 6520  y be set on the 
│ │ │ │ -0000d630: 696e 6974 6961 6c0a 2020 2020 2072 6571  initial.     req
│ │ │ │ -0000d640: 7565 7374 2c20 6f72 2077 6865 6e20 7468  uest, or when th
│ │ │ │ -0000d650: 6520 7469 636b 6574 2d67 7261 6e74 696e  e ticket-grantin
│ │ │ │ -0000d660: 6720 7469 636b 6574 206f 6e20 7768 6963  g ticket on whic
│ │ │ │ -0000d670: 6820 7468 6520 7265 7175 6573 7420 6973  h the request is
│ │ │ │ -0000d680: 0a20 2020 2020 6261 7365 6420 6973 2061  .     based is a
│ │ │ │ -0000d690: 6c73 6f20 7265 6e65 7761 626c 652e 2020  lso renewable.  
│ │ │ │ -0000d6a0: 4966 2074 6869 7320 6f70 7469 6f6e 2069  If this option i
│ │ │ │ -0000d6b0: 7320 7265 7175 6573 7465 642c 2074 6865  s requested, the
│ │ │ │ -0000d6c0: 6e20 7468 650a 2020 2020 2072 7469 6d65  n the.     rtime
│ │ │ │ -0000d6d0: 2066 6965 6c64 2069 6e20 7468 6520 7265   field in the re
│ │ │ │ -0000d6e0: 7175 6573 7420 636f 6e74 6169 6e73 2074  quest contains t
│ │ │ │ -0000d6f0: 6865 2064 6573 6972 6564 2061 6273 6f6c  he desired absol
│ │ │ │ -0000d700: 7574 6520 6578 7069 7261 7469 6f6e 0a20  ute expiration. 
│ │ │ │ -0000d710: 2020 2020 7469 6d65 2066 6f72 2074 6865      time for the
│ │ │ │ -0000d720: 2074 6963 6b65 742e 0a0a 2020 2020 202a   ticket...     *
│ │ │ │ -0000d730: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ -0000d740: 6574 7572 6e73 206e 6f6e 2d30 2069 6666  eturns non-0 iff
│ │ │ │ -0000d750: 2072 656e 6577 6162 6c65 2066 6c61 6720   renewable flag 
│ │ │ │ -0000d760: 6973 2073 6574 2069 6e20 4b44 432d 5245  is set in KDC-RE
│ │ │ │ -0000d770: 512e 0a0a 7368 6973 6869 5f6b 6463 7265  Q...shishi_kdcre
│ │ │ │ -0000d780: 715f 6469 7361 626c 655f 7472 616e 7369  q_disable_transi
│ │ │ │ -0000d790: 7465 645f 6368 6563 6b5f 700a 2d2d 2d2d  ted_check_p.----
│ │ │ │ +0000d160: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ +0000d170: 3a20 696e 7420 7368 6973 6869 5f6b 6463  : int shishi_kdc
│ │ │ │ +0000d180: 7265 715f 706f 7374 6461 7465 645f 7020  req_postdated_p 
│ │ │ │ +0000d190: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ +0000d1a0: 2c0a 2020 2020 2020 2020 2020 5368 6973  ,.          Shis
│ │ │ │ +0000d1b0: 6869 5f61 736e 3120 4b44 4352 4551 290a  hi_asn1 KDCREQ).
│ │ │ │ +0000d1c0: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ +0000d1d0: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ +0000d1e0: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ +0000d1f0: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ +0000d200: 2020 2020 204b 4443 5245 513a 204b 4443       KDCREQ: KDC
│ │ │ │ +0000d210: 2d52 4551 2076 6172 6961 626c 6520 746f  -REQ variable to
│ │ │ │ +0000d220: 2067 6574 206b 6463 2d6f 7074 696f 6e73   get kdc-options
│ │ │ │ +0000d230: 2066 6965 6c64 2066 726f 6d2e 0a0a 2020   field from...  
│ │ │ │ +0000d240: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ +0000d250: 2a20 4465 7465 726d 696e 6520 6966 204b  * Determine if K
│ │ │ │ +0000d260: 4443 2d4f 7074 696f 6e20 706f 7374 6461  DC-Option postda
│ │ │ │ +0000d270: 7465 6420 666c 6167 2069 7320 7365 742e  ted flag is set.
│ │ │ │ +0000d280: 0a0a 2020 2020 2054 6865 2050 4f53 5444  ..     The POSTD
│ │ │ │ +0000d290: 4154 4544 206f 7074 696f 6e20 696e 6469  ATED option indi
│ │ │ │ +0000d2a0: 6361 7465 7320 7468 6174 2074 6869 7320  cates that this 
│ │ │ │ +0000d2b0: 6973 2061 2072 6571 7565 7374 2066 6f72  is a request for
│ │ │ │ +0000d2c0: 2061 0a20 2020 2020 706f 7374 6461 7465   a.     postdate
│ │ │ │ +0000d2d0: 6420 7469 636b 6574 2e20 2054 6869 7320  d ticket.  This 
│ │ │ │ +0000d2e0: 6f70 7469 6f6e 2077 696c 6c20 6f6e 6c79  option will only
│ │ │ │ +0000d2f0: 2062 6520 686f 6e6f 7265 6420 6966 2074   be honored if t
│ │ │ │ +0000d300: 6865 0a20 2020 2020 7469 636b 6574 2d67  he.     ticket-g
│ │ │ │ +0000d310: 7261 6e74 696e 6720 7469 636b 6574 206f  ranting ticket o
│ │ │ │ +0000d320: 6e20 7768 6963 6820 6974 2069 7320 6261  n which it is ba
│ │ │ │ +0000d330: 7365 6420 6861 7320 6974 7320 4d41 592d  sed has its MAY-
│ │ │ │ +0000d340: 504f 5354 4441 5445 0a20 2020 2020 666c  POSTDATE.     fl
│ │ │ │ +0000d350: 6167 2073 6574 2e20 2054 6865 2072 6573  ag set.  The res
│ │ │ │ +0000d360: 756c 7469 6e67 2074 6963 6b65 7420 7769  ulting ticket wi
│ │ │ │ +0000d370: 6c6c 2061 6c73 6f20 6861 7665 2069 7473  ll also have its
│ │ │ │ +0000d380: 2049 4e56 414c 4944 2066 6c61 670a 2020   INVALID flag.  
│ │ │ │ +0000d390: 2020 2073 6574 2c20 616e 6420 7468 6174     set, and that
│ │ │ │ +0000d3a0: 2066 6c61 6720 6d61 7920 6265 2072 6573   flag may be res
│ │ │ │ +0000d3b0: 6574 2062 7920 6120 7375 6273 6571 7565  et by a subseque
│ │ │ │ +0000d3c0: 6e74 2072 6571 7565 7374 2074 6f20 7468  nt request to th
│ │ │ │ +0000d3d0: 6520 4b44 430a 2020 2020 2061 6674 6572  e KDC.     after
│ │ │ │ +0000d3e0: 2074 6865 2073 7461 7274 7469 6d65 2069   the starttime i
│ │ │ │ +0000d3f0: 6e20 7468 6520 7469 636b 6574 2068 6173  n the ticket has
│ │ │ │ +0000d400: 2062 6565 6e20 7265 6163 6865 642e 0a0a   been reached...
│ │ │ │ +0000d410: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ +0000d420: 7565 3a2a 2052 6574 7572 6e73 206e 6f6e  ue:* Returns non
│ │ │ │ +0000d430: 2d30 2069 6666 2070 6f73 7464 6174 6564  -0 iff postdated
│ │ │ │ +0000d440: 2066 6c61 6720 6973 2073 6574 2069 6e20   flag is set in 
│ │ │ │ +0000d450: 4b44 432d 5245 512e 0a0a 7368 6973 6869  KDC-REQ...shishi
│ │ │ │ +0000d460: 5f6b 6463 7265 715f 7265 6e65 7761 626c  _kdcreq_renewabl
│ │ │ │ +0000d470: 655f 700a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  e_p.------------
│ │ │ │ +0000d480: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ +0000d490: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ +0000d4a0: 2073 6869 7368 695f 6b64 6372 6571 5f72   shishi_kdcreq_r
│ │ │ │ +0000d4b0: 656e 6577 6162 6c65 5f70 2028 5368 6973  enewable_p (Shis
│ │ │ │ +0000d4c0: 6869 202a 2048 414e 444c 452c 0a20 2020  hi * HANDLE,.   
│ │ │ │ +0000d4d0: 2020 2020 2020 2053 6869 7368 695f 6173         Shishi_as
│ │ │ │ +0000d4e0: 6e31 204b 4443 5245 5129 0a20 2020 2020  n1 KDCREQ).     
│ │ │ │ +0000d4f0: 4841 4e44 4c45 3a20 7368 6973 6869 2068  HANDLE: shishi h
│ │ │ │ +0000d500: 616e 646c 6520 6173 2061 6c6c 6f63 6174  andle as allocat
│ │ │ │ +0000d510: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ +0000d520: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ +0000d530: 4b44 4352 4551 3a20 4b44 432d 5245 5120  KDCREQ: KDC-REQ 
│ │ │ │ +0000d540: 7661 7269 6162 6c65 2074 6f20 6765 7420  variable to get 
│ │ │ │ +0000d550: 6b64 632d 6f70 7469 6f6e 7320 6669 656c  kdc-options fiel
│ │ │ │ +0000d560: 6420 6672 6f6d 2e0a 0a20 2020 2020 2a44  d from...     *D
│ │ │ │ +0000d570: 6573 6372 6970 7469 6f6e 3a2a 2044 6574  escription:* Det
│ │ │ │ +0000d580: 6572 6d69 6e65 2069 6620 4b44 432d 4f70  ermine if KDC-Op
│ │ │ │ +0000d590: 7469 6f6e 2072 656e 6577 6162 6c65 2066  tion renewable f
│ │ │ │ +0000d5a0: 6c61 6720 6973 2073 6574 2e0a 0a20 2020  lag is set...   
│ │ │ │ +0000d5b0: 2020 5468 6520 5245 4e45 5741 424c 4520    The RENEWABLE 
│ │ │ │ +0000d5c0: 6f70 7469 6f6e 2069 6e64 6963 6174 6573  option indicates
│ │ │ │ +0000d5d0: 2074 6861 7420 7468 6520 7469 636b 6574   that the ticket
│ │ │ │ +0000d5e0: 2074 6f20 6265 2069 7373 7565 6420 6973   to be issued is
│ │ │ │ +0000d5f0: 2074 6f0a 2020 2020 2068 6176 6520 6974   to.     have it
│ │ │ │ +0000d600: 7320 5245 4e45 5741 424c 4520 666c 6167  s RENEWABLE flag
│ │ │ │ +0000d610: 2073 6574 2e20 2049 7420 6d61 7920 6f6e   set.  It may on
│ │ │ │ +0000d620: 6c79 2062 6520 7365 7420 6f6e 2074 6865  ly be set on the
│ │ │ │ +0000d630: 2069 6e69 7469 616c 0a20 2020 2020 7265   initial.     re
│ │ │ │ +0000d640: 7175 6573 742c 206f 7220 7768 656e 2074  quest, or when t
│ │ │ │ +0000d650: 6865 2074 6963 6b65 742d 6772 616e 7469  he ticket-granti
│ │ │ │ +0000d660: 6e67 2074 6963 6b65 7420 6f6e 2077 6869  ng ticket on whi
│ │ │ │ +0000d670: 6368 2074 6865 2072 6571 7565 7374 2069  ch the request i
│ │ │ │ +0000d680: 730a 2020 2020 2062 6173 6564 2069 7320  s.     based is 
│ │ │ │ +0000d690: 616c 736f 2072 656e 6577 6162 6c65 2e20  also renewable. 
│ │ │ │ +0000d6a0: 2049 6620 7468 6973 206f 7074 696f 6e20   If this option 
│ │ │ │ +0000d6b0: 6973 2072 6571 7565 7374 6564 2c20 7468  is requested, th
│ │ │ │ +0000d6c0: 656e 2074 6865 0a20 2020 2020 7274 696d  en the.     rtim
│ │ │ │ +0000d6d0: 6520 6669 656c 6420 696e 2074 6865 2072  e field in the r
│ │ │ │ +0000d6e0: 6571 7565 7374 2063 6f6e 7461 696e 7320  equest contains 
│ │ │ │ +0000d6f0: 7468 6520 6465 7369 7265 6420 6162 736f  the desired abso
│ │ │ │ +0000d700: 6c75 7465 2065 7870 6972 6174 696f 6e0a  lute expiration.
│ │ │ │ +0000d710: 2020 2020 2074 696d 6520 666f 7220 7468       time for th
│ │ │ │ +0000d720: 6520 7469 636b 6574 2e0a 0a20 2020 2020  e ticket...     
│ │ │ │ +0000d730: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ +0000d740: 5265 7475 726e 7320 6e6f 6e2d 3020 6966  Returns non-0 if
│ │ │ │ +0000d750: 6620 7265 6e65 7761 626c 6520 666c 6167  f renewable flag
│ │ │ │ +0000d760: 2069 7320 7365 7420 696e 204b 4443 2d52   is set in KDC-R
│ │ │ │ +0000d770: 4551 2e0a 0a73 6869 7368 695f 6b64 6372  EQ...shishi_kdcr
│ │ │ │ +0000d780: 6571 5f64 6973 6162 6c65 5f74 7261 6e73  eq_disable_trans
│ │ │ │ +0000d790: 6974 6564 5f63 6865 636b 5f70 0a2d 2d2d  ited_check_p.---
│ │ │ │  0000d7a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │  0000d7b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0000d7c0: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ -0000d7d0: 6e3a 2069 6e74 2073 6869 7368 695f 6b64  n: int shishi_kd
│ │ │ │ -0000d7e0: 6372 6571 5f64 6973 6162 6c65 5f74 7261  creq_disable_tra
│ │ │ │ -0000d7f0: 6e73 6974 6564 5f63 6865 636b 5f70 0a20  nsited_check_p. 
│ │ │ │ -0000d800: 2020 2020 2020 2020 2028 5368 6973 6869           (Shishi
│ │ │ │ -0000d810: 202a 2048 414e 444c 452c 2053 6869 7368   * HANDLE, Shish
│ │ │ │ -0000d820: 695f 6173 6e31 204b 4443 5245 5129 0a20  i_asn1 KDCREQ). 
│ │ │ │ -0000d830: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ -0000d840: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ -0000d850: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ -0000d860: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ -0000d870: 2020 2020 4b44 4352 4551 3a20 4b44 432d      KDCREQ: KDC-
│ │ │ │ -0000d880: 5245 5120 7661 7269 6162 6c65 2074 6f20  REQ variable to 
│ │ │ │ -0000d890: 6765 7420 6b64 632d 6f70 7469 6f6e 7320  get kdc-options 
│ │ │ │ -0000d8a0: 6669 656c 6420 6672 6f6d 2e0a 0a20 2020  field from...   
│ │ │ │ -0000d8b0: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ -0000d8c0: 2044 6574 6572 6d69 6e65 2069 6620 4b44   Determine if KD
│ │ │ │ -0000d8d0: 432d 4f70 7469 6f6e 2064 6973 6162 6c65  C-Option disable
│ │ │ │ -0000d8e0: 2d74 7261 6e73 6974 6564 2d63 6865 636b  -transited-check
│ │ │ │ -0000d8f0: 2066 6c61 670a 2020 2020 2069 7320 7365   flag.     is se
│ │ │ │ -0000d900: 742e 0a0a 2020 2020 2042 7920 6465 6661  t...     By defa
│ │ │ │ -0000d910: 756c 7420 7468 6520 4b44 4320 7769 6c6c  ult the KDC will
│ │ │ │ -0000d920: 2063 6865 636b 2074 6865 2074 7261 6e73   check the trans
│ │ │ │ -0000d930: 6974 6564 2066 6965 6c64 206f 6620 610a  ited field of a.
│ │ │ │ -0000d940: 2020 2020 2074 6963 6b65 742d 6772 616e       ticket-gran
│ │ │ │ -0000d950: 7469 6e67 2d74 6963 6b65 7420 6167 6169  ting-ticket agai
│ │ │ │ -0000d960: 6e73 7420 7468 6520 706f 6c69 6379 206f  nst the policy o
│ │ │ │ -0000d970: 6620 7468 6520 6c6f 6361 6c20 7265 616c  f the local real
│ │ │ │ -0000d980: 6d20 6265 666f 7265 0a20 2020 2020 6974  m before.     it
│ │ │ │ -0000d990: 2077 696c 6c20 6973 7375 6520 6465 7269   will issue deri
│ │ │ │ -0000d9a0: 7661 7469 7665 2074 6963 6b65 7473 2062  vative tickets b
│ │ │ │ -0000d9b0: 6173 6564 206f 6e20 7468 6520 7469 636b  ased on the tick
│ │ │ │ -0000d9c0: 6574 2d67 7261 6e74 696e 670a 2020 2020  et-granting.    
│ │ │ │ -0000d9d0: 2074 6963 6b65 742e 2020 4966 2074 6869   ticket.  If thi
│ │ │ │ -0000d9e0: 7320 666c 6167 2069 7320 7365 7420 696e  s flag is set in
│ │ │ │ -0000d9f0: 2074 6865 2072 6571 7565 7374 2c20 6368   the request, ch
│ │ │ │ -0000da00: 6563 6b69 6e67 206f 6620 7468 650a 2020  ecking of the.  
│ │ │ │ -0000da10: 2020 2074 7261 6e73 6974 6564 2066 6965     transited fie
│ │ │ │ -0000da20: 6c64 2069 7320 6469 7361 626c 6564 2e20  ld is disabled. 
│ │ │ │ -0000da30: 2054 6963 6b65 7473 2069 7373 7565 6420   Tickets issued 
│ │ │ │ -0000da40: 7769 7468 6f75 7420 7468 650a 2020 2020  without the.    
│ │ │ │ -0000da50: 2070 6572 666f 726d 616e 6365 206f 6620   performance of 
│ │ │ │ -0000da60: 7468 6973 2063 6865 636b 2077 696c 6c20  this check will 
│ │ │ │ -0000da70: 6265 206e 6f74 6564 2062 7920 7468 6520  be noted by the 
│ │ │ │ -0000da80: 7265 7365 7420 2830 2920 7661 6c75 6520  reset (0) value 
│ │ │ │ -0000da90: 6f66 0a20 2020 2020 7468 6520 5452 414e  of.     the TRAN
│ │ │ │ -0000daa0: 5349 5445 442d 504f 4c49 4359 2d43 4845  SITED-POLICY-CHE
│ │ │ │ -0000dab0: 434b 4544 2066 6c61 672c 2069 6e64 6963  CKED flag, indic
│ │ │ │ -0000dac0: 6174 696e 6720 746f 2074 6865 2061 7070  ating to the app
│ │ │ │ -0000dad0: 6c69 6361 7469 6f6e 0a20 2020 2020 7365  lication.     se
│ │ │ │ -0000dae0: 7276 6572 2074 6861 7420 7468 6520 7472  rver that the tr
│ │ │ │ -0000daf0: 616e 6973 7465 6420 6669 656c 6420 6d75  anisted field mu
│ │ │ │ -0000db00: 7374 2062 6520 6368 6563 6b65 6420 6c6f  st be checked lo
│ │ │ │ -0000db10: 6361 6c6c 792e 2020 4b44 4373 2061 7265  cally.  KDCs are
│ │ │ │ -0000db20: 0a20 2020 2020 656e 636f 7572 6167 6564  .     encouraged
│ │ │ │ -0000db30: 2062 7574 206e 6f74 2072 6571 7569 7265   but not require
│ │ │ │ -0000db40: 6420 746f 2068 6f6e 6f72 2074 6865 2044  d to honor the D
│ │ │ │ -0000db50: 4953 4142 4c45 2d54 5241 4e53 4954 4544  ISABLE-TRANSITED
│ │ │ │ -0000db60: 2d43 4845 434b 0a20 2020 2020 6f70 7469  -CHECK.     opti
│ │ │ │ -0000db70: 6f6e 2e0a 0a20 2020 2020 5468 6973 2066  on...     This f
│ │ │ │ -0000db80: 6c61 6720 6973 206e 6577 2073 696e 6365  lag is new since
│ │ │ │ -0000db90: 2052 4643 2031 3531 300a 0a20 2020 2020   RFC 1510..     
│ │ │ │ -0000dba0: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ -0000dbb0: 5265 7475 726e 7320 6e6f 6e2d 3020 6966  Returns non-0 if
│ │ │ │ -0000dbc0: 6620 6469 7361 626c 652d 7472 616e 7369  f disable-transi
│ │ │ │ -0000dbd0: 7465 642d 6368 6563 6b20 666c 6167 2069  ted-check flag i
│ │ │ │ -0000dbe0: 730a 2020 2020 2073 6574 2069 6e20 4b44  s.     set in KD
│ │ │ │ -0000dbf0: 432d 5245 512e 0a0a 7368 6973 6869 5f6b  C-REQ...shishi_k
│ │ │ │ -0000dc00: 6463 7265 715f 7265 6e65 7761 626c 655f  dcreq_renewable_
│ │ │ │ -0000dc10: 6f6b 5f70 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  ok_p.-----------
│ │ │ │ +0000d7c0: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ +0000d7d0: 6f6e 3a20 696e 7420 7368 6973 6869 5f6b  on: int shishi_k
│ │ │ │ +0000d7e0: 6463 7265 715f 6469 7361 626c 655f 7472  dcreq_disable_tr
│ │ │ │ +0000d7f0: 616e 7369 7465 645f 6368 6563 6b5f 700a  ansited_check_p.
│ │ │ │ +0000d800: 2020 2020 2020 2020 2020 2853 6869 7368            (Shish
│ │ │ │ +0000d810: 6920 2a20 4841 4e44 4c45 2c20 5368 6973  i * HANDLE, Shis
│ │ │ │ +0000d820: 6869 5f61 736e 3120 4b44 4352 4551 290a  hi_asn1 KDCREQ).
│ │ │ │ +0000d830: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ +0000d840: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ +0000d850: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ +0000d860: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ +0000d870: 2020 2020 204b 4443 5245 513a 204b 4443       KDCREQ: KDC
│ │ │ │ +0000d880: 2d52 4551 2076 6172 6961 626c 6520 746f  -REQ variable to
│ │ │ │ +0000d890: 2067 6574 206b 6463 2d6f 7074 696f 6e73   get kdc-options
│ │ │ │ +0000d8a0: 2066 6965 6c64 2066 726f 6d2e 0a0a 2020   field from...  
│ │ │ │ +0000d8b0: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ +0000d8c0: 2a20 4465 7465 726d 696e 6520 6966 204b  * Determine if K
│ │ │ │ +0000d8d0: 4443 2d4f 7074 696f 6e20 6469 7361 626c  DC-Option disabl
│ │ │ │ +0000d8e0: 652d 7472 616e 7369 7465 642d 6368 6563  e-transited-chec
│ │ │ │ +0000d8f0: 6b20 666c 6167 0a20 2020 2020 6973 2073  k flag.     is s
│ │ │ │ +0000d900: 6574 2e0a 0a20 2020 2020 4279 2064 6566  et...     By def
│ │ │ │ +0000d910: 6175 6c74 2074 6865 204b 4443 2077 696c  ault the KDC wil
│ │ │ │ +0000d920: 6c20 6368 6563 6b20 7468 6520 7472 616e  l check the tran
│ │ │ │ +0000d930: 7369 7465 6420 6669 656c 6420 6f66 2061  sited field of a
│ │ │ │ +0000d940: 0a20 2020 2020 7469 636b 6574 2d67 7261  .     ticket-gra
│ │ │ │ +0000d950: 6e74 696e 672d 7469 636b 6574 2061 6761  nting-ticket aga
│ │ │ │ +0000d960: 696e 7374 2074 6865 2070 6f6c 6963 7920  inst the policy 
│ │ │ │ +0000d970: 6f66 2074 6865 206c 6f63 616c 2072 6561  of the local rea
│ │ │ │ +0000d980: 6c6d 2062 6566 6f72 650a 2020 2020 2069  lm before.     i
│ │ │ │ +0000d990: 7420 7769 6c6c 2069 7373 7565 2064 6572  t will issue der
│ │ │ │ +0000d9a0: 6976 6174 6976 6520 7469 636b 6574 7320  ivative tickets 
│ │ │ │ +0000d9b0: 6261 7365 6420 6f6e 2074 6865 2074 6963  based on the tic
│ │ │ │ +0000d9c0: 6b65 742d 6772 616e 7469 6e67 0a20 2020  ket-granting.   
│ │ │ │ +0000d9d0: 2020 7469 636b 6574 2e20 2049 6620 7468    ticket.  If th
│ │ │ │ +0000d9e0: 6973 2066 6c61 6720 6973 2073 6574 2069  is flag is set i
│ │ │ │ +0000d9f0: 6e20 7468 6520 7265 7175 6573 742c 2063  n the request, c
│ │ │ │ +0000da00: 6865 636b 696e 6720 6f66 2074 6865 0a20  hecking of the. 
│ │ │ │ +0000da10: 2020 2020 7472 616e 7369 7465 6420 6669      transited fi
│ │ │ │ +0000da20: 656c 6420 6973 2064 6973 6162 6c65 642e  eld is disabled.
│ │ │ │ +0000da30: 2020 5469 636b 6574 7320 6973 7375 6564    Tickets issued
│ │ │ │ +0000da40: 2077 6974 686f 7574 2074 6865 0a20 2020   without the.   
│ │ │ │ +0000da50: 2020 7065 7266 6f72 6d61 6e63 6520 6f66    performance of
│ │ │ │ +0000da60: 2074 6869 7320 6368 6563 6b20 7769 6c6c   this check will
│ │ │ │ +0000da70: 2062 6520 6e6f 7465 6420 6279 2074 6865   be noted by the
│ │ │ │ +0000da80: 2072 6573 6574 2028 3029 2076 616c 7565   reset (0) value
│ │ │ │ +0000da90: 206f 660a 2020 2020 2074 6865 2054 5241   of.     the TRA
│ │ │ │ +0000daa0: 4e53 4954 4544 2d50 4f4c 4943 592d 4348  NSITED-POLICY-CH
│ │ │ │ +0000dab0: 4543 4b45 4420 666c 6167 2c20 696e 6469  ECKED flag, indi
│ │ │ │ +0000dac0: 6361 7469 6e67 2074 6f20 7468 6520 6170  cating to the ap
│ │ │ │ +0000dad0: 706c 6963 6174 696f 6e0a 2020 2020 2073  plication.     s
│ │ │ │ +0000dae0: 6572 7665 7220 7468 6174 2074 6865 2074  erver that the t
│ │ │ │ +0000daf0: 7261 6e69 7374 6564 2066 6965 6c64 206d  ranisted field m
│ │ │ │ +0000db00: 7573 7420 6265 2063 6865 636b 6564 206c  ust be checked l
│ │ │ │ +0000db10: 6f63 616c 6c79 2e20 204b 4443 7320 6172  ocally.  KDCs ar
│ │ │ │ +0000db20: 650a 2020 2020 2065 6e63 6f75 7261 6765  e.     encourage
│ │ │ │ +0000db30: 6420 6275 7420 6e6f 7420 7265 7175 6972  d but not requir
│ │ │ │ +0000db40: 6564 2074 6f20 686f 6e6f 7220 7468 6520  ed to honor the 
│ │ │ │ +0000db50: 4449 5341 424c 452d 5452 414e 5349 5445  DISABLE-TRANSITE
│ │ │ │ +0000db60: 442d 4348 4543 4b0a 2020 2020 206f 7074  D-CHECK.     opt
│ │ │ │ +0000db70: 696f 6e2e 0a0a 2020 2020 2054 6869 7320  ion...     This 
│ │ │ │ +0000db80: 666c 6167 2069 7320 6e65 7720 7369 6e63  flag is new sinc
│ │ │ │ +0000db90: 6520 5246 4320 3135 3130 0a0a 2020 2020  e RFC 1510..    
│ │ │ │ +0000dba0: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ +0000dbb0: 2052 6574 7572 6e73 206e 6f6e 2d30 2069   Returns non-0 i
│ │ │ │ +0000dbc0: 6666 2064 6973 6162 6c65 2d74 7261 6e73  ff disable-trans
│ │ │ │ +0000dbd0: 6974 6564 2d63 6865 636b 2066 6c61 6720  ited-check flag 
│ │ │ │ +0000dbe0: 6973 0a20 2020 2020 7365 7420 696e 204b  is.     set in K
│ │ │ │ +0000dbf0: 4443 2d52 4551 2e0a 0a73 6869 7368 695f  DC-REQ...shishi_
│ │ │ │ +0000dc00: 6b64 6372 6571 5f72 656e 6577 6162 6c65  kdcreq_renewable
│ │ │ │ +0000dc10: 5f6f 6b5f 700a 2d2d 2d2d 2d2d 2d2d 2d2d  _ok_p.----------
│ │ │ │  0000dc20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0000dc30: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ -0000dc40: 2069 6e74 2073 6869 7368 695f 6b64 6372   int shishi_kdcr
│ │ │ │ -0000dc50: 6571 5f72 656e 6577 6162 6c65 5f6f 6b5f  eq_renewable_ok_
│ │ │ │ -0000dc60: 7020 2853 6869 7368 6920 2a20 4841 4e44  p (Shishi * HAND
│ │ │ │ -0000dc70: 4c45 2c0a 2020 2020 2020 2020 2020 5368  LE,.          Sh
│ │ │ │ -0000dc80: 6973 6869 5f61 736e 3120 4b44 4352 4551  ishi_asn1 KDCREQ
│ │ │ │ -0000dc90: 290a 2020 2020 2048 414e 444c 453a 2073  ).     HANDLE: s
│ │ │ │ -0000dca0: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ -0000dcb0: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ -0000dcc0: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ -0000dcd0: 2e0a 2020 2020 204b 4443 5245 513a 204b  ..     KDCREQ: K
│ │ │ │ -0000dce0: 4443 2d52 4551 2076 6172 6961 626c 6520  DC-REQ variable 
│ │ │ │ -0000dcf0: 746f 2067 6574 206b 6463 2d6f 7074 696f  to get kdc-optio
│ │ │ │ -0000dd00: 6e73 2066 6965 6c64 2066 726f 6d2e 0a0a  ns field from...
│ │ │ │ -0000dd10: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ -0000dd20: 6e3a 2a20 4465 7465 726d 696e 6520 6966  n:* Determine if
│ │ │ │ -0000dd30: 204b 4443 2d4f 7074 696f 6e20 7265 6e65   KDC-Option rene
│ │ │ │ -0000dd40: 7761 626c 652d 6f6b 2066 6c61 6720 6973  wable-ok flag is
│ │ │ │ -0000dd50: 2073 6574 2e0a 0a20 2020 2020 5468 6520   set...     The 
│ │ │ │ -0000dd60: 5245 4e45 5741 424c 452d 4f4b 206f 7074  RENEWABLE-OK opt
│ │ │ │ -0000dd70: 696f 6e20 696e 6469 6361 7465 7320 7468  ion indicates th
│ │ │ │ -0000dd80: 6174 2061 2072 656e 6577 6162 6c65 2074  at a renewable t
│ │ │ │ -0000dd90: 6963 6b65 7420 7769 6c6c 2062 650a 2020  icket will be.  
│ │ │ │ -0000dda0: 2020 2061 6363 6570 7461 626c 6520 6966     acceptable if
│ │ │ │ -0000ddb0: 2061 2074 6963 6b65 7420 7769 7468 2074   a ticket with t
│ │ │ │ -0000ddc0: 6865 2072 6571 7565 7374 6564 206c 6966  he requested lif
│ │ │ │ -0000ddd0: 6520 6361 6e6e 6f74 206f 7468 6572 7769  e cannot otherwi
│ │ │ │ -0000dde0: 7365 2062 650a 2020 2020 2070 726f 7669  se be.     provi
│ │ │ │ -0000ddf0: 6465 642e 2020 4966 2061 2074 6963 6b65  ded.  If a ticke
│ │ │ │ -0000de00: 7420 7769 7468 2074 6865 2072 6571 7565  t with the reque
│ │ │ │ -0000de10: 7374 6564 206c 6966 6520 6361 6e6e 6f74  sted life cannot
│ │ │ │ -0000de20: 2062 6520 7072 6f76 6964 6564 2c0a 2020   be provided,.  
│ │ │ │ -0000de30: 2020 2074 6865 6e20 6120 7265 6e65 7761     then a renewa
│ │ │ │ -0000de40: 626c 6520 7469 636b 6574 206d 6179 2062  ble ticket may b
│ │ │ │ -0000de50: 6520 6973 7375 6564 2077 6974 6820 6120  e issued with a 
│ │ │ │ -0000de60: 7265 6e65 772d 7469 6c6c 2065 7175 616c  renew-till equal
│ │ │ │ -0000de70: 2074 6f0a 2020 2020 2074 6865 2072 6571   to.     the req
│ │ │ │ -0000de80: 7565 7374 6564 2065 6e64 7469 6d65 2e20  uested endtime. 
│ │ │ │ -0000de90: 2054 6865 2076 616c 7565 206f 6620 7468   The value of th
│ │ │ │ -0000dea0: 6520 7265 6e65 772d 7469 6c6c 2066 6965  e renew-till fie
│ │ │ │ -0000deb0: 6c64 206d 6179 2073 7469 6c6c 0a20 2020  ld may still.   
│ │ │ │ -0000dec0: 2020 6265 206c 696d 6974 6564 2062 7920    be limited by 
│ │ │ │ -0000ded0: 6c6f 6361 6c20 6c69 6d69 7473 2c20 6f72  local limits, or
│ │ │ │ -0000dee0: 206c 696d 6974 7320 7365 6c65 6374 6564   limits selected
│ │ │ │ -0000def0: 2062 7920 7468 6520 696e 6469 7669 6475   by the individu
│ │ │ │ -0000df00: 616c 0a20 2020 2020 7072 696e 6369 7061  al.     principa
│ │ │ │ -0000df10: 6c20 6f72 2073 6572 7665 722e 0a0a 2020  l or server...  
│ │ │ │ -0000df20: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ -0000df30: 3a2a 2052 6574 7572 6e73 206e 6f6e 2d30  :* Returns non-0
│ │ │ │ -0000df40: 2069 6666 2072 656e 6577 6162 6c65 2d6f   iff renewable-o
│ │ │ │ -0000df50: 6b20 666c 6167 2069 7320 7365 7420 696e  k flag is set in
│ │ │ │ -0000df60: 0a20 2020 2020 4b44 432d 5245 512e 0a0a  .     KDC-REQ...
│ │ │ │ -0000df70: 7368 6973 6869 5f6b 6463 7265 715f 656e  shishi_kdcreq_en
│ │ │ │ -0000df80: 635f 746b 745f 696e 5f73 6b65 795f 700a  c_tkt_in_skey_p.
│ │ │ │ -0000df90: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0000dfa0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -0000dfb0: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ -0000dfc0: 6e74 2073 6869 7368 695f 6b64 6372 6571  nt shishi_kdcreq
│ │ │ │ -0000dfd0: 5f65 6e63 5f74 6b74 5f69 6e5f 736b 6579  _enc_tkt_in_skey
│ │ │ │ -0000dfe0: 5f70 2028 5368 6973 6869 202a 2048 414e  _p (Shishi * HAN
│ │ │ │ -0000dff0: 444c 452c 0a20 2020 2020 2020 2020 2053  DLE,.          S
│ │ │ │ -0000e000: 6869 7368 695f 6173 6e31 204b 4443 5245  hishi_asn1 KDCRE
│ │ │ │ -0000e010: 5129 0a20 2020 2020 4841 4e44 4c45 3a20  Q).     HANDLE: 
│ │ │ │ -0000e020: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ -0000e030: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ -0000e040: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ -0000e050: 992e 0a20 2020 2020 4b44 4352 4551 3a20  ...     KDCREQ: 
│ │ │ │ -0000e060: 4b44 432d 5245 5120 7661 7269 6162 6c65  KDC-REQ variable
│ │ │ │ -0000e070: 2074 6f20 6765 7420 6b64 632d 6f70 7469   to get kdc-opti
│ │ │ │ -0000e080: 6f6e 7320 6669 656c 6420 6672 6f6d 2e0a  ons field from..
│ │ │ │ -0000e090: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -0000e0a0: 6f6e 3a2a 2044 6574 6572 6d69 6e65 2069  on:* Determine i
│ │ │ │ -0000e0b0: 6620 4b44 432d 4f70 7469 6f6e 2065 6e63  f KDC-Option enc
│ │ │ │ -0000e0c0: 2d74 6b74 2d69 6e2d 736b 6579 2066 6c61  -tkt-in-skey fla
│ │ │ │ -0000e0d0: 6720 6973 2073 6574 2e0a 0a20 2020 2020  g is set...     
│ │ │ │ -0000e0e0: 5468 6973 206f 7074 696f 6e20 6973 2075  This option is u
│ │ │ │ -0000e0f0: 7365 6420 6f6e 6c79 2062 7920 7468 6520  sed only by the 
│ │ │ │ -0000e100: 7469 636b 6574 2d67 7261 6e74 696e 6720  ticket-granting 
│ │ │ │ -0000e110: 7365 7276 6963 652e 2020 5468 650a 2020  service.  The.  
│ │ │ │ -0000e120: 2020 2045 4e43 2d54 4b54 2d49 4e2d 534b     ENC-TKT-IN-SK
│ │ │ │ -0000e130: 4559 206f 7074 696f 6e20 696e 6469 6361  EY option indica
│ │ │ │ -0000e140: 7465 7320 7468 6174 2074 6865 2074 6963  tes that the tic
│ │ │ │ -0000e150: 6b65 7420 666f 7220 7468 6520 656e 6420  ket for the end 
│ │ │ │ -0000e160: 7365 7276 6572 0a20 2020 2020 6973 2074  server.     is t
│ │ │ │ -0000e170: 6f20 6265 2065 6e63 7279 7074 6564 2069  o be encrypted i
│ │ │ │ -0000e180: 6e20 7468 6520 7365 7373 696f 6e20 6b65  n the session ke
│ │ │ │ -0000e190: 7920 6672 6f6d 2074 6865 2061 6464 6974  y from the addit
│ │ │ │ -0000e1a0: 696f 6e61 6c0a 2020 2020 2074 6963 6b65  ional.     ticke
│ │ │ │ -0000e1b0: 742d 6772 616e 7469 6e67 2074 6963 6b65  t-granting ticke
│ │ │ │ -0000e1c0: 7420 7072 6f76 6964 6564 2e0a 0a20 2020  t provided...   
│ │ │ │ -0000e1d0: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ -0000e1e0: 2a20 5265 7475 726e 7320 6e6f 6e2d 3020  * Returns non-0 
│ │ │ │ -0000e1f0: 6966 6620 656e 632d 746b 742d 696e 2d73  iff enc-tkt-in-s
│ │ │ │ -0000e200: 6b65 7920 666c 6167 2069 7320 7365 7420  key flag is set 
│ │ │ │ -0000e210: 696e 0a20 2020 2020 4b44 432d 5245 512e  in.     KDC-REQ.
│ │ │ │ -0000e220: 0a0a 7368 6973 6869 5f6b 6463 7265 715f  ..shishi_kdcreq_
│ │ │ │ -0000e230: 7265 6e65 775f 700a 2d2d 2d2d 2d2d 2d2d  renew_p.--------
│ │ │ │ -0000e240: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -0000e250: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ -0000e260: 2073 6869 7368 695f 6b64 6372 6571 5f72   shishi_kdcreq_r
│ │ │ │ -0000e270: 656e 6577 5f70 2028 5368 6973 6869 202a  enew_p (Shishi *
│ │ │ │ -0000e280: 2048 414e 444c 452c 0a20 2020 2020 2020   HANDLE,.       
│ │ │ │ -0000e290: 2020 2053 6869 7368 695f 6173 6e31 204b     Shishi_asn1 K
│ │ │ │ -0000e2a0: 4443 5245 5129 0a20 2020 2020 4841 4e44  DCREQ).     HAND
│ │ │ │ -0000e2b0: 4c45 3a20 7368 6973 6869 2068 616e 646c  LE: shishi handl
│ │ │ │ -0000e2c0: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ -0000e2d0: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ -0000e2e0: 2829 e280 992e 0a20 2020 2020 4b44 4352  ().....     KDCR
│ │ │ │ -0000e2f0: 4551 3a20 4b44 432d 5245 5120 7661 7269  EQ: KDC-REQ vari
│ │ │ │ -0000e300: 6162 6c65 2074 6f20 6765 7420 6b64 632d  able to get kdc-
│ │ │ │ -0000e310: 6f70 7469 6f6e 7320 6669 656c 6420 6672  options field fr
│ │ │ │ -0000e320: 6f6d 2e0a 0a20 2020 2020 2a44 6573 6372  om...     *Descr
│ │ │ │ -0000e330: 6970 7469 6f6e 3a2a 2044 6574 6572 6d69  iption:* Determi
│ │ │ │ -0000e340: 6e65 2069 6620 4b44 432d 4f70 7469 6f6e  ne if KDC-Option
│ │ │ │ -0000e350: 2072 656e 6577 2066 6c61 6720 6973 2073   renew flag is s
│ │ │ │ -0000e360: 6574 2e0a 0a20 2020 2020 5468 6973 206f  et...     This o
│ │ │ │ -0000e370: 7074 696f 6e20 6973 2075 7365 6420 6f6e  ption is used on
│ │ │ │ -0000e380: 6c79 2062 7920 7468 6520 7469 636b 6574  ly by the ticket
│ │ │ │ -0000e390: 2d67 7261 6e74 696e 6720 7365 7276 6963  -granting servic
│ │ │ │ -0000e3a0: 652e 2020 5468 6520 5245 4e45 570a 2020  e.  The RENEW.  
│ │ │ │ -0000e3b0: 2020 206f 7074 696f 6e20 696e 6469 6361     option indica
│ │ │ │ -0000e3c0: 7465 7320 7468 6174 2074 6865 2070 7265  tes that the pre
│ │ │ │ -0000e3d0: 7365 6e74 2072 6571 7565 7374 2069 7320  sent request is 
│ │ │ │ -0000e3e0: 666f 7220 6120 7265 6e65 7761 6c2e 2020  for a renewal.  
│ │ │ │ -0000e3f0: 5468 650a 2020 2020 2074 6963 6b65 7420  The.     ticket 
│ │ │ │ -0000e400: 7072 6f76 6964 6564 2069 7320 656e 6372  provided is encr
│ │ │ │ -0000e410: 7970 7465 6420 696e 2074 6865 2073 6563  ypted in the sec
│ │ │ │ -0000e420: 7265 7420 6b65 7920 666f 7220 7468 6520  ret key for the 
│ │ │ │ -0000e430: 7365 7276 6572 206f 6e0a 2020 2020 2077  server on.     w
│ │ │ │ -0000e440: 6869 6368 2069 7420 6973 2076 616c 6964  hich it is valid
│ │ │ │ -0000e450: 2e20 2054 6869 7320 6f70 7469 6f6e 2077  .  This option w
│ │ │ │ -0000e460: 696c 6c20 6f6e 6c79 2062 6520 686f 6e6f  ill only be hono
│ │ │ │ -0000e470: 7265 6420 6966 2074 6865 2074 6963 6b65  red if the ticke
│ │ │ │ -0000e480: 740a 2020 2020 2074 6f20 6265 2072 656e  t.     to be ren
│ │ │ │ -0000e490: 6577 6564 2068 6173 2069 7473 2052 454e  ewed has its REN
│ │ │ │ -0000e4a0: 4557 4142 4c45 2066 6c61 6720 7365 7420  EWABLE flag set 
│ │ │ │ -0000e4b0: 616e 6420 6966 2074 6865 2074 696d 6520  and if the time 
│ │ │ │ -0000e4c0: 696e 2069 7473 0a20 2020 2020 7265 6e65  in its.     rene
│ │ │ │ -0000e4d0: 772d 7469 6c6c 2066 6965 6c64 2068 6173  w-till field has
│ │ │ │ -0000e4e0: 206e 6f74 2070 6173 7365 642e 2020 5468   not passed.  Th
│ │ │ │ -0000e4f0: 6520 7469 636b 6574 2074 6f20 6265 2072  e ticket to be r
│ │ │ │ -0000e500: 656e 6577 6564 2069 730a 2020 2020 2070  enewed is.     p
│ │ │ │ -0000e510: 6173 7365 6420 696e 2074 6865 2070 6164  assed in the pad
│ │ │ │ -0000e520: 6174 6120 6669 656c 6420 6173 2070 6172  ata field as par
│ │ │ │ -0000e530: 7420 6f66 2074 6865 2061 7574 6865 6e74  t of the authent
│ │ │ │ -0000e540: 6963 6174 696f 6e20 6865 6164 6572 2e0a  ication header..
│ │ │ │ -0000e550: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ -0000e560: 6c75 653a 2a20 5265 7475 726e 7320 6e6f  lue:* Returns no
│ │ │ │ -0000e570: 6e2d 3020 6966 6620 7265 6e65 7720 666c  n-0 iff renew fl
│ │ │ │ -0000e580: 6167 2069 7320 7365 7420 696e 204b 4443  ag is set in KDC
│ │ │ │ -0000e590: 2d52 4551 2e0a 0a73 6869 7368 695f 6b64  -REQ...shishi_kd
│ │ │ │ -0000e5a0: 6372 6571 5f76 616c 6964 6174 655f 700a  creq_validate_p.
│ │ │ │ -0000e5b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0000e5c0: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -0000e5d0: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ -0000e5e0: 6869 5f6b 6463 7265 715f 7661 6c69 6461  hi_kdcreq_valida
│ │ │ │ -0000e5f0: 7465 5f70 2028 5368 6973 6869 202a 2048  te_p (Shishi * H
│ │ │ │ -0000e600: 414e 444c 452c 0a20 2020 2020 2020 2020  ANDLE,.         
│ │ │ │ -0000e610: 2053 6869 7368 695f 6173 6e31 204b 4443   Shishi_asn1 KDC
│ │ │ │ -0000e620: 5245 5129 0a20 2020 2020 4841 4e44 4c45  REQ).     HANDLE
│ │ │ │ -0000e630: 3a20 7368 6973 6869 2068 616e 646c 6520  : shishi handle 
│ │ │ │ -0000e640: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ -0000e650: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ -0000e660: e280 992e 0a20 2020 2020 4b44 4352 4551  .....     KDCREQ
│ │ │ │ -0000e670: 3a20 4b44 432d 5245 5120 7661 7269 6162  : KDC-REQ variab
│ │ │ │ -0000e680: 6c65 2074 6f20 6765 7420 6b64 632d 6f70  le to get kdc-op
│ │ │ │ -0000e690: 7469 6f6e 7320 6669 656c 6420 6672 6f6d  tions field from
│ │ │ │ -0000e6a0: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ -0000e6b0: 7469 6f6e 3a2a 2044 6574 6572 6d69 6e65  tion:* Determine
│ │ │ │ -0000e6c0: 2069 6620 4b44 432d 4f70 7469 6f6e 2076   if KDC-Option v
│ │ │ │ -0000e6d0: 616c 6964 6174 6520 666c 6167 2069 7320  alidate flag is 
│ │ │ │ -0000e6e0: 7365 742e 0a0a 2020 2020 2054 6869 7320  set...     This 
│ │ │ │ -0000e6f0: 6f70 7469 6f6e 2069 7320 7573 6564 206f  option is used o
│ │ │ │ -0000e700: 6e6c 7920 6279 2074 6865 2074 6963 6b65  nly by the ticke
│ │ │ │ -0000e710: 742d 6772 616e 7469 6e67 2073 6572 7669  t-granting servi
│ │ │ │ -0000e720: 6365 2e20 2054 6865 0a20 2020 2020 5641  ce.  The.     VA
│ │ │ │ -0000e730: 4c49 4441 5445 206f 7074 696f 6e20 696e  LIDATE option in
│ │ │ │ -0000e740: 6469 6361 7465 7320 7468 6174 2074 6865  dicates that the
│ │ │ │ -0000e750: 2072 6571 7565 7374 2069 7320 746f 2076   request is to v
│ │ │ │ -0000e760: 616c 6964 6174 6520 610a 2020 2020 2070  alidate a.     p
│ │ │ │ -0000e770: 6f73 7464 6174 6564 2074 6963 6b65 742e  ostdated ticket.
│ │ │ │ -0000e780: 2020 4974 2077 696c 6c20 6f6e 6c79 2062    It will only b
│ │ │ │ -0000e790: 6520 686f 6e6f 7265 6420 6966 2074 6865  e honored if the
│ │ │ │ -0000e7a0: 2074 6963 6b65 7420 7072 6573 656e 7465   ticket presente
│ │ │ │ -0000e7b0: 640a 2020 2020 2069 7320 706f 7374 6461  d.     is postda
│ │ │ │ -0000e7c0: 7465 642c 2070 7265 7365 6e74 6c79 2068  ted, presently h
│ │ │ │ -0000e7d0: 6173 2069 7473 2049 4e56 414c 4944 2066  as its INVALID f
│ │ │ │ -0000e7e0: 6c61 6720 7365 742c 2061 6e64 2077 6f75  lag set, and wou
│ │ │ │ -0000e7f0: 6c64 2062 650a 2020 2020 206f 7468 6572  ld be.     other
│ │ │ │ -0000e800: 7769 7365 2075 7361 626c 6520 6174 2074  wise usable at t
│ │ │ │ -0000e810: 6869 7320 7469 6d65 2e20 2041 2074 6963  his time.  A tic
│ │ │ │ -0000e820: 6b65 7420 6361 6e6e 6f74 2062 6520 7661  ket cannot be va
│ │ │ │ -0000e830: 6c69 6461 7465 6420 6265 666f 7265 0a20  lidated before. 
│ │ │ │ -0000e840: 2020 2020 6974 7320 7374 6172 7474 696d      its starttim
│ │ │ │ -0000e850: 652e 2020 5468 6520 7469 636b 6574 2070  e.  The ticket p
│ │ │ │ -0000e860: 7265 7365 6e74 6564 2066 6f72 2076 616c  resented for val
│ │ │ │ -0000e870: 6964 6174 696f 6e20 6973 2065 6e63 7279  idation is encry
│ │ │ │ -0000e880: 7074 6564 2069 6e0a 2020 2020 2074 6865  pted in.     the
│ │ │ │ -0000e890: 206b 6579 206f 6620 7468 6520 7365 7276   key of the serv
│ │ │ │ -0000e8a0: 6572 2066 6f72 2077 6869 6368 2069 7420  er for which it 
│ │ │ │ -0000e8b0: 6973 2076 616c 6964 2061 6e64 2069 7320  is valid and is 
│ │ │ │ -0000e8c0: 7061 7373 6564 2069 6e20 7468 650a 2020  passed in the.  
│ │ │ │ -0000e8d0: 2020 2070 6164 6174 6120 6669 656c 6420     padata field 
│ │ │ │ -0000e8e0: 6173 2070 6172 7420 6f66 2074 6865 2061  as part of the a
│ │ │ │ -0000e8f0: 7574 6865 6e74 6963 6174 696f 6e20 6865  uthentication he
│ │ │ │ -0000e900: 6164 6572 2e0a 0a20 2020 2020 2a52 6574  ader...     *Ret
│ │ │ │ -0000e910: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ -0000e920: 726e 7320 6e6f 6e2d 3020 6966 6620 7661  rns non-0 iff va
│ │ │ │ -0000e930: 6c69 6461 7465 2066 6c61 6720 6973 2073  lidate flag is s
│ │ │ │ -0000e940: 6574 2069 6e20 4b44 432d 5245 512e 0a0a  et in KDC-REQ...
│ │ │ │ -0000e950: 7368 6973 6869 5f6b 6463 7265 715f 6f70  shishi_kdcreq_op
│ │ │ │ -0000e960: 7469 6f6e 735f 7365 740a 2d2d 2d2d 2d2d  tions_set.------
│ │ │ │ +0000dc30: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ +0000dc40: 3a20 696e 7420 7368 6973 6869 5f6b 6463  : int shishi_kdc
│ │ │ │ +0000dc50: 7265 715f 7265 6e65 7761 626c 655f 6f6b  req_renewable_ok
│ │ │ │ +0000dc60: 5f70 2028 5368 6973 6869 202a 2048 414e  _p (Shishi * HAN
│ │ │ │ +0000dc70: 444c 452c 0a20 2020 2020 2020 2020 2053  DLE,.          S
│ │ │ │ +0000dc80: 6869 7368 695f 6173 6e31 204b 4443 5245  hishi_asn1 KDCRE
│ │ │ │ +0000dc90: 5129 0a20 2020 2020 4841 4e44 4c45 3a20  Q).     HANDLE: 
│ │ │ │ +0000dca0: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ +0000dcb0: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ +0000dcc0: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ +0000dcd0: 992e 0a20 2020 2020 4b44 4352 4551 3a20  ...     KDCREQ: 
│ │ │ │ +0000dce0: 4b44 432d 5245 5120 7661 7269 6162 6c65  KDC-REQ variable
│ │ │ │ +0000dcf0: 2074 6f20 6765 7420 6b64 632d 6f70 7469   to get kdc-opti
│ │ │ │ +0000dd00: 6f6e 7320 6669 656c 6420 6672 6f6d 2e0a  ons field from..
│ │ │ │ +0000dd10: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +0000dd20: 6f6e 3a2a 2044 6574 6572 6d69 6e65 2069  on:* Determine i
│ │ │ │ +0000dd30: 6620 4b44 432d 4f70 7469 6f6e 2072 656e  f KDC-Option ren
│ │ │ │ +0000dd40: 6577 6162 6c65 2d6f 6b20 666c 6167 2069  ewable-ok flag i
│ │ │ │ +0000dd50: 7320 7365 742e 0a0a 2020 2020 2054 6865  s set...     The
│ │ │ │ +0000dd60: 2052 454e 4557 4142 4c45 2d4f 4b20 6f70   RENEWABLE-OK op
│ │ │ │ +0000dd70: 7469 6f6e 2069 6e64 6963 6174 6573 2074  tion indicates t
│ │ │ │ +0000dd80: 6861 7420 6120 7265 6e65 7761 626c 6520  hat a renewable 
│ │ │ │ +0000dd90: 7469 636b 6574 2077 696c 6c20 6265 0a20  ticket will be. 
│ │ │ │ +0000dda0: 2020 2020 6163 6365 7074 6162 6c65 2069      acceptable i
│ │ │ │ +0000ddb0: 6620 6120 7469 636b 6574 2077 6974 6820  f a ticket with 
│ │ │ │ +0000ddc0: 7468 6520 7265 7175 6573 7465 6420 6c69  the requested li
│ │ │ │ +0000ddd0: 6665 2063 616e 6e6f 7420 6f74 6865 7277  fe cannot otherw
│ │ │ │ +0000dde0: 6973 6520 6265 0a20 2020 2020 7072 6f76  ise be.     prov
│ │ │ │ +0000ddf0: 6964 6564 2e20 2049 6620 6120 7469 636b  ided.  If a tick
│ │ │ │ +0000de00: 6574 2077 6974 6820 7468 6520 7265 7175  et with the requ
│ │ │ │ +0000de10: 6573 7465 6420 6c69 6665 2063 616e 6e6f  ested life canno
│ │ │ │ +0000de20: 7420 6265 2070 726f 7669 6465 642c 0a20  t be provided,. 
│ │ │ │ +0000de30: 2020 2020 7468 656e 2061 2072 656e 6577      then a renew
│ │ │ │ +0000de40: 6162 6c65 2074 6963 6b65 7420 6d61 7920  able ticket may 
│ │ │ │ +0000de50: 6265 2069 7373 7565 6420 7769 7468 2061  be issued with a
│ │ │ │ +0000de60: 2072 656e 6577 2d74 696c 6c20 6571 7561   renew-till equa
│ │ │ │ +0000de70: 6c20 746f 0a20 2020 2020 7468 6520 7265  l to.     the re
│ │ │ │ +0000de80: 7175 6573 7465 6420 656e 6474 696d 652e  quested endtime.
│ │ │ │ +0000de90: 2020 5468 6520 7661 6c75 6520 6f66 2074    The value of t
│ │ │ │ +0000dea0: 6865 2072 656e 6577 2d74 696c 6c20 6669  he renew-till fi
│ │ │ │ +0000deb0: 656c 6420 6d61 7920 7374 696c 6c0a 2020  eld may still.  
│ │ │ │ +0000dec0: 2020 2062 6520 6c69 6d69 7465 6420 6279     be limited by
│ │ │ │ +0000ded0: 206c 6f63 616c 206c 696d 6974 732c 206f   local limits, o
│ │ │ │ +0000dee0: 7220 6c69 6d69 7473 2073 656c 6563 7465  r limits selecte
│ │ │ │ +0000def0: 6420 6279 2074 6865 2069 6e64 6976 6964  d by the individ
│ │ │ │ +0000df00: 7561 6c0a 2020 2020 2070 7269 6e63 6970  ual.     princip
│ │ │ │ +0000df10: 616c 206f 7220 7365 7276 6572 2e0a 0a20  al or server... 
│ │ │ │ +0000df20: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ +0000df30: 653a 2a20 5265 7475 726e 7320 6e6f 6e2d  e:* Returns non-
│ │ │ │ +0000df40: 3020 6966 6620 7265 6e65 7761 626c 652d  0 iff renewable-
│ │ │ │ +0000df50: 6f6b 2066 6c61 6720 6973 2073 6574 2069  ok flag is set i
│ │ │ │ +0000df60: 6e0a 2020 2020 204b 4443 2d52 4551 2e0a  n.     KDC-REQ..
│ │ │ │ +0000df70: 0a73 6869 7368 695f 6b64 6372 6571 5f65  .shishi_kdcreq_e
│ │ │ │ +0000df80: 6e63 5f74 6b74 5f69 6e5f 736b 6579 5f70  nc_tkt_in_skey_p
│ │ │ │ +0000df90: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ +0000dfa0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +0000dfb0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +0000dfc0: 696e 7420 7368 6973 6869 5f6b 6463 7265  int shishi_kdcre
│ │ │ │ +0000dfd0: 715f 656e 635f 746b 745f 696e 5f73 6b65  q_enc_tkt_in_ske
│ │ │ │ +0000dfe0: 795f 7020 2853 6869 7368 6920 2a20 4841  y_p (Shishi * HA
│ │ │ │ +0000dff0: 4e44 4c45 2c0a 2020 2020 2020 2020 2020  NDLE,.          
│ │ │ │ +0000e000: 5368 6973 6869 5f61 736e 3120 4b44 4352  Shishi_asn1 KDCR
│ │ │ │ +0000e010: 4551 290a 2020 2020 2048 414e 444c 453a  EQ).     HANDLE:
│ │ │ │ +0000e020: 2073 6869 7368 6920 6861 6e64 6c65 2061   shishi handle a
│ │ │ │ +0000e030: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ +0000e040: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ +0000e050: 8099 2e0a 2020 2020 204b 4443 5245 513a  ....     KDCREQ:
│ │ │ │ +0000e060: 204b 4443 2d52 4551 2076 6172 6961 626c   KDC-REQ variabl
│ │ │ │ +0000e070: 6520 746f 2067 6574 206b 6463 2d6f 7074  e to get kdc-opt
│ │ │ │ +0000e080: 696f 6e73 2066 6965 6c64 2066 726f 6d2e  ions field from.
│ │ │ │ +0000e090: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ +0000e0a0: 696f 6e3a 2a20 4465 7465 726d 696e 6520  ion:* Determine 
│ │ │ │ +0000e0b0: 6966 204b 4443 2d4f 7074 696f 6e20 656e  if KDC-Option en
│ │ │ │ +0000e0c0: 632d 746b 742d 696e 2d73 6b65 7920 666c  c-tkt-in-skey fl
│ │ │ │ +0000e0d0: 6167 2069 7320 7365 742e 0a0a 2020 2020  ag is set...    
│ │ │ │ +0000e0e0: 2054 6869 7320 6f70 7469 6f6e 2069 7320   This option is 
│ │ │ │ +0000e0f0: 7573 6564 206f 6e6c 7920 6279 2074 6865  used only by the
│ │ │ │ +0000e100: 2074 6963 6b65 742d 6772 616e 7469 6e67   ticket-granting
│ │ │ │ +0000e110: 2073 6572 7669 6365 2e20 2054 6865 0a20   service.  The. 
│ │ │ │ +0000e120: 2020 2020 454e 432d 544b 542d 494e 2d53      ENC-TKT-IN-S
│ │ │ │ +0000e130: 4b45 5920 6f70 7469 6f6e 2069 6e64 6963  KEY option indic
│ │ │ │ +0000e140: 6174 6573 2074 6861 7420 7468 6520 7469  ates that the ti
│ │ │ │ +0000e150: 636b 6574 2066 6f72 2074 6865 2065 6e64  cket for the end
│ │ │ │ +0000e160: 2073 6572 7665 720a 2020 2020 2069 7320   server.     is 
│ │ │ │ +0000e170: 746f 2062 6520 656e 6372 7970 7465 6420  to be encrypted 
│ │ │ │ +0000e180: 696e 2074 6865 2073 6573 7369 6f6e 206b  in the session k
│ │ │ │ +0000e190: 6579 2066 726f 6d20 7468 6520 6164 6469  ey from the addi
│ │ │ │ +0000e1a0: 7469 6f6e 616c 0a20 2020 2020 7469 636b  tional.     tick
│ │ │ │ +0000e1b0: 6574 2d67 7261 6e74 696e 6720 7469 636b  et-granting tick
│ │ │ │ +0000e1c0: 6574 2070 726f 7669 6465 642e 0a0a 2020  et provided...  
│ │ │ │ +0000e1d0: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ +0000e1e0: 3a2a 2052 6574 7572 6e73 206e 6f6e 2d30  :* Returns non-0
│ │ │ │ +0000e1f0: 2069 6666 2065 6e63 2d74 6b74 2d69 6e2d   iff enc-tkt-in-
│ │ │ │ +0000e200: 736b 6579 2066 6c61 6720 6973 2073 6574  skey flag is set
│ │ │ │ +0000e210: 2069 6e0a 2020 2020 204b 4443 2d52 4551   in.     KDC-REQ
│ │ │ │ +0000e220: 2e0a 0a73 6869 7368 695f 6b64 6372 6571  ...shishi_kdcreq
│ │ │ │ +0000e230: 5f72 656e 6577 5f70 0a2d 2d2d 2d2d 2d2d  _renew_p.-------
│ │ │ │ +0000e240: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ +0000e250: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ +0000e260: 7420 7368 6973 6869 5f6b 6463 7265 715f  t shishi_kdcreq_
│ │ │ │ +0000e270: 7265 6e65 775f 7020 2853 6869 7368 6920  renew_p (Shishi 
│ │ │ │ +0000e280: 2a20 4841 4e44 4c45 2c0a 2020 2020 2020  * HANDLE,.      
│ │ │ │ +0000e290: 2020 2020 5368 6973 6869 5f61 736e 3120      Shishi_asn1 
│ │ │ │ +0000e2a0: 4b44 4352 4551 290a 2020 2020 2048 414e  KDCREQ).     HAN
│ │ │ │ +0000e2b0: 444c 453a 2073 6869 7368 6920 6861 6e64  DLE: shishi hand
│ │ │ │ +0000e2c0: 6c65 2061 7320 616c 6c6f 6361 7465 6420  le as allocated 
│ │ │ │ +0000e2d0: 6279 20e2 8098 7368 6973 6869 5f69 6e69  by ...shishi_ini
│ │ │ │ +0000e2e0: 7428 29e2 8099 2e0a 2020 2020 204b 4443  t().....     KDC
│ │ │ │ +0000e2f0: 5245 513a 204b 4443 2d52 4551 2076 6172  REQ: KDC-REQ var
│ │ │ │ +0000e300: 6961 626c 6520 746f 2067 6574 206b 6463  iable to get kdc
│ │ │ │ +0000e310: 2d6f 7074 696f 6e73 2066 6965 6c64 2066  -options field f
│ │ │ │ +0000e320: 726f 6d2e 0a0a 2020 2020 202a 4465 7363  rom...     *Desc
│ │ │ │ +0000e330: 7269 7074 696f 6e3a 2a20 4465 7465 726d  ription:* Determ
│ │ │ │ +0000e340: 696e 6520 6966 204b 4443 2d4f 7074 696f  ine if KDC-Optio
│ │ │ │ +0000e350: 6e20 7265 6e65 7720 666c 6167 2069 7320  n renew flag is 
│ │ │ │ +0000e360: 7365 742e 0a0a 2020 2020 2054 6869 7320  set...     This 
│ │ │ │ +0000e370: 6f70 7469 6f6e 2069 7320 7573 6564 206f  option is used o
│ │ │ │ +0000e380: 6e6c 7920 6279 2074 6865 2074 6963 6b65  nly by the ticke
│ │ │ │ +0000e390: 742d 6772 616e 7469 6e67 2073 6572 7669  t-granting servi
│ │ │ │ +0000e3a0: 6365 2e20 2054 6865 2052 454e 4557 0a20  ce.  The RENEW. 
│ │ │ │ +0000e3b0: 2020 2020 6f70 7469 6f6e 2069 6e64 6963      option indic
│ │ │ │ +0000e3c0: 6174 6573 2074 6861 7420 7468 6520 7072  ates that the pr
│ │ │ │ +0000e3d0: 6573 656e 7420 7265 7175 6573 7420 6973  esent request is
│ │ │ │ +0000e3e0: 2066 6f72 2061 2072 656e 6577 616c 2e20   for a renewal. 
│ │ │ │ +0000e3f0: 2054 6865 0a20 2020 2020 7469 636b 6574   The.     ticket
│ │ │ │ +0000e400: 2070 726f 7669 6465 6420 6973 2065 6e63   provided is enc
│ │ │ │ +0000e410: 7279 7074 6564 2069 6e20 7468 6520 7365  rypted in the se
│ │ │ │ +0000e420: 6372 6574 206b 6579 2066 6f72 2074 6865  cret key for the
│ │ │ │ +0000e430: 2073 6572 7665 7220 6f6e 0a20 2020 2020   server on.     
│ │ │ │ +0000e440: 7768 6963 6820 6974 2069 7320 7661 6c69  which it is vali
│ │ │ │ +0000e450: 642e 2020 5468 6973 206f 7074 696f 6e20  d.  This option 
│ │ │ │ +0000e460: 7769 6c6c 206f 6e6c 7920 6265 2068 6f6e  will only be hon
│ │ │ │ +0000e470: 6f72 6564 2069 6620 7468 6520 7469 636b  ored if the tick
│ │ │ │ +0000e480: 6574 0a20 2020 2020 746f 2062 6520 7265  et.     to be re
│ │ │ │ +0000e490: 6e65 7765 6420 6861 7320 6974 7320 5245  newed has its RE
│ │ │ │ +0000e4a0: 4e45 5741 424c 4520 666c 6167 2073 6574  NEWABLE flag set
│ │ │ │ +0000e4b0: 2061 6e64 2069 6620 7468 6520 7469 6d65   and if the time
│ │ │ │ +0000e4c0: 2069 6e20 6974 730a 2020 2020 2072 656e   in its.     ren
│ │ │ │ +0000e4d0: 6577 2d74 696c 6c20 6669 656c 6420 6861  ew-till field ha
│ │ │ │ +0000e4e0: 7320 6e6f 7420 7061 7373 6564 2e20 2054  s not passed.  T
│ │ │ │ +0000e4f0: 6865 2074 6963 6b65 7420 746f 2062 6520  he ticket to be 
│ │ │ │ +0000e500: 7265 6e65 7765 6420 6973 0a20 2020 2020  renewed is.     
│ │ │ │ +0000e510: 7061 7373 6564 2069 6e20 7468 6520 7061  passed in the pa
│ │ │ │ +0000e520: 6461 7461 2066 6965 6c64 2061 7320 7061  data field as pa
│ │ │ │ +0000e530: 7274 206f 6620 7468 6520 6175 7468 656e  rt of the authen
│ │ │ │ +0000e540: 7469 6361 7469 6f6e 2068 6561 6465 722e  tication header.
│ │ │ │ +0000e550: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ +0000e560: 616c 7565 3a2a 2052 6574 7572 6e73 206e  alue:* Returns n
│ │ │ │ +0000e570: 6f6e 2d30 2069 6666 2072 656e 6577 2066  on-0 iff renew f
│ │ │ │ +0000e580: 6c61 6720 6973 2073 6574 2069 6e20 4b44  lag is set in KD
│ │ │ │ +0000e590: 432d 5245 512e 0a0a 7368 6973 6869 5f6b  C-REQ...shishi_k
│ │ │ │ +0000e5a0: 6463 7265 715f 7661 6c69 6461 7465 5f70  dcreq_validate_p
│ │ │ │ +0000e5b0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ +0000e5c0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +0000e5d0: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ +0000e5e0: 7368 695f 6b64 6372 6571 5f76 616c 6964  shi_kdcreq_valid
│ │ │ │ +0000e5f0: 6174 655f 7020 2853 6869 7368 6920 2a20  ate_p (Shishi * 
│ │ │ │ +0000e600: 4841 4e44 4c45 2c0a 2020 2020 2020 2020  HANDLE,.        
│ │ │ │ +0000e610: 2020 5368 6973 6869 5f61 736e 3120 4b44    Shishi_asn1 KD
│ │ │ │ +0000e620: 4352 4551 290a 2020 2020 2048 414e 444c  CREQ).     HANDL
│ │ │ │ +0000e630: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ +0000e640: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ +0000e650: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ +0000e660: 29e2 8099 2e0a 2020 2020 204b 4443 5245  ).....     KDCRE
│ │ │ │ +0000e670: 513a 204b 4443 2d52 4551 2076 6172 6961  Q: KDC-REQ varia
│ │ │ │ +0000e680: 626c 6520 746f 2067 6574 206b 6463 2d6f  ble to get kdc-o
│ │ │ │ +0000e690: 7074 696f 6e73 2066 6965 6c64 2066 726f  ptions field fro
│ │ │ │ +0000e6a0: 6d2e 0a0a 2020 2020 202a 4465 7363 7269  m...     *Descri
│ │ │ │ +0000e6b0: 7074 696f 6e3a 2a20 4465 7465 726d 696e  ption:* Determin
│ │ │ │ +0000e6c0: 6520 6966 204b 4443 2d4f 7074 696f 6e20  e if KDC-Option 
│ │ │ │ +0000e6d0: 7661 6c69 6461 7465 2066 6c61 6720 6973  validate flag is
│ │ │ │ +0000e6e0: 2073 6574 2e0a 0a20 2020 2020 5468 6973   set...     This
│ │ │ │ +0000e6f0: 206f 7074 696f 6e20 6973 2075 7365 6420   option is used 
│ │ │ │ +0000e700: 6f6e 6c79 2062 7920 7468 6520 7469 636b  only by the tick
│ │ │ │ +0000e710: 6574 2d67 7261 6e74 696e 6720 7365 7276  et-granting serv
│ │ │ │ +0000e720: 6963 652e 2020 5468 650a 2020 2020 2056  ice.  The.     V
│ │ │ │ +0000e730: 414c 4944 4154 4520 6f70 7469 6f6e 2069  ALIDATE option i
│ │ │ │ +0000e740: 6e64 6963 6174 6573 2074 6861 7420 7468  ndicates that th
│ │ │ │ +0000e750: 6520 7265 7175 6573 7420 6973 2074 6f20  e request is to 
│ │ │ │ +0000e760: 7661 6c69 6461 7465 2061 0a20 2020 2020  validate a.     
│ │ │ │ +0000e770: 706f 7374 6461 7465 6420 7469 636b 6574  postdated ticket
│ │ │ │ +0000e780: 2e20 2049 7420 7769 6c6c 206f 6e6c 7920  .  It will only 
│ │ │ │ +0000e790: 6265 2068 6f6e 6f72 6564 2069 6620 7468  be honored if th
│ │ │ │ +0000e7a0: 6520 7469 636b 6574 2070 7265 7365 6e74  e ticket present
│ │ │ │ +0000e7b0: 6564 0a20 2020 2020 6973 2070 6f73 7464  ed.     is postd
│ │ │ │ +0000e7c0: 6174 6564 2c20 7072 6573 656e 746c 7920  ated, presently 
│ │ │ │ +0000e7d0: 6861 7320 6974 7320 494e 5641 4c49 4420  has its INVALID 
│ │ │ │ +0000e7e0: 666c 6167 2073 6574 2c20 616e 6420 776f  flag set, and wo
│ │ │ │ +0000e7f0: 756c 6420 6265 0a20 2020 2020 6f74 6865  uld be.     othe
│ │ │ │ +0000e800: 7277 6973 6520 7573 6162 6c65 2061 7420  rwise usable at 
│ │ │ │ +0000e810: 7468 6973 2074 696d 652e 2020 4120 7469  this time.  A ti
│ │ │ │ +0000e820: 636b 6574 2063 616e 6e6f 7420 6265 2076  cket cannot be v
│ │ │ │ +0000e830: 616c 6964 6174 6564 2062 6566 6f72 650a  alidated before.
│ │ │ │ +0000e840: 2020 2020 2069 7473 2073 7461 7274 7469       its startti
│ │ │ │ +0000e850: 6d65 2e20 2054 6865 2074 6963 6b65 7420  me.  The ticket 
│ │ │ │ +0000e860: 7072 6573 656e 7465 6420 666f 7220 7661  presented for va
│ │ │ │ +0000e870: 6c69 6461 7469 6f6e 2069 7320 656e 6372  lidation is encr
│ │ │ │ +0000e880: 7970 7465 6420 696e 0a20 2020 2020 7468  ypted in.     th
│ │ │ │ +0000e890: 6520 6b65 7920 6f66 2074 6865 2073 6572  e key of the ser
│ │ │ │ +0000e8a0: 7665 7220 666f 7220 7768 6963 6820 6974  ver for which it
│ │ │ │ +0000e8b0: 2069 7320 7661 6c69 6420 616e 6420 6973   is valid and is
│ │ │ │ +0000e8c0: 2070 6173 7365 6420 696e 2074 6865 0a20   passed in the. 
│ │ │ │ +0000e8d0: 2020 2020 7061 6461 7461 2066 6965 6c64      padata field
│ │ │ │ +0000e8e0: 2061 7320 7061 7274 206f 6620 7468 6520   as part of the 
│ │ │ │ +0000e8f0: 6175 7468 656e 7469 6361 7469 6f6e 2068  authentication h
│ │ │ │ +0000e900: 6561 6465 722e 0a0a 2020 2020 202a 5265  eader...     *Re
│ │ │ │ +0000e910: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ +0000e920: 7572 6e73 206e 6f6e 2d30 2069 6666 2076  urns non-0 iff v
│ │ │ │ +0000e930: 616c 6964 6174 6520 666c 6167 2069 7320  alidate flag is 
│ │ │ │ +0000e940: 7365 7420 696e 204b 4443 2d52 4551 2e0a  set in KDC-REQ..
│ │ │ │ +0000e950: 0a73 6869 7368 695f 6b64 6372 6571 5f6f  .shishi_kdcreq_o
│ │ │ │ +0000e960: 7074 696f 6e73 5f73 6574 0a2d 2d2d 2d2d  ptions_set.-----
│ │ │ │  0000e970: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0000e980: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ -0000e990: 6e3a 2069 6e74 2073 6869 7368 695f 6b64  n: int shishi_kd
│ │ │ │ -0000e9a0: 6372 6571 5f6f 7074 696f 6e73 5f73 6574  creq_options_set
│ │ │ │ -0000e9b0: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ -0000e9c0: 452c 0a20 2020 2020 2020 2020 2053 6869  E,.          Shi
│ │ │ │ -0000e9d0: 7368 695f 6173 6e31 204b 4443 5245 512c  shi_asn1 KDCREQ,
│ │ │ │ -0000e9e0: 2075 696e 7433 325f 7420 4f50 5449 4f4e   uint32_t OPTION
│ │ │ │ -0000e9f0: 5329 0a20 2020 2020 4841 4e44 4c45 3a20  S).     HANDLE: 
│ │ │ │ -0000ea00: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ -0000ea10: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ -0000ea20: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ -0000ea30: 992e 0a20 2020 2020 4b44 4352 4551 3a20  ...     KDCREQ: 
│ │ │ │ -0000ea40: 4b44 432d 5245 5120 7661 7269 6162 6c65  KDC-REQ variable
│ │ │ │ -0000ea50: 2074 6f20 7365 7420 6574 7970 6520 6669   to set etype fi
│ │ │ │ -0000ea60: 656c 6420 696e 2e0a 2020 2020 204f 5054  eld in..     OPT
│ │ │ │ -0000ea70: 494f 4e53 3a20 696e 7465 6765 7220 7769  IONS: integer wi
│ │ │ │ -0000ea80: 7468 2066 6c61 6773 2074 6f20 7374 6f72  th flags to stor
│ │ │ │ -0000ea90: 6520 696e 204b 4443 2d52 4551 2e0a 0a20  e in KDC-REQ... 
│ │ │ │ -0000eaa0: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -0000eab0: 3a2a 2053 6574 206f 7074 696f 6e73 2069  :* Set options i
│ │ │ │ -0000eac0: 6e20 4b44 432d 5245 512e 204e 6f74 6520  n KDC-REQ. Note 
│ │ │ │ -0000ead0: 7468 6174 2074 6869 7320 7265 7365 7420  that this reset 
│ │ │ │ -0000eae0: 616e 790a 2020 2020 2061 6c72 6561 6479  any.     already
│ │ │ │ -0000eaf0: 2065 7869 7374 696e 6720 666c 6167 732e   existing flags.
│ │ │ │ -0000eb00: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ -0000eb10: 616c 7565 3a2a 2052 6574 7572 6e73 2053  alue:* Returns S
│ │ │ │ -0000eb20: 4849 5348 495f 4f4b 2069 6666 2073 7563  HISHI_OK iff suc
│ │ │ │ -0000eb30: 6365 7373 6675 6c2e 0a0a 7368 6973 6869  cessful...shishi
│ │ │ │ -0000eb40: 5f6b 6463 7265 715f 6f70 7469 6f6e 735f  _kdcreq_options_
│ │ │ │ -0000eb50: 6164 640a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  add.------------
│ │ │ │ -0000eb60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -0000eb70: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ -0000eb80: 2073 6869 7368 695f 6b64 6372 6571 5f6f   shishi_kdcreq_o
│ │ │ │ -0000eb90: 7074 696f 6e73 5f61 6464 2028 5368 6973  ptions_add (Shis
│ │ │ │ -0000eba0: 6869 202a 2048 414e 444c 452c 0a20 2020  hi * HANDLE,.   
│ │ │ │ -0000ebb0: 2020 2020 2020 2053 6869 7368 695f 6173         Shishi_as
│ │ │ │ -0000ebc0: 6e31 204b 4443 5245 512c 2075 696e 7433  n1 KDCREQ, uint3
│ │ │ │ -0000ebd0: 325f 7420 4f50 5449 4f4e 290a 2020 2020  2_t OPTION).    
│ │ │ │ -0000ebe0: 2048 414e 444c 453a 2073 6869 7368 6920   HANDLE: shishi 
│ │ │ │ -0000ebf0: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ -0000ec00: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ -0000ec10: 5f69 6e69 7428 29e2 8099 2e0a 2020 2020  _init().....    
│ │ │ │ -0000ec20: 204b 4443 5245 513a 204b 4443 2d52 4551   KDCREQ: KDC-REQ
│ │ │ │ -0000ec30: 2076 6172 6961 626c 6520 746f 2073 6574   variable to set
│ │ │ │ -0000ec40: 2065 7479 7065 2066 6965 6c64 2069 6e2e   etype field in.
│ │ │ │ -0000ec50: 0a20 2020 2020 4f50 5449 4f4e 3a20 696e  .     OPTION: in
│ │ │ │ -0000ec60: 7465 6765 7220 7769 7468 206f 7074 696f  teger with optio
│ │ │ │ -0000ec70: 6e73 2074 6f20 6164 6420 696e 204b 4443  ns to add in KDC
│ │ │ │ -0000ec80: 2d52 4551 2e0a 0a20 2020 2020 2a44 6573  -REQ...     *Des
│ │ │ │ -0000ec90: 6372 6970 7469 6f6e 3a2a 2041 6464 204b  cription:* Add K
│ │ │ │ -0000eca0: 4443 2d4f 7074 696f 6e20 746f 204b 4443  DC-Option to KDC
│ │ │ │ -0000ecb0: 2d52 4551 2e20 5468 6973 2070 7265 7365  -REQ. This prese
│ │ │ │ -0000ecc0: 7276 6573 2061 6c6c 0a20 2020 2020 6578  rves all.     ex
│ │ │ │ -0000ecd0: 6973 7469 6e67 206f 7074 696f 6e73 2e0a  isting options..
│ │ │ │ -0000ece0: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ -0000ecf0: 6c75 653a 2a20 5265 7475 726e 7320 5348  lue:* Returns SH
│ │ │ │ -0000ed00: 4953 4849 5f4f 4b20 6966 6620 7375 6363  ISHI_OK iff succ
│ │ │ │ -0000ed10: 6573 7366 756c 2e0a 0a73 6869 7368 695f  essful...shishi_
│ │ │ │ -0000ed20: 6b64 6372 6571 5f63 6c65 6172 5f70 6164  kdcreq_clear_pad
│ │ │ │ -0000ed30: 6174 610a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ata.------------
│ │ │ │ -0000ed40: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -0000ed50: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ -0000ed60: 7420 7368 6973 6869 5f6b 6463 7265 715f  t shishi_kdcreq_
│ │ │ │ -0000ed70: 636c 6561 725f 7061 6461 7461 2028 5368  clear_padata (Sh
│ │ │ │ -0000ed80: 6973 6869 202a 2048 414e 444c 452c 0a20  ishi * HANDLE,. 
│ │ │ │ -0000ed90: 2020 2020 2020 2020 2053 6869 7368 695f           Shishi_
│ │ │ │ -0000eda0: 6173 6e31 204b 4443 5245 5129 0a20 2020  asn1 KDCREQ).   
│ │ │ │ -0000edb0: 2020 4841 4e44 4c45 3a20 7368 6973 6869    HANDLE: shishi
│ │ │ │ -0000edc0: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ -0000edd0: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ -0000ede0: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ -0000edf0: 2020 4b44 4352 4551 3a20 4b44 432d 5245    KDCREQ: KDC-RE
│ │ │ │ -0000ee00: 5120 746f 2072 656d 6f76 6520 5041 2d44  Q to remove PA-D
│ │ │ │ -0000ee10: 4154 4120 6672 6f6d 2e0a 0a20 2020 2020  ATA from...     
│ │ │ │ -0000ee20: 2a44 6573 6372 6970 7469 6f6e 3a2a 2052  *Description:* R
│ │ │ │ -0000ee30: 656d 6f76 6520 7468 6520 7061 6461 7461  emove the padata
│ │ │ │ -0000ee40: 2066 6965 6c64 2066 726f 6d20 4b44 432d   field from KDC-
│ │ │ │ -0000ee50: 5245 512e 0a0a 2020 2020 202a 5265 7475  REQ...     *Retu
│ │ │ │ -0000ee60: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ -0000ee70: 6e73 2053 4849 5348 495f 4f4b 2069 6666  ns SHISHI_OK iff
│ │ │ │ -0000ee80: 2073 7563 6365 7373 6675 6c2e 0a0a 7368   successful...sh
│ │ │ │ -0000ee90: 6973 6869 5f6b 6463 7265 715f 6765 745f  ishi_kdcreq_get_
│ │ │ │ -0000eea0: 7061 6461 7461 0a2d 2d2d 2d2d 2d2d 2d2d  padata.---------
│ │ │ │ -0000eeb0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -0000eec0: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ -0000eed0: 6e74 2073 6869 7368 695f 6b64 6372 6571  nt shishi_kdcreq
│ │ │ │ -0000eee0: 5f67 6574 5f70 6164 6174 6120 2853 6869  _get_padata (Shi
│ │ │ │ -0000eef0: 7368 6920 2a20 4841 4e44 4c45 2c0a 2020  shi * HANDLE,.  
│ │ │ │ -0000ef00: 2020 2020 2020 2020 5368 6973 6869 5f61          Shishi_a
│ │ │ │ -0000ef10: 736e 3120 4b44 4352 4551 2c20 5368 6973  sn1 KDCREQ, Shis
│ │ │ │ -0000ef20: 6869 5f70 6164 6174 615f 7479 7065 2050  hi_padata_type P
│ │ │ │ -0000ef30: 4144 4154 4154 5950 452c 0a20 2020 2020  ADATATYPE,.     
│ │ │ │ -0000ef40: 2020 2020 2063 6861 7220 2a2a 204f 5554       char ** OUT
│ │ │ │ -0000ef50: 2c20 7369 7a65 5f74 202a 204f 5554 4c45  , size_t * OUTLE
│ │ │ │ -0000ef60: 4e29 0a20 2020 2020 4841 4e44 4c45 3a20  N).     HANDLE: 
│ │ │ │ -0000ef70: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ -0000ef80: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ -0000ef90: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ -0000efa0: 992e 0a20 2020 2020 4b44 4352 4551 3a20  ...     KDCREQ: 
│ │ │ │ -0000efb0: 4b44 432d 5245 5120 746f 2067 6574 2050  KDC-REQ to get P
│ │ │ │ -0000efc0: 412d 4441 5441 2066 726f 6d2e 0a20 2020  A-DATA from..   
│ │ │ │ -0000efd0: 2020 5041 4441 5441 5459 5045 3a20 7479    PADATATYPE: ty
│ │ │ │ -0000efe0: 7065 206f 6620 5041 2d44 4154 412c 2073  pe of PA-DATA, s
│ │ │ │ -0000eff0: 6565 2053 6869 7368 695f 7061 6461 7461  ee Shishi_padata
│ │ │ │ -0000f000: 5f74 7970 652e 0a20 2020 2020 4f55 543a  _type..     OUT:
│ │ │ │ -0000f010: 206f 7574 7075 7420 6172 7261 7920 7769   output array wi
│ │ │ │ -0000f020: 7468 206e 6577 6c79 2061 6c6c 6f63 6174  th newly allocat
│ │ │ │ -0000f030: 6564 2050 412d 4441 5441 2076 616c 7565  ed PA-DATA value
│ │ │ │ -0000f040: 2e0a 2020 2020 204f 5554 4c45 4e3a 2073  ..     OUTLEN: s
│ │ │ │ -0000f050: 697a 6520 6f66 206f 7574 7075 7420 6172  ize of output ar
│ │ │ │ -0000f060: 7261 7920 7769 7468 2050 412d 4441 5441  ray with PA-DATA
│ │ │ │ -0000f070: 2076 616c 7565 2e0a 0a20 2020 2020 2a44   value...     *D
│ │ │ │ -0000f080: 6573 6372 6970 7469 6f6e 3a2a 2047 6574  escription:* Get
│ │ │ │ -0000f090: 2070 7265 2061 7574 6865 6e74 6963 6174   pre authenticat
│ │ │ │ -0000f0a0: 696f 6e20 6461 7461 2028 5041 2d44 4154  ion data (PA-DAT
│ │ │ │ -0000f0b0: 4129 2066 726f 6d20 4b44 432d 5245 512e  A) from KDC-REQ.
│ │ │ │ -0000f0c0: 0a20 2020 2020 5072 6520 6175 7468 656e  .     Pre authen
│ │ │ │ -0000f0d0: 7469 6361 7469 6f6e 2064 6174 6120 6973  tication data is
│ │ │ │ -0000f0e0: 2075 7365 6420 746f 2070 6173 7320 7661   used to pass va
│ │ │ │ -0000f0f0: 7269 6f75 7320 696e 666f 726d 6174 696f  rious informatio
│ │ │ │ -0000f100: 6e20 746f 204b 4443 2c0a 2020 2020 2073  n to KDC,.     s
│ │ │ │ -0000f110: 7563 6820 6173 2069 6e20 6361 7365 206f  uch as in case o
│ │ │ │ -0000f120: 6620 6120 5348 4953 4849 5f50 415f 5447  f a SHISHI_PA_TG
│ │ │ │ -0000f130: 535f 5245 5120 7061 6461 7461 7479 7065  S_REQ padatatype
│ │ │ │ -0000f140: 2074 6865 2041 502d 5245 5120 7468 6174   the AP-REQ that
│ │ │ │ -0000f150: 0a20 2020 2020 6175 7468 656e 7469 6361  .     authentica
│ │ │ │ -0000f160: 7465 7320 7468 6520 7573 6572 2074 6f20  tes the user to 
│ │ │ │ -0000f170: 6765 7420 7468 6520 7469 636b 6574 2e0a  get the ticket..
│ │ │ │ -0000f180: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ -0000f190: 6c75 653a 2a20 5265 7475 726e 7320 5348  lue:* Returns SH
│ │ │ │ -0000f1a0: 4953 4849 5f4f 4b20 6966 6620 7375 6363  ISHI_OK iff succ
│ │ │ │ -0000f1b0: 6573 7366 756c 2e0a 0a73 6869 7368 695f  essful...shishi_
│ │ │ │ -0000f1c0: 6b64 6372 6571 5f67 6574 5f70 6164 6174  kdcreq_get_padat
│ │ │ │ -0000f1d0: 615f 7467 730a 2d2d 2d2d 2d2d 2d2d 2d2d  a_tgs.----------
│ │ │ │ +0000e980: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ +0000e990: 6f6e 3a20 696e 7420 7368 6973 6869 5f6b  on: int shishi_k
│ │ │ │ +0000e9a0: 6463 7265 715f 6f70 7469 6f6e 735f 7365  dcreq_options_se
│ │ │ │ +0000e9b0: 7420 2853 6869 7368 6920 2a20 4841 4e44  t (Shishi * HAND
│ │ │ │ +0000e9c0: 4c45 2c0a 2020 2020 2020 2020 2020 5368  LE,.          Sh
│ │ │ │ +0000e9d0: 6973 6869 5f61 736e 3120 4b44 4352 4551  ishi_asn1 KDCREQ
│ │ │ │ +0000e9e0: 2c20 7569 6e74 3332 5f74 204f 5054 494f  , uint32_t OPTIO
│ │ │ │ +0000e9f0: 4e53 290a 2020 2020 2048 414e 444c 453a  NS).     HANDLE:
│ │ │ │ +0000ea00: 2073 6869 7368 6920 6861 6e64 6c65 2061   shishi handle a
│ │ │ │ +0000ea10: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ +0000ea20: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ +0000ea30: 8099 2e0a 2020 2020 204b 4443 5245 513a  ....     KDCREQ:
│ │ │ │ +0000ea40: 204b 4443 2d52 4551 2076 6172 6961 626c   KDC-REQ variabl
│ │ │ │ +0000ea50: 6520 746f 2073 6574 2065 7479 7065 2066  e to set etype f
│ │ │ │ +0000ea60: 6965 6c64 2069 6e2e 0a20 2020 2020 4f50  ield in..     OP
│ │ │ │ +0000ea70: 5449 4f4e 533a 2069 6e74 6567 6572 2077  TIONS: integer w
│ │ │ │ +0000ea80: 6974 6820 666c 6167 7320 746f 2073 746f  ith flags to sto
│ │ │ │ +0000ea90: 7265 2069 6e20 4b44 432d 5245 512e 0a0a  re in KDC-REQ...
│ │ │ │ +0000eaa0: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ +0000eab0: 6e3a 2a20 5365 7420 6f70 7469 6f6e 7320  n:* Set options 
│ │ │ │ +0000eac0: 696e 204b 4443 2d52 4551 2e20 4e6f 7465  in KDC-REQ. Note
│ │ │ │ +0000ead0: 2074 6861 7420 7468 6973 2072 6573 6574   that this reset
│ │ │ │ +0000eae0: 2061 6e79 0a20 2020 2020 616c 7265 6164   any.     alread
│ │ │ │ +0000eaf0: 7920 6578 6973 7469 6e67 2066 6c61 6773  y existing flags
│ │ │ │ +0000eb00: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ +0000eb10: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ +0000eb20: 5348 4953 4849 5f4f 4b20 6966 6620 7375  SHISHI_OK iff su
│ │ │ │ +0000eb30: 6363 6573 7366 756c 2e0a 0a73 6869 7368  ccessful...shish
│ │ │ │ +0000eb40: 695f 6b64 6372 6571 5f6f 7074 696f 6e73  i_kdcreq_options
│ │ │ │ +0000eb50: 5f61 6464 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  _add.-----------
│ │ │ │ +0000eb60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ +0000eb70: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ +0000eb80: 7420 7368 6973 6869 5f6b 6463 7265 715f  t shishi_kdcreq_
│ │ │ │ +0000eb90: 6f70 7469 6f6e 735f 6164 6420 2853 6869  options_add (Shi
│ │ │ │ +0000eba0: 7368 6920 2a20 4841 4e44 4c45 2c0a 2020  shi * HANDLE,.  
│ │ │ │ +0000ebb0: 2020 2020 2020 2020 5368 6973 6869 5f61          Shishi_a
│ │ │ │ +0000ebc0: 736e 3120 4b44 4352 4551 2c20 7569 6e74  sn1 KDCREQ, uint
│ │ │ │ +0000ebd0: 3332 5f74 204f 5054 494f 4e29 0a20 2020  32_t OPTION).   
│ │ │ │ +0000ebe0: 2020 4841 4e44 4c45 3a20 7368 6973 6869    HANDLE: shishi
│ │ │ │ +0000ebf0: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ +0000ec00: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ +0000ec10: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ +0000ec20: 2020 4b44 4352 4551 3a20 4b44 432d 5245    KDCREQ: KDC-RE
│ │ │ │ +0000ec30: 5120 7661 7269 6162 6c65 2074 6f20 7365  Q variable to se
│ │ │ │ +0000ec40: 7420 6574 7970 6520 6669 656c 6420 696e  t etype field in
│ │ │ │ +0000ec50: 2e0a 2020 2020 204f 5054 494f 4e3a 2069  ..     OPTION: i
│ │ │ │ +0000ec60: 6e74 6567 6572 2077 6974 6820 6f70 7469  nteger with opti
│ │ │ │ +0000ec70: 6f6e 7320 746f 2061 6464 2069 6e20 4b44  ons to add in KD
│ │ │ │ +0000ec80: 432d 5245 512e 0a0a 2020 2020 202a 4465  C-REQ...     *De
│ │ │ │ +0000ec90: 7363 7269 7074 696f 6e3a 2a20 4164 6420  scription:* Add 
│ │ │ │ +0000eca0: 4b44 432d 4f70 7469 6f6e 2074 6f20 4b44  KDC-Option to KD
│ │ │ │ +0000ecb0: 432d 5245 512e 2054 6869 7320 7072 6573  C-REQ. This pres
│ │ │ │ +0000ecc0: 6572 7665 7320 616c 6c0a 2020 2020 2065  erves all.     e
│ │ │ │ +0000ecd0: 7869 7374 696e 6720 6f70 7469 6f6e 732e  xisting options.
│ │ │ │ +0000ece0: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ +0000ecf0: 616c 7565 3a2a 2052 6574 7572 6e73 2053  alue:* Returns S
│ │ │ │ +0000ed00: 4849 5348 495f 4f4b 2069 6666 2073 7563  HISHI_OK iff suc
│ │ │ │ +0000ed10: 6365 7373 6675 6c2e 0a0a 7368 6973 6869  cessful...shishi
│ │ │ │ +0000ed20: 5f6b 6463 7265 715f 636c 6561 725f 7061  _kdcreq_clear_pa
│ │ │ │ +0000ed30: 6461 7461 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  data.-----------
│ │ │ │ +0000ed40: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +0000ed50: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ +0000ed60: 6e74 2073 6869 7368 695f 6b64 6372 6571  nt shishi_kdcreq
│ │ │ │ +0000ed70: 5f63 6c65 6172 5f70 6164 6174 6120 2853  _clear_padata (S
│ │ │ │ +0000ed80: 6869 7368 6920 2a20 4841 4e44 4c45 2c0a  hishi * HANDLE,.
│ │ │ │ +0000ed90: 2020 2020 2020 2020 2020 5368 6973 6869            Shishi
│ │ │ │ +0000eda0: 5f61 736e 3120 4b44 4352 4551 290a 2020  _asn1 KDCREQ).  
│ │ │ │ +0000edb0: 2020 2048 414e 444c 453a 2073 6869 7368     HANDLE: shish
│ │ │ │ +0000edc0: 6920 6861 6e64 6c65 2061 7320 616c 6c6f  i handle as allo
│ │ │ │ +0000edd0: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ +0000ede0: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ +0000edf0: 2020 204b 4443 5245 513a 204b 4443 2d52     KDCREQ: KDC-R
│ │ │ │ +0000ee00: 4551 2074 6f20 7265 6d6f 7665 2050 412d  EQ to remove PA-
│ │ │ │ +0000ee10: 4441 5441 2066 726f 6d2e 0a0a 2020 2020  DATA from...    
│ │ │ │ +0000ee20: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ +0000ee30: 5265 6d6f 7665 2074 6865 2070 6164 6174  Remove the padat
│ │ │ │ +0000ee40: 6120 6669 656c 6420 6672 6f6d 204b 4443  a field from KDC
│ │ │ │ +0000ee50: 2d52 4551 2e0a 0a20 2020 2020 2a52 6574  -REQ...     *Ret
│ │ │ │ +0000ee60: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ +0000ee70: 726e 7320 5348 4953 4849 5f4f 4b20 6966  rns SHISHI_OK if
│ │ │ │ +0000ee80: 6620 7375 6363 6573 7366 756c 2e0a 0a73  f successful...s
│ │ │ │ +0000ee90: 6869 7368 695f 6b64 6372 6571 5f67 6574  hishi_kdcreq_get
│ │ │ │ +0000eea0: 5f70 6164 6174 610a 2d2d 2d2d 2d2d 2d2d  _padata.--------
│ │ │ │ +0000eeb0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +0000eec0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +0000eed0: 696e 7420 7368 6973 6869 5f6b 6463 7265  int shishi_kdcre
│ │ │ │ +0000eee0: 715f 6765 745f 7061 6461 7461 2028 5368  q_get_padata (Sh
│ │ │ │ +0000eef0: 6973 6869 202a 2048 414e 444c 452c 0a20  ishi * HANDLE,. 
│ │ │ │ +0000ef00: 2020 2020 2020 2020 2053 6869 7368 695f           Shishi_
│ │ │ │ +0000ef10: 6173 6e31 204b 4443 5245 512c 2053 6869  asn1 KDCREQ, Shi
│ │ │ │ +0000ef20: 7368 695f 7061 6461 7461 5f74 7970 6520  shi_padata_type 
│ │ │ │ +0000ef30: 5041 4441 5441 5459 5045 2c0a 2020 2020  PADATATYPE,.    
│ │ │ │ +0000ef40: 2020 2020 2020 6368 6172 202a 2a20 4f55        char ** OU
│ │ │ │ +0000ef50: 542c 2073 697a 655f 7420 2a20 4f55 544c  T, size_t * OUTL
│ │ │ │ +0000ef60: 454e 290a 2020 2020 2048 414e 444c 453a  EN).     HANDLE:
│ │ │ │ +0000ef70: 2073 6869 7368 6920 6861 6e64 6c65 2061   shishi handle a
│ │ │ │ +0000ef80: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ +0000ef90: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ +0000efa0: 8099 2e0a 2020 2020 204b 4443 5245 513a  ....     KDCREQ:
│ │ │ │ +0000efb0: 204b 4443 2d52 4551 2074 6f20 6765 7420   KDC-REQ to get 
│ │ │ │ +0000efc0: 5041 2d44 4154 4120 6672 6f6d 2e0a 2020  PA-DATA from..  
│ │ │ │ +0000efd0: 2020 2050 4144 4154 4154 5950 453a 2074     PADATATYPE: t
│ │ │ │ +0000efe0: 7970 6520 6f66 2050 412d 4441 5441 2c20  ype of PA-DATA, 
│ │ │ │ +0000eff0: 7365 6520 5368 6973 6869 5f70 6164 6174  see Shishi_padat
│ │ │ │ +0000f000: 615f 7479 7065 2e0a 2020 2020 204f 5554  a_type..     OUT
│ │ │ │ +0000f010: 3a20 6f75 7470 7574 2061 7272 6179 2077  : output array w
│ │ │ │ +0000f020: 6974 6820 6e65 776c 7920 616c 6c6f 6361  ith newly alloca
│ │ │ │ +0000f030: 7465 6420 5041 2d44 4154 4120 7661 6c75  ted PA-DATA valu
│ │ │ │ +0000f040: 652e 0a20 2020 2020 4f55 544c 454e 3a20  e..     OUTLEN: 
│ │ │ │ +0000f050: 7369 7a65 206f 6620 6f75 7470 7574 2061  size of output a
│ │ │ │ +0000f060: 7272 6179 2077 6974 6820 5041 2d44 4154  rray with PA-DAT
│ │ │ │ +0000f070: 4120 7661 6c75 652e 0a0a 2020 2020 202a  A value...     *
│ │ │ │ +0000f080: 4465 7363 7269 7074 696f 6e3a 2a20 4765  Description:* Ge
│ │ │ │ +0000f090: 7420 7072 6520 6175 7468 656e 7469 6361  t pre authentica
│ │ │ │ +0000f0a0: 7469 6f6e 2064 6174 6120 2850 412d 4441  tion data (PA-DA
│ │ │ │ +0000f0b0: 5441 2920 6672 6f6d 204b 4443 2d52 4551  TA) from KDC-REQ
│ │ │ │ +0000f0c0: 2e0a 2020 2020 2050 7265 2061 7574 6865  ..     Pre authe
│ │ │ │ +0000f0d0: 6e74 6963 6174 696f 6e20 6461 7461 2069  ntication data i
│ │ │ │ +0000f0e0: 7320 7573 6564 2074 6f20 7061 7373 2076  s used to pass v
│ │ │ │ +0000f0f0: 6172 696f 7573 2069 6e66 6f72 6d61 7469  arious informati
│ │ │ │ +0000f100: 6f6e 2074 6f20 4b44 432c 0a20 2020 2020  on to KDC,.     
│ │ │ │ +0000f110: 7375 6368 2061 7320 696e 2063 6173 6520  such as in case 
│ │ │ │ +0000f120: 6f66 2061 2053 4849 5348 495f 5041 5f54  of a SHISHI_PA_T
│ │ │ │ +0000f130: 4753 5f52 4551 2070 6164 6174 6174 7970  GS_REQ padatatyp
│ │ │ │ +0000f140: 6520 7468 6520 4150 2d52 4551 2074 6861  e the AP-REQ tha
│ │ │ │ +0000f150: 740a 2020 2020 2061 7574 6865 6e74 6963  t.     authentic
│ │ │ │ +0000f160: 6174 6573 2074 6865 2075 7365 7220 746f  ates the user to
│ │ │ │ +0000f170: 2067 6574 2074 6865 2074 6963 6b65 742e   get the ticket.
│ │ │ │ +0000f180: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ +0000f190: 616c 7565 3a2a 2052 6574 7572 6e73 2053  alue:* Returns S
│ │ │ │ +0000f1a0: 4849 5348 495f 4f4b 2069 6666 2073 7563  HISHI_OK iff suc
│ │ │ │ +0000f1b0: 6365 7373 6675 6c2e 0a0a 7368 6973 6869  cessful...shishi
│ │ │ │ +0000f1c0: 5f6b 6463 7265 715f 6765 745f 7061 6461  _kdcreq_get_pada
│ │ │ │ +0000f1d0: 7461 5f74 6773 0a2d 2d2d 2d2d 2d2d 2d2d  ta_tgs.---------
│ │ │ │  0000f1e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0000f1f0: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ -0000f200: 3a20 696e 7420 7368 6973 6869 5f6b 6463  : int shishi_kdc
│ │ │ │ -0000f210: 7265 715f 6765 745f 7061 6461 7461 5f74  req_get_padata_t
│ │ │ │ -0000f220: 6773 2028 5368 6973 6869 202a 2048 414e  gs (Shishi * HAN
│ │ │ │ -0000f230: 444c 452c 0a20 2020 2020 2020 2020 2053  DLE,.          S
│ │ │ │ -0000f240: 6869 7368 695f 6173 6e31 204b 4443 5245  hishi_asn1 KDCRE
│ │ │ │ -0000f250: 512c 2053 6869 7368 695f 6173 6e31 202a  Q, Shishi_asn1 *
│ │ │ │ -0000f260: 2041 5052 4551 290a 2020 2020 2048 414e   APREQ).     HAN
│ │ │ │ -0000f270: 444c 453a 2073 6869 7368 6920 6861 6e64  DLE: shishi hand
│ │ │ │ -0000f280: 6c65 2061 7320 616c 6c6f 6361 7465 6420  le as allocated 
│ │ │ │ -0000f290: 6279 20e2 8098 7368 6973 6869 5f69 6e69  by ...shishi_ini
│ │ │ │ -0000f2a0: 7428 29e2 8099 2e0a 2020 2020 204b 4443  t().....     KDC
│ │ │ │ -0000f2b0: 5245 513a 204b 4443 2d52 4551 2074 6f20  REQ: KDC-REQ to 
│ │ │ │ -0000f2c0: 6765 7420 5041 2d54 4753 2d52 4551 2066  get PA-TGS-REQ f
│ │ │ │ -0000f2d0: 726f 6d2e 0a20 2020 2020 4150 5245 513a  rom..     APREQ:
│ │ │ │ -0000f2e0: 204f 7574 7075 7420 7661 7269 6162 6c65   Output variable
│ │ │ │ -0000f2f0: 2077 6974 6820 6e65 776c 7920 616c 6c6f   with newly allo
│ │ │ │ -0000f300: 6361 7465 6420 4150 2d52 4551 2e0a 0a20  cated AP-REQ... 
│ │ │ │ -0000f310: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -0000f320: 3a2a 2045 7874 7261 6374 2054 4753 2070  :* Extract TGS p
│ │ │ │ -0000f330: 7265 2d61 7574 6865 6e74 6963 6174 696f  re-authenticatio
│ │ │ │ -0000f340: 6e20 6461 7461 2066 726f 6d20 4b44 432d  n data from KDC-
│ │ │ │ -0000f350: 5245 512e 0a20 2020 2020 5468 6520 6461  REQ..     The da
│ │ │ │ -0000f360: 7461 2069 7320 616e 2041 502d 5245 5120  ta is an AP-REQ 
│ │ │ │ -0000f370: 7468 6174 2061 7574 6865 6e74 6963 6174  that authenticat
│ │ │ │ -0000f380: 6573 2074 6865 2072 6571 7565 7374 2e20  es the request. 
│ │ │ │ -0000f390: 2054 6869 730a 2020 2020 2066 756e 6374   This.     funct
│ │ │ │ -0000f3a0: 696f 6e20 6361 6c6c 20e2 8098 7368 6973  ion call ...shis
│ │ │ │ -0000f3b0: 6869 5f6b 6463 7265 715f 6765 745f 7061  hi_kdcreq_get_pa
│ │ │ │ -0000f3c0: 6461 7461 2829 e280 9920 7769 7468 2061  data()... with a
│ │ │ │ -0000f3d0: 2053 4849 5348 495f 5041 5f54 4753 5f52   SHISHI_PA_TGS_R
│ │ │ │ -0000f3e0: 4551 0a20 2020 2020 7061 6461 7461 7479  EQ.     padataty
│ │ │ │ -0000f3f0: 7065 2061 6e64 2044 4552 2064 6563 6f64  pe and DER decod
│ │ │ │ -0000f400: 6520 7468 6520 7265 7375 6c74 2028 6966  e the result (if
│ │ │ │ -0000f410: 2061 6e79 292e 0a0a 2020 2020 202a 5265   any)...     *Re
│ │ │ │ -0000f420: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ -0000f430: 7572 6e73 2053 4849 5348 495f 4f4b 2069  urns SHISHI_OK i
│ │ │ │ -0000f440: 6666 2073 7563 6365 7373 6675 6c2e 0a0a  ff successful...
│ │ │ │ -0000f450: 7368 6973 6869 5f6b 6463 7265 715f 6164  shishi_kdcreq_ad
│ │ │ │ -0000f460: 645f 7061 6461 7461 0a2d 2d2d 2d2d 2d2d  d_padata.-------
│ │ │ │ +0000f1f0: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ +0000f200: 6e3a 2069 6e74 2073 6869 7368 695f 6b64  n: int shishi_kd
│ │ │ │ +0000f210: 6372 6571 5f67 6574 5f70 6164 6174 615f  creq_get_padata_
│ │ │ │ +0000f220: 7467 7320 2853 6869 7368 6920 2a20 4841  tgs (Shishi * HA
│ │ │ │ +0000f230: 4e44 4c45 2c0a 2020 2020 2020 2020 2020  NDLE,.          
│ │ │ │ +0000f240: 5368 6973 6869 5f61 736e 3120 4b44 4352  Shishi_asn1 KDCR
│ │ │ │ +0000f250: 4551 2c20 5368 6973 6869 5f61 736e 3120  EQ, Shishi_asn1 
│ │ │ │ +0000f260: 2a20 4150 5245 5129 0a20 2020 2020 4841  * APREQ).     HA
│ │ │ │ +0000f270: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ +0000f280: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ +0000f290: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ +0000f2a0: 6974 2829 e280 992e 0a20 2020 2020 4b44  it().....     KD
│ │ │ │ +0000f2b0: 4352 4551 3a20 4b44 432d 5245 5120 746f  CREQ: KDC-REQ to
│ │ │ │ +0000f2c0: 2067 6574 2050 412d 5447 532d 5245 5120   get PA-TGS-REQ 
│ │ │ │ +0000f2d0: 6672 6f6d 2e0a 2020 2020 2041 5052 4551  from..     APREQ
│ │ │ │ +0000f2e0: 3a20 4f75 7470 7574 2076 6172 6961 626c  : Output variabl
│ │ │ │ +0000f2f0: 6520 7769 7468 206e 6577 6c79 2061 6c6c  e with newly all
│ │ │ │ +0000f300: 6f63 6174 6564 2041 502d 5245 512e 0a0a  ocated AP-REQ...
│ │ │ │ +0000f310: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ +0000f320: 6e3a 2a20 4578 7472 6163 7420 5447 5320  n:* Extract TGS 
│ │ │ │ +0000f330: 7072 652d 6175 7468 656e 7469 6361 7469  pre-authenticati
│ │ │ │ +0000f340: 6f6e 2064 6174 6120 6672 6f6d 204b 4443  on data from KDC
│ │ │ │ +0000f350: 2d52 4551 2e0a 2020 2020 2054 6865 2064  -REQ..     The d
│ │ │ │ +0000f360: 6174 6120 6973 2061 6e20 4150 2d52 4551  ata is an AP-REQ
│ │ │ │ +0000f370: 2074 6861 7420 6175 7468 656e 7469 6361   that authentica
│ │ │ │ +0000f380: 7465 7320 7468 6520 7265 7175 6573 742e  tes the request.
│ │ │ │ +0000f390: 2020 5468 6973 0a20 2020 2020 6675 6e63    This.     func
│ │ │ │ +0000f3a0: 7469 6f6e 2063 616c 6c20 e280 9873 6869  tion call ...shi
│ │ │ │ +0000f3b0: 7368 695f 6b64 6372 6571 5f67 6574 5f70  shi_kdcreq_get_p
│ │ │ │ +0000f3c0: 6164 6174 6128 29e2 8099 2077 6974 6820  adata()... with 
│ │ │ │ +0000f3d0: 6120 5348 4953 4849 5f50 415f 5447 535f  a SHISHI_PA_TGS_
│ │ │ │ +0000f3e0: 5245 510a 2020 2020 2070 6164 6174 6174  REQ.     padatat
│ │ │ │ +0000f3f0: 7970 6520 616e 6420 4445 5220 6465 636f  ype and DER deco
│ │ │ │ +0000f400: 6465 2074 6865 2072 6573 756c 7420 2869  de the result (i
│ │ │ │ +0000f410: 6620 616e 7929 2e0a 0a20 2020 2020 2a52  f any)...     *R
│ │ │ │ +0000f420: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +0000f430: 7475 726e 7320 5348 4953 4849 5f4f 4b20  turns SHISHI_OK 
│ │ │ │ +0000f440: 6966 6620 7375 6363 6573 7366 756c 2e0a  iff successful..
│ │ │ │ +0000f450: 0a73 6869 7368 695f 6b64 6372 6571 5f61  .shishi_kdcreq_a
│ │ │ │ +0000f460: 6464 5f70 6164 6174 610a 2d2d 2d2d 2d2d  dd_padata.------
│ │ │ │  0000f470: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0000f480: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ -0000f490: 2069 6e74 2073 6869 7368 695f 6b64 6372   int shishi_kdcr
│ │ │ │ -0000f4a0: 6571 5f61 6464 5f70 6164 6174 6120 2853  eq_add_padata (S
│ │ │ │ -0000f4b0: 6869 7368 6920 2a20 4841 4e44 4c45 2c0a  hishi * HANDLE,.
│ │ │ │ -0000f4c0: 2020 2020 2020 2020 2020 5368 6973 6869            Shishi
│ │ │ │ -0000f4d0: 5f61 736e 3120 4b44 4352 4551 2c20 696e  _asn1 KDCREQ, in
│ │ │ │ -0000f4e0: 7420 5041 4441 5441 5459 5045 2c20 636f  t PADATATYPE, co
│ │ │ │ -0000f4f0: 6e73 7420 6368 6172 202a 2044 4154 412c  nst char * DATA,
│ │ │ │ -0000f500: 0a20 2020 2020 2020 2020 2073 697a 655f  .          size_
│ │ │ │ -0000f510: 7420 4441 5441 4c45 4e29 0a20 2020 2020  t DATALEN).     
│ │ │ │ -0000f520: 4841 4e44 4c45 3a20 7368 6973 6869 2068  HANDLE: shishi h
│ │ │ │ -0000f530: 616e 646c 6520 6173 2061 6c6c 6f63 6174  andle as allocat
│ │ │ │ -0000f540: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ -0000f550: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ -0000f560: 4b44 4352 4551 3a20 4b44 432d 5245 5120  KDCREQ: KDC-REQ 
│ │ │ │ -0000f570: 746f 2061 6464 2050 412d 4441 5441 2074  to add PA-DATA t
│ │ │ │ -0000f580: 6f2e 0a20 2020 2020 5041 4441 5441 5459  o..     PADATATY
│ │ │ │ -0000f590: 5045 3a20 7479 7065 206f 6620 5041 2d44  PE: type of PA-D
│ │ │ │ -0000f5a0: 4154 412c 2073 6565 2053 6869 7368 695f  ATA, see Shishi_
│ │ │ │ -0000f5b0: 7061 6461 7461 5f74 7970 652e 0a20 2020  padata_type..   
│ │ │ │ -0000f5c0: 2020 4441 5441 3a20 696e 7075 7420 6172    DATA: input ar
│ │ │ │ -0000f5d0: 7261 7920 7769 7468 2050 412d 4441 5441  ray with PA-DATA
│ │ │ │ -0000f5e0: 2076 616c 7565 2e0a 2020 2020 2044 4154   value..     DAT
│ │ │ │ -0000f5f0: 414c 454e 3a20 7369 7a65 206f 6620 696e  ALEN: size of in
│ │ │ │ -0000f600: 7075 7420 6172 7261 7920 7769 7468 2050  put array with P
│ │ │ │ -0000f610: 412d 4441 5441 2076 616c 7565 2e0a 0a20  A-DATA value... 
│ │ │ │ -0000f620: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -0000f630: 3a2a 2041 6464 206e 6577 2070 7265 2061  :* Add new pre a
│ │ │ │ -0000f640: 7574 6865 6e74 6963 6174 696f 6e20 6461  uthentication da
│ │ │ │ -0000f650: 7461 2028 5041 2d44 4154 4129 2074 6f0a  ta (PA-DATA) to.
│ │ │ │ -0000f660: 2020 2020 204b 4443 2d52 4551 2e20 2054       KDC-REQ.  T
│ │ │ │ -0000f670: 6869 7320 6973 2075 7365 6420 746f 2070  his is used to p
│ │ │ │ -0000f680: 6173 7320 7661 7269 6f75 7320 696e 666f  ass various info
│ │ │ │ -0000f690: 726d 6174 696f 6e20 746f 204b 4443 2c20  rmation to KDC, 
│ │ │ │ -0000f6a0: 7375 6368 2061 730a 2020 2020 2069 6e20  such as.     in 
│ │ │ │ -0000f6b0: 6361 7365 206f 6620 6120 5348 4953 4849  case of a SHISHI
│ │ │ │ -0000f6c0: 5f50 415f 5447 535f 5245 5120 7061 6461  _PA_TGS_REQ pada
│ │ │ │ -0000f6d0: 7461 7479 7065 2074 6865 2041 502d 5245  tatype the AP-RE
│ │ │ │ -0000f6e0: 5120 7468 6174 0a20 2020 2020 6175 7468  Q that.     auth
│ │ │ │ -0000f6f0: 656e 7469 6361 7465 7320 7468 6520 7573  enticates the us
│ │ │ │ -0000f700: 6572 2074 6f20 6765 7420 7468 6520 7469  er to get the ti
│ │ │ │ -0000f710: 636b 6574 2e20 2028 4275 7420 616c 736f  cket.  (But also
│ │ │ │ -0000f720: 2073 6565 0a20 2020 2020 e280 9873 6869   see.     ...shi
│ │ │ │ -0000f730: 7368 695f 6b64 6372 6571 5f61 6464 5f70  shi_kdcreq_add_p
│ │ │ │ -0000f740: 6164 6174 615f 7467 7328 29e2 8099 2077  adata_tgs()... w
│ │ │ │ -0000f750: 6869 6368 2074 616b 6573 2061 6e20 4150  hich takes an AP
│ │ │ │ -0000f760: 2d52 4551 2064 6972 6563 746c 792e 290a  -REQ directly.).
│ │ │ │ -0000f770: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ -0000f780: 6c75 653a 2a20 5265 7475 726e 7320 5348  lue:* Returns SH
│ │ │ │ -0000f790: 4953 4849 5f4f 4b20 6966 6620 7375 6363  ISHI_OK iff succ
│ │ │ │ -0000f7a0: 6573 7366 756c 2e0a 0a73 6869 7368 695f  essful...shishi_
│ │ │ │ -0000f7b0: 6b64 6372 6571 5f61 6464 5f70 6164 6174  kdcreq_add_padat
│ │ │ │ -0000f7c0: 615f 7467 730a 2d2d 2d2d 2d2d 2d2d 2d2d  a_tgs.----------
│ │ │ │ +0000f480: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ +0000f490: 3a20 696e 7420 7368 6973 6869 5f6b 6463  : int shishi_kdc
│ │ │ │ +0000f4a0: 7265 715f 6164 645f 7061 6461 7461 2028  req_add_padata (
│ │ │ │ +0000f4b0: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ +0000f4c0: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ +0000f4d0: 695f 6173 6e31 204b 4443 5245 512c 2069  i_asn1 KDCREQ, i
│ │ │ │ +0000f4e0: 6e74 2050 4144 4154 4154 5950 452c 2063  nt PADATATYPE, c
│ │ │ │ +0000f4f0: 6f6e 7374 2063 6861 7220 2a20 4441 5441  onst char * DATA
│ │ │ │ +0000f500: 2c0a 2020 2020 2020 2020 2020 7369 7a65  ,.          size
│ │ │ │ +0000f510: 5f74 2044 4154 414c 454e 290a 2020 2020  _t DATALEN).    
│ │ │ │ +0000f520: 2048 414e 444c 453a 2073 6869 7368 6920   HANDLE: shishi 
│ │ │ │ +0000f530: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ +0000f540: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ +0000f550: 5f69 6e69 7428 29e2 8099 2e0a 2020 2020  _init().....    
│ │ │ │ +0000f560: 204b 4443 5245 513a 204b 4443 2d52 4551   KDCREQ: KDC-REQ
│ │ │ │ +0000f570: 2074 6f20 6164 6420 5041 2d44 4154 4120   to add PA-DATA 
│ │ │ │ +0000f580: 746f 2e0a 2020 2020 2050 4144 4154 4154  to..     PADATAT
│ │ │ │ +0000f590: 5950 453a 2074 7970 6520 6f66 2050 412d  YPE: type of PA-
│ │ │ │ +0000f5a0: 4441 5441 2c20 7365 6520 5368 6973 6869  DATA, see Shishi
│ │ │ │ +0000f5b0: 5f70 6164 6174 615f 7479 7065 2e0a 2020  _padata_type..  
│ │ │ │ +0000f5c0: 2020 2044 4154 413a 2069 6e70 7574 2061     DATA: input a
│ │ │ │ +0000f5d0: 7272 6179 2077 6974 6820 5041 2d44 4154  rray with PA-DAT
│ │ │ │ +0000f5e0: 4120 7661 6c75 652e 0a20 2020 2020 4441  A value..     DA
│ │ │ │ +0000f5f0: 5441 4c45 4e3a 2073 697a 6520 6f66 2069  TALEN: size of i
│ │ │ │ +0000f600: 6e70 7574 2061 7272 6179 2077 6974 6820  nput array with 
│ │ │ │ +0000f610: 5041 2d44 4154 4120 7661 6c75 652e 0a0a  PA-DATA value...
│ │ │ │ +0000f620: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ +0000f630: 6e3a 2a20 4164 6420 6e65 7720 7072 6520  n:* Add new pre 
│ │ │ │ +0000f640: 6175 7468 656e 7469 6361 7469 6f6e 2064  authentication d
│ │ │ │ +0000f650: 6174 6120 2850 412d 4441 5441 2920 746f  ata (PA-DATA) to
│ │ │ │ +0000f660: 0a20 2020 2020 4b44 432d 5245 512e 2020  .     KDC-REQ.  
│ │ │ │ +0000f670: 5468 6973 2069 7320 7573 6564 2074 6f20  This is used to 
│ │ │ │ +0000f680: 7061 7373 2076 6172 696f 7573 2069 6e66  pass various inf
│ │ │ │ +0000f690: 6f72 6d61 7469 6f6e 2074 6f20 4b44 432c  ormation to KDC,
│ │ │ │ +0000f6a0: 2073 7563 6820 6173 0a20 2020 2020 696e   such as.     in
│ │ │ │ +0000f6b0: 2063 6173 6520 6f66 2061 2053 4849 5348   case of a SHISH
│ │ │ │ +0000f6c0: 495f 5041 5f54 4753 5f52 4551 2070 6164  I_PA_TGS_REQ pad
│ │ │ │ +0000f6d0: 6174 6174 7970 6520 7468 6520 4150 2d52  atatype the AP-R
│ │ │ │ +0000f6e0: 4551 2074 6861 740a 2020 2020 2061 7574  EQ that.     aut
│ │ │ │ +0000f6f0: 6865 6e74 6963 6174 6573 2074 6865 2075  henticates the u
│ │ │ │ +0000f700: 7365 7220 746f 2067 6574 2074 6865 2074  ser to get the t
│ │ │ │ +0000f710: 6963 6b65 742e 2020 2842 7574 2061 6c73  icket.  (But als
│ │ │ │ +0000f720: 6f20 7365 650a 2020 2020 20e2 8098 7368  o see.     ...sh
│ │ │ │ +0000f730: 6973 6869 5f6b 6463 7265 715f 6164 645f  ishi_kdcreq_add_
│ │ │ │ +0000f740: 7061 6461 7461 5f74 6773 2829 e280 9920  padata_tgs()... 
│ │ │ │ +0000f750: 7768 6963 6820 7461 6b65 7320 616e 2041  which takes an A
│ │ │ │ +0000f760: 502d 5245 5120 6469 7265 6374 6c79 2e29  P-REQ directly.)
│ │ │ │ +0000f770: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ +0000f780: 616c 7565 3a2a 2052 6574 7572 6e73 2053  alue:* Returns S
│ │ │ │ +0000f790: 4849 5348 495f 4f4b 2069 6666 2073 7563  HISHI_OK iff suc
│ │ │ │ +0000f7a0: 6365 7373 6675 6c2e 0a0a 7368 6973 6869  cessful...shishi
│ │ │ │ +0000f7b0: 5f6b 6463 7265 715f 6164 645f 7061 6461  _kdcreq_add_pada
│ │ │ │ +0000f7c0: 7461 5f74 6773 0a2d 2d2d 2d2d 2d2d 2d2d  ta_tgs.---------
│ │ │ │  0000f7d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0000f7e0: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ -0000f7f0: 3a20 696e 7420 7368 6973 6869 5f6b 6463  : int shishi_kdc
│ │ │ │ -0000f800: 7265 715f 6164 645f 7061 6461 7461 5f74  req_add_padata_t
│ │ │ │ -0000f810: 6773 2028 5368 6973 6869 202a 2048 414e  gs (Shishi * HAN
│ │ │ │ -0000f820: 444c 452c 0a20 2020 2020 2020 2020 2053  DLE,.          S
│ │ │ │ -0000f830: 6869 7368 695f 6173 6e31 204b 4443 5245  hishi_asn1 KDCRE
│ │ │ │ -0000f840: 512c 2053 6869 7368 695f 6173 6e31 2041  Q, Shishi_asn1 A
│ │ │ │ -0000f850: 5052 4551 290a 2020 2020 2048 414e 444c  PREQ).     HANDL
│ │ │ │ -0000f860: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ -0000f870: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ -0000f880: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ -0000f890: 29e2 8099 2e0a 2020 2020 204b 4443 5245  ).....     KDCRE
│ │ │ │ -0000f8a0: 513a 204b 4443 2d52 4551 2074 6f20 6164  Q: KDC-REQ to ad
│ │ │ │ -0000f8b0: 6420 5041 2d44 4154 4120 746f 2e0a 2020  d PA-DATA to..  
│ │ │ │ -0000f8c0: 2020 2041 5052 4551 3a20 4150 2d52 4551     APREQ: AP-REQ
│ │ │ │ -0000f8d0: 2074 6f20 6164 6420 6173 2050 412d 4441   to add as PA-DA
│ │ │ │ -0000f8e0: 5441 2e0a 0a20 2020 2020 2a44 6573 6372  TA...     *Descr
│ │ │ │ -0000f8f0: 6970 7469 6f6e 3a2a 2041 6464 2054 4753  iption:* Add TGS
│ │ │ │ -0000f900: 2070 7265 2d61 7574 6865 6e74 6963 6174   pre-authenticat
│ │ │ │ -0000f910: 696f 6e20 6461 7461 2074 6f20 4b44 432d  ion data to KDC-
│ │ │ │ -0000f920: 5245 512e 2054 6865 2064 6174 610a 2020  REQ. The data.  
│ │ │ │ -0000f930: 2020 2069 7320 616e 2041 502d 5245 5120     is an AP-REQ 
│ │ │ │ -0000f940: 7468 6174 2061 7574 6865 6e74 6963 6174  that authenticat
│ │ │ │ -0000f950: 6573 2074 6865 2072 6571 7565 7374 2e20  es the request. 
│ │ │ │ -0000f960: 2054 6869 7320 6675 6e63 7469 6f6e 7320   This functions 
│ │ │ │ -0000f970: 7369 6d70 6c79 0a20 2020 2020 4445 5220  simply.     DER 
│ │ │ │ -0000f980: 656e 636f 6465 7320 7468 6520 4150 2d52  encodes the AP-R
│ │ │ │ -0000f990: 4551 2061 6e64 2063 616c 6c73 20e2 8098  EQ and calls ...
│ │ │ │ -0000f9a0: 7368 6973 6869 5f6b 6463 7265 715f 6164  shishi_kdcreq_ad
│ │ │ │ -0000f9b0: 645f 7061 6461 7461 2829 e280 9920 7769  d_padata()... wi
│ │ │ │ -0000f9c0: 7468 0a20 2020 2020 6120 5348 4953 4849  th.     a SHISHI
│ │ │ │ -0000f9d0: 5f50 415f 5447 535f 5245 5120 7061 6461  _PA_TGS_REQ pada
│ │ │ │ -0000f9e0: 7461 7479 7065 2e0a 0a20 2020 2020 2a52  tatype...     *R
│ │ │ │ -0000f9f0: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ -0000fa00: 7475 726e 7320 5348 4953 4849 5f4f 4b20  turns SHISHI_OK 
│ │ │ │ -0000fa10: 6966 6620 7375 6363 6573 7366 756c 2e0a  iff successful..
│ │ │ │ -0000fa20: 0a73 6869 7368 695f 6b64 6372 6571 5f61  .shishi_kdcreq_a
│ │ │ │ -0000fa30: 6464 5f70 6164 6174 615f 7072 6561 7574  dd_padata_preaut
│ │ │ │ -0000fa40: 680a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  h.--------------
│ │ │ │ +0000f7e0: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ +0000f7f0: 6e3a 2069 6e74 2073 6869 7368 695f 6b64  n: int shishi_kd
│ │ │ │ +0000f800: 6372 6571 5f61 6464 5f70 6164 6174 615f  creq_add_padata_
│ │ │ │ +0000f810: 7467 7320 2853 6869 7368 6920 2a20 4841  tgs (Shishi * HA
│ │ │ │ +0000f820: 4e44 4c45 2c0a 2020 2020 2020 2020 2020  NDLE,.          
│ │ │ │ +0000f830: 5368 6973 6869 5f61 736e 3120 4b44 4352  Shishi_asn1 KDCR
│ │ │ │ +0000f840: 4551 2c20 5368 6973 6869 5f61 736e 3120  EQ, Shishi_asn1 
│ │ │ │ +0000f850: 4150 5245 5129 0a20 2020 2020 4841 4e44  APREQ).     HAND
│ │ │ │ +0000f860: 4c45 3a20 7368 6973 6869 2068 616e 646c  LE: shishi handl
│ │ │ │ +0000f870: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ +0000f880: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ +0000f890: 2829 e280 992e 0a20 2020 2020 4b44 4352  ().....     KDCR
│ │ │ │ +0000f8a0: 4551 3a20 4b44 432d 5245 5120 746f 2061  EQ: KDC-REQ to a
│ │ │ │ +0000f8b0: 6464 2050 412d 4441 5441 2074 6f2e 0a20  dd PA-DATA to.. 
│ │ │ │ +0000f8c0: 2020 2020 4150 5245 513a 2041 502d 5245      APREQ: AP-RE
│ │ │ │ +0000f8d0: 5120 746f 2061 6464 2061 7320 5041 2d44  Q to add as PA-D
│ │ │ │ +0000f8e0: 4154 412e 0a0a 2020 2020 202a 4465 7363  ATA...     *Desc
│ │ │ │ +0000f8f0: 7269 7074 696f 6e3a 2a20 4164 6420 5447  ription:* Add TG
│ │ │ │ +0000f900: 5320 7072 652d 6175 7468 656e 7469 6361  S pre-authentica
│ │ │ │ +0000f910: 7469 6f6e 2064 6174 6120 746f 204b 4443  tion data to KDC
│ │ │ │ +0000f920: 2d52 4551 2e20 5468 6520 6461 7461 0a20  -REQ. The data. 
│ │ │ │ +0000f930: 2020 2020 6973 2061 6e20 4150 2d52 4551      is an AP-REQ
│ │ │ │ +0000f940: 2074 6861 7420 6175 7468 656e 7469 6361   that authentica
│ │ │ │ +0000f950: 7465 7320 7468 6520 7265 7175 6573 742e  tes the request.
│ │ │ │ +0000f960: 2020 5468 6973 2066 756e 6374 696f 6e73    This functions
│ │ │ │ +0000f970: 2073 696d 706c 790a 2020 2020 2044 4552   simply.     DER
│ │ │ │ +0000f980: 2065 6e63 6f64 6573 2074 6865 2041 502d   encodes the AP-
│ │ │ │ +0000f990: 5245 5120 616e 6420 6361 6c6c 7320 e280  REQ and calls ..
│ │ │ │ +0000f9a0: 9873 6869 7368 695f 6b64 6372 6571 5f61  .shishi_kdcreq_a
│ │ │ │ +0000f9b0: 6464 5f70 6164 6174 6128 29e2 8099 2077  dd_padata()... w
│ │ │ │ +0000f9c0: 6974 680a 2020 2020 2061 2053 4849 5348  ith.     a SHISH
│ │ │ │ +0000f9d0: 495f 5041 5f54 4753 5f52 4551 2070 6164  I_PA_TGS_REQ pad
│ │ │ │ +0000f9e0: 6174 6174 7970 652e 0a0a 2020 2020 202a  atatype...     *
│ │ │ │ +0000f9f0: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ +0000fa00: 6574 7572 6e73 2053 4849 5348 495f 4f4b  eturns SHISHI_OK
│ │ │ │ +0000fa10: 2069 6666 2073 7563 6365 7373 6675 6c2e   iff successful.
│ │ │ │ +0000fa20: 0a0a 7368 6973 6869 5f6b 6463 7265 715f  ..shishi_kdcreq_
│ │ │ │ +0000fa30: 6164 645f 7061 6461 7461 5f70 7265 6175  add_padata_preau
│ │ │ │ +0000fa40: 7468 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  th.-------------
│ │ │ │  0000fa50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0000fa60: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ -0000fa70: 3a20 696e 7420 7368 6973 6869 5f6b 6463  : int shishi_kdc
│ │ │ │ -0000fa80: 7265 715f 6164 645f 7061 6461 7461 5f70  req_add_padata_p
│ │ │ │ -0000fa90: 7265 6175 7468 2028 5368 6973 6869 202a  reauth (Shishi *
│ │ │ │ -0000faa0: 2048 414e 444c 452c 0a20 2020 2020 2020   HANDLE,.       
│ │ │ │ -0000fab0: 2020 2053 6869 7368 695f 6173 6e31 204b     Shishi_asn1 K
│ │ │ │ -0000fac0: 4443 5245 512c 2053 6869 7368 695f 6b65  DCREQ, Shishi_ke
│ │ │ │ -0000fad0: 7920 2a20 4b45 5929 0a20 2020 2020 4841  y * KEY).     HA
│ │ │ │ -0000fae0: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ -0000faf0: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ -0000fb00: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ -0000fb10: 6974 2829 e280 992e 0a20 2020 2020 4b44  it().....     KD
│ │ │ │ -0000fb20: 4352 4551 3a20 4b44 432d 5245 5120 746f  CREQ: KDC-REQ to
│ │ │ │ -0000fb30: 2061 6464 2070 7265 2d61 7574 6865 6e74   add pre-authent
│ │ │ │ -0000fb40: 6963 6174 696f 6e20 6461 7461 2074 6f2e  ication data to.
│ │ │ │ -0000fb50: 0a20 2020 2020 4b45 593a 204b 6579 2075  .     KEY: Key u
│ │ │ │ -0000fb60: 7365 6420 746f 2065 6e63 7279 7074 2070  sed to encrypt p
│ │ │ │ -0000fb70: 7265 2d61 7574 6820 6461 7461 2e0a 0a20  re-auth data... 
│ │ │ │ -0000fb80: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -0000fb90: 3a2a 2041 6464 2070 7265 2d61 7574 6865  :* Add pre-authe
│ │ │ │ -0000fba0: 6e74 6963 6174 696f 6e20 6461 7461 2074  ntication data t
│ │ │ │ -0000fbb0: 6f20 4b44 432d 5245 512e 0a0a 2020 2020  o KDC-REQ...    
│ │ │ │ -0000fbc0: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ -0000fbd0: 2052 6574 7572 6e73 2053 4849 5348 495f   Returns SHISHI_
│ │ │ │ -0000fbe0: 4f4b 2069 6666 2073 7563 6365 7373 6675  OK iff successfu
│ │ │ │ -0000fbf0: 6c2e 0a0a 7368 6973 6869 5f61 7372 6570  l...shishi_asrep
│ │ │ │ -0000fc00: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  .------------.. 
│ │ │ │ -0000fc10: 2d2d 2046 756e 6374 696f 6e3a 2053 6869  -- Function: Shi
│ │ │ │ -0000fc20: 7368 695f 6173 6e31 2073 6869 7368 695f  shi_asn1 shishi_
│ │ │ │ -0000fc30: 6173 7265 7020 2853 6869 7368 6920 2a20  asrep (Shishi * 
│ │ │ │ -0000fc40: 4841 4e44 4c45 290a 2020 2020 2048 414e  HANDLE).     HAN
│ │ │ │ -0000fc50: 444c 453a 2073 6869 7368 6920 6861 6e64  DLE: shishi hand
│ │ │ │ -0000fc60: 6c65 2061 7320 616c 6c6f 6361 7465 6420  le as allocated 
│ │ │ │ -0000fc70: 6279 20e2 8098 7368 6973 6869 5f69 6e69  by ...shishi_ini
│ │ │ │ -0000fc80: 7428 29e2 8099 2e0a 0a20 2020 2020 2a44  t()......     *D
│ │ │ │ -0000fc90: 6573 6372 6970 7469 6f6e 3a2a 2054 6869  escription:* Thi
│ │ │ │ -0000fca0: 7320 6675 6e63 7469 6f6e 2063 7265 6174  s function creat
│ │ │ │ -0000fcb0: 6573 2061 206e 6577 2041 532d 5245 502c  es a new AS-REP,
│ │ │ │ -0000fcc0: 2070 6f70 756c 6174 6564 2077 6974 680a   populated with.
│ │ │ │ -0000fcd0: 2020 2020 2073 6f6d 6520 6465 6661 756c       some defaul
│ │ │ │ -0000fce0: 7420 7661 6c75 6573 2e0a 0a20 2020 2020  t values...     
│ │ │ │ -0000fcf0: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ -0000fd00: 5265 7475 726e 7320 7468 6520 4153 2d52  Returns the AS-R
│ │ │ │ -0000fd10: 4550 206f 7220 4e55 4c4c 206f 6e20 6661  EP or NULL on fa
│ │ │ │ -0000fd20: 696c 7572 652e 0a0a 7368 6973 6869 5f74  ilure...shishi_t
│ │ │ │ -0000fd30: 6773 7265 700a 2d2d 2d2d 2d2d 2d2d 2d2d  gsrep.----------
│ │ │ │ -0000fd40: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ -0000fd50: 6e3a 2053 6869 7368 695f 6173 6e31 2073  n: Shishi_asn1 s
│ │ │ │ -0000fd60: 6869 7368 695f 7467 7372 6570 2028 5368  hishi_tgsrep (Sh
│ │ │ │ -0000fd70: 6973 6869 202a 2048 414e 444c 4529 0a20  ishi * HANDLE). 
│ │ │ │ -0000fd80: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ -0000fd90: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ -0000fda0: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ -0000fdb0: 7368 695f 696e 6974 2829 e280 992e 0a0a  shi_init()......
│ │ │ │ -0000fdc0: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ -0000fdd0: 6e3a 2a20 5468 6973 2066 756e 6374 696f  n:* This functio
│ │ │ │ -0000fde0: 6e20 6372 6561 7465 7320 6120 6e65 7720  n creates a new 
│ │ │ │ -0000fdf0: 5447 532d 5245 502c 2070 6f70 756c 6174  TGS-REP, populat
│ │ │ │ -0000fe00: 6564 2077 6974 680a 2020 2020 2073 6f6d  ed with.     som
│ │ │ │ -0000fe10: 6520 6465 6661 756c 7420 7661 6c75 6573  e default values
│ │ │ │ -0000fe20: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ -0000fe30: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ -0000fe40: 7468 6520 5447 532d 5245 5020 6f72 204e  the TGS-REP or N
│ │ │ │ -0000fe50: 554c 4c20 6f6e 2066 6169 6c75 7265 2e0a  ULL on failure..
│ │ │ │ -0000fe60: 0a73 6869 7368 695f 6b64 6372 6570 5f70  .shishi_kdcrep_p
│ │ │ │ -0000fe70: 7269 6e74 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  rint.-----------
│ │ │ │ -0000fe80: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -0000fe90: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ -0000fea0: 6869 5f6b 6463 7265 705f 7072 696e 7420  hi_kdcrep_print 
│ │ │ │ -0000feb0: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ -0000fec0: 2c20 4649 4c45 202a 2046 482c 0a20 2020  , FILE * FH,.   
│ │ │ │ -0000fed0: 2020 2020 2020 2053 6869 7368 695f 6173         Shishi_as
│ │ │ │ -0000fee0: 6e31 204b 4443 5245 5029 0a20 2020 2020  n1 KDCREP).     
│ │ │ │ -0000fef0: 4841 4e44 4c45 3a20 7368 6973 6869 2068  HANDLE: shishi h
│ │ │ │ -0000ff00: 616e 646c 6520 6173 2061 6c6c 6f63 6174  andle as allocat
│ │ │ │ -0000ff10: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ -0000ff20: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ -0000ff30: 4648 3a20 6669 6c65 2068 616e 646c 6520  FH: file handle 
│ │ │ │ -0000ff40: 6f70 656e 2066 6f72 2077 7269 7469 6e67  open for writing
│ │ │ │ -0000ff50: 2e0a 2020 2020 204b 4443 5245 503a 204b  ..     KDCREP: K
│ │ │ │ -0000ff60: 4443 2d52 4550 2074 6f20 7072 696e 742e  DC-REP to print.
│ │ │ │ -0000ff70: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ -0000ff80: 696f 6e3a 2a20 5072 696e 7420 4153 4349  ion:* Print ASCI
│ │ │ │ -0000ff90: 4920 6172 6d6f 7265 6420 4445 5220 656e  I armored DER en
│ │ │ │ -0000ffa0: 636f 6469 6e67 206f 6620 4b44 432d 5245  coding of KDC-RE
│ │ │ │ -0000ffb0: 5020 746f 2066 696c 652e 0a0a 2020 2020  P to file...    
│ │ │ │ -0000ffc0: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ -0000ffd0: 2052 6574 7572 6e73 2053 4849 5348 495f   Returns SHISHI_
│ │ │ │ -0000ffe0: 4f4b 2069 6666 2073 7563 6365 7373 6675  OK iff successfu
│ │ │ │ -0000fff0: 6c2e 0a0a 7368 6973 6869 5f6b 6463 7265  l...shishi_kdcre
│ │ │ │ -00010000: 705f 7361 7665 0a2d 2d2d 2d2d 2d2d 2d2d  p_save.---------
│ │ │ │ -00010010: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ -00010020: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ -00010030: 7368 695f 6b64 6372 6570 5f73 6176 6520  shi_kdcrep_save 
│ │ │ │ -00010040: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ -00010050: 2c20 4649 4c45 202a 2046 482c 0a20 2020  , FILE * FH,.   
│ │ │ │ -00010060: 2020 2020 2020 2053 6869 7368 695f 6173         Shishi_as
│ │ │ │ -00010070: 6e31 204b 4443 5245 5029 0a20 2020 2020  n1 KDCREP).     
│ │ │ │ -00010080: 4841 4e44 4c45 3a20 7368 6973 6869 2068  HANDLE: shishi h
│ │ │ │ -00010090: 616e 646c 6520 6173 2061 6c6c 6f63 6174  andle as allocat
│ │ │ │ -000100a0: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ -000100b0: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ -000100c0: 4648 3a20 6669 6c65 2068 616e 646c 6520  FH: file handle 
│ │ │ │ -000100d0: 6f70 656e 2066 6f72 2077 7269 7469 6e67  open for writing
│ │ │ │ -000100e0: 2e0a 2020 2020 204b 4443 5245 503a 204b  ..     KDCREP: K
│ │ │ │ -000100f0: 4443 2d52 4550 2074 6f20 7361 7665 2e0a  DC-REP to save..
│ │ │ │ -00010100: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -00010110: 6f6e 3a2a 2050 7269 6e74 2044 4552 2065  on:* Print DER e
│ │ │ │ -00010120: 6e63 6f64 696e 6720 6f66 204b 4443 2d52  ncoding of KDC-R
│ │ │ │ -00010130: 4550 2074 6f20 6669 6c65 2e0a 0a20 2020  EP to file...   
│ │ │ │ -00010140: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ -00010150: 2a20 5265 7475 726e 7320 5348 4953 4849  * Returns SHISHI
│ │ │ │ -00010160: 5f4f 4b20 6966 6620 7375 6363 6573 7366  _OK iff successf
│ │ │ │ -00010170: 756c 2e0a 0a73 6869 7368 695f 6b64 6372  ul...shishi_kdcr
│ │ │ │ -00010180: 6570 5f74 6f5f 6669 6c65 0a2d 2d2d 2d2d  ep_to_file.-----
│ │ │ │ +0000fa60: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ +0000fa70: 6e3a 2069 6e74 2073 6869 7368 695f 6b64  n: int shishi_kd
│ │ │ │ +0000fa80: 6372 6571 5f61 6464 5f70 6164 6174 615f  creq_add_padata_
│ │ │ │ +0000fa90: 7072 6561 7574 6820 2853 6869 7368 6920  preauth (Shishi 
│ │ │ │ +0000faa0: 2a20 4841 4e44 4c45 2c0a 2020 2020 2020  * HANDLE,.      
│ │ │ │ +0000fab0: 2020 2020 5368 6973 6869 5f61 736e 3120      Shishi_asn1 
│ │ │ │ +0000fac0: 4b44 4352 4551 2c20 5368 6973 6869 5f6b  KDCREQ, Shishi_k
│ │ │ │ +0000fad0: 6579 202a 204b 4559 290a 2020 2020 2048  ey * KEY).     H
│ │ │ │ +0000fae0: 414e 444c 453a 2073 6869 7368 6920 6861  ANDLE: shishi ha
│ │ │ │ +0000faf0: 6e64 6c65 2061 7320 616c 6c6f 6361 7465  ndle as allocate
│ │ │ │ +0000fb00: 6420 6279 20e2 8098 7368 6973 6869 5f69  d by ...shishi_i
│ │ │ │ +0000fb10: 6e69 7428 29e2 8099 2e0a 2020 2020 204b  nit().....     K
│ │ │ │ +0000fb20: 4443 5245 513a 204b 4443 2d52 4551 2074  DCREQ: KDC-REQ t
│ │ │ │ +0000fb30: 6f20 6164 6420 7072 652d 6175 7468 656e  o add pre-authen
│ │ │ │ +0000fb40: 7469 6361 7469 6f6e 2064 6174 6120 746f  tication data to
│ │ │ │ +0000fb50: 2e0a 2020 2020 204b 4559 3a20 4b65 7920  ..     KEY: Key 
│ │ │ │ +0000fb60: 7573 6564 2074 6f20 656e 6372 7970 7420  used to encrypt 
│ │ │ │ +0000fb70: 7072 652d 6175 7468 2064 6174 612e 0a0a  pre-auth data...
│ │ │ │ +0000fb80: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ +0000fb90: 6e3a 2a20 4164 6420 7072 652d 6175 7468  n:* Add pre-auth
│ │ │ │ +0000fba0: 656e 7469 6361 7469 6f6e 2064 6174 6120  entication data 
│ │ │ │ +0000fbb0: 746f 204b 4443 2d52 4551 2e0a 0a20 2020  to KDC-REQ...   
│ │ │ │ +0000fbc0: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ +0000fbd0: 2a20 5265 7475 726e 7320 5348 4953 4849  * Returns SHISHI
│ │ │ │ +0000fbe0: 5f4f 4b20 6966 6620 7375 6363 6573 7366  _OK iff successf
│ │ │ │ +0000fbf0: 756c 2e0a 0a73 6869 7368 695f 6173 7265  ul...shishi_asre
│ │ │ │ +0000fc00: 700a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  p.------------..
│ │ │ │ +0000fc10: 202d 2d20 4675 6e63 7469 6f6e 3a20 5368   -- Function: Sh
│ │ │ │ +0000fc20: 6973 6869 5f61 736e 3120 7368 6973 6869  ishi_asn1 shishi
│ │ │ │ +0000fc30: 5f61 7372 6570 2028 5368 6973 6869 202a  _asrep (Shishi *
│ │ │ │ +0000fc40: 2048 414e 444c 4529 0a20 2020 2020 4841   HANDLE).     HA
│ │ │ │ +0000fc50: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ +0000fc60: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ +0000fc70: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ +0000fc80: 6974 2829 e280 992e 0a0a 2020 2020 202a  it()......     *
│ │ │ │ +0000fc90: 4465 7363 7269 7074 696f 6e3a 2a20 5468  Description:* Th
│ │ │ │ +0000fca0: 6973 2066 756e 6374 696f 6e20 6372 6561  is function crea
│ │ │ │ +0000fcb0: 7465 7320 6120 6e65 7720 4153 2d52 4550  tes a new AS-REP
│ │ │ │ +0000fcc0: 2c20 706f 7075 6c61 7465 6420 7769 7468  , populated with
│ │ │ │ +0000fcd0: 0a20 2020 2020 736f 6d65 2064 6566 6175  .     some defau
│ │ │ │ +0000fce0: 6c74 2076 616c 7565 732e 0a0a 2020 2020  lt values...    
│ │ │ │ +0000fcf0: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ +0000fd00: 2052 6574 7572 6e73 2074 6865 2041 532d   Returns the AS-
│ │ │ │ +0000fd10: 5245 5020 6f72 204e 554c 4c20 6f6e 2066  REP or NULL on f
│ │ │ │ +0000fd20: 6169 6c75 7265 2e0a 0a73 6869 7368 695f  ailure...shishi_
│ │ │ │ +0000fd30: 7467 7372 6570 0a2d 2d2d 2d2d 2d2d 2d2d  tgsrep.---------
│ │ │ │ +0000fd40: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ +0000fd50: 6f6e 3a20 5368 6973 6869 5f61 736e 3120  on: Shishi_asn1 
│ │ │ │ +0000fd60: 7368 6973 6869 5f74 6773 7265 7020 2853  shishi_tgsrep (S
│ │ │ │ +0000fd70: 6869 7368 6920 2a20 4841 4e44 4c45 290a  hishi * HANDLE).
│ │ │ │ +0000fd80: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ +0000fd90: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ +0000fda0: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ +0000fdb0: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ +0000fdc0: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +0000fdd0: 6f6e 3a2a 2054 6869 7320 6675 6e63 7469  on:* This functi
│ │ │ │ +0000fde0: 6f6e 2063 7265 6174 6573 2061 206e 6577  on creates a new
│ │ │ │ +0000fdf0: 2054 4753 2d52 4550 2c20 706f 7075 6c61   TGS-REP, popula
│ │ │ │ +0000fe00: 7465 6420 7769 7468 0a20 2020 2020 736f  ted with.     so
│ │ │ │ +0000fe10: 6d65 2064 6566 6175 6c74 2076 616c 7565  me default value
│ │ │ │ +0000fe20: 732e 0a0a 2020 2020 202a 5265 7475 726e  s...     *Return
│ │ │ │ +0000fe30: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ +0000fe40: 2074 6865 2054 4753 2d52 4550 206f 7220   the TGS-REP or 
│ │ │ │ +0000fe50: 4e55 4c4c 206f 6e20 6661 696c 7572 652e  NULL on failure.
│ │ │ │ +0000fe60: 0a0a 7368 6973 6869 5f6b 6463 7265 705f  ..shishi_kdcrep_
│ │ │ │ +0000fe70: 7072 696e 740a 2d2d 2d2d 2d2d 2d2d 2d2d  print.----------
│ │ │ │ +0000fe80: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +0000fe90: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ +0000fea0: 7368 695f 6b64 6372 6570 5f70 7269 6e74  shi_kdcrep_print
│ │ │ │ +0000feb0: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ +0000fec0: 452c 2046 494c 4520 2a20 4648 2c0a 2020  E, FILE * FH,.  
│ │ │ │ +0000fed0: 2020 2020 2020 2020 5368 6973 6869 5f61          Shishi_a
│ │ │ │ +0000fee0: 736e 3120 4b44 4352 4550 290a 2020 2020  sn1 KDCREP).    
│ │ │ │ +0000fef0: 2048 414e 444c 453a 2073 6869 7368 6920   HANDLE: shishi 
│ │ │ │ +0000ff00: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ +0000ff10: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ +0000ff20: 5f69 6e69 7428 29e2 8099 2e0a 2020 2020  _init().....    
│ │ │ │ +0000ff30: 2046 483a 2066 696c 6520 6861 6e64 6c65   FH: file handle
│ │ │ │ +0000ff40: 206f 7065 6e20 666f 7220 7772 6974 696e   open for writin
│ │ │ │ +0000ff50: 672e 0a20 2020 2020 4b44 4352 4550 3a20  g..     KDCREP: 
│ │ │ │ +0000ff60: 4b44 432d 5245 5020 746f 2070 7269 6e74  KDC-REP to print
│ │ │ │ +0000ff70: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ +0000ff80: 7469 6f6e 3a2a 2050 7269 6e74 2041 5343  tion:* Print ASC
│ │ │ │ +0000ff90: 4949 2061 726d 6f72 6564 2044 4552 2065  II armored DER e
│ │ │ │ +0000ffa0: 6e63 6f64 696e 6720 6f66 204b 4443 2d52  ncoding of KDC-R
│ │ │ │ +0000ffb0: 4550 2074 6f20 6669 6c65 2e0a 0a20 2020  EP to file...   
│ │ │ │ +0000ffc0: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ +0000ffd0: 2a20 5265 7475 726e 7320 5348 4953 4849  * Returns SHISHI
│ │ │ │ +0000ffe0: 5f4f 4b20 6966 6620 7375 6363 6573 7366  _OK iff successf
│ │ │ │ +0000fff0: 756c 2e0a 0a73 6869 7368 695f 6b64 6372  ul...shishi_kdcr
│ │ │ │ +00010000: 6570 5f73 6176 650a 2d2d 2d2d 2d2d 2d2d  ep_save.--------
│ │ │ │ +00010010: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +00010020: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ +00010030: 6973 6869 5f6b 6463 7265 705f 7361 7665  ishi_kdcrep_save
│ │ │ │ +00010040: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ +00010050: 452c 2046 494c 4520 2a20 4648 2c0a 2020  E, FILE * FH,.  
│ │ │ │ +00010060: 2020 2020 2020 2020 5368 6973 6869 5f61          Shishi_a
│ │ │ │ +00010070: 736e 3120 4b44 4352 4550 290a 2020 2020  sn1 KDCREP).    
│ │ │ │ +00010080: 2048 414e 444c 453a 2073 6869 7368 6920   HANDLE: shishi 
│ │ │ │ +00010090: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ +000100a0: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ +000100b0: 5f69 6e69 7428 29e2 8099 2e0a 2020 2020  _init().....    
│ │ │ │ +000100c0: 2046 483a 2066 696c 6520 6861 6e64 6c65   FH: file handle
│ │ │ │ +000100d0: 206f 7065 6e20 666f 7220 7772 6974 696e   open for writin
│ │ │ │ +000100e0: 672e 0a20 2020 2020 4b44 4352 4550 3a20  g..     KDCREP: 
│ │ │ │ +000100f0: 4b44 432d 5245 5020 746f 2073 6176 652e  KDC-REP to save.
│ │ │ │ +00010100: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ +00010110: 696f 6e3a 2a20 5072 696e 7420 4445 5220  ion:* Print DER 
│ │ │ │ +00010120: 656e 636f 6469 6e67 206f 6620 4b44 432d  encoding of KDC-
│ │ │ │ +00010130: 5245 5020 746f 2066 696c 652e 0a0a 2020  REP to file...  
│ │ │ │ +00010140: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ +00010150: 3a2a 2052 6574 7572 6e73 2053 4849 5348  :* Returns SHISH
│ │ │ │ +00010160: 495f 4f4b 2069 6666 2073 7563 6365 7373  I_OK iff success
│ │ │ │ +00010170: 6675 6c2e 0a0a 7368 6973 6869 5f6b 6463  ful...shishi_kdc
│ │ │ │ +00010180: 7265 705f 746f 5f66 696c 650a 2d2d 2d2d  rep_to_file.----
│ │ │ │  00010190: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000101a0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ -000101b0: 696e 7420 7368 6973 6869 5f6b 6463 7265  int shishi_kdcre
│ │ │ │ -000101c0: 705f 746f 5f66 696c 6520 2853 6869 7368  p_to_file (Shish
│ │ │ │ -000101d0: 6920 2a20 4841 4e44 4c45 2c0a 2020 2020  i * HANDLE,.    
│ │ │ │ -000101e0: 2020 2020 2020 5368 6973 6869 5f61 736e        Shishi_asn
│ │ │ │ -000101f0: 3120 4b44 4352 4550 2c20 696e 7420 4649  1 KDCREP, int FI
│ │ │ │ -00010200: 4c45 5459 5045 2c20 636f 6e73 7420 6368  LETYPE, const ch
│ │ │ │ -00010210: 6172 202a 2046 494c 454e 414d 4529 0a20  ar * FILENAME). 
│ │ │ │ -00010220: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ -00010230: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ -00010240: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ -00010250: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ -00010260: 2020 2020 4b44 4352 4550 3a20 4b44 432d      KDCREP: KDC-
│ │ │ │ -00010270: 5245 5020 746f 2073 6176 652e 0a20 2020  REP to save..   
│ │ │ │ -00010280: 2020 4649 4c45 5459 5045 3a20 696e 7075    FILETYPE: inpu
│ │ │ │ -00010290: 7420 7661 7269 6162 6c65 2073 7065 6369  t variable speci
│ │ │ │ -000102a0: 6679 696e 6720 7479 7065 206f 6620 6669  fying type of fi
│ │ │ │ -000102b0: 6c65 2074 6f20 6265 2077 7269 7474 656e  le to be written
│ │ │ │ -000102c0: 2c20 7365 650a 2020 2020 2053 6869 7368  , see.     Shish
│ │ │ │ -000102d0: 695f 6669 6c65 7479 7065 2e0a 2020 2020  i_filetype..    
│ │ │ │ -000102e0: 2046 494c 454e 414d 453a 2069 6e70 7574   FILENAME: input
│ │ │ │ -000102f0: 2076 6172 6961 626c 6520 7769 7468 2066   variable with f
│ │ │ │ -00010300: 696c 656e 616d 6520 746f 2077 7269 7465  ilename to write
│ │ │ │ -00010310: 2074 6f2e 0a0a 2020 2020 202a 4465 7363   to...     *Desc
│ │ │ │ -00010320: 7269 7074 696f 6e3a 2a20 5772 6974 6520  ription:* Write 
│ │ │ │ -00010330: 4b44 432d 5245 5020 746f 2066 696c 6520  KDC-REP to file 
│ │ │ │ -00010340: 696e 2073 7065 6369 6669 6564 2054 5950  in specified TYP
│ │ │ │ -00010350: 452e 2054 6865 2066 696c 650a 2020 2020  E. The file.    
│ │ │ │ -00010360: 2077 696c 6c20 6265 2074 7275 6e63 6174   will be truncat
│ │ │ │ -00010370: 6564 2069 6620 6974 2065 7869 7374 732e  ed if it exists.
│ │ │ │ -00010380: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ -00010390: 616c 7565 3a2a 2052 6574 7572 6e73 2053  alue:* Returns S
│ │ │ │ -000103a0: 4849 5348 495f 4f4b 2069 6666 2073 7563  HISHI_OK iff suc
│ │ │ │ -000103b0: 6365 7373 6675 6c2e 0a0a 7368 6973 6869  cessful...shishi
│ │ │ │ -000103c0: 5f6b 6463 7265 705f 7061 7273 650a 2d2d  _kdcrep_parse.--
│ │ │ │ +000101a0: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ +000101b0: 2069 6e74 2073 6869 7368 695f 6b64 6372   int shishi_kdcr
│ │ │ │ +000101c0: 6570 5f74 6f5f 6669 6c65 2028 5368 6973  ep_to_file (Shis
│ │ │ │ +000101d0: 6869 202a 2048 414e 444c 452c 0a20 2020  hi * HANDLE,.   
│ │ │ │ +000101e0: 2020 2020 2020 2053 6869 7368 695f 6173         Shishi_as
│ │ │ │ +000101f0: 6e31 204b 4443 5245 502c 2069 6e74 2046  n1 KDCREP, int F
│ │ │ │ +00010200: 494c 4554 5950 452c 2063 6f6e 7374 2063  ILETYPE, const c
│ │ │ │ +00010210: 6861 7220 2a20 4649 4c45 4e41 4d45 290a  har * FILENAME).
│ │ │ │ +00010220: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ +00010230: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ +00010240: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ +00010250: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ +00010260: 2020 2020 204b 4443 5245 503a 204b 4443       KDCREP: KDC
│ │ │ │ +00010270: 2d52 4550 2074 6f20 7361 7665 2e0a 2020  -REP to save..  
│ │ │ │ +00010280: 2020 2046 494c 4554 5950 453a 2069 6e70     FILETYPE: inp
│ │ │ │ +00010290: 7574 2076 6172 6961 626c 6520 7370 6563  ut variable spec
│ │ │ │ +000102a0: 6966 7969 6e67 2074 7970 6520 6f66 2066  ifying type of f
│ │ │ │ +000102b0: 696c 6520 746f 2062 6520 7772 6974 7465  ile to be writte
│ │ │ │ +000102c0: 6e2c 2073 6565 0a20 2020 2020 5368 6973  n, see.     Shis
│ │ │ │ +000102d0: 6869 5f66 696c 6574 7970 652e 0a20 2020  hi_filetype..   
│ │ │ │ +000102e0: 2020 4649 4c45 4e41 4d45 3a20 696e 7075    FILENAME: inpu
│ │ │ │ +000102f0: 7420 7661 7269 6162 6c65 2077 6974 6820  t variable with 
│ │ │ │ +00010300: 6669 6c65 6e61 6d65 2074 6f20 7772 6974  filename to writ
│ │ │ │ +00010310: 6520 746f 2e0a 0a20 2020 2020 2a44 6573  e to...     *Des
│ │ │ │ +00010320: 6372 6970 7469 6f6e 3a2a 2057 7269 7465  cription:* Write
│ │ │ │ +00010330: 204b 4443 2d52 4550 2074 6f20 6669 6c65   KDC-REP to file
│ │ │ │ +00010340: 2069 6e20 7370 6563 6966 6965 6420 5459   in specified TY
│ │ │ │ +00010350: 5045 2e20 5468 6520 6669 6c65 0a20 2020  PE. The file.   
│ │ │ │ +00010360: 2020 7769 6c6c 2062 6520 7472 756e 6361    will be trunca
│ │ │ │ +00010370: 7465 6420 6966 2069 7420 6578 6973 7473  ted if it exists
│ │ │ │ +00010380: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ +00010390: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ +000103a0: 5348 4953 4849 5f4f 4b20 6966 6620 7375  SHISHI_OK iff su
│ │ │ │ +000103b0: 6363 6573 7366 756c 2e0a 0a73 6869 7368  ccessful...shish
│ │ │ │ +000103c0: 695f 6b64 6372 6570 5f70 6172 7365 0a2d  i_kdcrep_parse.-
│ │ │ │  000103d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000103e0: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ -000103f0: 2069 6e74 2073 6869 7368 695f 6b64 6372   int shishi_kdcr
│ │ │ │ -00010400: 6570 5f70 6172 7365 2028 5368 6973 6869  ep_parse (Shishi
│ │ │ │ -00010410: 202a 2048 414e 444c 452c 2046 494c 4520   * HANDLE, FILE 
│ │ │ │ -00010420: 2a20 4648 2c0a 2020 2020 2020 2020 2020  * FH,.          
│ │ │ │ -00010430: 5368 6973 6869 5f61 736e 3120 2a20 4b44  Shishi_asn1 * KD
│ │ │ │ -00010440: 4352 4550 290a 2020 2020 2048 414e 444c  CREP).     HANDL
│ │ │ │ -00010450: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ -00010460: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ -00010470: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ -00010480: 29e2 8099 2e0a 2020 2020 2046 483a 2066  ).....     FH: f
│ │ │ │ -00010490: 696c 6520 6861 6e64 6c65 206f 7065 6e20  ile handle open 
│ │ │ │ -000104a0: 666f 7220 7265 6164 696e 672e 0a20 2020  for reading..   
│ │ │ │ -000104b0: 2020 4b44 4352 4550 3a20 6f75 7470 7574    KDCREP: output
│ │ │ │ -000104c0: 2076 6172 6961 626c 6520 7769 7468 206e   variable with n
│ │ │ │ -000104d0: 6577 6c79 2061 6c6c 6f63 6174 6564 204b  ewly allocated K
│ │ │ │ -000104e0: 4443 2d52 4550 2e0a 0a20 2020 2020 2a44  DC-REP...     *D
│ │ │ │ -000104f0: 6573 6372 6970 7469 6f6e 3a2a 2052 6561  escription:* Rea
│ │ │ │ -00010500: 6420 4153 4349 4920 6172 6d6f 7265 6420  d ASCII armored 
│ │ │ │ -00010510: 4445 5220 656e 636f 6465 6420 4b44 432d  DER encoded KDC-
│ │ │ │ -00010520: 5245 5020 6672 6f6d 2066 696c 6520 616e  REP from file an
│ │ │ │ -00010530: 640a 2020 2020 2070 6f70 756c 6174 6520  d.     populate 
│ │ │ │ -00010540: 6769 7665 6e20 7661 7269 6162 6c65 2e0a  given variable..
│ │ │ │ -00010550: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ -00010560: 6c75 653a 2a20 5265 7475 726e 7320 5348  lue:* Returns SH
│ │ │ │ -00010570: 4953 4849 5f4f 4b20 6966 6620 7375 6363  ISHI_OK iff succ
│ │ │ │ -00010580: 6573 7366 756c 2e0a 0a73 6869 7368 695f  essful...shishi_
│ │ │ │ -00010590: 6b64 6372 6570 5f72 6561 640a 2d2d 2d2d  kdcrep_read.----
│ │ │ │ -000105a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -000105b0: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ -000105c0: 7420 7368 6973 6869 5f6b 6463 7265 705f  t shishi_kdcrep_
│ │ │ │ -000105d0: 7265 6164 2028 5368 6973 6869 202a 2048  read (Shishi * H
│ │ │ │ -000105e0: 414e 444c 452c 2046 494c 4520 2a20 4648  ANDLE, FILE * FH
│ │ │ │ -000105f0: 2c0a 2020 2020 2020 2020 2020 5368 6973  ,.          Shis
│ │ │ │ -00010600: 6869 5f61 736e 3120 2a20 4b44 4352 4550  hi_asn1 * KDCREP
│ │ │ │ -00010610: 290a 2020 2020 2048 414e 444c 453a 2073  ).     HANDLE: s
│ │ │ │ -00010620: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ -00010630: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ -00010640: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ -00010650: 2e0a 2020 2020 2046 483a 2066 696c 6520  ..     FH: file 
│ │ │ │ -00010660: 6861 6e64 6c65 206f 7065 6e20 666f 7220  handle open for 
│ │ │ │ -00010670: 7265 6164 696e 672e 0a20 2020 2020 4b44  reading..     KD
│ │ │ │ -00010680: 4352 4550 3a20 6f75 7470 7574 2076 6172  CREP: output var
│ │ │ │ -00010690: 6961 626c 6520 7769 7468 206e 6577 6c79  iable with newly
│ │ │ │ -000106a0: 2061 6c6c 6f63 6174 6564 204b 4443 2d52   allocated KDC-R
│ │ │ │ -000106b0: 4550 2e0a 0a20 2020 2020 2a44 6573 6372  EP...     *Descr
│ │ │ │ -000106c0: 6970 7469 6f6e 3a2a 2052 6561 6420 4445  iption:* Read DE
│ │ │ │ -000106d0: 5220 656e 636f 6465 6420 4b44 432d 5245  R encoded KDC-RE
│ │ │ │ -000106e0: 5020 6672 6f6d 2066 696c 6520 616e 6420  P from file and 
│ │ │ │ -000106f0: 706f 7075 6c61 7465 0a20 2020 2020 6769  populate.     gi
│ │ │ │ -00010700: 7665 6e20 7661 7269 6162 6c65 2e0a 0a20  ven variable... 
│ │ │ │ -00010710: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ -00010720: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ -00010730: 4849 5f4f 4b20 6966 6620 7375 6363 6573  HI_OK iff succes
│ │ │ │ -00010740: 7366 756c 2e0a 0a73 6869 7368 695f 6b64  sful...shishi_kd
│ │ │ │ -00010750: 6372 6570 5f66 726f 6d5f 6669 6c65 0a2d  crep_from_file.-
│ │ │ │ +000103e0: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ +000103f0: 3a20 696e 7420 7368 6973 6869 5f6b 6463  : int shishi_kdc
│ │ │ │ +00010400: 7265 705f 7061 7273 6520 2853 6869 7368  rep_parse (Shish
│ │ │ │ +00010410: 6920 2a20 4841 4e44 4c45 2c20 4649 4c45  i * HANDLE, FILE
│ │ │ │ +00010420: 202a 2046 482c 0a20 2020 2020 2020 2020   * FH,.         
│ │ │ │ +00010430: 2053 6869 7368 695f 6173 6e31 202a 204b   Shishi_asn1 * K
│ │ │ │ +00010440: 4443 5245 5029 0a20 2020 2020 4841 4e44  DCREP).     HAND
│ │ │ │ +00010450: 4c45 3a20 7368 6973 6869 2068 616e 646c  LE: shishi handl
│ │ │ │ +00010460: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ +00010470: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ +00010480: 2829 e280 992e 0a20 2020 2020 4648 3a20  ().....     FH: 
│ │ │ │ +00010490: 6669 6c65 2068 616e 646c 6520 6f70 656e  file handle open
│ │ │ │ +000104a0: 2066 6f72 2072 6561 6469 6e67 2e0a 2020   for reading..  
│ │ │ │ +000104b0: 2020 204b 4443 5245 503a 206f 7574 7075     KDCREP: outpu
│ │ │ │ +000104c0: 7420 7661 7269 6162 6c65 2077 6974 6820  t variable with 
│ │ │ │ +000104d0: 6e65 776c 7920 616c 6c6f 6361 7465 6420  newly allocated 
│ │ │ │ +000104e0: 4b44 432d 5245 502e 0a0a 2020 2020 202a  KDC-REP...     *
│ │ │ │ +000104f0: 4465 7363 7269 7074 696f 6e3a 2a20 5265  Description:* Re
│ │ │ │ +00010500: 6164 2041 5343 4949 2061 726d 6f72 6564  ad ASCII armored
│ │ │ │ +00010510: 2044 4552 2065 6e63 6f64 6564 204b 4443   DER encoded KDC
│ │ │ │ +00010520: 2d52 4550 2066 726f 6d20 6669 6c65 2061  -REP from file a
│ │ │ │ +00010530: 6e64 0a20 2020 2020 706f 7075 6c61 7465  nd.     populate
│ │ │ │ +00010540: 2067 6976 656e 2076 6172 6961 626c 652e   given variable.
│ │ │ │ +00010550: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ +00010560: 616c 7565 3a2a 2052 6574 7572 6e73 2053  alue:* Returns S
│ │ │ │ +00010570: 4849 5348 495f 4f4b 2069 6666 2073 7563  HISHI_OK iff suc
│ │ │ │ +00010580: 6365 7373 6675 6c2e 0a0a 7368 6973 6869  cessful...shishi
│ │ │ │ +00010590: 5f6b 6463 7265 705f 7265 6164 0a2d 2d2d  _kdcrep_read.---
│ │ │ │ +000105a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +000105b0: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ +000105c0: 6e74 2073 6869 7368 695f 6b64 6372 6570  nt shishi_kdcrep
│ │ │ │ +000105d0: 5f72 6561 6420 2853 6869 7368 6920 2a20  _read (Shishi * 
│ │ │ │ +000105e0: 4841 4e44 4c45 2c20 4649 4c45 202a 2046  HANDLE, FILE * F
│ │ │ │ +000105f0: 482c 0a20 2020 2020 2020 2020 2053 6869  H,.          Shi
│ │ │ │ +00010600: 7368 695f 6173 6e31 202a 204b 4443 5245  shi_asn1 * KDCRE
│ │ │ │ +00010610: 5029 0a20 2020 2020 4841 4e44 4c45 3a20  P).     HANDLE: 
│ │ │ │ +00010620: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ +00010630: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ +00010640: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ +00010650: 992e 0a20 2020 2020 4648 3a20 6669 6c65  ...     FH: file
│ │ │ │ +00010660: 2068 616e 646c 6520 6f70 656e 2066 6f72   handle open for
│ │ │ │ +00010670: 2072 6561 6469 6e67 2e0a 2020 2020 204b   reading..     K
│ │ │ │ +00010680: 4443 5245 503a 206f 7574 7075 7420 7661  DCREP: output va
│ │ │ │ +00010690: 7269 6162 6c65 2077 6974 6820 6e65 776c  riable with newl
│ │ │ │ +000106a0: 7920 616c 6c6f 6361 7465 6420 4b44 432d  y allocated KDC-
│ │ │ │ +000106b0: 5245 502e 0a0a 2020 2020 202a 4465 7363  REP...     *Desc
│ │ │ │ +000106c0: 7269 7074 696f 6e3a 2a20 5265 6164 2044  ription:* Read D
│ │ │ │ +000106d0: 4552 2065 6e63 6f64 6564 204b 4443 2d52  ER encoded KDC-R
│ │ │ │ +000106e0: 4550 2066 726f 6d20 6669 6c65 2061 6e64  EP from file and
│ │ │ │ +000106f0: 2070 6f70 756c 6174 650a 2020 2020 2067   populate.     g
│ │ │ │ +00010700: 6976 656e 2076 6172 6961 626c 652e 0a0a  iven variable...
│ │ │ │ +00010710: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ +00010720: 7565 3a2a 2052 6574 7572 6e73 2053 4849  ue:* Returns SHI
│ │ │ │ +00010730: 5348 495f 4f4b 2069 6666 2073 7563 6365  SHI_OK iff succe
│ │ │ │ +00010740: 7373 6675 6c2e 0a0a 7368 6973 6869 5f6b  ssful...shishi_k
│ │ │ │ +00010750: 6463 7265 705f 6672 6f6d 5f66 696c 650a  dcrep_from_file.
│ │ │ │  00010760: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00010770: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ -00010780: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ -00010790: 5f6b 6463 7265 705f 6672 6f6d 5f66 696c  _kdcrep_from_fil
│ │ │ │ -000107a0: 6520 2853 6869 7368 6920 2a20 4841 4e44  e (Shishi * HAND
│ │ │ │ -000107b0: 4c45 2c0a 2020 2020 2020 2020 2020 5368  LE,.          Sh
│ │ │ │ -000107c0: 6973 6869 5f61 736e 3120 2a20 4b44 4352  ishi_asn1 * KDCR
│ │ │ │ -000107d0: 4550 2c20 696e 7420 4649 4c45 5459 5045  EP, int FILETYPE
│ │ │ │ -000107e0: 2c20 636f 6e73 7420 6368 6172 202a 2046  , const char * F
│ │ │ │ -000107f0: 494c 454e 414d 4529 0a20 2020 2020 4841  ILENAME).     HA
│ │ │ │ -00010800: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ -00010810: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ -00010820: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ -00010830: 6974 2829 e280 992e 0a20 2020 2020 4b44  it().....     KD
│ │ │ │ -00010840: 4352 4550 3a20 6f75 7470 7574 2076 6172  CREP: output var
│ │ │ │ -00010850: 6961 626c 6520 7769 7468 206e 6577 6c79  iable with newly
│ │ │ │ -00010860: 2061 6c6c 6f63 6174 6564 204b 4443 2d52   allocated KDC-R
│ │ │ │ -00010870: 4550 2e0a 2020 2020 2046 494c 4554 5950  EP..     FILETYP
│ │ │ │ -00010880: 453a 2069 6e70 7574 2076 6172 6961 626c  E: input variabl
│ │ │ │ -00010890: 6520 7370 6563 6966 7969 6e67 2074 7970  e specifying typ
│ │ │ │ -000108a0: 6520 6f66 2066 696c 6520 746f 2062 6520  e of file to be 
│ │ │ │ -000108b0: 7265 6164 2c20 7365 650a 2020 2020 2053  read, see.     S
│ │ │ │ -000108c0: 6869 7368 695f 6669 6c65 7479 7065 2e0a  hishi_filetype..
│ │ │ │ -000108d0: 2020 2020 2046 494c 454e 414d 453a 2069       FILENAME: i
│ │ │ │ -000108e0: 6e70 7574 2076 6172 6961 626c 6520 7769  nput variable wi
│ │ │ │ -000108f0: 7468 2066 696c 656e 616d 6520 746f 2072  th filename to r
│ │ │ │ -00010900: 6561 6420 6672 6f6d 2e0a 0a20 2020 2020  ead from...     
│ │ │ │ -00010910: 2a44 6573 6372 6970 7469 6f6e 3a2a 2052  *Description:* R
│ │ │ │ -00010920: 6561 6420 4b44 432d 5245 5020 6672 6f6d  ead KDC-REP from
│ │ │ │ -00010930: 2066 696c 6520 696e 2073 7065 6369 6669   file in specifi
│ │ │ │ -00010940: 6564 2054 5950 452e 0a0a 2020 2020 202a  ed TYPE...     *
│ │ │ │ -00010950: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ -00010960: 6574 7572 6e73 2053 4849 5348 495f 4f4b  eturns SHISHI_OK
│ │ │ │ -00010970: 2069 6666 2073 7563 6365 7373 6675 6c2e   iff successful.
│ │ │ │ -00010980: 0a0a 7368 6973 6869 5f6b 6463 7265 705f  ..shishi_kdcrep_
│ │ │ │ -00010990: 6372 6561 6c6d 5f73 6574 0a2d 2d2d 2d2d  crealm_set.-----
│ │ │ │ +00010770: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +00010780: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ +00010790: 695f 6b64 6372 6570 5f66 726f 6d5f 6669  i_kdcrep_from_fi
│ │ │ │ +000107a0: 6c65 2028 5368 6973 6869 202a 2048 414e  le (Shishi * HAN
│ │ │ │ +000107b0: 444c 452c 0a20 2020 2020 2020 2020 2053  DLE,.          S
│ │ │ │ +000107c0: 6869 7368 695f 6173 6e31 202a 204b 4443  hishi_asn1 * KDC
│ │ │ │ +000107d0: 5245 502c 2069 6e74 2046 494c 4554 5950  REP, int FILETYP
│ │ │ │ +000107e0: 452c 2063 6f6e 7374 2063 6861 7220 2a20  E, const char * 
│ │ │ │ +000107f0: 4649 4c45 4e41 4d45 290a 2020 2020 2048  FILENAME).     H
│ │ │ │ +00010800: 414e 444c 453a 2073 6869 7368 6920 6861  ANDLE: shishi ha
│ │ │ │ +00010810: 6e64 6c65 2061 7320 616c 6c6f 6361 7465  ndle as allocate
│ │ │ │ +00010820: 6420 6279 20e2 8098 7368 6973 6869 5f69  d by ...shishi_i
│ │ │ │ +00010830: 6e69 7428 29e2 8099 2e0a 2020 2020 204b  nit().....     K
│ │ │ │ +00010840: 4443 5245 503a 206f 7574 7075 7420 7661  DCREP: output va
│ │ │ │ +00010850: 7269 6162 6c65 2077 6974 6820 6e65 776c  riable with newl
│ │ │ │ +00010860: 7920 616c 6c6f 6361 7465 6420 4b44 432d  y allocated KDC-
│ │ │ │ +00010870: 5245 502e 0a20 2020 2020 4649 4c45 5459  REP..     FILETY
│ │ │ │ +00010880: 5045 3a20 696e 7075 7420 7661 7269 6162  PE: input variab
│ │ │ │ +00010890: 6c65 2073 7065 6369 6679 696e 6720 7479  le specifying ty
│ │ │ │ +000108a0: 7065 206f 6620 6669 6c65 2074 6f20 6265  pe of file to be
│ │ │ │ +000108b0: 2072 6561 642c 2073 6565 0a20 2020 2020   read, see.     
│ │ │ │ +000108c0: 5368 6973 6869 5f66 696c 6574 7970 652e  Shishi_filetype.
│ │ │ │ +000108d0: 0a20 2020 2020 4649 4c45 4e41 4d45 3a20  .     FILENAME: 
│ │ │ │ +000108e0: 696e 7075 7420 7661 7269 6162 6c65 2077  input variable w
│ │ │ │ +000108f0: 6974 6820 6669 6c65 6e61 6d65 2074 6f20  ith filename to 
│ │ │ │ +00010900: 7265 6164 2066 726f 6d2e 0a0a 2020 2020  read from...    
│ │ │ │ +00010910: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ +00010920: 5265 6164 204b 4443 2d52 4550 2066 726f  Read KDC-REP fro
│ │ │ │ +00010930: 6d20 6669 6c65 2069 6e20 7370 6563 6966  m file in specif
│ │ │ │ +00010940: 6965 6420 5459 5045 2e0a 0a20 2020 2020  ied TYPE...     
│ │ │ │ +00010950: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ +00010960: 5265 7475 726e 7320 5348 4953 4849 5f4f  Returns SHISHI_O
│ │ │ │ +00010970: 4b20 6966 6620 7375 6363 6573 7366 756c  K iff successful
│ │ │ │ +00010980: 2e0a 0a73 6869 7368 695f 6b64 6372 6570  ...shishi_kdcrep
│ │ │ │ +00010990: 5f63 7265 616c 6d5f 7365 740a 2d2d 2d2d  _crealm_set.----
│ │ │ │  000109a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000109b0: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ -000109c0: 6e3a 2069 6e74 2073 6869 7368 695f 6b64  n: int shishi_kd
│ │ │ │ -000109d0: 6372 6570 5f63 7265 616c 6d5f 7365 7420  crep_crealm_set 
│ │ │ │ -000109e0: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ -000109f0: 2c0a 2020 2020 2020 2020 2020 5368 6973  ,.          Shis
│ │ │ │ -00010a00: 6869 5f61 736e 3120 4b44 4352 4550 2c20  hi_asn1 KDCREP, 
│ │ │ │ -00010a10: 636f 6e73 7420 6368 6172 202a 2043 5245  const char * CRE
│ │ │ │ -00010a20: 414c 4d29 0a20 2020 2020 4841 4e44 4c45  ALM).     HANDLE
│ │ │ │ -00010a30: 3a20 7368 6973 6869 2068 616e 646c 6520  : shishi handle 
│ │ │ │ -00010a40: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ -00010a50: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ -00010a60: e280 992e 0a20 2020 2020 4b44 4352 4550  .....     KDCREP
│ │ │ │ -00010a70: 3a20 4b64 6372 6570 2076 6172 6961 626c  : Kdcrep variabl
│ │ │ │ -00010a80: 6520 746f 2073 6574 2072 6561 6c6d 2066  e to set realm f
│ │ │ │ -00010a90: 6965 6c64 2069 6e2e 0a20 2020 2020 4352  ield in..     CR
│ │ │ │ -00010aa0: 4541 4c4d 3a20 696e 7075 7420 6172 7261  EALM: input arra
│ │ │ │ -00010ab0: 7920 7769 7468 206e 616d 6520 6f66 2072  y with name of r
│ │ │ │ -00010ac0: 6561 6c6d 2e0a 0a20 2020 2020 2a44 6573  ealm...     *Des
│ │ │ │ -00010ad0: 6372 6970 7469 6f6e 3a2a 2053 6574 2074  cription:* Set t
│ │ │ │ -00010ae0: 6865 2063 6c69 656e 7420 7265 616c 6d20  he client realm 
│ │ │ │ -00010af0: 6669 656c 6420 696e 2074 6865 204b 4443  field in the KDC
│ │ │ │ -00010b00: 2d52 4550 2e0a 0a20 2020 2020 2a52 6574  -REP...     *Ret
│ │ │ │ -00010b10: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ -00010b20: 726e 7320 5348 4953 4849 5f4f 4b20 6966  rns SHISHI_OK if
│ │ │ │ -00010b30: 6620 7375 6363 6573 7366 756c 2e0a 0a73  f successful...s
│ │ │ │ -00010b40: 6869 7368 695f 6b64 6372 6570 5f63 6e61  hishi_kdcrep_cna
│ │ │ │ -00010b50: 6d65 5f73 6574 0a2d 2d2d 2d2d 2d2d 2d2d  me_set.---------
│ │ │ │ -00010b60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -00010b70: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ -00010b80: 7420 7368 6973 6869 5f6b 6463 7265 705f  t shishi_kdcrep_
│ │ │ │ -00010b90: 636e 616d 655f 7365 7420 2853 6869 7368  cname_set (Shish
│ │ │ │ -00010ba0: 6920 2a20 4841 4e44 4c45 2c0a 2020 2020  i * HANDLE,.    
│ │ │ │ -00010bb0: 2020 2020 2020 5368 6973 6869 5f61 736e        Shishi_asn
│ │ │ │ -00010bc0: 3120 4b44 4352 4550 2c20 5368 6973 6869  1 KDCREP, Shishi
│ │ │ │ -00010bd0: 5f6e 616d 655f 7479 7065 204e 414d 455f  _name_type NAME_
│ │ │ │ -00010be0: 5459 5045 2c0a 2020 2020 2020 2020 2020  TYPE,.          
│ │ │ │ -00010bf0: 636f 6e73 7420 6368 6172 202a 2043 4e41  const char * CNA
│ │ │ │ -00010c00: 4d45 5b5d 290a 2020 2020 2048 414e 444c  ME[]).     HANDL
│ │ │ │ -00010c10: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ -00010c20: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ -00010c30: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ -00010c40: 29e2 8099 2e0a 2020 2020 204b 4443 5245  ).....     KDCRE
│ │ │ │ -00010c50: 503a 204b 6463 7265 7020 7661 7269 6162  P: Kdcrep variab
│ │ │ │ -00010c60: 6c65 2074 6f20 7365 7420 7365 7276 6572  le to set server
│ │ │ │ -00010c70: 206e 616d 6520 6669 656c 6420 696e 2e0a   name field in..
│ │ │ │ -00010c80: 2020 2020 204e 414d 455f 5459 5045 3a20       NAME_TYPE: 
│ │ │ │ -00010c90: 7479 7065 206f 6620 7072 696e 6369 7069  type of principi
│ │ │ │ -00010ca0: 616c 2c20 7365 6520 5368 6973 6869 5f6e  al, see Shishi_n
│ │ │ │ -00010cb0: 616d 655f 7479 7065 2c20 7573 7561 6c6c  ame_type, usuall
│ │ │ │ -00010cc0: 790a 2020 2020 2053 4849 5348 495f 4e54  y.     SHISHI_NT
│ │ │ │ -00010cd0: 5f55 4e4b 4e4f 574e 2e0a 2020 2020 2043  _UNKNOWN..     C
│ │ │ │ -00010ce0: 4e41 4d45 3a20 696e 7075 7420 6172 7261  NAME: input arra
│ │ │ │ -00010cf0: 7920 7769 7468 2070 7269 6e63 6970 616c  y with principal
│ │ │ │ -00010d00: 206e 616d 652e 0a0a 2020 2020 202a 4465   name...     *De
│ │ │ │ -00010d10: 7363 7269 7074 696f 6e3a 2a20 5365 7420  scription:* Set 
│ │ │ │ -00010d20: 7468 6520 636c 6965 6e74 206e 616d 6520  the client name 
│ │ │ │ -00010d30: 6669 656c 6420 696e 2074 6865 204b 4443  field in the KDC
│ │ │ │ -00010d40: 2d52 4550 2e0a 0a20 2020 2020 2a52 6574  -REP...     *Ret
│ │ │ │ -00010d50: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ -00010d60: 726e 7320 5348 4953 4849 5f4f 4b20 6966  rns SHISHI_OK if
│ │ │ │ -00010d70: 6620 7375 6363 6573 7366 756c 2e0a 0a73  f successful...s
│ │ │ │ -00010d80: 6869 7368 695f 6b64 6372 6570 5f63 6c69  hishi_kdcrep_cli
│ │ │ │ -00010d90: 656e 745f 7365 740a 2d2d 2d2d 2d2d 2d2d  ent_set.--------
│ │ │ │ +000109b0: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ +000109c0: 6f6e 3a20 696e 7420 7368 6973 6869 5f6b  on: int shishi_k
│ │ │ │ +000109d0: 6463 7265 705f 6372 6561 6c6d 5f73 6574  dcrep_crealm_set
│ │ │ │ +000109e0: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ +000109f0: 452c 0a20 2020 2020 2020 2020 2053 6869  E,.          Shi
│ │ │ │ +00010a00: 7368 695f 6173 6e31 204b 4443 5245 502c  shi_asn1 KDCREP,
│ │ │ │ +00010a10: 2063 6f6e 7374 2063 6861 7220 2a20 4352   const char * CR
│ │ │ │ +00010a20: 4541 4c4d 290a 2020 2020 2048 414e 444c  EALM).     HANDL
│ │ │ │ +00010a30: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ +00010a40: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ +00010a50: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ +00010a60: 29e2 8099 2e0a 2020 2020 204b 4443 5245  ).....     KDCRE
│ │ │ │ +00010a70: 503a 204b 6463 7265 7020 7661 7269 6162  P: Kdcrep variab
│ │ │ │ +00010a80: 6c65 2074 6f20 7365 7420 7265 616c 6d20  le to set realm 
│ │ │ │ +00010a90: 6669 656c 6420 696e 2e0a 2020 2020 2043  field in..     C
│ │ │ │ +00010aa0: 5245 414c 4d3a 2069 6e70 7574 2061 7272  REALM: input arr
│ │ │ │ +00010ab0: 6179 2077 6974 6820 6e61 6d65 206f 6620  ay with name of 
│ │ │ │ +00010ac0: 7265 616c 6d2e 0a0a 2020 2020 202a 4465  realm...     *De
│ │ │ │ +00010ad0: 7363 7269 7074 696f 6e3a 2a20 5365 7420  scription:* Set 
│ │ │ │ +00010ae0: 7468 6520 636c 6965 6e74 2072 6561 6c6d  the client realm
│ │ │ │ +00010af0: 2066 6965 6c64 2069 6e20 7468 6520 4b44   field in the KD
│ │ │ │ +00010b00: 432d 5245 502e 0a0a 2020 2020 202a 5265  C-REP...     *Re
│ │ │ │ +00010b10: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ +00010b20: 7572 6e73 2053 4849 5348 495f 4f4b 2069  urns SHISHI_OK i
│ │ │ │ +00010b30: 6666 2073 7563 6365 7373 6675 6c2e 0a0a  ff successful...
│ │ │ │ +00010b40: 7368 6973 6869 5f6b 6463 7265 705f 636e  shishi_kdcrep_cn
│ │ │ │ +00010b50: 616d 655f 7365 740a 2d2d 2d2d 2d2d 2d2d  ame_set.--------
│ │ │ │ +00010b60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +00010b70: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ +00010b80: 6e74 2073 6869 7368 695f 6b64 6372 6570  nt shishi_kdcrep
│ │ │ │ +00010b90: 5f63 6e61 6d65 5f73 6574 2028 5368 6973  _cname_set (Shis
│ │ │ │ +00010ba0: 6869 202a 2048 414e 444c 452c 0a20 2020  hi * HANDLE,.   
│ │ │ │ +00010bb0: 2020 2020 2020 2053 6869 7368 695f 6173         Shishi_as
│ │ │ │ +00010bc0: 6e31 204b 4443 5245 502c 2053 6869 7368  n1 KDCREP, Shish
│ │ │ │ +00010bd0: 695f 6e61 6d65 5f74 7970 6520 4e41 4d45  i_name_type NAME
│ │ │ │ +00010be0: 5f54 5950 452c 0a20 2020 2020 2020 2020  _TYPE,.         
│ │ │ │ +00010bf0: 2063 6f6e 7374 2063 6861 7220 2a20 434e   const char * CN
│ │ │ │ +00010c00: 414d 455b 5d29 0a20 2020 2020 4841 4e44  AME[]).     HAND
│ │ │ │ +00010c10: 4c45 3a20 7368 6973 6869 2068 616e 646c  LE: shishi handl
│ │ │ │ +00010c20: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ +00010c30: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ +00010c40: 2829 e280 992e 0a20 2020 2020 4b44 4352  ().....     KDCR
│ │ │ │ +00010c50: 4550 3a20 4b64 6372 6570 2076 6172 6961  EP: Kdcrep varia
│ │ │ │ +00010c60: 626c 6520 746f 2073 6574 2073 6572 7665  ble to set serve
│ │ │ │ +00010c70: 7220 6e61 6d65 2066 6965 6c64 2069 6e2e  r name field in.
│ │ │ │ +00010c80: 0a20 2020 2020 4e41 4d45 5f54 5950 453a  .     NAME_TYPE:
│ │ │ │ +00010c90: 2074 7970 6520 6f66 2070 7269 6e63 6970   type of princip
│ │ │ │ +00010ca0: 6961 6c2c 2073 6565 2053 6869 7368 695f  ial, see Shishi_
│ │ │ │ +00010cb0: 6e61 6d65 5f74 7970 652c 2075 7375 616c  name_type, usual
│ │ │ │ +00010cc0: 6c79 0a20 2020 2020 5348 4953 4849 5f4e  ly.     SHISHI_N
│ │ │ │ +00010cd0: 545f 554e 4b4e 4f57 4e2e 0a20 2020 2020  T_UNKNOWN..     
│ │ │ │ +00010ce0: 434e 414d 453a 2069 6e70 7574 2061 7272  CNAME: input arr
│ │ │ │ +00010cf0: 6179 2077 6974 6820 7072 696e 6369 7061  ay with principa
│ │ │ │ +00010d00: 6c20 6e61 6d65 2e0a 0a20 2020 2020 2a44  l name...     *D
│ │ │ │ +00010d10: 6573 6372 6970 7469 6f6e 3a2a 2053 6574  escription:* Set
│ │ │ │ +00010d20: 2074 6865 2063 6c69 656e 7420 6e61 6d65   the client name
│ │ │ │ +00010d30: 2066 6965 6c64 2069 6e20 7468 6520 4b44   field in the KD
│ │ │ │ +00010d40: 432d 5245 502e 0a0a 2020 2020 202a 5265  C-REP...     *Re
│ │ │ │ +00010d50: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ +00010d60: 7572 6e73 2053 4849 5348 495f 4f4b 2069  urns SHISHI_OK i
│ │ │ │ +00010d70: 6666 2073 7563 6365 7373 6675 6c2e 0a0a  ff successful...
│ │ │ │ +00010d80: 7368 6973 6869 5f6b 6463 7265 705f 636c  shishi_kdcrep_cl
│ │ │ │ +00010d90: 6965 6e74 5f73 6574 0a2d 2d2d 2d2d 2d2d  ient_set.-------
│ │ │ │  00010da0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00010db0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ -00010dc0: 696e 7420 7368 6973 6869 5f6b 6463 7265  int shishi_kdcre
│ │ │ │ -00010dd0: 705f 636c 6965 6e74 5f73 6574 2028 5368  p_client_set (Sh
│ │ │ │ -00010de0: 6973 6869 202a 2048 414e 444c 452c 0a20  ishi * HANDLE,. 
│ │ │ │ -00010df0: 2020 2020 2020 2020 2053 6869 7368 695f           Shishi_
│ │ │ │ -00010e00: 6173 6e31 204b 4443 5245 502c 2063 6f6e  asn1 KDCREP, con
│ │ │ │ -00010e10: 7374 2063 6861 7220 2a20 434c 4945 4e54  st char * CLIENT
│ │ │ │ -00010e20: 290a 2020 2020 2048 414e 444c 453a 2073  ).     HANDLE: s
│ │ │ │ -00010e30: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ -00010e40: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ -00010e50: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ -00010e60: 2e0a 2020 2020 204b 4443 5245 503a 204b  ..     KDCREP: K
│ │ │ │ -00010e70: 6463 7265 7020 7661 7269 6162 6c65 2074  dcrep variable t
│ │ │ │ -00010e80: 6f20 7365 7420 7365 7276 6572 206e 616d  o set server nam
│ │ │ │ -00010e90: 6520 6669 656c 6420 696e 2e0a 2020 2020  e field in..    
│ │ │ │ -00010ea0: 2043 4c49 454e 543a 207a 6572 6f2d 7465   CLIENT: zero-te
│ │ │ │ -00010eb0: 726d 696e 6174 6564 2073 7472 696e 6720  rminated string 
│ │ │ │ -00010ec0: 7769 7468 2070 7269 6e63 6970 616c 206e  with principal n
│ │ │ │ -00010ed0: 616d 6520 6f6e 2052 4643 2031 3936 340a  ame on RFC 1964.
│ │ │ │ -00010ee0: 2020 2020 2066 6f72 6d2e 0a0a 2020 2020       form...    
│ │ │ │ -00010ef0: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ -00010f00: 5365 7420 7468 6520 636c 6965 6e74 206e  Set the client n
│ │ │ │ -00010f10: 616d 6520 6669 656c 6420 696e 2074 6865  ame field in the
│ │ │ │ -00010f20: 204b 4443 2d52 4550 2e0a 0a20 2020 2020   KDC-REP...     
│ │ │ │ -00010f30: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ -00010f40: 5265 7475 726e 7320 5348 4953 4849 5f4f  Returns SHISHI_O
│ │ │ │ -00010f50: 4b20 6966 6620 7375 6363 6573 7366 756c  K iff successful
│ │ │ │ -00010f60: 2e0a 0a73 6869 7368 695f 6b64 6372 6570  ...shishi_kdcrep
│ │ │ │ -00010f70: 5f67 6574 5f65 6e63 5f70 6172 745f 6574  _get_enc_part_et
│ │ │ │ -00010f80: 7970 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ype.------------
│ │ │ │ +00010db0: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ +00010dc0: 2069 6e74 2073 6869 7368 695f 6b64 6372   int shishi_kdcr
│ │ │ │ +00010dd0: 6570 5f63 6c69 656e 745f 7365 7420 2853  ep_client_set (S
│ │ │ │ +00010de0: 6869 7368 6920 2a20 4841 4e44 4c45 2c0a  hishi * HANDLE,.
│ │ │ │ +00010df0: 2020 2020 2020 2020 2020 5368 6973 6869            Shishi
│ │ │ │ +00010e00: 5f61 736e 3120 4b44 4352 4550 2c20 636f  _asn1 KDCREP, co
│ │ │ │ +00010e10: 6e73 7420 6368 6172 202a 2043 4c49 454e  nst char * CLIEN
│ │ │ │ +00010e20: 5429 0a20 2020 2020 4841 4e44 4c45 3a20  T).     HANDLE: 
│ │ │ │ +00010e30: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ +00010e40: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ +00010e50: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ +00010e60: 992e 0a20 2020 2020 4b44 4352 4550 3a20  ...     KDCREP: 
│ │ │ │ +00010e70: 4b64 6372 6570 2076 6172 6961 626c 6520  Kdcrep variable 
│ │ │ │ +00010e80: 746f 2073 6574 2073 6572 7665 7220 6e61  to set server na
│ │ │ │ +00010e90: 6d65 2066 6965 6c64 2069 6e2e 0a20 2020  me field in..   
│ │ │ │ +00010ea0: 2020 434c 4945 4e54 3a20 7a65 726f 2d74    CLIENT: zero-t
│ │ │ │ +00010eb0: 6572 6d69 6e61 7465 6420 7374 7269 6e67  erminated string
│ │ │ │ +00010ec0: 2077 6974 6820 7072 696e 6369 7061 6c20   with principal 
│ │ │ │ +00010ed0: 6e61 6d65 206f 6e20 5246 4320 3139 3634  name on RFC 1964
│ │ │ │ +00010ee0: 0a20 2020 2020 666f 726d 2e0a 0a20 2020  .     form...   
│ │ │ │ +00010ef0: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ +00010f00: 2053 6574 2074 6865 2063 6c69 656e 7420   Set the client 
│ │ │ │ +00010f10: 6e61 6d65 2066 6965 6c64 2069 6e20 7468  name field in th
│ │ │ │ +00010f20: 6520 4b44 432d 5245 502e 0a0a 2020 2020  e KDC-REP...    
│ │ │ │ +00010f30: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ +00010f40: 2052 6574 7572 6e73 2053 4849 5348 495f   Returns SHISHI_
│ │ │ │ +00010f50: 4f4b 2069 6666 2073 7563 6365 7373 6675  OK iff successfu
│ │ │ │ +00010f60: 6c2e 0a0a 7368 6973 6869 5f6b 6463 7265  l...shishi_kdcre
│ │ │ │ +00010f70: 705f 6765 745f 656e 635f 7061 7274 5f65  p_get_enc_part_e
│ │ │ │ +00010f80: 7479 7065 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  type.-----------
│ │ │ │  00010f90: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00010fa0: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -00010fb0: 6f6e 3a20 696e 7420 7368 6973 6869 5f6b  on: int shishi_k
│ │ │ │ -00010fc0: 6463 7265 705f 6765 745f 656e 635f 7061  dcrep_get_enc_pa
│ │ │ │ -00010fd0: 7274 5f65 7479 7065 2028 5368 6973 6869  rt_etype (Shishi
│ │ │ │ -00010fe0: 202a 2048 414e 444c 452c 0a20 2020 2020   * HANDLE,.     
│ │ │ │ -00010ff0: 2020 2020 2053 6869 7368 695f 6173 6e31       Shishi_asn1
│ │ │ │ -00011000: 204b 4443 5245 502c 2069 6e74 3332 5f74   KDCREP, int32_t
│ │ │ │ -00011010: 202a 2045 5459 5045 290a 2020 2020 2048   * ETYPE).     H
│ │ │ │ -00011020: 414e 444c 453a 2073 6869 7368 6920 6861  ANDLE: shishi ha
│ │ │ │ -00011030: 6e64 6c65 2061 7320 616c 6c6f 6361 7465  ndle as allocate
│ │ │ │ -00011040: 6420 6279 20e2 8098 7368 6973 6869 5f69  d by ...shishi_i
│ │ │ │ -00011050: 6e69 7428 29e2 8099 2e0a 2020 2020 204b  nit().....     K
│ │ │ │ -00011060: 4443 5245 503a 204b 4443 2d52 4550 2076  DCREP: KDC-REP v
│ │ │ │ -00011070: 6172 6961 626c 6520 746f 2067 6574 2076  ariable to get v
│ │ │ │ -00011080: 616c 7565 2066 726f 6d2e 0a20 2020 2020  alue from..     
│ │ │ │ -00011090: 4554 5950 453a 206f 7574 7075 7420 7661  ETYPE: output va
│ │ │ │ -000110a0: 7269 6162 6c65 2074 6861 7420 686f 6c64  riable that hold
│ │ │ │ -000110b0: 7320 7468 6520 7661 6c75 652e 0a0a 2020  s the value...  
│ │ │ │ -000110c0: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ -000110d0: 2a20 4578 7472 6163 7420 4b44 432d 5245  * Extract KDC-RE
│ │ │ │ -000110e0: 502e 656e 632d 7061 7274 2e65 7479 7065  P.enc-part.etype
│ │ │ │ -000110f0: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ -00011100: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ -00011110: 5348 4953 4849 5f4f 4b20 6966 6620 7375  SHISHI_OK iff su
│ │ │ │ -00011120: 6363 6573 7366 756c 2e0a 0a73 6869 7368  ccessful...shish
│ │ │ │ -00011130: 695f 6b64 6372 6570 5f67 6574 5f74 6963  i_kdcrep_get_tic
│ │ │ │ -00011140: 6b65 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ket.------------
│ │ │ │ -00011150: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ -00011160: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ -00011170: 7368 6973 6869 5f6b 6463 7265 705f 6765  shishi_kdcrep_ge
│ │ │ │ -00011180: 745f 7469 636b 6574 2028 5368 6973 6869  t_ticket (Shishi
│ │ │ │ -00011190: 202a 2048 414e 444c 452c 0a20 2020 2020   * HANDLE,.     
│ │ │ │ -000111a0: 2020 2020 2053 6869 7368 695f 6173 6e31       Shishi_asn1
│ │ │ │ -000111b0: 204b 4443 5245 502c 2053 6869 7368 695f   KDCREP, Shishi_
│ │ │ │ -000111c0: 6173 6e31 202a 2054 4943 4b45 5429 0a20  asn1 * TICKET). 
│ │ │ │ -000111d0: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ -000111e0: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ -000111f0: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ -00011200: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ -00011210: 2020 2020 4b44 4352 4550 3a20 4b44 432d      KDCREP: KDC-
│ │ │ │ -00011220: 5245 5020 7661 7269 6162 6c65 2074 6f20  REP variable to 
│ │ │ │ -00011230: 6765 7420 7469 636b 6574 2066 726f 6d2e  get ticket from.
│ │ │ │ -00011240: 0a20 2020 2020 5449 434b 4554 3a20 6f75  .     TICKET: ou
│ │ │ │ -00011250: 7470 7574 2076 6172 6961 626c 6520 746f  tput variable to
│ │ │ │ -00011260: 2068 6f6c 6420 6578 7472 6163 7465 6420   hold extracted 
│ │ │ │ -00011270: 7469 636b 6574 2e0a 0a20 2020 2020 2a44  ticket...     *D
│ │ │ │ -00011280: 6573 6372 6970 7469 6f6e 3a2a 2045 7874  escription:* Ext
│ │ │ │ -00011290: 7261 6374 2074 6963 6b65 7420 6672 6f6d  ract ticket from
│ │ │ │ -000112a0: 204b 4443 2d52 4550 2e0a 0a20 2020 2020   KDC-REP...     
│ │ │ │ -000112b0: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ -000112c0: 5265 7475 726e 7320 5348 4953 4849 5f4f  Returns SHISHI_O
│ │ │ │ -000112d0: 4b20 6966 6620 7375 6363 6573 7366 756c  K iff successful
│ │ │ │ -000112e0: 2e0a 0a73 6869 7368 695f 6b64 6372 6570  ...shishi_kdcrep
│ │ │ │ -000112f0: 5f73 6574 5f74 6963 6b65 740a 2d2d 2d2d  _set_ticket.----
│ │ │ │ +00010fa0: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +00010fb0: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ +00010fc0: 6b64 6372 6570 5f67 6574 5f65 6e63 5f70  kdcrep_get_enc_p
│ │ │ │ +00010fd0: 6172 745f 6574 7970 6520 2853 6869 7368  art_etype (Shish
│ │ │ │ +00010fe0: 6920 2a20 4841 4e44 4c45 2c0a 2020 2020  i * HANDLE,.    
│ │ │ │ +00010ff0: 2020 2020 2020 5368 6973 6869 5f61 736e        Shishi_asn
│ │ │ │ +00011000: 3120 4b44 4352 4550 2c20 696e 7433 325f  1 KDCREP, int32_
│ │ │ │ +00011010: 7420 2a20 4554 5950 4529 0a20 2020 2020  t * ETYPE).     
│ │ │ │ +00011020: 4841 4e44 4c45 3a20 7368 6973 6869 2068  HANDLE: shishi h
│ │ │ │ +00011030: 616e 646c 6520 6173 2061 6c6c 6f63 6174  andle as allocat
│ │ │ │ +00011040: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ +00011050: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ +00011060: 4b44 4352 4550 3a20 4b44 432d 5245 5020  KDCREP: KDC-REP 
│ │ │ │ +00011070: 7661 7269 6162 6c65 2074 6f20 6765 7420  variable to get 
│ │ │ │ +00011080: 7661 6c75 6520 6672 6f6d 2e0a 2020 2020  value from..    
│ │ │ │ +00011090: 2045 5459 5045 3a20 6f75 7470 7574 2076   ETYPE: output v
│ │ │ │ +000110a0: 6172 6961 626c 6520 7468 6174 2068 6f6c  ariable that hol
│ │ │ │ +000110b0: 6473 2074 6865 2076 616c 7565 2e0a 0a20  ds the value... 
│ │ │ │ +000110c0: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ +000110d0: 3a2a 2045 7874 7261 6374 204b 4443 2d52  :* Extract KDC-R
│ │ │ │ +000110e0: 4550 2e65 6e63 2d70 6172 742e 6574 7970  EP.enc-part.etyp
│ │ │ │ +000110f0: 652e 0a0a 2020 2020 202a 5265 7475 726e  e...     *Return
│ │ │ │ +00011100: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ +00011110: 2053 4849 5348 495f 4f4b 2069 6666 2073   SHISHI_OK iff s
│ │ │ │ +00011120: 7563 6365 7373 6675 6c2e 0a0a 7368 6973  uccessful...shis
│ │ │ │ +00011130: 6869 5f6b 6463 7265 705f 6765 745f 7469  hi_kdcrep_get_ti
│ │ │ │ +00011140: 636b 6574 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  cket.-----------
│ │ │ │ +00011150: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ +00011160: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ +00011170: 2073 6869 7368 695f 6b64 6372 6570 5f67   shishi_kdcrep_g
│ │ │ │ +00011180: 6574 5f74 6963 6b65 7420 2853 6869 7368  et_ticket (Shish
│ │ │ │ +00011190: 6920 2a20 4841 4e44 4c45 2c0a 2020 2020  i * HANDLE,.    
│ │ │ │ +000111a0: 2020 2020 2020 5368 6973 6869 5f61 736e        Shishi_asn
│ │ │ │ +000111b0: 3120 4b44 4352 4550 2c20 5368 6973 6869  1 KDCREP, Shishi
│ │ │ │ +000111c0: 5f61 736e 3120 2a20 5449 434b 4554 290a  _asn1 * TICKET).
│ │ │ │ +000111d0: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ +000111e0: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ +000111f0: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ +00011200: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ +00011210: 2020 2020 204b 4443 5245 503a 204b 4443       KDCREP: KDC
│ │ │ │ +00011220: 2d52 4550 2076 6172 6961 626c 6520 746f  -REP variable to
│ │ │ │ +00011230: 2067 6574 2074 6963 6b65 7420 6672 6f6d   get ticket from
│ │ │ │ +00011240: 2e0a 2020 2020 2054 4943 4b45 543a 206f  ..     TICKET: o
│ │ │ │ +00011250: 7574 7075 7420 7661 7269 6162 6c65 2074  utput variable t
│ │ │ │ +00011260: 6f20 686f 6c64 2065 7874 7261 6374 6564  o hold extracted
│ │ │ │ +00011270: 2074 6963 6b65 742e 0a0a 2020 2020 202a   ticket...     *
│ │ │ │ +00011280: 4465 7363 7269 7074 696f 6e3a 2a20 4578  Description:* Ex
│ │ │ │ +00011290: 7472 6163 7420 7469 636b 6574 2066 726f  tract ticket fro
│ │ │ │ +000112a0: 6d20 4b44 432d 5245 502e 0a0a 2020 2020  m KDC-REP...    
│ │ │ │ +000112b0: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ +000112c0: 2052 6574 7572 6e73 2053 4849 5348 495f   Returns SHISHI_
│ │ │ │ +000112d0: 4f4b 2069 6666 2073 7563 6365 7373 6675  OK iff successfu
│ │ │ │ +000112e0: 6c2e 0a0a 7368 6973 6869 5f6b 6463 7265  l...shishi_kdcre
│ │ │ │ +000112f0: 705f 7365 745f 7469 636b 6574 0a2d 2d2d  p_set_ticket.---
│ │ │ │  00011300: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00011310: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -00011320: 6f6e 3a20 696e 7420 7368 6973 6869 5f6b  on: int shishi_k
│ │ │ │ -00011330: 6463 7265 705f 7365 745f 7469 636b 6574  dcrep_set_ticket
│ │ │ │ -00011340: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ -00011350: 452c 0a20 2020 2020 2020 2020 2053 6869  E,.          Shi
│ │ │ │ -00011360: 7368 695f 6173 6e31 204b 4443 5245 502c  shi_asn1 KDCREP,
│ │ │ │ -00011370: 2053 6869 7368 695f 6173 6e31 2054 4943   Shishi_asn1 TIC
│ │ │ │ -00011380: 4b45 5429 0a20 2020 2020 4841 4e44 4c45  KET).     HANDLE
│ │ │ │ -00011390: 3a20 7368 6973 6869 2068 616e 646c 6520  : shishi handle 
│ │ │ │ -000113a0: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ -000113b0: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ -000113c0: e280 992e 0a20 2020 2020 4b44 4352 4550  .....     KDCREP
│ │ │ │ -000113d0: 3a20 4b44 432d 5245 5020 746f 2061 6464  : KDC-REP to add
│ │ │ │ -000113e0: 2074 6963 6b65 7420 6669 656c 6420 746f   ticket field to
│ │ │ │ -000113f0: 2e0a 2020 2020 2054 4943 4b45 543a 2069  ..     TICKET: i
│ │ │ │ -00011400: 6e70 7574 2074 6963 6b65 7420 746f 2063  nput ticket to c
│ │ │ │ -00011410: 6f70 7920 696e 746f 204b 4443 2d52 4550  opy into KDC-REP
│ │ │ │ -00011420: 2074 6963 6b65 7420 6669 656c 642e 0a0a   ticket field...
│ │ │ │ -00011430: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ -00011440: 6e3a 2a20 436f 7079 2074 6963 6b65 7420  n:* Copy ticket 
│ │ │ │ -00011450: 696e 746f 204b 4443 2d52 4550 2e0a 0a20  into KDC-REP... 
│ │ │ │ -00011460: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ -00011470: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ -00011480: 4849 5f4f 4b20 6966 6620 7375 6363 6573  HI_OK iff succes
│ │ │ │ -00011490: 7366 756c 2e0a 0a73 6869 7368 695f 6b64  sful...shishi_kd
│ │ │ │ -000114a0: 6372 6570 5f73 6574 5f65 6e63 5f70 6172  crep_set_enc_par
│ │ │ │ -000114b0: 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  t.--------------
│ │ │ │ -000114c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ -000114d0: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ -000114e0: 7368 6973 6869 5f6b 6463 7265 705f 7365  shishi_kdcrep_se
│ │ │ │ -000114f0: 745f 656e 635f 7061 7274 2028 5368 6973  t_enc_part (Shis
│ │ │ │ -00011500: 6869 202a 2048 414e 444c 452c 0a20 2020  hi * HANDLE,.   
│ │ │ │ -00011510: 2020 2020 2020 2053 6869 7368 695f 6173         Shishi_as
│ │ │ │ -00011520: 6e31 204b 4443 5245 502c 2069 6e74 3332  n1 KDCREP, int32
│ │ │ │ -00011530: 5f74 2045 5459 5045 2c20 7569 6e74 3332  _t ETYPE, uint32
│ │ │ │ -00011540: 5f74 204b 564e 4f2c 0a20 2020 2020 2020  _t KVNO,.       
│ │ │ │ -00011550: 2020 2063 6f6e 7374 2063 6861 7220 2a20     const char * 
│ │ │ │ -00011560: 4255 462c 2073 697a 655f 7420 4255 464c  BUF, size_t BUFL
│ │ │ │ -00011570: 454e 290a 2020 2020 2048 414e 444c 453a  EN).     HANDLE:
│ │ │ │ -00011580: 2073 6869 7368 6920 6861 6e64 6c65 2061   shishi handle a
│ │ │ │ -00011590: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ -000115a0: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ -000115b0: 8099 2e0a 2020 2020 204b 4443 5245 503a  ....     KDCREP:
│ │ │ │ -000115c0: 204b 4443 2d52 4550 2074 6f20 6164 6420   KDC-REP to add 
│ │ │ │ -000115d0: 656e 632d 7061 7274 2066 6965 6c64 2074  enc-part field t
│ │ │ │ -000115e0: 6f2e 0a20 2020 2020 4554 5950 453a 2065  o..     ETYPE: e
│ │ │ │ -000115f0: 6e63 7279 7074 696f 6e20 7479 7065 2075  ncryption type u
│ │ │ │ -00011600: 7365 6420 746f 2065 6e63 7279 7074 2065  sed to encrypt e
│ │ │ │ -00011610: 6e63 2d70 6172 742e 0a20 2020 2020 4b56  nc-part..     KV
│ │ │ │ -00011620: 4e4f 3a20 6b65 7920 7665 7273 696f 6e20  NO: key version 
│ │ │ │ -00011630: 6e75 6d62 6572 2e0a 2020 2020 2042 5546  number..     BUF
│ │ │ │ -00011640: 3a20 696e 7075 7420 6172 7261 7920 7769  : input array wi
│ │ │ │ -00011650: 7468 2065 6e63 7279 7074 6564 2065 6e63  th encrypted enc
│ │ │ │ -00011660: 2d70 6172 742e 0a20 2020 2020 4255 464c  -part..     BUFL
│ │ │ │ -00011670: 454e 3a20 7369 7a65 206f 6620 696e 7075  EN: size of inpu
│ │ │ │ -00011680: 7420 6172 7261 7920 7769 7468 2065 6e63  t array with enc
│ │ │ │ -00011690: 7279 7074 6564 2065 6e63 2d70 6172 742e  rypted enc-part.
│ │ │ │ -000116a0: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ -000116b0: 696f 6e3a 2a20 5365 7420 7468 6520 656e  ion:* Set the en
│ │ │ │ -000116c0: 6372 7970 7465 6420 656e 632d 7061 7274  crypted enc-part
│ │ │ │ -000116d0: 2066 6965 6c64 2069 6e20 7468 6520 4b44   field in the KD
│ │ │ │ -000116e0: 432d 5245 502e 2054 6865 0a20 2020 2020  C-REP. The.     
│ │ │ │ -000116f0: 656e 6372 7970 7465 6420 6461 7461 2069  encrypted data i
│ │ │ │ -00011700: 7320 7573 7561 6c6c 7920 6372 6561 7465  s usually create
│ │ │ │ -00011710: 6420 6279 2063 616c 6c69 6e67 20e2 8098  d by calling ...
│ │ │ │ -00011720: 7368 6973 6869 5f65 6e63 7279 7074 2829  shishi_encrypt()
│ │ │ │ -00011730: e280 9920 6f6e 0a20 2020 2020 7468 6520  ... on.     the 
│ │ │ │ -00011740: 4445 5220 656e 636f 6465 6420 656e 632d  DER encoded enc-
│ │ │ │ -00011750: 7061 7274 2e20 2054 6f20 7361 7665 2074  part.  To save t
│ │ │ │ -00011760: 696d 652c 2079 6f75 206d 6179 2077 616e  ime, you may wan
│ │ │ │ -00011770: 7420 746f 2075 7365 0a20 2020 2020 e280  t to use.     ..
│ │ │ │ -00011780: 9873 6869 7368 695f 6b64 6372 6570 5f61  .shishi_kdcrep_a
│ │ │ │ -00011790: 6464 5f65 6e63 5f70 6172 7428 29e2 8099  dd_enc_part()...
│ │ │ │ -000117a0: 2069 6e73 7465 6164 2c20 7768 6963 6820   instead, which 
│ │ │ │ -000117b0: 6361 6c63 756c 6174 6573 2074 6865 0a20  calculates the. 
│ │ │ │ -000117c0: 2020 2020 656e 6372 7970 7465 6420 6461      encrypted da
│ │ │ │ -000117d0: 7461 2061 6e64 2063 616c 6c73 2074 6869  ta and calls thi
│ │ │ │ -000117e0: 7320 6675 6e63 7469 6f6e 2069 6e20 6f6e  s function in on
│ │ │ │ -000117f0: 6520 7374 6570 2e0a 0a20 2020 2020 2a52  e step...     *R
│ │ │ │ -00011800: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ -00011810: 7475 726e 7320 5348 4953 4849 5f4f 4b20  turns SHISHI_OK 
│ │ │ │ -00011820: 6966 6620 7375 6363 6573 7366 756c 2e0a  iff successful..
│ │ │ │ -00011830: 0a73 6869 7368 695f 6b64 6372 6570 5f61  .shishi_kdcrep_a
│ │ │ │ -00011840: 6464 5f65 6e63 5f70 6172 740a 2d2d 2d2d  dd_enc_part.----
│ │ │ │ +00011310: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +00011320: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ +00011330: 6b64 6372 6570 5f73 6574 5f74 6963 6b65  kdcrep_set_ticke
│ │ │ │ +00011340: 7420 2853 6869 7368 6920 2a20 4841 4e44  t (Shishi * HAND
│ │ │ │ +00011350: 4c45 2c0a 2020 2020 2020 2020 2020 5368  LE,.          Sh
│ │ │ │ +00011360: 6973 6869 5f61 736e 3120 4b44 4352 4550  ishi_asn1 KDCREP
│ │ │ │ +00011370: 2c20 5368 6973 6869 5f61 736e 3120 5449  , Shishi_asn1 TI
│ │ │ │ +00011380: 434b 4554 290a 2020 2020 2048 414e 444c  CKET).     HANDL
│ │ │ │ +00011390: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ +000113a0: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ +000113b0: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ +000113c0: 29e2 8099 2e0a 2020 2020 204b 4443 5245  ).....     KDCRE
│ │ │ │ +000113d0: 503a 204b 4443 2d52 4550 2074 6f20 6164  P: KDC-REP to ad
│ │ │ │ +000113e0: 6420 7469 636b 6574 2066 6965 6c64 2074  d ticket field t
│ │ │ │ +000113f0: 6f2e 0a20 2020 2020 5449 434b 4554 3a20  o..     TICKET: 
│ │ │ │ +00011400: 696e 7075 7420 7469 636b 6574 2074 6f20  input ticket to 
│ │ │ │ +00011410: 636f 7079 2069 6e74 6f20 4b44 432d 5245  copy into KDC-RE
│ │ │ │ +00011420: 5020 7469 636b 6574 2066 6965 6c64 2e0a  P ticket field..
│ │ │ │ +00011430: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +00011440: 6f6e 3a2a 2043 6f70 7920 7469 636b 6574  on:* Copy ticket
│ │ │ │ +00011450: 2069 6e74 6f20 4b44 432d 5245 502e 0a0a   into KDC-REP...
│ │ │ │ +00011460: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ +00011470: 7565 3a2a 2052 6574 7572 6e73 2053 4849  ue:* Returns SHI
│ │ │ │ +00011480: 5348 495f 4f4b 2069 6666 2073 7563 6365  SHI_OK iff succe
│ │ │ │ +00011490: 7373 6675 6c2e 0a0a 7368 6973 6869 5f6b  ssful...shishi_k
│ │ │ │ +000114a0: 6463 7265 705f 7365 745f 656e 635f 7061  dcrep_set_enc_pa
│ │ │ │ +000114b0: 7274 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  rt.-------------
│ │ │ │ +000114c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ +000114d0: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ +000114e0: 2073 6869 7368 695f 6b64 6372 6570 5f73   shishi_kdcrep_s
│ │ │ │ +000114f0: 6574 5f65 6e63 5f70 6172 7420 2853 6869  et_enc_part (Shi
│ │ │ │ +00011500: 7368 6920 2a20 4841 4e44 4c45 2c0a 2020  shi * HANDLE,.  
│ │ │ │ +00011510: 2020 2020 2020 2020 5368 6973 6869 5f61          Shishi_a
│ │ │ │ +00011520: 736e 3120 4b44 4352 4550 2c20 696e 7433  sn1 KDCREP, int3
│ │ │ │ +00011530: 325f 7420 4554 5950 452c 2075 696e 7433  2_t ETYPE, uint3
│ │ │ │ +00011540: 325f 7420 4b56 4e4f 2c0a 2020 2020 2020  2_t KVNO,.      
│ │ │ │ +00011550: 2020 2020 636f 6e73 7420 6368 6172 202a      const char *
│ │ │ │ +00011560: 2042 5546 2c20 7369 7a65 5f74 2042 5546   BUF, size_t BUF
│ │ │ │ +00011570: 4c45 4e29 0a20 2020 2020 4841 4e44 4c45  LEN).     HANDLE
│ │ │ │ +00011580: 3a20 7368 6973 6869 2068 616e 646c 6520  : shishi handle 
│ │ │ │ +00011590: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ +000115a0: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ +000115b0: e280 992e 0a20 2020 2020 4b44 4352 4550  .....     KDCREP
│ │ │ │ +000115c0: 3a20 4b44 432d 5245 5020 746f 2061 6464  : KDC-REP to add
│ │ │ │ +000115d0: 2065 6e63 2d70 6172 7420 6669 656c 6420   enc-part field 
│ │ │ │ +000115e0: 746f 2e0a 2020 2020 2045 5459 5045 3a20  to..     ETYPE: 
│ │ │ │ +000115f0: 656e 6372 7970 7469 6f6e 2074 7970 6520  encryption type 
│ │ │ │ +00011600: 7573 6564 2074 6f20 656e 6372 7970 7420  used to encrypt 
│ │ │ │ +00011610: 656e 632d 7061 7274 2e0a 2020 2020 204b  enc-part..     K
│ │ │ │ +00011620: 564e 4f3a 206b 6579 2076 6572 7369 6f6e  VNO: key version
│ │ │ │ +00011630: 206e 756d 6265 722e 0a20 2020 2020 4255   number..     BU
│ │ │ │ +00011640: 463a 2069 6e70 7574 2061 7272 6179 2077  F: input array w
│ │ │ │ +00011650: 6974 6820 656e 6372 7970 7465 6420 656e  ith encrypted en
│ │ │ │ +00011660: 632d 7061 7274 2e0a 2020 2020 2042 5546  c-part..     BUF
│ │ │ │ +00011670: 4c45 4e3a 2073 697a 6520 6f66 2069 6e70  LEN: size of inp
│ │ │ │ +00011680: 7574 2061 7272 6179 2077 6974 6820 656e  ut array with en
│ │ │ │ +00011690: 6372 7970 7465 6420 656e 632d 7061 7274  crypted enc-part
│ │ │ │ +000116a0: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ +000116b0: 7469 6f6e 3a2a 2053 6574 2074 6865 2065  tion:* Set the e
│ │ │ │ +000116c0: 6e63 7279 7074 6564 2065 6e63 2d70 6172  ncrypted enc-par
│ │ │ │ +000116d0: 7420 6669 656c 6420 696e 2074 6865 204b  t field in the K
│ │ │ │ +000116e0: 4443 2d52 4550 2e20 5468 650a 2020 2020  DC-REP. The.    
│ │ │ │ +000116f0: 2065 6e63 7279 7074 6564 2064 6174 6120   encrypted data 
│ │ │ │ +00011700: 6973 2075 7375 616c 6c79 2063 7265 6174  is usually creat
│ │ │ │ +00011710: 6564 2062 7920 6361 6c6c 696e 6720 e280  ed by calling ..
│ │ │ │ +00011720: 9873 6869 7368 695f 656e 6372 7970 7428  .shishi_encrypt(
│ │ │ │ +00011730: 29e2 8099 206f 6e0a 2020 2020 2074 6865  )... on.     the
│ │ │ │ +00011740: 2044 4552 2065 6e63 6f64 6564 2065 6e63   DER encoded enc
│ │ │ │ +00011750: 2d70 6172 742e 2020 546f 2073 6176 6520  -part.  To save 
│ │ │ │ +00011760: 7469 6d65 2c20 796f 7520 6d61 7920 7761  time, you may wa
│ │ │ │ +00011770: 6e74 2074 6f20 7573 650a 2020 2020 20e2  nt to use.     .
│ │ │ │ +00011780: 8098 7368 6973 6869 5f6b 6463 7265 705f  ..shishi_kdcrep_
│ │ │ │ +00011790: 6164 645f 656e 635f 7061 7274 2829 e280  add_enc_part()..
│ │ │ │ +000117a0: 9920 696e 7374 6561 642c 2077 6869 6368  . instead, which
│ │ │ │ +000117b0: 2063 616c 6375 6c61 7465 7320 7468 650a   calculates the.
│ │ │ │ +000117c0: 2020 2020 2065 6e63 7279 7074 6564 2064       encrypted d
│ │ │ │ +000117d0: 6174 6120 616e 6420 6361 6c6c 7320 7468  ata and calls th
│ │ │ │ +000117e0: 6973 2066 756e 6374 696f 6e20 696e 206f  is function in o
│ │ │ │ +000117f0: 6e65 2073 7465 702e 0a0a 2020 2020 202a  ne step...     *
│ │ │ │ +00011800: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ +00011810: 6574 7572 6e73 2053 4849 5348 495f 4f4b  eturns SHISHI_OK
│ │ │ │ +00011820: 2069 6666 2073 7563 6365 7373 6675 6c2e   iff successful.
│ │ │ │ +00011830: 0a0a 7368 6973 6869 5f6b 6463 7265 705f  ..shishi_kdcrep_
│ │ │ │ +00011840: 6164 645f 656e 635f 7061 7274 0a2d 2d2d  add_enc_part.---
│ │ │ │  00011850: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00011860: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ -00011870: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ -00011880: 5f6b 6463 7265 705f 6164 645f 656e 635f  _kdcrep_add_enc_
│ │ │ │ -00011890: 7061 7274 2028 5368 6973 6869 202a 2048  part (Shishi * H
│ │ │ │ -000118a0: 414e 444c 452c 0a20 2020 2020 2020 2020  ANDLE,.         
│ │ │ │ -000118b0: 2053 6869 7368 695f 6173 6e31 204b 4443   Shishi_asn1 KDC
│ │ │ │ -000118c0: 5245 502c 2053 6869 7368 695f 6b65 7920  REP, Shishi_key 
│ │ │ │ -000118d0: 2a20 4b45 592c 2069 6e74 204b 4559 5553  * KEY, int KEYUS
│ │ │ │ -000118e0: 4147 452c 0a20 2020 2020 2020 2020 2053  AGE,.          S
│ │ │ │ -000118f0: 6869 7368 695f 6173 6e31 2045 4e43 4b44  hishi_asn1 ENCKD
│ │ │ │ -00011900: 4352 4550 5041 5254 290a 2020 2020 2048  CREPPART).     H
│ │ │ │ -00011910: 414e 444c 453a 2073 6869 7368 6920 6861  ANDLE: shishi ha
│ │ │ │ -00011920: 6e64 6c65 2061 7320 616c 6c6f 6361 7465  ndle as allocate
│ │ │ │ -00011930: 6420 6279 20e2 8098 7368 6973 6869 5f69  d by ...shishi_i
│ │ │ │ -00011940: 6e69 7428 29e2 8099 2e0a 2020 2020 204b  nit().....     K
│ │ │ │ -00011950: 4443 5245 503a 204b 4443 2d52 4550 2074  DCREP: KDC-REP t
│ │ │ │ -00011960: 6f20 6164 6420 656e 632d 7061 7274 2066  o add enc-part f
│ │ │ │ -00011970: 6965 6c64 2074 6f2e 0a20 2020 2020 4b45  ield to..     KE
│ │ │ │ -00011980: 593a 206b 6579 2075 7365 6420 746f 2065  Y: key used to e
│ │ │ │ -00011990: 6e63 7279 7074 2065 6e63 2d70 6172 742e  ncrypt enc-part.
│ │ │ │ -000119a0: 0a20 2020 2020 4b45 5955 5341 4745 3a20  .     KEYUSAGE: 
│ │ │ │ -000119b0: 6b65 7920 7573 6167 6520 746f 2075 7365  key usage to use
│ │ │ │ -000119c0: 2c20 6e6f 726d 616c 6c79 2053 4849 5348  , normally SHISH
│ │ │ │ -000119d0: 495f 4b45 5955 5341 4745 5f45 4e43 4153  I_KEYUSAGE_ENCAS
│ │ │ │ -000119e0: 5245 5050 4152 542c 0a20 2020 2020 5348  REPPART,.     SH
│ │ │ │ -000119f0: 4953 4849 5f4b 4559 5553 4147 455f 454e  ISHI_KEYUSAGE_EN
│ │ │ │ -00011a00: 4354 4753 5245 5050 4152 545f 5345 5353  CTGSREPPART_SESS
│ │ │ │ -00011a10: 494f 4e5f 4b45 5920 6f72 0a20 2020 2020  ION_KEY or.     
│ │ │ │ -00011a20: 5348 4953 4849 5f4b 4559 5553 4147 455f  SHISHI_KEYUSAGE_
│ │ │ │ -00011a30: 454e 4354 4753 5245 5050 4152 545f 4155  ENCTGSREPPART_AU
│ │ │ │ -00011a40: 5448 454e 5449 4341 544f 525f 4b45 592e  THENTICATOR_KEY.
│ │ │ │ -00011a50: 0a20 2020 2020 454e 434b 4443 5245 5050  .     ENCKDCREPP
│ │ │ │ -00011a60: 4152 543a 2045 6e63 4b44 4352 6570 5061  ART: EncKDCRepPa
│ │ │ │ -00011a70: 7274 2074 6f20 6164 642e 0a0a 2020 2020  rt to add...    
│ │ │ │ -00011a80: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ -00011a90: 456e 6372 7970 7473 2044 4552 2065 6e63  Encrypts DER enc
│ │ │ │ -00011aa0: 6f64 6564 2045 6e63 4b44 4352 6570 5061  oded EncKDCRepPa
│ │ │ │ -00011ab0: 7274 2075 7369 6e67 206b 6579 2061 6e64  rt using key and
│ │ │ │ -00011ac0: 0a20 2020 2020 7374 6f72 6573 2069 7420  .     stores it 
│ │ │ │ -00011ad0: 696e 2074 6865 204b 4443 2d52 4550 2e0a  in the KDC-REP..
│ │ │ │ -00011ae0: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ -00011af0: 6c75 653a 2a20 5265 7475 726e 7320 5348  lue:* Returns SH
│ │ │ │ -00011b00: 4953 4849 5f4f 4b20 6966 6620 7375 6363  ISHI_OK iff succ
│ │ │ │ -00011b10: 6573 7366 756c 2e0a 0a73 6869 7368 695f  essful...shishi_
│ │ │ │ -00011b20: 6b64 6372 6570 5f63 6c65 6172 5f70 6164  kdcrep_clear_pad
│ │ │ │ -00011b30: 6174 610a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ata.------------
│ │ │ │ -00011b40: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -00011b50: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ -00011b60: 7420 7368 6973 6869 5f6b 6463 7265 705f  t shishi_kdcrep_
│ │ │ │ -00011b70: 636c 6561 725f 7061 6461 7461 2028 5368  clear_padata (Sh
│ │ │ │ -00011b80: 6973 6869 202a 2048 414e 444c 452c 0a20  ishi * HANDLE,. 
│ │ │ │ -00011b90: 2020 2020 2020 2020 2053 6869 7368 695f           Shishi_
│ │ │ │ -00011ba0: 6173 6e31 204b 4443 5245 5029 0a20 2020  asn1 KDCREP).   
│ │ │ │ -00011bb0: 2020 4841 4e44 4c45 3a20 7368 6973 6869    HANDLE: shishi
│ │ │ │ -00011bc0: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ -00011bd0: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ -00011be0: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ -00011bf0: 2020 4b44 4352 4550 3a20 4b44 432d 5245    KDCREP: KDC-RE
│ │ │ │ -00011c00: 5020 746f 2072 656d 6f76 6520 5041 2d44  P to remove PA-D
│ │ │ │ -00011c10: 4154 4120 6672 6f6d 2e0a 0a20 2020 2020  ATA from...     
│ │ │ │ -00011c20: 2a44 6573 6372 6970 7469 6f6e 3a2a 2052  *Description:* R
│ │ │ │ -00011c30: 656d 6f76 6520 7468 6520 7061 6461 7461  emove the padata
│ │ │ │ -00011c40: 2066 6965 6c64 2066 726f 6d20 4b44 432d   field from KDC-
│ │ │ │ -00011c50: 5245 502e 0a0a 2020 2020 202a 5265 7475  REP...     *Retu
│ │ │ │ -00011c60: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ -00011c70: 6e73 2053 4849 5348 495f 4f4b 2069 6666  ns SHISHI_OK iff
│ │ │ │ -00011c80: 2073 7563 6365 7373 6675 6c2e 0a0a 7368   successful...sh
│ │ │ │ -00011c90: 6973 6869 5f65 6e63 6b64 6372 6570 7061  ishi_enckdcreppa
│ │ │ │ -00011ca0: 7274 5f67 6574 5f6b 6579 0a2d 2d2d 2d2d  rt_get_key.-----
│ │ │ │ +00011860: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +00011870: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ +00011880: 695f 6b64 6372 6570 5f61 6464 5f65 6e63  i_kdcrep_add_enc
│ │ │ │ +00011890: 5f70 6172 7420 2853 6869 7368 6920 2a20  _part (Shishi * 
│ │ │ │ +000118a0: 4841 4e44 4c45 2c0a 2020 2020 2020 2020  HANDLE,.        
│ │ │ │ +000118b0: 2020 5368 6973 6869 5f61 736e 3120 4b44    Shishi_asn1 KD
│ │ │ │ +000118c0: 4352 4550 2c20 5368 6973 6869 5f6b 6579  CREP, Shishi_key
│ │ │ │ +000118d0: 202a 204b 4559 2c20 696e 7420 4b45 5955   * KEY, int KEYU
│ │ │ │ +000118e0: 5341 4745 2c0a 2020 2020 2020 2020 2020  SAGE,.          
│ │ │ │ +000118f0: 5368 6973 6869 5f61 736e 3120 454e 434b  Shishi_asn1 ENCK
│ │ │ │ +00011900: 4443 5245 5050 4152 5429 0a20 2020 2020  DCREPPART).     
│ │ │ │ +00011910: 4841 4e44 4c45 3a20 7368 6973 6869 2068  HANDLE: shishi h
│ │ │ │ +00011920: 616e 646c 6520 6173 2061 6c6c 6f63 6174  andle as allocat
│ │ │ │ +00011930: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ +00011940: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ +00011950: 4b44 4352 4550 3a20 4b44 432d 5245 5020  KDCREP: KDC-REP 
│ │ │ │ +00011960: 746f 2061 6464 2065 6e63 2d70 6172 7420  to add enc-part 
│ │ │ │ +00011970: 6669 656c 6420 746f 2e0a 2020 2020 204b  field to..     K
│ │ │ │ +00011980: 4559 3a20 6b65 7920 7573 6564 2074 6f20  EY: key used to 
│ │ │ │ +00011990: 656e 6372 7970 7420 656e 632d 7061 7274  encrypt enc-part
│ │ │ │ +000119a0: 2e0a 2020 2020 204b 4559 5553 4147 453a  ..     KEYUSAGE:
│ │ │ │ +000119b0: 206b 6579 2075 7361 6765 2074 6f20 7573   key usage to us
│ │ │ │ +000119c0: 652c 206e 6f72 6d61 6c6c 7920 5348 4953  e, normally SHIS
│ │ │ │ +000119d0: 4849 5f4b 4559 5553 4147 455f 454e 4341  HI_KEYUSAGE_ENCA
│ │ │ │ +000119e0: 5352 4550 5041 5254 2c0a 2020 2020 2053  SREPPART,.     S
│ │ │ │ +000119f0: 4849 5348 495f 4b45 5955 5341 4745 5f45  HISHI_KEYUSAGE_E
│ │ │ │ +00011a00: 4e43 5447 5352 4550 5041 5254 5f53 4553  NCTGSREPPART_SES
│ │ │ │ +00011a10: 5349 4f4e 5f4b 4559 206f 720a 2020 2020  SION_KEY or.    
│ │ │ │ +00011a20: 2053 4849 5348 495f 4b45 5955 5341 4745   SHISHI_KEYUSAGE
│ │ │ │ +00011a30: 5f45 4e43 5447 5352 4550 5041 5254 5f41  _ENCTGSREPPART_A
│ │ │ │ +00011a40: 5554 4845 4e54 4943 4154 4f52 5f4b 4559  UTHENTICATOR_KEY
│ │ │ │ +00011a50: 2e0a 2020 2020 2045 4e43 4b44 4352 4550  ..     ENCKDCREP
│ │ │ │ +00011a60: 5041 5254 3a20 456e 634b 4443 5265 7050  PART: EncKDCRepP
│ │ │ │ +00011a70: 6172 7420 746f 2061 6464 2e0a 0a20 2020  art to add...   
│ │ │ │ +00011a80: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ +00011a90: 2045 6e63 7279 7074 7320 4445 5220 656e   Encrypts DER en
│ │ │ │ +00011aa0: 636f 6465 6420 456e 634b 4443 5265 7050  coded EncKDCRepP
│ │ │ │ +00011ab0: 6172 7420 7573 696e 6720 6b65 7920 616e  art using key an
│ │ │ │ +00011ac0: 640a 2020 2020 2073 746f 7265 7320 6974  d.     stores it
│ │ │ │ +00011ad0: 2069 6e20 7468 6520 4b44 432d 5245 502e   in the KDC-REP.
│ │ │ │ +00011ae0: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ +00011af0: 616c 7565 3a2a 2052 6574 7572 6e73 2053  alue:* Returns S
│ │ │ │ +00011b00: 4849 5348 495f 4f4b 2069 6666 2073 7563  HISHI_OK iff suc
│ │ │ │ +00011b10: 6365 7373 6675 6c2e 0a0a 7368 6973 6869  cessful...shishi
│ │ │ │ +00011b20: 5f6b 6463 7265 705f 636c 6561 725f 7061  _kdcrep_clear_pa
│ │ │ │ +00011b30: 6461 7461 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  data.-----------
│ │ │ │ +00011b40: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +00011b50: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ +00011b60: 6e74 2073 6869 7368 695f 6b64 6372 6570  nt shishi_kdcrep
│ │ │ │ +00011b70: 5f63 6c65 6172 5f70 6164 6174 6120 2853  _clear_padata (S
│ │ │ │ +00011b80: 6869 7368 6920 2a20 4841 4e44 4c45 2c0a  hishi * HANDLE,.
│ │ │ │ +00011b90: 2020 2020 2020 2020 2020 5368 6973 6869            Shishi
│ │ │ │ +00011ba0: 5f61 736e 3120 4b44 4352 4550 290a 2020  _asn1 KDCREP).  
│ │ │ │ +00011bb0: 2020 2048 414e 444c 453a 2073 6869 7368     HANDLE: shish
│ │ │ │ +00011bc0: 6920 6861 6e64 6c65 2061 7320 616c 6c6f  i handle as allo
│ │ │ │ +00011bd0: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ +00011be0: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ +00011bf0: 2020 204b 4443 5245 503a 204b 4443 2d52     KDCREP: KDC-R
│ │ │ │ +00011c00: 4550 2074 6f20 7265 6d6f 7665 2050 412d  EP to remove PA-
│ │ │ │ +00011c10: 4441 5441 2066 726f 6d2e 0a0a 2020 2020  DATA from...    
│ │ │ │ +00011c20: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ +00011c30: 5265 6d6f 7665 2074 6865 2070 6164 6174  Remove the padat
│ │ │ │ +00011c40: 6120 6669 656c 6420 6672 6f6d 204b 4443  a field from KDC
│ │ │ │ +00011c50: 2d52 4550 2e0a 0a20 2020 2020 2a52 6574  -REP...     *Ret
│ │ │ │ +00011c60: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ +00011c70: 726e 7320 5348 4953 4849 5f4f 4b20 6966  rns SHISHI_OK if
│ │ │ │ +00011c80: 6620 7375 6363 6573 7366 756c 2e0a 0a73  f successful...s
│ │ │ │ +00011c90: 6869 7368 695f 656e 636b 6463 7265 7070  hishi_enckdcrepp
│ │ │ │ +00011ca0: 6172 745f 6765 745f 6b65 790a 2d2d 2d2d  art_get_key.----
│ │ │ │  00011cb0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00011cc0: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ -00011cd0: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ -00011ce0: 695f 656e 636b 6463 7265 7070 6172 745f  i_enckdcreppart_
│ │ │ │ -00011cf0: 6765 745f 6b65 7920 2853 6869 7368 6920  get_key (Shishi 
│ │ │ │ -00011d00: 2a20 4841 4e44 4c45 2c0a 2020 2020 2020  * HANDLE,.      
│ │ │ │ -00011d10: 2020 2020 5368 6973 6869 5f61 736e 3120      Shishi_asn1 
│ │ │ │ -00011d20: 454e 434b 4443 5245 5050 4152 542c 2053  ENCKDCREPPART, S
│ │ │ │ -00011d30: 6869 7368 695f 6b65 7920 2a2a 204b 4559  hishi_key ** KEY
│ │ │ │ -00011d40: 290a 2020 2020 2048 414e 444c 453a 2073  ).     HANDLE: s
│ │ │ │ -00011d50: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ -00011d60: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ -00011d70: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ -00011d80: 2e0a 2020 2020 2045 4e43 4b44 4352 4550  ..     ENCKDCREP
│ │ │ │ -00011d90: 5041 5254 3a20 696e 7075 7420 456e 634b  PART: input EncK
│ │ │ │ -00011da0: 4443 5265 7050 6172 7420 7661 7269 6162  DCRepPart variab
│ │ │ │ -00011db0: 6c65 2e0a 2020 2020 204b 4559 3a20 6e65  le..     KEY: ne
│ │ │ │ -00011dc0: 776c 7920 616c 6c6f 6361 7465 6420 656e  wly allocated en
│ │ │ │ -00011dd0: 6372 7970 7469 6f6e 206b 6579 2068 616e  cryption key han
│ │ │ │ -00011de0: 646c 652e 0a0a 2020 2020 202a 4465 7363  dle...     *Desc
│ │ │ │ -00011df0: 7269 7074 696f 6e3a 2a20 4578 7472 6163  ription:* Extrac
│ │ │ │ -00011e00: 7420 7468 6520 6b65 7920 746f 2075 7365  t the key to use
│ │ │ │ -00011e10: 2077 6974 6820 7468 6520 7469 636b 6574   with the ticket
│ │ │ │ -00011e20: 2073 656e 7420 696e 2074 6865 0a20 2020   sent in the.   
│ │ │ │ -00011e30: 2020 4b44 432d 5245 5020 6173 736f 6369    KDC-REP associ
│ │ │ │ -00011e40: 6174 6564 2077 6974 6820 7468 6520 456e  ated with the En
│ │ │ │ -00011e50: 634b 4443 5265 7050 6172 7420 696e 7075  cKDCRepPart inpu
│ │ │ │ -00011e60: 7420 7661 7269 6162 6c65 2e0a 0a20 2020  t variable...   
│ │ │ │ -00011e70: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ -00011e80: 2a20 5265 7475 726e 7320 e280 9853 4849  * Returns ...SHI
│ │ │ │ -00011e90: 5348 495f 4f4b e280 9920 6966 6620 7375  SHI_OK... iff su
│ │ │ │ -00011ea0: 6363 6573 7366 756c 2e0a 0a73 6869 7368  ccessful...shish
│ │ │ │ -00011eb0: 695f 656e 636b 6463 7265 7070 6172 745f  i_enckdcreppart_
│ │ │ │ -00011ec0: 6b65 795f 7365 740a 2d2d 2d2d 2d2d 2d2d  key_set.--------
│ │ │ │ +00011cc0: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ +00011cd0: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ +00011ce0: 6869 5f65 6e63 6b64 6372 6570 7061 7274  hi_enckdcreppart
│ │ │ │ +00011cf0: 5f67 6574 5f6b 6579 2028 5368 6973 6869  _get_key (Shishi
│ │ │ │ +00011d00: 202a 2048 414e 444c 452c 0a20 2020 2020   * HANDLE,.     
│ │ │ │ +00011d10: 2020 2020 2053 6869 7368 695f 6173 6e31       Shishi_asn1
│ │ │ │ +00011d20: 2045 4e43 4b44 4352 4550 5041 5254 2c20   ENCKDCREPPART, 
│ │ │ │ +00011d30: 5368 6973 6869 5f6b 6579 202a 2a20 4b45  Shishi_key ** KE
│ │ │ │ +00011d40: 5929 0a20 2020 2020 4841 4e44 4c45 3a20  Y).     HANDLE: 
│ │ │ │ +00011d50: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ +00011d60: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ +00011d70: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ +00011d80: 992e 0a20 2020 2020 454e 434b 4443 5245  ...     ENCKDCRE
│ │ │ │ +00011d90: 5050 4152 543a 2069 6e70 7574 2045 6e63  PPART: input Enc
│ │ │ │ +00011da0: 4b44 4352 6570 5061 7274 2076 6172 6961  KDCRepPart varia
│ │ │ │ +00011db0: 626c 652e 0a20 2020 2020 4b45 593a 206e  ble..     KEY: n
│ │ │ │ +00011dc0: 6577 6c79 2061 6c6c 6f63 6174 6564 2065  ewly allocated e
│ │ │ │ +00011dd0: 6e63 7279 7074 696f 6e20 6b65 7920 6861  ncryption key ha
│ │ │ │ +00011de0: 6e64 6c65 2e0a 0a20 2020 2020 2a44 6573  ndle...     *Des
│ │ │ │ +00011df0: 6372 6970 7469 6f6e 3a2a 2045 7874 7261  cription:* Extra
│ │ │ │ +00011e00: 6374 2074 6865 206b 6579 2074 6f20 7573  ct the key to us
│ │ │ │ +00011e10: 6520 7769 7468 2074 6865 2074 6963 6b65  e with the ticke
│ │ │ │ +00011e20: 7420 7365 6e74 2069 6e20 7468 650a 2020  t sent in the.  
│ │ │ │ +00011e30: 2020 204b 4443 2d52 4550 2061 7373 6f63     KDC-REP assoc
│ │ │ │ +00011e40: 6961 7465 6420 7769 7468 2074 6865 2045  iated with the E
│ │ │ │ +00011e50: 6e63 4b44 4352 6570 5061 7274 2069 6e70  ncKDCRepPart inp
│ │ │ │ +00011e60: 7574 2076 6172 6961 626c 652e 0a0a 2020  ut variable...  
│ │ │ │ +00011e70: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ +00011e80: 3a2a 2052 6574 7572 6e73 20e2 8098 5348  :* Returns ...SH
│ │ │ │ +00011e90: 4953 4849 5f4f 4be2 8099 2069 6666 2073  ISHI_OK... iff s
│ │ │ │ +00011ea0: 7563 6365 7373 6675 6c2e 0a0a 7368 6973  uccessful...shis
│ │ │ │ +00011eb0: 6869 5f65 6e63 6b64 6372 6570 7061 7274  hi_enckdcreppart
│ │ │ │ +00011ec0: 5f6b 6579 5f73 6574 0a2d 2d2d 2d2d 2d2d  _key_set.-------
│ │ │ │  00011ed0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00011ee0: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -00011ef0: 6f6e 3a20 696e 7420 7368 6973 6869 5f65  on: int shishi_e
│ │ │ │ -00011f00: 6e63 6b64 6372 6570 7061 7274 5f6b 6579  nckdcreppart_key
│ │ │ │ -00011f10: 5f73 6574 2028 5368 6973 6869 202a 2048  _set (Shishi * H
│ │ │ │ -00011f20: 414e 444c 452c 0a20 2020 2020 2020 2020  ANDLE,.         
│ │ │ │ -00011f30: 2053 6869 7368 695f 6173 6e31 2045 4e43   Shishi_asn1 ENC
│ │ │ │ -00011f40: 4b44 4352 4550 5041 5254 2c20 5368 6973  KDCREPPART, Shis
│ │ │ │ -00011f50: 6869 5f6b 6579 202a 204b 4559 290a 2020  hi_key * KEY).  
│ │ │ │ -00011f60: 2020 2048 414e 444c 453a 2073 6869 7368     HANDLE: shish
│ │ │ │ -00011f70: 6920 6861 6e64 6c65 2061 7320 616c 6c6f  i handle as allo
│ │ │ │ -00011f80: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ -00011f90: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ -00011fa0: 2020 2045 4e43 4b44 4352 4550 5041 5254     ENCKDCREPPART
│ │ │ │ -00011fb0: 3a20 696e 7075 7420 456e 634b 4443 5265  : input EncKDCRe
│ │ │ │ -00011fc0: 7050 6172 7420 7661 7269 6162 6c65 2e0a  pPart variable..
│ │ │ │ -00011fd0: 2020 2020 204b 4559 3a20 6b65 7920 6861       KEY: key ha
│ │ │ │ -00011fe0: 6e64 6c65 2077 6974 6820 696e 666f 726d  ndle with inform
│ │ │ │ -00011ff0: 6174 696f 6e20 746f 2073 746f 7265 2069  ation to store i
│ │ │ │ -00012000: 6e20 656e 636b 6463 7265 7070 6172 742e  n enckdcreppart.
│ │ │ │ -00012010: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ -00012020: 696f 6e3a 2a20 5365 7420 7468 6520 456e  ion:* Set the En
│ │ │ │ -00012030: 634b 4443 5265 7050 6172 742e 6b65 7920  cKDCRepPart.key 
│ │ │ │ -00012040: 6669 656c 6420 746f 206b 6579 2074 7970  field to key typ
│ │ │ │ -00012050: 6520 616e 640a 2020 2020 2076 616c 7565  e and.     value
│ │ │ │ -00012060: 206f 6620 7375 7070 6c69 6564 206b 6579   of supplied key
│ │ │ │ -00012070: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ -00012080: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ -00012090: e280 9853 4849 5348 495f 4f4b e280 9920  ...SHISHI_OK... 
│ │ │ │ -000120a0: 6966 6620 7375 6363 6573 7366 756c 2e0a  iff successful..
│ │ │ │ -000120b0: 0a73 6869 7368 695f 656e 636b 6463 7265  .shishi_enckdcre
│ │ │ │ -000120c0: 7070 6172 745f 6e6f 6e63 655f 7365 740a  ppart_nonce_set.
│ │ │ │ -000120d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000120e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -000120f0: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ -00012100: 7420 7368 6973 6869 5f65 6e63 6b64 6372  t shishi_enckdcr
│ │ │ │ -00012110: 6570 7061 7274 5f6e 6f6e 6365 5f73 6574  eppart_nonce_set
│ │ │ │ -00012120: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ -00012130: 452c 0a20 2020 2020 2020 2020 2053 6869  E,.          Shi
│ │ │ │ -00012140: 7368 695f 6173 6e31 2045 4e43 4b44 4352  shi_asn1 ENCKDCR
│ │ │ │ -00012150: 4550 5041 5254 2c20 7569 6e74 3332 5f74  EPPART, uint32_t
│ │ │ │ -00012160: 204e 4f4e 4345 290a 2020 2020 2048 414e   NONCE).     HAN
│ │ │ │ -00012170: 444c 453a 2073 6869 7368 6920 6861 6e64  DLE: shishi hand
│ │ │ │ -00012180: 6c65 2061 7320 616c 6c6f 6361 7465 6420  le as allocated 
│ │ │ │ -00012190: 6279 20e2 8098 7368 6973 6869 5f69 6e69  by ...shishi_ini
│ │ │ │ -000121a0: 7428 29e2 8099 2e0a 2020 2020 2045 4e43  t().....     ENC
│ │ │ │ -000121b0: 4b44 4352 4550 5041 5254 3a20 696e 7075  KDCREPPART: inpu
│ │ │ │ -000121c0: 7420 456e 634b 4443 5265 7050 6172 7420  t EncKDCRepPart 
│ │ │ │ -000121d0: 7661 7269 6162 6c65 2e0a 2020 2020 204e  variable..     N
│ │ │ │ -000121e0: 4f4e 4345 3a20 6e6f 6e63 6520 746f 2073  ONCE: nonce to s
│ │ │ │ -000121f0: 6574 2069 6e20 456e 634b 4443 5265 7050  et in EncKDCRepP
│ │ │ │ -00012200: 6172 742e 0a0a 2020 2020 202a 4465 7363  art...     *Desc
│ │ │ │ -00012210: 7269 7074 696f 6e3a 2a20 5365 7420 7468  ription:* Set th
│ │ │ │ -00012220: 6520 456e 634b 4443 5265 7050 6172 742e  e EncKDCRepPart.
│ │ │ │ -00012230: 6e6f 6e63 6520 6669 656c 642e 0a0a 2020  nonce field...  
│ │ │ │ -00012240: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ -00012250: 3a2a 2052 6574 7572 6e73 20e2 8098 5348  :* Returns ...SH
│ │ │ │ -00012260: 4953 4849 5f4f 4be2 8099 2069 6666 2073  ISHI_OK... iff s
│ │ │ │ -00012270: 7563 6365 7373 6675 6c2e 0a0a 7368 6973  uccessful...shis
│ │ │ │ -00012280: 6869 5f65 6e63 6b64 6372 6570 7061 7274  hi_enckdcreppart
│ │ │ │ -00012290: 5f66 6c61 6773 5f73 6574 0a2d 2d2d 2d2d  _flags_set.-----
│ │ │ │ +00011ee0: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +00011ef0: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ +00011f00: 656e 636b 6463 7265 7070 6172 745f 6b65  enckdcreppart_ke
│ │ │ │ +00011f10: 795f 7365 7420 2853 6869 7368 6920 2a20  y_set (Shishi * 
│ │ │ │ +00011f20: 4841 4e44 4c45 2c0a 2020 2020 2020 2020  HANDLE,.        
│ │ │ │ +00011f30: 2020 5368 6973 6869 5f61 736e 3120 454e    Shishi_asn1 EN
│ │ │ │ +00011f40: 434b 4443 5245 5050 4152 542c 2053 6869  CKDCREPPART, Shi
│ │ │ │ +00011f50: 7368 695f 6b65 7920 2a20 4b45 5929 0a20  shi_key * KEY). 
│ │ │ │ +00011f60: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ +00011f70: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ +00011f80: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ +00011f90: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ +00011fa0: 2020 2020 454e 434b 4443 5245 5050 4152      ENCKDCREPPAR
│ │ │ │ +00011fb0: 543a 2069 6e70 7574 2045 6e63 4b44 4352  T: input EncKDCR
│ │ │ │ +00011fc0: 6570 5061 7274 2076 6172 6961 626c 652e  epPart variable.
│ │ │ │ +00011fd0: 0a20 2020 2020 4b45 593a 206b 6579 2068  .     KEY: key h
│ │ │ │ +00011fe0: 616e 646c 6520 7769 7468 2069 6e66 6f72  andle with infor
│ │ │ │ +00011ff0: 6d61 7469 6f6e 2074 6f20 7374 6f72 6520  mation to store 
│ │ │ │ +00012000: 696e 2065 6e63 6b64 6372 6570 7061 7274  in enckdcreppart
│ │ │ │ +00012010: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ +00012020: 7469 6f6e 3a2a 2053 6574 2074 6865 2045  tion:* Set the E
│ │ │ │ +00012030: 6e63 4b44 4352 6570 5061 7274 2e6b 6579  ncKDCRepPart.key
│ │ │ │ +00012040: 2066 6965 6c64 2074 6f20 6b65 7920 7479   field to key ty
│ │ │ │ +00012050: 7065 2061 6e64 0a20 2020 2020 7661 6c75  pe and.     valu
│ │ │ │ +00012060: 6520 6f66 2073 7570 706c 6965 6420 6b65  e of supplied ke
│ │ │ │ +00012070: 792e 0a0a 2020 2020 202a 5265 7475 726e  y...     *Return
│ │ │ │ +00012080: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ +00012090: 20e2 8098 5348 4953 4849 5f4f 4be2 8099   ...SHISHI_OK...
│ │ │ │ +000120a0: 2069 6666 2073 7563 6365 7373 6675 6c2e   iff successful.
│ │ │ │ +000120b0: 0a0a 7368 6973 6869 5f65 6e63 6b64 6372  ..shishi_enckdcr
│ │ │ │ +000120c0: 6570 7061 7274 5f6e 6f6e 6365 5f73 6574  eppart_nonce_set
│ │ │ │ +000120d0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ +000120e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +000120f0: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ +00012100: 6e74 2073 6869 7368 695f 656e 636b 6463  nt shishi_enckdc
│ │ │ │ +00012110: 7265 7070 6172 745f 6e6f 6e63 655f 7365  reppart_nonce_se
│ │ │ │ +00012120: 7420 2853 6869 7368 6920 2a20 4841 4e44  t (Shishi * HAND
│ │ │ │ +00012130: 4c45 2c0a 2020 2020 2020 2020 2020 5368  LE,.          Sh
│ │ │ │ +00012140: 6973 6869 5f61 736e 3120 454e 434b 4443  ishi_asn1 ENCKDC
│ │ │ │ +00012150: 5245 5050 4152 542c 2075 696e 7433 325f  REPPART, uint32_
│ │ │ │ +00012160: 7420 4e4f 4e43 4529 0a20 2020 2020 4841  t NONCE).     HA
│ │ │ │ +00012170: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ +00012180: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ +00012190: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ +000121a0: 6974 2829 e280 992e 0a20 2020 2020 454e  it().....     EN
│ │ │ │ +000121b0: 434b 4443 5245 5050 4152 543a 2069 6e70  CKDCREPPART: inp
│ │ │ │ +000121c0: 7574 2045 6e63 4b44 4352 6570 5061 7274  ut EncKDCRepPart
│ │ │ │ +000121d0: 2076 6172 6961 626c 652e 0a20 2020 2020   variable..     
│ │ │ │ +000121e0: 4e4f 4e43 453a 206e 6f6e 6365 2074 6f20  NONCE: nonce to 
│ │ │ │ +000121f0: 7365 7420 696e 2045 6e63 4b44 4352 6570  set in EncKDCRep
│ │ │ │ +00012200: 5061 7274 2e0a 0a20 2020 2020 2a44 6573  Part...     *Des
│ │ │ │ +00012210: 6372 6970 7469 6f6e 3a2a 2053 6574 2074  cription:* Set t
│ │ │ │ +00012220: 6865 2045 6e63 4b44 4352 6570 5061 7274  he EncKDCRepPart
│ │ │ │ +00012230: 2e6e 6f6e 6365 2066 6965 6c64 2e0a 0a20  .nonce field... 
│ │ │ │ +00012240: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ +00012250: 653a 2a20 5265 7475 726e 7320 e280 9853  e:* Returns ...S
│ │ │ │ +00012260: 4849 5348 495f 4f4b e280 9920 6966 6620  HISHI_OK... iff 
│ │ │ │ +00012270: 7375 6363 6573 7366 756c 2e0a 0a73 6869  successful...shi
│ │ │ │ +00012280: 7368 695f 656e 636b 6463 7265 7070 6172  shi_enckdcreppar
│ │ │ │ +00012290: 745f 666c 6167 735f 7365 740a 2d2d 2d2d  t_flags_set.----
│ │ │ │  000122a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000122b0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ -000122c0: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ -000122d0: 7368 695f 656e 636b 6463 7265 7070 6172  shi_enckdcreppar
│ │ │ │ -000122e0: 745f 666c 6167 735f 7365 7420 2853 6869  t_flags_set (Shi
│ │ │ │ -000122f0: 7368 6920 2a20 4841 4e44 4c45 2c0a 2020  shi * HANDLE,.  
│ │ │ │ -00012300: 2020 2020 2020 2020 5368 6973 6869 5f61          Shishi_a
│ │ │ │ -00012310: 736e 3120 454e 434b 4443 5245 5050 4152  sn1 ENCKDCREPPAR
│ │ │ │ -00012320: 542c 2069 6e74 2046 4c41 4753 290a 2020  T, int FLAGS).  
│ │ │ │ -00012330: 2020 2048 414e 444c 453a 2073 6869 7368     HANDLE: shish
│ │ │ │ -00012340: 6920 6861 6e64 6c65 2061 7320 616c 6c6f  i handle as allo
│ │ │ │ -00012350: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ -00012360: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ -00012370: 2020 2045 4e43 4b44 4352 4550 5041 5254     ENCKDCREPPART
│ │ │ │ -00012380: 3a20 696e 7075 7420 456e 634b 4443 5265  : input EncKDCRe
│ │ │ │ -00012390: 7050 6172 7420 7661 7269 6162 6c65 2e0a  pPart variable..
│ │ │ │ -000123a0: 2020 2020 2046 4c41 4753 3a20 666c 6167       FLAGS: flag
│ │ │ │ -000123b0: 7320 746f 2073 6574 2069 6e20 456e 634b  s to set in EncK
│ │ │ │ -000123c0: 4443 5265 7050 6172 742e 0a0a 2020 2020  DCRepPart...    
│ │ │ │ -000123d0: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ -000123e0: 5365 7420 7468 6520 456e 634b 4443 5265  Set the EncKDCRe
│ │ │ │ -000123f0: 7050 6172 742e 666c 6167 7320 6669 656c  pPart.flags fiel
│ │ │ │ -00012400: 642e 0a0a 2020 2020 202a 5265 7475 726e  d...     *Return
│ │ │ │ -00012410: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ -00012420: 20e2 8098 5348 4953 4849 5f4f 4be2 8099   ...SHISHI_OK...
│ │ │ │ -00012430: 2069 6666 2073 7563 6365 7373 6675 6c2e   iff successful.
│ │ │ │ -00012440: 0a0a 7368 6973 6869 5f65 6e63 6b64 6372  ..shishi_enckdcr
│ │ │ │ -00012450: 6570 7061 7274 5f61 7574 6874 696d 655f  eppart_authtime_
│ │ │ │ -00012460: 7365 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  set.------------
│ │ │ │ +000122b0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +000122c0: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ +000122d0: 6973 6869 5f65 6e63 6b64 6372 6570 7061  ishi_enckdcreppa
│ │ │ │ +000122e0: 7274 5f66 6c61 6773 5f73 6574 2028 5368  rt_flags_set (Sh
│ │ │ │ +000122f0: 6973 6869 202a 2048 414e 444c 452c 0a20  ishi * HANDLE,. 
│ │ │ │ +00012300: 2020 2020 2020 2020 2053 6869 7368 695f           Shishi_
│ │ │ │ +00012310: 6173 6e31 2045 4e43 4b44 4352 4550 5041  asn1 ENCKDCREPPA
│ │ │ │ +00012320: 5254 2c20 696e 7420 464c 4147 5329 0a20  RT, int FLAGS). 
│ │ │ │ +00012330: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ +00012340: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ +00012350: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ +00012360: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ +00012370: 2020 2020 454e 434b 4443 5245 5050 4152      ENCKDCREPPAR
│ │ │ │ +00012380: 543a 2069 6e70 7574 2045 6e63 4b44 4352  T: input EncKDCR
│ │ │ │ +00012390: 6570 5061 7274 2076 6172 6961 626c 652e  epPart variable.
│ │ │ │ +000123a0: 0a20 2020 2020 464c 4147 533a 2066 6c61  .     FLAGS: fla
│ │ │ │ +000123b0: 6773 2074 6f20 7365 7420 696e 2045 6e63  gs to set in Enc
│ │ │ │ +000123c0: 4b44 4352 6570 5061 7274 2e0a 0a20 2020  KDCRepPart...   
│ │ │ │ +000123d0: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ +000123e0: 2053 6574 2074 6865 2045 6e63 4b44 4352   Set the EncKDCR
│ │ │ │ +000123f0: 6570 5061 7274 2e66 6c61 6773 2066 6965  epPart.flags fie
│ │ │ │ +00012400: 6c64 2e0a 0a20 2020 2020 2a52 6574 7572  ld...     *Retur
│ │ │ │ +00012410: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ +00012420: 7320 e280 9853 4849 5348 495f 4f4b e280  s ...SHISHI_OK..
│ │ │ │ +00012430: 9920 6966 6620 7375 6363 6573 7366 756c  . iff successful
│ │ │ │ +00012440: 2e0a 0a73 6869 7368 695f 656e 636b 6463  ...shishi_enckdc
│ │ │ │ +00012450: 7265 7070 6172 745f 6175 7468 7469 6d65  reppart_authtime
│ │ │ │ +00012460: 5f73 6574 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  _set.-----------
│ │ │ │  00012470: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00012480: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ -00012490: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ -000124a0: 656e 636b 6463 7265 7070 6172 745f 6175  enckdcreppart_au
│ │ │ │ -000124b0: 7468 7469 6d65 5f73 6574 2028 5368 6973  thtime_set (Shis
│ │ │ │ -000124c0: 6869 202a 2048 414e 444c 452c 0a20 2020  hi * HANDLE,.   
│ │ │ │ -000124d0: 2020 2020 2020 2053 6869 7368 695f 6173         Shishi_as
│ │ │ │ -000124e0: 6e31 2045 4e43 4b44 4352 4550 5041 5254  n1 ENCKDCREPPART
│ │ │ │ -000124f0: 2c20 636f 6e73 7420 6368 6172 202a 2041  , const char * A
│ │ │ │ -00012500: 5554 4854 494d 4529 0a20 2020 2020 4841  UTHTIME).     HA
│ │ │ │ -00012510: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ -00012520: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ -00012530: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ -00012540: 6974 2829 e280 992e 0a20 2020 2020 454e  it().....     EN
│ │ │ │ -00012550: 434b 4443 5245 5050 4152 543a 2069 6e70  CKDCREPPART: inp
│ │ │ │ -00012560: 7574 2045 6e63 4b44 4352 6570 5061 7274  ut EncKDCRepPart
│ │ │ │ -00012570: 2076 6172 6961 626c 652e 0a20 2020 2020   variable..     
│ │ │ │ -00012580: 4155 5448 5449 4d45 3a20 6368 6172 6163  AUTHTIME: charac
│ │ │ │ -00012590: 7465 7220 6275 6666 6572 2063 6f6e 7461  ter buffer conta
│ │ │ │ -000125a0: 696e 696e 6720 6120 6765 6e65 7261 6c69  ining a generali
│ │ │ │ -000125b0: 7a65 6420 7469 6d65 2073 7472 696e 672e  zed time string.
│ │ │ │ -000125c0: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ -000125d0: 696f 6e3a 2a20 5365 7420 7468 6520 456e  ion:* Set the En
│ │ │ │ -000125e0: 6354 6963 6b65 7450 6172 742e 6175 7468  cTicketPart.auth
│ │ │ │ -000125f0: 7469 6d65 2074 6f20 7375 7070 6c69 6564  time to supplied
│ │ │ │ -00012600: 2076 616c 7565 2e0a 0a20 2020 2020 2a52   value...     *R
│ │ │ │ -00012610: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ -00012620: 7475 726e 7320 e280 9853 4849 5348 495f  turns ...SHISHI_
│ │ │ │ -00012630: 4f4b e280 9920 6966 6620 7375 6363 6573  OK... iff succes
│ │ │ │ -00012640: 7366 756c 2e0a 0a73 6869 7368 695f 656e  sful...shishi_en
│ │ │ │ -00012650: 636b 6463 7265 7070 6172 745f 7374 6172  ckdcreppart_star
│ │ │ │ -00012660: 7474 696d 655f 7365 740a 2d2d 2d2d 2d2d  ttime_set.------
│ │ │ │ +00012480: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ +00012490: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ +000124a0: 5f65 6e63 6b64 6372 6570 7061 7274 5f61  _enckdcreppart_a
│ │ │ │ +000124b0: 7574 6874 696d 655f 7365 7420 2853 6869  uthtime_set (Shi
│ │ │ │ +000124c0: 7368 6920 2a20 4841 4e44 4c45 2c0a 2020  shi * HANDLE,.  
│ │ │ │ +000124d0: 2020 2020 2020 2020 5368 6973 6869 5f61          Shishi_a
│ │ │ │ +000124e0: 736e 3120 454e 434b 4443 5245 5050 4152  sn1 ENCKDCREPPAR
│ │ │ │ +000124f0: 542c 2063 6f6e 7374 2063 6861 7220 2a20  T, const char * 
│ │ │ │ +00012500: 4155 5448 5449 4d45 290a 2020 2020 2048  AUTHTIME).     H
│ │ │ │ +00012510: 414e 444c 453a 2073 6869 7368 6920 6861  ANDLE: shishi ha
│ │ │ │ +00012520: 6e64 6c65 2061 7320 616c 6c6f 6361 7465  ndle as allocate
│ │ │ │ +00012530: 6420 6279 20e2 8098 7368 6973 6869 5f69  d by ...shishi_i
│ │ │ │ +00012540: 6e69 7428 29e2 8099 2e0a 2020 2020 2045  nit().....     E
│ │ │ │ +00012550: 4e43 4b44 4352 4550 5041 5254 3a20 696e  NCKDCREPPART: in
│ │ │ │ +00012560: 7075 7420 456e 634b 4443 5265 7050 6172  put EncKDCRepPar
│ │ │ │ +00012570: 7420 7661 7269 6162 6c65 2e0a 2020 2020  t variable..    
│ │ │ │ +00012580: 2041 5554 4854 494d 453a 2063 6861 7261   AUTHTIME: chara
│ │ │ │ +00012590: 6374 6572 2062 7566 6665 7220 636f 6e74  cter buffer cont
│ │ │ │ +000125a0: 6169 6e69 6e67 2061 2067 656e 6572 616c  aining a general
│ │ │ │ +000125b0: 697a 6564 2074 696d 6520 7374 7269 6e67  ized time string
│ │ │ │ +000125c0: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ +000125d0: 7469 6f6e 3a2a 2053 6574 2074 6865 2045  tion:* Set the E
│ │ │ │ +000125e0: 6e63 5469 636b 6574 5061 7274 2e61 7574  ncTicketPart.aut
│ │ │ │ +000125f0: 6874 696d 6520 746f 2073 7570 706c 6965  htime to supplie
│ │ │ │ +00012600: 6420 7661 6c75 652e 0a0a 2020 2020 202a  d value...     *
│ │ │ │ +00012610: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ +00012620: 6574 7572 6e73 20e2 8098 5348 4953 4849  eturns ...SHISHI
│ │ │ │ +00012630: 5f4f 4be2 8099 2069 6666 2073 7563 6365  _OK... iff succe
│ │ │ │ +00012640: 7373 6675 6c2e 0a0a 7368 6973 6869 5f65  ssful...shishi_e
│ │ │ │ +00012650: 6e63 6b64 6372 6570 7061 7274 5f73 7461  nckdcreppart_sta
│ │ │ │ +00012660: 7274 7469 6d65 5f73 6574 0a2d 2d2d 2d2d  rttime_set.-----
│ │ │ │  00012670: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00012680: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ -00012690: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ -000126a0: 7368 6973 6869 5f65 6e63 6b64 6372 6570  shishi_enckdcrep
│ │ │ │ -000126b0: 7061 7274 5f73 7461 7274 7469 6d65 5f73  part_starttime_s
│ │ │ │ -000126c0: 6574 2028 5368 6973 6869 202a 2048 414e  et (Shishi * HAN
│ │ │ │ -000126d0: 444c 452c 0a20 2020 2020 2020 2020 2053  DLE,.          S
│ │ │ │ -000126e0: 6869 7368 695f 6173 6e31 2045 4e43 4b44  hishi_asn1 ENCKD
│ │ │ │ -000126f0: 4352 4550 5041 5254 2c20 636f 6e73 7420  CREPPART, const 
│ │ │ │ -00012700: 6368 6172 202a 2053 5441 5254 5449 4d45  char * STARTTIME
│ │ │ │ -00012710: 290a 2020 2020 2048 414e 444c 453a 2073  ).     HANDLE: s
│ │ │ │ -00012720: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ -00012730: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ -00012740: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ -00012750: 2e0a 2020 2020 2045 4e43 4b44 4352 4550  ..     ENCKDCREP
│ │ │ │ -00012760: 5041 5254 3a20 696e 7075 7420 456e 634b  PART: input EncK
│ │ │ │ -00012770: 4443 5265 7050 6172 7420 7661 7269 6162  DCRepPart variab
│ │ │ │ -00012780: 6c65 2e0a 2020 2020 2053 5441 5254 5449  le..     STARTTI
│ │ │ │ -00012790: 4d45 3a20 6368 6172 6163 7465 7220 6275  ME: character bu
│ │ │ │ -000127a0: 6666 6572 2063 6f6e 7461 696e 696e 6720  ffer containing 
│ │ │ │ -000127b0: 6120 6765 6e65 7261 6c69 7a65 6420 7469  a generalized ti
│ │ │ │ -000127c0: 6d65 2073 7472 696e 672e 0a0a 2020 2020  me string...    
│ │ │ │ -000127d0: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ -000127e0: 5365 7420 7468 6520 456e 6354 6963 6b65  Set the EncTicke
│ │ │ │ -000127f0: 7450 6172 742e 7374 6172 7474 696d 6520  tPart.starttime 
│ │ │ │ -00012800: 746f 2073 7570 706c 6965 6420 7661 6c75  to supplied valu
│ │ │ │ -00012810: 652e 0a20 2020 2020 5573 6520 6120 4e55  e..     Use a NU
│ │ │ │ -00012820: 4c4c 2076 616c 7565 2066 6f72 2053 5441  LL value for STA
│ │ │ │ -00012830: 5254 5449 4d45 2074 6f20 7265 6d6f 7665  RTTIME to remove
│ │ │ │ -00012840: 2074 6865 2066 6965 6c64 2e0a 0a20 2020   the field...   
│ │ │ │ -00012850: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ -00012860: 2a20 5265 7475 726e 7320 e280 9853 4849  * Returns ...SHI
│ │ │ │ -00012870: 5348 495f 4f4b e280 9920 6966 6620 7375  SHI_OK... iff su
│ │ │ │ -00012880: 6363 6573 7366 756c 2e0a 0a73 6869 7368  ccessful...shish
│ │ │ │ -00012890: 695f 656e 636b 6463 7265 7070 6172 745f  i_enckdcreppart_
│ │ │ │ -000128a0: 656e 6474 696d 655f 7365 740a 2d2d 2d2d  endtime_set.----
│ │ │ │ +00012680: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ +00012690: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ +000126a0: 2073 6869 7368 695f 656e 636b 6463 7265   shishi_enckdcre
│ │ │ │ +000126b0: 7070 6172 745f 7374 6172 7474 696d 655f  ppart_starttime_
│ │ │ │ +000126c0: 7365 7420 2853 6869 7368 6920 2a20 4841  set (Shishi * HA
│ │ │ │ +000126d0: 4e44 4c45 2c0a 2020 2020 2020 2020 2020  NDLE,.          
│ │ │ │ +000126e0: 5368 6973 6869 5f61 736e 3120 454e 434b  Shishi_asn1 ENCK
│ │ │ │ +000126f0: 4443 5245 5050 4152 542c 2063 6f6e 7374  DCREPPART, const
│ │ │ │ +00012700: 2063 6861 7220 2a20 5354 4152 5454 494d   char * STARTTIM
│ │ │ │ +00012710: 4529 0a20 2020 2020 4841 4e44 4c45 3a20  E).     HANDLE: 
│ │ │ │ +00012720: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ +00012730: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ +00012740: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ +00012750: 992e 0a20 2020 2020 454e 434b 4443 5245  ...     ENCKDCRE
│ │ │ │ +00012760: 5050 4152 543a 2069 6e70 7574 2045 6e63  PPART: input Enc
│ │ │ │ +00012770: 4b44 4352 6570 5061 7274 2076 6172 6961  KDCRepPart varia
│ │ │ │ +00012780: 626c 652e 0a20 2020 2020 5354 4152 5454  ble..     STARTT
│ │ │ │ +00012790: 494d 453a 2063 6861 7261 6374 6572 2062  IME: character b
│ │ │ │ +000127a0: 7566 6665 7220 636f 6e74 6169 6e69 6e67  uffer containing
│ │ │ │ +000127b0: 2061 2067 656e 6572 616c 697a 6564 2074   a generalized t
│ │ │ │ +000127c0: 696d 6520 7374 7269 6e67 2e0a 0a20 2020  ime string...   
│ │ │ │ +000127d0: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ +000127e0: 2053 6574 2074 6865 2045 6e63 5469 636b   Set the EncTick
│ │ │ │ +000127f0: 6574 5061 7274 2e73 7461 7274 7469 6d65  etPart.starttime
│ │ │ │ +00012800: 2074 6f20 7375 7070 6c69 6564 2076 616c   to supplied val
│ │ │ │ +00012810: 7565 2e0a 2020 2020 2055 7365 2061 204e  ue..     Use a N
│ │ │ │ +00012820: 554c 4c20 7661 6c75 6520 666f 7220 5354  ULL value for ST
│ │ │ │ +00012830: 4152 5454 494d 4520 746f 2072 656d 6f76  ARTTIME to remov
│ │ │ │ +00012840: 6520 7468 6520 6669 656c 642e 0a0a 2020  e the field...  
│ │ │ │ +00012850: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ +00012860: 3a2a 2052 6574 7572 6e73 20e2 8098 5348  :* Returns ...SH
│ │ │ │ +00012870: 4953 4849 5f4f 4be2 8099 2069 6666 2073  ISHI_OK... iff s
│ │ │ │ +00012880: 7563 6365 7373 6675 6c2e 0a0a 7368 6973  uccessful...shis
│ │ │ │ +00012890: 6869 5f65 6e63 6b64 6372 6570 7061 7274  hi_enckdcreppart
│ │ │ │ +000128a0: 5f65 6e64 7469 6d65 5f73 6574 0a2d 2d2d  _endtime_set.---
│ │ │ │  000128b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000128c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ -000128d0: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ -000128e0: 7368 6973 6869 5f65 6e63 6b64 6372 6570  shishi_enckdcrep
│ │ │ │ -000128f0: 7061 7274 5f65 6e64 7469 6d65 5f73 6574  part_endtime_set
│ │ │ │ -00012900: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ -00012910: 452c 0a20 2020 2020 2020 2020 2053 6869  E,.          Shi
│ │ │ │ -00012920: 7368 695f 6173 6e31 2045 4e43 4b44 4352  shi_asn1 ENCKDCR
│ │ │ │ -00012930: 4550 5041 5254 2c20 636f 6e73 7420 6368  EPPART, const ch
│ │ │ │ -00012940: 6172 202a 2045 4e44 5449 4d45 290a 2020  ar * ENDTIME).  
│ │ │ │ -00012950: 2020 2048 414e 444c 453a 2073 6869 7368     HANDLE: shish
│ │ │ │ -00012960: 6920 6861 6e64 6c65 2061 7320 616c 6c6f  i handle as allo
│ │ │ │ -00012970: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ -00012980: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ -00012990: 2020 2045 4e43 4b44 4352 4550 5041 5254     ENCKDCREPPART
│ │ │ │ -000129a0: 3a20 696e 7075 7420 456e 634b 4443 5265  : input EncKDCRe
│ │ │ │ -000129b0: 7050 6172 7420 7661 7269 6162 6c65 2e0a  pPart variable..
│ │ │ │ -000129c0: 2020 2020 2045 4e44 5449 4d45 3a20 6368       ENDTIME: ch
│ │ │ │ -000129d0: 6172 6163 7465 7220 6275 6666 6572 2063  aracter buffer c
│ │ │ │ -000129e0: 6f6e 7461 696e 696e 6720 6120 6765 6e65  ontaining a gene
│ │ │ │ -000129f0: 7261 6c69 7a65 6420 7469 6d65 2073 7472  ralized time str
│ │ │ │ -00012a00: 696e 672e 0a0a 2020 2020 202a 4465 7363  ing...     *Desc
│ │ │ │ -00012a10: 7269 7074 696f 6e3a 2a20 5365 7420 7468  ription:* Set th
│ │ │ │ -00012a20: 6520 456e 6354 6963 6b65 7450 6172 742e  e EncTicketPart.
│ │ │ │ -00012a30: 656e 6474 696d 6520 746f 2073 7570 706c  endtime to suppl
│ │ │ │ -00012a40: 6965 6420 7661 6c75 652e 0a0a 2020 2020  ied value...    
│ │ │ │ -00012a50: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ -00012a60: 2052 6574 7572 6e73 20e2 8098 5348 4953   Returns ...SHIS
│ │ │ │ -00012a70: 4849 5f4f 4be2 8099 2069 6666 2073 7563  HI_OK... iff suc
│ │ │ │ -00012a80: 6365 7373 6675 6c2e 0a0a 7368 6973 6869  cessful...shishi
│ │ │ │ -00012a90: 5f65 6e63 6b64 6372 6570 7061 7274 5f72  _enckdcreppart_r
│ │ │ │ -00012aa0: 656e 6577 5f74 696c 6c5f 7365 740a 2d2d  enew_till_set.--
│ │ │ │ +000128c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ +000128d0: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ +000128e0: 2073 6869 7368 695f 656e 636b 6463 7265   shishi_enckdcre
│ │ │ │ +000128f0: 7070 6172 745f 656e 6474 696d 655f 7365  ppart_endtime_se
│ │ │ │ +00012900: 7420 2853 6869 7368 6920 2a20 4841 4e44  t (Shishi * HAND
│ │ │ │ +00012910: 4c45 2c0a 2020 2020 2020 2020 2020 5368  LE,.          Sh
│ │ │ │ +00012920: 6973 6869 5f61 736e 3120 454e 434b 4443  ishi_asn1 ENCKDC
│ │ │ │ +00012930: 5245 5050 4152 542c 2063 6f6e 7374 2063  REPPART, const c
│ │ │ │ +00012940: 6861 7220 2a20 454e 4454 494d 4529 0a20  har * ENDTIME). 
│ │ │ │ +00012950: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ +00012960: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ +00012970: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ +00012980: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ +00012990: 2020 2020 454e 434b 4443 5245 5050 4152      ENCKDCREPPAR
│ │ │ │ +000129a0: 543a 2069 6e70 7574 2045 6e63 4b44 4352  T: input EncKDCR
│ │ │ │ +000129b0: 6570 5061 7274 2076 6172 6961 626c 652e  epPart variable.
│ │ │ │ +000129c0: 0a20 2020 2020 454e 4454 494d 453a 2063  .     ENDTIME: c
│ │ │ │ +000129d0: 6861 7261 6374 6572 2062 7566 6665 7220  haracter buffer 
│ │ │ │ +000129e0: 636f 6e74 6169 6e69 6e67 2061 2067 656e  containing a gen
│ │ │ │ +000129f0: 6572 616c 697a 6564 2074 696d 6520 7374  eralized time st
│ │ │ │ +00012a00: 7269 6e67 2e0a 0a20 2020 2020 2a44 6573  ring...     *Des
│ │ │ │ +00012a10: 6372 6970 7469 6f6e 3a2a 2053 6574 2074  cription:* Set t
│ │ │ │ +00012a20: 6865 2045 6e63 5469 636b 6574 5061 7274  he EncTicketPart
│ │ │ │ +00012a30: 2e65 6e64 7469 6d65 2074 6f20 7375 7070  .endtime to supp
│ │ │ │ +00012a40: 6c69 6564 2076 616c 7565 2e0a 0a20 2020  lied value...   
│ │ │ │ +00012a50: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ +00012a60: 2a20 5265 7475 726e 7320 e280 9853 4849  * Returns ...SHI
│ │ │ │ +00012a70: 5348 495f 4f4b e280 9920 6966 6620 7375  SHI_OK... iff su
│ │ │ │ +00012a80: 6363 6573 7366 756c 2e0a 0a73 6869 7368  ccessful...shish
│ │ │ │ +00012a90: 695f 656e 636b 6463 7265 7070 6172 745f  i_enckdcreppart_
│ │ │ │ +00012aa0: 7265 6e65 775f 7469 6c6c 5f73 6574 0a2d  renew_till_set.-
│ │ │ │  00012ab0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │  00012ac0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00012ad0: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ -00012ae0: 2069 6e74 2073 6869 7368 695f 656e 636b   int shishi_enck
│ │ │ │ -00012af0: 6463 7265 7070 6172 745f 7265 6e65 775f  dcreppart_renew_
│ │ │ │ -00012b00: 7469 6c6c 5f73 6574 2028 5368 6973 6869  till_set (Shishi
│ │ │ │ -00012b10: 202a 2048 414e 444c 452c 0a20 2020 2020   * HANDLE,.     
│ │ │ │ -00012b20: 2020 2020 2053 6869 7368 695f 6173 6e31       Shishi_asn1
│ │ │ │ -00012b30: 2045 4e43 4b44 4352 4550 5041 5254 2c20   ENCKDCREPPART, 
│ │ │ │ -00012b40: 636f 6e73 7420 6368 6172 202a 2052 454e  const char * REN
│ │ │ │ -00012b50: 4557 5f54 494c 4c29 0a20 2020 2020 4841  EW_TILL).     HA
│ │ │ │ -00012b60: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ -00012b70: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ -00012b80: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ -00012b90: 6974 2829 e280 992e 0a20 2020 2020 454e  it().....     EN
│ │ │ │ -00012ba0: 434b 4443 5245 5050 4152 543a 2069 6e70  CKDCREPPART: inp
│ │ │ │ -00012bb0: 7574 2045 6e63 4b44 4352 6570 5061 7274  ut EncKDCRepPart
│ │ │ │ -00012bc0: 2076 6172 6961 626c 652e 0a20 2020 2020   variable..     
│ │ │ │ -00012bd0: 5245 4e45 575f 5449 4c4c 3a20 6368 6172  RENEW_TILL: char
│ │ │ │ -00012be0: 6163 7465 7220 6275 6666 6572 2063 6f6e  acter buffer con
│ │ │ │ -00012bf0: 7461 696e 696e 6720 6120 6765 6e65 7261  taining a genera
│ │ │ │ -00012c00: 6c69 7a65 6420 7469 6d65 2073 7472 696e  lized time strin
│ │ │ │ -00012c10: 672e 0a0a 2020 2020 202a 4465 7363 7269  g...     *Descri
│ │ │ │ -00012c20: 7074 696f 6e3a 2a20 5365 7420 7468 6520  ption:* Set the 
│ │ │ │ -00012c30: 456e 6354 6963 6b65 7450 6172 742e 7265  EncTicketPart.re
│ │ │ │ -00012c40: 6e65 772d 7469 6c6c 2074 6f20 7375 7070  new-till to supp
│ │ │ │ -00012c50: 6c69 6564 2076 616c 7565 2e0a 2020 2020  lied value..    
│ │ │ │ -00012c60: 2055 7365 2061 204e 554c 4c20 7661 6c75   Use a NULL valu
│ │ │ │ -00012c70: 6520 666f 7220 5245 4e45 575f 5449 4c4c  e for RENEW_TILL
│ │ │ │ -00012c80: 2074 6f20 7265 6d6f 7665 2074 6865 2066   to remove the f
│ │ │ │ -00012c90: 6965 6c64 2e0a 0a20 2020 2020 2a52 6574  ield...     *Ret
│ │ │ │ -00012ca0: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ -00012cb0: 726e 7320 e280 9853 4849 5348 495f 4f4b  rns ...SHISHI_OK
│ │ │ │ -00012cc0: e280 9920 6966 6620 7375 6363 6573 7366  ... iff successf
│ │ │ │ -00012cd0: 756c 2e0a 0a73 6869 7368 695f 656e 636b  ul...shishi_enck
│ │ │ │ -00012ce0: 6463 7265 7070 6172 745f 7372 6561 6c6d  dcreppart_srealm
│ │ │ │ -00012cf0: 5f73 6574 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  _set.-----------
│ │ │ │ +00012ad0: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ +00012ae0: 3a20 696e 7420 7368 6973 6869 5f65 6e63  : int shishi_enc
│ │ │ │ +00012af0: 6b64 6372 6570 7061 7274 5f72 656e 6577  kdcreppart_renew
│ │ │ │ +00012b00: 5f74 696c 6c5f 7365 7420 2853 6869 7368  _till_set (Shish
│ │ │ │ +00012b10: 6920 2a20 4841 4e44 4c45 2c0a 2020 2020  i * HANDLE,.    
│ │ │ │ +00012b20: 2020 2020 2020 5368 6973 6869 5f61 736e        Shishi_asn
│ │ │ │ +00012b30: 3120 454e 434b 4443 5245 5050 4152 542c  1 ENCKDCREPPART,
│ │ │ │ +00012b40: 2063 6f6e 7374 2063 6861 7220 2a20 5245   const char * RE
│ │ │ │ +00012b50: 4e45 575f 5449 4c4c 290a 2020 2020 2048  NEW_TILL).     H
│ │ │ │ +00012b60: 414e 444c 453a 2073 6869 7368 6920 6861  ANDLE: shishi ha
│ │ │ │ +00012b70: 6e64 6c65 2061 7320 616c 6c6f 6361 7465  ndle as allocate
│ │ │ │ +00012b80: 6420 6279 20e2 8098 7368 6973 6869 5f69  d by ...shishi_i
│ │ │ │ +00012b90: 6e69 7428 29e2 8099 2e0a 2020 2020 2045  nit().....     E
│ │ │ │ +00012ba0: 4e43 4b44 4352 4550 5041 5254 3a20 696e  NCKDCREPPART: in
│ │ │ │ +00012bb0: 7075 7420 456e 634b 4443 5265 7050 6172  put EncKDCRepPar
│ │ │ │ +00012bc0: 7420 7661 7269 6162 6c65 2e0a 2020 2020  t variable..    
│ │ │ │ +00012bd0: 2052 454e 4557 5f54 494c 4c3a 2063 6861   RENEW_TILL: cha
│ │ │ │ +00012be0: 7261 6374 6572 2062 7566 6665 7220 636f  racter buffer co
│ │ │ │ +00012bf0: 6e74 6169 6e69 6e67 2061 2067 656e 6572  ntaining a gener
│ │ │ │ +00012c00: 616c 697a 6564 2074 696d 6520 7374 7269  alized time stri
│ │ │ │ +00012c10: 6e67 2e0a 0a20 2020 2020 2a44 6573 6372  ng...     *Descr
│ │ │ │ +00012c20: 6970 7469 6f6e 3a2a 2053 6574 2074 6865  iption:* Set the
│ │ │ │ +00012c30: 2045 6e63 5469 636b 6574 5061 7274 2e72   EncTicketPart.r
│ │ │ │ +00012c40: 656e 6577 2d74 696c 6c20 746f 2073 7570  enew-till to sup
│ │ │ │ +00012c50: 706c 6965 6420 7661 6c75 652e 0a20 2020  plied value..   
│ │ │ │ +00012c60: 2020 5573 6520 6120 4e55 4c4c 2076 616c    Use a NULL val
│ │ │ │ +00012c70: 7565 2066 6f72 2052 454e 4557 5f54 494c  ue for RENEW_TIL
│ │ │ │ +00012c80: 4c20 746f 2072 656d 6f76 6520 7468 6520  L to remove the 
│ │ │ │ +00012c90: 6669 656c 642e 0a0a 2020 2020 202a 5265  field...     *Re
│ │ │ │ +00012ca0: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ +00012cb0: 7572 6e73 20e2 8098 5348 4953 4849 5f4f  urns ...SHISHI_O
│ │ │ │ +00012cc0: 4be2 8099 2069 6666 2073 7563 6365 7373  K... iff success
│ │ │ │ +00012cd0: 6675 6c2e 0a0a 7368 6973 6869 5f65 6e63  ful...shishi_enc
│ │ │ │ +00012ce0: 6b64 6372 6570 7061 7274 5f73 7265 616c  kdcreppart_sreal
│ │ │ │ +00012cf0: 6d5f 7365 740a 2d2d 2d2d 2d2d 2d2d 2d2d  m_set.----------
│ │ │ │  00012d00: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00012d10: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -00012d20: 6f6e 3a20 696e 7420 7368 6973 6869 5f65  on: int shishi_e
│ │ │ │ -00012d30: 6e63 6b64 6372 6570 7061 7274 5f73 7265  nckdcreppart_sre
│ │ │ │ -00012d40: 616c 6d5f 7365 7420 2853 6869 7368 6920  alm_set (Shishi 
│ │ │ │ -00012d50: 2a20 4841 4e44 4c45 2c0a 2020 2020 2020  * HANDLE,.      
│ │ │ │ -00012d60: 2020 2020 5368 6973 6869 5f61 736e 3120      Shishi_asn1 
│ │ │ │ -00012d70: 454e 434b 4443 5245 5050 4152 542c 2063  ENCKDCREPPART, c
│ │ │ │ -00012d80: 6f6e 7374 2063 6861 7220 2a20 5352 4541  onst char * SREA
│ │ │ │ -00012d90: 4c4d 290a 2020 2020 2048 414e 444c 453a  LM).     HANDLE:
│ │ │ │ -00012da0: 2073 6869 7368 6920 6861 6e64 6c65 2061   shishi handle a
│ │ │ │ -00012db0: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ -00012dc0: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ -00012dd0: 8099 2e0a 2020 2020 2045 4e43 4b44 4352  ....     ENCKDCR
│ │ │ │ -00012de0: 4550 5041 5254 3a20 456e 634b 4443 5265  EPPART: EncKDCRe
│ │ │ │ -00012df0: 7050 6172 7420 7661 7269 6162 6c65 2074  pPart variable t
│ │ │ │ -00012e00: 6f20 7365 7420 7265 616c 6d20 6669 656c  o set realm fiel
│ │ │ │ -00012e10: 6420 696e 2e0a 2020 2020 2053 5245 414c  d in..     SREAL
│ │ │ │ -00012e20: 4d3a 2069 6e70 7574 2061 7272 6179 2077  M: input array w
│ │ │ │ -00012e30: 6974 6820 6e61 6d65 206f 6620 7265 616c  ith name of real
│ │ │ │ -00012e40: 6d2e 0a0a 2020 2020 202a 4465 7363 7269  m...     *Descri
│ │ │ │ -00012e50: 7074 696f 6e3a 2a20 5365 7420 7468 6520  ption:* Set the 
│ │ │ │ -00012e60: 7365 7276 6572 2072 6561 6c6d 2066 6965  server realm fie
│ │ │ │ -00012e70: 6c64 2069 6e20 7468 6520 456e 634b 4443  ld in the EncKDC
│ │ │ │ -00012e80: 5265 7050 6172 742e 0a0a 2020 2020 202a  RepPart...     *
│ │ │ │ -00012e90: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ -00012ea0: 6574 7572 6e73 2053 4849 5348 495f 4f4b  eturns SHISHI_OK
│ │ │ │ -00012eb0: 2069 6666 2073 7563 6365 7373 6675 6c2e   iff successful.
│ │ │ │ -00012ec0: 0a0a 7368 6973 6869 5f65 6e63 6b64 6372  ..shishi_enckdcr
│ │ │ │ -00012ed0: 6570 7061 7274 5f73 6e61 6d65 5f73 6574  eppart_sname_set
│ │ │ │ -00012ee0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ -00012ef0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -00012f00: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ -00012f10: 6e74 2073 6869 7368 695f 656e 636b 6463  nt shishi_enckdc
│ │ │ │ -00012f20: 7265 7070 6172 745f 736e 616d 655f 7365  reppart_sname_se
│ │ │ │ -00012f30: 7420 2853 6869 7368 6920 2a20 4841 4e44  t (Shishi * HAND
│ │ │ │ -00012f40: 4c45 2c0a 2020 2020 2020 2020 2020 5368  LE,.          Sh
│ │ │ │ -00012f50: 6973 6869 5f61 736e 3120 454e 434b 4443  ishi_asn1 ENCKDC
│ │ │ │ -00012f60: 5245 5050 4152 542c 2053 6869 7368 695f  REPPART, Shishi_
│ │ │ │ -00012f70: 6e61 6d65 5f74 7970 6520 4e41 4d45 5f54  name_type NAME_T
│ │ │ │ -00012f80: 5950 452c 0a20 2020 2020 2020 2020 2063  YPE,.          c
│ │ │ │ -00012f90: 6861 7220 2a20 534e 414d 455b 5d29 0a20  har * SNAME[]). 
│ │ │ │ -00012fa0: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ -00012fb0: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ -00012fc0: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ -00012fd0: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ -00012fe0: 2020 2020 454e 434b 4443 5245 5050 4152      ENCKDCREPPAR
│ │ │ │ -00012ff0: 543a 2045 6e63 4b44 4352 6570 5061 7274  T: EncKDCRepPart
│ │ │ │ -00013000: 2076 6172 6961 626c 6520 746f 2073 6574   variable to set
│ │ │ │ -00013010: 2073 6572 7665 7220 6e61 6d65 2066 6965   server name fie
│ │ │ │ -00013020: 6c64 2069 6e2e 0a0a 2020 2020 204e 414d  ld in...     NAM
│ │ │ │ -00013030: 455f 5459 5045 3a20 7479 7065 206f 6620  E_TYPE: type of 
│ │ │ │ -00013040: 7072 696e 6369 7069 616c 2c20 7365 6520  principial, see 
│ │ │ │ -00013050: 5368 6973 6869 5f6e 616d 655f 7479 7065  Shishi_name_type
│ │ │ │ -00013060: 2c20 7573 7561 6c6c 790a 2020 2020 2053  , usually.     S
│ │ │ │ -00013070: 4849 5348 495f 4e54 5f55 4e4b 4e4f 574e  HISHI_NT_UNKNOWN
│ │ │ │ -00013080: 2e0a 2020 2020 2053 4e41 4d45 3a20 696e  ..     SNAME: in
│ │ │ │ -00013090: 7075 7420 6172 7261 7920 7769 7468 2070  put array with p
│ │ │ │ -000130a0: 7269 6e63 6970 616c 206e 616d 652e 0a0a  rincipal name...
│ │ │ │ -000130b0: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ -000130c0: 6e3a 2a20 5365 7420 7468 6520 7365 7276  n:* Set the serv
│ │ │ │ -000130d0: 6572 206e 616d 6520 6669 656c 6420 696e  er name field in
│ │ │ │ -000130e0: 2074 6865 2045 6e63 4b44 4352 6570 5061   the EncKDCRepPa
│ │ │ │ -000130f0: 7274 2e0a 0a20 2020 2020 2a52 6574 7572  rt...     *Retur
│ │ │ │ -00013100: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ -00013110: 7320 5348 4953 4849 5f4f 4b20 6966 6620  s SHISHI_OK iff 
│ │ │ │ -00013120: 7375 6363 6573 7366 756c 2e0a 0a73 6869  successful...shi
│ │ │ │ -00013130: 7368 695f 656e 636b 6463 7265 7070 6172  shi_enckdcreppar
│ │ │ │ -00013140: 745f 706f 7075 6c61 7465 5f65 6e63 7469  t_populate_encti
│ │ │ │ -00013150: 636b 6574 7061 7274 0a2d 2d2d 2d2d 2d2d  cketpart.-------
│ │ │ │ +00012d10: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +00012d20: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ +00012d30: 656e 636b 6463 7265 7070 6172 745f 7372  enckdcreppart_sr
│ │ │ │ +00012d40: 6561 6c6d 5f73 6574 2028 5368 6973 6869  ealm_set (Shishi
│ │ │ │ +00012d50: 202a 2048 414e 444c 452c 0a20 2020 2020   * HANDLE,.     
│ │ │ │ +00012d60: 2020 2020 2053 6869 7368 695f 6173 6e31       Shishi_asn1
│ │ │ │ +00012d70: 2045 4e43 4b44 4352 4550 5041 5254 2c20   ENCKDCREPPART, 
│ │ │ │ +00012d80: 636f 6e73 7420 6368 6172 202a 2053 5245  const char * SRE
│ │ │ │ +00012d90: 414c 4d29 0a20 2020 2020 4841 4e44 4c45  ALM).     HANDLE
│ │ │ │ +00012da0: 3a20 7368 6973 6869 2068 616e 646c 6520  : shishi handle 
│ │ │ │ +00012db0: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ +00012dc0: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ +00012dd0: e280 992e 0a20 2020 2020 454e 434b 4443  .....     ENCKDC
│ │ │ │ +00012de0: 5245 5050 4152 543a 2045 6e63 4b44 4352  REPPART: EncKDCR
│ │ │ │ +00012df0: 6570 5061 7274 2076 6172 6961 626c 6520  epPart variable 
│ │ │ │ +00012e00: 746f 2073 6574 2072 6561 6c6d 2066 6965  to set realm fie
│ │ │ │ +00012e10: 6c64 2069 6e2e 0a20 2020 2020 5352 4541  ld in..     SREA
│ │ │ │ +00012e20: 4c4d 3a20 696e 7075 7420 6172 7261 7920  LM: input array 
│ │ │ │ +00012e30: 7769 7468 206e 616d 6520 6f66 2072 6561  with name of rea
│ │ │ │ +00012e40: 6c6d 2e0a 0a20 2020 2020 2a44 6573 6372  lm...     *Descr
│ │ │ │ +00012e50: 6970 7469 6f6e 3a2a 2053 6574 2074 6865  iption:* Set the
│ │ │ │ +00012e60: 2073 6572 7665 7220 7265 616c 6d20 6669   server realm fi
│ │ │ │ +00012e70: 656c 6420 696e 2074 6865 2045 6e63 4b44  eld in the EncKD
│ │ │ │ +00012e80: 4352 6570 5061 7274 2e0a 0a20 2020 2020  CRepPart...     
│ │ │ │ +00012e90: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ +00012ea0: 5265 7475 726e 7320 5348 4953 4849 5f4f  Returns SHISHI_O
│ │ │ │ +00012eb0: 4b20 6966 6620 7375 6363 6573 7366 756c  K iff successful
│ │ │ │ +00012ec0: 2e0a 0a73 6869 7368 695f 656e 636b 6463  ...shishi_enckdc
│ │ │ │ +00012ed0: 7265 7070 6172 745f 736e 616d 655f 7365  reppart_sname_se
│ │ │ │ +00012ee0: 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  t.--------------
│ │ │ │ +00012ef0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +00012f00: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +00012f10: 696e 7420 7368 6973 6869 5f65 6e63 6b64  int shishi_enckd
│ │ │ │ +00012f20: 6372 6570 7061 7274 5f73 6e61 6d65 5f73  creppart_sname_s
│ │ │ │ +00012f30: 6574 2028 5368 6973 6869 202a 2048 414e  et (Shishi * HAN
│ │ │ │ +00012f40: 444c 452c 0a20 2020 2020 2020 2020 2053  DLE,.          S
│ │ │ │ +00012f50: 6869 7368 695f 6173 6e31 2045 4e43 4b44  hishi_asn1 ENCKD
│ │ │ │ +00012f60: 4352 4550 5041 5254 2c20 5368 6973 6869  CREPPART, Shishi
│ │ │ │ +00012f70: 5f6e 616d 655f 7479 7065 204e 414d 455f  _name_type NAME_
│ │ │ │ +00012f80: 5459 5045 2c0a 2020 2020 2020 2020 2020  TYPE,.          
│ │ │ │ +00012f90: 6368 6172 202a 2053 4e41 4d45 5b5d 290a  char * SNAME[]).
│ │ │ │ +00012fa0: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ +00012fb0: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ +00012fc0: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ +00012fd0: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ +00012fe0: 2020 2020 2045 4e43 4b44 4352 4550 5041       ENCKDCREPPA
│ │ │ │ +00012ff0: 5254 3a20 456e 634b 4443 5265 7050 6172  RT: EncKDCRepPar
│ │ │ │ +00013000: 7420 7661 7269 6162 6c65 2074 6f20 7365  t variable to se
│ │ │ │ +00013010: 7420 7365 7276 6572 206e 616d 6520 6669  t server name fi
│ │ │ │ +00013020: 656c 6420 696e 2e0a 0a20 2020 2020 4e41  eld in...     NA
│ │ │ │ +00013030: 4d45 5f54 5950 453a 2074 7970 6520 6f66  ME_TYPE: type of
│ │ │ │ +00013040: 2070 7269 6e63 6970 6961 6c2c 2073 6565   principial, see
│ │ │ │ +00013050: 2053 6869 7368 695f 6e61 6d65 5f74 7970   Shishi_name_typ
│ │ │ │ +00013060: 652c 2075 7375 616c 6c79 0a20 2020 2020  e, usually.     
│ │ │ │ +00013070: 5348 4953 4849 5f4e 545f 554e 4b4e 4f57  SHISHI_NT_UNKNOW
│ │ │ │ +00013080: 4e2e 0a20 2020 2020 534e 414d 453a 2069  N..     SNAME: i
│ │ │ │ +00013090: 6e70 7574 2061 7272 6179 2077 6974 6820  nput array with 
│ │ │ │ +000130a0: 7072 696e 6369 7061 6c20 6e61 6d65 2e0a  principal name..
│ │ │ │ +000130b0: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +000130c0: 6f6e 3a2a 2053 6574 2074 6865 2073 6572  on:* Set the ser
│ │ │ │ +000130d0: 7665 7220 6e61 6d65 2066 6965 6c64 2069  ver name field i
│ │ │ │ +000130e0: 6e20 7468 6520 456e 634b 4443 5265 7050  n the EncKDCRepP
│ │ │ │ +000130f0: 6172 742e 0a0a 2020 2020 202a 5265 7475  art...     *Retu
│ │ │ │ +00013100: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ +00013110: 6e73 2053 4849 5348 495f 4f4b 2069 6666  ns SHISHI_OK iff
│ │ │ │ +00013120: 2073 7563 6365 7373 6675 6c2e 0a0a 7368   successful...sh
│ │ │ │ +00013130: 6973 6869 5f65 6e63 6b64 6372 6570 7061  ishi_enckdcreppa
│ │ │ │ +00013140: 7274 5f70 6f70 756c 6174 655f 656e 6374  rt_populate_enct
│ │ │ │ +00013150: 6963 6b65 7470 6172 740a 2d2d 2d2d 2d2d  icketpart.------
│ │ │ │  00013160: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │  00013170: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00013180: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -00013190: 6f6e 3a20 696e 7420 7368 6973 6869 5f65  on: int shishi_e
│ │ │ │ -000131a0: 6e63 6b64 6372 6570 7061 7274 5f70 6f70  nckdcreppart_pop
│ │ │ │ -000131b0: 756c 6174 655f 656e 6374 6963 6b65 7470  ulate_encticketp
│ │ │ │ -000131c0: 6172 740a 2020 2020 2020 2020 2020 2853  art.          (S
│ │ │ │ -000131d0: 6869 7368 6920 2a20 4841 4e44 4c45 2c20  hishi * HANDLE, 
│ │ │ │ -000131e0: 5368 6973 6869 5f61 736e 3120 454e 434b  Shishi_asn1 ENCK
│ │ │ │ -000131f0: 4443 5245 5050 4152 542c 0a20 2020 2020  DCREPPART,.     
│ │ │ │ -00013200: 2020 2020 2053 6869 7368 695f 6173 6e31       Shishi_asn1
│ │ │ │ -00013210: 2045 4e43 5449 434b 4554 5041 5254 290a   ENCTICKETPART).
│ │ │ │ -00013220: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ -00013230: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ -00013240: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ -00013250: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ -00013260: 2020 2020 2045 4e43 4b44 4352 4550 5041       ENCKDCREPPA
│ │ │ │ -00013270: 5254 3a20 696e 7075 7420 456e 634b 4443  RT: input EncKDC
│ │ │ │ -00013280: 5265 7050 6172 7420 7661 7269 6162 6c65  RepPart variable
│ │ │ │ -00013290: 2e0a 2020 2020 2045 4e43 5449 434b 4554  ..     ENCTICKET
│ │ │ │ -000132a0: 5041 5254 3a20 696e 7075 7420 456e 6354  PART: input EncT
│ │ │ │ -000132b0: 6963 6b65 7450 6172 7420 7661 7269 6162  icketPart variab
│ │ │ │ -000132c0: 6c65 2e0a 0a20 2020 2020 2a44 6573 6372  le...     *Descr
│ │ │ │ -000132d0: 6970 7469 6f6e 3a2a 2053 6574 2074 6865  iption:* Set the
│ │ │ │ -000132e0: 2066 6c61 6773 2c20 6175 7468 7469 6d65   flags, authtime
│ │ │ │ -000132f0: 2c20 7374 6172 7474 696d 652c 2065 6e64  , starttime, end
│ │ │ │ -00013300: 7469 6d65 2c0a 2020 2020 2072 656e 6577  time,.     renew
│ │ │ │ -00013310: 2d74 696c 6c20 616e 6420 6361 6464 7220  -till and caddr 
│ │ │ │ -00013320: 6669 656c 6473 206f 6620 7468 6520 456e  fields of the En
│ │ │ │ -00013330: 634b 4443 5265 7050 6172 7420 746f 2074  cKDCRepPart to t
│ │ │ │ -00013340: 6865 0a20 2020 2020 636f 7272 6573 706f  he.     correspo
│ │ │ │ -00013350: 6e64 696e 6720 7661 6c75 6573 2069 6e20  nding values in 
│ │ │ │ -00013360: 7468 6520 456e 6354 6963 6b65 7450 6172  the EncTicketPar
│ │ │ │ -00013370: 742e 0a0a 2020 2020 202a 5265 7475 726e  t...     *Return
│ │ │ │ -00013380: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ -00013390: 20e2 8098 5348 4953 4849 5f4f 4be2 8099   ...SHISHI_OK...
│ │ │ │ -000133a0: 2069 6666 2073 7563 6365 7373 6675 6c2e   iff successful.
│ │ │ │ -000133b0: 0a0a 1f0a 4669 6c65 3a20 7368 6973 6869  ....File: shishi
│ │ │ │ -000133c0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 4175  .info,  Node: Au
│ │ │ │ -000133d0: 7468 656e 7469 6361 746f 7220 4675 6e63  thenticator Func
│ │ │ │ -000133e0: 7469 6f6e 732c 2020 4e65 7874 3a20 4b52  tions,  Next: KR
│ │ │ │ -000133f0: 422d 4552 524f 5220 4675 6e63 7469 6f6e  B-ERROR Function
│ │ │ │ -00013400: 732c 2020 5072 6576 3a20 4153 2f54 4753  s,  Prev: AS/TGS
│ │ │ │ -00013410: 2046 756e 6374 696f 6e73 2c20 2055 703a   Functions,  Up:
│ │ │ │ -00013420: 2050 726f 6772 616d 6d69 6e67 204d 616e   Programming Man
│ │ │ │ -00013430: 7561 6c0a 0a35 2e31 3120 4175 7468 656e  ual..5.11 Authen
│ │ │ │ -00013440: 7469 6361 746f 7220 4675 6e63 7469 6f6e  ticator Function
│ │ │ │ -00013450: 730a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  s.==============
│ │ │ │ -00013460: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a  ==============..
│ │ │ │ -00013470: 416e 2022 4175 7468 656e 7469 6361 746f  An "Authenticato
│ │ │ │ -00013480: 7222 2069 7320 616e 2041 534e 2e31 2073  r" is an ASN.1 s
│ │ │ │ -00013490: 7472 7563 7475 7265 2074 6861 7420 776f  tructure that wo
│ │ │ │ -000134a0: 726b 2061 7320 6120 7072 6f6f 6620 7468  rk as a proof th
│ │ │ │ -000134b0: 6174 2061 6e0a 656e 7469 7479 206f 776e  at an.entity own
│ │ │ │ -000134c0: 7320 6120 7469 636b 6574 2e20 2049 7420  s a ticket.  It 
│ │ │ │ -000134d0: 6973 2075 7375 616c 6c79 2065 6d62 6564  is usually embed
│ │ │ │ -000134e0: 6465 6420 696e 2074 6865 2041 502d 5245  ded in the AP-RE
│ │ │ │ -000134f0: 5120 7374 7275 6374 7572 650a 282a 6e6f  Q structure.(*no
│ │ │ │ -00013500: 7465 2041 502d 5245 5120 616e 6420 4150  te AP-REQ and AP
│ │ │ │ -00013510: 2d52 4550 2046 756e 6374 696f 6e73 3a3a  -REP Functions::
│ │ │ │ -00013520: 292c 2061 6e64 2079 6f75 206d 6f73 7420  ), and you most 
│ │ │ │ -00013530: 6c69 6b65 6c79 2077 616e 7420 746f 2075  likely want to u
│ │ │ │ -00013540: 7365 0a61 6e20 4150 2d52 4551 2069 6e73  se.an AP-REQ ins
│ │ │ │ -00013550: 7465 6164 206f 6620 6120 4175 7468 656e  tead of a Authen
│ │ │ │ -00013560: 7469 6361 746f 7220 696e 206e 6f72 6d61  ticator in norma
│ │ │ │ -00013570: 6c20 6170 706c 6963 6174 696f 6e73 2e20  l applications. 
│ │ │ │ -00013580: 2054 6865 0a66 6f6c 6c6f 7769 6e67 2069   The.following i
│ │ │ │ -00013590: 6c6c 7573 7472 6174 6573 2074 6865 2041  llustrates the A
│ │ │ │ -000135a0: 7574 6865 6e74 6963 6174 6f72 2041 534e  uthenticator ASN
│ │ │ │ -000135b0: 2e31 2073 7472 7563 7475 7265 2e0a 0a41  .1 structure...A
│ │ │ │ -000135c0: 7574 6865 6e74 6963 6174 6f72 093a 3a3d  uthenticator.::=
│ │ │ │ -000135d0: 205b 4150 504c 4943 4154 494f 4e20 325d   [APPLICATION 2]
│ │ │ │ -000135e0: 2053 4551 5545 4e43 4520 207b 0a09 6175   SEQUENCE  {..au
│ │ │ │ -000135f0: 7468 656e 7469 6361 746f 722d 766e 6f09  thenticator-vno.
│ │ │ │ -00013600: 5b30 5d20 494e 5445 4745 5220 2835 292c  [0] INTEGER (5),
│ │ │ │ -00013610: 0a09 6372 6561 6c6d 0909 095b 315d 2052  ..crealm...[1] R
│ │ │ │ -00013620: 6561 6c6d 2c0a 0963 6e61 6d65 0909 095b  ealm,..cname...[
│ │ │ │ -00013630: 325d 2050 7269 6e63 6970 616c 4e61 6d65  2] PrincipalName
│ │ │ │ -00013640: 2c0a 0963 6b73 756d 0909 095b 335d 2043  ,..cksum...[3] C
│ │ │ │ -00013650: 6865 636b 7375 6d20 4f50 5449 4f4e 414c  hecksum OPTIONAL
│ │ │ │ -00013660: 2c0a 0963 7573 6563 0909 095b 345d 204d  ,..cusec...[4] M
│ │ │ │ -00013670: 6963 726f 7365 636f 6e64 732c 0a09 6374  icroseconds,..ct
│ │ │ │ -00013680: 696d 6509 0909 5b35 5d20 4b65 7262 6572  ime...[5] Kerber
│ │ │ │ -00013690: 6f73 5469 6d65 2c0a 0973 7562 6b65 7909  osTime,..subkey.
│ │ │ │ -000136a0: 0909 5b36 5d20 456e 6372 7970 7469 6f6e  ..[6] Encryption
│ │ │ │ -000136b0: 4b65 7920 4f50 5449 4f4e 414c 2c0a 0973  Key OPTIONAL,..s
│ │ │ │ -000136c0: 6571 2d6e 756d 6265 7209 095b 375d 2055  eq-number..[7] U
│ │ │ │ -000136d0: 496e 7433 3220 4f50 5449 4f4e 414c 2c0a  Int32 OPTIONAL,.
│ │ │ │ -000136e0: 0961 7574 686f 7269 7a61 7469 6f6e 2d64  .authorization-d
│ │ │ │ -000136f0: 6174 6109 5b38 5d20 4175 7468 6f72 697a  ata.[8] Authoriz
│ │ │ │ -00013700: 6174 696f 6e44 6174 6120 4f50 5449 4f4e  ationData OPTION
│ │ │ │ -00013710: 414c 0a7d 0a0a 7368 6973 6869 5f61 7574  AL.}..shishi_aut
│ │ │ │ -00013720: 6865 6e74 6963 6174 6f72 0a2d 2d2d 2d2d  henticator.-----
│ │ │ │ -00013730: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -00013740: 0a20 2d2d 2046 756e 6374 696f 6e3a 2053  . -- Function: S
│ │ │ │ -00013750: 6869 7368 695f 6173 6e31 2073 6869 7368  hishi_asn1 shish
│ │ │ │ -00013760: 695f 6175 7468 656e 7469 6361 746f 7220  i_authenticator 
│ │ │ │ -00013770: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ -00013780: 290a 2020 2020 2048 414e 444c 453a 2073  ).     HANDLE: s
│ │ │ │ -00013790: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ -000137a0: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ -000137b0: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ -000137c0: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ -000137d0: 7469 6f6e 3a2a 2054 6869 7320 6675 6e63  tion:* This func
│ │ │ │ -000137e0: 7469 6f6e 2063 7265 6174 6573 2061 206e  tion creates a n
│ │ │ │ -000137f0: 6577 2041 7574 6865 6e74 6963 6174 6f72  ew Authenticator
│ │ │ │ -00013800: 2c20 706f 7075 6c61 7465 640a 2020 2020  , populated.    
│ │ │ │ -00013810: 2077 6974 6820 736f 6d65 2064 6566 6175   with some defau
│ │ │ │ -00013820: 6c74 2076 616c 7565 732e 2020 4974 2075  lt values.  It u
│ │ │ │ -00013830: 7365 7320 7468 6520 6375 7272 656e 7420  ses the current 
│ │ │ │ -00013840: 7469 6d65 2061 7320 7265 7475 726e 6564  time as returned
│ │ │ │ -00013850: 2062 790a 2020 2020 2074 6865 2073 7973   by.     the sys
│ │ │ │ -00013860: 7465 6d20 666f 7220 7468 6520 6374 696d  tem for the ctim
│ │ │ │ -00013870: 6520 616e 6420 6375 7365 6320 6669 656c  e and cusec fiel
│ │ │ │ -00013880: 6473 2e0a 0a20 2020 2020 2a52 6574 7572  ds...     *Retur
│ │ │ │ -00013890: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ -000138a0: 7320 7468 6520 6175 7468 656e 7469 6361  s the authentica
│ │ │ │ -000138b0: 746f 7220 6f72 204e 554c 4c20 6f6e 2066  tor or NULL on f
│ │ │ │ -000138c0: 6169 6c75 7265 2e0a 0a73 6869 7368 695f  ailure...shishi_
│ │ │ │ -000138d0: 6175 7468 656e 7469 6361 746f 725f 7375  authenticator_su
│ │ │ │ -000138e0: 626b 6579 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  bkey.-----------
│ │ │ │ +00013180: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +00013190: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ +000131a0: 656e 636b 6463 7265 7070 6172 745f 706f  enckdcreppart_po
│ │ │ │ +000131b0: 7075 6c61 7465 5f65 6e63 7469 636b 6574  pulate_encticket
│ │ │ │ +000131c0: 7061 7274 0a20 2020 2020 2020 2020 2028  part.          (
│ │ │ │ +000131d0: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ +000131e0: 2053 6869 7368 695f 6173 6e31 2045 4e43   Shishi_asn1 ENC
│ │ │ │ +000131f0: 4b44 4352 4550 5041 5254 2c0a 2020 2020  KDCREPPART,.    
│ │ │ │ +00013200: 2020 2020 2020 5368 6973 6869 5f61 736e        Shishi_asn
│ │ │ │ +00013210: 3120 454e 4354 4943 4b45 5450 4152 5429  1 ENCTICKETPART)
│ │ │ │ +00013220: 0a20 2020 2020 4841 4e44 4c45 3a20 7368  .     HANDLE: sh
│ │ │ │ +00013230: 6973 6869 2068 616e 646c 6520 6173 2061  ishi handle as a
│ │ │ │ +00013240: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ +00013250: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ +00013260: 0a20 2020 2020 454e 434b 4443 5245 5050  .     ENCKDCREPP
│ │ │ │ +00013270: 4152 543a 2069 6e70 7574 2045 6e63 4b44  ART: input EncKD
│ │ │ │ +00013280: 4352 6570 5061 7274 2076 6172 6961 626c  CRepPart variabl
│ │ │ │ +00013290: 652e 0a20 2020 2020 454e 4354 4943 4b45  e..     ENCTICKE
│ │ │ │ +000132a0: 5450 4152 543a 2069 6e70 7574 2045 6e63  TPART: input Enc
│ │ │ │ +000132b0: 5469 636b 6574 5061 7274 2076 6172 6961  TicketPart varia
│ │ │ │ +000132c0: 626c 652e 0a0a 2020 2020 202a 4465 7363  ble...     *Desc
│ │ │ │ +000132d0: 7269 7074 696f 6e3a 2a20 5365 7420 7468  ription:* Set th
│ │ │ │ +000132e0: 6520 666c 6167 732c 2061 7574 6874 696d  e flags, authtim
│ │ │ │ +000132f0: 652c 2073 7461 7274 7469 6d65 2c20 656e  e, starttime, en
│ │ │ │ +00013300: 6474 696d 652c 0a20 2020 2020 7265 6e65  dtime,.     rene
│ │ │ │ +00013310: 772d 7469 6c6c 2061 6e64 2063 6164 6472  w-till and caddr
│ │ │ │ +00013320: 2066 6965 6c64 7320 6f66 2074 6865 2045   fields of the E
│ │ │ │ +00013330: 6e63 4b44 4352 6570 5061 7274 2074 6f20  ncKDCRepPart to 
│ │ │ │ +00013340: 7468 650a 2020 2020 2063 6f72 7265 7370  the.     corresp
│ │ │ │ +00013350: 6f6e 6469 6e67 2076 616c 7565 7320 696e  onding values in
│ │ │ │ +00013360: 2074 6865 2045 6e63 5469 636b 6574 5061   the EncTicketPa
│ │ │ │ +00013370: 7274 2e0a 0a20 2020 2020 2a52 6574 7572  rt...     *Retur
│ │ │ │ +00013380: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ +00013390: 7320 e280 9853 4849 5348 495f 4f4b e280  s ...SHISHI_OK..
│ │ │ │ +000133a0: 9920 6966 6620 7375 6363 6573 7366 756c  . iff successful
│ │ │ │ +000133b0: 2e0a 0a1f 0a46 696c 653a 2073 6869 7368  .....File: shish
│ │ │ │ +000133c0: 692e 696e 666f 2c20 204e 6f64 653a 2041  i.info,  Node: A
│ │ │ │ +000133d0: 7574 6865 6e74 6963 6174 6f72 2046 756e  uthenticator Fun
│ │ │ │ +000133e0: 6374 696f 6e73 2c20 204e 6578 743a 204b  ctions,  Next: K
│ │ │ │ +000133f0: 5242 2d45 5252 4f52 2046 756e 6374 696f  RB-ERROR Functio
│ │ │ │ +00013400: 6e73 2c20 2050 7265 763a 2041 532f 5447  ns,  Prev: AS/TG
│ │ │ │ +00013410: 5320 4675 6e63 7469 6f6e 732c 2020 5570  S Functions,  Up
│ │ │ │ +00013420: 3a20 5072 6f67 7261 6d6d 696e 6720 4d61  : Programming Ma
│ │ │ │ +00013430: 6e75 616c 0a0a 352e 3131 2041 7574 6865  nual..5.11 Authe
│ │ │ │ +00013440: 6e74 6963 6174 6f72 2046 756e 6374 696f  nticator Functio
│ │ │ │ +00013450: 6e73 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ns.=============
│ │ │ │ +00013460: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a  ===============.
│ │ │ │ +00013470: 0a41 6e20 2241 7574 6865 6e74 6963 6174  .An "Authenticat
│ │ │ │ +00013480: 6f72 2220 6973 2061 6e20 4153 4e2e 3120  or" is an ASN.1 
│ │ │ │ +00013490: 7374 7275 6374 7572 6520 7468 6174 2077  structure that w
│ │ │ │ +000134a0: 6f72 6b20 6173 2061 2070 726f 6f66 2074  ork as a proof t
│ │ │ │ +000134b0: 6861 7420 616e 0a65 6e74 6974 7920 6f77  hat an.entity ow
│ │ │ │ +000134c0: 6e73 2061 2074 6963 6b65 742e 2020 4974  ns a ticket.  It
│ │ │ │ +000134d0: 2069 7320 7573 7561 6c6c 7920 656d 6265   is usually embe
│ │ │ │ +000134e0: 6464 6564 2069 6e20 7468 6520 4150 2d52  dded in the AP-R
│ │ │ │ +000134f0: 4551 2073 7472 7563 7475 7265 0a28 2a6e  EQ structure.(*n
│ │ │ │ +00013500: 6f74 6520 4150 2d52 4551 2061 6e64 2041  ote AP-REQ and A
│ │ │ │ +00013510: 502d 5245 5020 4675 6e63 7469 6f6e 733a  P-REP Functions:
│ │ │ │ +00013520: 3a29 2c20 616e 6420 796f 7520 6d6f 7374  :), and you most
│ │ │ │ +00013530: 206c 696b 656c 7920 7761 6e74 2074 6f20   likely want to 
│ │ │ │ +00013540: 7573 650a 616e 2041 502d 5245 5120 696e  use.an AP-REQ in
│ │ │ │ +00013550: 7374 6561 6420 6f66 2061 2041 7574 6865  stead of a Authe
│ │ │ │ +00013560: 6e74 6963 6174 6f72 2069 6e20 6e6f 726d  nticator in norm
│ │ │ │ +00013570: 616c 2061 7070 6c69 6361 7469 6f6e 732e  al applications.
│ │ │ │ +00013580: 2020 5468 650a 666f 6c6c 6f77 696e 6720    The.following 
│ │ │ │ +00013590: 696c 6c75 7374 7261 7465 7320 7468 6520  illustrates the 
│ │ │ │ +000135a0: 4175 7468 656e 7469 6361 746f 7220 4153  Authenticator AS
│ │ │ │ +000135b0: 4e2e 3120 7374 7275 6374 7572 652e 0a0a  N.1 structure...
│ │ │ │ +000135c0: 4175 7468 656e 7469 6361 746f 7209 3a3a  Authenticator.::
│ │ │ │ +000135d0: 3d20 5b41 5050 4c49 4341 5449 4f4e 2032  = [APPLICATION 2
│ │ │ │ +000135e0: 5d20 5345 5155 454e 4345 2020 7b0a 0961  ] SEQUENCE  {..a
│ │ │ │ +000135f0: 7574 6865 6e74 6963 6174 6f72 2d76 6e6f  uthenticator-vno
│ │ │ │ +00013600: 095b 305d 2049 4e54 4547 4552 2028 3529  .[0] INTEGER (5)
│ │ │ │ +00013610: 2c0a 0963 7265 616c 6d09 0909 5b31 5d20  ,..crealm...[1] 
│ │ │ │ +00013620: 5265 616c 6d2c 0a09 636e 616d 6509 0909  Realm,..cname...
│ │ │ │ +00013630: 5b32 5d20 5072 696e 6369 7061 6c4e 616d  [2] PrincipalNam
│ │ │ │ +00013640: 652c 0a09 636b 7375 6d09 0909 5b33 5d20  e,..cksum...[3] 
│ │ │ │ +00013650: 4368 6563 6b73 756d 204f 5054 494f 4e41  Checksum OPTIONA
│ │ │ │ +00013660: 4c2c 0a09 6375 7365 6309 0909 5b34 5d20  L,..cusec...[4] 
│ │ │ │ +00013670: 4d69 6372 6f73 6563 6f6e 6473 2c0a 0963  Microseconds,..c
│ │ │ │ +00013680: 7469 6d65 0909 095b 355d 204b 6572 6265  time...[5] Kerbe
│ │ │ │ +00013690: 726f 7354 696d 652c 0a09 7375 626b 6579  rosTime,..subkey
│ │ │ │ +000136a0: 0909 095b 365d 2045 6e63 7279 7074 696f  ...[6] Encryptio
│ │ │ │ +000136b0: 6e4b 6579 204f 5054 494f 4e41 4c2c 0a09  nKey OPTIONAL,..
│ │ │ │ +000136c0: 7365 712d 6e75 6d62 6572 0909 5b37 5d20  seq-number..[7] 
│ │ │ │ +000136d0: 5549 6e74 3332 204f 5054 494f 4e41 4c2c  UInt32 OPTIONAL,
│ │ │ │ +000136e0: 0a09 6175 7468 6f72 697a 6174 696f 6e2d  ..authorization-
│ │ │ │ +000136f0: 6461 7461 095b 385d 2041 7574 686f 7269  data.[8] Authori
│ │ │ │ +00013700: 7a61 7469 6f6e 4461 7461 204f 5054 494f  zationData OPTIO
│ │ │ │ +00013710: 4e41 4c0a 7d0a 0a73 6869 7368 695f 6175  NAL.}..shishi_au
│ │ │ │ +00013720: 7468 656e 7469 6361 746f 720a 2d2d 2d2d  thenticator.----
│ │ │ │ +00013730: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +00013740: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +00013750: 5368 6973 6869 5f61 736e 3120 7368 6973  Shishi_asn1 shis
│ │ │ │ +00013760: 6869 5f61 7574 6865 6e74 6963 6174 6f72  hi_authenticator
│ │ │ │ +00013770: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ +00013780: 4529 0a20 2020 2020 4841 4e44 4c45 3a20  E).     HANDLE: 
│ │ │ │ +00013790: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ +000137a0: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ +000137b0: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ +000137c0: 992e 0a0a 2020 2020 202a 4465 7363 7269  ....     *Descri
│ │ │ │ +000137d0: 7074 696f 6e3a 2a20 5468 6973 2066 756e  ption:* This fun
│ │ │ │ +000137e0: 6374 696f 6e20 6372 6561 7465 7320 6120  ction creates a 
│ │ │ │ +000137f0: 6e65 7720 4175 7468 656e 7469 6361 746f  new Authenticato
│ │ │ │ +00013800: 722c 2070 6f70 756c 6174 6564 0a20 2020  r, populated.   
│ │ │ │ +00013810: 2020 7769 7468 2073 6f6d 6520 6465 6661    with some defa
│ │ │ │ +00013820: 756c 7420 7661 6c75 6573 2e20 2049 7420  ult values.  It 
│ │ │ │ +00013830: 7573 6573 2074 6865 2063 7572 7265 6e74  uses the current
│ │ │ │ +00013840: 2074 696d 6520 6173 2072 6574 7572 6e65   time as returne
│ │ │ │ +00013850: 6420 6279 0a20 2020 2020 7468 6520 7379  d by.     the sy
│ │ │ │ +00013860: 7374 656d 2066 6f72 2074 6865 2063 7469  stem for the cti
│ │ │ │ +00013870: 6d65 2061 6e64 2063 7573 6563 2066 6965  me and cusec fie
│ │ │ │ +00013880: 6c64 732e 0a0a 2020 2020 202a 5265 7475  lds...     *Retu
│ │ │ │ +00013890: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ +000138a0: 6e73 2074 6865 2061 7574 6865 6e74 6963  ns the authentic
│ │ │ │ +000138b0: 6174 6f72 206f 7220 4e55 4c4c 206f 6e20  ator or NULL on 
│ │ │ │ +000138c0: 6661 696c 7572 652e 0a0a 7368 6973 6869  failure...shishi
│ │ │ │ +000138d0: 5f61 7574 6865 6e74 6963 6174 6f72 5f73  _authenticator_s
│ │ │ │ +000138e0: 7562 6b65 790a 2d2d 2d2d 2d2d 2d2d 2d2d  ubkey.----------
│ │ │ │  000138f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00013900: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ -00013910: 5368 6973 6869 5f61 736e 3120 7368 6973  Shishi_asn1 shis
│ │ │ │ -00013920: 6869 5f61 7574 6865 6e74 6963 6174 6f72  hi_authenticator
│ │ │ │ -00013930: 5f73 7562 6b65 7920 2853 6869 7368 6920  _subkey (Shishi 
│ │ │ │ -00013940: 2a20 4841 4e44 4c45 290a 2020 2020 2048  * HANDLE).     H
│ │ │ │ -00013950: 414e 444c 453a 2073 6869 7368 6920 6861  ANDLE: shishi ha
│ │ │ │ -00013960: 6e64 6c65 2061 7320 616c 6c6f 6361 7465  ndle as allocate
│ │ │ │ -00013970: 6420 6279 20e2 8098 7368 6973 6869 5f69  d by ...shishi_i
│ │ │ │ -00013980: 6e69 7428 29e2 8099 2e0a 0a20 2020 2020  nit()......     
│ │ │ │ -00013990: 2a44 6573 6372 6970 7469 6f6e 3a2a 2054  *Description:* T
│ │ │ │ -000139a0: 6869 7320 6675 6e63 7469 6f6e 2063 7265  his function cre
│ │ │ │ -000139b0: 6174 6573 2061 206e 6577 2041 7574 6865  ates a new Authe
│ │ │ │ -000139c0: 6e74 6963 6174 6f72 2c20 706f 7075 6c61  nticator, popula
│ │ │ │ -000139d0: 7465 640a 2020 2020 2077 6974 6820 736f  ted.     with so
│ │ │ │ -000139e0: 6d65 2064 6566 6175 6c74 2076 616c 7565  me default value
│ │ │ │ -000139f0: 732e 2020 4974 2075 7365 7320 7468 6520  s.  It uses the 
│ │ │ │ -00013a00: 6375 7272 656e 7420 7469 6d65 2061 7320  current time as 
│ │ │ │ -00013a10: 7265 7475 726e 6564 2062 790a 2020 2020  returned by.    
│ │ │ │ -00013a20: 2074 6865 2073 7973 7465 6d20 666f 7220   the system for 
│ │ │ │ -00013a30: 7468 6520 6374 696d 6520 616e 6420 6375  the ctime and cu
│ │ │ │ -00013a40: 7365 6320 6669 656c 6473 2e20 2049 7420  sec fields.  It 
│ │ │ │ -00013a50: 6164 6473 2061 2072 616e 646f 6d0a 2020  adds a random.  
│ │ │ │ -00013a60: 2020 2073 7562 6b65 792e 0a0a 2020 2020     subkey...    
│ │ │ │ -00013a70: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ -00013a80: 2052 6574 7572 6e73 2074 6865 2061 7574   Returns the aut
│ │ │ │ -00013a90: 6865 6e74 6963 6174 6f72 206f 7220 4e55  henticator or NU
│ │ │ │ -00013aa0: 4c4c 206f 6e20 6661 696c 7572 652e 0a0a  LL on failure...
│ │ │ │ -00013ab0: 7368 6973 6869 5f61 7574 6865 6e74 6963  shishi_authentic
│ │ │ │ -00013ac0: 6174 6f72 5f70 7269 6e74 0a2d 2d2d 2d2d  ator_print.-----
│ │ │ │ +00013900: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ +00013910: 2053 6869 7368 695f 6173 6e31 2073 6869   Shishi_asn1 shi
│ │ │ │ +00013920: 7368 695f 6175 7468 656e 7469 6361 746f  shi_authenticato
│ │ │ │ +00013930: 725f 7375 626b 6579 2028 5368 6973 6869  r_subkey (Shishi
│ │ │ │ +00013940: 202a 2048 414e 444c 4529 0a20 2020 2020   * HANDLE).     
│ │ │ │ +00013950: 4841 4e44 4c45 3a20 7368 6973 6869 2068  HANDLE: shishi h
│ │ │ │ +00013960: 616e 646c 6520 6173 2061 6c6c 6f63 6174  andle as allocat
│ │ │ │ +00013970: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ +00013980: 696e 6974 2829 e280 992e 0a0a 2020 2020  init()......    
│ │ │ │ +00013990: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ +000139a0: 5468 6973 2066 756e 6374 696f 6e20 6372  This function cr
│ │ │ │ +000139b0: 6561 7465 7320 6120 6e65 7720 4175 7468  eates a new Auth
│ │ │ │ +000139c0: 656e 7469 6361 746f 722c 2070 6f70 756c  enticator, popul
│ │ │ │ +000139d0: 6174 6564 0a20 2020 2020 7769 7468 2073  ated.     with s
│ │ │ │ +000139e0: 6f6d 6520 6465 6661 756c 7420 7661 6c75  ome default valu
│ │ │ │ +000139f0: 6573 2e20 2049 7420 7573 6573 2074 6865  es.  It uses the
│ │ │ │ +00013a00: 2063 7572 7265 6e74 2074 696d 6520 6173   current time as
│ │ │ │ +00013a10: 2072 6574 7572 6e65 6420 6279 0a20 2020   returned by.   
│ │ │ │ +00013a20: 2020 7468 6520 7379 7374 656d 2066 6f72    the system for
│ │ │ │ +00013a30: 2074 6865 2063 7469 6d65 2061 6e64 2063   the ctime and c
│ │ │ │ +00013a40: 7573 6563 2066 6965 6c64 732e 2020 4974  usec fields.  It
│ │ │ │ +00013a50: 2061 6464 7320 6120 7261 6e64 6f6d 0a20   adds a random. 
│ │ │ │ +00013a60: 2020 2020 7375 626b 6579 2e0a 0a20 2020      subkey...   
│ │ │ │ +00013a70: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ +00013a80: 2a20 5265 7475 726e 7320 7468 6520 6175  * Returns the au
│ │ │ │ +00013a90: 7468 656e 7469 6361 746f 7220 6f72 204e  thenticator or N
│ │ │ │ +00013aa0: 554c 4c20 6f6e 2066 6169 6c75 7265 2e0a  ULL on failure..
│ │ │ │ +00013ab0: 0a73 6869 7368 695f 6175 7468 656e 7469  .shishi_authenti
│ │ │ │ +00013ac0: 6361 746f 725f 7072 696e 740a 2d2d 2d2d  cator_print.----
│ │ │ │  00013ad0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00013ae0: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ -00013af0: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ -00013b00: 6175 7468 656e 7469 6361 746f 725f 7072  authenticator_pr
│ │ │ │ -00013b10: 696e 7420 2853 6869 7368 6920 2a20 4841  int (Shishi * HA
│ │ │ │ -00013b20: 4e44 4c45 2c0a 2020 2020 2020 2020 2020  NDLE,.          
│ │ │ │ -00013b30: 4649 4c45 202a 2046 482c 2053 6869 7368  FILE * FH, Shish
│ │ │ │ -00013b40: 695f 6173 6e31 2041 5554 4845 4e54 4943  i_asn1 AUTHENTIC
│ │ │ │ -00013b50: 4154 4f52 290a 2020 2020 2048 414e 444c  ATOR).     HANDL
│ │ │ │ -00013b60: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ -00013b70: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ -00013b80: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ -00013b90: 29e2 8099 2e0a 2020 2020 2046 483a 2066  ).....     FH: f
│ │ │ │ -00013ba0: 696c 6520 6861 6e64 6c65 206f 7065 6e20  ile handle open 
│ │ │ │ -00013bb0: 666f 7220 7772 6974 696e 672e 0a20 2020  for writing..   
│ │ │ │ -00013bc0: 2020 4155 5448 454e 5449 4341 544f 523a    AUTHENTICATOR:
│ │ │ │ -00013bd0: 2061 7574 6865 6e74 6963 6174 6f72 2061   authenticator a
│ │ │ │ -00013be0: 7320 616c 6c6f 6361 7465 6420 6279 0a20  s allocated by. 
│ │ │ │ -00013bf0: 2020 2020 e280 9873 6869 7368 695f 6175      ...shishi_au
│ │ │ │ -00013c00: 7468 656e 7469 6361 746f 7228 29e2 8099  thenticator()...
│ │ │ │ -00013c10: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ -00013c20: 7469 6f6e 3a2a 2050 7269 6e74 2041 5343  tion:* Print ASC
│ │ │ │ -00013c30: 4949 2061 726d 6f72 6564 2044 4552 2065  II armored DER e
│ │ │ │ -00013c40: 6e63 6f64 696e 6720 6f66 2061 7574 6865  ncoding of authe
│ │ │ │ -00013c50: 6e74 6963 6174 6f72 2074 6f0a 2020 2020  nticator to.    
│ │ │ │ -00013c60: 2066 696c 652e 0a0a 2020 2020 202a 5265   file...     *Re
│ │ │ │ -00013c70: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ -00013c80: 7572 6e73 2053 4849 5348 495f 4f4b 2069  urns SHISHI_OK i
│ │ │ │ -00013c90: 6666 2073 7563 6365 7373 6675 6c2e 0a0a  ff successful...
│ │ │ │ -00013ca0: 7368 6973 6869 5f61 7574 6865 6e74 6963  shishi_authentic
│ │ │ │ -00013cb0: 6174 6f72 5f73 6176 650a 2d2d 2d2d 2d2d  ator_save.------
│ │ │ │ +00013ae0: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ +00013af0: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ +00013b00: 5f61 7574 6865 6e74 6963 6174 6f72 5f70  _authenticator_p
│ │ │ │ +00013b10: 7269 6e74 2028 5368 6973 6869 202a 2048  rint (Shishi * H
│ │ │ │ +00013b20: 414e 444c 452c 0a20 2020 2020 2020 2020  ANDLE,.         
│ │ │ │ +00013b30: 2046 494c 4520 2a20 4648 2c20 5368 6973   FILE * FH, Shis
│ │ │ │ +00013b40: 6869 5f61 736e 3120 4155 5448 454e 5449  hi_asn1 AUTHENTI
│ │ │ │ +00013b50: 4341 544f 5229 0a20 2020 2020 4841 4e44  CATOR).     HAND
│ │ │ │ +00013b60: 4c45 3a20 7368 6973 6869 2068 616e 646c  LE: shishi handl
│ │ │ │ +00013b70: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ +00013b80: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ +00013b90: 2829 e280 992e 0a20 2020 2020 4648 3a20  ().....     FH: 
│ │ │ │ +00013ba0: 6669 6c65 2068 616e 646c 6520 6f70 656e  file handle open
│ │ │ │ +00013bb0: 2066 6f72 2077 7269 7469 6e67 2e0a 2020   for writing..  
│ │ │ │ +00013bc0: 2020 2041 5554 4845 4e54 4943 4154 4f52     AUTHENTICATOR
│ │ │ │ +00013bd0: 3a20 6175 7468 656e 7469 6361 746f 7220  : authenticator 
│ │ │ │ +00013be0: 6173 2061 6c6c 6f63 6174 6564 2062 790a  as allocated by.
│ │ │ │ +00013bf0: 2020 2020 20e2 8098 7368 6973 6869 5f61       ...shishi_a
│ │ │ │ +00013c00: 7574 6865 6e74 6963 6174 6f72 2829 e280  uthenticator()..
│ │ │ │ +00013c10: 992e 0a0a 2020 2020 202a 4465 7363 7269  ....     *Descri
│ │ │ │ +00013c20: 7074 696f 6e3a 2a20 5072 696e 7420 4153  ption:* Print AS
│ │ │ │ +00013c30: 4349 4920 6172 6d6f 7265 6420 4445 5220  CII armored DER 
│ │ │ │ +00013c40: 656e 636f 6469 6e67 206f 6620 6175 7468  encoding of auth
│ │ │ │ +00013c50: 656e 7469 6361 746f 7220 746f 0a20 2020  enticator to.   
│ │ │ │ +00013c60: 2020 6669 6c65 2e0a 0a20 2020 2020 2a52    file...     *R
│ │ │ │ +00013c70: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +00013c80: 7475 726e 7320 5348 4953 4849 5f4f 4b20  turns SHISHI_OK 
│ │ │ │ +00013c90: 6966 6620 7375 6363 6573 7366 756c 2e0a  iff successful..
│ │ │ │ +00013ca0: 0a73 6869 7368 695f 6175 7468 656e 7469  .shishi_authenti
│ │ │ │ +00013cb0: 6361 746f 725f 7361 7665 0a2d 2d2d 2d2d  cator_save.-----
│ │ │ │  00013cc0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00013cd0: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ -00013ce0: 6e3a 2069 6e74 2073 6869 7368 695f 6175  n: int shishi_au
│ │ │ │ -00013cf0: 7468 656e 7469 6361 746f 725f 7361 7665  thenticator_save
│ │ │ │ -00013d00: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ -00013d10: 452c 2046 494c 4520 2a20 4648 2c0a 2020  E, FILE * FH,.  
│ │ │ │ -00013d20: 2020 2020 2020 2020 5368 6973 6869 5f61          Shishi_a
│ │ │ │ -00013d30: 736e 3120 4155 5448 454e 5449 4341 544f  sn1 AUTHENTICATO
│ │ │ │ -00013d40: 5229 0a20 2020 2020 4841 4e44 4c45 3a20  R).     HANDLE: 
│ │ │ │ -00013d50: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ -00013d60: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ -00013d70: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ -00013d80: 992e 0a20 2020 2020 4648 3a20 6669 6c65  ...     FH: file
│ │ │ │ -00013d90: 2068 616e 646c 6520 6f70 656e 2066 6f72   handle open for
│ │ │ │ -00013da0: 2077 7269 7469 6e67 2e0a 2020 2020 2041   writing..     A
│ │ │ │ -00013db0: 5554 4845 4e54 4943 4154 4f52 3a20 6175  UTHENTICATOR: au
│ │ │ │ -00013dc0: 7468 656e 7469 6361 746f 7220 6173 2061  thenticator as a
│ │ │ │ -00013dd0: 6c6c 6f63 6174 6564 2062 790a 2020 2020  llocated by.    
│ │ │ │ -00013de0: 20e2 8098 7368 6973 6869 5f61 7574 6865   ...shishi_authe
│ │ │ │ -00013df0: 6e74 6963 6174 6f72 2829 e280 992e 0a0a  nticator()......
│ │ │ │ -00013e00: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ -00013e10: 6e3a 2a20 5361 7665 2044 4552 2065 6e63  n:* Save DER enc
│ │ │ │ -00013e20: 6f64 696e 6720 6f66 2061 7574 6865 6e74  oding of authent
│ │ │ │ -00013e30: 6963 6174 6f72 2074 6f20 6669 6c65 2e0a  icator to file..
│ │ │ │ -00013e40: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ -00013e50: 6c75 653a 2a20 5265 7475 726e 7320 5348  lue:* Returns SH
│ │ │ │ -00013e60: 4953 4849 5f4f 4b20 6966 6620 7375 6363  ISHI_OK iff succ
│ │ │ │ -00013e70: 6573 7366 756c 2e0a 0a73 6869 7368 695f  essful...shishi_
│ │ │ │ -00013e80: 6175 7468 656e 7469 6361 746f 725f 746f  authenticator_to
│ │ │ │ -00013e90: 5f66 696c 650a 2d2d 2d2d 2d2d 2d2d 2d2d  _file.----------
│ │ │ │ +00013cd0: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ +00013ce0: 6f6e 3a20 696e 7420 7368 6973 6869 5f61  on: int shishi_a
│ │ │ │ +00013cf0: 7574 6865 6e74 6963 6174 6f72 5f73 6176  uthenticator_sav
│ │ │ │ +00013d00: 6520 2853 6869 7368 6920 2a20 4841 4e44  e (Shishi * HAND
│ │ │ │ +00013d10: 4c45 2c20 4649 4c45 202a 2046 482c 0a20  LE, FILE * FH,. 
│ │ │ │ +00013d20: 2020 2020 2020 2020 2053 6869 7368 695f           Shishi_
│ │ │ │ +00013d30: 6173 6e31 2041 5554 4845 4e54 4943 4154  asn1 AUTHENTICAT
│ │ │ │ +00013d40: 4f52 290a 2020 2020 2048 414e 444c 453a  OR).     HANDLE:
│ │ │ │ +00013d50: 2073 6869 7368 6920 6861 6e64 6c65 2061   shishi handle a
│ │ │ │ +00013d60: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ +00013d70: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ +00013d80: 8099 2e0a 2020 2020 2046 483a 2066 696c  ....     FH: fil
│ │ │ │ +00013d90: 6520 6861 6e64 6c65 206f 7065 6e20 666f  e handle open fo
│ │ │ │ +00013da0: 7220 7772 6974 696e 672e 0a20 2020 2020  r writing..     
│ │ │ │ +00013db0: 4155 5448 454e 5449 4341 544f 523a 2061  AUTHENTICATOR: a
│ │ │ │ +00013dc0: 7574 6865 6e74 6963 6174 6f72 2061 7320  uthenticator as 
│ │ │ │ +00013dd0: 616c 6c6f 6361 7465 6420 6279 0a20 2020  allocated by.   
│ │ │ │ +00013de0: 2020 e280 9873 6869 7368 695f 6175 7468    ...shishi_auth
│ │ │ │ +00013df0: 656e 7469 6361 746f 7228 29e2 8099 2e0a  enticator().....
│ │ │ │ +00013e00: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +00013e10: 6f6e 3a2a 2053 6176 6520 4445 5220 656e  on:* Save DER en
│ │ │ │ +00013e20: 636f 6469 6e67 206f 6620 6175 7468 656e  coding of authen
│ │ │ │ +00013e30: 7469 6361 746f 7220 746f 2066 696c 652e  ticator to file.
│ │ │ │ +00013e40: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ +00013e50: 616c 7565 3a2a 2052 6574 7572 6e73 2053  alue:* Returns S
│ │ │ │ +00013e60: 4849 5348 495f 4f4b 2069 6666 2073 7563  HISHI_OK iff suc
│ │ │ │ +00013e70: 6365 7373 6675 6c2e 0a0a 7368 6973 6869  cessful...shishi
│ │ │ │ +00013e80: 5f61 7574 6865 6e74 6963 6174 6f72 5f74  _authenticator_t
│ │ │ │ +00013e90: 6f5f 6669 6c65 0a2d 2d2d 2d2d 2d2d 2d2d  o_file.---------
│ │ │ │  00013ea0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00013eb0: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ -00013ec0: 3a20 696e 7420 7368 6973 6869 5f61 7574  : int shishi_aut
│ │ │ │ -00013ed0: 6865 6e74 6963 6174 6f72 5f74 6f5f 6669  henticator_to_fi
│ │ │ │ -00013ee0: 6c65 2028 5368 6973 6869 202a 2048 414e  le (Shishi * HAN
│ │ │ │ -00013ef0: 444c 452c 0a20 2020 2020 2020 2020 2053  DLE,.          S
│ │ │ │ -00013f00: 6869 7368 695f 6173 6e31 2041 5554 4845  hishi_asn1 AUTHE
│ │ │ │ -00013f10: 4e54 4943 4154 4f52 2c20 696e 7420 4649  NTICATOR, int FI
│ │ │ │ -00013f20: 4c45 5459 5045 2c0a 2020 2020 2020 2020  LETYPE,.        
│ │ │ │ -00013f30: 2020 636f 6e73 7420 6368 6172 202a 2046    const char * F
│ │ │ │ -00013f40: 494c 454e 414d 4529 0a20 2020 2020 4841  ILENAME).     HA
│ │ │ │ -00013f50: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ -00013f60: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ -00013f70: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ -00013f80: 6974 2829 e280 992e 0a20 2020 2020 4155  it().....     AU
│ │ │ │ -00013f90: 5448 454e 5449 4341 544f 523a 2041 7574  THENTICATOR: Aut
│ │ │ │ -00013fa0: 6865 6e74 6963 6174 6f72 2074 6f20 7361  henticator to sa
│ │ │ │ -00013fb0: 7665 2e0a 2020 2020 2046 494c 4554 5950  ve..     FILETYP
│ │ │ │ -00013fc0: 453a 2069 6e70 7574 2076 6172 6961 626c  E: input variabl
│ │ │ │ -00013fd0: 6520 7370 6563 6966 7969 6e67 2074 7970  e specifying typ
│ │ │ │ -00013fe0: 6520 6f66 2066 696c 6520 746f 2062 6520  e of file to be 
│ │ │ │ -00013ff0: 7772 6974 7465 6e2c 2073 6565 0a20 2020  written, see.   
│ │ │ │ -00014000: 2020 5368 6973 6869 5f66 696c 6574 7970    Shishi_filetyp
│ │ │ │ -00014010: 652e 0a20 2020 2020 4649 4c45 4e41 4d45  e..     FILENAME
│ │ │ │ -00014020: 3a20 696e 7075 7420 7661 7269 6162 6c65  : input variable
│ │ │ │ -00014030: 2077 6974 6820 6669 6c65 6e61 6d65 2074   with filename t
│ │ │ │ -00014040: 6f20 7772 6974 6520 746f 2e0a 0a20 2020  o write to...   
│ │ │ │ -00014050: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ -00014060: 2057 7269 7465 2041 7574 6865 6e74 6963   Write Authentic
│ │ │ │ -00014070: 6174 6f72 2074 6f20 6669 6c65 2069 6e20  ator to file in 
│ │ │ │ -00014080: 7370 6563 6966 6965 6420 5459 5045 2e20  specified TYPE. 
│ │ │ │ -00014090: 5468 650a 2020 2020 2066 696c 6520 7769  The.     file wi
│ │ │ │ -000140a0: 6c6c 2062 6520 7472 756e 6361 7465 6420  ll be truncated 
│ │ │ │ -000140b0: 6966 2069 7420 6578 6973 7473 2e0a 0a20  if it exists... 
│ │ │ │ -000140c0: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ -000140d0: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ -000140e0: 4849 5f4f 4b20 6966 6620 7375 6363 6573  HI_OK iff succes
│ │ │ │ -000140f0: 7366 756c 2e0a 0a73 6869 7368 695f 6175  sful...shishi_au
│ │ │ │ -00014100: 7468 656e 7469 6361 746f 725f 7061 7273  thenticator_pars
│ │ │ │ -00014110: 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  e.--------------
│ │ │ │ -00014120: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ -00014130: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ -00014140: 7368 6973 6869 5f61 7574 6865 6e74 6963  shishi_authentic
│ │ │ │ -00014150: 6174 6f72 5f70 6172 7365 2028 5368 6973  ator_parse (Shis
│ │ │ │ -00014160: 6869 202a 2048 414e 444c 452c 0a20 2020  hi * HANDLE,.   
│ │ │ │ -00014170: 2020 2020 2020 2046 494c 4520 2a20 4648         FILE * FH
│ │ │ │ -00014180: 2c20 5368 6973 6869 5f61 736e 3120 2a20  , Shishi_asn1 * 
│ │ │ │ -00014190: 4155 5448 454e 5449 4341 544f 5229 0a20  AUTHENTICATOR). 
│ │ │ │ -000141a0: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ -000141b0: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ -000141c0: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ -000141d0: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ -000141e0: 2020 2020 4648 3a20 6669 6c65 2068 616e      FH: file han
│ │ │ │ -000141f0: 646c 6520 6f70 656e 2066 6f72 2072 6561  dle open for rea
│ │ │ │ -00014200: 6469 6e67 2e0a 2020 2020 2041 5554 4845  ding..     AUTHE
│ │ │ │ -00014210: 4e54 4943 4154 4f52 3a20 6f75 7470 7574  NTICATOR: output
│ │ │ │ -00014220: 2076 6172 6961 626c 6520 7769 7468 206e   variable with n
│ │ │ │ -00014230: 6577 6c79 2061 6c6c 6f63 6174 6564 2061  ewly allocated a
│ │ │ │ -00014240: 7574 6865 6e74 6963 6174 6f72 2e0a 0a20  uthenticator... 
│ │ │ │ -00014250: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -00014260: 3a2a 2052 6561 6420 4153 4349 4920 6172  :* Read ASCII ar
│ │ │ │ -00014270: 6d6f 7265 6420 4445 5220 656e 636f 6465  mored DER encode
│ │ │ │ -00014280: 6420 6175 7468 656e 7469 6361 746f 7220  d authenticator 
│ │ │ │ -00014290: 6672 6f6d 0a20 2020 2020 6669 6c65 2061  from.     file a
│ │ │ │ -000142a0: 6e64 2070 6f70 756c 6174 6520 6769 7665  nd populate give
│ │ │ │ -000142b0: 6e20 6175 7468 656e 7469 6361 746f 7220  n authenticator 
│ │ │ │ -000142c0: 7661 7269 6162 6c65 2e0a 0a20 2020 2020  variable...     
│ │ │ │ -000142d0: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ -000142e0: 5265 7475 726e 7320 5348 4953 4849 5f4f  Returns SHISHI_O
│ │ │ │ -000142f0: 4b20 6966 6620 7375 6363 6573 7366 756c  K iff successful
│ │ │ │ -00014300: 2e0a 0a73 6869 7368 695f 6175 7468 656e  ...shishi_authen
│ │ │ │ -00014310: 7469 6361 746f 725f 7265 6164 0a2d 2d2d  ticator_read.---
│ │ │ │ +00013eb0: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ +00013ec0: 6e3a 2069 6e74 2073 6869 7368 695f 6175  n: int shishi_au
│ │ │ │ +00013ed0: 7468 656e 7469 6361 746f 725f 746f 5f66  thenticator_to_f
│ │ │ │ +00013ee0: 696c 6520 2853 6869 7368 6920 2a20 4841  ile (Shishi * HA
│ │ │ │ +00013ef0: 4e44 4c45 2c0a 2020 2020 2020 2020 2020  NDLE,.          
│ │ │ │ +00013f00: 5368 6973 6869 5f61 736e 3120 4155 5448  Shishi_asn1 AUTH
│ │ │ │ +00013f10: 454e 5449 4341 544f 522c 2069 6e74 2046  ENTICATOR, int F
│ │ │ │ +00013f20: 494c 4554 5950 452c 0a20 2020 2020 2020  ILETYPE,.       
│ │ │ │ +00013f30: 2020 2063 6f6e 7374 2063 6861 7220 2a20     const char * 
│ │ │ │ +00013f40: 4649 4c45 4e41 4d45 290a 2020 2020 2048  FILENAME).     H
│ │ │ │ +00013f50: 414e 444c 453a 2073 6869 7368 6920 6861  ANDLE: shishi ha
│ │ │ │ +00013f60: 6e64 6c65 2061 7320 616c 6c6f 6361 7465  ndle as allocate
│ │ │ │ +00013f70: 6420 6279 20e2 8098 7368 6973 6869 5f69  d by ...shishi_i
│ │ │ │ +00013f80: 6e69 7428 29e2 8099 2e0a 2020 2020 2041  nit().....     A
│ │ │ │ +00013f90: 5554 4845 4e54 4943 4154 4f52 3a20 4175  UTHENTICATOR: Au
│ │ │ │ +00013fa0: 7468 656e 7469 6361 746f 7220 746f 2073  thenticator to s
│ │ │ │ +00013fb0: 6176 652e 0a20 2020 2020 4649 4c45 5459  ave..     FILETY
│ │ │ │ +00013fc0: 5045 3a20 696e 7075 7420 7661 7269 6162  PE: input variab
│ │ │ │ +00013fd0: 6c65 2073 7065 6369 6679 696e 6720 7479  le specifying ty
│ │ │ │ +00013fe0: 7065 206f 6620 6669 6c65 2074 6f20 6265  pe of file to be
│ │ │ │ +00013ff0: 2077 7269 7474 656e 2c20 7365 650a 2020   written, see.  
│ │ │ │ +00014000: 2020 2053 6869 7368 695f 6669 6c65 7479     Shishi_filety
│ │ │ │ +00014010: 7065 2e0a 2020 2020 2046 494c 454e 414d  pe..     FILENAM
│ │ │ │ +00014020: 453a 2069 6e70 7574 2076 6172 6961 626c  E: input variabl
│ │ │ │ +00014030: 6520 7769 7468 2066 696c 656e 616d 6520  e with filename 
│ │ │ │ +00014040: 746f 2077 7269 7465 2074 6f2e 0a0a 2020  to write to...  
│ │ │ │ +00014050: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ +00014060: 2a20 5772 6974 6520 4175 7468 656e 7469  * Write Authenti
│ │ │ │ +00014070: 6361 746f 7220 746f 2066 696c 6520 696e  cator to file in
│ │ │ │ +00014080: 2073 7065 6369 6669 6564 2054 5950 452e   specified TYPE.
│ │ │ │ +00014090: 2054 6865 0a20 2020 2020 6669 6c65 2077   The.     file w
│ │ │ │ +000140a0: 696c 6c20 6265 2074 7275 6e63 6174 6564  ill be truncated
│ │ │ │ +000140b0: 2069 6620 6974 2065 7869 7374 732e 0a0a   if it exists...
│ │ │ │ +000140c0: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ +000140d0: 7565 3a2a 2052 6574 7572 6e73 2053 4849  ue:* Returns SHI
│ │ │ │ +000140e0: 5348 495f 4f4b 2069 6666 2073 7563 6365  SHI_OK iff succe
│ │ │ │ +000140f0: 7373 6675 6c2e 0a0a 7368 6973 6869 5f61  ssful...shishi_a
│ │ │ │ +00014100: 7574 6865 6e74 6963 6174 6f72 5f70 6172  uthenticator_par
│ │ │ │ +00014110: 7365 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  se.-------------
│ │ │ │ +00014120: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ +00014130: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ +00014140: 2073 6869 7368 695f 6175 7468 656e 7469   shishi_authenti
│ │ │ │ +00014150: 6361 746f 725f 7061 7273 6520 2853 6869  cator_parse (Shi
│ │ │ │ +00014160: 7368 6920 2a20 4841 4e44 4c45 2c0a 2020  shi * HANDLE,.  
│ │ │ │ +00014170: 2020 2020 2020 2020 4649 4c45 202a 2046          FILE * F
│ │ │ │ +00014180: 482c 2053 6869 7368 695f 6173 6e31 202a  H, Shishi_asn1 *
│ │ │ │ +00014190: 2041 5554 4845 4e54 4943 4154 4f52 290a   AUTHENTICATOR).
│ │ │ │ +000141a0: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ +000141b0: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ +000141c0: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ +000141d0: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ +000141e0: 2020 2020 2046 483a 2066 696c 6520 6861       FH: file ha
│ │ │ │ +000141f0: 6e64 6c65 206f 7065 6e20 666f 7220 7265  ndle open for re
│ │ │ │ +00014200: 6164 696e 672e 0a20 2020 2020 4155 5448  ading..     AUTH
│ │ │ │ +00014210: 454e 5449 4341 544f 523a 206f 7574 7075  ENTICATOR: outpu
│ │ │ │ +00014220: 7420 7661 7269 6162 6c65 2077 6974 6820  t variable with 
│ │ │ │ +00014230: 6e65 776c 7920 616c 6c6f 6361 7465 6420  newly allocated 
│ │ │ │ +00014240: 6175 7468 656e 7469 6361 746f 722e 0a0a  authenticator...
│ │ │ │ +00014250: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ +00014260: 6e3a 2a20 5265 6164 2041 5343 4949 2061  n:* Read ASCII a
│ │ │ │ +00014270: 726d 6f72 6564 2044 4552 2065 6e63 6f64  rmored DER encod
│ │ │ │ +00014280: 6564 2061 7574 6865 6e74 6963 6174 6f72  ed authenticator
│ │ │ │ +00014290: 2066 726f 6d0a 2020 2020 2066 696c 6520   from.     file 
│ │ │ │ +000142a0: 616e 6420 706f 7075 6c61 7465 2067 6976  and populate giv
│ │ │ │ +000142b0: 656e 2061 7574 6865 6e74 6963 6174 6f72  en authenticator
│ │ │ │ +000142c0: 2076 6172 6961 626c 652e 0a0a 2020 2020   variable...    
│ │ │ │ +000142d0: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ +000142e0: 2052 6574 7572 6e73 2053 4849 5348 495f   Returns SHISHI_
│ │ │ │ +000142f0: 4f4b 2069 6666 2073 7563 6365 7373 6675  OK iff successfu
│ │ │ │ +00014300: 6c2e 0a0a 7368 6973 6869 5f61 7574 6865  l...shishi_authe
│ │ │ │ +00014310: 6e74 6963 6174 6f72 5f72 6561 640a 2d2d  nticator_read.--
│ │ │ │  00014320: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00014330: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ -00014340: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ -00014350: 5f61 7574 6865 6e74 6963 6174 6f72 5f72  _authenticator_r
│ │ │ │ -00014360: 6561 6420 2853 6869 7368 6920 2a20 4841  ead (Shishi * HA
│ │ │ │ -00014370: 4e44 4c45 2c20 4649 4c45 202a 2046 482c  NDLE, FILE * FH,
│ │ │ │ -00014380: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ -00014390: 695f 6173 6e31 202a 2041 5554 4845 4e54  i_asn1 * AUTHENT
│ │ │ │ -000143a0: 4943 4154 4f52 290a 2020 2020 2048 414e  ICATOR).     HAN
│ │ │ │ -000143b0: 444c 453a 2073 6869 7368 6920 6861 6e64  DLE: shishi hand
│ │ │ │ -000143c0: 6c65 2061 7320 616c 6c6f 6361 7465 6420  le as allocated 
│ │ │ │ -000143d0: 6279 20e2 8098 7368 6973 6869 5f69 6e69  by ...shishi_ini
│ │ │ │ -000143e0: 7428 29e2 8099 2e0a 2020 2020 2046 483a  t().....     FH:
│ │ │ │ -000143f0: 2066 696c 6520 6861 6e64 6c65 206f 7065   file handle ope
│ │ │ │ -00014400: 6e20 666f 7220 7265 6164 696e 672e 0a20  n for reading.. 
│ │ │ │ -00014410: 2020 2020 4155 5448 454e 5449 4341 544f      AUTHENTICATO
│ │ │ │ -00014420: 523a 206f 7574 7075 7420 7661 7269 6162  R: output variab
│ │ │ │ -00014430: 6c65 2077 6974 6820 6e65 776c 7920 616c  le with newly al
│ │ │ │ -00014440: 6c6f 6361 7465 6420 6175 7468 656e 7469  located authenti
│ │ │ │ -00014450: 6361 746f 722e 0a0a 2020 2020 202a 4465  cator...     *De
│ │ │ │ -00014460: 7363 7269 7074 696f 6e3a 2a20 5265 6164  scription:* Read
│ │ │ │ -00014470: 2044 4552 2065 6e63 6f64 6564 2061 7574   DER encoded aut
│ │ │ │ -00014480: 6865 6e74 6963 6174 6f72 2066 726f 6d20  henticator from 
│ │ │ │ -00014490: 6669 6c65 2061 6e64 0a20 2020 2020 706f  file and.     po
│ │ │ │ -000144a0: 7075 6c61 7465 2067 6976 656e 2061 7574  pulate given aut
│ │ │ │ -000144b0: 6865 6e74 6963 6174 6f72 2076 6172 6961  henticator varia
│ │ │ │ -000144c0: 626c 652e 0a0a 2020 2020 202a 5265 7475  ble...     *Retu
│ │ │ │ -000144d0: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ -000144e0: 6e73 2053 4849 5348 495f 4f4b 2069 6666  ns SHISHI_OK iff
│ │ │ │ -000144f0: 2073 7563 6365 7373 6675 6c2e 0a0a 7368   successful...sh
│ │ │ │ -00014500: 6973 6869 5f61 7574 6865 6e74 6963 6174  ishi_authenticat
│ │ │ │ -00014510: 6f72 5f66 726f 6d5f 6669 6c65 0a2d 2d2d  or_from_file.---
│ │ │ │ +00014330: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +00014340: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ +00014350: 695f 6175 7468 656e 7469 6361 746f 725f  i_authenticator_
│ │ │ │ +00014360: 7265 6164 2028 5368 6973 6869 202a 2048  read (Shishi * H
│ │ │ │ +00014370: 414e 444c 452c 2046 494c 4520 2a20 4648  ANDLE, FILE * FH
│ │ │ │ +00014380: 2c0a 2020 2020 2020 2020 2020 5368 6973  ,.          Shis
│ │ │ │ +00014390: 6869 5f61 736e 3120 2a20 4155 5448 454e  hi_asn1 * AUTHEN
│ │ │ │ +000143a0: 5449 4341 544f 5229 0a20 2020 2020 4841  TICATOR).     HA
│ │ │ │ +000143b0: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ +000143c0: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ +000143d0: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ +000143e0: 6974 2829 e280 992e 0a20 2020 2020 4648  it().....     FH
│ │ │ │ +000143f0: 3a20 6669 6c65 2068 616e 646c 6520 6f70  : file handle op
│ │ │ │ +00014400: 656e 2066 6f72 2072 6561 6469 6e67 2e0a  en for reading..
│ │ │ │ +00014410: 2020 2020 2041 5554 4845 4e54 4943 4154       AUTHENTICAT
│ │ │ │ +00014420: 4f52 3a20 6f75 7470 7574 2076 6172 6961  OR: output varia
│ │ │ │ +00014430: 626c 6520 7769 7468 206e 6577 6c79 2061  ble with newly a
│ │ │ │ +00014440: 6c6c 6f63 6174 6564 2061 7574 6865 6e74  llocated authent
│ │ │ │ +00014450: 6963 6174 6f72 2e0a 0a20 2020 2020 2a44  icator...     *D
│ │ │ │ +00014460: 6573 6372 6970 7469 6f6e 3a2a 2052 6561  escription:* Rea
│ │ │ │ +00014470: 6420 4445 5220 656e 636f 6465 6420 6175  d DER encoded au
│ │ │ │ +00014480: 7468 656e 7469 6361 746f 7220 6672 6f6d  thenticator from
│ │ │ │ +00014490: 2066 696c 6520 616e 640a 2020 2020 2070   file and.     p
│ │ │ │ +000144a0: 6f70 756c 6174 6520 6769 7665 6e20 6175  opulate given au
│ │ │ │ +000144b0: 7468 656e 7469 6361 746f 7220 7661 7269  thenticator vari
│ │ │ │ +000144c0: 6162 6c65 2e0a 0a20 2020 2020 2a52 6574  able...     *Ret
│ │ │ │ +000144d0: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ +000144e0: 726e 7320 5348 4953 4849 5f4f 4b20 6966  rns SHISHI_OK if
│ │ │ │ +000144f0: 6620 7375 6363 6573 7366 756c 2e0a 0a73  f successful...s
│ │ │ │ +00014500: 6869 7368 695f 6175 7468 656e 7469 6361  hishi_authentica
│ │ │ │ +00014510: 746f 725f 6672 6f6d 5f66 696c 650a 2d2d  tor_from_file.--
│ │ │ │  00014520: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00014530: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ -00014540: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ -00014550: 6869 7368 695f 6175 7468 656e 7469 6361  hishi_authentica
│ │ │ │ -00014560: 746f 725f 6672 6f6d 5f66 696c 6520 2853  tor_from_file (S
│ │ │ │ -00014570: 6869 7368 6920 2a20 4841 4e44 4c45 2c0a  hishi * HANDLE,.
│ │ │ │ -00014580: 2020 2020 2020 2020 2020 5368 6973 6869            Shishi
│ │ │ │ -00014590: 5f61 736e 3120 2a20 4155 5448 454e 5449  _asn1 * AUTHENTI
│ │ │ │ -000145a0: 4341 544f 522c 2069 6e74 2046 494c 4554  CATOR, int FILET
│ │ │ │ -000145b0: 5950 452c 0a20 2020 2020 2020 2020 2063  YPE,.          c
│ │ │ │ -000145c0: 6f6e 7374 2063 6861 7220 2a20 4649 4c45  onst char * FILE
│ │ │ │ -000145d0: 4e41 4d45 290a 2020 2020 2048 414e 444c  NAME).     HANDL
│ │ │ │ -000145e0: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ -000145f0: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ -00014600: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ -00014610: 29e2 8099 2e0a 2020 2020 2041 5554 4845  ).....     AUTHE
│ │ │ │ -00014620: 4e54 4943 4154 4f52 3a20 6f75 7470 7574  NTICATOR: output
│ │ │ │ -00014630: 2076 6172 6961 626c 6520 7769 7468 206e   variable with n
│ │ │ │ -00014640: 6577 6c79 2061 6c6c 6f63 6174 6564 2041  ewly allocated A
│ │ │ │ -00014650: 7574 6865 6e74 6963 6174 6f72 2e0a 0a20  uthenticator... 
│ │ │ │ -00014660: 2020 2020 4649 4c45 5459 5045 3a20 696e      FILETYPE: in
│ │ │ │ -00014670: 7075 7420 7661 7269 6162 6c65 2073 7065  put variable spe
│ │ │ │ -00014680: 6369 6679 696e 6720 7479 7065 206f 6620  cifying type of 
│ │ │ │ -00014690: 6669 6c65 2074 6f20 6265 2072 6561 642c  file to be read,
│ │ │ │ -000146a0: 2073 6565 0a20 2020 2020 5368 6973 6869   see.     Shishi
│ │ │ │ -000146b0: 5f66 696c 6574 7970 652e 0a20 2020 2020  _filetype..     
│ │ │ │ -000146c0: 4649 4c45 4e41 4d45 3a20 696e 7075 7420  FILENAME: input 
│ │ │ │ -000146d0: 7661 7269 6162 6c65 2077 6974 6820 6669  variable with fi
│ │ │ │ -000146e0: 6c65 6e61 6d65 2074 6f20 7265 6164 2066  lename to read f
│ │ │ │ -000146f0: 726f 6d2e 0a0a 2020 2020 202a 4465 7363  rom...     *Desc
│ │ │ │ -00014700: 7269 7074 696f 6e3a 2a20 5265 6164 2041  ription:* Read A
│ │ │ │ -00014710: 7574 6865 6e74 6963 6174 6f72 2066 726f  uthenticator fro
│ │ │ │ -00014720: 6d20 6669 6c65 2069 6e20 7370 6563 6966  m file in specif
│ │ │ │ -00014730: 6965 6420 5459 5045 2e0a 0a20 2020 2020  ied TYPE...     
│ │ │ │ -00014740: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ -00014750: 5265 7475 726e 7320 5348 4953 4849 5f4f  Returns SHISHI_O
│ │ │ │ -00014760: 4b20 6966 6620 7375 6363 6573 7366 756c  K iff successful
│ │ │ │ -00014770: 2e0a 0a73 6869 7368 695f 6175 7468 656e  ...shishi_authen
│ │ │ │ -00014780: 7469 6361 746f 725f 7365 745f 6372 6561  ticator_set_crea
│ │ │ │ -00014790: 6c6d 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  lm.-------------
│ │ │ │ +00014530: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ +00014540: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ +00014550: 7368 6973 6869 5f61 7574 6865 6e74 6963  shishi_authentic
│ │ │ │ +00014560: 6174 6f72 5f66 726f 6d5f 6669 6c65 2028  ator_from_file (
│ │ │ │ +00014570: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ +00014580: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ +00014590: 695f 6173 6e31 202a 2041 5554 4845 4e54  i_asn1 * AUTHENT
│ │ │ │ +000145a0: 4943 4154 4f52 2c20 696e 7420 4649 4c45  ICATOR, int FILE
│ │ │ │ +000145b0: 5459 5045 2c0a 2020 2020 2020 2020 2020  TYPE,.          
│ │ │ │ +000145c0: 636f 6e73 7420 6368 6172 202a 2046 494c  const char * FIL
│ │ │ │ +000145d0: 454e 414d 4529 0a20 2020 2020 4841 4e44  ENAME).     HAND
│ │ │ │ +000145e0: 4c45 3a20 7368 6973 6869 2068 616e 646c  LE: shishi handl
│ │ │ │ +000145f0: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ +00014600: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ +00014610: 2829 e280 992e 0a20 2020 2020 4155 5448  ().....     AUTH
│ │ │ │ +00014620: 454e 5449 4341 544f 523a 206f 7574 7075  ENTICATOR: outpu
│ │ │ │ +00014630: 7420 7661 7269 6162 6c65 2077 6974 6820  t variable with 
│ │ │ │ +00014640: 6e65 776c 7920 616c 6c6f 6361 7465 6420  newly allocated 
│ │ │ │ +00014650: 4175 7468 656e 7469 6361 746f 722e 0a0a  Authenticator...
│ │ │ │ +00014660: 2020 2020 2046 494c 4554 5950 453a 2069       FILETYPE: i
│ │ │ │ +00014670: 6e70 7574 2076 6172 6961 626c 6520 7370  nput variable sp
│ │ │ │ +00014680: 6563 6966 7969 6e67 2074 7970 6520 6f66  ecifying type of
│ │ │ │ +00014690: 2066 696c 6520 746f 2062 6520 7265 6164   file to be read
│ │ │ │ +000146a0: 2c20 7365 650a 2020 2020 2053 6869 7368  , see.     Shish
│ │ │ │ +000146b0: 695f 6669 6c65 7479 7065 2e0a 2020 2020  i_filetype..    
│ │ │ │ +000146c0: 2046 494c 454e 414d 453a 2069 6e70 7574   FILENAME: input
│ │ │ │ +000146d0: 2076 6172 6961 626c 6520 7769 7468 2066   variable with f
│ │ │ │ +000146e0: 696c 656e 616d 6520 746f 2072 6561 6420  ilename to read 
│ │ │ │ +000146f0: 6672 6f6d 2e0a 0a20 2020 2020 2a44 6573  from...     *Des
│ │ │ │ +00014700: 6372 6970 7469 6f6e 3a2a 2052 6561 6420  cription:* Read 
│ │ │ │ +00014710: 4175 7468 656e 7469 6361 746f 7220 6672  Authenticator fr
│ │ │ │ +00014720: 6f6d 2066 696c 6520 696e 2073 7065 6369  om file in speci
│ │ │ │ +00014730: 6669 6564 2054 5950 452e 0a0a 2020 2020  fied TYPE...    
│ │ │ │ +00014740: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ +00014750: 2052 6574 7572 6e73 2053 4849 5348 495f   Returns SHISHI_
│ │ │ │ +00014760: 4f4b 2069 6666 2073 7563 6365 7373 6675  OK iff successfu
│ │ │ │ +00014770: 6c2e 0a0a 7368 6973 6869 5f61 7574 6865  l...shishi_authe
│ │ │ │ +00014780: 6e74 6963 6174 6f72 5f73 6574 5f63 7265  nticator_set_cre
│ │ │ │ +00014790: 616c 6d0a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  alm.------------
│ │ │ │  000147a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000147b0: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ -000147c0: 3a20 696e 7420 7368 6973 6869 5f61 7574  : int shishi_aut
│ │ │ │ -000147d0: 6865 6e74 6963 6174 6f72 5f73 6574 5f63  henticator_set_c
│ │ │ │ -000147e0: 7265 616c 6d20 2853 6869 7368 6920 2a20  realm (Shishi * 
│ │ │ │ -000147f0: 4841 4e44 4c45 2c0a 2020 2020 2020 2020  HANDLE,.        
│ │ │ │ -00014800: 2020 5368 6973 6869 5f61 736e 3120 4155    Shishi_asn1 AU
│ │ │ │ -00014810: 5448 454e 5449 4341 544f 522c 2063 6f6e  THENTICATOR, con
│ │ │ │ -00014820: 7374 2063 6861 7220 2a20 4352 4541 4c4d  st char * CREALM
│ │ │ │ -00014830: 290a 2020 2020 2048 414e 444c 453a 2073  ).     HANDLE: s
│ │ │ │ -00014840: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ -00014850: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ -00014860: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ -00014870: 2e0a 2020 2020 2041 5554 4845 4e54 4943  ..     AUTHENTIC
│ │ │ │ -00014880: 4154 4f52 3a20 6175 7468 656e 7469 6361  ATOR: authentica
│ │ │ │ -00014890: 746f 7220 6173 2061 6c6c 6f63 6174 6564  tor as allocated
│ │ │ │ -000148a0: 2062 790a 2020 2020 20e2 8098 7368 6973   by.     ...shis
│ │ │ │ -000148b0: 6869 5f61 7574 6865 6e74 6963 6174 6f72  hi_authenticator
│ │ │ │ -000148c0: 2829 e280 992e 0a20 2020 2020 4352 4541  ().....     CREA
│ │ │ │ -000148d0: 4c4d 3a20 696e 7075 7420 6172 7261 7920  LM: input array 
│ │ │ │ -000148e0: 7769 7468 2072 6561 6c6d 2e0a 0a20 2020  with realm...   
│ │ │ │ -000148f0: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ -00014900: 2053 6574 2072 6561 6c6d 2066 6965 6c64   Set realm field
│ │ │ │ -00014910: 2069 6e20 6175 7468 656e 7469 6361 746f   in authenticato
│ │ │ │ -00014920: 7220 746f 2073 7065 6369 6669 6564 2076  r to specified v
│ │ │ │ -00014930: 616c 7565 2e0a 0a20 2020 2020 2a52 6574  alue...     *Ret
│ │ │ │ -00014940: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ -00014950: 726e 7320 5348 4953 4849 5f4f 4b20 6966  rns SHISHI_OK if
│ │ │ │ -00014960: 6620 7375 6363 6573 7366 756c 2e0a 0a73  f successful...s
│ │ │ │ -00014970: 6869 7368 695f 6175 7468 656e 7469 6361  hishi_authentica
│ │ │ │ -00014980: 746f 725f 7365 745f 636e 616d 650a 2d2d  tor_set_cname.--
│ │ │ │ +000147b0: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ +000147c0: 6e3a 2069 6e74 2073 6869 7368 695f 6175  n: int shishi_au
│ │ │ │ +000147d0: 7468 656e 7469 6361 746f 725f 7365 745f  thenticator_set_
│ │ │ │ +000147e0: 6372 6561 6c6d 2028 5368 6973 6869 202a  crealm (Shishi *
│ │ │ │ +000147f0: 2048 414e 444c 452c 0a20 2020 2020 2020   HANDLE,.       
│ │ │ │ +00014800: 2020 2053 6869 7368 695f 6173 6e31 2041     Shishi_asn1 A
│ │ │ │ +00014810: 5554 4845 4e54 4943 4154 4f52 2c20 636f  UTHENTICATOR, co
│ │ │ │ +00014820: 6e73 7420 6368 6172 202a 2043 5245 414c  nst char * CREAL
│ │ │ │ +00014830: 4d29 0a20 2020 2020 4841 4e44 4c45 3a20  M).     HANDLE: 
│ │ │ │ +00014840: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ +00014850: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ +00014860: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ +00014870: 992e 0a20 2020 2020 4155 5448 454e 5449  ...     AUTHENTI
│ │ │ │ +00014880: 4341 544f 523a 2061 7574 6865 6e74 6963  CATOR: authentic
│ │ │ │ +00014890: 6174 6f72 2061 7320 616c 6c6f 6361 7465  ator as allocate
│ │ │ │ +000148a0: 6420 6279 0a20 2020 2020 e280 9873 6869  d by.     ...shi
│ │ │ │ +000148b0: 7368 695f 6175 7468 656e 7469 6361 746f  shi_authenticato
│ │ │ │ +000148c0: 7228 29e2 8099 2e0a 2020 2020 2043 5245  r().....     CRE
│ │ │ │ +000148d0: 414c 4d3a 2069 6e70 7574 2061 7272 6179  ALM: input array
│ │ │ │ +000148e0: 2077 6974 6820 7265 616c 6d2e 0a0a 2020   with realm...  
│ │ │ │ +000148f0: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ +00014900: 2a20 5365 7420 7265 616c 6d20 6669 656c  * Set realm fiel
│ │ │ │ +00014910: 6420 696e 2061 7574 6865 6e74 6963 6174  d in authenticat
│ │ │ │ +00014920: 6f72 2074 6f20 7370 6563 6966 6965 6420  or to specified 
│ │ │ │ +00014930: 7661 6c75 652e 0a0a 2020 2020 202a 5265  value...     *Re
│ │ │ │ +00014940: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ +00014950: 7572 6e73 2053 4849 5348 495f 4f4b 2069  urns SHISHI_OK i
│ │ │ │ +00014960: 6666 2073 7563 6365 7373 6675 6c2e 0a0a  ff successful...
│ │ │ │ +00014970: 7368 6973 6869 5f61 7574 6865 6e74 6963  shishi_authentic
│ │ │ │ +00014980: 6174 6f72 5f73 6574 5f63 6e61 6d65 0a2d  ator_set_cname.-
│ │ │ │  00014990: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000149a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ -000149b0: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ -000149c0: 7368 6973 6869 5f61 7574 6865 6e74 6963  shishi_authentic
│ │ │ │ -000149d0: 6174 6f72 5f73 6574 5f63 6e61 6d65 2028  ator_set_cname (
│ │ │ │ -000149e0: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ -000149f0: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ -00014a00: 695f 6173 6e31 2041 5554 4845 4e54 4943  i_asn1 AUTHENTIC
│ │ │ │ -00014a10: 4154 4f52 2c20 5368 6973 6869 5f6e 616d  ATOR, Shishi_nam
│ │ │ │ -00014a20: 655f 7479 7065 204e 414d 455f 5459 5045  e_type NAME_TYPE
│ │ │ │ -00014a30: 2c0a 2020 2020 2020 2020 2020 636f 6e73  ,.          cons
│ │ │ │ -00014a40: 7420 6368 6172 202a 2043 4e41 4d45 5b5d  t char * CNAME[]
│ │ │ │ -00014a50: 290a 2020 2020 2048 414e 444c 453a 2073  ).     HANDLE: s
│ │ │ │ -00014a60: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ -00014a70: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ -00014a80: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ -00014a90: 2e0a 2020 2020 2041 5554 4845 4e54 4943  ..     AUTHENTIC
│ │ │ │ -00014aa0: 4154 4f52 3a20 6175 7468 656e 7469 6361  ATOR: authentica
│ │ │ │ -00014ab0: 746f 7220 6173 2061 6c6c 6f63 6174 6564  tor as allocated
│ │ │ │ -00014ac0: 2062 790a 2020 2020 20e2 8098 7368 6973   by.     ...shis
│ │ │ │ -00014ad0: 6869 5f61 7574 6865 6e74 6963 6174 6f72  hi_authenticator
│ │ │ │ -00014ae0: 2829 e280 992e 0a20 2020 2020 4e41 4d45  ().....     NAME
│ │ │ │ -00014af0: 5f54 5950 453a 2074 7970 6520 6f66 2070  _TYPE: type of p
│ │ │ │ -00014b00: 7269 6e63 6970 6961 6c2c 2073 6565 2053  rincipial, see S
│ │ │ │ -00014b10: 6869 7368 695f 6e61 6d65 5f74 7970 652c  hishi_name_type,
│ │ │ │ -00014b20: 2075 7375 616c 6c79 0a20 2020 2020 5348   usually.     SH
│ │ │ │ -00014b30: 4953 4849 5f4e 545f 554e 4b4e 4f57 4e2e  ISHI_NT_UNKNOWN.
│ │ │ │ -00014b40: 0a20 2020 2020 434e 414d 453a 2069 6e70  .     CNAME: inp
│ │ │ │ -00014b50: 7574 2061 7272 6179 2077 6974 6820 7072  ut array with pr
│ │ │ │ -00014b60: 696e 6369 7061 6c20 6e61 6d65 2e0a 0a20  incipal name... 
│ │ │ │ -00014b70: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -00014b80: 3a2a 2053 6574 2070 7269 6e63 6970 616c  :* Set principal
│ │ │ │ -00014b90: 2066 6965 6c64 2069 6e20 6175 7468 656e   field in authen
│ │ │ │ -00014ba0: 7469 6361 746f 7220 746f 2073 7065 6369  ticator to speci
│ │ │ │ -00014bb0: 6669 6564 0a20 2020 2020 7661 6c75 652e  fied.     value.
│ │ │ │ -00014bc0: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ -00014bd0: 616c 7565 3a2a 2052 6574 7572 6e73 2053  alue:* Returns S
│ │ │ │ -00014be0: 4849 5348 495f 4f4b 2069 6666 2073 7563  HISHI_OK iff suc
│ │ │ │ -00014bf0: 6365 7373 6675 6c2e 0a0a 7368 6973 6869  cessful...shishi
│ │ │ │ -00014c00: 5f61 7574 6865 6e74 6963 6174 6f72 5f63  _authenticator_c
│ │ │ │ -00014c10: 6c69 656e 745f 7365 740a 2d2d 2d2d 2d2d  lient_set.------
│ │ │ │ +000149a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ +000149b0: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ +000149c0: 2073 6869 7368 695f 6175 7468 656e 7469   shishi_authenti
│ │ │ │ +000149d0: 6361 746f 725f 7365 745f 636e 616d 6520  cator_set_cname 
│ │ │ │ +000149e0: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ +000149f0: 2c0a 2020 2020 2020 2020 2020 5368 6973  ,.          Shis
│ │ │ │ +00014a00: 6869 5f61 736e 3120 4155 5448 454e 5449  hi_asn1 AUTHENTI
│ │ │ │ +00014a10: 4341 544f 522c 2053 6869 7368 695f 6e61  CATOR, Shishi_na
│ │ │ │ +00014a20: 6d65 5f74 7970 6520 4e41 4d45 5f54 5950  me_type NAME_TYP
│ │ │ │ +00014a30: 452c 0a20 2020 2020 2020 2020 2063 6f6e  E,.          con
│ │ │ │ +00014a40: 7374 2063 6861 7220 2a20 434e 414d 455b  st char * CNAME[
│ │ │ │ +00014a50: 5d29 0a20 2020 2020 4841 4e44 4c45 3a20  ]).     HANDLE: 
│ │ │ │ +00014a60: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ +00014a70: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ +00014a80: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ +00014a90: 992e 0a20 2020 2020 4155 5448 454e 5449  ...     AUTHENTI
│ │ │ │ +00014aa0: 4341 544f 523a 2061 7574 6865 6e74 6963  CATOR: authentic
│ │ │ │ +00014ab0: 6174 6f72 2061 7320 616c 6c6f 6361 7465  ator as allocate
│ │ │ │ +00014ac0: 6420 6279 0a20 2020 2020 e280 9873 6869  d by.     ...shi
│ │ │ │ +00014ad0: 7368 695f 6175 7468 656e 7469 6361 746f  shi_authenticato
│ │ │ │ +00014ae0: 7228 29e2 8099 2e0a 2020 2020 204e 414d  r().....     NAM
│ │ │ │ +00014af0: 455f 5459 5045 3a20 7479 7065 206f 6620  E_TYPE: type of 
│ │ │ │ +00014b00: 7072 696e 6369 7069 616c 2c20 7365 6520  principial, see 
│ │ │ │ +00014b10: 5368 6973 6869 5f6e 616d 655f 7479 7065  Shishi_name_type
│ │ │ │ +00014b20: 2c20 7573 7561 6c6c 790a 2020 2020 2053  , usually.     S
│ │ │ │ +00014b30: 4849 5348 495f 4e54 5f55 4e4b 4e4f 574e  HISHI_NT_UNKNOWN
│ │ │ │ +00014b40: 2e0a 2020 2020 2043 4e41 4d45 3a20 696e  ..     CNAME: in
│ │ │ │ +00014b50: 7075 7420 6172 7261 7920 7769 7468 2070  put array with p
│ │ │ │ +00014b60: 7269 6e63 6970 616c 206e 616d 652e 0a0a  rincipal name...
│ │ │ │ +00014b70: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ +00014b80: 6e3a 2a20 5365 7420 7072 696e 6369 7061  n:* Set principa
│ │ │ │ +00014b90: 6c20 6669 656c 6420 696e 2061 7574 6865  l field in authe
│ │ │ │ +00014ba0: 6e74 6963 6174 6f72 2074 6f20 7370 6563  nticator to spec
│ │ │ │ +00014bb0: 6966 6965 640a 2020 2020 2076 616c 7565  ified.     value
│ │ │ │ +00014bc0: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ +00014bd0: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ +00014be0: 5348 4953 4849 5f4f 4b20 6966 6620 7375  SHISHI_OK iff su
│ │ │ │ +00014bf0: 6363 6573 7366 756c 2e0a 0a73 6869 7368  ccessful...shish
│ │ │ │ +00014c00: 695f 6175 7468 656e 7469 6361 746f 725f  i_authenticator_
│ │ │ │ +00014c10: 636c 6965 6e74 5f73 6574 0a2d 2d2d 2d2d  client_set.-----
│ │ │ │  00014c20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00014c30: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ -00014c40: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ -00014c50: 7368 695f 6175 7468 656e 7469 6361 746f  shi_authenticato
│ │ │ │ -00014c60: 725f 636c 6965 6e74 5f73 6574 2028 5368  r_client_set (Sh
│ │ │ │ -00014c70: 6973 6869 202a 2048 414e 444c 452c 0a20  ishi * HANDLE,. 
│ │ │ │ -00014c80: 2020 2020 2020 2020 2053 6869 7368 695f           Shishi_
│ │ │ │ -00014c90: 6173 6e31 2041 5554 4845 4e54 4943 4154  asn1 AUTHENTICAT
│ │ │ │ -00014ca0: 4f52 2c20 636f 6e73 7420 6368 6172 202a  OR, const char *
│ │ │ │ -00014cb0: 2043 4c49 454e 5429 0a20 2020 2020 4841   CLIENT).     HA
│ │ │ │ -00014cc0: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ -00014cd0: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ -00014ce0: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ -00014cf0: 6974 2829 e280 992e 0a20 2020 2020 4155  it().....     AU
│ │ │ │ -00014d00: 5448 454e 5449 4341 544f 523a 2041 7574  THENTICATOR: Aut
│ │ │ │ -00014d10: 6865 6e74 6963 6174 6f72 2074 6f20 7365  henticator to se
│ │ │ │ -00014d20: 7420 636c 6965 6e74 206e 616d 6520 6669  t client name fi
│ │ │ │ -00014d30: 656c 6420 696e 2e0a 2020 2020 2043 4c49  eld in..     CLI
│ │ │ │ -00014d40: 454e 543a 207a 6572 6f2d 7465 726d 696e  ENT: zero-termin
│ │ │ │ -00014d50: 6174 6564 2073 7472 696e 6720 7769 7468  ated string with
│ │ │ │ -00014d60: 2070 7269 6e63 6970 616c 206e 616d 6520   principal name 
│ │ │ │ -00014d70: 6f6e 2052 4643 2031 3936 340a 2020 2020  on RFC 1964.    
│ │ │ │ -00014d80: 2066 6f72 6d2e 0a0a 2020 2020 202a 4465   form...     *De
│ │ │ │ -00014d90: 7363 7269 7074 696f 6e3a 2a20 5365 7420  scription:* Set 
│ │ │ │ -00014da0: 7468 6520 636c 6965 6e74 206e 616d 6520  the client name 
│ │ │ │ -00014db0: 6669 656c 6420 696e 2074 6865 2041 7574  field in the Aut
│ │ │ │ -00014dc0: 6865 6e74 6963 6174 6f72 2e0a 0a20 2020  henticator...   
│ │ │ │ -00014dd0: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ -00014de0: 2a20 5265 7475 726e 7320 5348 4953 4849  * Returns SHISHI
│ │ │ │ -00014df0: 5f4f 4b20 6966 6620 7375 6363 6573 7366  _OK iff successf
│ │ │ │ -00014e00: 756c 2e0a 0a73 6869 7368 695f 6175 7468  ul...shishi_auth
│ │ │ │ -00014e10: 656e 7469 6361 746f 725f 6374 696d 650a  enticator_ctime.
│ │ │ │ -00014e20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00014e30: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ -00014e40: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ -00014e50: 6973 6869 5f61 7574 6865 6e74 6963 6174  ishi_authenticat
│ │ │ │ -00014e60: 6f72 5f63 7469 6d65 2028 5368 6973 6869  or_ctime (Shishi
│ │ │ │ -00014e70: 202a 2048 414e 444c 452c 0a20 2020 2020   * HANDLE,.     
│ │ │ │ -00014e80: 2020 2020 2053 6869 7368 695f 6173 6e31       Shishi_asn1
│ │ │ │ -00014e90: 2041 5554 4845 4e54 4943 4154 4f52 2c20   AUTHENTICATOR, 
│ │ │ │ -00014ea0: 6368 6172 202a 2a20 5429 0a20 2020 2020  char ** T).     
│ │ │ │ -00014eb0: 4841 4e44 4c45 3a20 7368 6973 6869 2068  HANDLE: shishi h
│ │ │ │ -00014ec0: 616e 646c 6520 6173 2061 6c6c 6f63 6174  andle as allocat
│ │ │ │ -00014ed0: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ -00014ee0: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ -00014ef0: 4155 5448 454e 5449 4341 544f 523a 2041  AUTHENTICATOR: A
│ │ │ │ -00014f00: 7574 6865 6e74 6963 6174 6f72 2061 7320  uthenticator as 
│ │ │ │ -00014f10: 616c 6c6f 6361 7465 6420 6279 0a20 2020  allocated by.   
│ │ │ │ -00014f20: 2020 e280 9873 6869 7368 695f 6175 7468    ...shishi_auth
│ │ │ │ -00014f30: 656e 7469 6361 746f 7228 29e2 8099 2e0a  enticator().....
│ │ │ │ -00014f40: 2020 2020 2054 3a20 6e65 776c 7920 616c       T: newly al
│ │ │ │ -00014f50: 6c6f 6361 7465 6420 7a65 726f 2d74 6572  located zero-ter
│ │ │ │ -00014f60: 6d69 6e61 7465 6420 6368 6172 6163 7465  minated characte
│ │ │ │ -00014f70: 7220 6172 7261 7920 7769 7468 2063 6c69  r array with cli
│ │ │ │ -00014f80: 656e 740a 2020 2020 2074 696d 652e 0a0a  ent.     time...
│ │ │ │ -00014f90: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ -00014fa0: 6e3a 2a20 4578 7472 6163 7420 636c 6965  n:* Extract clie
│ │ │ │ -00014fb0: 6e74 2074 696d 6520 6672 6f6d 2041 7574  nt time from Aut
│ │ │ │ -00014fc0: 6865 6e74 6963 6174 6f72 2e0a 0a20 2020  henticator...   
│ │ │ │ -00014fd0: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ -00014fe0: 2a20 5265 7475 726e 7320 5348 4953 4849  * Returns SHISHI
│ │ │ │ -00014ff0: 5f4f 4b20 6966 6620 7375 6363 6573 7366  _OK iff successf
│ │ │ │ -00015000: 756c 2e0a 0a73 6869 7368 695f 6175 7468  ul...shishi_auth
│ │ │ │ -00015010: 656e 7469 6361 746f 725f 6374 696d 655f  enticator_ctime_
│ │ │ │ -00015020: 7365 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  set.------------
│ │ │ │ +00014c30: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +00014c40: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ +00014c50: 6973 6869 5f61 7574 6865 6e74 6963 6174  ishi_authenticat
│ │ │ │ +00014c60: 6f72 5f63 6c69 656e 745f 7365 7420 2853  or_client_set (S
│ │ │ │ +00014c70: 6869 7368 6920 2a20 4841 4e44 4c45 2c0a  hishi * HANDLE,.
│ │ │ │ +00014c80: 2020 2020 2020 2020 2020 5368 6973 6869            Shishi
│ │ │ │ +00014c90: 5f61 736e 3120 4155 5448 454e 5449 4341  _asn1 AUTHENTICA
│ │ │ │ +00014ca0: 544f 522c 2063 6f6e 7374 2063 6861 7220  TOR, const char 
│ │ │ │ +00014cb0: 2a20 434c 4945 4e54 290a 2020 2020 2048  * CLIENT).     H
│ │ │ │ +00014cc0: 414e 444c 453a 2073 6869 7368 6920 6861  ANDLE: shishi ha
│ │ │ │ +00014cd0: 6e64 6c65 2061 7320 616c 6c6f 6361 7465  ndle as allocate
│ │ │ │ +00014ce0: 6420 6279 20e2 8098 7368 6973 6869 5f69  d by ...shishi_i
│ │ │ │ +00014cf0: 6e69 7428 29e2 8099 2e0a 2020 2020 2041  nit().....     A
│ │ │ │ +00014d00: 5554 4845 4e54 4943 4154 4f52 3a20 4175  UTHENTICATOR: Au
│ │ │ │ +00014d10: 7468 656e 7469 6361 746f 7220 746f 2073  thenticator to s
│ │ │ │ +00014d20: 6574 2063 6c69 656e 7420 6e61 6d65 2066  et client name f
│ │ │ │ +00014d30: 6965 6c64 2069 6e2e 0a20 2020 2020 434c  ield in..     CL
│ │ │ │ +00014d40: 4945 4e54 3a20 7a65 726f 2d74 6572 6d69  IENT: zero-termi
│ │ │ │ +00014d50: 6e61 7465 6420 7374 7269 6e67 2077 6974  nated string wit
│ │ │ │ +00014d60: 6820 7072 696e 6369 7061 6c20 6e61 6d65  h principal name
│ │ │ │ +00014d70: 206f 6e20 5246 4320 3139 3634 0a20 2020   on RFC 1964.   
│ │ │ │ +00014d80: 2020 666f 726d 2e0a 0a20 2020 2020 2a44    form...     *D
│ │ │ │ +00014d90: 6573 6372 6970 7469 6f6e 3a2a 2053 6574  escription:* Set
│ │ │ │ +00014da0: 2074 6865 2063 6c69 656e 7420 6e61 6d65   the client name
│ │ │ │ +00014db0: 2066 6965 6c64 2069 6e20 7468 6520 4175   field in the Au
│ │ │ │ +00014dc0: 7468 656e 7469 6361 746f 722e 0a0a 2020  thenticator...  
│ │ │ │ +00014dd0: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ +00014de0: 3a2a 2052 6574 7572 6e73 2053 4849 5348  :* Returns SHISH
│ │ │ │ +00014df0: 495f 4f4b 2069 6666 2073 7563 6365 7373  I_OK iff success
│ │ │ │ +00014e00: 6675 6c2e 0a0a 7368 6973 6869 5f61 7574  ful...shishi_aut
│ │ │ │ +00014e10: 6865 6e74 6963 6174 6f72 5f63 7469 6d65  henticator_ctime
│ │ │ │ +00014e20: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ +00014e30: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ +00014e40: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ +00014e50: 6869 7368 695f 6175 7468 656e 7469 6361  hishi_authentica
│ │ │ │ +00014e60: 746f 725f 6374 696d 6520 2853 6869 7368  tor_ctime (Shish
│ │ │ │ +00014e70: 6920 2a20 4841 4e44 4c45 2c0a 2020 2020  i * HANDLE,.    
│ │ │ │ +00014e80: 2020 2020 2020 5368 6973 6869 5f61 736e        Shishi_asn
│ │ │ │ +00014e90: 3120 4155 5448 454e 5449 4341 544f 522c  1 AUTHENTICATOR,
│ │ │ │ +00014ea0: 2063 6861 7220 2a2a 2054 290a 2020 2020   char ** T).    
│ │ │ │ +00014eb0: 2048 414e 444c 453a 2073 6869 7368 6920   HANDLE: shishi 
│ │ │ │ +00014ec0: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ +00014ed0: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ +00014ee0: 5f69 6e69 7428 29e2 8099 2e0a 2020 2020  _init().....    
│ │ │ │ +00014ef0: 2041 5554 4845 4e54 4943 4154 4f52 3a20   AUTHENTICATOR: 
│ │ │ │ +00014f00: 4175 7468 656e 7469 6361 746f 7220 6173  Authenticator as
│ │ │ │ +00014f10: 2061 6c6c 6f63 6174 6564 2062 790a 2020   allocated by.  
│ │ │ │ +00014f20: 2020 20e2 8098 7368 6973 6869 5f61 7574     ...shishi_aut
│ │ │ │ +00014f30: 6865 6e74 6963 6174 6f72 2829 e280 992e  henticator()....
│ │ │ │ +00014f40: 0a20 2020 2020 543a 206e 6577 6c79 2061  .     T: newly a
│ │ │ │ +00014f50: 6c6c 6f63 6174 6564 207a 6572 6f2d 7465  llocated zero-te
│ │ │ │ +00014f60: 726d 696e 6174 6564 2063 6861 7261 6374  rminated charact
│ │ │ │ +00014f70: 6572 2061 7272 6179 2077 6974 6820 636c  er array with cl
│ │ │ │ +00014f80: 6965 6e74 0a20 2020 2020 7469 6d65 2e0a  ient.     time..
│ │ │ │ +00014f90: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +00014fa0: 6f6e 3a2a 2045 7874 7261 6374 2063 6c69  on:* Extract cli
│ │ │ │ +00014fb0: 656e 7420 7469 6d65 2066 726f 6d20 4175  ent time from Au
│ │ │ │ +00014fc0: 7468 656e 7469 6361 746f 722e 0a0a 2020  thenticator...  
│ │ │ │ +00014fd0: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ +00014fe0: 3a2a 2052 6574 7572 6e73 2053 4849 5348  :* Returns SHISH
│ │ │ │ +00014ff0: 495f 4f4b 2069 6666 2073 7563 6365 7373  I_OK iff success
│ │ │ │ +00015000: 6675 6c2e 0a0a 7368 6973 6869 5f61 7574  ful...shishi_aut
│ │ │ │ +00015010: 6865 6e74 6963 6174 6f72 5f63 7469 6d65  henticator_ctime
│ │ │ │ +00015020: 5f73 6574 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  _set.-----------
│ │ │ │  00015030: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00015040: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ -00015050: 3a20 696e 7420 7368 6973 6869 5f61 7574  : int shishi_aut
│ │ │ │ -00015060: 6865 6e74 6963 6174 6f72 5f63 7469 6d65  henticator_ctime
│ │ │ │ -00015070: 5f73 6574 2028 5368 6973 6869 202a 2048  _set (Shishi * H
│ │ │ │ -00015080: 414e 444c 452c 0a20 2020 2020 2020 2020  ANDLE,.         
│ │ │ │ -00015090: 2053 6869 7368 695f 6173 6e31 2041 5554   Shishi_asn1 AUT
│ │ │ │ -000150a0: 4845 4e54 4943 4154 4f52 2c20 636f 6e73  HENTICATOR, cons
│ │ │ │ -000150b0: 7420 6368 6172 202a 2054 290a 2020 2020  t char * T).    
│ │ │ │ -000150c0: 2048 414e 444c 453a 2073 6869 7368 6920   HANDLE: shishi 
│ │ │ │ -000150d0: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ -000150e0: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ -000150f0: 5f69 6e69 7428 29e2 8099 2e0a 2020 2020  _init().....    
│ │ │ │ -00015100: 2041 5554 4845 4e54 4943 4154 4f52 3a20   AUTHENTICATOR: 
│ │ │ │ -00015110: 4175 7468 656e 7469 6361 746f 7220 6173  Authenticator as
│ │ │ │ -00015120: 2061 6c6c 6f63 6174 6564 2062 790a 2020   allocated by.  
│ │ │ │ -00015130: 2020 20e2 8098 7368 6973 6869 5f61 7574     ...shishi_aut
│ │ │ │ -00015140: 6865 6e74 6963 6174 6f72 2829 e280 992e  henticator()....
│ │ │ │ -00015150: 0a20 2020 2020 543a 2073 7472 696e 6720  .     T: string 
│ │ │ │ -00015160: 7769 7468 2067 656e 6572 616c 697a 6564  with generalized
│ │ │ │ -00015170: 2074 696d 6520 7661 6c75 6520 746f 2073   time value to s
│ │ │ │ -00015180: 746f 7265 2069 6e20 4175 7468 656e 7469  tore in Authenti
│ │ │ │ -00015190: 6361 746f 722e 0a0a 2020 2020 202a 4465  cator...     *De
│ │ │ │ -000151a0: 7363 7269 7074 696f 6e3a 2a20 5374 6f72  scription:* Stor
│ │ │ │ -000151b0: 6520 636c 6965 6e74 2074 696d 6520 696e  e client time in
│ │ │ │ -000151c0: 2041 7574 6865 6e74 6963 6174 6f72 2e0a   Authenticator..
│ │ │ │ -000151d0: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ -000151e0: 6c75 653a 2a20 5265 7475 726e 7320 5348  lue:* Returns SH
│ │ │ │ -000151f0: 4953 4849 5f4f 4b20 6966 6620 7375 6363  ISHI_OK iff succ
│ │ │ │ -00015200: 6573 7366 756c 2e0a 0a73 6869 7368 695f  essful...shishi_
│ │ │ │ -00015210: 6175 7468 656e 7469 6361 746f 725f 6375  authenticator_cu
│ │ │ │ -00015220: 7365 635f 6765 740a 2d2d 2d2d 2d2d 2d2d  sec_get.--------
│ │ │ │ +00015040: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ +00015050: 6e3a 2069 6e74 2073 6869 7368 695f 6175  n: int shishi_au
│ │ │ │ +00015060: 7468 656e 7469 6361 746f 725f 6374 696d  thenticator_ctim
│ │ │ │ +00015070: 655f 7365 7420 2853 6869 7368 6920 2a20  e_set (Shishi * 
│ │ │ │ +00015080: 4841 4e44 4c45 2c0a 2020 2020 2020 2020  HANDLE,.        
│ │ │ │ +00015090: 2020 5368 6973 6869 5f61 736e 3120 4155    Shishi_asn1 AU
│ │ │ │ +000150a0: 5448 454e 5449 4341 544f 522c 2063 6f6e  THENTICATOR, con
│ │ │ │ +000150b0: 7374 2063 6861 7220 2a20 5429 0a20 2020  st char * T).   
│ │ │ │ +000150c0: 2020 4841 4e44 4c45 3a20 7368 6973 6869    HANDLE: shishi
│ │ │ │ +000150d0: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ +000150e0: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ +000150f0: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ +00015100: 2020 4155 5448 454e 5449 4341 544f 523a    AUTHENTICATOR:
│ │ │ │ +00015110: 2041 7574 6865 6e74 6963 6174 6f72 2061   Authenticator a
│ │ │ │ +00015120: 7320 616c 6c6f 6361 7465 6420 6279 0a20  s allocated by. 
│ │ │ │ +00015130: 2020 2020 e280 9873 6869 7368 695f 6175      ...shishi_au
│ │ │ │ +00015140: 7468 656e 7469 6361 746f 7228 29e2 8099  thenticator()...
│ │ │ │ +00015150: 2e0a 2020 2020 2054 3a20 7374 7269 6e67  ..     T: string
│ │ │ │ +00015160: 2077 6974 6820 6765 6e65 7261 6c69 7a65   with generalize
│ │ │ │ +00015170: 6420 7469 6d65 2076 616c 7565 2074 6f20  d time value to 
│ │ │ │ +00015180: 7374 6f72 6520 696e 2041 7574 6865 6e74  store in Authent
│ │ │ │ +00015190: 6963 6174 6f72 2e0a 0a20 2020 2020 2a44  icator...     *D
│ │ │ │ +000151a0: 6573 6372 6970 7469 6f6e 3a2a 2053 746f  escription:* Sto
│ │ │ │ +000151b0: 7265 2063 6c69 656e 7420 7469 6d65 2069  re client time i
│ │ │ │ +000151c0: 6e20 4175 7468 656e 7469 6361 746f 722e  n Authenticator.
│ │ │ │ +000151d0: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ +000151e0: 616c 7565 3a2a 2052 6574 7572 6e73 2053  alue:* Returns S
│ │ │ │ +000151f0: 4849 5348 495f 4f4b 2069 6666 2073 7563  HISHI_OK iff suc
│ │ │ │ +00015200: 6365 7373 6675 6c2e 0a0a 7368 6973 6869  cessful...shishi
│ │ │ │ +00015210: 5f61 7574 6865 6e74 6963 6174 6f72 5f63  _authenticator_c
│ │ │ │ +00015220: 7573 6563 5f67 6574 0a2d 2d2d 2d2d 2d2d  usec_get.-------
│ │ │ │  00015230: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00015240: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ -00015250: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ -00015260: 5f61 7574 6865 6e74 6963 6174 6f72 5f63  _authenticator_c
│ │ │ │ -00015270: 7573 6563 5f67 6574 2028 5368 6973 6869  usec_get (Shishi
│ │ │ │ -00015280: 202a 2048 414e 444c 452c 0a20 2020 2020   * HANDLE,.     
│ │ │ │ -00015290: 2020 2020 2053 6869 7368 695f 6173 6e31       Shishi_asn1
│ │ │ │ -000152a0: 2041 5554 4845 4e54 4943 4154 4f52 2c20   AUTHENTICATOR, 
│ │ │ │ -000152b0: 7569 6e74 3332 5f74 202a 2043 5553 4543  uint32_t * CUSEC
│ │ │ │ -000152c0: 290a 2020 2020 2048 414e 444c 453a 2073  ).     HANDLE: s
│ │ │ │ -000152d0: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ -000152e0: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ -000152f0: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ -00015300: 2e0a 2020 2020 2041 5554 4845 4e54 4943  ..     AUTHENTIC
│ │ │ │ -00015310: 4154 4f52 3a20 4175 7468 656e 7469 6361  ATOR: Authentica
│ │ │ │ -00015320: 746f 7220 6173 2061 6c6c 6f63 6174 6564  tor as allocated
│ │ │ │ -00015330: 2062 790a 2020 2020 20e2 8098 7368 6973   by.     ...shis
│ │ │ │ -00015340: 6869 5f61 7574 6865 6e74 6963 6174 6f72  hi_authenticator
│ │ │ │ -00015350: 2829 e280 992e 0a20 2020 2020 4355 5345  ().....     CUSE
│ │ │ │ -00015360: 433a 206f 7574 7075 7420 696e 7465 6765  C: output intege
│ │ │ │ -00015370: 7220 7769 7468 2063 6c69 656e 7420 6d69  r with client mi
│ │ │ │ -00015380: 6372 6f73 6563 6f6e 6473 2066 6965 6c64  croseconds field
│ │ │ │ -00015390: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ -000153a0: 7469 6f6e 3a2a 2045 7874 7261 6374 2063  tion:* Extract c
│ │ │ │ -000153b0: 6c69 656e 7420 6d69 6372 6f73 6563 6f6e  lient microsecon
│ │ │ │ -000153c0: 6473 2066 6965 6c64 2066 726f 6d0a 2020  ds field from.  
│ │ │ │ -000153d0: 2020 2041 7574 6865 6e74 6963 6174 6f72     Authenticator
│ │ │ │ -000153e0: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ -000153f0: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ -00015400: 5348 4953 4849 5f4f 4b20 6966 6620 7375  SHISHI_OK iff su
│ │ │ │ -00015410: 6363 6573 7366 756c 2e0a 0a73 6869 7368  ccessful...shish
│ │ │ │ -00015420: 695f 6175 7468 656e 7469 6361 746f 725f  i_authenticator_
│ │ │ │ -00015430: 6375 7365 635f 7365 740a 2d2d 2d2d 2d2d  cusec_set.------
│ │ │ │ +00015240: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +00015250: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ +00015260: 695f 6175 7468 656e 7469 6361 746f 725f  i_authenticator_
│ │ │ │ +00015270: 6375 7365 635f 6765 7420 2853 6869 7368  cusec_get (Shish
│ │ │ │ +00015280: 6920 2a20 4841 4e44 4c45 2c0a 2020 2020  i * HANDLE,.    
│ │ │ │ +00015290: 2020 2020 2020 5368 6973 6869 5f61 736e        Shishi_asn
│ │ │ │ +000152a0: 3120 4155 5448 454e 5449 4341 544f 522c  1 AUTHENTICATOR,
│ │ │ │ +000152b0: 2075 696e 7433 325f 7420 2a20 4355 5345   uint32_t * CUSE
│ │ │ │ +000152c0: 4329 0a20 2020 2020 4841 4e44 4c45 3a20  C).     HANDLE: 
│ │ │ │ +000152d0: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ +000152e0: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ +000152f0: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ +00015300: 992e 0a20 2020 2020 4155 5448 454e 5449  ...     AUTHENTI
│ │ │ │ +00015310: 4341 544f 523a 2041 7574 6865 6e74 6963  CATOR: Authentic
│ │ │ │ +00015320: 6174 6f72 2061 7320 616c 6c6f 6361 7465  ator as allocate
│ │ │ │ +00015330: 6420 6279 0a20 2020 2020 e280 9873 6869  d by.     ...shi
│ │ │ │ +00015340: 7368 695f 6175 7468 656e 7469 6361 746f  shi_authenticato
│ │ │ │ +00015350: 7228 29e2 8099 2e0a 2020 2020 2043 5553  r().....     CUS
│ │ │ │ +00015360: 4543 3a20 6f75 7470 7574 2069 6e74 6567  EC: output integ
│ │ │ │ +00015370: 6572 2077 6974 6820 636c 6965 6e74 206d  er with client m
│ │ │ │ +00015380: 6963 726f 7365 636f 6e64 7320 6669 656c  icroseconds fiel
│ │ │ │ +00015390: 642e 0a0a 2020 2020 202a 4465 7363 7269  d...     *Descri
│ │ │ │ +000153a0: 7074 696f 6e3a 2a20 4578 7472 6163 7420  ption:* Extract 
│ │ │ │ +000153b0: 636c 6965 6e74 206d 6963 726f 7365 636f  client microseco
│ │ │ │ +000153c0: 6e64 7320 6669 656c 6420 6672 6f6d 0a20  nds field from. 
│ │ │ │ +000153d0: 2020 2020 4175 7468 656e 7469 6361 746f      Authenticato
│ │ │ │ +000153e0: 722e 0a0a 2020 2020 202a 5265 7475 726e  r...     *Return
│ │ │ │ +000153f0: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ +00015400: 2053 4849 5348 495f 4f4b 2069 6666 2073   SHISHI_OK iff s
│ │ │ │ +00015410: 7563 6365 7373 6675 6c2e 0a0a 7368 6973  uccessful...shis
│ │ │ │ +00015420: 6869 5f61 7574 6865 6e74 6963 6174 6f72  hi_authenticator
│ │ │ │ +00015430: 5f63 7573 6563 5f73 6574 0a2d 2d2d 2d2d  _cusec_set.-----
│ │ │ │  00015440: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00015450: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -00015460: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ -00015470: 6869 5f61 7574 6865 6e74 6963 6174 6f72  hi_authenticator
│ │ │ │ -00015480: 5f63 7573 6563 5f73 6574 2028 5368 6973  _cusec_set (Shis
│ │ │ │ -00015490: 6869 202a 2048 414e 444c 452c 0a20 2020  hi * HANDLE,.   
│ │ │ │ -000154a0: 2020 2020 2020 2053 6869 7368 695f 6173         Shishi_as
│ │ │ │ -000154b0: 6e31 2041 5554 4845 4e54 4943 4154 4f52  n1 AUTHENTICATOR
│ │ │ │ -000154c0: 2c20 7569 6e74 3332 5f74 2043 5553 4543  , uint32_t CUSEC
│ │ │ │ -000154d0: 290a 2020 2020 2048 414e 444c 453a 2073  ).     HANDLE: s
│ │ │ │ -000154e0: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ -000154f0: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ -00015500: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ -00015510: 2e0a 2020 2020 2041 5554 4845 4e54 4943  ..     AUTHENTIC
│ │ │ │ -00015520: 4154 4f52 3a20 6175 7468 656e 7469 6361  ATOR: authentica
│ │ │ │ -00015530: 746f 7220 6173 2061 6c6c 6f63 6174 6564  tor as allocated
│ │ │ │ -00015540: 2062 790a 2020 2020 20e2 8098 7368 6973   by.     ...shis
│ │ │ │ -00015550: 6869 5f61 7574 6865 6e74 6963 6174 6f72  hi_authenticator
│ │ │ │ -00015560: 2829 e280 992e 0a20 2020 2020 4355 5345  ().....     CUSE
│ │ │ │ -00015570: 433a 2063 6c69 656e 7420 6d69 6372 6f73  C: client micros
│ │ │ │ -00015580: 6563 6f6e 6473 2074 6f20 7365 7420 696e  econds to set in
│ │ │ │ -00015590: 2061 7574 6865 6e74 6963 6174 6f72 2c20   authenticator, 
│ │ │ │ -000155a0: 302d 3939 3939 3939 2e0a 0a20 2020 2020  0-999999...     
│ │ │ │ -000155b0: 2a44 6573 6372 6970 7469 6f6e 3a2a 2053  *Description:* S
│ │ │ │ -000155c0: 6574 2074 6865 2063 7573 6563 2066 6965  et the cusec fie
│ │ │ │ -000155d0: 6c64 2069 6e20 7468 6520 4175 7468 656e  ld in the Authen
│ │ │ │ -000155e0: 7469 6361 746f 722e 0a0a 2020 2020 202a  ticator...     *
│ │ │ │ -000155f0: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ -00015600: 6574 7572 6e73 2053 4849 5348 495f 4f4b  eturns SHISHI_OK
│ │ │ │ -00015610: 2069 6666 2073 7563 6365 7373 6675 6c2e   iff successful.
│ │ │ │ -00015620: 0a0a 7368 6973 6869 5f61 7574 6865 6e74  ..shishi_authent
│ │ │ │ -00015630: 6963 6174 6f72 5f73 6571 6e75 6d62 6572  icator_seqnumber
│ │ │ │ -00015640: 5f67 6574 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  _get.-----------
│ │ │ │ +00015450: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +00015460: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ +00015470: 7368 695f 6175 7468 656e 7469 6361 746f  shi_authenticato
│ │ │ │ +00015480: 725f 6375 7365 635f 7365 7420 2853 6869  r_cusec_set (Shi
│ │ │ │ +00015490: 7368 6920 2a20 4841 4e44 4c45 2c0a 2020  shi * HANDLE,.  
│ │ │ │ +000154a0: 2020 2020 2020 2020 5368 6973 6869 5f61          Shishi_a
│ │ │ │ +000154b0: 736e 3120 4155 5448 454e 5449 4341 544f  sn1 AUTHENTICATO
│ │ │ │ +000154c0: 522c 2075 696e 7433 325f 7420 4355 5345  R, uint32_t CUSE
│ │ │ │ +000154d0: 4329 0a20 2020 2020 4841 4e44 4c45 3a20  C).     HANDLE: 
│ │ │ │ +000154e0: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ +000154f0: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ +00015500: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ +00015510: 992e 0a20 2020 2020 4155 5448 454e 5449  ...     AUTHENTI
│ │ │ │ +00015520: 4341 544f 523a 2061 7574 6865 6e74 6963  CATOR: authentic
│ │ │ │ +00015530: 6174 6f72 2061 7320 616c 6c6f 6361 7465  ator as allocate
│ │ │ │ +00015540: 6420 6279 0a20 2020 2020 e280 9873 6869  d by.     ...shi
│ │ │ │ +00015550: 7368 695f 6175 7468 656e 7469 6361 746f  shi_authenticato
│ │ │ │ +00015560: 7228 29e2 8099 2e0a 2020 2020 2043 5553  r().....     CUS
│ │ │ │ +00015570: 4543 3a20 636c 6965 6e74 206d 6963 726f  EC: client micro
│ │ │ │ +00015580: 7365 636f 6e64 7320 746f 2073 6574 2069  seconds to set i
│ │ │ │ +00015590: 6e20 6175 7468 656e 7469 6361 746f 722c  n authenticator,
│ │ │ │ +000155a0: 2030 2d39 3939 3939 392e 0a0a 2020 2020   0-999999...    
│ │ │ │ +000155b0: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ +000155c0: 5365 7420 7468 6520 6375 7365 6320 6669  Set the cusec fi
│ │ │ │ +000155d0: 656c 6420 696e 2074 6865 2041 7574 6865  eld in the Authe
│ │ │ │ +000155e0: 6e74 6963 6174 6f72 2e0a 0a20 2020 2020  nticator...     
│ │ │ │ +000155f0: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ +00015600: 5265 7475 726e 7320 5348 4953 4849 5f4f  Returns SHISHI_O
│ │ │ │ +00015610: 4b20 6966 6620 7375 6363 6573 7366 756c  K iff successful
│ │ │ │ +00015620: 2e0a 0a73 6869 7368 695f 6175 7468 656e  ...shishi_authen
│ │ │ │ +00015630: 7469 6361 746f 725f 7365 716e 756d 6265  ticator_seqnumbe
│ │ │ │ +00015640: 725f 6765 740a 2d2d 2d2d 2d2d 2d2d 2d2d  r_get.----------
│ │ │ │  00015650: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00015660: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ -00015670: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ -00015680: 695f 6175 7468 656e 7469 6361 746f 725f  i_authenticator_
│ │ │ │ -00015690: 7365 716e 756d 6265 725f 6765 7420 2853  seqnumber_get (S
│ │ │ │ -000156a0: 6869 7368 6920 2a20 4841 4e44 4c45 2c0a  hishi * HANDLE,.
│ │ │ │ -000156b0: 2020 2020 2020 2020 2020 5368 6973 6869            Shishi
│ │ │ │ -000156c0: 5f61 736e 3120 4155 5448 454e 5449 4341  _asn1 AUTHENTICA
│ │ │ │ -000156d0: 544f 522c 2075 696e 7433 325f 7420 2a20  TOR, uint32_t * 
│ │ │ │ -000156e0: 5345 514e 554d 4245 5229 0a20 2020 2020  SEQNUMBER).     
│ │ │ │ -000156f0: 4841 4e44 4c45 3a20 7368 6973 6869 2068  HANDLE: shishi h
│ │ │ │ -00015700: 616e 646c 6520 6173 2061 6c6c 6f63 6174  andle as allocat
│ │ │ │ -00015710: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ -00015720: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ -00015730: 4155 5448 454e 5449 4341 544f 523a 2061  AUTHENTICATOR: a
│ │ │ │ -00015740: 7574 6865 6e74 6963 6174 6f72 2061 7320  uthenticator as 
│ │ │ │ -00015750: 616c 6c6f 6361 7465 6420 6279 0a20 2020  allocated by.   
│ │ │ │ -00015760: 2020 e280 9873 6869 7368 695f 6175 7468    ...shishi_auth
│ │ │ │ -00015770: 656e 7469 6361 746f 7228 29e2 8099 2e0a  enticator().....
│ │ │ │ -00015780: 2020 2020 2053 4551 4e55 4d42 4552 3a20       SEQNUMBER: 
│ │ │ │ -00015790: 6f75 7470 7574 2069 6e74 6567 6572 2077  output integer w
│ │ │ │ -000157a0: 6974 6820 7365 7175 656e 6365 206e 756d  ith sequence num
│ │ │ │ -000157b0: 6265 7220 6669 656c 642e 0a0a 2020 2020  ber field...    
│ │ │ │ -000157c0: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ -000157d0: 4578 7472 6163 7420 7365 7175 656e 6365  Extract sequence
│ │ │ │ -000157e0: 206e 756d 6265 7220 6669 656c 6420 6672   number field fr
│ │ │ │ -000157f0: 6f6d 2041 7574 6865 6e74 6963 6174 6f72  om Authenticator
│ │ │ │ -00015800: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ -00015810: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ -00015820: e280 9853 4849 5348 495f 4f4b e280 9920  ...SHISHI_OK... 
│ │ │ │ -00015830: 6966 6620 7375 6363 6573 7366 756c 2e0a  iff successful..
│ │ │ │ -00015840: 0a73 6869 7368 695f 6175 7468 656e 7469  .shishi_authenti
│ │ │ │ -00015850: 6361 746f 725f 7365 716e 756d 6265 725f  cator_seqnumber_
│ │ │ │ -00015860: 7265 6d6f 7665 0a2d 2d2d 2d2d 2d2d 2d2d  remove.---------
│ │ │ │ +00015660: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ +00015670: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ +00015680: 6869 5f61 7574 6865 6e74 6963 6174 6f72  hi_authenticator
│ │ │ │ +00015690: 5f73 6571 6e75 6d62 6572 5f67 6574 2028  _seqnumber_get (
│ │ │ │ +000156a0: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ +000156b0: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ +000156c0: 695f 6173 6e31 2041 5554 4845 4e54 4943  i_asn1 AUTHENTIC
│ │ │ │ +000156d0: 4154 4f52 2c20 7569 6e74 3332 5f74 202a  ATOR, uint32_t *
│ │ │ │ +000156e0: 2053 4551 4e55 4d42 4552 290a 2020 2020   SEQNUMBER).    
│ │ │ │ +000156f0: 2048 414e 444c 453a 2073 6869 7368 6920   HANDLE: shishi 
│ │ │ │ +00015700: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ +00015710: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ +00015720: 5f69 6e69 7428 29e2 8099 2e0a 2020 2020  _init().....    
│ │ │ │ +00015730: 2041 5554 4845 4e54 4943 4154 4f52 3a20   AUTHENTICATOR: 
│ │ │ │ +00015740: 6175 7468 656e 7469 6361 746f 7220 6173  authenticator as
│ │ │ │ +00015750: 2061 6c6c 6f63 6174 6564 2062 790a 2020   allocated by.  
│ │ │ │ +00015760: 2020 20e2 8098 7368 6973 6869 5f61 7574     ...shishi_aut
│ │ │ │ +00015770: 6865 6e74 6963 6174 6f72 2829 e280 992e  henticator()....
│ │ │ │ +00015780: 0a20 2020 2020 5345 514e 554d 4245 523a  .     SEQNUMBER:
│ │ │ │ +00015790: 206f 7574 7075 7420 696e 7465 6765 7220   output integer 
│ │ │ │ +000157a0: 7769 7468 2073 6571 7565 6e63 6520 6e75  with sequence nu
│ │ │ │ +000157b0: 6d62 6572 2066 6965 6c64 2e0a 0a20 2020  mber field...   
│ │ │ │ +000157c0: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ +000157d0: 2045 7874 7261 6374 2073 6571 7565 6e63   Extract sequenc
│ │ │ │ +000157e0: 6520 6e75 6d62 6572 2066 6965 6c64 2066  e number field f
│ │ │ │ +000157f0: 726f 6d20 4175 7468 656e 7469 6361 746f  rom Authenticato
│ │ │ │ +00015800: 722e 0a0a 2020 2020 202a 5265 7475 726e  r...     *Return
│ │ │ │ +00015810: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ +00015820: 20e2 8098 5348 4953 4849 5f4f 4be2 8099   ...SHISHI_OK...
│ │ │ │ +00015830: 2069 6666 2073 7563 6365 7373 6675 6c2e   iff successful.
│ │ │ │ +00015840: 0a0a 7368 6973 6869 5f61 7574 6865 6e74  ..shishi_authent
│ │ │ │ +00015850: 6963 6174 6f72 5f73 6571 6e75 6d62 6572  icator_seqnumber
│ │ │ │ +00015860: 5f72 656d 6f76 650a 2d2d 2d2d 2d2d 2d2d  _remove.--------
│ │ │ │  00015870: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00015880: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ -00015890: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ -000158a0: 7368 6973 6869 5f61 7574 6865 6e74 6963  shishi_authentic
│ │ │ │ -000158b0: 6174 6f72 5f73 6571 6e75 6d62 6572 5f72  ator_seqnumber_r
│ │ │ │ -000158c0: 656d 6f76 650a 2020 2020 2020 2020 2020  emove.          
│ │ │ │ -000158d0: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ -000158e0: 2c20 5368 6973 6869 5f61 736e 3120 4155  , Shishi_asn1 AU
│ │ │ │ -000158f0: 5448 454e 5449 4341 544f 5229 0a20 2020  THENTICATOR).   
│ │ │ │ -00015900: 2020 4841 4e44 4c45 3a20 7368 6973 6869    HANDLE: shishi
│ │ │ │ -00015910: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ -00015920: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ -00015930: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ -00015940: 2020 4155 5448 454e 5449 4341 544f 523a    AUTHENTICATOR:
│ │ │ │ -00015950: 2061 7574 6865 6e74 6963 6174 6f72 2061   authenticator a
│ │ │ │ -00015960: 7320 616c 6c6f 6361 7465 6420 6279 0a20  s allocated by. 
│ │ │ │ -00015970: 2020 2020 e280 9873 6869 7368 695f 6175      ...shishi_au
│ │ │ │ -00015980: 7468 656e 7469 6361 746f 7228 29e2 8099  thenticator()...
│ │ │ │ -00015990: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ -000159a0: 7469 6f6e 3a2a 2052 656d 6f76 6520 7365  tion:* Remove se
│ │ │ │ -000159b0: 7175 656e 6365 206e 756d 6265 7220 6669  quence number fi
│ │ │ │ -000159c0: 656c 6420 696e 2041 7574 6865 6e74 6963  eld in Authentic
│ │ │ │ -000159d0: 6174 6f72 2e0a 0a20 2020 2020 2a52 6574  ator...     *Ret
│ │ │ │ -000159e0: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ -000159f0: 726e 7320 e280 9853 4849 5348 495f 4f4b  rns ...SHISHI_OK
│ │ │ │ -00015a00: e280 9920 6966 6620 7375 6363 6573 7366  ... iff successf
│ │ │ │ -00015a10: 756c 2e0a 0a73 6869 7368 695f 6175 7468  ul...shishi_auth
│ │ │ │ -00015a20: 656e 7469 6361 746f 725f 7365 716e 756d  enticator_seqnum
│ │ │ │ -00015a30: 6265 725f 7365 740a 2d2d 2d2d 2d2d 2d2d  ber_set.--------
│ │ │ │ +00015880: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ +00015890: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ +000158a0: 2073 6869 7368 695f 6175 7468 656e 7469   shishi_authenti
│ │ │ │ +000158b0: 6361 746f 725f 7365 716e 756d 6265 725f  cator_seqnumber_
│ │ │ │ +000158c0: 7265 6d6f 7665 0a20 2020 2020 2020 2020  remove.         
│ │ │ │ +000158d0: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ +000158e0: 452c 2053 6869 7368 695f 6173 6e31 2041  E, Shishi_asn1 A
│ │ │ │ +000158f0: 5554 4845 4e54 4943 4154 4f52 290a 2020  UTHENTICATOR).  
│ │ │ │ +00015900: 2020 2048 414e 444c 453a 2073 6869 7368     HANDLE: shish
│ │ │ │ +00015910: 6920 6861 6e64 6c65 2061 7320 616c 6c6f  i handle as allo
│ │ │ │ +00015920: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ +00015930: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ +00015940: 2020 2041 5554 4845 4e54 4943 4154 4f52     AUTHENTICATOR
│ │ │ │ +00015950: 3a20 6175 7468 656e 7469 6361 746f 7220  : authenticator 
│ │ │ │ +00015960: 6173 2061 6c6c 6f63 6174 6564 2062 790a  as allocated by.
│ │ │ │ +00015970: 2020 2020 20e2 8098 7368 6973 6869 5f61       ...shishi_a
│ │ │ │ +00015980: 7574 6865 6e74 6963 6174 6f72 2829 e280  uthenticator()..
│ │ │ │ +00015990: 992e 0a0a 2020 2020 202a 4465 7363 7269  ....     *Descri
│ │ │ │ +000159a0: 7074 696f 6e3a 2a20 5265 6d6f 7665 2073  ption:* Remove s
│ │ │ │ +000159b0: 6571 7565 6e63 6520 6e75 6d62 6572 2066  equence number f
│ │ │ │ +000159c0: 6965 6c64 2069 6e20 4175 7468 656e 7469  ield in Authenti
│ │ │ │ +000159d0: 6361 746f 722e 0a0a 2020 2020 202a 5265  cator...     *Re
│ │ │ │ +000159e0: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ +000159f0: 7572 6e73 20e2 8098 5348 4953 4849 5f4f  urns ...SHISHI_O
│ │ │ │ +00015a00: 4be2 8099 2069 6666 2073 7563 6365 7373  K... iff success
│ │ │ │ +00015a10: 6675 6c2e 0a0a 7368 6973 6869 5f61 7574  ful...shishi_aut
│ │ │ │ +00015a20: 6865 6e74 6963 6174 6f72 5f73 6571 6e75  henticator_seqnu
│ │ │ │ +00015a30: 6d62 6572 5f73 6574 0a2d 2d2d 2d2d 2d2d  mber_set.-------
│ │ │ │  00015a40: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00015a50: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ -00015a60: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ -00015a70: 6973 6869 5f61 7574 6865 6e74 6963 6174  ishi_authenticat
│ │ │ │ -00015a80: 6f72 5f73 6571 6e75 6d62 6572 5f73 6574  or_seqnumber_set
│ │ │ │ -00015a90: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ -00015aa0: 452c 0a20 2020 2020 2020 2020 2053 6869  E,.          Shi
│ │ │ │ -00015ab0: 7368 695f 6173 6e31 2041 5554 4845 4e54  shi_asn1 AUTHENT
│ │ │ │ -00015ac0: 4943 4154 4f52 2c20 7569 6e74 3332 5f74  ICATOR, uint32_t
│ │ │ │ -00015ad0: 2053 4551 4e55 4d42 4552 290a 2020 2020   SEQNUMBER).    
│ │ │ │ -00015ae0: 2048 414e 444c 453a 2073 6869 7368 6920   HANDLE: shishi 
│ │ │ │ -00015af0: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ -00015b00: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ -00015b10: 5f69 6e69 7428 29e2 8099 2e0a 2020 2020  _init().....    
│ │ │ │ -00015b20: 2041 5554 4845 4e54 4943 4154 4f52 3a20   AUTHENTICATOR: 
│ │ │ │ -00015b30: 6175 7468 656e 7469 6361 746f 7220 6173  authenticator as
│ │ │ │ -00015b40: 2061 6c6c 6f63 6174 6564 2062 790a 2020   allocated by.  
│ │ │ │ -00015b50: 2020 20e2 8098 7368 6973 6869 5f61 7574     ...shishi_aut
│ │ │ │ -00015b60: 6865 6e74 6963 6174 6f72 2829 e280 992e  henticator()....
│ │ │ │ -00015b70: 0a20 2020 2020 5345 514e 554d 4245 523a  .     SEQNUMBER:
│ │ │ │ -00015b80: 2069 6e74 6567 6572 2077 6974 6820 7365   integer with se
│ │ │ │ -00015b90: 7175 656e 6365 206e 756d 6265 7220 6669  quence number fi
│ │ │ │ -00015ba0: 656c 6420 746f 2073 746f 7265 2069 6e0a  eld to store in.
│ │ │ │ -00015bb0: 2020 2020 2041 7574 6865 6e74 6963 6174       Authenticat
│ │ │ │ -00015bc0: 6f72 2e0a 0a20 2020 2020 2a44 6573 6372  or...     *Descr
│ │ │ │ -00015bd0: 6970 7469 6f6e 3a2a 2053 746f 7265 2073  iption:* Store s
│ │ │ │ -00015be0: 6571 7565 6e63 6520 6e75 6d62 6572 2066  equence number f
│ │ │ │ -00015bf0: 6965 6c64 2069 6e20 4175 7468 656e 7469  ield in Authenti
│ │ │ │ -00015c00: 6361 746f 722e 0a0a 2020 2020 202a 5265  cator...     *Re
│ │ │ │ -00015c10: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ -00015c20: 7572 6e73 20e2 8098 5348 4953 4849 5f4f  urns ...SHISHI_O
│ │ │ │ -00015c30: 4be2 8099 2069 6666 2073 7563 6365 7373  K... iff success
│ │ │ │ -00015c40: 6675 6c2e 0a0a 7368 6973 6869 5f61 7574  ful...shishi_aut
│ │ │ │ -00015c50: 6865 6e74 6963 6174 6f72 5f63 6c69 656e  henticator_clien
│ │ │ │ -00015c60: 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  t.--------------
│ │ │ │ -00015c70: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -00015c80: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ -00015c90: 2073 6869 7368 695f 6175 7468 656e 7469   shishi_authenti
│ │ │ │ -00015ca0: 6361 746f 725f 636c 6965 6e74 2028 5368  cator_client (Sh
│ │ │ │ -00015cb0: 6973 6869 202a 2048 414e 444c 452c 0a20  ishi * HANDLE,. 
│ │ │ │ -00015cc0: 2020 2020 2020 2020 2053 6869 7368 695f           Shishi_
│ │ │ │ -00015cd0: 6173 6e31 2041 5554 4845 4e54 4943 4154  asn1 AUTHENTICAT
│ │ │ │ -00015ce0: 4f52 2c20 6368 6172 202a 2a20 434c 4945  OR, char ** CLIE
│ │ │ │ -00015cf0: 4e54 2c20 7369 7a65 5f74 202a 2043 4c49  NT, size_t * CLI
│ │ │ │ -00015d00: 454e 544c 454e 290a 2020 2020 2048 414e  ENTLEN).     HAN
│ │ │ │ -00015d10: 444c 453a 2053 6869 7368 6920 6c69 6272  DLE: Shishi libr
│ │ │ │ -00015d20: 6172 7920 6861 6e64 6c65 2063 7265 6174  ary handle creat
│ │ │ │ -00015d30: 6520 6279 20e2 8098 7368 6973 6869 5f69  e by ...shishi_i
│ │ │ │ -00015d40: 6e69 7428 29e2 8099 2e0a 2020 2020 2041  nit().....     A
│ │ │ │ -00015d50: 5554 4845 4e54 4943 4154 4f52 3a20 4175  UTHENTICATOR: Au
│ │ │ │ -00015d60: 7468 656e 7469 6361 746f 7220 7661 7269  thenticator vari
│ │ │ │ -00015d70: 6162 6c65 2074 6f20 6765 7420 636c 6965  able to get clie
│ │ │ │ -00015d80: 6e74 206e 616d 6520 6672 6f6d 2e0a 2020  nt name from..  
│ │ │ │ -00015d90: 2020 2043 4c49 454e 543a 2070 6f69 6e74     CLIENT: point
│ │ │ │ -00015da0: 6572 2074 6f20 6e65 776c 7920 616c 6c6f  er to newly allo
│ │ │ │ -00015db0: 6361 7465 6420 7a65 726f 2074 6572 6d69  cated zero termi
│ │ │ │ -00015dc0: 6e61 7465 6420 7374 7269 6e67 0a20 2020  nated string.   
│ │ │ │ -00015dd0: 2020 636f 6e74 6169 6e69 6e67 2070 7269    containing pri
│ │ │ │ -00015de0: 6e63 6970 616c 206e 616d 652e 2020 4d61  ncipal name.  Ma
│ │ │ │ -00015df0: 7920 6265 20e2 8098 4e55 4c4c e280 9920  y be ...NULL... 
│ │ │ │ -00015e00: 2874 6f20 6f6e 6c79 2070 6f70 756c 6174  (to only populat
│ │ │ │ -00015e10: 650a 2020 2020 2043 4c49 454e 544c 454e  e.     CLIENTLEN
│ │ │ │ -00015e20: 292e 0a20 2020 2020 434c 4945 4e54 4c45  )..     CLIENTLE
│ │ │ │ -00015e30: 4e3a 2070 6f69 6e74 6572 2074 6f20 6c65  N: pointer to le
│ │ │ │ -00015e40: 6e67 7468 206f 6620 434c 4945 4e54 206f  ngth of CLIENT o
│ │ │ │ -00015e50: 6e20 6f75 7470 7574 2c20 6578 636c 7564  n output, exclud
│ │ │ │ -00015e60: 696e 670a 2020 2020 2074 6572 6d69 6e61  ing.     termina
│ │ │ │ -00015e70: 7469 6e67 207a 6572 6f2e 2020 4d61 7920  ting zero.  May 
│ │ │ │ -00015e80: 6265 20e2 8098 4e55 4c4c e280 9920 2874  be ...NULL... (t
│ │ │ │ -00015e90: 6f20 6f6e 6c79 2070 6f70 756c 6174 6520  o only populate 
│ │ │ │ -00015ea0: 434c 4945 4e54 292e 0a0a 2020 2020 202a  CLIENT)...     *
│ │ │ │ -00015eb0: 4465 7363 7269 7074 696f 6e3a 2a20 5265  Description:* Re
│ │ │ │ -00015ec0: 7072 6573 656e 7420 636c 6965 6e74 2070  present client p
│ │ │ │ -00015ed0: 7269 6e63 6970 616c 206e 616d 6520 696e  rincipal name in
│ │ │ │ -00015ee0: 2041 7574 6865 6e74 6963 6174 6f72 2061   Authenticator a
│ │ │ │ -00015ef0: 730a 2020 2020 207a 6572 6f2d 7465 726d  s.     zero-term
│ │ │ │ -00015f00: 696e 6174 6564 2073 7472 696e 672e 2020  inated string.  
│ │ │ │ -00015f10: 5468 6520 7374 7269 6e67 2069 7320 616c  The string is al
│ │ │ │ -00015f20: 6c6f 6361 7465 2062 7920 7468 6973 2066  locate by this f
│ │ │ │ -00015f30: 756e 6374 696f 6e2c 0a20 2020 2020 616e  unction,.     an
│ │ │ │ -00015f40: 6420 6974 2069 7320 7468 6520 7265 7370  d it is the resp
│ │ │ │ -00015f50: 6f6e 7369 6269 6c69 7479 206f 6620 7468  onsibility of th
│ │ │ │ -00015f60: 6520 6361 6c6c 6572 2074 6f20 6465 616c  e caller to deal
│ │ │ │ -00015f70: 6c6f 6361 7465 2069 742e 2020 4e6f 7465  locate it.  Note
│ │ │ │ -00015f80: 0a20 2020 2020 7468 6174 2074 6865 206f  .     that the o
│ │ │ │ -00015f90: 7574 7075 7420 6c65 6e67 7468 2043 4c49  utput length CLI
│ │ │ │ -00015fa0: 454e 544c 454e 2064 6f65 7320 6e6f 7420  ENTLEN does not 
│ │ │ │ -00015fb0: 696e 636c 7564 6520 7468 6520 7465 726d  include the term
│ │ │ │ -00015fc0: 696e 6174 696e 670a 2020 2020 207a 6572  inating.     zer
│ │ │ │ -00015fd0: 6f2e 0a0a 2020 2020 202a 5265 7475 726e  o...     *Return
│ │ │ │ -00015fe0: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ -00015ff0: 2053 4849 5348 495f 4f4b 2069 6666 2073   SHISHI_OK iff s
│ │ │ │ -00016000: 7563 6365 7373 6675 6c2e 0a0a 7368 6973  uccessful...shis
│ │ │ │ -00016010: 6869 5f61 7574 6865 6e74 6963 6174 6f72  hi_authenticator
│ │ │ │ -00016020: 5f63 6c69 656e 7472 6561 6c6d 0a2d 2d2d  _clientrealm.---
│ │ │ │ +00015a50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ +00015a60: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ +00015a70: 6869 7368 695f 6175 7468 656e 7469 6361  hishi_authentica
│ │ │ │ +00015a80: 746f 725f 7365 716e 756d 6265 725f 7365  tor_seqnumber_se
│ │ │ │ +00015a90: 7420 2853 6869 7368 6920 2a20 4841 4e44  t (Shishi * HAND
│ │ │ │ +00015aa0: 4c45 2c0a 2020 2020 2020 2020 2020 5368  LE,.          Sh
│ │ │ │ +00015ab0: 6973 6869 5f61 736e 3120 4155 5448 454e  ishi_asn1 AUTHEN
│ │ │ │ +00015ac0: 5449 4341 544f 522c 2075 696e 7433 325f  TICATOR, uint32_
│ │ │ │ +00015ad0: 7420 5345 514e 554d 4245 5229 0a20 2020  t SEQNUMBER).   
│ │ │ │ +00015ae0: 2020 4841 4e44 4c45 3a20 7368 6973 6869    HANDLE: shishi
│ │ │ │ +00015af0: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ +00015b00: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ +00015b10: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ +00015b20: 2020 4155 5448 454e 5449 4341 544f 523a    AUTHENTICATOR:
│ │ │ │ +00015b30: 2061 7574 6865 6e74 6963 6174 6f72 2061   authenticator a
│ │ │ │ +00015b40: 7320 616c 6c6f 6361 7465 6420 6279 0a20  s allocated by. 
│ │ │ │ +00015b50: 2020 2020 e280 9873 6869 7368 695f 6175      ...shishi_au
│ │ │ │ +00015b60: 7468 656e 7469 6361 746f 7228 29e2 8099  thenticator()...
│ │ │ │ +00015b70: 2e0a 2020 2020 2053 4551 4e55 4d42 4552  ..     SEQNUMBER
│ │ │ │ +00015b80: 3a20 696e 7465 6765 7220 7769 7468 2073  : integer with s
│ │ │ │ +00015b90: 6571 7565 6e63 6520 6e75 6d62 6572 2066  equence number f
│ │ │ │ +00015ba0: 6965 6c64 2074 6f20 7374 6f72 6520 696e  ield to store in
│ │ │ │ +00015bb0: 0a20 2020 2020 4175 7468 656e 7469 6361  .     Authentica
│ │ │ │ +00015bc0: 746f 722e 0a0a 2020 2020 202a 4465 7363  tor...     *Desc
│ │ │ │ +00015bd0: 7269 7074 696f 6e3a 2a20 5374 6f72 6520  ription:* Store 
│ │ │ │ +00015be0: 7365 7175 656e 6365 206e 756d 6265 7220  sequence number 
│ │ │ │ +00015bf0: 6669 656c 6420 696e 2041 7574 6865 6e74  field in Authent
│ │ │ │ +00015c00: 6963 6174 6f72 2e0a 0a20 2020 2020 2a52  icator...     *R
│ │ │ │ +00015c10: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +00015c20: 7475 726e 7320 e280 9853 4849 5348 495f  turns ...SHISHI_
│ │ │ │ +00015c30: 4f4b e280 9920 6966 6620 7375 6363 6573  OK... iff succes
│ │ │ │ +00015c40: 7366 756c 2e0a 0a73 6869 7368 695f 6175  sful...shishi_au
│ │ │ │ +00015c50: 7468 656e 7469 6361 746f 725f 636c 6965  thenticator_clie
│ │ │ │ +00015c60: 6e74 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  nt.-------------
│ │ │ │ +00015c70: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ +00015c80: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ +00015c90: 7420 7368 6973 6869 5f61 7574 6865 6e74  t shishi_authent
│ │ │ │ +00015ca0: 6963 6174 6f72 5f63 6c69 656e 7420 2853  icator_client (S
│ │ │ │ +00015cb0: 6869 7368 6920 2a20 4841 4e44 4c45 2c0a  hishi * HANDLE,.
│ │ │ │ +00015cc0: 2020 2020 2020 2020 2020 5368 6973 6869            Shishi
│ │ │ │ +00015cd0: 5f61 736e 3120 4155 5448 454e 5449 4341  _asn1 AUTHENTICA
│ │ │ │ +00015ce0: 544f 522c 2063 6861 7220 2a2a 2043 4c49  TOR, char ** CLI
│ │ │ │ +00015cf0: 454e 542c 2073 697a 655f 7420 2a20 434c  ENT, size_t * CL
│ │ │ │ +00015d00: 4945 4e54 4c45 4e29 0a20 2020 2020 4841  IENTLEN).     HA
│ │ │ │ +00015d10: 4e44 4c45 3a20 5368 6973 6869 206c 6962  NDLE: Shishi lib
│ │ │ │ +00015d20: 7261 7279 2068 616e 646c 6520 6372 6561  rary handle crea
│ │ │ │ +00015d30: 7465 2062 7920 e280 9873 6869 7368 695f  te by ...shishi_
│ │ │ │ +00015d40: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ +00015d50: 4155 5448 454e 5449 4341 544f 523a 2041  AUTHENTICATOR: A
│ │ │ │ +00015d60: 7574 6865 6e74 6963 6174 6f72 2076 6172  uthenticator var
│ │ │ │ +00015d70: 6961 626c 6520 746f 2067 6574 2063 6c69  iable to get cli
│ │ │ │ +00015d80: 656e 7420 6e61 6d65 2066 726f 6d2e 0a20  ent name from.. 
│ │ │ │ +00015d90: 2020 2020 434c 4945 4e54 3a20 706f 696e      CLIENT: poin
│ │ │ │ +00015da0: 7465 7220 746f 206e 6577 6c79 2061 6c6c  ter to newly all
│ │ │ │ +00015db0: 6f63 6174 6564 207a 6572 6f20 7465 726d  ocated zero term
│ │ │ │ +00015dc0: 696e 6174 6564 2073 7472 696e 670a 2020  inated string.  
│ │ │ │ +00015dd0: 2020 2063 6f6e 7461 696e 696e 6720 7072     containing pr
│ │ │ │ +00015de0: 696e 6369 7061 6c20 6e61 6d65 2e20 204d  incipal name.  M
│ │ │ │ +00015df0: 6179 2062 6520 e280 984e 554c 4ce2 8099  ay be ...NULL...
│ │ │ │ +00015e00: 2028 746f 206f 6e6c 7920 706f 7075 6c61   (to only popula
│ │ │ │ +00015e10: 7465 0a20 2020 2020 434c 4945 4e54 4c45  te.     CLIENTLE
│ │ │ │ +00015e20: 4e29 2e0a 2020 2020 2043 4c49 454e 544c  N)..     CLIENTL
│ │ │ │ +00015e30: 454e 3a20 706f 696e 7465 7220 746f 206c  EN: pointer to l
│ │ │ │ +00015e40: 656e 6774 6820 6f66 2043 4c49 454e 5420  ength of CLIENT 
│ │ │ │ +00015e50: 6f6e 206f 7574 7075 742c 2065 7863 6c75  on output, exclu
│ │ │ │ +00015e60: 6469 6e67 0a20 2020 2020 7465 726d 696e  ding.     termin
│ │ │ │ +00015e70: 6174 696e 6720 7a65 726f 2e20 204d 6179  ating zero.  May
│ │ │ │ +00015e80: 2062 6520 e280 984e 554c 4ce2 8099 2028   be ...NULL... (
│ │ │ │ +00015e90: 746f 206f 6e6c 7920 706f 7075 6c61 7465  to only populate
│ │ │ │ +00015ea0: 2043 4c49 454e 5429 2e0a 0a20 2020 2020   CLIENT)...     
│ │ │ │ +00015eb0: 2a44 6573 6372 6970 7469 6f6e 3a2a 2052  *Description:* R
│ │ │ │ +00015ec0: 6570 7265 7365 6e74 2063 6c69 656e 7420  epresent client 
│ │ │ │ +00015ed0: 7072 696e 6369 7061 6c20 6e61 6d65 2069  principal name i
│ │ │ │ +00015ee0: 6e20 4175 7468 656e 7469 6361 746f 7220  n Authenticator 
│ │ │ │ +00015ef0: 6173 0a20 2020 2020 7a65 726f 2d74 6572  as.     zero-ter
│ │ │ │ +00015f00: 6d69 6e61 7465 6420 7374 7269 6e67 2e20  minated string. 
│ │ │ │ +00015f10: 2054 6865 2073 7472 696e 6720 6973 2061   The string is a
│ │ │ │ +00015f20: 6c6c 6f63 6174 6520 6279 2074 6869 7320  llocate by this 
│ │ │ │ +00015f30: 6675 6e63 7469 6f6e 2c0a 2020 2020 2061  function,.     a
│ │ │ │ +00015f40: 6e64 2069 7420 6973 2074 6865 2072 6573  nd it is the res
│ │ │ │ +00015f50: 706f 6e73 6962 696c 6974 7920 6f66 2074  ponsibility of t
│ │ │ │ +00015f60: 6865 2063 616c 6c65 7220 746f 2064 6561  he caller to dea
│ │ │ │ +00015f70: 6c6c 6f63 6174 6520 6974 2e20 204e 6f74  llocate it.  Not
│ │ │ │ +00015f80: 650a 2020 2020 2074 6861 7420 7468 6520  e.     that the 
│ │ │ │ +00015f90: 6f75 7470 7574 206c 656e 6774 6820 434c  output length CL
│ │ │ │ +00015fa0: 4945 4e54 4c45 4e20 646f 6573 206e 6f74  IENTLEN does not
│ │ │ │ +00015fb0: 2069 6e63 6c75 6465 2074 6865 2074 6572   include the ter
│ │ │ │ +00015fc0: 6d69 6e61 7469 6e67 0a20 2020 2020 7a65  minating.     ze
│ │ │ │ +00015fd0: 726f 2e0a 0a20 2020 2020 2a52 6574 7572  ro...     *Retur
│ │ │ │ +00015fe0: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ +00015ff0: 7320 5348 4953 4849 5f4f 4b20 6966 6620  s SHISHI_OK iff 
│ │ │ │ +00016000: 7375 6363 6573 7366 756c 2e0a 0a73 6869  successful...shi
│ │ │ │ +00016010: 7368 695f 6175 7468 656e 7469 6361 746f  shi_authenticato
│ │ │ │ +00016020: 725f 636c 6965 6e74 7265 616c 6d0a 2d2d  r_clientrealm.--
│ │ │ │  00016030: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00016040: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -00016050: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ -00016060: 2073 6869 7368 695f 6175 7468 656e 7469   shishi_authenti
│ │ │ │ -00016070: 6361 746f 725f 636c 6965 6e74 7265 616c  cator_clientreal
│ │ │ │ -00016080: 6d20 2853 6869 7368 6920 2a20 4841 4e44  m (Shishi * HAND
│ │ │ │ -00016090: 4c45 2c0a 2020 2020 2020 2020 2020 5368  LE,.          Sh
│ │ │ │ -000160a0: 6973 6869 5f61 736e 3120 4155 5448 454e  ishi_asn1 AUTHEN
│ │ │ │ -000160b0: 5449 4341 544f 522c 2063 6861 7220 2a2a  TICATOR, char **
│ │ │ │ -000160c0: 2043 4c49 454e 542c 2073 697a 655f 7420   CLIENT, size_t 
│ │ │ │ -000160d0: 2a20 434c 4945 4e54 4c45 4e29 0a20 2020  * CLIENTLEN).   
│ │ │ │ -000160e0: 2020 4841 4e44 4c45 3a20 5368 6973 6869    HANDLE: Shishi
│ │ │ │ -000160f0: 206c 6962 7261 7279 2068 616e 646c 6520   library handle 
│ │ │ │ -00016100: 6372 6561 7465 2062 7920 e280 9873 6869  create by ...shi
│ │ │ │ -00016110: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ -00016120: 2020 2020 4155 5448 454e 5449 4341 544f      AUTHENTICATO
│ │ │ │ -00016130: 523a 2041 7574 6865 6e74 6963 6174 6f72  R: Authenticator
│ │ │ │ -00016140: 2076 6172 6961 626c 6520 746f 2067 6574   variable to get
│ │ │ │ -00016150: 2063 6c69 656e 7420 6e61 6d65 2061 6e64   client name and
│ │ │ │ -00016160: 2072 6561 6c6d 0a20 2020 2020 6672 6f6d   realm.     from
│ │ │ │ -00016170: 2e0a 2020 2020 2043 4c49 454e 543a 2070  ..     CLIENT: p
│ │ │ │ -00016180: 6f69 6e74 6572 2074 6f20 6e65 776c 7920  ointer to newly 
│ │ │ │ -00016190: 616c 6c6f 6361 7465 6420 7a65 726f 2074  allocated zero t
│ │ │ │ -000161a0: 6572 6d69 6e61 7465 6420 7374 7269 6e67  erminated string
│ │ │ │ -000161b0: 0a20 2020 2020 636f 6e74 6169 6e69 6e67  .     containing
│ │ │ │ -000161c0: 2070 7269 6e63 6970 616c 206e 616d 6520   principal name 
│ │ │ │ -000161d0: 616e 6420 7265 616c 6d2e 2020 4d61 7920  and realm.  May 
│ │ │ │ -000161e0: 6265 20e2 8098 4e55 4c4c e280 9920 2874  be ...NULL... (t
│ │ │ │ -000161f0: 6f20 6f6e 6c79 0a20 2020 2020 706f 7075  o only.     popu
│ │ │ │ -00016200: 6c61 7465 2043 4c49 454e 544c 454e 292e  late CLIENTLEN).
│ │ │ │ -00016210: 0a20 2020 2020 434c 4945 4e54 4c45 4e3a  .     CLIENTLEN:
│ │ │ │ -00016220: 2070 6f69 6e74 6572 2074 6f20 6c65 6e67   pointer to leng
│ │ │ │ -00016230: 7468 206f 6620 434c 4945 4e54 206f 6e20  th of CLIENT on 
│ │ │ │ -00016240: 6f75 7470 7574 2c20 6578 636c 7564 696e  output, excludin
│ │ │ │ -00016250: 670a 2020 2020 2074 6572 6d69 6e61 7469  g.     terminati
│ │ │ │ -00016260: 6e67 207a 6572 6f2e 2020 4d61 7920 6265  ng zero.  May be
│ │ │ │ -00016270: 20e2 8098 4e55 4c4c e280 9920 2874 6f20   ...NULL... (to 
│ │ │ │ -00016280: 6f6e 6c79 2070 6f70 756c 6174 6520 434c  only populate CL
│ │ │ │ -00016290: 4945 4e54 292e 0a0a 2020 2020 202a 4465  IENT)...     *De
│ │ │ │ -000162a0: 7363 7269 7074 696f 6e3a 2a20 436f 6e76  scription:* Conv
│ │ │ │ -000162b0: 6572 7420 636e 616d 6520 616e 6420 7265  ert cname and re
│ │ │ │ -000162c0: 616c 6d20 6669 656c 6473 2066 726f 6d20  alm fields from 
│ │ │ │ -000162d0: 4175 7468 656e 7469 6361 746f 7220 746f  Authenticator to
│ │ │ │ -000162e0: 0a20 2020 2020 7072 696e 7461 626c 6520  .     printable 
│ │ │ │ -000162f0: 7072 696e 6369 7061 6c20 6e61 6d65 2066  principal name f
│ │ │ │ -00016300: 6f72 6d61 742e 2020 5468 6520 7374 7269  ormat.  The stri
│ │ │ │ -00016310: 6e67 2069 7320 616c 6c6f 6361 7465 2062  ng is allocate b
│ │ │ │ -00016320: 7920 7468 6973 0a20 2020 2020 6675 6e63  y this.     func
│ │ │ │ -00016330: 7469 6f6e 2c20 616e 6420 6974 2069 7320  tion, and it is 
│ │ │ │ -00016340: 7468 6520 7265 7370 6f6e 7369 6269 6c69  the responsibili
│ │ │ │ -00016350: 7479 206f 6620 7468 6520 6361 6c6c 6572  ty of the caller
│ │ │ │ -00016360: 2074 6f20 6465 616c 6c6f 6361 7465 0a20   to deallocate. 
│ │ │ │ -00016370: 2020 2020 6974 2e20 204e 6f74 6520 7468      it.  Note th
│ │ │ │ -00016380: 6174 2074 6865 206f 7574 7075 7420 6c65  at the output le
│ │ │ │ -00016390: 6e67 7468 2043 4c49 454e 544c 454e 2064  ngth CLIENTLEN d
│ │ │ │ -000163a0: 6f65 7320 6e6f 7420 696e 636c 7564 6520  oes not include 
│ │ │ │ -000163b0: 7468 650a 2020 2020 2074 6572 6d69 6e61  the.     termina
│ │ │ │ -000163c0: 7469 6e67 207a 6572 6f2e 0a0a 2020 2020  ting zero...    
│ │ │ │ -000163d0: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ -000163e0: 2052 6574 7572 6e73 2053 4849 5348 495f   Returns SHISHI_
│ │ │ │ -000163f0: 4f4b 2069 6666 2073 7563 6365 7373 6675  OK iff successfu
│ │ │ │ -00016400: 6c2e 0a0a 7368 6973 6869 5f61 7574 6865  l...shishi_authe
│ │ │ │ -00016410: 6e74 6963 6174 6f72 5f63 6b73 756d 0a2d  nticator_cksum.-
│ │ │ │ +00016040: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ +00016050: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ +00016060: 7420 7368 6973 6869 5f61 7574 6865 6e74  t shishi_authent
│ │ │ │ +00016070: 6963 6174 6f72 5f63 6c69 656e 7472 6561  icator_clientrea
│ │ │ │ +00016080: 6c6d 2028 5368 6973 6869 202a 2048 414e  lm (Shishi * HAN
│ │ │ │ +00016090: 444c 452c 0a20 2020 2020 2020 2020 2053  DLE,.          S
│ │ │ │ +000160a0: 6869 7368 695f 6173 6e31 2041 5554 4845  hishi_asn1 AUTHE
│ │ │ │ +000160b0: 4e54 4943 4154 4f52 2c20 6368 6172 202a  NTICATOR, char *
│ │ │ │ +000160c0: 2a20 434c 4945 4e54 2c20 7369 7a65 5f74  * CLIENT, size_t
│ │ │ │ +000160d0: 202a 2043 4c49 454e 544c 454e 290a 2020   * CLIENTLEN).  
│ │ │ │ +000160e0: 2020 2048 414e 444c 453a 2053 6869 7368     HANDLE: Shish
│ │ │ │ +000160f0: 6920 6c69 6272 6172 7920 6861 6e64 6c65  i library handle
│ │ │ │ +00016100: 2063 7265 6174 6520 6279 20e2 8098 7368   create by ...sh
│ │ │ │ +00016110: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ +00016120: 2020 2020 2041 5554 4845 4e54 4943 4154       AUTHENTICAT
│ │ │ │ +00016130: 4f52 3a20 4175 7468 656e 7469 6361 746f  OR: Authenticato
│ │ │ │ +00016140: 7220 7661 7269 6162 6c65 2074 6f20 6765  r variable to ge
│ │ │ │ +00016150: 7420 636c 6965 6e74 206e 616d 6520 616e  t client name an
│ │ │ │ +00016160: 6420 7265 616c 6d0a 2020 2020 2066 726f  d realm.     fro
│ │ │ │ +00016170: 6d2e 0a20 2020 2020 434c 4945 4e54 3a20  m..     CLIENT: 
│ │ │ │ +00016180: 706f 696e 7465 7220 746f 206e 6577 6c79  pointer to newly
│ │ │ │ +00016190: 2061 6c6c 6f63 6174 6564 207a 6572 6f20   allocated zero 
│ │ │ │ +000161a0: 7465 726d 696e 6174 6564 2073 7472 696e  terminated strin
│ │ │ │ +000161b0: 670a 2020 2020 2063 6f6e 7461 696e 696e  g.     containin
│ │ │ │ +000161c0: 6720 7072 696e 6369 7061 6c20 6e61 6d65  g principal name
│ │ │ │ +000161d0: 2061 6e64 2072 6561 6c6d 2e20 204d 6179   and realm.  May
│ │ │ │ +000161e0: 2062 6520 e280 984e 554c 4ce2 8099 2028   be ...NULL... (
│ │ │ │ +000161f0: 746f 206f 6e6c 790a 2020 2020 2070 6f70  to only.     pop
│ │ │ │ +00016200: 756c 6174 6520 434c 4945 4e54 4c45 4e29  ulate CLIENTLEN)
│ │ │ │ +00016210: 2e0a 2020 2020 2043 4c49 454e 544c 454e  ..     CLIENTLEN
│ │ │ │ +00016220: 3a20 706f 696e 7465 7220 746f 206c 656e  : pointer to len
│ │ │ │ +00016230: 6774 6820 6f66 2043 4c49 454e 5420 6f6e  gth of CLIENT on
│ │ │ │ +00016240: 206f 7574 7075 742c 2065 7863 6c75 6469   output, excludi
│ │ │ │ +00016250: 6e67 0a20 2020 2020 7465 726d 696e 6174  ng.     terminat
│ │ │ │ +00016260: 696e 6720 7a65 726f 2e20 204d 6179 2062  ing zero.  May b
│ │ │ │ +00016270: 6520 e280 984e 554c 4ce2 8099 2028 746f  e ...NULL... (to
│ │ │ │ +00016280: 206f 6e6c 7920 706f 7075 6c61 7465 2043   only populate C
│ │ │ │ +00016290: 4c49 454e 5429 2e0a 0a20 2020 2020 2a44  LIENT)...     *D
│ │ │ │ +000162a0: 6573 6372 6970 7469 6f6e 3a2a 2043 6f6e  escription:* Con
│ │ │ │ +000162b0: 7665 7274 2063 6e61 6d65 2061 6e64 2072  vert cname and r
│ │ │ │ +000162c0: 6561 6c6d 2066 6965 6c64 7320 6672 6f6d  ealm fields from
│ │ │ │ +000162d0: 2041 7574 6865 6e74 6963 6174 6f72 2074   Authenticator t
│ │ │ │ +000162e0: 6f0a 2020 2020 2070 7269 6e74 6162 6c65  o.     printable
│ │ │ │ +000162f0: 2070 7269 6e63 6970 616c 206e 616d 6520   principal name 
│ │ │ │ +00016300: 666f 726d 6174 2e20 2054 6865 2073 7472  format.  The str
│ │ │ │ +00016310: 696e 6720 6973 2061 6c6c 6f63 6174 6520  ing is allocate 
│ │ │ │ +00016320: 6279 2074 6869 730a 2020 2020 2066 756e  by this.     fun
│ │ │ │ +00016330: 6374 696f 6e2c 2061 6e64 2069 7420 6973  ction, and it is
│ │ │ │ +00016340: 2074 6865 2072 6573 706f 6e73 6962 696c   the responsibil
│ │ │ │ +00016350: 6974 7920 6f66 2074 6865 2063 616c 6c65  ity of the calle
│ │ │ │ +00016360: 7220 746f 2064 6561 6c6c 6f63 6174 650a  r to deallocate.
│ │ │ │ +00016370: 2020 2020 2069 742e 2020 4e6f 7465 2074       it.  Note t
│ │ │ │ +00016380: 6861 7420 7468 6520 6f75 7470 7574 206c  hat the output l
│ │ │ │ +00016390: 656e 6774 6820 434c 4945 4e54 4c45 4e20  ength CLIENTLEN 
│ │ │ │ +000163a0: 646f 6573 206e 6f74 2069 6e63 6c75 6465  does not include
│ │ │ │ +000163b0: 2074 6865 0a20 2020 2020 7465 726d 696e   the.     termin
│ │ │ │ +000163c0: 6174 696e 6720 7a65 726f 2e0a 0a20 2020  ating zero...   
│ │ │ │ +000163d0: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ +000163e0: 2a20 5265 7475 726e 7320 5348 4953 4849  * Returns SHISHI
│ │ │ │ +000163f0: 5f4f 4b20 6966 6620 7375 6363 6573 7366  _OK iff successf
│ │ │ │ +00016400: 756c 2e0a 0a73 6869 7368 695f 6175 7468  ul...shishi_auth
│ │ │ │ +00016410: 656e 7469 6361 746f 725f 636b 7375 6d0a  enticator_cksum.
│ │ │ │  00016420: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00016430: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ -00016440: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ -00016450: 7368 695f 6175 7468 656e 7469 6361 746f  shi_authenticato
│ │ │ │ -00016460: 725f 636b 7375 6d20 2853 6869 7368 6920  r_cksum (Shishi 
│ │ │ │ -00016470: 2a20 4841 4e44 4c45 2c0a 2020 2020 2020  * HANDLE,.      
│ │ │ │ -00016480: 2020 2020 5368 6973 6869 5f61 736e 3120      Shishi_asn1 
│ │ │ │ -00016490: 4155 5448 454e 5449 4341 544f 522c 2069  AUTHENTICATOR, i
│ │ │ │ -000164a0: 6e74 3332 5f74 202a 2043 4b53 554d 5459  nt32_t * CKSUMTY
│ │ │ │ -000164b0: 5045 2c20 6368 6172 202a 2a20 434b 5355  PE, char ** CKSU
│ │ │ │ -000164c0: 4d2c 0a20 2020 2020 2020 2020 2073 697a  M,.          siz
│ │ │ │ -000164d0: 655f 7420 2a20 434b 5355 4d4c 454e 290a  e_t * CKSUMLEN).
│ │ │ │ -000164e0: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ -000164f0: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ -00016500: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ -00016510: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ -00016520: 2020 2020 2041 5554 4845 4e54 4943 4154       AUTHENTICAT
│ │ │ │ -00016530: 4f52 3a20 6175 7468 656e 7469 6361 746f  OR: authenticato
│ │ │ │ -00016540: 7220 6173 2061 6c6c 6f63 6174 6564 2062  r as allocated b
│ │ │ │ -00016550: 790a 2020 2020 20e2 8098 7368 6973 6869  y.     ...shishi
│ │ │ │ -00016560: 5f61 7574 6865 6e74 6963 6174 6f72 2829  _authenticator()
│ │ │ │ -00016570: e280 992e 0a20 2020 2020 434b 5355 4d54  .....     CKSUMT
│ │ │ │ -00016580: 5950 453a 206f 7574 7075 7420 6368 6563  YPE: output chec
│ │ │ │ -00016590: 6b73 756d 2074 7970 652e 0a20 2020 2020  ksum type..     
│ │ │ │ -000165a0: 434b 5355 4d3a 206e 6577 6c79 2061 6c6c  CKSUM: newly all
│ │ │ │ -000165b0: 6f63 6174 6564 206f 7574 7075 7420 6368  ocated output ch
│ │ │ │ -000165c0: 6563 6b73 756d 2064 6174 6120 6672 6f6d  ecksum data from
│ │ │ │ -000165d0: 2061 7574 6865 6e74 6963 6174 6f72 2e0a   authenticator..
│ │ │ │ -000165e0: 2020 2020 2043 4b53 554d 4c45 4e3a 206f       CKSUMLEN: o
│ │ │ │ -000165f0: 6e20 6f75 7470 7574 2c20 6163 7475 616c  n output, actual
│ │ │ │ -00016600: 2073 697a 6520 6f66 2061 6c6c 6f63 6174   size of allocat
│ │ │ │ -00016610: 6564 206f 7574 7075 7420 6368 6563 6b73  ed output checks
│ │ │ │ -00016620: 756d 2064 6174 610a 2020 2020 2062 7566  um data.     buf
│ │ │ │ -00016630: 6665 722e 0a0a 2020 2020 202a 4465 7363  fer...     *Desc
│ │ │ │ -00016640: 7269 7074 696f 6e3a 2a20 5265 6164 2063  ription:* Read c
│ │ │ │ -00016650: 6865 636b 7375 6d20 7661 6c75 6520 6672  hecksum value fr
│ │ │ │ -00016660: 6f6d 2061 7574 6865 6e74 6963 6174 6f72  om authenticator
│ │ │ │ -00016670: 2e20 2043 4b53 554d 2069 730a 2020 2020  .  CKSUM is.    
│ │ │ │ -00016680: 2061 6c6c 6f63 6174 6564 2062 7920 7468   allocated by th
│ │ │ │ -00016690: 6973 2066 756e 6374 696f 6e2c 2061 6e64  is function, and
│ │ │ │ -000166a0: 2069 7420 6973 2074 6865 2072 6573 706f   it is the respo
│ │ │ │ -000166b0: 6e73 6962 696c 6974 7920 6f66 2063 616c  nsibility of cal
│ │ │ │ -000166c0: 6c65 720a 2020 2020 2074 6f20 6465 616c  ler.     to deal
│ │ │ │ -000166d0: 6c6f 6361 7465 2069 742e 0a0a 2020 2020  locate it...    
│ │ │ │ -000166e0: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ -000166f0: 2052 6574 7572 6e73 2053 4849 5348 495f   Returns SHISHI_
│ │ │ │ -00016700: 4f4b 2069 6666 2073 7563 6365 7373 6675  OK iff successfu
│ │ │ │ -00016710: 6c2e 0a0a 7368 6973 6869 5f61 7574 6865  l...shishi_authe
│ │ │ │ -00016720: 6e74 6963 6174 6f72 5f73 6574 5f63 6b73  nticator_set_cks
│ │ │ │ -00016730: 756d 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  um.-------------
│ │ │ │ +00016430: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +00016440: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ +00016450: 6973 6869 5f61 7574 6865 6e74 6963 6174  ishi_authenticat
│ │ │ │ +00016460: 6f72 5f63 6b73 756d 2028 5368 6973 6869  or_cksum (Shishi
│ │ │ │ +00016470: 202a 2048 414e 444c 452c 0a20 2020 2020   * HANDLE,.     
│ │ │ │ +00016480: 2020 2020 2053 6869 7368 695f 6173 6e31       Shishi_asn1
│ │ │ │ +00016490: 2041 5554 4845 4e54 4943 4154 4f52 2c20   AUTHENTICATOR, 
│ │ │ │ +000164a0: 696e 7433 325f 7420 2a20 434b 5355 4d54  int32_t * CKSUMT
│ │ │ │ +000164b0: 5950 452c 2063 6861 7220 2a2a 2043 4b53  YPE, char ** CKS
│ │ │ │ +000164c0: 554d 2c0a 2020 2020 2020 2020 2020 7369  UM,.          si
│ │ │ │ +000164d0: 7a65 5f74 202a 2043 4b53 554d 4c45 4e29  ze_t * CKSUMLEN)
│ │ │ │ +000164e0: 0a20 2020 2020 4841 4e44 4c45 3a20 7368  .     HANDLE: sh
│ │ │ │ +000164f0: 6973 6869 2068 616e 646c 6520 6173 2061  ishi handle as a
│ │ │ │ +00016500: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ +00016510: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ +00016520: 0a20 2020 2020 4155 5448 454e 5449 4341  .     AUTHENTICA
│ │ │ │ +00016530: 544f 523a 2061 7574 6865 6e74 6963 6174  TOR: authenticat
│ │ │ │ +00016540: 6f72 2061 7320 616c 6c6f 6361 7465 6420  or as allocated 
│ │ │ │ +00016550: 6279 0a20 2020 2020 e280 9873 6869 7368  by.     ...shish
│ │ │ │ +00016560: 695f 6175 7468 656e 7469 6361 746f 7228  i_authenticator(
│ │ │ │ +00016570: 29e2 8099 2e0a 2020 2020 2043 4b53 554d  ).....     CKSUM
│ │ │ │ +00016580: 5459 5045 3a20 6f75 7470 7574 2063 6865  TYPE: output che
│ │ │ │ +00016590: 636b 7375 6d20 7479 7065 2e0a 2020 2020  cksum type..    
│ │ │ │ +000165a0: 2043 4b53 554d 3a20 6e65 776c 7920 616c   CKSUM: newly al
│ │ │ │ +000165b0: 6c6f 6361 7465 6420 6f75 7470 7574 2063  located output c
│ │ │ │ +000165c0: 6865 636b 7375 6d20 6461 7461 2066 726f  hecksum data fro
│ │ │ │ +000165d0: 6d20 6175 7468 656e 7469 6361 746f 722e  m authenticator.
│ │ │ │ +000165e0: 0a20 2020 2020 434b 5355 4d4c 454e 3a20  .     CKSUMLEN: 
│ │ │ │ +000165f0: 6f6e 206f 7574 7075 742c 2061 6374 7561  on output, actua
│ │ │ │ +00016600: 6c20 7369 7a65 206f 6620 616c 6c6f 6361  l size of alloca
│ │ │ │ +00016610: 7465 6420 6f75 7470 7574 2063 6865 636b  ted output check
│ │ │ │ +00016620: 7375 6d20 6461 7461 0a20 2020 2020 6275  sum data.     bu
│ │ │ │ +00016630: 6666 6572 2e0a 0a20 2020 2020 2a44 6573  ffer...     *Des
│ │ │ │ +00016640: 6372 6970 7469 6f6e 3a2a 2052 6561 6420  cription:* Read 
│ │ │ │ +00016650: 6368 6563 6b73 756d 2076 616c 7565 2066  checksum value f
│ │ │ │ +00016660: 726f 6d20 6175 7468 656e 7469 6361 746f  rom authenticato
│ │ │ │ +00016670: 722e 2020 434b 5355 4d20 6973 0a20 2020  r.  CKSUM is.   
│ │ │ │ +00016680: 2020 616c 6c6f 6361 7465 6420 6279 2074    allocated by t
│ │ │ │ +00016690: 6869 7320 6675 6e63 7469 6f6e 2c20 616e  his function, an
│ │ │ │ +000166a0: 6420 6974 2069 7320 7468 6520 7265 7370  d it is the resp
│ │ │ │ +000166b0: 6f6e 7369 6269 6c69 7479 206f 6620 6361  onsibility of ca
│ │ │ │ +000166c0: 6c6c 6572 0a20 2020 2020 746f 2064 6561  ller.     to dea
│ │ │ │ +000166d0: 6c6c 6f63 6174 6520 6974 2e0a 0a20 2020  llocate it...   
│ │ │ │ +000166e0: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ +000166f0: 2a20 5265 7475 726e 7320 5348 4953 4849  * Returns SHISHI
│ │ │ │ +00016700: 5f4f 4b20 6966 6620 7375 6363 6573 7366  _OK iff successf
│ │ │ │ +00016710: 756c 2e0a 0a73 6869 7368 695f 6175 7468  ul...shishi_auth
│ │ │ │ +00016720: 656e 7469 6361 746f 725f 7365 745f 636b  enticator_set_ck
│ │ │ │ +00016730: 7375 6d0a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  sum.------------
│ │ │ │  00016740: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00016750: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ -00016760: 2069 6e74 2073 6869 7368 695f 6175 7468   int shishi_auth
│ │ │ │ -00016770: 656e 7469 6361 746f 725f 7365 745f 636b  enticator_set_ck
│ │ │ │ -00016780: 7375 6d20 2853 6869 7368 6920 2a20 4841  sum (Shishi * HA
│ │ │ │ -00016790: 4e44 4c45 2c0a 2020 2020 2020 2020 2020  NDLE,.          
│ │ │ │ -000167a0: 5368 6973 6869 5f61 736e 3120 4155 5448  Shishi_asn1 AUTH
│ │ │ │ -000167b0: 454e 5449 4341 544f 522c 2069 6e74 3332  ENTICATOR, int32
│ │ │ │ -000167c0: 5f74 2043 4b53 554d 5459 5045 2c20 6368  _t CKSUMTYPE, ch
│ │ │ │ -000167d0: 6172 202a 2043 4b53 554d 2c0a 2020 2020  ar * CKSUM,.    
│ │ │ │ -000167e0: 2020 2020 2020 7369 7a65 5f74 2043 4b53        size_t CKS
│ │ │ │ -000167f0: 554d 4c45 4e29 0a20 2020 2020 4841 4e44  UMLEN).     HAND
│ │ │ │ -00016800: 4c45 3a20 7368 6973 6869 2068 616e 646c  LE: shishi handl
│ │ │ │ -00016810: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ -00016820: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ -00016830: 2829 e280 992e 0a20 2020 2020 4155 5448  ().....     AUTH
│ │ │ │ -00016840: 454e 5449 4341 544f 523a 2061 7574 6865  ENTICATOR: authe
│ │ │ │ -00016850: 6e74 6963 6174 6f72 2061 7320 616c 6c6f  nticator as allo
│ │ │ │ -00016860: 6361 7465 6420 6279 0a20 2020 2020 e280  cated by.     ..
│ │ │ │ -00016870: 9873 6869 7368 695f 6175 7468 656e 7469  .shishi_authenti
│ │ │ │ -00016880: 6361 746f 7228 29e2 8099 2e0a 2020 2020  cator().....    
│ │ │ │ -00016890: 2043 4b53 554d 5459 5045 3a20 696e 7075   CKSUMTYPE: inpu
│ │ │ │ -000168a0: 7420 6368 6563 6b73 756d 2074 7970 6520  t checksum type 
│ │ │ │ -000168b0: 746f 2073 746f 7265 2069 6e20 6175 7468  to store in auth
│ │ │ │ -000168c0: 656e 7469 6361 746f 722e 0a20 2020 2020  enticator..     
│ │ │ │ -000168d0: 434b 5355 4d3a 2069 6e70 7574 2063 6865  CKSUM: input che
│ │ │ │ -000168e0: 636b 7375 6d20 6461 7461 2074 6f20 7374  cksum data to st
│ │ │ │ -000168f0: 6f72 6520 696e 2061 7574 6865 6e74 6963  ore in authentic
│ │ │ │ -00016900: 6174 6f72 2e0a 2020 2020 2043 4b53 554d  ator..     CKSUM
│ │ │ │ -00016910: 4c45 4e3a 2073 697a 6520 6f66 2069 6e70  LEN: size of inp
│ │ │ │ -00016920: 7574 2063 6865 636b 7375 6d20 6461 7461  ut checksum data
│ │ │ │ -00016930: 2074 6f20 7374 6f72 6520 696e 2061 7574   to store in aut
│ │ │ │ -00016940: 6865 6e74 6963 6174 6f72 2e0a 0a20 2020  henticator...   
│ │ │ │ -00016950: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ -00016960: 2053 746f 7265 2063 6865 636b 7375 6d20   Store checksum 
│ │ │ │ -00016970: 7661 6c75 6520 696e 2061 7574 6865 6e74  value in authent
│ │ │ │ -00016980: 6963 6174 6f72 2e20 2041 2063 6865 636b  icator.  A check
│ │ │ │ -00016990: 7375 6d0a 2020 2020 2069 7320 7573 7561  sum.     is usua
│ │ │ │ -000169a0: 6c6c 7920 6372 6561 7465 6420 6279 2063  lly created by c
│ │ │ │ -000169b0: 616c 6c69 6e67 20e2 8098 7368 6973 6869  alling ...shishi
│ │ │ │ -000169c0: 5f63 6865 636b 7375 6d28 29e2 8099 206f  _checksum()... o
│ │ │ │ -000169d0: 6e20 736f 6d65 0a20 2020 2020 6170 706c  n some.     appl
│ │ │ │ -000169e0: 6963 6174 696f 6e20 7370 6563 6966 6963  ication specific
│ │ │ │ -000169f0: 2064 6174 6120 7573 696e 6720 7468 6520   data using the 
│ │ │ │ -00016a00: 6b65 7920 6672 6f6d 2074 6865 2074 6963  key from the tic
│ │ │ │ -00016a10: 6b65 7420 7468 6174 2069 730a 2020 2020  ket that is.    
│ │ │ │ -00016a20: 2062 6569 6e67 2075 7365 642e 2020 546f   being used.  To
│ │ │ │ -00016a30: 2073 6176 6520 7469 6d65 2c20 796f 7520   save time, you 
│ │ │ │ -00016a40: 6d61 7920 7761 6e74 2074 6f20 7573 650a  may want to use.
│ │ │ │ -00016a50: 2020 2020 20e2 8098 7368 6973 6869 5f61       ...shishi_a
│ │ │ │ -00016a60: 7574 6865 6e74 6963 6174 6f72 5f61 6464  uthenticator_add
│ │ │ │ -00016a70: 5f63 6b73 756d 2829 e280 9920 696e 7374  _cksum()... inst
│ │ │ │ -00016a80: 6561 642c 2077 6869 6368 2063 616c 6375  ead, which calcu
│ │ │ │ -00016a90: 6c61 7465 7320 7468 650a 2020 2020 2063  lates the.     c
│ │ │ │ -00016aa0: 6865 636b 7375 6d20 616e 6420 6361 6c6c  hecksum and call
│ │ │ │ -00016ab0: 7320 7468 6973 2066 756e 6374 696f 6e20  s this function 
│ │ │ │ -00016ac0: 696e 206f 6e65 2073 7465 702e 0a0a 2020  in one step...  
│ │ │ │ -00016ad0: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ -00016ae0: 3a2a 2052 6574 7572 6e73 2053 4849 5348  :* Returns SHISH
│ │ │ │ -00016af0: 495f 4f4b 2069 6666 2073 7563 6365 7373  I_OK iff success
│ │ │ │ -00016b00: 6675 6c2e 0a0a 7368 6973 6869 5f61 7574  ful...shishi_aut
│ │ │ │ -00016b10: 6865 6e74 6963 6174 6f72 5f61 6464 5f63  henticator_add_c
│ │ │ │ -00016b20: 6b73 756d 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  ksum.-----------
│ │ │ │ +00016750: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ +00016760: 3a20 696e 7420 7368 6973 6869 5f61 7574  : int shishi_aut
│ │ │ │ +00016770: 6865 6e74 6963 6174 6f72 5f73 6574 5f63  henticator_set_c
│ │ │ │ +00016780: 6b73 756d 2028 5368 6973 6869 202a 2048  ksum (Shishi * H
│ │ │ │ +00016790: 414e 444c 452c 0a20 2020 2020 2020 2020  ANDLE,.         
│ │ │ │ +000167a0: 2053 6869 7368 695f 6173 6e31 2041 5554   Shishi_asn1 AUT
│ │ │ │ +000167b0: 4845 4e54 4943 4154 4f52 2c20 696e 7433  HENTICATOR, int3
│ │ │ │ +000167c0: 325f 7420 434b 5355 4d54 5950 452c 2063  2_t CKSUMTYPE, c
│ │ │ │ +000167d0: 6861 7220 2a20 434b 5355 4d2c 0a20 2020  har * CKSUM,.   
│ │ │ │ +000167e0: 2020 2020 2020 2073 697a 655f 7420 434b         size_t CK
│ │ │ │ +000167f0: 5355 4d4c 454e 290a 2020 2020 2048 414e  SUMLEN).     HAN
│ │ │ │ +00016800: 444c 453a 2073 6869 7368 6920 6861 6e64  DLE: shishi hand
│ │ │ │ +00016810: 6c65 2061 7320 616c 6c6f 6361 7465 6420  le as allocated 
│ │ │ │ +00016820: 6279 20e2 8098 7368 6973 6869 5f69 6e69  by ...shishi_ini
│ │ │ │ +00016830: 7428 29e2 8099 2e0a 2020 2020 2041 5554  t().....     AUT
│ │ │ │ +00016840: 4845 4e54 4943 4154 4f52 3a20 6175 7468  HENTICATOR: auth
│ │ │ │ +00016850: 656e 7469 6361 746f 7220 6173 2061 6c6c  enticator as all
│ │ │ │ +00016860: 6f63 6174 6564 2062 790a 2020 2020 20e2  ocated by.     .
│ │ │ │ +00016870: 8098 7368 6973 6869 5f61 7574 6865 6e74  ..shishi_authent
│ │ │ │ +00016880: 6963 6174 6f72 2829 e280 992e 0a20 2020  icator().....   
│ │ │ │ +00016890: 2020 434b 5355 4d54 5950 453a 2069 6e70    CKSUMTYPE: inp
│ │ │ │ +000168a0: 7574 2063 6865 636b 7375 6d20 7479 7065  ut checksum type
│ │ │ │ +000168b0: 2074 6f20 7374 6f72 6520 696e 2061 7574   to store in aut
│ │ │ │ +000168c0: 6865 6e74 6963 6174 6f72 2e0a 2020 2020  henticator..    
│ │ │ │ +000168d0: 2043 4b53 554d 3a20 696e 7075 7420 6368   CKSUM: input ch
│ │ │ │ +000168e0: 6563 6b73 756d 2064 6174 6120 746f 2073  ecksum data to s
│ │ │ │ +000168f0: 746f 7265 2069 6e20 6175 7468 656e 7469  tore in authenti
│ │ │ │ +00016900: 6361 746f 722e 0a20 2020 2020 434b 5355  cator..     CKSU
│ │ │ │ +00016910: 4d4c 454e 3a20 7369 7a65 206f 6620 696e  MLEN: size of in
│ │ │ │ +00016920: 7075 7420 6368 6563 6b73 756d 2064 6174  put checksum dat
│ │ │ │ +00016930: 6120 746f 2073 746f 7265 2069 6e20 6175  a to store in au
│ │ │ │ +00016940: 7468 656e 7469 6361 746f 722e 0a0a 2020  thenticator...  
│ │ │ │ +00016950: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ +00016960: 2a20 5374 6f72 6520 6368 6563 6b73 756d  * Store checksum
│ │ │ │ +00016970: 2076 616c 7565 2069 6e20 6175 7468 656e   value in authen
│ │ │ │ +00016980: 7469 6361 746f 722e 2020 4120 6368 6563  ticator.  A chec
│ │ │ │ +00016990: 6b73 756d 0a20 2020 2020 6973 2075 7375  ksum.     is usu
│ │ │ │ +000169a0: 616c 6c79 2063 7265 6174 6564 2062 7920  ally created by 
│ │ │ │ +000169b0: 6361 6c6c 696e 6720 e280 9873 6869 7368  calling ...shish
│ │ │ │ +000169c0: 695f 6368 6563 6b73 756d 2829 e280 9920  i_checksum()... 
│ │ │ │ +000169d0: 6f6e 2073 6f6d 650a 2020 2020 2061 7070  on some.     app
│ │ │ │ +000169e0: 6c69 6361 7469 6f6e 2073 7065 6369 6669  lication specifi
│ │ │ │ +000169f0: 6320 6461 7461 2075 7369 6e67 2074 6865  c data using the
│ │ │ │ +00016a00: 206b 6579 2066 726f 6d20 7468 6520 7469   key from the ti
│ │ │ │ +00016a10: 636b 6574 2074 6861 7420 6973 0a20 2020  cket that is.   
│ │ │ │ +00016a20: 2020 6265 696e 6720 7573 6564 2e20 2054    being used.  T
│ │ │ │ +00016a30: 6f20 7361 7665 2074 696d 652c 2079 6f75  o save time, you
│ │ │ │ +00016a40: 206d 6179 2077 616e 7420 746f 2075 7365   may want to use
│ │ │ │ +00016a50: 0a20 2020 2020 e280 9873 6869 7368 695f  .     ...shishi_
│ │ │ │ +00016a60: 6175 7468 656e 7469 6361 746f 725f 6164  authenticator_ad
│ │ │ │ +00016a70: 645f 636b 7375 6d28 29e2 8099 2069 6e73  d_cksum()... ins
│ │ │ │ +00016a80: 7465 6164 2c20 7768 6963 6820 6361 6c63  tead, which calc
│ │ │ │ +00016a90: 756c 6174 6573 2074 6865 0a20 2020 2020  ulates the.     
│ │ │ │ +00016aa0: 6368 6563 6b73 756d 2061 6e64 2063 616c  checksum and cal
│ │ │ │ +00016ab0: 6c73 2074 6869 7320 6675 6e63 7469 6f6e  ls this function
│ │ │ │ +00016ac0: 2069 6e20 6f6e 6520 7374 6570 2e0a 0a20   in one step... 
│ │ │ │ +00016ad0: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ +00016ae0: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ +00016af0: 4849 5f4f 4b20 6966 6620 7375 6363 6573  HI_OK iff succes
│ │ │ │ +00016b00: 7366 756c 2e0a 0a73 6869 7368 695f 6175  sful...shishi_au
│ │ │ │ +00016b10: 7468 656e 7469 6361 746f 725f 6164 645f  thenticator_add_
│ │ │ │ +00016b20: 636b 7375 6d0a 2d2d 2d2d 2d2d 2d2d 2d2d  cksum.----------
│ │ │ │  00016b30: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00016b40: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ -00016b50: 6e3a 2069 6e74 2073 6869 7368 695f 6175  n: int shishi_au
│ │ │ │ -00016b60: 7468 656e 7469 6361 746f 725f 6164 645f  thenticator_add_
│ │ │ │ -00016b70: 636b 7375 6d20 2853 6869 7368 6920 2a20  cksum (Shishi * 
│ │ │ │ -00016b80: 4841 4e44 4c45 2c0a 2020 2020 2020 2020  HANDLE,.        
│ │ │ │ -00016b90: 2020 5368 6973 6869 5f61 736e 3120 4155    Shishi_asn1 AU
│ │ │ │ -00016ba0: 5448 454e 5449 4341 544f 522c 2053 6869  THENTICATOR, Shi
│ │ │ │ -00016bb0: 7368 695f 6b65 7920 2a20 4b45 592c 2069  shi_key * KEY, i
│ │ │ │ -00016bc0: 6e74 204b 4559 5553 4147 452c 0a20 2020  nt KEYUSAGE,.   
│ │ │ │ -00016bd0: 2020 2020 2020 2063 6861 7220 2a20 4441         char * DA
│ │ │ │ -00016be0: 5441 2c20 7369 7a65 5f74 2044 4154 414c  TA, size_t DATAL
│ │ │ │ -00016bf0: 454e 290a 2020 2020 2048 414e 444c 453a  EN).     HANDLE:
│ │ │ │ -00016c00: 2073 6869 7368 6920 6861 6e64 6c65 2061   shishi handle a
│ │ │ │ -00016c10: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ -00016c20: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ -00016c30: 8099 2e0a 2020 2020 2041 5554 4845 4e54  ....     AUTHENT
│ │ │ │ -00016c40: 4943 4154 4f52 3a20 6175 7468 656e 7469  ICATOR: authenti
│ │ │ │ -00016c50: 6361 746f 7220 6173 2061 6c6c 6f63 6174  cator as allocat
│ │ │ │ -00016c60: 6564 2062 790a 2020 2020 20e2 8098 7368  ed by.     ...sh
│ │ │ │ -00016c70: 6973 6869 5f61 7574 6865 6e74 6963 6174  ishi_authenticat
│ │ │ │ -00016c80: 6f72 2829 e280 992e 0a20 2020 2020 4b45  or().....     KE
│ │ │ │ -00016c90: 593a 206b 6579 2074 6f20 746f 2075 7365  Y: key to to use
│ │ │ │ -00016ca0: 2066 6f72 2065 6e63 7279 7074 696f 6e2e   for encryption.
│ │ │ │ -00016cb0: 0a20 2020 2020 4b45 5955 5341 4745 3a20  .     KEYUSAGE: 
│ │ │ │ -00016cc0: 6372 7970 746f 6772 6170 6869 6320 6b65  cryptographic ke
│ │ │ │ -00016cd0: 7920 7573 6167 6520 7661 6c75 6520 746f  y usage value to
│ │ │ │ -00016ce0: 2075 7365 2069 6e20 656e 6372 7970 7469   use in encrypti
│ │ │ │ -00016cf0: 6f6e 2e0a 2020 2020 2044 4154 413a 2069  on..     DATA: i
│ │ │ │ -00016d00: 6e70 7574 2061 7272 6179 2077 6974 6820  nput array with 
│ │ │ │ -00016d10: 6461 7461 2074 6f20 6361 6c63 756c 6174  data to calculat
│ │ │ │ -00016d20: 6520 6368 6563 6b73 756d 206f 6e2e 0a20  e checksum on.. 
│ │ │ │ -00016d30: 2020 2020 4441 5441 4c45 4e3a 2073 697a      DATALEN: siz
│ │ │ │ -00016d40: 6520 6f66 2069 6e70 7574 2061 7272 6179  e of input array
│ │ │ │ -00016d50: 2077 6974 6820 6461 7461 2074 6f20 6361   with data to ca
│ │ │ │ -00016d60: 6c63 756c 6174 6520 6368 6563 6b73 756d  lculate checksum
│ │ │ │ -00016d70: 206f 6e2e 0a0a 2020 2020 202a 4465 7363   on...     *Desc
│ │ │ │ -00016d80: 7269 7074 696f 6e3a 2a20 4361 6c63 756c  ription:* Calcul
│ │ │ │ -00016d90: 6174 6520 6368 6563 6b73 756d 2066 6f72  ate checksum for
│ │ │ │ -00016da0: 2064 6174 6120 616e 6420 7374 6f72 6520   data and store 
│ │ │ │ -00016db0: 6974 2069 6e20 7468 650a 2020 2020 2061  it in the.     a
│ │ │ │ -00016dc0: 7574 6865 6e74 6963 6174 6f72 2e0a 0a20  uthenticator... 
│ │ │ │ -00016dd0: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ -00016de0: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ -00016df0: 4849 5f4f 4b20 6966 6620 7375 6363 6573  HI_OK iff succes
│ │ │ │ -00016e00: 7366 756c 2e0a 0a73 6869 7368 695f 6175  sful...shishi_au
│ │ │ │ -00016e10: 7468 656e 7469 6361 746f 725f 6164 645f  thenticator_add_
│ │ │ │ -00016e20: 636b 7375 6d5f 7479 7065 0a2d 2d2d 2d2d  cksum_type.-----
│ │ │ │ +00016b40: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ +00016b50: 6f6e 3a20 696e 7420 7368 6973 6869 5f61  on: int shishi_a
│ │ │ │ +00016b60: 7574 6865 6e74 6963 6174 6f72 5f61 6464  uthenticator_add
│ │ │ │ +00016b70: 5f63 6b73 756d 2028 5368 6973 6869 202a  _cksum (Shishi *
│ │ │ │ +00016b80: 2048 414e 444c 452c 0a20 2020 2020 2020   HANDLE,.       
│ │ │ │ +00016b90: 2020 2053 6869 7368 695f 6173 6e31 2041     Shishi_asn1 A
│ │ │ │ +00016ba0: 5554 4845 4e54 4943 4154 4f52 2c20 5368  UTHENTICATOR, Sh
│ │ │ │ +00016bb0: 6973 6869 5f6b 6579 202a 204b 4559 2c20  ishi_key * KEY, 
│ │ │ │ +00016bc0: 696e 7420 4b45 5955 5341 4745 2c0a 2020  int KEYUSAGE,.  
│ │ │ │ +00016bd0: 2020 2020 2020 2020 6368 6172 202a 2044          char * D
│ │ │ │ +00016be0: 4154 412c 2073 697a 655f 7420 4441 5441  ATA, size_t DATA
│ │ │ │ +00016bf0: 4c45 4e29 0a20 2020 2020 4841 4e44 4c45  LEN).     HANDLE
│ │ │ │ +00016c00: 3a20 7368 6973 6869 2068 616e 646c 6520  : shishi handle 
│ │ │ │ +00016c10: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ +00016c20: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ +00016c30: e280 992e 0a20 2020 2020 4155 5448 454e  .....     AUTHEN
│ │ │ │ +00016c40: 5449 4341 544f 523a 2061 7574 6865 6e74  TICATOR: authent
│ │ │ │ +00016c50: 6963 6174 6f72 2061 7320 616c 6c6f 6361  icator as alloca
│ │ │ │ +00016c60: 7465 6420 6279 0a20 2020 2020 e280 9873  ted by.     ...s
│ │ │ │ +00016c70: 6869 7368 695f 6175 7468 656e 7469 6361  hishi_authentica
│ │ │ │ +00016c80: 746f 7228 29e2 8099 2e0a 2020 2020 204b  tor().....     K
│ │ │ │ +00016c90: 4559 3a20 6b65 7920 746f 2074 6f20 7573  EY: key to to us
│ │ │ │ +00016ca0: 6520 666f 7220 656e 6372 7970 7469 6f6e  e for encryption
│ │ │ │ +00016cb0: 2e0a 2020 2020 204b 4559 5553 4147 453a  ..     KEYUSAGE:
│ │ │ │ +00016cc0: 2063 7279 7074 6f67 7261 7068 6963 206b   cryptographic k
│ │ │ │ +00016cd0: 6579 2075 7361 6765 2076 616c 7565 2074  ey usage value t
│ │ │ │ +00016ce0: 6f20 7573 6520 696e 2065 6e63 7279 7074  o use in encrypt
│ │ │ │ +00016cf0: 696f 6e2e 0a20 2020 2020 4441 5441 3a20  ion..     DATA: 
│ │ │ │ +00016d00: 696e 7075 7420 6172 7261 7920 7769 7468  input array with
│ │ │ │ +00016d10: 2064 6174 6120 746f 2063 616c 6375 6c61   data to calcula
│ │ │ │ +00016d20: 7465 2063 6865 636b 7375 6d20 6f6e 2e0a  te checksum on..
│ │ │ │ +00016d30: 2020 2020 2044 4154 414c 454e 3a20 7369       DATALEN: si
│ │ │ │ +00016d40: 7a65 206f 6620 696e 7075 7420 6172 7261  ze of input arra
│ │ │ │ +00016d50: 7920 7769 7468 2064 6174 6120 746f 2063  y with data to c
│ │ │ │ +00016d60: 616c 6375 6c61 7465 2063 6865 636b 7375  alculate checksu
│ │ │ │ +00016d70: 6d20 6f6e 2e0a 0a20 2020 2020 2a44 6573  m on...     *Des
│ │ │ │ +00016d80: 6372 6970 7469 6f6e 3a2a 2043 616c 6375  cription:* Calcu
│ │ │ │ +00016d90: 6c61 7465 2063 6865 636b 7375 6d20 666f  late checksum fo
│ │ │ │ +00016da0: 7220 6461 7461 2061 6e64 2073 746f 7265  r data and store
│ │ │ │ +00016db0: 2069 7420 696e 2074 6865 0a20 2020 2020   it in the.     
│ │ │ │ +00016dc0: 6175 7468 656e 7469 6361 746f 722e 0a0a  authenticator...
│ │ │ │ +00016dd0: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ +00016de0: 7565 3a2a 2052 6574 7572 6e73 2053 4849  ue:* Returns SHI
│ │ │ │ +00016df0: 5348 495f 4f4b 2069 6666 2073 7563 6365  SHI_OK iff succe
│ │ │ │ +00016e00: 7373 6675 6c2e 0a0a 7368 6973 6869 5f61  ssful...shishi_a
│ │ │ │ +00016e10: 7574 6865 6e74 6963 6174 6f72 5f61 6464  uthenticator_add
│ │ │ │ +00016e20: 5f63 6b73 756d 5f74 7970 650a 2d2d 2d2d  _cksum_type.----
│ │ │ │  00016e30: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00016e40: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -00016e50: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ -00016e60: 7420 7368 6973 6869 5f61 7574 6865 6e74  t shishi_authent
│ │ │ │ -00016e70: 6963 6174 6f72 5f61 6464 5f63 6b73 756d  icator_add_cksum
│ │ │ │ -00016e80: 5f74 7970 6520 2853 6869 7368 6920 2a20  _type (Shishi * 
│ │ │ │ -00016e90: 4841 4e44 4c45 2c0a 2020 2020 2020 2020  HANDLE,.        
│ │ │ │ -00016ea0: 2020 5368 6973 6869 5f61 736e 3120 4155    Shishi_asn1 AU
│ │ │ │ -00016eb0: 5448 454e 5449 4341 544f 522c 2053 6869  THENTICATOR, Shi
│ │ │ │ -00016ec0: 7368 695f 6b65 7920 2a20 4b45 592c 2069  shi_key * KEY, i
│ │ │ │ -00016ed0: 6e74 204b 4559 5553 4147 452c 0a20 2020  nt KEYUSAGE,.   
│ │ │ │ -00016ee0: 2020 2020 2020 2069 6e74 2043 4b53 554d         int CKSUM
│ │ │ │ -00016ef0: 5459 5045 2c20 6368 6172 202a 2044 4154  TYPE, char * DAT
│ │ │ │ -00016f00: 412c 2073 697a 655f 7420 4441 5441 4c45  A, size_t DATALE
│ │ │ │ -00016f10: 4e29 0a20 2020 2020 4841 4e44 4c45 3a20  N).     HANDLE: 
│ │ │ │ -00016f20: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ -00016f30: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ -00016f40: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ -00016f50: 992e 0a20 2020 2020 4155 5448 454e 5449  ...     AUTHENTI
│ │ │ │ -00016f60: 4341 544f 523a 2061 7574 6865 6e74 6963  CATOR: authentic
│ │ │ │ -00016f70: 6174 6f72 2061 7320 616c 6c6f 6361 7465  ator as allocate
│ │ │ │ -00016f80: 6420 6279 0a20 2020 2020 e280 9873 6869  d by.     ...shi
│ │ │ │ -00016f90: 7368 695f 6175 7468 656e 7469 6361 746f  shi_authenticato
│ │ │ │ -00016fa0: 7228 29e2 8099 2e0a 2020 2020 204b 4559  r().....     KEY
│ │ │ │ -00016fb0: 3a20 6b65 7920 746f 2074 6f20 7573 6520  : key to to use 
│ │ │ │ -00016fc0: 666f 7220 656e 6372 7970 7469 6f6e 2e0a  for encryption..
│ │ │ │ -00016fd0: 2020 2020 204b 4559 5553 4147 453a 2063       KEYUSAGE: c
│ │ │ │ -00016fe0: 7279 7074 6f67 7261 7068 6963 206b 6579  ryptographic key
│ │ │ │ -00016ff0: 2075 7361 6765 2076 616c 7565 2074 6f20   usage value to 
│ │ │ │ -00017000: 7573 6520 696e 2065 6e63 7279 7074 696f  use in encryptio
│ │ │ │ -00017010: 6e2e 0a20 2020 2020 434b 5355 4d54 5950  n..     CKSUMTYP
│ │ │ │ -00017020: 453a 2063 6865 636b 7375 6d20 746f 2074  E: checksum to t
│ │ │ │ -00017030: 7970 6520 746f 2063 616c 6375 6c61 7465  ype to calculate
│ │ │ │ -00017040: 2063 6865 636b 7375 6d2e 0a20 2020 2020   checksum..     
│ │ │ │ -00017050: 4441 5441 3a20 696e 7075 7420 6172 7261  DATA: input arra
│ │ │ │ -00017060: 7920 7769 7468 2064 6174 6120 746f 2063  y with data to c
│ │ │ │ -00017070: 616c 6375 6c61 7465 2063 6865 636b 7375  alculate checksu
│ │ │ │ -00017080: 6d20 6f6e 2e0a 2020 2020 2044 4154 414c  m on..     DATAL
│ │ │ │ -00017090: 454e 3a20 7369 7a65 206f 6620 696e 7075  EN: size of inpu
│ │ │ │ -000170a0: 7420 6172 7261 7920 7769 7468 2064 6174  t array with dat
│ │ │ │ -000170b0: 6120 746f 2063 616c 6375 6c61 7465 2063  a to calculate c
│ │ │ │ -000170c0: 6865 636b 7375 6d20 6f6e 2e0a 0a20 2020  hecksum on...   
│ │ │ │ -000170d0: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ -000170e0: 2043 616c 6375 6c61 7465 2063 6865 636b   Calculate check
│ │ │ │ -000170f0: 7375 6d20 666f 7220 6461 7461 2061 6e64  sum for data and
│ │ │ │ -00017100: 2073 746f 7265 2069 7420 696e 2074 6865   store it in the
│ │ │ │ -00017110: 0a20 2020 2020 6175 7468 656e 7469 6361  .     authentica
│ │ │ │ -00017120: 746f 722e 0a0a 2020 2020 202a 5265 7475  tor...     *Retu
│ │ │ │ -00017130: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ -00017140: 6e73 2053 4849 5348 495f 4f4b 2069 6666  ns SHISHI_OK iff
│ │ │ │ -00017150: 2073 7563 6365 7373 6675 6c2e 0a0a 7368   successful...sh
│ │ │ │ -00017160: 6973 6869 5f61 7574 6865 6e74 6963 6174  ishi_authenticat
│ │ │ │ -00017170: 6f72 5f63 6c65 6172 5f61 7574 686f 7269  or_clear_authori
│ │ │ │ -00017180: 7a61 7469 6f6e 6461 7461 0a2d 2d2d 2d2d  zationdata.-----
│ │ │ │ +00016e40: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +00016e50: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ +00016e60: 6e74 2073 6869 7368 695f 6175 7468 656e  nt shishi_authen
│ │ │ │ +00016e70: 7469 6361 746f 725f 6164 645f 636b 7375  ticator_add_cksu
│ │ │ │ +00016e80: 6d5f 7479 7065 2028 5368 6973 6869 202a  m_type (Shishi *
│ │ │ │ +00016e90: 2048 414e 444c 452c 0a20 2020 2020 2020   HANDLE,.       
│ │ │ │ +00016ea0: 2020 2053 6869 7368 695f 6173 6e31 2041     Shishi_asn1 A
│ │ │ │ +00016eb0: 5554 4845 4e54 4943 4154 4f52 2c20 5368  UTHENTICATOR, Sh
│ │ │ │ +00016ec0: 6973 6869 5f6b 6579 202a 204b 4559 2c20  ishi_key * KEY, 
│ │ │ │ +00016ed0: 696e 7420 4b45 5955 5341 4745 2c0a 2020  int KEYUSAGE,.  
│ │ │ │ +00016ee0: 2020 2020 2020 2020 696e 7420 434b 5355          int CKSU
│ │ │ │ +00016ef0: 4d54 5950 452c 2063 6861 7220 2a20 4441  MTYPE, char * DA
│ │ │ │ +00016f00: 5441 2c20 7369 7a65 5f74 2044 4154 414c  TA, size_t DATAL
│ │ │ │ +00016f10: 454e 290a 2020 2020 2048 414e 444c 453a  EN).     HANDLE:
│ │ │ │ +00016f20: 2073 6869 7368 6920 6861 6e64 6c65 2061   shishi handle a
│ │ │ │ +00016f30: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ +00016f40: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ +00016f50: 8099 2e0a 2020 2020 2041 5554 4845 4e54  ....     AUTHENT
│ │ │ │ +00016f60: 4943 4154 4f52 3a20 6175 7468 656e 7469  ICATOR: authenti
│ │ │ │ +00016f70: 6361 746f 7220 6173 2061 6c6c 6f63 6174  cator as allocat
│ │ │ │ +00016f80: 6564 2062 790a 2020 2020 20e2 8098 7368  ed by.     ...sh
│ │ │ │ +00016f90: 6973 6869 5f61 7574 6865 6e74 6963 6174  ishi_authenticat
│ │ │ │ +00016fa0: 6f72 2829 e280 992e 0a20 2020 2020 4b45  or().....     KE
│ │ │ │ +00016fb0: 593a 206b 6579 2074 6f20 746f 2075 7365  Y: key to to use
│ │ │ │ +00016fc0: 2066 6f72 2065 6e63 7279 7074 696f 6e2e   for encryption.
│ │ │ │ +00016fd0: 0a20 2020 2020 4b45 5955 5341 4745 3a20  .     KEYUSAGE: 
│ │ │ │ +00016fe0: 6372 7970 746f 6772 6170 6869 6320 6b65  cryptographic ke
│ │ │ │ +00016ff0: 7920 7573 6167 6520 7661 6c75 6520 746f  y usage value to
│ │ │ │ +00017000: 2075 7365 2069 6e20 656e 6372 7970 7469   use in encrypti
│ │ │ │ +00017010: 6f6e 2e0a 2020 2020 2043 4b53 554d 5459  on..     CKSUMTY
│ │ │ │ +00017020: 5045 3a20 6368 6563 6b73 756d 2074 6f20  PE: checksum to 
│ │ │ │ +00017030: 7479 7065 2074 6f20 6361 6c63 756c 6174  type to calculat
│ │ │ │ +00017040: 6520 6368 6563 6b73 756d 2e0a 2020 2020  e checksum..    
│ │ │ │ +00017050: 2044 4154 413a 2069 6e70 7574 2061 7272   DATA: input arr
│ │ │ │ +00017060: 6179 2077 6974 6820 6461 7461 2074 6f20  ay with data to 
│ │ │ │ +00017070: 6361 6c63 756c 6174 6520 6368 6563 6b73  calculate checks
│ │ │ │ +00017080: 756d 206f 6e2e 0a20 2020 2020 4441 5441  um on..     DATA
│ │ │ │ +00017090: 4c45 4e3a 2073 697a 6520 6f66 2069 6e70  LEN: size of inp
│ │ │ │ +000170a0: 7574 2061 7272 6179 2077 6974 6820 6461  ut array with da
│ │ │ │ +000170b0: 7461 2074 6f20 6361 6c63 756c 6174 6520  ta to calculate 
│ │ │ │ +000170c0: 6368 6563 6b73 756d 206f 6e2e 0a0a 2020  checksum on...  
│ │ │ │ +000170d0: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ +000170e0: 2a20 4361 6c63 756c 6174 6520 6368 6563  * Calculate chec
│ │ │ │ +000170f0: 6b73 756d 2066 6f72 2064 6174 6120 616e  ksum for data an
│ │ │ │ +00017100: 6420 7374 6f72 6520 6974 2069 6e20 7468  d store it in th
│ │ │ │ +00017110: 650a 2020 2020 2061 7574 6865 6e74 6963  e.     authentic
│ │ │ │ +00017120: 6174 6f72 2e0a 0a20 2020 2020 2a52 6574  ator...     *Ret
│ │ │ │ +00017130: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ +00017140: 726e 7320 5348 4953 4849 5f4f 4b20 6966  rns SHISHI_OK if
│ │ │ │ +00017150: 6620 7375 6363 6573 7366 756c 2e0a 0a73  f successful...s
│ │ │ │ +00017160: 6869 7368 695f 6175 7468 656e 7469 6361  hishi_authentica
│ │ │ │ +00017170: 746f 725f 636c 6561 725f 6175 7468 6f72  tor_clear_author
│ │ │ │ +00017180: 697a 6174 696f 6e64 6174 610a 2d2d 2d2d  izationdata.----
│ │ │ │  00017190: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │  000171a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000171b0: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ -000171c0: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ -000171d0: 695f 6175 7468 656e 7469 6361 746f 725f  i_authenticator_
│ │ │ │ -000171e0: 636c 6561 725f 6175 7468 6f72 697a 6174  clear_authorizat
│ │ │ │ -000171f0: 696f 6e64 6174 610a 2020 2020 2020 2020  iondata.        
│ │ │ │ -00017200: 2020 2853 6869 7368 6920 2a20 4841 4e44    (Shishi * HAND
│ │ │ │ -00017210: 4c45 2c20 5368 6973 6869 5f61 736e 3120  LE, Shishi_asn1 
│ │ │ │ -00017220: 4155 5448 454e 5449 4341 544f 5229 0a20  AUTHENTICATOR). 
│ │ │ │ -00017230: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ -00017240: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ -00017250: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ -00017260: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ -00017270: 2020 2020 4155 5448 454e 5449 4341 544f      AUTHENTICATO
│ │ │ │ -00017280: 523a 2041 7574 6865 6e74 6963 6174 6f72  R: Authenticator
│ │ │ │ -00017290: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ -000172a0: 0a20 2020 2020 e280 9873 6869 7368 695f  .     ...shishi_
│ │ │ │ -000172b0: 6175 7468 656e 7469 6361 746f 7228 29e2  authenticator().
│ │ │ │ -000172c0: 8099 2e0a 0a20 2020 2020 2a44 6573 6372  .....     *Descr
│ │ │ │ -000172d0: 6970 7469 6f6e 3a2a 2052 656d 6f76 6520  iption:* Remove 
│ │ │ │ -000172e0: 7468 6520 6175 7468 6f72 697a 6174 696f  the authorizatio
│ │ │ │ -000172f0: 6e2d 6461 7461 2066 6965 6c64 2066 726f  n-data field fro
│ │ │ │ -00017300: 6d0a 2020 2020 2041 7574 6865 6e74 6963  m.     Authentic
│ │ │ │ -00017310: 6174 6f72 2e0a 0a20 2020 2020 2a52 6574  ator...     *Ret
│ │ │ │ -00017320: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ -00017330: 726e 7320 5348 4953 4849 5f4f 4b20 6966  rns SHISHI_OK if
│ │ │ │ -00017340: 6620 7375 6363 6573 7366 756c 2e0a 0a73  f successful...s
│ │ │ │ -00017350: 6869 7368 695f 6175 7468 656e 7469 6361  hishi_authentica
│ │ │ │ -00017360: 746f 725f 6164 645f 6175 7468 6f72 697a  tor_add_authoriz
│ │ │ │ -00017370: 6174 696f 6e64 6174 610a 2d2d 2d2d 2d2d  ationdata.------
│ │ │ │ +000171b0: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ +000171c0: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ +000171d0: 6869 5f61 7574 6865 6e74 6963 6174 6f72  hi_authenticator
│ │ │ │ +000171e0: 5f63 6c65 6172 5f61 7574 686f 7269 7a61  _clear_authoriza
│ │ │ │ +000171f0: 7469 6f6e 6461 7461 0a20 2020 2020 2020  tiondata.       
│ │ │ │ +00017200: 2020 2028 5368 6973 6869 202a 2048 414e     (Shishi * HAN
│ │ │ │ +00017210: 444c 452c 2053 6869 7368 695f 6173 6e31  DLE, Shishi_asn1
│ │ │ │ +00017220: 2041 5554 4845 4e54 4943 4154 4f52 290a   AUTHENTICATOR).
│ │ │ │ +00017230: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ +00017240: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ +00017250: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ +00017260: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ +00017270: 2020 2020 2041 5554 4845 4e54 4943 4154       AUTHENTICAT
│ │ │ │ +00017280: 4f52 3a20 4175 7468 656e 7469 6361 746f  OR: Authenticato
│ │ │ │ +00017290: 7220 6173 2061 6c6c 6f63 6174 6564 2062  r as allocated b
│ │ │ │ +000172a0: 790a 2020 2020 20e2 8098 7368 6973 6869  y.     ...shishi
│ │ │ │ +000172b0: 5f61 7574 6865 6e74 6963 6174 6f72 2829  _authenticator()
│ │ │ │ +000172c0: e280 992e 0a0a 2020 2020 202a 4465 7363  ......     *Desc
│ │ │ │ +000172d0: 7269 7074 696f 6e3a 2a20 5265 6d6f 7665  ription:* Remove
│ │ │ │ +000172e0: 2074 6865 2061 7574 686f 7269 7a61 7469   the authorizati
│ │ │ │ +000172f0: 6f6e 2d64 6174 6120 6669 656c 6420 6672  on-data field fr
│ │ │ │ +00017300: 6f6d 0a20 2020 2020 4175 7468 656e 7469  om.     Authenti
│ │ │ │ +00017310: 6361 746f 722e 0a0a 2020 2020 202a 5265  cator...     *Re
│ │ │ │ +00017320: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ +00017330: 7572 6e73 2053 4849 5348 495f 4f4b 2069  urns SHISHI_OK i
│ │ │ │ +00017340: 6666 2073 7563 6365 7373 6675 6c2e 0a0a  ff successful...
│ │ │ │ +00017350: 7368 6973 6869 5f61 7574 6865 6e74 6963  shishi_authentic
│ │ │ │ +00017360: 6174 6f72 5f61 6464 5f61 7574 686f 7269  ator_add_authori
│ │ │ │ +00017370: 7a61 7469 6f6e 6461 7461 0a2d 2d2d 2d2d  zationdata.-----
│ │ │ │  00017380: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │  00017390: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000173a0: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -000173b0: 6f6e 3a20 696e 7420 7368 6973 6869 5f61  on: int shishi_a
│ │ │ │ -000173c0: 7574 6865 6e74 6963 6174 6f72 5f61 6464  uthenticator_add
│ │ │ │ -000173d0: 5f61 7574 686f 7269 7a61 7469 6f6e 6461  _authorizationda
│ │ │ │ -000173e0: 7461 0a20 2020 2020 2020 2020 2028 5368  ta.          (Sh
│ │ │ │ -000173f0: 6973 6869 202a 2048 414e 444c 452c 2053  ishi * HANDLE, S
│ │ │ │ -00017400: 6869 7368 695f 6173 6e31 2041 5554 4845  hishi_asn1 AUTHE
│ │ │ │ -00017410: 4e54 4943 4154 4f52 2c20 696e 7433 325f  NTICATOR, int32_
│ │ │ │ -00017420: 7420 4144 5459 5045 2c0a 2020 2020 2020  t ADTYPE,.      
│ │ │ │ -00017430: 2020 2020 636f 6e73 7420 6368 6172 202a      const char *
│ │ │ │ -00017440: 2041 4444 4154 412c 2073 697a 655f 7420   ADDATA, size_t 
│ │ │ │ -00017450: 4144 4441 5441 4c45 4e29 0a20 2020 2020  ADDATALEN).     
│ │ │ │ -00017460: 4841 4e44 4c45 3a20 7368 6973 6869 2068  HANDLE: shishi h
│ │ │ │ -00017470: 616e 646c 6520 6173 2061 6c6c 6f63 6174  andle as allocat
│ │ │ │ -00017480: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ -00017490: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ -000174a0: 4155 5448 454e 5449 4341 544f 523a 2061  AUTHENTICATOR: a
│ │ │ │ -000174b0: 7574 6865 6e74 6963 6174 6f72 2061 7320  uthenticator as 
│ │ │ │ -000174c0: 616c 6c6f 6361 7465 6420 6279 0a20 2020  allocated by.   
│ │ │ │ -000174d0: 2020 e280 9873 6869 7368 695f 6175 7468    ...shishi_auth
│ │ │ │ -000174e0: 656e 7469 6361 746f 7228 29e2 8099 2e0a  enticator().....
│ │ │ │ -000174f0: 2020 2020 2041 4454 5950 453a 2069 6e70       ADTYPE: inp
│ │ │ │ -00017500: 7574 2061 7574 686f 7269 7a61 7469 6f6e  ut authorization
│ │ │ │ -00017510: 2064 6174 6120 7479 7065 2074 6f20 6164   data type to ad
│ │ │ │ -00017520: 642e 0a20 2020 2020 4144 4441 5441 3a20  d..     ADDATA: 
│ │ │ │ -00017530: 696e 7075 7420 6175 7468 6f72 697a 6174  input authorizat
│ │ │ │ -00017540: 696f 6e20 6461 7461 2074 6f20 6164 642e  ion data to add.
│ │ │ │ -00017550: 0a20 2020 2020 4144 4441 5441 4c45 4e3a  .     ADDATALEN:
│ │ │ │ -00017560: 2073 697a 6520 6f66 2069 6e70 7574 2061   size of input a
│ │ │ │ -00017570: 7574 686f 7269 7a61 7469 6f6e 2064 6174  uthorization dat
│ │ │ │ -00017580: 6120 746f 2061 6464 2e0a 0a20 2020 2020  a to add...     
│ │ │ │ -00017590: 2a44 6573 6372 6970 7469 6f6e 3a2a 2041  *Description:* A
│ │ │ │ -000175a0: 6464 2061 7574 686f 7269 7a61 7469 6f6e  dd authorization
│ │ │ │ -000175b0: 2064 6174 6120 746f 2061 7574 6865 6e74   data to authent
│ │ │ │ -000175c0: 6963 6174 6f72 2e0a 0a20 2020 2020 2a52  icator...     *R
│ │ │ │ -000175d0: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ -000175e0: 7475 726e 7320 5348 4953 4849 5f4f 4b20  turns SHISHI_OK 
│ │ │ │ -000175f0: 6966 6620 7375 6363 6573 7366 756c 2e0a  iff successful..
│ │ │ │ -00017600: 0a73 6869 7368 695f 6175 7468 656e 7469  .shishi_authenti
│ │ │ │ -00017610: 6361 746f 725f 6175 7468 6f72 697a 6174  cator_authorizat
│ │ │ │ -00017620: 696f 6e64 6174 610a 2d2d 2d2d 2d2d 2d2d  iondata.--------
│ │ │ │ +000173a0: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +000173b0: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ +000173c0: 6175 7468 656e 7469 6361 746f 725f 6164  authenticator_ad
│ │ │ │ +000173d0: 645f 6175 7468 6f72 697a 6174 696f 6e64  d_authorizationd
│ │ │ │ +000173e0: 6174 610a 2020 2020 2020 2020 2020 2853  ata.          (S
│ │ │ │ +000173f0: 6869 7368 6920 2a20 4841 4e44 4c45 2c20  hishi * HANDLE, 
│ │ │ │ +00017400: 5368 6973 6869 5f61 736e 3120 4155 5448  Shishi_asn1 AUTH
│ │ │ │ +00017410: 454e 5449 4341 544f 522c 2069 6e74 3332  ENTICATOR, int32
│ │ │ │ +00017420: 5f74 2041 4454 5950 452c 0a20 2020 2020  _t ADTYPE,.     
│ │ │ │ +00017430: 2020 2020 2063 6f6e 7374 2063 6861 7220       const char 
│ │ │ │ +00017440: 2a20 4144 4441 5441 2c20 7369 7a65 5f74  * ADDATA, size_t
│ │ │ │ +00017450: 2041 4444 4154 414c 454e 290a 2020 2020   ADDATALEN).    
│ │ │ │ +00017460: 2048 414e 444c 453a 2073 6869 7368 6920   HANDLE: shishi 
│ │ │ │ +00017470: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ +00017480: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ +00017490: 5f69 6e69 7428 29e2 8099 2e0a 2020 2020  _init().....    
│ │ │ │ +000174a0: 2041 5554 4845 4e54 4943 4154 4f52 3a20   AUTHENTICATOR: 
│ │ │ │ +000174b0: 6175 7468 656e 7469 6361 746f 7220 6173  authenticator as
│ │ │ │ +000174c0: 2061 6c6c 6f63 6174 6564 2062 790a 2020   allocated by.  
│ │ │ │ +000174d0: 2020 20e2 8098 7368 6973 6869 5f61 7574     ...shishi_aut
│ │ │ │ +000174e0: 6865 6e74 6963 6174 6f72 2829 e280 992e  henticator()....
│ │ │ │ +000174f0: 0a20 2020 2020 4144 5459 5045 3a20 696e  .     ADTYPE: in
│ │ │ │ +00017500: 7075 7420 6175 7468 6f72 697a 6174 696f  put authorizatio
│ │ │ │ +00017510: 6e20 6461 7461 2074 7970 6520 746f 2061  n data type to a
│ │ │ │ +00017520: 6464 2e0a 2020 2020 2041 4444 4154 413a  dd..     ADDATA:
│ │ │ │ +00017530: 2069 6e70 7574 2061 7574 686f 7269 7a61   input authoriza
│ │ │ │ +00017540: 7469 6f6e 2064 6174 6120 746f 2061 6464  tion data to add
│ │ │ │ +00017550: 2e0a 2020 2020 2041 4444 4154 414c 454e  ..     ADDATALEN
│ │ │ │ +00017560: 3a20 7369 7a65 206f 6620 696e 7075 7420  : size of input 
│ │ │ │ +00017570: 6175 7468 6f72 697a 6174 696f 6e20 6461  authorization da
│ │ │ │ +00017580: 7461 2074 6f20 6164 642e 0a0a 2020 2020  ta to add...    
│ │ │ │ +00017590: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ +000175a0: 4164 6420 6175 7468 6f72 697a 6174 696f  Add authorizatio
│ │ │ │ +000175b0: 6e20 6461 7461 2074 6f20 6175 7468 656e  n data to authen
│ │ │ │ +000175c0: 7469 6361 746f 722e 0a0a 2020 2020 202a  ticator...     *
│ │ │ │ +000175d0: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ +000175e0: 6574 7572 6e73 2053 4849 5348 495f 4f4b  eturns SHISHI_OK
│ │ │ │ +000175f0: 2069 6666 2073 7563 6365 7373 6675 6c2e   iff successful.
│ │ │ │ +00017600: 0a0a 7368 6973 6869 5f61 7574 6865 6e74  ..shishi_authent
│ │ │ │ +00017610: 6963 6174 6f72 5f61 7574 686f 7269 7a61  icator_authoriza
│ │ │ │ +00017620: 7469 6f6e 6461 7461 0a2d 2d2d 2d2d 2d2d  tiondata.-------
│ │ │ │  00017630: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00017640: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -00017650: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ -00017660: 7420 7368 6973 6869 5f61 7574 6865 6e74  t shishi_authent
│ │ │ │ -00017670: 6963 6174 6f72 5f61 7574 686f 7269 7a61  icator_authoriza
│ │ │ │ -00017680: 7469 6f6e 6461 7461 0a20 2020 2020 2020  tiondata.       
│ │ │ │ -00017690: 2020 2028 5368 6973 6869 202a 2048 414e     (Shishi * HAN
│ │ │ │ -000176a0: 444c 452c 2053 6869 7368 695f 6173 6e31  DLE, Shishi_asn1
│ │ │ │ -000176b0: 2041 5554 4845 4e54 4943 4154 4f52 2c20   AUTHENTICATOR, 
│ │ │ │ -000176c0: 696e 7433 325f 7420 2a20 4144 5459 5045  int32_t * ADTYPE
│ │ │ │ -000176d0: 2c0a 2020 2020 2020 2020 2020 6368 6172  ,.          char
│ │ │ │ -000176e0: 202a 2a20 4144 4441 5441 2c20 7369 7a65   ** ADDATA, size
│ │ │ │ -000176f0: 5f74 202a 2041 4444 4154 414c 454e 2c20  _t * ADDATALEN, 
│ │ │ │ -00017700: 7369 7a65 5f74 204e 5448 290a 2020 2020  size_t NTH).    
│ │ │ │ -00017710: 2048 414e 444c 453a 2073 6869 7368 6920   HANDLE: shishi 
│ │ │ │ -00017720: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ -00017730: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ -00017740: 5f69 6e69 7428 29e2 8099 2e0a 2020 2020  _init().....    
│ │ │ │ -00017750: 2041 5554 4845 4e54 4943 4154 4f52 3a20   AUTHENTICATOR: 
│ │ │ │ -00017760: 6175 7468 656e 7469 6361 746f 7220 6173  authenticator as
│ │ │ │ -00017770: 2061 6c6c 6f63 6174 6564 2062 790a 2020   allocated by.  
│ │ │ │ -00017780: 2020 20e2 8098 7368 6973 6869 5f61 7574     ...shishi_aut
│ │ │ │ -00017790: 6865 6e74 6963 6174 6f72 2829 e280 992e  henticator()....
│ │ │ │ -000177a0: 0a20 2020 2020 4144 5459 5045 3a20 6f75  .     ADTYPE: ou
│ │ │ │ -000177b0: 7470 7574 2061 7574 686f 7269 7a61 7469  tput authorizati
│ │ │ │ -000177c0: 6f6e 2064 6174 6120 7479 7065 2e0a 2020  on data type..  
│ │ │ │ -000177d0: 2020 2041 4444 4154 413a 206e 6577 6c79     ADDATA: newly
│ │ │ │ -000177e0: 2061 6c6c 6f63 6174 6564 206f 7574 7075   allocated outpu
│ │ │ │ -000177f0: 7420 6175 7468 6f72 697a 6174 696f 6e20  t authorization 
│ │ │ │ -00017800: 6461 7461 2e0a 2020 2020 2041 4444 4154  data..     ADDAT
│ │ │ │ -00017810: 414c 454e 3a20 6f6e 206f 7574 7075 742c  ALEN: on output,
│ │ │ │ -00017820: 2061 6374 7561 6c20 7369 7a65 206f 6620   actual size of 
│ │ │ │ -00017830: 6e65 776c 7920 616c 6c6f 6361 7465 6420  newly allocated 
│ │ │ │ -00017840: 6175 7468 6f72 697a 6174 696f 6e0a 2020  authorization.  
│ │ │ │ -00017850: 2020 2064 6174 612e 0a20 2020 2020 4e54     data..     NT
│ │ │ │ -00017860: 483a 2065 6c65 6d65 6e74 206e 756d 6265  H: element numbe
│ │ │ │ -00017870: 7220 6f66 2061 7574 686f 7269 7a61 7469  r of authorizati
│ │ │ │ -00017880: 6f6e 2d64 6174 6120 746f 2065 7874 7261  on-data to extra
│ │ │ │ -00017890: 6374 2e0a 0a20 2020 2020 2a45 7874 7261  ct...     *Extra
│ │ │ │ -000178a0: 6374 206e 3a2a 2074 6820 6175 7468 6f72  ct n:* th author
│ │ │ │ -000178b0: 697a 6174 696f 6e20 6461 7461 2066 726f  ization data fro
│ │ │ │ -000178c0: 6d20 6175 7468 656e 7469 6361 746f 722e  m authenticator.
│ │ │ │ -000178d0: 2020 5468 6520 6669 7273 740a 2020 2020    The first.    
│ │ │ │ -000178e0: 2066 6965 6c64 2069 7320 312e 0a0a 2020   field is 1...  
│ │ │ │ -000178f0: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ -00017900: 3a2a 2052 6574 7572 6e73 2053 4849 5348  :* Returns SHISH
│ │ │ │ -00017910: 495f 4f4b 2069 6666 2073 7563 6365 7373  I_OK iff success
│ │ │ │ -00017920: 6675 6c2e 0a0a 7368 6973 6869 5f61 7574  ful...shishi_aut
│ │ │ │ -00017930: 6865 6e74 6963 6174 6f72 5f72 656d 6f76  henticator_remov
│ │ │ │ -00017940: 655f 7375 626b 6579 0a2d 2d2d 2d2d 2d2d  e_subkey.-------
│ │ │ │ +00017640: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +00017650: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ +00017660: 6e74 2073 6869 7368 695f 6175 7468 656e  nt shishi_authen
│ │ │ │ +00017670: 7469 6361 746f 725f 6175 7468 6f72 697a  ticator_authoriz
│ │ │ │ +00017680: 6174 696f 6e64 6174 610a 2020 2020 2020  ationdata.      
│ │ │ │ +00017690: 2020 2020 2853 6869 7368 6920 2a20 4841      (Shishi * HA
│ │ │ │ +000176a0: 4e44 4c45 2c20 5368 6973 6869 5f61 736e  NDLE, Shishi_asn
│ │ │ │ +000176b0: 3120 4155 5448 454e 5449 4341 544f 522c  1 AUTHENTICATOR,
│ │ │ │ +000176c0: 2069 6e74 3332 5f74 202a 2041 4454 5950   int32_t * ADTYP
│ │ │ │ +000176d0: 452c 0a20 2020 2020 2020 2020 2063 6861  E,.          cha
│ │ │ │ +000176e0: 7220 2a2a 2041 4444 4154 412c 2073 697a  r ** ADDATA, siz
│ │ │ │ +000176f0: 655f 7420 2a20 4144 4441 5441 4c45 4e2c  e_t * ADDATALEN,
│ │ │ │ +00017700: 2073 697a 655f 7420 4e54 4829 0a20 2020   size_t NTH).   
│ │ │ │ +00017710: 2020 4841 4e44 4c45 3a20 7368 6973 6869    HANDLE: shishi
│ │ │ │ +00017720: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ +00017730: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ +00017740: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ +00017750: 2020 4155 5448 454e 5449 4341 544f 523a    AUTHENTICATOR:
│ │ │ │ +00017760: 2061 7574 6865 6e74 6963 6174 6f72 2061   authenticator a
│ │ │ │ +00017770: 7320 616c 6c6f 6361 7465 6420 6279 0a20  s allocated by. 
│ │ │ │ +00017780: 2020 2020 e280 9873 6869 7368 695f 6175      ...shishi_au
│ │ │ │ +00017790: 7468 656e 7469 6361 746f 7228 29e2 8099  thenticator()...
│ │ │ │ +000177a0: 2e0a 2020 2020 2041 4454 5950 453a 206f  ..     ADTYPE: o
│ │ │ │ +000177b0: 7574 7075 7420 6175 7468 6f72 697a 6174  utput authorizat
│ │ │ │ +000177c0: 696f 6e20 6461 7461 2074 7970 652e 0a20  ion data type.. 
│ │ │ │ +000177d0: 2020 2020 4144 4441 5441 3a20 6e65 776c      ADDATA: newl
│ │ │ │ +000177e0: 7920 616c 6c6f 6361 7465 6420 6f75 7470  y allocated outp
│ │ │ │ +000177f0: 7574 2061 7574 686f 7269 7a61 7469 6f6e  ut authorization
│ │ │ │ +00017800: 2064 6174 612e 0a20 2020 2020 4144 4441   data..     ADDA
│ │ │ │ +00017810: 5441 4c45 4e3a 206f 6e20 6f75 7470 7574  TALEN: on output
│ │ │ │ +00017820: 2c20 6163 7475 616c 2073 697a 6520 6f66  , actual size of
│ │ │ │ +00017830: 206e 6577 6c79 2061 6c6c 6f63 6174 6564   newly allocated
│ │ │ │ +00017840: 2061 7574 686f 7269 7a61 7469 6f6e 0a20   authorization. 
│ │ │ │ +00017850: 2020 2020 6461 7461 2e0a 2020 2020 204e      data..     N
│ │ │ │ +00017860: 5448 3a20 656c 656d 656e 7420 6e75 6d62  TH: element numb
│ │ │ │ +00017870: 6572 206f 6620 6175 7468 6f72 697a 6174  er of authorizat
│ │ │ │ +00017880: 696f 6e2d 6461 7461 2074 6f20 6578 7472  ion-data to extr
│ │ │ │ +00017890: 6163 742e 0a0a 2020 2020 202a 4578 7472  act...     *Extr
│ │ │ │ +000178a0: 6163 7420 6e3a 2a20 7468 2061 7574 686f  act n:* th autho
│ │ │ │ +000178b0: 7269 7a61 7469 6f6e 2064 6174 6120 6672  rization data fr
│ │ │ │ +000178c0: 6f6d 2061 7574 6865 6e74 6963 6174 6f72  om authenticator
│ │ │ │ +000178d0: 2e20 2054 6865 2066 6972 7374 0a20 2020  .  The first.   
│ │ │ │ +000178e0: 2020 6669 656c 6420 6973 2031 2e0a 0a20    field is 1... 
│ │ │ │ +000178f0: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ +00017900: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ +00017910: 4849 5f4f 4b20 6966 6620 7375 6363 6573  HI_OK iff succes
│ │ │ │ +00017920: 7366 756c 2e0a 0a73 6869 7368 695f 6175  sful...shishi_au
│ │ │ │ +00017930: 7468 656e 7469 6361 746f 725f 7265 6d6f  thenticator_remo
│ │ │ │ +00017940: 7665 5f73 7562 6b65 790a 2d2d 2d2d 2d2d  ve_subkey.------
│ │ │ │  00017950: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00017960: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ -00017970: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ -00017980: 6869 7368 695f 6175 7468 656e 7469 6361  hishi_authentica
│ │ │ │ -00017990: 746f 725f 7265 6d6f 7665 5f73 7562 6b65  tor_remove_subke
│ │ │ │ -000179a0: 7920 2853 6869 7368 6920 2a20 4841 4e44  y (Shishi * HAND
│ │ │ │ -000179b0: 4c45 2c0a 2020 2020 2020 2020 2020 5368  LE,.          Sh
│ │ │ │ -000179c0: 6973 6869 5f61 736e 3120 4155 5448 454e  ishi_asn1 AUTHEN
│ │ │ │ -000179d0: 5449 4341 544f 5229 0a20 2020 2020 4841  TICATOR).     HA
│ │ │ │ -000179e0: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ -000179f0: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ -00017a00: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ -00017a10: 6974 2829 e280 992e 0a20 2020 2020 4155  it().....     AU
│ │ │ │ -00017a20: 5448 454e 5449 4341 544f 523a 2061 7574  THENTICATOR: aut
│ │ │ │ -00017a30: 6865 6e74 6963 6174 6f72 2061 7320 616c  henticator as al
│ │ │ │ -00017a40: 6c6f 6361 7465 6420 6279 0a20 2020 2020  located by.     
│ │ │ │ -00017a50: e280 9873 6869 7368 695f 6175 7468 656e  ...shishi_authen
│ │ │ │ -00017a60: 7469 6361 746f 7228 29e2 8099 2e0a 0a20  ticator()...... 
│ │ │ │ -00017a70: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -00017a80: 3a2a 2052 656d 6f76 6520 7375 626b 6579  :* Remove subkey
│ │ │ │ -00017a90: 2066 726f 6d20 7468 6520 6175 7468 656e   from the authen
│ │ │ │ -00017aa0: 7469 6361 746f 722e 0a0a 2020 2020 202a  ticator...     *
│ │ │ │ -00017ab0: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ -00017ac0: 6574 7572 6e73 2053 4849 5348 495f 4f4b  eturns SHISHI_OK
│ │ │ │ -00017ad0: 2069 6666 2073 7563 6365 7373 6675 6c2e   iff successful.
│ │ │ │ -00017ae0: 0a0a 7368 6973 6869 5f61 7574 6865 6e74  ..shishi_authent
│ │ │ │ -00017af0: 6963 6174 6f72 5f67 6574 5f73 7562 6b65  icator_get_subke
│ │ │ │ -00017b00: 790a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  y.--------------
│ │ │ │ +00017960: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ +00017970: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ +00017980: 7368 6973 6869 5f61 7574 6865 6e74 6963  shishi_authentic
│ │ │ │ +00017990: 6174 6f72 5f72 656d 6f76 655f 7375 626b  ator_remove_subk
│ │ │ │ +000179a0: 6579 2028 5368 6973 6869 202a 2048 414e  ey (Shishi * HAN
│ │ │ │ +000179b0: 444c 452c 0a20 2020 2020 2020 2020 2053  DLE,.          S
│ │ │ │ +000179c0: 6869 7368 695f 6173 6e31 2041 5554 4845  hishi_asn1 AUTHE
│ │ │ │ +000179d0: 4e54 4943 4154 4f52 290a 2020 2020 2048  NTICATOR).     H
│ │ │ │ +000179e0: 414e 444c 453a 2073 6869 7368 6920 6861  ANDLE: shishi ha
│ │ │ │ +000179f0: 6e64 6c65 2061 7320 616c 6c6f 6361 7465  ndle as allocate
│ │ │ │ +00017a00: 6420 6279 20e2 8098 7368 6973 6869 5f69  d by ...shishi_i
│ │ │ │ +00017a10: 6e69 7428 29e2 8099 2e0a 2020 2020 2041  nit().....     A
│ │ │ │ +00017a20: 5554 4845 4e54 4943 4154 4f52 3a20 6175  UTHENTICATOR: au
│ │ │ │ +00017a30: 7468 656e 7469 6361 746f 7220 6173 2061  thenticator as a
│ │ │ │ +00017a40: 6c6c 6f63 6174 6564 2062 790a 2020 2020  llocated by.    
│ │ │ │ +00017a50: 20e2 8098 7368 6973 6869 5f61 7574 6865   ...shishi_authe
│ │ │ │ +00017a60: 6e74 6963 6174 6f72 2829 e280 992e 0a0a  nticator()......
│ │ │ │ +00017a70: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ +00017a80: 6e3a 2a20 5265 6d6f 7665 2073 7562 6b65  n:* Remove subke
│ │ │ │ +00017a90: 7920 6672 6f6d 2074 6865 2061 7574 6865  y from the authe
│ │ │ │ +00017aa0: 6e74 6963 6174 6f72 2e0a 0a20 2020 2020  nticator...     
│ │ │ │ +00017ab0: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ +00017ac0: 5265 7475 726e 7320 5348 4953 4849 5f4f  Returns SHISHI_O
│ │ │ │ +00017ad0: 4b20 6966 6620 7375 6363 6573 7366 756c  K iff successful
│ │ │ │ +00017ae0: 2e0a 0a73 6869 7368 695f 6175 7468 656e  ...shishi_authen
│ │ │ │ +00017af0: 7469 6361 746f 725f 6765 745f 7375 626b  ticator_get_subk
│ │ │ │ +00017b00: 6579 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ey.-------------
│ │ │ │  00017b10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00017b20: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ -00017b30: 2069 6e74 2073 6869 7368 695f 6175 7468   int shishi_auth
│ │ │ │ -00017b40: 656e 7469 6361 746f 725f 6765 745f 7375  enticator_get_su
│ │ │ │ -00017b50: 626b 6579 2028 5368 6973 6869 202a 2048  bkey (Shishi * H
│ │ │ │ -00017b60: 414e 444c 452c 0a20 2020 2020 2020 2020  ANDLE,.         
│ │ │ │ -00017b70: 2053 6869 7368 695f 6173 6e31 2041 5554   Shishi_asn1 AUT
│ │ │ │ -00017b80: 4845 4e54 4943 4154 4f52 2c20 5368 6973  HENTICATOR, Shis
│ │ │ │ -00017b90: 6869 5f6b 6579 202a 2a20 5355 424b 4559  hi_key ** SUBKEY
│ │ │ │ -00017ba0: 290a 2020 2020 2048 414e 444c 453a 2073  ).     HANDLE: s
│ │ │ │ -00017bb0: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ -00017bc0: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ -00017bd0: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ -00017be0: 2e0a 2020 2020 2041 5554 4845 4e54 4943  ..     AUTHENTIC
│ │ │ │ -00017bf0: 4154 4f52 3a20 6175 7468 656e 7469 6361  ATOR: authentica
│ │ │ │ -00017c00: 746f 7220 6173 2061 6c6c 6f63 6174 6564  tor as allocated
│ │ │ │ -00017c10: 2062 790a 2020 2020 20e2 8098 7368 6973   by.     ...shis
│ │ │ │ -00017c20: 6869 5f61 7574 6865 6e74 6963 6174 6f72  hi_authenticator
│ │ │ │ -00017c30: 2829 e280 992e 0a20 2020 2020 5355 424b  ().....     SUBK
│ │ │ │ -00017c40: 4559 3a20 6f75 7470 7574 206e 6577 6c79  EY: output newly
│ │ │ │ -00017c50: 2061 6c6c 6f63 6174 6564 2073 7562 6b65   allocated subke
│ │ │ │ -00017c60: 7920 6672 6f6d 2061 7574 6865 6e74 6963  y from authentic
│ │ │ │ -00017c70: 6174 6f72 2e0a 0a20 2020 2020 2a44 6573  ator...     *Des
│ │ │ │ -00017c80: 6372 6970 7469 6f6e 3a2a 2052 6561 6420  cription:* Read 
│ │ │ │ -00017c90: 7375 626b 6579 2076 616c 7565 2066 726f  subkey value fro
│ │ │ │ -00017ca0: 6d20 6175 7468 656e 7469 6361 746f 722e  m authenticator.
│ │ │ │ -00017cb0: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ -00017cc0: 616c 7565 3a2a 2052 6574 7572 6e73 2053  alue:* Returns S
│ │ │ │ -00017cd0: 4849 5348 495f 4f4b 2069 6620 7375 6363  HISHI_OK if succ
│ │ │ │ -00017ce0: 6573 7366 756c 206f 720a 2020 2020 2053  essful or.     S
│ │ │ │ -00017cf0: 4849 5348 495f 4153 4e31 5f4e 4f5f 454c  HISHI_ASN1_NO_EL
│ │ │ │ -00017d00: 454d 454e 5420 6966 2073 7562 6b65 7920  EMENT if subkey 
│ │ │ │ -00017d10: 6973 206e 6f74 2070 7265 7365 6e74 2e0a  is not present..
│ │ │ │ -00017d20: 0a73 6869 7368 695f 6175 7468 656e 7469  .shishi_authenti
│ │ │ │ -00017d30: 6361 746f 725f 7365 745f 7375 626b 6579  cator_set_subkey
│ │ │ │ -00017d40: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ +00017b20: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ +00017b30: 3a20 696e 7420 7368 6973 6869 5f61 7574  : int shishi_aut
│ │ │ │ +00017b40: 6865 6e74 6963 6174 6f72 5f67 6574 5f73  henticator_get_s
│ │ │ │ +00017b50: 7562 6b65 7920 2853 6869 7368 6920 2a20  ubkey (Shishi * 
│ │ │ │ +00017b60: 4841 4e44 4c45 2c0a 2020 2020 2020 2020  HANDLE,.        
│ │ │ │ +00017b70: 2020 5368 6973 6869 5f61 736e 3120 4155    Shishi_asn1 AU
│ │ │ │ +00017b80: 5448 454e 5449 4341 544f 522c 2053 6869  THENTICATOR, Shi
│ │ │ │ +00017b90: 7368 695f 6b65 7920 2a2a 2053 5542 4b45  shi_key ** SUBKE
│ │ │ │ +00017ba0: 5929 0a20 2020 2020 4841 4e44 4c45 3a20  Y).     HANDLE: 
│ │ │ │ +00017bb0: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ +00017bc0: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ +00017bd0: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ +00017be0: 992e 0a20 2020 2020 4155 5448 454e 5449  ...     AUTHENTI
│ │ │ │ +00017bf0: 4341 544f 523a 2061 7574 6865 6e74 6963  CATOR: authentic
│ │ │ │ +00017c00: 6174 6f72 2061 7320 616c 6c6f 6361 7465  ator as allocate
│ │ │ │ +00017c10: 6420 6279 0a20 2020 2020 e280 9873 6869  d by.     ...shi
│ │ │ │ +00017c20: 7368 695f 6175 7468 656e 7469 6361 746f  shi_authenticato
│ │ │ │ +00017c30: 7228 29e2 8099 2e0a 2020 2020 2053 5542  r().....     SUB
│ │ │ │ +00017c40: 4b45 593a 206f 7574 7075 7420 6e65 776c  KEY: output newl
│ │ │ │ +00017c50: 7920 616c 6c6f 6361 7465 6420 7375 626b  y allocated subk
│ │ │ │ +00017c60: 6579 2066 726f 6d20 6175 7468 656e 7469  ey from authenti
│ │ │ │ +00017c70: 6361 746f 722e 0a0a 2020 2020 202a 4465  cator...     *De
│ │ │ │ +00017c80: 7363 7269 7074 696f 6e3a 2a20 5265 6164  scription:* Read
│ │ │ │ +00017c90: 2073 7562 6b65 7920 7661 6c75 6520 6672   subkey value fr
│ │ │ │ +00017ca0: 6f6d 2061 7574 6865 6e74 6963 6174 6f72  om authenticator
│ │ │ │ +00017cb0: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ +00017cc0: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ +00017cd0: 5348 4953 4849 5f4f 4b20 6966 2073 7563  SHISHI_OK if suc
│ │ │ │ +00017ce0: 6365 7373 6675 6c20 6f72 0a20 2020 2020  cessful or.     
│ │ │ │ +00017cf0: 5348 4953 4849 5f41 534e 315f 4e4f 5f45  SHISHI_ASN1_NO_E
│ │ │ │ +00017d00: 4c45 4d45 4e54 2069 6620 7375 626b 6579  LEMENT if subkey
│ │ │ │ +00017d10: 2069 7320 6e6f 7420 7072 6573 656e 742e   is not present.
│ │ │ │ +00017d20: 0a0a 7368 6973 6869 5f61 7574 6865 6e74  ..shishi_authent
│ │ │ │ +00017d30: 6963 6174 6f72 5f73 6574 5f73 7562 6b65  icator_set_subke
│ │ │ │ +00017d40: 790a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  y.--------------
│ │ │ │  00017d50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00017d60: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ -00017d70: 696e 7420 7368 6973 6869 5f61 7574 6865  int shishi_authe
│ │ │ │ -00017d80: 6e74 6963 6174 6f72 5f73 6574 5f73 7562  nticator_set_sub
│ │ │ │ -00017d90: 6b65 7920 2853 6869 7368 6920 2a20 4841  key (Shishi * HA
│ │ │ │ -00017da0: 4e44 4c45 2c0a 2020 2020 2020 2020 2020  NDLE,.          
│ │ │ │ -00017db0: 5368 6973 6869 5f61 736e 3120 4155 5448  Shishi_asn1 AUTH
│ │ │ │ -00017dc0: 454e 5449 4341 544f 522c 2069 6e74 3332  ENTICATOR, int32
│ │ │ │ -00017dd0: 5f74 2053 5542 4b45 5954 5950 452c 0a20  _t SUBKEYTYPE,. 
│ │ │ │ -00017de0: 2020 2020 2020 2020 2063 6f6e 7374 2063           const c
│ │ │ │ -00017df0: 6861 7220 2a20 5355 424b 4559 2c20 7369  har * SUBKEY, si
│ │ │ │ -00017e00: 7a65 5f74 2053 5542 4b45 594c 454e 290a  ze_t SUBKEYLEN).
│ │ │ │ -00017e10: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ -00017e20: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ -00017e30: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ -00017e40: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ -00017e50: 2020 2020 2041 5554 4845 4e54 4943 4154       AUTHENTICAT
│ │ │ │ -00017e60: 4f52 3a20 6175 7468 656e 7469 6361 746f  OR: authenticato
│ │ │ │ -00017e70: 7220 6173 2061 6c6c 6f63 6174 6564 2062  r as allocated b
│ │ │ │ -00017e80: 790a 2020 2020 20e2 8098 7368 6973 6869  y.     ...shishi
│ │ │ │ -00017e90: 5f61 7574 6865 6e74 6963 6174 6f72 2829  _authenticator()
│ │ │ │ -00017ea0: e280 992e 0a20 2020 2020 5355 424b 4559  .....     SUBKEY
│ │ │ │ -00017eb0: 5459 5045 3a20 696e 7075 7420 7375 626b  TYPE: input subk
│ │ │ │ -00017ec0: 6579 2074 7970 6520 746f 2073 746f 7265  ey type to store
│ │ │ │ -00017ed0: 2069 6e20 6175 7468 656e 7469 6361 746f   in authenticato
│ │ │ │ -00017ee0: 722e 0a20 2020 2020 5355 424b 4559 3a20  r..     SUBKEY: 
│ │ │ │ -00017ef0: 696e 7075 7420 7375 626b 6579 2064 6174  input subkey dat
│ │ │ │ -00017f00: 6120 746f 2073 746f 7265 2069 6e20 6175  a to store in au
│ │ │ │ -00017f10: 7468 656e 7469 6361 746f 722e 0a20 2020  thenticator..   
│ │ │ │ -00017f20: 2020 5355 424b 4559 4c45 4e3a 2073 697a    SUBKEYLEN: siz
│ │ │ │ -00017f30: 6520 6f66 2069 6e70 7574 2073 7562 6b65  e of input subke
│ │ │ │ -00017f40: 7920 6461 7461 2074 6f20 7374 6f72 6520  y data to store 
│ │ │ │ -00017f50: 696e 2061 7574 6865 6e74 6963 6174 6f72  in authenticator
│ │ │ │ -00017f60: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ -00017f70: 7469 6f6e 3a2a 2053 746f 7265 2073 7562  tion:* Store sub
│ │ │ │ -00017f80: 6b65 7920 7661 6c75 6520 696e 2061 7574  key value in aut
│ │ │ │ -00017f90: 6865 6e74 6963 6174 6f72 2e20 2041 2073  henticator.  A s
│ │ │ │ -00017fa0: 7562 6b65 7920 6973 0a20 2020 2020 7573  ubkey is.     us
│ │ │ │ -00017fb0: 7561 6c6c 7920 6372 6561 7465 6420 6279  ually created by
│ │ │ │ -00017fc0: 2063 616c 6c69 6e67 20e2 8098 7368 6973   calling ...shis
│ │ │ │ -00017fd0: 6869 5f6b 6579 5f72 616e 646f 6d28 29e2  hi_key_random().
│ │ │ │ -00017fe0: 8099 2075 7369 6e67 2074 6865 2064 6566  .. using the def
│ │ │ │ -00017ff0: 6175 6c74 0a20 2020 2020 656e 6372 7970  ault.     encryp
│ │ │ │ -00018000: 7469 6f6e 2074 7970 6520 6f66 2074 6865  tion type of the
│ │ │ │ -00018010: 206b 6579 2066 726f 6d20 7468 6520 7469   key from the ti
│ │ │ │ -00018020: 636b 6574 2074 6861 7420 6973 2062 6569  cket that is bei
│ │ │ │ -00018030: 6e67 2075 7365 642e 2020 546f 0a20 2020  ng used.  To.   
│ │ │ │ -00018040: 2020 7361 7665 2074 696d 652c 2079 6f75    save time, you
│ │ │ │ -00018050: 206d 6179 2077 616e 7420 746f 2075 7365   may want to use
│ │ │ │ -00018060: 20e2 8098 7368 6973 6869 5f61 7574 6865   ...shishi_authe
│ │ │ │ -00018070: 6e74 6963 6174 6f72 5f61 6464 5f73 7562  nticator_add_sub
│ │ │ │ -00018080: 6b65 7928 29e2 8099 0a20 2020 2020 696e  key()....     in
│ │ │ │ -00018090: 7374 6561 642c 2077 6869 6368 2063 616c  stead, which cal
│ │ │ │ -000180a0: 6375 6c61 7465 7320 7468 6520 7375 626b  culates the subk
│ │ │ │ -000180b0: 6579 2061 6e64 2063 616c 6c73 2074 6869  ey and calls thi
│ │ │ │ -000180c0: 7320 6675 6e63 7469 6f6e 2069 6e20 6f6e  s function in on
│ │ │ │ -000180d0: 650a 2020 2020 2073 7465 702e 0a0a 2020  e.     step...  
│ │ │ │ -000180e0: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ -000180f0: 3a2a 2052 6574 7572 6e73 2053 4849 5348  :* Returns SHISH
│ │ │ │ -00018100: 495f 4f4b 2069 6666 2073 7563 6365 7373  I_OK iff success
│ │ │ │ -00018110: 6675 6c2e 0a0a 7368 6973 6869 5f61 7574  ful...shishi_aut
│ │ │ │ -00018120: 6865 6e74 6963 6174 6f72 5f61 6464 5f72  henticator_add_r
│ │ │ │ -00018130: 616e 646f 6d5f 7375 626b 6579 0a2d 2d2d  andom_subkey.---
│ │ │ │ +00017d60: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ +00017d70: 2069 6e74 2073 6869 7368 695f 6175 7468   int shishi_auth
│ │ │ │ +00017d80: 656e 7469 6361 746f 725f 7365 745f 7375  enticator_set_su
│ │ │ │ +00017d90: 626b 6579 2028 5368 6973 6869 202a 2048  bkey (Shishi * H
│ │ │ │ +00017da0: 414e 444c 452c 0a20 2020 2020 2020 2020  ANDLE,.         
│ │ │ │ +00017db0: 2053 6869 7368 695f 6173 6e31 2041 5554   Shishi_asn1 AUT
│ │ │ │ +00017dc0: 4845 4e54 4943 4154 4f52 2c20 696e 7433  HENTICATOR, int3
│ │ │ │ +00017dd0: 325f 7420 5355 424b 4559 5459 5045 2c0a  2_t SUBKEYTYPE,.
│ │ │ │ +00017de0: 2020 2020 2020 2020 2020 636f 6e73 7420            const 
│ │ │ │ +00017df0: 6368 6172 202a 2053 5542 4b45 592c 2073  char * SUBKEY, s
│ │ │ │ +00017e00: 697a 655f 7420 5355 424b 4559 4c45 4e29  ize_t SUBKEYLEN)
│ │ │ │ +00017e10: 0a20 2020 2020 4841 4e44 4c45 3a20 7368  .     HANDLE: sh
│ │ │ │ +00017e20: 6973 6869 2068 616e 646c 6520 6173 2061  ishi handle as a
│ │ │ │ +00017e30: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ +00017e40: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ +00017e50: 0a20 2020 2020 4155 5448 454e 5449 4341  .     AUTHENTICA
│ │ │ │ +00017e60: 544f 523a 2061 7574 6865 6e74 6963 6174  TOR: authenticat
│ │ │ │ +00017e70: 6f72 2061 7320 616c 6c6f 6361 7465 6420  or as allocated 
│ │ │ │ +00017e80: 6279 0a20 2020 2020 e280 9873 6869 7368  by.     ...shish
│ │ │ │ +00017e90: 695f 6175 7468 656e 7469 6361 746f 7228  i_authenticator(
│ │ │ │ +00017ea0: 29e2 8099 2e0a 2020 2020 2053 5542 4b45  ).....     SUBKE
│ │ │ │ +00017eb0: 5954 5950 453a 2069 6e70 7574 2073 7562  YTYPE: input sub
│ │ │ │ +00017ec0: 6b65 7920 7479 7065 2074 6f20 7374 6f72  key type to stor
│ │ │ │ +00017ed0: 6520 696e 2061 7574 6865 6e74 6963 6174  e in authenticat
│ │ │ │ +00017ee0: 6f72 2e0a 2020 2020 2053 5542 4b45 593a  or..     SUBKEY:
│ │ │ │ +00017ef0: 2069 6e70 7574 2073 7562 6b65 7920 6461   input subkey da
│ │ │ │ +00017f00: 7461 2074 6f20 7374 6f72 6520 696e 2061  ta to store in a
│ │ │ │ +00017f10: 7574 6865 6e74 6963 6174 6f72 2e0a 2020  uthenticator..  
│ │ │ │ +00017f20: 2020 2053 5542 4b45 594c 454e 3a20 7369     SUBKEYLEN: si
│ │ │ │ +00017f30: 7a65 206f 6620 696e 7075 7420 7375 626b  ze of input subk
│ │ │ │ +00017f40: 6579 2064 6174 6120 746f 2073 746f 7265  ey data to store
│ │ │ │ +00017f50: 2069 6e20 6175 7468 656e 7469 6361 746f   in authenticato
│ │ │ │ +00017f60: 722e 0a0a 2020 2020 202a 4465 7363 7269  r...     *Descri
│ │ │ │ +00017f70: 7074 696f 6e3a 2a20 5374 6f72 6520 7375  ption:* Store su
│ │ │ │ +00017f80: 626b 6579 2076 616c 7565 2069 6e20 6175  bkey value in au
│ │ │ │ +00017f90: 7468 656e 7469 6361 746f 722e 2020 4120  thenticator.  A 
│ │ │ │ +00017fa0: 7375 626b 6579 2069 730a 2020 2020 2075  subkey is.     u
│ │ │ │ +00017fb0: 7375 616c 6c79 2063 7265 6174 6564 2062  sually created b
│ │ │ │ +00017fc0: 7920 6361 6c6c 696e 6720 e280 9873 6869  y calling ...shi
│ │ │ │ +00017fd0: 7368 695f 6b65 795f 7261 6e64 6f6d 2829  shi_key_random()
│ │ │ │ +00017fe0: e280 9920 7573 696e 6720 7468 6520 6465  ... using the de
│ │ │ │ +00017ff0: 6661 756c 740a 2020 2020 2065 6e63 7279  fault.     encry
│ │ │ │ +00018000: 7074 696f 6e20 7479 7065 206f 6620 7468  ption type of th
│ │ │ │ +00018010: 6520 6b65 7920 6672 6f6d 2074 6865 2074  e key from the t
│ │ │ │ +00018020: 6963 6b65 7420 7468 6174 2069 7320 6265  icket that is be
│ │ │ │ +00018030: 696e 6720 7573 6564 2e20 2054 6f0a 2020  ing used.  To.  
│ │ │ │ +00018040: 2020 2073 6176 6520 7469 6d65 2c20 796f     save time, yo
│ │ │ │ +00018050: 7520 6d61 7920 7761 6e74 2074 6f20 7573  u may want to us
│ │ │ │ +00018060: 6520 e280 9873 6869 7368 695f 6175 7468  e ...shishi_auth
│ │ │ │ +00018070: 656e 7469 6361 746f 725f 6164 645f 7375  enticator_add_su
│ │ │ │ +00018080: 626b 6579 2829 e280 990a 2020 2020 2069  bkey()....     i
│ │ │ │ +00018090: 6e73 7465 6164 2c20 7768 6963 6820 6361  nstead, which ca
│ │ │ │ +000180a0: 6c63 756c 6174 6573 2074 6865 2073 7562  lculates the sub
│ │ │ │ +000180b0: 6b65 7920 616e 6420 6361 6c6c 7320 7468  key and calls th
│ │ │ │ +000180c0: 6973 2066 756e 6374 696f 6e20 696e 206f  is function in o
│ │ │ │ +000180d0: 6e65 0a20 2020 2020 7374 6570 2e0a 0a20  ne.     step... 
│ │ │ │ +000180e0: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ +000180f0: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ +00018100: 4849 5f4f 4b20 6966 6620 7375 6363 6573  HI_OK iff succes
│ │ │ │ +00018110: 7366 756c 2e0a 0a73 6869 7368 695f 6175  sful...shishi_au
│ │ │ │ +00018120: 7468 656e 7469 6361 746f 725f 6164 645f  thenticator_add_
│ │ │ │ +00018130: 7261 6e64 6f6d 5f73 7562 6b65 790a 2d2d  random_subkey.--
│ │ │ │  00018140: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │  00018150: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00018160: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ -00018170: 6e3a 2069 6e74 2073 6869 7368 695f 6175  n: int shishi_au
│ │ │ │ -00018180: 7468 656e 7469 6361 746f 725f 6164 645f  thenticator_add_
│ │ │ │ -00018190: 7261 6e64 6f6d 5f73 7562 6b65 790a 2020  random_subkey.  
│ │ │ │ -000181a0: 2020 2020 2020 2020 2853 6869 7368 6920          (Shishi 
│ │ │ │ -000181b0: 2a20 4841 4e44 4c45 2c20 5368 6973 6869  * HANDLE, Shishi
│ │ │ │ -000181c0: 5f61 736e 3120 4155 5448 454e 5449 4341  _asn1 AUTHENTICA
│ │ │ │ -000181d0: 544f 5229 0a20 2020 2020 4841 4e44 4c45  TOR).     HANDLE
│ │ │ │ -000181e0: 3a20 7368 6973 6869 2068 616e 646c 6520  : shishi handle 
│ │ │ │ -000181f0: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ -00018200: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ -00018210: e280 992e 0a20 2020 2020 4155 5448 454e  .....     AUTHEN
│ │ │ │ -00018220: 5449 4341 544f 523a 2061 7574 6865 6e74  TICATOR: authent
│ │ │ │ -00018230: 6963 6174 6f72 2061 7320 616c 6c6f 6361  icator as alloca
│ │ │ │ -00018240: 7465 6420 6279 0a20 2020 2020 e280 9873  ted by.     ...s
│ │ │ │ -00018250: 6869 7368 695f 6175 7468 656e 7469 6361  hishi_authentica
│ │ │ │ -00018260: 746f 7228 29e2 8099 2e0a 0a20 2020 2020  tor()......     
│ │ │ │ -00018270: 2a44 6573 6372 6970 7469 6f6e 3a2a 2047  *Description:* G
│ │ │ │ -00018280: 656e 6572 6174 6520 7261 6e64 6f6d 2073  enerate random s
│ │ │ │ -00018290: 7562 6b65 792c 206f 6620 7468 6520 6465  ubkey, of the de
│ │ │ │ -000182a0: 6661 756c 7420 656e 6372 7970 7469 6f6e  fault encryption
│ │ │ │ -000182b0: 0a20 2020 2020 7479 7065 2066 726f 6d20  .     type from 
│ │ │ │ -000182c0: 636f 6e66 6967 7572 6174 696f 6e2c 2061  configuration, a
│ │ │ │ -000182d0: 6e64 2073 746f 7265 2069 7420 696e 2074  nd store it in t
│ │ │ │ -000182e0: 6865 2061 7574 6865 6e74 6963 6174 6f72  he authenticator
│ │ │ │ -000182f0: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ -00018300: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ -00018310: 5348 4953 4849 5f4f 4b20 6966 6620 7375  SHISHI_OK iff su
│ │ │ │ -00018320: 6363 6573 7366 756c 2e0a 0a73 6869 7368  ccessful...shish
│ │ │ │ -00018330: 695f 6175 7468 656e 7469 6361 746f 725f  i_authenticator_
│ │ │ │ -00018340: 6164 645f 7261 6e64 6f6d 5f73 7562 6b65  add_random_subke
│ │ │ │ -00018350: 795f 6574 7970 650a 2d2d 2d2d 2d2d 2d2d  y_etype.--------
│ │ │ │ +00018160: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ +00018170: 6f6e 3a20 696e 7420 7368 6973 6869 5f61  on: int shishi_a
│ │ │ │ +00018180: 7574 6865 6e74 6963 6174 6f72 5f61 6464  uthenticator_add
│ │ │ │ +00018190: 5f72 616e 646f 6d5f 7375 626b 6579 0a20  _random_subkey. 
│ │ │ │ +000181a0: 2020 2020 2020 2020 2028 5368 6973 6869           (Shishi
│ │ │ │ +000181b0: 202a 2048 414e 444c 452c 2053 6869 7368   * HANDLE, Shish
│ │ │ │ +000181c0: 695f 6173 6e31 2041 5554 4845 4e54 4943  i_asn1 AUTHENTIC
│ │ │ │ +000181d0: 4154 4f52 290a 2020 2020 2048 414e 444c  ATOR).     HANDL
│ │ │ │ +000181e0: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ +000181f0: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ +00018200: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ +00018210: 29e2 8099 2e0a 2020 2020 2041 5554 4845  ).....     AUTHE
│ │ │ │ +00018220: 4e54 4943 4154 4f52 3a20 6175 7468 656e  NTICATOR: authen
│ │ │ │ +00018230: 7469 6361 746f 7220 6173 2061 6c6c 6f63  ticator as alloc
│ │ │ │ +00018240: 6174 6564 2062 790a 2020 2020 20e2 8098  ated by.     ...
│ │ │ │ +00018250: 7368 6973 6869 5f61 7574 6865 6e74 6963  shishi_authentic
│ │ │ │ +00018260: 6174 6f72 2829 e280 992e 0a0a 2020 2020  ator()......    
│ │ │ │ +00018270: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ +00018280: 4765 6e65 7261 7465 2072 616e 646f 6d20  Generate random 
│ │ │ │ +00018290: 7375 626b 6579 2c20 6f66 2074 6865 2064  subkey, of the d
│ │ │ │ +000182a0: 6566 6175 6c74 2065 6e63 7279 7074 696f  efault encryptio
│ │ │ │ +000182b0: 6e0a 2020 2020 2074 7970 6520 6672 6f6d  n.     type from
│ │ │ │ +000182c0: 2063 6f6e 6669 6775 7261 7469 6f6e 2c20   configuration, 
│ │ │ │ +000182d0: 616e 6420 7374 6f72 6520 6974 2069 6e20  and store it in 
│ │ │ │ +000182e0: 7468 6520 6175 7468 656e 7469 6361 746f  the authenticato
│ │ │ │ +000182f0: 722e 0a0a 2020 2020 202a 5265 7475 726e  r...     *Return
│ │ │ │ +00018300: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ +00018310: 2053 4849 5348 495f 4f4b 2069 6666 2073   SHISHI_OK iff s
│ │ │ │ +00018320: 7563 6365 7373 6675 6c2e 0a0a 7368 6973  uccessful...shis
│ │ │ │ +00018330: 6869 5f61 7574 6865 6e74 6963 6174 6f72  hi_authenticator
│ │ │ │ +00018340: 5f61 6464 5f72 616e 646f 6d5f 7375 626b  _add_random_subk
│ │ │ │ +00018350: 6579 5f65 7479 7065 0a2d 2d2d 2d2d 2d2d  ey_etype.-------
│ │ │ │  00018360: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │  00018370: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00018380: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -00018390: 6f6e 3a20 696e 7420 7368 6973 6869 5f61  on: int shishi_a
│ │ │ │ -000183a0: 7574 6865 6e74 6963 6174 6f72 5f61 6464  uthenticator_add
│ │ │ │ -000183b0: 5f72 616e 646f 6d5f 7375 626b 6579 5f65  _random_subkey_e
│ │ │ │ -000183c0: 7479 7065 0a20 2020 2020 2020 2020 2028  type.          (
│ │ │ │ -000183d0: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ -000183e0: 2053 6869 7368 695f 6173 6e31 2041 5554   Shishi_asn1 AUT
│ │ │ │ -000183f0: 4845 4e54 4943 4154 4f52 2c20 696e 7420  HENTICATOR, int 
│ │ │ │ -00018400: 4554 5950 4529 0a20 2020 2020 4841 4e44  ETYPE).     HAND
│ │ │ │ -00018410: 4c45 3a20 7368 6973 6869 2068 616e 646c  LE: shishi handl
│ │ │ │ -00018420: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ -00018430: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ -00018440: 2829 e280 992e 0a20 2020 2020 4155 5448  ().....     AUTH
│ │ │ │ -00018450: 454e 5449 4341 544f 523a 2061 7574 6865  ENTICATOR: authe
│ │ │ │ -00018460: 6e74 6963 6174 6f72 2061 7320 616c 6c6f  nticator as allo
│ │ │ │ -00018470: 6361 7465 6420 6279 0a20 2020 2020 e280  cated by.     ..
│ │ │ │ -00018480: 9873 6869 7368 695f 6175 7468 656e 7469  .shishi_authenti
│ │ │ │ -00018490: 6361 746f 7228 29e2 8099 2e0a 2020 2020  cator().....    
│ │ │ │ -000184a0: 2045 5459 5045 3a20 656e 6372 7970 7469   ETYPE: encrypti
│ │ │ │ -000184b0: 6f6e 2074 7970 6520 6f66 2072 616e 646f  on type of rando
│ │ │ │ -000184c0: 6d20 6b65 7920 746f 2067 656e 6572 6174  m key to generat
│ │ │ │ -000184d0: 652e 0a0a 2020 2020 202a 4465 7363 7269  e...     *Descri
│ │ │ │ -000184e0: 7074 696f 6e3a 2a20 4765 6e65 7261 7465  ption:* Generate
│ │ │ │ -000184f0: 2072 616e 646f 6d20 7375 626b 6579 206f   random subkey o
│ │ │ │ -00018500: 6620 696e 6469 6361 7465 6420 656e 6372  f indicated encr
│ │ │ │ -00018510: 7970 7469 6f6e 2074 7970 652c 0a20 2020  yption type,.   
│ │ │ │ -00018520: 2020 616e 6420 7374 6f72 6520 6974 2069    and store it i
│ │ │ │ -00018530: 6e20 7468 6520 6175 7468 656e 7469 6361  n the authentica
│ │ │ │ -00018540: 746f 722e 0a0a 2020 2020 202a 5265 7475  tor...     *Retu
│ │ │ │ -00018550: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ -00018560: 6e73 2053 4849 5348 495f 4f4b 2069 6666  ns SHISHI_OK iff
│ │ │ │ -00018570: 2073 7563 6365 7373 6675 6c2e 0a0a 7368   successful...sh
│ │ │ │ -00018580: 6973 6869 5f61 7574 6865 6e74 6963 6174  ishi_authenticat
│ │ │ │ -00018590: 6f72 5f61 6464 5f73 7562 6b65 790a 2d2d  or_add_subkey.--
│ │ │ │ +00018380: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +00018390: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ +000183a0: 6175 7468 656e 7469 6361 746f 725f 6164  authenticator_ad
│ │ │ │ +000183b0: 645f 7261 6e64 6f6d 5f73 7562 6b65 795f  d_random_subkey_
│ │ │ │ +000183c0: 6574 7970 650a 2020 2020 2020 2020 2020  etype.          
│ │ │ │ +000183d0: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ +000183e0: 2c20 5368 6973 6869 5f61 736e 3120 4155  , Shishi_asn1 AU
│ │ │ │ +000183f0: 5448 454e 5449 4341 544f 522c 2069 6e74  THENTICATOR, int
│ │ │ │ +00018400: 2045 5459 5045 290a 2020 2020 2048 414e   ETYPE).     HAN
│ │ │ │ +00018410: 444c 453a 2073 6869 7368 6920 6861 6e64  DLE: shishi hand
│ │ │ │ +00018420: 6c65 2061 7320 616c 6c6f 6361 7465 6420  le as allocated 
│ │ │ │ +00018430: 6279 20e2 8098 7368 6973 6869 5f69 6e69  by ...shishi_ini
│ │ │ │ +00018440: 7428 29e2 8099 2e0a 2020 2020 2041 5554  t().....     AUT
│ │ │ │ +00018450: 4845 4e54 4943 4154 4f52 3a20 6175 7468  HENTICATOR: auth
│ │ │ │ +00018460: 656e 7469 6361 746f 7220 6173 2061 6c6c  enticator as all
│ │ │ │ +00018470: 6f63 6174 6564 2062 790a 2020 2020 20e2  ocated by.     .
│ │ │ │ +00018480: 8098 7368 6973 6869 5f61 7574 6865 6e74  ..shishi_authent
│ │ │ │ +00018490: 6963 6174 6f72 2829 e280 992e 0a20 2020  icator().....   
│ │ │ │ +000184a0: 2020 4554 5950 453a 2065 6e63 7279 7074    ETYPE: encrypt
│ │ │ │ +000184b0: 696f 6e20 7479 7065 206f 6620 7261 6e64  ion type of rand
│ │ │ │ +000184c0: 6f6d 206b 6579 2074 6f20 6765 6e65 7261  om key to genera
│ │ │ │ +000184d0: 7465 2e0a 0a20 2020 2020 2a44 6573 6372  te...     *Descr
│ │ │ │ +000184e0: 6970 7469 6f6e 3a2a 2047 656e 6572 6174  iption:* Generat
│ │ │ │ +000184f0: 6520 7261 6e64 6f6d 2073 7562 6b65 7920  e random subkey 
│ │ │ │ +00018500: 6f66 2069 6e64 6963 6174 6564 2065 6e63  of indicated enc
│ │ │ │ +00018510: 7279 7074 696f 6e20 7479 7065 2c0a 2020  ryption type,.  
│ │ │ │ +00018520: 2020 2061 6e64 2073 746f 7265 2069 7420     and store it 
│ │ │ │ +00018530: 696e 2074 6865 2061 7574 6865 6e74 6963  in the authentic
│ │ │ │ +00018540: 6174 6f72 2e0a 0a20 2020 2020 2a52 6574  ator...     *Ret
│ │ │ │ +00018550: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ +00018560: 726e 7320 5348 4953 4849 5f4f 4b20 6966  rns SHISHI_OK if
│ │ │ │ +00018570: 6620 7375 6363 6573 7366 756c 2e0a 0a73  f successful...s
│ │ │ │ +00018580: 6869 7368 695f 6175 7468 656e 7469 6361  hishi_authentica
│ │ │ │ +00018590: 746f 725f 6164 645f 7375 626b 6579 0a2d  tor_add_subkey.-
│ │ │ │  000185a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000185b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -000185c0: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ -000185d0: 2073 6869 7368 695f 6175 7468 656e 7469   shishi_authenti
│ │ │ │ -000185e0: 6361 746f 725f 6164 645f 7375 626b 6579  cator_add_subkey
│ │ │ │ -000185f0: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ -00018600: 452c 0a20 2020 2020 2020 2020 2053 6869  E,.          Shi
│ │ │ │ -00018610: 7368 695f 6173 6e31 2041 5554 4845 4e54  shi_asn1 AUTHENT
│ │ │ │ -00018620: 4943 4154 4f52 2c20 5368 6973 6869 5f6b  ICATOR, Shishi_k
│ │ │ │ -00018630: 6579 202a 2053 5542 4b45 5929 0a20 2020  ey * SUBKEY).   
│ │ │ │ -00018640: 2020 4841 4e44 4c45 3a20 7368 6973 6869    HANDLE: shishi
│ │ │ │ -00018650: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ -00018660: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ -00018670: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ -00018680: 2020 4155 5448 454e 5449 4341 544f 523a    AUTHENTICATOR:
│ │ │ │ -00018690: 2061 7574 6865 6e74 6963 6174 6f72 2061   authenticator a
│ │ │ │ -000186a0: 7320 616c 6c6f 6361 7465 6420 6279 0a20  s allocated by. 
│ │ │ │ -000186b0: 2020 2020 e280 9873 6869 7368 695f 6175      ...shishi_au
│ │ │ │ -000186c0: 7468 656e 7469 6361 746f 7228 29e2 8099  thenticator()...
│ │ │ │ -000186d0: 2e0a 2020 2020 2053 5542 4b45 593a 2073  ..     SUBKEY: s
│ │ │ │ -000186e0: 7562 6b65 7920 746f 2061 6464 2074 6f20  ubkey to add to 
│ │ │ │ -000186f0: 6175 7468 656e 7469 6361 746f 722e 0a0a  authenticator...
│ │ │ │ -00018700: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ -00018710: 6e3a 2a20 5374 6f72 6520 7375 626b 6579  n:* Store subkey
│ │ │ │ -00018720: 2069 6e20 7468 6520 6175 7468 656e 7469   in the authenti
│ │ │ │ -00018730: 6361 746f 722e 0a0a 2020 2020 202a 5265  cator...     *Re
│ │ │ │ -00018740: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ -00018750: 7572 6e73 2053 4849 5348 495f 4f4b 2069  urns SHISHI_OK i
│ │ │ │ -00018760: 6666 2073 7563 6365 7373 6675 6c2e 0a0a  ff successful...
│ │ │ │ -00018770: 1f0a 4669 6c65 3a20 7368 6973 6869 2e69  ..File: shishi.i
│ │ │ │ -00018780: 6e66 6f2c 2020 4e6f 6465 3a20 4b52 422d  nfo,  Node: KRB-
│ │ │ │ -00018790: 4552 524f 5220 4675 6e63 7469 6f6e 732c  ERROR Functions,
│ │ │ │ -000187a0: 2020 4e65 7874 3a20 4372 7970 746f 6772    Next: Cryptogr
│ │ │ │ -000187b0: 6170 6869 6320 4675 6e63 7469 6f6e 732c  aphic Functions,
│ │ │ │ -000187c0: 2020 5072 6576 3a20 4175 7468 656e 7469    Prev: Authenti
│ │ │ │ -000187d0: 6361 746f 7220 4675 6e63 7469 6f6e 732c  cator Functions,
│ │ │ │ -000187e0: 2020 5570 3a20 5072 6f67 7261 6d6d 696e    Up: Programmin
│ │ │ │ -000187f0: 6720 4d61 6e75 616c 0a0a 352e 3132 204b  g Manual..5.12 K
│ │ │ │ -00018800: 5242 2d45 5252 4f52 2046 756e 6374 696f  RB-ERROR Functio
│ │ │ │ -00018810: 6e73 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ns.=============
│ │ │ │ -00018820: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a54 6865  ===========..The
│ │ │ │ -00018830: 2022 4b52 422d 4552 524f 5222 2069 7320   "KRB-ERROR" is 
│ │ │ │ -00018840: 616e 2041 534e 2e31 2073 7472 7563 7475  an ASN.1 structu
│ │ │ │ -00018850: 7265 2074 6861 7420 6361 6e20 6265 2072  re that can be r
│ │ │ │ -00018860: 6574 7572 6e65 642c 2069 6e73 7465 6164  eturned, instead
│ │ │ │ -00018870: 206f 662c 0a65 2e67 2e2c 204b 4443 2d52   of,.e.g., KDC-R
│ │ │ │ -00018880: 4550 206f 7220 4150 2d52 4550 2c20 746f  EP or AP-REP, to
│ │ │ │ -00018890: 2069 6e64 6963 6174 6520 7661 7269 6f75   indicate variou
│ │ │ │ -000188a0: 7320 6572 726f 7220 636f 6e64 6974 696f  s error conditio
│ │ │ │ -000188b0: 6e73 2e0a 556e 666f 7274 756e 6174 656c  ns..Unfortunatel
│ │ │ │ -000188c0: 792c 2074 6865 2073 656d 616e 7469 6373  y, the semantics
│ │ │ │ -000188d0: 206f 6620 7365 7665 7261 6c20 6f66 2074   of several of t
│ │ │ │ -000188e0: 6865 2066 6965 6c64 7320 6172 6520 696c  he fields are il
│ │ │ │ -000188f0: 6c20 7370 6563 6966 6965 642c 0a73 6f20  l specified,.so 
│ │ │ │ -00018900: 7468 6520 7479 7069 6361 6c6c 7920 7072  the typically pr
│ │ │ │ -00018910: 6f63 6564 7572 6520 6973 2074 6f20 6578  ocedure is to ex
│ │ │ │ -00018920: 7472 6163 7420 2265 2d74 6578 7422 2061  tract "e-text" a
│ │ │ │ -00018930: 6e64 2f6f 7220 2265 2d64 6174 6122 2061  nd/or "e-data" a
│ │ │ │ -00018940: 6e64 0a73 686f 7720 6974 2074 6f20 7468  nd.show it to th
│ │ │ │ -00018950: 6520 7573 6572 2e20 2054 6865 2066 6f6c  e user.  The fol
│ │ │ │ -00018960: 6c6f 7769 6e67 2069 6c6c 7573 7472 6174  lowing illustrat
│ │ │ │ -00018970: 6573 2074 6865 204b 5242 2d45 5252 4f52  es the KRB-ERROR
│ │ │ │ -00018980: 2041 534e 2e31 0a73 7472 7563 7475 7265   ASN.1.structure
│ │ │ │ -00018990: 2e0a 0a4b 5242 2d45 5252 4f52 2020 2020  ...KRB-ERROR    
│ │ │ │ -000189a0: 2020 203a 3a3d 205b 4150 504c 4943 4154     ::= [APPLICAT
│ │ │ │ -000189b0: 494f 4e20 3330 5d20 5345 5155 454e 4345  ION 30] SEQUENCE
│ │ │ │ -000189c0: 207b 0a20 2020 2020 2020 2070 766e 6f20   {.        pvno 
│ │ │ │ -000189d0: 2020 2020 2020 2020 2020 205b 305d 2049             [0] I
│ │ │ │ -000189e0: 4e54 4547 4552 2028 3529 2c0a 2020 2020  NTEGER (5),.    
│ │ │ │ -000189f0: 2020 2020 6d73 672d 7479 7065 2020 2020      msg-type    
│ │ │ │ -00018a00: 2020 2020 5b31 5d20 494e 5445 4745 5220      [1] INTEGER 
│ │ │ │ -00018a10: 2833 3029 2c0a 2020 2020 2020 2020 6374  (30),.        ct
│ │ │ │ -00018a20: 696d 6520 2020 2020 2020 2020 2020 5b32  ime           [2
│ │ │ │ -00018a30: 5d20 4b65 7262 6572 6f73 5469 6d65 204f  ] KerberosTime O
│ │ │ │ -00018a40: 5054 494f 4e41 4c2c 0a20 2020 2020 2020  PTIONAL,.       
│ │ │ │ -00018a50: 2063 7573 6563 2020 2020 2020 2020 2020   cusec          
│ │ │ │ -00018a60: 205b 335d 204d 6963 726f 7365 636f 6e64   [3] Microsecond
│ │ │ │ -00018a70: 7320 4f50 5449 4f4e 414c 2c0a 2020 2020  s OPTIONAL,.    
│ │ │ │ -00018a80: 2020 2020 7374 696d 6520 2020 2020 2020      stime       
│ │ │ │ -00018a90: 2020 2020 5b34 5d20 4b65 7262 6572 6f73      [4] Kerberos
│ │ │ │ -00018aa0: 5469 6d65 2c0a 2020 2020 2020 2020 7375  Time,.        su
│ │ │ │ -00018ab0: 7365 6320 2020 2020 2020 2020 2020 5b35  sec           [5
│ │ │ │ -00018ac0: 5d20 4d69 6372 6f73 6563 6f6e 6473 2c0a  ] Microseconds,.
│ │ │ │ -00018ad0: 2020 2020 2020 2020 6572 726f 722d 636f          error-co
│ │ │ │ -00018ae0: 6465 2020 2020 2020 5b36 5d20 496e 7433  de      [6] Int3
│ │ │ │ -00018af0: 322c 0a20 2020 2020 2020 2063 7265 616c  2,.        creal
│ │ │ │ -00018b00: 6d20 2020 2020 2020 2020 205b 375d 2052  m          [7] R
│ │ │ │ -00018b10: 6561 6c6d 204f 5054 494f 4e41 4c2c 0a20  ealm OPTIONAL,. 
│ │ │ │ -00018b20: 2020 2020 2020 2063 6e61 6d65 2020 2020         cname    
│ │ │ │ -00018b30: 2020 2020 2020 205b 385d 2050 7269 6e63         [8] Princ
│ │ │ │ -00018b40: 6970 616c 4e61 6d65 204f 5054 494f 4e41  ipalName OPTIONA
│ │ │ │ -00018b50: 4c2c 0a20 2020 2020 2020 2072 6561 6c6d  L,.        realm
│ │ │ │ -00018b60: 2020 2020 2020 2020 2020 205b 395d 2052             [9] R
│ │ │ │ -00018b70: 6561 6c6d 202d 2d20 7365 7276 6963 6520  ealm -- service 
│ │ │ │ -00018b80: 7265 616c 6d20 2d2d 2c0a 2020 2020 2020  realm --,.      
│ │ │ │ -00018b90: 2020 736e 616d 6520 2020 2020 2020 2020    sname         
│ │ │ │ -00018ba0: 2020 5b31 305d 2050 7269 6e63 6970 616c    [10] Principal
│ │ │ │ -00018bb0: 4e61 6d65 202d 2d20 7365 7276 6963 6520  Name -- service 
│ │ │ │ -00018bc0: 6e61 6d65 202d 2d2c 0a20 2020 2020 2020  name --,.       
│ │ │ │ -00018bd0: 2065 2d74 6578 7420 2020 2020 2020 2020   e-text         
│ │ │ │ -00018be0: 205b 3131 5d20 4b65 7262 6572 6f73 5374   [11] KerberosSt
│ │ │ │ -00018bf0: 7269 6e67 204f 5054 494f 4e41 4c2c 0a20  ring OPTIONAL,. 
│ │ │ │ -00018c00: 2020 2020 2020 2065 2d64 6174 6120 2020         e-data   
│ │ │ │ -00018c10: 2020 2020 2020 205b 3132 5d20 4f43 5445         [12] OCTE
│ │ │ │ -00018c20: 5420 5354 5249 4e47 204f 5054 494f 4e41  T STRING OPTIONA
│ │ │ │ -00018c30: 4c0a 7d0a 0a73 6869 7368 695f 6b72 6265  L.}..shishi_krbe
│ │ │ │ -00018c40: 7272 6f72 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  rror.-----------
│ │ │ │ -00018c50: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -00018c60: 6f6e 3a20 5368 6973 6869 5f61 736e 3120  on: Shishi_asn1 
│ │ │ │ -00018c70: 7368 6973 6869 5f6b 7262 6572 726f 7220  shishi_krberror 
│ │ │ │ -00018c80: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ -00018c90: 290a 2020 2020 2048 414e 444c 453a 2073  ).     HANDLE: s
│ │ │ │ -00018ca0: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ -00018cb0: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ -00018cc0: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ -00018cd0: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ -00018ce0: 7469 6f6e 3a2a 2054 6869 7320 6675 6e63  tion:* This func
│ │ │ │ -00018cf0: 7469 6f6e 2063 7265 6174 6573 2061 206e  tion creates a n
│ │ │ │ -00018d00: 6577 204b 5242 2d45 5252 4f52 2c20 706f  ew KRB-ERROR, po
│ │ │ │ -00018d10: 7075 6c61 7465 640a 2020 2020 2077 6974  pulated.     wit
│ │ │ │ -00018d20: 6820 736f 6d65 2064 6566 6175 6c74 2076  h some default v
│ │ │ │ -00018d30: 616c 7565 732e 0a0a 2020 2020 202a 5265  alues...     *Re
│ │ │ │ -00018d40: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ -00018d50: 7572 6e73 2074 6865 204b 5242 2d45 5252  urns the KRB-ERR
│ │ │ │ -00018d60: 4f52 206f 7220 4e55 4c4c 206f 6e20 6661  OR or NULL on fa
│ │ │ │ -00018d70: 696c 7572 652e 0a0a 7368 6973 6869 5f6b  ilure...shishi_k
│ │ │ │ -00018d80: 7262 6572 726f 725f 7072 696e 740a 2d2d  rberror_print.--
│ │ │ │ +000185b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ +000185c0: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ +000185d0: 7420 7368 6973 6869 5f61 7574 6865 6e74  t shishi_authent
│ │ │ │ +000185e0: 6963 6174 6f72 5f61 6464 5f73 7562 6b65  icator_add_subke
│ │ │ │ +000185f0: 7920 2853 6869 7368 6920 2a20 4841 4e44  y (Shishi * HAND
│ │ │ │ +00018600: 4c45 2c0a 2020 2020 2020 2020 2020 5368  LE,.          Sh
│ │ │ │ +00018610: 6973 6869 5f61 736e 3120 4155 5448 454e  ishi_asn1 AUTHEN
│ │ │ │ +00018620: 5449 4341 544f 522c 2053 6869 7368 695f  TICATOR, Shishi_
│ │ │ │ +00018630: 6b65 7920 2a20 5355 424b 4559 290a 2020  key * SUBKEY).  
│ │ │ │ +00018640: 2020 2048 414e 444c 453a 2073 6869 7368     HANDLE: shish
│ │ │ │ +00018650: 6920 6861 6e64 6c65 2061 7320 616c 6c6f  i handle as allo
│ │ │ │ +00018660: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ +00018670: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ +00018680: 2020 2041 5554 4845 4e54 4943 4154 4f52     AUTHENTICATOR
│ │ │ │ +00018690: 3a20 6175 7468 656e 7469 6361 746f 7220  : authenticator 
│ │ │ │ +000186a0: 6173 2061 6c6c 6f63 6174 6564 2062 790a  as allocated by.
│ │ │ │ +000186b0: 2020 2020 20e2 8098 7368 6973 6869 5f61       ...shishi_a
│ │ │ │ +000186c0: 7574 6865 6e74 6963 6174 6f72 2829 e280  uthenticator()..
│ │ │ │ +000186d0: 992e 0a20 2020 2020 5355 424b 4559 3a20  ...     SUBKEY: 
│ │ │ │ +000186e0: 7375 626b 6579 2074 6f20 6164 6420 746f  subkey to add to
│ │ │ │ +000186f0: 2061 7574 6865 6e74 6963 6174 6f72 2e0a   authenticator..
│ │ │ │ +00018700: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +00018710: 6f6e 3a2a 2053 746f 7265 2073 7562 6b65  on:* Store subke
│ │ │ │ +00018720: 7920 696e 2074 6865 2061 7574 6865 6e74  y in the authent
│ │ │ │ +00018730: 6963 6174 6f72 2e0a 0a20 2020 2020 2a52  icator...     *R
│ │ │ │ +00018740: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +00018750: 7475 726e 7320 5348 4953 4849 5f4f 4b20  turns SHISHI_OK 
│ │ │ │ +00018760: 6966 6620 7375 6363 6573 7366 756c 2e0a  iff successful..
│ │ │ │ +00018770: 0a1f 0a46 696c 653a 2073 6869 7368 692e  ...File: shishi.
│ │ │ │ +00018780: 696e 666f 2c20 204e 6f64 653a 204b 5242  info,  Node: KRB
│ │ │ │ +00018790: 2d45 5252 4f52 2046 756e 6374 696f 6e73  -ERROR Functions
│ │ │ │ +000187a0: 2c20 204e 6578 743a 2043 7279 7074 6f67  ,  Next: Cryptog
│ │ │ │ +000187b0: 7261 7068 6963 2046 756e 6374 696f 6e73  raphic Functions
│ │ │ │ +000187c0: 2c20 2050 7265 763a 2041 7574 6865 6e74  ,  Prev: Authent
│ │ │ │ +000187d0: 6963 6174 6f72 2046 756e 6374 696f 6e73  icator Functions
│ │ │ │ +000187e0: 2c20 2055 703a 2050 726f 6772 616d 6d69  ,  Up: Programmi
│ │ │ │ +000187f0: 6e67 204d 616e 7561 6c0a 0a35 2e31 3220  ng Manual..5.12 
│ │ │ │ +00018800: 4b52 422d 4552 524f 5220 4675 6e63 7469  KRB-ERROR Functi
│ │ │ │ +00018810: 6f6e 730a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ons.============
│ │ │ │ +00018820: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 5468  ============..Th
│ │ │ │ +00018830: 6520 224b 5242 2d45 5252 4f52 2220 6973  e "KRB-ERROR" is
│ │ │ │ +00018840: 2061 6e20 4153 4e2e 3120 7374 7275 6374   an ASN.1 struct
│ │ │ │ +00018850: 7572 6520 7468 6174 2063 616e 2062 6520  ure that can be 
│ │ │ │ +00018860: 7265 7475 726e 6564 2c20 696e 7374 6561  returned, instea
│ │ │ │ +00018870: 6420 6f66 2c0a 652e 672e 2c20 4b44 432d  d of,.e.g., KDC-
│ │ │ │ +00018880: 5245 5020 6f72 2041 502d 5245 502c 2074  REP or AP-REP, t
│ │ │ │ +00018890: 6f20 696e 6469 6361 7465 2076 6172 696f  o indicate vario
│ │ │ │ +000188a0: 7573 2065 7272 6f72 2063 6f6e 6469 7469  us error conditi
│ │ │ │ +000188b0: 6f6e 732e 0a55 6e66 6f72 7475 6e61 7465  ons..Unfortunate
│ │ │ │ +000188c0: 6c79 2c20 7468 6520 7365 6d61 6e74 6963  ly, the semantic
│ │ │ │ +000188d0: 7320 6f66 2073 6576 6572 616c 206f 6620  s of several of 
│ │ │ │ +000188e0: 7468 6520 6669 656c 6473 2061 7265 2069  the fields are i
│ │ │ │ +000188f0: 6c6c 2073 7065 6369 6669 6564 2c0a 736f  ll specified,.so
│ │ │ │ +00018900: 2074 6865 2074 7970 6963 616c 6c79 2070   the typically p
│ │ │ │ +00018910: 726f 6365 6475 7265 2069 7320 746f 2065  rocedure is to e
│ │ │ │ +00018920: 7874 7261 6374 2022 652d 7465 7874 2220  xtract "e-text" 
│ │ │ │ +00018930: 616e 642f 6f72 2022 652d 6461 7461 2220  and/or "e-data" 
│ │ │ │ +00018940: 616e 640a 7368 6f77 2069 7420 746f 2074  and.show it to t
│ │ │ │ +00018950: 6865 2075 7365 722e 2020 5468 6520 666f  he user.  The fo
│ │ │ │ +00018960: 6c6c 6f77 696e 6720 696c 6c75 7374 7261  llowing illustra
│ │ │ │ +00018970: 7465 7320 7468 6520 4b52 422d 4552 524f  tes the KRB-ERRO
│ │ │ │ +00018980: 5220 4153 4e2e 310a 7374 7275 6374 7572  R ASN.1.structur
│ │ │ │ +00018990: 652e 0a0a 4b52 422d 4552 524f 5220 2020  e...KRB-ERROR   
│ │ │ │ +000189a0: 2020 2020 3a3a 3d20 5b41 5050 4c49 4341      ::= [APPLICA
│ │ │ │ +000189b0: 5449 4f4e 2033 305d 2053 4551 5545 4e43  TION 30] SEQUENC
│ │ │ │ +000189c0: 4520 7b0a 2020 2020 2020 2020 7076 6e6f  E {.        pvno
│ │ │ │ +000189d0: 2020 2020 2020 2020 2020 2020 5b30 5d20              [0] 
│ │ │ │ +000189e0: 494e 5445 4745 5220 2835 292c 0a20 2020  INTEGER (5),.   
│ │ │ │ +000189f0: 2020 2020 206d 7367 2d74 7970 6520 2020       msg-type   
│ │ │ │ +00018a00: 2020 2020 205b 315d 2049 4e54 4547 4552       [1] INTEGER
│ │ │ │ +00018a10: 2028 3330 292c 0a20 2020 2020 2020 2063   (30),.        c
│ │ │ │ +00018a20: 7469 6d65 2020 2020 2020 2020 2020 205b  time           [
│ │ │ │ +00018a30: 325d 204b 6572 6265 726f 7354 696d 6520  2] KerberosTime 
│ │ │ │ +00018a40: 4f50 5449 4f4e 414c 2c0a 2020 2020 2020  OPTIONAL,.      
│ │ │ │ +00018a50: 2020 6375 7365 6320 2020 2020 2020 2020    cusec         
│ │ │ │ +00018a60: 2020 5b33 5d20 4d69 6372 6f73 6563 6f6e    [3] Microsecon
│ │ │ │ +00018a70: 6473 204f 5054 494f 4e41 4c2c 0a20 2020  ds OPTIONAL,.   
│ │ │ │ +00018a80: 2020 2020 2073 7469 6d65 2020 2020 2020       stime      
│ │ │ │ +00018a90: 2020 2020 205b 345d 204b 6572 6265 726f       [4] Kerbero
│ │ │ │ +00018aa0: 7354 696d 652c 0a20 2020 2020 2020 2073  sTime,.        s
│ │ │ │ +00018ab0: 7573 6563 2020 2020 2020 2020 2020 205b  usec           [
│ │ │ │ +00018ac0: 355d 204d 6963 726f 7365 636f 6e64 732c  5] Microseconds,
│ │ │ │ +00018ad0: 0a20 2020 2020 2020 2065 7272 6f72 2d63  .        error-c
│ │ │ │ +00018ae0: 6f64 6520 2020 2020 205b 365d 2049 6e74  ode      [6] Int
│ │ │ │ +00018af0: 3332 2c0a 2020 2020 2020 2020 6372 6561  32,.        crea
│ │ │ │ +00018b00: 6c6d 2020 2020 2020 2020 2020 5b37 5d20  lm          [7] 
│ │ │ │ +00018b10: 5265 616c 6d20 4f50 5449 4f4e 414c 2c0a  Realm OPTIONAL,.
│ │ │ │ +00018b20: 2020 2020 2020 2020 636e 616d 6520 2020          cname   
│ │ │ │ +00018b30: 2020 2020 2020 2020 5b38 5d20 5072 696e          [8] Prin
│ │ │ │ +00018b40: 6369 7061 6c4e 616d 6520 4f50 5449 4f4e  cipalName OPTION
│ │ │ │ +00018b50: 414c 2c0a 2020 2020 2020 2020 7265 616c  AL,.        real
│ │ │ │ +00018b60: 6d20 2020 2020 2020 2020 2020 5b39 5d20  m           [9] 
│ │ │ │ +00018b70: 5265 616c 6d20 2d2d 2073 6572 7669 6365  Realm -- service
│ │ │ │ +00018b80: 2072 6561 6c6d 202d 2d2c 0a20 2020 2020   realm --,.     
│ │ │ │ +00018b90: 2020 2073 6e61 6d65 2020 2020 2020 2020     sname        
│ │ │ │ +00018ba0: 2020 205b 3130 5d20 5072 696e 6369 7061     [10] Principa
│ │ │ │ +00018bb0: 6c4e 616d 6520 2d2d 2073 6572 7669 6365  lName -- service
│ │ │ │ +00018bc0: 206e 616d 6520 2d2d 2c0a 2020 2020 2020   name --,.      
│ │ │ │ +00018bd0: 2020 652d 7465 7874 2020 2020 2020 2020    e-text        
│ │ │ │ +00018be0: 2020 5b31 315d 204b 6572 6265 726f 7353    [11] KerberosS
│ │ │ │ +00018bf0: 7472 696e 6720 4f50 5449 4f4e 414c 2c0a  tring OPTIONAL,.
│ │ │ │ +00018c00: 2020 2020 2020 2020 652d 6461 7461 2020          e-data  
│ │ │ │ +00018c10: 2020 2020 2020 2020 5b31 325d 204f 4354          [12] OCT
│ │ │ │ +00018c20: 4554 2053 5452 494e 4720 4f50 5449 4f4e  ET STRING OPTION
│ │ │ │ +00018c30: 414c 0a7d 0a0a 7368 6973 6869 5f6b 7262  AL.}..shishi_krb
│ │ │ │ +00018c40: 6572 726f 720a 2d2d 2d2d 2d2d 2d2d 2d2d  error.----------
│ │ │ │ +00018c50: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +00018c60: 696f 6e3a 2053 6869 7368 695f 6173 6e31  ion: Shishi_asn1
│ │ │ │ +00018c70: 2073 6869 7368 695f 6b72 6265 7272 6f72   shishi_krberror
│ │ │ │ +00018c80: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ +00018c90: 4529 0a20 2020 2020 4841 4e44 4c45 3a20  E).     HANDLE: 
│ │ │ │ +00018ca0: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ +00018cb0: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ +00018cc0: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ +00018cd0: 992e 0a0a 2020 2020 202a 4465 7363 7269  ....     *Descri
│ │ │ │ +00018ce0: 7074 696f 6e3a 2a20 5468 6973 2066 756e  ption:* This fun
│ │ │ │ +00018cf0: 6374 696f 6e20 6372 6561 7465 7320 6120  ction creates a 
│ │ │ │ +00018d00: 6e65 7720 4b52 422d 4552 524f 522c 2070  new KRB-ERROR, p
│ │ │ │ +00018d10: 6f70 756c 6174 6564 0a20 2020 2020 7769  opulated.     wi
│ │ │ │ +00018d20: 7468 2073 6f6d 6520 6465 6661 756c 7420  th some default 
│ │ │ │ +00018d30: 7661 6c75 6573 2e0a 0a20 2020 2020 2a52  values...     *R
│ │ │ │ +00018d40: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +00018d50: 7475 726e 7320 7468 6520 4b52 422d 4552  turns the KRB-ER
│ │ │ │ +00018d60: 524f 5220 6f72 204e 554c 4c20 6f6e 2066  ROR or NULL on f
│ │ │ │ +00018d70: 6169 6c75 7265 2e0a 0a73 6869 7368 695f  ailure...shishi_
│ │ │ │ +00018d80: 6b72 6265 7272 6f72 5f70 7269 6e74 0a2d  krberror_print.-
│ │ │ │  00018d90: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00018da0: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ -00018db0: 6e3a 2069 6e74 2073 6869 7368 695f 6b72  n: int shishi_kr
│ │ │ │ -00018dc0: 6265 7272 6f72 5f70 7269 6e74 2028 5368  berror_print (Sh
│ │ │ │ -00018dd0: 6973 6869 202a 2048 414e 444c 452c 2046  ishi * HANDLE, F
│ │ │ │ -00018de0: 494c 4520 2a20 4648 2c0a 2020 2020 2020  ILE * FH,.      
│ │ │ │ -00018df0: 2020 2020 5368 6973 6869 5f61 736e 3120      Shishi_asn1 
│ │ │ │ -00018e00: 4b52 4245 5252 4f52 290a 2020 2020 2048  KRBERROR).     H
│ │ │ │ -00018e10: 414e 444c 453a 2073 6869 7368 6920 6861  ANDLE: shishi ha
│ │ │ │ -00018e20: 6e64 6c65 2061 7320 616c 6c6f 6361 7465  ndle as allocate
│ │ │ │ -00018e30: 6420 6279 20e2 8098 7368 6973 6869 5f69  d by ...shishi_i
│ │ │ │ -00018e40: 6e69 7428 29e2 8099 2e0a 2020 2020 2046  nit().....     F
│ │ │ │ -00018e50: 483a 2066 696c 6520 6861 6e64 6c65 206f  H: file handle o
│ │ │ │ -00018e60: 7065 6e20 666f 7220 7772 6974 696e 672e  pen for writing.
│ │ │ │ -00018e70: 0a20 2020 2020 4b52 4245 5252 4f52 3a20  .     KRBERROR: 
│ │ │ │ -00018e80: 4b52 422d 4552 524f 5220 746f 2070 7269  KRB-ERROR to pri
│ │ │ │ -00018e90: 6e74 2e0a 0a20 2020 2020 2a44 6573 6372  nt...     *Descr
│ │ │ │ -00018ea0: 6970 7469 6f6e 3a2a 2050 7269 6e74 2041  iption:* Print A
│ │ │ │ -00018eb0: 5343 4949 2061 726d 6f72 6564 2044 4552  SCII armored DER
│ │ │ │ -00018ec0: 2065 6e63 6f64 696e 6720 6f66 204b 5242   encoding of KRB
│ │ │ │ -00018ed0: 2d45 5252 4f52 2074 6f0a 2020 2020 2066  -ERROR to.     f
│ │ │ │ -00018ee0: 696c 652e 0a0a 2020 2020 202a 5265 7475  ile...     *Retu
│ │ │ │ -00018ef0: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ -00018f00: 6e73 2053 4849 5348 495f 4f4b 2069 6666  ns SHISHI_OK iff
│ │ │ │ -00018f10: 2073 7563 6365 7373 6675 6c2e 0a0a 7368   successful...sh
│ │ │ │ -00018f20: 6973 6869 5f6b 7262 6572 726f 725f 7361  ishi_krberror_sa
│ │ │ │ -00018f30: 7665 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ve.-------------
│ │ │ │ -00018f40: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ -00018f50: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ -00018f60: 695f 6b72 6265 7272 6f72 5f73 6176 6520  i_krberror_save 
│ │ │ │ -00018f70: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ -00018f80: 2c20 4649 4c45 202a 2046 482c 0a20 2020  , FILE * FH,.   
│ │ │ │ -00018f90: 2020 2020 2020 2053 6869 7368 695f 6173         Shishi_as
│ │ │ │ -00018fa0: 6e31 204b 5242 4552 524f 5229 0a20 2020  n1 KRBERROR).   
│ │ │ │ -00018fb0: 2020 4841 4e44 4c45 3a20 7368 6973 6869    HANDLE: shishi
│ │ │ │ -00018fc0: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ -00018fd0: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ -00018fe0: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ -00018ff0: 2020 4648 3a20 6669 6c65 2068 616e 646c    FH: file handl
│ │ │ │ -00019000: 6520 6f70 656e 2066 6f72 2077 7269 7469  e open for writi
│ │ │ │ -00019010: 6e67 2e0a 2020 2020 204b 5242 4552 524f  ng..     KRBERRO
│ │ │ │ -00019020: 523a 204b 5242 2d45 5252 4f52 2074 6f20  R: KRB-ERROR to 
│ │ │ │ -00019030: 7361 7665 2e0a 0a20 2020 2020 2a44 6573  save...     *Des
│ │ │ │ -00019040: 6372 6970 7469 6f6e 3a2a 2053 6176 6520  cription:* Save 
│ │ │ │ -00019050: 4445 5220 656e 636f 6469 6e67 206f 6620  DER encoding of 
│ │ │ │ -00019060: 4b52 422d 4552 524f 5220 746f 2066 696c  KRB-ERROR to fil
│ │ │ │ -00019070: 652e 0a0a 2020 2020 202a 5265 7475 726e  e...     *Return
│ │ │ │ -00019080: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ -00019090: 2053 4849 5348 495f 4f4b 2069 6666 2073   SHISHI_OK iff s
│ │ │ │ -000190a0: 7563 6365 7373 6675 6c2e 0a0a 7368 6973  uccessful...shis
│ │ │ │ -000190b0: 6869 5f6b 7262 6572 726f 725f 746f 5f66  hi_krberror_to_f
│ │ │ │ -000190c0: 696c 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ile.------------
│ │ │ │ -000190d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ -000190e0: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ -000190f0: 6869 7368 695f 6b72 6265 7272 6f72 5f74  hishi_krberror_t
│ │ │ │ -00019100: 6f5f 6669 6c65 2028 5368 6973 6869 202a  o_file (Shishi *
│ │ │ │ -00019110: 2048 414e 444c 452c 0a20 2020 2020 2020   HANDLE,.       
│ │ │ │ -00019120: 2020 2053 6869 7368 695f 6173 6e31 204b     Shishi_asn1 K
│ │ │ │ -00019130: 5242 4552 524f 522c 2069 6e74 2046 494c  RBERROR, int FIL
│ │ │ │ -00019140: 4554 5950 452c 2063 6f6e 7374 2063 6861  ETYPE, const cha
│ │ │ │ -00019150: 7220 2a20 4649 4c45 4e41 4d45 290a 2020  r * FILENAME).  
│ │ │ │ -00019160: 2020 2048 414e 444c 453a 2073 6869 7368     HANDLE: shish
│ │ │ │ -00019170: 6920 6861 6e64 6c65 2061 7320 616c 6c6f  i handle as allo
│ │ │ │ -00019180: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ -00019190: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ -000191a0: 2020 204b 5242 4552 524f 523a 204b 5242     KRBERROR: KRB
│ │ │ │ -000191b0: 2d45 5252 4f52 2074 6f20 7361 7665 2e0a  -ERROR to save..
│ │ │ │ -000191c0: 2020 2020 2046 494c 4554 5950 453a 2069       FILETYPE: i
│ │ │ │ -000191d0: 6e70 7574 2076 6172 6961 626c 6520 7370  nput variable sp
│ │ │ │ -000191e0: 6563 6966 7969 6e67 2074 7970 6520 6f66  ecifying type of
│ │ │ │ -000191f0: 2066 696c 6520 746f 2062 6520 7772 6974   file to be writ
│ │ │ │ -00019200: 7465 6e2c 2073 6565 0a20 2020 2020 5368  ten, see.     Sh
│ │ │ │ -00019210: 6973 6869 5f66 696c 6574 7970 652e 0a20  ishi_filetype.. 
│ │ │ │ -00019220: 2020 2020 4649 4c45 4e41 4d45 3a20 696e      FILENAME: in
│ │ │ │ -00019230: 7075 7420 7661 7269 6162 6c65 2077 6974  put variable wit
│ │ │ │ -00019240: 6820 6669 6c65 6e61 6d65 2074 6f20 7772  h filename to wr
│ │ │ │ -00019250: 6974 6520 746f 2e0a 0a20 2020 2020 2a44  ite to...     *D
│ │ │ │ -00019260: 6573 6372 6970 7469 6f6e 3a2a 2057 7269  escription:* Wri
│ │ │ │ -00019270: 7465 204b 5242 2d45 5252 4f52 2074 6f20  te KRB-ERROR to 
│ │ │ │ -00019280: 6669 6c65 2069 6e20 7370 6563 6966 6965  file in specifie
│ │ │ │ -00019290: 6420 5459 5045 2e20 5468 6520 6669 6c65  d TYPE. The file
│ │ │ │ -000192a0: 0a20 2020 2020 7769 6c6c 2062 6520 7472  .     will be tr
│ │ │ │ -000192b0: 756e 6361 7465 6420 6966 2069 7420 6578  uncated if it ex
│ │ │ │ -000192c0: 6973 7473 2e0a 0a20 2020 2020 2a52 6574  ists...     *Ret
│ │ │ │ -000192d0: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ -000192e0: 726e 7320 5348 4953 4849 5f4f 4b20 6966  rns SHISHI_OK if
│ │ │ │ -000192f0: 6620 7375 6363 6573 7366 756c 2e0a 0a73  f successful...s
│ │ │ │ -00019300: 6869 7368 695f 6b72 6265 7272 6f72 5f70  hishi_krberror_p
│ │ │ │ -00019310: 6172 7365 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  arse.-----------
│ │ │ │ -00019320: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ -00019330: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ -00019340: 6973 6869 5f6b 7262 6572 726f 725f 7061  ishi_krberror_pa
│ │ │ │ -00019350: 7273 6520 2853 6869 7368 6920 2a20 4841  rse (Shishi * HA
│ │ │ │ -00019360: 4e44 4c45 2c20 4649 4c45 202a 2046 482c  NDLE, FILE * FH,
│ │ │ │ -00019370: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ -00019380: 695f 6173 6e31 202a 204b 5242 4552 524f  i_asn1 * KRBERRO
│ │ │ │ -00019390: 5229 0a20 2020 2020 4841 4e44 4c45 3a20  R).     HANDLE: 
│ │ │ │ -000193a0: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ -000193b0: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ -000193c0: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ -000193d0: 992e 0a20 2020 2020 4648 3a20 6669 6c65  ...     FH: file
│ │ │ │ -000193e0: 2068 616e 646c 6520 6f70 656e 2066 6f72   handle open for
│ │ │ │ -000193f0: 2072 6561 6469 6e67 2e0a 2020 2020 204b   reading..     K
│ │ │ │ -00019400: 5242 4552 524f 523a 206f 7574 7075 7420  RBERROR: output 
│ │ │ │ -00019410: 7661 7269 6162 6c65 2077 6974 6820 6e65  variable with ne
│ │ │ │ -00019420: 776c 7920 616c 6c6f 6361 7465 6420 4b52  wly allocated KR
│ │ │ │ -00019430: 422d 4552 524f 522e 0a0a 2020 2020 202a  B-ERROR...     *
│ │ │ │ -00019440: 4465 7363 7269 7074 696f 6e3a 2a20 5265  Description:* Re
│ │ │ │ -00019450: 6164 2041 5343 4949 2061 726d 6f72 6564  ad ASCII armored
│ │ │ │ -00019460: 2044 4552 2065 6e63 6f64 6564 204b 5242   DER encoded KRB
│ │ │ │ -00019470: 2d45 5252 4f52 2066 726f 6d20 6669 6c65  -ERROR from file
│ │ │ │ -00019480: 0a20 2020 2020 616e 6420 706f 7075 6c61  .     and popula
│ │ │ │ -00019490: 7465 2067 6976 656e 2076 6172 6961 626c  te given variabl
│ │ │ │ -000194a0: 652e 0a0a 2020 2020 202a 5265 7475 726e  e...     *Return
│ │ │ │ -000194b0: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ -000194c0: 2053 4849 5348 495f 4f4b 2069 6666 2073   SHISHI_OK iff s
│ │ │ │ -000194d0: 7563 6365 7373 6675 6c2e 0a0a 7368 6973  uccessful...shis
│ │ │ │ -000194e0: 6869 5f6b 7262 6572 726f 725f 7265 6164  hi_krberror_read
│ │ │ │ -000194f0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ -00019500: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ -00019510: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ -00019520: 6b72 6265 7272 6f72 5f72 6561 6420 2853  krberror_read (S
│ │ │ │ -00019530: 6869 7368 6920 2a20 4841 4e44 4c45 2c20  hishi * HANDLE, 
│ │ │ │ -00019540: 4649 4c45 202a 2046 482c 0a20 2020 2020  FILE * FH,.     
│ │ │ │ -00019550: 2020 2020 2053 6869 7368 695f 6173 6e31       Shishi_asn1
│ │ │ │ -00019560: 202a 204b 5242 4552 524f 5229 0a20 2020   * KRBERROR).   
│ │ │ │ -00019570: 2020 4841 4e44 4c45 3a20 7368 6973 6869    HANDLE: shishi
│ │ │ │ -00019580: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ -00019590: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ -000195a0: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ -000195b0: 2020 4648 3a20 6669 6c65 2068 616e 646c    FH: file handl
│ │ │ │ -000195c0: 6520 6f70 656e 2066 6f72 2072 6561 6469  e open for readi
│ │ │ │ -000195d0: 6e67 2e0a 2020 2020 204b 5242 4552 524f  ng..     KRBERRO
│ │ │ │ -000195e0: 523a 206f 7574 7075 7420 7661 7269 6162  R: output variab
│ │ │ │ -000195f0: 6c65 2077 6974 6820 6e65 776c 7920 616c  le with newly al
│ │ │ │ -00019600: 6c6f 6361 7465 6420 4b52 422d 4552 524f  located KRB-ERRO
│ │ │ │ -00019610: 522e 0a0a 2020 2020 202a 4465 7363 7269  R...     *Descri
│ │ │ │ -00019620: 7074 696f 6e3a 2a20 5265 6164 2044 4552  ption:* Read DER
│ │ │ │ -00019630: 2065 6e63 6f64 6564 204b 5242 2d45 5252   encoded KRB-ERR
│ │ │ │ -00019640: 4f52 2066 726f 6d20 6669 6c65 2061 6e64  OR from file and
│ │ │ │ -00019650: 2070 6f70 756c 6174 650a 2020 2020 2067   populate.     g
│ │ │ │ -00019660: 6976 656e 2076 6172 6961 626c 652e 0a0a  iven variable...
│ │ │ │ -00019670: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ -00019680: 7565 3a2a 2052 6574 7572 6e73 2053 4849  ue:* Returns SHI
│ │ │ │ -00019690: 5348 495f 4f4b 2069 6666 2073 7563 6365  SHI_OK iff succe
│ │ │ │ -000196a0: 7373 6675 6c2e 0a0a 7368 6973 6869 5f6b  ssful...shishi_k
│ │ │ │ -000196b0: 7262 6572 726f 725f 6672 6f6d 5f66 696c  rberror_from_fil
│ │ │ │ -000196c0: 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  e.--------------
│ │ │ │ -000196d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ -000196e0: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ -000196f0: 6869 7368 695f 6b72 6265 7272 6f72 5f66  hishi_krberror_f
│ │ │ │ -00019700: 726f 6d5f 6669 6c65 2028 5368 6973 6869  rom_file (Shishi
│ │ │ │ -00019710: 202a 2048 414e 444c 452c 0a20 2020 2020   * HANDLE,.     
│ │ │ │ -00019720: 2020 2020 2053 6869 7368 695f 6173 6e31       Shishi_asn1
│ │ │ │ -00019730: 202a 204b 5242 4552 524f 522c 2069 6e74   * KRBERROR, int
│ │ │ │ -00019740: 2046 494c 4554 5950 452c 2063 6f6e 7374   FILETYPE, const
│ │ │ │ -00019750: 2063 6861 7220 2a20 4649 4c45 4e41 4d45   char * FILENAME
│ │ │ │ -00019760: 290a 2020 2020 2048 414e 444c 453a 2073  ).     HANDLE: s
│ │ │ │ -00019770: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ -00019780: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ -00019790: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ -000197a0: 2e0a 2020 2020 204b 5242 4552 524f 523a  ..     KRBERROR:
│ │ │ │ -000197b0: 206f 7574 7075 7420 7661 7269 6162 6c65   output variable
│ │ │ │ -000197c0: 2077 6974 6820 6e65 776c 7920 616c 6c6f   with newly allo
│ │ │ │ -000197d0: 6361 7465 6420 4b52 422d 4552 524f 522e  cated KRB-ERROR.
│ │ │ │ -000197e0: 0a20 2020 2020 4649 4c45 5459 5045 3a20  .     FILETYPE: 
│ │ │ │ -000197f0: 696e 7075 7420 7661 7269 6162 6c65 2073  input variable s
│ │ │ │ -00019800: 7065 6369 6679 696e 6720 7479 7065 206f  pecifying type o
│ │ │ │ -00019810: 6620 6669 6c65 2074 6f20 6265 2072 6561  f file to be rea
│ │ │ │ -00019820: 642c 2073 6565 0a20 2020 2020 5368 6973  d, see.     Shis
│ │ │ │ -00019830: 6869 5f66 696c 6574 7970 652e 0a20 2020  hi_filetype..   
│ │ │ │ -00019840: 2020 4649 4c45 4e41 4d45 3a20 696e 7075    FILENAME: inpu
│ │ │ │ -00019850: 7420 7661 7269 6162 6c65 2077 6974 6820  t variable with 
│ │ │ │ -00019860: 6669 6c65 6e61 6d65 2074 6f20 7265 6164  filename to read
│ │ │ │ -00019870: 2066 726f 6d2e 0a0a 2020 2020 202a 4465   from...     *De
│ │ │ │ -00019880: 7363 7269 7074 696f 6e3a 2a20 5265 6164  scription:* Read
│ │ │ │ -00019890: 204b 5242 2d45 5252 4f52 2066 726f 6d20   KRB-ERROR from 
│ │ │ │ -000198a0: 6669 6c65 2069 6e20 7370 6563 6966 6965  file in specifie
│ │ │ │ -000198b0: 6420 5459 5045 2e0a 0a20 2020 2020 2a52  d TYPE...     *R
│ │ │ │ -000198c0: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ -000198d0: 7475 726e 7320 5348 4953 4849 5f4f 4b20  turns SHISHI_OK 
│ │ │ │ -000198e0: 6966 6620 7375 6363 6573 7366 756c 2e0a  iff successful..
│ │ │ │ -000198f0: 0a73 6869 7368 695f 6b72 6265 7272 6f72  .shishi_krberror
│ │ │ │ -00019900: 5f62 7569 6c64 0a2d 2d2d 2d2d 2d2d 2d2d  _build.---------
│ │ │ │ -00019910: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ -00019920: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ -00019930: 7368 6973 6869 5f6b 7262 6572 726f 725f  shishi_krberror_
│ │ │ │ -00019940: 6275 696c 6420 2853 6869 7368 6920 2a20  build (Shishi * 
│ │ │ │ -00019950: 4841 4e44 4c45 2c0a 2020 2020 2020 2020  HANDLE,.        
│ │ │ │ -00019960: 2020 5368 6973 6869 5f61 736e 3120 4b52    Shishi_asn1 KR
│ │ │ │ -00019970: 4245 5252 4f52 290a 2020 2020 2048 414e  BERROR).     HAN
│ │ │ │ -00019980: 444c 453a 2073 6869 7368 6920 6861 6e64  DLE: shishi hand
│ │ │ │ -00019990: 6c65 2061 7320 616c 6c6f 6361 7465 6420  le as allocated 
│ │ │ │ -000199a0: 6279 20e2 8098 7368 6973 6869 5f69 6e69  by ...shishi_ini
│ │ │ │ -000199b0: 7428 29e2 8099 2e0a 2020 2020 204b 5242  t().....     KRB
│ │ │ │ -000199c0: 4552 524f 523a 206b 7262 6572 726f 7220  ERROR: krberror 
│ │ │ │ -000199d0: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ -000199e0: e280 9873 6869 7368 695f 6b72 6265 7272  ...shishi_krberr
│ │ │ │ -000199f0: 6f72 2829 e280 992e 0a0a 2020 2020 202a  or()......     *
│ │ │ │ -00019a00: 4465 7363 7269 7074 696f 6e3a 2a20 4669  Description:* Fi
│ │ │ │ -00019a10: 6e69 7368 204b 5242 2d45 5252 4f52 2c20  nish KRB-ERROR, 
│ │ │ │ -00019a20: 6361 6c6c 6564 2062 6566 6f72 6520 652e  called before e.
│ │ │ │ -00019a30: 672e 0a20 2020 2020 7368 6973 6869 5f6b  g..     shishi_k
│ │ │ │ -00019a40: 7262 6572 726f 725f 6465 722e 2020 5468  rberror_der.  Th
│ │ │ │ -00019a50: 6973 2066 756e 6374 696f 6e20 7265 6d6f  is function remo
│ │ │ │ -00019a60: 7665 7320 656d 7074 7920 6275 7420 4f50  ves empty but OP
│ │ │ │ -00019a70: 5449 4f4e 414c 0a20 2020 2020 6669 656c  TIONAL.     fiel
│ │ │ │ -00019a80: 6473 2028 7375 6368 2061 7320 636e 616d  ds (such as cnam
│ │ │ │ -00019a90: 6529 2c20 616e 640a 0a20 2020 2020 2a52  e), and..     *R
│ │ │ │ -00019aa0: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ -00019ab0: 7475 726e 7320 5348 4953 4849 5f4f 4b20  turns SHISHI_OK 
│ │ │ │ -00019ac0: 6966 6620 7375 6363 6573 7366 756c 2e0a  iff successful..
│ │ │ │ -00019ad0: 0a73 6869 7368 695f 6b72 6265 7272 6f72  .shishi_krberror
│ │ │ │ -00019ae0: 5f64 6572 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  _der.-----------
│ │ │ │ -00019af0: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -00019b00: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ -00019b10: 6869 5f6b 7262 6572 726f 725f 6465 7220  hi_krberror_der 
│ │ │ │ -00019b20: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ -00019b30: 2c0a 2020 2020 2020 2020 2020 5368 6973  ,.          Shis
│ │ │ │ -00019b40: 6869 5f61 736e 3120 4b52 4245 5252 4f52  hi_asn1 KRBERROR
│ │ │ │ -00019b50: 2c20 6368 6172 202a 2a20 4f55 542c 2073  , char ** OUT, s
│ │ │ │ -00019b60: 697a 655f 7420 2a20 4f55 544c 454e 290a  ize_t * OUTLEN).
│ │ │ │ -00019b70: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ -00019b80: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ -00019b90: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ -00019ba0: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ -00019bb0: 2020 2020 204b 5242 4552 524f 523a 206b       KRBERROR: k
│ │ │ │ -00019bc0: 7262 6572 726f 7220 6173 2061 6c6c 6f63  rberror as alloc
│ │ │ │ -00019bd0: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ -00019be0: 695f 6b72 6265 7272 6f72 2829 e280 992e  i_krberror()....
│ │ │ │ -00019bf0: 0a20 2020 2020 4f55 543a 206f 7574 7075  .     OUT: outpu
│ │ │ │ -00019c00: 7420 6172 7261 7920 7769 7468 206e 6577  t array with new
│ │ │ │ -00019c10: 6c79 2061 6c6c 6f63 6174 6564 2044 4552  ly allocated DER
│ │ │ │ -00019c20: 2065 6e63 6f64 696e 6720 6f66 204b 5242   encoding of KRB
│ │ │ │ -00019c30: 2d45 5252 4f52 2e0a 2020 2020 204f 5554  -ERROR..     OUT
│ │ │ │ -00019c40: 4c45 4e3a 206c 656e 6774 6820 6f66 206f  LEN: length of o
│ │ │ │ -00019c50: 7574 7075 7420 6172 7261 7920 7769 7468  utput array with
│ │ │ │ -00019c60: 2044 4552 2065 6e63 6f64 696e 6720 6f66   DER encoding of
│ │ │ │ -00019c70: 204b 5242 2d45 5252 4f52 2e0a 0a20 2020   KRB-ERROR...   
│ │ │ │ -00019c80: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ -00019c90: 2044 4552 2065 6e63 6f64 6520 4b52 422d   DER encode KRB-
│ │ │ │ -00019ca0: 4552 524f 522e 2054 6865 2063 616c 6c65  ERROR. The calle
│ │ │ │ -00019cb0: 7220 6d75 7374 2064 6561 6c6c 6f63 6174  r must deallocat
│ │ │ │ -00019cc0: 6520 7468 650a 2020 2020 204f 5554 2062  e the.     OUT b
│ │ │ │ -00019cd0: 7566 6665 722e 0a0a 2020 2020 202a 5265  uffer...     *Re
│ │ │ │ -00019ce0: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ -00019cf0: 7572 6e73 2053 4849 5348 495f 4f4b 2069  urns SHISHI_OK i
│ │ │ │ -00019d00: 6666 2073 7563 6365 7373 6675 6c2e 0a0a  ff successful...
│ │ │ │ -00019d10: 7368 6973 6869 5f6b 7262 6572 726f 725f  shishi_krberror_
│ │ │ │ -00019d20: 6372 6561 6c6d 0a2d 2d2d 2d2d 2d2d 2d2d  crealm.---------
│ │ │ │ -00019d30: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -00019d40: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ -00019d50: 2073 6869 7368 695f 6b72 6265 7272 6f72   shishi_krberror
│ │ │ │ -00019d60: 5f63 7265 616c 6d20 2853 6869 7368 6920  _crealm (Shishi 
│ │ │ │ -00019d70: 2a20 4841 4e44 4c45 2c0a 2020 2020 2020  * HANDLE,.      
│ │ │ │ -00019d80: 2020 2020 5368 6973 6869 5f61 736e 3120      Shishi_asn1 
│ │ │ │ -00019d90: 4b52 4245 5252 4f52 2c20 6368 6172 202a  KRBERROR, char *
│ │ │ │ -00019da0: 2a20 5245 414c 4d2c 2073 697a 655f 7420  * REALM, size_t 
│ │ │ │ -00019db0: 2a20 5245 414c 4d4c 454e 290a 2020 2020  * REALMLEN).    
│ │ │ │ -00019dc0: 2048 414e 444c 453a 2073 6869 7368 6920   HANDLE: shishi 
│ │ │ │ -00019dd0: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ -00019de0: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ -00019df0: 5f69 6e69 7428 29e2 8099 2e0a 2020 2020  _init().....    
│ │ │ │ -00019e00: 204b 5242 4552 524f 523a 206b 7262 6572   KRBERROR: krber
│ │ │ │ -00019e10: 726f 7220 6173 2061 6c6c 6f63 6174 6564  ror as allocated
│ │ │ │ -00019e20: 2062 7920 e280 9873 6869 7368 695f 6b72   by ...shishi_kr
│ │ │ │ -00019e30: 6265 7272 6f72 2829 e280 992e 0a20 2020  berror().....   
│ │ │ │ -00019e40: 2020 5245 414c 4d3a 206f 7574 7075 7420    REALM: output 
│ │ │ │ -00019e50: 6172 7261 7920 7769 7468 206e 6577 6c79  array with newly
│ │ │ │ -00019e60: 2061 6c6c 6f63 6174 6564 206e 616d 6520   allocated name 
│ │ │ │ -00019e70: 6f66 2072 6561 6c6d 2069 6e0a 2020 2020  of realm in.    
│ │ │ │ -00019e80: 204b 5242 2d45 5252 4f52 2e0a 2020 2020   KRB-ERROR..    
│ │ │ │ -00019e90: 2052 4541 4c4d 4c45 4e3a 2073 697a 6520   REALMLEN: size 
│ │ │ │ -00019ea0: 6f66 206f 7574 7075 7420 6172 7261 792e  of output array.
│ │ │ │ -00019eb0: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ -00019ec0: 696f 6e3a 2a20 4578 7472 6163 7420 636c  ion:* Extract cl
│ │ │ │ -00019ed0: 6965 6e74 2072 6561 6c6d 2066 726f 6d20  ient realm from 
│ │ │ │ -00019ee0: 4b52 422d 4552 524f 522e 0a0a 2020 2020  KRB-ERROR...    
│ │ │ │ -00019ef0: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ -00019f00: 2052 6574 7572 6e73 2053 4849 5348 495f   Returns SHISHI_
│ │ │ │ -00019f10: 4f4b 2069 6666 2073 7563 6365 7373 6675  OK iff successfu
│ │ │ │ -00019f20: 6c2e 0a0a 7368 6973 6869 5f6b 7262 6572  l...shishi_krber
│ │ │ │ -00019f30: 726f 725f 7265 6d6f 7665 5f63 7265 616c  ror_remove_creal
│ │ │ │ -00019f40: 6d0a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  m.--------------
│ │ │ │ -00019f50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -00019f60: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ -00019f70: 6e74 2073 6869 7368 695f 6b72 6265 7272  nt shishi_krberr
│ │ │ │ -00019f80: 6f72 5f72 656d 6f76 655f 6372 6561 6c6d  or_remove_crealm
│ │ │ │ -00019f90: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ -00019fa0: 452c 0a20 2020 2020 2020 2020 2053 6869  E,.          Shi
│ │ │ │ -00019fb0: 7368 695f 6173 6e31 204b 5242 4552 524f  shi_asn1 KRBERRO
│ │ │ │ -00019fc0: 5229 0a20 2020 2020 4841 4e44 4c45 3a20  R).     HANDLE: 
│ │ │ │ -00019fd0: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ -00019fe0: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ -00019ff0: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ -0001a000: 992e 0a20 2020 2020 4b52 4245 5252 4f52  ...     KRBERROR
│ │ │ │ -0001a010: 3a20 6b72 6265 7272 6f72 2061 7320 616c  : krberror as al
│ │ │ │ -0001a020: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ -0001a030: 6973 6869 5f6b 7262 6572 726f 7228 29e2  ishi_krberror().
│ │ │ │ -0001a040: 8099 2e0a 0a20 2020 2020 2a44 6573 6372  .....     *Descr
│ │ │ │ -0001a050: 6970 7469 6f6e 3a2a 2052 656d 6f76 6520  iption:* Remove 
│ │ │ │ -0001a060: 636c 6965 6e74 2072 6561 6c6d 2066 6965  client realm fie
│ │ │ │ -0001a070: 6c64 2069 6e20 4b52 422d 4552 524f 522e  ld in KRB-ERROR.
│ │ │ │ -0001a080: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ -0001a090: 616c 7565 3a2a 2052 6574 7572 6e73 2053  alue:* Returns S
│ │ │ │ -0001a0a0: 4849 5348 495f 4f4b 2069 6666 2073 7563  HISHI_OK iff suc
│ │ │ │ -0001a0b0: 6365 7373 6675 6c2e 0a0a 7368 6973 6869  cessful...shishi
│ │ │ │ -0001a0c0: 5f6b 7262 6572 726f 725f 7365 745f 6372  _krberror_set_cr
│ │ │ │ -0001a0d0: 6561 6c6d 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  ealm.-----------
│ │ │ │ -0001a0e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -0001a0f0: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ -0001a100: 6e74 2073 6869 7368 695f 6b72 6265 7272  nt shishi_krberr
│ │ │ │ -0001a110: 6f72 5f73 6574 5f63 7265 616c 6d20 2853  or_set_crealm (S
│ │ │ │ -0001a120: 6869 7368 6920 2a20 4841 4e44 4c45 2c0a  hishi * HANDLE,.
│ │ │ │ -0001a130: 2020 2020 2020 2020 2020 5368 6973 6869            Shishi
│ │ │ │ -0001a140: 5f61 736e 3120 4b52 4245 5252 4f52 2c20  _asn1 KRBERROR, 
│ │ │ │ -0001a150: 636f 6e73 7420 6368 6172 202a 2043 5245  const char * CRE
│ │ │ │ -0001a160: 414c 4d29 0a20 2020 2020 4841 4e44 4c45  ALM).     HANDLE
│ │ │ │ -0001a170: 3a20 7368 6973 6869 2068 616e 646c 6520  : shishi handle 
│ │ │ │ -0001a180: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ -0001a190: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ -0001a1a0: e280 992e 0a20 2020 2020 4b52 4245 5252  .....     KRBERR
│ │ │ │ -0001a1b0: 4f52 3a20 6b72 6265 7272 6f72 2061 7320  OR: krberror as 
│ │ │ │ -0001a1c0: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ -0001a1d0: 7368 6973 6869 5f6b 7262 6572 726f 7228  shishi_krberror(
│ │ │ │ -0001a1e0: 29e2 8099 2e0a 2020 2020 2043 5245 414c  ).....     CREAL
│ │ │ │ -0001a1f0: 4d3a 2069 6e70 7574 2061 7272 6179 2077  M: input array w
│ │ │ │ -0001a200: 6974 6820 7265 616c 6d2e 0a0a 2020 2020  ith realm...    
│ │ │ │ -0001a210: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ -0001a220: 5365 7420 7265 616c 6d20 6669 656c 6420  Set realm field 
│ │ │ │ -0001a230: 696e 206b 7262 6572 726f 7220 746f 2073  in krberror to s
│ │ │ │ -0001a240: 7065 6369 6669 6564 2076 616c 7565 2e0a  pecified value..
│ │ │ │ -0001a250: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ -0001a260: 6c75 653a 2a20 5265 7475 726e 7320 5348  lue:* Returns SH
│ │ │ │ -0001a270: 4953 4849 5f4f 4b20 6966 6620 7375 6363  ISHI_OK iff succ
│ │ │ │ -0001a280: 6573 7366 756c 2e0a 0a73 6869 7368 695f  essful...shishi_
│ │ │ │ -0001a290: 6b72 6265 7272 6f72 5f63 6c69 656e 740a  krberror_client.
│ │ │ │ -0001a2a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0001a2b0: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ -0001a2c0: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ -0001a2d0: 5f6b 7262 6572 726f 725f 636c 6965 6e74  _krberror_client
│ │ │ │ -0001a2e0: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ -0001a2f0: 452c 0a20 2020 2020 2020 2020 2053 6869  E,.          Shi
│ │ │ │ -0001a300: 7368 695f 6173 6e31 204b 5242 4552 524f  shi_asn1 KRBERRO
│ │ │ │ -0001a310: 522c 2063 6861 7220 2a2a 2043 4c49 454e  R, char ** CLIEN
│ │ │ │ -0001a320: 542c 2073 697a 655f 7420 2a20 434c 4945  T, size_t * CLIE
│ │ │ │ -0001a330: 4e54 4c45 4e29 0a20 2020 2020 4841 4e44  NTLEN).     HAND
│ │ │ │ -0001a340: 4c45 3a20 7368 6973 6869 2068 616e 646c  LE: shishi handl
│ │ │ │ -0001a350: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ -0001a360: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ -0001a370: 2829 e280 992e 0a20 2020 2020 4b52 4245  ().....     KRBE
│ │ │ │ -0001a380: 5252 4f52 3a20 6b72 6265 7272 6f72 2061  RROR: krberror a
│ │ │ │ -0001a390: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ -0001a3a0: 8098 7368 6973 6869 5f6b 7262 6572 726f  ..shishi_krberro
│ │ │ │ -0001a3b0: 7228 29e2 8099 2e0a 2020 2020 2043 4c49  r().....     CLI
│ │ │ │ -0001a3c0: 454e 543a 2070 6f69 6e74 6572 2074 6f20  ENT: pointer to 
│ │ │ │ -0001a3d0: 6e65 776c 7920 616c 6c6f 6361 7465 6420  newly allocated 
│ │ │ │ -0001a3e0: 7a65 726f 2074 6572 6d69 6e61 7465 6420  zero terminated 
│ │ │ │ -0001a3f0: 7374 7269 6e67 0a20 2020 2020 636f 6e74  string.     cont
│ │ │ │ -0001a400: 6169 6e69 6e67 2070 7269 6e63 6970 616c  aining principal
│ │ │ │ -0001a410: 206e 616d 652e 2020 4d61 7920 6265 20e2   name.  May be .
│ │ │ │ -0001a420: 8098 4e55 4c4c e280 9920 2874 6f20 6f6e  ..NULL... (to on
│ │ │ │ -0001a430: 6c79 2070 6f70 756c 6174 650a 2020 2020  ly populate.    
│ │ │ │ -0001a440: 2043 4c49 454e 544c 454e 292e 0a20 2020   CLIENTLEN)..   
│ │ │ │ -0001a450: 2020 434c 4945 4e54 4c45 4e3a 2070 6f69    CLIENTLEN: poi
│ │ │ │ -0001a460: 6e74 6572 2074 6f20 6c65 6e67 7468 206f  nter to length o
│ │ │ │ -0001a470: 6620 434c 4945 4e54 206f 6e20 6f75 7470  f CLIENT on outp
│ │ │ │ -0001a480: 7574 2c20 6578 636c 7564 696e 670a 2020  ut, excluding.  
│ │ │ │ -0001a490: 2020 2074 6572 6d69 6e61 7469 6e67 207a     terminating z
│ │ │ │ -0001a4a0: 6572 6f2e 2020 4d61 7920 6265 20e2 8098  ero.  May be ...
│ │ │ │ -0001a4b0: 4e55 4c4c e280 9920 2874 6f20 6f6e 6c79  NULL... (to only
│ │ │ │ -0001a4c0: 2070 6f70 756c 6174 6520 434c 4945 4e54   populate CLIENT
│ │ │ │ -0001a4d0: 292e 0a0a 2020 2020 202a 4465 7363 7269  )...     *Descri
│ │ │ │ -0001a4e0: 7074 696f 6e3a 2a20 5265 7475 726e 2063  ption:* Return c
│ │ │ │ -0001a4f0: 6c69 656e 7420 7072 696e 6369 7061 6c20  lient principal 
│ │ │ │ -0001a500: 6e61 6d65 2069 6e20 4b52 422d 4552 524f  name in KRB-ERRO
│ │ │ │ -0001a510: 522e 0a0a 2020 2020 202a 5265 7475 726e  R...     *Return
│ │ │ │ -0001a520: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ -0001a530: 2053 4849 5348 495f 4f4b 2069 6666 2073   SHISHI_OK iff s
│ │ │ │ -0001a540: 7563 6365 7373 6675 6c2e 0a0a 7368 6973  uccessful...shis
│ │ │ │ -0001a550: 6869 5f6b 7262 6572 726f 725f 7365 745f  hi_krberror_set_
│ │ │ │ -0001a560: 636e 616d 650a 2d2d 2d2d 2d2d 2d2d 2d2d  cname.----------
│ │ │ │ -0001a570: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -0001a580: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ -0001a590: 6e74 2073 6869 7368 695f 6b72 6265 7272  nt shishi_krberr
│ │ │ │ -0001a5a0: 6f72 5f73 6574 5f63 6e61 6d65 2028 5368  or_set_cname (Sh
│ │ │ │ -0001a5b0: 6973 6869 202a 2048 414e 444c 452c 0a20  ishi * HANDLE,. 
│ │ │ │ -0001a5c0: 2020 2020 2020 2020 2053 6869 7368 695f           Shishi_
│ │ │ │ -0001a5d0: 6173 6e31 204b 5242 4552 524f 522c 2053  asn1 KRBERROR, S
│ │ │ │ -0001a5e0: 6869 7368 695f 6e61 6d65 5f74 7970 6520  hishi_name_type 
│ │ │ │ -0001a5f0: 4e41 4d45 5f54 5950 452c 0a20 2020 2020  NAME_TYPE,.     
│ │ │ │ -0001a600: 2020 2020 2063 6f6e 7374 2063 6861 7220       const char 
│ │ │ │ -0001a610: 2a20 434e 414d 455b 5d29 0a20 2020 2020  * CNAME[]).     
│ │ │ │ -0001a620: 4841 4e44 4c45 3a20 7368 6973 6869 2068  HANDLE: shishi h
│ │ │ │ -0001a630: 616e 646c 6520 6173 2061 6c6c 6f63 6174  andle as allocat
│ │ │ │ -0001a640: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ -0001a650: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ -0001a660: 4b52 4245 5252 4f52 3a20 6b72 6265 7272  KRBERROR: krberr
│ │ │ │ -0001a670: 6f72 2061 7320 616c 6c6f 6361 7465 6420  or as allocated 
│ │ │ │ -0001a680: 6279 20e2 8098 7368 6973 6869 5f6b 7262  by ...shishi_krb
│ │ │ │ -0001a690: 6572 726f 7228 29e2 8099 2e0a 2020 2020  error().....    
│ │ │ │ -0001a6a0: 204e 414d 455f 5459 5045 3a20 7479 7065   NAME_TYPE: type
│ │ │ │ -0001a6b0: 206f 6620 7072 696e 6369 7069 616c 2c20   of principial, 
│ │ │ │ -0001a6c0: 7365 6520 5368 6973 6869 5f6e 616d 655f  see Shishi_name_
│ │ │ │ -0001a6d0: 7479 7065 2c20 7573 7561 6c6c 790a 2020  type, usually.  
│ │ │ │ -0001a6e0: 2020 2053 4849 5348 495f 4e54 5f55 4e4b     SHISHI_NT_UNK
│ │ │ │ -0001a6f0: 4e4f 574e 2e0a 2020 2020 2043 4e41 4d45  NOWN..     CNAME
│ │ │ │ -0001a700: 3a20 696e 7075 7420 6172 7261 7920 7769  : input array wi
│ │ │ │ -0001a710: 7468 2070 7269 6e63 6970 616c 206e 616d  th principal nam
│ │ │ │ -0001a720: 652e 0a0a 2020 2020 202a 4465 7363 7269  e...     *Descri
│ │ │ │ -0001a730: 7074 696f 6e3a 2a20 5365 7420 7072 696e  ption:* Set prin
│ │ │ │ -0001a740: 6369 7061 6c20 6669 656c 6420 696e 206b  cipal field in k
│ │ │ │ -0001a750: 7262 6572 726f 7220 746f 2073 7065 6369  rberror to speci
│ │ │ │ -0001a760: 6669 6564 2076 616c 7565 2e0a 0a20 2020  fied value...   
│ │ │ │ -0001a770: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ -0001a780: 2a20 5265 7475 726e 7320 5348 4953 4849  * Returns SHISHI
│ │ │ │ -0001a790: 5f4f 4b20 6966 6620 7375 6363 6573 7366  _OK iff successf
│ │ │ │ -0001a7a0: 756c 2e0a 0a73 6869 7368 695f 6b72 6265  ul...shishi_krbe
│ │ │ │ -0001a7b0: 7272 6f72 5f72 656d 6f76 655f 636e 616d  rror_remove_cnam
│ │ │ │ -0001a7c0: 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  e.--------------
│ │ │ │ -0001a7d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -0001a7e0: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ -0001a7f0: 7420 7368 6973 6869 5f6b 7262 6572 726f  t shishi_krberro
│ │ │ │ -0001a800: 725f 7265 6d6f 7665 5f63 6e61 6d65 2028  r_remove_cname (
│ │ │ │ -0001a810: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ -0001a820: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ -0001a830: 695f 6173 6e31 204b 5242 4552 524f 5229  i_asn1 KRBERROR)
│ │ │ │ -0001a840: 0a20 2020 2020 4841 4e44 4c45 3a20 7368  .     HANDLE: sh
│ │ │ │ -0001a850: 6973 6869 2068 616e 646c 6520 6173 2061  ishi handle as a
│ │ │ │ -0001a860: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ -0001a870: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ -0001a880: 0a20 2020 2020 4b52 4245 5252 4f52 3a20  .     KRBERROR: 
│ │ │ │ -0001a890: 6b72 6265 7272 6f72 2061 7320 616c 6c6f  krberror as allo
│ │ │ │ -0001a8a0: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ -0001a8b0: 6869 5f6b 7262 6572 726f 7228 29e2 8099  hi_krberror()...
│ │ │ │ -0001a8c0: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ -0001a8d0: 7469 6f6e 3a2a 2052 656d 6f76 6520 636c  tion:* Remove cl
│ │ │ │ -0001a8e0: 6965 6e74 2072 6561 6c6d 2066 6965 6c64  ient realm field
│ │ │ │ -0001a8f0: 2069 6e20 4b52 422d 4552 524f 522e 0a0a   in KRB-ERROR...
│ │ │ │ -0001a900: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ -0001a910: 7565 3a2a 2052 6574 7572 6e73 2053 4849  ue:* Returns SHI
│ │ │ │ -0001a920: 5348 495f 4f4b 2069 6666 2073 7563 6365  SHI_OK iff succe
│ │ │ │ -0001a930: 7373 6675 6c2e 0a0a 7368 6973 6869 5f6b  ssful...shishi_k
│ │ │ │ -0001a940: 7262 6572 726f 725f 636c 6965 6e74 5f73  rberror_client_s
│ │ │ │ -0001a950: 6574 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  et.-------------
│ │ │ │ -0001a960: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -0001a970: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ -0001a980: 2073 6869 7368 695f 6b72 6265 7272 6f72   shishi_krberror
│ │ │ │ -0001a990: 5f63 6c69 656e 745f 7365 7420 2853 6869  _client_set (Shi
│ │ │ │ -0001a9a0: 7368 6920 2a20 4841 4e44 4c45 2c0a 2020  shi * HANDLE,.  
│ │ │ │ -0001a9b0: 2020 2020 2020 2020 5368 6973 6869 5f61          Shishi_a
│ │ │ │ -0001a9c0: 736e 3120 4b52 4245 5252 4f52 2c20 636f  sn1 KRBERROR, co
│ │ │ │ -0001a9d0: 6e73 7420 6368 6172 202a 2043 4c49 454e  nst char * CLIEN
│ │ │ │ -0001a9e0: 5429 0a20 2020 2020 4841 4e44 4c45 3a20  T).     HANDLE: 
│ │ │ │ -0001a9f0: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ -0001aa00: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ -0001aa10: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ -0001aa20: 992e 0a20 2020 2020 4b52 4245 5252 4f52  ...     KRBERROR
│ │ │ │ -0001aa30: 3a20 4b72 6265 7272 6f72 2074 6f20 7365  : Krberror to se
│ │ │ │ -0001aa40: 7420 636c 6965 6e74 206e 616d 6520 6669  t client name fi
│ │ │ │ -0001aa50: 656c 6420 696e 2e0a 2020 2020 2043 4c49  eld in..     CLI
│ │ │ │ -0001aa60: 454e 543a 207a 6572 6f2d 7465 726d 696e  ENT: zero-termin
│ │ │ │ -0001aa70: 6174 6564 2073 7472 696e 6720 7769 7468  ated string with
│ │ │ │ -0001aa80: 2070 7269 6e63 6970 616c 206e 616d 6520   principal name 
│ │ │ │ -0001aa90: 6f6e 2052 4643 2031 3936 340a 2020 2020  on RFC 1964.    
│ │ │ │ -0001aaa0: 2066 6f72 6d2e 0a0a 2020 2020 202a 4465   form...     *De
│ │ │ │ -0001aab0: 7363 7269 7074 696f 6e3a 2a20 5365 7420  scription:* Set 
│ │ │ │ -0001aac0: 7468 6520 636c 6965 6e74 206e 616d 6520  the client name 
│ │ │ │ -0001aad0: 6669 656c 6420 696e 2074 6865 204b 7262  field in the Krb
│ │ │ │ -0001aae0: 6572 726f 722e 0a0a 2020 2020 202a 5265  error...     *Re
│ │ │ │ -0001aaf0: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ -0001ab00: 7572 6e73 2053 4849 5348 495f 4f4b 2069  urns SHISHI_OK i
│ │ │ │ -0001ab10: 6666 2073 7563 6365 7373 6675 6c2e 0a0a  ff successful...
│ │ │ │ -0001ab20: 7368 6973 6869 5f6b 7262 6572 726f 725f  shishi_krberror_
│ │ │ │ -0001ab30: 7265 616c 6d0a 2d2d 2d2d 2d2d 2d2d 2d2d  realm.----------
│ │ │ │ -0001ab40: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ -0001ab50: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ -0001ab60: 6869 7368 695f 6b72 6265 7272 6f72 5f72  hishi_krberror_r
│ │ │ │ -0001ab70: 6561 6c6d 2028 5368 6973 6869 202a 2048  ealm (Shishi * H
│ │ │ │ -0001ab80: 414e 444c 452c 0a20 2020 2020 2020 2020  ANDLE,.         
│ │ │ │ -0001ab90: 2053 6869 7368 695f 6173 6e31 204b 5242   Shishi_asn1 KRB
│ │ │ │ -0001aba0: 4552 524f 522c 2063 6861 7220 2a2a 2052  ERROR, char ** R
│ │ │ │ -0001abb0: 4541 4c4d 2c20 7369 7a65 5f74 202a 2052  EALM, size_t * R
│ │ │ │ -0001abc0: 4541 4c4d 4c45 4e29 0a20 2020 2020 4841  EALMLEN).     HA
│ │ │ │ -0001abd0: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ -0001abe0: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ -0001abf0: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ -0001ac00: 6974 2829 e280 992e 0a20 2020 2020 4b52  it().....     KR
│ │ │ │ -0001ac10: 4245 5252 4f52 3a20 6b72 6265 7272 6f72  BERROR: krberror
│ │ │ │ -0001ac20: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ -0001ac30: 20e2 8098 7368 6973 6869 5f6b 7262 6572   ...shishi_krber
│ │ │ │ -0001ac40: 726f 7228 29e2 8099 2e0a 2020 2020 2052  ror().....     R
│ │ │ │ -0001ac50: 4541 4c4d 3a20 6f75 7470 7574 2061 7272  EALM: output arr
│ │ │ │ -0001ac60: 6179 2077 6974 6820 6e65 776c 7920 616c  ay with newly al
│ │ │ │ -0001ac70: 6c6f 6361 7465 6420 6e61 6d65 206f 6620  located name of 
│ │ │ │ -0001ac80: 7265 616c 6d20 696e 0a20 2020 2020 4b52  realm in.     KR
│ │ │ │ -0001ac90: 422d 4552 524f 522e 0a20 2020 2020 5245  B-ERROR..     RE
│ │ │ │ -0001aca0: 414c 4d4c 454e 3a20 7369 7a65 206f 6620  ALMLEN: size of 
│ │ │ │ -0001acb0: 6f75 7470 7574 2061 7272 6179 2e0a 0a20  output array... 
│ │ │ │ -0001acc0: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -0001acd0: 3a2a 2045 7874 7261 6374 2028 7365 7276  :* Extract (serv
│ │ │ │ -0001ace0: 6572 2920 7265 616c 6d20 6672 6f6d 204b  er) realm from K
│ │ │ │ -0001acf0: 5242 2d45 5252 4f52 2e0a 0a20 2020 2020  RB-ERROR...     
│ │ │ │ -0001ad00: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ -0001ad10: 5265 7475 726e 7320 5348 4953 4849 5f4f  Returns SHISHI_O
│ │ │ │ -0001ad20: 4b20 6966 6620 7375 6363 6573 7366 756c  K iff successful
│ │ │ │ -0001ad30: 2e0a 0a73 6869 7368 695f 6b72 6265 7272  ...shishi_krberr
│ │ │ │ -0001ad40: 6f72 5f73 6574 5f72 6561 6c6d 0a2d 2d2d  or_set_realm.---
│ │ │ │ +00018da0: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ +00018db0: 6f6e 3a20 696e 7420 7368 6973 6869 5f6b  on: int shishi_k
│ │ │ │ +00018dc0: 7262 6572 726f 725f 7072 696e 7420 2853  rberror_print (S
│ │ │ │ +00018dd0: 6869 7368 6920 2a20 4841 4e44 4c45 2c20  hishi * HANDLE, 
│ │ │ │ +00018de0: 4649 4c45 202a 2046 482c 0a20 2020 2020  FILE * FH,.     
│ │ │ │ +00018df0: 2020 2020 2053 6869 7368 695f 6173 6e31       Shishi_asn1
│ │ │ │ +00018e00: 204b 5242 4552 524f 5229 0a20 2020 2020   KRBERROR).     
│ │ │ │ +00018e10: 4841 4e44 4c45 3a20 7368 6973 6869 2068  HANDLE: shishi h
│ │ │ │ +00018e20: 616e 646c 6520 6173 2061 6c6c 6f63 6174  andle as allocat
│ │ │ │ +00018e30: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ +00018e40: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ +00018e50: 4648 3a20 6669 6c65 2068 616e 646c 6520  FH: file handle 
│ │ │ │ +00018e60: 6f70 656e 2066 6f72 2077 7269 7469 6e67  open for writing
│ │ │ │ +00018e70: 2e0a 2020 2020 204b 5242 4552 524f 523a  ..     KRBERROR:
│ │ │ │ +00018e80: 204b 5242 2d45 5252 4f52 2074 6f20 7072   KRB-ERROR to pr
│ │ │ │ +00018e90: 696e 742e 0a0a 2020 2020 202a 4465 7363  int...     *Desc
│ │ │ │ +00018ea0: 7269 7074 696f 6e3a 2a20 5072 696e 7420  ription:* Print 
│ │ │ │ +00018eb0: 4153 4349 4920 6172 6d6f 7265 6420 4445  ASCII armored DE
│ │ │ │ +00018ec0: 5220 656e 636f 6469 6e67 206f 6620 4b52  R encoding of KR
│ │ │ │ +00018ed0: 422d 4552 524f 5220 746f 0a20 2020 2020  B-ERROR to.     
│ │ │ │ +00018ee0: 6669 6c65 2e0a 0a20 2020 2020 2a52 6574  file...     *Ret
│ │ │ │ +00018ef0: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ +00018f00: 726e 7320 5348 4953 4849 5f4f 4b20 6966  rns SHISHI_OK if
│ │ │ │ +00018f10: 6620 7375 6363 6573 7366 756c 2e0a 0a73  f successful...s
│ │ │ │ +00018f20: 6869 7368 695f 6b72 6265 7272 6f72 5f73  hishi_krberror_s
│ │ │ │ +00018f30: 6176 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ave.------------
│ │ │ │ +00018f40: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ +00018f50: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ +00018f60: 6869 5f6b 7262 6572 726f 725f 7361 7665  hi_krberror_save
│ │ │ │ +00018f70: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ +00018f80: 452c 2046 494c 4520 2a20 4648 2c0a 2020  E, FILE * FH,.  
│ │ │ │ +00018f90: 2020 2020 2020 2020 5368 6973 6869 5f61          Shishi_a
│ │ │ │ +00018fa0: 736e 3120 4b52 4245 5252 4f52 290a 2020  sn1 KRBERROR).  
│ │ │ │ +00018fb0: 2020 2048 414e 444c 453a 2073 6869 7368     HANDLE: shish
│ │ │ │ +00018fc0: 6920 6861 6e64 6c65 2061 7320 616c 6c6f  i handle as allo
│ │ │ │ +00018fd0: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ +00018fe0: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ +00018ff0: 2020 2046 483a 2066 696c 6520 6861 6e64     FH: file hand
│ │ │ │ +00019000: 6c65 206f 7065 6e20 666f 7220 7772 6974  le open for writ
│ │ │ │ +00019010: 696e 672e 0a20 2020 2020 4b52 4245 5252  ing..     KRBERR
│ │ │ │ +00019020: 4f52 3a20 4b52 422d 4552 524f 5220 746f  OR: KRB-ERROR to
│ │ │ │ +00019030: 2073 6176 652e 0a0a 2020 2020 202a 4465   save...     *De
│ │ │ │ +00019040: 7363 7269 7074 696f 6e3a 2a20 5361 7665  scription:* Save
│ │ │ │ +00019050: 2044 4552 2065 6e63 6f64 696e 6720 6f66   DER encoding of
│ │ │ │ +00019060: 204b 5242 2d45 5252 4f52 2074 6f20 6669   KRB-ERROR to fi
│ │ │ │ +00019070: 6c65 2e0a 0a20 2020 2020 2a52 6574 7572  le...     *Retur
│ │ │ │ +00019080: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ +00019090: 7320 5348 4953 4849 5f4f 4b20 6966 6620  s SHISHI_OK iff 
│ │ │ │ +000190a0: 7375 6363 6573 7366 756c 2e0a 0a73 6869  successful...shi
│ │ │ │ +000190b0: 7368 695f 6b72 6265 7272 6f72 5f74 6f5f  shi_krberror_to_
│ │ │ │ +000190c0: 6669 6c65 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  file.-----------
│ │ │ │ +000190d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ +000190e0: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ +000190f0: 7368 6973 6869 5f6b 7262 6572 726f 725f  shishi_krberror_
│ │ │ │ +00019100: 746f 5f66 696c 6520 2853 6869 7368 6920  to_file (Shishi 
│ │ │ │ +00019110: 2a20 4841 4e44 4c45 2c0a 2020 2020 2020  * HANDLE,.      
│ │ │ │ +00019120: 2020 2020 5368 6973 6869 5f61 736e 3120      Shishi_asn1 
│ │ │ │ +00019130: 4b52 4245 5252 4f52 2c20 696e 7420 4649  KRBERROR, int FI
│ │ │ │ +00019140: 4c45 5459 5045 2c20 636f 6e73 7420 6368  LETYPE, const ch
│ │ │ │ +00019150: 6172 202a 2046 494c 454e 414d 4529 0a20  ar * FILENAME). 
│ │ │ │ +00019160: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ +00019170: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ +00019180: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ +00019190: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ +000191a0: 2020 2020 4b52 4245 5252 4f52 3a20 4b52      KRBERROR: KR
│ │ │ │ +000191b0: 422d 4552 524f 5220 746f 2073 6176 652e  B-ERROR to save.
│ │ │ │ +000191c0: 0a20 2020 2020 4649 4c45 5459 5045 3a20  .     FILETYPE: 
│ │ │ │ +000191d0: 696e 7075 7420 7661 7269 6162 6c65 2073  input variable s
│ │ │ │ +000191e0: 7065 6369 6679 696e 6720 7479 7065 206f  pecifying type o
│ │ │ │ +000191f0: 6620 6669 6c65 2074 6f20 6265 2077 7269  f file to be wri
│ │ │ │ +00019200: 7474 656e 2c20 7365 650a 2020 2020 2053  tten, see.     S
│ │ │ │ +00019210: 6869 7368 695f 6669 6c65 7479 7065 2e0a  hishi_filetype..
│ │ │ │ +00019220: 2020 2020 2046 494c 454e 414d 453a 2069       FILENAME: i
│ │ │ │ +00019230: 6e70 7574 2076 6172 6961 626c 6520 7769  nput variable wi
│ │ │ │ +00019240: 7468 2066 696c 656e 616d 6520 746f 2077  th filename to w
│ │ │ │ +00019250: 7269 7465 2074 6f2e 0a0a 2020 2020 202a  rite to...     *
│ │ │ │ +00019260: 4465 7363 7269 7074 696f 6e3a 2a20 5772  Description:* Wr
│ │ │ │ +00019270: 6974 6520 4b52 422d 4552 524f 5220 746f  ite KRB-ERROR to
│ │ │ │ +00019280: 2066 696c 6520 696e 2073 7065 6369 6669   file in specifi
│ │ │ │ +00019290: 6564 2054 5950 452e 2054 6865 2066 696c  ed TYPE. The fil
│ │ │ │ +000192a0: 650a 2020 2020 2077 696c 6c20 6265 2074  e.     will be t
│ │ │ │ +000192b0: 7275 6e63 6174 6564 2069 6620 6974 2065  runcated if it e
│ │ │ │ +000192c0: 7869 7374 732e 0a0a 2020 2020 202a 5265  xists...     *Re
│ │ │ │ +000192d0: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ +000192e0: 7572 6e73 2053 4849 5348 495f 4f4b 2069  urns SHISHI_OK i
│ │ │ │ +000192f0: 6666 2073 7563 6365 7373 6675 6c2e 0a0a  ff successful...
│ │ │ │ +00019300: 7368 6973 6869 5f6b 7262 6572 726f 725f  shishi_krberror_
│ │ │ │ +00019310: 7061 7273 650a 2d2d 2d2d 2d2d 2d2d 2d2d  parse.----------
│ │ │ │ +00019320: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ +00019330: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ +00019340: 6869 7368 695f 6b72 6265 7272 6f72 5f70  hishi_krberror_p
│ │ │ │ +00019350: 6172 7365 2028 5368 6973 6869 202a 2048  arse (Shishi * H
│ │ │ │ +00019360: 414e 444c 452c 2046 494c 4520 2a20 4648  ANDLE, FILE * FH
│ │ │ │ +00019370: 2c0a 2020 2020 2020 2020 2020 5368 6973  ,.          Shis
│ │ │ │ +00019380: 6869 5f61 736e 3120 2a20 4b52 4245 5252  hi_asn1 * KRBERR
│ │ │ │ +00019390: 4f52 290a 2020 2020 2048 414e 444c 453a  OR).     HANDLE:
│ │ │ │ +000193a0: 2073 6869 7368 6920 6861 6e64 6c65 2061   shishi handle a
│ │ │ │ +000193b0: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ +000193c0: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ +000193d0: 8099 2e0a 2020 2020 2046 483a 2066 696c  ....     FH: fil
│ │ │ │ +000193e0: 6520 6861 6e64 6c65 206f 7065 6e20 666f  e handle open fo
│ │ │ │ +000193f0: 7220 7265 6164 696e 672e 0a20 2020 2020  r reading..     
│ │ │ │ +00019400: 4b52 4245 5252 4f52 3a20 6f75 7470 7574  KRBERROR: output
│ │ │ │ +00019410: 2076 6172 6961 626c 6520 7769 7468 206e   variable with n
│ │ │ │ +00019420: 6577 6c79 2061 6c6c 6f63 6174 6564 204b  ewly allocated K
│ │ │ │ +00019430: 5242 2d45 5252 4f52 2e0a 0a20 2020 2020  RB-ERROR...     
│ │ │ │ +00019440: 2a44 6573 6372 6970 7469 6f6e 3a2a 2052  *Description:* R
│ │ │ │ +00019450: 6561 6420 4153 4349 4920 6172 6d6f 7265  ead ASCII armore
│ │ │ │ +00019460: 6420 4445 5220 656e 636f 6465 6420 4b52  d DER encoded KR
│ │ │ │ +00019470: 422d 4552 524f 5220 6672 6f6d 2066 696c  B-ERROR from fil
│ │ │ │ +00019480: 650a 2020 2020 2061 6e64 2070 6f70 756c  e.     and popul
│ │ │ │ +00019490: 6174 6520 6769 7665 6e20 7661 7269 6162  ate given variab
│ │ │ │ +000194a0: 6c65 2e0a 0a20 2020 2020 2a52 6574 7572  le...     *Retur
│ │ │ │ +000194b0: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ +000194c0: 7320 5348 4953 4849 5f4f 4b20 6966 6620  s SHISHI_OK iff 
│ │ │ │ +000194d0: 7375 6363 6573 7366 756c 2e0a 0a73 6869  successful...shi
│ │ │ │ +000194e0: 7368 695f 6b72 6265 7272 6f72 5f72 6561  shi_krberror_rea
│ │ │ │ +000194f0: 640a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  d.--------------
│ │ │ │ +00019500: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ +00019510: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ +00019520: 5f6b 7262 6572 726f 725f 7265 6164 2028  _krberror_read (
│ │ │ │ +00019530: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ +00019540: 2046 494c 4520 2a20 4648 2c0a 2020 2020   FILE * FH,.    
│ │ │ │ +00019550: 2020 2020 2020 5368 6973 6869 5f61 736e        Shishi_asn
│ │ │ │ +00019560: 3120 2a20 4b52 4245 5252 4f52 290a 2020  1 * KRBERROR).  
│ │ │ │ +00019570: 2020 2048 414e 444c 453a 2073 6869 7368     HANDLE: shish
│ │ │ │ +00019580: 6920 6861 6e64 6c65 2061 7320 616c 6c6f  i handle as allo
│ │ │ │ +00019590: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ +000195a0: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ +000195b0: 2020 2046 483a 2066 696c 6520 6861 6e64     FH: file hand
│ │ │ │ +000195c0: 6c65 206f 7065 6e20 666f 7220 7265 6164  le open for read
│ │ │ │ +000195d0: 696e 672e 0a20 2020 2020 4b52 4245 5252  ing..     KRBERR
│ │ │ │ +000195e0: 4f52 3a20 6f75 7470 7574 2076 6172 6961  OR: output varia
│ │ │ │ +000195f0: 626c 6520 7769 7468 206e 6577 6c79 2061  ble with newly a
│ │ │ │ +00019600: 6c6c 6f63 6174 6564 204b 5242 2d45 5252  llocated KRB-ERR
│ │ │ │ +00019610: 4f52 2e0a 0a20 2020 2020 2a44 6573 6372  OR...     *Descr
│ │ │ │ +00019620: 6970 7469 6f6e 3a2a 2052 6561 6420 4445  iption:* Read DE
│ │ │ │ +00019630: 5220 656e 636f 6465 6420 4b52 422d 4552  R encoded KRB-ER
│ │ │ │ +00019640: 524f 5220 6672 6f6d 2066 696c 6520 616e  ROR from file an
│ │ │ │ +00019650: 6420 706f 7075 6c61 7465 0a20 2020 2020  d populate.     
│ │ │ │ +00019660: 6769 7665 6e20 7661 7269 6162 6c65 2e0a  given variable..
│ │ │ │ +00019670: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ +00019680: 6c75 653a 2a20 5265 7475 726e 7320 5348  lue:* Returns SH
│ │ │ │ +00019690: 4953 4849 5f4f 4b20 6966 6620 7375 6363  ISHI_OK iff succ
│ │ │ │ +000196a0: 6573 7366 756c 2e0a 0a73 6869 7368 695f  essful...shishi_
│ │ │ │ +000196b0: 6b72 6265 7272 6f72 5f66 726f 6d5f 6669  krberror_from_fi
│ │ │ │ +000196c0: 6c65 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  le.-------------
│ │ │ │ +000196d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ +000196e0: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ +000196f0: 7368 6973 6869 5f6b 7262 6572 726f 725f  shishi_krberror_
│ │ │ │ +00019700: 6672 6f6d 5f66 696c 6520 2853 6869 7368  from_file (Shish
│ │ │ │ +00019710: 6920 2a20 4841 4e44 4c45 2c0a 2020 2020  i * HANDLE,.    
│ │ │ │ +00019720: 2020 2020 2020 5368 6973 6869 5f61 736e        Shishi_asn
│ │ │ │ +00019730: 3120 2a20 4b52 4245 5252 4f52 2c20 696e  1 * KRBERROR, in
│ │ │ │ +00019740: 7420 4649 4c45 5459 5045 2c20 636f 6e73  t FILETYPE, cons
│ │ │ │ +00019750: 7420 6368 6172 202a 2046 494c 454e 414d  t char * FILENAM
│ │ │ │ +00019760: 4529 0a20 2020 2020 4841 4e44 4c45 3a20  E).     HANDLE: 
│ │ │ │ +00019770: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ +00019780: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ +00019790: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ +000197a0: 992e 0a20 2020 2020 4b52 4245 5252 4f52  ...     KRBERROR
│ │ │ │ +000197b0: 3a20 6f75 7470 7574 2076 6172 6961 626c  : output variabl
│ │ │ │ +000197c0: 6520 7769 7468 206e 6577 6c79 2061 6c6c  e with newly all
│ │ │ │ +000197d0: 6f63 6174 6564 204b 5242 2d45 5252 4f52  ocated KRB-ERROR
│ │ │ │ +000197e0: 2e0a 2020 2020 2046 494c 4554 5950 453a  ..     FILETYPE:
│ │ │ │ +000197f0: 2069 6e70 7574 2076 6172 6961 626c 6520   input variable 
│ │ │ │ +00019800: 7370 6563 6966 7969 6e67 2074 7970 6520  specifying type 
│ │ │ │ +00019810: 6f66 2066 696c 6520 746f 2062 6520 7265  of file to be re
│ │ │ │ +00019820: 6164 2c20 7365 650a 2020 2020 2053 6869  ad, see.     Shi
│ │ │ │ +00019830: 7368 695f 6669 6c65 7479 7065 2e0a 2020  shi_filetype..  
│ │ │ │ +00019840: 2020 2046 494c 454e 414d 453a 2069 6e70     FILENAME: inp
│ │ │ │ +00019850: 7574 2076 6172 6961 626c 6520 7769 7468  ut variable with
│ │ │ │ +00019860: 2066 696c 656e 616d 6520 746f 2072 6561   filename to rea
│ │ │ │ +00019870: 6420 6672 6f6d 2e0a 0a20 2020 2020 2a44  d from...     *D
│ │ │ │ +00019880: 6573 6372 6970 7469 6f6e 3a2a 2052 6561  escription:* Rea
│ │ │ │ +00019890: 6420 4b52 422d 4552 524f 5220 6672 6f6d  d KRB-ERROR from
│ │ │ │ +000198a0: 2066 696c 6520 696e 2073 7065 6369 6669   file in specifi
│ │ │ │ +000198b0: 6564 2054 5950 452e 0a0a 2020 2020 202a  ed TYPE...     *
│ │ │ │ +000198c0: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ +000198d0: 6574 7572 6e73 2053 4849 5348 495f 4f4b  eturns SHISHI_OK
│ │ │ │ +000198e0: 2069 6666 2073 7563 6365 7373 6675 6c2e   iff successful.
│ │ │ │ +000198f0: 0a0a 7368 6973 6869 5f6b 7262 6572 726f  ..shishi_krberro
│ │ │ │ +00019900: 725f 6275 696c 640a 2d2d 2d2d 2d2d 2d2d  r_build.--------
│ │ │ │ +00019910: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ +00019920: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ +00019930: 2073 6869 7368 695f 6b72 6265 7272 6f72   shishi_krberror
│ │ │ │ +00019940: 5f62 7569 6c64 2028 5368 6973 6869 202a  _build (Shishi *
│ │ │ │ +00019950: 2048 414e 444c 452c 0a20 2020 2020 2020   HANDLE,.       
│ │ │ │ +00019960: 2020 2053 6869 7368 695f 6173 6e31 204b     Shishi_asn1 K
│ │ │ │ +00019970: 5242 4552 524f 5229 0a20 2020 2020 4841  RBERROR).     HA
│ │ │ │ +00019980: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ +00019990: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ +000199a0: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ +000199b0: 6974 2829 e280 992e 0a20 2020 2020 4b52  it().....     KR
│ │ │ │ +000199c0: 4245 5252 4f52 3a20 6b72 6265 7272 6f72  BERROR: krberror
│ │ │ │ +000199d0: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ +000199e0: 20e2 8098 7368 6973 6869 5f6b 7262 6572   ...shishi_krber
│ │ │ │ +000199f0: 726f 7228 29e2 8099 2e0a 0a20 2020 2020  ror()......     
│ │ │ │ +00019a00: 2a44 6573 6372 6970 7469 6f6e 3a2a 2046  *Description:* F
│ │ │ │ +00019a10: 696e 6973 6820 4b52 422d 4552 524f 522c  inish KRB-ERROR,
│ │ │ │ +00019a20: 2063 616c 6c65 6420 6265 666f 7265 2065   called before e
│ │ │ │ +00019a30: 2e67 2e0a 2020 2020 2073 6869 7368 695f  .g..     shishi_
│ │ │ │ +00019a40: 6b72 6265 7272 6f72 5f64 6572 2e20 2054  krberror_der.  T
│ │ │ │ +00019a50: 6869 7320 6675 6e63 7469 6f6e 2072 656d  his function rem
│ │ │ │ +00019a60: 6f76 6573 2065 6d70 7479 2062 7574 204f  oves empty but O
│ │ │ │ +00019a70: 5054 494f 4e41 4c0a 2020 2020 2066 6965  PTIONAL.     fie
│ │ │ │ +00019a80: 6c64 7320 2873 7563 6820 6173 2063 6e61  lds (such as cna
│ │ │ │ +00019a90: 6d65 292c 2061 6e64 0a0a 2020 2020 202a  me), and..     *
│ │ │ │ +00019aa0: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ +00019ab0: 6574 7572 6e73 2053 4849 5348 495f 4f4b  eturns SHISHI_OK
│ │ │ │ +00019ac0: 2069 6666 2073 7563 6365 7373 6675 6c2e   iff successful.
│ │ │ │ +00019ad0: 0a0a 7368 6973 6869 5f6b 7262 6572 726f  ..shishi_krberro
│ │ │ │ +00019ae0: 725f 6465 720a 2d2d 2d2d 2d2d 2d2d 2d2d  r_der.----------
│ │ │ │ +00019af0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +00019b00: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ +00019b10: 7368 695f 6b72 6265 7272 6f72 5f64 6572  shi_krberror_der
│ │ │ │ +00019b20: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ +00019b30: 452c 0a20 2020 2020 2020 2020 2053 6869  E,.          Shi
│ │ │ │ +00019b40: 7368 695f 6173 6e31 204b 5242 4552 524f  shi_asn1 KRBERRO
│ │ │ │ +00019b50: 522c 2063 6861 7220 2a2a 204f 5554 2c20  R, char ** OUT, 
│ │ │ │ +00019b60: 7369 7a65 5f74 202a 204f 5554 4c45 4e29  size_t * OUTLEN)
│ │ │ │ +00019b70: 0a20 2020 2020 4841 4e44 4c45 3a20 7368  .     HANDLE: sh
│ │ │ │ +00019b80: 6973 6869 2068 616e 646c 6520 6173 2061  ishi handle as a
│ │ │ │ +00019b90: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ +00019ba0: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ +00019bb0: 0a20 2020 2020 4b52 4245 5252 4f52 3a20  .     KRBERROR: 
│ │ │ │ +00019bc0: 6b72 6265 7272 6f72 2061 7320 616c 6c6f  krberror as allo
│ │ │ │ +00019bd0: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ +00019be0: 6869 5f6b 7262 6572 726f 7228 29e2 8099  hi_krberror()...
│ │ │ │ +00019bf0: 2e0a 2020 2020 204f 5554 3a20 6f75 7470  ..     OUT: outp
│ │ │ │ +00019c00: 7574 2061 7272 6179 2077 6974 6820 6e65  ut array with ne
│ │ │ │ +00019c10: 776c 7920 616c 6c6f 6361 7465 6420 4445  wly allocated DE
│ │ │ │ +00019c20: 5220 656e 636f 6469 6e67 206f 6620 4b52  R encoding of KR
│ │ │ │ +00019c30: 422d 4552 524f 522e 0a20 2020 2020 4f55  B-ERROR..     OU
│ │ │ │ +00019c40: 544c 454e 3a20 6c65 6e67 7468 206f 6620  TLEN: length of 
│ │ │ │ +00019c50: 6f75 7470 7574 2061 7272 6179 2077 6974  output array wit
│ │ │ │ +00019c60: 6820 4445 5220 656e 636f 6469 6e67 206f  h DER encoding o
│ │ │ │ +00019c70: 6620 4b52 422d 4552 524f 522e 0a0a 2020  f KRB-ERROR...  
│ │ │ │ +00019c80: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ +00019c90: 2a20 4445 5220 656e 636f 6465 204b 5242  * DER encode KRB
│ │ │ │ +00019ca0: 2d45 5252 4f52 2e20 5468 6520 6361 6c6c  -ERROR. The call
│ │ │ │ +00019cb0: 6572 206d 7573 7420 6465 616c 6c6f 6361  er must dealloca
│ │ │ │ +00019cc0: 7465 2074 6865 0a20 2020 2020 4f55 5420  te the.     OUT 
│ │ │ │ +00019cd0: 6275 6666 6572 2e0a 0a20 2020 2020 2a52  buffer...     *R
│ │ │ │ +00019ce0: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +00019cf0: 7475 726e 7320 5348 4953 4849 5f4f 4b20  turns SHISHI_OK 
│ │ │ │ +00019d00: 6966 6620 7375 6363 6573 7366 756c 2e0a  iff successful..
│ │ │ │ +00019d10: 0a73 6869 7368 695f 6b72 6265 7272 6f72  .shishi_krberror
│ │ │ │ +00019d20: 5f63 7265 616c 6d0a 2d2d 2d2d 2d2d 2d2d  _crealm.--------
│ │ │ │ +00019d30: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ +00019d40: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ +00019d50: 7420 7368 6973 6869 5f6b 7262 6572 726f  t shishi_krberro
│ │ │ │ +00019d60: 725f 6372 6561 6c6d 2028 5368 6973 6869  r_crealm (Shishi
│ │ │ │ +00019d70: 202a 2048 414e 444c 452c 0a20 2020 2020   * HANDLE,.     
│ │ │ │ +00019d80: 2020 2020 2053 6869 7368 695f 6173 6e31       Shishi_asn1
│ │ │ │ +00019d90: 204b 5242 4552 524f 522c 2063 6861 7220   KRBERROR, char 
│ │ │ │ +00019da0: 2a2a 2052 4541 4c4d 2c20 7369 7a65 5f74  ** REALM, size_t
│ │ │ │ +00019db0: 202a 2052 4541 4c4d 4c45 4e29 0a20 2020   * REALMLEN).   
│ │ │ │ +00019dc0: 2020 4841 4e44 4c45 3a20 7368 6973 6869    HANDLE: shishi
│ │ │ │ +00019dd0: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ +00019de0: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ +00019df0: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ +00019e00: 2020 4b52 4245 5252 4f52 3a20 6b72 6265    KRBERROR: krbe
│ │ │ │ +00019e10: 7272 6f72 2061 7320 616c 6c6f 6361 7465  rror as allocate
│ │ │ │ +00019e20: 6420 6279 20e2 8098 7368 6973 6869 5f6b  d by ...shishi_k
│ │ │ │ +00019e30: 7262 6572 726f 7228 29e2 8099 2e0a 2020  rberror().....  
│ │ │ │ +00019e40: 2020 2052 4541 4c4d 3a20 6f75 7470 7574     REALM: output
│ │ │ │ +00019e50: 2061 7272 6179 2077 6974 6820 6e65 776c   array with newl
│ │ │ │ +00019e60: 7920 616c 6c6f 6361 7465 6420 6e61 6d65  y allocated name
│ │ │ │ +00019e70: 206f 6620 7265 616c 6d20 696e 0a20 2020   of realm in.   
│ │ │ │ +00019e80: 2020 4b52 422d 4552 524f 522e 0a20 2020    KRB-ERROR..   
│ │ │ │ +00019e90: 2020 5245 414c 4d4c 454e 3a20 7369 7a65    REALMLEN: size
│ │ │ │ +00019ea0: 206f 6620 6f75 7470 7574 2061 7272 6179   of output array
│ │ │ │ +00019eb0: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ +00019ec0: 7469 6f6e 3a2a 2045 7874 7261 6374 2063  tion:* Extract c
│ │ │ │ +00019ed0: 6c69 656e 7420 7265 616c 6d20 6672 6f6d  lient realm from
│ │ │ │ +00019ee0: 204b 5242 2d45 5252 4f52 2e0a 0a20 2020   KRB-ERROR...   
│ │ │ │ +00019ef0: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ +00019f00: 2a20 5265 7475 726e 7320 5348 4953 4849  * Returns SHISHI
│ │ │ │ +00019f10: 5f4f 4b20 6966 6620 7375 6363 6573 7366  _OK iff successf
│ │ │ │ +00019f20: 756c 2e0a 0a73 6869 7368 695f 6b72 6265  ul...shishi_krbe
│ │ │ │ +00019f30: 7272 6f72 5f72 656d 6f76 655f 6372 6561  rror_remove_crea
│ │ │ │ +00019f40: 6c6d 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  lm.-------------
│ │ │ │ +00019f50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +00019f60: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +00019f70: 696e 7420 7368 6973 6869 5f6b 7262 6572  int shishi_krber
│ │ │ │ +00019f80: 726f 725f 7265 6d6f 7665 5f63 7265 616c  ror_remove_creal
│ │ │ │ +00019f90: 6d20 2853 6869 7368 6920 2a20 4841 4e44  m (Shishi * HAND
│ │ │ │ +00019fa0: 4c45 2c0a 2020 2020 2020 2020 2020 5368  LE,.          Sh
│ │ │ │ +00019fb0: 6973 6869 5f61 736e 3120 4b52 4245 5252  ishi_asn1 KRBERR
│ │ │ │ +00019fc0: 4f52 290a 2020 2020 2048 414e 444c 453a  OR).     HANDLE:
│ │ │ │ +00019fd0: 2073 6869 7368 6920 6861 6e64 6c65 2061   shishi handle a
│ │ │ │ +00019fe0: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ +00019ff0: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ +0001a000: 8099 2e0a 2020 2020 204b 5242 4552 524f  ....     KRBERRO
│ │ │ │ +0001a010: 523a 206b 7262 6572 726f 7220 6173 2061  R: krberror as a
│ │ │ │ +0001a020: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ +0001a030: 6869 7368 695f 6b72 6265 7272 6f72 2829  hishi_krberror()
│ │ │ │ +0001a040: e280 992e 0a0a 2020 2020 202a 4465 7363  ......     *Desc
│ │ │ │ +0001a050: 7269 7074 696f 6e3a 2a20 5265 6d6f 7665  ription:* Remove
│ │ │ │ +0001a060: 2063 6c69 656e 7420 7265 616c 6d20 6669   client realm fi
│ │ │ │ +0001a070: 656c 6420 696e 204b 5242 2d45 5252 4f52  eld in KRB-ERROR
│ │ │ │ +0001a080: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ +0001a090: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ +0001a0a0: 5348 4953 4849 5f4f 4b20 6966 6620 7375  SHISHI_OK iff su
│ │ │ │ +0001a0b0: 6363 6573 7366 756c 2e0a 0a73 6869 7368  ccessful...shish
│ │ │ │ +0001a0c0: 695f 6b72 6265 7272 6f72 5f73 6574 5f63  i_krberror_set_c
│ │ │ │ +0001a0d0: 7265 616c 6d0a 2d2d 2d2d 2d2d 2d2d 2d2d  realm.----------
│ │ │ │ +0001a0e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +0001a0f0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +0001a100: 696e 7420 7368 6973 6869 5f6b 7262 6572  int shishi_krber
│ │ │ │ +0001a110: 726f 725f 7365 745f 6372 6561 6c6d 2028  ror_set_crealm (
│ │ │ │ +0001a120: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ +0001a130: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ +0001a140: 695f 6173 6e31 204b 5242 4552 524f 522c  i_asn1 KRBERROR,
│ │ │ │ +0001a150: 2063 6f6e 7374 2063 6861 7220 2a20 4352   const char * CR
│ │ │ │ +0001a160: 4541 4c4d 290a 2020 2020 2048 414e 444c  EALM).     HANDL
│ │ │ │ +0001a170: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ +0001a180: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ +0001a190: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ +0001a1a0: 29e2 8099 2e0a 2020 2020 204b 5242 4552  ).....     KRBER
│ │ │ │ +0001a1b0: 524f 523a 206b 7262 6572 726f 7220 6173  ROR: krberror as
│ │ │ │ +0001a1c0: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ +0001a1d0: 9873 6869 7368 695f 6b72 6265 7272 6f72  .shishi_krberror
│ │ │ │ +0001a1e0: 2829 e280 992e 0a20 2020 2020 4352 4541  ().....     CREA
│ │ │ │ +0001a1f0: 4c4d 3a20 696e 7075 7420 6172 7261 7920  LM: input array 
│ │ │ │ +0001a200: 7769 7468 2072 6561 6c6d 2e0a 0a20 2020  with realm...   
│ │ │ │ +0001a210: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ +0001a220: 2053 6574 2072 6561 6c6d 2066 6965 6c64   Set realm field
│ │ │ │ +0001a230: 2069 6e20 6b72 6265 7272 6f72 2074 6f20   in krberror to 
│ │ │ │ +0001a240: 7370 6563 6966 6965 6420 7661 6c75 652e  specified value.
│ │ │ │ +0001a250: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ +0001a260: 616c 7565 3a2a 2052 6574 7572 6e73 2053  alue:* Returns S
│ │ │ │ +0001a270: 4849 5348 495f 4f4b 2069 6666 2073 7563  HISHI_OK iff suc
│ │ │ │ +0001a280: 6365 7373 6675 6c2e 0a0a 7368 6973 6869  cessful...shishi
│ │ │ │ +0001a290: 5f6b 7262 6572 726f 725f 636c 6965 6e74  _krberror_client
│ │ │ │ +0001a2a0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ +0001a2b0: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +0001a2c0: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ +0001a2d0: 695f 6b72 6265 7272 6f72 5f63 6c69 656e  i_krberror_clien
│ │ │ │ +0001a2e0: 7420 2853 6869 7368 6920 2a20 4841 4e44  t (Shishi * HAND
│ │ │ │ +0001a2f0: 4c45 2c0a 2020 2020 2020 2020 2020 5368  LE,.          Sh
│ │ │ │ +0001a300: 6973 6869 5f61 736e 3120 4b52 4245 5252  ishi_asn1 KRBERR
│ │ │ │ +0001a310: 4f52 2c20 6368 6172 202a 2a20 434c 4945  OR, char ** CLIE
│ │ │ │ +0001a320: 4e54 2c20 7369 7a65 5f74 202a 2043 4c49  NT, size_t * CLI
│ │ │ │ +0001a330: 454e 544c 454e 290a 2020 2020 2048 414e  ENTLEN).     HAN
│ │ │ │ +0001a340: 444c 453a 2073 6869 7368 6920 6861 6e64  DLE: shishi hand
│ │ │ │ +0001a350: 6c65 2061 7320 616c 6c6f 6361 7465 6420  le as allocated 
│ │ │ │ +0001a360: 6279 20e2 8098 7368 6973 6869 5f69 6e69  by ...shishi_ini
│ │ │ │ +0001a370: 7428 29e2 8099 2e0a 2020 2020 204b 5242  t().....     KRB
│ │ │ │ +0001a380: 4552 524f 523a 206b 7262 6572 726f 7220  ERROR: krberror 
│ │ │ │ +0001a390: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ +0001a3a0: e280 9873 6869 7368 695f 6b72 6265 7272  ...shishi_krberr
│ │ │ │ +0001a3b0: 6f72 2829 e280 992e 0a20 2020 2020 434c  or().....     CL
│ │ │ │ +0001a3c0: 4945 4e54 3a20 706f 696e 7465 7220 746f  IENT: pointer to
│ │ │ │ +0001a3d0: 206e 6577 6c79 2061 6c6c 6f63 6174 6564   newly allocated
│ │ │ │ +0001a3e0: 207a 6572 6f20 7465 726d 696e 6174 6564   zero terminated
│ │ │ │ +0001a3f0: 2073 7472 696e 670a 2020 2020 2063 6f6e   string.     con
│ │ │ │ +0001a400: 7461 696e 696e 6720 7072 696e 6369 7061  taining principa
│ │ │ │ +0001a410: 6c20 6e61 6d65 2e20 204d 6179 2062 6520  l name.  May be 
│ │ │ │ +0001a420: e280 984e 554c 4ce2 8099 2028 746f 206f  ...NULL... (to o
│ │ │ │ +0001a430: 6e6c 7920 706f 7075 6c61 7465 0a20 2020  nly populate.   
│ │ │ │ +0001a440: 2020 434c 4945 4e54 4c45 4e29 2e0a 2020    CLIENTLEN)..  
│ │ │ │ +0001a450: 2020 2043 4c49 454e 544c 454e 3a20 706f     CLIENTLEN: po
│ │ │ │ +0001a460: 696e 7465 7220 746f 206c 656e 6774 6820  inter to length 
│ │ │ │ +0001a470: 6f66 2043 4c49 454e 5420 6f6e 206f 7574  of CLIENT on out
│ │ │ │ +0001a480: 7075 742c 2065 7863 6c75 6469 6e67 0a20  put, excluding. 
│ │ │ │ +0001a490: 2020 2020 7465 726d 696e 6174 696e 6720      terminating 
│ │ │ │ +0001a4a0: 7a65 726f 2e20 204d 6179 2062 6520 e280  zero.  May be ..
│ │ │ │ +0001a4b0: 984e 554c 4ce2 8099 2028 746f 206f 6e6c  .NULL... (to onl
│ │ │ │ +0001a4c0: 7920 706f 7075 6c61 7465 2043 4c49 454e  y populate CLIEN
│ │ │ │ +0001a4d0: 5429 2e0a 0a20 2020 2020 2a44 6573 6372  T)...     *Descr
│ │ │ │ +0001a4e0: 6970 7469 6f6e 3a2a 2052 6574 7572 6e20  iption:* Return 
│ │ │ │ +0001a4f0: 636c 6965 6e74 2070 7269 6e63 6970 616c  client principal
│ │ │ │ +0001a500: 206e 616d 6520 696e 204b 5242 2d45 5252   name in KRB-ERR
│ │ │ │ +0001a510: 4f52 2e0a 0a20 2020 2020 2a52 6574 7572  OR...     *Retur
│ │ │ │ +0001a520: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ +0001a530: 7320 5348 4953 4849 5f4f 4b20 6966 6620  s SHISHI_OK iff 
│ │ │ │ +0001a540: 7375 6363 6573 7366 756c 2e0a 0a73 6869  successful...shi
│ │ │ │ +0001a550: 7368 695f 6b72 6265 7272 6f72 5f73 6574  shi_krberror_set
│ │ │ │ +0001a560: 5f63 6e61 6d65 0a2d 2d2d 2d2d 2d2d 2d2d  _cname.---------
│ │ │ │ +0001a570: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +0001a580: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +0001a590: 696e 7420 7368 6973 6869 5f6b 7262 6572  int shishi_krber
│ │ │ │ +0001a5a0: 726f 725f 7365 745f 636e 616d 6520 2853  ror_set_cname (S
│ │ │ │ +0001a5b0: 6869 7368 6920 2a20 4841 4e44 4c45 2c0a  hishi * HANDLE,.
│ │ │ │ +0001a5c0: 2020 2020 2020 2020 2020 5368 6973 6869            Shishi
│ │ │ │ +0001a5d0: 5f61 736e 3120 4b52 4245 5252 4f52 2c20  _asn1 KRBERROR, 
│ │ │ │ +0001a5e0: 5368 6973 6869 5f6e 616d 655f 7479 7065  Shishi_name_type
│ │ │ │ +0001a5f0: 204e 414d 455f 5459 5045 2c0a 2020 2020   NAME_TYPE,.    
│ │ │ │ +0001a600: 2020 2020 2020 636f 6e73 7420 6368 6172        const char
│ │ │ │ +0001a610: 202a 2043 4e41 4d45 5b5d 290a 2020 2020   * CNAME[]).    
│ │ │ │ +0001a620: 2048 414e 444c 453a 2073 6869 7368 6920   HANDLE: shishi 
│ │ │ │ +0001a630: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ +0001a640: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ +0001a650: 5f69 6e69 7428 29e2 8099 2e0a 2020 2020  _init().....    
│ │ │ │ +0001a660: 204b 5242 4552 524f 523a 206b 7262 6572   KRBERROR: krber
│ │ │ │ +0001a670: 726f 7220 6173 2061 6c6c 6f63 6174 6564  ror as allocated
│ │ │ │ +0001a680: 2062 7920 e280 9873 6869 7368 695f 6b72   by ...shishi_kr
│ │ │ │ +0001a690: 6265 7272 6f72 2829 e280 992e 0a20 2020  berror().....   
│ │ │ │ +0001a6a0: 2020 4e41 4d45 5f54 5950 453a 2074 7970    NAME_TYPE: typ
│ │ │ │ +0001a6b0: 6520 6f66 2070 7269 6e63 6970 6961 6c2c  e of principial,
│ │ │ │ +0001a6c0: 2073 6565 2053 6869 7368 695f 6e61 6d65   see Shishi_name
│ │ │ │ +0001a6d0: 5f74 7970 652c 2075 7375 616c 6c79 0a20  _type, usually. 
│ │ │ │ +0001a6e0: 2020 2020 5348 4953 4849 5f4e 545f 554e      SHISHI_NT_UN
│ │ │ │ +0001a6f0: 4b4e 4f57 4e2e 0a20 2020 2020 434e 414d  KNOWN..     CNAM
│ │ │ │ +0001a700: 453a 2069 6e70 7574 2061 7272 6179 2077  E: input array w
│ │ │ │ +0001a710: 6974 6820 7072 696e 6369 7061 6c20 6e61  ith principal na
│ │ │ │ +0001a720: 6d65 2e0a 0a20 2020 2020 2a44 6573 6372  me...     *Descr
│ │ │ │ +0001a730: 6970 7469 6f6e 3a2a 2053 6574 2070 7269  iption:* Set pri
│ │ │ │ +0001a740: 6e63 6970 616c 2066 6965 6c64 2069 6e20  ncipal field in 
│ │ │ │ +0001a750: 6b72 6265 7272 6f72 2074 6f20 7370 6563  krberror to spec
│ │ │ │ +0001a760: 6966 6965 6420 7661 6c75 652e 0a0a 2020  ified value...  
│ │ │ │ +0001a770: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ +0001a780: 3a2a 2052 6574 7572 6e73 2053 4849 5348  :* Returns SHISH
│ │ │ │ +0001a790: 495f 4f4b 2069 6666 2073 7563 6365 7373  I_OK iff success
│ │ │ │ +0001a7a0: 6675 6c2e 0a0a 7368 6973 6869 5f6b 7262  ful...shishi_krb
│ │ │ │ +0001a7b0: 6572 726f 725f 7265 6d6f 7665 5f63 6e61  error_remove_cna
│ │ │ │ +0001a7c0: 6d65 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  me.-------------
│ │ │ │ +0001a7d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +0001a7e0: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ +0001a7f0: 6e74 2073 6869 7368 695f 6b72 6265 7272  nt shishi_krberr
│ │ │ │ +0001a800: 6f72 5f72 656d 6f76 655f 636e 616d 6520  or_remove_cname 
│ │ │ │ +0001a810: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ +0001a820: 2c0a 2020 2020 2020 2020 2020 5368 6973  ,.          Shis
│ │ │ │ +0001a830: 6869 5f61 736e 3120 4b52 4245 5252 4f52  hi_asn1 KRBERROR
│ │ │ │ +0001a840: 290a 2020 2020 2048 414e 444c 453a 2073  ).     HANDLE: s
│ │ │ │ +0001a850: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ +0001a860: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ +0001a870: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ +0001a880: 2e0a 2020 2020 204b 5242 4552 524f 523a  ..     KRBERROR:
│ │ │ │ +0001a890: 206b 7262 6572 726f 7220 6173 2061 6c6c   krberror as all
│ │ │ │ +0001a8a0: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ +0001a8b0: 7368 695f 6b72 6265 7272 6f72 2829 e280  shi_krberror()..
│ │ │ │ +0001a8c0: 992e 0a0a 2020 2020 202a 4465 7363 7269  ....     *Descri
│ │ │ │ +0001a8d0: 7074 696f 6e3a 2a20 5265 6d6f 7665 2063  ption:* Remove c
│ │ │ │ +0001a8e0: 6c69 656e 7420 7265 616c 6d20 6669 656c  lient realm fiel
│ │ │ │ +0001a8f0: 6420 696e 204b 5242 2d45 5252 4f52 2e0a  d in KRB-ERROR..
│ │ │ │ +0001a900: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ +0001a910: 6c75 653a 2a20 5265 7475 726e 7320 5348  lue:* Returns SH
│ │ │ │ +0001a920: 4953 4849 5f4f 4b20 6966 6620 7375 6363  ISHI_OK iff succ
│ │ │ │ +0001a930: 6573 7366 756c 2e0a 0a73 6869 7368 695f  essful...shishi_
│ │ │ │ +0001a940: 6b72 6265 7272 6f72 5f63 6c69 656e 745f  krberror_client_
│ │ │ │ +0001a950: 7365 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  set.------------
│ │ │ │ +0001a960: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ +0001a970: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ +0001a980: 7420 7368 6973 6869 5f6b 7262 6572 726f  t shishi_krberro
│ │ │ │ +0001a990: 725f 636c 6965 6e74 5f73 6574 2028 5368  r_client_set (Sh
│ │ │ │ +0001a9a0: 6973 6869 202a 2048 414e 444c 452c 0a20  ishi * HANDLE,. 
│ │ │ │ +0001a9b0: 2020 2020 2020 2020 2053 6869 7368 695f           Shishi_
│ │ │ │ +0001a9c0: 6173 6e31 204b 5242 4552 524f 522c 2063  asn1 KRBERROR, c
│ │ │ │ +0001a9d0: 6f6e 7374 2063 6861 7220 2a20 434c 4945  onst char * CLIE
│ │ │ │ +0001a9e0: 4e54 290a 2020 2020 2048 414e 444c 453a  NT).     HANDLE:
│ │ │ │ +0001a9f0: 2073 6869 7368 6920 6861 6e64 6c65 2061   shishi handle a
│ │ │ │ +0001aa00: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ +0001aa10: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ +0001aa20: 8099 2e0a 2020 2020 204b 5242 4552 524f  ....     KRBERRO
│ │ │ │ +0001aa30: 523a 204b 7262 6572 726f 7220 746f 2073  R: Krberror to s
│ │ │ │ +0001aa40: 6574 2063 6c69 656e 7420 6e61 6d65 2066  et client name f
│ │ │ │ +0001aa50: 6965 6c64 2069 6e2e 0a20 2020 2020 434c  ield in..     CL
│ │ │ │ +0001aa60: 4945 4e54 3a20 7a65 726f 2d74 6572 6d69  IENT: zero-termi
│ │ │ │ +0001aa70: 6e61 7465 6420 7374 7269 6e67 2077 6974  nated string wit
│ │ │ │ +0001aa80: 6820 7072 696e 6369 7061 6c20 6e61 6d65  h principal name
│ │ │ │ +0001aa90: 206f 6e20 5246 4320 3139 3634 0a20 2020   on RFC 1964.   
│ │ │ │ +0001aaa0: 2020 666f 726d 2e0a 0a20 2020 2020 2a44    form...     *D
│ │ │ │ +0001aab0: 6573 6372 6970 7469 6f6e 3a2a 2053 6574  escription:* Set
│ │ │ │ +0001aac0: 2074 6865 2063 6c69 656e 7420 6e61 6d65   the client name
│ │ │ │ +0001aad0: 2066 6965 6c64 2069 6e20 7468 6520 4b72   field in the Kr
│ │ │ │ +0001aae0: 6265 7272 6f72 2e0a 0a20 2020 2020 2a52  berror...     *R
│ │ │ │ +0001aaf0: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +0001ab00: 7475 726e 7320 5348 4953 4849 5f4f 4b20  turns SHISHI_OK 
│ │ │ │ +0001ab10: 6966 6620 7375 6363 6573 7366 756c 2e0a  iff successful..
│ │ │ │ +0001ab20: 0a73 6869 7368 695f 6b72 6265 7272 6f72  .shishi_krberror
│ │ │ │ +0001ab30: 5f72 6561 6c6d 0a2d 2d2d 2d2d 2d2d 2d2d  _realm.---------
│ │ │ │ +0001ab40: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ +0001ab50: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ +0001ab60: 7368 6973 6869 5f6b 7262 6572 726f 725f  shishi_krberror_
│ │ │ │ +0001ab70: 7265 616c 6d20 2853 6869 7368 6920 2a20  realm (Shishi * 
│ │ │ │ +0001ab80: 4841 4e44 4c45 2c0a 2020 2020 2020 2020  HANDLE,.        
│ │ │ │ +0001ab90: 2020 5368 6973 6869 5f61 736e 3120 4b52    Shishi_asn1 KR
│ │ │ │ +0001aba0: 4245 5252 4f52 2c20 6368 6172 202a 2a20  BERROR, char ** 
│ │ │ │ +0001abb0: 5245 414c 4d2c 2073 697a 655f 7420 2a20  REALM, size_t * 
│ │ │ │ +0001abc0: 5245 414c 4d4c 454e 290a 2020 2020 2048  REALMLEN).     H
│ │ │ │ +0001abd0: 414e 444c 453a 2073 6869 7368 6920 6861  ANDLE: shishi ha
│ │ │ │ +0001abe0: 6e64 6c65 2061 7320 616c 6c6f 6361 7465  ndle as allocate
│ │ │ │ +0001abf0: 6420 6279 20e2 8098 7368 6973 6869 5f69  d by ...shishi_i
│ │ │ │ +0001ac00: 6e69 7428 29e2 8099 2e0a 2020 2020 204b  nit().....     K
│ │ │ │ +0001ac10: 5242 4552 524f 523a 206b 7262 6572 726f  RBERROR: krberro
│ │ │ │ +0001ac20: 7220 6173 2061 6c6c 6f63 6174 6564 2062  r as allocated b
│ │ │ │ +0001ac30: 7920 e280 9873 6869 7368 695f 6b72 6265  y ...shishi_krbe
│ │ │ │ +0001ac40: 7272 6f72 2829 e280 992e 0a20 2020 2020  rror().....     
│ │ │ │ +0001ac50: 5245 414c 4d3a 206f 7574 7075 7420 6172  REALM: output ar
│ │ │ │ +0001ac60: 7261 7920 7769 7468 206e 6577 6c79 2061  ray with newly a
│ │ │ │ +0001ac70: 6c6c 6f63 6174 6564 206e 616d 6520 6f66  llocated name of
│ │ │ │ +0001ac80: 2072 6561 6c6d 2069 6e0a 2020 2020 204b   realm in.     K
│ │ │ │ +0001ac90: 5242 2d45 5252 4f52 2e0a 2020 2020 2052  RB-ERROR..     R
│ │ │ │ +0001aca0: 4541 4c4d 4c45 4e3a 2073 697a 6520 6f66  EALMLEN: size of
│ │ │ │ +0001acb0: 206f 7574 7075 7420 6172 7261 792e 0a0a   output array...
│ │ │ │ +0001acc0: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ +0001acd0: 6e3a 2a20 4578 7472 6163 7420 2873 6572  n:* Extract (ser
│ │ │ │ +0001ace0: 7665 7229 2072 6561 6c6d 2066 726f 6d20  ver) realm from 
│ │ │ │ +0001acf0: 4b52 422d 4552 524f 522e 0a0a 2020 2020  KRB-ERROR...    
│ │ │ │ +0001ad00: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ +0001ad10: 2052 6574 7572 6e73 2053 4849 5348 495f   Returns SHISHI_
│ │ │ │ +0001ad20: 4f4b 2069 6666 2073 7563 6365 7373 6675  OK iff successfu
│ │ │ │ +0001ad30: 6c2e 0a0a 7368 6973 6869 5f6b 7262 6572  l...shishi_krber
│ │ │ │ +0001ad40: 726f 725f 7365 745f 7265 616c 6d0a 2d2d  ror_set_realm.--
│ │ │ │  0001ad50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0001ad60: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ -0001ad70: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ -0001ad80: 5f6b 7262 6572 726f 725f 7365 745f 7265  _krberror_set_re
│ │ │ │ -0001ad90: 616c 6d20 2853 6869 7368 6920 2a20 4841  alm (Shishi * HA
│ │ │ │ -0001ada0: 4e44 4c45 2c0a 2020 2020 2020 2020 2020  NDLE,.          
│ │ │ │ -0001adb0: 5368 6973 6869 5f61 736e 3120 4b52 4245  Shishi_asn1 KRBE
│ │ │ │ -0001adc0: 5252 4f52 2c20 636f 6e73 7420 6368 6172  RROR, const char
│ │ │ │ -0001add0: 202a 2052 4541 4c4d 290a 2020 2020 2048   * REALM).     H
│ │ │ │ -0001ade0: 414e 444c 453a 2073 6869 7368 6920 6861  ANDLE: shishi ha
│ │ │ │ -0001adf0: 6e64 6c65 2061 7320 616c 6c6f 6361 7465  ndle as allocate
│ │ │ │ -0001ae00: 6420 6279 20e2 8098 7368 6973 6869 5f69  d by ...shishi_i
│ │ │ │ -0001ae10: 6e69 7428 29e2 8099 2e0a 2020 2020 204b  nit().....     K
│ │ │ │ -0001ae20: 5242 4552 524f 523a 206b 7262 6572 726f  RBERROR: krberro
│ │ │ │ -0001ae30: 7220 6173 2061 6c6c 6f63 6174 6564 2062  r as allocated b
│ │ │ │ -0001ae40: 7920 e280 9873 6869 7368 695f 6b72 6265  y ...shishi_krbe
│ │ │ │ -0001ae50: 7272 6f72 2829 e280 992e 0a20 2020 2020  rror().....     
│ │ │ │ -0001ae60: 5245 414c 4d3a 2069 6e70 7574 2061 7272  REALM: input arr
│ │ │ │ -0001ae70: 6179 2077 6974 6820 2873 6572 7665 7229  ay with (server)
│ │ │ │ -0001ae80: 2072 6561 6c6d 2e0a 0a20 2020 2020 2a44   realm...     *D
│ │ │ │ -0001ae90: 6573 6372 6970 7469 6f6e 3a2a 2053 6574  escription:* Set
│ │ │ │ -0001aea0: 2028 7365 7276 6572 2920 7265 616c 6d20   (server) realm 
│ │ │ │ -0001aeb0: 6669 656c 6420 696e 206b 7262 6572 726f  field in krberro
│ │ │ │ -0001aec0: 7220 746f 2073 7065 6369 6669 6564 0a20  r to specified. 
│ │ │ │ -0001aed0: 2020 2020 7661 6c75 652e 0a0a 2020 2020      value...    
│ │ │ │ -0001aee0: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ -0001aef0: 2052 6574 7572 6e73 2053 4849 5348 495f   Returns SHISHI_
│ │ │ │ -0001af00: 4f4b 2069 6666 2073 7563 6365 7373 6675  OK iff successfu
│ │ │ │ -0001af10: 6c2e 0a0a 7368 6973 6869 5f6b 7262 6572  l...shishi_krber
│ │ │ │ -0001af20: 726f 725f 7365 7276 6572 0a2d 2d2d 2d2d  ror_server.-----
│ │ │ │ +0001ad60: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +0001ad70: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ +0001ad80: 695f 6b72 6265 7272 6f72 5f73 6574 5f72  i_krberror_set_r
│ │ │ │ +0001ad90: 6561 6c6d 2028 5368 6973 6869 202a 2048  ealm (Shishi * H
│ │ │ │ +0001ada0: 414e 444c 452c 0a20 2020 2020 2020 2020  ANDLE,.         
│ │ │ │ +0001adb0: 2053 6869 7368 695f 6173 6e31 204b 5242   Shishi_asn1 KRB
│ │ │ │ +0001adc0: 4552 524f 522c 2063 6f6e 7374 2063 6861  ERROR, const cha
│ │ │ │ +0001add0: 7220 2a20 5245 414c 4d29 0a20 2020 2020  r * REALM).     
│ │ │ │ +0001ade0: 4841 4e44 4c45 3a20 7368 6973 6869 2068  HANDLE: shishi h
│ │ │ │ +0001adf0: 616e 646c 6520 6173 2061 6c6c 6f63 6174  andle as allocat
│ │ │ │ +0001ae00: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ +0001ae10: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ +0001ae20: 4b52 4245 5252 4f52 3a20 6b72 6265 7272  KRBERROR: krberr
│ │ │ │ +0001ae30: 6f72 2061 7320 616c 6c6f 6361 7465 6420  or as allocated 
│ │ │ │ +0001ae40: 6279 20e2 8098 7368 6973 6869 5f6b 7262  by ...shishi_krb
│ │ │ │ +0001ae50: 6572 726f 7228 29e2 8099 2e0a 2020 2020  error().....    
│ │ │ │ +0001ae60: 2052 4541 4c4d 3a20 696e 7075 7420 6172   REALM: input ar
│ │ │ │ +0001ae70: 7261 7920 7769 7468 2028 7365 7276 6572  ray with (server
│ │ │ │ +0001ae80: 2920 7265 616c 6d2e 0a0a 2020 2020 202a  ) realm...     *
│ │ │ │ +0001ae90: 4465 7363 7269 7074 696f 6e3a 2a20 5365  Description:* Se
│ │ │ │ +0001aea0: 7420 2873 6572 7665 7229 2072 6561 6c6d  t (server) realm
│ │ │ │ +0001aeb0: 2066 6965 6c64 2069 6e20 6b72 6265 7272   field in krberr
│ │ │ │ +0001aec0: 6f72 2074 6f20 7370 6563 6966 6965 640a  or to specified.
│ │ │ │ +0001aed0: 2020 2020 2076 616c 7565 2e0a 0a20 2020       value...   
│ │ │ │ +0001aee0: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ +0001aef0: 2a20 5265 7475 726e 7320 5348 4953 4849  * Returns SHISHI
│ │ │ │ +0001af00: 5f4f 4b20 6966 6620 7375 6363 6573 7366  _OK iff successf
│ │ │ │ +0001af10: 756c 2e0a 0a73 6869 7368 695f 6b72 6265  ul...shishi_krbe
│ │ │ │ +0001af20: 7272 6f72 5f73 6572 7665 720a 2d2d 2d2d  rror_server.----
│ │ │ │  0001af30: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0001af40: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ -0001af50: 2069 6e74 2073 6869 7368 695f 6b72 6265   int shishi_krbe
│ │ │ │ -0001af60: 7272 6f72 5f73 6572 7665 7220 2853 6869  rror_server (Shi
│ │ │ │ -0001af70: 7368 6920 2a20 4841 4e44 4c45 2c0a 2020  shi * HANDLE,.  
│ │ │ │ -0001af80: 2020 2020 2020 2020 5368 6973 6869 5f61          Shishi_a
│ │ │ │ -0001af90: 736e 3120 4b52 4245 5252 4f52 2c20 6368  sn1 KRBERROR, ch
│ │ │ │ -0001afa0: 6172 202a 2a20 5345 5256 4552 2c20 7369  ar ** SERVER, si
│ │ │ │ -0001afb0: 7a65 5f74 202a 2053 4552 5645 524c 454e  ze_t * SERVERLEN
│ │ │ │ -0001afc0: 290a 2020 2020 2048 414e 444c 453a 2073  ).     HANDLE: s
│ │ │ │ -0001afd0: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ -0001afe0: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ -0001aff0: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ -0001b000: 2e0a 2020 2020 204b 5242 4552 524f 523a  ..     KRBERROR:
│ │ │ │ -0001b010: 206b 7262 6572 726f 7220 6173 2061 6c6c   krberror as all
│ │ │ │ -0001b020: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ -0001b030: 7368 695f 6b72 6265 7272 6f72 2829 e280  shi_krberror()..
│ │ │ │ -0001b040: 992e 0a20 2020 2020 5345 5256 4552 3a20  ...     SERVER: 
│ │ │ │ -0001b050: 706f 696e 7465 7220 746f 206e 6577 6c79  pointer to newly
│ │ │ │ -0001b060: 2061 6c6c 6f63 6174 6564 207a 6572 6f20   allocated zero 
│ │ │ │ -0001b070: 7465 726d 696e 6174 6564 2073 7472 696e  terminated strin
│ │ │ │ -0001b080: 670a 2020 2020 2063 6f6e 7461 696e 696e  g.     containin
│ │ │ │ -0001b090: 6720 7365 7276 6572 206e 616d 652e 2020  g server name.  
│ │ │ │ -0001b0a0: 4d61 7920 6265 20e2 8098 4e55 4c4c e280  May be ...NULL..
│ │ │ │ -0001b0b0: 9920 2874 6f20 6f6e 6c79 2070 6f70 756c  . (to only popul
│ │ │ │ -0001b0c0: 6174 650a 2020 2020 2053 4552 5645 524c  ate.     SERVERL
│ │ │ │ -0001b0d0: 454e 292e 0a20 2020 2020 5345 5256 4552  EN)..     SERVER
│ │ │ │ -0001b0e0: 4c45 4e3a 2070 6f69 6e74 6572 2074 6f20  LEN: pointer to 
│ │ │ │ -0001b0f0: 6c65 6e67 7468 206f 6620 5345 5256 4552  length of SERVER
│ │ │ │ -0001b100: 206f 6e20 6f75 7470 7574 2c20 6578 636c   on output, excl
│ │ │ │ -0001b110: 7564 696e 670a 2020 2020 2074 6572 6d69  uding.     termi
│ │ │ │ -0001b120: 6e61 7469 6e67 207a 6572 6f2e 2020 4d61  nating zero.  Ma
│ │ │ │ -0001b130: 7920 6265 20e2 8098 4e55 4c4c e280 9920  y be ...NULL... 
│ │ │ │ -0001b140: 2874 6f20 6f6e 6c79 2070 6f70 756c 6174  (to only populat
│ │ │ │ -0001b150: 6520 5345 5256 4552 292e 0a0a 2020 2020  e SERVER)...    
│ │ │ │ -0001b160: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ -0001b170: 5265 7475 726e 2073 6572 7665 7220 7072  Return server pr
│ │ │ │ -0001b180: 696e 6369 7061 6c20 6e61 6d65 2069 6e20  incipal name in 
│ │ │ │ -0001b190: 4b52 422d 4552 524f 522e 0a0a 2020 2020  KRB-ERROR...    
│ │ │ │ -0001b1a0: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ -0001b1b0: 2052 6574 7572 6e73 2053 4849 5348 495f   Returns SHISHI_
│ │ │ │ -0001b1c0: 4f4b 2069 6666 2073 7563 6365 7373 6675  OK iff successfu
│ │ │ │ -0001b1d0: 6c2e 0a0a 7368 6973 6869 5f6b 7262 6572  l...shishi_krber
│ │ │ │ -0001b1e0: 726f 725f 7265 6d6f 7665 5f73 6e61 6d65  ror_remove_sname
│ │ │ │ -0001b1f0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ -0001b200: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -0001b210: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ -0001b220: 2073 6869 7368 695f 6b72 6265 7272 6f72   shishi_krberror
│ │ │ │ -0001b230: 5f72 656d 6f76 655f 736e 616d 6520 2853  _remove_sname (S
│ │ │ │ -0001b240: 6869 7368 6920 2a20 4841 4e44 4c45 2c0a  hishi * HANDLE,.
│ │ │ │ -0001b250: 2020 2020 2020 2020 2020 5368 6973 6869            Shishi
│ │ │ │ -0001b260: 5f61 736e 3120 4b52 4245 5252 4f52 290a  _asn1 KRBERROR).
│ │ │ │ -0001b270: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ -0001b280: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ -0001b290: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ -0001b2a0: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ -0001b2b0: 2020 2020 204b 5242 4552 524f 523a 204b       KRBERROR: K
│ │ │ │ -0001b2c0: 7262 6572 726f 7220 746f 2073 6574 2073  rberror to set s
│ │ │ │ -0001b2d0: 6572 7665 7220 6e61 6d65 2066 6965 6c64  erver name field
│ │ │ │ -0001b2e0: 2069 6e2e 0a0a 2020 2020 202a 4465 7363   in...     *Desc
│ │ │ │ -0001b2f0: 7269 7074 696f 6e3a 2a20 5265 6d6f 7665  ription:* Remove
│ │ │ │ -0001b300: 2073 6572 7665 7220 6e61 6d65 2066 6965   server name fie
│ │ │ │ -0001b310: 6c64 2069 6e20 4b52 422d 4552 524f 522e  ld in KRB-ERROR.
│ │ │ │ -0001b320: 2028 5369 6e63 6520 6974 2069 730a 2020   (Since it is.  
│ │ │ │ -0001b330: 2020 206e 6f74 206d 6172 6b65 6420 4f50     not marked OP
│ │ │ │ -0001b340: 5449 4f4e 414c 2069 6e20 7468 6520 4153  TIONAL in the AS
│ │ │ │ -0001b350: 4e2e 3120 7072 6f66 696c 652c 2077 6861  N.1 profile, wha
│ │ │ │ -0001b360: 7420 6973 2064 6f6e 6520 6973 2074 6f20  t is done is to 
│ │ │ │ -0001b370: 7365 740a 2020 2020 2074 6865 206e 616d  set.     the nam
│ │ │ │ -0001b380: 652d 7479 7065 2074 6f20 554e 4b4e 4f57  e-type to UNKNOW
│ │ │ │ -0001b390: 4e20 616e 6420 6d61 6b65 2073 7572 6520  N and make sure 
│ │ │ │ -0001b3a0: 7468 6520 6e61 6d65 2d73 7472 696e 6720  the name-string 
│ │ │ │ -0001b3b0: 7365 7175 656e 6365 2069 730a 2020 2020  sequence is.    
│ │ │ │ -0001b3c0: 2065 6d70 7479 2e29 0a0a 2020 2020 202a   empty.)..     *
│ │ │ │ -0001b3d0: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ -0001b3e0: 6574 7572 6e73 2053 4849 5348 495f 4f4b  eturns SHISHI_OK
│ │ │ │ -0001b3f0: 2069 6666 2073 7563 6365 7373 6675 6c2e   iff successful.
│ │ │ │ -0001b400: 0a0a 7368 6973 6869 5f6b 7262 6572 726f  ..shishi_krberro
│ │ │ │ -0001b410: 725f 7365 745f 736e 616d 650a 2d2d 2d2d  r_set_sname.----
│ │ │ │ +0001af40: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ +0001af50: 3a20 696e 7420 7368 6973 6869 5f6b 7262  : int shishi_krb
│ │ │ │ +0001af60: 6572 726f 725f 7365 7276 6572 2028 5368  error_server (Sh
│ │ │ │ +0001af70: 6973 6869 202a 2048 414e 444c 452c 0a20  ishi * HANDLE,. 
│ │ │ │ +0001af80: 2020 2020 2020 2020 2053 6869 7368 695f           Shishi_
│ │ │ │ +0001af90: 6173 6e31 204b 5242 4552 524f 522c 2063  asn1 KRBERROR, c
│ │ │ │ +0001afa0: 6861 7220 2a2a 2053 4552 5645 522c 2073  har ** SERVER, s
│ │ │ │ +0001afb0: 697a 655f 7420 2a20 5345 5256 4552 4c45  ize_t * SERVERLE
│ │ │ │ +0001afc0: 4e29 0a20 2020 2020 4841 4e44 4c45 3a20  N).     HANDLE: 
│ │ │ │ +0001afd0: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ +0001afe0: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ +0001aff0: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ +0001b000: 992e 0a20 2020 2020 4b52 4245 5252 4f52  ...     KRBERROR
│ │ │ │ +0001b010: 3a20 6b72 6265 7272 6f72 2061 7320 616c  : krberror as al
│ │ │ │ +0001b020: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ +0001b030: 6973 6869 5f6b 7262 6572 726f 7228 29e2  ishi_krberror().
│ │ │ │ +0001b040: 8099 2e0a 2020 2020 2053 4552 5645 523a  ....     SERVER:
│ │ │ │ +0001b050: 2070 6f69 6e74 6572 2074 6f20 6e65 776c   pointer to newl
│ │ │ │ +0001b060: 7920 616c 6c6f 6361 7465 6420 7a65 726f  y allocated zero
│ │ │ │ +0001b070: 2074 6572 6d69 6e61 7465 6420 7374 7269   terminated stri
│ │ │ │ +0001b080: 6e67 0a20 2020 2020 636f 6e74 6169 6e69  ng.     containi
│ │ │ │ +0001b090: 6e67 2073 6572 7665 7220 6e61 6d65 2e20  ng server name. 
│ │ │ │ +0001b0a0: 204d 6179 2062 6520 e280 984e 554c 4ce2   May be ...NULL.
│ │ │ │ +0001b0b0: 8099 2028 746f 206f 6e6c 7920 706f 7075  .. (to only popu
│ │ │ │ +0001b0c0: 6c61 7465 0a20 2020 2020 5345 5256 4552  late.     SERVER
│ │ │ │ +0001b0d0: 4c45 4e29 2e0a 2020 2020 2053 4552 5645  LEN)..     SERVE
│ │ │ │ +0001b0e0: 524c 454e 3a20 706f 696e 7465 7220 746f  RLEN: pointer to
│ │ │ │ +0001b0f0: 206c 656e 6774 6820 6f66 2053 4552 5645   length of SERVE
│ │ │ │ +0001b100: 5220 6f6e 206f 7574 7075 742c 2065 7863  R on output, exc
│ │ │ │ +0001b110: 6c75 6469 6e67 0a20 2020 2020 7465 726d  luding.     term
│ │ │ │ +0001b120: 696e 6174 696e 6720 7a65 726f 2e20 204d  inating zero.  M
│ │ │ │ +0001b130: 6179 2062 6520 e280 984e 554c 4ce2 8099  ay be ...NULL...
│ │ │ │ +0001b140: 2028 746f 206f 6e6c 7920 706f 7075 6c61   (to only popula
│ │ │ │ +0001b150: 7465 2053 4552 5645 5229 2e0a 0a20 2020  te SERVER)...   
│ │ │ │ +0001b160: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ +0001b170: 2052 6574 7572 6e20 7365 7276 6572 2070   Return server p
│ │ │ │ +0001b180: 7269 6e63 6970 616c 206e 616d 6520 696e  rincipal name in
│ │ │ │ +0001b190: 204b 5242 2d45 5252 4f52 2e0a 0a20 2020   KRB-ERROR...   
│ │ │ │ +0001b1a0: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ +0001b1b0: 2a20 5265 7475 726e 7320 5348 4953 4849  * Returns SHISHI
│ │ │ │ +0001b1c0: 5f4f 4b20 6966 6620 7375 6363 6573 7366  _OK iff successf
│ │ │ │ +0001b1d0: 756c 2e0a 0a73 6869 7368 695f 6b72 6265  ul...shishi_krbe
│ │ │ │ +0001b1e0: 7272 6f72 5f72 656d 6f76 655f 736e 616d  rror_remove_snam
│ │ │ │ +0001b1f0: 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  e.--------------
│ │ │ │ +0001b200: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ +0001b210: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ +0001b220: 7420 7368 6973 6869 5f6b 7262 6572 726f  t shishi_krberro
│ │ │ │ +0001b230: 725f 7265 6d6f 7665 5f73 6e61 6d65 2028  r_remove_sname (
│ │ │ │ +0001b240: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ +0001b250: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ +0001b260: 695f 6173 6e31 204b 5242 4552 524f 5229  i_asn1 KRBERROR)
│ │ │ │ +0001b270: 0a20 2020 2020 4841 4e44 4c45 3a20 7368  .     HANDLE: sh
│ │ │ │ +0001b280: 6973 6869 2068 616e 646c 6520 6173 2061  ishi handle as a
│ │ │ │ +0001b290: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ +0001b2a0: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ +0001b2b0: 0a20 2020 2020 4b52 4245 5252 4f52 3a20  .     KRBERROR: 
│ │ │ │ +0001b2c0: 4b72 6265 7272 6f72 2074 6f20 7365 7420  Krberror to set 
│ │ │ │ +0001b2d0: 7365 7276 6572 206e 616d 6520 6669 656c  server name fiel
│ │ │ │ +0001b2e0: 6420 696e 2e0a 0a20 2020 2020 2a44 6573  d in...     *Des
│ │ │ │ +0001b2f0: 6372 6970 7469 6f6e 3a2a 2052 656d 6f76  cription:* Remov
│ │ │ │ +0001b300: 6520 7365 7276 6572 206e 616d 6520 6669  e server name fi
│ │ │ │ +0001b310: 656c 6420 696e 204b 5242 2d45 5252 4f52  eld in KRB-ERROR
│ │ │ │ +0001b320: 2e20 2853 696e 6365 2069 7420 6973 0a20  . (Since it is. 
│ │ │ │ +0001b330: 2020 2020 6e6f 7420 6d61 726b 6564 204f      not marked O
│ │ │ │ +0001b340: 5054 494f 4e41 4c20 696e 2074 6865 2041  PTIONAL in the A
│ │ │ │ +0001b350: 534e 2e31 2070 726f 6669 6c65 2c20 7768  SN.1 profile, wh
│ │ │ │ +0001b360: 6174 2069 7320 646f 6e65 2069 7320 746f  at is done is to
│ │ │ │ +0001b370: 2073 6574 0a20 2020 2020 7468 6520 6e61   set.     the na
│ │ │ │ +0001b380: 6d65 2d74 7970 6520 746f 2055 4e4b 4e4f  me-type to UNKNO
│ │ │ │ +0001b390: 574e 2061 6e64 206d 616b 6520 7375 7265  WN and make sure
│ │ │ │ +0001b3a0: 2074 6865 206e 616d 652d 7374 7269 6e67   the name-string
│ │ │ │ +0001b3b0: 2073 6571 7565 6e63 6520 6973 0a20 2020   sequence is.   
│ │ │ │ +0001b3c0: 2020 656d 7074 792e 290a 0a20 2020 2020    empty.)..     
│ │ │ │ +0001b3d0: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ +0001b3e0: 5265 7475 726e 7320 5348 4953 4849 5f4f  Returns SHISHI_O
│ │ │ │ +0001b3f0: 4b20 6966 6620 7375 6363 6573 7366 756c  K iff successful
│ │ │ │ +0001b400: 2e0a 0a73 6869 7368 695f 6b72 6265 7272  ...shishi_krberr
│ │ │ │ +0001b410: 6f72 5f73 6574 5f73 6e61 6d65 0a2d 2d2d  or_set_sname.---
│ │ │ │  0001b420: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0001b430: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ -0001b440: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ -0001b450: 6b72 6265 7272 6f72 5f73 6574 5f73 6e61  krberror_set_sna
│ │ │ │ -0001b460: 6d65 2028 5368 6973 6869 202a 2048 414e  me (Shishi * HAN
│ │ │ │ -0001b470: 444c 452c 0a20 2020 2020 2020 2020 2053  DLE,.          S
│ │ │ │ -0001b480: 6869 7368 695f 6173 6e31 204b 5242 4552  hishi_asn1 KRBER
│ │ │ │ -0001b490: 524f 522c 2053 6869 7368 695f 6e61 6d65  ROR, Shishi_name
│ │ │ │ -0001b4a0: 5f74 7970 6520 4e41 4d45 5f54 5950 452c  _type NAME_TYPE,
│ │ │ │ -0001b4b0: 0a20 2020 2020 2020 2020 2063 6f6e 7374  .          const
│ │ │ │ -0001b4c0: 2063 6861 7220 2a20 534e 414d 455b 5d29   char * SNAME[])
│ │ │ │ -0001b4d0: 0a20 2020 2020 4841 4e44 4c45 3a20 7368  .     HANDLE: sh
│ │ │ │ -0001b4e0: 6973 6869 2068 616e 646c 6520 6173 2061  ishi handle as a
│ │ │ │ -0001b4f0: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ -0001b500: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ -0001b510: 0a20 2020 2020 4b52 4245 5252 4f52 3a20  .     KRBERROR: 
│ │ │ │ -0001b520: 6b72 6265 7272 6f72 2061 7320 616c 6c6f  krberror as allo
│ │ │ │ -0001b530: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ -0001b540: 6869 5f6b 7262 6572 726f 7228 29e2 8099  hi_krberror()...
│ │ │ │ -0001b550: 2e0a 2020 2020 204e 414d 455f 5459 5045  ..     NAME_TYPE
│ │ │ │ -0001b560: 3a20 7479 7065 206f 6620 7072 696e 6369  : type of princi
│ │ │ │ -0001b570: 7069 616c 2c20 7365 6520 5368 6973 6869  pial, see Shishi
│ │ │ │ -0001b580: 5f6e 616d 655f 7479 7065 2c20 7573 7561  _name_type, usua
│ │ │ │ -0001b590: 6c6c 790a 2020 2020 2053 4849 5348 495f  lly.     SHISHI_
│ │ │ │ -0001b5a0: 4e54 5f55 4e4b 4e4f 574e 2e0a 2020 2020  NT_UNKNOWN..    
│ │ │ │ -0001b5b0: 2053 4e41 4d45 3a20 696e 7075 7420 6172   SNAME: input ar
│ │ │ │ -0001b5c0: 7261 7920 7769 7468 2070 7269 6e63 6970  ray with princip
│ │ │ │ -0001b5d0: 616c 206e 616d 652e 0a0a 2020 2020 202a  al name...     *
│ │ │ │ -0001b5e0: 4465 7363 7269 7074 696f 6e3a 2a20 5365  Description:* Se
│ │ │ │ -0001b5f0: 7420 7072 696e 6369 7061 6c20 6669 656c  t principal fiel
│ │ │ │ -0001b600: 6420 696e 206b 7262 6572 726f 7220 746f  d in krberror to
│ │ │ │ -0001b610: 2073 7065 6369 6669 6564 2076 616c 7565   specified value
│ │ │ │ -0001b620: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ -0001b630: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ -0001b640: 5348 4953 4849 5f4f 4b20 6966 6620 7375  SHISHI_OK iff su
│ │ │ │ -0001b650: 6363 6573 7366 756c 2e0a 0a73 6869 7368  ccessful...shish
│ │ │ │ -0001b660: 695f 6b72 6265 7272 6f72 5f73 6572 7665  i_krberror_serve
│ │ │ │ -0001b670: 725f 7365 740a 2d2d 2d2d 2d2d 2d2d 2d2d  r_set.----------
│ │ │ │ +0001b430: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ +0001b440: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ +0001b450: 5f6b 7262 6572 726f 725f 7365 745f 736e  _krberror_set_sn
│ │ │ │ +0001b460: 616d 6520 2853 6869 7368 6920 2a20 4841  ame (Shishi * HA
│ │ │ │ +0001b470: 4e44 4c45 2c0a 2020 2020 2020 2020 2020  NDLE,.          
│ │ │ │ +0001b480: 5368 6973 6869 5f61 736e 3120 4b52 4245  Shishi_asn1 KRBE
│ │ │ │ +0001b490: 5252 4f52 2c20 5368 6973 6869 5f6e 616d  RROR, Shishi_nam
│ │ │ │ +0001b4a0: 655f 7479 7065 204e 414d 455f 5459 5045  e_type NAME_TYPE
│ │ │ │ +0001b4b0: 2c0a 2020 2020 2020 2020 2020 636f 6e73  ,.          cons
│ │ │ │ +0001b4c0: 7420 6368 6172 202a 2053 4e41 4d45 5b5d  t char * SNAME[]
│ │ │ │ +0001b4d0: 290a 2020 2020 2048 414e 444c 453a 2073  ).     HANDLE: s
│ │ │ │ +0001b4e0: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ +0001b4f0: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ +0001b500: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ +0001b510: 2e0a 2020 2020 204b 5242 4552 524f 523a  ..     KRBERROR:
│ │ │ │ +0001b520: 206b 7262 6572 726f 7220 6173 2061 6c6c   krberror as all
│ │ │ │ +0001b530: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ +0001b540: 7368 695f 6b72 6265 7272 6f72 2829 e280  shi_krberror()..
│ │ │ │ +0001b550: 992e 0a20 2020 2020 4e41 4d45 5f54 5950  ...     NAME_TYP
│ │ │ │ +0001b560: 453a 2074 7970 6520 6f66 2070 7269 6e63  E: type of princ
│ │ │ │ +0001b570: 6970 6961 6c2c 2073 6565 2053 6869 7368  ipial, see Shish
│ │ │ │ +0001b580: 695f 6e61 6d65 5f74 7970 652c 2075 7375  i_name_type, usu
│ │ │ │ +0001b590: 616c 6c79 0a20 2020 2020 5348 4953 4849  ally.     SHISHI
│ │ │ │ +0001b5a0: 5f4e 545f 554e 4b4e 4f57 4e2e 0a20 2020  _NT_UNKNOWN..   
│ │ │ │ +0001b5b0: 2020 534e 414d 453a 2069 6e70 7574 2061    SNAME: input a
│ │ │ │ +0001b5c0: 7272 6179 2077 6974 6820 7072 696e 6369  rray with princi
│ │ │ │ +0001b5d0: 7061 6c20 6e61 6d65 2e0a 0a20 2020 2020  pal name...     
│ │ │ │ +0001b5e0: 2a44 6573 6372 6970 7469 6f6e 3a2a 2053  *Description:* S
│ │ │ │ +0001b5f0: 6574 2070 7269 6e63 6970 616c 2066 6965  et principal fie
│ │ │ │ +0001b600: 6c64 2069 6e20 6b72 6265 7272 6f72 2074  ld in krberror t
│ │ │ │ +0001b610: 6f20 7370 6563 6966 6965 6420 7661 6c75  o specified valu
│ │ │ │ +0001b620: 652e 0a0a 2020 2020 202a 5265 7475 726e  e...     *Return
│ │ │ │ +0001b630: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ +0001b640: 2053 4849 5348 495f 4f4b 2069 6666 2073   SHISHI_OK iff s
│ │ │ │ +0001b650: 7563 6365 7373 6675 6c2e 0a0a 7368 6973  uccessful...shis
│ │ │ │ +0001b660: 6869 5f6b 7262 6572 726f 725f 7365 7276  hi_krberror_serv
│ │ │ │ +0001b670: 6572 5f73 6574 0a2d 2d2d 2d2d 2d2d 2d2d  er_set.---------
│ │ │ │  0001b680: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0001b690: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ -0001b6a0: 696e 7420 7368 6973 6869 5f6b 7262 6572  int shishi_krber
│ │ │ │ -0001b6b0: 726f 725f 7365 7276 6572 5f73 6574 2028  ror_server_set (
│ │ │ │ -0001b6c0: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ -0001b6d0: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ -0001b6e0: 695f 6173 6e31 204b 5242 4552 524f 522c  i_asn1 KRBERROR,
│ │ │ │ -0001b6f0: 2063 6f6e 7374 2063 6861 7220 2a20 5345   const char * SE
│ │ │ │ -0001b700: 5256 4552 290a 2020 2020 2048 414e 444c  RVER).     HANDL
│ │ │ │ -0001b710: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ -0001b720: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ -0001b730: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ -0001b740: 29e2 8099 2e0a 2020 2020 204b 5242 4552  ).....     KRBER
│ │ │ │ -0001b750: 524f 523a 204b 7262 6572 726f 7220 746f  ROR: Krberror to
│ │ │ │ -0001b760: 2073 6574 2073 6572 7665 7220 6e61 6d65   set server name
│ │ │ │ -0001b770: 2066 6965 6c64 2069 6e2e 0a20 2020 2020   field in..     
│ │ │ │ -0001b780: 5345 5256 4552 3a20 7a65 726f 2d74 6572  SERVER: zero-ter
│ │ │ │ -0001b790: 6d69 6e61 7465 6420 7374 7269 6e67 2077  minated string w
│ │ │ │ -0001b7a0: 6974 6820 7072 696e 6369 7061 6c20 6e61  ith principal na
│ │ │ │ -0001b7b0: 6d65 206f 6e20 5246 4320 3139 3634 0a20  me on RFC 1964. 
│ │ │ │ -0001b7c0: 2020 2020 666f 726d 2e0a 0a20 2020 2020      form...     
│ │ │ │ -0001b7d0: 2a44 6573 6372 6970 7469 6f6e 3a2a 2053  *Description:* S
│ │ │ │ -0001b7e0: 6574 2074 6865 2073 6572 7665 7220 6e61  et the server na
│ │ │ │ -0001b7f0: 6d65 2066 6965 6c64 2069 6e20 7468 6520  me field in the 
│ │ │ │ -0001b800: 4b72 6265 7272 6f72 2e0a 0a20 2020 2020  Krberror...     
│ │ │ │ -0001b810: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ -0001b820: 5265 7475 726e 7320 5348 4953 4849 5f4f  Returns SHISHI_O
│ │ │ │ -0001b830: 4b20 6966 6620 7375 6363 6573 7366 756c  K iff successful
│ │ │ │ -0001b840: 2e0a 0a73 6869 7368 695f 6b72 6265 7272  ...shishi_krberr
│ │ │ │ -0001b850: 6f72 5f63 7469 6d65 0a2d 2d2d 2d2d 2d2d  or_ctime.-------
│ │ │ │ -0001b860: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -0001b870: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ -0001b880: 7420 7368 6973 6869 5f6b 7262 6572 726f  t shishi_krberro
│ │ │ │ -0001b890: 725f 6374 696d 6520 2853 6869 7368 6920  r_ctime (Shishi 
│ │ │ │ -0001b8a0: 2a20 4841 4e44 4c45 2c0a 2020 2020 2020  * HANDLE,.      
│ │ │ │ -0001b8b0: 2020 2020 5368 6973 6869 5f61 736e 3120      Shishi_asn1 
│ │ │ │ -0001b8c0: 4b52 4245 5252 4f52 2c20 6368 6172 202a  KRBERROR, char *
│ │ │ │ -0001b8d0: 2a20 5429 0a20 2020 2020 4841 4e44 4c45  * T).     HANDLE
│ │ │ │ -0001b8e0: 3a20 7368 6973 6869 2068 616e 646c 6520  : shishi handle 
│ │ │ │ -0001b8f0: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ -0001b900: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ -0001b910: e280 992e 0a20 2020 2020 4b52 4245 5252  .....     KRBERR
│ │ │ │ -0001b920: 4f52 3a20 4b72 6265 7272 6f72 2074 6f20  OR: Krberror to 
│ │ │ │ -0001b930: 7365 7420 636c 6965 6e74 206e 616d 6520  set client name 
│ │ │ │ -0001b940: 6669 656c 6420 696e 2e0a 2020 2020 2054  field in..     T
│ │ │ │ -0001b950: 3a20 6e65 776c 7920 616c 6c6f 6361 7465  : newly allocate
│ │ │ │ -0001b960: 6420 7a65 726f 2d74 6572 6d69 6e61 7465  d zero-terminate
│ │ │ │ -0001b970: 6420 6f75 7470 7574 2061 7272 6179 2077  d output array w
│ │ │ │ -0001b980: 6974 6820 636c 6965 6e74 2074 696d 652e  ith client time.
│ │ │ │ -0001b990: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ -0001b9a0: 696f 6e3a 2a20 4578 7472 6163 7420 636c  ion:* Extract cl
│ │ │ │ -0001b9b0: 6965 6e74 2074 696d 6520 6672 6f6d 204b  ient time from K
│ │ │ │ -0001b9c0: 5242 2d45 5252 4f52 2e0a 0a20 2020 2020  RB-ERROR...     
│ │ │ │ -0001b9d0: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ -0001b9e0: 5265 7475 726e 7320 5348 4953 4849 5f4f  Returns SHISHI_O
│ │ │ │ -0001b9f0: 4b20 6966 6620 7375 6363 6573 7366 756c  K iff successful
│ │ │ │ -0001ba00: 2e0a 0a73 6869 7368 695f 6b72 6265 7272  ...shishi_krberr
│ │ │ │ -0001ba10: 6f72 5f63 7469 6d65 5f73 6574 0a2d 2d2d  or_ctime_set.---
│ │ │ │ +0001b690: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ +0001b6a0: 2069 6e74 2073 6869 7368 695f 6b72 6265   int shishi_krbe
│ │ │ │ +0001b6b0: 7272 6f72 5f73 6572 7665 725f 7365 7420  rror_server_set 
│ │ │ │ +0001b6c0: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ +0001b6d0: 2c0a 2020 2020 2020 2020 2020 5368 6973  ,.          Shis
│ │ │ │ +0001b6e0: 6869 5f61 736e 3120 4b52 4245 5252 4f52  hi_asn1 KRBERROR
│ │ │ │ +0001b6f0: 2c20 636f 6e73 7420 6368 6172 202a 2053  , const char * S
│ │ │ │ +0001b700: 4552 5645 5229 0a20 2020 2020 4841 4e44  ERVER).     HAND
│ │ │ │ +0001b710: 4c45 3a20 7368 6973 6869 2068 616e 646c  LE: shishi handl
│ │ │ │ +0001b720: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ +0001b730: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ +0001b740: 2829 e280 992e 0a20 2020 2020 4b52 4245  ().....     KRBE
│ │ │ │ +0001b750: 5252 4f52 3a20 4b72 6265 7272 6f72 2074  RROR: Krberror t
│ │ │ │ +0001b760: 6f20 7365 7420 7365 7276 6572 206e 616d  o set server nam
│ │ │ │ +0001b770: 6520 6669 656c 6420 696e 2e0a 2020 2020  e field in..    
│ │ │ │ +0001b780: 2053 4552 5645 523a 207a 6572 6f2d 7465   SERVER: zero-te
│ │ │ │ +0001b790: 726d 696e 6174 6564 2073 7472 696e 6720  rminated string 
│ │ │ │ +0001b7a0: 7769 7468 2070 7269 6e63 6970 616c 206e  with principal n
│ │ │ │ +0001b7b0: 616d 6520 6f6e 2052 4643 2031 3936 340a  ame on RFC 1964.
│ │ │ │ +0001b7c0: 2020 2020 2066 6f72 6d2e 0a0a 2020 2020       form...    
│ │ │ │ +0001b7d0: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ +0001b7e0: 5365 7420 7468 6520 7365 7276 6572 206e  Set the server n
│ │ │ │ +0001b7f0: 616d 6520 6669 656c 6420 696e 2074 6865  ame field in the
│ │ │ │ +0001b800: 204b 7262 6572 726f 722e 0a0a 2020 2020   Krberror...    
│ │ │ │ +0001b810: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ +0001b820: 2052 6574 7572 6e73 2053 4849 5348 495f   Returns SHISHI_
│ │ │ │ +0001b830: 4f4b 2069 6666 2073 7563 6365 7373 6675  OK iff successfu
│ │ │ │ +0001b840: 6c2e 0a0a 7368 6973 6869 5f6b 7262 6572  l...shishi_krber
│ │ │ │ +0001b850: 726f 725f 6374 696d 650a 2d2d 2d2d 2d2d  ror_ctime.------
│ │ │ │ +0001b860: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +0001b870: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ +0001b880: 6e74 2073 6869 7368 695f 6b72 6265 7272  nt shishi_krberr
│ │ │ │ +0001b890: 6f72 5f63 7469 6d65 2028 5368 6973 6869  or_ctime (Shishi
│ │ │ │ +0001b8a0: 202a 2048 414e 444c 452c 0a20 2020 2020   * HANDLE,.     
│ │ │ │ +0001b8b0: 2020 2020 2053 6869 7368 695f 6173 6e31       Shishi_asn1
│ │ │ │ +0001b8c0: 204b 5242 4552 524f 522c 2063 6861 7220   KRBERROR, char 
│ │ │ │ +0001b8d0: 2a2a 2054 290a 2020 2020 2048 414e 444c  ** T).     HANDL
│ │ │ │ +0001b8e0: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ +0001b8f0: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ +0001b900: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ +0001b910: 29e2 8099 2e0a 2020 2020 204b 5242 4552  ).....     KRBER
│ │ │ │ +0001b920: 524f 523a 204b 7262 6572 726f 7220 746f  ROR: Krberror to
│ │ │ │ +0001b930: 2073 6574 2063 6c69 656e 7420 6e61 6d65   set client name
│ │ │ │ +0001b940: 2066 6965 6c64 2069 6e2e 0a20 2020 2020   field in..     
│ │ │ │ +0001b950: 543a 206e 6577 6c79 2061 6c6c 6f63 6174  T: newly allocat
│ │ │ │ +0001b960: 6564 207a 6572 6f2d 7465 726d 696e 6174  ed zero-terminat
│ │ │ │ +0001b970: 6564 206f 7574 7075 7420 6172 7261 7920  ed output array 
│ │ │ │ +0001b980: 7769 7468 2063 6c69 656e 7420 7469 6d65  with client time
│ │ │ │ +0001b990: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ +0001b9a0: 7469 6f6e 3a2a 2045 7874 7261 6374 2063  tion:* Extract c
│ │ │ │ +0001b9b0: 6c69 656e 7420 7469 6d65 2066 726f 6d20  lient time from 
│ │ │ │ +0001b9c0: 4b52 422d 4552 524f 522e 0a0a 2020 2020  KRB-ERROR...    
│ │ │ │ +0001b9d0: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ +0001b9e0: 2052 6574 7572 6e73 2053 4849 5348 495f   Returns SHISHI_
│ │ │ │ +0001b9f0: 4f4b 2069 6666 2073 7563 6365 7373 6675  OK iff successfu
│ │ │ │ +0001ba00: 6c2e 0a0a 7368 6973 6869 5f6b 7262 6572  l...shishi_krber
│ │ │ │ +0001ba10: 726f 725f 6374 696d 655f 7365 740a 2d2d  ror_ctime_set.--
│ │ │ │  0001ba20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0001ba30: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ -0001ba40: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ -0001ba50: 5f6b 7262 6572 726f 725f 6374 696d 655f  _krberror_ctime_
│ │ │ │ -0001ba60: 7365 7420 2853 6869 7368 6920 2a20 4841  set (Shishi * HA
│ │ │ │ -0001ba70: 4e44 4c45 2c0a 2020 2020 2020 2020 2020  NDLE,.          
│ │ │ │ -0001ba80: 5368 6973 6869 5f61 736e 3120 4b52 4245  Shishi_asn1 KRBE
│ │ │ │ -0001ba90: 5252 4f52 2c20 636f 6e73 7420 6368 6172  RROR, const char
│ │ │ │ -0001baa0: 202a 2054 290a 2020 2020 2048 414e 444c   * T).     HANDL
│ │ │ │ -0001bab0: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ -0001bac0: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ -0001bad0: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ -0001bae0: 29e2 8099 2e0a 2020 2020 204b 5242 4552  ).....     KRBER
│ │ │ │ -0001baf0: 524f 523a 204b 7262 6572 726f 7220 6173  ROR: Krberror as
│ │ │ │ -0001bb00: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ -0001bb10: 9873 6869 7368 695f 6b72 6265 7272 6f72  .shishi_krberror
│ │ │ │ -0001bb20: 2829 e280 992e 0a20 2020 2020 543a 2073  ().....     T: s
│ │ │ │ -0001bb30: 7472 696e 6720 7769 7468 2067 656e 6572  tring with gener
│ │ │ │ -0001bb40: 616c 697a 6564 2074 696d 6520 7661 6c75  alized time valu
│ │ │ │ -0001bb50: 6520 746f 2073 746f 7265 2069 6e20 4b72  e to store in Kr
│ │ │ │ -0001bb60: 6265 7272 6f72 2e0a 0a20 2020 2020 2a44  berror...     *D
│ │ │ │ -0001bb70: 6573 6372 6970 7469 6f6e 3a2a 2053 746f  escription:* Sto
│ │ │ │ -0001bb80: 7265 2063 6c69 656e 7420 7469 6d65 2069  re client time i
│ │ │ │ -0001bb90: 6e20 4b72 6265 7272 6f72 2e0a 0a20 2020  n Krberror...   
│ │ │ │ -0001bba0: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ -0001bbb0: 2a20 5265 7475 726e 7320 5348 4953 4849  * Returns SHISHI
│ │ │ │ -0001bbc0: 5f4f 4b20 6966 6620 7375 6363 6573 7366  _OK iff successf
│ │ │ │ -0001bbd0: 756c 2e0a 0a73 6869 7368 695f 6b72 6265  ul...shishi_krbe
│ │ │ │ -0001bbe0: 7272 6f72 5f72 656d 6f76 655f 6374 696d  rror_remove_ctim
│ │ │ │ -0001bbf0: 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  e.--------------
│ │ │ │ -0001bc00: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -0001bc10: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ -0001bc20: 7420 7368 6973 6869 5f6b 7262 6572 726f  t shishi_krberro
│ │ │ │ -0001bc30: 725f 7265 6d6f 7665 5f63 7469 6d65 2028  r_remove_ctime (
│ │ │ │ -0001bc40: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ -0001bc50: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ -0001bc60: 695f 6173 6e31 204b 5242 4552 524f 5229  i_asn1 KRBERROR)
│ │ │ │ -0001bc70: 0a20 2020 2020 4841 4e44 4c45 3a20 7368  .     HANDLE: sh
│ │ │ │ -0001bc80: 6973 6869 2068 616e 646c 6520 6173 2061  ishi handle as a
│ │ │ │ -0001bc90: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ -0001bca0: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ -0001bcb0: 0a20 2020 2020 4b52 4245 5252 4f52 3a20  .     KRBERROR: 
│ │ │ │ -0001bcc0: 4b72 6265 7272 6f72 2061 7320 616c 6c6f  Krberror as allo
│ │ │ │ -0001bcd0: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ -0001bce0: 6869 5f6b 7262 6572 726f 7228 29e2 8099  hi_krberror()...
│ │ │ │ -0001bcf0: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ -0001bd00: 7469 6f6e 3a2a 2052 656d 6f76 6520 636c  tion:* Remove cl
│ │ │ │ -0001bd10: 6965 6e74 2074 696d 6520 6669 656c 6420  ient time field 
│ │ │ │ -0001bd20: 696e 204b 7262 6572 726f 722e 0a0a 2020  in Krberror...  
│ │ │ │ -0001bd30: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ -0001bd40: 3a2a 2052 6574 7572 6e73 2053 4849 5348  :* Returns SHISH
│ │ │ │ -0001bd50: 495f 4f4b 2069 6666 2073 7563 6365 7373  I_OK iff success
│ │ │ │ -0001bd60: 6675 6c2e 0a0a 7368 6973 6869 5f6b 7262  ful...shishi_krb
│ │ │ │ -0001bd70: 6572 726f 725f 6375 7365 630a 2d2d 2d2d  error_cusec.----
│ │ │ │ +0001ba30: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +0001ba40: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ +0001ba50: 695f 6b72 6265 7272 6f72 5f63 7469 6d65  i_krberror_ctime
│ │ │ │ +0001ba60: 5f73 6574 2028 5368 6973 6869 202a 2048  _set (Shishi * H
│ │ │ │ +0001ba70: 414e 444c 452c 0a20 2020 2020 2020 2020  ANDLE,.         
│ │ │ │ +0001ba80: 2053 6869 7368 695f 6173 6e31 204b 5242   Shishi_asn1 KRB
│ │ │ │ +0001ba90: 4552 524f 522c 2063 6f6e 7374 2063 6861  ERROR, const cha
│ │ │ │ +0001baa0: 7220 2a20 5429 0a20 2020 2020 4841 4e44  r * T).     HAND
│ │ │ │ +0001bab0: 4c45 3a20 7368 6973 6869 2068 616e 646c  LE: shishi handl
│ │ │ │ +0001bac0: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ +0001bad0: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ +0001bae0: 2829 e280 992e 0a20 2020 2020 4b52 4245  ().....     KRBE
│ │ │ │ +0001baf0: 5252 4f52 3a20 4b72 6265 7272 6f72 2061  RROR: Krberror a
│ │ │ │ +0001bb00: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ +0001bb10: 8098 7368 6973 6869 5f6b 7262 6572 726f  ..shishi_krberro
│ │ │ │ +0001bb20: 7228 29e2 8099 2e0a 2020 2020 2054 3a20  r().....     T: 
│ │ │ │ +0001bb30: 7374 7269 6e67 2077 6974 6820 6765 6e65  string with gene
│ │ │ │ +0001bb40: 7261 6c69 7a65 6420 7469 6d65 2076 616c  ralized time val
│ │ │ │ +0001bb50: 7565 2074 6f20 7374 6f72 6520 696e 204b  ue to store in K
│ │ │ │ +0001bb60: 7262 6572 726f 722e 0a0a 2020 2020 202a  rberror...     *
│ │ │ │ +0001bb70: 4465 7363 7269 7074 696f 6e3a 2a20 5374  Description:* St
│ │ │ │ +0001bb80: 6f72 6520 636c 6965 6e74 2074 696d 6520  ore client time 
│ │ │ │ +0001bb90: 696e 204b 7262 6572 726f 722e 0a0a 2020  in Krberror...  
│ │ │ │ +0001bba0: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ +0001bbb0: 3a2a 2052 6574 7572 6e73 2053 4849 5348  :* Returns SHISH
│ │ │ │ +0001bbc0: 495f 4f4b 2069 6666 2073 7563 6365 7373  I_OK iff success
│ │ │ │ +0001bbd0: 6675 6c2e 0a0a 7368 6973 6869 5f6b 7262  ful...shishi_krb
│ │ │ │ +0001bbe0: 6572 726f 725f 7265 6d6f 7665 5f63 7469  error_remove_cti
│ │ │ │ +0001bbf0: 6d65 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  me.-------------
│ │ │ │ +0001bc00: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +0001bc10: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ +0001bc20: 6e74 2073 6869 7368 695f 6b72 6265 7272  nt shishi_krberr
│ │ │ │ +0001bc30: 6f72 5f72 656d 6f76 655f 6374 696d 6520  or_remove_ctime 
│ │ │ │ +0001bc40: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ +0001bc50: 2c0a 2020 2020 2020 2020 2020 5368 6973  ,.          Shis
│ │ │ │ +0001bc60: 6869 5f61 736e 3120 4b52 4245 5252 4f52  hi_asn1 KRBERROR
│ │ │ │ +0001bc70: 290a 2020 2020 2048 414e 444c 453a 2073  ).     HANDLE: s
│ │ │ │ +0001bc80: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ +0001bc90: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ +0001bca0: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ +0001bcb0: 2e0a 2020 2020 204b 5242 4552 524f 523a  ..     KRBERROR:
│ │ │ │ +0001bcc0: 204b 7262 6572 726f 7220 6173 2061 6c6c   Krberror as all
│ │ │ │ +0001bcd0: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ +0001bce0: 7368 695f 6b72 6265 7272 6f72 2829 e280  shi_krberror()..
│ │ │ │ +0001bcf0: 992e 0a0a 2020 2020 202a 4465 7363 7269  ....     *Descri
│ │ │ │ +0001bd00: 7074 696f 6e3a 2a20 5265 6d6f 7665 2063  ption:* Remove c
│ │ │ │ +0001bd10: 6c69 656e 7420 7469 6d65 2066 6965 6c64  lient time field
│ │ │ │ +0001bd20: 2069 6e20 4b72 6265 7272 6f72 2e0a 0a20   in Krberror... 
│ │ │ │ +0001bd30: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ +0001bd40: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ +0001bd50: 4849 5f4f 4b20 6966 6620 7375 6363 6573  HI_OK iff succes
│ │ │ │ +0001bd60: 7366 756c 2e0a 0a73 6869 7368 695f 6b72  sful...shishi_kr
│ │ │ │ +0001bd70: 6265 7272 6f72 5f63 7573 6563 0a2d 2d2d  berror_cusec.---
│ │ │ │  0001bd80: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0001bd90: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ -0001bda0: 2069 6e74 2073 6869 7368 695f 6b72 6265   int shishi_krbe
│ │ │ │ -0001bdb0: 7272 6f72 5f63 7573 6563 2028 5368 6973  rror_cusec (Shis
│ │ │ │ -0001bdc0: 6869 202a 2048 414e 444c 452c 0a20 2020  hi * HANDLE,.   
│ │ │ │ -0001bdd0: 2020 2020 2020 2053 6869 7368 695f 6173         Shishi_as
│ │ │ │ -0001bde0: 6e31 204b 5242 4552 524f 522c 2075 696e  n1 KRBERROR, uin
│ │ │ │ -0001bdf0: 7433 325f 7420 2a20 4355 5345 4329 0a20  t32_t * CUSEC). 
│ │ │ │ -0001be00: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ -0001be10: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ -0001be20: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ -0001be30: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ -0001be40: 2020 2020 4b52 4245 5252 4f52 3a20 4b72      KRBERROR: Kr
│ │ │ │ -0001be50: 6265 7272 6f72 2061 7320 616c 6c6f 6361  berror as alloca
│ │ │ │ -0001be60: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ -0001be70: 5f6b 7262 6572 726f 7228 29e2 8099 2e0a  _krberror().....
│ │ │ │ -0001be80: 2020 2020 2043 5553 4543 3a20 6f75 7470       CUSEC: outp
│ │ │ │ -0001be90: 7574 2069 6e74 6567 6572 2077 6974 6820  ut integer with 
│ │ │ │ -0001bea0: 636c 6965 6e74 206d 6963 726f 7365 636f  client microseco
│ │ │ │ -0001beb0: 6e64 7320 6669 656c 642e 0a0a 2020 2020  nds field...    
│ │ │ │ -0001bec0: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ -0001bed0: 4578 7472 6163 7420 636c 6965 6e74 206d  Extract client m
│ │ │ │ -0001bee0: 6963 726f 7365 636f 6e64 7320 6669 656c  icroseconds fiel
│ │ │ │ -0001bef0: 6420 6672 6f6d 204b 7262 6572 726f 722e  d from Krberror.
│ │ │ │ -0001bf00: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ -0001bf10: 616c 7565 3a2a 2052 6574 7572 6e73 2053  alue:* Returns S
│ │ │ │ -0001bf20: 4849 5348 495f 4f4b 2069 6666 2073 7563  HISHI_OK iff suc
│ │ │ │ -0001bf30: 6365 7373 6675 6c2e 0a0a 7368 6973 6869  cessful...shishi
│ │ │ │ -0001bf40: 5f6b 7262 6572 726f 725f 6375 7365 635f  _krberror_cusec_
│ │ │ │ -0001bf50: 7365 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  set.------------
│ │ │ │ -0001bf60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -0001bf70: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ -0001bf80: 2073 6869 7368 695f 6b72 6265 7272 6f72   shishi_krberror
│ │ │ │ -0001bf90: 5f63 7573 6563 5f73 6574 2028 5368 6973  _cusec_set (Shis
│ │ │ │ -0001bfa0: 6869 202a 2048 414e 444c 452c 0a20 2020  hi * HANDLE,.   
│ │ │ │ -0001bfb0: 2020 2020 2020 2053 6869 7368 695f 6173         Shishi_as
│ │ │ │ -0001bfc0: 6e31 204b 5242 4552 524f 522c 2075 696e  n1 KRBERROR, uin
│ │ │ │ -0001bfd0: 7433 325f 7420 4355 5345 4329 0a20 2020  t32_t CUSEC).   
│ │ │ │ -0001bfe0: 2020 4841 4e44 4c45 3a20 7368 6973 6869    HANDLE: shishi
│ │ │ │ -0001bff0: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ -0001c000: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ -0001c010: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ -0001c020: 2020 4b52 4245 5252 4f52 3a20 6b72 6265    KRBERROR: krbe
│ │ │ │ -0001c030: 7272 6f72 2061 7320 616c 6c6f 6361 7465  rror as allocate
│ │ │ │ -0001c040: 6420 6279 20e2 8098 7368 6973 6869 5f6b  d by ...shishi_k
│ │ │ │ -0001c050: 7262 6572 726f 7228 29e2 8099 2e0a 2020  rberror().....  
│ │ │ │ -0001c060: 2020 2043 5553 4543 3a20 636c 6965 6e74     CUSEC: client
│ │ │ │ -0001c070: 206d 6963 726f 7365 636f 6e64 7320 746f   microseconds to
│ │ │ │ -0001c080: 2073 6574 2069 6e20 6b72 6265 7272 6f72   set in krberror
│ │ │ │ -0001c090: 2c20 302d 3939 3939 3939 2e0a 0a20 2020  , 0-999999...   
│ │ │ │ -0001c0a0: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ -0001c0b0: 2053 6574 2074 6865 2063 7573 6563 2066   Set the cusec f
│ │ │ │ -0001c0c0: 6965 6c64 2069 6e20 7468 6520 4b72 6265  ield in the Krbe
│ │ │ │ -0001c0d0: 7272 6f72 2e0a 0a20 2020 2020 2a52 6574  rror...     *Ret
│ │ │ │ -0001c0e0: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ -0001c0f0: 726e 7320 5348 4953 4849 5f4f 4b20 6966  rns SHISHI_OK if
│ │ │ │ -0001c100: 6620 7375 6363 6573 7366 756c 2e0a 0a73  f successful...s
│ │ │ │ -0001c110: 6869 7368 695f 6b72 6265 7272 6f72 5f72  hishi_krberror_r
│ │ │ │ -0001c120: 656d 6f76 655f 6375 7365 630a 2d2d 2d2d  emove_cusec.----
│ │ │ │ +0001bd90: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ +0001bda0: 3a20 696e 7420 7368 6973 6869 5f6b 7262  : int shishi_krb
│ │ │ │ +0001bdb0: 6572 726f 725f 6375 7365 6320 2853 6869  error_cusec (Shi
│ │ │ │ +0001bdc0: 7368 6920 2a20 4841 4e44 4c45 2c0a 2020  shi * HANDLE,.  
│ │ │ │ +0001bdd0: 2020 2020 2020 2020 5368 6973 6869 5f61          Shishi_a
│ │ │ │ +0001bde0: 736e 3120 4b52 4245 5252 4f52 2c20 7569  sn1 KRBERROR, ui
│ │ │ │ +0001bdf0: 6e74 3332 5f74 202a 2043 5553 4543 290a  nt32_t * CUSEC).
│ │ │ │ +0001be00: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ +0001be10: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ +0001be20: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ +0001be30: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ +0001be40: 2020 2020 204b 5242 4552 524f 523a 204b       KRBERROR: K
│ │ │ │ +0001be50: 7262 6572 726f 7220 6173 2061 6c6c 6f63  rberror as alloc
│ │ │ │ +0001be60: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ +0001be70: 695f 6b72 6265 7272 6f72 2829 e280 992e  i_krberror()....
│ │ │ │ +0001be80: 0a20 2020 2020 4355 5345 433a 206f 7574  .     CUSEC: out
│ │ │ │ +0001be90: 7075 7420 696e 7465 6765 7220 7769 7468  put integer with
│ │ │ │ +0001bea0: 2063 6c69 656e 7420 6d69 6372 6f73 6563   client microsec
│ │ │ │ +0001beb0: 6f6e 6473 2066 6965 6c64 2e0a 0a20 2020  onds field...   
│ │ │ │ +0001bec0: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ +0001bed0: 2045 7874 7261 6374 2063 6c69 656e 7420   Extract client 
│ │ │ │ +0001bee0: 6d69 6372 6f73 6563 6f6e 6473 2066 6965  microseconds fie
│ │ │ │ +0001bef0: 6c64 2066 726f 6d20 4b72 6265 7272 6f72  ld from Krberror
│ │ │ │ +0001bf00: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ +0001bf10: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ +0001bf20: 5348 4953 4849 5f4f 4b20 6966 6620 7375  SHISHI_OK iff su
│ │ │ │ +0001bf30: 6363 6573 7366 756c 2e0a 0a73 6869 7368  ccessful...shish
│ │ │ │ +0001bf40: 695f 6b72 6265 7272 6f72 5f63 7573 6563  i_krberror_cusec
│ │ │ │ +0001bf50: 5f73 6574 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  _set.-----------
│ │ │ │ +0001bf60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ +0001bf70: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ +0001bf80: 7420 7368 6973 6869 5f6b 7262 6572 726f  t shishi_krberro
│ │ │ │ +0001bf90: 725f 6375 7365 635f 7365 7420 2853 6869  r_cusec_set (Shi
│ │ │ │ +0001bfa0: 7368 6920 2a20 4841 4e44 4c45 2c0a 2020  shi * HANDLE,.  
│ │ │ │ +0001bfb0: 2020 2020 2020 2020 5368 6973 6869 5f61          Shishi_a
│ │ │ │ +0001bfc0: 736e 3120 4b52 4245 5252 4f52 2c20 7569  sn1 KRBERROR, ui
│ │ │ │ +0001bfd0: 6e74 3332 5f74 2043 5553 4543 290a 2020  nt32_t CUSEC).  
│ │ │ │ +0001bfe0: 2020 2048 414e 444c 453a 2073 6869 7368     HANDLE: shish
│ │ │ │ +0001bff0: 6920 6861 6e64 6c65 2061 7320 616c 6c6f  i handle as allo
│ │ │ │ +0001c000: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ +0001c010: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ +0001c020: 2020 204b 5242 4552 524f 523a 206b 7262     KRBERROR: krb
│ │ │ │ +0001c030: 6572 726f 7220 6173 2061 6c6c 6f63 6174  error as allocat
│ │ │ │ +0001c040: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ +0001c050: 6b72 6265 7272 6f72 2829 e280 992e 0a20  krberror()..... 
│ │ │ │ +0001c060: 2020 2020 4355 5345 433a 2063 6c69 656e      CUSEC: clien
│ │ │ │ +0001c070: 7420 6d69 6372 6f73 6563 6f6e 6473 2074  t microseconds t
│ │ │ │ +0001c080: 6f20 7365 7420 696e 206b 7262 6572 726f  o set in krberro
│ │ │ │ +0001c090: 722c 2030 2d39 3939 3939 392e 0a0a 2020  r, 0-999999...  
│ │ │ │ +0001c0a0: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ +0001c0b0: 2a20 5365 7420 7468 6520 6375 7365 6320  * Set the cusec 
│ │ │ │ +0001c0c0: 6669 656c 6420 696e 2074 6865 204b 7262  field in the Krb
│ │ │ │ +0001c0d0: 6572 726f 722e 0a0a 2020 2020 202a 5265  error...     *Re
│ │ │ │ +0001c0e0: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ +0001c0f0: 7572 6e73 2053 4849 5348 495f 4f4b 2069  urns SHISHI_OK i
│ │ │ │ +0001c100: 6666 2073 7563 6365 7373 6675 6c2e 0a0a  ff successful...
│ │ │ │ +0001c110: 7368 6973 6869 5f6b 7262 6572 726f 725f  shishi_krberror_
│ │ │ │ +0001c120: 7265 6d6f 7665 5f63 7573 6563 0a2d 2d2d  remove_cusec.---
│ │ │ │  0001c130: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0001c140: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -0001c150: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ -0001c160: 6869 5f6b 7262 6572 726f 725f 7265 6d6f  hi_krberror_remo
│ │ │ │ -0001c170: 7665 5f63 7573 6563 2028 5368 6973 6869  ve_cusec (Shishi
│ │ │ │ -0001c180: 202a 2048 414e 444c 452c 0a20 2020 2020   * HANDLE,.     
│ │ │ │ -0001c190: 2020 2020 2053 6869 7368 695f 6173 6e31       Shishi_asn1
│ │ │ │ -0001c1a0: 204b 5242 4552 524f 5229 0a20 2020 2020   KRBERROR).     
│ │ │ │ -0001c1b0: 4841 4e44 4c45 3a20 7368 6973 6869 2068  HANDLE: shishi h
│ │ │ │ -0001c1c0: 616e 646c 6520 6173 2061 6c6c 6f63 6174  andle as allocat
│ │ │ │ -0001c1d0: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ -0001c1e0: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ -0001c1f0: 4b52 4245 5252 4f52 3a20 4b72 6265 7272  KRBERROR: Krberr
│ │ │ │ -0001c200: 6f72 2061 7320 616c 6c6f 6361 7465 6420  or as allocated 
│ │ │ │ -0001c210: 6279 20e2 8098 7368 6973 6869 5f6b 7262  by ...shishi_krb
│ │ │ │ -0001c220: 6572 726f 7228 29e2 8099 2e0a 0a20 2020  error()......   
│ │ │ │ -0001c230: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ -0001c240: 2052 656d 6f76 6520 636c 6965 6e74 2075   Remove client u
│ │ │ │ -0001c250: 7365 6320 6669 656c 6420 696e 204b 7262  sec field in Krb
│ │ │ │ -0001c260: 6572 726f 722e 0a0a 2020 2020 202a 5265  error...     *Re
│ │ │ │ -0001c270: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ -0001c280: 7572 6e73 2053 4849 5348 495f 4f4b 2069  urns SHISHI_OK i
│ │ │ │ -0001c290: 6666 2073 7563 6365 7373 6675 6c2e 0a0a  ff successful...
│ │ │ │ -0001c2a0: 7368 6973 6869 5f6b 7262 6572 726f 725f  shishi_krberror_
│ │ │ │ -0001c2b0: 7374 696d 650a 2d2d 2d2d 2d2d 2d2d 2d2d  stime.----------
│ │ │ │ -0001c2c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ -0001c2d0: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ -0001c2e0: 6869 7368 695f 6b72 6265 7272 6f72 5f73  hishi_krberror_s
│ │ │ │ -0001c2f0: 7469 6d65 2028 5368 6973 6869 202a 2048  time (Shishi * H
│ │ │ │ -0001c300: 414e 444c 452c 0a20 2020 2020 2020 2020  ANDLE,.         
│ │ │ │ -0001c310: 2053 6869 7368 695f 6173 6e31 204b 5242   Shishi_asn1 KRB
│ │ │ │ -0001c320: 4552 524f 522c 2063 6861 7220 2a2a 2054  ERROR, char ** T
│ │ │ │ -0001c330: 290a 2020 2020 2048 414e 444c 453a 2073  ).     HANDLE: s
│ │ │ │ -0001c340: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ -0001c350: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ -0001c360: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ -0001c370: 2e0a 2020 2020 204b 5242 4552 524f 523a  ..     KRBERROR:
│ │ │ │ -0001c380: 204b 7262 6572 726f 7220 746f 2073 6574   Krberror to set
│ │ │ │ -0001c390: 2063 6c69 656e 7420 6e61 6d65 2066 6965   client name fie
│ │ │ │ -0001c3a0: 6c64 2069 6e2e 0a20 2020 2020 543a 206e  ld in..     T: n
│ │ │ │ -0001c3b0: 6577 6c79 2061 6c6c 6f63 6174 6564 207a  ewly allocated z
│ │ │ │ -0001c3c0: 6572 6f2d 7465 726d 696e 6174 6564 206f  ero-terminated o
│ │ │ │ -0001c3d0: 7574 7075 7420 6172 7261 7920 7769 7468  utput array with
│ │ │ │ -0001c3e0: 2073 6572 7665 7220 7469 6d65 2e0a 0a20   server time... 
│ │ │ │ -0001c3f0: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -0001c400: 3a2a 2045 7874 7261 6374 2073 6572 7665  :* Extract serve
│ │ │ │ -0001c410: 7220 7469 6d65 2066 726f 6d20 4b52 422d  r time from KRB-
│ │ │ │ -0001c420: 4552 524f 522e 0a0a 2020 2020 202a 5265  ERROR...     *Re
│ │ │ │ -0001c430: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ -0001c440: 7572 6e73 2053 4849 5348 495f 4f4b 2069  urns SHISHI_OK i
│ │ │ │ -0001c450: 6666 2073 7563 6365 7373 6675 6c2e 0a0a  ff successful...
│ │ │ │ -0001c460: 7368 6973 6869 5f6b 7262 6572 726f 725f  shishi_krberror_
│ │ │ │ -0001c470: 7374 696d 655f 7365 740a 2d2d 2d2d 2d2d  stime_set.------
│ │ │ │ +0001c140: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +0001c150: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ +0001c160: 7368 695f 6b72 6265 7272 6f72 5f72 656d  shi_krberror_rem
│ │ │ │ +0001c170: 6f76 655f 6375 7365 6320 2853 6869 7368  ove_cusec (Shish
│ │ │ │ +0001c180: 6920 2a20 4841 4e44 4c45 2c0a 2020 2020  i * HANDLE,.    
│ │ │ │ +0001c190: 2020 2020 2020 5368 6973 6869 5f61 736e        Shishi_asn
│ │ │ │ +0001c1a0: 3120 4b52 4245 5252 4f52 290a 2020 2020  1 KRBERROR).    
│ │ │ │ +0001c1b0: 2048 414e 444c 453a 2073 6869 7368 6920   HANDLE: shishi 
│ │ │ │ +0001c1c0: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ +0001c1d0: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ +0001c1e0: 5f69 6e69 7428 29e2 8099 2e0a 2020 2020  _init().....    
│ │ │ │ +0001c1f0: 204b 5242 4552 524f 523a 204b 7262 6572   KRBERROR: Krber
│ │ │ │ +0001c200: 726f 7220 6173 2061 6c6c 6f63 6174 6564  ror as allocated
│ │ │ │ +0001c210: 2062 7920 e280 9873 6869 7368 695f 6b72   by ...shishi_kr
│ │ │ │ +0001c220: 6265 7272 6f72 2829 e280 992e 0a0a 2020  berror()......  
│ │ │ │ +0001c230: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ +0001c240: 2a20 5265 6d6f 7665 2063 6c69 656e 7420  * Remove client 
│ │ │ │ +0001c250: 7573 6563 2066 6965 6c64 2069 6e20 4b72  usec field in Kr
│ │ │ │ +0001c260: 6265 7272 6f72 2e0a 0a20 2020 2020 2a52  berror...     *R
│ │ │ │ +0001c270: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +0001c280: 7475 726e 7320 5348 4953 4849 5f4f 4b20  turns SHISHI_OK 
│ │ │ │ +0001c290: 6966 6620 7375 6363 6573 7366 756c 2e0a  iff successful..
│ │ │ │ +0001c2a0: 0a73 6869 7368 695f 6b72 6265 7272 6f72  .shishi_krberror
│ │ │ │ +0001c2b0: 5f73 7469 6d65 0a2d 2d2d 2d2d 2d2d 2d2d  _stime.---------
│ │ │ │ +0001c2c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ +0001c2d0: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ +0001c2e0: 7368 6973 6869 5f6b 7262 6572 726f 725f  shishi_krberror_
│ │ │ │ +0001c2f0: 7374 696d 6520 2853 6869 7368 6920 2a20  stime (Shishi * 
│ │ │ │ +0001c300: 4841 4e44 4c45 2c0a 2020 2020 2020 2020  HANDLE,.        
│ │ │ │ +0001c310: 2020 5368 6973 6869 5f61 736e 3120 4b52    Shishi_asn1 KR
│ │ │ │ +0001c320: 4245 5252 4f52 2c20 6368 6172 202a 2a20  BERROR, char ** 
│ │ │ │ +0001c330: 5429 0a20 2020 2020 4841 4e44 4c45 3a20  T).     HANDLE: 
│ │ │ │ +0001c340: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ +0001c350: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ +0001c360: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ +0001c370: 992e 0a20 2020 2020 4b52 4245 5252 4f52  ...     KRBERROR
│ │ │ │ +0001c380: 3a20 4b72 6265 7272 6f72 2074 6f20 7365  : Krberror to se
│ │ │ │ +0001c390: 7420 636c 6965 6e74 206e 616d 6520 6669  t client name fi
│ │ │ │ +0001c3a0: 656c 6420 696e 2e0a 2020 2020 2054 3a20  eld in..     T: 
│ │ │ │ +0001c3b0: 6e65 776c 7920 616c 6c6f 6361 7465 6420  newly allocated 
│ │ │ │ +0001c3c0: 7a65 726f 2d74 6572 6d69 6e61 7465 6420  zero-terminated 
│ │ │ │ +0001c3d0: 6f75 7470 7574 2061 7272 6179 2077 6974  output array wit
│ │ │ │ +0001c3e0: 6820 7365 7276 6572 2074 696d 652e 0a0a  h server time...
│ │ │ │ +0001c3f0: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ +0001c400: 6e3a 2a20 4578 7472 6163 7420 7365 7276  n:* Extract serv
│ │ │ │ +0001c410: 6572 2074 696d 6520 6672 6f6d 204b 5242  er time from KRB
│ │ │ │ +0001c420: 2d45 5252 4f52 2e0a 0a20 2020 2020 2a52  -ERROR...     *R
│ │ │ │ +0001c430: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +0001c440: 7475 726e 7320 5348 4953 4849 5f4f 4b20  turns SHISHI_OK 
│ │ │ │ +0001c450: 6966 6620 7375 6363 6573 7366 756c 2e0a  iff successful..
│ │ │ │ +0001c460: 0a73 6869 7368 695f 6b72 6265 7272 6f72  .shishi_krberror
│ │ │ │ +0001c470: 5f73 7469 6d65 5f73 6574 0a2d 2d2d 2d2d  _stime_set.-----
│ │ │ │  0001c480: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0001c490: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ -0001c4a0: 6e3a 2069 6e74 2073 6869 7368 695f 6b72  n: int shishi_kr
│ │ │ │ -0001c4b0: 6265 7272 6f72 5f73 7469 6d65 5f73 6574  berror_stime_set
│ │ │ │ -0001c4c0: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ -0001c4d0: 452c 0a20 2020 2020 2020 2020 2053 6869  E,.          Shi
│ │ │ │ -0001c4e0: 7368 695f 6173 6e31 204b 5242 4552 524f  shi_asn1 KRBERRO
│ │ │ │ -0001c4f0: 522c 2063 6f6e 7374 2063 6861 7220 2a20  R, const char * 
│ │ │ │ -0001c500: 5429 0a20 2020 2020 4841 4e44 4c45 3a20  T).     HANDLE: 
│ │ │ │ -0001c510: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ -0001c520: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ -0001c530: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ -0001c540: 992e 0a20 2020 2020 4b52 4245 5252 4f52  ...     KRBERROR
│ │ │ │ -0001c550: 3a20 4b72 6265 7272 6f72 2061 7320 616c  : Krberror as al
│ │ │ │ -0001c560: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ -0001c570: 6973 6869 5f6b 7262 6572 726f 7228 29e2  ishi_krberror().
│ │ │ │ -0001c580: 8099 2e0a 2020 2020 2054 3a20 7374 7269  ....     T: stri
│ │ │ │ -0001c590: 6e67 2077 6974 6820 6765 6e65 7261 6c69  ng with generali
│ │ │ │ -0001c5a0: 7a65 6420 7469 6d65 2076 616c 7565 2074  zed time value t
│ │ │ │ -0001c5b0: 6f20 7374 6f72 6520 696e 204b 7262 6572  o store in Krber
│ │ │ │ -0001c5c0: 726f 722e 0a0a 2020 2020 202a 4465 7363  ror...     *Desc
│ │ │ │ -0001c5d0: 7269 7074 696f 6e3a 2a20 5374 6f72 6520  ription:* Store 
│ │ │ │ -0001c5e0: 7365 7276 6572 2074 696d 6520 696e 204b  server time in K
│ │ │ │ -0001c5f0: 7262 6572 726f 722e 0a0a 2020 2020 202a  rberror...     *
│ │ │ │ -0001c600: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ -0001c610: 6574 7572 6e73 2053 4849 5348 495f 4f4b  eturns SHISHI_OK
│ │ │ │ -0001c620: 2069 6666 2073 7563 6365 7373 6675 6c2e   iff successful.
│ │ │ │ -0001c630: 0a0a 7368 6973 6869 5f6b 7262 6572 726f  ..shishi_krberro
│ │ │ │ -0001c640: 725f 7375 7365 630a 2d2d 2d2d 2d2d 2d2d  r_susec.--------
│ │ │ │ -0001c650: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -0001c660: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ -0001c670: 2073 6869 7368 695f 6b72 6265 7272 6f72   shishi_krberror
│ │ │ │ -0001c680: 5f73 7573 6563 2028 5368 6973 6869 202a  _susec (Shishi *
│ │ │ │ -0001c690: 2048 414e 444c 452c 0a20 2020 2020 2020   HANDLE,.       
│ │ │ │ -0001c6a0: 2020 2053 6869 7368 695f 6173 6e31 204b     Shishi_asn1 K
│ │ │ │ -0001c6b0: 5242 4552 524f 522c 2075 696e 7433 325f  RBERROR, uint32_
│ │ │ │ -0001c6c0: 7420 2a20 5355 5345 4329 0a20 2020 2020  t * SUSEC).     
│ │ │ │ -0001c6d0: 4841 4e44 4c45 3a20 7368 6973 6869 2068  HANDLE: shishi h
│ │ │ │ -0001c6e0: 616e 646c 6520 6173 2061 6c6c 6f63 6174  andle as allocat
│ │ │ │ -0001c6f0: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ -0001c700: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ -0001c710: 4b52 4245 5252 4f52 3a20 4b72 6265 7272  KRBERROR: Krberr
│ │ │ │ -0001c720: 6f72 2061 7320 616c 6c6f 6361 7465 6420  or as allocated 
│ │ │ │ -0001c730: 6279 20e2 8098 7368 6973 6869 5f6b 7262  by ...shishi_krb
│ │ │ │ -0001c740: 6572 726f 7228 29e2 8099 2e0a 2020 2020  error().....    
│ │ │ │ -0001c750: 2053 5553 4543 3a20 6f75 7470 7574 2069   SUSEC: output i
│ │ │ │ -0001c760: 6e74 6567 6572 2077 6974 6820 7365 7276  nteger with serv
│ │ │ │ -0001c770: 6572 206d 6963 726f 7365 636f 6e64 7320  er microseconds 
│ │ │ │ -0001c780: 6669 656c 642e 0a0a 2020 2020 202a 4465  field...     *De
│ │ │ │ -0001c790: 7363 7269 7074 696f 6e3a 2a20 4578 7472  scription:* Extr
│ │ │ │ -0001c7a0: 6163 7420 7365 7276 6572 206d 6963 726f  act server micro
│ │ │ │ -0001c7b0: 7365 636f 6e64 7320 6669 656c 6420 6672  seconds field fr
│ │ │ │ -0001c7c0: 6f6d 204b 7262 6572 726f 722e 0a0a 2020  om Krberror...  
│ │ │ │ -0001c7d0: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ -0001c7e0: 3a2a 2052 6574 7572 6e73 2053 4849 5348  :* Returns SHISH
│ │ │ │ -0001c7f0: 495f 4f4b 2069 6666 2073 7563 6365 7373  I_OK iff success
│ │ │ │ -0001c800: 6675 6c2e 0a0a 7368 6973 6869 5f6b 7262  ful...shishi_krb
│ │ │ │ -0001c810: 6572 726f 725f 7375 7365 635f 7365 740a  error_susec_set.
│ │ │ │ -0001c820: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0001c830: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ -0001c840: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ -0001c850: 7368 695f 6b72 6265 7272 6f72 5f73 7573  shi_krberror_sus
│ │ │ │ -0001c860: 6563 5f73 6574 2028 5368 6973 6869 202a  ec_set (Shishi *
│ │ │ │ -0001c870: 2048 414e 444c 452c 0a20 2020 2020 2020   HANDLE,.       
│ │ │ │ -0001c880: 2020 2053 6869 7368 695f 6173 6e31 204b     Shishi_asn1 K
│ │ │ │ -0001c890: 5242 4552 524f 522c 2075 696e 7433 325f  RBERROR, uint32_
│ │ │ │ -0001c8a0: 7420 5355 5345 4329 0a20 2020 2020 4841  t SUSEC).     HA
│ │ │ │ -0001c8b0: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ -0001c8c0: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ -0001c8d0: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ -0001c8e0: 6974 2829 e280 992e 0a20 2020 2020 4b52  it().....     KR
│ │ │ │ -0001c8f0: 4245 5252 4f52 3a20 6b72 6265 7272 6f72  BERROR: krberror
│ │ │ │ -0001c900: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ -0001c910: 20e2 8098 7368 6973 6869 5f6b 7262 6572   ...shishi_krber
│ │ │ │ -0001c920: 726f 7228 29e2 8099 2e0a 2020 2020 2053  ror().....     S
│ │ │ │ -0001c930: 5553 4543 3a20 7365 7276 6572 206d 6963  USEC: server mic
│ │ │ │ -0001c940: 726f 7365 636f 6e64 7320 746f 2073 6574  roseconds to set
│ │ │ │ -0001c950: 2069 6e20 6b72 6265 7272 6f72 2c20 302d   in krberror, 0-
│ │ │ │ -0001c960: 3939 3939 3939 2e0a 0a20 2020 2020 2a44  999999...     *D
│ │ │ │ -0001c970: 6573 6372 6970 7469 6f6e 3a2a 2053 6574  escription:* Set
│ │ │ │ -0001c980: 2074 6865 2073 7573 6563 2066 6965 6c64   the susec field
│ │ │ │ -0001c990: 2069 6e20 7468 6520 4b72 6265 7272 6f72   in the Krberror
│ │ │ │ -0001c9a0: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ -0001c9b0: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ -0001c9c0: 5348 4953 4849 5f4f 4b20 6966 6620 7375  SHISHI_OK iff su
│ │ │ │ -0001c9d0: 6363 6573 7366 756c 2e0a 0a73 6869 7368  ccessful...shish
│ │ │ │ -0001c9e0: 695f 6b72 6265 7272 6f72 5f65 7272 6f72  i_krberror_error
│ │ │ │ -0001c9f0: 636f 6465 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  code.-----------
│ │ │ │ -0001ca00: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -0001ca10: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ -0001ca20: 7420 7368 6973 6869 5f6b 7262 6572 726f  t shishi_krberro
│ │ │ │ -0001ca30: 725f 6572 726f 7263 6f64 6520 2853 6869  r_errorcode (Shi
│ │ │ │ -0001ca40: 7368 6920 2a20 4841 4e44 4c45 2c0a 2020  shi * HANDLE,.  
│ │ │ │ -0001ca50: 2020 2020 2020 2020 5368 6973 6869 5f61          Shishi_a
│ │ │ │ -0001ca60: 736e 3120 4b52 4245 5252 4f52 2c20 696e  sn1 KRBERROR, in
│ │ │ │ -0001ca70: 7433 325f 7420 2a20 4552 524f 5243 4f44  t32_t * ERRORCOD
│ │ │ │ -0001ca80: 4529 0a20 2020 2020 4841 4e44 4c45 3a20  E).     HANDLE: 
│ │ │ │ -0001ca90: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ -0001caa0: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ -0001cab0: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ -0001cac0: 992e 0a20 2020 2020 4b52 4245 5252 4f52  ...     KRBERROR
│ │ │ │ -0001cad0: 3a20 4b52 422d 4552 524f 5220 7374 7275  : KRB-ERROR stru
│ │ │ │ -0001cae0: 6374 7572 6520 7769 7468 2065 7272 6f72  cture with error
│ │ │ │ -0001caf0: 2063 6f64 652e 0a20 2020 2020 4552 524f   code..     ERRO
│ │ │ │ -0001cb00: 5243 4f44 453a 206f 7574 7075 7420 696e  RCODE: output in
│ │ │ │ -0001cb10: 7465 6765 7220 4b52 422d 4552 524f 5220  teger KRB-ERROR 
│ │ │ │ -0001cb20: 6572 726f 7220 636f 6465 2e0a 0a20 2020  error code...   
│ │ │ │ -0001cb30: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ -0001cb40: 2045 7874 7261 6374 2065 7272 6f72 2063   Extract error c
│ │ │ │ -0001cb50: 6f64 6520 6672 6f6d 204b 5242 2d45 5252  ode from KRB-ERR
│ │ │ │ -0001cb60: 4f52 2e0a 0a20 2020 2020 2a52 6574 7572  OR...     *Retur
│ │ │ │ -0001cb70: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ -0001cb80: 7320 5348 4953 4849 5f4f 4b20 6966 6620  s SHISHI_OK iff 
│ │ │ │ -0001cb90: 7375 6363 6573 7366 756c 2e0a 0a73 6869  successful...shi
│ │ │ │ -0001cba0: 7368 695f 6b72 6265 7272 6f72 5f65 7272  shi_krberror_err
│ │ │ │ -0001cbb0: 6f72 636f 6465 5f66 6173 740a 2d2d 2d2d  orcode_fast.----
│ │ │ │ +0001c490: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ +0001c4a0: 6f6e 3a20 696e 7420 7368 6973 6869 5f6b  on: int shishi_k
│ │ │ │ +0001c4b0: 7262 6572 726f 725f 7374 696d 655f 7365  rberror_stime_se
│ │ │ │ +0001c4c0: 7420 2853 6869 7368 6920 2a20 4841 4e44  t (Shishi * HAND
│ │ │ │ +0001c4d0: 4c45 2c0a 2020 2020 2020 2020 2020 5368  LE,.          Sh
│ │ │ │ +0001c4e0: 6973 6869 5f61 736e 3120 4b52 4245 5252  ishi_asn1 KRBERR
│ │ │ │ +0001c4f0: 4f52 2c20 636f 6e73 7420 6368 6172 202a  OR, const char *
│ │ │ │ +0001c500: 2054 290a 2020 2020 2048 414e 444c 453a   T).     HANDLE:
│ │ │ │ +0001c510: 2073 6869 7368 6920 6861 6e64 6c65 2061   shishi handle a
│ │ │ │ +0001c520: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ +0001c530: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ +0001c540: 8099 2e0a 2020 2020 204b 5242 4552 524f  ....     KRBERRO
│ │ │ │ +0001c550: 523a 204b 7262 6572 726f 7220 6173 2061  R: Krberror as a
│ │ │ │ +0001c560: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ +0001c570: 6869 7368 695f 6b72 6265 7272 6f72 2829  hishi_krberror()
│ │ │ │ +0001c580: e280 992e 0a20 2020 2020 543a 2073 7472  .....     T: str
│ │ │ │ +0001c590: 696e 6720 7769 7468 2067 656e 6572 616c  ing with general
│ │ │ │ +0001c5a0: 697a 6564 2074 696d 6520 7661 6c75 6520  ized time value 
│ │ │ │ +0001c5b0: 746f 2073 746f 7265 2069 6e20 4b72 6265  to store in Krbe
│ │ │ │ +0001c5c0: 7272 6f72 2e0a 0a20 2020 2020 2a44 6573  rror...     *Des
│ │ │ │ +0001c5d0: 6372 6970 7469 6f6e 3a2a 2053 746f 7265  cription:* Store
│ │ │ │ +0001c5e0: 2073 6572 7665 7220 7469 6d65 2069 6e20   server time in 
│ │ │ │ +0001c5f0: 4b72 6265 7272 6f72 2e0a 0a20 2020 2020  Krberror...     
│ │ │ │ +0001c600: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ +0001c610: 5265 7475 726e 7320 5348 4953 4849 5f4f  Returns SHISHI_O
│ │ │ │ +0001c620: 4b20 6966 6620 7375 6363 6573 7366 756c  K iff successful
│ │ │ │ +0001c630: 2e0a 0a73 6869 7368 695f 6b72 6265 7272  ...shishi_krberr
│ │ │ │ +0001c640: 6f72 5f73 7573 6563 0a2d 2d2d 2d2d 2d2d  or_susec.-------
│ │ │ │ +0001c650: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ +0001c660: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ +0001c670: 7420 7368 6973 6869 5f6b 7262 6572 726f  t shishi_krberro
│ │ │ │ +0001c680: 725f 7375 7365 6320 2853 6869 7368 6920  r_susec (Shishi 
│ │ │ │ +0001c690: 2a20 4841 4e44 4c45 2c0a 2020 2020 2020  * HANDLE,.      
│ │ │ │ +0001c6a0: 2020 2020 5368 6973 6869 5f61 736e 3120      Shishi_asn1 
│ │ │ │ +0001c6b0: 4b52 4245 5252 4f52 2c20 7569 6e74 3332  KRBERROR, uint32
│ │ │ │ +0001c6c0: 5f74 202a 2053 5553 4543 290a 2020 2020  _t * SUSEC).    
│ │ │ │ +0001c6d0: 2048 414e 444c 453a 2073 6869 7368 6920   HANDLE: shishi 
│ │ │ │ +0001c6e0: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ +0001c6f0: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ +0001c700: 5f69 6e69 7428 29e2 8099 2e0a 2020 2020  _init().....    
│ │ │ │ +0001c710: 204b 5242 4552 524f 523a 204b 7262 6572   KRBERROR: Krber
│ │ │ │ +0001c720: 726f 7220 6173 2061 6c6c 6f63 6174 6564  ror as allocated
│ │ │ │ +0001c730: 2062 7920 e280 9873 6869 7368 695f 6b72   by ...shishi_kr
│ │ │ │ +0001c740: 6265 7272 6f72 2829 e280 992e 0a20 2020  berror().....   
│ │ │ │ +0001c750: 2020 5355 5345 433a 206f 7574 7075 7420    SUSEC: output 
│ │ │ │ +0001c760: 696e 7465 6765 7220 7769 7468 2073 6572  integer with ser
│ │ │ │ +0001c770: 7665 7220 6d69 6372 6f73 6563 6f6e 6473  ver microseconds
│ │ │ │ +0001c780: 2066 6965 6c64 2e0a 0a20 2020 2020 2a44   field...     *D
│ │ │ │ +0001c790: 6573 6372 6970 7469 6f6e 3a2a 2045 7874  escription:* Ext
│ │ │ │ +0001c7a0: 7261 6374 2073 6572 7665 7220 6d69 6372  ract server micr
│ │ │ │ +0001c7b0: 6f73 6563 6f6e 6473 2066 6965 6c64 2066  oseconds field f
│ │ │ │ +0001c7c0: 726f 6d20 4b72 6265 7272 6f72 2e0a 0a20  rom Krberror... 
│ │ │ │ +0001c7d0: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ +0001c7e0: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ +0001c7f0: 4849 5f4f 4b20 6966 6620 7375 6363 6573  HI_OK iff succes
│ │ │ │ +0001c800: 7366 756c 2e0a 0a73 6869 7368 695f 6b72  sful...shishi_kr
│ │ │ │ +0001c810: 6265 7272 6f72 5f73 7573 6563 5f73 6574  berror_susec_set
│ │ │ │ +0001c820: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ +0001c830: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +0001c840: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ +0001c850: 6973 6869 5f6b 7262 6572 726f 725f 7375  ishi_krberror_su
│ │ │ │ +0001c860: 7365 635f 7365 7420 2853 6869 7368 6920  sec_set (Shishi 
│ │ │ │ +0001c870: 2a20 4841 4e44 4c45 2c0a 2020 2020 2020  * HANDLE,.      
│ │ │ │ +0001c880: 2020 2020 5368 6973 6869 5f61 736e 3120      Shishi_asn1 
│ │ │ │ +0001c890: 4b52 4245 5252 4f52 2c20 7569 6e74 3332  KRBERROR, uint32
│ │ │ │ +0001c8a0: 5f74 2053 5553 4543 290a 2020 2020 2048  _t SUSEC).     H
│ │ │ │ +0001c8b0: 414e 444c 453a 2073 6869 7368 6920 6861  ANDLE: shishi ha
│ │ │ │ +0001c8c0: 6e64 6c65 2061 7320 616c 6c6f 6361 7465  ndle as allocate
│ │ │ │ +0001c8d0: 6420 6279 20e2 8098 7368 6973 6869 5f69  d by ...shishi_i
│ │ │ │ +0001c8e0: 6e69 7428 29e2 8099 2e0a 2020 2020 204b  nit().....     K
│ │ │ │ +0001c8f0: 5242 4552 524f 523a 206b 7262 6572 726f  RBERROR: krberro
│ │ │ │ +0001c900: 7220 6173 2061 6c6c 6f63 6174 6564 2062  r as allocated b
│ │ │ │ +0001c910: 7920 e280 9873 6869 7368 695f 6b72 6265  y ...shishi_krbe
│ │ │ │ +0001c920: 7272 6f72 2829 e280 992e 0a20 2020 2020  rror().....     
│ │ │ │ +0001c930: 5355 5345 433a 2073 6572 7665 7220 6d69  SUSEC: server mi
│ │ │ │ +0001c940: 6372 6f73 6563 6f6e 6473 2074 6f20 7365  croseconds to se
│ │ │ │ +0001c950: 7420 696e 206b 7262 6572 726f 722c 2030  t in krberror, 0
│ │ │ │ +0001c960: 2d39 3939 3939 392e 0a0a 2020 2020 202a  -999999...     *
│ │ │ │ +0001c970: 4465 7363 7269 7074 696f 6e3a 2a20 5365  Description:* Se
│ │ │ │ +0001c980: 7420 7468 6520 7375 7365 6320 6669 656c  t the susec fiel
│ │ │ │ +0001c990: 6420 696e 2074 6865 204b 7262 6572 726f  d in the Krberro
│ │ │ │ +0001c9a0: 722e 0a0a 2020 2020 202a 5265 7475 726e  r...     *Return
│ │ │ │ +0001c9b0: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ +0001c9c0: 2053 4849 5348 495f 4f4b 2069 6666 2073   SHISHI_OK iff s
│ │ │ │ +0001c9d0: 7563 6365 7373 6675 6c2e 0a0a 7368 6973  uccessful...shis
│ │ │ │ +0001c9e0: 6869 5f6b 7262 6572 726f 725f 6572 726f  hi_krberror_erro
│ │ │ │ +0001c9f0: 7263 6f64 650a 2d2d 2d2d 2d2d 2d2d 2d2d  rcode.----------
│ │ │ │ +0001ca00: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +0001ca10: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ +0001ca20: 6e74 2073 6869 7368 695f 6b72 6265 7272  nt shishi_krberr
│ │ │ │ +0001ca30: 6f72 5f65 7272 6f72 636f 6465 2028 5368  or_errorcode (Sh
│ │ │ │ +0001ca40: 6973 6869 202a 2048 414e 444c 452c 0a20  ishi * HANDLE,. 
│ │ │ │ +0001ca50: 2020 2020 2020 2020 2053 6869 7368 695f           Shishi_
│ │ │ │ +0001ca60: 6173 6e31 204b 5242 4552 524f 522c 2069  asn1 KRBERROR, i
│ │ │ │ +0001ca70: 6e74 3332 5f74 202a 2045 5252 4f52 434f  nt32_t * ERRORCO
│ │ │ │ +0001ca80: 4445 290a 2020 2020 2048 414e 444c 453a  DE).     HANDLE:
│ │ │ │ +0001ca90: 2073 6869 7368 6920 6861 6e64 6c65 2061   shishi handle a
│ │ │ │ +0001caa0: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ +0001cab0: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ +0001cac0: 8099 2e0a 2020 2020 204b 5242 4552 524f  ....     KRBERRO
│ │ │ │ +0001cad0: 523a 204b 5242 2d45 5252 4f52 2073 7472  R: KRB-ERROR str
│ │ │ │ +0001cae0: 7563 7475 7265 2077 6974 6820 6572 726f  ucture with erro
│ │ │ │ +0001caf0: 7220 636f 6465 2e0a 2020 2020 2045 5252  r code..     ERR
│ │ │ │ +0001cb00: 4f52 434f 4445 3a20 6f75 7470 7574 2069  ORCODE: output i
│ │ │ │ +0001cb10: 6e74 6567 6572 204b 5242 2d45 5252 4f52  nteger KRB-ERROR
│ │ │ │ +0001cb20: 2065 7272 6f72 2063 6f64 652e 0a0a 2020   error code...  
│ │ │ │ +0001cb30: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ +0001cb40: 2a20 4578 7472 6163 7420 6572 726f 7220  * Extract error 
│ │ │ │ +0001cb50: 636f 6465 2066 726f 6d20 4b52 422d 4552  code from KRB-ER
│ │ │ │ +0001cb60: 524f 522e 0a0a 2020 2020 202a 5265 7475  ROR...     *Retu
│ │ │ │ +0001cb70: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ +0001cb80: 6e73 2053 4849 5348 495f 4f4b 2069 6666  ns SHISHI_OK iff
│ │ │ │ +0001cb90: 2073 7563 6365 7373 6675 6c2e 0a0a 7368   successful...sh
│ │ │ │ +0001cba0: 6973 6869 5f6b 7262 6572 726f 725f 6572  ishi_krberror_er
│ │ │ │ +0001cbb0: 726f 7263 6f64 655f 6661 7374 0a2d 2d2d  rorcode_fast.---
│ │ │ │  0001cbc0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0001cbd0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ -0001cbe0: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ -0001cbf0: 6973 6869 5f6b 7262 6572 726f 725f 6572  ishi_krberror_er
│ │ │ │ -0001cc00: 726f 7263 6f64 655f 6661 7374 2028 5368  rorcode_fast (Sh
│ │ │ │ -0001cc10: 6973 6869 202a 2048 414e 444c 452c 0a20  ishi * HANDLE,. 
│ │ │ │ -0001cc20: 2020 2020 2020 2020 2053 6869 7368 695f           Shishi_
│ │ │ │ -0001cc30: 6173 6e31 204b 5242 4552 524f 5229 0a20  asn1 KRBERROR). 
│ │ │ │ -0001cc40: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ -0001cc50: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ -0001cc60: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ -0001cc70: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ -0001cc80: 2020 2020 4b52 4245 5252 4f52 3a20 4b52      KRBERROR: KR
│ │ │ │ -0001cc90: 422d 4552 524f 5220 7374 7275 6374 7572  B-ERROR structur
│ │ │ │ -0001cca0: 6520 7769 7468 2065 7272 6f72 2063 6f64  e with error cod
│ │ │ │ -0001ccb0: 652e 0a0a 2020 2020 202a 4465 7363 7269  e...     *Descri
│ │ │ │ -0001ccc0: 7074 696f 6e3a 2a20 4765 7420 6572 726f  ption:* Get erro
│ │ │ │ -0001ccd0: 7220 636f 6465 2066 726f 6d20 4b52 422d  r code from KRB-
│ │ │ │ -0001cce0: 4552 524f 522c 2077 6974 686f 7574 2065  ERROR, without e
│ │ │ │ -0001ccf0: 7272 6f72 0a20 2020 2020 6368 6563 6b69  rror.     checki
│ │ │ │ -0001cd00: 6e67 2e0a 0a20 2020 2020 2a52 6574 7572  ng...     *Retur
│ │ │ │ -0001cd10: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ -0001cd20: 2065 7272 6f72 2063 6f64 6520 2873 6565   error code (see
│ │ │ │ -0001cd30: 0a20 2020 2020 e280 9873 6869 7368 695f  .     ...shishi_
│ │ │ │ -0001cd40: 6b72 6265 7272 6f72 5f65 7272 6f72 636f  krberror_errorco
│ │ │ │ -0001cd50: 6465 2829 e280 9929 2064 6972 6563 746c  de()...) directl
│ │ │ │ -0001cd60: 792c 206f 7220 2d31 206f 6e20 6572 726f  y, or -1 on erro
│ │ │ │ -0001cd70: 722e 0a0a 7368 6973 6869 5f6b 7262 6572  r...shishi_krber
│ │ │ │ -0001cd80: 726f 725f 6572 726f 7263 6f64 655f 7365  ror_errorcode_se
│ │ │ │ -0001cd90: 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  t.--------------
│ │ │ │ -0001cda0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -0001cdb0: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ -0001cdc0: 6e74 2073 6869 7368 695f 6b72 6265 7272  nt shishi_krberr
│ │ │ │ -0001cdd0: 6f72 5f65 7272 6f72 636f 6465 5f73 6574  or_errorcode_set
│ │ │ │ -0001cde0: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ -0001cdf0: 452c 0a20 2020 2020 2020 2020 2053 6869  E,.          Shi
│ │ │ │ -0001ce00: 7368 695f 6173 6e31 204b 5242 4552 524f  shi_asn1 KRBERRO
│ │ │ │ -0001ce10: 522c 2069 6e74 2045 5252 4f52 434f 4445  R, int ERRORCODE
│ │ │ │ -0001ce20: 290a 2020 2020 2048 414e 444c 453a 2073  ).     HANDLE: s
│ │ │ │ -0001ce30: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ -0001ce40: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ -0001ce50: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ -0001ce60: 2e0a 2020 2020 204b 5242 4552 524f 523a  ..     KRBERROR:
│ │ │ │ -0001ce70: 204b 5242 2d45 5252 4f52 2073 7472 7563   KRB-ERROR struc
│ │ │ │ -0001ce80: 7475 7265 2077 6974 6820 6572 726f 7220  ture with error 
│ │ │ │ -0001ce90: 636f 6465 2074 6f20 7365 742e 0a20 2020  code to set..   
│ │ │ │ -0001cea0: 2020 4552 524f 5243 4f44 453a 206e 6577    ERRORCODE: new
│ │ │ │ -0001ceb0: 2065 7272 6f72 2063 6f64 6520 746f 2073   error code to s
│ │ │ │ -0001cec0: 6574 2069 6e20 6b72 6265 7272 6f72 2e0a  et in krberror..
│ │ │ │ -0001ced0: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -0001cee0: 6f6e 3a2a 2053 6574 2074 6865 2065 7272  on:* Set the err
│ │ │ │ -0001cef0: 6f72 2d63 6f64 6520 6669 656c 6420 746f  or-code field to
│ │ │ │ -0001cf00: 2061 206e 6577 2065 7272 6f72 2063 6f64   a new error cod
│ │ │ │ -0001cf10: 652e 0a0a 2020 2020 202a 5265 7475 726e  e...     *Return
│ │ │ │ -0001cf20: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ -0001cf30: 2053 4849 5348 495f 4f4b 2069 6666 2073   SHISHI_OK iff s
│ │ │ │ -0001cf40: 7563 6365 7373 6675 6c2e 0a0a 7368 6973  uccessful...shis
│ │ │ │ -0001cf50: 6869 5f6b 7262 6572 726f 725f 6574 6578  hi_krberror_etex
│ │ │ │ -0001cf60: 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  t.--------------
│ │ │ │ -0001cf70: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ -0001cf80: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ -0001cf90: 695f 6b72 6265 7272 6f72 5f65 7465 7874  i_krberror_etext
│ │ │ │ -0001cfa0: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ -0001cfb0: 452c 0a20 2020 2020 2020 2020 2053 6869  E,.          Shi
│ │ │ │ -0001cfc0: 7368 695f 6173 6e31 204b 5242 4552 524f  shi_asn1 KRBERRO
│ │ │ │ -0001cfd0: 522c 2063 6861 7220 2a2a 2045 5445 5854  R, char ** ETEXT
│ │ │ │ -0001cfe0: 2c20 7369 7a65 5f74 202a 2045 5445 5854  , size_t * ETEXT
│ │ │ │ -0001cff0: 4c45 4e29 0a20 2020 2020 4841 4e44 4c45  LEN).     HANDLE
│ │ │ │ -0001d000: 3a20 7368 6973 6869 2068 616e 646c 6520  : shishi handle 
│ │ │ │ -0001d010: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ -0001d020: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ -0001d030: e280 992e 0a20 2020 2020 4b52 4245 5252  .....     KRBERR
│ │ │ │ -0001d040: 4f52 3a20 4b52 422d 4552 524f 5220 7374  OR: KRB-ERROR st
│ │ │ │ -0001d050: 7275 6374 7572 6520 7769 7468 2065 7272  ructure with err
│ │ │ │ -0001d060: 6f72 2063 6f64 652e 0a20 2020 2020 4554  or code..     ET
│ │ │ │ -0001d070: 4558 543a 206f 7574 7075 7420 6172 7261  EXT: output arra
│ │ │ │ -0001d080: 7920 7769 7468 206e 6577 6c79 2061 6c6c  y with newly all
│ │ │ │ -0001d090: 6f63 6174 6564 2065 7272 6f72 2074 6578  ocated error tex
│ │ │ │ -0001d0a0: 742e 0a20 2020 2020 4554 4558 544c 454e  t..     ETEXTLEN
│ │ │ │ -0001d0b0: 3a20 6f75 7470 7574 206c 656e 6774 6820  : output length 
│ │ │ │ -0001d0c0: 6f66 2065 7272 6f72 2074 6578 742e 0a0a  of error text...
│ │ │ │ -0001d0d0: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ -0001d0e0: 6e3a 2a20 4578 7472 6163 7420 6164 6469  n:* Extract addi
│ │ │ │ -0001d0f0: 7469 6f6e 616c 2065 7272 6f72 2074 6578  tional error tex
│ │ │ │ -0001d100: 7420 6672 6f6d 2073 6572 7665 7220 2870  t from server (p
│ │ │ │ -0001d110: 6f73 7369 626c 790a 2020 2020 2065 6d70  ossibly.     emp
│ │ │ │ -0001d120: 7479 292e 0a0a 2020 2020 202a 5265 7475  ty)...     *Retu
│ │ │ │ -0001d130: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ -0001d140: 6e73 2053 4849 5348 495f 4f4b 2069 6666  ns SHISHI_OK iff
│ │ │ │ -0001d150: 2073 7563 6365 7373 6675 6c2e 0a0a 7368   successful...sh
│ │ │ │ -0001d160: 6973 6869 5f6b 7262 6572 726f 725f 7365  ishi_krberror_se
│ │ │ │ -0001d170: 745f 6574 6578 740a 2d2d 2d2d 2d2d 2d2d  t_etext.--------
│ │ │ │ +0001cbd0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ +0001cbe0: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ +0001cbf0: 6869 7368 695f 6b72 6265 7272 6f72 5f65  hishi_krberror_e
│ │ │ │ +0001cc00: 7272 6f72 636f 6465 5f66 6173 7420 2853  rrorcode_fast (S
│ │ │ │ +0001cc10: 6869 7368 6920 2a20 4841 4e44 4c45 2c0a  hishi * HANDLE,.
│ │ │ │ +0001cc20: 2020 2020 2020 2020 2020 5368 6973 6869            Shishi
│ │ │ │ +0001cc30: 5f61 736e 3120 4b52 4245 5252 4f52 290a  _asn1 KRBERROR).
│ │ │ │ +0001cc40: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ +0001cc50: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ +0001cc60: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ +0001cc70: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ +0001cc80: 2020 2020 204b 5242 4552 524f 523a 204b       KRBERROR: K
│ │ │ │ +0001cc90: 5242 2d45 5252 4f52 2073 7472 7563 7475  RB-ERROR structu
│ │ │ │ +0001cca0: 7265 2077 6974 6820 6572 726f 7220 636f  re with error co
│ │ │ │ +0001ccb0: 6465 2e0a 0a20 2020 2020 2a44 6573 6372  de...     *Descr
│ │ │ │ +0001ccc0: 6970 7469 6f6e 3a2a 2047 6574 2065 7272  iption:* Get err
│ │ │ │ +0001ccd0: 6f72 2063 6f64 6520 6672 6f6d 204b 5242  or code from KRB
│ │ │ │ +0001cce0: 2d45 5252 4f52 2c20 7769 7468 6f75 7420  -ERROR, without 
│ │ │ │ +0001ccf0: 6572 726f 720a 2020 2020 2063 6865 636b  error.     check
│ │ │ │ +0001cd00: 696e 672e 0a0a 2020 2020 202a 5265 7475  ing...     *Retu
│ │ │ │ +0001cd10: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ +0001cd20: 6e20 6572 726f 7220 636f 6465 2028 7365  n error code (se
│ │ │ │ +0001cd30: 650a 2020 2020 20e2 8098 7368 6973 6869  e.     ...shishi
│ │ │ │ +0001cd40: 5f6b 7262 6572 726f 725f 6572 726f 7263  _krberror_errorc
│ │ │ │ +0001cd50: 6f64 6528 29e2 8099 2920 6469 7265 6374  ode()...) direct
│ │ │ │ +0001cd60: 6c79 2c20 6f72 202d 3120 6f6e 2065 7272  ly, or -1 on err
│ │ │ │ +0001cd70: 6f72 2e0a 0a73 6869 7368 695f 6b72 6265  or...shishi_krbe
│ │ │ │ +0001cd80: 7272 6f72 5f65 7272 6f72 636f 6465 5f73  rror_errorcode_s
│ │ │ │ +0001cd90: 6574 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  et.-------------
│ │ │ │ +0001cda0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +0001cdb0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +0001cdc0: 696e 7420 7368 6973 6869 5f6b 7262 6572  int shishi_krber
│ │ │ │ +0001cdd0: 726f 725f 6572 726f 7263 6f64 655f 7365  ror_errorcode_se
│ │ │ │ +0001cde0: 7420 2853 6869 7368 6920 2a20 4841 4e44  t (Shishi * HAND
│ │ │ │ +0001cdf0: 4c45 2c0a 2020 2020 2020 2020 2020 5368  LE,.          Sh
│ │ │ │ +0001ce00: 6973 6869 5f61 736e 3120 4b52 4245 5252  ishi_asn1 KRBERR
│ │ │ │ +0001ce10: 4f52 2c20 696e 7420 4552 524f 5243 4f44  OR, int ERRORCOD
│ │ │ │ +0001ce20: 4529 0a20 2020 2020 4841 4e44 4c45 3a20  E).     HANDLE: 
│ │ │ │ +0001ce30: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ +0001ce40: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ +0001ce50: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ +0001ce60: 992e 0a20 2020 2020 4b52 4245 5252 4f52  ...     KRBERROR
│ │ │ │ +0001ce70: 3a20 4b52 422d 4552 524f 5220 7374 7275  : KRB-ERROR stru
│ │ │ │ +0001ce80: 6374 7572 6520 7769 7468 2065 7272 6f72  cture with error
│ │ │ │ +0001ce90: 2063 6f64 6520 746f 2073 6574 2e0a 2020   code to set..  
│ │ │ │ +0001cea0: 2020 2045 5252 4f52 434f 4445 3a20 6e65     ERRORCODE: ne
│ │ │ │ +0001ceb0: 7720 6572 726f 7220 636f 6465 2074 6f20  w error code to 
│ │ │ │ +0001cec0: 7365 7420 696e 206b 7262 6572 726f 722e  set in krberror.
│ │ │ │ +0001ced0: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ +0001cee0: 696f 6e3a 2a20 5365 7420 7468 6520 6572  ion:* Set the er
│ │ │ │ +0001cef0: 726f 722d 636f 6465 2066 6965 6c64 2074  ror-code field t
│ │ │ │ +0001cf00: 6f20 6120 6e65 7720 6572 726f 7220 636f  o a new error co
│ │ │ │ +0001cf10: 6465 2e0a 0a20 2020 2020 2a52 6574 7572  de...     *Retur
│ │ │ │ +0001cf20: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ +0001cf30: 7320 5348 4953 4849 5f4f 4b20 6966 6620  s SHISHI_OK iff 
│ │ │ │ +0001cf40: 7375 6363 6573 7366 756c 2e0a 0a73 6869  successful...shi
│ │ │ │ +0001cf50: 7368 695f 6b72 6265 7272 6f72 5f65 7465  shi_krberror_ete
│ │ │ │ +0001cf60: 7874 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  xt.-------------
│ │ │ │ +0001cf70: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ +0001cf80: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ +0001cf90: 6869 5f6b 7262 6572 726f 725f 6574 6578  hi_krberror_etex
│ │ │ │ +0001cfa0: 7420 2853 6869 7368 6920 2a20 4841 4e44  t (Shishi * HAND
│ │ │ │ +0001cfb0: 4c45 2c0a 2020 2020 2020 2020 2020 5368  LE,.          Sh
│ │ │ │ +0001cfc0: 6973 6869 5f61 736e 3120 4b52 4245 5252  ishi_asn1 KRBERR
│ │ │ │ +0001cfd0: 4f52 2c20 6368 6172 202a 2a20 4554 4558  OR, char ** ETEX
│ │ │ │ +0001cfe0: 542c 2073 697a 655f 7420 2a20 4554 4558  T, size_t * ETEX
│ │ │ │ +0001cff0: 544c 454e 290a 2020 2020 2048 414e 444c  TLEN).     HANDL
│ │ │ │ +0001d000: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ +0001d010: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ +0001d020: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ +0001d030: 29e2 8099 2e0a 2020 2020 204b 5242 4552  ).....     KRBER
│ │ │ │ +0001d040: 524f 523a 204b 5242 2d45 5252 4f52 2073  ROR: KRB-ERROR s
│ │ │ │ +0001d050: 7472 7563 7475 7265 2077 6974 6820 6572  tructure with er
│ │ │ │ +0001d060: 726f 7220 636f 6465 2e0a 2020 2020 2045  ror code..     E
│ │ │ │ +0001d070: 5445 5854 3a20 6f75 7470 7574 2061 7272  TEXT: output arr
│ │ │ │ +0001d080: 6179 2077 6974 6820 6e65 776c 7920 616c  ay with newly al
│ │ │ │ +0001d090: 6c6f 6361 7465 6420 6572 726f 7220 7465  located error te
│ │ │ │ +0001d0a0: 7874 2e0a 2020 2020 2045 5445 5854 4c45  xt..     ETEXTLE
│ │ │ │ +0001d0b0: 4e3a 206f 7574 7075 7420 6c65 6e67 7468  N: output length
│ │ │ │ +0001d0c0: 206f 6620 6572 726f 7220 7465 7874 2e0a   of error text..
│ │ │ │ +0001d0d0: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +0001d0e0: 6f6e 3a2a 2045 7874 7261 6374 2061 6464  on:* Extract add
│ │ │ │ +0001d0f0: 6974 696f 6e61 6c20 6572 726f 7220 7465  itional error te
│ │ │ │ +0001d100: 7874 2066 726f 6d20 7365 7276 6572 2028  xt from server (
│ │ │ │ +0001d110: 706f 7373 6962 6c79 0a20 2020 2020 656d  possibly.     em
│ │ │ │ +0001d120: 7074 7929 2e0a 0a20 2020 2020 2a52 6574  pty)...     *Ret
│ │ │ │ +0001d130: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ +0001d140: 726e 7320 5348 4953 4849 5f4f 4b20 6966  rns SHISHI_OK if
│ │ │ │ +0001d150: 6620 7375 6363 6573 7366 756c 2e0a 0a73  f successful...s
│ │ │ │ +0001d160: 6869 7368 695f 6b72 6265 7272 6f72 5f73  hishi_krberror_s
│ │ │ │ +0001d170: 6574 5f65 7465 7874 0a2d 2d2d 2d2d 2d2d  et_etext.-------
│ │ │ │  0001d180: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0001d190: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ -0001d1a0: 2069 6e74 2073 6869 7368 695f 6b72 6265   int shishi_krbe
│ │ │ │ -0001d1b0: 7272 6f72 5f73 6574 5f65 7465 7874 2028  rror_set_etext (
│ │ │ │ -0001d1c0: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ -0001d1d0: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ -0001d1e0: 695f 6173 6e31 204b 5242 4552 524f 522c  i_asn1 KRBERROR,
│ │ │ │ -0001d1f0: 2063 6f6e 7374 2063 6861 7220 2a20 4554   const char * ET
│ │ │ │ -0001d200: 4558 5429 0a20 2020 2020 4841 4e44 4c45  EXT).     HANDLE
│ │ │ │ -0001d210: 3a20 7368 6973 6869 2068 616e 646c 6520  : shishi handle 
│ │ │ │ -0001d220: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ -0001d230: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ -0001d240: e280 992e 0a20 2020 2020 4b52 4245 5252  .....     KRBERR
│ │ │ │ -0001d250: 4f52 3a20 6b72 6265 7272 6f72 2061 7320  OR: krberror as 
│ │ │ │ -0001d260: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ -0001d270: 7368 6973 6869 5f6b 7262 6572 726f 7228  shishi_krberror(
│ │ │ │ -0001d280: 29e2 8099 2e0a 2020 2020 2045 5445 5854  ).....     ETEXT
│ │ │ │ -0001d290: 3a20 696e 7075 7420 6172 7261 7920 7769  : input array wi
│ │ │ │ -0001d2a0: 7468 2065 7272 6f72 2074 6578 7420 746f  th error text to
│ │ │ │ -0001d2b0: 2073 6574 2e0a 0a20 2020 2020 2a44 6573   set...     *Des
│ │ │ │ -0001d2c0: 6372 6970 7469 6f6e 3a2a 2053 6574 2065  cription:* Set e
│ │ │ │ -0001d2d0: 7272 6f72 2074 6578 7420 2865 2d74 6578  rror text (e-tex
│ │ │ │ -0001d2e0: 7429 2066 6965 6c64 2069 6e20 4b52 422d  t) field in KRB-
│ │ │ │ -0001d2f0: 4552 524f 5220 746f 0a20 2020 2020 7370  ERROR to.     sp
│ │ │ │ -0001d300: 6563 6966 6965 6420 7661 6c75 652e 0a0a  ecified value...
│ │ │ │ -0001d310: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ -0001d320: 7565 3a2a 2052 6574 7572 6e73 2053 4849  ue:* Returns SHI
│ │ │ │ -0001d330: 5348 495f 4f4b 2069 6666 2073 7563 6365  SHI_OK iff succe
│ │ │ │ -0001d340: 7373 6675 6c2e 0a0a 7368 6973 6869 5f6b  ssful...shishi_k
│ │ │ │ -0001d350: 7262 6572 726f 725f 7265 6d6f 7665 5f65  rberror_remove_e
│ │ │ │ -0001d360: 7465 7874 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  text.-----------
│ │ │ │ +0001d190: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ +0001d1a0: 3a20 696e 7420 7368 6973 6869 5f6b 7262  : int shishi_krb
│ │ │ │ +0001d1b0: 6572 726f 725f 7365 745f 6574 6578 7420  error_set_etext 
│ │ │ │ +0001d1c0: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ +0001d1d0: 2c0a 2020 2020 2020 2020 2020 5368 6973  ,.          Shis
│ │ │ │ +0001d1e0: 6869 5f61 736e 3120 4b52 4245 5252 4f52  hi_asn1 KRBERROR
│ │ │ │ +0001d1f0: 2c20 636f 6e73 7420 6368 6172 202a 2045  , const char * E
│ │ │ │ +0001d200: 5445 5854 290a 2020 2020 2048 414e 444c  TEXT).     HANDL
│ │ │ │ +0001d210: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ +0001d220: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ +0001d230: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ +0001d240: 29e2 8099 2e0a 2020 2020 204b 5242 4552  ).....     KRBER
│ │ │ │ +0001d250: 524f 523a 206b 7262 6572 726f 7220 6173  ROR: krberror as
│ │ │ │ +0001d260: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ +0001d270: 9873 6869 7368 695f 6b72 6265 7272 6f72  .shishi_krberror
│ │ │ │ +0001d280: 2829 e280 992e 0a20 2020 2020 4554 4558  ().....     ETEX
│ │ │ │ +0001d290: 543a 2069 6e70 7574 2061 7272 6179 2077  T: input array w
│ │ │ │ +0001d2a0: 6974 6820 6572 726f 7220 7465 7874 2074  ith error text t
│ │ │ │ +0001d2b0: 6f20 7365 742e 0a0a 2020 2020 202a 4465  o set...     *De
│ │ │ │ +0001d2c0: 7363 7269 7074 696f 6e3a 2a20 5365 7420  scription:* Set 
│ │ │ │ +0001d2d0: 6572 726f 7220 7465 7874 2028 652d 7465  error text (e-te
│ │ │ │ +0001d2e0: 7874 2920 6669 656c 6420 696e 204b 5242  xt) field in KRB
│ │ │ │ +0001d2f0: 2d45 5252 4f52 2074 6f0a 2020 2020 2073  -ERROR to.     s
│ │ │ │ +0001d300: 7065 6369 6669 6564 2076 616c 7565 2e0a  pecified value..
│ │ │ │ +0001d310: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ +0001d320: 6c75 653a 2a20 5265 7475 726e 7320 5348  lue:* Returns SH
│ │ │ │ +0001d330: 4953 4849 5f4f 4b20 6966 6620 7375 6363  ISHI_OK iff succ
│ │ │ │ +0001d340: 6573 7366 756c 2e0a 0a73 6869 7368 695f  essful...shishi_
│ │ │ │ +0001d350: 6b72 6265 7272 6f72 5f72 656d 6f76 655f  krberror_remove_
│ │ │ │ +0001d360: 6574 6578 740a 2d2d 2d2d 2d2d 2d2d 2d2d  etext.----------
│ │ │ │  0001d370: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0001d380: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ -0001d390: 2069 6e74 2073 6869 7368 695f 6b72 6265   int shishi_krbe
│ │ │ │ -0001d3a0: 7272 6f72 5f72 656d 6f76 655f 6574 6578  rror_remove_etex
│ │ │ │ -0001d3b0: 7420 2853 6869 7368 6920 2a20 4841 4e44  t (Shishi * HAND
│ │ │ │ -0001d3c0: 4c45 2c0a 2020 2020 2020 2020 2020 5368  LE,.          Sh
│ │ │ │ -0001d3d0: 6973 6869 5f61 736e 3120 4b52 4245 5252  ishi_asn1 KRBERR
│ │ │ │ -0001d3e0: 4f52 290a 2020 2020 2048 414e 444c 453a  OR).     HANDLE:
│ │ │ │ -0001d3f0: 2073 6869 7368 6920 6861 6e64 6c65 2061   shishi handle a
│ │ │ │ -0001d400: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ -0001d410: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ -0001d420: 8099 2e0a 2020 2020 204b 5242 4552 524f  ....     KRBERRO
│ │ │ │ -0001d430: 523a 206b 7262 6572 726f 7220 6173 2061  R: krberror as a
│ │ │ │ -0001d440: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ -0001d450: 6869 7368 695f 6b72 6265 7272 6f72 2829  hishi_krberror()
│ │ │ │ -0001d460: e280 992e 0a0a 2020 2020 202a 4465 7363  ......     *Desc
│ │ │ │ -0001d470: 7269 7074 696f 6e3a 2a20 5265 6d6f 7665  ription:* Remove
│ │ │ │ -0001d480: 2065 7272 6f72 2074 6578 7420 2865 2d74   error text (e-t
│ │ │ │ -0001d490: 6578 7429 2066 6965 6c64 2069 6e20 4b52  ext) field in KR
│ │ │ │ -0001d4a0: 422d 4552 524f 522e 0a0a 2020 2020 202a  B-ERROR...     *
│ │ │ │ -0001d4b0: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ -0001d4c0: 6574 7572 6e73 2053 4849 5348 495f 4f4b  eturns SHISHI_OK
│ │ │ │ -0001d4d0: 2069 6666 2073 7563 6365 7373 6675 6c2e   iff successful.
│ │ │ │ -0001d4e0: 0a0a 7368 6973 6869 5f6b 7262 6572 726f  ..shishi_krberro
│ │ │ │ -0001d4f0: 725f 6564 6174 610a 2d2d 2d2d 2d2d 2d2d  r_edata.--------
│ │ │ │ -0001d500: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -0001d510: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ -0001d520: 2073 6869 7368 695f 6b72 6265 7272 6f72   shishi_krberror
│ │ │ │ -0001d530: 5f65 6461 7461 2028 5368 6973 6869 202a  _edata (Shishi *
│ │ │ │ -0001d540: 2048 414e 444c 452c 0a20 2020 2020 2020   HANDLE,.       
│ │ │ │ -0001d550: 2020 2053 6869 7368 695f 6173 6e31 204b     Shishi_asn1 K
│ │ │ │ -0001d560: 5242 4552 524f 522c 2063 6861 7220 2a2a  RBERROR, char **
│ │ │ │ -0001d570: 2045 4441 5441 2c20 7369 7a65 5f74 202a   EDATA, size_t *
│ │ │ │ -0001d580: 2045 4441 5441 4c45 4e29 0a20 2020 2020   EDATALEN).     
│ │ │ │ -0001d590: 4841 4e44 4c45 3a20 7368 6973 6869 2068  HANDLE: shishi h
│ │ │ │ -0001d5a0: 616e 646c 6520 6173 2061 6c6c 6f63 6174  andle as allocat
│ │ │ │ -0001d5b0: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ -0001d5c0: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ -0001d5d0: 4b52 4245 5252 4f52 3a20 4b52 422d 4552  KRBERROR: KRB-ER
│ │ │ │ -0001d5e0: 524f 5220 7374 7275 6374 7572 6520 7769  ROR structure wi
│ │ │ │ -0001d5f0: 7468 2065 7272 6f72 2063 6f64 652e 0a20  th error code.. 
│ │ │ │ -0001d600: 2020 2020 4544 4154 413a 206f 7574 7075      EDATA: outpu
│ │ │ │ -0001d610: 7420 6172 7261 7920 7769 7468 206e 6577  t array with new
│ │ │ │ -0001d620: 6c79 2061 6c6c 6f63 6174 6564 2065 7272  ly allocated err
│ │ │ │ -0001d630: 6f72 2064 6174 612e 0a20 2020 2020 4544  or data..     ED
│ │ │ │ -0001d640: 4154 414c 454e 3a20 6f75 7470 7574 206c  ATALEN: output l
│ │ │ │ -0001d650: 656e 6774 6820 6f66 2065 7272 6f72 2064  ength of error d
│ │ │ │ -0001d660: 6174 612e 0a0a 2020 2020 202a 4465 7363  ata...     *Desc
│ │ │ │ -0001d670: 7269 7074 696f 6e3a 2a20 4578 7472 6163  ription:* Extrac
│ │ │ │ -0001d680: 7420 6164 6469 7469 6f6e 616c 2065 7272  t additional err
│ │ │ │ -0001d690: 6f72 2064 6174 6120 6672 6f6d 2073 6572  or data from ser
│ │ │ │ -0001d6a0: 7665 7220 2870 6f73 7369 626c 790a 2020  ver (possibly.  
│ │ │ │ -0001d6b0: 2020 2065 6d70 7479 292e 0a0a 2020 2020     empty)...    
│ │ │ │ -0001d6c0: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ -0001d6d0: 2052 6574 7572 6e73 2053 4849 5348 495f   Returns SHISHI_
│ │ │ │ -0001d6e0: 4f4b 2069 6666 2073 7563 6365 7373 6675  OK iff successfu
│ │ │ │ -0001d6f0: 6c2e 0a0a 7368 6973 6869 5f6b 7262 6572  l...shishi_krber
│ │ │ │ -0001d700: 726f 725f 6d65 7468 6f64 6461 7461 0a2d  ror_methoddata.-
│ │ │ │ +0001d380: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ +0001d390: 3a20 696e 7420 7368 6973 6869 5f6b 7262  : int shishi_krb
│ │ │ │ +0001d3a0: 6572 726f 725f 7265 6d6f 7665 5f65 7465  error_remove_ete
│ │ │ │ +0001d3b0: 7874 2028 5368 6973 6869 202a 2048 414e  xt (Shishi * HAN
│ │ │ │ +0001d3c0: 444c 452c 0a20 2020 2020 2020 2020 2053  DLE,.          S
│ │ │ │ +0001d3d0: 6869 7368 695f 6173 6e31 204b 5242 4552  hishi_asn1 KRBER
│ │ │ │ +0001d3e0: 524f 5229 0a20 2020 2020 4841 4e44 4c45  ROR).     HANDLE
│ │ │ │ +0001d3f0: 3a20 7368 6973 6869 2068 616e 646c 6520  : shishi handle 
│ │ │ │ +0001d400: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ +0001d410: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ +0001d420: e280 992e 0a20 2020 2020 4b52 4245 5252  .....     KRBERR
│ │ │ │ +0001d430: 4f52 3a20 6b72 6265 7272 6f72 2061 7320  OR: krberror as 
│ │ │ │ +0001d440: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ +0001d450: 7368 6973 6869 5f6b 7262 6572 726f 7228  shishi_krberror(
│ │ │ │ +0001d460: 29e2 8099 2e0a 0a20 2020 2020 2a44 6573  )......     *Des
│ │ │ │ +0001d470: 6372 6970 7469 6f6e 3a2a 2052 656d 6f76  cription:* Remov
│ │ │ │ +0001d480: 6520 6572 726f 7220 7465 7874 2028 652d  e error text (e-
│ │ │ │ +0001d490: 7465 7874 2920 6669 656c 6420 696e 204b  text) field in K
│ │ │ │ +0001d4a0: 5242 2d45 5252 4f52 2e0a 0a20 2020 2020  RB-ERROR...     
│ │ │ │ +0001d4b0: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ +0001d4c0: 5265 7475 726e 7320 5348 4953 4849 5f4f  Returns SHISHI_O
│ │ │ │ +0001d4d0: 4b20 6966 6620 7375 6363 6573 7366 756c  K iff successful
│ │ │ │ +0001d4e0: 2e0a 0a73 6869 7368 695f 6b72 6265 7272  ...shishi_krberr
│ │ │ │ +0001d4f0: 6f72 5f65 6461 7461 0a2d 2d2d 2d2d 2d2d  or_edata.-------
│ │ │ │ +0001d500: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ +0001d510: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ +0001d520: 7420 7368 6973 6869 5f6b 7262 6572 726f  t shishi_krberro
│ │ │ │ +0001d530: 725f 6564 6174 6120 2853 6869 7368 6920  r_edata (Shishi 
│ │ │ │ +0001d540: 2a20 4841 4e44 4c45 2c0a 2020 2020 2020  * HANDLE,.      
│ │ │ │ +0001d550: 2020 2020 5368 6973 6869 5f61 736e 3120      Shishi_asn1 
│ │ │ │ +0001d560: 4b52 4245 5252 4f52 2c20 6368 6172 202a  KRBERROR, char *
│ │ │ │ +0001d570: 2a20 4544 4154 412c 2073 697a 655f 7420  * EDATA, size_t 
│ │ │ │ +0001d580: 2a20 4544 4154 414c 454e 290a 2020 2020  * EDATALEN).    
│ │ │ │ +0001d590: 2048 414e 444c 453a 2073 6869 7368 6920   HANDLE: shishi 
│ │ │ │ +0001d5a0: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ +0001d5b0: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ +0001d5c0: 5f69 6e69 7428 29e2 8099 2e0a 2020 2020  _init().....    
│ │ │ │ +0001d5d0: 204b 5242 4552 524f 523a 204b 5242 2d45   KRBERROR: KRB-E
│ │ │ │ +0001d5e0: 5252 4f52 2073 7472 7563 7475 7265 2077  RROR structure w
│ │ │ │ +0001d5f0: 6974 6820 6572 726f 7220 636f 6465 2e0a  ith error code..
│ │ │ │ +0001d600: 2020 2020 2045 4441 5441 3a20 6f75 7470       EDATA: outp
│ │ │ │ +0001d610: 7574 2061 7272 6179 2077 6974 6820 6e65  ut array with ne
│ │ │ │ +0001d620: 776c 7920 616c 6c6f 6361 7465 6420 6572  wly allocated er
│ │ │ │ +0001d630: 726f 7220 6461 7461 2e0a 2020 2020 2045  ror data..     E
│ │ │ │ +0001d640: 4441 5441 4c45 4e3a 206f 7574 7075 7420  DATALEN: output 
│ │ │ │ +0001d650: 6c65 6e67 7468 206f 6620 6572 726f 7220  length of error 
│ │ │ │ +0001d660: 6461 7461 2e0a 0a20 2020 2020 2a44 6573  data...     *Des
│ │ │ │ +0001d670: 6372 6970 7469 6f6e 3a2a 2045 7874 7261  cription:* Extra
│ │ │ │ +0001d680: 6374 2061 6464 6974 696f 6e61 6c20 6572  ct additional er
│ │ │ │ +0001d690: 726f 7220 6461 7461 2066 726f 6d20 7365  ror data from se
│ │ │ │ +0001d6a0: 7276 6572 2028 706f 7373 6962 6c79 0a20  rver (possibly. 
│ │ │ │ +0001d6b0: 2020 2020 656d 7074 7929 2e0a 0a20 2020      empty)...   
│ │ │ │ +0001d6c0: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ +0001d6d0: 2a20 5265 7475 726e 7320 5348 4953 4849  * Returns SHISHI
│ │ │ │ +0001d6e0: 5f4f 4b20 6966 6620 7375 6363 6573 7366  _OK iff successf
│ │ │ │ +0001d6f0: 756c 2e0a 0a73 6869 7368 695f 6b72 6265  ul...shishi_krbe
│ │ │ │ +0001d700: 7272 6f72 5f6d 6574 686f 6464 6174 610a  rror_methoddata.
│ │ │ │  0001d710: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0001d720: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ -0001d730: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ -0001d740: 7368 695f 6b72 6265 7272 6f72 5f6d 6574  shi_krberror_met
│ │ │ │ -0001d750: 686f 6464 6174 6120 2853 6869 7368 6920  hoddata (Shishi 
│ │ │ │ -0001d760: 2a20 4841 4e44 4c45 2c0a 2020 2020 2020  * HANDLE,.      
│ │ │ │ -0001d770: 2020 2020 5368 6973 6869 5f61 736e 3120      Shishi_asn1 
│ │ │ │ -0001d780: 4b52 4245 5252 4f52 2c20 5368 6973 6869  KRBERROR, Shishi
│ │ │ │ -0001d790: 5f61 736e 3120 2a20 4d45 5448 4f44 4441  _asn1 * METHODDA
│ │ │ │ -0001d7a0: 5441 290a 2020 2020 2048 414e 444c 453a  TA).     HANDLE:
│ │ │ │ -0001d7b0: 2073 6869 7368 6920 6861 6e64 6c65 2061   shishi handle a
│ │ │ │ -0001d7c0: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ -0001d7d0: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ -0001d7e0: 8099 2e0a 2020 2020 204b 5242 4552 524f  ....     KRBERRO
│ │ │ │ -0001d7f0: 523a 204b 5242 2d45 5252 4f52 2073 7472  R: KRB-ERROR str
│ │ │ │ -0001d800: 7563 7475 7265 2077 6974 6820 6572 726f  ucture with erro
│ │ │ │ -0001d810: 7220 636f 6465 2e0a 2020 2020 204d 4554  r code..     MET
│ │ │ │ -0001d820: 484f 4444 4154 413a 206f 7574 7075 7420  HODDATA: output 
│ │ │ │ -0001d830: 4153 4e2e 3120 4d45 5448 4f44 2d44 4154  ASN.1 METHOD-DAT
│ │ │ │ -0001d840: 412e 0a0a 2020 2020 202a 4465 7363 7269  A...     *Descri
│ │ │ │ -0001d850: 7074 696f 6e3a 2a20 4578 7472 6163 7420  ption:* Extract 
│ │ │ │ -0001d860: 4d45 5448 4f44 2d44 4154 4120 4153 4e2e  METHOD-DATA ASN.
│ │ │ │ -0001d870: 3120 6f62 6a65 6374 2066 726f 6d20 7468  1 object from th
│ │ │ │ -0001d880: 6520 652d 6461 7461 0a20 2020 2020 6669  e e-data.     fi
│ │ │ │ -0001d890: 656c 642e 2020 5468 6520 652d 6461 7461  eld.  The e-data
│ │ │ │ -0001d8a0: 2066 6965 6c64 2077 696c 6c20 6f6e 6c79   field will only
│ │ │ │ -0001d8b0: 2063 6f6e 7461 696e 2061 204d 4554 484f   contain a METHO
│ │ │ │ -0001d8c0: 442d 4441 5441 2069 6620 7468 650a 2020  D-DATA if the.  
│ │ │ │ -0001d8d0: 2020 206b 7262 6572 726f 7220 6572 726f     krberror erro
│ │ │ │ -0001d8e0: 7220 636f 6465 2069 7320 e280 9853 4849  r code is ...SHI
│ │ │ │ -0001d8f0: 5348 495f 4b44 435f 4552 525f 5052 4541  SHI_KDC_ERR_PREA
│ │ │ │ -0001d900: 5554 485f 5245 5155 4952 4544 e280 992e  UTH_REQUIRED....
│ │ │ │ -0001d910: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ -0001d920: 616c 7565 3a2a 2052 6574 7572 6e73 2053  alue:* Returns S
│ │ │ │ -0001d930: 4849 5348 495f 4f4b 2069 6666 2073 7563  HISHI_OK iff suc
│ │ │ │ -0001d940: 6365 7373 6675 6c2e 0a0a 7368 6973 6869  cessful...shishi
│ │ │ │ -0001d950: 5f6b 7262 6572 726f 725f 7365 745f 6564  _krberror_set_ed
│ │ │ │ -0001d960: 6174 610a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ata.------------
│ │ │ │ -0001d970: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -0001d980: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ -0001d990: 2073 6869 7368 695f 6b72 6265 7272 6f72   shishi_krberror
│ │ │ │ -0001d9a0: 5f73 6574 5f65 6461 7461 2028 5368 6973  _set_edata (Shis
│ │ │ │ -0001d9b0: 6869 202a 2048 414e 444c 452c 0a20 2020  hi * HANDLE,.   
│ │ │ │ -0001d9c0: 2020 2020 2020 2053 6869 7368 695f 6173         Shishi_as
│ │ │ │ -0001d9d0: 6e31 204b 5242 4552 524f 522c 2063 6f6e  n1 KRBERROR, con
│ │ │ │ -0001d9e0: 7374 2063 6861 7220 2a20 4544 4154 4129  st char * EDATA)
│ │ │ │ -0001d9f0: 0a20 2020 2020 4841 4e44 4c45 3a20 7368  .     HANDLE: sh
│ │ │ │ -0001da00: 6973 6869 2068 616e 646c 6520 6173 2061  ishi handle as a
│ │ │ │ -0001da10: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ -0001da20: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ -0001da30: 0a20 2020 2020 4b52 4245 5252 4f52 3a20  .     KRBERROR: 
│ │ │ │ -0001da40: 6b72 6265 7272 6f72 2061 7320 616c 6c6f  krberror as allo
│ │ │ │ -0001da50: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ -0001da60: 6869 5f6b 7262 6572 726f 7228 29e2 8099  hi_krberror()...
│ │ │ │ -0001da70: 2e0a 2020 2020 2045 4441 5441 3a20 696e  ..     EDATA: in
│ │ │ │ -0001da80: 7075 7420 6172 7261 7920 7769 7468 2065  put array with e
│ │ │ │ -0001da90: 7272 6f72 2074 6578 7420 746f 2073 6574  rror text to set
│ │ │ │ -0001daa0: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ -0001dab0: 7469 6f6e 3a2a 2053 6574 2065 7272 6f72  tion:* Set error
│ │ │ │ -0001dac0: 2074 6578 7420 2865 2d64 6174 6129 2066   text (e-data) f
│ │ │ │ -0001dad0: 6965 6c64 2069 6e20 4b52 422d 4552 524f  ield in KRB-ERRO
│ │ │ │ -0001dae0: 5220 746f 0a20 2020 2020 7370 6563 6966  R to.     specif
│ │ │ │ -0001daf0: 6965 6420 7661 6c75 652e 0a0a 2020 2020  ied value...    
│ │ │ │ -0001db00: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ -0001db10: 2052 6574 7572 6e73 2053 4849 5348 495f   Returns SHISHI_
│ │ │ │ -0001db20: 4f4b 2069 6666 2073 7563 6365 7373 6675  OK iff successfu
│ │ │ │ -0001db30: 6c2e 0a0a 7368 6973 6869 5f6b 7262 6572  l...shishi_krber
│ │ │ │ -0001db40: 726f 725f 7265 6d6f 7665 5f65 6461 7461  ror_remove_edata
│ │ │ │ -0001db50: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ -0001db60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -0001db70: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ -0001db80: 2073 6869 7368 695f 6b72 6265 7272 6f72   shishi_krberror
│ │ │ │ -0001db90: 5f72 656d 6f76 655f 6564 6174 6120 2853  _remove_edata (S
│ │ │ │ -0001dba0: 6869 7368 6920 2a20 4841 4e44 4c45 2c0a  hishi * HANDLE,.
│ │ │ │ -0001dbb0: 2020 2020 2020 2020 2020 5368 6973 6869            Shishi
│ │ │ │ -0001dbc0: 5f61 736e 3120 4b52 4245 5252 4f52 290a  _asn1 KRBERROR).
│ │ │ │ -0001dbd0: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ -0001dbe0: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ -0001dbf0: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ -0001dc00: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ -0001dc10: 2020 2020 204b 5242 4552 524f 523a 206b       KRBERROR: k
│ │ │ │ -0001dc20: 7262 6572 726f 7220 6173 2061 6c6c 6f63  rberror as alloc
│ │ │ │ -0001dc30: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ -0001dc40: 695f 6b72 6265 7272 6f72 2829 e280 992e  i_krberror()....
│ │ │ │ -0001dc50: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ -0001dc60: 696f 6e3a 2a20 5265 6d6f 7665 2065 7272  ion:* Remove err
│ │ │ │ -0001dc70: 6f72 2074 6578 7420 2865 2d64 6174 6129  or text (e-data)
│ │ │ │ -0001dc80: 2066 6965 6c64 2069 6e20 4b52 422d 4552   field in KRB-ER
│ │ │ │ -0001dc90: 524f 522e 0a0a 2020 2020 202a 5265 7475  ROR...     *Retu
│ │ │ │ -0001dca0: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ -0001dcb0: 6e73 2053 4849 5348 495f 4f4b 2069 6666  ns SHISHI_OK iff
│ │ │ │ -0001dcc0: 2073 7563 6365 7373 6675 6c2e 0a0a 7368   successful...sh
│ │ │ │ -0001dcd0: 6973 6869 5f6b 7262 6572 726f 725f 7072  ishi_krberror_pr
│ │ │ │ -0001dce0: 6574 7479 5f70 7269 6e74 0a2d 2d2d 2d2d  etty_print.-----
│ │ │ │ +0001d720: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +0001d730: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ +0001d740: 6973 6869 5f6b 7262 6572 726f 725f 6d65  ishi_krberror_me
│ │ │ │ +0001d750: 7468 6f64 6461 7461 2028 5368 6973 6869  thoddata (Shishi
│ │ │ │ +0001d760: 202a 2048 414e 444c 452c 0a20 2020 2020   * HANDLE,.     
│ │ │ │ +0001d770: 2020 2020 2053 6869 7368 695f 6173 6e31       Shishi_asn1
│ │ │ │ +0001d780: 204b 5242 4552 524f 522c 2053 6869 7368   KRBERROR, Shish
│ │ │ │ +0001d790: 695f 6173 6e31 202a 204d 4554 484f 4444  i_asn1 * METHODD
│ │ │ │ +0001d7a0: 4154 4129 0a20 2020 2020 4841 4e44 4c45  ATA).     HANDLE
│ │ │ │ +0001d7b0: 3a20 7368 6973 6869 2068 616e 646c 6520  : shishi handle 
│ │ │ │ +0001d7c0: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ +0001d7d0: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ +0001d7e0: e280 992e 0a20 2020 2020 4b52 4245 5252  .....     KRBERR
│ │ │ │ +0001d7f0: 4f52 3a20 4b52 422d 4552 524f 5220 7374  OR: KRB-ERROR st
│ │ │ │ +0001d800: 7275 6374 7572 6520 7769 7468 2065 7272  ructure with err
│ │ │ │ +0001d810: 6f72 2063 6f64 652e 0a20 2020 2020 4d45  or code..     ME
│ │ │ │ +0001d820: 5448 4f44 4441 5441 3a20 6f75 7470 7574  THODDATA: output
│ │ │ │ +0001d830: 2041 534e 2e31 204d 4554 484f 442d 4441   ASN.1 METHOD-DA
│ │ │ │ +0001d840: 5441 2e0a 0a20 2020 2020 2a44 6573 6372  TA...     *Descr
│ │ │ │ +0001d850: 6970 7469 6f6e 3a2a 2045 7874 7261 6374  iption:* Extract
│ │ │ │ +0001d860: 204d 4554 484f 442d 4441 5441 2041 534e   METHOD-DATA ASN
│ │ │ │ +0001d870: 2e31 206f 626a 6563 7420 6672 6f6d 2074  .1 object from t
│ │ │ │ +0001d880: 6865 2065 2d64 6174 610a 2020 2020 2066  he e-data.     f
│ │ │ │ +0001d890: 6965 6c64 2e20 2054 6865 2065 2d64 6174  ield.  The e-dat
│ │ │ │ +0001d8a0: 6120 6669 656c 6420 7769 6c6c 206f 6e6c  a field will onl
│ │ │ │ +0001d8b0: 7920 636f 6e74 6169 6e20 6120 4d45 5448  y contain a METH
│ │ │ │ +0001d8c0: 4f44 2d44 4154 4120 6966 2074 6865 0a20  OD-DATA if the. 
│ │ │ │ +0001d8d0: 2020 2020 6b72 6265 7272 6f72 2065 7272      krberror err
│ │ │ │ +0001d8e0: 6f72 2063 6f64 6520 6973 20e2 8098 5348  or code is ...SH
│ │ │ │ +0001d8f0: 4953 4849 5f4b 4443 5f45 5252 5f50 5245  ISHI_KDC_ERR_PRE
│ │ │ │ +0001d900: 4155 5448 5f52 4551 5549 5245 44e2 8099  AUTH_REQUIRED...
│ │ │ │ +0001d910: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ +0001d920: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ +0001d930: 5348 4953 4849 5f4f 4b20 6966 6620 7375  SHISHI_OK iff su
│ │ │ │ +0001d940: 6363 6573 7366 756c 2e0a 0a73 6869 7368  ccessful...shish
│ │ │ │ +0001d950: 695f 6b72 6265 7272 6f72 5f73 6574 5f65  i_krberror_set_e
│ │ │ │ +0001d960: 6461 7461 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  data.-----------
│ │ │ │ +0001d970: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ +0001d980: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ +0001d990: 7420 7368 6973 6869 5f6b 7262 6572 726f  t shishi_krberro
│ │ │ │ +0001d9a0: 725f 7365 745f 6564 6174 6120 2853 6869  r_set_edata (Shi
│ │ │ │ +0001d9b0: 7368 6920 2a20 4841 4e44 4c45 2c0a 2020  shi * HANDLE,.  
│ │ │ │ +0001d9c0: 2020 2020 2020 2020 5368 6973 6869 5f61          Shishi_a
│ │ │ │ +0001d9d0: 736e 3120 4b52 4245 5252 4f52 2c20 636f  sn1 KRBERROR, co
│ │ │ │ +0001d9e0: 6e73 7420 6368 6172 202a 2045 4441 5441  nst char * EDATA
│ │ │ │ +0001d9f0: 290a 2020 2020 2048 414e 444c 453a 2073  ).     HANDLE: s
│ │ │ │ +0001da00: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ +0001da10: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ +0001da20: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ +0001da30: 2e0a 2020 2020 204b 5242 4552 524f 523a  ..     KRBERROR:
│ │ │ │ +0001da40: 206b 7262 6572 726f 7220 6173 2061 6c6c   krberror as all
│ │ │ │ +0001da50: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ +0001da60: 7368 695f 6b72 6265 7272 6f72 2829 e280  shi_krberror()..
│ │ │ │ +0001da70: 992e 0a20 2020 2020 4544 4154 413a 2069  ...     EDATA: i
│ │ │ │ +0001da80: 6e70 7574 2061 7272 6179 2077 6974 6820  nput array with 
│ │ │ │ +0001da90: 6572 726f 7220 7465 7874 2074 6f20 7365  error text to se
│ │ │ │ +0001daa0: 742e 0a0a 2020 2020 202a 4465 7363 7269  t...     *Descri
│ │ │ │ +0001dab0: 7074 696f 6e3a 2a20 5365 7420 6572 726f  ption:* Set erro
│ │ │ │ +0001dac0: 7220 7465 7874 2028 652d 6461 7461 2920  r text (e-data) 
│ │ │ │ +0001dad0: 6669 656c 6420 696e 204b 5242 2d45 5252  field in KRB-ERR
│ │ │ │ +0001dae0: 4f52 2074 6f0a 2020 2020 2073 7065 6369  OR to.     speci
│ │ │ │ +0001daf0: 6669 6564 2076 616c 7565 2e0a 0a20 2020  fied value...   
│ │ │ │ +0001db00: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ +0001db10: 2a20 5265 7475 726e 7320 5348 4953 4849  * Returns SHISHI
│ │ │ │ +0001db20: 5f4f 4b20 6966 6620 7375 6363 6573 7366  _OK iff successf
│ │ │ │ +0001db30: 756c 2e0a 0a73 6869 7368 695f 6b72 6265  ul...shishi_krbe
│ │ │ │ +0001db40: 7272 6f72 5f72 656d 6f76 655f 6564 6174  rror_remove_edat
│ │ │ │ +0001db50: 610a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  a.--------------
│ │ │ │ +0001db60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ +0001db70: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ +0001db80: 7420 7368 6973 6869 5f6b 7262 6572 726f  t shishi_krberro
│ │ │ │ +0001db90: 725f 7265 6d6f 7665 5f65 6461 7461 2028  r_remove_edata (
│ │ │ │ +0001dba0: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ +0001dbb0: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ +0001dbc0: 695f 6173 6e31 204b 5242 4552 524f 5229  i_asn1 KRBERROR)
│ │ │ │ +0001dbd0: 0a20 2020 2020 4841 4e44 4c45 3a20 7368  .     HANDLE: sh
│ │ │ │ +0001dbe0: 6973 6869 2068 616e 646c 6520 6173 2061  ishi handle as a
│ │ │ │ +0001dbf0: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ +0001dc00: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ +0001dc10: 0a20 2020 2020 4b52 4245 5252 4f52 3a20  .     KRBERROR: 
│ │ │ │ +0001dc20: 6b72 6265 7272 6f72 2061 7320 616c 6c6f  krberror as allo
│ │ │ │ +0001dc30: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ +0001dc40: 6869 5f6b 7262 6572 726f 7228 29e2 8099  hi_krberror()...
│ │ │ │ +0001dc50: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ +0001dc60: 7469 6f6e 3a2a 2052 656d 6f76 6520 6572  tion:* Remove er
│ │ │ │ +0001dc70: 726f 7220 7465 7874 2028 652d 6461 7461  ror text (e-data
│ │ │ │ +0001dc80: 2920 6669 656c 6420 696e 204b 5242 2d45  ) field in KRB-E
│ │ │ │ +0001dc90: 5252 4f52 2e0a 0a20 2020 2020 2a52 6574  RROR...     *Ret
│ │ │ │ +0001dca0: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ +0001dcb0: 726e 7320 5348 4953 4849 5f4f 4b20 6966  rns SHISHI_OK if
│ │ │ │ +0001dcc0: 6620 7375 6363 6573 7366 756c 2e0a 0a73  f successful...s
│ │ │ │ +0001dcd0: 6869 7368 695f 6b72 6265 7272 6f72 5f70  hishi_krberror_p
│ │ │ │ +0001dce0: 7265 7474 795f 7072 696e 740a 2d2d 2d2d  retty_print.----
│ │ │ │  0001dcf0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0001dd00: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ -0001dd10: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ -0001dd20: 695f 6b72 6265 7272 6f72 5f70 7265 7474  i_krberror_prett
│ │ │ │ -0001dd30: 795f 7072 696e 7420 2853 6869 7368 6920  y_print (Shishi 
│ │ │ │ -0001dd40: 2a20 4841 4e44 4c45 2c0a 2020 2020 2020  * HANDLE,.      
│ │ │ │ -0001dd50: 2020 2020 4649 4c45 202a 2046 482c 2053      FILE * FH, S
│ │ │ │ -0001dd60: 6869 7368 695f 6173 6e31 204b 5242 4552  hishi_asn1 KRBER
│ │ │ │ -0001dd70: 524f 5229 0a20 2020 2020 4841 4e44 4c45  ROR).     HANDLE
│ │ │ │ -0001dd80: 3a20 7368 6973 6869 2068 616e 646c 6520  : shishi handle 
│ │ │ │ -0001dd90: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ -0001dda0: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ -0001ddb0: e280 992e 0a20 2020 2020 4648 3a20 6669  .....     FH: fi
│ │ │ │ -0001ddc0: 6c65 2068 616e 646c 6520 6f70 656e 6564  le handle opened
│ │ │ │ -0001ddd0: 2066 6f72 2077 7269 7469 6e67 2e0a 2020   for writing..  
│ │ │ │ -0001dde0: 2020 204b 5242 4552 524f 523a 204b 5242     KRBERROR: KRB
│ │ │ │ -0001ddf0: 2d45 5252 4f52 2073 7472 7563 7475 7265  -ERROR structure
│ │ │ │ -0001de00: 2077 6974 6820 6572 726f 7220 636f 6465   with error code
│ │ │ │ -0001de10: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ -0001de20: 7469 6f6e 3a2a 2050 7269 6e74 204b 5242  tion:* Print KRB
│ │ │ │ -0001de30: 2d45 5252 4f52 2065 7272 6f72 2063 6f6e  -ERROR error con
│ │ │ │ -0001de40: 6469 7469 6f6e 2061 6e64 2073 6f6d 6520  dition and some 
│ │ │ │ -0001de50: 6578 706c 616e 6174 6f72 790a 2020 2020  explanatory.    
│ │ │ │ -0001de60: 2074 6578 7420 746f 2066 696c 6520 6465   text to file de
│ │ │ │ -0001de70: 7363 7269 7074 6f72 2e0a 0a20 2020 2020  scriptor...     
│ │ │ │ -0001de80: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ -0001de90: 5265 7475 726e 7320 5348 4953 4849 5f4f  Returns SHISHI_O
│ │ │ │ -0001dea0: 4b20 6966 6620 7375 6363 6573 7366 756c  K iff successful
│ │ │ │ -0001deb0: 2e0a 0a73 6869 7368 695f 6b72 6265 7272  ...shishi_krberr
│ │ │ │ -0001dec0: 6f72 5f65 7272 6f72 636f 6465 5f6d 6573  or_errorcode_mes
│ │ │ │ -0001ded0: 7361 6765 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  sage.-----------
│ │ │ │ +0001dd00: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ +0001dd10: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ +0001dd20: 6869 5f6b 7262 6572 726f 725f 7072 6574  hi_krberror_pret
│ │ │ │ +0001dd30: 7479 5f70 7269 6e74 2028 5368 6973 6869  ty_print (Shishi
│ │ │ │ +0001dd40: 202a 2048 414e 444c 452c 0a20 2020 2020   * HANDLE,.     
│ │ │ │ +0001dd50: 2020 2020 2046 494c 4520 2a20 4648 2c20       FILE * FH, 
│ │ │ │ +0001dd60: 5368 6973 6869 5f61 736e 3120 4b52 4245  Shishi_asn1 KRBE
│ │ │ │ +0001dd70: 5252 4f52 290a 2020 2020 2048 414e 444c  RROR).     HANDL
│ │ │ │ +0001dd80: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ +0001dd90: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ +0001dda0: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ +0001ddb0: 29e2 8099 2e0a 2020 2020 2046 483a 2066  ).....     FH: f
│ │ │ │ +0001ddc0: 696c 6520 6861 6e64 6c65 206f 7065 6e65  ile handle opene
│ │ │ │ +0001ddd0: 6420 666f 7220 7772 6974 696e 672e 0a20  d for writing.. 
│ │ │ │ +0001dde0: 2020 2020 4b52 4245 5252 4f52 3a20 4b52      KRBERROR: KR
│ │ │ │ +0001ddf0: 422d 4552 524f 5220 7374 7275 6374 7572  B-ERROR structur
│ │ │ │ +0001de00: 6520 7769 7468 2065 7272 6f72 2063 6f64  e with error cod
│ │ │ │ +0001de10: 652e 0a0a 2020 2020 202a 4465 7363 7269  e...     *Descri
│ │ │ │ +0001de20: 7074 696f 6e3a 2a20 5072 696e 7420 4b52  ption:* Print KR
│ │ │ │ +0001de30: 422d 4552 524f 5220 6572 726f 7220 636f  B-ERROR error co
│ │ │ │ +0001de40: 6e64 6974 696f 6e20 616e 6420 736f 6d65  ndition and some
│ │ │ │ +0001de50: 2065 7870 6c61 6e61 746f 7279 0a20 2020   explanatory.   
│ │ │ │ +0001de60: 2020 7465 7874 2074 6f20 6669 6c65 2064    text to file d
│ │ │ │ +0001de70: 6573 6372 6970 746f 722e 0a0a 2020 2020  escriptor...    
│ │ │ │ +0001de80: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ +0001de90: 2052 6574 7572 6e73 2053 4849 5348 495f   Returns SHISHI_
│ │ │ │ +0001dea0: 4f4b 2069 6666 2073 7563 6365 7373 6675  OK iff successfu
│ │ │ │ +0001deb0: 6c2e 0a0a 7368 6973 6869 5f6b 7262 6572  l...shishi_krber
│ │ │ │ +0001dec0: 726f 725f 6572 726f 7263 6f64 655f 6d65  ror_errorcode_me
│ │ │ │ +0001ded0: 7373 6167 650a 2d2d 2d2d 2d2d 2d2d 2d2d  ssage.----------
│ │ │ │  0001dee0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0001def0: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ -0001df00: 7469 6f6e 3a20 636f 6e73 7420 6368 6172  tion: const char
│ │ │ │ -0001df10: 202a 2073 6869 7368 695f 6b72 6265 7272   * shishi_krberr
│ │ │ │ -0001df20: 6f72 5f65 7272 6f72 636f 6465 5f6d 6573  or_errorcode_mes
│ │ │ │ -0001df30: 7361 6765 0a20 2020 2020 2020 2020 2028  sage.          (
│ │ │ │ -0001df40: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ -0001df50: 2069 6e74 2045 5252 4f52 434f 4445 290a   int ERRORCODE).
│ │ │ │ -0001df60: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ -0001df70: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ -0001df80: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ -0001df90: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ -0001dfa0: 2020 2020 2045 5252 4f52 434f 4445 3a20       ERRORCODE: 
│ │ │ │ -0001dfb0: 696e 7465 6765 7220 4b52 422d 4552 524f  integer KRB-ERRO
│ │ │ │ -0001dfc0: 5220 6572 726f 7220 636f 6465 2e0a 0a20  R error code... 
│ │ │ │ -0001dfd0: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -0001dfe0: 3a2a 2047 6574 2068 756d 616e 2072 6561  :* Get human rea
│ │ │ │ -0001dff0: 6461 626c 6520 7374 7269 6e67 2064 6573  dable string des
│ │ │ │ -0001e000: 6372 6962 696e 6720 4b52 422d 4552 524f  cribing KRB-ERRO
│ │ │ │ -0001e010: 5220 636f 6465 2e0a 0a20 2020 2020 2a52  R code...     *R
│ │ │ │ -0001e020: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ -0001e030: 7475 726e 2061 2073 7472 696e 6720 6465  turn a string de
│ │ │ │ -0001e040: 7363 7269 6269 6e67 2065 7272 6f72 2063  scribing error c
│ │ │ │ -0001e050: 6f64 652e 2020 5468 6973 0a20 2020 2020  ode.  This.     
│ │ │ │ -0001e060: 6675 6e63 7469 6f6e 2077 696c 6c20 616c  function will al
│ │ │ │ -0001e070: 7761 7973 2072 6574 7572 6e20 6120 7374  ways return a st
│ │ │ │ -0001e080: 7269 6e67 2065 7665 6e20 6966 2074 6865  ring even if the
│ │ │ │ -0001e090: 2065 7272 6f72 2063 6f64 6520 6973 6e27   error code isn'
│ │ │ │ -0001e0a0: 740a 2020 2020 206b 6e6f 776e 2e0a 0a73  t.     known...s
│ │ │ │ -0001e0b0: 6869 7368 695f 6b72 6265 7272 6f72 5f6d  hishi_krberror_m
│ │ │ │ -0001e0c0: 6573 7361 6765 0a2d 2d2d 2d2d 2d2d 2d2d  essage.---------
│ │ │ │ -0001e0d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -0001e0e0: 202d 2d20 4675 6e63 7469 6f6e 3a20 636f   -- Function: co
│ │ │ │ -0001e0f0: 6e73 7420 6368 6172 202a 2073 6869 7368  nst char * shish
│ │ │ │ -0001e100: 695f 6b72 6265 7272 6f72 5f6d 6573 7361  i_krberror_messa
│ │ │ │ -0001e110: 6765 2028 5368 6973 6869 202a 2048 414e  ge (Shishi * HAN
│ │ │ │ -0001e120: 444c 452c 0a20 2020 2020 2020 2020 2053  DLE,.          S
│ │ │ │ -0001e130: 6869 7368 695f 6173 6e31 204b 5242 4552  hishi_asn1 KRBER
│ │ │ │ -0001e140: 524f 5229 0a20 2020 2020 4841 4e44 4c45  ROR).     HANDLE
│ │ │ │ -0001e150: 3a20 7368 6973 6869 2068 616e 646c 6520  : shishi handle 
│ │ │ │ -0001e160: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ -0001e170: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ -0001e180: e280 992e 0a20 2020 2020 4b52 4245 5252  .....     KRBERR
│ │ │ │ -0001e190: 4f52 3a20 4b52 422d 4552 524f 5220 7374  OR: KRB-ERROR st
│ │ │ │ -0001e1a0: 7275 6374 7572 6520 7769 7468 2065 7272  ructure with err
│ │ │ │ -0001e1b0: 6f72 2063 6f64 652e 0a0a 2020 2020 202a  or code...     *
│ │ │ │ -0001e1c0: 4465 7363 7269 7074 696f 6e3a 2a20 4578  Description:* Ex
│ │ │ │ -0001e1d0: 7472 6163 7420 6572 726f 7220 636f 6465  tract error code
│ │ │ │ -0001e1e0: 2028 7365 650a 2020 2020 20e2 8098 7368   (see.     ...sh
│ │ │ │ -0001e1f0: 6973 6869 5f6b 7262 6572 726f 725f 6572  ishi_krberror_er
│ │ │ │ -0001e200: 726f 7263 6f64 655f 6661 7374 2829 e280  rorcode_fast()..
│ │ │ │ -0001e210: 9929 2061 6e64 2072 6574 7572 6e20 6572  .) and return er
│ │ │ │ -0001e220: 726f 7220 6d65 7373 6167 6520 2873 6565  ror message (see
│ │ │ │ -0001e230: 0a20 2020 2020 e280 9873 6869 7368 695f  .     ...shishi_
│ │ │ │ -0001e240: 6b72 6265 7272 6f72 5f65 7272 6f72 636f  krberror_errorco
│ │ │ │ -0001e250: 6465 5f6d 6573 7361 6765 2829 e280 9929  de_message()...)
│ │ │ │ -0001e260: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ -0001e270: 7661 6c75 653a 2a20 5265 7475 726e 2061  value:* Return a
│ │ │ │ -0001e280: 2073 7472 696e 6720 6465 7363 7269 6269   string describi
│ │ │ │ -0001e290: 6e67 2065 7272 6f72 2063 6f64 652e 2020  ng error code.  
│ │ │ │ -0001e2a0: 5468 6973 0a20 2020 2020 6675 6e63 7469  This.     functi
│ │ │ │ -0001e2b0: 6f6e 2077 696c 6c20 616c 7761 7973 2072  on will always r
│ │ │ │ -0001e2c0: 6574 7572 6e20 6120 7374 7269 6e67 2065  eturn a string e
│ │ │ │ -0001e2d0: 7665 6e20 6966 2074 6865 2065 7272 6f72  ven if the error
│ │ │ │ -0001e2e0: 2063 6f64 6520 6973 6e27 740a 2020 2020   code isn't.    
│ │ │ │ -0001e2f0: 206b 6e6f 776e 2e0a 0a1f 0a46 696c 653a   known.....File:
│ │ │ │ -0001e300: 2073 6869 7368 692e 696e 666f 2c20 204e   shishi.info,  N
│ │ │ │ -0001e310: 6f64 653a 2043 7279 7074 6f67 7261 7068  ode: Cryptograph
│ │ │ │ -0001e320: 6963 2046 756e 6374 696f 6e73 2c20 204e  ic Functions,  N
│ │ │ │ -0001e330: 6578 743a 2058 2e35 3039 2046 756e 6374  ext: X.509 Funct
│ │ │ │ -0001e340: 696f 6e73 2c20 2050 7265 763a 204b 5242  ions,  Prev: KRB
│ │ │ │ -0001e350: 2d45 5252 4f52 2046 756e 6374 696f 6e73  -ERROR Functions
│ │ │ │ -0001e360: 2c20 2055 703a 2050 726f 6772 616d 6d69  ,  Up: Programmi
│ │ │ │ -0001e370: 6e67 204d 616e 7561 6c0a 0a35 2e31 3320  ng Manual..5.13 
│ │ │ │ -0001e380: 4372 7970 746f 6772 6170 6869 6320 4675  Cryptographic Fu
│ │ │ │ -0001e390: 6e63 7469 6f6e 730a 3d3d 3d3d 3d3d 3d3d  nctions.========
│ │ │ │ +0001def0: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +0001df00: 6374 696f 6e3a 2063 6f6e 7374 2063 6861  ction: const cha
│ │ │ │ +0001df10: 7220 2a20 7368 6973 6869 5f6b 7262 6572  r * shishi_krber
│ │ │ │ +0001df20: 726f 725f 6572 726f 7263 6f64 655f 6d65  ror_errorcode_me
│ │ │ │ +0001df30: 7373 6167 650a 2020 2020 2020 2020 2020  ssage.          
│ │ │ │ +0001df40: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ +0001df50: 2c20 696e 7420 4552 524f 5243 4f44 4529  , int ERRORCODE)
│ │ │ │ +0001df60: 0a20 2020 2020 4841 4e44 4c45 3a20 7368  .     HANDLE: sh
│ │ │ │ +0001df70: 6973 6869 2068 616e 646c 6520 6173 2061  ishi handle as a
│ │ │ │ +0001df80: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ +0001df90: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ +0001dfa0: 0a20 2020 2020 4552 524f 5243 4f44 453a  .     ERRORCODE:
│ │ │ │ +0001dfb0: 2069 6e74 6567 6572 204b 5242 2d45 5252   integer KRB-ERR
│ │ │ │ +0001dfc0: 4f52 2065 7272 6f72 2063 6f64 652e 0a0a  OR error code...
│ │ │ │ +0001dfd0: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ +0001dfe0: 6e3a 2a20 4765 7420 6875 6d61 6e20 7265  n:* Get human re
│ │ │ │ +0001dff0: 6164 6162 6c65 2073 7472 696e 6720 6465  adable string de
│ │ │ │ +0001e000: 7363 7269 6269 6e67 204b 5242 2d45 5252  scribing KRB-ERR
│ │ │ │ +0001e010: 4f52 2063 6f64 652e 0a0a 2020 2020 202a  OR code...     *
│ │ │ │ +0001e020: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ +0001e030: 6574 7572 6e20 6120 7374 7269 6e67 2064  eturn a string d
│ │ │ │ +0001e040: 6573 6372 6962 696e 6720 6572 726f 7220  escribing error 
│ │ │ │ +0001e050: 636f 6465 2e20 2054 6869 730a 2020 2020  code.  This.    
│ │ │ │ +0001e060: 2066 756e 6374 696f 6e20 7769 6c6c 2061   function will a
│ │ │ │ +0001e070: 6c77 6179 7320 7265 7475 726e 2061 2073  lways return a s
│ │ │ │ +0001e080: 7472 696e 6720 6576 656e 2069 6620 7468  tring even if th
│ │ │ │ +0001e090: 6520 6572 726f 7220 636f 6465 2069 736e  e error code isn
│ │ │ │ +0001e0a0: 2774 0a20 2020 2020 6b6e 6f77 6e2e 0a0a  't.     known...
│ │ │ │ +0001e0b0: 7368 6973 6869 5f6b 7262 6572 726f 725f  shishi_krberror_
│ │ │ │ +0001e0c0: 6d65 7373 6167 650a 2d2d 2d2d 2d2d 2d2d  message.--------
│ │ │ │ +0001e0d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +0001e0e0: 0a20 2d2d 2046 756e 6374 696f 6e3a 2063  . -- Function: c
│ │ │ │ +0001e0f0: 6f6e 7374 2063 6861 7220 2a20 7368 6973  onst char * shis
│ │ │ │ +0001e100: 6869 5f6b 7262 6572 726f 725f 6d65 7373  hi_krberror_mess
│ │ │ │ +0001e110: 6167 6520 2853 6869 7368 6920 2a20 4841  age (Shishi * HA
│ │ │ │ +0001e120: 4e44 4c45 2c0a 2020 2020 2020 2020 2020  NDLE,.          
│ │ │ │ +0001e130: 5368 6973 6869 5f61 736e 3120 4b52 4245  Shishi_asn1 KRBE
│ │ │ │ +0001e140: 5252 4f52 290a 2020 2020 2048 414e 444c  RROR).     HANDL
│ │ │ │ +0001e150: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ +0001e160: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ +0001e170: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ +0001e180: 29e2 8099 2e0a 2020 2020 204b 5242 4552  ).....     KRBER
│ │ │ │ +0001e190: 524f 523a 204b 5242 2d45 5252 4f52 2073  ROR: KRB-ERROR s
│ │ │ │ +0001e1a0: 7472 7563 7475 7265 2077 6974 6820 6572  tructure with er
│ │ │ │ +0001e1b0: 726f 7220 636f 6465 2e0a 0a20 2020 2020  ror code...     
│ │ │ │ +0001e1c0: 2a44 6573 6372 6970 7469 6f6e 3a2a 2045  *Description:* E
│ │ │ │ +0001e1d0: 7874 7261 6374 2065 7272 6f72 2063 6f64  xtract error cod
│ │ │ │ +0001e1e0: 6520 2873 6565 0a20 2020 2020 e280 9873  e (see.     ...s
│ │ │ │ +0001e1f0: 6869 7368 695f 6b72 6265 7272 6f72 5f65  hishi_krberror_e
│ │ │ │ +0001e200: 7272 6f72 636f 6465 5f66 6173 7428 29e2  rrorcode_fast().
│ │ │ │ +0001e210: 8099 2920 616e 6420 7265 7475 726e 2065  ..) and return e
│ │ │ │ +0001e220: 7272 6f72 206d 6573 7361 6765 2028 7365  rror message (se
│ │ │ │ +0001e230: 650a 2020 2020 20e2 8098 7368 6973 6869  e.     ...shishi
│ │ │ │ +0001e240: 5f6b 7262 6572 726f 725f 6572 726f 7263  _krberror_errorc
│ │ │ │ +0001e250: 6f64 655f 6d65 7373 6167 6528 29e2 8099  ode_message()...
│ │ │ │ +0001e260: 292e 0a0a 2020 2020 202a 5265 7475 726e  )...     *Return
│ │ │ │ +0001e270: 2076 616c 7565 3a2a 2052 6574 7572 6e20   value:* Return 
│ │ │ │ +0001e280: 6120 7374 7269 6e67 2064 6573 6372 6962  a string describ
│ │ │ │ +0001e290: 696e 6720 6572 726f 7220 636f 6465 2e20  ing error code. 
│ │ │ │ +0001e2a0: 2054 6869 730a 2020 2020 2066 756e 6374   This.     funct
│ │ │ │ +0001e2b0: 696f 6e20 7769 6c6c 2061 6c77 6179 7320  ion will always 
│ │ │ │ +0001e2c0: 7265 7475 726e 2061 2073 7472 696e 6720  return a string 
│ │ │ │ +0001e2d0: 6576 656e 2069 6620 7468 6520 6572 726f  even if the erro
│ │ │ │ +0001e2e0: 7220 636f 6465 2069 736e 2774 0a20 2020  r code isn't.   
│ │ │ │ +0001e2f0: 2020 6b6e 6f77 6e2e 0a0a 1f0a 4669 6c65    known.....File
│ │ │ │ +0001e300: 3a20 7368 6973 6869 2e69 6e66 6f2c 2020  : shishi.info,  
│ │ │ │ +0001e310: 4e6f 6465 3a20 4372 7970 746f 6772 6170  Node: Cryptograp
│ │ │ │ +0001e320: 6869 6320 4675 6e63 7469 6f6e 732c 2020  hic Functions,  
│ │ │ │ +0001e330: 4e65 7874 3a20 582e 3530 3920 4675 6e63  Next: X.509 Func
│ │ │ │ +0001e340: 7469 6f6e 732c 2020 5072 6576 3a20 4b52  tions,  Prev: KR
│ │ │ │ +0001e350: 422d 4552 524f 5220 4675 6e63 7469 6f6e  B-ERROR Function
│ │ │ │ +0001e360: 732c 2020 5570 3a20 5072 6f67 7261 6d6d  s,  Up: Programm
│ │ │ │ +0001e370: 696e 6720 4d61 6e75 616c 0a0a 352e 3133  ing Manual..5.13
│ │ │ │ +0001e380: 2043 7279 7074 6f67 7261 7068 6963 2046   Cryptographic F
│ │ │ │ +0001e390: 756e 6374 696f 6e73 0a3d 3d3d 3d3d 3d3d  unctions.=======
│ │ │ │  0001e3a0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ -0001e3b0: 3d3d 3d3d 0a0a 556e 6465 726e 6561 7468  ====..Underneath
│ │ │ │ -0001e3c0: 2074 6865 2068 6967 682d 6c65 7665 6c20   the high-level 
│ │ │ │ -0001e3d0: 6675 6e63 7469 6f6e 7320 6465 7363 7269  functions descri
│ │ │ │ -0001e3e0: 6265 6420 6561 726c 6965 722c 2063 7279  bed earlier, cry
│ │ │ │ -0001e3f0: 7074 6f67 7261 7068 6963 0a6f 7065 7261  ptographic.opera
│ │ │ │ -0001e400: 7469 6f6e 7320 6172 6520 6861 7070 656e  tions are happen
│ │ │ │ -0001e410: 696e 672e 2020 4966 2079 6f75 206e 6565  ing.  If you nee
│ │ │ │ -0001e420: 6420 746f 2061 6363 6573 7320 7468 6573  d to access thes
│ │ │ │ -0001e430: 6520 6372 7970 746f 6772 6170 6869 630a  e cryptographic.
│ │ │ │ -0001e440: 7072 696d 6974 6976 6573 2064 6972 6563  primitives direc
│ │ │ │ -0001e450: 746c 792c 2074 6869 7320 7365 6374 696f  tly, this sectio
│ │ │ │ -0001e460: 6e20 6465 7363 7269 6265 7320 7468 6520  n describes the 
│ │ │ │ -0001e470: 6675 6e63 7469 6f6e 7320 6176 6169 6c61  functions availa
│ │ │ │ -0001e480: 626c 652e 0a0a 2020 204d 6f73 7420 6372  ble...   Most cr
│ │ │ │ -0001e490: 7970 746f 6772 6170 6869 6320 6f70 6572  yptographic oper
│ │ │ │ -0001e4a0: 6174 696f 6e73 206e 6565 6420 6b65 7969  ations need keyi
│ │ │ │ -0001e4b0: 6e67 206d 6174 6572 6961 6c2c 2061 6e64  ng material, and
│ │ │ │ -0001e4c0: 2063 7279 7074 6f67 7261 7068 6963 0a6b   cryptographic.k
│ │ │ │ -0001e4d0: 6579 7320 6861 7665 2062 6565 6e20 6973  eys have been is
│ │ │ │ -0001e4e0: 6f6c 6174 6564 2069 6e74 6f20 6974 2773  olated into it's
│ │ │ │ -0001e4f0: 206f 776e 2064 6174 6120 7374 7275 6374   own data struct
│ │ │ │ -0001e500: 7572 6520 e280 9853 6869 7368 695f 6b65  ure ...Shishi_ke
│ │ │ │ -0001e510: 79e2 8099 2e20 2054 6865 0a66 6f6c 6c6f  y....  The.follo
│ │ │ │ -0001e520: 7769 6e67 2069 6c6c 7573 7472 6174 6573  wing illustrates
│ │ │ │ -0001e530: 2069 7427 7320 636f 6e74 656e 7473 2c20   it's contents, 
│ │ │ │ -0001e540: 6275 7420 6e6f 7465 2074 6861 7420 796f  but note that yo
│ │ │ │ -0001e550: 7520 6361 6e6e 6f74 2061 6363 6573 730a  u cannot access.
│ │ │ │ -0001e560: 6974 2773 2065 6c65 6d65 6e74 7320 6469  it's elements di
│ │ │ │ -0001e570: 7265 6374 6c79 2062 7574 206d 7573 7420  rectly but must 
│ │ │ │ -0001e580: 7573 6520 7468 6520 6163 6365 7373 6f72  use the accessor
│ │ │ │ -0001e590: 2066 756e 6374 696f 6e73 2064 6573 6372   functions descr
│ │ │ │ -0001e5a0: 6962 6564 0a62 656c 6f77 2e0a 0a73 7472  ibed.below...str
│ │ │ │ -0001e5b0: 7563 7420 5368 6973 6869 5f6b 6579 0a7b  uct Shishi_key.{
│ │ │ │ -0001e5c0: 0a20 2069 6e74 2074 7970 653b 2020 2020  .  int type;    
│ │ │ │ -0001e5d0: 2f2a 2052 4643 2031 3531 3020 656e 6372  /* RFC 1510 encr
│ │ │ │ -0001e5e0: 7970 7469 6f6e 2069 6e74 6567 6572 2074  yption integer t
│ │ │ │ -0001e5f0: 7970 6520 2a2f 0a20 2063 6861 7220 2a76  ype */.  char *v
│ │ │ │ -0001e600: 616c 7565 3b20 2f2a 2043 7279 7074 6f67  alue; /* Cryptog
│ │ │ │ -0001e610: 7261 7068 6963 206b 6579 2064 6174 6120  raphic key data 
│ │ │ │ -0001e620: 2a2f 0a20 2069 6e74 2076 6572 7369 6f6e  */.  int version
│ │ │ │ -0001e630: 3b20 2f2a 2052 4643 2031 3531 3020 6060  ; /* RFC 1510 ``
│ │ │ │ -0001e640: 6b76 6e6f 2727 202a 2f0a 7d3b 0a0a 2020  kvno'' */.};..  
│ │ │ │ -0001e650: 2041 6c6c 2066 756e 6374 696f 6e73 2074   All functions t
│ │ │ │ -0001e660: 6861 7420 6f70 6572 6174 6520 6f6e 2074  hat operate on t
│ │ │ │ -0001e670: 6869 7320 6461 7461 2073 7472 7563 7475  his data structu
│ │ │ │ -0001e680: 7265 2061 7265 2064 6573 6372 6962 6564  re are described
│ │ │ │ -0001e690: 206e 6f77 2e0a 0a73 6869 7368 695f 6b65   now...shishi_ke
│ │ │ │ -0001e6a0: 795f 7072 696e 6369 7061 6c0a 2d2d 2d2d  y_principal.----
│ │ │ │ +0001e3b0: 3d3d 3d3d 3d0a 0a55 6e64 6572 6e65 6174  =====..Underneat
│ │ │ │ +0001e3c0: 6820 7468 6520 6869 6768 2d6c 6576 656c  h the high-level
│ │ │ │ +0001e3d0: 2066 756e 6374 696f 6e73 2064 6573 6372   functions descr
│ │ │ │ +0001e3e0: 6962 6564 2065 6172 6c69 6572 2c20 6372  ibed earlier, cr
│ │ │ │ +0001e3f0: 7970 746f 6772 6170 6869 630a 6f70 6572  yptographic.oper
│ │ │ │ +0001e400: 6174 696f 6e73 2061 7265 2068 6170 7065  ations are happe
│ │ │ │ +0001e410: 6e69 6e67 2e20 2049 6620 796f 7520 6e65  ning.  If you ne
│ │ │ │ +0001e420: 6564 2074 6f20 6163 6365 7373 2074 6865  ed to access the
│ │ │ │ +0001e430: 7365 2063 7279 7074 6f67 7261 7068 6963  se cryptographic
│ │ │ │ +0001e440: 0a70 7269 6d69 7469 7665 7320 6469 7265  .primitives dire
│ │ │ │ +0001e450: 6374 6c79 2c20 7468 6973 2073 6563 7469  ctly, this secti
│ │ │ │ +0001e460: 6f6e 2064 6573 6372 6962 6573 2074 6865  on describes the
│ │ │ │ +0001e470: 2066 756e 6374 696f 6e73 2061 7661 696c   functions avail
│ │ │ │ +0001e480: 6162 6c65 2e0a 0a20 2020 4d6f 7374 2063  able...   Most c
│ │ │ │ +0001e490: 7279 7074 6f67 7261 7068 6963 206f 7065  ryptographic ope
│ │ │ │ +0001e4a0: 7261 7469 6f6e 7320 6e65 6564 206b 6579  rations need key
│ │ │ │ +0001e4b0: 696e 6720 6d61 7465 7269 616c 2c20 616e  ing material, an
│ │ │ │ +0001e4c0: 6420 6372 7970 746f 6772 6170 6869 630a  d cryptographic.
│ │ │ │ +0001e4d0: 6b65 7973 2068 6176 6520 6265 656e 2069  keys have been i
│ │ │ │ +0001e4e0: 736f 6c61 7465 6420 696e 746f 2069 7427  solated into it'
│ │ │ │ +0001e4f0: 7320 6f77 6e20 6461 7461 2073 7472 7563  s own data struc
│ │ │ │ +0001e500: 7475 7265 20e2 8098 5368 6973 6869 5f6b  ture ...Shishi_k
│ │ │ │ +0001e510: 6579 e280 992e 2020 5468 650a 666f 6c6c  ey....  The.foll
│ │ │ │ +0001e520: 6f77 696e 6720 696c 6c75 7374 7261 7465  owing illustrate
│ │ │ │ +0001e530: 7320 6974 2773 2063 6f6e 7465 6e74 732c  s it's contents,
│ │ │ │ +0001e540: 2062 7574 206e 6f74 6520 7468 6174 2079   but note that y
│ │ │ │ +0001e550: 6f75 2063 616e 6e6f 7420 6163 6365 7373  ou cannot access
│ │ │ │ +0001e560: 0a69 7427 7320 656c 656d 656e 7473 2064  .it's elements d
│ │ │ │ +0001e570: 6972 6563 746c 7920 6275 7420 6d75 7374  irectly but must
│ │ │ │ +0001e580: 2075 7365 2074 6865 2061 6363 6573 736f   use the accesso
│ │ │ │ +0001e590: 7220 6675 6e63 7469 6f6e 7320 6465 7363  r functions desc
│ │ │ │ +0001e5a0: 7269 6265 640a 6265 6c6f 772e 0a0a 7374  ribed.below...st
│ │ │ │ +0001e5b0: 7275 6374 2053 6869 7368 695f 6b65 790a  ruct Shishi_key.
│ │ │ │ +0001e5c0: 7b0a 2020 696e 7420 7479 7065 3b20 2020  {.  int type;   
│ │ │ │ +0001e5d0: 202f 2a20 5246 4320 3135 3130 2065 6e63   /* RFC 1510 enc
│ │ │ │ +0001e5e0: 7279 7074 696f 6e20 696e 7465 6765 7220  ryption integer 
│ │ │ │ +0001e5f0: 7479 7065 202a 2f0a 2020 6368 6172 202a  type */.  char *
│ │ │ │ +0001e600: 7661 6c75 653b 202f 2a20 4372 7970 746f  value; /* Crypto
│ │ │ │ +0001e610: 6772 6170 6869 6320 6b65 7920 6461 7461  graphic key data
│ │ │ │ +0001e620: 202a 2f0a 2020 696e 7420 7665 7273 696f   */.  int versio
│ │ │ │ +0001e630: 6e3b 202f 2a20 5246 4320 3135 3130 2060  n; /* RFC 1510 `
│ │ │ │ +0001e640: 606b 766e 6f27 2720 2a2f 0a7d 3b0a 0a20  `kvno'' */.};.. 
│ │ │ │ +0001e650: 2020 416c 6c20 6675 6e63 7469 6f6e 7320    All functions 
│ │ │ │ +0001e660: 7468 6174 206f 7065 7261 7465 206f 6e20  that operate on 
│ │ │ │ +0001e670: 7468 6973 2064 6174 6120 7374 7275 6374  this data struct
│ │ │ │ +0001e680: 7572 6520 6172 6520 6465 7363 7269 6265  ure are describe
│ │ │ │ +0001e690: 6420 6e6f 772e 0a0a 7368 6973 6869 5f6b  d now...shishi_k
│ │ │ │ +0001e6a0: 6579 5f70 7269 6e63 6970 616c 0a2d 2d2d  ey_principal.---
│ │ │ │  0001e6b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0001e6c0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ -0001e6d0: 636f 6e73 7420 6368 6172 202a 2073 6869  const char * shi
│ │ │ │ -0001e6e0: 7368 695f 6b65 795f 7072 696e 6369 7061  shi_key_principa
│ │ │ │ -0001e6f0: 6c20 2863 6f6e 7374 2053 6869 7368 695f  l (const Shishi_
│ │ │ │ -0001e700: 6b65 7920 2a20 4b45 5929 0a20 2020 2020  key * KEY).     
│ │ │ │ -0001e710: 4b45 593a 2073 7472 7563 7475 7265 2074  KEY: structure t
│ │ │ │ -0001e720: 6861 7420 686f 6c64 7320 6b65 7920 696e  hat holds key in
│ │ │ │ -0001e730: 666f 726d 6174 696f 6e0a 0a20 2020 2020  formation..     
│ │ │ │ -0001e740: 2a44 6573 6372 6970 7469 6f6e 3a2a 2047  *Description:* G
│ │ │ │ -0001e750: 6574 2074 6865 2070 7269 6e63 6970 616c  et the principal
│ │ │ │ -0001e760: 2070 6172 7420 6f66 2074 6865 206b 6579   part of the key
│ │ │ │ -0001e770: 206f 776e 6572 2070 7269 6e63 6970 616c   owner principal
│ │ │ │ -0001e780: 0a20 2020 2020 6e61 6d65 2c20 692e 652e  .     name, i.e.
│ │ │ │ -0001e790: 2c20 6578 6365 7074 2074 6865 2072 6561  , except the rea
│ │ │ │ -0001e7a0: 6c6d 2e0a 0a20 2020 2020 2a52 6574 7572  lm...     *Retur
│ │ │ │ -0001e7b0: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ -0001e7c0: 7320 7468 6520 7072 696e 6369 7061 6c20  s the principal 
│ │ │ │ -0001e7d0: 6f77 6e69 6e67 2074 6865 206b 6579 2e20  owning the key. 
│ │ │ │ -0001e7e0: 2028 4e6f 7420 6120 636f 7079 0a20 2020   (Not a copy.   
│ │ │ │ -0001e7f0: 2020 6f66 2069 742c 2073 6f20 646f 6e27    of it, so don'
│ │ │ │ -0001e800: 7420 6d6f 6469 6679 206f 7220 6465 616c  t modify or deal
│ │ │ │ -0001e810: 6c6f 6361 7465 2069 742e 290a 0a73 6869  locate it.)..shi
│ │ │ │ -0001e820: 7368 695f 6b65 795f 7072 696e 6369 7061  shi_key_principa
│ │ │ │ -0001e830: 6c5f 7365 740a 2d2d 2d2d 2d2d 2d2d 2d2d  l_set.----------
│ │ │ │ -0001e840: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -0001e850: 202d 2d20 4675 6e63 7469 6f6e 3a20 766f   -- Function: vo
│ │ │ │ -0001e860: 6964 2073 6869 7368 695f 6b65 795f 7072  id shishi_key_pr
│ │ │ │ -0001e870: 696e 6369 7061 6c5f 7365 7420 2853 6869  incipal_set (Shi
│ │ │ │ -0001e880: 7368 695f 6b65 7920 2a20 4b45 592c 0a20  shi_key * KEY,. 
│ │ │ │ -0001e890: 2020 2020 2020 2020 2063 6f6e 7374 2063           const c
│ │ │ │ -0001e8a0: 6861 7220 2a20 5052 494e 4349 5041 4c29  har * PRINCIPAL)
│ │ │ │ -0001e8b0: 0a20 2020 2020 4b45 593a 2073 7472 7563  .     KEY: struc
│ │ │ │ -0001e8c0: 7475 7265 2074 6861 7420 686f 6c64 7320  ture that holds 
│ │ │ │ -0001e8d0: 6b65 7920 696e 666f 726d 6174 696f 6e0a  key information.
│ │ │ │ -0001e8e0: 2020 2020 2050 5249 4e43 4950 414c 3a20       PRINCIPAL: 
│ │ │ │ -0001e8f0: 7374 7269 6e67 2077 6974 6820 6e65 7720  string with new 
│ │ │ │ -0001e900: 7072 696e 6369 7061 6c20 6e61 6d65 2e0a  principal name..
│ │ │ │ -0001e910: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -0001e920: 6f6e 3a2a 2053 6574 2074 6865 2070 7269  on:* Set the pri
│ │ │ │ -0001e930: 6e63 6970 616c 206f 776e 696e 6720 7468  ncipal owning th
│ │ │ │ -0001e940: 6520 6b65 792e 2020 5468 6520 7374 7269  e key.  The stri
│ │ │ │ -0001e950: 6e67 2069 730a 2020 2020 2063 6f70 6965  ng is.     copie
│ │ │ │ -0001e960: 6420 696e 746f 2074 6865 206b 6579 2c20  d into the key, 
│ │ │ │ -0001e970: 736f 2079 6f75 2063 616e 2064 6973 706f  so you can dispo
│ │ │ │ -0001e980: 7365 206f 6620 7468 6520 7661 7269 6162  se of the variab
│ │ │ │ -0001e990: 6c65 2069 6d6d 6564 6961 7465 6c79 0a20  le immediately. 
│ │ │ │ -0001e9a0: 2020 2020 6166 7465 7220 6361 6c6c 696e      after callin
│ │ │ │ -0001e9b0: 6720 7468 6973 2066 756e 6374 696f 6e2e  g this function.
│ │ │ │ -0001e9c0: 0a0a 7368 6973 6869 5f6b 6579 5f72 6561  ..shishi_key_rea
│ │ │ │ -0001e9d0: 6c6d 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  lm.-------------
│ │ │ │ -0001e9e0: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ -0001e9f0: 6e3a 2063 6f6e 7374 2063 6861 7220 2a20  n: const char * 
│ │ │ │ -0001ea00: 7368 6973 6869 5f6b 6579 5f72 6561 6c6d  shishi_key_realm
│ │ │ │ -0001ea10: 2028 636f 6e73 7420 5368 6973 6869 5f6b   (const Shishi_k
│ │ │ │ -0001ea20: 6579 202a 204b 4559 290a 2020 2020 204b  ey * KEY).     K
│ │ │ │ -0001ea30: 4559 3a20 7374 7275 6374 7572 6520 7468  EY: structure th
│ │ │ │ -0001ea40: 6174 2068 6f6c 6473 206b 6579 2069 6e66  at holds key inf
│ │ │ │ -0001ea50: 6f72 6d61 7469 6f6e 0a0a 2020 2020 202a  ormation..     *
│ │ │ │ -0001ea60: 4465 7363 7269 7074 696f 6e3a 2a20 4765  Description:* Ge
│ │ │ │ -0001ea70: 7420 7468 6520 7265 616c 6d20 7061 7274  t the realm part
│ │ │ │ -0001ea80: 206f 6620 7468 6520 6b65 7920 6f77 6e65   of the key owne
│ │ │ │ -0001ea90: 7220 7072 696e 6369 7061 6c20 6e61 6d65  r principal name
│ │ │ │ -0001eaa0: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ -0001eab0: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ -0001eac0: 7468 6520 7265 616c 6d20 666f 7220 7468  the realm for th
│ │ │ │ -0001ead0: 6520 7072 696e 6369 7061 6c20 6f77 6e69  e principal owni
│ │ │ │ -0001eae0: 6e67 2074 6865 206b 6579 2e0a 2020 2020  ng the key..    
│ │ │ │ -0001eaf0: 2028 4e6f 7420 6120 636f 7079 206f 6620   (Not a copy of 
│ │ │ │ -0001eb00: 6974 2c20 736f 2064 6f6e 2774 206d 6f64  it, so don't mod
│ │ │ │ -0001eb10: 6966 7920 6f72 2064 6561 6c6c 6f63 6174  ify or deallocat
│ │ │ │ -0001eb20: 6520 6974 2e29 0a0a 7368 6973 6869 5f6b  e it.)..shishi_k
│ │ │ │ -0001eb30: 6579 5f72 6561 6c6d 5f73 6574 0a2d 2d2d  ey_realm_set.---
│ │ │ │ +0001e6c0: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ +0001e6d0: 2063 6f6e 7374 2063 6861 7220 2a20 7368   const char * sh
│ │ │ │ +0001e6e0: 6973 6869 5f6b 6579 5f70 7269 6e63 6970  ishi_key_princip
│ │ │ │ +0001e6f0: 616c 2028 636f 6e73 7420 5368 6973 6869  al (const Shishi
│ │ │ │ +0001e700: 5f6b 6579 202a 204b 4559 290a 2020 2020  _key * KEY).    
│ │ │ │ +0001e710: 204b 4559 3a20 7374 7275 6374 7572 6520   KEY: structure 
│ │ │ │ +0001e720: 7468 6174 2068 6f6c 6473 206b 6579 2069  that holds key i
│ │ │ │ +0001e730: 6e66 6f72 6d61 7469 6f6e 0a0a 2020 2020  nformation..    
│ │ │ │ +0001e740: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ +0001e750: 4765 7420 7468 6520 7072 696e 6369 7061  Get the principa
│ │ │ │ +0001e760: 6c20 7061 7274 206f 6620 7468 6520 6b65  l part of the ke
│ │ │ │ +0001e770: 7920 6f77 6e65 7220 7072 696e 6369 7061  y owner principa
│ │ │ │ +0001e780: 6c0a 2020 2020 206e 616d 652c 2069 2e65  l.     name, i.e
│ │ │ │ +0001e790: 2e2c 2065 7863 6570 7420 7468 6520 7265  ., except the re
│ │ │ │ +0001e7a0: 616c 6d2e 0a0a 2020 2020 202a 5265 7475  alm...     *Retu
│ │ │ │ +0001e7b0: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ +0001e7c0: 6e73 2074 6865 2070 7269 6e63 6970 616c  ns the principal
│ │ │ │ +0001e7d0: 206f 776e 696e 6720 7468 6520 6b65 792e   owning the key.
│ │ │ │ +0001e7e0: 2020 284e 6f74 2061 2063 6f70 790a 2020    (Not a copy.  
│ │ │ │ +0001e7f0: 2020 206f 6620 6974 2c20 736f 2064 6f6e     of it, so don
│ │ │ │ +0001e800: 2774 206d 6f64 6966 7920 6f72 2064 6561  't modify or dea
│ │ │ │ +0001e810: 6c6c 6f63 6174 6520 6974 2e29 0a0a 7368  llocate it.)..sh
│ │ │ │ +0001e820: 6973 6869 5f6b 6579 5f70 7269 6e63 6970  ishi_key_princip
│ │ │ │ +0001e830: 616c 5f73 6574 0a2d 2d2d 2d2d 2d2d 2d2d  al_set.---------
│ │ │ │ +0001e840: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +0001e850: 0a20 2d2d 2046 756e 6374 696f 6e3a 2076  . -- Function: v
│ │ │ │ +0001e860: 6f69 6420 7368 6973 6869 5f6b 6579 5f70  oid shishi_key_p
│ │ │ │ +0001e870: 7269 6e63 6970 616c 5f73 6574 2028 5368  rincipal_set (Sh
│ │ │ │ +0001e880: 6973 6869 5f6b 6579 202a 204b 4559 2c0a  ishi_key * KEY,.
│ │ │ │ +0001e890: 2020 2020 2020 2020 2020 636f 6e73 7420            const 
│ │ │ │ +0001e8a0: 6368 6172 202a 2050 5249 4e43 4950 414c  char * PRINCIPAL
│ │ │ │ +0001e8b0: 290a 2020 2020 204b 4559 3a20 7374 7275  ).     KEY: stru
│ │ │ │ +0001e8c0: 6374 7572 6520 7468 6174 2068 6f6c 6473  cture that holds
│ │ │ │ +0001e8d0: 206b 6579 2069 6e66 6f72 6d61 7469 6f6e   key information
│ │ │ │ +0001e8e0: 0a20 2020 2020 5052 494e 4349 5041 4c3a  .     PRINCIPAL:
│ │ │ │ +0001e8f0: 2073 7472 696e 6720 7769 7468 206e 6577   string with new
│ │ │ │ +0001e900: 2070 7269 6e63 6970 616c 206e 616d 652e   principal name.
│ │ │ │ +0001e910: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ +0001e920: 696f 6e3a 2a20 5365 7420 7468 6520 7072  ion:* Set the pr
│ │ │ │ +0001e930: 696e 6369 7061 6c20 6f77 6e69 6e67 2074  incipal owning t
│ │ │ │ +0001e940: 6865 206b 6579 2e20 2054 6865 2073 7472  he key.  The str
│ │ │ │ +0001e950: 696e 6720 6973 0a20 2020 2020 636f 7069  ing is.     copi
│ │ │ │ +0001e960: 6564 2069 6e74 6f20 7468 6520 6b65 792c  ed into the key,
│ │ │ │ +0001e970: 2073 6f20 796f 7520 6361 6e20 6469 7370   so you can disp
│ │ │ │ +0001e980: 6f73 6520 6f66 2074 6865 2076 6172 6961  ose of the varia
│ │ │ │ +0001e990: 626c 6520 696d 6d65 6469 6174 656c 790a  ble immediately.
│ │ │ │ +0001e9a0: 2020 2020 2061 6674 6572 2063 616c 6c69       after calli
│ │ │ │ +0001e9b0: 6e67 2074 6869 7320 6675 6e63 7469 6f6e  ng this function
│ │ │ │ +0001e9c0: 2e0a 0a73 6869 7368 695f 6b65 795f 7265  ...shishi_key_re
│ │ │ │ +0001e9d0: 616c 6d0a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  alm.------------
│ │ │ │ +0001e9e0: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ +0001e9f0: 6f6e 3a20 636f 6e73 7420 6368 6172 202a  on: const char *
│ │ │ │ +0001ea00: 2073 6869 7368 695f 6b65 795f 7265 616c   shishi_key_real
│ │ │ │ +0001ea10: 6d20 2863 6f6e 7374 2053 6869 7368 695f  m (const Shishi_
│ │ │ │ +0001ea20: 6b65 7920 2a20 4b45 5929 0a20 2020 2020  key * KEY).     
│ │ │ │ +0001ea30: 4b45 593a 2073 7472 7563 7475 7265 2074  KEY: structure t
│ │ │ │ +0001ea40: 6861 7420 686f 6c64 7320 6b65 7920 696e  hat holds key in
│ │ │ │ +0001ea50: 666f 726d 6174 696f 6e0a 0a20 2020 2020  formation..     
│ │ │ │ +0001ea60: 2a44 6573 6372 6970 7469 6f6e 3a2a 2047  *Description:* G
│ │ │ │ +0001ea70: 6574 2074 6865 2072 6561 6c6d 2070 6172  et the realm par
│ │ │ │ +0001ea80: 7420 6f66 2074 6865 206b 6579 206f 776e  t of the key own
│ │ │ │ +0001ea90: 6572 2070 7269 6e63 6970 616c 206e 616d  er principal nam
│ │ │ │ +0001eaa0: 652e 0a0a 2020 2020 202a 5265 7475 726e  e...     *Return
│ │ │ │ +0001eab0: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ +0001eac0: 2074 6865 2072 6561 6c6d 2066 6f72 2074   the realm for t
│ │ │ │ +0001ead0: 6865 2070 7269 6e63 6970 616c 206f 776e  he principal own
│ │ │ │ +0001eae0: 696e 6720 7468 6520 6b65 792e 0a20 2020  ing the key..   
│ │ │ │ +0001eaf0: 2020 284e 6f74 2061 2063 6f70 7920 6f66    (Not a copy of
│ │ │ │ +0001eb00: 2069 742c 2073 6f20 646f 6e27 7420 6d6f   it, so don't mo
│ │ │ │ +0001eb10: 6469 6679 206f 7220 6465 616c 6c6f 6361  dify or dealloca
│ │ │ │ +0001eb20: 7465 2069 742e 290a 0a73 6869 7368 695f  te it.)..shishi_
│ │ │ │ +0001eb30: 6b65 795f 7265 616c 6d5f 7365 740a 2d2d  key_realm_set.--
│ │ │ │  0001eb40: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0001eb50: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ -0001eb60: 2076 6f69 6420 7368 6973 6869 5f6b 6579   void shishi_key
│ │ │ │ -0001eb70: 5f72 6561 6c6d 5f73 6574 2028 5368 6973  _realm_set (Shis
│ │ │ │ -0001eb80: 6869 5f6b 6579 202a 204b 4559 2c0a 2020  hi_key * KEY,.  
│ │ │ │ -0001eb90: 2020 2020 2020 2020 636f 6e73 7420 6368          const ch
│ │ │ │ -0001eba0: 6172 202a 2052 4541 4c4d 290a 2020 2020  ar * REALM).    
│ │ │ │ -0001ebb0: 204b 4559 3a20 7374 7275 6374 7572 6520   KEY: structure 
│ │ │ │ -0001ebc0: 7468 6174 2068 6f6c 6473 206b 6579 2069  that holds key i
│ │ │ │ -0001ebd0: 6e66 6f72 6d61 7469 6f6e 0a20 2020 2020  nformation.     
│ │ │ │ -0001ebe0: 5245 414c 4d3a 2073 7472 696e 6720 7769  REALM: string wi
│ │ │ │ -0001ebf0: 7468 206e 6577 2072 6561 6c6d 206e 616d  th new realm nam
│ │ │ │ -0001ec00: 652e 0a0a 2020 2020 202a 4465 7363 7269  e...     *Descri
│ │ │ │ -0001ec10: 7074 696f 6e3a 2a20 5365 7420 7468 6520  ption:* Set the 
│ │ │ │ -0001ec20: 7265 616c 6d20 666f 7220 7468 6520 7072  realm for the pr
│ │ │ │ -0001ec30: 696e 6369 7061 6c20 6f77 6e69 6e67 2074  incipal owning t
│ │ │ │ -0001ec40: 6865 206b 6579 2e20 2054 6865 0a20 2020  he key.  The.   
│ │ │ │ -0001ec50: 2020 7374 7269 6e67 2069 7320 636f 7069    string is copi
│ │ │ │ -0001ec60: 6564 2069 6e74 6f20 7468 6520 6b65 792c  ed into the key,
│ │ │ │ -0001ec70: 2073 6f20 796f 7520 6361 6e20 6469 7370   so you can disp
│ │ │ │ -0001ec80: 6f73 6520 6f66 2074 6865 2076 6172 6961  ose of the varia
│ │ │ │ -0001ec90: 626c 650a 2020 2020 2069 6d6d 6564 6961  ble.     immedia
│ │ │ │ -0001eca0: 7465 6c79 2061 6674 6572 2063 616c 6c69  tely after calli
│ │ │ │ -0001ecb0: 6e67 2074 6869 7320 6675 6e63 7469 6f6e  ng this function
│ │ │ │ -0001ecc0: 2e0a 0a73 6869 7368 695f 6b65 795f 7479  ...shishi_key_ty
│ │ │ │ -0001ecd0: 7065 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  pe.-------------
│ │ │ │ -0001ece0: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ -0001ecf0: 3a20 696e 7420 7368 6973 6869 5f6b 6579  : int shishi_key
│ │ │ │ -0001ed00: 5f74 7970 6520 2863 6f6e 7374 2053 6869  _type (const Shi
│ │ │ │ -0001ed10: 7368 695f 6b65 7920 2a20 4b45 5929 0a20  shi_key * KEY). 
│ │ │ │ -0001ed20: 2020 2020 4b45 593a 2073 7472 7563 7475      KEY: structu
│ │ │ │ -0001ed30: 7265 2074 6861 7420 686f 6c64 7320 6b65  re that holds ke
│ │ │ │ -0001ed40: 7920 696e 666f 726d 6174 696f 6e0a 0a20  y information.. 
│ │ │ │ -0001ed50: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -0001ed60: 3a2a 2047 6574 206b 6579 2074 7970 652e  :* Get key type.
│ │ │ │ -0001ed70: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ -0001ed80: 616c 7565 3a2a 2052 6574 7572 6e73 2074  alue:* Returns t
│ │ │ │ -0001ed90: 6865 2074 7970 6520 6f66 206b 6579 2061  he type of key a
│ │ │ │ -0001eda0: 7320 616e 2069 6e74 6567 6572 2061 7320  s an integer as 
│ │ │ │ -0001edb0: 6465 7363 7269 6265 640a 2020 2020 2069  described.     i
│ │ │ │ -0001edc0: 6e20 7468 6520 7374 616e 6461 7264 2e0a  n the standard..
│ │ │ │ -0001edd0: 0a73 6869 7368 695f 6b65 795f 7479 7065  .shishi_key_type
│ │ │ │ -0001ede0: 5f73 6574 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  _set.-----------
│ │ │ │ -0001edf0: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -0001ee00: 6e63 7469 6f6e 3a20 766f 6964 2073 6869  nction: void shi
│ │ │ │ -0001ee10: 7368 695f 6b65 795f 7479 7065 5f73 6574  shi_key_type_set
│ │ │ │ -0001ee20: 2028 5368 6973 6869 5f6b 6579 202a 204b   (Shishi_key * K
│ │ │ │ -0001ee30: 4559 2c20 696e 7433 325f 7420 5459 5045  EY, int32_t TYPE
│ │ │ │ -0001ee40: 290a 2020 2020 204b 4559 3a20 7374 7275  ).     KEY: stru
│ │ │ │ -0001ee50: 6374 7572 6520 7468 6174 2068 6f6c 6473  cture that holds
│ │ │ │ -0001ee60: 206b 6579 2069 6e66 6f72 6d61 7469 6f6e   key information
│ │ │ │ -0001ee70: 0a20 2020 2020 5459 5045 3a20 7479 7065  .     TYPE: type
│ │ │ │ -0001ee80: 2074 6f20 7365 7420 696e 206b 6579 2e0a   to set in key..
│ │ │ │ -0001ee90: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -0001eea0: 6f6e 3a2a 2053 6574 2074 6865 2074 7970  on:* Set the typ
│ │ │ │ -0001eeb0: 6520 6f66 206b 6579 2069 6e20 6b65 7920  e of key in key 
│ │ │ │ -0001eec0: 7374 7275 6374 7572 652e 0a0a 7368 6973  structure...shis
│ │ │ │ -0001eed0: 6869 5f6b 6579 5f76 616c 7565 0a2d 2d2d  hi_key_value.---
│ │ │ │ -0001eee0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -0001eef0: 2d2d 2046 756e 6374 696f 6e3a 2063 6f6e  -- Function: con
│ │ │ │ -0001ef00: 7374 2063 6861 7220 2a20 7368 6973 6869  st char * shishi
│ │ │ │ -0001ef10: 5f6b 6579 5f76 616c 7565 2028 636f 6e73  _key_value (cons
│ │ │ │ -0001ef20: 7420 5368 6973 6869 5f6b 6579 202a 204b  t Shishi_key * K
│ │ │ │ -0001ef30: 4559 290a 2020 2020 204b 4559 3a20 7374  EY).     KEY: st
│ │ │ │ -0001ef40: 7275 6374 7572 6520 7468 6174 2068 6f6c  ructure that hol
│ │ │ │ -0001ef50: 6473 206b 6579 2069 6e66 6f72 6d61 7469  ds key informati
│ │ │ │ -0001ef60: 6f6e 0a0a 2020 2020 202a 4465 7363 7269  on..     *Descri
│ │ │ │ -0001ef70: 7074 696f 6e3a 2a20 4765 7420 7468 6520  ption:* Get the 
│ │ │ │ -0001ef80: 7261 7720 6b65 7920 6279 7465 732e 0a0a  raw key bytes...
│ │ │ │ -0001ef90: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ -0001efa0: 7565 3a2a 2052 6574 7572 6e73 2074 6865  ue:* Returns the
│ │ │ │ -0001efb0: 206b 6579 2076 616c 7565 2061 7320 6120   key value as a 
│ │ │ │ -0001efc0: 706f 696e 7465 7220 7768 6963 6820 6973  pointer which is
│ │ │ │ -0001efd0: 2076 616c 6964 0a20 2020 2020 7468 726f   valid.     thro
│ │ │ │ -0001efe0: 7567 686f 7574 2074 6865 206c 6966 6574  ughout the lifet
│ │ │ │ -0001eff0: 696d 6520 6f66 2074 6865 206b 6579 2073  ime of the key s
│ │ │ │ -0001f000: 7472 7563 7475 7265 2e0a 0a73 6869 7368  tructure...shish
│ │ │ │ -0001f010: 695f 6b65 795f 7661 6c75 655f 7365 740a  i_key_value_set.
│ │ │ │ -0001f020: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0001f030: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -0001f040: 6f6e 3a20 766f 6964 2073 6869 7368 695f  on: void shishi_
│ │ │ │ -0001f050: 6b65 795f 7661 6c75 655f 7365 7420 2853  key_value_set (S
│ │ │ │ -0001f060: 6869 7368 695f 6b65 7920 2a20 4b45 592c  hishi_key * KEY,
│ │ │ │ -0001f070: 0a20 2020 2020 2020 2020 2063 6f6e 7374  .          const
│ │ │ │ -0001f080: 2063 6861 7220 2a20 5641 4c55 4529 0a20   char * VALUE). 
│ │ │ │ -0001f090: 2020 2020 4b45 593a 2073 7472 7563 7475      KEY: structu
│ │ │ │ -0001f0a0: 7265 2074 6861 7420 686f 6c64 7320 6b65  re that holds ke
│ │ │ │ -0001f0b0: 7920 696e 666f 726d 6174 696f 6e0a 2020  y information.  
│ │ │ │ -0001f0c0: 2020 2056 414c 5545 3a20 696e 7075 7420     VALUE: input 
│ │ │ │ -0001f0d0: 6172 7261 7920 7769 7468 206b 6579 2064  array with key d
│ │ │ │ -0001f0e0: 6174 612e 0a0a 2020 2020 202a 4465 7363  ata...     *Desc
│ │ │ │ -0001f0f0: 7269 7074 696f 6e3a 2a20 5365 7420 7468  ription:* Set th
│ │ │ │ -0001f100: 6520 6b65 7920 7661 6c75 6520 616e 6420  e key value and 
│ │ │ │ -0001f110: 6c65 6e67 7468 2069 6e20 6b65 7920 7374  length in key st
│ │ │ │ -0001f120: 7275 6374 7572 652e 2020 5468 650a 2020  ructure.  The.  
│ │ │ │ -0001f130: 2020 2076 616c 7565 2069 7320 636f 7069     value is copi
│ │ │ │ -0001f140: 6564 2069 6e74 6f20 7468 6520 6b65 7920  ed into the key 
│ │ │ │ -0001f150: 2869 6e20 6f74 6865 7220 776f 7264 732c  (in other words,
│ │ │ │ -0001f160: 2079 6f75 2063 616e 2064 6561 6c6c 6f63   you can dealloc
│ │ │ │ -0001f170: 6174 650a 2020 2020 2056 414c 5545 2072  ate.     VALUE r
│ │ │ │ -0001f180: 6967 6874 2061 6674 6572 2063 616c 6c69  ight after calli
│ │ │ │ -0001f190: 6e67 2074 6869 7320 6675 6e63 7469 6f6e  ng this function
│ │ │ │ -0001f1a0: 2077 6974 686f 7574 206d 6f64 6966 7969   without modifyi
│ │ │ │ -0001f1b0: 6e67 2074 6865 2076 616c 7565 0a20 2020  ng the value.   
│ │ │ │ -0001f1c0: 2020 696e 7369 6465 2074 6865 206b 6579    inside the key
│ │ │ │ -0001f1d0: 292e 0a0a 7368 6973 6869 5f6b 6579 5f76  )...shishi_key_v
│ │ │ │ -0001f1e0: 6572 7369 6f6e 0a2d 2d2d 2d2d 2d2d 2d2d  ersion.---------
│ │ │ │ -0001f1f0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ -0001f200: 756e 6374 696f 6e3a 2075 696e 7433 325f  unction: uint32_
│ │ │ │ -0001f210: 7420 7368 6973 6869 5f6b 6579 5f76 6572  t shishi_key_ver
│ │ │ │ -0001f220: 7369 6f6e 2028 636f 6e73 7420 5368 6973  sion (const Shis
│ │ │ │ -0001f230: 6869 5f6b 6579 202a 204b 4559 290a 2020  hi_key * KEY).  
│ │ │ │ -0001f240: 2020 204b 4559 3a20 7374 7275 6374 7572     KEY: structur
│ │ │ │ -0001f250: 6520 7468 6174 2068 6f6c 6473 206b 6579  e that holds key
│ │ │ │ -0001f260: 2069 6e66 6f72 6d61 7469 6f6e 0a0a 2020   information..  
│ │ │ │ -0001f270: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ -0001f280: 2a20 4765 7420 7468 6520 226b 766e 6f22  * Get the "kvno"
│ │ │ │ -0001f290: 2028 6b65 7920 7665 7273 696f 6e29 206f   (key version) o
│ │ │ │ -0001f2a0: 6620 6b65 792e 2020 4974 2077 696c 6c20  f key.  It will 
│ │ │ │ -0001f2b0: 6265 0a20 2020 2020 5549 4e54 3332 5f4d  be.     UINT32_M
│ │ │ │ -0001f2c0: 4158 2069 6620 7468 6520 6b65 7920 6973  AX if the key is
│ │ │ │ -0001f2d0: 206e 6f74 206c 6f6e 672d 6c69 7665 642e   not long-lived.
│ │ │ │ -0001f2e0: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ -0001f2f0: 616c 7565 3a2a 2052 6574 7572 6e73 2074  alue:* Returns t
│ │ │ │ -0001f300: 6865 2076 6572 7369 6f6e 206f 6620 6b65  he version of ke
│ │ │ │ -0001f310: 7920 2822 6b76 6e6f 2229 2e0a 0a73 6869  y ("kvno")...shi
│ │ │ │ -0001f320: 7368 695f 6b65 795f 7665 7273 696f 6e5f  shi_key_version_
│ │ │ │ -0001f330: 7365 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  set.------------
│ │ │ │ -0001f340: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ -0001f350: 4675 6e63 7469 6f6e 3a20 766f 6964 2073  Function: void s
│ │ │ │ -0001f360: 6869 7368 695f 6b65 795f 7665 7273 696f  hishi_key_versio
│ │ │ │ -0001f370: 6e5f 7365 7420 2853 6869 7368 695f 6b65  n_set (Shishi_ke
│ │ │ │ -0001f380: 7920 2a20 4b45 592c 0a20 2020 2020 2020  y * KEY,.       
│ │ │ │ -0001f390: 2020 2075 696e 7433 325f 7420 4b56 4e4f     uint32_t KVNO
│ │ │ │ -0001f3a0: 290a 2020 2020 204b 4559 3a20 7374 7275  ).     KEY: stru
│ │ │ │ -0001f3b0: 6374 7572 6520 7468 6174 2068 6f6c 6473  cture that holds
│ │ │ │ -0001f3c0: 206b 6579 2069 6e66 6f72 6d61 7469 6f6e   key information
│ │ │ │ -0001f3d0: 0a20 2020 2020 4b56 4e4f 3a20 6e65 7720  .     KVNO: new 
│ │ │ │ -0001f3e0: 7665 7273 696f 6e20 696e 7465 6765 722e  version integer.
│ │ │ │ -0001f3f0: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ -0001f400: 696f 6e3a 2a20 5365 7420 7468 6520 7665  ion:* Set the ve
│ │ │ │ -0001f410: 7273 696f 6e20 6f66 206b 6579 2028 226b  rsion of key ("k
│ │ │ │ -0001f420: 766e 6f22 2920 696e 206b 6579 2073 7472  vno") in key str
│ │ │ │ -0001f430: 7563 7475 7265 2e0a 2020 2020 2055 7365  ucture..     Use
│ │ │ │ -0001f440: 2055 494e 5433 325f 4d41 5820 666f 7220   UINT32_MAX for 
│ │ │ │ -0001f450: 6e6f 6e2d 7074 6572 6d61 6e65 6e74 206b  non-ptermanent k
│ │ │ │ -0001f460: 6579 732e 0a0a 7368 6973 6869 5f6b 6579  eys...shishi_key
│ │ │ │ -0001f470: 5f74 696d 6573 7461 6d70 0a2d 2d2d 2d2d  _timestamp.-----
│ │ │ │ -0001f480: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -0001f490: 0a20 2d2d 2046 756e 6374 696f 6e3a 2074  . -- Function: t
│ │ │ │ -0001f4a0: 696d 655f 7420 7368 6973 6869 5f6b 6579  ime_t shishi_key
│ │ │ │ -0001f4b0: 5f74 696d 6573 7461 6d70 2028 636f 6e73  _timestamp (cons
│ │ │ │ -0001f4c0: 7420 5368 6973 6869 5f6b 6579 202a 204b  t Shishi_key * K
│ │ │ │ -0001f4d0: 4559 290a 2020 2020 204b 4559 3a20 7374  EY).     KEY: st
│ │ │ │ -0001f4e0: 7275 6374 7572 6520 7468 6174 2068 6f6c  ructure that hol
│ │ │ │ -0001f4f0: 6473 206b 6579 2069 6e66 6f72 6d61 7469  ds key informati
│ │ │ │ -0001f500: 6f6e 0a0a 2020 2020 202a 4465 7363 7269  on..     *Descri
│ │ │ │ -0001f510: 7074 696f 6e3a 2a20 4765 7420 7468 6520  ption:* Get the 
│ │ │ │ -0001f520: 7469 6d65 2074 6865 206b 6579 2077 6173  time the key was
│ │ │ │ -0001f530: 2065 7374 6162 6c69 7368 6564 2e20 2054   established.  T
│ │ │ │ -0001f540: 7970 6963 616c 6c79 0a20 2020 2020 6f6e  ypically.     on
│ │ │ │ -0001f550: 6c79 2070 7265 7365 6e74 2077 6865 6e20  ly present when 
│ │ │ │ -0001f560: 7468 6520 6b65 7920 7761 7320 696d 706f  the key was impo
│ │ │ │ -0001f570: 7274 6564 2066 726f 6d20 6120 6b65 7974  rted from a keyt
│ │ │ │ -0001f580: 6162 2066 6f72 6d61 742e 0a0a 2020 2020  ab format...    
│ │ │ │ -0001f590: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ -0001f5a0: 2052 6574 7572 6e73 2074 6865 2074 696d   Returns the tim
│ │ │ │ -0001f5b0: 6520 7468 6520 6b65 7920 7761 7320 6573  e the key was es
│ │ │ │ -0001f5c0: 7461 626c 6973 6865 642c 206f 720a 2020  tablished, or.  
│ │ │ │ -0001f5d0: 2020 2028 7469 6d65 5f74 292d 3120 6966     (time_t)-1 if
│ │ │ │ -0001f5e0: 206e 6f74 2061 7661 696c 6162 6c65 2e0a   not available..
│ │ │ │ -0001f5f0: 0a20 2020 2020 2a53 696e 6365 3a2a 2030  .     *Since:* 0
│ │ │ │ -0001f600: 2e30 2e34 320a 0a73 6869 7368 695f 6b65  .0.42..shishi_ke
│ │ │ │ -0001f610: 795f 7469 6d65 7374 616d 705f 7365 740a  y_timestamp_set.
│ │ │ │ -0001f620: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0001f630: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -0001f640: 6e63 7469 6f6e 3a20 766f 6964 2073 6869  nction: void shi
│ │ │ │ -0001f650: 7368 695f 6b65 795f 7469 6d65 7374 616d  shi_key_timestam
│ │ │ │ -0001f660: 705f 7365 7420 2853 6869 7368 695f 6b65  p_set (Shishi_ke
│ │ │ │ -0001f670: 7920 2a20 4b45 592c 0a20 2020 2020 2020  y * KEY,.       
│ │ │ │ -0001f680: 2020 2074 696d 655f 7420 5449 4d45 5354     time_t TIMEST
│ │ │ │ -0001f690: 414d 5029 0a20 2020 2020 4b45 593a 2073  AMP).     KEY: s
│ │ │ │ -0001f6a0: 7472 7563 7475 7265 2074 6861 7420 686f  tructure that ho
│ │ │ │ -0001f6b0: 6c64 7320 6b65 7920 696e 666f 726d 6174  lds key informat
│ │ │ │ -0001f6c0: 696f 6e0a 2020 2020 2054 494d 4553 5441  ion.     TIMESTA
│ │ │ │ -0001f6d0: 4d50 3a20 6e65 7720 7469 6d65 7374 616d  MP: new timestam
│ │ │ │ -0001f6e0: 702e 0a0a 2020 2020 202a 4465 7363 7269  p...     *Descri
│ │ │ │ -0001f6f0: 7074 696f 6e3a 2a20 5365 7420 7468 6520  ption:* Set the 
│ │ │ │ -0001f700: 7469 6d65 2074 6865 206b 6579 2077 6173  time the key was
│ │ │ │ -0001f710: 2065 7374 6162 6c69 7368 6564 2e20 2054   established.  T
│ │ │ │ -0001f720: 7970 6963 616c 6c79 0a20 2020 2020 6f6e  ypically.     on
│ │ │ │ -0001f730: 6c79 2072 656c 6576 616e 7420 7768 656e  ly relevant when
│ │ │ │ -0001f740: 2065 7870 6f72 7469 6e67 2074 6865 206b   exporting the k
│ │ │ │ -0001f750: 6579 2074 6f20 6b65 7974 6162 2066 6f72  ey to keytab for
│ │ │ │ -0001f760: 6d61 742e 0a0a 2020 2020 202a 5369 6e63  mat...     *Sinc
│ │ │ │ -0001f770: 653a 2a20 302e 302e 3432 0a0a 7368 6973  e:* 0.0.42..shis
│ │ │ │ -0001f780: 6869 5f6b 6579 5f6e 616d 650a 2d2d 2d2d  hi_key_name.----
│ │ │ │ -0001f790: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ -0001f7a0: 2046 756e 6374 696f 6e3a 2063 6f6e 7374   Function: const
│ │ │ │ -0001f7b0: 2063 6861 7220 2a20 7368 6973 6869 5f6b   char * shishi_k
│ │ │ │ -0001f7c0: 6579 5f6e 616d 6520 2853 6869 7368 695f  ey_name (Shishi_
│ │ │ │ -0001f7d0: 6b65 7920 2a20 4b45 5929 0a20 2020 2020  key * KEY).     
│ │ │ │ -0001f7e0: 4b45 593a 2073 7472 7563 7475 7265 2074  KEY: structure t
│ │ │ │ -0001f7f0: 6861 7420 686f 6c64 7320 6b65 7920 696e  hat holds key in
│ │ │ │ -0001f800: 666f 726d 6174 696f 6e0a 0a20 2020 2020  formation..     
│ │ │ │ -0001f810: 2a44 6573 6372 6970 7469 6f6e 3a2a 2043  *Description:* C
│ │ │ │ -0001f820: 616c 6c73 2073 6869 7368 695f 6369 7068  alls shishi_ciph
│ │ │ │ -0001f830: 6572 5f6e 616d 6520 666f 7220 6b65 7920  er_name for key 
│ │ │ │ -0001f840: 7479 7065 2e0a 0a20 2020 2020 2a52 6574  type...     *Ret
│ │ │ │ -0001f850: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ -0001f860: 726e 206e 616d 6520 6f66 206b 6579 2e0a  rn name of key..
│ │ │ │ -0001f870: 0a73 6869 7368 695f 6b65 795f 6c65 6e67  .shishi_key_leng
│ │ │ │ -0001f880: 7468 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  th.-------------
│ │ │ │ -0001f890: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -0001f8a0: 6f6e 3a20 7369 7a65 5f74 2073 6869 7368  on: size_t shish
│ │ │ │ -0001f8b0: 695f 6b65 795f 6c65 6e67 7468 2028 636f  i_key_length (co
│ │ │ │ -0001f8c0: 6e73 7420 5368 6973 6869 5f6b 6579 202a  nst Shishi_key *
│ │ │ │ -0001f8d0: 204b 4559 290a 2020 2020 204b 4559 3a20   KEY).     KEY: 
│ │ │ │ -0001f8e0: 7374 7275 6374 7572 6520 7468 6174 2068  structure that h
│ │ │ │ -0001f8f0: 6f6c 6473 206b 6579 2069 6e66 6f72 6d61  olds key informa
│ │ │ │ -0001f900: 7469 6f6e 0a0a 2020 2020 202a 4465 7363  tion..     *Desc
│ │ │ │ -0001f910: 7269 7074 696f 6e3a 2a20 4361 6c6c 7320  ription:* Calls 
│ │ │ │ -0001f920: 7368 6973 6869 5f63 6970 6865 725f 6b65  shishi_cipher_ke
│ │ │ │ -0001f930: 796c 656e 2066 6f72 206b 6579 2074 7970  ylen for key typ
│ │ │ │ -0001f940: 652e 0a0a 2020 2020 202a 5265 7475 726e  e...     *Return
│ │ │ │ -0001f950: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ -0001f960: 2074 6865 206c 656e 6774 6820 6f66 2074   the length of t
│ │ │ │ -0001f970: 6865 206b 6579 2076 616c 7565 2e0a 0a73  he key value...s
│ │ │ │ -0001f980: 6869 7368 695f 6b65 790a 2d2d 2d2d 2d2d  hishi_key.------
│ │ │ │ -0001f990: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -0001f9a0: 6f6e 3a20 696e 7420 7368 6973 6869 5f6b  on: int shishi_k
│ │ │ │ -0001f9b0: 6579 2028 5368 6973 6869 202a 2048 414e  ey (Shishi * HAN
│ │ │ │ -0001f9c0: 444c 452c 2053 6869 7368 695f 6b65 7920  DLE, Shishi_key 
│ │ │ │ -0001f9d0: 2a2a 204b 4559 290a 2020 2020 2048 414e  ** KEY).     HAN
│ │ │ │ -0001f9e0: 444c 453a 2053 6869 7368 6920 6c69 6272  DLE: Shishi libr
│ │ │ │ -0001f9f0: 6172 7920 6861 6e64 6c65 2063 7265 6174  ary handle creat
│ │ │ │ -0001fa00: 6520 6279 20e2 8098 7368 6973 6869 5f69  e by ...shishi_i
│ │ │ │ -0001fa10: 6e69 7428 29e2 8099 2e0a 2020 2020 204b  nit().....     K
│ │ │ │ -0001fa20: 4559 3a20 706f 696e 7465 7220 746f 2073  EY: pointer to s
│ │ │ │ -0001fa30: 7472 7563 7475 7265 2074 6861 7420 7769  tructure that wi
│ │ │ │ -0001fa40: 6c6c 2068 6f6c 6420 6e65 776c 7920 6372  ll hold newly cr
│ │ │ │ -0001fa50: 6561 7465 6420 6b65 790a 2020 2020 2069  eated key.     i
│ │ │ │ -0001fa60: 6e66 6f72 6d61 7469 6f6e 0a0a 2020 2020  nformation..    
│ │ │ │ -0001fa70: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ -0001fa80: 4372 6561 7465 2061 206e 6577 204b 6579  Create a new Key
│ │ │ │ -0001fa90: 2069 6e66 6f72 6d61 7469 6f6e 2073 7472   information str
│ │ │ │ -0001faa0: 7563 7475 7265 2e0a 0a20 2020 2020 2a52  ucture...     *R
│ │ │ │ -0001fab0: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ -0001fac0: 7475 726e 7320 5348 4953 4849 5f4f 4b20  turns SHISHI_OK 
│ │ │ │ -0001fad0: 6966 6620 7375 6363 6573 7366 756c 2e0a  iff successful..
│ │ │ │ -0001fae0: 0a73 6869 7368 695f 6b65 795f 646f 6e65  .shishi_key_done
│ │ │ │ -0001faf0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ -0001fb00: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ -0001fb10: 766f 6964 2073 6869 7368 695f 6b65 795f  void shishi_key_
│ │ │ │ -0001fb20: 646f 6e65 2028 5368 6973 6869 5f6b 6579  done (Shishi_key
│ │ │ │ -0001fb30: 202a 204b 4559 290a 2020 2020 204b 4559   * KEY).     KEY
│ │ │ │ -0001fb40: 3a20 706f 696e 7465 7220 746f 2073 7472  : pointer to str
│ │ │ │ -0001fb50: 7563 7475 7265 2074 6861 7420 686f 6c64  ucture that hold
│ │ │ │ -0001fb60: 7320 6b65 7920 696e 666f 726d 6174 696f  s key informatio
│ │ │ │ -0001fb70: 6e2e 0a0a 2020 2020 202a 4465 7363 7269  n...     *Descri
│ │ │ │ -0001fb80: 7074 696f 6e3a 2a20 4465 616c 6c6f 6361  ption:* Dealloca
│ │ │ │ -0001fb90: 7465 7320 6b65 7920 696e 666f 726d 6174  tes key informat
│ │ │ │ -0001fba0: 696f 6e20 7374 7275 6374 7572 652e 0a0a  ion structure...
│ │ │ │ -0001fbb0: 7368 6973 6869 5f6b 6579 5f63 6f70 790a  shishi_key_copy.
│ │ │ │ -0001fbc0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -0001fbd0: 0a20 2d2d 2046 756e 6374 696f 6e3a 2076  . -- Function: v
│ │ │ │ -0001fbe0: 6f69 6420 7368 6973 6869 5f6b 6579 5f63  oid shishi_key_c
│ │ │ │ -0001fbf0: 6f70 7920 2853 6869 7368 695f 6b65 7920  opy (Shishi_key 
│ │ │ │ -0001fc00: 2a20 4453 544b 4559 2c0a 2020 2020 2020  * DSTKEY,.      
│ │ │ │ -0001fc10: 2020 2020 5368 6973 6869 5f6b 6579 202a      Shishi_key *
│ │ │ │ -0001fc20: 2053 5243 4b45 5929 0a20 2020 2020 4453   SRCKEY).     DS
│ │ │ │ -0001fc30: 544b 4559 3a20 7374 7275 6374 7572 6520  TKEY: structure 
│ │ │ │ -0001fc40: 7468 6174 2068 6f6c 6473 2064 6573 7469  that holds desti
│ │ │ │ -0001fc50: 6e61 7469 6f6e 206b 6579 2069 6e66 6f72  nation key infor
│ │ │ │ -0001fc60: 6d61 7469 6f6e 0a20 2020 2020 5352 434b  mation.     SRCK
│ │ │ │ -0001fc70: 4559 3a20 7374 7275 6374 7572 6520 7468  EY: structure th
│ │ │ │ -0001fc80: 6174 2068 6f6c 6473 2073 6f75 7263 6520  at holds source 
│ │ │ │ -0001fc90: 6b65 7920 696e 666f 726d 6174 696f 6e0a  key information.
│ │ │ │ -0001fca0: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -0001fcb0: 6f6e 3a2a 2043 6f70 6965 7320 736f 7572  on:* Copies sour
│ │ │ │ -0001fcc0: 6365 206b 6579 2069 6e74 6f20 6578 6973  ce key into exis
│ │ │ │ -0001fcd0: 7469 6e67 2061 6c6c 6f63 6174 6564 0a20  ting allocated. 
│ │ │ │ -0001fce0: 2020 2020 6465 7374 696e 6174 696f 6e20      destination 
│ │ │ │ -0001fcf0: 6b65 792e 0a0a 7368 6973 6869 5f6b 6579  key...shishi_key
│ │ │ │ -0001fd00: 5f66 726f 6d5f 7661 6c75 650a 2d2d 2d2d  _from_value.----
│ │ │ │ +0001eb50: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ +0001eb60: 3a20 766f 6964 2073 6869 7368 695f 6b65  : void shishi_ke
│ │ │ │ +0001eb70: 795f 7265 616c 6d5f 7365 7420 2853 6869  y_realm_set (Shi
│ │ │ │ +0001eb80: 7368 695f 6b65 7920 2a20 4b45 592c 0a20  shi_key * KEY,. 
│ │ │ │ +0001eb90: 2020 2020 2020 2020 2063 6f6e 7374 2063           const c
│ │ │ │ +0001eba0: 6861 7220 2a20 5245 414c 4d29 0a20 2020  har * REALM).   
│ │ │ │ +0001ebb0: 2020 4b45 593a 2073 7472 7563 7475 7265    KEY: structure
│ │ │ │ +0001ebc0: 2074 6861 7420 686f 6c64 7320 6b65 7920   that holds key 
│ │ │ │ +0001ebd0: 696e 666f 726d 6174 696f 6e0a 2020 2020  information.    
│ │ │ │ +0001ebe0: 2052 4541 4c4d 3a20 7374 7269 6e67 2077   REALM: string w
│ │ │ │ +0001ebf0: 6974 6820 6e65 7720 7265 616c 6d20 6e61  ith new realm na
│ │ │ │ +0001ec00: 6d65 2e0a 0a20 2020 2020 2a44 6573 6372  me...     *Descr
│ │ │ │ +0001ec10: 6970 7469 6f6e 3a2a 2053 6574 2074 6865  iption:* Set the
│ │ │ │ +0001ec20: 2072 6561 6c6d 2066 6f72 2074 6865 2070   realm for the p
│ │ │ │ +0001ec30: 7269 6e63 6970 616c 206f 776e 696e 6720  rincipal owning 
│ │ │ │ +0001ec40: 7468 6520 6b65 792e 2020 5468 650a 2020  the key.  The.  
│ │ │ │ +0001ec50: 2020 2073 7472 696e 6720 6973 2063 6f70     string is cop
│ │ │ │ +0001ec60: 6965 6420 696e 746f 2074 6865 206b 6579  ied into the key
│ │ │ │ +0001ec70: 2c20 736f 2079 6f75 2063 616e 2064 6973  , so you can dis
│ │ │ │ +0001ec80: 706f 7365 206f 6620 7468 6520 7661 7269  pose of the vari
│ │ │ │ +0001ec90: 6162 6c65 0a20 2020 2020 696d 6d65 6469  able.     immedi
│ │ │ │ +0001eca0: 6174 656c 7920 6166 7465 7220 6361 6c6c  ately after call
│ │ │ │ +0001ecb0: 696e 6720 7468 6973 2066 756e 6374 696f  ing this functio
│ │ │ │ +0001ecc0: 6e2e 0a0a 7368 6973 6869 5f6b 6579 5f74  n...shishi_key_t
│ │ │ │ +0001ecd0: 7970 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ype.------------
│ │ │ │ +0001ece0: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ +0001ecf0: 6e3a 2069 6e74 2073 6869 7368 695f 6b65  n: int shishi_ke
│ │ │ │ +0001ed00: 795f 7479 7065 2028 636f 6e73 7420 5368  y_type (const Sh
│ │ │ │ +0001ed10: 6973 6869 5f6b 6579 202a 204b 4559 290a  ishi_key * KEY).
│ │ │ │ +0001ed20: 2020 2020 204b 4559 3a20 7374 7275 6374       KEY: struct
│ │ │ │ +0001ed30: 7572 6520 7468 6174 2068 6f6c 6473 206b  ure that holds k
│ │ │ │ +0001ed40: 6579 2069 6e66 6f72 6d61 7469 6f6e 0a0a  ey information..
│ │ │ │ +0001ed50: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ +0001ed60: 6e3a 2a20 4765 7420 6b65 7920 7479 7065  n:* Get key type
│ │ │ │ +0001ed70: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ +0001ed80: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ +0001ed90: 7468 6520 7479 7065 206f 6620 6b65 7920  the type of key 
│ │ │ │ +0001eda0: 6173 2061 6e20 696e 7465 6765 7220 6173  as an integer as
│ │ │ │ +0001edb0: 2064 6573 6372 6962 6564 0a20 2020 2020   described.     
│ │ │ │ +0001edc0: 696e 2074 6865 2073 7461 6e64 6172 642e  in the standard.
│ │ │ │ +0001edd0: 0a0a 7368 6973 6869 5f6b 6579 5f74 7970  ..shishi_key_typ
│ │ │ │ +0001ede0: 655f 7365 740a 2d2d 2d2d 2d2d 2d2d 2d2d  e_set.----------
│ │ │ │ +0001edf0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +0001ee00: 756e 6374 696f 6e3a 2076 6f69 6420 7368  unction: void sh
│ │ │ │ +0001ee10: 6973 6869 5f6b 6579 5f74 7970 655f 7365  ishi_key_type_se
│ │ │ │ +0001ee20: 7420 2853 6869 7368 695f 6b65 7920 2a20  t (Shishi_key * 
│ │ │ │ +0001ee30: 4b45 592c 2069 6e74 3332 5f74 2054 5950  KEY, int32_t TYP
│ │ │ │ +0001ee40: 4529 0a20 2020 2020 4b45 593a 2073 7472  E).     KEY: str
│ │ │ │ +0001ee50: 7563 7475 7265 2074 6861 7420 686f 6c64  ucture that hold
│ │ │ │ +0001ee60: 7320 6b65 7920 696e 666f 726d 6174 696f  s key informatio
│ │ │ │ +0001ee70: 6e0a 2020 2020 2054 5950 453a 2074 7970  n.     TYPE: typ
│ │ │ │ +0001ee80: 6520 746f 2073 6574 2069 6e20 6b65 792e  e to set in key.
│ │ │ │ +0001ee90: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ +0001eea0: 696f 6e3a 2a20 5365 7420 7468 6520 7479  ion:* Set the ty
│ │ │ │ +0001eeb0: 7065 206f 6620 6b65 7920 696e 206b 6579  pe of key in key
│ │ │ │ +0001eec0: 2073 7472 7563 7475 7265 2e0a 0a73 6869   structure...shi
│ │ │ │ +0001eed0: 7368 695f 6b65 795f 7661 6c75 650a 2d2d  shi_key_value.--
│ │ │ │ +0001eee0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ +0001eef0: 202d 2d20 4675 6e63 7469 6f6e 3a20 636f   -- Function: co
│ │ │ │ +0001ef00: 6e73 7420 6368 6172 202a 2073 6869 7368  nst char * shish
│ │ │ │ +0001ef10: 695f 6b65 795f 7661 6c75 6520 2863 6f6e  i_key_value (con
│ │ │ │ +0001ef20: 7374 2053 6869 7368 695f 6b65 7920 2a20  st Shishi_key * 
│ │ │ │ +0001ef30: 4b45 5929 0a20 2020 2020 4b45 593a 2073  KEY).     KEY: s
│ │ │ │ +0001ef40: 7472 7563 7475 7265 2074 6861 7420 686f  tructure that ho
│ │ │ │ +0001ef50: 6c64 7320 6b65 7920 696e 666f 726d 6174  lds key informat
│ │ │ │ +0001ef60: 696f 6e0a 0a20 2020 2020 2a44 6573 6372  ion..     *Descr
│ │ │ │ +0001ef70: 6970 7469 6f6e 3a2a 2047 6574 2074 6865  iption:* Get the
│ │ │ │ +0001ef80: 2072 6177 206b 6579 2062 7974 6573 2e0a   raw key bytes..
│ │ │ │ +0001ef90: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ +0001efa0: 6c75 653a 2a20 5265 7475 726e 7320 7468  lue:* Returns th
│ │ │ │ +0001efb0: 6520 6b65 7920 7661 6c75 6520 6173 2061  e key value as a
│ │ │ │ +0001efc0: 2070 6f69 6e74 6572 2077 6869 6368 2069   pointer which i
│ │ │ │ +0001efd0: 7320 7661 6c69 640a 2020 2020 2074 6872  s valid.     thr
│ │ │ │ +0001efe0: 6f75 6768 6f75 7420 7468 6520 6c69 6665  oughout the life
│ │ │ │ +0001eff0: 7469 6d65 206f 6620 7468 6520 6b65 7920  time of the key 
│ │ │ │ +0001f000: 7374 7275 6374 7572 652e 0a0a 7368 6973  structure...shis
│ │ │ │ +0001f010: 6869 5f6b 6579 5f76 616c 7565 5f73 6574  hi_key_value_set
│ │ │ │ +0001f020: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ +0001f030: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +0001f040: 696f 6e3a 2076 6f69 6420 7368 6973 6869  ion: void shishi
│ │ │ │ +0001f050: 5f6b 6579 5f76 616c 7565 5f73 6574 2028  _key_value_set (
│ │ │ │ +0001f060: 5368 6973 6869 5f6b 6579 202a 204b 4559  Shishi_key * KEY
│ │ │ │ +0001f070: 2c0a 2020 2020 2020 2020 2020 636f 6e73  ,.          cons
│ │ │ │ +0001f080: 7420 6368 6172 202a 2056 414c 5545 290a  t char * VALUE).
│ │ │ │ +0001f090: 2020 2020 204b 4559 3a20 7374 7275 6374       KEY: struct
│ │ │ │ +0001f0a0: 7572 6520 7468 6174 2068 6f6c 6473 206b  ure that holds k
│ │ │ │ +0001f0b0: 6579 2069 6e66 6f72 6d61 7469 6f6e 0a20  ey information. 
│ │ │ │ +0001f0c0: 2020 2020 5641 4c55 453a 2069 6e70 7574      VALUE: input
│ │ │ │ +0001f0d0: 2061 7272 6179 2077 6974 6820 6b65 7920   array with key 
│ │ │ │ +0001f0e0: 6461 7461 2e0a 0a20 2020 2020 2a44 6573  data...     *Des
│ │ │ │ +0001f0f0: 6372 6970 7469 6f6e 3a2a 2053 6574 2074  cription:* Set t
│ │ │ │ +0001f100: 6865 206b 6579 2076 616c 7565 2061 6e64  he key value and
│ │ │ │ +0001f110: 206c 656e 6774 6820 696e 206b 6579 2073   length in key s
│ │ │ │ +0001f120: 7472 7563 7475 7265 2e20 2054 6865 0a20  tructure.  The. 
│ │ │ │ +0001f130: 2020 2020 7661 6c75 6520 6973 2063 6f70      value is cop
│ │ │ │ +0001f140: 6965 6420 696e 746f 2074 6865 206b 6579  ied into the key
│ │ │ │ +0001f150: 2028 696e 206f 7468 6572 2077 6f72 6473   (in other words
│ │ │ │ +0001f160: 2c20 796f 7520 6361 6e20 6465 616c 6c6f  , you can deallo
│ │ │ │ +0001f170: 6361 7465 0a20 2020 2020 5641 4c55 4520  cate.     VALUE 
│ │ │ │ +0001f180: 7269 6768 7420 6166 7465 7220 6361 6c6c  right after call
│ │ │ │ +0001f190: 696e 6720 7468 6973 2066 756e 6374 696f  ing this functio
│ │ │ │ +0001f1a0: 6e20 7769 7468 6f75 7420 6d6f 6469 6679  n without modify
│ │ │ │ +0001f1b0: 696e 6720 7468 6520 7661 6c75 650a 2020  ing the value.  
│ │ │ │ +0001f1c0: 2020 2069 6e73 6964 6520 7468 6520 6b65     inside the ke
│ │ │ │ +0001f1d0: 7929 2e0a 0a73 6869 7368 695f 6b65 795f  y)...shishi_key_
│ │ │ │ +0001f1e0: 7665 7273 696f 6e0a 2d2d 2d2d 2d2d 2d2d  version.--------
│ │ │ │ +0001f1f0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +0001f200: 4675 6e63 7469 6f6e 3a20 7569 6e74 3332  Function: uint32
│ │ │ │ +0001f210: 5f74 2073 6869 7368 695f 6b65 795f 7665  _t shishi_key_ve
│ │ │ │ +0001f220: 7273 696f 6e20 2863 6f6e 7374 2053 6869  rsion (const Shi
│ │ │ │ +0001f230: 7368 695f 6b65 7920 2a20 4b45 5929 0a20  shi_key * KEY). 
│ │ │ │ +0001f240: 2020 2020 4b45 593a 2073 7472 7563 7475      KEY: structu
│ │ │ │ +0001f250: 7265 2074 6861 7420 686f 6c64 7320 6b65  re that holds ke
│ │ │ │ +0001f260: 7920 696e 666f 726d 6174 696f 6e0a 0a20  y information.. 
│ │ │ │ +0001f270: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ +0001f280: 3a2a 2047 6574 2074 6865 2022 6b76 6e6f  :* Get the "kvno
│ │ │ │ +0001f290: 2220 286b 6579 2076 6572 7369 6f6e 2920  " (key version) 
│ │ │ │ +0001f2a0: 6f66 206b 6579 2e20 2049 7420 7769 6c6c  of key.  It will
│ │ │ │ +0001f2b0: 2062 650a 2020 2020 2055 494e 5433 325f   be.     UINT32_
│ │ │ │ +0001f2c0: 4d41 5820 6966 2074 6865 206b 6579 2069  MAX if the key i
│ │ │ │ +0001f2d0: 7320 6e6f 7420 6c6f 6e67 2d6c 6976 6564  s not long-lived
│ │ │ │ +0001f2e0: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ +0001f2f0: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ +0001f300: 7468 6520 7665 7273 696f 6e20 6f66 206b  the version of k
│ │ │ │ +0001f310: 6579 2028 226b 766e 6f22 292e 0a0a 7368  ey ("kvno")...sh
│ │ │ │ +0001f320: 6973 6869 5f6b 6579 5f76 6572 7369 6f6e  ishi_key_version
│ │ │ │ +0001f330: 5f73 6574 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  _set.-----------
│ │ │ │ +0001f340: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ +0001f350: 2046 756e 6374 696f 6e3a 2076 6f69 6420   Function: void 
│ │ │ │ +0001f360: 7368 6973 6869 5f6b 6579 5f76 6572 7369  shishi_key_versi
│ │ │ │ +0001f370: 6f6e 5f73 6574 2028 5368 6973 6869 5f6b  on_set (Shishi_k
│ │ │ │ +0001f380: 6579 202a 204b 4559 2c0a 2020 2020 2020  ey * KEY,.      
│ │ │ │ +0001f390: 2020 2020 7569 6e74 3332 5f74 204b 564e      uint32_t KVN
│ │ │ │ +0001f3a0: 4f29 0a20 2020 2020 4b45 593a 2073 7472  O).     KEY: str
│ │ │ │ +0001f3b0: 7563 7475 7265 2074 6861 7420 686f 6c64  ucture that hold
│ │ │ │ +0001f3c0: 7320 6b65 7920 696e 666f 726d 6174 696f  s key informatio
│ │ │ │ +0001f3d0: 6e0a 2020 2020 204b 564e 4f3a 206e 6577  n.     KVNO: new
│ │ │ │ +0001f3e0: 2076 6572 7369 6f6e 2069 6e74 6567 6572   version integer
│ │ │ │ +0001f3f0: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ +0001f400: 7469 6f6e 3a2a 2053 6574 2074 6865 2076  tion:* Set the v
│ │ │ │ +0001f410: 6572 7369 6f6e 206f 6620 6b65 7920 2822  ersion of key ("
│ │ │ │ +0001f420: 6b76 6e6f 2229 2069 6e20 6b65 7920 7374  kvno") in key st
│ │ │ │ +0001f430: 7275 6374 7572 652e 0a20 2020 2020 5573  ructure..     Us
│ │ │ │ +0001f440: 6520 5549 4e54 3332 5f4d 4158 2066 6f72  e UINT32_MAX for
│ │ │ │ +0001f450: 206e 6f6e 2d70 7465 726d 616e 656e 7420   non-ptermanent 
│ │ │ │ +0001f460: 6b65 7973 2e0a 0a73 6869 7368 695f 6b65  keys...shishi_ke
│ │ │ │ +0001f470: 795f 7469 6d65 7374 616d 700a 2d2d 2d2d  y_timestamp.----
│ │ │ │ +0001f480: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +0001f490: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +0001f4a0: 7469 6d65 5f74 2073 6869 7368 695f 6b65  time_t shishi_ke
│ │ │ │ +0001f4b0: 795f 7469 6d65 7374 616d 7020 2863 6f6e  y_timestamp (con
│ │ │ │ +0001f4c0: 7374 2053 6869 7368 695f 6b65 7920 2a20  st Shishi_key * 
│ │ │ │ +0001f4d0: 4b45 5929 0a20 2020 2020 4b45 593a 2073  KEY).     KEY: s
│ │ │ │ +0001f4e0: 7472 7563 7475 7265 2074 6861 7420 686f  tructure that ho
│ │ │ │ +0001f4f0: 6c64 7320 6b65 7920 696e 666f 726d 6174  lds key informat
│ │ │ │ +0001f500: 696f 6e0a 0a20 2020 2020 2a44 6573 6372  ion..     *Descr
│ │ │ │ +0001f510: 6970 7469 6f6e 3a2a 2047 6574 2074 6865  iption:* Get the
│ │ │ │ +0001f520: 2074 696d 6520 7468 6520 6b65 7920 7761   time the key wa
│ │ │ │ +0001f530: 7320 6573 7461 626c 6973 6865 642e 2020  s established.  
│ │ │ │ +0001f540: 5479 7069 6361 6c6c 790a 2020 2020 206f  Typically.     o
│ │ │ │ +0001f550: 6e6c 7920 7072 6573 656e 7420 7768 656e  nly present when
│ │ │ │ +0001f560: 2074 6865 206b 6579 2077 6173 2069 6d70   the key was imp
│ │ │ │ +0001f570: 6f72 7465 6420 6672 6f6d 2061 206b 6579  orted from a key
│ │ │ │ +0001f580: 7461 6220 666f 726d 6174 2e0a 0a20 2020  tab format...   
│ │ │ │ +0001f590: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ +0001f5a0: 2a20 5265 7475 726e 7320 7468 6520 7469  * Returns the ti
│ │ │ │ +0001f5b0: 6d65 2074 6865 206b 6579 2077 6173 2065  me the key was e
│ │ │ │ +0001f5c0: 7374 6162 6c69 7368 6564 2c20 6f72 0a20  stablished, or. 
│ │ │ │ +0001f5d0: 2020 2020 2874 696d 655f 7429 2d31 2069      (time_t)-1 i
│ │ │ │ +0001f5e0: 6620 6e6f 7420 6176 6169 6c61 626c 652e  f not available.
│ │ │ │ +0001f5f0: 0a0a 2020 2020 202a 5369 6e63 653a 2a20  ..     *Since:* 
│ │ │ │ +0001f600: 302e 302e 3432 0a0a 7368 6973 6869 5f6b  0.0.42..shishi_k
│ │ │ │ +0001f610: 6579 5f74 696d 6573 7461 6d70 5f73 6574  ey_timestamp_set
│ │ │ │ +0001f620: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ +0001f630: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +0001f640: 756e 6374 696f 6e3a 2076 6f69 6420 7368  unction: void sh
│ │ │ │ +0001f650: 6973 6869 5f6b 6579 5f74 696d 6573 7461  ishi_key_timesta
│ │ │ │ +0001f660: 6d70 5f73 6574 2028 5368 6973 6869 5f6b  mp_set (Shishi_k
│ │ │ │ +0001f670: 6579 202a 204b 4559 2c0a 2020 2020 2020  ey * KEY,.      
│ │ │ │ +0001f680: 2020 2020 7469 6d65 5f74 2054 494d 4553      time_t TIMES
│ │ │ │ +0001f690: 5441 4d50 290a 2020 2020 204b 4559 3a20  TAMP).     KEY: 
│ │ │ │ +0001f6a0: 7374 7275 6374 7572 6520 7468 6174 2068  structure that h
│ │ │ │ +0001f6b0: 6f6c 6473 206b 6579 2069 6e66 6f72 6d61  olds key informa
│ │ │ │ +0001f6c0: 7469 6f6e 0a20 2020 2020 5449 4d45 5354  tion.     TIMEST
│ │ │ │ +0001f6d0: 414d 503a 206e 6577 2074 696d 6573 7461  AMP: new timesta
│ │ │ │ +0001f6e0: 6d70 2e0a 0a20 2020 2020 2a44 6573 6372  mp...     *Descr
│ │ │ │ +0001f6f0: 6970 7469 6f6e 3a2a 2053 6574 2074 6865  iption:* Set the
│ │ │ │ +0001f700: 2074 696d 6520 7468 6520 6b65 7920 7761   time the key wa
│ │ │ │ +0001f710: 7320 6573 7461 626c 6973 6865 642e 2020  s established.  
│ │ │ │ +0001f720: 5479 7069 6361 6c6c 790a 2020 2020 206f  Typically.     o
│ │ │ │ +0001f730: 6e6c 7920 7265 6c65 7661 6e74 2077 6865  nly relevant whe
│ │ │ │ +0001f740: 6e20 6578 706f 7274 696e 6720 7468 6520  n exporting the 
│ │ │ │ +0001f750: 6b65 7920 746f 206b 6579 7461 6220 666f  key to keytab fo
│ │ │ │ +0001f760: 726d 6174 2e0a 0a20 2020 2020 2a53 696e  rmat...     *Sin
│ │ │ │ +0001f770: 6365 3a2a 2030 2e30 2e34 320a 0a73 6869  ce:* 0.0.42..shi
│ │ │ │ +0001f780: 7368 695f 6b65 795f 6e61 6d65 0a2d 2d2d  shi_key_name.---
│ │ │ │ +0001f790: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ +0001f7a0: 2d20 4675 6e63 7469 6f6e 3a20 636f 6e73  - Function: cons
│ │ │ │ +0001f7b0: 7420 6368 6172 202a 2073 6869 7368 695f  t char * shishi_
│ │ │ │ +0001f7c0: 6b65 795f 6e61 6d65 2028 5368 6973 6869  key_name (Shishi
│ │ │ │ +0001f7d0: 5f6b 6579 202a 204b 4559 290a 2020 2020  _key * KEY).    
│ │ │ │ +0001f7e0: 204b 4559 3a20 7374 7275 6374 7572 6520   KEY: structure 
│ │ │ │ +0001f7f0: 7468 6174 2068 6f6c 6473 206b 6579 2069  that holds key i
│ │ │ │ +0001f800: 6e66 6f72 6d61 7469 6f6e 0a0a 2020 2020  nformation..    
│ │ │ │ +0001f810: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ +0001f820: 4361 6c6c 7320 7368 6973 6869 5f63 6970  Calls shishi_cip
│ │ │ │ +0001f830: 6865 725f 6e61 6d65 2066 6f72 206b 6579  her_name for key
│ │ │ │ +0001f840: 2074 7970 652e 0a0a 2020 2020 202a 5265   type...     *Re
│ │ │ │ +0001f850: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ +0001f860: 7572 6e20 6e61 6d65 206f 6620 6b65 792e  urn name of key.
│ │ │ │ +0001f870: 0a0a 7368 6973 6869 5f6b 6579 5f6c 656e  ..shishi_key_len
│ │ │ │ +0001f880: 6774 680a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  gth.------------
│ │ │ │ +0001f890: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +0001f8a0: 696f 6e3a 2073 697a 655f 7420 7368 6973  ion: size_t shis
│ │ │ │ +0001f8b0: 6869 5f6b 6579 5f6c 656e 6774 6820 2863  hi_key_length (c
│ │ │ │ +0001f8c0: 6f6e 7374 2053 6869 7368 695f 6b65 7920  onst Shishi_key 
│ │ │ │ +0001f8d0: 2a20 4b45 5929 0a20 2020 2020 4b45 593a  * KEY).     KEY:
│ │ │ │ +0001f8e0: 2073 7472 7563 7475 7265 2074 6861 7420   structure that 
│ │ │ │ +0001f8f0: 686f 6c64 7320 6b65 7920 696e 666f 726d  holds key inform
│ │ │ │ +0001f900: 6174 696f 6e0a 0a20 2020 2020 2a44 6573  ation..     *Des
│ │ │ │ +0001f910: 6372 6970 7469 6f6e 3a2a 2043 616c 6c73  cription:* Calls
│ │ │ │ +0001f920: 2073 6869 7368 695f 6369 7068 6572 5f6b   shishi_cipher_k
│ │ │ │ +0001f930: 6579 6c65 6e20 666f 7220 6b65 7920 7479  eylen for key ty
│ │ │ │ +0001f940: 7065 2e0a 0a20 2020 2020 2a52 6574 7572  pe...     *Retur
│ │ │ │ +0001f950: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ +0001f960: 7320 7468 6520 6c65 6e67 7468 206f 6620  s the length of 
│ │ │ │ +0001f970: 7468 6520 6b65 7920 7661 6c75 652e 0a0a  the key value...
│ │ │ │ +0001f980: 7368 6973 6869 5f6b 6579 0a2d 2d2d 2d2d  shishi_key.-----
│ │ │ │ +0001f990: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +0001f9a0: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ +0001f9b0: 6b65 7920 2853 6869 7368 6920 2a20 4841  key (Shishi * HA
│ │ │ │ +0001f9c0: 4e44 4c45 2c20 5368 6973 6869 5f6b 6579  NDLE, Shishi_key
│ │ │ │ +0001f9d0: 202a 2a20 4b45 5929 0a20 2020 2020 4841   ** KEY).     HA
│ │ │ │ +0001f9e0: 4e44 4c45 3a20 5368 6973 6869 206c 6962  NDLE: Shishi lib
│ │ │ │ +0001f9f0: 7261 7279 2068 616e 646c 6520 6372 6561  rary handle crea
│ │ │ │ +0001fa00: 7465 2062 7920 e280 9873 6869 7368 695f  te by ...shishi_
│ │ │ │ +0001fa10: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ +0001fa20: 4b45 593a 2070 6f69 6e74 6572 2074 6f20  KEY: pointer to 
│ │ │ │ +0001fa30: 7374 7275 6374 7572 6520 7468 6174 2077  structure that w
│ │ │ │ +0001fa40: 696c 6c20 686f 6c64 206e 6577 6c79 2063  ill hold newly c
│ │ │ │ +0001fa50: 7265 6174 6564 206b 6579 0a20 2020 2020  reated key.     
│ │ │ │ +0001fa60: 696e 666f 726d 6174 696f 6e0a 0a20 2020  information..   
│ │ │ │ +0001fa70: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ +0001fa80: 2043 7265 6174 6520 6120 6e65 7720 4b65   Create a new Ke
│ │ │ │ +0001fa90: 7920 696e 666f 726d 6174 696f 6e20 7374  y information st
│ │ │ │ +0001faa0: 7275 6374 7572 652e 0a0a 2020 2020 202a  ructure...     *
│ │ │ │ +0001fab0: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ +0001fac0: 6574 7572 6e73 2053 4849 5348 495f 4f4b  eturns SHISHI_OK
│ │ │ │ +0001fad0: 2069 6666 2073 7563 6365 7373 6675 6c2e   iff successful.
│ │ │ │ +0001fae0: 0a0a 7368 6973 6869 5f6b 6579 5f64 6f6e  ..shishi_key_don
│ │ │ │ +0001faf0: 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  e.--------------
│ │ │ │ +0001fb00: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ +0001fb10: 2076 6f69 6420 7368 6973 6869 5f6b 6579   void shishi_key
│ │ │ │ +0001fb20: 5f64 6f6e 6520 2853 6869 7368 695f 6b65  _done (Shishi_ke
│ │ │ │ +0001fb30: 7920 2a20 4b45 5929 0a20 2020 2020 4b45  y * KEY).     KE
│ │ │ │ +0001fb40: 593a 2070 6f69 6e74 6572 2074 6f20 7374  Y: pointer to st
│ │ │ │ +0001fb50: 7275 6374 7572 6520 7468 6174 2068 6f6c  ructure that hol
│ │ │ │ +0001fb60: 6473 206b 6579 2069 6e66 6f72 6d61 7469  ds key informati
│ │ │ │ +0001fb70: 6f6e 2e0a 0a20 2020 2020 2a44 6573 6372  on...     *Descr
│ │ │ │ +0001fb80: 6970 7469 6f6e 3a2a 2044 6561 6c6c 6f63  iption:* Dealloc
│ │ │ │ +0001fb90: 6174 6573 206b 6579 2069 6e66 6f72 6d61  ates key informa
│ │ │ │ +0001fba0: 7469 6f6e 2073 7472 7563 7475 7265 2e0a  tion structure..
│ │ │ │ +0001fbb0: 0a73 6869 7368 695f 6b65 795f 636f 7079  .shishi_key_copy
│ │ │ │ +0001fbc0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ +0001fbd0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +0001fbe0: 766f 6964 2073 6869 7368 695f 6b65 795f  void shishi_key_
│ │ │ │ +0001fbf0: 636f 7079 2028 5368 6973 6869 5f6b 6579  copy (Shishi_key
│ │ │ │ +0001fc00: 202a 2044 5354 4b45 592c 0a20 2020 2020   * DSTKEY,.     
│ │ │ │ +0001fc10: 2020 2020 2053 6869 7368 695f 6b65 7920       Shishi_key 
│ │ │ │ +0001fc20: 2a20 5352 434b 4559 290a 2020 2020 2044  * SRCKEY).     D
│ │ │ │ +0001fc30: 5354 4b45 593a 2073 7472 7563 7475 7265  STKEY: structure
│ │ │ │ +0001fc40: 2074 6861 7420 686f 6c64 7320 6465 7374   that holds dest
│ │ │ │ +0001fc50: 696e 6174 696f 6e20 6b65 7920 696e 666f  ination key info
│ │ │ │ +0001fc60: 726d 6174 696f 6e0a 2020 2020 2053 5243  rmation.     SRC
│ │ │ │ +0001fc70: 4b45 593a 2073 7472 7563 7475 7265 2074  KEY: structure t
│ │ │ │ +0001fc80: 6861 7420 686f 6c64 7320 736f 7572 6365  hat holds source
│ │ │ │ +0001fc90: 206b 6579 2069 6e66 6f72 6d61 7469 6f6e   key information
│ │ │ │ +0001fca0: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ +0001fcb0: 696f 6e3a 2a20 436f 7069 6573 2073 6f75  ion:* Copies sou
│ │ │ │ +0001fcc0: 7263 6520 6b65 7920 696e 746f 2065 7869  rce key into exi
│ │ │ │ +0001fcd0: 7374 696e 6720 616c 6c6f 6361 7465 640a  sting allocated.
│ │ │ │ +0001fce0: 2020 2020 2064 6573 7469 6e61 7469 6f6e       destination
│ │ │ │ +0001fcf0: 206b 6579 2e0a 0a73 6869 7368 695f 6b65   key...shishi_ke
│ │ │ │ +0001fd00: 795f 6672 6f6d 5f76 616c 7565 0a2d 2d2d  y_from_value.---
│ │ │ │  0001fd10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0001fd20: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ -0001fd30: 2069 6e74 2073 6869 7368 695f 6b65 795f   int shishi_key_
│ │ │ │ -0001fd40: 6672 6f6d 5f76 616c 7565 2028 5368 6973  from_value (Shis
│ │ │ │ -0001fd50: 6869 202a 2048 414e 444c 452c 2069 6e74  hi * HANDLE, int
│ │ │ │ -0001fd60: 3332 5f74 2054 5950 452c 0a20 2020 2020  32_t TYPE,.     
│ │ │ │ -0001fd70: 2020 2020 2063 6f6e 7374 2063 6861 7220       const char 
│ │ │ │ -0001fd80: 2a20 5641 4c55 452c 2053 6869 7368 695f  * VALUE, Shishi_
│ │ │ │ -0001fd90: 6b65 7920 2a2a 204b 4559 290a 2020 2020  key ** KEY).    
│ │ │ │ -0001fda0: 2048 414e 444c 453a 2053 6869 7368 6920   HANDLE: Shishi 
│ │ │ │ -0001fdb0: 6c69 6272 6172 7920 6861 6e64 6c65 2063  library handle c
│ │ │ │ -0001fdc0: 7265 6174 6520 6279 20e2 8098 7368 6973  reate by ...shis
│ │ │ │ -0001fdd0: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ -0001fde0: 2020 2054 5950 453a 2074 7970 6520 6f66     TYPE: type of
│ │ │ │ -0001fdf0: 206b 6579 2e0a 2020 2020 2056 414c 5545   key..     VALUE
│ │ │ │ -0001fe00: 3a20 696e 7075 7420 6172 7261 7920 7769  : input array wi
│ │ │ │ -0001fe10: 7468 206b 6579 2076 616c 7565 2c20 6f72  th key value, or
│ │ │ │ -0001fe20: 204e 554c 4c2e 0a20 2020 2020 4b45 593a   NULL..     KEY:
│ │ │ │ -0001fe30: 2070 6f69 6e74 6572 2074 6f20 7374 7275   pointer to stru
│ │ │ │ -0001fe40: 6374 7572 6520 7468 6174 2077 696c 6c20  cture that will 
│ │ │ │ -0001fe50: 686f 6c64 206e 6577 6c79 2063 7265 6174  hold newly creat
│ │ │ │ -0001fe60: 6564 206b 6579 0a20 2020 2020 696e 666f  ed key.     info
│ │ │ │ -0001fe70: 726d 6174 696f 6e0a 0a20 2020 2020 2a44  rmation..     *D
│ │ │ │ -0001fe80: 6573 6372 6970 7469 6f6e 3a2a 2043 7265  escription:* Cre
│ │ │ │ -0001fe90: 6174 6520 6120 6e65 7720 4b65 7920 696e  ate a new Key in
│ │ │ │ -0001fea0: 666f 726d 6174 696f 6e20 7374 7275 6374  formation struct
│ │ │ │ -0001feb0: 7572 652c 2061 6e64 2073 6574 2074 6865  ure, and set the
│ │ │ │ -0001fec0: 0a20 2020 2020 6b65 7920 7479 7065 2061  .     key type a
│ │ │ │ -0001fed0: 6e64 206b 6579 2076 616c 7565 2e20 204b  nd key value.  K
│ │ │ │ -0001fee0: 4559 2063 6f6e 7461 696e 7320 6120 6e65  EY contains a ne
│ │ │ │ -0001fef0: 776c 7920 616c 6c6f 6361 7465 6420 7374  wly allocated st
│ │ │ │ -0001ff00: 7275 6374 7572 650a 2020 2020 206f 6e6c  ructure.     onl
│ │ │ │ -0001ff10: 7920 6966 2074 6869 7320 6675 6e63 7469  y if this functi
│ │ │ │ -0001ff20: 6f6e 2069 7320 7375 6363 6573 7366 756c  on is successful
│ │ │ │ -0001ff30: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ -0001ff40: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ -0001ff50: 5348 4953 4849 5f4f 4b20 6966 6620 7375  SHISHI_OK iff su
│ │ │ │ -0001ff60: 6363 6573 7366 756c 2e0a 0a73 6869 7368  ccessful...shish
│ │ │ │ -0001ff70: 695f 6b65 795f 6672 6f6d 5f62 6173 6536  i_key_from_base6
│ │ │ │ -0001ff80: 340a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  4.--------------
│ │ │ │ -0001ff90: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -0001ffa0: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ -0001ffb0: 6869 5f6b 6579 5f66 726f 6d5f 6261 7365  hi_key_from_base
│ │ │ │ -0001ffc0: 3634 2028 5368 6973 6869 202a 2048 414e  64 (Shishi * HAN
│ │ │ │ -0001ffd0: 444c 452c 2069 6e74 3332 5f74 2054 5950  DLE, int32_t TYP
│ │ │ │ -0001ffe0: 452c 0a20 2020 2020 2020 2020 2063 6f6e  E,.          con
│ │ │ │ -0001fff0: 7374 2063 6861 7220 2a20 5641 4c55 452c  st char * VALUE,
│ │ │ │ -00020000: 2053 6869 7368 695f 6b65 7920 2a2a 204b   Shishi_key ** K
│ │ │ │ -00020010: 4559 290a 2020 2020 2048 414e 444c 453a  EY).     HANDLE:
│ │ │ │ -00020020: 2053 6869 7368 6920 6c69 6272 6172 7920   Shishi library 
│ │ │ │ -00020030: 6861 6e64 6c65 2063 7265 6174 6520 6279  handle create by
│ │ │ │ -00020040: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ -00020050: 29e2 8099 2e0a 2020 2020 2054 5950 453a  ).....     TYPE:
│ │ │ │ -00020060: 2074 7970 6520 6f66 206b 6579 2e0a 2020   type of key..  
│ │ │ │ -00020070: 2020 2056 414c 5545 3a20 696e 7075 7420     VALUE: input 
│ │ │ │ -00020080: 7374 7269 6e67 2077 6974 6820 6261 7365  string with base
│ │ │ │ -00020090: 3634 2065 6e63 6f64 6564 206b 6579 2076  64 encoded key v
│ │ │ │ -000200a0: 616c 7565 2c20 6f72 204e 554c 4c2e 0a20  alue, or NULL.. 
│ │ │ │ -000200b0: 2020 2020 4b45 593a 2070 6f69 6e74 6572      KEY: pointer
│ │ │ │ -000200c0: 2074 6f20 7374 7275 6374 7572 6520 7468   to structure th
│ │ │ │ -000200d0: 6174 2077 696c 6c20 686f 6c64 206e 6577  at will hold new
│ │ │ │ -000200e0: 6c79 2063 7265 6174 6564 206b 6579 0a20  ly created key. 
│ │ │ │ -000200f0: 2020 2020 696e 666f 726d 6174 696f 6e0a      information.
│ │ │ │ -00020100: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -00020110: 6f6e 3a2a 2043 7265 6174 6520 6120 6e65  on:* Create a ne
│ │ │ │ -00020120: 7720 4b65 7920 696e 666f 726d 6174 696f  w Key informatio
│ │ │ │ -00020130: 6e20 7374 7275 6374 7572 652c 2061 6e64  n structure, and
│ │ │ │ -00020140: 2073 6574 2074 6865 0a20 2020 2020 6b65   set the.     ke
│ │ │ │ -00020150: 7920 7479 7065 2061 6e64 206b 6579 2076  y type and key v
│ │ │ │ -00020160: 616c 7565 2e20 204b 4559 2063 6f6e 7461  alue.  KEY conta
│ │ │ │ -00020170: 696e 7320 6120 6e65 776c 7920 616c 6c6f  ins a newly allo
│ │ │ │ -00020180: 6361 7465 6420 7374 7275 6374 7572 650a  cated structure.
│ │ │ │ -00020190: 2020 2020 206f 6e6c 7920 6966 2074 6869       only if thi
│ │ │ │ -000201a0: 7320 6675 6e63 7469 6f6e 2069 7320 7375  s function is su
│ │ │ │ -000201b0: 6363 6573 7366 756c 2e0a 0a20 2020 2020  ccessful...     
│ │ │ │ -000201c0: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ -000201d0: 5265 7475 726e 7320 5348 4953 4849 5f49  Returns SHISHI_I
│ │ │ │ -000201e0: 4e56 414c 4944 5f4b 4559 2069 6620 7468  NVALID_KEY if th
│ │ │ │ -000201f0: 6520 6261 7365 3634 2065 6e63 6f64 6564  e base64 encoded
│ │ │ │ -00020200: 0a20 2020 2020 6b65 7920 6c65 6e67 7468  .     key length
│ │ │ │ -00020210: 2064 6f65 736e 2774 206d 6174 6368 2074   doesn't match t
│ │ │ │ -00020220: 6865 206b 6579 2074 7970 652c 2061 6e64  he key type, and
│ │ │ │ -00020230: 2053 4849 5348 495f 4f4b 206f 6e20 7375   SHISHI_OK on su
│ │ │ │ -00020240: 6363 6573 732e 0a0a 7368 6973 6869 5f6b  ccess...shishi_k
│ │ │ │ -00020250: 6579 5f72 616e 646f 6d0a 2d2d 2d2d 2d2d  ey_random.------
│ │ │ │ -00020260: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ -00020270: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ -00020280: 6869 7368 695f 6b65 795f 7261 6e64 6f6d  hishi_key_random
│ │ │ │ -00020290: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ -000202a0: 452c 2069 6e74 3332 5f74 2054 5950 452c  E, int32_t TYPE,
│ │ │ │ -000202b0: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ -000202c0: 695f 6b65 7920 2a2a 204b 4559 290a 2020  i_key ** KEY).  
│ │ │ │ -000202d0: 2020 2048 414e 444c 453a 2053 6869 7368     HANDLE: Shish
│ │ │ │ -000202e0: 6920 6c69 6272 6172 7920 6861 6e64 6c65  i library handle
│ │ │ │ -000202f0: 2063 7265 6174 6520 6279 20e2 8098 7368   create by ...sh
│ │ │ │ -00020300: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ -00020310: 2020 2020 2054 5950 453a 2074 7970 6520       TYPE: type 
│ │ │ │ -00020320: 6f66 206b 6579 2e0a 2020 2020 204b 4559  of key..     KEY
│ │ │ │ -00020330: 3a20 706f 696e 7465 7220 746f 2073 7472  : pointer to str
│ │ │ │ -00020340: 7563 7475 7265 2074 6861 7420 7769 6c6c  ucture that will
│ │ │ │ -00020350: 2068 6f6c 6420 6e65 776c 7920 6372 6561   hold newly crea
│ │ │ │ -00020360: 7465 6420 6b65 790a 2020 2020 2069 6e66  ted key.     inf
│ │ │ │ -00020370: 6f72 6d61 7469 6f6e 0a0a 2020 2020 202a  ormation..     *
│ │ │ │ -00020380: 4465 7363 7269 7074 696f 6e3a 2a20 4372  Description:* Cr
│ │ │ │ -00020390: 6561 7465 2061 206e 6577 204b 6579 2069  eate a new Key i
│ │ │ │ -000203a0: 6e66 6f72 6d61 7469 6f6e 2073 7472 7563  nformation struc
│ │ │ │ -000203b0: 7475 7265 2066 6f72 2074 6865 206b 6579  ture for the key
│ │ │ │ -000203c0: 0a20 2020 2020 7479 7065 2061 6e64 2073  .     type and s
│ │ │ │ -000203d0: 6f6d 6520 7261 6e64 6f6d 2064 6174 612e  ome random data.
│ │ │ │ -000203e0: 2020 4b45 5920 636f 6e74 6169 6e73 2061    KEY contains a
│ │ │ │ -000203f0: 206e 6577 6c79 2061 6c6c 6f63 6174 6564   newly allocated
│ │ │ │ -00020400: 0a20 2020 2020 7374 7275 6374 7572 6520  .     structure 
│ │ │ │ -00020410: 6f6e 6c79 2069 6620 7468 6973 2066 756e  only if this fun
│ │ │ │ -00020420: 6374 696f 6e20 6973 2073 7563 6365 7373  ction is success
│ │ │ │ -00020430: 6675 6c2e 0a0a 2020 2020 202a 5265 7475  ful...     *Retu
│ │ │ │ -00020440: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ -00020450: 6e73 2053 4849 5348 495f 4f4b 2069 6666  ns SHISHI_OK iff
│ │ │ │ -00020460: 2073 7563 6365 7373 6675 6c2e 0a0a 7368   successful...sh
│ │ │ │ -00020470: 6973 6869 5f6b 6579 5f66 726f 6d5f 7261  ishi_key_from_ra
│ │ │ │ -00020480: 6e64 6f6d 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  ndom.-----------
│ │ │ │ -00020490: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ -000204a0: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ -000204b0: 6869 7368 695f 6b65 795f 6672 6f6d 5f72  hishi_key_from_r
│ │ │ │ -000204c0: 616e 646f 6d20 2853 6869 7368 6920 2a20  andom (Shishi * 
│ │ │ │ -000204d0: 4841 4e44 4c45 2c20 696e 7433 325f 7420  HANDLE, int32_t 
│ │ │ │ -000204e0: 5459 5045 2c0a 2020 2020 2020 2020 2020  TYPE,.          
│ │ │ │ -000204f0: 636f 6e73 7420 6368 6172 202a 2052 4e44  const char * RND
│ │ │ │ -00020500: 2c20 7369 7a65 5f74 2052 4e44 4c45 4e2c  , size_t RNDLEN,
│ │ │ │ -00020510: 2053 6869 7368 695f 6b65 7920 2a2a 204f   Shishi_key ** O
│ │ │ │ -00020520: 5554 4b45 5929 0a20 2020 2020 4841 4e44  UTKEY).     HAND
│ │ │ │ -00020530: 4c45 3a20 5368 6973 6869 206c 6962 7261  LE: Shishi libra
│ │ │ │ -00020540: 7279 2068 616e 646c 6520 6372 6561 7465  ry handle create
│ │ │ │ -00020550: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ -00020560: 6974 2829 e280 992e 0a20 2020 2020 5459  it().....     TY
│ │ │ │ -00020570: 5045 3a20 7479 7065 206f 6620 6b65 792e  PE: type of key.
│ │ │ │ -00020580: 0a20 2020 2020 524e 443a 2072 616e 646f  .     RND: rando
│ │ │ │ -00020590: 6d20 6461 7461 2e0a 2020 2020 2052 4e44  m data..     RND
│ │ │ │ -000205a0: 4c45 4e3a 206c 656e 6774 6820 6f66 2072  LEN: length of r
│ │ │ │ -000205b0: 616e 646f 6d20 6461 7461 2e0a 2020 2020  andom data..    
│ │ │ │ -000205c0: 204f 5554 4b45 593a 2070 6f69 6e74 6572   OUTKEY: pointer
│ │ │ │ -000205d0: 2074 6f20 7374 7275 6374 7572 6520 7468   to structure th
│ │ │ │ -000205e0: 6174 2077 696c 6c20 686f 6c64 206e 6577  at will hold new
│ │ │ │ -000205f0: 6c79 2063 7265 6174 6564 206b 6579 0a20  ly created key. 
│ │ │ │ -00020600: 2020 2020 696e 666f 726d 6174 696f 6e0a      information.
│ │ │ │ -00020610: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -00020620: 6f6e 3a2a 2043 7265 6174 6520 6120 6e65  on:* Create a ne
│ │ │ │ -00020630: 7720 4b65 7920 696e 666f 726d 6174 696f  w Key informatio
│ │ │ │ -00020640: 6e20 7374 7275 6374 7572 652c 2061 6e64  n structure, and
│ │ │ │ -00020650: 2073 6574 2074 6865 0a20 2020 2020 6b65   set the.     ke
│ │ │ │ -00020660: 7920 7479 7065 2061 6e64 206b 6579 2076  y type and key v
│ │ │ │ -00020670: 616c 7565 2075 7369 6e67 20e2 8098 7368  alue using ...sh
│ │ │ │ -00020680: 6973 6869 5f72 616e 646f 6d5f 746f 5f6b  ishi_random_to_k
│ │ │ │ -00020690: 6579 2829 e280 992e 2020 4b45 590a 2020  ey()....  KEY.  
│ │ │ │ -000206a0: 2020 2063 6f6e 7461 696e 7320 6120 6e65     contains a ne
│ │ │ │ -000206b0: 776c 7920 616c 6c6f 6361 7465 6420 7374  wly allocated st
│ │ │ │ -000206c0: 7275 6374 7572 6520 6f6e 6c79 2069 6620  ructure only if 
│ │ │ │ -000206d0: 7468 6973 2066 756e 6374 696f 6e20 6973  this function is
│ │ │ │ -000206e0: 0a20 2020 2020 7375 6363 6573 7366 756c  .     successful
│ │ │ │ -000206f0: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ -00020700: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ -00020710: 5348 4953 4849 5f4f 4b20 6966 6620 7375  SHISHI_OK iff su
│ │ │ │ -00020720: 6363 6573 7366 756c 2e0a 0a73 6869 7368  ccessful...shish
│ │ │ │ -00020730: 695f 6b65 795f 6672 6f6d 5f73 7472 696e  i_key_from_strin
│ │ │ │ -00020740: 670a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  g.--------------
│ │ │ │ -00020750: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -00020760: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ -00020770: 6869 5f6b 6579 5f66 726f 6d5f 7374 7269  hi_key_from_stri
│ │ │ │ -00020780: 6e67 2028 5368 6973 6869 202a 2048 414e  ng (Shishi * HAN
│ │ │ │ -00020790: 444c 452c 2069 6e74 3332 5f74 2054 5950  DLE, int32_t TYP
│ │ │ │ -000207a0: 452c 0a20 2020 2020 2020 2020 2063 6f6e  E,.          con
│ │ │ │ -000207b0: 7374 2063 6861 7220 2a20 5041 5353 574f  st char * PASSWO
│ │ │ │ -000207c0: 5244 2c20 7369 7a65 5f74 2050 4153 5357  RD, size_t PASSW
│ │ │ │ -000207d0: 4f52 444c 454e 2c20 636f 6e73 7420 6368  ORDLEN, const ch
│ │ │ │ -000207e0: 6172 202a 2053 414c 542c 0a20 2020 2020  ar * SALT,.     
│ │ │ │ -000207f0: 2020 2020 2073 697a 655f 7420 5341 4c54       size_t SALT
│ │ │ │ -00020800: 4c45 4e2c 2063 6f6e 7374 2063 6861 7220  LEN, const char 
│ │ │ │ -00020810: 2a20 5041 5241 4d45 5445 522c 2053 6869  * PARAMETER, Shi
│ │ │ │ -00020820: 7368 695f 6b65 7920 2a2a 204f 5554 4b45  shi_key ** OUTKE
│ │ │ │ -00020830: 5929 0a20 2020 2020 4841 4e44 4c45 3a20  Y).     HANDLE: 
│ │ │ │ -00020840: 5368 6973 6869 206c 6962 7261 7279 2068  Shishi library h
│ │ │ │ -00020850: 616e 646c 6520 6372 6561 7465 2062 7920  andle create by 
│ │ │ │ -00020860: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ -00020870: e280 992e 0a20 2020 2020 5459 5045 3a20  .....     TYPE: 
│ │ │ │ -00020880: 7479 7065 206f 6620 6b65 792e 0a20 2020  type of key..   
│ │ │ │ -00020890: 2020 5041 5353 574f 5244 3a20 696e 7075    PASSWORD: inpu
│ │ │ │ -000208a0: 7420 6172 7261 7920 636f 6e74 6169 6e69  t array containi
│ │ │ │ -000208b0: 6e67 2070 6173 7377 6f72 642e 0a20 2020  ng password..   
│ │ │ │ -000208c0: 2020 5041 5353 574f 5244 4c45 4e3a 206c    PASSWORDLEN: l
│ │ │ │ -000208d0: 656e 6774 6820 6f66 2069 6e70 7574 2061  ength of input a
│ │ │ │ -000208e0: 7272 6179 2063 6f6e 7461 696e 696e 6720  rray containing 
│ │ │ │ -000208f0: 7061 7373 776f 7264 2e0a 2020 2020 2053  password..     S
│ │ │ │ -00020900: 414c 543a 2069 6e70 7574 2061 7272 6179  ALT: input array
│ │ │ │ -00020910: 2063 6f6e 7461 696e 696e 6720 7361 6c74   containing salt
│ │ │ │ -00020920: 2e0a 2020 2020 2053 414c 544c 454e 3a20  ..     SALTLEN: 
│ │ │ │ -00020930: 6c65 6e67 7468 206f 6620 696e 7075 7420  length of input 
│ │ │ │ -00020940: 6172 7261 7920 636f 6e74 6169 6e69 6e67  array containing
│ │ │ │ -00020950: 2073 616c 742e 0a20 2020 2020 5041 5241   salt..     PARA
│ │ │ │ -00020960: 4d45 5445 523a 2069 6e70 7574 2061 7272  METER: input arr
│ │ │ │ -00020970: 6179 2077 6974 6820 6f70 6171 7565 2065  ay with opaque e
│ │ │ │ -00020980: 6e63 7279 7074 696f 6e20 7479 7065 2073  ncryption type s
│ │ │ │ -00020990: 7065 6369 6669 630a 2020 2020 2069 6e66  pecific.     inf
│ │ │ │ -000209a0: 6f72 6d61 7469 6f6e 2e0a 2020 2020 204f  ormation..     O
│ │ │ │ -000209b0: 5554 4b45 593a 2070 6f69 6e74 6572 2074  UTKEY: pointer t
│ │ │ │ -000209c0: 6f20 7374 7275 6374 7572 6520 7468 6174  o structure that
│ │ │ │ -000209d0: 2077 696c 6c20 686f 6c64 206e 6577 6c79   will hold newly
│ │ │ │ -000209e0: 2063 7265 6174 6564 206b 6579 0a20 2020   created key.   
│ │ │ │ -000209f0: 2020 696e 666f 726d 6174 696f 6e0a 0a20    information.. 
│ │ │ │ -00020a00: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -00020a10: 3a2a 2043 7265 6174 6520 6120 6e65 7720  :* Create a new 
│ │ │ │ -00020a20: 4b65 7920 696e 666f 726d 6174 696f 6e20  Key information 
│ │ │ │ -00020a30: 7374 7275 6374 7572 652c 2061 6e64 2073  structure, and s
│ │ │ │ -00020a40: 6574 2074 6865 0a20 2020 2020 6b65 7920  et the.     key 
│ │ │ │ -00020a50: 7479 7065 2061 6e64 206b 6579 2076 616c  type and key val
│ │ │ │ -00020a60: 7565 2075 7369 6e67 20e2 8098 7368 6973  ue using ...shis
│ │ │ │ -00020a70: 6869 5f73 7472 696e 675f 746f 5f6b 6579  hi_string_to_key
│ │ │ │ -00020a80: 2829 e280 992e 2020 4b45 590a 2020 2020  ()....  KEY.    
│ │ │ │ -00020a90: 2063 6f6e 7461 696e 7320 6120 6e65 776c   contains a newl
│ │ │ │ -00020aa0: 7920 616c 6c6f 6361 7465 6420 7374 7275  y allocated stru
│ │ │ │ -00020ab0: 6374 7572 6520 6f6e 6c79 2069 6620 7468  cture only if th
│ │ │ │ -00020ac0: 6973 2066 756e 6374 696f 6e20 6973 0a20  is function is. 
│ │ │ │ -00020ad0: 2020 2020 7375 6363 6573 7366 756c 2e0a      successful..
│ │ │ │ -00020ae0: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ -00020af0: 6c75 653a 2a20 5265 7475 726e 7320 5348  lue:* Returns SH
│ │ │ │ -00020b00: 4953 4849 5f4f 4b20 6966 6620 7375 6363  ISHI_OK iff succ
│ │ │ │ -00020b10: 6573 7366 756c 2e0a 0a73 6869 7368 695f  essful...shishi_
│ │ │ │ -00020b20: 6b65 795f 6672 6f6d 5f6e 616d 650a 2d2d  key_from_name.--
│ │ │ │ +0001fd20: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ +0001fd30: 3a20 696e 7420 7368 6973 6869 5f6b 6579  : int shishi_key
│ │ │ │ +0001fd40: 5f66 726f 6d5f 7661 6c75 6520 2853 6869  _from_value (Shi
│ │ │ │ +0001fd50: 7368 6920 2a20 4841 4e44 4c45 2c20 696e  shi * HANDLE, in
│ │ │ │ +0001fd60: 7433 325f 7420 5459 5045 2c0a 2020 2020  t32_t TYPE,.    
│ │ │ │ +0001fd70: 2020 2020 2020 636f 6e73 7420 6368 6172        const char
│ │ │ │ +0001fd80: 202a 2056 414c 5545 2c20 5368 6973 6869   * VALUE, Shishi
│ │ │ │ +0001fd90: 5f6b 6579 202a 2a20 4b45 5929 0a20 2020  _key ** KEY).   
│ │ │ │ +0001fda0: 2020 4841 4e44 4c45 3a20 5368 6973 6869    HANDLE: Shishi
│ │ │ │ +0001fdb0: 206c 6962 7261 7279 2068 616e 646c 6520   library handle 
│ │ │ │ +0001fdc0: 6372 6561 7465 2062 7920 e280 9873 6869  create by ...shi
│ │ │ │ +0001fdd0: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ +0001fde0: 2020 2020 5459 5045 3a20 7479 7065 206f      TYPE: type o
│ │ │ │ +0001fdf0: 6620 6b65 792e 0a20 2020 2020 5641 4c55  f key..     VALU
│ │ │ │ +0001fe00: 453a 2069 6e70 7574 2061 7272 6179 2077  E: input array w
│ │ │ │ +0001fe10: 6974 6820 6b65 7920 7661 6c75 652c 206f  ith key value, o
│ │ │ │ +0001fe20: 7220 4e55 4c4c 2e0a 2020 2020 204b 4559  r NULL..     KEY
│ │ │ │ +0001fe30: 3a20 706f 696e 7465 7220 746f 2073 7472  : pointer to str
│ │ │ │ +0001fe40: 7563 7475 7265 2074 6861 7420 7769 6c6c  ucture that will
│ │ │ │ +0001fe50: 2068 6f6c 6420 6e65 776c 7920 6372 6561   hold newly crea
│ │ │ │ +0001fe60: 7465 6420 6b65 790a 2020 2020 2069 6e66  ted key.     inf
│ │ │ │ +0001fe70: 6f72 6d61 7469 6f6e 0a0a 2020 2020 202a  ormation..     *
│ │ │ │ +0001fe80: 4465 7363 7269 7074 696f 6e3a 2a20 4372  Description:* Cr
│ │ │ │ +0001fe90: 6561 7465 2061 206e 6577 204b 6579 2069  eate a new Key i
│ │ │ │ +0001fea0: 6e66 6f72 6d61 7469 6f6e 2073 7472 7563  nformation struc
│ │ │ │ +0001feb0: 7475 7265 2c20 616e 6420 7365 7420 7468  ture, and set th
│ │ │ │ +0001fec0: 650a 2020 2020 206b 6579 2074 7970 6520  e.     key type 
│ │ │ │ +0001fed0: 616e 6420 6b65 7920 7661 6c75 652e 2020  and key value.  
│ │ │ │ +0001fee0: 4b45 5920 636f 6e74 6169 6e73 2061 206e  KEY contains a n
│ │ │ │ +0001fef0: 6577 6c79 2061 6c6c 6f63 6174 6564 2073  ewly allocated s
│ │ │ │ +0001ff00: 7472 7563 7475 7265 0a20 2020 2020 6f6e  tructure.     on
│ │ │ │ +0001ff10: 6c79 2069 6620 7468 6973 2066 756e 6374  ly if this funct
│ │ │ │ +0001ff20: 696f 6e20 6973 2073 7563 6365 7373 6675  ion is successfu
│ │ │ │ +0001ff30: 6c2e 0a0a 2020 2020 202a 5265 7475 726e  l...     *Return
│ │ │ │ +0001ff40: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ +0001ff50: 2053 4849 5348 495f 4f4b 2069 6666 2073   SHISHI_OK iff s
│ │ │ │ +0001ff60: 7563 6365 7373 6675 6c2e 0a0a 7368 6973  uccessful...shis
│ │ │ │ +0001ff70: 6869 5f6b 6579 5f66 726f 6d5f 6261 7365  hi_key_from_base
│ │ │ │ +0001ff80: 3634 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  64.-------------
│ │ │ │ +0001ff90: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +0001ffa0: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ +0001ffb0: 7368 695f 6b65 795f 6672 6f6d 5f62 6173  shi_key_from_bas
│ │ │ │ +0001ffc0: 6536 3420 2853 6869 7368 6920 2a20 4841  e64 (Shishi * HA
│ │ │ │ +0001ffd0: 4e44 4c45 2c20 696e 7433 325f 7420 5459  NDLE, int32_t TY
│ │ │ │ +0001ffe0: 5045 2c0a 2020 2020 2020 2020 2020 636f  PE,.          co
│ │ │ │ +0001fff0: 6e73 7420 6368 6172 202a 2056 414c 5545  nst char * VALUE
│ │ │ │ +00020000: 2c20 5368 6973 6869 5f6b 6579 202a 2a20  , Shishi_key ** 
│ │ │ │ +00020010: 4b45 5929 0a20 2020 2020 4841 4e44 4c45  KEY).     HANDLE
│ │ │ │ +00020020: 3a20 5368 6973 6869 206c 6962 7261 7279  : Shishi library
│ │ │ │ +00020030: 2068 616e 646c 6520 6372 6561 7465 2062   handle create b
│ │ │ │ +00020040: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ +00020050: 2829 e280 992e 0a20 2020 2020 5459 5045  ().....     TYPE
│ │ │ │ +00020060: 3a20 7479 7065 206f 6620 6b65 792e 0a20  : type of key.. 
│ │ │ │ +00020070: 2020 2020 5641 4c55 453a 2069 6e70 7574      VALUE: input
│ │ │ │ +00020080: 2073 7472 696e 6720 7769 7468 2062 6173   string with bas
│ │ │ │ +00020090: 6536 3420 656e 636f 6465 6420 6b65 7920  e64 encoded key 
│ │ │ │ +000200a0: 7661 6c75 652c 206f 7220 4e55 4c4c 2e0a  value, or NULL..
│ │ │ │ +000200b0: 2020 2020 204b 4559 3a20 706f 696e 7465       KEY: pointe
│ │ │ │ +000200c0: 7220 746f 2073 7472 7563 7475 7265 2074  r to structure t
│ │ │ │ +000200d0: 6861 7420 7769 6c6c 2068 6f6c 6420 6e65  hat will hold ne
│ │ │ │ +000200e0: 776c 7920 6372 6561 7465 6420 6b65 790a  wly created key.
│ │ │ │ +000200f0: 2020 2020 2069 6e66 6f72 6d61 7469 6f6e       information
│ │ │ │ +00020100: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ +00020110: 696f 6e3a 2a20 4372 6561 7465 2061 206e  ion:* Create a n
│ │ │ │ +00020120: 6577 204b 6579 2069 6e66 6f72 6d61 7469  ew Key informati
│ │ │ │ +00020130: 6f6e 2073 7472 7563 7475 7265 2c20 616e  on structure, an
│ │ │ │ +00020140: 6420 7365 7420 7468 650a 2020 2020 206b  d set the.     k
│ │ │ │ +00020150: 6579 2074 7970 6520 616e 6420 6b65 7920  ey type and key 
│ │ │ │ +00020160: 7661 6c75 652e 2020 4b45 5920 636f 6e74  value.  KEY cont
│ │ │ │ +00020170: 6169 6e73 2061 206e 6577 6c79 2061 6c6c  ains a newly all
│ │ │ │ +00020180: 6f63 6174 6564 2073 7472 7563 7475 7265  ocated structure
│ │ │ │ +00020190: 0a20 2020 2020 6f6e 6c79 2069 6620 7468  .     only if th
│ │ │ │ +000201a0: 6973 2066 756e 6374 696f 6e20 6973 2073  is function is s
│ │ │ │ +000201b0: 7563 6365 7373 6675 6c2e 0a0a 2020 2020  uccessful...    
│ │ │ │ +000201c0: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ +000201d0: 2052 6574 7572 6e73 2053 4849 5348 495f   Returns SHISHI_
│ │ │ │ +000201e0: 494e 5641 4c49 445f 4b45 5920 6966 2074  INVALID_KEY if t
│ │ │ │ +000201f0: 6865 2062 6173 6536 3420 656e 636f 6465  he base64 encode
│ │ │ │ +00020200: 640a 2020 2020 206b 6579 206c 656e 6774  d.     key lengt
│ │ │ │ +00020210: 6820 646f 6573 6e27 7420 6d61 7463 6820  h doesn't match 
│ │ │ │ +00020220: 7468 6520 6b65 7920 7479 7065 2c20 616e  the key type, an
│ │ │ │ +00020230: 6420 5348 4953 4849 5f4f 4b20 6f6e 2073  d SHISHI_OK on s
│ │ │ │ +00020240: 7563 6365 7373 2e0a 0a73 6869 7368 695f  uccess...shishi_
│ │ │ │ +00020250: 6b65 795f 7261 6e64 6f6d 0a2d 2d2d 2d2d  key_random.-----
│ │ │ │ +00020260: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ +00020270: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ +00020280: 7368 6973 6869 5f6b 6579 5f72 616e 646f  shishi_key_rando
│ │ │ │ +00020290: 6d20 2853 6869 7368 6920 2a20 4841 4e44  m (Shishi * HAND
│ │ │ │ +000202a0: 4c45 2c20 696e 7433 325f 7420 5459 5045  LE, int32_t TYPE
│ │ │ │ +000202b0: 2c0a 2020 2020 2020 2020 2020 5368 6973  ,.          Shis
│ │ │ │ +000202c0: 6869 5f6b 6579 202a 2a20 4b45 5929 0a20  hi_key ** KEY). 
│ │ │ │ +000202d0: 2020 2020 4841 4e44 4c45 3a20 5368 6973      HANDLE: Shis
│ │ │ │ +000202e0: 6869 206c 6962 7261 7279 2068 616e 646c  hi library handl
│ │ │ │ +000202f0: 6520 6372 6561 7465 2062 7920 e280 9873  e create by ...s
│ │ │ │ +00020300: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ +00020310: 0a20 2020 2020 5459 5045 3a20 7479 7065  .     TYPE: type
│ │ │ │ +00020320: 206f 6620 6b65 792e 0a20 2020 2020 4b45   of key..     KE
│ │ │ │ +00020330: 593a 2070 6f69 6e74 6572 2074 6f20 7374  Y: pointer to st
│ │ │ │ +00020340: 7275 6374 7572 6520 7468 6174 2077 696c  ructure that wil
│ │ │ │ +00020350: 6c20 686f 6c64 206e 6577 6c79 2063 7265  l hold newly cre
│ │ │ │ +00020360: 6174 6564 206b 6579 0a20 2020 2020 696e  ated key.     in
│ │ │ │ +00020370: 666f 726d 6174 696f 6e0a 0a20 2020 2020  formation..     
│ │ │ │ +00020380: 2a44 6573 6372 6970 7469 6f6e 3a2a 2043  *Description:* C
│ │ │ │ +00020390: 7265 6174 6520 6120 6e65 7720 4b65 7920  reate a new Key 
│ │ │ │ +000203a0: 696e 666f 726d 6174 696f 6e20 7374 7275  information stru
│ │ │ │ +000203b0: 6374 7572 6520 666f 7220 7468 6520 6b65  cture for the ke
│ │ │ │ +000203c0: 790a 2020 2020 2074 7970 6520 616e 6420  y.     type and 
│ │ │ │ +000203d0: 736f 6d65 2072 616e 646f 6d20 6461 7461  some random data
│ │ │ │ +000203e0: 2e20 204b 4559 2063 6f6e 7461 696e 7320  .  KEY contains 
│ │ │ │ +000203f0: 6120 6e65 776c 7920 616c 6c6f 6361 7465  a newly allocate
│ │ │ │ +00020400: 640a 2020 2020 2073 7472 7563 7475 7265  d.     structure
│ │ │ │ +00020410: 206f 6e6c 7920 6966 2074 6869 7320 6675   only if this fu
│ │ │ │ +00020420: 6e63 7469 6f6e 2069 7320 7375 6363 6573  nction is succes
│ │ │ │ +00020430: 7366 756c 2e0a 0a20 2020 2020 2a52 6574  sful...     *Ret
│ │ │ │ +00020440: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ +00020450: 726e 7320 5348 4953 4849 5f4f 4b20 6966  rns SHISHI_OK if
│ │ │ │ +00020460: 6620 7375 6363 6573 7366 756c 2e0a 0a73  f successful...s
│ │ │ │ +00020470: 6869 7368 695f 6b65 795f 6672 6f6d 5f72  hishi_key_from_r
│ │ │ │ +00020480: 616e 646f 6d0a 2d2d 2d2d 2d2d 2d2d 2d2d  andom.----------
│ │ │ │ +00020490: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ +000204a0: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ +000204b0: 7368 6973 6869 5f6b 6579 5f66 726f 6d5f  shishi_key_from_
│ │ │ │ +000204c0: 7261 6e64 6f6d 2028 5368 6973 6869 202a  random (Shishi *
│ │ │ │ +000204d0: 2048 414e 444c 452c 2069 6e74 3332 5f74   HANDLE, int32_t
│ │ │ │ +000204e0: 2054 5950 452c 0a20 2020 2020 2020 2020   TYPE,.         
│ │ │ │ +000204f0: 2063 6f6e 7374 2063 6861 7220 2a20 524e   const char * RN
│ │ │ │ +00020500: 442c 2073 697a 655f 7420 524e 444c 454e  D, size_t RNDLEN
│ │ │ │ +00020510: 2c20 5368 6973 6869 5f6b 6579 202a 2a20  , Shishi_key ** 
│ │ │ │ +00020520: 4f55 544b 4559 290a 2020 2020 2048 414e  OUTKEY).     HAN
│ │ │ │ +00020530: 444c 453a 2053 6869 7368 6920 6c69 6272  DLE: Shishi libr
│ │ │ │ +00020540: 6172 7920 6861 6e64 6c65 2063 7265 6174  ary handle creat
│ │ │ │ +00020550: 6520 6279 20e2 8098 7368 6973 6869 5f69  e by ...shishi_i
│ │ │ │ +00020560: 6e69 7428 29e2 8099 2e0a 2020 2020 2054  nit().....     T
│ │ │ │ +00020570: 5950 453a 2074 7970 6520 6f66 206b 6579  YPE: type of key
│ │ │ │ +00020580: 2e0a 2020 2020 2052 4e44 3a20 7261 6e64  ..     RND: rand
│ │ │ │ +00020590: 6f6d 2064 6174 612e 0a20 2020 2020 524e  om data..     RN
│ │ │ │ +000205a0: 444c 454e 3a20 6c65 6e67 7468 206f 6620  DLEN: length of 
│ │ │ │ +000205b0: 7261 6e64 6f6d 2064 6174 612e 0a20 2020  random data..   
│ │ │ │ +000205c0: 2020 4f55 544b 4559 3a20 706f 696e 7465    OUTKEY: pointe
│ │ │ │ +000205d0: 7220 746f 2073 7472 7563 7475 7265 2074  r to structure t
│ │ │ │ +000205e0: 6861 7420 7769 6c6c 2068 6f6c 6420 6e65  hat will hold ne
│ │ │ │ +000205f0: 776c 7920 6372 6561 7465 6420 6b65 790a  wly created key.
│ │ │ │ +00020600: 2020 2020 2069 6e66 6f72 6d61 7469 6f6e       information
│ │ │ │ +00020610: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ +00020620: 696f 6e3a 2a20 4372 6561 7465 2061 206e  ion:* Create a n
│ │ │ │ +00020630: 6577 204b 6579 2069 6e66 6f72 6d61 7469  ew Key informati
│ │ │ │ +00020640: 6f6e 2073 7472 7563 7475 7265 2c20 616e  on structure, an
│ │ │ │ +00020650: 6420 7365 7420 7468 650a 2020 2020 206b  d set the.     k
│ │ │ │ +00020660: 6579 2074 7970 6520 616e 6420 6b65 7920  ey type and key 
│ │ │ │ +00020670: 7661 6c75 6520 7573 696e 6720 e280 9873  value using ...s
│ │ │ │ +00020680: 6869 7368 695f 7261 6e64 6f6d 5f74 6f5f  hishi_random_to_
│ │ │ │ +00020690: 6b65 7928 29e2 8099 2e20 204b 4559 0a20  key()....  KEY. 
│ │ │ │ +000206a0: 2020 2020 636f 6e74 6169 6e73 2061 206e      contains a n
│ │ │ │ +000206b0: 6577 6c79 2061 6c6c 6f63 6174 6564 2073  ewly allocated s
│ │ │ │ +000206c0: 7472 7563 7475 7265 206f 6e6c 7920 6966  tructure only if
│ │ │ │ +000206d0: 2074 6869 7320 6675 6e63 7469 6f6e 2069   this function i
│ │ │ │ +000206e0: 730a 2020 2020 2073 7563 6365 7373 6675  s.     successfu
│ │ │ │ +000206f0: 6c2e 0a0a 2020 2020 202a 5265 7475 726e  l...     *Return
│ │ │ │ +00020700: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ +00020710: 2053 4849 5348 495f 4f4b 2069 6666 2073   SHISHI_OK iff s
│ │ │ │ +00020720: 7563 6365 7373 6675 6c2e 0a0a 7368 6973  uccessful...shis
│ │ │ │ +00020730: 6869 5f6b 6579 5f66 726f 6d5f 7374 7269  hi_key_from_stri
│ │ │ │ +00020740: 6e67 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ng.-------------
│ │ │ │ +00020750: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +00020760: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ +00020770: 7368 695f 6b65 795f 6672 6f6d 5f73 7472  shi_key_from_str
│ │ │ │ +00020780: 696e 6720 2853 6869 7368 6920 2a20 4841  ing (Shishi * HA
│ │ │ │ +00020790: 4e44 4c45 2c20 696e 7433 325f 7420 5459  NDLE, int32_t TY
│ │ │ │ +000207a0: 5045 2c0a 2020 2020 2020 2020 2020 636f  PE,.          co
│ │ │ │ +000207b0: 6e73 7420 6368 6172 202a 2050 4153 5357  nst char * PASSW
│ │ │ │ +000207c0: 4f52 442c 2073 697a 655f 7420 5041 5353  ORD, size_t PASS
│ │ │ │ +000207d0: 574f 5244 4c45 4e2c 2063 6f6e 7374 2063  WORDLEN, const c
│ │ │ │ +000207e0: 6861 7220 2a20 5341 4c54 2c0a 2020 2020  har * SALT,.    
│ │ │ │ +000207f0: 2020 2020 2020 7369 7a65 5f74 2053 414c        size_t SAL
│ │ │ │ +00020800: 544c 454e 2c20 636f 6e73 7420 6368 6172  TLEN, const char
│ │ │ │ +00020810: 202a 2050 4152 414d 4554 4552 2c20 5368   * PARAMETER, Sh
│ │ │ │ +00020820: 6973 6869 5f6b 6579 202a 2a20 4f55 544b  ishi_key ** OUTK
│ │ │ │ +00020830: 4559 290a 2020 2020 2048 414e 444c 453a  EY).     HANDLE:
│ │ │ │ +00020840: 2053 6869 7368 6920 6c69 6272 6172 7920   Shishi library 
│ │ │ │ +00020850: 6861 6e64 6c65 2063 7265 6174 6520 6279  handle create by
│ │ │ │ +00020860: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ +00020870: 29e2 8099 2e0a 2020 2020 2054 5950 453a  ).....     TYPE:
│ │ │ │ +00020880: 2074 7970 6520 6f66 206b 6579 2e0a 2020   type of key..  
│ │ │ │ +00020890: 2020 2050 4153 5357 4f52 443a 2069 6e70     PASSWORD: inp
│ │ │ │ +000208a0: 7574 2061 7272 6179 2063 6f6e 7461 696e  ut array contain
│ │ │ │ +000208b0: 696e 6720 7061 7373 776f 7264 2e0a 2020  ing password..  
│ │ │ │ +000208c0: 2020 2050 4153 5357 4f52 444c 454e 3a20     PASSWORDLEN: 
│ │ │ │ +000208d0: 6c65 6e67 7468 206f 6620 696e 7075 7420  length of input 
│ │ │ │ +000208e0: 6172 7261 7920 636f 6e74 6169 6e69 6e67  array containing
│ │ │ │ +000208f0: 2070 6173 7377 6f72 642e 0a20 2020 2020   password..     
│ │ │ │ +00020900: 5341 4c54 3a20 696e 7075 7420 6172 7261  SALT: input arra
│ │ │ │ +00020910: 7920 636f 6e74 6169 6e69 6e67 2073 616c  y containing sal
│ │ │ │ +00020920: 742e 0a20 2020 2020 5341 4c54 4c45 4e3a  t..     SALTLEN:
│ │ │ │ +00020930: 206c 656e 6774 6820 6f66 2069 6e70 7574   length of input
│ │ │ │ +00020940: 2061 7272 6179 2063 6f6e 7461 696e 696e   array containin
│ │ │ │ +00020950: 6720 7361 6c74 2e0a 2020 2020 2050 4152  g salt..     PAR
│ │ │ │ +00020960: 414d 4554 4552 3a20 696e 7075 7420 6172  AMETER: input ar
│ │ │ │ +00020970: 7261 7920 7769 7468 206f 7061 7175 6520  ray with opaque 
│ │ │ │ +00020980: 656e 6372 7970 7469 6f6e 2074 7970 6520  encryption type 
│ │ │ │ +00020990: 7370 6563 6966 6963 0a20 2020 2020 696e  specific.     in
│ │ │ │ +000209a0: 666f 726d 6174 696f 6e2e 0a20 2020 2020  formation..     
│ │ │ │ +000209b0: 4f55 544b 4559 3a20 706f 696e 7465 7220  OUTKEY: pointer 
│ │ │ │ +000209c0: 746f 2073 7472 7563 7475 7265 2074 6861  to structure tha
│ │ │ │ +000209d0: 7420 7769 6c6c 2068 6f6c 6420 6e65 776c  t will hold newl
│ │ │ │ +000209e0: 7920 6372 6561 7465 6420 6b65 790a 2020  y created key.  
│ │ │ │ +000209f0: 2020 2069 6e66 6f72 6d61 7469 6f6e 0a0a     information..
│ │ │ │ +00020a00: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ +00020a10: 6e3a 2a20 4372 6561 7465 2061 206e 6577  n:* Create a new
│ │ │ │ +00020a20: 204b 6579 2069 6e66 6f72 6d61 7469 6f6e   Key information
│ │ │ │ +00020a30: 2073 7472 7563 7475 7265 2c20 616e 6420   structure, and 
│ │ │ │ +00020a40: 7365 7420 7468 650a 2020 2020 206b 6579  set the.     key
│ │ │ │ +00020a50: 2074 7970 6520 616e 6420 6b65 7920 7661   type and key va
│ │ │ │ +00020a60: 6c75 6520 7573 696e 6720 e280 9873 6869  lue using ...shi
│ │ │ │ +00020a70: 7368 695f 7374 7269 6e67 5f74 6f5f 6b65  shi_string_to_ke
│ │ │ │ +00020a80: 7928 29e2 8099 2e20 204b 4559 0a20 2020  y()....  KEY.   
│ │ │ │ +00020a90: 2020 636f 6e74 6169 6e73 2061 206e 6577    contains a new
│ │ │ │ +00020aa0: 6c79 2061 6c6c 6f63 6174 6564 2073 7472  ly allocated str
│ │ │ │ +00020ab0: 7563 7475 7265 206f 6e6c 7920 6966 2074  ucture only if t
│ │ │ │ +00020ac0: 6869 7320 6675 6e63 7469 6f6e 2069 730a  his function is.
│ │ │ │ +00020ad0: 2020 2020 2073 7563 6365 7373 6675 6c2e       successful.
│ │ │ │ +00020ae0: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ +00020af0: 616c 7565 3a2a 2052 6574 7572 6e73 2053  alue:* Returns S
│ │ │ │ +00020b00: 4849 5348 495f 4f4b 2069 6666 2073 7563  HISHI_OK iff suc
│ │ │ │ +00020b10: 6365 7373 6675 6c2e 0a0a 7368 6973 6869  cessful...shishi
│ │ │ │ +00020b20: 5f6b 6579 5f66 726f 6d5f 6e61 6d65 0a2d  _key_from_name.-
│ │ │ │  00020b30: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00020b40: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ -00020b50: 3a20 696e 7420 7368 6973 6869 5f6b 6579  : int shishi_key
│ │ │ │ -00020b60: 5f66 726f 6d5f 6e61 6d65 2028 5368 6973  _from_name (Shis
│ │ │ │ -00020b70: 6869 202a 2048 414e 444c 452c 2069 6e74  hi * HANDLE, int
│ │ │ │ -00020b80: 3332 5f74 2054 5950 452c 0a20 2020 2020  32_t TYPE,.     
│ │ │ │ -00020b90: 2020 2020 2063 6f6e 7374 2063 6861 7220       const char 
│ │ │ │ -00020ba0: 2a20 4e41 4d45 2c20 636f 6e73 7420 6368  * NAME, const ch
│ │ │ │ -00020bb0: 6172 202a 2050 4153 5357 4f52 442c 2073  ar * PASSWORD, s
│ │ │ │ -00020bc0: 697a 655f 7420 5041 5353 574f 5244 4c45  ize_t PASSWORDLE
│ │ │ │ -00020bd0: 4e2c 0a20 2020 2020 2020 2020 2063 6f6e  N,.          con
│ │ │ │ -00020be0: 7374 2063 6861 7220 2a20 5041 5241 4d45  st char * PARAME
│ │ │ │ -00020bf0: 5445 522c 2053 6869 7368 695f 6b65 7920  TER, Shishi_key 
│ │ │ │ -00020c00: 2a2a 204f 5554 4b45 5929 0a20 2020 2020  ** OUTKEY).     
│ │ │ │ -00020c10: 4841 4e44 4c45 3a20 5368 6973 6869 206c  HANDLE: Shishi l
│ │ │ │ -00020c20: 6962 7261 7279 2068 616e 646c 6520 6372  ibrary handle cr
│ │ │ │ -00020c30: 6561 7465 2062 7920 e280 9873 6869 7368  eate by ...shish
│ │ │ │ -00020c40: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ -00020c50: 2020 5459 5045 3a20 7479 7065 206f 6620    TYPE: type of 
│ │ │ │ -00020c60: 6b65 792e 0a20 2020 2020 4e41 4d45 3a20  key..     NAME: 
│ │ │ │ -00020c70: 7072 696e 6369 7061 6c20 6e61 6d65 206f  principal name o
│ │ │ │ -00020c80: 6620 7573 6572 2e0a 2020 2020 2050 4153  f user..     PAS
│ │ │ │ -00020c90: 5357 4f52 443a 2069 6e70 7574 2061 7272  SWORD: input arr
│ │ │ │ -00020ca0: 6179 2063 6f6e 7461 696e 696e 6720 7061  ay containing pa
│ │ │ │ -00020cb0: 7373 776f 7264 2e0a 2020 2020 2050 4153  ssword..     PAS
│ │ │ │ -00020cc0: 5357 4f52 444c 454e 3a20 6c65 6e67 7468  SWORDLEN: length
│ │ │ │ -00020cd0: 206f 6620 696e 7075 7420 6172 7261 7920   of input array 
│ │ │ │ -00020ce0: 636f 6e74 6169 6e69 6e67 2070 6173 7377  containing passw
│ │ │ │ -00020cf0: 6f72 642e 0a20 2020 2020 5041 5241 4d45  ord..     PARAME
│ │ │ │ -00020d00: 5445 523a 2069 6e70 7574 2061 7272 6179  TER: input array
│ │ │ │ -00020d10: 2077 6974 6820 6f70 6171 7565 2065 6e63   with opaque enc
│ │ │ │ -00020d20: 7279 7074 696f 6e20 7479 7065 2073 7065  ryption type spe
│ │ │ │ -00020d30: 6369 6669 630a 2020 2020 2069 6e66 6f72  cific.     infor
│ │ │ │ -00020d40: 6d61 7469 6f6e 2e0a 2020 2020 204f 5554  mation..     OUT
│ │ │ │ -00020d50: 4b45 593a 2070 6f69 6e74 6572 2074 6f20  KEY: pointer to 
│ │ │ │ -00020d60: 7374 7275 6374 7572 6520 7468 6174 2077  structure that w
│ │ │ │ -00020d70: 696c 6c20 686f 6c64 206e 6577 6c79 2063  ill hold newly c
│ │ │ │ -00020d80: 7265 6174 6564 206b 6579 0a20 2020 2020  reated key.     
│ │ │ │ -00020d90: 696e 666f 726d 6174 696f 6e0a 0a20 2020  information..   
│ │ │ │ -00020da0: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ -00020db0: 2043 7265 6174 6520 6120 6e65 7720 4b65   Create a new Ke
│ │ │ │ -00020dc0: 7920 696e 666f 726d 6174 696f 6e20 7374  y information st
│ │ │ │ -00020dd0: 7275 6374 7572 652c 2061 6e64 2064 6572  ructure, and der
│ │ │ │ -00020de0: 6976 650a 2020 2020 2074 6865 206b 6579  ive.     the key
│ │ │ │ -00020df0: 2066 726f 6d20 7072 696e 6369 7061 6c20   from principal 
│ │ │ │ -00020e00: 6e61 6d65 2061 6e64 2070 6173 7377 6f72  name and passwor
│ │ │ │ -00020e10: 6420 7573 696e 670a 2020 2020 20e2 8098  d using.     ...
│ │ │ │ -00020e20: 7368 6973 6869 5f6b 6579 5f66 726f 6d5f  shishi_key_from_
│ │ │ │ -00020e30: 6e61 6d65 2829 e280 992e 2020 5468 6520  name()....  The 
│ │ │ │ -00020e40: 7361 6c74 2069 7320 6465 7269 7665 6420  salt is derived 
│ │ │ │ -00020e50: 6672 6f6d 2074 6865 2070 7269 6e63 6970  from the princip
│ │ │ │ -00020e60: 616c 0a20 2020 2020 6e61 6d65 2062 7920  al.     name by 
│ │ │ │ -00020e70: 636f 6e63 6174 656e 6174 696e 6720 7468  concatenating th
│ │ │ │ -00020e80: 6520 6465 636f 6465 6420 7265 616c 6d20  e decoded realm 
│ │ │ │ -00020e90: 616e 6420 7072 696e 6369 7061 6c2e 0a0a  and principal...
│ │ │ │ -00020ea0: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ -00020eb0: 7565 3a2a 2052 6574 7572 6e73 2053 4849  ue:* Returns SHI
│ │ │ │ -00020ec0: 5348 495f 4f4b 2069 6666 2073 7563 6365  SHI_OK iff succe
│ │ │ │ -00020ed0: 7373 6675 6c2e 0a0a 2020 2041 7070 6c69  ssful...   Appli
│ │ │ │ -00020ee0: 6361 7469 6f6e 7320 7468 6174 2072 756e  cations that run
│ │ │ │ -00020ef0: 2075 6e69 6e74 6572 6163 7469 7665 6c79   uninteractively
│ │ │ │ -00020f00: 206d 6179 206e 6565 6420 6b65 7969 6e67   may need keying
│ │ │ │ -00020f10: 206d 6174 6572 6961 6c2e 2020 496e 0a74   material.  In.t
│ │ │ │ -00020f20: 6865 7365 2063 6173 6573 2c20 7468 6520  hese cases, the 
│ │ │ │ -00020f30: 6b65 7973 2061 7265 2073 746f 7265 6420  keys are stored 
│ │ │ │ -00020f40: 696e 2061 2066 696c 652c 2061 2066 696c  in a file, a fil
│ │ │ │ -00020f50: 6520 7468 6174 2069 7320 6e6f 726d 616c  e that is normal
│ │ │ │ -00020f60: 6c79 0a73 746f 7265 6420 6f6e 2074 6865  ly.stored on the
│ │ │ │ -00020f70: 206c 6f63 616c 2068 6f73 742e 2020 5468   local host.  Th
│ │ │ │ -00020f80: 6520 6669 6c65 2073 686f 756c 6420 6265  e file should be
│ │ │ │ -00020f90: 2070 726f 7465 6374 6564 2066 726f 6d0a   protected from.
│ │ │ │ -00020fa0: 756e 6175 7468 6f72 697a 6564 2061 6363  unauthorized acc
│ │ │ │ -00020fb0: 6573 732e 2020 5468 6520 6669 6c65 2069  ess.  The file i
│ │ │ │ -00020fc0: 7320 696e 2041 5343 4949 2066 6f72 6d61  s in ASCII forma
│ │ │ │ -00020fd0: 7420 616e 6420 636f 6e74 6169 6e73 206b  t and contains k
│ │ │ │ -00020fe0: 6579 7320 6173 0a6f 7574 7075 7465 6420  eys as.outputed 
│ │ │ │ -00020ff0: 6279 20e2 8098 7368 6973 6869 5f6b 6579  by ...shishi_key
│ │ │ │ -00021000: 5f70 7269 6e74 e280 992e 2020 416c 6c20  _print....  All 
│ │ │ │ -00021010: 6675 6e63 7469 6f6e 7320 7468 6174 2068  functions that h
│ │ │ │ -00021020: 616e 646c 6520 7468 6573 6520 6b65 7973  andle these keys
│ │ │ │ -00021030: 0a73 6574 7320 6172 6520 6465 7363 7269  .sets are descri
│ │ │ │ -00021040: 6265 6420 6e6f 772e 0a0a 7368 6973 6869  bed now...shishi
│ │ │ │ -00021050: 5f6b 6579 730a 2d2d 2d2d 2d2d 2d2d 2d2d  _keys.----------
│ │ │ │ -00021060: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ -00021070: 2069 6e74 2073 6869 7368 695f 6b65 7973   int shishi_keys
│ │ │ │ -00021080: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ -00021090: 452c 2053 6869 7368 695f 6b65 7973 202a  E, Shishi_keys *
│ │ │ │ -000210a0: 2a20 4b45 5953 290a 2020 2020 2048 414e  * KEYS).     HAN
│ │ │ │ -000210b0: 444c 453a 2073 6869 7368 6920 6861 6e64  DLE: shishi hand
│ │ │ │ -000210c0: 6c65 2061 7320 616c 6c6f 6361 7465 6420  le as allocated 
│ │ │ │ -000210d0: 6279 20e2 8098 7368 6973 6869 5f69 6e69  by ...shishi_ini
│ │ │ │ -000210e0: 7428 29e2 8099 2e0a 2020 2020 204b 4559  t().....     KEY
│ │ │ │ -000210f0: 533a 206f 7574 7075 7420 706f 696e 7465  S: output pointe
│ │ │ │ -00021100: 7220 746f 206e 6577 6c79 2061 6c6c 6f63  r to newly alloc
│ │ │ │ -00021110: 6174 6564 206b 6579 7320 6861 6e64 6c65  ated keys handle
│ │ │ │ -00021120: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ -00021130: 7469 6f6e 3a2a 2047 6574 2061 206e 6577  tion:* Get a new
│ │ │ │ -00021140: 206b 6579 2073 6574 2068 616e 646c 652e   key set handle.
│ │ │ │ -00021150: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ -00021160: 616c 7565 3a2a 2052 6574 7572 6e73 20e2  alue:* Returns .
│ │ │ │ -00021170: 8098 5348 4953 4849 5f4f 4be2 8099 2069  ..SHISHI_OK... i
│ │ │ │ -00021180: 6666 2073 7563 6365 7373 6675 6c2e 0a0a  ff successful...
│ │ │ │ -00021190: 7368 6973 6869 5f6b 6579 735f 646f 6e65  shishi_keys_done
│ │ │ │ -000211a0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ -000211b0: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ -000211c0: 2076 6f69 6420 7368 6973 6869 5f6b 6579   void shishi_key
│ │ │ │ -000211d0: 735f 646f 6e65 2028 5368 6973 6869 5f6b  s_done (Shishi_k
│ │ │ │ -000211e0: 6579 7320 2a2a 204b 4559 5329 0a20 2020  eys ** KEYS).   
│ │ │ │ -000211f0: 2020 4b45 5953 3a20 6b65 7920 7365 7420    KEYS: key set 
│ │ │ │ -00021200: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ -00021210: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ -00021220: 5f6b 6579 7328 29e2 8099 2e0a 0a20 2020  _keys()......   
│ │ │ │ -00021230: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ -00021240: 2044 6561 6c6c 6f63 6174 6573 2061 6c6c   Deallocates all
│ │ │ │ -00021250: 2072 6573 6f75 7263 6573 2061 7373 6f63   resources assoc
│ │ │ │ -00021260: 6961 7465 6420 7769 7468 206b 6579 2073  iated with key s
│ │ │ │ -00021270: 6574 2e0a 2020 2020 2054 6865 206b 6579  et..     The key
│ │ │ │ -00021280: 2073 6574 2068 616e 646c 6520 6d75 7374   set handle must
│ │ │ │ -00021290: 206e 6f74 2062 6520 7573 6564 2069 6e20   not be used in 
│ │ │ │ -000212a0: 6361 6c6c 7320 746f 206f 7468 6572 0a20  calls to other. 
│ │ │ │ -000212b0: 2020 2020 7368 6973 6869 5f6b 6579 735f      shishi_keys_
│ │ │ │ -000212c0: 2a28 2920 6675 6e63 7469 6f6e 7320 6166  *() functions af
│ │ │ │ -000212d0: 7465 7220 7468 6973 2e0a 0a73 6869 7368  ter this...shish
│ │ │ │ -000212e0: 695f 6b65 7973 5f73 697a 650a 2d2d 2d2d  i_keys_size.----
│ │ │ │ -000212f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ -00021300: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ -00021310: 7368 6973 6869 5f6b 6579 735f 7369 7a65  shishi_keys_size
│ │ │ │ -00021320: 2028 5368 6973 6869 5f6b 6579 7320 2a20   (Shishi_keys * 
│ │ │ │ -00021330: 4b45 5953 290a 2020 2020 204b 4559 533a  KEYS).     KEYS:
│ │ │ │ -00021340: 206b 6579 2073 6574 2068 616e 646c 6520   key set handle 
│ │ │ │ -00021350: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ -00021360: e280 9873 6869 7368 695f 6b65 7973 2829  ...shishi_keys()
│ │ │ │ -00021370: e280 992e 0a0a 2020 2020 202a 4465 7363  ......     *Desc
│ │ │ │ -00021380: 7269 7074 696f 6e3a 2a20 4765 7420 7369  ription:* Get si
│ │ │ │ -00021390: 7a65 206f 6620 6b65 7920 7365 742e 0a0a  ze of key set...
│ │ │ │ -000213a0: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ -000213b0: 7565 3a2a 2052 6574 7572 6e73 206e 756d  ue:* Returns num
│ │ │ │ -000213c0: 6265 7220 6f66 206b 6579 7320 7374 6f72  ber of keys stor
│ │ │ │ -000213d0: 6564 2069 6e20 6b65 7920 7365 742e 0a0a  ed in key set...
│ │ │ │ -000213e0: 7368 6973 6869 5f6b 6579 735f 6e74 680a  shishi_keys_nth.
│ │ │ │ -000213f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -00021400: 0a20 2d2d 2046 756e 6374 696f 6e3a 2063  . -- Function: c
│ │ │ │ -00021410: 6f6e 7374 2053 6869 7368 695f 6b65 7920  onst Shishi_key 
│ │ │ │ -00021420: 2a20 7368 6973 6869 5f6b 6579 735f 6e74  * shishi_keys_nt
│ │ │ │ -00021430: 6820 2853 6869 7368 695f 6b65 7973 202a  h (Shishi_keys *
│ │ │ │ -00021440: 204b 4559 532c 0a20 2020 2020 2020 2020   KEYS,.         
│ │ │ │ -00021450: 2069 6e74 204b 4559 4e4f 290a 2020 2020   int KEYNO).    
│ │ │ │ -00021460: 204b 4559 533a 206b 6579 2073 6574 2068   KEYS: key set h
│ │ │ │ -00021470: 616e 646c 6520 6173 2061 6c6c 6f63 6174  andle as allocat
│ │ │ │ -00021480: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ -00021490: 6b65 7973 2829 e280 992e 0a20 2020 2020  keys().....     
│ │ │ │ -000214a0: 4b45 594e 4f3a 2069 6e74 6567 6572 2069  KEYNO: integer i
│ │ │ │ -000214b0: 6e64 6963 6174 696e 6720 7265 7175 6573  ndicating reques
│ │ │ │ -000214c0: 7465 6420 6b65 7920 696e 206b 6579 2073  ted key in key s
│ │ │ │ -000214d0: 6574 2e0a 0a20 2020 2020 2a47 6574 2074  et...     *Get t
│ │ │ │ -000214e0: 6865 206e 3a2a 2074 6820 7469 636b 6574  he n:* th ticket
│ │ │ │ -000214f0: 2069 6e20 6b65 7920 7365 742e 0a0a 2020   in key set...  
│ │ │ │ -00021500: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ -00021510: 3a2a 2052 6574 7572 6e73 2061 206b 6579  :* Returns a key
│ │ │ │ -00021520: 2068 616e 646c 6520 746f 2074 6865 206b   handle to the k
│ │ │ │ -00021530: 6579 6e6f 3a74 6820 6b65 7920 696e 2074  eyno:th key in t
│ │ │ │ -00021540: 6865 206b 6579 0a20 2020 2020 7365 742c  he key.     set,
│ │ │ │ -00021550: 206f 7220 4e55 4c4c 2069 6620 4b45 5953   or NULL if KEYS
│ │ │ │ -00021560: 2069 7320 696e 7661 6c69 6420 6f72 204b   is invalid or K
│ │ │ │ -00021570: 4559 4e4f 2069 7320 6f75 7420 6f66 2062  EYNO is out of b
│ │ │ │ -00021580: 6f75 6e64 732e 2020 5468 650a 2020 2020  ounds.  The.    
│ │ │ │ -00021590: 2066 6972 7374 206b 6579 2069 7320 4b45   first key is KE
│ │ │ │ -000215a0: 594e 4f20 302c 2074 6865 2073 6563 6f6e  YNO 0, the secon
│ │ │ │ -000215b0: 6420 6b65 7920 4b45 594e 4f20 312c 2061  d key KEYNO 1, a
│ │ │ │ -000215c0: 6e64 2073 6f20 6f6e 2e0a 0a73 6869 7368  nd so on...shish
│ │ │ │ -000215d0: 695f 6b65 7973 5f72 656d 6f76 650a 2d2d  i_keys_remove.--
│ │ │ │ +00020b40: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ +00020b50: 6e3a 2069 6e74 2073 6869 7368 695f 6b65  n: int shishi_ke
│ │ │ │ +00020b60: 795f 6672 6f6d 5f6e 616d 6520 2853 6869  y_from_name (Shi
│ │ │ │ +00020b70: 7368 6920 2a20 4841 4e44 4c45 2c20 696e  shi * HANDLE, in
│ │ │ │ +00020b80: 7433 325f 7420 5459 5045 2c0a 2020 2020  t32_t TYPE,.    
│ │ │ │ +00020b90: 2020 2020 2020 636f 6e73 7420 6368 6172        const char
│ │ │ │ +00020ba0: 202a 204e 414d 452c 2063 6f6e 7374 2063   * NAME, const c
│ │ │ │ +00020bb0: 6861 7220 2a20 5041 5353 574f 5244 2c20  har * PASSWORD, 
│ │ │ │ +00020bc0: 7369 7a65 5f74 2050 4153 5357 4f52 444c  size_t PASSWORDL
│ │ │ │ +00020bd0: 454e 2c0a 2020 2020 2020 2020 2020 636f  EN,.          co
│ │ │ │ +00020be0: 6e73 7420 6368 6172 202a 2050 4152 414d  nst char * PARAM
│ │ │ │ +00020bf0: 4554 4552 2c20 5368 6973 6869 5f6b 6579  ETER, Shishi_key
│ │ │ │ +00020c00: 202a 2a20 4f55 544b 4559 290a 2020 2020   ** OUTKEY).    
│ │ │ │ +00020c10: 2048 414e 444c 453a 2053 6869 7368 6920   HANDLE: Shishi 
│ │ │ │ +00020c20: 6c69 6272 6172 7920 6861 6e64 6c65 2063  library handle c
│ │ │ │ +00020c30: 7265 6174 6520 6279 20e2 8098 7368 6973  reate by ...shis
│ │ │ │ +00020c40: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ +00020c50: 2020 2054 5950 453a 2074 7970 6520 6f66     TYPE: type of
│ │ │ │ +00020c60: 206b 6579 2e0a 2020 2020 204e 414d 453a   key..     NAME:
│ │ │ │ +00020c70: 2070 7269 6e63 6970 616c 206e 616d 6520   principal name 
│ │ │ │ +00020c80: 6f66 2075 7365 722e 0a20 2020 2020 5041  of user..     PA
│ │ │ │ +00020c90: 5353 574f 5244 3a20 696e 7075 7420 6172  SSWORD: input ar
│ │ │ │ +00020ca0: 7261 7920 636f 6e74 6169 6e69 6e67 2070  ray containing p
│ │ │ │ +00020cb0: 6173 7377 6f72 642e 0a20 2020 2020 5041  assword..     PA
│ │ │ │ +00020cc0: 5353 574f 5244 4c45 4e3a 206c 656e 6774  SSWORDLEN: lengt
│ │ │ │ +00020cd0: 6820 6f66 2069 6e70 7574 2061 7272 6179  h of input array
│ │ │ │ +00020ce0: 2063 6f6e 7461 696e 696e 6720 7061 7373   containing pass
│ │ │ │ +00020cf0: 776f 7264 2e0a 2020 2020 2050 4152 414d  word..     PARAM
│ │ │ │ +00020d00: 4554 4552 3a20 696e 7075 7420 6172 7261  ETER: input arra
│ │ │ │ +00020d10: 7920 7769 7468 206f 7061 7175 6520 656e  y with opaque en
│ │ │ │ +00020d20: 6372 7970 7469 6f6e 2074 7970 6520 7370  cryption type sp
│ │ │ │ +00020d30: 6563 6966 6963 0a20 2020 2020 696e 666f  ecific.     info
│ │ │ │ +00020d40: 726d 6174 696f 6e2e 0a20 2020 2020 4f55  rmation..     OU
│ │ │ │ +00020d50: 544b 4559 3a20 706f 696e 7465 7220 746f  TKEY: pointer to
│ │ │ │ +00020d60: 2073 7472 7563 7475 7265 2074 6861 7420   structure that 
│ │ │ │ +00020d70: 7769 6c6c 2068 6f6c 6420 6e65 776c 7920  will hold newly 
│ │ │ │ +00020d80: 6372 6561 7465 6420 6b65 790a 2020 2020  created key.    
│ │ │ │ +00020d90: 2069 6e66 6f72 6d61 7469 6f6e 0a0a 2020   information..  
│ │ │ │ +00020da0: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ +00020db0: 2a20 4372 6561 7465 2061 206e 6577 204b  * Create a new K
│ │ │ │ +00020dc0: 6579 2069 6e66 6f72 6d61 7469 6f6e 2073  ey information s
│ │ │ │ +00020dd0: 7472 7563 7475 7265 2c20 616e 6420 6465  tructure, and de
│ │ │ │ +00020de0: 7269 7665 0a20 2020 2020 7468 6520 6b65  rive.     the ke
│ │ │ │ +00020df0: 7920 6672 6f6d 2070 7269 6e63 6970 616c  y from principal
│ │ │ │ +00020e00: 206e 616d 6520 616e 6420 7061 7373 776f   name and passwo
│ │ │ │ +00020e10: 7264 2075 7369 6e67 0a20 2020 2020 e280  rd using.     ..
│ │ │ │ +00020e20: 9873 6869 7368 695f 6b65 795f 6672 6f6d  .shishi_key_from
│ │ │ │ +00020e30: 5f6e 616d 6528 29e2 8099 2e20 2054 6865  _name()....  The
│ │ │ │ +00020e40: 2073 616c 7420 6973 2064 6572 6976 6564   salt is derived
│ │ │ │ +00020e50: 2066 726f 6d20 7468 6520 7072 696e 6369   from the princi
│ │ │ │ +00020e60: 7061 6c0a 2020 2020 206e 616d 6520 6279  pal.     name by
│ │ │ │ +00020e70: 2063 6f6e 6361 7465 6e61 7469 6e67 2074   concatenating t
│ │ │ │ +00020e80: 6865 2064 6563 6f64 6564 2072 6561 6c6d  he decoded realm
│ │ │ │ +00020e90: 2061 6e64 2070 7269 6e63 6970 616c 2e0a   and principal..
│ │ │ │ +00020ea0: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ +00020eb0: 6c75 653a 2a20 5265 7475 726e 7320 5348  lue:* Returns SH
│ │ │ │ +00020ec0: 4953 4849 5f4f 4b20 6966 6620 7375 6363  ISHI_OK iff succ
│ │ │ │ +00020ed0: 6573 7366 756c 2e0a 0a20 2020 4170 706c  essful...   Appl
│ │ │ │ +00020ee0: 6963 6174 696f 6e73 2074 6861 7420 7275  ications that ru
│ │ │ │ +00020ef0: 6e20 756e 696e 7465 7261 6374 6976 656c  n uninteractivel
│ │ │ │ +00020f00: 7920 6d61 7920 6e65 6564 206b 6579 696e  y may need keyin
│ │ │ │ +00020f10: 6720 6d61 7465 7269 616c 2e20 2049 6e0a  g material.  In.
│ │ │ │ +00020f20: 7468 6573 6520 6361 7365 732c 2074 6865  these cases, the
│ │ │ │ +00020f30: 206b 6579 7320 6172 6520 7374 6f72 6564   keys are stored
│ │ │ │ +00020f40: 2069 6e20 6120 6669 6c65 2c20 6120 6669   in a file, a fi
│ │ │ │ +00020f50: 6c65 2074 6861 7420 6973 206e 6f72 6d61  le that is norma
│ │ │ │ +00020f60: 6c6c 790a 7374 6f72 6564 206f 6e20 7468  lly.stored on th
│ │ │ │ +00020f70: 6520 6c6f 6361 6c20 686f 7374 2e20 2054  e local host.  T
│ │ │ │ +00020f80: 6865 2066 696c 6520 7368 6f75 6c64 2062  he file should b
│ │ │ │ +00020f90: 6520 7072 6f74 6563 7465 6420 6672 6f6d  e protected from
│ │ │ │ +00020fa0: 0a75 6e61 7574 686f 7269 7a65 6420 6163  .unauthorized ac
│ │ │ │ +00020fb0: 6365 7373 2e20 2054 6865 2066 696c 6520  cess.  The file 
│ │ │ │ +00020fc0: 6973 2069 6e20 4153 4349 4920 666f 726d  is in ASCII form
│ │ │ │ +00020fd0: 6174 2061 6e64 2063 6f6e 7461 696e 7320  at and contains 
│ │ │ │ +00020fe0: 6b65 7973 2061 730a 6f75 7470 7574 6564  keys as.outputed
│ │ │ │ +00020ff0: 2062 7920 e280 9873 6869 7368 695f 6b65   by ...shishi_ke
│ │ │ │ +00021000: 795f 7072 696e 74e2 8099 2e20 2041 6c6c  y_print....  All
│ │ │ │ +00021010: 2066 756e 6374 696f 6e73 2074 6861 7420   functions that 
│ │ │ │ +00021020: 6861 6e64 6c65 2074 6865 7365 206b 6579  handle these key
│ │ │ │ +00021030: 730a 7365 7473 2061 7265 2064 6573 6372  s.sets are descr
│ │ │ │ +00021040: 6962 6564 206e 6f77 2e0a 0a73 6869 7368  ibed now...shish
│ │ │ │ +00021050: 695f 6b65 7973 0a2d 2d2d 2d2d 2d2d 2d2d  i_keys.---------
│ │ │ │ +00021060: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ +00021070: 3a20 696e 7420 7368 6973 6869 5f6b 6579  : int shishi_key
│ │ │ │ +00021080: 7320 2853 6869 7368 6920 2a20 4841 4e44  s (Shishi * HAND
│ │ │ │ +00021090: 4c45 2c20 5368 6973 6869 5f6b 6579 7320  LE, Shishi_keys 
│ │ │ │ +000210a0: 2a2a 204b 4559 5329 0a20 2020 2020 4841  ** KEYS).     HA
│ │ │ │ +000210b0: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ +000210c0: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ +000210d0: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ +000210e0: 6974 2829 e280 992e 0a20 2020 2020 4b45  it().....     KE
│ │ │ │ +000210f0: 5953 3a20 6f75 7470 7574 2070 6f69 6e74  YS: output point
│ │ │ │ +00021100: 6572 2074 6f20 6e65 776c 7920 616c 6c6f  er to newly allo
│ │ │ │ +00021110: 6361 7465 6420 6b65 7973 2068 616e 646c  cated keys handl
│ │ │ │ +00021120: 652e 0a0a 2020 2020 202a 4465 7363 7269  e...     *Descri
│ │ │ │ +00021130: 7074 696f 6e3a 2a20 4765 7420 6120 6e65  ption:* Get a ne
│ │ │ │ +00021140: 7720 6b65 7920 7365 7420 6861 6e64 6c65  w key set handle
│ │ │ │ +00021150: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ +00021160: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ +00021170: e280 9853 4849 5348 495f 4f4b e280 9920  ...SHISHI_OK... 
│ │ │ │ +00021180: 6966 6620 7375 6363 6573 7366 756c 2e0a  iff successful..
│ │ │ │ +00021190: 0a73 6869 7368 695f 6b65 7973 5f64 6f6e  .shishi_keys_don
│ │ │ │ +000211a0: 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  e.--------------
│ │ │ │ +000211b0: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ +000211c0: 3a20 766f 6964 2073 6869 7368 695f 6b65  : void shishi_ke
│ │ │ │ +000211d0: 7973 5f64 6f6e 6520 2853 6869 7368 695f  ys_done (Shishi_
│ │ │ │ +000211e0: 6b65 7973 202a 2a20 4b45 5953 290a 2020  keys ** KEYS).  
│ │ │ │ +000211f0: 2020 204b 4559 533a 206b 6579 2073 6574     KEYS: key set
│ │ │ │ +00021200: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ +00021210: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ +00021220: 695f 6b65 7973 2829 e280 992e 0a0a 2020  i_keys()......  
│ │ │ │ +00021230: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ +00021240: 2a20 4465 616c 6c6f 6361 7465 7320 616c  * Deallocates al
│ │ │ │ +00021250: 6c20 7265 736f 7572 6365 7320 6173 736f  l resources asso
│ │ │ │ +00021260: 6369 6174 6564 2077 6974 6820 6b65 7920  ciated with key 
│ │ │ │ +00021270: 7365 742e 0a20 2020 2020 5468 6520 6b65  set..     The ke
│ │ │ │ +00021280: 7920 7365 7420 6861 6e64 6c65 206d 7573  y set handle mus
│ │ │ │ +00021290: 7420 6e6f 7420 6265 2075 7365 6420 696e  t not be used in
│ │ │ │ +000212a0: 2063 616c 6c73 2074 6f20 6f74 6865 720a   calls to other.
│ │ │ │ +000212b0: 2020 2020 2073 6869 7368 695f 6b65 7973       shishi_keys
│ │ │ │ +000212c0: 5f2a 2829 2066 756e 6374 696f 6e73 2061  _*() functions a
│ │ │ │ +000212d0: 6674 6572 2074 6869 732e 0a0a 7368 6973  fter this...shis
│ │ │ │ +000212e0: 6869 5f6b 6579 735f 7369 7a65 0a2d 2d2d  hi_keys_size.---
│ │ │ │ +000212f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ +00021300: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ +00021310: 2073 6869 7368 695f 6b65 7973 5f73 697a   shishi_keys_siz
│ │ │ │ +00021320: 6520 2853 6869 7368 695f 6b65 7973 202a  e (Shishi_keys *
│ │ │ │ +00021330: 204b 4559 5329 0a20 2020 2020 4b45 5953   KEYS).     KEYS
│ │ │ │ +00021340: 3a20 6b65 7920 7365 7420 6861 6e64 6c65  : key set handle
│ │ │ │ +00021350: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ +00021360: 20e2 8098 7368 6973 6869 5f6b 6579 7328   ...shishi_keys(
│ │ │ │ +00021370: 29e2 8099 2e0a 0a20 2020 2020 2a44 6573  )......     *Des
│ │ │ │ +00021380: 6372 6970 7469 6f6e 3a2a 2047 6574 2073  cription:* Get s
│ │ │ │ +00021390: 697a 6520 6f66 206b 6579 2073 6574 2e0a  ize of key set..
│ │ │ │ +000213a0: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ +000213b0: 6c75 653a 2a20 5265 7475 726e 7320 6e75  lue:* Returns nu
│ │ │ │ +000213c0: 6d62 6572 206f 6620 6b65 7973 2073 746f  mber of keys sto
│ │ │ │ +000213d0: 7265 6420 696e 206b 6579 2073 6574 2e0a  red in key set..
│ │ │ │ +000213e0: 0a73 6869 7368 695f 6b65 7973 5f6e 7468  .shishi_keys_nth
│ │ │ │ +000213f0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ +00021400: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +00021410: 636f 6e73 7420 5368 6973 6869 5f6b 6579  const Shishi_key
│ │ │ │ +00021420: 202a 2073 6869 7368 695f 6b65 7973 5f6e   * shishi_keys_n
│ │ │ │ +00021430: 7468 2028 5368 6973 6869 5f6b 6579 7320  th (Shishi_keys 
│ │ │ │ +00021440: 2a20 4b45 5953 2c0a 2020 2020 2020 2020  * KEYS,.        
│ │ │ │ +00021450: 2020 696e 7420 4b45 594e 4f29 0a20 2020    int KEYNO).   
│ │ │ │ +00021460: 2020 4b45 5953 3a20 6b65 7920 7365 7420    KEYS: key set 
│ │ │ │ +00021470: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ +00021480: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ +00021490: 5f6b 6579 7328 29e2 8099 2e0a 2020 2020  _keys().....    
│ │ │ │ +000214a0: 204b 4559 4e4f 3a20 696e 7465 6765 7220   KEYNO: integer 
│ │ │ │ +000214b0: 696e 6469 6361 7469 6e67 2072 6571 7565  indicating reque
│ │ │ │ +000214c0: 7374 6564 206b 6579 2069 6e20 6b65 7920  sted key in key 
│ │ │ │ +000214d0: 7365 742e 0a0a 2020 2020 202a 4765 7420  set...     *Get 
│ │ │ │ +000214e0: 7468 6520 6e3a 2a20 7468 2074 6963 6b65  the n:* th ticke
│ │ │ │ +000214f0: 7420 696e 206b 6579 2073 6574 2e0a 0a20  t in key set... 
│ │ │ │ +00021500: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ +00021510: 653a 2a20 5265 7475 726e 7320 6120 6b65  e:* Returns a ke
│ │ │ │ +00021520: 7920 6861 6e64 6c65 2074 6f20 7468 6520  y handle to the 
│ │ │ │ +00021530: 6b65 796e 6f3a 7468 206b 6579 2069 6e20  keyno:th key in 
│ │ │ │ +00021540: 7468 6520 6b65 790a 2020 2020 2073 6574  the key.     set
│ │ │ │ +00021550: 2c20 6f72 204e 554c 4c20 6966 204b 4559  , or NULL if KEY
│ │ │ │ +00021560: 5320 6973 2069 6e76 616c 6964 206f 7220  S is invalid or 
│ │ │ │ +00021570: 4b45 594e 4f20 6973 206f 7574 206f 6620  KEYNO is out of 
│ │ │ │ +00021580: 626f 756e 6473 2e20 2054 6865 0a20 2020  bounds.  The.   
│ │ │ │ +00021590: 2020 6669 7273 7420 6b65 7920 6973 204b    first key is K
│ │ │ │ +000215a0: 4559 4e4f 2030 2c20 7468 6520 7365 636f  EYNO 0, the seco
│ │ │ │ +000215b0: 6e64 206b 6579 204b 4559 4e4f 2031 2c20  nd key KEYNO 1, 
│ │ │ │ +000215c0: 616e 6420 736f 206f 6e2e 0a0a 7368 6973  and so on...shis
│ │ │ │ +000215d0: 6869 5f6b 6579 735f 7265 6d6f 7665 0a2d  hi_keys_remove.-
│ │ │ │  000215e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000215f0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ -00021600: 766f 6964 2073 6869 7368 695f 6b65 7973  void shishi_keys
│ │ │ │ -00021610: 5f72 656d 6f76 6520 2853 6869 7368 695f  _remove (Shishi_
│ │ │ │ -00021620: 6b65 7973 202a 204b 4559 532c 2069 6e74  keys * KEYS, int
│ │ │ │ -00021630: 204b 4559 4e4f 290a 2020 2020 204b 4559   KEYNO).     KEY
│ │ │ │ -00021640: 533a 206b 6579 2073 6574 2068 616e 646c  S: key set handl
│ │ │ │ -00021650: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ -00021660: 7920 e280 9873 6869 7368 695f 6b65 7973  y ...shishi_keys
│ │ │ │ -00021670: 2829 e280 992e 0a20 2020 2020 4b45 594e  ().....     KEYN
│ │ │ │ -00021680: 4f3a 206b 6579 206e 756d 6265 7220 6f66  O: key number of
│ │ │ │ -00021690: 206b 6579 2069 6e20 7468 6520 7365 7420   key in the set 
│ │ │ │ -000216a0: 746f 2072 656d 6f76 652e 2020 5468 6520  to remove.  The 
│ │ │ │ -000216b0: 6669 7273 7420 6b65 7920 6973 0a20 2020  first key is.   
│ │ │ │ -000216c0: 2020 6b65 7920 6e75 6d62 6572 2030 2e0a    key number 0..
│ │ │ │ -000216d0: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -000216e0: 6f6e 3a2a 2052 656d 6f76 6520 6120 6b65  on:* Remove a ke
│ │ │ │ -000216f0: 792c 2069 6e64 6578 6564 2062 7920 4b45  y, indexed by KE
│ │ │ │ -00021700: 594e 4f2c 2069 6e20 6769 7665 6e20 6b65  YNO, in given ke
│ │ │ │ -00021710: 7920 7365 742e 0a0a 7368 6973 6869 5f6b  y set...shishi_k
│ │ │ │ -00021720: 6579 735f 6164 640a 2d2d 2d2d 2d2d 2d2d  eys_add.--------
│ │ │ │ -00021730: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ -00021740: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ -00021750: 695f 6b65 7973 5f61 6464 2028 5368 6973  i_keys_add (Shis
│ │ │ │ -00021760: 6869 5f6b 6579 7320 2a20 4b45 5953 2c20  hi_keys * KEYS, 
│ │ │ │ -00021770: 5368 6973 6869 5f6b 6579 202a 204b 4559  Shishi_key * KEY
│ │ │ │ -00021780: 290a 2020 2020 204b 4559 533a 206b 6579  ).     KEYS: key
│ │ │ │ -00021790: 2073 6574 2068 616e 646c 6520 6173 2061   set handle as a
│ │ │ │ -000217a0: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ -000217b0: 6869 7368 695f 6b65 7973 2829 e280 992e  hishi_keys()....
│ │ │ │ -000217c0: 0a20 2020 2020 4b45 593a 206b 6579 2074  .     KEY: key t
│ │ │ │ -000217d0: 6f20 6265 2061 6464 6564 2074 6f20 6b65  o be added to ke
│ │ │ │ -000217e0: 7920 7365 742e 0a0a 2020 2020 202a 4465  y set...     *De
│ │ │ │ -000217f0: 7363 7269 7074 696f 6e3a 2a20 4164 6420  scription:* Add 
│ │ │ │ -00021800: 6120 6b65 7920 746f 2074 6865 206b 6579  a key to the key
│ │ │ │ -00021810: 2073 6574 2e20 2041 2064 6565 7020 636f   set.  A deep co
│ │ │ │ -00021820: 7079 206f 6620 7468 6520 6b65 7920 6973  py of the key is
│ │ │ │ -00021830: 0a20 2020 2020 7374 6f72 6564 2c20 736f  .     stored, so
│ │ │ │ -00021840: 2063 6861 6e67 696e 6720 4b45 592c 206f   changing KEY, o
│ │ │ │ -00021850: 7220 6465 616c 6c6f 6361 7469 6e67 2069  r deallocating i
│ │ │ │ -00021860: 742c 2077 696c 6c20 6e6f 7420 6d6f 6469  t, will not modi
│ │ │ │ -00021870: 6679 2074 6865 0a20 2020 2020 7661 6c75  fy the.     valu
│ │ │ │ -00021880: 6520 7374 6f72 6564 2069 6e20 7468 6520  e stored in the 
│ │ │ │ -00021890: 6b65 7920 7365 742e 0a0a 2020 2020 202a  key set...     *
│ │ │ │ -000218a0: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ -000218b0: 6574 7572 6e73 20e2 8098 5348 4953 4849  eturns ...SHISHI
│ │ │ │ -000218c0: 5f4f 4be2 8099 2069 6666 2073 7563 6365  _OK... iff succe
│ │ │ │ -000218d0: 7373 6675 6c2e 0a0a 7368 6973 6869 5f6b  ssful...shishi_k
│ │ │ │ -000218e0: 6579 735f 7072 696e 740a 2d2d 2d2d 2d2d  eys_print.------
│ │ │ │ -000218f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ -00021900: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ -00021910: 6869 7368 695f 6b65 7973 5f70 7269 6e74  hishi_keys_print
│ │ │ │ -00021920: 2028 5368 6973 6869 5f6b 6579 7320 2a20   (Shishi_keys * 
│ │ │ │ -00021930: 4b45 5953 2c20 4649 4c45 202a 2046 4829  KEYS, FILE * FH)
│ │ │ │ -00021940: 0a20 2020 2020 4b45 5953 3a20 6b65 7920  .     KEYS: key 
│ │ │ │ -00021950: 7365 7420 746f 2070 7269 6e74 2e0a 2020  set to print..  
│ │ │ │ -00021960: 2020 2046 483a 2066 696c 6520 6861 6e64     FH: file hand
│ │ │ │ -00021970: 6c65 2c20 6f70 656e 2066 6f72 2077 7269  le, open for wri
│ │ │ │ -00021980: 7469 6e67 2c20 746f 2070 7269 6e74 206b  ting, to print k
│ │ │ │ -00021990: 6579 7320 746f 2e0a 0a20 2020 2020 2a44  eys to...     *D
│ │ │ │ -000219a0: 6573 6372 6970 7469 6f6e 3a2a 2050 7269  escription:* Pri
│ │ │ │ -000219b0: 6e74 2061 6c6c 206b 6579 7320 696e 2073  nt all keys in s
│ │ │ │ -000219c0: 6574 2075 7369 6e67 2073 6869 7368 695f  et using shishi_
│ │ │ │ -000219d0: 6b65 795f 7072 696e 742e 0a0a 2020 2020  key_print...    
│ │ │ │ -000219e0: 202a 5265 7475 726e 733a 2a20 5265 7475   *Returns:* Retu
│ │ │ │ -000219f0: 726e 7320 e280 9853 4849 5348 495f 4f4b  rns ...SHISHI_OK
│ │ │ │ -00021a00: e280 9920 6f6e 2073 7563 6365 7373 2e0a  ... on success..
│ │ │ │ -00021a10: 0a73 6869 7368 695f 6b65 7973 5f74 6f5f  .shishi_keys_to_
│ │ │ │ -00021a20: 6669 6c65 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  file.-----------
│ │ │ │ -00021a30: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -00021a40: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ -00021a50: 6869 5f6b 6579 735f 746f 5f66 696c 6520  hi_keys_to_file 
│ │ │ │ -00021a60: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ -00021a70: 2c0a 2020 2020 2020 2020 2020 636f 6e73  ,.          cons
│ │ │ │ -00021a80: 7420 6368 6172 202a 2046 494c 454e 414d  t char * FILENAM
│ │ │ │ -00021a90: 452c 2053 6869 7368 695f 6b65 7973 202a  E, Shishi_keys *
│ │ │ │ -00021aa0: 204b 4559 5329 0a20 2020 2020 4841 4e44   KEYS).     HAND
│ │ │ │ -00021ab0: 4c45 3a20 7368 6973 6869 2068 616e 646c  LE: shishi handl
│ │ │ │ -00021ac0: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ -00021ad0: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ -00021ae0: 2829 e280 992e 0a20 2020 2020 4649 4c45  ().....     FILE
│ │ │ │ -00021af0: 4e41 4d45 3a20 6669 6c65 6e61 6d65 2074  NAME: filename t
│ │ │ │ -00021b00: 6f20 6170 7065 6e64 206b 6579 2074 6f2e  o append key to.
│ │ │ │ -00021b10: 0a20 2020 2020 4b45 5953 3a20 7365 7420  .     KEYS: set 
│ │ │ │ -00021b20: 6f66 206b 6579 7320 746f 2070 7269 6e74  of keys to print
│ │ │ │ -00021b30: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ -00021b40: 7469 6f6e 3a2a 2050 7269 6e74 2061 6e20  tion:* Print an 
│ │ │ │ -00021b50: 4153 4349 4920 7265 7072 6573 656e 7461  ASCII representa
│ │ │ │ -00021b60: 7469 6f6e 206f 6620 6120 6b65 7920 7374  tion of a key st
│ │ │ │ -00021b70: 7275 6374 7572 6520 746f 0a20 2020 2020  ructure to.     
│ │ │ │ -00021b80: 6120 6669 6c65 2c20 666f 7220 6561 6368  a file, for each
│ │ │ │ -00021b90: 206b 6579 2069 6e20 7468 6520 6b65 7920   key in the key 
│ │ │ │ -00021ba0: 7365 742e 2020 5468 6520 6669 6c65 2069  set.  The file i
│ │ │ │ -00021bb0: 7320 6170 7065 6e64 6564 2074 6f20 6966  s appended to if
│ │ │ │ -00021bc0: 2069 740a 2020 2020 2065 7869 7374 732e   it.     exists.
│ │ │ │ -00021bd0: 2020 5365 6520 e280 9873 6869 7368 695f    See ...shishi_
│ │ │ │ -00021be0: 6b65 795f 7072 696e 7428 29e2 8099 2066  key_print()... f
│ │ │ │ -00021bf0: 6f72 2074 6865 2066 6f72 6d61 7420 6f66  or the format of
│ │ │ │ -00021c00: 2074 6865 206f 7574 7075 742e 0a0a 2020   the output...  
│ │ │ │ -00021c10: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ -00021c20: 3a2a 2052 6574 7572 6e73 20e2 8098 5348  :* Returns ...SH
│ │ │ │ -00021c30: 4953 4849 5f4f 4be2 8099 2069 6666 2073  ISHI_OK... iff s
│ │ │ │ -00021c40: 7563 6365 7373 6675 6c2e 0a0a 7368 6973  uccessful...shis
│ │ │ │ -00021c50: 6869 5f6b 6579 735f 6672 6f6d 5f66 696c  hi_keys_from_fil
│ │ │ │ -00021c60: 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  e.--------------
│ │ │ │ -00021c70: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ -00021c80: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ -00021c90: 695f 6b65 7973 5f66 726f 6d5f 6669 6c65  i_keys_from_file
│ │ │ │ -00021ca0: 2028 5368 6973 6869 5f6b 6579 7320 2a20   (Shishi_keys * 
│ │ │ │ -00021cb0: 4b45 5953 2c0a 2020 2020 2020 2020 2020  KEYS,.          
│ │ │ │ -00021cc0: 636f 6e73 7420 6368 6172 202a 2046 494c  const char * FIL
│ │ │ │ -00021cd0: 454e 414d 4529 0a20 2020 2020 4b45 5953  ENAME).     KEYS
│ │ │ │ -00021ce0: 3a20 6b65 7920 7365 7420 6861 6e64 6c65  : key set handle
│ │ │ │ -00021cf0: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ -00021d00: 20e2 8098 7368 6973 6869 5f6b 6579 7328   ...shishi_keys(
│ │ │ │ -00021d10: 29e2 8099 2e0a 2020 2020 2046 494c 454e  ).....     FILEN
│ │ │ │ -00021d20: 414d 453a 2066 696c 656e 616d 6520 746f  AME: filename to
│ │ │ │ -00021d30: 2072 6561 6420 6b65 7973 2066 726f 6d2e   read keys from.
│ │ │ │ -00021d40: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ -00021d50: 696f 6e3a 2a20 5265 6164 207a 6572 6f20  ion:* Read zero 
│ │ │ │ -00021d60: 6f72 206d 6f72 6520 6b65 7973 2066 726f  or more keys fro
│ │ │ │ -00021d70: 6d20 6669 6c65 2046 494c 454e 414d 4520  m file FILENAME 
│ │ │ │ -00021d80: 616e 6420 6170 7065 6e64 0a20 2020 2020  and append.     
│ │ │ │ -00021d90: 7468 656d 2074 6f20 7468 6520 6b65 7973  them to the keys
│ │ │ │ -00021da0: 6574 204b 4559 532e 2020 5365 6520 e280  et KEYS.  See ..
│ │ │ │ -00021db0: 9873 6869 7368 695f 6b65 795f 7072 696e  .shishi_key_prin
│ │ │ │ -00021dc0: 7428 29e2 8099 2066 6f72 2074 6865 2066  t()... for the f
│ │ │ │ -00021dd0: 6f72 6d61 740a 2020 2020 206f 6620 7468  ormat.     of th
│ │ │ │ -00021de0: 6520 696e 7075 742e 0a0a 2020 2020 202a  e input...     *
│ │ │ │ -00021df0: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ -00021e00: 6574 7572 6e73 20e2 8098 5348 4953 4849  eturns ...SHISHI
│ │ │ │ -00021e10: 5f4f 4be2 8099 2069 6666 2073 7563 6365  _OK... iff succe
│ │ │ │ -00021e20: 7373 6675 6c2e 0a0a 2020 2020 202a 5369  ssful...     *Si
│ │ │ │ -00021e30: 6e63 653a 2a20 302e 302e 3432 0a0a 7368  nce:* 0.0.42..sh
│ │ │ │ -00021e40: 6973 6869 5f6b 6579 735f 666f 725f 7365  ishi_keys_for_se
│ │ │ │ -00021e50: 7276 6572 7265 616c 6d5f 696e 5f66 696c  rverrealm_in_fil
│ │ │ │ -00021e60: 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  e.--------------
│ │ │ │ +000215f0: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ +00021600: 2076 6f69 6420 7368 6973 6869 5f6b 6579   void shishi_key
│ │ │ │ +00021610: 735f 7265 6d6f 7665 2028 5368 6973 6869  s_remove (Shishi
│ │ │ │ +00021620: 5f6b 6579 7320 2a20 4b45 5953 2c20 696e  _keys * KEYS, in
│ │ │ │ +00021630: 7420 4b45 594e 4f29 0a20 2020 2020 4b45  t KEYNO).     KE
│ │ │ │ +00021640: 5953 3a20 6b65 7920 7365 7420 6861 6e64  YS: key set hand
│ │ │ │ +00021650: 6c65 2061 7320 616c 6c6f 6361 7465 6420  le as allocated 
│ │ │ │ +00021660: 6279 20e2 8098 7368 6973 6869 5f6b 6579  by ...shishi_key
│ │ │ │ +00021670: 7328 29e2 8099 2e0a 2020 2020 204b 4559  s().....     KEY
│ │ │ │ +00021680: 4e4f 3a20 6b65 7920 6e75 6d62 6572 206f  NO: key number o
│ │ │ │ +00021690: 6620 6b65 7920 696e 2074 6865 2073 6574  f key in the set
│ │ │ │ +000216a0: 2074 6f20 7265 6d6f 7665 2e20 2054 6865   to remove.  The
│ │ │ │ +000216b0: 2066 6972 7374 206b 6579 2069 730a 2020   first key is.  
│ │ │ │ +000216c0: 2020 206b 6579 206e 756d 6265 7220 302e     key number 0.
│ │ │ │ +000216d0: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ +000216e0: 696f 6e3a 2a20 5265 6d6f 7665 2061 206b  ion:* Remove a k
│ │ │ │ +000216f0: 6579 2c20 696e 6465 7865 6420 6279 204b  ey, indexed by K
│ │ │ │ +00021700: 4559 4e4f 2c20 696e 2067 6976 656e 206b  EYNO, in given k
│ │ │ │ +00021710: 6579 2073 6574 2e0a 0a73 6869 7368 695f  ey set...shishi_
│ │ │ │ +00021720: 6b65 7973 5f61 6464 0a2d 2d2d 2d2d 2d2d  keys_add.-------
│ │ │ │ +00021730: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ +00021740: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ +00021750: 6869 5f6b 6579 735f 6164 6420 2853 6869  hi_keys_add (Shi
│ │ │ │ +00021760: 7368 695f 6b65 7973 202a 204b 4559 532c  shi_keys * KEYS,
│ │ │ │ +00021770: 2053 6869 7368 695f 6b65 7920 2a20 4b45   Shishi_key * KE
│ │ │ │ +00021780: 5929 0a20 2020 2020 4b45 5953 3a20 6b65  Y).     KEYS: ke
│ │ │ │ +00021790: 7920 7365 7420 6861 6e64 6c65 2061 7320  y set handle as 
│ │ │ │ +000217a0: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ +000217b0: 7368 6973 6869 5f6b 6579 7328 29e2 8099  shishi_keys()...
│ │ │ │ +000217c0: 2e0a 2020 2020 204b 4559 3a20 6b65 7920  ..     KEY: key 
│ │ │ │ +000217d0: 746f 2062 6520 6164 6465 6420 746f 206b  to be added to k
│ │ │ │ +000217e0: 6579 2073 6574 2e0a 0a20 2020 2020 2a44  ey set...     *D
│ │ │ │ +000217f0: 6573 6372 6970 7469 6f6e 3a2a 2041 6464  escription:* Add
│ │ │ │ +00021800: 2061 206b 6579 2074 6f20 7468 6520 6b65   a key to the ke
│ │ │ │ +00021810: 7920 7365 742e 2020 4120 6465 6570 2063  y set.  A deep c
│ │ │ │ +00021820: 6f70 7920 6f66 2074 6865 206b 6579 2069  opy of the key i
│ │ │ │ +00021830: 730a 2020 2020 2073 746f 7265 642c 2073  s.     stored, s
│ │ │ │ +00021840: 6f20 6368 616e 6769 6e67 204b 4559 2c20  o changing KEY, 
│ │ │ │ +00021850: 6f72 2064 6561 6c6c 6f63 6174 696e 6720  or deallocating 
│ │ │ │ +00021860: 6974 2c20 7769 6c6c 206e 6f74 206d 6f64  it, will not mod
│ │ │ │ +00021870: 6966 7920 7468 650a 2020 2020 2076 616c  ify the.     val
│ │ │ │ +00021880: 7565 2073 746f 7265 6420 696e 2074 6865  ue stored in the
│ │ │ │ +00021890: 206b 6579 2073 6574 2e0a 0a20 2020 2020   key set...     
│ │ │ │ +000218a0: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ +000218b0: 5265 7475 726e 7320 e280 9853 4849 5348  Returns ...SHISH
│ │ │ │ +000218c0: 495f 4f4b e280 9920 6966 6620 7375 6363  I_OK... iff succ
│ │ │ │ +000218d0: 6573 7366 756c 2e0a 0a73 6869 7368 695f  essful...shishi_
│ │ │ │ +000218e0: 6b65 7973 5f70 7269 6e74 0a2d 2d2d 2d2d  keys_print.-----
│ │ │ │ +000218f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ +00021900: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ +00021910: 7368 6973 6869 5f6b 6579 735f 7072 696e  shishi_keys_prin
│ │ │ │ +00021920: 7420 2853 6869 7368 695f 6b65 7973 202a  t (Shishi_keys *
│ │ │ │ +00021930: 204b 4559 532c 2046 494c 4520 2a20 4648   KEYS, FILE * FH
│ │ │ │ +00021940: 290a 2020 2020 204b 4559 533a 206b 6579  ).     KEYS: key
│ │ │ │ +00021950: 2073 6574 2074 6f20 7072 696e 742e 0a20   set to print.. 
│ │ │ │ +00021960: 2020 2020 4648 3a20 6669 6c65 2068 616e      FH: file han
│ │ │ │ +00021970: 646c 652c 206f 7065 6e20 666f 7220 7772  dle, open for wr
│ │ │ │ +00021980: 6974 696e 672c 2074 6f20 7072 696e 7420  iting, to print 
│ │ │ │ +00021990: 6b65 7973 2074 6f2e 0a0a 2020 2020 202a  keys to...     *
│ │ │ │ +000219a0: 4465 7363 7269 7074 696f 6e3a 2a20 5072  Description:* Pr
│ │ │ │ +000219b0: 696e 7420 616c 6c20 6b65 7973 2069 6e20  int all keys in 
│ │ │ │ +000219c0: 7365 7420 7573 696e 6720 7368 6973 6869  set using shishi
│ │ │ │ +000219d0: 5f6b 6579 5f70 7269 6e74 2e0a 0a20 2020  _key_print...   
│ │ │ │ +000219e0: 2020 2a52 6574 7572 6e73 3a2a 2052 6574    *Returns:* Ret
│ │ │ │ +000219f0: 7572 6e73 20e2 8098 5348 4953 4849 5f4f  urns ...SHISHI_O
│ │ │ │ +00021a00: 4be2 8099 206f 6e20 7375 6363 6573 732e  K... on success.
│ │ │ │ +00021a10: 0a0a 7368 6973 6869 5f6b 6579 735f 746f  ..shishi_keys_to
│ │ │ │ +00021a20: 5f66 696c 650a 2d2d 2d2d 2d2d 2d2d 2d2d  _file.----------
│ │ │ │ +00021a30: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +00021a40: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ +00021a50: 7368 695f 6b65 7973 5f74 6f5f 6669 6c65  shi_keys_to_file
│ │ │ │ +00021a60: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ +00021a70: 452c 0a20 2020 2020 2020 2020 2063 6f6e  E,.          con
│ │ │ │ +00021a80: 7374 2063 6861 7220 2a20 4649 4c45 4e41  st char * FILENA
│ │ │ │ +00021a90: 4d45 2c20 5368 6973 6869 5f6b 6579 7320  ME, Shishi_keys 
│ │ │ │ +00021aa0: 2a20 4b45 5953 290a 2020 2020 2048 414e  * KEYS).     HAN
│ │ │ │ +00021ab0: 444c 453a 2073 6869 7368 6920 6861 6e64  DLE: shishi hand
│ │ │ │ +00021ac0: 6c65 2061 7320 616c 6c6f 6361 7465 6420  le as allocated 
│ │ │ │ +00021ad0: 6279 20e2 8098 7368 6973 6869 5f69 6e69  by ...shishi_ini
│ │ │ │ +00021ae0: 7428 29e2 8099 2e0a 2020 2020 2046 494c  t().....     FIL
│ │ │ │ +00021af0: 454e 414d 453a 2066 696c 656e 616d 6520  ENAME: filename 
│ │ │ │ +00021b00: 746f 2061 7070 656e 6420 6b65 7920 746f  to append key to
│ │ │ │ +00021b10: 2e0a 2020 2020 204b 4559 533a 2073 6574  ..     KEYS: set
│ │ │ │ +00021b20: 206f 6620 6b65 7973 2074 6f20 7072 696e   of keys to prin
│ │ │ │ +00021b30: 742e 0a0a 2020 2020 202a 4465 7363 7269  t...     *Descri
│ │ │ │ +00021b40: 7074 696f 6e3a 2a20 5072 696e 7420 616e  ption:* Print an
│ │ │ │ +00021b50: 2041 5343 4949 2072 6570 7265 7365 6e74   ASCII represent
│ │ │ │ +00021b60: 6174 696f 6e20 6f66 2061 206b 6579 2073  ation of a key s
│ │ │ │ +00021b70: 7472 7563 7475 7265 2074 6f0a 2020 2020  tructure to.    
│ │ │ │ +00021b80: 2061 2066 696c 652c 2066 6f72 2065 6163   a file, for eac
│ │ │ │ +00021b90: 6820 6b65 7920 696e 2074 6865 206b 6579  h key in the key
│ │ │ │ +00021ba0: 2073 6574 2e20 2054 6865 2066 696c 6520   set.  The file 
│ │ │ │ +00021bb0: 6973 2061 7070 656e 6465 6420 746f 2069  is appended to i
│ │ │ │ +00021bc0: 6620 6974 0a20 2020 2020 6578 6973 7473  f it.     exists
│ │ │ │ +00021bd0: 2e20 2053 6565 20e2 8098 7368 6973 6869  .  See ...shishi
│ │ │ │ +00021be0: 5f6b 6579 5f70 7269 6e74 2829 e280 9920  _key_print()... 
│ │ │ │ +00021bf0: 666f 7220 7468 6520 666f 726d 6174 206f  for the format o
│ │ │ │ +00021c00: 6620 7468 6520 6f75 7470 7574 2e0a 0a20  f the output... 
│ │ │ │ +00021c10: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ +00021c20: 653a 2a20 5265 7475 726e 7320 e280 9853  e:* Returns ...S
│ │ │ │ +00021c30: 4849 5348 495f 4f4b e280 9920 6966 6620  HISHI_OK... iff 
│ │ │ │ +00021c40: 7375 6363 6573 7366 756c 2e0a 0a73 6869  successful...shi
│ │ │ │ +00021c50: 7368 695f 6b65 7973 5f66 726f 6d5f 6669  shi_keys_from_fi
│ │ │ │ +00021c60: 6c65 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  le.-------------
│ │ │ │ +00021c70: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ +00021c80: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ +00021c90: 6869 5f6b 6579 735f 6672 6f6d 5f66 696c  hi_keys_from_fil
│ │ │ │ +00021ca0: 6520 2853 6869 7368 695f 6b65 7973 202a  e (Shishi_keys *
│ │ │ │ +00021cb0: 204b 4559 532c 0a20 2020 2020 2020 2020   KEYS,.         
│ │ │ │ +00021cc0: 2063 6f6e 7374 2063 6861 7220 2a20 4649   const char * FI
│ │ │ │ +00021cd0: 4c45 4e41 4d45 290a 2020 2020 204b 4559  LENAME).     KEY
│ │ │ │ +00021ce0: 533a 206b 6579 2073 6574 2068 616e 646c  S: key set handl
│ │ │ │ +00021cf0: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ +00021d00: 7920 e280 9873 6869 7368 695f 6b65 7973  y ...shishi_keys
│ │ │ │ +00021d10: 2829 e280 992e 0a20 2020 2020 4649 4c45  ().....     FILE
│ │ │ │ +00021d20: 4e41 4d45 3a20 6669 6c65 6e61 6d65 2074  NAME: filename t
│ │ │ │ +00021d30: 6f20 7265 6164 206b 6579 7320 6672 6f6d  o read keys from
│ │ │ │ +00021d40: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ +00021d50: 7469 6f6e 3a2a 2052 6561 6420 7a65 726f  tion:* Read zero
│ │ │ │ +00021d60: 206f 7220 6d6f 7265 206b 6579 7320 6672   or more keys fr
│ │ │ │ +00021d70: 6f6d 2066 696c 6520 4649 4c45 4e41 4d45  om file FILENAME
│ │ │ │ +00021d80: 2061 6e64 2061 7070 656e 640a 2020 2020   and append.    
│ │ │ │ +00021d90: 2074 6865 6d20 746f 2074 6865 206b 6579   them to the key
│ │ │ │ +00021da0: 7365 7420 4b45 5953 2e20 2053 6565 20e2  set KEYS.  See .
│ │ │ │ +00021db0: 8098 7368 6973 6869 5f6b 6579 5f70 7269  ..shishi_key_pri
│ │ │ │ +00021dc0: 6e74 2829 e280 9920 666f 7220 7468 6520  nt()... for the 
│ │ │ │ +00021dd0: 666f 726d 6174 0a20 2020 2020 6f66 2074  format.     of t
│ │ │ │ +00021de0: 6865 2069 6e70 7574 2e0a 0a20 2020 2020  he input...     
│ │ │ │ +00021df0: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ +00021e00: 5265 7475 726e 7320 e280 9853 4849 5348  Returns ...SHISH
│ │ │ │ +00021e10: 495f 4f4b e280 9920 6966 6620 7375 6363  I_OK... iff succ
│ │ │ │ +00021e20: 6573 7366 756c 2e0a 0a20 2020 2020 2a53  essful...     *S
│ │ │ │ +00021e30: 696e 6365 3a2a 2030 2e30 2e34 320a 0a73  ince:* 0.0.42..s
│ │ │ │ +00021e40: 6869 7368 695f 6b65 7973 5f66 6f72 5f73  hishi_keys_for_s
│ │ │ │ +00021e50: 6572 7665 7272 6561 6c6d 5f69 6e5f 6669  erverrealm_in_fi
│ │ │ │ +00021e60: 6c65 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  le.-------------
│ │ │ │  00021e70: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00021e80: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ -00021e90: 696f 6e3a 2053 6869 7368 695f 6b65 7920  ion: Shishi_key 
│ │ │ │ -00021ea0: 2a20 7368 6973 6869 5f6b 6579 735f 666f  * shishi_keys_fo
│ │ │ │ -00021eb0: 725f 7365 7276 6572 7265 616c 6d5f 696e  r_serverrealm_in
│ │ │ │ -00021ec0: 5f66 696c 650a 2020 2020 2020 2020 2020  _file.          
│ │ │ │ -00021ed0: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ -00021ee0: 2c20 636f 6e73 7420 6368 6172 202a 2046  , const char * F
│ │ │ │ -00021ef0: 494c 454e 414d 452c 2063 6f6e 7374 2063  ILENAME, const c
│ │ │ │ -00021f00: 6861 7220 2a20 5345 5256 4552 2c0a 2020  har * SERVER,.  
│ │ │ │ -00021f10: 2020 2020 2020 2020 636f 6e73 7420 6368          const ch
│ │ │ │ -00021f20: 6172 202a 2052 4541 4c4d 290a 2020 2020  ar * REALM).    
│ │ │ │ -00021f30: 2048 414e 444c 453a 2053 6869 7368 6920   HANDLE: Shishi 
│ │ │ │ -00021f40: 6c69 6272 6172 7920 6861 6e64 6c65 2063  library handle c
│ │ │ │ -00021f50: 7265 6174 6520 6279 20e2 8098 7368 6973  reate by ...shis
│ │ │ │ -00021f60: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ -00021f70: 2020 2046 494c 454e 414d 453a 2066 696c     FILENAME: fil
│ │ │ │ -00021f80: 6520 746f 2072 6561 6420 6b65 7973 2066  e to read keys f
│ │ │ │ -00021f90: 726f 6d2e 0a20 2020 2020 5345 5256 4552  rom..     SERVER
│ │ │ │ -00021fa0: 3a20 7365 7276 6572 206e 616d 6520 746f  : server name to
│ │ │ │ -00021fb0: 2067 6574 206b 6579 2066 6f72 2e0a 2020   get key for..  
│ │ │ │ -00021fc0: 2020 2052 4541 4c4d 3a20 7265 616c 6d20     REALM: realm 
│ │ │ │ -00021fd0: 6f66 2073 6572 7665 7220 746f 2067 6574  of server to get
│ │ │ │ -00021fe0: 206b 6579 2066 6f72 2e0a 0a20 2020 2020   key for...     
│ │ │ │ -00021ff0: 2a44 6573 6372 6970 7469 6f6e 3a2a 2047  *Description:* G
│ │ │ │ -00022000: 6574 206b 6579 7320 7468 6174 206d 6174  et keys that mat
│ │ │ │ -00022010: 6368 2073 7065 6369 6669 6564 2053 4552  ch specified SER
│ │ │ │ -00022020: 5645 5220 616e 6420 5245 414c 4d20 6672  VER and REALM fr
│ │ │ │ -00022030: 6f6d 0a20 2020 2020 7468 6520 6b65 7920  om.     the key 
│ │ │ │ -00022040: 7365 7420 6669 6c65 2046 494c 454e 414d  set file FILENAM
│ │ │ │ -00022050: 452e 0a0a 2020 2020 202a 5265 7475 726e  E...     *Return
│ │ │ │ -00022060: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ -00022070: 2074 6865 206b 6579 2066 6f72 2073 7065   the key for spe
│ │ │ │ -00022080: 6369 6669 6320 7365 7276 6572 2061 6e64  cific server and
│ │ │ │ -00022090: 2072 6561 6c6d 2c20 7265 6164 0a20 2020   realm, read.   
│ │ │ │ -000220a0: 2020 6672 6f6d 2074 6865 2069 6e64 6963    from the indic
│ │ │ │ -000220b0: 6174 6564 2066 696c 652c 206f 7220 4e55  ated file, or NU
│ │ │ │ -000220c0: 4c4c 2069 6620 6e6f 206b 6579 2063 6f75  LL if no key cou
│ │ │ │ -000220d0: 6c64 2062 6520 666f 756e 6420 6f72 2061  ld be found or a
│ │ │ │ -000220e0: 6e0a 2020 2020 2065 7272 6f72 2065 6e63  n.     error enc
│ │ │ │ -000220f0: 6f75 6e74 6572 6564 2e0a 0a73 6869 7368  ountered...shish
│ │ │ │ -00022100: 695f 6b65 7973 5f66 6f72 5f73 6572 7665  i_keys_for_serve
│ │ │ │ -00022110: 725f 696e 5f66 696c 650a 2d2d 2d2d 2d2d  r_in_file.------
│ │ │ │ +00021e80: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ +00021e90: 7469 6f6e 3a20 5368 6973 6869 5f6b 6579  tion: Shishi_key
│ │ │ │ +00021ea0: 202a 2073 6869 7368 695f 6b65 7973 5f66   * shishi_keys_f
│ │ │ │ +00021eb0: 6f72 5f73 6572 7665 7272 6561 6c6d 5f69  or_serverrealm_i
│ │ │ │ +00021ec0: 6e5f 6669 6c65 0a20 2020 2020 2020 2020  n_file.         
│ │ │ │ +00021ed0: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ +00021ee0: 452c 2063 6f6e 7374 2063 6861 7220 2a20  E, const char * 
│ │ │ │ +00021ef0: 4649 4c45 4e41 4d45 2c20 636f 6e73 7420  FILENAME, const 
│ │ │ │ +00021f00: 6368 6172 202a 2053 4552 5645 522c 0a20  char * SERVER,. 
│ │ │ │ +00021f10: 2020 2020 2020 2020 2063 6f6e 7374 2063           const c
│ │ │ │ +00021f20: 6861 7220 2a20 5245 414c 4d29 0a20 2020  har * REALM).   
│ │ │ │ +00021f30: 2020 4841 4e44 4c45 3a20 5368 6973 6869    HANDLE: Shishi
│ │ │ │ +00021f40: 206c 6962 7261 7279 2068 616e 646c 6520   library handle 
│ │ │ │ +00021f50: 6372 6561 7465 2062 7920 e280 9873 6869  create by ...shi
│ │ │ │ +00021f60: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ +00021f70: 2020 2020 4649 4c45 4e41 4d45 3a20 6669      FILENAME: fi
│ │ │ │ +00021f80: 6c65 2074 6f20 7265 6164 206b 6579 7320  le to read keys 
│ │ │ │ +00021f90: 6672 6f6d 2e0a 2020 2020 2053 4552 5645  from..     SERVE
│ │ │ │ +00021fa0: 523a 2073 6572 7665 7220 6e61 6d65 2074  R: server name t
│ │ │ │ +00021fb0: 6f20 6765 7420 6b65 7920 666f 722e 0a20  o get key for.. 
│ │ │ │ +00021fc0: 2020 2020 5245 414c 4d3a 2072 6561 6c6d      REALM: realm
│ │ │ │ +00021fd0: 206f 6620 7365 7276 6572 2074 6f20 6765   of server to ge
│ │ │ │ +00021fe0: 7420 6b65 7920 666f 722e 0a0a 2020 2020  t key for...    
│ │ │ │ +00021ff0: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ +00022000: 4765 7420 6b65 7973 2074 6861 7420 6d61  Get keys that ma
│ │ │ │ +00022010: 7463 6820 7370 6563 6966 6965 6420 5345  tch specified SE
│ │ │ │ +00022020: 5256 4552 2061 6e64 2052 4541 4c4d 2066  RVER and REALM f
│ │ │ │ +00022030: 726f 6d0a 2020 2020 2074 6865 206b 6579  rom.     the key
│ │ │ │ +00022040: 2073 6574 2066 696c 6520 4649 4c45 4e41   set file FILENA
│ │ │ │ +00022050: 4d45 2e0a 0a20 2020 2020 2a52 6574 7572  ME...     *Retur
│ │ │ │ +00022060: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ +00022070: 7320 7468 6520 6b65 7920 666f 7220 7370  s the key for sp
│ │ │ │ +00022080: 6563 6966 6963 2073 6572 7665 7220 616e  ecific server an
│ │ │ │ +00022090: 6420 7265 616c 6d2c 2072 6561 640a 2020  d realm, read.  
│ │ │ │ +000220a0: 2020 2066 726f 6d20 7468 6520 696e 6469     from the indi
│ │ │ │ +000220b0: 6361 7465 6420 6669 6c65 2c20 6f72 204e  cated file, or N
│ │ │ │ +000220c0: 554c 4c20 6966 206e 6f20 6b65 7920 636f  ULL if no key co
│ │ │ │ +000220d0: 756c 6420 6265 2066 6f75 6e64 206f 7220  uld be found or 
│ │ │ │ +000220e0: 616e 0a20 2020 2020 6572 726f 7220 656e  an.     error en
│ │ │ │ +000220f0: 636f 756e 7465 7265 642e 0a0a 7368 6973  countered...shis
│ │ │ │ +00022100: 6869 5f6b 6579 735f 666f 725f 7365 7276  hi_keys_for_serv
│ │ │ │ +00022110: 6572 5f69 6e5f 6669 6c65 0a2d 2d2d 2d2d  er_in_file.-----
│ │ │ │  00022120: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00022130: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -00022140: 6e63 7469 6f6e 3a20 5368 6973 6869 5f6b  nction: Shishi_k
│ │ │ │ -00022150: 6579 202a 2073 6869 7368 695f 6b65 7973  ey * shishi_keys
│ │ │ │ -00022160: 5f66 6f72 5f73 6572 7665 725f 696e 5f66  _for_server_in_f
│ │ │ │ -00022170: 696c 650a 2020 2020 2020 2020 2020 2853  ile.          (S
│ │ │ │ -00022180: 6869 7368 6920 2a20 4841 4e44 4c45 2c20  hishi * HANDLE, 
│ │ │ │ -00022190: 636f 6e73 7420 6368 6172 202a 2046 494c  const char * FIL
│ │ │ │ -000221a0: 454e 414d 452c 2063 6f6e 7374 2063 6861  ENAME, const cha
│ │ │ │ -000221b0: 7220 2a20 5345 5256 4552 290a 2020 2020  r * SERVER).    
│ │ │ │ -000221c0: 2048 414e 444c 453a 2053 6869 7368 6920   HANDLE: Shishi 
│ │ │ │ -000221d0: 6c69 6272 6172 7920 6861 6e64 6c65 2063  library handle c
│ │ │ │ -000221e0: 7265 6174 6520 6279 20e2 8098 7368 6973  reate by ...shis
│ │ │ │ -000221f0: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ -00022200: 2020 2046 494c 454e 414d 453a 2066 696c     FILENAME: fil
│ │ │ │ -00022210: 6520 746f 2072 6561 6420 6b65 7973 2066  e to read keys f
│ │ │ │ -00022220: 726f 6d2e 0a20 2020 2020 5345 5256 4552  rom..     SERVER
│ │ │ │ -00022230: 3a20 7365 7276 6572 206e 616d 6520 746f  : server name to
│ │ │ │ -00022240: 2067 6574 206b 6579 2066 6f72 2e0a 0a20   get key for... 
│ │ │ │ -00022250: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -00022260: 3a2a 2047 6574 206b 6579 2066 6f72 2073  :* Get key for s
│ │ │ │ -00022270: 7065 6369 6669 6564 2053 4552 5645 5220  pecified SERVER 
│ │ │ │ -00022280: 6672 6f6d 2046 494c 454e 414d 452e 0a0a  from FILENAME...
│ │ │ │ -00022290: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ -000222a0: 7565 3a2a 2052 6574 7572 6e73 2074 6865  ue:* Returns the
│ │ │ │ -000222b0: 206b 6579 2066 6f72 2073 7065 6369 6669   key for specifi
│ │ │ │ -000222c0: 6320 7365 7276 6572 2c20 7265 6164 2066  c server, read f
│ │ │ │ -000222d0: 726f 6d20 7468 650a 2020 2020 2069 6e64  rom the.     ind
│ │ │ │ -000222e0: 6963 6174 6564 2066 696c 652c 206f 7220  icated file, or 
│ │ │ │ -000222f0: 4e55 4c4c 2069 6620 6e6f 206b 6579 2063  NULL if no key c
│ │ │ │ -00022300: 6f75 6c64 2062 6520 666f 756e 6420 6f72  ould be found or
│ │ │ │ -00022310: 2061 6e20 6572 726f 720a 2020 2020 2065   an error.     e
│ │ │ │ -00022320: 6e63 6f75 6e74 6572 6564 2e0a 0a73 6869  ncountered...shi
│ │ │ │ -00022330: 7368 695f 6b65 7973 5f66 6f72 5f6c 6f63  shi_keys_for_loc
│ │ │ │ -00022340: 616c 7365 7276 6963 6572 6561 6c6d 5f69  alservicerealm_i
│ │ │ │ -00022350: 6e5f 6669 6c65 0a2d 2d2d 2d2d 2d2d 2d2d  n_file.---------
│ │ │ │ +00022130: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +00022140: 756e 6374 696f 6e3a 2053 6869 7368 695f  unction: Shishi_
│ │ │ │ +00022150: 6b65 7920 2a20 7368 6973 6869 5f6b 6579  key * shishi_key
│ │ │ │ +00022160: 735f 666f 725f 7365 7276 6572 5f69 6e5f  s_for_server_in_
│ │ │ │ +00022170: 6669 6c65 0a20 2020 2020 2020 2020 2028  file.          (
│ │ │ │ +00022180: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ +00022190: 2063 6f6e 7374 2063 6861 7220 2a20 4649   const char * FI
│ │ │ │ +000221a0: 4c45 4e41 4d45 2c20 636f 6e73 7420 6368  LENAME, const ch
│ │ │ │ +000221b0: 6172 202a 2053 4552 5645 5229 0a20 2020  ar * SERVER).   
│ │ │ │ +000221c0: 2020 4841 4e44 4c45 3a20 5368 6973 6869    HANDLE: Shishi
│ │ │ │ +000221d0: 206c 6962 7261 7279 2068 616e 646c 6520   library handle 
│ │ │ │ +000221e0: 6372 6561 7465 2062 7920 e280 9873 6869  create by ...shi
│ │ │ │ +000221f0: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ +00022200: 2020 2020 4649 4c45 4e41 4d45 3a20 6669      FILENAME: fi
│ │ │ │ +00022210: 6c65 2074 6f20 7265 6164 206b 6579 7320  le to read keys 
│ │ │ │ +00022220: 6672 6f6d 2e0a 2020 2020 2053 4552 5645  from..     SERVE
│ │ │ │ +00022230: 523a 2073 6572 7665 7220 6e61 6d65 2074  R: server name t
│ │ │ │ +00022240: 6f20 6765 7420 6b65 7920 666f 722e 0a0a  o get key for...
│ │ │ │ +00022250: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ +00022260: 6e3a 2a20 4765 7420 6b65 7920 666f 7220  n:* Get key for 
│ │ │ │ +00022270: 7370 6563 6966 6965 6420 5345 5256 4552  specified SERVER
│ │ │ │ +00022280: 2066 726f 6d20 4649 4c45 4e41 4d45 2e0a   from FILENAME..
│ │ │ │ +00022290: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ +000222a0: 6c75 653a 2a20 5265 7475 726e 7320 7468  lue:* Returns th
│ │ │ │ +000222b0: 6520 6b65 7920 666f 7220 7370 6563 6966  e key for specif
│ │ │ │ +000222c0: 6963 2073 6572 7665 722c 2072 6561 6420  ic server, read 
│ │ │ │ +000222d0: 6672 6f6d 2074 6865 0a20 2020 2020 696e  from the.     in
│ │ │ │ +000222e0: 6469 6361 7465 6420 6669 6c65 2c20 6f72  dicated file, or
│ │ │ │ +000222f0: 204e 554c 4c20 6966 206e 6f20 6b65 7920   NULL if no key 
│ │ │ │ +00022300: 636f 756c 6420 6265 2066 6f75 6e64 206f  could be found o
│ │ │ │ +00022310: 7220 616e 2065 7272 6f72 0a20 2020 2020  r an error.     
│ │ │ │ +00022320: 656e 636f 756e 7465 7265 642e 0a0a 7368  encountered...sh
│ │ │ │ +00022330: 6973 6869 5f6b 6579 735f 666f 725f 6c6f  ishi_keys_for_lo
│ │ │ │ +00022340: 6361 6c73 6572 7669 6365 7265 616c 6d5f  calservicerealm_
│ │ │ │ +00022350: 696e 5f66 696c 650a 2d2d 2d2d 2d2d 2d2d  in_file.--------
│ │ │ │  00022360: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │  00022370: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00022380: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ -00022390: 5368 6973 6869 5f6b 6579 202a 2073 6869  Shishi_key * shi
│ │ │ │ -000223a0: 7368 695f 6b65 7973 5f66 6f72 5f6c 6f63  shi_keys_for_loc
│ │ │ │ -000223b0: 616c 7365 7276 6963 6572 6561 6c6d 5f69  alservicerealm_i
│ │ │ │ -000223c0: 6e5f 6669 6c65 0a20 2020 2020 2020 2020  n_file.         
│ │ │ │ -000223d0: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ -000223e0: 452c 2063 6f6e 7374 2063 6861 7220 2a20  E, const char * 
│ │ │ │ -000223f0: 4649 4c45 4e41 4d45 2c20 636f 6e73 7420  FILENAME, const 
│ │ │ │ -00022400: 6368 6172 202a 2053 4552 5649 4345 2c0a  char * SERVICE,.
│ │ │ │ -00022410: 2020 2020 2020 2020 2020 636f 6e73 7420            const 
│ │ │ │ -00022420: 6368 6172 202a 2052 4541 4c4d 290a 2020  char * REALM).  
│ │ │ │ -00022430: 2020 2048 414e 444c 453a 2053 6869 7368     HANDLE: Shish
│ │ │ │ -00022440: 6920 6c69 6272 6172 7920 6861 6e64 6c65  i library handle
│ │ │ │ -00022450: 2063 7265 6174 6520 6279 20e2 8098 7368   create by ...sh
│ │ │ │ -00022460: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ -00022470: 2020 2020 2046 494c 454e 414d 453a 2066       FILENAME: f
│ │ │ │ -00022480: 696c 6520 746f 2072 6561 6420 6b65 7973  ile to read keys
│ │ │ │ -00022490: 2066 726f 6d2e 0a20 2020 2020 5345 5256   from..     SERV
│ │ │ │ -000224a0: 4943 453a 2073 6572 7669 6365 2074 6f20  ICE: service to 
│ │ │ │ -000224b0: 6765 7420 6b65 7920 666f 722e 0a20 2020  get key for..   
│ │ │ │ -000224c0: 2020 5245 414c 4d3a 2072 6561 6c6d 206f    REALM: realm o
│ │ │ │ -000224d0: 6620 7365 7276 6572 2074 6f20 6765 7420  f server to get 
│ │ │ │ -000224e0: 6b65 7920 666f 722c 206f 7220 4e55 4c4c  key for, or NULL
│ │ │ │ -000224f0: 2066 6f72 2064 6566 6175 6c74 2072 6561   for default rea
│ │ │ │ -00022500: 6c6d 2e0a 0a20 2020 2020 2a44 6573 6372  lm...     *Descr
│ │ │ │ -00022510: 6970 7469 6f6e 3a2a 2047 6574 206b 6579  iption:* Get key
│ │ │ │ -00022520: 2066 6f72 2073 7065 6369 6669 6564 2053   for specified S
│ │ │ │ -00022530: 4552 5649 4345 2061 6e64 2052 4541 4c4d  ERVICE and REALM
│ │ │ │ -00022540: 2066 726f 6d0a 2020 2020 2046 494c 454e   from.     FILEN
│ │ │ │ -00022550: 414d 452e 0a0a 2020 2020 202a 5265 7475  AME...     *Retu
│ │ │ │ -00022560: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ -00022570: 6e73 2074 6865 206b 6579 2066 6f72 2074  ns the key for t
│ │ │ │ -00022580: 6865 2073 6572 7665 720a 2020 2020 2022  he server.     "
│ │ │ │ -00022590: 5345 5256 4943 452f 484f 5354 4e41 4d45  SERVICE/HOSTNAME
│ │ │ │ -000225a0: 4052 4541 4c4d 2220 2877 6865 7265 2048  @REALM" (where H
│ │ │ │ -000225b0: 4f53 544e 414d 4520 6973 2074 6865 2063  OSTNAME is the c
│ │ │ │ -000225c0: 7572 7265 6e74 2073 7973 7465 6d27 730a  urrent system's.
│ │ │ │ -000225d0: 2020 2020 2068 6f73 746e 616d 6529 2c20       hostname), 
│ │ │ │ -000225e0: 7265 6164 2066 726f 6d20 7468 6520 6465  read from the de
│ │ │ │ -000225f0: 6661 756c 7420 686f 7374 206b 6579 7320  fault host keys 
│ │ │ │ -00022600: 6669 6c65 2028 7365 650a 2020 2020 20e2  file (see.     .
│ │ │ │ -00022610: 8098 7368 6973 6869 5f68 6f73 746b 6579  ..shishi_hostkey
│ │ │ │ -00022620: 735f 6465 6661 756c 745f 6669 6c65 2829  s_default_file()
│ │ │ │ -00022630: e280 9929 2c20 6f72 204e 554c 4c20 6966  ...), or NULL if
│ │ │ │ -00022640: 206e 6f20 6b65 7920 636f 756c 6420 6265   no key could be
│ │ │ │ -00022650: 2066 6f75 6e64 0a20 2020 2020 6f72 2061   found.     or a
│ │ │ │ -00022660: 6e20 6572 726f 7220 656e 636f 756e 7465  n error encounte
│ │ │ │ -00022670: 7265 642e 0a0a 2020 2054 6865 2070 7265  red...   The pre
│ │ │ │ -00022680: 7669 6f75 7320 6675 6e63 7469 6f6e 7320  vious functions 
│ │ │ │ -00022690: 7265 7175 6972 6520 7468 6174 2074 6865  require that the
│ │ │ │ -000226a0: 2066 696c 656e 616d 6520 6973 206b 6e6f   filename is kno
│ │ │ │ -000226b0: 776e 2e20 2046 6f72 2073 6f6d 650a 6170  wn.  For some.ap
│ │ │ │ -000226c0: 706c 6963 6174 696f 6e73 2c20 7365 7276  plications, serv
│ │ │ │ -000226d0: 6572 732c 2069 7420 6d61 6b65 7320 7365  ers, it makes se
│ │ │ │ -000226e0: 6e73 6520 746f 2070 726f 7669 6465 2061  nse to provide a
│ │ │ │ -000226f0: 2073 7973 7465 6d20 6465 6661 756c 742e   system default.
│ │ │ │ -00022700: 0a54 6865 7365 206b 6579 2073 6574 7320  .These key sets 
│ │ │ │ -00022710: 7573 6564 2062 7920 7365 7276 6572 2061  used by server a
│ │ │ │ -00022720: 7070 6c69 6361 7469 6f6e 7320 6172 6520  pplications are 
│ │ │ │ -00022730: 6b6e 6f77 6e20 6173 2022 686f 7374 6b65  known as "hostke
│ │ │ │ -00022740: 7973 222e 0a48 6572 6520 6172 6520 7468  ys"..Here are th
│ │ │ │ -00022750: 6520 6675 6e63 7469 6f6e 7320 7468 6174  e functions that
│ │ │ │ -00022760: 206f 7065 7261 7465 206f 6e20 686f 7374   operate on host
│ │ │ │ -00022770: 6b65 7973 2028 7468 6579 2061 7265 206d  keys (they are m
│ │ │ │ -00022780: 6f73 746c 790a 7772 6170 7065 7273 2061  ostly.wrappers a
│ │ │ │ -00022790: 726f 756e 6420 6765 6e65 7269 6320 6b65  round generic ke
│ │ │ │ -000227a0: 7920 7365 7473 292e 0a0a 7368 6973 6869  y sets)...shishi
│ │ │ │ -000227b0: 5f68 6f73 746b 6579 735f 6465 6661 756c  _hostkeys_defaul
│ │ │ │ -000227c0: 745f 6669 6c65 0a2d 2d2d 2d2d 2d2d 2d2d  t_file.---------
│ │ │ │ +00022380: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ +00022390: 2053 6869 7368 695f 6b65 7920 2a20 7368   Shishi_key * sh
│ │ │ │ +000223a0: 6973 6869 5f6b 6579 735f 666f 725f 6c6f  ishi_keys_for_lo
│ │ │ │ +000223b0: 6361 6c73 6572 7669 6365 7265 616c 6d5f  calservicerealm_
│ │ │ │ +000223c0: 696e 5f66 696c 650a 2020 2020 2020 2020  in_file.        
│ │ │ │ +000223d0: 2020 2853 6869 7368 6920 2a20 4841 4e44    (Shishi * HAND
│ │ │ │ +000223e0: 4c45 2c20 636f 6e73 7420 6368 6172 202a  LE, const char *
│ │ │ │ +000223f0: 2046 494c 454e 414d 452c 2063 6f6e 7374   FILENAME, const
│ │ │ │ +00022400: 2063 6861 7220 2a20 5345 5256 4943 452c   char * SERVICE,
│ │ │ │ +00022410: 0a20 2020 2020 2020 2020 2063 6f6e 7374  .          const
│ │ │ │ +00022420: 2063 6861 7220 2a20 5245 414c 4d29 0a20   char * REALM). 
│ │ │ │ +00022430: 2020 2020 4841 4e44 4c45 3a20 5368 6973      HANDLE: Shis
│ │ │ │ +00022440: 6869 206c 6962 7261 7279 2068 616e 646c  hi library handl
│ │ │ │ +00022450: 6520 6372 6561 7465 2062 7920 e280 9873  e create by ...s
│ │ │ │ +00022460: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ +00022470: 0a20 2020 2020 4649 4c45 4e41 4d45 3a20  .     FILENAME: 
│ │ │ │ +00022480: 6669 6c65 2074 6f20 7265 6164 206b 6579  file to read key
│ │ │ │ +00022490: 7320 6672 6f6d 2e0a 2020 2020 2053 4552  s from..     SER
│ │ │ │ +000224a0: 5649 4345 3a20 7365 7276 6963 6520 746f  VICE: service to
│ │ │ │ +000224b0: 2067 6574 206b 6579 2066 6f72 2e0a 2020   get key for..  
│ │ │ │ +000224c0: 2020 2052 4541 4c4d 3a20 7265 616c 6d20     REALM: realm 
│ │ │ │ +000224d0: 6f66 2073 6572 7665 7220 746f 2067 6574  of server to get
│ │ │ │ +000224e0: 206b 6579 2066 6f72 2c20 6f72 204e 554c   key for, or NUL
│ │ │ │ +000224f0: 4c20 666f 7220 6465 6661 756c 7420 7265  L for default re
│ │ │ │ +00022500: 616c 6d2e 0a0a 2020 2020 202a 4465 7363  alm...     *Desc
│ │ │ │ +00022510: 7269 7074 696f 6e3a 2a20 4765 7420 6b65  ription:* Get ke
│ │ │ │ +00022520: 7920 666f 7220 7370 6563 6966 6965 6420  y for specified 
│ │ │ │ +00022530: 5345 5256 4943 4520 616e 6420 5245 414c  SERVICE and REAL
│ │ │ │ +00022540: 4d20 6672 6f6d 0a20 2020 2020 4649 4c45  M from.     FILE
│ │ │ │ +00022550: 4e41 4d45 2e0a 0a20 2020 2020 2a52 6574  NAME...     *Ret
│ │ │ │ +00022560: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ +00022570: 726e 7320 7468 6520 6b65 7920 666f 7220  rns the key for 
│ │ │ │ +00022580: 7468 6520 7365 7276 6572 0a20 2020 2020  the server.     
│ │ │ │ +00022590: 2253 4552 5649 4345 2f48 4f53 544e 414d  "SERVICE/HOSTNAM
│ │ │ │ +000225a0: 4540 5245 414c 4d22 2028 7768 6572 6520  E@REALM" (where 
│ │ │ │ +000225b0: 484f 5354 4e41 4d45 2069 7320 7468 6520  HOSTNAME is the 
│ │ │ │ +000225c0: 6375 7272 656e 7420 7379 7374 656d 2773  current system's
│ │ │ │ +000225d0: 0a20 2020 2020 686f 7374 6e61 6d65 292c  .     hostname),
│ │ │ │ +000225e0: 2072 6561 6420 6672 6f6d 2074 6865 2064   read from the d
│ │ │ │ +000225f0: 6566 6175 6c74 2068 6f73 7420 6b65 7973  efault host keys
│ │ │ │ +00022600: 2066 696c 6520 2873 6565 0a20 2020 2020   file (see.     
│ │ │ │ +00022610: e280 9873 6869 7368 695f 686f 7374 6b65  ...shishi_hostke
│ │ │ │ +00022620: 7973 5f64 6566 6175 6c74 5f66 696c 6528  ys_default_file(
│ │ │ │ +00022630: 29e2 8099 292c 206f 7220 4e55 4c4c 2069  )...), or NULL i
│ │ │ │ +00022640: 6620 6e6f 206b 6579 2063 6f75 6c64 2062  f no key could b
│ │ │ │ +00022650: 6520 666f 756e 640a 2020 2020 206f 7220  e found.     or 
│ │ │ │ +00022660: 616e 2065 7272 6f72 2065 6e63 6f75 6e74  an error encount
│ │ │ │ +00022670: 6572 6564 2e0a 0a20 2020 5468 6520 7072  ered...   The pr
│ │ │ │ +00022680: 6576 696f 7573 2066 756e 6374 696f 6e73  evious functions
│ │ │ │ +00022690: 2072 6571 7569 7265 2074 6861 7420 7468   require that th
│ │ │ │ +000226a0: 6520 6669 6c65 6e61 6d65 2069 7320 6b6e  e filename is kn
│ │ │ │ +000226b0: 6f77 6e2e 2020 466f 7220 736f 6d65 0a61  own.  For some.a
│ │ │ │ +000226c0: 7070 6c69 6361 7469 6f6e 732c 2073 6572  pplications, ser
│ │ │ │ +000226d0: 7665 7273 2c20 6974 206d 616b 6573 2073  vers, it makes s
│ │ │ │ +000226e0: 656e 7365 2074 6f20 7072 6f76 6964 6520  ense to provide 
│ │ │ │ +000226f0: 6120 7379 7374 656d 2064 6566 6175 6c74  a system default
│ │ │ │ +00022700: 2e0a 5468 6573 6520 6b65 7920 7365 7473  ..These key sets
│ │ │ │ +00022710: 2075 7365 6420 6279 2073 6572 7665 7220   used by server 
│ │ │ │ +00022720: 6170 706c 6963 6174 696f 6e73 2061 7265  applications are
│ │ │ │ +00022730: 206b 6e6f 776e 2061 7320 2268 6f73 746b   known as "hostk
│ │ │ │ +00022740: 6579 7322 2e0a 4865 7265 2061 7265 2074  eys"..Here are t
│ │ │ │ +00022750: 6865 2066 756e 6374 696f 6e73 2074 6861  he functions tha
│ │ │ │ +00022760: 7420 6f70 6572 6174 6520 6f6e 2068 6f73  t operate on hos
│ │ │ │ +00022770: 746b 6579 7320 2874 6865 7920 6172 6520  tkeys (they are 
│ │ │ │ +00022780: 6d6f 7374 6c79 0a77 7261 7070 6572 7320  mostly.wrappers 
│ │ │ │ +00022790: 6172 6f75 6e64 2067 656e 6572 6963 206b  around generic k
│ │ │ │ +000227a0: 6579 2073 6574 7329 2e0a 0a73 6869 7368  ey sets)...shish
│ │ │ │ +000227b0: 695f 686f 7374 6b65 7973 5f64 6566 6175  i_hostkeys_defau
│ │ │ │ +000227c0: 6c74 5f66 696c 650a 2d2d 2d2d 2d2d 2d2d  lt_file.--------
│ │ │ │  000227d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000227e0: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ -000227f0: 6e3a 2063 6f6e 7374 2063 6861 7220 2a20  n: const char * 
│ │ │ │ -00022800: 7368 6973 6869 5f68 6f73 746b 6579 735f  shishi_hostkeys_
│ │ │ │ -00022810: 6465 6661 756c 745f 6669 6c65 0a20 2020  default_file.   
│ │ │ │ -00022820: 2020 2020 2020 2028 5368 6973 6869 202a         (Shishi *
│ │ │ │ -00022830: 2048 414e 444c 4529 0a20 2020 2020 4841   HANDLE).     HA
│ │ │ │ -00022840: 4e44 4c45 3a20 5368 6973 6869 206c 6962  NDLE: Shishi lib
│ │ │ │ -00022850: 7261 7279 2068 616e 646c 6520 6372 6561  rary handle crea
│ │ │ │ -00022860: 7465 2062 7920 e280 9873 6869 7368 695f  te by ...shishi_
│ │ │ │ -00022870: 696e 6974 2829 e280 992e 0a0a 2020 2020  init()......    
│ │ │ │ -00022880: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ -00022890: 4765 7420 6669 6c65 206e 616d 6520 6f66  Get file name of
│ │ │ │ -000228a0: 2064 6566 6175 6c74 2068 6f73 7420 6b65   default host ke
│ │ │ │ -000228b0: 7920 6669 6c65 2e0a 0a20 2020 2020 2a52  y file...     *R
│ │ │ │ -000228c0: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ -000228d0: 7475 726e 7320 7468 6520 6465 6661 756c  turns the defaul
│ │ │ │ -000228e0: 7420 686f 7374 206b 6579 2066 696c 656e  t host key filen
│ │ │ │ -000228f0: 616d 6520 7573 6564 2069 6e20 7468 650a  ame used in the.
│ │ │ │ -00022900: 2020 2020 206c 6962 7261 7279 2e20 2028       library.  (
│ │ │ │ -00022910: 4e6f 7420 6120 636f 7079 206f 6620 6974  Not a copy of it
│ │ │ │ -00022920: 2c20 736f 2064 6f6e 2774 206d 6f64 6966  , so don't modif
│ │ │ │ -00022930: 7920 6f72 2064 6561 6c6c 6f63 6174 6520  y or deallocate 
│ │ │ │ -00022940: 6974 2e29 0a0a 7368 6973 6869 5f68 6f73  it.)..shishi_hos
│ │ │ │ -00022950: 746b 6579 735f 6465 6661 756c 745f 6669  tkeys_default_fi
│ │ │ │ -00022960: 6c65 5f73 6574 0a2d 2d2d 2d2d 2d2d 2d2d  le_set.---------
│ │ │ │ +000227e0: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ +000227f0: 6f6e 3a20 636f 6e73 7420 6368 6172 202a  on: const char *
│ │ │ │ +00022800: 2073 6869 7368 695f 686f 7374 6b65 7973   shishi_hostkeys
│ │ │ │ +00022810: 5f64 6566 6175 6c74 5f66 696c 650a 2020  _default_file.  
│ │ │ │ +00022820: 2020 2020 2020 2020 2853 6869 7368 6920          (Shishi 
│ │ │ │ +00022830: 2a20 4841 4e44 4c45 290a 2020 2020 2048  * HANDLE).     H
│ │ │ │ +00022840: 414e 444c 453a 2053 6869 7368 6920 6c69  ANDLE: Shishi li
│ │ │ │ +00022850: 6272 6172 7920 6861 6e64 6c65 2063 7265  brary handle cre
│ │ │ │ +00022860: 6174 6520 6279 20e2 8098 7368 6973 6869  ate by ...shishi
│ │ │ │ +00022870: 5f69 6e69 7428 29e2 8099 2e0a 0a20 2020  _init()......   
│ │ │ │ +00022880: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ +00022890: 2047 6574 2066 696c 6520 6e61 6d65 206f   Get file name o
│ │ │ │ +000228a0: 6620 6465 6661 756c 7420 686f 7374 206b  f default host k
│ │ │ │ +000228b0: 6579 2066 696c 652e 0a0a 2020 2020 202a  ey file...     *
│ │ │ │ +000228c0: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ +000228d0: 6574 7572 6e73 2074 6865 2064 6566 6175  eturns the defau
│ │ │ │ +000228e0: 6c74 2068 6f73 7420 6b65 7920 6669 6c65  lt host key file
│ │ │ │ +000228f0: 6e61 6d65 2075 7365 6420 696e 2074 6865  name used in the
│ │ │ │ +00022900: 0a20 2020 2020 6c69 6272 6172 792e 2020  .     library.  
│ │ │ │ +00022910: 284e 6f74 2061 2063 6f70 7920 6f66 2069  (Not a copy of i
│ │ │ │ +00022920: 742c 2073 6f20 646f 6e27 7420 6d6f 6469  t, so don't modi
│ │ │ │ +00022930: 6679 206f 7220 6465 616c 6c6f 6361 7465  fy or deallocate
│ │ │ │ +00022940: 2069 742e 290a 0a73 6869 7368 695f 686f   it.)..shishi_ho
│ │ │ │ +00022950: 7374 6b65 7973 5f64 6566 6175 6c74 5f66  stkeys_default_f
│ │ │ │ +00022960: 696c 655f 7365 740a 2d2d 2d2d 2d2d 2d2d  ile_set.--------
│ │ │ │  00022970: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00022980: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ -00022990: 6374 696f 6e3a 2076 6f69 6420 7368 6973  ction: void shis
│ │ │ │ -000229a0: 6869 5f68 6f73 746b 6579 735f 6465 6661  hi_hostkeys_defa
│ │ │ │ -000229b0: 756c 745f 6669 6c65 5f73 6574 2028 5368  ult_file_set (Sh
│ │ │ │ -000229c0: 6973 6869 202a 2048 414e 444c 452c 0a20  ishi * HANDLE,. 
│ │ │ │ -000229d0: 2020 2020 2020 2020 2063 6f6e 7374 2063           const c
│ │ │ │ -000229e0: 6861 7220 2a20 484f 5354 4b45 5953 4649  har * HOSTKEYSFI
│ │ │ │ -000229f0: 4c45 290a 2020 2020 2048 414e 444c 453a  LE).     HANDLE:
│ │ │ │ -00022a00: 2053 6869 7368 6920 6c69 6272 6172 7920   Shishi library 
│ │ │ │ -00022a10: 6861 6e64 6c65 2063 7265 6174 6520 6279  handle create by
│ │ │ │ -00022a20: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ -00022a30: 29e2 8099 2e0a 2020 2020 2048 4f53 544b  ).....     HOSTK
│ │ │ │ -00022a40: 4559 5346 494c 453a 2073 7472 696e 6720  EYSFILE: string 
│ │ │ │ -00022a50: 7769 7468 206e 6577 2064 6566 6175 6c74  with new default
│ │ │ │ -00022a60: 2068 6f73 746b 6579 7320 6669 6c65 206e   hostkeys file n
│ │ │ │ -00022a70: 616d 652c 206f 7220 4e55 4c4c 0a20 2020  ame, or NULL.   
│ │ │ │ -00022a80: 2020 746f 2072 6573 6574 2074 6f20 6465    to reset to de
│ │ │ │ -00022a90: 6661 756c 742e 0a0a 2020 2020 202a 4465  fault...     *De
│ │ │ │ -00022aa0: 7363 7269 7074 696f 6e3a 2a20 5365 7420  scription:* Set 
│ │ │ │ -00022ab0: 7468 6520 6465 6661 756c 7420 686f 7374  the default host
│ │ │ │ -00022ac0: 206b 6579 2066 696c 656e 616d 6520 7573   key filename us
│ │ │ │ -00022ad0: 6564 2069 6e20 7468 650a 2020 2020 206c  ed in the.     l
│ │ │ │ -00022ae0: 6962 7261 7279 2e20 2054 6865 2073 7472  ibrary.  The str
│ │ │ │ -00022af0: 696e 6720 6973 2063 6f70 6965 6420 696e  ing is copied in
│ │ │ │ -00022b00: 746f 2074 6865 206c 6962 7261 7279 2c20  to the library, 
│ │ │ │ -00022b10: 736f 2079 6f75 2063 616e 2064 6973 706f  so you can dispo
│ │ │ │ -00022b20: 7365 0a20 2020 2020 6f66 2074 6865 2076  se.     of the v
│ │ │ │ -00022b30: 6172 6961 626c 6520 696d 6d65 6469 6174  ariable immediat
│ │ │ │ -00022b40: 656c 7920 6166 7465 7220 6361 6c6c 696e  ely after callin
│ │ │ │ -00022b50: 6720 7468 6973 2066 756e 6374 696f 6e2e  g this function.
│ │ │ │ -00022b60: 0a0a 7368 6973 6869 5f68 6f73 746b 6579  ..shishi_hostkey
│ │ │ │ -00022b70: 735f 666f 725f 7365 7276 6572 0a2d 2d2d  s_for_server.---
│ │ │ │ +00022980: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ +00022990: 6e63 7469 6f6e 3a20 766f 6964 2073 6869  nction: void shi
│ │ │ │ +000229a0: 7368 695f 686f 7374 6b65 7973 5f64 6566  shi_hostkeys_def
│ │ │ │ +000229b0: 6175 6c74 5f66 696c 655f 7365 7420 2853  ault_file_set (S
│ │ │ │ +000229c0: 6869 7368 6920 2a20 4841 4e44 4c45 2c0a  hishi * HANDLE,.
│ │ │ │ +000229d0: 2020 2020 2020 2020 2020 636f 6e73 7420            const 
│ │ │ │ +000229e0: 6368 6172 202a 2048 4f53 544b 4559 5346  char * HOSTKEYSF
│ │ │ │ +000229f0: 494c 4529 0a20 2020 2020 4841 4e44 4c45  ILE).     HANDLE
│ │ │ │ +00022a00: 3a20 5368 6973 6869 206c 6962 7261 7279  : Shishi library
│ │ │ │ +00022a10: 2068 616e 646c 6520 6372 6561 7465 2062   handle create b
│ │ │ │ +00022a20: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ +00022a30: 2829 e280 992e 0a20 2020 2020 484f 5354  ().....     HOST
│ │ │ │ +00022a40: 4b45 5953 4649 4c45 3a20 7374 7269 6e67  KEYSFILE: string
│ │ │ │ +00022a50: 2077 6974 6820 6e65 7720 6465 6661 756c   with new defaul
│ │ │ │ +00022a60: 7420 686f 7374 6b65 7973 2066 696c 6520  t hostkeys file 
│ │ │ │ +00022a70: 6e61 6d65 2c20 6f72 204e 554c 4c0a 2020  name, or NULL.  
│ │ │ │ +00022a80: 2020 2074 6f20 7265 7365 7420 746f 2064     to reset to d
│ │ │ │ +00022a90: 6566 6175 6c74 2e0a 0a20 2020 2020 2a44  efault...     *D
│ │ │ │ +00022aa0: 6573 6372 6970 7469 6f6e 3a2a 2053 6574  escription:* Set
│ │ │ │ +00022ab0: 2074 6865 2064 6566 6175 6c74 2068 6f73   the default hos
│ │ │ │ +00022ac0: 7420 6b65 7920 6669 6c65 6e61 6d65 2075  t key filename u
│ │ │ │ +00022ad0: 7365 6420 696e 2074 6865 0a20 2020 2020  sed in the.     
│ │ │ │ +00022ae0: 6c69 6272 6172 792e 2020 5468 6520 7374  library.  The st
│ │ │ │ +00022af0: 7269 6e67 2069 7320 636f 7069 6564 2069  ring is copied i
│ │ │ │ +00022b00: 6e74 6f20 7468 6520 6c69 6272 6172 792c  nto the library,
│ │ │ │ +00022b10: 2073 6f20 796f 7520 6361 6e20 6469 7370   so you can disp
│ │ │ │ +00022b20: 6f73 650a 2020 2020 206f 6620 7468 6520  ose.     of the 
│ │ │ │ +00022b30: 7661 7269 6162 6c65 2069 6d6d 6564 6961  variable immedia
│ │ │ │ +00022b40: 7465 6c79 2061 6674 6572 2063 616c 6c69  tely after calli
│ │ │ │ +00022b50: 6e67 2074 6869 7320 6675 6e63 7469 6f6e  ng this function
│ │ │ │ +00022b60: 2e0a 0a73 6869 7368 695f 686f 7374 6b65  ...shishi_hostke
│ │ │ │ +00022b70: 7973 5f66 6f72 5f73 6572 7665 720a 2d2d  ys_for_server.--
│ │ │ │  00022b80: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00022b90: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ -00022ba0: 6374 696f 6e3a 2053 6869 7368 695f 6b65  ction: Shishi_ke
│ │ │ │ -00022bb0: 7920 2a20 7368 6973 6869 5f68 6f73 746b  y * shishi_hostk
│ │ │ │ -00022bc0: 6579 735f 666f 725f 7365 7276 6572 2028  eys_for_server (
│ │ │ │ -00022bd0: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ -00022be0: 0a20 2020 2020 2020 2020 2063 6f6e 7374  .          const
│ │ │ │ -00022bf0: 2063 6861 7220 2a20 5345 5256 4552 290a   char * SERVER).
│ │ │ │ -00022c00: 2020 2020 2048 414e 444c 453a 2053 6869       HANDLE: Shi
│ │ │ │ -00022c10: 7368 6920 6c69 6272 6172 7920 6861 6e64  shi library hand
│ │ │ │ -00022c20: 6c65 2063 7265 6174 6520 6279 20e2 8098  le create by ...
│ │ │ │ -00022c30: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ -00022c40: 2e0a 2020 2020 2053 4552 5645 523a 2073  ..     SERVER: s
│ │ │ │ -00022c50: 6572 7665 7220 6e61 6d65 2074 6f20 6765  erver name to ge
│ │ │ │ -00022c60: 7420 6b65 7920 666f 720a 0a20 2020 2020  t key for..     
│ │ │ │ -00022c70: 2a44 6573 6372 6970 7469 6f6e 3a2a 2047  *Description:* G
│ │ │ │ -00022c80: 6574 2068 6f73 7420 6b65 7920 666f 7220  et host key for 
│ │ │ │ -00022c90: 5345 5256 4552 2e0a 0a20 2020 2020 2a52  SERVER...     *R
│ │ │ │ -00022ca0: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ -00022cb0: 7475 726e 7320 7468 6520 6b65 7920 666f  turns the key fo
│ │ │ │ -00022cc0: 7220 7370 6563 6966 6963 2073 6572 7665  r specific serve
│ │ │ │ -00022cd0: 722c 2072 6561 6420 6672 6f6d 2074 6865  r, read from the
│ │ │ │ -00022ce0: 0a20 2020 2020 6465 6661 756c 7420 686f  .     default ho
│ │ │ │ -00022cf0: 7374 206b 6579 7320 6669 6c65 2028 7365  st keys file (se
│ │ │ │ -00022d00: 6520 e280 9873 6869 7368 695f 686f 7374  e ...shishi_host
│ │ │ │ -00022d10: 6b65 7973 5f64 6566 6175 6c74 5f66 696c  keys_default_fil
│ │ │ │ -00022d20: 6528 29e2 8099 292c 206f 720a 2020 2020  e()...), or.    
│ │ │ │ -00022d30: 204e 554c 4c20 6966 206e 6f20 6b65 7920   NULL if no key 
│ │ │ │ -00022d40: 636f 756c 6420 6265 2066 6f75 6e64 206f  could be found o
│ │ │ │ -00022d50: 7220 616e 2065 7272 6f72 2065 6e63 6f75  r an error encou
│ │ │ │ -00022d60: 6e74 6572 6564 2e0a 0a73 6869 7368 695f  ntered...shishi_
│ │ │ │ -00022d70: 686f 7374 6b65 7973 5f66 6f72 5f73 6572  hostkeys_for_ser
│ │ │ │ -00022d80: 7665 7272 6561 6c6d 0a2d 2d2d 2d2d 2d2d  verrealm.-------
│ │ │ │ +00022b90: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ +00022ba0: 6e63 7469 6f6e 3a20 5368 6973 6869 5f6b  nction: Shishi_k
│ │ │ │ +00022bb0: 6579 202a 2073 6869 7368 695f 686f 7374  ey * shishi_host
│ │ │ │ +00022bc0: 6b65 7973 5f66 6f72 5f73 6572 7665 7220  keys_for_server 
│ │ │ │ +00022bd0: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ +00022be0: 2c0a 2020 2020 2020 2020 2020 636f 6e73  ,.          cons
│ │ │ │ +00022bf0: 7420 6368 6172 202a 2053 4552 5645 5229  t char * SERVER)
│ │ │ │ +00022c00: 0a20 2020 2020 4841 4e44 4c45 3a20 5368  .     HANDLE: Sh
│ │ │ │ +00022c10: 6973 6869 206c 6962 7261 7279 2068 616e  ishi library han
│ │ │ │ +00022c20: 646c 6520 6372 6561 7465 2062 7920 e280  dle create by ..
│ │ │ │ +00022c30: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ +00022c40: 992e 0a20 2020 2020 5345 5256 4552 3a20  ...     SERVER: 
│ │ │ │ +00022c50: 7365 7276 6572 206e 616d 6520 746f 2067  server name to g
│ │ │ │ +00022c60: 6574 206b 6579 2066 6f72 0a0a 2020 2020  et key for..    
│ │ │ │ +00022c70: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ +00022c80: 4765 7420 686f 7374 206b 6579 2066 6f72  Get host key for
│ │ │ │ +00022c90: 2053 4552 5645 522e 0a0a 2020 2020 202a   SERVER...     *
│ │ │ │ +00022ca0: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ +00022cb0: 6574 7572 6e73 2074 6865 206b 6579 2066  eturns the key f
│ │ │ │ +00022cc0: 6f72 2073 7065 6369 6669 6320 7365 7276  or specific serv
│ │ │ │ +00022cd0: 6572 2c20 7265 6164 2066 726f 6d20 7468  er, read from th
│ │ │ │ +00022ce0: 650a 2020 2020 2064 6566 6175 6c74 2068  e.     default h
│ │ │ │ +00022cf0: 6f73 7420 6b65 7973 2066 696c 6520 2873  ost keys file (s
│ │ │ │ +00022d00: 6565 20e2 8098 7368 6973 6869 5f68 6f73  ee ...shishi_hos
│ │ │ │ +00022d10: 746b 6579 735f 6465 6661 756c 745f 6669  tkeys_default_fi
│ │ │ │ +00022d20: 6c65 2829 e280 9929 2c20 6f72 0a20 2020  le()...), or.   
│ │ │ │ +00022d30: 2020 4e55 4c4c 2069 6620 6e6f 206b 6579    NULL if no key
│ │ │ │ +00022d40: 2063 6f75 6c64 2062 6520 666f 756e 6420   could be found 
│ │ │ │ +00022d50: 6f72 2061 6e20 6572 726f 7220 656e 636f  or an error enco
│ │ │ │ +00022d60: 756e 7465 7265 642e 0a0a 7368 6973 6869  untered...shishi
│ │ │ │ +00022d70: 5f68 6f73 746b 6579 735f 666f 725f 7365  _hostkeys_for_se
│ │ │ │ +00022d80: 7276 6572 7265 616c 6d0a 2d2d 2d2d 2d2d  rverrealm.------
│ │ │ │  00022d90: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00022da0: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -00022db0: 6e63 7469 6f6e 3a20 5368 6973 6869 5f6b  nction: Shishi_k
│ │ │ │ -00022dc0: 6579 202a 2073 6869 7368 695f 686f 7374  ey * shishi_host
│ │ │ │ -00022dd0: 6b65 7973 5f66 6f72 5f73 6572 7665 7272  keys_for_serverr
│ │ │ │ -00022de0: 6561 6c6d 0a20 2020 2020 2020 2020 2028  ealm.          (
│ │ │ │ -00022df0: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ -00022e00: 2063 6f6e 7374 2063 6861 7220 2a20 5345   const char * SE
│ │ │ │ -00022e10: 5256 4552 2c20 636f 6e73 7420 6368 6172  RVER, const char
│ │ │ │ -00022e20: 202a 2052 4541 4c4d 290a 2020 2020 2048   * REALM).     H
│ │ │ │ -00022e30: 414e 444c 453a 2053 6869 7368 6920 6c69  ANDLE: Shishi li
│ │ │ │ -00022e40: 6272 6172 7920 6861 6e64 6c65 2063 7265  brary handle cre
│ │ │ │ -00022e50: 6174 6520 6279 20e2 8098 7368 6973 6869  ate by ...shishi
│ │ │ │ -00022e60: 5f69 6e69 7428 29e2 8099 2e0a 2020 2020  _init().....    
│ │ │ │ -00022e70: 2053 4552 5645 523a 2073 6572 7665 7220   SERVER: server 
│ │ │ │ -00022e80: 6e61 6d65 2074 6f20 6765 7420 6b65 7920  name to get key 
│ │ │ │ -00022e90: 666f 720a 2020 2020 2052 4541 4c4d 3a20  for.     REALM: 
│ │ │ │ -00022ea0: 7265 616c 6d20 6f66 2073 6572 7665 7220  realm of server 
│ │ │ │ -00022eb0: 746f 2067 6574 206b 6579 2066 6f72 2e0a  to get key for..
│ │ │ │ -00022ec0: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -00022ed0: 6f6e 3a2a 2047 6574 2068 6f73 7420 6b65  on:* Get host ke
│ │ │ │ -00022ee0: 7920 666f 7220 5345 5256 4552 2069 6e20  y for SERVER in 
│ │ │ │ -00022ef0: 5245 414c 4d2e 0a0a 2020 2020 202a 5265  REALM...     *Re
│ │ │ │ -00022f00: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ -00022f10: 7572 6e73 2074 6865 206b 6579 2066 6f72  urns the key for
│ │ │ │ -00022f20: 2073 7065 6369 6669 6320 7365 7276 6572   specific server
│ │ │ │ -00022f30: 2061 6e64 2072 6561 6c6d 2c20 7265 6164   and realm, read
│ │ │ │ -00022f40: 0a20 2020 2020 6672 6f6d 2074 6865 2064  .     from the d
│ │ │ │ -00022f50: 6566 6175 6c74 2068 6f73 7420 6b65 7973  efault host keys
│ │ │ │ -00022f60: 2066 696c 6520 2873 6565 0a20 2020 2020   file (see.     
│ │ │ │ -00022f70: e280 9873 6869 7368 695f 686f 7374 6b65  ...shishi_hostke
│ │ │ │ -00022f80: 7973 5f64 6566 6175 6c74 5f66 696c 6528  ys_default_file(
│ │ │ │ -00022f90: 29e2 8099 292c 206f 7220 4e55 4c4c 2069  )...), or NULL i
│ │ │ │ -00022fa0: 6620 6e6f 206b 6579 2063 6f75 6c64 2062  f no key could b
│ │ │ │ -00022fb0: 6520 666f 756e 640a 2020 2020 206f 7220  e found.     or 
│ │ │ │ -00022fc0: 616e 2065 7272 6f72 2065 6e63 6f75 6e74  an error encount
│ │ │ │ -00022fd0: 6572 6564 2e0a 0a73 6869 7368 695f 686f  ered...shishi_ho
│ │ │ │ -00022fe0: 7374 6b65 7973 5f66 6f72 5f6c 6f63 616c  stkeys_for_local
│ │ │ │ -00022ff0: 7365 7276 6963 6572 6561 6c6d 0a2d 2d2d  servicerealm.---
│ │ │ │ +00022da0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +00022db0: 756e 6374 696f 6e3a 2053 6869 7368 695f  unction: Shishi_
│ │ │ │ +00022dc0: 6b65 7920 2a20 7368 6973 6869 5f68 6f73  key * shishi_hos
│ │ │ │ +00022dd0: 746b 6579 735f 666f 725f 7365 7276 6572  tkeys_for_server
│ │ │ │ +00022de0: 7265 616c 6d0a 2020 2020 2020 2020 2020  realm.          
│ │ │ │ +00022df0: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ +00022e00: 2c20 636f 6e73 7420 6368 6172 202a 2053  , const char * S
│ │ │ │ +00022e10: 4552 5645 522c 2063 6f6e 7374 2063 6861  ERVER, const cha
│ │ │ │ +00022e20: 7220 2a20 5245 414c 4d29 0a20 2020 2020  r * REALM).     
│ │ │ │ +00022e30: 4841 4e44 4c45 3a20 5368 6973 6869 206c  HANDLE: Shishi l
│ │ │ │ +00022e40: 6962 7261 7279 2068 616e 646c 6520 6372  ibrary handle cr
│ │ │ │ +00022e50: 6561 7465 2062 7920 e280 9873 6869 7368  eate by ...shish
│ │ │ │ +00022e60: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ +00022e70: 2020 5345 5256 4552 3a20 7365 7276 6572    SERVER: server
│ │ │ │ +00022e80: 206e 616d 6520 746f 2067 6574 206b 6579   name to get key
│ │ │ │ +00022e90: 2066 6f72 0a20 2020 2020 5245 414c 4d3a   for.     REALM:
│ │ │ │ +00022ea0: 2072 6561 6c6d 206f 6620 7365 7276 6572   realm of server
│ │ │ │ +00022eb0: 2074 6f20 6765 7420 6b65 7920 666f 722e   to get key for.
│ │ │ │ +00022ec0: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ +00022ed0: 696f 6e3a 2a20 4765 7420 686f 7374 206b  ion:* Get host k
│ │ │ │ +00022ee0: 6579 2066 6f72 2053 4552 5645 5220 696e  ey for SERVER in
│ │ │ │ +00022ef0: 2052 4541 4c4d 2e0a 0a20 2020 2020 2a52   REALM...     *R
│ │ │ │ +00022f00: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +00022f10: 7475 726e 7320 7468 6520 6b65 7920 666f  turns the key fo
│ │ │ │ +00022f20: 7220 7370 6563 6966 6963 2073 6572 7665  r specific serve
│ │ │ │ +00022f30: 7220 616e 6420 7265 616c 6d2c 2072 6561  r and realm, rea
│ │ │ │ +00022f40: 640a 2020 2020 2066 726f 6d20 7468 6520  d.     from the 
│ │ │ │ +00022f50: 6465 6661 756c 7420 686f 7374 206b 6579  default host key
│ │ │ │ +00022f60: 7320 6669 6c65 2028 7365 650a 2020 2020  s file (see.    
│ │ │ │ +00022f70: 20e2 8098 7368 6973 6869 5f68 6f73 746b   ...shishi_hostk
│ │ │ │ +00022f80: 6579 735f 6465 6661 756c 745f 6669 6c65  eys_default_file
│ │ │ │ +00022f90: 2829 e280 9929 2c20 6f72 204e 554c 4c20  ()...), or NULL 
│ │ │ │ +00022fa0: 6966 206e 6f20 6b65 7920 636f 756c 6420  if no key could 
│ │ │ │ +00022fb0: 6265 2066 6f75 6e64 0a20 2020 2020 6f72  be found.     or
│ │ │ │ +00022fc0: 2061 6e20 6572 726f 7220 656e 636f 756e   an error encoun
│ │ │ │ +00022fd0: 7465 7265 642e 0a0a 7368 6973 6869 5f68  tered...shishi_h
│ │ │ │ +00022fe0: 6f73 746b 6579 735f 666f 725f 6c6f 6361  ostkeys_for_loca
│ │ │ │ +00022ff0: 6c73 6572 7669 6365 7265 616c 6d0a 2d2d  lservicerealm.--
│ │ │ │  00023000: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │  00023010: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00023020: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ -00023030: 3a20 5368 6973 6869 5f6b 6579 202a 2073  : Shishi_key * s
│ │ │ │ -00023040: 6869 7368 695f 686f 7374 6b65 7973 5f66  hishi_hostkeys_f
│ │ │ │ -00023050: 6f72 5f6c 6f63 616c 7365 7276 6963 6572  or_localservicer
│ │ │ │ -00023060: 6561 6c6d 0a20 2020 2020 2020 2020 2028  ealm.          (
│ │ │ │ -00023070: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ -00023080: 2063 6f6e 7374 2063 6861 7220 2a20 5345   const char * SE
│ │ │ │ -00023090: 5256 4943 452c 2063 6f6e 7374 2063 6861  RVICE, const cha
│ │ │ │ -000230a0: 7220 2a20 5245 414c 4d29 0a20 2020 2020  r * REALM).     
│ │ │ │ -000230b0: 4841 4e44 4c45 3a20 5368 6973 6869 206c  HANDLE: Shishi l
│ │ │ │ -000230c0: 6962 7261 7279 2068 616e 646c 6520 6372  ibrary handle cr
│ │ │ │ -000230d0: 6561 7465 2062 7920 e280 9873 6869 7368  eate by ...shish
│ │ │ │ -000230e0: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ -000230f0: 2020 5345 5256 4943 453a 2073 6572 7669    SERVICE: servi
│ │ │ │ -00023100: 6365 2074 6f20 6765 7420 6b65 7920 666f  ce to get key fo
│ │ │ │ -00023110: 722e 0a20 2020 2020 5245 414c 4d3a 2072  r..     REALM: r
│ │ │ │ -00023120: 6561 6c6d 206f 6620 7365 7276 6572 2074  ealm of server t
│ │ │ │ -00023130: 6f20 6765 7420 6b65 7920 666f 722c 206f  o get key for, o
│ │ │ │ -00023140: 7220 4e55 4c4c 2066 6f72 2064 6566 6175  r NULL for defau
│ │ │ │ -00023150: 6c74 2072 6561 6c6d 2e0a 0a20 2020 2020  lt realm...     
│ │ │ │ -00023160: 2a44 6573 6372 6970 7469 6f6e 3a2a 2047  *Description:* G
│ │ │ │ -00023170: 6574 2068 6f73 7420 6b65 7920 666f 7220  et host key for 
│ │ │ │ -00023180: 5345 5256 4943 4520 6f6e 2063 7572 7265  SERVICE on curre
│ │ │ │ -00023190: 6e74 2068 6f73 7420 696e 2052 4541 4c4d  nt host in REALM
│ │ │ │ -000231a0: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ -000231b0: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ -000231c0: 7468 6520 6b65 7920 666f 7220 7468 6520  the key for the 
│ │ │ │ -000231d0: 7365 7276 6572 0a20 2020 2020 2253 4552  server.     "SER
│ │ │ │ -000231e0: 5649 4345 2f48 4f53 544e 414d 4540 5245  VICE/HOSTNAME@RE
│ │ │ │ -000231f0: 414c 4d22 2028 7768 6572 6520 484f 5354  ALM" (where HOST
│ │ │ │ -00023200: 4e41 4d45 2069 7320 7468 6520 6375 7272  NAME is the curr
│ │ │ │ -00023210: 656e 7420 7379 7374 656d 2773 0a20 2020  ent system's.   
│ │ │ │ -00023220: 2020 686f 7374 6e61 6d65 292c 2072 6561    hostname), rea
│ │ │ │ -00023230: 6420 6672 6f6d 2074 6865 2064 6566 6175  d from the defau
│ │ │ │ -00023240: 6c74 2068 6f73 7420 6b65 7973 2066 696c  lt host keys fil
│ │ │ │ -00023250: 6520 2873 6565 0a20 2020 2020 e280 9873  e (see.     ...s
│ │ │ │ -00023260: 6869 7368 695f 686f 7374 6b65 7973 5f64  hishi_hostkeys_d
│ │ │ │ -00023270: 6566 6175 6c74 5f66 696c 6528 29e2 8099  efault_file()...
│ │ │ │ -00023280: 292c 206f 7220 4e55 4c4c 2069 6620 6e6f  ), or NULL if no
│ │ │ │ -00023290: 206b 6579 2063 6f75 6c64 2062 6520 666f   key could be fo
│ │ │ │ -000232a0: 756e 640a 2020 2020 206f 7220 616e 2065  und.     or an e
│ │ │ │ -000232b0: 7272 6f72 2065 6e63 6f75 6e74 6572 6564  rror encountered
│ │ │ │ -000232c0: 2e0a 0a73 6869 7368 695f 686f 7374 6b65  ...shishi_hostke
│ │ │ │ -000232d0: 7973 5f66 6f72 5f6c 6f63 616c 7365 7276  ys_for_localserv
│ │ │ │ -000232e0: 6963 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ice.------------
│ │ │ │ +00023020: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ +00023030: 6e3a 2053 6869 7368 695f 6b65 7920 2a20  n: Shishi_key * 
│ │ │ │ +00023040: 7368 6973 6869 5f68 6f73 746b 6579 735f  shishi_hostkeys_
│ │ │ │ +00023050: 666f 725f 6c6f 6361 6c73 6572 7669 6365  for_localservice
│ │ │ │ +00023060: 7265 616c 6d0a 2020 2020 2020 2020 2020  realm.          
│ │ │ │ +00023070: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ +00023080: 2c20 636f 6e73 7420 6368 6172 202a 2053  , const char * S
│ │ │ │ +00023090: 4552 5649 4345 2c20 636f 6e73 7420 6368  ERVICE, const ch
│ │ │ │ +000230a0: 6172 202a 2052 4541 4c4d 290a 2020 2020  ar * REALM).    
│ │ │ │ +000230b0: 2048 414e 444c 453a 2053 6869 7368 6920   HANDLE: Shishi 
│ │ │ │ +000230c0: 6c69 6272 6172 7920 6861 6e64 6c65 2063  library handle c
│ │ │ │ +000230d0: 7265 6174 6520 6279 20e2 8098 7368 6973  reate by ...shis
│ │ │ │ +000230e0: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ +000230f0: 2020 2053 4552 5649 4345 3a20 7365 7276     SERVICE: serv
│ │ │ │ +00023100: 6963 6520 746f 2067 6574 206b 6579 2066  ice to get key f
│ │ │ │ +00023110: 6f72 2e0a 2020 2020 2052 4541 4c4d 3a20  or..     REALM: 
│ │ │ │ +00023120: 7265 616c 6d20 6f66 2073 6572 7665 7220  realm of server 
│ │ │ │ +00023130: 746f 2067 6574 206b 6579 2066 6f72 2c20  to get key for, 
│ │ │ │ +00023140: 6f72 204e 554c 4c20 666f 7220 6465 6661  or NULL for defa
│ │ │ │ +00023150: 756c 7420 7265 616c 6d2e 0a0a 2020 2020  ult realm...    
│ │ │ │ +00023160: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ +00023170: 4765 7420 686f 7374 206b 6579 2066 6f72  Get host key for
│ │ │ │ +00023180: 2053 4552 5649 4345 206f 6e20 6375 7272   SERVICE on curr
│ │ │ │ +00023190: 656e 7420 686f 7374 2069 6e20 5245 414c  ent host in REAL
│ │ │ │ +000231a0: 4d2e 0a0a 2020 2020 202a 5265 7475 726e  M...     *Return
│ │ │ │ +000231b0: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ +000231c0: 2074 6865 206b 6579 2066 6f72 2074 6865   the key for the
│ │ │ │ +000231d0: 2073 6572 7665 720a 2020 2020 2022 5345   server.     "SE
│ │ │ │ +000231e0: 5256 4943 452f 484f 5354 4e41 4d45 4052  RVICE/HOSTNAME@R
│ │ │ │ +000231f0: 4541 4c4d 2220 2877 6865 7265 2048 4f53  EALM" (where HOS
│ │ │ │ +00023200: 544e 414d 4520 6973 2074 6865 2063 7572  TNAME is the cur
│ │ │ │ +00023210: 7265 6e74 2073 7973 7465 6d27 730a 2020  rent system's.  
│ │ │ │ +00023220: 2020 2068 6f73 746e 616d 6529 2c20 7265     hostname), re
│ │ │ │ +00023230: 6164 2066 726f 6d20 7468 6520 6465 6661  ad from the defa
│ │ │ │ +00023240: 756c 7420 686f 7374 206b 6579 7320 6669  ult host keys fi
│ │ │ │ +00023250: 6c65 2028 7365 650a 2020 2020 20e2 8098  le (see.     ...
│ │ │ │ +00023260: 7368 6973 6869 5f68 6f73 746b 6579 735f  shishi_hostkeys_
│ │ │ │ +00023270: 6465 6661 756c 745f 6669 6c65 2829 e280  default_file()..
│ │ │ │ +00023280: 9929 2c20 6f72 204e 554c 4c20 6966 206e  .), or NULL if n
│ │ │ │ +00023290: 6f20 6b65 7920 636f 756c 6420 6265 2066  o key could be f
│ │ │ │ +000232a0: 6f75 6e64 0a20 2020 2020 6f72 2061 6e20  ound.     or an 
│ │ │ │ +000232b0: 6572 726f 7220 656e 636f 756e 7465 7265  error encountere
│ │ │ │ +000232c0: 642e 0a0a 7368 6973 6869 5f68 6f73 746b  d...shishi_hostk
│ │ │ │ +000232d0: 6579 735f 666f 725f 6c6f 6361 6c73 6572  eys_for_localser
│ │ │ │ +000232e0: 7669 6365 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  vice.-----------
│ │ │ │  000232f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00023300: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -00023310: 6f6e 3a20 5368 6973 6869 5f6b 6579 202a  on: Shishi_key *
│ │ │ │ -00023320: 2073 6869 7368 695f 686f 7374 6b65 7973   shishi_hostkeys
│ │ │ │ -00023330: 5f66 6f72 5f6c 6f63 616c 7365 7276 6963  _for_localservic
│ │ │ │ -00023340: 650a 2020 2020 2020 2020 2020 2853 6869  e.          (Shi
│ │ │ │ -00023350: 7368 6920 2a20 4841 4e44 4c45 2c20 636f  shi * HANDLE, co
│ │ │ │ -00023360: 6e73 7420 6368 6172 202a 2053 4552 5649  nst char * SERVI
│ │ │ │ -00023370: 4345 290a 2020 2020 2048 414e 444c 453a  CE).     HANDLE:
│ │ │ │ -00023380: 2053 6869 7368 6920 6c69 6272 6172 7920   Shishi library 
│ │ │ │ -00023390: 6861 6e64 6c65 2063 7265 6174 6520 6279  handle create by
│ │ │ │ -000233a0: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ -000233b0: 29e2 8099 2e0a 2020 2020 2053 4552 5649  ).....     SERVI
│ │ │ │ -000233c0: 4345 3a20 7365 7276 6963 6520 746f 2067  CE: service to g
│ │ │ │ -000233d0: 6574 206b 6579 2066 6f72 2e0a 0a20 2020  et key for...   
│ │ │ │ -000233e0: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ -000233f0: 2047 6574 2068 6f73 7420 6b65 7920 666f   Get host key fo
│ │ │ │ -00023400: 7220 5345 5256 4943 4520 6f6e 2063 7572  r SERVICE on cur
│ │ │ │ -00023410: 7265 6e74 2068 6f73 7420 696e 2064 6566  rent host in def
│ │ │ │ -00023420: 6175 6c74 0a20 2020 2020 7265 616c 6d2e  ault.     realm.
│ │ │ │ -00023430: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ -00023440: 616c 7565 3a2a 2052 6574 7572 6e73 2074  alue:* Returns t
│ │ │ │ -00023450: 6865 206b 6579 2066 6f72 2074 6865 2073  he key for the s
│ │ │ │ -00023460: 6572 7665 7220 2253 4552 5649 4345 2f48  erver "SERVICE/H
│ │ │ │ -00023470: 4f53 544e 414d 4522 0a20 2020 2020 2877  OSTNAME".     (w
│ │ │ │ -00023480: 6865 7265 2048 4f53 544e 414d 4520 6973  here HOSTNAME is
│ │ │ │ -00023490: 2074 6865 2063 7572 7265 6e74 2073 7973   the current sys
│ │ │ │ -000234a0: 7465 6d27 7320 686f 7374 6e61 6d65 292c  tem's hostname),
│ │ │ │ -000234b0: 2072 6561 6420 6672 6f6d 2074 6865 0a20   read from the. 
│ │ │ │ -000234c0: 2020 2020 6465 6661 756c 7420 686f 7374      default host
│ │ │ │ -000234d0: 206b 6579 7320 6669 6c65 2028 7365 6520   keys file (see 
│ │ │ │ -000234e0: e280 9873 6869 7368 695f 686f 7374 6b65  ...shishi_hostke
│ │ │ │ -000234f0: 7973 5f64 6566 6175 6c74 5f66 696c 6528  ys_default_file(
│ │ │ │ -00023500: 29e2 8099 292c 206f 720a 2020 2020 204e  )...), or.     N
│ │ │ │ -00023510: 554c 4c20 6966 206e 6f20 6b65 7920 636f  ULL if no key co
│ │ │ │ -00023520: 756c 6420 6265 2066 6f75 6e64 206f 7220  uld be found or 
│ │ │ │ -00023530: 616e 2065 7272 6f72 2065 6e63 6f75 6e74  an error encount
│ │ │ │ -00023540: 6572 6564 2e0a 0a20 2020 4166 7465 7220  ered...   After 
│ │ │ │ -00023550: 6372 6561 7469 6e67 2074 6865 206b 6579  creating the key
│ │ │ │ -00023560: 2073 7472 7563 7475 7265 2c20 6974 2063   structure, it c
│ │ │ │ -00023570: 616e 2062 6520 7573 6564 2074 6f20 656e  an be used to en
│ │ │ │ -00023580: 6372 7970 7420 616e 640a 6465 6372 7970  crypt and.decryp
│ │ │ │ -00023590: 7420 6461 7461 2c20 6361 6c63 756c 6174  t data, calculat
│ │ │ │ -000235a0: 6520 6368 6563 6b73 756d 206f 6e20 6461  e checksum on da
│ │ │ │ -000235b0: 7461 2065 7463 2e20 2041 6c6c 2061 7661  ta etc.  All ava
│ │ │ │ -000235c0: 696c 6162 6c65 2066 756e 6374 696f 6e73  ilable functions
│ │ │ │ -000235d0: 0a61 7265 2064 6573 6372 6962 6564 206e  .are described n
│ │ │ │ -000235e0: 6f77 2e0a 0a73 6869 7368 695f 6369 7068  ow...shishi_ciph
│ │ │ │ -000235f0: 6572 5f73 7570 706f 7274 6564 5f70 0a2d  er_supported_p.-
│ │ │ │ +00023300: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +00023310: 696f 6e3a 2053 6869 7368 695f 6b65 7920  ion: Shishi_key 
│ │ │ │ +00023320: 2a20 7368 6973 6869 5f68 6f73 746b 6579  * shishi_hostkey
│ │ │ │ +00023330: 735f 666f 725f 6c6f 6361 6c73 6572 7669  s_for_localservi
│ │ │ │ +00023340: 6365 0a20 2020 2020 2020 2020 2028 5368  ce.          (Sh
│ │ │ │ +00023350: 6973 6869 202a 2048 414e 444c 452c 2063  ishi * HANDLE, c
│ │ │ │ +00023360: 6f6e 7374 2063 6861 7220 2a20 5345 5256  onst char * SERV
│ │ │ │ +00023370: 4943 4529 0a20 2020 2020 4841 4e44 4c45  ICE).     HANDLE
│ │ │ │ +00023380: 3a20 5368 6973 6869 206c 6962 7261 7279  : Shishi library
│ │ │ │ +00023390: 2068 616e 646c 6520 6372 6561 7465 2062   handle create b
│ │ │ │ +000233a0: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ +000233b0: 2829 e280 992e 0a20 2020 2020 5345 5256  ().....     SERV
│ │ │ │ +000233c0: 4943 453a 2073 6572 7669 6365 2074 6f20  ICE: service to 
│ │ │ │ +000233d0: 6765 7420 6b65 7920 666f 722e 0a0a 2020  get key for...  
│ │ │ │ +000233e0: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ +000233f0: 2a20 4765 7420 686f 7374 206b 6579 2066  * Get host key f
│ │ │ │ +00023400: 6f72 2053 4552 5649 4345 206f 6e20 6375  or SERVICE on cu
│ │ │ │ +00023410: 7272 656e 7420 686f 7374 2069 6e20 6465  rrent host in de
│ │ │ │ +00023420: 6661 756c 740a 2020 2020 2072 6561 6c6d  fault.     realm
│ │ │ │ +00023430: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ +00023440: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ +00023450: 7468 6520 6b65 7920 666f 7220 7468 6520  the key for the 
│ │ │ │ +00023460: 7365 7276 6572 2022 5345 5256 4943 452f  server "SERVICE/
│ │ │ │ +00023470: 484f 5354 4e41 4d45 220a 2020 2020 2028  HOSTNAME".     (
│ │ │ │ +00023480: 7768 6572 6520 484f 5354 4e41 4d45 2069  where HOSTNAME i
│ │ │ │ +00023490: 7320 7468 6520 6375 7272 656e 7420 7379  s the current sy
│ │ │ │ +000234a0: 7374 656d 2773 2068 6f73 746e 616d 6529  stem's hostname)
│ │ │ │ +000234b0: 2c20 7265 6164 2066 726f 6d20 7468 650a  , read from the.
│ │ │ │ +000234c0: 2020 2020 2064 6566 6175 6c74 2068 6f73       default hos
│ │ │ │ +000234d0: 7420 6b65 7973 2066 696c 6520 2873 6565  t keys file (see
│ │ │ │ +000234e0: 20e2 8098 7368 6973 6869 5f68 6f73 746b   ...shishi_hostk
│ │ │ │ +000234f0: 6579 735f 6465 6661 756c 745f 6669 6c65  eys_default_file
│ │ │ │ +00023500: 2829 e280 9929 2c20 6f72 0a20 2020 2020  ()...), or.     
│ │ │ │ +00023510: 4e55 4c4c 2069 6620 6e6f 206b 6579 2063  NULL if no key c
│ │ │ │ +00023520: 6f75 6c64 2062 6520 666f 756e 6420 6f72  ould be found or
│ │ │ │ +00023530: 2061 6e20 6572 726f 7220 656e 636f 756e   an error encoun
│ │ │ │ +00023540: 7465 7265 642e 0a0a 2020 2041 6674 6572  tered...   After
│ │ │ │ +00023550: 2063 7265 6174 696e 6720 7468 6520 6b65   creating the ke
│ │ │ │ +00023560: 7920 7374 7275 6374 7572 652c 2069 7420  y structure, it 
│ │ │ │ +00023570: 6361 6e20 6265 2075 7365 6420 746f 2065  can be used to e
│ │ │ │ +00023580: 6e63 7279 7074 2061 6e64 0a64 6563 7279  ncrypt and.decry
│ │ │ │ +00023590: 7074 2064 6174 612c 2063 616c 6375 6c61  pt data, calcula
│ │ │ │ +000235a0: 7465 2063 6865 636b 7375 6d20 6f6e 2064  te checksum on d
│ │ │ │ +000235b0: 6174 6120 6574 632e 2020 416c 6c20 6176  ata etc.  All av
│ │ │ │ +000235c0: 6169 6c61 626c 6520 6675 6e63 7469 6f6e  ailable function
│ │ │ │ +000235d0: 730a 6172 6520 6465 7363 7269 6265 6420  s.are described 
│ │ │ │ +000235e0: 6e6f 772e 0a0a 7368 6973 6869 5f63 6970  now...shishi_cip
│ │ │ │ +000235f0: 6865 725f 7375 7070 6f72 7465 645f 700a  her_supported_p.
│ │ │ │  00023600: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00023610: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -00023620: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ -00023630: 6869 5f63 6970 6865 725f 7375 7070 6f72  hi_cipher_suppor
│ │ │ │ -00023640: 7465 645f 7020 2869 6e74 3332 5f74 2054  ted_p (int32_t T
│ │ │ │ -00023650: 5950 4529 0a20 2020 2020 5459 5045 3a20  YPE).     TYPE: 
│ │ │ │ -00023660: 656e 6372 7970 7469 6f6e 2074 7970 652c  encryption type,
│ │ │ │ -00023670: 2073 6565 2053 6869 7368 695f 6574 7970   see Shishi_etyp
│ │ │ │ -00023680: 652e 0a0a 2020 2020 202a 4465 7363 7269  e...     *Descri
│ │ │ │ -00023690: 7074 696f 6e3a 2a20 4669 6e64 206f 7574  ption:* Find out
│ │ │ │ -000236a0: 2069 6620 6369 7068 6572 2069 7320 7375   if cipher is su
│ │ │ │ -000236b0: 7070 6f72 7465 642e 0a0a 2020 2020 202a  pported...     *
│ │ │ │ -000236c0: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ -000236d0: 6574 7572 6e20 3020 6966 6620 6369 7068  eturn 0 iff ciph
│ │ │ │ -000236e0: 6572 2069 7320 756e 7375 7070 6f72 7465  er is unsupporte
│ │ │ │ -000236f0: 642e 0a0a 7368 6973 6869 5f63 6970 6865  d...shishi_ciphe
│ │ │ │ -00023700: 725f 6e61 6d65 0a2d 2d2d 2d2d 2d2d 2d2d  r_name.---------
│ │ │ │ -00023710: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ -00023720: 756e 6374 696f 6e3a 2063 6f6e 7374 2063  unction: const c
│ │ │ │ -00023730: 6861 7220 2a20 7368 6973 6869 5f63 6970  har * shishi_cip
│ │ │ │ -00023740: 6865 725f 6e61 6d65 2028 696e 7433 325f  her_name (int32_
│ │ │ │ -00023750: 7420 5459 5045 290a 2020 2020 2054 5950  t TYPE).     TYP
│ │ │ │ -00023760: 453a 2065 6e63 7279 7074 696f 6e20 7479  E: encryption ty
│ │ │ │ -00023770: 7065 2c20 7365 6520 5368 6973 6869 5f65  pe, see Shishi_e
│ │ │ │ -00023780: 7479 7065 2e0a 0a20 2020 2020 2a44 6573  type...     *Des
│ │ │ │ -00023790: 6372 6970 7469 6f6e 3a2a 2052 6561 6420  cription:* Read 
│ │ │ │ -000237a0: 6875 6d61 6e6c 7920 7265 6164 6162 6c65  humanly readable
│ │ │ │ -000237b0: 2073 7472 696e 6720 666f 7220 6369 7068   string for ciph
│ │ │ │ -000237c0: 6572 2e0a 0a20 2020 2020 2a52 6574 7572  er...     *Retur
│ │ │ │ -000237d0: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ -000237e0: 206e 616d 6520 6f66 2065 6e63 7279 7074   name of encrypt
│ │ │ │ -000237f0: 696f 6e20 7479 7065 2c20 652e 672e 0a20  ion type, e.g.. 
│ │ │ │ -00023800: 2020 2020 2264 6573 332d 6362 632d 7368      "des3-cbc-sh
│ │ │ │ -00023810: 6131 2d6b 6422 2c20 6173 2064 6566 696e  a1-kd", as defin
│ │ │ │ -00023820: 6564 2069 6e20 7468 6520 7374 616e 6461  ed in the standa
│ │ │ │ -00023830: 7264 732e 0a0a 7368 6973 6869 5f63 6970  rds...shishi_cip
│ │ │ │ -00023840: 6865 725f 626c 6f63 6b73 697a 650a 2d2d  her_blocksize.--
│ │ │ │ +00023610: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +00023620: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ +00023630: 7368 695f 6369 7068 6572 5f73 7570 706f  shi_cipher_suppo
│ │ │ │ +00023640: 7274 6564 5f70 2028 696e 7433 325f 7420  rted_p (int32_t 
│ │ │ │ +00023650: 5459 5045 290a 2020 2020 2054 5950 453a  TYPE).     TYPE:
│ │ │ │ +00023660: 2065 6e63 7279 7074 696f 6e20 7479 7065   encryption type
│ │ │ │ +00023670: 2c20 7365 6520 5368 6973 6869 5f65 7479  , see Shishi_ety
│ │ │ │ +00023680: 7065 2e0a 0a20 2020 2020 2a44 6573 6372  pe...     *Descr
│ │ │ │ +00023690: 6970 7469 6f6e 3a2a 2046 696e 6420 6f75  iption:* Find ou
│ │ │ │ +000236a0: 7420 6966 2063 6970 6865 7220 6973 2073  t if cipher is s
│ │ │ │ +000236b0: 7570 706f 7274 6564 2e0a 0a20 2020 2020  upported...     
│ │ │ │ +000236c0: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ +000236d0: 5265 7475 726e 2030 2069 6666 2063 6970  Return 0 iff cip
│ │ │ │ +000236e0: 6865 7220 6973 2075 6e73 7570 706f 7274  her is unsupport
│ │ │ │ +000236f0: 6564 2e0a 0a73 6869 7368 695f 6369 7068  ed...shishi_ciph
│ │ │ │ +00023700: 6572 5f6e 616d 650a 2d2d 2d2d 2d2d 2d2d  er_name.--------
│ │ │ │ +00023710: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +00023720: 4675 6e63 7469 6f6e 3a20 636f 6e73 7420  Function: const 
│ │ │ │ +00023730: 6368 6172 202a 2073 6869 7368 695f 6369  char * shishi_ci
│ │ │ │ +00023740: 7068 6572 5f6e 616d 6520 2869 6e74 3332  pher_name (int32
│ │ │ │ +00023750: 5f74 2054 5950 4529 0a20 2020 2020 5459  _t TYPE).     TY
│ │ │ │ +00023760: 5045 3a20 656e 6372 7970 7469 6f6e 2074  PE: encryption t
│ │ │ │ +00023770: 7970 652c 2073 6565 2053 6869 7368 695f  ype, see Shishi_
│ │ │ │ +00023780: 6574 7970 652e 0a0a 2020 2020 202a 4465  etype...     *De
│ │ │ │ +00023790: 7363 7269 7074 696f 6e3a 2a20 5265 6164  scription:* Read
│ │ │ │ +000237a0: 2068 756d 616e 6c79 2072 6561 6461 626c   humanly readabl
│ │ │ │ +000237b0: 6520 7374 7269 6e67 2066 6f72 2063 6970  e string for cip
│ │ │ │ +000237c0: 6865 722e 0a0a 2020 2020 202a 5265 7475  her...     *Retu
│ │ │ │ +000237d0: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ +000237e0: 6e20 6e61 6d65 206f 6620 656e 6372 7970  n name of encryp
│ │ │ │ +000237f0: 7469 6f6e 2074 7970 652c 2065 2e67 2e0a  tion type, e.g..
│ │ │ │ +00023800: 2020 2020 2022 6465 7333 2d63 6263 2d73       "des3-cbc-s
│ │ │ │ +00023810: 6861 312d 6b64 222c 2061 7320 6465 6669  ha1-kd", as defi
│ │ │ │ +00023820: 6e65 6420 696e 2074 6865 2073 7461 6e64  ned in the stand
│ │ │ │ +00023830: 6172 6473 2e0a 0a73 6869 7368 695f 6369  ards...shishi_ci
│ │ │ │ +00023840: 7068 6572 5f62 6c6f 636b 7369 7a65 0a2d  pher_blocksize.-
│ │ │ │  00023850: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00023860: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ -00023870: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ -00023880: 6369 7068 6572 5f62 6c6f 636b 7369 7a65  cipher_blocksize
│ │ │ │ -00023890: 2028 696e 7433 325f 7420 5459 5045 290a   (int32_t TYPE).
│ │ │ │ -000238a0: 2020 2020 2054 5950 453a 2065 6e63 7279       TYPE: encry
│ │ │ │ -000238b0: 7074 696f 6e20 7479 7065 2c20 7365 6520  ption type, see 
│ │ │ │ -000238c0: 5368 6973 6869 5f65 7479 7065 2e0a 0a20  Shishi_etype... 
│ │ │ │ -000238d0: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -000238e0: 3a2a 2047 6574 2062 6c6f 636b 2073 697a  :* Get block siz
│ │ │ │ -000238f0: 6520 666f 7220 6369 7068 6572 2e0a 0a20  e for cipher... 
│ │ │ │ -00023900: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ -00023910: 653a 2a20 5265 7475 726e 2062 6c6f 636b  e:* Return block
│ │ │ │ -00023920: 2073 697a 6520 666f 7220 656e 6372 7970   size for encryp
│ │ │ │ -00023930: 7469 6f6e 2074 7970 652c 2061 7320 6465  tion type, as de
│ │ │ │ -00023940: 6669 6e65 640a 2020 2020 2069 6e20 7468  fined.     in th
│ │ │ │ -00023950: 6520 7374 616e 6461 7264 732e 0a0a 7368  e standards...sh
│ │ │ │ -00023960: 6973 6869 5f63 6970 6865 725f 636f 6e66  ishi_cipher_conf
│ │ │ │ -00023970: 6f75 6e64 6572 7369 7a65 0a2d 2d2d 2d2d  oundersize.-----
│ │ │ │ +00023860: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ +00023870: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ +00023880: 5f63 6970 6865 725f 626c 6f63 6b73 697a  _cipher_blocksiz
│ │ │ │ +00023890: 6520 2869 6e74 3332 5f74 2054 5950 4529  e (int32_t TYPE)
│ │ │ │ +000238a0: 0a20 2020 2020 5459 5045 3a20 656e 6372  .     TYPE: encr
│ │ │ │ +000238b0: 7970 7469 6f6e 2074 7970 652c 2073 6565  yption type, see
│ │ │ │ +000238c0: 2053 6869 7368 695f 6574 7970 652e 0a0a   Shishi_etype...
│ │ │ │ +000238d0: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ +000238e0: 6e3a 2a20 4765 7420 626c 6f63 6b20 7369  n:* Get block si
│ │ │ │ +000238f0: 7a65 2066 6f72 2063 6970 6865 722e 0a0a  ze for cipher...
│ │ │ │ +00023900: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ +00023910: 7565 3a2a 2052 6574 7572 6e20 626c 6f63  ue:* Return bloc
│ │ │ │ +00023920: 6b20 7369 7a65 2066 6f72 2065 6e63 7279  k size for encry
│ │ │ │ +00023930: 7074 696f 6e20 7479 7065 2c20 6173 2064  ption type, as d
│ │ │ │ +00023940: 6566 696e 6564 0a20 2020 2020 696e 2074  efined.     in t
│ │ │ │ +00023950: 6865 2073 7461 6e64 6172 6473 2e0a 0a73  he standards...s
│ │ │ │ +00023960: 6869 7368 695f 6369 7068 6572 5f63 6f6e  hishi_cipher_con
│ │ │ │ +00023970: 666f 756e 6465 7273 697a 650a 2d2d 2d2d  foundersize.----
│ │ │ │  00023980: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00023990: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ -000239a0: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ -000239b0: 695f 6369 7068 6572 5f63 6f6e 666f 756e  i_cipher_confoun
│ │ │ │ -000239c0: 6465 7273 697a 6520 2869 6e74 3332 5f74  dersize (int32_t
│ │ │ │ -000239d0: 2054 5950 4529 0a20 2020 2020 5459 5045   TYPE).     TYPE
│ │ │ │ -000239e0: 3a20 656e 6372 7970 7469 6f6e 2074 7970  : encryption typ
│ │ │ │ -000239f0: 652c 2073 6565 2053 6869 7368 695f 6574  e, see Shishi_et
│ │ │ │ -00023a00: 7970 652e 0a0a 2020 2020 202a 4465 7363  ype...     *Desc
│ │ │ │ -00023a10: 7269 7074 696f 6e3a 2a20 4765 7420 6c65  ription:* Get le
│ │ │ │ -00023a20: 6e67 7468 206f 6620 636f 6e66 6f75 6e64  ngth of confound
│ │ │ │ -00023a30: 6572 2066 6f72 2063 6970 6865 722e 0a0a  er for cipher...
│ │ │ │ -00023a40: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ -00023a50: 7565 3a2a 2052 6574 7572 6e73 2074 6865  ue:* Returns the
│ │ │ │ -00023a60: 2073 697a 6520 6f66 2074 6865 2063 6f6e   size of the con
│ │ │ │ -00023a70: 666f 756e 6465 7220 2872 616e 646f 6d20  founder (random 
│ │ │ │ -00023a80: 6461 7461 290a 2020 2020 2066 6f72 2065  data).     for e
│ │ │ │ -00023a90: 6e63 7279 7074 696f 6e20 7479 7065 2c20  ncryption type, 
│ │ │ │ -00023aa0: 6173 2064 6566 696e 6564 2069 6e20 7468  as defined in th
│ │ │ │ -00023ab0: 6520 7374 616e 6461 7264 732c 206f 7220  e standards, or 
│ │ │ │ -00023ac0: 2873 697a 655f 7429 2d31 206f 6e0a 2020  (size_t)-1 on.  
│ │ │ │ -00023ad0: 2020 2065 7272 6f72 2028 652e 672e 2c20     error (e.g., 
│ │ │ │ -00023ae0: 756e 7375 7070 6f72 7465 6420 656e 6372  unsupported encr
│ │ │ │ -00023af0: 7970 7469 6f6e 2074 7970 6529 2e0a 0a73  yption type)...s
│ │ │ │ -00023b00: 6869 7368 695f 6369 7068 6572 5f6b 6579  hishi_cipher_key
│ │ │ │ -00023b10: 6c65 6e0a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  len.------------
│ │ │ │ -00023b20: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -00023b30: 6e63 7469 6f6e 3a20 7369 7a65 5f74 2073  nction: size_t s
│ │ │ │ -00023b40: 6869 7368 695f 6369 7068 6572 5f6b 6579  hishi_cipher_key
│ │ │ │ -00023b50: 6c65 6e20 2869 6e74 3332 5f74 2054 5950  len (int32_t TYP
│ │ │ │ -00023b60: 4529 0a20 2020 2020 5459 5045 3a20 656e  E).     TYPE: en
│ │ │ │ -00023b70: 6372 7970 7469 6f6e 2074 7970 652c 2073  cryption type, s
│ │ │ │ -00023b80: 6565 2053 6869 7368 695f 6574 7970 652e  ee Shishi_etype.
│ │ │ │ -00023b90: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ -00023ba0: 696f 6e3a 2a20 4765 7420 6b65 7920 6c65  ion:* Get key le
│ │ │ │ -00023bb0: 6e67 7468 2066 6f72 2063 6970 6865 722e  ngth for cipher.
│ │ │ │ -00023bc0: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ -00023bd0: 616c 7565 3a2a 2052 6574 7572 6e20 6c65  alue:* Return le
│ │ │ │ -00023be0: 6e67 7468 206f 6620 6b65 7920 7573 6564  ngth of key used
│ │ │ │ -00023bf0: 2066 6f72 2074 6865 2065 6e63 7279 7074   for the encrypt
│ │ │ │ -00023c00: 696f 6e20 7479 7065 2c0a 2020 2020 2061  ion type,.     a
│ │ │ │ -00023c10: 7320 6465 6669 6e65 6420 696e 2074 6865  s defined in the
│ │ │ │ -00023c20: 2073 7461 6e64 6172 6473 2e0a 0a73 6869   standards...shi
│ │ │ │ -00023c30: 7368 695f 6369 7068 6572 5f72 616e 646f  shi_cipher_rando
│ │ │ │ -00023c40: 6d6c 656e 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  mlen.-----------
│ │ │ │ -00023c50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ -00023c60: 2d20 4675 6e63 7469 6f6e 3a20 7369 7a65  - Function: size
│ │ │ │ -00023c70: 5f74 2073 6869 7368 695f 6369 7068 6572  _t shishi_cipher
│ │ │ │ -00023c80: 5f72 616e 646f 6d6c 656e 2028 696e 7433  _randomlen (int3
│ │ │ │ -00023c90: 325f 7420 5459 5045 290a 2020 2020 2054  2_t TYPE).     T
│ │ │ │ -00023ca0: 5950 453a 2065 6e63 7279 7074 696f 6e20  YPE: encryption 
│ │ │ │ -00023cb0: 7479 7065 2c20 7365 6520 5368 6973 6869  type, see Shishi
│ │ │ │ -00023cc0: 5f65 7479 7065 2e0a 0a20 2020 2020 2a44  _etype...     *D
│ │ │ │ -00023cd0: 6573 6372 6970 7469 6f6e 3a2a 2047 6574  escription:* Get
│ │ │ │ -00023ce0: 206c 656e 6774 6820 6f66 2072 616e 646f   length of rando
│ │ │ │ -00023cf0: 6d20 6461 7461 2066 6f72 2063 6970 6865  m data for ciphe
│ │ │ │ -00023d00: 722e 0a0a 2020 2020 202a 5265 7475 726e  r...     *Return
│ │ │ │ -00023d10: 2076 616c 7565 3a2a 2052 6574 7572 6e20   value:* Return 
│ │ │ │ -00023d20: 6c65 6e67 7468 206f 6620 7261 6e64 6f6d  length of random
│ │ │ │ -00023d30: 2075 7365 6420 666f 7220 7468 6520 656e   used for the en
│ │ │ │ -00023d40: 6372 7970 7469 6f6e 0a20 2020 2020 7479  cryption.     ty
│ │ │ │ -00023d50: 7065 2c20 6173 2064 6566 696e 6564 2069  pe, as defined i
│ │ │ │ -00023d60: 6e20 7468 6520 7374 616e 6461 7264 732c  n the standards,
│ │ │ │ -00023d70: 206f 7220 2873 697a 655f 7429 2d31 206f   or (size_t)-1 o
│ │ │ │ -00023d80: 6e20 6572 726f 7220 2865 2e67 2e2c 0a20  n error (e.g.,. 
│ │ │ │ -00023d90: 2020 2020 756e 7375 7070 6f72 7465 6420      unsupported 
│ │ │ │ -00023da0: 656e 6372 7970 7469 6f6e 2074 7970 6529  encryption type)
│ │ │ │ -00023db0: 2e0a 0a73 6869 7368 695f 6369 7068 6572  ...shishi_cipher
│ │ │ │ -00023dc0: 5f64 6566 6175 6c74 636b 7375 6d74 7970  _defaultcksumtyp
│ │ │ │ -00023dd0: 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  e.--------------
│ │ │ │ +00023990: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ +000239a0: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ +000239b0: 6869 5f63 6970 6865 725f 636f 6e66 6f75  hi_cipher_confou
│ │ │ │ +000239c0: 6e64 6572 7369 7a65 2028 696e 7433 325f  ndersize (int32_
│ │ │ │ +000239d0: 7420 5459 5045 290a 2020 2020 2054 5950  t TYPE).     TYP
│ │ │ │ +000239e0: 453a 2065 6e63 7279 7074 696f 6e20 7479  E: encryption ty
│ │ │ │ +000239f0: 7065 2c20 7365 6520 5368 6973 6869 5f65  pe, see Shishi_e
│ │ │ │ +00023a00: 7479 7065 2e0a 0a20 2020 2020 2a44 6573  type...     *Des
│ │ │ │ +00023a10: 6372 6970 7469 6f6e 3a2a 2047 6574 206c  cription:* Get l
│ │ │ │ +00023a20: 656e 6774 6820 6f66 2063 6f6e 666f 756e  ength of confoun
│ │ │ │ +00023a30: 6465 7220 666f 7220 6369 7068 6572 2e0a  der for cipher..
│ │ │ │ +00023a40: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ +00023a50: 6c75 653a 2a20 5265 7475 726e 7320 7468  lue:* Returns th
│ │ │ │ +00023a60: 6520 7369 7a65 206f 6620 7468 6520 636f  e size of the co
│ │ │ │ +00023a70: 6e66 6f75 6e64 6572 2028 7261 6e64 6f6d  nfounder (random
│ │ │ │ +00023a80: 2064 6174 6129 0a20 2020 2020 666f 7220   data).     for 
│ │ │ │ +00023a90: 656e 6372 7970 7469 6f6e 2074 7970 652c  encryption type,
│ │ │ │ +00023aa0: 2061 7320 6465 6669 6e65 6420 696e 2074   as defined in t
│ │ │ │ +00023ab0: 6865 2073 7461 6e64 6172 6473 2c20 6f72  he standards, or
│ │ │ │ +00023ac0: 2028 7369 7a65 5f74 292d 3120 6f6e 0a20   (size_t)-1 on. 
│ │ │ │ +00023ad0: 2020 2020 6572 726f 7220 2865 2e67 2e2c      error (e.g.,
│ │ │ │ +00023ae0: 2075 6e73 7570 706f 7274 6564 2065 6e63   unsupported enc
│ │ │ │ +00023af0: 7279 7074 696f 6e20 7479 7065 292e 0a0a  ryption type)...
│ │ │ │ +00023b00: 7368 6973 6869 5f63 6970 6865 725f 6b65  shishi_cipher_ke
│ │ │ │ +00023b10: 796c 656e 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  ylen.-----------
│ │ │ │ +00023b20: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +00023b30: 756e 6374 696f 6e3a 2073 697a 655f 7420  unction: size_t 
│ │ │ │ +00023b40: 7368 6973 6869 5f63 6970 6865 725f 6b65  shishi_cipher_ke
│ │ │ │ +00023b50: 796c 656e 2028 696e 7433 325f 7420 5459  ylen (int32_t TY
│ │ │ │ +00023b60: 5045 290a 2020 2020 2054 5950 453a 2065  PE).     TYPE: e
│ │ │ │ +00023b70: 6e63 7279 7074 696f 6e20 7479 7065 2c20  ncryption type, 
│ │ │ │ +00023b80: 7365 6520 5368 6973 6869 5f65 7479 7065  see Shishi_etype
│ │ │ │ +00023b90: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ +00023ba0: 7469 6f6e 3a2a 2047 6574 206b 6579 206c  tion:* Get key l
│ │ │ │ +00023bb0: 656e 6774 6820 666f 7220 6369 7068 6572  ength for cipher
│ │ │ │ +00023bc0: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ +00023bd0: 7661 6c75 653a 2a20 5265 7475 726e 206c  value:* Return l
│ │ │ │ +00023be0: 656e 6774 6820 6f66 206b 6579 2075 7365  ength of key use
│ │ │ │ +00023bf0: 6420 666f 7220 7468 6520 656e 6372 7970  d for the encryp
│ │ │ │ +00023c00: 7469 6f6e 2074 7970 652c 0a20 2020 2020  tion type,.     
│ │ │ │ +00023c10: 6173 2064 6566 696e 6564 2069 6e20 7468  as defined in th
│ │ │ │ +00023c20: 6520 7374 616e 6461 7264 732e 0a0a 7368  e standards...sh
│ │ │ │ +00023c30: 6973 6869 5f63 6970 6865 725f 7261 6e64  ishi_cipher_rand
│ │ │ │ +00023c40: 6f6d 6c65 6e0a 2d2d 2d2d 2d2d 2d2d 2d2d  omlen.----------
│ │ │ │ +00023c50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ +00023c60: 2d2d 2046 756e 6374 696f 6e3a 2073 697a  -- Function: siz
│ │ │ │ +00023c70: 655f 7420 7368 6973 6869 5f63 6970 6865  e_t shishi_ciphe
│ │ │ │ +00023c80: 725f 7261 6e64 6f6d 6c65 6e20 2869 6e74  r_randomlen (int
│ │ │ │ +00023c90: 3332 5f74 2054 5950 4529 0a20 2020 2020  32_t TYPE).     
│ │ │ │ +00023ca0: 5459 5045 3a20 656e 6372 7970 7469 6f6e  TYPE: encryption
│ │ │ │ +00023cb0: 2074 7970 652c 2073 6565 2053 6869 7368   type, see Shish
│ │ │ │ +00023cc0: 695f 6574 7970 652e 0a0a 2020 2020 202a  i_etype...     *
│ │ │ │ +00023cd0: 4465 7363 7269 7074 696f 6e3a 2a20 4765  Description:* Ge
│ │ │ │ +00023ce0: 7420 6c65 6e67 7468 206f 6620 7261 6e64  t length of rand
│ │ │ │ +00023cf0: 6f6d 2064 6174 6120 666f 7220 6369 7068  om data for ciph
│ │ │ │ +00023d00: 6572 2e0a 0a20 2020 2020 2a52 6574 7572  er...     *Retur
│ │ │ │ +00023d10: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ +00023d20: 206c 656e 6774 6820 6f66 2072 616e 646f   length of rando
│ │ │ │ +00023d30: 6d20 7573 6564 2066 6f72 2074 6865 2065  m used for the e
│ │ │ │ +00023d40: 6e63 7279 7074 696f 6e0a 2020 2020 2074  ncryption.     t
│ │ │ │ +00023d50: 7970 652c 2061 7320 6465 6669 6e65 6420  ype, as defined 
│ │ │ │ +00023d60: 696e 2074 6865 2073 7461 6e64 6172 6473  in the standards
│ │ │ │ +00023d70: 2c20 6f72 2028 7369 7a65 5f74 292d 3120  , or (size_t)-1 
│ │ │ │ +00023d80: 6f6e 2065 7272 6f72 2028 652e 672e 2c0a  on error (e.g.,.
│ │ │ │ +00023d90: 2020 2020 2075 6e73 7570 706f 7274 6564       unsupported
│ │ │ │ +00023da0: 2065 6e63 7279 7074 696f 6e20 7479 7065   encryption type
│ │ │ │ +00023db0: 292e 0a0a 7368 6973 6869 5f63 6970 6865  )...shishi_ciphe
│ │ │ │ +00023dc0: 725f 6465 6661 756c 7463 6b73 756d 7479  r_defaultcksumty
│ │ │ │ +00023dd0: 7065 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  pe.-------------
│ │ │ │  00023de0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00023df0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ -00023e00: 696e 7420 7368 6973 6869 5f63 6970 6865  int shishi_ciphe
│ │ │ │ -00023e10: 725f 6465 6661 756c 7463 6b73 756d 7479  r_defaultcksumty
│ │ │ │ -00023e20: 7065 2028 696e 7433 325f 7420 5459 5045  pe (int32_t TYPE
│ │ │ │ -00023e30: 290a 2020 2020 2054 5950 453a 2065 6e63  ).     TYPE: enc
│ │ │ │ -00023e40: 7279 7074 696f 6e20 7479 7065 2c20 7365  ryption type, se
│ │ │ │ -00023e50: 6520 5368 6973 6869 5f65 7479 7065 2e0a  e Shishi_etype..
│ │ │ │ -00023e60: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -00023e70: 6f6e 3a2a 2047 6574 2074 6865 2064 6566  on:* Get the def
│ │ │ │ -00023e80: 6175 6c74 2063 6865 636b 7375 6d20 6173  ault checksum as
│ │ │ │ -00023e90: 736f 6369 6174 6564 2077 6974 6820 6369  sociated with ci
│ │ │ │ -00023ea0: 7068 6572 2e0a 0a20 2020 2020 2a52 6574  pher...     *Ret
│ │ │ │ -00023eb0: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ -00023ec0: 726e 2061 7373 6f63 6961 7465 6420 6368  rn associated ch
│ │ │ │ -00023ed0: 6563 6b73 756d 206d 6563 6861 6e69 736d  ecksum mechanism
│ │ │ │ -00023ee0: 2066 6f72 2074 6865 0a20 2020 2020 656e   for the.     en
│ │ │ │ -00023ef0: 6372 7970 7469 6f6e 2074 7970 652c 2061  cryption type, a
│ │ │ │ -00023f00: 7320 6465 6669 6e65 6420 696e 2074 6865  s defined in the
│ │ │ │ -00023f10: 2073 7461 6e64 6172 6473 2e0a 0a73 6869   standards...shi
│ │ │ │ -00023f20: 7368 695f 6369 7068 6572 5f70 6172 7365  shi_cipher_parse
│ │ │ │ -00023f30: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ -00023f40: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -00023f50: 6f6e 3a20 696e 7420 7368 6973 6869 5f63  on: int shishi_c
│ │ │ │ -00023f60: 6970 6865 725f 7061 7273 6520 2863 6f6e  ipher_parse (con
│ │ │ │ -00023f70: 7374 2063 6861 7220 2a20 4349 5048 4552  st char * CIPHER
│ │ │ │ -00023f80: 290a 2020 2020 2043 4950 4845 523a 206e  ).     CIPHER: n
│ │ │ │ -00023f90: 616d 6520 6f66 2065 6e63 7279 7074 696f  ame of encryptio
│ │ │ │ -00023fa0: 6e20 7479 7065 2c20 652e 672e 2020 2264  n type, e.g.  "d
│ │ │ │ -00023fb0: 6573 332d 6362 632d 7368 6131 2d6b 6422  es3-cbc-sha1-kd"
│ │ │ │ -00023fc0: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ -00023fd0: 7469 6f6e 3a2a 2047 6574 2063 6970 6865  tion:* Get ciphe
│ │ │ │ -00023fe0: 7220 6e75 6d62 6572 2062 7920 7061 7273  r number by pars
│ │ │ │ -00023ff0: 696e 6720 7374 7269 6e67 2e0a 0a20 2020  ing string...   
│ │ │ │ -00024000: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ -00024010: 2a20 5265 7475 726e 2065 6e63 7279 7074  * Return encrypt
│ │ │ │ -00024020: 696f 6e20 7479 7065 2063 6f72 7265 7370  ion type corresp
│ │ │ │ -00024030: 6f6e 6469 6e67 2074 6f20 6120 7374 7269  onding to a stri
│ │ │ │ -00024040: 6e67 2e0a 0a73 6869 7368 695f 6368 6563  ng...shishi_chec
│ │ │ │ -00024050: 6b73 756d 5f73 7570 706f 7274 6564 5f70  ksum_supported_p
│ │ │ │ -00024060: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ -00024070: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ -00024080: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ -00024090: 7368 6973 6869 5f63 6865 636b 7375 6d5f  shishi_checksum_
│ │ │ │ -000240a0: 7375 7070 6f72 7465 645f 7020 2869 6e74  supported_p (int
│ │ │ │ -000240b0: 3332 5f74 2054 5950 4529 0a20 2020 2020  32_t TYPE).     
│ │ │ │ -000240c0: 5459 5045 3a20 6368 6563 6b73 756d 2074  TYPE: checksum t
│ │ │ │ -000240d0: 7970 652c 2073 6565 2053 6869 7368 695f  ype, see Shishi_
│ │ │ │ -000240e0: 636b 7375 6d74 7970 652e 0a0a 2020 2020  cksumtype...    
│ │ │ │ -000240f0: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ -00024100: 4669 6e64 206f 7574 2077 6865 7468 6572  Find out whether
│ │ │ │ -00024110: 2063 6865 636b 7375 6d20 6973 2073 7570   checksum is sup
│ │ │ │ -00024120: 706f 7274 6564 2e0a 0a20 2020 2020 2a52  ported...     *R
│ │ │ │ -00024130: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ -00024140: 7475 726e 2030 2069 6666 2063 6865 636b  turn 0 iff check
│ │ │ │ -00024150: 7375 6d20 6973 2075 6e73 7570 706f 7274  sum is unsupport
│ │ │ │ -00024160: 6564 2e0a 0a73 6869 7368 695f 6368 6563  ed...shishi_chec
│ │ │ │ -00024170: 6b73 756d 5f6e 616d 650a 2d2d 2d2d 2d2d  ksum_name.------
│ │ │ │ -00024180: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -00024190: 202d 2d20 4675 6e63 7469 6f6e 3a20 636f   -- Function: co
│ │ │ │ -000241a0: 6e73 7420 6368 6172 202a 2073 6869 7368  nst char * shish
│ │ │ │ -000241b0: 695f 6368 6563 6b73 756d 5f6e 616d 6520  i_checksum_name 
│ │ │ │ -000241c0: 2869 6e74 3332 5f74 2054 5950 4529 0a20  (int32_t TYPE). 
│ │ │ │ -000241d0: 2020 2020 5459 5045 3a20 6368 6563 6b73      TYPE: checks
│ │ │ │ -000241e0: 756d 2074 7970 652c 2073 6565 2053 6869  um type, see Shi
│ │ │ │ -000241f0: 7368 695f 636b 7375 6d74 7970 652e 0a0a  shi_cksumtype...
│ │ │ │ -00024200: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ -00024210: 6e3a 2a20 4765 7420 6e61 6d65 206f 6620  n:* Get name of 
│ │ │ │ -00024220: 6368 6563 6b73 756d 2e0a 0a20 2020 2020  checksum...     
│ │ │ │ -00024230: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ -00024240: 5265 7475 726e 206e 616d 6520 6f66 2063  Return name of c
│ │ │ │ -00024250: 6865 636b 7375 6d20 7479 7065 2c20 652e  hecksum type, e.
│ │ │ │ -00024260: 672e 0a20 2020 2020 2268 6d61 632d 7368  g..     "hmac-sh
│ │ │ │ -00024270: 6131 2d39 362d 6165 7332 3536 222c 2061  a1-96-aes256", a
│ │ │ │ -00024280: 7320 6465 6669 6e65 6420 696e 2074 6865  s defined in the
│ │ │ │ -00024290: 2073 7461 6e64 6172 6473 2e0a 0a73 6869   standards...shi
│ │ │ │ -000242a0: 7368 695f 6368 6563 6b73 756d 5f63 6b73  shi_checksum_cks
│ │ │ │ -000242b0: 756d 6c65 6e0a 2d2d 2d2d 2d2d 2d2d 2d2d  umlen.----------
│ │ │ │ -000242c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -000242d0: 202d 2d20 4675 6e63 7469 6f6e 3a20 7369   -- Function: si
│ │ │ │ -000242e0: 7a65 5f74 2073 6869 7368 695f 6368 6563  ze_t shishi_chec
│ │ │ │ -000242f0: 6b73 756d 5f63 6b73 756d 6c65 6e20 2869  ksum_cksumlen (i
│ │ │ │ -00024300: 6e74 3332 5f74 2054 5950 4529 0a20 2020  nt32_t TYPE).   
│ │ │ │ -00024310: 2020 5459 5045 3a20 6368 6563 6b73 756d    TYPE: checksum
│ │ │ │ -00024320: 2074 7970 652c 2073 6565 2053 6869 7368   type, see Shish
│ │ │ │ -00024330: 695f 636b 7375 6d74 7970 652e 0a0a 2020  i_cksumtype...  
│ │ │ │ -00024340: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ -00024350: 2a20 4765 7420 6c65 6e67 7468 206f 6620  * Get length of 
│ │ │ │ -00024360: 6368 6563 6b73 756d 206f 7574 7075 742e  checksum output.
│ │ │ │ -00024370: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ -00024380: 616c 7565 3a2a 2052 6574 7572 6e20 6c65  alue:* Return le
│ │ │ │ -00024390: 6e67 7468 206f 6620 6368 6563 6b73 756d  ngth of checksum
│ │ │ │ -000243a0: 2075 7365 6420 666f 7220 7468 6520 6368   used for the ch
│ │ │ │ -000243b0: 6563 6b73 756d 0a20 2020 2020 7479 7065  ecksum.     type
│ │ │ │ -000243c0: 2c20 6173 2064 6566 696e 6564 2069 6e20  , as defined in 
│ │ │ │ -000243d0: 7468 6520 7374 616e 6461 7264 732e 0a0a  the standards...
│ │ │ │ -000243e0: 7368 6973 6869 5f63 6865 636b 7375 6d5f  shishi_checksum_
│ │ │ │ -000243f0: 7061 7273 650a 2d2d 2d2d 2d2d 2d2d 2d2d  parse.----------
│ │ │ │ -00024400: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ -00024410: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ -00024420: 6869 7368 695f 6368 6563 6b73 756d 5f70  hishi_checksum_p
│ │ │ │ -00024430: 6172 7365 2028 636f 6e73 7420 6368 6172  arse (const char
│ │ │ │ -00024440: 202a 2043 4845 434b 5355 4d29 0a20 2020   * CHECKSUM).   
│ │ │ │ -00024450: 2020 4348 4543 4b53 554d 3a20 6e61 6d65    CHECKSUM: name
│ │ │ │ -00024460: 206f 6620 6368 6563 6b73 756d 2074 7970   of checksum typ
│ │ │ │ -00024470: 652c 2065 2e67 2e20 2022 686d 6163 2d73  e, e.g.  "hmac-s
│ │ │ │ -00024480: 6861 312d 3936 2d61 6573 3235 3622 2e0a  ha1-96-aes256"..
│ │ │ │ -00024490: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -000244a0: 6f6e 3a2a 2047 6574 2063 6865 636b 7375  on:* Get checksu
│ │ │ │ -000244b0: 6d20 6e75 6d62 6572 2062 7920 7061 7273  m number by pars
│ │ │ │ -000244c0: 696e 6720 6120 7374 7269 6e67 2e0a 0a20  ing a string... 
│ │ │ │ -000244d0: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ -000244e0: 653a 2a20 5265 7475 726e 2063 6865 636b  e:* Return check
│ │ │ │ -000244f0: 7375 6d20 7479 7065 2c20 7365 6520 5368  sum type, see Sh
│ │ │ │ -00024500: 6973 6869 5f63 6b73 756d 7479 7065 2c0a  ishi_cksumtype,.
│ │ │ │ -00024510: 2020 2020 2063 6f72 7265 7370 6f6e 6469       correspondi
│ │ │ │ -00024520: 6e67 2074 6f20 6120 7374 7269 6e67 2e0a  ng to a string..
│ │ │ │ -00024530: 0a73 6869 7368 695f 7374 7269 6e67 5f74  .shishi_string_t
│ │ │ │ -00024540: 6f5f 6b65 790a 2d2d 2d2d 2d2d 2d2d 2d2d  o_key.----------
│ │ │ │ -00024550: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ -00024560: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ -00024570: 6973 6869 5f73 7472 696e 675f 746f 5f6b  ishi_string_to_k
│ │ │ │ -00024580: 6579 2028 5368 6973 6869 202a 2048 414e  ey (Shishi * HAN
│ │ │ │ -00024590: 444c 452c 0a20 2020 2020 2020 2020 2069  DLE,.          i
│ │ │ │ -000245a0: 6e74 3332 5f74 204b 4559 5459 5045 2c20  nt32_t KEYTYPE, 
│ │ │ │ -000245b0: 636f 6e73 7420 6368 6172 202a 2050 4153  const char * PAS
│ │ │ │ -000245c0: 5357 4f52 442c 2073 697a 655f 7420 5041  SWORD, size_t PA
│ │ │ │ -000245d0: 5353 574f 5244 4c45 4e2c 0a20 2020 2020  SSWORDLEN,.     
│ │ │ │ -000245e0: 2020 2020 2063 6f6e 7374 2063 6861 7220       const char 
│ │ │ │ -000245f0: 2a20 5341 4c54 2c20 7369 7a65 5f74 2053  * SALT, size_t S
│ │ │ │ -00024600: 414c 544c 454e 2c20 636f 6e73 7420 6368  ALTLEN, const ch
│ │ │ │ -00024610: 6172 202a 2050 4152 414d 4554 4552 2c0a  ar * PARAMETER,.
│ │ │ │ -00024620: 2020 2020 2020 2020 2020 5368 6973 6869            Shishi
│ │ │ │ -00024630: 5f6b 6579 202a 204f 5554 4b45 5929 0a20  _key * OUTKEY). 
│ │ │ │ -00024640: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ -00024650: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ -00024660: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ -00024670: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ -00024680: 2020 2020 4b45 5954 5950 453a 2063 7279      KEYTYPE: cry
│ │ │ │ -00024690: 7074 6f67 7261 7068 6963 2065 6e63 7279  ptographic encry
│ │ │ │ -000246a0: 7074 696f 6e20 7479 7065 2c20 7365 6520  ption type, see 
│ │ │ │ -000246b0: 5368 6973 6869 5f65 7479 7065 2e0a 2020  Shishi_etype..  
│ │ │ │ -000246c0: 2020 2050 4153 5357 4f52 443a 2069 6e70     PASSWORD: inp
│ │ │ │ -000246d0: 7574 2061 7272 6179 2077 6974 6820 7061  ut array with pa
│ │ │ │ -000246e0: 7373 776f 7264 2e0a 2020 2020 2050 4153  ssword..     PAS
│ │ │ │ -000246f0: 5357 4f52 444c 454e 3a20 6c65 6e67 7468  SWORDLEN: length
│ │ │ │ -00024700: 206f 6620 696e 7075 7420 6172 7261 7920   of input array 
│ │ │ │ -00024710: 7769 7468 2070 6173 7377 6f72 642e 0a20  with password.. 
│ │ │ │ -00024720: 2020 2020 5341 4c54 3a20 696e 7075 7420      SALT: input 
│ │ │ │ -00024730: 6172 7261 7920 7769 7468 2073 616c 742e  array with salt.
│ │ │ │ -00024740: 0a20 2020 2020 5341 4c54 4c45 4e3a 206c  .     SALTLEN: l
│ │ │ │ -00024750: 656e 6774 6820 6f66 2069 6e70 7574 2061  ength of input a
│ │ │ │ -00024760: 7272 6179 2077 6974 6820 7361 6c74 2e0a  rray with salt..
│ │ │ │ -00024770: 2020 2020 2050 4152 414d 4554 4552 3a20       PARAMETER: 
│ │ │ │ -00024780: 696e 7075 7420 6172 7261 7920 7769 7468  input array with
│ │ │ │ -00024790: 206f 7061 7175 6520 656e 6372 7970 7469   opaque encrypti
│ │ │ │ -000247a0: 6f6e 2074 7970 6520 7370 6563 6966 6963  on type specific
│ │ │ │ -000247b0: 0a20 2020 2020 696e 666f 726d 6174 696f  .     informatio
│ │ │ │ -000247c0: 6e2e 0a20 2020 2020 4f55 544b 4559 3a20  n..     OUTKEY: 
│ │ │ │ -000247d0: 616c 6c6f 6361 7465 6420 6b65 7920 6861  allocated key ha
│ │ │ │ -000247e0: 6e64 6c65 2074 6861 7420 7769 6c6c 2063  ndle that will c
│ │ │ │ -000247f0: 6f6e 7461 696e 206e 6577 206b 6579 2e0a  ontain new key..
│ │ │ │ -00024800: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -00024810: 6f6e 3a2a 2044 6572 6976 6520 6b65 7920  on:* Derive key 
│ │ │ │ -00024820: 6672 6f6d 2061 2073 7472 696e 6720 2870  from a string (p
│ │ │ │ -00024830: 6173 7377 6f72 6429 2061 6e64 2073 616c  assword) and sal
│ │ │ │ -00024840: 740a 2020 2020 2028 636f 6d6d 6f6e 6c79  t.     (commonly
│ │ │ │ -00024850: 2063 6f6e 6361 7465 6e61 7469 6f6e 206f   concatenation o
│ │ │ │ -00024860: 6620 7265 616c 6d20 616e 6420 7072 696e  f realm and prin
│ │ │ │ -00024870: 6369 7061 6c29 2066 6f72 2073 7065 6369  cipal) for speci
│ │ │ │ -00024880: 6669 6564 206b 6579 0a20 2020 2020 7479  fied key.     ty
│ │ │ │ -00024890: 7065 2c20 616e 6420 7365 7420 7468 6520  pe, and set the 
│ │ │ │ -000248a0: 7479 7065 2061 6e64 2076 616c 7565 2069  type and value i
│ │ │ │ -000248b0: 6e20 7468 6520 6769 7665 6e20 6b65 7920  n the given key 
│ │ │ │ -000248c0: 746f 2074 6865 2063 6f6d 7075 7465 640a  to the computed.
│ │ │ │ -000248d0: 2020 2020 2076 616c 7565 732e 2020 5468       values.  Th
│ │ │ │ -000248e0: 6520 7061 7261 6d65 7465 7220 7661 6c75  e parameter valu
│ │ │ │ -000248f0: 6520 6973 2073 7065 6369 6669 6320 666f  e is specific fo
│ │ │ │ -00024900: 7220 6561 6368 206b 6579 7479 7065 2c20  r each keytype, 
│ │ │ │ -00024910: 616e 6420 6361 6e0a 2020 2020 2062 6520  and can.     be 
│ │ │ │ -00024920: 7365 7420 6966 2074 6865 2070 6172 616d  set if the param
│ │ │ │ -00024930: 6574 6572 2069 6e66 6f72 6d61 7469 6f6e  eter information
│ │ │ │ -00024940: 2069 7320 6e6f 7420 6176 6169 6c61 626c   is not availabl
│ │ │ │ -00024950: 652e 0a0a 2020 2020 202a 5265 7475 726e  e...     *Return
│ │ │ │ -00024960: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ -00024970: 20e2 8098 5348 4953 4849 5f4f 4be2 8099   ...SHISHI_OK...
│ │ │ │ -00024980: 2069 6666 2073 7563 6365 7373 6675 6c2e   iff successful.
│ │ │ │ -00024990: 0a0a 7368 6973 6869 5f72 616e 646f 6d5f  ..shishi_random_
│ │ │ │ -000249a0: 746f 5f6b 6579 0a2d 2d2d 2d2d 2d2d 2d2d  to_key.---------
│ │ │ │ -000249b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ -000249c0: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ -000249d0: 6869 7368 695f 7261 6e64 6f6d 5f74 6f5f  hishi_random_to_
│ │ │ │ -000249e0: 6b65 7920 2853 6869 7368 6920 2a20 4841  key (Shishi * HA
│ │ │ │ -000249f0: 4e44 4c45 2c0a 2020 2020 2020 2020 2020  NDLE,.          
│ │ │ │ -00024a00: 696e 7433 325f 7420 4b45 5954 5950 452c  int32_t KEYTYPE,
│ │ │ │ -00024a10: 2063 6f6e 7374 2063 6861 7220 2a20 524e   const char * RN
│ │ │ │ -00024a20: 442c 2073 697a 655f 7420 524e 444c 454e  D, size_t RNDLEN
│ │ │ │ -00024a30: 2c0a 2020 2020 2020 2020 2020 5368 6973  ,.          Shis
│ │ │ │ -00024a40: 6869 5f6b 6579 202a 204f 5554 4b45 5929  hi_key * OUTKEY)
│ │ │ │ -00024a50: 0a20 2020 2020 4841 4e44 4c45 3a20 7368  .     HANDLE: sh
│ │ │ │ -00024a60: 6973 6869 2068 616e 646c 6520 6173 2061  ishi handle as a
│ │ │ │ -00024a70: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ -00024a80: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ -00024a90: 0a20 2020 2020 4b45 5954 5950 453a 2063  .     KEYTYPE: c
│ │ │ │ -00024aa0: 7279 7074 6f67 7261 7068 6963 2065 6e63  ryptographic enc
│ │ │ │ -00024ab0: 7279 7074 696f 6e20 7479 7065 2c20 7365  ryption type, se
│ │ │ │ -00024ac0: 6520 5368 6973 6869 5f65 7479 7065 2e0a  e Shishi_etype..
│ │ │ │ -00024ad0: 2020 2020 2052 4e44 3a20 696e 7075 7420       RND: input 
│ │ │ │ -00024ae0: 6172 7261 7920 7769 7468 2072 616e 646f  array with rando
│ │ │ │ -00024af0: 6d20 6461 7461 2e0a 2020 2020 2052 4e44  m data..     RND
│ │ │ │ -00024b00: 4c45 4e3a 206c 656e 6774 6820 6f66 2069  LEN: length of i
│ │ │ │ -00024b10: 6e70 7574 2061 7272 6179 2077 6974 6820  nput array with 
│ │ │ │ -00024b20: 7261 6e64 6f6d 2064 6174 612e 0a20 2020  random data..   
│ │ │ │ -00024b30: 2020 4f55 544b 4559 3a20 616c 6c6f 6361    OUTKEY: alloca
│ │ │ │ -00024b40: 7465 6420 6b65 7920 6861 6e64 6c65 2074  ted key handle t
│ │ │ │ -00024b50: 6861 7420 7769 6c6c 2063 6f6e 7461 696e  hat will contain
│ │ │ │ -00024b60: 206e 6577 206b 6579 2e0a 0a20 2020 2020   new key...     
│ │ │ │ -00024b70: 2a44 6573 6372 6970 7469 6f6e 3a2a 2044  *Description:* D
│ │ │ │ -00024b80: 6572 6976 6520 6b65 7920 6672 6f6d 2072  erive key from r
│ │ │ │ -00024b90: 616e 646f 6d20 6461 7461 2066 6f72 2073  andom data for s
│ │ │ │ -00024ba0: 7065 6369 6669 6564 206b 6579 2074 7970  pecified key typ
│ │ │ │ -00024bb0: 652c 0a20 2020 2020 616e 6420 7365 7420  e,.     and set 
│ │ │ │ -00024bc0: 7468 6520 7479 7065 2061 6e64 2076 616c  the type and val
│ │ │ │ -00024bd0: 7565 2069 6e20 7468 6520 6769 7665 6e20  ue in the given 
│ │ │ │ -00024be0: 6b65 7920 746f 2074 6865 2063 6f6d 7075  key to the compu
│ │ │ │ -00024bf0: 7465 6420 7661 6c75 6573 2e0a 0a20 2020  ted values...   
│ │ │ │ -00024c00: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ -00024c10: 2a20 5265 7475 726e 7320 e280 9853 4849  * Returns ...SHI
│ │ │ │ -00024c20: 5348 495f 4f4b e280 9920 6966 6620 7375  SHI_OK... iff su
│ │ │ │ -00024c30: 6363 6573 7366 756c 2e0a 0a73 6869 7368  ccessful...shish
│ │ │ │ -00024c40: 695f 6368 6563 6b73 756d 0a2d 2d2d 2d2d  i_checksum.-----
│ │ │ │ -00024c50: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ -00024c60: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ -00024c70: 6973 6869 5f63 6865 636b 7375 6d20 2853  ishi_checksum (S
│ │ │ │ -00024c80: 6869 7368 6920 2a20 4841 4e44 4c45 2c20  hishi * HANDLE, 
│ │ │ │ -00024c90: 5368 6973 6869 5f6b 6579 202a 204b 4559  Shishi_key * KEY
│ │ │ │ -00024ca0: 2c0a 2020 2020 2020 2020 2020 696e 7420  ,.          int 
│ │ │ │ -00024cb0: 4b45 5955 5341 4745 2c20 696e 7420 434b  KEYUSAGE, int CK
│ │ │ │ -00024cc0: 5355 4d54 5950 452c 2063 6f6e 7374 2063  SUMTYPE, const c
│ │ │ │ -00024cd0: 6861 7220 2a20 494e 2c20 7369 7a65 5f74  har * IN, size_t
│ │ │ │ -00024ce0: 2049 4e4c 454e 2c0a 2020 2020 2020 2020   INLEN,.        
│ │ │ │ -00024cf0: 2020 6368 6172 202a 2a20 4f55 542c 2073    char ** OUT, s
│ │ │ │ -00024d00: 697a 655f 7420 2a20 4f55 544c 454e 290a  ize_t * OUTLEN).
│ │ │ │ -00024d10: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ -00024d20: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ -00024d30: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ -00024d40: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ -00024d50: 2020 2020 204b 4559 3a20 6b65 7920 746f       KEY: key to
│ │ │ │ -00024d60: 2063 6f6d 7075 7465 2063 6865 636b 7375   compute checksu
│ │ │ │ -00024d70: 6d20 7769 7468 2e0a 2020 2020 204b 4559  m with..     KEY
│ │ │ │ -00024d80: 5553 4147 453a 2069 6e74 6567 6572 2073  USAGE: integer s
│ │ │ │ -00024d90: 7065 6369 6679 696e 6720 7768 6174 2074  pecifying what t
│ │ │ │ -00024da0: 6869 7320 6b65 7920 6973 2075 7365 6420  his key is used 
│ │ │ │ -00024db0: 666f 722e 0a20 2020 2020 434b 5355 4d54  for..     CKSUMT
│ │ │ │ -00024dc0: 5950 453a 2074 6865 2063 6865 636b 7375  YPE: the checksu
│ │ │ │ -00024dd0: 6d20 616c 676f 7269 7468 6d20 746f 2075  m algorithm to u
│ │ │ │ -00024de0: 7365 2e0a 2020 2020 2049 4e3a 2069 6e70  se..     IN: inp
│ │ │ │ -00024df0: 7574 2061 7272 6179 2077 6974 6820 6461  ut array with da
│ │ │ │ -00024e00: 7461 2074 6f20 696e 7465 6772 6974 7920  ta to integrity 
│ │ │ │ -00024e10: 7072 6f74 6563 742e 0a20 2020 2020 494e  protect..     IN
│ │ │ │ -00024e20: 4c45 4e3a 2073 697a 6520 6f66 2069 6e70  LEN: size of inp
│ │ │ │ -00024e30: 7574 2061 7272 6179 2077 6974 6820 6461  ut array with da
│ │ │ │ -00024e40: 7461 2074 6f20 696e 7465 6772 6974 7920  ta to integrity 
│ │ │ │ -00024e50: 7072 6f74 6563 742e 0a20 2020 2020 4f55  protect..     OU
│ │ │ │ -00024e60: 543a 206f 7574 7075 7420 6172 7261 7920  T: output array 
│ │ │ │ -00024e70: 7769 7468 206e 6577 6c79 2061 6c6c 6f63  with newly alloc
│ │ │ │ -00024e80: 6174 6564 2069 6e74 6567 7269 7479 2070  ated integrity p
│ │ │ │ -00024e90: 726f 7465 6374 6564 2064 6174 612e 0a20  rotected data.. 
│ │ │ │ -00024ea0: 2020 2020 4f55 544c 454e 3a20 6f75 7470      OUTLEN: outp
│ │ │ │ -00024eb0: 7574 2076 6172 6961 626c 6520 7769 7468  ut variable with
│ │ │ │ -00024ec0: 206c 656e 6774 6820 6f66 206f 7574 7075   length of outpu
│ │ │ │ -00024ed0: 7420 6172 7261 7920 7769 7468 2063 6865  t array with che
│ │ │ │ -00024ee0: 636b 7375 6d2e 0a0a 2020 2020 202a 4465  cksum...     *De
│ │ │ │ -00024ef0: 7363 7269 7074 696f 6e3a 2a20 496e 7465  scription:* Inte
│ │ │ │ -00024f00: 6772 6974 7920 7072 6f74 6563 7420 6461  grity protect da
│ │ │ │ -00024f10: 7461 2075 7369 6e67 206b 6579 2c20 706f  ta using key, po
│ │ │ │ -00024f20: 7373 6962 6c79 2061 6c74 6572 6564 0a20  ssibly altered. 
│ │ │ │ -00024f30: 2020 2020 6279 2073 7570 706c 6965 6420      by supplied 
│ │ │ │ -00024f40: 6b65 7920 7573 6167 652e 2020 4966 206b  key usage.  If k
│ │ │ │ -00024f50: 6579 2075 7361 6765 2069 7320 302c 206e  ey usage is 0, n
│ │ │ │ -00024f60: 6f20 6b65 7920 6465 7269 7661 7469 6f6e  o key derivation
│ │ │ │ -00024f70: 2069 730a 2020 2020 2075 7365 642e 2020   is.     used.  
│ │ │ │ -00024f80: 5468 6520 4f55 5420 6275 6666 6572 206d  The OUT buffer m
│ │ │ │ -00024f90: 7573 7420 6265 2064 6561 6c6c 6f63 6174  ust be deallocat
│ │ │ │ -00024fa0: 6564 2062 7920 7468 6520 6361 6c6c 6572  ed by the caller
│ │ │ │ -00024fb0: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ -00024fc0: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ -00024fd0: e280 9853 4849 5348 495f 4f4b e280 9920  ...SHISHI_OK... 
│ │ │ │ -00024fe0: 6966 6620 7375 6363 6573 7366 756c 2e0a  iff successful..
│ │ │ │ -00024ff0: 0a73 6869 7368 695f 7665 7269 6679 0a2d  .shishi_verify.-
│ │ │ │ -00025000: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ -00025010: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ -00025020: 7368 6973 6869 5f76 6572 6966 7920 2853  shishi_verify (S
│ │ │ │ -00025030: 6869 7368 6920 2a20 4841 4e44 4c45 2c20  hishi * HANDLE, 
│ │ │ │ -00025040: 5368 6973 6869 5f6b 6579 202a 204b 4559  Shishi_key * KEY
│ │ │ │ -00025050: 2c0a 2020 2020 2020 2020 2020 696e 7420  ,.          int 
│ │ │ │ -00025060: 4b45 5955 5341 4745 2c20 696e 7420 434b  KEYUSAGE, int CK
│ │ │ │ -00025070: 5355 4d54 5950 452c 2063 6f6e 7374 2063  SUMTYPE, const c
│ │ │ │ -00025080: 6861 7220 2a20 494e 2c20 7369 7a65 5f74  har * IN, size_t
│ │ │ │ -00025090: 2049 4e4c 454e 2c0a 2020 2020 2020 2020   INLEN,.        
│ │ │ │ -000250a0: 2020 636f 6e73 7420 6368 6172 202a 2043    const char * C
│ │ │ │ -000250b0: 4b53 554d 2c20 7369 7a65 5f74 2043 4b53  KSUM, size_t CKS
│ │ │ │ -000250c0: 554d 4c45 4e29 0a20 2020 2020 4841 4e44  UMLEN).     HAND
│ │ │ │ -000250d0: 4c45 3a20 7368 6973 6869 2068 616e 646c  LE: shishi handl
│ │ │ │ -000250e0: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ -000250f0: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ -00025100: 2829 e280 992e 0a20 2020 2020 4b45 593a  ().....     KEY:
│ │ │ │ -00025110: 206b 6579 2074 6f20 7665 7269 6679 2063   key to verify c
│ │ │ │ -00025120: 6865 636b 7375 6d20 7769 7468 2e0a 2020  hecksum with..  
│ │ │ │ -00025130: 2020 204b 4559 5553 4147 453a 2069 6e74     KEYUSAGE: int
│ │ │ │ -00025140: 6567 6572 2073 7065 6369 6679 696e 6720  eger specifying 
│ │ │ │ -00025150: 7768 6174 2074 6869 7320 6b65 7920 6973  what this key is
│ │ │ │ -00025160: 2075 7365 6420 666f 722e 0a20 2020 2020   used for..     
│ │ │ │ -00025170: 434b 5355 4d54 5950 453a 2074 6865 2063  CKSUMTYPE: the c
│ │ │ │ -00025180: 6865 636b 7375 6d20 616c 676f 7269 7468  hecksum algorith
│ │ │ │ -00025190: 6d20 746f 2075 7365 2e0a 2020 2020 2049  m to use..     I
│ │ │ │ -000251a0: 4e3a 2069 6e70 7574 2061 7272 6179 2077  N: input array w
│ │ │ │ -000251b0: 6974 6820 6461 7461 2074 6861 7420 7761  ith data that wa
│ │ │ │ -000251c0: 7320 696e 7465 6772 6974 7920 7072 6f74  s integrity prot
│ │ │ │ -000251d0: 6563 7465 642e 0a20 2020 2020 494e 4c45  ected..     INLE
│ │ │ │ -000251e0: 4e3a 2073 697a 6520 6f66 2069 6e70 7574  N: size of input
│ │ │ │ -000251f0: 2061 7272 6179 2077 6974 6820 6461 7461   array with data
│ │ │ │ -00025200: 2074 6861 7420 7761 7320 696e 7465 6772   that was integr
│ │ │ │ -00025210: 6974 7920 7072 6f74 6563 7465 642e 0a0a  ity protected...
│ │ │ │ -00025220: 2020 2020 2043 4b53 554d 3a20 696e 7075       CKSUM: inpu
│ │ │ │ -00025230: 7420 6172 7261 7920 7769 7468 2061 6c6c  t array with all
│ │ │ │ -00025240: 6567 6564 2063 6865 636b 7375 6d20 6f66  eged checksum of
│ │ │ │ -00025250: 2064 6174 612e 0a20 2020 2020 434b 5355   data..     CKSU
│ │ │ │ -00025260: 4d4c 454e 3a20 7369 7a65 206f 6620 696e  MLEN: size of in
│ │ │ │ -00025270: 7075 7420 6172 7261 7920 7769 7468 2061  put array with a
│ │ │ │ -00025280: 6c6c 6567 6564 2063 6865 636b 7375 6d20  lleged checksum 
│ │ │ │ -00025290: 6f66 2064 6174 612e 0a0a 2020 2020 202a  of data...     *
│ │ │ │ -000252a0: 4465 7363 7269 7074 696f 6e3a 2a20 5665  Description:* Ve
│ │ │ │ -000252b0: 7269 6679 2063 6865 636b 7375 6d20 6f66  rify checksum of
│ │ │ │ -000252c0: 2064 6174 6120 7573 696e 6720 6b65 792c   data using key,
│ │ │ │ -000252d0: 2070 6f73 7369 626c 7920 616c 7465 7265   possibly altere
│ │ │ │ -000252e0: 640a 2020 2020 2062 7920 7375 7070 6c69  d.     by suppli
│ │ │ │ -000252f0: 6564 206b 6579 2075 7361 6765 2e20 2049  ed key usage.  I
│ │ │ │ -00025300: 6620 6b65 7920 7573 6167 6520 6973 2030  f key usage is 0
│ │ │ │ -00025310: 2c20 6e6f 206b 6579 2064 6572 6976 6174  , no key derivat
│ │ │ │ -00025320: 696f 6e20 6973 0a20 2020 2020 7573 6564  ion is.     used
│ │ │ │ -00025330: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ -00025340: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ -00025350: e280 9853 4849 5348 495f 4f4b e280 9920  ...SHISHI_OK... 
│ │ │ │ -00025360: 6966 6620 7375 6363 6573 7366 756c 2e0a  iff successful..
│ │ │ │ -00025370: 0a73 6869 7368 695f 656e 6372 7970 745f  .shishi_encrypt_
│ │ │ │ -00025380: 6976 7570 6461 7465 5f65 7479 7065 0a2d  ivupdate_etype.-
│ │ │ │ +00023df0: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ +00023e00: 2069 6e74 2073 6869 7368 695f 6369 7068   int shishi_ciph
│ │ │ │ +00023e10: 6572 5f64 6566 6175 6c74 636b 7375 6d74  er_defaultcksumt
│ │ │ │ +00023e20: 7970 6520 2869 6e74 3332 5f74 2054 5950  ype (int32_t TYP
│ │ │ │ +00023e30: 4529 0a20 2020 2020 5459 5045 3a20 656e  E).     TYPE: en
│ │ │ │ +00023e40: 6372 7970 7469 6f6e 2074 7970 652c 2073  cryption type, s
│ │ │ │ +00023e50: 6565 2053 6869 7368 695f 6574 7970 652e  ee Shishi_etype.
│ │ │ │ +00023e60: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ +00023e70: 696f 6e3a 2a20 4765 7420 7468 6520 6465  ion:* Get the de
│ │ │ │ +00023e80: 6661 756c 7420 6368 6563 6b73 756d 2061  fault checksum a
│ │ │ │ +00023e90: 7373 6f63 6961 7465 6420 7769 7468 2063  ssociated with c
│ │ │ │ +00023ea0: 6970 6865 722e 0a0a 2020 2020 202a 5265  ipher...     *Re
│ │ │ │ +00023eb0: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ +00023ec0: 7572 6e20 6173 736f 6369 6174 6564 2063  urn associated c
│ │ │ │ +00023ed0: 6865 636b 7375 6d20 6d65 6368 616e 6973  hecksum mechanis
│ │ │ │ +00023ee0: 6d20 666f 7220 7468 650a 2020 2020 2065  m for the.     e
│ │ │ │ +00023ef0: 6e63 7279 7074 696f 6e20 7479 7065 2c20  ncryption type, 
│ │ │ │ +00023f00: 6173 2064 6566 696e 6564 2069 6e20 7468  as defined in th
│ │ │ │ +00023f10: 6520 7374 616e 6461 7264 732e 0a0a 7368  e standards...sh
│ │ │ │ +00023f20: 6973 6869 5f63 6970 6865 725f 7061 7273  ishi_cipher_pars
│ │ │ │ +00023f30: 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  e.--------------
│ │ │ │ +00023f40: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +00023f50: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ +00023f60: 6369 7068 6572 5f70 6172 7365 2028 636f  cipher_parse (co
│ │ │ │ +00023f70: 6e73 7420 6368 6172 202a 2043 4950 4845  nst char * CIPHE
│ │ │ │ +00023f80: 5229 0a20 2020 2020 4349 5048 4552 3a20  R).     CIPHER: 
│ │ │ │ +00023f90: 6e61 6d65 206f 6620 656e 6372 7970 7469  name of encrypti
│ │ │ │ +00023fa0: 6f6e 2074 7970 652c 2065 2e67 2e20 2022  on type, e.g.  "
│ │ │ │ +00023fb0: 6465 7333 2d63 6263 2d73 6861 312d 6b64  des3-cbc-sha1-kd
│ │ │ │ +00023fc0: 222e 0a0a 2020 2020 202a 4465 7363 7269  "...     *Descri
│ │ │ │ +00023fd0: 7074 696f 6e3a 2a20 4765 7420 6369 7068  ption:* Get ciph
│ │ │ │ +00023fe0: 6572 206e 756d 6265 7220 6279 2070 6172  er number by par
│ │ │ │ +00023ff0: 7369 6e67 2073 7472 696e 672e 0a0a 2020  sing string...  
│ │ │ │ +00024000: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ +00024010: 3a2a 2052 6574 7572 6e20 656e 6372 7970  :* Return encryp
│ │ │ │ +00024020: 7469 6f6e 2074 7970 6520 636f 7272 6573  tion type corres
│ │ │ │ +00024030: 706f 6e64 696e 6720 746f 2061 2073 7472  ponding to a str
│ │ │ │ +00024040: 696e 672e 0a0a 7368 6973 6869 5f63 6865  ing...shishi_che
│ │ │ │ +00024050: 636b 7375 6d5f 7375 7070 6f72 7465 645f  cksum_supported_
│ │ │ │ +00024060: 700a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  p.--------------
│ │ │ │ +00024070: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ +00024080: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ +00024090: 2073 6869 7368 695f 6368 6563 6b73 756d   shishi_checksum
│ │ │ │ +000240a0: 5f73 7570 706f 7274 6564 5f70 2028 696e  _supported_p (in
│ │ │ │ +000240b0: 7433 325f 7420 5459 5045 290a 2020 2020  t32_t TYPE).    
│ │ │ │ +000240c0: 2054 5950 453a 2063 6865 636b 7375 6d20   TYPE: checksum 
│ │ │ │ +000240d0: 7479 7065 2c20 7365 6520 5368 6973 6869  type, see Shishi
│ │ │ │ +000240e0: 5f63 6b73 756d 7479 7065 2e0a 0a20 2020  _cksumtype...   
│ │ │ │ +000240f0: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ +00024100: 2046 696e 6420 6f75 7420 7768 6574 6865   Find out whethe
│ │ │ │ +00024110: 7220 6368 6563 6b73 756d 2069 7320 7375  r checksum is su
│ │ │ │ +00024120: 7070 6f72 7465 642e 0a0a 2020 2020 202a  pported...     *
│ │ │ │ +00024130: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ +00024140: 6574 7572 6e20 3020 6966 6620 6368 6563  eturn 0 iff chec
│ │ │ │ +00024150: 6b73 756d 2069 7320 756e 7375 7070 6f72  ksum is unsuppor
│ │ │ │ +00024160: 7465 642e 0a0a 7368 6973 6869 5f63 6865  ted...shishi_che
│ │ │ │ +00024170: 636b 7375 6d5f 6e61 6d65 0a2d 2d2d 2d2d  cksum_name.-----
│ │ │ │ +00024180: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +00024190: 0a20 2d2d 2046 756e 6374 696f 6e3a 2063  . -- Function: c
│ │ │ │ +000241a0: 6f6e 7374 2063 6861 7220 2a20 7368 6973  onst char * shis
│ │ │ │ +000241b0: 6869 5f63 6865 636b 7375 6d5f 6e61 6d65  hi_checksum_name
│ │ │ │ +000241c0: 2028 696e 7433 325f 7420 5459 5045 290a   (int32_t TYPE).
│ │ │ │ +000241d0: 2020 2020 2054 5950 453a 2063 6865 636b       TYPE: check
│ │ │ │ +000241e0: 7375 6d20 7479 7065 2c20 7365 6520 5368  sum type, see Sh
│ │ │ │ +000241f0: 6973 6869 5f63 6b73 756d 7479 7065 2e0a  ishi_cksumtype..
│ │ │ │ +00024200: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +00024210: 6f6e 3a2a 2047 6574 206e 616d 6520 6f66  on:* Get name of
│ │ │ │ +00024220: 2063 6865 636b 7375 6d2e 0a0a 2020 2020   checksum...    
│ │ │ │ +00024230: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ +00024240: 2052 6574 7572 6e20 6e61 6d65 206f 6620   Return name of 
│ │ │ │ +00024250: 6368 6563 6b73 756d 2074 7970 652c 2065  checksum type, e
│ │ │ │ +00024260: 2e67 2e0a 2020 2020 2022 686d 6163 2d73  .g..     "hmac-s
│ │ │ │ +00024270: 6861 312d 3936 2d61 6573 3235 3622 2c20  ha1-96-aes256", 
│ │ │ │ +00024280: 6173 2064 6566 696e 6564 2069 6e20 7468  as defined in th
│ │ │ │ +00024290: 6520 7374 616e 6461 7264 732e 0a0a 7368  e standards...sh
│ │ │ │ +000242a0: 6973 6869 5f63 6865 636b 7375 6d5f 636b  ishi_checksum_ck
│ │ │ │ +000242b0: 7375 6d6c 656e 0a2d 2d2d 2d2d 2d2d 2d2d  sumlen.---------
│ │ │ │ +000242c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +000242d0: 0a20 2d2d 2046 756e 6374 696f 6e3a 2073  . -- Function: s
│ │ │ │ +000242e0: 697a 655f 7420 7368 6973 6869 5f63 6865  ize_t shishi_che
│ │ │ │ +000242f0: 636b 7375 6d5f 636b 7375 6d6c 656e 2028  cksum_cksumlen (
│ │ │ │ +00024300: 696e 7433 325f 7420 5459 5045 290a 2020  int32_t TYPE).  
│ │ │ │ +00024310: 2020 2054 5950 453a 2063 6865 636b 7375     TYPE: checksu
│ │ │ │ +00024320: 6d20 7479 7065 2c20 7365 6520 5368 6973  m type, see Shis
│ │ │ │ +00024330: 6869 5f63 6b73 756d 7479 7065 2e0a 0a20  hi_cksumtype... 
│ │ │ │ +00024340: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ +00024350: 3a2a 2047 6574 206c 656e 6774 6820 6f66  :* Get length of
│ │ │ │ +00024360: 2063 6865 636b 7375 6d20 6f75 7470 7574   checksum output
│ │ │ │ +00024370: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ +00024380: 7661 6c75 653a 2a20 5265 7475 726e 206c  value:* Return l
│ │ │ │ +00024390: 656e 6774 6820 6f66 2063 6865 636b 7375  ength of checksu
│ │ │ │ +000243a0: 6d20 7573 6564 2066 6f72 2074 6865 2063  m used for the c
│ │ │ │ +000243b0: 6865 636b 7375 6d0a 2020 2020 2074 7970  hecksum.     typ
│ │ │ │ +000243c0: 652c 2061 7320 6465 6669 6e65 6420 696e  e, as defined in
│ │ │ │ +000243d0: 2074 6865 2073 7461 6e64 6172 6473 2e0a   the standards..
│ │ │ │ +000243e0: 0a73 6869 7368 695f 6368 6563 6b73 756d  .shishi_checksum
│ │ │ │ +000243f0: 5f70 6172 7365 0a2d 2d2d 2d2d 2d2d 2d2d  _parse.---------
│ │ │ │ +00024400: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ +00024410: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ +00024420: 7368 6973 6869 5f63 6865 636b 7375 6d5f  shishi_checksum_
│ │ │ │ +00024430: 7061 7273 6520 2863 6f6e 7374 2063 6861  parse (const cha
│ │ │ │ +00024440: 7220 2a20 4348 4543 4b53 554d 290a 2020  r * CHECKSUM).  
│ │ │ │ +00024450: 2020 2043 4845 434b 5355 4d3a 206e 616d     CHECKSUM: nam
│ │ │ │ +00024460: 6520 6f66 2063 6865 636b 7375 6d20 7479  e of checksum ty
│ │ │ │ +00024470: 7065 2c20 652e 672e 2020 2268 6d61 632d  pe, e.g.  "hmac-
│ │ │ │ +00024480: 7368 6131 2d39 362d 6165 7332 3536 222e  sha1-96-aes256".
│ │ │ │ +00024490: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ +000244a0: 696f 6e3a 2a20 4765 7420 6368 6563 6b73  ion:* Get checks
│ │ │ │ +000244b0: 756d 206e 756d 6265 7220 6279 2070 6172  um number by par
│ │ │ │ +000244c0: 7369 6e67 2061 2073 7472 696e 672e 0a0a  sing a string...
│ │ │ │ +000244d0: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ +000244e0: 7565 3a2a 2052 6574 7572 6e20 6368 6563  ue:* Return chec
│ │ │ │ +000244f0: 6b73 756d 2074 7970 652c 2073 6565 2053  ksum type, see S
│ │ │ │ +00024500: 6869 7368 695f 636b 7375 6d74 7970 652c  hishi_cksumtype,
│ │ │ │ +00024510: 0a20 2020 2020 636f 7272 6573 706f 6e64  .     correspond
│ │ │ │ +00024520: 696e 6720 746f 2061 2073 7472 696e 672e  ing to a string.
│ │ │ │ +00024530: 0a0a 7368 6973 6869 5f73 7472 696e 675f  ..shishi_string_
│ │ │ │ +00024540: 746f 5f6b 6579 0a2d 2d2d 2d2d 2d2d 2d2d  to_key.---------
│ │ │ │ +00024550: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ +00024560: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ +00024570: 6869 7368 695f 7374 7269 6e67 5f74 6f5f  hishi_string_to_
│ │ │ │ +00024580: 6b65 7920 2853 6869 7368 6920 2a20 4841  key (Shishi * HA
│ │ │ │ +00024590: 4e44 4c45 2c0a 2020 2020 2020 2020 2020  NDLE,.          
│ │ │ │ +000245a0: 696e 7433 325f 7420 4b45 5954 5950 452c  int32_t KEYTYPE,
│ │ │ │ +000245b0: 2063 6f6e 7374 2063 6861 7220 2a20 5041   const char * PA
│ │ │ │ +000245c0: 5353 574f 5244 2c20 7369 7a65 5f74 2050  SSWORD, size_t P
│ │ │ │ +000245d0: 4153 5357 4f52 444c 454e 2c0a 2020 2020  ASSWORDLEN,.    
│ │ │ │ +000245e0: 2020 2020 2020 636f 6e73 7420 6368 6172        const char
│ │ │ │ +000245f0: 202a 2053 414c 542c 2073 697a 655f 7420   * SALT, size_t 
│ │ │ │ +00024600: 5341 4c54 4c45 4e2c 2063 6f6e 7374 2063  SALTLEN, const c
│ │ │ │ +00024610: 6861 7220 2a20 5041 5241 4d45 5445 522c  har * PARAMETER,
│ │ │ │ +00024620: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ +00024630: 695f 6b65 7920 2a20 4f55 544b 4559 290a  i_key * OUTKEY).
│ │ │ │ +00024640: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ +00024650: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ +00024660: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ +00024670: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ +00024680: 2020 2020 204b 4559 5459 5045 3a20 6372       KEYTYPE: cr
│ │ │ │ +00024690: 7970 746f 6772 6170 6869 6320 656e 6372  yptographic encr
│ │ │ │ +000246a0: 7970 7469 6f6e 2074 7970 652c 2073 6565  yption type, see
│ │ │ │ +000246b0: 2053 6869 7368 695f 6574 7970 652e 0a20   Shishi_etype.. 
│ │ │ │ +000246c0: 2020 2020 5041 5353 574f 5244 3a20 696e      PASSWORD: in
│ │ │ │ +000246d0: 7075 7420 6172 7261 7920 7769 7468 2070  put array with p
│ │ │ │ +000246e0: 6173 7377 6f72 642e 0a20 2020 2020 5041  assword..     PA
│ │ │ │ +000246f0: 5353 574f 5244 4c45 4e3a 206c 656e 6774  SSWORDLEN: lengt
│ │ │ │ +00024700: 6820 6f66 2069 6e70 7574 2061 7272 6179  h of input array
│ │ │ │ +00024710: 2077 6974 6820 7061 7373 776f 7264 2e0a   with password..
│ │ │ │ +00024720: 2020 2020 2053 414c 543a 2069 6e70 7574       SALT: input
│ │ │ │ +00024730: 2061 7272 6179 2077 6974 6820 7361 6c74   array with salt
│ │ │ │ +00024740: 2e0a 2020 2020 2053 414c 544c 454e 3a20  ..     SALTLEN: 
│ │ │ │ +00024750: 6c65 6e67 7468 206f 6620 696e 7075 7420  length of input 
│ │ │ │ +00024760: 6172 7261 7920 7769 7468 2073 616c 742e  array with salt.
│ │ │ │ +00024770: 0a20 2020 2020 5041 5241 4d45 5445 523a  .     PARAMETER:
│ │ │ │ +00024780: 2069 6e70 7574 2061 7272 6179 2077 6974   input array wit
│ │ │ │ +00024790: 6820 6f70 6171 7565 2065 6e63 7279 7074  h opaque encrypt
│ │ │ │ +000247a0: 696f 6e20 7479 7065 2073 7065 6369 6669  ion type specifi
│ │ │ │ +000247b0: 630a 2020 2020 2069 6e66 6f72 6d61 7469  c.     informati
│ │ │ │ +000247c0: 6f6e 2e0a 2020 2020 204f 5554 4b45 593a  on..     OUTKEY:
│ │ │ │ +000247d0: 2061 6c6c 6f63 6174 6564 206b 6579 2068   allocated key h
│ │ │ │ +000247e0: 616e 646c 6520 7468 6174 2077 696c 6c20  andle that will 
│ │ │ │ +000247f0: 636f 6e74 6169 6e20 6e65 7720 6b65 792e  contain new key.
│ │ │ │ +00024800: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ +00024810: 696f 6e3a 2a20 4465 7269 7665 206b 6579  ion:* Derive key
│ │ │ │ +00024820: 2066 726f 6d20 6120 7374 7269 6e67 2028   from a string (
│ │ │ │ +00024830: 7061 7373 776f 7264 2920 616e 6420 7361  password) and sa
│ │ │ │ +00024840: 6c74 0a20 2020 2020 2863 6f6d 6d6f 6e6c  lt.     (commonl
│ │ │ │ +00024850: 7920 636f 6e63 6174 656e 6174 696f 6e20  y concatenation 
│ │ │ │ +00024860: 6f66 2072 6561 6c6d 2061 6e64 2070 7269  of realm and pri
│ │ │ │ +00024870: 6e63 6970 616c 2920 666f 7220 7370 6563  ncipal) for spec
│ │ │ │ +00024880: 6966 6965 6420 6b65 790a 2020 2020 2074  ified key.     t
│ │ │ │ +00024890: 7970 652c 2061 6e64 2073 6574 2074 6865  ype, and set the
│ │ │ │ +000248a0: 2074 7970 6520 616e 6420 7661 6c75 6520   type and value 
│ │ │ │ +000248b0: 696e 2074 6865 2067 6976 656e 206b 6579  in the given key
│ │ │ │ +000248c0: 2074 6f20 7468 6520 636f 6d70 7574 6564   to the computed
│ │ │ │ +000248d0: 0a20 2020 2020 7661 6c75 6573 2e20 2054  .     values.  T
│ │ │ │ +000248e0: 6865 2070 6172 616d 6574 6572 2076 616c  he parameter val
│ │ │ │ +000248f0: 7565 2069 7320 7370 6563 6966 6963 2066  ue is specific f
│ │ │ │ +00024900: 6f72 2065 6163 6820 6b65 7974 7970 652c  or each keytype,
│ │ │ │ +00024910: 2061 6e64 2063 616e 0a20 2020 2020 6265   and can.     be
│ │ │ │ +00024920: 2073 6574 2069 6620 7468 6520 7061 7261   set if the para
│ │ │ │ +00024930: 6d65 7465 7220 696e 666f 726d 6174 696f  meter informatio
│ │ │ │ +00024940: 6e20 6973 206e 6f74 2061 7661 696c 6162  n is not availab
│ │ │ │ +00024950: 6c65 2e0a 0a20 2020 2020 2a52 6574 7572  le...     *Retur
│ │ │ │ +00024960: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ +00024970: 7320 e280 9853 4849 5348 495f 4f4b e280  s ...SHISHI_OK..
│ │ │ │ +00024980: 9920 6966 6620 7375 6363 6573 7366 756c  . iff successful
│ │ │ │ +00024990: 2e0a 0a73 6869 7368 695f 7261 6e64 6f6d  ...shishi_random
│ │ │ │ +000249a0: 5f74 6f5f 6b65 790a 2d2d 2d2d 2d2d 2d2d  _to_key.--------
│ │ │ │ +000249b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ +000249c0: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ +000249d0: 7368 6973 6869 5f72 616e 646f 6d5f 746f  shishi_random_to
│ │ │ │ +000249e0: 5f6b 6579 2028 5368 6973 6869 202a 2048  _key (Shishi * H
│ │ │ │ +000249f0: 414e 444c 452c 0a20 2020 2020 2020 2020  ANDLE,.         
│ │ │ │ +00024a00: 2069 6e74 3332 5f74 204b 4559 5459 5045   int32_t KEYTYPE
│ │ │ │ +00024a10: 2c20 636f 6e73 7420 6368 6172 202a 2052  , const char * R
│ │ │ │ +00024a20: 4e44 2c20 7369 7a65 5f74 2052 4e44 4c45  ND, size_t RNDLE
│ │ │ │ +00024a30: 4e2c 0a20 2020 2020 2020 2020 2053 6869  N,.          Shi
│ │ │ │ +00024a40: 7368 695f 6b65 7920 2a20 4f55 544b 4559  shi_key * OUTKEY
│ │ │ │ +00024a50: 290a 2020 2020 2048 414e 444c 453a 2073  ).     HANDLE: s
│ │ │ │ +00024a60: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ +00024a70: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ +00024a80: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ +00024a90: 2e0a 2020 2020 204b 4559 5459 5045 3a20  ..     KEYTYPE: 
│ │ │ │ +00024aa0: 6372 7970 746f 6772 6170 6869 6320 656e  cryptographic en
│ │ │ │ +00024ab0: 6372 7970 7469 6f6e 2074 7970 652c 2073  cryption type, s
│ │ │ │ +00024ac0: 6565 2053 6869 7368 695f 6574 7970 652e  ee Shishi_etype.
│ │ │ │ +00024ad0: 0a20 2020 2020 524e 443a 2069 6e70 7574  .     RND: input
│ │ │ │ +00024ae0: 2061 7272 6179 2077 6974 6820 7261 6e64   array with rand
│ │ │ │ +00024af0: 6f6d 2064 6174 612e 0a20 2020 2020 524e  om data..     RN
│ │ │ │ +00024b00: 444c 454e 3a20 6c65 6e67 7468 206f 6620  DLEN: length of 
│ │ │ │ +00024b10: 696e 7075 7420 6172 7261 7920 7769 7468  input array with
│ │ │ │ +00024b20: 2072 616e 646f 6d20 6461 7461 2e0a 2020   random data..  
│ │ │ │ +00024b30: 2020 204f 5554 4b45 593a 2061 6c6c 6f63     OUTKEY: alloc
│ │ │ │ +00024b40: 6174 6564 206b 6579 2068 616e 646c 6520  ated key handle 
│ │ │ │ +00024b50: 7468 6174 2077 696c 6c20 636f 6e74 6169  that will contai
│ │ │ │ +00024b60: 6e20 6e65 7720 6b65 792e 0a0a 2020 2020  n new key...    
│ │ │ │ +00024b70: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ +00024b80: 4465 7269 7665 206b 6579 2066 726f 6d20  Derive key from 
│ │ │ │ +00024b90: 7261 6e64 6f6d 2064 6174 6120 666f 7220  random data for 
│ │ │ │ +00024ba0: 7370 6563 6966 6965 6420 6b65 7920 7479  specified key ty
│ │ │ │ +00024bb0: 7065 2c0a 2020 2020 2061 6e64 2073 6574  pe,.     and set
│ │ │ │ +00024bc0: 2074 6865 2074 7970 6520 616e 6420 7661   the type and va
│ │ │ │ +00024bd0: 6c75 6520 696e 2074 6865 2067 6976 656e  lue in the given
│ │ │ │ +00024be0: 206b 6579 2074 6f20 7468 6520 636f 6d70   key to the comp
│ │ │ │ +00024bf0: 7574 6564 2076 616c 7565 732e 0a0a 2020  uted values...  
│ │ │ │ +00024c00: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ +00024c10: 3a2a 2052 6574 7572 6e73 20e2 8098 5348  :* Returns ...SH
│ │ │ │ +00024c20: 4953 4849 5f4f 4be2 8099 2069 6666 2073  ISHI_OK... iff s
│ │ │ │ +00024c30: 7563 6365 7373 6675 6c2e 0a0a 7368 6973  uccessful...shis
│ │ │ │ +00024c40: 6869 5f63 6865 636b 7375 6d0a 2d2d 2d2d  hi_checksum.----
│ │ │ │ +00024c50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ +00024c60: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ +00024c70: 6869 7368 695f 6368 6563 6b73 756d 2028  hishi_checksum (
│ │ │ │ +00024c80: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ +00024c90: 2053 6869 7368 695f 6b65 7920 2a20 4b45   Shishi_key * KE
│ │ │ │ +00024ca0: 592c 0a20 2020 2020 2020 2020 2069 6e74  Y,.          int
│ │ │ │ +00024cb0: 204b 4559 5553 4147 452c 2069 6e74 2043   KEYUSAGE, int C
│ │ │ │ +00024cc0: 4b53 554d 5459 5045 2c20 636f 6e73 7420  KSUMTYPE, const 
│ │ │ │ +00024cd0: 6368 6172 202a 2049 4e2c 2073 697a 655f  char * IN, size_
│ │ │ │ +00024ce0: 7420 494e 4c45 4e2c 0a20 2020 2020 2020  t INLEN,.       
│ │ │ │ +00024cf0: 2020 2063 6861 7220 2a2a 204f 5554 2c20     char ** OUT, 
│ │ │ │ +00024d00: 7369 7a65 5f74 202a 204f 5554 4c45 4e29  size_t * OUTLEN)
│ │ │ │ +00024d10: 0a20 2020 2020 4841 4e44 4c45 3a20 7368  .     HANDLE: sh
│ │ │ │ +00024d20: 6973 6869 2068 616e 646c 6520 6173 2061  ishi handle as a
│ │ │ │ +00024d30: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ +00024d40: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ +00024d50: 0a20 2020 2020 4b45 593a 206b 6579 2074  .     KEY: key t
│ │ │ │ +00024d60: 6f20 636f 6d70 7574 6520 6368 6563 6b73  o compute checks
│ │ │ │ +00024d70: 756d 2077 6974 682e 0a20 2020 2020 4b45  um with..     KE
│ │ │ │ +00024d80: 5955 5341 4745 3a20 696e 7465 6765 7220  YUSAGE: integer 
│ │ │ │ +00024d90: 7370 6563 6966 7969 6e67 2077 6861 7420  specifying what 
│ │ │ │ +00024da0: 7468 6973 206b 6579 2069 7320 7573 6564  this key is used
│ │ │ │ +00024db0: 2066 6f72 2e0a 2020 2020 2043 4b53 554d   for..     CKSUM
│ │ │ │ +00024dc0: 5459 5045 3a20 7468 6520 6368 6563 6b73  TYPE: the checks
│ │ │ │ +00024dd0: 756d 2061 6c67 6f72 6974 686d 2074 6f20  um algorithm to 
│ │ │ │ +00024de0: 7573 652e 0a20 2020 2020 494e 3a20 696e  use..     IN: in
│ │ │ │ +00024df0: 7075 7420 6172 7261 7920 7769 7468 2064  put array with d
│ │ │ │ +00024e00: 6174 6120 746f 2069 6e74 6567 7269 7479  ata to integrity
│ │ │ │ +00024e10: 2070 726f 7465 6374 2e0a 2020 2020 2049   protect..     I
│ │ │ │ +00024e20: 4e4c 454e 3a20 7369 7a65 206f 6620 696e  NLEN: size of in
│ │ │ │ +00024e30: 7075 7420 6172 7261 7920 7769 7468 2064  put array with d
│ │ │ │ +00024e40: 6174 6120 746f 2069 6e74 6567 7269 7479  ata to integrity
│ │ │ │ +00024e50: 2070 726f 7465 6374 2e0a 2020 2020 204f   protect..     O
│ │ │ │ +00024e60: 5554 3a20 6f75 7470 7574 2061 7272 6179  UT: output array
│ │ │ │ +00024e70: 2077 6974 6820 6e65 776c 7920 616c 6c6f   with newly allo
│ │ │ │ +00024e80: 6361 7465 6420 696e 7465 6772 6974 7920  cated integrity 
│ │ │ │ +00024e90: 7072 6f74 6563 7465 6420 6461 7461 2e0a  protected data..
│ │ │ │ +00024ea0: 2020 2020 204f 5554 4c45 4e3a 206f 7574       OUTLEN: out
│ │ │ │ +00024eb0: 7075 7420 7661 7269 6162 6c65 2077 6974  put variable wit
│ │ │ │ +00024ec0: 6820 6c65 6e67 7468 206f 6620 6f75 7470  h length of outp
│ │ │ │ +00024ed0: 7574 2061 7272 6179 2077 6974 6820 6368  ut array with ch
│ │ │ │ +00024ee0: 6563 6b73 756d 2e0a 0a20 2020 2020 2a44  ecksum...     *D
│ │ │ │ +00024ef0: 6573 6372 6970 7469 6f6e 3a2a 2049 6e74  escription:* Int
│ │ │ │ +00024f00: 6567 7269 7479 2070 726f 7465 6374 2064  egrity protect d
│ │ │ │ +00024f10: 6174 6120 7573 696e 6720 6b65 792c 2070  ata using key, p
│ │ │ │ +00024f20: 6f73 7369 626c 7920 616c 7465 7265 640a  ossibly altered.
│ │ │ │ +00024f30: 2020 2020 2062 7920 7375 7070 6c69 6564       by supplied
│ │ │ │ +00024f40: 206b 6579 2075 7361 6765 2e20 2049 6620   key usage.  If 
│ │ │ │ +00024f50: 6b65 7920 7573 6167 6520 6973 2030 2c20  key usage is 0, 
│ │ │ │ +00024f60: 6e6f 206b 6579 2064 6572 6976 6174 696f  no key derivatio
│ │ │ │ +00024f70: 6e20 6973 0a20 2020 2020 7573 6564 2e20  n is.     used. 
│ │ │ │ +00024f80: 2054 6865 204f 5554 2062 7566 6665 7220   The OUT buffer 
│ │ │ │ +00024f90: 6d75 7374 2062 6520 6465 616c 6c6f 6361  must be dealloca
│ │ │ │ +00024fa0: 7465 6420 6279 2074 6865 2063 616c 6c65  ted by the calle
│ │ │ │ +00024fb0: 722e 0a0a 2020 2020 202a 5265 7475 726e  r...     *Return
│ │ │ │ +00024fc0: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ +00024fd0: 20e2 8098 5348 4953 4849 5f4f 4be2 8099   ...SHISHI_OK...
│ │ │ │ +00024fe0: 2069 6666 2073 7563 6365 7373 6675 6c2e   iff successful.
│ │ │ │ +00024ff0: 0a0a 7368 6973 6869 5f76 6572 6966 790a  ..shishi_verify.
│ │ │ │ +00025000: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ +00025010: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ +00025020: 2073 6869 7368 695f 7665 7269 6679 2028   shishi_verify (
│ │ │ │ +00025030: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ +00025040: 2053 6869 7368 695f 6b65 7920 2a20 4b45   Shishi_key * KE
│ │ │ │ +00025050: 592c 0a20 2020 2020 2020 2020 2069 6e74  Y,.          int
│ │ │ │ +00025060: 204b 4559 5553 4147 452c 2069 6e74 2043   KEYUSAGE, int C
│ │ │ │ +00025070: 4b53 554d 5459 5045 2c20 636f 6e73 7420  KSUMTYPE, const 
│ │ │ │ +00025080: 6368 6172 202a 2049 4e2c 2073 697a 655f  char * IN, size_
│ │ │ │ +00025090: 7420 494e 4c45 4e2c 0a20 2020 2020 2020  t INLEN,.       
│ │ │ │ +000250a0: 2020 2063 6f6e 7374 2063 6861 7220 2a20     const char * 
│ │ │ │ +000250b0: 434b 5355 4d2c 2073 697a 655f 7420 434b  CKSUM, size_t CK
│ │ │ │ +000250c0: 5355 4d4c 454e 290a 2020 2020 2048 414e  SUMLEN).     HAN
│ │ │ │ +000250d0: 444c 453a 2073 6869 7368 6920 6861 6e64  DLE: shishi hand
│ │ │ │ +000250e0: 6c65 2061 7320 616c 6c6f 6361 7465 6420  le as allocated 
│ │ │ │ +000250f0: 6279 20e2 8098 7368 6973 6869 5f69 6e69  by ...shishi_ini
│ │ │ │ +00025100: 7428 29e2 8099 2e0a 2020 2020 204b 4559  t().....     KEY
│ │ │ │ +00025110: 3a20 6b65 7920 746f 2076 6572 6966 7920  : key to verify 
│ │ │ │ +00025120: 6368 6563 6b73 756d 2077 6974 682e 0a20  checksum with.. 
│ │ │ │ +00025130: 2020 2020 4b45 5955 5341 4745 3a20 696e      KEYUSAGE: in
│ │ │ │ +00025140: 7465 6765 7220 7370 6563 6966 7969 6e67  teger specifying
│ │ │ │ +00025150: 2077 6861 7420 7468 6973 206b 6579 2069   what this key i
│ │ │ │ +00025160: 7320 7573 6564 2066 6f72 2e0a 2020 2020  s used for..    
│ │ │ │ +00025170: 2043 4b53 554d 5459 5045 3a20 7468 6520   CKSUMTYPE: the 
│ │ │ │ +00025180: 6368 6563 6b73 756d 2061 6c67 6f72 6974  checksum algorit
│ │ │ │ +00025190: 686d 2074 6f20 7573 652e 0a20 2020 2020  hm to use..     
│ │ │ │ +000251a0: 494e 3a20 696e 7075 7420 6172 7261 7920  IN: input array 
│ │ │ │ +000251b0: 7769 7468 2064 6174 6120 7468 6174 2077  with data that w
│ │ │ │ +000251c0: 6173 2069 6e74 6567 7269 7479 2070 726f  as integrity pro
│ │ │ │ +000251d0: 7465 6374 6564 2e0a 2020 2020 2049 4e4c  tected..     INL
│ │ │ │ +000251e0: 454e 3a20 7369 7a65 206f 6620 696e 7075  EN: size of inpu
│ │ │ │ +000251f0: 7420 6172 7261 7920 7769 7468 2064 6174  t array with dat
│ │ │ │ +00025200: 6120 7468 6174 2077 6173 2069 6e74 6567  a that was integ
│ │ │ │ +00025210: 7269 7479 2070 726f 7465 6374 6564 2e0a  rity protected..
│ │ │ │ +00025220: 0a20 2020 2020 434b 5355 4d3a 2069 6e70  .     CKSUM: inp
│ │ │ │ +00025230: 7574 2061 7272 6179 2077 6974 6820 616c  ut array with al
│ │ │ │ +00025240: 6c65 6765 6420 6368 6563 6b73 756d 206f  leged checksum o
│ │ │ │ +00025250: 6620 6461 7461 2e0a 2020 2020 2043 4b53  f data..     CKS
│ │ │ │ +00025260: 554d 4c45 4e3a 2073 697a 6520 6f66 2069  UMLEN: size of i
│ │ │ │ +00025270: 6e70 7574 2061 7272 6179 2077 6974 6820  nput array with 
│ │ │ │ +00025280: 616c 6c65 6765 6420 6368 6563 6b73 756d  alleged checksum
│ │ │ │ +00025290: 206f 6620 6461 7461 2e0a 0a20 2020 2020   of data...     
│ │ │ │ +000252a0: 2a44 6573 6372 6970 7469 6f6e 3a2a 2056  *Description:* V
│ │ │ │ +000252b0: 6572 6966 7920 6368 6563 6b73 756d 206f  erify checksum o
│ │ │ │ +000252c0: 6620 6461 7461 2075 7369 6e67 206b 6579  f data using key
│ │ │ │ +000252d0: 2c20 706f 7373 6962 6c79 2061 6c74 6572  , possibly alter
│ │ │ │ +000252e0: 6564 0a20 2020 2020 6279 2073 7570 706c  ed.     by suppl
│ │ │ │ +000252f0: 6965 6420 6b65 7920 7573 6167 652e 2020  ied key usage.  
│ │ │ │ +00025300: 4966 206b 6579 2075 7361 6765 2069 7320  If key usage is 
│ │ │ │ +00025310: 302c 206e 6f20 6b65 7920 6465 7269 7661  0, no key deriva
│ │ │ │ +00025320: 7469 6f6e 2069 730a 2020 2020 2075 7365  tion is.     use
│ │ │ │ +00025330: 642e 0a0a 2020 2020 202a 5265 7475 726e  d...     *Return
│ │ │ │ +00025340: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ +00025350: 20e2 8098 5348 4953 4849 5f4f 4be2 8099   ...SHISHI_OK...
│ │ │ │ +00025360: 2069 6666 2073 7563 6365 7373 6675 6c2e   iff successful.
│ │ │ │ +00025370: 0a0a 7368 6973 6869 5f65 6e63 7279 7074  ..shishi_encrypt
│ │ │ │ +00025380: 5f69 7675 7064 6174 655f 6574 7970 650a  _ivupdate_etype.
│ │ │ │  00025390: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000253a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ -000253b0: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ -000253c0: 7368 6973 6869 5f65 6e63 7279 7074 5f69  shishi_encrypt_i
│ │ │ │ -000253d0: 7675 7064 6174 655f 6574 7970 6520 2853  vupdate_etype (S
│ │ │ │ -000253e0: 6869 7368 6920 2a20 4841 4e44 4c45 2c0a  hishi * HANDLE,.
│ │ │ │ -000253f0: 2020 2020 2020 2020 2020 5368 6973 6869            Shishi
│ │ │ │ -00025400: 5f6b 6579 202a 204b 4559 2c20 696e 7420  _key * KEY, int 
│ │ │ │ -00025410: 4b45 5955 5341 4745 2c20 696e 7433 325f  KEYUSAGE, int32_
│ │ │ │ -00025420: 7420 4554 5950 452c 0a20 2020 2020 2020  t ETYPE,.       
│ │ │ │ -00025430: 2020 2063 6f6e 7374 2063 6861 7220 2a20     const char * 
│ │ │ │ -00025440: 4956 2c20 7369 7a65 5f74 2049 564c 454e  IV, size_t IVLEN
│ │ │ │ -00025450: 2c20 6368 6172 202a 2a20 4956 4f55 542c  , char ** IVOUT,
│ │ │ │ -00025460: 0a20 2020 2020 2020 2020 2073 697a 655f  .          size_
│ │ │ │ -00025470: 7420 2a20 4956 4f55 544c 454e 2c20 636f  t * IVOUTLEN, co
│ │ │ │ -00025480: 6e73 7420 6368 6172 202a 2049 4e2c 2073  nst char * IN, s
│ │ │ │ -00025490: 697a 655f 7420 494e 4c45 4e2c 2063 6861  ize_t INLEN, cha
│ │ │ │ -000254a0: 7220 2a2a 204f 5554 2c0a 2020 2020 2020  r ** OUT,.      
│ │ │ │ -000254b0: 2020 2020 7369 7a65 5f74 202a 204f 5554      size_t * OUT
│ │ │ │ -000254c0: 4c45 4e29 0a20 2020 2020 4841 4e44 4c45  LEN).     HANDLE
│ │ │ │ -000254d0: 3a20 7368 6973 6869 2068 616e 646c 6520  : shishi handle 
│ │ │ │ -000254e0: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ -000254f0: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ -00025500: e280 992e 0a20 2020 2020 4b45 593a 206b  .....     KEY: k
│ │ │ │ -00025510: 6579 2074 6f20 656e 6372 7970 7420 7769  ey to encrypt wi
│ │ │ │ -00025520: 7468 2e0a 2020 2020 204b 4559 5553 4147  th..     KEYUSAG
│ │ │ │ -00025530: 453a 2069 6e74 6567 6572 2073 7065 6369  E: integer speci
│ │ │ │ -00025540: 6679 696e 6720 7768 6174 2074 6869 7320  fying what this 
│ │ │ │ -00025550: 6b65 7920 6973 2065 6e63 7279 7074 696e  key is encryptin
│ │ │ │ -00025560: 672e 0a20 2020 2020 4554 5950 453a 2069  g..     ETYPE: i
│ │ │ │ -00025570: 6e74 6567 6572 2073 7065 6369 6679 696e  nteger specifyin
│ │ │ │ -00025580: 6720 7768 6174 2063 6970 6865 7220 746f  g what cipher to
│ │ │ │ -00025590: 2075 7365 2e0a 2020 2020 2049 563a 2069   use..     IV: i
│ │ │ │ -000255a0: 6e70 7574 2061 7272 6179 2077 6974 6820  nput array with 
│ │ │ │ -000255b0: 696e 6974 6961 6c69 7a61 7469 6f6e 2076  initialization v
│ │ │ │ -000255c0: 6563 746f 720a 2020 2020 2049 564c 454e  ector.     IVLEN
│ │ │ │ -000255d0: 3a20 7369 7a65 206f 6620 696e 7075 7420  : size of input 
│ │ │ │ -000255e0: 6172 7261 7920 7769 7468 2069 6e69 7469  array with initi
│ │ │ │ -000255f0: 616c 697a 6174 696f 6e20 7665 6374 6f72  alization vector
│ │ │ │ -00025600: 2e0a 2020 2020 2049 564f 5554 3a20 6f75  ..     IVOUT: ou
│ │ │ │ -00025610: 7470 7574 2061 7272 6179 2077 6974 6820  tput array with 
│ │ │ │ -00025620: 6e65 776c 7920 616c 6c6f 6361 7465 6420  newly allocated 
│ │ │ │ -00025630: 7570 6461 7465 6420 696e 6974 6961 6c69  updated initiali
│ │ │ │ -00025640: 7a61 7469 6f6e 0a20 2020 2020 7665 6374  zation.     vect
│ │ │ │ -00025650: 6f72 2e0a 2020 2020 2049 564f 5554 4c45  or..     IVOUTLE
│ │ │ │ -00025660: 4e3a 2073 697a 6520 6f66 206f 7574 7075  N: size of outpu
│ │ │ │ -00025670: 7420 6172 7261 7920 7769 7468 2075 7064  t array with upd
│ │ │ │ -00025680: 6174 6564 2069 6e69 7469 616c 697a 6174  ated initializat
│ │ │ │ -00025690: 696f 6e20 7665 6374 6f72 2e0a 0a20 2020  ion vector...   
│ │ │ │ -000256a0: 2020 494e 3a20 696e 7075 7420 6172 7261    IN: input arra
│ │ │ │ -000256b0: 7920 7769 7468 2064 6174 6120 746f 2065  y with data to e
│ │ │ │ -000256c0: 6e63 7279 7074 2e0a 2020 2020 2049 4e4c  ncrypt..     INL
│ │ │ │ -000256d0: 454e 3a20 7369 7a65 206f 6620 696e 7075  EN: size of inpu
│ │ │ │ -000256e0: 7420 6172 7261 7920 7769 7468 2064 6174  t array with dat
│ │ │ │ -000256f0: 6120 746f 2065 6e63 7279 7074 2e0a 2020  a to encrypt..  
│ │ │ │ -00025700: 2020 204f 5554 3a20 6f75 7470 7574 2061     OUT: output a
│ │ │ │ -00025710: 7272 6179 2077 6974 6820 6e65 776c 7920  rray with newly 
│ │ │ │ -00025720: 616c 6c6f 6361 7465 6420 656e 6372 7970  allocated encryp
│ │ │ │ -00025730: 7465 6420 6461 7461 2e0a 2020 2020 204f  ted data..     O
│ │ │ │ -00025740: 5554 4c45 4e3a 206f 7574 7075 7420 7661  UTLEN: output va
│ │ │ │ -00025750: 7269 6162 6c65 2077 6974 6820 7369 7a65  riable with size
│ │ │ │ -00025760: 206f 6620 6e65 776c 7920 616c 6c6f 6361   of newly alloca
│ │ │ │ -00025770: 7465 6420 6f75 7470 7574 2061 7272 6179  ted output array
│ │ │ │ -00025780: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ -00025790: 7469 6f6e 3a2a 2045 6e63 7279 7074 7320  tion:* Encrypts 
│ │ │ │ -000257a0: 6461 7461 2061 7320 7065 7220 656e 6372  data as per encr
│ │ │ │ -000257b0: 7970 7469 6f6e 206d 6574 686f 6420 7573  yption method us
│ │ │ │ -000257c0: 696e 670a 2020 2020 2073 7065 6369 6669  ing.     specifi
│ │ │ │ -000257d0: 6564 2069 6e69 7469 616c 697a 6174 696f  ed initializatio
│ │ │ │ -000257e0: 6e20 7665 6374 6f72 2061 6e64 206b 6579  n vector and key
│ │ │ │ -000257f0: 2e20 2054 6865 206b 6579 2061 6374 7561  .  The key actua
│ │ │ │ -00025800: 6c6c 7920 7573 6564 2069 730a 2020 2020  lly used is.    
│ │ │ │ -00025810: 2064 6572 6976 6564 2075 7369 6e67 2074   derived using t
│ │ │ │ -00025820: 6865 206b 6579 2075 7361 6765 2e20 2049  he key usage.  I
│ │ │ │ -00025830: 6620 6b65 7920 7573 6167 6520 6973 2030  f key usage is 0
│ │ │ │ -00025840: 2c20 6e6f 206b 6579 2064 6572 6976 6174  , no key derivat
│ │ │ │ -00025850: 696f 6e0a 2020 2020 2069 7320 7573 6564  ion.     is used
│ │ │ │ -00025860: 2e20 2054 6865 204f 5554 2062 7566 6665  .  The OUT buffe
│ │ │ │ -00025870: 7220 6d75 7374 2062 6520 6465 616c 6c6f  r must be deallo
│ │ │ │ -00025880: 6361 7465 6420 6279 2074 6865 2063 616c  cated by the cal
│ │ │ │ -00025890: 6c65 722e 2020 4966 0a20 2020 2020 4956  ler.  If.     IV
│ │ │ │ -000258a0: 4f55 5420 6f72 2049 564f 5554 4c45 4e20  OUT or IVOUTLEN 
│ │ │ │ -000258b0: 6973 204e 554c 4c2c 2074 6865 2075 7064  is NULL, the upd
│ │ │ │ -000258c0: 6174 6564 2049 5620 6973 206e 6f74 2073  ated IV is not s
│ │ │ │ -000258d0: 6176 6564 2061 6e79 7768 6572 652e 0a0a  aved anywhere...
│ │ │ │ -000258e0: 2020 2020 204e 6f74 6520 7468 6174 2044       Note that D
│ │ │ │ -000258f0: 4543 5259 5054 2845 4e43 5259 5054 2864  ECRYPT(ENCRYPT(d
│ │ │ │ -00025900: 6174 6129 2920 646f 6573 206e 6f74 206e  ata)) does not n
│ │ │ │ -00025910: 6563 6573 7361 7269 6c79 2079 6965 6c64  ecessarily yield
│ │ │ │ -00025920: 2064 6174 610a 2020 2020 2065 7861 6374   data.     exact
│ │ │ │ -00025930: 6c79 2e20 2053 6f6d 6520 656e 6372 7970  ly.  Some encryp
│ │ │ │ -00025940: 7469 6f6e 2074 7970 6573 2061 6464 2070  tion types add p
│ │ │ │ -00025950: 6164 2074 6f20 6d61 6b65 2074 6865 2064  ad to make the d
│ │ │ │ -00025960: 6174 6120 6669 7420 696e 746f 0a20 2020  ata fit into.   
│ │ │ │ -00025970: 2020 7468 6520 626c 6f63 6b20 7369 7a65    the block size
│ │ │ │ -00025980: 206f 6620 7468 6520 656e 6372 7970 7469   of the encrypti
│ │ │ │ -00025990: 6f6e 2061 6c67 6f72 6974 686d 2e20 2046  on algorithm.  F
│ │ │ │ -000259a0: 7572 7468 6572 6d6f 7265 2c20 7468 6520  urthermore, the 
│ │ │ │ -000259b0: 7061 640a 2020 2020 2069 7320 6e6f 7420  pad.     is not 
│ │ │ │ -000259c0: 6775 6172 616e 7465 6564 2074 6f20 6c6f  guaranteed to lo
│ │ │ │ -000259d0: 6f6b 2069 6e20 616e 7920 7370 6563 6961  ok in any specia
│ │ │ │ -000259e0: 6c20 7761 792c 2061 6c74 686f 7567 6820  l way, although 
│ │ │ │ -000259f0: 6578 6973 7469 6e67 0a20 2020 2020 696d  existing.     im
│ │ │ │ -00025a00: 706c 656d 656e 7461 7469 6f6e 7320 6f66  plementations of
│ │ │ │ -00025a10: 7465 6e20 7061 6420 7769 7468 2074 6865  ten pad with the
│ │ │ │ -00025a20: 207a 6572 6f20 6279 7465 2e20 2054 6869   zero byte.  Thi
│ │ │ │ -00025a30: 7320 6d65 616e 7320 7468 6174 2079 6f75  s means that you
│ │ │ │ -00025a40: 0a20 2020 2020 6d61 7920 6861 7665 2074  .     may have t
│ │ │ │ -00025a50: 6f20 2266 7261 6d65 2220 6461 7461 2c20  o "frame" data, 
│ │ │ │ -00025a60: 736f 2069 7420 6973 2070 6f73 7369 626c  so it is possibl
│ │ │ │ -00025a70: 6520 746f 2069 6e66 6572 2074 6865 206f  e to infer the o
│ │ │ │ -00025a80: 7269 6769 6e61 6c0a 2020 2020 206c 656e  riginal.     len
│ │ │ │ -00025a90: 6774 6820 6166 7465 7220 6465 6372 7970  gth after decryp
│ │ │ │ -00025aa0: 7469 6f6e 2e20 2043 6f6d 7061 7265 2041  tion.  Compare A
│ │ │ │ -00025ab0: 534e 2e31 2044 4552 2077 6869 6368 2063  SN.1 DER which c
│ │ │ │ -00025ac0: 6f6e 7461 696e 7320 7375 6368 0a20 2020  ontains such.   
│ │ │ │ -00025ad0: 2020 696e 666f 726d 6174 696f 6e2e 0a0a    information...
│ │ │ │ -00025ae0: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ -00025af0: 7565 3a2a 2052 6574 7572 6e73 20e2 8098  ue:* Returns ...
│ │ │ │ -00025b00: 5348 4953 4849 5f4f 4be2 8099 2069 6666  SHISHI_OK... iff
│ │ │ │ -00025b10: 2073 7563 6365 7373 6675 6c2e 0a0a 7368   successful...sh
│ │ │ │ -00025b20: 6973 6869 5f65 6e63 7279 7074 5f69 765f  ishi_encrypt_iv_
│ │ │ │ -00025b30: 6574 7970 650a 2d2d 2d2d 2d2d 2d2d 2d2d  etype.----------
│ │ │ │ -00025b40: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -00025b50: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ -00025b60: 2073 6869 7368 695f 656e 6372 7970 745f   shishi_encrypt_
│ │ │ │ -00025b70: 6976 5f65 7479 7065 2028 5368 6973 6869  iv_etype (Shishi
│ │ │ │ -00025b80: 202a 2048 414e 444c 452c 0a20 2020 2020   * HANDLE,.     
│ │ │ │ -00025b90: 2020 2020 2053 6869 7368 695f 6b65 7920       Shishi_key 
│ │ │ │ -00025ba0: 2a20 4b45 592c 2069 6e74 204b 4559 5553  * KEY, int KEYUS
│ │ │ │ -00025bb0: 4147 452c 2069 6e74 3332 5f74 2045 5459  AGE, int32_t ETY
│ │ │ │ -00025bc0: 5045 2c0a 2020 2020 2020 2020 2020 636f  PE,.          co
│ │ │ │ -00025bd0: 6e73 7420 6368 6172 202a 2049 562c 2073  nst char * IV, s
│ │ │ │ -00025be0: 697a 655f 7420 4956 4c45 4e2c 2063 6f6e  ize_t IVLEN, con
│ │ │ │ -00025bf0: 7374 2063 6861 7220 2a20 494e 2c20 7369  st char * IN, si
│ │ │ │ -00025c00: 7a65 5f74 2049 4e4c 454e 2c0a 2020 2020  ze_t INLEN,.    
│ │ │ │ -00025c10: 2020 2020 2020 6368 6172 202a 2a20 4f55        char ** OU
│ │ │ │ -00025c20: 542c 2073 697a 655f 7420 2a20 4f55 544c  T, size_t * OUTL
│ │ │ │ -00025c30: 454e 290a 2020 2020 2048 414e 444c 453a  EN).     HANDLE:
│ │ │ │ -00025c40: 2073 6869 7368 6920 6861 6e64 6c65 2061   shishi handle a
│ │ │ │ -00025c50: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ -00025c60: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ -00025c70: 8099 2e0a 2020 2020 204b 4559 3a20 6b65  ....     KEY: ke
│ │ │ │ -00025c80: 7920 746f 2065 6e63 7279 7074 2077 6974  y to encrypt wit
│ │ │ │ -00025c90: 682e 0a20 2020 2020 4b45 5955 5341 4745  h..     KEYUSAGE
│ │ │ │ -00025ca0: 3a20 696e 7465 6765 7220 7370 6563 6966  : integer specif
│ │ │ │ -00025cb0: 7969 6e67 2077 6861 7420 7468 6973 206b  ying what this k
│ │ │ │ -00025cc0: 6579 2069 7320 656e 6372 7970 7469 6e67  ey is encrypting
│ │ │ │ -00025cd0: 2e0a 2020 2020 2045 5459 5045 3a20 696e  ..     ETYPE: in
│ │ │ │ -00025ce0: 7465 6765 7220 7370 6563 6966 7969 6e67  teger specifying
│ │ │ │ -00025cf0: 2077 6861 7420 6369 7068 6572 2074 6f20   what cipher to 
│ │ │ │ -00025d00: 7573 652e 0a20 2020 2020 4956 3a20 696e  use..     IV: in
│ │ │ │ -00025d10: 7075 7420 6172 7261 7920 7769 7468 2069  put array with i
│ │ │ │ -00025d20: 6e69 7469 616c 697a 6174 696f 6e20 7665  nitialization ve
│ │ │ │ -00025d30: 6374 6f72 0a20 2020 2020 4956 4c45 4e3a  ctor.     IVLEN:
│ │ │ │ -00025d40: 2073 697a 6520 6f66 2069 6e70 7574 2061   size of input a
│ │ │ │ -00025d50: 7272 6179 2077 6974 6820 696e 6974 6961  rray with initia
│ │ │ │ -00025d60: 6c69 7a61 7469 6f6e 2076 6563 746f 722e  lization vector.
│ │ │ │ -00025d70: 0a20 2020 2020 494e 3a20 696e 7075 7420  .     IN: input 
│ │ │ │ -00025d80: 6172 7261 7920 7769 7468 2064 6174 6120  array with data 
│ │ │ │ -00025d90: 746f 2065 6e63 7279 7074 2e0a 2020 2020  to encrypt..    
│ │ │ │ -00025da0: 2049 4e4c 454e 3a20 7369 7a65 206f 6620   INLEN: size of 
│ │ │ │ -00025db0: 696e 7075 7420 6172 7261 7920 7769 7468  input array with
│ │ │ │ -00025dc0: 2064 6174 6120 746f 2065 6e63 7279 7074   data to encrypt
│ │ │ │ -00025dd0: 2e0a 2020 2020 204f 5554 3a20 6f75 7470  ..     OUT: outp
│ │ │ │ -00025de0: 7574 2061 7272 6179 2077 6974 6820 6e65  ut array with ne
│ │ │ │ -00025df0: 776c 7920 616c 6c6f 6361 7465 6420 656e  wly allocated en
│ │ │ │ -00025e00: 6372 7970 7465 6420 6461 7461 2e0a 2020  crypted data..  
│ │ │ │ -00025e10: 2020 204f 5554 4c45 4e3a 206f 7574 7075     OUTLEN: outpu
│ │ │ │ -00025e20: 7420 7661 7269 6162 6c65 2077 6974 6820  t variable with 
│ │ │ │ -00025e30: 7369 7a65 206f 6620 6e65 776c 7920 616c  size of newly al
│ │ │ │ -00025e40: 6c6f 6361 7465 6420 6f75 7470 7574 2061  located output a
│ │ │ │ -00025e50: 7272 6179 2e0a 0a20 2020 2020 2a44 6573  rray...     *Des
│ │ │ │ -00025e60: 6372 6970 7469 6f6e 3a2a 2045 6e63 7279  cription:* Encry
│ │ │ │ -00025e70: 7074 7320 6461 7461 2061 7320 7065 7220  pts data as per 
│ │ │ │ -00025e80: 656e 6372 7970 7469 6f6e 206d 6574 686f  encryption metho
│ │ │ │ -00025e90: 6420 7573 696e 670a 2020 2020 2073 7065  d using.     spe
│ │ │ │ -00025ea0: 6369 6669 6564 2069 6e69 7469 616c 697a  cified initializ
│ │ │ │ -00025eb0: 6174 696f 6e20 7665 6374 6f72 2061 6e64  ation vector and
│ │ │ │ -00025ec0: 206b 6579 2e20 2054 6865 206b 6579 2061   key.  The key a
│ │ │ │ -00025ed0: 6374 7561 6c6c 7920 7573 6564 2069 730a  ctually used is.
│ │ │ │ -00025ee0: 2020 2020 2064 6572 6976 6564 2075 7369       derived usi
│ │ │ │ -00025ef0: 6e67 2074 6865 206b 6579 2075 7361 6765  ng the key usage
│ │ │ │ -00025f00: 2e20 2049 6620 6b65 7920 7573 6167 6520  .  If key usage 
│ │ │ │ -00025f10: 6973 2030 2c20 6e6f 206b 6579 2064 6572  is 0, no key der
│ │ │ │ -00025f20: 6976 6174 696f 6e0a 2020 2020 2069 7320  ivation.     is 
│ │ │ │ -00025f30: 7573 6564 2e20 2054 6865 204f 5554 2062  used.  The OUT b
│ │ │ │ -00025f40: 7566 6665 7220 6d75 7374 2062 6520 6465  uffer must be de
│ │ │ │ -00025f50: 616c 6c6f 6361 7465 6420 6279 2074 6865  allocated by the
│ │ │ │ -00025f60: 2063 616c 6c65 722e 2020 5468 650a 2020   caller.  The.  
│ │ │ │ -00025f70: 2020 206e 6578 7420 4956 2069 7320 6c6f     next IV is lo
│ │ │ │ -00025f80: 7374 2c20 7365 6520 7368 6973 6869 5f65  st, see shishi_e
│ │ │ │ -00025f90: 6e63 7279 7074 5f69 7675 7064 6174 655f  ncrypt_ivupdate_
│ │ │ │ -00025fa0: 6574 7970 6520 6966 2079 6f75 206e 6565  etype if you nee
│ │ │ │ -00025fb0: 6420 6974 2e0a 0a20 2020 2020 4e6f 7465  d it...     Note
│ │ │ │ -00025fc0: 2074 6861 7420 4445 4352 5950 5428 454e   that DECRYPT(EN
│ │ │ │ -00025fd0: 4352 5950 5428 6461 7461 2929 2064 6f65  CRYPT(data)) doe
│ │ │ │ -00025fe0: 7320 6e6f 7420 6e65 6365 7373 6172 696c  s not necessaril
│ │ │ │ -00025ff0: 7920 7969 656c 6420 6461 7461 0a20 2020  y yield data.   
│ │ │ │ -00026000: 2020 6578 6163 746c 792e 2020 536f 6d65    exactly.  Some
│ │ │ │ -00026010: 2065 6e63 7279 7074 696f 6e20 7479 7065   encryption type
│ │ │ │ -00026020: 7320 6164 6420 7061 6420 746f 206d 616b  s add pad to mak
│ │ │ │ -00026030: 6520 7468 6520 6461 7461 2066 6974 2069  e the data fit i
│ │ │ │ -00026040: 6e74 6f0a 2020 2020 2074 6865 2062 6c6f  nto.     the blo
│ │ │ │ -00026050: 636b 2073 697a 6520 6f66 2074 6865 2065  ck size of the e
│ │ │ │ -00026060: 6e63 7279 7074 696f 6e20 616c 676f 7269  ncryption algori
│ │ │ │ -00026070: 7468 6d2e 2020 4675 7274 6865 726d 6f72  thm.  Furthermor
│ │ │ │ -00026080: 652c 2074 6865 2070 6164 0a20 2020 2020  e, the pad.     
│ │ │ │ -00026090: 6973 206e 6f74 2067 7561 7261 6e74 6565  is not guarantee
│ │ │ │ -000260a0: 6420 746f 206c 6f6f 6b20 696e 2061 6e79  d to look in any
│ │ │ │ -000260b0: 2073 7065 6369 616c 2077 6179 2c20 616c   special way, al
│ │ │ │ -000260c0: 7468 6f75 6768 2065 7869 7374 696e 670a  though existing.
│ │ │ │ -000260d0: 2020 2020 2069 6d70 6c65 6d65 6e74 6174       implementat
│ │ │ │ -000260e0: 696f 6e73 206f 6674 656e 2070 6164 2077  ions often pad w
│ │ │ │ -000260f0: 6974 6820 7468 6520 7a65 726f 2062 7974  ith the zero byt
│ │ │ │ -00026100: 652e 2020 5468 6973 206d 6561 6e73 2074  e.  This means t
│ │ │ │ -00026110: 6861 7420 796f 750a 2020 2020 206d 6179  hat you.     may
│ │ │ │ -00026120: 2068 6176 6520 746f 2022 6672 616d 6522   have to "frame"
│ │ │ │ -00026130: 2064 6174 612c 2073 6f20 6974 2069 7320   data, so it is 
│ │ │ │ -00026140: 706f 7373 6962 6c65 2074 6f20 696e 6665  possible to infe
│ │ │ │ -00026150: 7220 7468 6520 6f72 6967 696e 616c 0a20  r the original. 
│ │ │ │ -00026160: 2020 2020 6c65 6e67 7468 2061 6674 6572      length after
│ │ │ │ -00026170: 2064 6563 7279 7074 696f 6e2e 2020 436f   decryption.  Co
│ │ │ │ -00026180: 6d70 6172 6520 4153 4e2e 3120 4445 5220  mpare ASN.1 DER 
│ │ │ │ -00026190: 7768 6963 6820 636f 6e74 6169 6e73 2073  which contains s
│ │ │ │ -000261a0: 7563 680a 2020 2020 2069 6e66 6f72 6d61  uch.     informa
│ │ │ │ -000261b0: 7469 6f6e 2e0a 0a20 2020 2020 2a52 6574  tion...     *Ret
│ │ │ │ -000261c0: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ -000261d0: 726e 7320 e280 9853 4849 5348 495f 4f4b  rns ...SHISHI_OK
│ │ │ │ -000261e0: e280 9920 6966 6620 7375 6363 6573 7366  ... iff successf
│ │ │ │ -000261f0: 756c 2e0a 0a73 6869 7368 695f 656e 6372  ul...shishi_encr
│ │ │ │ -00026200: 7970 745f 6574 7970 650a 2d2d 2d2d 2d2d  ypt_etype.------
│ │ │ │ -00026210: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -00026220: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ -00026230: 7420 7368 6973 6869 5f65 6e63 7279 7074  t shishi_encrypt
│ │ │ │ -00026240: 5f65 7479 7065 2028 5368 6973 6869 202a  _etype (Shishi *
│ │ │ │ -00026250: 2048 414e 444c 452c 0a20 2020 2020 2020   HANDLE,.       
│ │ │ │ -00026260: 2020 2053 6869 7368 695f 6b65 7920 2a20     Shishi_key * 
│ │ │ │ -00026270: 4b45 592c 2069 6e74 204b 4559 5553 4147  KEY, int KEYUSAG
│ │ │ │ -00026280: 452c 2069 6e74 3332 5f74 2045 5459 5045  E, int32_t ETYPE
│ │ │ │ -00026290: 2c0a 2020 2020 2020 2020 2020 636f 6e73  ,.          cons
│ │ │ │ -000262a0: 7420 6368 6172 202a 2049 4e2c 2073 697a  t char * IN, siz
│ │ │ │ -000262b0: 655f 7420 494e 4c45 4e2c 2063 6861 7220  e_t INLEN, char 
│ │ │ │ -000262c0: 2a2a 204f 5554 2c20 7369 7a65 5f74 202a  ** OUT, size_t *
│ │ │ │ -000262d0: 204f 5554 4c45 4e29 0a20 2020 2020 4841   OUTLEN).     HA
│ │ │ │ -000262e0: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ -000262f0: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ -00026300: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ -00026310: 6974 2829 e280 992e 0a20 2020 2020 4b45  it().....     KE
│ │ │ │ -00026320: 593a 206b 6579 2074 6f20 656e 6372 7970  Y: key to encryp
│ │ │ │ -00026330: 7420 7769 7468 2e0a 2020 2020 204b 4559  t with..     KEY
│ │ │ │ -00026340: 5553 4147 453a 2069 6e74 6567 6572 2073  USAGE: integer s
│ │ │ │ -00026350: 7065 6369 6679 696e 6720 7768 6174 2074  pecifying what t
│ │ │ │ -00026360: 6869 7320 6b65 7920 6973 2065 6e63 7279  his key is encry
│ │ │ │ -00026370: 7074 696e 672e 0a20 2020 2020 4554 5950  pting..     ETYP
│ │ │ │ -00026380: 453a 2069 6e74 6567 6572 2073 7065 6369  E: integer speci
│ │ │ │ -00026390: 6679 696e 6720 7768 6174 2063 6970 6865  fying what ciphe
│ │ │ │ -000263a0: 7220 746f 2075 7365 2e0a 2020 2020 2049  r to use..     I
│ │ │ │ -000263b0: 4e3a 2069 6e70 7574 2061 7272 6179 2077  N: input array w
│ │ │ │ -000263c0: 6974 6820 6461 7461 2074 6f20 656e 6372  ith data to encr
│ │ │ │ -000263d0: 7970 742e 0a20 2020 2020 494e 4c45 4e3a  ypt..     INLEN:
│ │ │ │ -000263e0: 2073 697a 6520 6f66 2069 6e70 7574 2061   size of input a
│ │ │ │ -000263f0: 7272 6179 2077 6974 6820 6461 7461 2074  rray with data t
│ │ │ │ -00026400: 6f20 656e 6372 7970 742e 0a20 2020 2020  o encrypt..     
│ │ │ │ -00026410: 4f55 543a 206f 7574 7075 7420 6172 7261  OUT: output arra
│ │ │ │ -00026420: 7920 7769 7468 206e 6577 6c79 2061 6c6c  y with newly all
│ │ │ │ -00026430: 6f63 6174 6564 2065 6e63 7279 7074 6564  ocated encrypted
│ │ │ │ -00026440: 2064 6174 612e 0a20 2020 2020 4f55 544c   data..     OUTL
│ │ │ │ -00026450: 454e 3a20 6f75 7470 7574 2076 6172 6961  EN: output varia
│ │ │ │ -00026460: 626c 6520 7769 7468 2073 697a 6520 6f66  ble with size of
│ │ │ │ -00026470: 206e 6577 6c79 2061 6c6c 6f63 6174 6564   newly allocated
│ │ │ │ -00026480: 206f 7574 7075 7420 6172 7261 792e 0a0a   output array...
│ │ │ │ -00026490: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ -000264a0: 6e3a 2a20 456e 6372 7970 7473 2064 6174  n:* Encrypts dat
│ │ │ │ -000264b0: 6120 6173 2070 6572 2065 6e63 7279 7074  a as per encrypt
│ │ │ │ -000264c0: 696f 6e20 6d65 7468 6f64 2075 7369 6e67  ion method using
│ │ │ │ -000264d0: 0a20 2020 2020 7370 6563 6966 6965 6420  .     specified 
│ │ │ │ -000264e0: 696e 6974 6961 6c69 7a61 7469 6f6e 2076  initialization v
│ │ │ │ -000264f0: 6563 746f 7220 616e 6420 6b65 792e 2020  ector and key.  
│ │ │ │ -00026500: 5468 6520 6b65 7920 6163 7475 616c 6c79  The key actually
│ │ │ │ -00026510: 2075 7365 6420 6973 0a20 2020 2020 6465   used is.     de
│ │ │ │ -00026520: 7269 7665 6420 7573 696e 6720 7468 6520  rived using the 
│ │ │ │ -00026530: 6b65 7920 7573 6167 652e 2020 4966 206b  key usage.  If k
│ │ │ │ -00026540: 6579 2075 7361 6765 2069 7320 302c 206e  ey usage is 0, n
│ │ │ │ -00026550: 6f20 6b65 7920 6465 7269 7661 7469 6f6e  o key derivation
│ │ │ │ -00026560: 0a20 2020 2020 6973 2075 7365 642e 2020  .     is used.  
│ │ │ │ -00026570: 5468 6520 4f55 5420 6275 6666 6572 206d  The OUT buffer m
│ │ │ │ -00026580: 7573 7420 6265 2064 6561 6c6c 6f63 6174  ust be deallocat
│ │ │ │ -00026590: 6564 2062 7920 7468 6520 6361 6c6c 6572  ed by the caller
│ │ │ │ -000265a0: 2e20 2054 6865 0a20 2020 2020 6465 6661  .  The.     defa
│ │ │ │ -000265b0: 756c 7420 4956 2069 7320 7573 6564 2c20  ult IV is used, 
│ │ │ │ -000265c0: 7365 6520 7368 6973 6869 5f65 6e63 7279  see shishi_encry
│ │ │ │ -000265d0: 7074 5f69 765f 6574 7970 6520 6966 2079  pt_iv_etype if y
│ │ │ │ -000265e0: 6f75 206e 6565 6420 746f 0a20 2020 2020  ou need to.     
│ │ │ │ -000265f0: 616c 7465 7220 6974 2e20 2054 6865 206e  alter it.  The n
│ │ │ │ -00026600: 6578 7420 4956 2069 7320 6c6f 7374 2c20  ext IV is lost, 
│ │ │ │ -00026610: 7365 6520 7368 6973 6869 5f65 6e63 7279  see shishi_encry
│ │ │ │ -00026620: 7074 5f69 7675 7064 6174 655f 6574 7970  pt_ivupdate_etyp
│ │ │ │ -00026630: 650a 2020 2020 2069 6620 796f 7520 6e65  e.     if you ne
│ │ │ │ -00026640: 6564 2069 742e 0a0a 2020 2020 204e 6f74  ed it...     Not
│ │ │ │ -00026650: 6520 7468 6174 2044 4543 5259 5054 2845  e that DECRYPT(E
│ │ │ │ -00026660: 4e43 5259 5054 2864 6174 6129 2920 646f  NCRYPT(data)) do
│ │ │ │ -00026670: 6573 206e 6f74 206e 6563 6573 7361 7269  es not necessari
│ │ │ │ -00026680: 6c79 2079 6965 6c64 2064 6174 610a 2020  ly yield data.  
│ │ │ │ -00026690: 2020 2065 7861 6374 6c79 2e20 2053 6f6d     exactly.  Som
│ │ │ │ -000266a0: 6520 656e 6372 7970 7469 6f6e 2074 7970  e encryption typ
│ │ │ │ -000266b0: 6573 2061 6464 2070 6164 2074 6f20 6d61  es add pad to ma
│ │ │ │ -000266c0: 6b65 2074 6865 2064 6174 6120 6669 7420  ke the data fit 
│ │ │ │ -000266d0: 696e 746f 0a20 2020 2020 7468 6520 626c  into.     the bl
│ │ │ │ -000266e0: 6f63 6b20 7369 7a65 206f 6620 7468 6520  ock size of the 
│ │ │ │ -000266f0: 656e 6372 7970 7469 6f6e 2061 6c67 6f72  encryption algor
│ │ │ │ -00026700: 6974 686d 2e20 2046 7572 7468 6572 6d6f  ithm.  Furthermo
│ │ │ │ -00026710: 7265 2c20 7468 6520 7061 640a 2020 2020  re, the pad.    
│ │ │ │ -00026720: 2069 7320 6e6f 7420 6775 6172 616e 7465   is not guarante
│ │ │ │ -00026730: 6564 2074 6f20 6c6f 6f6b 2069 6e20 616e  ed to look in an
│ │ │ │ -00026740: 7920 7370 6563 6961 6c20 7761 792c 2061  y special way, a
│ │ │ │ -00026750: 6c74 686f 7567 6820 6578 6973 7469 6e67  lthough existing
│ │ │ │ -00026760: 0a20 2020 2020 696d 706c 656d 656e 7461  .     implementa
│ │ │ │ -00026770: 7469 6f6e 7320 6f66 7465 6e20 7061 6420  tions often pad 
│ │ │ │ -00026780: 7769 7468 2074 6865 207a 6572 6f20 6279  with the zero by
│ │ │ │ -00026790: 7465 2e20 2054 6869 7320 6d65 616e 7320  te.  This means 
│ │ │ │ -000267a0: 7468 6174 2079 6f75 0a20 2020 2020 6d61  that you.     ma
│ │ │ │ -000267b0: 7920 6861 7665 2074 6f20 2266 7261 6d65  y have to "frame
│ │ │ │ -000267c0: 2220 6461 7461 2c20 736f 2069 7420 6973  " data, so it is
│ │ │ │ -000267d0: 2070 6f73 7369 626c 6520 746f 2069 6e66   possible to inf
│ │ │ │ -000267e0: 6572 2074 6865 206f 7269 6769 6e61 6c0a  er the original.
│ │ │ │ -000267f0: 2020 2020 206c 656e 6774 6820 6166 7465       length afte
│ │ │ │ -00026800: 7220 6465 6372 7970 7469 6f6e 2e20 2043  r decryption.  C
│ │ │ │ -00026810: 6f6d 7061 7265 2041 534e 2e31 2044 4552  ompare ASN.1 DER
│ │ │ │ -00026820: 2077 6869 6368 2063 6f6e 7461 696e 7320   which contains 
│ │ │ │ -00026830: 7375 6368 0a20 2020 2020 696e 666f 726d  such.     inform
│ │ │ │ -00026840: 6174 696f 6e2e 0a0a 2020 2020 202a 5265  ation...     *Re
│ │ │ │ -00026850: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ -00026860: 7572 6e73 20e2 8098 5348 4953 4849 5f4f  urns ...SHISHI_O
│ │ │ │ -00026870: 4be2 8099 2069 6666 2073 7563 6365 7373  K... iff success
│ │ │ │ -00026880: 6675 6c2e 0a0a 7368 6973 6869 5f65 6e63  ful...shishi_enc
│ │ │ │ -00026890: 7279 7074 5f69 7675 7064 6174 650a 2d2d  rypt_ivupdate.--
│ │ │ │ +000253a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ +000253b0: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ +000253c0: 2073 6869 7368 695f 656e 6372 7970 745f   shishi_encrypt_
│ │ │ │ +000253d0: 6976 7570 6461 7465 5f65 7479 7065 2028  ivupdate_etype (
│ │ │ │ +000253e0: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ +000253f0: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ +00025400: 695f 6b65 7920 2a20 4b45 592c 2069 6e74  i_key * KEY, int
│ │ │ │ +00025410: 204b 4559 5553 4147 452c 2069 6e74 3332   KEYUSAGE, int32
│ │ │ │ +00025420: 5f74 2045 5459 5045 2c0a 2020 2020 2020  _t ETYPE,.      
│ │ │ │ +00025430: 2020 2020 636f 6e73 7420 6368 6172 202a      const char *
│ │ │ │ +00025440: 2049 562c 2073 697a 655f 7420 4956 4c45   IV, size_t IVLE
│ │ │ │ +00025450: 4e2c 2063 6861 7220 2a2a 2049 564f 5554  N, char ** IVOUT
│ │ │ │ +00025460: 2c0a 2020 2020 2020 2020 2020 7369 7a65  ,.          size
│ │ │ │ +00025470: 5f74 202a 2049 564f 5554 4c45 4e2c 2063  _t * IVOUTLEN, c
│ │ │ │ +00025480: 6f6e 7374 2063 6861 7220 2a20 494e 2c20  onst char * IN, 
│ │ │ │ +00025490: 7369 7a65 5f74 2049 4e4c 454e 2c20 6368  size_t INLEN, ch
│ │ │ │ +000254a0: 6172 202a 2a20 4f55 542c 0a20 2020 2020  ar ** OUT,.     
│ │ │ │ +000254b0: 2020 2020 2073 697a 655f 7420 2a20 4f55       size_t * OU
│ │ │ │ +000254c0: 544c 454e 290a 2020 2020 2048 414e 444c  TLEN).     HANDL
│ │ │ │ +000254d0: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ +000254e0: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ +000254f0: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ +00025500: 29e2 8099 2e0a 2020 2020 204b 4559 3a20  ).....     KEY: 
│ │ │ │ +00025510: 6b65 7920 746f 2065 6e63 7279 7074 2077  key to encrypt w
│ │ │ │ +00025520: 6974 682e 0a20 2020 2020 4b45 5955 5341  ith..     KEYUSA
│ │ │ │ +00025530: 4745 3a20 696e 7465 6765 7220 7370 6563  GE: integer spec
│ │ │ │ +00025540: 6966 7969 6e67 2077 6861 7420 7468 6973  ifying what this
│ │ │ │ +00025550: 206b 6579 2069 7320 656e 6372 7970 7469   key is encrypti
│ │ │ │ +00025560: 6e67 2e0a 2020 2020 2045 5459 5045 3a20  ng..     ETYPE: 
│ │ │ │ +00025570: 696e 7465 6765 7220 7370 6563 6966 7969  integer specifyi
│ │ │ │ +00025580: 6e67 2077 6861 7420 6369 7068 6572 2074  ng what cipher t
│ │ │ │ +00025590: 6f20 7573 652e 0a20 2020 2020 4956 3a20  o use..     IV: 
│ │ │ │ +000255a0: 696e 7075 7420 6172 7261 7920 7769 7468  input array with
│ │ │ │ +000255b0: 2069 6e69 7469 616c 697a 6174 696f 6e20   initialization 
│ │ │ │ +000255c0: 7665 6374 6f72 0a20 2020 2020 4956 4c45  vector.     IVLE
│ │ │ │ +000255d0: 4e3a 2073 697a 6520 6f66 2069 6e70 7574  N: size of input
│ │ │ │ +000255e0: 2061 7272 6179 2077 6974 6820 696e 6974   array with init
│ │ │ │ +000255f0: 6961 6c69 7a61 7469 6f6e 2076 6563 746f  ialization vecto
│ │ │ │ +00025600: 722e 0a20 2020 2020 4956 4f55 543a 206f  r..     IVOUT: o
│ │ │ │ +00025610: 7574 7075 7420 6172 7261 7920 7769 7468  utput array with
│ │ │ │ +00025620: 206e 6577 6c79 2061 6c6c 6f63 6174 6564   newly allocated
│ │ │ │ +00025630: 2075 7064 6174 6564 2069 6e69 7469 616c   updated initial
│ │ │ │ +00025640: 697a 6174 696f 6e0a 2020 2020 2076 6563  ization.     vec
│ │ │ │ +00025650: 746f 722e 0a20 2020 2020 4956 4f55 544c  tor..     IVOUTL
│ │ │ │ +00025660: 454e 3a20 7369 7a65 206f 6620 6f75 7470  EN: size of outp
│ │ │ │ +00025670: 7574 2061 7272 6179 2077 6974 6820 7570  ut array with up
│ │ │ │ +00025680: 6461 7465 6420 696e 6974 6961 6c69 7a61  dated initializa
│ │ │ │ +00025690: 7469 6f6e 2076 6563 746f 722e 0a0a 2020  tion vector...  
│ │ │ │ +000256a0: 2020 2049 4e3a 2069 6e70 7574 2061 7272     IN: input arr
│ │ │ │ +000256b0: 6179 2077 6974 6820 6461 7461 2074 6f20  ay with data to 
│ │ │ │ +000256c0: 656e 6372 7970 742e 0a20 2020 2020 494e  encrypt..     IN
│ │ │ │ +000256d0: 4c45 4e3a 2073 697a 6520 6f66 2069 6e70  LEN: size of inp
│ │ │ │ +000256e0: 7574 2061 7272 6179 2077 6974 6820 6461  ut array with da
│ │ │ │ +000256f0: 7461 2074 6f20 656e 6372 7970 742e 0a20  ta to encrypt.. 
│ │ │ │ +00025700: 2020 2020 4f55 543a 206f 7574 7075 7420      OUT: output 
│ │ │ │ +00025710: 6172 7261 7920 7769 7468 206e 6577 6c79  array with newly
│ │ │ │ +00025720: 2061 6c6c 6f63 6174 6564 2065 6e63 7279   allocated encry
│ │ │ │ +00025730: 7074 6564 2064 6174 612e 0a20 2020 2020  pted data..     
│ │ │ │ +00025740: 4f55 544c 454e 3a20 6f75 7470 7574 2076  OUTLEN: output v
│ │ │ │ +00025750: 6172 6961 626c 6520 7769 7468 2073 697a  ariable with siz
│ │ │ │ +00025760: 6520 6f66 206e 6577 6c79 2061 6c6c 6f63  e of newly alloc
│ │ │ │ +00025770: 6174 6564 206f 7574 7075 7420 6172 7261  ated output arra
│ │ │ │ +00025780: 792e 0a0a 2020 2020 202a 4465 7363 7269  y...     *Descri
│ │ │ │ +00025790: 7074 696f 6e3a 2a20 456e 6372 7970 7473  ption:* Encrypts
│ │ │ │ +000257a0: 2064 6174 6120 6173 2070 6572 2065 6e63   data as per enc
│ │ │ │ +000257b0: 7279 7074 696f 6e20 6d65 7468 6f64 2075  ryption method u
│ │ │ │ +000257c0: 7369 6e67 0a20 2020 2020 7370 6563 6966  sing.     specif
│ │ │ │ +000257d0: 6965 6420 696e 6974 6961 6c69 7a61 7469  ied initializati
│ │ │ │ +000257e0: 6f6e 2076 6563 746f 7220 616e 6420 6b65  on vector and ke
│ │ │ │ +000257f0: 792e 2020 5468 6520 6b65 7920 6163 7475  y.  The key actu
│ │ │ │ +00025800: 616c 6c79 2075 7365 6420 6973 0a20 2020  ally used is.   
│ │ │ │ +00025810: 2020 6465 7269 7665 6420 7573 696e 6720    derived using 
│ │ │ │ +00025820: 7468 6520 6b65 7920 7573 6167 652e 2020  the key usage.  
│ │ │ │ +00025830: 4966 206b 6579 2075 7361 6765 2069 7320  If key usage is 
│ │ │ │ +00025840: 302c 206e 6f20 6b65 7920 6465 7269 7661  0, no key deriva
│ │ │ │ +00025850: 7469 6f6e 0a20 2020 2020 6973 2075 7365  tion.     is use
│ │ │ │ +00025860: 642e 2020 5468 6520 4f55 5420 6275 6666  d.  The OUT buff
│ │ │ │ +00025870: 6572 206d 7573 7420 6265 2064 6561 6c6c  er must be deall
│ │ │ │ +00025880: 6f63 6174 6564 2062 7920 7468 6520 6361  ocated by the ca
│ │ │ │ +00025890: 6c6c 6572 2e20 2049 660a 2020 2020 2049  ller.  If.     I
│ │ │ │ +000258a0: 564f 5554 206f 7220 4956 4f55 544c 454e  VOUT or IVOUTLEN
│ │ │ │ +000258b0: 2069 7320 4e55 4c4c 2c20 7468 6520 7570   is NULL, the up
│ │ │ │ +000258c0: 6461 7465 6420 4956 2069 7320 6e6f 7420  dated IV is not 
│ │ │ │ +000258d0: 7361 7665 6420 616e 7977 6865 7265 2e0a  saved anywhere..
│ │ │ │ +000258e0: 0a20 2020 2020 4e6f 7465 2074 6861 7420  .     Note that 
│ │ │ │ +000258f0: 4445 4352 5950 5428 454e 4352 5950 5428  DECRYPT(ENCRYPT(
│ │ │ │ +00025900: 6461 7461 2929 2064 6f65 7320 6e6f 7420  data)) does not 
│ │ │ │ +00025910: 6e65 6365 7373 6172 696c 7920 7969 656c  necessarily yiel
│ │ │ │ +00025920: 6420 6461 7461 0a20 2020 2020 6578 6163  d data.     exac
│ │ │ │ +00025930: 746c 792e 2020 536f 6d65 2065 6e63 7279  tly.  Some encry
│ │ │ │ +00025940: 7074 696f 6e20 7479 7065 7320 6164 6420  ption types add 
│ │ │ │ +00025950: 7061 6420 746f 206d 616b 6520 7468 6520  pad to make the 
│ │ │ │ +00025960: 6461 7461 2066 6974 2069 6e74 6f0a 2020  data fit into.  
│ │ │ │ +00025970: 2020 2074 6865 2062 6c6f 636b 2073 697a     the block siz
│ │ │ │ +00025980: 6520 6f66 2074 6865 2065 6e63 7279 7074  e of the encrypt
│ │ │ │ +00025990: 696f 6e20 616c 676f 7269 7468 6d2e 2020  ion algorithm.  
│ │ │ │ +000259a0: 4675 7274 6865 726d 6f72 652c 2074 6865  Furthermore, the
│ │ │ │ +000259b0: 2070 6164 0a20 2020 2020 6973 206e 6f74   pad.     is not
│ │ │ │ +000259c0: 2067 7561 7261 6e74 6565 6420 746f 206c   guaranteed to l
│ │ │ │ +000259d0: 6f6f 6b20 696e 2061 6e79 2073 7065 6369  ook in any speci
│ │ │ │ +000259e0: 616c 2077 6179 2c20 616c 7468 6f75 6768  al way, although
│ │ │ │ +000259f0: 2065 7869 7374 696e 670a 2020 2020 2069   existing.     i
│ │ │ │ +00025a00: 6d70 6c65 6d65 6e74 6174 696f 6e73 206f  mplementations o
│ │ │ │ +00025a10: 6674 656e 2070 6164 2077 6974 6820 7468  ften pad with th
│ │ │ │ +00025a20: 6520 7a65 726f 2062 7974 652e 2020 5468  e zero byte.  Th
│ │ │ │ +00025a30: 6973 206d 6561 6e73 2074 6861 7420 796f  is means that yo
│ │ │ │ +00025a40: 750a 2020 2020 206d 6179 2068 6176 6520  u.     may have 
│ │ │ │ +00025a50: 746f 2022 6672 616d 6522 2064 6174 612c  to "frame" data,
│ │ │ │ +00025a60: 2073 6f20 6974 2069 7320 706f 7373 6962   so it is possib
│ │ │ │ +00025a70: 6c65 2074 6f20 696e 6665 7220 7468 6520  le to infer the 
│ │ │ │ +00025a80: 6f72 6967 696e 616c 0a20 2020 2020 6c65  original.     le
│ │ │ │ +00025a90: 6e67 7468 2061 6674 6572 2064 6563 7279  ngth after decry
│ │ │ │ +00025aa0: 7074 696f 6e2e 2020 436f 6d70 6172 6520  ption.  Compare 
│ │ │ │ +00025ab0: 4153 4e2e 3120 4445 5220 7768 6963 6820  ASN.1 DER which 
│ │ │ │ +00025ac0: 636f 6e74 6169 6e73 2073 7563 680a 2020  contains such.  
│ │ │ │ +00025ad0: 2020 2069 6e66 6f72 6d61 7469 6f6e 2e0a     information..
│ │ │ │ +00025ae0: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ +00025af0: 6c75 653a 2a20 5265 7475 726e 7320 e280  lue:* Returns ..
│ │ │ │ +00025b00: 9853 4849 5348 495f 4f4b e280 9920 6966  .SHISHI_OK... if
│ │ │ │ +00025b10: 6620 7375 6363 6573 7366 756c 2e0a 0a73  f successful...s
│ │ │ │ +00025b20: 6869 7368 695f 656e 6372 7970 745f 6976  hishi_encrypt_iv
│ │ │ │ +00025b30: 5f65 7479 7065 0a2d 2d2d 2d2d 2d2d 2d2d  _etype.---------
│ │ │ │ +00025b40: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ +00025b50: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ +00025b60: 7420 7368 6973 6869 5f65 6e63 7279 7074  t shishi_encrypt
│ │ │ │ +00025b70: 5f69 765f 6574 7970 6520 2853 6869 7368  _iv_etype (Shish
│ │ │ │ +00025b80: 6920 2a20 4841 4e44 4c45 2c0a 2020 2020  i * HANDLE,.    
│ │ │ │ +00025b90: 2020 2020 2020 5368 6973 6869 5f6b 6579        Shishi_key
│ │ │ │ +00025ba0: 202a 204b 4559 2c20 696e 7420 4b45 5955   * KEY, int KEYU
│ │ │ │ +00025bb0: 5341 4745 2c20 696e 7433 325f 7420 4554  SAGE, int32_t ET
│ │ │ │ +00025bc0: 5950 452c 0a20 2020 2020 2020 2020 2063  YPE,.          c
│ │ │ │ +00025bd0: 6f6e 7374 2063 6861 7220 2a20 4956 2c20  onst char * IV, 
│ │ │ │ +00025be0: 7369 7a65 5f74 2049 564c 454e 2c20 636f  size_t IVLEN, co
│ │ │ │ +00025bf0: 6e73 7420 6368 6172 202a 2049 4e2c 2073  nst char * IN, s
│ │ │ │ +00025c00: 697a 655f 7420 494e 4c45 4e2c 0a20 2020  ize_t INLEN,.   
│ │ │ │ +00025c10: 2020 2020 2020 2063 6861 7220 2a2a 204f         char ** O
│ │ │ │ +00025c20: 5554 2c20 7369 7a65 5f74 202a 204f 5554  UT, size_t * OUT
│ │ │ │ +00025c30: 4c45 4e29 0a20 2020 2020 4841 4e44 4c45  LEN).     HANDLE
│ │ │ │ +00025c40: 3a20 7368 6973 6869 2068 616e 646c 6520  : shishi handle 
│ │ │ │ +00025c50: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ +00025c60: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ +00025c70: e280 992e 0a20 2020 2020 4b45 593a 206b  .....     KEY: k
│ │ │ │ +00025c80: 6579 2074 6f20 656e 6372 7970 7420 7769  ey to encrypt wi
│ │ │ │ +00025c90: 7468 2e0a 2020 2020 204b 4559 5553 4147  th..     KEYUSAG
│ │ │ │ +00025ca0: 453a 2069 6e74 6567 6572 2073 7065 6369  E: integer speci
│ │ │ │ +00025cb0: 6679 696e 6720 7768 6174 2074 6869 7320  fying what this 
│ │ │ │ +00025cc0: 6b65 7920 6973 2065 6e63 7279 7074 696e  key is encryptin
│ │ │ │ +00025cd0: 672e 0a20 2020 2020 4554 5950 453a 2069  g..     ETYPE: i
│ │ │ │ +00025ce0: 6e74 6567 6572 2073 7065 6369 6679 696e  nteger specifyin
│ │ │ │ +00025cf0: 6720 7768 6174 2063 6970 6865 7220 746f  g what cipher to
│ │ │ │ +00025d00: 2075 7365 2e0a 2020 2020 2049 563a 2069   use..     IV: i
│ │ │ │ +00025d10: 6e70 7574 2061 7272 6179 2077 6974 6820  nput array with 
│ │ │ │ +00025d20: 696e 6974 6961 6c69 7a61 7469 6f6e 2076  initialization v
│ │ │ │ +00025d30: 6563 746f 720a 2020 2020 2049 564c 454e  ector.     IVLEN
│ │ │ │ +00025d40: 3a20 7369 7a65 206f 6620 696e 7075 7420  : size of input 
│ │ │ │ +00025d50: 6172 7261 7920 7769 7468 2069 6e69 7469  array with initi
│ │ │ │ +00025d60: 616c 697a 6174 696f 6e20 7665 6374 6f72  alization vector
│ │ │ │ +00025d70: 2e0a 2020 2020 2049 4e3a 2069 6e70 7574  ..     IN: input
│ │ │ │ +00025d80: 2061 7272 6179 2077 6974 6820 6461 7461   array with data
│ │ │ │ +00025d90: 2074 6f20 656e 6372 7970 742e 0a20 2020   to encrypt..   
│ │ │ │ +00025da0: 2020 494e 4c45 4e3a 2073 697a 6520 6f66    INLEN: size of
│ │ │ │ +00025db0: 2069 6e70 7574 2061 7272 6179 2077 6974   input array wit
│ │ │ │ +00025dc0: 6820 6461 7461 2074 6f20 656e 6372 7970  h data to encryp
│ │ │ │ +00025dd0: 742e 0a20 2020 2020 4f55 543a 206f 7574  t..     OUT: out
│ │ │ │ +00025de0: 7075 7420 6172 7261 7920 7769 7468 206e  put array with n
│ │ │ │ +00025df0: 6577 6c79 2061 6c6c 6f63 6174 6564 2065  ewly allocated e
│ │ │ │ +00025e00: 6e63 7279 7074 6564 2064 6174 612e 0a20  ncrypted data.. 
│ │ │ │ +00025e10: 2020 2020 4f55 544c 454e 3a20 6f75 7470      OUTLEN: outp
│ │ │ │ +00025e20: 7574 2076 6172 6961 626c 6520 7769 7468  ut variable with
│ │ │ │ +00025e30: 2073 697a 6520 6f66 206e 6577 6c79 2061   size of newly a
│ │ │ │ +00025e40: 6c6c 6f63 6174 6564 206f 7574 7075 7420  llocated output 
│ │ │ │ +00025e50: 6172 7261 792e 0a0a 2020 2020 202a 4465  array...     *De
│ │ │ │ +00025e60: 7363 7269 7074 696f 6e3a 2a20 456e 6372  scription:* Encr
│ │ │ │ +00025e70: 7970 7473 2064 6174 6120 6173 2070 6572  ypts data as per
│ │ │ │ +00025e80: 2065 6e63 7279 7074 696f 6e20 6d65 7468   encryption meth
│ │ │ │ +00025e90: 6f64 2075 7369 6e67 0a20 2020 2020 7370  od using.     sp
│ │ │ │ +00025ea0: 6563 6966 6965 6420 696e 6974 6961 6c69  ecified initiali
│ │ │ │ +00025eb0: 7a61 7469 6f6e 2076 6563 746f 7220 616e  zation vector an
│ │ │ │ +00025ec0: 6420 6b65 792e 2020 5468 6520 6b65 7920  d key.  The key 
│ │ │ │ +00025ed0: 6163 7475 616c 6c79 2075 7365 6420 6973  actually used is
│ │ │ │ +00025ee0: 0a20 2020 2020 6465 7269 7665 6420 7573  .     derived us
│ │ │ │ +00025ef0: 696e 6720 7468 6520 6b65 7920 7573 6167  ing the key usag
│ │ │ │ +00025f00: 652e 2020 4966 206b 6579 2075 7361 6765  e.  If key usage
│ │ │ │ +00025f10: 2069 7320 302c 206e 6f20 6b65 7920 6465   is 0, no key de
│ │ │ │ +00025f20: 7269 7661 7469 6f6e 0a20 2020 2020 6973  rivation.     is
│ │ │ │ +00025f30: 2075 7365 642e 2020 5468 6520 4f55 5420   used.  The OUT 
│ │ │ │ +00025f40: 6275 6666 6572 206d 7573 7420 6265 2064  buffer must be d
│ │ │ │ +00025f50: 6561 6c6c 6f63 6174 6564 2062 7920 7468  eallocated by th
│ │ │ │ +00025f60: 6520 6361 6c6c 6572 2e20 2054 6865 0a20  e caller.  The. 
│ │ │ │ +00025f70: 2020 2020 6e65 7874 2049 5620 6973 206c      next IV is l
│ │ │ │ +00025f80: 6f73 742c 2073 6565 2073 6869 7368 695f  ost, see shishi_
│ │ │ │ +00025f90: 656e 6372 7970 745f 6976 7570 6461 7465  encrypt_ivupdate
│ │ │ │ +00025fa0: 5f65 7479 7065 2069 6620 796f 7520 6e65  _etype if you ne
│ │ │ │ +00025fb0: 6564 2069 742e 0a0a 2020 2020 204e 6f74  ed it...     Not
│ │ │ │ +00025fc0: 6520 7468 6174 2044 4543 5259 5054 2845  e that DECRYPT(E
│ │ │ │ +00025fd0: 4e43 5259 5054 2864 6174 6129 2920 646f  NCRYPT(data)) do
│ │ │ │ +00025fe0: 6573 206e 6f74 206e 6563 6573 7361 7269  es not necessari
│ │ │ │ +00025ff0: 6c79 2079 6965 6c64 2064 6174 610a 2020  ly yield data.  
│ │ │ │ +00026000: 2020 2065 7861 6374 6c79 2e20 2053 6f6d     exactly.  Som
│ │ │ │ +00026010: 6520 656e 6372 7970 7469 6f6e 2074 7970  e encryption typ
│ │ │ │ +00026020: 6573 2061 6464 2070 6164 2074 6f20 6d61  es add pad to ma
│ │ │ │ +00026030: 6b65 2074 6865 2064 6174 6120 6669 7420  ke the data fit 
│ │ │ │ +00026040: 696e 746f 0a20 2020 2020 7468 6520 626c  into.     the bl
│ │ │ │ +00026050: 6f63 6b20 7369 7a65 206f 6620 7468 6520  ock size of the 
│ │ │ │ +00026060: 656e 6372 7970 7469 6f6e 2061 6c67 6f72  encryption algor
│ │ │ │ +00026070: 6974 686d 2e20 2046 7572 7468 6572 6d6f  ithm.  Furthermo
│ │ │ │ +00026080: 7265 2c20 7468 6520 7061 640a 2020 2020  re, the pad.    
│ │ │ │ +00026090: 2069 7320 6e6f 7420 6775 6172 616e 7465   is not guarante
│ │ │ │ +000260a0: 6564 2074 6f20 6c6f 6f6b 2069 6e20 616e  ed to look in an
│ │ │ │ +000260b0: 7920 7370 6563 6961 6c20 7761 792c 2061  y special way, a
│ │ │ │ +000260c0: 6c74 686f 7567 6820 6578 6973 7469 6e67  lthough existing
│ │ │ │ +000260d0: 0a20 2020 2020 696d 706c 656d 656e 7461  .     implementa
│ │ │ │ +000260e0: 7469 6f6e 7320 6f66 7465 6e20 7061 6420  tions often pad 
│ │ │ │ +000260f0: 7769 7468 2074 6865 207a 6572 6f20 6279  with the zero by
│ │ │ │ +00026100: 7465 2e20 2054 6869 7320 6d65 616e 7320  te.  This means 
│ │ │ │ +00026110: 7468 6174 2079 6f75 0a20 2020 2020 6d61  that you.     ma
│ │ │ │ +00026120: 7920 6861 7665 2074 6f20 2266 7261 6d65  y have to "frame
│ │ │ │ +00026130: 2220 6461 7461 2c20 736f 2069 7420 6973  " data, so it is
│ │ │ │ +00026140: 2070 6f73 7369 626c 6520 746f 2069 6e66   possible to inf
│ │ │ │ +00026150: 6572 2074 6865 206f 7269 6769 6e61 6c0a  er the original.
│ │ │ │ +00026160: 2020 2020 206c 656e 6774 6820 6166 7465       length afte
│ │ │ │ +00026170: 7220 6465 6372 7970 7469 6f6e 2e20 2043  r decryption.  C
│ │ │ │ +00026180: 6f6d 7061 7265 2041 534e 2e31 2044 4552  ompare ASN.1 DER
│ │ │ │ +00026190: 2077 6869 6368 2063 6f6e 7461 696e 7320   which contains 
│ │ │ │ +000261a0: 7375 6368 0a20 2020 2020 696e 666f 726d  such.     inform
│ │ │ │ +000261b0: 6174 696f 6e2e 0a0a 2020 2020 202a 5265  ation...     *Re
│ │ │ │ +000261c0: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ +000261d0: 7572 6e73 20e2 8098 5348 4953 4849 5f4f  urns ...SHISHI_O
│ │ │ │ +000261e0: 4be2 8099 2069 6666 2073 7563 6365 7373  K... iff success
│ │ │ │ +000261f0: 6675 6c2e 0a0a 7368 6973 6869 5f65 6e63  ful...shishi_enc
│ │ │ │ +00026200: 7279 7074 5f65 7479 7065 0a2d 2d2d 2d2d  rypt_etype.-----
│ │ │ │ +00026210: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +00026220: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ +00026230: 6e74 2073 6869 7368 695f 656e 6372 7970  nt shishi_encryp
│ │ │ │ +00026240: 745f 6574 7970 6520 2853 6869 7368 6920  t_etype (Shishi 
│ │ │ │ +00026250: 2a20 4841 4e44 4c45 2c0a 2020 2020 2020  * HANDLE,.      
│ │ │ │ +00026260: 2020 2020 5368 6973 6869 5f6b 6579 202a      Shishi_key *
│ │ │ │ +00026270: 204b 4559 2c20 696e 7420 4b45 5955 5341   KEY, int KEYUSA
│ │ │ │ +00026280: 4745 2c20 696e 7433 325f 7420 4554 5950  GE, int32_t ETYP
│ │ │ │ +00026290: 452c 0a20 2020 2020 2020 2020 2063 6f6e  E,.          con
│ │ │ │ +000262a0: 7374 2063 6861 7220 2a20 494e 2c20 7369  st char * IN, si
│ │ │ │ +000262b0: 7a65 5f74 2049 4e4c 454e 2c20 6368 6172  ze_t INLEN, char
│ │ │ │ +000262c0: 202a 2a20 4f55 542c 2073 697a 655f 7420   ** OUT, size_t 
│ │ │ │ +000262d0: 2a20 4f55 544c 454e 290a 2020 2020 2048  * OUTLEN).     H
│ │ │ │ +000262e0: 414e 444c 453a 2073 6869 7368 6920 6861  ANDLE: shishi ha
│ │ │ │ +000262f0: 6e64 6c65 2061 7320 616c 6c6f 6361 7465  ndle as allocate
│ │ │ │ +00026300: 6420 6279 20e2 8098 7368 6973 6869 5f69  d by ...shishi_i
│ │ │ │ +00026310: 6e69 7428 29e2 8099 2e0a 2020 2020 204b  nit().....     K
│ │ │ │ +00026320: 4559 3a20 6b65 7920 746f 2065 6e63 7279  EY: key to encry
│ │ │ │ +00026330: 7074 2077 6974 682e 0a20 2020 2020 4b45  pt with..     KE
│ │ │ │ +00026340: 5955 5341 4745 3a20 696e 7465 6765 7220  YUSAGE: integer 
│ │ │ │ +00026350: 7370 6563 6966 7969 6e67 2077 6861 7420  specifying what 
│ │ │ │ +00026360: 7468 6973 206b 6579 2069 7320 656e 6372  this key is encr
│ │ │ │ +00026370: 7970 7469 6e67 2e0a 2020 2020 2045 5459  ypting..     ETY
│ │ │ │ +00026380: 5045 3a20 696e 7465 6765 7220 7370 6563  PE: integer spec
│ │ │ │ +00026390: 6966 7969 6e67 2077 6861 7420 6369 7068  ifying what ciph
│ │ │ │ +000263a0: 6572 2074 6f20 7573 652e 0a20 2020 2020  er to use..     
│ │ │ │ +000263b0: 494e 3a20 696e 7075 7420 6172 7261 7920  IN: input array 
│ │ │ │ +000263c0: 7769 7468 2064 6174 6120 746f 2065 6e63  with data to enc
│ │ │ │ +000263d0: 7279 7074 2e0a 2020 2020 2049 4e4c 454e  rypt..     INLEN
│ │ │ │ +000263e0: 3a20 7369 7a65 206f 6620 696e 7075 7420  : size of input 
│ │ │ │ +000263f0: 6172 7261 7920 7769 7468 2064 6174 6120  array with data 
│ │ │ │ +00026400: 746f 2065 6e63 7279 7074 2e0a 2020 2020  to encrypt..    
│ │ │ │ +00026410: 204f 5554 3a20 6f75 7470 7574 2061 7272   OUT: output arr
│ │ │ │ +00026420: 6179 2077 6974 6820 6e65 776c 7920 616c  ay with newly al
│ │ │ │ +00026430: 6c6f 6361 7465 6420 656e 6372 7970 7465  located encrypte
│ │ │ │ +00026440: 6420 6461 7461 2e0a 2020 2020 204f 5554  d data..     OUT
│ │ │ │ +00026450: 4c45 4e3a 206f 7574 7075 7420 7661 7269  LEN: output vari
│ │ │ │ +00026460: 6162 6c65 2077 6974 6820 7369 7a65 206f  able with size o
│ │ │ │ +00026470: 6620 6e65 776c 7920 616c 6c6f 6361 7465  f newly allocate
│ │ │ │ +00026480: 6420 6f75 7470 7574 2061 7272 6179 2e0a  d output array..
│ │ │ │ +00026490: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +000264a0: 6f6e 3a2a 2045 6e63 7279 7074 7320 6461  on:* Encrypts da
│ │ │ │ +000264b0: 7461 2061 7320 7065 7220 656e 6372 7970  ta as per encryp
│ │ │ │ +000264c0: 7469 6f6e 206d 6574 686f 6420 7573 696e  tion method usin
│ │ │ │ +000264d0: 670a 2020 2020 2073 7065 6369 6669 6564  g.     specified
│ │ │ │ +000264e0: 2069 6e69 7469 616c 697a 6174 696f 6e20   initialization 
│ │ │ │ +000264f0: 7665 6374 6f72 2061 6e64 206b 6579 2e20  vector and key. 
│ │ │ │ +00026500: 2054 6865 206b 6579 2061 6374 7561 6c6c   The key actuall
│ │ │ │ +00026510: 7920 7573 6564 2069 730a 2020 2020 2064  y used is.     d
│ │ │ │ +00026520: 6572 6976 6564 2075 7369 6e67 2074 6865  erived using the
│ │ │ │ +00026530: 206b 6579 2075 7361 6765 2e20 2049 6620   key usage.  If 
│ │ │ │ +00026540: 6b65 7920 7573 6167 6520 6973 2030 2c20  key usage is 0, 
│ │ │ │ +00026550: 6e6f 206b 6579 2064 6572 6976 6174 696f  no key derivatio
│ │ │ │ +00026560: 6e0a 2020 2020 2069 7320 7573 6564 2e20  n.     is used. 
│ │ │ │ +00026570: 2054 6865 204f 5554 2062 7566 6665 7220   The OUT buffer 
│ │ │ │ +00026580: 6d75 7374 2062 6520 6465 616c 6c6f 6361  must be dealloca
│ │ │ │ +00026590: 7465 6420 6279 2074 6865 2063 616c 6c65  ted by the calle
│ │ │ │ +000265a0: 722e 2020 5468 650a 2020 2020 2064 6566  r.  The.     def
│ │ │ │ +000265b0: 6175 6c74 2049 5620 6973 2075 7365 642c  ault IV is used,
│ │ │ │ +000265c0: 2073 6565 2073 6869 7368 695f 656e 6372   see shishi_encr
│ │ │ │ +000265d0: 7970 745f 6976 5f65 7479 7065 2069 6620  ypt_iv_etype if 
│ │ │ │ +000265e0: 796f 7520 6e65 6564 2074 6f0a 2020 2020  you need to.    
│ │ │ │ +000265f0: 2061 6c74 6572 2069 742e 2020 5468 6520   alter it.  The 
│ │ │ │ +00026600: 6e65 7874 2049 5620 6973 206c 6f73 742c  next IV is lost,
│ │ │ │ +00026610: 2073 6565 2073 6869 7368 695f 656e 6372   see shishi_encr
│ │ │ │ +00026620: 7970 745f 6976 7570 6461 7465 5f65 7479  ypt_ivupdate_ety
│ │ │ │ +00026630: 7065 0a20 2020 2020 6966 2079 6f75 206e  pe.     if you n
│ │ │ │ +00026640: 6565 6420 6974 2e0a 0a20 2020 2020 4e6f  eed it...     No
│ │ │ │ +00026650: 7465 2074 6861 7420 4445 4352 5950 5428  te that DECRYPT(
│ │ │ │ +00026660: 454e 4352 5950 5428 6461 7461 2929 2064  ENCRYPT(data)) d
│ │ │ │ +00026670: 6f65 7320 6e6f 7420 6e65 6365 7373 6172  oes not necessar
│ │ │ │ +00026680: 696c 7920 7969 656c 6420 6461 7461 0a20  ily yield data. 
│ │ │ │ +00026690: 2020 2020 6578 6163 746c 792e 2020 536f      exactly.  So
│ │ │ │ +000266a0: 6d65 2065 6e63 7279 7074 696f 6e20 7479  me encryption ty
│ │ │ │ +000266b0: 7065 7320 6164 6420 7061 6420 746f 206d  pes add pad to m
│ │ │ │ +000266c0: 616b 6520 7468 6520 6461 7461 2066 6974  ake the data fit
│ │ │ │ +000266d0: 2069 6e74 6f0a 2020 2020 2074 6865 2062   into.     the b
│ │ │ │ +000266e0: 6c6f 636b 2073 697a 6520 6f66 2074 6865  lock size of the
│ │ │ │ +000266f0: 2065 6e63 7279 7074 696f 6e20 616c 676f   encryption algo
│ │ │ │ +00026700: 7269 7468 6d2e 2020 4675 7274 6865 726d  rithm.  Furtherm
│ │ │ │ +00026710: 6f72 652c 2074 6865 2070 6164 0a20 2020  ore, the pad.   
│ │ │ │ +00026720: 2020 6973 206e 6f74 2067 7561 7261 6e74    is not guarant
│ │ │ │ +00026730: 6565 6420 746f 206c 6f6f 6b20 696e 2061  eed to look in a
│ │ │ │ +00026740: 6e79 2073 7065 6369 616c 2077 6179 2c20  ny special way, 
│ │ │ │ +00026750: 616c 7468 6f75 6768 2065 7869 7374 696e  although existin
│ │ │ │ +00026760: 670a 2020 2020 2069 6d70 6c65 6d65 6e74  g.     implement
│ │ │ │ +00026770: 6174 696f 6e73 206f 6674 656e 2070 6164  ations often pad
│ │ │ │ +00026780: 2077 6974 6820 7468 6520 7a65 726f 2062   with the zero b
│ │ │ │ +00026790: 7974 652e 2020 5468 6973 206d 6561 6e73  yte.  This means
│ │ │ │ +000267a0: 2074 6861 7420 796f 750a 2020 2020 206d   that you.     m
│ │ │ │ +000267b0: 6179 2068 6176 6520 746f 2022 6672 616d  ay have to "fram
│ │ │ │ +000267c0: 6522 2064 6174 612c 2073 6f20 6974 2069  e" data, so it i
│ │ │ │ +000267d0: 7320 706f 7373 6962 6c65 2074 6f20 696e  s possible to in
│ │ │ │ +000267e0: 6665 7220 7468 6520 6f72 6967 696e 616c  fer the original
│ │ │ │ +000267f0: 0a20 2020 2020 6c65 6e67 7468 2061 6674  .     length aft
│ │ │ │ +00026800: 6572 2064 6563 7279 7074 696f 6e2e 2020  er decryption.  
│ │ │ │ +00026810: 436f 6d70 6172 6520 4153 4e2e 3120 4445  Compare ASN.1 DE
│ │ │ │ +00026820: 5220 7768 6963 6820 636f 6e74 6169 6e73  R which contains
│ │ │ │ +00026830: 2073 7563 680a 2020 2020 2069 6e66 6f72   such.     infor
│ │ │ │ +00026840: 6d61 7469 6f6e 2e0a 0a20 2020 2020 2a52  mation...     *R
│ │ │ │ +00026850: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +00026860: 7475 726e 7320 e280 9853 4849 5348 495f  turns ...SHISHI_
│ │ │ │ +00026870: 4f4b e280 9920 6966 6620 7375 6363 6573  OK... iff succes
│ │ │ │ +00026880: 7366 756c 2e0a 0a73 6869 7368 695f 656e  sful...shishi_en
│ │ │ │ +00026890: 6372 7970 745f 6976 7570 6461 7465 0a2d  crypt_ivupdate.-
│ │ │ │  000268a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000268b0: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ -000268c0: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ -000268d0: 656e 6372 7970 745f 6976 7570 6461 7465  encrypt_ivupdate
│ │ │ │ -000268e0: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ -000268f0: 452c 0a20 2020 2020 2020 2020 2053 6869  E,.          Shi
│ │ │ │ -00026900: 7368 695f 6b65 7920 2a20 4b45 592c 2069  shi_key * KEY, i
│ │ │ │ -00026910: 6e74 204b 4559 5553 4147 452c 2063 6f6e  nt KEYUSAGE, con
│ │ │ │ -00026920: 7374 2063 6861 7220 2a20 4956 2c20 7369  st char * IV, si
│ │ │ │ -00026930: 7a65 5f74 2049 564c 454e 2c0a 2020 2020  ze_t IVLEN,.    
│ │ │ │ -00026940: 2020 2020 2020 6368 6172 202a 2a20 4956        char ** IV
│ │ │ │ -00026950: 4f55 542c 2073 697a 655f 7420 2a20 4956  OUT, size_t * IV
│ │ │ │ -00026960: 4f55 544c 454e 2c20 636f 6e73 7420 6368  OUTLEN, const ch
│ │ │ │ -00026970: 6172 202a 2049 4e2c 0a20 2020 2020 2020  ar * IN,.       
│ │ │ │ -00026980: 2020 2073 697a 655f 7420 494e 4c45 4e2c     size_t INLEN,
│ │ │ │ -00026990: 2063 6861 7220 2a2a 204f 5554 2c20 7369   char ** OUT, si
│ │ │ │ -000269a0: 7a65 5f74 202a 204f 5554 4c45 4e29 0a20  ze_t * OUTLEN). 
│ │ │ │ -000269b0: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ -000269c0: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ -000269d0: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ -000269e0: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ -000269f0: 2020 2020 4b45 593a 206b 6579 2074 6f20      KEY: key to 
│ │ │ │ -00026a00: 656e 6372 7970 7420 7769 7468 2e0a 2020  encrypt with..  
│ │ │ │ -00026a10: 2020 204b 4559 5553 4147 453a 2069 6e74     KEYUSAGE: int
│ │ │ │ -00026a20: 6567 6572 2073 7065 6369 6679 696e 6720  eger specifying 
│ │ │ │ -00026a30: 7768 6174 2074 6869 7320 6b65 7920 6973  what this key is
│ │ │ │ -00026a40: 2065 6e63 7279 7074 696e 672e 0a20 2020   encrypting..   
│ │ │ │ -00026a50: 2020 4956 3a20 696e 7075 7420 6172 7261    IV: input arra
│ │ │ │ -00026a60: 7920 7769 7468 2069 6e69 7469 616c 697a  y with initializ
│ │ │ │ -00026a70: 6174 696f 6e20 7665 6374 6f72 0a20 2020  ation vector.   
│ │ │ │ -00026a80: 2020 4956 4c45 4e3a 2073 697a 6520 6f66    IVLEN: size of
│ │ │ │ -00026a90: 2069 6e70 7574 2061 7272 6179 2077 6974   input array wit
│ │ │ │ -00026aa0: 6820 696e 6974 6961 6c69 7a61 7469 6f6e  h initialization
│ │ │ │ -00026ab0: 2076 6563 746f 722e 0a20 2020 2020 4956   vector..     IV
│ │ │ │ -00026ac0: 4f55 543a 206f 7574 7075 7420 6172 7261  OUT: output arra
│ │ │ │ -00026ad0: 7920 7769 7468 206e 6577 6c79 2061 6c6c  y with newly all
│ │ │ │ -00026ae0: 6f63 6174 6564 2075 7064 6174 6564 2069  ocated updated i
│ │ │ │ -00026af0: 6e69 7469 616c 697a 6174 696f 6e0a 2020  nitialization.  
│ │ │ │ -00026b00: 2020 2076 6563 746f 722e 0a20 2020 2020     vector..     
│ │ │ │ -00026b10: 4956 4f55 544c 454e 3a20 7369 7a65 206f  IVOUTLEN: size o
│ │ │ │ -00026b20: 6620 6f75 7470 7574 2061 7272 6179 2077  f output array w
│ │ │ │ -00026b30: 6974 6820 7570 6461 7465 6420 696e 6974  ith updated init
│ │ │ │ -00026b40: 6961 6c69 7a61 7469 6f6e 2076 6563 746f  ialization vecto
│ │ │ │ -00026b50: 722e 0a0a 2020 2020 2049 4e3a 2069 6e70  r...     IN: inp
│ │ │ │ -00026b60: 7574 2061 7272 6179 2077 6974 6820 6461  ut array with da
│ │ │ │ -00026b70: 7461 2074 6f20 656e 6372 7970 742e 0a20  ta to encrypt.. 
│ │ │ │ -00026b80: 2020 2020 494e 4c45 4e3a 2073 697a 6520      INLEN: size 
│ │ │ │ -00026b90: 6f66 2069 6e70 7574 2061 7272 6179 2077  of input array w
│ │ │ │ -00026ba0: 6974 6820 6461 7461 2074 6f20 656e 6372  ith data to encr
│ │ │ │ -00026bb0: 7970 742e 0a20 2020 2020 4f55 543a 206f  ypt..     OUT: o
│ │ │ │ -00026bc0: 7574 7075 7420 6172 7261 7920 7769 7468  utput array with
│ │ │ │ -00026bd0: 206e 6577 6c79 2061 6c6c 6f63 6174 6564   newly allocated
│ │ │ │ -00026be0: 2065 6e63 7279 7074 6564 2064 6174 612e   encrypted data.
│ │ │ │ -00026bf0: 0a20 2020 2020 4f55 544c 454e 3a20 6f75  .     OUTLEN: ou
│ │ │ │ -00026c00: 7470 7574 2076 6172 6961 626c 6520 7769  tput variable wi
│ │ │ │ -00026c10: 7468 2073 697a 6520 6f66 206e 6577 6c79  th size of newly
│ │ │ │ -00026c20: 2061 6c6c 6f63 6174 6564 206f 7574 7075   allocated outpu
│ │ │ │ -00026c30: 7420 6172 7261 792e 0a0a 2020 2020 202a  t array...     *
│ │ │ │ -00026c40: 4465 7363 7269 7074 696f 6e3a 2a20 456e  Description:* En
│ │ │ │ -00026c50: 6372 7970 7473 2064 6174 6120 7573 696e  crypts data usin
│ │ │ │ -00026c60: 6720 7370 6563 6966 6965 6420 696e 6974  g specified init
│ │ │ │ -00026c70: 6961 6c69 7a61 7469 6f6e 2076 6563 746f  ialization vecto
│ │ │ │ -00026c80: 720a 2020 2020 2061 6e64 206b 6579 2e20  r.     and key. 
│ │ │ │ -00026c90: 2054 6865 206b 6579 2061 6374 7561 6c6c   The key actuall
│ │ │ │ -00026ca0: 7920 7573 6564 2069 7320 6465 7269 7665  y used is derive
│ │ │ │ -00026cb0: 6420 7573 696e 6720 7468 6520 6b65 7920  d using the key 
│ │ │ │ -00026cc0: 7573 6167 652e 2020 4966 0a20 2020 2020  usage.  If.     
│ │ │ │ -00026cd0: 6b65 7920 7573 6167 6520 6973 2030 2c20  key usage is 0, 
│ │ │ │ -00026ce0: 6e6f 206b 6579 2064 6572 6976 6174 696f  no key derivatio
│ │ │ │ -00026cf0: 6e20 6973 2075 7365 642e 2020 5468 6520  n is used.  The 
│ │ │ │ -00026d00: 4f55 5420 6275 6666 6572 206d 7573 7420  OUT buffer must 
│ │ │ │ -00026d10: 6265 0a20 2020 2020 6465 616c 6c6f 6361  be.     dealloca
│ │ │ │ -00026d20: 7465 6420 6279 2074 6865 2063 616c 6c65  ted by the calle
│ │ │ │ -00026d30: 722e 2020 4966 2049 564f 5554 206f 7220  r.  If IVOUT or 
│ │ │ │ -00026d40: 4956 4f55 544c 454e 2069 7320 4e55 4c4c  IVOUTLEN is NULL
│ │ │ │ -00026d50: 2c20 7468 650a 2020 2020 2075 7064 6174  , the.     updat
│ │ │ │ -00026d60: 6564 2049 5620 6973 206e 6f74 2073 6176  ed IV is not sav
│ │ │ │ -00026d70: 6564 2061 6e79 7768 6572 652e 0a0a 2020  ed anywhere...  
│ │ │ │ -00026d80: 2020 204e 6f74 6520 7468 6174 2044 4543     Note that DEC
│ │ │ │ -00026d90: 5259 5054 2845 4e43 5259 5054 2864 6174  RYPT(ENCRYPT(dat
│ │ │ │ -00026da0: 6129 2920 646f 6573 206e 6f74 206e 6563  a)) does not nec
│ │ │ │ -00026db0: 6573 7361 7269 6c79 2079 6965 6c64 2064  essarily yield d
│ │ │ │ -00026dc0: 6174 610a 2020 2020 2065 7861 6374 6c79  ata.     exactly
│ │ │ │ -00026dd0: 2e20 2053 6f6d 6520 656e 6372 7970 7469  .  Some encrypti
│ │ │ │ -00026de0: 6f6e 2074 7970 6573 2061 6464 2070 6164  on types add pad
│ │ │ │ -00026df0: 2074 6f20 6d61 6b65 2074 6865 2064 6174   to make the dat
│ │ │ │ -00026e00: 6120 6669 7420 696e 746f 0a20 2020 2020  a fit into.     
│ │ │ │ -00026e10: 7468 6520 626c 6f63 6b20 7369 7a65 206f  the block size o
│ │ │ │ -00026e20: 6620 7468 6520 656e 6372 7970 7469 6f6e  f the encryption
│ │ │ │ -00026e30: 2061 6c67 6f72 6974 686d 2e20 2046 7572   algorithm.  Fur
│ │ │ │ -00026e40: 7468 6572 6d6f 7265 2c20 7468 6520 7061  thermore, the pa
│ │ │ │ -00026e50: 640a 2020 2020 2069 7320 6e6f 7420 6775  d.     is not gu
│ │ │ │ -00026e60: 6172 616e 7465 6564 2074 6f20 6c6f 6f6b  aranteed to look
│ │ │ │ -00026e70: 2069 6e20 616e 7920 7370 6563 6961 6c20   in any special 
│ │ │ │ -00026e80: 7761 792c 2061 6c74 686f 7567 6820 6578  way, although ex
│ │ │ │ -00026e90: 6973 7469 6e67 0a20 2020 2020 696d 706c  isting.     impl
│ │ │ │ -00026ea0: 656d 656e 7461 7469 6f6e 7320 6f66 7465  ementations ofte
│ │ │ │ -00026eb0: 6e20 7061 6420 7769 7468 2074 6865 207a  n pad with the z
│ │ │ │ -00026ec0: 6572 6f20 6279 7465 2e20 2054 6869 7320  ero byte.  This 
│ │ │ │ -00026ed0: 6d65 616e 7320 7468 6174 2079 6f75 0a20  means that you. 
│ │ │ │ -00026ee0: 2020 2020 6d61 7920 6861 7665 2074 6f20      may have to 
│ │ │ │ -00026ef0: 2266 7261 6d65 2220 6461 7461 2c20 736f  "frame" data, so
│ │ │ │ -00026f00: 2069 7420 6973 2070 6f73 7369 626c 6520   it is possible 
│ │ │ │ -00026f10: 746f 2069 6e66 6572 2074 6865 206f 7269  to infer the ori
│ │ │ │ -00026f20: 6769 6e61 6c0a 2020 2020 206c 656e 6774  ginal.     lengt
│ │ │ │ -00026f30: 6820 6166 7465 7220 6465 6372 7970 7469  h after decrypti
│ │ │ │ -00026f40: 6f6e 2e20 2043 6f6d 7061 7265 2041 534e  on.  Compare ASN
│ │ │ │ -00026f50: 2e31 2044 4552 2077 6869 6368 2063 6f6e  .1 DER which con
│ │ │ │ -00026f60: 7461 696e 7320 7375 6368 0a20 2020 2020  tains such.     
│ │ │ │ -00026f70: 696e 666f 726d 6174 696f 6e2e 0a0a 2020  information...  
│ │ │ │ -00026f80: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ -00026f90: 3a2a 2052 6574 7572 6e73 20e2 8098 5348  :* Returns ...SH
│ │ │ │ -00026fa0: 4953 4849 5f4f 4be2 8099 2069 6666 2073  ISHI_OK... iff s
│ │ │ │ -00026fb0: 7563 6365 7373 6675 6c2e 0a0a 7368 6973  uccessful...shis
│ │ │ │ -00026fc0: 6869 5f65 6e63 7279 7074 5f69 760a 2d2d  hi_encrypt_iv.--
│ │ │ │ -00026fd0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -00026fe0: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ -00026ff0: 6e74 2073 6869 7368 695f 656e 6372 7970  nt shishi_encryp
│ │ │ │ -00027000: 745f 6976 2028 5368 6973 6869 202a 2048  t_iv (Shishi * H
│ │ │ │ -00027010: 414e 444c 452c 2053 6869 7368 695f 6b65  ANDLE, Shishi_ke
│ │ │ │ -00027020: 7920 2a20 4b45 592c 0a20 2020 2020 2020  y * KEY,.       
│ │ │ │ -00027030: 2020 2069 6e74 204b 4559 5553 4147 452c     int KEYUSAGE,
│ │ │ │ -00027040: 2063 6f6e 7374 2063 6861 7220 2a20 4956   const char * IV
│ │ │ │ -00027050: 2c20 7369 7a65 5f74 2049 564c 454e 2c20  , size_t IVLEN, 
│ │ │ │ -00027060: 636f 6e73 7420 6368 6172 202a 2049 4e2c  const char * IN,
│ │ │ │ -00027070: 0a20 2020 2020 2020 2020 2073 697a 655f  .          size_
│ │ │ │ -00027080: 7420 494e 4c45 4e2c 2063 6861 7220 2a2a  t INLEN, char **
│ │ │ │ -00027090: 204f 5554 2c20 7369 7a65 5f74 202a 204f   OUT, size_t * O
│ │ │ │ -000270a0: 5554 4c45 4e29 0a20 2020 2020 4841 4e44  UTLEN).     HAND
│ │ │ │ -000270b0: 4c45 3a20 7368 6973 6869 2068 616e 646c  LE: shishi handl
│ │ │ │ -000270c0: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ -000270d0: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ -000270e0: 2829 e280 992e 0a20 2020 2020 4b45 593a  ().....     KEY:
│ │ │ │ -000270f0: 206b 6579 2074 6f20 656e 6372 7970 7420   key to encrypt 
│ │ │ │ -00027100: 7769 7468 2e0a 2020 2020 204b 4559 5553  with..     KEYUS
│ │ │ │ -00027110: 4147 453a 2069 6e74 6567 6572 2073 7065  AGE: integer spe
│ │ │ │ -00027120: 6369 6679 696e 6720 7768 6174 2074 6869  cifying what thi
│ │ │ │ -00027130: 7320 6b65 7920 6973 2065 6e63 7279 7074  s key is encrypt
│ │ │ │ -00027140: 696e 672e 0a20 2020 2020 4956 3a20 696e  ing..     IV: in
│ │ │ │ -00027150: 7075 7420 6172 7261 7920 7769 7468 2069  put array with i
│ │ │ │ -00027160: 6e69 7469 616c 697a 6174 696f 6e20 7665  nitialization ve
│ │ │ │ -00027170: 6374 6f72 0a20 2020 2020 4956 4c45 4e3a  ctor.     IVLEN:
│ │ │ │ -00027180: 2073 697a 6520 6f66 2069 6e70 7574 2061   size of input a
│ │ │ │ -00027190: 7272 6179 2077 6974 6820 696e 6974 6961  rray with initia
│ │ │ │ -000271a0: 6c69 7a61 7469 6f6e 2076 6563 746f 722e  lization vector.
│ │ │ │ -000271b0: 0a20 2020 2020 494e 3a20 696e 7075 7420  .     IN: input 
│ │ │ │ -000271c0: 6172 7261 7920 7769 7468 2064 6174 6120  array with data 
│ │ │ │ -000271d0: 746f 2065 6e63 7279 7074 2e0a 2020 2020  to encrypt..    
│ │ │ │ -000271e0: 2049 4e4c 454e 3a20 7369 7a65 206f 6620   INLEN: size of 
│ │ │ │ -000271f0: 696e 7075 7420 6172 7261 7920 7769 7468  input array with
│ │ │ │ -00027200: 2064 6174 6120 746f 2065 6e63 7279 7074   data to encrypt
│ │ │ │ -00027210: 2e0a 2020 2020 204f 5554 3a20 6f75 7470  ..     OUT: outp
│ │ │ │ -00027220: 7574 2061 7272 6179 2077 6974 6820 6e65  ut array with ne
│ │ │ │ -00027230: 776c 7920 616c 6c6f 6361 7465 6420 656e  wly allocated en
│ │ │ │ -00027240: 6372 7970 7465 6420 6461 7461 2e0a 2020  crypted data..  
│ │ │ │ -00027250: 2020 204f 5554 4c45 4e3a 206f 7574 7075     OUTLEN: outpu
│ │ │ │ -00027260: 7420 7661 7269 6162 6c65 2077 6974 6820  t variable with 
│ │ │ │ -00027270: 7369 7a65 206f 6620 6e65 776c 7920 616c  size of newly al
│ │ │ │ -00027280: 6c6f 6361 7465 6420 6f75 7470 7574 2061  located output a
│ │ │ │ -00027290: 7272 6179 2e0a 0a20 2020 2020 2a44 6573  rray...     *Des
│ │ │ │ -000272a0: 6372 6970 7469 6f6e 3a2a 2045 6e63 7279  cription:* Encry
│ │ │ │ -000272b0: 7074 7320 6461 7461 2075 7369 6e67 2073  pts data using s
│ │ │ │ -000272c0: 7065 6369 6669 6564 2069 6e69 7469 616c  pecified initial
│ │ │ │ -000272d0: 697a 6174 696f 6e20 7665 6374 6f72 0a20  ization vector. 
│ │ │ │ -000272e0: 2020 2020 616e 6420 6b65 792e 2020 5468      and key.  Th
│ │ │ │ -000272f0: 6520 6b65 7920 6163 7475 616c 6c79 2075  e key actually u
│ │ │ │ -00027300: 7365 6420 6973 2064 6572 6976 6564 2075  sed is derived u
│ │ │ │ -00027310: 7369 6e67 2074 6865 206b 6579 2075 7361  sing the key usa
│ │ │ │ -00027320: 6765 2e20 2049 660a 2020 2020 206b 6579  ge.  If.     key
│ │ │ │ -00027330: 2075 7361 6765 2069 7320 302c 206e 6f20   usage is 0, no 
│ │ │ │ -00027340: 6b65 7920 6465 7269 7661 7469 6f6e 2069  key derivation i
│ │ │ │ -00027350: 7320 7573 6564 2e20 2054 6865 204f 5554  s used.  The OUT
│ │ │ │ -00027360: 2062 7566 6665 7220 6d75 7374 2062 650a   buffer must be.
│ │ │ │ -00027370: 2020 2020 2064 6561 6c6c 6f63 6174 6564       deallocated
│ │ │ │ -00027380: 2062 7920 7468 6520 6361 6c6c 6572 2e20   by the caller. 
│ │ │ │ -00027390: 2054 6865 206e 6578 7420 4956 2069 7320   The next IV is 
│ │ │ │ -000273a0: 6c6f 7374 2c20 7365 650a 2020 2020 2073  lost, see.     s
│ │ │ │ -000273b0: 6869 7368 695f 656e 6372 7970 745f 6976  hishi_encrypt_iv
│ │ │ │ -000273c0: 7570 6461 7465 2069 6620 796f 7520 6e65  update if you ne
│ │ │ │ -000273d0: 6564 2069 742e 0a0a 2020 2020 204e 6f74  ed it...     Not
│ │ │ │ -000273e0: 6520 7468 6174 2044 4543 5259 5054 2845  e that DECRYPT(E
│ │ │ │ -000273f0: 4e43 5259 5054 2864 6174 6129 2920 646f  NCRYPT(data)) do
│ │ │ │ -00027400: 6573 206e 6f74 206e 6563 6573 7361 7269  es not necessari
│ │ │ │ -00027410: 6c79 2079 6965 6c64 2064 6174 610a 2020  ly yield data.  
│ │ │ │ -00027420: 2020 2065 7861 6374 6c79 2e20 2053 6f6d     exactly.  Som
│ │ │ │ -00027430: 6520 656e 6372 7970 7469 6f6e 2074 7970  e encryption typ
│ │ │ │ -00027440: 6573 2061 6464 2070 6164 2074 6f20 6d61  es add pad to ma
│ │ │ │ -00027450: 6b65 2074 6865 2064 6174 6120 6669 7420  ke the data fit 
│ │ │ │ -00027460: 696e 746f 0a20 2020 2020 7468 6520 626c  into.     the bl
│ │ │ │ -00027470: 6f63 6b20 7369 7a65 206f 6620 7468 6520  ock size of the 
│ │ │ │ -00027480: 656e 6372 7970 7469 6f6e 2061 6c67 6f72  encryption algor
│ │ │ │ -00027490: 6974 686d 2e20 2046 7572 7468 6572 6d6f  ithm.  Furthermo
│ │ │ │ -000274a0: 7265 2c20 7468 6520 7061 640a 2020 2020  re, the pad.    
│ │ │ │ -000274b0: 2069 7320 6e6f 7420 6775 6172 616e 7465   is not guarante
│ │ │ │ -000274c0: 6564 2074 6f20 6c6f 6f6b 2069 6e20 616e  ed to look in an
│ │ │ │ -000274d0: 7920 7370 6563 6961 6c20 7761 792c 2061  y special way, a
│ │ │ │ -000274e0: 6c74 686f 7567 6820 6578 6973 7469 6e67  lthough existing
│ │ │ │ -000274f0: 0a20 2020 2020 696d 706c 656d 656e 7461  .     implementa
│ │ │ │ -00027500: 7469 6f6e 7320 6f66 7465 6e20 7061 6420  tions often pad 
│ │ │ │ -00027510: 7769 7468 2074 6865 207a 6572 6f20 6279  with the zero by
│ │ │ │ -00027520: 7465 2e20 2054 6869 7320 6d65 616e 7320  te.  This means 
│ │ │ │ -00027530: 7468 6174 2079 6f75 0a20 2020 2020 6d61  that you.     ma
│ │ │ │ -00027540: 7920 6861 7665 2074 6f20 2266 7261 6d65  y have to "frame
│ │ │ │ -00027550: 2220 6461 7461 2c20 736f 2069 7420 6973  " data, so it is
│ │ │ │ -00027560: 2070 6f73 7369 626c 6520 746f 2069 6e66   possible to inf
│ │ │ │ -00027570: 6572 2074 6865 206f 7269 6769 6e61 6c0a  er the original.
│ │ │ │ -00027580: 2020 2020 206c 656e 6774 6820 6166 7465       length afte
│ │ │ │ -00027590: 7220 6465 6372 7970 7469 6f6e 2e20 2043  r decryption.  C
│ │ │ │ -000275a0: 6f6d 7061 7265 2041 534e 2e31 2044 4552  ompare ASN.1 DER
│ │ │ │ -000275b0: 2077 6869 6368 2063 6f6e 7461 696e 7320   which contains 
│ │ │ │ -000275c0: 7375 6368 0a20 2020 2020 696e 666f 726d  such.     inform
│ │ │ │ -000275d0: 6174 696f 6e2e 0a0a 2020 2020 202a 5265  ation...     *Re
│ │ │ │ -000275e0: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ -000275f0: 7572 6e73 20e2 8098 5348 4953 4849 5f4f  urns ...SHISHI_O
│ │ │ │ -00027600: 4be2 8099 2069 6666 2073 7563 6365 7373  K... iff success
│ │ │ │ -00027610: 6675 6c2e 0a0a 7368 6973 6869 5f65 6e63  ful...shishi_enc
│ │ │ │ -00027620: 7279 7074 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  rypt.-----------
│ │ │ │ -00027630: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ -00027640: 6e3a 2069 6e74 2073 6869 7368 695f 656e  n: int shishi_en
│ │ │ │ -00027650: 6372 7970 7420 2853 6869 7368 6920 2a20  crypt (Shishi * 
│ │ │ │ -00027660: 4841 4e44 4c45 2c20 5368 6973 6869 5f6b  HANDLE, Shishi_k
│ │ │ │ -00027670: 6579 202a 204b 4559 2c0a 2020 2020 2020  ey * KEY,.      
│ │ │ │ -00027680: 2020 2020 696e 7420 4b45 5955 5341 4745      int KEYUSAGE
│ │ │ │ -00027690: 2c20 6368 6172 202a 2049 4e2c 2073 697a  , char * IN, siz
│ │ │ │ -000276a0: 655f 7420 494e 4c45 4e2c 2063 6861 7220  e_t INLEN, char 
│ │ │ │ -000276b0: 2a2a 204f 5554 2c0a 2020 2020 2020 2020  ** OUT,.        
│ │ │ │ -000276c0: 2020 7369 7a65 5f74 202a 204f 5554 4c45    size_t * OUTLE
│ │ │ │ -000276d0: 4e29 0a20 2020 2020 4841 4e44 4c45 3a20  N).     HANDLE: 
│ │ │ │ -000276e0: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ -000276f0: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ -00027700: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ -00027710: 992e 0a20 2020 2020 4b45 593a 206b 6579  ...     KEY: key
│ │ │ │ -00027720: 2074 6f20 656e 6372 7970 7420 7769 7468   to encrypt with
│ │ │ │ -00027730: 2e0a 2020 2020 204b 4559 5553 4147 453a  ..     KEYUSAGE:
│ │ │ │ -00027740: 2069 6e74 6567 6572 2073 7065 6369 6679   integer specify
│ │ │ │ -00027750: 696e 6720 7768 6174 2074 6869 7320 6b65  ing what this ke
│ │ │ │ -00027760: 7920 6973 2065 6e63 7279 7074 696e 672e  y is encrypting.
│ │ │ │ -00027770: 0a20 2020 2020 494e 3a20 696e 7075 7420  .     IN: input 
│ │ │ │ -00027780: 6172 7261 7920 7769 7468 2064 6174 6120  array with data 
│ │ │ │ -00027790: 746f 2065 6e63 7279 7074 2e0a 2020 2020  to encrypt..    
│ │ │ │ -000277a0: 2049 4e4c 454e 3a20 7369 7a65 206f 6620   INLEN: size of 
│ │ │ │ -000277b0: 696e 7075 7420 6172 7261 7920 7769 7468  input array with
│ │ │ │ -000277c0: 2064 6174 6120 746f 2065 6e63 7279 7074   data to encrypt
│ │ │ │ -000277d0: 2e0a 2020 2020 204f 5554 3a20 6f75 7470  ..     OUT: outp
│ │ │ │ -000277e0: 7574 2061 7272 6179 2077 6974 6820 6e65  ut array with ne
│ │ │ │ -000277f0: 776c 7920 616c 6c6f 6361 7465 6420 656e  wly allocated en
│ │ │ │ -00027800: 6372 7970 7465 6420 6461 7461 2e0a 2020  crypted data..  
│ │ │ │ -00027810: 2020 204f 5554 4c45 4e3a 206f 7574 7075     OUTLEN: outpu
│ │ │ │ -00027820: 7420 7661 7269 6162 6c65 2077 6974 6820  t variable with 
│ │ │ │ -00027830: 7369 7a65 206f 6620 6e65 776c 7920 616c  size of newly al
│ │ │ │ -00027840: 6c6f 6361 7465 6420 6f75 7470 7574 2061  located output a
│ │ │ │ -00027850: 7272 6179 2e0a 0a20 2020 2020 2a44 6573  rray...     *Des
│ │ │ │ -00027860: 6372 6970 7469 6f6e 3a2a 2045 6e63 7279  cription:* Encry
│ │ │ │ -00027870: 7074 7320 6461 7461 2075 7369 6e67 2073  pts data using s
│ │ │ │ -00027880: 7065 6369 6669 6564 206b 6579 2e20 2054  pecified key.  T
│ │ │ │ -00027890: 6865 206b 6579 2061 6374 7561 6c6c 790a  he key actually.
│ │ │ │ -000278a0: 2020 2020 2075 7365 6420 6973 2064 6572       used is der
│ │ │ │ -000278b0: 6976 6564 2075 7369 6e67 2074 6865 206b  ived using the k
│ │ │ │ -000278c0: 6579 2075 7361 6765 2e20 2049 6620 6b65  ey usage.  If ke
│ │ │ │ -000278d0: 7920 7573 6167 6520 6973 2030 2c20 6e6f  y usage is 0, no
│ │ │ │ -000278e0: 206b 6579 0a20 2020 2020 6465 7269 7661   key.     deriva
│ │ │ │ -000278f0: 7469 6f6e 2069 7320 7573 6564 2e20 2054  tion is used.  T
│ │ │ │ -00027900: 6865 204f 5554 2062 7566 6665 7220 6d75  he OUT buffer mu
│ │ │ │ -00027910: 7374 2062 6520 6465 616c 6c6f 6361 7465  st be deallocate
│ │ │ │ -00027920: 6420 6279 2074 6865 0a20 2020 2020 6361  d by the.     ca
│ │ │ │ -00027930: 6c6c 6572 2e20 2054 6865 2064 6566 6175  ller.  The defau
│ │ │ │ -00027940: 6c74 2049 5620 6973 2075 7365 642c 2073  lt IV is used, s
│ │ │ │ -00027950: 6565 2073 6869 7368 695f 656e 6372 7970  ee shishi_encryp
│ │ │ │ -00027960: 745f 6976 2069 6620 796f 7520 6e65 6564  t_iv if you need
│ │ │ │ -00027970: 0a20 2020 2020 746f 2061 6c74 6572 2069  .     to alter i
│ │ │ │ -00027980: 742e 2020 5468 6520 6e65 7874 2049 5620  t.  The next IV 
│ │ │ │ -00027990: 6973 206c 6f73 742c 2073 6565 2073 6869  is lost, see shi
│ │ │ │ -000279a0: 7368 695f 656e 6372 7970 745f 6976 7570  shi_encrypt_ivup
│ │ │ │ -000279b0: 6461 7465 2069 660a 2020 2020 2079 6f75  date if.     you
│ │ │ │ -000279c0: 206e 6565 6420 6974 2e0a 0a20 2020 2020   need it...     
│ │ │ │ -000279d0: 4e6f 7465 2074 6861 7420 4445 4352 5950  Note that DECRYP
│ │ │ │ -000279e0: 5428 454e 4352 5950 5428 6461 7461 2929  T(ENCRYPT(data))
│ │ │ │ -000279f0: 2064 6f65 7320 6e6f 7420 6e65 6365 7373   does not necess
│ │ │ │ -00027a00: 6172 696c 7920 7969 656c 6420 6461 7461  arily yield data
│ │ │ │ -00027a10: 0a20 2020 2020 6578 6163 746c 792e 2020  .     exactly.  
│ │ │ │ -00027a20: 536f 6d65 2065 6e63 7279 7074 696f 6e20  Some encryption 
│ │ │ │ -00027a30: 7479 7065 7320 6164 6420 7061 6420 746f  types add pad to
│ │ │ │ -00027a40: 206d 616b 6520 7468 6520 6461 7461 2066   make the data f
│ │ │ │ -00027a50: 6974 2069 6e74 6f0a 2020 2020 2074 6865  it into.     the
│ │ │ │ -00027a60: 2062 6c6f 636b 2073 697a 6520 6f66 2074   block size of t
│ │ │ │ -00027a70: 6865 2065 6e63 7279 7074 696f 6e20 616c  he encryption al
│ │ │ │ -00027a80: 676f 7269 7468 6d2e 2020 4675 7274 6865  gorithm.  Furthe
│ │ │ │ -00027a90: 726d 6f72 652c 2074 6865 2070 6164 0a20  rmore, the pad. 
│ │ │ │ -00027aa0: 2020 2020 6973 206e 6f74 2067 7561 7261      is not guara
│ │ │ │ -00027ab0: 6e74 6565 6420 746f 206c 6f6f 6b20 696e  nteed to look in
│ │ │ │ -00027ac0: 2061 6e79 2073 7065 6369 616c 2077 6179   any special way
│ │ │ │ -00027ad0: 2c20 616c 7468 6f75 6768 2065 7869 7374  , although exist
│ │ │ │ -00027ae0: 696e 670a 2020 2020 2069 6d70 6c65 6d65  ing.     impleme
│ │ │ │ -00027af0: 6e74 6174 696f 6e73 206f 6674 656e 2070  ntations often p
│ │ │ │ -00027b00: 6164 2077 6974 6820 7468 6520 7a65 726f  ad with the zero
│ │ │ │ -00027b10: 2062 7974 652e 2020 5468 6973 206d 6561   byte.  This mea
│ │ │ │ -00027b20: 6e73 2074 6861 7420 796f 750a 2020 2020  ns that you.    
│ │ │ │ -00027b30: 206d 6179 2068 6176 6520 746f 2022 6672   may have to "fr
│ │ │ │ -00027b40: 616d 6522 2064 6174 612c 2073 6f20 6974  ame" data, so it
│ │ │ │ -00027b50: 2069 7320 706f 7373 6962 6c65 2074 6f20   is possible to 
│ │ │ │ -00027b60: 696e 6665 7220 7468 6520 6f72 6967 696e  infer the origin
│ │ │ │ -00027b70: 616c 0a20 2020 2020 6c65 6e67 7468 2061  al.     length a
│ │ │ │ -00027b80: 6674 6572 2064 6563 7279 7074 696f 6e2e  fter decryption.
│ │ │ │ -00027b90: 2020 436f 6d70 6172 6520 4153 4e2e 3120    Compare ASN.1 
│ │ │ │ -00027ba0: 4445 5220 7768 6963 6820 636f 6e74 6169  DER which contai
│ │ │ │ -00027bb0: 6e73 2073 7563 680a 2020 2020 2069 6e66  ns such.     inf
│ │ │ │ -00027bc0: 6f72 6d61 7469 6f6e 2e0a 0a20 2020 2020  ormation...     
│ │ │ │ -00027bd0: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ -00027be0: 5265 7475 726e 7320 e280 9853 4849 5348  Returns ...SHISH
│ │ │ │ -00027bf0: 495f 4f4b e280 9920 6966 6620 7375 6363  I_OK... iff succ
│ │ │ │ -00027c00: 6573 7366 756c 2e0a 0a73 6869 7368 695f  essful...shishi_
│ │ │ │ -00027c10: 6465 6372 7970 745f 6976 7570 6461 7465  decrypt_ivupdate
│ │ │ │ -00027c20: 5f65 7479 7065 0a2d 2d2d 2d2d 2d2d 2d2d  _etype.---------
│ │ │ │ +000268b0: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ +000268c0: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ +000268d0: 5f65 6e63 7279 7074 5f69 7675 7064 6174  _encrypt_ivupdat
│ │ │ │ +000268e0: 6520 2853 6869 7368 6920 2a20 4841 4e44  e (Shishi * HAND
│ │ │ │ +000268f0: 4c45 2c0a 2020 2020 2020 2020 2020 5368  LE,.          Sh
│ │ │ │ +00026900: 6973 6869 5f6b 6579 202a 204b 4559 2c20  ishi_key * KEY, 
│ │ │ │ +00026910: 696e 7420 4b45 5955 5341 4745 2c20 636f  int KEYUSAGE, co
│ │ │ │ +00026920: 6e73 7420 6368 6172 202a 2049 562c 2073  nst char * IV, s
│ │ │ │ +00026930: 697a 655f 7420 4956 4c45 4e2c 0a20 2020  ize_t IVLEN,.   
│ │ │ │ +00026940: 2020 2020 2020 2063 6861 7220 2a2a 2049         char ** I
│ │ │ │ +00026950: 564f 5554 2c20 7369 7a65 5f74 202a 2049  VOUT, size_t * I
│ │ │ │ +00026960: 564f 5554 4c45 4e2c 2063 6f6e 7374 2063  VOUTLEN, const c
│ │ │ │ +00026970: 6861 7220 2a20 494e 2c0a 2020 2020 2020  har * IN,.      
│ │ │ │ +00026980: 2020 2020 7369 7a65 5f74 2049 4e4c 454e      size_t INLEN
│ │ │ │ +00026990: 2c20 6368 6172 202a 2a20 4f55 542c 2073  , char ** OUT, s
│ │ │ │ +000269a0: 697a 655f 7420 2a20 4f55 544c 454e 290a  ize_t * OUTLEN).
│ │ │ │ +000269b0: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ +000269c0: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ +000269d0: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ +000269e0: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ +000269f0: 2020 2020 204b 4559 3a20 6b65 7920 746f       KEY: key to
│ │ │ │ +00026a00: 2065 6e63 7279 7074 2077 6974 682e 0a20   encrypt with.. 
│ │ │ │ +00026a10: 2020 2020 4b45 5955 5341 4745 3a20 696e      KEYUSAGE: in
│ │ │ │ +00026a20: 7465 6765 7220 7370 6563 6966 7969 6e67  teger specifying
│ │ │ │ +00026a30: 2077 6861 7420 7468 6973 206b 6579 2069   what this key i
│ │ │ │ +00026a40: 7320 656e 6372 7970 7469 6e67 2e0a 2020  s encrypting..  
│ │ │ │ +00026a50: 2020 2049 563a 2069 6e70 7574 2061 7272     IV: input arr
│ │ │ │ +00026a60: 6179 2077 6974 6820 696e 6974 6961 6c69  ay with initiali
│ │ │ │ +00026a70: 7a61 7469 6f6e 2076 6563 746f 720a 2020  zation vector.  
│ │ │ │ +00026a80: 2020 2049 564c 454e 3a20 7369 7a65 206f     IVLEN: size o
│ │ │ │ +00026a90: 6620 696e 7075 7420 6172 7261 7920 7769  f input array wi
│ │ │ │ +00026aa0: 7468 2069 6e69 7469 616c 697a 6174 696f  th initializatio
│ │ │ │ +00026ab0: 6e20 7665 6374 6f72 2e0a 2020 2020 2049  n vector..     I
│ │ │ │ +00026ac0: 564f 5554 3a20 6f75 7470 7574 2061 7272  VOUT: output arr
│ │ │ │ +00026ad0: 6179 2077 6974 6820 6e65 776c 7920 616c  ay with newly al
│ │ │ │ +00026ae0: 6c6f 6361 7465 6420 7570 6461 7465 6420  located updated 
│ │ │ │ +00026af0: 696e 6974 6961 6c69 7a61 7469 6f6e 0a20  initialization. 
│ │ │ │ +00026b00: 2020 2020 7665 6374 6f72 2e0a 2020 2020      vector..    
│ │ │ │ +00026b10: 2049 564f 5554 4c45 4e3a 2073 697a 6520   IVOUTLEN: size 
│ │ │ │ +00026b20: 6f66 206f 7574 7075 7420 6172 7261 7920  of output array 
│ │ │ │ +00026b30: 7769 7468 2075 7064 6174 6564 2069 6e69  with updated ini
│ │ │ │ +00026b40: 7469 616c 697a 6174 696f 6e20 7665 6374  tialization vect
│ │ │ │ +00026b50: 6f72 2e0a 0a20 2020 2020 494e 3a20 696e  or...     IN: in
│ │ │ │ +00026b60: 7075 7420 6172 7261 7920 7769 7468 2064  put array with d
│ │ │ │ +00026b70: 6174 6120 746f 2065 6e63 7279 7074 2e0a  ata to encrypt..
│ │ │ │ +00026b80: 2020 2020 2049 4e4c 454e 3a20 7369 7a65       INLEN: size
│ │ │ │ +00026b90: 206f 6620 696e 7075 7420 6172 7261 7920   of input array 
│ │ │ │ +00026ba0: 7769 7468 2064 6174 6120 746f 2065 6e63  with data to enc
│ │ │ │ +00026bb0: 7279 7074 2e0a 2020 2020 204f 5554 3a20  rypt..     OUT: 
│ │ │ │ +00026bc0: 6f75 7470 7574 2061 7272 6179 2077 6974  output array wit
│ │ │ │ +00026bd0: 6820 6e65 776c 7920 616c 6c6f 6361 7465  h newly allocate
│ │ │ │ +00026be0: 6420 656e 6372 7970 7465 6420 6461 7461  d encrypted data
│ │ │ │ +00026bf0: 2e0a 2020 2020 204f 5554 4c45 4e3a 206f  ..     OUTLEN: o
│ │ │ │ +00026c00: 7574 7075 7420 7661 7269 6162 6c65 2077  utput variable w
│ │ │ │ +00026c10: 6974 6820 7369 7a65 206f 6620 6e65 776c  ith size of newl
│ │ │ │ +00026c20: 7920 616c 6c6f 6361 7465 6420 6f75 7470  y allocated outp
│ │ │ │ +00026c30: 7574 2061 7272 6179 2e0a 0a20 2020 2020  ut array...     
│ │ │ │ +00026c40: 2a44 6573 6372 6970 7469 6f6e 3a2a 2045  *Description:* E
│ │ │ │ +00026c50: 6e63 7279 7074 7320 6461 7461 2075 7369  ncrypts data usi
│ │ │ │ +00026c60: 6e67 2073 7065 6369 6669 6564 2069 6e69  ng specified ini
│ │ │ │ +00026c70: 7469 616c 697a 6174 696f 6e20 7665 6374  tialization vect
│ │ │ │ +00026c80: 6f72 0a20 2020 2020 616e 6420 6b65 792e  or.     and key.
│ │ │ │ +00026c90: 2020 5468 6520 6b65 7920 6163 7475 616c    The key actual
│ │ │ │ +00026ca0: 6c79 2075 7365 6420 6973 2064 6572 6976  ly used is deriv
│ │ │ │ +00026cb0: 6564 2075 7369 6e67 2074 6865 206b 6579  ed using the key
│ │ │ │ +00026cc0: 2075 7361 6765 2e20 2049 660a 2020 2020   usage.  If.    
│ │ │ │ +00026cd0: 206b 6579 2075 7361 6765 2069 7320 302c   key usage is 0,
│ │ │ │ +00026ce0: 206e 6f20 6b65 7920 6465 7269 7661 7469   no key derivati
│ │ │ │ +00026cf0: 6f6e 2069 7320 7573 6564 2e20 2054 6865  on is used.  The
│ │ │ │ +00026d00: 204f 5554 2062 7566 6665 7220 6d75 7374   OUT buffer must
│ │ │ │ +00026d10: 2062 650a 2020 2020 2064 6561 6c6c 6f63   be.     dealloc
│ │ │ │ +00026d20: 6174 6564 2062 7920 7468 6520 6361 6c6c  ated by the call
│ │ │ │ +00026d30: 6572 2e20 2049 6620 4956 4f55 5420 6f72  er.  If IVOUT or
│ │ │ │ +00026d40: 2049 564f 5554 4c45 4e20 6973 204e 554c   IVOUTLEN is NUL
│ │ │ │ +00026d50: 4c2c 2074 6865 0a20 2020 2020 7570 6461  L, the.     upda
│ │ │ │ +00026d60: 7465 6420 4956 2069 7320 6e6f 7420 7361  ted IV is not sa
│ │ │ │ +00026d70: 7665 6420 616e 7977 6865 7265 2e0a 0a20  ved anywhere... 
│ │ │ │ +00026d80: 2020 2020 4e6f 7465 2074 6861 7420 4445      Note that DE
│ │ │ │ +00026d90: 4352 5950 5428 454e 4352 5950 5428 6461  CRYPT(ENCRYPT(da
│ │ │ │ +00026da0: 7461 2929 2064 6f65 7320 6e6f 7420 6e65  ta)) does not ne
│ │ │ │ +00026db0: 6365 7373 6172 696c 7920 7969 656c 6420  cessarily yield 
│ │ │ │ +00026dc0: 6461 7461 0a20 2020 2020 6578 6163 746c  data.     exactl
│ │ │ │ +00026dd0: 792e 2020 536f 6d65 2065 6e63 7279 7074  y.  Some encrypt
│ │ │ │ +00026de0: 696f 6e20 7479 7065 7320 6164 6420 7061  ion types add pa
│ │ │ │ +00026df0: 6420 746f 206d 616b 6520 7468 6520 6461  d to make the da
│ │ │ │ +00026e00: 7461 2066 6974 2069 6e74 6f0a 2020 2020  ta fit into.    
│ │ │ │ +00026e10: 2074 6865 2062 6c6f 636b 2073 697a 6520   the block size 
│ │ │ │ +00026e20: 6f66 2074 6865 2065 6e63 7279 7074 696f  of the encryptio
│ │ │ │ +00026e30: 6e20 616c 676f 7269 7468 6d2e 2020 4675  n algorithm.  Fu
│ │ │ │ +00026e40: 7274 6865 726d 6f72 652c 2074 6865 2070  rthermore, the p
│ │ │ │ +00026e50: 6164 0a20 2020 2020 6973 206e 6f74 2067  ad.     is not g
│ │ │ │ +00026e60: 7561 7261 6e74 6565 6420 746f 206c 6f6f  uaranteed to loo
│ │ │ │ +00026e70: 6b20 696e 2061 6e79 2073 7065 6369 616c  k in any special
│ │ │ │ +00026e80: 2077 6179 2c20 616c 7468 6f75 6768 2065   way, although e
│ │ │ │ +00026e90: 7869 7374 696e 670a 2020 2020 2069 6d70  xisting.     imp
│ │ │ │ +00026ea0: 6c65 6d65 6e74 6174 696f 6e73 206f 6674  lementations oft
│ │ │ │ +00026eb0: 656e 2070 6164 2077 6974 6820 7468 6520  en pad with the 
│ │ │ │ +00026ec0: 7a65 726f 2062 7974 652e 2020 5468 6973  zero byte.  This
│ │ │ │ +00026ed0: 206d 6561 6e73 2074 6861 7420 796f 750a   means that you.
│ │ │ │ +00026ee0: 2020 2020 206d 6179 2068 6176 6520 746f       may have to
│ │ │ │ +00026ef0: 2022 6672 616d 6522 2064 6174 612c 2073   "frame" data, s
│ │ │ │ +00026f00: 6f20 6974 2069 7320 706f 7373 6962 6c65  o it is possible
│ │ │ │ +00026f10: 2074 6f20 696e 6665 7220 7468 6520 6f72   to infer the or
│ │ │ │ +00026f20: 6967 696e 616c 0a20 2020 2020 6c65 6e67  iginal.     leng
│ │ │ │ +00026f30: 7468 2061 6674 6572 2064 6563 7279 7074  th after decrypt
│ │ │ │ +00026f40: 696f 6e2e 2020 436f 6d70 6172 6520 4153  ion.  Compare AS
│ │ │ │ +00026f50: 4e2e 3120 4445 5220 7768 6963 6820 636f  N.1 DER which co
│ │ │ │ +00026f60: 6e74 6169 6e73 2073 7563 680a 2020 2020  ntains such.    
│ │ │ │ +00026f70: 2069 6e66 6f72 6d61 7469 6f6e 2e0a 0a20   information... 
│ │ │ │ +00026f80: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ +00026f90: 653a 2a20 5265 7475 726e 7320 e280 9853  e:* Returns ...S
│ │ │ │ +00026fa0: 4849 5348 495f 4f4b e280 9920 6966 6620  HISHI_OK... iff 
│ │ │ │ +00026fb0: 7375 6363 6573 7366 756c 2e0a 0a73 6869  successful...shi
│ │ │ │ +00026fc0: 7368 695f 656e 6372 7970 745f 6976 0a2d  shi_encrypt_iv.-
│ │ │ │ +00026fd0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +00026fe0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +00026ff0: 696e 7420 7368 6973 6869 5f65 6e63 7279  int shishi_encry
│ │ │ │ +00027000: 7074 5f69 7620 2853 6869 7368 6920 2a20  pt_iv (Shishi * 
│ │ │ │ +00027010: 4841 4e44 4c45 2c20 5368 6973 6869 5f6b  HANDLE, Shishi_k
│ │ │ │ +00027020: 6579 202a 204b 4559 2c0a 2020 2020 2020  ey * KEY,.      
│ │ │ │ +00027030: 2020 2020 696e 7420 4b45 5955 5341 4745      int KEYUSAGE
│ │ │ │ +00027040: 2c20 636f 6e73 7420 6368 6172 202a 2049  , const char * I
│ │ │ │ +00027050: 562c 2073 697a 655f 7420 4956 4c45 4e2c  V, size_t IVLEN,
│ │ │ │ +00027060: 2063 6f6e 7374 2063 6861 7220 2a20 494e   const char * IN
│ │ │ │ +00027070: 2c0a 2020 2020 2020 2020 2020 7369 7a65  ,.          size
│ │ │ │ +00027080: 5f74 2049 4e4c 454e 2c20 6368 6172 202a  _t INLEN, char *
│ │ │ │ +00027090: 2a20 4f55 542c 2073 697a 655f 7420 2a20  * OUT, size_t * 
│ │ │ │ +000270a0: 4f55 544c 454e 290a 2020 2020 2048 414e  OUTLEN).     HAN
│ │ │ │ +000270b0: 444c 453a 2073 6869 7368 6920 6861 6e64  DLE: shishi hand
│ │ │ │ +000270c0: 6c65 2061 7320 616c 6c6f 6361 7465 6420  le as allocated 
│ │ │ │ +000270d0: 6279 20e2 8098 7368 6973 6869 5f69 6e69  by ...shishi_ini
│ │ │ │ +000270e0: 7428 29e2 8099 2e0a 2020 2020 204b 4559  t().....     KEY
│ │ │ │ +000270f0: 3a20 6b65 7920 746f 2065 6e63 7279 7074  : key to encrypt
│ │ │ │ +00027100: 2077 6974 682e 0a20 2020 2020 4b45 5955   with..     KEYU
│ │ │ │ +00027110: 5341 4745 3a20 696e 7465 6765 7220 7370  SAGE: integer sp
│ │ │ │ +00027120: 6563 6966 7969 6e67 2077 6861 7420 7468  ecifying what th
│ │ │ │ +00027130: 6973 206b 6579 2069 7320 656e 6372 7970  is key is encryp
│ │ │ │ +00027140: 7469 6e67 2e0a 2020 2020 2049 563a 2069  ting..     IV: i
│ │ │ │ +00027150: 6e70 7574 2061 7272 6179 2077 6974 6820  nput array with 
│ │ │ │ +00027160: 696e 6974 6961 6c69 7a61 7469 6f6e 2076  initialization v
│ │ │ │ +00027170: 6563 746f 720a 2020 2020 2049 564c 454e  ector.     IVLEN
│ │ │ │ +00027180: 3a20 7369 7a65 206f 6620 696e 7075 7420  : size of input 
│ │ │ │ +00027190: 6172 7261 7920 7769 7468 2069 6e69 7469  array with initi
│ │ │ │ +000271a0: 616c 697a 6174 696f 6e20 7665 6374 6f72  alization vector
│ │ │ │ +000271b0: 2e0a 2020 2020 2049 4e3a 2069 6e70 7574  ..     IN: input
│ │ │ │ +000271c0: 2061 7272 6179 2077 6974 6820 6461 7461   array with data
│ │ │ │ +000271d0: 2074 6f20 656e 6372 7970 742e 0a20 2020   to encrypt..   
│ │ │ │ +000271e0: 2020 494e 4c45 4e3a 2073 697a 6520 6f66    INLEN: size of
│ │ │ │ +000271f0: 2069 6e70 7574 2061 7272 6179 2077 6974   input array wit
│ │ │ │ +00027200: 6820 6461 7461 2074 6f20 656e 6372 7970  h data to encryp
│ │ │ │ +00027210: 742e 0a20 2020 2020 4f55 543a 206f 7574  t..     OUT: out
│ │ │ │ +00027220: 7075 7420 6172 7261 7920 7769 7468 206e  put array with n
│ │ │ │ +00027230: 6577 6c79 2061 6c6c 6f63 6174 6564 2065  ewly allocated e
│ │ │ │ +00027240: 6e63 7279 7074 6564 2064 6174 612e 0a20  ncrypted data.. 
│ │ │ │ +00027250: 2020 2020 4f55 544c 454e 3a20 6f75 7470      OUTLEN: outp
│ │ │ │ +00027260: 7574 2076 6172 6961 626c 6520 7769 7468  ut variable with
│ │ │ │ +00027270: 2073 697a 6520 6f66 206e 6577 6c79 2061   size of newly a
│ │ │ │ +00027280: 6c6c 6f63 6174 6564 206f 7574 7075 7420  llocated output 
│ │ │ │ +00027290: 6172 7261 792e 0a0a 2020 2020 202a 4465  array...     *De
│ │ │ │ +000272a0: 7363 7269 7074 696f 6e3a 2a20 456e 6372  scription:* Encr
│ │ │ │ +000272b0: 7970 7473 2064 6174 6120 7573 696e 6720  ypts data using 
│ │ │ │ +000272c0: 7370 6563 6966 6965 6420 696e 6974 6961  specified initia
│ │ │ │ +000272d0: 6c69 7a61 7469 6f6e 2076 6563 746f 720a  lization vector.
│ │ │ │ +000272e0: 2020 2020 2061 6e64 206b 6579 2e20 2054       and key.  T
│ │ │ │ +000272f0: 6865 206b 6579 2061 6374 7561 6c6c 7920  he key actually 
│ │ │ │ +00027300: 7573 6564 2069 7320 6465 7269 7665 6420  used is derived 
│ │ │ │ +00027310: 7573 696e 6720 7468 6520 6b65 7920 7573  using the key us
│ │ │ │ +00027320: 6167 652e 2020 4966 0a20 2020 2020 6b65  age.  If.     ke
│ │ │ │ +00027330: 7920 7573 6167 6520 6973 2030 2c20 6e6f  y usage is 0, no
│ │ │ │ +00027340: 206b 6579 2064 6572 6976 6174 696f 6e20   key derivation 
│ │ │ │ +00027350: 6973 2075 7365 642e 2020 5468 6520 4f55  is used.  The OU
│ │ │ │ +00027360: 5420 6275 6666 6572 206d 7573 7420 6265  T buffer must be
│ │ │ │ +00027370: 0a20 2020 2020 6465 616c 6c6f 6361 7465  .     deallocate
│ │ │ │ +00027380: 6420 6279 2074 6865 2063 616c 6c65 722e  d by the caller.
│ │ │ │ +00027390: 2020 5468 6520 6e65 7874 2049 5620 6973    The next IV is
│ │ │ │ +000273a0: 206c 6f73 742c 2073 6565 0a20 2020 2020   lost, see.     
│ │ │ │ +000273b0: 7368 6973 6869 5f65 6e63 7279 7074 5f69  shishi_encrypt_i
│ │ │ │ +000273c0: 7675 7064 6174 6520 6966 2079 6f75 206e  vupdate if you n
│ │ │ │ +000273d0: 6565 6420 6974 2e0a 0a20 2020 2020 4e6f  eed it...     No
│ │ │ │ +000273e0: 7465 2074 6861 7420 4445 4352 5950 5428  te that DECRYPT(
│ │ │ │ +000273f0: 454e 4352 5950 5428 6461 7461 2929 2064  ENCRYPT(data)) d
│ │ │ │ +00027400: 6f65 7320 6e6f 7420 6e65 6365 7373 6172  oes not necessar
│ │ │ │ +00027410: 696c 7920 7969 656c 6420 6461 7461 0a20  ily yield data. 
│ │ │ │ +00027420: 2020 2020 6578 6163 746c 792e 2020 536f      exactly.  So
│ │ │ │ +00027430: 6d65 2065 6e63 7279 7074 696f 6e20 7479  me encryption ty
│ │ │ │ +00027440: 7065 7320 6164 6420 7061 6420 746f 206d  pes add pad to m
│ │ │ │ +00027450: 616b 6520 7468 6520 6461 7461 2066 6974  ake the data fit
│ │ │ │ +00027460: 2069 6e74 6f0a 2020 2020 2074 6865 2062   into.     the b
│ │ │ │ +00027470: 6c6f 636b 2073 697a 6520 6f66 2074 6865  lock size of the
│ │ │ │ +00027480: 2065 6e63 7279 7074 696f 6e20 616c 676f   encryption algo
│ │ │ │ +00027490: 7269 7468 6d2e 2020 4675 7274 6865 726d  rithm.  Furtherm
│ │ │ │ +000274a0: 6f72 652c 2074 6865 2070 6164 0a20 2020  ore, the pad.   
│ │ │ │ +000274b0: 2020 6973 206e 6f74 2067 7561 7261 6e74    is not guarant
│ │ │ │ +000274c0: 6565 6420 746f 206c 6f6f 6b20 696e 2061  eed to look in a
│ │ │ │ +000274d0: 6e79 2073 7065 6369 616c 2077 6179 2c20  ny special way, 
│ │ │ │ +000274e0: 616c 7468 6f75 6768 2065 7869 7374 696e  although existin
│ │ │ │ +000274f0: 670a 2020 2020 2069 6d70 6c65 6d65 6e74  g.     implement
│ │ │ │ +00027500: 6174 696f 6e73 206f 6674 656e 2070 6164  ations often pad
│ │ │ │ +00027510: 2077 6974 6820 7468 6520 7a65 726f 2062   with the zero b
│ │ │ │ +00027520: 7974 652e 2020 5468 6973 206d 6561 6e73  yte.  This means
│ │ │ │ +00027530: 2074 6861 7420 796f 750a 2020 2020 206d   that you.     m
│ │ │ │ +00027540: 6179 2068 6176 6520 746f 2022 6672 616d  ay have to "fram
│ │ │ │ +00027550: 6522 2064 6174 612c 2073 6f20 6974 2069  e" data, so it i
│ │ │ │ +00027560: 7320 706f 7373 6962 6c65 2074 6f20 696e  s possible to in
│ │ │ │ +00027570: 6665 7220 7468 6520 6f72 6967 696e 616c  fer the original
│ │ │ │ +00027580: 0a20 2020 2020 6c65 6e67 7468 2061 6674  .     length aft
│ │ │ │ +00027590: 6572 2064 6563 7279 7074 696f 6e2e 2020  er decryption.  
│ │ │ │ +000275a0: 436f 6d70 6172 6520 4153 4e2e 3120 4445  Compare ASN.1 DE
│ │ │ │ +000275b0: 5220 7768 6963 6820 636f 6e74 6169 6e73  R which contains
│ │ │ │ +000275c0: 2073 7563 680a 2020 2020 2069 6e66 6f72   such.     infor
│ │ │ │ +000275d0: 6d61 7469 6f6e 2e0a 0a20 2020 2020 2a52  mation...     *R
│ │ │ │ +000275e0: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +000275f0: 7475 726e 7320 e280 9853 4849 5348 495f  turns ...SHISHI_
│ │ │ │ +00027600: 4f4b e280 9920 6966 6620 7375 6363 6573  OK... iff succes
│ │ │ │ +00027610: 7366 756c 2e0a 0a73 6869 7368 695f 656e  sful...shishi_en
│ │ │ │ +00027620: 6372 7970 740a 2d2d 2d2d 2d2d 2d2d 2d2d  crypt.----------
│ │ │ │ +00027630: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ +00027640: 6f6e 3a20 696e 7420 7368 6973 6869 5f65  on: int shishi_e
│ │ │ │ +00027650: 6e63 7279 7074 2028 5368 6973 6869 202a  ncrypt (Shishi *
│ │ │ │ +00027660: 2048 414e 444c 452c 2053 6869 7368 695f   HANDLE, Shishi_
│ │ │ │ +00027670: 6b65 7920 2a20 4b45 592c 0a20 2020 2020  key * KEY,.     
│ │ │ │ +00027680: 2020 2020 2069 6e74 204b 4559 5553 4147       int KEYUSAG
│ │ │ │ +00027690: 452c 2063 6861 7220 2a20 494e 2c20 7369  E, char * IN, si
│ │ │ │ +000276a0: 7a65 5f74 2049 4e4c 454e 2c20 6368 6172  ze_t INLEN, char
│ │ │ │ +000276b0: 202a 2a20 4f55 542c 0a20 2020 2020 2020   ** OUT,.       
│ │ │ │ +000276c0: 2020 2073 697a 655f 7420 2a20 4f55 544c     size_t * OUTL
│ │ │ │ +000276d0: 454e 290a 2020 2020 2048 414e 444c 453a  EN).     HANDLE:
│ │ │ │ +000276e0: 2073 6869 7368 6920 6861 6e64 6c65 2061   shishi handle a
│ │ │ │ +000276f0: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ +00027700: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ +00027710: 8099 2e0a 2020 2020 204b 4559 3a20 6b65  ....     KEY: ke
│ │ │ │ +00027720: 7920 746f 2065 6e63 7279 7074 2077 6974  y to encrypt wit
│ │ │ │ +00027730: 682e 0a20 2020 2020 4b45 5955 5341 4745  h..     KEYUSAGE
│ │ │ │ +00027740: 3a20 696e 7465 6765 7220 7370 6563 6966  : integer specif
│ │ │ │ +00027750: 7969 6e67 2077 6861 7420 7468 6973 206b  ying what this k
│ │ │ │ +00027760: 6579 2069 7320 656e 6372 7970 7469 6e67  ey is encrypting
│ │ │ │ +00027770: 2e0a 2020 2020 2049 4e3a 2069 6e70 7574  ..     IN: input
│ │ │ │ +00027780: 2061 7272 6179 2077 6974 6820 6461 7461   array with data
│ │ │ │ +00027790: 2074 6f20 656e 6372 7970 742e 0a20 2020   to encrypt..   
│ │ │ │ +000277a0: 2020 494e 4c45 4e3a 2073 697a 6520 6f66    INLEN: size of
│ │ │ │ +000277b0: 2069 6e70 7574 2061 7272 6179 2077 6974   input array wit
│ │ │ │ +000277c0: 6820 6461 7461 2074 6f20 656e 6372 7970  h data to encryp
│ │ │ │ +000277d0: 742e 0a20 2020 2020 4f55 543a 206f 7574  t..     OUT: out
│ │ │ │ +000277e0: 7075 7420 6172 7261 7920 7769 7468 206e  put array with n
│ │ │ │ +000277f0: 6577 6c79 2061 6c6c 6f63 6174 6564 2065  ewly allocated e
│ │ │ │ +00027800: 6e63 7279 7074 6564 2064 6174 612e 0a20  ncrypted data.. 
│ │ │ │ +00027810: 2020 2020 4f55 544c 454e 3a20 6f75 7470      OUTLEN: outp
│ │ │ │ +00027820: 7574 2076 6172 6961 626c 6520 7769 7468  ut variable with
│ │ │ │ +00027830: 2073 697a 6520 6f66 206e 6577 6c79 2061   size of newly a
│ │ │ │ +00027840: 6c6c 6f63 6174 6564 206f 7574 7075 7420  llocated output 
│ │ │ │ +00027850: 6172 7261 792e 0a0a 2020 2020 202a 4465  array...     *De
│ │ │ │ +00027860: 7363 7269 7074 696f 6e3a 2a20 456e 6372  scription:* Encr
│ │ │ │ +00027870: 7970 7473 2064 6174 6120 7573 696e 6720  ypts data using 
│ │ │ │ +00027880: 7370 6563 6966 6965 6420 6b65 792e 2020  specified key.  
│ │ │ │ +00027890: 5468 6520 6b65 7920 6163 7475 616c 6c79  The key actually
│ │ │ │ +000278a0: 0a20 2020 2020 7573 6564 2069 7320 6465  .     used is de
│ │ │ │ +000278b0: 7269 7665 6420 7573 696e 6720 7468 6520  rived using the 
│ │ │ │ +000278c0: 6b65 7920 7573 6167 652e 2020 4966 206b  key usage.  If k
│ │ │ │ +000278d0: 6579 2075 7361 6765 2069 7320 302c 206e  ey usage is 0, n
│ │ │ │ +000278e0: 6f20 6b65 790a 2020 2020 2064 6572 6976  o key.     deriv
│ │ │ │ +000278f0: 6174 696f 6e20 6973 2075 7365 642e 2020  ation is used.  
│ │ │ │ +00027900: 5468 6520 4f55 5420 6275 6666 6572 206d  The OUT buffer m
│ │ │ │ +00027910: 7573 7420 6265 2064 6561 6c6c 6f63 6174  ust be deallocat
│ │ │ │ +00027920: 6564 2062 7920 7468 650a 2020 2020 2063  ed by the.     c
│ │ │ │ +00027930: 616c 6c65 722e 2020 5468 6520 6465 6661  aller.  The defa
│ │ │ │ +00027940: 756c 7420 4956 2069 7320 7573 6564 2c20  ult IV is used, 
│ │ │ │ +00027950: 7365 6520 7368 6973 6869 5f65 6e63 7279  see shishi_encry
│ │ │ │ +00027960: 7074 5f69 7620 6966 2079 6f75 206e 6565  pt_iv if you nee
│ │ │ │ +00027970: 640a 2020 2020 2074 6f20 616c 7465 7220  d.     to alter 
│ │ │ │ +00027980: 6974 2e20 2054 6865 206e 6578 7420 4956  it.  The next IV
│ │ │ │ +00027990: 2069 7320 6c6f 7374 2c20 7365 6520 7368   is lost, see sh
│ │ │ │ +000279a0: 6973 6869 5f65 6e63 7279 7074 5f69 7675  ishi_encrypt_ivu
│ │ │ │ +000279b0: 7064 6174 6520 6966 0a20 2020 2020 796f  pdate if.     yo
│ │ │ │ +000279c0: 7520 6e65 6564 2069 742e 0a0a 2020 2020  u need it...    
│ │ │ │ +000279d0: 204e 6f74 6520 7468 6174 2044 4543 5259   Note that DECRY
│ │ │ │ +000279e0: 5054 2845 4e43 5259 5054 2864 6174 6129  PT(ENCRYPT(data)
│ │ │ │ +000279f0: 2920 646f 6573 206e 6f74 206e 6563 6573  ) does not neces
│ │ │ │ +00027a00: 7361 7269 6c79 2079 6965 6c64 2064 6174  sarily yield dat
│ │ │ │ +00027a10: 610a 2020 2020 2065 7861 6374 6c79 2e20  a.     exactly. 
│ │ │ │ +00027a20: 2053 6f6d 6520 656e 6372 7970 7469 6f6e   Some encryption
│ │ │ │ +00027a30: 2074 7970 6573 2061 6464 2070 6164 2074   types add pad t
│ │ │ │ +00027a40: 6f20 6d61 6b65 2074 6865 2064 6174 6120  o make the data 
│ │ │ │ +00027a50: 6669 7420 696e 746f 0a20 2020 2020 7468  fit into.     th
│ │ │ │ +00027a60: 6520 626c 6f63 6b20 7369 7a65 206f 6620  e block size of 
│ │ │ │ +00027a70: 7468 6520 656e 6372 7970 7469 6f6e 2061  the encryption a
│ │ │ │ +00027a80: 6c67 6f72 6974 686d 2e20 2046 7572 7468  lgorithm.  Furth
│ │ │ │ +00027a90: 6572 6d6f 7265 2c20 7468 6520 7061 640a  ermore, the pad.
│ │ │ │ +00027aa0: 2020 2020 2069 7320 6e6f 7420 6775 6172       is not guar
│ │ │ │ +00027ab0: 616e 7465 6564 2074 6f20 6c6f 6f6b 2069  anteed to look i
│ │ │ │ +00027ac0: 6e20 616e 7920 7370 6563 6961 6c20 7761  n any special wa
│ │ │ │ +00027ad0: 792c 2061 6c74 686f 7567 6820 6578 6973  y, although exis
│ │ │ │ +00027ae0: 7469 6e67 0a20 2020 2020 696d 706c 656d  ting.     implem
│ │ │ │ +00027af0: 656e 7461 7469 6f6e 7320 6f66 7465 6e20  entations often 
│ │ │ │ +00027b00: 7061 6420 7769 7468 2074 6865 207a 6572  pad with the zer
│ │ │ │ +00027b10: 6f20 6279 7465 2e20 2054 6869 7320 6d65  o byte.  This me
│ │ │ │ +00027b20: 616e 7320 7468 6174 2079 6f75 0a20 2020  ans that you.   
│ │ │ │ +00027b30: 2020 6d61 7920 6861 7665 2074 6f20 2266    may have to "f
│ │ │ │ +00027b40: 7261 6d65 2220 6461 7461 2c20 736f 2069  rame" data, so i
│ │ │ │ +00027b50: 7420 6973 2070 6f73 7369 626c 6520 746f  t is possible to
│ │ │ │ +00027b60: 2069 6e66 6572 2074 6865 206f 7269 6769   infer the origi
│ │ │ │ +00027b70: 6e61 6c0a 2020 2020 206c 656e 6774 6820  nal.     length 
│ │ │ │ +00027b80: 6166 7465 7220 6465 6372 7970 7469 6f6e  after decryption
│ │ │ │ +00027b90: 2e20 2043 6f6d 7061 7265 2041 534e 2e31  .  Compare ASN.1
│ │ │ │ +00027ba0: 2044 4552 2077 6869 6368 2063 6f6e 7461   DER which conta
│ │ │ │ +00027bb0: 696e 7320 7375 6368 0a20 2020 2020 696e  ins such.     in
│ │ │ │ +00027bc0: 666f 726d 6174 696f 6e2e 0a0a 2020 2020  formation...    
│ │ │ │ +00027bd0: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ +00027be0: 2052 6574 7572 6e73 20e2 8098 5348 4953   Returns ...SHIS
│ │ │ │ +00027bf0: 4849 5f4f 4be2 8099 2069 6666 2073 7563  HI_OK... iff suc
│ │ │ │ +00027c00: 6365 7373 6675 6c2e 0a0a 7368 6973 6869  cessful...shishi
│ │ │ │ +00027c10: 5f64 6563 7279 7074 5f69 7675 7064 6174  _decrypt_ivupdat
│ │ │ │ +00027c20: 655f 6574 7970 650a 2d2d 2d2d 2d2d 2d2d  e_etype.--------
│ │ │ │  00027c30: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00027c40: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -00027c50: 6f6e 3a20 696e 7420 7368 6973 6869 5f64  on: int shishi_d
│ │ │ │ -00027c60: 6563 7279 7074 5f69 7675 7064 6174 655f  ecrypt_ivupdate_
│ │ │ │ -00027c70: 6574 7970 6520 2853 6869 7368 6920 2a20  etype (Shishi * 
│ │ │ │ -00027c80: 4841 4e44 4c45 2c0a 2020 2020 2020 2020  HANDLE,.        
│ │ │ │ -00027c90: 2020 5368 6973 6869 5f6b 6579 202a 204b    Shishi_key * K
│ │ │ │ -00027ca0: 4559 2c20 696e 7420 4b45 5955 5341 4745  EY, int KEYUSAGE
│ │ │ │ -00027cb0: 2c20 696e 7433 325f 7420 4554 5950 452c  , int32_t ETYPE,
│ │ │ │ -00027cc0: 0a20 2020 2020 2020 2020 2063 6f6e 7374  .          const
│ │ │ │ -00027cd0: 2063 6861 7220 2a20 4956 2c20 7369 7a65   char * IV, size
│ │ │ │ -00027ce0: 5f74 2049 564c 454e 2c20 6368 6172 202a  _t IVLEN, char *
│ │ │ │ -00027cf0: 2a20 4956 4f55 542c 0a20 2020 2020 2020  * IVOUT,.       
│ │ │ │ -00027d00: 2020 2073 697a 655f 7420 2a20 4956 4f55     size_t * IVOU
│ │ │ │ -00027d10: 544c 454e 2c20 636f 6e73 7420 6368 6172  TLEN, const char
│ │ │ │ -00027d20: 202a 2049 4e2c 2073 697a 655f 7420 494e   * IN, size_t IN
│ │ │ │ -00027d30: 4c45 4e2c 2063 6861 7220 2a2a 204f 5554  LEN, char ** OUT
│ │ │ │ -00027d40: 2c0a 2020 2020 2020 2020 2020 7369 7a65  ,.          size
│ │ │ │ -00027d50: 5f74 202a 204f 5554 4c45 4e29 0a20 2020  _t * OUTLEN).   
│ │ │ │ -00027d60: 2020 4841 4e44 4c45 3a20 7368 6973 6869    HANDLE: shishi
│ │ │ │ -00027d70: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ -00027d80: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ -00027d90: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ -00027da0: 2020 4b45 593a 206b 6579 2074 6f20 6465    KEY: key to de
│ │ │ │ -00027db0: 6372 7970 7420 7769 7468 2e0a 2020 2020  crypt with..    
│ │ │ │ -00027dc0: 204b 4559 5553 4147 453a 2069 6e74 6567   KEYUSAGE: integ
│ │ │ │ -00027dd0: 6572 2073 7065 6369 6679 696e 6720 7768  er specifying wh
│ │ │ │ -00027de0: 6174 2074 6869 7320 6b65 7920 6973 2064  at this key is d
│ │ │ │ -00027df0: 6563 7279 7074 696e 672e 0a20 2020 2020  ecrypting..     
│ │ │ │ -00027e00: 4554 5950 453a 2069 6e74 6567 6572 2073  ETYPE: integer s
│ │ │ │ -00027e10: 7065 6369 6679 696e 6720 7768 6174 2063  pecifying what c
│ │ │ │ -00027e20: 6970 6865 7220 746f 2075 7365 2e0a 2020  ipher to use..  
│ │ │ │ -00027e30: 2020 2049 563a 2069 6e70 7574 2061 7272     IV: input arr
│ │ │ │ -00027e40: 6179 2077 6974 6820 696e 6974 6961 6c69  ay with initiali
│ │ │ │ -00027e50: 7a61 7469 6f6e 2076 6563 746f 720a 2020  zation vector.  
│ │ │ │ -00027e60: 2020 2049 564c 454e 3a20 7369 7a65 206f     IVLEN: size o
│ │ │ │ -00027e70: 6620 696e 7075 7420 6172 7261 7920 7769  f input array wi
│ │ │ │ -00027e80: 7468 2069 6e69 7469 616c 697a 6174 696f  th initializatio
│ │ │ │ -00027e90: 6e20 7665 6374 6f72 2e0a 2020 2020 2049  n vector..     I
│ │ │ │ -00027ea0: 564f 5554 3a20 6f75 7470 7574 2061 7272  VOUT: output arr
│ │ │ │ -00027eb0: 6179 2077 6974 6820 6e65 776c 7920 616c  ay with newly al
│ │ │ │ -00027ec0: 6c6f 6361 7465 6420 7570 6461 7465 6420  located updated 
│ │ │ │ -00027ed0: 696e 6974 6961 6c69 7a61 7469 6f6e 0a20  initialization. 
│ │ │ │ -00027ee0: 2020 2020 7665 6374 6f72 2e0a 2020 2020      vector..    
│ │ │ │ -00027ef0: 2049 564f 5554 4c45 4e3a 2073 697a 6520   IVOUTLEN: size 
│ │ │ │ -00027f00: 6f66 206f 7574 7075 7420 6172 7261 7920  of output array 
│ │ │ │ -00027f10: 7769 7468 2075 7064 6174 6564 2069 6e69  with updated ini
│ │ │ │ -00027f20: 7469 616c 697a 6174 696f 6e20 7665 6374  tialization vect
│ │ │ │ -00027f30: 6f72 2e0a 0a20 2020 2020 494e 3a20 696e  or...     IN: in
│ │ │ │ -00027f40: 7075 7420 6172 7261 7920 7769 7468 2064  put array with d
│ │ │ │ -00027f50: 6174 6120 746f 2064 6563 7279 7074 2e0a  ata to decrypt..
│ │ │ │ -00027f60: 2020 2020 2049 4e4c 454e 3a20 7369 7a65       INLEN: size
│ │ │ │ -00027f70: 206f 6620 696e 7075 7420 6172 7261 7920   of input array 
│ │ │ │ -00027f80: 7769 7468 2064 6174 6120 746f 2064 6563  with data to dec
│ │ │ │ -00027f90: 7279 7074 2e0a 2020 2020 204f 5554 3a20  rypt..     OUT: 
│ │ │ │ -00027fa0: 6f75 7470 7574 2061 7272 6179 2077 6974  output array wit
│ │ │ │ -00027fb0: 6820 6e65 776c 7920 616c 6c6f 6361 7465  h newly allocate
│ │ │ │ -00027fc0: 6420 6465 6372 7970 7465 6420 6461 7461  d decrypted data
│ │ │ │ -00027fd0: 2e0a 2020 2020 204f 5554 4c45 4e3a 206f  ..     OUTLEN: o
│ │ │ │ -00027fe0: 7574 7075 7420 7661 7269 6162 6c65 2077  utput variable w
│ │ │ │ -00027ff0: 6974 6820 7369 7a65 206f 6620 6e65 776c  ith size of newl
│ │ │ │ -00028000: 7920 616c 6c6f 6361 7465 6420 6f75 7470  y allocated outp
│ │ │ │ -00028010: 7574 2061 7272 6179 2e0a 0a20 2020 2020  ut array...     
│ │ │ │ -00028020: 2a44 6573 6372 6970 7469 6f6e 3a2a 2044  *Description:* D
│ │ │ │ -00028030: 6563 7279 7074 7320 6461 7461 2061 7320  ecrypts data as 
│ │ │ │ -00028040: 7065 7220 656e 6372 7970 7469 6f6e 206d  per encryption m
│ │ │ │ -00028050: 6574 686f 6420 7573 696e 670a 2020 2020  ethod using.    
│ │ │ │ -00028060: 2073 7065 6369 6669 6564 2069 6e69 7469   specified initi
│ │ │ │ -00028070: 616c 697a 6174 696f 6e20 7665 6374 6f72  alization vector
│ │ │ │ -00028080: 2061 6e64 206b 6579 2e20 2054 6865 206b   and key.  The k
│ │ │ │ -00028090: 6579 2061 6374 7561 6c6c 7920 7573 6564  ey actually used
│ │ │ │ -000280a0: 2069 730a 2020 2020 2064 6572 6976 6564   is.     derived
│ │ │ │ -000280b0: 2075 7369 6e67 2074 6865 206b 6579 2075   using the key u
│ │ │ │ -000280c0: 7361 6765 2e20 2049 6620 6b65 7920 7573  sage.  If key us
│ │ │ │ -000280d0: 6167 6520 6973 2030 2c20 6e6f 206b 6579  age is 0, no key
│ │ │ │ -000280e0: 2064 6572 6976 6174 696f 6e0a 2020 2020   derivation.    
│ │ │ │ -000280f0: 2069 7320 7573 6564 2e20 2054 6865 204f   is used.  The O
│ │ │ │ -00028100: 5554 2062 7566 6665 7220 6d75 7374 2062  UT buffer must b
│ │ │ │ -00028110: 6520 6465 616c 6c6f 6361 7465 6420 6279  e deallocated by
│ │ │ │ -00028120: 2074 6865 2063 616c 6c65 722e 2020 4966   the caller.  If
│ │ │ │ -00028130: 0a20 2020 2020 4956 4f55 5420 6f72 2049  .     IVOUT or I
│ │ │ │ -00028140: 564f 5554 4c45 4e20 6973 204e 554c 4c2c  VOUTLEN is NULL,
│ │ │ │ -00028150: 2074 6865 2075 7064 6174 6564 2049 5620   the updated IV 
│ │ │ │ -00028160: 6973 206e 6f74 2073 6176 6564 2061 6e79  is not saved any
│ │ │ │ -00028170: 7768 6572 652e 0a0a 2020 2020 204e 6f74  where...     Not
│ │ │ │ -00028180: 6520 7468 6174 2044 4543 5259 5054 2845  e that DECRYPT(E
│ │ │ │ -00028190: 4e43 5259 5054 2864 6174 6129 2920 646f  NCRYPT(data)) do
│ │ │ │ -000281a0: 6573 206e 6f74 206e 6563 6573 7361 7269  es not necessari
│ │ │ │ -000281b0: 6c79 2079 6965 6c64 2064 6174 610a 2020  ly yield data.  
│ │ │ │ -000281c0: 2020 2065 7861 6374 6c79 2e20 2053 6f6d     exactly.  Som
│ │ │ │ -000281d0: 6520 656e 6372 7970 7469 6f6e 2074 7970  e encryption typ
│ │ │ │ -000281e0: 6573 2061 6464 2070 6164 2074 6f20 6d61  es add pad to ma
│ │ │ │ -000281f0: 6b65 2074 6865 2064 6174 6120 6669 7420  ke the data fit 
│ │ │ │ -00028200: 696e 746f 0a20 2020 2020 7468 6520 626c  into.     the bl
│ │ │ │ -00028210: 6f63 6b20 7369 7a65 206f 6620 7468 6520  ock size of the 
│ │ │ │ -00028220: 656e 6372 7970 7469 6f6e 2061 6c67 6f72  encryption algor
│ │ │ │ -00028230: 6974 686d 2e20 2046 7572 7468 6572 6d6f  ithm.  Furthermo
│ │ │ │ -00028240: 7265 2c20 7468 6520 7061 640a 2020 2020  re, the pad.    
│ │ │ │ -00028250: 2069 7320 6e6f 7420 6775 6172 616e 7465   is not guarante
│ │ │ │ -00028260: 6564 2074 6f20 6c6f 6f6b 2069 6e20 616e  ed to look in an
│ │ │ │ -00028270: 7920 7370 6563 6961 6c20 7761 792c 2061  y special way, a
│ │ │ │ -00028280: 6c74 686f 7567 6820 6578 6973 7469 6e67  lthough existing
│ │ │ │ -00028290: 0a20 2020 2020 696d 706c 656d 656e 7461  .     implementa
│ │ │ │ -000282a0: 7469 6f6e 7320 6f66 7465 6e20 7061 6420  tions often pad 
│ │ │ │ -000282b0: 7769 7468 2074 6865 207a 6572 6f20 6279  with the zero by
│ │ │ │ -000282c0: 7465 2e20 2054 6869 7320 6d65 616e 7320  te.  This means 
│ │ │ │ -000282d0: 7468 6174 2079 6f75 0a20 2020 2020 6d61  that you.     ma
│ │ │ │ -000282e0: 7920 6861 7665 2074 6f20 2266 7261 6d65  y have to "frame
│ │ │ │ -000282f0: 2220 6461 7461 2c20 736f 2069 7420 6973  " data, so it is
│ │ │ │ -00028300: 2070 6f73 7369 626c 6520 746f 2069 6e66   possible to inf
│ │ │ │ -00028310: 6572 2074 6865 206f 7269 6769 6e61 6c0a  er the original.
│ │ │ │ -00028320: 2020 2020 206c 656e 6774 6820 6166 7465       length afte
│ │ │ │ -00028330: 7220 6465 6372 7970 7469 6f6e 2e20 2043  r decryption.  C
│ │ │ │ -00028340: 6f6d 7061 7265 2041 534e 2e31 2044 4552  ompare ASN.1 DER
│ │ │ │ -00028350: 2077 6869 6368 2063 6f6e 7461 696e 7320   which contains 
│ │ │ │ -00028360: 7375 6368 0a20 2020 2020 696e 666f 726d  such.     inform
│ │ │ │ -00028370: 6174 696f 6e2e 0a0a 2020 2020 202a 5265  ation...     *Re
│ │ │ │ -00028380: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ -00028390: 7572 6e73 20e2 8098 5348 4953 4849 5f4f  urns ...SHISHI_O
│ │ │ │ -000283a0: 4be2 8099 2069 6666 2073 7563 6365 7373  K... iff success
│ │ │ │ -000283b0: 6675 6c2e 0a0a 7368 6973 6869 5f64 6563  ful...shishi_dec
│ │ │ │ -000283c0: 7279 7074 5f69 765f 6574 7970 650a 2d2d  rypt_iv_etype.--
│ │ │ │ +00027c40: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +00027c50: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ +00027c60: 6465 6372 7970 745f 6976 7570 6461 7465  decrypt_ivupdate
│ │ │ │ +00027c70: 5f65 7479 7065 2028 5368 6973 6869 202a  _etype (Shishi *
│ │ │ │ +00027c80: 2048 414e 444c 452c 0a20 2020 2020 2020   HANDLE,.       
│ │ │ │ +00027c90: 2020 2053 6869 7368 695f 6b65 7920 2a20     Shishi_key * 
│ │ │ │ +00027ca0: 4b45 592c 2069 6e74 204b 4559 5553 4147  KEY, int KEYUSAG
│ │ │ │ +00027cb0: 452c 2069 6e74 3332 5f74 2045 5459 5045  E, int32_t ETYPE
│ │ │ │ +00027cc0: 2c0a 2020 2020 2020 2020 2020 636f 6e73  ,.          cons
│ │ │ │ +00027cd0: 7420 6368 6172 202a 2049 562c 2073 697a  t char * IV, siz
│ │ │ │ +00027ce0: 655f 7420 4956 4c45 4e2c 2063 6861 7220  e_t IVLEN, char 
│ │ │ │ +00027cf0: 2a2a 2049 564f 5554 2c0a 2020 2020 2020  ** IVOUT,.      
│ │ │ │ +00027d00: 2020 2020 7369 7a65 5f74 202a 2049 564f      size_t * IVO
│ │ │ │ +00027d10: 5554 4c45 4e2c 2063 6f6e 7374 2063 6861  UTLEN, const cha
│ │ │ │ +00027d20: 7220 2a20 494e 2c20 7369 7a65 5f74 2049  r * IN, size_t I
│ │ │ │ +00027d30: 4e4c 454e 2c20 6368 6172 202a 2a20 4f55  NLEN, char ** OU
│ │ │ │ +00027d40: 542c 0a20 2020 2020 2020 2020 2073 697a  T,.          siz
│ │ │ │ +00027d50: 655f 7420 2a20 4f55 544c 454e 290a 2020  e_t * OUTLEN).  
│ │ │ │ +00027d60: 2020 2048 414e 444c 453a 2073 6869 7368     HANDLE: shish
│ │ │ │ +00027d70: 6920 6861 6e64 6c65 2061 7320 616c 6c6f  i handle as allo
│ │ │ │ +00027d80: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ +00027d90: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ +00027da0: 2020 204b 4559 3a20 6b65 7920 746f 2064     KEY: key to d
│ │ │ │ +00027db0: 6563 7279 7074 2077 6974 682e 0a20 2020  ecrypt with..   
│ │ │ │ +00027dc0: 2020 4b45 5955 5341 4745 3a20 696e 7465    KEYUSAGE: inte
│ │ │ │ +00027dd0: 6765 7220 7370 6563 6966 7969 6e67 2077  ger specifying w
│ │ │ │ +00027de0: 6861 7420 7468 6973 206b 6579 2069 7320  hat this key is 
│ │ │ │ +00027df0: 6465 6372 7970 7469 6e67 2e0a 2020 2020  decrypting..    
│ │ │ │ +00027e00: 2045 5459 5045 3a20 696e 7465 6765 7220   ETYPE: integer 
│ │ │ │ +00027e10: 7370 6563 6966 7969 6e67 2077 6861 7420  specifying what 
│ │ │ │ +00027e20: 6369 7068 6572 2074 6f20 7573 652e 0a20  cipher to use.. 
│ │ │ │ +00027e30: 2020 2020 4956 3a20 696e 7075 7420 6172      IV: input ar
│ │ │ │ +00027e40: 7261 7920 7769 7468 2069 6e69 7469 616c  ray with initial
│ │ │ │ +00027e50: 697a 6174 696f 6e20 7665 6374 6f72 0a20  ization vector. 
│ │ │ │ +00027e60: 2020 2020 4956 4c45 4e3a 2073 697a 6520      IVLEN: size 
│ │ │ │ +00027e70: 6f66 2069 6e70 7574 2061 7272 6179 2077  of input array w
│ │ │ │ +00027e80: 6974 6820 696e 6974 6961 6c69 7a61 7469  ith initializati
│ │ │ │ +00027e90: 6f6e 2076 6563 746f 722e 0a20 2020 2020  on vector..     
│ │ │ │ +00027ea0: 4956 4f55 543a 206f 7574 7075 7420 6172  IVOUT: output ar
│ │ │ │ +00027eb0: 7261 7920 7769 7468 206e 6577 6c79 2061  ray with newly a
│ │ │ │ +00027ec0: 6c6c 6f63 6174 6564 2075 7064 6174 6564  llocated updated
│ │ │ │ +00027ed0: 2069 6e69 7469 616c 697a 6174 696f 6e0a   initialization.
│ │ │ │ +00027ee0: 2020 2020 2076 6563 746f 722e 0a20 2020       vector..   
│ │ │ │ +00027ef0: 2020 4956 4f55 544c 454e 3a20 7369 7a65    IVOUTLEN: size
│ │ │ │ +00027f00: 206f 6620 6f75 7470 7574 2061 7272 6179   of output array
│ │ │ │ +00027f10: 2077 6974 6820 7570 6461 7465 6420 696e   with updated in
│ │ │ │ +00027f20: 6974 6961 6c69 7a61 7469 6f6e 2076 6563  itialization vec
│ │ │ │ +00027f30: 746f 722e 0a0a 2020 2020 2049 4e3a 2069  tor...     IN: i
│ │ │ │ +00027f40: 6e70 7574 2061 7272 6179 2077 6974 6820  nput array with 
│ │ │ │ +00027f50: 6461 7461 2074 6f20 6465 6372 7970 742e  data to decrypt.
│ │ │ │ +00027f60: 0a20 2020 2020 494e 4c45 4e3a 2073 697a  .     INLEN: siz
│ │ │ │ +00027f70: 6520 6f66 2069 6e70 7574 2061 7272 6179  e of input array
│ │ │ │ +00027f80: 2077 6974 6820 6461 7461 2074 6f20 6465   with data to de
│ │ │ │ +00027f90: 6372 7970 742e 0a20 2020 2020 4f55 543a  crypt..     OUT:
│ │ │ │ +00027fa0: 206f 7574 7075 7420 6172 7261 7920 7769   output array wi
│ │ │ │ +00027fb0: 7468 206e 6577 6c79 2061 6c6c 6f63 6174  th newly allocat
│ │ │ │ +00027fc0: 6564 2064 6563 7279 7074 6564 2064 6174  ed decrypted dat
│ │ │ │ +00027fd0: 612e 0a20 2020 2020 4f55 544c 454e 3a20  a..     OUTLEN: 
│ │ │ │ +00027fe0: 6f75 7470 7574 2076 6172 6961 626c 6520  output variable 
│ │ │ │ +00027ff0: 7769 7468 2073 697a 6520 6f66 206e 6577  with size of new
│ │ │ │ +00028000: 6c79 2061 6c6c 6f63 6174 6564 206f 7574  ly allocated out
│ │ │ │ +00028010: 7075 7420 6172 7261 792e 0a0a 2020 2020  put array...    
│ │ │ │ +00028020: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ +00028030: 4465 6372 7970 7473 2064 6174 6120 6173  Decrypts data as
│ │ │ │ +00028040: 2070 6572 2065 6e63 7279 7074 696f 6e20   per encryption 
│ │ │ │ +00028050: 6d65 7468 6f64 2075 7369 6e67 0a20 2020  method using.   
│ │ │ │ +00028060: 2020 7370 6563 6966 6965 6420 696e 6974    specified init
│ │ │ │ +00028070: 6961 6c69 7a61 7469 6f6e 2076 6563 746f  ialization vecto
│ │ │ │ +00028080: 7220 616e 6420 6b65 792e 2020 5468 6520  r and key.  The 
│ │ │ │ +00028090: 6b65 7920 6163 7475 616c 6c79 2075 7365  key actually use
│ │ │ │ +000280a0: 6420 6973 0a20 2020 2020 6465 7269 7665  d is.     derive
│ │ │ │ +000280b0: 6420 7573 696e 6720 7468 6520 6b65 7920  d using the key 
│ │ │ │ +000280c0: 7573 6167 652e 2020 4966 206b 6579 2075  usage.  If key u
│ │ │ │ +000280d0: 7361 6765 2069 7320 302c 206e 6f20 6b65  sage is 0, no ke
│ │ │ │ +000280e0: 7920 6465 7269 7661 7469 6f6e 0a20 2020  y derivation.   
│ │ │ │ +000280f0: 2020 6973 2075 7365 642e 2020 5468 6520    is used.  The 
│ │ │ │ +00028100: 4f55 5420 6275 6666 6572 206d 7573 7420  OUT buffer must 
│ │ │ │ +00028110: 6265 2064 6561 6c6c 6f63 6174 6564 2062  be deallocated b
│ │ │ │ +00028120: 7920 7468 6520 6361 6c6c 6572 2e20 2049  y the caller.  I
│ │ │ │ +00028130: 660a 2020 2020 2049 564f 5554 206f 7220  f.     IVOUT or 
│ │ │ │ +00028140: 4956 4f55 544c 454e 2069 7320 4e55 4c4c  IVOUTLEN is NULL
│ │ │ │ +00028150: 2c20 7468 6520 7570 6461 7465 6420 4956  , the updated IV
│ │ │ │ +00028160: 2069 7320 6e6f 7420 7361 7665 6420 616e   is not saved an
│ │ │ │ +00028170: 7977 6865 7265 2e0a 0a20 2020 2020 4e6f  ywhere...     No
│ │ │ │ +00028180: 7465 2074 6861 7420 4445 4352 5950 5428  te that DECRYPT(
│ │ │ │ +00028190: 454e 4352 5950 5428 6461 7461 2929 2064  ENCRYPT(data)) d
│ │ │ │ +000281a0: 6f65 7320 6e6f 7420 6e65 6365 7373 6172  oes not necessar
│ │ │ │ +000281b0: 696c 7920 7969 656c 6420 6461 7461 0a20  ily yield data. 
│ │ │ │ +000281c0: 2020 2020 6578 6163 746c 792e 2020 536f      exactly.  So
│ │ │ │ +000281d0: 6d65 2065 6e63 7279 7074 696f 6e20 7479  me encryption ty
│ │ │ │ +000281e0: 7065 7320 6164 6420 7061 6420 746f 206d  pes add pad to m
│ │ │ │ +000281f0: 616b 6520 7468 6520 6461 7461 2066 6974  ake the data fit
│ │ │ │ +00028200: 2069 6e74 6f0a 2020 2020 2074 6865 2062   into.     the b
│ │ │ │ +00028210: 6c6f 636b 2073 697a 6520 6f66 2074 6865  lock size of the
│ │ │ │ +00028220: 2065 6e63 7279 7074 696f 6e20 616c 676f   encryption algo
│ │ │ │ +00028230: 7269 7468 6d2e 2020 4675 7274 6865 726d  rithm.  Furtherm
│ │ │ │ +00028240: 6f72 652c 2074 6865 2070 6164 0a20 2020  ore, the pad.   
│ │ │ │ +00028250: 2020 6973 206e 6f74 2067 7561 7261 6e74    is not guarant
│ │ │ │ +00028260: 6565 6420 746f 206c 6f6f 6b20 696e 2061  eed to look in a
│ │ │ │ +00028270: 6e79 2073 7065 6369 616c 2077 6179 2c20  ny special way, 
│ │ │ │ +00028280: 616c 7468 6f75 6768 2065 7869 7374 696e  although existin
│ │ │ │ +00028290: 670a 2020 2020 2069 6d70 6c65 6d65 6e74  g.     implement
│ │ │ │ +000282a0: 6174 696f 6e73 206f 6674 656e 2070 6164  ations often pad
│ │ │ │ +000282b0: 2077 6974 6820 7468 6520 7a65 726f 2062   with the zero b
│ │ │ │ +000282c0: 7974 652e 2020 5468 6973 206d 6561 6e73  yte.  This means
│ │ │ │ +000282d0: 2074 6861 7420 796f 750a 2020 2020 206d   that you.     m
│ │ │ │ +000282e0: 6179 2068 6176 6520 746f 2022 6672 616d  ay have to "fram
│ │ │ │ +000282f0: 6522 2064 6174 612c 2073 6f20 6974 2069  e" data, so it i
│ │ │ │ +00028300: 7320 706f 7373 6962 6c65 2074 6f20 696e  s possible to in
│ │ │ │ +00028310: 6665 7220 7468 6520 6f72 6967 696e 616c  fer the original
│ │ │ │ +00028320: 0a20 2020 2020 6c65 6e67 7468 2061 6674  .     length aft
│ │ │ │ +00028330: 6572 2064 6563 7279 7074 696f 6e2e 2020  er decryption.  
│ │ │ │ +00028340: 436f 6d70 6172 6520 4153 4e2e 3120 4445  Compare ASN.1 DE
│ │ │ │ +00028350: 5220 7768 6963 6820 636f 6e74 6169 6e73  R which contains
│ │ │ │ +00028360: 2073 7563 680a 2020 2020 2069 6e66 6f72   such.     infor
│ │ │ │ +00028370: 6d61 7469 6f6e 2e0a 0a20 2020 2020 2a52  mation...     *R
│ │ │ │ +00028380: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +00028390: 7475 726e 7320 e280 9853 4849 5348 495f  turns ...SHISHI_
│ │ │ │ +000283a0: 4f4b e280 9920 6966 6620 7375 6363 6573  OK... iff succes
│ │ │ │ +000283b0: 7366 756c 2e0a 0a73 6869 7368 695f 6465  sful...shishi_de
│ │ │ │ +000283c0: 6372 7970 745f 6976 5f65 7479 7065 0a2d  crypt_iv_etype.-
│ │ │ │  000283d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000283e0: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ -000283f0: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ -00028400: 6465 6372 7970 745f 6976 5f65 7479 7065  decrypt_iv_etype
│ │ │ │ -00028410: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ -00028420: 452c 0a20 2020 2020 2020 2020 2053 6869  E,.          Shi
│ │ │ │ -00028430: 7368 695f 6b65 7920 2a20 4b45 592c 2069  shi_key * KEY, i
│ │ │ │ -00028440: 6e74 204b 4559 5553 4147 452c 2069 6e74  nt KEYUSAGE, int
│ │ │ │ -00028450: 3332 5f74 2045 5459 5045 2c0a 2020 2020  32_t ETYPE,.    
│ │ │ │ -00028460: 2020 2020 2020 636f 6e73 7420 6368 6172        const char
│ │ │ │ -00028470: 202a 2049 562c 2073 697a 655f 7420 4956   * IV, size_t IV
│ │ │ │ -00028480: 4c45 4e2c 2063 6f6e 7374 2063 6861 7220  LEN, const char 
│ │ │ │ -00028490: 2a20 494e 2c20 7369 7a65 5f74 2049 4e4c  * IN, size_t INL
│ │ │ │ -000284a0: 454e 2c0a 2020 2020 2020 2020 2020 6368  EN,.          ch
│ │ │ │ -000284b0: 6172 202a 2a20 4f55 542c 2073 697a 655f  ar ** OUT, size_
│ │ │ │ -000284c0: 7420 2a20 4f55 544c 454e 290a 2020 2020  t * OUTLEN).    
│ │ │ │ -000284d0: 2048 414e 444c 453a 2073 6869 7368 6920   HANDLE: shishi 
│ │ │ │ -000284e0: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ -000284f0: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ -00028500: 5f69 6e69 7428 29e2 8099 2e0a 2020 2020  _init().....    
│ │ │ │ -00028510: 204b 4559 3a20 6b65 7920 746f 2064 6563   KEY: key to dec
│ │ │ │ -00028520: 7279 7074 2077 6974 682e 0a20 2020 2020  rypt with..     
│ │ │ │ -00028530: 4b45 5955 5341 4745 3a20 696e 7465 6765  KEYUSAGE: intege
│ │ │ │ -00028540: 7220 7370 6563 6966 7969 6e67 2077 6861  r specifying wha
│ │ │ │ -00028550: 7420 7468 6973 206b 6579 2069 7320 6465  t this key is de
│ │ │ │ -00028560: 6372 7970 7469 6e67 2e0a 2020 2020 2045  crypting..     E
│ │ │ │ -00028570: 5459 5045 3a20 696e 7465 6765 7220 7370  TYPE: integer sp
│ │ │ │ -00028580: 6563 6966 7969 6e67 2077 6861 7420 6369  ecifying what ci
│ │ │ │ -00028590: 7068 6572 2074 6f20 7573 652e 0a20 2020  pher to use..   
│ │ │ │ -000285a0: 2020 4956 3a20 696e 7075 7420 6172 7261    IV: input arra
│ │ │ │ -000285b0: 7920 7769 7468 2069 6e69 7469 616c 697a  y with initializ
│ │ │ │ -000285c0: 6174 696f 6e20 7665 6374 6f72 0a20 2020  ation vector.   
│ │ │ │ -000285d0: 2020 4956 4c45 4e3a 2073 697a 6520 6f66    IVLEN: size of
│ │ │ │ -000285e0: 2069 6e70 7574 2061 7272 6179 2077 6974   input array wit
│ │ │ │ -000285f0: 6820 696e 6974 6961 6c69 7a61 7469 6f6e  h initialization
│ │ │ │ -00028600: 2076 6563 746f 722e 0a20 2020 2020 494e   vector..     IN
│ │ │ │ -00028610: 3a20 696e 7075 7420 6172 7261 7920 7769  : input array wi
│ │ │ │ -00028620: 7468 2064 6174 6120 746f 2064 6563 7279  th data to decry
│ │ │ │ -00028630: 7074 2e0a 2020 2020 2049 4e4c 454e 3a20  pt..     INLEN: 
│ │ │ │ -00028640: 7369 7a65 206f 6620 696e 7075 7420 6172  size of input ar
│ │ │ │ -00028650: 7261 7920 7769 7468 2064 6174 6120 746f  ray with data to
│ │ │ │ -00028660: 2064 6563 7279 7074 2e0a 2020 2020 204f   decrypt..     O
│ │ │ │ -00028670: 5554 3a20 6f75 7470 7574 2061 7272 6179  UT: output array
│ │ │ │ -00028680: 2077 6974 6820 6e65 776c 7920 616c 6c6f   with newly allo
│ │ │ │ -00028690: 6361 7465 6420 6465 6372 7970 7465 6420  cated decrypted 
│ │ │ │ -000286a0: 6461 7461 2e0a 2020 2020 204f 5554 4c45  data..     OUTLE
│ │ │ │ -000286b0: 4e3a 206f 7574 7075 7420 7661 7269 6162  N: output variab
│ │ │ │ -000286c0: 6c65 2077 6974 6820 7369 7a65 206f 6620  le with size of 
│ │ │ │ -000286d0: 6e65 776c 7920 616c 6c6f 6361 7465 6420  newly allocated 
│ │ │ │ -000286e0: 6f75 7470 7574 2061 7272 6179 2e0a 0a20  output array... 
│ │ │ │ -000286f0: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -00028700: 3a2a 2044 6563 7279 7074 7320 6461 7461  :* Decrypts data
│ │ │ │ -00028710: 2061 7320 7065 7220 656e 6372 7970 7469   as per encrypti
│ │ │ │ -00028720: 6f6e 206d 6574 686f 6420 7573 696e 670a  on method using.
│ │ │ │ -00028730: 2020 2020 2073 7065 6369 6669 6564 2069       specified i
│ │ │ │ -00028740: 6e69 7469 616c 697a 6174 696f 6e20 7665  nitialization ve
│ │ │ │ -00028750: 6374 6f72 2061 6e64 206b 6579 2e20 2054  ctor and key.  T
│ │ │ │ -00028760: 6865 206b 6579 2061 6374 7561 6c6c 7920  he key actually 
│ │ │ │ -00028770: 7573 6564 2069 730a 2020 2020 2064 6572  used is.     der
│ │ │ │ -00028780: 6976 6564 2075 7369 6e67 2074 6865 206b  ived using the k
│ │ │ │ -00028790: 6579 2075 7361 6765 2e20 2049 6620 6b65  ey usage.  If ke
│ │ │ │ -000287a0: 7920 7573 6167 6520 6973 2030 2c20 6e6f  y usage is 0, no
│ │ │ │ -000287b0: 206b 6579 2064 6572 6976 6174 696f 6e0a   key derivation.
│ │ │ │ -000287c0: 2020 2020 2069 7320 7573 6564 2e20 2054       is used.  T
│ │ │ │ -000287d0: 6865 204f 5554 2062 7566 6665 7220 6d75  he OUT buffer mu
│ │ │ │ -000287e0: 7374 2062 6520 6465 616c 6c6f 6361 7465  st be deallocate
│ │ │ │ -000287f0: 6420 6279 2074 6865 2063 616c 6c65 722e  d by the caller.
│ │ │ │ -00028800: 2020 5468 650a 2020 2020 206e 6578 7420    The.     next 
│ │ │ │ -00028810: 4956 2069 7320 6c6f 7374 2c20 7365 6520  IV is lost, see 
│ │ │ │ -00028820: 7368 6973 6869 5f64 6563 7279 7074 5f69  shishi_decrypt_i
│ │ │ │ -00028830: 7675 7064 6174 655f 6574 7970 6520 6966  vupdate_etype if
│ │ │ │ -00028840: 2079 6f75 206e 6565 6420 6974 2e0a 0a20   you need it... 
│ │ │ │ -00028850: 2020 2020 4e6f 7465 2074 6861 7420 4445      Note that DE
│ │ │ │ -00028860: 4352 5950 5428 454e 4352 5950 5428 6461  CRYPT(ENCRYPT(da
│ │ │ │ -00028870: 7461 2929 2064 6f65 7320 6e6f 7420 6e65  ta)) does not ne
│ │ │ │ -00028880: 6365 7373 6172 696c 7920 7969 656c 6420  cessarily yield 
│ │ │ │ -00028890: 6461 7461 0a20 2020 2020 6578 6163 746c  data.     exactl
│ │ │ │ -000288a0: 792e 2020 536f 6d65 2065 6e63 7279 7074  y.  Some encrypt
│ │ │ │ -000288b0: 696f 6e20 7479 7065 7320 6164 6420 7061  ion types add pa
│ │ │ │ -000288c0: 6420 746f 206d 616b 6520 7468 6520 6461  d to make the da
│ │ │ │ -000288d0: 7461 2066 6974 2069 6e74 6f0a 2020 2020  ta fit into.    
│ │ │ │ -000288e0: 2074 6865 2062 6c6f 636b 2073 697a 6520   the block size 
│ │ │ │ -000288f0: 6f66 2074 6865 2065 6e63 7279 7074 696f  of the encryptio
│ │ │ │ -00028900: 6e20 616c 676f 7269 7468 6d2e 2020 4675  n algorithm.  Fu
│ │ │ │ -00028910: 7274 6865 726d 6f72 652c 2074 6865 2070  rthermore, the p
│ │ │ │ -00028920: 6164 0a20 2020 2020 6973 206e 6f74 2067  ad.     is not g
│ │ │ │ -00028930: 7561 7261 6e74 6565 6420 746f 206c 6f6f  uaranteed to loo
│ │ │ │ -00028940: 6b20 696e 2061 6e79 2073 7065 6369 616c  k in any special
│ │ │ │ -00028950: 2077 6179 2c20 616c 7468 6f75 6768 2065   way, although e
│ │ │ │ -00028960: 7869 7374 696e 670a 2020 2020 2069 6d70  xisting.     imp
│ │ │ │ -00028970: 6c65 6d65 6e74 6174 696f 6e73 206f 6674  lementations oft
│ │ │ │ -00028980: 656e 2070 6164 2077 6974 6820 7468 6520  en pad with the 
│ │ │ │ -00028990: 7a65 726f 2062 7974 652e 2020 5468 6973  zero byte.  This
│ │ │ │ -000289a0: 206d 6561 6e73 2074 6861 7420 796f 750a   means that you.
│ │ │ │ -000289b0: 2020 2020 206d 6179 2068 6176 6520 746f       may have to
│ │ │ │ -000289c0: 2022 6672 616d 6522 2064 6174 612c 2073   "frame" data, s
│ │ │ │ -000289d0: 6f20 6974 2069 7320 706f 7373 6962 6c65  o it is possible
│ │ │ │ -000289e0: 2074 6f20 696e 6665 7220 7468 6520 6f72   to infer the or
│ │ │ │ -000289f0: 6967 696e 616c 0a20 2020 2020 6c65 6e67  iginal.     leng
│ │ │ │ -00028a00: 7468 2061 6674 6572 2064 6563 7279 7074  th after decrypt
│ │ │ │ -00028a10: 696f 6e2e 2020 436f 6d70 6172 6520 4153  ion.  Compare AS
│ │ │ │ -00028a20: 4e2e 3120 4445 5220 7768 6963 6820 636f  N.1 DER which co
│ │ │ │ -00028a30: 6e74 6169 6e73 2073 7563 680a 2020 2020  ntains such.    
│ │ │ │ -00028a40: 2069 6e66 6f72 6d61 7469 6f6e 2e0a 0a20   information... 
│ │ │ │ -00028a50: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ -00028a60: 653a 2a20 5265 7475 726e 7320 e280 9853  e:* Returns ...S
│ │ │ │ -00028a70: 4849 5348 495f 4f4b e280 9920 6966 6620  HISHI_OK... iff 
│ │ │ │ -00028a80: 7375 6363 6573 7366 756c 2e0a 0a73 6869  successful...shi
│ │ │ │ -00028a90: 7368 695f 6465 6372 7970 745f 6574 7970  shi_decrypt_etyp
│ │ │ │ -00028aa0: 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  e.--------------
│ │ │ │ -00028ab0: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ -00028ac0: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ -00028ad0: 5f64 6563 7279 7074 5f65 7479 7065 2028  _decrypt_etype (
│ │ │ │ -00028ae0: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ -00028af0: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ -00028b00: 695f 6b65 7920 2a20 4b45 592c 2069 6e74  i_key * KEY, int
│ │ │ │ -00028b10: 204b 4559 5553 4147 452c 2069 6e74 3332   KEYUSAGE, int32
│ │ │ │ -00028b20: 5f74 2045 5459 5045 2c0a 2020 2020 2020  _t ETYPE,.      
│ │ │ │ -00028b30: 2020 2020 636f 6e73 7420 6368 6172 202a      const char *
│ │ │ │ -00028b40: 2049 4e2c 2073 697a 655f 7420 494e 4c45   IN, size_t INLE
│ │ │ │ -00028b50: 4e2c 2063 6861 7220 2a2a 204f 5554 2c20  N, char ** OUT, 
│ │ │ │ -00028b60: 7369 7a65 5f74 202a 204f 5554 4c45 4e29  size_t * OUTLEN)
│ │ │ │ -00028b70: 0a20 2020 2020 4841 4e44 4c45 3a20 7368  .     HANDLE: sh
│ │ │ │ -00028b80: 6973 6869 2068 616e 646c 6520 6173 2061  ishi handle as a
│ │ │ │ -00028b90: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ -00028ba0: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ -00028bb0: 0a20 2020 2020 4b45 593a 206b 6579 2074  .     KEY: key t
│ │ │ │ -00028bc0: 6f20 6465 6372 7970 7420 7769 7468 2e0a  o decrypt with..
│ │ │ │ -00028bd0: 2020 2020 204b 4559 5553 4147 453a 2069       KEYUSAGE: i
│ │ │ │ -00028be0: 6e74 6567 6572 2073 7065 6369 6679 696e  nteger specifyin
│ │ │ │ -00028bf0: 6720 7768 6174 2074 6869 7320 6b65 7920  g what this key 
│ │ │ │ -00028c00: 6973 2064 6563 7279 7074 696e 672e 0a20  is decrypting.. 
│ │ │ │ -00028c10: 2020 2020 4554 5950 453a 2069 6e74 6567      ETYPE: integ
│ │ │ │ -00028c20: 6572 2073 7065 6369 6679 696e 6720 7768  er specifying wh
│ │ │ │ -00028c30: 6174 2063 6970 6865 7220 746f 2075 7365  at cipher to use
│ │ │ │ -00028c40: 2e0a 2020 2020 2049 4e3a 2069 6e70 7574  ..     IN: input
│ │ │ │ -00028c50: 2061 7272 6179 2077 6974 6820 6461 7461   array with data
│ │ │ │ -00028c60: 2074 6f20 6465 6372 7970 742e 0a20 2020   to decrypt..   
│ │ │ │ -00028c70: 2020 494e 4c45 4e3a 2073 697a 6520 6f66    INLEN: size of
│ │ │ │ -00028c80: 2069 6e70 7574 2061 7272 6179 2077 6974   input array wit
│ │ │ │ -00028c90: 6820 6461 7461 2074 6f20 6465 6372 7970  h data to decryp
│ │ │ │ -00028ca0: 742e 0a20 2020 2020 4f55 543a 206f 7574  t..     OUT: out
│ │ │ │ -00028cb0: 7075 7420 6172 7261 7920 7769 7468 206e  put array with n
│ │ │ │ -00028cc0: 6577 6c79 2061 6c6c 6f63 6174 6564 2064  ewly allocated d
│ │ │ │ -00028cd0: 6563 7279 7074 6564 2064 6174 612e 0a20  ecrypted data.. 
│ │ │ │ -00028ce0: 2020 2020 4f55 544c 454e 3a20 6f75 7470      OUTLEN: outp
│ │ │ │ -00028cf0: 7574 2076 6172 6961 626c 6520 7769 7468  ut variable with
│ │ │ │ -00028d00: 2073 697a 6520 6f66 206e 6577 6c79 2061   size of newly a
│ │ │ │ -00028d10: 6c6c 6f63 6174 6564 206f 7574 7075 7420  llocated output 
│ │ │ │ -00028d20: 6172 7261 792e 0a0a 2020 2020 202a 4465  array...     *De
│ │ │ │ -00028d30: 7363 7269 7074 696f 6e3a 2a20 4465 6372  scription:* Decr
│ │ │ │ -00028d40: 7970 7473 2064 6174 6120 6173 2070 6572  ypts data as per
│ │ │ │ -00028d50: 2065 6e63 7279 7074 696f 6e20 6d65 7468   encryption meth
│ │ │ │ -00028d60: 6f64 2075 7369 6e67 0a20 2020 2020 7370  od using.     sp
│ │ │ │ -00028d70: 6563 6966 6965 6420 6b65 792e 2020 5468  ecified key.  Th
│ │ │ │ -00028d80: 6520 6b65 7920 6163 7475 616c 6c79 2075  e key actually u
│ │ │ │ -00028d90: 7365 6420 6973 2064 6572 6976 6564 2075  sed is derived u
│ │ │ │ -00028da0: 7369 6e67 2074 6865 206b 6579 0a20 2020  sing the key.   
│ │ │ │ -00028db0: 2020 7573 6167 652e 2020 4966 206b 6579    usage.  If key
│ │ │ │ -00028dc0: 2075 7361 6765 2069 7320 302c 206e 6f20   usage is 0, no 
│ │ │ │ -00028dd0: 6b65 7920 6465 7269 7661 7469 6f6e 2069  key derivation i
│ │ │ │ -00028de0: 7320 7573 6564 2e20 2054 6865 204f 5554  s used.  The OUT
│ │ │ │ -00028df0: 0a20 2020 2020 6275 6666 6572 206d 7573  .     buffer mus
│ │ │ │ -00028e00: 7420 6265 2064 6561 6c6c 6f63 6174 6564  t be deallocated
│ │ │ │ -00028e10: 2062 7920 7468 6520 6361 6c6c 6572 2e20   by the caller. 
│ │ │ │ -00028e20: 2054 6865 2064 6566 6175 6c74 2049 5620   The default IV 
│ │ │ │ -00028e30: 6973 2075 7365 642c 0a20 2020 2020 7365  is used,.     se
│ │ │ │ -00028e40: 6520 7368 6973 6869 5f64 6563 7279 7074  e shishi_decrypt
│ │ │ │ -00028e50: 5f69 765f 6574 7970 6520 6966 2079 6f75  _iv_etype if you
│ │ │ │ -00028e60: 206e 6565 6420 746f 2061 6c74 6572 2069   need to alter i
│ │ │ │ -00028e70: 742e 2020 5468 6520 6e65 7874 2049 560a  t.  The next IV.
│ │ │ │ -00028e80: 2020 2020 2069 7320 6c6f 7374 2c20 7365       is lost, se
│ │ │ │ -00028e90: 6520 7368 6973 6869 5f64 6563 7279 7074  e shishi_decrypt
│ │ │ │ -00028ea0: 5f69 7675 7064 6174 655f 6574 7970 6520  _ivupdate_etype 
│ │ │ │ -00028eb0: 6966 2079 6f75 206e 6565 6420 6974 2e0a  if you need it..
│ │ │ │ -00028ec0: 0a20 2020 2020 4e6f 7465 2074 6861 7420  .     Note that 
│ │ │ │ -00028ed0: 4445 4352 5950 5428 454e 4352 5950 5428  DECRYPT(ENCRYPT(
│ │ │ │ -00028ee0: 6461 7461 2929 2064 6f65 7320 6e6f 7420  data)) does not 
│ │ │ │ -00028ef0: 6e65 6365 7373 6172 696c 7920 7969 656c  necessarily yiel
│ │ │ │ -00028f00: 6420 6461 7461 0a20 2020 2020 6578 6163  d data.     exac
│ │ │ │ -00028f10: 746c 792e 2020 536f 6d65 2065 6e63 7279  tly.  Some encry
│ │ │ │ -00028f20: 7074 696f 6e20 7479 7065 7320 6164 6420  ption types add 
│ │ │ │ -00028f30: 7061 6420 746f 206d 616b 6520 7468 6520  pad to make the 
│ │ │ │ -00028f40: 6461 7461 2066 6974 2069 6e74 6f0a 2020  data fit into.  
│ │ │ │ -00028f50: 2020 2074 6865 2062 6c6f 636b 2073 697a     the block siz
│ │ │ │ -00028f60: 6520 6f66 2074 6865 2065 6e63 7279 7074  e of the encrypt
│ │ │ │ -00028f70: 696f 6e20 616c 676f 7269 7468 6d2e 2020  ion algorithm.  
│ │ │ │ -00028f80: 4675 7274 6865 726d 6f72 652c 2074 6865  Furthermore, the
│ │ │ │ -00028f90: 2070 6164 0a20 2020 2020 6973 206e 6f74   pad.     is not
│ │ │ │ -00028fa0: 2067 7561 7261 6e74 6565 6420 746f 206c   guaranteed to l
│ │ │ │ -00028fb0: 6f6f 6b20 696e 2061 6e79 2073 7065 6369  ook in any speci
│ │ │ │ -00028fc0: 616c 2077 6179 2c20 616c 7468 6f75 6768  al way, although
│ │ │ │ -00028fd0: 2065 7869 7374 696e 670a 2020 2020 2069   existing.     i
│ │ │ │ -00028fe0: 6d70 6c65 6d65 6e74 6174 696f 6e73 206f  mplementations o
│ │ │ │ -00028ff0: 6674 656e 2070 6164 2077 6974 6820 7468  ften pad with th
│ │ │ │ -00029000: 6520 7a65 726f 2062 7974 652e 2020 5468  e zero byte.  Th
│ │ │ │ -00029010: 6973 206d 6561 6e73 2074 6861 7420 796f  is means that yo
│ │ │ │ -00029020: 750a 2020 2020 206d 6179 2068 6176 6520  u.     may have 
│ │ │ │ -00029030: 746f 2022 6672 616d 6522 2064 6174 612c  to "frame" data,
│ │ │ │ -00029040: 2073 6f20 6974 2069 7320 706f 7373 6962   so it is possib
│ │ │ │ -00029050: 6c65 2074 6f20 696e 6665 7220 7468 6520  le to infer the 
│ │ │ │ -00029060: 6f72 6967 696e 616c 0a20 2020 2020 6c65  original.     le
│ │ │ │ -00029070: 6e67 7468 2061 6674 6572 2064 6563 7279  ngth after decry
│ │ │ │ -00029080: 7074 696f 6e2e 2020 436f 6d70 6172 6520  ption.  Compare 
│ │ │ │ -00029090: 4153 4e2e 3120 4445 5220 7768 6963 6820  ASN.1 DER which 
│ │ │ │ -000290a0: 636f 6e74 6169 6e73 2073 7563 680a 2020  contains such.  
│ │ │ │ -000290b0: 2020 2069 6e66 6f72 6d61 7469 6f6e 2e0a     information..
│ │ │ │ -000290c0: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ -000290d0: 6c75 653a 2a20 5265 7475 726e 7320 e280  lue:* Returns ..
│ │ │ │ -000290e0: 9853 4849 5348 495f 4f4b e280 9920 6966  .SHISHI_OK... if
│ │ │ │ -000290f0: 6620 7375 6363 6573 7366 756c 2e0a 0a73  f successful...s
│ │ │ │ -00029100: 6869 7368 695f 6465 6372 7970 745f 6976  hishi_decrypt_iv
│ │ │ │ -00029110: 7570 6461 7465 0a2d 2d2d 2d2d 2d2d 2d2d  update.---------
│ │ │ │ -00029120: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -00029130: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ -00029140: 7420 7368 6973 6869 5f64 6563 7279 7074  t shishi_decrypt
│ │ │ │ -00029150: 5f69 7675 7064 6174 6520 2853 6869 7368  _ivupdate (Shish
│ │ │ │ -00029160: 6920 2a20 4841 4e44 4c45 2c0a 2020 2020  i * HANDLE,.    
│ │ │ │ -00029170: 2020 2020 2020 5368 6973 6869 5f6b 6579        Shishi_key
│ │ │ │ -00029180: 202a 204b 4559 2c20 696e 7420 4b45 5955   * KEY, int KEYU
│ │ │ │ -00029190: 5341 4745 2c20 636f 6e73 7420 6368 6172  SAGE, const char
│ │ │ │ -000291a0: 202a 2049 562c 2073 697a 655f 7420 4956   * IV, size_t IV
│ │ │ │ -000291b0: 4c45 4e2c 0a20 2020 2020 2020 2020 2063  LEN,.          c
│ │ │ │ -000291c0: 6861 7220 2a2a 2049 564f 5554 2c20 7369  har ** IVOUT, si
│ │ │ │ -000291d0: 7a65 5f74 202a 2049 564f 5554 4c45 4e2c  ze_t * IVOUTLEN,
│ │ │ │ -000291e0: 2063 6f6e 7374 2063 6861 7220 2a20 494e   const char * IN
│ │ │ │ -000291f0: 2c0a 2020 2020 2020 2020 2020 7369 7a65  ,.          size
│ │ │ │ -00029200: 5f74 2049 4e4c 454e 2c20 6368 6172 202a  _t INLEN, char *
│ │ │ │ -00029210: 2a20 4f55 542c 2073 697a 655f 7420 2a20  * OUT, size_t * 
│ │ │ │ -00029220: 4f55 544c 454e 290a 2020 2020 2048 414e  OUTLEN).     HAN
│ │ │ │ -00029230: 444c 453a 2073 6869 7368 6920 6861 6e64  DLE: shishi hand
│ │ │ │ -00029240: 6c65 2061 7320 616c 6c6f 6361 7465 6420  le as allocated 
│ │ │ │ -00029250: 6279 20e2 8098 7368 6973 6869 5f69 6e69  by ...shishi_ini
│ │ │ │ -00029260: 7428 29e2 8099 2e0a 2020 2020 204b 4559  t().....     KEY
│ │ │ │ -00029270: 3a20 6b65 7920 746f 2064 6563 7279 7074  : key to decrypt
│ │ │ │ -00029280: 2077 6974 682e 0a20 2020 2020 4b45 5955   with..     KEYU
│ │ │ │ -00029290: 5341 4745 3a20 696e 7465 6765 7220 7370  SAGE: integer sp
│ │ │ │ -000292a0: 6563 6966 7969 6e67 2077 6861 7420 7468  ecifying what th
│ │ │ │ -000292b0: 6973 206b 6579 2069 7320 6465 6372 7970  is key is decryp
│ │ │ │ -000292c0: 7469 6e67 2e0a 2020 2020 2049 563a 2069  ting..     IV: i
│ │ │ │ -000292d0: 6e70 7574 2061 7272 6179 2077 6974 6820  nput array with 
│ │ │ │ -000292e0: 696e 6974 6961 6c69 7a61 7469 6f6e 2076  initialization v
│ │ │ │ -000292f0: 6563 746f 720a 2020 2020 2049 564c 454e  ector.     IVLEN
│ │ │ │ -00029300: 3a20 7369 7a65 206f 6620 696e 7075 7420  : size of input 
│ │ │ │ -00029310: 6172 7261 7920 7769 7468 2069 6e69 7469  array with initi
│ │ │ │ -00029320: 616c 697a 6174 696f 6e20 7665 6374 6f72  alization vector
│ │ │ │ -00029330: 2e0a 2020 2020 2049 564f 5554 3a20 6f75  ..     IVOUT: ou
│ │ │ │ -00029340: 7470 7574 2061 7272 6179 2077 6974 6820  tput array with 
│ │ │ │ -00029350: 6e65 776c 7920 616c 6c6f 6361 7465 6420  newly allocated 
│ │ │ │ -00029360: 7570 6461 7465 6420 696e 6974 6961 6c69  updated initiali
│ │ │ │ -00029370: 7a61 7469 6f6e 0a20 2020 2020 7665 6374  zation.     vect
│ │ │ │ -00029380: 6f72 2e0a 2020 2020 2049 564f 5554 4c45  or..     IVOUTLE
│ │ │ │ -00029390: 4e3a 2073 697a 6520 6f66 206f 7574 7075  N: size of outpu
│ │ │ │ -000293a0: 7420 6172 7261 7920 7769 7468 2075 7064  t array with upd
│ │ │ │ -000293b0: 6174 6564 2069 6e69 7469 616c 697a 6174  ated initializat
│ │ │ │ -000293c0: 696f 6e20 7665 6374 6f72 2e0a 0a20 2020  ion vector...   
│ │ │ │ -000293d0: 2020 494e 3a20 696e 7075 7420 6172 7261    IN: input arra
│ │ │ │ -000293e0: 7920 7769 7468 2064 6174 6120 746f 2064  y with data to d
│ │ │ │ -000293f0: 6563 7279 7074 2e0a 2020 2020 2049 4e4c  ecrypt..     INL
│ │ │ │ -00029400: 454e 3a20 7369 7a65 206f 6620 696e 7075  EN: size of inpu
│ │ │ │ -00029410: 7420 6172 7261 7920 7769 7468 2064 6174  t array with dat
│ │ │ │ -00029420: 6120 746f 2064 6563 7279 7074 2e0a 2020  a to decrypt..  
│ │ │ │ -00029430: 2020 204f 5554 3a20 6f75 7470 7574 2061     OUT: output a
│ │ │ │ -00029440: 7272 6179 2077 6974 6820 6e65 776c 7920  rray with newly 
│ │ │ │ -00029450: 616c 6c6f 6361 7465 6420 6465 6372 7970  allocated decryp
│ │ │ │ -00029460: 7465 6420 6461 7461 2e0a 2020 2020 204f  ted data..     O
│ │ │ │ -00029470: 5554 4c45 4e3a 206f 7574 7075 7420 7661  UTLEN: output va
│ │ │ │ -00029480: 7269 6162 6c65 2077 6974 6820 7369 7a65  riable with size
│ │ │ │ -00029490: 206f 6620 6e65 776c 7920 616c 6c6f 6361   of newly alloca
│ │ │ │ -000294a0: 7465 6420 6f75 7470 7574 2061 7272 6179  ted output array
│ │ │ │ -000294b0: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ -000294c0: 7469 6f6e 3a2a 2044 6563 7279 7074 7320  tion:* Decrypts 
│ │ │ │ -000294d0: 6461 7461 2075 7369 6e67 2073 7065 6369  data using speci
│ │ │ │ -000294e0: 6669 6564 2069 6e69 7469 616c 697a 6174  fied initializat
│ │ │ │ -000294f0: 696f 6e20 7665 6374 6f72 0a20 2020 2020  ion vector.     
│ │ │ │ -00029500: 616e 6420 6b65 792e 2020 5468 6520 6b65  and key.  The ke
│ │ │ │ -00029510: 7920 6163 7475 616c 6c79 2075 7365 6420  y actually used 
│ │ │ │ -00029520: 6973 2064 6572 6976 6564 2075 7369 6e67  is derived using
│ │ │ │ -00029530: 2074 6865 206b 6579 2075 7361 6765 2e20   the key usage. 
│ │ │ │ -00029540: 2049 660a 2020 2020 206b 6579 2075 7361   If.     key usa
│ │ │ │ -00029550: 6765 2069 7320 302c 206e 6f20 6b65 7920  ge is 0, no key 
│ │ │ │ -00029560: 6465 7269 7661 7469 6f6e 2069 7320 7573  derivation is us
│ │ │ │ -00029570: 6564 2e20 2054 6865 204f 5554 2062 7566  ed.  The OUT buf
│ │ │ │ -00029580: 6665 7220 6d75 7374 2062 650a 2020 2020  fer must be.    
│ │ │ │ -00029590: 2064 6561 6c6c 6f63 6174 6564 2062 7920   deallocated by 
│ │ │ │ -000295a0: 7468 6520 6361 6c6c 6572 2e20 2049 6620  the caller.  If 
│ │ │ │ -000295b0: 4956 4f55 5420 6f72 2049 564f 5554 4c45  IVOUT or IVOUTLE
│ │ │ │ -000295c0: 4e20 6973 204e 554c 4c2c 2074 6865 0a20  N is NULL, the. 
│ │ │ │ -000295d0: 2020 2020 7570 6461 7465 6420 4956 2069      updated IV i
│ │ │ │ -000295e0: 7320 6e6f 7420 7361 7665 6420 616e 7977  s not saved anyw
│ │ │ │ -000295f0: 6865 7265 2e0a 0a20 2020 2020 4e6f 7465  here...     Note
│ │ │ │ -00029600: 2074 6861 7420 4445 4352 5950 5428 454e   that DECRYPT(EN
│ │ │ │ -00029610: 4352 5950 5428 6461 7461 2929 2064 6f65  CRYPT(data)) doe
│ │ │ │ -00029620: 7320 6e6f 7420 6e65 6365 7373 6172 696c  s not necessaril
│ │ │ │ -00029630: 7920 7969 656c 6420 6461 7461 0a20 2020  y yield data.   
│ │ │ │ -00029640: 2020 6578 6163 746c 792e 2020 536f 6d65    exactly.  Some
│ │ │ │ -00029650: 2065 6e63 7279 7074 696f 6e20 7479 7065   encryption type
│ │ │ │ -00029660: 7320 6164 6420 7061 6420 746f 206d 616b  s add pad to mak
│ │ │ │ -00029670: 6520 7468 6520 6461 7461 2066 6974 2069  e the data fit i
│ │ │ │ -00029680: 6e74 6f0a 2020 2020 2074 6865 2062 6c6f  nto.     the blo
│ │ │ │ -00029690: 636b 2073 697a 6520 6f66 2074 6865 2065  ck size of the e
│ │ │ │ -000296a0: 6e63 7279 7074 696f 6e20 616c 676f 7269  ncryption algori
│ │ │ │ -000296b0: 7468 6d2e 2020 4675 7274 6865 726d 6f72  thm.  Furthermor
│ │ │ │ -000296c0: 652c 2074 6865 2070 6164 0a20 2020 2020  e, the pad.     
│ │ │ │ -000296d0: 6973 206e 6f74 2067 7561 7261 6e74 6565  is not guarantee
│ │ │ │ -000296e0: 6420 746f 206c 6f6f 6b20 696e 2061 6e79  d to look in any
│ │ │ │ -000296f0: 2073 7065 6369 616c 2077 6179 2c20 616c   special way, al
│ │ │ │ -00029700: 7468 6f75 6768 2065 7869 7374 696e 670a  though existing.
│ │ │ │ -00029710: 2020 2020 2069 6d70 6c65 6d65 6e74 6174       implementat
│ │ │ │ -00029720: 696f 6e73 206f 6674 656e 2070 6164 2077  ions often pad w
│ │ │ │ -00029730: 6974 6820 7468 6520 7a65 726f 2062 7974  ith the zero byt
│ │ │ │ -00029740: 652e 2020 5468 6973 206d 6561 6e73 2074  e.  This means t
│ │ │ │ -00029750: 6861 7420 796f 750a 2020 2020 206d 6179  hat you.     may
│ │ │ │ -00029760: 2068 6176 6520 746f 2022 6672 616d 6522   have to "frame"
│ │ │ │ -00029770: 2064 6174 612c 2073 6f20 6974 2069 7320   data, so it is 
│ │ │ │ -00029780: 706f 7373 6962 6c65 2074 6f20 696e 6665  possible to infe
│ │ │ │ -00029790: 7220 7468 6520 6f72 6967 696e 616c 0a20  r the original. 
│ │ │ │ -000297a0: 2020 2020 6c65 6e67 7468 2061 6674 6572      length after
│ │ │ │ -000297b0: 2064 6563 7279 7074 696f 6e2e 2020 436f   decryption.  Co
│ │ │ │ -000297c0: 6d70 6172 6520 4153 4e2e 3120 4445 5220  mpare ASN.1 DER 
│ │ │ │ -000297d0: 7768 6963 6820 636f 6e74 6169 6e73 2073  which contains s
│ │ │ │ -000297e0: 7563 680a 2020 2020 2069 6e66 6f72 6d61  uch.     informa
│ │ │ │ -000297f0: 7469 6f6e 2e0a 0a20 2020 2020 2a52 6574  tion...     *Ret
│ │ │ │ -00029800: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ -00029810: 726e 7320 e280 9853 4849 5348 495f 4f4b  rns ...SHISHI_OK
│ │ │ │ -00029820: e280 9920 6966 6620 7375 6363 6573 7366  ... iff successf
│ │ │ │ -00029830: 756c 2e0a 0a73 6869 7368 695f 6465 6372  ul...shishi_decr
│ │ │ │ -00029840: 7970 745f 6976 0a2d 2d2d 2d2d 2d2d 2d2d  ypt_iv.---------
│ │ │ │ -00029850: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -00029860: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ -00029870: 6869 5f64 6563 7279 7074 5f69 7620 2853  hi_decrypt_iv (S
│ │ │ │ -00029880: 6869 7368 6920 2a20 4841 4e44 4c45 2c20  hishi * HANDLE, 
│ │ │ │ -00029890: 5368 6973 6869 5f6b 6579 202a 204b 4559  Shishi_key * KEY
│ │ │ │ -000298a0: 2c0a 2020 2020 2020 2020 2020 696e 7420  ,.          int 
│ │ │ │ -000298b0: 4b45 5955 5341 4745 2c20 636f 6e73 7420  KEYUSAGE, const 
│ │ │ │ -000298c0: 6368 6172 202a 2049 562c 2073 697a 655f  char * IV, size_
│ │ │ │ -000298d0: 7420 4956 4c45 4e2c 2063 6f6e 7374 2063  t IVLEN, const c
│ │ │ │ -000298e0: 6861 7220 2a20 494e 2c0a 2020 2020 2020  har * IN,.      
│ │ │ │ -000298f0: 2020 2020 7369 7a65 5f74 2049 4e4c 454e      size_t INLEN
│ │ │ │ -00029900: 2c20 6368 6172 202a 2a20 4f55 542c 2073  , char ** OUT, s
│ │ │ │ -00029910: 697a 655f 7420 2a20 4f55 544c 454e 290a  ize_t * OUTLEN).
│ │ │ │ -00029920: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ -00029930: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ -00029940: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ -00029950: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ -00029960: 2020 2020 204b 4559 3a20 6b65 7920 746f       KEY: key to
│ │ │ │ -00029970: 2064 6563 7279 7074 2077 6974 682e 0a20   decrypt with.. 
│ │ │ │ -00029980: 2020 2020 4b45 5955 5341 4745 3a20 696e      KEYUSAGE: in
│ │ │ │ -00029990: 7465 6765 7220 7370 6563 6966 7969 6e67  teger specifying
│ │ │ │ -000299a0: 2077 6861 7420 7468 6973 206b 6579 2069   what this key i
│ │ │ │ -000299b0: 7320 6465 6372 7970 7469 6e67 2e0a 2020  s decrypting..  
│ │ │ │ -000299c0: 2020 2049 563a 2069 6e70 7574 2061 7272     IV: input arr
│ │ │ │ -000299d0: 6179 2077 6974 6820 696e 6974 6961 6c69  ay with initiali
│ │ │ │ -000299e0: 7a61 7469 6f6e 2076 6563 746f 720a 2020  zation vector.  
│ │ │ │ -000299f0: 2020 2049 564c 454e 3a20 7369 7a65 206f     IVLEN: size o
│ │ │ │ -00029a00: 6620 696e 7075 7420 6172 7261 7920 7769  f input array wi
│ │ │ │ -00029a10: 7468 2069 6e69 7469 616c 697a 6174 696f  th initializatio
│ │ │ │ -00029a20: 6e20 7665 6374 6f72 2e0a 2020 2020 2049  n vector..     I
│ │ │ │ -00029a30: 4e3a 2069 6e70 7574 2061 7272 6179 2077  N: input array w
│ │ │ │ -00029a40: 6974 6820 6461 7461 2074 6f20 6465 6372  ith data to decr
│ │ │ │ -00029a50: 7970 742e 0a20 2020 2020 494e 4c45 4e3a  ypt..     INLEN:
│ │ │ │ -00029a60: 2073 697a 6520 6f66 2069 6e70 7574 2061   size of input a
│ │ │ │ -00029a70: 7272 6179 2077 6974 6820 6461 7461 2074  rray with data t
│ │ │ │ -00029a80: 6f20 6465 6372 7970 742e 0a20 2020 2020  o decrypt..     
│ │ │ │ -00029a90: 4f55 543a 206f 7574 7075 7420 6172 7261  OUT: output arra
│ │ │ │ -00029aa0: 7920 7769 7468 206e 6577 6c79 2061 6c6c  y with newly all
│ │ │ │ -00029ab0: 6f63 6174 6564 2064 6563 7279 7074 6564  ocated decrypted
│ │ │ │ -00029ac0: 2064 6174 612e 0a20 2020 2020 4f55 544c   data..     OUTL
│ │ │ │ -00029ad0: 454e 3a20 6f75 7470 7574 2076 6172 6961  EN: output varia
│ │ │ │ -00029ae0: 626c 6520 7769 7468 2073 697a 6520 6f66  ble with size of
│ │ │ │ -00029af0: 206e 6577 6c79 2061 6c6c 6f63 6174 6564   newly allocated
│ │ │ │ -00029b00: 206f 7574 7075 7420 6172 7261 792e 0a0a   output array...
│ │ │ │ -00029b10: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ -00029b20: 6e3a 2a20 4465 6372 7970 7473 2064 6174  n:* Decrypts dat
│ │ │ │ -00029b30: 6120 7573 696e 6720 7370 6563 6966 6965  a using specifie
│ │ │ │ -00029b40: 6420 696e 6974 6961 6c69 7a61 7469 6f6e  d initialization
│ │ │ │ -00029b50: 2076 6563 746f 720a 2020 2020 2061 6e64   vector.     and
│ │ │ │ -00029b60: 206b 6579 2e20 2054 6865 206b 6579 2061   key.  The key a
│ │ │ │ -00029b70: 6374 7561 6c6c 7920 7573 6564 2069 7320  ctually used is 
│ │ │ │ -00029b80: 6465 7269 7665 6420 7573 696e 6720 7468  derived using th
│ │ │ │ -00029b90: 6520 6b65 7920 7573 6167 652e 2020 4966  e key usage.  If
│ │ │ │ -00029ba0: 0a20 2020 2020 6b65 7920 7573 6167 6520  .     key usage 
│ │ │ │ -00029bb0: 6973 2030 2c20 6e6f 206b 6579 2064 6572  is 0, no key der
│ │ │ │ -00029bc0: 6976 6174 696f 6e20 6973 2075 7365 642e  ivation is used.
│ │ │ │ -00029bd0: 2020 5468 6520 4f55 5420 6275 6666 6572    The OUT buffer
│ │ │ │ -00029be0: 206d 7573 7420 6265 0a20 2020 2020 6465   must be.     de
│ │ │ │ -00029bf0: 616c 6c6f 6361 7465 6420 6279 2074 6865  allocated by the
│ │ │ │ -00029c00: 2063 616c 6c65 722e 2020 5468 6520 6e65   caller.  The ne
│ │ │ │ -00029c10: 7874 2049 5620 6973 206c 6f73 742c 2073  xt IV is lost, s
│ │ │ │ -00029c20: 6565 0a20 2020 2020 7368 6973 6869 5f64  ee.     shishi_d
│ │ │ │ -00029c30: 6563 7279 7074 5f69 7675 7064 6174 655f  ecrypt_ivupdate_
│ │ │ │ -00029c40: 6574 7970 6520 6966 2079 6f75 206e 6565  etype if you nee
│ │ │ │ -00029c50: 6420 6974 2e0a 0a20 2020 2020 4e6f 7465  d it...     Note
│ │ │ │ -00029c60: 2074 6861 7420 4445 4352 5950 5428 454e   that DECRYPT(EN
│ │ │ │ -00029c70: 4352 5950 5428 6461 7461 2929 2064 6f65  CRYPT(data)) doe
│ │ │ │ -00029c80: 7320 6e6f 7420 6e65 6365 7373 6172 696c  s not necessaril
│ │ │ │ -00029c90: 7920 7969 656c 6420 6461 7461 0a20 2020  y yield data.   
│ │ │ │ -00029ca0: 2020 6578 6163 746c 792e 2020 536f 6d65    exactly.  Some
│ │ │ │ -00029cb0: 2065 6e63 7279 7074 696f 6e20 7479 7065   encryption type
│ │ │ │ -00029cc0: 7320 6164 6420 7061 6420 746f 206d 616b  s add pad to mak
│ │ │ │ -00029cd0: 6520 7468 6520 6461 7461 2066 6974 2069  e the data fit i
│ │ │ │ -00029ce0: 6e74 6f0a 2020 2020 2074 6865 2062 6c6f  nto.     the blo
│ │ │ │ -00029cf0: 636b 2073 697a 6520 6f66 2074 6865 2065  ck size of the e
│ │ │ │ -00029d00: 6e63 7279 7074 696f 6e20 616c 676f 7269  ncryption algori
│ │ │ │ -00029d10: 7468 6d2e 2020 4675 7274 6865 726d 6f72  thm.  Furthermor
│ │ │ │ -00029d20: 652c 2074 6865 2070 6164 0a20 2020 2020  e, the pad.     
│ │ │ │ -00029d30: 6973 206e 6f74 2067 7561 7261 6e74 6565  is not guarantee
│ │ │ │ -00029d40: 6420 746f 206c 6f6f 6b20 696e 2061 6e79  d to look in any
│ │ │ │ -00029d50: 2073 7065 6369 616c 2077 6179 2c20 616c   special way, al
│ │ │ │ -00029d60: 7468 6f75 6768 2065 7869 7374 696e 670a  though existing.
│ │ │ │ -00029d70: 2020 2020 2069 6d70 6c65 6d65 6e74 6174       implementat
│ │ │ │ -00029d80: 696f 6e73 206f 6674 656e 2070 6164 2077  ions often pad w
│ │ │ │ -00029d90: 6974 6820 7468 6520 7a65 726f 2062 7974  ith the zero byt
│ │ │ │ -00029da0: 652e 2020 5468 6973 206d 6561 6e73 2074  e.  This means t
│ │ │ │ -00029db0: 6861 7420 796f 750a 2020 2020 206d 6179  hat you.     may
│ │ │ │ -00029dc0: 2068 6176 6520 746f 2022 6672 616d 6522   have to "frame"
│ │ │ │ -00029dd0: 2064 6174 612c 2073 6f20 6974 2069 7320   data, so it is 
│ │ │ │ -00029de0: 706f 7373 6962 6c65 2074 6f20 696e 6665  possible to infe
│ │ │ │ -00029df0: 7220 7468 6520 6f72 6967 696e 616c 0a20  r the original. 
│ │ │ │ -00029e00: 2020 2020 6c65 6e67 7468 2061 6674 6572      length after
│ │ │ │ -00029e10: 2064 6563 7279 7074 696f 6e2e 2020 436f   decryption.  Co
│ │ │ │ -00029e20: 6d70 6172 6520 4153 4e2e 3120 4445 5220  mpare ASN.1 DER 
│ │ │ │ -00029e30: 7768 6963 6820 636f 6e74 6169 6e73 2073  which contains s
│ │ │ │ -00029e40: 7563 680a 2020 2020 2069 6e66 6f72 6d61  uch.     informa
│ │ │ │ -00029e50: 7469 6f6e 2e0a 0a20 2020 2020 2a52 6574  tion...     *Ret
│ │ │ │ -00029e60: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ -00029e70: 726e 7320 e280 9853 4849 5348 495f 4f4b  rns ...SHISHI_OK
│ │ │ │ -00029e80: e280 9920 6966 6620 7375 6363 6573 7366  ... iff successf
│ │ │ │ -00029e90: 756c 2e0a 0a73 6869 7368 695f 6465 6372  ul...shishi_decr
│ │ │ │ -00029ea0: 7970 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ypt.------------
│ │ │ │ -00029eb0: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ -00029ec0: 3a20 696e 7420 7368 6973 6869 5f64 6563  : int shishi_dec
│ │ │ │ -00029ed0: 7279 7074 2028 5368 6973 6869 202a 2048  rypt (Shishi * H
│ │ │ │ -00029ee0: 414e 444c 452c 2053 6869 7368 695f 6b65  ANDLE, Shishi_ke
│ │ │ │ -00029ef0: 7920 2a20 4b45 592c 0a20 2020 2020 2020  y * KEY,.       
│ │ │ │ -00029f00: 2020 2069 6e74 204b 4559 5553 4147 452c     int KEYUSAGE,
│ │ │ │ -00029f10: 2063 6f6e 7374 2063 6861 7220 2a20 494e   const char * IN
│ │ │ │ -00029f20: 2c20 7369 7a65 5f74 2049 4e4c 454e 2c20  , size_t INLEN, 
│ │ │ │ -00029f30: 6368 6172 202a 2a20 4f55 542c 0a20 2020  char ** OUT,.   
│ │ │ │ -00029f40: 2020 2020 2020 2073 697a 655f 7420 2a20         size_t * 
│ │ │ │ -00029f50: 4f55 544c 454e 290a 2020 2020 2048 414e  OUTLEN).     HAN
│ │ │ │ -00029f60: 444c 453a 2073 6869 7368 6920 6861 6e64  DLE: shishi hand
│ │ │ │ -00029f70: 6c65 2061 7320 616c 6c6f 6361 7465 6420  le as allocated 
│ │ │ │ -00029f80: 6279 20e2 8098 7368 6973 6869 5f69 6e69  by ...shishi_ini
│ │ │ │ -00029f90: 7428 29e2 8099 2e0a 2020 2020 204b 4559  t().....     KEY
│ │ │ │ -00029fa0: 3a20 6b65 7920 746f 2064 6563 7279 7074  : key to decrypt
│ │ │ │ -00029fb0: 2077 6974 682e 0a20 2020 2020 4b45 5955   with..     KEYU
│ │ │ │ -00029fc0: 5341 4745 3a20 696e 7465 6765 7220 7370  SAGE: integer sp
│ │ │ │ -00029fd0: 6563 6966 7969 6e67 2077 6861 7420 7468  ecifying what th
│ │ │ │ -00029fe0: 6973 206b 6579 2069 7320 6465 6372 7970  is key is decryp
│ │ │ │ -00029ff0: 7469 6e67 2e0a 2020 2020 2049 4e3a 2069  ting..     IN: i
│ │ │ │ -0002a000: 6e70 7574 2061 7272 6179 2077 6974 6820  nput array with 
│ │ │ │ -0002a010: 6461 7461 2074 6f20 6465 6372 7970 742e  data to decrypt.
│ │ │ │ -0002a020: 0a20 2020 2020 494e 4c45 4e3a 2073 697a  .     INLEN: siz
│ │ │ │ -0002a030: 6520 6f66 2069 6e70 7574 2061 7272 6179  e of input array
│ │ │ │ -0002a040: 2077 6974 6820 6461 7461 2074 6f20 6465   with data to de
│ │ │ │ -0002a050: 6372 7970 742e 0a20 2020 2020 4f55 543a  crypt..     OUT:
│ │ │ │ -0002a060: 206f 7574 7075 7420 6172 7261 7920 7769   output array wi
│ │ │ │ -0002a070: 7468 206e 6577 6c79 2061 6c6c 6f63 6174  th newly allocat
│ │ │ │ -0002a080: 6564 2064 6563 7279 7074 6564 2064 6174  ed decrypted dat
│ │ │ │ -0002a090: 612e 0a20 2020 2020 4f55 544c 454e 3a20  a..     OUTLEN: 
│ │ │ │ -0002a0a0: 6f75 7470 7574 2076 6172 6961 626c 6520  output variable 
│ │ │ │ -0002a0b0: 7769 7468 2073 697a 6520 6f66 206e 6577  with size of new
│ │ │ │ -0002a0c0: 6c79 2061 6c6c 6f63 6174 6564 206f 7574  ly allocated out
│ │ │ │ -0002a0d0: 7075 7420 6172 7261 792e 0a0a 2020 2020  put array...    
│ │ │ │ -0002a0e0: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ -0002a0f0: 4465 6372 7970 7473 2064 6174 6120 7370  Decrypts data sp
│ │ │ │ -0002a100: 6563 6966 6965 6420 6b65 792e 2020 5468  ecified key.  Th
│ │ │ │ -0002a110: 6520 6b65 7920 6163 7475 616c 6c79 2075  e key actually u
│ │ │ │ -0002a120: 7365 640a 2020 2020 2069 7320 6465 7269  sed.     is deri
│ │ │ │ -0002a130: 7665 6420 7573 696e 6720 7468 6520 6b65  ved using the ke
│ │ │ │ -0002a140: 7920 7573 6167 652e 2020 4966 206b 6579  y usage.  If key
│ │ │ │ -0002a150: 2075 7361 6765 2069 7320 302c 206e 6f20   usage is 0, no 
│ │ │ │ -0002a160: 6b65 790a 2020 2020 2064 6572 6976 6174  key.     derivat
│ │ │ │ -0002a170: 696f 6e20 6973 2075 7365 642e 2020 5468  ion is used.  Th
│ │ │ │ -0002a180: 6520 4f55 5420 6275 6666 6572 206d 7573  e OUT buffer mus
│ │ │ │ -0002a190: 7420 6265 2064 6561 6c6c 6f63 6174 6564  t be deallocated
│ │ │ │ -0002a1a0: 2062 7920 7468 650a 2020 2020 2063 616c   by the.     cal
│ │ │ │ -0002a1b0: 6c65 722e 2020 5468 6520 6465 6661 756c  ler.  The defaul
│ │ │ │ -0002a1c0: 7420 4956 2069 7320 7573 6564 2c20 7365  t IV is used, se
│ │ │ │ -0002a1d0: 6520 7368 6973 6869 5f64 6563 7279 7074  e shishi_decrypt
│ │ │ │ -0002a1e0: 5f69 7620 6966 2079 6f75 206e 6565 640a  _iv if you need.
│ │ │ │ -0002a1f0: 2020 2020 2074 6f20 616c 7465 7220 6974       to alter it
│ │ │ │ -0002a200: 2e20 2054 6865 206e 6578 7420 4956 2069  .  The next IV i
│ │ │ │ -0002a210: 7320 6c6f 7374 2c20 7365 6520 7368 6973  s lost, see shis
│ │ │ │ -0002a220: 6869 5f64 6563 7279 7074 5f69 7675 7064  hi_decrypt_ivupd
│ │ │ │ -0002a230: 6174 6520 6966 0a20 2020 2020 796f 7520  ate if.     you 
│ │ │ │ -0002a240: 6e65 6564 2069 742e 0a0a 2020 2020 204e  need it...     N
│ │ │ │ -0002a250: 6f74 6520 7468 6174 2044 4543 5259 5054  ote that DECRYPT
│ │ │ │ -0002a260: 2845 4e43 5259 5054 2864 6174 6129 2920  (ENCRYPT(data)) 
│ │ │ │ -0002a270: 646f 6573 206e 6f74 206e 6563 6573 7361  does not necessa
│ │ │ │ -0002a280: 7269 6c79 2079 6965 6c64 2064 6174 610a  rily yield data.
│ │ │ │ -0002a290: 2020 2020 2065 7861 6374 6c79 2e20 2053       exactly.  S
│ │ │ │ -0002a2a0: 6f6d 6520 656e 6372 7970 7469 6f6e 2074  ome encryption t
│ │ │ │ -0002a2b0: 7970 6573 2061 6464 2070 6164 2074 6f20  ypes add pad to 
│ │ │ │ -0002a2c0: 6d61 6b65 2074 6865 2064 6174 6120 6669  make the data fi
│ │ │ │ -0002a2d0: 7420 696e 746f 0a20 2020 2020 7468 6520  t into.     the 
│ │ │ │ -0002a2e0: 626c 6f63 6b20 7369 7a65 206f 6620 7468  block size of th
│ │ │ │ -0002a2f0: 6520 656e 6372 7970 7469 6f6e 2061 6c67  e encryption alg
│ │ │ │ -0002a300: 6f72 6974 686d 2e20 2046 7572 7468 6572  orithm.  Further
│ │ │ │ -0002a310: 6d6f 7265 2c20 7468 6520 7061 640a 2020  more, the pad.  
│ │ │ │ -0002a320: 2020 2069 7320 6e6f 7420 6775 6172 616e     is not guaran
│ │ │ │ -0002a330: 7465 6564 2074 6f20 6c6f 6f6b 2069 6e20  teed to look in 
│ │ │ │ -0002a340: 616e 7920 7370 6563 6961 6c20 7761 792c  any special way,
│ │ │ │ -0002a350: 2061 6c74 686f 7567 6820 6578 6973 7469   although existi
│ │ │ │ -0002a360: 6e67 0a20 2020 2020 696d 706c 656d 656e  ng.     implemen
│ │ │ │ -0002a370: 7461 7469 6f6e 7320 6f66 7465 6e20 7061  tations often pa
│ │ │ │ -0002a380: 6420 7769 7468 2074 6865 207a 6572 6f20  d with the zero 
│ │ │ │ -0002a390: 6279 7465 2e20 2054 6869 7320 6d65 616e  byte.  This mean
│ │ │ │ -0002a3a0: 7320 7468 6174 2079 6f75 0a20 2020 2020  s that you.     
│ │ │ │ -0002a3b0: 6d61 7920 6861 7665 2074 6f20 2266 7261  may have to "fra
│ │ │ │ -0002a3c0: 6d65 2220 6461 7461 2c20 736f 2069 7420  me" data, so it 
│ │ │ │ -0002a3d0: 6973 2070 6f73 7369 626c 6520 746f 2069  is possible to i
│ │ │ │ -0002a3e0: 6e66 6572 2074 6865 206f 7269 6769 6e61  nfer the origina
│ │ │ │ -0002a3f0: 6c0a 2020 2020 206c 656e 6774 6820 6166  l.     length af
│ │ │ │ -0002a400: 7465 7220 6465 6372 7970 7469 6f6e 2e20  ter decryption. 
│ │ │ │ -0002a410: 2043 6f6d 7061 7265 2041 534e 2e31 2044   Compare ASN.1 D
│ │ │ │ -0002a420: 4552 2077 6869 6368 2063 6f6e 7461 696e  ER which contain
│ │ │ │ -0002a430: 7320 7375 6368 0a20 2020 2020 696e 666f  s such.     info
│ │ │ │ -0002a440: 726d 6174 696f 6e2e 0a0a 2020 2020 202a  rmation...     *
│ │ │ │ -0002a450: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ -0002a460: 6574 7572 6e73 20e2 8098 5348 4953 4849  eturns ...SHISHI
│ │ │ │ -0002a470: 5f4f 4be2 8099 2069 6666 2073 7563 6365  _OK... iff succe
│ │ │ │ -0002a480: 7373 6675 6c2e 0a0a 7368 6973 6869 5f6e  ssful...shishi_n
│ │ │ │ -0002a490: 5f66 6f6c 640a 2d2d 2d2d 2d2d 2d2d 2d2d  _fold.----------
│ │ │ │ -0002a4a0: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ -0002a4b0: 6e3a 2069 6e74 2073 6869 7368 695f 6e5f  n: int shishi_n_
│ │ │ │ -0002a4c0: 666f 6c64 2028 5368 6973 6869 202a 2048  fold (Shishi * H
│ │ │ │ -0002a4d0: 414e 444c 452c 2063 6f6e 7374 2063 6861  ANDLE, const cha
│ │ │ │ -0002a4e0: 7220 2a20 494e 2c0a 2020 2020 2020 2020  r * IN,.        
│ │ │ │ -0002a4f0: 2020 7369 7a65 5f74 2049 4e4c 454e 2c20    size_t INLEN, 
│ │ │ │ -0002a500: 6368 6172 202a 204f 5554 2c20 7369 7a65  char * OUT, size
│ │ │ │ -0002a510: 5f74 204f 5554 4c45 4e29 0a20 2020 2020  _t OUTLEN).     
│ │ │ │ -0002a520: 4841 4e44 4c45 3a20 7368 6973 6869 2068  HANDLE: shishi h
│ │ │ │ -0002a530: 616e 646c 6520 6173 2061 6c6c 6f63 6174  andle as allocat
│ │ │ │ -0002a540: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ -0002a550: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ -0002a560: 494e 3a20 696e 7075 7420 6172 7261 7920  IN: input array 
│ │ │ │ -0002a570: 7769 7468 2064 6174 6120 746f 2064 6563  with data to dec
│ │ │ │ -0002a580: 7279 7074 2e0a 2020 2020 2049 4e4c 454e  rypt..     INLEN
│ │ │ │ -0002a590: 3a20 7369 7a65 206f 6620 696e 7075 7420  : size of input 
│ │ │ │ -0002a5a0: 6172 7261 7920 7769 7468 2064 6174 6120  array with data 
│ │ │ │ -0002a5b0: 746f 2064 6563 7279 7074 2028 224d 2229  to decrypt ("M")
│ │ │ │ -0002a5c0: 2e0a 2020 2020 204f 5554 3a20 6f75 7470  ..     OUT: outp
│ │ │ │ -0002a5d0: 7574 2061 7272 6179 2077 6974 6820 6465  ut array with de
│ │ │ │ -0002a5e0: 6372 7970 7465 6420 6461 7461 2e0a 2020  crypted data..  
│ │ │ │ -0002a5f0: 2020 204f 5554 4c45 4e3a 2073 697a 6520     OUTLEN: size 
│ │ │ │ -0002a600: 6f66 206f 7574 7075 7420 6172 7261 7920  of output array 
│ │ │ │ -0002a610: 2822 4e22 292e 0a0a 2020 2020 202a 4465  ("N")...     *De
│ │ │ │ -0002a620: 7363 7269 7074 696f 6e3a 2a20 466f 6c64  scription:* Fold
│ │ │ │ -0002a630: 2064 6174 6120 696e 746f 2061 2066 6978   data into a fix
│ │ │ │ -0002a640: 6564 206c 656e 6774 6820 6f75 7470 7574  ed length output
│ │ │ │ -0002a650: 2061 7272 6179 2c20 7769 7468 2074 6865   array, with the
│ │ │ │ -0002a660: 0a20 2020 2020 696e 7465 6e74 2074 6f20  .     intent to 
│ │ │ │ -0002a670: 6769 7665 2065 6163 6820 696e 7075 7420  give each input 
│ │ │ │ -0002a680: 6269 7420 6170 7072 6f78 696d 6174 656c  bit approximatel
│ │ │ │ -0002a690: 7920 6571 7561 6c20 7765 6967 6874 2069  y equal weight i
│ │ │ │ -0002a6a0: 6e0a 2020 2020 2064 6574 6572 6d69 6e69  n.     determini
│ │ │ │ -0002a6b0: 6e67 2074 6865 2076 616c 7565 206f 6620  ng the value of 
│ │ │ │ -0002a6c0: 6561 6368 206f 7574 7075 7420 6269 742e  each output bit.
│ │ │ │ -0002a6d0: 0a0a 2020 2020 2054 6865 2061 6c67 6f72  ..     The algor
│ │ │ │ -0002a6e0: 6974 686d 2069 7320 6672 6f6d 2022 4120  ithm is from "A 
│ │ │ │ -0002a6f0: 4265 7474 6572 204b 6579 2053 6368 6564  Better Key Sched
│ │ │ │ -0002a700: 756c 6520 466f 7220 4445 532d 6c69 6b65  ule For DES-like
│ │ │ │ -0002a710: 2043 6970 6865 7273 220a 2020 2020 2062   Ciphers".     b
│ │ │ │ -0002a720: 7920 5572 6920 426c 756d 656e 7468 616c  y Uri Blumenthal
│ │ │ │ -0002a730: 2061 6e64 2053 7465 7665 6e20 4d2e 2042   and Steven M. B
│ │ │ │ -0002a740: 656c 6c6f 7669 6e2c 0a20 2020 2020 6874  ellovin,.     ht
│ │ │ │ -0002a750: 7470 3a2f 2f77 7777 2e72 6573 6561 7263  tp://www.researc
│ │ │ │ -0002a760: 682e 6174 742e 636f 6d2f 7e73 6d62 2f70  h.att.com/~smb/p
│ │ │ │ -0002a770: 6170 6572 732f 6964 6573 2e70 6466 2c20  apers/ides.pdf, 
│ │ │ │ -0002a780: 616c 7468 6f75 6768 2074 6865 0a20 2020  although the.   
│ │ │ │ -0002a790: 2020 7361 6d70 6c65 2076 6563 746f 7273    sample vectors
│ │ │ │ -0002a7a0: 2070 726f 7669 6465 6420 6279 2074 6865   provided by the
│ │ │ │ -0002a7b0: 2070 6170 6572 2061 7265 2069 6e63 6f72   paper are incor
│ │ │ │ -0002a7c0: 7265 6374 2e0a 0a20 2020 2020 2a52 6574  rect...     *Ret
│ │ │ │ -0002a7d0: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ -0002a7e0: 726e 7320 e280 9853 4849 5348 495f 4f4b  rns ...SHISHI_OK
│ │ │ │ -0002a7f0: e280 9920 6966 6620 7375 6363 6573 7366  ... iff successf
│ │ │ │ -0002a800: 756c 2e0a 0a73 6869 7368 695f 6472 0a2d  ul...shishi_dr.-
│ │ │ │ -0002a810: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -0002a820: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ -0002a830: 6869 5f64 7220 2853 6869 7368 6920 2a20  hi_dr (Shishi * 
│ │ │ │ -0002a840: 4841 4e44 4c45 2c20 5368 6973 6869 5f6b  HANDLE, Shishi_k
│ │ │ │ -0002a850: 6579 202a 204b 4559 2c0a 2020 2020 2020  ey * KEY,.      
│ │ │ │ -0002a860: 2020 2020 636f 6e73 7420 6368 6172 202a      const char *
│ │ │ │ -0002a870: 2050 5246 434f 4e53 5441 4e54 2c20 7369   PRFCONSTANT, si
│ │ │ │ -0002a880: 7a65 5f74 2050 5246 434f 4e53 5441 4e54  ze_t PRFCONSTANT
│ │ │ │ -0002a890: 4c45 4e2c 0a20 2020 2020 2020 2020 2063  LEN,.          c
│ │ │ │ -0002a8a0: 6861 7220 2a20 4445 5249 5645 4452 414e  har * DERIVEDRAN
│ │ │ │ -0002a8b0: 444f 4d2c 2073 697a 655f 7420 4445 5249  DOM, size_t DERI
│ │ │ │ -0002a8c0: 5645 4452 414e 444f 4d4c 454e 290a 2020  VEDRANDOMLEN).  
│ │ │ │ -0002a8d0: 2020 2048 414e 444c 453a 2073 6869 7368     HANDLE: shish
│ │ │ │ -0002a8e0: 6920 6861 6e64 6c65 2061 7320 616c 6c6f  i handle as allo
│ │ │ │ -0002a8f0: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ -0002a900: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ -0002a910: 2020 204b 4559 3a20 696e 7075 7420 6172     KEY: input ar
│ │ │ │ -0002a920: 7261 7920 7769 7468 2063 7279 7074 6f67  ray with cryptog
│ │ │ │ -0002a930: 7261 7068 6963 206b 6579 2074 6f20 7573  raphic key to us
│ │ │ │ -0002a940: 652e 0a20 2020 2020 5052 4643 4f4e 5354  e..     PRFCONST
│ │ │ │ -0002a950: 414e 543a 2069 6e70 7574 2061 7272 6179  ANT: input array
│ │ │ │ -0002a960: 2077 6974 6820 7468 6520 636f 6e73 7461   with the consta
│ │ │ │ -0002a970: 6e74 2073 7472 696e 672e 0a20 2020 2020  nt string..     
│ │ │ │ -0002a980: 5052 4643 4f4e 5354 414e 544c 454e 3a20  PRFCONSTANTLEN: 
│ │ │ │ -0002a990: 7369 7a65 206f 6620 696e 7075 7420 6172  size of input ar
│ │ │ │ -0002a9a0: 7261 7920 7769 7468 2074 6865 2063 6f6e  ray with the con
│ │ │ │ -0002a9b0: 7374 616e 7420 7374 7269 6e67 2e0a 2020  stant string..  
│ │ │ │ -0002a9c0: 2020 2044 4552 4956 4544 5241 4e44 4f4d     DERIVEDRANDOM
│ │ │ │ -0002a9d0: 3a20 6f75 7470 7574 2061 7272 6179 2077  : output array w
│ │ │ │ -0002a9e0: 6974 6820 6465 7269 7665 6420 7261 6e64  ith derived rand
│ │ │ │ -0002a9f0: 6f6d 2064 6174 612e 0a20 2020 2020 4445  om data..     DE
│ │ │ │ -0002aa00: 5249 5645 4452 414e 444f 4d4c 454e 3a20  RIVEDRANDOMLEN: 
│ │ │ │ -0002aa10: 7369 7a65 206f 6620 6f75 7470 7574 2061  size of output a
│ │ │ │ -0002aa20: 7272 6179 2077 6974 6820 6465 7269 7665  rray with derive
│ │ │ │ -0002aa30: 6420 7261 6e64 6f6d 2064 6174 612e 0a0a  d random data...
│ │ │ │ -0002aa40: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ -0002aa50: 6e3a 2a20 4465 7269 7665 2022 7261 6e64  n:* Derive "rand
│ │ │ │ -0002aa60: 6f6d 2220 6461 7461 2066 726f 6d20 6120  om" data from a 
│ │ │ │ -0002aa70: 6b65 7920 616e 6420 6120 636f 6e73 7461  key and a consta
│ │ │ │ -0002aa80: 6e74 0a20 2020 2020 7468 7573 6c79 3a20  nt.     thusly: 
│ │ │ │ -0002aa90: 4452 284b 4559 2c20 5052 4643 4f4e 5354  DR(KEY, PRFCONST
│ │ │ │ -0002aaa0: 414e 5429 203d 2054 5255 4e43 4154 4528  ANT) = TRUNCATE(
│ │ │ │ -0002aab0: 4445 5249 5645 4452 414e 444f 4d4c 454e  DERIVEDRANDOMLEN
│ │ │ │ -0002aac0: 2c0a 2020 2020 2053 4849 5348 495f 454e  ,.     SHISHI_EN
│ │ │ │ -0002aad0: 4352 5950 5428 4b45 592c 2050 5246 434f  CRYPT(KEY, PRFCO
│ │ │ │ -0002aae0: 4e53 5441 4e54 2929 2e0a 0a20 2020 2020  NSTANT))...     
│ │ │ │ -0002aaf0: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ -0002ab00: 5265 7475 726e 7320 e280 9853 4849 5348  Returns ...SHISH
│ │ │ │ -0002ab10: 495f 4f4b e280 9920 6966 6620 7375 6363  I_OK... iff succ
│ │ │ │ -0002ab20: 6573 7366 756c 2e0a 0a73 6869 7368 695f  essful...shishi_
│ │ │ │ -0002ab30: 646b 0a2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  dk.---------.. -
│ │ │ │ -0002ab40: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ -0002ab50: 7368 6973 6869 5f64 6b20 2853 6869 7368  shishi_dk (Shish
│ │ │ │ -0002ab60: 6920 2a20 4841 4e44 4c45 2c20 5368 6973  i * HANDLE, Shis
│ │ │ │ -0002ab70: 6869 5f6b 6579 202a 204b 4559 2c0a 2020  hi_key * KEY,.  
│ │ │ │ -0002ab80: 2020 2020 2020 2020 636f 6e73 7420 6368          const ch
│ │ │ │ -0002ab90: 6172 202a 2050 5246 434f 4e53 5441 4e54  ar * PRFCONSTANT
│ │ │ │ -0002aba0: 2c20 7369 7a65 5f74 2050 5246 434f 4e53  , size_t PRFCONS
│ │ │ │ -0002abb0: 5441 4e54 4c45 4e2c 0a20 2020 2020 2020  TANTLEN,.       
│ │ │ │ -0002abc0: 2020 2053 6869 7368 695f 6b65 7920 2a20     Shishi_key * 
│ │ │ │ -0002abd0: 4445 5249 5645 444b 4559 290a 2020 2020  DERIVEDKEY).    
│ │ │ │ -0002abe0: 2048 414e 444c 453a 2073 6869 7368 6920   HANDLE: shishi 
│ │ │ │ -0002abf0: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ -0002ac00: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ -0002ac10: 5f69 6e69 7428 29e2 8099 2e0a 2020 2020  _init().....    
│ │ │ │ -0002ac20: 204b 4559 3a20 696e 7075 7420 6372 7970   KEY: input cryp
│ │ │ │ -0002ac30: 746f 6772 6170 6869 6320 6b65 7920 746f  tographic key to
│ │ │ │ -0002ac40: 2075 7365 2e0a 2020 2020 2050 5246 434f   use..     PRFCO
│ │ │ │ -0002ac50: 4e53 5441 4e54 3a20 696e 7075 7420 6172  NSTANT: input ar
│ │ │ │ -0002ac60: 7261 7920 7769 7468 2074 6865 2063 6f6e  ray with the con
│ │ │ │ -0002ac70: 7374 616e 7420 7374 7269 6e67 2e0a 2020  stant string..  
│ │ │ │ -0002ac80: 2020 2050 5246 434f 4e53 5441 4e54 4c45     PRFCONSTANTLE
│ │ │ │ -0002ac90: 4e3a 2073 697a 6520 6f66 2069 6e70 7574  N: size of input
│ │ │ │ -0002aca0: 2061 7272 6179 2077 6974 6820 7468 6520   array with the 
│ │ │ │ -0002acb0: 636f 6e73 7461 6e74 2073 7472 696e 672e  constant string.
│ │ │ │ -0002acc0: 0a20 2020 2020 4445 5249 5645 444b 4559  .     DERIVEDKEY
│ │ │ │ -0002acd0: 3a20 706f 696e 7465 7220 746f 2064 6572  : pointer to der
│ │ │ │ -0002ace0: 6976 6564 206b 6579 2028 616c 6c6f 6361  ived key (alloca
│ │ │ │ -0002acf0: 7465 6420 6279 2063 616c 6c65 7229 2e0a  ted by caller)..
│ │ │ │ -0002ad00: 0a20 2020 2020 2a44 6572 6976 6520 6120  .     *Derive a 
│ │ │ │ -0002ad10: 6b65 7920 6672 6f6d 2061 206b 6579 2061  key from a key a
│ │ │ │ -0002ad20: 6e64 2061 2063 6f6e 7374 616e 7420 7468  nd a constant th
│ │ │ │ -0002ad30: 7573 6c79 3a2a 2044 4b28 4b45 592c 0a20  usly:* DK(KEY,. 
│ │ │ │ -0002ad40: 2020 2020 5052 4643 4f4e 5354 414e 5429      PRFCONSTANT)
│ │ │ │ -0002ad50: 203d 2053 4849 5348 495f 5241 4e44 4f4d   = SHISHI_RANDOM
│ │ │ │ -0002ad60: 2d54 4f2d 4b45 5928 5348 4953 4849 5f44  -TO-KEY(SHISHI_D
│ │ │ │ -0002ad70: 5228 4b45 592c 2050 5246 434f 4e53 5441  R(KEY, PRFCONSTA
│ │ │ │ -0002ad80: 4e54 2929 2e0a 0a20 2020 2020 2a52 6574  NT))...     *Ret
│ │ │ │ -0002ad90: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ -0002ada0: 726e 7320 e280 9853 4849 5348 495f 4f4b  rns ...SHISHI_OK
│ │ │ │ -0002adb0: e280 9920 6966 6620 7375 6363 6573 7366  ... iff successf
│ │ │ │ -0002adc0: 756c 2e0a 0a20 2020 416e 2065 6173 6965  ul...   An easie
│ │ │ │ -0002add0: 7220 7761 7920 746f 2075 7365 2065 6e63  r way to use enc
│ │ │ │ -0002ade0: 7279 7074 696f 6e20 616e 6420 6465 6372  ryption and decr
│ │ │ │ -0002adf0: 7970 7469 6f6e 2069 6620 796f 7572 2061  yption if your a
│ │ │ │ -0002ae00: 7070 6c69 6361 7469 6f6e 0a72 6570 6561  pplication.repea
│ │ │ │ -0002ae10: 7465 646c 7920 6361 6c6c 732c 2065 2e67  tedly calls, e.g
│ │ │ │ -0002ae20: 2e2c 20e2 8098 7368 6973 6869 5f65 6e63  ., ...shishi_enc
│ │ │ │ -0002ae30: 7279 7074 5f69 7675 7064 6174 65e2 8099  rypt_ivupdate...
│ │ │ │ -0002ae40: 2c20 6973 2074 6f20 7573 6520 7468 650a  , is to use the.
│ │ │ │ -0002ae50: 666f 6c6c 6f77 696e 6720 6675 6e63 7469  following functi
│ │ │ │ -0002ae60: 6f6e 732e 2020 5468 6579 2073 746f 7265  ons.  They store
│ │ │ │ -0002ae70: 2074 6865 206b 6579 2c20 696e 6974 6961   the key, initia
│ │ │ │ -0002ae80: 6c69 7a61 7469 6f6e 2076 6563 746f 722c  lization vector,
│ │ │ │ -0002ae90: 2065 7463 2c20 696e 0a61 2063 6f6e 7465   etc, in.a conte
│ │ │ │ -0002aea0: 7874 2c20 616e 6420 7468 6520 656e 6372  xt, and the encr
│ │ │ │ -0002aeb0: 7970 7469 6f6e 2061 6e64 2064 6563 7279  yption and decry
│ │ │ │ -0002aec0: 7074 696f 6e20 6f70 6572 6174 696f 6e73  ption operations
│ │ │ │ -0002aed0: 2075 7064 6174 6520 7468 6520 4956 0a77   update the IV.w
│ │ │ │ -0002aee0: 6974 6869 6e20 7468 6520 636f 6e74 6578  ithin the contex
│ │ │ │ -0002aef0: 7420 6175 746f 6d61 7469 6361 6c6c 792e  t automatically.
│ │ │ │ -0002af00: 0a0a 7368 6973 6869 5f63 7279 7074 6f0a  ..shishi_crypto.
│ │ │ │ -0002af10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -0002af20: 2d2d 2046 756e 6374 696f 6e3a 2053 6869  -- Function: Shi
│ │ │ │ -0002af30: 7368 695f 6372 7970 746f 202a 2073 6869  shi_crypto * shi
│ │ │ │ -0002af40: 7368 695f 6372 7970 746f 2028 5368 6973  shi_crypto (Shis
│ │ │ │ -0002af50: 6869 202a 2048 414e 444c 452c 0a20 2020  hi * HANDLE,.   
│ │ │ │ -0002af60: 2020 2020 2020 2053 6869 7368 695f 6b65         Shishi_ke
│ │ │ │ -0002af70: 7920 2a20 4b45 592c 2069 6e74 204b 4559  y * KEY, int KEY
│ │ │ │ -0002af80: 5553 4147 452c 2069 6e74 3332 5f74 2045  USAGE, int32_t E
│ │ │ │ -0002af90: 5459 5045 2c0a 2020 2020 2020 2020 2020  TYPE,.          
│ │ │ │ -0002afa0: 636f 6e73 7420 6368 6172 202a 2049 562c  const char * IV,
│ │ │ │ -0002afb0: 2073 697a 655f 7420 4956 4c45 4e29 0a20   size_t IVLEN). 
│ │ │ │ -0002afc0: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ -0002afd0: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ -0002afe0: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ -0002aff0: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ -0002b000: 2020 2020 4b45 593a 206b 6579 2074 6f20      KEY: key to 
│ │ │ │ -0002b010: 656e 6372 7970 7420 7769 7468 2e0a 2020  encrypt with..  
│ │ │ │ -0002b020: 2020 204b 4559 5553 4147 453a 2069 6e74     KEYUSAGE: int
│ │ │ │ -0002b030: 6567 6572 2073 7065 6369 6679 696e 6720  eger specifying 
│ │ │ │ -0002b040: 7768 6174 2074 6869 7320 6b65 7920 7769  what this key wi
│ │ │ │ -0002b050: 6c6c 2065 6e63 7279 7074 2f64 6563 7279  ll encrypt/decry
│ │ │ │ -0002b060: 7074 2e0a 2020 2020 2045 5459 5045 3a20  pt..     ETYPE: 
│ │ │ │ -0002b070: 696e 7465 6765 7220 7370 6563 6966 7969  integer specifyi
│ │ │ │ -0002b080: 6e67 2077 6861 7420 6369 7068 6572 2074  ng what cipher t
│ │ │ │ -0002b090: 6f20 7573 652e 0a20 2020 2020 4956 3a20  o use..     IV: 
│ │ │ │ -0002b0a0: 696e 7075 7420 6172 7261 7920 7769 7468  input array with
│ │ │ │ -0002b0b0: 2069 6e69 7469 616c 697a 6174 696f 6e20   initialization 
│ │ │ │ -0002b0c0: 7665 6374 6f72 0a20 2020 2020 4956 4c45  vector.     IVLE
│ │ │ │ -0002b0d0: 4e3a 2073 697a 6520 6f66 2069 6e70 7574  N: size of input
│ │ │ │ -0002b0e0: 2061 7272 6179 2077 6974 6820 696e 6974   array with init
│ │ │ │ -0002b0f0: 6961 6c69 7a61 7469 6f6e 2076 6563 746f  ialization vecto
│ │ │ │ -0002b100: 722e 0a0a 2020 2020 202a 4465 7363 7269  r...     *Descri
│ │ │ │ -0002b110: 7074 696f 6e3a 2a20 496e 6974 6961 6c69  ption:* Initiali
│ │ │ │ -0002b120: 7a65 2061 2063 7279 7074 6f20 636f 6e74  ze a crypto cont
│ │ │ │ -0002b130: 6578 742e 2020 5468 6973 2073 746f 7265  ext.  This store
│ │ │ │ -0002b140: 2061 206b 6579 2c0a 2020 2020 206b 6579   a key,.     key
│ │ │ │ -0002b150: 7573 6167 652c 2065 6e63 7279 7074 696f  usage, encryptio
│ │ │ │ -0002b160: 6e20 7479 7065 2061 6e64 2069 6e69 7469  n type and initi
│ │ │ │ -0002b170: 616c 697a 6174 696f 6e20 7665 6374 6f72  alization vector
│ │ │ │ -0002b180: 2069 6e20 6120 2263 6f6e 7465 7874 222c   in a "context",
│ │ │ │ -0002b190: 0a20 2020 2020 616e 6420 7468 6520 6361  .     and the ca
│ │ │ │ -0002b1a0: 6c6c 6572 2063 616e 2074 6865 6e20 7573  ller can then us
│ │ │ │ -0002b1b0: 6520 7468 6973 2063 6f6e 7465 7874 2074  e this context t
│ │ │ │ -0002b1c0: 6f20 7065 7266 6f72 6d20 656e 6372 7970  o perform encryp
│ │ │ │ -0002b1d0: 7469 6f6e 2076 6961 0a20 2020 2020 e280  tion via.     ..
│ │ │ │ -0002b1e0: 9873 6869 7368 695f 6372 7970 746f 5f65  .shishi_crypto_e
│ │ │ │ -0002b1f0: 6e63 7279 7074 2829 e280 9920 616e 6420  ncrypt()... and 
│ │ │ │ -0002b200: 6465 6372 7970 7469 6f6e 2076 6961 0a20  decryption via. 
│ │ │ │ -0002b210: 2020 2020 e280 9873 6869 7368 695f 6372      ...shishi_cr
│ │ │ │ -0002b220: 7970 746f 5f65 6e63 7279 7074 2829 e280  ypto_encrypt()..
│ │ │ │ -0002b230: 9920 7769 7468 6f75 7420 7375 7070 6c79  . without supply
│ │ │ │ -0002b240: 696e 6720 616c 6c20 7468 6f73 6520 6465  ing all those de
│ │ │ │ -0002b250: 7461 696c 730a 2020 2020 2061 6761 696e  tails.     again
│ │ │ │ -0002b260: 2e20 2054 6865 2066 756e 6374 696f 6e73  .  The functions
│ │ │ │ -0002b270: 2061 6c73 6f20 7461 6b65 7320 6361 7265   also takes care
│ │ │ │ -0002b280: 206f 6620 7072 6f70 6167 6174 696e 6720   of propagating 
│ │ │ │ -0002b290: 7468 6520 4956 2062 6574 7765 656e 0a20  the IV between. 
│ │ │ │ -0002b2a0: 2020 2020 6361 6c6c 732e 0a0a 2020 2020      calls...    
│ │ │ │ -0002b2b0: 2057 6865 6e20 7468 6520 6170 706c 6963   When the applic
│ │ │ │ -0002b2c0: 6174 696f 6e20 6e6f 206c 6f6e 6765 7220  ation no longer 
│ │ │ │ -0002b2d0: 6e65 6564 2074 6f20 7573 6520 7468 6520  need to use the 
│ │ │ │ -0002b2e0: 636f 6e74 6578 742c 2069 7420 7368 6f75  context, it shou
│ │ │ │ -0002b2f0: 6c64 0a20 2020 2020 6465 616c 6c6f 6361  ld.     dealloca
│ │ │ │ -0002b300: 7465 2072 6573 6f75 7263 6573 2061 7373  te resources ass
│ │ │ │ -0002b310: 6f63 6961 7465 6420 7769 7468 2069 7420  ociated with it 
│ │ │ │ -0002b320: 6279 2063 616c 6c69 6e67 0a20 2020 2020  by calling.     
│ │ │ │ -0002b330: e280 9873 6869 7368 695f 6372 7970 746f  ...shishi_crypto
│ │ │ │ -0002b340: 5f63 6c6f 7365 2829 e280 992e 0a0a 2020  _close()......  
│ │ │ │ -0002b350: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ -0002b360: 3a2a 2052 6574 7572 6e20 6120 6e65 776c  :* Return a newl
│ │ │ │ -0002b370: 7920 616c 6c6f 6361 7465 6420 6372 7970  y allocated cryp
│ │ │ │ -0002b380: 746f 2063 6f6e 7465 7874 2e0a 0a73 6869  to context...shi
│ │ │ │ -0002b390: 7368 695f 6372 7970 746f 5f65 6e63 7279  shi_crypto_encry
│ │ │ │ -0002b3a0: 7074 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  pt.-------------
│ │ │ │ -0002b3b0: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -0002b3c0: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ -0002b3d0: 6869 5f63 7279 7074 6f5f 656e 6372 7970  hi_crypto_encryp
│ │ │ │ -0002b3e0: 7420 2853 6869 7368 695f 6372 7970 746f  t (Shishi_crypto
│ │ │ │ -0002b3f0: 202a 2043 5458 2c0a 2020 2020 2020 2020   * CTX,.        
│ │ │ │ -0002b400: 2020 636f 6e73 7420 6368 6172 202a 2049    const char * I
│ │ │ │ -0002b410: 4e2c 2073 697a 655f 7420 494e 4c45 4e2c  N, size_t INLEN,
│ │ │ │ -0002b420: 2063 6861 7220 2a2a 204f 5554 2c20 7369   char ** OUT, si
│ │ │ │ -0002b430: 7a65 5f74 202a 204f 5554 4c45 4e29 0a20  ze_t * OUTLEN). 
│ │ │ │ -0002b440: 2020 2020 4354 583a 2063 7279 7074 6f20      CTX: crypto 
│ │ │ │ -0002b450: 636f 6e74 6578 7420 6173 2072 6574 7572  context as retur
│ │ │ │ -0002b460: 6e65 6420 6279 20e2 8098 7368 6973 6869  ned by ...shishi
│ │ │ │ -0002b470: 5f63 7279 7074 6f28 29e2 8099 2e0a 2020  _crypto().....  
│ │ │ │ -0002b480: 2020 2049 4e3a 2069 6e70 7574 2061 7272     IN: input arr
│ │ │ │ -0002b490: 6179 2077 6974 6820 6461 7461 2074 6f20  ay with data to 
│ │ │ │ -0002b4a0: 656e 6372 7970 742e 0a20 2020 2020 494e  encrypt..     IN
│ │ │ │ -0002b4b0: 4c45 4e3a 2073 697a 6520 6f66 2069 6e70  LEN: size of inp
│ │ │ │ -0002b4c0: 7574 2061 7272 6179 2077 6974 6820 6461  ut array with da
│ │ │ │ -0002b4d0: 7461 2074 6f20 656e 6372 7970 742e 0a20  ta to encrypt.. 
│ │ │ │ -0002b4e0: 2020 2020 4f55 543a 206f 7574 7075 7420      OUT: output 
│ │ │ │ -0002b4f0: 6172 7261 7920 7769 7468 206e 6577 6c79  array with newly
│ │ │ │ -0002b500: 2061 6c6c 6f63 6174 6564 2065 6e63 7279   allocated encry
│ │ │ │ -0002b510: 7074 6564 2064 6174 612e 0a20 2020 2020  pted data..     
│ │ │ │ -0002b520: 4f55 544c 454e 3a20 6f75 7470 7574 2076  OUTLEN: output v
│ │ │ │ -0002b530: 6172 6961 626c 6520 7769 7468 2073 697a  ariable with siz
│ │ │ │ -0002b540: 6520 6f66 206e 6577 6c79 2061 6c6c 6f63  e of newly alloc
│ │ │ │ -0002b550: 6174 6564 206f 7574 7075 7420 6172 7261  ated output arra
│ │ │ │ -0002b560: 792e 0a0a 2020 2020 202a 4465 7363 7269  y...     *Descri
│ │ │ │ -0002b570: 7074 696f 6e3a 2a20 456e 6372 7970 7420  ption:* Encrypt 
│ │ │ │ -0002b580: 6461 7461 2c20 7573 696e 6720 696e 666f  data, using info
│ │ │ │ -0002b590: 726d 6174 696f 6e20 2865 2e67 2e2c 206b  rmation (e.g., k
│ │ │ │ -0002b5a0: 6579 2061 6e64 0a20 2020 2020 696e 6974  ey and.     init
│ │ │ │ -0002b5b0: 6961 6c69 7a61 7469 6f6e 2076 6563 746f  ialization vecto
│ │ │ │ -0002b5c0: 7229 2066 726f 6d20 636f 6e74 6578 742e  r) from context.
│ │ │ │ -0002b5d0: 2020 5468 6520 4956 2069 7320 7570 6461    The IV is upda
│ │ │ │ -0002b5e0: 7465 6420 696e 7369 6465 2074 6865 0a20  ted inside the. 
│ │ │ │ -0002b5f0: 2020 2020 636f 6e74 6578 7420 6166 7465      context afte
│ │ │ │ -0002b600: 7220 7468 6973 2063 616c 6c2e 0a0a 2020  r this call...  
│ │ │ │ -0002b610: 2020 2057 6865 6e20 7468 6520 6170 706c     When the appl
│ │ │ │ -0002b620: 6963 6174 696f 6e20 6e6f 206c 6f6e 6765  ication no longe
│ │ │ │ -0002b630: 7220 6e65 6564 2074 6f20 7573 6520 7468  r need to use th
│ │ │ │ -0002b640: 6520 636f 6e74 6578 742c 2069 7420 7368  e context, it sh
│ │ │ │ -0002b650: 6f75 6c64 0a20 2020 2020 6465 616c 6c6f  ould.     deallo
│ │ │ │ -0002b660: 6361 7465 2072 6573 6f75 7263 6573 2061  cate resources a
│ │ │ │ -0002b670: 7373 6f63 6961 7465 6420 7769 7468 2069  ssociated with i
│ │ │ │ -0002b680: 7420 6279 2063 616c 6c69 6e67 0a20 2020  t by calling.   
│ │ │ │ -0002b690: 2020 e280 9873 6869 7368 695f 6372 7970    ...shishi_cryp
│ │ │ │ -0002b6a0: 746f 5f63 6c6f 7365 2829 e280 992e 0a0a  to_close()......
│ │ │ │ -0002b6b0: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ -0002b6c0: 7565 3a2a 2052 6574 7572 6e73 20e2 8098  ue:* Returns ...
│ │ │ │ -0002b6d0: 5348 4953 4849 5f4f 4be2 8099 2069 6666  SHISHI_OK... iff
│ │ │ │ -0002b6e0: 2073 7563 6365 7373 6675 6c2e 0a0a 7368   successful...sh
│ │ │ │ -0002b6f0: 6973 6869 5f63 7279 7074 6f5f 6465 6372  ishi_crypto_decr
│ │ │ │ -0002b700: 7970 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ypt.------------
│ │ │ │ -0002b710: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ -0002b720: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ -0002b730: 7368 695f 6372 7970 746f 5f64 6563 7279  shi_crypto_decry
│ │ │ │ -0002b740: 7074 2028 5368 6973 6869 5f63 7279 7074  pt (Shishi_crypt
│ │ │ │ -0002b750: 6f20 2a20 4354 582c 0a20 2020 2020 2020  o * CTX,.       
│ │ │ │ -0002b760: 2020 2063 6f6e 7374 2063 6861 7220 2a20     const char * 
│ │ │ │ -0002b770: 494e 2c20 7369 7a65 5f74 2049 4e4c 454e  IN, size_t INLEN
│ │ │ │ -0002b780: 2c20 6368 6172 202a 2a20 4f55 542c 2073  , char ** OUT, s
│ │ │ │ -0002b790: 697a 655f 7420 2a20 4f55 544c 454e 290a  ize_t * OUTLEN).
│ │ │ │ -0002b7a0: 2020 2020 2043 5458 3a20 6372 7970 746f       CTX: crypto
│ │ │ │ -0002b7b0: 2063 6f6e 7465 7874 2061 7320 7265 7475   context as retu
│ │ │ │ -0002b7c0: 726e 6564 2062 7920 e280 9873 6869 7368  rned by ...shish
│ │ │ │ -0002b7d0: 695f 6372 7970 746f 2829 e280 992e 0a20  i_crypto()..... 
│ │ │ │ -0002b7e0: 2020 2020 494e 3a20 696e 7075 7420 6172      IN: input ar
│ │ │ │ -0002b7f0: 7261 7920 7769 7468 2064 6174 6120 746f  ray with data to
│ │ │ │ -0002b800: 2064 6563 7279 7074 2e0a 2020 2020 2049   decrypt..     I
│ │ │ │ -0002b810: 4e4c 454e 3a20 7369 7a65 206f 6620 696e  NLEN: size of in
│ │ │ │ -0002b820: 7075 7420 6172 7261 7920 7769 7468 2064  put array with d
│ │ │ │ -0002b830: 6174 6120 746f 2064 6563 7279 7074 2e0a  ata to decrypt..
│ │ │ │ -0002b840: 2020 2020 204f 5554 3a20 6f75 7470 7574       OUT: output
│ │ │ │ -0002b850: 2061 7272 6179 2077 6974 6820 6e65 776c   array with newl
│ │ │ │ -0002b860: 7920 616c 6c6f 6361 7465 6420 6465 6372  y allocated decr
│ │ │ │ -0002b870: 7970 7465 6420 6461 7461 2e0a 2020 2020  ypted data..    
│ │ │ │ -0002b880: 204f 5554 4c45 4e3a 206f 7574 7075 7420   OUTLEN: output 
│ │ │ │ -0002b890: 7661 7269 6162 6c65 2077 6974 6820 7369  variable with si
│ │ │ │ -0002b8a0: 7a65 206f 6620 6e65 776c 7920 616c 6c6f  ze of newly allo
│ │ │ │ -0002b8b0: 6361 7465 6420 6f75 7470 7574 2061 7272  cated output arr
│ │ │ │ -0002b8c0: 6179 2e0a 0a20 2020 2020 2a44 6573 6372  ay...     *Descr
│ │ │ │ -0002b8d0: 6970 7469 6f6e 3a2a 2044 6563 7279 7074  iption:* Decrypt
│ │ │ │ -0002b8e0: 2064 6174 612c 2075 7369 6e67 2069 6e66   data, using inf
│ │ │ │ -0002b8f0: 6f72 6d61 7469 6f6e 2028 652e 672e 2c20  ormation (e.g., 
│ │ │ │ -0002b900: 6b65 7920 616e 640a 2020 2020 2069 6e69  key and.     ini
│ │ │ │ -0002b910: 7469 616c 697a 6174 696f 6e20 7665 6374  tialization vect
│ │ │ │ -0002b920: 6f72 2920 6672 6f6d 2063 6f6e 7465 7874  or) from context
│ │ │ │ -0002b930: 2e20 2054 6865 2049 5620 6973 2075 7064  .  The IV is upd
│ │ │ │ -0002b940: 6174 6564 2069 6e73 6964 6520 7468 650a  ated inside the.
│ │ │ │ -0002b950: 2020 2020 2063 6f6e 7465 7874 2061 6674       context aft
│ │ │ │ -0002b960: 6572 2074 6869 7320 6361 6c6c 2e0a 0a20  er this call... 
│ │ │ │ -0002b970: 2020 2020 5768 656e 2074 6865 2061 7070      When the app
│ │ │ │ -0002b980: 6c69 6361 7469 6f6e 206e 6f20 6c6f 6e67  lication no long
│ │ │ │ -0002b990: 6572 206e 6565 6420 746f 2075 7365 2074  er need to use t
│ │ │ │ -0002b9a0: 6865 2063 6f6e 7465 7874 2c20 6974 2073  he context, it s
│ │ │ │ -0002b9b0: 686f 756c 640a 2020 2020 2064 6561 6c6c  hould.     deall
│ │ │ │ -0002b9c0: 6f63 6174 6520 7265 736f 7572 6365 7320  ocate resources 
│ │ │ │ -0002b9d0: 6173 736f 6369 6174 6564 2077 6974 6820  associated with 
│ │ │ │ -0002b9e0: 6974 2062 7920 6361 6c6c 696e 670a 2020  it by calling.  
│ │ │ │ -0002b9f0: 2020 20e2 8098 7368 6973 6869 5f63 7279     ...shishi_cry
│ │ │ │ -0002ba00: 7074 6f5f 636c 6f73 6528 29e2 8099 2e0a  pto_close().....
│ │ │ │ -0002ba10: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ -0002ba20: 6c75 653a 2a20 5265 7475 726e 7320 e280  lue:* Returns ..
│ │ │ │ -0002ba30: 9853 4849 5348 495f 4f4b e280 9920 6966  .SHISHI_OK... if
│ │ │ │ -0002ba40: 6620 7375 6363 6573 7366 756c 2e0a 0a73  f successful...s
│ │ │ │ -0002ba50: 6869 7368 695f 6372 7970 746f 5f63 6c6f  hishi_crypto_clo
│ │ │ │ -0002ba60: 7365 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  se.-------------
│ │ │ │ -0002ba70: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ -0002ba80: 7469 6f6e 3a20 766f 6964 2073 6869 7368  tion: void shish
│ │ │ │ -0002ba90: 695f 6372 7970 746f 5f63 6c6f 7365 2028  i_crypto_close (
│ │ │ │ -0002baa0: 5368 6973 6869 5f63 7279 7074 6f20 2a20  Shishi_crypto * 
│ │ │ │ -0002bab0: 4354 5829 0a20 2020 2020 4354 583a 2063  CTX).     CTX: c
│ │ │ │ -0002bac0: 7279 7074 6f20 636f 6e74 6578 7420 6173  rypto context as
│ │ │ │ -0002bad0: 2072 6574 7572 6e65 6420 6279 20e2 8098   returned by ...
│ │ │ │ -0002bae0: 7368 6973 6869 5f63 7279 7074 6f28 29e2  shishi_crypto().
│ │ │ │ -0002baf0: 8099 2e0a 0a20 2020 2020 2a44 6573 6372  .....     *Descr
│ │ │ │ -0002bb00: 6970 7469 6f6e 3a2a 2044 6561 6c6c 6f63  iption:* Dealloc
│ │ │ │ -0002bb10: 6174 6520 7265 736f 7572 6365 7320 6173  ate resources as
│ │ │ │ -0002bb20: 736f 6369 6174 6564 2077 6974 6820 7468  sociated with th
│ │ │ │ -0002bb30: 6520 6372 7970 746f 0a20 2020 2020 636f  e crypto.     co
│ │ │ │ -0002bb40: 6e74 6578 742e 0a0a 2020 2041 6c73 6f20  ntext...   Also 
│ │ │ │ -0002bb50: 696e 636c 7564 6564 2069 6e20 5368 6973  included in Shis
│ │ │ │ -0002bb60: 6869 2069 7320 616e 2069 6e74 6572 6661  hi is an interfa
│ │ │ │ -0002bb70: 6365 2074 6f20 7468 6520 7265 616c 6c79  ce to the really
│ │ │ │ -0002bb80: 206c 6f77 2d6c 6576 656c 0a63 7279 7074   low-level.crypt
│ │ │ │ -0002bb90: 6f67 7261 7068 6963 2070 7269 6d69 7469  ographic primiti
│ │ │ │ -0002bba0: 7665 732e 2020 5468 6579 206d 6170 2064  ves.  They map d
│ │ │ │ -0002bbb0: 6972 6563 746c 7920 6f6e 2074 6865 2075  irectly on the u
│ │ │ │ -0002bbc0: 6e64 6572 6c79 696e 670a 6372 7970 746f  nderlying.crypto
│ │ │ │ -0002bbd0: 6772 6170 6869 6320 6c69 6272 6172 7920  graphic library 
│ │ │ │ -0002bbe0: 7573 6564 2028 692e 652e 2c20 476e 756c  used (i.e., Gnul
│ │ │ │ -0002bbf0: 6962 206f 7220 4c69 6267 6372 7970 7429  ib or Libgcrypt)
│ │ │ │ -0002bc00: 2061 6e64 2069 7320 7573 6564 0a69 6e74   and is used.int
│ │ │ │ -0002bc10: 6572 6e61 6c6c 7920 6279 2053 6869 7368  ernally by Shish
│ │ │ │ -0002bc20: 692e 0a0a 7368 6973 6869 5f72 616e 646f  i...shishi_rando
│ │ │ │ -0002bc30: 6d69 7a65 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  mize.-----------
│ │ │ │ -0002bc40: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ -0002bc50: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ -0002bc60: 7261 6e64 6f6d 697a 6520 2853 6869 7368  randomize (Shish
│ │ │ │ -0002bc70: 6920 2a20 4841 4e44 4c45 2c20 696e 7420  i * HANDLE, int 
│ │ │ │ -0002bc80: 5354 524f 4e47 2c0a 2020 2020 2020 2020  STRONG,.        
│ │ │ │ -0002bc90: 2020 766f 6964 202a 2044 4154 412c 2073    void * DATA, s
│ │ │ │ -0002bca0: 697a 655f 7420 4441 5441 4c45 4e29 0a20  ize_t DATALEN). 
│ │ │ │ -0002bcb0: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ -0002bcc0: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ -0002bcd0: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ -0002bce0: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ -0002bcf0: 2020 2020 5354 524f 4e47 3a20 3020 6966      STRONG: 0 if
│ │ │ │ -0002bd00: 6620 6f70 6572 6174 696f 6e20 7368 6f75  f operation shou
│ │ │ │ -0002bd10: 6c64 206e 6f74 2062 6c6f 636b 2c20 6e6f  ld not block, no
│ │ │ │ -0002bd20: 6e2d 3020 666f 7220 7665 7279 2073 7472  n-0 for very str
│ │ │ │ -0002bd30: 6f6e 670a 2020 2020 2072 616e 646f 6d6e  ong.     randomn
│ │ │ │ -0002bd40: 6573 732e 0a20 2020 2020 4441 5441 3a20  ess..     DATA: 
│ │ │ │ -0002bd50: 6f75 7470 7574 2061 7272 6179 2074 6f20  output array to 
│ │ │ │ -0002bd60: 6265 2066 696c 6c65 6420 7769 7468 2072  be filled with r
│ │ │ │ -0002bd70: 616e 646f 6d20 6461 7461 2e0a 2020 2020  andom data..    
│ │ │ │ -0002bd80: 2044 4154 414c 454e 3a20 7369 7a65 206f   DATALEN: size o
│ │ │ │ -0002bd90: 6620 6f75 7470 7574 2061 7272 6179 2e0a  f output array..
│ │ │ │ -0002bda0: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -0002bdb0: 6f6e 3a2a 2053 746f 7265 2063 7279 7074  on:* Store crypt
│ │ │ │ -0002bdc0: 6f67 7261 7068 6963 616c 6c79 2072 616e  ographically ran
│ │ │ │ -0002bdd0: 646f 6d20 6461 7461 206f 6620 6769 7665  dom data of give
│ │ │ │ -0002bde0: 6e20 7369 7a65 2069 6e0a 2020 2020 2074  n size in.     t
│ │ │ │ -0002bdf0: 6865 2070 726f 7669 6465 6420 6275 6666  he provided buff
│ │ │ │ -0002be00: 6572 2e0a 0a20 2020 2020 2a52 6574 7572  er...     *Retur
│ │ │ │ -0002be10: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ -0002be20: 7320 e280 9853 4849 5348 495f 4f4b e280  s ...SHISHI_OK..
│ │ │ │ -0002be30: 9920 6966 6620 7375 6363 6573 7366 756c  . iff successful
│ │ │ │ -0002be40: 2e0a 0a73 6869 7368 695f 6372 630a 2d2d  ...shishi_crc.--
│ │ │ │ -0002be50: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -0002be60: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ -0002be70: 6869 5f63 7263 2028 5368 6973 6869 202a  hi_crc (Shishi *
│ │ │ │ -0002be80: 2048 414e 444c 452c 2063 6f6e 7374 2063   HANDLE, const c
│ │ │ │ -0002be90: 6861 7220 2a20 494e 2c0a 2020 2020 2020  har * IN,.      
│ │ │ │ -0002bea0: 2020 2020 7369 7a65 5f74 2049 4e4c 454e      size_t INLEN
│ │ │ │ -0002beb0: 2c20 6368 6172 202a 204f 5554 5b34 5d29  , char * OUT[4])
│ │ │ │ -0002bec0: 0a20 2020 2020 4841 4e44 4c45 3a20 7368  .     HANDLE: sh
│ │ │ │ -0002bed0: 6973 6869 2068 616e 646c 6520 6173 2061  ishi handle as a
│ │ │ │ -0002bee0: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ -0002bef0: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ -0002bf00: 0a20 2020 2020 494e 3a20 696e 7075 7420  .     IN: input 
│ │ │ │ -0002bf10: 6368 6172 6163 7465 7220 6172 7261 7920  character array 
│ │ │ │ -0002bf20: 6f66 2064 6174 6120 746f 2063 6865 636b  of data to check
│ │ │ │ -0002bf30: 7375 6d2e 0a20 2020 2020 494e 4c45 4e3a  sum..     INLEN:
│ │ │ │ -0002bf40: 206c 656e 6774 6820 6f66 2069 6e70 7574   length of input
│ │ │ │ -0002bf50: 2063 6861 7261 6374 6572 2061 7272 6179   character array
│ │ │ │ -0002bf60: 206f 6620 6461 7461 2074 6f20 6368 6563   of data to chec
│ │ │ │ -0002bf70: 6b73 756d 2e0a 2020 2020 204f 5554 3a20  ksum..     OUT: 
│ │ │ │ -0002bf80: 6e65 776c 7920 616c 6c6f 6361 7465 6420  newly allocated 
│ │ │ │ -0002bf90: 6368 6172 6163 7465 7220 6172 7261 7920  character array 
│ │ │ │ -0002bfa0: 7769 7468 2063 6865 636b 7375 6d20 6f66  with checksum of
│ │ │ │ -0002bfb0: 2064 6174 612e 0a0a 2020 2020 202a 4465   data...     *De
│ │ │ │ -0002bfc0: 7363 7269 7074 696f 6e3a 2a20 436f 6d70  scription:* Comp
│ │ │ │ -0002bfd0: 7574 6520 6368 6563 6b73 756d 206f 6620  ute checksum of 
│ │ │ │ -0002bfe0: 6461 7461 2075 7369 6e67 2043 5243 3332  data using CRC32
│ │ │ │ -0002bff0: 206d 6f64 6966 6965 640a 2020 2020 2061   modified.     a
│ │ │ │ -0002c000: 6363 6f72 6469 6e67 2074 6f20 5246 4320  ccording to RFC 
│ │ │ │ -0002c010: 3135 3130 2e20 2054 6865 204f 5554 2062  1510.  The OUT b
│ │ │ │ -0002c020: 7566 6665 7220 6d75 7374 2062 6520 6465  uffer must be de
│ │ │ │ -0002c030: 616c 6c6f 6361 7465 6420 6279 2074 6865  allocated by the
│ │ │ │ -0002c040: 0a20 2020 2020 6361 6c6c 6572 2e0a 0a20  .     caller... 
│ │ │ │ -0002c050: 2020 2020 5468 6520 6d6f 6469 6669 6361      The modifica
│ │ │ │ -0002c060: 7469 6f6e 7320 636f 6d70 6172 6564 2074  tions compared t
│ │ │ │ -0002c070: 6f20 7374 616e 6461 7264 2043 5243 3332  o standard CRC32
│ │ │ │ -0002c080: 2069 7320 7468 6174 206e 6f20 696e 6974   is that no init
│ │ │ │ -0002c090: 6961 6c20 616e 640a 2020 2020 2066 696e  ial and.     fin
│ │ │ │ -0002c0a0: 616c 2058 4f52 2069 7320 7065 7266 6f72  al XOR is perfor
│ │ │ │ -0002c0b0: 6d65 642c 2061 6e64 2074 6861 7420 7468  med, and that th
│ │ │ │ -0002c0c0: 6520 6f75 7470 7574 2069 7320 7265 7475  e output is retu
│ │ │ │ -0002c0d0: 726e 6564 2069 6e0a 2020 2020 204c 5342  rned in.     LSB
│ │ │ │ -0002c0e0: 2d66 6972 7374 206f 7264 6572 2e0a 0a20  -first order... 
│ │ │ │ -0002c0f0: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ -0002c100: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ -0002c110: 4849 5f4f 4b20 6966 6620 7375 6363 6573  HI_OK iff succes
│ │ │ │ -0002c120: 7366 756c 2e0a 0a73 6869 7368 695f 6d64  sful...shishi_md
│ │ │ │ -0002c130: 340a 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  4.----------.. -
│ │ │ │ -0002c140: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ -0002c150: 7368 6973 6869 5f6d 6434 2028 5368 6973  shishi_md4 (Shis
│ │ │ │ -0002c160: 6869 202a 2048 414e 444c 452c 2063 6f6e  hi * HANDLE, con
│ │ │ │ -0002c170: 7374 2063 6861 7220 2a20 494e 2c0a 2020  st char * IN,.  
│ │ │ │ -0002c180: 2020 2020 2020 2020 7369 7a65 5f74 2049          size_t I
│ │ │ │ -0002c190: 4e4c 454e 2c20 6368 6172 202a 204f 5554  NLEN, char * OUT
│ │ │ │ -0002c1a0: 5b31 365d 290a 2020 2020 2048 414e 444c  [16]).     HANDL
│ │ │ │ -0002c1b0: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ -0002c1c0: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ -0002c1d0: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ -0002c1e0: 29e2 8099 2e0a 2020 2020 2049 4e3a 2069  ).....     IN: i
│ │ │ │ -0002c1f0: 6e70 7574 2063 6861 7261 6374 6572 2061  nput character a
│ │ │ │ -0002c200: 7272 6179 206f 6620 6461 7461 2074 6f20  rray of data to 
│ │ │ │ -0002c210: 6861 7368 2e0a 2020 2020 2049 4e4c 454e  hash..     INLEN
│ │ │ │ -0002c220: 3a20 6c65 6e67 7468 206f 6620 696e 7075  : length of inpu
│ │ │ │ -0002c230: 7420 6368 6172 6163 7465 7220 6172 7261  t character arra
│ │ │ │ -0002c240: 7920 6f66 2064 6174 6120 746f 2068 6173  y of data to has
│ │ │ │ -0002c250: 682e 0a20 2020 2020 4f55 543a 206e 6577  h..     OUT: new
│ │ │ │ -0002c260: 6c79 2061 6c6c 6f63 6174 6564 2063 6861  ly allocated cha
│ │ │ │ -0002c270: 7261 6374 6572 2061 7272 6179 2077 6974  racter array wit
│ │ │ │ -0002c280: 6820 6861 7368 206f 6620 6461 7461 2e0a  h hash of data..
│ │ │ │ -0002c290: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -0002c2a0: 6f6e 3a2a 2043 6f6d 7075 7465 2068 6173  on:* Compute has
│ │ │ │ -0002c2b0: 6820 6f66 2064 6174 6120 7573 696e 6720  h of data using 
│ │ │ │ -0002c2c0: 4d44 342e 2020 5468 6520 4f55 5420 6275  MD4.  The OUT bu
│ │ │ │ -0002c2d0: 6666 6572 206d 7573 740a 2020 2020 2062  ffer must.     b
│ │ │ │ -0002c2e0: 6520 6465 616c 6c6f 6361 7465 6420 6279  e deallocated by
│ │ │ │ -0002c2f0: 2074 6865 2063 616c 6c65 722e 0a0a 2020   the caller...  
│ │ │ │ -0002c300: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ -0002c310: 3a2a 2052 6574 7572 6e73 2053 4849 5348  :* Returns SHISH
│ │ │ │ -0002c320: 495f 4f4b 2069 6666 2073 7563 6365 7373  I_OK iff success
│ │ │ │ -0002c330: 6675 6c2e 0a0a 7368 6973 6869 5f6d 6435  ful...shishi_md5
│ │ │ │ -0002c340: 0a2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  .----------.. --
│ │ │ │ -0002c350: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ -0002c360: 6869 7368 695f 6d64 3520 2853 6869 7368  hishi_md5 (Shish
│ │ │ │ -0002c370: 6920 2a20 4841 4e44 4c45 2c20 636f 6e73  i * HANDLE, cons
│ │ │ │ -0002c380: 7420 6368 6172 202a 2049 4e2c 0a20 2020  t char * IN,.   
│ │ │ │ -0002c390: 2020 2020 2020 2073 697a 655f 7420 494e         size_t IN
│ │ │ │ -0002c3a0: 4c45 4e2c 2063 6861 7220 2a20 4f55 545b  LEN, char * OUT[
│ │ │ │ -0002c3b0: 3136 5d29 0a20 2020 2020 4841 4e44 4c45  16]).     HANDLE
│ │ │ │ -0002c3c0: 3a20 7368 6973 6869 2068 616e 646c 6520  : shishi handle 
│ │ │ │ -0002c3d0: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ -0002c3e0: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ -0002c3f0: e280 992e 0a20 2020 2020 494e 3a20 696e  .....     IN: in
│ │ │ │ -0002c400: 7075 7420 6368 6172 6163 7465 7220 6172  put character ar
│ │ │ │ -0002c410: 7261 7920 6f66 2064 6174 6120 746f 2068  ray of data to h
│ │ │ │ -0002c420: 6173 682e 0a20 2020 2020 494e 4c45 4e3a  ash..     INLEN:
│ │ │ │ -0002c430: 206c 656e 6774 6820 6f66 2069 6e70 7574   length of input
│ │ │ │ -0002c440: 2063 6861 7261 6374 6572 2061 7272 6179   character array
│ │ │ │ -0002c450: 206f 6620 6461 7461 2074 6f20 6861 7368   of data to hash
│ │ │ │ -0002c460: 2e0a 2020 2020 204f 5554 3a20 6e65 776c  ..     OUT: newl
│ │ │ │ -0002c470: 7920 616c 6c6f 6361 7465 6420 6368 6172  y allocated char
│ │ │ │ -0002c480: 6163 7465 7220 6172 7261 7920 7769 7468  acter array with
│ │ │ │ -0002c490: 2068 6173 6820 6f66 2064 6174 612e 0a0a   hash of data...
│ │ │ │ -0002c4a0: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ -0002c4b0: 6e3a 2a20 436f 6d70 7574 6520 6861 7368  n:* Compute hash
│ │ │ │ -0002c4c0: 206f 6620 6461 7461 2075 7369 6e67 204d   of data using M
│ │ │ │ -0002c4d0: 4435 2e20 2054 6865 204f 5554 2062 7566  D5.  The OUT buf
│ │ │ │ -0002c4e0: 6665 7220 6d75 7374 0a20 2020 2020 6265  fer must.     be
│ │ │ │ -0002c4f0: 2064 6561 6c6c 6f63 6174 6564 2062 7920   deallocated by 
│ │ │ │ -0002c500: 7468 6520 6361 6c6c 6572 2e0a 0a20 2020  the caller...   
│ │ │ │ -0002c510: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ -0002c520: 2a20 5265 7475 726e 7320 5348 4953 4849  * Returns SHISHI
│ │ │ │ -0002c530: 5f4f 4b20 6966 6620 7375 6363 6573 7366  _OK iff successf
│ │ │ │ -0002c540: 756c 2e0a 0a73 6869 7368 695f 686d 6163  ul...shishi_hmac
│ │ │ │ -0002c550: 5f6d 6435 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  _md5.-----------
│ │ │ │ -0002c560: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -0002c570: 6f6e 3a20 696e 7420 7368 6973 6869 5f68  on: int shishi_h
│ │ │ │ -0002c580: 6d61 635f 6d64 3520 2853 6869 7368 6920  mac_md5 (Shishi 
│ │ │ │ -0002c590: 2a20 4841 4e44 4c45 2c20 636f 6e73 7420  * HANDLE, const 
│ │ │ │ -0002c5a0: 6368 6172 202a 204b 4559 2c0a 2020 2020  char * KEY,.    
│ │ │ │ -0002c5b0: 2020 2020 2020 7369 7a65 5f74 204b 4559        size_t KEY
│ │ │ │ -0002c5c0: 4c45 4e2c 2063 6f6e 7374 2063 6861 7220  LEN, const char 
│ │ │ │ -0002c5d0: 2a20 494e 2c20 7369 7a65 5f74 2049 4e4c  * IN, size_t INL
│ │ │ │ -0002c5e0: 454e 2c0a 2020 2020 2020 2020 2020 6368  EN,.          ch
│ │ │ │ -0002c5f0: 6172 202a 204f 5554 4841 5348 5b31 365d  ar * OUTHASH[16]
│ │ │ │ -0002c600: 290a 2020 2020 2048 414e 444c 453a 2073  ).     HANDLE: s
│ │ │ │ -0002c610: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ -0002c620: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ -0002c630: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ -0002c640: 2e0a 2020 2020 204b 4559 3a20 696e 7075  ..     KEY: inpu
│ │ │ │ -0002c650: 7420 6368 6172 6163 7465 7220 6172 7261  t character arra
│ │ │ │ -0002c660: 7920 7769 7468 206b 6579 2074 6f20 7573  y with key to us
│ │ │ │ -0002c670: 652e 0a20 2020 2020 4b45 594c 454e 3a20  e..     KEYLEN: 
│ │ │ │ -0002c680: 6c65 6e67 7468 206f 6620 696e 7075 7420  length of input 
│ │ │ │ -0002c690: 6368 6172 6163 7465 7220 6172 7261 7920  character array 
│ │ │ │ -0002c6a0: 7769 7468 206b 6579 2074 6f20 7573 652e  with key to use.
│ │ │ │ -0002c6b0: 0a20 2020 2020 494e 3a20 696e 7075 7420  .     IN: input 
│ │ │ │ -0002c6c0: 6368 6172 6163 7465 7220 6172 7261 7920  character array 
│ │ │ │ -0002c6d0: 6f66 2064 6174 6120 746f 2068 6173 682e  of data to hash.
│ │ │ │ -0002c6e0: 0a20 2020 2020 494e 4c45 4e3a 206c 656e  .     INLEN: len
│ │ │ │ -0002c6f0: 6774 6820 6f66 2069 6e70 7574 2063 6861  gth of input cha
│ │ │ │ -0002c700: 7261 6374 6572 2061 7272 6179 206f 6620  racter array of 
│ │ │ │ -0002c710: 6461 7461 2074 6f20 6861 7368 2e0a 2020  data to hash..  
│ │ │ │ -0002c720: 2020 204f 5554 4841 5348 3a20 6e65 776c     OUTHASH: newl
│ │ │ │ -0002c730: 7920 616c 6c6f 6361 7465 6420 6368 6172  y allocated char
│ │ │ │ -0002c740: 6163 7465 7220 6172 7261 7920 7769 7468  acter array with
│ │ │ │ -0002c750: 206b 6579 6564 2068 6173 6820 6f66 2064   keyed hash of d
│ │ │ │ -0002c760: 6174 612e 0a0a 2020 2020 202a 4465 7363  ata...     *Desc
│ │ │ │ -0002c770: 7269 7074 696f 6e3a 2a20 436f 6d70 7574  ription:* Comput
│ │ │ │ -0002c780: 6520 6b65 7965 6420 6368 6563 6b73 756d  e keyed checksum
│ │ │ │ -0002c790: 206f 6620 6461 7461 2075 7369 6e67 2048   of data using H
│ │ │ │ -0002c7a0: 4d41 432d 4d44 352e 2020 5468 650a 2020  MAC-MD5.  The.  
│ │ │ │ -0002c7b0: 2020 204f 5554 4841 5348 2062 7566 6665     OUTHASH buffe
│ │ │ │ -0002c7c0: 7220 6d75 7374 2062 6520 6465 616c 6c6f  r must be deallo
│ │ │ │ -0002c7d0: 6361 7465 6420 6279 2074 6865 2063 616c  cated by the cal
│ │ │ │ -0002c7e0: 6c65 722e 0a0a 2020 2020 202a 5265 7475  ler...     *Retu
│ │ │ │ -0002c7f0: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ -0002c800: 6e73 2053 4849 5348 495f 4f4b 2069 6666  ns SHISHI_OK iff
│ │ │ │ -0002c810: 2073 7563 6365 7373 6675 6c2e 0a0a 7368   successful...sh
│ │ │ │ -0002c820: 6973 6869 5f68 6d61 635f 7368 6131 0a2d  ishi_hmac_sha1.-
│ │ │ │ -0002c830: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -0002c840: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ -0002c850: 6e74 2073 6869 7368 695f 686d 6163 5f73  nt shishi_hmac_s
│ │ │ │ -0002c860: 6861 3120 2853 6869 7368 6920 2a20 4841  ha1 (Shishi * HA
│ │ │ │ -0002c870: 4e44 4c45 2c20 636f 6e73 7420 6368 6172  NDLE, const char
│ │ │ │ -0002c880: 202a 204b 4559 2c0a 2020 2020 2020 2020   * KEY,.        
│ │ │ │ -0002c890: 2020 7369 7a65 5f74 204b 4559 4c45 4e2c    size_t KEYLEN,
│ │ │ │ -0002c8a0: 2063 6f6e 7374 2063 6861 7220 2a20 494e   const char * IN
│ │ │ │ -0002c8b0: 2c20 7369 7a65 5f74 2049 4e4c 454e 2c0a  , size_t INLEN,.
│ │ │ │ -0002c8c0: 2020 2020 2020 2020 2020 6368 6172 202a            char *
│ │ │ │ -0002c8d0: 204f 5554 4841 5348 5b32 305d 290a 2020   OUTHASH[20]).  
│ │ │ │ -0002c8e0: 2020 2048 414e 444c 453a 2073 6869 7368     HANDLE: shish
│ │ │ │ -0002c8f0: 6920 6861 6e64 6c65 2061 7320 616c 6c6f  i handle as allo
│ │ │ │ -0002c900: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ -0002c910: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ -0002c920: 2020 204b 4559 3a20 696e 7075 7420 6368     KEY: input ch
│ │ │ │ -0002c930: 6172 6163 7465 7220 6172 7261 7920 7769  aracter array wi
│ │ │ │ -0002c940: 7468 206b 6579 2074 6f20 7573 652e 0a20  th key to use.. 
│ │ │ │ -0002c950: 2020 2020 4b45 594c 454e 3a20 6c65 6e67      KEYLEN: leng
│ │ │ │ -0002c960: 7468 206f 6620 696e 7075 7420 6368 6172  th of input char
│ │ │ │ -0002c970: 6163 7465 7220 6172 7261 7920 7769 7468  acter array with
│ │ │ │ -0002c980: 206b 6579 2074 6f20 7573 652e 0a20 2020   key to use..   
│ │ │ │ -0002c990: 2020 494e 3a20 696e 7075 7420 6368 6172    IN: input char
│ │ │ │ -0002c9a0: 6163 7465 7220 6172 7261 7920 6f66 2064  acter array of d
│ │ │ │ -0002c9b0: 6174 6120 746f 2068 6173 682e 0a20 2020  ata to hash..   
│ │ │ │ -0002c9c0: 2020 494e 4c45 4e3a 206c 656e 6774 6820    INLEN: length 
│ │ │ │ -0002c9d0: 6f66 2069 6e70 7574 2063 6861 7261 6374  of input charact
│ │ │ │ -0002c9e0: 6572 2061 7272 6179 206f 6620 6461 7461  er array of data
│ │ │ │ -0002c9f0: 2074 6f20 6861 7368 2e0a 2020 2020 204f   to hash..     O
│ │ │ │ -0002ca00: 5554 4841 5348 3a20 6e65 776c 7920 616c  UTHASH: newly al
│ │ │ │ -0002ca10: 6c6f 6361 7465 6420 6368 6172 6163 7465  located characte
│ │ │ │ -0002ca20: 7220 6172 7261 7920 7769 7468 206b 6579  r array with key
│ │ │ │ -0002ca30: 6564 2068 6173 6820 6f66 2064 6174 612e  ed hash of data.
│ │ │ │ -0002ca40: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ -0002ca50: 696f 6e3a 2a20 436f 6d70 7574 6520 6b65  ion:* Compute ke
│ │ │ │ -0002ca60: 7965 6420 6368 6563 6b73 756d 206f 6620  yed checksum of 
│ │ │ │ -0002ca70: 6461 7461 2075 7369 6e67 2048 4d41 432d  data using HMAC-
│ │ │ │ -0002ca80: 5348 4131 2e20 2054 6865 0a20 2020 2020  SHA1.  The.     
│ │ │ │ -0002ca90: 4f55 5448 4153 4820 6275 6666 6572 206d  OUTHASH buffer m
│ │ │ │ -0002caa0: 7573 7420 6265 2064 6561 6c6c 6f63 6174  ust be deallocat
│ │ │ │ -0002cab0: 6564 2062 7920 7468 6520 6361 6c6c 6572  ed by the caller
│ │ │ │ -0002cac0: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ -0002cad0: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ -0002cae0: 5348 4953 4849 5f4f 4b20 6966 6620 7375  SHISHI_OK iff su
│ │ │ │ -0002caf0: 6363 6573 7366 756c 2e0a 0a73 6869 7368  ccessful...shish
│ │ │ │ -0002cb00: 695f 6465 735f 6362 635f 6d61 630a 2d2d  i_des_cbc_mac.--
│ │ │ │ +000283e0: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ +000283f0: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ +00028400: 5f64 6563 7279 7074 5f69 765f 6574 7970  _decrypt_iv_etyp
│ │ │ │ +00028410: 6520 2853 6869 7368 6920 2a20 4841 4e44  e (Shishi * HAND
│ │ │ │ +00028420: 4c45 2c0a 2020 2020 2020 2020 2020 5368  LE,.          Sh
│ │ │ │ +00028430: 6973 6869 5f6b 6579 202a 204b 4559 2c20  ishi_key * KEY, 
│ │ │ │ +00028440: 696e 7420 4b45 5955 5341 4745 2c20 696e  int KEYUSAGE, in
│ │ │ │ +00028450: 7433 325f 7420 4554 5950 452c 0a20 2020  t32_t ETYPE,.   
│ │ │ │ +00028460: 2020 2020 2020 2063 6f6e 7374 2063 6861         const cha
│ │ │ │ +00028470: 7220 2a20 4956 2c20 7369 7a65 5f74 2049  r * IV, size_t I
│ │ │ │ +00028480: 564c 454e 2c20 636f 6e73 7420 6368 6172  VLEN, const char
│ │ │ │ +00028490: 202a 2049 4e2c 2073 697a 655f 7420 494e   * IN, size_t IN
│ │ │ │ +000284a0: 4c45 4e2c 0a20 2020 2020 2020 2020 2063  LEN,.          c
│ │ │ │ +000284b0: 6861 7220 2a2a 204f 5554 2c20 7369 7a65  har ** OUT, size
│ │ │ │ +000284c0: 5f74 202a 204f 5554 4c45 4e29 0a20 2020  _t * OUTLEN).   
│ │ │ │ +000284d0: 2020 4841 4e44 4c45 3a20 7368 6973 6869    HANDLE: shishi
│ │ │ │ +000284e0: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ +000284f0: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ +00028500: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ +00028510: 2020 4b45 593a 206b 6579 2074 6f20 6465    KEY: key to de
│ │ │ │ +00028520: 6372 7970 7420 7769 7468 2e0a 2020 2020  crypt with..    
│ │ │ │ +00028530: 204b 4559 5553 4147 453a 2069 6e74 6567   KEYUSAGE: integ
│ │ │ │ +00028540: 6572 2073 7065 6369 6679 696e 6720 7768  er specifying wh
│ │ │ │ +00028550: 6174 2074 6869 7320 6b65 7920 6973 2064  at this key is d
│ │ │ │ +00028560: 6563 7279 7074 696e 672e 0a20 2020 2020  ecrypting..     
│ │ │ │ +00028570: 4554 5950 453a 2069 6e74 6567 6572 2073  ETYPE: integer s
│ │ │ │ +00028580: 7065 6369 6679 696e 6720 7768 6174 2063  pecifying what c
│ │ │ │ +00028590: 6970 6865 7220 746f 2075 7365 2e0a 2020  ipher to use..  
│ │ │ │ +000285a0: 2020 2049 563a 2069 6e70 7574 2061 7272     IV: input arr
│ │ │ │ +000285b0: 6179 2077 6974 6820 696e 6974 6961 6c69  ay with initiali
│ │ │ │ +000285c0: 7a61 7469 6f6e 2076 6563 746f 720a 2020  zation vector.  
│ │ │ │ +000285d0: 2020 2049 564c 454e 3a20 7369 7a65 206f     IVLEN: size o
│ │ │ │ +000285e0: 6620 696e 7075 7420 6172 7261 7920 7769  f input array wi
│ │ │ │ +000285f0: 7468 2069 6e69 7469 616c 697a 6174 696f  th initializatio
│ │ │ │ +00028600: 6e20 7665 6374 6f72 2e0a 2020 2020 2049  n vector..     I
│ │ │ │ +00028610: 4e3a 2069 6e70 7574 2061 7272 6179 2077  N: input array w
│ │ │ │ +00028620: 6974 6820 6461 7461 2074 6f20 6465 6372  ith data to decr
│ │ │ │ +00028630: 7970 742e 0a20 2020 2020 494e 4c45 4e3a  ypt..     INLEN:
│ │ │ │ +00028640: 2073 697a 6520 6f66 2069 6e70 7574 2061   size of input a
│ │ │ │ +00028650: 7272 6179 2077 6974 6820 6461 7461 2074  rray with data t
│ │ │ │ +00028660: 6f20 6465 6372 7970 742e 0a20 2020 2020  o decrypt..     
│ │ │ │ +00028670: 4f55 543a 206f 7574 7075 7420 6172 7261  OUT: output arra
│ │ │ │ +00028680: 7920 7769 7468 206e 6577 6c79 2061 6c6c  y with newly all
│ │ │ │ +00028690: 6f63 6174 6564 2064 6563 7279 7074 6564  ocated decrypted
│ │ │ │ +000286a0: 2064 6174 612e 0a20 2020 2020 4f55 544c   data..     OUTL
│ │ │ │ +000286b0: 454e 3a20 6f75 7470 7574 2076 6172 6961  EN: output varia
│ │ │ │ +000286c0: 626c 6520 7769 7468 2073 697a 6520 6f66  ble with size of
│ │ │ │ +000286d0: 206e 6577 6c79 2061 6c6c 6f63 6174 6564   newly allocated
│ │ │ │ +000286e0: 206f 7574 7075 7420 6172 7261 792e 0a0a   output array...
│ │ │ │ +000286f0: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ +00028700: 6e3a 2a20 4465 6372 7970 7473 2064 6174  n:* Decrypts dat
│ │ │ │ +00028710: 6120 6173 2070 6572 2065 6e63 7279 7074  a as per encrypt
│ │ │ │ +00028720: 696f 6e20 6d65 7468 6f64 2075 7369 6e67  ion method using
│ │ │ │ +00028730: 0a20 2020 2020 7370 6563 6966 6965 6420  .     specified 
│ │ │ │ +00028740: 696e 6974 6961 6c69 7a61 7469 6f6e 2076  initialization v
│ │ │ │ +00028750: 6563 746f 7220 616e 6420 6b65 792e 2020  ector and key.  
│ │ │ │ +00028760: 5468 6520 6b65 7920 6163 7475 616c 6c79  The key actually
│ │ │ │ +00028770: 2075 7365 6420 6973 0a20 2020 2020 6465   used is.     de
│ │ │ │ +00028780: 7269 7665 6420 7573 696e 6720 7468 6520  rived using the 
│ │ │ │ +00028790: 6b65 7920 7573 6167 652e 2020 4966 206b  key usage.  If k
│ │ │ │ +000287a0: 6579 2075 7361 6765 2069 7320 302c 206e  ey usage is 0, n
│ │ │ │ +000287b0: 6f20 6b65 7920 6465 7269 7661 7469 6f6e  o key derivation
│ │ │ │ +000287c0: 0a20 2020 2020 6973 2075 7365 642e 2020  .     is used.  
│ │ │ │ +000287d0: 5468 6520 4f55 5420 6275 6666 6572 206d  The OUT buffer m
│ │ │ │ +000287e0: 7573 7420 6265 2064 6561 6c6c 6f63 6174  ust be deallocat
│ │ │ │ +000287f0: 6564 2062 7920 7468 6520 6361 6c6c 6572  ed by the caller
│ │ │ │ +00028800: 2e20 2054 6865 0a20 2020 2020 6e65 7874  .  The.     next
│ │ │ │ +00028810: 2049 5620 6973 206c 6f73 742c 2073 6565   IV is lost, see
│ │ │ │ +00028820: 2073 6869 7368 695f 6465 6372 7970 745f   shishi_decrypt_
│ │ │ │ +00028830: 6976 7570 6461 7465 5f65 7479 7065 2069  ivupdate_etype i
│ │ │ │ +00028840: 6620 796f 7520 6e65 6564 2069 742e 0a0a  f you need it...
│ │ │ │ +00028850: 2020 2020 204e 6f74 6520 7468 6174 2044       Note that D
│ │ │ │ +00028860: 4543 5259 5054 2845 4e43 5259 5054 2864  ECRYPT(ENCRYPT(d
│ │ │ │ +00028870: 6174 6129 2920 646f 6573 206e 6f74 206e  ata)) does not n
│ │ │ │ +00028880: 6563 6573 7361 7269 6c79 2079 6965 6c64  ecessarily yield
│ │ │ │ +00028890: 2064 6174 610a 2020 2020 2065 7861 6374   data.     exact
│ │ │ │ +000288a0: 6c79 2e20 2053 6f6d 6520 656e 6372 7970  ly.  Some encryp
│ │ │ │ +000288b0: 7469 6f6e 2074 7970 6573 2061 6464 2070  tion types add p
│ │ │ │ +000288c0: 6164 2074 6f20 6d61 6b65 2074 6865 2064  ad to make the d
│ │ │ │ +000288d0: 6174 6120 6669 7420 696e 746f 0a20 2020  ata fit into.   
│ │ │ │ +000288e0: 2020 7468 6520 626c 6f63 6b20 7369 7a65    the block size
│ │ │ │ +000288f0: 206f 6620 7468 6520 656e 6372 7970 7469   of the encrypti
│ │ │ │ +00028900: 6f6e 2061 6c67 6f72 6974 686d 2e20 2046  on algorithm.  F
│ │ │ │ +00028910: 7572 7468 6572 6d6f 7265 2c20 7468 6520  urthermore, the 
│ │ │ │ +00028920: 7061 640a 2020 2020 2069 7320 6e6f 7420  pad.     is not 
│ │ │ │ +00028930: 6775 6172 616e 7465 6564 2074 6f20 6c6f  guaranteed to lo
│ │ │ │ +00028940: 6f6b 2069 6e20 616e 7920 7370 6563 6961  ok in any specia
│ │ │ │ +00028950: 6c20 7761 792c 2061 6c74 686f 7567 6820  l way, although 
│ │ │ │ +00028960: 6578 6973 7469 6e67 0a20 2020 2020 696d  existing.     im
│ │ │ │ +00028970: 706c 656d 656e 7461 7469 6f6e 7320 6f66  plementations of
│ │ │ │ +00028980: 7465 6e20 7061 6420 7769 7468 2074 6865  ten pad with the
│ │ │ │ +00028990: 207a 6572 6f20 6279 7465 2e20 2054 6869   zero byte.  Thi
│ │ │ │ +000289a0: 7320 6d65 616e 7320 7468 6174 2079 6f75  s means that you
│ │ │ │ +000289b0: 0a20 2020 2020 6d61 7920 6861 7665 2074  .     may have t
│ │ │ │ +000289c0: 6f20 2266 7261 6d65 2220 6461 7461 2c20  o "frame" data, 
│ │ │ │ +000289d0: 736f 2069 7420 6973 2070 6f73 7369 626c  so it is possibl
│ │ │ │ +000289e0: 6520 746f 2069 6e66 6572 2074 6865 206f  e to infer the o
│ │ │ │ +000289f0: 7269 6769 6e61 6c0a 2020 2020 206c 656e  riginal.     len
│ │ │ │ +00028a00: 6774 6820 6166 7465 7220 6465 6372 7970  gth after decryp
│ │ │ │ +00028a10: 7469 6f6e 2e20 2043 6f6d 7061 7265 2041  tion.  Compare A
│ │ │ │ +00028a20: 534e 2e31 2044 4552 2077 6869 6368 2063  SN.1 DER which c
│ │ │ │ +00028a30: 6f6e 7461 696e 7320 7375 6368 0a20 2020  ontains such.   
│ │ │ │ +00028a40: 2020 696e 666f 726d 6174 696f 6e2e 0a0a    information...
│ │ │ │ +00028a50: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ +00028a60: 7565 3a2a 2052 6574 7572 6e73 20e2 8098  ue:* Returns ...
│ │ │ │ +00028a70: 5348 4953 4849 5f4f 4be2 8099 2069 6666  SHISHI_OK... iff
│ │ │ │ +00028a80: 2073 7563 6365 7373 6675 6c2e 0a0a 7368   successful...sh
│ │ │ │ +00028a90: 6973 6869 5f64 6563 7279 7074 5f65 7479  ishi_decrypt_ety
│ │ │ │ +00028aa0: 7065 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  pe.-------------
│ │ │ │ +00028ab0: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +00028ac0: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ +00028ad0: 695f 6465 6372 7970 745f 6574 7970 6520  i_decrypt_etype 
│ │ │ │ +00028ae0: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ +00028af0: 2c0a 2020 2020 2020 2020 2020 5368 6973  ,.          Shis
│ │ │ │ +00028b00: 6869 5f6b 6579 202a 204b 4559 2c20 696e  hi_key * KEY, in
│ │ │ │ +00028b10: 7420 4b45 5955 5341 4745 2c20 696e 7433  t KEYUSAGE, int3
│ │ │ │ +00028b20: 325f 7420 4554 5950 452c 0a20 2020 2020  2_t ETYPE,.     
│ │ │ │ +00028b30: 2020 2020 2063 6f6e 7374 2063 6861 7220       const char 
│ │ │ │ +00028b40: 2a20 494e 2c20 7369 7a65 5f74 2049 4e4c  * IN, size_t INL
│ │ │ │ +00028b50: 454e 2c20 6368 6172 202a 2a20 4f55 542c  EN, char ** OUT,
│ │ │ │ +00028b60: 2073 697a 655f 7420 2a20 4f55 544c 454e   size_t * OUTLEN
│ │ │ │ +00028b70: 290a 2020 2020 2048 414e 444c 453a 2073  ).     HANDLE: s
│ │ │ │ +00028b80: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ +00028b90: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ +00028ba0: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ +00028bb0: 2e0a 2020 2020 204b 4559 3a20 6b65 7920  ..     KEY: key 
│ │ │ │ +00028bc0: 746f 2064 6563 7279 7074 2077 6974 682e  to decrypt with.
│ │ │ │ +00028bd0: 0a20 2020 2020 4b45 5955 5341 4745 3a20  .     KEYUSAGE: 
│ │ │ │ +00028be0: 696e 7465 6765 7220 7370 6563 6966 7969  integer specifyi
│ │ │ │ +00028bf0: 6e67 2077 6861 7420 7468 6973 206b 6579  ng what this key
│ │ │ │ +00028c00: 2069 7320 6465 6372 7970 7469 6e67 2e0a   is decrypting..
│ │ │ │ +00028c10: 2020 2020 2045 5459 5045 3a20 696e 7465       ETYPE: inte
│ │ │ │ +00028c20: 6765 7220 7370 6563 6966 7969 6e67 2077  ger specifying w
│ │ │ │ +00028c30: 6861 7420 6369 7068 6572 2074 6f20 7573  hat cipher to us
│ │ │ │ +00028c40: 652e 0a20 2020 2020 494e 3a20 696e 7075  e..     IN: inpu
│ │ │ │ +00028c50: 7420 6172 7261 7920 7769 7468 2064 6174  t array with dat
│ │ │ │ +00028c60: 6120 746f 2064 6563 7279 7074 2e0a 2020  a to decrypt..  
│ │ │ │ +00028c70: 2020 2049 4e4c 454e 3a20 7369 7a65 206f     INLEN: size o
│ │ │ │ +00028c80: 6620 696e 7075 7420 6172 7261 7920 7769  f input array wi
│ │ │ │ +00028c90: 7468 2064 6174 6120 746f 2064 6563 7279  th data to decry
│ │ │ │ +00028ca0: 7074 2e0a 2020 2020 204f 5554 3a20 6f75  pt..     OUT: ou
│ │ │ │ +00028cb0: 7470 7574 2061 7272 6179 2077 6974 6820  tput array with 
│ │ │ │ +00028cc0: 6e65 776c 7920 616c 6c6f 6361 7465 6420  newly allocated 
│ │ │ │ +00028cd0: 6465 6372 7970 7465 6420 6461 7461 2e0a  decrypted data..
│ │ │ │ +00028ce0: 2020 2020 204f 5554 4c45 4e3a 206f 7574       OUTLEN: out
│ │ │ │ +00028cf0: 7075 7420 7661 7269 6162 6c65 2077 6974  put variable wit
│ │ │ │ +00028d00: 6820 7369 7a65 206f 6620 6e65 776c 7920  h size of newly 
│ │ │ │ +00028d10: 616c 6c6f 6361 7465 6420 6f75 7470 7574  allocated output
│ │ │ │ +00028d20: 2061 7272 6179 2e0a 0a20 2020 2020 2a44   array...     *D
│ │ │ │ +00028d30: 6573 6372 6970 7469 6f6e 3a2a 2044 6563  escription:* Dec
│ │ │ │ +00028d40: 7279 7074 7320 6461 7461 2061 7320 7065  rypts data as pe
│ │ │ │ +00028d50: 7220 656e 6372 7970 7469 6f6e 206d 6574  r encryption met
│ │ │ │ +00028d60: 686f 6420 7573 696e 670a 2020 2020 2073  hod using.     s
│ │ │ │ +00028d70: 7065 6369 6669 6564 206b 6579 2e20 2054  pecified key.  T
│ │ │ │ +00028d80: 6865 206b 6579 2061 6374 7561 6c6c 7920  he key actually 
│ │ │ │ +00028d90: 7573 6564 2069 7320 6465 7269 7665 6420  used is derived 
│ │ │ │ +00028da0: 7573 696e 6720 7468 6520 6b65 790a 2020  using the key.  
│ │ │ │ +00028db0: 2020 2075 7361 6765 2e20 2049 6620 6b65     usage.  If ke
│ │ │ │ +00028dc0: 7920 7573 6167 6520 6973 2030 2c20 6e6f  y usage is 0, no
│ │ │ │ +00028dd0: 206b 6579 2064 6572 6976 6174 696f 6e20   key derivation 
│ │ │ │ +00028de0: 6973 2075 7365 642e 2020 5468 6520 4f55  is used.  The OU
│ │ │ │ +00028df0: 540a 2020 2020 2062 7566 6665 7220 6d75  T.     buffer mu
│ │ │ │ +00028e00: 7374 2062 6520 6465 616c 6c6f 6361 7465  st be deallocate
│ │ │ │ +00028e10: 6420 6279 2074 6865 2063 616c 6c65 722e  d by the caller.
│ │ │ │ +00028e20: 2020 5468 6520 6465 6661 756c 7420 4956    The default IV
│ │ │ │ +00028e30: 2069 7320 7573 6564 2c0a 2020 2020 2073   is used,.     s
│ │ │ │ +00028e40: 6565 2073 6869 7368 695f 6465 6372 7970  ee shishi_decryp
│ │ │ │ +00028e50: 745f 6976 5f65 7479 7065 2069 6620 796f  t_iv_etype if yo
│ │ │ │ +00028e60: 7520 6e65 6564 2074 6f20 616c 7465 7220  u need to alter 
│ │ │ │ +00028e70: 6974 2e20 2054 6865 206e 6578 7420 4956  it.  The next IV
│ │ │ │ +00028e80: 0a20 2020 2020 6973 206c 6f73 742c 2073  .     is lost, s
│ │ │ │ +00028e90: 6565 2073 6869 7368 695f 6465 6372 7970  ee shishi_decryp
│ │ │ │ +00028ea0: 745f 6976 7570 6461 7465 5f65 7479 7065  t_ivupdate_etype
│ │ │ │ +00028eb0: 2069 6620 796f 7520 6e65 6564 2069 742e   if you need it.
│ │ │ │ +00028ec0: 0a0a 2020 2020 204e 6f74 6520 7468 6174  ..     Note that
│ │ │ │ +00028ed0: 2044 4543 5259 5054 2845 4e43 5259 5054   DECRYPT(ENCRYPT
│ │ │ │ +00028ee0: 2864 6174 6129 2920 646f 6573 206e 6f74  (data)) does not
│ │ │ │ +00028ef0: 206e 6563 6573 7361 7269 6c79 2079 6965   necessarily yie
│ │ │ │ +00028f00: 6c64 2064 6174 610a 2020 2020 2065 7861  ld data.     exa
│ │ │ │ +00028f10: 6374 6c79 2e20 2053 6f6d 6520 656e 6372  ctly.  Some encr
│ │ │ │ +00028f20: 7970 7469 6f6e 2074 7970 6573 2061 6464  yption types add
│ │ │ │ +00028f30: 2070 6164 2074 6f20 6d61 6b65 2074 6865   pad to make the
│ │ │ │ +00028f40: 2064 6174 6120 6669 7420 696e 746f 0a20   data fit into. 
│ │ │ │ +00028f50: 2020 2020 7468 6520 626c 6f63 6b20 7369      the block si
│ │ │ │ +00028f60: 7a65 206f 6620 7468 6520 656e 6372 7970  ze of the encryp
│ │ │ │ +00028f70: 7469 6f6e 2061 6c67 6f72 6974 686d 2e20  tion algorithm. 
│ │ │ │ +00028f80: 2046 7572 7468 6572 6d6f 7265 2c20 7468   Furthermore, th
│ │ │ │ +00028f90: 6520 7061 640a 2020 2020 2069 7320 6e6f  e pad.     is no
│ │ │ │ +00028fa0: 7420 6775 6172 616e 7465 6564 2074 6f20  t guaranteed to 
│ │ │ │ +00028fb0: 6c6f 6f6b 2069 6e20 616e 7920 7370 6563  look in any spec
│ │ │ │ +00028fc0: 6961 6c20 7761 792c 2061 6c74 686f 7567  ial way, althoug
│ │ │ │ +00028fd0: 6820 6578 6973 7469 6e67 0a20 2020 2020  h existing.     
│ │ │ │ +00028fe0: 696d 706c 656d 656e 7461 7469 6f6e 7320  implementations 
│ │ │ │ +00028ff0: 6f66 7465 6e20 7061 6420 7769 7468 2074  often pad with t
│ │ │ │ +00029000: 6865 207a 6572 6f20 6279 7465 2e20 2054  he zero byte.  T
│ │ │ │ +00029010: 6869 7320 6d65 616e 7320 7468 6174 2079  his means that y
│ │ │ │ +00029020: 6f75 0a20 2020 2020 6d61 7920 6861 7665  ou.     may have
│ │ │ │ +00029030: 2074 6f20 2266 7261 6d65 2220 6461 7461   to "frame" data
│ │ │ │ +00029040: 2c20 736f 2069 7420 6973 2070 6f73 7369  , so it is possi
│ │ │ │ +00029050: 626c 6520 746f 2069 6e66 6572 2074 6865  ble to infer the
│ │ │ │ +00029060: 206f 7269 6769 6e61 6c0a 2020 2020 206c   original.     l
│ │ │ │ +00029070: 656e 6774 6820 6166 7465 7220 6465 6372  ength after decr
│ │ │ │ +00029080: 7970 7469 6f6e 2e20 2043 6f6d 7061 7265  yption.  Compare
│ │ │ │ +00029090: 2041 534e 2e31 2044 4552 2077 6869 6368   ASN.1 DER which
│ │ │ │ +000290a0: 2063 6f6e 7461 696e 7320 7375 6368 0a20   contains such. 
│ │ │ │ +000290b0: 2020 2020 696e 666f 726d 6174 696f 6e2e      information.
│ │ │ │ +000290c0: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ +000290d0: 616c 7565 3a2a 2052 6574 7572 6e73 20e2  alue:* Returns .
│ │ │ │ +000290e0: 8098 5348 4953 4849 5f4f 4be2 8099 2069  ..SHISHI_OK... i
│ │ │ │ +000290f0: 6666 2073 7563 6365 7373 6675 6c2e 0a0a  ff successful...
│ │ │ │ +00029100: 7368 6973 6869 5f64 6563 7279 7074 5f69  shishi_decrypt_i
│ │ │ │ +00029110: 7675 7064 6174 650a 2d2d 2d2d 2d2d 2d2d  vupdate.--------
│ │ │ │ +00029120: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +00029130: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ +00029140: 6e74 2073 6869 7368 695f 6465 6372 7970  nt shishi_decryp
│ │ │ │ +00029150: 745f 6976 7570 6461 7465 2028 5368 6973  t_ivupdate (Shis
│ │ │ │ +00029160: 6869 202a 2048 414e 444c 452c 0a20 2020  hi * HANDLE,.   
│ │ │ │ +00029170: 2020 2020 2020 2053 6869 7368 695f 6b65         Shishi_ke
│ │ │ │ +00029180: 7920 2a20 4b45 592c 2069 6e74 204b 4559  y * KEY, int KEY
│ │ │ │ +00029190: 5553 4147 452c 2063 6f6e 7374 2063 6861  USAGE, const cha
│ │ │ │ +000291a0: 7220 2a20 4956 2c20 7369 7a65 5f74 2049  r * IV, size_t I
│ │ │ │ +000291b0: 564c 454e 2c0a 2020 2020 2020 2020 2020  VLEN,.          
│ │ │ │ +000291c0: 6368 6172 202a 2a20 4956 4f55 542c 2073  char ** IVOUT, s
│ │ │ │ +000291d0: 697a 655f 7420 2a20 4956 4f55 544c 454e  ize_t * IVOUTLEN
│ │ │ │ +000291e0: 2c20 636f 6e73 7420 6368 6172 202a 2049  , const char * I
│ │ │ │ +000291f0: 4e2c 0a20 2020 2020 2020 2020 2073 697a  N,.          siz
│ │ │ │ +00029200: 655f 7420 494e 4c45 4e2c 2063 6861 7220  e_t INLEN, char 
│ │ │ │ +00029210: 2a2a 204f 5554 2c20 7369 7a65 5f74 202a  ** OUT, size_t *
│ │ │ │ +00029220: 204f 5554 4c45 4e29 0a20 2020 2020 4841   OUTLEN).     HA
│ │ │ │ +00029230: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ +00029240: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ +00029250: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ +00029260: 6974 2829 e280 992e 0a20 2020 2020 4b45  it().....     KE
│ │ │ │ +00029270: 593a 206b 6579 2074 6f20 6465 6372 7970  Y: key to decryp
│ │ │ │ +00029280: 7420 7769 7468 2e0a 2020 2020 204b 4559  t with..     KEY
│ │ │ │ +00029290: 5553 4147 453a 2069 6e74 6567 6572 2073  USAGE: integer s
│ │ │ │ +000292a0: 7065 6369 6679 696e 6720 7768 6174 2074  pecifying what t
│ │ │ │ +000292b0: 6869 7320 6b65 7920 6973 2064 6563 7279  his key is decry
│ │ │ │ +000292c0: 7074 696e 672e 0a20 2020 2020 4956 3a20  pting..     IV: 
│ │ │ │ +000292d0: 696e 7075 7420 6172 7261 7920 7769 7468  input array with
│ │ │ │ +000292e0: 2069 6e69 7469 616c 697a 6174 696f 6e20   initialization 
│ │ │ │ +000292f0: 7665 6374 6f72 0a20 2020 2020 4956 4c45  vector.     IVLE
│ │ │ │ +00029300: 4e3a 2073 697a 6520 6f66 2069 6e70 7574  N: size of input
│ │ │ │ +00029310: 2061 7272 6179 2077 6974 6820 696e 6974   array with init
│ │ │ │ +00029320: 6961 6c69 7a61 7469 6f6e 2076 6563 746f  ialization vecto
│ │ │ │ +00029330: 722e 0a20 2020 2020 4956 4f55 543a 206f  r..     IVOUT: o
│ │ │ │ +00029340: 7574 7075 7420 6172 7261 7920 7769 7468  utput array with
│ │ │ │ +00029350: 206e 6577 6c79 2061 6c6c 6f63 6174 6564   newly allocated
│ │ │ │ +00029360: 2075 7064 6174 6564 2069 6e69 7469 616c   updated initial
│ │ │ │ +00029370: 697a 6174 696f 6e0a 2020 2020 2076 6563  ization.     vec
│ │ │ │ +00029380: 746f 722e 0a20 2020 2020 4956 4f55 544c  tor..     IVOUTL
│ │ │ │ +00029390: 454e 3a20 7369 7a65 206f 6620 6f75 7470  EN: size of outp
│ │ │ │ +000293a0: 7574 2061 7272 6179 2077 6974 6820 7570  ut array with up
│ │ │ │ +000293b0: 6461 7465 6420 696e 6974 6961 6c69 7a61  dated initializa
│ │ │ │ +000293c0: 7469 6f6e 2076 6563 746f 722e 0a0a 2020  tion vector...  
│ │ │ │ +000293d0: 2020 2049 4e3a 2069 6e70 7574 2061 7272     IN: input arr
│ │ │ │ +000293e0: 6179 2077 6974 6820 6461 7461 2074 6f20  ay with data to 
│ │ │ │ +000293f0: 6465 6372 7970 742e 0a20 2020 2020 494e  decrypt..     IN
│ │ │ │ +00029400: 4c45 4e3a 2073 697a 6520 6f66 2069 6e70  LEN: size of inp
│ │ │ │ +00029410: 7574 2061 7272 6179 2077 6974 6820 6461  ut array with da
│ │ │ │ +00029420: 7461 2074 6f20 6465 6372 7970 742e 0a20  ta to decrypt.. 
│ │ │ │ +00029430: 2020 2020 4f55 543a 206f 7574 7075 7420      OUT: output 
│ │ │ │ +00029440: 6172 7261 7920 7769 7468 206e 6577 6c79  array with newly
│ │ │ │ +00029450: 2061 6c6c 6f63 6174 6564 2064 6563 7279   allocated decry
│ │ │ │ +00029460: 7074 6564 2064 6174 612e 0a20 2020 2020  pted data..     
│ │ │ │ +00029470: 4f55 544c 454e 3a20 6f75 7470 7574 2076  OUTLEN: output v
│ │ │ │ +00029480: 6172 6961 626c 6520 7769 7468 2073 697a  ariable with siz
│ │ │ │ +00029490: 6520 6f66 206e 6577 6c79 2061 6c6c 6f63  e of newly alloc
│ │ │ │ +000294a0: 6174 6564 206f 7574 7075 7420 6172 7261  ated output arra
│ │ │ │ +000294b0: 792e 0a0a 2020 2020 202a 4465 7363 7269  y...     *Descri
│ │ │ │ +000294c0: 7074 696f 6e3a 2a20 4465 6372 7970 7473  ption:* Decrypts
│ │ │ │ +000294d0: 2064 6174 6120 7573 696e 6720 7370 6563   data using spec
│ │ │ │ +000294e0: 6966 6965 6420 696e 6974 6961 6c69 7a61  ified initializa
│ │ │ │ +000294f0: 7469 6f6e 2076 6563 746f 720a 2020 2020  tion vector.    
│ │ │ │ +00029500: 2061 6e64 206b 6579 2e20 2054 6865 206b   and key.  The k
│ │ │ │ +00029510: 6579 2061 6374 7561 6c6c 7920 7573 6564  ey actually used
│ │ │ │ +00029520: 2069 7320 6465 7269 7665 6420 7573 696e   is derived usin
│ │ │ │ +00029530: 6720 7468 6520 6b65 7920 7573 6167 652e  g the key usage.
│ │ │ │ +00029540: 2020 4966 0a20 2020 2020 6b65 7920 7573    If.     key us
│ │ │ │ +00029550: 6167 6520 6973 2030 2c20 6e6f 206b 6579  age is 0, no key
│ │ │ │ +00029560: 2064 6572 6976 6174 696f 6e20 6973 2075   derivation is u
│ │ │ │ +00029570: 7365 642e 2020 5468 6520 4f55 5420 6275  sed.  The OUT bu
│ │ │ │ +00029580: 6666 6572 206d 7573 7420 6265 0a20 2020  ffer must be.   
│ │ │ │ +00029590: 2020 6465 616c 6c6f 6361 7465 6420 6279    deallocated by
│ │ │ │ +000295a0: 2074 6865 2063 616c 6c65 722e 2020 4966   the caller.  If
│ │ │ │ +000295b0: 2049 564f 5554 206f 7220 4956 4f55 544c   IVOUT or IVOUTL
│ │ │ │ +000295c0: 454e 2069 7320 4e55 4c4c 2c20 7468 650a  EN is NULL, the.
│ │ │ │ +000295d0: 2020 2020 2075 7064 6174 6564 2049 5620       updated IV 
│ │ │ │ +000295e0: 6973 206e 6f74 2073 6176 6564 2061 6e79  is not saved any
│ │ │ │ +000295f0: 7768 6572 652e 0a0a 2020 2020 204e 6f74  where...     Not
│ │ │ │ +00029600: 6520 7468 6174 2044 4543 5259 5054 2845  e that DECRYPT(E
│ │ │ │ +00029610: 4e43 5259 5054 2864 6174 6129 2920 646f  NCRYPT(data)) do
│ │ │ │ +00029620: 6573 206e 6f74 206e 6563 6573 7361 7269  es not necessari
│ │ │ │ +00029630: 6c79 2079 6965 6c64 2064 6174 610a 2020  ly yield data.  
│ │ │ │ +00029640: 2020 2065 7861 6374 6c79 2e20 2053 6f6d     exactly.  Som
│ │ │ │ +00029650: 6520 656e 6372 7970 7469 6f6e 2074 7970  e encryption typ
│ │ │ │ +00029660: 6573 2061 6464 2070 6164 2074 6f20 6d61  es add pad to ma
│ │ │ │ +00029670: 6b65 2074 6865 2064 6174 6120 6669 7420  ke the data fit 
│ │ │ │ +00029680: 696e 746f 0a20 2020 2020 7468 6520 626c  into.     the bl
│ │ │ │ +00029690: 6f63 6b20 7369 7a65 206f 6620 7468 6520  ock size of the 
│ │ │ │ +000296a0: 656e 6372 7970 7469 6f6e 2061 6c67 6f72  encryption algor
│ │ │ │ +000296b0: 6974 686d 2e20 2046 7572 7468 6572 6d6f  ithm.  Furthermo
│ │ │ │ +000296c0: 7265 2c20 7468 6520 7061 640a 2020 2020  re, the pad.    
│ │ │ │ +000296d0: 2069 7320 6e6f 7420 6775 6172 616e 7465   is not guarante
│ │ │ │ +000296e0: 6564 2074 6f20 6c6f 6f6b 2069 6e20 616e  ed to look in an
│ │ │ │ +000296f0: 7920 7370 6563 6961 6c20 7761 792c 2061  y special way, a
│ │ │ │ +00029700: 6c74 686f 7567 6820 6578 6973 7469 6e67  lthough existing
│ │ │ │ +00029710: 0a20 2020 2020 696d 706c 656d 656e 7461  .     implementa
│ │ │ │ +00029720: 7469 6f6e 7320 6f66 7465 6e20 7061 6420  tions often pad 
│ │ │ │ +00029730: 7769 7468 2074 6865 207a 6572 6f20 6279  with the zero by
│ │ │ │ +00029740: 7465 2e20 2054 6869 7320 6d65 616e 7320  te.  This means 
│ │ │ │ +00029750: 7468 6174 2079 6f75 0a20 2020 2020 6d61  that you.     ma
│ │ │ │ +00029760: 7920 6861 7665 2074 6f20 2266 7261 6d65  y have to "frame
│ │ │ │ +00029770: 2220 6461 7461 2c20 736f 2069 7420 6973  " data, so it is
│ │ │ │ +00029780: 2070 6f73 7369 626c 6520 746f 2069 6e66   possible to inf
│ │ │ │ +00029790: 6572 2074 6865 206f 7269 6769 6e61 6c0a  er the original.
│ │ │ │ +000297a0: 2020 2020 206c 656e 6774 6820 6166 7465       length afte
│ │ │ │ +000297b0: 7220 6465 6372 7970 7469 6f6e 2e20 2043  r decryption.  C
│ │ │ │ +000297c0: 6f6d 7061 7265 2041 534e 2e31 2044 4552  ompare ASN.1 DER
│ │ │ │ +000297d0: 2077 6869 6368 2063 6f6e 7461 696e 7320   which contains 
│ │ │ │ +000297e0: 7375 6368 0a20 2020 2020 696e 666f 726d  such.     inform
│ │ │ │ +000297f0: 6174 696f 6e2e 0a0a 2020 2020 202a 5265  ation...     *Re
│ │ │ │ +00029800: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ +00029810: 7572 6e73 20e2 8098 5348 4953 4849 5f4f  urns ...SHISHI_O
│ │ │ │ +00029820: 4be2 8099 2069 6666 2073 7563 6365 7373  K... iff success
│ │ │ │ +00029830: 6675 6c2e 0a0a 7368 6973 6869 5f64 6563  ful...shishi_dec
│ │ │ │ +00029840: 7279 7074 5f69 760a 2d2d 2d2d 2d2d 2d2d  rypt_iv.--------
│ │ │ │ +00029850: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +00029860: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ +00029870: 7368 695f 6465 6372 7970 745f 6976 2028  shi_decrypt_iv (
│ │ │ │ +00029880: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ +00029890: 2053 6869 7368 695f 6b65 7920 2a20 4b45   Shishi_key * KE
│ │ │ │ +000298a0: 592c 0a20 2020 2020 2020 2020 2069 6e74  Y,.          int
│ │ │ │ +000298b0: 204b 4559 5553 4147 452c 2063 6f6e 7374   KEYUSAGE, const
│ │ │ │ +000298c0: 2063 6861 7220 2a20 4956 2c20 7369 7a65   char * IV, size
│ │ │ │ +000298d0: 5f74 2049 564c 454e 2c20 636f 6e73 7420  _t IVLEN, const 
│ │ │ │ +000298e0: 6368 6172 202a 2049 4e2c 0a20 2020 2020  char * IN,.     
│ │ │ │ +000298f0: 2020 2020 2073 697a 655f 7420 494e 4c45       size_t INLE
│ │ │ │ +00029900: 4e2c 2063 6861 7220 2a2a 204f 5554 2c20  N, char ** OUT, 
│ │ │ │ +00029910: 7369 7a65 5f74 202a 204f 5554 4c45 4e29  size_t * OUTLEN)
│ │ │ │ +00029920: 0a20 2020 2020 4841 4e44 4c45 3a20 7368  .     HANDLE: sh
│ │ │ │ +00029930: 6973 6869 2068 616e 646c 6520 6173 2061  ishi handle as a
│ │ │ │ +00029940: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ +00029950: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ +00029960: 0a20 2020 2020 4b45 593a 206b 6579 2074  .     KEY: key t
│ │ │ │ +00029970: 6f20 6465 6372 7970 7420 7769 7468 2e0a  o decrypt with..
│ │ │ │ +00029980: 2020 2020 204b 4559 5553 4147 453a 2069       KEYUSAGE: i
│ │ │ │ +00029990: 6e74 6567 6572 2073 7065 6369 6679 696e  nteger specifyin
│ │ │ │ +000299a0: 6720 7768 6174 2074 6869 7320 6b65 7920  g what this key 
│ │ │ │ +000299b0: 6973 2064 6563 7279 7074 696e 672e 0a20  is decrypting.. 
│ │ │ │ +000299c0: 2020 2020 4956 3a20 696e 7075 7420 6172      IV: input ar
│ │ │ │ +000299d0: 7261 7920 7769 7468 2069 6e69 7469 616c  ray with initial
│ │ │ │ +000299e0: 697a 6174 696f 6e20 7665 6374 6f72 0a20  ization vector. 
│ │ │ │ +000299f0: 2020 2020 4956 4c45 4e3a 2073 697a 6520      IVLEN: size 
│ │ │ │ +00029a00: 6f66 2069 6e70 7574 2061 7272 6179 2077  of input array w
│ │ │ │ +00029a10: 6974 6820 696e 6974 6961 6c69 7a61 7469  ith initializati
│ │ │ │ +00029a20: 6f6e 2076 6563 746f 722e 0a20 2020 2020  on vector..     
│ │ │ │ +00029a30: 494e 3a20 696e 7075 7420 6172 7261 7920  IN: input array 
│ │ │ │ +00029a40: 7769 7468 2064 6174 6120 746f 2064 6563  with data to dec
│ │ │ │ +00029a50: 7279 7074 2e0a 2020 2020 2049 4e4c 454e  rypt..     INLEN
│ │ │ │ +00029a60: 3a20 7369 7a65 206f 6620 696e 7075 7420  : size of input 
│ │ │ │ +00029a70: 6172 7261 7920 7769 7468 2064 6174 6120  array with data 
│ │ │ │ +00029a80: 746f 2064 6563 7279 7074 2e0a 2020 2020  to decrypt..    
│ │ │ │ +00029a90: 204f 5554 3a20 6f75 7470 7574 2061 7272   OUT: output arr
│ │ │ │ +00029aa0: 6179 2077 6974 6820 6e65 776c 7920 616c  ay with newly al
│ │ │ │ +00029ab0: 6c6f 6361 7465 6420 6465 6372 7970 7465  located decrypte
│ │ │ │ +00029ac0: 6420 6461 7461 2e0a 2020 2020 204f 5554  d data..     OUT
│ │ │ │ +00029ad0: 4c45 4e3a 206f 7574 7075 7420 7661 7269  LEN: output vari
│ │ │ │ +00029ae0: 6162 6c65 2077 6974 6820 7369 7a65 206f  able with size o
│ │ │ │ +00029af0: 6620 6e65 776c 7920 616c 6c6f 6361 7465  f newly allocate
│ │ │ │ +00029b00: 6420 6f75 7470 7574 2061 7272 6179 2e0a  d output array..
│ │ │ │ +00029b10: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +00029b20: 6f6e 3a2a 2044 6563 7279 7074 7320 6461  on:* Decrypts da
│ │ │ │ +00029b30: 7461 2075 7369 6e67 2073 7065 6369 6669  ta using specifi
│ │ │ │ +00029b40: 6564 2069 6e69 7469 616c 697a 6174 696f  ed initializatio
│ │ │ │ +00029b50: 6e20 7665 6374 6f72 0a20 2020 2020 616e  n vector.     an
│ │ │ │ +00029b60: 6420 6b65 792e 2020 5468 6520 6b65 7920  d key.  The key 
│ │ │ │ +00029b70: 6163 7475 616c 6c79 2075 7365 6420 6973  actually used is
│ │ │ │ +00029b80: 2064 6572 6976 6564 2075 7369 6e67 2074   derived using t
│ │ │ │ +00029b90: 6865 206b 6579 2075 7361 6765 2e20 2049  he key usage.  I
│ │ │ │ +00029ba0: 660a 2020 2020 206b 6579 2075 7361 6765  f.     key usage
│ │ │ │ +00029bb0: 2069 7320 302c 206e 6f20 6b65 7920 6465   is 0, no key de
│ │ │ │ +00029bc0: 7269 7661 7469 6f6e 2069 7320 7573 6564  rivation is used
│ │ │ │ +00029bd0: 2e20 2054 6865 204f 5554 2062 7566 6665  .  The OUT buffe
│ │ │ │ +00029be0: 7220 6d75 7374 2062 650a 2020 2020 2064  r must be.     d
│ │ │ │ +00029bf0: 6561 6c6c 6f63 6174 6564 2062 7920 7468  eallocated by th
│ │ │ │ +00029c00: 6520 6361 6c6c 6572 2e20 2054 6865 206e  e caller.  The n
│ │ │ │ +00029c10: 6578 7420 4956 2069 7320 6c6f 7374 2c20  ext IV is lost, 
│ │ │ │ +00029c20: 7365 650a 2020 2020 2073 6869 7368 695f  see.     shishi_
│ │ │ │ +00029c30: 6465 6372 7970 745f 6976 7570 6461 7465  decrypt_ivupdate
│ │ │ │ +00029c40: 5f65 7479 7065 2069 6620 796f 7520 6e65  _etype if you ne
│ │ │ │ +00029c50: 6564 2069 742e 0a0a 2020 2020 204e 6f74  ed it...     Not
│ │ │ │ +00029c60: 6520 7468 6174 2044 4543 5259 5054 2845  e that DECRYPT(E
│ │ │ │ +00029c70: 4e43 5259 5054 2864 6174 6129 2920 646f  NCRYPT(data)) do
│ │ │ │ +00029c80: 6573 206e 6f74 206e 6563 6573 7361 7269  es not necessari
│ │ │ │ +00029c90: 6c79 2079 6965 6c64 2064 6174 610a 2020  ly yield data.  
│ │ │ │ +00029ca0: 2020 2065 7861 6374 6c79 2e20 2053 6f6d     exactly.  Som
│ │ │ │ +00029cb0: 6520 656e 6372 7970 7469 6f6e 2074 7970  e encryption typ
│ │ │ │ +00029cc0: 6573 2061 6464 2070 6164 2074 6f20 6d61  es add pad to ma
│ │ │ │ +00029cd0: 6b65 2074 6865 2064 6174 6120 6669 7420  ke the data fit 
│ │ │ │ +00029ce0: 696e 746f 0a20 2020 2020 7468 6520 626c  into.     the bl
│ │ │ │ +00029cf0: 6f63 6b20 7369 7a65 206f 6620 7468 6520  ock size of the 
│ │ │ │ +00029d00: 656e 6372 7970 7469 6f6e 2061 6c67 6f72  encryption algor
│ │ │ │ +00029d10: 6974 686d 2e20 2046 7572 7468 6572 6d6f  ithm.  Furthermo
│ │ │ │ +00029d20: 7265 2c20 7468 6520 7061 640a 2020 2020  re, the pad.    
│ │ │ │ +00029d30: 2069 7320 6e6f 7420 6775 6172 616e 7465   is not guarante
│ │ │ │ +00029d40: 6564 2074 6f20 6c6f 6f6b 2069 6e20 616e  ed to look in an
│ │ │ │ +00029d50: 7920 7370 6563 6961 6c20 7761 792c 2061  y special way, a
│ │ │ │ +00029d60: 6c74 686f 7567 6820 6578 6973 7469 6e67  lthough existing
│ │ │ │ +00029d70: 0a20 2020 2020 696d 706c 656d 656e 7461  .     implementa
│ │ │ │ +00029d80: 7469 6f6e 7320 6f66 7465 6e20 7061 6420  tions often pad 
│ │ │ │ +00029d90: 7769 7468 2074 6865 207a 6572 6f20 6279  with the zero by
│ │ │ │ +00029da0: 7465 2e20 2054 6869 7320 6d65 616e 7320  te.  This means 
│ │ │ │ +00029db0: 7468 6174 2079 6f75 0a20 2020 2020 6d61  that you.     ma
│ │ │ │ +00029dc0: 7920 6861 7665 2074 6f20 2266 7261 6d65  y have to "frame
│ │ │ │ +00029dd0: 2220 6461 7461 2c20 736f 2069 7420 6973  " data, so it is
│ │ │ │ +00029de0: 2070 6f73 7369 626c 6520 746f 2069 6e66   possible to inf
│ │ │ │ +00029df0: 6572 2074 6865 206f 7269 6769 6e61 6c0a  er the original.
│ │ │ │ +00029e00: 2020 2020 206c 656e 6774 6820 6166 7465       length afte
│ │ │ │ +00029e10: 7220 6465 6372 7970 7469 6f6e 2e20 2043  r decryption.  C
│ │ │ │ +00029e20: 6f6d 7061 7265 2041 534e 2e31 2044 4552  ompare ASN.1 DER
│ │ │ │ +00029e30: 2077 6869 6368 2063 6f6e 7461 696e 7320   which contains 
│ │ │ │ +00029e40: 7375 6368 0a20 2020 2020 696e 666f 726d  such.     inform
│ │ │ │ +00029e50: 6174 696f 6e2e 0a0a 2020 2020 202a 5265  ation...     *Re
│ │ │ │ +00029e60: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ +00029e70: 7572 6e73 20e2 8098 5348 4953 4849 5f4f  urns ...SHISHI_O
│ │ │ │ +00029e80: 4be2 8099 2069 6666 2073 7563 6365 7373  K... iff success
│ │ │ │ +00029e90: 6675 6c2e 0a0a 7368 6973 6869 5f64 6563  ful...shishi_dec
│ │ │ │ +00029ea0: 7279 7074 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  rypt.-----------
│ │ │ │ +00029eb0: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ +00029ec0: 6e3a 2069 6e74 2073 6869 7368 695f 6465  n: int shishi_de
│ │ │ │ +00029ed0: 6372 7970 7420 2853 6869 7368 6920 2a20  crypt (Shishi * 
│ │ │ │ +00029ee0: 4841 4e44 4c45 2c20 5368 6973 6869 5f6b  HANDLE, Shishi_k
│ │ │ │ +00029ef0: 6579 202a 204b 4559 2c0a 2020 2020 2020  ey * KEY,.      
│ │ │ │ +00029f00: 2020 2020 696e 7420 4b45 5955 5341 4745      int KEYUSAGE
│ │ │ │ +00029f10: 2c20 636f 6e73 7420 6368 6172 202a 2049  , const char * I
│ │ │ │ +00029f20: 4e2c 2073 697a 655f 7420 494e 4c45 4e2c  N, size_t INLEN,
│ │ │ │ +00029f30: 2063 6861 7220 2a2a 204f 5554 2c0a 2020   char ** OUT,.  
│ │ │ │ +00029f40: 2020 2020 2020 2020 7369 7a65 5f74 202a          size_t *
│ │ │ │ +00029f50: 204f 5554 4c45 4e29 0a20 2020 2020 4841   OUTLEN).     HA
│ │ │ │ +00029f60: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ +00029f70: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ +00029f80: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ +00029f90: 6974 2829 e280 992e 0a20 2020 2020 4b45  it().....     KE
│ │ │ │ +00029fa0: 593a 206b 6579 2074 6f20 6465 6372 7970  Y: key to decryp
│ │ │ │ +00029fb0: 7420 7769 7468 2e0a 2020 2020 204b 4559  t with..     KEY
│ │ │ │ +00029fc0: 5553 4147 453a 2069 6e74 6567 6572 2073  USAGE: integer s
│ │ │ │ +00029fd0: 7065 6369 6679 696e 6720 7768 6174 2074  pecifying what t
│ │ │ │ +00029fe0: 6869 7320 6b65 7920 6973 2064 6563 7279  his key is decry
│ │ │ │ +00029ff0: 7074 696e 672e 0a20 2020 2020 494e 3a20  pting..     IN: 
│ │ │ │ +0002a000: 696e 7075 7420 6172 7261 7920 7769 7468  input array with
│ │ │ │ +0002a010: 2064 6174 6120 746f 2064 6563 7279 7074   data to decrypt
│ │ │ │ +0002a020: 2e0a 2020 2020 2049 4e4c 454e 3a20 7369  ..     INLEN: si
│ │ │ │ +0002a030: 7a65 206f 6620 696e 7075 7420 6172 7261  ze of input arra
│ │ │ │ +0002a040: 7920 7769 7468 2064 6174 6120 746f 2064  y with data to d
│ │ │ │ +0002a050: 6563 7279 7074 2e0a 2020 2020 204f 5554  ecrypt..     OUT
│ │ │ │ +0002a060: 3a20 6f75 7470 7574 2061 7272 6179 2077  : output array w
│ │ │ │ +0002a070: 6974 6820 6e65 776c 7920 616c 6c6f 6361  ith newly alloca
│ │ │ │ +0002a080: 7465 6420 6465 6372 7970 7465 6420 6461  ted decrypted da
│ │ │ │ +0002a090: 7461 2e0a 2020 2020 204f 5554 4c45 4e3a  ta..     OUTLEN:
│ │ │ │ +0002a0a0: 206f 7574 7075 7420 7661 7269 6162 6c65   output variable
│ │ │ │ +0002a0b0: 2077 6974 6820 7369 7a65 206f 6620 6e65   with size of ne
│ │ │ │ +0002a0c0: 776c 7920 616c 6c6f 6361 7465 6420 6f75  wly allocated ou
│ │ │ │ +0002a0d0: 7470 7574 2061 7272 6179 2e0a 0a20 2020  tput array...   
│ │ │ │ +0002a0e0: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ +0002a0f0: 2044 6563 7279 7074 7320 6461 7461 2073   Decrypts data s
│ │ │ │ +0002a100: 7065 6369 6669 6564 206b 6579 2e20 2054  pecified key.  T
│ │ │ │ +0002a110: 6865 206b 6579 2061 6374 7561 6c6c 7920  he key actually 
│ │ │ │ +0002a120: 7573 6564 0a20 2020 2020 6973 2064 6572  used.     is der
│ │ │ │ +0002a130: 6976 6564 2075 7369 6e67 2074 6865 206b  ived using the k
│ │ │ │ +0002a140: 6579 2075 7361 6765 2e20 2049 6620 6b65  ey usage.  If ke
│ │ │ │ +0002a150: 7920 7573 6167 6520 6973 2030 2c20 6e6f  y usage is 0, no
│ │ │ │ +0002a160: 206b 6579 0a20 2020 2020 6465 7269 7661   key.     deriva
│ │ │ │ +0002a170: 7469 6f6e 2069 7320 7573 6564 2e20 2054  tion is used.  T
│ │ │ │ +0002a180: 6865 204f 5554 2062 7566 6665 7220 6d75  he OUT buffer mu
│ │ │ │ +0002a190: 7374 2062 6520 6465 616c 6c6f 6361 7465  st be deallocate
│ │ │ │ +0002a1a0: 6420 6279 2074 6865 0a20 2020 2020 6361  d by the.     ca
│ │ │ │ +0002a1b0: 6c6c 6572 2e20 2054 6865 2064 6566 6175  ller.  The defau
│ │ │ │ +0002a1c0: 6c74 2049 5620 6973 2075 7365 642c 2073  lt IV is used, s
│ │ │ │ +0002a1d0: 6565 2073 6869 7368 695f 6465 6372 7970  ee shishi_decryp
│ │ │ │ +0002a1e0: 745f 6976 2069 6620 796f 7520 6e65 6564  t_iv if you need
│ │ │ │ +0002a1f0: 0a20 2020 2020 746f 2061 6c74 6572 2069  .     to alter i
│ │ │ │ +0002a200: 742e 2020 5468 6520 6e65 7874 2049 5620  t.  The next IV 
│ │ │ │ +0002a210: 6973 206c 6f73 742c 2073 6565 2073 6869  is lost, see shi
│ │ │ │ +0002a220: 7368 695f 6465 6372 7970 745f 6976 7570  shi_decrypt_ivup
│ │ │ │ +0002a230: 6461 7465 2069 660a 2020 2020 2079 6f75  date if.     you
│ │ │ │ +0002a240: 206e 6565 6420 6974 2e0a 0a20 2020 2020   need it...     
│ │ │ │ +0002a250: 4e6f 7465 2074 6861 7420 4445 4352 5950  Note that DECRYP
│ │ │ │ +0002a260: 5428 454e 4352 5950 5428 6461 7461 2929  T(ENCRYPT(data))
│ │ │ │ +0002a270: 2064 6f65 7320 6e6f 7420 6e65 6365 7373   does not necess
│ │ │ │ +0002a280: 6172 696c 7920 7969 656c 6420 6461 7461  arily yield data
│ │ │ │ +0002a290: 0a20 2020 2020 6578 6163 746c 792e 2020  .     exactly.  
│ │ │ │ +0002a2a0: 536f 6d65 2065 6e63 7279 7074 696f 6e20  Some encryption 
│ │ │ │ +0002a2b0: 7479 7065 7320 6164 6420 7061 6420 746f  types add pad to
│ │ │ │ +0002a2c0: 206d 616b 6520 7468 6520 6461 7461 2066   make the data f
│ │ │ │ +0002a2d0: 6974 2069 6e74 6f0a 2020 2020 2074 6865  it into.     the
│ │ │ │ +0002a2e0: 2062 6c6f 636b 2073 697a 6520 6f66 2074   block size of t
│ │ │ │ +0002a2f0: 6865 2065 6e63 7279 7074 696f 6e20 616c  he encryption al
│ │ │ │ +0002a300: 676f 7269 7468 6d2e 2020 4675 7274 6865  gorithm.  Furthe
│ │ │ │ +0002a310: 726d 6f72 652c 2074 6865 2070 6164 0a20  rmore, the pad. 
│ │ │ │ +0002a320: 2020 2020 6973 206e 6f74 2067 7561 7261      is not guara
│ │ │ │ +0002a330: 6e74 6565 6420 746f 206c 6f6f 6b20 696e  nteed to look in
│ │ │ │ +0002a340: 2061 6e79 2073 7065 6369 616c 2077 6179   any special way
│ │ │ │ +0002a350: 2c20 616c 7468 6f75 6768 2065 7869 7374  , although exist
│ │ │ │ +0002a360: 696e 670a 2020 2020 2069 6d70 6c65 6d65  ing.     impleme
│ │ │ │ +0002a370: 6e74 6174 696f 6e73 206f 6674 656e 2070  ntations often p
│ │ │ │ +0002a380: 6164 2077 6974 6820 7468 6520 7a65 726f  ad with the zero
│ │ │ │ +0002a390: 2062 7974 652e 2020 5468 6973 206d 6561   byte.  This mea
│ │ │ │ +0002a3a0: 6e73 2074 6861 7420 796f 750a 2020 2020  ns that you.    
│ │ │ │ +0002a3b0: 206d 6179 2068 6176 6520 746f 2022 6672   may have to "fr
│ │ │ │ +0002a3c0: 616d 6522 2064 6174 612c 2073 6f20 6974  ame" data, so it
│ │ │ │ +0002a3d0: 2069 7320 706f 7373 6962 6c65 2074 6f20   is possible to 
│ │ │ │ +0002a3e0: 696e 6665 7220 7468 6520 6f72 6967 696e  infer the origin
│ │ │ │ +0002a3f0: 616c 0a20 2020 2020 6c65 6e67 7468 2061  al.     length a
│ │ │ │ +0002a400: 6674 6572 2064 6563 7279 7074 696f 6e2e  fter decryption.
│ │ │ │ +0002a410: 2020 436f 6d70 6172 6520 4153 4e2e 3120    Compare ASN.1 
│ │ │ │ +0002a420: 4445 5220 7768 6963 6820 636f 6e74 6169  DER which contai
│ │ │ │ +0002a430: 6e73 2073 7563 680a 2020 2020 2069 6e66  ns such.     inf
│ │ │ │ +0002a440: 6f72 6d61 7469 6f6e 2e0a 0a20 2020 2020  ormation...     
│ │ │ │ +0002a450: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ +0002a460: 5265 7475 726e 7320 e280 9853 4849 5348  Returns ...SHISH
│ │ │ │ +0002a470: 495f 4f4b e280 9920 6966 6620 7375 6363  I_OK... iff succ
│ │ │ │ +0002a480: 6573 7366 756c 2e0a 0a73 6869 7368 695f  essful...shishi_
│ │ │ │ +0002a490: 6e5f 666f 6c64 0a2d 2d2d 2d2d 2d2d 2d2d  n_fold.---------
│ │ │ │ +0002a4a0: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ +0002a4b0: 6f6e 3a20 696e 7420 7368 6973 6869 5f6e  on: int shishi_n
│ │ │ │ +0002a4c0: 5f66 6f6c 6420 2853 6869 7368 6920 2a20  _fold (Shishi * 
│ │ │ │ +0002a4d0: 4841 4e44 4c45 2c20 636f 6e73 7420 6368  HANDLE, const ch
│ │ │ │ +0002a4e0: 6172 202a 2049 4e2c 0a20 2020 2020 2020  ar * IN,.       
│ │ │ │ +0002a4f0: 2020 2073 697a 655f 7420 494e 4c45 4e2c     size_t INLEN,
│ │ │ │ +0002a500: 2063 6861 7220 2a20 4f55 542c 2073 697a   char * OUT, siz
│ │ │ │ +0002a510: 655f 7420 4f55 544c 454e 290a 2020 2020  e_t OUTLEN).    
│ │ │ │ +0002a520: 2048 414e 444c 453a 2073 6869 7368 6920   HANDLE: shishi 
│ │ │ │ +0002a530: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ +0002a540: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ +0002a550: 5f69 6e69 7428 29e2 8099 2e0a 2020 2020  _init().....    
│ │ │ │ +0002a560: 2049 4e3a 2069 6e70 7574 2061 7272 6179   IN: input array
│ │ │ │ +0002a570: 2077 6974 6820 6461 7461 2074 6f20 6465   with data to de
│ │ │ │ +0002a580: 6372 7970 742e 0a20 2020 2020 494e 4c45  crypt..     INLE
│ │ │ │ +0002a590: 4e3a 2073 697a 6520 6f66 2069 6e70 7574  N: size of input
│ │ │ │ +0002a5a0: 2061 7272 6179 2077 6974 6820 6461 7461   array with data
│ │ │ │ +0002a5b0: 2074 6f20 6465 6372 7970 7420 2822 4d22   to decrypt ("M"
│ │ │ │ +0002a5c0: 292e 0a20 2020 2020 4f55 543a 206f 7574  )..     OUT: out
│ │ │ │ +0002a5d0: 7075 7420 6172 7261 7920 7769 7468 2064  put array with d
│ │ │ │ +0002a5e0: 6563 7279 7074 6564 2064 6174 612e 0a20  ecrypted data.. 
│ │ │ │ +0002a5f0: 2020 2020 4f55 544c 454e 3a20 7369 7a65      OUTLEN: size
│ │ │ │ +0002a600: 206f 6620 6f75 7470 7574 2061 7272 6179   of output array
│ │ │ │ +0002a610: 2028 224e 2229 2e0a 0a20 2020 2020 2a44   ("N")...     *D
│ │ │ │ +0002a620: 6573 6372 6970 7469 6f6e 3a2a 2046 6f6c  escription:* Fol
│ │ │ │ +0002a630: 6420 6461 7461 2069 6e74 6f20 6120 6669  d data into a fi
│ │ │ │ +0002a640: 7865 6420 6c65 6e67 7468 206f 7574 7075  xed length outpu
│ │ │ │ +0002a650: 7420 6172 7261 792c 2077 6974 6820 7468  t array, with th
│ │ │ │ +0002a660: 650a 2020 2020 2069 6e74 656e 7420 746f  e.     intent to
│ │ │ │ +0002a670: 2067 6976 6520 6561 6368 2069 6e70 7574   give each input
│ │ │ │ +0002a680: 2062 6974 2061 7070 726f 7869 6d61 7465   bit approximate
│ │ │ │ +0002a690: 6c79 2065 7175 616c 2077 6569 6768 7420  ly equal weight 
│ │ │ │ +0002a6a0: 696e 0a20 2020 2020 6465 7465 726d 696e  in.     determin
│ │ │ │ +0002a6b0: 696e 6720 7468 6520 7661 6c75 6520 6f66  ing the value of
│ │ │ │ +0002a6c0: 2065 6163 6820 6f75 7470 7574 2062 6974   each output bit
│ │ │ │ +0002a6d0: 2e0a 0a20 2020 2020 5468 6520 616c 676f  ...     The algo
│ │ │ │ +0002a6e0: 7269 7468 6d20 6973 2066 726f 6d20 2241  rithm is from "A
│ │ │ │ +0002a6f0: 2042 6574 7465 7220 4b65 7920 5363 6865   Better Key Sche
│ │ │ │ +0002a700: 6475 6c65 2046 6f72 2044 4553 2d6c 696b  dule For DES-lik
│ │ │ │ +0002a710: 6520 4369 7068 6572 7322 0a20 2020 2020  e Ciphers".     
│ │ │ │ +0002a720: 6279 2055 7269 2042 6c75 6d65 6e74 6861  by Uri Blumentha
│ │ │ │ +0002a730: 6c20 616e 6420 5374 6576 656e 204d 2e20  l and Steven M. 
│ │ │ │ +0002a740: 4265 6c6c 6f76 696e 2c0a 2020 2020 2068  Bellovin,.     h
│ │ │ │ +0002a750: 7474 703a 2f2f 7777 772e 7265 7365 6172  ttp://www.resear
│ │ │ │ +0002a760: 6368 2e61 7474 2e63 6f6d 2f7e 736d 622f  ch.att.com/~smb/
│ │ │ │ +0002a770: 7061 7065 7273 2f69 6465 732e 7064 662c  papers/ides.pdf,
│ │ │ │ +0002a780: 2061 6c74 686f 7567 6820 7468 650a 2020   although the.  
│ │ │ │ +0002a790: 2020 2073 616d 706c 6520 7665 6374 6f72     sample vector
│ │ │ │ +0002a7a0: 7320 7072 6f76 6964 6564 2062 7920 7468  s provided by th
│ │ │ │ +0002a7b0: 6520 7061 7065 7220 6172 6520 696e 636f  e paper are inco
│ │ │ │ +0002a7c0: 7272 6563 742e 0a0a 2020 2020 202a 5265  rrect...     *Re
│ │ │ │ +0002a7d0: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ +0002a7e0: 7572 6e73 20e2 8098 5348 4953 4849 5f4f  urns ...SHISHI_O
│ │ │ │ +0002a7f0: 4be2 8099 2069 6666 2073 7563 6365 7373  K... iff success
│ │ │ │ +0002a800: 6675 6c2e 0a0a 7368 6973 6869 5f64 720a  ful...shishi_dr.
│ │ │ │ +0002a810: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +0002a820: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ +0002a830: 7368 695f 6472 2028 5368 6973 6869 202a  shi_dr (Shishi *
│ │ │ │ +0002a840: 2048 414e 444c 452c 2053 6869 7368 695f   HANDLE, Shishi_
│ │ │ │ +0002a850: 6b65 7920 2a20 4b45 592c 0a20 2020 2020  key * KEY,.     
│ │ │ │ +0002a860: 2020 2020 2063 6f6e 7374 2063 6861 7220       const char 
│ │ │ │ +0002a870: 2a20 5052 4643 4f4e 5354 414e 542c 2073  * PRFCONSTANT, s
│ │ │ │ +0002a880: 697a 655f 7420 5052 4643 4f4e 5354 414e  ize_t PRFCONSTAN
│ │ │ │ +0002a890: 544c 454e 2c0a 2020 2020 2020 2020 2020  TLEN,.          
│ │ │ │ +0002a8a0: 6368 6172 202a 2044 4552 4956 4544 5241  char * DERIVEDRA
│ │ │ │ +0002a8b0: 4e44 4f4d 2c20 7369 7a65 5f74 2044 4552  NDOM, size_t DER
│ │ │ │ +0002a8c0: 4956 4544 5241 4e44 4f4d 4c45 4e29 0a20  IVEDRANDOMLEN). 
│ │ │ │ +0002a8d0: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ +0002a8e0: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ +0002a8f0: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ +0002a900: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ +0002a910: 2020 2020 4b45 593a 2069 6e70 7574 2061      KEY: input a
│ │ │ │ +0002a920: 7272 6179 2077 6974 6820 6372 7970 746f  rray with crypto
│ │ │ │ +0002a930: 6772 6170 6869 6320 6b65 7920 746f 2075  graphic key to u
│ │ │ │ +0002a940: 7365 2e0a 2020 2020 2050 5246 434f 4e53  se..     PRFCONS
│ │ │ │ +0002a950: 5441 4e54 3a20 696e 7075 7420 6172 7261  TANT: input arra
│ │ │ │ +0002a960: 7920 7769 7468 2074 6865 2063 6f6e 7374  y with the const
│ │ │ │ +0002a970: 616e 7420 7374 7269 6e67 2e0a 2020 2020  ant string..    
│ │ │ │ +0002a980: 2050 5246 434f 4e53 5441 4e54 4c45 4e3a   PRFCONSTANTLEN:
│ │ │ │ +0002a990: 2073 697a 6520 6f66 2069 6e70 7574 2061   size of input a
│ │ │ │ +0002a9a0: 7272 6179 2077 6974 6820 7468 6520 636f  rray with the co
│ │ │ │ +0002a9b0: 6e73 7461 6e74 2073 7472 696e 672e 0a20  nstant string.. 
│ │ │ │ +0002a9c0: 2020 2020 4445 5249 5645 4452 414e 444f      DERIVEDRANDO
│ │ │ │ +0002a9d0: 4d3a 206f 7574 7075 7420 6172 7261 7920  M: output array 
│ │ │ │ +0002a9e0: 7769 7468 2064 6572 6976 6564 2072 616e  with derived ran
│ │ │ │ +0002a9f0: 646f 6d20 6461 7461 2e0a 2020 2020 2044  dom data..     D
│ │ │ │ +0002aa00: 4552 4956 4544 5241 4e44 4f4d 4c45 4e3a  ERIVEDRANDOMLEN:
│ │ │ │ +0002aa10: 2073 697a 6520 6f66 206f 7574 7075 7420   size of output 
│ │ │ │ +0002aa20: 6172 7261 7920 7769 7468 2064 6572 6976  array with deriv
│ │ │ │ +0002aa30: 6564 2072 616e 646f 6d20 6461 7461 2e0a  ed random data..
│ │ │ │ +0002aa40: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +0002aa50: 6f6e 3a2a 2044 6572 6976 6520 2272 616e  on:* Derive "ran
│ │ │ │ +0002aa60: 646f 6d22 2064 6174 6120 6672 6f6d 2061  dom" data from a
│ │ │ │ +0002aa70: 206b 6579 2061 6e64 2061 2063 6f6e 7374   key and a const
│ │ │ │ +0002aa80: 616e 740a 2020 2020 2074 6875 736c 793a  ant.     thusly:
│ │ │ │ +0002aa90: 2044 5228 4b45 592c 2050 5246 434f 4e53   DR(KEY, PRFCONS
│ │ │ │ +0002aaa0: 5441 4e54 2920 3d20 5452 554e 4341 5445  TANT) = TRUNCATE
│ │ │ │ +0002aab0: 2844 4552 4956 4544 5241 4e44 4f4d 4c45  (DERIVEDRANDOMLE
│ │ │ │ +0002aac0: 4e2c 0a20 2020 2020 5348 4953 4849 5f45  N,.     SHISHI_E
│ │ │ │ +0002aad0: 4e43 5259 5054 284b 4559 2c20 5052 4643  NCRYPT(KEY, PRFC
│ │ │ │ +0002aae0: 4f4e 5354 414e 5429 292e 0a0a 2020 2020  ONSTANT))...    
│ │ │ │ +0002aaf0: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ +0002ab00: 2052 6574 7572 6e73 20e2 8098 5348 4953   Returns ...SHIS
│ │ │ │ +0002ab10: 4849 5f4f 4be2 8099 2069 6666 2073 7563  HI_OK... iff suc
│ │ │ │ +0002ab20: 6365 7373 6675 6c2e 0a0a 7368 6973 6869  cessful...shishi
│ │ │ │ +0002ab30: 5f64 6b0a 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  _dk.---------.. 
│ │ │ │ +0002ab40: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ +0002ab50: 2073 6869 7368 695f 646b 2028 5368 6973   shishi_dk (Shis
│ │ │ │ +0002ab60: 6869 202a 2048 414e 444c 452c 2053 6869  hi * HANDLE, Shi
│ │ │ │ +0002ab70: 7368 695f 6b65 7920 2a20 4b45 592c 0a20  shi_key * KEY,. 
│ │ │ │ +0002ab80: 2020 2020 2020 2020 2063 6f6e 7374 2063           const c
│ │ │ │ +0002ab90: 6861 7220 2a20 5052 4643 4f4e 5354 414e  har * PRFCONSTAN
│ │ │ │ +0002aba0: 542c 2073 697a 655f 7420 5052 4643 4f4e  T, size_t PRFCON
│ │ │ │ +0002abb0: 5354 414e 544c 454e 2c0a 2020 2020 2020  STANTLEN,.      
│ │ │ │ +0002abc0: 2020 2020 5368 6973 6869 5f6b 6579 202a      Shishi_key *
│ │ │ │ +0002abd0: 2044 4552 4956 4544 4b45 5929 0a20 2020   DERIVEDKEY).   
│ │ │ │ +0002abe0: 2020 4841 4e44 4c45 3a20 7368 6973 6869    HANDLE: shishi
│ │ │ │ +0002abf0: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ +0002ac00: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ +0002ac10: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ +0002ac20: 2020 4b45 593a 2069 6e70 7574 2063 7279    KEY: input cry
│ │ │ │ +0002ac30: 7074 6f67 7261 7068 6963 206b 6579 2074  ptographic key t
│ │ │ │ +0002ac40: 6f20 7573 652e 0a20 2020 2020 5052 4643  o use..     PRFC
│ │ │ │ +0002ac50: 4f4e 5354 414e 543a 2069 6e70 7574 2061  ONSTANT: input a
│ │ │ │ +0002ac60: 7272 6179 2077 6974 6820 7468 6520 636f  rray with the co
│ │ │ │ +0002ac70: 6e73 7461 6e74 2073 7472 696e 672e 0a20  nstant string.. 
│ │ │ │ +0002ac80: 2020 2020 5052 4643 4f4e 5354 414e 544c      PRFCONSTANTL
│ │ │ │ +0002ac90: 454e 3a20 7369 7a65 206f 6620 696e 7075  EN: size of inpu
│ │ │ │ +0002aca0: 7420 6172 7261 7920 7769 7468 2074 6865  t array with the
│ │ │ │ +0002acb0: 2063 6f6e 7374 616e 7420 7374 7269 6e67   constant string
│ │ │ │ +0002acc0: 2e0a 2020 2020 2044 4552 4956 4544 4b45  ..     DERIVEDKE
│ │ │ │ +0002acd0: 593a 2070 6f69 6e74 6572 2074 6f20 6465  Y: pointer to de
│ │ │ │ +0002ace0: 7269 7665 6420 6b65 7920 2861 6c6c 6f63  rived key (alloc
│ │ │ │ +0002acf0: 6174 6564 2062 7920 6361 6c6c 6572 292e  ated by caller).
│ │ │ │ +0002ad00: 0a0a 2020 2020 202a 4465 7269 7665 2061  ..     *Derive a
│ │ │ │ +0002ad10: 206b 6579 2066 726f 6d20 6120 6b65 7920   key from a key 
│ │ │ │ +0002ad20: 616e 6420 6120 636f 6e73 7461 6e74 2074  and a constant t
│ │ │ │ +0002ad30: 6875 736c 793a 2a20 444b 284b 4559 2c0a  husly:* DK(KEY,.
│ │ │ │ +0002ad40: 2020 2020 2050 5246 434f 4e53 5441 4e54       PRFCONSTANT
│ │ │ │ +0002ad50: 2920 3d20 5348 4953 4849 5f52 414e 444f  ) = SHISHI_RANDO
│ │ │ │ +0002ad60: 4d2d 544f 2d4b 4559 2853 4849 5348 495f  M-TO-KEY(SHISHI_
│ │ │ │ +0002ad70: 4452 284b 4559 2c20 5052 4643 4f4e 5354  DR(KEY, PRFCONST
│ │ │ │ +0002ad80: 414e 5429 292e 0a0a 2020 2020 202a 5265  ANT))...     *Re
│ │ │ │ +0002ad90: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ +0002ada0: 7572 6e73 20e2 8098 5348 4953 4849 5f4f  urns ...SHISHI_O
│ │ │ │ +0002adb0: 4be2 8099 2069 6666 2073 7563 6365 7373  K... iff success
│ │ │ │ +0002adc0: 6675 6c2e 0a0a 2020 2041 6e20 6561 7369  ful...   An easi
│ │ │ │ +0002add0: 6572 2077 6179 2074 6f20 7573 6520 656e  er way to use en
│ │ │ │ +0002ade0: 6372 7970 7469 6f6e 2061 6e64 2064 6563  cryption and dec
│ │ │ │ +0002adf0: 7279 7074 696f 6e20 6966 2079 6f75 7220  ryption if your 
│ │ │ │ +0002ae00: 6170 706c 6963 6174 696f 6e0a 7265 7065  application.repe
│ │ │ │ +0002ae10: 6174 6564 6c79 2063 616c 6c73 2c20 652e  atedly calls, e.
│ │ │ │ +0002ae20: 672e 2c20 e280 9873 6869 7368 695f 656e  g., ...shishi_en
│ │ │ │ +0002ae30: 6372 7970 745f 6976 7570 6461 7465 e280  crypt_ivupdate..
│ │ │ │ +0002ae40: 992c 2069 7320 746f 2075 7365 2074 6865  ., is to use the
│ │ │ │ +0002ae50: 0a66 6f6c 6c6f 7769 6e67 2066 756e 6374  .following funct
│ │ │ │ +0002ae60: 696f 6e73 2e20 2054 6865 7920 7374 6f72  ions.  They stor
│ │ │ │ +0002ae70: 6520 7468 6520 6b65 792c 2069 6e69 7469  e the key, initi
│ │ │ │ +0002ae80: 616c 697a 6174 696f 6e20 7665 6374 6f72  alization vector
│ │ │ │ +0002ae90: 2c20 6574 632c 2069 6e0a 6120 636f 6e74  , etc, in.a cont
│ │ │ │ +0002aea0: 6578 742c 2061 6e64 2074 6865 2065 6e63  ext, and the enc
│ │ │ │ +0002aeb0: 7279 7074 696f 6e20 616e 6420 6465 6372  ryption and decr
│ │ │ │ +0002aec0: 7970 7469 6f6e 206f 7065 7261 7469 6f6e  yption operation
│ │ │ │ +0002aed0: 7320 7570 6461 7465 2074 6865 2049 560a  s update the IV.
│ │ │ │ +0002aee0: 7769 7468 696e 2074 6865 2063 6f6e 7465  within the conte
│ │ │ │ +0002aef0: 7874 2061 7574 6f6d 6174 6963 616c 6c79  xt automatically
│ │ │ │ +0002af00: 2e0a 0a73 6869 7368 695f 6372 7970 746f  ...shishi_crypto
│ │ │ │ +0002af10: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  .-------------..
│ │ │ │ +0002af20: 202d 2d20 4675 6e63 7469 6f6e 3a20 5368   -- Function: Sh
│ │ │ │ +0002af30: 6973 6869 5f63 7279 7074 6f20 2a20 7368  ishi_crypto * sh
│ │ │ │ +0002af40: 6973 6869 5f63 7279 7074 6f20 2853 6869  ishi_crypto (Shi
│ │ │ │ +0002af50: 7368 6920 2a20 4841 4e44 4c45 2c0a 2020  shi * HANDLE,.  
│ │ │ │ +0002af60: 2020 2020 2020 2020 5368 6973 6869 5f6b          Shishi_k
│ │ │ │ +0002af70: 6579 202a 204b 4559 2c20 696e 7420 4b45  ey * KEY, int KE
│ │ │ │ +0002af80: 5955 5341 4745 2c20 696e 7433 325f 7420  YUSAGE, int32_t 
│ │ │ │ +0002af90: 4554 5950 452c 0a20 2020 2020 2020 2020  ETYPE,.         
│ │ │ │ +0002afa0: 2063 6f6e 7374 2063 6861 7220 2a20 4956   const char * IV
│ │ │ │ +0002afb0: 2c20 7369 7a65 5f74 2049 564c 454e 290a  , size_t IVLEN).
│ │ │ │ +0002afc0: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ +0002afd0: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ +0002afe0: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ +0002aff0: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ +0002b000: 2020 2020 204b 4559 3a20 6b65 7920 746f       KEY: key to
│ │ │ │ +0002b010: 2065 6e63 7279 7074 2077 6974 682e 0a20   encrypt with.. 
│ │ │ │ +0002b020: 2020 2020 4b45 5955 5341 4745 3a20 696e      KEYUSAGE: in
│ │ │ │ +0002b030: 7465 6765 7220 7370 6563 6966 7969 6e67  teger specifying
│ │ │ │ +0002b040: 2077 6861 7420 7468 6973 206b 6579 2077   what this key w
│ │ │ │ +0002b050: 696c 6c20 656e 6372 7970 742f 6465 6372  ill encrypt/decr
│ │ │ │ +0002b060: 7970 742e 0a20 2020 2020 4554 5950 453a  ypt..     ETYPE:
│ │ │ │ +0002b070: 2069 6e74 6567 6572 2073 7065 6369 6679   integer specify
│ │ │ │ +0002b080: 696e 6720 7768 6174 2063 6970 6865 7220  ing what cipher 
│ │ │ │ +0002b090: 746f 2075 7365 2e0a 2020 2020 2049 563a  to use..     IV:
│ │ │ │ +0002b0a0: 2069 6e70 7574 2061 7272 6179 2077 6974   input array wit
│ │ │ │ +0002b0b0: 6820 696e 6974 6961 6c69 7a61 7469 6f6e  h initialization
│ │ │ │ +0002b0c0: 2076 6563 746f 720a 2020 2020 2049 564c   vector.     IVL
│ │ │ │ +0002b0d0: 454e 3a20 7369 7a65 206f 6620 696e 7075  EN: size of inpu
│ │ │ │ +0002b0e0: 7420 6172 7261 7920 7769 7468 2069 6e69  t array with ini
│ │ │ │ +0002b0f0: 7469 616c 697a 6174 696f 6e20 7665 6374  tialization vect
│ │ │ │ +0002b100: 6f72 2e0a 0a20 2020 2020 2a44 6573 6372  or...     *Descr
│ │ │ │ +0002b110: 6970 7469 6f6e 3a2a 2049 6e69 7469 616c  iption:* Initial
│ │ │ │ +0002b120: 697a 6520 6120 6372 7970 746f 2063 6f6e  ize a crypto con
│ │ │ │ +0002b130: 7465 7874 2e20 2054 6869 7320 7374 6f72  text.  This stor
│ │ │ │ +0002b140: 6520 6120 6b65 792c 0a20 2020 2020 6b65  e a key,.     ke
│ │ │ │ +0002b150: 7975 7361 6765 2c20 656e 6372 7970 7469  yusage, encrypti
│ │ │ │ +0002b160: 6f6e 2074 7970 6520 616e 6420 696e 6974  on type and init
│ │ │ │ +0002b170: 6961 6c69 7a61 7469 6f6e 2076 6563 746f  ialization vecto
│ │ │ │ +0002b180: 7220 696e 2061 2022 636f 6e74 6578 7422  r in a "context"
│ │ │ │ +0002b190: 2c0a 2020 2020 2061 6e64 2074 6865 2063  ,.     and the c
│ │ │ │ +0002b1a0: 616c 6c65 7220 6361 6e20 7468 656e 2075  aller can then u
│ │ │ │ +0002b1b0: 7365 2074 6869 7320 636f 6e74 6578 7420  se this context 
│ │ │ │ +0002b1c0: 746f 2070 6572 666f 726d 2065 6e63 7279  to perform encry
│ │ │ │ +0002b1d0: 7074 696f 6e20 7669 610a 2020 2020 20e2  ption via.     .
│ │ │ │ +0002b1e0: 8098 7368 6973 6869 5f63 7279 7074 6f5f  ..shishi_crypto_
│ │ │ │ +0002b1f0: 656e 6372 7970 7428 29e2 8099 2061 6e64  encrypt()... and
│ │ │ │ +0002b200: 2064 6563 7279 7074 696f 6e20 7669 610a   decryption via.
│ │ │ │ +0002b210: 2020 2020 20e2 8098 7368 6973 6869 5f63       ...shishi_c
│ │ │ │ +0002b220: 7279 7074 6f5f 656e 6372 7970 7428 29e2  rypto_encrypt().
│ │ │ │ +0002b230: 8099 2077 6974 686f 7574 2073 7570 706c  .. without suppl
│ │ │ │ +0002b240: 7969 6e67 2061 6c6c 2074 686f 7365 2064  ying all those d
│ │ │ │ +0002b250: 6574 6169 6c73 0a20 2020 2020 6167 6169  etails.     agai
│ │ │ │ +0002b260: 6e2e 2020 5468 6520 6675 6e63 7469 6f6e  n.  The function
│ │ │ │ +0002b270: 7320 616c 736f 2074 616b 6573 2063 6172  s also takes car
│ │ │ │ +0002b280: 6520 6f66 2070 726f 7061 6761 7469 6e67  e of propagating
│ │ │ │ +0002b290: 2074 6865 2049 5620 6265 7477 6565 6e0a   the IV between.
│ │ │ │ +0002b2a0: 2020 2020 2063 616c 6c73 2e0a 0a20 2020       calls...   
│ │ │ │ +0002b2b0: 2020 5768 656e 2074 6865 2061 7070 6c69    When the appli
│ │ │ │ +0002b2c0: 6361 7469 6f6e 206e 6f20 6c6f 6e67 6572  cation no longer
│ │ │ │ +0002b2d0: 206e 6565 6420 746f 2075 7365 2074 6865   need to use the
│ │ │ │ +0002b2e0: 2063 6f6e 7465 7874 2c20 6974 2073 686f   context, it sho
│ │ │ │ +0002b2f0: 756c 640a 2020 2020 2064 6561 6c6c 6f63  uld.     dealloc
│ │ │ │ +0002b300: 6174 6520 7265 736f 7572 6365 7320 6173  ate resources as
│ │ │ │ +0002b310: 736f 6369 6174 6564 2077 6974 6820 6974  sociated with it
│ │ │ │ +0002b320: 2062 7920 6361 6c6c 696e 670a 2020 2020   by calling.    
│ │ │ │ +0002b330: 20e2 8098 7368 6973 6869 5f63 7279 7074   ...shishi_crypt
│ │ │ │ +0002b340: 6f5f 636c 6f73 6528 29e2 8099 2e0a 0a20  o_close()...... 
│ │ │ │ +0002b350: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ +0002b360: 653a 2a20 5265 7475 726e 2061 206e 6577  e:* Return a new
│ │ │ │ +0002b370: 6c79 2061 6c6c 6f63 6174 6564 2063 7279  ly allocated cry
│ │ │ │ +0002b380: 7074 6f20 636f 6e74 6578 742e 0a0a 7368  pto context...sh
│ │ │ │ +0002b390: 6973 6869 5f63 7279 7074 6f5f 656e 6372  ishi_crypto_encr
│ │ │ │ +0002b3a0: 7970 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ypt.------------
│ │ │ │ +0002b3b0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +0002b3c0: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ +0002b3d0: 7368 695f 6372 7970 746f 5f65 6e63 7279  shi_crypto_encry
│ │ │ │ +0002b3e0: 7074 2028 5368 6973 6869 5f63 7279 7074  pt (Shishi_crypt
│ │ │ │ +0002b3f0: 6f20 2a20 4354 582c 0a20 2020 2020 2020  o * CTX,.       
│ │ │ │ +0002b400: 2020 2063 6f6e 7374 2063 6861 7220 2a20     const char * 
│ │ │ │ +0002b410: 494e 2c20 7369 7a65 5f74 2049 4e4c 454e  IN, size_t INLEN
│ │ │ │ +0002b420: 2c20 6368 6172 202a 2a20 4f55 542c 2073  , char ** OUT, s
│ │ │ │ +0002b430: 697a 655f 7420 2a20 4f55 544c 454e 290a  ize_t * OUTLEN).
│ │ │ │ +0002b440: 2020 2020 2043 5458 3a20 6372 7970 746f       CTX: crypto
│ │ │ │ +0002b450: 2063 6f6e 7465 7874 2061 7320 7265 7475   context as retu
│ │ │ │ +0002b460: 726e 6564 2062 7920 e280 9873 6869 7368  rned by ...shish
│ │ │ │ +0002b470: 695f 6372 7970 746f 2829 e280 992e 0a20  i_crypto()..... 
│ │ │ │ +0002b480: 2020 2020 494e 3a20 696e 7075 7420 6172      IN: input ar
│ │ │ │ +0002b490: 7261 7920 7769 7468 2064 6174 6120 746f  ray with data to
│ │ │ │ +0002b4a0: 2065 6e63 7279 7074 2e0a 2020 2020 2049   encrypt..     I
│ │ │ │ +0002b4b0: 4e4c 454e 3a20 7369 7a65 206f 6620 696e  NLEN: size of in
│ │ │ │ +0002b4c0: 7075 7420 6172 7261 7920 7769 7468 2064  put array with d
│ │ │ │ +0002b4d0: 6174 6120 746f 2065 6e63 7279 7074 2e0a  ata to encrypt..
│ │ │ │ +0002b4e0: 2020 2020 204f 5554 3a20 6f75 7470 7574       OUT: output
│ │ │ │ +0002b4f0: 2061 7272 6179 2077 6974 6820 6e65 776c   array with newl
│ │ │ │ +0002b500: 7920 616c 6c6f 6361 7465 6420 656e 6372  y allocated encr
│ │ │ │ +0002b510: 7970 7465 6420 6461 7461 2e0a 2020 2020  ypted data..    
│ │ │ │ +0002b520: 204f 5554 4c45 4e3a 206f 7574 7075 7420   OUTLEN: output 
│ │ │ │ +0002b530: 7661 7269 6162 6c65 2077 6974 6820 7369  variable with si
│ │ │ │ +0002b540: 7a65 206f 6620 6e65 776c 7920 616c 6c6f  ze of newly allo
│ │ │ │ +0002b550: 6361 7465 6420 6f75 7470 7574 2061 7272  cated output arr
│ │ │ │ +0002b560: 6179 2e0a 0a20 2020 2020 2a44 6573 6372  ay...     *Descr
│ │ │ │ +0002b570: 6970 7469 6f6e 3a2a 2045 6e63 7279 7074  iption:* Encrypt
│ │ │ │ +0002b580: 2064 6174 612c 2075 7369 6e67 2069 6e66   data, using inf
│ │ │ │ +0002b590: 6f72 6d61 7469 6f6e 2028 652e 672e 2c20  ormation (e.g., 
│ │ │ │ +0002b5a0: 6b65 7920 616e 640a 2020 2020 2069 6e69  key and.     ini
│ │ │ │ +0002b5b0: 7469 616c 697a 6174 696f 6e20 7665 6374  tialization vect
│ │ │ │ +0002b5c0: 6f72 2920 6672 6f6d 2063 6f6e 7465 7874  or) from context
│ │ │ │ +0002b5d0: 2e20 2054 6865 2049 5620 6973 2075 7064  .  The IV is upd
│ │ │ │ +0002b5e0: 6174 6564 2069 6e73 6964 6520 7468 650a  ated inside the.
│ │ │ │ +0002b5f0: 2020 2020 2063 6f6e 7465 7874 2061 6674       context aft
│ │ │ │ +0002b600: 6572 2074 6869 7320 6361 6c6c 2e0a 0a20  er this call... 
│ │ │ │ +0002b610: 2020 2020 5768 656e 2074 6865 2061 7070      When the app
│ │ │ │ +0002b620: 6c69 6361 7469 6f6e 206e 6f20 6c6f 6e67  lication no long
│ │ │ │ +0002b630: 6572 206e 6565 6420 746f 2075 7365 2074  er need to use t
│ │ │ │ +0002b640: 6865 2063 6f6e 7465 7874 2c20 6974 2073  he context, it s
│ │ │ │ +0002b650: 686f 756c 640a 2020 2020 2064 6561 6c6c  hould.     deall
│ │ │ │ +0002b660: 6f63 6174 6520 7265 736f 7572 6365 7320  ocate resources 
│ │ │ │ +0002b670: 6173 736f 6369 6174 6564 2077 6974 6820  associated with 
│ │ │ │ +0002b680: 6974 2062 7920 6361 6c6c 696e 670a 2020  it by calling.  
│ │ │ │ +0002b690: 2020 20e2 8098 7368 6973 6869 5f63 7279     ...shishi_cry
│ │ │ │ +0002b6a0: 7074 6f5f 636c 6f73 6528 29e2 8099 2e0a  pto_close().....
│ │ │ │ +0002b6b0: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ +0002b6c0: 6c75 653a 2a20 5265 7475 726e 7320 e280  lue:* Returns ..
│ │ │ │ +0002b6d0: 9853 4849 5348 495f 4f4b e280 9920 6966  .SHISHI_OK... if
│ │ │ │ +0002b6e0: 6620 7375 6363 6573 7366 756c 2e0a 0a73  f successful...s
│ │ │ │ +0002b6f0: 6869 7368 695f 6372 7970 746f 5f64 6563  hishi_crypto_dec
│ │ │ │ +0002b700: 7279 7074 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  rypt.-----------
│ │ │ │ +0002b710: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +0002b720: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ +0002b730: 6973 6869 5f63 7279 7074 6f5f 6465 6372  ishi_crypto_decr
│ │ │ │ +0002b740: 7970 7420 2853 6869 7368 695f 6372 7970  ypt (Shishi_cryp
│ │ │ │ +0002b750: 746f 202a 2043 5458 2c0a 2020 2020 2020  to * CTX,.      
│ │ │ │ +0002b760: 2020 2020 636f 6e73 7420 6368 6172 202a      const char *
│ │ │ │ +0002b770: 2049 4e2c 2073 697a 655f 7420 494e 4c45   IN, size_t INLE
│ │ │ │ +0002b780: 4e2c 2063 6861 7220 2a2a 204f 5554 2c20  N, char ** OUT, 
│ │ │ │ +0002b790: 7369 7a65 5f74 202a 204f 5554 4c45 4e29  size_t * OUTLEN)
│ │ │ │ +0002b7a0: 0a20 2020 2020 4354 583a 2063 7279 7074  .     CTX: crypt
│ │ │ │ +0002b7b0: 6f20 636f 6e74 6578 7420 6173 2072 6574  o context as ret
│ │ │ │ +0002b7c0: 7572 6e65 6420 6279 20e2 8098 7368 6973  urned by ...shis
│ │ │ │ +0002b7d0: 6869 5f63 7279 7074 6f28 29e2 8099 2e0a  hi_crypto().....
│ │ │ │ +0002b7e0: 2020 2020 2049 4e3a 2069 6e70 7574 2061       IN: input a
│ │ │ │ +0002b7f0: 7272 6179 2077 6974 6820 6461 7461 2074  rray with data t
│ │ │ │ +0002b800: 6f20 6465 6372 7970 742e 0a20 2020 2020  o decrypt..     
│ │ │ │ +0002b810: 494e 4c45 4e3a 2073 697a 6520 6f66 2069  INLEN: size of i
│ │ │ │ +0002b820: 6e70 7574 2061 7272 6179 2077 6974 6820  nput array with 
│ │ │ │ +0002b830: 6461 7461 2074 6f20 6465 6372 7970 742e  data to decrypt.
│ │ │ │ +0002b840: 0a20 2020 2020 4f55 543a 206f 7574 7075  .     OUT: outpu
│ │ │ │ +0002b850: 7420 6172 7261 7920 7769 7468 206e 6577  t array with new
│ │ │ │ +0002b860: 6c79 2061 6c6c 6f63 6174 6564 2064 6563  ly allocated dec
│ │ │ │ +0002b870: 7279 7074 6564 2064 6174 612e 0a20 2020  rypted data..   
│ │ │ │ +0002b880: 2020 4f55 544c 454e 3a20 6f75 7470 7574    OUTLEN: output
│ │ │ │ +0002b890: 2076 6172 6961 626c 6520 7769 7468 2073   variable with s
│ │ │ │ +0002b8a0: 697a 6520 6f66 206e 6577 6c79 2061 6c6c  ize of newly all
│ │ │ │ +0002b8b0: 6f63 6174 6564 206f 7574 7075 7420 6172  ocated output ar
│ │ │ │ +0002b8c0: 7261 792e 0a0a 2020 2020 202a 4465 7363  ray...     *Desc
│ │ │ │ +0002b8d0: 7269 7074 696f 6e3a 2a20 4465 6372 7970  ription:* Decryp
│ │ │ │ +0002b8e0: 7420 6461 7461 2c20 7573 696e 6720 696e  t data, using in
│ │ │ │ +0002b8f0: 666f 726d 6174 696f 6e20 2865 2e67 2e2c  formation (e.g.,
│ │ │ │ +0002b900: 206b 6579 2061 6e64 0a20 2020 2020 696e   key and.     in
│ │ │ │ +0002b910: 6974 6961 6c69 7a61 7469 6f6e 2076 6563  itialization vec
│ │ │ │ +0002b920: 746f 7229 2066 726f 6d20 636f 6e74 6578  tor) from contex
│ │ │ │ +0002b930: 742e 2020 5468 6520 4956 2069 7320 7570  t.  The IV is up
│ │ │ │ +0002b940: 6461 7465 6420 696e 7369 6465 2074 6865  dated inside the
│ │ │ │ +0002b950: 0a20 2020 2020 636f 6e74 6578 7420 6166  .     context af
│ │ │ │ +0002b960: 7465 7220 7468 6973 2063 616c 6c2e 0a0a  ter this call...
│ │ │ │ +0002b970: 2020 2020 2057 6865 6e20 7468 6520 6170       When the ap
│ │ │ │ +0002b980: 706c 6963 6174 696f 6e20 6e6f 206c 6f6e  plication no lon
│ │ │ │ +0002b990: 6765 7220 6e65 6564 2074 6f20 7573 6520  ger need to use 
│ │ │ │ +0002b9a0: 7468 6520 636f 6e74 6578 742c 2069 7420  the context, it 
│ │ │ │ +0002b9b0: 7368 6f75 6c64 0a20 2020 2020 6465 616c  should.     deal
│ │ │ │ +0002b9c0: 6c6f 6361 7465 2072 6573 6f75 7263 6573  locate resources
│ │ │ │ +0002b9d0: 2061 7373 6f63 6961 7465 6420 7769 7468   associated with
│ │ │ │ +0002b9e0: 2069 7420 6279 2063 616c 6c69 6e67 0a20   it by calling. 
│ │ │ │ +0002b9f0: 2020 2020 e280 9873 6869 7368 695f 6372      ...shishi_cr
│ │ │ │ +0002ba00: 7970 746f 5f63 6c6f 7365 2829 e280 992e  ypto_close()....
│ │ │ │ +0002ba10: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ +0002ba20: 616c 7565 3a2a 2052 6574 7572 6e73 20e2  alue:* Returns .
│ │ │ │ +0002ba30: 8098 5348 4953 4849 5f4f 4be2 8099 2069  ..SHISHI_OK... i
│ │ │ │ +0002ba40: 6666 2073 7563 6365 7373 6675 6c2e 0a0a  ff successful...
│ │ │ │ +0002ba50: 7368 6973 6869 5f63 7279 7074 6f5f 636c  shishi_crypto_cl
│ │ │ │ +0002ba60: 6f73 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ose.------------
│ │ │ │ +0002ba70: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +0002ba80: 6374 696f 6e3a 2076 6f69 6420 7368 6973  ction: void shis
│ │ │ │ +0002ba90: 6869 5f63 7279 7074 6f5f 636c 6f73 6520  hi_crypto_close 
│ │ │ │ +0002baa0: 2853 6869 7368 695f 6372 7970 746f 202a  (Shishi_crypto *
│ │ │ │ +0002bab0: 2043 5458 290a 2020 2020 2043 5458 3a20   CTX).     CTX: 
│ │ │ │ +0002bac0: 6372 7970 746f 2063 6f6e 7465 7874 2061  crypto context a
│ │ │ │ +0002bad0: 7320 7265 7475 726e 6564 2062 7920 e280  s returned by ..
│ │ │ │ +0002bae0: 9873 6869 7368 695f 6372 7970 746f 2829  .shishi_crypto()
│ │ │ │ +0002baf0: e280 992e 0a0a 2020 2020 202a 4465 7363  ......     *Desc
│ │ │ │ +0002bb00: 7269 7074 696f 6e3a 2a20 4465 616c 6c6f  ription:* Deallo
│ │ │ │ +0002bb10: 6361 7465 2072 6573 6f75 7263 6573 2061  cate resources a
│ │ │ │ +0002bb20: 7373 6f63 6961 7465 6420 7769 7468 2074  ssociated with t
│ │ │ │ +0002bb30: 6865 2063 7279 7074 6f0a 2020 2020 2063  he crypto.     c
│ │ │ │ +0002bb40: 6f6e 7465 7874 2e0a 0a20 2020 416c 736f  ontext...   Also
│ │ │ │ +0002bb50: 2069 6e63 6c75 6465 6420 696e 2053 6869   included in Shi
│ │ │ │ +0002bb60: 7368 6920 6973 2061 6e20 696e 7465 7266  shi is an interf
│ │ │ │ +0002bb70: 6163 6520 746f 2074 6865 2072 6561 6c6c  ace to the reall
│ │ │ │ +0002bb80: 7920 6c6f 772d 6c65 7665 6c0a 6372 7970  y low-level.cryp
│ │ │ │ +0002bb90: 746f 6772 6170 6869 6320 7072 696d 6974  tographic primit
│ │ │ │ +0002bba0: 6976 6573 2e20 2054 6865 7920 6d61 7020  ives.  They map 
│ │ │ │ +0002bbb0: 6469 7265 6374 6c79 206f 6e20 7468 6520  directly on the 
│ │ │ │ +0002bbc0: 756e 6465 726c 7969 6e67 0a63 7279 7074  underlying.crypt
│ │ │ │ +0002bbd0: 6f67 7261 7068 6963 206c 6962 7261 7279  ographic library
│ │ │ │ +0002bbe0: 2075 7365 6420 2869 2e65 2e2c 2047 6e75   used (i.e., Gnu
│ │ │ │ +0002bbf0: 6c69 6220 6f72 204c 6962 6763 7279 7074  lib or Libgcrypt
│ │ │ │ +0002bc00: 2920 616e 6420 6973 2075 7365 640a 696e  ) and is used.in
│ │ │ │ +0002bc10: 7465 726e 616c 6c79 2062 7920 5368 6973  ternally by Shis
│ │ │ │ +0002bc20: 6869 2e0a 0a73 6869 7368 695f 7261 6e64  hi...shishi_rand
│ │ │ │ +0002bc30: 6f6d 697a 650a 2d2d 2d2d 2d2d 2d2d 2d2d  omize.----------
│ │ │ │ +0002bc40: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ +0002bc50: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ +0002bc60: 5f72 616e 646f 6d69 7a65 2028 5368 6973  _randomize (Shis
│ │ │ │ +0002bc70: 6869 202a 2048 414e 444c 452c 2069 6e74  hi * HANDLE, int
│ │ │ │ +0002bc80: 2053 5452 4f4e 472c 0a20 2020 2020 2020   STRONG,.       
│ │ │ │ +0002bc90: 2020 2076 6f69 6420 2a20 4441 5441 2c20     void * DATA, 
│ │ │ │ +0002bca0: 7369 7a65 5f74 2044 4154 414c 454e 290a  size_t DATALEN).
│ │ │ │ +0002bcb0: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ +0002bcc0: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ +0002bcd0: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ +0002bce0: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ +0002bcf0: 2020 2020 2053 5452 4f4e 473a 2030 2069       STRONG: 0 i
│ │ │ │ +0002bd00: 6666 206f 7065 7261 7469 6f6e 2073 686f  ff operation sho
│ │ │ │ +0002bd10: 756c 6420 6e6f 7420 626c 6f63 6b2c 206e  uld not block, n
│ │ │ │ +0002bd20: 6f6e 2d30 2066 6f72 2076 6572 7920 7374  on-0 for very st
│ │ │ │ +0002bd30: 726f 6e67 0a20 2020 2020 7261 6e64 6f6d  rong.     random
│ │ │ │ +0002bd40: 6e65 7373 2e0a 2020 2020 2044 4154 413a  ness..     DATA:
│ │ │ │ +0002bd50: 206f 7574 7075 7420 6172 7261 7920 746f   output array to
│ │ │ │ +0002bd60: 2062 6520 6669 6c6c 6564 2077 6974 6820   be filled with 
│ │ │ │ +0002bd70: 7261 6e64 6f6d 2064 6174 612e 0a20 2020  random data..   
│ │ │ │ +0002bd80: 2020 4441 5441 4c45 4e3a 2073 697a 6520    DATALEN: size 
│ │ │ │ +0002bd90: 6f66 206f 7574 7075 7420 6172 7261 792e  of output array.
│ │ │ │ +0002bda0: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ +0002bdb0: 696f 6e3a 2a20 5374 6f72 6520 6372 7970  ion:* Store cryp
│ │ │ │ +0002bdc0: 746f 6772 6170 6869 6361 6c6c 7920 7261  tographically ra
│ │ │ │ +0002bdd0: 6e64 6f6d 2064 6174 6120 6f66 2067 6976  ndom data of giv
│ │ │ │ +0002bde0: 656e 2073 697a 6520 696e 0a20 2020 2020  en size in.     
│ │ │ │ +0002bdf0: 7468 6520 7072 6f76 6964 6564 2062 7566  the provided buf
│ │ │ │ +0002be00: 6665 722e 0a0a 2020 2020 202a 5265 7475  fer...     *Retu
│ │ │ │ +0002be10: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ +0002be20: 6e73 20e2 8098 5348 4953 4849 5f4f 4be2  ns ...SHISHI_OK.
│ │ │ │ +0002be30: 8099 2069 6666 2073 7563 6365 7373 6675  .. iff successfu
│ │ │ │ +0002be40: 6c2e 0a0a 7368 6973 6869 5f63 7263 0a2d  l...shishi_crc.-
│ │ │ │ +0002be50: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +0002be60: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ +0002be70: 7368 695f 6372 6320 2853 6869 7368 6920  shi_crc (Shishi 
│ │ │ │ +0002be80: 2a20 4841 4e44 4c45 2c20 636f 6e73 7420  * HANDLE, const 
│ │ │ │ +0002be90: 6368 6172 202a 2049 4e2c 0a20 2020 2020  char * IN,.     
│ │ │ │ +0002bea0: 2020 2020 2073 697a 655f 7420 494e 4c45       size_t INLE
│ │ │ │ +0002beb0: 4e2c 2063 6861 7220 2a20 4f55 545b 345d  N, char * OUT[4]
│ │ │ │ +0002bec0: 290a 2020 2020 2048 414e 444c 453a 2073  ).     HANDLE: s
│ │ │ │ +0002bed0: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ +0002bee0: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ +0002bef0: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ +0002bf00: 2e0a 2020 2020 2049 4e3a 2069 6e70 7574  ..     IN: input
│ │ │ │ +0002bf10: 2063 6861 7261 6374 6572 2061 7272 6179   character array
│ │ │ │ +0002bf20: 206f 6620 6461 7461 2074 6f20 6368 6563   of data to chec
│ │ │ │ +0002bf30: 6b73 756d 2e0a 2020 2020 2049 4e4c 454e  ksum..     INLEN
│ │ │ │ +0002bf40: 3a20 6c65 6e67 7468 206f 6620 696e 7075  : length of inpu
│ │ │ │ +0002bf50: 7420 6368 6172 6163 7465 7220 6172 7261  t character arra
│ │ │ │ +0002bf60: 7920 6f66 2064 6174 6120 746f 2063 6865  y of data to che
│ │ │ │ +0002bf70: 636b 7375 6d2e 0a20 2020 2020 4f55 543a  cksum..     OUT:
│ │ │ │ +0002bf80: 206e 6577 6c79 2061 6c6c 6f63 6174 6564   newly allocated
│ │ │ │ +0002bf90: 2063 6861 7261 6374 6572 2061 7272 6179   character array
│ │ │ │ +0002bfa0: 2077 6974 6820 6368 6563 6b73 756d 206f   with checksum o
│ │ │ │ +0002bfb0: 6620 6461 7461 2e0a 0a20 2020 2020 2a44  f data...     *D
│ │ │ │ +0002bfc0: 6573 6372 6970 7469 6f6e 3a2a 2043 6f6d  escription:* Com
│ │ │ │ +0002bfd0: 7075 7465 2063 6865 636b 7375 6d20 6f66  pute checksum of
│ │ │ │ +0002bfe0: 2064 6174 6120 7573 696e 6720 4352 4333   data using CRC3
│ │ │ │ +0002bff0: 3220 6d6f 6469 6669 6564 0a20 2020 2020  2 modified.     
│ │ │ │ +0002c000: 6163 636f 7264 696e 6720 746f 2052 4643  according to RFC
│ │ │ │ +0002c010: 2031 3531 302e 2020 5468 6520 4f55 5420   1510.  The OUT 
│ │ │ │ +0002c020: 6275 6666 6572 206d 7573 7420 6265 2064  buffer must be d
│ │ │ │ +0002c030: 6561 6c6c 6f63 6174 6564 2062 7920 7468  eallocated by th
│ │ │ │ +0002c040: 650a 2020 2020 2063 616c 6c65 722e 0a0a  e.     caller...
│ │ │ │ +0002c050: 2020 2020 2054 6865 206d 6f64 6966 6963       The modific
│ │ │ │ +0002c060: 6174 696f 6e73 2063 6f6d 7061 7265 6420  ations compared 
│ │ │ │ +0002c070: 746f 2073 7461 6e64 6172 6420 4352 4333  to standard CRC3
│ │ │ │ +0002c080: 3220 6973 2074 6861 7420 6e6f 2069 6e69  2 is that no ini
│ │ │ │ +0002c090: 7469 616c 2061 6e64 0a20 2020 2020 6669  tial and.     fi
│ │ │ │ +0002c0a0: 6e61 6c20 584f 5220 6973 2070 6572 666f  nal XOR is perfo
│ │ │ │ +0002c0b0: 726d 6564 2c20 616e 6420 7468 6174 2074  rmed, and that t
│ │ │ │ +0002c0c0: 6865 206f 7574 7075 7420 6973 2072 6574  he output is ret
│ │ │ │ +0002c0d0: 7572 6e65 6420 696e 0a20 2020 2020 4c53  urned in.     LS
│ │ │ │ +0002c0e0: 422d 6669 7273 7420 6f72 6465 722e 0a0a  B-first order...
│ │ │ │ +0002c0f0: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ +0002c100: 7565 3a2a 2052 6574 7572 6e73 2053 4849  ue:* Returns SHI
│ │ │ │ +0002c110: 5348 495f 4f4b 2069 6666 2073 7563 6365  SHI_OK iff succe
│ │ │ │ +0002c120: 7373 6675 6c2e 0a0a 7368 6973 6869 5f6d  ssful...shishi_m
│ │ │ │ +0002c130: 6434 0a2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  d4.----------.. 
│ │ │ │ +0002c140: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ +0002c150: 2073 6869 7368 695f 6d64 3420 2853 6869   shishi_md4 (Shi
│ │ │ │ +0002c160: 7368 6920 2a20 4841 4e44 4c45 2c20 636f  shi * HANDLE, co
│ │ │ │ +0002c170: 6e73 7420 6368 6172 202a 2049 4e2c 0a20  nst char * IN,. 
│ │ │ │ +0002c180: 2020 2020 2020 2020 2073 697a 655f 7420           size_t 
│ │ │ │ +0002c190: 494e 4c45 4e2c 2063 6861 7220 2a20 4f55  INLEN, char * OU
│ │ │ │ +0002c1a0: 545b 3136 5d29 0a20 2020 2020 4841 4e44  T[16]).     HAND
│ │ │ │ +0002c1b0: 4c45 3a20 7368 6973 6869 2068 616e 646c  LE: shishi handl
│ │ │ │ +0002c1c0: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ +0002c1d0: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ +0002c1e0: 2829 e280 992e 0a20 2020 2020 494e 3a20  ().....     IN: 
│ │ │ │ +0002c1f0: 696e 7075 7420 6368 6172 6163 7465 7220  input character 
│ │ │ │ +0002c200: 6172 7261 7920 6f66 2064 6174 6120 746f  array of data to
│ │ │ │ +0002c210: 2068 6173 682e 0a20 2020 2020 494e 4c45   hash..     INLE
│ │ │ │ +0002c220: 4e3a 206c 656e 6774 6820 6f66 2069 6e70  N: length of inp
│ │ │ │ +0002c230: 7574 2063 6861 7261 6374 6572 2061 7272  ut character arr
│ │ │ │ +0002c240: 6179 206f 6620 6461 7461 2074 6f20 6861  ay of data to ha
│ │ │ │ +0002c250: 7368 2e0a 2020 2020 204f 5554 3a20 6e65  sh..     OUT: ne
│ │ │ │ +0002c260: 776c 7920 616c 6c6f 6361 7465 6420 6368  wly allocated ch
│ │ │ │ +0002c270: 6172 6163 7465 7220 6172 7261 7920 7769  aracter array wi
│ │ │ │ +0002c280: 7468 2068 6173 6820 6f66 2064 6174 612e  th hash of data.
│ │ │ │ +0002c290: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ +0002c2a0: 696f 6e3a 2a20 436f 6d70 7574 6520 6861  ion:* Compute ha
│ │ │ │ +0002c2b0: 7368 206f 6620 6461 7461 2075 7369 6e67  sh of data using
│ │ │ │ +0002c2c0: 204d 4434 2e20 2054 6865 204f 5554 2062   MD4.  The OUT b
│ │ │ │ +0002c2d0: 7566 6665 7220 6d75 7374 0a20 2020 2020  uffer must.     
│ │ │ │ +0002c2e0: 6265 2064 6561 6c6c 6f63 6174 6564 2062  be deallocated b
│ │ │ │ +0002c2f0: 7920 7468 6520 6361 6c6c 6572 2e0a 0a20  y the caller... 
│ │ │ │ +0002c300: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ +0002c310: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ +0002c320: 4849 5f4f 4b20 6966 6620 7375 6363 6573  HI_OK iff succes
│ │ │ │ +0002c330: 7366 756c 2e0a 0a73 6869 7368 695f 6d64  sful...shishi_md
│ │ │ │ +0002c340: 350a 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  5.----------.. -
│ │ │ │ +0002c350: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ +0002c360: 7368 6973 6869 5f6d 6435 2028 5368 6973  shishi_md5 (Shis
│ │ │ │ +0002c370: 6869 202a 2048 414e 444c 452c 2063 6f6e  hi * HANDLE, con
│ │ │ │ +0002c380: 7374 2063 6861 7220 2a20 494e 2c0a 2020  st char * IN,.  
│ │ │ │ +0002c390: 2020 2020 2020 2020 7369 7a65 5f74 2049          size_t I
│ │ │ │ +0002c3a0: 4e4c 454e 2c20 6368 6172 202a 204f 5554  NLEN, char * OUT
│ │ │ │ +0002c3b0: 5b31 365d 290a 2020 2020 2048 414e 444c  [16]).     HANDL
│ │ │ │ +0002c3c0: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ +0002c3d0: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ +0002c3e0: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ +0002c3f0: 29e2 8099 2e0a 2020 2020 2049 4e3a 2069  ).....     IN: i
│ │ │ │ +0002c400: 6e70 7574 2063 6861 7261 6374 6572 2061  nput character a
│ │ │ │ +0002c410: 7272 6179 206f 6620 6461 7461 2074 6f20  rray of data to 
│ │ │ │ +0002c420: 6861 7368 2e0a 2020 2020 2049 4e4c 454e  hash..     INLEN
│ │ │ │ +0002c430: 3a20 6c65 6e67 7468 206f 6620 696e 7075  : length of inpu
│ │ │ │ +0002c440: 7420 6368 6172 6163 7465 7220 6172 7261  t character arra
│ │ │ │ +0002c450: 7920 6f66 2064 6174 6120 746f 2068 6173  y of data to has
│ │ │ │ +0002c460: 682e 0a20 2020 2020 4f55 543a 206e 6577  h..     OUT: new
│ │ │ │ +0002c470: 6c79 2061 6c6c 6f63 6174 6564 2063 6861  ly allocated cha
│ │ │ │ +0002c480: 7261 6374 6572 2061 7272 6179 2077 6974  racter array wit
│ │ │ │ +0002c490: 6820 6861 7368 206f 6620 6461 7461 2e0a  h hash of data..
│ │ │ │ +0002c4a0: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +0002c4b0: 6f6e 3a2a 2043 6f6d 7075 7465 2068 6173  on:* Compute has
│ │ │ │ +0002c4c0: 6820 6f66 2064 6174 6120 7573 696e 6720  h of data using 
│ │ │ │ +0002c4d0: 4d44 352e 2020 5468 6520 4f55 5420 6275  MD5.  The OUT bu
│ │ │ │ +0002c4e0: 6666 6572 206d 7573 740a 2020 2020 2062  ffer must.     b
│ │ │ │ +0002c4f0: 6520 6465 616c 6c6f 6361 7465 6420 6279  e deallocated by
│ │ │ │ +0002c500: 2074 6865 2063 616c 6c65 722e 0a0a 2020   the caller...  
│ │ │ │ +0002c510: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ +0002c520: 3a2a 2052 6574 7572 6e73 2053 4849 5348  :* Returns SHISH
│ │ │ │ +0002c530: 495f 4f4b 2069 6666 2073 7563 6365 7373  I_OK iff success
│ │ │ │ +0002c540: 6675 6c2e 0a0a 7368 6973 6869 5f68 6d61  ful...shishi_hma
│ │ │ │ +0002c550: 635f 6d64 350a 2d2d 2d2d 2d2d 2d2d 2d2d  c_md5.----------
│ │ │ │ +0002c560: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +0002c570: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ +0002c580: 686d 6163 5f6d 6435 2028 5368 6973 6869  hmac_md5 (Shishi
│ │ │ │ +0002c590: 202a 2048 414e 444c 452c 2063 6f6e 7374   * HANDLE, const
│ │ │ │ +0002c5a0: 2063 6861 7220 2a20 4b45 592c 0a20 2020   char * KEY,.   
│ │ │ │ +0002c5b0: 2020 2020 2020 2073 697a 655f 7420 4b45         size_t KE
│ │ │ │ +0002c5c0: 594c 454e 2c20 636f 6e73 7420 6368 6172  YLEN, const char
│ │ │ │ +0002c5d0: 202a 2049 4e2c 2073 697a 655f 7420 494e   * IN, size_t IN
│ │ │ │ +0002c5e0: 4c45 4e2c 0a20 2020 2020 2020 2020 2063  LEN,.          c
│ │ │ │ +0002c5f0: 6861 7220 2a20 4f55 5448 4153 485b 3136  har * OUTHASH[16
│ │ │ │ +0002c600: 5d29 0a20 2020 2020 4841 4e44 4c45 3a20  ]).     HANDLE: 
│ │ │ │ +0002c610: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ +0002c620: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ +0002c630: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ +0002c640: 992e 0a20 2020 2020 4b45 593a 2069 6e70  ...     KEY: inp
│ │ │ │ +0002c650: 7574 2063 6861 7261 6374 6572 2061 7272  ut character arr
│ │ │ │ +0002c660: 6179 2077 6974 6820 6b65 7920 746f 2075  ay with key to u
│ │ │ │ +0002c670: 7365 2e0a 2020 2020 204b 4559 4c45 4e3a  se..     KEYLEN:
│ │ │ │ +0002c680: 206c 656e 6774 6820 6f66 2069 6e70 7574   length of input
│ │ │ │ +0002c690: 2063 6861 7261 6374 6572 2061 7272 6179   character array
│ │ │ │ +0002c6a0: 2077 6974 6820 6b65 7920 746f 2075 7365   with key to use
│ │ │ │ +0002c6b0: 2e0a 2020 2020 2049 4e3a 2069 6e70 7574  ..     IN: input
│ │ │ │ +0002c6c0: 2063 6861 7261 6374 6572 2061 7272 6179   character array
│ │ │ │ +0002c6d0: 206f 6620 6461 7461 2074 6f20 6861 7368   of data to hash
│ │ │ │ +0002c6e0: 2e0a 2020 2020 2049 4e4c 454e 3a20 6c65  ..     INLEN: le
│ │ │ │ +0002c6f0: 6e67 7468 206f 6620 696e 7075 7420 6368  ngth of input ch
│ │ │ │ +0002c700: 6172 6163 7465 7220 6172 7261 7920 6f66  aracter array of
│ │ │ │ +0002c710: 2064 6174 6120 746f 2068 6173 682e 0a20   data to hash.. 
│ │ │ │ +0002c720: 2020 2020 4f55 5448 4153 483a 206e 6577      OUTHASH: new
│ │ │ │ +0002c730: 6c79 2061 6c6c 6f63 6174 6564 2063 6861  ly allocated cha
│ │ │ │ +0002c740: 7261 6374 6572 2061 7272 6179 2077 6974  racter array wit
│ │ │ │ +0002c750: 6820 6b65 7965 6420 6861 7368 206f 6620  h keyed hash of 
│ │ │ │ +0002c760: 6461 7461 2e0a 0a20 2020 2020 2a44 6573  data...     *Des
│ │ │ │ +0002c770: 6372 6970 7469 6f6e 3a2a 2043 6f6d 7075  cription:* Compu
│ │ │ │ +0002c780: 7465 206b 6579 6564 2063 6865 636b 7375  te keyed checksu
│ │ │ │ +0002c790: 6d20 6f66 2064 6174 6120 7573 696e 6720  m of data using 
│ │ │ │ +0002c7a0: 484d 4143 2d4d 4435 2e20 2054 6865 0a20  HMAC-MD5.  The. 
│ │ │ │ +0002c7b0: 2020 2020 4f55 5448 4153 4820 6275 6666      OUTHASH buff
│ │ │ │ +0002c7c0: 6572 206d 7573 7420 6265 2064 6561 6c6c  er must be deall
│ │ │ │ +0002c7d0: 6f63 6174 6564 2062 7920 7468 6520 6361  ocated by the ca
│ │ │ │ +0002c7e0: 6c6c 6572 2e0a 0a20 2020 2020 2a52 6574  ller...     *Ret
│ │ │ │ +0002c7f0: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ +0002c800: 726e 7320 5348 4953 4849 5f4f 4b20 6966  rns SHISHI_OK if
│ │ │ │ +0002c810: 6620 7375 6363 6573 7366 756c 2e0a 0a73  f successful...s
│ │ │ │ +0002c820: 6869 7368 695f 686d 6163 5f73 6861 310a  hishi_hmac_sha1.
│ │ │ │ +0002c830: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +0002c840: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +0002c850: 696e 7420 7368 6973 6869 5f68 6d61 635f  int shishi_hmac_
│ │ │ │ +0002c860: 7368 6131 2028 5368 6973 6869 202a 2048  sha1 (Shishi * H
│ │ │ │ +0002c870: 414e 444c 452c 2063 6f6e 7374 2063 6861  ANDLE, const cha
│ │ │ │ +0002c880: 7220 2a20 4b45 592c 0a20 2020 2020 2020  r * KEY,.       
│ │ │ │ +0002c890: 2020 2073 697a 655f 7420 4b45 594c 454e     size_t KEYLEN
│ │ │ │ +0002c8a0: 2c20 636f 6e73 7420 6368 6172 202a 2049  , const char * I
│ │ │ │ +0002c8b0: 4e2c 2073 697a 655f 7420 494e 4c45 4e2c  N, size_t INLEN,
│ │ │ │ +0002c8c0: 0a20 2020 2020 2020 2020 2063 6861 7220  .          char 
│ │ │ │ +0002c8d0: 2a20 4f55 5448 4153 485b 3230 5d29 0a20  * OUTHASH[20]). 
│ │ │ │ +0002c8e0: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ +0002c8f0: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ +0002c900: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ +0002c910: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ +0002c920: 2020 2020 4b45 593a 2069 6e70 7574 2063      KEY: input c
│ │ │ │ +0002c930: 6861 7261 6374 6572 2061 7272 6179 2077  haracter array w
│ │ │ │ +0002c940: 6974 6820 6b65 7920 746f 2075 7365 2e0a  ith key to use..
│ │ │ │ +0002c950: 2020 2020 204b 4559 4c45 4e3a 206c 656e       KEYLEN: len
│ │ │ │ +0002c960: 6774 6820 6f66 2069 6e70 7574 2063 6861  gth of input cha
│ │ │ │ +0002c970: 7261 6374 6572 2061 7272 6179 2077 6974  racter array wit
│ │ │ │ +0002c980: 6820 6b65 7920 746f 2075 7365 2e0a 2020  h key to use..  
│ │ │ │ +0002c990: 2020 2049 4e3a 2069 6e70 7574 2063 6861     IN: input cha
│ │ │ │ +0002c9a0: 7261 6374 6572 2061 7272 6179 206f 6620  racter array of 
│ │ │ │ +0002c9b0: 6461 7461 2074 6f20 6861 7368 2e0a 2020  data to hash..  
│ │ │ │ +0002c9c0: 2020 2049 4e4c 454e 3a20 6c65 6e67 7468     INLEN: length
│ │ │ │ +0002c9d0: 206f 6620 696e 7075 7420 6368 6172 6163   of input charac
│ │ │ │ +0002c9e0: 7465 7220 6172 7261 7920 6f66 2064 6174  ter array of dat
│ │ │ │ +0002c9f0: 6120 746f 2068 6173 682e 0a20 2020 2020  a to hash..     
│ │ │ │ +0002ca00: 4f55 5448 4153 483a 206e 6577 6c79 2061  OUTHASH: newly a
│ │ │ │ +0002ca10: 6c6c 6f63 6174 6564 2063 6861 7261 6374  llocated charact
│ │ │ │ +0002ca20: 6572 2061 7272 6179 2077 6974 6820 6b65  er array with ke
│ │ │ │ +0002ca30: 7965 6420 6861 7368 206f 6620 6461 7461  yed hash of data
│ │ │ │ +0002ca40: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ +0002ca50: 7469 6f6e 3a2a 2043 6f6d 7075 7465 206b  tion:* Compute k
│ │ │ │ +0002ca60: 6579 6564 2063 6865 636b 7375 6d20 6f66  eyed checksum of
│ │ │ │ +0002ca70: 2064 6174 6120 7573 696e 6720 484d 4143   data using HMAC
│ │ │ │ +0002ca80: 2d53 4841 312e 2020 5468 650a 2020 2020  -SHA1.  The.    
│ │ │ │ +0002ca90: 204f 5554 4841 5348 2062 7566 6665 7220   OUTHASH buffer 
│ │ │ │ +0002caa0: 6d75 7374 2062 6520 6465 616c 6c6f 6361  must be dealloca
│ │ │ │ +0002cab0: 7465 6420 6279 2074 6865 2063 616c 6c65  ted by the calle
│ │ │ │ +0002cac0: 722e 0a0a 2020 2020 202a 5265 7475 726e  r...     *Return
│ │ │ │ +0002cad0: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ +0002cae0: 2053 4849 5348 495f 4f4b 2069 6666 2073   SHISHI_OK iff s
│ │ │ │ +0002caf0: 7563 6365 7373 6675 6c2e 0a0a 7368 6973  uccessful...shis
│ │ │ │ +0002cb00: 6869 5f64 6573 5f63 6263 5f6d 6163 0a2d  hi_des_cbc_mac.-
│ │ │ │  0002cb10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0002cb20: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ -0002cb30: 696e 7420 7368 6973 6869 5f64 6573 5f63  int shishi_des_c
│ │ │ │ -0002cb40: 6263 5f6d 6163 2028 5368 6973 6869 202a  bc_mac (Shishi *
│ │ │ │ -0002cb50: 2048 414e 444c 452c 0a20 2020 2020 2020   HANDLE,.       
│ │ │ │ -0002cb60: 2020 2063 6f6e 7374 2063 6861 7220 4b45     const char KE
│ │ │ │ -0002cb70: 595b 385d 2c20 636f 6e73 7420 6368 6172  Y[8], const char
│ │ │ │ -0002cb80: 2049 565b 385d 2c20 636f 6e73 7420 6368   IV[8], const ch
│ │ │ │ -0002cb90: 6172 202a 2049 4e2c 0a20 2020 2020 2020  ar * IN,.       
│ │ │ │ -0002cba0: 2020 2073 697a 655f 7420 494e 4c45 4e2c     size_t INLEN,
│ │ │ │ -0002cbb0: 2063 6861 7220 2a20 4f55 545b 385d 290a   char * OUT[8]).
│ │ │ │ -0002cbc0: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ -0002cbd0: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ -0002cbe0: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ -0002cbf0: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ -0002cc00: 2020 2020 204b 4559 3a20 696e 7075 7420       KEY: input 
│ │ │ │ -0002cc10: 6368 6172 6163 7465 7220 6172 7261 7920  character array 
│ │ │ │ -0002cc20: 7769 7468 206b 6579 2074 6f20 7573 652e  with key to use.
│ │ │ │ -0002cc30: 0a20 2020 2020 4956 3a20 696e 7075 7420  .     IV: input 
│ │ │ │ -0002cc40: 6368 6172 6163 7465 7220 6172 7261 7920  character array 
│ │ │ │ -0002cc50: 7769 7468 2069 6e69 7469 616c 697a 6174  with initializat
│ │ │ │ -0002cc60: 696f 6e20 7665 6374 6f72 2074 6f20 7573  ion vector to us
│ │ │ │ -0002cc70: 652c 2063 616e 2062 650a 2020 2020 204e  e, can be.     N
│ │ │ │ -0002cc80: 554c 4c2e 0a20 2020 2020 494e 3a20 696e  ULL..     IN: in
│ │ │ │ -0002cc90: 7075 7420 6368 6172 6163 7465 7220 6172  put character ar
│ │ │ │ -0002cca0: 7261 7920 6f66 2064 6174 6120 746f 2068  ray of data to h
│ │ │ │ -0002ccb0: 6173 682e 0a20 2020 2020 494e 4c45 4e3a  ash..     INLEN:
│ │ │ │ -0002ccc0: 206c 656e 6774 6820 6f66 2069 6e70 7574   length of input
│ │ │ │ -0002ccd0: 2063 6861 7261 6374 6572 2061 7272 6179   character array
│ │ │ │ -0002cce0: 206f 6620 6461 7461 2074 6f20 6861 7368   of data to hash
│ │ │ │ -0002ccf0: 2e0a 2020 2020 204f 5554 3a20 6e65 776c  ..     OUT: newl
│ │ │ │ -0002cd00: 7920 616c 6c6f 6361 7465 6420 6368 6172  y allocated char
│ │ │ │ -0002cd10: 6163 7465 7220 6172 7261 7920 7769 7468  acter array with
│ │ │ │ -0002cd20: 206b 6579 6564 2068 6173 6820 6f66 2064   keyed hash of d
│ │ │ │ -0002cd30: 6174 612e 0a0a 2020 2020 202a 4465 7363  ata...     *Desc
│ │ │ │ -0002cd40: 7269 7074 696f 6e3a 2a20 436f 6d70 7574  ription:* Comput
│ │ │ │ -0002cd50: 6564 206b 6579 6564 2063 6865 636b 7375  ed keyed checksu
│ │ │ │ -0002cd60: 6d20 6f66 2064 6174 6120 7573 696e 6720  m of data using 
│ │ │ │ -0002cd70: 4445 532d 4342 432d 4d41 432e 0a20 2020  DES-CBC-MAC..   
│ │ │ │ -0002cd80: 2020 5468 6520 4f55 5420 6275 6666 6572    The OUT buffer
│ │ │ │ -0002cd90: 206d 7573 7420 6265 2064 6561 6c6c 6f63   must be dealloc
│ │ │ │ -0002cda0: 6174 6564 2062 7920 7468 6520 6361 6c6c  ated by the call
│ │ │ │ -0002cdb0: 6572 2e0a 0a20 2020 2020 2a52 6574 7572  er...     *Retur
│ │ │ │ -0002cdc0: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ -0002cdd0: 7320 5348 4953 4849 5f4f 4b20 6966 6620  s SHISHI_OK iff 
│ │ │ │ -0002cde0: 7375 6363 6573 7366 756c 2e0a 0a73 6869  successful...shi
│ │ │ │ -0002cdf0: 7368 695f 6172 6366 6f75 720a 2d2d 2d2d  shi_arcfour.----
│ │ │ │ -0002ce00: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ -0002ce10: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ -0002ce20: 6973 6869 5f61 7263 666f 7572 2028 5368  ishi_arcfour (Sh
│ │ │ │ -0002ce30: 6973 6869 202a 2048 414e 444c 452c 2069  ishi * HANDLE, i
│ │ │ │ -0002ce40: 6e74 2044 4543 5259 5054 502c 0a20 2020  nt DECRYPTP,.   
│ │ │ │ -0002ce50: 2020 2020 2020 2063 6f6e 7374 2063 6861         const cha
│ │ │ │ -0002ce60: 7220 2a20 4b45 592c 2073 697a 655f 7420  r * KEY, size_t 
│ │ │ │ -0002ce70: 4b45 594c 454e 2c20 636f 6e73 7420 6368  KEYLEN, const ch
│ │ │ │ -0002ce80: 6172 2049 565b 3235 385d 2c0a 2020 2020  ar IV[258],.    
│ │ │ │ -0002ce90: 2020 2020 2020 6368 6172 202a 2049 564f        char * IVO
│ │ │ │ -0002cea0: 5554 5b32 3538 5d2c 2063 6f6e 7374 2063  UT[258], const c
│ │ │ │ -0002ceb0: 6861 7220 2a20 494e 2c20 7369 7a65 5f74  har * IN, size_t
│ │ │ │ -0002cec0: 2049 4e4c 454e 2c20 6368 6172 202a 2a20   INLEN, char ** 
│ │ │ │ -0002ced0: 4f55 5429 0a20 2020 2020 4841 4e44 4c45  OUT).     HANDLE
│ │ │ │ -0002cee0: 3a20 7368 6973 6869 2068 616e 646c 6520  : shishi handle 
│ │ │ │ -0002cef0: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ -0002cf00: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ -0002cf10: e280 992e 0a20 2020 2020 4445 4352 5950  .....     DECRYP
│ │ │ │ -0002cf20: 5450 3a20 3020 746f 2069 6e64 6963 6174  TP: 0 to indicat
│ │ │ │ -0002cf30: 6520 656e 6372 7970 7469 6f6e 2c20 6e6f  e encryption, no
│ │ │ │ -0002cf40: 6e2d 3020 746f 2069 6e64 6963 6174 6520  n-0 to indicate 
│ │ │ │ -0002cf50: 6465 6372 7970 7469 6f6e 2e0a 2020 2020  decryption..    
│ │ │ │ -0002cf60: 204b 4559 3a20 696e 7075 7420 6368 6172   KEY: input char
│ │ │ │ -0002cf70: 6163 7465 7220 6172 7261 7920 7769 7468  acter array with
│ │ │ │ -0002cf80: 206b 6579 2074 6f20 7573 652e 0a20 2020   key to use..   
│ │ │ │ -0002cf90: 2020 4b45 594c 454e 3a20 6c65 6e67 7468    KEYLEN: length
│ │ │ │ -0002cfa0: 206f 6620 696e 7075 7420 6b65 7920 6172   of input key ar
│ │ │ │ -0002cfb0: 7261 792e 0a20 2020 2020 4956 3a20 696e  ray..     IV: in
│ │ │ │ -0002cfc0: 7075 7420 6368 6172 6163 7465 7220 6172  put character ar
│ │ │ │ -0002cfd0: 7261 7920 7769 7468 2069 6e69 7469 616c  ray with initial
│ │ │ │ -0002cfe0: 697a 6174 696f 6e20 7665 6374 6f72 2074  ization vector t
│ │ │ │ -0002cff0: 6f20 7573 652c 206f 720a 2020 2020 204e  o use, or.     N
│ │ │ │ -0002d000: 554c 4c2e 0a20 2020 2020 4956 4f55 543a  ULL..     IVOUT:
│ │ │ │ -0002d010: 206f 7574 7075 7420 6368 6172 6163 7465   output characte
│ │ │ │ -0002d020: 7220 6172 7261 7920 7769 7468 2075 7064  r array with upd
│ │ │ │ -0002d030: 6174 6564 2069 6e69 7469 616c 697a 6174  ated initializat
│ │ │ │ -0002d040: 696f 6e20 7665 6374 6f72 2c0a 2020 2020  ion vector,.    
│ │ │ │ -0002d050: 206f 7220 4e55 4c4c 2e0a 2020 2020 2049   or NULL..     I
│ │ │ │ -0002d060: 4e3a 2069 6e70 7574 2063 6861 7261 6374  N: input charact
│ │ │ │ -0002d070: 6572 2061 7272 6179 206f 6620 6461 7461  er array of data
│ │ │ │ -0002d080: 2074 6f20 656e 6372 7970 742f 6465 6372   to encrypt/decr
│ │ │ │ -0002d090: 7970 742e 0a20 2020 2020 494e 4c45 4e3a  ypt..     INLEN:
│ │ │ │ -0002d0a0: 206c 656e 6774 6820 6f66 2069 6e70 7574   length of input
│ │ │ │ -0002d0b0: 2063 6861 7261 6374 6572 2061 7272 6179   character array
│ │ │ │ -0002d0c0: 206f 6620 6461 7461 2074 6f20 656e 6372   of data to encr
│ │ │ │ -0002d0d0: 7970 742f 6465 6372 7970 742e 0a0a 2020  ypt/decrypt...  
│ │ │ │ -0002d0e0: 2020 204f 5554 3a20 6e65 776c 7920 616c     OUT: newly al
│ │ │ │ -0002d0f0: 6c6f 6361 7465 6420 6368 6172 6163 7465  located characte
│ │ │ │ -0002d100: 7220 6172 7261 7920 7769 7468 2065 6e63  r array with enc
│ │ │ │ -0002d110: 7279 7074 6564 2f64 6563 7279 7074 6564  rypted/decrypted
│ │ │ │ -0002d120: 2064 6174 612e 0a0a 2020 2020 202a 4465   data...     *De
│ │ │ │ -0002d130: 7363 7269 7074 696f 6e3a 2a20 456e 6372  scription:* Encr
│ │ │ │ -0002d140: 7970 7420 6f72 2064 6563 7279 7074 2064  ypt or decrypt d
│ │ │ │ -0002d150: 6174 6120 2864 6570 656e 6469 6e67 206f  ata (depending o
│ │ │ │ -0002d160: 6e20 4445 4352 5950 5450 290a 2020 2020  n DECRYPTP).    
│ │ │ │ -0002d170: 2075 7369 6e67 2041 5243 464f 5552 2e20   using ARCFOUR. 
│ │ │ │ -0002d180: 5468 6520 4f55 5420 6275 6666 6572 206d  The OUT buffer m
│ │ │ │ -0002d190: 7573 7420 6265 2064 6561 6c6c 6f63 6174  ust be deallocat
│ │ │ │ -0002d1a0: 6564 2062 7920 7468 6520 6361 6c6c 6572  ed by the caller
│ │ │ │ -0002d1b0: 2e0a 0a20 2020 2020 5468 6520 2269 6e69  ...     The "ini
│ │ │ │ -0002d1c0: 7469 616c 697a 6174 696f 6e20 7665 6374  tialization vect
│ │ │ │ -0002d1d0: 6f72 2220 7573 6564 2068 6572 6520 6973  or" used here is
│ │ │ │ -0002d1e0: 2074 6865 2063 6f6e 6361 7465 6e61 7469   the concatenati
│ │ │ │ -0002d1f0: 6f6e 206f 6620 7468 650a 2020 2020 2073  on of the.     s
│ │ │ │ -0002d200: 626f 7820 616e 6420 6920 616e 6420 6a2c  box and i and j,
│ │ │ │ -0002d210: 2061 6e64 2069 7320 7468 7573 2061 6c77   and is thus alw
│ │ │ │ -0002d220: 6179 7320 6f66 2073 697a 6520 3235 3620  ays of size 256 
│ │ │ │ -0002d230: 2b20 3120 2b20 312e 2020 5468 6973 2069  + 1 + 1.  This i
│ │ │ │ -0002d240: 730a 2020 2020 2061 2073 6c69 6768 7420  s.     a slight 
│ │ │ │ -0002d250: 6162 7573 6520 6f66 2074 6572 6d69 6e6f  abuse of termino
│ │ │ │ -0002d260: 6c6f 6779 2c20 616e 6420 6173 7375 6d65  logy, and assume
│ │ │ │ -0002d270: 7320 796f 7520 6b6e 6f77 2077 6861 7420  s you know what 
│ │ │ │ -0002d280: 796f 7520 6172 650a 2020 2020 2064 6f69  you are.     doi
│ │ │ │ -0002d290: 6e67 2e20 2044 6f6e 2774 2075 7365 2069  ng.  Don't use i
│ │ │ │ -0002d2a0: 7420 6966 2079 6f75 2063 616e 2061 766f  t if you can avo
│ │ │ │ -0002d2b0: 6964 2074 6f2e 0a0a 2020 2020 202a 5265  id to...     *Re
│ │ │ │ -0002d2c0: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ -0002d2d0: 7572 6e73 2053 4849 5348 495f 4f4b 2069  urns SHISHI_OK i
│ │ │ │ -0002d2e0: 6666 2073 7563 6365 7373 6675 6c2e 0a0a  ff successful...
│ │ │ │ -0002d2f0: 7368 6973 6869 5f64 6573 0a2d 2d2d 2d2d  shishi_des.-----
│ │ │ │ -0002d300: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ -0002d310: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ -0002d320: 6465 7320 2853 6869 7368 6920 2a20 4841  des (Shishi * HA
│ │ │ │ -0002d330: 4e44 4c45 2c20 696e 7420 4445 4352 5950  NDLE, int DECRYP
│ │ │ │ -0002d340: 5450 2c0a 2020 2020 2020 2020 2020 636f  TP,.          co
│ │ │ │ -0002d350: 6e73 7420 6368 6172 204b 4559 5b38 5d2c  nst char KEY[8],
│ │ │ │ -0002d360: 2063 6f6e 7374 2063 6861 7220 4956 5b38   const char IV[8
│ │ │ │ -0002d370: 5d2c 2063 6861 7220 2a20 4956 4f55 545b  ], char * IVOUT[
│ │ │ │ -0002d380: 385d 2c0a 2020 2020 2020 2020 2020 636f  8],.          co
│ │ │ │ -0002d390: 6e73 7420 6368 6172 202a 2049 4e2c 2073  nst char * IN, s
│ │ │ │ -0002d3a0: 697a 655f 7420 494e 4c45 4e2c 2063 6861  ize_t INLEN, cha
│ │ │ │ -0002d3b0: 7220 2a2a 204f 5554 290a 2020 2020 2048  r ** OUT).     H
│ │ │ │ -0002d3c0: 414e 444c 453a 2073 6869 7368 6920 6861  ANDLE: shishi ha
│ │ │ │ -0002d3d0: 6e64 6c65 2061 7320 616c 6c6f 6361 7465  ndle as allocate
│ │ │ │ -0002d3e0: 6420 6279 20e2 8098 7368 6973 6869 5f69  d by ...shishi_i
│ │ │ │ -0002d3f0: 6e69 7428 29e2 8099 2e0a 2020 2020 2044  nit().....     D
│ │ │ │ -0002d400: 4543 5259 5054 503a 2030 2074 6f20 696e  ECRYPTP: 0 to in
│ │ │ │ -0002d410: 6469 6361 7465 2065 6e63 7279 7074 696f  dicate encryptio
│ │ │ │ -0002d420: 6e2c 206e 6f6e 2d30 2074 6f20 696e 6469  n, non-0 to indi
│ │ │ │ -0002d430: 6361 7465 2064 6563 7279 7074 696f 6e2e  cate decryption.
│ │ │ │ -0002d440: 0a20 2020 2020 4b45 593a 2069 6e70 7574  .     KEY: input
│ │ │ │ -0002d450: 2063 6861 7261 6374 6572 2061 7272 6179   character array
│ │ │ │ -0002d460: 2077 6974 6820 6b65 7920 746f 2075 7365   with key to use
│ │ │ │ -0002d470: 2e0a 2020 2020 2049 563a 2069 6e70 7574  ..     IV: input
│ │ │ │ -0002d480: 2063 6861 7261 6374 6572 2061 7272 6179   character array
│ │ │ │ -0002d490: 2077 6974 6820 696e 6974 6961 6c69 7a61   with initializa
│ │ │ │ -0002d4a0: 7469 6f6e 2076 6563 746f 7220 746f 2075  tion vector to u
│ │ │ │ -0002d4b0: 7365 2c20 6f72 0a20 2020 2020 4e55 4c4c  se, or.     NULL
│ │ │ │ -0002d4c0: 2e0a 2020 2020 2049 564f 5554 3a20 6f75  ..     IVOUT: ou
│ │ │ │ -0002d4d0: 7470 7574 2063 6861 7261 6374 6572 2061  tput character a
│ │ │ │ -0002d4e0: 7272 6179 2077 6974 6820 7570 6461 7465  rray with update
│ │ │ │ -0002d4f0: 6420 696e 6974 6961 6c69 7a61 7469 6f6e  d initialization
│ │ │ │ -0002d500: 2076 6563 746f 722c 0a20 2020 2020 6f72   vector,.     or
│ │ │ │ -0002d510: 204e 554c 4c2e 0a20 2020 2020 494e 3a20   NULL..     IN: 
│ │ │ │ -0002d520: 696e 7075 7420 6368 6172 6163 7465 7220  input character 
│ │ │ │ -0002d530: 6172 7261 7920 6f66 2064 6174 6120 746f  array of data to
│ │ │ │ -0002d540: 2065 6e63 7279 7074 2f64 6563 7279 7074   encrypt/decrypt
│ │ │ │ -0002d550: 2e0a 2020 2020 2049 4e4c 454e 3a20 6c65  ..     INLEN: le
│ │ │ │ -0002d560: 6e67 7468 206f 6620 696e 7075 7420 6368  ngth of input ch
│ │ │ │ -0002d570: 6172 6163 7465 7220 6172 7261 7920 6f66  aracter array of
│ │ │ │ -0002d580: 2064 6174 6120 746f 2065 6e63 7279 7074   data to encrypt
│ │ │ │ -0002d590: 2f64 6563 7279 7074 2e0a 0a20 2020 2020  /decrypt...     
│ │ │ │ -0002d5a0: 4f55 543a 206e 6577 6c79 2061 6c6c 6f63  OUT: newly alloc
│ │ │ │ -0002d5b0: 6174 6564 2063 6861 7261 6374 6572 2061  ated character a
│ │ │ │ -0002d5c0: 7272 6179 2077 6974 6820 656e 6372 7970  rray with encryp
│ │ │ │ -0002d5d0: 7465 642f 6465 6372 7970 7465 6420 6461  ted/decrypted da
│ │ │ │ -0002d5e0: 7461 2e0a 0a20 2020 2020 2a44 6573 6372  ta...     *Descr
│ │ │ │ -0002d5f0: 6970 7469 6f6e 3a2a 2045 6e63 7279 7074  iption:* Encrypt
│ │ │ │ -0002d600: 206f 7220 6465 6372 7970 7420 6461 7461   or decrypt data
│ │ │ │ -0002d610: 2028 6465 7065 6e64 696e 6720 6f6e 2044   (depending on D
│ │ │ │ -0002d620: 4543 5259 5054 5029 0a20 2020 2020 7573  ECRYPTP).     us
│ │ │ │ -0002d630: 696e 6720 4445 5320 696e 2043 4243 206d  ing DES in CBC m
│ │ │ │ -0002d640: 6f64 652e 2020 5468 6520 4f55 5420 6275  ode.  The OUT bu
│ │ │ │ -0002d650: 6666 6572 206d 7573 7420 6265 2064 6561  ffer must be dea
│ │ │ │ -0002d660: 6c6c 6f63 6174 6564 2062 7920 7468 650a  llocated by the.
│ │ │ │ -0002d670: 2020 2020 2063 616c 6c65 722e 0a0a 2020       caller...  
│ │ │ │ -0002d680: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ -0002d690: 3a2a 2052 6574 7572 6e73 2053 4849 5348  :* Returns SHISH
│ │ │ │ -0002d6a0: 495f 4f4b 2069 6666 2073 7563 6365 7373  I_OK iff success
│ │ │ │ -0002d6b0: 6675 6c2e 0a0a 7368 6973 6869 5f33 6465  ful...shishi_3de
│ │ │ │ -0002d6c0: 730a 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  s.-----------.. 
│ │ │ │ -0002d6d0: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ -0002d6e0: 2073 6869 7368 695f 3364 6573 2028 5368   shishi_3des (Sh
│ │ │ │ -0002d6f0: 6973 6869 202a 2048 414e 444c 452c 2069  ishi * HANDLE, i
│ │ │ │ -0002d700: 6e74 2044 4543 5259 5054 502c 0a20 2020  nt DECRYPTP,.   
│ │ │ │ -0002d710: 2020 2020 2020 2063 6f6e 7374 2063 6861         const cha
│ │ │ │ -0002d720: 7220 4b45 595b 385d 2c20 636f 6e73 7420  r KEY[8], const 
│ │ │ │ -0002d730: 6368 6172 2049 565b 385d 2c20 6368 6172  char IV[8], char
│ │ │ │ -0002d740: 202a 2049 564f 5554 5b38 5d2c 0a20 2020   * IVOUT[8],.   
│ │ │ │ -0002d750: 2020 2020 2020 2063 6f6e 7374 2063 6861         const cha
│ │ │ │ -0002d760: 7220 2a20 494e 2c20 7369 7a65 5f74 2049  r * IN, size_t I
│ │ │ │ -0002d770: 4e4c 454e 2c20 6368 6172 202a 2a20 4f55  NLEN, char ** OU
│ │ │ │ -0002d780: 5429 0a20 2020 2020 4841 4e44 4c45 3a20  T).     HANDLE: 
│ │ │ │ -0002d790: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ -0002d7a0: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ -0002d7b0: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ -0002d7c0: 992e 0a20 2020 2020 4445 4352 5950 5450  ...     DECRYPTP
│ │ │ │ -0002d7d0: 3a20 3020 746f 2069 6e64 6963 6174 6520  : 0 to indicate 
│ │ │ │ -0002d7e0: 656e 6372 7970 7469 6f6e 2c20 6e6f 6e2d  encryption, non-
│ │ │ │ -0002d7f0: 3020 746f 2069 6e64 6963 6174 6520 6465  0 to indicate de
│ │ │ │ -0002d800: 6372 7970 7469 6f6e 2e0a 2020 2020 204b  cryption..     K
│ │ │ │ -0002d810: 4559 3a20 696e 7075 7420 6368 6172 6163  EY: input charac
│ │ │ │ -0002d820: 7465 7220 6172 7261 7920 7769 7468 206b  ter array with k
│ │ │ │ -0002d830: 6579 2074 6f20 7573 652e 0a20 2020 2020  ey to use..     
│ │ │ │ -0002d840: 4956 3a20 696e 7075 7420 6368 6172 6163  IV: input charac
│ │ │ │ -0002d850: 7465 7220 6172 7261 7920 7769 7468 2069  ter array with i
│ │ │ │ -0002d860: 6e69 7469 616c 697a 6174 696f 6e20 7665  nitialization ve
│ │ │ │ -0002d870: 6374 6f72 2074 6f20 7573 652c 206f 720a  ctor to use, or.
│ │ │ │ -0002d880: 2020 2020 204e 554c 4c2e 0a20 2020 2020       NULL..     
│ │ │ │ -0002d890: 4956 4f55 543a 206f 7574 7075 7420 6368  IVOUT: output ch
│ │ │ │ -0002d8a0: 6172 6163 7465 7220 6172 7261 7920 7769  aracter array wi
│ │ │ │ -0002d8b0: 7468 2075 7064 6174 6564 2069 6e69 7469  th updated initi
│ │ │ │ -0002d8c0: 616c 697a 6174 696f 6e20 7665 6374 6f72  alization vector
│ │ │ │ -0002d8d0: 2c0a 2020 2020 206f 7220 4e55 4c4c 2e0a  ,.     or NULL..
│ │ │ │ -0002d8e0: 2020 2020 2049 4e3a 2069 6e70 7574 2063       IN: input c
│ │ │ │ -0002d8f0: 6861 7261 6374 6572 2061 7272 6179 206f  haracter array o
│ │ │ │ -0002d900: 6620 6461 7461 2074 6f20 656e 6372 7970  f data to encryp
│ │ │ │ -0002d910: 742f 6465 6372 7970 742e 0a20 2020 2020  t/decrypt..     
│ │ │ │ -0002d920: 494e 4c45 4e3a 206c 656e 6774 6820 6f66  INLEN: length of
│ │ │ │ -0002d930: 2069 6e70 7574 2063 6861 7261 6374 6572   input character
│ │ │ │ -0002d940: 2061 7272 6179 206f 6620 6461 7461 2074   array of data t
│ │ │ │ -0002d950: 6f20 656e 6372 7970 742f 6465 6372 7970  o encrypt/decryp
│ │ │ │ -0002d960: 742e 0a0a 2020 2020 204f 5554 3a20 6e65  t...     OUT: ne
│ │ │ │ -0002d970: 776c 7920 616c 6c6f 6361 7465 6420 6368  wly allocated ch
│ │ │ │ -0002d980: 6172 6163 7465 7220 6172 7261 7920 7769  aracter array wi
│ │ │ │ -0002d990: 7468 2065 6e63 7279 7074 6564 2f64 6563  th encrypted/dec
│ │ │ │ -0002d9a0: 7279 7074 6564 2064 6174 612e 0a0a 2020  rypted data...  
│ │ │ │ -0002d9b0: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ -0002d9c0: 2a20 456e 6372 7970 7420 6f72 2064 6563  * Encrypt or dec
│ │ │ │ -0002d9d0: 7279 7074 2064 6174 6120 2864 6570 656e  rypt data (depen
│ │ │ │ -0002d9e0: 6469 6e67 206f 6e20 4445 4352 5950 5450  ding on DECRYPTP
│ │ │ │ -0002d9f0: 290a 2020 2020 2075 7369 6e67 2033 4445  ).     using 3DE
│ │ │ │ -0002da00: 5320 696e 2043 4243 206d 6f64 652e 2020  S in CBC mode.  
│ │ │ │ -0002da10: 5468 6520 4f55 5420 6275 6666 6572 206d  The OUT buffer m
│ │ │ │ -0002da20: 7573 7420 6265 2064 6561 6c6c 6f63 6174  ust be deallocat
│ │ │ │ -0002da30: 6564 2062 7920 7468 650a 2020 2020 2063  ed by the.     c
│ │ │ │ -0002da40: 616c 6c65 722e 0a0a 2020 2020 202a 5265  aller...     *Re
│ │ │ │ -0002da50: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ -0002da60: 7572 6e73 2053 4849 5348 495f 4f4b 2069  urns SHISHI_OK i
│ │ │ │ -0002da70: 6666 2073 7563 6365 7373 6675 6c2e 0a0a  ff successful...
│ │ │ │ -0002da80: 7368 6973 6869 5f61 6573 5f63 7473 0a2d  shishi_aes_cts.-
│ │ │ │ -0002da90: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -0002daa0: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ -0002dab0: 2073 6869 7368 695f 6165 735f 6374 7320   shishi_aes_cts 
│ │ │ │ -0002dac0: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ -0002dad0: 2c20 696e 7420 4445 4352 5950 5450 2c0a  , int DECRYPTP,.
│ │ │ │ -0002dae0: 2020 2020 2020 2020 2020 636f 6e73 7420            const 
│ │ │ │ -0002daf0: 6368 6172 202a 204b 4559 2c20 7369 7a65  char * KEY, size
│ │ │ │ -0002db00: 5f74 204b 4559 4c45 4e2c 2063 6f6e 7374  _t KEYLEN, const
│ │ │ │ -0002db10: 2063 6861 7220 4956 5b31 365d 2c0a 2020   char IV[16],.  
│ │ │ │ -0002db20: 2020 2020 2020 2020 6368 6172 202a 2049          char * I
│ │ │ │ -0002db30: 564f 5554 5b31 365d 2c20 636f 6e73 7420  VOUT[16], const 
│ │ │ │ -0002db40: 6368 6172 202a 2049 4e2c 2073 697a 655f  char * IN, size_
│ │ │ │ -0002db50: 7420 494e 4c45 4e2c 2063 6861 7220 2a2a  t INLEN, char **
│ │ │ │ -0002db60: 204f 5554 290a 2020 2020 2048 414e 444c   OUT).     HANDL
│ │ │ │ -0002db70: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ -0002db80: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ -0002db90: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ -0002dba0: 29e2 8099 2e0a 2020 2020 2044 4543 5259  ).....     DECRY
│ │ │ │ -0002dbb0: 5054 503a 2030 2074 6f20 696e 6469 6361  PTP: 0 to indica
│ │ │ │ -0002dbc0: 7465 2065 6e63 7279 7074 696f 6e2c 206e  te encryption, n
│ │ │ │ -0002dbd0: 6f6e 2d30 2074 6f20 696e 6469 6361 7465  on-0 to indicate
│ │ │ │ -0002dbe0: 2064 6563 7279 7074 696f 6e2e 0a20 2020   decryption..   
│ │ │ │ -0002dbf0: 2020 4b45 593a 2069 6e70 7574 2063 6861    KEY: input cha
│ │ │ │ -0002dc00: 7261 6374 6572 2061 7272 6179 2077 6974  racter array wit
│ │ │ │ -0002dc10: 6820 6b65 7920 746f 2075 7365 2e0a 2020  h key to use..  
│ │ │ │ -0002dc20: 2020 204b 4559 4c45 4e3a 206c 656e 6774     KEYLEN: lengt
│ │ │ │ -0002dc30: 6820 6f66 2069 6e70 7574 2063 6861 7261  h of input chara
│ │ │ │ -0002dc40: 6374 6572 2061 7272 6179 2077 6974 6820  cter array with 
│ │ │ │ -0002dc50: 6b65 7920 746f 2075 7365 2e0a 2020 2020  key to use..    
│ │ │ │ -0002dc60: 2049 563a 2069 6e70 7574 2063 6861 7261   IV: input chara
│ │ │ │ -0002dc70: 6374 6572 2061 7272 6179 2077 6974 6820  cter array with 
│ │ │ │ -0002dc80: 696e 6974 6961 6c69 7a61 7469 6f6e 2076  initialization v
│ │ │ │ -0002dc90: 6563 746f 7220 746f 2075 7365 2c20 6f72  ector to use, or
│ │ │ │ -0002dca0: 0a20 2020 2020 4e55 4c4c 2e0a 2020 2020  .     NULL..    
│ │ │ │ -0002dcb0: 2049 564f 5554 3a20 6f75 7470 7574 2063   IVOUT: output c
│ │ │ │ -0002dcc0: 6861 7261 6374 6572 2061 7272 6179 2077  haracter array w
│ │ │ │ -0002dcd0: 6974 6820 7570 6461 7465 6420 696e 6974  ith updated init
│ │ │ │ -0002dce0: 6961 6c69 7a61 7469 6f6e 2076 6563 746f  ialization vecto
│ │ │ │ -0002dcf0: 722c 0a20 2020 2020 6f72 204e 554c 4c2e  r,.     or NULL.
│ │ │ │ -0002dd00: 0a20 2020 2020 494e 3a20 696e 7075 7420  .     IN: input 
│ │ │ │ -0002dd10: 6368 6172 6163 7465 7220 6172 7261 7920  character array 
│ │ │ │ -0002dd20: 6f66 2064 6174 6120 746f 2065 6e63 7279  of data to encry
│ │ │ │ -0002dd30: 7074 2f64 6563 7279 7074 2e0a 2020 2020  pt/decrypt..    
│ │ │ │ -0002dd40: 2049 4e4c 454e 3a20 6c65 6e67 7468 206f   INLEN: length o
│ │ │ │ -0002dd50: 6620 696e 7075 7420 6368 6172 6163 7465  f input characte
│ │ │ │ -0002dd60: 7220 6172 7261 7920 6f66 2064 6174 6120  r array of data 
│ │ │ │ -0002dd70: 746f 2065 6e63 7279 7074 2f64 6563 7279  to encrypt/decry
│ │ │ │ -0002dd80: 7074 2e0a 0a20 2020 2020 4f55 543a 206e  pt...     OUT: n
│ │ │ │ -0002dd90: 6577 6c79 2061 6c6c 6f63 6174 6564 2063  ewly allocated c
│ │ │ │ -0002dda0: 6861 7261 6374 6572 2061 7272 6179 2077  haracter array w
│ │ │ │ -0002ddb0: 6974 6820 656e 6372 7970 7465 642f 6465  ith encrypted/de
│ │ │ │ -0002ddc0: 6372 7970 7465 6420 6461 7461 2e0a 0a20  crypted data... 
│ │ │ │ -0002ddd0: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -0002dde0: 3a2a 2045 6e63 7279 7074 206f 7220 6465  :* Encrypt or de
│ │ │ │ -0002ddf0: 6372 7970 7420 6461 7461 2028 6465 7065  crypt data (depe
│ │ │ │ -0002de00: 6e64 696e 6720 6f6e 2044 4543 5259 5054  nding on DECRYPT
│ │ │ │ -0002de10: 5029 0a20 2020 2020 7573 696e 6720 4145  P).     using AE
│ │ │ │ -0002de20: 5320 696e 2043 4243 2d43 5453 206d 6f64  S in CBC-CTS mod
│ │ │ │ -0002de30: 652e 2020 5468 6520 6c65 6e67 7468 206f  e.  The length o
│ │ │ │ -0002de40: 6620 7468 6520 6b65 792c 204b 4559 4c45  f the key, KEYLE
│ │ │ │ -0002de50: 4e2c 2064 6563 6964 650a 2020 2020 2069  N, decide.     i
│ │ │ │ -0002de60: 6620 4145 5320 3132 3820 6f72 2041 4553  f AES 128 or AES
│ │ │ │ -0002de70: 2032 3536 2073 686f 756c 6420 6265 2075   256 should be u
│ │ │ │ -0002de80: 7365 642e 2020 5468 6520 4f55 5420 6275  sed.  The OUT bu
│ │ │ │ -0002de90: 6666 6572 206d 7573 7420 6265 0a20 2020  ffer must be.   
│ │ │ │ -0002dea0: 2020 6465 616c 6c6f 6361 7465 6420 6279    deallocated by
│ │ │ │ -0002deb0: 2074 6865 2063 616c 6c65 722e 0a0a 2020   the caller...  
│ │ │ │ -0002dec0: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ -0002ded0: 3a2a 2052 6574 7572 6e73 2053 4849 5348  :* Returns SHISH
│ │ │ │ -0002dee0: 495f 4f4b 2069 6666 2073 7563 6365 7373  I_OK iff success
│ │ │ │ -0002def0: 6675 6c2e 0a0a 7368 6973 6869 5f70 626b  ful...shishi_pbk
│ │ │ │ -0002df00: 6466 325f 7368 6131 0a2d 2d2d 2d2d 2d2d  df2_sha1.-------
│ │ │ │ -0002df10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ -0002df20: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ -0002df30: 6869 7368 695f 7062 6b64 6632 5f73 6861  hishi_pbkdf2_sha
│ │ │ │ -0002df40: 3120 2853 6869 7368 6920 2a20 4841 4e44  1 (Shishi * HAND
│ │ │ │ -0002df50: 4c45 2c20 636f 6e73 7420 6368 6172 202a  LE, const char *
│ │ │ │ -0002df60: 2050 2c0a 2020 2020 2020 2020 2020 7369   P,.          si
│ │ │ │ -0002df70: 7a65 5f74 2050 4c45 4e2c 2063 6f6e 7374  ze_t PLEN, const
│ │ │ │ -0002df80: 2063 6861 7220 2a20 532c 2073 697a 655f   char * S, size_
│ │ │ │ -0002df90: 7420 534c 454e 2c20 756e 7369 676e 6564  t SLEN, unsigned
│ │ │ │ -0002dfa0: 2069 6e74 2043 2c0a 2020 2020 2020 2020   int C,.        
│ │ │ │ -0002dfb0: 2020 756e 7369 676e 6564 2069 6e74 2044    unsigned int D
│ │ │ │ -0002dfc0: 4b4c 454e 2c20 6368 6172 202a 2044 4b29  KLEN, char * DK)
│ │ │ │ -0002dfd0: 0a20 2020 2020 4841 4e44 4c45 3a20 7368  .     HANDLE: sh
│ │ │ │ -0002dfe0: 6973 6869 2068 616e 646c 6520 6173 2061  ishi handle as a
│ │ │ │ -0002dff0: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ -0002e000: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ -0002e010: 0a20 2020 2020 503a 2069 6e70 7574 2070  .     P: input p
│ │ │ │ -0002e020: 6173 7377 6f72 642c 2061 6e20 6f63 7465  assword, an octe
│ │ │ │ -0002e030: 7420 7374 7269 6e67 0a20 2020 2020 504c  t string.     PL
│ │ │ │ -0002e040: 454e 3a20 6c65 6e67 7468 206f 6620 7061  EN: length of pa
│ │ │ │ -0002e050: 7373 776f 7264 2c20 616e 206f 6374 6574  ssword, an octet
│ │ │ │ -0002e060: 2073 7472 696e 670a 2020 2020 2053 3a20   string.     S: 
│ │ │ │ -0002e070: 696e 7075 7420 7361 6c74 2c20 616e 206f  input salt, an o
│ │ │ │ -0002e080: 6374 6574 2073 7472 696e 670a 2020 2020  ctet string.    
│ │ │ │ -0002e090: 2053 4c45 4e3a 206c 656e 6774 6820 6f66   SLEN: length of
│ │ │ │ -0002e0a0: 2073 616c 742c 2061 6e20 6f63 7465 7420   salt, an octet 
│ │ │ │ -0002e0b0: 7374 7269 6e67 0a20 2020 2020 433a 2069  string.     C: i
│ │ │ │ -0002e0c0: 7465 7261 7469 6f6e 2063 6f75 6e74 2c20  teration count, 
│ │ │ │ -0002e0d0: 6120 706f 7369 7469 7665 2069 6e74 6567  a positive integ
│ │ │ │ -0002e0e0: 6572 0a20 2020 2020 444b 4c45 4e3a 2069  er.     DKLEN: i
│ │ │ │ -0002e0f0: 6e74 656e 6465 6420 6c65 6e67 7468 2069  ntended length i
│ │ │ │ -0002e100: 6e20 6f63 7465 7473 206f 6620 7468 6520  n octets of the 
│ │ │ │ -0002e110: 6465 7269 7665 6420 6b65 792c 2061 2070  derived key, a p
│ │ │ │ -0002e120: 6f73 6974 6976 650a 2020 2020 2069 6e74  ositive.     int
│ │ │ │ -0002e130: 6567 6572 2c20 6174 206d 6f73 7420 2832  eger, at most (2
│ │ │ │ -0002e140: 5e33 3220 2d20 3129 202a 2068 4c65 6e2e  ^32 - 1) * hLen.
│ │ │ │ -0002e150: 2020 5468 6520 444b 2061 7272 6179 206d    The DK array m
│ │ │ │ -0002e160: 7573 7420 6861 7665 2072 6f6f 6d0a 2020  ust have room.  
│ │ │ │ -0002e170: 2020 2066 6f72 2074 6869 7320 6d61 6e79     for this many
│ │ │ │ -0002e180: 2063 6861 7261 6374 6572 732e 0a20 2020   characters..   
│ │ │ │ -0002e190: 2020 444b 3a20 6f75 7470 7574 2064 6572    DK: output der
│ │ │ │ -0002e1a0: 6976 6564 206b 6579 2c20 6120 646b 4c65  ived key, a dkLe
│ │ │ │ -0002e1b0: 6e2d 6f63 7465 7420 7374 7269 6e67 0a0a  n-octet string..
│ │ │ │ -0002e1c0: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ -0002e1d0: 6e3a 2a20 4465 7269 7665 206b 6579 2075  n:* Derive key u
│ │ │ │ -0002e1e0: 7369 6e67 2074 6865 2050 424b 4446 3220  sing the PBKDF2 
│ │ │ │ -0002e1f0: 6465 6669 6e65 6420 696e 2050 4b43 5335  defined in PKCS5
│ │ │ │ -0002e200: 2e0a 2020 2020 2050 424b 4446 3220 6170  ..     PBKDF2 ap
│ │ │ │ -0002e210: 706c 6965 7320 6120 7073 6575 646f 7261  plies a pseudora
│ │ │ │ -0002e220: 6e64 6f6d 2066 756e 6374 696f 6e20 746f  ndom function to
│ │ │ │ -0002e230: 2064 6572 6976 6520 6b65 7973 2e20 2054   derive keys.  T
│ │ │ │ -0002e240: 6865 206c 656e 6774 680a 2020 2020 206f  he length.     o
│ │ │ │ -0002e250: 6620 7468 6520 6465 7269 7665 6420 6b65  f the derived ke
│ │ │ │ -0002e260: 7920 6973 2065 7373 656e 7469 616c 6c79  y is essentially
│ │ │ │ -0002e270: 2075 6e62 6f75 6e64 6564 2e20 2028 486f   unbounded.  (Ho
│ │ │ │ -0002e280: 7765 7665 722c 2074 6865 206d 6178 696d  wever, the maxim
│ │ │ │ -0002e290: 756d 0a20 2020 2020 6566 6665 6374 6976  um.     effectiv
│ │ │ │ -0002e2a0: 6520 7365 6172 6368 2073 7061 6365 2066  e search space f
│ │ │ │ -0002e2b0: 6f72 2074 6865 2064 6572 6976 6564 206b  or the derived k
│ │ │ │ -0002e2c0: 6579 206d 6179 2062 6520 6c69 6d69 7465  ey may be limite
│ │ │ │ -0002e2d0: 6420 6279 2074 6865 0a20 2020 2020 7374  d by the.     st
│ │ │ │ -0002e2e0: 7275 6374 7572 6520 6f66 2074 6865 2075  ructure of the u
│ │ │ │ -0002e2f0: 6e64 6572 6c79 696e 6720 7073 6575 646f  nderlying pseudo
│ │ │ │ -0002e300: 7261 6e64 6f6d 2066 756e 6374 696f 6e2c  random function,
│ │ │ │ -0002e310: 2077 6869 6368 2069 7320 7468 6973 0a20   which is this. 
│ │ │ │ -0002e320: 2020 2020 6675 6e63 7469 6f6e 2069 7320      function is 
│ │ │ │ -0002e330: 616c 7761 7973 2053 4841 312e 290a 0a20  always SHA1.).. 
│ │ │ │ -0002e340: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ -0002e350: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ -0002e360: 4849 5f4f 4b20 6966 6620 7375 6363 6573  HI_OK iff succes
│ │ │ │ -0002e370: 7366 756c 2e0a 0a1f 0a46 696c 653a 2073  sful.....File: s
│ │ │ │ -0002e380: 6869 7368 692e 696e 666f 2c20 204e 6f64  hishi.info,  Nod
│ │ │ │ -0002e390: 653a 2058 2e35 3039 2046 756e 6374 696f  e: X.509 Functio
│ │ │ │ -0002e3a0: 6e73 2c20 204e 6578 743a 2055 7469 6c69  ns,  Next: Utili
│ │ │ │ -0002e3b0: 7479 2046 756e 6374 696f 6e73 2c20 2050  ty Functions,  P
│ │ │ │ -0002e3c0: 7265 763a 2043 7279 7074 6f67 7261 7068  rev: Cryptograph
│ │ │ │ -0002e3d0: 6963 2046 756e 6374 696f 6e73 2c20 2055  ic Functions,  U
│ │ │ │ -0002e3e0: 703a 2050 726f 6772 616d 6d69 6e67 204d  p: Programming M
│ │ │ │ -0002e3f0: 616e 7561 6c0a 0a35 2e31 3420 582e 3530  anual..5.14 X.50
│ │ │ │ -0002e400: 3920 4675 6e63 7469 6f6e 730a 3d3d 3d3d  9 Functions.====
│ │ │ │ +0002cb20: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ +0002cb30: 2069 6e74 2073 6869 7368 695f 6465 735f   int shishi_des_
│ │ │ │ +0002cb40: 6362 635f 6d61 6320 2853 6869 7368 6920  cbc_mac (Shishi 
│ │ │ │ +0002cb50: 2a20 4841 4e44 4c45 2c0a 2020 2020 2020  * HANDLE,.      
│ │ │ │ +0002cb60: 2020 2020 636f 6e73 7420 6368 6172 204b      const char K
│ │ │ │ +0002cb70: 4559 5b38 5d2c 2063 6f6e 7374 2063 6861  EY[8], const cha
│ │ │ │ +0002cb80: 7220 4956 5b38 5d2c 2063 6f6e 7374 2063  r IV[8], const c
│ │ │ │ +0002cb90: 6861 7220 2a20 494e 2c0a 2020 2020 2020  har * IN,.      
│ │ │ │ +0002cba0: 2020 2020 7369 7a65 5f74 2049 4e4c 454e      size_t INLEN
│ │ │ │ +0002cbb0: 2c20 6368 6172 202a 204f 5554 5b38 5d29  , char * OUT[8])
│ │ │ │ +0002cbc0: 0a20 2020 2020 4841 4e44 4c45 3a20 7368  .     HANDLE: sh
│ │ │ │ +0002cbd0: 6973 6869 2068 616e 646c 6520 6173 2061  ishi handle as a
│ │ │ │ +0002cbe0: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ +0002cbf0: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ +0002cc00: 0a20 2020 2020 4b45 593a 2069 6e70 7574  .     KEY: input
│ │ │ │ +0002cc10: 2063 6861 7261 6374 6572 2061 7272 6179   character array
│ │ │ │ +0002cc20: 2077 6974 6820 6b65 7920 746f 2075 7365   with key to use
│ │ │ │ +0002cc30: 2e0a 2020 2020 2049 563a 2069 6e70 7574  ..     IV: input
│ │ │ │ +0002cc40: 2063 6861 7261 6374 6572 2061 7272 6179   character array
│ │ │ │ +0002cc50: 2077 6974 6820 696e 6974 6961 6c69 7a61   with initializa
│ │ │ │ +0002cc60: 7469 6f6e 2076 6563 746f 7220 746f 2075  tion vector to u
│ │ │ │ +0002cc70: 7365 2c20 6361 6e20 6265 0a20 2020 2020  se, can be.     
│ │ │ │ +0002cc80: 4e55 4c4c 2e0a 2020 2020 2049 4e3a 2069  NULL..     IN: i
│ │ │ │ +0002cc90: 6e70 7574 2063 6861 7261 6374 6572 2061  nput character a
│ │ │ │ +0002cca0: 7272 6179 206f 6620 6461 7461 2074 6f20  rray of data to 
│ │ │ │ +0002ccb0: 6861 7368 2e0a 2020 2020 2049 4e4c 454e  hash..     INLEN
│ │ │ │ +0002ccc0: 3a20 6c65 6e67 7468 206f 6620 696e 7075  : length of inpu
│ │ │ │ +0002ccd0: 7420 6368 6172 6163 7465 7220 6172 7261  t character arra
│ │ │ │ +0002cce0: 7920 6f66 2064 6174 6120 746f 2068 6173  y of data to has
│ │ │ │ +0002ccf0: 682e 0a20 2020 2020 4f55 543a 206e 6577  h..     OUT: new
│ │ │ │ +0002cd00: 6c79 2061 6c6c 6f63 6174 6564 2063 6861  ly allocated cha
│ │ │ │ +0002cd10: 7261 6374 6572 2061 7272 6179 2077 6974  racter array wit
│ │ │ │ +0002cd20: 6820 6b65 7965 6420 6861 7368 206f 6620  h keyed hash of 
│ │ │ │ +0002cd30: 6461 7461 2e0a 0a20 2020 2020 2a44 6573  data...     *Des
│ │ │ │ +0002cd40: 6372 6970 7469 6f6e 3a2a 2043 6f6d 7075  cription:* Compu
│ │ │ │ +0002cd50: 7465 6420 6b65 7965 6420 6368 6563 6b73  ted keyed checks
│ │ │ │ +0002cd60: 756d 206f 6620 6461 7461 2075 7369 6e67  um of data using
│ │ │ │ +0002cd70: 2044 4553 2d43 4243 2d4d 4143 2e0a 2020   DES-CBC-MAC..  
│ │ │ │ +0002cd80: 2020 2054 6865 204f 5554 2062 7566 6665     The OUT buffe
│ │ │ │ +0002cd90: 7220 6d75 7374 2062 6520 6465 616c 6c6f  r must be deallo
│ │ │ │ +0002cda0: 6361 7465 6420 6279 2074 6865 2063 616c  cated by the cal
│ │ │ │ +0002cdb0: 6c65 722e 0a0a 2020 2020 202a 5265 7475  ler...     *Retu
│ │ │ │ +0002cdc0: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ +0002cdd0: 6e73 2053 4849 5348 495f 4f4b 2069 6666  ns SHISHI_OK iff
│ │ │ │ +0002cde0: 2073 7563 6365 7373 6675 6c2e 0a0a 7368   successful...sh
│ │ │ │ +0002cdf0: 6973 6869 5f61 7263 666f 7572 0a2d 2d2d  ishi_arcfour.---
│ │ │ │ +0002ce00: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ +0002ce10: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ +0002ce20: 6869 7368 695f 6172 6366 6f75 7220 2853  hishi_arcfour (S
│ │ │ │ +0002ce30: 6869 7368 6920 2a20 4841 4e44 4c45 2c20  hishi * HANDLE, 
│ │ │ │ +0002ce40: 696e 7420 4445 4352 5950 5450 2c0a 2020  int DECRYPTP,.  
│ │ │ │ +0002ce50: 2020 2020 2020 2020 636f 6e73 7420 6368          const ch
│ │ │ │ +0002ce60: 6172 202a 204b 4559 2c20 7369 7a65 5f74  ar * KEY, size_t
│ │ │ │ +0002ce70: 204b 4559 4c45 4e2c 2063 6f6e 7374 2063   KEYLEN, const c
│ │ │ │ +0002ce80: 6861 7220 4956 5b32 3538 5d2c 0a20 2020  har IV[258],.   
│ │ │ │ +0002ce90: 2020 2020 2020 2063 6861 7220 2a20 4956         char * IV
│ │ │ │ +0002cea0: 4f55 545b 3235 385d 2c20 636f 6e73 7420  OUT[258], const 
│ │ │ │ +0002ceb0: 6368 6172 202a 2049 4e2c 2073 697a 655f  char * IN, size_
│ │ │ │ +0002cec0: 7420 494e 4c45 4e2c 2063 6861 7220 2a2a  t INLEN, char **
│ │ │ │ +0002ced0: 204f 5554 290a 2020 2020 2048 414e 444c   OUT).     HANDL
│ │ │ │ +0002cee0: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ +0002cef0: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ +0002cf00: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ +0002cf10: 29e2 8099 2e0a 2020 2020 2044 4543 5259  ).....     DECRY
│ │ │ │ +0002cf20: 5054 503a 2030 2074 6f20 696e 6469 6361  PTP: 0 to indica
│ │ │ │ +0002cf30: 7465 2065 6e63 7279 7074 696f 6e2c 206e  te encryption, n
│ │ │ │ +0002cf40: 6f6e 2d30 2074 6f20 696e 6469 6361 7465  on-0 to indicate
│ │ │ │ +0002cf50: 2064 6563 7279 7074 696f 6e2e 0a20 2020   decryption..   
│ │ │ │ +0002cf60: 2020 4b45 593a 2069 6e70 7574 2063 6861    KEY: input cha
│ │ │ │ +0002cf70: 7261 6374 6572 2061 7272 6179 2077 6974  racter array wit
│ │ │ │ +0002cf80: 6820 6b65 7920 746f 2075 7365 2e0a 2020  h key to use..  
│ │ │ │ +0002cf90: 2020 204b 4559 4c45 4e3a 206c 656e 6774     KEYLEN: lengt
│ │ │ │ +0002cfa0: 6820 6f66 2069 6e70 7574 206b 6579 2061  h of input key a
│ │ │ │ +0002cfb0: 7272 6179 2e0a 2020 2020 2049 563a 2069  rray..     IV: i
│ │ │ │ +0002cfc0: 6e70 7574 2063 6861 7261 6374 6572 2061  nput character a
│ │ │ │ +0002cfd0: 7272 6179 2077 6974 6820 696e 6974 6961  rray with initia
│ │ │ │ +0002cfe0: 6c69 7a61 7469 6f6e 2076 6563 746f 7220  lization vector 
│ │ │ │ +0002cff0: 746f 2075 7365 2c20 6f72 0a20 2020 2020  to use, or.     
│ │ │ │ +0002d000: 4e55 4c4c 2e0a 2020 2020 2049 564f 5554  NULL..     IVOUT
│ │ │ │ +0002d010: 3a20 6f75 7470 7574 2063 6861 7261 6374  : output charact
│ │ │ │ +0002d020: 6572 2061 7272 6179 2077 6974 6820 7570  er array with up
│ │ │ │ +0002d030: 6461 7465 6420 696e 6974 6961 6c69 7a61  dated initializa
│ │ │ │ +0002d040: 7469 6f6e 2076 6563 746f 722c 0a20 2020  tion vector,.   
│ │ │ │ +0002d050: 2020 6f72 204e 554c 4c2e 0a20 2020 2020    or NULL..     
│ │ │ │ +0002d060: 494e 3a20 696e 7075 7420 6368 6172 6163  IN: input charac
│ │ │ │ +0002d070: 7465 7220 6172 7261 7920 6f66 2064 6174  ter array of dat
│ │ │ │ +0002d080: 6120 746f 2065 6e63 7279 7074 2f64 6563  a to encrypt/dec
│ │ │ │ +0002d090: 7279 7074 2e0a 2020 2020 2049 4e4c 454e  rypt..     INLEN
│ │ │ │ +0002d0a0: 3a20 6c65 6e67 7468 206f 6620 696e 7075  : length of inpu
│ │ │ │ +0002d0b0: 7420 6368 6172 6163 7465 7220 6172 7261  t character arra
│ │ │ │ +0002d0c0: 7920 6f66 2064 6174 6120 746f 2065 6e63  y of data to enc
│ │ │ │ +0002d0d0: 7279 7074 2f64 6563 7279 7074 2e0a 0a20  rypt/decrypt... 
│ │ │ │ +0002d0e0: 2020 2020 4f55 543a 206e 6577 6c79 2061      OUT: newly a
│ │ │ │ +0002d0f0: 6c6c 6f63 6174 6564 2063 6861 7261 6374  llocated charact
│ │ │ │ +0002d100: 6572 2061 7272 6179 2077 6974 6820 656e  er array with en
│ │ │ │ +0002d110: 6372 7970 7465 642f 6465 6372 7970 7465  crypted/decrypte
│ │ │ │ +0002d120: 6420 6461 7461 2e0a 0a20 2020 2020 2a44  d data...     *D
│ │ │ │ +0002d130: 6573 6372 6970 7469 6f6e 3a2a 2045 6e63  escription:* Enc
│ │ │ │ +0002d140: 7279 7074 206f 7220 6465 6372 7970 7420  rypt or decrypt 
│ │ │ │ +0002d150: 6461 7461 2028 6465 7065 6e64 696e 6720  data (depending 
│ │ │ │ +0002d160: 6f6e 2044 4543 5259 5054 5029 0a20 2020  on DECRYPTP).   
│ │ │ │ +0002d170: 2020 7573 696e 6720 4152 4346 4f55 522e    using ARCFOUR.
│ │ │ │ +0002d180: 2054 6865 204f 5554 2062 7566 6665 7220   The OUT buffer 
│ │ │ │ +0002d190: 6d75 7374 2062 6520 6465 616c 6c6f 6361  must be dealloca
│ │ │ │ +0002d1a0: 7465 6420 6279 2074 6865 2063 616c 6c65  ted by the calle
│ │ │ │ +0002d1b0: 722e 0a0a 2020 2020 2054 6865 2022 696e  r...     The "in
│ │ │ │ +0002d1c0: 6974 6961 6c69 7a61 7469 6f6e 2076 6563  itialization vec
│ │ │ │ +0002d1d0: 746f 7222 2075 7365 6420 6865 7265 2069  tor" used here i
│ │ │ │ +0002d1e0: 7320 7468 6520 636f 6e63 6174 656e 6174  s the concatenat
│ │ │ │ +0002d1f0: 696f 6e20 6f66 2074 6865 0a20 2020 2020  ion of the.     
│ │ │ │ +0002d200: 7362 6f78 2061 6e64 2069 2061 6e64 206a  sbox and i and j
│ │ │ │ +0002d210: 2c20 616e 6420 6973 2074 6875 7320 616c  , and is thus al
│ │ │ │ +0002d220: 7761 7973 206f 6620 7369 7a65 2032 3536  ways of size 256
│ │ │ │ +0002d230: 202b 2031 202b 2031 2e20 2054 6869 7320   + 1 + 1.  This 
│ │ │ │ +0002d240: 6973 0a20 2020 2020 6120 736c 6967 6874  is.     a slight
│ │ │ │ +0002d250: 2061 6275 7365 206f 6620 7465 726d 696e   abuse of termin
│ │ │ │ +0002d260: 6f6c 6f67 792c 2061 6e64 2061 7373 756d  ology, and assum
│ │ │ │ +0002d270: 6573 2079 6f75 206b 6e6f 7720 7768 6174  es you know what
│ │ │ │ +0002d280: 2079 6f75 2061 7265 0a20 2020 2020 646f   you are.     do
│ │ │ │ +0002d290: 696e 672e 2020 446f 6e27 7420 7573 6520  ing.  Don't use 
│ │ │ │ +0002d2a0: 6974 2069 6620 796f 7520 6361 6e20 6176  it if you can av
│ │ │ │ +0002d2b0: 6f69 6420 746f 2e0a 0a20 2020 2020 2a52  oid to...     *R
│ │ │ │ +0002d2c0: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +0002d2d0: 7475 726e 7320 5348 4953 4849 5f4f 4b20  turns SHISHI_OK 
│ │ │ │ +0002d2e0: 6966 6620 7375 6363 6573 7366 756c 2e0a  iff successful..
│ │ │ │ +0002d2f0: 0a73 6869 7368 695f 6465 730a 2d2d 2d2d  .shishi_des.----
│ │ │ │ +0002d300: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ +0002d310: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ +0002d320: 5f64 6573 2028 5368 6973 6869 202a 2048  _des (Shishi * H
│ │ │ │ +0002d330: 414e 444c 452c 2069 6e74 2044 4543 5259  ANDLE, int DECRY
│ │ │ │ +0002d340: 5054 502c 0a20 2020 2020 2020 2020 2063  PTP,.          c
│ │ │ │ +0002d350: 6f6e 7374 2063 6861 7220 4b45 595b 385d  onst char KEY[8]
│ │ │ │ +0002d360: 2c20 636f 6e73 7420 6368 6172 2049 565b  , const char IV[
│ │ │ │ +0002d370: 385d 2c20 6368 6172 202a 2049 564f 5554  8], char * IVOUT
│ │ │ │ +0002d380: 5b38 5d2c 0a20 2020 2020 2020 2020 2063  [8],.          c
│ │ │ │ +0002d390: 6f6e 7374 2063 6861 7220 2a20 494e 2c20  onst char * IN, 
│ │ │ │ +0002d3a0: 7369 7a65 5f74 2049 4e4c 454e 2c20 6368  size_t INLEN, ch
│ │ │ │ +0002d3b0: 6172 202a 2a20 4f55 5429 0a20 2020 2020  ar ** OUT).     
│ │ │ │ +0002d3c0: 4841 4e44 4c45 3a20 7368 6973 6869 2068  HANDLE: shishi h
│ │ │ │ +0002d3d0: 616e 646c 6520 6173 2061 6c6c 6f63 6174  andle as allocat
│ │ │ │ +0002d3e0: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ +0002d3f0: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ +0002d400: 4445 4352 5950 5450 3a20 3020 746f 2069  DECRYPTP: 0 to i
│ │ │ │ +0002d410: 6e64 6963 6174 6520 656e 6372 7970 7469  ndicate encrypti
│ │ │ │ +0002d420: 6f6e 2c20 6e6f 6e2d 3020 746f 2069 6e64  on, non-0 to ind
│ │ │ │ +0002d430: 6963 6174 6520 6465 6372 7970 7469 6f6e  icate decryption
│ │ │ │ +0002d440: 2e0a 2020 2020 204b 4559 3a20 696e 7075  ..     KEY: inpu
│ │ │ │ +0002d450: 7420 6368 6172 6163 7465 7220 6172 7261  t character arra
│ │ │ │ +0002d460: 7920 7769 7468 206b 6579 2074 6f20 7573  y with key to us
│ │ │ │ +0002d470: 652e 0a20 2020 2020 4956 3a20 696e 7075  e..     IV: inpu
│ │ │ │ +0002d480: 7420 6368 6172 6163 7465 7220 6172 7261  t character arra
│ │ │ │ +0002d490: 7920 7769 7468 2069 6e69 7469 616c 697a  y with initializ
│ │ │ │ +0002d4a0: 6174 696f 6e20 7665 6374 6f72 2074 6f20  ation vector to 
│ │ │ │ +0002d4b0: 7573 652c 206f 720a 2020 2020 204e 554c  use, or.     NUL
│ │ │ │ +0002d4c0: 4c2e 0a20 2020 2020 4956 4f55 543a 206f  L..     IVOUT: o
│ │ │ │ +0002d4d0: 7574 7075 7420 6368 6172 6163 7465 7220  utput character 
│ │ │ │ +0002d4e0: 6172 7261 7920 7769 7468 2075 7064 6174  array with updat
│ │ │ │ +0002d4f0: 6564 2069 6e69 7469 616c 697a 6174 696f  ed initializatio
│ │ │ │ +0002d500: 6e20 7665 6374 6f72 2c0a 2020 2020 206f  n vector,.     o
│ │ │ │ +0002d510: 7220 4e55 4c4c 2e0a 2020 2020 2049 4e3a  r NULL..     IN:
│ │ │ │ +0002d520: 2069 6e70 7574 2063 6861 7261 6374 6572   input character
│ │ │ │ +0002d530: 2061 7272 6179 206f 6620 6461 7461 2074   array of data t
│ │ │ │ +0002d540: 6f20 656e 6372 7970 742f 6465 6372 7970  o encrypt/decryp
│ │ │ │ +0002d550: 742e 0a20 2020 2020 494e 4c45 4e3a 206c  t..     INLEN: l
│ │ │ │ +0002d560: 656e 6774 6820 6f66 2069 6e70 7574 2063  ength of input c
│ │ │ │ +0002d570: 6861 7261 6374 6572 2061 7272 6179 206f  haracter array o
│ │ │ │ +0002d580: 6620 6461 7461 2074 6f20 656e 6372 7970  f data to encryp
│ │ │ │ +0002d590: 742f 6465 6372 7970 742e 0a0a 2020 2020  t/decrypt...    
│ │ │ │ +0002d5a0: 204f 5554 3a20 6e65 776c 7920 616c 6c6f   OUT: newly allo
│ │ │ │ +0002d5b0: 6361 7465 6420 6368 6172 6163 7465 7220  cated character 
│ │ │ │ +0002d5c0: 6172 7261 7920 7769 7468 2065 6e63 7279  array with encry
│ │ │ │ +0002d5d0: 7074 6564 2f64 6563 7279 7074 6564 2064  pted/decrypted d
│ │ │ │ +0002d5e0: 6174 612e 0a0a 2020 2020 202a 4465 7363  ata...     *Desc
│ │ │ │ +0002d5f0: 7269 7074 696f 6e3a 2a20 456e 6372 7970  ription:* Encryp
│ │ │ │ +0002d600: 7420 6f72 2064 6563 7279 7074 2064 6174  t or decrypt dat
│ │ │ │ +0002d610: 6120 2864 6570 656e 6469 6e67 206f 6e20  a (depending on 
│ │ │ │ +0002d620: 4445 4352 5950 5450 290a 2020 2020 2075  DECRYPTP).     u
│ │ │ │ +0002d630: 7369 6e67 2044 4553 2069 6e20 4342 4320  sing DES in CBC 
│ │ │ │ +0002d640: 6d6f 6465 2e20 2054 6865 204f 5554 2062  mode.  The OUT b
│ │ │ │ +0002d650: 7566 6665 7220 6d75 7374 2062 6520 6465  uffer must be de
│ │ │ │ +0002d660: 616c 6c6f 6361 7465 6420 6279 2074 6865  allocated by the
│ │ │ │ +0002d670: 0a20 2020 2020 6361 6c6c 6572 2e0a 0a20  .     caller... 
│ │ │ │ +0002d680: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ +0002d690: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ +0002d6a0: 4849 5f4f 4b20 6966 6620 7375 6363 6573  HI_OK iff succes
│ │ │ │ +0002d6b0: 7366 756c 2e0a 0a73 6869 7368 695f 3364  sful...shishi_3d
│ │ │ │ +0002d6c0: 6573 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  es.-----------..
│ │ │ │ +0002d6d0: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ +0002d6e0: 7420 7368 6973 6869 5f33 6465 7320 2853  t shishi_3des (S
│ │ │ │ +0002d6f0: 6869 7368 6920 2a20 4841 4e44 4c45 2c20  hishi * HANDLE, 
│ │ │ │ +0002d700: 696e 7420 4445 4352 5950 5450 2c0a 2020  int DECRYPTP,.  
│ │ │ │ +0002d710: 2020 2020 2020 2020 636f 6e73 7420 6368          const ch
│ │ │ │ +0002d720: 6172 204b 4559 5b38 5d2c 2063 6f6e 7374  ar KEY[8], const
│ │ │ │ +0002d730: 2063 6861 7220 4956 5b38 5d2c 2063 6861   char IV[8], cha
│ │ │ │ +0002d740: 7220 2a20 4956 4f55 545b 385d 2c0a 2020  r * IVOUT[8],.  
│ │ │ │ +0002d750: 2020 2020 2020 2020 636f 6e73 7420 6368          const ch
│ │ │ │ +0002d760: 6172 202a 2049 4e2c 2073 697a 655f 7420  ar * IN, size_t 
│ │ │ │ +0002d770: 494e 4c45 4e2c 2063 6861 7220 2a2a 204f  INLEN, char ** O
│ │ │ │ +0002d780: 5554 290a 2020 2020 2048 414e 444c 453a  UT).     HANDLE:
│ │ │ │ +0002d790: 2073 6869 7368 6920 6861 6e64 6c65 2061   shishi handle a
│ │ │ │ +0002d7a0: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ +0002d7b0: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ +0002d7c0: 8099 2e0a 2020 2020 2044 4543 5259 5054  ....     DECRYPT
│ │ │ │ +0002d7d0: 503a 2030 2074 6f20 696e 6469 6361 7465  P: 0 to indicate
│ │ │ │ +0002d7e0: 2065 6e63 7279 7074 696f 6e2c 206e 6f6e   encryption, non
│ │ │ │ +0002d7f0: 2d30 2074 6f20 696e 6469 6361 7465 2064  -0 to indicate d
│ │ │ │ +0002d800: 6563 7279 7074 696f 6e2e 0a20 2020 2020  ecryption..     
│ │ │ │ +0002d810: 4b45 593a 2069 6e70 7574 2063 6861 7261  KEY: input chara
│ │ │ │ +0002d820: 6374 6572 2061 7272 6179 2077 6974 6820  cter array with 
│ │ │ │ +0002d830: 6b65 7920 746f 2075 7365 2e0a 2020 2020  key to use..    
│ │ │ │ +0002d840: 2049 563a 2069 6e70 7574 2063 6861 7261   IV: input chara
│ │ │ │ +0002d850: 6374 6572 2061 7272 6179 2077 6974 6820  cter array with 
│ │ │ │ +0002d860: 696e 6974 6961 6c69 7a61 7469 6f6e 2076  initialization v
│ │ │ │ +0002d870: 6563 746f 7220 746f 2075 7365 2c20 6f72  ector to use, or
│ │ │ │ +0002d880: 0a20 2020 2020 4e55 4c4c 2e0a 2020 2020  .     NULL..    
│ │ │ │ +0002d890: 2049 564f 5554 3a20 6f75 7470 7574 2063   IVOUT: output c
│ │ │ │ +0002d8a0: 6861 7261 6374 6572 2061 7272 6179 2077  haracter array w
│ │ │ │ +0002d8b0: 6974 6820 7570 6461 7465 6420 696e 6974  ith updated init
│ │ │ │ +0002d8c0: 6961 6c69 7a61 7469 6f6e 2076 6563 746f  ialization vecto
│ │ │ │ +0002d8d0: 722c 0a20 2020 2020 6f72 204e 554c 4c2e  r,.     or NULL.
│ │ │ │ +0002d8e0: 0a20 2020 2020 494e 3a20 696e 7075 7420  .     IN: input 
│ │ │ │ +0002d8f0: 6368 6172 6163 7465 7220 6172 7261 7920  character array 
│ │ │ │ +0002d900: 6f66 2064 6174 6120 746f 2065 6e63 7279  of data to encry
│ │ │ │ +0002d910: 7074 2f64 6563 7279 7074 2e0a 2020 2020  pt/decrypt..    
│ │ │ │ +0002d920: 2049 4e4c 454e 3a20 6c65 6e67 7468 206f   INLEN: length o
│ │ │ │ +0002d930: 6620 696e 7075 7420 6368 6172 6163 7465  f input characte
│ │ │ │ +0002d940: 7220 6172 7261 7920 6f66 2064 6174 6120  r array of data 
│ │ │ │ +0002d950: 746f 2065 6e63 7279 7074 2f64 6563 7279  to encrypt/decry
│ │ │ │ +0002d960: 7074 2e0a 0a20 2020 2020 4f55 543a 206e  pt...     OUT: n
│ │ │ │ +0002d970: 6577 6c79 2061 6c6c 6f63 6174 6564 2063  ewly allocated c
│ │ │ │ +0002d980: 6861 7261 6374 6572 2061 7272 6179 2077  haracter array w
│ │ │ │ +0002d990: 6974 6820 656e 6372 7970 7465 642f 6465  ith encrypted/de
│ │ │ │ +0002d9a0: 6372 7970 7465 6420 6461 7461 2e0a 0a20  crypted data... 
│ │ │ │ +0002d9b0: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ +0002d9c0: 3a2a 2045 6e63 7279 7074 206f 7220 6465  :* Encrypt or de
│ │ │ │ +0002d9d0: 6372 7970 7420 6461 7461 2028 6465 7065  crypt data (depe
│ │ │ │ +0002d9e0: 6e64 696e 6720 6f6e 2044 4543 5259 5054  nding on DECRYPT
│ │ │ │ +0002d9f0: 5029 0a20 2020 2020 7573 696e 6720 3344  P).     using 3D
│ │ │ │ +0002da00: 4553 2069 6e20 4342 4320 6d6f 6465 2e20  ES in CBC mode. 
│ │ │ │ +0002da10: 2054 6865 204f 5554 2062 7566 6665 7220   The OUT buffer 
│ │ │ │ +0002da20: 6d75 7374 2062 6520 6465 616c 6c6f 6361  must be dealloca
│ │ │ │ +0002da30: 7465 6420 6279 2074 6865 0a20 2020 2020  ted by the.     
│ │ │ │ +0002da40: 6361 6c6c 6572 2e0a 0a20 2020 2020 2a52  caller...     *R
│ │ │ │ +0002da50: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +0002da60: 7475 726e 7320 5348 4953 4849 5f4f 4b20  turns SHISHI_OK 
│ │ │ │ +0002da70: 6966 6620 7375 6363 6573 7366 756c 2e0a  iff successful..
│ │ │ │ +0002da80: 0a73 6869 7368 695f 6165 735f 6374 730a  .shishi_aes_cts.
│ │ │ │ +0002da90: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ +0002daa0: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ +0002dab0: 7420 7368 6973 6869 5f61 6573 5f63 7473  t shishi_aes_cts
│ │ │ │ +0002dac0: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ +0002dad0: 452c 2069 6e74 2044 4543 5259 5054 502c  E, int DECRYPTP,
│ │ │ │ +0002dae0: 0a20 2020 2020 2020 2020 2063 6f6e 7374  .          const
│ │ │ │ +0002daf0: 2063 6861 7220 2a20 4b45 592c 2073 697a   char * KEY, siz
│ │ │ │ +0002db00: 655f 7420 4b45 594c 454e 2c20 636f 6e73  e_t KEYLEN, cons
│ │ │ │ +0002db10: 7420 6368 6172 2049 565b 3136 5d2c 0a20  t char IV[16],. 
│ │ │ │ +0002db20: 2020 2020 2020 2020 2063 6861 7220 2a20           char * 
│ │ │ │ +0002db30: 4956 4f55 545b 3136 5d2c 2063 6f6e 7374  IVOUT[16], const
│ │ │ │ +0002db40: 2063 6861 7220 2a20 494e 2c20 7369 7a65   char * IN, size
│ │ │ │ +0002db50: 5f74 2049 4e4c 454e 2c20 6368 6172 202a  _t INLEN, char *
│ │ │ │ +0002db60: 2a20 4f55 5429 0a20 2020 2020 4841 4e44  * OUT).     HAND
│ │ │ │ +0002db70: 4c45 3a20 7368 6973 6869 2068 616e 646c  LE: shishi handl
│ │ │ │ +0002db80: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ +0002db90: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ +0002dba0: 2829 e280 992e 0a20 2020 2020 4445 4352  ().....     DECR
│ │ │ │ +0002dbb0: 5950 5450 3a20 3020 746f 2069 6e64 6963  YPTP: 0 to indic
│ │ │ │ +0002dbc0: 6174 6520 656e 6372 7970 7469 6f6e 2c20  ate encryption, 
│ │ │ │ +0002dbd0: 6e6f 6e2d 3020 746f 2069 6e64 6963 6174  non-0 to indicat
│ │ │ │ +0002dbe0: 6520 6465 6372 7970 7469 6f6e 2e0a 2020  e decryption..  
│ │ │ │ +0002dbf0: 2020 204b 4559 3a20 696e 7075 7420 6368     KEY: input ch
│ │ │ │ +0002dc00: 6172 6163 7465 7220 6172 7261 7920 7769  aracter array wi
│ │ │ │ +0002dc10: 7468 206b 6579 2074 6f20 7573 652e 0a20  th key to use.. 
│ │ │ │ +0002dc20: 2020 2020 4b45 594c 454e 3a20 6c65 6e67      KEYLEN: leng
│ │ │ │ +0002dc30: 7468 206f 6620 696e 7075 7420 6368 6172  th of input char
│ │ │ │ +0002dc40: 6163 7465 7220 6172 7261 7920 7769 7468  acter array with
│ │ │ │ +0002dc50: 206b 6579 2074 6f20 7573 652e 0a20 2020   key to use..   
│ │ │ │ +0002dc60: 2020 4956 3a20 696e 7075 7420 6368 6172    IV: input char
│ │ │ │ +0002dc70: 6163 7465 7220 6172 7261 7920 7769 7468  acter array with
│ │ │ │ +0002dc80: 2069 6e69 7469 616c 697a 6174 696f 6e20   initialization 
│ │ │ │ +0002dc90: 7665 6374 6f72 2074 6f20 7573 652c 206f  vector to use, o
│ │ │ │ +0002dca0: 720a 2020 2020 204e 554c 4c2e 0a20 2020  r.     NULL..   
│ │ │ │ +0002dcb0: 2020 4956 4f55 543a 206f 7574 7075 7420    IVOUT: output 
│ │ │ │ +0002dcc0: 6368 6172 6163 7465 7220 6172 7261 7920  character array 
│ │ │ │ +0002dcd0: 7769 7468 2075 7064 6174 6564 2069 6e69  with updated ini
│ │ │ │ +0002dce0: 7469 616c 697a 6174 696f 6e20 7665 6374  tialization vect
│ │ │ │ +0002dcf0: 6f72 2c0a 2020 2020 206f 7220 4e55 4c4c  or,.     or NULL
│ │ │ │ +0002dd00: 2e0a 2020 2020 2049 4e3a 2069 6e70 7574  ..     IN: input
│ │ │ │ +0002dd10: 2063 6861 7261 6374 6572 2061 7272 6179   character array
│ │ │ │ +0002dd20: 206f 6620 6461 7461 2074 6f20 656e 6372   of data to encr
│ │ │ │ +0002dd30: 7970 742f 6465 6372 7970 742e 0a20 2020  ypt/decrypt..   
│ │ │ │ +0002dd40: 2020 494e 4c45 4e3a 206c 656e 6774 6820    INLEN: length 
│ │ │ │ +0002dd50: 6f66 2069 6e70 7574 2063 6861 7261 6374  of input charact
│ │ │ │ +0002dd60: 6572 2061 7272 6179 206f 6620 6461 7461  er array of data
│ │ │ │ +0002dd70: 2074 6f20 656e 6372 7970 742f 6465 6372   to encrypt/decr
│ │ │ │ +0002dd80: 7970 742e 0a0a 2020 2020 204f 5554 3a20  ypt...     OUT: 
│ │ │ │ +0002dd90: 6e65 776c 7920 616c 6c6f 6361 7465 6420  newly allocated 
│ │ │ │ +0002dda0: 6368 6172 6163 7465 7220 6172 7261 7920  character array 
│ │ │ │ +0002ddb0: 7769 7468 2065 6e63 7279 7074 6564 2f64  with encrypted/d
│ │ │ │ +0002ddc0: 6563 7279 7074 6564 2064 6174 612e 0a0a  ecrypted data...
│ │ │ │ +0002ddd0: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ +0002dde0: 6e3a 2a20 456e 6372 7970 7420 6f72 2064  n:* Encrypt or d
│ │ │ │ +0002ddf0: 6563 7279 7074 2064 6174 6120 2864 6570  ecrypt data (dep
│ │ │ │ +0002de00: 656e 6469 6e67 206f 6e20 4445 4352 5950  ending on DECRYP
│ │ │ │ +0002de10: 5450 290a 2020 2020 2075 7369 6e67 2041  TP).     using A
│ │ │ │ +0002de20: 4553 2069 6e20 4342 432d 4354 5320 6d6f  ES in CBC-CTS mo
│ │ │ │ +0002de30: 6465 2e20 2054 6865 206c 656e 6774 6820  de.  The length 
│ │ │ │ +0002de40: 6f66 2074 6865 206b 6579 2c20 4b45 594c  of the key, KEYL
│ │ │ │ +0002de50: 454e 2c20 6465 6369 6465 0a20 2020 2020  EN, decide.     
│ │ │ │ +0002de60: 6966 2041 4553 2031 3238 206f 7220 4145  if AES 128 or AE
│ │ │ │ +0002de70: 5320 3235 3620 7368 6f75 6c64 2062 6520  S 256 should be 
│ │ │ │ +0002de80: 7573 6564 2e20 2054 6865 204f 5554 2062  used.  The OUT b
│ │ │ │ +0002de90: 7566 6665 7220 6d75 7374 2062 650a 2020  uffer must be.  
│ │ │ │ +0002dea0: 2020 2064 6561 6c6c 6f63 6174 6564 2062     deallocated b
│ │ │ │ +0002deb0: 7920 7468 6520 6361 6c6c 6572 2e0a 0a20  y the caller... 
│ │ │ │ +0002dec0: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ +0002ded0: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ +0002dee0: 4849 5f4f 4b20 6966 6620 7375 6363 6573  HI_OK iff succes
│ │ │ │ +0002def0: 7366 756c 2e0a 0a73 6869 7368 695f 7062  sful...shishi_pb
│ │ │ │ +0002df00: 6b64 6632 5f73 6861 310a 2d2d 2d2d 2d2d  kdf2_sha1.------
│ │ │ │ +0002df10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ +0002df20: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ +0002df30: 7368 6973 6869 5f70 626b 6466 325f 7368  shishi_pbkdf2_sh
│ │ │ │ +0002df40: 6131 2028 5368 6973 6869 202a 2048 414e  a1 (Shishi * HAN
│ │ │ │ +0002df50: 444c 452c 2063 6f6e 7374 2063 6861 7220  DLE, const char 
│ │ │ │ +0002df60: 2a20 502c 0a20 2020 2020 2020 2020 2073  * P,.          s
│ │ │ │ +0002df70: 697a 655f 7420 504c 454e 2c20 636f 6e73  ize_t PLEN, cons
│ │ │ │ +0002df80: 7420 6368 6172 202a 2053 2c20 7369 7a65  t char * S, size
│ │ │ │ +0002df90: 5f74 2053 4c45 4e2c 2075 6e73 6967 6e65  _t SLEN, unsigne
│ │ │ │ +0002dfa0: 6420 696e 7420 432c 0a20 2020 2020 2020  d int C,.       
│ │ │ │ +0002dfb0: 2020 2075 6e73 6967 6e65 6420 696e 7420     unsigned int 
│ │ │ │ +0002dfc0: 444b 4c45 4e2c 2063 6861 7220 2a20 444b  DKLEN, char * DK
│ │ │ │ +0002dfd0: 290a 2020 2020 2048 414e 444c 453a 2073  ).     HANDLE: s
│ │ │ │ +0002dfe0: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ +0002dff0: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ +0002e000: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ +0002e010: 2e0a 2020 2020 2050 3a20 696e 7075 7420  ..     P: input 
│ │ │ │ +0002e020: 7061 7373 776f 7264 2c20 616e 206f 6374  password, an oct
│ │ │ │ +0002e030: 6574 2073 7472 696e 670a 2020 2020 2050  et string.     P
│ │ │ │ +0002e040: 4c45 4e3a 206c 656e 6774 6820 6f66 2070  LEN: length of p
│ │ │ │ +0002e050: 6173 7377 6f72 642c 2061 6e20 6f63 7465  assword, an octe
│ │ │ │ +0002e060: 7420 7374 7269 6e67 0a20 2020 2020 533a  t string.     S:
│ │ │ │ +0002e070: 2069 6e70 7574 2073 616c 742c 2061 6e20   input salt, an 
│ │ │ │ +0002e080: 6f63 7465 7420 7374 7269 6e67 0a20 2020  octet string.   
│ │ │ │ +0002e090: 2020 534c 454e 3a20 6c65 6e67 7468 206f    SLEN: length o
│ │ │ │ +0002e0a0: 6620 7361 6c74 2c20 616e 206f 6374 6574  f salt, an octet
│ │ │ │ +0002e0b0: 2073 7472 696e 670a 2020 2020 2043 3a20   string.     C: 
│ │ │ │ +0002e0c0: 6974 6572 6174 696f 6e20 636f 756e 742c  iteration count,
│ │ │ │ +0002e0d0: 2061 2070 6f73 6974 6976 6520 696e 7465   a positive inte
│ │ │ │ +0002e0e0: 6765 720a 2020 2020 2044 4b4c 454e 3a20  ger.     DKLEN: 
│ │ │ │ +0002e0f0: 696e 7465 6e64 6564 206c 656e 6774 6820  intended length 
│ │ │ │ +0002e100: 696e 206f 6374 6574 7320 6f66 2074 6865  in octets of the
│ │ │ │ +0002e110: 2064 6572 6976 6564 206b 6579 2c20 6120   derived key, a 
│ │ │ │ +0002e120: 706f 7369 7469 7665 0a20 2020 2020 696e  positive.     in
│ │ │ │ +0002e130: 7465 6765 722c 2061 7420 6d6f 7374 2028  teger, at most (
│ │ │ │ +0002e140: 325e 3332 202d 2031 2920 2a20 684c 656e  2^32 - 1) * hLen
│ │ │ │ +0002e150: 2e20 2054 6865 2044 4b20 6172 7261 7920  .  The DK array 
│ │ │ │ +0002e160: 6d75 7374 2068 6176 6520 726f 6f6d 0a20  must have room. 
│ │ │ │ +0002e170: 2020 2020 666f 7220 7468 6973 206d 616e      for this man
│ │ │ │ +0002e180: 7920 6368 6172 6163 7465 7273 2e0a 2020  y characters..  
│ │ │ │ +0002e190: 2020 2044 4b3a 206f 7574 7075 7420 6465     DK: output de
│ │ │ │ +0002e1a0: 7269 7665 6420 6b65 792c 2061 2064 6b4c  rived key, a dkL
│ │ │ │ +0002e1b0: 656e 2d6f 6374 6574 2073 7472 696e 670a  en-octet string.
│ │ │ │ +0002e1c0: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +0002e1d0: 6f6e 3a2a 2044 6572 6976 6520 6b65 7920  on:* Derive key 
│ │ │ │ +0002e1e0: 7573 696e 6720 7468 6520 5042 4b44 4632  using the PBKDF2
│ │ │ │ +0002e1f0: 2064 6566 696e 6564 2069 6e20 504b 4353   defined in PKCS
│ │ │ │ +0002e200: 352e 0a20 2020 2020 5042 4b44 4632 2061  5..     PBKDF2 a
│ │ │ │ +0002e210: 7070 6c69 6573 2061 2070 7365 7564 6f72  pplies a pseudor
│ │ │ │ +0002e220: 616e 646f 6d20 6675 6e63 7469 6f6e 2074  andom function t
│ │ │ │ +0002e230: 6f20 6465 7269 7665 206b 6579 732e 2020  o derive keys.  
│ │ │ │ +0002e240: 5468 6520 6c65 6e67 7468 0a20 2020 2020  The length.     
│ │ │ │ +0002e250: 6f66 2074 6865 2064 6572 6976 6564 206b  of the derived k
│ │ │ │ +0002e260: 6579 2069 7320 6573 7365 6e74 6961 6c6c  ey is essentiall
│ │ │ │ +0002e270: 7920 756e 626f 756e 6465 642e 2020 2848  y unbounded.  (H
│ │ │ │ +0002e280: 6f77 6576 6572 2c20 7468 6520 6d61 7869  owever, the maxi
│ │ │ │ +0002e290: 6d75 6d0a 2020 2020 2065 6666 6563 7469  mum.     effecti
│ │ │ │ +0002e2a0: 7665 2073 6561 7263 6820 7370 6163 6520  ve search space 
│ │ │ │ +0002e2b0: 666f 7220 7468 6520 6465 7269 7665 6420  for the derived 
│ │ │ │ +0002e2c0: 6b65 7920 6d61 7920 6265 206c 696d 6974  key may be limit
│ │ │ │ +0002e2d0: 6564 2062 7920 7468 650a 2020 2020 2073  ed by the.     s
│ │ │ │ +0002e2e0: 7472 7563 7475 7265 206f 6620 7468 6520  tructure of the 
│ │ │ │ +0002e2f0: 756e 6465 726c 7969 6e67 2070 7365 7564  underlying pseud
│ │ │ │ +0002e300: 6f72 616e 646f 6d20 6675 6e63 7469 6f6e  orandom function
│ │ │ │ +0002e310: 2c20 7768 6963 6820 6973 2074 6869 730a  , which is this.
│ │ │ │ +0002e320: 2020 2020 2066 756e 6374 696f 6e20 6973       function is
│ │ │ │ +0002e330: 2061 6c77 6179 7320 5348 4131 2e29 0a0a   always SHA1.)..
│ │ │ │ +0002e340: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ +0002e350: 7565 3a2a 2052 6574 7572 6e73 2053 4849  ue:* Returns SHI
│ │ │ │ +0002e360: 5348 495f 4f4b 2069 6666 2073 7563 6365  SHI_OK iff succe
│ │ │ │ +0002e370: 7373 6675 6c2e 0a0a 1f0a 4669 6c65 3a20  ssful.....File: 
│ │ │ │ +0002e380: 7368 6973 6869 2e69 6e66 6f2c 2020 4e6f  shishi.info,  No
│ │ │ │ +0002e390: 6465 3a20 582e 3530 3920 4675 6e63 7469  de: X.509 Functi
│ │ │ │ +0002e3a0: 6f6e 732c 2020 4e65 7874 3a20 5574 696c  ons,  Next: Util
│ │ │ │ +0002e3b0: 6974 7920 4675 6e63 7469 6f6e 732c 2020  ity Functions,  
│ │ │ │ +0002e3c0: 5072 6576 3a20 4372 7970 746f 6772 6170  Prev: Cryptograp
│ │ │ │ +0002e3d0: 6869 6320 4675 6e63 7469 6f6e 732c 2020  hic Functions,  
│ │ │ │ +0002e3e0: 5570 3a20 5072 6f67 7261 6d6d 696e 6720  Up: Programming 
│ │ │ │ +0002e3f0: 4d61 6e75 616c 0a0a 352e 3134 2058 2e35  Manual..5.14 X.5
│ │ │ │ +0002e400: 3039 2046 756e 6374 696f 6e73 0a3d 3d3d  09 Functions.===
│ │ │ │  0002e410: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ -0002e420: 0a0a 5468 6520 6675 6e63 7469 6f6e 7320  ..The functions 
│ │ │ │ -0002e430: 6465 7363 7269 6265 6420 696e 2074 6869  described in thi
│ │ │ │ -0002e440: 7320 7365 6374 696f 6e20 6172 6520 7573  s section are us
│ │ │ │ -0002e450: 6564 2062 7920 7468 6520 5354 4152 5454  ed by the STARTT
│ │ │ │ -0002e460: 4c53 0a66 756e 6374 696f 6e61 6c69 7479  LS.functionality
│ │ │ │ -0002e470: 2c20 7365 6520 2a6e 6f74 6520 4b65 7262  , see *note Kerb
│ │ │ │ -0002e480: 6572 6f73 2076 6961 2054 4c53 3a3a 2e0a  eros via TLS::..
│ │ │ │ -0002e490: 0a73 6869 7368 695f 7835 3039 6361 5f64  .shishi_x509ca_d
│ │ │ │ -0002e4a0: 6566 6175 6c74 5f66 696c 655f 6775 6573  efault_file_gues
│ │ │ │ -0002e4b0: 730a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  s.--------------
│ │ │ │ +0002e420: 3d0a 0a54 6865 2066 756e 6374 696f 6e73  =..The functions
│ │ │ │ +0002e430: 2064 6573 6372 6962 6564 2069 6e20 7468   described in th
│ │ │ │ +0002e440: 6973 2073 6563 7469 6f6e 2061 7265 2075  is section are u
│ │ │ │ +0002e450: 7365 6420 6279 2074 6865 2053 5441 5254  sed by the START
│ │ │ │ +0002e460: 544c 530a 6675 6e63 7469 6f6e 616c 6974  TLS.functionalit
│ │ │ │ +0002e470: 792c 2073 6565 202a 6e6f 7465 204b 6572  y, see *note Ker
│ │ │ │ +0002e480: 6265 726f 7320 7669 6120 544c 533a 3a2e  beros via TLS::.
│ │ │ │ +0002e490: 0a0a 7368 6973 6869 5f78 3530 3963 615f  ..shishi_x509ca_
│ │ │ │ +0002e4a0: 6465 6661 756c 745f 6669 6c65 5f67 7565  default_file_gue
│ │ │ │ +0002e4b0: 7373 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ss.-------------
│ │ │ │  0002e4c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0002e4d0: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ -0002e4e0: 3a20 6368 6172 202a 2073 6869 7368 695f  : char * shishi_
│ │ │ │ -0002e4f0: 7835 3039 6361 5f64 6566 6175 6c74 5f66  x509ca_default_f
│ │ │ │ -0002e500: 696c 655f 6775 6573 7320 2853 6869 7368  ile_guess (Shish
│ │ │ │ -0002e510: 6920 2a20 4841 4e44 4c45 290a 2020 2020  i * HANDLE).    
│ │ │ │ -0002e520: 2048 414e 444c 453a 2053 6869 7368 6920   HANDLE: Shishi 
│ │ │ │ -0002e530: 6c69 6272 6172 7920 6861 6e64 6c65 2063  library handle c
│ │ │ │ -0002e540: 7265 6174 6520 6279 20e2 8098 7368 6973  reate by ...shis
│ │ │ │ -0002e550: 6869 5f69 6e69 7428 29e2 8099 2e0a 0a20  hi_init()...... 
│ │ │ │ -0002e560: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -0002e570: 3a2a 2047 7565 7373 6573 2074 6865 2064  :* Guesses the d
│ │ │ │ -0002e580: 6566 6175 6c74 2058 2e35 3039 2043 4120  efault X.509 CA 
│ │ │ │ -0002e590: 6365 7274 6966 6963 6174 6520 6669 6c65  certificate file
│ │ │ │ -0002e5a0: 6e61 6d65 3b0a 2020 2020 2069 7420 6973  name;.     it is
│ │ │ │ -0002e5b0: 20e2 8098 484f 4d45 e280 992f 2e73 6869   ...HOME.../.shi
│ │ │ │ -0002e5c0: 7368 692f 636c 6965 6e74 2e63 612e 0a0a  shi/client.ca...
│ │ │ │ -0002e5d0: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ -0002e5e0: 7565 3a2a 2052 6574 7572 6e73 2064 6566  ue:* Returns def
│ │ │ │ -0002e5f0: 6175 6c74 2058 2e35 3039 2063 6c69 656e  ault X.509 clien
│ │ │ │ -0002e600: 7420 6365 7274 6966 6963 6174 6520 6669  t certificate fi
│ │ │ │ -0002e610: 6c65 6e61 6d65 0a20 2020 2020 6173 2061  lename.     as a
│ │ │ │ -0002e620: 2073 7472 696e 6720 7468 6174 2068 6173   string that has
│ │ │ │ -0002e630: 2074 6f20 6265 2064 6561 6c6c 6f63 6174   to be deallocat
│ │ │ │ -0002e640: 6564 2077 6974 6820 e280 9866 7265 6528  ed with ...free(
│ │ │ │ -0002e650: 29e2 8099 2062 7920 7468 6520 6361 6c6c  )... by the call
│ │ │ │ -0002e660: 6572 2e0a 0a73 6869 7368 695f 7835 3039  er...shishi_x509
│ │ │ │ -0002e670: 6361 5f64 6566 6175 6c74 5f66 696c 655f  ca_default_file_
│ │ │ │ -0002e680: 7365 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  set.------------
│ │ │ │ +0002e4d0: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ +0002e4e0: 6e3a 2063 6861 7220 2a20 7368 6973 6869  n: char * shishi
│ │ │ │ +0002e4f0: 5f78 3530 3963 615f 6465 6661 756c 745f  _x509ca_default_
│ │ │ │ +0002e500: 6669 6c65 5f67 7565 7373 2028 5368 6973  file_guess (Shis
│ │ │ │ +0002e510: 6869 202a 2048 414e 444c 4529 0a20 2020  hi * HANDLE).   
│ │ │ │ +0002e520: 2020 4841 4e44 4c45 3a20 5368 6973 6869    HANDLE: Shishi
│ │ │ │ +0002e530: 206c 6962 7261 7279 2068 616e 646c 6520   library handle 
│ │ │ │ +0002e540: 6372 6561 7465 2062 7920 e280 9873 6869  create by ...shi
│ │ │ │ +0002e550: 7368 695f 696e 6974 2829 e280 992e 0a0a  shi_init()......
│ │ │ │ +0002e560: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ +0002e570: 6e3a 2a20 4775 6573 7365 7320 7468 6520  n:* Guesses the 
│ │ │ │ +0002e580: 6465 6661 756c 7420 582e 3530 3920 4341  default X.509 CA
│ │ │ │ +0002e590: 2063 6572 7469 6669 6361 7465 2066 696c   certificate fil
│ │ │ │ +0002e5a0: 656e 616d 653b 0a20 2020 2020 6974 2069  ename;.     it i
│ │ │ │ +0002e5b0: 7320 e280 9848 4f4d 45e2 8099 2f2e 7368  s ...HOME.../.sh
│ │ │ │ +0002e5c0: 6973 6869 2f63 6c69 656e 742e 6361 2e0a  ishi/client.ca..
│ │ │ │ +0002e5d0: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ +0002e5e0: 6c75 653a 2a20 5265 7475 726e 7320 6465  lue:* Returns de
│ │ │ │ +0002e5f0: 6661 756c 7420 582e 3530 3920 636c 6965  fault X.509 clie
│ │ │ │ +0002e600: 6e74 2063 6572 7469 6669 6361 7465 2066  nt certificate f
│ │ │ │ +0002e610: 696c 656e 616d 650a 2020 2020 2061 7320  ilename.     as 
│ │ │ │ +0002e620: 6120 7374 7269 6e67 2074 6861 7420 6861  a string that ha
│ │ │ │ +0002e630: 7320 746f 2062 6520 6465 616c 6c6f 6361  s to be dealloca
│ │ │ │ +0002e640: 7465 6420 7769 7468 20e2 8098 6672 6565  ted with ...free
│ │ │ │ +0002e650: 2829 e280 9920 6279 2074 6865 2063 616c  ()... by the cal
│ │ │ │ +0002e660: 6c65 722e 0a0a 7368 6973 6869 5f78 3530  ler...shishi_x50
│ │ │ │ +0002e670: 3963 615f 6465 6661 756c 745f 6669 6c65  9ca_default_file
│ │ │ │ +0002e680: 5f73 6574 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  _set.-----------
│ │ │ │  0002e690: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0002e6a0: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ -0002e6b0: 3a20 766f 6964 2073 6869 7368 695f 7835  : void shishi_x5
│ │ │ │ -0002e6c0: 3039 6361 5f64 6566 6175 6c74 5f66 696c  09ca_default_fil
│ │ │ │ -0002e6d0: 655f 7365 7420 2853 6869 7368 6920 2a20  e_set (Shishi * 
│ │ │ │ -0002e6e0: 4841 4e44 4c45 2c0a 2020 2020 2020 2020  HANDLE,.        
│ │ │ │ -0002e6f0: 2020 636f 6e73 7420 6368 6172 202a 2058    const char * X
│ │ │ │ -0002e700: 3530 3943 4146 494c 4529 0a20 2020 2020  509CAFILE).     
│ │ │ │ -0002e710: 4841 4e44 4c45 3a20 5368 6973 6869 206c  HANDLE: Shishi l
│ │ │ │ -0002e720: 6962 7261 7279 2068 616e 646c 6520 6372  ibrary handle cr
│ │ │ │ -0002e730: 6561 7465 2062 7920 e280 9873 6869 7368  eate by ...shish
│ │ │ │ -0002e740: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ -0002e750: 2020 5835 3039 4341 4649 4c45 3a20 7374    X509CAFILE: st
│ │ │ │ -0002e760: 7269 6e67 2077 6974 6820 6e65 7720 6465  ring with new de
│ │ │ │ -0002e770: 6661 756c 7420 7835 3039 2063 6c69 656e  fault x509 clien
│ │ │ │ -0002e780: 7420 6365 7274 6966 6963 6174 6520 6669  t certificate fi
│ │ │ │ -0002e790: 6c65 0a20 2020 2020 6e61 6d65 2c20 6f72  le.     name, or
│ │ │ │ -0002e7a0: 204e 554c 4c20 746f 2072 6573 6574 2074   NULL to reset t
│ │ │ │ -0002e7b0: 6f20 6465 6661 756c 742e 0a0a 2020 2020  o default...    
│ │ │ │ -0002e7c0: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ -0002e7d0: 5365 7420 7468 6520 6465 6661 756c 7420  Set the default 
│ │ │ │ -0002e7e0: 582e 3530 3920 4341 2063 6572 7469 6669  X.509 CA certifi
│ │ │ │ -0002e7f0: 6361 7465 2066 696c 656e 616d 6520 7573  cate filename us
│ │ │ │ -0002e800: 6564 0a20 2020 2020 696e 2074 6865 206c  ed.     in the l
│ │ │ │ -0002e810: 6962 7261 7279 2e20 2054 6865 2063 6572  ibrary.  The cer
│ │ │ │ -0002e820: 7469 6669 6361 7465 2069 7320 7573 6564  tificate is used
│ │ │ │ -0002e830: 2064 7572 696e 6720 544c 5320 636f 6e6e   during TLS conn
│ │ │ │ -0002e840: 6563 7469 6f6e 730a 2020 2020 2077 6974  ections.     wit
│ │ │ │ -0002e850: 6820 7468 6520 4b44 4320 746f 2061 7574  h the KDC to aut
│ │ │ │ -0002e860: 6865 6e74 6963 6174 6520 7468 6520 4b44  henticate the KD
│ │ │ │ -0002e870: 432e 2054 6865 2073 7472 696e 6720 6973  C. The string is
│ │ │ │ -0002e880: 2063 6f70 6965 6420 696e 746f 2074 6865   copied into the
│ │ │ │ -0002e890: 0a20 2020 2020 6c69 6272 6172 792c 2073  .     library, s
│ │ │ │ -0002e8a0: 6f20 796f 7520 6361 6e20 6469 7370 6f73  o you can dispos
│ │ │ │ -0002e8b0: 6520 6f66 2074 6865 2076 6172 6961 626c  e of the variabl
│ │ │ │ -0002e8c0: 6520 696d 6d65 6469 6174 656c 7920 6166  e immediately af
│ │ │ │ -0002e8d0: 7465 720a 2020 2020 2063 616c 6c69 6e67  ter.     calling
│ │ │ │ -0002e8e0: 2074 6869 7320 6675 6e63 7469 6f6e 2e0a   this function..
│ │ │ │ -0002e8f0: 0a73 6869 7368 695f 7835 3039 6361 5f64  .shishi_x509ca_d
│ │ │ │ -0002e900: 6566 6175 6c74 5f66 696c 650a 2d2d 2d2d  efault_file.----
│ │ │ │ +0002e6a0: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ +0002e6b0: 6e3a 2076 6f69 6420 7368 6973 6869 5f78  n: void shishi_x
│ │ │ │ +0002e6c0: 3530 3963 615f 6465 6661 756c 745f 6669  509ca_default_fi
│ │ │ │ +0002e6d0: 6c65 5f73 6574 2028 5368 6973 6869 202a  le_set (Shishi *
│ │ │ │ +0002e6e0: 2048 414e 444c 452c 0a20 2020 2020 2020   HANDLE,.       
│ │ │ │ +0002e6f0: 2020 2063 6f6e 7374 2063 6861 7220 2a20     const char * 
│ │ │ │ +0002e700: 5835 3039 4341 4649 4c45 290a 2020 2020  X509CAFILE).    
│ │ │ │ +0002e710: 2048 414e 444c 453a 2053 6869 7368 6920   HANDLE: Shishi 
│ │ │ │ +0002e720: 6c69 6272 6172 7920 6861 6e64 6c65 2063  library handle c
│ │ │ │ +0002e730: 7265 6174 6520 6279 20e2 8098 7368 6973  reate by ...shis
│ │ │ │ +0002e740: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ +0002e750: 2020 2058 3530 3943 4146 494c 453a 2073     X509CAFILE: s
│ │ │ │ +0002e760: 7472 696e 6720 7769 7468 206e 6577 2064  tring with new d
│ │ │ │ +0002e770: 6566 6175 6c74 2078 3530 3920 636c 6965  efault x509 clie
│ │ │ │ +0002e780: 6e74 2063 6572 7469 6669 6361 7465 2066  nt certificate f
│ │ │ │ +0002e790: 696c 650a 2020 2020 206e 616d 652c 206f  ile.     name, o
│ │ │ │ +0002e7a0: 7220 4e55 4c4c 2074 6f20 7265 7365 7420  r NULL to reset 
│ │ │ │ +0002e7b0: 746f 2064 6566 6175 6c74 2e0a 0a20 2020  to default...   
│ │ │ │ +0002e7c0: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ +0002e7d0: 2053 6574 2074 6865 2064 6566 6175 6c74   Set the default
│ │ │ │ +0002e7e0: 2058 2e35 3039 2043 4120 6365 7274 6966   X.509 CA certif
│ │ │ │ +0002e7f0: 6963 6174 6520 6669 6c65 6e61 6d65 2075  icate filename u
│ │ │ │ +0002e800: 7365 640a 2020 2020 2069 6e20 7468 6520  sed.     in the 
│ │ │ │ +0002e810: 6c69 6272 6172 792e 2020 5468 6520 6365  library.  The ce
│ │ │ │ +0002e820: 7274 6966 6963 6174 6520 6973 2075 7365  rtificate is use
│ │ │ │ +0002e830: 6420 6475 7269 6e67 2054 4c53 2063 6f6e  d during TLS con
│ │ │ │ +0002e840: 6e65 6374 696f 6e73 0a20 2020 2020 7769  nections.     wi
│ │ │ │ +0002e850: 7468 2074 6865 204b 4443 2074 6f20 6175  th the KDC to au
│ │ │ │ +0002e860: 7468 656e 7469 6361 7465 2074 6865 204b  thenticate the K
│ │ │ │ +0002e870: 4443 2e20 5468 6520 7374 7269 6e67 2069  DC. The string i
│ │ │ │ +0002e880: 7320 636f 7069 6564 2069 6e74 6f20 7468  s copied into th
│ │ │ │ +0002e890: 650a 2020 2020 206c 6962 7261 7279 2c20  e.     library, 
│ │ │ │ +0002e8a0: 736f 2079 6f75 2063 616e 2064 6973 706f  so you can dispo
│ │ │ │ +0002e8b0: 7365 206f 6620 7468 6520 7661 7269 6162  se of the variab
│ │ │ │ +0002e8c0: 6c65 2069 6d6d 6564 6961 7465 6c79 2061  le immediately a
│ │ │ │ +0002e8d0: 6674 6572 0a20 2020 2020 6361 6c6c 696e  fter.     callin
│ │ │ │ +0002e8e0: 6720 7468 6973 2066 756e 6374 696f 6e2e  g this function.
│ │ │ │ +0002e8f0: 0a0a 7368 6973 6869 5f78 3530 3963 615f  ..shishi_x509ca_
│ │ │ │ +0002e900: 6465 6661 756c 745f 6669 6c65 0a2d 2d2d  default_file.---
│ │ │ │  0002e910: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0002e920: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ -0002e930: 7469 6f6e 3a20 636f 6e73 7420 6368 6172  tion: const char
│ │ │ │ -0002e940: 202a 2073 6869 7368 695f 7835 3039 6361   * shishi_x509ca
│ │ │ │ -0002e950: 5f64 6566 6175 6c74 5f66 696c 6520 2853  _default_file (S
│ │ │ │ -0002e960: 6869 7368 6920 2a20 4841 4e44 4c45 290a  hishi * HANDLE).
│ │ │ │ -0002e970: 2020 2020 2048 414e 444c 453a 2053 6869       HANDLE: Shi
│ │ │ │ -0002e980: 7368 6920 6c69 6272 6172 7920 6861 6e64  shi library hand
│ │ │ │ -0002e990: 6c65 2063 7265 6174 6520 6279 20e2 8098  le create by ...
│ │ │ │ -0002e9a0: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ -0002e9b0: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ -0002e9c0: 7469 6f6e 3a2a 2047 6574 2066 696c 656e  tion:* Get filen
│ │ │ │ -0002e9d0: 616d 6520 666f 7220 6465 6661 756c 7420  ame for default 
│ │ │ │ -0002e9e0: 582e 3530 3920 4341 2063 6572 7469 6669  X.509 CA certifi
│ │ │ │ -0002e9f0: 6361 7465 2e0a 0a20 2020 2020 2a52 6574  cate...     *Ret
│ │ │ │ -0002ea00: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ -0002ea10: 726e 7320 7468 6520 6465 6661 756c 7420  rns the default 
│ │ │ │ -0002ea20: 582e 3530 3920 4341 2063 6572 7469 6669  X.509 CA certifi
│ │ │ │ -0002ea30: 6361 7465 2066 696c 656e 616d 650a 2020  cate filename.  
│ │ │ │ -0002ea40: 2020 2075 7365 6420 696e 2074 6865 206c     used in the l
│ │ │ │ -0002ea50: 6962 7261 7279 2e20 2054 6865 2063 6572  ibrary.  The cer
│ │ │ │ -0002ea60: 7469 6669 6361 7465 2069 7320 7573 6564  tificate is used
│ │ │ │ -0002ea70: 2064 7572 696e 6720 544c 530a 2020 2020   during TLS.    
│ │ │ │ -0002ea80: 2063 6f6e 6e65 6374 696f 6e73 2077 6974   connections wit
│ │ │ │ -0002ea90: 6820 7468 6520 4b44 4320 746f 2061 7574  h the KDC to aut
│ │ │ │ -0002eaa0: 6865 6e74 6963 6174 6520 7468 6520 4b44  henticate the KD
│ │ │ │ -0002eab0: 432e 2054 6865 2073 7472 696e 6720 6973  C. The string is
│ │ │ │ -0002eac0: 206e 6f74 0a20 2020 2020 6120 636f 7079   not.     a copy
│ │ │ │ -0002ead0: 2c20 736f 2064 6f6e 2774 206d 6f64 6966  , so don't modif
│ │ │ │ -0002eae0: 7920 6f72 2064 6561 6c6c 6f63 6174 6520  y or deallocate 
│ │ │ │ -0002eaf0: 6974 2e0a 0a73 6869 7368 695f 7835 3039  it...shishi_x509
│ │ │ │ -0002eb00: 6365 7274 5f64 6566 6175 6c74 5f66 696c  cert_default_fil
│ │ │ │ -0002eb10: 655f 6775 6573 730a 2d2d 2d2d 2d2d 2d2d  e_guess.--------
│ │ │ │ +0002e920: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +0002e930: 6374 696f 6e3a 2063 6f6e 7374 2063 6861  ction: const cha
│ │ │ │ +0002e940: 7220 2a20 7368 6973 6869 5f78 3530 3963  r * shishi_x509c
│ │ │ │ +0002e950: 615f 6465 6661 756c 745f 6669 6c65 2028  a_default_file (
│ │ │ │ +0002e960: 5368 6973 6869 202a 2048 414e 444c 4529  Shishi * HANDLE)
│ │ │ │ +0002e970: 0a20 2020 2020 4841 4e44 4c45 3a20 5368  .     HANDLE: Sh
│ │ │ │ +0002e980: 6973 6869 206c 6962 7261 7279 2068 616e  ishi library han
│ │ │ │ +0002e990: 646c 6520 6372 6561 7465 2062 7920 e280  dle create by ..
│ │ │ │ +0002e9a0: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ +0002e9b0: 992e 0a0a 2020 2020 202a 4465 7363 7269  ....     *Descri
│ │ │ │ +0002e9c0: 7074 696f 6e3a 2a20 4765 7420 6669 6c65  ption:* Get file
│ │ │ │ +0002e9d0: 6e61 6d65 2066 6f72 2064 6566 6175 6c74  name for default
│ │ │ │ +0002e9e0: 2058 2e35 3039 2043 4120 6365 7274 6966   X.509 CA certif
│ │ │ │ +0002e9f0: 6963 6174 652e 0a0a 2020 2020 202a 5265  icate...     *Re
│ │ │ │ +0002ea00: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ +0002ea10: 7572 6e73 2074 6865 2064 6566 6175 6c74  urns the default
│ │ │ │ +0002ea20: 2058 2e35 3039 2043 4120 6365 7274 6966   X.509 CA certif
│ │ │ │ +0002ea30: 6963 6174 6520 6669 6c65 6e61 6d65 0a20  icate filename. 
│ │ │ │ +0002ea40: 2020 2020 7573 6564 2069 6e20 7468 6520      used in the 
│ │ │ │ +0002ea50: 6c69 6272 6172 792e 2020 5468 6520 6365  library.  The ce
│ │ │ │ +0002ea60: 7274 6966 6963 6174 6520 6973 2075 7365  rtificate is use
│ │ │ │ +0002ea70: 6420 6475 7269 6e67 2054 4c53 0a20 2020  d during TLS.   
│ │ │ │ +0002ea80: 2020 636f 6e6e 6563 7469 6f6e 7320 7769    connections wi
│ │ │ │ +0002ea90: 7468 2074 6865 204b 4443 2074 6f20 6175  th the KDC to au
│ │ │ │ +0002eaa0: 7468 656e 7469 6361 7465 2074 6865 204b  thenticate the K
│ │ │ │ +0002eab0: 4443 2e20 5468 6520 7374 7269 6e67 2069  DC. The string i
│ │ │ │ +0002eac0: 7320 6e6f 740a 2020 2020 2061 2063 6f70  s not.     a cop
│ │ │ │ +0002ead0: 792c 2073 6f20 646f 6e27 7420 6d6f 6469  y, so don't modi
│ │ │ │ +0002eae0: 6679 206f 7220 6465 616c 6c6f 6361 7465  fy or deallocate
│ │ │ │ +0002eaf0: 2069 742e 0a0a 7368 6973 6869 5f78 3530   it...shishi_x50
│ │ │ │ +0002eb00: 3963 6572 745f 6465 6661 756c 745f 6669  9cert_default_fi
│ │ │ │ +0002eb10: 6c65 5f67 7565 7373 0a2d 2d2d 2d2d 2d2d  le_guess.-------
│ │ │ │  0002eb20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0002eb30: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ -0002eb40: 4675 6e63 7469 6f6e 3a20 6368 6172 202a  Function: char *
│ │ │ │ -0002eb50: 2073 6869 7368 695f 7835 3039 6365 7274   shishi_x509cert
│ │ │ │ -0002eb60: 5f64 6566 6175 6c74 5f66 696c 655f 6775  _default_file_gu
│ │ │ │ -0002eb70: 6573 730a 2020 2020 2020 2020 2020 2853  ess.          (S
│ │ │ │ -0002eb80: 6869 7368 6920 2a20 4841 4e44 4c45 290a  hishi * HANDLE).
│ │ │ │ -0002eb90: 2020 2020 2048 414e 444c 453a 2053 6869       HANDLE: Shi
│ │ │ │ -0002eba0: 7368 6920 6c69 6272 6172 7920 6861 6e64  shi library hand
│ │ │ │ -0002ebb0: 6c65 2063 7265 6174 6520 6279 20e2 8098  le create by ...
│ │ │ │ -0002ebc0: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ -0002ebd0: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ -0002ebe0: 7469 6f6e 3a2a 2047 7565 7373 6573 2074  tion:* Guesses t
│ │ │ │ -0002ebf0: 6865 2064 6566 6175 6c74 2058 2e35 3039  he default X.509
│ │ │ │ -0002ec00: 2063 6c69 656e 7420 6365 7274 6966 6963   client certific
│ │ │ │ -0002ec10: 6174 650a 2020 2020 2066 696c 656e 616d  ate.     filenam
│ │ │ │ -0002ec20: 653b 2069 7420 6973 20e2 8098 484f 4d45  e; it is ...HOME
│ │ │ │ -0002ec30: e280 992f 2e73 6869 7368 692f 636c 6965  .../.shishi/clie
│ │ │ │ -0002ec40: 6e74 2e63 6572 7473 2e0a 0a20 2020 2020  nt.certs...     
│ │ │ │ -0002ec50: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ -0002ec60: 5265 7475 726e 7320 6465 6661 756c 7420  Returns default 
│ │ │ │ -0002ec70: 582e 3530 3920 636c 6965 6e74 2063 6572  X.509 client cer
│ │ │ │ -0002ec80: 7469 6669 6361 7465 2066 696c 656e 616d  tificate filenam
│ │ │ │ -0002ec90: 650a 2020 2020 2061 7320 6120 7374 7269  e.     as a stri
│ │ │ │ -0002eca0: 6e67 2074 6861 7420 6861 7320 746f 2062  ng that has to b
│ │ │ │ -0002ecb0: 6520 6465 616c 6c6f 6361 7465 6420 7769  e deallocated wi
│ │ │ │ -0002ecc0: 7468 20e2 8098 6672 6565 2829 e280 9920  th ...free()... 
│ │ │ │ -0002ecd0: 6279 2074 6865 2063 616c 6c65 722e 0a0a  by the caller...
│ │ │ │ -0002ece0: 7368 6973 6869 5f78 3530 3963 6572 745f  shishi_x509cert_
│ │ │ │ -0002ecf0: 6465 6661 756c 745f 6669 6c65 5f73 6574  default_file_set
│ │ │ │ -0002ed00: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ +0002eb30: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ +0002eb40: 2046 756e 6374 696f 6e3a 2063 6861 7220   Function: char 
│ │ │ │ +0002eb50: 2a20 7368 6973 6869 5f78 3530 3963 6572  * shishi_x509cer
│ │ │ │ +0002eb60: 745f 6465 6661 756c 745f 6669 6c65 5f67  t_default_file_g
│ │ │ │ +0002eb70: 7565 7373 0a20 2020 2020 2020 2020 2028  uess.          (
│ │ │ │ +0002eb80: 5368 6973 6869 202a 2048 414e 444c 4529  Shishi * HANDLE)
│ │ │ │ +0002eb90: 0a20 2020 2020 4841 4e44 4c45 3a20 5368  .     HANDLE: Sh
│ │ │ │ +0002eba0: 6973 6869 206c 6962 7261 7279 2068 616e  ishi library han
│ │ │ │ +0002ebb0: 646c 6520 6372 6561 7465 2062 7920 e280  dle create by ..
│ │ │ │ +0002ebc0: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ +0002ebd0: 992e 0a0a 2020 2020 202a 4465 7363 7269  ....     *Descri
│ │ │ │ +0002ebe0: 7074 696f 6e3a 2a20 4775 6573 7365 7320  ption:* Guesses 
│ │ │ │ +0002ebf0: 7468 6520 6465 6661 756c 7420 582e 3530  the default X.50
│ │ │ │ +0002ec00: 3920 636c 6965 6e74 2063 6572 7469 6669  9 client certifi
│ │ │ │ +0002ec10: 6361 7465 0a20 2020 2020 6669 6c65 6e61  cate.     filena
│ │ │ │ +0002ec20: 6d65 3b20 6974 2069 7320 e280 9848 4f4d  me; it is ...HOM
│ │ │ │ +0002ec30: 45e2 8099 2f2e 7368 6973 6869 2f63 6c69  E.../.shishi/cli
│ │ │ │ +0002ec40: 656e 742e 6365 7274 732e 0a0a 2020 2020  ent.certs...    
│ │ │ │ +0002ec50: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ +0002ec60: 2052 6574 7572 6e73 2064 6566 6175 6c74   Returns default
│ │ │ │ +0002ec70: 2058 2e35 3039 2063 6c69 656e 7420 6365   X.509 client ce
│ │ │ │ +0002ec80: 7274 6966 6963 6174 6520 6669 6c65 6e61  rtificate filena
│ │ │ │ +0002ec90: 6d65 0a20 2020 2020 6173 2061 2073 7472  me.     as a str
│ │ │ │ +0002eca0: 696e 6720 7468 6174 2068 6173 2074 6f20  ing that has to 
│ │ │ │ +0002ecb0: 6265 2064 6561 6c6c 6f63 6174 6564 2077  be deallocated w
│ │ │ │ +0002ecc0: 6974 6820 e280 9866 7265 6528 29e2 8099  ith ...free()...
│ │ │ │ +0002ecd0: 2062 7920 7468 6520 6361 6c6c 6572 2e0a   by the caller..
│ │ │ │ +0002ece0: 0a73 6869 7368 695f 7835 3039 6365 7274  .shishi_x509cert
│ │ │ │ +0002ecf0: 5f64 6566 6175 6c74 5f66 696c 655f 7365  _default_file_se
│ │ │ │ +0002ed00: 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  t.--------------
│ │ │ │  0002ed10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0002ed20: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ -0002ed30: 2076 6f69 6420 7368 6973 6869 5f78 3530   void shishi_x50
│ │ │ │ -0002ed40: 3963 6572 745f 6465 6661 756c 745f 6669  9cert_default_fi
│ │ │ │ -0002ed50: 6c65 5f73 6574 2028 5368 6973 6869 202a  le_set (Shishi *
│ │ │ │ -0002ed60: 2048 414e 444c 452c 0a20 2020 2020 2020   HANDLE,.       
│ │ │ │ -0002ed70: 2020 2063 6f6e 7374 2063 6861 7220 2a20     const char * 
│ │ │ │ -0002ed80: 5835 3039 4345 5254 4649 4c45 290a 2020  X509CERTFILE).  
│ │ │ │ -0002ed90: 2020 2048 414e 444c 453a 2053 6869 7368     HANDLE: Shish
│ │ │ │ -0002eda0: 6920 6c69 6272 6172 7920 6861 6e64 6c65  i library handle
│ │ │ │ -0002edb0: 2063 7265 6174 6520 6279 20e2 8098 7368   create by ...sh
│ │ │ │ -0002edc0: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ -0002edd0: 2020 2020 2058 3530 3943 4552 5446 494c       X509CERTFIL
│ │ │ │ -0002ede0: 453a 2073 7472 696e 6720 7769 7468 206e  E: string with n
│ │ │ │ -0002edf0: 6577 2064 6566 6175 6c74 2078 3530 3920  ew default x509 
│ │ │ │ -0002ee00: 636c 6965 6e74 2063 6572 7469 6669 6361  client certifica
│ │ │ │ -0002ee10: 7465 2066 696c 650a 2020 2020 206e 616d  te file.     nam
│ │ │ │ -0002ee20: 652c 206f 7220 4e55 4c4c 2074 6f20 7265  e, or NULL to re
│ │ │ │ -0002ee30: 7365 7420 746f 2064 6566 6175 6c74 2e0a  set to default..
│ │ │ │ -0002ee40: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -0002ee50: 6f6e 3a2a 2053 6574 2074 6865 2064 6566  on:* Set the def
│ │ │ │ -0002ee60: 6175 6c74 2058 2e35 3039 2063 6c69 656e  ault X.509 clien
│ │ │ │ -0002ee70: 7420 6365 7274 6966 6963 6174 6520 6669  t certificate fi
│ │ │ │ -0002ee80: 6c65 6e61 6d65 0a20 2020 2020 7573 6564  lename.     used
│ │ │ │ -0002ee90: 2069 6e20 7468 6520 6c69 6272 6172 792e   in the library.
│ │ │ │ -0002eea0: 2020 5468 6520 6365 7274 6966 6963 6174    The certificat
│ │ │ │ -0002eeb0: 6520 6973 2075 7365 6420 6475 7269 6e67  e is used during
│ │ │ │ -0002eec0: 2054 4c53 0a20 2020 2020 636f 6e6e 6563   TLS.     connec
│ │ │ │ -0002eed0: 7469 6f6e 7320 7769 7468 2074 6865 204b  tions with the K
│ │ │ │ -0002eee0: 4443 2074 6f20 6175 7468 656e 7469 6361  DC to authentica
│ │ │ │ -0002eef0: 7465 2074 6865 2063 6c69 656e 742e 2020  te the client.  
│ │ │ │ -0002ef00: 5468 6520 7374 7269 6e67 2069 730a 2020  The string is.  
│ │ │ │ -0002ef10: 2020 2063 6f70 6965 6420 696e 746f 2074     copied into t
│ │ │ │ -0002ef20: 6865 206c 6962 7261 7279 2c20 736f 2079  he library, so y
│ │ │ │ -0002ef30: 6f75 2063 616e 2064 6973 706f 7365 206f  ou can dispose o
│ │ │ │ -0002ef40: 6620 7468 6520 7661 7269 6162 6c65 0a20  f the variable. 
│ │ │ │ -0002ef50: 2020 2020 696d 6d65 6469 6174 656c 7920      immediately 
│ │ │ │ -0002ef60: 6166 7465 7220 6361 6c6c 696e 6720 7468  after calling th
│ │ │ │ -0002ef70: 6973 2066 756e 6374 696f 6e2e 0a0a 7368  is function...sh
│ │ │ │ -0002ef80: 6973 6869 5f78 3530 3963 6572 745f 6465  ishi_x509cert_de
│ │ │ │ -0002ef90: 6661 756c 745f 6669 6c65 0a2d 2d2d 2d2d  fault_file.-----
│ │ │ │ +0002ed20: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ +0002ed30: 3a20 766f 6964 2073 6869 7368 695f 7835  : void shishi_x5
│ │ │ │ +0002ed40: 3039 6365 7274 5f64 6566 6175 6c74 5f66  09cert_default_f
│ │ │ │ +0002ed50: 696c 655f 7365 7420 2853 6869 7368 6920  ile_set (Shishi 
│ │ │ │ +0002ed60: 2a20 4841 4e44 4c45 2c0a 2020 2020 2020  * HANDLE,.      
│ │ │ │ +0002ed70: 2020 2020 636f 6e73 7420 6368 6172 202a      const char *
│ │ │ │ +0002ed80: 2058 3530 3943 4552 5446 494c 4529 0a20   X509CERTFILE). 
│ │ │ │ +0002ed90: 2020 2020 4841 4e44 4c45 3a20 5368 6973      HANDLE: Shis
│ │ │ │ +0002eda0: 6869 206c 6962 7261 7279 2068 616e 646c  hi library handl
│ │ │ │ +0002edb0: 6520 6372 6561 7465 2062 7920 e280 9873  e create by ...s
│ │ │ │ +0002edc0: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ +0002edd0: 0a20 2020 2020 5835 3039 4345 5254 4649  .     X509CERTFI
│ │ │ │ +0002ede0: 4c45 3a20 7374 7269 6e67 2077 6974 6820  LE: string with 
│ │ │ │ +0002edf0: 6e65 7720 6465 6661 756c 7420 7835 3039  new default x509
│ │ │ │ +0002ee00: 2063 6c69 656e 7420 6365 7274 6966 6963   client certific
│ │ │ │ +0002ee10: 6174 6520 6669 6c65 0a20 2020 2020 6e61  ate file.     na
│ │ │ │ +0002ee20: 6d65 2c20 6f72 204e 554c 4c20 746f 2072  me, or NULL to r
│ │ │ │ +0002ee30: 6573 6574 2074 6f20 6465 6661 756c 742e  eset to default.
│ │ │ │ +0002ee40: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ +0002ee50: 696f 6e3a 2a20 5365 7420 7468 6520 6465  ion:* Set the de
│ │ │ │ +0002ee60: 6661 756c 7420 582e 3530 3920 636c 6965  fault X.509 clie
│ │ │ │ +0002ee70: 6e74 2063 6572 7469 6669 6361 7465 2066  nt certificate f
│ │ │ │ +0002ee80: 696c 656e 616d 650a 2020 2020 2075 7365  ilename.     use
│ │ │ │ +0002ee90: 6420 696e 2074 6865 206c 6962 7261 7279  d in the library
│ │ │ │ +0002eea0: 2e20 2054 6865 2063 6572 7469 6669 6361  .  The certifica
│ │ │ │ +0002eeb0: 7465 2069 7320 7573 6564 2064 7572 696e  te is used durin
│ │ │ │ +0002eec0: 6720 544c 530a 2020 2020 2063 6f6e 6e65  g TLS.     conne
│ │ │ │ +0002eed0: 6374 696f 6e73 2077 6974 6820 7468 6520  ctions with the 
│ │ │ │ +0002eee0: 4b44 4320 746f 2061 7574 6865 6e74 6963  KDC to authentic
│ │ │ │ +0002eef0: 6174 6520 7468 6520 636c 6965 6e74 2e20  ate the client. 
│ │ │ │ +0002ef00: 2054 6865 2073 7472 696e 6720 6973 0a20   The string is. 
│ │ │ │ +0002ef10: 2020 2020 636f 7069 6564 2069 6e74 6f20      copied into 
│ │ │ │ +0002ef20: 7468 6520 6c69 6272 6172 792c 2073 6f20  the library, so 
│ │ │ │ +0002ef30: 796f 7520 6361 6e20 6469 7370 6f73 6520  you can dispose 
│ │ │ │ +0002ef40: 6f66 2074 6865 2076 6172 6961 626c 650a  of the variable.
│ │ │ │ +0002ef50: 2020 2020 2069 6d6d 6564 6961 7465 6c79       immediately
│ │ │ │ +0002ef60: 2061 6674 6572 2063 616c 6c69 6e67 2074   after calling t
│ │ │ │ +0002ef70: 6869 7320 6675 6e63 7469 6f6e 2e0a 0a73  his function...s
│ │ │ │ +0002ef80: 6869 7368 695f 7835 3039 6365 7274 5f64  hishi_x509cert_d
│ │ │ │ +0002ef90: 6566 6175 6c74 5f66 696c 650a 2d2d 2d2d  efault_file.----
│ │ │ │  0002efa0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0002efb0: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ -0002efc0: 6374 696f 6e3a 2063 6f6e 7374 2063 6861  ction: const cha
│ │ │ │ -0002efd0: 7220 2a20 7368 6973 6869 5f78 3530 3963  r * shishi_x509c
│ │ │ │ -0002efe0: 6572 745f 6465 6661 756c 745f 6669 6c65  ert_default_file
│ │ │ │ -0002eff0: 0a20 2020 2020 2020 2020 2028 5368 6973  .          (Shis
│ │ │ │ -0002f000: 6869 202a 2048 414e 444c 4529 0a20 2020  hi * HANDLE).   
│ │ │ │ -0002f010: 2020 4841 4e44 4c45 3a20 5368 6973 6869    HANDLE: Shishi
│ │ │ │ -0002f020: 206c 6962 7261 7279 2068 616e 646c 6520   library handle 
│ │ │ │ -0002f030: 6372 6561 7465 2062 7920 e280 9873 6869  create by ...shi
│ │ │ │ -0002f040: 7368 695f 696e 6974 2829 e280 992e 0a0a  shi_init()......
│ │ │ │ -0002f050: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ -0002f060: 6e3a 2a20 4765 7420 6669 6c65 6e61 6d65  n:* Get filename
│ │ │ │ -0002f070: 2066 6f72 2064 6566 6175 6c74 2058 2e35   for default X.5
│ │ │ │ -0002f080: 3039 2063 6572 7469 6669 6361 7465 2e0a  09 certificate..
│ │ │ │ -0002f090: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ -0002f0a0: 6c75 653a 2a20 5265 7475 726e 7320 7468  lue:* Returns th
│ │ │ │ -0002f0b0: 6520 6465 6661 756c 7420 582e 3530 3920  e default X.509 
│ │ │ │ -0002f0c0: 636c 6965 6e74 2063 6572 7469 6669 6361  client certifica
│ │ │ │ -0002f0d0: 7465 0a20 2020 2020 6669 6c65 6e61 6d65  te.     filename
│ │ │ │ -0002f0e0: 2075 7365 6420 696e 2074 6865 206c 6962   used in the lib
│ │ │ │ -0002f0f0: 7261 7279 2e20 2054 6865 2063 6572 7469  rary.  The certi
│ │ │ │ -0002f100: 6669 6361 7465 2069 7320 7573 6564 2064  ficate is used d
│ │ │ │ -0002f110: 7572 696e 6720 544c 530a 2020 2020 2063  uring TLS.     c
│ │ │ │ -0002f120: 6f6e 6e65 6374 696f 6e73 2077 6974 6820  onnections with 
│ │ │ │ -0002f130: 7468 6520 4b44 4320 746f 2061 7574 6865  the KDC to authe
│ │ │ │ -0002f140: 6e74 6963 6174 6520 7468 6520 636c 6965  nticate the clie
│ │ │ │ -0002f150: 6e74 2e20 2054 6865 2073 7472 696e 6720  nt.  The string 
│ │ │ │ -0002f160: 6973 0a20 2020 2020 6e6f 7420 6120 636f  is.     not a co
│ │ │ │ -0002f170: 7079 2c20 736f 2064 6f6e 2774 206d 6f64  py, so don't mod
│ │ │ │ -0002f180: 6966 7920 6f72 2064 6561 6c6c 6f63 6174  ify or deallocat
│ │ │ │ -0002f190: 6520 6974 2e0a 0a73 6869 7368 695f 7835  e it...shishi_x5
│ │ │ │ -0002f1a0: 3039 6b65 795f 6465 6661 756c 745f 6669  09key_default_fi
│ │ │ │ -0002f1b0: 6c65 5f67 7565 7373 0a2d 2d2d 2d2d 2d2d  le_guess.-------
│ │ │ │ +0002efb0: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ +0002efc0: 6e63 7469 6f6e 3a20 636f 6e73 7420 6368  nction: const ch
│ │ │ │ +0002efd0: 6172 202a 2073 6869 7368 695f 7835 3039  ar * shishi_x509
│ │ │ │ +0002efe0: 6365 7274 5f64 6566 6175 6c74 5f66 696c  cert_default_fil
│ │ │ │ +0002eff0: 650a 2020 2020 2020 2020 2020 2853 6869  e.          (Shi
│ │ │ │ +0002f000: 7368 6920 2a20 4841 4e44 4c45 290a 2020  shi * HANDLE).  
│ │ │ │ +0002f010: 2020 2048 414e 444c 453a 2053 6869 7368     HANDLE: Shish
│ │ │ │ +0002f020: 6920 6c69 6272 6172 7920 6861 6e64 6c65  i library handle
│ │ │ │ +0002f030: 2063 7265 6174 6520 6279 20e2 8098 7368   create by ...sh
│ │ │ │ +0002f040: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ +0002f050: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +0002f060: 6f6e 3a2a 2047 6574 2066 696c 656e 616d  on:* Get filenam
│ │ │ │ +0002f070: 6520 666f 7220 6465 6661 756c 7420 582e  e for default X.
│ │ │ │ +0002f080: 3530 3920 6365 7274 6966 6963 6174 652e  509 certificate.
│ │ │ │ +0002f090: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ +0002f0a0: 616c 7565 3a2a 2052 6574 7572 6e73 2074  alue:* Returns t
│ │ │ │ +0002f0b0: 6865 2064 6566 6175 6c74 2058 2e35 3039  he default X.509
│ │ │ │ +0002f0c0: 2063 6c69 656e 7420 6365 7274 6966 6963   client certific
│ │ │ │ +0002f0d0: 6174 650a 2020 2020 2066 696c 656e 616d  ate.     filenam
│ │ │ │ +0002f0e0: 6520 7573 6564 2069 6e20 7468 6520 6c69  e used in the li
│ │ │ │ +0002f0f0: 6272 6172 792e 2020 5468 6520 6365 7274  brary.  The cert
│ │ │ │ +0002f100: 6966 6963 6174 6520 6973 2075 7365 6420  ificate is used 
│ │ │ │ +0002f110: 6475 7269 6e67 2054 4c53 0a20 2020 2020  during TLS.     
│ │ │ │ +0002f120: 636f 6e6e 6563 7469 6f6e 7320 7769 7468  connections with
│ │ │ │ +0002f130: 2074 6865 204b 4443 2074 6f20 6175 7468   the KDC to auth
│ │ │ │ +0002f140: 656e 7469 6361 7465 2074 6865 2063 6c69  enticate the cli
│ │ │ │ +0002f150: 656e 742e 2020 5468 6520 7374 7269 6e67  ent.  The string
│ │ │ │ +0002f160: 2069 730a 2020 2020 206e 6f74 2061 2063   is.     not a c
│ │ │ │ +0002f170: 6f70 792c 2073 6f20 646f 6e27 7420 6d6f  opy, so don't mo
│ │ │ │ +0002f180: 6469 6679 206f 7220 6465 616c 6c6f 6361  dify or dealloca
│ │ │ │ +0002f190: 7465 2069 742e 0a0a 7368 6973 6869 5f78  te it...shishi_x
│ │ │ │ +0002f1a0: 3530 396b 6579 5f64 6566 6175 6c74 5f66  509key_default_f
│ │ │ │ +0002f1b0: 696c 655f 6775 6573 730a 2d2d 2d2d 2d2d  ile_guess.------
│ │ │ │  0002f1c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0002f1d0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ -0002f1e0: 4675 6e63 7469 6f6e 3a20 6368 6172 202a  Function: char *
│ │ │ │ -0002f1f0: 2073 6869 7368 695f 7835 3039 6b65 795f   shishi_x509key_
│ │ │ │ -0002f200: 6465 6661 756c 745f 6669 6c65 5f67 7565  default_file_gue
│ │ │ │ -0002f210: 7373 2028 5368 6973 6869 202a 2048 414e  ss (Shishi * HAN
│ │ │ │ -0002f220: 444c 4529 0a20 2020 2020 4841 4e44 4c45  DLE).     HANDLE
│ │ │ │ -0002f230: 3a20 5368 6973 6869 206c 6962 7261 7279  : Shishi library
│ │ │ │ -0002f240: 2068 616e 646c 6520 6372 6561 7465 2062   handle create b
│ │ │ │ -0002f250: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ -0002f260: 2829 e280 992e 0a0a 2020 2020 202a 4465  ()......     *De
│ │ │ │ -0002f270: 7363 7269 7074 696f 6e3a 2a20 4775 6573  scription:* Gues
│ │ │ │ -0002f280: 7365 7320 7468 6520 6465 6661 756c 7420  ses the default 
│ │ │ │ -0002f290: 582e 3530 3920 636c 6965 6e74 206b 6579  X.509 client key
│ │ │ │ -0002f2a0: 2066 696c 656e 616d 653b 2069 7420 6973   filename; it is
│ │ │ │ -0002f2b0: 0a20 2020 2020 e280 9848 4f4d 45e2 8099  .     ...HOME...
│ │ │ │ -0002f2c0: 2f2e 7368 6973 6869 2f63 6c69 656e 742e  /.shishi/client.
│ │ │ │ -0002f2d0: 6b65 792e 0a0a 2020 2020 202a 5265 7475  key...     *Retu
│ │ │ │ -0002f2e0: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ -0002f2f0: 6e73 2064 6566 6175 6c74 2058 2e35 3039  ns default X.509
│ │ │ │ -0002f300: 2063 6c69 656e 7420 6b65 7920 6669 6c65   client key file
│ │ │ │ -0002f310: 6e61 6d65 2061 7320 610a 2020 2020 2073  name as a.     s
│ │ │ │ -0002f320: 7472 696e 6720 7468 6174 2068 6173 2074  tring that has t
│ │ │ │ -0002f330: 6f20 6265 2064 6561 6c6c 6f63 6174 6564  o be deallocated
│ │ │ │ -0002f340: 2077 6974 6820 e280 9866 7265 6528 29e2   with ...free().
│ │ │ │ -0002f350: 8099 2062 7920 7468 6520 6361 6c6c 6572  .. by the caller
│ │ │ │ -0002f360: 2e0a 0a73 6869 7368 695f 7835 3039 6b65  ...shishi_x509ke
│ │ │ │ -0002f370: 795f 6465 6661 756c 745f 6669 6c65 5f73  y_default_file_s
│ │ │ │ -0002f380: 6574 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  et.-------------
│ │ │ │ +0002f1d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ +0002f1e0: 2046 756e 6374 696f 6e3a 2063 6861 7220   Function: char 
│ │ │ │ +0002f1f0: 2a20 7368 6973 6869 5f78 3530 396b 6579  * shishi_x509key
│ │ │ │ +0002f200: 5f64 6566 6175 6c74 5f66 696c 655f 6775  _default_file_gu
│ │ │ │ +0002f210: 6573 7320 2853 6869 7368 6920 2a20 4841  ess (Shishi * HA
│ │ │ │ +0002f220: 4e44 4c45 290a 2020 2020 2048 414e 444c  NDLE).     HANDL
│ │ │ │ +0002f230: 453a 2053 6869 7368 6920 6c69 6272 6172  E: Shishi librar
│ │ │ │ +0002f240: 7920 6861 6e64 6c65 2063 7265 6174 6520  y handle create 
│ │ │ │ +0002f250: 6279 20e2 8098 7368 6973 6869 5f69 6e69  by ...shishi_ini
│ │ │ │ +0002f260: 7428 29e2 8099 2e0a 0a20 2020 2020 2a44  t()......     *D
│ │ │ │ +0002f270: 6573 6372 6970 7469 6f6e 3a2a 2047 7565  escription:* Gue
│ │ │ │ +0002f280: 7373 6573 2074 6865 2064 6566 6175 6c74  sses the default
│ │ │ │ +0002f290: 2058 2e35 3039 2063 6c69 656e 7420 6b65   X.509 client ke
│ │ │ │ +0002f2a0: 7920 6669 6c65 6e61 6d65 3b20 6974 2069  y filename; it i
│ │ │ │ +0002f2b0: 730a 2020 2020 20e2 8098 484f 4d45 e280  s.     ...HOME..
│ │ │ │ +0002f2c0: 992f 2e73 6869 7368 692f 636c 6965 6e74  ./.shishi/client
│ │ │ │ +0002f2d0: 2e6b 6579 2e0a 0a20 2020 2020 2a52 6574  .key...     *Ret
│ │ │ │ +0002f2e0: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ +0002f2f0: 726e 7320 6465 6661 756c 7420 582e 3530  rns default X.50
│ │ │ │ +0002f300: 3920 636c 6965 6e74 206b 6579 2066 696c  9 client key fil
│ │ │ │ +0002f310: 656e 616d 6520 6173 2061 0a20 2020 2020  ename as a.     
│ │ │ │ +0002f320: 7374 7269 6e67 2074 6861 7420 6861 7320  string that has 
│ │ │ │ +0002f330: 746f 2062 6520 6465 616c 6c6f 6361 7465  to be deallocate
│ │ │ │ +0002f340: 6420 7769 7468 20e2 8098 6672 6565 2829  d with ...free()
│ │ │ │ +0002f350: e280 9920 6279 2074 6865 2063 616c 6c65  ... by the calle
│ │ │ │ +0002f360: 722e 0a0a 7368 6973 6869 5f78 3530 396b  r...shishi_x509k
│ │ │ │ +0002f370: 6579 5f64 6566 6175 6c74 5f66 696c 655f  ey_default_file_
│ │ │ │ +0002f380: 7365 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  set.------------
│ │ │ │  0002f390: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0002f3a0: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ -0002f3b0: 3a20 766f 6964 2073 6869 7368 695f 7835  : void shishi_x5
│ │ │ │ -0002f3c0: 3039 6b65 795f 6465 6661 756c 745f 6669  09key_default_fi
│ │ │ │ -0002f3d0: 6c65 5f73 6574 2028 5368 6973 6869 202a  le_set (Shishi *
│ │ │ │ -0002f3e0: 2048 414e 444c 452c 0a20 2020 2020 2020   HANDLE,.       
│ │ │ │ -0002f3f0: 2020 2063 6f6e 7374 2063 6861 7220 2a20     const char * 
│ │ │ │ -0002f400: 5835 3039 4b45 5946 494c 4529 0a20 2020  X509KEYFILE).   
│ │ │ │ -0002f410: 2020 4841 4e44 4c45 3a20 5368 6973 6869    HANDLE: Shishi
│ │ │ │ -0002f420: 206c 6962 7261 7279 2068 616e 646c 6520   library handle 
│ │ │ │ -0002f430: 6372 6561 7465 2062 7920 e280 9873 6869  create by ...shi
│ │ │ │ -0002f440: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ -0002f450: 2020 2020 5835 3039 4b45 5946 494c 453a      X509KEYFILE:
│ │ │ │ -0002f460: 2073 7472 696e 6720 7769 7468 206e 6577   string with new
│ │ │ │ -0002f470: 2064 6566 6175 6c74 2078 3530 3920 636c   default x509 cl
│ │ │ │ -0002f480: 6965 6e74 206b 6579 2066 696c 6520 6e61  ient key file na
│ │ │ │ -0002f490: 6d65 2c20 6f72 0a20 2020 2020 4e55 4c4c  me, or.     NULL
│ │ │ │ -0002f4a0: 2074 6f20 7265 7365 7420 746f 2064 6566   to reset to def
│ │ │ │ -0002f4b0: 6175 6c74 2e0a 0a20 2020 2020 2a44 6573  ault...     *Des
│ │ │ │ -0002f4c0: 6372 6970 7469 6f6e 3a2a 2053 6574 2074  cription:* Set t
│ │ │ │ -0002f4d0: 6865 2064 6566 6175 6c74 2058 2e35 3039  he default X.509
│ │ │ │ -0002f4e0: 2063 6c69 656e 7420 6b65 7920 6669 6c65   client key file
│ │ │ │ -0002f4f0: 6e61 6d65 2075 7365 6420 696e 0a20 2020  name used in.   
│ │ │ │ -0002f500: 2020 7468 6520 6c69 6272 6172 792e 2020    the library.  
│ │ │ │ -0002f510: 5468 6520 6b65 7920 6973 2075 7365 6420  The key is used 
│ │ │ │ -0002f520: 6475 7269 6e67 2054 4c53 2063 6f6e 6e65  during TLS conne
│ │ │ │ -0002f530: 6374 696f 6e73 2077 6974 6820 7468 6520  ctions with the 
│ │ │ │ -0002f540: 4b44 430a 2020 2020 2074 6f20 6175 7468  KDC.     to auth
│ │ │ │ -0002f550: 656e 7469 6361 7465 2074 6865 2063 6c69  enticate the cli
│ │ │ │ -0002f560: 656e 742e 2020 5468 6520 7374 7269 6e67  ent.  The string
│ │ │ │ -0002f570: 2069 7320 636f 7069 6564 2069 6e74 6f20   is copied into 
│ │ │ │ -0002f580: 7468 6520 6c69 6272 6172 792c 0a20 2020  the library,.   
│ │ │ │ -0002f590: 2020 736f 2079 6f75 2063 616e 2064 6973    so you can dis
│ │ │ │ -0002f5a0: 706f 7365 206f 6620 7468 6520 7661 7269  pose of the vari
│ │ │ │ -0002f5b0: 6162 6c65 2069 6d6d 6564 6961 7465 6c79  able immediately
│ │ │ │ -0002f5c0: 2061 6674 6572 2063 616c 6c69 6e67 2074   after calling t
│ │ │ │ -0002f5d0: 6869 730a 2020 2020 2066 756e 6374 696f  his.     functio
│ │ │ │ -0002f5e0: 6e2e 0a0a 7368 6973 6869 5f78 3530 396b  n...shishi_x509k
│ │ │ │ -0002f5f0: 6579 5f64 6566 6175 6c74 5f66 696c 650a  ey_default_file.
│ │ │ │ -0002f600: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0002f610: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ -0002f620: 2046 756e 6374 696f 6e3a 2063 6f6e 7374   Function: const
│ │ │ │ -0002f630: 2063 6861 7220 2a20 7368 6973 6869 5f78   char * shishi_x
│ │ │ │ -0002f640: 3530 396b 6579 5f64 6566 6175 6c74 5f66  509key_default_f
│ │ │ │ -0002f650: 696c 6520 2853 6869 7368 6920 2a20 4841  ile (Shishi * HA
│ │ │ │ -0002f660: 4e44 4c45 290a 2020 2020 2048 414e 444c  NDLE).     HANDL
│ │ │ │ -0002f670: 453a 2053 6869 7368 6920 6c69 6272 6172  E: Shishi librar
│ │ │ │ -0002f680: 7920 6861 6e64 6c65 2063 7265 6174 6520  y handle create 
│ │ │ │ -0002f690: 6279 20e2 8098 7368 6973 6869 5f69 6e69  by ...shishi_ini
│ │ │ │ -0002f6a0: 7428 29e2 8099 2e0a 0a20 2020 2020 2a44  t()......     *D
│ │ │ │ -0002f6b0: 6573 6372 6970 7469 6f6e 3a2a 2047 6574  escription:* Get
│ │ │ │ -0002f6c0: 2066 696c 656e 616d 6520 666f 7220 6465   filename for de
│ │ │ │ -0002f6d0: 6661 756c 7420 582e 3530 3920 6b65 792e  fault X.509 key.
│ │ │ │ -0002f6e0: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ -0002f6f0: 616c 7565 3a2a 2052 6574 7572 6e73 2074  alue:* Returns t
│ │ │ │ -0002f700: 6865 2064 6566 6175 6c74 2058 2e35 3039  he default X.509
│ │ │ │ -0002f710: 2063 6c69 656e 7420 6b65 7920 6669 6c65   client key file
│ │ │ │ -0002f720: 6e61 6d65 2075 7365 640a 2020 2020 2069  name used.     i
│ │ │ │ -0002f730: 6e20 7468 6520 6c69 6272 6172 792e 2020  n the library.  
│ │ │ │ -0002f740: 5468 6520 6b65 7920 6973 2075 7365 6420  The key is used 
│ │ │ │ -0002f750: 6475 7269 6e67 2054 4c53 2063 6f6e 6e65  during TLS conne
│ │ │ │ -0002f760: 6374 696f 6e73 2077 6974 6820 7468 650a  ctions with the.
│ │ │ │ -0002f770: 2020 2020 204b 4443 2074 6f20 6175 7468       KDC to auth
│ │ │ │ -0002f780: 656e 7469 6361 7465 2074 6865 2063 6c69  enticate the cli
│ │ │ │ -0002f790: 656e 742e 2020 5468 6520 7374 7269 6e67  ent.  The string
│ │ │ │ -0002f7a0: 2069 7320 6e6f 7420 6120 636f 7079 2c20   is not a copy, 
│ │ │ │ -0002f7b0: 736f 2064 6f6e 2774 0a20 2020 2020 6d6f  so don't.     mo
│ │ │ │ -0002f7c0: 6469 6679 206f 7220 6465 616c 6c6f 6361  dify or dealloca
│ │ │ │ -0002f7d0: 7465 2069 742e 0a0a 1f0a 4669 6c65 3a20  te it.....File: 
│ │ │ │ -0002f7e0: 7368 6973 6869 2e69 6e66 6f2c 2020 4e6f  shishi.info,  No
│ │ │ │ -0002f7f0: 6465 3a20 5574 696c 6974 7920 4675 6e63  de: Utility Func
│ │ │ │ -0002f800: 7469 6f6e 732c 2020 4e65 7874 3a20 4153  tions,  Next: AS
│ │ │ │ -0002f810: 4e2e 3120 4675 6e63 7469 6f6e 732c 2020  N.1 Functions,  
│ │ │ │ -0002f820: 5072 6576 3a20 582e 3530 3920 4675 6e63  Prev: X.509 Func
│ │ │ │ -0002f830: 7469 6f6e 732c 2020 5570 3a20 5072 6f67  tions,  Up: Prog
│ │ │ │ -0002f840: 7261 6d6d 696e 6720 4d61 6e75 616c 0a0a  ramming Manual..
│ │ │ │ -0002f850: 352e 3135 2055 7469 6c69 7479 2046 756e  5.15 Utility Fun
│ │ │ │ -0002f860: 6374 696f 6e73 0a3d 3d3d 3d3d 3d3d 3d3d  ctions.=========
│ │ │ │ -0002f870: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a73  =============..s
│ │ │ │ -0002f880: 6869 7368 695f 7265 616c 6d5f 6465 6661  hishi_realm_defa
│ │ │ │ -0002f890: 756c 745f 6775 6573 730a 2d2d 2d2d 2d2d  ult_guess.------
│ │ │ │ +0002f3a0: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ +0002f3b0: 6e3a 2076 6f69 6420 7368 6973 6869 5f78  n: void shishi_x
│ │ │ │ +0002f3c0: 3530 396b 6579 5f64 6566 6175 6c74 5f66  509key_default_f
│ │ │ │ +0002f3d0: 696c 655f 7365 7420 2853 6869 7368 6920  ile_set (Shishi 
│ │ │ │ +0002f3e0: 2a20 4841 4e44 4c45 2c0a 2020 2020 2020  * HANDLE,.      
│ │ │ │ +0002f3f0: 2020 2020 636f 6e73 7420 6368 6172 202a      const char *
│ │ │ │ +0002f400: 2058 3530 394b 4559 4649 4c45 290a 2020   X509KEYFILE).  
│ │ │ │ +0002f410: 2020 2048 414e 444c 453a 2053 6869 7368     HANDLE: Shish
│ │ │ │ +0002f420: 6920 6c69 6272 6172 7920 6861 6e64 6c65  i library handle
│ │ │ │ +0002f430: 2063 7265 6174 6520 6279 20e2 8098 7368   create by ...sh
│ │ │ │ +0002f440: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ +0002f450: 2020 2020 2058 3530 394b 4559 4649 4c45       X509KEYFILE
│ │ │ │ +0002f460: 3a20 7374 7269 6e67 2077 6974 6820 6e65  : string with ne
│ │ │ │ +0002f470: 7720 6465 6661 756c 7420 7835 3039 2063  w default x509 c
│ │ │ │ +0002f480: 6c69 656e 7420 6b65 7920 6669 6c65 206e  lient key file n
│ │ │ │ +0002f490: 616d 652c 206f 720a 2020 2020 204e 554c  ame, or.     NUL
│ │ │ │ +0002f4a0: 4c20 746f 2072 6573 6574 2074 6f20 6465  L to reset to de
│ │ │ │ +0002f4b0: 6661 756c 742e 0a0a 2020 2020 202a 4465  fault...     *De
│ │ │ │ +0002f4c0: 7363 7269 7074 696f 6e3a 2a20 5365 7420  scription:* Set 
│ │ │ │ +0002f4d0: 7468 6520 6465 6661 756c 7420 582e 3530  the default X.50
│ │ │ │ +0002f4e0: 3920 636c 6965 6e74 206b 6579 2066 696c  9 client key fil
│ │ │ │ +0002f4f0: 656e 616d 6520 7573 6564 2069 6e0a 2020  ename used in.  
│ │ │ │ +0002f500: 2020 2074 6865 206c 6962 7261 7279 2e20     the library. 
│ │ │ │ +0002f510: 2054 6865 206b 6579 2069 7320 7573 6564   The key is used
│ │ │ │ +0002f520: 2064 7572 696e 6720 544c 5320 636f 6e6e   during TLS conn
│ │ │ │ +0002f530: 6563 7469 6f6e 7320 7769 7468 2074 6865  ections with the
│ │ │ │ +0002f540: 204b 4443 0a20 2020 2020 746f 2061 7574   KDC.     to aut
│ │ │ │ +0002f550: 6865 6e74 6963 6174 6520 7468 6520 636c  henticate the cl
│ │ │ │ +0002f560: 6965 6e74 2e20 2054 6865 2073 7472 696e  ient.  The strin
│ │ │ │ +0002f570: 6720 6973 2063 6f70 6965 6420 696e 746f  g is copied into
│ │ │ │ +0002f580: 2074 6865 206c 6962 7261 7279 2c0a 2020   the library,.  
│ │ │ │ +0002f590: 2020 2073 6f20 796f 7520 6361 6e20 6469     so you can di
│ │ │ │ +0002f5a0: 7370 6f73 6520 6f66 2074 6865 2076 6172  spose of the var
│ │ │ │ +0002f5b0: 6961 626c 6520 696d 6d65 6469 6174 656c  iable immediatel
│ │ │ │ +0002f5c0: 7920 6166 7465 7220 6361 6c6c 696e 6720  y after calling 
│ │ │ │ +0002f5d0: 7468 6973 0a20 2020 2020 6675 6e63 7469  this.     functi
│ │ │ │ +0002f5e0: 6f6e 2e0a 0a73 6869 7368 695f 7835 3039  on...shishi_x509
│ │ │ │ +0002f5f0: 6b65 795f 6465 6661 756c 745f 6669 6c65  key_default_file
│ │ │ │ +0002f600: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ +0002f610: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ +0002f620: 2d20 4675 6e63 7469 6f6e 3a20 636f 6e73  - Function: cons
│ │ │ │ +0002f630: 7420 6368 6172 202a 2073 6869 7368 695f  t char * shishi_
│ │ │ │ +0002f640: 7835 3039 6b65 795f 6465 6661 756c 745f  x509key_default_
│ │ │ │ +0002f650: 6669 6c65 2028 5368 6973 6869 202a 2048  file (Shishi * H
│ │ │ │ +0002f660: 414e 444c 4529 0a20 2020 2020 4841 4e44  ANDLE).     HAND
│ │ │ │ +0002f670: 4c45 3a20 5368 6973 6869 206c 6962 7261  LE: Shishi libra
│ │ │ │ +0002f680: 7279 2068 616e 646c 6520 6372 6561 7465  ry handle create
│ │ │ │ +0002f690: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ +0002f6a0: 6974 2829 e280 992e 0a0a 2020 2020 202a  it()......     *
│ │ │ │ +0002f6b0: 4465 7363 7269 7074 696f 6e3a 2a20 4765  Description:* Ge
│ │ │ │ +0002f6c0: 7420 6669 6c65 6e61 6d65 2066 6f72 2064  t filename for d
│ │ │ │ +0002f6d0: 6566 6175 6c74 2058 2e35 3039 206b 6579  efault X.509 key
│ │ │ │ +0002f6e0: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ +0002f6f0: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ +0002f700: 7468 6520 6465 6661 756c 7420 582e 3530  the default X.50
│ │ │ │ +0002f710: 3920 636c 6965 6e74 206b 6579 2066 696c  9 client key fil
│ │ │ │ +0002f720: 656e 616d 6520 7573 6564 0a20 2020 2020  ename used.     
│ │ │ │ +0002f730: 696e 2074 6865 206c 6962 7261 7279 2e20  in the library. 
│ │ │ │ +0002f740: 2054 6865 206b 6579 2069 7320 7573 6564   The key is used
│ │ │ │ +0002f750: 2064 7572 696e 6720 544c 5320 636f 6e6e   during TLS conn
│ │ │ │ +0002f760: 6563 7469 6f6e 7320 7769 7468 2074 6865  ections with the
│ │ │ │ +0002f770: 0a20 2020 2020 4b44 4320 746f 2061 7574  .     KDC to aut
│ │ │ │ +0002f780: 6865 6e74 6963 6174 6520 7468 6520 636c  henticate the cl
│ │ │ │ +0002f790: 6965 6e74 2e20 2054 6865 2073 7472 696e  ient.  The strin
│ │ │ │ +0002f7a0: 6720 6973 206e 6f74 2061 2063 6f70 792c  g is not a copy,
│ │ │ │ +0002f7b0: 2073 6f20 646f 6e27 740a 2020 2020 206d   so don't.     m
│ │ │ │ +0002f7c0: 6f64 6966 7920 6f72 2064 6561 6c6c 6f63  odify or dealloc
│ │ │ │ +0002f7d0: 6174 6520 6974 2e0a 0a1f 0a46 696c 653a  ate it.....File:
│ │ │ │ +0002f7e0: 2073 6869 7368 692e 696e 666f 2c20 204e   shishi.info,  N
│ │ │ │ +0002f7f0: 6f64 653a 2055 7469 6c69 7479 2046 756e  ode: Utility Fun
│ │ │ │ +0002f800: 6374 696f 6e73 2c20 204e 6578 743a 2041  ctions,  Next: A
│ │ │ │ +0002f810: 534e 2e31 2046 756e 6374 696f 6e73 2c20  SN.1 Functions, 
│ │ │ │ +0002f820: 2050 7265 763a 2058 2e35 3039 2046 756e   Prev: X.509 Fun
│ │ │ │ +0002f830: 6374 696f 6e73 2c20 2055 703a 2050 726f  ctions,  Up: Pro
│ │ │ │ +0002f840: 6772 616d 6d69 6e67 204d 616e 7561 6c0a  gramming Manual.
│ │ │ │ +0002f850: 0a35 2e31 3520 5574 696c 6974 7920 4675  .5.15 Utility Fu
│ │ │ │ +0002f860: 6e63 7469 6f6e 730a 3d3d 3d3d 3d3d 3d3d  nctions.========
│ │ │ │ +0002f870: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a  ==============..
│ │ │ │ +0002f880: 7368 6973 6869 5f72 6561 6c6d 5f64 6566  shishi_realm_def
│ │ │ │ +0002f890: 6175 6c74 5f67 7565 7373 0a2d 2d2d 2d2d  ault_guess.-----
│ │ │ │  0002f8a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0002f8b0: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -0002f8c0: 6f6e 3a20 6368 6172 202a 2073 6869 7368  on: char * shish
│ │ │ │ -0002f8d0: 695f 7265 616c 6d5f 6465 6661 756c 745f  i_realm_default_
│ │ │ │ -0002f8e0: 6775 6573 7320 2829 0a0a 2020 2020 202a  guess ()..     *
│ │ │ │ -0002f8f0: 4465 7363 7269 7074 696f 6e3a 2a20 4775  Description:* Gu
│ │ │ │ -0002f900: 6573 7365 7320 6120 7265 616c 6d20 6261  esses a realm ba
│ │ │ │ -0002f910: 7365 6420 6f6e 20e2 8098 6765 7464 6f6d  sed on ...getdom
│ │ │ │ -0002f920: 6169 6e6e 616d 6528 29e2 8099 2c20 7768  ainname()..., wh
│ │ │ │ -0002f930: 6963 680a 2020 2020 2072 6561 6c6c 7920  ich.     really 
│ │ │ │ -0002f940: 7265 7370 6f6e 6473 2077 6974 6820 6120  responds with a 
│ │ │ │ -0002f950: 4e49 532f 5950 2064 6f6d 6169 6e2c 2062  NIS/YP domain, b
│ │ │ │ -0002f960: 7574 2069 6620 7365 7420 7072 6f70 6572  ut if set proper
│ │ │ │ -0002f970: 6c79 2c20 6974 206d 6967 6874 0a20 2020  ly, it might.   
│ │ │ │ -0002f980: 2020 6265 2061 2067 6f6f 6420 6669 7273    be a good firs
│ │ │ │ -0002f990: 7420 6775 6573 732e 2020 4966 2074 6869  t guess.  If thi
│ │ │ │ -0002f9a0: 7320 4e49 5320 7175 6572 7920 6661 696c  s NIS query fail
│ │ │ │ -0002f9b0: 732c 2063 616c 6c0a 2020 2020 20e2 8098  s, call.     ...
│ │ │ │ -0002f9c0: 6765 7468 6f73 746e 616d 6528 29e2 8099  gethostname()...
│ │ │ │ -0002f9d0: 2c20 616e 6420 6f6e 2069 7473 2066 6169  , and on its fai
│ │ │ │ -0002f9e0: 6c75 7265 2c20 6661 6c6c 2062 6163 6b20  lure, fall back 
│ │ │ │ -0002f9f0: 746f 2072 6574 7572 6e69 6e67 2074 6865  to returning the
│ │ │ │ -0002fa00: 0a20 2020 2020 6172 7469 6669 6369 616c  .     artificial
│ │ │ │ -0002fa10: 2073 7472 696e 6720 2263 6f75 6c64 2d6e   string "could-n
│ │ │ │ -0002fa20: 6f74 2d67 7565 7373 2d64 6566 6175 6c74  ot-guess-default
│ │ │ │ -0002fa30: 2d72 6561 6c6d 222e 0a0a 2020 2020 204e  -realm"...     N
│ │ │ │ -0002fa40: 6f74 6520 7468 6174 2074 6865 2068 6f73  ote that the hos
│ │ │ │ -0002fa50: 746e 616d 6520 6973 206e 6f74 2074 7269  tname is not tri
│ │ │ │ -0002fa60: 6d6d 6564 206f 6666 206f 6620 7468 6520  mmed off of the 
│ │ │ │ -0002fa70: 7374 7269 6e67 2072 6574 7572 6e65 6420  string returned 
│ │ │ │ -0002fa80: 6279 0a20 2020 2020 e280 9867 6574 686f  by.     ...getho
│ │ │ │ -0002fa90: 7374 6e61 6d65 2829 e280 992c 2074 6875  stname()..., thu
│ │ │ │ -0002faa0: 7320 7072 6574 656e 6469 6e67 2074 6865  s pretending the
│ │ │ │ -0002fab0: 206c 6f63 616c 2068 6f73 7420 6e61 6d65   local host name
│ │ │ │ -0002fac0: 2069 7320 6120 7661 6c69 640a 2020 2020   is a valid.    
│ │ │ │ -0002fad0: 2072 6561 6c6d 206e 616d 652e 2020 5468   realm name.  Th
│ │ │ │ -0002fae0: 6520 7265 7375 6c74 696e 6720 636f 726e  e resulting corn
│ │ │ │ -0002faf0: 6572 2063 6173 6520 636f 756c 6420 6d65  er case could me
│ │ │ │ -0002fb00: 7269 7420 6120 6368 6563 6b20 7468 6174  rit a check that
│ │ │ │ -0002fb10: 2074 6865 0a20 2020 2020 7375 6767 6573   the.     sugges
│ │ │ │ -0002fb20: 7465 6420 7265 616c 6d20 6973 2064 6973  ted realm is dis
│ │ │ │ -0002fb30: 7469 6e63 7420 6672 6f6d 2074 6865 2066  tinct from the f
│ │ │ │ -0002fb40: 756c 6c79 2071 7561 6c69 6669 6573 2068  ully qualifies h
│ │ │ │ -0002fb50: 6f73 742c 2061 6e64 2069 660a 2020 2020  ost, and if.    
│ │ │ │ -0002fb60: 206e 6f74 2c20 7369 6d70 6c79 2073 7472   not, simply str
│ │ │ │ -0002fb70: 6970 2074 6865 2068 6f73 7420 6e61 6d65  ip the host name
│ │ │ │ -0002fb80: 2066 726f 6d20 7468 6520 7265 7475 726e   from the return
│ │ │ │ -0002fb90: 6564 2073 7472 696e 6720 6265 666f 7265  ed string before
│ │ │ │ -0002fba0: 2069 740a 2020 2020 2069 7320 7573 6564   it.     is used
│ │ │ │ -0002fbb0: 2069 6e20 616e 2061 7070 6c69 6361 7469   in an applicati
│ │ │ │ -0002fbc0: 6f6e 2e20 204f 6e65 2072 6561 736f 6e20  on.  One reason 
│ │ │ │ -0002fbd0: 666f 7220 7374 6963 6b69 6e67 2077 6974  for sticking wit
│ │ │ │ -0002fbe0: 6820 7468 650a 2020 2020 2070 7265 7365  h the.     prese
│ │ │ │ -0002fbf0: 6e74 2062 6568 6176 696f 7572 2c20 6973  nt behaviour, is
│ │ │ │ -0002fc00: 2074 6861 7420 736f 6d65 2073 7973 7465   that some syste
│ │ │ │ -0002fc10: 6d73 2072 6573 706f 6e64 2077 6974 6820  ms respond with 
│ │ │ │ -0002fc20: 610a 2020 2020 206e 6f6e 2d71 7561 6c69  a.     non-quali
│ │ │ │ -0002fc30: 6669 6564 2068 6f73 7420 6e61 6d65 2061  fied host name a
│ │ │ │ -0002fc40: 7320 7265 706c 7920 6672 6f6d 20e2 8098  s reply from ...
│ │ │ │ -0002fc50: 6765 7468 6f73 746e 616d 6528 29e2 8099  gethostname()...
│ │ │ │ -0002fc60: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ -0002fc70: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ -0002fc80: 6120 6775 6573 7365 6420 7265 616c 6d20  a guessed realm 
│ │ │ │ -0002fc90: 666f 7220 7468 6520 7275 6e6e 696e 6720  for the running 
│ │ │ │ -0002fca0: 686f 7374 2c0a 2020 2020 2063 6f6e 7461  host,.     conta
│ │ │ │ -0002fcb0: 696e 696e 6720 6120 7374 7269 6e67 2074  ining a string t
│ │ │ │ -0002fcc0: 6861 7420 6861 7320 746f 2062 6520 6465  hat has to be de
│ │ │ │ -0002fcd0: 616c 6c6f 6361 7465 6420 7769 7468 20e2  allocated with .
│ │ │ │ -0002fce0: 8098 6672 6565 2829 e280 9920 6279 2074  ..free()... by t
│ │ │ │ -0002fcf0: 6865 0a20 2020 2020 6361 6c6c 6572 2e0a  he.     caller..
│ │ │ │ -0002fd00: 0a73 6869 7368 695f 7265 616c 6d5f 6465  .shishi_realm_de
│ │ │ │ -0002fd10: 6661 756c 740a 2d2d 2d2d 2d2d 2d2d 2d2d  fault.----------
│ │ │ │ -0002fd20: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ -0002fd30: 4675 6e63 7469 6f6e 3a20 636f 6e73 7420  Function: const 
│ │ │ │ -0002fd40: 6368 6172 202a 2073 6869 7368 695f 7265  char * shishi_re
│ │ │ │ -0002fd50: 616c 6d5f 6465 6661 756c 7420 2853 6869  alm_default (Shi
│ │ │ │ -0002fd60: 7368 6920 2a20 4841 4e44 4c45 290a 2020  shi * HANDLE).  
│ │ │ │ -0002fd70: 2020 2048 414e 444c 453a 2053 6869 7368     HANDLE: Shish
│ │ │ │ -0002fd80: 6920 6c69 6272 6172 7920 6861 6e64 6c65  i library handle
│ │ │ │ -0002fd90: 2063 7265 6174 6564 2062 7920 e280 9873   created by ...s
│ │ │ │ -0002fda0: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ -0002fdb0: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ -0002fdc0: 696f 6e3a 2a20 4465 7465 726d 696e 6573  ion:* Determines
│ │ │ │ -0002fdd0: 206e 616d 6520 6f66 2064 6566 6175 6c74   name of default
│ │ │ │ -0002fde0: 2072 6561 6c6d 2c20 692e 652e 2c20 7468   realm, i.e., th
│ │ │ │ -0002fdf0: 6520 6e61 6d65 206f 660a 2020 2020 2077  e name of.     w
│ │ │ │ -0002fe00: 6861 7465 7665 7220 7265 616c 6d20 7468  hatever realm th
│ │ │ │ -0002fe10: 6520 6c69 6272 6172 7920 7769 6c6c 2075  e library will u
│ │ │ │ -0002fe20: 7365 2077 6865 6e65 7665 7220 616e 2065  se whenever an e
│ │ │ │ -0002fe30: 7870 6c69 6369 7420 7265 616c 6d20 6973  xplicit realm is
│ │ │ │ -0002fe40: 0a20 2020 2020 6e6f 7420 7374 6174 6564  .     not stated
│ │ │ │ -0002fe50: 2064 7572 696e 6720 6120 6c69 6272 6172   during a librar
│ │ │ │ -0002fe60: 7920 6361 6c6c 2e0a 0a20 2020 2020 2a52  y call...     *R
│ │ │ │ -0002fe70: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ -0002fe80: 7475 726e 7320 7468 6520 6465 6661 756c  turns the defaul
│ │ │ │ -0002fe90: 7420 7265 616c 6d20 696e 2075 7365 2062  t realm in use b
│ │ │ │ -0002fea0: 7920 7468 6520 6c69 6272 6172 792e 0a20  y the library.. 
│ │ │ │ -0002feb0: 2020 2020 4e6f 7420 6120 636f 7079 2c20      Not a copy, 
│ │ │ │ -0002fec0: 736f 2064 6f20 6e6f 7420 6d6f 6469 6679  so do not modify
│ │ │ │ -0002fed0: 206f 7220 6465 616c 6c6f 6361 7465 2074   or deallocate t
│ │ │ │ -0002fee0: 6865 2072 6574 7572 6e65 6420 7374 7269  he returned stri
│ │ │ │ -0002fef0: 6e67 2e0a 0a73 6869 7368 695f 7265 616c  ng...shishi_real
│ │ │ │ -0002ff00: 6d5f 6465 6661 756c 745f 7365 740a 2d2d  m_default_set.--
│ │ │ │ +0002f8b0: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +0002f8c0: 696f 6e3a 2063 6861 7220 2a20 7368 6973  ion: char * shis
│ │ │ │ +0002f8d0: 6869 5f72 6561 6c6d 5f64 6566 6175 6c74  hi_realm_default
│ │ │ │ +0002f8e0: 5f67 7565 7373 2028 290a 0a20 2020 2020  _guess ()..     
│ │ │ │ +0002f8f0: 2a44 6573 6372 6970 7469 6f6e 3a2a 2047  *Description:* G
│ │ │ │ +0002f900: 7565 7373 6573 2061 2072 6561 6c6d 2062  uesses a realm b
│ │ │ │ +0002f910: 6173 6564 206f 6e20 e280 9867 6574 646f  ased on ...getdo
│ │ │ │ +0002f920: 6d61 696e 6e61 6d65 2829 e280 992c 2077  mainname()..., w
│ │ │ │ +0002f930: 6869 6368 0a20 2020 2020 7265 616c 6c79  hich.     really
│ │ │ │ +0002f940: 2072 6573 706f 6e64 7320 7769 7468 2061   responds with a
│ │ │ │ +0002f950: 204e 4953 2f59 5020 646f 6d61 696e 2c20   NIS/YP domain, 
│ │ │ │ +0002f960: 6275 7420 6966 2073 6574 2070 726f 7065  but if set prope
│ │ │ │ +0002f970: 726c 792c 2069 7420 6d69 6768 740a 2020  rly, it might.  
│ │ │ │ +0002f980: 2020 2062 6520 6120 676f 6f64 2066 6972     be a good fir
│ │ │ │ +0002f990: 7374 2067 7565 7373 2e20 2049 6620 7468  st guess.  If th
│ │ │ │ +0002f9a0: 6973 204e 4953 2071 7565 7279 2066 6169  is NIS query fai
│ │ │ │ +0002f9b0: 6c73 2c20 6361 6c6c 0a20 2020 2020 e280  ls, call.     ..
│ │ │ │ +0002f9c0: 9867 6574 686f 7374 6e61 6d65 2829 e280  .gethostname()..
│ │ │ │ +0002f9d0: 992c 2061 6e64 206f 6e20 6974 7320 6661  ., and on its fa
│ │ │ │ +0002f9e0: 696c 7572 652c 2066 616c 6c20 6261 636b  ilure, fall back
│ │ │ │ +0002f9f0: 2074 6f20 7265 7475 726e 696e 6720 7468   to returning th
│ │ │ │ +0002fa00: 650a 2020 2020 2061 7274 6966 6963 6961  e.     artificia
│ │ │ │ +0002fa10: 6c20 7374 7269 6e67 2022 636f 756c 642d  l string "could-
│ │ │ │ +0002fa20: 6e6f 742d 6775 6573 732d 6465 6661 756c  not-guess-defaul
│ │ │ │ +0002fa30: 742d 7265 616c 6d22 2e0a 0a20 2020 2020  t-realm"...     
│ │ │ │ +0002fa40: 4e6f 7465 2074 6861 7420 7468 6520 686f  Note that the ho
│ │ │ │ +0002fa50: 7374 6e61 6d65 2069 7320 6e6f 7420 7472  stname is not tr
│ │ │ │ +0002fa60: 696d 6d65 6420 6f66 6620 6f66 2074 6865  immed off of the
│ │ │ │ +0002fa70: 2073 7472 696e 6720 7265 7475 726e 6564   string returned
│ │ │ │ +0002fa80: 2062 790a 2020 2020 20e2 8098 6765 7468   by.     ...geth
│ │ │ │ +0002fa90: 6f73 746e 616d 6528 29e2 8099 2c20 7468  ostname()..., th
│ │ │ │ +0002faa0: 7573 2070 7265 7465 6e64 696e 6720 7468  us pretending th
│ │ │ │ +0002fab0: 6520 6c6f 6361 6c20 686f 7374 206e 616d  e local host nam
│ │ │ │ +0002fac0: 6520 6973 2061 2076 616c 6964 0a20 2020  e is a valid.   
│ │ │ │ +0002fad0: 2020 7265 616c 6d20 6e61 6d65 2e20 2054    realm name.  T
│ │ │ │ +0002fae0: 6865 2072 6573 756c 7469 6e67 2063 6f72  he resulting cor
│ │ │ │ +0002faf0: 6e65 7220 6361 7365 2063 6f75 6c64 206d  ner case could m
│ │ │ │ +0002fb00: 6572 6974 2061 2063 6865 636b 2074 6861  erit a check tha
│ │ │ │ +0002fb10: 7420 7468 650a 2020 2020 2073 7567 6765  t the.     sugge
│ │ │ │ +0002fb20: 7374 6564 2072 6561 6c6d 2069 7320 6469  sted realm is di
│ │ │ │ +0002fb30: 7374 696e 6374 2066 726f 6d20 7468 6520  stinct from the 
│ │ │ │ +0002fb40: 6675 6c6c 7920 7175 616c 6966 6965 7320  fully qualifies 
│ │ │ │ +0002fb50: 686f 7374 2c20 616e 6420 6966 0a20 2020  host, and if.   
│ │ │ │ +0002fb60: 2020 6e6f 742c 2073 696d 706c 7920 7374    not, simply st
│ │ │ │ +0002fb70: 7269 7020 7468 6520 686f 7374 206e 616d  rip the host nam
│ │ │ │ +0002fb80: 6520 6672 6f6d 2074 6865 2072 6574 7572  e from the retur
│ │ │ │ +0002fb90: 6e65 6420 7374 7269 6e67 2062 6566 6f72  ned string befor
│ │ │ │ +0002fba0: 6520 6974 0a20 2020 2020 6973 2075 7365  e it.     is use
│ │ │ │ +0002fbb0: 6420 696e 2061 6e20 6170 706c 6963 6174  d in an applicat
│ │ │ │ +0002fbc0: 696f 6e2e 2020 4f6e 6520 7265 6173 6f6e  ion.  One reason
│ │ │ │ +0002fbd0: 2066 6f72 2073 7469 636b 696e 6720 7769   for sticking wi
│ │ │ │ +0002fbe0: 7468 2074 6865 0a20 2020 2020 7072 6573  th the.     pres
│ │ │ │ +0002fbf0: 656e 7420 6265 6861 7669 6f75 722c 2069  ent behaviour, i
│ │ │ │ +0002fc00: 7320 7468 6174 2073 6f6d 6520 7379 7374  s that some syst
│ │ │ │ +0002fc10: 656d 7320 7265 7370 6f6e 6420 7769 7468  ems respond with
│ │ │ │ +0002fc20: 2061 0a20 2020 2020 6e6f 6e2d 7175 616c   a.     non-qual
│ │ │ │ +0002fc30: 6966 6965 6420 686f 7374 206e 616d 6520  ified host name 
│ │ │ │ +0002fc40: 6173 2072 6570 6c79 2066 726f 6d20 e280  as reply from ..
│ │ │ │ +0002fc50: 9867 6574 686f 7374 6e61 6d65 2829 e280  .gethostname()..
│ │ │ │ +0002fc60: 992e 0a0a 2020 2020 202a 5265 7475 726e  ....     *Return
│ │ │ │ +0002fc70: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ +0002fc80: 2061 2067 7565 7373 6564 2072 6561 6c6d   a guessed realm
│ │ │ │ +0002fc90: 2066 6f72 2074 6865 2072 756e 6e69 6e67   for the running
│ │ │ │ +0002fca0: 2068 6f73 742c 0a20 2020 2020 636f 6e74   host,.     cont
│ │ │ │ +0002fcb0: 6169 6e69 6e67 2061 2073 7472 696e 6720  aining a string 
│ │ │ │ +0002fcc0: 7468 6174 2068 6173 2074 6f20 6265 2064  that has to be d
│ │ │ │ +0002fcd0: 6561 6c6c 6f63 6174 6564 2077 6974 6820  eallocated with 
│ │ │ │ +0002fce0: e280 9866 7265 6528 29e2 8099 2062 7920  ...free()... by 
│ │ │ │ +0002fcf0: 7468 650a 2020 2020 2063 616c 6c65 722e  the.     caller.
│ │ │ │ +0002fd00: 0a0a 7368 6973 6869 5f72 6561 6c6d 5f64  ..shishi_realm_d
│ │ │ │ +0002fd10: 6566 6175 6c74 0a2d 2d2d 2d2d 2d2d 2d2d  efault.---------
│ │ │ │ +0002fd20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ +0002fd30: 2046 756e 6374 696f 6e3a 2063 6f6e 7374   Function: const
│ │ │ │ +0002fd40: 2063 6861 7220 2a20 7368 6973 6869 5f72   char * shishi_r
│ │ │ │ +0002fd50: 6561 6c6d 5f64 6566 6175 6c74 2028 5368  ealm_default (Sh
│ │ │ │ +0002fd60: 6973 6869 202a 2048 414e 444c 4529 0a20  ishi * HANDLE). 
│ │ │ │ +0002fd70: 2020 2020 4841 4e44 4c45 3a20 5368 6973      HANDLE: Shis
│ │ │ │ +0002fd80: 6869 206c 6962 7261 7279 2068 616e 646c  hi library handl
│ │ │ │ +0002fd90: 6520 6372 6561 7465 6420 6279 20e2 8098  e created by ...
│ │ │ │ +0002fda0: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ +0002fdb0: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ +0002fdc0: 7469 6f6e 3a2a 2044 6574 6572 6d69 6e65  tion:* Determine
│ │ │ │ +0002fdd0: 7320 6e61 6d65 206f 6620 6465 6661 756c  s name of defaul
│ │ │ │ +0002fde0: 7420 7265 616c 6d2c 2069 2e65 2e2c 2074  t realm, i.e., t
│ │ │ │ +0002fdf0: 6865 206e 616d 6520 6f66 0a20 2020 2020  he name of.     
│ │ │ │ +0002fe00: 7768 6174 6576 6572 2072 6561 6c6d 2074  whatever realm t
│ │ │ │ +0002fe10: 6865 206c 6962 7261 7279 2077 696c 6c20  he library will 
│ │ │ │ +0002fe20: 7573 6520 7768 656e 6576 6572 2061 6e20  use whenever an 
│ │ │ │ +0002fe30: 6578 706c 6963 6974 2072 6561 6c6d 2069  explicit realm i
│ │ │ │ +0002fe40: 730a 2020 2020 206e 6f74 2073 7461 7465  s.     not state
│ │ │ │ +0002fe50: 6420 6475 7269 6e67 2061 206c 6962 7261  d during a libra
│ │ │ │ +0002fe60: 7279 2063 616c 6c2e 0a0a 2020 2020 202a  ry call...     *
│ │ │ │ +0002fe70: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ +0002fe80: 6574 7572 6e73 2074 6865 2064 6566 6175  eturns the defau
│ │ │ │ +0002fe90: 6c74 2072 6561 6c6d 2069 6e20 7573 6520  lt realm in use 
│ │ │ │ +0002fea0: 6279 2074 6865 206c 6962 7261 7279 2e0a  by the library..
│ │ │ │ +0002feb0: 2020 2020 204e 6f74 2061 2063 6f70 792c       Not a copy,
│ │ │ │ +0002fec0: 2073 6f20 646f 206e 6f74 206d 6f64 6966   so do not modif
│ │ │ │ +0002fed0: 7920 6f72 2064 6561 6c6c 6f63 6174 6520  y or deallocate 
│ │ │ │ +0002fee0: 7468 6520 7265 7475 726e 6564 2073 7472  the returned str
│ │ │ │ +0002fef0: 696e 672e 0a0a 7368 6973 6869 5f72 6561  ing...shishi_rea
│ │ │ │ +0002ff00: 6c6d 5f64 6566 6175 6c74 5f73 6574 0a2d  lm_default_set.-
│ │ │ │  0002ff10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0002ff20: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ -0002ff30: 7469 6f6e 3a20 766f 6964 2073 6869 7368  tion: void shish
│ │ │ │ -0002ff40: 695f 7265 616c 6d5f 6465 6661 756c 745f  i_realm_default_
│ │ │ │ -0002ff50: 7365 7420 2853 6869 7368 6920 2a20 4841  set (Shishi * HA
│ │ │ │ -0002ff60: 4e44 4c45 2c0a 2020 2020 2020 2020 2020  NDLE,.          
│ │ │ │ -0002ff70: 636f 6e73 7420 6368 6172 202a 2052 4541  const char * REA
│ │ │ │ -0002ff80: 4c4d 290a 2020 2020 2048 414e 444c 453a  LM).     HANDLE:
│ │ │ │ -0002ff90: 2053 6869 7368 6920 6c69 6272 6172 7920   Shishi library 
│ │ │ │ -0002ffa0: 6861 6e64 6c65 2063 7265 6174 6564 2062  handle created b
│ │ │ │ -0002ffb0: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ -0002ffc0: 2829 e280 992e 0a20 2020 2020 5245 414c  ().....     REAL
│ │ │ │ -0002ffd0: 4d3a 2053 7472 696e 6720 7374 6174 696e  M: String statin
│ │ │ │ -0002ffe0: 6720 6120 6e65 7720 6465 6661 756c 7420  g a new default 
│ │ │ │ -0002fff0: 7265 616c 6d20 6e61 6d65 2c20 6f72 20e2  realm name, or .
│ │ │ │ -00030000: 8098 4e55 4c4c e280 992e 0a0a 2020 2020  ..NULL......    
│ │ │ │ -00030010: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ -00030020: 5365 7473 2074 6865 2064 6566 6175 6c74  Sets the default
│ │ │ │ -00030030: 2072 6561 6c6d 2075 7365 6420 6279 2074   realm used by t
│ │ │ │ -00030040: 6865 206c 6962 7261 7279 3b20 6f72 2c20  he library; or, 
│ │ │ │ -00030050: 7769 7468 0a20 2020 2020 5245 414c 4d20  with.     REALM 
│ │ │ │ -00030060: 7365 7420 746f 20e2 8098 4e55 4c4c e280  set to ...NULL..
│ │ │ │ -00030070: 992c 2072 6573 6574 7320 7468 6520 6c69  ., resets the li
│ │ │ │ -00030080: 6272 6172 7920 7265 616c 6d20 7365 7474  brary realm sett
│ │ │ │ -00030090: 696e 6720 746f 2074 6861 7420 6e61 6d65  ing to that name
│ │ │ │ -000300a0: 0a20 2020 2020 7365 6c65 6374 6564 2062  .     selected b
│ │ │ │ -000300b0: 7920 636f 6e66 6967 7572 6174 696f 6e20  y configuration 
│ │ │ │ -000300c0: 666f 7220 6465 6661 756c 7420 7661 6c75  for default valu
│ │ │ │ -000300d0: 652e 0a0a 2020 2020 2054 6865 2073 7472  e...     The str
│ │ │ │ -000300e0: 696e 6720 6973 2063 6f70 6965 6420 696e  ing is copied in
│ │ │ │ -000300f0: 746f 2074 6865 206c 6962 7261 7279 2c20  to the library, 
│ │ │ │ -00030100: 736f 2079 6f75 2063 616e 2064 6973 706f  so you can dispo
│ │ │ │ -00030110: 7365 206f 6620 7468 650a 2020 2020 2063  se of the.     c
│ │ │ │ -00030120: 6f6e 7465 6e74 2069 6e20 5245 414c 4d20  ontent in REALM 
│ │ │ │ -00030130: 696d 6d65 6469 6174 656c 7920 6166 7465  immediately afte
│ │ │ │ -00030140: 7220 6361 6c6c 696e 6720 7468 6973 2066  r calling this f
│ │ │ │ -00030150: 756e 6374 696f 6e2e 0a0a 7368 6973 6869  unction...shishi
│ │ │ │ -00030160: 5f72 6561 6c6d 5f66 6f72 5f73 6572 7665  _realm_for_serve
│ │ │ │ -00030170: 725f 6669 6c65 0a2d 2d2d 2d2d 2d2d 2d2d  r_file.---------
│ │ │ │ +0002ff20: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +0002ff30: 6374 696f 6e3a 2076 6f69 6420 7368 6973  ction: void shis
│ │ │ │ +0002ff40: 6869 5f72 6561 6c6d 5f64 6566 6175 6c74  hi_realm_default
│ │ │ │ +0002ff50: 5f73 6574 2028 5368 6973 6869 202a 2048  _set (Shishi * H
│ │ │ │ +0002ff60: 414e 444c 452c 0a20 2020 2020 2020 2020  ANDLE,.         
│ │ │ │ +0002ff70: 2063 6f6e 7374 2063 6861 7220 2a20 5245   const char * RE
│ │ │ │ +0002ff80: 414c 4d29 0a20 2020 2020 4841 4e44 4c45  ALM).     HANDLE
│ │ │ │ +0002ff90: 3a20 5368 6973 6869 206c 6962 7261 7279  : Shishi library
│ │ │ │ +0002ffa0: 2068 616e 646c 6520 6372 6561 7465 6420   handle created 
│ │ │ │ +0002ffb0: 6279 20e2 8098 7368 6973 6869 5f69 6e69  by ...shishi_ini
│ │ │ │ +0002ffc0: 7428 29e2 8099 2e0a 2020 2020 2052 4541  t().....     REA
│ │ │ │ +0002ffd0: 4c4d 3a20 5374 7269 6e67 2073 7461 7469  LM: String stati
│ │ │ │ +0002ffe0: 6e67 2061 206e 6577 2064 6566 6175 6c74  ng a new default
│ │ │ │ +0002fff0: 2072 6561 6c6d 206e 616d 652c 206f 7220   realm name, or 
│ │ │ │ +00030000: e280 984e 554c 4ce2 8099 2e0a 0a20 2020  ...NULL......   
│ │ │ │ +00030010: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ +00030020: 2053 6574 7320 7468 6520 6465 6661 756c   Sets the defaul
│ │ │ │ +00030030: 7420 7265 616c 6d20 7573 6564 2062 7920  t realm used by 
│ │ │ │ +00030040: 7468 6520 6c69 6272 6172 793b 206f 722c  the library; or,
│ │ │ │ +00030050: 2077 6974 680a 2020 2020 2052 4541 4c4d   with.     REALM
│ │ │ │ +00030060: 2073 6574 2074 6f20 e280 984e 554c 4ce2   set to ...NULL.
│ │ │ │ +00030070: 8099 2c20 7265 7365 7473 2074 6865 206c  .., resets the l
│ │ │ │ +00030080: 6962 7261 7279 2072 6561 6c6d 2073 6574  ibrary realm set
│ │ │ │ +00030090: 7469 6e67 2074 6f20 7468 6174 206e 616d  ting to that nam
│ │ │ │ +000300a0: 650a 2020 2020 2073 656c 6563 7465 6420  e.     selected 
│ │ │ │ +000300b0: 6279 2063 6f6e 6669 6775 7261 7469 6f6e  by configuration
│ │ │ │ +000300c0: 2066 6f72 2064 6566 6175 6c74 2076 616c   for default val
│ │ │ │ +000300d0: 7565 2e0a 0a20 2020 2020 5468 6520 7374  ue...     The st
│ │ │ │ +000300e0: 7269 6e67 2069 7320 636f 7069 6564 2069  ring is copied i
│ │ │ │ +000300f0: 6e74 6f20 7468 6520 6c69 6272 6172 792c  nto the library,
│ │ │ │ +00030100: 2073 6f20 796f 7520 6361 6e20 6469 7370   so you can disp
│ │ │ │ +00030110: 6f73 6520 6f66 2074 6865 0a20 2020 2020  ose of the.     
│ │ │ │ +00030120: 636f 6e74 656e 7420 696e 2052 4541 4c4d  content in REALM
│ │ │ │ +00030130: 2069 6d6d 6564 6961 7465 6c79 2061 6674   immediately aft
│ │ │ │ +00030140: 6572 2063 616c 6c69 6e67 2074 6869 7320  er calling this 
│ │ │ │ +00030150: 6675 6e63 7469 6f6e 2e0a 0a73 6869 7368  function...shish
│ │ │ │ +00030160: 695f 7265 616c 6d5f 666f 725f 7365 7276  i_realm_for_serv
│ │ │ │ +00030170: 6572 5f66 696c 650a 2d2d 2d2d 2d2d 2d2d  er_file.--------
│ │ │ │  00030180: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00030190: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ -000301a0: 6e3a 2063 6861 7220 2a20 7368 6973 6869  n: char * shishi
│ │ │ │ -000301b0: 5f72 6561 6c6d 5f66 6f72 5f73 6572 7665  _realm_for_serve
│ │ │ │ -000301c0: 725f 6669 6c65 2028 5368 6973 6869 202a  r_file (Shishi *
│ │ │ │ -000301d0: 2048 414e 444c 452c 0a20 2020 2020 2020   HANDLE,.       
│ │ │ │ -000301e0: 2020 2063 6861 7220 2a20 5345 5256 4552     char * SERVER
│ │ │ │ -000301f0: 290a 2020 2020 2048 414e 444c 453a 2053  ).     HANDLE: S
│ │ │ │ -00030200: 6869 7368 6920 6c69 6272 6172 7920 6861  hishi library ha
│ │ │ │ -00030210: 6e64 6c65 2063 7265 6174 6564 2062 7920  ndle created by 
│ │ │ │ -00030220: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ -00030230: e280 992e 0a20 2020 2020 5345 5256 4552  .....     SERVER
│ │ │ │ -00030240: 3a20 486f 7374 6e61 6d65 2074 6f20 6465  : Hostname to de
│ │ │ │ -00030250: 7465 726d 696e 6520 7265 616c 6d20 666f  termine realm fo
│ │ │ │ -00030260: 722e 0a0a 2020 2020 202a 4465 7363 7269  r...     *Descri
│ │ │ │ -00030270: 7074 696f 6e3a 2a20 4669 6e64 7320 7468  ption:* Finds th
│ │ │ │ -00030280: 6520 7265 616c 6d20 6170 706c 6963 6162  e realm applicab
│ │ │ │ -00030290: 6c65 2074 6f20 6120 686f 7374 2053 4552  le to a host SER
│ │ │ │ -000302a0: 5645 522c 2075 7369 6e67 0a20 2020 2020  VER, using.     
│ │ │ │ -000302b0: 7468 6520 7374 616e 6461 7264 2063 6f6e  the standard con
│ │ │ │ -000302c0: 6669 6775 7261 7469 6f6e 2066 696c 652e  figuration file.
│ │ │ │ -000302d0: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ -000302e0: 616c 7565 3a2a 2052 6574 7572 6e73 2072  alue:* Returns r
│ │ │ │ -000302f0: 6561 6c6d 2066 6f72 2068 6f73 742c 206f  ealm for host, o
│ │ │ │ -00030300: 7220 e280 984e 554c 4ce2 8099 2069 6620  r ...NULL... if 
│ │ │ │ -00030310: 6e6f 7420 6b6e 6f77 6e2e 0a0a 7368 6973  not known...shis
│ │ │ │ -00030320: 6869 5f72 6561 6c6d 5f66 6f72 5f73 6572  hi_realm_for_ser
│ │ │ │ -00030330: 7665 725f 646e 730a 2d2d 2d2d 2d2d 2d2d  ver_dns.--------
│ │ │ │ +00030190: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ +000301a0: 6f6e 3a20 6368 6172 202a 2073 6869 7368  on: char * shish
│ │ │ │ +000301b0: 695f 7265 616c 6d5f 666f 725f 7365 7276  i_realm_for_serv
│ │ │ │ +000301c0: 6572 5f66 696c 6520 2853 6869 7368 6920  er_file (Shishi 
│ │ │ │ +000301d0: 2a20 4841 4e44 4c45 2c0a 2020 2020 2020  * HANDLE,.      
│ │ │ │ +000301e0: 2020 2020 6368 6172 202a 2053 4552 5645      char * SERVE
│ │ │ │ +000301f0: 5229 0a20 2020 2020 4841 4e44 4c45 3a20  R).     HANDLE: 
│ │ │ │ +00030200: 5368 6973 6869 206c 6962 7261 7279 2068  Shishi library h
│ │ │ │ +00030210: 616e 646c 6520 6372 6561 7465 6420 6279  andle created by
│ │ │ │ +00030220: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ +00030230: 29e2 8099 2e0a 2020 2020 2053 4552 5645  ).....     SERVE
│ │ │ │ +00030240: 523a 2048 6f73 746e 616d 6520 746f 2064  R: Hostname to d
│ │ │ │ +00030250: 6574 6572 6d69 6e65 2072 6561 6c6d 2066  etermine realm f
│ │ │ │ +00030260: 6f72 2e0a 0a20 2020 2020 2a44 6573 6372  or...     *Descr
│ │ │ │ +00030270: 6970 7469 6f6e 3a2a 2046 696e 6473 2074  iption:* Finds t
│ │ │ │ +00030280: 6865 2072 6561 6c6d 2061 7070 6c69 6361  he realm applica
│ │ │ │ +00030290: 626c 6520 746f 2061 2068 6f73 7420 5345  ble to a host SE
│ │ │ │ +000302a0: 5256 4552 2c20 7573 696e 670a 2020 2020  RVER, using.    
│ │ │ │ +000302b0: 2074 6865 2073 7461 6e64 6172 6420 636f   the standard co
│ │ │ │ +000302c0: 6e66 6967 7572 6174 696f 6e20 6669 6c65  nfiguration file
│ │ │ │ +000302d0: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ +000302e0: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ +000302f0: 7265 616c 6d20 666f 7220 686f 7374 2c20  realm for host, 
│ │ │ │ +00030300: 6f72 20e2 8098 4e55 4c4c e280 9920 6966  or ...NULL... if
│ │ │ │ +00030310: 206e 6f74 206b 6e6f 776e 2e0a 0a73 6869   not known...shi
│ │ │ │ +00030320: 7368 695f 7265 616c 6d5f 666f 725f 7365  shi_realm_for_se
│ │ │ │ +00030330: 7276 6572 5f64 6e73 0a2d 2d2d 2d2d 2d2d  rver_dns.-------
│ │ │ │  00030340: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00030350: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ -00030360: 6e3a 2063 6861 7220 2a20 7368 6973 6869  n: char * shishi
│ │ │ │ -00030370: 5f72 6561 6c6d 5f66 6f72 5f73 6572 7665  _realm_for_serve
│ │ │ │ -00030380: 725f 646e 7320 2853 6869 7368 6920 2a20  r_dns (Shishi * 
│ │ │ │ -00030390: 4841 4e44 4c45 2c0a 2020 2020 2020 2020  HANDLE,.        
│ │ │ │ -000303a0: 2020 6368 6172 202a 2053 4552 5645 5229    char * SERVER)
│ │ │ │ -000303b0: 0a20 2020 2020 4841 4e44 4c45 3a20 5368  .     HANDLE: Sh
│ │ │ │ -000303c0: 6973 6869 206c 6962 7261 7279 2068 616e  ishi library han
│ │ │ │ -000303d0: 646c 6520 6372 6561 7465 6420 6279 20e2  dle created by .
│ │ │ │ -000303e0: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ -000303f0: 8099 2e0a 2020 2020 2053 4552 5645 523a  ....     SERVER:
│ │ │ │ -00030400: 2048 6f73 746e 616d 6520 746f 2066 696e   Hostname to fin
│ │ │ │ -00030410: 6420 7265 616c 6d20 666f 722e 0a0a 2020  d realm for...  
│ │ │ │ -00030420: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ -00030430: 2a20 4669 6e64 7320 7468 6520 7265 616c  * Finds the real
│ │ │ │ -00030440: 6d20 666f 7220 6120 686f 7374 2053 4552  m for a host SER
│ │ │ │ -00030450: 5645 5220 7573 696e 6720 444e 5320 6c6f  VER using DNS lo
│ │ │ │ -00030460: 6f6b 7570 2c0a 2020 2020 2061 7320 6973  okup,.     as is
│ │ │ │ -00030470: 2070 7265 7363 7269 6265 6420 696e 2022   prescribed in "
│ │ │ │ -00030480: 6472 6166 742d 6965 7466 2d6b 7262 2d77  draft-ietf-krb-w
│ │ │ │ -00030490: 672d 6b72 622d 646e 732d 6c6f 6361 7465  g-krb-dns-locate
│ │ │ │ -000304a0: 2d30 332e 7478 7422 2e0a 0a20 2020 2020  -03.txt"...     
│ │ │ │ -000304b0: 5369 6e63 6520 444e 5320 6c6f 6f6b 7570  Since DNS lookup
│ │ │ │ -000304c0: 2063 616e 2062 6520 7370 6f6f 6665 642c   can be spoofed,
│ │ │ │ -000304d0: 2072 656c 7969 6e67 206f 6e20 7468 6520   relying on the 
│ │ │ │ -000304e0: 7265 616c 6d20 696e 666f 726d 6174 696f  realm informatio
│ │ │ │ -000304f0: 6e0a 2020 2020 206d 6179 2072 6573 756c  n.     may resul
│ │ │ │ -00030500: 7420 696e 2061 2072 6564 6972 6563 7469  t in a redirecti
│ │ │ │ -00030510: 6f6e 2061 7474 6163 6b2e 2020 496e 2061  on attack.  In a
│ │ │ │ -00030520: 2073 696e 676c 652d 7265 616c 6d20 7363   single-realm sc
│ │ │ │ -00030530: 656e 6172 696f 2c0a 2020 2020 2074 6869  enario,.     thi
│ │ │ │ -00030540: 7320 6f6e 6c79 2061 6368 6965 7665 7320  s only achieves 
│ │ │ │ -00030550: 6120 6465 6e69 616c 206f 6620 7365 7276  a denial of serv
│ │ │ │ -00030560: 6963 652c 2062 7574 2077 6974 6820 7472  ice, but with tr
│ │ │ │ -00030570: 7573 7420 6163 726f 7373 0a20 2020 2020  ust across.     
│ │ │ │ -00030580: 6d75 6c74 6970 6c65 2072 6561 6c6d 7320  multiple realms 
│ │ │ │ -00030590: 7468 6520 6174 7461 636b 206d 6179 2072  the attack may r
│ │ │ │ -000305a0: 6564 6972 6563 7420 796f 7520 746f 2061  edirect you to a
│ │ │ │ -000305b0: 2063 6f6d 7072 6f6d 6973 6564 2072 6561   compromised rea
│ │ │ │ -000305c0: 6c6d 2e0a 2020 2020 2046 6f72 2074 6869  lm..     For thi
│ │ │ │ -000305d0: 7320 7265 6173 6f6e 2c20 5368 6973 6869  s reason, Shishi
│ │ │ │ -000305e0: 2070 7269 6e74 7320 6120 7761 726e 696e   prints a warnin
│ │ │ │ -000305f0: 672c 2073 7567 6765 7374 696e 6720 7468  g, suggesting th
│ │ │ │ -00030600: 6174 2074 6865 2075 7365 720a 2020 2020  at the user.    
│ │ │ │ -00030610: 2073 686f 756c 6420 696e 7374 6561 6420   should instead 
│ │ │ │ -00030620: 6164 6420 6120 7072 6f70 6572 2027 7365  add a proper 'se
│ │ │ │ -00030630: 7276 6572 2d72 6561 6c6d 2720 636f 6e66  rver-realm' conf
│ │ │ │ -00030640: 6967 7572 6174 696f 6e20 746f 6b65 6e2e  iguration token.
│ │ │ │ -00030650: 0a0a 2020 2020 2054 6f20 696c 6c75 7374  ..     To illust
│ │ │ │ -00030660: 7261 7465 2074 6865 2044 4e53 2069 6e66  rate the DNS inf
│ │ │ │ -00030670: 6f72 6d61 7469 6f6e 2075 7365 642c 2068  ormation used, h
│ │ │ │ -00030680: 6572 6520 6973 2061 6e20 6578 7472 6163  ere is an extrac
│ │ │ │ -00030690: 7420 6672 6f6d 2061 0a20 2020 2020 7a6f  t from a.     zo
│ │ │ │ -000306a0: 6e65 2066 696c 6520 666f 7220 7468 6520  ne file for the 
│ │ │ │ -000306b0: 646f 6d61 696e 2041 5344 462e 434f 4d3a  domain ASDF.COM:
│ │ │ │ -000306c0: 0a0a 2020 2020 205f 6b65 7262 6572 6f73  ..     _kerberos
│ │ │ │ -000306d0: 2e61 7364 662e 636f 6d2e 2020 494e 2054  .asdf.com.  IN T
│ │ │ │ -000306e0: 5854 2022 4153 4446 2e43 4f4d 220a 2020  XT "ASDF.COM".  
│ │ │ │ -000306f0: 2020 205f 6b65 7262 6572 6f73 2e6d 726b     _kerberos.mrk
│ │ │ │ -00030700: 7365 7276 6572 2e61 7364 662e 636f 6d2e  server.asdf.com.
│ │ │ │ -00030710: 2020 494e 2054 5854 2022 4d41 524b 4554    IN TXT "MARKET
│ │ │ │ -00030720: 494e 472e 4153 4446 2e43 4f4d 220a 2020  ING.ASDF.COM".  
│ │ │ │ -00030730: 2020 205f 6b65 7262 6572 6f73 2e73 616c     _kerberos.sal
│ │ │ │ -00030740: 6573 7365 7276 6572 2e61 7364 662e 636f  esserver.asdf.co
│ │ │ │ -00030750: 6d2e 2020 494e 2054 5854 2022 5341 4c45  m.  IN TXT "SALE
│ │ │ │ -00030760: 532e 4153 4446 2e43 4f4d 220a 0a20 2020  S.ASDF.COM"..   
│ │ │ │ -00030770: 2020 4c65 7420 7573 2073 7570 706f 7365    Let us suppose
│ │ │ │ -00030780: 2074 6861 7420 696e 2074 6869 7320 6361   that in this ca
│ │ │ │ -00030790: 7365 2c20 6120 636c 6965 6e74 2077 6973  se, a client wis
│ │ │ │ -000307a0: 6865 7320 746f 2075 7365 2061 2073 6572  hes to use a ser
│ │ │ │ -000307b0: 7669 6365 0a20 2020 2020 6f6e 2074 6865  vice.     on the
│ │ │ │ -000307c0: 2068 6f73 7420 2266 6f6f 2e61 7364 662e   host "foo.asdf.
│ │ │ │ -000307d0: 636f 6d22 2e20 2049 7420 776f 756c 6420  com".  It would 
│ │ │ │ -000307e0: 6669 7273 7420 7175 6572 7920 666f 720a  first query for.
│ │ │ │ -000307f0: 0a20 2020 2020 5f6b 6572 6265 726f 732e  .     _kerberos.
│ │ │ │ -00030800: 666f 6f2e 6173 6466 2e63 6f6d 2e20 2049  foo.asdf.com.  I
│ │ │ │ -00030810: 4e20 5458 540a 0a20 2020 2020 4669 6e64  N TXT..     Find
│ │ │ │ -00030820: 696e 6720 6e6f 206d 6174 6368 2c20 6974  ing no match, it
│ │ │ │ -00030830: 2077 6f75 6c64 2074 6865 6e20 7175 6572   would then quer
│ │ │ │ -00030840: 7920 666f 720a 0a20 2020 2020 5f6b 6572  y for..     _ker
│ │ │ │ -00030850: 6265 726f 732e 6173 6466 2e63 6f6d 2e20  beros.asdf.com. 
│ │ │ │ -00030860: 2049 4e20 5458 540a 0a20 2020 2020 5769   IN TXT..     Wi
│ │ │ │ -00030870: 7468 2074 6865 2072 6573 6f75 7263 6520  th the resource 
│ │ │ │ -00030880: 7265 636f 7264 7320 7374 6174 6564 2061  records stated a
│ │ │ │ -00030890: 626f 7665 2c20 7468 6520 6c61 7474 6572  bove, the latter
│ │ │ │ -000308a0: 2071 7565 7279 2072 6574 7572 6e73 2061   query returns a
│ │ │ │ -000308b0: 0a20 2020 2020 706f 7369 7469 7665 2061  .     positive a
│ │ │ │ -000308c0: 6e73 7765 722e 0a0a 2020 2020 202a 5265  nswer...     *Re
│ │ │ │ -000308d0: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ -000308e0: 7572 6e73 2072 6561 6c6d 2066 6f72 2074  urns realm for t
│ │ │ │ -000308f0: 6865 2069 6e64 6963 6174 6564 2068 6f73  he indicated hos
│ │ │ │ -00030900: 742c 206f 7220 e280 984e 554c 4ce2 8099  t, or ...NULL...
│ │ │ │ -00030910: 2069 660a 2020 2020 206e 6f20 7265 6c65   if.     no rele
│ │ │ │ -00030920: 7661 6e74 2054 5854 2072 6563 6f72 6420  vant TXT record 
│ │ │ │ -00030930: 636f 756c 6420 6265 2066 6f75 6e64 2e0a  could be found..
│ │ │ │ -00030940: 0a73 6869 7368 695f 7265 616c 6d5f 666f  .shishi_realm_fo
│ │ │ │ -00030950: 725f 7365 7276 6572 0a2d 2d2d 2d2d 2d2d  r_server.-------
│ │ │ │ +00030350: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ +00030360: 6f6e 3a20 6368 6172 202a 2073 6869 7368  on: char * shish
│ │ │ │ +00030370: 695f 7265 616c 6d5f 666f 725f 7365 7276  i_realm_for_serv
│ │ │ │ +00030380: 6572 5f64 6e73 2028 5368 6973 6869 202a  er_dns (Shishi *
│ │ │ │ +00030390: 2048 414e 444c 452c 0a20 2020 2020 2020   HANDLE,.       
│ │ │ │ +000303a0: 2020 2063 6861 7220 2a20 5345 5256 4552     char * SERVER
│ │ │ │ +000303b0: 290a 2020 2020 2048 414e 444c 453a 2053  ).     HANDLE: S
│ │ │ │ +000303c0: 6869 7368 6920 6c69 6272 6172 7920 6861  hishi library ha
│ │ │ │ +000303d0: 6e64 6c65 2063 7265 6174 6564 2062 7920  ndle created by 
│ │ │ │ +000303e0: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ +000303f0: e280 992e 0a20 2020 2020 5345 5256 4552  .....     SERVER
│ │ │ │ +00030400: 3a20 486f 7374 6e61 6d65 2074 6f20 6669  : Hostname to fi
│ │ │ │ +00030410: 6e64 2072 6561 6c6d 2066 6f72 2e0a 0a20  nd realm for... 
│ │ │ │ +00030420: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ +00030430: 3a2a 2046 696e 6473 2074 6865 2072 6561  :* Finds the rea
│ │ │ │ +00030440: 6c6d 2066 6f72 2061 2068 6f73 7420 5345  lm for a host SE
│ │ │ │ +00030450: 5256 4552 2075 7369 6e67 2044 4e53 206c  RVER using DNS l
│ │ │ │ +00030460: 6f6f 6b75 702c 0a20 2020 2020 6173 2069  ookup,.     as i
│ │ │ │ +00030470: 7320 7072 6573 6372 6962 6564 2069 6e20  s prescribed in 
│ │ │ │ +00030480: 2264 7261 6674 2d69 6574 662d 6b72 622d  "draft-ietf-krb-
│ │ │ │ +00030490: 7767 2d6b 7262 2d64 6e73 2d6c 6f63 6174  wg-krb-dns-locat
│ │ │ │ +000304a0: 652d 3033 2e74 7874 222e 0a0a 2020 2020  e-03.txt"...    
│ │ │ │ +000304b0: 2053 696e 6365 2044 4e53 206c 6f6f 6b75   Since DNS looku
│ │ │ │ +000304c0: 7020 6361 6e20 6265 2073 706f 6f66 6564  p can be spoofed
│ │ │ │ +000304d0: 2c20 7265 6c79 696e 6720 6f6e 2074 6865  , relying on the
│ │ │ │ +000304e0: 2072 6561 6c6d 2069 6e66 6f72 6d61 7469   realm informati
│ │ │ │ +000304f0: 6f6e 0a20 2020 2020 6d61 7920 7265 7375  on.     may resu
│ │ │ │ +00030500: 6c74 2069 6e20 6120 7265 6469 7265 6374  lt in a redirect
│ │ │ │ +00030510: 696f 6e20 6174 7461 636b 2e20 2049 6e20  ion attack.  In 
│ │ │ │ +00030520: 6120 7369 6e67 6c65 2d72 6561 6c6d 2073  a single-realm s
│ │ │ │ +00030530: 6365 6e61 7269 6f2c 0a20 2020 2020 7468  cenario,.     th
│ │ │ │ +00030540: 6973 206f 6e6c 7920 6163 6869 6576 6573  is only achieves
│ │ │ │ +00030550: 2061 2064 656e 6961 6c20 6f66 2073 6572   a denial of ser
│ │ │ │ +00030560: 7669 6365 2c20 6275 7420 7769 7468 2074  vice, but with t
│ │ │ │ +00030570: 7275 7374 2061 6372 6f73 730a 2020 2020  rust across.    
│ │ │ │ +00030580: 206d 756c 7469 706c 6520 7265 616c 6d73   multiple realms
│ │ │ │ +00030590: 2074 6865 2061 7474 6163 6b20 6d61 7920   the attack may 
│ │ │ │ +000305a0: 7265 6469 7265 6374 2079 6f75 2074 6f20  redirect you to 
│ │ │ │ +000305b0: 6120 636f 6d70 726f 6d69 7365 6420 7265  a compromised re
│ │ │ │ +000305c0: 616c 6d2e 0a20 2020 2020 466f 7220 7468  alm..     For th
│ │ │ │ +000305d0: 6973 2072 6561 736f 6e2c 2053 6869 7368  is reason, Shish
│ │ │ │ +000305e0: 6920 7072 696e 7473 2061 2077 6172 6e69  i prints a warni
│ │ │ │ +000305f0: 6e67 2c20 7375 6767 6573 7469 6e67 2074  ng, suggesting t
│ │ │ │ +00030600: 6861 7420 7468 6520 7573 6572 0a20 2020  hat the user.   
│ │ │ │ +00030610: 2020 7368 6f75 6c64 2069 6e73 7465 6164    should instead
│ │ │ │ +00030620: 2061 6464 2061 2070 726f 7065 7220 2773   add a proper 's
│ │ │ │ +00030630: 6572 7665 722d 7265 616c 6d27 2063 6f6e  erver-realm' con
│ │ │ │ +00030640: 6669 6775 7261 7469 6f6e 2074 6f6b 656e  figuration token
│ │ │ │ +00030650: 2e0a 0a20 2020 2020 546f 2069 6c6c 7573  ...     To illus
│ │ │ │ +00030660: 7472 6174 6520 7468 6520 444e 5320 696e  trate the DNS in
│ │ │ │ +00030670: 666f 726d 6174 696f 6e20 7573 6564 2c20  formation used, 
│ │ │ │ +00030680: 6865 7265 2069 7320 616e 2065 7874 7261  here is an extra
│ │ │ │ +00030690: 6374 2066 726f 6d20 610a 2020 2020 207a  ct from a.     z
│ │ │ │ +000306a0: 6f6e 6520 6669 6c65 2066 6f72 2074 6865  one file for the
│ │ │ │ +000306b0: 2064 6f6d 6169 6e20 4153 4446 2e43 4f4d   domain ASDF.COM
│ │ │ │ +000306c0: 3a0a 0a20 2020 2020 5f6b 6572 6265 726f  :..     _kerbero
│ │ │ │ +000306d0: 732e 6173 6466 2e63 6f6d 2e20 2049 4e20  s.asdf.com.  IN 
│ │ │ │ +000306e0: 5458 5420 2241 5344 462e 434f 4d22 0a20  TXT "ASDF.COM". 
│ │ │ │ +000306f0: 2020 2020 5f6b 6572 6265 726f 732e 6d72      _kerberos.mr
│ │ │ │ +00030700: 6b73 6572 7665 722e 6173 6466 2e63 6f6d  kserver.asdf.com
│ │ │ │ +00030710: 2e20 2049 4e20 5458 5420 224d 4152 4b45  .  IN TXT "MARKE
│ │ │ │ +00030720: 5449 4e47 2e41 5344 462e 434f 4d22 0a20  TING.ASDF.COM". 
│ │ │ │ +00030730: 2020 2020 5f6b 6572 6265 726f 732e 7361      _kerberos.sa
│ │ │ │ +00030740: 6c65 7373 6572 7665 722e 6173 6466 2e63  lesserver.asdf.c
│ │ │ │ +00030750: 6f6d 2e20 2049 4e20 5458 5420 2253 414c  om.  IN TXT "SAL
│ │ │ │ +00030760: 4553 2e41 5344 462e 434f 4d22 0a0a 2020  ES.ASDF.COM"..  
│ │ │ │ +00030770: 2020 204c 6574 2075 7320 7375 7070 6f73     Let us suppos
│ │ │ │ +00030780: 6520 7468 6174 2069 6e20 7468 6973 2063  e that in this c
│ │ │ │ +00030790: 6173 652c 2061 2063 6c69 656e 7420 7769  ase, a client wi
│ │ │ │ +000307a0: 7368 6573 2074 6f20 7573 6520 6120 7365  shes to use a se
│ │ │ │ +000307b0: 7276 6963 650a 2020 2020 206f 6e20 7468  rvice.     on th
│ │ │ │ +000307c0: 6520 686f 7374 2022 666f 6f2e 6173 6466  e host "foo.asdf
│ │ │ │ +000307d0: 2e63 6f6d 222e 2020 4974 2077 6f75 6c64  .com".  It would
│ │ │ │ +000307e0: 2066 6972 7374 2071 7565 7279 2066 6f72   first query for
│ │ │ │ +000307f0: 0a0a 2020 2020 205f 6b65 7262 6572 6f73  ..     _kerberos
│ │ │ │ +00030800: 2e66 6f6f 2e61 7364 662e 636f 6d2e 2020  .foo.asdf.com.  
│ │ │ │ +00030810: 494e 2054 5854 0a0a 2020 2020 2046 696e  IN TXT..     Fin
│ │ │ │ +00030820: 6469 6e67 206e 6f20 6d61 7463 682c 2069  ding no match, i
│ │ │ │ +00030830: 7420 776f 756c 6420 7468 656e 2071 7565  t would then que
│ │ │ │ +00030840: 7279 2066 6f72 0a0a 2020 2020 205f 6b65  ry for..     _ke
│ │ │ │ +00030850: 7262 6572 6f73 2e61 7364 662e 636f 6d2e  rberos.asdf.com.
│ │ │ │ +00030860: 2020 494e 2054 5854 0a0a 2020 2020 2057    IN TXT..     W
│ │ │ │ +00030870: 6974 6820 7468 6520 7265 736f 7572 6365  ith the resource
│ │ │ │ +00030880: 2072 6563 6f72 6473 2073 7461 7465 6420   records stated 
│ │ │ │ +00030890: 6162 6f76 652c 2074 6865 206c 6174 7465  above, the latte
│ │ │ │ +000308a0: 7220 7175 6572 7920 7265 7475 726e 7320  r query returns 
│ │ │ │ +000308b0: 610a 2020 2020 2070 6f73 6974 6976 6520  a.     positive 
│ │ │ │ +000308c0: 616e 7377 6572 2e0a 0a20 2020 2020 2a52  answer...     *R
│ │ │ │ +000308d0: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +000308e0: 7475 726e 7320 7265 616c 6d20 666f 7220  turns realm for 
│ │ │ │ +000308f0: 7468 6520 696e 6469 6361 7465 6420 686f  the indicated ho
│ │ │ │ +00030900: 7374 2c20 6f72 20e2 8098 4e55 4c4c e280  st, or ...NULL..
│ │ │ │ +00030910: 9920 6966 0a20 2020 2020 6e6f 2072 656c  . if.     no rel
│ │ │ │ +00030920: 6576 616e 7420 5458 5420 7265 636f 7264  evant TXT record
│ │ │ │ +00030930: 2063 6f75 6c64 2062 6520 666f 756e 642e   could be found.
│ │ │ │ +00030940: 0a0a 7368 6973 6869 5f72 6561 6c6d 5f66  ..shishi_realm_f
│ │ │ │ +00030950: 6f72 5f73 6572 7665 720a 2d2d 2d2d 2d2d  or_server.------
│ │ │ │  00030960: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00030970: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ -00030980: 6368 6172 202a 2073 6869 7368 695f 7265  char * shishi_re
│ │ │ │ -00030990: 616c 6d5f 666f 725f 7365 7276 6572 2028  alm_for_server (
│ │ │ │ -000309a0: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ -000309b0: 0a20 2020 2020 2020 2020 2063 6861 7220  .          char 
│ │ │ │ -000309c0: 2a20 5345 5256 4552 290a 2020 2020 2048  * SERVER).     H
│ │ │ │ -000309d0: 414e 444c 453a 2053 6869 7368 6920 6c69  ANDLE: Shishi li
│ │ │ │ -000309e0: 6272 6172 7920 6861 6e64 6c65 2063 7265  brary handle cre
│ │ │ │ -000309f0: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ -00030a00: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ -00030a10: 2020 5345 5256 4552 3a20 486f 7374 6e61    SERVER: Hostna
│ │ │ │ -00030a20: 6d65 2074 6f20 6669 6e64 2072 6561 6c6d  me to find realm
│ │ │ │ -00030a30: 2066 6f72 2e0a 0a20 2020 2020 2a44 6573   for...     *Des
│ │ │ │ -00030a40: 6372 6970 7469 6f6e 3a2a 2046 696e 6473  cription:* Finds
│ │ │ │ -00030a50: 2061 2072 6561 6c6d 2066 6f72 2074 6865   a realm for the
│ │ │ │ -00030a60: 2068 6f73 7420 5345 5256 4552 2c20 7573   host SERVER, us
│ │ │ │ -00030a70: 696e 6720 7661 7269 6f75 730a 2020 2020  ing various.    
│ │ │ │ -00030a80: 206d 6574 686f 6473 2e0a 0a20 2020 2020   methods...     
│ │ │ │ -00030a90: 4375 7272 656e 746c 7920 7468 6973 2069  Currently this i
│ │ │ │ -00030aa0: 6e63 6c75 6465 7320 7374 6174 6963 2063  ncludes static c
│ │ │ │ -00030ab0: 6f6e 6669 6775 7261 7469 6f6e 2066 696c  onfiguration fil
│ │ │ │ -00030ac0: 6573 2c20 7573 696e 6720 7468 650a 2020  es, using the.  
│ │ │ │ -00030ad0: 2020 206c 6962 7261 7279 2063 616c 6c20     library call 
│ │ │ │ -00030ae0: e280 9873 6869 7368 695f 7265 616c 6d5f  ...shishi_realm_
│ │ │ │ -00030af0: 666f 725f 7365 7276 6572 5f66 696c 6528  for_server_file(
│ │ │ │ -00030b00: 29e2 8099 2c20 616e 6420 444e 5320 6c6f  )..., and DNS lo
│ │ │ │ -00030b10: 6f6b 7570 2075 7369 6e67 0a20 2020 2020  okup using.     
│ │ │ │ -00030b20: e280 9873 6869 7368 695f 7265 616c 6d5f  ...shishi_realm_
│ │ │ │ -00030b30: 666f 725f 7365 7276 6572 5f64 6e73 2829  for_server_dns()
│ │ │ │ -00030b40: e280 992e 2020 5468 6579 2061 7265 2061  ....  They are a
│ │ │ │ -00030b50: 7474 656d 7074 6564 2069 6e20 7468 6520  ttempted in the 
│ │ │ │ -00030b60: 7374 6174 6564 0a20 2020 2020 6f72 6465  stated.     orde
│ │ │ │ -00030b70: 722e 2020 5365 6520 7468 6520 646f 6375  r.  See the docu
│ │ │ │ -00030b80: 6d65 6e74 6174 696f 6e20 6f66 2065 6974  mentation of eit
│ │ │ │ -00030b90: 6865 7220 6675 6e63 7469 6f6e 2066 6f72  her function for
│ │ │ │ -00030ba0: 206d 6f72 650a 2020 2020 2069 6e66 6f72   more.     infor
│ │ │ │ -00030bb0: 6d61 7469 6f6e 2e0a 0a20 2020 2020 2a52  mation...     *R
│ │ │ │ -00030bc0: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ -00030bd0: 7475 726e 7320 7265 616c 6d20 666f 7220  turns realm for 
│ │ │ │ -00030be0: 7468 6520 696e 6469 6361 7465 6420 686f  the indicated ho
│ │ │ │ -00030bf0: 7374 2c20 6f72 20e2 8098 4e55 4c4c e280  st, or ...NULL..
│ │ │ │ -00030c00: 9920 6966 0a20 2020 2020 6e6f 7468 696e  . if.     nothin
│ │ │ │ -00030c10: 6720 6973 206b 6e6f 776e 2061 626f 7574  g is known about
│ │ │ │ -00030c20: 2053 4552 5645 522e 0a0a 7368 6973 6869   SERVER...shishi
│ │ │ │ -00030c30: 5f70 7269 6e63 6970 616c 5f64 6566 6175  _principal_defau
│ │ │ │ -00030c40: 6c74 5f67 7565 7373 0a2d 2d2d 2d2d 2d2d  lt_guess.-------
│ │ │ │ +00030970: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ +00030980: 2063 6861 7220 2a20 7368 6973 6869 5f72   char * shishi_r
│ │ │ │ +00030990: 6561 6c6d 5f66 6f72 5f73 6572 7665 7220  ealm_for_server 
│ │ │ │ +000309a0: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ +000309b0: 2c0a 2020 2020 2020 2020 2020 6368 6172  ,.          char
│ │ │ │ +000309c0: 202a 2053 4552 5645 5229 0a20 2020 2020   * SERVER).     
│ │ │ │ +000309d0: 4841 4e44 4c45 3a20 5368 6973 6869 206c  HANDLE: Shishi l
│ │ │ │ +000309e0: 6962 7261 7279 2068 616e 646c 6520 6372  ibrary handle cr
│ │ │ │ +000309f0: 6561 7465 6420 6279 20e2 8098 7368 6973  eated by ...shis
│ │ │ │ +00030a00: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ +00030a10: 2020 2053 4552 5645 523a 2048 6f73 746e     SERVER: Hostn
│ │ │ │ +00030a20: 616d 6520 746f 2066 696e 6420 7265 616c  ame to find real
│ │ │ │ +00030a30: 6d20 666f 722e 0a0a 2020 2020 202a 4465  m for...     *De
│ │ │ │ +00030a40: 7363 7269 7074 696f 6e3a 2a20 4669 6e64  scription:* Find
│ │ │ │ +00030a50: 7320 6120 7265 616c 6d20 666f 7220 7468  s a realm for th
│ │ │ │ +00030a60: 6520 686f 7374 2053 4552 5645 522c 2075  e host SERVER, u
│ │ │ │ +00030a70: 7369 6e67 2076 6172 696f 7573 0a20 2020  sing various.   
│ │ │ │ +00030a80: 2020 6d65 7468 6f64 732e 0a0a 2020 2020    methods...    
│ │ │ │ +00030a90: 2043 7572 7265 6e74 6c79 2074 6869 7320   Currently this 
│ │ │ │ +00030aa0: 696e 636c 7564 6573 2073 7461 7469 6320  includes static 
│ │ │ │ +00030ab0: 636f 6e66 6967 7572 6174 696f 6e20 6669  configuration fi
│ │ │ │ +00030ac0: 6c65 732c 2075 7369 6e67 2074 6865 0a20  les, using the. 
│ │ │ │ +00030ad0: 2020 2020 6c69 6272 6172 7920 6361 6c6c      library call
│ │ │ │ +00030ae0: 20e2 8098 7368 6973 6869 5f72 6561 6c6d   ...shishi_realm
│ │ │ │ +00030af0: 5f66 6f72 5f73 6572 7665 725f 6669 6c65  _for_server_file
│ │ │ │ +00030b00: 2829 e280 992c 2061 6e64 2044 4e53 206c  ()..., and DNS l
│ │ │ │ +00030b10: 6f6f 6b75 7020 7573 696e 670a 2020 2020  ookup using.    
│ │ │ │ +00030b20: 20e2 8098 7368 6973 6869 5f72 6561 6c6d   ...shishi_realm
│ │ │ │ +00030b30: 5f66 6f72 5f73 6572 7665 725f 646e 7328  _for_server_dns(
│ │ │ │ +00030b40: 29e2 8099 2e20 2054 6865 7920 6172 6520  )....  They are 
│ │ │ │ +00030b50: 6174 7465 6d70 7465 6420 696e 2074 6865  attempted in the
│ │ │ │ +00030b60: 2073 7461 7465 640a 2020 2020 206f 7264   stated.     ord
│ │ │ │ +00030b70: 6572 2e20 2053 6565 2074 6865 2064 6f63  er.  See the doc
│ │ │ │ +00030b80: 756d 656e 7461 7469 6f6e 206f 6620 6569  umentation of ei
│ │ │ │ +00030b90: 7468 6572 2066 756e 6374 696f 6e20 666f  ther function fo
│ │ │ │ +00030ba0: 7220 6d6f 7265 0a20 2020 2020 696e 666f  r more.     info
│ │ │ │ +00030bb0: 726d 6174 696f 6e2e 0a0a 2020 2020 202a  rmation...     *
│ │ │ │ +00030bc0: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ +00030bd0: 6574 7572 6e73 2072 6561 6c6d 2066 6f72  eturns realm for
│ │ │ │ +00030be0: 2074 6865 2069 6e64 6963 6174 6564 2068   the indicated h
│ │ │ │ +00030bf0: 6f73 742c 206f 7220 e280 984e 554c 4ce2  ost, or ...NULL.
│ │ │ │ +00030c00: 8099 2069 660a 2020 2020 206e 6f74 6869  .. if.     nothi
│ │ │ │ +00030c10: 6e67 2069 7320 6b6e 6f77 6e20 6162 6f75  ng is known abou
│ │ │ │ +00030c20: 7420 5345 5256 4552 2e0a 0a73 6869 7368  t SERVER...shish
│ │ │ │ +00030c30: 695f 7072 696e 6369 7061 6c5f 6465 6661  i_principal_defa
│ │ │ │ +00030c40: 756c 745f 6775 6573 730a 2d2d 2d2d 2d2d  ult_guess.------
│ │ │ │  00030c50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00030c60: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ -00030c70: 6374 696f 6e3a 2063 6861 7220 2a20 7368  ction: char * sh
│ │ │ │ -00030c80: 6973 6869 5f70 7269 6e63 6970 616c 5f64  ishi_principal_d
│ │ │ │ -00030c90: 6566 6175 6c74 5f67 7565 7373 2028 290a  efault_guess ().
│ │ │ │ -00030ca0: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -00030cb0: 6f6e 3a2a 2047 7565 7373 6573 2074 6865  on:* Guesses the
│ │ │ │ -00030cc0: 2070 7269 6e63 6970 616c 206e 616d 6520   principal name 
│ │ │ │ -00030cd0: 666f 7220 7468 6520 7573 6572 2c20 6c6f  for the user, lo
│ │ │ │ -00030ce0: 6f6b 696e 6720 6174 0a20 2020 2020 656e  oking at.     en
│ │ │ │ -00030cf0: 7669 726f 6e6d 656e 7420 7661 7269 6162  vironment variab
│ │ │ │ -00030d00: 6c65 7320 5348 4953 4849 5f55 5345 522c  les SHISHI_USER,
│ │ │ │ -00030d10: 2055 5345 5220 616e 6420 4c4f 474e 414d   USER and LOGNAM
│ │ │ │ -00030d20: 452c 206f 7220 6966 2074 6861 740a 2020  E, or if that.  
│ │ │ │ -00030d30: 2020 2066 6169 6c73 2c20 7265 7475 726e     fails, return
│ │ │ │ -00030d40: 7320 7468 6520 7374 7269 6e67 2022 7573  s the string "us
│ │ │ │ -00030d50: 6572 222e 0a0a 2020 2020 202a 5265 7475  er"...     *Retu
│ │ │ │ -00030d60: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ -00030d70: 6e73 2067 7565 7373 6564 2064 6566 6175  ns guessed defau
│ │ │ │ -00030d80: 6c74 2070 7269 6e63 6970 616c 2066 6f72  lt principal for
│ │ │ │ -00030d90: 2075 7365 7220 6173 2061 0a20 2020 2020   user as a.     
│ │ │ │ -00030da0: 7374 7269 6e67 2074 6861 7420 6861 7320  string that has 
│ │ │ │ -00030db0: 746f 2062 6520 6465 616c 6c6f 6361 7465  to be deallocate
│ │ │ │ -00030dc0: 6420 6279 2074 6865 2063 616c 6c65 7220  d by the caller 
│ │ │ │ -00030dd0: 7769 7468 20e2 8098 6672 6565 2829 e280  with ...free()..
│ │ │ │ -00030de0: 992e 0a0a 7368 6973 6869 5f70 7269 6e63  ....shishi_princ
│ │ │ │ -00030df0: 6970 616c 5f64 6566 6175 6c74 0a2d 2d2d  ipal_default.---
│ │ │ │ +00030c60: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ +00030c70: 6e63 7469 6f6e 3a20 6368 6172 202a 2073  nction: char * s
│ │ │ │ +00030c80: 6869 7368 695f 7072 696e 6369 7061 6c5f  hishi_principal_
│ │ │ │ +00030c90: 6465 6661 756c 745f 6775 6573 7320 2829  default_guess ()
│ │ │ │ +00030ca0: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ +00030cb0: 696f 6e3a 2a20 4775 6573 7365 7320 7468  ion:* Guesses th
│ │ │ │ +00030cc0: 6520 7072 696e 6369 7061 6c20 6e61 6d65  e principal name
│ │ │ │ +00030cd0: 2066 6f72 2074 6865 2075 7365 722c 206c   for the user, l
│ │ │ │ +00030ce0: 6f6f 6b69 6e67 2061 740a 2020 2020 2065  ooking at.     e
│ │ │ │ +00030cf0: 6e76 6972 6f6e 6d65 6e74 2076 6172 6961  nvironment varia
│ │ │ │ +00030d00: 626c 6573 2053 4849 5348 495f 5553 4552  bles SHISHI_USER
│ │ │ │ +00030d10: 2c20 5553 4552 2061 6e64 204c 4f47 4e41  , USER and LOGNA
│ │ │ │ +00030d20: 4d45 2c20 6f72 2069 6620 7468 6174 0a20  ME, or if that. 
│ │ │ │ +00030d30: 2020 2020 6661 696c 732c 2072 6574 7572      fails, retur
│ │ │ │ +00030d40: 6e73 2074 6865 2073 7472 696e 6720 2275  ns the string "u
│ │ │ │ +00030d50: 7365 7222 2e0a 0a20 2020 2020 2a52 6574  ser"...     *Ret
│ │ │ │ +00030d60: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ +00030d70: 726e 7320 6775 6573 7365 6420 6465 6661  rns guessed defa
│ │ │ │ +00030d80: 756c 7420 7072 696e 6369 7061 6c20 666f  ult principal fo
│ │ │ │ +00030d90: 7220 7573 6572 2061 7320 610a 2020 2020  r user as a.    
│ │ │ │ +00030da0: 2073 7472 696e 6720 7468 6174 2068 6173   string that has
│ │ │ │ +00030db0: 2074 6f20 6265 2064 6561 6c6c 6f63 6174   to be deallocat
│ │ │ │ +00030dc0: 6564 2062 7920 7468 6520 6361 6c6c 6572  ed by the caller
│ │ │ │ +00030dd0: 2077 6974 6820 e280 9866 7265 6528 29e2   with ...free().
│ │ │ │ +00030de0: 8099 2e0a 0a73 6869 7368 695f 7072 696e  .....shishi_prin
│ │ │ │ +00030df0: 6369 7061 6c5f 6465 6661 756c 740a 2d2d  cipal_default.--
│ │ │ │  00030e00: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00030e10: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ -00030e20: 696f 6e3a 2063 6f6e 7374 2063 6861 7220  ion: const char 
│ │ │ │ -00030e30: 2a20 7368 6973 6869 5f70 7269 6e63 6970  * shishi_princip
│ │ │ │ -00030e40: 616c 5f64 6566 6175 6c74 2028 5368 6973  al_default (Shis
│ │ │ │ -00030e50: 6869 202a 2048 414e 444c 4529 0a20 2020  hi * HANDLE).   
│ │ │ │ -00030e60: 2020 4841 4e44 4c45 3a20 5368 6973 6869    HANDLE: Shishi
│ │ │ │ -00030e70: 206c 6962 7261 7279 2068 616e 646c 6520   library handle 
│ │ │ │ -00030e80: 6372 6561 7465 6420 6279 20e2 8098 7368  created by ...sh
│ │ │ │ -00030e90: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ -00030ea0: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -00030eb0: 6f6e 3a2a 2054 6865 2064 6566 6175 6c74  on:* The default
│ │ │ │ -00030ec0: 2070 7269 6e63 6970 616c 206e 616d 6520   principal name 
│ │ │ │ -00030ed0: 6973 2074 6865 206e 616d 6520 696e 2074  is the name in t
│ │ │ │ -00030ee0: 6865 0a20 2020 2020 656e 7669 726f 6e6d  he.     environm
│ │ │ │ -00030ef0: 656e 7420 7661 7269 6162 6c65 2055 5345  ent variable USE
│ │ │ │ -00030f00: 522c 206f 7220 4c4f 474e 414d 4520 666f  R, or LOGNAME fo
│ │ │ │ -00030f10: 7220 736f 6d65 2073 7973 7465 6d73 2c20  r some systems, 
│ │ │ │ -00030f20: 6275 7420 6974 2063 616e 0a20 2020 2020  but it can.     
│ │ │ │ -00030f30: 6265 206f 7665 7272 6964 6465 6e20 6279  be overridden by
│ │ │ │ -00030f40: 2073 7065 6369 6679 696e 6720 7468 6520   specifying the 
│ │ │ │ -00030f50: 656e 7669 726f 6e6d 656e 7420 7661 7269  environment vari
│ │ │ │ -00030f60: 6162 6c65 2053 4849 5348 495f 5553 4552  able SHISHI_USER
│ │ │ │ -00030f70: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ -00030f80: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ -00030f90: 7468 6520 6465 6661 756c 7420 7072 696e  the default prin
│ │ │ │ -00030fa0: 6369 7061 6c20 6e61 6d65 2075 7365 6420  cipal name used 
│ │ │ │ -00030fb0: 6279 2074 6865 0a20 2020 2020 6c69 6272  by the.     libr
│ │ │ │ -00030fc0: 6172 792e 2020 284e 6f74 2061 2063 6f70  ary.  (Not a cop
│ │ │ │ -00030fd0: 7920 6f66 2069 742c 2073 6f20 646f 6e27  y of it, so don'
│ │ │ │ -00030fe0: 7420 6d6f 6469 6679 206f 7220 6465 616c  t modify or deal
│ │ │ │ -00030ff0: 6c6f 6361 7465 2069 742e 290a 0a73 6869  locate it.)..shi
│ │ │ │ -00031000: 7368 695f 7072 696e 6369 7061 6c5f 6465  shi_principal_de
│ │ │ │ -00031010: 6661 756c 745f 7365 740a 2d2d 2d2d 2d2d  fault_set.------
│ │ │ │ +00030e10: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ +00030e20: 7469 6f6e 3a20 636f 6e73 7420 6368 6172  tion: const char
│ │ │ │ +00030e30: 202a 2073 6869 7368 695f 7072 696e 6369   * shishi_princi
│ │ │ │ +00030e40: 7061 6c5f 6465 6661 756c 7420 2853 6869  pal_default (Shi
│ │ │ │ +00030e50: 7368 6920 2a20 4841 4e44 4c45 290a 2020  shi * HANDLE).  
│ │ │ │ +00030e60: 2020 2048 414e 444c 453a 2053 6869 7368     HANDLE: Shish
│ │ │ │ +00030e70: 6920 6c69 6272 6172 7920 6861 6e64 6c65  i library handle
│ │ │ │ +00030e80: 2063 7265 6174 6564 2062 7920 e280 9873   created by ...s
│ │ │ │ +00030e90: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ +00030ea0: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ +00030eb0: 696f 6e3a 2a20 5468 6520 6465 6661 756c  ion:* The defaul
│ │ │ │ +00030ec0: 7420 7072 696e 6369 7061 6c20 6e61 6d65  t principal name
│ │ │ │ +00030ed0: 2069 7320 7468 6520 6e61 6d65 2069 6e20   is the name in 
│ │ │ │ +00030ee0: 7468 650a 2020 2020 2065 6e76 6972 6f6e  the.     environ
│ │ │ │ +00030ef0: 6d65 6e74 2076 6172 6961 626c 6520 5553  ment variable US
│ │ │ │ +00030f00: 4552 2c20 6f72 204c 4f47 4e41 4d45 2066  ER, or LOGNAME f
│ │ │ │ +00030f10: 6f72 2073 6f6d 6520 7379 7374 656d 732c  or some systems,
│ │ │ │ +00030f20: 2062 7574 2069 7420 6361 6e0a 2020 2020   but it can.    
│ │ │ │ +00030f30: 2062 6520 6f76 6572 7269 6464 656e 2062   be overridden b
│ │ │ │ +00030f40: 7920 7370 6563 6966 7969 6e67 2074 6865  y specifying the
│ │ │ │ +00030f50: 2065 6e76 6972 6f6e 6d65 6e74 2076 6172   environment var
│ │ │ │ +00030f60: 6961 626c 6520 5348 4953 4849 5f55 5345  iable SHISHI_USE
│ │ │ │ +00030f70: 522e 0a0a 2020 2020 202a 5265 7475 726e  R...     *Return
│ │ │ │ +00030f80: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ +00030f90: 2074 6865 2064 6566 6175 6c74 2070 7269   the default pri
│ │ │ │ +00030fa0: 6e63 6970 616c 206e 616d 6520 7573 6564  ncipal name used
│ │ │ │ +00030fb0: 2062 7920 7468 650a 2020 2020 206c 6962   by the.     lib
│ │ │ │ +00030fc0: 7261 7279 2e20 2028 4e6f 7420 6120 636f  rary.  (Not a co
│ │ │ │ +00030fd0: 7079 206f 6620 6974 2c20 736f 2064 6f6e  py of it, so don
│ │ │ │ +00030fe0: 2774 206d 6f64 6966 7920 6f72 2064 6561  't modify or dea
│ │ │ │ +00030ff0: 6c6c 6f63 6174 6520 6974 2e29 0a0a 7368  llocate it.)..sh
│ │ │ │ +00031000: 6973 6869 5f70 7269 6e63 6970 616c 5f64  ishi_principal_d
│ │ │ │ +00031010: 6566 6175 6c74 5f73 6574 0a2d 2d2d 2d2d  efault_set.-----
│ │ │ │  00031020: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00031030: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ -00031040: 7469 6f6e 3a20 766f 6964 2073 6869 7368  tion: void shish
│ │ │ │ -00031050: 695f 7072 696e 6369 7061 6c5f 6465 6661  i_principal_defa
│ │ │ │ -00031060: 756c 745f 7365 7420 2853 6869 7368 6920  ult_set (Shishi 
│ │ │ │ -00031070: 2a20 4841 4e44 4c45 2c0a 2020 2020 2020  * HANDLE,.      
│ │ │ │ -00031080: 2020 2020 636f 6e73 7420 6368 6172 202a      const char *
│ │ │ │ -00031090: 2050 5249 4e43 4950 414c 290a 2020 2020   PRINCIPAL).    
│ │ │ │ -000310a0: 2048 414e 444c 453a 2053 6869 7368 6920   HANDLE: Shishi 
│ │ │ │ -000310b0: 6c69 6272 6172 7920 6861 6e64 6c65 2063  library handle c
│ │ │ │ -000310c0: 7265 6174 6564 2062 7920 e280 9873 6869  reated by ...shi
│ │ │ │ -000310d0: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ -000310e0: 2020 2020 5052 494e 4349 5041 4c3a 2073      PRINCIPAL: s
│ │ │ │ -000310f0: 7472 696e 6720 7769 7468 206e 6577 2064  tring with new d
│ │ │ │ -00031100: 6566 6175 6c74 2070 7269 6e63 6970 616c  efault principal
│ │ │ │ -00031110: 206e 616d 652c 206f 7220 4e55 4c4c 2074   name, or NULL t
│ │ │ │ -00031120: 6f20 7265 7365 740a 2020 2020 2074 6f20  o reset.     to 
│ │ │ │ -00031130: 6465 6661 756c 742e 0a0a 2020 2020 202a  default...     *
│ │ │ │ -00031140: 4465 7363 7269 7074 696f 6e3a 2a20 5365  Description:* Se
│ │ │ │ -00031150: 7420 7468 6520 6465 6661 756c 7420 7072  t the default pr
│ │ │ │ -00031160: 696e 6369 7061 6c20 7573 6564 2062 7920  incipal used by 
│ │ │ │ -00031170: 7468 6520 6c69 6272 6172 792e 2020 5468  the library.  Th
│ │ │ │ -00031180: 650a 2020 2020 2073 7472 696e 6720 6973  e.     string is
│ │ │ │ -00031190: 2063 6f70 6965 6420 696e 746f 2074 6865   copied into the
│ │ │ │ -000311a0: 206c 6962 7261 7279 2c20 736f 2079 6f75   library, so you
│ │ │ │ -000311b0: 2063 616e 2064 6973 706f 7365 206f 6620   can dispose of 
│ │ │ │ -000311c0: 7468 650a 2020 2020 2076 6172 6961 626c  the.     variabl
│ │ │ │ -000311d0: 6520 696d 6d65 6469 6174 656c 7920 6166  e immediately af
│ │ │ │ -000311e0: 7465 7220 6361 6c6c 696e 6720 7468 6973  ter calling this
│ │ │ │ -000311f0: 2066 756e 6374 696f 6e2e 0a0a 7368 6973   function...shis
│ │ │ │ -00031200: 6869 5f70 6172 7365 5f6e 616d 650a 2d2d  hi_parse_name.--
│ │ │ │ -00031210: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -00031220: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ -00031230: 6e74 2073 6869 7368 695f 7061 7273 655f  nt shishi_parse_
│ │ │ │ -00031240: 6e61 6d65 2028 5368 6973 6869 202a 2048  name (Shishi * H
│ │ │ │ -00031250: 414e 444c 452c 2063 6f6e 7374 2063 6861  ANDLE, const cha
│ │ │ │ -00031260: 7220 2a20 4e41 4d45 2c0a 2020 2020 2020  r * NAME,.      
│ │ │ │ -00031270: 2020 2020 6368 6172 202a 2a20 5052 494e      char ** PRIN
│ │ │ │ -00031280: 4349 5041 4c2c 2063 6861 7220 2a2a 2052  CIPAL, char ** R
│ │ │ │ -00031290: 4541 4c4d 290a 2020 2020 2048 414e 444c  EALM).     HANDL
│ │ │ │ -000312a0: 453a 2053 6869 7368 6920 6c69 6272 6172  E: Shishi librar
│ │ │ │ -000312b0: 7920 6861 6e64 6c65 2063 7265 6174 6564  y handle created
│ │ │ │ -000312c0: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ -000312d0: 6974 2829 e280 992e 0a20 2020 2020 4e41  it().....     NA
│ │ │ │ -000312e0: 4d45 3a20 696e 7075 7420 7072 696e 6369  ME: input princi
│ │ │ │ -000312f0: 7061 6c20 6e61 6d65 2073 7472 696e 672c  pal name string,
│ │ │ │ -00031300: 2065 2e67 2e20 2069 6d61 702f 6d61 696c   e.g.  imap/mail
│ │ │ │ -00031310: 2e67 6e75 2e6f 7267 5c47 4e55 2e4f 5247  .gnu.org\GNU.ORG
│ │ │ │ -00031320: 2e0a 0a20 2020 2020 5052 494e 4349 5041  ...     PRINCIPA
│ │ │ │ -00031330: 4c3a 206e 6577 6c79 2061 6c6c 6f63 6174  L: newly allocat
│ │ │ │ -00031340: 6564 206f 7574 7075 7420 7374 7269 6e67  ed output string
│ │ │ │ -00031350: 2077 6974 6820 7072 696e 6369 7061 6c20   with principal 
│ │ │ │ -00031360: 6e61 6d65 2e0a 2020 2020 2052 4541 4c4d  name..     REALM
│ │ │ │ -00031370: 3a20 6e65 776c 7920 616c 6c6f 6361 7465  : newly allocate
│ │ │ │ -00031380: 6420 6f75 7470 7574 2073 7472 696e 6720  d output string 
│ │ │ │ -00031390: 7769 7468 2072 6561 6c6d 206e 616d 652e  with realm name.
│ │ │ │ -000313a0: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ -000313b0: 696f 6e3a 2a20 5370 6c69 7420 7072 696e  ion:* Split prin
│ │ │ │ -000313c0: 6369 7061 6c20 6e61 6d65 2028 652e 672e  cipal name (e.g.
│ │ │ │ -000313d0: 2c20 2273 696d 6f6e 5c4a 4f53 4546 5353  , "simon\JOSEFSS
│ │ │ │ -000313e0: 4f4e 2e4f 5247 2229 0a20 2020 2020 696e  ON.ORG").     in
│ │ │ │ -000313f0: 746f 2074 776f 206e 6577 6c79 2061 6c6c  to two newly all
│ │ │ │ -00031400: 6f63 6174 6564 2073 7472 696e 6773 2c20  ocated strings, 
│ │ │ │ -00031410: 7468 6520 5052 494e 4349 5041 4c20 2822  the PRINCIPAL ("
│ │ │ │ -00031420: 7369 6d6f 6e22 292c 2061 6e64 2074 6865  simon"), and the
│ │ │ │ -00031430: 0a20 2020 2020 5245 414c 4d20 2822 4a4f  .     REALM ("JO
│ │ │ │ -00031440: 5345 4653 534f 4e2e 4f52 4722 292e 2049  SEFSSON.ORG"). I
│ │ │ │ -00031450: 6620 7468 6572 6520 6973 206e 6f20 7265  f there is no re
│ │ │ │ -00031460: 616c 6d20 7061 7274 2069 6e20 4e41 4d45  alm part in NAME
│ │ │ │ -00031470: 2c20 5245 414c 4d0a 2020 2020 2069 7320  , REALM.     is 
│ │ │ │ -00031480: 7365 7420 746f 204e 554c 4c2e 0a0a 2020  set to NULL...  
│ │ │ │ -00031490: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ -000314a0: 3a2a 2052 6574 7572 6e73 2053 4849 5348  :* Returns SHISH
│ │ │ │ -000314b0: 495f 494e 5641 4c49 445f 5052 494e 4349  I_INVALID_PRINCI
│ │ │ │ -000314c0: 5041 4c5f 4e41 4d45 2069 6620 4e41 4d45  PAL_NAME if NAME
│ │ │ │ -000314d0: 2069 730a 2020 2020 204e 554c 4c20 6f72   is.     NULL or
│ │ │ │ -000314e0: 2065 6e64 7320 7769 7468 2074 6865 2065   ends with the e
│ │ │ │ -000314f0: 7363 6170 6520 6368 6172 6163 7465 7220  scape character 
│ │ │ │ -00031500: 225c 222c 2061 6e64 2053 4849 5348 495f  "\", and SHISHI_
│ │ │ │ -00031510: 4f4b 2069 660a 2020 2020 2073 7563 6365  OK if.     succe
│ │ │ │ -00031520: 7373 6675 6c2e 0a0a 7368 6973 6869 5f70  ssful...shishi_p
│ │ │ │ -00031530: 7269 6e63 6970 616c 5f6e 616d 650a 2d2d  rincipal_name.--
│ │ │ │ +00031030: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +00031040: 6374 696f 6e3a 2076 6f69 6420 7368 6973  ction: void shis
│ │ │ │ +00031050: 6869 5f70 7269 6e63 6970 616c 5f64 6566  hi_principal_def
│ │ │ │ +00031060: 6175 6c74 5f73 6574 2028 5368 6973 6869  ault_set (Shishi
│ │ │ │ +00031070: 202a 2048 414e 444c 452c 0a20 2020 2020   * HANDLE,.     
│ │ │ │ +00031080: 2020 2020 2063 6f6e 7374 2063 6861 7220       const char 
│ │ │ │ +00031090: 2a20 5052 494e 4349 5041 4c29 0a20 2020  * PRINCIPAL).   
│ │ │ │ +000310a0: 2020 4841 4e44 4c45 3a20 5368 6973 6869    HANDLE: Shishi
│ │ │ │ +000310b0: 206c 6962 7261 7279 2068 616e 646c 6520   library handle 
│ │ │ │ +000310c0: 6372 6561 7465 6420 6279 20e2 8098 7368  created by ...sh
│ │ │ │ +000310d0: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ +000310e0: 2020 2020 2050 5249 4e43 4950 414c 3a20       PRINCIPAL: 
│ │ │ │ +000310f0: 7374 7269 6e67 2077 6974 6820 6e65 7720  string with new 
│ │ │ │ +00031100: 6465 6661 756c 7420 7072 696e 6369 7061  default principa
│ │ │ │ +00031110: 6c20 6e61 6d65 2c20 6f72 204e 554c 4c20  l name, or NULL 
│ │ │ │ +00031120: 746f 2072 6573 6574 0a20 2020 2020 746f  to reset.     to
│ │ │ │ +00031130: 2064 6566 6175 6c74 2e0a 0a20 2020 2020   default...     
│ │ │ │ +00031140: 2a44 6573 6372 6970 7469 6f6e 3a2a 2053  *Description:* S
│ │ │ │ +00031150: 6574 2074 6865 2064 6566 6175 6c74 2070  et the default p
│ │ │ │ +00031160: 7269 6e63 6970 616c 2075 7365 6420 6279  rincipal used by
│ │ │ │ +00031170: 2074 6865 206c 6962 7261 7279 2e20 2054   the library.  T
│ │ │ │ +00031180: 6865 0a20 2020 2020 7374 7269 6e67 2069  he.     string i
│ │ │ │ +00031190: 7320 636f 7069 6564 2069 6e74 6f20 7468  s copied into th
│ │ │ │ +000311a0: 6520 6c69 6272 6172 792c 2073 6f20 796f  e library, so yo
│ │ │ │ +000311b0: 7520 6361 6e20 6469 7370 6f73 6520 6f66  u can dispose of
│ │ │ │ +000311c0: 2074 6865 0a20 2020 2020 7661 7269 6162   the.     variab
│ │ │ │ +000311d0: 6c65 2069 6d6d 6564 6961 7465 6c79 2061  le immediately a
│ │ │ │ +000311e0: 6674 6572 2063 616c 6c69 6e67 2074 6869  fter calling thi
│ │ │ │ +000311f0: 7320 6675 6e63 7469 6f6e 2e0a 0a73 6869  s function...shi
│ │ │ │ +00031200: 7368 695f 7061 7273 655f 6e61 6d65 0a2d  shi_parse_name.-
│ │ │ │ +00031210: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +00031220: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +00031230: 696e 7420 7368 6973 6869 5f70 6172 7365  int shishi_parse
│ │ │ │ +00031240: 5f6e 616d 6520 2853 6869 7368 6920 2a20  _name (Shishi * 
│ │ │ │ +00031250: 4841 4e44 4c45 2c20 636f 6e73 7420 6368  HANDLE, const ch
│ │ │ │ +00031260: 6172 202a 204e 414d 452c 0a20 2020 2020  ar * NAME,.     
│ │ │ │ +00031270: 2020 2020 2063 6861 7220 2a2a 2050 5249       char ** PRI
│ │ │ │ +00031280: 4e43 4950 414c 2c20 6368 6172 202a 2a20  NCIPAL, char ** 
│ │ │ │ +00031290: 5245 414c 4d29 0a20 2020 2020 4841 4e44  REALM).     HAND
│ │ │ │ +000312a0: 4c45 3a20 5368 6973 6869 206c 6962 7261  LE: Shishi libra
│ │ │ │ +000312b0: 7279 2068 616e 646c 6520 6372 6561 7465  ry handle create
│ │ │ │ +000312c0: 6420 6279 20e2 8098 7368 6973 6869 5f69  d by ...shishi_i
│ │ │ │ +000312d0: 6e69 7428 29e2 8099 2e0a 2020 2020 204e  nit().....     N
│ │ │ │ +000312e0: 414d 453a 2069 6e70 7574 2070 7269 6e63  AME: input princ
│ │ │ │ +000312f0: 6970 616c 206e 616d 6520 7374 7269 6e67  ipal name string
│ │ │ │ +00031300: 2c20 652e 672e 2020 696d 6170 2f6d 6169  , e.g.  imap/mai
│ │ │ │ +00031310: 6c2e 676e 752e 6f72 675c 474e 552e 4f52  l.gnu.org\GNU.OR
│ │ │ │ +00031320: 472e 0a0a 2020 2020 2050 5249 4e43 4950  G...     PRINCIP
│ │ │ │ +00031330: 414c 3a20 6e65 776c 7920 616c 6c6f 6361  AL: newly alloca
│ │ │ │ +00031340: 7465 6420 6f75 7470 7574 2073 7472 696e  ted output strin
│ │ │ │ +00031350: 6720 7769 7468 2070 7269 6e63 6970 616c  g with principal
│ │ │ │ +00031360: 206e 616d 652e 0a20 2020 2020 5245 414c   name..     REAL
│ │ │ │ +00031370: 4d3a 206e 6577 6c79 2061 6c6c 6f63 6174  M: newly allocat
│ │ │ │ +00031380: 6564 206f 7574 7075 7420 7374 7269 6e67  ed output string
│ │ │ │ +00031390: 2077 6974 6820 7265 616c 6d20 6e61 6d65   with realm name
│ │ │ │ +000313a0: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ +000313b0: 7469 6f6e 3a2a 2053 706c 6974 2070 7269  tion:* Split pri
│ │ │ │ +000313c0: 6e63 6970 616c 206e 616d 6520 2865 2e67  ncipal name (e.g
│ │ │ │ +000313d0: 2e2c 2022 7369 6d6f 6e5c 4a4f 5345 4653  ., "simon\JOSEFS
│ │ │ │ +000313e0: 534f 4e2e 4f52 4722 290a 2020 2020 2069  SON.ORG").     i
│ │ │ │ +000313f0: 6e74 6f20 7477 6f20 6e65 776c 7920 616c  nto two newly al
│ │ │ │ +00031400: 6c6f 6361 7465 6420 7374 7269 6e67 732c  located strings,
│ │ │ │ +00031410: 2074 6865 2050 5249 4e43 4950 414c 2028   the PRINCIPAL (
│ │ │ │ +00031420: 2273 696d 6f6e 2229 2c20 616e 6420 7468  "simon"), and th
│ │ │ │ +00031430: 650a 2020 2020 2052 4541 4c4d 2028 224a  e.     REALM ("J
│ │ │ │ +00031440: 4f53 4546 5353 4f4e 2e4f 5247 2229 2e20  OSEFSSON.ORG"). 
│ │ │ │ +00031450: 4966 2074 6865 7265 2069 7320 6e6f 2072  If there is no r
│ │ │ │ +00031460: 6561 6c6d 2070 6172 7420 696e 204e 414d  ealm part in NAM
│ │ │ │ +00031470: 452c 2052 4541 4c4d 0a20 2020 2020 6973  E, REALM.     is
│ │ │ │ +00031480: 2073 6574 2074 6f20 4e55 4c4c 2e0a 0a20   set to NULL... 
│ │ │ │ +00031490: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ +000314a0: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ +000314b0: 4849 5f49 4e56 414c 4944 5f50 5249 4e43  HI_INVALID_PRINC
│ │ │ │ +000314c0: 4950 414c 5f4e 414d 4520 6966 204e 414d  IPAL_NAME if NAM
│ │ │ │ +000314d0: 4520 6973 0a20 2020 2020 4e55 4c4c 206f  E is.     NULL o
│ │ │ │ +000314e0: 7220 656e 6473 2077 6974 6820 7468 6520  r ends with the 
│ │ │ │ +000314f0: 6573 6361 7065 2063 6861 7261 6374 6572  escape character
│ │ │ │ +00031500: 2022 5c22 2c20 616e 6420 5348 4953 4849   "\", and SHISHI
│ │ │ │ +00031510: 5f4f 4b20 6966 0a20 2020 2020 7375 6363  _OK if.     succ
│ │ │ │ +00031520: 6573 7366 756c 2e0a 0a73 6869 7368 695f  essful...shishi_
│ │ │ │ +00031530: 7072 696e 6369 7061 6c5f 6e61 6d65 0a2d  principal_name.-
│ │ │ │  00031540: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00031550: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ -00031560: 6e3a 2069 6e74 2073 6869 7368 695f 7072  n: int shishi_pr
│ │ │ │ -00031570: 696e 6369 7061 6c5f 6e61 6d65 2028 5368  incipal_name (Sh
│ │ │ │ -00031580: 6973 6869 202a 2048 414e 444c 452c 0a20  ishi * HANDLE,. 
│ │ │ │ -00031590: 2020 2020 2020 2020 2053 6869 7368 695f           Shishi_
│ │ │ │ -000315a0: 6173 6e31 204e 414d 454e 4f44 452c 2063  asn1 NAMENODE, c
│ │ │ │ -000315b0: 6f6e 7374 2063 6861 7220 2a20 4e41 4d45  onst char * NAME
│ │ │ │ -000315c0: 4649 454c 442c 2063 6861 7220 2a2a 204f  FIELD, char ** O
│ │ │ │ -000315d0: 5554 2c0a 2020 2020 2020 2020 2020 7369  UT,.          si
│ │ │ │ -000315e0: 7a65 5f74 202a 204f 5554 4c45 4e29 0a20  ze_t * OUTLEN). 
│ │ │ │ -000315f0: 2020 2020 4841 4e44 4c45 3a20 5368 6973      HANDLE: Shis
│ │ │ │ -00031600: 6869 206c 6962 7261 7279 2068 616e 646c  hi library handl
│ │ │ │ -00031610: 6520 6372 6561 7465 6420 6279 20e2 8098  e created by ...
│ │ │ │ -00031620: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ -00031630: 2e0a 2020 2020 204e 414d 454e 4f44 453a  ..     NAMENODE:
│ │ │ │ -00031640: 2041 534e 2e31 2073 7472 7563 7475 7265   ASN.1 structure
│ │ │ │ -00031650: 2077 6974 6820 7072 696e 6369 7061 6c20   with principal 
│ │ │ │ -00031660: 696e 204e 414d 4546 4945 4c44 2e0a 2020  in NAMEFIELD..  
│ │ │ │ -00031670: 2020 204e 414d 4546 4945 4c44 3a20 6e61     NAMEFIELD: na
│ │ │ │ -00031680: 6d65 206f 6620 6669 656c 6420 696e 204e  me of field in N
│ │ │ │ -00031690: 414d 454e 4f44 4520 636f 6e74 6169 6e69  AMENODE containi
│ │ │ │ -000316a0: 6e67 2070 7269 6e63 6970 616c 206e 616d  ng principal nam
│ │ │ │ -000316b0: 652e 0a20 2020 2020 4f55 543a 2070 6f69  e..     OUT: poi
│ │ │ │ -000316c0: 6e74 6572 2074 6f20 6e65 776c 7920 616c  nter to newly al
│ │ │ │ -000316d0: 6c6f 6361 7465 642c 206e 756c 6c20 7465  located, null te
│ │ │ │ -000316e0: 726d 696e 6174 6564 2c20 7374 7269 6e67  rminated, string
│ │ │ │ -000316f0: 2063 6f6e 7461 696e 696e 670a 2020 2020   containing.    
│ │ │ │ -00031700: 2070 7269 6e63 6970 616c 206e 616d 652e   principal name.
│ │ │ │ -00031710: 2020 4d61 7920 6265 20e2 8098 4e55 4c4c    May be ...NULL
│ │ │ │ -00031720: e280 9920 2874 6f20 6f6e 6c79 2070 6f70  ... (to only pop
│ │ │ │ -00031730: 756c 6174 6520 4f55 544c 454e 292e 0a20  ulate OUTLEN).. 
│ │ │ │ -00031740: 2020 2020 4f55 544c 454e 3a20 706f 696e      OUTLEN: poin
│ │ │ │ -00031750: 7465 7220 746f 206c 656e 6774 6820 6f66  ter to length of
│ │ │ │ -00031760: 204f 5554 206f 6e20 6f75 7470 7574 2c20   OUT on output, 
│ │ │ │ -00031770: 6578 636c 7564 696e 6720 7465 726d 696e  excluding termin
│ │ │ │ -00031780: 6174 696e 670a 2020 2020 206e 756c 6c2e  ating.     null.
│ │ │ │ -00031790: 2020 4d61 7920 6265 20e2 8098 4e55 4c4c    May be ...NULL
│ │ │ │ -000317a0: e280 9920 2874 6f20 6f6e 6c79 2070 6f70  ... (to only pop
│ │ │ │ -000317b0: 756c 6174 6520 4f55 5429 2e0a 0a20 2020  ulate OUT)...   
│ │ │ │ -000317c0: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ -000317d0: 2052 6570 7265 7365 6e74 2070 7269 6e63   Represent princ
│ │ │ │ -000317e0: 6970 616c 206e 616d 6520 696e 2041 534e  ipal name in ASN
│ │ │ │ -000317f0: 2e31 2073 7472 7563 7475 7265 2061 730a  .1 structure as.
│ │ │ │ -00031800: 2020 2020 206e 756c 6c2d 7465 726d 696e       null-termin
│ │ │ │ -00031810: 6174 6564 2073 7472 696e 672e 2020 5468  ated string.  Th
│ │ │ │ -00031820: 6520 7374 7269 6e67 2069 7320 616c 6c6f  e string is allo
│ │ │ │ -00031830: 6361 7465 6420 6279 2074 6869 7320 6675  cated by this fu
│ │ │ │ -00031840: 6e63 7469 6f6e 2c0a 2020 2020 2061 6e64  nction,.     and
│ │ │ │ -00031850: 2069 7420 6973 2074 6865 2072 6573 706f   it is the respo
│ │ │ │ -00031860: 6e73 6962 696c 6974 7920 6f66 2074 6865  nsibility of the
│ │ │ │ -00031870: 2063 616c 6c65 7220 746f 2064 6561 6c6c   caller to deall
│ │ │ │ -00031880: 6f63 6174 6520 6974 2e20 204e 6f74 650a  ocate it.  Note.
│ │ │ │ -00031890: 2020 2020 2074 6861 7420 7468 6520 6f75       that the ou
│ │ │ │ -000318a0: 7470 7574 206c 656e 6774 6820 4f55 544c  tput length OUTL
│ │ │ │ -000318b0: 454e 2064 6f65 7320 6e6f 7420 696e 636c  EN does not incl
│ │ │ │ -000318c0: 7564 6520 7468 6520 7465 726d 696e 6174  ude the terminat
│ │ │ │ -000318d0: 696e 670a 2020 2020 206e 756c 6c2e 0a0a  ing.     null...
│ │ │ │ -000318e0: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ -000318f0: 7565 3a2a 2052 6574 7572 6e73 2053 4849  ue:* Returns SHI
│ │ │ │ -00031900: 5348 495f 4f4b 2069 6620 7375 6363 6573  SHI_OK if succes
│ │ │ │ -00031910: 7366 756c 2e0a 0a73 6869 7368 695f 7072  sful...shishi_pr
│ │ │ │ -00031920: 696e 6369 7061 6c5f 6e61 6d65 5f72 6561  incipal_name_rea
│ │ │ │ -00031930: 6c6d 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  lm.-------------
│ │ │ │ -00031940: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -00031950: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ -00031960: 7420 7368 6973 6869 5f70 7269 6e63 6970  t shishi_princip
│ │ │ │ -00031970: 616c 5f6e 616d 655f 7265 616c 6d20 2853  al_name_realm (S
│ │ │ │ -00031980: 6869 7368 6920 2a20 4841 4e44 4c45 2c0a  hishi * HANDLE,.
│ │ │ │ -00031990: 2020 2020 2020 2020 2020 5368 6973 6869            Shishi
│ │ │ │ -000319a0: 5f61 736e 3120 4e41 4d45 4e4f 4445 2c20  _asn1 NAMENODE, 
│ │ │ │ -000319b0: 636f 6e73 7420 6368 6172 202a 204e 414d  const char * NAM
│ │ │ │ -000319c0: 4546 4945 4c44 2c0a 2020 2020 2020 2020  EFIELD,.        
│ │ │ │ -000319d0: 2020 5368 6973 6869 5f61 736e 3120 5245    Shishi_asn1 RE
│ │ │ │ -000319e0: 414c 4d4e 4f44 452c 2063 6f6e 7374 2063  ALMNODE, const c
│ │ │ │ -000319f0: 6861 7220 2a20 5245 414c 4d46 4945 4c44  har * REALMFIELD
│ │ │ │ -00031a00: 2c20 6368 6172 202a 2a20 4f55 542c 0a20  , char ** OUT,. 
│ │ │ │ -00031a10: 2020 2020 2020 2020 2073 697a 655f 7420           size_t 
│ │ │ │ -00031a20: 2a20 4f55 544c 454e 290a 2020 2020 2048  * OUTLEN).     H
│ │ │ │ -00031a30: 414e 444c 453a 2053 6869 7368 6920 6c69  ANDLE: Shishi li
│ │ │ │ -00031a40: 6272 6172 7920 6861 6e64 6c65 2063 7265  brary handle cre
│ │ │ │ -00031a50: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ -00031a60: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ -00031a70: 2020 4e41 4d45 4e4f 4445 3a20 4153 4e2e    NAMENODE: ASN.
│ │ │ │ -00031a80: 3120 7374 7275 6374 7572 6520 7769 7468  1 structure with
│ │ │ │ -00031a90: 2070 7269 6e63 6970 616c 206e 616d 6520   principal name 
│ │ │ │ -00031aa0: 696e 204e 414d 4546 4945 4c44 2e0a 2020  in NAMEFIELD..  
│ │ │ │ -00031ab0: 2020 204e 414d 4546 4945 4c44 3a20 6e61     NAMEFIELD: na
│ │ │ │ -00031ac0: 6d65 206f 6620 6669 656c 6420 696e 204e  me of field in N
│ │ │ │ -00031ad0: 414d 454e 4f44 4520 636f 6e74 6169 6e69  AMENODE containi
│ │ │ │ -00031ae0: 6e67 2070 7269 6e63 6970 616c 206e 616d  ng principal nam
│ │ │ │ -00031af0: 652e 0a20 2020 2020 5245 414c 4d4e 4f44  e..     REALMNOD
│ │ │ │ -00031b00: 453a 2041 534e 2e31 2073 7472 7563 7475  E: ASN.1 structu
│ │ │ │ -00031b10: 7265 2077 6974 6820 7072 696e 6369 7061  re with principa
│ │ │ │ -00031b20: 6c20 7265 616c 6d20 696e 2052 4541 4c4d  l realm in REALM
│ │ │ │ -00031b30: 4649 454c 442e 0a20 2020 2020 5245 414c  FIELD..     REAL
│ │ │ │ -00031b40: 4d46 4945 4c44 3a20 6e61 6d65 206f 6620  MFIELD: name of 
│ │ │ │ -00031b50: 6669 656c 6420 696e 2052 4541 4c4d 4e4f  field in REALMNO
│ │ │ │ -00031b60: 4445 2063 6f6e 7461 696e 696e 6720 7072  DE containing pr
│ │ │ │ -00031b70: 696e 6369 7061 6c20 7265 616c 6d2e 0a0a  incipal realm...
│ │ │ │ -00031b80: 2020 2020 204f 5554 3a20 706f 696e 7465       OUT: pointe
│ │ │ │ -00031b90: 7220 746f 206e 6577 6c79 2061 6c6c 6f63  r to newly alloc
│ │ │ │ -00031ba0: 6174 6564 206e 756c 6c20 7465 726d 696e  ated null termin
│ │ │ │ -00031bb0: 6174 6564 2073 7472 696e 6720 636f 6e74  ated string cont
│ │ │ │ -00031bc0: 6169 6e69 6e67 0a20 2020 2020 7072 696e  aining.     prin
│ │ │ │ -00031bd0: 6369 7061 6c20 6e61 6d65 2e20 204d 6179  cipal name.  May
│ │ │ │ -00031be0: 2062 6520 e280 984e 554c 4ce2 8099 2028   be ...NULL... (
│ │ │ │ -00031bf0: 746f 206f 6e6c 7920 706f 7075 6c61 7465  to only populate
│ │ │ │ -00031c00: 204f 5554 4c45 4e29 2e0a 2020 2020 204f   OUTLEN)..     O
│ │ │ │ -00031c10: 5554 4c45 4e3a 2070 6f69 6e74 6572 2074  UTLEN: pointer t
│ │ │ │ -00031c20: 6f20 6c65 6e67 7468 206f 6620 4f55 5420  o length of OUT 
│ │ │ │ -00031c30: 6f6e 206f 7574 7075 742c 2065 7863 6c75  on output, exclu
│ │ │ │ -00031c40: 6469 6e67 2074 6572 6d69 6e61 7469 6e67  ding terminating
│ │ │ │ -00031c50: 0a20 2020 2020 6e75 6c6c 2e20 204d 6179  .     null.  May
│ │ │ │ -00031c60: 2062 6520 e280 984e 554c 4ce2 8099 2028   be ...NULL... (
│ │ │ │ -00031c70: 746f 206f 6e6c 7920 706f 7075 6c61 7465  to only populate
│ │ │ │ -00031c80: 204f 5554 292e 0a0a 2020 2020 202a 4465   OUT)...     *De
│ │ │ │ -00031c90: 7363 7269 7074 696f 6e3a 2a20 5265 7072  scription:* Repr
│ │ │ │ -00031ca0: 6573 656e 7420 7072 696e 6369 7061 6c20  esent principal 
│ │ │ │ -00031cb0: 6e61 6d65 2061 6e64 2072 6561 6c6d 2069  name and realm i
│ │ │ │ -00031cc0: 6e20 4153 4e2e 310a 2020 2020 2073 7472  n ASN.1.     str
│ │ │ │ -00031cd0: 7563 7475 7265 2061 7320 6e75 6c6c 2d74  ucture as null-t
│ │ │ │ -00031ce0: 6572 6d69 6e61 7465 6420 7374 7269 6e67  erminated string
│ │ │ │ -00031cf0: 2e20 2054 6865 2073 7472 696e 6720 6973  .  The string is
│ │ │ │ -00031d00: 2061 6c6c 6f63 6174 6564 2062 790a 2020   allocated by.  
│ │ │ │ -00031d10: 2020 2074 6869 7320 6675 6e63 7469 6f6e     this function
│ │ │ │ -00031d20: 2e20 2049 7420 6973 2074 6865 2072 6573  .  It is the res
│ │ │ │ -00031d30: 706f 6e73 6962 696c 6974 7920 6f66 2074  ponsibility of t
│ │ │ │ -00031d40: 6865 2063 616c 6c65 7220 746f 0a20 2020  he caller to.   
│ │ │ │ -00031d50: 2020 6465 616c 6c6f 6361 7465 2069 742e    deallocate it.
│ │ │ │ -00031d60: 2020 4e6f 7465 2074 6861 7420 7468 6520    Note that the 
│ │ │ │ -00031d70: 6f75 7470 7574 206c 656e 6774 6820 4f55  output length OU
│ │ │ │ -00031d80: 544c 454e 2064 6f65 7320 6e6f 7420 696e  TLEN does not in
│ │ │ │ -00031d90: 636c 7564 650a 2020 2020 2074 6865 2074  clude.     the t
│ │ │ │ -00031da0: 6572 6d69 6e61 7469 6e67 206e 756c 6c20  erminating null 
│ │ │ │ -00031db0: 6368 6172 6163 7465 722e 0a0a 2020 2020  character...    
│ │ │ │ -00031dc0: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ -00031dd0: 2052 6574 7572 6e73 2053 4849 5348 495f   Returns SHISHI_
│ │ │ │ -00031de0: 4f4b 2069 6620 7375 6363 6573 7366 756c  OK if successful
│ │ │ │ -00031df0: 2e0a 0a73 6869 7368 695f 7072 696e 6369  ...shishi_princi
│ │ │ │ -00031e00: 7061 6c5f 6e61 6d65 5f73 6574 0a2d 2d2d  pal_name_set.---
│ │ │ │ +00031550: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ +00031560: 6f6e 3a20 696e 7420 7368 6973 6869 5f70  on: int shishi_p
│ │ │ │ +00031570: 7269 6e63 6970 616c 5f6e 616d 6520 2853  rincipal_name (S
│ │ │ │ +00031580: 6869 7368 6920 2a20 4841 4e44 4c45 2c0a  hishi * HANDLE,.
│ │ │ │ +00031590: 2020 2020 2020 2020 2020 5368 6973 6869            Shishi
│ │ │ │ +000315a0: 5f61 736e 3120 4e41 4d45 4e4f 4445 2c20  _asn1 NAMENODE, 
│ │ │ │ +000315b0: 636f 6e73 7420 6368 6172 202a 204e 414d  const char * NAM
│ │ │ │ +000315c0: 4546 4945 4c44 2c20 6368 6172 202a 2a20  EFIELD, char ** 
│ │ │ │ +000315d0: 4f55 542c 0a20 2020 2020 2020 2020 2073  OUT,.          s
│ │ │ │ +000315e0: 697a 655f 7420 2a20 4f55 544c 454e 290a  ize_t * OUTLEN).
│ │ │ │ +000315f0: 2020 2020 2048 414e 444c 453a 2053 6869       HANDLE: Shi
│ │ │ │ +00031600: 7368 6920 6c69 6272 6172 7920 6861 6e64  shi library hand
│ │ │ │ +00031610: 6c65 2063 7265 6174 6564 2062 7920 e280  le created by ..
│ │ │ │ +00031620: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ +00031630: 992e 0a20 2020 2020 4e41 4d45 4e4f 4445  ...     NAMENODE
│ │ │ │ +00031640: 3a20 4153 4e2e 3120 7374 7275 6374 7572  : ASN.1 structur
│ │ │ │ +00031650: 6520 7769 7468 2070 7269 6e63 6970 616c  e with principal
│ │ │ │ +00031660: 2069 6e20 4e41 4d45 4649 454c 442e 0a20   in NAMEFIELD.. 
│ │ │ │ +00031670: 2020 2020 4e41 4d45 4649 454c 443a 206e      NAMEFIELD: n
│ │ │ │ +00031680: 616d 6520 6f66 2066 6965 6c64 2069 6e20  ame of field in 
│ │ │ │ +00031690: 4e41 4d45 4e4f 4445 2063 6f6e 7461 696e  NAMENODE contain
│ │ │ │ +000316a0: 696e 6720 7072 696e 6369 7061 6c20 6e61  ing principal na
│ │ │ │ +000316b0: 6d65 2e0a 2020 2020 204f 5554 3a20 706f  me..     OUT: po
│ │ │ │ +000316c0: 696e 7465 7220 746f 206e 6577 6c79 2061  inter to newly a
│ │ │ │ +000316d0: 6c6c 6f63 6174 6564 2c20 6e75 6c6c 2074  llocated, null t
│ │ │ │ +000316e0: 6572 6d69 6e61 7465 642c 2073 7472 696e  erminated, strin
│ │ │ │ +000316f0: 6720 636f 6e74 6169 6e69 6e67 0a20 2020  g containing.   
│ │ │ │ +00031700: 2020 7072 696e 6369 7061 6c20 6e61 6d65    principal name
│ │ │ │ +00031710: 2e20 204d 6179 2062 6520 e280 984e 554c  .  May be ...NUL
│ │ │ │ +00031720: 4ce2 8099 2028 746f 206f 6e6c 7920 706f  L... (to only po
│ │ │ │ +00031730: 7075 6c61 7465 204f 5554 4c45 4e29 2e0a  pulate OUTLEN)..
│ │ │ │ +00031740: 2020 2020 204f 5554 4c45 4e3a 2070 6f69       OUTLEN: poi
│ │ │ │ +00031750: 6e74 6572 2074 6f20 6c65 6e67 7468 206f  nter to length o
│ │ │ │ +00031760: 6620 4f55 5420 6f6e 206f 7574 7075 742c  f OUT on output,
│ │ │ │ +00031770: 2065 7863 6c75 6469 6e67 2074 6572 6d69   excluding termi
│ │ │ │ +00031780: 6e61 7469 6e67 0a20 2020 2020 6e75 6c6c  nating.     null
│ │ │ │ +00031790: 2e20 204d 6179 2062 6520 e280 984e 554c  .  May be ...NUL
│ │ │ │ +000317a0: 4ce2 8099 2028 746f 206f 6e6c 7920 706f  L... (to only po
│ │ │ │ +000317b0: 7075 6c61 7465 204f 5554 292e 0a0a 2020  pulate OUT)...  
│ │ │ │ +000317c0: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ +000317d0: 2a20 5265 7072 6573 656e 7420 7072 696e  * Represent prin
│ │ │ │ +000317e0: 6369 7061 6c20 6e61 6d65 2069 6e20 4153  cipal name in AS
│ │ │ │ +000317f0: 4e2e 3120 7374 7275 6374 7572 6520 6173  N.1 structure as
│ │ │ │ +00031800: 0a20 2020 2020 6e75 6c6c 2d74 6572 6d69  .     null-termi
│ │ │ │ +00031810: 6e61 7465 6420 7374 7269 6e67 2e20 2054  nated string.  T
│ │ │ │ +00031820: 6865 2073 7472 696e 6720 6973 2061 6c6c  he string is all
│ │ │ │ +00031830: 6f63 6174 6564 2062 7920 7468 6973 2066  ocated by this f
│ │ │ │ +00031840: 756e 6374 696f 6e2c 0a20 2020 2020 616e  unction,.     an
│ │ │ │ +00031850: 6420 6974 2069 7320 7468 6520 7265 7370  d it is the resp
│ │ │ │ +00031860: 6f6e 7369 6269 6c69 7479 206f 6620 7468  onsibility of th
│ │ │ │ +00031870: 6520 6361 6c6c 6572 2074 6f20 6465 616c  e caller to deal
│ │ │ │ +00031880: 6c6f 6361 7465 2069 742e 2020 4e6f 7465  locate it.  Note
│ │ │ │ +00031890: 0a20 2020 2020 7468 6174 2074 6865 206f  .     that the o
│ │ │ │ +000318a0: 7574 7075 7420 6c65 6e67 7468 204f 5554  utput length OUT
│ │ │ │ +000318b0: 4c45 4e20 646f 6573 206e 6f74 2069 6e63  LEN does not inc
│ │ │ │ +000318c0: 6c75 6465 2074 6865 2074 6572 6d69 6e61  lude the termina
│ │ │ │ +000318d0: 7469 6e67 0a20 2020 2020 6e75 6c6c 2e0a  ting.     null..
│ │ │ │ +000318e0: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ +000318f0: 6c75 653a 2a20 5265 7475 726e 7320 5348  lue:* Returns SH
│ │ │ │ +00031900: 4953 4849 5f4f 4b20 6966 2073 7563 6365  ISHI_OK if succe
│ │ │ │ +00031910: 7373 6675 6c2e 0a0a 7368 6973 6869 5f70  ssful...shishi_p
│ │ │ │ +00031920: 7269 6e63 6970 616c 5f6e 616d 655f 7265  rincipal_name_re
│ │ │ │ +00031930: 616c 6d0a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  alm.------------
│ │ │ │ +00031940: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +00031950: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ +00031960: 6e74 2073 6869 7368 695f 7072 696e 6369  nt shishi_princi
│ │ │ │ +00031970: 7061 6c5f 6e61 6d65 5f72 6561 6c6d 2028  pal_name_realm (
│ │ │ │ +00031980: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ +00031990: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ +000319a0: 695f 6173 6e31 204e 414d 454e 4f44 452c  i_asn1 NAMENODE,
│ │ │ │ +000319b0: 2063 6f6e 7374 2063 6861 7220 2a20 4e41   const char * NA
│ │ │ │ +000319c0: 4d45 4649 454c 442c 0a20 2020 2020 2020  MEFIELD,.       
│ │ │ │ +000319d0: 2020 2053 6869 7368 695f 6173 6e31 2052     Shishi_asn1 R
│ │ │ │ +000319e0: 4541 4c4d 4e4f 4445 2c20 636f 6e73 7420  EALMNODE, const 
│ │ │ │ +000319f0: 6368 6172 202a 2052 4541 4c4d 4649 454c  char * REALMFIEL
│ │ │ │ +00031a00: 442c 2063 6861 7220 2a2a 204f 5554 2c0a  D, char ** OUT,.
│ │ │ │ +00031a10: 2020 2020 2020 2020 2020 7369 7a65 5f74            size_t
│ │ │ │ +00031a20: 202a 204f 5554 4c45 4e29 0a20 2020 2020   * OUTLEN).     
│ │ │ │ +00031a30: 4841 4e44 4c45 3a20 5368 6973 6869 206c  HANDLE: Shishi l
│ │ │ │ +00031a40: 6962 7261 7279 2068 616e 646c 6520 6372  ibrary handle cr
│ │ │ │ +00031a50: 6561 7465 6420 6279 20e2 8098 7368 6973  eated by ...shis
│ │ │ │ +00031a60: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ +00031a70: 2020 204e 414d 454e 4f44 453a 2041 534e     NAMENODE: ASN
│ │ │ │ +00031a80: 2e31 2073 7472 7563 7475 7265 2077 6974  .1 structure wit
│ │ │ │ +00031a90: 6820 7072 696e 6369 7061 6c20 6e61 6d65  h principal name
│ │ │ │ +00031aa0: 2069 6e20 4e41 4d45 4649 454c 442e 0a20   in NAMEFIELD.. 
│ │ │ │ +00031ab0: 2020 2020 4e41 4d45 4649 454c 443a 206e      NAMEFIELD: n
│ │ │ │ +00031ac0: 616d 6520 6f66 2066 6965 6c64 2069 6e20  ame of field in 
│ │ │ │ +00031ad0: 4e41 4d45 4e4f 4445 2063 6f6e 7461 696e  NAMENODE contain
│ │ │ │ +00031ae0: 696e 6720 7072 696e 6369 7061 6c20 6e61  ing principal na
│ │ │ │ +00031af0: 6d65 2e0a 2020 2020 2052 4541 4c4d 4e4f  me..     REALMNO
│ │ │ │ +00031b00: 4445 3a20 4153 4e2e 3120 7374 7275 6374  DE: ASN.1 struct
│ │ │ │ +00031b10: 7572 6520 7769 7468 2070 7269 6e63 6970  ure with princip
│ │ │ │ +00031b20: 616c 2072 6561 6c6d 2069 6e20 5245 414c  al realm in REAL
│ │ │ │ +00031b30: 4d46 4945 4c44 2e0a 2020 2020 2052 4541  MFIELD..     REA
│ │ │ │ +00031b40: 4c4d 4649 454c 443a 206e 616d 6520 6f66  LMFIELD: name of
│ │ │ │ +00031b50: 2066 6965 6c64 2069 6e20 5245 414c 4d4e   field in REALMN
│ │ │ │ +00031b60: 4f44 4520 636f 6e74 6169 6e69 6e67 2070  ODE containing p
│ │ │ │ +00031b70: 7269 6e63 6970 616c 2072 6561 6c6d 2e0a  rincipal realm..
│ │ │ │ +00031b80: 0a20 2020 2020 4f55 543a 2070 6f69 6e74  .     OUT: point
│ │ │ │ +00031b90: 6572 2074 6f20 6e65 776c 7920 616c 6c6f  er to newly allo
│ │ │ │ +00031ba0: 6361 7465 6420 6e75 6c6c 2074 6572 6d69  cated null termi
│ │ │ │ +00031bb0: 6e61 7465 6420 7374 7269 6e67 2063 6f6e  nated string con
│ │ │ │ +00031bc0: 7461 696e 696e 670a 2020 2020 2070 7269  taining.     pri
│ │ │ │ +00031bd0: 6e63 6970 616c 206e 616d 652e 2020 4d61  ncipal name.  Ma
│ │ │ │ +00031be0: 7920 6265 20e2 8098 4e55 4c4c e280 9920  y be ...NULL... 
│ │ │ │ +00031bf0: 2874 6f20 6f6e 6c79 2070 6f70 756c 6174  (to only populat
│ │ │ │ +00031c00: 6520 4f55 544c 454e 292e 0a20 2020 2020  e OUTLEN)..     
│ │ │ │ +00031c10: 4f55 544c 454e 3a20 706f 696e 7465 7220  OUTLEN: pointer 
│ │ │ │ +00031c20: 746f 206c 656e 6774 6820 6f66 204f 5554  to length of OUT
│ │ │ │ +00031c30: 206f 6e20 6f75 7470 7574 2c20 6578 636c   on output, excl
│ │ │ │ +00031c40: 7564 696e 6720 7465 726d 696e 6174 696e  uding terminatin
│ │ │ │ +00031c50: 670a 2020 2020 206e 756c 6c2e 2020 4d61  g.     null.  Ma
│ │ │ │ +00031c60: 7920 6265 20e2 8098 4e55 4c4c e280 9920  y be ...NULL... 
│ │ │ │ +00031c70: 2874 6f20 6f6e 6c79 2070 6f70 756c 6174  (to only populat
│ │ │ │ +00031c80: 6520 4f55 5429 2e0a 0a20 2020 2020 2a44  e OUT)...     *D
│ │ │ │ +00031c90: 6573 6372 6970 7469 6f6e 3a2a 2052 6570  escription:* Rep
│ │ │ │ +00031ca0: 7265 7365 6e74 2070 7269 6e63 6970 616c  resent principal
│ │ │ │ +00031cb0: 206e 616d 6520 616e 6420 7265 616c 6d20   name and realm 
│ │ │ │ +00031cc0: 696e 2041 534e 2e31 0a20 2020 2020 7374  in ASN.1.     st
│ │ │ │ +00031cd0: 7275 6374 7572 6520 6173 206e 756c 6c2d  ructure as null-
│ │ │ │ +00031ce0: 7465 726d 696e 6174 6564 2073 7472 696e  terminated strin
│ │ │ │ +00031cf0: 672e 2020 5468 6520 7374 7269 6e67 2069  g.  The string i
│ │ │ │ +00031d00: 7320 616c 6c6f 6361 7465 6420 6279 0a20  s allocated by. 
│ │ │ │ +00031d10: 2020 2020 7468 6973 2066 756e 6374 696f      this functio
│ │ │ │ +00031d20: 6e2e 2020 4974 2069 7320 7468 6520 7265  n.  It is the re
│ │ │ │ +00031d30: 7370 6f6e 7369 6269 6c69 7479 206f 6620  sponsibility of 
│ │ │ │ +00031d40: 7468 6520 6361 6c6c 6572 2074 6f0a 2020  the caller to.  
│ │ │ │ +00031d50: 2020 2064 6561 6c6c 6f63 6174 6520 6974     deallocate it
│ │ │ │ +00031d60: 2e20 204e 6f74 6520 7468 6174 2074 6865  .  Note that the
│ │ │ │ +00031d70: 206f 7574 7075 7420 6c65 6e67 7468 204f   output length O
│ │ │ │ +00031d80: 5554 4c45 4e20 646f 6573 206e 6f74 2069  UTLEN does not i
│ │ │ │ +00031d90: 6e63 6c75 6465 0a20 2020 2020 7468 6520  nclude.     the 
│ │ │ │ +00031da0: 7465 726d 696e 6174 696e 6720 6e75 6c6c  terminating null
│ │ │ │ +00031db0: 2063 6861 7261 6374 6572 2e0a 0a20 2020   character...   
│ │ │ │ +00031dc0: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ +00031dd0: 2a20 5265 7475 726e 7320 5348 4953 4849  * Returns SHISHI
│ │ │ │ +00031de0: 5f4f 4b20 6966 2073 7563 6365 7373 6675  _OK if successfu
│ │ │ │ +00031df0: 6c2e 0a0a 7368 6973 6869 5f70 7269 6e63  l...shishi_princ
│ │ │ │ +00031e00: 6970 616c 5f6e 616d 655f 7365 740a 2d2d  ipal_name_set.--
│ │ │ │  00031e10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00031e20: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ -00031e30: 7469 6f6e 3a20 696e 7420 7368 6973 6869  tion: int shishi
│ │ │ │ -00031e40: 5f70 7269 6e63 6970 616c 5f6e 616d 655f  _principal_name_
│ │ │ │ -00031e50: 7365 7420 2853 6869 7368 6920 2a20 4841  set (Shishi * HA
│ │ │ │ -00031e60: 4e44 4c45 2c0a 2020 2020 2020 2020 2020  NDLE,.          
│ │ │ │ -00031e70: 5368 6973 6869 5f61 736e 3120 4e41 4d45  Shishi_asn1 NAME
│ │ │ │ -00031e80: 4e4f 4445 2c20 636f 6e73 7420 6368 6172  NODE, const char
│ │ │ │ -00031e90: 202a 204e 414d 4546 4945 4c44 2c0a 2020   * NAMEFIELD,.  
│ │ │ │ -00031ea0: 2020 2020 2020 2020 5368 6973 6869 5f6e          Shishi_n
│ │ │ │ -00031eb0: 616d 655f 7479 7065 204e 414d 455f 5459  ame_type NAME_TY
│ │ │ │ -00031ec0: 5045 2c20 636f 6e73 7420 6368 6172 202a  PE, const char *
│ │ │ │ -00031ed0: 204e 414d 455b 5d29 0a20 2020 2020 4841   NAME[]).     HA
│ │ │ │ -00031ee0: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ -00031ef0: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ -00031f00: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ -00031f10: 6974 2829 e280 992e 0a20 2020 2020 4e41  it().....     NA
│ │ │ │ -00031f20: 4d45 4e4f 4445 3a20 4153 4e2e 3120 7374  MENODE: ASN.1 st
│ │ │ │ -00031f30: 7275 6374 7572 6520 7769 7468 2070 7269  ructure with pri
│ │ │ │ -00031f40: 6e63 6970 616c 2069 6e20 4e41 4d45 4649  ncipal in NAMEFI
│ │ │ │ -00031f50: 454c 442e 0a20 2020 2020 4e41 4d45 4649  ELD..     NAMEFI
│ │ │ │ -00031f60: 454c 443a 206e 616d 6520 6f66 2066 6965  ELD: name of fie
│ │ │ │ -00031f70: 6c64 2069 6e20 4e41 4d45 4e4f 4445 2063  ld in NAMENODE c
│ │ │ │ -00031f80: 6f6e 7461 696e 696e 6720 7072 696e 6369  ontaining princi
│ │ │ │ -00031f90: 7061 6c20 6e61 6d65 2e0a 2020 2020 204e  pal name..     N
│ │ │ │ -00031fa0: 414d 455f 5459 5045 3a20 7479 7065 206f  AME_TYPE: type o
│ │ │ │ -00031fb0: 6620 7072 696e 6369 7061 6c2c 2073 6565  f principal, see
│ │ │ │ -00031fc0: 2053 6869 7368 695f 6e61 6d65 5f74 7970   Shishi_name_typ
│ │ │ │ -00031fd0: 652c 2075 7375 616c 6c79 0a20 2020 2020  e, usually.     
│ │ │ │ -00031fe0: 5348 4953 4849 5f4e 545f 554e 4b4e 4f57  SHISHI_NT_UNKNOW
│ │ │ │ -00031ff0: 4e2e 0a20 2020 2020 4e41 4d45 3a20 6e75  N..     NAME: nu
│ │ │ │ -00032000: 6c6c 2d74 6572 6d69 6e61 7465 6420 696e  ll-terminated in
│ │ │ │ -00032010: 7075 7420 6172 7261 7920 7769 7468 2070  put array with p
│ │ │ │ -00032020: 7269 6e63 6970 616c 206e 616d 652e 0a0a  rincipal name...
│ │ │ │ -00032030: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ -00032040: 6e3a 2a20 5365 7420 7468 6520 6769 7665  n:* Set the give
│ │ │ │ -00032050: 6e20 7072 696e 6369 7061 6c20 6e61 6d65  n principal name
│ │ │ │ -00032060: 2066 6965 6c64 2074 6f20 7468 6520 6769   field to the gi
│ │ │ │ -00032070: 7665 6e0a 2020 2020 206e 616d 652e 0a0a  ven.     name...
│ │ │ │ -00032080: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ -00032090: 7565 3a2a 2052 6574 7572 6e73 2053 4849  ue:* Returns SHI
│ │ │ │ -000320a0: 5348 495f 4f4b 2069 6620 7375 6363 6573  SHI_OK if succes
│ │ │ │ -000320b0: 7366 756c 2e0a 0a73 6869 7368 695f 7072  sful...shishi_pr
│ │ │ │ -000320c0: 696e 6369 7061 6c5f 7365 740a 2d2d 2d2d  incipal_set.----
│ │ │ │ +00031e20: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +00031e30: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ +00031e40: 695f 7072 696e 6369 7061 6c5f 6e61 6d65  i_principal_name
│ │ │ │ +00031e50: 5f73 6574 2028 5368 6973 6869 202a 2048  _set (Shishi * H
│ │ │ │ +00031e60: 414e 444c 452c 0a20 2020 2020 2020 2020  ANDLE,.         
│ │ │ │ +00031e70: 2053 6869 7368 695f 6173 6e31 204e 414d   Shishi_asn1 NAM
│ │ │ │ +00031e80: 454e 4f44 452c 2063 6f6e 7374 2063 6861  ENODE, const cha
│ │ │ │ +00031e90: 7220 2a20 4e41 4d45 4649 454c 442c 0a20  r * NAMEFIELD,. 
│ │ │ │ +00031ea0: 2020 2020 2020 2020 2053 6869 7368 695f           Shishi_
│ │ │ │ +00031eb0: 6e61 6d65 5f74 7970 6520 4e41 4d45 5f54  name_type NAME_T
│ │ │ │ +00031ec0: 5950 452c 2063 6f6e 7374 2063 6861 7220  YPE, const char 
│ │ │ │ +00031ed0: 2a20 4e41 4d45 5b5d 290a 2020 2020 2048  * NAME[]).     H
│ │ │ │ +00031ee0: 414e 444c 453a 2073 6869 7368 6920 6861  ANDLE: shishi ha
│ │ │ │ +00031ef0: 6e64 6c65 2061 7320 616c 6c6f 6361 7465  ndle as allocate
│ │ │ │ +00031f00: 6420 6279 20e2 8098 7368 6973 6869 5f69  d by ...shishi_i
│ │ │ │ +00031f10: 6e69 7428 29e2 8099 2e0a 2020 2020 204e  nit().....     N
│ │ │ │ +00031f20: 414d 454e 4f44 453a 2041 534e 2e31 2073  AMENODE: ASN.1 s
│ │ │ │ +00031f30: 7472 7563 7475 7265 2077 6974 6820 7072  tructure with pr
│ │ │ │ +00031f40: 696e 6369 7061 6c20 696e 204e 414d 4546  incipal in NAMEF
│ │ │ │ +00031f50: 4945 4c44 2e0a 2020 2020 204e 414d 4546  IELD..     NAMEF
│ │ │ │ +00031f60: 4945 4c44 3a20 6e61 6d65 206f 6620 6669  IELD: name of fi
│ │ │ │ +00031f70: 656c 6420 696e 204e 414d 454e 4f44 4520  eld in NAMENODE 
│ │ │ │ +00031f80: 636f 6e74 6169 6e69 6e67 2070 7269 6e63  containing princ
│ │ │ │ +00031f90: 6970 616c 206e 616d 652e 0a20 2020 2020  ipal name..     
│ │ │ │ +00031fa0: 4e41 4d45 5f54 5950 453a 2074 7970 6520  NAME_TYPE: type 
│ │ │ │ +00031fb0: 6f66 2070 7269 6e63 6970 616c 2c20 7365  of principal, se
│ │ │ │ +00031fc0: 6520 5368 6973 6869 5f6e 616d 655f 7479  e Shishi_name_ty
│ │ │ │ +00031fd0: 7065 2c20 7573 7561 6c6c 790a 2020 2020  pe, usually.    
│ │ │ │ +00031fe0: 2053 4849 5348 495f 4e54 5f55 4e4b 4e4f   SHISHI_NT_UNKNO
│ │ │ │ +00031ff0: 574e 2e0a 2020 2020 204e 414d 453a 206e  WN..     NAME: n
│ │ │ │ +00032000: 756c 6c2d 7465 726d 696e 6174 6564 2069  ull-terminated i
│ │ │ │ +00032010: 6e70 7574 2061 7272 6179 2077 6974 6820  nput array with 
│ │ │ │ +00032020: 7072 696e 6369 7061 6c20 6e61 6d65 2e0a  principal name..
│ │ │ │ +00032030: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +00032040: 6f6e 3a2a 2053 6574 2074 6865 2067 6976  on:* Set the giv
│ │ │ │ +00032050: 656e 2070 7269 6e63 6970 616c 206e 616d  en principal nam
│ │ │ │ +00032060: 6520 6669 656c 6420 746f 2074 6865 2067  e field to the g
│ │ │ │ +00032070: 6976 656e 0a20 2020 2020 6e61 6d65 2e0a  iven.     name..
│ │ │ │ +00032080: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ +00032090: 6c75 653a 2a20 5265 7475 726e 7320 5348  lue:* Returns SH
│ │ │ │ +000320a0: 4953 4849 5f4f 4b20 6966 2073 7563 6365  ISHI_OK if succe
│ │ │ │ +000320b0: 7373 6675 6c2e 0a0a 7368 6973 6869 5f70  ssful...shishi_p
│ │ │ │ +000320c0: 7269 6e63 6970 616c 5f73 6574 0a2d 2d2d  rincipal_set.---
│ │ │ │  000320d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000320e0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ -000320f0: 696e 7420 7368 6973 6869 5f70 7269 6e63  int shishi_princ
│ │ │ │ -00032100: 6970 616c 5f73 6574 2028 5368 6973 6869  ipal_set (Shishi
│ │ │ │ -00032110: 202a 2048 414e 444c 452c 0a20 2020 2020   * HANDLE,.     
│ │ │ │ -00032120: 2020 2020 2053 6869 7368 695f 6173 6e31       Shishi_asn1
│ │ │ │ -00032130: 204e 414d 454e 4f44 452c 2063 6f6e 7374   NAMENODE, const
│ │ │ │ -00032140: 2063 6861 7220 2a20 4e41 4d45 4649 454c   char * NAMEFIEL
│ │ │ │ -00032150: 442c 0a20 2020 2020 2020 2020 2063 6f6e  D,.          con
│ │ │ │ -00032160: 7374 2063 6861 7220 2a20 4e41 4d45 290a  st char * NAME).
│ │ │ │ -00032170: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ -00032180: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ -00032190: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ -000321a0: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ -000321b0: 2020 2020 204e 414d 454e 4f44 453a 2041       NAMENODE: A
│ │ │ │ -000321c0: 534e 2e31 2073 7472 7563 7475 7265 2077  SN.1 structure w
│ │ │ │ -000321d0: 6974 6820 7072 696e 6369 7061 6c20 696e  ith principal in
│ │ │ │ -000321e0: 204e 414d 4546 4945 4c44 2e0a 2020 2020   NAMEFIELD..    
│ │ │ │ -000321f0: 204e 414d 4546 4945 4c44 3a20 6e61 6d65   NAMEFIELD: name
│ │ │ │ -00032200: 206f 6620 6669 656c 6420 696e 204e 414d   of field in NAM
│ │ │ │ -00032210: 454e 4f44 4520 636f 6e74 6169 6e69 6e67  ENODE containing
│ │ │ │ -00032220: 2070 7269 6e63 6970 616c 206e 616d 652e   principal name.
│ │ │ │ -00032230: 0a20 2020 2020 4e41 4d45 3a20 6e75 6c6c  .     NAME: null
│ │ │ │ -00032240: 2d74 6572 6d69 6e61 7465 6420 7374 7269  -terminated stri
│ │ │ │ -00032250: 6e67 2077 6974 6820 7072 696e 6369 7061  ng with principa
│ │ │ │ -00032260: 6c20 6e61 6d65 2069 6e20 5246 4320 3139  l name in RFC 19
│ │ │ │ -00032270: 3634 2066 6f72 6d2e 0a0a 2020 2020 202a  64 form...     *
│ │ │ │ -00032280: 4465 7363 7269 7074 696f 6e3a 2a20 5365  Description:* Se
│ │ │ │ -00032290: 7420 7072 696e 6369 7061 6c20 6e61 6d65  t principal name
│ │ │ │ -000322a0: 2066 6965 6c64 2069 6e20 616e 2041 534e   field in an ASN
│ │ │ │ -000322b0: 2e31 2073 7472 7563 7475 7265 2074 6f0a  .1 structure to.
│ │ │ │ -000322c0: 2020 2020 2074 6865 2067 6976 656e 206e       the given n
│ │ │ │ -000322d0: 616d 652e 0a0a 2020 2020 202a 5265 7475  ame...     *Retu
│ │ │ │ -000322e0: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ -000322f0: 6e73 2053 4849 5348 495f 4f4b 2069 6620  ns SHISHI_OK if 
│ │ │ │ -00032300: 7375 6363 6573 7366 756c 2e0a 0a73 6869  successful...shi
│ │ │ │ -00032310: 7368 695f 6465 7269 7665 5f64 6566 6175  shi_derive_defau
│ │ │ │ -00032320: 6c74 5f73 616c 740a 2d2d 2d2d 2d2d 2d2d  lt_salt.--------
│ │ │ │ +000320e0: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ +000320f0: 2069 6e74 2073 6869 7368 695f 7072 696e   int shishi_prin
│ │ │ │ +00032100: 6369 7061 6c5f 7365 7420 2853 6869 7368  cipal_set (Shish
│ │ │ │ +00032110: 6920 2a20 4841 4e44 4c45 2c0a 2020 2020  i * HANDLE,.    
│ │ │ │ +00032120: 2020 2020 2020 5368 6973 6869 5f61 736e        Shishi_asn
│ │ │ │ +00032130: 3120 4e41 4d45 4e4f 4445 2c20 636f 6e73  1 NAMENODE, cons
│ │ │ │ +00032140: 7420 6368 6172 202a 204e 414d 4546 4945  t char * NAMEFIE
│ │ │ │ +00032150: 4c44 2c0a 2020 2020 2020 2020 2020 636f  LD,.          co
│ │ │ │ +00032160: 6e73 7420 6368 6172 202a 204e 414d 4529  nst char * NAME)
│ │ │ │ +00032170: 0a20 2020 2020 4841 4e44 4c45 3a20 7368  .     HANDLE: sh
│ │ │ │ +00032180: 6973 6869 2068 616e 646c 6520 6173 2061  ishi handle as a
│ │ │ │ +00032190: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ +000321a0: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ +000321b0: 0a20 2020 2020 4e41 4d45 4e4f 4445 3a20  .     NAMENODE: 
│ │ │ │ +000321c0: 4153 4e2e 3120 7374 7275 6374 7572 6520  ASN.1 structure 
│ │ │ │ +000321d0: 7769 7468 2070 7269 6e63 6970 616c 2069  with principal i
│ │ │ │ +000321e0: 6e20 4e41 4d45 4649 454c 442e 0a20 2020  n NAMEFIELD..   
│ │ │ │ +000321f0: 2020 4e41 4d45 4649 454c 443a 206e 616d    NAMEFIELD: nam
│ │ │ │ +00032200: 6520 6f66 2066 6965 6c64 2069 6e20 4e41  e of field in NA
│ │ │ │ +00032210: 4d45 4e4f 4445 2063 6f6e 7461 696e 696e  MENODE containin
│ │ │ │ +00032220: 6720 7072 696e 6369 7061 6c20 6e61 6d65  g principal name
│ │ │ │ +00032230: 2e0a 2020 2020 204e 414d 453a 206e 756c  ..     NAME: nul
│ │ │ │ +00032240: 6c2d 7465 726d 696e 6174 6564 2073 7472  l-terminated str
│ │ │ │ +00032250: 696e 6720 7769 7468 2070 7269 6e63 6970  ing with princip
│ │ │ │ +00032260: 616c 206e 616d 6520 696e 2052 4643 2031  al name in RFC 1
│ │ │ │ +00032270: 3936 3420 666f 726d 2e0a 0a20 2020 2020  964 form...     
│ │ │ │ +00032280: 2a44 6573 6372 6970 7469 6f6e 3a2a 2053  *Description:* S
│ │ │ │ +00032290: 6574 2070 7269 6e63 6970 616c 206e 616d  et principal nam
│ │ │ │ +000322a0: 6520 6669 656c 6420 696e 2061 6e20 4153  e field in an AS
│ │ │ │ +000322b0: 4e2e 3120 7374 7275 6374 7572 6520 746f  N.1 structure to
│ │ │ │ +000322c0: 0a20 2020 2020 7468 6520 6769 7665 6e20  .     the given 
│ │ │ │ +000322d0: 6e61 6d65 2e0a 0a20 2020 2020 2a52 6574  name...     *Ret
│ │ │ │ +000322e0: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ +000322f0: 726e 7320 5348 4953 4849 5f4f 4b20 6966  rns SHISHI_OK if
│ │ │ │ +00032300: 2073 7563 6365 7373 6675 6c2e 0a0a 7368   successful...sh
│ │ │ │ +00032310: 6973 6869 5f64 6572 6976 655f 6465 6661  ishi_derive_defa
│ │ │ │ +00032320: 756c 745f 7361 6c74 0a2d 2d2d 2d2d 2d2d  ult_salt.-------
│ │ │ │  00032330: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00032340: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ -00032350: 3a20 696e 7420 7368 6973 6869 5f64 6572  : int shishi_der
│ │ │ │ -00032360: 6976 655f 6465 6661 756c 745f 7361 6c74  ive_default_salt
│ │ │ │ -00032370: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ -00032380: 452c 0a20 2020 2020 2020 2020 2063 6f6e  E,.          con
│ │ │ │ -00032390: 7374 2063 6861 7220 2a20 4e41 4d45 2c20  st char * NAME, 
│ │ │ │ -000323a0: 6368 6172 202a 2a20 5341 4c54 290a 2020  char ** SALT).  
│ │ │ │ -000323b0: 2020 2048 414e 444c 453a 2073 6869 7368     HANDLE: shish
│ │ │ │ -000323c0: 6920 6861 6e64 6c65 2061 7320 616c 6c6f  i handle as allo
│ │ │ │ -000323d0: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ -000323e0: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ -000323f0: 2020 204e 414d 453a 2070 7269 6e63 6970     NAME: princip
│ │ │ │ -00032400: 616c 206e 616d 6520 6f66 2075 7365 722e  al name of user.
│ │ │ │ -00032410: 0a20 2020 2020 5341 4c54 3a20 6f75 7470  .     SALT: outp
│ │ │ │ -00032420: 7574 2076 6172 6961 626c 6520 7769 7468  ut variable with
│ │ │ │ -00032430: 206e 6577 6c79 2061 6c6c 6f63 6174 6564   newly allocated
│ │ │ │ -00032440: 2073 616c 7420 7374 7269 6e67 2e0a 0a20   salt string... 
│ │ │ │ -00032450: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -00032460: 3a2a 2044 6572 6976 6520 7468 6520 6465  :* Derive the de
│ │ │ │ -00032470: 6661 756c 7420 7361 6c74 2066 726f 6d20  fault salt from 
│ │ │ │ -00032480: 6120 7072 696e 6369 7061 6c2e 2020 5468  a principal.  Th
│ │ │ │ -00032490: 650a 2020 2020 2064 6566 6175 6c74 2073  e.     default s
│ │ │ │ -000324a0: 616c 7420 6973 2074 6865 2063 6f6e 6361  alt is the conca
│ │ │ │ -000324b0: 7465 6e61 7469 6f6e 206f 6620 7468 6520  tenation of the 
│ │ │ │ -000324c0: 6465 636f 6465 6420 7265 616c 6d20 616e  decoded realm an
│ │ │ │ -000324d0: 6420 7468 650a 2020 2020 2070 7269 6e63  d the.     princ
│ │ │ │ -000324e0: 6970 616c 2e0a 0a20 2020 2020 2a52 6574  ipal...     *Ret
│ │ │ │ -000324f0: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ -00032500: 726e 2053 4849 5348 495f 4f4b 2069 6620  rn SHISHI_OK if 
│ │ │ │ -00032510: 7375 6363 6573 7366 756c 2e0a 0a73 6869  successful...shi
│ │ │ │ -00032520: 7368 695f 7365 7276 6572 5f66 6f72 5f6c  shi_server_for_l
│ │ │ │ -00032530: 6f63 616c 5f73 6572 7669 6365 0a2d 2d2d  ocal_service.---
│ │ │ │ +00032340: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ +00032350: 6e3a 2069 6e74 2073 6869 7368 695f 6465  n: int shishi_de
│ │ │ │ +00032360: 7269 7665 5f64 6566 6175 6c74 5f73 616c  rive_default_sal
│ │ │ │ +00032370: 7420 2853 6869 7368 6920 2a20 4841 4e44  t (Shishi * HAND
│ │ │ │ +00032380: 4c45 2c0a 2020 2020 2020 2020 2020 636f  LE,.          co
│ │ │ │ +00032390: 6e73 7420 6368 6172 202a 204e 414d 452c  nst char * NAME,
│ │ │ │ +000323a0: 2063 6861 7220 2a2a 2053 414c 5429 0a20   char ** SALT). 
│ │ │ │ +000323b0: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ +000323c0: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ +000323d0: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ +000323e0: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ +000323f0: 2020 2020 4e41 4d45 3a20 7072 696e 6369      NAME: princi
│ │ │ │ +00032400: 7061 6c20 6e61 6d65 206f 6620 7573 6572  pal name of user
│ │ │ │ +00032410: 2e0a 2020 2020 2053 414c 543a 206f 7574  ..     SALT: out
│ │ │ │ +00032420: 7075 7420 7661 7269 6162 6c65 2077 6974  put variable wit
│ │ │ │ +00032430: 6820 6e65 776c 7920 616c 6c6f 6361 7465  h newly allocate
│ │ │ │ +00032440: 6420 7361 6c74 2073 7472 696e 672e 0a0a  d salt string...
│ │ │ │ +00032450: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ +00032460: 6e3a 2a20 4465 7269 7665 2074 6865 2064  n:* Derive the d
│ │ │ │ +00032470: 6566 6175 6c74 2073 616c 7420 6672 6f6d  efault salt from
│ │ │ │ +00032480: 2061 2070 7269 6e63 6970 616c 2e20 2054   a principal.  T
│ │ │ │ +00032490: 6865 0a20 2020 2020 6465 6661 756c 7420  he.     default 
│ │ │ │ +000324a0: 7361 6c74 2069 7320 7468 6520 636f 6e63  salt is the conc
│ │ │ │ +000324b0: 6174 656e 6174 696f 6e20 6f66 2074 6865  atenation of the
│ │ │ │ +000324c0: 2064 6563 6f64 6564 2072 6561 6c6d 2061   decoded realm a
│ │ │ │ +000324d0: 6e64 2074 6865 0a20 2020 2020 7072 696e  nd the.     prin
│ │ │ │ +000324e0: 6369 7061 6c2e 0a0a 2020 2020 202a 5265  cipal...     *Re
│ │ │ │ +000324f0: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ +00032500: 7572 6e20 5348 4953 4849 5f4f 4b20 6966  urn SHISHI_OK if
│ │ │ │ +00032510: 2073 7563 6365 7373 6675 6c2e 0a0a 7368   successful...sh
│ │ │ │ +00032520: 6973 6869 5f73 6572 7665 725f 666f 725f  ishi_server_for_
│ │ │ │ +00032530: 6c6f 6361 6c5f 7365 7276 6963 650a 2d2d  local_service.--
│ │ │ │  00032540: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00032550: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ -00032560: 2d20 4675 6e63 7469 6f6e 3a20 6368 6172  - Function: char
│ │ │ │ -00032570: 202a 2073 6869 7368 695f 7365 7276 6572   * shishi_server
│ │ │ │ -00032580: 5f66 6f72 5f6c 6f63 616c 5f73 6572 7669  _for_local_servi
│ │ │ │ -00032590: 6365 2028 5368 6973 6869 202a 2048 414e  ce (Shishi * HAN
│ │ │ │ -000325a0: 444c 452c 0a20 2020 2020 2020 2020 2063  DLE,.          c
│ │ │ │ -000325b0: 6f6e 7374 2063 6861 7220 2a20 5345 5256  onst char * SERV
│ │ │ │ -000325c0: 4943 4529 0a20 2020 2020 4841 4e44 4c45  ICE).     HANDLE
│ │ │ │ -000325d0: 3a20 7368 6973 6869 2068 616e 646c 6520  : shishi handle 
│ │ │ │ -000325e0: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ -000325f0: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ -00032600: e280 992e 0a20 2020 2020 5345 5256 4943  .....     SERVIC
│ │ │ │ -00032610: 453a 206e 756c 6c20 7465 726d 696e 6174  E: null terminat
│ │ │ │ -00032620: 6564 2073 7472 696e 6720 7769 7468 206e  ed string with n
│ │ │ │ -00032630: 616d 6520 6f66 2073 6572 7669 6365 2c20  ame of service, 
│ │ │ │ -00032640: 652e 672e 2c20 2268 6f73 7422 2e0a 0a20  e.g., "host"... 
│ │ │ │ -00032650: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -00032660: 3a2a 2043 6f6e 7374 7275 6374 2061 2073  :* Construct a s
│ │ │ │ -00032670: 6572 7669 6365 2070 7269 6e63 6970 616c  ervice principal
│ │ │ │ -00032680: 2028 652e 672e 2c0a 2020 2020 2022 696d   (e.g.,.     "im
│ │ │ │ -00032690: 6170 2f79 7861 2e65 7874 756e 6f2e 636f  ap/yxa.extuno.co
│ │ │ │ -000326a0: 6d22 2920 6261 7365 6420 6f6e 2073 7570  m") based on sup
│ │ │ │ -000326b0: 706c 6965 6420 7365 7276 6963 6520 6e61  plied service na
│ │ │ │ -000326c0: 6d65 2028 692e 652e 2c0a 2020 2020 2022  me (i.e.,.     "
│ │ │ │ -000326d0: 696d 6170 2229 2061 6e64 2074 6865 2073  imap") and the s
│ │ │ │ -000326e0: 7973 7465 6d27 7320 686f 7374 6e61 6d65  ystem's hostname
│ │ │ │ -000326f0: 2061 7320 7265 7475 726e 6564 2062 7920   as returned by 
│ │ │ │ -00032700: e280 9868 6f73 746e 616d 6528 29e2 8099  ...hostname()...
│ │ │ │ -00032710: 0a20 2020 2020 2869 2e65 2e2c 2022 7978  .     (i.e., "yx
│ │ │ │ -00032720: 612e 6578 7475 6e64 6f2e 636f 6d22 292e  a.extundo.com").
│ │ │ │ -00032730: 2020 5468 6520 7374 7269 6e67 206d 7573    The string mus
│ │ │ │ -00032740: 7420 6265 2064 6561 6c6c 6f63 6174 6564  t be deallocated
│ │ │ │ -00032750: 2062 7920 7468 650a 2020 2020 2063 616c   by the.     cal
│ │ │ │ -00032760: 6c65 722e 0a0a 2020 2020 202a 5265 7475  ler...     *Retu
│ │ │ │ -00032770: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ -00032780: 6e20 6e65 776c 7920 616c 6c6f 6361 7465  n newly allocate
│ │ │ │ -00032790: 6420 7365 7276 6963 6520 6e61 6d65 2073  d service name s
│ │ │ │ -000327a0: 7472 696e 672e 0a0a 7368 6973 6869 5f61  tring...shishi_a
│ │ │ │ -000327b0: 7574 686f 7269 7a65 5f73 7472 636d 700a  uthorize_strcmp.
│ │ │ │ -000327c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000327d0: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ -000327e0: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ -000327f0: 695f 6175 7468 6f72 697a 655f 7374 7263  i_authorize_strc
│ │ │ │ -00032800: 6d70 2028 5368 6973 6869 202a 2048 414e  mp (Shishi * HAN
│ │ │ │ -00032810: 444c 452c 0a20 2020 2020 2020 2020 2063  DLE,.          c
│ │ │ │ -00032820: 6f6e 7374 2063 6861 7220 2a20 5052 494e  onst char * PRIN
│ │ │ │ -00032830: 4349 5041 4c2c 2063 6f6e 7374 2063 6861  CIPAL, const cha
│ │ │ │ -00032840: 7220 2a20 4155 5448 5a4e 414d 4529 0a20  r * AUTHZNAME). 
│ │ │ │ -00032850: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ -00032860: 6869 2068 616e 646c 6520 616c 6c6f 6361  hi handle alloca
│ │ │ │ -00032870: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ -00032880: 5f69 6e69 7428 29e2 8099 2e0a 2020 2020  _init().....    
│ │ │ │ -00032890: 2050 5249 4e43 4950 414c 3a20 7374 7269   PRINCIPAL: stri
│ │ │ │ -000328a0: 6e67 2077 6974 6820 6465 7369 7265 6420  ng with desired 
│ │ │ │ -000328b0: 7072 696e 6369 7061 6c20 6e61 6d65 2e0a  principal name..
│ │ │ │ -000328c0: 2020 2020 2041 5554 485a 4e41 4d45 3a20       AUTHZNAME: 
│ │ │ │ -000328d0: 6175 7468 6f72 697a 6174 696f 6e20 6e61  authorization na
│ │ │ │ -000328e0: 6d65 2e0a 0a20 2020 2020 2a44 6573 6372  me...     *Descr
│ │ │ │ -000328f0: 6970 7469 6f6e 3a2a 2041 7574 686f 7269  iption:* Authori
│ │ │ │ -00032900: 7a61 7469 6f6e 206f 6620 4155 5448 5a4e  zation of AUTHZN
│ │ │ │ -00032910: 414d 4520 6167 6169 6e73 7420 6465 7369  AME against desi
│ │ │ │ -00032920: 7265 6420 5052 494e 4349 5041 4c0a 2020  red PRINCIPAL.  
│ │ │ │ -00032930: 2020 2061 6363 6f72 6469 6e67 2074 6f20     according to 
│ │ │ │ -00032940: 2262 6173 6963 2220 6175 7468 656e 7469  "basic" authenti
│ │ │ │ -00032950: 6361 7469 6f6e 2c20 692e 652e 2c20 7465  cation, i.e., te
│ │ │ │ -00032960: 7374 696e 6720 666f 7220 6964 656e 7469  sting for identi
│ │ │ │ -00032970: 6361 6c0a 2020 2020 2073 7472 696e 6773  cal.     strings
│ │ │ │ -00032980: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ -00032990: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ -000329a0: 3120 6966 2041 5554 485a 4e41 4d45 2069  1 if AUTHZNAME i
│ │ │ │ -000329b0: 7320 6175 7468 6f72 697a 6564 2066 6f72  s authorized for
│ │ │ │ -000329c0: 2073 6572 7669 6365 730a 2020 2020 2062   services.     b
│ │ │ │ -000329d0: 7920 7468 6520 656e 6372 7970 7465 6420  y the encrypted 
│ │ │ │ -000329e0: 7072 696e 6369 7061 6c2c 2061 6e64 2030  principal, and 0
│ │ │ │ -000329f0: 206f 7468 6572 7769 7365 2e0a 0a73 6869   otherwise...shi
│ │ │ │ -00032a00: 7368 695f 6175 7468 6f72 697a 655f 6b35  shi_authorize_k5
│ │ │ │ -00032a10: 6c6f 6769 6e0a 2d2d 2d2d 2d2d 2d2d 2d2d  login.----------
│ │ │ │ -00032a20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -00032a30: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ -00032a40: 7420 7368 6973 6869 5f61 7574 686f 7269  t shishi_authori
│ │ │ │ -00032a50: 7a65 5f6b 356c 6f67 696e 2028 5368 6973  ze_k5login (Shis
│ │ │ │ -00032a60: 6869 202a 2048 414e 444c 452c 0a20 2020  hi * HANDLE,.   
│ │ │ │ -00032a70: 2020 2020 2020 2063 6f6e 7374 2063 6861         const cha
│ │ │ │ -00032a80: 7220 2a20 5052 494e 4349 5041 4c2c 2063  r * PRINCIPAL, c
│ │ │ │ -00032a90: 6f6e 7374 2063 6861 7220 2a20 4155 5448  onst char * AUTH
│ │ │ │ -00032aa0: 5a4e 414d 4529 0a20 2020 2020 4841 4e44  ZNAME).     HAND
│ │ │ │ -00032ab0: 4c45 3a20 7368 6973 6869 2068 616e 646c  LE: shishi handl
│ │ │ │ -00032ac0: 6520 616c 6c6f 6361 7465 6420 6279 20e2  e allocated by .
│ │ │ │ -00032ad0: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ -00032ae0: 8099 2e0a 2020 2020 2050 5249 4e43 4950  ....     PRINCIP
│ │ │ │ -00032af0: 414c 3a20 7374 7269 6e67 2077 6974 6820  AL: string with 
│ │ │ │ -00032b00: 6465 7369 7265 6420 7072 696e 6369 7061  desired principa
│ │ │ │ -00032b10: 6c20 6e61 6d65 2061 6e64 2072 6561 6c6d  l name and realm
│ │ │ │ -00032b20: 2e0a 2020 2020 2041 5554 485a 4e41 4d45  ..     AUTHZNAME
│ │ │ │ -00032b30: 3a20 6175 7468 6f72 697a 6174 696f 6e20  : authorization 
│ │ │ │ -00032b40: 6e61 6d65 2e0a 0a20 2020 2020 2a44 6573  name...     *Des
│ │ │ │ -00032b50: 6372 6970 7469 6f6e 3a2a 2041 7574 686f  cription:* Autho
│ │ │ │ -00032b60: 7269 7a61 7469 6f6e 206f 6620 4155 5448  rization of AUTH
│ │ │ │ -00032b70: 5a4e 414d 4520 6167 6169 6e73 7420 6465  ZNAME against de
│ │ │ │ -00032b80: 7369 7265 6420 5052 494e 4349 5041 4c0a  sired PRINCIPAL.
│ │ │ │ -00032b90: 2020 2020 2069 6e20 6163 636f 7264 616e       in accordan
│ │ │ │ -00032ba0: 6365 2077 6974 6820 7468 6520 4d49 542f  ce with the MIT/
│ │ │ │ -00032bb0: 4865 696d 6461 6c20 6175 7468 6f72 697a  Heimdal authoriz
│ │ │ │ -00032bc0: 6174 696f 6e20 6d65 7468 6f64 2e0a 0a20  ation method... 
│ │ │ │ -00032bd0: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ -00032be0: 653a 2a20 5265 7475 726e 7320 3120 6966  e:* Returns 1 if
│ │ │ │ -00032bf0: 2041 5554 485a 4e41 4d45 2069 7320 6175   AUTHZNAME is au
│ │ │ │ -00032c00: 7468 6f72 697a 6564 2066 6f72 2073 6572  thorized for ser
│ │ │ │ -00032c10: 7669 6365 730a 2020 2020 2062 7920 5052  vices.     by PR
│ │ │ │ -00032c20: 494e 4349 5041 4c2c 2061 6e64 2072 6574  INCIPAL, and ret
│ │ │ │ -00032c30: 7572 6e73 2030 206f 7468 6572 7769 7365  urns 0 otherwise
│ │ │ │ -00032c40: 2e0a 0a73 6869 7368 695f 6175 7468 6f72  ...shishi_author
│ │ │ │ -00032c50: 697a 6174 696f 6e5f 7061 7273 650a 2d2d  ization_parse.--
│ │ │ │ +00032550: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ +00032560: 2d2d 2046 756e 6374 696f 6e3a 2063 6861  -- Function: cha
│ │ │ │ +00032570: 7220 2a20 7368 6973 6869 5f73 6572 7665  r * shishi_serve
│ │ │ │ +00032580: 725f 666f 725f 6c6f 6361 6c5f 7365 7276  r_for_local_serv
│ │ │ │ +00032590: 6963 6520 2853 6869 7368 6920 2a20 4841  ice (Shishi * HA
│ │ │ │ +000325a0: 4e44 4c45 2c0a 2020 2020 2020 2020 2020  NDLE,.          
│ │ │ │ +000325b0: 636f 6e73 7420 6368 6172 202a 2053 4552  const char * SER
│ │ │ │ +000325c0: 5649 4345 290a 2020 2020 2048 414e 444c  VICE).     HANDL
│ │ │ │ +000325d0: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ +000325e0: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ +000325f0: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ +00032600: 29e2 8099 2e0a 2020 2020 2053 4552 5649  ).....     SERVI
│ │ │ │ +00032610: 4345 3a20 6e75 6c6c 2074 6572 6d69 6e61  CE: null termina
│ │ │ │ +00032620: 7465 6420 7374 7269 6e67 2077 6974 6820  ted string with 
│ │ │ │ +00032630: 6e61 6d65 206f 6620 7365 7276 6963 652c  name of service,
│ │ │ │ +00032640: 2065 2e67 2e2c 2022 686f 7374 222e 0a0a   e.g., "host"...
│ │ │ │ +00032650: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ +00032660: 6e3a 2a20 436f 6e73 7472 7563 7420 6120  n:* Construct a 
│ │ │ │ +00032670: 7365 7276 6963 6520 7072 696e 6369 7061  service principa
│ │ │ │ +00032680: 6c20 2865 2e67 2e2c 0a20 2020 2020 2269  l (e.g.,.     "i
│ │ │ │ +00032690: 6d61 702f 7978 612e 6578 7475 6e6f 2e63  map/yxa.extuno.c
│ │ │ │ +000326a0: 6f6d 2229 2062 6173 6564 206f 6e20 7375  om") based on su
│ │ │ │ +000326b0: 7070 6c69 6564 2073 6572 7669 6365 206e  pplied service n
│ │ │ │ +000326c0: 616d 6520 2869 2e65 2e2c 0a20 2020 2020  ame (i.e.,.     
│ │ │ │ +000326d0: 2269 6d61 7022 2920 616e 6420 7468 6520  "imap") and the 
│ │ │ │ +000326e0: 7379 7374 656d 2773 2068 6f73 746e 616d  system's hostnam
│ │ │ │ +000326f0: 6520 6173 2072 6574 7572 6e65 6420 6279  e as returned by
│ │ │ │ +00032700: 20e2 8098 686f 7374 6e61 6d65 2829 e280   ...hostname()..
│ │ │ │ +00032710: 990a 2020 2020 2028 692e 652e 2c20 2279  ..     (i.e., "y
│ │ │ │ +00032720: 7861 2e65 7874 756e 646f 2e63 6f6d 2229  xa.extundo.com")
│ │ │ │ +00032730: 2e20 2054 6865 2073 7472 696e 6720 6d75  .  The string mu
│ │ │ │ +00032740: 7374 2062 6520 6465 616c 6c6f 6361 7465  st be deallocate
│ │ │ │ +00032750: 6420 6279 2074 6865 0a20 2020 2020 6361  d by the.     ca
│ │ │ │ +00032760: 6c6c 6572 2e0a 0a20 2020 2020 2a52 6574  ller...     *Ret
│ │ │ │ +00032770: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ +00032780: 726e 206e 6577 6c79 2061 6c6c 6f63 6174  rn newly allocat
│ │ │ │ +00032790: 6564 2073 6572 7669 6365 206e 616d 6520  ed service name 
│ │ │ │ +000327a0: 7374 7269 6e67 2e0a 0a73 6869 7368 695f  string...shishi_
│ │ │ │ +000327b0: 6175 7468 6f72 697a 655f 7374 7263 6d70  authorize_strcmp
│ │ │ │ +000327c0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ +000327d0: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ +000327e0: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ +000327f0: 6869 5f61 7574 686f 7269 7a65 5f73 7472  hi_authorize_str
│ │ │ │ +00032800: 636d 7020 2853 6869 7368 6920 2a20 4841  cmp (Shishi * HA
│ │ │ │ +00032810: 4e44 4c45 2c0a 2020 2020 2020 2020 2020  NDLE,.          
│ │ │ │ +00032820: 636f 6e73 7420 6368 6172 202a 2050 5249  const char * PRI
│ │ │ │ +00032830: 4e43 4950 414c 2c20 636f 6e73 7420 6368  NCIPAL, const ch
│ │ │ │ +00032840: 6172 202a 2041 5554 485a 4e41 4d45 290a  ar * AUTHZNAME).
│ │ │ │ +00032850: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ +00032860: 7368 6920 6861 6e64 6c65 2061 6c6c 6f63  shi handle alloc
│ │ │ │ +00032870: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ +00032880: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ +00032890: 2020 5052 494e 4349 5041 4c3a 2073 7472    PRINCIPAL: str
│ │ │ │ +000328a0: 696e 6720 7769 7468 2064 6573 6972 6564  ing with desired
│ │ │ │ +000328b0: 2070 7269 6e63 6970 616c 206e 616d 652e   principal name.
│ │ │ │ +000328c0: 0a20 2020 2020 4155 5448 5a4e 414d 453a  .     AUTHZNAME:
│ │ │ │ +000328d0: 2061 7574 686f 7269 7a61 7469 6f6e 206e   authorization n
│ │ │ │ +000328e0: 616d 652e 0a0a 2020 2020 202a 4465 7363  ame...     *Desc
│ │ │ │ +000328f0: 7269 7074 696f 6e3a 2a20 4175 7468 6f72  ription:* Author
│ │ │ │ +00032900: 697a 6174 696f 6e20 6f66 2041 5554 485a  ization of AUTHZ
│ │ │ │ +00032910: 4e41 4d45 2061 6761 696e 7374 2064 6573  NAME against des
│ │ │ │ +00032920: 6972 6564 2050 5249 4e43 4950 414c 0a20  ired PRINCIPAL. 
│ │ │ │ +00032930: 2020 2020 6163 636f 7264 696e 6720 746f      according to
│ │ │ │ +00032940: 2022 6261 7369 6322 2061 7574 6865 6e74   "basic" authent
│ │ │ │ +00032950: 6963 6174 696f 6e2c 2069 2e65 2e2c 2074  ication, i.e., t
│ │ │ │ +00032960: 6573 7469 6e67 2066 6f72 2069 6465 6e74  esting for ident
│ │ │ │ +00032970: 6963 616c 0a20 2020 2020 7374 7269 6e67  ical.     string
│ │ │ │ +00032980: 732e 0a0a 2020 2020 202a 5265 7475 726e  s...     *Return
│ │ │ │ +00032990: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ +000329a0: 2031 2069 6620 4155 5448 5a4e 414d 4520   1 if AUTHZNAME 
│ │ │ │ +000329b0: 6973 2061 7574 686f 7269 7a65 6420 666f  is authorized fo
│ │ │ │ +000329c0: 7220 7365 7276 6963 6573 0a20 2020 2020  r services.     
│ │ │ │ +000329d0: 6279 2074 6865 2065 6e63 7279 7074 6564  by the encrypted
│ │ │ │ +000329e0: 2070 7269 6e63 6970 616c 2c20 616e 6420   principal, and 
│ │ │ │ +000329f0: 3020 6f74 6865 7277 6973 652e 0a0a 7368  0 otherwise...sh
│ │ │ │ +00032a00: 6973 6869 5f61 7574 686f 7269 7a65 5f6b  ishi_authorize_k
│ │ │ │ +00032a10: 356c 6f67 696e 0a2d 2d2d 2d2d 2d2d 2d2d  5login.---------
│ │ │ │ +00032a20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +00032a30: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ +00032a40: 6e74 2073 6869 7368 695f 6175 7468 6f72  nt shishi_author
│ │ │ │ +00032a50: 697a 655f 6b35 6c6f 6769 6e20 2853 6869  ize_k5login (Shi
│ │ │ │ +00032a60: 7368 6920 2a20 4841 4e44 4c45 2c0a 2020  shi * HANDLE,.  
│ │ │ │ +00032a70: 2020 2020 2020 2020 636f 6e73 7420 6368          const ch
│ │ │ │ +00032a80: 6172 202a 2050 5249 4e43 4950 414c 2c20  ar * PRINCIPAL, 
│ │ │ │ +00032a90: 636f 6e73 7420 6368 6172 202a 2041 5554  const char * AUT
│ │ │ │ +00032aa0: 485a 4e41 4d45 290a 2020 2020 2048 414e  HZNAME).     HAN
│ │ │ │ +00032ab0: 444c 453a 2073 6869 7368 6920 6861 6e64  DLE: shishi hand
│ │ │ │ +00032ac0: 6c65 2061 6c6c 6f63 6174 6564 2062 7920  le allocated by 
│ │ │ │ +00032ad0: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ +00032ae0: e280 992e 0a20 2020 2020 5052 494e 4349  .....     PRINCI
│ │ │ │ +00032af0: 5041 4c3a 2073 7472 696e 6720 7769 7468  PAL: string with
│ │ │ │ +00032b00: 2064 6573 6972 6564 2070 7269 6e63 6970   desired princip
│ │ │ │ +00032b10: 616c 206e 616d 6520 616e 6420 7265 616c  al name and real
│ │ │ │ +00032b20: 6d2e 0a20 2020 2020 4155 5448 5a4e 414d  m..     AUTHZNAM
│ │ │ │ +00032b30: 453a 2061 7574 686f 7269 7a61 7469 6f6e  E: authorization
│ │ │ │ +00032b40: 206e 616d 652e 0a0a 2020 2020 202a 4465   name...     *De
│ │ │ │ +00032b50: 7363 7269 7074 696f 6e3a 2a20 4175 7468  scription:* Auth
│ │ │ │ +00032b60: 6f72 697a 6174 696f 6e20 6f66 2041 5554  orization of AUT
│ │ │ │ +00032b70: 485a 4e41 4d45 2061 6761 696e 7374 2064  HZNAME against d
│ │ │ │ +00032b80: 6573 6972 6564 2050 5249 4e43 4950 414c  esired PRINCIPAL
│ │ │ │ +00032b90: 0a20 2020 2020 696e 2061 6363 6f72 6461  .     in accorda
│ │ │ │ +00032ba0: 6e63 6520 7769 7468 2074 6865 204d 4954  nce with the MIT
│ │ │ │ +00032bb0: 2f48 6569 6d64 616c 2061 7574 686f 7269  /Heimdal authori
│ │ │ │ +00032bc0: 7a61 7469 6f6e 206d 6574 686f 642e 0a0a  zation method...
│ │ │ │ +00032bd0: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ +00032be0: 7565 3a2a 2052 6574 7572 6e73 2031 2069  ue:* Returns 1 i
│ │ │ │ +00032bf0: 6620 4155 5448 5a4e 414d 4520 6973 2061  f AUTHZNAME is a
│ │ │ │ +00032c00: 7574 686f 7269 7a65 6420 666f 7220 7365  uthorized for se
│ │ │ │ +00032c10: 7276 6963 6573 0a20 2020 2020 6279 2050  rvices.     by P
│ │ │ │ +00032c20: 5249 4e43 4950 414c 2c20 616e 6420 7265  RINCIPAL, and re
│ │ │ │ +00032c30: 7475 726e 7320 3020 6f74 6865 7277 6973  turns 0 otherwis
│ │ │ │ +00032c40: 652e 0a0a 7368 6973 6869 5f61 7574 686f  e...shishi_autho
│ │ │ │ +00032c50: 7269 7a61 7469 6f6e 5f70 6172 7365 0a2d  rization_parse.-
│ │ │ │  00032c60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00032c70: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -00032c80: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ -00032c90: 6869 5f61 7574 686f 7269 7a61 7469 6f6e  hi_authorization
│ │ │ │ -00032ca0: 5f70 6172 7365 0a20 2020 2020 2020 2020  _parse.         
│ │ │ │ -00032cb0: 2028 636f 6e73 7420 6368 6172 202a 2041   (const char * A
│ │ │ │ -00032cc0: 5554 484f 5249 5a41 5449 4f4e 290a 2020  UTHORIZATION).  
│ │ │ │ -00032cd0: 2020 2041 5554 484f 5249 5a41 5449 4f4e     AUTHORIZATION
│ │ │ │ -00032ce0: 3a20 6e61 6d65 206f 6620 6175 7468 6f72  : name of author
│ │ │ │ -00032cf0: 697a 6174 696f 6e20 7479 7065 2c20 2262  ization type, "b
│ │ │ │ -00032d00: 6173 6963 2220 6f72 2022 6b35 6c6f 6769  asic" or "k5logi
│ │ │ │ -00032d10: 6e22 2e0a 0a20 2020 2020 2a44 6573 6372  n"...     *Descr
│ │ │ │ -00032d20: 6970 7469 6f6e 3a2a 2050 6172 7365 2061  iption:* Parse a
│ │ │ │ -00032d30: 7574 686f 7269 7a61 7469 6f6e 2074 7970  uthorization typ
│ │ │ │ -00032d40: 6520 6e61 6d65 2e0a 0a20 2020 2020 2a52  e name...     *R
│ │ │ │ -00032d50: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ -00032d60: 7475 726e 7320 6175 7468 6f72 697a 6174  turns authorizat
│ │ │ │ -00032d70: 696f 6e20 7479 7065 2063 6f72 7265 7370  ion type corresp
│ │ │ │ -00032d80: 6f6e 6469 6e67 2074 6f20 610a 2020 2020  onding to a.    
│ │ │ │ -00032d90: 2073 7472 696e 672e 0a0a 7368 6973 6869   string...shishi
│ │ │ │ -00032da0: 5f61 7574 686f 7269 7a65 645f 700a 2d2d  _authorized_p.--
│ │ │ │ +00032c70: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +00032c80: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ +00032c90: 7368 695f 6175 7468 6f72 697a 6174 696f  shi_authorizatio
│ │ │ │ +00032ca0: 6e5f 7061 7273 650a 2020 2020 2020 2020  n_parse.        
│ │ │ │ +00032cb0: 2020 2863 6f6e 7374 2063 6861 7220 2a20    (const char * 
│ │ │ │ +00032cc0: 4155 5448 4f52 495a 4154 494f 4e29 0a20  AUTHORIZATION). 
│ │ │ │ +00032cd0: 2020 2020 4155 5448 4f52 495a 4154 494f      AUTHORIZATIO
│ │ │ │ +00032ce0: 4e3a 206e 616d 6520 6f66 2061 7574 686f  N: name of autho
│ │ │ │ +00032cf0: 7269 7a61 7469 6f6e 2074 7970 652c 2022  rization type, "
│ │ │ │ +00032d00: 6261 7369 6322 206f 7220 226b 356c 6f67  basic" or "k5log
│ │ │ │ +00032d10: 696e 222e 0a0a 2020 2020 202a 4465 7363  in"...     *Desc
│ │ │ │ +00032d20: 7269 7074 696f 6e3a 2a20 5061 7273 6520  ription:* Parse 
│ │ │ │ +00032d30: 6175 7468 6f72 697a 6174 696f 6e20 7479  authorization ty
│ │ │ │ +00032d40: 7065 206e 616d 652e 0a0a 2020 2020 202a  pe name...     *
│ │ │ │ +00032d50: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ +00032d60: 6574 7572 6e73 2061 7574 686f 7269 7a61  eturns authoriza
│ │ │ │ +00032d70: 7469 6f6e 2074 7970 6520 636f 7272 6573  tion type corres
│ │ │ │ +00032d80: 706f 6e64 696e 6720 746f 2061 0a20 2020  ponding to a.   
│ │ │ │ +00032d90: 2020 7374 7269 6e67 2e0a 0a73 6869 7368    string...shish
│ │ │ │ +00032da0: 695f 6175 7468 6f72 697a 6564 5f70 0a2d  i_authorized_p.-
│ │ │ │  00032db0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00032dc0: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ -00032dd0: 2069 6e74 2073 6869 7368 695f 6175 7468   int shishi_auth
│ │ │ │ -00032de0: 6f72 697a 6564 5f70 2028 5368 6973 6869  orized_p (Shishi
│ │ │ │ -00032df0: 202a 2048 414e 444c 452c 0a20 2020 2020   * HANDLE,.     
│ │ │ │ -00032e00: 2020 2020 2053 6869 7368 695f 746b 7420       Shishi_tkt 
│ │ │ │ -00032e10: 2a20 544b 542c 2063 6f6e 7374 2063 6861  * TKT, const cha
│ │ │ │ -00032e20: 7220 2a20 4155 5448 5a4e 414d 4529 0a20  r * AUTHZNAME). 
│ │ │ │ -00032e30: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ -00032e40: 6869 2068 616e 646c 6520 616c 6c6f 6361  hi handle alloca
│ │ │ │ -00032e50: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ -00032e60: 5f69 6e69 7428 29e2 8099 2e0a 2020 2020  _init().....    
│ │ │ │ -00032e70: 2054 4b54 3a20 696e 7075 7420 7661 7269   TKT: input vari
│ │ │ │ -00032e80: 6162 6c65 2077 6974 6820 7469 636b 6574  able with ticket
│ │ │ │ -00032e90: 2069 6e66 6f2e 0a20 2020 2020 4155 5448   info..     AUTH
│ │ │ │ -00032ea0: 5a4e 414d 453a 2061 7574 686f 7269 7a61  ZNAME: authoriza
│ │ │ │ -00032eb0: 7469 6f6e 206e 616d 652e 0a0a 2020 2020  tion name...    
│ │ │ │ -00032ec0: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ -00032ed0: 5369 6d70 6c69 7374 6963 2061 7574 686f  Simplistic autho
│ │ │ │ -00032ee0: 7269 7a61 7469 6f6e 206f 6620 4155 5448  rization of AUTH
│ │ │ │ -00032ef0: 5a4e 414d 4520 6167 6169 6e73 740a 2020  ZNAME against.  
│ │ │ │ -00032f00: 2020 2065 6e63 7279 7074 6564 2063 6c69     encrypted cli
│ │ │ │ -00032f10: 656e 7420 7072 696e 6369 7061 6c20 6e61  ent principal na
│ │ │ │ -00032f20: 6d65 2069 6e73 6964 6520 7469 636b 6574  me inside ticket
│ │ │ │ -00032f30: 2e20 2046 6f72 2022 6261 7369 6322 0a20  .  For "basic". 
│ │ │ │ -00032f40: 2020 2020 6175 7468 656e 7469 6361 7469      authenticati
│ │ │ │ -00032f50: 6f6e 2074 7970 652c 2074 6865 2070 7269  on type, the pri
│ │ │ │ -00032f60: 6e63 6970 616c 206e 616d 6520 6d75 7374  ncipal name must
│ │ │ │ -00032f70: 2063 6f69 6e63 6964 6520 7769 7468 0a20   coincide with. 
│ │ │ │ -00032f80: 2020 2020 4155 5448 5a4e 414d 452e 2020      AUTHZNAME.  
│ │ │ │ -00032f90: 5468 6520 226b 356c 6f67 696e 2220 6175  The "k5login" au
│ │ │ │ -00032fa0: 7468 656e 7469 6361 7469 6f6e 2074 7970  thentication typ
│ │ │ │ -00032fb0: 6520 6174 7465 6d70 7473 2074 6865 0a20  e attempts the. 
│ │ │ │ -00032fc0: 2020 2020 4d49 542f 4865 696d 6461 6c20      MIT/Heimdal 
│ │ │ │ -00032fd0: 6d65 7468 6f64 206f 6620 7061 7273 696e  method of parsin
│ │ │ │ -00032fe0: 6720 7468 6520 6669 6c65 2022 7e2f 2e6b  g the file "~/.k
│ │ │ │ -00032ff0: 356c 6f67 696e 2220 666f 7220 6164 6469  5login" for addi
│ │ │ │ -00033000: 7469 6f6e 616c 0a20 2020 2020 6571 7569  tional.     equi
│ │ │ │ -00033010: 7661 6c65 6e63 6520 6e61 6d65 732e 0a0a  valence names...
│ │ │ │ -00033020: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ -00033030: 7565 3a2a 2052 6574 7572 6e73 2031 2069  ue:* Returns 1 i
│ │ │ │ -00033040: 6620 4155 5448 5a4e 414d 4520 6973 2061  f AUTHZNAME is a
│ │ │ │ -00033050: 7574 686f 7269 7a65 6420 666f 7220 7365  uthorized for se
│ │ │ │ -00033060: 7276 6963 6573 0a20 2020 2020 6279 2074  rvices.     by t
│ │ │ │ -00033070: 6865 2065 6e63 7279 7074 6564 2070 7269  he encrypted pri
│ │ │ │ -00033080: 6e63 6970 616c 2c20 616e 6420 3020 6f74  ncipal, and 0 ot
│ │ │ │ -00033090: 6865 7277 6973 652e 0a0a 7368 6973 6869  herwise...shishi
│ │ │ │ -000330a0: 5f67 656e 6572 616c 697a 655f 7469 6d65  _generalize_time
│ │ │ │ -000330b0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ -000330c0: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ -000330d0: 6374 696f 6e3a 2063 6f6e 7374 2063 6861  ction: const cha
│ │ │ │ -000330e0: 7220 2a20 7368 6973 6869 5f67 656e 6572  r * shishi_gener
│ │ │ │ -000330f0: 616c 697a 655f 7469 6d65 2028 5368 6973  alize_time (Shis
│ │ │ │ -00033100: 6869 202a 2048 414e 444c 452c 0a20 2020  hi * HANDLE,.   
│ │ │ │ -00033110: 2020 2020 2020 2074 696d 655f 7420 5429         time_t T)
│ │ │ │ -00033120: 0a20 2020 2020 4841 4e44 4c45 3a20 5368  .     HANDLE: Sh
│ │ │ │ -00033130: 6973 6869 2068 616e 646c 6520 6173 2061  ishi handle as a
│ │ │ │ -00033140: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ -00033150: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ -00033160: 0a20 2020 2020 543a 2043 2074 696d 6520  .     T: C time 
│ │ │ │ -00033170: 746f 2063 6f6e 7665 7274 2e0a 0a20 2020  to convert...   
│ │ │ │ -00033180: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ -00033190: 2043 6f6e 7665 7274 7320 4320 7469 6d65   Converts C time
│ │ │ │ -000331a0: 2054 2074 6f20 6120 4b65 7262 6572 6f73   T to a Kerberos
│ │ │ │ -000331b0: 5469 6d65 2073 7472 696e 670a 2020 2020  Time string.    
│ │ │ │ -000331c0: 2072 6570 7265 7365 6e74 6174 696f 6e2e   representation.
│ │ │ │ -000331d0: 2020 5468 6520 7265 7475 726e 6564 2073    The returned s
│ │ │ │ -000331e0: 7472 696e 6720 6d75 7374 206e 6f74 2062  tring must not b
│ │ │ │ -000331f0: 6520 6465 616c 6c6f 6361 7465 6420 6279  e deallocated by
│ │ │ │ -00033200: 2074 6865 0a20 2020 2020 6361 6c6c 6572   the.     caller
│ │ │ │ -00033210: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ -00033220: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ -00033230: 6120 4b65 7262 6572 6f73 5469 6d65 2066  a KerberosTime f
│ │ │ │ -00033240: 6f72 6d61 7474 6564 2073 7472 696e 670a  ormatted string.
│ │ │ │ -00033250: 2020 2020 2063 6f72 7265 7370 6f6e 6469       correspondi
│ │ │ │ -00033260: 6e67 2074 6f20 7468 6520 696e 7075 7420  ng to the input 
│ │ │ │ -00033270: 7061 7261 6d65 7465 722e 0a0a 7368 6973  parameter...shis
│ │ │ │ -00033280: 6869 5f67 656e 6572 616c 697a 655f 6e6f  hi_generalize_no
│ │ │ │ -00033290: 770a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  w.--------------
│ │ │ │ -000332a0: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ -000332b0: 6374 696f 6e3a 2063 6f6e 7374 2063 6861  ction: const cha
│ │ │ │ -000332c0: 7220 2a20 7368 6973 6869 5f67 656e 6572  r * shishi_gener
│ │ │ │ -000332d0: 616c 697a 655f 6e6f 7720 2853 6869 7368  alize_now (Shish
│ │ │ │ -000332e0: 6920 2a20 4841 4e44 4c45 290a 2020 2020  i * HANDLE).    
│ │ │ │ -000332f0: 2048 414e 444c 453a 2053 6869 7368 6920   HANDLE: Shishi 
│ │ │ │ -00033300: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ -00033310: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ -00033320: 5f69 6e69 7428 29e2 8099 2e0a 0a20 2020  _init()......   
│ │ │ │ -00033330: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ -00033340: 2043 6f6e 7665 7274 7320 7468 6520 6375   Converts the cu
│ │ │ │ -00033350: 7272 656e 7420 7469 6d65 2074 6f20 6120  rrent time to a 
│ │ │ │ -00033360: 4b65 7262 6572 6f73 5469 6d65 2073 7472  KerberosTime str
│ │ │ │ -00033370: 696e 672e 0a20 2020 2020 5468 6520 7265  ing..     The re
│ │ │ │ -00033380: 7475 726e 6564 2073 7472 696e 6720 6d75  turned string mu
│ │ │ │ -00033390: 7374 206e 6f74 2062 6520 6465 616c 6c6f  st not be deallo
│ │ │ │ -000333a0: 6361 7465 6420 6279 2074 6865 2063 616c  cated by the cal
│ │ │ │ -000333b0: 6c65 722e 0a0a 2020 2020 202a 5265 7475  ler...     *Retu
│ │ │ │ -000333c0: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ -000333d0: 6e73 2061 204b 6572 6265 726f 7354 696d  ns a KerberosTim
│ │ │ │ -000333e0: 6520 666f 726d 6174 7465 6420 7374 7269  e formatted stri
│ │ │ │ -000333f0: 6e67 0a20 2020 2020 636f 7272 6573 706f  ng.     correspo
│ │ │ │ -00033400: 6e64 696e 6720 746f 2074 6865 2063 7572  nding to the cur
│ │ │ │ -00033410: 7265 6e74 2074 696d 652e 0a0a 7368 6973  rent time...shis
│ │ │ │ -00033420: 6869 5f67 656e 6572 616c 697a 655f 6374  hi_generalize_ct
│ │ │ │ -00033430: 696d 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ime.------------
│ │ │ │ -00033440: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ -00033450: 2046 756e 6374 696f 6e3a 2074 696d 655f   Function: time_
│ │ │ │ -00033460: 7420 7368 6973 6869 5f67 656e 6572 616c  t shishi_general
│ │ │ │ -00033470: 697a 655f 6374 696d 6520 2853 6869 7368  ize_ctime (Shish
│ │ │ │ -00033480: 6920 2a20 4841 4e44 4c45 2c0a 2020 2020  i * HANDLE,.    
│ │ │ │ -00033490: 2020 2020 2020 636f 6e73 7420 6368 6172        const char
│ │ │ │ -000334a0: 202a 2054 290a 2020 2020 2048 414e 444c   * T).     HANDL
│ │ │ │ -000334b0: 453a 2053 6869 7368 6920 6861 6e64 6c65  E: Shishi handle
│ │ │ │ -000334c0: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ -000334d0: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ -000334e0: 29e2 8099 2e0a 2020 2020 2054 3a20 4b65  ).....     T: Ke
│ │ │ │ -000334f0: 7262 6572 6f73 5469 6d65 2073 7472 696e  rberosTime strin
│ │ │ │ -00033500: 6720 746f 2063 6f6e 7665 7274 2e0a 0a20  g to convert... 
│ │ │ │ -00033510: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -00033520: 3a2a 2043 6f6e 7665 7274 7320 6120 4b65  :* Converts a Ke
│ │ │ │ -00033530: 7262 6572 6f73 5469 6d65 2066 6f72 6d61  rberosTime forma
│ │ │ │ -00033540: 7474 6564 2073 7472 696e 6720 696e 2054  tted string in T
│ │ │ │ -00033550: 2074 6f0a 2020 2020 2069 6e74 6567 7261   to.     integra
│ │ │ │ -00033560: 6c20 4320 7469 6d65 2072 6570 7265 7365  l C time represe
│ │ │ │ -00033570: 6e74 6174 696f 6e2e 0a0a 2020 2020 202a  ntation...     *
│ │ │ │ -00033580: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ -00033590: 6574 7572 6e73 2074 6865 2043 2074 696d  eturns the C tim
│ │ │ │ -000335a0: 6520 636f 7272 6573 706f 6e64 696e 6720  e corresponding 
│ │ │ │ -000335b0: 746f 2074 6865 2069 6e70 7574 0a20 2020  to the input.   
│ │ │ │ -000335c0: 2020 6172 6775 6d65 6e74 2e0a 0a73 6869    argument...shi
│ │ │ │ -000335d0: 7368 695f 7469 6d65 0a2d 2d2d 2d2d 2d2d  shi_time.-------
│ │ │ │ -000335e0: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -000335f0: 6f6e 3a20 696e 7420 7368 6973 6869 5f74  on: int shishi_t
│ │ │ │ -00033600: 696d 6520 2853 6869 7368 6920 2a20 4841  ime (Shishi * HA
│ │ │ │ -00033610: 4e44 4c45 2c20 5368 6973 6869 5f61 736e  NDLE, Shishi_asn
│ │ │ │ -00033620: 3120 4e4f 4445 2c0a 2020 2020 2020 2020  1 NODE,.        
│ │ │ │ -00033630: 2020 636f 6e73 7420 6368 6172 202a 2046    const char * F
│ │ │ │ -00033640: 4945 4c44 2c20 6368 6172 202a 2a20 5429  IELD, char ** T)
│ │ │ │ -00033650: 0a20 2020 2020 4841 4e44 4c45 3a20 5368  .     HANDLE: Sh
│ │ │ │ -00033660: 6973 6869 2068 616e 646c 6520 6173 2061  ishi handle as a
│ │ │ │ -00033670: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ -00033680: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ -00033690: 0a20 2020 2020 4e4f 4445 3a20 4153 4e2e  .     NODE: ASN.
│ │ │ │ -000336a0: 3120 7374 7275 6374 7572 6520 746f 2067  1 structure to g
│ │ │ │ -000336b0: 6574 2074 696d 6520 6672 6f6d 2e0a 2020  et time from..  
│ │ │ │ -000336c0: 2020 2046 4945 4c44 3a20 4e61 6d65 206f     FIELD: Name o
│ │ │ │ -000336d0: 6620 7468 6520 6669 656c 6420 696e 2074  f the field in t
│ │ │ │ -000336e0: 6865 2041 534e 2e31 206e 6f64 6520 6361  he ASN.1 node ca
│ │ │ │ -000336f0: 7272 7969 6e67 2074 696d 652e 0a20 2020  rrying time..   
│ │ │ │ -00033700: 2020 543a 2052 6574 7572 6e65 6420 706f    T: Returned po
│ │ │ │ -00033710: 696e 7465 7220 746f 2061 6e20 616c 6c6f  inter to an allo
│ │ │ │ -00033720: 6361 7465 6420 6368 6172 2061 7272 6179  cated char array
│ │ │ │ -00033730: 2063 6f6e 7461 696e 696e 6720 610a 2020   containing a.  
│ │ │ │ -00033740: 2020 206e 756c 6c2d 7465 726d 696e 6174     null-terminat
│ │ │ │ -00033750: 6564 2074 696d 6520 7374 7269 6e67 2e0a  ed time string..
│ │ │ │ -00033760: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -00033770: 6f6e 3a2a 2045 7874 7261 6374 7320 7469  on:* Extracts ti
│ │ │ │ -00033780: 6d65 2069 6e66 6f72 6d61 7469 6f6e 2066  me information f
│ │ │ │ -00033790: 726f 6d20 616e 2041 534e 2e31 2073 7472  rom an ASN.1 str
│ │ │ │ -000337a0: 7563 7475 7265 2c0a 2020 2020 2061 6e64  ucture,.     and
│ │ │ │ -000337b0: 2074 6f20 6265 2070 7265 6369 7365 2c20   to be precise, 
│ │ │ │ -000337c0: 646f 6573 2073 6f20 6672 6f6d 2074 6865  does so from the
│ │ │ │ -000337d0: 206e 616d 6564 2066 6965 6c64 2046 4945   named field FIE
│ │ │ │ -000337e0: 4c44 2077 6974 6869 6e20 7468 650a 2020  LD within the.  
│ │ │ │ -000337f0: 2020 2073 7472 7563 7475 7265 204e 4f44     structure NOD
│ │ │ │ -00033800: 452e 0a0a 2020 2020 202a 5265 7475 726e  E...     *Return
│ │ │ │ -00033810: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ -00033820: 20e2 8098 5348 4953 4849 5f4f 4be2 8099   ...SHISHI_OK...
│ │ │ │ -00033830: 2069 6620 7375 6363 6573 7366 756c 2c20   if successful, 
│ │ │ │ -00033840: 6f72 2061 6e20 6572 726f 722e 0a0a 7368  or an error...sh
│ │ │ │ -00033850: 6973 6869 5f63 7469 6d65 0a2d 2d2d 2d2d  ishi_ctime.-----
│ │ │ │ -00033860: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ -00033870: 6374 696f 6e3a 2069 6e74 2073 6869 7368  ction: int shish
│ │ │ │ -00033880: 695f 6374 696d 6520 2853 6869 7368 6920  i_ctime (Shishi 
│ │ │ │ -00033890: 2a20 4841 4e44 4c45 2c20 5368 6973 6869  * HANDLE, Shishi
│ │ │ │ -000338a0: 5f61 736e 3120 4e4f 4445 2c0a 2020 2020  _asn1 NODE,.    
│ │ │ │ -000338b0: 2020 2020 2020 636f 6e73 7420 6368 6172        const char
│ │ │ │ -000338c0: 202a 2046 4945 4c44 2c20 7469 6d65 5f74   * FIELD, time_t
│ │ │ │ -000338d0: 202a 2054 290a 2020 2020 2048 414e 444c   * T).     HANDL
│ │ │ │ -000338e0: 453a 2053 6869 7368 6920 6861 6e64 6c65  E: Shishi handle
│ │ │ │ -000338f0: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ -00033900: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ -00033910: 29e2 8099 2e0a 2020 2020 204e 4f44 453a  ).....     NODE:
│ │ │ │ -00033920: 2041 534e 2e31 2073 7472 7563 7475 7265   ASN.1 structure
│ │ │ │ -00033930: 2074 6f20 7265 6164 2066 6965 6c64 2066   to read field f
│ │ │ │ -00033940: 726f 6d2e 0a20 2020 2020 4649 454c 443a  rom..     FIELD:
│ │ │ │ -00033950: 204e 616d 6520 6f66 2066 6965 6c64 2069   Name of field i
│ │ │ │ -00033960: 6e20 4e4f 4445 2074 6f20 7265 6164 2e0a  n NODE to read..
│ │ │ │ -00033970: 2020 2020 2054 3a20 506f 696e 7465 7220       T: Pointer 
│ │ │ │ -00033980: 746f 2061 2043 2d74 696d 6520 7661 6c75  to a C-time valu
│ │ │ │ -00033990: 6564 2069 6e74 6567 6572 2c20 6265 696e  ed integer, bein
│ │ │ │ -000339a0: 6720 7570 6461 7465 6420 7769 7468 2074  g updated with t
│ │ │ │ -000339b0: 6865 2074 696d 650a 2020 2020 2076 616c  he time.     val
│ │ │ │ -000339c0: 7565 2074 6f20 6265 2065 7874 7261 6374  ue to be extract
│ │ │ │ -000339d0: 6564 2e0a 0a20 2020 2020 2a44 6573 6372  ed...     *Descr
│ │ │ │ -000339e0: 6970 7469 6f6e 3a2a 2045 7874 7261 6374  iption:* Extract
│ │ │ │ -000339f0: 7320 7469 6d65 2069 6e66 6f72 6d61 7469  s time informati
│ │ │ │ -00033a00: 6f6e 2066 726f 6d20 616e 2041 534e 2e31  on from an ASN.1
│ │ │ │ -00033a10: 2073 7472 7563 7475 7265 0a20 2020 2020   structure.     
│ │ │ │ -00033a20: 4e4f 4445 2c20 616e 6420 6672 6f6d 2061  NODE, and from a
│ │ │ │ -00033a30: 6e20 6172 6269 7472 6172 7920 656c 656d  n arbitrary elem
│ │ │ │ -00033a40: 656e 7420 4649 454c 4420 6f66 2074 6861  ent FIELD of tha
│ │ │ │ -00033a50: 7420 7374 7275 6374 7572 652e 0a0a 2020  t structure...  
│ │ │ │ -00033a60: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ -00033a70: 3a2a 2052 6574 7572 6e73 20e2 8098 5348  :* Returns ...SH
│ │ │ │ -00033a80: 4953 4849 5f4f 4be2 8099 2069 6620 7375  ISHI_OK... if su
│ │ │ │ -00033a90: 6363 6573 7366 756c 2c0a 2020 2020 20e2  ccessful,.     .
│ │ │ │ -00033aa0: 8098 5348 4953 4849 5f41 534e 315f 4e4f  ..SHISHI_ASN1_NO
│ │ │ │ -00033ab0: 5f45 4c45 4d45 4e54 e280 9920 6966 2074  _ELEMENT... if t
│ │ │ │ -00033ac0: 6865 2065 6c65 6d65 6e74 2064 6f65 7320  he element does 
│ │ │ │ -00033ad0: 6e6f 7420 6578 6973 742c 0a20 2020 2020  not exist,.     
│ │ │ │ -00033ae0: e280 9853 4849 5348 495f 4153 4e31 5f4e  ...SHISHI_ASN1_N
│ │ │ │ -00033af0: 4f5f 5641 4c55 45e2 8099 2069 6620 7468  O_VALUE... if th
│ │ │ │ -00033b00: 6520 6669 656c 6420 6861 7320 6e6f 2076  e field has no v
│ │ │ │ -00033b10: 616c 7565 2e20 2049 6e20 616c 6c20 6f74  alue.  In all ot
│ │ │ │ -00033b20: 6865 720a 2020 2020 2063 6173 6573 2c20  her.     cases, 
│ │ │ │ -00033b30: e280 9853 4849 5348 495f 4153 4e31 5f45  ...SHISHI_ASN1_E
│ │ │ │ -00033b40: 5252 4f52 e280 9920 6973 2072 6574 7572  RROR... is retur
│ │ │ │ -00033b50: 6e65 642e 0a0a 7368 6973 6869 5f70 726f  ned...shishi_pro
│ │ │ │ -00033b60: 6d70 745f 7061 7373 776f 7264 5f63 616c  mpt_password_cal
│ │ │ │ -00033b70: 6c62 6163 6b5f 7365 740a 2d2d 2d2d 2d2d  lback_set.------
│ │ │ │ +00032dc0: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ +00032dd0: 3a20 696e 7420 7368 6973 6869 5f61 7574  : int shishi_aut
│ │ │ │ +00032de0: 686f 7269 7a65 645f 7020 2853 6869 7368  horized_p (Shish
│ │ │ │ +00032df0: 6920 2a20 4841 4e44 4c45 2c0a 2020 2020  i * HANDLE,.    
│ │ │ │ +00032e00: 2020 2020 2020 5368 6973 6869 5f74 6b74        Shishi_tkt
│ │ │ │ +00032e10: 202a 2054 4b54 2c20 636f 6e73 7420 6368   * TKT, const ch
│ │ │ │ +00032e20: 6172 202a 2041 5554 485a 4e41 4d45 290a  ar * AUTHZNAME).
│ │ │ │ +00032e30: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ +00032e40: 7368 6920 6861 6e64 6c65 2061 6c6c 6f63  shi handle alloc
│ │ │ │ +00032e50: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ +00032e60: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ +00032e70: 2020 544b 543a 2069 6e70 7574 2076 6172    TKT: input var
│ │ │ │ +00032e80: 6961 626c 6520 7769 7468 2074 6963 6b65  iable with ticke
│ │ │ │ +00032e90: 7420 696e 666f 2e0a 2020 2020 2041 5554  t info..     AUT
│ │ │ │ +00032ea0: 485a 4e41 4d45 3a20 6175 7468 6f72 697a  HZNAME: authoriz
│ │ │ │ +00032eb0: 6174 696f 6e20 6e61 6d65 2e0a 0a20 2020  ation name...   
│ │ │ │ +00032ec0: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ +00032ed0: 2053 696d 706c 6973 7469 6320 6175 7468   Simplistic auth
│ │ │ │ +00032ee0: 6f72 697a 6174 696f 6e20 6f66 2041 5554  orization of AUT
│ │ │ │ +00032ef0: 485a 4e41 4d45 2061 6761 696e 7374 0a20  HZNAME against. 
│ │ │ │ +00032f00: 2020 2020 656e 6372 7970 7465 6420 636c      encrypted cl
│ │ │ │ +00032f10: 6965 6e74 2070 7269 6e63 6970 616c 206e  ient principal n
│ │ │ │ +00032f20: 616d 6520 696e 7369 6465 2074 6963 6b65  ame inside ticke
│ │ │ │ +00032f30: 742e 2020 466f 7220 2262 6173 6963 220a  t.  For "basic".
│ │ │ │ +00032f40: 2020 2020 2061 7574 6865 6e74 6963 6174       authenticat
│ │ │ │ +00032f50: 696f 6e20 7479 7065 2c20 7468 6520 7072  ion type, the pr
│ │ │ │ +00032f60: 696e 6369 7061 6c20 6e61 6d65 206d 7573  incipal name mus
│ │ │ │ +00032f70: 7420 636f 696e 6369 6465 2077 6974 680a  t coincide with.
│ │ │ │ +00032f80: 2020 2020 2041 5554 485a 4e41 4d45 2e20       AUTHZNAME. 
│ │ │ │ +00032f90: 2054 6865 2022 6b35 6c6f 6769 6e22 2061   The "k5login" a
│ │ │ │ +00032fa0: 7574 6865 6e74 6963 6174 696f 6e20 7479  uthentication ty
│ │ │ │ +00032fb0: 7065 2061 7474 656d 7074 7320 7468 650a  pe attempts the.
│ │ │ │ +00032fc0: 2020 2020 204d 4954 2f48 6569 6d64 616c       MIT/Heimdal
│ │ │ │ +00032fd0: 206d 6574 686f 6420 6f66 2070 6172 7369   method of parsi
│ │ │ │ +00032fe0: 6e67 2074 6865 2066 696c 6520 227e 2f2e  ng the file "~/.
│ │ │ │ +00032ff0: 6b35 6c6f 6769 6e22 2066 6f72 2061 6464  k5login" for add
│ │ │ │ +00033000: 6974 696f 6e61 6c0a 2020 2020 2065 7175  itional.     equ
│ │ │ │ +00033010: 6976 616c 656e 6365 206e 616d 6573 2e0a  ivalence names..
│ │ │ │ +00033020: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ +00033030: 6c75 653a 2a20 5265 7475 726e 7320 3120  lue:* Returns 1 
│ │ │ │ +00033040: 6966 2041 5554 485a 4e41 4d45 2069 7320  if AUTHZNAME is 
│ │ │ │ +00033050: 6175 7468 6f72 697a 6564 2066 6f72 2073  authorized for s
│ │ │ │ +00033060: 6572 7669 6365 730a 2020 2020 2062 7920  ervices.     by 
│ │ │ │ +00033070: 7468 6520 656e 6372 7970 7465 6420 7072  the encrypted pr
│ │ │ │ +00033080: 696e 6369 7061 6c2c 2061 6e64 2030 206f  incipal, and 0 o
│ │ │ │ +00033090: 7468 6572 7769 7365 2e0a 0a73 6869 7368  therwise...shish
│ │ │ │ +000330a0: 695f 6765 6e65 7261 6c69 7a65 5f74 696d  i_generalize_tim
│ │ │ │ +000330b0: 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  e.--------------
│ │ │ │ +000330c0: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ +000330d0: 6e63 7469 6f6e 3a20 636f 6e73 7420 6368  nction: const ch
│ │ │ │ +000330e0: 6172 202a 2073 6869 7368 695f 6765 6e65  ar * shishi_gene
│ │ │ │ +000330f0: 7261 6c69 7a65 5f74 696d 6520 2853 6869  ralize_time (Shi
│ │ │ │ +00033100: 7368 6920 2a20 4841 4e44 4c45 2c0a 2020  shi * HANDLE,.  
│ │ │ │ +00033110: 2020 2020 2020 2020 7469 6d65 5f74 2054          time_t T
│ │ │ │ +00033120: 290a 2020 2020 2048 414e 444c 453a 2053  ).     HANDLE: S
│ │ │ │ +00033130: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ +00033140: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ +00033150: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ +00033160: 2e0a 2020 2020 2054 3a20 4320 7469 6d65  ..     T: C time
│ │ │ │ +00033170: 2074 6f20 636f 6e76 6572 742e 0a0a 2020   to convert...  
│ │ │ │ +00033180: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ +00033190: 2a20 436f 6e76 6572 7473 2043 2074 696d  * Converts C tim
│ │ │ │ +000331a0: 6520 5420 746f 2061 204b 6572 6265 726f  e T to a Kerbero
│ │ │ │ +000331b0: 7354 696d 6520 7374 7269 6e67 0a20 2020  sTime string.   
│ │ │ │ +000331c0: 2020 7265 7072 6573 656e 7461 7469 6f6e    representation
│ │ │ │ +000331d0: 2e20 2054 6865 2072 6574 7572 6e65 6420  .  The returned 
│ │ │ │ +000331e0: 7374 7269 6e67 206d 7573 7420 6e6f 7420  string must not 
│ │ │ │ +000331f0: 6265 2064 6561 6c6c 6f63 6174 6564 2062  be deallocated b
│ │ │ │ +00033200: 7920 7468 650a 2020 2020 2063 616c 6c65  y the.     calle
│ │ │ │ +00033210: 722e 0a0a 2020 2020 202a 5265 7475 726e  r...     *Return
│ │ │ │ +00033220: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ +00033230: 2061 204b 6572 6265 726f 7354 696d 6520   a KerberosTime 
│ │ │ │ +00033240: 666f 726d 6174 7465 6420 7374 7269 6e67  formatted string
│ │ │ │ +00033250: 0a20 2020 2020 636f 7272 6573 706f 6e64  .     correspond
│ │ │ │ +00033260: 696e 6720 746f 2074 6865 2069 6e70 7574  ing to the input
│ │ │ │ +00033270: 2070 6172 616d 6574 6572 2e0a 0a73 6869   parameter...shi
│ │ │ │ +00033280: 7368 695f 6765 6e65 7261 6c69 7a65 5f6e  shi_generalize_n
│ │ │ │ +00033290: 6f77 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ow.-------------
│ │ │ │ +000332a0: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ +000332b0: 6e63 7469 6f6e 3a20 636f 6e73 7420 6368  nction: const ch
│ │ │ │ +000332c0: 6172 202a 2073 6869 7368 695f 6765 6e65  ar * shishi_gene
│ │ │ │ +000332d0: 7261 6c69 7a65 5f6e 6f77 2028 5368 6973  ralize_now (Shis
│ │ │ │ +000332e0: 6869 202a 2048 414e 444c 4529 0a20 2020  hi * HANDLE).   
│ │ │ │ +000332f0: 2020 4841 4e44 4c45 3a20 5368 6973 6869    HANDLE: Shishi
│ │ │ │ +00033300: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ +00033310: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ +00033320: 695f 696e 6974 2829 e280 992e 0a0a 2020  i_init()......  
│ │ │ │ +00033330: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ +00033340: 2a20 436f 6e76 6572 7473 2074 6865 2063  * Converts the c
│ │ │ │ +00033350: 7572 7265 6e74 2074 696d 6520 746f 2061  urrent time to a
│ │ │ │ +00033360: 204b 6572 6265 726f 7354 696d 6520 7374   KerberosTime st
│ │ │ │ +00033370: 7269 6e67 2e0a 2020 2020 2054 6865 2072  ring..     The r
│ │ │ │ +00033380: 6574 7572 6e65 6420 7374 7269 6e67 206d  eturned string m
│ │ │ │ +00033390: 7573 7420 6e6f 7420 6265 2064 6561 6c6c  ust not be deall
│ │ │ │ +000333a0: 6f63 6174 6564 2062 7920 7468 6520 6361  ocated by the ca
│ │ │ │ +000333b0: 6c6c 6572 2e0a 0a20 2020 2020 2a52 6574  ller...     *Ret
│ │ │ │ +000333c0: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ +000333d0: 726e 7320 6120 4b65 7262 6572 6f73 5469  rns a KerberosTi
│ │ │ │ +000333e0: 6d65 2066 6f72 6d61 7474 6564 2073 7472  me formatted str
│ │ │ │ +000333f0: 696e 670a 2020 2020 2063 6f72 7265 7370  ing.     corresp
│ │ │ │ +00033400: 6f6e 6469 6e67 2074 6f20 7468 6520 6375  onding to the cu
│ │ │ │ +00033410: 7272 656e 7420 7469 6d65 2e0a 0a73 6869  rrent time...shi
│ │ │ │ +00033420: 7368 695f 6765 6e65 7261 6c69 7a65 5f63  shi_generalize_c
│ │ │ │ +00033430: 7469 6d65 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  time.-----------
│ │ │ │ +00033440: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ +00033450: 2d20 4675 6e63 7469 6f6e 3a20 7469 6d65  - Function: time
│ │ │ │ +00033460: 5f74 2073 6869 7368 695f 6765 6e65 7261  _t shishi_genera
│ │ │ │ +00033470: 6c69 7a65 5f63 7469 6d65 2028 5368 6973  lize_ctime (Shis
│ │ │ │ +00033480: 6869 202a 2048 414e 444c 452c 0a20 2020  hi * HANDLE,.   
│ │ │ │ +00033490: 2020 2020 2020 2063 6f6e 7374 2063 6861         const cha
│ │ │ │ +000334a0: 7220 2a20 5429 0a20 2020 2020 4841 4e44  r * T).     HAND
│ │ │ │ +000334b0: 4c45 3a20 5368 6973 6869 2068 616e 646c  LE: Shishi handl
│ │ │ │ +000334c0: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ +000334d0: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ +000334e0: 2829 e280 992e 0a20 2020 2020 543a 204b  ().....     T: K
│ │ │ │ +000334f0: 6572 6265 726f 7354 696d 6520 7374 7269  erberosTime stri
│ │ │ │ +00033500: 6e67 2074 6f20 636f 6e76 6572 742e 0a0a  ng to convert...
│ │ │ │ +00033510: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ +00033520: 6e3a 2a20 436f 6e76 6572 7473 2061 204b  n:* Converts a K
│ │ │ │ +00033530: 6572 6265 726f 7354 696d 6520 666f 726d  erberosTime form
│ │ │ │ +00033540: 6174 7465 6420 7374 7269 6e67 2069 6e20  atted string in 
│ │ │ │ +00033550: 5420 746f 0a20 2020 2020 696e 7465 6772  T to.     integr
│ │ │ │ +00033560: 616c 2043 2074 696d 6520 7265 7072 6573  al C time repres
│ │ │ │ +00033570: 656e 7461 7469 6f6e 2e0a 0a20 2020 2020  entation...     
│ │ │ │ +00033580: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ +00033590: 5265 7475 726e 7320 7468 6520 4320 7469  Returns the C ti
│ │ │ │ +000335a0: 6d65 2063 6f72 7265 7370 6f6e 6469 6e67  me corresponding
│ │ │ │ +000335b0: 2074 6f20 7468 6520 696e 7075 740a 2020   to the input.  
│ │ │ │ +000335c0: 2020 2061 7267 756d 656e 742e 0a0a 7368     argument...sh
│ │ │ │ +000335d0: 6973 6869 5f74 696d 650a 2d2d 2d2d 2d2d  ishi_time.------
│ │ │ │ +000335e0: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +000335f0: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ +00033600: 7469 6d65 2028 5368 6973 6869 202a 2048  time (Shishi * H
│ │ │ │ +00033610: 414e 444c 452c 2053 6869 7368 695f 6173  ANDLE, Shishi_as
│ │ │ │ +00033620: 6e31 204e 4f44 452c 0a20 2020 2020 2020  n1 NODE,.       
│ │ │ │ +00033630: 2020 2063 6f6e 7374 2063 6861 7220 2a20     const char * 
│ │ │ │ +00033640: 4649 454c 442c 2063 6861 7220 2a2a 2054  FIELD, char ** T
│ │ │ │ +00033650: 290a 2020 2020 2048 414e 444c 453a 2053  ).     HANDLE: S
│ │ │ │ +00033660: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ +00033670: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ +00033680: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ +00033690: 2e0a 2020 2020 204e 4f44 453a 2041 534e  ..     NODE: ASN
│ │ │ │ +000336a0: 2e31 2073 7472 7563 7475 7265 2074 6f20  .1 structure to 
│ │ │ │ +000336b0: 6765 7420 7469 6d65 2066 726f 6d2e 0a20  get time from.. 
│ │ │ │ +000336c0: 2020 2020 4649 454c 443a 204e 616d 6520      FIELD: Name 
│ │ │ │ +000336d0: 6f66 2074 6865 2066 6965 6c64 2069 6e20  of the field in 
│ │ │ │ +000336e0: 7468 6520 4153 4e2e 3120 6e6f 6465 2063  the ASN.1 node c
│ │ │ │ +000336f0: 6172 7279 696e 6720 7469 6d65 2e0a 2020  arrying time..  
│ │ │ │ +00033700: 2020 2054 3a20 5265 7475 726e 6564 2070     T: Returned p
│ │ │ │ +00033710: 6f69 6e74 6572 2074 6f20 616e 2061 6c6c  ointer to an all
│ │ │ │ +00033720: 6f63 6174 6564 2063 6861 7220 6172 7261  ocated char arra
│ │ │ │ +00033730: 7920 636f 6e74 6169 6e69 6e67 2061 0a20  y containing a. 
│ │ │ │ +00033740: 2020 2020 6e75 6c6c 2d74 6572 6d69 6e61      null-termina
│ │ │ │ +00033750: 7465 6420 7469 6d65 2073 7472 696e 672e  ted time string.
│ │ │ │ +00033760: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ +00033770: 696f 6e3a 2a20 4578 7472 6163 7473 2074  ion:* Extracts t
│ │ │ │ +00033780: 696d 6520 696e 666f 726d 6174 696f 6e20  ime information 
│ │ │ │ +00033790: 6672 6f6d 2061 6e20 4153 4e2e 3120 7374  from an ASN.1 st
│ │ │ │ +000337a0: 7275 6374 7572 652c 0a20 2020 2020 616e  ructure,.     an
│ │ │ │ +000337b0: 6420 746f 2062 6520 7072 6563 6973 652c  d to be precise,
│ │ │ │ +000337c0: 2064 6f65 7320 736f 2066 726f 6d20 7468   does so from th
│ │ │ │ +000337d0: 6520 6e61 6d65 6420 6669 656c 6420 4649  e named field FI
│ │ │ │ +000337e0: 454c 4420 7769 7468 696e 2074 6865 0a20  ELD within the. 
│ │ │ │ +000337f0: 2020 2020 7374 7275 6374 7572 6520 4e4f      structure NO
│ │ │ │ +00033800: 4445 2e0a 0a20 2020 2020 2a52 6574 7572  DE...     *Retur
│ │ │ │ +00033810: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ +00033820: 7320 e280 9853 4849 5348 495f 4f4b e280  s ...SHISHI_OK..
│ │ │ │ +00033830: 9920 6966 2073 7563 6365 7373 6675 6c2c  . if successful,
│ │ │ │ +00033840: 206f 7220 616e 2065 7272 6f72 2e0a 0a73   or an error...s
│ │ │ │ +00033850: 6869 7368 695f 6374 696d 650a 2d2d 2d2d  hishi_ctime.----
│ │ │ │ +00033860: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ +00033870: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ +00033880: 6869 5f63 7469 6d65 2028 5368 6973 6869  hi_ctime (Shishi
│ │ │ │ +00033890: 202a 2048 414e 444c 452c 2053 6869 7368   * HANDLE, Shish
│ │ │ │ +000338a0: 695f 6173 6e31 204e 4f44 452c 0a20 2020  i_asn1 NODE,.   
│ │ │ │ +000338b0: 2020 2020 2020 2063 6f6e 7374 2063 6861         const cha
│ │ │ │ +000338c0: 7220 2a20 4649 454c 442c 2074 696d 655f  r * FIELD, time_
│ │ │ │ +000338d0: 7420 2a20 5429 0a20 2020 2020 4841 4e44  t * T).     HAND
│ │ │ │ +000338e0: 4c45 3a20 5368 6973 6869 2068 616e 646c  LE: Shishi handl
│ │ │ │ +000338f0: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ +00033900: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ +00033910: 2829 e280 992e 0a20 2020 2020 4e4f 4445  ().....     NODE
│ │ │ │ +00033920: 3a20 4153 4e2e 3120 7374 7275 6374 7572  : ASN.1 structur
│ │ │ │ +00033930: 6520 746f 2072 6561 6420 6669 656c 6420  e to read field 
│ │ │ │ +00033940: 6672 6f6d 2e0a 2020 2020 2046 4945 4c44  from..     FIELD
│ │ │ │ +00033950: 3a20 4e61 6d65 206f 6620 6669 656c 6420  : Name of field 
│ │ │ │ +00033960: 696e 204e 4f44 4520 746f 2072 6561 642e  in NODE to read.
│ │ │ │ +00033970: 0a20 2020 2020 543a 2050 6f69 6e74 6572  .     T: Pointer
│ │ │ │ +00033980: 2074 6f20 6120 432d 7469 6d65 2076 616c   to a C-time val
│ │ │ │ +00033990: 7565 6420 696e 7465 6765 722c 2062 6569  ued integer, bei
│ │ │ │ +000339a0: 6e67 2075 7064 6174 6564 2077 6974 6820  ng updated with 
│ │ │ │ +000339b0: 7468 6520 7469 6d65 0a20 2020 2020 7661  the time.     va
│ │ │ │ +000339c0: 6c75 6520 746f 2062 6520 6578 7472 6163  lue to be extrac
│ │ │ │ +000339d0: 7465 642e 0a0a 2020 2020 202a 4465 7363  ted...     *Desc
│ │ │ │ +000339e0: 7269 7074 696f 6e3a 2a20 4578 7472 6163  ription:* Extrac
│ │ │ │ +000339f0: 7473 2074 696d 6520 696e 666f 726d 6174  ts time informat
│ │ │ │ +00033a00: 696f 6e20 6672 6f6d 2061 6e20 4153 4e2e  ion from an ASN.
│ │ │ │ +00033a10: 3120 7374 7275 6374 7572 650a 2020 2020  1 structure.    
│ │ │ │ +00033a20: 204e 4f44 452c 2061 6e64 2066 726f 6d20   NODE, and from 
│ │ │ │ +00033a30: 616e 2061 7262 6974 7261 7279 2065 6c65  an arbitrary ele
│ │ │ │ +00033a40: 6d65 6e74 2046 4945 4c44 206f 6620 7468  ment FIELD of th
│ │ │ │ +00033a50: 6174 2073 7472 7563 7475 7265 2e0a 0a20  at structure... 
│ │ │ │ +00033a60: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ +00033a70: 653a 2a20 5265 7475 726e 7320 e280 9853  e:* Returns ...S
│ │ │ │ +00033a80: 4849 5348 495f 4f4b e280 9920 6966 2073  HISHI_OK... if s
│ │ │ │ +00033a90: 7563 6365 7373 6675 6c2c 0a20 2020 2020  uccessful,.     
│ │ │ │ +00033aa0: e280 9853 4849 5348 495f 4153 4e31 5f4e  ...SHISHI_ASN1_N
│ │ │ │ +00033ab0: 4f5f 454c 454d 454e 54e2 8099 2069 6620  O_ELEMENT... if 
│ │ │ │ +00033ac0: 7468 6520 656c 656d 656e 7420 646f 6573  the element does
│ │ │ │ +00033ad0: 206e 6f74 2065 7869 7374 2c0a 2020 2020   not exist,.    
│ │ │ │ +00033ae0: 20e2 8098 5348 4953 4849 5f41 534e 315f   ...SHISHI_ASN1_
│ │ │ │ +00033af0: 4e4f 5f56 414c 5545 e280 9920 6966 2074  NO_VALUE... if t
│ │ │ │ +00033b00: 6865 2066 6965 6c64 2068 6173 206e 6f20  he field has no 
│ │ │ │ +00033b10: 7661 6c75 652e 2020 496e 2061 6c6c 206f  value.  In all o
│ │ │ │ +00033b20: 7468 6572 0a20 2020 2020 6361 7365 732c  ther.     cases,
│ │ │ │ +00033b30: 20e2 8098 5348 4953 4849 5f41 534e 315f   ...SHISHI_ASN1_
│ │ │ │ +00033b40: 4552 524f 52e2 8099 2069 7320 7265 7475  ERROR... is retu
│ │ │ │ +00033b50: 726e 6564 2e0a 0a73 6869 7368 695f 7072  rned...shishi_pr
│ │ │ │ +00033b60: 6f6d 7074 5f70 6173 7377 6f72 645f 6361  ompt_password_ca
│ │ │ │ +00033b70: 6c6c 6261 636b 5f73 6574 0a2d 2d2d 2d2d  llback_set.-----
│ │ │ │  00033b80: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00033b90: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -00033ba0: 2d2d 2046 756e 6374 696f 6e3a 2076 6f69  -- Function: voi
│ │ │ │ -00033bb0: 6420 7368 6973 6869 5f70 726f 6d70 745f  d shishi_prompt_
│ │ │ │ -00033bc0: 7061 7373 776f 7264 5f63 616c 6c62 6163  password_callbac
│ │ │ │ -00033bd0: 6b5f 7365 7420 2853 6869 7368 6920 2a20  k_set (Shishi * 
│ │ │ │ -00033be0: 4841 4e44 4c45 2c0a 2020 2020 2020 2020  HANDLE,.        
│ │ │ │ -00033bf0: 2020 7368 6973 6869 5f70 726f 6d70 745f    shishi_prompt_
│ │ │ │ -00033c00: 7061 7373 776f 7264 5f66 756e 6320 4342  password_func CB
│ │ │ │ -00033c10: 290a 2020 2020 2048 414e 444c 453a 2073  ).     HANDLE: s
│ │ │ │ -00033c20: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ -00033c30: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ -00033c40: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ -00033c50: 2e0a 2020 2020 2043 423a 2066 756e 6374  ..     CB: funct
│ │ │ │ -00033c60: 696f 6e20 706f 696e 7465 7220 746f 2061  ion pointer to a
│ │ │ │ -00033c70: 7070 6c69 6361 7469 6f6e 2070 6173 7377  pplication passw
│ │ │ │ -00033c80: 6f72 6420 6361 6c6c 6261 636b 2c20 610a  ord callback, a.
│ │ │ │ -00033c90: 2020 2020 20e2 8098 7368 6973 6869 5f70       ...shishi_p
│ │ │ │ -00033ca0: 726f 6d70 745f 7061 7373 776f 7264 5f66  rompt_password_f
│ │ │ │ -00033cb0: 756e 63e2 8099 2074 7970 652e 0a0a 2020  unc... type...  
│ │ │ │ -00033cc0: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ -00033cd0: 2a20 5365 7420 6120 6361 6c6c 6261 636b  * Set a callback
│ │ │ │ -00033ce0: 2066 756e 6374 696f 6e20 7468 6174 2077   function that w
│ │ │ │ -00033cf0: 696c 6c20 6265 2075 7365 6420 6279 0a20  ill be used by. 
│ │ │ │ -00033d00: 2020 2020 e280 9873 6869 7368 695f 7072      ...shishi_pr
│ │ │ │ -00033d10: 6f6d 7074 5f70 6173 7377 6f72 6428 29e2  ompt_password().
│ │ │ │ -00033d20: 8099 2074 6f20 7175 6572 7920 7468 6520  .. to query the 
│ │ │ │ -00033d30: 7573 6572 2066 6f72 2061 2070 6173 7377  user for a passw
│ │ │ │ -00033d40: 6f72 642e 2020 5468 650a 2020 2020 2066  ord.  The.     f
│ │ │ │ -00033d50: 756e 6374 696f 6e20 706f 696e 7465 7220  unction pointer 
│ │ │ │ -00033d60: 6361 6e20 6265 2072 6574 7269 6576 6564  can be retrieved
│ │ │ │ -00033d70: 2075 7369 6e67 0a20 2020 2020 e280 9873   using.     ...s
│ │ │ │ -00033d80: 6869 7368 695f 7072 6f6d 7074 5f70 6173  hishi_prompt_pas
│ │ │ │ -00033d90: 7377 6f72 645f 6361 6c6c 6261 636b 5f67  sword_callback_g
│ │ │ │ -00033da0: 6574 2829 e280 992e 0a0a 2020 2020 2054  et()......     T
│ │ │ │ -00033db0: 6865 2043 4220 6675 6e63 7469 6f6e 2073  he CB function s
│ │ │ │ -00033dc0: 686f 756c 6420 666f 6c6c 6f77 2074 6865  hould follow the
│ │ │ │ -00033dd0: 20e2 8098 7368 6973 6869 5f70 726f 6d70   ...shishi_promp
│ │ │ │ -00033de0: 745f 7061 7373 776f 7264 5f66 756e 63e2  t_password_func.
│ │ │ │ -00033df0: 8099 0a20 2020 2020 7072 6f74 6f74 7970  ...     prototyp
│ │ │ │ -00033e00: 653a 0a0a 2020 2020 2069 6e74 2070 726f  e:..     int pro
│ │ │ │ -00033e10: 6d70 745f 7061 7373 776f 7264 2028 5368  mpt_password (Sh
│ │ │ │ -00033e20: 6973 6869 202a 2048 414e 444c 452c 2063  ishi * HANDLE, c
│ │ │ │ -00033e30: 6861 7220 2a2a 532c 2063 6f6e 7374 2063  har **S, const c
│ │ │ │ -00033e40: 6861 7220 2a46 4f52 4d41 542c 0a20 2020  har *FORMAT,.   
│ │ │ │ -00033e50: 2020 7661 5f6c 6973 7420 4150 293b 0a0a    va_list AP);..
│ │ │ │ -00033e60: 2020 2020 2049 6620 7468 6520 6675 6e63       If the func
│ │ │ │ -00033e70: 7469 6f6e 2072 6574 7572 6e73 2030 2c20  tion returns 0, 
│ │ │ │ -00033e80: 7468 6520 5320 7661 7269 6162 6c65 2073  the S variable s
│ │ │ │ -00033e90: 686f 756c 6420 636f 6e74 6169 6e20 6120  hould contain a 
│ │ │ │ -00033ea0: 6e65 776c 790a 2020 2020 2061 6c6c 6f63  newly.     alloc
│ │ │ │ -00033eb0: 6174 6564 2073 7472 696e 6720 7769 7468  ated string with
│ │ │ │ -00033ec0: 2074 6865 2070 6173 7377 6f72 6420 7265   the password re
│ │ │ │ -00033ed0: 6164 2066 726f 6d20 7468 6520 7573 6572  ad from the user
│ │ │ │ -00033ee0: 2e0a 0a73 6869 7368 695f 7072 6f6d 7074  ...shishi_prompt
│ │ │ │ -00033ef0: 5f70 6173 7377 6f72 645f 6361 6c6c 6261  _password_callba
│ │ │ │ -00033f00: 636b 5f67 6574 0a2d 2d2d 2d2d 2d2d 2d2d  ck_get.---------
│ │ │ │ +00033b90: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ +00033ba0: 202d 2d20 4675 6e63 7469 6f6e 3a20 766f   -- Function: vo
│ │ │ │ +00033bb0: 6964 2073 6869 7368 695f 7072 6f6d 7074  id shishi_prompt
│ │ │ │ +00033bc0: 5f70 6173 7377 6f72 645f 6361 6c6c 6261  _password_callba
│ │ │ │ +00033bd0: 636b 5f73 6574 2028 5368 6973 6869 202a  ck_set (Shishi *
│ │ │ │ +00033be0: 2048 414e 444c 452c 0a20 2020 2020 2020   HANDLE,.       
│ │ │ │ +00033bf0: 2020 2073 6869 7368 695f 7072 6f6d 7074     shishi_prompt
│ │ │ │ +00033c00: 5f70 6173 7377 6f72 645f 6675 6e63 2043  _password_func C
│ │ │ │ +00033c10: 4229 0a20 2020 2020 4841 4e44 4c45 3a20  B).     HANDLE: 
│ │ │ │ +00033c20: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ +00033c30: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ +00033c40: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ +00033c50: 992e 0a20 2020 2020 4342 3a20 6675 6e63  ...     CB: func
│ │ │ │ +00033c60: 7469 6f6e 2070 6f69 6e74 6572 2074 6f20  tion pointer to 
│ │ │ │ +00033c70: 6170 706c 6963 6174 696f 6e20 7061 7373  application pass
│ │ │ │ +00033c80: 776f 7264 2063 616c 6c62 6163 6b2c 2061  word callback, a
│ │ │ │ +00033c90: 0a20 2020 2020 e280 9873 6869 7368 695f  .     ...shishi_
│ │ │ │ +00033ca0: 7072 6f6d 7074 5f70 6173 7377 6f72 645f  prompt_password_
│ │ │ │ +00033cb0: 6675 6e63 e280 9920 7479 7065 2e0a 0a20  func... type... 
│ │ │ │ +00033cc0: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ +00033cd0: 3a2a 2053 6574 2061 2063 616c 6c62 6163  :* Set a callbac
│ │ │ │ +00033ce0: 6b20 6675 6e63 7469 6f6e 2074 6861 7420  k function that 
│ │ │ │ +00033cf0: 7769 6c6c 2062 6520 7573 6564 2062 790a  will be used by.
│ │ │ │ +00033d00: 2020 2020 20e2 8098 7368 6973 6869 5f70       ...shishi_p
│ │ │ │ +00033d10: 726f 6d70 745f 7061 7373 776f 7264 2829  rompt_password()
│ │ │ │ +00033d20: e280 9920 746f 2071 7565 7279 2074 6865  ... to query the
│ │ │ │ +00033d30: 2075 7365 7220 666f 7220 6120 7061 7373   user for a pass
│ │ │ │ +00033d40: 776f 7264 2e20 2054 6865 0a20 2020 2020  word.  The.     
│ │ │ │ +00033d50: 6675 6e63 7469 6f6e 2070 6f69 6e74 6572  function pointer
│ │ │ │ +00033d60: 2063 616e 2062 6520 7265 7472 6965 7665   can be retrieve
│ │ │ │ +00033d70: 6420 7573 696e 670a 2020 2020 20e2 8098  d using.     ...
│ │ │ │ +00033d80: 7368 6973 6869 5f70 726f 6d70 745f 7061  shishi_prompt_pa
│ │ │ │ +00033d90: 7373 776f 7264 5f63 616c 6c62 6163 6b5f  ssword_callback_
│ │ │ │ +00033da0: 6765 7428 29e2 8099 2e0a 0a20 2020 2020  get()......     
│ │ │ │ +00033db0: 5468 6520 4342 2066 756e 6374 696f 6e20  The CB function 
│ │ │ │ +00033dc0: 7368 6f75 6c64 2066 6f6c 6c6f 7720 7468  should follow th
│ │ │ │ +00033dd0: 6520 e280 9873 6869 7368 695f 7072 6f6d  e ...shishi_prom
│ │ │ │ +00033de0: 7074 5f70 6173 7377 6f72 645f 6675 6e63  pt_password_func
│ │ │ │ +00033df0: e280 990a 2020 2020 2070 726f 746f 7479  ....     prototy
│ │ │ │ +00033e00: 7065 3a0a 0a20 2020 2020 696e 7420 7072  pe:..     int pr
│ │ │ │ +00033e10: 6f6d 7074 5f70 6173 7377 6f72 6420 2853  ompt_password (S
│ │ │ │ +00033e20: 6869 7368 6920 2a20 4841 4e44 4c45 2c20  hishi * HANDLE, 
│ │ │ │ +00033e30: 6368 6172 202a 2a53 2c20 636f 6e73 7420  char **S, const 
│ │ │ │ +00033e40: 6368 6172 202a 464f 524d 4154 2c0a 2020  char *FORMAT,.  
│ │ │ │ +00033e50: 2020 2076 615f 6c69 7374 2041 5029 3b0a     va_list AP);.
│ │ │ │ +00033e60: 0a20 2020 2020 4966 2074 6865 2066 756e  .     If the fun
│ │ │ │ +00033e70: 6374 696f 6e20 7265 7475 726e 7320 302c  ction returns 0,
│ │ │ │ +00033e80: 2074 6865 2053 2076 6172 6961 626c 6520   the S variable 
│ │ │ │ +00033e90: 7368 6f75 6c64 2063 6f6e 7461 696e 2061  should contain a
│ │ │ │ +00033ea0: 206e 6577 6c79 0a20 2020 2020 616c 6c6f   newly.     allo
│ │ │ │ +00033eb0: 6361 7465 6420 7374 7269 6e67 2077 6974  cated string wit
│ │ │ │ +00033ec0: 6820 7468 6520 7061 7373 776f 7264 2072  h the password r
│ │ │ │ +00033ed0: 6561 6420 6672 6f6d 2074 6865 2075 7365  ead from the use
│ │ │ │ +00033ee0: 722e 0a0a 7368 6973 6869 5f70 726f 6d70  r...shishi_promp
│ │ │ │ +00033ef0: 745f 7061 7373 776f 7264 5f63 616c 6c62  t_password_callb
│ │ │ │ +00033f00: 6163 6b5f 6765 740a 2d2d 2d2d 2d2d 2d2d  ack_get.--------
│ │ │ │  00033f10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00033f20: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ -00033f30: 4675 6e63 7469 6f6e 3a20 7368 6973 6869  Function: shishi
│ │ │ │ -00033f40: 5f70 726f 6d70 745f 7061 7373 776f 7264  _prompt_password
│ │ │ │ -00033f50: 5f66 756e 630a 2020 2020 2020 2020 2020  _func.          
│ │ │ │ -00033f60: 7368 6973 6869 5f70 726f 6d70 745f 7061  shishi_prompt_pa
│ │ │ │ -00033f70: 7373 776f 7264 5f63 616c 6c62 6163 6b5f  ssword_callback_
│ │ │ │ -00033f80: 6765 7420 2853 6869 7368 6920 2a20 4841  get (Shishi * HA
│ │ │ │ -00033f90: 4e44 4c45 290a 2020 2020 2048 414e 444c  NDLE).     HANDL
│ │ │ │ -00033fa0: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ -00033fb0: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ -00033fc0: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ -00033fd0: 29e2 8099 2e0a 0a20 2020 2020 2a44 6573  )......     *Des
│ │ │ │ -00033fe0: 6372 6970 7469 6f6e 3a2a 2047 6574 2074  cription:* Get t
│ │ │ │ -00033ff0: 6865 2061 7070 6c69 6361 7469 6f6e 2070  he application p
│ │ │ │ -00034000: 6173 7377 6f72 6420 7072 6f6d 7074 2066  assword prompt f
│ │ │ │ -00034010: 756e 6374 696f 6e0a 2020 2020 2063 616c  unction.     cal
│ │ │ │ -00034020: 6c62 6163 6b20 6173 2073 6574 2062 7920  lback as set by 
│ │ │ │ -00034030: e280 9873 6869 7368 695f 7072 6f6d 7074  ...shishi_prompt
│ │ │ │ -00034040: 5f70 6173 7377 6f72 645f 6361 6c6c 6261  _password_callba
│ │ │ │ -00034050: 636b 5f73 6574 2829 e280 992e 0a0a 2020  ck_set()......  
│ │ │ │ -00034060: 2020 202a 5265 7475 726e 733a 2a20 5265     *Returns:* Re
│ │ │ │ -00034070: 7475 726e 7320 7468 6520 6361 6c6c 6261  turns the callba
│ │ │ │ -00034080: 636b 2c20 6120 e280 9873 6869 7368 695f  ck, a ...shishi_
│ │ │ │ -00034090: 7072 6f6d 7074 5f70 6173 7377 6f72 645f  prompt_password_
│ │ │ │ -000340a0: 6675 6e63 e280 990a 2020 2020 2074 7970  func....     typ
│ │ │ │ -000340b0: 652c 206f 7220 e280 984e 554c 4ce2 8099  e, or ...NULL...
│ │ │ │ -000340c0: 2e0a 0a73 6869 7368 695f 7072 6f6d 7074  ...shishi_prompt
│ │ │ │ -000340d0: 5f70 6173 7377 6f72 640a 2d2d 2d2d 2d2d  _password.------
│ │ │ │ +00033f20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ +00033f30: 2046 756e 6374 696f 6e3a 2073 6869 7368   Function: shish
│ │ │ │ +00033f40: 695f 7072 6f6d 7074 5f70 6173 7377 6f72  i_prompt_passwor
│ │ │ │ +00033f50: 645f 6675 6e63 0a20 2020 2020 2020 2020  d_func.         
│ │ │ │ +00033f60: 2073 6869 7368 695f 7072 6f6d 7074 5f70   shishi_prompt_p
│ │ │ │ +00033f70: 6173 7377 6f72 645f 6361 6c6c 6261 636b  assword_callback
│ │ │ │ +00033f80: 5f67 6574 2028 5368 6973 6869 202a 2048  _get (Shishi * H
│ │ │ │ +00033f90: 414e 444c 4529 0a20 2020 2020 4841 4e44  ANDLE).     HAND
│ │ │ │ +00033fa0: 4c45 3a20 7368 6973 6869 2068 616e 646c  LE: shishi handl
│ │ │ │ +00033fb0: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ +00033fc0: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ +00033fd0: 2829 e280 992e 0a0a 2020 2020 202a 4465  ()......     *De
│ │ │ │ +00033fe0: 7363 7269 7074 696f 6e3a 2a20 4765 7420  scription:* Get 
│ │ │ │ +00033ff0: 7468 6520 6170 706c 6963 6174 696f 6e20  the application 
│ │ │ │ +00034000: 7061 7373 776f 7264 2070 726f 6d70 7420  password prompt 
│ │ │ │ +00034010: 6675 6e63 7469 6f6e 0a20 2020 2020 6361  function.     ca
│ │ │ │ +00034020: 6c6c 6261 636b 2061 7320 7365 7420 6279  llback as set by
│ │ │ │ +00034030: 20e2 8098 7368 6973 6869 5f70 726f 6d70   ...shishi_promp
│ │ │ │ +00034040: 745f 7061 7373 776f 7264 5f63 616c 6c62  t_password_callb
│ │ │ │ +00034050: 6163 6b5f 7365 7428 29e2 8099 2e0a 0a20  ack_set()...... 
│ │ │ │ +00034060: 2020 2020 2a52 6574 7572 6e73 3a2a 2052      *Returns:* R
│ │ │ │ +00034070: 6574 7572 6e73 2074 6865 2063 616c 6c62  eturns the callb
│ │ │ │ +00034080: 6163 6b2c 2061 20e2 8098 7368 6973 6869  ack, a ...shishi
│ │ │ │ +00034090: 5f70 726f 6d70 745f 7061 7373 776f 7264  _prompt_password
│ │ │ │ +000340a0: 5f66 756e 63e2 8099 0a20 2020 2020 7479  _func....     ty
│ │ │ │ +000340b0: 7065 2c20 6f72 20e2 8098 4e55 4c4c e280  pe, or ...NULL..
│ │ │ │ +000340c0: 992e 0a0a 7368 6973 6869 5f70 726f 6d70  ....shishi_promp
│ │ │ │ +000340d0: 745f 7061 7373 776f 7264 0a2d 2d2d 2d2d  t_password.-----
│ │ │ │  000340e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000340f0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ -00034100: 696e 7420 7368 6973 6869 5f70 726f 6d70  int shishi_promp
│ │ │ │ -00034110: 745f 7061 7373 776f 7264 2028 5368 6973  t_password (Shis
│ │ │ │ -00034120: 6869 202a 2048 414e 444c 452c 2063 6861  hi * HANDLE, cha
│ │ │ │ -00034130: 7220 2a2a 2053 2c0a 2020 2020 2020 2020  r ** S,.        
│ │ │ │ -00034140: 2020 636f 6e73 7420 6368 6172 202a 2046    const char * F
│ │ │ │ -00034150: 4f52 4d41 542c 202e 2e2e 290a 2020 2020  ORMAT, ...).    
│ │ │ │ -00034160: 2048 414e 444c 453a 2073 6869 7368 6920   HANDLE: shishi 
│ │ │ │ -00034170: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ -00034180: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ -00034190: 5f69 6e69 7428 29e2 8099 2e0a 2020 2020  _init().....    
│ │ │ │ -000341a0: 2053 3a20 706f 696e 7465 7220 746f 206e   S: pointer to n
│ │ │ │ -000341b0: 6577 6c79 2061 6c6c 6f63 6174 6564 206f  ewly allocated o
│ │ │ │ -000341c0: 7574 7075 7420 7374 7269 6e67 2077 6974  utput string wit
│ │ │ │ -000341d0: 6820 7265 6164 2070 6173 7377 6f72 642e  h read password.
│ │ │ │ -000341e0: 0a20 2020 2020 464f 524d 4154 3a20 7072  .     FORMAT: pr
│ │ │ │ -000341f0: 696e 7466 2833 2920 7374 796c 6520 666f  intf(3) style fo
│ │ │ │ -00034200: 726d 6174 2073 7472 696e 672e 0a20 2020  rmat string..   
│ │ │ │ -00034210: 2020 2e2e 2e3a 2070 7269 6e74 6628 3329    ...: printf(3)
│ │ │ │ -00034220: 2073 7479 6c65 2061 7267 756d 656e 7473   style arguments
│ │ │ │ -00034230: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ -00034240: 7469 6f6e 3a2a 2046 6f72 6d61 7420 616e  tion:* Format an
│ │ │ │ -00034250: 6420 7072 696e 7420 6120 7072 6f6d 7074  d print a prompt
│ │ │ │ -00034260: 2c20 616e 6420 7265 6164 2061 2070 6173  , and read a pas
│ │ │ │ -00034270: 7377 6f72 6420 6672 6f6d 0a20 2020 2020  sword from.     
│ │ │ │ -00034280: 7573 6572 2e20 2054 6865 2070 6173 7377  user.  The passw
│ │ │ │ -00034290: 6f72 6420 6973 2070 6f73 7369 626c 7920  ord is possibly 
│ │ │ │ -000342a0: 636f 6e76 6572 7465 6420 2865 2e67 2e2c  converted (e.g.,
│ │ │ │ -000342b0: 2063 6f6e 7665 7274 6564 2066 726f 6d0a   converted from.
│ │ │ │ -000342c0: 2020 2020 204c 6174 696e 2d31 2074 6f20       Latin-1 to 
│ │ │ │ -000342d0: 5554 462d 382c 206f 7220 7072 6f63 6573  UTF-8, or proces
│ │ │ │ -000342e0: 7365 6420 7573 696e 6720 5374 7269 6e67  sed using String
│ │ │ │ -000342f0: 7072 6570 2070 726f 6669 6c65 2920 666f  prep profile) fo
│ │ │ │ -00034300: 6c6c 6f77 696e 670a 2020 2020 2061 6e79  llowing.     any
│ │ │ │ -00034310: 2022 7374 7269 6e67 7072 6f63 6573 7322   "stringprocess"
│ │ │ │ -00034320: 206b 6579 776f 7264 7320 696e 2063 6f6e   keywords in con
│ │ │ │ -00034330: 6669 6775 7261 7469 6f6e 2066 696c 6573  figuration files
│ │ │ │ -00034340: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ -00034350: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ -00034360: 5348 4953 4849 5f4f 4b20 6966 6620 7375  SHISHI_OK iff su
│ │ │ │ -00034370: 6363 6573 7366 756c 2e0a 0a73 6869 7368  ccessful...shish
│ │ │ │ -00034380: 695f 7265 736f 6c76 0a2d 2d2d 2d2d 2d2d  i_resolv.-------
│ │ │ │ -00034390: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ -000343a0: 7469 6f6e 3a20 5368 6973 6869 5f64 6e73  tion: Shishi_dns
│ │ │ │ -000343b0: 2073 6869 7368 695f 7265 736f 6c76 2028   shishi_resolv (
│ │ │ │ -000343c0: 636f 6e73 7420 6368 6172 202a 205a 4f4e  const char * ZON
│ │ │ │ -000343d0: 452c 0a20 2020 2020 2020 2020 2075 696e  E,.          uin
│ │ │ │ -000343e0: 7431 365f 7420 5155 4552 5954 5950 4529  t16_t QUERYTYPE)
│ │ │ │ -000343f0: 0a20 2020 2020 5a4f 4e45 3a20 446f 6d61  .     ZONE: Doma
│ │ │ │ -00034400: 696e 206e 616d 6520 6f66 2061 7574 6865  in name of authe
│ │ │ │ -00034410: 6e74 6963 6174 696f 6e20 7a6f 6e65 2c20  ntication zone, 
│ │ │ │ -00034420: 652e 672e 2020 2245 5841 4d50 4c45 2e4f  e.g.  "EXAMPLE.O
│ │ │ │ -00034430: 5247 220a 2020 2020 2051 5545 5259 5459  RG".     QUERYTY
│ │ │ │ -00034440: 5045 3a20 5479 7065 206f 6620 646f 6d61  PE: Type of doma
│ │ │ │ -00034450: 696e 2064 6174 6120 746f 2071 7565 7279  in data to query
│ │ │ │ -00034460: 2066 6f72 2e0a 0a20 2020 2020 2a44 6573   for...     *Des
│ │ │ │ -00034470: 6372 6970 7469 6f6e 3a2a 2051 7565 7269  cription:* Queri
│ │ │ │ -00034480: 6573 2074 6865 2044 4e53 2072 6573 6f6c  es the DNS resol
│ │ │ │ -00034490: 7665 7220 666f 7220 6461 7461 206f 6620  ver for data of 
│ │ │ │ -000344a0: 7479 7065 2051 5545 5259 5459 5045 0a20  type QUERYTYPE. 
│ │ │ │ -000344b0: 2020 2020 6162 6f75 7420 7468 6520 646f      about the do
│ │ │ │ -000344c0: 6d61 696e 206e 616d 6520 5a4f 4e45 2e20  main name ZONE. 
│ │ │ │ -000344d0: 2043 7572 7265 6e74 6c79 2c20 7468 6520   Currently, the 
│ │ │ │ -000344e0: 7479 7065 7320 e280 9853 4849 5348 495f  types ...SHISHI_
│ │ │ │ -000344f0: 444e 535f 5458 54e2 8099 0a20 2020 2020  DNS_TXT....     
│ │ │ │ -00034500: 616e 6420 e280 9853 4849 5348 495f 444e  and ...SHISHI_DN
│ │ │ │ -00034510: 535f 5352 56e2 8099 2061 7265 2074 6865  S_SRV... are the
│ │ │ │ -00034520: 206f 6e6c 7920 7375 7070 6f72 7465 6420   only supported 
│ │ │ │ -00034530: 6b69 6e64 732e 0a0a 2020 2020 2041 6674  kinds...     Aft
│ │ │ │ -00034540: 6572 2069 7473 2075 7365 2c20 7468 6520  er its use, the 
│ │ │ │ -00034550: 7265 7475 726e 6564 206c 6973 7420 7368  returned list sh
│ │ │ │ -00034560: 6f75 6c64 2062 6520 6465 616c 6c6f 6361  ould be dealloca
│ │ │ │ -00034570: 7465 6420 6279 2061 2063 616c 6c20 746f  ted by a call to
│ │ │ │ -00034580: 0a20 2020 2020 e280 9873 6869 7368 695f  .     ...shishi_
│ │ │ │ -00034590: 7265 736f 6c76 5f66 7265 6528 29e2 8099  resolv_free()...
│ │ │ │ -000345a0: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ -000345b0: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ -000345c0: 6120 6c69 6e6b 6564 206c 6973 7420 6f66  a linked list of
│ │ │ │ -000345d0: 2044 4e53 2072 6573 6f75 7263 6520 7265   DNS resource re
│ │ │ │ -000345e0: 636f 7264 732c 206f 720a 2020 2020 20e2  cords, or.     .
│ │ │ │ -000345f0: 8098 4e55 4c4c e280 9920 6966 2074 6865  ..NULL... if the
│ │ │ │ -00034600: 2071 7565 7279 2066 6169 6c65 642e 0a0a   query failed...
│ │ │ │ -00034610: 7368 6973 6869 5f72 6573 6f6c 765f 6672  shishi_resolv_fr
│ │ │ │ -00034620: 6565 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ee.-------------
│ │ │ │ -00034630: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ -00034640: 696f 6e3a 2076 6f69 6420 7368 6973 6869  ion: void shishi
│ │ │ │ -00034650: 5f72 6573 6f6c 765f 6672 6565 2028 5368  _resolv_free (Sh
│ │ │ │ -00034660: 6973 6869 5f64 6e73 2052 5253 290a 2020  ishi_dns RRS).  
│ │ │ │ -00034670: 2020 2052 5253 3a20 4c69 7374 206f 6620     RRS: List of 
│ │ │ │ -00034680: 444e 5320 5252 7320 6173 2072 6574 7572  DNS RRs as retur
│ │ │ │ -00034690: 6e65 6420 6279 20e2 8098 7368 6973 6869  ned by ...shishi
│ │ │ │ -000346a0: 5f72 6573 6f6c 7628 29e2 8099 2e0a 0a20  _resolv()...... 
│ │ │ │ -000346b0: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -000346c0: 3a2a 2044 6561 6c6c 6f63 6174 6573 2061  :* Deallocates a
│ │ │ │ -000346d0: 206c 6973 7420 6f66 2044 4e53 2072 6573   list of DNS res
│ │ │ │ -000346e0: 6f75 7263 6520 7265 636f 7264 7320 7265  ource records re
│ │ │ │ -000346f0: 7475 726e 6564 0a20 2020 2020 6279 2061  turned.     by a
│ │ │ │ -00034700: 2063 616c 6c20 746f 20e2 8098 7368 6973   call to ...shis
│ │ │ │ -00034710: 6869 5f72 6573 6f6c 7628 29e2 8099 2e0a  hi_resolv().....
│ │ │ │ -00034720: 0a1f 0a46 696c 653a 2073 6869 7368 692e  ...File: shishi.
│ │ │ │ -00034730: 696e 666f 2c20 204e 6f64 653a 2041 534e  info,  Node: ASN
│ │ │ │ -00034740: 2e31 2046 756e 6374 696f 6e73 2c20 204e  .1 Functions,  N
│ │ │ │ -00034750: 6578 743a 2045 7272 6f72 2048 616e 646c  ext: Error Handl
│ │ │ │ -00034760: 696e 672c 2020 5072 6576 3a20 5574 696c  ing,  Prev: Util
│ │ │ │ -00034770: 6974 7920 4675 6e63 7469 6f6e 732c 2020  ity Functions,  
│ │ │ │ -00034780: 5570 3a20 5072 6f67 7261 6d6d 696e 6720  Up: Programming 
│ │ │ │ -00034790: 4d61 6e75 616c 0a0a 352e 3136 2041 534e  Manual..5.16 ASN
│ │ │ │ -000347a0: 2e31 2046 756e 6374 696f 6e73 0a3d 3d3d  .1 Functions.===
│ │ │ │ +000340f0: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ +00034100: 2069 6e74 2073 6869 7368 695f 7072 6f6d   int shishi_prom
│ │ │ │ +00034110: 7074 5f70 6173 7377 6f72 6420 2853 6869  pt_password (Shi
│ │ │ │ +00034120: 7368 6920 2a20 4841 4e44 4c45 2c20 6368  shi * HANDLE, ch
│ │ │ │ +00034130: 6172 202a 2a20 532c 0a20 2020 2020 2020  ar ** S,.       
│ │ │ │ +00034140: 2020 2063 6f6e 7374 2063 6861 7220 2a20     const char * 
│ │ │ │ +00034150: 464f 524d 4154 2c20 2e2e 2e29 0a20 2020  FORMAT, ...).   
│ │ │ │ +00034160: 2020 4841 4e44 4c45 3a20 7368 6973 6869    HANDLE: shishi
│ │ │ │ +00034170: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ +00034180: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ +00034190: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ +000341a0: 2020 533a 2070 6f69 6e74 6572 2074 6f20    S: pointer to 
│ │ │ │ +000341b0: 6e65 776c 7920 616c 6c6f 6361 7465 6420  newly allocated 
│ │ │ │ +000341c0: 6f75 7470 7574 2073 7472 696e 6720 7769  output string wi
│ │ │ │ +000341d0: 7468 2072 6561 6420 7061 7373 776f 7264  th read password
│ │ │ │ +000341e0: 2e0a 2020 2020 2046 4f52 4d41 543a 2070  ..     FORMAT: p
│ │ │ │ +000341f0: 7269 6e74 6628 3329 2073 7479 6c65 2066  rintf(3) style f
│ │ │ │ +00034200: 6f72 6d61 7420 7374 7269 6e67 2e0a 2020  ormat string..  
│ │ │ │ +00034210: 2020 202e 2e2e 3a20 7072 696e 7466 2833     ...: printf(3
│ │ │ │ +00034220: 2920 7374 796c 6520 6172 6775 6d65 6e74  ) style argument
│ │ │ │ +00034230: 732e 0a0a 2020 2020 202a 4465 7363 7269  s...     *Descri
│ │ │ │ +00034240: 7074 696f 6e3a 2a20 466f 726d 6174 2061  ption:* Format a
│ │ │ │ +00034250: 6e64 2070 7269 6e74 2061 2070 726f 6d70  nd print a promp
│ │ │ │ +00034260: 742c 2061 6e64 2072 6561 6420 6120 7061  t, and read a pa
│ │ │ │ +00034270: 7373 776f 7264 2066 726f 6d0a 2020 2020  ssword from.    
│ │ │ │ +00034280: 2075 7365 722e 2020 5468 6520 7061 7373   user.  The pass
│ │ │ │ +00034290: 776f 7264 2069 7320 706f 7373 6962 6c79  word is possibly
│ │ │ │ +000342a0: 2063 6f6e 7665 7274 6564 2028 652e 672e   converted (e.g.
│ │ │ │ +000342b0: 2c20 636f 6e76 6572 7465 6420 6672 6f6d  , converted from
│ │ │ │ +000342c0: 0a20 2020 2020 4c61 7469 6e2d 3120 746f  .     Latin-1 to
│ │ │ │ +000342d0: 2055 5446 2d38 2c20 6f72 2070 726f 6365   UTF-8, or proce
│ │ │ │ +000342e0: 7373 6564 2075 7369 6e67 2053 7472 696e  ssed using Strin
│ │ │ │ +000342f0: 6770 7265 7020 7072 6f66 696c 6529 2066  gprep profile) f
│ │ │ │ +00034300: 6f6c 6c6f 7769 6e67 0a20 2020 2020 616e  ollowing.     an
│ │ │ │ +00034310: 7920 2273 7472 696e 6770 726f 6365 7373  y "stringprocess
│ │ │ │ +00034320: 2220 6b65 7977 6f72 6473 2069 6e20 636f  " keywords in co
│ │ │ │ +00034330: 6e66 6967 7572 6174 696f 6e20 6669 6c65  nfiguration file
│ │ │ │ +00034340: 732e 0a0a 2020 2020 202a 5265 7475 726e  s...     *Return
│ │ │ │ +00034350: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ +00034360: 2053 4849 5348 495f 4f4b 2069 6666 2073   SHISHI_OK iff s
│ │ │ │ +00034370: 7563 6365 7373 6675 6c2e 0a0a 7368 6973  uccessful...shis
│ │ │ │ +00034380: 6869 5f72 6573 6f6c 760a 2d2d 2d2d 2d2d  hi_resolv.------
│ │ │ │ +00034390: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +000343a0: 6374 696f 6e3a 2053 6869 7368 695f 646e  ction: Shishi_dn
│ │ │ │ +000343b0: 7320 7368 6973 6869 5f72 6573 6f6c 7620  s shishi_resolv 
│ │ │ │ +000343c0: 2863 6f6e 7374 2063 6861 7220 2a20 5a4f  (const char * ZO
│ │ │ │ +000343d0: 4e45 2c0a 2020 2020 2020 2020 2020 7569  NE,.          ui
│ │ │ │ +000343e0: 6e74 3136 5f74 2051 5545 5259 5459 5045  nt16_t QUERYTYPE
│ │ │ │ +000343f0: 290a 2020 2020 205a 4f4e 453a 2044 6f6d  ).     ZONE: Dom
│ │ │ │ +00034400: 6169 6e20 6e61 6d65 206f 6620 6175 7468  ain name of auth
│ │ │ │ +00034410: 656e 7469 6361 7469 6f6e 207a 6f6e 652c  entication zone,
│ │ │ │ +00034420: 2065 2e67 2e20 2022 4558 414d 504c 452e   e.g.  "EXAMPLE.
│ │ │ │ +00034430: 4f52 4722 0a20 2020 2020 5155 4552 5954  ORG".     QUERYT
│ │ │ │ +00034440: 5950 453a 2054 7970 6520 6f66 2064 6f6d  YPE: Type of dom
│ │ │ │ +00034450: 6169 6e20 6461 7461 2074 6f20 7175 6572  ain data to quer
│ │ │ │ +00034460: 7920 666f 722e 0a0a 2020 2020 202a 4465  y for...     *De
│ │ │ │ +00034470: 7363 7269 7074 696f 6e3a 2a20 5175 6572  scription:* Quer
│ │ │ │ +00034480: 6965 7320 7468 6520 444e 5320 7265 736f  ies the DNS reso
│ │ │ │ +00034490: 6c76 6572 2066 6f72 2064 6174 6120 6f66  lver for data of
│ │ │ │ +000344a0: 2074 7970 6520 5155 4552 5954 5950 450a   type QUERYTYPE.
│ │ │ │ +000344b0: 2020 2020 2061 626f 7574 2074 6865 2064       about the d
│ │ │ │ +000344c0: 6f6d 6169 6e20 6e61 6d65 205a 4f4e 452e  omain name ZONE.
│ │ │ │ +000344d0: 2020 4375 7272 656e 746c 792c 2074 6865    Currently, the
│ │ │ │ +000344e0: 2074 7970 6573 20e2 8098 5348 4953 4849   types ...SHISHI
│ │ │ │ +000344f0: 5f44 4e53 5f54 5854 e280 990a 2020 2020  _DNS_TXT....    
│ │ │ │ +00034500: 2061 6e64 20e2 8098 5348 4953 4849 5f44   and ...SHISHI_D
│ │ │ │ +00034510: 4e53 5f53 5256 e280 9920 6172 6520 7468  NS_SRV... are th
│ │ │ │ +00034520: 6520 6f6e 6c79 2073 7570 706f 7274 6564  e only supported
│ │ │ │ +00034530: 206b 696e 6473 2e0a 0a20 2020 2020 4166   kinds...     Af
│ │ │ │ +00034540: 7465 7220 6974 7320 7573 652c 2074 6865  ter its use, the
│ │ │ │ +00034550: 2072 6574 7572 6e65 6420 6c69 7374 2073   returned list s
│ │ │ │ +00034560: 686f 756c 6420 6265 2064 6561 6c6c 6f63  hould be dealloc
│ │ │ │ +00034570: 6174 6564 2062 7920 6120 6361 6c6c 2074  ated by a call t
│ │ │ │ +00034580: 6f0a 2020 2020 20e2 8098 7368 6973 6869  o.     ...shishi
│ │ │ │ +00034590: 5f72 6573 6f6c 765f 6672 6565 2829 e280  _resolv_free()..
│ │ │ │ +000345a0: 992e 0a0a 2020 2020 202a 5265 7475 726e  ....     *Return
│ │ │ │ +000345b0: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ +000345c0: 2061 206c 696e 6b65 6420 6c69 7374 206f   a linked list o
│ │ │ │ +000345d0: 6620 444e 5320 7265 736f 7572 6365 2072  f DNS resource r
│ │ │ │ +000345e0: 6563 6f72 6473 2c20 6f72 0a20 2020 2020  ecords, or.     
│ │ │ │ +000345f0: e280 984e 554c 4ce2 8099 2069 6620 7468  ...NULL... if th
│ │ │ │ +00034600: 6520 7175 6572 7920 6661 696c 6564 2e0a  e query failed..
│ │ │ │ +00034610: 0a73 6869 7368 695f 7265 736f 6c76 5f66  .shishi_resolv_f
│ │ │ │ +00034620: 7265 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ree.------------
│ │ │ │ +00034630: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ +00034640: 7469 6f6e 3a20 766f 6964 2073 6869 7368  tion: void shish
│ │ │ │ +00034650: 695f 7265 736f 6c76 5f66 7265 6520 2853  i_resolv_free (S
│ │ │ │ +00034660: 6869 7368 695f 646e 7320 5252 5329 0a20  hishi_dns RRS). 
│ │ │ │ +00034670: 2020 2020 5252 533a 204c 6973 7420 6f66      RRS: List of
│ │ │ │ +00034680: 2044 4e53 2052 5273 2061 7320 7265 7475   DNS RRs as retu
│ │ │ │ +00034690: 726e 6564 2062 7920 e280 9873 6869 7368  rned by ...shish
│ │ │ │ +000346a0: 695f 7265 736f 6c76 2829 e280 992e 0a0a  i_resolv()......
│ │ │ │ +000346b0: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ +000346c0: 6e3a 2a20 4465 616c 6c6f 6361 7465 7320  n:* Deallocates 
│ │ │ │ +000346d0: 6120 6c69 7374 206f 6620 444e 5320 7265  a list of DNS re
│ │ │ │ +000346e0: 736f 7572 6365 2072 6563 6f72 6473 2072  source records r
│ │ │ │ +000346f0: 6574 7572 6e65 640a 2020 2020 2062 7920  eturned.     by 
│ │ │ │ +00034700: 6120 6361 6c6c 2074 6f20 e280 9873 6869  a call to ...shi
│ │ │ │ +00034710: 7368 695f 7265 736f 6c76 2829 e280 992e  shi_resolv()....
│ │ │ │ +00034720: 0a0a 1f0a 4669 6c65 3a20 7368 6973 6869  ....File: shishi
│ │ │ │ +00034730: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 4153  .info,  Node: AS
│ │ │ │ +00034740: 4e2e 3120 4675 6e63 7469 6f6e 732c 2020  N.1 Functions,  
│ │ │ │ +00034750: 4e65 7874 3a20 4572 726f 7220 4861 6e64  Next: Error Hand
│ │ │ │ +00034760: 6c69 6e67 2c20 2050 7265 763a 2055 7469  ling,  Prev: Uti
│ │ │ │ +00034770: 6c69 7479 2046 756e 6374 696f 6e73 2c20  lity Functions, 
│ │ │ │ +00034780: 2055 703a 2050 726f 6772 616d 6d69 6e67   Up: Programming
│ │ │ │ +00034790: 204d 616e 7561 6c0a 0a35 2e31 3620 4153   Manual..5.16 AS
│ │ │ │ +000347a0: 4e2e 3120 4675 6e63 7469 6f6e 730a 3d3d  N.1 Functions.==
│ │ │ │  000347b0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ -000347c0: 3d0a 0a73 6869 7368 695f 6173 6e31 5f72  =..shishi_asn1_r
│ │ │ │ -000347d0: 6561 645f 696e 6c69 6e65 0a2d 2d2d 2d2d  ead_inline.-----
│ │ │ │ +000347c0: 3d3d 0a0a 7368 6973 6869 5f61 736e 315f  ==..shishi_asn1_
│ │ │ │ +000347d0: 7265 6164 5f69 6e6c 696e 650a 2d2d 2d2d  read_inline.----
│ │ │ │  000347e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000347f0: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ -00034800: 3a20 696e 7420 7368 6973 6869 5f61 736e  : int shishi_asn
│ │ │ │ -00034810: 315f 7265 6164 5f69 6e6c 696e 6520 2853  1_read_inline (S
│ │ │ │ -00034820: 6869 7368 6920 2a20 4841 4e44 4c45 2c0a  hishi * HANDLE,.
│ │ │ │ -00034830: 2020 2020 2020 2020 2020 5368 6973 6869            Shishi
│ │ │ │ -00034840: 5f61 736e 3120 4e4f 4445 2c20 636f 6e73  _asn1 NODE, cons
│ │ │ │ -00034850: 7420 6368 6172 202a 2046 4945 4c44 2c20  t char * FIELD, 
│ │ │ │ -00034860: 6368 6172 202a 2044 4154 412c 0a20 2020  char * DATA,.   
│ │ │ │ -00034870: 2020 2020 2020 2073 697a 655f 7420 2a20         size_t * 
│ │ │ │ -00034880: 4441 5441 4c45 4e29 0a20 2020 2020 4841  DATALEN).     HA
│ │ │ │ -00034890: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ -000348a0: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ -000348b0: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ -000348c0: 6974 2829 e280 992e 0a20 2020 2020 4e4f  it().....     NO
│ │ │ │ -000348d0: 4445 3a20 4153 4e2e 3120 7661 7269 6162  DE: ASN.1 variab
│ │ │ │ -000348e0: 6c65 2074 6f20 7265 6164 2066 6965 6c64  le to read field
│ │ │ │ -000348f0: 2066 726f 6d2e 0a20 2020 2020 4649 454c   from..     FIEL
│ │ │ │ -00034900: 443a 206e 616d 6520 6f66 2066 6965 6c64  D: name of field
│ │ │ │ -00034910: 2069 6e20 4e4f 4445 2074 6f20 7265 6164   in NODE to read
│ │ │ │ -00034920: 2e0a 2020 2020 2044 4154 413a 2070 7265  ..     DATA: pre
│ │ │ │ -00034930: 2d61 6c6c 6f63 6174 6564 206f 7574 7075  -allocated outpu
│ │ │ │ -00034940: 7420 6275 6666 6572 2074 6861 7420 7769  t buffer that wi
│ │ │ │ -00034950: 6c6c 2068 6f6c 6420 4153 4e2e 3120 6669  ll hold ASN.1 fi
│ │ │ │ -00034960: 656c 6420 6461 7461 2e0a 0a20 2020 2020  eld data...     
│ │ │ │ -00034970: 4441 5441 4c45 4e3a 206f 6e20 696e 7075  DATALEN: on inpu
│ │ │ │ -00034980: 742c 206d 6178 696d 756d 2073 697a 6520  t, maximum size 
│ │ │ │ -00034990: 6f66 206f 7574 7075 7420 6275 6666 6572  of output buffer
│ │ │ │ -000349a0: 2c20 6f6e 206f 7574 7075 742c 2061 6374  , on output, act
│ │ │ │ -000349b0: 7561 6c0a 2020 2020 2073 697a 6520 6f66  ual.     size of
│ │ │ │ -000349c0: 206f 7574 7075 7420 6275 6666 6572 2e0a   output buffer..
│ │ │ │ -000349d0: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -000349e0: 6f6e 3a2a 2045 7874 7261 6374 2064 6174  on:* Extract dat
│ │ │ │ -000349f0: 6120 7374 6f72 6564 2069 6e20 6120 4153  a stored in a AS
│ │ │ │ -00034a00: 4e2e 3120 6669 656c 6420 696e 746f 2061  N.1 field into a
│ │ │ │ -00034a10: 2066 6978 6564 0a20 2020 2020 7369 7a65   fixed.     size
│ │ │ │ -00034a20: 2062 7566 6665 7220 616c 6c6f 6361 7465   buffer allocate
│ │ │ │ -00034a30: 6420 6279 2063 616c 6c65 722e 0a0a 2020  d by caller...  
│ │ │ │ -00034a40: 2020 204e 6f74 6520 7468 6174 2073 696e     Note that sin
│ │ │ │ -00034a50: 6365 2069 7420 6973 2064 6966 6669 6375  ce it is difficu
│ │ │ │ -00034a60: 6c74 2074 6f20 7072 6564 6963 7420 7468  lt to predict th
│ │ │ │ -00034a70: 6520 6c65 6e67 7468 206f 6620 7468 6520  e length of the 
│ │ │ │ -00034a80: 6669 656c 642c 0a20 2020 2020 6974 2069  field,.     it i
│ │ │ │ -00034a90: 7320 6f66 7465 6e20 6265 7474 6572 2074  s often better t
│ │ │ │ -00034aa0: 6f20 7573 6520 e280 9873 6869 7368 695f  o use ...shishi_
│ │ │ │ -00034ab0: 6173 6e31 5f72 6561 6428 29e2 8099 2069  asn1_read()... i
│ │ │ │ -00034ac0: 6e73 7465 6164 2e0a 0a20 2020 2020 2a52  nstead...     *R
│ │ │ │ -00034ad0: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ -00034ae0: 7475 726e 7320 5348 4953 4849 5f4f 4b20  turns SHISHI_OK 
│ │ │ │ -00034af0: 6966 2073 7563 6365 7373 6675 6c2c 0a20  if successful,. 
│ │ │ │ -00034b00: 2020 2020 5348 4953 4849 5f41 534e 315f      SHISHI_ASN1_
│ │ │ │ -00034b10: 4e4f 5f45 4c45 4d45 4e54 2069 6620 7468  NO_ELEMENT if th
│ │ │ │ -00034b20: 6520 656c 656d 656e 7420 646f 206e 6f74  e element do not
│ │ │ │ -00034b30: 2065 7869 7374 2c0a 2020 2020 2053 4849   exist,.     SHI
│ │ │ │ -00034b40: 5348 495f 4153 4e31 5f4e 4f5f 5641 4c55  SHI_ASN1_NO_VALU
│ │ │ │ -00034b50: 4520 6966 2074 6865 2066 6965 6c64 2068  E if the field h
│ │ │ │ -00034b60: 6173 206e 6f20 7661 6c75 652c 206f 740a  as no value, ot.
│ │ │ │ -00034b70: 2020 2020 2053 4849 5348 495f 4153 4e31       SHISHI_ASN1
│ │ │ │ -00034b80: 5f45 5252 4f52 206f 7468 6572 7769 7365  _ERROR otherwise
│ │ │ │ -00034b90: 2e0a 0a73 6869 7368 695f 6173 6e31 5f72  ...shishi_asn1_r
│ │ │ │ -00034ba0: 6561 640a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ead.------------
│ │ │ │ -00034bb0: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -00034bc0: 6f6e 3a20 696e 7420 7368 6973 6869 5f61  on: int shishi_a
│ │ │ │ -00034bd0: 736e 315f 7265 6164 2028 5368 6973 6869  sn1_read (Shishi
│ │ │ │ -00034be0: 202a 2048 414e 444c 452c 2053 6869 7368   * HANDLE, Shish
│ │ │ │ -00034bf0: 695f 6173 6e31 204e 4f44 452c 0a20 2020  i_asn1 NODE,.   
│ │ │ │ -00034c00: 2020 2020 2020 2063 6f6e 7374 2063 6861         const cha
│ │ │ │ -00034c10: 7220 2a20 4649 454c 442c 2063 6861 7220  r * FIELD, char 
│ │ │ │ -00034c20: 2a2a 2044 4154 412c 2073 697a 655f 7420  ** DATA, size_t 
│ │ │ │ -00034c30: 2a20 4441 5441 4c45 4e29 0a20 2020 2020  * DATALEN).     
│ │ │ │ -00034c40: 4841 4e44 4c45 3a20 7368 6973 6869 2068  HANDLE: shishi h
│ │ │ │ -00034c50: 616e 646c 6520 6173 2061 6c6c 6f63 6174  andle as allocat
│ │ │ │ -00034c60: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ -00034c70: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ -00034c80: 4e4f 4445 3a20 4153 4e2e 3120 7661 7269  NODE: ASN.1 vari
│ │ │ │ -00034c90: 6162 6c65 2074 6f20 7265 6164 2066 6965  able to read fie
│ │ │ │ -00034ca0: 6c64 2066 726f 6d2e 0a20 2020 2020 4649  ld from..     FI
│ │ │ │ -00034cb0: 454c 443a 206e 616d 6520 6f66 2066 6965  ELD: name of fie
│ │ │ │ -00034cc0: 6c64 2069 6e20 4e4f 4445 2074 6f20 7265  ld in NODE to re
│ │ │ │ -00034cd0: 6164 2e0a 2020 2020 2044 4154 413a 206e  ad..     DATA: n
│ │ │ │ -00034ce0: 6577 6c79 2061 6c6c 6f63 6174 6564 206f  ewly allocated o
│ │ │ │ -00034cf0: 7574 7075 7420 6275 6666 6572 2074 6861  utput buffer tha
│ │ │ │ -00034d00: 7420 7769 6c6c 2068 6f6c 6420 4153 4e2e  t will hold ASN.
│ │ │ │ -00034d10: 3120 6669 656c 640a 2020 2020 2064 6174  1 field.     dat
│ │ │ │ -00034d20: 612e 0a20 2020 2020 4441 5441 4c45 4e3a  a..     DATALEN:
│ │ │ │ -00034d30: 2061 6374 7561 6c20 7369 7a65 206f 6620   actual size of 
│ │ │ │ -00034d40: 6f75 7470 7574 2062 7566 6665 722e 0a0a  output buffer...
│ │ │ │ -00034d50: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ -00034d60: 6e3a 2a20 4578 7472 6163 7420 6461 7461  n:* Extract data
│ │ │ │ -00034d70: 2073 746f 7265 6420 696e 2061 2041 534e   stored in a ASN
│ │ │ │ -00034d80: 2e31 2066 6965 6c64 2069 6e74 6f20 6120  .1 field into a 
│ │ │ │ -00034d90: 6e65 776c 790a 2020 2020 2061 6c6c 6f63  newly.     alloc
│ │ │ │ -00034da0: 6174 6564 2062 7566 6665 722e 2020 5468  ated buffer.  Th
│ │ │ │ -00034db0: 6520 6275 6666 6572 2077 696c 6c20 616c  e buffer will al
│ │ │ │ -00034dc0: 7761 7973 2062 6520 7a65 726f 2074 6572  ways be zero ter
│ │ │ │ -00034dd0: 6d69 6e61 7465 642c 2065 7665 6e0a 2020  minated, even.  
│ │ │ │ -00034de0: 2020 2074 686f 7567 6820 4441 5441 4c45     though DATALE
│ │ │ │ -00034df0: 4e20 7769 6c6c 206e 6f74 2069 6e63 6c75  N will not inclu
│ │ │ │ -00034e00: 6465 2074 6865 2061 6464 6564 207a 6572  de the added zer
│ │ │ │ -00034e10: 6f2e 0a0a 2020 2020 202a 5265 7475 726e  o...     *Return
│ │ │ │ -00034e20: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ -00034e30: 2053 4849 5348 495f 4f4b 2069 6620 7375   SHISHI_OK if su
│ │ │ │ -00034e40: 6363 6573 7366 756c 2c0a 2020 2020 2053  ccessful,.     S
│ │ │ │ -00034e50: 4849 5348 495f 4153 4e31 5f4e 4f5f 454c  HISHI_ASN1_NO_EL
│ │ │ │ -00034e60: 454d 454e 5420 6966 2074 6865 2065 6c65  EMENT if the ele
│ │ │ │ -00034e70: 6d65 6e74 2064 6f20 6e6f 7420 6578 6973  ment do not exis
│ │ │ │ -00034e80: 742c 0a20 2020 2020 5348 4953 4849 5f41  t,.     SHISHI_A
│ │ │ │ -00034e90: 534e 315f 4e4f 5f56 414c 5545 2069 6620  SN1_NO_VALUE if 
│ │ │ │ -00034ea0: 7468 6520 6669 656c 6420 6861 7320 6e6f  the field has no
│ │ │ │ -00034eb0: 2076 616c 7565 2c20 6f74 0a20 2020 2020   value, ot.     
│ │ │ │ -00034ec0: 5348 4953 4849 5f41 534e 315f 4552 524f  SHISHI_ASN1_ERRO
│ │ │ │ -00034ed0: 5220 6f74 6865 7277 6973 652e 0a0a 7368  R otherwise...sh
│ │ │ │ -00034ee0: 6973 6869 5f61 736e 315f 7265 6164 5f6f  ishi_asn1_read_o
│ │ │ │ -00034ef0: 7074 696f 6e61 6c0a 2d2d 2d2d 2d2d 2d2d  ptional.--------
│ │ │ │ +000347f0: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ +00034800: 6e3a 2069 6e74 2073 6869 7368 695f 6173  n: int shishi_as
│ │ │ │ +00034810: 6e31 5f72 6561 645f 696e 6c69 6e65 2028  n1_read_inline (
│ │ │ │ +00034820: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ +00034830: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ +00034840: 695f 6173 6e31 204e 4f44 452c 2063 6f6e  i_asn1 NODE, con
│ │ │ │ +00034850: 7374 2063 6861 7220 2a20 4649 454c 442c  st char * FIELD,
│ │ │ │ +00034860: 2063 6861 7220 2a20 4441 5441 2c0a 2020   char * DATA,.  
│ │ │ │ +00034870: 2020 2020 2020 2020 7369 7a65 5f74 202a          size_t *
│ │ │ │ +00034880: 2044 4154 414c 454e 290a 2020 2020 2048   DATALEN).     H
│ │ │ │ +00034890: 414e 444c 453a 2073 6869 7368 6920 6861  ANDLE: shishi ha
│ │ │ │ +000348a0: 6e64 6c65 2061 7320 616c 6c6f 6361 7465  ndle as allocate
│ │ │ │ +000348b0: 6420 6279 20e2 8098 7368 6973 6869 5f69  d by ...shishi_i
│ │ │ │ +000348c0: 6e69 7428 29e2 8099 2e0a 2020 2020 204e  nit().....     N
│ │ │ │ +000348d0: 4f44 453a 2041 534e 2e31 2076 6172 6961  ODE: ASN.1 varia
│ │ │ │ +000348e0: 626c 6520 746f 2072 6561 6420 6669 656c  ble to read fiel
│ │ │ │ +000348f0: 6420 6672 6f6d 2e0a 2020 2020 2046 4945  d from..     FIE
│ │ │ │ +00034900: 4c44 3a20 6e61 6d65 206f 6620 6669 656c  LD: name of fiel
│ │ │ │ +00034910: 6420 696e 204e 4f44 4520 746f 2072 6561  d in NODE to rea
│ │ │ │ +00034920: 642e 0a20 2020 2020 4441 5441 3a20 7072  d..     DATA: pr
│ │ │ │ +00034930: 652d 616c 6c6f 6361 7465 6420 6f75 7470  e-allocated outp
│ │ │ │ +00034940: 7574 2062 7566 6665 7220 7468 6174 2077  ut buffer that w
│ │ │ │ +00034950: 696c 6c20 686f 6c64 2041 534e 2e31 2066  ill hold ASN.1 f
│ │ │ │ +00034960: 6965 6c64 2064 6174 612e 0a0a 2020 2020  ield data...    
│ │ │ │ +00034970: 2044 4154 414c 454e 3a20 6f6e 2069 6e70   DATALEN: on inp
│ │ │ │ +00034980: 7574 2c20 6d61 7869 6d75 6d20 7369 7a65  ut, maximum size
│ │ │ │ +00034990: 206f 6620 6f75 7470 7574 2062 7566 6665   of output buffe
│ │ │ │ +000349a0: 722c 206f 6e20 6f75 7470 7574 2c20 6163  r, on output, ac
│ │ │ │ +000349b0: 7475 616c 0a20 2020 2020 7369 7a65 206f  tual.     size o
│ │ │ │ +000349c0: 6620 6f75 7470 7574 2062 7566 6665 722e  f output buffer.
│ │ │ │ +000349d0: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ +000349e0: 696f 6e3a 2a20 4578 7472 6163 7420 6461  ion:* Extract da
│ │ │ │ +000349f0: 7461 2073 746f 7265 6420 696e 2061 2041  ta stored in a A
│ │ │ │ +00034a00: 534e 2e31 2066 6965 6c64 2069 6e74 6f20  SN.1 field into 
│ │ │ │ +00034a10: 6120 6669 7865 640a 2020 2020 2073 697a  a fixed.     siz
│ │ │ │ +00034a20: 6520 6275 6666 6572 2061 6c6c 6f63 6174  e buffer allocat
│ │ │ │ +00034a30: 6564 2062 7920 6361 6c6c 6572 2e0a 0a20  ed by caller... 
│ │ │ │ +00034a40: 2020 2020 4e6f 7465 2074 6861 7420 7369      Note that si
│ │ │ │ +00034a50: 6e63 6520 6974 2069 7320 6469 6666 6963  nce it is diffic
│ │ │ │ +00034a60: 756c 7420 746f 2070 7265 6469 6374 2074  ult to predict t
│ │ │ │ +00034a70: 6865 206c 656e 6774 6820 6f66 2074 6865  he length of the
│ │ │ │ +00034a80: 2066 6965 6c64 2c0a 2020 2020 2069 7420   field,.     it 
│ │ │ │ +00034a90: 6973 206f 6674 656e 2062 6574 7465 7220  is often better 
│ │ │ │ +00034aa0: 746f 2075 7365 20e2 8098 7368 6973 6869  to use ...shishi
│ │ │ │ +00034ab0: 5f61 736e 315f 7265 6164 2829 e280 9920  _asn1_read()... 
│ │ │ │ +00034ac0: 696e 7374 6561 642e 0a0a 2020 2020 202a  instead...     *
│ │ │ │ +00034ad0: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ +00034ae0: 6574 7572 6e73 2053 4849 5348 495f 4f4b  eturns SHISHI_OK
│ │ │ │ +00034af0: 2069 6620 7375 6363 6573 7366 756c 2c0a   if successful,.
│ │ │ │ +00034b00: 2020 2020 2053 4849 5348 495f 4153 4e31       SHISHI_ASN1
│ │ │ │ +00034b10: 5f4e 4f5f 454c 454d 454e 5420 6966 2074  _NO_ELEMENT if t
│ │ │ │ +00034b20: 6865 2065 6c65 6d65 6e74 2064 6f20 6e6f  he element do no
│ │ │ │ +00034b30: 7420 6578 6973 742c 0a20 2020 2020 5348  t exist,.     SH
│ │ │ │ +00034b40: 4953 4849 5f41 534e 315f 4e4f 5f56 414c  ISHI_ASN1_NO_VAL
│ │ │ │ +00034b50: 5545 2069 6620 7468 6520 6669 656c 6420  UE if the field 
│ │ │ │ +00034b60: 6861 7320 6e6f 2076 616c 7565 2c20 6f74  has no value, ot
│ │ │ │ +00034b70: 0a20 2020 2020 5348 4953 4849 5f41 534e  .     SHISHI_ASN
│ │ │ │ +00034b80: 315f 4552 524f 5220 6f74 6865 7277 6973  1_ERROR otherwis
│ │ │ │ +00034b90: 652e 0a0a 7368 6973 6869 5f61 736e 315f  e...shishi_asn1_
│ │ │ │ +00034ba0: 7265 6164 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  read.-----------
│ │ │ │ +00034bb0: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +00034bc0: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ +00034bd0: 6173 6e31 5f72 6561 6420 2853 6869 7368  asn1_read (Shish
│ │ │ │ +00034be0: 6920 2a20 4841 4e44 4c45 2c20 5368 6973  i * HANDLE, Shis
│ │ │ │ +00034bf0: 6869 5f61 736e 3120 4e4f 4445 2c0a 2020  hi_asn1 NODE,.  
│ │ │ │ +00034c00: 2020 2020 2020 2020 636f 6e73 7420 6368          const ch
│ │ │ │ +00034c10: 6172 202a 2046 4945 4c44 2c20 6368 6172  ar * FIELD, char
│ │ │ │ +00034c20: 202a 2a20 4441 5441 2c20 7369 7a65 5f74   ** DATA, size_t
│ │ │ │ +00034c30: 202a 2044 4154 414c 454e 290a 2020 2020   * DATALEN).    
│ │ │ │ +00034c40: 2048 414e 444c 453a 2073 6869 7368 6920   HANDLE: shishi 
│ │ │ │ +00034c50: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ +00034c60: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ +00034c70: 5f69 6e69 7428 29e2 8099 2e0a 2020 2020  _init().....    
│ │ │ │ +00034c80: 204e 4f44 453a 2041 534e 2e31 2076 6172   NODE: ASN.1 var
│ │ │ │ +00034c90: 6961 626c 6520 746f 2072 6561 6420 6669  iable to read fi
│ │ │ │ +00034ca0: 656c 6420 6672 6f6d 2e0a 2020 2020 2046  eld from..     F
│ │ │ │ +00034cb0: 4945 4c44 3a20 6e61 6d65 206f 6620 6669  IELD: name of fi
│ │ │ │ +00034cc0: 656c 6420 696e 204e 4f44 4520 746f 2072  eld in NODE to r
│ │ │ │ +00034cd0: 6561 642e 0a20 2020 2020 4441 5441 3a20  ead..     DATA: 
│ │ │ │ +00034ce0: 6e65 776c 7920 616c 6c6f 6361 7465 6420  newly allocated 
│ │ │ │ +00034cf0: 6f75 7470 7574 2062 7566 6665 7220 7468  output buffer th
│ │ │ │ +00034d00: 6174 2077 696c 6c20 686f 6c64 2041 534e  at will hold ASN
│ │ │ │ +00034d10: 2e31 2066 6965 6c64 0a20 2020 2020 6461  .1 field.     da
│ │ │ │ +00034d20: 7461 2e0a 2020 2020 2044 4154 414c 454e  ta..     DATALEN
│ │ │ │ +00034d30: 3a20 6163 7475 616c 2073 697a 6520 6f66  : actual size of
│ │ │ │ +00034d40: 206f 7574 7075 7420 6275 6666 6572 2e0a   output buffer..
│ │ │ │ +00034d50: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +00034d60: 6f6e 3a2a 2045 7874 7261 6374 2064 6174  on:* Extract dat
│ │ │ │ +00034d70: 6120 7374 6f72 6564 2069 6e20 6120 4153  a stored in a AS
│ │ │ │ +00034d80: 4e2e 3120 6669 656c 6420 696e 746f 2061  N.1 field into a
│ │ │ │ +00034d90: 206e 6577 6c79 0a20 2020 2020 616c 6c6f   newly.     allo
│ │ │ │ +00034da0: 6361 7465 6420 6275 6666 6572 2e20 2054  cated buffer.  T
│ │ │ │ +00034db0: 6865 2062 7566 6665 7220 7769 6c6c 2061  he buffer will a
│ │ │ │ +00034dc0: 6c77 6179 7320 6265 207a 6572 6f20 7465  lways be zero te
│ │ │ │ +00034dd0: 726d 696e 6174 6564 2c20 6576 656e 0a20  rminated, even. 
│ │ │ │ +00034de0: 2020 2020 7468 6f75 6768 2044 4154 414c      though DATAL
│ │ │ │ +00034df0: 454e 2077 696c 6c20 6e6f 7420 696e 636c  EN will not incl
│ │ │ │ +00034e00: 7564 6520 7468 6520 6164 6465 6420 7a65  ude the added ze
│ │ │ │ +00034e10: 726f 2e0a 0a20 2020 2020 2a52 6574 7572  ro...     *Retur
│ │ │ │ +00034e20: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ +00034e30: 7320 5348 4953 4849 5f4f 4b20 6966 2073  s SHISHI_OK if s
│ │ │ │ +00034e40: 7563 6365 7373 6675 6c2c 0a20 2020 2020  uccessful,.     
│ │ │ │ +00034e50: 5348 4953 4849 5f41 534e 315f 4e4f 5f45  SHISHI_ASN1_NO_E
│ │ │ │ +00034e60: 4c45 4d45 4e54 2069 6620 7468 6520 656c  LEMENT if the el
│ │ │ │ +00034e70: 656d 656e 7420 646f 206e 6f74 2065 7869  ement do not exi
│ │ │ │ +00034e80: 7374 2c0a 2020 2020 2053 4849 5348 495f  st,.     SHISHI_
│ │ │ │ +00034e90: 4153 4e31 5f4e 4f5f 5641 4c55 4520 6966  ASN1_NO_VALUE if
│ │ │ │ +00034ea0: 2074 6865 2066 6965 6c64 2068 6173 206e   the field has n
│ │ │ │ +00034eb0: 6f20 7661 6c75 652c 206f 740a 2020 2020  o value, ot.    
│ │ │ │ +00034ec0: 2053 4849 5348 495f 4153 4e31 5f45 5252   SHISHI_ASN1_ERR
│ │ │ │ +00034ed0: 4f52 206f 7468 6572 7769 7365 2e0a 0a73  OR otherwise...s
│ │ │ │ +00034ee0: 6869 7368 695f 6173 6e31 5f72 6561 645f  hishi_asn1_read_
│ │ │ │ +00034ef0: 6f70 7469 6f6e 616c 0a2d 2d2d 2d2d 2d2d  optional.-------
│ │ │ │  00034f00: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00034f10: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ -00034f20: 2069 6e74 2073 6869 7368 695f 6173 6e31   int shishi_asn1
│ │ │ │ -00034f30: 5f72 6561 645f 6f70 7469 6f6e 616c 2028  _read_optional (
│ │ │ │ -00034f40: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ -00034f50: 0a20 2020 2020 2020 2020 2053 6869 7368  .          Shish
│ │ │ │ -00034f60: 695f 6173 6e31 204e 4f44 452c 2063 6f6e  i_asn1 NODE, con
│ │ │ │ -00034f70: 7374 2063 6861 7220 2a20 4649 454c 442c  st char * FIELD,
│ │ │ │ -00034f80: 2063 6861 7220 2a2a 2044 4154 412c 0a20   char ** DATA,. 
│ │ │ │ -00034f90: 2020 2020 2020 2020 2073 697a 655f 7420           size_t 
│ │ │ │ -00034fa0: 2a20 4441 5441 4c45 4e29 0a20 2020 2020  * DATALEN).     
│ │ │ │ -00034fb0: 4841 4e44 4c45 3a20 7368 6973 6869 2068  HANDLE: shishi h
│ │ │ │ -00034fc0: 616e 646c 6520 6173 2061 6c6c 6f63 6174  andle as allocat
│ │ │ │ -00034fd0: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ -00034fe0: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ -00034ff0: 4e4f 4445 3a20 4153 4e2e 3120 7661 7269  NODE: ASN.1 vari
│ │ │ │ -00035000: 6162 6c65 2074 6f20 7265 6164 2066 6965  able to read fie
│ │ │ │ -00035010: 6c64 2066 726f 6d2e 0a20 2020 2020 4649  ld from..     FI
│ │ │ │ -00035020: 454c 443a 206e 616d 6520 6f66 2066 6965  ELD: name of fie
│ │ │ │ -00035030: 6c64 2069 6e20 4e4f 4445 2074 6f20 7265  ld in NODE to re
│ │ │ │ -00035040: 6164 2e0a 2020 2020 2044 4154 413a 206e  ad..     DATA: n
│ │ │ │ -00035050: 6577 6c79 2061 6c6c 6f63 6174 6564 206f  ewly allocated o
│ │ │ │ -00035060: 7574 7075 7420 6275 6666 6572 2074 6861  utput buffer tha
│ │ │ │ -00035070: 7420 7769 6c6c 2068 6f6c 6420 4153 4e2e  t will hold ASN.
│ │ │ │ -00035080: 3120 6669 656c 640a 2020 2020 2064 6174  1 field.     dat
│ │ │ │ -00035090: 612e 0a20 2020 2020 4441 5441 4c45 4e3a  a..     DATALEN:
│ │ │ │ -000350a0: 2061 6374 7561 6c20 7369 7a65 206f 6620   actual size of 
│ │ │ │ -000350b0: 6f75 7470 7574 2062 7566 6665 722e 0a0a  output buffer...
│ │ │ │ -000350c0: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ -000350d0: 6e3a 2a20 4578 7472 6163 7420 6461 7461  n:* Extract data
│ │ │ │ -000350e0: 2073 746f 7265 6420 696e 2061 2041 534e   stored in a ASN
│ │ │ │ -000350f0: 2e31 2066 6965 6c64 2069 6e74 6f20 6120  .1 field into a 
│ │ │ │ -00035100: 6e65 776c 790a 2020 2020 2061 6c6c 6f63  newly.     alloc
│ │ │ │ -00035110: 6174 6564 2062 7566 6665 722e 2020 4966  ated buffer.  If
│ │ │ │ -00035120: 2074 6865 2066 6965 6c64 2064 6f65 7320   the field does 
│ │ │ │ -00035130: 6e6f 7420 6578 6973 7420 2869 2e65 2e2c  not exist (i.e.,
│ │ │ │ -00035140: 0a20 2020 2020 5348 4953 4849 5f41 534e  .     SHISHI_ASN
│ │ │ │ -00035150: 315f 4e4f 5f45 4c45 4d45 4e54 292c 2074  1_NO_ELEMENT), t
│ │ │ │ -00035160: 6869 7320 6675 6e63 7469 6f6e 2073 6574  his function set
│ │ │ │ -00035170: 2064 6174 616c 656e 2074 6f20 3020 616e   datalen to 0 an
│ │ │ │ -00035180: 640a 2020 2020 2073 7563 6365 6564 732e  d.     succeeds.
│ │ │ │ -00035190: 2020 4361 6e20 6265 2075 7365 6675 6c20    Can be useful 
│ │ │ │ -000351a0: 746f 2072 6561 6420 4153 4e2e 3120 6669  to read ASN.1 fi
│ │ │ │ -000351b0: 656c 6473 2077 6869 6368 2061 7265 206d  elds which are m
│ │ │ │ -000351c0: 6172 6b65 640a 2020 2020 204f 5054 494f  arked.     OPTIO
│ │ │ │ -000351d0: 4e41 4c20 696e 2074 6865 2067 7261 6d6d  NAL in the gramm
│ │ │ │ -000351e0: 6172 2c20 6966 2079 6f75 2077 616e 7420  ar, if you want 
│ │ │ │ -000351f0: 746f 2061 766f 6964 2073 7065 6369 616c  to avoid special
│ │ │ │ -00035200: 2065 7272 6f72 0a20 2020 2020 6861 6e64   error.     hand
│ │ │ │ -00035210: 6c69 6e67 2069 6e20 796f 7572 2063 6f64  ling in your cod
│ │ │ │ -00035220: 652e 0a0a 2020 2020 202a 5265 7475 726e  e...     *Return
│ │ │ │ -00035230: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ -00035240: 2053 4849 5348 495f 4f4b 2069 6620 7375   SHISHI_OK if su
│ │ │ │ -00035250: 6363 6573 7366 756c 2c0a 2020 2020 2053  ccessful,.     S
│ │ │ │ -00035260: 4849 5348 495f 4153 4e31 5f4e 4f5f 5641  HISHI_ASN1_NO_VA
│ │ │ │ -00035270: 4c55 4520 6966 2074 6865 2066 6965 6c64  LUE if the field
│ │ │ │ -00035280: 2068 6173 206e 6f20 7661 6c75 652c 206f   has no value, o
│ │ │ │ -00035290: 740a 2020 2020 2053 4849 5348 495f 4153  t.     SHISHI_AS
│ │ │ │ -000352a0: 4e31 5f45 5252 4f52 206f 7468 6572 7769  N1_ERROR otherwi
│ │ │ │ -000352b0: 7365 2e0a 0a73 6869 7368 695f 6173 6e31  se...shishi_asn1
│ │ │ │ -000352c0: 5f64 6f6e 650a 2d2d 2d2d 2d2d 2d2d 2d2d  _done.----------
│ │ │ │ -000352d0: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ -000352e0: 7469 6f6e 3a20 766f 6964 2073 6869 7368  tion: void shish
│ │ │ │ -000352f0: 695f 6173 6e31 5f64 6f6e 6520 2853 6869  i_asn1_done (Shi
│ │ │ │ -00035300: 7368 6920 2a20 4841 4e44 4c45 2c20 5368  shi * HANDLE, Sh
│ │ │ │ -00035310: 6973 6869 5f61 736e 3120 4e4f 4445 290a  ishi_asn1 NODE).
│ │ │ │ -00035320: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ -00035330: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ -00035340: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ -00035350: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ -00035360: 2020 2020 204e 4f44 453a 2041 534e 2e31       NODE: ASN.1
│ │ │ │ -00035370: 206e 6f64 6520 746f 2064 6561 6c6c 6f63   node to dealloc
│ │ │ │ -00035380: 6174 652e 0a0a 2020 2020 202a 4465 7363  ate...     *Desc
│ │ │ │ -00035390: 7269 7074 696f 6e3a 2a20 4465 616c 6c6f  ription:* Deallo
│ │ │ │ -000353a0: 6361 7465 2072 6573 6f75 7263 6573 2061  cate resources a
│ │ │ │ -000353b0: 7373 6f63 6961 7465 6420 7769 7468 2041  ssociated with A
│ │ │ │ -000353c0: 534e 2e31 0a20 2020 2020 7374 7275 6374  SN.1.     struct
│ │ │ │ -000353d0: 7572 652e 2020 4e6f 7465 2074 6861 7420  ure.  Note that 
│ │ │ │ -000353e0: 7468 6520 6e6f 6465 206d 7573 7420 6e6f  the node must no
│ │ │ │ -000353f0: 7420 6265 2075 7365 6420 6166 7465 7220  t be used after 
│ │ │ │ -00035400: 7468 6973 2063 616c 6c2e 0a0a 7368 6973  this call...shis
│ │ │ │ -00035410: 6869 5f61 736e 315f 7061 5f65 6e63 5f74  hi_asn1_pa_enc_t
│ │ │ │ -00035420: 735f 656e 630a 2d2d 2d2d 2d2d 2d2d 2d2d  s_enc.----------
│ │ │ │ -00035430: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -00035440: 0a20 2d2d 2046 756e 6374 696f 6e3a 2053  . -- Function: S
│ │ │ │ -00035450: 6869 7368 695f 6173 6e31 2073 6869 7368  hishi_asn1 shish
│ │ │ │ -00035460: 695f 6173 6e31 5f70 615f 656e 635f 7473  i_asn1_pa_enc_ts
│ │ │ │ -00035470: 5f65 6e63 2028 5368 6973 6869 202a 2048  _enc (Shishi * H
│ │ │ │ -00035480: 414e 444c 4529 0a20 2020 2020 4841 4e44  ANDLE).     HAND
│ │ │ │ -00035490: 4c45 3a20 7368 6973 6869 2068 616e 646c  LE: shishi handl
│ │ │ │ -000354a0: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ -000354b0: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ -000354c0: 2829 e280 992e 0a0a 2020 2020 202a 4465  ()......     *De
│ │ │ │ -000354d0: 7363 7269 7074 696f 6e3a 2a20 4372 6561  scription:* Crea
│ │ │ │ -000354e0: 7465 206e 6577 2041 534e 2e31 2073 7472  te new ASN.1 str
│ │ │ │ -000354f0: 7563 7475 7265 2066 6f72 2050 412d 454e  ucture for PA-EN
│ │ │ │ -00035500: 432d 5453 2d45 4e43 2e0a 0a20 2020 2020  C-TS-ENC...     
│ │ │ │ -00035510: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ -00035520: 5265 7475 726e 7320 4153 4e2e 3120 7374  Returns ASN.1 st
│ │ │ │ -00035530: 7275 6374 7572 652e 0a0a 7368 6973 6869  ructure...shishi
│ │ │ │ -00035540: 5f61 736e 315f 656e 6372 7970 7465 6464  _asn1_encryptedd
│ │ │ │ -00035550: 6174 610a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ata.------------
│ │ │ │ -00035560: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -00035570: 2d2d 2046 756e 6374 696f 6e3a 2053 6869  -- Function: Shi
│ │ │ │ -00035580: 7368 695f 6173 6e31 2073 6869 7368 695f  shi_asn1 shishi_
│ │ │ │ -00035590: 6173 6e31 5f65 6e63 7279 7074 6564 6461  asn1_encryptedda
│ │ │ │ -000355a0: 7461 2028 5368 6973 6869 202a 2048 414e  ta (Shishi * HAN
│ │ │ │ -000355b0: 444c 4529 0a20 2020 2020 4841 4e44 4c45  DLE).     HANDLE
│ │ │ │ -000355c0: 3a20 7368 6973 6869 2068 616e 646c 6520  : shishi handle 
│ │ │ │ -000355d0: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ -000355e0: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ -000355f0: e280 992e 0a0a 2020 2020 202a 4465 7363  ......     *Desc
│ │ │ │ -00035600: 7269 7074 696f 6e3a 2a20 4372 6561 7465  ription:* Create
│ │ │ │ -00035610: 206e 6577 2041 534e 2e31 2073 7472 7563   new ASN.1 struc
│ │ │ │ -00035620: 7475 7265 2066 6f72 2045 6e63 7279 7074  ture for Encrypt
│ │ │ │ -00035630: 6564 4461 7461 0a0a 2020 2020 202a 5265  edData..     *Re
│ │ │ │ -00035640: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ -00035650: 7572 6e73 2041 534e 2e31 2073 7472 7563  urns ASN.1 struc
│ │ │ │ -00035660: 7475 7265 2e0a 0a73 6869 7368 695f 6173  ture...shishi_as
│ │ │ │ -00035670: 6e31 5f70 6164 6174 610a 2d2d 2d2d 2d2d  n1_padata.------
│ │ │ │ -00035680: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ -00035690: 2d20 4675 6e63 7469 6f6e 3a20 5368 6973  - Function: Shis
│ │ │ │ -000356a0: 6869 5f61 736e 3120 7368 6973 6869 5f61  hi_asn1 shishi_a
│ │ │ │ -000356b0: 736e 315f 7061 6461 7461 2028 5368 6973  sn1_padata (Shis
│ │ │ │ -000356c0: 6869 202a 2048 414e 444c 4529 0a20 2020  hi * HANDLE).   
│ │ │ │ -000356d0: 2020 4841 4e44 4c45 3a20 7368 6973 6869    HANDLE: shishi
│ │ │ │ -000356e0: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ -000356f0: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ -00035700: 695f 696e 6974 2829 e280 992e 0a0a 2020  i_init()......  
│ │ │ │ -00035710: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ -00035720: 2a20 4372 6561 7465 206e 6577 2041 534e  * Create new ASN
│ │ │ │ -00035730: 2e31 2073 7472 7563 7475 7265 2066 6f72  .1 structure for
│ │ │ │ -00035740: 2050 412d 4441 5441 2e0a 0a20 2020 2020   PA-DATA...     
│ │ │ │ -00035750: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ -00035760: 5265 7475 726e 7320 4153 4e2e 3120 7374  Returns ASN.1 st
│ │ │ │ -00035770: 7275 6374 7572 652e 0a0a 7368 6973 6869  ructure...shishi
│ │ │ │ -00035780: 5f61 736e 315f 6d65 7468 6f64 6461 7461  _asn1_methoddata
│ │ │ │ -00035790: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ -000357a0: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ -000357b0: 6374 696f 6e3a 2053 6869 7368 695f 6173  ction: Shishi_as
│ │ │ │ -000357c0: 6e31 2073 6869 7368 695f 6173 6e31 5f6d  n1 shishi_asn1_m
│ │ │ │ -000357d0: 6574 686f 6464 6174 6120 2853 6869 7368  ethoddata (Shish
│ │ │ │ -000357e0: 6920 2a20 4841 4e44 4c45 290a 2020 2020  i * HANDLE).    
│ │ │ │ -000357f0: 2048 414e 444c 453a 2073 6869 7368 6920   HANDLE: shishi 
│ │ │ │ -00035800: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ -00035810: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ -00035820: 5f69 6e69 7428 29e2 8099 2e0a 0a20 2020  _init()......   
│ │ │ │ -00035830: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ -00035840: 2043 7265 6174 6520 6e65 7720 4153 4e2e   Create new ASN.
│ │ │ │ -00035850: 3120 7374 7275 6374 7572 6520 666f 7220  1 structure for 
│ │ │ │ -00035860: 4d45 5448 4f44 2d44 4154 412e 0a0a 2020  METHOD-DATA...  
│ │ │ │ -00035870: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ -00035880: 3a2a 2052 6574 7572 6e73 2041 534e 2e31  :* Returns ASN.1
│ │ │ │ -00035890: 2073 7472 7563 7475 7265 2e0a 0a73 6869   structure...shi
│ │ │ │ -000358a0: 7368 695f 6173 6e31 5f65 7479 7065 5f69  shi_asn1_etype_i
│ │ │ │ -000358b0: 6e66 6f0a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  nfo.------------
│ │ │ │ -000358c0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ -000358d0: 4675 6e63 7469 6f6e 3a20 5368 6973 6869  Function: Shishi
│ │ │ │ -000358e0: 5f61 736e 3120 7368 6973 6869 5f61 736e  _asn1 shishi_asn
│ │ │ │ -000358f0: 315f 6574 7970 655f 696e 666f 2028 5368  1_etype_info (Sh
│ │ │ │ -00035900: 6973 6869 202a 2048 414e 444c 4529 0a20  ishi * HANDLE). 
│ │ │ │ -00035910: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ -00035920: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ -00035930: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ -00035940: 7368 695f 696e 6974 2829 e280 992e 0a0a  shi_init()......
│ │ │ │ -00035950: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ -00035960: 6e3a 2a20 4372 6561 7465 206e 6577 2041  n:* Create new A
│ │ │ │ -00035970: 534e 2e31 2073 7472 7563 7475 7265 2066  SN.1 structure f
│ │ │ │ -00035980: 6f72 2045 5459 5045 2d49 4e46 4f2e 0a0a  or ETYPE-INFO...
│ │ │ │ -00035990: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ -000359a0: 7565 3a2a 2052 6574 7572 6e73 2041 534e  ue:* Returns ASN
│ │ │ │ -000359b0: 2e31 2073 7472 7563 7475 7265 2e0a 0a73  .1 structure...s
│ │ │ │ -000359c0: 6869 7368 695f 6173 6e31 5f65 7479 7065  hishi_asn1_etype
│ │ │ │ -000359d0: 5f69 6e66 6f32 0a2d 2d2d 2d2d 2d2d 2d2d  _info2.---------
│ │ │ │ -000359e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -000359f0: 202d 2d20 4675 6e63 7469 6f6e 3a20 5368   -- Function: Sh
│ │ │ │ -00035a00: 6973 6869 5f61 736e 3120 7368 6973 6869  ishi_asn1 shishi
│ │ │ │ -00035a10: 5f61 736e 315f 6574 7970 655f 696e 666f  _asn1_etype_info
│ │ │ │ -00035a20: 3220 2853 6869 7368 6920 2a20 4841 4e44  2 (Shishi * HAND
│ │ │ │ -00035a30: 4c45 290a 2020 2020 2048 414e 444c 453a  LE).     HANDLE:
│ │ │ │ -00035a40: 2073 6869 7368 6920 6861 6e64 6c65 2061   shishi handle a
│ │ │ │ -00035a50: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ -00035a60: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ -00035a70: 8099 2e0a 0a20 2020 2020 2a44 6573 6372  .....     *Descr
│ │ │ │ -00035a80: 6970 7469 6f6e 3a2a 2043 7265 6174 6520  iption:* Create 
│ │ │ │ -00035a90: 6e65 7720 4153 4e2e 3120 7374 7275 6374  new ASN.1 struct
│ │ │ │ -00035aa0: 7572 6520 666f 7220 4554 5950 452d 494e  ure for ETYPE-IN
│ │ │ │ -00035ab0: 464f 322e 0a0a 2020 2020 202a 5265 7475  FO2...     *Retu
│ │ │ │ -00035ac0: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ -00035ad0: 6e73 2041 534e 2e31 2073 7472 7563 7475  ns ASN.1 structu
│ │ │ │ -00035ae0: 7265 2e0a 0a73 6869 7368 695f 6173 6e31  re...shishi_asn1
│ │ │ │ -00035af0: 5f61 7372 6571 0a2d 2d2d 2d2d 2d2d 2d2d  _asreq.---------
│ │ │ │ -00035b00: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -00035b10: 6e63 7469 6f6e 3a20 5368 6973 6869 5f61  nction: Shishi_a
│ │ │ │ -00035b20: 736e 3120 7368 6973 6869 5f61 736e 315f  sn1 shishi_asn1_
│ │ │ │ -00035b30: 6173 7265 7120 2853 6869 7368 6920 2a20  asreq (Shishi * 
│ │ │ │ -00035b40: 4841 4e44 4c45 290a 2020 2020 2048 414e  HANDLE).     HAN
│ │ │ │ -00035b50: 444c 453a 2073 6869 7368 6920 6861 6e64  DLE: shishi hand
│ │ │ │ -00035b60: 6c65 2061 7320 616c 6c6f 6361 7465 6420  le as allocated 
│ │ │ │ -00035b70: 6279 20e2 8098 7368 6973 6869 5f69 6e69  by ...shishi_ini
│ │ │ │ -00035b80: 7428 29e2 8099 2e0a 0a20 2020 2020 2a44  t()......     *D
│ │ │ │ -00035b90: 6573 6372 6970 7469 6f6e 3a2a 2043 7265  escription:* Cre
│ │ │ │ -00035ba0: 6174 6520 6e65 7720 4153 4e2e 3120 7374  ate new ASN.1 st
│ │ │ │ -00035bb0: 7275 6374 7572 6520 666f 7220 4153 2d52  ructure for AS-R
│ │ │ │ -00035bc0: 4551 2e0a 0a20 2020 2020 2a52 6574 7572  EQ...     *Retur
│ │ │ │ -00035bd0: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ -00035be0: 7320 4153 4e2e 3120 7374 7275 6374 7572  s ASN.1 structur
│ │ │ │ -00035bf0: 652e 0a0a 7368 6973 6869 5f61 736e 315f  e...shishi_asn1_
│ │ │ │ -00035c00: 6173 7265 700a 2d2d 2d2d 2d2d 2d2d 2d2d  asrep.----------
│ │ │ │ -00035c10: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ -00035c20: 6374 696f 6e3a 2053 6869 7368 695f 6173  ction: Shishi_as
│ │ │ │ -00035c30: 6e31 2073 6869 7368 695f 6173 6e31 5f61  n1 shishi_asn1_a
│ │ │ │ -00035c40: 7372 6570 2028 5368 6973 6869 202a 2048  srep (Shishi * H
│ │ │ │ -00035c50: 414e 444c 4529 0a20 2020 2020 4841 4e44  ANDLE).     HAND
│ │ │ │ -00035c60: 4c45 3a20 7368 6973 6869 2068 616e 646c  LE: shishi handl
│ │ │ │ -00035c70: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ -00035c80: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ -00035c90: 2829 e280 992e 0a0a 2020 2020 202a 4465  ()......     *De
│ │ │ │ -00035ca0: 7363 7269 7074 696f 6e3a 2a20 4372 6561  scription:* Crea
│ │ │ │ -00035cb0: 7465 206e 6577 2041 534e 2e31 2073 7472  te new ASN.1 str
│ │ │ │ -00035cc0: 7563 7475 7265 2066 6f72 2041 532d 5245  ucture for AS-RE
│ │ │ │ -00035cd0: 502e 0a0a 2020 2020 202a 5265 7475 726e  P...     *Return
│ │ │ │ -00035ce0: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ -00035cf0: 2041 534e 2e31 2073 7472 7563 7475 7265   ASN.1 structure
│ │ │ │ -00035d00: 2e0a 0a73 6869 7368 695f 6173 6e31 5f74  ...shishi_asn1_t
│ │ │ │ -00035d10: 6773 7265 710a 2d2d 2d2d 2d2d 2d2d 2d2d  gsreq.----------
│ │ │ │ -00035d20: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -00035d30: 6e63 7469 6f6e 3a20 5368 6973 6869 5f61  nction: Shishi_a
│ │ │ │ -00035d40: 736e 3120 7368 6973 6869 5f61 736e 315f  sn1 shishi_asn1_
│ │ │ │ -00035d50: 7467 7372 6571 2028 5368 6973 6869 202a  tgsreq (Shishi *
│ │ │ │ -00035d60: 2048 414e 444c 4529 0a20 2020 2020 4841   HANDLE).     HA
│ │ │ │ -00035d70: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ -00035d80: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ -00035d90: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ -00035da0: 6974 2829 e280 992e 0a0a 2020 2020 202a  it()......     *
│ │ │ │ -00035db0: 4465 7363 7269 7074 696f 6e3a 2a20 4372  Description:* Cr
│ │ │ │ -00035dc0: 6561 7465 206e 6577 2041 534e 2e31 2073  eate new ASN.1 s
│ │ │ │ -00035dd0: 7472 7563 7475 7265 2066 6f72 2054 4753  tructure for TGS
│ │ │ │ -00035de0: 2d52 4551 2e0a 0a20 2020 2020 2a52 6574  -REQ...     *Ret
│ │ │ │ -00035df0: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ -00035e00: 726e 7320 4153 4e2e 3120 7374 7275 6374  rns ASN.1 struct
│ │ │ │ -00035e10: 7572 652e 0a0a 7368 6973 6869 5f61 736e  ure...shishi_asn
│ │ │ │ -00035e20: 315f 7467 7372 6570 0a2d 2d2d 2d2d 2d2d  1_tgsrep.-------
│ │ │ │ -00035e30: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ -00035e40: 2046 756e 6374 696f 6e3a 2053 6869 7368   Function: Shish
│ │ │ │ -00035e50: 695f 6173 6e31 2073 6869 7368 695f 6173  i_asn1 shishi_as
│ │ │ │ -00035e60: 6e31 5f74 6773 7265 7020 2853 6869 7368  n1_tgsrep (Shish
│ │ │ │ -00035e70: 6920 2a20 4841 4e44 4c45 290a 2020 2020  i * HANDLE).    
│ │ │ │ -00035e80: 2048 414e 444c 453a 2073 6869 7368 6920   HANDLE: shishi 
│ │ │ │ -00035e90: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ -00035ea0: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ -00035eb0: 5f69 6e69 7428 29e2 8099 2e0a 0a20 2020  _init()......   
│ │ │ │ -00035ec0: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ -00035ed0: 2043 7265 6174 6520 6e65 7720 4153 4e2e   Create new ASN.
│ │ │ │ -00035ee0: 3120 7374 7275 6374 7572 6520 666f 7220  1 structure for 
│ │ │ │ -00035ef0: 5447 532d 5245 502e 0a0a 2020 2020 202a  TGS-REP...     *
│ │ │ │ -00035f00: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ -00035f10: 6574 7572 6e73 2041 534e 2e31 2073 7472  eturns ASN.1 str
│ │ │ │ -00035f20: 7563 7475 7265 2e0a 0a73 6869 7368 695f  ucture...shishi_
│ │ │ │ -00035f30: 6173 6e31 5f61 7072 6571 0a2d 2d2d 2d2d  asn1_apreq.-----
│ │ │ │ -00035f40: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ -00035f50: 2d20 4675 6e63 7469 6f6e 3a20 5368 6973  - Function: Shis
│ │ │ │ -00035f60: 6869 5f61 736e 3120 7368 6973 6869 5f61  hi_asn1 shishi_a
│ │ │ │ -00035f70: 736e 315f 6170 7265 7120 2853 6869 7368  sn1_apreq (Shish
│ │ │ │ -00035f80: 6920 2a20 4841 4e44 4c45 290a 2020 2020  i * HANDLE).    
│ │ │ │ -00035f90: 2048 414e 444c 453a 2073 6869 7368 6920   HANDLE: shishi 
│ │ │ │ -00035fa0: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ -00035fb0: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ -00035fc0: 5f69 6e69 7428 29e2 8099 2e0a 0a20 2020  _init()......   
│ │ │ │ -00035fd0: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ -00035fe0: 2043 7265 6174 6520 6e65 7720 4153 4e2e   Create new ASN.
│ │ │ │ -00035ff0: 3120 7374 7275 6374 7572 6520 666f 7220  1 structure for 
│ │ │ │ -00036000: 4150 2d52 4551 2e0a 0a20 2020 2020 2a52  AP-REQ...     *R
│ │ │ │ -00036010: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ -00036020: 7475 726e 7320 4153 4e2e 3120 7374 7275  turns ASN.1 stru
│ │ │ │ -00036030: 6374 7572 652e 0a0a 7368 6973 6869 5f61  cture...shishi_a
│ │ │ │ -00036040: 736e 315f 6170 7265 700a 2d2d 2d2d 2d2d  sn1_aprep.------
│ │ │ │ -00036050: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ -00036060: 2046 756e 6374 696f 6e3a 2053 6869 7368   Function: Shish
│ │ │ │ -00036070: 695f 6173 6e31 2073 6869 7368 695f 6173  i_asn1 shishi_as
│ │ │ │ -00036080: 6e31 5f61 7072 6570 2028 5368 6973 6869  n1_aprep (Shishi
│ │ │ │ -00036090: 202a 2048 414e 444c 4529 0a20 2020 2020   * HANDLE).     
│ │ │ │ -000360a0: 4841 4e44 4c45 3a20 7368 6973 6869 2068  HANDLE: shishi h
│ │ │ │ -000360b0: 616e 646c 6520 6173 2061 6c6c 6f63 6174  andle as allocat
│ │ │ │ -000360c0: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ -000360d0: 696e 6974 2829 e280 992e 0a0a 2020 2020  init()......    
│ │ │ │ -000360e0: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ -000360f0: 4372 6561 7465 206e 6577 2041 534e 2e31  Create new ASN.1
│ │ │ │ -00036100: 2073 7472 7563 7475 7265 2066 6f72 2041   structure for A
│ │ │ │ -00036110: 502d 5245 502e 0a0a 2020 2020 202a 5265  P-REP...     *Re
│ │ │ │ -00036120: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ -00036130: 7572 6e73 2041 534e 2e31 2073 7472 7563  urns ASN.1 struc
│ │ │ │ -00036140: 7475 7265 2e0a 0a73 6869 7368 695f 6173  ture...shishi_as
│ │ │ │ -00036150: 6e31 5f65 6e63 6170 7265 7070 6172 740a  n1_encapreppart.
│ │ │ │ -00036160: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00036170: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -00036180: 6e63 7469 6f6e 3a20 5368 6973 6869 5f61  nction: Shishi_a
│ │ │ │ -00036190: 736e 3120 7368 6973 6869 5f61 736e 315f  sn1 shishi_asn1_
│ │ │ │ -000361a0: 656e 6361 7072 6570 7061 7274 2028 5368  encapreppart (Sh
│ │ │ │ -000361b0: 6973 6869 202a 2048 414e 444c 4529 0a20  ishi * HANDLE). 
│ │ │ │ -000361c0: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ -000361d0: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ -000361e0: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ -000361f0: 7368 695f 696e 6974 2829 e280 992e 0a0a  shi_init()......
│ │ │ │ -00036200: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ -00036210: 6e3a 2a20 4372 6561 7465 206e 6577 2041  n:* Create new A
│ │ │ │ -00036220: 534e 2e31 2073 7472 7563 7475 7265 2066  SN.1 structure f
│ │ │ │ -00036230: 6f72 2041 502d 5245 502e 0a0a 2020 2020  or AP-REP...    
│ │ │ │ -00036240: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ -00036250: 2052 6574 7572 6e73 2041 534e 2e31 2073   Returns ASN.1 s
│ │ │ │ -00036260: 7472 7563 7475 7265 2e0a 0a73 6869 7368  tructure...shish
│ │ │ │ -00036270: 695f 6173 6e31 5f74 6963 6b65 740a 2d2d  i_asn1_ticket.--
│ │ │ │ +00034f10: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ +00034f20: 3a20 696e 7420 7368 6973 6869 5f61 736e  : int shishi_asn
│ │ │ │ +00034f30: 315f 7265 6164 5f6f 7074 696f 6e61 6c20  1_read_optional 
│ │ │ │ +00034f40: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ +00034f50: 2c0a 2020 2020 2020 2020 2020 5368 6973  ,.          Shis
│ │ │ │ +00034f60: 6869 5f61 736e 3120 4e4f 4445 2c20 636f  hi_asn1 NODE, co
│ │ │ │ +00034f70: 6e73 7420 6368 6172 202a 2046 4945 4c44  nst char * FIELD
│ │ │ │ +00034f80: 2c20 6368 6172 202a 2a20 4441 5441 2c0a  , char ** DATA,.
│ │ │ │ +00034f90: 2020 2020 2020 2020 2020 7369 7a65 5f74            size_t
│ │ │ │ +00034fa0: 202a 2044 4154 414c 454e 290a 2020 2020   * DATALEN).    
│ │ │ │ +00034fb0: 2048 414e 444c 453a 2073 6869 7368 6920   HANDLE: shishi 
│ │ │ │ +00034fc0: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ +00034fd0: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ +00034fe0: 5f69 6e69 7428 29e2 8099 2e0a 2020 2020  _init().....    
│ │ │ │ +00034ff0: 204e 4f44 453a 2041 534e 2e31 2076 6172   NODE: ASN.1 var
│ │ │ │ +00035000: 6961 626c 6520 746f 2072 6561 6420 6669  iable to read fi
│ │ │ │ +00035010: 656c 6420 6672 6f6d 2e0a 2020 2020 2046  eld from..     F
│ │ │ │ +00035020: 4945 4c44 3a20 6e61 6d65 206f 6620 6669  IELD: name of fi
│ │ │ │ +00035030: 656c 6420 696e 204e 4f44 4520 746f 2072  eld in NODE to r
│ │ │ │ +00035040: 6561 642e 0a20 2020 2020 4441 5441 3a20  ead..     DATA: 
│ │ │ │ +00035050: 6e65 776c 7920 616c 6c6f 6361 7465 6420  newly allocated 
│ │ │ │ +00035060: 6f75 7470 7574 2062 7566 6665 7220 7468  output buffer th
│ │ │ │ +00035070: 6174 2077 696c 6c20 686f 6c64 2041 534e  at will hold ASN
│ │ │ │ +00035080: 2e31 2066 6965 6c64 0a20 2020 2020 6461  .1 field.     da
│ │ │ │ +00035090: 7461 2e0a 2020 2020 2044 4154 414c 454e  ta..     DATALEN
│ │ │ │ +000350a0: 3a20 6163 7475 616c 2073 697a 6520 6f66  : actual size of
│ │ │ │ +000350b0: 206f 7574 7075 7420 6275 6666 6572 2e0a   output buffer..
│ │ │ │ +000350c0: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +000350d0: 6f6e 3a2a 2045 7874 7261 6374 2064 6174  on:* Extract dat
│ │ │ │ +000350e0: 6120 7374 6f72 6564 2069 6e20 6120 4153  a stored in a AS
│ │ │ │ +000350f0: 4e2e 3120 6669 656c 6420 696e 746f 2061  N.1 field into a
│ │ │ │ +00035100: 206e 6577 6c79 0a20 2020 2020 616c 6c6f   newly.     allo
│ │ │ │ +00035110: 6361 7465 6420 6275 6666 6572 2e20 2049  cated buffer.  I
│ │ │ │ +00035120: 6620 7468 6520 6669 656c 6420 646f 6573  f the field does
│ │ │ │ +00035130: 206e 6f74 2065 7869 7374 2028 692e 652e   not exist (i.e.
│ │ │ │ +00035140: 2c0a 2020 2020 2053 4849 5348 495f 4153  ,.     SHISHI_AS
│ │ │ │ +00035150: 4e31 5f4e 4f5f 454c 454d 454e 5429 2c20  N1_NO_ELEMENT), 
│ │ │ │ +00035160: 7468 6973 2066 756e 6374 696f 6e20 7365  this function se
│ │ │ │ +00035170: 7420 6461 7461 6c65 6e20 746f 2030 2061  t datalen to 0 a
│ │ │ │ +00035180: 6e64 0a20 2020 2020 7375 6363 6565 6473  nd.     succeeds
│ │ │ │ +00035190: 2e20 2043 616e 2062 6520 7573 6566 756c  .  Can be useful
│ │ │ │ +000351a0: 2074 6f20 7265 6164 2041 534e 2e31 2066   to read ASN.1 f
│ │ │ │ +000351b0: 6965 6c64 7320 7768 6963 6820 6172 6520  ields which are 
│ │ │ │ +000351c0: 6d61 726b 6564 0a20 2020 2020 4f50 5449  marked.     OPTI
│ │ │ │ +000351d0: 4f4e 414c 2069 6e20 7468 6520 6772 616d  ONAL in the gram
│ │ │ │ +000351e0: 6d61 722c 2069 6620 796f 7520 7761 6e74  mar, if you want
│ │ │ │ +000351f0: 2074 6f20 6176 6f69 6420 7370 6563 6961   to avoid specia
│ │ │ │ +00035200: 6c20 6572 726f 720a 2020 2020 2068 616e  l error.     han
│ │ │ │ +00035210: 646c 696e 6720 696e 2079 6f75 7220 636f  dling in your co
│ │ │ │ +00035220: 6465 2e0a 0a20 2020 2020 2a52 6574 7572  de...     *Retur
│ │ │ │ +00035230: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ +00035240: 7320 5348 4953 4849 5f4f 4b20 6966 2073  s SHISHI_OK if s
│ │ │ │ +00035250: 7563 6365 7373 6675 6c2c 0a20 2020 2020  uccessful,.     
│ │ │ │ +00035260: 5348 4953 4849 5f41 534e 315f 4e4f 5f56  SHISHI_ASN1_NO_V
│ │ │ │ +00035270: 414c 5545 2069 6620 7468 6520 6669 656c  ALUE if the fiel
│ │ │ │ +00035280: 6420 6861 7320 6e6f 2076 616c 7565 2c20  d has no value, 
│ │ │ │ +00035290: 6f74 0a20 2020 2020 5348 4953 4849 5f41  ot.     SHISHI_A
│ │ │ │ +000352a0: 534e 315f 4552 524f 5220 6f74 6865 7277  SN1_ERROR otherw
│ │ │ │ +000352b0: 6973 652e 0a0a 7368 6973 6869 5f61 736e  ise...shishi_asn
│ │ │ │ +000352c0: 315f 646f 6e65 0a2d 2d2d 2d2d 2d2d 2d2d  1_done.---------
│ │ │ │ +000352d0: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +000352e0: 6374 696f 6e3a 2076 6f69 6420 7368 6973  ction: void shis
│ │ │ │ +000352f0: 6869 5f61 736e 315f 646f 6e65 2028 5368  hi_asn1_done (Sh
│ │ │ │ +00035300: 6973 6869 202a 2048 414e 444c 452c 2053  ishi * HANDLE, S
│ │ │ │ +00035310: 6869 7368 695f 6173 6e31 204e 4f44 4529  hishi_asn1 NODE)
│ │ │ │ +00035320: 0a20 2020 2020 4841 4e44 4c45 3a20 7368  .     HANDLE: sh
│ │ │ │ +00035330: 6973 6869 2068 616e 646c 6520 6173 2061  ishi handle as a
│ │ │ │ +00035340: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ +00035350: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ +00035360: 0a20 2020 2020 4e4f 4445 3a20 4153 4e2e  .     NODE: ASN.
│ │ │ │ +00035370: 3120 6e6f 6465 2074 6f20 6465 616c 6c6f  1 node to deallo
│ │ │ │ +00035380: 6361 7465 2e0a 0a20 2020 2020 2a44 6573  cate...     *Des
│ │ │ │ +00035390: 6372 6970 7469 6f6e 3a2a 2044 6561 6c6c  cription:* Deall
│ │ │ │ +000353a0: 6f63 6174 6520 7265 736f 7572 6365 7320  ocate resources 
│ │ │ │ +000353b0: 6173 736f 6369 6174 6564 2077 6974 6820  associated with 
│ │ │ │ +000353c0: 4153 4e2e 310a 2020 2020 2073 7472 7563  ASN.1.     struc
│ │ │ │ +000353d0: 7475 7265 2e20 204e 6f74 6520 7468 6174  ture.  Note that
│ │ │ │ +000353e0: 2074 6865 206e 6f64 6520 6d75 7374 206e   the node must n
│ │ │ │ +000353f0: 6f74 2062 6520 7573 6564 2061 6674 6572  ot be used after
│ │ │ │ +00035400: 2074 6869 7320 6361 6c6c 2e0a 0a73 6869   this call...shi
│ │ │ │ +00035410: 7368 695f 6173 6e31 5f70 615f 656e 635f  shi_asn1_pa_enc_
│ │ │ │ +00035420: 7473 5f65 6e63 0a2d 2d2d 2d2d 2d2d 2d2d  ts_enc.---------
│ │ │ │ +00035430: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +00035440: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +00035450: 5368 6973 6869 5f61 736e 3120 7368 6973  Shishi_asn1 shis
│ │ │ │ +00035460: 6869 5f61 736e 315f 7061 5f65 6e63 5f74  hi_asn1_pa_enc_t
│ │ │ │ +00035470: 735f 656e 6320 2853 6869 7368 6920 2a20  s_enc (Shishi * 
│ │ │ │ +00035480: 4841 4e44 4c45 290a 2020 2020 2048 414e  HANDLE).     HAN
│ │ │ │ +00035490: 444c 453a 2073 6869 7368 6920 6861 6e64  DLE: shishi hand
│ │ │ │ +000354a0: 6c65 2061 7320 616c 6c6f 6361 7465 6420  le as allocated 
│ │ │ │ +000354b0: 6279 20e2 8098 7368 6973 6869 5f69 6e69  by ...shishi_ini
│ │ │ │ +000354c0: 7428 29e2 8099 2e0a 0a20 2020 2020 2a44  t()......     *D
│ │ │ │ +000354d0: 6573 6372 6970 7469 6f6e 3a2a 2043 7265  escription:* Cre
│ │ │ │ +000354e0: 6174 6520 6e65 7720 4153 4e2e 3120 7374  ate new ASN.1 st
│ │ │ │ +000354f0: 7275 6374 7572 6520 666f 7220 5041 2d45  ructure for PA-E
│ │ │ │ +00035500: 4e43 2d54 532d 454e 432e 0a0a 2020 2020  NC-TS-ENC...    
│ │ │ │ +00035510: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ +00035520: 2052 6574 7572 6e73 2041 534e 2e31 2073   Returns ASN.1 s
│ │ │ │ +00035530: 7472 7563 7475 7265 2e0a 0a73 6869 7368  tructure...shish
│ │ │ │ +00035540: 695f 6173 6e31 5f65 6e63 7279 7074 6564  i_asn1_encrypted
│ │ │ │ +00035550: 6461 7461 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  data.-----------
│ │ │ │ +00035560: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ +00035570: 202d 2d20 4675 6e63 7469 6f6e 3a20 5368   -- Function: Sh
│ │ │ │ +00035580: 6973 6869 5f61 736e 3120 7368 6973 6869  ishi_asn1 shishi
│ │ │ │ +00035590: 5f61 736e 315f 656e 6372 7970 7465 6464  _asn1_encryptedd
│ │ │ │ +000355a0: 6174 6120 2853 6869 7368 6920 2a20 4841  ata (Shishi * HA
│ │ │ │ +000355b0: 4e44 4c45 290a 2020 2020 2048 414e 444c  NDLE).     HANDL
│ │ │ │ +000355c0: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ +000355d0: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ +000355e0: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ +000355f0: 29e2 8099 2e0a 0a20 2020 2020 2a44 6573  )......     *Des
│ │ │ │ +00035600: 6372 6970 7469 6f6e 3a2a 2043 7265 6174  cription:* Creat
│ │ │ │ +00035610: 6520 6e65 7720 4153 4e2e 3120 7374 7275  e new ASN.1 stru
│ │ │ │ +00035620: 6374 7572 6520 666f 7220 456e 6372 7970  cture for Encryp
│ │ │ │ +00035630: 7465 6444 6174 610a 0a20 2020 2020 2a52  tedData..     *R
│ │ │ │ +00035640: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +00035650: 7475 726e 7320 4153 4e2e 3120 7374 7275  turns ASN.1 stru
│ │ │ │ +00035660: 6374 7572 652e 0a0a 7368 6973 6869 5f61  cture...shishi_a
│ │ │ │ +00035670: 736e 315f 7061 6461 7461 0a2d 2d2d 2d2d  sn1_padata.-----
│ │ │ │ +00035680: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ +00035690: 2d2d 2046 756e 6374 696f 6e3a 2053 6869  -- Function: Shi
│ │ │ │ +000356a0: 7368 695f 6173 6e31 2073 6869 7368 695f  shi_asn1 shishi_
│ │ │ │ +000356b0: 6173 6e31 5f70 6164 6174 6120 2853 6869  asn1_padata (Shi
│ │ │ │ +000356c0: 7368 6920 2a20 4841 4e44 4c45 290a 2020  shi * HANDLE).  
│ │ │ │ +000356d0: 2020 2048 414e 444c 453a 2073 6869 7368     HANDLE: shish
│ │ │ │ +000356e0: 6920 6861 6e64 6c65 2061 7320 616c 6c6f  i handle as allo
│ │ │ │ +000356f0: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ +00035700: 6869 5f69 6e69 7428 29e2 8099 2e0a 0a20  hi_init()...... 
│ │ │ │ +00035710: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ +00035720: 3a2a 2043 7265 6174 6520 6e65 7720 4153  :* Create new AS
│ │ │ │ +00035730: 4e2e 3120 7374 7275 6374 7572 6520 666f  N.1 structure fo
│ │ │ │ +00035740: 7220 5041 2d44 4154 412e 0a0a 2020 2020  r PA-DATA...    
│ │ │ │ +00035750: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ +00035760: 2052 6574 7572 6e73 2041 534e 2e31 2073   Returns ASN.1 s
│ │ │ │ +00035770: 7472 7563 7475 7265 2e0a 0a73 6869 7368  tructure...shish
│ │ │ │ +00035780: 695f 6173 6e31 5f6d 6574 686f 6464 6174  i_asn1_methoddat
│ │ │ │ +00035790: 610a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  a.--------------
│ │ │ │ +000357a0: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ +000357b0: 6e63 7469 6f6e 3a20 5368 6973 6869 5f61  nction: Shishi_a
│ │ │ │ +000357c0: 736e 3120 7368 6973 6869 5f61 736e 315f  sn1 shishi_asn1_
│ │ │ │ +000357d0: 6d65 7468 6f64 6461 7461 2028 5368 6973  methoddata (Shis
│ │ │ │ +000357e0: 6869 202a 2048 414e 444c 4529 0a20 2020  hi * HANDLE).   
│ │ │ │ +000357f0: 2020 4841 4e44 4c45 3a20 7368 6973 6869    HANDLE: shishi
│ │ │ │ +00035800: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ +00035810: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ +00035820: 695f 696e 6974 2829 e280 992e 0a0a 2020  i_init()......  
│ │ │ │ +00035830: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ +00035840: 2a20 4372 6561 7465 206e 6577 2041 534e  * Create new ASN
│ │ │ │ +00035850: 2e31 2073 7472 7563 7475 7265 2066 6f72  .1 structure for
│ │ │ │ +00035860: 204d 4554 484f 442d 4441 5441 2e0a 0a20   METHOD-DATA... 
│ │ │ │ +00035870: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ +00035880: 653a 2a20 5265 7475 726e 7320 4153 4e2e  e:* Returns ASN.
│ │ │ │ +00035890: 3120 7374 7275 6374 7572 652e 0a0a 7368  1 structure...sh
│ │ │ │ +000358a0: 6973 6869 5f61 736e 315f 6574 7970 655f  ishi_asn1_etype_
│ │ │ │ +000358b0: 696e 666f 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  info.-----------
│ │ │ │ +000358c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ +000358d0: 2046 756e 6374 696f 6e3a 2053 6869 7368   Function: Shish
│ │ │ │ +000358e0: 695f 6173 6e31 2073 6869 7368 695f 6173  i_asn1 shishi_as
│ │ │ │ +000358f0: 6e31 5f65 7479 7065 5f69 6e66 6f20 2853  n1_etype_info (S
│ │ │ │ +00035900: 6869 7368 6920 2a20 4841 4e44 4c45 290a  hishi * HANDLE).
│ │ │ │ +00035910: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ +00035920: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ +00035930: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ +00035940: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ +00035950: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +00035960: 6f6e 3a2a 2043 7265 6174 6520 6e65 7720  on:* Create new 
│ │ │ │ +00035970: 4153 4e2e 3120 7374 7275 6374 7572 6520  ASN.1 structure 
│ │ │ │ +00035980: 666f 7220 4554 5950 452d 494e 464f 2e0a  for ETYPE-INFO..
│ │ │ │ +00035990: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ +000359a0: 6c75 653a 2a20 5265 7475 726e 7320 4153  lue:* Returns AS
│ │ │ │ +000359b0: 4e2e 3120 7374 7275 6374 7572 652e 0a0a  N.1 structure...
│ │ │ │ +000359c0: 7368 6973 6869 5f61 736e 315f 6574 7970  shishi_asn1_etyp
│ │ │ │ +000359d0: 655f 696e 666f 320a 2d2d 2d2d 2d2d 2d2d  e_info2.--------
│ │ │ │ +000359e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +000359f0: 0a20 2d2d 2046 756e 6374 696f 6e3a 2053  . -- Function: S
│ │ │ │ +00035a00: 6869 7368 695f 6173 6e31 2073 6869 7368  hishi_asn1 shish
│ │ │ │ +00035a10: 695f 6173 6e31 5f65 7479 7065 5f69 6e66  i_asn1_etype_inf
│ │ │ │ +00035a20: 6f32 2028 5368 6973 6869 202a 2048 414e  o2 (Shishi * HAN
│ │ │ │ +00035a30: 444c 4529 0a20 2020 2020 4841 4e44 4c45  DLE).     HANDLE
│ │ │ │ +00035a40: 3a20 7368 6973 6869 2068 616e 646c 6520  : shishi handle 
│ │ │ │ +00035a50: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ +00035a60: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ +00035a70: e280 992e 0a0a 2020 2020 202a 4465 7363  ......     *Desc
│ │ │ │ +00035a80: 7269 7074 696f 6e3a 2a20 4372 6561 7465  ription:* Create
│ │ │ │ +00035a90: 206e 6577 2041 534e 2e31 2073 7472 7563   new ASN.1 struc
│ │ │ │ +00035aa0: 7475 7265 2066 6f72 2045 5459 5045 2d49  ture for ETYPE-I
│ │ │ │ +00035ab0: 4e46 4f32 2e0a 0a20 2020 2020 2a52 6574  NFO2...     *Ret
│ │ │ │ +00035ac0: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ +00035ad0: 726e 7320 4153 4e2e 3120 7374 7275 6374  rns ASN.1 struct
│ │ │ │ +00035ae0: 7572 652e 0a0a 7368 6973 6869 5f61 736e  ure...shishi_asn
│ │ │ │ +00035af0: 315f 6173 7265 710a 2d2d 2d2d 2d2d 2d2d  1_asreq.--------
│ │ │ │ +00035b00: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +00035b10: 756e 6374 696f 6e3a 2053 6869 7368 695f  unction: Shishi_
│ │ │ │ +00035b20: 6173 6e31 2073 6869 7368 695f 6173 6e31  asn1 shishi_asn1
│ │ │ │ +00035b30: 5f61 7372 6571 2028 5368 6973 6869 202a  _asreq (Shishi *
│ │ │ │ +00035b40: 2048 414e 444c 4529 0a20 2020 2020 4841   HANDLE).     HA
│ │ │ │ +00035b50: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ +00035b60: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ +00035b70: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ +00035b80: 6974 2829 e280 992e 0a0a 2020 2020 202a  it()......     *
│ │ │ │ +00035b90: 4465 7363 7269 7074 696f 6e3a 2a20 4372  Description:* Cr
│ │ │ │ +00035ba0: 6561 7465 206e 6577 2041 534e 2e31 2073  eate new ASN.1 s
│ │ │ │ +00035bb0: 7472 7563 7475 7265 2066 6f72 2041 532d  tructure for AS-
│ │ │ │ +00035bc0: 5245 512e 0a0a 2020 2020 202a 5265 7475  REQ...     *Retu
│ │ │ │ +00035bd0: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ +00035be0: 6e73 2041 534e 2e31 2073 7472 7563 7475  ns ASN.1 structu
│ │ │ │ +00035bf0: 7265 2e0a 0a73 6869 7368 695f 6173 6e31  re...shishi_asn1
│ │ │ │ +00035c00: 5f61 7372 6570 0a2d 2d2d 2d2d 2d2d 2d2d  _asrep.---------
│ │ │ │ +00035c10: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ +00035c20: 6e63 7469 6f6e 3a20 5368 6973 6869 5f61  nction: Shishi_a
│ │ │ │ +00035c30: 736e 3120 7368 6973 6869 5f61 736e 315f  sn1 shishi_asn1_
│ │ │ │ +00035c40: 6173 7265 7020 2853 6869 7368 6920 2a20  asrep (Shishi * 
│ │ │ │ +00035c50: 4841 4e44 4c45 290a 2020 2020 2048 414e  HANDLE).     HAN
│ │ │ │ +00035c60: 444c 453a 2073 6869 7368 6920 6861 6e64  DLE: shishi hand
│ │ │ │ +00035c70: 6c65 2061 7320 616c 6c6f 6361 7465 6420  le as allocated 
│ │ │ │ +00035c80: 6279 20e2 8098 7368 6973 6869 5f69 6e69  by ...shishi_ini
│ │ │ │ +00035c90: 7428 29e2 8099 2e0a 0a20 2020 2020 2a44  t()......     *D
│ │ │ │ +00035ca0: 6573 6372 6970 7469 6f6e 3a2a 2043 7265  escription:* Cre
│ │ │ │ +00035cb0: 6174 6520 6e65 7720 4153 4e2e 3120 7374  ate new ASN.1 st
│ │ │ │ +00035cc0: 7275 6374 7572 6520 666f 7220 4153 2d52  ructure for AS-R
│ │ │ │ +00035cd0: 4550 2e0a 0a20 2020 2020 2a52 6574 7572  EP...     *Retur
│ │ │ │ +00035ce0: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ +00035cf0: 7320 4153 4e2e 3120 7374 7275 6374 7572  s ASN.1 structur
│ │ │ │ +00035d00: 652e 0a0a 7368 6973 6869 5f61 736e 315f  e...shishi_asn1_
│ │ │ │ +00035d10: 7467 7372 6571 0a2d 2d2d 2d2d 2d2d 2d2d  tgsreq.---------
│ │ │ │ +00035d20: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +00035d30: 756e 6374 696f 6e3a 2053 6869 7368 695f  unction: Shishi_
│ │ │ │ +00035d40: 6173 6e31 2073 6869 7368 695f 6173 6e31  asn1 shishi_asn1
│ │ │ │ +00035d50: 5f74 6773 7265 7120 2853 6869 7368 6920  _tgsreq (Shishi 
│ │ │ │ +00035d60: 2a20 4841 4e44 4c45 290a 2020 2020 2048  * HANDLE).     H
│ │ │ │ +00035d70: 414e 444c 453a 2073 6869 7368 6920 6861  ANDLE: shishi ha
│ │ │ │ +00035d80: 6e64 6c65 2061 7320 616c 6c6f 6361 7465  ndle as allocate
│ │ │ │ +00035d90: 6420 6279 20e2 8098 7368 6973 6869 5f69  d by ...shishi_i
│ │ │ │ +00035da0: 6e69 7428 29e2 8099 2e0a 0a20 2020 2020  nit()......     
│ │ │ │ +00035db0: 2a44 6573 6372 6970 7469 6f6e 3a2a 2043  *Description:* C
│ │ │ │ +00035dc0: 7265 6174 6520 6e65 7720 4153 4e2e 3120  reate new ASN.1 
│ │ │ │ +00035dd0: 7374 7275 6374 7572 6520 666f 7220 5447  structure for TG
│ │ │ │ +00035de0: 532d 5245 512e 0a0a 2020 2020 202a 5265  S-REQ...     *Re
│ │ │ │ +00035df0: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ +00035e00: 7572 6e73 2041 534e 2e31 2073 7472 7563  urns ASN.1 struc
│ │ │ │ +00035e10: 7475 7265 2e0a 0a73 6869 7368 695f 6173  ture...shishi_as
│ │ │ │ +00035e20: 6e31 5f74 6773 7265 700a 2d2d 2d2d 2d2d  n1_tgsrep.------
│ │ │ │ +00035e30: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ +00035e40: 2d20 4675 6e63 7469 6f6e 3a20 5368 6973  - Function: Shis
│ │ │ │ +00035e50: 6869 5f61 736e 3120 7368 6973 6869 5f61  hi_asn1 shishi_a
│ │ │ │ +00035e60: 736e 315f 7467 7372 6570 2028 5368 6973  sn1_tgsrep (Shis
│ │ │ │ +00035e70: 6869 202a 2048 414e 444c 4529 0a20 2020  hi * HANDLE).   
│ │ │ │ +00035e80: 2020 4841 4e44 4c45 3a20 7368 6973 6869    HANDLE: shishi
│ │ │ │ +00035e90: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ +00035ea0: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ +00035eb0: 695f 696e 6974 2829 e280 992e 0a0a 2020  i_init()......  
│ │ │ │ +00035ec0: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ +00035ed0: 2a20 4372 6561 7465 206e 6577 2041 534e  * Create new ASN
│ │ │ │ +00035ee0: 2e31 2073 7472 7563 7475 7265 2066 6f72  .1 structure for
│ │ │ │ +00035ef0: 2054 4753 2d52 4550 2e0a 0a20 2020 2020   TGS-REP...     
│ │ │ │ +00035f00: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ +00035f10: 5265 7475 726e 7320 4153 4e2e 3120 7374  Returns ASN.1 st
│ │ │ │ +00035f20: 7275 6374 7572 652e 0a0a 7368 6973 6869  ructure...shishi
│ │ │ │ +00035f30: 5f61 736e 315f 6170 7265 710a 2d2d 2d2d  _asn1_apreq.----
│ │ │ │ +00035f40: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ +00035f50: 2d2d 2046 756e 6374 696f 6e3a 2053 6869  -- Function: Shi
│ │ │ │ +00035f60: 7368 695f 6173 6e31 2073 6869 7368 695f  shi_asn1 shishi_
│ │ │ │ +00035f70: 6173 6e31 5f61 7072 6571 2028 5368 6973  asn1_apreq (Shis
│ │ │ │ +00035f80: 6869 202a 2048 414e 444c 4529 0a20 2020  hi * HANDLE).   
│ │ │ │ +00035f90: 2020 4841 4e44 4c45 3a20 7368 6973 6869    HANDLE: shishi
│ │ │ │ +00035fa0: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ +00035fb0: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ +00035fc0: 695f 696e 6974 2829 e280 992e 0a0a 2020  i_init()......  
│ │ │ │ +00035fd0: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ +00035fe0: 2a20 4372 6561 7465 206e 6577 2041 534e  * Create new ASN
│ │ │ │ +00035ff0: 2e31 2073 7472 7563 7475 7265 2066 6f72  .1 structure for
│ │ │ │ +00036000: 2041 502d 5245 512e 0a0a 2020 2020 202a   AP-REQ...     *
│ │ │ │ +00036010: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ +00036020: 6574 7572 6e73 2041 534e 2e31 2073 7472  eturns ASN.1 str
│ │ │ │ +00036030: 7563 7475 7265 2e0a 0a73 6869 7368 695f  ucture...shishi_
│ │ │ │ +00036040: 6173 6e31 5f61 7072 6570 0a2d 2d2d 2d2d  asn1_aprep.-----
│ │ │ │ +00036050: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ +00036060: 2d20 4675 6e63 7469 6f6e 3a20 5368 6973  - Function: Shis
│ │ │ │ +00036070: 6869 5f61 736e 3120 7368 6973 6869 5f61  hi_asn1 shishi_a
│ │ │ │ +00036080: 736e 315f 6170 7265 7020 2853 6869 7368  sn1_aprep (Shish
│ │ │ │ +00036090: 6920 2a20 4841 4e44 4c45 290a 2020 2020  i * HANDLE).    
│ │ │ │ +000360a0: 2048 414e 444c 453a 2073 6869 7368 6920   HANDLE: shishi 
│ │ │ │ +000360b0: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ +000360c0: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ +000360d0: 5f69 6e69 7428 29e2 8099 2e0a 0a20 2020  _init()......   
│ │ │ │ +000360e0: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ +000360f0: 2043 7265 6174 6520 6e65 7720 4153 4e2e   Create new ASN.
│ │ │ │ +00036100: 3120 7374 7275 6374 7572 6520 666f 7220  1 structure for 
│ │ │ │ +00036110: 4150 2d52 4550 2e0a 0a20 2020 2020 2a52  AP-REP...     *R
│ │ │ │ +00036120: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +00036130: 7475 726e 7320 4153 4e2e 3120 7374 7275  turns ASN.1 stru
│ │ │ │ +00036140: 6374 7572 652e 0a0a 7368 6973 6869 5f61  cture...shishi_a
│ │ │ │ +00036150: 736e 315f 656e 6361 7072 6570 7061 7274  sn1_encapreppart
│ │ │ │ +00036160: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ +00036170: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +00036180: 756e 6374 696f 6e3a 2053 6869 7368 695f  unction: Shishi_
│ │ │ │ +00036190: 6173 6e31 2073 6869 7368 695f 6173 6e31  asn1 shishi_asn1
│ │ │ │ +000361a0: 5f65 6e63 6170 7265 7070 6172 7420 2853  _encapreppart (S
│ │ │ │ +000361b0: 6869 7368 6920 2a20 4841 4e44 4c45 290a  hishi * HANDLE).
│ │ │ │ +000361c0: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ +000361d0: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ +000361e0: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ +000361f0: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ +00036200: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +00036210: 6f6e 3a2a 2043 7265 6174 6520 6e65 7720  on:* Create new 
│ │ │ │ +00036220: 4153 4e2e 3120 7374 7275 6374 7572 6520  ASN.1 structure 
│ │ │ │ +00036230: 666f 7220 4150 2d52 4550 2e0a 0a20 2020  for AP-REP...   
│ │ │ │ +00036240: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ +00036250: 2a20 5265 7475 726e 7320 4153 4e2e 3120  * Returns ASN.1 
│ │ │ │ +00036260: 7374 7275 6374 7572 652e 0a0a 7368 6973  structure...shis
│ │ │ │ +00036270: 6869 5f61 736e 315f 7469 636b 6574 0a2d  hi_asn1_ticket.-
│ │ │ │  00036280: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00036290: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ -000362a0: 5368 6973 6869 5f61 736e 3120 7368 6973  Shishi_asn1 shis
│ │ │ │ -000362b0: 6869 5f61 736e 315f 7469 636b 6574 2028  hi_asn1_ticket (
│ │ │ │ -000362c0: 5368 6973 6869 202a 2048 414e 444c 4529  Shishi * HANDLE)
│ │ │ │ -000362d0: 0a20 2020 2020 4841 4e44 4c45 3a20 7368  .     HANDLE: sh
│ │ │ │ -000362e0: 6973 6869 2068 616e 646c 6520 6173 2061  ishi handle as a
│ │ │ │ -000362f0: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ -00036300: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ -00036310: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ -00036320: 696f 6e3a 2a20 4372 6561 7465 206e 6577  ion:* Create new
│ │ │ │ -00036330: 2041 534e 2e31 2073 7472 7563 7475 7265   ASN.1 structure
│ │ │ │ -00036340: 2066 6f72 2054 6963 6b65 742e 0a0a 2020   for Ticket...  
│ │ │ │ -00036350: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ -00036360: 3a2a 2052 6574 7572 6e73 2041 534e 2e31  :* Returns ASN.1
│ │ │ │ -00036370: 2073 7472 7563 7475 7265 2e0a 0a73 6869   structure...shi
│ │ │ │ -00036380: 7368 695f 6173 6e31 5f65 6e63 7469 636b  shi_asn1_enctick
│ │ │ │ -00036390: 6574 7061 7274 0a2d 2d2d 2d2d 2d2d 2d2d  etpart.---------
│ │ │ │ +00036290: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ +000362a0: 2053 6869 7368 695f 6173 6e31 2073 6869   Shishi_asn1 shi
│ │ │ │ +000362b0: 7368 695f 6173 6e31 5f74 6963 6b65 7420  shi_asn1_ticket 
│ │ │ │ +000362c0: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ +000362d0: 290a 2020 2020 2048 414e 444c 453a 2073  ).     HANDLE: s
│ │ │ │ +000362e0: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ +000362f0: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ +00036300: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ +00036310: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ +00036320: 7469 6f6e 3a2a 2043 7265 6174 6520 6e65  tion:* Create ne
│ │ │ │ +00036330: 7720 4153 4e2e 3120 7374 7275 6374 7572  w ASN.1 structur
│ │ │ │ +00036340: 6520 666f 7220 5469 636b 6574 2e0a 0a20  e for Ticket... 
│ │ │ │ +00036350: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ +00036360: 653a 2a20 5265 7475 726e 7320 4153 4e2e  e:* Returns ASN.
│ │ │ │ +00036370: 3120 7374 7275 6374 7572 652e 0a0a 7368  1 structure...sh
│ │ │ │ +00036380: 6973 6869 5f61 736e 315f 656e 6374 6963  ishi_asn1_enctic
│ │ │ │ +00036390: 6b65 7470 6172 740a 2d2d 2d2d 2d2d 2d2d  ketpart.--------
│ │ │ │  000363a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000363b0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ -000363c0: 5368 6973 6869 5f61 736e 3120 7368 6973  Shishi_asn1 shis
│ │ │ │ -000363d0: 6869 5f61 736e 315f 656e 6374 6963 6b65  hi_asn1_encticke
│ │ │ │ -000363e0: 7470 6172 7420 2853 6869 7368 6920 2a20  tpart (Shishi * 
│ │ │ │ -000363f0: 4841 4e44 4c45 290a 2020 2020 2048 414e  HANDLE).     HAN
│ │ │ │ -00036400: 444c 453a 2073 6869 7368 6920 6861 6e64  DLE: shishi hand
│ │ │ │ -00036410: 6c65 2061 7320 616c 6c6f 6361 7465 6420  le as allocated 
│ │ │ │ -00036420: 6279 20e2 8098 7368 6973 6869 5f69 6e69  by ...shishi_ini
│ │ │ │ -00036430: 7428 29e2 8099 2e0a 0a20 2020 2020 2a44  t()......     *D
│ │ │ │ -00036440: 6573 6372 6970 7469 6f6e 3a2a 2043 7265  escription:* Cre
│ │ │ │ -00036450: 6174 6520 6e65 7720 4153 4e2e 3120 7374  ate new ASN.1 st
│ │ │ │ -00036460: 7275 6374 7572 6520 666f 7220 456e 6354  ructure for EncT
│ │ │ │ -00036470: 6963 6b65 7450 6172 742e 0a0a 2020 2020  icketPart...    
│ │ │ │ -00036480: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ -00036490: 2052 6574 7572 6e73 2041 534e 2e31 2073   Returns ASN.1 s
│ │ │ │ -000364a0: 7472 7563 7475 7265 2e0a 0a73 6869 7368  tructure...shish
│ │ │ │ -000364b0: 695f 6173 6e31 5f61 7574 6865 6e74 6963  i_asn1_authentic
│ │ │ │ -000364c0: 6174 6f72 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  ator.-----------
│ │ │ │ -000364d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -000364e0: 202d 2d20 4675 6e63 7469 6f6e 3a20 5368   -- Function: Sh
│ │ │ │ -000364f0: 6973 6869 5f61 736e 3120 7368 6973 6869  ishi_asn1 shishi
│ │ │ │ -00036500: 5f61 736e 315f 6175 7468 656e 7469 6361  _asn1_authentica
│ │ │ │ -00036510: 746f 7220 2853 6869 7368 6920 2a20 4841  tor (Shishi * HA
│ │ │ │ -00036520: 4e44 4c45 290a 2020 2020 2048 414e 444c  NDLE).     HANDL
│ │ │ │ -00036530: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ -00036540: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ -00036550: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ -00036560: 29e2 8099 2e0a 0a20 2020 2020 2a44 6573  )......     *Des
│ │ │ │ -00036570: 6372 6970 7469 6f6e 3a2a 2043 7265 6174  cription:* Creat
│ │ │ │ -00036580: 6520 6e65 7720 4153 4e2e 3120 7374 7275  e new ASN.1 stru
│ │ │ │ -00036590: 6374 7572 6520 666f 7220 4175 7468 656e  cture for Authen
│ │ │ │ -000365a0: 7469 6361 746f 722e 0a0a 2020 2020 202a  ticator...     *
│ │ │ │ -000365b0: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ -000365c0: 6574 7572 6e73 2041 534e 2e31 2073 7472  eturns ASN.1 str
│ │ │ │ -000365d0: 7563 7475 7265 2e0a 0a73 6869 7368 695f  ucture...shishi_
│ │ │ │ -000365e0: 6173 6e31 5f65 6e63 6b64 6372 6570 7061  asn1_enckdcreppa
│ │ │ │ -000365f0: 7274 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  rt.-------------
│ │ │ │ -00036600: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ -00036610: 2d20 4675 6e63 7469 6f6e 3a20 5368 6973  - Function: Shis
│ │ │ │ -00036620: 6869 5f61 736e 3120 7368 6973 6869 5f61  hi_asn1 shishi_a
│ │ │ │ -00036630: 736e 315f 656e 636b 6463 7265 7070 6172  sn1_enckdcreppar
│ │ │ │ -00036640: 7420 2853 6869 7368 6920 2a20 4841 4e44  t (Shishi * HAND
│ │ │ │ -00036650: 4c45 290a 2020 2020 2048 414e 444c 453a  LE).     HANDLE:
│ │ │ │ -00036660: 2073 6869 7368 6920 6861 6e64 6c65 2061   shishi handle a
│ │ │ │ -00036670: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ -00036680: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ -00036690: 8099 2e0a 0a20 2020 2020 2a44 6573 6372  .....     *Descr
│ │ │ │ -000366a0: 6970 7469 6f6e 3a2a 2043 7265 6174 6520  iption:* Create 
│ │ │ │ -000366b0: 6e65 7720 4153 4e2e 3120 7374 7275 6374  new ASN.1 struct
│ │ │ │ -000366c0: 7572 6520 666f 7220 456e 634b 4443 5265  ure for EncKDCRe
│ │ │ │ -000366d0: 7050 6172 742e 0a0a 2020 2020 202a 5265  pPart...     *Re
│ │ │ │ -000366e0: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ -000366f0: 7572 6e73 2041 534e 2e31 2073 7472 7563  urns ASN.1 struc
│ │ │ │ -00036700: 7475 7265 2e0a 0a73 6869 7368 695f 6173  ture...shishi_as
│ │ │ │ -00036710: 6e31 5f65 6e63 6173 7265 7070 6172 740a  n1_encasreppart.
│ │ │ │ -00036720: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00036730: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -00036740: 6e63 7469 6f6e 3a20 5368 6973 6869 5f61  nction: Shishi_a
│ │ │ │ -00036750: 736e 3120 7368 6973 6869 5f61 736e 315f  sn1 shishi_asn1_
│ │ │ │ -00036760: 656e 6361 7372 6570 7061 7274 2028 5368  encasreppart (Sh
│ │ │ │ -00036770: 6973 6869 202a 2048 414e 444c 4529 0a20  ishi * HANDLE). 
│ │ │ │ -00036780: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ -00036790: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ -000367a0: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ -000367b0: 7368 695f 696e 6974 2829 e280 992e 0a0a  shi_init()......
│ │ │ │ -000367c0: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ -000367d0: 6e3a 2a20 4372 6561 7465 206e 6577 2041  n:* Create new A
│ │ │ │ -000367e0: 534e 2e31 2073 7472 7563 7475 7265 2066  SN.1 structure f
│ │ │ │ -000367f0: 6f72 2045 6e63 4153 5265 7050 6172 742e  or EncASRepPart.
│ │ │ │ -00036800: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ -00036810: 616c 7565 3a2a 2052 6574 7572 6e73 2041  alue:* Returns A
│ │ │ │ -00036820: 534e 2e31 2073 7472 7563 7475 7265 2e0a  SN.1 structure..
│ │ │ │ -00036830: 0a73 6869 7368 695f 6173 6e31 5f6b 7262  .shishi_asn1_krb
│ │ │ │ -00036840: 6572 726f 720a 2d2d 2d2d 2d2d 2d2d 2d2d  error.----------
│ │ │ │ -00036850: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ -00036860: 4675 6e63 7469 6f6e 3a20 5368 6973 6869  Function: Shishi
│ │ │ │ -00036870: 5f61 736e 3120 7368 6973 6869 5f61 736e  _asn1 shishi_asn
│ │ │ │ -00036880: 315f 6b72 6265 7272 6f72 2028 5368 6973  1_krberror (Shis
│ │ │ │ -00036890: 6869 202a 2048 414e 444c 4529 0a20 2020  hi * HANDLE).   
│ │ │ │ -000368a0: 2020 4841 4e44 4c45 3a20 7368 6973 6869    HANDLE: shishi
│ │ │ │ -000368b0: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ -000368c0: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ -000368d0: 695f 696e 6974 2829 e280 992e 0a0a 2020  i_init()......  
│ │ │ │ -000368e0: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ -000368f0: 2a20 4372 6561 7465 206e 6577 2041 534e  * Create new ASN
│ │ │ │ -00036900: 2e31 2073 7472 7563 7475 7265 2066 6f72  .1 structure for
│ │ │ │ -00036910: 204b 5242 2d45 5252 4f52 2e0a 0a20 2020   KRB-ERROR...   
│ │ │ │ -00036920: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ -00036930: 2a20 5265 7475 726e 7320 4153 4e2e 3120  * Returns ASN.1 
│ │ │ │ -00036940: 7374 7275 6374 7572 652e 0a0a 7368 6973  structure...shis
│ │ │ │ -00036950: 6869 5f61 736e 315f 6b72 6273 6166 650a  hi_asn1_krbsafe.
│ │ │ │ -00036960: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00036970: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ -00036980: 6e3a 2053 6869 7368 695f 6173 6e31 2073  n: Shishi_asn1 s
│ │ │ │ -00036990: 6869 7368 695f 6173 6e31 5f6b 7262 7361  hishi_asn1_krbsa
│ │ │ │ -000369a0: 6665 2028 5368 6973 6869 202a 2048 414e  fe (Shishi * HAN
│ │ │ │ -000369b0: 444c 4529 0a20 2020 2020 4841 4e44 4c45  DLE).     HANDLE
│ │ │ │ -000369c0: 3a20 7368 6973 6869 2068 616e 646c 6520  : shishi handle 
│ │ │ │ -000369d0: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ -000369e0: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ -000369f0: e280 992e 0a0a 2020 2020 202a 4465 7363  ......     *Desc
│ │ │ │ -00036a00: 7269 7074 696f 6e3a 2a20 4372 6561 7465  ription:* Create
│ │ │ │ -00036a10: 206e 6577 2041 534e 2e31 2073 7472 7563   new ASN.1 struc
│ │ │ │ -00036a20: 7475 7265 2066 6f72 204b 5242 2d53 4146  ture for KRB-SAF
│ │ │ │ -00036a30: 452e 0a0a 2020 2020 202a 5265 7475 726e  E...     *Return
│ │ │ │ -00036a40: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ -00036a50: 2041 534e 2e31 2073 7472 7563 7475 7265   ASN.1 structure
│ │ │ │ -00036a60: 2e0a 0a73 6869 7368 695f 6173 6e31 5f70  ...shishi_asn1_p
│ │ │ │ -00036a70: 7269 760a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  riv.------------
│ │ │ │ -00036a80: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -00036a90: 6f6e 3a20 5368 6973 6869 5f61 736e 3120  on: Shishi_asn1 
│ │ │ │ -00036aa0: 7368 6973 6869 5f61 736e 315f 7072 6976  shishi_asn1_priv
│ │ │ │ -00036ab0: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ -00036ac0: 4529 0a20 2020 2020 4841 4e44 4c45 3a20  E).     HANDLE: 
│ │ │ │ -00036ad0: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ -00036ae0: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ -00036af0: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ -00036b00: 992e 0a0a 2020 2020 202a 4465 7363 7269  ....     *Descri
│ │ │ │ -00036b10: 7074 696f 6e3a 2a20 4372 6561 7465 206e  ption:* Create n
│ │ │ │ -00036b20: 6577 2041 534e 2e31 2073 7472 7563 7475  ew ASN.1 structu
│ │ │ │ -00036b30: 7265 2066 6f72 204b 5242 2d50 5249 562e  re for KRB-PRIV.
│ │ │ │ -00036b40: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ -00036b50: 616c 7565 3a2a 2052 6574 7572 6e73 2041  alue:* Returns A
│ │ │ │ -00036b60: 534e 2e31 2073 7472 7563 7475 7265 2e0a  SN.1 structure..
│ │ │ │ -00036b70: 0a73 6869 7368 695f 6173 6e31 5f65 6e63  .shishi_asn1_enc
│ │ │ │ -00036b80: 7072 6976 7061 7274 0a2d 2d2d 2d2d 2d2d  privpart.-------
│ │ │ │ +000363b0: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ +000363c0: 2053 6869 7368 695f 6173 6e31 2073 6869   Shishi_asn1 shi
│ │ │ │ +000363d0: 7368 695f 6173 6e31 5f65 6e63 7469 636b  shi_asn1_enctick
│ │ │ │ +000363e0: 6574 7061 7274 2028 5368 6973 6869 202a  etpart (Shishi *
│ │ │ │ +000363f0: 2048 414e 444c 4529 0a20 2020 2020 4841   HANDLE).     HA
│ │ │ │ +00036400: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ +00036410: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ +00036420: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ +00036430: 6974 2829 e280 992e 0a0a 2020 2020 202a  it()......     *
│ │ │ │ +00036440: 4465 7363 7269 7074 696f 6e3a 2a20 4372  Description:* Cr
│ │ │ │ +00036450: 6561 7465 206e 6577 2041 534e 2e31 2073  eate new ASN.1 s
│ │ │ │ +00036460: 7472 7563 7475 7265 2066 6f72 2045 6e63  tructure for Enc
│ │ │ │ +00036470: 5469 636b 6574 5061 7274 2e0a 0a20 2020  TicketPart...   
│ │ │ │ +00036480: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ +00036490: 2a20 5265 7475 726e 7320 4153 4e2e 3120  * Returns ASN.1 
│ │ │ │ +000364a0: 7374 7275 6374 7572 652e 0a0a 7368 6973  structure...shis
│ │ │ │ +000364b0: 6869 5f61 736e 315f 6175 7468 656e 7469  hi_asn1_authenti
│ │ │ │ +000364c0: 6361 746f 720a 2d2d 2d2d 2d2d 2d2d 2d2d  cator.----------
│ │ │ │ +000364d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +000364e0: 0a20 2d2d 2046 756e 6374 696f 6e3a 2053  . -- Function: S
│ │ │ │ +000364f0: 6869 7368 695f 6173 6e31 2073 6869 7368  hishi_asn1 shish
│ │ │ │ +00036500: 695f 6173 6e31 5f61 7574 6865 6e74 6963  i_asn1_authentic
│ │ │ │ +00036510: 6174 6f72 2028 5368 6973 6869 202a 2048  ator (Shishi * H
│ │ │ │ +00036520: 414e 444c 4529 0a20 2020 2020 4841 4e44  ANDLE).     HAND
│ │ │ │ +00036530: 4c45 3a20 7368 6973 6869 2068 616e 646c  LE: shishi handl
│ │ │ │ +00036540: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ +00036550: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ +00036560: 2829 e280 992e 0a0a 2020 2020 202a 4465  ()......     *De
│ │ │ │ +00036570: 7363 7269 7074 696f 6e3a 2a20 4372 6561  scription:* Crea
│ │ │ │ +00036580: 7465 206e 6577 2041 534e 2e31 2073 7472  te new ASN.1 str
│ │ │ │ +00036590: 7563 7475 7265 2066 6f72 2041 7574 6865  ucture for Authe
│ │ │ │ +000365a0: 6e74 6963 6174 6f72 2e0a 0a20 2020 2020  nticator...     
│ │ │ │ +000365b0: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ +000365c0: 5265 7475 726e 7320 4153 4e2e 3120 7374  Returns ASN.1 st
│ │ │ │ +000365d0: 7275 6374 7572 652e 0a0a 7368 6973 6869  ructure...shishi
│ │ │ │ +000365e0: 5f61 736e 315f 656e 636b 6463 7265 7070  _asn1_enckdcrepp
│ │ │ │ +000365f0: 6172 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  art.------------
│ │ │ │ +00036600: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ +00036610: 2d2d 2046 756e 6374 696f 6e3a 2053 6869  -- Function: Shi
│ │ │ │ +00036620: 7368 695f 6173 6e31 2073 6869 7368 695f  shi_asn1 shishi_
│ │ │ │ +00036630: 6173 6e31 5f65 6e63 6b64 6372 6570 7061  asn1_enckdcreppa
│ │ │ │ +00036640: 7274 2028 5368 6973 6869 202a 2048 414e  rt (Shishi * HAN
│ │ │ │ +00036650: 444c 4529 0a20 2020 2020 4841 4e44 4c45  DLE).     HANDLE
│ │ │ │ +00036660: 3a20 7368 6973 6869 2068 616e 646c 6520  : shishi handle 
│ │ │ │ +00036670: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ +00036680: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ +00036690: e280 992e 0a0a 2020 2020 202a 4465 7363  ......     *Desc
│ │ │ │ +000366a0: 7269 7074 696f 6e3a 2a20 4372 6561 7465  ription:* Create
│ │ │ │ +000366b0: 206e 6577 2041 534e 2e31 2073 7472 7563   new ASN.1 struc
│ │ │ │ +000366c0: 7475 7265 2066 6f72 2045 6e63 4b44 4352  ture for EncKDCR
│ │ │ │ +000366d0: 6570 5061 7274 2e0a 0a20 2020 2020 2a52  epPart...     *R
│ │ │ │ +000366e0: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +000366f0: 7475 726e 7320 4153 4e2e 3120 7374 7275  turns ASN.1 stru
│ │ │ │ +00036700: 6374 7572 652e 0a0a 7368 6973 6869 5f61  cture...shishi_a
│ │ │ │ +00036710: 736e 315f 656e 6361 7372 6570 7061 7274  sn1_encasreppart
│ │ │ │ +00036720: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ +00036730: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +00036740: 756e 6374 696f 6e3a 2053 6869 7368 695f  unction: Shishi_
│ │ │ │ +00036750: 6173 6e31 2073 6869 7368 695f 6173 6e31  asn1 shishi_asn1
│ │ │ │ +00036760: 5f65 6e63 6173 7265 7070 6172 7420 2853  _encasreppart (S
│ │ │ │ +00036770: 6869 7368 6920 2a20 4841 4e44 4c45 290a  hishi * HANDLE).
│ │ │ │ +00036780: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ +00036790: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ +000367a0: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ +000367b0: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ +000367c0: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +000367d0: 6f6e 3a2a 2043 7265 6174 6520 6e65 7720  on:* Create new 
│ │ │ │ +000367e0: 4153 4e2e 3120 7374 7275 6374 7572 6520  ASN.1 structure 
│ │ │ │ +000367f0: 666f 7220 456e 6341 5352 6570 5061 7274  for EncASRepPart
│ │ │ │ +00036800: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ +00036810: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ +00036820: 4153 4e2e 3120 7374 7275 6374 7572 652e  ASN.1 structure.
│ │ │ │ +00036830: 0a0a 7368 6973 6869 5f61 736e 315f 6b72  ..shishi_asn1_kr
│ │ │ │ +00036840: 6265 7272 6f72 0a2d 2d2d 2d2d 2d2d 2d2d  berror.---------
│ │ │ │ +00036850: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ +00036860: 2046 756e 6374 696f 6e3a 2053 6869 7368   Function: Shish
│ │ │ │ +00036870: 695f 6173 6e31 2073 6869 7368 695f 6173  i_asn1 shishi_as
│ │ │ │ +00036880: 6e31 5f6b 7262 6572 726f 7220 2853 6869  n1_krberror (Shi
│ │ │ │ +00036890: 7368 6920 2a20 4841 4e44 4c45 290a 2020  shi * HANDLE).  
│ │ │ │ +000368a0: 2020 2048 414e 444c 453a 2073 6869 7368     HANDLE: shish
│ │ │ │ +000368b0: 6920 6861 6e64 6c65 2061 7320 616c 6c6f  i handle as allo
│ │ │ │ +000368c0: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ +000368d0: 6869 5f69 6e69 7428 29e2 8099 2e0a 0a20  hi_init()...... 
│ │ │ │ +000368e0: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ +000368f0: 3a2a 2043 7265 6174 6520 6e65 7720 4153  :* Create new AS
│ │ │ │ +00036900: 4e2e 3120 7374 7275 6374 7572 6520 666f  N.1 structure fo
│ │ │ │ +00036910: 7220 4b52 422d 4552 524f 522e 0a0a 2020  r KRB-ERROR...  
│ │ │ │ +00036920: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ +00036930: 3a2a 2052 6574 7572 6e73 2041 534e 2e31  :* Returns ASN.1
│ │ │ │ +00036940: 2073 7472 7563 7475 7265 2e0a 0a73 6869   structure...shi
│ │ │ │ +00036950: 7368 695f 6173 6e31 5f6b 7262 7361 6665  shi_asn1_krbsafe
│ │ │ │ +00036960: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ +00036970: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ +00036980: 6f6e 3a20 5368 6973 6869 5f61 736e 3120  on: Shishi_asn1 
│ │ │ │ +00036990: 7368 6973 6869 5f61 736e 315f 6b72 6273  shishi_asn1_krbs
│ │ │ │ +000369a0: 6166 6520 2853 6869 7368 6920 2a20 4841  afe (Shishi * HA
│ │ │ │ +000369b0: 4e44 4c45 290a 2020 2020 2048 414e 444c  NDLE).     HANDL
│ │ │ │ +000369c0: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ +000369d0: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ +000369e0: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ +000369f0: 29e2 8099 2e0a 0a20 2020 2020 2a44 6573  )......     *Des
│ │ │ │ +00036a00: 6372 6970 7469 6f6e 3a2a 2043 7265 6174  cription:* Creat
│ │ │ │ +00036a10: 6520 6e65 7720 4153 4e2e 3120 7374 7275  e new ASN.1 stru
│ │ │ │ +00036a20: 6374 7572 6520 666f 7220 4b52 422d 5341  cture for KRB-SA
│ │ │ │ +00036a30: 4645 2e0a 0a20 2020 2020 2a52 6574 7572  FE...     *Retur
│ │ │ │ +00036a40: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ +00036a50: 7320 4153 4e2e 3120 7374 7275 6374 7572  s ASN.1 structur
│ │ │ │ +00036a60: 652e 0a0a 7368 6973 6869 5f61 736e 315f  e...shishi_asn1_
│ │ │ │ +00036a70: 7072 6976 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  priv.-----------
│ │ │ │ +00036a80: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +00036a90: 696f 6e3a 2053 6869 7368 695f 6173 6e31  ion: Shishi_asn1
│ │ │ │ +00036aa0: 2073 6869 7368 695f 6173 6e31 5f70 7269   shishi_asn1_pri
│ │ │ │ +00036ab0: 7620 2853 6869 7368 6920 2a20 4841 4e44  v (Shishi * HAND
│ │ │ │ +00036ac0: 4c45 290a 2020 2020 2048 414e 444c 453a  LE).     HANDLE:
│ │ │ │ +00036ad0: 2073 6869 7368 6920 6861 6e64 6c65 2061   shishi handle a
│ │ │ │ +00036ae0: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ +00036af0: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ +00036b00: 8099 2e0a 0a20 2020 2020 2a44 6573 6372  .....     *Descr
│ │ │ │ +00036b10: 6970 7469 6f6e 3a2a 2043 7265 6174 6520  iption:* Create 
│ │ │ │ +00036b20: 6e65 7720 4153 4e2e 3120 7374 7275 6374  new ASN.1 struct
│ │ │ │ +00036b30: 7572 6520 666f 7220 4b52 422d 5052 4956  ure for KRB-PRIV
│ │ │ │ +00036b40: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ +00036b50: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ +00036b60: 4153 4e2e 3120 7374 7275 6374 7572 652e  ASN.1 structure.
│ │ │ │ +00036b70: 0a0a 7368 6973 6869 5f61 736e 315f 656e  ..shishi_asn1_en
│ │ │ │ +00036b80: 6370 7269 7670 6172 740a 2d2d 2d2d 2d2d  cprivpart.------
│ │ │ │  00036b90: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00036ba0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ -00036bb0: 5368 6973 6869 5f61 736e 3120 7368 6973  Shishi_asn1 shis
│ │ │ │ -00036bc0: 6869 5f61 736e 315f 656e 6370 7269 7670  hi_asn1_encprivp
│ │ │ │ -00036bd0: 6172 7420 2853 6869 7368 6920 2a20 4841  art (Shishi * HA
│ │ │ │ -00036be0: 4e44 4c45 290a 2020 2020 2048 414e 444c  NDLE).     HANDL
│ │ │ │ -00036bf0: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ -00036c00: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ -00036c10: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ -00036c20: 29e2 8099 2e0a 0a20 2020 2020 2a44 6573  )......     *Des
│ │ │ │ -00036c30: 6372 6970 7469 6f6e 3a2a 2043 7265 6174  cription:* Creat
│ │ │ │ -00036c40: 6520 6e65 7720 4153 4e2e 3120 7374 7275  e new ASN.1 stru
│ │ │ │ -00036c50: 6374 7572 6520 666f 7220 456e 634b 7262  cture for EncKrb
│ │ │ │ -00036c60: 5072 6976 5061 7274 2e0a 0a20 2020 2020  PrivPart...     
│ │ │ │ -00036c70: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ -00036c80: 5265 7475 726e 7320 4153 4e2e 3120 7374  Returns ASN.1 st
│ │ │ │ -00036c90: 7275 6374 7572 652e 0a0a 7368 6973 6869  ructure...shishi
│ │ │ │ -00036ca0: 5f61 736e 315f 746f 5f64 6572 5f66 6965  _asn1_to_der_fie
│ │ │ │ -00036cb0: 6c64 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ld.-------------
│ │ │ │ -00036cc0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ -00036cd0: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ -00036ce0: 6869 7368 695f 6173 6e31 5f74 6f5f 6465  hishi_asn1_to_de
│ │ │ │ -00036cf0: 725f 6669 656c 6420 2853 6869 7368 6920  r_field (Shishi 
│ │ │ │ -00036d00: 2a20 4841 4e44 4c45 2c0a 2020 2020 2020  * HANDLE,.      
│ │ │ │ -00036d10: 2020 2020 5368 6973 6869 5f61 736e 3120      Shishi_asn1 
│ │ │ │ -00036d20: 4e4f 4445 2c20 636f 6e73 7420 6368 6172  NODE, const char
│ │ │ │ -00036d30: 202a 2046 4945 4c44 2c20 6368 6172 202a   * FIELD, char *
│ │ │ │ -00036d40: 2a20 4445 522c 0a20 2020 2020 2020 2020  * DER,.         
│ │ │ │ -00036d50: 2073 697a 655f 7420 2a20 4c45 4e29 0a20   size_t * LEN). 
│ │ │ │ -00036d60: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ -00036d70: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ -00036d80: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ -00036d90: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ -00036da0: 2020 2020 4e4f 4445 3a20 4153 4e2e 3120      NODE: ASN.1 
│ │ │ │ -00036db0: 6461 7461 2074 6861 7420 6861 7665 2066  data that have f
│ │ │ │ -00036dc0: 6965 6c64 2074 6f20 6578 7472 6163 742e  ield to extract.
│ │ │ │ -00036dd0: 0a20 2020 2020 4649 454c 443a 206e 616d  .     FIELD: nam
│ │ │ │ -00036de0: 6520 6f66 2066 6965 6c64 2069 6e20 4e4f  e of field in NO
│ │ │ │ -00036df0: 4445 2074 6f20 6578 7472 6163 742e 0a20  DE to extract.. 
│ │ │ │ -00036e00: 2020 2020 4445 523a 206f 7574 7075 7420      DER: output 
│ │ │ │ -00036e10: 6172 7261 7920 7468 6174 2068 6f6c 6473  array that holds
│ │ │ │ -00036e20: 2044 4552 2065 6e63 6f64 696e 6720 6f66   DER encoding of
│ │ │ │ -00036e30: 2046 4945 4c44 2069 6e20 4e4f 4445 2e0a   FIELD in NODE..
│ │ │ │ -00036e40: 2020 2020 204c 454e 3a20 6f75 7470 7574       LEN: output
│ │ │ │ -00036e50: 2076 6172 6961 626c 6520 7769 7468 206c   variable with l
│ │ │ │ -00036e60: 656e 6774 6820 6f66 2044 4552 206f 7574  ength of DER out
│ │ │ │ -00036e70: 7075 7420 6172 7261 792e 0a0a 2020 2020  put array...    
│ │ │ │ -00036e80: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ -00036e90: 4578 7472 6163 7420 6e65 776c 7920 616c  Extract newly al
│ │ │ │ -00036ea0: 6c6f 6361 7465 6420 4445 5220 7265 7072  located DER repr
│ │ │ │ -00036eb0: 6573 656e 7461 7469 6f6e 206f 660a 2020  esentation of.  
│ │ │ │ -00036ec0: 2020 2073 7065 6369 6669 6564 2041 534e     specified ASN
│ │ │ │ -00036ed0: 2e31 2066 6965 6c64 2e0a 0a20 2020 2020  .1 field...     
│ │ │ │ -00036ee0: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ -00036ef0: 5265 7475 726e 7320 5348 4953 4849 5f4f  Returns SHISHI_O
│ │ │ │ -00036f00: 4b20 6966 2073 7563 6365 7373 6675 6c2c  K if successful,
│ │ │ │ -00036f10: 206f 720a 2020 2020 2053 4849 5348 495f   or.     SHISHI_
│ │ │ │ -00036f20: 4153 4e31 5f45 5252 4f52 2069 6620 4445  ASN1_ERROR if DE
│ │ │ │ -00036f30: 5220 656e 636f 6469 6e67 2066 6169 6c73  R encoding fails
│ │ │ │ -00036f40: 2028 636f 6d6d 6f6e 2072 6561 736f 6e73   (common reasons
│ │ │ │ -00036f50: 2066 6f72 2074 6869 7320 6973 0a20 2020   for this is.   
│ │ │ │ -00036f60: 2020 7468 6174 2074 6865 2041 534e 2e31    that the ASN.1
│ │ │ │ -00036f70: 2069 7320 6d69 7373 696e 6720 7265 7175   is missing requ
│ │ │ │ -00036f80: 6972 6564 2076 616c 7565 7329 2e0a 0a73  ired values)...s
│ │ │ │ -00036f90: 6869 7368 695f 6173 6e31 5f74 6f5f 6465  hishi_asn1_to_de
│ │ │ │ -00036fa0: 720a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  r.--------------
│ │ │ │ -00036fb0: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -00036fc0: 6f6e 3a20 696e 7420 7368 6973 6869 5f61  on: int shishi_a
│ │ │ │ -00036fd0: 736e 315f 746f 5f64 6572 2028 5368 6973  sn1_to_der (Shis
│ │ │ │ -00036fe0: 6869 202a 2048 414e 444c 452c 2053 6869  hi * HANDLE, Shi
│ │ │ │ -00036ff0: 7368 695f 6173 6e31 204e 4f44 452c 0a20  shi_asn1 NODE,. 
│ │ │ │ -00037000: 2020 2020 2020 2020 2063 6861 7220 2a2a           char **
│ │ │ │ -00037010: 2044 4552 2c20 7369 7a65 5f74 202a 204c   DER, size_t * L
│ │ │ │ -00037020: 454e 290a 2020 2020 2048 414e 444c 453a  EN).     HANDLE:
│ │ │ │ -00037030: 2073 6869 7368 6920 6861 6e64 6c65 2061   shishi handle a
│ │ │ │ -00037040: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ -00037050: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ -00037060: 8099 2e0a 2020 2020 204e 4f44 453a 2041  ....     NODE: A
│ │ │ │ -00037070: 534e 2e31 2064 6174 6120 746f 2063 6f6e  SN.1 data to con
│ │ │ │ -00037080: 7665 7274 2074 6f20 4445 522e 0a20 2020  vert to DER..   
│ │ │ │ -00037090: 2020 4445 523a 206f 7574 7075 7420 6172    DER: output ar
│ │ │ │ -000370a0: 7261 7920 7468 6174 2068 6f6c 6473 2044  ray that holds D
│ │ │ │ -000370b0: 4552 2065 6e63 6f64 696e 6720 6f66 204e  ER encoding of N
│ │ │ │ -000370c0: 4f44 452e 0a20 2020 2020 4c45 4e3a 206f  ODE..     LEN: o
│ │ │ │ -000370d0: 7574 7075 7420 7661 7269 6162 6c65 2077  utput variable w
│ │ │ │ -000370e0: 6974 6820 6c65 6e67 7468 206f 6620 4445  ith length of DE
│ │ │ │ -000370f0: 5220 6f75 7470 7574 2061 7272 6179 2e0a  R output array..
│ │ │ │ -00037100: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -00037110: 6f6e 3a2a 2045 7874 7261 6374 206e 6577  on:* Extract new
│ │ │ │ -00037120: 6c79 2061 6c6c 6f63 6174 6564 2044 4552  ly allocated DER
│ │ │ │ -00037130: 2072 6570 7265 7365 6e74 6174 696f 6e20   representation 
│ │ │ │ -00037140: 6f66 0a20 2020 2020 7370 6563 6966 6965  of.     specifie
│ │ │ │ -00037150: 6420 4153 4e2e 3120 6461 7461 2e0a 0a20  d ASN.1 data... 
│ │ │ │ -00037160: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ -00037170: 653a 2a20 5265 7475 726e 7320 5348 4953  e:* Returns SHIS
│ │ │ │ -00037180: 4849 5f4f 4b20 6966 2073 7563 6365 7373  HI_OK if success
│ │ │ │ -00037190: 6675 6c2c 206f 720a 2020 2020 2053 4849  ful, or.     SHI
│ │ │ │ -000371a0: 5348 495f 4153 4e31 5f45 5252 4f52 2069  SHI_ASN1_ERROR i
│ │ │ │ -000371b0: 6620 4445 5220 656e 636f 6469 6e67 2066  f DER encoding f
│ │ │ │ -000371c0: 6169 6c73 2028 636f 6d6d 6f6e 2072 6561  ails (common rea
│ │ │ │ -000371d0: 736f 6e73 2066 6f72 2074 6869 7320 6973  sons for this is
│ │ │ │ -000371e0: 0a20 2020 2020 7468 6174 2074 6865 2041  .     that the A
│ │ │ │ -000371f0: 534e 2e31 2069 7320 6d69 7373 696e 6720  SN.1 is missing 
│ │ │ │ -00037200: 7265 7175 6972 6564 2076 616c 7565 7329  required values)
│ │ │ │ -00037210: 2e0a 0a73 6869 7368 695f 6173 6e31 5f6d  ...shishi_asn1_m
│ │ │ │ -00037220: 7367 7479 7065 0a2d 2d2d 2d2d 2d2d 2d2d  sgtype.---------
│ │ │ │ -00037230: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ -00037240: 4675 6e63 7469 6f6e 3a20 5368 6973 6869  Function: Shishi
│ │ │ │ -00037250: 5f6d 7367 7479 7065 2073 6869 7368 695f  _msgtype shishi_
│ │ │ │ -00037260: 6173 6e31 5f6d 7367 7479 7065 2028 5368  asn1_msgtype (Sh
│ │ │ │ -00037270: 6973 6869 202a 2048 414e 444c 452c 0a20  ishi * HANDLE,. 
│ │ │ │ -00037280: 2020 2020 2020 2020 2053 6869 7368 695f           Shishi_
│ │ │ │ -00037290: 6173 6e31 204e 4f44 4529 0a20 2020 2020  asn1 NODE).     
│ │ │ │ -000372a0: 4841 4e44 4c45 3a20 7368 6973 6869 2068  HANDLE: shishi h
│ │ │ │ -000372b0: 616e 646c 6520 6173 2061 6c6c 6f63 6174  andle as allocat
│ │ │ │ -000372c0: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ -000372d0: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ -000372e0: 4e4f 4445 3a20 4153 4e2e 3120 7479 7065  NODE: ASN.1 type
│ │ │ │ -000372f0: 2074 6f20 6765 7420 6d73 6720 7479 7065   to get msg type
│ │ │ │ -00037300: 2066 6f72 2e0a 0a20 2020 2020 2a44 6573   for...     *Des
│ │ │ │ -00037310: 6372 6970 7469 6f6e 3a2a 2044 6574 6572  cription:* Deter
│ │ │ │ -00037320: 6d69 6e65 206d 7367 2d74 7970 6520 6f66  mine msg-type of
│ │ │ │ -00037330: 2041 534e 2e31 2074 7970 6520 6f66 2061   ASN.1 type of a
│ │ │ │ -00037340: 2070 6163 6b65 742e 0a20 2020 2020 4375   packet..     Cu
│ │ │ │ -00037350: 7272 656e 746c 7920 7468 6973 2075 7365  rrently this use
│ │ │ │ -00037360: 7320 7468 6520 6d73 672d 7479 7065 2066  s the msg-type f
│ │ │ │ -00037370: 6965 6c64 2069 6e73 7465 6164 206f 6620  ield instead of 
│ │ │ │ -00037380: 7468 6520 4150 504c 4943 4154 494f 4e0a  the APPLICATION.
│ │ │ │ -00037390: 2020 2020 2074 6167 2c20 6275 7420 7468       tag, but th
│ │ │ │ -000373a0: 6973 206d 6179 2062 6520 6368 616e 6765  is may be change
│ │ │ │ -000373b0: 6420 696e 2074 6865 2066 7574 7572 652e  d in the future.
│ │ │ │ -000373c0: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ -000373d0: 616c 7565 3a2a 2052 6574 7572 6e73 206d  alue:* Returns m
│ │ │ │ -000373e0: 7367 2d74 7970 6520 6f66 2041 534e 2e31  sg-type of ASN.1
│ │ │ │ -000373f0: 2074 7970 652c 2030 206f 6e20 6661 696c   type, 0 on fail
│ │ │ │ -00037400: 7572 652e 0a0a 7368 6973 6869 5f64 6572  ure...shishi_der
│ │ │ │ -00037410: 5f6d 7367 7479 7065 0a2d 2d2d 2d2d 2d2d  _msgtype.-------
│ │ │ │ -00037420: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ -00037430: 2046 756e 6374 696f 6e3a 2053 6869 7368   Function: Shish
│ │ │ │ -00037440: 695f 6d73 6774 7970 6520 7368 6973 6869  i_msgtype shishi
│ │ │ │ -00037450: 5f64 6572 5f6d 7367 7479 7065 2028 5368  _der_msgtype (Sh
│ │ │ │ -00037460: 6973 6869 202a 2048 414e 444c 452c 0a20  ishi * HANDLE,. 
│ │ │ │ -00037470: 2020 2020 2020 2020 2063 6f6e 7374 2063           const c
│ │ │ │ -00037480: 6861 7220 2a20 4445 522c 2073 697a 655f  har * DER, size_
│ │ │ │ -00037490: 7420 4445 524c 454e 290a 2020 2020 2048  t DERLEN).     H
│ │ │ │ -000374a0: 414e 444c 453a 2073 6869 7368 6920 6861  ANDLE: shishi ha
│ │ │ │ -000374b0: 6e64 6c65 2061 7320 616c 6c6f 6361 7465  ndle as allocate
│ │ │ │ -000374c0: 6420 6279 20e2 8098 7368 6973 6869 5f69  d by ...shishi_i
│ │ │ │ -000374d0: 6e69 7428 29e2 8099 2e0a 2020 2020 2044  nit().....     D
│ │ │ │ -000374e0: 4552 3a20 696e 7075 7420 6368 6172 6163  ER: input charac
│ │ │ │ -000374f0: 7465 7220 6172 7261 7920 7769 7468 2044  ter array with D
│ │ │ │ -00037500: 4552 2065 6e63 6f64 696e 672e 0a20 2020  ER encoding..   
│ │ │ │ -00037510: 2020 4445 524c 454e 3a20 6c65 6e67 7468    DERLEN: length
│ │ │ │ -00037520: 206f 6620 696e 7075 7420 6368 6172 6163   of input charac
│ │ │ │ -00037530: 7465 7220 6172 7261 7920 7769 7468 2044  ter array with D
│ │ │ │ -00037540: 4552 2065 6e63 6f64 696e 672e 0a0a 2020  ER encoding...  
│ │ │ │ -00037550: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ -00037560: 2a20 4465 7465 726d 696e 6520 6d73 672d  * Determine msg-
│ │ │ │ -00037570: 7479 7065 206f 6620 4445 5220 636f 6465  type of DER code
│ │ │ │ -00037580: 6420 6461 7461 206f 6620 6120 7061 636b  d data of a pack
│ │ │ │ -00037590: 6574 2e0a 0a20 2020 2020 2a52 6574 7572  et...     *Retur
│ │ │ │ -000375a0: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ -000375b0: 7320 6d73 672d 7479 7065 206f 6620 4445  s msg-type of DE
│ │ │ │ -000375c0: 5220 6461 7461 2c20 3020 6f6e 2066 6169  R data, 0 on fai
│ │ │ │ -000375d0: 6c75 7265 2e0a 0a73 6869 7368 695f 6465  lure...shishi_de
│ │ │ │ -000375e0: 7232 6173 6e31 0a2d 2d2d 2d2d 2d2d 2d2d  r2asn1.---------
│ │ │ │ -000375f0: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ -00037600: 7469 6f6e 3a20 5368 6973 6869 5f61 736e  tion: Shishi_asn
│ │ │ │ -00037610: 3120 7368 6973 6869 5f64 6572 3261 736e  1 shishi_der2asn
│ │ │ │ -00037620: 3120 2853 6869 7368 6920 2a20 4841 4e44  1 (Shishi * HAND
│ │ │ │ -00037630: 4c45 2c0a 2020 2020 2020 2020 2020 636f  LE,.          co
│ │ │ │ -00037640: 6e73 7420 6368 6172 202a 2044 4552 2c20  nst char * DER, 
│ │ │ │ -00037650: 7369 7a65 5f74 2044 4552 4c45 4e29 0a20  size_t DERLEN). 
│ │ │ │ -00037660: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ -00037670: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ -00037680: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ -00037690: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ -000376a0: 2020 2020 4445 523a 2069 6e70 7574 2063      DER: input c
│ │ │ │ -000376b0: 6861 7261 6374 6572 2061 7272 6179 2077  haracter array w
│ │ │ │ -000376c0: 6974 6820 4445 5220 656e 636f 6469 6e67  ith DER encoding
│ │ │ │ -000376d0: 2e0a 2020 2020 2044 4552 4c45 4e3a 206c  ..     DERLEN: l
│ │ │ │ -000376e0: 656e 6774 6820 6f66 2069 6e70 7574 2063  ength of input c
│ │ │ │ -000376f0: 6861 7261 6374 6572 2061 7272 6179 2077  haracter array w
│ │ │ │ -00037700: 6974 6820 4445 5220 656e 636f 6469 6e67  ith DER encoding
│ │ │ │ -00037710: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ -00037720: 7469 6f6e 3a2a 2043 6f6e 7665 7274 2061  tion:* Convert a
│ │ │ │ -00037730: 7262 6974 7261 7279 2044 4552 2064 6174  rbitrary DER dat
│ │ │ │ -00037740: 6120 6f66 2061 2070 6163 6b65 7420 746f  a of a packet to
│ │ │ │ -00037750: 2061 2041 534e 2e31 0a20 2020 2020 7479   a ASN.1.     ty
│ │ │ │ -00037760: 7065 2e0a 0a20 2020 2020 2a52 6574 7572  pe...     *Retur
│ │ │ │ -00037770: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ -00037780: 7320 6e65 776c 7920 616c 6c6f 6361 7465  s newly allocate
│ │ │ │ -00037790: 2041 534e 2e31 2063 6f72 7265 7370 6f6e   ASN.1 correspon
│ │ │ │ -000377a0: 6469 6e67 2074 6f20 4445 520a 2020 2020  ding to DER.    
│ │ │ │ -000377b0: 2064 6174 612c 206f 7220 e280 984e 554c   data, or ...NUL
│ │ │ │ -000377c0: 4ce2 8099 206f 6e20 6661 696c 7572 652e  L... on failure.
│ │ │ │ -000377d0: 0a0a 7368 6973 6869 5f64 6572 3261 736e  ..shishi_der2asn
│ │ │ │ -000377e0: 315f 7061 6461 7461 0a2d 2d2d 2d2d 2d2d  1_padata.-------
│ │ │ │ -000377f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -00037800: 0a20 2d2d 2046 756e 6374 696f 6e3a 2053  . -- Function: S
│ │ │ │ -00037810: 6869 7368 695f 6173 6e31 2073 6869 7368  hishi_asn1 shish
│ │ │ │ -00037820: 695f 6465 7232 6173 6e31 5f70 6164 6174  i_der2asn1_padat
│ │ │ │ -00037830: 6120 2853 6869 7368 6920 2a20 4841 4e44  a (Shishi * HAND
│ │ │ │ -00037840: 4c45 2c0a 2020 2020 2020 2020 2020 636f  LE,.          co
│ │ │ │ -00037850: 6e73 7420 6368 6172 202a 2044 4552 2c20  nst char * DER, 
│ │ │ │ -00037860: 7369 7a65 5f74 2044 4552 4c45 4e29 0a20  size_t DERLEN). 
│ │ │ │ -00037870: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ -00037880: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ -00037890: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ -000378a0: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ -000378b0: 2020 2020 4445 523a 2069 6e70 7574 2063      DER: input c
│ │ │ │ -000378c0: 6861 7261 6374 6572 2061 7272 6179 2077  haracter array w
│ │ │ │ -000378d0: 6974 6820 4445 5220 656e 636f 6469 6e67  ith DER encoding
│ │ │ │ -000378e0: 2e0a 2020 2020 2044 4552 4c45 4e3a 206c  ..     DERLEN: l
│ │ │ │ -000378f0: 656e 6774 6820 6f66 2069 6e70 7574 2063  ength of input c
│ │ │ │ -00037900: 6861 7261 6374 6572 2061 7272 6179 2077  haracter array w
│ │ │ │ -00037910: 6974 6820 4445 5220 656e 636f 6469 6e67  ith DER encoding
│ │ │ │ -00037920: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ -00037930: 7469 6f6e 3a2a 2044 6563 6f64 6520 4445  tion:* Decode DE
│ │ │ │ -00037940: 5220 656e 636f 6469 6e67 206f 6620 5041  R encoding of PA
│ │ │ │ -00037950: 2d44 4154 4120 616e 6420 6372 6561 7465  -DATA and create
│ │ │ │ -00037960: 2061 2041 534e 2e31 0a20 2020 2020 7374   a ASN.1.     st
│ │ │ │ -00037970: 7275 6374 7572 652e 0a0a 2020 2020 202a  ructure...     *
│ │ │ │ -00037980: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ -00037990: 6574 7572 6e73 2041 534e 2e31 2073 7472  eturns ASN.1 str
│ │ │ │ -000379a0: 7563 7475 7265 2063 6f72 7265 7370 6f6e  ucture correspon
│ │ │ │ -000379b0: 6469 6e67 2074 6f20 4445 5220 6461 7461  ding to DER data
│ │ │ │ -000379c0: 2e0a 0a73 6869 7368 695f 6465 7232 6173  ...shishi_der2as
│ │ │ │ -000379d0: 6e31 5f6d 6574 686f 6464 6174 610a 2d2d  n1_methoddata.--
│ │ │ │ +00036ba0: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ +00036bb0: 2053 6869 7368 695f 6173 6e31 2073 6869   Shishi_asn1 shi
│ │ │ │ +00036bc0: 7368 695f 6173 6e31 5f65 6e63 7072 6976  shi_asn1_encpriv
│ │ │ │ +00036bd0: 7061 7274 2028 5368 6973 6869 202a 2048  part (Shishi * H
│ │ │ │ +00036be0: 414e 444c 4529 0a20 2020 2020 4841 4e44  ANDLE).     HAND
│ │ │ │ +00036bf0: 4c45 3a20 7368 6973 6869 2068 616e 646c  LE: shishi handl
│ │ │ │ +00036c00: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ +00036c10: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ +00036c20: 2829 e280 992e 0a0a 2020 2020 202a 4465  ()......     *De
│ │ │ │ +00036c30: 7363 7269 7074 696f 6e3a 2a20 4372 6561  scription:* Crea
│ │ │ │ +00036c40: 7465 206e 6577 2041 534e 2e31 2073 7472  te new ASN.1 str
│ │ │ │ +00036c50: 7563 7475 7265 2066 6f72 2045 6e63 4b72  ucture for EncKr
│ │ │ │ +00036c60: 6250 7269 7650 6172 742e 0a0a 2020 2020  bPrivPart...    
│ │ │ │ +00036c70: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ +00036c80: 2052 6574 7572 6e73 2041 534e 2e31 2073   Returns ASN.1 s
│ │ │ │ +00036c90: 7472 7563 7475 7265 2e0a 0a73 6869 7368  tructure...shish
│ │ │ │ +00036ca0: 695f 6173 6e31 5f74 6f5f 6465 725f 6669  i_asn1_to_der_fi
│ │ │ │ +00036cb0: 656c 640a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  eld.------------
│ │ │ │ +00036cc0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ +00036cd0: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ +00036ce0: 7368 6973 6869 5f61 736e 315f 746f 5f64  shishi_asn1_to_d
│ │ │ │ +00036cf0: 6572 5f66 6965 6c64 2028 5368 6973 6869  er_field (Shishi
│ │ │ │ +00036d00: 202a 2048 414e 444c 452c 0a20 2020 2020   * HANDLE,.     
│ │ │ │ +00036d10: 2020 2020 2053 6869 7368 695f 6173 6e31       Shishi_asn1
│ │ │ │ +00036d20: 204e 4f44 452c 2063 6f6e 7374 2063 6861   NODE, const cha
│ │ │ │ +00036d30: 7220 2a20 4649 454c 442c 2063 6861 7220  r * FIELD, char 
│ │ │ │ +00036d40: 2a2a 2044 4552 2c0a 2020 2020 2020 2020  ** DER,.        
│ │ │ │ +00036d50: 2020 7369 7a65 5f74 202a 204c 454e 290a    size_t * LEN).
│ │ │ │ +00036d60: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ +00036d70: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ +00036d80: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ +00036d90: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ +00036da0: 2020 2020 204e 4f44 453a 2041 534e 2e31       NODE: ASN.1
│ │ │ │ +00036db0: 2064 6174 6120 7468 6174 2068 6176 6520   data that have 
│ │ │ │ +00036dc0: 6669 656c 6420 746f 2065 7874 7261 6374  field to extract
│ │ │ │ +00036dd0: 2e0a 2020 2020 2046 4945 4c44 3a20 6e61  ..     FIELD: na
│ │ │ │ +00036de0: 6d65 206f 6620 6669 656c 6420 696e 204e  me of field in N
│ │ │ │ +00036df0: 4f44 4520 746f 2065 7874 7261 6374 2e0a  ODE to extract..
│ │ │ │ +00036e00: 2020 2020 2044 4552 3a20 6f75 7470 7574       DER: output
│ │ │ │ +00036e10: 2061 7272 6179 2074 6861 7420 686f 6c64   array that hold
│ │ │ │ +00036e20: 7320 4445 5220 656e 636f 6469 6e67 206f  s DER encoding o
│ │ │ │ +00036e30: 6620 4649 454c 4420 696e 204e 4f44 452e  f FIELD in NODE.
│ │ │ │ +00036e40: 0a20 2020 2020 4c45 4e3a 206f 7574 7075  .     LEN: outpu
│ │ │ │ +00036e50: 7420 7661 7269 6162 6c65 2077 6974 6820  t variable with 
│ │ │ │ +00036e60: 6c65 6e67 7468 206f 6620 4445 5220 6f75  length of DER ou
│ │ │ │ +00036e70: 7470 7574 2061 7272 6179 2e0a 0a20 2020  tput array...   
│ │ │ │ +00036e80: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ +00036e90: 2045 7874 7261 6374 206e 6577 6c79 2061   Extract newly a
│ │ │ │ +00036ea0: 6c6c 6f63 6174 6564 2044 4552 2072 6570  llocated DER rep
│ │ │ │ +00036eb0: 7265 7365 6e74 6174 696f 6e20 6f66 0a20  resentation of. 
│ │ │ │ +00036ec0: 2020 2020 7370 6563 6966 6965 6420 4153      specified AS
│ │ │ │ +00036ed0: 4e2e 3120 6669 656c 642e 0a0a 2020 2020  N.1 field...    
│ │ │ │ +00036ee0: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ +00036ef0: 2052 6574 7572 6e73 2053 4849 5348 495f   Returns SHISHI_
│ │ │ │ +00036f00: 4f4b 2069 6620 7375 6363 6573 7366 756c  OK if successful
│ │ │ │ +00036f10: 2c20 6f72 0a20 2020 2020 5348 4953 4849  , or.     SHISHI
│ │ │ │ +00036f20: 5f41 534e 315f 4552 524f 5220 6966 2044  _ASN1_ERROR if D
│ │ │ │ +00036f30: 4552 2065 6e63 6f64 696e 6720 6661 696c  ER encoding fail
│ │ │ │ +00036f40: 7320 2863 6f6d 6d6f 6e20 7265 6173 6f6e  s (common reason
│ │ │ │ +00036f50: 7320 666f 7220 7468 6973 2069 730a 2020  s for this is.  
│ │ │ │ +00036f60: 2020 2074 6861 7420 7468 6520 4153 4e2e     that the ASN.
│ │ │ │ +00036f70: 3120 6973 206d 6973 7369 6e67 2072 6571  1 is missing req
│ │ │ │ +00036f80: 7569 7265 6420 7661 6c75 6573 292e 0a0a  uired values)...
│ │ │ │ +00036f90: 7368 6973 6869 5f61 736e 315f 746f 5f64  shishi_asn1_to_d
│ │ │ │ +00036fa0: 6572 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  er.-------------
│ │ │ │ +00036fb0: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +00036fc0: 696f 6e3a 2069 6e74 2073 6869 7368 695f  ion: int shishi_
│ │ │ │ +00036fd0: 6173 6e31 5f74 6f5f 6465 7220 2853 6869  asn1_to_der (Shi
│ │ │ │ +00036fe0: 7368 6920 2a20 4841 4e44 4c45 2c20 5368  shi * HANDLE, Sh
│ │ │ │ +00036ff0: 6973 6869 5f61 736e 3120 4e4f 4445 2c0a  ishi_asn1 NODE,.
│ │ │ │ +00037000: 2020 2020 2020 2020 2020 6368 6172 202a            char *
│ │ │ │ +00037010: 2a20 4445 522c 2073 697a 655f 7420 2a20  * DER, size_t * 
│ │ │ │ +00037020: 4c45 4e29 0a20 2020 2020 4841 4e44 4c45  LEN).     HANDLE
│ │ │ │ +00037030: 3a20 7368 6973 6869 2068 616e 646c 6520  : shishi handle 
│ │ │ │ +00037040: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ +00037050: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ +00037060: e280 992e 0a20 2020 2020 4e4f 4445 3a20  .....     NODE: 
│ │ │ │ +00037070: 4153 4e2e 3120 6461 7461 2074 6f20 636f  ASN.1 data to co
│ │ │ │ +00037080: 6e76 6572 7420 746f 2044 4552 2e0a 2020  nvert to DER..  
│ │ │ │ +00037090: 2020 2044 4552 3a20 6f75 7470 7574 2061     DER: output a
│ │ │ │ +000370a0: 7272 6179 2074 6861 7420 686f 6c64 7320  rray that holds 
│ │ │ │ +000370b0: 4445 5220 656e 636f 6469 6e67 206f 6620  DER encoding of 
│ │ │ │ +000370c0: 4e4f 4445 2e0a 2020 2020 204c 454e 3a20  NODE..     LEN: 
│ │ │ │ +000370d0: 6f75 7470 7574 2076 6172 6961 626c 6520  output variable 
│ │ │ │ +000370e0: 7769 7468 206c 656e 6774 6820 6f66 2044  with length of D
│ │ │ │ +000370f0: 4552 206f 7574 7075 7420 6172 7261 792e  ER output array.
│ │ │ │ +00037100: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ +00037110: 696f 6e3a 2a20 4578 7472 6163 7420 6e65  ion:* Extract ne
│ │ │ │ +00037120: 776c 7920 616c 6c6f 6361 7465 6420 4445  wly allocated DE
│ │ │ │ +00037130: 5220 7265 7072 6573 656e 7461 7469 6f6e  R representation
│ │ │ │ +00037140: 206f 660a 2020 2020 2073 7065 6369 6669   of.     specifi
│ │ │ │ +00037150: 6564 2041 534e 2e31 2064 6174 612e 0a0a  ed ASN.1 data...
│ │ │ │ +00037160: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ +00037170: 7565 3a2a 2052 6574 7572 6e73 2053 4849  ue:* Returns SHI
│ │ │ │ +00037180: 5348 495f 4f4b 2069 6620 7375 6363 6573  SHI_OK if succes
│ │ │ │ +00037190: 7366 756c 2c20 6f72 0a20 2020 2020 5348  sful, or.     SH
│ │ │ │ +000371a0: 4953 4849 5f41 534e 315f 4552 524f 5220  ISHI_ASN1_ERROR 
│ │ │ │ +000371b0: 6966 2044 4552 2065 6e63 6f64 696e 6720  if DER encoding 
│ │ │ │ +000371c0: 6661 696c 7320 2863 6f6d 6d6f 6e20 7265  fails (common re
│ │ │ │ +000371d0: 6173 6f6e 7320 666f 7220 7468 6973 2069  asons for this i
│ │ │ │ +000371e0: 730a 2020 2020 2074 6861 7420 7468 6520  s.     that the 
│ │ │ │ +000371f0: 4153 4e2e 3120 6973 206d 6973 7369 6e67  ASN.1 is missing
│ │ │ │ +00037200: 2072 6571 7569 7265 6420 7661 6c75 6573   required values
│ │ │ │ +00037210: 292e 0a0a 7368 6973 6869 5f61 736e 315f  )...shishi_asn1_
│ │ │ │ +00037220: 6d73 6774 7970 650a 2d2d 2d2d 2d2d 2d2d  msgtype.--------
│ │ │ │ +00037230: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ +00037240: 2046 756e 6374 696f 6e3a 2053 6869 7368   Function: Shish
│ │ │ │ +00037250: 695f 6d73 6774 7970 6520 7368 6973 6869  i_msgtype shishi
│ │ │ │ +00037260: 5f61 736e 315f 6d73 6774 7970 6520 2853  _asn1_msgtype (S
│ │ │ │ +00037270: 6869 7368 6920 2a20 4841 4e44 4c45 2c0a  hishi * HANDLE,.
│ │ │ │ +00037280: 2020 2020 2020 2020 2020 5368 6973 6869            Shishi
│ │ │ │ +00037290: 5f61 736e 3120 4e4f 4445 290a 2020 2020  _asn1 NODE).    
│ │ │ │ +000372a0: 2048 414e 444c 453a 2073 6869 7368 6920   HANDLE: shishi 
│ │ │ │ +000372b0: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ +000372c0: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ +000372d0: 5f69 6e69 7428 29e2 8099 2e0a 2020 2020  _init().....    
│ │ │ │ +000372e0: 204e 4f44 453a 2041 534e 2e31 2074 7970   NODE: ASN.1 typ
│ │ │ │ +000372f0: 6520 746f 2067 6574 206d 7367 2074 7970  e to get msg typ
│ │ │ │ +00037300: 6520 666f 722e 0a0a 2020 2020 202a 4465  e for...     *De
│ │ │ │ +00037310: 7363 7269 7074 696f 6e3a 2a20 4465 7465  scription:* Dete
│ │ │ │ +00037320: 726d 696e 6520 6d73 672d 7479 7065 206f  rmine msg-type o
│ │ │ │ +00037330: 6620 4153 4e2e 3120 7479 7065 206f 6620  f ASN.1 type of 
│ │ │ │ +00037340: 6120 7061 636b 6574 2e0a 2020 2020 2043  a packet..     C
│ │ │ │ +00037350: 7572 7265 6e74 6c79 2074 6869 7320 7573  urrently this us
│ │ │ │ +00037360: 6573 2074 6865 206d 7367 2d74 7970 6520  es the msg-type 
│ │ │ │ +00037370: 6669 656c 6420 696e 7374 6561 6420 6f66  field instead of
│ │ │ │ +00037380: 2074 6865 2041 5050 4c49 4341 5449 4f4e   the APPLICATION
│ │ │ │ +00037390: 0a20 2020 2020 7461 672c 2062 7574 2074  .     tag, but t
│ │ │ │ +000373a0: 6869 7320 6d61 7920 6265 2063 6861 6e67  his may be chang
│ │ │ │ +000373b0: 6564 2069 6e20 7468 6520 6675 7475 7265  ed in the future
│ │ │ │ +000373c0: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ +000373d0: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ +000373e0: 6d73 672d 7479 7065 206f 6620 4153 4e2e  msg-type of ASN.
│ │ │ │ +000373f0: 3120 7479 7065 2c20 3020 6f6e 2066 6169  1 type, 0 on fai
│ │ │ │ +00037400: 6c75 7265 2e0a 0a73 6869 7368 695f 6465  lure...shishi_de
│ │ │ │ +00037410: 725f 6d73 6774 7970 650a 2d2d 2d2d 2d2d  r_msgtype.------
│ │ │ │ +00037420: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ +00037430: 2d20 4675 6e63 7469 6f6e 3a20 5368 6973  - Function: Shis
│ │ │ │ +00037440: 6869 5f6d 7367 7479 7065 2073 6869 7368  hi_msgtype shish
│ │ │ │ +00037450: 695f 6465 725f 6d73 6774 7970 6520 2853  i_der_msgtype (S
│ │ │ │ +00037460: 6869 7368 6920 2a20 4841 4e44 4c45 2c0a  hishi * HANDLE,.
│ │ │ │ +00037470: 2020 2020 2020 2020 2020 636f 6e73 7420            const 
│ │ │ │ +00037480: 6368 6172 202a 2044 4552 2c20 7369 7a65  char * DER, size
│ │ │ │ +00037490: 5f74 2044 4552 4c45 4e29 0a20 2020 2020  _t DERLEN).     
│ │ │ │ +000374a0: 4841 4e44 4c45 3a20 7368 6973 6869 2068  HANDLE: shishi h
│ │ │ │ +000374b0: 616e 646c 6520 6173 2061 6c6c 6f63 6174  andle as allocat
│ │ │ │ +000374c0: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ +000374d0: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ +000374e0: 4445 523a 2069 6e70 7574 2063 6861 7261  DER: input chara
│ │ │ │ +000374f0: 6374 6572 2061 7272 6179 2077 6974 6820  cter array with 
│ │ │ │ +00037500: 4445 5220 656e 636f 6469 6e67 2e0a 2020  DER encoding..  
│ │ │ │ +00037510: 2020 2044 4552 4c45 4e3a 206c 656e 6774     DERLEN: lengt
│ │ │ │ +00037520: 6820 6f66 2069 6e70 7574 2063 6861 7261  h of input chara
│ │ │ │ +00037530: 6374 6572 2061 7272 6179 2077 6974 6820  cter array with 
│ │ │ │ +00037540: 4445 5220 656e 636f 6469 6e67 2e0a 0a20  DER encoding... 
│ │ │ │ +00037550: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ +00037560: 3a2a 2044 6574 6572 6d69 6e65 206d 7367  :* Determine msg
│ │ │ │ +00037570: 2d74 7970 6520 6f66 2044 4552 2063 6f64  -type of DER cod
│ │ │ │ +00037580: 6564 2064 6174 6120 6f66 2061 2070 6163  ed data of a pac
│ │ │ │ +00037590: 6b65 742e 0a0a 2020 2020 202a 5265 7475  ket...     *Retu
│ │ │ │ +000375a0: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ +000375b0: 6e73 206d 7367 2d74 7970 6520 6f66 2044  ns msg-type of D
│ │ │ │ +000375c0: 4552 2064 6174 612c 2030 206f 6e20 6661  ER data, 0 on fa
│ │ │ │ +000375d0: 696c 7572 652e 0a0a 7368 6973 6869 5f64  ilure...shishi_d
│ │ │ │ +000375e0: 6572 3261 736e 310a 2d2d 2d2d 2d2d 2d2d  er2asn1.--------
│ │ │ │ +000375f0: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +00037600: 6374 696f 6e3a 2053 6869 7368 695f 6173  ction: Shishi_as
│ │ │ │ +00037610: 6e31 2073 6869 7368 695f 6465 7232 6173  n1 shishi_der2as
│ │ │ │ +00037620: 6e31 2028 5368 6973 6869 202a 2048 414e  n1 (Shishi * HAN
│ │ │ │ +00037630: 444c 452c 0a20 2020 2020 2020 2020 2063  DLE,.          c
│ │ │ │ +00037640: 6f6e 7374 2063 6861 7220 2a20 4445 522c  onst char * DER,
│ │ │ │ +00037650: 2073 697a 655f 7420 4445 524c 454e 290a   size_t DERLEN).
│ │ │ │ +00037660: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ +00037670: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ +00037680: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ +00037690: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ +000376a0: 2020 2020 2044 4552 3a20 696e 7075 7420       DER: input 
│ │ │ │ +000376b0: 6368 6172 6163 7465 7220 6172 7261 7920  character array 
│ │ │ │ +000376c0: 7769 7468 2044 4552 2065 6e63 6f64 696e  with DER encodin
│ │ │ │ +000376d0: 672e 0a20 2020 2020 4445 524c 454e 3a20  g..     DERLEN: 
│ │ │ │ +000376e0: 6c65 6e67 7468 206f 6620 696e 7075 7420  length of input 
│ │ │ │ +000376f0: 6368 6172 6163 7465 7220 6172 7261 7920  character array 
│ │ │ │ +00037700: 7769 7468 2044 4552 2065 6e63 6f64 696e  with DER encodin
│ │ │ │ +00037710: 672e 0a0a 2020 2020 202a 4465 7363 7269  g...     *Descri
│ │ │ │ +00037720: 7074 696f 6e3a 2a20 436f 6e76 6572 7420  ption:* Convert 
│ │ │ │ +00037730: 6172 6269 7472 6172 7920 4445 5220 6461  arbitrary DER da
│ │ │ │ +00037740: 7461 206f 6620 6120 7061 636b 6574 2074  ta of a packet t
│ │ │ │ +00037750: 6f20 6120 4153 4e2e 310a 2020 2020 2074  o a ASN.1.     t
│ │ │ │ +00037760: 7970 652e 0a0a 2020 2020 202a 5265 7475  ype...     *Retu
│ │ │ │ +00037770: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ +00037780: 6e73 206e 6577 6c79 2061 6c6c 6f63 6174  ns newly allocat
│ │ │ │ +00037790: 6520 4153 4e2e 3120 636f 7272 6573 706f  e ASN.1 correspo
│ │ │ │ +000377a0: 6e64 696e 6720 746f 2044 4552 0a20 2020  nding to DER.   
│ │ │ │ +000377b0: 2020 6461 7461 2c20 6f72 20e2 8098 4e55    data, or ...NU
│ │ │ │ +000377c0: 4c4c e280 9920 6f6e 2066 6169 6c75 7265  LL... on failure
│ │ │ │ +000377d0: 2e0a 0a73 6869 7368 695f 6465 7232 6173  ...shishi_der2as
│ │ │ │ +000377e0: 6e31 5f70 6164 6174 610a 2d2d 2d2d 2d2d  n1_padata.------
│ │ │ │ +000377f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +00037800: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +00037810: 5368 6973 6869 5f61 736e 3120 7368 6973  Shishi_asn1 shis
│ │ │ │ +00037820: 6869 5f64 6572 3261 736e 315f 7061 6461  hi_der2asn1_pada
│ │ │ │ +00037830: 7461 2028 5368 6973 6869 202a 2048 414e  ta (Shishi * HAN
│ │ │ │ +00037840: 444c 452c 0a20 2020 2020 2020 2020 2063  DLE,.          c
│ │ │ │ +00037850: 6f6e 7374 2063 6861 7220 2a20 4445 522c  onst char * DER,
│ │ │ │ +00037860: 2073 697a 655f 7420 4445 524c 454e 290a   size_t DERLEN).
│ │ │ │ +00037870: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ +00037880: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ +00037890: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ +000378a0: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ +000378b0: 2020 2020 2044 4552 3a20 696e 7075 7420       DER: input 
│ │ │ │ +000378c0: 6368 6172 6163 7465 7220 6172 7261 7920  character array 
│ │ │ │ +000378d0: 7769 7468 2044 4552 2065 6e63 6f64 696e  with DER encodin
│ │ │ │ +000378e0: 672e 0a20 2020 2020 4445 524c 454e 3a20  g..     DERLEN: 
│ │ │ │ +000378f0: 6c65 6e67 7468 206f 6620 696e 7075 7420  length of input 
│ │ │ │ +00037900: 6368 6172 6163 7465 7220 6172 7261 7920  character array 
│ │ │ │ +00037910: 7769 7468 2044 4552 2065 6e63 6f64 696e  with DER encodin
│ │ │ │ +00037920: 672e 0a0a 2020 2020 202a 4465 7363 7269  g...     *Descri
│ │ │ │ +00037930: 7074 696f 6e3a 2a20 4465 636f 6465 2044  ption:* Decode D
│ │ │ │ +00037940: 4552 2065 6e63 6f64 696e 6720 6f66 2050  ER encoding of P
│ │ │ │ +00037950: 412d 4441 5441 2061 6e64 2063 7265 6174  A-DATA and creat
│ │ │ │ +00037960: 6520 6120 4153 4e2e 310a 2020 2020 2073  e a ASN.1.     s
│ │ │ │ +00037970: 7472 7563 7475 7265 2e0a 0a20 2020 2020  tructure...     
│ │ │ │ +00037980: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ +00037990: 5265 7475 726e 7320 4153 4e2e 3120 7374  Returns ASN.1 st
│ │ │ │ +000379a0: 7275 6374 7572 6520 636f 7272 6573 706f  ructure correspo
│ │ │ │ +000379b0: 6e64 696e 6720 746f 2044 4552 2064 6174  nding to DER dat
│ │ │ │ +000379c0: 612e 0a0a 7368 6973 6869 5f64 6572 3261  a...shishi_der2a
│ │ │ │ +000379d0: 736e 315f 6d65 7468 6f64 6461 7461 0a2d  sn1_methoddata.-
│ │ │ │  000379e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000379f0: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -00037a00: 6e63 7469 6f6e 3a20 5368 6973 6869 5f61  nction: Shishi_a
│ │ │ │ -00037a10: 736e 3120 7368 6973 6869 5f64 6572 3261  sn1 shishi_der2a
│ │ │ │ -00037a20: 736e 315f 6d65 7468 6f64 6461 7461 2028  sn1_methoddata (
│ │ │ │ -00037a30: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ -00037a40: 0a20 2020 2020 2020 2020 2063 6f6e 7374  .          const
│ │ │ │ -00037a50: 2063 6861 7220 2a20 4445 522c 2073 697a   char * DER, siz
│ │ │ │ -00037a60: 655f 7420 4445 524c 454e 290a 2020 2020  e_t DERLEN).    
│ │ │ │ -00037a70: 2048 414e 444c 453a 2073 6869 7368 6920   HANDLE: shishi 
│ │ │ │ -00037a80: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ -00037a90: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ -00037aa0: 5f69 6e69 7428 29e2 8099 2e0a 2020 2020  _init().....    
│ │ │ │ -00037ab0: 2044 4552 3a20 696e 7075 7420 6368 6172   DER: input char
│ │ │ │ -00037ac0: 6163 7465 7220 6172 7261 7920 7769 7468  acter array with
│ │ │ │ -00037ad0: 2044 4552 2065 6e63 6f64 696e 672e 0a20   DER encoding.. 
│ │ │ │ -00037ae0: 2020 2020 4445 524c 454e 3a20 6c65 6e67      DERLEN: leng
│ │ │ │ -00037af0: 7468 206f 6620 696e 7075 7420 6368 6172  th of input char
│ │ │ │ -00037b00: 6163 7465 7220 6172 7261 7920 7769 7468  acter array with
│ │ │ │ -00037b10: 2044 4552 2065 6e63 6f64 696e 672e 0a0a   DER encoding...
│ │ │ │ -00037b20: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ -00037b30: 6e3a 2a20 4465 636f 6465 2044 4552 2065  n:* Decode DER e
│ │ │ │ -00037b40: 6e63 6f64 696e 6720 6f66 204d 4554 484f  ncoding of METHO
│ │ │ │ -00037b50: 442d 4441 5441 2061 6e64 2063 7265 6174  D-DATA and creat
│ │ │ │ -00037b60: 6520 610a 2020 2020 2041 534e 2e31 2073  e a.     ASN.1 s
│ │ │ │ -00037b70: 7472 7563 7475 7265 2e0a 0a20 2020 2020  tructure...     
│ │ │ │ -00037b80: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ -00037b90: 5265 7475 726e 7320 4153 4e2e 3120 7374  Returns ASN.1 st
│ │ │ │ -00037ba0: 7275 6374 7572 6520 636f 7272 6573 706f  ructure correspo
│ │ │ │ -00037bb0: 6e64 696e 6720 746f 2044 4552 2064 6174  nding to DER dat
│ │ │ │ -00037bc0: 612e 0a0a 7368 6973 6869 5f64 6572 3261  a...shishi_der2a
│ │ │ │ -00037bd0: 736e 315f 6574 7970 655f 696e 666f 0a2d  sn1_etype_info.-
│ │ │ │ +000379f0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +00037a00: 756e 6374 696f 6e3a 2053 6869 7368 695f  unction: Shishi_
│ │ │ │ +00037a10: 6173 6e31 2073 6869 7368 695f 6465 7232  asn1 shishi_der2
│ │ │ │ +00037a20: 6173 6e31 5f6d 6574 686f 6464 6174 6120  asn1_methoddata 
│ │ │ │ +00037a30: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ +00037a40: 2c0a 2020 2020 2020 2020 2020 636f 6e73  ,.          cons
│ │ │ │ +00037a50: 7420 6368 6172 202a 2044 4552 2c20 7369  t char * DER, si
│ │ │ │ +00037a60: 7a65 5f74 2044 4552 4c45 4e29 0a20 2020  ze_t DERLEN).   
│ │ │ │ +00037a70: 2020 4841 4e44 4c45 3a20 7368 6973 6869    HANDLE: shishi
│ │ │ │ +00037a80: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ +00037a90: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ +00037aa0: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ +00037ab0: 2020 4445 523a 2069 6e70 7574 2063 6861    DER: input cha
│ │ │ │ +00037ac0: 7261 6374 6572 2061 7272 6179 2077 6974  racter array wit
│ │ │ │ +00037ad0: 6820 4445 5220 656e 636f 6469 6e67 2e0a  h DER encoding..
│ │ │ │ +00037ae0: 2020 2020 2044 4552 4c45 4e3a 206c 656e       DERLEN: len
│ │ │ │ +00037af0: 6774 6820 6f66 2069 6e70 7574 2063 6861  gth of input cha
│ │ │ │ +00037b00: 7261 6374 6572 2061 7272 6179 2077 6974  racter array wit
│ │ │ │ +00037b10: 6820 4445 5220 656e 636f 6469 6e67 2e0a  h DER encoding..
│ │ │ │ +00037b20: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +00037b30: 6f6e 3a2a 2044 6563 6f64 6520 4445 5220  on:* Decode DER 
│ │ │ │ +00037b40: 656e 636f 6469 6e67 206f 6620 4d45 5448  encoding of METH
│ │ │ │ +00037b50: 4f44 2d44 4154 4120 616e 6420 6372 6561  OD-DATA and crea
│ │ │ │ +00037b60: 7465 2061 0a20 2020 2020 4153 4e2e 3120  te a.     ASN.1 
│ │ │ │ +00037b70: 7374 7275 6374 7572 652e 0a0a 2020 2020  structure...    
│ │ │ │ +00037b80: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ +00037b90: 2052 6574 7572 6e73 2041 534e 2e31 2073   Returns ASN.1 s
│ │ │ │ +00037ba0: 7472 7563 7475 7265 2063 6f72 7265 7370  tructure corresp
│ │ │ │ +00037bb0: 6f6e 6469 6e67 2074 6f20 4445 5220 6461  onding to DER da
│ │ │ │ +00037bc0: 7461 2e0a 0a73 6869 7368 695f 6465 7232  ta...shishi_der2
│ │ │ │ +00037bd0: 6173 6e31 5f65 7479 7065 5f69 6e66 6f0a  asn1_etype_info.
│ │ │ │  00037be0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00037bf0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ -00037c00: 756e 6374 696f 6e3a 2053 6869 7368 695f  unction: Shishi_
│ │ │ │ -00037c10: 6173 6e31 2073 6869 7368 695f 6465 7232  asn1 shishi_der2
│ │ │ │ -00037c20: 6173 6e31 5f65 7479 7065 5f69 6e66 6f20  asn1_etype_info 
│ │ │ │ -00037c30: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ -00037c40: 2c0a 2020 2020 2020 2020 2020 636f 6e73  ,.          cons
│ │ │ │ -00037c50: 7420 6368 6172 202a 2044 4552 2c20 7369  t char * DER, si
│ │ │ │ -00037c60: 7a65 5f74 2044 4552 4c45 4e29 0a20 2020  ze_t DERLEN).   
│ │ │ │ -00037c70: 2020 4841 4e44 4c45 3a20 7368 6973 6869    HANDLE: shishi
│ │ │ │ -00037c80: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ -00037c90: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ -00037ca0: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ -00037cb0: 2020 4445 523a 2069 6e70 7574 2063 6861    DER: input cha
│ │ │ │ -00037cc0: 7261 6374 6572 2061 7272 6179 2077 6974  racter array wit
│ │ │ │ -00037cd0: 6820 4445 5220 656e 636f 6469 6e67 2e0a  h DER encoding..
│ │ │ │ -00037ce0: 2020 2020 2044 4552 4c45 4e3a 206c 656e       DERLEN: len
│ │ │ │ -00037cf0: 6774 6820 6f66 2069 6e70 7574 2063 6861  gth of input cha
│ │ │ │ -00037d00: 7261 6374 6572 2061 7272 6179 2077 6974  racter array wit
│ │ │ │ -00037d10: 6820 4445 5220 656e 636f 6469 6e67 2e0a  h DER encoding..
│ │ │ │ -00037d20: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -00037d30: 6f6e 3a2a 2044 6563 6f64 6520 4445 5220  on:* Decode DER 
│ │ │ │ -00037d40: 656e 636f 6469 6e67 206f 6620 4554 5950  encoding of ETYP
│ │ │ │ -00037d50: 452d 494e 464f 2061 6e64 2063 7265 6174  E-INFO and creat
│ │ │ │ -00037d60: 6520 6120 4153 4e2e 310a 2020 2020 2073  e a ASN.1.     s
│ │ │ │ -00037d70: 7472 7563 7475 7265 2e0a 0a20 2020 2020  tructure...     
│ │ │ │ -00037d80: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ -00037d90: 5265 7475 726e 7320 4153 4e2e 3120 7374  Returns ASN.1 st
│ │ │ │ -00037da0: 7275 6374 7572 6520 636f 7272 6573 706f  ructure correspo
│ │ │ │ -00037db0: 6e64 696e 6720 746f 2044 4552 2064 6174  nding to DER dat
│ │ │ │ -00037dc0: 612e 0a0a 7368 6973 6869 5f64 6572 3261  a...shishi_der2a
│ │ │ │ -00037dd0: 736e 315f 6574 7970 655f 696e 666f 320a  sn1_etype_info2.
│ │ │ │ -00037de0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00037df0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ -00037e00: 2046 756e 6374 696f 6e3a 2053 6869 7368   Function: Shish
│ │ │ │ -00037e10: 695f 6173 6e31 2073 6869 7368 695f 6465  i_asn1 shishi_de
│ │ │ │ -00037e20: 7232 6173 6e31 5f65 7479 7065 5f69 6e66  r2asn1_etype_inf
│ │ │ │ -00037e30: 6f32 2028 5368 6973 6869 202a 2048 414e  o2 (Shishi * HAN
│ │ │ │ -00037e40: 444c 452c 0a20 2020 2020 2020 2020 2063  DLE,.          c
│ │ │ │ -00037e50: 6f6e 7374 2063 6861 7220 2a20 4445 522c  onst char * DER,
│ │ │ │ -00037e60: 2073 697a 655f 7420 4445 524c 454e 290a   size_t DERLEN).
│ │ │ │ -00037e70: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ -00037e80: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ -00037e90: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ -00037ea0: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ -00037eb0: 2020 2020 2044 4552 3a20 696e 7075 7420       DER: input 
│ │ │ │ -00037ec0: 6368 6172 6163 7465 7220 6172 7261 7920  character array 
│ │ │ │ -00037ed0: 7769 7468 2044 4552 2065 6e63 6f64 696e  with DER encodin
│ │ │ │ -00037ee0: 672e 0a20 2020 2020 4445 524c 454e 3a20  g..     DERLEN: 
│ │ │ │ -00037ef0: 6c65 6e67 7468 206f 6620 696e 7075 7420  length of input 
│ │ │ │ -00037f00: 6368 6172 6163 7465 7220 6172 7261 7920  character array 
│ │ │ │ -00037f10: 7769 7468 2044 4552 2065 6e63 6f64 696e  with DER encodin
│ │ │ │ -00037f20: 672e 0a0a 2020 2020 202a 4465 7363 7269  g...     *Descri
│ │ │ │ -00037f30: 7074 696f 6e3a 2a20 4465 636f 6465 2044  ption:* Decode D
│ │ │ │ -00037f40: 4552 2065 6e63 6f64 696e 6720 6f66 2045  ER encoding of E
│ │ │ │ -00037f50: 5459 5045 2d49 4e46 4f32 2061 6e64 2063  TYPE-INFO2 and c
│ │ │ │ -00037f60: 7265 6174 6520 610a 2020 2020 2041 534e  reate a.     ASN
│ │ │ │ -00037f70: 2e31 2073 7472 7563 7475 7265 2e0a 0a20  .1 structure... 
│ │ │ │ -00037f80: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ -00037f90: 653a 2a20 5265 7475 726e 7320 4153 4e2e  e:* Returns ASN.
│ │ │ │ -00037fa0: 3120 7374 7275 6374 7572 6520 636f 7272  1 structure corr
│ │ │ │ -00037fb0: 6573 706f 6e64 696e 6720 746f 2044 4552  esponding to DER
│ │ │ │ -00037fc0: 2064 6174 612e 0a0a 7368 6973 6869 5f64   data...shishi_d
│ │ │ │ -00037fd0: 6572 3261 736e 315f 7469 636b 6574 0a2d  er2asn1_ticket.-
│ │ │ │ +00037bf0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +00037c00: 4675 6e63 7469 6f6e 3a20 5368 6973 6869  Function: Shishi
│ │ │ │ +00037c10: 5f61 736e 3120 7368 6973 6869 5f64 6572  _asn1 shishi_der
│ │ │ │ +00037c20: 3261 736e 315f 6574 7970 655f 696e 666f  2asn1_etype_info
│ │ │ │ +00037c30: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ +00037c40: 452c 0a20 2020 2020 2020 2020 2063 6f6e  E,.          con
│ │ │ │ +00037c50: 7374 2063 6861 7220 2a20 4445 522c 2073  st char * DER, s
│ │ │ │ +00037c60: 697a 655f 7420 4445 524c 454e 290a 2020  ize_t DERLEN).  
│ │ │ │ +00037c70: 2020 2048 414e 444c 453a 2073 6869 7368     HANDLE: shish
│ │ │ │ +00037c80: 6920 6861 6e64 6c65 2061 7320 616c 6c6f  i handle as allo
│ │ │ │ +00037c90: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ +00037ca0: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ +00037cb0: 2020 2044 4552 3a20 696e 7075 7420 6368     DER: input ch
│ │ │ │ +00037cc0: 6172 6163 7465 7220 6172 7261 7920 7769  aracter array wi
│ │ │ │ +00037cd0: 7468 2044 4552 2065 6e63 6f64 696e 672e  th DER encoding.
│ │ │ │ +00037ce0: 0a20 2020 2020 4445 524c 454e 3a20 6c65  .     DERLEN: le
│ │ │ │ +00037cf0: 6e67 7468 206f 6620 696e 7075 7420 6368  ngth of input ch
│ │ │ │ +00037d00: 6172 6163 7465 7220 6172 7261 7920 7769  aracter array wi
│ │ │ │ +00037d10: 7468 2044 4552 2065 6e63 6f64 696e 672e  th DER encoding.
│ │ │ │ +00037d20: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ +00037d30: 696f 6e3a 2a20 4465 636f 6465 2044 4552  ion:* Decode DER
│ │ │ │ +00037d40: 2065 6e63 6f64 696e 6720 6f66 2045 5459   encoding of ETY
│ │ │ │ +00037d50: 5045 2d49 4e46 4f20 616e 6420 6372 6561  PE-INFO and crea
│ │ │ │ +00037d60: 7465 2061 2041 534e 2e31 0a20 2020 2020  te a ASN.1.     
│ │ │ │ +00037d70: 7374 7275 6374 7572 652e 0a0a 2020 2020  structure...    
│ │ │ │ +00037d80: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ +00037d90: 2052 6574 7572 6e73 2041 534e 2e31 2073   Returns ASN.1 s
│ │ │ │ +00037da0: 7472 7563 7475 7265 2063 6f72 7265 7370  tructure corresp
│ │ │ │ +00037db0: 6f6e 6469 6e67 2074 6f20 4445 5220 6461  onding to DER da
│ │ │ │ +00037dc0: 7461 2e0a 0a73 6869 7368 695f 6465 7232  ta...shishi_der2
│ │ │ │ +00037dd0: 6173 6e31 5f65 7479 7065 5f69 6e66 6f32  asn1_etype_info2
│ │ │ │ +00037de0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ +00037df0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ +00037e00: 2d20 4675 6e63 7469 6f6e 3a20 5368 6973  - Function: Shis
│ │ │ │ +00037e10: 6869 5f61 736e 3120 7368 6973 6869 5f64  hi_asn1 shishi_d
│ │ │ │ +00037e20: 6572 3261 736e 315f 6574 7970 655f 696e  er2asn1_etype_in
│ │ │ │ +00037e30: 666f 3220 2853 6869 7368 6920 2a20 4841  fo2 (Shishi * HA
│ │ │ │ +00037e40: 4e44 4c45 2c0a 2020 2020 2020 2020 2020  NDLE,.          
│ │ │ │ +00037e50: 636f 6e73 7420 6368 6172 202a 2044 4552  const char * DER
│ │ │ │ +00037e60: 2c20 7369 7a65 5f74 2044 4552 4c45 4e29  , size_t DERLEN)
│ │ │ │ +00037e70: 0a20 2020 2020 4841 4e44 4c45 3a20 7368  .     HANDLE: sh
│ │ │ │ +00037e80: 6973 6869 2068 616e 646c 6520 6173 2061  ishi handle as a
│ │ │ │ +00037e90: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ +00037ea0: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ +00037eb0: 0a20 2020 2020 4445 523a 2069 6e70 7574  .     DER: input
│ │ │ │ +00037ec0: 2063 6861 7261 6374 6572 2061 7272 6179   character array
│ │ │ │ +00037ed0: 2077 6974 6820 4445 5220 656e 636f 6469   with DER encodi
│ │ │ │ +00037ee0: 6e67 2e0a 2020 2020 2044 4552 4c45 4e3a  ng..     DERLEN:
│ │ │ │ +00037ef0: 206c 656e 6774 6820 6f66 2069 6e70 7574   length of input
│ │ │ │ +00037f00: 2063 6861 7261 6374 6572 2061 7272 6179   character array
│ │ │ │ +00037f10: 2077 6974 6820 4445 5220 656e 636f 6469   with DER encodi
│ │ │ │ +00037f20: 6e67 2e0a 0a20 2020 2020 2a44 6573 6372  ng...     *Descr
│ │ │ │ +00037f30: 6970 7469 6f6e 3a2a 2044 6563 6f64 6520  iption:* Decode 
│ │ │ │ +00037f40: 4445 5220 656e 636f 6469 6e67 206f 6620  DER encoding of 
│ │ │ │ +00037f50: 4554 5950 452d 494e 464f 3220 616e 6420  ETYPE-INFO2 and 
│ │ │ │ +00037f60: 6372 6561 7465 2061 0a20 2020 2020 4153  create a.     AS
│ │ │ │ +00037f70: 4e2e 3120 7374 7275 6374 7572 652e 0a0a  N.1 structure...
│ │ │ │ +00037f80: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ +00037f90: 7565 3a2a 2052 6574 7572 6e73 2041 534e  ue:* Returns ASN
│ │ │ │ +00037fa0: 2e31 2073 7472 7563 7475 7265 2063 6f72  .1 structure cor
│ │ │ │ +00037fb0: 7265 7370 6f6e 6469 6e67 2074 6f20 4445  responding to DE
│ │ │ │ +00037fc0: 5220 6461 7461 2e0a 0a73 6869 7368 695f  R data...shishi_
│ │ │ │ +00037fd0: 6465 7232 6173 6e31 5f74 6963 6b65 740a  der2asn1_ticket.
│ │ │ │  00037fe0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00037ff0: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ -00038000: 696f 6e3a 2053 6869 7368 695f 6173 6e31  ion: Shishi_asn1
│ │ │ │ -00038010: 2073 6869 7368 695f 6465 7232 6173 6e31   shishi_der2asn1
│ │ │ │ -00038020: 5f74 6963 6b65 7420 2853 6869 7368 6920  _ticket (Shishi 
│ │ │ │ -00038030: 2a20 4841 4e44 4c45 2c0a 2020 2020 2020  * HANDLE,.      
│ │ │ │ -00038040: 2020 2020 636f 6e73 7420 6368 6172 202a      const char *
│ │ │ │ -00038050: 2044 4552 2c20 7369 7a65 5f74 2044 4552   DER, size_t DER
│ │ │ │ -00038060: 4c45 4e29 0a20 2020 2020 4841 4e44 4c45  LEN).     HANDLE
│ │ │ │ -00038070: 3a20 7368 6973 6869 2068 616e 646c 6520  : shishi handle 
│ │ │ │ -00038080: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ -00038090: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ -000380a0: e280 992e 0a20 2020 2020 4445 523a 2069  .....     DER: i
│ │ │ │ -000380b0: 6e70 7574 2063 6861 7261 6374 6572 2061  nput character a
│ │ │ │ -000380c0: 7272 6179 2077 6974 6820 4445 5220 656e  rray with DER en
│ │ │ │ -000380d0: 636f 6469 6e67 2e0a 2020 2020 2044 4552  coding..     DER
│ │ │ │ -000380e0: 4c45 4e3a 206c 656e 6774 6820 6f66 2069  LEN: length of i
│ │ │ │ -000380f0: 6e70 7574 2063 6861 7261 6374 6572 2061  nput character a
│ │ │ │ -00038100: 7272 6179 2077 6974 6820 4445 5220 656e  rray with DER en
│ │ │ │ -00038110: 636f 6469 6e67 2e0a 0a20 2020 2020 2a44  coding...     *D
│ │ │ │ -00038120: 6573 6372 6970 7469 6f6e 3a2a 2044 6563  escription:* Dec
│ │ │ │ -00038130: 6f64 6520 4445 5220 656e 636f 6469 6e67  ode DER encoding
│ │ │ │ -00038140: 206f 6620 5469 636b 6574 2061 6e64 2063   of Ticket and c
│ │ │ │ -00038150: 7265 6174 6520 6120 4153 4e2e 310a 2020  reate a ASN.1.  
│ │ │ │ -00038160: 2020 2073 7472 7563 7475 7265 2e0a 0a20     structure... 
│ │ │ │ -00038170: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ -00038180: 653a 2a20 5265 7475 726e 7320 4153 4e2e  e:* Returns ASN.
│ │ │ │ -00038190: 3120 7374 7275 6374 7572 6520 636f 7272  1 structure corr
│ │ │ │ -000381a0: 6573 706f 6e64 696e 6720 746f 2044 4552  esponding to DER
│ │ │ │ -000381b0: 2064 6174 612e 0a0a 7368 6973 6869 5f64   data...shishi_d
│ │ │ │ -000381c0: 6572 3261 736e 315f 656e 6374 6963 6b65  er2asn1_encticke
│ │ │ │ -000381d0: 7470 6172 740a 2d2d 2d2d 2d2d 2d2d 2d2d  tpart.----------
│ │ │ │ +00037ff0: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ +00038000: 7469 6f6e 3a20 5368 6973 6869 5f61 736e  tion: Shishi_asn
│ │ │ │ +00038010: 3120 7368 6973 6869 5f64 6572 3261 736e  1 shishi_der2asn
│ │ │ │ +00038020: 315f 7469 636b 6574 2028 5368 6973 6869  1_ticket (Shishi
│ │ │ │ +00038030: 202a 2048 414e 444c 452c 0a20 2020 2020   * HANDLE,.     
│ │ │ │ +00038040: 2020 2020 2063 6f6e 7374 2063 6861 7220       const char 
│ │ │ │ +00038050: 2a20 4445 522c 2073 697a 655f 7420 4445  * DER, size_t DE
│ │ │ │ +00038060: 524c 454e 290a 2020 2020 2048 414e 444c  RLEN).     HANDL
│ │ │ │ +00038070: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ +00038080: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ +00038090: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ +000380a0: 29e2 8099 2e0a 2020 2020 2044 4552 3a20  ).....     DER: 
│ │ │ │ +000380b0: 696e 7075 7420 6368 6172 6163 7465 7220  input character 
│ │ │ │ +000380c0: 6172 7261 7920 7769 7468 2044 4552 2065  array with DER e
│ │ │ │ +000380d0: 6e63 6f64 696e 672e 0a20 2020 2020 4445  ncoding..     DE
│ │ │ │ +000380e0: 524c 454e 3a20 6c65 6e67 7468 206f 6620  RLEN: length of 
│ │ │ │ +000380f0: 696e 7075 7420 6368 6172 6163 7465 7220  input character 
│ │ │ │ +00038100: 6172 7261 7920 7769 7468 2044 4552 2065  array with DER e
│ │ │ │ +00038110: 6e63 6f64 696e 672e 0a0a 2020 2020 202a  ncoding...     *
│ │ │ │ +00038120: 4465 7363 7269 7074 696f 6e3a 2a20 4465  Description:* De
│ │ │ │ +00038130: 636f 6465 2044 4552 2065 6e63 6f64 696e  code DER encodin
│ │ │ │ +00038140: 6720 6f66 2054 6963 6b65 7420 616e 6420  g of Ticket and 
│ │ │ │ +00038150: 6372 6561 7465 2061 2041 534e 2e31 0a20  create a ASN.1. 
│ │ │ │ +00038160: 2020 2020 7374 7275 6374 7572 652e 0a0a      structure...
│ │ │ │ +00038170: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ +00038180: 7565 3a2a 2052 6574 7572 6e73 2041 534e  ue:* Returns ASN
│ │ │ │ +00038190: 2e31 2073 7472 7563 7475 7265 2063 6f72  .1 structure cor
│ │ │ │ +000381a0: 7265 7370 6f6e 6469 6e67 2074 6f20 4445  responding to DE
│ │ │ │ +000381b0: 5220 6461 7461 2e0a 0a73 6869 7368 695f  R data...shishi_
│ │ │ │ +000381c0: 6465 7232 6173 6e31 5f65 6e63 7469 636b  der2asn1_enctick
│ │ │ │ +000381d0: 6574 7061 7274 0a2d 2d2d 2d2d 2d2d 2d2d  etpart.---------
│ │ │ │  000381e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000381f0: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ -00038200: 6e3a 2053 6869 7368 695f 6173 6e31 2073  n: Shishi_asn1 s
│ │ │ │ -00038210: 6869 7368 695f 6465 7232 6173 6e31 5f65  hishi_der2asn1_e
│ │ │ │ -00038220: 6e63 7469 636b 6574 7061 7274 0a20 2020  ncticketpart.   
│ │ │ │ -00038230: 2020 2020 2020 2028 5368 6973 6869 202a         (Shishi *
│ │ │ │ -00038240: 2048 414e 444c 452c 2063 6f6e 7374 2063   HANDLE, const c
│ │ │ │ -00038250: 6861 7220 2a20 4445 522c 2073 697a 655f  har * DER, size_
│ │ │ │ -00038260: 7420 4445 524c 454e 290a 2020 2020 2048  t DERLEN).     H
│ │ │ │ -00038270: 414e 444c 453a 2073 6869 7368 6920 6861  ANDLE: shishi ha
│ │ │ │ -00038280: 6e64 6c65 2061 7320 616c 6c6f 6361 7465  ndle as allocate
│ │ │ │ -00038290: 6420 6279 20e2 8098 7368 6973 6869 5f69  d by ...shishi_i
│ │ │ │ -000382a0: 6e69 7428 29e2 8099 2e0a 2020 2020 2044  nit().....     D
│ │ │ │ -000382b0: 4552 3a20 696e 7075 7420 6368 6172 6163  ER: input charac
│ │ │ │ -000382c0: 7465 7220 6172 7261 7920 7769 7468 2044  ter array with D
│ │ │ │ -000382d0: 4552 2065 6e63 6f64 696e 672e 0a20 2020  ER encoding..   
│ │ │ │ -000382e0: 2020 4445 524c 454e 3a20 6c65 6e67 7468    DERLEN: length
│ │ │ │ -000382f0: 206f 6620 696e 7075 7420 6368 6172 6163   of input charac
│ │ │ │ -00038300: 7465 7220 6172 7261 7920 7769 7468 2044  ter array with D
│ │ │ │ -00038310: 4552 2065 6e63 6f64 696e 672e 0a0a 2020  ER encoding...  
│ │ │ │ -00038320: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ -00038330: 2a20 4465 636f 6465 2044 4552 2065 6e63  * Decode DER enc
│ │ │ │ -00038340: 6f64 696e 6720 6f66 2045 6e63 5469 636b  oding of EncTick
│ │ │ │ -00038350: 6574 5061 7274 2061 6e64 2063 7265 6174  etPart and creat
│ │ │ │ -00038360: 6520 610a 2020 2020 2041 534e 2e31 2073  e a.     ASN.1 s
│ │ │ │ -00038370: 7472 7563 7475 7265 2e0a 0a20 2020 2020  tructure...     
│ │ │ │ -00038380: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ -00038390: 5265 7475 726e 7320 4153 4e2e 3120 7374  Returns ASN.1 st
│ │ │ │ -000383a0: 7275 6374 7572 6520 636f 7272 6573 706f  ructure correspo
│ │ │ │ -000383b0: 6e64 696e 6720 746f 2044 4552 2064 6174  nding to DER dat
│ │ │ │ -000383c0: 612e 0a0a 7368 6973 6869 5f64 6572 3261  a...shishi_der2a
│ │ │ │ -000383d0: 736e 315f 6173 7265 710a 2d2d 2d2d 2d2d  sn1_asreq.------
│ │ │ │ -000383e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -000383f0: 0a20 2d2d 2046 756e 6374 696f 6e3a 2053  . -- Function: S
│ │ │ │ -00038400: 6869 7368 695f 6173 6e31 2073 6869 7368  hishi_asn1 shish
│ │ │ │ -00038410: 695f 6465 7232 6173 6e31 5f61 7372 6571  i_der2asn1_asreq
│ │ │ │ -00038420: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ -00038430: 452c 0a20 2020 2020 2020 2020 2063 6f6e  E,.          con
│ │ │ │ -00038440: 7374 2063 6861 7220 2a20 4445 522c 2073  st char * DER, s
│ │ │ │ -00038450: 697a 655f 7420 4445 524c 454e 290a 2020  ize_t DERLEN).  
│ │ │ │ -00038460: 2020 2048 414e 444c 453a 2073 6869 7368     HANDLE: shish
│ │ │ │ -00038470: 6920 6861 6e64 6c65 2061 7320 616c 6c6f  i handle as allo
│ │ │ │ -00038480: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ -00038490: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ -000384a0: 2020 2044 4552 3a20 696e 7075 7420 6368     DER: input ch
│ │ │ │ -000384b0: 6172 6163 7465 7220 6172 7261 7920 7769  aracter array wi
│ │ │ │ -000384c0: 7468 2044 4552 2065 6e63 6f64 696e 672e  th DER encoding.
│ │ │ │ -000384d0: 0a20 2020 2020 4445 524c 454e 3a20 6c65  .     DERLEN: le
│ │ │ │ -000384e0: 6e67 7468 206f 6620 696e 7075 7420 6368  ngth of input ch
│ │ │ │ -000384f0: 6172 6163 7465 7220 6172 7261 7920 7769  aracter array wi
│ │ │ │ -00038500: 7468 2044 4552 2065 6e63 6f64 696e 672e  th DER encoding.
│ │ │ │ -00038510: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ -00038520: 696f 6e3a 2a20 4465 636f 6465 2044 4552  ion:* Decode DER
│ │ │ │ -00038530: 2065 6e63 6f64 696e 6720 6f66 2041 532d   encoding of AS-
│ │ │ │ -00038540: 5245 5120 616e 6420 6372 6561 7465 2061  REQ and create a
│ │ │ │ -00038550: 2041 534e 2e31 0a20 2020 2020 7374 7275   ASN.1.     stru
│ │ │ │ -00038560: 6374 7572 652e 0a0a 2020 2020 202a 5265  cture...     *Re
│ │ │ │ -00038570: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ -00038580: 7572 6e73 2041 534e 2e31 2073 7472 7563  urns ASN.1 struc
│ │ │ │ -00038590: 7475 7265 2063 6f72 7265 7370 6f6e 6469  ture correspondi
│ │ │ │ -000385a0: 6e67 2074 6f20 4445 5220 6461 7461 2e0a  ng to DER data..
│ │ │ │ -000385b0: 0a73 6869 7368 695f 6465 7232 6173 6e31  .shishi_der2asn1
│ │ │ │ -000385c0: 5f74 6773 7265 710a 2d2d 2d2d 2d2d 2d2d  _tgsreq.--------
│ │ │ │ -000385d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -000385e0: 202d 2d20 4675 6e63 7469 6f6e 3a20 5368   -- Function: Sh
│ │ │ │ -000385f0: 6973 6869 5f61 736e 3120 7368 6973 6869  ishi_asn1 shishi
│ │ │ │ -00038600: 5f64 6572 3261 736e 315f 7467 7372 6571  _der2asn1_tgsreq
│ │ │ │ -00038610: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ -00038620: 452c 0a20 2020 2020 2020 2020 2063 6f6e  E,.          con
│ │ │ │ -00038630: 7374 2063 6861 7220 2a20 4445 522c 2073  st char * DER, s
│ │ │ │ -00038640: 697a 655f 7420 4445 524c 454e 290a 2020  ize_t DERLEN).  
│ │ │ │ -00038650: 2020 2048 414e 444c 453a 2073 6869 7368     HANDLE: shish
│ │ │ │ -00038660: 6920 6861 6e64 6c65 2061 7320 616c 6c6f  i handle as allo
│ │ │ │ -00038670: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ -00038680: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ -00038690: 2020 2044 4552 3a20 696e 7075 7420 6368     DER: input ch
│ │ │ │ -000386a0: 6172 6163 7465 7220 6172 7261 7920 7769  aracter array wi
│ │ │ │ -000386b0: 7468 2044 4552 2065 6e63 6f64 696e 672e  th DER encoding.
│ │ │ │ -000386c0: 0a20 2020 2020 4445 524c 454e 3a20 6c65  .     DERLEN: le
│ │ │ │ -000386d0: 6e67 7468 206f 6620 696e 7075 7420 6368  ngth of input ch
│ │ │ │ -000386e0: 6172 6163 7465 7220 6172 7261 7920 7769  aracter array wi
│ │ │ │ -000386f0: 7468 2044 4552 2065 6e63 6f64 696e 672e  th DER encoding.
│ │ │ │ -00038700: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ -00038710: 696f 6e3a 2a20 4465 636f 6465 2044 4552  ion:* Decode DER
│ │ │ │ -00038720: 2065 6e63 6f64 696e 6720 6f66 2054 4753   encoding of TGS
│ │ │ │ -00038730: 2d52 4551 2061 6e64 2063 7265 6174 6520  -REQ and create 
│ │ │ │ -00038740: 6120 4153 4e2e 310a 2020 2020 2073 7472  a ASN.1.     str
│ │ │ │ -00038750: 7563 7475 7265 2e0a 0a20 2020 2020 2a52  ucture...     *R
│ │ │ │ -00038760: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ -00038770: 7475 726e 7320 4153 4e2e 3120 7374 7275  turns ASN.1 stru
│ │ │ │ -00038780: 6374 7572 6520 636f 7272 6573 706f 6e64  cture correspond
│ │ │ │ -00038790: 696e 6720 746f 2044 4552 2064 6174 612e  ing to DER data.
│ │ │ │ -000387a0: 0a0a 7368 6973 6869 5f64 6572 3261 736e  ..shishi_der2asn
│ │ │ │ -000387b0: 315f 6173 7265 700a 2d2d 2d2d 2d2d 2d2d  1_asrep.--------
│ │ │ │ -000387c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -000387d0: 2d2d 2046 756e 6374 696f 6e3a 2053 6869  -- Function: Shi
│ │ │ │ -000387e0: 7368 695f 6173 6e31 2073 6869 7368 695f  shi_asn1 shishi_
│ │ │ │ -000387f0: 6465 7232 6173 6e31 5f61 7372 6570 2028  der2asn1_asrep (
│ │ │ │ -00038800: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ -00038810: 0a20 2020 2020 2020 2020 2063 6f6e 7374  .          const
│ │ │ │ -00038820: 2063 6861 7220 2a20 4445 522c 2073 697a   char * DER, siz
│ │ │ │ -00038830: 655f 7420 4445 524c 454e 290a 2020 2020  e_t DERLEN).    
│ │ │ │ -00038840: 2048 414e 444c 453a 2073 6869 7368 6920   HANDLE: shishi 
│ │ │ │ -00038850: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ -00038860: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ -00038870: 5f69 6e69 7428 29e2 8099 2e0a 2020 2020  _init().....    
│ │ │ │ -00038880: 2044 4552 3a20 696e 7075 7420 6368 6172   DER: input char
│ │ │ │ -00038890: 6163 7465 7220 6172 7261 7920 7769 7468  acter array with
│ │ │ │ -000388a0: 2044 4552 2065 6e63 6f64 696e 672e 0a20   DER encoding.. 
│ │ │ │ -000388b0: 2020 2020 4445 524c 454e 3a20 6c65 6e67      DERLEN: leng
│ │ │ │ -000388c0: 7468 206f 6620 696e 7075 7420 6368 6172  th of input char
│ │ │ │ -000388d0: 6163 7465 7220 6172 7261 7920 7769 7468  acter array with
│ │ │ │ -000388e0: 2044 4552 2065 6e63 6f64 696e 672e 0a0a   DER encoding...
│ │ │ │ -000388f0: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ -00038900: 6e3a 2a20 4465 636f 6465 2044 4552 2065  n:* Decode DER e
│ │ │ │ -00038910: 6e63 6f64 696e 6720 6f66 2041 532d 5245  ncoding of AS-RE
│ │ │ │ -00038920: 5020 616e 6420 6372 6561 7465 2061 2041  P and create a A
│ │ │ │ -00038930: 534e 2e31 0a20 2020 2020 7374 7275 6374  SN.1.     struct
│ │ │ │ -00038940: 7572 652e 0a0a 2020 2020 202a 5265 7475  ure...     *Retu
│ │ │ │ -00038950: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ -00038960: 6e73 2041 534e 2e31 2073 7472 7563 7475  ns ASN.1 structu
│ │ │ │ -00038970: 7265 2063 6f72 7265 7370 6f6e 6469 6e67  re corresponding
│ │ │ │ -00038980: 2074 6f20 4445 5220 6461 7461 2e0a 0a73   to DER data...s
│ │ │ │ -00038990: 6869 7368 695f 6465 7232 6173 6e31 5f74  hishi_der2asn1_t
│ │ │ │ -000389a0: 6773 7265 700a 2d2d 2d2d 2d2d 2d2d 2d2d  gsrep.----------
│ │ │ │ -000389b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ -000389c0: 2d20 4675 6e63 7469 6f6e 3a20 5368 6973  - Function: Shis
│ │ │ │ -000389d0: 6869 5f61 736e 3120 7368 6973 6869 5f64  hi_asn1 shishi_d
│ │ │ │ -000389e0: 6572 3261 736e 315f 7467 7372 6570 2028  er2asn1_tgsrep (
│ │ │ │ -000389f0: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ -00038a00: 0a20 2020 2020 2020 2020 2063 6f6e 7374  .          const
│ │ │ │ -00038a10: 2063 6861 7220 2a20 4445 522c 2073 697a   char * DER, siz
│ │ │ │ -00038a20: 655f 7420 4445 524c 454e 290a 2020 2020  e_t DERLEN).    
│ │ │ │ -00038a30: 2048 414e 444c 453a 2073 6869 7368 6920   HANDLE: shishi 
│ │ │ │ -00038a40: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ -00038a50: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ -00038a60: 5f69 6e69 7428 29e2 8099 2e0a 2020 2020  _init().....    
│ │ │ │ -00038a70: 2044 4552 3a20 696e 7075 7420 6368 6172   DER: input char
│ │ │ │ -00038a80: 6163 7465 7220 6172 7261 7920 7769 7468  acter array with
│ │ │ │ -00038a90: 2044 4552 2065 6e63 6f64 696e 672e 0a20   DER encoding.. 
│ │ │ │ -00038aa0: 2020 2020 4445 524c 454e 3a20 6c65 6e67      DERLEN: leng
│ │ │ │ -00038ab0: 7468 206f 6620 696e 7075 7420 6368 6172  th of input char
│ │ │ │ -00038ac0: 6163 7465 7220 6172 7261 7920 7769 7468  acter array with
│ │ │ │ -00038ad0: 2044 4552 2065 6e63 6f64 696e 672e 0a0a   DER encoding...
│ │ │ │ -00038ae0: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ -00038af0: 6e3a 2a20 4465 636f 6465 2044 4552 2065  n:* Decode DER e
│ │ │ │ -00038b00: 6e63 6f64 696e 6720 6f66 2054 4753 2d52  ncoding of TGS-R
│ │ │ │ -00038b10: 4550 2061 6e64 2063 7265 6174 6520 6120  EP and create a 
│ │ │ │ -00038b20: 4153 4e2e 310a 2020 2020 2073 7472 7563  ASN.1.     struc
│ │ │ │ -00038b30: 7475 7265 2e0a 0a20 2020 2020 2a52 6574  ture...     *Ret
│ │ │ │ -00038b40: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ -00038b50: 726e 7320 4153 4e2e 3120 7374 7275 6374  rns ASN.1 struct
│ │ │ │ -00038b60: 7572 6520 636f 7272 6573 706f 6e64 696e  ure correspondin
│ │ │ │ -00038b70: 6720 746f 2044 4552 2064 6174 612e 0a0a  g to DER data...
│ │ │ │ -00038b80: 7368 6973 6869 5f64 6572 3261 736e 315f  shishi_der2asn1_
│ │ │ │ -00038b90: 6b64 6372 6570 0a2d 2d2d 2d2d 2d2d 2d2d  kdcrep.---------
│ │ │ │ -00038ba0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -00038bb0: 2d2d 2046 756e 6374 696f 6e3a 2053 6869  -- Function: Shi
│ │ │ │ -00038bc0: 7368 695f 6173 6e31 2073 6869 7368 695f  shi_asn1 shishi_
│ │ │ │ -00038bd0: 6465 7232 6173 6e31 5f6b 6463 7265 7020  der2asn1_kdcrep 
│ │ │ │ -00038be0: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ -00038bf0: 2c0a 2020 2020 2020 2020 2020 636f 6e73  ,.          cons
│ │ │ │ -00038c00: 7420 6368 6172 202a 2044 4552 2c20 7369  t char * DER, si
│ │ │ │ -00038c10: 7a65 5f74 2044 4552 4c45 4e29 0a20 2020  ze_t DERLEN).   
│ │ │ │ -00038c20: 2020 4841 4e44 4c45 3a20 7368 6973 6869    HANDLE: shishi
│ │ │ │ -00038c30: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ -00038c40: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ -00038c50: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ -00038c60: 2020 4445 523a 2069 6e70 7574 2063 6861    DER: input cha
│ │ │ │ -00038c70: 7261 6374 6572 2061 7272 6179 2077 6974  racter array wit
│ │ │ │ -00038c80: 6820 4445 5220 656e 636f 6469 6e67 2e0a  h DER encoding..
│ │ │ │ -00038c90: 2020 2020 2044 4552 4c45 4e3a 206c 656e       DERLEN: len
│ │ │ │ -00038ca0: 6774 6820 6f66 2069 6e70 7574 2063 6861  gth of input cha
│ │ │ │ -00038cb0: 7261 6374 6572 2061 7272 6179 2077 6974  racter array wit
│ │ │ │ -00038cc0: 6820 4445 5220 656e 636f 6469 6e67 2e0a  h DER encoding..
│ │ │ │ -00038cd0: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -00038ce0: 6f6e 3a2a 2044 6563 6f64 6520 4445 5220  on:* Decode DER 
│ │ │ │ -00038cf0: 656e 636f 6469 6e67 206f 6620 4b44 432d  encoding of KDC-
│ │ │ │ -00038d00: 5245 5020 616e 6420 6372 6561 7465 2061  REP and create a
│ │ │ │ -00038d10: 2041 534e 2e31 0a20 2020 2020 7374 7275   ASN.1.     stru
│ │ │ │ -00038d20: 6374 7572 652e 0a0a 2020 2020 202a 5265  cture...     *Re
│ │ │ │ -00038d30: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ -00038d40: 7572 6e73 2041 534e 2e31 2073 7472 7563  urns ASN.1 struc
│ │ │ │ -00038d50: 7475 7265 2063 6f72 7265 7370 6f6e 6469  ture correspondi
│ │ │ │ -00038d60: 6e67 2074 6f20 4445 5220 6461 7461 2e0a  ng to DER data..
│ │ │ │ -00038d70: 0a73 6869 7368 695f 6465 7232 6173 6e31  .shishi_der2asn1
│ │ │ │ -00038d80: 5f65 6e63 6173 7265 7070 6172 740a 2d2d  _encasreppart.--
│ │ │ │ +000381f0: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ +00038200: 6f6e 3a20 5368 6973 6869 5f61 736e 3120  on: Shishi_asn1 
│ │ │ │ +00038210: 7368 6973 6869 5f64 6572 3261 736e 315f  shishi_der2asn1_
│ │ │ │ +00038220: 656e 6374 6963 6b65 7470 6172 740a 2020  encticketpart.  
│ │ │ │ +00038230: 2020 2020 2020 2020 2853 6869 7368 6920          (Shishi 
│ │ │ │ +00038240: 2a20 4841 4e44 4c45 2c20 636f 6e73 7420  * HANDLE, const 
│ │ │ │ +00038250: 6368 6172 202a 2044 4552 2c20 7369 7a65  char * DER, size
│ │ │ │ +00038260: 5f74 2044 4552 4c45 4e29 0a20 2020 2020  _t DERLEN).     
│ │ │ │ +00038270: 4841 4e44 4c45 3a20 7368 6973 6869 2068  HANDLE: shishi h
│ │ │ │ +00038280: 616e 646c 6520 6173 2061 6c6c 6f63 6174  andle as allocat
│ │ │ │ +00038290: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ +000382a0: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ +000382b0: 4445 523a 2069 6e70 7574 2063 6861 7261  DER: input chara
│ │ │ │ +000382c0: 6374 6572 2061 7272 6179 2077 6974 6820  cter array with 
│ │ │ │ +000382d0: 4445 5220 656e 636f 6469 6e67 2e0a 2020  DER encoding..  
│ │ │ │ +000382e0: 2020 2044 4552 4c45 4e3a 206c 656e 6774     DERLEN: lengt
│ │ │ │ +000382f0: 6820 6f66 2069 6e70 7574 2063 6861 7261  h of input chara
│ │ │ │ +00038300: 6374 6572 2061 7272 6179 2077 6974 6820  cter array with 
│ │ │ │ +00038310: 4445 5220 656e 636f 6469 6e67 2e0a 0a20  DER encoding... 
│ │ │ │ +00038320: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ +00038330: 3a2a 2044 6563 6f64 6520 4445 5220 656e  :* Decode DER en
│ │ │ │ +00038340: 636f 6469 6e67 206f 6620 456e 6354 6963  coding of EncTic
│ │ │ │ +00038350: 6b65 7450 6172 7420 616e 6420 6372 6561  ketPart and crea
│ │ │ │ +00038360: 7465 2061 0a20 2020 2020 4153 4e2e 3120  te a.     ASN.1 
│ │ │ │ +00038370: 7374 7275 6374 7572 652e 0a0a 2020 2020  structure...    
│ │ │ │ +00038380: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ +00038390: 2052 6574 7572 6e73 2041 534e 2e31 2073   Returns ASN.1 s
│ │ │ │ +000383a0: 7472 7563 7475 7265 2063 6f72 7265 7370  tructure corresp
│ │ │ │ +000383b0: 6f6e 6469 6e67 2074 6f20 4445 5220 6461  onding to DER da
│ │ │ │ +000383c0: 7461 2e0a 0a73 6869 7368 695f 6465 7232  ta...shishi_der2
│ │ │ │ +000383d0: 6173 6e31 5f61 7372 6571 0a2d 2d2d 2d2d  asn1_asreq.-----
│ │ │ │ +000383e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +000383f0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +00038400: 5368 6973 6869 5f61 736e 3120 7368 6973  Shishi_asn1 shis
│ │ │ │ +00038410: 6869 5f64 6572 3261 736e 315f 6173 7265  hi_der2asn1_asre
│ │ │ │ +00038420: 7120 2853 6869 7368 6920 2a20 4841 4e44  q (Shishi * HAND
│ │ │ │ +00038430: 4c45 2c0a 2020 2020 2020 2020 2020 636f  LE,.          co
│ │ │ │ +00038440: 6e73 7420 6368 6172 202a 2044 4552 2c20  nst char * DER, 
│ │ │ │ +00038450: 7369 7a65 5f74 2044 4552 4c45 4e29 0a20  size_t DERLEN). 
│ │ │ │ +00038460: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ +00038470: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ +00038480: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ +00038490: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ +000384a0: 2020 2020 4445 523a 2069 6e70 7574 2063      DER: input c
│ │ │ │ +000384b0: 6861 7261 6374 6572 2061 7272 6179 2077  haracter array w
│ │ │ │ +000384c0: 6974 6820 4445 5220 656e 636f 6469 6e67  ith DER encoding
│ │ │ │ +000384d0: 2e0a 2020 2020 2044 4552 4c45 4e3a 206c  ..     DERLEN: l
│ │ │ │ +000384e0: 656e 6774 6820 6f66 2069 6e70 7574 2063  ength of input c
│ │ │ │ +000384f0: 6861 7261 6374 6572 2061 7272 6179 2077  haracter array w
│ │ │ │ +00038500: 6974 6820 4445 5220 656e 636f 6469 6e67  ith DER encoding
│ │ │ │ +00038510: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ +00038520: 7469 6f6e 3a2a 2044 6563 6f64 6520 4445  tion:* Decode DE
│ │ │ │ +00038530: 5220 656e 636f 6469 6e67 206f 6620 4153  R encoding of AS
│ │ │ │ +00038540: 2d52 4551 2061 6e64 2063 7265 6174 6520  -REQ and create 
│ │ │ │ +00038550: 6120 4153 4e2e 310a 2020 2020 2073 7472  a ASN.1.     str
│ │ │ │ +00038560: 7563 7475 7265 2e0a 0a20 2020 2020 2a52  ucture...     *R
│ │ │ │ +00038570: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +00038580: 7475 726e 7320 4153 4e2e 3120 7374 7275  turns ASN.1 stru
│ │ │ │ +00038590: 6374 7572 6520 636f 7272 6573 706f 6e64  cture correspond
│ │ │ │ +000385a0: 696e 6720 746f 2044 4552 2064 6174 612e  ing to DER data.
│ │ │ │ +000385b0: 0a0a 7368 6973 6869 5f64 6572 3261 736e  ..shishi_der2asn
│ │ │ │ +000385c0: 315f 7467 7372 6571 0a2d 2d2d 2d2d 2d2d  1_tgsreq.-------
│ │ │ │ +000385d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +000385e0: 0a20 2d2d 2046 756e 6374 696f 6e3a 2053  . -- Function: S
│ │ │ │ +000385f0: 6869 7368 695f 6173 6e31 2073 6869 7368  hishi_asn1 shish
│ │ │ │ +00038600: 695f 6465 7232 6173 6e31 5f74 6773 7265  i_der2asn1_tgsre
│ │ │ │ +00038610: 7120 2853 6869 7368 6920 2a20 4841 4e44  q (Shishi * HAND
│ │ │ │ +00038620: 4c45 2c0a 2020 2020 2020 2020 2020 636f  LE,.          co
│ │ │ │ +00038630: 6e73 7420 6368 6172 202a 2044 4552 2c20  nst char * DER, 
│ │ │ │ +00038640: 7369 7a65 5f74 2044 4552 4c45 4e29 0a20  size_t DERLEN). 
│ │ │ │ +00038650: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ +00038660: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ +00038670: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ +00038680: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ +00038690: 2020 2020 4445 523a 2069 6e70 7574 2063      DER: input c
│ │ │ │ +000386a0: 6861 7261 6374 6572 2061 7272 6179 2077  haracter array w
│ │ │ │ +000386b0: 6974 6820 4445 5220 656e 636f 6469 6e67  ith DER encoding
│ │ │ │ +000386c0: 2e0a 2020 2020 2044 4552 4c45 4e3a 206c  ..     DERLEN: l
│ │ │ │ +000386d0: 656e 6774 6820 6f66 2069 6e70 7574 2063  ength of input c
│ │ │ │ +000386e0: 6861 7261 6374 6572 2061 7272 6179 2077  haracter array w
│ │ │ │ +000386f0: 6974 6820 4445 5220 656e 636f 6469 6e67  ith DER encoding
│ │ │ │ +00038700: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ +00038710: 7469 6f6e 3a2a 2044 6563 6f64 6520 4445  tion:* Decode DE
│ │ │ │ +00038720: 5220 656e 636f 6469 6e67 206f 6620 5447  R encoding of TG
│ │ │ │ +00038730: 532d 5245 5120 616e 6420 6372 6561 7465  S-REQ and create
│ │ │ │ +00038740: 2061 2041 534e 2e31 0a20 2020 2020 7374   a ASN.1.     st
│ │ │ │ +00038750: 7275 6374 7572 652e 0a0a 2020 2020 202a  ructure...     *
│ │ │ │ +00038760: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ +00038770: 6574 7572 6e73 2041 534e 2e31 2073 7472  eturns ASN.1 str
│ │ │ │ +00038780: 7563 7475 7265 2063 6f72 7265 7370 6f6e  ucture correspon
│ │ │ │ +00038790: 6469 6e67 2074 6f20 4445 5220 6461 7461  ding to DER data
│ │ │ │ +000387a0: 2e0a 0a73 6869 7368 695f 6465 7232 6173  ...shishi_der2as
│ │ │ │ +000387b0: 6e31 5f61 7372 6570 0a2d 2d2d 2d2d 2d2d  n1_asrep.-------
│ │ │ │ +000387c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ +000387d0: 202d 2d20 4675 6e63 7469 6f6e 3a20 5368   -- Function: Sh
│ │ │ │ +000387e0: 6973 6869 5f61 736e 3120 7368 6973 6869  ishi_asn1 shishi
│ │ │ │ +000387f0: 5f64 6572 3261 736e 315f 6173 7265 7020  _der2asn1_asrep 
│ │ │ │ +00038800: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ +00038810: 2c0a 2020 2020 2020 2020 2020 636f 6e73  ,.          cons
│ │ │ │ +00038820: 7420 6368 6172 202a 2044 4552 2c20 7369  t char * DER, si
│ │ │ │ +00038830: 7a65 5f74 2044 4552 4c45 4e29 0a20 2020  ze_t DERLEN).   
│ │ │ │ +00038840: 2020 4841 4e44 4c45 3a20 7368 6973 6869    HANDLE: shishi
│ │ │ │ +00038850: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ +00038860: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ +00038870: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ +00038880: 2020 4445 523a 2069 6e70 7574 2063 6861    DER: input cha
│ │ │ │ +00038890: 7261 6374 6572 2061 7272 6179 2077 6974  racter array wit
│ │ │ │ +000388a0: 6820 4445 5220 656e 636f 6469 6e67 2e0a  h DER encoding..
│ │ │ │ +000388b0: 2020 2020 2044 4552 4c45 4e3a 206c 656e       DERLEN: len
│ │ │ │ +000388c0: 6774 6820 6f66 2069 6e70 7574 2063 6861  gth of input cha
│ │ │ │ +000388d0: 7261 6374 6572 2061 7272 6179 2077 6974  racter array wit
│ │ │ │ +000388e0: 6820 4445 5220 656e 636f 6469 6e67 2e0a  h DER encoding..
│ │ │ │ +000388f0: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +00038900: 6f6e 3a2a 2044 6563 6f64 6520 4445 5220  on:* Decode DER 
│ │ │ │ +00038910: 656e 636f 6469 6e67 206f 6620 4153 2d52  encoding of AS-R
│ │ │ │ +00038920: 4550 2061 6e64 2063 7265 6174 6520 6120  EP and create a 
│ │ │ │ +00038930: 4153 4e2e 310a 2020 2020 2073 7472 7563  ASN.1.     struc
│ │ │ │ +00038940: 7475 7265 2e0a 0a20 2020 2020 2a52 6574  ture...     *Ret
│ │ │ │ +00038950: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ +00038960: 726e 7320 4153 4e2e 3120 7374 7275 6374  rns ASN.1 struct
│ │ │ │ +00038970: 7572 6520 636f 7272 6573 706f 6e64 696e  ure correspondin
│ │ │ │ +00038980: 6720 746f 2044 4552 2064 6174 612e 0a0a  g to DER data...
│ │ │ │ +00038990: 7368 6973 6869 5f64 6572 3261 736e 315f  shishi_der2asn1_
│ │ │ │ +000389a0: 7467 7372 6570 0a2d 2d2d 2d2d 2d2d 2d2d  tgsrep.---------
│ │ │ │ +000389b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ +000389c0: 2d2d 2046 756e 6374 696f 6e3a 2053 6869  -- Function: Shi
│ │ │ │ +000389d0: 7368 695f 6173 6e31 2073 6869 7368 695f  shi_asn1 shishi_
│ │ │ │ +000389e0: 6465 7232 6173 6e31 5f74 6773 7265 7020  der2asn1_tgsrep 
│ │ │ │ +000389f0: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ +00038a00: 2c0a 2020 2020 2020 2020 2020 636f 6e73  ,.          cons
│ │ │ │ +00038a10: 7420 6368 6172 202a 2044 4552 2c20 7369  t char * DER, si
│ │ │ │ +00038a20: 7a65 5f74 2044 4552 4c45 4e29 0a20 2020  ze_t DERLEN).   
│ │ │ │ +00038a30: 2020 4841 4e44 4c45 3a20 7368 6973 6869    HANDLE: shishi
│ │ │ │ +00038a40: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ +00038a50: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ +00038a60: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ +00038a70: 2020 4445 523a 2069 6e70 7574 2063 6861    DER: input cha
│ │ │ │ +00038a80: 7261 6374 6572 2061 7272 6179 2077 6974  racter array wit
│ │ │ │ +00038a90: 6820 4445 5220 656e 636f 6469 6e67 2e0a  h DER encoding..
│ │ │ │ +00038aa0: 2020 2020 2044 4552 4c45 4e3a 206c 656e       DERLEN: len
│ │ │ │ +00038ab0: 6774 6820 6f66 2069 6e70 7574 2063 6861  gth of input cha
│ │ │ │ +00038ac0: 7261 6374 6572 2061 7272 6179 2077 6974  racter array wit
│ │ │ │ +00038ad0: 6820 4445 5220 656e 636f 6469 6e67 2e0a  h DER encoding..
│ │ │ │ +00038ae0: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +00038af0: 6f6e 3a2a 2044 6563 6f64 6520 4445 5220  on:* Decode DER 
│ │ │ │ +00038b00: 656e 636f 6469 6e67 206f 6620 5447 532d  encoding of TGS-
│ │ │ │ +00038b10: 5245 5020 616e 6420 6372 6561 7465 2061  REP and create a
│ │ │ │ +00038b20: 2041 534e 2e31 0a20 2020 2020 7374 7275   ASN.1.     stru
│ │ │ │ +00038b30: 6374 7572 652e 0a0a 2020 2020 202a 5265  cture...     *Re
│ │ │ │ +00038b40: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ +00038b50: 7572 6e73 2041 534e 2e31 2073 7472 7563  urns ASN.1 struc
│ │ │ │ +00038b60: 7475 7265 2063 6f72 7265 7370 6f6e 6469  ture correspondi
│ │ │ │ +00038b70: 6e67 2074 6f20 4445 5220 6461 7461 2e0a  ng to DER data..
│ │ │ │ +00038b80: 0a73 6869 7368 695f 6465 7232 6173 6e31  .shishi_der2asn1
│ │ │ │ +00038b90: 5f6b 6463 7265 700a 2d2d 2d2d 2d2d 2d2d  _kdcrep.--------
│ │ │ │ +00038ba0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ +00038bb0: 202d 2d20 4675 6e63 7469 6f6e 3a20 5368   -- Function: Sh
│ │ │ │ +00038bc0: 6973 6869 5f61 736e 3120 7368 6973 6869  ishi_asn1 shishi
│ │ │ │ +00038bd0: 5f64 6572 3261 736e 315f 6b64 6372 6570  _der2asn1_kdcrep
│ │ │ │ +00038be0: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ +00038bf0: 452c 0a20 2020 2020 2020 2020 2063 6f6e  E,.          con
│ │ │ │ +00038c00: 7374 2063 6861 7220 2a20 4445 522c 2073  st char * DER, s
│ │ │ │ +00038c10: 697a 655f 7420 4445 524c 454e 290a 2020  ize_t DERLEN).  
│ │ │ │ +00038c20: 2020 2048 414e 444c 453a 2073 6869 7368     HANDLE: shish
│ │ │ │ +00038c30: 6920 6861 6e64 6c65 2061 7320 616c 6c6f  i handle as allo
│ │ │ │ +00038c40: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ +00038c50: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ +00038c60: 2020 2044 4552 3a20 696e 7075 7420 6368     DER: input ch
│ │ │ │ +00038c70: 6172 6163 7465 7220 6172 7261 7920 7769  aracter array wi
│ │ │ │ +00038c80: 7468 2044 4552 2065 6e63 6f64 696e 672e  th DER encoding.
│ │ │ │ +00038c90: 0a20 2020 2020 4445 524c 454e 3a20 6c65  .     DERLEN: le
│ │ │ │ +00038ca0: 6e67 7468 206f 6620 696e 7075 7420 6368  ngth of input ch
│ │ │ │ +00038cb0: 6172 6163 7465 7220 6172 7261 7920 7769  aracter array wi
│ │ │ │ +00038cc0: 7468 2044 4552 2065 6e63 6f64 696e 672e  th DER encoding.
│ │ │ │ +00038cd0: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ +00038ce0: 696f 6e3a 2a20 4465 636f 6465 2044 4552  ion:* Decode DER
│ │ │ │ +00038cf0: 2065 6e63 6f64 696e 6720 6f66 204b 4443   encoding of KDC
│ │ │ │ +00038d00: 2d52 4550 2061 6e64 2063 7265 6174 6520  -REP and create 
│ │ │ │ +00038d10: 6120 4153 4e2e 310a 2020 2020 2073 7472  a ASN.1.     str
│ │ │ │ +00038d20: 7563 7475 7265 2e0a 0a20 2020 2020 2a52  ucture...     *R
│ │ │ │ +00038d30: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +00038d40: 7475 726e 7320 4153 4e2e 3120 7374 7275  turns ASN.1 stru
│ │ │ │ +00038d50: 6374 7572 6520 636f 7272 6573 706f 6e64  cture correspond
│ │ │ │ +00038d60: 696e 6720 746f 2044 4552 2064 6174 612e  ing to DER data.
│ │ │ │ +00038d70: 0a0a 7368 6973 6869 5f64 6572 3261 736e  ..shishi_der2asn
│ │ │ │ +00038d80: 315f 656e 6361 7372 6570 7061 7274 0a2d  1_encasreppart.-
│ │ │ │  00038d90: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00038da0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ -00038db0: 4675 6e63 7469 6f6e 3a20 5368 6973 6869  Function: Shishi
│ │ │ │ -00038dc0: 5f61 736e 3120 7368 6973 6869 5f64 6572  _asn1 shishi_der
│ │ │ │ -00038dd0: 3261 736e 315f 656e 6361 7372 6570 7061  2asn1_encasreppa
│ │ │ │ -00038de0: 7274 2028 5368 6973 6869 202a 2048 414e  rt (Shishi * HAN
│ │ │ │ -00038df0: 444c 452c 0a20 2020 2020 2020 2020 2063  DLE,.          c
│ │ │ │ -00038e00: 6f6e 7374 2063 6861 7220 2a20 4445 522c  onst char * DER,
│ │ │ │ -00038e10: 2073 697a 655f 7420 4445 524c 454e 290a   size_t DERLEN).
│ │ │ │ -00038e20: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ -00038e30: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ -00038e40: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ -00038e50: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ -00038e60: 2020 2020 2044 4552 3a20 696e 7075 7420       DER: input 
│ │ │ │ -00038e70: 6368 6172 6163 7465 7220 6172 7261 7920  character array 
│ │ │ │ -00038e80: 7769 7468 2044 4552 2065 6e63 6f64 696e  with DER encodin
│ │ │ │ -00038e90: 672e 0a20 2020 2020 4445 524c 454e 3a20  g..     DERLEN: 
│ │ │ │ -00038ea0: 6c65 6e67 7468 206f 6620 696e 7075 7420  length of input 
│ │ │ │ -00038eb0: 6368 6172 6163 7465 7220 6172 7261 7920  character array 
│ │ │ │ -00038ec0: 7769 7468 2044 4552 2065 6e63 6f64 696e  with DER encodin
│ │ │ │ -00038ed0: 672e 0a0a 2020 2020 202a 4465 7363 7269  g...     *Descri
│ │ │ │ -00038ee0: 7074 696f 6e3a 2a20 4465 636f 6465 2044  ption:* Decode D
│ │ │ │ -00038ef0: 4552 2065 6e63 6f64 696e 6720 6f66 2045  ER encoding of E
│ │ │ │ -00038f00: 6e63 4153 5265 7050 6172 7420 616e 6420  ncASRepPart and 
│ │ │ │ -00038f10: 6372 6561 7465 2061 0a20 2020 2020 4153  create a.     AS
│ │ │ │ -00038f20: 4e2e 3120 7374 7275 6374 7572 652e 0a0a  N.1 structure...
│ │ │ │ -00038f30: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ -00038f40: 7565 3a2a 2052 6574 7572 6e73 2041 534e  ue:* Returns ASN
│ │ │ │ -00038f50: 2e31 2073 7472 7563 7475 7265 2063 6f72  .1 structure cor
│ │ │ │ -00038f60: 7265 7370 6f6e 6469 6e67 2074 6f20 4445  responding to DE
│ │ │ │ -00038f70: 5220 6461 7461 2e0a 0a73 6869 7368 695f  R data...shishi_
│ │ │ │ -00038f80: 6465 7232 6173 6e31 5f65 6e63 7467 7372  der2asn1_enctgsr
│ │ │ │ -00038f90: 6570 7061 7274 0a2d 2d2d 2d2d 2d2d 2d2d  eppart.---------
│ │ │ │ +00038da0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ +00038db0: 2046 756e 6374 696f 6e3a 2053 6869 7368   Function: Shish
│ │ │ │ +00038dc0: 695f 6173 6e31 2073 6869 7368 695f 6465  i_asn1 shishi_de
│ │ │ │ +00038dd0: 7232 6173 6e31 5f65 6e63 6173 7265 7070  r2asn1_encasrepp
│ │ │ │ +00038de0: 6172 7420 2853 6869 7368 6920 2a20 4841  art (Shishi * HA
│ │ │ │ +00038df0: 4e44 4c45 2c0a 2020 2020 2020 2020 2020  NDLE,.          
│ │ │ │ +00038e00: 636f 6e73 7420 6368 6172 202a 2044 4552  const char * DER
│ │ │ │ +00038e10: 2c20 7369 7a65 5f74 2044 4552 4c45 4e29  , size_t DERLEN)
│ │ │ │ +00038e20: 0a20 2020 2020 4841 4e44 4c45 3a20 7368  .     HANDLE: sh
│ │ │ │ +00038e30: 6973 6869 2068 616e 646c 6520 6173 2061  ishi handle as a
│ │ │ │ +00038e40: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ +00038e50: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ +00038e60: 0a20 2020 2020 4445 523a 2069 6e70 7574  .     DER: input
│ │ │ │ +00038e70: 2063 6861 7261 6374 6572 2061 7272 6179   character array
│ │ │ │ +00038e80: 2077 6974 6820 4445 5220 656e 636f 6469   with DER encodi
│ │ │ │ +00038e90: 6e67 2e0a 2020 2020 2044 4552 4c45 4e3a  ng..     DERLEN:
│ │ │ │ +00038ea0: 206c 656e 6774 6820 6f66 2069 6e70 7574   length of input
│ │ │ │ +00038eb0: 2063 6861 7261 6374 6572 2061 7272 6179   character array
│ │ │ │ +00038ec0: 2077 6974 6820 4445 5220 656e 636f 6469   with DER encodi
│ │ │ │ +00038ed0: 6e67 2e0a 0a20 2020 2020 2a44 6573 6372  ng...     *Descr
│ │ │ │ +00038ee0: 6970 7469 6f6e 3a2a 2044 6563 6f64 6520  iption:* Decode 
│ │ │ │ +00038ef0: 4445 5220 656e 636f 6469 6e67 206f 6620  DER encoding of 
│ │ │ │ +00038f00: 456e 6341 5352 6570 5061 7274 2061 6e64  EncASRepPart and
│ │ │ │ +00038f10: 2063 7265 6174 6520 610a 2020 2020 2041   create a.     A
│ │ │ │ +00038f20: 534e 2e31 2073 7472 7563 7475 7265 2e0a  SN.1 structure..
│ │ │ │ +00038f30: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ +00038f40: 6c75 653a 2a20 5265 7475 726e 7320 4153  lue:* Returns AS
│ │ │ │ +00038f50: 4e2e 3120 7374 7275 6374 7572 6520 636f  N.1 structure co
│ │ │ │ +00038f60: 7272 6573 706f 6e64 696e 6720 746f 2044  rresponding to D
│ │ │ │ +00038f70: 4552 2064 6174 612e 0a0a 7368 6973 6869  ER data...shishi
│ │ │ │ +00038f80: 5f64 6572 3261 736e 315f 656e 6374 6773  _der2asn1_enctgs
│ │ │ │ +00038f90: 7265 7070 6172 740a 2d2d 2d2d 2d2d 2d2d  reppart.--------
│ │ │ │  00038fa0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00038fb0: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -00038fc0: 6f6e 3a20 5368 6973 6869 5f61 736e 3120  on: Shishi_asn1 
│ │ │ │ -00038fd0: 7368 6973 6869 5f64 6572 3261 736e 315f  shishi_der2asn1_
│ │ │ │ -00038fe0: 656e 6374 6773 7265 7070 6172 740a 2020  enctgsreppart.  
│ │ │ │ -00038ff0: 2020 2020 2020 2020 2853 6869 7368 6920          (Shishi 
│ │ │ │ -00039000: 2a20 4841 4e44 4c45 2c20 636f 6e73 7420  * HANDLE, const 
│ │ │ │ -00039010: 6368 6172 202a 2044 4552 2c20 7369 7a65  char * DER, size
│ │ │ │ -00039020: 5f74 2044 4552 4c45 4e29 0a20 2020 2020  _t DERLEN).     
│ │ │ │ -00039030: 4841 4e44 4c45 3a20 7368 6973 6869 2068  HANDLE: shishi h
│ │ │ │ -00039040: 616e 646c 6520 6173 2061 6c6c 6f63 6174  andle as allocat
│ │ │ │ -00039050: 6564 2062 7920 e280 9873 6869 7368 695f  ed by ...shishi_
│ │ │ │ -00039060: 696e 6974 2829 e280 992e 0a20 2020 2020  init().....     
│ │ │ │ -00039070: 4445 523a 2069 6e70 7574 2063 6861 7261  DER: input chara
│ │ │ │ -00039080: 6374 6572 2061 7272 6179 2077 6974 6820  cter array with 
│ │ │ │ -00039090: 4445 5220 656e 636f 6469 6e67 2e0a 2020  DER encoding..  
│ │ │ │ -000390a0: 2020 2044 4552 4c45 4e3a 206c 656e 6774     DERLEN: lengt
│ │ │ │ -000390b0: 6820 6f66 2069 6e70 7574 2063 6861 7261  h of input chara
│ │ │ │ -000390c0: 6374 6572 2061 7272 6179 2077 6974 6820  cter array with 
│ │ │ │ -000390d0: 4445 5220 656e 636f 6469 6e67 2e0a 0a20  DER encoding... 
│ │ │ │ -000390e0: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -000390f0: 3a2a 2044 6563 6f64 6520 4445 5220 656e  :* Decode DER en
│ │ │ │ -00039100: 636f 6469 6e67 206f 6620 456e 6354 4753  coding of EncTGS
│ │ │ │ -00039110: 5265 7050 6172 7420 616e 6420 6372 6561  RepPart and crea
│ │ │ │ -00039120: 7465 2061 0a20 2020 2020 4153 4e2e 3120  te a.     ASN.1 
│ │ │ │ -00039130: 7374 7275 6374 7572 652e 0a0a 2020 2020  structure...    
│ │ │ │ -00039140: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ -00039150: 2052 6574 7572 6e73 2041 534e 2e31 2073   Returns ASN.1 s
│ │ │ │ -00039160: 7472 7563 7475 7265 2063 6f72 7265 7370  tructure corresp
│ │ │ │ -00039170: 6f6e 6469 6e67 2074 6f20 4445 5220 6461  onding to DER da
│ │ │ │ -00039180: 7461 2e0a 0a73 6869 7368 695f 6465 7232  ta...shishi_der2
│ │ │ │ -00039190: 6173 6e31 5f65 6e63 6b64 6372 6570 7061  asn1_enckdcreppa
│ │ │ │ -000391a0: 7274 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  rt.-------------
│ │ │ │ +00038fb0: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +00038fc0: 696f 6e3a 2053 6869 7368 695f 6173 6e31  ion: Shishi_asn1
│ │ │ │ +00038fd0: 2073 6869 7368 695f 6465 7232 6173 6e31   shishi_der2asn1
│ │ │ │ +00038fe0: 5f65 6e63 7467 7372 6570 7061 7274 0a20  _enctgsreppart. 
│ │ │ │ +00038ff0: 2020 2020 2020 2020 2028 5368 6973 6869           (Shishi
│ │ │ │ +00039000: 202a 2048 414e 444c 452c 2063 6f6e 7374   * HANDLE, const
│ │ │ │ +00039010: 2063 6861 7220 2a20 4445 522c 2073 697a   char * DER, siz
│ │ │ │ +00039020: 655f 7420 4445 524c 454e 290a 2020 2020  e_t DERLEN).    
│ │ │ │ +00039030: 2048 414e 444c 453a 2073 6869 7368 6920   HANDLE: shishi 
│ │ │ │ +00039040: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ +00039050: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ +00039060: 5f69 6e69 7428 29e2 8099 2e0a 2020 2020  _init().....    
│ │ │ │ +00039070: 2044 4552 3a20 696e 7075 7420 6368 6172   DER: input char
│ │ │ │ +00039080: 6163 7465 7220 6172 7261 7920 7769 7468  acter array with
│ │ │ │ +00039090: 2044 4552 2065 6e63 6f64 696e 672e 0a20   DER encoding.. 
│ │ │ │ +000390a0: 2020 2020 4445 524c 454e 3a20 6c65 6e67      DERLEN: leng
│ │ │ │ +000390b0: 7468 206f 6620 696e 7075 7420 6368 6172  th of input char
│ │ │ │ +000390c0: 6163 7465 7220 6172 7261 7920 7769 7468  acter array with
│ │ │ │ +000390d0: 2044 4552 2065 6e63 6f64 696e 672e 0a0a   DER encoding...
│ │ │ │ +000390e0: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ +000390f0: 6e3a 2a20 4465 636f 6465 2044 4552 2065  n:* Decode DER e
│ │ │ │ +00039100: 6e63 6f64 696e 6720 6f66 2045 6e63 5447  ncoding of EncTG
│ │ │ │ +00039110: 5352 6570 5061 7274 2061 6e64 2063 7265  SRepPart and cre
│ │ │ │ +00039120: 6174 6520 610a 2020 2020 2041 534e 2e31  ate a.     ASN.1
│ │ │ │ +00039130: 2073 7472 7563 7475 7265 2e0a 0a20 2020   structure...   
│ │ │ │ +00039140: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ +00039150: 2a20 5265 7475 726e 7320 4153 4e2e 3120  * Returns ASN.1 
│ │ │ │ +00039160: 7374 7275 6374 7572 6520 636f 7272 6573  structure corres
│ │ │ │ +00039170: 706f 6e64 696e 6720 746f 2044 4552 2064  ponding to DER d
│ │ │ │ +00039180: 6174 612e 0a0a 7368 6973 6869 5f64 6572  ata...shishi_der
│ │ │ │ +00039190: 3261 736e 315f 656e 636b 6463 7265 7070  2asn1_enckdcrepp
│ │ │ │ +000391a0: 6172 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  art.------------
│ │ │ │  000391b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000391c0: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ -000391d0: 5368 6973 6869 5f61 736e 3120 7368 6973  Shishi_asn1 shis
│ │ │ │ -000391e0: 6869 5f64 6572 3261 736e 315f 656e 636b  hi_der2asn1_enck
│ │ │ │ -000391f0: 6463 7265 7070 6172 740a 2020 2020 2020  dcreppart.      
│ │ │ │ -00039200: 2020 2020 2853 6869 7368 6920 2a20 4841      (Shishi * HA
│ │ │ │ -00039210: 4e44 4c45 2c20 636f 6e73 7420 6368 6172  NDLE, const char
│ │ │ │ -00039220: 202a 2044 4552 2c20 7369 7a65 5f74 2044   * DER, size_t D
│ │ │ │ -00039230: 4552 4c45 4e29 0a20 2020 2020 4841 4e44  ERLEN).     HAND
│ │ │ │ -00039240: 4c45 3a20 7368 6973 6869 2068 616e 646c  LE: shishi handl
│ │ │ │ -00039250: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ -00039260: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ -00039270: 2829 e280 992e 0a20 2020 2020 4445 523a  ().....     DER:
│ │ │ │ -00039280: 2069 6e70 7574 2063 6861 7261 6374 6572   input character
│ │ │ │ -00039290: 2061 7272 6179 2077 6974 6820 4445 5220   array with DER 
│ │ │ │ -000392a0: 656e 636f 6469 6e67 2e0a 2020 2020 2044  encoding..     D
│ │ │ │ -000392b0: 4552 4c45 4e3a 206c 656e 6774 6820 6f66  ERLEN: length of
│ │ │ │ -000392c0: 2069 6e70 7574 2063 6861 7261 6374 6572   input character
│ │ │ │ -000392d0: 2061 7272 6179 2077 6974 6820 4445 5220   array with DER 
│ │ │ │ -000392e0: 656e 636f 6469 6e67 2e0a 0a20 2020 2020  encoding...     
│ │ │ │ -000392f0: 2a44 6573 6372 6970 7469 6f6e 3a2a 2044  *Description:* D
│ │ │ │ -00039300: 6563 6f64 6520 4445 5220 656e 636f 6469  ecode DER encodi
│ │ │ │ -00039310: 6e67 206f 6620 456e 634b 4443 5265 7050  ng of EncKDCRepP
│ │ │ │ -00039320: 6172 7420 616e 6420 6372 6561 7465 2061  art and create a
│ │ │ │ -00039330: 0a20 2020 2020 4153 4e2e 3120 7374 7275  .     ASN.1 stru
│ │ │ │ -00039340: 6374 7572 652e 0a0a 2020 2020 202a 5265  cture...     *Re
│ │ │ │ -00039350: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ -00039360: 7572 6e73 2041 534e 2e31 2073 7472 7563  urns ASN.1 struc
│ │ │ │ -00039370: 7475 7265 2063 6f72 7265 7370 6f6e 6469  ture correspondi
│ │ │ │ -00039380: 6e67 2074 6f20 4445 5220 6461 7461 2e0a  ng to DER data..
│ │ │ │ -00039390: 0a73 6869 7368 695f 6465 7232 6173 6e31  .shishi_der2asn1
│ │ │ │ -000393a0: 5f61 7574 6865 6e74 6963 6174 6f72 0a2d  _authenticator.-
│ │ │ │ +000391c0: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ +000391d0: 2053 6869 7368 695f 6173 6e31 2073 6869   Shishi_asn1 shi
│ │ │ │ +000391e0: 7368 695f 6465 7232 6173 6e31 5f65 6e63  shi_der2asn1_enc
│ │ │ │ +000391f0: 6b64 6372 6570 7061 7274 0a20 2020 2020  kdcreppart.     
│ │ │ │ +00039200: 2020 2020 2028 5368 6973 6869 202a 2048       (Shishi * H
│ │ │ │ +00039210: 414e 444c 452c 2063 6f6e 7374 2063 6861  ANDLE, const cha
│ │ │ │ +00039220: 7220 2a20 4445 522c 2073 697a 655f 7420  r * DER, size_t 
│ │ │ │ +00039230: 4445 524c 454e 290a 2020 2020 2048 414e  DERLEN).     HAN
│ │ │ │ +00039240: 444c 453a 2073 6869 7368 6920 6861 6e64  DLE: shishi hand
│ │ │ │ +00039250: 6c65 2061 7320 616c 6c6f 6361 7465 6420  le as allocated 
│ │ │ │ +00039260: 6279 20e2 8098 7368 6973 6869 5f69 6e69  by ...shishi_ini
│ │ │ │ +00039270: 7428 29e2 8099 2e0a 2020 2020 2044 4552  t().....     DER
│ │ │ │ +00039280: 3a20 696e 7075 7420 6368 6172 6163 7465  : input characte
│ │ │ │ +00039290: 7220 6172 7261 7920 7769 7468 2044 4552  r array with DER
│ │ │ │ +000392a0: 2065 6e63 6f64 696e 672e 0a20 2020 2020   encoding..     
│ │ │ │ +000392b0: 4445 524c 454e 3a20 6c65 6e67 7468 206f  DERLEN: length o
│ │ │ │ +000392c0: 6620 696e 7075 7420 6368 6172 6163 7465  f input characte
│ │ │ │ +000392d0: 7220 6172 7261 7920 7769 7468 2044 4552  r array with DER
│ │ │ │ +000392e0: 2065 6e63 6f64 696e 672e 0a0a 2020 2020   encoding...    
│ │ │ │ +000392f0: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ +00039300: 4465 636f 6465 2044 4552 2065 6e63 6f64  Decode DER encod
│ │ │ │ +00039310: 696e 6720 6f66 2045 6e63 4b44 4352 6570  ing of EncKDCRep
│ │ │ │ +00039320: 5061 7274 2061 6e64 2063 7265 6174 6520  Part and create 
│ │ │ │ +00039330: 610a 2020 2020 2041 534e 2e31 2073 7472  a.     ASN.1 str
│ │ │ │ +00039340: 7563 7475 7265 2e0a 0a20 2020 2020 2a52  ucture...     *R
│ │ │ │ +00039350: 6574 7572 6e20 7661 6c75 653a 2a20 5265  eturn value:* Re
│ │ │ │ +00039360: 7475 726e 7320 4153 4e2e 3120 7374 7275  turns ASN.1 stru
│ │ │ │ +00039370: 6374 7572 6520 636f 7272 6573 706f 6e64  cture correspond
│ │ │ │ +00039380: 696e 6720 746f 2044 4552 2064 6174 612e  ing to DER data.
│ │ │ │ +00039390: 0a0a 7368 6973 6869 5f64 6572 3261 736e  ..shishi_der2asn
│ │ │ │ +000393a0: 315f 6175 7468 656e 7469 6361 746f 720a  1_authenticator.
│ │ │ │  000393b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000393c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ -000393d0: 2d20 4675 6e63 7469 6f6e 3a20 5368 6973  - Function: Shis
│ │ │ │ -000393e0: 6869 5f61 736e 3120 7368 6973 6869 5f64  hi_asn1 shishi_d
│ │ │ │ -000393f0: 6572 3261 736e 315f 6175 7468 656e 7469  er2asn1_authenti
│ │ │ │ -00039400: 6361 746f 720a 2020 2020 2020 2020 2020  cator.          
│ │ │ │ -00039410: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ -00039420: 2c20 636f 6e73 7420 6368 6172 202a 2044  , const char * D
│ │ │ │ -00039430: 4552 2c20 7369 7a65 5f74 2044 4552 4c45  ER, size_t DERLE
│ │ │ │ -00039440: 4e29 0a20 2020 2020 4841 4e44 4c45 3a20  N).     HANDLE: 
│ │ │ │ -00039450: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ -00039460: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ -00039470: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ -00039480: 992e 0a20 2020 2020 4445 523a 2069 6e70  ...     DER: inp
│ │ │ │ -00039490: 7574 2063 6861 7261 6374 6572 2061 7272  ut character arr
│ │ │ │ -000394a0: 6179 2077 6974 6820 4445 5220 656e 636f  ay with DER enco
│ │ │ │ -000394b0: 6469 6e67 2e0a 2020 2020 2044 4552 4c45  ding..     DERLE
│ │ │ │ -000394c0: 4e3a 206c 656e 6774 6820 6f66 2069 6e70  N: length of inp
│ │ │ │ -000394d0: 7574 2063 6861 7261 6374 6572 2061 7272  ut character arr
│ │ │ │ -000394e0: 6179 2077 6974 6820 4445 5220 656e 636f  ay with DER enco
│ │ │ │ -000394f0: 6469 6e67 2e0a 0a20 2020 2020 2a44 6573  ding...     *Des
│ │ │ │ -00039500: 6372 6970 7469 6f6e 3a2a 2044 6563 6f64  cription:* Decod
│ │ │ │ -00039510: 6520 4445 5220 656e 636f 6469 6e67 206f  e DER encoding o
│ │ │ │ -00039520: 6620 4175 7468 656e 7469 6361 746f 7220  f Authenticator 
│ │ │ │ -00039530: 616e 6420 6372 6561 7465 2061 0a20 2020  and create a.   
│ │ │ │ -00039540: 2020 4153 4e2e 3120 7374 7275 6374 7572    ASN.1 structur
│ │ │ │ -00039550: 652e 0a0a 2020 2020 202a 5265 7475 726e  e...     *Return
│ │ │ │ -00039560: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ -00039570: 2041 534e 2e31 2073 7472 7563 7475 7265   ASN.1 structure
│ │ │ │ -00039580: 2063 6f72 7265 7370 6f6e 6469 6e67 2074   corresponding t
│ │ │ │ -00039590: 6f20 4445 5220 6461 7461 2e0a 0a73 6869  o DER data...shi
│ │ │ │ -000395a0: 7368 695f 6465 7232 6173 6e31 5f6b 7262  shi_der2asn1_krb
│ │ │ │ -000395b0: 6572 726f 720a 2d2d 2d2d 2d2d 2d2d 2d2d  error.----------
│ │ │ │ -000395c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -000395d0: 202d 2d20 4675 6e63 7469 6f6e 3a20 5368   -- Function: Sh
│ │ │ │ -000395e0: 6973 6869 5f61 736e 3120 7368 6973 6869  ishi_asn1 shishi
│ │ │ │ -000395f0: 5f64 6572 3261 736e 315f 6b72 6265 7272  _der2asn1_krberr
│ │ │ │ -00039600: 6f72 2028 5368 6973 6869 202a 2048 414e  or (Shishi * HAN
│ │ │ │ -00039610: 444c 452c 0a20 2020 2020 2020 2020 2063  DLE,.          c
│ │ │ │ -00039620: 6f6e 7374 2063 6861 7220 2a20 4445 522c  onst char * DER,
│ │ │ │ -00039630: 2073 697a 655f 7420 4445 524c 454e 290a   size_t DERLEN).
│ │ │ │ -00039640: 2020 2020 2048 414e 444c 453a 2073 6869       HANDLE: shi
│ │ │ │ -00039650: 7368 6920 6861 6e64 6c65 2061 7320 616c  shi handle as al
│ │ │ │ -00039660: 6c6f 6361 7465 6420 6279 20e2 8098 7368  located by ...sh
│ │ │ │ -00039670: 6973 6869 5f69 6e69 7428 29e2 8099 2e0a  ishi_init().....
│ │ │ │ -00039680: 2020 2020 2044 4552 3a20 696e 7075 7420       DER: input 
│ │ │ │ -00039690: 6368 6172 6163 7465 7220 6172 7261 7920  character array 
│ │ │ │ -000396a0: 7769 7468 2044 4552 2065 6e63 6f64 696e  with DER encodin
│ │ │ │ -000396b0: 672e 0a20 2020 2020 4445 524c 454e 3a20  g..     DERLEN: 
│ │ │ │ -000396c0: 6c65 6e67 7468 206f 6620 696e 7075 7420  length of input 
│ │ │ │ -000396d0: 6368 6172 6163 7465 7220 6172 7261 7920  character array 
│ │ │ │ -000396e0: 7769 7468 2044 4552 2065 6e63 6f64 696e  with DER encodin
│ │ │ │ -000396f0: 672e 0a0a 2020 2020 202a 4465 7363 7269  g...     *Descri
│ │ │ │ -00039700: 7074 696f 6e3a 2a20 4465 636f 6465 2044  ption:* Decode D
│ │ │ │ -00039710: 4552 2065 6e63 6f64 696e 6720 6f66 204b  ER encoding of K
│ │ │ │ -00039720: 5242 2d45 5252 4f52 2061 6e64 2063 7265  RB-ERROR and cre
│ │ │ │ -00039730: 6174 6520 6120 4153 4e2e 310a 2020 2020  ate a ASN.1.    
│ │ │ │ -00039740: 2073 7472 7563 7475 7265 2e0a 0a20 2020   structure...   
│ │ │ │ -00039750: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ -00039760: 2a20 5265 7475 726e 7320 4153 4e2e 3120  * Returns ASN.1 
│ │ │ │ -00039770: 7374 7275 6374 7572 6520 636f 7272 6573  structure corres
│ │ │ │ -00039780: 706f 6e64 696e 6720 746f 2044 4552 2064  ponding to DER d
│ │ │ │ -00039790: 6174 612e 0a0a 7368 6973 6869 5f64 6572  ata...shishi_der
│ │ │ │ -000397a0: 3261 736e 315f 6b72 6273 6166 650a 2d2d  2asn1_krbsafe.--
│ │ │ │ +000393c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ +000393d0: 2d2d 2046 756e 6374 696f 6e3a 2053 6869  -- Function: Shi
│ │ │ │ +000393e0: 7368 695f 6173 6e31 2073 6869 7368 695f  shi_asn1 shishi_
│ │ │ │ +000393f0: 6465 7232 6173 6e31 5f61 7574 6865 6e74  der2asn1_authent
│ │ │ │ +00039400: 6963 6174 6f72 0a20 2020 2020 2020 2020  icator.         
│ │ │ │ +00039410: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ +00039420: 452c 2063 6f6e 7374 2063 6861 7220 2a20  E, const char * 
│ │ │ │ +00039430: 4445 522c 2073 697a 655f 7420 4445 524c  DER, size_t DERL
│ │ │ │ +00039440: 454e 290a 2020 2020 2048 414e 444c 453a  EN).     HANDLE:
│ │ │ │ +00039450: 2073 6869 7368 6920 6861 6e64 6c65 2061   shishi handle a
│ │ │ │ +00039460: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ +00039470: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ +00039480: 8099 2e0a 2020 2020 2044 4552 3a20 696e  ....     DER: in
│ │ │ │ +00039490: 7075 7420 6368 6172 6163 7465 7220 6172  put character ar
│ │ │ │ +000394a0: 7261 7920 7769 7468 2044 4552 2065 6e63  ray with DER enc
│ │ │ │ +000394b0: 6f64 696e 672e 0a20 2020 2020 4445 524c  oding..     DERL
│ │ │ │ +000394c0: 454e 3a20 6c65 6e67 7468 206f 6620 696e  EN: length of in
│ │ │ │ +000394d0: 7075 7420 6368 6172 6163 7465 7220 6172  put character ar
│ │ │ │ +000394e0: 7261 7920 7769 7468 2044 4552 2065 6e63  ray with DER enc
│ │ │ │ +000394f0: 6f64 696e 672e 0a0a 2020 2020 202a 4465  oding...     *De
│ │ │ │ +00039500: 7363 7269 7074 696f 6e3a 2a20 4465 636f  scription:* Deco
│ │ │ │ +00039510: 6465 2044 4552 2065 6e63 6f64 696e 6720  de DER encoding 
│ │ │ │ +00039520: 6f66 2041 7574 6865 6e74 6963 6174 6f72  of Authenticator
│ │ │ │ +00039530: 2061 6e64 2063 7265 6174 6520 610a 2020   and create a.  
│ │ │ │ +00039540: 2020 2041 534e 2e31 2073 7472 7563 7475     ASN.1 structu
│ │ │ │ +00039550: 7265 2e0a 0a20 2020 2020 2a52 6574 7572  re...     *Retur
│ │ │ │ +00039560: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ +00039570: 7320 4153 4e2e 3120 7374 7275 6374 7572  s ASN.1 structur
│ │ │ │ +00039580: 6520 636f 7272 6573 706f 6e64 696e 6720  e corresponding 
│ │ │ │ +00039590: 746f 2044 4552 2064 6174 612e 0a0a 7368  to DER data...sh
│ │ │ │ +000395a0: 6973 6869 5f64 6572 3261 736e 315f 6b72  ishi_der2asn1_kr
│ │ │ │ +000395b0: 6265 7272 6f72 0a2d 2d2d 2d2d 2d2d 2d2d  berror.---------
│ │ │ │ +000395c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +000395d0: 0a20 2d2d 2046 756e 6374 696f 6e3a 2053  . -- Function: S
│ │ │ │ +000395e0: 6869 7368 695f 6173 6e31 2073 6869 7368  hishi_asn1 shish
│ │ │ │ +000395f0: 695f 6465 7232 6173 6e31 5f6b 7262 6572  i_der2asn1_krber
│ │ │ │ +00039600: 726f 7220 2853 6869 7368 6920 2a20 4841  ror (Shishi * HA
│ │ │ │ +00039610: 4e44 4c45 2c0a 2020 2020 2020 2020 2020  NDLE,.          
│ │ │ │ +00039620: 636f 6e73 7420 6368 6172 202a 2044 4552  const char * DER
│ │ │ │ +00039630: 2c20 7369 7a65 5f74 2044 4552 4c45 4e29  , size_t DERLEN)
│ │ │ │ +00039640: 0a20 2020 2020 4841 4e44 4c45 3a20 7368  .     HANDLE: sh
│ │ │ │ +00039650: 6973 6869 2068 616e 646c 6520 6173 2061  ishi handle as a
│ │ │ │ +00039660: 6c6c 6f63 6174 6564 2062 7920 e280 9873  llocated by ...s
│ │ │ │ +00039670: 6869 7368 695f 696e 6974 2829 e280 992e  hishi_init()....
│ │ │ │ +00039680: 0a20 2020 2020 4445 523a 2069 6e70 7574  .     DER: input
│ │ │ │ +00039690: 2063 6861 7261 6374 6572 2061 7272 6179   character array
│ │ │ │ +000396a0: 2077 6974 6820 4445 5220 656e 636f 6469   with DER encodi
│ │ │ │ +000396b0: 6e67 2e0a 2020 2020 2044 4552 4c45 4e3a  ng..     DERLEN:
│ │ │ │ +000396c0: 206c 656e 6774 6820 6f66 2069 6e70 7574   length of input
│ │ │ │ +000396d0: 2063 6861 7261 6374 6572 2061 7272 6179   character array
│ │ │ │ +000396e0: 2077 6974 6820 4445 5220 656e 636f 6469   with DER encodi
│ │ │ │ +000396f0: 6e67 2e0a 0a20 2020 2020 2a44 6573 6372  ng...     *Descr
│ │ │ │ +00039700: 6970 7469 6f6e 3a2a 2044 6563 6f64 6520  iption:* Decode 
│ │ │ │ +00039710: 4445 5220 656e 636f 6469 6e67 206f 6620  DER encoding of 
│ │ │ │ +00039720: 4b52 422d 4552 524f 5220 616e 6420 6372  KRB-ERROR and cr
│ │ │ │ +00039730: 6561 7465 2061 2041 534e 2e31 0a20 2020  eate a ASN.1.   
│ │ │ │ +00039740: 2020 7374 7275 6374 7572 652e 0a0a 2020    structure...  
│ │ │ │ +00039750: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ +00039760: 3a2a 2052 6574 7572 6e73 2041 534e 2e31  :* Returns ASN.1
│ │ │ │ +00039770: 2073 7472 7563 7475 7265 2063 6f72 7265   structure corre
│ │ │ │ +00039780: 7370 6f6e 6469 6e67 2074 6f20 4445 5220  sponding to DER 
│ │ │ │ +00039790: 6461 7461 2e0a 0a73 6869 7368 695f 6465  data...shishi_de
│ │ │ │ +000397a0: 7232 6173 6e31 5f6b 7262 7361 6665 0a2d  r2asn1_krbsafe.-
│ │ │ │  000397b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000397c0: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ -000397d0: 696f 6e3a 2053 6869 7368 695f 6173 6e31  ion: Shishi_asn1
│ │ │ │ -000397e0: 2073 6869 7368 695f 6465 7232 6173 6e31   shishi_der2asn1
│ │ │ │ -000397f0: 5f6b 7262 7361 6665 2028 5368 6973 6869  _krbsafe (Shishi
│ │ │ │ -00039800: 202a 2048 414e 444c 452c 0a20 2020 2020   * HANDLE,.     
│ │ │ │ -00039810: 2020 2020 2063 6f6e 7374 2063 6861 7220       const char 
│ │ │ │ -00039820: 2a20 4445 522c 2073 697a 655f 7420 4445  * DER, size_t DE
│ │ │ │ -00039830: 524c 454e 290a 2020 2020 2048 414e 444c  RLEN).     HANDL
│ │ │ │ -00039840: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ -00039850: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ -00039860: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ -00039870: 29e2 8099 2e0a 2020 2020 2044 4552 3a20  ).....     DER: 
│ │ │ │ -00039880: 696e 7075 7420 6368 6172 6163 7465 7220  input character 
│ │ │ │ -00039890: 6172 7261 7920 7769 7468 2044 4552 2065  array with DER e
│ │ │ │ -000398a0: 6e63 6f64 696e 672e 0a20 2020 2020 4445  ncoding..     DE
│ │ │ │ -000398b0: 524c 454e 3a20 6c65 6e67 7468 206f 6620  RLEN: length of 
│ │ │ │ -000398c0: 696e 7075 7420 6368 6172 6163 7465 7220  input character 
│ │ │ │ -000398d0: 6172 7261 7920 7769 7468 2044 4552 2065  array with DER e
│ │ │ │ -000398e0: 6e63 6f64 696e 672e 0a0a 2020 2020 202a  ncoding...     *
│ │ │ │ -000398f0: 4465 7363 7269 7074 696f 6e3a 2a20 4465  Description:* De
│ │ │ │ -00039900: 636f 6465 2044 4552 2065 6e63 6f64 696e  code DER encodin
│ │ │ │ -00039910: 6720 6f66 204b 5242 2d53 4146 4520 616e  g of KRB-SAFE an
│ │ │ │ -00039920: 6420 6372 6561 7465 2061 2041 534e 2e31  d create a ASN.1
│ │ │ │ -00039930: 0a20 2020 2020 7374 7275 6374 7572 652e  .     structure.
│ │ │ │ -00039940: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ -00039950: 616c 7565 3a2a 2052 6574 7572 6e73 2041  alue:* Returns A
│ │ │ │ -00039960: 534e 2e31 2073 7472 7563 7475 7265 2063  SN.1 structure c
│ │ │ │ -00039970: 6f72 7265 7370 6f6e 6469 6e67 2074 6f20  orresponding to 
│ │ │ │ -00039980: 4445 5220 6461 7461 2e0a 0a73 6869 7368  DER data...shish
│ │ │ │ -00039990: 695f 6465 7232 6173 6e31 5f70 7269 760a  i_der2asn1_priv.
│ │ │ │ -000399a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000399b0: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -000399c0: 6f6e 3a20 5368 6973 6869 5f61 736e 3120  on: Shishi_asn1 
│ │ │ │ -000399d0: 7368 6973 6869 5f64 6572 3261 736e 315f  shishi_der2asn1_
│ │ │ │ -000399e0: 7072 6976 2028 5368 6973 6869 202a 2048  priv (Shishi * H
│ │ │ │ -000399f0: 414e 444c 452c 0a20 2020 2020 2020 2020  ANDLE,.         
│ │ │ │ -00039a00: 2063 6f6e 7374 2063 6861 7220 2a20 4445   const char * DE
│ │ │ │ -00039a10: 522c 2073 697a 655f 7420 4445 524c 454e  R, size_t DERLEN
│ │ │ │ -00039a20: 290a 2020 2020 2048 414e 444c 453a 2073  ).     HANDLE: s
│ │ │ │ -00039a30: 6869 7368 6920 6861 6e64 6c65 2061 7320  hishi handle as 
│ │ │ │ -00039a40: 616c 6c6f 6361 7465 6420 6279 20e2 8098  allocated by ...
│ │ │ │ -00039a50: 7368 6973 6869 5f69 6e69 7428 29e2 8099  shishi_init()...
│ │ │ │ -00039a60: 2e0a 2020 2020 2044 4552 3a20 696e 7075  ..     DER: inpu
│ │ │ │ -00039a70: 7420 6368 6172 6163 7465 7220 6172 7261  t character arra
│ │ │ │ -00039a80: 7920 7769 7468 2044 4552 2065 6e63 6f64  y with DER encod
│ │ │ │ -00039a90: 696e 672e 0a20 2020 2020 4445 524c 454e  ing..     DERLEN
│ │ │ │ -00039aa0: 3a20 6c65 6e67 7468 206f 6620 696e 7075  : length of inpu
│ │ │ │ -00039ab0: 7420 6368 6172 6163 7465 7220 6172 7261  t character arra
│ │ │ │ -00039ac0: 7920 7769 7468 2044 4552 2065 6e63 6f64  y with DER encod
│ │ │ │ -00039ad0: 696e 672e 0a0a 2020 2020 202a 4465 7363  ing...     *Desc
│ │ │ │ -00039ae0: 7269 7074 696f 6e3a 2a20 4465 636f 6465  ription:* Decode
│ │ │ │ -00039af0: 2044 4552 2065 6e63 6f64 696e 6720 6f66   DER encoding of
│ │ │ │ -00039b00: 204b 5242 2d50 5249 5620 616e 6420 6372   KRB-PRIV and cr
│ │ │ │ -00039b10: 6561 7465 2061 2041 534e 2e31 0a20 2020  eate a ASN.1.   
│ │ │ │ -00039b20: 2020 7374 7275 6374 7572 652e 0a0a 2020    structure...  
│ │ │ │ -00039b30: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ -00039b40: 3a2a 2052 6574 7572 6e73 2041 534e 2e31  :* Returns ASN.1
│ │ │ │ -00039b50: 2073 7472 7563 7475 7265 2063 6f72 7265   structure corre
│ │ │ │ -00039b60: 7370 6f6e 6469 6e67 2074 6f20 4445 5220  sponding to DER 
│ │ │ │ -00039b70: 6461 7461 2e0a 0a73 6869 7368 695f 6465  data...shishi_de
│ │ │ │ -00039b80: 7232 6173 6e31 5f65 6e63 7072 6976 7061  r2asn1_encprivpa
│ │ │ │ -00039b90: 7274 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  rt.-------------
│ │ │ │ -00039ba0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -00039bb0: 202d 2d20 4675 6e63 7469 6f6e 3a20 5368   -- Function: Sh
│ │ │ │ -00039bc0: 6973 6869 5f61 736e 3120 7368 6973 6869  ishi_asn1 shishi
│ │ │ │ -00039bd0: 5f64 6572 3261 736e 315f 656e 6370 7269  _der2asn1_encpri
│ │ │ │ -00039be0: 7670 6172 7420 2853 6869 7368 6920 2a20  vpart (Shishi * 
│ │ │ │ -00039bf0: 4841 4e44 4c45 2c0a 2020 2020 2020 2020  HANDLE,.        
│ │ │ │ -00039c00: 2020 636f 6e73 7420 6368 6172 202a 2044    const char * D
│ │ │ │ -00039c10: 4552 2c20 7369 7a65 5f74 2044 4552 4c45  ER, size_t DERLE
│ │ │ │ -00039c20: 4e29 0a20 2020 2020 4841 4e44 4c45 3a20  N).     HANDLE: 
│ │ │ │ -00039c30: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ -00039c40: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ -00039c50: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ -00039c60: 992e 0a20 2020 2020 4445 523a 2069 6e70  ...     DER: inp
│ │ │ │ -00039c70: 7574 2063 6861 7261 6374 6572 2061 7272  ut character arr
│ │ │ │ -00039c80: 6179 2077 6974 6820 4445 5220 656e 636f  ay with DER enco
│ │ │ │ -00039c90: 6469 6e67 2e0a 2020 2020 2044 4552 4c45  ding..     DERLE
│ │ │ │ -00039ca0: 4e3a 206c 656e 6774 6820 6f66 2069 6e70  N: length of inp
│ │ │ │ -00039cb0: 7574 2063 6861 7261 6374 6572 2061 7272  ut character arr
│ │ │ │ -00039cc0: 6179 2077 6974 6820 4445 5220 656e 636f  ay with DER enco
│ │ │ │ -00039cd0: 6469 6e67 2e0a 0a20 2020 2020 2a44 6573  ding...     *Des
│ │ │ │ -00039ce0: 6372 6970 7469 6f6e 3a2a 2044 6563 6f64  cription:* Decod
│ │ │ │ -00039cf0: 6520 4445 5220 656e 636f 6469 6e67 206f  e DER encoding o
│ │ │ │ -00039d00: 6620 456e 634b 7262 5072 6976 5061 7274  f EncKrbPrivPart
│ │ │ │ -00039d10: 2061 6e64 2063 7265 6174 6520 610a 2020   and create a.  
│ │ │ │ -00039d20: 2020 2041 534e 2e31 2073 7472 7563 7475     ASN.1 structu
│ │ │ │ -00039d30: 7265 2e0a 0a20 2020 2020 2a52 6574 7572  re...     *Retur
│ │ │ │ -00039d40: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ -00039d50: 7320 4153 4e2e 3120 7374 7275 6374 7572  s ASN.1 structur
│ │ │ │ -00039d60: 6520 636f 7272 6573 706f 6e64 696e 6720  e corresponding 
│ │ │ │ -00039d70: 746f 2044 4552 2064 6174 612e 0a0a 7368  to DER data...sh
│ │ │ │ -00039d80: 6973 6869 5f64 6572 3261 736e 315f 6170  ishi_der2asn1_ap
│ │ │ │ -00039d90: 7265 710a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  req.------------
│ │ │ │ -00039da0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ -00039db0: 756e 6374 696f 6e3a 2053 6869 7368 695f  unction: Shishi_
│ │ │ │ -00039dc0: 6173 6e31 2073 6869 7368 695f 6465 7232  asn1 shishi_der2
│ │ │ │ -00039dd0: 6173 6e31 5f61 7072 6571 2028 5368 6973  asn1_apreq (Shis
│ │ │ │ -00039de0: 6869 202a 2048 414e 444c 452c 0a20 2020  hi * HANDLE,.   
│ │ │ │ -00039df0: 2020 2020 2020 2063 6f6e 7374 2063 6861         const cha
│ │ │ │ -00039e00: 7220 2a20 4445 522c 2073 697a 655f 7420  r * DER, size_t 
│ │ │ │ -00039e10: 4445 524c 454e 290a 2020 2020 2048 414e  DERLEN).     HAN
│ │ │ │ -00039e20: 444c 453a 2073 6869 7368 6920 6861 6e64  DLE: shishi hand
│ │ │ │ -00039e30: 6c65 2061 7320 616c 6c6f 6361 7465 6420  le as allocated 
│ │ │ │ -00039e40: 6279 20e2 8098 7368 6973 6869 5f69 6e69  by ...shishi_ini
│ │ │ │ -00039e50: 7428 29e2 8099 2e0a 2020 2020 2044 4552  t().....     DER
│ │ │ │ -00039e60: 3a20 696e 7075 7420 6368 6172 6163 7465  : input characte
│ │ │ │ -00039e70: 7220 6172 7261 7920 7769 7468 2044 4552  r array with DER
│ │ │ │ -00039e80: 2065 6e63 6f64 696e 672e 0a20 2020 2020   encoding..     
│ │ │ │ -00039e90: 4445 524c 454e 3a20 6c65 6e67 7468 206f  DERLEN: length o
│ │ │ │ -00039ea0: 6620 696e 7075 7420 6368 6172 6163 7465  f input characte
│ │ │ │ -00039eb0: 7220 6172 7261 7920 7769 7468 2044 4552  r array with DER
│ │ │ │ -00039ec0: 2065 6e63 6f64 696e 672e 0a0a 2020 2020   encoding...    
│ │ │ │ -00039ed0: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ -00039ee0: 4465 636f 6465 2044 4552 2065 6e63 6f64  Decode DER encod
│ │ │ │ -00039ef0: 696e 6720 6f66 2041 502d 5245 5120 616e  ing of AP-REQ an
│ │ │ │ -00039f00: 6420 6372 6561 7465 2061 2041 534e 2e31  d create a ASN.1
│ │ │ │ -00039f10: 0a20 2020 2020 7374 7275 6374 7572 652e  .     structure.
│ │ │ │ -00039f20: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ -00039f30: 616c 7565 3a2a 2052 6574 7572 6e73 2041  alue:* Returns A
│ │ │ │ -00039f40: 534e 2e31 2073 7472 7563 7475 7265 2063  SN.1 structure c
│ │ │ │ -00039f50: 6f72 7265 7370 6f6e 6469 6e67 2074 6f20  orresponding to 
│ │ │ │ -00039f60: 4445 5220 6461 7461 2e0a 0a73 6869 7368  DER data...shish
│ │ │ │ -00039f70: 695f 6465 7232 6173 6e31 5f61 7072 6570  i_der2asn1_aprep
│ │ │ │ -00039f80: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ -00039f90: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ -00039fa0: 7469 6f6e 3a20 5368 6973 6869 5f61 736e  tion: Shishi_asn
│ │ │ │ -00039fb0: 3120 7368 6973 6869 5f64 6572 3261 736e  1 shishi_der2asn
│ │ │ │ -00039fc0: 315f 6170 7265 7020 2853 6869 7368 6920  1_aprep (Shishi 
│ │ │ │ -00039fd0: 2a20 4841 4e44 4c45 2c0a 2020 2020 2020  * HANDLE,.      
│ │ │ │ -00039fe0: 2020 2020 636f 6e73 7420 6368 6172 202a      const char *
│ │ │ │ -00039ff0: 2044 4552 2c20 7369 7a65 5f74 2044 4552   DER, size_t DER
│ │ │ │ -0003a000: 4c45 4e29 0a20 2020 2020 4841 4e44 4c45  LEN).     HANDLE
│ │ │ │ -0003a010: 3a20 7368 6973 6869 2068 616e 646c 6520  : shishi handle 
│ │ │ │ -0003a020: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ -0003a030: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ -0003a040: e280 992e 0a20 2020 2020 4445 523a 2069  .....     DER: i
│ │ │ │ -0003a050: 6e70 7574 2063 6861 7261 6374 6572 2061  nput character a
│ │ │ │ -0003a060: 7272 6179 2077 6974 6820 4445 5220 656e  rray with DER en
│ │ │ │ -0003a070: 636f 6469 6e67 2e0a 2020 2020 2044 4552  coding..     DER
│ │ │ │ -0003a080: 4c45 4e3a 206c 656e 6774 6820 6f66 2069  LEN: length of i
│ │ │ │ -0003a090: 6e70 7574 2063 6861 7261 6374 6572 2061  nput character a
│ │ │ │ -0003a0a0: 7272 6179 2077 6974 6820 4445 5220 656e  rray with DER en
│ │ │ │ -0003a0b0: 636f 6469 6e67 2e0a 0a20 2020 2020 2a44  coding...     *D
│ │ │ │ -0003a0c0: 6573 6372 6970 7469 6f6e 3a2a 2044 6563  escription:* Dec
│ │ │ │ -0003a0d0: 6f64 6520 4445 5220 656e 636f 6469 6e67  ode DER encoding
│ │ │ │ -0003a0e0: 206f 6620 4150 2d52 4550 2061 6e64 2063   of AP-REP and c
│ │ │ │ -0003a0f0: 7265 6174 6520 6120 4153 4e2e 310a 2020  reate a ASN.1.  
│ │ │ │ -0003a100: 2020 2073 7472 7563 7475 7265 2e0a 0a20     structure... 
│ │ │ │ -0003a110: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ -0003a120: 653a 2a20 5265 7475 726e 7320 4153 4e2e  e:* Returns ASN.
│ │ │ │ -0003a130: 3120 7374 7275 6374 7572 6520 636f 7272  1 structure corr
│ │ │ │ -0003a140: 6573 706f 6e64 696e 6720 746f 2044 4552  esponding to DER
│ │ │ │ -0003a150: 2064 6174 612e 0a0a 7368 6973 6869 5f64   data...shishi_d
│ │ │ │ -0003a160: 6572 3261 736e 315f 656e 6361 7072 6570  er2asn1_encaprep
│ │ │ │ -0003a170: 7061 7274 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  part.-----------
│ │ │ │ +000397c0: 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  ------.. -- Func
│ │ │ │ +000397d0: 7469 6f6e 3a20 5368 6973 6869 5f61 736e  tion: Shishi_asn
│ │ │ │ +000397e0: 3120 7368 6973 6869 5f64 6572 3261 736e  1 shishi_der2asn
│ │ │ │ +000397f0: 315f 6b72 6273 6166 6520 2853 6869 7368  1_krbsafe (Shish
│ │ │ │ +00039800: 6920 2a20 4841 4e44 4c45 2c0a 2020 2020  i * HANDLE,.    
│ │ │ │ +00039810: 2020 2020 2020 636f 6e73 7420 6368 6172        const char
│ │ │ │ +00039820: 202a 2044 4552 2c20 7369 7a65 5f74 2044   * DER, size_t D
│ │ │ │ +00039830: 4552 4c45 4e29 0a20 2020 2020 4841 4e44  ERLEN).     HAND
│ │ │ │ +00039840: 4c45 3a20 7368 6973 6869 2068 616e 646c  LE: shishi handl
│ │ │ │ +00039850: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ +00039860: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ +00039870: 2829 e280 992e 0a20 2020 2020 4445 523a  ().....     DER:
│ │ │ │ +00039880: 2069 6e70 7574 2063 6861 7261 6374 6572   input character
│ │ │ │ +00039890: 2061 7272 6179 2077 6974 6820 4445 5220   array with DER 
│ │ │ │ +000398a0: 656e 636f 6469 6e67 2e0a 2020 2020 2044  encoding..     D
│ │ │ │ +000398b0: 4552 4c45 4e3a 206c 656e 6774 6820 6f66  ERLEN: length of
│ │ │ │ +000398c0: 2069 6e70 7574 2063 6861 7261 6374 6572   input character
│ │ │ │ +000398d0: 2061 7272 6179 2077 6974 6820 4445 5220   array with DER 
│ │ │ │ +000398e0: 656e 636f 6469 6e67 2e0a 0a20 2020 2020  encoding...     
│ │ │ │ +000398f0: 2a44 6573 6372 6970 7469 6f6e 3a2a 2044  *Description:* D
│ │ │ │ +00039900: 6563 6f64 6520 4445 5220 656e 636f 6469  ecode DER encodi
│ │ │ │ +00039910: 6e67 206f 6620 4b52 422d 5341 4645 2061  ng of KRB-SAFE a
│ │ │ │ +00039920: 6e64 2063 7265 6174 6520 6120 4153 4e2e  nd create a ASN.
│ │ │ │ +00039930: 310a 2020 2020 2073 7472 7563 7475 7265  1.     structure
│ │ │ │ +00039940: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ +00039950: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ +00039960: 4153 4e2e 3120 7374 7275 6374 7572 6520  ASN.1 structure 
│ │ │ │ +00039970: 636f 7272 6573 706f 6e64 696e 6720 746f  corresponding to
│ │ │ │ +00039980: 2044 4552 2064 6174 612e 0a0a 7368 6973   DER data...shis
│ │ │ │ +00039990: 6869 5f64 6572 3261 736e 315f 7072 6976  hi_der2asn1_priv
│ │ │ │ +000399a0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ +000399b0: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +000399c0: 696f 6e3a 2053 6869 7368 695f 6173 6e31  ion: Shishi_asn1
│ │ │ │ +000399d0: 2073 6869 7368 695f 6465 7232 6173 6e31   shishi_der2asn1
│ │ │ │ +000399e0: 5f70 7269 7620 2853 6869 7368 6920 2a20  _priv (Shishi * 
│ │ │ │ +000399f0: 4841 4e44 4c45 2c0a 2020 2020 2020 2020  HANDLE,.        
│ │ │ │ +00039a00: 2020 636f 6e73 7420 6368 6172 202a 2044    const char * D
│ │ │ │ +00039a10: 4552 2c20 7369 7a65 5f74 2044 4552 4c45  ER, size_t DERLE
│ │ │ │ +00039a20: 4e29 0a20 2020 2020 4841 4e44 4c45 3a20  N).     HANDLE: 
│ │ │ │ +00039a30: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ +00039a40: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ +00039a50: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ +00039a60: 992e 0a20 2020 2020 4445 523a 2069 6e70  ...     DER: inp
│ │ │ │ +00039a70: 7574 2063 6861 7261 6374 6572 2061 7272  ut character arr
│ │ │ │ +00039a80: 6179 2077 6974 6820 4445 5220 656e 636f  ay with DER enco
│ │ │ │ +00039a90: 6469 6e67 2e0a 2020 2020 2044 4552 4c45  ding..     DERLE
│ │ │ │ +00039aa0: 4e3a 206c 656e 6774 6820 6f66 2069 6e70  N: length of inp
│ │ │ │ +00039ab0: 7574 2063 6861 7261 6374 6572 2061 7272  ut character arr
│ │ │ │ +00039ac0: 6179 2077 6974 6820 4445 5220 656e 636f  ay with DER enco
│ │ │ │ +00039ad0: 6469 6e67 2e0a 0a20 2020 2020 2a44 6573  ding...     *Des
│ │ │ │ +00039ae0: 6372 6970 7469 6f6e 3a2a 2044 6563 6f64  cription:* Decod
│ │ │ │ +00039af0: 6520 4445 5220 656e 636f 6469 6e67 206f  e DER encoding o
│ │ │ │ +00039b00: 6620 4b52 422d 5052 4956 2061 6e64 2063  f KRB-PRIV and c
│ │ │ │ +00039b10: 7265 6174 6520 6120 4153 4e2e 310a 2020  reate a ASN.1.  
│ │ │ │ +00039b20: 2020 2073 7472 7563 7475 7265 2e0a 0a20     structure... 
│ │ │ │ +00039b30: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ +00039b40: 653a 2a20 5265 7475 726e 7320 4153 4e2e  e:* Returns ASN.
│ │ │ │ +00039b50: 3120 7374 7275 6374 7572 6520 636f 7272  1 structure corr
│ │ │ │ +00039b60: 6573 706f 6e64 696e 6720 746f 2044 4552  esponding to DER
│ │ │ │ +00039b70: 2064 6174 612e 0a0a 7368 6973 6869 5f64   data...shishi_d
│ │ │ │ +00039b80: 6572 3261 736e 315f 656e 6370 7269 7670  er2asn1_encprivp
│ │ │ │ +00039b90: 6172 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  art.------------
│ │ │ │ +00039ba0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +00039bb0: 0a20 2d2d 2046 756e 6374 696f 6e3a 2053  . -- Function: S
│ │ │ │ +00039bc0: 6869 7368 695f 6173 6e31 2073 6869 7368  hishi_asn1 shish
│ │ │ │ +00039bd0: 695f 6465 7232 6173 6e31 5f65 6e63 7072  i_der2asn1_encpr
│ │ │ │ +00039be0: 6976 7061 7274 2028 5368 6973 6869 202a  ivpart (Shishi *
│ │ │ │ +00039bf0: 2048 414e 444c 452c 0a20 2020 2020 2020   HANDLE,.       
│ │ │ │ +00039c00: 2020 2063 6f6e 7374 2063 6861 7220 2a20     const char * 
│ │ │ │ +00039c10: 4445 522c 2073 697a 655f 7420 4445 524c  DER, size_t DERL
│ │ │ │ +00039c20: 454e 290a 2020 2020 2048 414e 444c 453a  EN).     HANDLE:
│ │ │ │ +00039c30: 2073 6869 7368 6920 6861 6e64 6c65 2061   shishi handle a
│ │ │ │ +00039c40: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ +00039c50: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ +00039c60: 8099 2e0a 2020 2020 2044 4552 3a20 696e  ....     DER: in
│ │ │ │ +00039c70: 7075 7420 6368 6172 6163 7465 7220 6172  put character ar
│ │ │ │ +00039c80: 7261 7920 7769 7468 2044 4552 2065 6e63  ray with DER enc
│ │ │ │ +00039c90: 6f64 696e 672e 0a20 2020 2020 4445 524c  oding..     DERL
│ │ │ │ +00039ca0: 454e 3a20 6c65 6e67 7468 206f 6620 696e  EN: length of in
│ │ │ │ +00039cb0: 7075 7420 6368 6172 6163 7465 7220 6172  put character ar
│ │ │ │ +00039cc0: 7261 7920 7769 7468 2044 4552 2065 6e63  ray with DER enc
│ │ │ │ +00039cd0: 6f64 696e 672e 0a0a 2020 2020 202a 4465  oding...     *De
│ │ │ │ +00039ce0: 7363 7269 7074 696f 6e3a 2a20 4465 636f  scription:* Deco
│ │ │ │ +00039cf0: 6465 2044 4552 2065 6e63 6f64 696e 6720  de DER encoding 
│ │ │ │ +00039d00: 6f66 2045 6e63 4b72 6250 7269 7650 6172  of EncKrbPrivPar
│ │ │ │ +00039d10: 7420 616e 6420 6372 6561 7465 2061 0a20  t and create a. 
│ │ │ │ +00039d20: 2020 2020 4153 4e2e 3120 7374 7275 6374      ASN.1 struct
│ │ │ │ +00039d30: 7572 652e 0a0a 2020 2020 202a 5265 7475  ure...     *Retu
│ │ │ │ +00039d40: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ +00039d50: 6e73 2041 534e 2e31 2073 7472 7563 7475  ns ASN.1 structu
│ │ │ │ +00039d60: 7265 2063 6f72 7265 7370 6f6e 6469 6e67  re corresponding
│ │ │ │ +00039d70: 2074 6f20 4445 5220 6461 7461 2e0a 0a73   to DER data...s
│ │ │ │ +00039d80: 6869 7368 695f 6465 7232 6173 6e31 5f61  hishi_der2asn1_a
│ │ │ │ +00039d90: 7072 6571 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  preq.-----------
│ │ │ │ +00039da0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +00039db0: 4675 6e63 7469 6f6e 3a20 5368 6973 6869  Function: Shishi
│ │ │ │ +00039dc0: 5f61 736e 3120 7368 6973 6869 5f64 6572  _asn1 shishi_der
│ │ │ │ +00039dd0: 3261 736e 315f 6170 7265 7120 2853 6869  2asn1_apreq (Shi
│ │ │ │ +00039de0: 7368 6920 2a20 4841 4e44 4c45 2c0a 2020  shi * HANDLE,.  
│ │ │ │ +00039df0: 2020 2020 2020 2020 636f 6e73 7420 6368          const ch
│ │ │ │ +00039e00: 6172 202a 2044 4552 2c20 7369 7a65 5f74  ar * DER, size_t
│ │ │ │ +00039e10: 2044 4552 4c45 4e29 0a20 2020 2020 4841   DERLEN).     HA
│ │ │ │ +00039e20: 4e44 4c45 3a20 7368 6973 6869 2068 616e  NDLE: shishi han
│ │ │ │ +00039e30: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ +00039e40: 2062 7920 e280 9873 6869 7368 695f 696e   by ...shishi_in
│ │ │ │ +00039e50: 6974 2829 e280 992e 0a20 2020 2020 4445  it().....     DE
│ │ │ │ +00039e60: 523a 2069 6e70 7574 2063 6861 7261 6374  R: input charact
│ │ │ │ +00039e70: 6572 2061 7272 6179 2077 6974 6820 4445  er array with DE
│ │ │ │ +00039e80: 5220 656e 636f 6469 6e67 2e0a 2020 2020  R encoding..    
│ │ │ │ +00039e90: 2044 4552 4c45 4e3a 206c 656e 6774 6820   DERLEN: length 
│ │ │ │ +00039ea0: 6f66 2069 6e70 7574 2063 6861 7261 6374  of input charact
│ │ │ │ +00039eb0: 6572 2061 7272 6179 2077 6974 6820 4445  er array with DE
│ │ │ │ +00039ec0: 5220 656e 636f 6469 6e67 2e0a 0a20 2020  R encoding...   
│ │ │ │ +00039ed0: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ +00039ee0: 2044 6563 6f64 6520 4445 5220 656e 636f   Decode DER enco
│ │ │ │ +00039ef0: 6469 6e67 206f 6620 4150 2d52 4551 2061  ding of AP-REQ a
│ │ │ │ +00039f00: 6e64 2063 7265 6174 6520 6120 4153 4e2e  nd create a ASN.
│ │ │ │ +00039f10: 310a 2020 2020 2073 7472 7563 7475 7265  1.     structure
│ │ │ │ +00039f20: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ +00039f30: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ +00039f40: 4153 4e2e 3120 7374 7275 6374 7572 6520  ASN.1 structure 
│ │ │ │ +00039f50: 636f 7272 6573 706f 6e64 696e 6720 746f  corresponding to
│ │ │ │ +00039f60: 2044 4552 2064 6174 612e 0a0a 7368 6973   DER data...shis
│ │ │ │ +00039f70: 6869 5f64 6572 3261 736e 315f 6170 7265  hi_der2asn1_apre
│ │ │ │ +00039f80: 700a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  p.--------------
│ │ │ │ +00039f90: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ +00039fa0: 6374 696f 6e3a 2053 6869 7368 695f 6173  ction: Shishi_as
│ │ │ │ +00039fb0: 6e31 2073 6869 7368 695f 6465 7232 6173  n1 shishi_der2as
│ │ │ │ +00039fc0: 6e31 5f61 7072 6570 2028 5368 6973 6869  n1_aprep (Shishi
│ │ │ │ +00039fd0: 202a 2048 414e 444c 452c 0a20 2020 2020   * HANDLE,.     
│ │ │ │ +00039fe0: 2020 2020 2063 6f6e 7374 2063 6861 7220       const char 
│ │ │ │ +00039ff0: 2a20 4445 522c 2073 697a 655f 7420 4445  * DER, size_t DE
│ │ │ │ +0003a000: 524c 454e 290a 2020 2020 2048 414e 444c  RLEN).     HANDL
│ │ │ │ +0003a010: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ +0003a020: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ +0003a030: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ +0003a040: 29e2 8099 2e0a 2020 2020 2044 4552 3a20  ).....     DER: 
│ │ │ │ +0003a050: 696e 7075 7420 6368 6172 6163 7465 7220  input character 
│ │ │ │ +0003a060: 6172 7261 7920 7769 7468 2044 4552 2065  array with DER e
│ │ │ │ +0003a070: 6e63 6f64 696e 672e 0a20 2020 2020 4445  ncoding..     DE
│ │ │ │ +0003a080: 524c 454e 3a20 6c65 6e67 7468 206f 6620  RLEN: length of 
│ │ │ │ +0003a090: 696e 7075 7420 6368 6172 6163 7465 7220  input character 
│ │ │ │ +0003a0a0: 6172 7261 7920 7769 7468 2044 4552 2065  array with DER e
│ │ │ │ +0003a0b0: 6e63 6f64 696e 672e 0a0a 2020 2020 202a  ncoding...     *
│ │ │ │ +0003a0c0: 4465 7363 7269 7074 696f 6e3a 2a20 4465  Description:* De
│ │ │ │ +0003a0d0: 636f 6465 2044 4552 2065 6e63 6f64 696e  code DER encodin
│ │ │ │ +0003a0e0: 6720 6f66 2041 502d 5245 5020 616e 6420  g of AP-REP and 
│ │ │ │ +0003a0f0: 6372 6561 7465 2061 2041 534e 2e31 0a20  create a ASN.1. 
│ │ │ │ +0003a100: 2020 2020 7374 7275 6374 7572 652e 0a0a      structure...
│ │ │ │ +0003a110: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ +0003a120: 7565 3a2a 2052 6574 7572 6e73 2041 534e  ue:* Returns ASN
│ │ │ │ +0003a130: 2e31 2073 7472 7563 7475 7265 2063 6f72  .1 structure cor
│ │ │ │ +0003a140: 7265 7370 6f6e 6469 6e67 2074 6f20 4445  responding to DE
│ │ │ │ +0003a150: 5220 6461 7461 2e0a 0a73 6869 7368 695f  R data...shishi_
│ │ │ │ +0003a160: 6465 7232 6173 6e31 5f65 6e63 6170 7265  der2asn1_encapre
│ │ │ │ +0003a170: 7070 6172 740a 2d2d 2d2d 2d2d 2d2d 2d2d  ppart.----------
│ │ │ │  0003a180: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0003a190: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ -0003a1a0: 2053 6869 7368 695f 6173 6e31 2073 6869   Shishi_asn1 shi
│ │ │ │ -0003a1b0: 7368 695f 6465 7232 6173 6e31 5f65 6e63  shi_der2asn1_enc
│ │ │ │ -0003a1c0: 6170 7265 7070 6172 7420 2853 6869 7368  apreppart (Shish
│ │ │ │ -0003a1d0: 6920 2a20 4841 4e44 4c45 2c0a 2020 2020  i * HANDLE,.    
│ │ │ │ -0003a1e0: 2020 2020 2020 636f 6e73 7420 6368 6172        const char
│ │ │ │ -0003a1f0: 202a 2044 4552 2c20 7369 7a65 5f74 2044   * DER, size_t D
│ │ │ │ -0003a200: 4552 4c45 4e29 0a20 2020 2020 4841 4e44  ERLEN).     HAND
│ │ │ │ -0003a210: 4c45 3a20 7368 6973 6869 2068 616e 646c  LE: shishi handl
│ │ │ │ -0003a220: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ -0003a230: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ -0003a240: 2829 e280 992e 0a20 2020 2020 4445 523a  ().....     DER:
│ │ │ │ -0003a250: 2069 6e70 7574 2063 6861 7261 6374 6572   input character
│ │ │ │ -0003a260: 2061 7272 6179 2077 6974 6820 4445 5220   array with DER 
│ │ │ │ -0003a270: 656e 636f 6469 6e67 2e0a 2020 2020 2044  encoding..     D
│ │ │ │ -0003a280: 4552 4c45 4e3a 206c 656e 6774 6820 6f66  ERLEN: length of
│ │ │ │ -0003a290: 2069 6e70 7574 2063 6861 7261 6374 6572   input character
│ │ │ │ -0003a2a0: 2061 7272 6179 2077 6974 6820 4445 5220   array with DER 
│ │ │ │ -0003a2b0: 656e 636f 6469 6e67 2e0a 0a20 2020 2020  encoding...     
│ │ │ │ -0003a2c0: 2a44 6573 6372 6970 7469 6f6e 3a2a 2044  *Description:* D
│ │ │ │ -0003a2d0: 6563 6f64 6520 4445 5220 656e 636f 6469  ecode DER encodi
│ │ │ │ -0003a2e0: 6e67 206f 6620 456e 6341 5052 6570 5061  ng of EncAPRepPa
│ │ │ │ -0003a2f0: 7274 2061 6e64 2063 7265 6174 6520 610a  rt and create a.
│ │ │ │ -0003a300: 2020 2020 2041 534e 2e31 2073 7472 7563       ASN.1 struc
│ │ │ │ -0003a310: 7475 7265 2e0a 0a20 2020 2020 2a52 6574  ture...     *Ret
│ │ │ │ -0003a320: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ -0003a330: 726e 7320 4153 4e2e 3120 7374 7275 6374  rns ASN.1 struct
│ │ │ │ -0003a340: 7572 6520 636f 7272 6573 706f 6e64 696e  ure correspondin
│ │ │ │ -0003a350: 6720 746f 2044 4552 2064 6174 612e 0a0a  g to DER data...
│ │ │ │ -0003a360: 7368 6973 6869 5f64 6572 3261 736e 315f  shishi_der2asn1_
│ │ │ │ -0003a370: 6b64 6372 6571 0a2d 2d2d 2d2d 2d2d 2d2d  kdcreq.---------
│ │ │ │ -0003a380: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -0003a390: 2d2d 2046 756e 6374 696f 6e3a 2053 6869  -- Function: Shi
│ │ │ │ -0003a3a0: 7368 695f 6173 6e31 2073 6869 7368 695f  shi_asn1 shishi_
│ │ │ │ -0003a3b0: 6465 7232 6173 6e31 5f6b 6463 7265 7120  der2asn1_kdcreq 
│ │ │ │ -0003a3c0: 2853 6869 7368 6920 2a20 4841 4e44 4c45  (Shishi * HANDLE
│ │ │ │ -0003a3d0: 2c0a 2020 2020 2020 2020 2020 636f 6e73  ,.          cons
│ │ │ │ -0003a3e0: 7420 6368 6172 202a 2044 4552 2c20 7369  t char * DER, si
│ │ │ │ -0003a3f0: 7a65 5f74 2044 4552 4c45 4e29 0a20 2020  ze_t DERLEN).   
│ │ │ │ -0003a400: 2020 4841 4e44 4c45 3a20 7368 6973 6869    HANDLE: shishi
│ │ │ │ -0003a410: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ -0003a420: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ -0003a430: 695f 696e 6974 2829 e280 992e 0a20 2020  i_init().....   
│ │ │ │ -0003a440: 2020 4445 523a 2069 6e70 7574 2063 6861    DER: input cha
│ │ │ │ -0003a450: 7261 6374 6572 2061 7272 6179 2077 6974  racter array wit
│ │ │ │ -0003a460: 6820 4445 5220 656e 636f 6469 6e67 2e0a  h DER encoding..
│ │ │ │ -0003a470: 2020 2020 2044 4552 4c45 4e3a 206c 656e       DERLEN: len
│ │ │ │ -0003a480: 6774 6820 6f66 2069 6e70 7574 2063 6861  gth of input cha
│ │ │ │ -0003a490: 7261 6374 6572 2061 7272 6179 2077 6974  racter array wit
│ │ │ │ -0003a4a0: 6820 4445 5220 656e 636f 6469 6e67 2e0a  h DER encoding..
│ │ │ │ -0003a4b0: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ -0003a4c0: 6f6e 3a2a 2044 6563 6f64 6520 4445 5220  on:* Decode DER 
│ │ │ │ -0003a4d0: 656e 636f 6469 6e67 206f 6620 4153 2d52  encoding of AS-R
│ │ │ │ -0003a4e0: 4551 2c20 5447 532d 5245 5120 6f72 204b  EQ, TGS-REQ or K
│ │ │ │ -0003a4f0: 4443 2d52 4551 0a20 2020 2020 616e 6420  DC-REQ.     and 
│ │ │ │ -0003a500: 6372 6561 7465 2061 2041 534e 2e31 2073  create a ASN.1 s
│ │ │ │ -0003a510: 7472 7563 7475 7265 2e0a 0a20 2020 2020  tructure...     
│ │ │ │ -0003a520: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ -0003a530: 5265 7475 726e 7320 4153 4e2e 3120 7374  Returns ASN.1 st
│ │ │ │ -0003a540: 7275 6374 7572 6520 636f 7272 6573 706f  ructure correspo
│ │ │ │ -0003a550: 6e64 696e 6720 746f 2044 4552 2064 6174  nding to DER dat
│ │ │ │ -0003a560: 612e 0a0a 7368 6973 6869 5f61 736e 315f  a...shishi_asn1_
│ │ │ │ -0003a570: 7072 696e 740a 2d2d 2d2d 2d2d 2d2d 2d2d  print.----------
│ │ │ │ -0003a580: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ -0003a590: 6374 696f 6e3a 2076 6f69 6420 7368 6973  ction: void shis
│ │ │ │ -0003a5a0: 6869 5f61 736e 315f 7072 696e 7420 2853  hi_asn1_print (S
│ │ │ │ -0003a5b0: 6869 7368 6920 2a20 4841 4e44 4c45 2c20  hishi * HANDLE, 
│ │ │ │ -0003a5c0: 5368 6973 6869 5f61 736e 3120 4e4f 4445  Shishi_asn1 NODE
│ │ │ │ -0003a5d0: 2c0a 2020 2020 2020 2020 2020 4649 4c45  ,.          FILE
│ │ │ │ -0003a5e0: 202a 2046 4829 0a20 2020 2020 4841 4e44   * FH).     HAND
│ │ │ │ -0003a5f0: 4c45 3a20 7368 6973 6869 2068 616e 646c  LE: shishi handl
│ │ │ │ -0003a600: 6520 6173 2061 6c6c 6f63 6174 6564 2062  e as allocated b
│ │ │ │ -0003a610: 7920 e280 9873 6869 7368 695f 696e 6974  y ...shishi_init
│ │ │ │ -0003a620: 2829 e280 992e 0a20 2020 2020 4e4f 4445  ().....     NODE
│ │ │ │ -0003a630: 3a20 4153 4e2e 3120 6461 7461 2074 6861  : ASN.1 data tha
│ │ │ │ -0003a640: 7420 6861 7665 2066 6965 6c64 2074 6f20  t have field to 
│ │ │ │ -0003a650: 6578 7472 6163 742e 0a20 2020 2020 4648  extract..     FH
│ │ │ │ -0003a660: 3a20 6669 6c65 2064 6573 6372 6970 746f  : file descripto
│ │ │ │ -0003a670: 7220 746f 2070 7269 6e74 2074 6f2c 2065  r to print to, e
│ │ │ │ -0003a680: 2e67 2e20 2073 7464 6f75 742e 0a0a 2020  .g.  stdout...  
│ │ │ │ -0003a690: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ -0003a6a0: 2a20 5072 696e 7420 4153 4e2e 3120 7374  * Print ASN.1 st
│ │ │ │ -0003a6b0: 7275 6374 7572 6520 696e 2068 756d 616e  ructure in human
│ │ │ │ -0003a6c0: 2072 6561 6461 626c 6520 666f 726d 2c0a   readable form,.
│ │ │ │ -0003a6d0: 2020 2020 2074 7970 6963 616c 6c79 2066       typically f
│ │ │ │ -0003a6e0: 6f72 2064 6562 7567 6769 6e67 2070 7572  or debugging pur
│ │ │ │ -0003a6f0: 706f 7365 732e 0a0a 1f0a 4669 6c65 3a20  poses.....File: 
│ │ │ │ -0003a700: 7368 6973 6869 2e69 6e66 6f2c 2020 4e6f  shishi.info,  No
│ │ │ │ -0003a710: 6465 3a20 4572 726f 7220 4861 6e64 6c69  de: Error Handli
│ │ │ │ -0003a720: 6e67 2c20 204e 6578 743a 2045 7861 6d70  ng,  Next: Examp
│ │ │ │ -0003a730: 6c65 732c 2020 5072 6576 3a20 4153 4e2e  les,  Prev: ASN.
│ │ │ │ -0003a740: 3120 4675 6e63 7469 6f6e 732c 2020 5570  1 Functions,  Up
│ │ │ │ -0003a750: 3a20 5072 6f67 7261 6d6d 696e 6720 4d61  : Programming Ma
│ │ │ │ -0003a760: 6e75 616c 0a0a 352e 3137 2045 7272 6f72  nual..5.17 Error
│ │ │ │ -0003a770: 2048 616e 646c 696e 670a 3d3d 3d3d 3d3d   Handling.======
│ │ │ │ -0003a780: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a4d  =============..M
│ │ │ │ -0003a790: 6f73 7420 6675 6e63 7469 6f6e 7320 696e  ost functions in
│ │ │ │ -0003a7a0: 2027 4c69 6273 6869 7368 6927 2061 7265   'Libshishi' are
│ │ │ │ -0003a7b0: 2072 6574 7572 6e69 6e67 2061 6e20 6572   returning an er
│ │ │ │ -0003a7c0: 726f 7220 6966 2074 6865 7920 6661 696c  ror if they fail
│ │ │ │ -0003a7d0: 2e20 2046 6f72 0a74 6869 7320 7265 6173  .  For.this reas
│ │ │ │ -0003a7e0: 6f6e 2c20 7468 6520 6170 706c 6963 6174  on, the applicat
│ │ │ │ -0003a7f0: 696f 6e20 7368 6f75 6c64 2061 6c77 6179  ion should alway
│ │ │ │ -0003a800: 7320 6361 7463 6820 7468 6520 6572 726f  s catch the erro
│ │ │ │ -0003a810: 7220 636f 6e64 6974 696f 6e20 616e 640a  r condition and.
│ │ │ │ -0003a820: 7461 6b65 2061 7070 726f 7072 6961 7465  take appropriate
│ │ │ │ -0003a830: 206d 6561 7375 7265 732c 2066 6f72 2065   measures, for e
│ │ │ │ -0003a840: 7861 6d70 6c65 2062 7920 7265 6c65 6173  xample by releas
│ │ │ │ -0003a850: 696e 6720 7468 6520 7265 736f 7572 6365  ing the resource
│ │ │ │ -0003a860: 7320 616e 640a 7061 7373 696e 6720 7468  s and.passing th
│ │ │ │ -0003a870: 6520 6572 726f 7220 7570 2074 6f20 7468  e error up to th
│ │ │ │ -0003a880: 6520 6361 6c6c 6572 2c20 6f72 2062 7920  e caller, or by 
│ │ │ │ -0003a890: 6469 7370 6c61 7969 6e67 2061 2064 6573  displaying a des
│ │ │ │ -0003a8a0: 6372 6970 7469 7665 0a6d 6573 7361 6765  criptive.message
│ │ │ │ -0003a8b0: 2074 6f20 7468 6520 7573 6572 2061 6e64   to the user and
│ │ │ │ -0003a8c0: 2063 616e 6365 6c6c 696e 6720 7468 6520   cancelling the 
│ │ │ │ -0003a8d0: 6f70 6572 6174 696f 6e2e 0a0a 2020 2053  operation...   S
│ │ │ │ -0003a8e0: 6f6d 6520 6572 726f 7220 7661 6c75 6573  ome error values
│ │ │ │ -0003a8f0: 2064 6f20 6e6f 7420 696e 6469 6361 7465   do not indicate
│ │ │ │ -0003a900: 2061 2073 7973 7465 6d20 6572 726f 7220   a system error 
│ │ │ │ -0003a910: 6f72 2061 6e20 6572 726f 7220 696e 2074  or an error in t
│ │ │ │ -0003a920: 6865 0a6f 7065 7261 7469 6f6e 2c20 6275  he.operation, bu
│ │ │ │ -0003a930: 7420 7468 6520 7265 7375 6c74 206f 6620  t the result of 
│ │ │ │ -0003a940: 616e 206f 7065 7261 7469 6f6e 2074 6861  an operation tha
│ │ │ │ -0003a950: 7420 6661 696c 6564 2070 726f 7065 726c  t failed properl
│ │ │ │ -0003a960: 792e 0a0a 2a20 4d65 6e75 3a0a 0a2a 2045  y...* Menu:..* E
│ │ │ │ -0003a970: 7272 6f72 2056 616c 7565 733a 3a20 2020  rror Values::   
│ │ │ │ -0003a980: 2020 2020 2020 2020 2020 2020 2041 206c               A l
│ │ │ │ -0003a990: 6973 7420 6f66 2061 6c6c 2065 7272 6f72  ist of all error
│ │ │ │ -0003a9a0: 2076 616c 7565 7320 7573 6564 2e0a 2a20   values used..* 
│ │ │ │ -0003a9b0: 4572 726f 7220 4675 6e63 7469 6f6e 733a  Error Functions:
│ │ │ │ -0003a9c0: 3a20 2020 2020 2020 2020 2020 2020 4572  :             Er
│ │ │ │ -0003a9d0: 726f 7220 6861 6e64 6c69 6e67 2072 656c  ror handling rel
│ │ │ │ -0003a9e0: 6174 6564 2066 756e 6374 696f 6e73 2e0a  ated functions..
│ │ │ │ -0003a9f0: 0a1f 0a46 696c 653a 2073 6869 7368 692e  ...File: shishi.
│ │ │ │ -0003aa00: 696e 666f 2c20 204e 6f64 653a 2045 7272  info,  Node: Err
│ │ │ │ -0003aa10: 6f72 2056 616c 7565 732c 2020 4e65 7874  or Values,  Next
│ │ │ │ -0003aa20: 3a20 4572 726f 7220 4675 6e63 7469 6f6e  : Error Function
│ │ │ │ -0003aa30: 732c 2020 5570 3a20 4572 726f 7220 4861  s,  Up: Error Ha
│ │ │ │ -0003aa40: 6e64 6c69 6e67 0a0a 352e 3137 2e31 2045  ndling..5.17.1 E
│ │ │ │ -0003aa50: 7272 6f72 2056 616c 7565 730a 2d2d 2d2d  rror Values.----
│ │ │ │ -0003aa60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -0003aa70: 0a45 7272 6f72 7320 6172 6520 7265 7475  .Errors are retu
│ │ │ │ -0003aa80: 726e 6564 2061 7320 616e 20e2 8098 696e  rned as an ...in
│ │ │ │ -0003aa90: 74e2 8099 2e20 2045 7863 6570 7420 666f  t....  Except fo
│ │ │ │ -0003aaa0: 7220 7468 6520 5348 4953 4849 5f4f 4b20  r the SHISHI_OK 
│ │ │ │ -0003aab0: 6361 7365 2c20 616e 0a61 7070 6c69 6361  case, an.applica
│ │ │ │ -0003aac0: 7469 6f6e 2073 686f 756c 6420 616c 7761  tion should alwa
│ │ │ │ -0003aad0: 7973 2075 7365 2074 6865 2063 6f6e 7374  ys use the const
│ │ │ │ -0003aae0: 616e 7473 2069 6e73 7465 6164 206f 6620  ants instead of 
│ │ │ │ -0003aaf0: 7468 6569 7220 6e75 6d65 7269 630a 7661  their numeric.va
│ │ │ │ -0003ab00: 6c75 652e 2020 4170 706c 6963 6174 696f  lue.  Applicatio
│ │ │ │ -0003ab10: 6e73 2061 7265 2065 6e63 6f75 7261 6765  ns are encourage
│ │ │ │ -0003ab20: 6420 746f 2075 7365 2074 6865 2063 6f6e  d to use the con
│ │ │ │ -0003ab30: 7374 616e 7473 2065 7665 6e20 666f 720a  stants even for.
│ │ │ │ -0003ab40: 5348 4953 4849 5f4f 4b20 6173 2069 7420  SHISHI_OK as it 
│ │ │ │ -0003ab50: 696d 7072 6f76 6573 2072 6561 6461 6269  improves readabi
│ │ │ │ -0003ab60: 6c69 7479 2e20 2050 6f73 7369 626c 6520  lity.  Possible 
│ │ │ │ -0003ab70: 7661 6c75 6573 2061 7265 3a0a 0ae2 8098  values are:.....
│ │ │ │ -0003ab80: 5348 4953 4849 5f4f 4be2 8099 0a20 2020  SHISHI_OK....   
│ │ │ │ -0003ab90: 2020 5468 6973 2076 616c 7565 2069 6e64    This value ind
│ │ │ │ -0003aba0: 6963 6174 6573 2073 7563 6365 7373 2e20  icates success. 
│ │ │ │ -0003abb0: 2054 6865 2076 616c 7565 206f 6620 7468   The value of th
│ │ │ │ -0003abc0: 6973 2065 7272 6f72 2069 730a 2020 2020  is error is.    
│ │ │ │ -0003abd0: 2067 7561 7261 6e74 6565 6420 746f 2061   guaranteed to a
│ │ │ │ -0003abe0: 6c77 6179 7320 6265 20e2 8098 30e2 8099  lways be ...0...
│ │ │ │ -0003abf0: 2073 6f20 796f 7520 6d61 7920 7573 6520   so you may use 
│ │ │ │ -0003ac00: 6974 2069 6e20 626f 6f6c 6561 6e0a 2020  it in boolean.  
│ │ │ │ -0003ac10: 2020 2063 6f6e 7374 7275 6374 732e 0a0a     constructs...
│ │ │ │ -0003ac20: e280 9853 4849 5348 495f 4153 4e31 5f45  ...SHISHI_ASN1_E
│ │ │ │ -0003ac30: 5252 4f52 e280 990a 2020 2020 2045 7272  RROR....     Err
│ │ │ │ -0003ac40: 6f72 2069 6e20 4153 4e2e 3120 6675 6e63  or in ASN.1 func
│ │ │ │ -0003ac50: 7469 6f6e 2e20 2028 636f 7272 7570 7420  tion.  (corrupt 
│ │ │ │ -0003ac60: 6461 7461 3f29 0a0a e280 9853 4849 5348  data?).....SHISH
│ │ │ │ -0003ac70: 495f 464f 5045 4e5f 4552 524f 52e2 8099  I_FOPEN_ERROR...
│ │ │ │ -0003ac80: 0a20 2020 2020 436f 756c 6420 6e6f 7420  .     Could not 
│ │ │ │ -0003ac90: 6f70 656e 2066 696c 652e 0a0a e280 9853  open file......S
│ │ │ │ -0003aca0: 4849 5348 495f 494f 5f45 5252 4f52 e280  HISHI_IO_ERROR..
│ │ │ │ -0003acb0: 990a 2020 2020 2046 696c 6520 696e 7075  ..     File inpu
│ │ │ │ -0003acc0: 742f 6f75 7470 7574 2065 7272 6f72 2e0a  t/output error..
│ │ │ │ -0003acd0: 0ae2 8098 5348 4953 4849 5f4d 414c 4c4f  ....SHISHI_MALLO
│ │ │ │ -0003ace0: 435f 4552 524f 52e2 8099 0a20 2020 2020  C_ERROR....     
│ │ │ │ -0003acf0: 4d65 6d6f 7279 2061 6c6c 6f63 6174 696f  Memory allocatio
│ │ │ │ -0003ad00: 6e20 6572 726f 7220 696e 2073 6869 7368  n error in shish
│ │ │ │ -0003ad10: 6920 6c69 6272 6172 792e 0a0a e280 9853  i library......S
│ │ │ │ -0003ad20: 4849 5348 495f 4241 5345 3634 5f45 5252  HISHI_BASE64_ERR
│ │ │ │ -0003ad30: 4f52 e280 990a 2020 2020 2042 6173 6536  OR....     Base6
│ │ │ │ -0003ad40: 3420 656e 636f 6469 6e67 206f 7220 6465  4 encoding or de
│ │ │ │ -0003ad50: 636f 6469 6e67 2066 6169 6c65 642e 2020  coding failed.  
│ │ │ │ -0003ad60: 4461 7461 2063 6f72 7275 7074 3f0a 0ae2  Data corrupt?...
│ │ │ │ -0003ad70: 8098 5348 4953 4849 5f52 4541 4c4d 5f4d  ..SHISHI_REALM_M
│ │ │ │ -0003ad80: 4953 4d41 5443 48e2 8099 0a20 2020 2020  ISMATCH....     
│ │ │ │ -0003ad90: 436c 6965 6e74 2072 6561 6c6d 2076 616c  Client realm val
│ │ │ │ -0003ada0: 7565 2064 6966 6665 7220 6265 7477 6565  ue differ betwee
│ │ │ │ -0003adb0: 6e20 7265 7175 6573 7420 616e 6420 7265  n request and re
│ │ │ │ -0003adc0: 706c 792e 0a0a e280 9853 4849 5348 495f  ply......SHISHI_
│ │ │ │ -0003add0: 434e 414d 455f 4d49 534d 4154 4348 e280  CNAME_MISMATCH..
│ │ │ │ -0003ade0: 990a 2020 2020 2043 6c69 656e 7420 6e61  ..     Client na
│ │ │ │ -0003adf0: 6d65 2076 616c 7565 2064 6966 6665 7220  me value differ 
│ │ │ │ -0003ae00: 6265 7477 6565 6e20 7265 7175 6573 7420  between request 
│ │ │ │ -0003ae10: 616e 6420 7265 706c 792e 0a0a e280 9853  and reply......S
│ │ │ │ -0003ae20: 4849 5348 495f 4e4f 4e43 455f 4d49 534d  HISHI_NONCE_MISM
│ │ │ │ -0003ae30: 4154 4348 e280 990a 2020 2020 2052 6570  ATCH....     Rep
│ │ │ │ -0003ae40: 6c61 7920 7072 6f74 6563 7469 6f6e 2076  lay protection v
│ │ │ │ -0003ae50: 616c 7565 2028 6e6f 6e63 6529 2064 6966  alue (nonce) dif
│ │ │ │ -0003ae60: 6665 7220 6265 7477 6565 6e20 7265 7175  fer between requ
│ │ │ │ -0003ae70: 6573 7420 616e 6420 7265 706c 792e 0a0a  est and reply...
│ │ │ │ -0003ae80: e280 9853 4849 5348 495f 5447 5352 4550  ...SHISHI_TGSREP
│ │ │ │ -0003ae90: 5f42 4144 5f4b 4559 5459 5045 e280 990a  _BAD_KEYTYPE....
│ │ │ │ -0003aea0: 2020 2020 2049 6e63 6f72 7265 6374 206b       Incorrect k
│ │ │ │ -0003aeb0: 6579 2074 7970 6520 7573 6564 2069 6e20  ey type used in 
│ │ │ │ -0003aec0: 5447 5320 7265 706c 792e 0a0a e280 9853  TGS reply......S
│ │ │ │ -0003aed0: 4849 5348 495f 4b44 4352 4550 5f42 4144  HISHI_KDCREP_BAD
│ │ │ │ -0003aee0: 5f4b 4559 5459 5045 e280 990a 2020 2020  _KEYTYPE....    
│ │ │ │ -0003aef0: 2049 6e63 6f72 7265 6374 206b 6579 2074   Incorrect key t
│ │ │ │ -0003af00: 7970 6520 7573 6564 2069 6e20 7265 706c  ype used in repl
│ │ │ │ -0003af10: 7920 6672 6f6d 204b 4443 2e0a 0ae2 8098  y from KDC......
│ │ │ │ -0003af20: 5348 4953 4849 5f41 5052 4550 5f42 4144  SHISHI_APREP_BAD
│ │ │ │ -0003af30: 5f4b 4559 5459 5045 e280 990a 2020 2020  _KEYTYPE....    
│ │ │ │ -0003af40: 2049 6e63 6f72 7265 6374 206b 6579 2074   Incorrect key t
│ │ │ │ -0003af50: 7970 6520 7573 6564 2069 6e20 4150 2072  ype used in AP r
│ │ │ │ -0003af60: 6570 6c79 2e0a 0ae2 8098 5348 4953 4849  eply......SHISHI
│ │ │ │ -0003af70: 5f41 5052 4550 5f56 4552 4946 595f 4641  _APREP_VERIFY_FA
│ │ │ │ -0003af80: 494c 4544 e280 990a 2020 2020 2046 6169  ILED....     Fai
│ │ │ │ -0003af90: 6c65 6420 7665 7269 6669 6361 7469 6f6e  led verification
│ │ │ │ -0003afa0: 206f 6620 4150 2072 6570 6c79 2e0a 0ae2   of AP reply....
│ │ │ │ -0003afb0: 8098 5348 4953 4849 5f41 5052 4551 5f42  ..SHISHI_APREQ_B
│ │ │ │ -0003afc0: 4144 5f4b 4559 5459 5045 e280 990a 2020  AD_KEYTYPE....  
│ │ │ │ -0003afd0: 2020 2049 6e63 6f72 7265 6374 206b 6579     Incorrect key
│ │ │ │ -0003afe0: 2074 7970 6520 7573 6564 2069 6e20 4150   type used in AP
│ │ │ │ -0003aff0: 2072 6571 7565 7374 2e0a 0ae2 8098 5348   request......SH
│ │ │ │ -0003b000: 4953 4849 5f54 4f4f 5f53 4d41 4c4c 5f42  ISHI_TOO_SMALL_B
│ │ │ │ -0003b010: 5546 4645 52e2 8099 0a20 2020 2020 5072  UFFER....     Pr
│ │ │ │ -0003b020: 6f76 6964 6564 2062 7566 6665 7220 7761  ovided buffer wa
│ │ │ │ -0003b030: 7320 746f 6f20 736d 616c 6c2e 0a0a e280  s too small.....
│ │ │ │ -0003b040: 9853 4849 5348 495f 4445 5249 5645 444b  .SHISHI_DERIVEDK
│ │ │ │ -0003b050: 4559 5f54 4f4f 5f53 4d41 4c4c e280 990a  EY_TOO_SMALL....
│ │ │ │ -0003b060: 2020 2020 2044 6572 6976 6564 206b 6579       Derived key
│ │ │ │ -0003b070: 206d 6174 6572 6961 6c20 6973 2074 6f6f   material is too
│ │ │ │ -0003b080: 2073 686f 7274 2074 6f20 6265 2061 7070   short to be app
│ │ │ │ -0003b090: 6c69 6361 626c 652e 0a0a e280 9853 4849  licable......SHI
│ │ │ │ -0003b0a0: 5348 495f 4b45 595f 544f 4f5f 4c41 5247  SHI_KEY_TOO_LARG
│ │ │ │ -0003b0b0: 45e2 8099 0a20 2020 2020 5468 6520 6b65  E....     The ke
│ │ │ │ -0003b0c0: 7920 6973 2074 6f6f 206c 6172 6765 2074  y is too large t
│ │ │ │ -0003b0d0: 6f20 6265 2075 7361 626c 652e 0a0a e280  o be usable.....
│ │ │ │ -0003b0e0: 9853 4849 5348 495f 4352 5950 544f 5f45  .SHISHI_CRYPTO_E
│ │ │ │ -0003b0f0: 5252 4f52 e280 990a 2020 2020 204c 6f77  RROR....     Low
│ │ │ │ -0003b100: 2d6c 6576 656c 2063 7279 7074 6f67 7261  -level cryptogra
│ │ │ │ -0003b110: 7068 6963 2070 7269 6d69 7469 7665 2066  phic primitive f
│ │ │ │ -0003b120: 6169 6c65 642e 2020 5468 6973 2075 7375  ailed.  This usu
│ │ │ │ -0003b130: 616c 6c79 2069 6e64 6963 6174 6573 0a20  ally indicates. 
│ │ │ │ -0003b140: 2020 2020 6261 6420 7061 7373 776f 7264      bad password
│ │ │ │ -0003b150: 206f 7220 6461 7461 2063 6f72 7275 7074   or data corrupt
│ │ │ │ -0003b160: 696f 6e2e 0a0a e280 9853 4849 5348 495f  ion......SHISHI_
│ │ │ │ -0003b170: 4352 5950 544f 5f49 4e54 4552 4e41 4c5f  CRYPTO_INTERNAL_
│ │ │ │ -0003b180: 4552 524f 52e2 8099 0a20 2020 2020 496e  ERROR....     In
│ │ │ │ -0003b190: 7465 726e 616c 2065 7272 6f72 2069 6e20  ternal error in 
│ │ │ │ -0003b1a0: 6c6f 772d 6c65 7665 6c20 6372 7970 746f  low-level crypto
│ │ │ │ -0003b1b0: 2072 6f75 7469 6e65 732e 0a0a e280 9853   routines......S
│ │ │ │ -0003b1c0: 4849 5348 495f 534f 434b 4554 5f45 5252  HISHI_SOCKET_ERR
│ │ │ │ -0003b1d0: 4f52 e280 990a 2020 2020 2054 6865 2073  OR....     The s
│ │ │ │ -0003b1e0: 7973 7465 6d20 6361 6c6c 2073 6f63 6b65  ystem call socke
│ │ │ │ -0003b1f0: 7428 2920 6661 696c 6564 2e20 2054 6869  t() failed.  Thi
│ │ │ │ -0003b200: 7320 7573 7561 6c6c 7920 696e 6469 6361  s usually indica
│ │ │ │ -0003b210: 7465 7320 7468 6174 2079 6f75 720a 2020  tes that your.  
│ │ │ │ -0003b220: 2020 2073 7973 7465 6d20 646f 6573 206e     system does n
│ │ │ │ -0003b230: 6f74 2073 7570 706f 7274 2074 6865 2073  ot support the s
│ │ │ │ -0003b240: 6f63 6b65 7420 7479 7065 2e0a 0ae2 8098  ocket type......
│ │ │ │ -0003b250: 5348 4953 4849 5f42 494e 445f 4552 524f  SHISHI_BIND_ERRO
│ │ │ │ -0003b260: 52e2 8099 0a20 2020 2020 5468 6520 7379  R....     The sy
│ │ │ │ -0003b270: 7374 656d 2063 616c 6c20 6269 6e64 2829  stem call bind()
│ │ │ │ -0003b280: 2066 6169 6c65 642e 2020 5468 6973 2075   failed.  This u
│ │ │ │ -0003b290: 7375 616c 6c79 2069 6e64 6963 6174 6573  sually indicates
│ │ │ │ -0003b2a0: 2069 6e73 7566 6669 6369 656e 740a 2020   insufficient.  
│ │ │ │ -0003b2b0: 2020 2070 6572 6d69 7373 696f 6e73 2e0a     permissions..
│ │ │ │ -0003b2c0: 0ae2 8098 5348 4953 4849 5f53 454e 4454  ....SHISHI_SENDT
│ │ │ │ -0003b2d0: 4f5f 4552 524f 52e2 8099 0a20 2020 2020  O_ERROR....     
│ │ │ │ -0003b2e0: 5468 6520 7379 7374 656d 2063 616c 6c20  The system call 
│ │ │ │ -0003b2f0: 7365 6e64 746f 2829 2066 6169 6c65 642e  sendto() failed.
│ │ │ │ -0003b300: 0a0a e280 9853 4849 5348 495f 5245 4356  .....SHISHI_RECV
│ │ │ │ -0003b310: 4652 4f4d 5f45 5252 4f52 e280 990a 2020  FROM_ERROR....  
│ │ │ │ -0003b320: 2020 2045 7272 6f72 2072 6563 6569 7669     Error receivi
│ │ │ │ -0003b330: 6e67 2064 6174 6120 6672 6f6d 2073 6572  ng data from ser
│ │ │ │ -0003b340: 7665 722e 0a0a e280 9853 4849 5348 495f  ver......SHISHI_
│ │ │ │ -0003b350: 434c 4f53 455f 4552 524f 52e2 8099 0a20  CLOSE_ERROR.... 
│ │ │ │ -0003b360: 2020 2020 5468 6520 7379 7374 656d 2063      The system c
│ │ │ │ -0003b370: 616c 6c20 636c 6f73 6528 2920 6661 696c  all close() fail
│ │ │ │ -0003b380: 6564 2e0a 0ae2 8098 5348 4953 4849 5f4b  ed......SHISHI_K
│ │ │ │ -0003b390: 4443 5f54 494d 454f 5554 e280 990a 2020  DC_TIMEOUT....  
│ │ │ │ -0003b3a0: 2020 2054 696d 6564 206f 7574 2074 616c     Timed out tal
│ │ │ │ -0003b3b0: 6b69 6e67 2074 6f20 4b44 432e 2054 6869  king to KDC. Thi
│ │ │ │ -0003b3c0: 7320 7573 7561 6c6c 7920 696e 6469 6361  s usually indica
│ │ │ │ -0003b3d0: 7465 7320 6120 6e65 7477 6f72 6b20 6f72  tes a network or
│ │ │ │ -0003b3e0: 204b 4443 0a20 2020 2020 6164 6472 6573   KDC.     addres
│ │ │ │ -0003b3f0: 7320 7072 6f62 6c65 6d2e 0a0a e280 9853  s problem......S
│ │ │ │ -0003b400: 4849 5348 495f 4b44 435f 4e4f 545f 4b4e  HISHI_KDC_NOT_KN
│ │ │ │ -0003b410: 4f57 4e5f 464f 525f 5245 414c 4de2 8099  OWN_FOR_REALM...
│ │ │ │ -0003b420: 0a20 2020 2020 4e6f 204b 4443 206b 6e6f  .     No KDC kno
│ │ │ │ -0003b430: 776e 2066 6f72 2067 6976 656e 2072 6561  wn for given rea
│ │ │ │ -0003b440: 6c6d 2e0a 0ae2 8098 5348 4953 4849 5f54  lm......SHISHI_T
│ │ │ │ -0003b450: 5459 5f45 5252 4f52 e280 990a 2020 2020  TY_ERROR....    
│ │ │ │ -0003b460: 204e 6f20 5454 5920 6173 7369 676e 6564   No TTY assigned
│ │ │ │ -0003b470: 2074 6f20 7072 6f63 6573 732e 0a0a e280   to process.....
│ │ │ │ -0003b480: 9853 4849 5348 495f 474f 545f 4b52 4245  .SHISHI_GOT_KRBE
│ │ │ │ -0003b490: 5252 4f52 e280 990a 2020 2020 2053 6572  RROR....     Ser
│ │ │ │ -0003b4a0: 7665 7220 7265 706c 6965 6420 746f 2074  ver replied to t
│ │ │ │ -0003b4b0: 6865 2072 6571 7565 7374 2077 6974 6820  he request with 
│ │ │ │ -0003b4c0: 616e 2065 7272 6f72 206d 6573 7361 6765  an error message
│ │ │ │ -0003b4d0: 2e0a 0ae2 8098 5348 4953 4849 5f48 414e  ......SHISHI_HAN
│ │ │ │ -0003b4e0: 444c 455f 4552 524f 52e2 8099 0a20 2020  DLE_ERROR....   
│ │ │ │ -0003b4f0: 2020 4661 696c 7572 6520 746f 2075 7365    Failure to use
│ │ │ │ -0003b500: 2068 616e 646c 652e 2020 4d69 7373 696e   handle.  Missin
│ │ │ │ -0003b510: 6720 6861 6e64 6c65 2c20 6f72 206d 6973  g handle, or mis
│ │ │ │ -0003b520: 636f 6e66 6967 7572 6564 2e0a 0ae2 8098  configured......
│ │ │ │ -0003b530: 5348 4953 4849 5f49 4e56 414c 4944 5f54  SHISHI_INVALID_T
│ │ │ │ -0003b540: 4b54 53e2 8099 0a20 2020 2020 5469 636b  KTS....     Tick
│ │ │ │ -0003b550: 6574 2073 6574 206e 6f74 2069 6e69 7469  et set not initi
│ │ │ │ -0003b560: 616c 697a 6564 2e20 2054 6869 7320 7573  alized.  This us
│ │ │ │ -0003b570: 7561 6c6c 7920 696e 6469 6361 7465 7320  ually indicates 
│ │ │ │ -0003b580: 616e 2069 6e74 6572 6e61 6c0a 2020 2020  an internal.    
│ │ │ │ -0003b590: 2061 7070 6c69 6361 7469 6f6e 2065 7272   application err
│ │ │ │ -0003b5a0: 6f72 2e0a 0ae2 8098 5348 4953 4849 5f54  or......SHISHI_T
│ │ │ │ -0003b5b0: 4943 4b45 545f 4241 445f 4b45 5954 5950  ICKET_BAD_KEYTYP
│ │ │ │ -0003b5c0: 45e2 8099 0a20 2020 2020 4b65 7920 7479  E....     Key ty
│ │ │ │ -0003b5d0: 7065 2075 7365 6420 746f 2065 6e63 7279  pe used to encry
│ │ │ │ -0003b5e0: 7074 2074 6963 6b65 7420 646f 6573 6e27  pt ticket doesn'
│ │ │ │ -0003b5f0: 7420 6d61 7463 6820 7072 6f76 6964 6564  t match provided
│ │ │ │ -0003b600: 206b 6579 2e20 2054 6869 730a 2020 2020   key.  This.    
│ │ │ │ -0003b610: 2075 7375 616c 6c79 2069 6e64 6963 6174   usually indicat
│ │ │ │ -0003b620: 6573 2061 6e20 696e 7465 726e 616c 2061  es an internal a
│ │ │ │ -0003b630: 7070 6c69 6361 7469 6f6e 2065 7272 6f72  pplication error
│ │ │ │ -0003b640: 2e0a 0ae2 8098 5348 4953 4849 5f49 4e56  ......SHISHI_INV
│ │ │ │ -0003b650: 414c 4944 5f4b 4559 e280 990a 2020 2020  ALID_KEY....    
│ │ │ │ -0003b660: 2052 6566 6572 656e 6365 2074 6f20 696e   Reference to in
│ │ │ │ -0003b670: 7661 6c69 6420 656e 6372 7970 7469 6f6e  valid encryption
│ │ │ │ -0003b680: 206b 6579 2e0a 0ae2 8098 5348 4953 4849   key......SHISHI
│ │ │ │ -0003b690: 5f41 5052 4551 5f44 4543 5259 5054 5f46  _APREQ_DECRYPT_F
│ │ │ │ -0003b6a0: 4149 4c45 44e2 8099 0a20 2020 2020 436f  AILED....     Co
│ │ │ │ -0003b6b0: 756c 6420 6e6f 7420 6465 6372 7970 7420  uld not decrypt 
│ │ │ │ -0003b6c0: 4150 2d52 4551 2075 7369 6e67 2070 726f  AP-REQ using pro
│ │ │ │ -0003b6d0: 7669 6465 6420 6b65 792e 2020 5468 6973  vided key.  This
│ │ │ │ -0003b6e0: 2075 7375 616c 6c79 0a20 2020 2020 696e   usually.     in
│ │ │ │ -0003b6f0: 6469 6361 7465 7320 616e 2069 6e74 6572  dicates an inter
│ │ │ │ -0003b700: 6e61 6c20 6170 706c 6963 6174 696f 6e20  nal application 
│ │ │ │ -0003b710: 6572 726f 722e 0a0a e280 9853 4849 5348  error......SHISH
│ │ │ │ -0003b720: 495f 5449 434b 4554 5f44 4543 5259 5054  I_TICKET_DECRYPT
│ │ │ │ -0003b730: 5f46 4149 4c45 44e2 8099 0a20 2020 2020  _FAILED....     
│ │ │ │ -0003b740: 436f 756c 6420 6e6f 7420 6465 6372 7970  Could not decryp
│ │ │ │ -0003b750: 7420 5469 636b 6574 2075 7369 6e67 2070  t Ticket using p
│ │ │ │ -0003b760: 726f 7669 6465 6420 6b65 792e 2020 5468  rovided key.  Th
│ │ │ │ -0003b770: 6973 2075 7375 616c 6c79 0a20 2020 2020  is usually.     
│ │ │ │ -0003b780: 696e 6469 6361 7465 7320 616e 2069 6e74  indicates an int
│ │ │ │ -0003b790: 6572 6e61 6c20 6170 706c 6963 6174 696f  ernal applicatio
│ │ │ │ -0003b7a0: 6e20 6572 726f 722e 0a0a e280 9853 4849  n error......SHI
│ │ │ │ -0003b7b0: 5348 495f 494e 5641 4c49 445f 5449 434b  SHI_INVALID_TICK
│ │ │ │ -0003b7c0: 4554 e280 990a 2020 2020 2049 6e76 616c  ET....     Inval
│ │ │ │ -0003b7d0: 6964 2074 6963 6b65 6420 7061 7373 6564  id ticked passed
│ │ │ │ -0003b7e0: 2069 6e20 6361 6c6c 2e0a 0ae2 8098 5348   in call......SH
│ │ │ │ -0003b7f0: 4953 4849 5f4f 5554 5f4f 465f 5241 4e47  ISHI_OUT_OF_RANG
│ │ │ │ -0003b800: 45e2 8099 0a20 2020 2020 4172 6775 6d65  E....     Argume
│ │ │ │ -0003b810: 6e74 206c 6965 7320 6f75 7473 6964 6520  nt lies outside 
│ │ │ │ -0003b820: 6f66 2076 616c 6964 2072 616e 6765 2e0a  of valid range..
│ │ │ │ -0003b830: 0ae2 8098 5348 4953 4849 5f41 534e 315f  ....SHISHI_ASN1_
│ │ │ │ -0003b840: 4e4f 5f45 4c45 4d45 4e54 e280 990a 2020  NO_ELEMENT....  
│ │ │ │ -0003b850: 2020 2054 6865 2041 534e 2e31 2073 7472     The ASN.1 str
│ │ │ │ -0003b860: 7563 7475 7265 2064 6f65 7320 6e6f 7420  ucture does not 
│ │ │ │ -0003b870: 636f 6e74 6169 6e20 7468 6520 696e 6469  contain the indi
│ │ │ │ -0003b880: 6361 7465 6420 656c 656d 656e 742e 0a0a  cated element...
│ │ │ │ -0003b890: e280 9853 4849 5348 495f 5341 4645 5f42  ...SHISHI_SAFE_B
│ │ │ │ -0003b8a0: 4144 5f4b 4559 5459 5045 e280 990a 2020  AD_KEYTYPE....  
│ │ │ │ -0003b8b0: 2020 2041 7474 656d 7074 6564 2061 6363     Attempted acc
│ │ │ │ -0003b8c0: 6573 7320 746f 206e 6f6e 2d65 7869 7374  ess to non-exist
│ │ │ │ -0003b8d0: 656e 7420 6b65 7920 7479 7065 2e0a 0ae2  ent key type....
│ │ │ │ -0003b8e0: 8098 5348 4953 4849 5f53 4146 455f 5645  ..SHISHI_SAFE_VE
│ │ │ │ -0003b8f0: 5249 4659 5f46 4149 4c45 44e2 8099 0a20  RIFY_FAILED.... 
│ │ │ │ -0003b900: 2020 2020 5665 7269 6669 6361 7469 6f6e      Verification
│ │ │ │ -0003b910: 2066 6169 6c65 6420 6f6e 2065 6974 6865   failed on eithe
│ │ │ │ -0003b920: 7220 7369 6465 2e0a 0ae2 8098 5348 4953  r side......SHIS
│ │ │ │ -0003b930: 4849 5f50 4b43 5335 5f49 4e56 414c 4944  HI_PKCS5_INVALID
│ │ │ │ -0003b940: 5f50 5246 e280 990a 2020 2020 2049 6e76  _PRF....     Inv
│ │ │ │ -0003b950: 616c 6964 2050 4b43 5335 2064 6573 6372  alid PKCS5 descr
│ │ │ │ -0003b960: 6970 746f 722e 0a0a e280 9853 4849 5348  iptor......SHISH
│ │ │ │ -0003b970: 495f 504b 4353 355f 494e 5641 4c49 445f  I_PKCS5_INVALID_
│ │ │ │ -0003b980: 4954 4552 4154 494f 4e5f 434f 554e 54e2  ITERATION_COUNT.
│ │ │ │ -0003b990: 8099 0a20 2020 2020 496e 7661 6c69 6420  ...     Invalid 
│ │ │ │ -0003b9a0: 636c 6169 6d20 6f66 2069 7465 7261 7469  claim of iterati
│ │ │ │ -0003b9b0: 6f6e 2063 6f75 6e74 2069 6e20 504b 4353  on count in PKCS
│ │ │ │ -0003b9c0: 3520 6465 7363 7269 7074 6f72 2e0a 0ae2  5 descriptor....
│ │ │ │ -0003b9d0: 8098 5348 4953 4849 5f50 4b43 5335 5f49  ..SHISHI_PKCS5_I
│ │ │ │ -0003b9e0: 4e56 414c 4944 5f44 4552 4956 4544 5f4b  NVALID_DERIVED_K
│ │ │ │ -0003b9f0: 4559 5f4c 454e 4754 48e2 8099 0a20 2020  EY_LENGTH....   
│ │ │ │ -0003ba00: 2020 4465 7269 7665 6420 6b65 7920 6c65    Derived key le
│ │ │ │ -0003ba10: 6e67 7468 2069 7320 696e 636f 7272 6563  ngth is incorrec
│ │ │ │ -0003ba20: 7420 666f 7220 504b 4353 3520 6465 7363  t for PKCS5 desc
│ │ │ │ -0003ba30: 7269 7074 6f72 2e0a 0ae2 8098 5348 4953  riptor......SHIS
│ │ │ │ -0003ba40: 4849 5f50 4b43 5335 5f44 4552 4956 4544  HI_PKCS5_DERIVED
│ │ │ │ -0003ba50: 5f4b 4559 5f54 4f4f 5f4c 4f4e 47e2 8099  _KEY_TOO_LONG...
│ │ │ │ -0003ba60: 0a20 2020 2020 4465 7269 7665 6420 6b65  .     Derived ke
│ │ │ │ -0003ba70: 7920 6973 2074 6f6f 206c 6f6e 6720 666f  y is too long fo
│ │ │ │ -0003ba80: 7220 504b 4353 3520 6465 7363 7269 7074  r PKCS5 descript
│ │ │ │ -0003ba90: 6f72 2e0a 0ae2 8098 5348 4953 4849 5f49  or......SHISHI_I
│ │ │ │ -0003baa0: 4e56 414c 4944 5f50 5249 4e43 4950 414c  NVALID_PRINCIPAL
│ │ │ │ -0003bab0: 5f4e 414d 45e2 8099 0a20 2020 2020 5072  _NAME....     Pr
│ │ │ │ -0003bac0: 696e 6369 7061 6c20 6e61 6d65 2073 796e  incipal name syn
│ │ │ │ -0003bad0: 7461 7820 6572 726f 722e 0a0a e280 9853  tax error......S
│ │ │ │ -0003bae0: 4849 5348 495f 494e 5641 4c49 445f 4152  HISHI_INVALID_AR
│ │ │ │ -0003baf0: 4755 4d45 4e54 e280 990a 2020 2020 2049  GUMENT....     I
│ │ │ │ -0003bb00: 6e76 616c 6964 2061 7267 756d 656e 7420  nvalid argument 
│ │ │ │ -0003bb10: 7061 7373 6564 2069 6e20 6361 6c6c 2e20  passed in call. 
│ │ │ │ -0003bb20: 2057 726f 6e67 206f 7220 756e 6b6e 6f77   Wrong or unknow
│ │ │ │ -0003bb30: 6e20 7661 6c75 652e 0a0a e280 9853 4849  n value......SHI
│ │ │ │ -0003bb40: 5348 495f 4153 4e31 5f4e 4f5f 5641 4c55  SHI_ASN1_NO_VALU
│ │ │ │ -0003bb50: 45e2 8099 0a20 2020 2020 5468 6520 696e  E....     The in
│ │ │ │ -0003bb60: 6469 6361 7465 6420 4153 4e2e 3120 656c  dicated ASN.1 el
│ │ │ │ -0003bb70: 656d 656e 7420 646f 6573 206e 6f74 2063  ement does not c
│ │ │ │ -0003bb80: 6172 7279 2061 2076 616c 7565 2e0a 0ae2  arry a value....
│ │ │ │ -0003bb90: 8098 5348 4953 4849 5f43 4f4e 4e45 4354  ..SHISHI_CONNECT
│ │ │ │ -0003bba0: 5f45 5252 4f52 e280 990a 2020 2020 2043  _ERROR....     C
│ │ │ │ -0003bbb0: 6f6e 6e65 6374 696f 6e20 6174 7465 6d70  onnection attemp
│ │ │ │ -0003bbc0: 7420 6661 696c 6564 2e20 2054 7279 2061  t failed.  Try a
│ │ │ │ -0003bbd0: 6761 696e 2c20 6f72 2063 6865 636b 2061  gain, or check a
│ │ │ │ -0003bbe0: 7661 696c 6162 696c 6974 792e 0a0a e280  vailability.....
│ │ │ │ -0003bbf0: 9853 4849 5348 495f 5645 5249 4659 5f46  .SHISHI_VERIFY_F
│ │ │ │ -0003bc00: 4149 4c45 44e2 8099 0a20 2020 2020 5665  AILED....     Ve
│ │ │ │ -0003bc10: 7269 6669 6361 7469 6f6e 2066 6169 6c65  rification faile
│ │ │ │ -0003bc20: 6420 6f6e 2065 6974 6865 7220 7369 6465  d on either side
│ │ │ │ -0003bc30: 2e0a 0ae2 8098 5348 4953 4849 5f50 5249  ......SHISHI_PRI
│ │ │ │ -0003bc40: 565f 4241 445f 4b45 5954 5950 45e2 8099  V_BAD_KEYTYPE...
│ │ │ │ -0003bc50: 0a20 2020 2020 5468 6520 7072 6976 6174  .     The privat
│ │ │ │ -0003bc60: 6520 6b65 7920 7573 6573 2061 6e20 696e  e key uses an in
│ │ │ │ -0003bc70: 636f 6d70 6174 6962 6c65 2065 6e63 7279  compatible encry
│ │ │ │ -0003bc80: 7074 696f 6e20 7479 7065 2e0a 0ae2 8098  ption type......
│ │ │ │ -0003bc90: 5348 4953 4849 5f46 494c 455f 4552 524f  SHISHI_FILE_ERRO
│ │ │ │ -0003bca0: 52e2 8099 0a20 2020 2020 5468 6520 6465  R....     The de
│ │ │ │ -0003bcb0: 7369 7265 6420 6669 6c65 2063 6f75 6c64  sired file could
│ │ │ │ -0003bcc0: 206e 6f74 2062 6520 6163 6365 7373 6564   not be accessed
│ │ │ │ -0003bcd0: 2e20 2043 6865 636b 2070 6572 6d69 7373  .  Check permiss
│ │ │ │ -0003bce0: 696f 6e73 2e0a 0ae2 8098 5348 4953 4849  ions......SHISHI
│ │ │ │ -0003bcf0: 5f45 4e43 4150 5245 5050 4152 545f 4241  _ENCAPREPPART_BA
│ │ │ │ -0003bd00: 445f 4b45 5954 5950 45e2 8099 0a20 2020  D_KEYTYPE....   
│ │ │ │ -0003bd10: 2020 5468 6520 7072 6573 656e 7420 4150    The present AP
│ │ │ │ -0003bd20: 2072 6570 6c79 2073 7065 6369 6669 6573   reply specifies
│ │ │ │ -0003bd30: 2061 6e20 696e 7065 726d 6973 7369 626c   an inpermissibl
│ │ │ │ -0003bd40: 6520 6b65 7920 7479 7065 2e0a 0ae2 8098  e key type......
│ │ │ │ -0003bd50: 5348 4953 4849 5f47 4554 5449 4d45 4f46  SHISHI_GETTIMEOF
│ │ │ │ -0003bd60: 4441 595f 4552 524f 52e2 8099 0a20 2020  DAY_ERROR....   
│ │ │ │ -0003bd70: 2020 4120 7265 7175 6573 7420 666f 7220    A request for 
│ │ │ │ -0003bd80: 7072 6573 656e 7420 7469 6d65 206f 6620  present time of 
│ │ │ │ -0003bd90: 6461 7920 6861 7320 6661 696c 6564 2e20  day has failed. 
│ │ │ │ -0003bda0: 2054 6869 7320 6973 2075 7375 616c 6c79   This is usually
│ │ │ │ -0003bdb0: 0a20 2020 2020 696e 7465 726e 616c 2c20  .     internal, 
│ │ │ │ -0003bdc0: 6275 7420 6120 7661 6c69 6420 7469 6d65  but a valid time
│ │ │ │ -0003bdd0: 2069 7320 696d 7065 7261 7469 7665 2066   is imperative f
│ │ │ │ -0003bde0: 6f72 2075 732e 0a0a e280 9853 4849 5348  or us......SHISH
│ │ │ │ -0003bdf0: 495f 4b45 5954 4142 5f45 5252 4f52 e280  I_KEYTAB_ERROR..
│ │ │ │ -0003be00: 990a 2020 2020 2046 6169 6c65 6420 746f  ..     Failed to
│ │ │ │ -0003be10: 2070 6172 7365 206b 6579 7461 6220 6669   parse keytab fi
│ │ │ │ -0003be20: 6c65 2e0a 0ae2 8098 5348 4953 4849 5f43  le......SHISHI_C
│ │ │ │ -0003be30: 4341 4348 455f 4552 524f 52e2 8099 0a20  CACHE_ERROR.... 
│ │ │ │ -0003be40: 2020 2020 4661 696c 6564 2074 6f20 7061      Failed to pa
│ │ │ │ -0003be50: 7273 6520 6372 6564 656e 7469 616c 2063  rse credential c
│ │ │ │ -0003be60: 6163 6865 2066 696c 652e 0a0a 1f0a 4669  ache file.....Fi
│ │ │ │ -0003be70: 6c65 3a20 7368 6973 6869 2e69 6e66 6f2c  le: shishi.info,
│ │ │ │ -0003be80: 2020 4e6f 6465 3a20 4572 726f 7220 4675    Node: Error Fu
│ │ │ │ -0003be90: 6e63 7469 6f6e 732c 2020 5072 6576 3a20  nctions,  Prev: 
│ │ │ │ -0003bea0: 4572 726f 7220 5661 6c75 6573 2c20 2055  Error Values,  U
│ │ │ │ -0003beb0: 703a 2045 7272 6f72 2048 616e 646c 696e  p: Error Handlin
│ │ │ │ -0003bec0: 670a 0a35 2e31 372e 3220 4572 726f 7220  g..5.17.2 Error 
│ │ │ │ -0003bed0: 4675 6e63 7469 6f6e 730a 2d2d 2d2d 2d2d  Functions.------
│ │ │ │ +0003a190: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ +0003a1a0: 3a20 5368 6973 6869 5f61 736e 3120 7368  : Shishi_asn1 sh
│ │ │ │ +0003a1b0: 6973 6869 5f64 6572 3261 736e 315f 656e  ishi_der2asn1_en
│ │ │ │ +0003a1c0: 6361 7072 6570 7061 7274 2028 5368 6973  capreppart (Shis
│ │ │ │ +0003a1d0: 6869 202a 2048 414e 444c 452c 0a20 2020  hi * HANDLE,.   
│ │ │ │ +0003a1e0: 2020 2020 2020 2063 6f6e 7374 2063 6861         const cha
│ │ │ │ +0003a1f0: 7220 2a20 4445 522c 2073 697a 655f 7420  r * DER, size_t 
│ │ │ │ +0003a200: 4445 524c 454e 290a 2020 2020 2048 414e  DERLEN).     HAN
│ │ │ │ +0003a210: 444c 453a 2073 6869 7368 6920 6861 6e64  DLE: shishi hand
│ │ │ │ +0003a220: 6c65 2061 7320 616c 6c6f 6361 7465 6420  le as allocated 
│ │ │ │ +0003a230: 6279 20e2 8098 7368 6973 6869 5f69 6e69  by ...shishi_ini
│ │ │ │ +0003a240: 7428 29e2 8099 2e0a 2020 2020 2044 4552  t().....     DER
│ │ │ │ +0003a250: 3a20 696e 7075 7420 6368 6172 6163 7465  : input characte
│ │ │ │ +0003a260: 7220 6172 7261 7920 7769 7468 2044 4552  r array with DER
│ │ │ │ +0003a270: 2065 6e63 6f64 696e 672e 0a20 2020 2020   encoding..     
│ │ │ │ +0003a280: 4445 524c 454e 3a20 6c65 6e67 7468 206f  DERLEN: length o
│ │ │ │ +0003a290: 6620 696e 7075 7420 6368 6172 6163 7465  f input characte
│ │ │ │ +0003a2a0: 7220 6172 7261 7920 7769 7468 2044 4552  r array with DER
│ │ │ │ +0003a2b0: 2065 6e63 6f64 696e 672e 0a0a 2020 2020   encoding...    
│ │ │ │ +0003a2c0: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ +0003a2d0: 4465 636f 6465 2044 4552 2065 6e63 6f64  Decode DER encod
│ │ │ │ +0003a2e0: 696e 6720 6f66 2045 6e63 4150 5265 7050  ing of EncAPRepP
│ │ │ │ +0003a2f0: 6172 7420 616e 6420 6372 6561 7465 2061  art and create a
│ │ │ │ +0003a300: 0a20 2020 2020 4153 4e2e 3120 7374 7275  .     ASN.1 stru
│ │ │ │ +0003a310: 6374 7572 652e 0a0a 2020 2020 202a 5265  cture...     *Re
│ │ │ │ +0003a320: 7475 726e 2076 616c 7565 3a2a 2052 6574  turn value:* Ret
│ │ │ │ +0003a330: 7572 6e73 2041 534e 2e31 2073 7472 7563  urns ASN.1 struc
│ │ │ │ +0003a340: 7475 7265 2063 6f72 7265 7370 6f6e 6469  ture correspondi
│ │ │ │ +0003a350: 6e67 2074 6f20 4445 5220 6461 7461 2e0a  ng to DER data..
│ │ │ │ +0003a360: 0a73 6869 7368 695f 6465 7232 6173 6e31  .shishi_der2asn1
│ │ │ │ +0003a370: 5f6b 6463 7265 710a 2d2d 2d2d 2d2d 2d2d  _kdcreq.--------
│ │ │ │ +0003a380: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ +0003a390: 202d 2d20 4675 6e63 7469 6f6e 3a20 5368   -- Function: Sh
│ │ │ │ +0003a3a0: 6973 6869 5f61 736e 3120 7368 6973 6869  ishi_asn1 shishi
│ │ │ │ +0003a3b0: 5f64 6572 3261 736e 315f 6b64 6372 6571  _der2asn1_kdcreq
│ │ │ │ +0003a3c0: 2028 5368 6973 6869 202a 2048 414e 444c   (Shishi * HANDL
│ │ │ │ +0003a3d0: 452c 0a20 2020 2020 2020 2020 2063 6f6e  E,.          con
│ │ │ │ +0003a3e0: 7374 2063 6861 7220 2a20 4445 522c 2073  st char * DER, s
│ │ │ │ +0003a3f0: 697a 655f 7420 4445 524c 454e 290a 2020  ize_t DERLEN).  
│ │ │ │ +0003a400: 2020 2048 414e 444c 453a 2073 6869 7368     HANDLE: shish
│ │ │ │ +0003a410: 6920 6861 6e64 6c65 2061 7320 616c 6c6f  i handle as allo
│ │ │ │ +0003a420: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ +0003a430: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ +0003a440: 2020 2044 4552 3a20 696e 7075 7420 6368     DER: input ch
│ │ │ │ +0003a450: 6172 6163 7465 7220 6172 7261 7920 7769  aracter array wi
│ │ │ │ +0003a460: 7468 2044 4552 2065 6e63 6f64 696e 672e  th DER encoding.
│ │ │ │ +0003a470: 0a20 2020 2020 4445 524c 454e 3a20 6c65  .     DERLEN: le
│ │ │ │ +0003a480: 6e67 7468 206f 6620 696e 7075 7420 6368  ngth of input ch
│ │ │ │ +0003a490: 6172 6163 7465 7220 6172 7261 7920 7769  aracter array wi
│ │ │ │ +0003a4a0: 7468 2044 4552 2065 6e63 6f64 696e 672e  th DER encoding.
│ │ │ │ +0003a4b0: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ +0003a4c0: 696f 6e3a 2a20 4465 636f 6465 2044 4552  ion:* Decode DER
│ │ │ │ +0003a4d0: 2065 6e63 6f64 696e 6720 6f66 2041 532d   encoding of AS-
│ │ │ │ +0003a4e0: 5245 512c 2054 4753 2d52 4551 206f 7220  REQ, TGS-REQ or 
│ │ │ │ +0003a4f0: 4b44 432d 5245 510a 2020 2020 2061 6e64  KDC-REQ.     and
│ │ │ │ +0003a500: 2063 7265 6174 6520 6120 4153 4e2e 3120   create a ASN.1 
│ │ │ │ +0003a510: 7374 7275 6374 7572 652e 0a0a 2020 2020  structure...    
│ │ │ │ +0003a520: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ +0003a530: 2052 6574 7572 6e73 2041 534e 2e31 2073   Returns ASN.1 s
│ │ │ │ +0003a540: 7472 7563 7475 7265 2063 6f72 7265 7370  tructure corresp
│ │ │ │ +0003a550: 6f6e 6469 6e67 2074 6f20 4445 5220 6461  onding to DER da
│ │ │ │ +0003a560: 7461 2e0a 0a73 6869 7368 695f 6173 6e31  ta...shishi_asn1
│ │ │ │ +0003a570: 5f70 7269 6e74 0a2d 2d2d 2d2d 2d2d 2d2d  _print.---------
│ │ │ │ +0003a580: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ +0003a590: 6e63 7469 6f6e 3a20 766f 6964 2073 6869  nction: void shi
│ │ │ │ +0003a5a0: 7368 695f 6173 6e31 5f70 7269 6e74 2028  shi_asn1_print (
│ │ │ │ +0003a5b0: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ +0003a5c0: 2053 6869 7368 695f 6173 6e31 204e 4f44   Shishi_asn1 NOD
│ │ │ │ +0003a5d0: 452c 0a20 2020 2020 2020 2020 2046 494c  E,.          FIL
│ │ │ │ +0003a5e0: 4520 2a20 4648 290a 2020 2020 2048 414e  E * FH).     HAN
│ │ │ │ +0003a5f0: 444c 453a 2073 6869 7368 6920 6861 6e64  DLE: shishi hand
│ │ │ │ +0003a600: 6c65 2061 7320 616c 6c6f 6361 7465 6420  le as allocated 
│ │ │ │ +0003a610: 6279 20e2 8098 7368 6973 6869 5f69 6e69  by ...shishi_ini
│ │ │ │ +0003a620: 7428 29e2 8099 2e0a 2020 2020 204e 4f44  t().....     NOD
│ │ │ │ +0003a630: 453a 2041 534e 2e31 2064 6174 6120 7468  E: ASN.1 data th
│ │ │ │ +0003a640: 6174 2068 6176 6520 6669 656c 6420 746f  at have field to
│ │ │ │ +0003a650: 2065 7874 7261 6374 2e0a 2020 2020 2046   extract..     F
│ │ │ │ +0003a660: 483a 2066 696c 6520 6465 7363 7269 7074  H: file descript
│ │ │ │ +0003a670: 6f72 2074 6f20 7072 696e 7420 746f 2c20  or to print to, 
│ │ │ │ +0003a680: 652e 672e 2020 7374 646f 7574 2e0a 0a20  e.g.  stdout... 
│ │ │ │ +0003a690: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ +0003a6a0: 3a2a 2050 7269 6e74 2041 534e 2e31 2073  :* Print ASN.1 s
│ │ │ │ +0003a6b0: 7472 7563 7475 7265 2069 6e20 6875 6d61  tructure in huma
│ │ │ │ +0003a6c0: 6e20 7265 6164 6162 6c65 2066 6f72 6d2c  n readable form,
│ │ │ │ +0003a6d0: 0a20 2020 2020 7479 7069 6361 6c6c 7920  .     typically 
│ │ │ │ +0003a6e0: 666f 7220 6465 6275 6767 696e 6720 7075  for debugging pu
│ │ │ │ +0003a6f0: 7270 6f73 6573 2e0a 0a1f 0a46 696c 653a  rposes.....File:
│ │ │ │ +0003a700: 2073 6869 7368 692e 696e 666f 2c20 204e   shishi.info,  N
│ │ │ │ +0003a710: 6f64 653a 2045 7272 6f72 2048 616e 646c  ode: Error Handl
│ │ │ │ +0003a720: 696e 672c 2020 4e65 7874 3a20 4578 616d  ing,  Next: Exam
│ │ │ │ +0003a730: 706c 6573 2c20 2050 7265 763a 2041 534e  ples,  Prev: ASN
│ │ │ │ +0003a740: 2e31 2046 756e 6374 696f 6e73 2c20 2055  .1 Functions,  U
│ │ │ │ +0003a750: 703a 2050 726f 6772 616d 6d69 6e67 204d  p: Programming M
│ │ │ │ +0003a760: 616e 7561 6c0a 0a35 2e31 3720 4572 726f  anual..5.17 Erro
│ │ │ │ +0003a770: 7220 4861 6e64 6c69 6e67 0a3d 3d3d 3d3d  r Handling.=====
│ │ │ │ +0003a780: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a  ==============..
│ │ │ │ +0003a790: 4d6f 7374 2066 756e 6374 696f 6e73 2069  Most functions i
│ │ │ │ +0003a7a0: 6e20 274c 6962 7368 6973 6869 2720 6172  n 'Libshishi' ar
│ │ │ │ +0003a7b0: 6520 7265 7475 726e 696e 6720 616e 2065  e returning an e
│ │ │ │ +0003a7c0: 7272 6f72 2069 6620 7468 6579 2066 6169  rror if they fai
│ │ │ │ +0003a7d0: 6c2e 2020 466f 720a 7468 6973 2072 6561  l.  For.this rea
│ │ │ │ +0003a7e0: 736f 6e2c 2074 6865 2061 7070 6c69 6361  son, the applica
│ │ │ │ +0003a7f0: 7469 6f6e 2073 686f 756c 6420 616c 7761  tion should alwa
│ │ │ │ +0003a800: 7973 2063 6174 6368 2074 6865 2065 7272  ys catch the err
│ │ │ │ +0003a810: 6f72 2063 6f6e 6469 7469 6f6e 2061 6e64  or condition and
│ │ │ │ +0003a820: 0a74 616b 6520 6170 7072 6f70 7269 6174  .take appropriat
│ │ │ │ +0003a830: 6520 6d65 6173 7572 6573 2c20 666f 7220  e measures, for 
│ │ │ │ +0003a840: 6578 616d 706c 6520 6279 2072 656c 6561  example by relea
│ │ │ │ +0003a850: 7369 6e67 2074 6865 2072 6573 6f75 7263  sing the resourc
│ │ │ │ +0003a860: 6573 2061 6e64 0a70 6173 7369 6e67 2074  es and.passing t
│ │ │ │ +0003a870: 6865 2065 7272 6f72 2075 7020 746f 2074  he error up to t
│ │ │ │ +0003a880: 6865 2063 616c 6c65 722c 206f 7220 6279  he caller, or by
│ │ │ │ +0003a890: 2064 6973 706c 6179 696e 6720 6120 6465   displaying a de
│ │ │ │ +0003a8a0: 7363 7269 7074 6976 650a 6d65 7373 6167  scriptive.messag
│ │ │ │ +0003a8b0: 6520 746f 2074 6865 2075 7365 7220 616e  e to the user an
│ │ │ │ +0003a8c0: 6420 6361 6e63 656c 6c69 6e67 2074 6865  d cancelling the
│ │ │ │ +0003a8d0: 206f 7065 7261 7469 6f6e 2e0a 0a20 2020   operation...   
│ │ │ │ +0003a8e0: 536f 6d65 2065 7272 6f72 2076 616c 7565  Some error value
│ │ │ │ +0003a8f0: 7320 646f 206e 6f74 2069 6e64 6963 6174  s do not indicat
│ │ │ │ +0003a900: 6520 6120 7379 7374 656d 2065 7272 6f72  e a system error
│ │ │ │ +0003a910: 206f 7220 616e 2065 7272 6f72 2069 6e20   or an error in 
│ │ │ │ +0003a920: 7468 650a 6f70 6572 6174 696f 6e2c 2062  the.operation, b
│ │ │ │ +0003a930: 7574 2074 6865 2072 6573 756c 7420 6f66  ut the result of
│ │ │ │ +0003a940: 2061 6e20 6f70 6572 6174 696f 6e20 7468   an operation th
│ │ │ │ +0003a950: 6174 2066 6169 6c65 6420 7072 6f70 6572  at failed proper
│ │ │ │ +0003a960: 6c79 2e0a 0a2a 204d 656e 753a 0a0a 2a20  ly...* Menu:..* 
│ │ │ │ +0003a970: 4572 726f 7220 5661 6c75 6573 3a3a 2020  Error Values::  
│ │ │ │ +0003a980: 2020 2020 2020 2020 2020 2020 2020 4120                A 
│ │ │ │ +0003a990: 6c69 7374 206f 6620 616c 6c20 6572 726f  list of all erro
│ │ │ │ +0003a9a0: 7220 7661 6c75 6573 2075 7365 642e 0a2a  r values used..*
│ │ │ │ +0003a9b0: 2045 7272 6f72 2046 756e 6374 696f 6e73   Error Functions
│ │ │ │ +0003a9c0: 3a3a 2020 2020 2020 2020 2020 2020 2045  ::             E
│ │ │ │ +0003a9d0: 7272 6f72 2068 616e 646c 696e 6720 7265  rror handling re
│ │ │ │ +0003a9e0: 6c61 7465 6420 6675 6e63 7469 6f6e 732e  lated functions.
│ │ │ │ +0003a9f0: 0a0a 1f0a 4669 6c65 3a20 7368 6973 6869  ....File: shishi
│ │ │ │ +0003aa00: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 4572  .info,  Node: Er
│ │ │ │ +0003aa10: 726f 7220 5661 6c75 6573 2c20 204e 6578  ror Values,  Nex
│ │ │ │ +0003aa20: 743a 2045 7272 6f72 2046 756e 6374 696f  t: Error Functio
│ │ │ │ +0003aa30: 6e73 2c20 2055 703a 2045 7272 6f72 2048  ns,  Up: Error H
│ │ │ │ +0003aa40: 616e 646c 696e 670a 0a35 2e31 372e 3120  andling..5.17.1 
│ │ │ │ +0003aa50: 4572 726f 7220 5661 6c75 6573 0a2d 2d2d  Error Values.---
│ │ │ │ +0003aa60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +0003aa70: 0a0a 4572 726f 7273 2061 7265 2072 6574  ..Errors are ret
│ │ │ │ +0003aa80: 7572 6e65 6420 6173 2061 6e20 e280 9869  urned as an ...i
│ │ │ │ +0003aa90: 6e74 e280 992e 2020 4578 6365 7074 2066  nt....  Except f
│ │ │ │ +0003aaa0: 6f72 2074 6865 2053 4849 5348 495f 4f4b  or the SHISHI_OK
│ │ │ │ +0003aab0: 2063 6173 652c 2061 6e0a 6170 706c 6963   case, an.applic
│ │ │ │ +0003aac0: 6174 696f 6e20 7368 6f75 6c64 2061 6c77  ation should alw
│ │ │ │ +0003aad0: 6179 7320 7573 6520 7468 6520 636f 6e73  ays use the cons
│ │ │ │ +0003aae0: 7461 6e74 7320 696e 7374 6561 6420 6f66  tants instead of
│ │ │ │ +0003aaf0: 2074 6865 6972 206e 756d 6572 6963 0a76   their numeric.v
│ │ │ │ +0003ab00: 616c 7565 2e20 2041 7070 6c69 6361 7469  alue.  Applicati
│ │ │ │ +0003ab10: 6f6e 7320 6172 6520 656e 636f 7572 6167  ons are encourag
│ │ │ │ +0003ab20: 6564 2074 6f20 7573 6520 7468 6520 636f  ed to use the co
│ │ │ │ +0003ab30: 6e73 7461 6e74 7320 6576 656e 2066 6f72  nstants even for
│ │ │ │ +0003ab40: 0a53 4849 5348 495f 4f4b 2061 7320 6974  .SHISHI_OK as it
│ │ │ │ +0003ab50: 2069 6d70 726f 7665 7320 7265 6164 6162   improves readab
│ │ │ │ +0003ab60: 696c 6974 792e 2020 506f 7373 6962 6c65  ility.  Possible
│ │ │ │ +0003ab70: 2076 616c 7565 7320 6172 653a 0a0a e280   values are:....
│ │ │ │ +0003ab80: 9853 4849 5348 495f 4f4b e280 990a 2020  .SHISHI_OK....  
│ │ │ │ +0003ab90: 2020 2054 6869 7320 7661 6c75 6520 696e     This value in
│ │ │ │ +0003aba0: 6469 6361 7465 7320 7375 6363 6573 732e  dicates success.
│ │ │ │ +0003abb0: 2020 5468 6520 7661 6c75 6520 6f66 2074    The value of t
│ │ │ │ +0003abc0: 6869 7320 6572 726f 7220 6973 0a20 2020  his error is.   
│ │ │ │ +0003abd0: 2020 6775 6172 616e 7465 6564 2074 6f20    guaranteed to 
│ │ │ │ +0003abe0: 616c 7761 7973 2062 6520 e280 9830 e280  always be ...0..
│ │ │ │ +0003abf0: 9920 736f 2079 6f75 206d 6179 2075 7365  . so you may use
│ │ │ │ +0003ac00: 2069 7420 696e 2062 6f6f 6c65 616e 0a20   it in boolean. 
│ │ │ │ +0003ac10: 2020 2020 636f 6e73 7472 7563 7473 2e0a      constructs..
│ │ │ │ +0003ac20: 0ae2 8098 5348 4953 4849 5f41 534e 315f  ....SHISHI_ASN1_
│ │ │ │ +0003ac30: 4552 524f 52e2 8099 0a20 2020 2020 4572  ERROR....     Er
│ │ │ │ +0003ac40: 726f 7220 696e 2041 534e 2e31 2066 756e  ror in ASN.1 fun
│ │ │ │ +0003ac50: 6374 696f 6e2e 2020 2863 6f72 7275 7074  ction.  (corrupt
│ │ │ │ +0003ac60: 2064 6174 613f 290a 0ae2 8098 5348 4953   data?).....SHIS
│ │ │ │ +0003ac70: 4849 5f46 4f50 454e 5f45 5252 4f52 e280  HI_FOPEN_ERROR..
│ │ │ │ +0003ac80: 990a 2020 2020 2043 6f75 6c64 206e 6f74  ..     Could not
│ │ │ │ +0003ac90: 206f 7065 6e20 6669 6c65 2e0a 0ae2 8098   open file......
│ │ │ │ +0003aca0: 5348 4953 4849 5f49 4f5f 4552 524f 52e2  SHISHI_IO_ERROR.
│ │ │ │ +0003acb0: 8099 0a20 2020 2020 4669 6c65 2069 6e70  ...     File inp
│ │ │ │ +0003acc0: 7574 2f6f 7574 7075 7420 6572 726f 722e  ut/output error.
│ │ │ │ +0003acd0: 0a0a e280 9853 4849 5348 495f 4d41 4c4c  .....SHISHI_MALL
│ │ │ │ +0003ace0: 4f43 5f45 5252 4f52 e280 990a 2020 2020  OC_ERROR....    
│ │ │ │ +0003acf0: 204d 656d 6f72 7920 616c 6c6f 6361 7469   Memory allocati
│ │ │ │ +0003ad00: 6f6e 2065 7272 6f72 2069 6e20 7368 6973  on error in shis
│ │ │ │ +0003ad10: 6869 206c 6962 7261 7279 2e0a 0ae2 8098  hi library......
│ │ │ │ +0003ad20: 5348 4953 4849 5f42 4153 4536 345f 4552  SHISHI_BASE64_ER
│ │ │ │ +0003ad30: 524f 52e2 8099 0a20 2020 2020 4261 7365  ROR....     Base
│ │ │ │ +0003ad40: 3634 2065 6e63 6f64 696e 6720 6f72 2064  64 encoding or d
│ │ │ │ +0003ad50: 6563 6f64 696e 6720 6661 696c 6564 2e20  ecoding failed. 
│ │ │ │ +0003ad60: 2044 6174 6120 636f 7272 7570 743f 0a0a   Data corrupt?..
│ │ │ │ +0003ad70: e280 9853 4849 5348 495f 5245 414c 4d5f  ...SHISHI_REALM_
│ │ │ │ +0003ad80: 4d49 534d 4154 4348 e280 990a 2020 2020  MISMATCH....    
│ │ │ │ +0003ad90: 2043 6c69 656e 7420 7265 616c 6d20 7661   Client realm va
│ │ │ │ +0003ada0: 6c75 6520 6469 6666 6572 2062 6574 7765  lue differ betwe
│ │ │ │ +0003adb0: 656e 2072 6571 7565 7374 2061 6e64 2072  en request and r
│ │ │ │ +0003adc0: 6570 6c79 2e0a 0ae2 8098 5348 4953 4849  eply......SHISHI
│ │ │ │ +0003add0: 5f43 4e41 4d45 5f4d 4953 4d41 5443 48e2  _CNAME_MISMATCH.
│ │ │ │ +0003ade0: 8099 0a20 2020 2020 436c 6965 6e74 206e  ...     Client n
│ │ │ │ +0003adf0: 616d 6520 7661 6c75 6520 6469 6666 6572  ame value differ
│ │ │ │ +0003ae00: 2062 6574 7765 656e 2072 6571 7565 7374   between request
│ │ │ │ +0003ae10: 2061 6e64 2072 6570 6c79 2e0a 0ae2 8098   and reply......
│ │ │ │ +0003ae20: 5348 4953 4849 5f4e 4f4e 4345 5f4d 4953  SHISHI_NONCE_MIS
│ │ │ │ +0003ae30: 4d41 5443 48e2 8099 0a20 2020 2020 5265  MATCH....     Re
│ │ │ │ +0003ae40: 706c 6179 2070 726f 7465 6374 696f 6e20  play protection 
│ │ │ │ +0003ae50: 7661 6c75 6520 286e 6f6e 6365 2920 6469  value (nonce) di
│ │ │ │ +0003ae60: 6666 6572 2062 6574 7765 656e 2072 6571  ffer between req
│ │ │ │ +0003ae70: 7565 7374 2061 6e64 2072 6570 6c79 2e0a  uest and reply..
│ │ │ │ +0003ae80: 0ae2 8098 5348 4953 4849 5f54 4753 5245  ....SHISHI_TGSRE
│ │ │ │ +0003ae90: 505f 4241 445f 4b45 5954 5950 45e2 8099  P_BAD_KEYTYPE...
│ │ │ │ +0003aea0: 0a20 2020 2020 496e 636f 7272 6563 7420  .     Incorrect 
│ │ │ │ +0003aeb0: 6b65 7920 7479 7065 2075 7365 6420 696e  key type used in
│ │ │ │ +0003aec0: 2054 4753 2072 6570 6c79 2e0a 0ae2 8098   TGS reply......
│ │ │ │ +0003aed0: 5348 4953 4849 5f4b 4443 5245 505f 4241  SHISHI_KDCREP_BA
│ │ │ │ +0003aee0: 445f 4b45 5954 5950 45e2 8099 0a20 2020  D_KEYTYPE....   
│ │ │ │ +0003aef0: 2020 496e 636f 7272 6563 7420 6b65 7920    Incorrect key 
│ │ │ │ +0003af00: 7479 7065 2075 7365 6420 696e 2072 6570  type used in rep
│ │ │ │ +0003af10: 6c79 2066 726f 6d20 4b44 432e 0a0a e280  ly from KDC.....
│ │ │ │ +0003af20: 9853 4849 5348 495f 4150 5245 505f 4241  .SHISHI_APREP_BA
│ │ │ │ +0003af30: 445f 4b45 5954 5950 45e2 8099 0a20 2020  D_KEYTYPE....   
│ │ │ │ +0003af40: 2020 496e 636f 7272 6563 7420 6b65 7920    Incorrect key 
│ │ │ │ +0003af50: 7479 7065 2075 7365 6420 696e 2041 5020  type used in AP 
│ │ │ │ +0003af60: 7265 706c 792e 0a0a e280 9853 4849 5348  reply......SHISH
│ │ │ │ +0003af70: 495f 4150 5245 505f 5645 5249 4659 5f46  I_APREP_VERIFY_F
│ │ │ │ +0003af80: 4149 4c45 44e2 8099 0a20 2020 2020 4661  AILED....     Fa
│ │ │ │ +0003af90: 696c 6564 2076 6572 6966 6963 6174 696f  iled verificatio
│ │ │ │ +0003afa0: 6e20 6f66 2041 5020 7265 706c 792e 0a0a  n of AP reply...
│ │ │ │ +0003afb0: e280 9853 4849 5348 495f 4150 5245 515f  ...SHISHI_APREQ_
│ │ │ │ +0003afc0: 4241 445f 4b45 5954 5950 45e2 8099 0a20  BAD_KEYTYPE.... 
│ │ │ │ +0003afd0: 2020 2020 496e 636f 7272 6563 7420 6b65      Incorrect ke
│ │ │ │ +0003afe0: 7920 7479 7065 2075 7365 6420 696e 2041  y type used in A
│ │ │ │ +0003aff0: 5020 7265 7175 6573 742e 0a0a e280 9853  P request......S
│ │ │ │ +0003b000: 4849 5348 495f 544f 4f5f 534d 414c 4c5f  HISHI_TOO_SMALL_
│ │ │ │ +0003b010: 4255 4646 4552 e280 990a 2020 2020 2050  BUFFER....     P
│ │ │ │ +0003b020: 726f 7669 6465 6420 6275 6666 6572 2077  rovided buffer w
│ │ │ │ +0003b030: 6173 2074 6f6f 2073 6d61 6c6c 2e0a 0ae2  as too small....
│ │ │ │ +0003b040: 8098 5348 4953 4849 5f44 4552 4956 4544  ..SHISHI_DERIVED
│ │ │ │ +0003b050: 4b45 595f 544f 4f5f 534d 414c 4ce2 8099  KEY_TOO_SMALL...
│ │ │ │ +0003b060: 0a20 2020 2020 4465 7269 7665 6420 6b65  .     Derived ke
│ │ │ │ +0003b070: 7920 6d61 7465 7269 616c 2069 7320 746f  y material is to
│ │ │ │ +0003b080: 6f20 7368 6f72 7420 746f 2062 6520 6170  o short to be ap
│ │ │ │ +0003b090: 706c 6963 6162 6c65 2e0a 0ae2 8098 5348  plicable......SH
│ │ │ │ +0003b0a0: 4953 4849 5f4b 4559 5f54 4f4f 5f4c 4152  ISHI_KEY_TOO_LAR
│ │ │ │ +0003b0b0: 4745 e280 990a 2020 2020 2054 6865 206b  GE....     The k
│ │ │ │ +0003b0c0: 6579 2069 7320 746f 6f20 6c61 7267 6520  ey is too large 
│ │ │ │ +0003b0d0: 746f 2062 6520 7573 6162 6c65 2e0a 0ae2  to be usable....
│ │ │ │ +0003b0e0: 8098 5348 4953 4849 5f43 5259 5054 4f5f  ..SHISHI_CRYPTO_
│ │ │ │ +0003b0f0: 4552 524f 52e2 8099 0a20 2020 2020 4c6f  ERROR....     Lo
│ │ │ │ +0003b100: 772d 6c65 7665 6c20 6372 7970 746f 6772  w-level cryptogr
│ │ │ │ +0003b110: 6170 6869 6320 7072 696d 6974 6976 6520  aphic primitive 
│ │ │ │ +0003b120: 6661 696c 6564 2e20 2054 6869 7320 7573  failed.  This us
│ │ │ │ +0003b130: 7561 6c6c 7920 696e 6469 6361 7465 730a  ually indicates.
│ │ │ │ +0003b140: 2020 2020 2062 6164 2070 6173 7377 6f72       bad passwor
│ │ │ │ +0003b150: 6420 6f72 2064 6174 6120 636f 7272 7570  d or data corrup
│ │ │ │ +0003b160: 7469 6f6e 2e0a 0ae2 8098 5348 4953 4849  tion......SHISHI
│ │ │ │ +0003b170: 5f43 5259 5054 4f5f 494e 5445 524e 414c  _CRYPTO_INTERNAL
│ │ │ │ +0003b180: 5f45 5252 4f52 e280 990a 2020 2020 2049  _ERROR....     I
│ │ │ │ +0003b190: 6e74 6572 6e61 6c20 6572 726f 7220 696e  nternal error in
│ │ │ │ +0003b1a0: 206c 6f77 2d6c 6576 656c 2063 7279 7074   low-level crypt
│ │ │ │ +0003b1b0: 6f20 726f 7574 696e 6573 2e0a 0ae2 8098  o routines......
│ │ │ │ +0003b1c0: 5348 4953 4849 5f53 4f43 4b45 545f 4552  SHISHI_SOCKET_ER
│ │ │ │ +0003b1d0: 524f 52e2 8099 0a20 2020 2020 5468 6520  ROR....     The 
│ │ │ │ +0003b1e0: 7379 7374 656d 2063 616c 6c20 736f 636b  system call sock
│ │ │ │ +0003b1f0: 6574 2829 2066 6169 6c65 642e 2020 5468  et() failed.  Th
│ │ │ │ +0003b200: 6973 2075 7375 616c 6c79 2069 6e64 6963  is usually indic
│ │ │ │ +0003b210: 6174 6573 2074 6861 7420 796f 7572 0a20  ates that your. 
│ │ │ │ +0003b220: 2020 2020 7379 7374 656d 2064 6f65 7320      system does 
│ │ │ │ +0003b230: 6e6f 7420 7375 7070 6f72 7420 7468 6520  not support the 
│ │ │ │ +0003b240: 736f 636b 6574 2074 7970 652e 0a0a e280  socket type.....
│ │ │ │ +0003b250: 9853 4849 5348 495f 4249 4e44 5f45 5252  .SHISHI_BIND_ERR
│ │ │ │ +0003b260: 4f52 e280 990a 2020 2020 2054 6865 2073  OR....     The s
│ │ │ │ +0003b270: 7973 7465 6d20 6361 6c6c 2062 696e 6428  ystem call bind(
│ │ │ │ +0003b280: 2920 6661 696c 6564 2e20 2054 6869 7320  ) failed.  This 
│ │ │ │ +0003b290: 7573 7561 6c6c 7920 696e 6469 6361 7465  usually indicate
│ │ │ │ +0003b2a0: 7320 696e 7375 6666 6963 6965 6e74 0a20  s insufficient. 
│ │ │ │ +0003b2b0: 2020 2020 7065 726d 6973 7369 6f6e 732e      permissions.
│ │ │ │ +0003b2c0: 0a0a e280 9853 4849 5348 495f 5345 4e44  .....SHISHI_SEND
│ │ │ │ +0003b2d0: 544f 5f45 5252 4f52 e280 990a 2020 2020  TO_ERROR....    
│ │ │ │ +0003b2e0: 2054 6865 2073 7973 7465 6d20 6361 6c6c   The system call
│ │ │ │ +0003b2f0: 2073 656e 6474 6f28 2920 6661 696c 6564   sendto() failed
│ │ │ │ +0003b300: 2e0a 0ae2 8098 5348 4953 4849 5f52 4543  ......SHISHI_REC
│ │ │ │ +0003b310: 5646 524f 4d5f 4552 524f 52e2 8099 0a20  VFROM_ERROR.... 
│ │ │ │ +0003b320: 2020 2020 4572 726f 7220 7265 6365 6976      Error receiv
│ │ │ │ +0003b330: 696e 6720 6461 7461 2066 726f 6d20 7365  ing data from se
│ │ │ │ +0003b340: 7276 6572 2e0a 0ae2 8098 5348 4953 4849  rver......SHISHI
│ │ │ │ +0003b350: 5f43 4c4f 5345 5f45 5252 4f52 e280 990a  _CLOSE_ERROR....
│ │ │ │ +0003b360: 2020 2020 2054 6865 2073 7973 7465 6d20       The system 
│ │ │ │ +0003b370: 6361 6c6c 2063 6c6f 7365 2829 2066 6169  call close() fai
│ │ │ │ +0003b380: 6c65 642e 0a0a e280 9853 4849 5348 495f  led......SHISHI_
│ │ │ │ +0003b390: 4b44 435f 5449 4d45 4f55 54e2 8099 0a20  KDC_TIMEOUT.... 
│ │ │ │ +0003b3a0: 2020 2020 5469 6d65 6420 6f75 7420 7461      Timed out ta
│ │ │ │ +0003b3b0: 6c6b 696e 6720 746f 204b 4443 2e20 5468  lking to KDC. Th
│ │ │ │ +0003b3c0: 6973 2075 7375 616c 6c79 2069 6e64 6963  is usually indic
│ │ │ │ +0003b3d0: 6174 6573 2061 206e 6574 776f 726b 206f  ates a network o
│ │ │ │ +0003b3e0: 7220 4b44 430a 2020 2020 2061 6464 7265  r KDC.     addre
│ │ │ │ +0003b3f0: 7373 2070 726f 626c 656d 2e0a 0ae2 8098  ss problem......
│ │ │ │ +0003b400: 5348 4953 4849 5f4b 4443 5f4e 4f54 5f4b  SHISHI_KDC_NOT_K
│ │ │ │ +0003b410: 4e4f 574e 5f46 4f52 5f52 4541 4c4d e280  NOWN_FOR_REALM..
│ │ │ │ +0003b420: 990a 2020 2020 204e 6f20 4b44 4320 6b6e  ..     No KDC kn
│ │ │ │ +0003b430: 6f77 6e20 666f 7220 6769 7665 6e20 7265  own for given re
│ │ │ │ +0003b440: 616c 6d2e 0a0a e280 9853 4849 5348 495f  alm......SHISHI_
│ │ │ │ +0003b450: 5454 595f 4552 524f 52e2 8099 0a20 2020  TTY_ERROR....   
│ │ │ │ +0003b460: 2020 4e6f 2054 5459 2061 7373 6967 6e65    No TTY assigne
│ │ │ │ +0003b470: 6420 746f 2070 726f 6365 7373 2e0a 0ae2  d to process....
│ │ │ │ +0003b480: 8098 5348 4953 4849 5f47 4f54 5f4b 5242  ..SHISHI_GOT_KRB
│ │ │ │ +0003b490: 4552 524f 52e2 8099 0a20 2020 2020 5365  ERROR....     Se
│ │ │ │ +0003b4a0: 7276 6572 2072 6570 6c69 6564 2074 6f20  rver replied to 
│ │ │ │ +0003b4b0: 7468 6520 7265 7175 6573 7420 7769 7468  the request with
│ │ │ │ +0003b4c0: 2061 6e20 6572 726f 7220 6d65 7373 6167   an error messag
│ │ │ │ +0003b4d0: 652e 0a0a e280 9853 4849 5348 495f 4841  e......SHISHI_HA
│ │ │ │ +0003b4e0: 4e44 4c45 5f45 5252 4f52 e280 990a 2020  NDLE_ERROR....  
│ │ │ │ +0003b4f0: 2020 2046 6169 6c75 7265 2074 6f20 7573     Failure to us
│ │ │ │ +0003b500: 6520 6861 6e64 6c65 2e20 204d 6973 7369  e handle.  Missi
│ │ │ │ +0003b510: 6e67 2068 616e 646c 652c 206f 7220 6d69  ng handle, or mi
│ │ │ │ +0003b520: 7363 6f6e 6669 6775 7265 642e 0a0a e280  sconfigured.....
│ │ │ │ +0003b530: 9853 4849 5348 495f 494e 5641 4c49 445f  .SHISHI_INVALID_
│ │ │ │ +0003b540: 544b 5453 e280 990a 2020 2020 2054 6963  TKTS....     Tic
│ │ │ │ +0003b550: 6b65 7420 7365 7420 6e6f 7420 696e 6974  ket set not init
│ │ │ │ +0003b560: 6961 6c69 7a65 642e 2020 5468 6973 2075  ialized.  This u
│ │ │ │ +0003b570: 7375 616c 6c79 2069 6e64 6963 6174 6573  sually indicates
│ │ │ │ +0003b580: 2061 6e20 696e 7465 726e 616c 0a20 2020   an internal.   
│ │ │ │ +0003b590: 2020 6170 706c 6963 6174 696f 6e20 6572    application er
│ │ │ │ +0003b5a0: 726f 722e 0a0a e280 9853 4849 5348 495f  ror......SHISHI_
│ │ │ │ +0003b5b0: 5449 434b 4554 5f42 4144 5f4b 4559 5459  TICKET_BAD_KEYTY
│ │ │ │ +0003b5c0: 5045 e280 990a 2020 2020 204b 6579 2074  PE....     Key t
│ │ │ │ +0003b5d0: 7970 6520 7573 6564 2074 6f20 656e 6372  ype used to encr
│ │ │ │ +0003b5e0: 7970 7420 7469 636b 6574 2064 6f65 736e  ypt ticket doesn
│ │ │ │ +0003b5f0: 2774 206d 6174 6368 2070 726f 7669 6465  't match provide
│ │ │ │ +0003b600: 6420 6b65 792e 2020 5468 6973 0a20 2020  d key.  This.   
│ │ │ │ +0003b610: 2020 7573 7561 6c6c 7920 696e 6469 6361    usually indica
│ │ │ │ +0003b620: 7465 7320 616e 2069 6e74 6572 6e61 6c20  tes an internal 
│ │ │ │ +0003b630: 6170 706c 6963 6174 696f 6e20 6572 726f  application erro
│ │ │ │ +0003b640: 722e 0a0a e280 9853 4849 5348 495f 494e  r......SHISHI_IN
│ │ │ │ +0003b650: 5641 4c49 445f 4b45 59e2 8099 0a20 2020  VALID_KEY....   
│ │ │ │ +0003b660: 2020 5265 6665 7265 6e63 6520 746f 2069    Reference to i
│ │ │ │ +0003b670: 6e76 616c 6964 2065 6e63 7279 7074 696f  nvalid encryptio
│ │ │ │ +0003b680: 6e20 6b65 792e 0a0a e280 9853 4849 5348  n key......SHISH
│ │ │ │ +0003b690: 495f 4150 5245 515f 4445 4352 5950 545f  I_APREQ_DECRYPT_
│ │ │ │ +0003b6a0: 4641 494c 4544 e280 990a 2020 2020 2043  FAILED....     C
│ │ │ │ +0003b6b0: 6f75 6c64 206e 6f74 2064 6563 7279 7074  ould not decrypt
│ │ │ │ +0003b6c0: 2041 502d 5245 5120 7573 696e 6720 7072   AP-REQ using pr
│ │ │ │ +0003b6d0: 6f76 6964 6564 206b 6579 2e20 2054 6869  ovided key.  Thi
│ │ │ │ +0003b6e0: 7320 7573 7561 6c6c 790a 2020 2020 2069  s usually.     i
│ │ │ │ +0003b6f0: 6e64 6963 6174 6573 2061 6e20 696e 7465  ndicates an inte
│ │ │ │ +0003b700: 726e 616c 2061 7070 6c69 6361 7469 6f6e  rnal application
│ │ │ │ +0003b710: 2065 7272 6f72 2e0a 0ae2 8098 5348 4953   error......SHIS
│ │ │ │ +0003b720: 4849 5f54 4943 4b45 545f 4445 4352 5950  HI_TICKET_DECRYP
│ │ │ │ +0003b730: 545f 4641 494c 4544 e280 990a 2020 2020  T_FAILED....    
│ │ │ │ +0003b740: 2043 6f75 6c64 206e 6f74 2064 6563 7279   Could not decry
│ │ │ │ +0003b750: 7074 2054 6963 6b65 7420 7573 696e 6720  pt Ticket using 
│ │ │ │ +0003b760: 7072 6f76 6964 6564 206b 6579 2e20 2054  provided key.  T
│ │ │ │ +0003b770: 6869 7320 7573 7561 6c6c 790a 2020 2020  his usually.    
│ │ │ │ +0003b780: 2069 6e64 6963 6174 6573 2061 6e20 696e   indicates an in
│ │ │ │ +0003b790: 7465 726e 616c 2061 7070 6c69 6361 7469  ternal applicati
│ │ │ │ +0003b7a0: 6f6e 2065 7272 6f72 2e0a 0ae2 8098 5348  on error......SH
│ │ │ │ +0003b7b0: 4953 4849 5f49 4e56 414c 4944 5f54 4943  ISHI_INVALID_TIC
│ │ │ │ +0003b7c0: 4b45 54e2 8099 0a20 2020 2020 496e 7661  KET....     Inva
│ │ │ │ +0003b7d0: 6c69 6420 7469 636b 6564 2070 6173 7365  lid ticked passe
│ │ │ │ +0003b7e0: 6420 696e 2063 616c 6c2e 0a0a e280 9853  d in call......S
│ │ │ │ +0003b7f0: 4849 5348 495f 4f55 545f 4f46 5f52 414e  HISHI_OUT_OF_RAN
│ │ │ │ +0003b800: 4745 e280 990a 2020 2020 2041 7267 756d  GE....     Argum
│ │ │ │ +0003b810: 656e 7420 6c69 6573 206f 7574 7369 6465  ent lies outside
│ │ │ │ +0003b820: 206f 6620 7661 6c69 6420 7261 6e67 652e   of valid range.
│ │ │ │ +0003b830: 0a0a e280 9853 4849 5348 495f 4153 4e31  .....SHISHI_ASN1
│ │ │ │ +0003b840: 5f4e 4f5f 454c 454d 454e 54e2 8099 0a20  _NO_ELEMENT.... 
│ │ │ │ +0003b850: 2020 2020 5468 6520 4153 4e2e 3120 7374      The ASN.1 st
│ │ │ │ +0003b860: 7275 6374 7572 6520 646f 6573 206e 6f74  ructure does not
│ │ │ │ +0003b870: 2063 6f6e 7461 696e 2074 6865 2069 6e64   contain the ind
│ │ │ │ +0003b880: 6963 6174 6564 2065 6c65 6d65 6e74 2e0a  icated element..
│ │ │ │ +0003b890: 0ae2 8098 5348 4953 4849 5f53 4146 455f  ....SHISHI_SAFE_
│ │ │ │ +0003b8a0: 4241 445f 4b45 5954 5950 45e2 8099 0a20  BAD_KEYTYPE.... 
│ │ │ │ +0003b8b0: 2020 2020 4174 7465 6d70 7465 6420 6163      Attempted ac
│ │ │ │ +0003b8c0: 6365 7373 2074 6f20 6e6f 6e2d 6578 6973  cess to non-exis
│ │ │ │ +0003b8d0: 7465 6e74 206b 6579 2074 7970 652e 0a0a  tent key type...
│ │ │ │ +0003b8e0: e280 9853 4849 5348 495f 5341 4645 5f56  ...SHISHI_SAFE_V
│ │ │ │ +0003b8f0: 4552 4946 595f 4641 494c 4544 e280 990a  ERIFY_FAILED....
│ │ │ │ +0003b900: 2020 2020 2056 6572 6966 6963 6174 696f       Verificatio
│ │ │ │ +0003b910: 6e20 6661 696c 6564 206f 6e20 6569 7468  n failed on eith
│ │ │ │ +0003b920: 6572 2073 6964 652e 0a0a e280 9853 4849  er side......SHI
│ │ │ │ +0003b930: 5348 495f 504b 4353 355f 494e 5641 4c49  SHI_PKCS5_INVALI
│ │ │ │ +0003b940: 445f 5052 46e2 8099 0a20 2020 2020 496e  D_PRF....     In
│ │ │ │ +0003b950: 7661 6c69 6420 504b 4353 3520 6465 7363  valid PKCS5 desc
│ │ │ │ +0003b960: 7269 7074 6f72 2e0a 0ae2 8098 5348 4953  riptor......SHIS
│ │ │ │ +0003b970: 4849 5f50 4b43 5335 5f49 4e56 414c 4944  HI_PKCS5_INVALID
│ │ │ │ +0003b980: 5f49 5445 5241 5449 4f4e 5f43 4f55 4e54  _ITERATION_COUNT
│ │ │ │ +0003b990: e280 990a 2020 2020 2049 6e76 616c 6964  ....     Invalid
│ │ │ │ +0003b9a0: 2063 6c61 696d 206f 6620 6974 6572 6174   claim of iterat
│ │ │ │ +0003b9b0: 696f 6e20 636f 756e 7420 696e 2050 4b43  ion count in PKC
│ │ │ │ +0003b9c0: 5335 2064 6573 6372 6970 746f 722e 0a0a  S5 descriptor...
│ │ │ │ +0003b9d0: e280 9853 4849 5348 495f 504b 4353 355f  ...SHISHI_PKCS5_
│ │ │ │ +0003b9e0: 494e 5641 4c49 445f 4445 5249 5645 445f  INVALID_DERIVED_
│ │ │ │ +0003b9f0: 4b45 595f 4c45 4e47 5448 e280 990a 2020  KEY_LENGTH....  
│ │ │ │ +0003ba00: 2020 2044 6572 6976 6564 206b 6579 206c     Derived key l
│ │ │ │ +0003ba10: 656e 6774 6820 6973 2069 6e63 6f72 7265  ength is incorre
│ │ │ │ +0003ba20: 6374 2066 6f72 2050 4b43 5335 2064 6573  ct for PKCS5 des
│ │ │ │ +0003ba30: 6372 6970 746f 722e 0a0a e280 9853 4849  criptor......SHI
│ │ │ │ +0003ba40: 5348 495f 504b 4353 355f 4445 5249 5645  SHI_PKCS5_DERIVE
│ │ │ │ +0003ba50: 445f 4b45 595f 544f 4f5f 4c4f 4e47 e280  D_KEY_TOO_LONG..
│ │ │ │ +0003ba60: 990a 2020 2020 2044 6572 6976 6564 206b  ..     Derived k
│ │ │ │ +0003ba70: 6579 2069 7320 746f 6f20 6c6f 6e67 2066  ey is too long f
│ │ │ │ +0003ba80: 6f72 2050 4b43 5335 2064 6573 6372 6970  or PKCS5 descrip
│ │ │ │ +0003ba90: 746f 722e 0a0a e280 9853 4849 5348 495f  tor......SHISHI_
│ │ │ │ +0003baa0: 494e 5641 4c49 445f 5052 494e 4349 5041  INVALID_PRINCIPA
│ │ │ │ +0003bab0: 4c5f 4e41 4d45 e280 990a 2020 2020 2050  L_NAME....     P
│ │ │ │ +0003bac0: 7269 6e63 6970 616c 206e 616d 6520 7379  rincipal name sy
│ │ │ │ +0003bad0: 6e74 6178 2065 7272 6f72 2e0a 0ae2 8098  ntax error......
│ │ │ │ +0003bae0: 5348 4953 4849 5f49 4e56 414c 4944 5f41  SHISHI_INVALID_A
│ │ │ │ +0003baf0: 5247 554d 454e 54e2 8099 0a20 2020 2020  RGUMENT....     
│ │ │ │ +0003bb00: 496e 7661 6c69 6420 6172 6775 6d65 6e74  Invalid argument
│ │ │ │ +0003bb10: 2070 6173 7365 6420 696e 2063 616c 6c2e   passed in call.
│ │ │ │ +0003bb20: 2020 5772 6f6e 6720 6f72 2075 6e6b 6e6f    Wrong or unkno
│ │ │ │ +0003bb30: 776e 2076 616c 7565 2e0a 0ae2 8098 5348  wn value......SH
│ │ │ │ +0003bb40: 4953 4849 5f41 534e 315f 4e4f 5f56 414c  ISHI_ASN1_NO_VAL
│ │ │ │ +0003bb50: 5545 e280 990a 2020 2020 2054 6865 2069  UE....     The i
│ │ │ │ +0003bb60: 6e64 6963 6174 6564 2041 534e 2e31 2065  ndicated ASN.1 e
│ │ │ │ +0003bb70: 6c65 6d65 6e74 2064 6f65 7320 6e6f 7420  lement does not 
│ │ │ │ +0003bb80: 6361 7272 7920 6120 7661 6c75 652e 0a0a  carry a value...
│ │ │ │ +0003bb90: e280 9853 4849 5348 495f 434f 4e4e 4543  ...SHISHI_CONNEC
│ │ │ │ +0003bba0: 545f 4552 524f 52e2 8099 0a20 2020 2020  T_ERROR....     
│ │ │ │ +0003bbb0: 436f 6e6e 6563 7469 6f6e 2061 7474 656d  Connection attem
│ │ │ │ +0003bbc0: 7074 2066 6169 6c65 642e 2020 5472 7920  pt failed.  Try 
│ │ │ │ +0003bbd0: 6167 6169 6e2c 206f 7220 6368 6563 6b20  again, or check 
│ │ │ │ +0003bbe0: 6176 6169 6c61 6269 6c69 7479 2e0a 0ae2  availability....
│ │ │ │ +0003bbf0: 8098 5348 4953 4849 5f56 4552 4946 595f  ..SHISHI_VERIFY_
│ │ │ │ +0003bc00: 4641 494c 4544 e280 990a 2020 2020 2056  FAILED....     V
│ │ │ │ +0003bc10: 6572 6966 6963 6174 696f 6e20 6661 696c  erification fail
│ │ │ │ +0003bc20: 6564 206f 6e20 6569 7468 6572 2073 6964  ed on either sid
│ │ │ │ +0003bc30: 652e 0a0a e280 9853 4849 5348 495f 5052  e......SHISHI_PR
│ │ │ │ +0003bc40: 4956 5f42 4144 5f4b 4559 5459 5045 e280  IV_BAD_KEYTYPE..
│ │ │ │ +0003bc50: 990a 2020 2020 2054 6865 2070 7269 7661  ..     The priva
│ │ │ │ +0003bc60: 7465 206b 6579 2075 7365 7320 616e 2069  te key uses an i
│ │ │ │ +0003bc70: 6e63 6f6d 7061 7469 626c 6520 656e 6372  ncompatible encr
│ │ │ │ +0003bc80: 7970 7469 6f6e 2074 7970 652e 0a0a e280  yption type.....
│ │ │ │ +0003bc90: 9853 4849 5348 495f 4649 4c45 5f45 5252  .SHISHI_FILE_ERR
│ │ │ │ +0003bca0: 4f52 e280 990a 2020 2020 2054 6865 2064  OR....     The d
│ │ │ │ +0003bcb0: 6573 6972 6564 2066 696c 6520 636f 756c  esired file coul
│ │ │ │ +0003bcc0: 6420 6e6f 7420 6265 2061 6363 6573 7365  d not be accesse
│ │ │ │ +0003bcd0: 642e 2020 4368 6563 6b20 7065 726d 6973  d.  Check permis
│ │ │ │ +0003bce0: 7369 6f6e 732e 0a0a e280 9853 4849 5348  sions......SHISH
│ │ │ │ +0003bcf0: 495f 454e 4341 5052 4550 5041 5254 5f42  I_ENCAPREPPART_B
│ │ │ │ +0003bd00: 4144 5f4b 4559 5459 5045 e280 990a 2020  AD_KEYTYPE....  
│ │ │ │ +0003bd10: 2020 2054 6865 2070 7265 7365 6e74 2041     The present A
│ │ │ │ +0003bd20: 5020 7265 706c 7920 7370 6563 6966 6965  P reply specifie
│ │ │ │ +0003bd30: 7320 616e 2069 6e70 6572 6d69 7373 6962  s an inpermissib
│ │ │ │ +0003bd40: 6c65 206b 6579 2074 7970 652e 0a0a e280  le key type.....
│ │ │ │ +0003bd50: 9853 4849 5348 495f 4745 5454 494d 454f  .SHISHI_GETTIMEO
│ │ │ │ +0003bd60: 4644 4159 5f45 5252 4f52 e280 990a 2020  FDAY_ERROR....  
│ │ │ │ +0003bd70: 2020 2041 2072 6571 7565 7374 2066 6f72     A request for
│ │ │ │ +0003bd80: 2070 7265 7365 6e74 2074 696d 6520 6f66   present time of
│ │ │ │ +0003bd90: 2064 6179 2068 6173 2066 6169 6c65 642e   day has failed.
│ │ │ │ +0003bda0: 2020 5468 6973 2069 7320 7573 7561 6c6c    This is usuall
│ │ │ │ +0003bdb0: 790a 2020 2020 2069 6e74 6572 6e61 6c2c  y.     internal,
│ │ │ │ +0003bdc0: 2062 7574 2061 2076 616c 6964 2074 696d   but a valid tim
│ │ │ │ +0003bdd0: 6520 6973 2069 6d70 6572 6174 6976 6520  e is imperative 
│ │ │ │ +0003bde0: 666f 7220 7573 2e0a 0ae2 8098 5348 4953  for us......SHIS
│ │ │ │ +0003bdf0: 4849 5f4b 4559 5441 425f 4552 524f 52e2  HI_KEYTAB_ERROR.
│ │ │ │ +0003be00: 8099 0a20 2020 2020 4661 696c 6564 2074  ...     Failed t
│ │ │ │ +0003be10: 6f20 7061 7273 6520 6b65 7974 6162 2066  o parse keytab f
│ │ │ │ +0003be20: 696c 652e 0a0a e280 9853 4849 5348 495f  ile......SHISHI_
│ │ │ │ +0003be30: 4343 4143 4845 5f45 5252 4f52 e280 990a  CCACHE_ERROR....
│ │ │ │ +0003be40: 2020 2020 2046 6169 6c65 6420 746f 2070       Failed to p
│ │ │ │ +0003be50: 6172 7365 2063 7265 6465 6e74 6961 6c20  arse credential 
│ │ │ │ +0003be60: 6361 6368 6520 6669 6c65 2e0a 0a1f 0a46  cache file.....F
│ │ │ │ +0003be70: 696c 653a 2073 6869 7368 692e 696e 666f  ile: shishi.info
│ │ │ │ +0003be80: 2c20 204e 6f64 653a 2045 7272 6f72 2046  ,  Node: Error F
│ │ │ │ +0003be90: 756e 6374 696f 6e73 2c20 2050 7265 763a  unctions,  Prev:
│ │ │ │ +0003bea0: 2045 7272 6f72 2056 616c 7565 732c 2020   Error Values,  
│ │ │ │ +0003beb0: 5570 3a20 4572 726f 7220 4861 6e64 6c69  Up: Error Handli
│ │ │ │ +0003bec0: 6e67 0a0a 352e 3137 2e32 2045 7272 6f72  ng..5.17.2 Error
│ │ │ │ +0003bed0: 2046 756e 6374 696f 6e73 0a2d 2d2d 2d2d   Functions.-----
│ │ │ │  0003bee0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0003bef0: 0a0a 7368 6973 6869 5f73 7472 6572 726f  ..shishi_strerro
│ │ │ │ -0003bf00: 720a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  r.--------------
│ │ │ │ -0003bf10: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ -0003bf20: 2063 6f6e 7374 2063 6861 7220 2a20 7368   const char * sh
│ │ │ │ -0003bf30: 6973 6869 5f73 7472 6572 726f 7220 2869  ishi_strerror (i
│ │ │ │ -0003bf40: 6e74 2045 5252 290a 2020 2020 2045 5252  nt ERR).     ERR
│ │ │ │ -0003bf50: 3a20 7368 6973 6869 2065 7272 6f72 2063  : shishi error c
│ │ │ │ -0003bf60: 6f64 652e 0a0a 2020 2020 202a 4465 7363  ode...     *Desc
│ │ │ │ -0003bf70: 7269 7074 696f 6e3a 2a20 436f 6e76 6572  ription:* Conver
│ │ │ │ -0003bf80: 7473 2074 6865 2072 6574 7572 6e20 636f  ts the return co
│ │ │ │ -0003bf90: 6465 2069 6e20 4552 5220 746f 2061 2068  de in ERR to a h
│ │ │ │ -0003bfa0: 756d 616e 2072 6561 6461 626c 650a 2020  uman readable.  
│ │ │ │ -0003bfb0: 2020 2073 7472 696e 672e 0a0a 2020 2020     string...    
│ │ │ │ -0003bfc0: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ -0003bfd0: 2052 6574 7572 6e73 2061 2070 6f69 6e74   Returns a point
│ │ │ │ -0003bfe0: 6572 2074 6f20 6120 7374 6174 6963 616c  er to a statical
│ │ │ │ -0003bff0: 6c79 2061 6c6c 6f63 6174 6564 2073 7472  ly allocated str
│ │ │ │ -0003c000: 696e 670a 2020 2020 2063 6f6e 7461 696e  ing.     contain
│ │ │ │ -0003c010: 696e 6720 6120 6465 7363 7269 7074 696f  ing a descriptio
│ │ │ │ -0003c020: 6e20 6f66 2074 6865 2065 7272 6f72 2077  n of the error w
│ │ │ │ -0003c030: 6974 6820 636f 6465 2045 5252 2e20 2054  ith code ERR.  T
│ │ │ │ -0003c040: 6869 7320 7374 7269 6e67 0a20 2020 2020  his string.     
│ │ │ │ -0003c050: 6361 6e20 6265 2075 7365 6420 746f 206f  can be used to o
│ │ │ │ -0003c060: 7574 7075 7420 6120 6469 6167 6e6f 7374  utput a diagnost
│ │ │ │ -0003c070: 6963 206d 6573 7361 6765 2074 6f20 7468  ic message to th
│ │ │ │ -0003c080: 6520 7573 6572 2e0a 0a73 6869 7368 695f  e user...shishi_
│ │ │ │ -0003c090: 6572 726f 720a 2d2d 2d2d 2d2d 2d2d 2d2d  error.----------
│ │ │ │ -0003c0a0: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ -0003c0b0: 3a20 636f 6e73 7420 6368 6172 202a 2073  : const char * s
│ │ │ │ -0003c0c0: 6869 7368 695f 6572 726f 7220 2853 6869  hishi_error (Shi
│ │ │ │ -0003c0d0: 7368 6920 2a20 4841 4e44 4c45 290a 2020  shi * HANDLE).  
│ │ │ │ -0003c0e0: 2020 2048 414e 444c 453a 2073 6869 7368     HANDLE: shish
│ │ │ │ -0003c0f0: 6920 6861 6e64 6c65 2061 7320 616c 6c6f  i handle as allo
│ │ │ │ -0003c100: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ -0003c110: 6869 5f69 6e69 7428 29e2 8099 2e0a 0a20  hi_init()...... 
│ │ │ │ -0003c120: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -0003c130: 3a2a 2045 7874 7261 6374 7320 6465 7461  :* Extracts deta
│ │ │ │ -0003c140: 696c 6564 2069 6e66 6f72 6d61 7469 6f6e  iled information
│ │ │ │ -0003c150: 206f 6e20 7468 6520 6d6f 7374 2072 6563   on the most rec
│ │ │ │ -0003c160: 656e 746c 790a 2020 2020 206f 6363 7572  ently.     occur
│ │ │ │ -0003c170: 7265 6420 6572 726f 7220 636f 6e64 6974  red error condit
│ │ │ │ -0003c180: 696f 6e2e 2020 4e6f 7465 2074 6861 7420  ion.  Note that 
│ │ │ │ -0003c190: 6d65 6d6f 7279 2069 7320 6d61 6e61 6765  memory is manage
│ │ │ │ -0003c1a0: 6420 6279 2074 6865 0a20 2020 2020 5368  d by the.     Sh
│ │ │ │ -0003c1b0: 6973 6869 206c 6962 7261 7279 2c20 736f  ishi library, so
│ │ │ │ -0003c1c0: 2074 6865 2072 6574 7572 6e65 6420 7374   the returned st
│ │ │ │ -0003c1d0: 7269 6e67 206d 7573 7420 6e6f 7420 6265  ring must not be
│ │ │ │ -0003c1e0: 2064 6561 6c6c 6f63 6174 6564 2e0a 0a20   deallocated... 
│ │ │ │ -0003c1f0: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ -0003c200: 653a 2a20 5265 7475 726e 7320 6120 706f  e:* Returns a po
│ │ │ │ -0003c210: 696e 7465 7220 746f 2061 2073 7472 696e  inter to a strin
│ │ │ │ -0003c220: 6720 6465 7363 7269 6269 6e67 2061 6e20  g describing an 
│ │ │ │ -0003c230: 6572 726f 722e 0a20 2020 2020 5468 6520  error..     The 
│ │ │ │ -0003c240: 7374 7269 6e67 206d 7573 7420 6e6f 7420  string must not 
│ │ │ │ -0003c250: 6265 2064 6561 6c6c 6f63 6174 6564 2062  be deallocated b
│ │ │ │ -0003c260: 7920 7468 6520 6361 6c6c 6572 2e0a 0a73  y the caller...s
│ │ │ │ -0003c270: 6869 7368 695f 6572 726f 725f 636c 6561  hishi_error_clea
│ │ │ │ -0003c280: 720a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  r.--------------
│ │ │ │ -0003c290: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -0003c2a0: 6f6e 3a20 766f 6964 2073 6869 7368 695f  on: void shishi_
│ │ │ │ -0003c2b0: 6572 726f 725f 636c 6561 7220 2853 6869  error_clear (Shi
│ │ │ │ -0003c2c0: 7368 6920 2a20 4841 4e44 4c45 290a 2020  shi * HANDLE).  
│ │ │ │ -0003c2d0: 2020 2048 414e 444c 453a 2073 6869 7368     HANDLE: shish
│ │ │ │ -0003c2e0: 6920 6861 6e64 6c65 2061 7320 616c 6c6f  i handle as allo
│ │ │ │ -0003c2f0: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ -0003c300: 6869 5f69 6e69 7428 29e2 8099 2e0a 0a20  hi_init()...... 
│ │ │ │ -0003c310: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -0003c320: 3a2a 2043 6c65 6172 7320 7468 6520 696e  :* Clears the in
│ │ │ │ -0003c330: 7465 726e 616c 2065 7272 6f72 2064 6573  ternal error des
│ │ │ │ -0003c340: 6372 6970 7469 6f6e 2e20 2053 6565 0a20  cription.  See. 
│ │ │ │ -0003c350: 2020 2020 e280 9873 6869 7368 695f 6572      ...shishi_er
│ │ │ │ -0003c360: 726f 7228 29e2 8099 206f 6e20 686f 7720  ror()... on how 
│ │ │ │ -0003c370: 746f 2061 6363 6573 7320 7468 6520 6572  to access the er
│ │ │ │ -0003c380: 726f 7220 7374 7269 6e67 2c20 616e 640a  ror string, and.
│ │ │ │ -0003c390: 2020 2020 20e2 8098 7368 6973 6869 5f65       ...shishi_e
│ │ │ │ -0003c3a0: 7272 6f72 5f73 6574 2829 e280 9920 6173  rror_set()... as
│ │ │ │ -0003c3b0: 2077 656c 6c20 6173 20e2 8098 7368 6973   well as ...shis
│ │ │ │ -0003c3c0: 6869 5f65 7272 6f72 5f70 7269 6e74 6628  hi_error_printf(
│ │ │ │ -0003c3d0: 29e2 8099 206f 6e20 686f 7720 746f 0a20  )... on how to. 
│ │ │ │ -0003c3e0: 2020 2020 7365 7420 7468 6520 6572 726f      set the erro
│ │ │ │ -0003c3f0: 7220 7374 7269 6e67 2e0a 0a20 2020 2020  r string...     
│ │ │ │ -0003c400: 5468 6973 2066 756e 6374 696f 6e20 6973  This function is
│ │ │ │ -0003c410: 206d 6f73 746c 7920 666f 7220 5368 6973   mostly for Shis
│ │ │ │ -0003c420: 6869 2773 2069 6e74 6572 6e61 6c20 7573  hi's internal us
│ │ │ │ -0003c430: 652c 2062 7574 2069 6620 796f 750a 2020  e, but if you.  
│ │ │ │ -0003c440: 2020 2064 6576 656c 6f70 2061 6e20 6578     develop an ex
│ │ │ │ -0003c450: 7465 6e73 696f 6e20 6f66 2053 6869 7368  tension of Shish
│ │ │ │ -0003c460: 692c 2069 7420 6d61 7920 6265 2075 7365  i, it may be use
│ │ │ │ -0003c470: 6675 6c20 746f 2073 7570 706f 7274 2074  ful to support t
│ │ │ │ -0003c480: 6865 0a20 2020 2020 7361 6d65 2065 7272  he.     same err
│ │ │ │ -0003c490: 6f72 2068 616e 646c 696e 6720 696e 6672  or handling infr
│ │ │ │ -0003c4a0: 6173 7472 7563 7475 7265 2e0a 0a73 6869  astructure...shi
│ │ │ │ -0003c4b0: 7368 695f 6572 726f 725f 7365 740a 2d2d  shi_error_set.--
│ │ │ │ -0003c4c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -0003c4d0: 202d 2d20 4675 6e63 7469 6f6e 3a20 766f   -- Function: vo
│ │ │ │ -0003c4e0: 6964 2073 6869 7368 695f 6572 726f 725f  id shishi_error_
│ │ │ │ -0003c4f0: 7365 7420 2853 6869 7368 6920 2a20 4841  set (Shishi * HA
│ │ │ │ -0003c500: 4e44 4c45 2c0a 2020 2020 2020 2020 2020  NDLE,.          
│ │ │ │ -0003c510: 636f 6e73 7420 6368 6172 202a 2045 5252  const char * ERR
│ │ │ │ -0003c520: 5354 5229 0a20 2020 2020 4841 4e44 4c45  STR).     HANDLE
│ │ │ │ -0003c530: 3a20 7368 6973 6869 2068 616e 646c 6520  : shishi handle 
│ │ │ │ -0003c540: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ -0003c550: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ -0003c560: e280 992e 0a20 2020 2020 4552 5253 5452  .....     ERRSTR
│ │ │ │ -0003c570: 3a20 4120 6e75 6c6c 2d74 6572 6d69 6e61  : A null-termina
│ │ │ │ -0003c580: 7465 6420 6368 6172 6163 7465 7220 7374  ted character st
│ │ │ │ -0003c590: 7269 6e67 2068 6f6c 6469 6e67 2061 2064  ring holding a d
│ │ │ │ -0003c5a0: 6573 6372 6970 7469 6f6e 2c0a 2020 2020  escription,.    
│ │ │ │ -0003c5b0: 206f 7220 e280 984e 554c 4ce2 8099 2074   or ...NULL... t
│ │ │ │ -0003c5c0: 6f20 636c 6561 7220 7468 6520 696e 7465  o clear the inte
│ │ │ │ -0003c5d0: 726e 616c 2065 7272 6f72 2073 7472 696e  rnal error strin
│ │ │ │ -0003c5e0: 672e 0a0a 2020 2020 202a 4465 7363 7269  g...     *Descri
│ │ │ │ -0003c5f0: 7074 696f 6e3a 2a20 5365 7473 2074 6865  ption:* Sets the
│ │ │ │ -0003c600: 2065 7272 6f72 2064 6573 6372 6970 7469   error descripti
│ │ │ │ -0003c610: 6f6e 2074 6f20 7468 6520 636f 6e74 656e  on to the conten
│ │ │ │ -0003c620: 7420 6f66 2045 5252 5354 522e 0a20 2020  t of ERRSTR..   
│ │ │ │ -0003c630: 2020 5468 6520 7374 7269 6e67 2069 7320    The string is 
│ │ │ │ -0003c640: 636f 7069 6564 2069 6e74 6f20 7468 6520  copied into the 
│ │ │ │ -0003c650: 5368 6973 6869 2069 6e74 6572 6e61 6c20  Shishi internal 
│ │ │ │ -0003c660: 7374 7275 6374 7572 652c 2073 6f20 796f  structure, so yo
│ │ │ │ -0003c670: 7520 6361 6e0a 2020 2020 2064 6561 6c6c  u can.     deall
│ │ │ │ -0003c680: 6f63 6174 6520 616e 7920 7374 7269 6e67  ocate any string
│ │ │ │ -0003c690: 2070 6173 7365 6420 746f 2074 6869 7320   passed to this 
│ │ │ │ -0003c6a0: 6675 6e63 7469 6f6e 2e0a 0a20 2020 2020  function...     
│ │ │ │ -0003c6b0: 5468 6973 2066 756e 6374 696f 6e20 6973  This function is
│ │ │ │ -0003c6c0: 206d 6f73 746c 7920 666f 7220 5368 6973   mostly for Shis
│ │ │ │ -0003c6d0: 6869 2773 2069 6e74 6572 6e61 6c20 7573  hi's internal us
│ │ │ │ -0003c6e0: 652c 2062 7574 2069 6620 796f 750a 2020  e, but if you.  
│ │ │ │ -0003c6f0: 2020 2064 6576 656c 6f70 2061 6e20 6578     develop an ex
│ │ │ │ -0003c700: 7465 6e73 696f 6e20 6f66 2053 6869 7368  tension of Shish
│ │ │ │ -0003c710: 692c 2069 7420 6d61 7920 6265 2075 7365  i, it may be use
│ │ │ │ -0003c720: 6675 6c20 746f 2073 7570 706f 7274 2074  ful to support t
│ │ │ │ -0003c730: 6865 0a20 2020 2020 7361 6d65 2065 7272  he.     same err
│ │ │ │ -0003c740: 6f72 2068 616e 646c 696e 6720 696e 6672  or handling infr
│ │ │ │ -0003c750: 6173 7472 7563 7475 7265 2e0a 0a73 6869  astructure...shi
│ │ │ │ -0003c760: 7368 695f 6572 726f 725f 7072 696e 7466  shi_error_printf
│ │ │ │ -0003c770: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ -0003c780: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ -0003c790: 6f6e 3a20 766f 6964 2073 6869 7368 695f  on: void shishi_
│ │ │ │ -0003c7a0: 6572 726f 725f 7072 696e 7466 2028 5368  error_printf (Sh
│ │ │ │ -0003c7b0: 6973 6869 202a 2048 414e 444c 452c 0a20  ishi * HANDLE,. 
│ │ │ │ -0003c7c0: 2020 2020 2020 2020 2063 6f6e 7374 2063           const c
│ │ │ │ -0003c7d0: 6861 7220 2a20 464f 524d 4154 2c20 2e2e  har * FORMAT, ..
│ │ │ │ -0003c7e0: 2e29 0a20 2020 2020 4841 4e44 4c45 3a20  .).     HANDLE: 
│ │ │ │ -0003c7f0: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ -0003c800: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ -0003c810: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ -0003c820: 992e 0a20 2020 2020 464f 524d 4154 3a20  ...     FORMAT: 
│ │ │ │ -0003c830: 7072 696e 7466 2073 7479 6c65 2066 6f72  printf style for
│ │ │ │ -0003c840: 6d61 7420 7374 7269 6e67 2e0a 2020 2020  mat string..    
│ │ │ │ -0003c850: 202e 2e2e 3a20 7072 696e 7466 2073 7479   ...: printf sty
│ │ │ │ -0003c860: 6c65 2061 7267 756d 656e 7473 2e0a 0a20  le arguments... 
│ │ │ │ -0003c870: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -0003c880: 3a2a 2053 6574 7320 7468 6520 696e 7465  :* Sets the inte
│ │ │ │ -0003c890: 726e 616c 2065 7272 6f72 2064 6573 6372  rnal error descr
│ │ │ │ -0003c8a0: 6970 7469 6f6e 2074 6f20 6120 7072 696e  iption to a prin
│ │ │ │ -0003c8b0: 7466 2833 290a 2020 2020 2066 6f72 6d61  tf(3).     forma
│ │ │ │ -0003c8c0: 7474 6564 2073 7472 696e 672e 2020 5468  tted string.  Th
│ │ │ │ -0003c8d0: 6973 2066 756e 6374 696f 6e20 6973 206d  is function is m
│ │ │ │ -0003c8e0: 6f73 746c 7920 666f 7220 5368 6973 6869  ostly for Shishi
│ │ │ │ -0003c8f0: 2773 2069 6e74 6572 6e61 6c0a 2020 2020  's internal.    
│ │ │ │ -0003c900: 2075 7365 2c20 6275 7420 6966 2079 6f75   use, but if you
│ │ │ │ -0003c910: 2064 6576 656c 6f70 2061 6e20 6578 7465   develop an exte
│ │ │ │ -0003c920: 6e73 696f 6e20 6f66 2053 6869 7368 692c  nsion of Shishi,
│ │ │ │ -0003c930: 2069 7420 6d61 7920 6265 2075 7365 6675   it may be usefu
│ │ │ │ -0003c940: 6c20 746f 0a20 2020 2020 7375 7070 6f72  l to.     suppor
│ │ │ │ -0003c950: 7420 7468 6520 7361 6d65 2069 6e66 7261  t the same infra
│ │ │ │ -0003c960: 7374 7275 6374 7572 6520 666f 7220 6572  structure for er
│ │ │ │ -0003c970: 726f 7220 6861 6e64 6c69 6e67 2e0a 0a73  ror handling...s
│ │ │ │ -0003c980: 6869 7368 695f 6572 726f 725f 6f75 7470  hishi_error_outp
│ │ │ │ -0003c990: 7574 7479 7065 0a2d 2d2d 2d2d 2d2d 2d2d  uttype.---------
│ │ │ │ -0003c9a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -0003c9b0: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ -0003c9c0: 7420 7368 6973 6869 5f65 7272 6f72 5f6f  t shishi_error_o
│ │ │ │ -0003c9d0: 7574 7075 7474 7970 6520 2853 6869 7368  utputtype (Shish
│ │ │ │ -0003c9e0: 6920 2a20 4841 4e44 4c45 290a 2020 2020  i * HANDLE).    
│ │ │ │ -0003c9f0: 2048 414e 444c 453a 2073 6869 7368 6920   HANDLE: shishi 
│ │ │ │ -0003ca00: 6861 6e64 6c65 2061 7320 616c 6c6f 6361  handle as alloca
│ │ │ │ -0003ca10: 7465 6420 6279 20e2 8098 7368 6973 6869  ted by ...shishi
│ │ │ │ -0003ca20: 5f69 6e69 7428 29e2 8099 2e0a 0a20 2020  _init()......   
│ │ │ │ -0003ca30: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ -0003ca40: 2052 6570 6f72 7473 2074 6865 2063 7572   Reports the cur
│ │ │ │ -0003ca50: 7265 6e74 206f 7574 7075 7420 7479 7065  rent output type
│ │ │ │ -0003ca60: 2075 7365 6420 696e 206d 6573 7361 6765   used in message
│ │ │ │ -0003ca70: 0a20 2020 2020 6c6f 6767 696e 672e 0a0a  .     logging...
│ │ │ │ -0003ca80: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ -0003ca90: 7565 3a2a 2052 6574 7572 6e73 2074 6865  ue:* Returns the
│ │ │ │ -0003caa0: 206f 7574 7075 7420 7479 7065 2e20 20e2   output type.  .
│ │ │ │ -0003cab0: 8098 5348 4953 4849 5f4f 5554 5055 5454  ..SHISHI_OUTPUTT
│ │ │ │ -0003cac0: 5950 455f 4e55 4c4c e280 990a 2020 2020  YPE_NULL....    
│ │ │ │ -0003cad0: 206d 6561 6e73 206e 6f20 6f75 7470 7574   means no output
│ │ │ │ -0003cae0: 2e20 20e2 8098 5348 4953 4849 5f4f 5554  .  ...SHISHI_OUT
│ │ │ │ -0003caf0: 5055 5454 5950 455f 5354 4445 5252 e280  PUTTYPE_STDERR..
│ │ │ │ -0003cb00: 9920 616e 640a 2020 2020 20e2 8098 5348  . and.     ...SH
│ │ │ │ -0003cb10: 4953 4849 5f4f 5554 5055 5454 5950 455f  ISHI_OUTPUTTYPE_
│ │ │ │ -0003cb20: 5359 534c 4f47 e280 9920 6469 7265 6374  SYSLOG... direct
│ │ │ │ -0003cb30: 2074 6578 7420 746f 2074 6865 2063 6f6e   text to the con
│ │ │ │ -0003cb40: 736f 6c65 2c20 6f72 2074 6f20 7468 650a  sole, or to the.
│ │ │ │ -0003cb50: 2020 2020 2073 7973 6c6f 6720 7379 7374       syslog syst
│ │ │ │ -0003cb60: 656d 2e0a 0a73 6869 7368 695f 6572 726f  em...shishi_erro
│ │ │ │ -0003cb70: 725f 7365 745f 6f75 7470 7574 7479 7065  r_set_outputtype
│ │ │ │ -0003cb80: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ -0003cb90: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ -0003cba0: 2d20 4675 6e63 7469 6f6e 3a20 766f 6964  - Function: void
│ │ │ │ -0003cbb0: 2073 6869 7368 695f 6572 726f 725f 7365   shishi_error_se
│ │ │ │ -0003cbc0: 745f 6f75 7470 7574 7479 7065 2028 5368  t_outputtype (Sh
│ │ │ │ -0003cbd0: 6973 6869 202a 2048 414e 444c 452c 0a20  ishi * HANDLE,. 
│ │ │ │ -0003cbe0: 2020 2020 2020 2020 2069 6e74 2054 5950           int TYP
│ │ │ │ -0003cbf0: 4529 0a20 2020 2020 4841 4e44 4c45 3a20  E).     HANDLE: 
│ │ │ │ -0003cc00: 7368 6973 6869 2068 616e 646c 6520 6173  shishi handle as
│ │ │ │ -0003cc10: 2061 6c6c 6f63 6174 6564 2062 7920 e280   allocated by ..
│ │ │ │ -0003cc20: 9873 6869 7368 695f 696e 6974 2829 e280  .shishi_init()..
│ │ │ │ -0003cc30: 992e 0a20 2020 2020 5459 5045 3a20 6f75  ...     TYPE: ou
│ │ │ │ -0003cc40: 7470 7574 2074 7970 652c 206f 6620 656e  tput type, of en
│ │ │ │ -0003cc50: 756d 2074 7970 6520 e280 9853 6869 7368  um type ...Shish
│ │ │ │ -0003cc60: 695f 6f75 7470 7574 7479 7065 e280 992e  i_outputtype....
│ │ │ │ -0003cc70: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ -0003cc80: 696f 6e3a 2a20 5365 7473 2074 6865 206f  ion:* Sets the o
│ │ │ │ -0003cc90: 7574 7075 7420 7479 7065 2028 e280 984e  utput type (...N
│ │ │ │ -0003cca0: 554c 4ce2 8099 2c20 e280 9873 7464 6572  ULL..., ...stder
│ │ │ │ -0003ccb0: 72e2 8099 206f 7220 e280 9873 7973 6c6f  r... or ...syslo
│ │ │ │ -0003ccc0: 67e2 8099 290a 2020 2020 2075 7365 6420  g...).     used 
│ │ │ │ -0003ccd0: 666f 7220 696e 666f 726d 6174 696f 6e20  for information 
│ │ │ │ -0003cce0: 616e 6420 7761 726e 696e 6720 6d65 7373  and warning mess
│ │ │ │ -0003ccf0: 6167 6573 2e20 2049 6e74 656e 6465 6420  ages.  Intended 
│ │ │ │ -0003cd00: 7661 6c75 6573 2061 7265 0a20 2020 2020  values are.     
│ │ │ │ -0003cd10: e280 9853 4849 5348 495f 4f55 5450 5554  ...SHISHI_OUTPUT
│ │ │ │ -0003cd20: 5459 5045 5f4e 554c 4ce2 8099 2c20 666f  TYPE_NULL..., fo
│ │ │ │ -0003cd30: 7220 6e6f 206f 7574 7075 7420 6174 2061  r no output at a
│ │ │ │ -0003cd40: 6c6c 2c0a 2020 2020 20e2 8098 5348 4953  ll,.     ...SHIS
│ │ │ │ -0003cd50: 4849 5f4f 5554 5055 5454 5950 455f 5354  HI_OUTPUTTYPE_ST
│ │ │ │ -0003cd60: 4445 5252 e280 9920 666f 7220 6f75 7470  DERR... for outp
│ │ │ │ -0003cd70: 7574 2074 6f20 7468 6520 636f 6e73 6f6c  ut to the consol
│ │ │ │ -0003cd80: 652c 2061 6e64 0a20 2020 2020 e280 9853  e, and.     ...S
│ │ │ │ -0003cd90: 4849 5348 495f 4f55 5450 5554 5459 5045  HISHI_OUTPUTTYPE
│ │ │ │ -0003cda0: 5f53 5953 4c4f 47e2 8099 2066 6f72 2073  _SYSLOG... for s
│ │ │ │ -0003cdb0: 7973 6c6f 6720 6d65 7373 6167 696e 672e  yslog messaging.
│ │ │ │ -0003cdc0: 2020 5468 6520 6669 7273 7420 7661 6c75    The first valu
│ │ │ │ -0003cdd0: 650a 2020 2020 2063 6f76 6572 7320 6576  e.     covers ev
│ │ │ │ -0003cde0: 6572 7974 6869 6e67 2064 6966 6665 7265  erything differe
│ │ │ │ -0003cdf0: 6e74 2066 726f 6d20 7468 6520 6c61 7474  nt from the latt
│ │ │ │ -0003ce00: 6572 2074 776f 2076 616c 7565 732e 0a0a  er two values...
│ │ │ │ -0003ce10: 7368 6973 6869 5f69 6e66 6f0a 2d2d 2d2d  shishi_info.----
│ │ │ │ -0003ce20: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  -------.. -- Fun
│ │ │ │ -0003ce30: 6374 696f 6e3a 2076 6f69 6420 7368 6973  ction: void shis
│ │ │ │ -0003ce40: 6869 5f69 6e66 6f20 2853 6869 7368 6920  hi_info (Shishi 
│ │ │ │ -0003ce50: 2a20 4841 4e44 4c45 2c20 636f 6e73 7420  * HANDLE, const 
│ │ │ │ -0003ce60: 6368 6172 202a 2046 4f52 4d41 542c 0a20  char * FORMAT,. 
│ │ │ │ -0003ce70: 2020 2020 2020 2020 202e 2e2e 290a 2020           ...).  
│ │ │ │ -0003ce80: 2020 2048 414e 444c 453a 2073 6869 7368     HANDLE: shish
│ │ │ │ -0003ce90: 6920 6861 6e64 6c65 2061 7320 616c 6c6f  i handle as allo
│ │ │ │ -0003cea0: 6361 7465 6420 6279 20e2 8098 7368 6973  cated by ...shis
│ │ │ │ -0003ceb0: 6869 5f69 6e69 7428 29e2 8099 2e0a 2020  hi_init().....  
│ │ │ │ -0003cec0: 2020 2046 4f52 4d41 543a 2070 7269 6e74     FORMAT: print
│ │ │ │ -0003ced0: 6620 7374 796c 6520 666f 726d 6174 2073  f style format s
│ │ │ │ -0003cee0: 7472 696e 672e 0a20 2020 2020 2e2e 2e3a  tring..     ...:
│ │ │ │ -0003cef0: 2070 7269 6e74 6620 7374 796c 6520 6172   printf style ar
│ │ │ │ -0003cf00: 6775 6d65 6e74 732e 0a0a 2020 2020 202a  guments...     *
│ │ │ │ -0003cf10: 4465 7363 7269 7074 696f 6e3a 2a20 5072  Description:* Pr
│ │ │ │ -0003cf20: 696e 7473 2061 6e20 696e 666f 726d 6174  ints an informat
│ │ │ │ -0003cf30: 696f 6e61 6c20 6d65 7373 6167 652c 2063  ional message, c
│ │ │ │ -0003cf40: 6f6d 706f 7365 6420 6672 6f6d 2074 6865  omposed from the
│ │ │ │ -0003cf50: 0a20 2020 2020 6172 6775 6d65 6e74 732c  .     arguments,
│ │ │ │ -0003cf60: 2074 6f20 7468 6520 6f75 7470 7574 2073   to the output s
│ │ │ │ -0003cf70: 7472 6561 6d20 7365 7420 696e 2048 414e  tream set in HAN
│ │ │ │ -0003cf80: 444c 452e 0a0a 7368 6973 6869 5f77 6172  DLE...shishi_war
│ │ │ │ -0003cf90: 6e0a 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  n.-----------.. 
│ │ │ │ -0003cfa0: 2d2d 2046 756e 6374 696f 6e3a 2076 6f69  -- Function: voi
│ │ │ │ -0003cfb0: 6420 7368 6973 6869 5f77 6172 6e20 2853  d shishi_warn (S
│ │ │ │ -0003cfc0: 6869 7368 6920 2a20 4841 4e44 4c45 2c20  hishi * HANDLE, 
│ │ │ │ -0003cfd0: 636f 6e73 7420 6368 6172 202a 2046 4f52  const char * FOR
│ │ │ │ -0003cfe0: 4d41 542c 0a20 2020 2020 2020 2020 202e  MAT,.          .
│ │ │ │ -0003cff0: 2e2e 290a 2020 2020 2048 414e 444c 453a  ..).     HANDLE:
│ │ │ │ -0003d000: 2073 6869 7368 6920 6861 6e64 6c65 2061   shishi handle a
│ │ │ │ -0003d010: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ -0003d020: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ -0003d030: 8099 2e0a 2020 2020 2046 4f52 4d41 543a  ....     FORMAT:
│ │ │ │ -0003d040: 2070 7269 6e74 6620 7374 796c 6520 666f   printf style fo
│ │ │ │ -0003d050: 726d 6174 2073 7472 696e 672e 0a20 2020  rmat string..   
│ │ │ │ -0003d060: 2020 2e2e 2e3a 2070 7269 6e74 6620 7374    ...: printf st
│ │ │ │ -0003d070: 796c 6520 6172 6775 6d65 6e74 732e 0a0a  yle arguments...
│ │ │ │ -0003d080: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ -0003d090: 6e3a 2a20 5072 696e 7473 2061 2077 6172  n:* Prints a war
│ │ │ │ -0003d0a0: 6e69 6e67 2c20 636f 6d70 6f73 6564 2066  ning, composed f
│ │ │ │ -0003d0b0: 726f 6d20 7468 6520 6172 6775 6d65 6e74  rom the argument
│ │ │ │ -0003d0c0: 732c 2074 6f0a 2020 2020 2074 6865 206f  s, to.     the o
│ │ │ │ -0003d0d0: 7574 7075 7420 7374 7265 616d 2073 6574  utput stream set
│ │ │ │ -0003d0e0: 2069 6e20 4841 4e44 4c45 2e0a 0a73 6869   in HANDLE...shi
│ │ │ │ -0003d0f0: 7368 695f 7665 7262 6f73 650a 2d2d 2d2d  shi_verbose.----
│ │ │ │ -0003d100: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ -0003d110: 4675 6e63 7469 6f6e 3a20 766f 6964 2073  Function: void s
│ │ │ │ -0003d120: 6869 7368 695f 7665 7262 6f73 6520 2853  hishi_verbose (S
│ │ │ │ -0003d130: 6869 7368 6920 2a20 4841 4e44 4c45 2c20  hishi * HANDLE, 
│ │ │ │ -0003d140: 636f 6e73 7420 6368 6172 202a 2046 4f52  const char * FOR
│ │ │ │ -0003d150: 4d41 542c 0a20 2020 2020 2020 2020 202e  MAT,.          .
│ │ │ │ -0003d160: 2e2e 290a 2020 2020 2048 414e 444c 453a  ..).     HANDLE:
│ │ │ │ -0003d170: 2073 6869 7368 6920 6861 6e64 6c65 2061   shishi handle a
│ │ │ │ -0003d180: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ -0003d190: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ -0003d1a0: 8099 2e0a 2020 2020 2046 4f52 4d41 543a  ....     FORMAT:
│ │ │ │ -0003d1b0: 2070 7269 6e74 6620 7374 796c 6520 666f   printf style fo
│ │ │ │ -0003d1c0: 726d 6174 2073 7472 696e 672e 0a20 2020  rmat string..   
│ │ │ │ -0003d1d0: 2020 2e2e 2e3a 2070 7269 6e74 6620 7374    ...: printf st
│ │ │ │ -0003d1e0: 796c 6520 6172 6775 6d65 6e74 732e 0a0a  yle arguments...
│ │ │ │ -0003d1f0: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ -0003d200: 6e3a 2a20 5072 696e 7473 2061 2064 6961  n:* Prints a dia
│ │ │ │ -0003d210: 676e 6f73 7469 6320 6d65 7373 6167 652c  gnostic message,
│ │ │ │ -0003d220: 2063 6f6d 706f 7365 6420 6672 6f6d 2074   composed from t
│ │ │ │ -0003d230: 6865 0a20 2020 2020 6172 6775 6d65 6e74  he.     argument
│ │ │ │ -0003d240: 732c 2074 6f20 7468 6520 6f75 7470 7574  s, to the output
│ │ │ │ -0003d250: 2073 7472 6561 6d20 7365 7420 696e 2048   stream set in H
│ │ │ │ -0003d260: 414e 444c 452e 2020 5468 6520 6375 7272  ANDLE.  The curr
│ │ │ │ -0003d270: 656e 740a 2020 2020 2076 6572 626f 7369  ent.     verbosi
│ │ │ │ -0003d280: 7479 2073 6574 7469 6e67 2064 6574 6572  ty setting deter
│ │ │ │ -0003d290: 6d69 6e65 7320 7768 6574 6865 7220 7468  mines whether th
│ │ │ │ -0003d2a0: 6520 6d65 7373 6167 6520 6973 2061 6374  e message is act
│ │ │ │ -0003d2b0: 7561 6c6c 790a 2020 2020 2070 7269 6e74  ually.     print
│ │ │ │ -0003d2c0: 6564 2c20 6f72 2069 7320 7375 7070 7265  ed, or is suppre
│ │ │ │ -0003d2d0: 7373 6564 2064 7565 2074 6f20 6c6f 7720  ssed due to low 
│ │ │ │ -0003d2e0: 7369 676e 6966 6963 616e 6365 2e0a 0a1f  significance....
│ │ │ │ -0003d2f0: 0a46 696c 653a 2073 6869 7368 692e 696e  .File: shishi.in
│ │ │ │ -0003d300: 666f 2c20 204e 6f64 653a 2045 7861 6d70  fo,  Node: Examp
│ │ │ │ -0003d310: 6c65 732c 2020 4e65 7874 3a20 4b65 7262  les,  Next: Kerb
│ │ │ │ -0003d320: 6572 6f73 2044 6174 6162 6173 6520 4675  eros Database Fu
│ │ │ │ -0003d330: 6e63 7469 6f6e 732c 2020 5072 6576 3a20  nctions,  Prev: 
│ │ │ │ -0003d340: 4572 726f 7220 4861 6e64 6c69 6e67 2c20  Error Handling, 
│ │ │ │ -0003d350: 2055 703a 2050 726f 6772 616d 6d69 6e67   Up: Programming
│ │ │ │ -0003d360: 204d 616e 7561 6c0a 0a35 2e31 3820 4578   Manual..5.18 Ex
│ │ │ │ -0003d370: 616d 706c 6573 0a3d 3d3d 3d3d 3d3d 3d3d  amples.=========
│ │ │ │ -0003d380: 3d3d 3d3d 0a0a 5468 6973 2073 6563 7469  ====..This secti
│ │ │ │ -0003d390: 6f6e 2077 696c 6c20 6265 2065 7874 656e  on will be exten
│ │ │ │ -0003d3a0: 6465 6420 746f 2063 6f6e 7461 696e 2077  ded to contain w
│ │ │ │ -0003d3b0: 616c 6b2d 7468 726f 7567 6873 206f 6620  alk-throughs of 
│ │ │ │ -0003d3c0: 6578 616d 706c 6520 636f 6465 0a74 6861  example code.tha
│ │ │ │ -0003d3d0: 7420 6465 6d6f 6e73 7472 6174 6520 686f  t demonstrate ho
│ │ │ │ -0003d3e0: 7720 2753 6869 7368 6927 2069 7320 7573  w 'Shishi' is us
│ │ │ │ -0003d3f0: 6564 2074 6f20 7772 6974 6520 796f 7572  ed to write your
│ │ │ │ -0003d400: 206f 776e 2061 7070 6c69 6361 7469 6f6e   own application
│ │ │ │ -0003d410: 730a 7468 6174 2073 7570 706f 7274 204b  s.that support K
│ │ │ │ -0003d420: 6572 6265 726f 7320 352e 2020 5468 6520  erberos 5.  The 
│ │ │ │ -0003d430: 7265 7374 206f 6620 7468 6520 6375 7272  rest of the curr
│ │ │ │ -0003d440: 656e 7420 7365 6374 696f 6e20 636f 6e73  ent section cons
│ │ │ │ -0003d450: 6973 7473 206f 660a 736f 6d65 2063 7275  ists of.some cru
│ │ │ │ -0003d460: 6465 2068 696e 7473 2066 6f72 2074 6865  de hints for the
│ │ │ │ -0003d470: 2065 7861 6d70 6c65 2063 6c69 656e 742f   example client/
│ │ │ │ -0003d480: 7365 7276 6572 2061 7070 6c69 6361 7469  server applicati
│ │ │ │ -0003d490: 6f6e 7320 7468 6174 2069 7320 7061 7274  ons that is part
│ │ │ │ -0003d4a0: 0a6f 6620 5368 6973 6869 2c20 7461 6b65  .of Shishi, take
│ │ │ │ -0003d4b0: 6e20 6672 6f6d 2061 6e20 656d 6169 6c20  n from an email 
│ │ │ │ -0003d4c0: 6275 7420 7361 7665 6420 6865 7265 2066  but saved here f
│ │ │ │ -0003d4d0: 6f72 206c 6163 6b20 6f66 2061 2062 6574  or lack of a bet
│ │ │ │ -0003d4e0: 7465 7220 706c 6163 650a 746f 2070 7574  ter place.to put
│ │ │ │ -0003d4f0: 2069 742e 0a0a 2020 2054 6865 7265 2061   it...   There a
│ │ │ │ -0003d500: 7265 2074 776f 2070 726f 6772 616d 733a  re two programs:
│ │ │ │ -0003d510: 2027 636c 6965 6e74 2720 616e 6420 2773   'client' and 's
│ │ │ │ -0003d520: 6572 7665 7227 2069 6e20 7372 632f 2e0a  erver' in src/..
│ │ │ │ -0003d530: 0a20 2020 5468 6520 636c 6965 6e74 206f  .   The client o
│ │ │ │ -0003d540: 7574 7075 7420 616e 2041 502d 5245 512c  utput an AP-REQ,
│ │ │ │ -0003d550: 2077 6169 7473 2066 6f72 2061 6e20 4150   waits for an AP
│ │ │ │ -0003d560: 2d52 4550 2c20 616e 6420 7468 656e 2073  -REP, and then s
│ │ │ │ -0003d570: 696d 706c 790a 7265 6164 7320 6461 7461  imply.reads data
│ │ │ │ -0003d580: 2066 726f 6d20 7374 6469 6e2e 0a0a 2020   from stdin...  
│ │ │ │ -0003d590: 2054 6865 2073 6572 7665 7220 7761 6974   The server wait
│ │ │ │ -0003d5a0: 7320 666f 7220 616e 2041 502d 5245 512c  s for an AP-REQ,
│ │ │ │ -0003d5b0: 2070 6172 7365 7320 6974 2061 6e64 2070   parses it and p
│ │ │ │ -0003d5c0: 7269 6e74 7320 616e 2041 502d 5245 502c  rints an AP-REP,
│ │ │ │ -0003d5d0: 2061 6e64 0a74 6865 6e20 7265 6164 2064   and.then read d
│ │ │ │ -0003d5e0: 6174 6120 6672 6f6d 2073 7464 696e 2e0a  ata from stdin..
│ │ │ │ -0003d5f0: 0a20 2020 426f 7468 2070 726f 6772 616d  .   Both program
│ │ │ │ -0003d600: 7320 6163 6365 7074 2061 204b 6572 6265  s accept a Kerbe
│ │ │ │ -0003d610: 726f 7320 7365 7276 6572 206e 616d 6520  ros server name 
│ │ │ │ -0003d620: 6173 2074 6865 2066 6972 7374 2063 6f6d  as the first com
│ │ │ │ -0003d630: 6d61 6e64 206c 696e 650a 6172 6775 6d65  mand line.argume
│ │ │ │ -0003d640: 6e74 2e20 2059 6f75 7220 4b44 4320 6d75  nt.  Your KDC mu
│ │ │ │ -0003d650: 7374 206b 6e6f 7720 7468 6973 2073 6572  st know this ser
│ │ │ │ -0003d660: 7665 722c 2073 696e 6365 2074 6865 2063  ver, since the c
│ │ │ │ -0003d670: 6c69 656e 7420 7472 6965 7320 746f 2067  lient tries to g
│ │ │ │ -0003d680: 6574 0a61 2074 6963 6b65 7420 666f 7220  et.a ticket for 
│ │ │ │ -0003d690: 6974 2028 6669 7273 7420 6974 2067 6574  it (first it get
│ │ │ │ -0003d6a0: 7320 6120 7469 636b 6574 2067 7261 6e74  s a ticket grant
│ │ │ │ -0003d6b0: 696e 6720 7469 636b 6574 2066 6f72 2074  ing ticket for t
│ │ │ │ -0003d6c0: 6865 2064 6566 6175 6c74 0a75 7365 726e  he default.usern
│ │ │ │ -0003d6d0: 616d 6529 2c20 616e 6420 796f 7520 6d75  ame), and you mu
│ │ │ │ -0003d6e0: 7374 2077 7269 7465 2074 6865 206b 6579  st write the key
│ │ │ │ -0003d6f0: 2066 6f72 2074 6865 2073 6572 7665 7220   for the server 
│ │ │ │ -0003d700: 696e 746f 0a2f 7573 722f 6c6f 6361 6c2f  into./usr/local/
│ │ │ │ -0003d710: 6574 632f 7368 6973 6869 2e6b 6579 7320  etc/shishi.keys 
│ │ │ │ -0003d720: 6f6e 2074 6865 2053 6869 7368 6920 666f  on the Shishi fo
│ │ │ │ -0003d730: 726d 6174 2c20 652e 672e 3a0a 0a20 2020  rmat, e.g.:..   
│ │ │ │ -0003d740: 2020 2d2d 2d2d 2d42 4547 494e 2053 4849    -----BEGIN SHI
│ │ │ │ -0003d750: 5348 4920 4b45 592d 2d2d 2d2d 0a20 2020  SHI KEY-----.   
│ │ │ │ -0003d760: 2020 4b65 7974 7970 653a 2031 3620 2864    Keytype: 16 (d
│ │ │ │ -0003d770: 6573 332d 6362 632d 7368 6131 2d6b 6429  es3-cbc-sha1-kd)
│ │ │ │ -0003d780: 0a20 2020 2020 5072 696e 6369 7061 6c3a  .     Principal:
│ │ │ │ -0003d790: 2073 616d 706c 652f 6c61 7474 652e 6a6f   sample/latte.jo
│ │ │ │ -0003d7a0: 7365 6673 736f 6e2e 6f72 670a 2020 2020  sefsson.org.    
│ │ │ │ -0003d7b0: 2052 6561 6c6d 3a20 4a4f 5345 4653 534f   Realm: JOSEFSSO
│ │ │ │ -0003d7c0: 4e2e 4f52 470a 0a20 2020 2020 3857 3056  N.ORG..     8W0V
│ │ │ │ -0003d7d0: 7251 5142 7078 6c41 4350 5145 714e 3931  rQQBpxlACPQEqN91
│ │ │ │ -0003d7e0: 4548 7862 7646 466f 326c 7474 0a20 2020  EHxbvFFo2ltt.   
│ │ │ │ -0003d7f0: 2020 2d2d 2d2d 2d45 4e44 2053 4849 5348    -----END SHISH
│ │ │ │ -0003d800: 4920 4b45 592d 2d2d 2d2d 0a0a 2020 2059  I KEY-----..   Y
│ │ │ │ -0003d810: 6f75 206d 7573 7420 6578 7472 6163 7420  ou must extract 
│ │ │ │ -0003d820: 7468 6520 7072 6f70 6572 2065 6e63 7279  the proper encry
│ │ │ │ -0003d830: 7074 696f 6e20 6b65 7920 6672 6f6d 2074  ption key from t
│ │ │ │ -0003d840: 6865 204b 4443 2069 6e20 736f 6d65 2077  he KDC in some w
│ │ │ │ -0003d850: 6179 2e0a 2854 6869 7320 7061 7274 2077  ay..(This part w
│ │ │ │ -0003d860: 696c 6c20 6265 2065 6173 6965 7220 7768  ill be easier wh
│ │ │ │ -0003d870: 656e 2053 6869 7368 6920 696e 636c 7564  en Shishi includ
│ │ │ │ -0003d880: 6520 6120 4b44 432c 2061 2062 6173 6963  e a KDC, a basic
│ │ │ │ -0003d890: 206f 6e65 2069 736e 2774 0a66 6172 2061   one isn't.far a
│ │ │ │ -0003d8a0: 7761 792c 2067 6976 6520 6d65 2061 2077  way, give me a w
│ │ │ │ -0003d8b0: 6565 6b20 6f72 2074 6f2e 290a 0a20 2020  eek or to.)..   
│ │ │ │ -0003d8c0: 5468 6520 696e 7465 6e74 696f 6e20 6973  The intention is
│ │ │ │ -0003d8d0: 2074 6861 7420 7468 6520 6461 7461 2072   that the data r
│ │ │ │ -0003d8e0: 6561 642c 2061 6674 6572 2074 6865 2061  ead, after the a
│ │ │ │ -0003d8f0: 7574 6865 6e74 6963 6174 696f 6e20 7068  uthentication ph
│ │ │ │ -0003d900: 6173 652c 0a73 686f 756c 6420 6265 2070  ase,.should be p
│ │ │ │ -0003d910: 726f 7465 6374 6564 2075 7369 6e67 204b  rotected using K
│ │ │ │ -0003d920: 5242 5f53 4146 4520 2873 6565 2052 4643  RB_SAFE (see RFC
│ │ │ │ -0003d930: 2920 6275 7420 4920 6861 7665 6e27 7420  ) but I haven't 
│ │ │ │ -0003d940: 6164 6465 6420 7468 6973 0a79 6574 2e0a  added this.yet..
│ │ │ │ -0003d950: 0a1f 0a46 696c 653a 2073 6869 7368 692e  ...File: shishi.
│ │ │ │ -0003d960: 696e 666f 2c20 204e 6f64 653a 204b 6572  info,  Node: Ker
│ │ │ │ -0003d970: 6265 726f 7320 4461 7461 6261 7365 2046  beros Database F
│ │ │ │ -0003d980: 756e 6374 696f 6e73 2c20 204e 6578 743a  unctions,  Next:
│ │ │ │ -0003d990: 2047 656e 6572 6963 2053 6563 7572 6974   Generic Securit
│ │ │ │ -0003d9a0: 7920 5365 7276 6963 652c 2020 5072 6576  y Service,  Prev
│ │ │ │ -0003d9b0: 3a20 4578 616d 706c 6573 2c20 2055 703a  : Examples,  Up:
│ │ │ │ -0003d9c0: 2050 726f 6772 616d 6d69 6e67 204d 616e   Programming Man
│ │ │ │ -0003d9d0: 7561 6c0a 0a35 2e31 3920 4b65 7262 6572  ual..5.19 Kerber
│ │ │ │ -0003d9e0: 6f73 2044 6174 6162 6173 6520 4675 6e63  os Database Func
│ │ │ │ -0003d9f0: 7469 6f6e 730a 3d3d 3d3d 3d3d 3d3d 3d3d  tions.==========
│ │ │ │ +0003bef0: 2d0a 0a73 6869 7368 695f 7374 7265 7272  -..shishi_strerr
│ │ │ │ +0003bf00: 6f72 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  or.-------------
│ │ │ │ +0003bf10: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ +0003bf20: 3a20 636f 6e73 7420 6368 6172 202a 2073  : const char * s
│ │ │ │ +0003bf30: 6869 7368 695f 7374 7265 7272 6f72 2028  hishi_strerror (
│ │ │ │ +0003bf40: 696e 7420 4552 5229 0a20 2020 2020 4552  int ERR).     ER
│ │ │ │ +0003bf50: 523a 2073 6869 7368 6920 6572 726f 7220  R: shishi error 
│ │ │ │ +0003bf60: 636f 6465 2e0a 0a20 2020 2020 2a44 6573  code...     *Des
│ │ │ │ +0003bf70: 6372 6970 7469 6f6e 3a2a 2043 6f6e 7665  cription:* Conve
│ │ │ │ +0003bf80: 7274 7320 7468 6520 7265 7475 726e 2063  rts the return c
│ │ │ │ +0003bf90: 6f64 6520 696e 2045 5252 2074 6f20 6120  ode in ERR to a 
│ │ │ │ +0003bfa0: 6875 6d61 6e20 7265 6164 6162 6c65 0a20  human readable. 
│ │ │ │ +0003bfb0: 2020 2020 7374 7269 6e67 2e0a 0a20 2020      string...   
│ │ │ │ +0003bfc0: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ +0003bfd0: 2a20 5265 7475 726e 7320 6120 706f 696e  * Returns a poin
│ │ │ │ +0003bfe0: 7465 7220 746f 2061 2073 7461 7469 6361  ter to a statica
│ │ │ │ +0003bff0: 6c6c 7920 616c 6c6f 6361 7465 6420 7374  lly allocated st
│ │ │ │ +0003c000: 7269 6e67 0a20 2020 2020 636f 6e74 6169  ring.     contai
│ │ │ │ +0003c010: 6e69 6e67 2061 2064 6573 6372 6970 7469  ning a descripti
│ │ │ │ +0003c020: 6f6e 206f 6620 7468 6520 6572 726f 7220  on of the error 
│ │ │ │ +0003c030: 7769 7468 2063 6f64 6520 4552 522e 2020  with code ERR.  
│ │ │ │ +0003c040: 5468 6973 2073 7472 696e 670a 2020 2020  This string.    
│ │ │ │ +0003c050: 2063 616e 2062 6520 7573 6564 2074 6f20   can be used to 
│ │ │ │ +0003c060: 6f75 7470 7574 2061 2064 6961 676e 6f73  output a diagnos
│ │ │ │ +0003c070: 7469 6320 6d65 7373 6167 6520 746f 2074  tic message to t
│ │ │ │ +0003c080: 6865 2075 7365 722e 0a0a 7368 6973 6869  he user...shishi
│ │ │ │ +0003c090: 5f65 7272 6f72 0a2d 2d2d 2d2d 2d2d 2d2d  _error.---------
│ │ │ │ +0003c0a0: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ +0003c0b0: 6e3a 2063 6f6e 7374 2063 6861 7220 2a20  n: const char * 
│ │ │ │ +0003c0c0: 7368 6973 6869 5f65 7272 6f72 2028 5368  shishi_error (Sh
│ │ │ │ +0003c0d0: 6973 6869 202a 2048 414e 444c 4529 0a20  ishi * HANDLE). 
│ │ │ │ +0003c0e0: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ +0003c0f0: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ +0003c100: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ +0003c110: 7368 695f 696e 6974 2829 e280 992e 0a0a  shi_init()......
│ │ │ │ +0003c120: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ +0003c130: 6e3a 2a20 4578 7472 6163 7473 2064 6574  n:* Extracts det
│ │ │ │ +0003c140: 6169 6c65 6420 696e 666f 726d 6174 696f  ailed informatio
│ │ │ │ +0003c150: 6e20 6f6e 2074 6865 206d 6f73 7420 7265  n on the most re
│ │ │ │ +0003c160: 6365 6e74 6c79 0a20 2020 2020 6f63 6375  cently.     occu
│ │ │ │ +0003c170: 7272 6564 2065 7272 6f72 2063 6f6e 6469  rred error condi
│ │ │ │ +0003c180: 7469 6f6e 2e20 204e 6f74 6520 7468 6174  tion.  Note that
│ │ │ │ +0003c190: 206d 656d 6f72 7920 6973 206d 616e 6167   memory is manag
│ │ │ │ +0003c1a0: 6564 2062 7920 7468 650a 2020 2020 2053  ed by the.     S
│ │ │ │ +0003c1b0: 6869 7368 6920 6c69 6272 6172 792c 2073  hishi library, s
│ │ │ │ +0003c1c0: 6f20 7468 6520 7265 7475 726e 6564 2073  o the returned s
│ │ │ │ +0003c1d0: 7472 696e 6720 6d75 7374 206e 6f74 2062  tring must not b
│ │ │ │ +0003c1e0: 6520 6465 616c 6c6f 6361 7465 642e 0a0a  e deallocated...
│ │ │ │ +0003c1f0: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ +0003c200: 7565 3a2a 2052 6574 7572 6e73 2061 2070  ue:* Returns a p
│ │ │ │ +0003c210: 6f69 6e74 6572 2074 6f20 6120 7374 7269  ointer to a stri
│ │ │ │ +0003c220: 6e67 2064 6573 6372 6962 696e 6720 616e  ng describing an
│ │ │ │ +0003c230: 2065 7272 6f72 2e0a 2020 2020 2054 6865   error..     The
│ │ │ │ +0003c240: 2073 7472 696e 6720 6d75 7374 206e 6f74   string must not
│ │ │ │ +0003c250: 2062 6520 6465 616c 6c6f 6361 7465 6420   be deallocated 
│ │ │ │ +0003c260: 6279 2074 6865 2063 616c 6c65 722e 0a0a  by the caller...
│ │ │ │ +0003c270: 7368 6973 6869 5f65 7272 6f72 5f63 6c65  shishi_error_cle
│ │ │ │ +0003c280: 6172 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ar.-------------
│ │ │ │ +0003c290: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +0003c2a0: 696f 6e3a 2076 6f69 6420 7368 6973 6869  ion: void shishi
│ │ │ │ +0003c2b0: 5f65 7272 6f72 5f63 6c65 6172 2028 5368  _error_clear (Sh
│ │ │ │ +0003c2c0: 6973 6869 202a 2048 414e 444c 4529 0a20  ishi * HANDLE). 
│ │ │ │ +0003c2d0: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ +0003c2e0: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ +0003c2f0: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ +0003c300: 7368 695f 696e 6974 2829 e280 992e 0a0a  shi_init()......
│ │ │ │ +0003c310: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ +0003c320: 6e3a 2a20 436c 6561 7273 2074 6865 2069  n:* Clears the i
│ │ │ │ +0003c330: 6e74 6572 6e61 6c20 6572 726f 7220 6465  nternal error de
│ │ │ │ +0003c340: 7363 7269 7074 696f 6e2e 2020 5365 650a  scription.  See.
│ │ │ │ +0003c350: 2020 2020 20e2 8098 7368 6973 6869 5f65       ...shishi_e
│ │ │ │ +0003c360: 7272 6f72 2829 e280 9920 6f6e 2068 6f77  rror()... on how
│ │ │ │ +0003c370: 2074 6f20 6163 6365 7373 2074 6865 2065   to access the e
│ │ │ │ +0003c380: 7272 6f72 2073 7472 696e 672c 2061 6e64  rror string, and
│ │ │ │ +0003c390: 0a20 2020 2020 e280 9873 6869 7368 695f  .     ...shishi_
│ │ │ │ +0003c3a0: 6572 726f 725f 7365 7428 29e2 8099 2061  error_set()... a
│ │ │ │ +0003c3b0: 7320 7765 6c6c 2061 7320 e280 9873 6869  s well as ...shi
│ │ │ │ +0003c3c0: 7368 695f 6572 726f 725f 7072 696e 7466  shi_error_printf
│ │ │ │ +0003c3d0: 2829 e280 9920 6f6e 2068 6f77 2074 6f0a  ()... on how to.
│ │ │ │ +0003c3e0: 2020 2020 2073 6574 2074 6865 2065 7272       set the err
│ │ │ │ +0003c3f0: 6f72 2073 7472 696e 672e 0a0a 2020 2020  or string...    
│ │ │ │ +0003c400: 2054 6869 7320 6675 6e63 7469 6f6e 2069   This function i
│ │ │ │ +0003c410: 7320 6d6f 7374 6c79 2066 6f72 2053 6869  s mostly for Shi
│ │ │ │ +0003c420: 7368 6927 7320 696e 7465 726e 616c 2075  shi's internal u
│ │ │ │ +0003c430: 7365 2c20 6275 7420 6966 2079 6f75 0a20  se, but if you. 
│ │ │ │ +0003c440: 2020 2020 6465 7665 6c6f 7020 616e 2065      develop an e
│ │ │ │ +0003c450: 7874 656e 7369 6f6e 206f 6620 5368 6973  xtension of Shis
│ │ │ │ +0003c460: 6869 2c20 6974 206d 6179 2062 6520 7573  hi, it may be us
│ │ │ │ +0003c470: 6566 756c 2074 6f20 7375 7070 6f72 7420  eful to support 
│ │ │ │ +0003c480: 7468 650a 2020 2020 2073 616d 6520 6572  the.     same er
│ │ │ │ +0003c490: 726f 7220 6861 6e64 6c69 6e67 2069 6e66  ror handling inf
│ │ │ │ +0003c4a0: 7261 7374 7275 6374 7572 652e 0a0a 7368  rastructure...sh
│ │ │ │ +0003c4b0: 6973 6869 5f65 7272 6f72 5f73 6574 0a2d  ishi_error_set.-
│ │ │ │ +0003c4c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +0003c4d0: 0a20 2d2d 2046 756e 6374 696f 6e3a 2076  . -- Function: v
│ │ │ │ +0003c4e0: 6f69 6420 7368 6973 6869 5f65 7272 6f72  oid shishi_error
│ │ │ │ +0003c4f0: 5f73 6574 2028 5368 6973 6869 202a 2048  _set (Shishi * H
│ │ │ │ +0003c500: 414e 444c 452c 0a20 2020 2020 2020 2020  ANDLE,.         
│ │ │ │ +0003c510: 2063 6f6e 7374 2063 6861 7220 2a20 4552   const char * ER
│ │ │ │ +0003c520: 5253 5452 290a 2020 2020 2048 414e 444c  RSTR).     HANDL
│ │ │ │ +0003c530: 453a 2073 6869 7368 6920 6861 6e64 6c65  E: shishi handle
│ │ │ │ +0003c540: 2061 7320 616c 6c6f 6361 7465 6420 6279   as allocated by
│ │ │ │ +0003c550: 20e2 8098 7368 6973 6869 5f69 6e69 7428   ...shishi_init(
│ │ │ │ +0003c560: 29e2 8099 2e0a 2020 2020 2045 5252 5354  ).....     ERRST
│ │ │ │ +0003c570: 523a 2041 206e 756c 6c2d 7465 726d 696e  R: A null-termin
│ │ │ │ +0003c580: 6174 6564 2063 6861 7261 6374 6572 2073  ated character s
│ │ │ │ +0003c590: 7472 696e 6720 686f 6c64 696e 6720 6120  tring holding a 
│ │ │ │ +0003c5a0: 6465 7363 7269 7074 696f 6e2c 0a20 2020  description,.   
│ │ │ │ +0003c5b0: 2020 6f72 20e2 8098 4e55 4c4c e280 9920    or ...NULL... 
│ │ │ │ +0003c5c0: 746f 2063 6c65 6172 2074 6865 2069 6e74  to clear the int
│ │ │ │ +0003c5d0: 6572 6e61 6c20 6572 726f 7220 7374 7269  ernal error stri
│ │ │ │ +0003c5e0: 6e67 2e0a 0a20 2020 2020 2a44 6573 6372  ng...     *Descr
│ │ │ │ +0003c5f0: 6970 7469 6f6e 3a2a 2053 6574 7320 7468  iption:* Sets th
│ │ │ │ +0003c600: 6520 6572 726f 7220 6465 7363 7269 7074  e error descript
│ │ │ │ +0003c610: 696f 6e20 746f 2074 6865 2063 6f6e 7465  ion to the conte
│ │ │ │ +0003c620: 6e74 206f 6620 4552 5253 5452 2e0a 2020  nt of ERRSTR..  
│ │ │ │ +0003c630: 2020 2054 6865 2073 7472 696e 6720 6973     The string is
│ │ │ │ +0003c640: 2063 6f70 6965 6420 696e 746f 2074 6865   copied into the
│ │ │ │ +0003c650: 2053 6869 7368 6920 696e 7465 726e 616c   Shishi internal
│ │ │ │ +0003c660: 2073 7472 7563 7475 7265 2c20 736f 2079   structure, so y
│ │ │ │ +0003c670: 6f75 2063 616e 0a20 2020 2020 6465 616c  ou can.     deal
│ │ │ │ +0003c680: 6c6f 6361 7465 2061 6e79 2073 7472 696e  locate any strin
│ │ │ │ +0003c690: 6720 7061 7373 6564 2074 6f20 7468 6973  g passed to this
│ │ │ │ +0003c6a0: 2066 756e 6374 696f 6e2e 0a0a 2020 2020   function...    
│ │ │ │ +0003c6b0: 2054 6869 7320 6675 6e63 7469 6f6e 2069   This function i
│ │ │ │ +0003c6c0: 7320 6d6f 7374 6c79 2066 6f72 2053 6869  s mostly for Shi
│ │ │ │ +0003c6d0: 7368 6927 7320 696e 7465 726e 616c 2075  shi's internal u
│ │ │ │ +0003c6e0: 7365 2c20 6275 7420 6966 2079 6f75 0a20  se, but if you. 
│ │ │ │ +0003c6f0: 2020 2020 6465 7665 6c6f 7020 616e 2065      develop an e
│ │ │ │ +0003c700: 7874 656e 7369 6f6e 206f 6620 5368 6973  xtension of Shis
│ │ │ │ +0003c710: 6869 2c20 6974 206d 6179 2062 6520 7573  hi, it may be us
│ │ │ │ +0003c720: 6566 756c 2074 6f20 7375 7070 6f72 7420  eful to support 
│ │ │ │ +0003c730: 7468 650a 2020 2020 2073 616d 6520 6572  the.     same er
│ │ │ │ +0003c740: 726f 7220 6861 6e64 6c69 6e67 2069 6e66  ror handling inf
│ │ │ │ +0003c750: 7261 7374 7275 6374 7572 652e 0a0a 7368  rastructure...sh
│ │ │ │ +0003c760: 6973 6869 5f65 7272 6f72 5f70 7269 6e74  ishi_error_print
│ │ │ │ +0003c770: 660a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  f.--------------
│ │ │ │ +0003c780: 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e 6374  -----.. -- Funct
│ │ │ │ +0003c790: 696f 6e3a 2076 6f69 6420 7368 6973 6869  ion: void shishi
│ │ │ │ +0003c7a0: 5f65 7272 6f72 5f70 7269 6e74 6620 2853  _error_printf (S
│ │ │ │ +0003c7b0: 6869 7368 6920 2a20 4841 4e44 4c45 2c0a  hishi * HANDLE,.
│ │ │ │ +0003c7c0: 2020 2020 2020 2020 2020 636f 6e73 7420            const 
│ │ │ │ +0003c7d0: 6368 6172 202a 2046 4f52 4d41 542c 202e  char * FORMAT, .
│ │ │ │ +0003c7e0: 2e2e 290a 2020 2020 2048 414e 444c 453a  ..).     HANDLE:
│ │ │ │ +0003c7f0: 2073 6869 7368 6920 6861 6e64 6c65 2061   shishi handle a
│ │ │ │ +0003c800: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ +0003c810: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ +0003c820: 8099 2e0a 2020 2020 2046 4f52 4d41 543a  ....     FORMAT:
│ │ │ │ +0003c830: 2070 7269 6e74 6620 7374 796c 6520 666f   printf style fo
│ │ │ │ +0003c840: 726d 6174 2073 7472 696e 672e 0a20 2020  rmat string..   
│ │ │ │ +0003c850: 2020 2e2e 2e3a 2070 7269 6e74 6620 7374    ...: printf st
│ │ │ │ +0003c860: 796c 6520 6172 6775 6d65 6e74 732e 0a0a  yle arguments...
│ │ │ │ +0003c870: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ +0003c880: 6e3a 2a20 5365 7473 2074 6865 2069 6e74  n:* Sets the int
│ │ │ │ +0003c890: 6572 6e61 6c20 6572 726f 7220 6465 7363  ernal error desc
│ │ │ │ +0003c8a0: 7269 7074 696f 6e20 746f 2061 2070 7269  ription to a pri
│ │ │ │ +0003c8b0: 6e74 6628 3329 0a20 2020 2020 666f 726d  ntf(3).     form
│ │ │ │ +0003c8c0: 6174 7465 6420 7374 7269 6e67 2e20 2054  atted string.  T
│ │ │ │ +0003c8d0: 6869 7320 6675 6e63 7469 6f6e 2069 7320  his function is 
│ │ │ │ +0003c8e0: 6d6f 7374 6c79 2066 6f72 2053 6869 7368  mostly for Shish
│ │ │ │ +0003c8f0: 6927 7320 696e 7465 726e 616c 0a20 2020  i's internal.   
│ │ │ │ +0003c900: 2020 7573 652c 2062 7574 2069 6620 796f    use, but if yo
│ │ │ │ +0003c910: 7520 6465 7665 6c6f 7020 616e 2065 7874  u develop an ext
│ │ │ │ +0003c920: 656e 7369 6f6e 206f 6620 5368 6973 6869  ension of Shishi
│ │ │ │ +0003c930: 2c20 6974 206d 6179 2062 6520 7573 6566  , it may be usef
│ │ │ │ +0003c940: 756c 2074 6f0a 2020 2020 2073 7570 706f  ul to.     suppo
│ │ │ │ +0003c950: 7274 2074 6865 2073 616d 6520 696e 6672  rt the same infr
│ │ │ │ +0003c960: 6173 7472 7563 7475 7265 2066 6f72 2065  astructure for e
│ │ │ │ +0003c970: 7272 6f72 2068 616e 646c 696e 672e 0a0a  rror handling...
│ │ │ │ +0003c980: 7368 6973 6869 5f65 7272 6f72 5f6f 7574  shishi_error_out
│ │ │ │ +0003c990: 7075 7474 7970 650a 2d2d 2d2d 2d2d 2d2d  puttype.--------
│ │ │ │ +0003c9a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +0003c9b0: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ +0003c9c0: 6e74 2073 6869 7368 695f 6572 726f 725f  nt shishi_error_
│ │ │ │ +0003c9d0: 6f75 7470 7574 7479 7065 2028 5368 6973  outputtype (Shis
│ │ │ │ +0003c9e0: 6869 202a 2048 414e 444c 4529 0a20 2020  hi * HANDLE).   
│ │ │ │ +0003c9f0: 2020 4841 4e44 4c45 3a20 7368 6973 6869    HANDLE: shishi
│ │ │ │ +0003ca00: 2068 616e 646c 6520 6173 2061 6c6c 6f63   handle as alloc
│ │ │ │ +0003ca10: 6174 6564 2062 7920 e280 9873 6869 7368  ated by ...shish
│ │ │ │ +0003ca20: 695f 696e 6974 2829 e280 992e 0a0a 2020  i_init()......  
│ │ │ │ +0003ca30: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ +0003ca40: 2a20 5265 706f 7274 7320 7468 6520 6375  * Reports the cu
│ │ │ │ +0003ca50: 7272 656e 7420 6f75 7470 7574 2074 7970  rrent output typ
│ │ │ │ +0003ca60: 6520 7573 6564 2069 6e20 6d65 7373 6167  e used in messag
│ │ │ │ +0003ca70: 650a 2020 2020 206c 6f67 6769 6e67 2e0a  e.     logging..
│ │ │ │ +0003ca80: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ +0003ca90: 6c75 653a 2a20 5265 7475 726e 7320 7468  lue:* Returns th
│ │ │ │ +0003caa0: 6520 6f75 7470 7574 2074 7970 652e 2020  e output type.  
│ │ │ │ +0003cab0: e280 9853 4849 5348 495f 4f55 5450 5554  ...SHISHI_OUTPUT
│ │ │ │ +0003cac0: 5459 5045 5f4e 554c 4ce2 8099 0a20 2020  TYPE_NULL....   
│ │ │ │ +0003cad0: 2020 6d65 616e 7320 6e6f 206f 7574 7075    means no outpu
│ │ │ │ +0003cae0: 742e 2020 e280 9853 4849 5348 495f 4f55  t.  ...SHISHI_OU
│ │ │ │ +0003caf0: 5450 5554 5459 5045 5f53 5444 4552 52e2  TPUTTYPE_STDERR.
│ │ │ │ +0003cb00: 8099 2061 6e64 0a20 2020 2020 e280 9853  .. and.     ...S
│ │ │ │ +0003cb10: 4849 5348 495f 4f55 5450 5554 5459 5045  HISHI_OUTPUTTYPE
│ │ │ │ +0003cb20: 5f53 5953 4c4f 47e2 8099 2064 6972 6563  _SYSLOG... direc
│ │ │ │ +0003cb30: 7420 7465 7874 2074 6f20 7468 6520 636f  t text to the co
│ │ │ │ +0003cb40: 6e73 6f6c 652c 206f 7220 746f 2074 6865  nsole, or to the
│ │ │ │ +0003cb50: 0a20 2020 2020 7379 736c 6f67 2073 7973  .     syslog sys
│ │ │ │ +0003cb60: 7465 6d2e 0a0a 7368 6973 6869 5f65 7272  tem...shishi_err
│ │ │ │ +0003cb70: 6f72 5f73 6574 5f6f 7574 7075 7474 7970  or_set_outputtyp
│ │ │ │ +0003cb80: 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  e.--------------
│ │ │ │ +0003cb90: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ +0003cba0: 2d2d 2046 756e 6374 696f 6e3a 2076 6f69  -- Function: voi
│ │ │ │ +0003cbb0: 6420 7368 6973 6869 5f65 7272 6f72 5f73  d shishi_error_s
│ │ │ │ +0003cbc0: 6574 5f6f 7574 7075 7474 7970 6520 2853  et_outputtype (S
│ │ │ │ +0003cbd0: 6869 7368 6920 2a20 4841 4e44 4c45 2c0a  hishi * HANDLE,.
│ │ │ │ +0003cbe0: 2020 2020 2020 2020 2020 696e 7420 5459            int TY
│ │ │ │ +0003cbf0: 5045 290a 2020 2020 2048 414e 444c 453a  PE).     HANDLE:
│ │ │ │ +0003cc00: 2073 6869 7368 6920 6861 6e64 6c65 2061   shishi handle a
│ │ │ │ +0003cc10: 7320 616c 6c6f 6361 7465 6420 6279 20e2  s allocated by .
│ │ │ │ +0003cc20: 8098 7368 6973 6869 5f69 6e69 7428 29e2  ..shishi_init().
│ │ │ │ +0003cc30: 8099 2e0a 2020 2020 2054 5950 453a 206f  ....     TYPE: o
│ │ │ │ +0003cc40: 7574 7075 7420 7479 7065 2c20 6f66 2065  utput type, of e
│ │ │ │ +0003cc50: 6e75 6d20 7479 7065 20e2 8098 5368 6973  num type ...Shis
│ │ │ │ +0003cc60: 6869 5f6f 7574 7075 7474 7970 65e2 8099  hi_outputtype...
│ │ │ │ +0003cc70: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ +0003cc80: 7469 6f6e 3a2a 2053 6574 7320 7468 6520  tion:* Sets the 
│ │ │ │ +0003cc90: 6f75 7470 7574 2074 7970 6520 28e2 8098  output type (...
│ │ │ │ +0003cca0: 4e55 4c4c e280 992c 20e2 8098 7374 6465  NULL..., ...stde
│ │ │ │ +0003ccb0: 7272 e280 9920 6f72 20e2 8098 7379 736c  rr... or ...sysl
│ │ │ │ +0003ccc0: 6f67 e280 9929 0a20 2020 2020 7573 6564  og...).     used
│ │ │ │ +0003ccd0: 2066 6f72 2069 6e66 6f72 6d61 7469 6f6e   for information
│ │ │ │ +0003cce0: 2061 6e64 2077 6172 6e69 6e67 206d 6573   and warning mes
│ │ │ │ +0003ccf0: 7361 6765 732e 2020 496e 7465 6e64 6564  sages.  Intended
│ │ │ │ +0003cd00: 2076 616c 7565 7320 6172 650a 2020 2020   values are.    
│ │ │ │ +0003cd10: 20e2 8098 5348 4953 4849 5f4f 5554 5055   ...SHISHI_OUTPU
│ │ │ │ +0003cd20: 5454 5950 455f 4e55 4c4c e280 992c 2066  TTYPE_NULL..., f
│ │ │ │ +0003cd30: 6f72 206e 6f20 6f75 7470 7574 2061 7420  or no output at 
│ │ │ │ +0003cd40: 616c 6c2c 0a20 2020 2020 e280 9853 4849  all,.     ...SHI
│ │ │ │ +0003cd50: 5348 495f 4f55 5450 5554 5459 5045 5f53  SHI_OUTPUTTYPE_S
│ │ │ │ +0003cd60: 5444 4552 52e2 8099 2066 6f72 206f 7574  TDERR... for out
│ │ │ │ +0003cd70: 7075 7420 746f 2074 6865 2063 6f6e 736f  put to the conso
│ │ │ │ +0003cd80: 6c65 2c20 616e 640a 2020 2020 20e2 8098  le, and.     ...
│ │ │ │ +0003cd90: 5348 4953 4849 5f4f 5554 5055 5454 5950  SHISHI_OUTPUTTYP
│ │ │ │ +0003cda0: 455f 5359 534c 4f47 e280 9920 666f 7220  E_SYSLOG... for 
│ │ │ │ +0003cdb0: 7379 736c 6f67 206d 6573 7361 6769 6e67  syslog messaging
│ │ │ │ +0003cdc0: 2e20 2054 6865 2066 6972 7374 2076 616c  .  The first val
│ │ │ │ +0003cdd0: 7565 0a20 2020 2020 636f 7665 7273 2065  ue.     covers e
│ │ │ │ +0003cde0: 7665 7279 7468 696e 6720 6469 6666 6572  verything differ
│ │ │ │ +0003cdf0: 656e 7420 6672 6f6d 2074 6865 206c 6174  ent from the lat
│ │ │ │ +0003ce00: 7465 7220 7477 6f20 7661 6c75 6573 2e0a  ter two values..
│ │ │ │ +0003ce10: 0a73 6869 7368 695f 696e 666f 0a2d 2d2d  .shishi_info.---
│ │ │ │ +0003ce20: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ +0003ce30: 6e63 7469 6f6e 3a20 766f 6964 2073 6869  nction: void shi
│ │ │ │ +0003ce40: 7368 695f 696e 666f 2028 5368 6973 6869  shi_info (Shishi
│ │ │ │ +0003ce50: 202a 2048 414e 444c 452c 2063 6f6e 7374   * HANDLE, const
│ │ │ │ +0003ce60: 2063 6861 7220 2a20 464f 524d 4154 2c0a   char * FORMAT,.
│ │ │ │ +0003ce70: 2020 2020 2020 2020 2020 2e2e 2e29 0a20            ...). 
│ │ │ │ +0003ce80: 2020 2020 4841 4e44 4c45 3a20 7368 6973      HANDLE: shis
│ │ │ │ +0003ce90: 6869 2068 616e 646c 6520 6173 2061 6c6c  hi handle as all
│ │ │ │ +0003cea0: 6f63 6174 6564 2062 7920 e280 9873 6869  ocated by ...shi
│ │ │ │ +0003ceb0: 7368 695f 696e 6974 2829 e280 992e 0a20  shi_init()..... 
│ │ │ │ +0003cec0: 2020 2020 464f 524d 4154 3a20 7072 696e      FORMAT: prin
│ │ │ │ +0003ced0: 7466 2073 7479 6c65 2066 6f72 6d61 7420  tf style format 
│ │ │ │ +0003cee0: 7374 7269 6e67 2e0a 2020 2020 202e 2e2e  string..     ...
│ │ │ │ +0003cef0: 3a20 7072 696e 7466 2073 7479 6c65 2061  : printf style a
│ │ │ │ +0003cf00: 7267 756d 656e 7473 2e0a 0a20 2020 2020  rguments...     
│ │ │ │ +0003cf10: 2a44 6573 6372 6970 7469 6f6e 3a2a 2050  *Description:* P
│ │ │ │ +0003cf20: 7269 6e74 7320 616e 2069 6e66 6f72 6d61  rints an informa
│ │ │ │ +0003cf30: 7469 6f6e 616c 206d 6573 7361 6765 2c20  tional message, 
│ │ │ │ +0003cf40: 636f 6d70 6f73 6564 2066 726f 6d20 7468  composed from th
│ │ │ │ +0003cf50: 650a 2020 2020 2061 7267 756d 656e 7473  e.     arguments
│ │ │ │ +0003cf60: 2c20 746f 2074 6865 206f 7574 7075 7420  , to the output 
│ │ │ │ +0003cf70: 7374 7265 616d 2073 6574 2069 6e20 4841  stream set in HA
│ │ │ │ +0003cf80: 4e44 4c45 2e0a 0a73 6869 7368 695f 7761  NDLE...shishi_wa
│ │ │ │ +0003cf90: 726e 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  rn.-----------..
│ │ │ │ +0003cfa0: 202d 2d20 4675 6e63 7469 6f6e 3a20 766f   -- Function: vo
│ │ │ │ +0003cfb0: 6964 2073 6869 7368 695f 7761 726e 2028  id shishi_warn (
│ │ │ │ +0003cfc0: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ +0003cfd0: 2063 6f6e 7374 2063 6861 7220 2a20 464f   const char * FO
│ │ │ │ +0003cfe0: 524d 4154 2c0a 2020 2020 2020 2020 2020  RMAT,.          
│ │ │ │ +0003cff0: 2e2e 2e29 0a20 2020 2020 4841 4e44 4c45  ...).     HANDLE
│ │ │ │ +0003d000: 3a20 7368 6973 6869 2068 616e 646c 6520  : shishi handle 
│ │ │ │ +0003d010: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ +0003d020: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ +0003d030: e280 992e 0a20 2020 2020 464f 524d 4154  .....     FORMAT
│ │ │ │ +0003d040: 3a20 7072 696e 7466 2073 7479 6c65 2066  : printf style f
│ │ │ │ +0003d050: 6f72 6d61 7420 7374 7269 6e67 2e0a 2020  ormat string..  
│ │ │ │ +0003d060: 2020 202e 2e2e 3a20 7072 696e 7466 2073     ...: printf s
│ │ │ │ +0003d070: 7479 6c65 2061 7267 756d 656e 7473 2e0a  tyle arguments..
│ │ │ │ +0003d080: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +0003d090: 6f6e 3a2a 2050 7269 6e74 7320 6120 7761  on:* Prints a wa
│ │ │ │ +0003d0a0: 726e 696e 672c 2063 6f6d 706f 7365 6420  rning, composed 
│ │ │ │ +0003d0b0: 6672 6f6d 2074 6865 2061 7267 756d 656e  from the argumen
│ │ │ │ +0003d0c0: 7473 2c20 746f 0a20 2020 2020 7468 6520  ts, to.     the 
│ │ │ │ +0003d0d0: 6f75 7470 7574 2073 7472 6561 6d20 7365  output stream se
│ │ │ │ +0003d0e0: 7420 696e 2048 414e 444c 452e 0a0a 7368  t in HANDLE...sh
│ │ │ │ +0003d0f0: 6973 6869 5f76 6572 626f 7365 0a2d 2d2d  ishi_verbose.---
│ │ │ │ +0003d100: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ +0003d110: 2046 756e 6374 696f 6e3a 2076 6f69 6420   Function: void 
│ │ │ │ +0003d120: 7368 6973 6869 5f76 6572 626f 7365 2028  shishi_verbose (
│ │ │ │ +0003d130: 5368 6973 6869 202a 2048 414e 444c 452c  Shishi * HANDLE,
│ │ │ │ +0003d140: 2063 6f6e 7374 2063 6861 7220 2a20 464f   const char * FO
│ │ │ │ +0003d150: 524d 4154 2c0a 2020 2020 2020 2020 2020  RMAT,.          
│ │ │ │ +0003d160: 2e2e 2e29 0a20 2020 2020 4841 4e44 4c45  ...).     HANDLE
│ │ │ │ +0003d170: 3a20 7368 6973 6869 2068 616e 646c 6520  : shishi handle 
│ │ │ │ +0003d180: 6173 2061 6c6c 6f63 6174 6564 2062 7920  as allocated by 
│ │ │ │ +0003d190: e280 9873 6869 7368 695f 696e 6974 2829  ...shishi_init()
│ │ │ │ +0003d1a0: e280 992e 0a20 2020 2020 464f 524d 4154  .....     FORMAT
│ │ │ │ +0003d1b0: 3a20 7072 696e 7466 2073 7479 6c65 2066  : printf style f
│ │ │ │ +0003d1c0: 6f72 6d61 7420 7374 7269 6e67 2e0a 2020  ormat string..  
│ │ │ │ +0003d1d0: 2020 202e 2e2e 3a20 7072 696e 7466 2073     ...: printf s
│ │ │ │ +0003d1e0: 7479 6c65 2061 7267 756d 656e 7473 2e0a  tyle arguments..
│ │ │ │ +0003d1f0: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +0003d200: 6f6e 3a2a 2050 7269 6e74 7320 6120 6469  on:* Prints a di
│ │ │ │ +0003d210: 6167 6e6f 7374 6963 206d 6573 7361 6765  agnostic message
│ │ │ │ +0003d220: 2c20 636f 6d70 6f73 6564 2066 726f 6d20  , composed from 
│ │ │ │ +0003d230: 7468 650a 2020 2020 2061 7267 756d 656e  the.     argumen
│ │ │ │ +0003d240: 7473 2c20 746f 2074 6865 206f 7574 7075  ts, to the outpu
│ │ │ │ +0003d250: 7420 7374 7265 616d 2073 6574 2069 6e20  t stream set in 
│ │ │ │ +0003d260: 4841 4e44 4c45 2e20 2054 6865 2063 7572  HANDLE.  The cur
│ │ │ │ +0003d270: 7265 6e74 0a20 2020 2020 7665 7262 6f73  rent.     verbos
│ │ │ │ +0003d280: 6974 7920 7365 7474 696e 6720 6465 7465  ity setting dete
│ │ │ │ +0003d290: 726d 696e 6573 2077 6865 7468 6572 2074  rmines whether t
│ │ │ │ +0003d2a0: 6865 206d 6573 7361 6765 2069 7320 6163  he message is ac
│ │ │ │ +0003d2b0: 7475 616c 6c79 0a20 2020 2020 7072 696e  tually.     prin
│ │ │ │ +0003d2c0: 7465 642c 206f 7220 6973 2073 7570 7072  ted, or is suppr
│ │ │ │ +0003d2d0: 6573 7365 6420 6475 6520 746f 206c 6f77  essed due to low
│ │ │ │ +0003d2e0: 2073 6967 6e69 6669 6361 6e63 652e 0a0a   significance...
│ │ │ │ +0003d2f0: 1f0a 4669 6c65 3a20 7368 6973 6869 2e69  ..File: shishi.i
│ │ │ │ +0003d300: 6e66 6f2c 2020 4e6f 6465 3a20 4578 616d  nfo,  Node: Exam
│ │ │ │ +0003d310: 706c 6573 2c20 204e 6578 743a 204b 6572  ples,  Next: Ker
│ │ │ │ +0003d320: 6265 726f 7320 4461 7461 6261 7365 2046  beros Database F
│ │ │ │ +0003d330: 756e 6374 696f 6e73 2c20 2050 7265 763a  unctions,  Prev:
│ │ │ │ +0003d340: 2045 7272 6f72 2048 616e 646c 696e 672c   Error Handling,
│ │ │ │ +0003d350: 2020 5570 3a20 5072 6f67 7261 6d6d 696e    Up: Programmin
│ │ │ │ +0003d360: 6720 4d61 6e75 616c 0a0a 352e 3138 2045  g Manual..5.18 E
│ │ │ │ +0003d370: 7861 6d70 6c65 730a 3d3d 3d3d 3d3d 3d3d  xamples.========
│ │ │ │ +0003d380: 3d3d 3d3d 3d0a 0a54 6869 7320 7365 6374  =====..This sect
│ │ │ │ +0003d390: 696f 6e20 7769 6c6c 2062 6520 6578 7465  ion will be exte
│ │ │ │ +0003d3a0: 6e64 6564 2074 6f20 636f 6e74 6169 6e20  nded to contain 
│ │ │ │ +0003d3b0: 7761 6c6b 2d74 6872 6f75 6768 7320 6f66  walk-throughs of
│ │ │ │ +0003d3c0: 2065 7861 6d70 6c65 2063 6f64 650a 7468   example code.th
│ │ │ │ +0003d3d0: 6174 2064 656d 6f6e 7374 7261 7465 2068  at demonstrate h
│ │ │ │ +0003d3e0: 6f77 2027 5368 6973 6869 2720 6973 2075  ow 'Shishi' is u
│ │ │ │ +0003d3f0: 7365 6420 746f 2077 7269 7465 2079 6f75  sed to write you
│ │ │ │ +0003d400: 7220 6f77 6e20 6170 706c 6963 6174 696f  r own applicatio
│ │ │ │ +0003d410: 6e73 0a74 6861 7420 7375 7070 6f72 7420  ns.that support 
│ │ │ │ +0003d420: 4b65 7262 6572 6f73 2035 2e20 2054 6865  Kerberos 5.  The
│ │ │ │ +0003d430: 2072 6573 7420 6f66 2074 6865 2063 7572   rest of the cur
│ │ │ │ +0003d440: 7265 6e74 2073 6563 7469 6f6e 2063 6f6e  rent section con
│ │ │ │ +0003d450: 7369 7374 7320 6f66 0a73 6f6d 6520 6372  sists of.some cr
│ │ │ │ +0003d460: 7564 6520 6869 6e74 7320 666f 7220 7468  ude hints for th
│ │ │ │ +0003d470: 6520 6578 616d 706c 6520 636c 6965 6e74  e example client
│ │ │ │ +0003d480: 2f73 6572 7665 7220 6170 706c 6963 6174  /server applicat
│ │ │ │ +0003d490: 696f 6e73 2074 6861 7420 6973 2070 6172  ions that is par
│ │ │ │ +0003d4a0: 740a 6f66 2053 6869 7368 692c 2074 616b  t.of Shishi, tak
│ │ │ │ +0003d4b0: 656e 2066 726f 6d20 616e 2065 6d61 696c  en from an email
│ │ │ │ +0003d4c0: 2062 7574 2073 6176 6564 2068 6572 6520   but saved here 
│ │ │ │ +0003d4d0: 666f 7220 6c61 636b 206f 6620 6120 6265  for lack of a be
│ │ │ │ +0003d4e0: 7474 6572 2070 6c61 6365 0a74 6f20 7075  tter place.to pu
│ │ │ │ +0003d4f0: 7420 6974 2e0a 0a20 2020 5468 6572 6520  t it...   There 
│ │ │ │ +0003d500: 6172 6520 7477 6f20 7072 6f67 7261 6d73  are two programs
│ │ │ │ +0003d510: 3a20 2763 6c69 656e 7427 2061 6e64 2027  : 'client' and '
│ │ │ │ +0003d520: 7365 7276 6572 2720 696e 2073 7263 2f2e  server' in src/.
│ │ │ │ +0003d530: 0a0a 2020 2054 6865 2063 6c69 656e 7420  ..   The client 
│ │ │ │ +0003d540: 6f75 7470 7574 2061 6e20 4150 2d52 4551  output an AP-REQ
│ │ │ │ +0003d550: 2c20 7761 6974 7320 666f 7220 616e 2041  , waits for an A
│ │ │ │ +0003d560: 502d 5245 502c 2061 6e64 2074 6865 6e20  P-REP, and then 
│ │ │ │ +0003d570: 7369 6d70 6c79 0a72 6561 6473 2064 6174  simply.reads dat
│ │ │ │ +0003d580: 6120 6672 6f6d 2073 7464 696e 2e0a 0a20  a from stdin... 
│ │ │ │ +0003d590: 2020 5468 6520 7365 7276 6572 2077 6169    The server wai
│ │ │ │ +0003d5a0: 7473 2066 6f72 2061 6e20 4150 2d52 4551  ts for an AP-REQ
│ │ │ │ +0003d5b0: 2c20 7061 7273 6573 2069 7420 616e 6420  , parses it and 
│ │ │ │ +0003d5c0: 7072 696e 7473 2061 6e20 4150 2d52 4550  prints an AP-REP
│ │ │ │ +0003d5d0: 2c20 616e 640a 7468 656e 2072 6561 6420  , and.then read 
│ │ │ │ +0003d5e0: 6461 7461 2066 726f 6d20 7374 6469 6e2e  data from stdin.
│ │ │ │ +0003d5f0: 0a0a 2020 2042 6f74 6820 7072 6f67 7261  ..   Both progra
│ │ │ │ +0003d600: 6d73 2061 6363 6570 7420 6120 4b65 7262  ms accept a Kerb
│ │ │ │ +0003d610: 6572 6f73 2073 6572 7665 7220 6e61 6d65  eros server name
│ │ │ │ +0003d620: 2061 7320 7468 6520 6669 7273 7420 636f   as the first co
│ │ │ │ +0003d630: 6d6d 616e 6420 6c69 6e65 0a61 7267 756d  mmand line.argum
│ │ │ │ +0003d640: 656e 742e 2020 596f 7572 204b 4443 206d  ent.  Your KDC m
│ │ │ │ +0003d650: 7573 7420 6b6e 6f77 2074 6869 7320 7365  ust know this se
│ │ │ │ +0003d660: 7276 6572 2c20 7369 6e63 6520 7468 6520  rver, since the 
│ │ │ │ +0003d670: 636c 6965 6e74 2074 7269 6573 2074 6f20  client tries to 
│ │ │ │ +0003d680: 6765 740a 6120 7469 636b 6574 2066 6f72  get.a ticket for
│ │ │ │ +0003d690: 2069 7420 2866 6972 7374 2069 7420 6765   it (first it ge
│ │ │ │ +0003d6a0: 7473 2061 2074 6963 6b65 7420 6772 616e  ts a ticket gran
│ │ │ │ +0003d6b0: 7469 6e67 2074 6963 6b65 7420 666f 7220  ting ticket for 
│ │ │ │ +0003d6c0: 7468 6520 6465 6661 756c 740a 7573 6572  the default.user
│ │ │ │ +0003d6d0: 6e61 6d65 292c 2061 6e64 2079 6f75 206d  name), and you m
│ │ │ │ +0003d6e0: 7573 7420 7772 6974 6520 7468 6520 6b65  ust write the ke
│ │ │ │ +0003d6f0: 7920 666f 7220 7468 6520 7365 7276 6572  y for the server
│ │ │ │ +0003d700: 2069 6e74 6f0a 2f75 7372 2f6c 6f63 616c   into./usr/local
│ │ │ │ +0003d710: 2f65 7463 2f73 6869 7368 692e 6b65 7973  /etc/shishi.keys
│ │ │ │ +0003d720: 206f 6e20 7468 6520 5368 6973 6869 2066   on the Shishi f
│ │ │ │ +0003d730: 6f72 6d61 742c 2065 2e67 2e3a 0a0a 2020  ormat, e.g.:..  
│ │ │ │ +0003d740: 2020 202d 2d2d 2d2d 4245 4749 4e20 5348     -----BEGIN SH
│ │ │ │ +0003d750: 4953 4849 204b 4559 2d2d 2d2d 2d0a 2020  ISHI KEY-----.  
│ │ │ │ +0003d760: 2020 204b 6579 7479 7065 3a20 3136 2028     Keytype: 16 (
│ │ │ │ +0003d770: 6465 7333 2d63 6263 2d73 6861 312d 6b64  des3-cbc-sha1-kd
│ │ │ │ +0003d780: 290a 2020 2020 2050 7269 6e63 6970 616c  ).     Principal
│ │ │ │ +0003d790: 3a20 7361 6d70 6c65 2f6c 6174 7465 2e6a  : sample/latte.j
│ │ │ │ +0003d7a0: 6f73 6566 7373 6f6e 2e6f 7267 0a20 2020  osefsson.org.   
│ │ │ │ +0003d7b0: 2020 5265 616c 6d3a 204a 4f53 4546 5353    Realm: JOSEFSS
│ │ │ │ +0003d7c0: 4f4e 2e4f 5247 0a0a 2020 2020 2038 5730  ON.ORG..     8W0
│ │ │ │ +0003d7d0: 5672 5151 4270 786c 4143 5051 4571 4e39  VrQQBpxlACPQEqN9
│ │ │ │ +0003d7e0: 3145 4878 6276 4646 6f32 6c74 740a 2020  1EHxbvFFo2ltt.  
│ │ │ │ +0003d7f0: 2020 202d 2d2d 2d2d 454e 4420 5348 4953     -----END SHIS
│ │ │ │ +0003d800: 4849 204b 4559 2d2d 2d2d 2d0a 0a20 2020  HI KEY-----..   
│ │ │ │ +0003d810: 596f 7520 6d75 7374 2065 7874 7261 6374  You must extract
│ │ │ │ +0003d820: 2074 6865 2070 726f 7065 7220 656e 6372   the proper encr
│ │ │ │ +0003d830: 7970 7469 6f6e 206b 6579 2066 726f 6d20  yption key from 
│ │ │ │ +0003d840: 7468 6520 4b44 4320 696e 2073 6f6d 6520  the KDC in some 
│ │ │ │ +0003d850: 7761 792e 0a28 5468 6973 2070 6172 7420  way..(This part 
│ │ │ │ +0003d860: 7769 6c6c 2062 6520 6561 7369 6572 2077  will be easier w
│ │ │ │ +0003d870: 6865 6e20 5368 6973 6869 2069 6e63 6c75  hen Shishi inclu
│ │ │ │ +0003d880: 6465 2061 204b 4443 2c20 6120 6261 7369  de a KDC, a basi
│ │ │ │ +0003d890: 6320 6f6e 6520 6973 6e27 740a 6661 7220  c one isn't.far 
│ │ │ │ +0003d8a0: 6177 6179 2c20 6769 7665 206d 6520 6120  away, give me a 
│ │ │ │ +0003d8b0: 7765 656b 206f 7220 746f 2e29 0a0a 2020  week or to.)..  
│ │ │ │ +0003d8c0: 2054 6865 2069 6e74 656e 7469 6f6e 2069   The intention i
│ │ │ │ +0003d8d0: 7320 7468 6174 2074 6865 2064 6174 6120  s that the data 
│ │ │ │ +0003d8e0: 7265 6164 2c20 6166 7465 7220 7468 6520  read, after the 
│ │ │ │ +0003d8f0: 6175 7468 656e 7469 6361 7469 6f6e 2070  authentication p
│ │ │ │ +0003d900: 6861 7365 2c0a 7368 6f75 6c64 2062 6520  hase,.should be 
│ │ │ │ +0003d910: 7072 6f74 6563 7465 6420 7573 696e 6720  protected using 
│ │ │ │ +0003d920: 4b52 425f 5341 4645 2028 7365 6520 5246  KRB_SAFE (see RF
│ │ │ │ +0003d930: 4329 2062 7574 2049 2068 6176 656e 2774  C) but I haven't
│ │ │ │ +0003d940: 2061 6464 6564 2074 6869 730a 7965 742e   added this.yet.
│ │ │ │ +0003d950: 0a0a 1f0a 4669 6c65 3a20 7368 6973 6869  ....File: shishi
│ │ │ │ +0003d960: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 4b65  .info,  Node: Ke
│ │ │ │ +0003d970: 7262 6572 6f73 2044 6174 6162 6173 6520  rberos Database 
│ │ │ │ +0003d980: 4675 6e63 7469 6f6e 732c 2020 4e65 7874  Functions,  Next
│ │ │ │ +0003d990: 3a20 4765 6e65 7269 6320 5365 6375 7269  : Generic Securi
│ │ │ │ +0003d9a0: 7479 2053 6572 7669 6365 2c20 2050 7265  ty Service,  Pre
│ │ │ │ +0003d9b0: 763a 2045 7861 6d70 6c65 732c 2020 5570  v: Examples,  Up
│ │ │ │ +0003d9c0: 3a20 5072 6f67 7261 6d6d 696e 6720 4d61  : Programming Ma
│ │ │ │ +0003d9d0: 6e75 616c 0a0a 352e 3139 204b 6572 6265  nual..5.19 Kerbe
│ │ │ │ +0003d9e0: 726f 7320 4461 7461 6261 7365 2046 756e  ros Database Fun
│ │ │ │ +0003d9f0: 6374 696f 6e73 0a3d 3d3d 3d3d 3d3d 3d3d  ctions.=========
│ │ │ │  0003da00: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ -0003da10: 3d3d 3d3d 3d3d 0a0a 5368 6973 6120 6973  ======..Shisa is
│ │ │ │ -0003da20: 2061 2073 6570 6172 6174 6520 616e 6420   a separate and 
│ │ │ │ -0003da30: 7374 616e 6461 6c6f 6e65 206c 6962 7261  standalone libra
│ │ │ │ -0003da40: 7279 2066 726f 6d20 5368 6973 6869 2028  ry from Shishi (
│ │ │ │ -0003da50: 2a6e 6f74 650a 496e 7472 6f64 7563 7469  *note.Introducti
│ │ │ │ -0003da60: 6f6e 2074 6f20 5368 6973 613a 3a29 2e20  on to Shisa::). 
│ │ │ │ -0003da70: 2049 6620 796f 7520 6f6e 6c79 2077 6973   If you only wis
│ │ │ │ -0003da80: 6820 746f 206d 616e 6970 756c 6174 6520  h to manipulate 
│ │ │ │ -0003da90: 7468 650a 696e 666f 726d 6174 696f 6e20  the.information 
│ │ │ │ -0003daa0: 7374 6f72 6564 2069 6e20 7468 6520 4b65  stored in the Ke
│ │ │ │ -0003dab0: 7262 6572 6f73 2075 7365 7220 6461 7461  rberos user data
│ │ │ │ -0003dac0: 6261 7365 2075 7365 6420 6279 2053 6869  base used by Shi
│ │ │ │ -0003dad0: 7368 692c 2079 6f75 2064 6f0a 6e6f 7420  shi, you do.not 
│ │ │ │ -0003dae0: 6e65 6564 2074 6f20 6c69 6e6b 206f 7220  need to link or 
│ │ │ │ -0003daf0: 7573 6520 7468 6520 5368 6973 6869 206c  use the Shishi l
│ │ │ │ -0003db00: 6962 7261 7279 2061 7420 616c 6c2e 2020  ibrary at all.  
│ │ │ │ -0003db10: 486f 7765 7665 722c 2079 6f75 206d 6179  However, you may
│ │ │ │ -0003db20: 0a66 696e 6420 6974 2075 7365 6675 6c20  .find it useful 
│ │ │ │ -0003db30: 746f 2063 6f6d 6269 6e65 2074 6865 2074  to combine the t
│ │ │ │ -0003db40: 776f 206c 6962 7261 7269 6573 2e0a 0a20  wo libraries... 
│ │ │ │ -0003db50: 2020 466f 7220 7477 6f20 7265 616c 2077    For two real w
│ │ │ │ -0003db60: 6f72 6c64 2065 7861 6d70 6c65 7320 6f6e  orld examples on
│ │ │ │ -0003db70: 2075 7369 6e67 2074 6865 2053 6869 7361   using the Shisa
│ │ │ │ -0003db80: 206c 6962 7261 7279 2c20 7265 6665 7220   library, refer 
│ │ │ │ -0003db90: 746f 0ae2 8098 7372 632f 7368 6973 612e  to....src/shisa.
│ │ │ │ -0003dba0: 63e2 8099 2028 5368 6973 6120 636f 6d6d  c... (Shisa comm
│ │ │ │ -0003dbb0: 616e 6420 6c69 6e65 2074 6f6f 6c29 2061  and line tool) a
│ │ │ │ -0003dbc0: 6e64 20e2 8098 7372 632f 6b64 632e 63e2  nd ...src/kdc.c.
│ │ │ │ -0003dbd0: 8099 2028 7061 7274 206f 6620 5368 6973  .. (part of Shis
│ │ │ │ -0003dbe0: 6869 640a 7365 7276 6572 292e 0a0a 2020  hid.server)...  
│ │ │ │ -0003dbf0: 2053 6869 7361 2075 7365 7320 7477 6f20   Shisa uses two 
│ │ │ │ -0003dc00: e280 9873 7472 7563 74e2 8099 7320 746f  ...struct...s to
│ │ │ │ -0003dc10: 2063 6172 7279 2069 6e66 6f72 6d61 7469   carry informati
│ │ │ │ -0003dc20: 6f6e 2e20 2054 6865 2066 6972 7374 2c0a  on.  The first,.
│ │ │ │ -0003dc30: e280 9853 6869 7361 5f70 7269 6e63 6970  ...Shisa_princip
│ │ │ │ -0003dc40: 616c e280 992c 2069 7320 7573 6564 2074  al..., is used t
│ │ │ │ -0003dc50: 6f20 686f 6c64 2069 6e66 6f72 6d61 7469  o hold informati
│ │ │ │ -0003dc60: 6f6e 2061 626f 7574 2070 7269 6e63 6970  on about princip
│ │ │ │ -0003dc70: 616c 732e 2020 5468 650a 7374 7275 6374  als.  The.struct
│ │ │ │ -0003dc80: 2064 6f65 7320 6e6f 7420 636f 6e74 6169   does not contai
│ │ │ │ -0003dc90: 6e20 706f 696e 7465 7273 2074 6f20 7374  n pointers to st
│ │ │ │ -0003dca0: 7269 6e67 7320 6574 632c 2073 6f20 7468  rings etc, so th
│ │ │ │ -0003dcb0: 6520 6c69 6272 6172 7920 6173 7375 6d65  e library assume
│ │ │ │ -0003dcc0: 730a 7468 6520 6361 6c6c 6572 2069 7320  s.the caller is 
│ │ │ │ -0003dcd0: 7265 7370 6f6e 7369 626c 6520 666f 7220  responsible for 
│ │ │ │ -0003dce0: 616c 6c6f 6361 7469 6e67 2061 6e64 2064  allocating and d
│ │ │ │ -0003dcf0: 6561 6c6c 6f63 6174 696e 6720 7468 6520  eallocating the 
│ │ │ │ -0003dd00: 7374 7275 6374 0a69 7473 656c 662e 2020  struct.itself.  
│ │ │ │ -0003dd10: 4561 6368 2073 7563 6820 7374 7275 6374  Each such struct
│ │ │ │ -0003dd20: 2069 7320 2875 6e69 7175 656c 7929 2069   is (uniquely) i
│ │ │ │ -0003dd30: 6465 6e74 6966 6965 6420 6279 2074 6865  dentified by the
│ │ │ │ -0003dd40: 2063 6f6d 6269 6e61 7469 6f6e 206f 660a   combination of.
│ │ │ │ -0003dd50: 7072 696e 6369 7061 6c20 6e61 6d65 2061  principal name a
│ │ │ │ -0003dd60: 6e64 2072 6561 6c6d 206e 616d 652e 0a0a  nd realm name...
│ │ │ │ -0003dd70: 2020 2020 2073 7472 7563 7420 5368 6973       struct Shis
│ │ │ │ -0003dd80: 615f 7072 696e 6369 7061 6c0a 2020 2020  a_principal.    
│ │ │ │ -0003dd90: 207b 0a20 2020 2020 2020 696e 7420 6973   {.       int is
│ │ │ │ -0003dda0: 6469 7361 626c 6564 3b0a 2020 2020 2020  disabled;.      
│ │ │ │ -0003ddb0: 2075 696e 7433 325f 7420 6b76 6e6f 3b0a   uint32_t kvno;.
│ │ │ │ -0003ddc0: 2020 2020 2020 2074 696d 655f 7420 6e6f         time_t no
│ │ │ │ -0003ddd0: 7475 7365 6462 6566 6f72 653b 0a20 2020  tusedbefore;.   
│ │ │ │ -0003dde0: 2020 2020 7469 6d65 5f74 206c 6173 7469      time_t lasti
│ │ │ │ -0003ddf0: 6e69 7469 616c 7467 743b 2020 2020 2020  nitialtgt;      
│ │ │ │ -0003de00: 2f2a 2074 696d 6520 6f66 206c 6173 7420  /* time of last 
│ │ │ │ -0003de10: 696e 6974 6961 6c20 7265 7175 6573 7420  initial request 
│ │ │ │ -0003de20: 666f 7220 6120 5447 5420 2a2f 0a20 2020  for a TGT */.   
│ │ │ │ -0003de30: 2020 2020 7469 6d65 5f74 206c 6173 7469      time_t lasti
│ │ │ │ -0003de40: 6e69 7469 616c 7265 7175 6573 743b 2020  nitialrequest;  
│ │ │ │ -0003de50: 2f2a 2074 696d 6520 6f66 206c 6173 7420  /* time of last 
│ │ │ │ -0003de60: 696e 6974 6961 6c20 7265 7175 6573 7420  initial request 
│ │ │ │ -0003de70: 2a2f 0a20 2020 2020 2020 7469 6d65 5f74  */.       time_t
│ │ │ │ -0003de80: 206c 6173 7474 6774 3b20 2020 2020 2020   lasttgt;       
│ │ │ │ -0003de90: 2020 2020 2020 2f2a 2074 696d 6520 6f66        /* time of
│ │ │ │ -0003dea0: 2069 7373 7565 2066 6f72 2074 6865 206e   issue for the n
│ │ │ │ -0003deb0: 6577 6573 7420 5447 5420 7573 6564 202a  ewest TGT used *
│ │ │ │ -0003dec0: 2f0a 2020 2020 2020 2074 696d 655f 7420  /.       time_t 
│ │ │ │ -0003ded0: 6c61 7374 7265 6e65 7761 6c3b 2020 2020  lastrenewal;    
│ │ │ │ -0003dee0: 2020 2020 202f 2a20 7469 6d65 206f 6620       /* time of 
│ │ │ │ -0003def0: 7468 6520 6c61 7374 2072 656e 6577 616c  the last renewal
│ │ │ │ -0003df00: 202a 2f0a 2020 2020 2020 2074 696d 655f   */.       time_
│ │ │ │ -0003df10: 7420 7061 7373 776f 7264 6578 7069 7265  t passwordexpire
│ │ │ │ -0003df20: 3b20 2020 2020 202f 2a20 7469 6d65 2077  ;      /* time w
│ │ │ │ -0003df30: 6865 6e20 7468 6520 7061 7373 776f 7264  hen the password
│ │ │ │ -0003df40: 2077 696c 6c20 6578 7069 7265 202a 2f0a   will expire */.
│ │ │ │ -0003df50: 2020 2020 2020 2074 696d 655f 7420 6163         time_t ac
│ │ │ │ -0003df60: 636f 756e 7465 7870 6972 653b 2020 2020  countexpire;    
│ │ │ │ -0003df70: 2020 202f 2a20 7469 6d65 2077 6865 6e20     /* time when 
│ │ │ │ -0003df80: 7468 6520 6163 636f 756e 7420 7769 6c6c  the account will
│ │ │ │ -0003df90: 2065 7870 6972 652e 202a 2f0a 2020 2020   expire. */.    
│ │ │ │ -0003dfa0: 207d 3b0a 2020 2020 2074 7970 6564 6566   };.     typedef
│ │ │ │ -0003dfb0: 2073 7472 7563 7420 5368 6973 615f 7072   struct Shisa_pr
│ │ │ │ -0003dfc0: 696e 6369 7061 6c20 5368 6973 615f 7072  incipal Shisa_pr
│ │ │ │ -0003dfd0: 696e 6369 7061 6c3b 0a0a 2020 2054 6865  incipal;..   The
│ │ │ │ -0003dfe0: 2073 6563 6f6e 6420 7374 7275 6374 7572   second structur
│ │ │ │ -0003dff0: 6520 6973 2063 616c 6c65 6420 e280 9853  e is called ...S
│ │ │ │ -0003e000: 6869 7361 5f6b 6579 e280 9920 616e 6420  hisa_key... and 
│ │ │ │ -0003e010: 686f 6c64 2069 6e66 6f72 6d61 7469 6f6e  hold information
│ │ │ │ -0003e020: 2061 626f 7574 0a63 7279 7074 6f67 7261   about.cryptogra
│ │ │ │ -0003e030: 7068 6963 206b 6579 732e 2020 4265 6361  phic keys.  Beca
│ │ │ │ -0003e040: 7573 6520 7468 6520 7374 7275 6374 2063  use the struct c
│ │ │ │ -0003e050: 6f6e 7461 696e 2070 6f69 6e74 6572 732c  ontain pointers,
│ │ │ │ -0003e060: 2061 6e64 2074 6865 2063 616c 6c65 720a   and the caller.
│ │ │ │ -0003e070: 6361 6e6e 6f74 206b 6e6f 7720 686f 7720  cannot know how 
│ │ │ │ -0003e080: 6d61 6e79 206b 6579 7320 6120 7072 696e  many keys a prin
│ │ │ │ -0003e090: 6369 7061 6c20 6861 7665 2c20 7468 6520  cipal have, the 
│ │ │ │ -0003e0a0: 5368 6973 6120 6c69 6272 6172 7920 6d61  Shisa library ma
│ │ │ │ -0003e0b0: 6e61 6765 730a 6d65 6d6f 7279 2066 6f72  nages.memory for
│ │ │ │ -0003e0c0: 2074 6865 2073 7472 7563 742e 2020 5468   the struct.  Th
│ │ │ │ -0003e0d0: 6520 6c69 6272 6172 7920 616c 6c6f 6361  e library alloca
│ │ │ │ -0003e0e0: 7465 2074 6865 2073 7472 7563 7473 2c20  te the structs, 
│ │ │ │ -0003e0f0: 616e 6420 7468 650a 706f 696e 7465 7273  and the.pointers
│ │ │ │ -0003e100: 2077 6974 6869 6e20 7468 656d 2e20 2054   within them.  T
│ │ │ │ -0003e110: 6865 2063 616c 6c65 7220 6d61 7920 6465  he caller may de
│ │ │ │ -0003e120: 616c 6c6f 6361 7465 2074 6865 6d2c 2062  allocate them, b
│ │ │ │ -0003e130: 7574 2069 7420 6973 0a72 6563 6f6d 6d65  ut it is.recomme
│ │ │ │ -0003e140: 6e64 6564 2074 6f20 7573 6520 e280 9873  nded to use ...s
│ │ │ │ -0003e150: 6869 7361 5f6b 6579 5f66 7265 65e2 8099  hisa_key_free...
│ │ │ │ -0003e160: 206f 7220 e280 9873 6869 7361 5f6b 6579   or ...shisa_key
│ │ │ │ -0003e170: 735f 6672 6565 e280 9920 696e 7374 6561  s_free... instea
│ │ │ │ -0003e180: 642e 2020 4e6f 7465 0a74 6861 7420 6561  d.  Note.that ea
│ │ │ │ -0003e190: 6368 2070 7269 6e63 6970 616c 206d 6179  ch principal may
│ │ │ │ -0003e1a0: 2068 6176 6520 6d75 6c74 6970 6c65 206b   have multiple k
│ │ │ │ -0003e1b0: 6579 732e 0a0a 2020 2020 2073 7472 7563  eys...     struc
│ │ │ │ -0003e1c0: 7420 5368 6973 615f 6b65 790a 2020 2020  t Shisa_key.    
│ │ │ │ -0003e1d0: 207b 0a20 2020 2020 2020 7569 6e74 3332   {.       uint32
│ │ │ │ -0003e1e0: 5f74 206b 766e 6f3b 0a20 2020 2020 2020  _t kvno;.       
│ │ │ │ -0003e1f0: 696e 7433 325f 7420 6574 7970 653b 0a20  int32_t etype;. 
│ │ │ │ -0003e200: 2020 2020 2020 696e 7420 7072 696f 7269        int priori
│ │ │ │ -0003e210: 7479 3b0a 2020 2020 2020 2063 6861 7220  ty;.       char 
│ │ │ │ -0003e220: 2a6b 6579 3b0a 2020 2020 2020 2073 697a  *key;.       siz
│ │ │ │ -0003e230: 655f 7420 6b65 796c 656e 3b0a 2020 2020  e_t keylen;.    
│ │ │ │ -0003e240: 2020 2063 6861 7220 2a73 616c 743b 0a20     char *salt;. 
│ │ │ │ -0003e250: 2020 2020 2020 7369 7a65 5f74 2073 616c        size_t sal
│ │ │ │ -0003e260: 746c 656e 3b0a 2020 2020 2020 2063 6861  tlen;.       cha
│ │ │ │ -0003e270: 7220 2a73 7472 326b 6579 7061 7261 6d3b  r *str2keyparam;
│ │ │ │ -0003e280: 0a20 2020 2020 2020 7369 7a65 5f74 2073  .       size_t s
│ │ │ │ -0003e290: 7472 326b 6579 7061 7261 6d6c 656e 3b0a  tr2keyparamlen;.
│ │ │ │ -0003e2a0: 2020 2020 2020 2063 6861 7220 2a70 6173         char *pas
│ │ │ │ -0003e2b0: 7377 6f72 643b 0a20 2020 2020 7d3b 0a20  sword;.     };. 
│ │ │ │ -0003e2c0: 2020 2020 7479 7065 6465 6620 7374 7275      typedef stru
│ │ │ │ -0003e2d0: 6374 2053 6869 7361 5f6b 6579 2053 6869  ct Shisa_key Shi
│ │ │ │ -0003e2e0: 7361 5f6b 6579 3b0a 0a20 2020 5368 6973  sa_key;..   Shis
│ │ │ │ -0003e2f0: 6120 6973 2074 7970 6963 616c 6c79 2069  a is typically i
│ │ │ │ -0003e300: 6e69 7469 616c 697a 6564 2062 7920 6361  nitialized by ca
│ │ │ │ -0003e310: 6c6c 696e 6720 e280 9873 6869 7361 5f69  lling ...shisa_i
│ │ │ │ -0003e320: 6e69 74e2 8099 2c20 616e 640a 6465 696e  nit..., and.dein
│ │ │ │ -0003e330: 6974 6961 6c69 7a65 6420 2877 6865 6e20  itialized (when 
│ │ │ │ -0003e340: 7468 6520 6170 706c 6963 6174 696f 6e20  the application 
│ │ │ │ -0003e350: 6e6f 206c 6f6e 6765 7220 6e65 6564 2074  no longer need t
│ │ │ │ -0003e360: 6f20 7573 6520 5368 6973 612c 0a74 7970  o use Shisa,.typ
│ │ │ │ -0003e370: 6963 616c 6c79 2077 6865 6e20 6974 2073  ically when it s
│ │ │ │ -0003e380: 6875 7473 2064 6f77 6e29 2062 7920 6361  huts down) by ca
│ │ │ │ -0003e390: 6c6c 696e 6720 e280 9873 6869 7361 5f64  lling ...shisa_d
│ │ │ │ -0003e3a0: 6f6e 65e2 8099 2c20 6275 7420 6865 7265  one..., but here
│ │ │ │ -0003e3b0: 2061 7265 2074 6865 0a63 6f6d 706c 6574   are the.complet
│ │ │ │ -0003e3c0: 6520 2864 6529 696e 6974 6961 6c69 7a61  e (de)initializa
│ │ │ │ -0003e3d0: 7469 6f6e 2069 6e74 6572 6661 6365 2066  tion interface f
│ │ │ │ -0003e3e0: 756e 6374 696f 6e73 2e0a 0a73 6869 7361  unctions...shisa
│ │ │ │ -0003e3f0: 0a2d 2d2d 2d2d 0a0a 202d 2d20 4675 6e63  .-----.. -- Func
│ │ │ │ -0003e400: 7469 6f6e 3a20 5368 6973 6120 2a20 7368  tion: Shisa * sh
│ │ │ │ -0003e410: 6973 6120 2829 0a0a 2020 2020 202a 4465  isa ()..     *De
│ │ │ │ -0003e420: 7363 7269 7074 696f 6e3a 2a20 496e 6974  scription:* Init
│ │ │ │ -0003e430: 6961 6c69 7a65 7320 7468 6520 5368 6973  ializes the Shis
│ │ │ │ -0003e440: 6120 6c69 6272 6172 792e 2020 4966 2074  a library.  If t
│ │ │ │ -0003e450: 6869 7320 6675 6e63 7469 6f6e 0a20 2020  his function.   
│ │ │ │ -0003e460: 2020 6661 696c 732c 2069 7420 6d61 7920    fails, it may 
│ │ │ │ -0003e470: 7072 696e 7420 6469 6167 6e6f 7374 6963  print diagnostic
│ │ │ │ -0003e480: 2065 7272 6f72 7320 746f 2073 7461 6e64   errors to stand
│ │ │ │ -0003e490: 6172 6420 6572 726f 722e 0a0a 2020 2020  ard error...    
│ │ │ │ -0003e4a0: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ -0003e4b0: 2052 6574 7572 6e73 2061 2053 6869 7361   Returns a Shisa
│ │ │ │ -0003e4c0: 206c 6962 7261 7279 2068 616e 646c 652c   library handle,
│ │ │ │ -0003e4d0: 206f 7220 e280 984e 554c 4ce2 8099 206f   or ...NULL... o
│ │ │ │ -0003e4e0: 6e20 6572 726f 722e 0a0a 7368 6973 615f  n error...shisa_
│ │ │ │ -0003e4f0: 646f 6e65 0a2d 2d2d 2d2d 2d2d 2d2d 2d0a  done.----------.
│ │ │ │ -0003e500: 0a20 2d2d 2046 756e 6374 696f 6e3a 2076  . -- Function: v
│ │ │ │ -0003e510: 6f69 6420 7368 6973 615f 646f 6e65 2028  oid shisa_done (
│ │ │ │ -0003e520: 5368 6973 6120 2a20 4442 4829 0a20 2020  Shisa * DBH).   
│ │ │ │ -0003e530: 2020 4442 483a 2053 6869 7361 2068 616e    DBH: Shisa han
│ │ │ │ -0003e540: 646c 6520 6173 2061 6c6c 6f63 6174 6564  dle as allocated
│ │ │ │ -0003e550: 2062 7920 e280 9873 6869 7361 2829 e280   by ...shisa()..
│ │ │ │ -0003e560: 992e 0a0a 2020 2020 202a 4465 7363 7269  ....     *Descri
│ │ │ │ -0003e570: 7074 696f 6e3a 2a20 4465 616c 6c6f 6361  ption:* Dealloca
│ │ │ │ -0003e580: 7465 7320 7468 6520 7368 6973 6120 6c69  tes the shisa li
│ │ │ │ -0003e590: 6272 6172 7920 6861 6e64 6c65 2e20 2054  brary handle.  T
│ │ │ │ -0003e5a0: 6865 2068 616e 646c 650a 2020 2020 206d  he handle.     m
│ │ │ │ -0003e5b0: 7573 7420 6e6f 7420 6265 2075 7365 6420  ust not be used 
│ │ │ │ -0003e5c0: 696e 2063 616c 6c73 2074 6f20 616e 7920  in calls to any 
│ │ │ │ -0003e5d0: 7368 6973 6120 6675 6e63 7469 6f6e 2061  shisa function a
│ │ │ │ -0003e5e0: 6674 6572 2074 6865 0a20 2020 2020 636f  fter the.     co
│ │ │ │ -0003e5f0: 6d70 6c65 7469 6f6e 206f 6620 7468 6973  mpletion of this
│ │ │ │ -0003e600: 2063 616c 6c2e 0a0a 7368 6973 615f 696e   call...shisa_in
│ │ │ │ -0003e610: 6974 0a2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  it.----------.. 
│ │ │ │ -0003e620: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ -0003e630: 2073 6869 7361 5f69 6e69 7420 2853 6869   shisa_init (Shi
│ │ │ │ -0003e640: 7361 202a 2a20 4442 4829 0a20 2020 2020  sa ** DBH).     
│ │ │ │ -0003e650: 4442 483a 2052 6574 7572 6e65 6420 706f  DBH: Returned po
│ │ │ │ -0003e660: 696e 7465 7220 746f 2061 2063 7265 6174  inter to a creat
│ │ │ │ -0003e670: 6564 2053 6869 7361 206c 6962 7261 7279  ed Shisa library
│ │ │ │ -0003e680: 2068 616e 646c 652e 0a0a 2020 2020 202a   handle...     *
│ │ │ │ -0003e690: 4465 7363 7269 7074 696f 6e3a 2a20 4372  Description:* Cr
│ │ │ │ -0003e6a0: 6561 7465 7320 6120 5368 6973 6120 6c69  eates a Shisa li
│ │ │ │ -0003e6b0: 6272 6172 7920 6861 6e64 6c65 2c20 7573  brary handle, us
│ │ │ │ -0003e6c0: 696e 6720 e280 9873 6869 7361 2829 e280  ing ...shisa()..
│ │ │ │ -0003e6d0: 992c 0a20 2020 2020 7265 6164 696e 6720  .,.     reading 
│ │ │ │ -0003e6e0: 7468 6520 7379 7374 656d 2063 6f6e 6669  the system confi
│ │ │ │ -0003e6f0: 6775 7261 7469 6f6e 2066 696c 6520 6672  guration file fr
│ │ │ │ -0003e700: 6f6d 2069 7473 2064 6566 6175 6c74 206c  om its default l
│ │ │ │ -0003e710: 6f63 6174 696f 6e2e 0a20 2020 2020 5468  ocation..     Th
│ │ │ │ -0003e720: 6520 7061 7468 2074 6f20 7468 6520 6465  e path to the de
│ │ │ │ -0003e730: 6661 756c 7420 7379 7374 656d 2063 6f6e  fault system con
│ │ │ │ -0003e740: 6669 6775 7261 7469 6f6e 2066 696c 6520  figuration file 
│ │ │ │ -0003e750: 6973 2064 6563 6964 6564 2061 740a 2020  is decided at.  
│ │ │ │ -0003e760: 2020 2063 6f6d 7069 6c65 2074 696d 6520     compile time 
│ │ │ │ -0003e770: 28e2 8098 7379 7363 6f6e 6664 6972 e280  (...sysconfdir..
│ │ │ │ -0003e780: 992f 7368 6973 612e 636f 6e66 292e 0a0a  ./shisa.conf)...
│ │ │ │ -0003e790: 2020 2020 2054 6865 2068 616e 646c 6520       The handle 
│ │ │ │ -0003e7a0: 6973 2061 6c6c 6f63 6174 6564 2072 6567  is allocated reg
│ │ │ │ -0003e7b0: 6172 646c 6573 7320 6f66 2072 6574 7572  ardless of retur
│ │ │ │ -0003e7c0: 6e20 7661 6c75 652c 2074 6865 206f 6e6c  n value, the onl
│ │ │ │ -0003e7d0: 790a 2020 2020 2065 7863 6570 7469 6f6e  y.     exception
│ │ │ │ -0003e7e0: 2062 6569 6e67 20e2 8098 5348 4953 415f   being ...SHISA_
│ │ │ │ -0003e7f0: 494e 4954 5f45 5252 4f52 e280 992c 2077  INIT_ERROR..., w
│ │ │ │ -0003e800: 6869 6368 2069 6e64 6963 6174 6573 2061  hich indicates a
│ │ │ │ -0003e810: 2070 726f 626c 656d 2069 6e0a 2020 2020   problem in.    
│ │ │ │ -0003e820: 2061 6c6c 6f63 6174 696e 6720 7468 6520   allocating the 
│ │ │ │ -0003e830: 6861 6e64 6c65 2e20 204f 7468 6572 2065  handle.  Other e
│ │ │ │ -0003e840: 7272 6f72 2063 6f6e 6469 7469 6f6e 7320  rror conditions 
│ │ │ │ -0003e850: 6172 6973 6520 7768 696c 6520 7265 6164  arise while read
│ │ │ │ -0003e860: 696e 670a 2020 2020 2061 2066 696c 652e  ing.     a file.
│ │ │ │ -0003e870: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ -0003e880: 616c 7565 3a2a 2052 6574 7572 6e73 20e2  alue:* Returns .
│ │ │ │ -0003e890: 8098 5348 4953 415f 4f4b e280 992c 206f  ..SHISA_OK..., o
│ │ │ │ -0003e8a0: 7220 616e 2065 7272 6f72 2063 6f64 652e  r an error code.
│ │ │ │ -0003e8b0: 2020 5468 6520 7661 6c75 650a 2020 2020    The value.    
│ │ │ │ -0003e8c0: 20e2 8098 5348 4953 415f 494e 4954 5f45   ...SHISA_INIT_E
│ │ │ │ -0003e8d0: 5252 4f52 e280 9920 696e 6469 6361 7465  RROR... indicate
│ │ │ │ -0003e8e0: 7320 6120 6661 696c 7572 6520 746f 2063  s a failure to c
│ │ │ │ -0003e8f0: 7265 6174 6520 7468 6520 6861 6e64 6c65  reate the handle
│ │ │ │ -0003e900: 2e0a 0a73 6869 7361 5f69 6e69 745f 7769  ...shisa_init_wi
│ │ │ │ -0003e910: 7468 5f70 6174 6873 0a2d 2d2d 2d2d 2d2d  th_paths.-------
│ │ │ │ -0003e920: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ -0003e930: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ -0003e940: 7420 7368 6973 615f 696e 6974 5f77 6974  t shisa_init_wit
│ │ │ │ -0003e950: 685f 7061 7468 7320 2853 6869 7361 202a  h_paths (Shisa *
│ │ │ │ -0003e960: 2a20 4442 482c 0a20 2020 2020 2020 2020  * DBH,.         
│ │ │ │ -0003e970: 2063 6f6e 7374 2063 6861 7220 2a20 4649   const char * FI
│ │ │ │ -0003e980: 4c45 290a 2020 2020 2044 4248 3a20 5265  LE).     DBH: Re
│ │ │ │ -0003e990: 7475 726e 6564 2070 6f69 6e74 6572 2074  turned pointer t
│ │ │ │ -0003e9a0: 6f20 6120 6372 6561 7465 6420 5368 6973  o a created Shis
│ │ │ │ -0003e9b0: 6120 6c69 6272 6172 7920 6861 6e64 6c65  a library handle
│ │ │ │ -0003e9c0: 2e0a 2020 2020 2046 494c 453a 2046 696c  ..     FILE: Fil
│ │ │ │ -0003e9d0: 656e 616d 6520 6f66 2073 7973 7465 6d20  ename of system 
│ │ │ │ -0003e9e0: 636f 6e66 6967 7572 6174 696f 6e2c 206f  configuration, o
│ │ │ │ -0003e9f0: 7220 e280 984e 554c 4ce2 8099 2e0a 0a20  r ...NULL...... 
│ │ │ │ -0003ea00: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -0003ea10: 3a2a 2043 7265 6174 6573 2061 2053 6869  :* Creates a Shi
│ │ │ │ -0003ea20: 7361 206c 6962 7261 7279 2068 616e 646c  sa library handl
│ │ │ │ -0003ea30: 652c 2075 7369 6e67 20e2 8098 7368 6973  e, using ...shis
│ │ │ │ -0003ea40: 6128 29e2 8099 2c20 6275 740a 2020 2020  a()..., but.    
│ │ │ │ -0003ea50: 2072 6561 6469 6e67 2074 6865 2073 7973   reading the sys
│ │ │ │ -0003ea60: 7465 6d20 636f 6e66 6967 7572 6174 696f  tem configuratio
│ │ │ │ -0003ea70: 6e20 6669 6c65 2061 7420 7468 6520 6c6f  n file at the lo
│ │ │ │ -0003ea80: 6361 7469 6f6e 2046 494c 452c 206f 7220  cation FILE, or 
│ │ │ │ -0003ea90: 6174 0a20 2020 2020 7468 6520 6465 6661  at.     the defa
│ │ │ │ -0003eaa0: 756c 7420 6c6f 6361 7469 6f6e 2c20 7368  ult location, sh
│ │ │ │ -0003eab0: 6f75 6c64 2046 494c 4520 6265 20e2 8098  ould FILE be ...
│ │ │ │ -0003eac0: 4e55 4c4c e280 992e 2020 5468 6520 7061  NULL....  The pa
│ │ │ │ -0003ead0: 7468 2074 6f20 7468 650a 2020 2020 2064  th to the.     d
│ │ │ │ -0003eae0: 6566 6175 6c74 2073 7973 7465 6d20 636f  efault system co
│ │ │ │ -0003eaf0: 6e66 6967 7572 6174 696f 6e20 6669 6c65  nfiguration file
│ │ │ │ -0003eb00: 2069 7320 6465 6369 6465 6420 6174 2063   is decided at c
│ │ │ │ -0003eb10: 6f6d 7069 6c65 2074 696d 650a 2020 2020  ompile time.    
│ │ │ │ -0003eb20: 2028 e280 9873 7973 636f 6e66 6469 72e2   (...sysconfdir.
│ │ │ │ -0003eb30: 8099 2f73 6869 7361 2e63 6f6e 6629 2e0a  ../shisa.conf)..
│ │ │ │ -0003eb40: 0a20 2020 2020 5468 6520 6861 6e64 6c65  .     The handle
│ │ │ │ -0003eb50: 2069 7320 616c 6c6f 6361 7465 6420 7265   is allocated re
│ │ │ │ -0003eb60: 6761 7264 6c65 7373 206f 6620 7265 7475  gardless of retu
│ │ │ │ -0003eb70: 726e 2076 616c 7565 2c20 7468 6520 6f6e  rn value, the on
│ │ │ │ -0003eb80: 6c79 0a20 2020 2020 6578 6365 7074 696f  ly.     exceptio
│ │ │ │ -0003eb90: 6e20 6265 696e 6720 e280 9853 4849 5341  n being ...SHISA
│ │ │ │ -0003eba0: 5f49 4e49 545f 4552 524f 52e2 8099 2c20  _INIT_ERROR..., 
│ │ │ │ -0003ebb0: 7768 6963 6820 696e 6469 6361 7465 7320  which indicates 
│ │ │ │ -0003ebc0: 6120 7072 6f62 6c65 6d20 696e 0a20 2020  a problem in.   
│ │ │ │ -0003ebd0: 2020 616c 6c6f 6361 7469 6e67 2074 6865    allocating the
│ │ │ │ -0003ebe0: 2068 616e 646c 652e 2020 4f74 6865 7220   handle.  Other 
│ │ │ │ -0003ebf0: 6572 726f 7220 636f 6e64 6974 696f 6e73  error conditions
│ │ │ │ -0003ec00: 2061 7269 7365 2077 6869 6c65 2072 6561   arise while rea
│ │ │ │ -0003ec10: 6469 6e67 0a20 2020 2020 6120 6669 6c65  ding.     a file
│ │ │ │ -0003ec20: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ -0003ec30: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ -0003ec40: e280 9853 4849 5341 5f4f 4be2 8099 2c20  ...SHISA_OK..., 
│ │ │ │ -0003ec50: 6f72 2061 6e20 6572 726f 7220 636f 6465  or an error code
│ │ │ │ -0003ec60: 2e20 2054 6865 2076 616c 7565 0a20 2020  .  The value.   
│ │ │ │ -0003ec70: 2020 e280 9853 4849 5341 5f49 4e49 545f    ...SHISA_INIT_
│ │ │ │ -0003ec80: 4552 524f 52e2 8099 2069 6e64 6963 6174  ERROR... indicat
│ │ │ │ -0003ec90: 6573 2061 2066 6169 6c75 7265 2074 6f20  es a failure to 
│ │ │ │ -0003eca0: 6372 6561 7465 2074 6865 2068 616e 646c  create the handl
│ │ │ │ -0003ecb0: 652e 0a0a 2020 2054 6865 2064 6566 6175  e...   The defau
│ │ │ │ -0003ecc0: 6c74 2063 6f6e 6669 6775 7261 7469 6f6e  lt configuration
│ │ │ │ -0003ecd0: 2066 696c 6520 6973 2074 7970 6963 616c   file is typical
│ │ │ │ -0003ece0: 6c79 2072 6561 6420 6175 746f 6d61 7469  ly read automati
│ │ │ │ -0003ecf0: 6361 6c6c 7920 6279 0a63 616c 6c69 6e67  cally by.calling
│ │ │ │ -0003ed00: 20e2 8098 7368 6973 615f 696e 6974 e280   ...shisa_init..
│ │ │ │ -0003ed10: 992c 2062 7574 2069 6620 796f 7520 7769  ., but if you wi
│ │ │ │ -0003ed20: 7368 2074 6f20 6d61 6e75 616c 6c79 2061  sh to manually a
│ │ │ │ -0003ed30: 6363 6573 7320 7468 6520 5368 6973 610a  ccess the Shisa.
│ │ │ │ -0003ed40: 636f 6e66 6967 7572 6174 696f 6e20 6669  configuration fi
│ │ │ │ -0003ed50: 6c65 2066 756e 6374 696f 6e73 2c20 6865  le functions, he
│ │ │ │ -0003ed60: 7265 2069 7320 7468 6520 636f 6d70 6c65  re is the comple
│ │ │ │ -0003ed70: 7465 2069 6e74 6572 6661 6365 2e0a 0a73  te interface...s
│ │ │ │ -0003ed80: 6869 7361 5f63 6667 5f64 620a 2d2d 2d2d  hisa_cfg_db.----
│ │ │ │ -0003ed90: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -0003eda0: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ -0003edb0: 615f 6366 675f 6462 2028 5368 6973 6120  a_cfg_db (Shisa 
│ │ │ │ -0003edc0: 2a20 4442 482c 2063 6f6e 7374 2063 6861  * DBH, const cha
│ │ │ │ -0003edd0: 7220 2a20 5641 4c55 4529 0a20 2020 2020  r * VALUE).     
│ │ │ │ -0003ede0: 4442 483a 2053 6869 7361 206c 6962 7261  DBH: Shisa libra
│ │ │ │ -0003edf0: 7279 2068 616e 646c 6520 6372 6561 7465  ry handle create
│ │ │ │ -0003ee00: 6420 6279 20e2 8098 7368 6973 6128 29e2  d by ...shisa().
│ │ │ │ -0003ee10: 8099 2e0a 2020 2020 2056 414c 5545 3a20  ....     VALUE: 
│ │ │ │ -0003ee20: 5374 7269 6e67 2063 6f6e 7461 696e 696e  String containin
│ │ │ │ -0003ee30: 6720 6461 7461 6261 7365 2064 6566 696e  g database defin
│ │ │ │ -0003ee40: 6974 696f 6e2e 0a0a 2020 2020 202a 4465  ition...     *De
│ │ │ │ -0003ee50: 7363 7269 7074 696f 6e3a 2a20 5365 7473  scription:* Sets
│ │ │ │ -0003ee60: 2075 7020 616e 6420 6f70 656e 7320 6120   up and opens a 
│ │ │ │ -0003ee70: 6e65 7720 6461 7461 6261 7365 2e20 2054  new database.  T
│ │ │ │ -0003ee80: 6865 2073 796e 7461 7820 6f66 2074 6865  he syntax of the
│ │ │ │ -0003ee90: 0a20 2020 2020 7061 7261 6d65 7465 7220  .     parameter 
│ │ │ │ -0003eea0: 5641 4c55 4520 6973 2022 5459 5045 5b20  VALUE is "TYPE[ 
│ │ │ │ -0003eeb0: 4c4f 4341 5449 4f4e 5b20 5041 5241 4d45  LOCATION[ PARAME
│ │ │ │ -0003eec0: 5445 525d 5d22 2c20 7768 6572 6520 5459  TER]]", where TY
│ │ │ │ -0003eed0: 5045 2069 7320 6f6e 650a 2020 2020 206f  PE is one.     o
│ │ │ │ -0003eee0: 6620 7468 6520 7375 7070 6f72 7465 6420  f the supported 
│ │ │ │ -0003eef0: 6461 7461 6261 7365 2074 7970 6573 2c20  database types, 
│ │ │ │ -0003ef00: 7479 7069 6361 6c6c 7920 2266 696c 6522  typically "file"
│ │ │ │ -0003ef10: 2e0a 0a20 2020 2020 5468 6520 6162 6f76  ...     The abov
│ │ │ │ -0003ef20: 6520 7375 6273 7472 696e 6773 204c 4f43  e substrings LOC
│ │ │ │ -0003ef30: 4154 494f 4e20 616e 6420 5041 5241 4d45  ATION and PARAME
│ │ │ │ -0003ef40: 5445 5220 6172 6520 6f70 7469 6f6e 616c  TER are optional
│ │ │ │ -0003ef50: 2073 7472 696e 6773 0a20 2020 2020 7061   strings.     pa
│ │ │ │ -0003ef60: 7373 6564 206f 6e20 7665 7262 6174 696d  ssed on verbatim
│ │ │ │ -0003ef70: 2074 6f20 7468 6520 6461 7461 6261 7365   to the database
│ │ │ │ -0003ef80: 2064 7572 696e 6720 696e 6974 6961 6c69   during initiali
│ │ │ │ -0003ef90: 7a61 7469 6f6e 2e20 204e 6569 7468 6572  zation.  Neither
│ │ │ │ -0003efa0: 0a20 2020 2020 5459 5045 206e 6f72 204c  .     TYPE nor L
│ │ │ │ -0003efb0: 4f43 4154 494f 4e20 6d61 7920 636f 6e74  OCATION may cont
│ │ │ │ -0003efc0: 6169 6e20 656d 6265 6464 6564 2073 7061  ain embedded spa
│ │ │ │ -0003efd0: 6365 732c 2062 7574 2050 4152 414d 4554  ces, but PARAMET
│ │ │ │ -0003efe0: 4552 206d 6179 2064 6f0a 2020 2020 2073  ER may do.     s
│ │ │ │ -0003eff0: 6f2e 0a0a 2020 2020 202a 5265 7475 726e  o...     *Return
│ │ │ │ -0003f000: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ -0003f010: 20e2 8098 5348 4953 415f 4f4b e280 9920   ...SHISA_OK... 
│ │ │ │ -0003f020: 6966 2061 2064 6174 6162 6173 6520 7761  if a database wa
│ │ │ │ -0003f030: 7320 7061 7273 6564 2061 6e64 0a20 2020  s parsed and.   
│ │ │ │ -0003f040: 2020 6f70 656e 6564 2073 7563 6365 7373    opened success
│ │ │ │ -0003f050: 6675 6c6c 792e 0a0a 7368 6973 615f 6366  fully...shisa_cf
│ │ │ │ -0003f060: 670a 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  g.---------.. --
│ │ │ │ -0003f070: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ -0003f080: 6869 7361 5f63 6667 2028 5368 6973 6120  hisa_cfg (Shisa 
│ │ │ │ -0003f090: 2a20 4442 482c 2063 6f6e 7374 2063 6861  * DBH, const cha
│ │ │ │ -0003f0a0: 7220 2a20 4f50 5449 4f4e 290a 2020 2020  r * OPTION).    
│ │ │ │ -0003f0b0: 2044 4248 3a20 5368 6973 6120 6c69 6272   DBH: Shisa libr
│ │ │ │ -0003f0c0: 6172 7920 6861 6e64 6c65 2063 7265 6174  ary handle creat
│ │ │ │ -0003f0d0: 6564 2062 7920 e280 9873 6869 7361 2829  ed by ...shisa()
│ │ │ │ -0003f0e0: e280 992e 0a20 2020 2020 4f50 5449 4f4e  .....     OPTION
│ │ │ │ -0003f0f0: 3a20 5374 7269 6e67 2077 6974 6820 6f70  : String with op
│ │ │ │ -0003f100: 7469 6f6e 7320 746f 2070 7269 6d65 2074  tions to prime t
│ │ │ │ -0003f110: 6865 2053 6869 7361 206c 6962 7261 7279  he Shisa library
│ │ │ │ -0003f120: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ -0003f130: 7469 6f6e 3a2a 2043 6f6e 6669 6775 7265  tion:* Configure
│ │ │ │ -0003f140: 7320 7468 6520 5368 6973 6120 6c69 6272  s the Shisa libr
│ │ │ │ -0003f150: 6172 7920 6672 6f6d 2074 6865 2073 7065  ary from the spe
│ │ │ │ -0003f160: 6369 6669 6361 7469 6f6e 0a20 2020 2020  cification.     
│ │ │ │ -0003f170: 4f50 5449 4f4e 2e20 2054 6869 7320 6361  OPTION.  This ca
│ │ │ │ -0003f180: 6c6c 2065 7870 6563 7473 2061 2073 7472  ll expects a str
│ │ │ │ -0003f190: 696e 6720 6465 636c 6172 6174 696f 6e20  ing declaration 
│ │ │ │ -0003f1a0: 6f66 2074 6865 2066 6f72 6d0a 2020 2020  of the form.    
│ │ │ │ -0003f1b0: 2022 6462 3d56 414c 5545 222c 206f 7220   "db=VALUE", or 
│ │ │ │ -0003f1c0: 2264 6220 5641 4c55 4522 2e20 4865 7265  "db VALUE". Here
│ │ │ │ -0003f1d0: 2056 414c 5545 2069 7320 7468 6520 7361   VALUE is the sa
│ │ │ │ -0003f1e0: 6d65 2064 6563 6c61 7261 7469 6f6e 2061  me declaration a
│ │ │ │ -0003f1f0: 730a 2020 2020 2075 7365 6420 6279 20e2  s.     used by .
│ │ │ │ -0003f200: 8098 7368 6973 615f 6366 675f 6462 2829  ..shisa_cfg_db()
│ │ │ │ -0003f210: e280 992c 2069 2e65 2e2c 206f 6620 7468  ..., i.e., of th
│ │ │ │ -0003f220: 6520 666f 726d 2022 5459 5045 5b20 4c4f  e form "TYPE[ LO
│ │ │ │ -0003f230: 4341 5449 4f4e 5b0a 2020 2020 2050 4152  CATION[.     PAR
│ │ │ │ -0003f240: 414d 4554 4552 5d5d 222e 0a0a 2020 2020  AMETER]]"...    
│ │ │ │ -0003f250: 2054 6865 2070 7265 6669 7820 2264 6222   The prefix "db"
│ │ │ │ -0003f260: 2c20 6d61 6e64 6174 6f72 7920 696e 204f  , mandatory in O
│ │ │ │ -0003f270: 5054 494f 4e2c 206d 616b 6573 20e2 8098  PTION, makes ...
│ │ │ │ -0003f280: 7368 6973 615f 6366 6728 29e2 8099 2073  shisa_cfg()... s
│ │ │ │ -0003f290: 7569 7465 6420 746f 0a20 2020 2020 6120  uited to.     a 
│ │ │ │ -0003f2a0: 7379 6e74 6178 2077 6974 6820 6b65 792d  syntax with key-
│ │ │ │ -0003f2b0: 7661 6c75 6520 7061 6972 7320 616c 736f  value pairs also
│ │ │ │ -0003f2c0: 2069 6e20 5041 5241 4d45 5445 522e 0a0a   in PARAMETER...
│ │ │ │ -0003f2d0: 2020 2020 202a 5265 7475 726e 2076 616c       *Return val
│ │ │ │ -0003f2e0: 7565 3a2a 2052 6574 7572 6e73 20e2 8098  ue:* Returns ...
│ │ │ │ -0003f2f0: 5348 4953 415f 4f4b e280 9920 6966 204f  SHISA_OK... if O
│ │ │ │ -0003f300: 5054 494f 4e20 6973 2076 616c 6964 2e0a  PTION is valid..
│ │ │ │ -0003f310: 0a73 6869 7361 5f63 6667 5f66 726f 6d5f  .shisa_cfg_from_
│ │ │ │ -0003f320: 6669 6c65 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  file.-----------
│ │ │ │ -0003f330: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -0003f340: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ -0003f350: 615f 6366 675f 6672 6f6d 5f66 696c 6520  a_cfg_from_file 
│ │ │ │ -0003f360: 2853 6869 7361 202a 2044 4248 2c20 636f  (Shisa * DBH, co
│ │ │ │ -0003f370: 6e73 7420 6368 6172 202a 2043 4647 290a  nst char * CFG).
│ │ │ │ -0003f380: 2020 2020 2044 4248 3a20 5368 6973 6120       DBH: Shisa 
│ │ │ │ -0003f390: 6c69 6272 6172 7920 6861 6e64 6c65 2063  library handle c
│ │ │ │ -0003f3a0: 7265 6174 6564 2062 7920 e280 9873 6869  reated by ...shi
│ │ │ │ -0003f3b0: 7361 2829 e280 992e 0a20 2020 2020 4346  sa().....     CF
│ │ │ │ -0003f3c0: 473a 2046 696c 6520 6e61 6d65 2077 6865  G: File name whe
│ │ │ │ -0003f3d0: 7265 2074 6f20 7265 6164 2063 6f6e 6669  re to read confi
│ │ │ │ -0003f3e0: 6775 7261 7469 6f6e 2e0a 0a20 2020 2020  guration...     
│ │ │ │ -0003f3f0: 2a44 6573 6372 6970 7469 6f6e 3a2a 2043  *Description:* C
│ │ │ │ -0003f400: 6f6e 6669 6775 7265 7320 7468 6520 5368  onfigures the Sh
│ │ │ │ -0003f410: 6973 6120 6c69 6272 6172 7920 7573 696e  isa library usin
│ │ │ │ -0003f420: 6720 6120 636f 6e66 6967 7572 6174 696f  g a configuratio
│ │ │ │ -0003f430: 6e0a 2020 2020 2066 696c 6520 6c6f 6361  n.     file loca
│ │ │ │ -0003f440: 7465 6420 6174 2043 4647 2e0a 0a20 2020  ted at CFG...   
│ │ │ │ -0003f450: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ -0003f460: 2a20 5265 7475 726e 7320 e280 9853 4849  * Returns ...SHI
│ │ │ │ -0003f470: 5341 5f4f 4be2 8099 2069 6620 7375 6363  SA_OK... if succ
│ │ │ │ -0003f480: 6573 7366 756c 2e20 2054 7970 6963 616c  essful.  Typical
│ │ │ │ -0003f490: 6c79 0a20 2020 2020 7265 7475 726e 7320  ly.     returns 
│ │ │ │ -0003f4a0: e280 9853 4849 5341 5f43 4647 5f4e 4f5f  ...SHISA_CFG_NO_
│ │ │ │ -0003f4b0: 4649 4c45 e280 9920 696e 2072 6573 706f  FILE... in respo
│ │ │ │ -0003f4c0: 6e73 6520 746f 2061 206d 6973 6e61 6d65  nse to a misname
│ │ │ │ -0003f4d0: 6420 6669 6c65 2e0a 0a73 6869 7361 5f63  d file...shisa_c
│ │ │ │ -0003f4e0: 6667 5f64 6566 6175 6c74 5f73 7973 7465  fg_default_syste
│ │ │ │ -0003f4f0: 6d66 696c 650a 2d2d 2d2d 2d2d 2d2d 2d2d  mfile.----------
│ │ │ │ +0003da10: 3d3d 3d3d 3d3d 3d0a 0a53 6869 7361 2069  =======..Shisa i
│ │ │ │ +0003da20: 7320 6120 7365 7061 7261 7465 2061 6e64  s a separate and
│ │ │ │ +0003da30: 2073 7461 6e64 616c 6f6e 6520 6c69 6272   standalone libr
│ │ │ │ +0003da40: 6172 7920 6672 6f6d 2053 6869 7368 6920  ary from Shishi 
│ │ │ │ +0003da50: 282a 6e6f 7465 0a49 6e74 726f 6475 6374  (*note.Introduct
│ │ │ │ +0003da60: 696f 6e20 746f 2053 6869 7361 3a3a 292e  ion to Shisa::).
│ │ │ │ +0003da70: 2020 4966 2079 6f75 206f 6e6c 7920 7769    If you only wi
│ │ │ │ +0003da80: 7368 2074 6f20 6d61 6e69 7075 6c61 7465  sh to manipulate
│ │ │ │ +0003da90: 2074 6865 0a69 6e66 6f72 6d61 7469 6f6e   the.information
│ │ │ │ +0003daa0: 2073 746f 7265 6420 696e 2074 6865 204b   stored in the K
│ │ │ │ +0003dab0: 6572 6265 726f 7320 7573 6572 2064 6174  erberos user dat
│ │ │ │ +0003dac0: 6162 6173 6520 7573 6564 2062 7920 5368  abase used by Sh
│ │ │ │ +0003dad0: 6973 6869 2c20 796f 7520 646f 0a6e 6f74  ishi, you do.not
│ │ │ │ +0003dae0: 206e 6565 6420 746f 206c 696e 6b20 6f72   need to link or
│ │ │ │ +0003daf0: 2075 7365 2074 6865 2053 6869 7368 6920   use the Shishi 
│ │ │ │ +0003db00: 6c69 6272 6172 7920 6174 2061 6c6c 2e20  library at all. 
│ │ │ │ +0003db10: 2048 6f77 6576 6572 2c20 796f 7520 6d61   However, you ma
│ │ │ │ +0003db20: 790a 6669 6e64 2069 7420 7573 6566 756c  y.find it useful
│ │ │ │ +0003db30: 2074 6f20 636f 6d62 696e 6520 7468 6520   to combine the 
│ │ │ │ +0003db40: 7477 6f20 6c69 6272 6172 6965 732e 0a0a  two libraries...
│ │ │ │ +0003db50: 2020 2046 6f72 2074 776f 2072 6561 6c20     For two real 
│ │ │ │ +0003db60: 776f 726c 6420 6578 616d 706c 6573 206f  world examples o
│ │ │ │ +0003db70: 6e20 7573 696e 6720 7468 6520 5368 6973  n using the Shis
│ │ │ │ +0003db80: 6120 6c69 6272 6172 792c 2072 6566 6572  a library, refer
│ │ │ │ +0003db90: 2074 6f0a e280 9873 7263 2f73 6869 7361   to....src/shisa
│ │ │ │ +0003dba0: 2e63 e280 9920 2853 6869 7361 2063 6f6d  .c... (Shisa com
│ │ │ │ +0003dbb0: 6d61 6e64 206c 696e 6520 746f 6f6c 2920  mand line tool) 
│ │ │ │ +0003dbc0: 616e 6420 e280 9873 7263 2f6b 6463 2e63  and ...src/kdc.c
│ │ │ │ +0003dbd0: e280 9920 2870 6172 7420 6f66 2053 6869  ... (part of Shi
│ │ │ │ +0003dbe0: 7368 6964 0a73 6572 7665 7229 2e0a 0a20  shid.server)... 
│ │ │ │ +0003dbf0: 2020 5368 6973 6120 7573 6573 2074 776f    Shisa uses two
│ │ │ │ +0003dc00: 20e2 8098 7374 7275 6374 e280 9973 2074   ...struct...s t
│ │ │ │ +0003dc10: 6f20 6361 7272 7920 696e 666f 726d 6174  o carry informat
│ │ │ │ +0003dc20: 696f 6e2e 2020 5468 6520 6669 7273 742c  ion.  The first,
│ │ │ │ +0003dc30: 0ae2 8098 5368 6973 615f 7072 696e 6369  ....Shisa_princi
│ │ │ │ +0003dc40: 7061 6ce2 8099 2c20 6973 2075 7365 6420  pal..., is used 
│ │ │ │ +0003dc50: 746f 2068 6f6c 6420 696e 666f 726d 6174  to hold informat
│ │ │ │ +0003dc60: 696f 6e20 6162 6f75 7420 7072 696e 6369  ion about princi
│ │ │ │ +0003dc70: 7061 6c73 2e20 2054 6865 0a73 7472 7563  pals.  The.struc
│ │ │ │ +0003dc80: 7420 646f 6573 206e 6f74 2063 6f6e 7461  t does not conta
│ │ │ │ +0003dc90: 696e 2070 6f69 6e74 6572 7320 746f 2073  in pointers to s
│ │ │ │ +0003dca0: 7472 696e 6773 2065 7463 2c20 736f 2074  trings etc, so t
│ │ │ │ +0003dcb0: 6865 206c 6962 7261 7279 2061 7373 756d  he library assum
│ │ │ │ +0003dcc0: 6573 0a74 6865 2063 616c 6c65 7220 6973  es.the caller is
│ │ │ │ +0003dcd0: 2072 6573 706f 6e73 6962 6c65 2066 6f72   responsible for
│ │ │ │ +0003dce0: 2061 6c6c 6f63 6174 696e 6720 616e 6420   allocating and 
│ │ │ │ +0003dcf0: 6465 616c 6c6f 6361 7469 6e67 2074 6865  deallocating the
│ │ │ │ +0003dd00: 2073 7472 7563 740a 6974 7365 6c66 2e20   struct.itself. 
│ │ │ │ +0003dd10: 2045 6163 6820 7375 6368 2073 7472 7563   Each such struc
│ │ │ │ +0003dd20: 7420 6973 2028 756e 6971 7565 6c79 2920  t is (uniquely) 
│ │ │ │ +0003dd30: 6964 656e 7469 6669 6564 2062 7920 7468  identified by th
│ │ │ │ +0003dd40: 6520 636f 6d62 696e 6174 696f 6e20 6f66  e combination of
│ │ │ │ +0003dd50: 0a70 7269 6e63 6970 616c 206e 616d 6520  .principal name 
│ │ │ │ +0003dd60: 616e 6420 7265 616c 6d20 6e61 6d65 2e0a  and realm name..
│ │ │ │ +0003dd70: 0a20 2020 2020 7374 7275 6374 2053 6869  .     struct Shi
│ │ │ │ +0003dd80: 7361 5f70 7269 6e63 6970 616c 0a20 2020  sa_principal.   
│ │ │ │ +0003dd90: 2020 7b0a 2020 2020 2020 2069 6e74 2069    {.       int i
│ │ │ │ +0003dda0: 7364 6973 6162 6c65 643b 0a20 2020 2020  sdisabled;.     
│ │ │ │ +0003ddb0: 2020 7569 6e74 3332 5f74 206b 766e 6f3b    uint32_t kvno;
│ │ │ │ +0003ddc0: 0a20 2020 2020 2020 7469 6d65 5f74 206e  .       time_t n
│ │ │ │ +0003ddd0: 6f74 7573 6564 6265 666f 7265 3b0a 2020  otusedbefore;.  
│ │ │ │ +0003dde0: 2020 2020 2074 696d 655f 7420 6c61 7374       time_t last
│ │ │ │ +0003ddf0: 696e 6974 6961 6c74 6774 3b20 2020 2020  initialtgt;     
│ │ │ │ +0003de00: 202f 2a20 7469 6d65 206f 6620 6c61 7374   /* time of last
│ │ │ │ +0003de10: 2069 6e69 7469 616c 2072 6571 7565 7374   initial request
│ │ │ │ +0003de20: 2066 6f72 2061 2054 4754 202a 2f0a 2020   for a TGT */.  
│ │ │ │ +0003de30: 2020 2020 2074 696d 655f 7420 6c61 7374       time_t last
│ │ │ │ +0003de40: 696e 6974 6961 6c72 6571 7565 7374 3b20  initialrequest; 
│ │ │ │ +0003de50: 202f 2a20 7469 6d65 206f 6620 6c61 7374   /* time of last
│ │ │ │ +0003de60: 2069 6e69 7469 616c 2072 6571 7565 7374   initial request
│ │ │ │ +0003de70: 202a 2f0a 2020 2020 2020 2074 696d 655f   */.       time_
│ │ │ │ +0003de80: 7420 6c61 7374 7467 743b 2020 2020 2020  t lasttgt;      
│ │ │ │ +0003de90: 2020 2020 2020 202f 2a20 7469 6d65 206f         /* time o
│ │ │ │ +0003dea0: 6620 6973 7375 6520 666f 7220 7468 6520  f issue for the 
│ │ │ │ +0003deb0: 6e65 7765 7374 2054 4754 2075 7365 6420  newest TGT used 
│ │ │ │ +0003dec0: 2a2f 0a20 2020 2020 2020 7469 6d65 5f74  */.       time_t
│ │ │ │ +0003ded0: 206c 6173 7472 656e 6577 616c 3b20 2020   lastrenewal;   
│ │ │ │ +0003dee0: 2020 2020 2020 2f2a 2074 696d 6520 6f66        /* time of
│ │ │ │ +0003def0: 2074 6865 206c 6173 7420 7265 6e65 7761   the last renewa
│ │ │ │ +0003df00: 6c20 2a2f 0a20 2020 2020 2020 7469 6d65  l */.       time
│ │ │ │ +0003df10: 5f74 2070 6173 7377 6f72 6465 7870 6972  _t passwordexpir
│ │ │ │ +0003df20: 653b 2020 2020 2020 2f2a 2074 696d 6520  e;      /* time 
│ │ │ │ +0003df30: 7768 656e 2074 6865 2070 6173 7377 6f72  when the passwor
│ │ │ │ +0003df40: 6420 7769 6c6c 2065 7870 6972 6520 2a2f  d will expire */
│ │ │ │ +0003df50: 0a20 2020 2020 2020 7469 6d65 5f74 2061  .       time_t a
│ │ │ │ +0003df60: 6363 6f75 6e74 6578 7069 7265 3b20 2020  ccountexpire;   
│ │ │ │ +0003df70: 2020 2020 2f2a 2074 696d 6520 7768 656e      /* time when
│ │ │ │ +0003df80: 2074 6865 2061 6363 6f75 6e74 2077 696c   the account wil
│ │ │ │ +0003df90: 6c20 6578 7069 7265 2e20 2a2f 0a20 2020  l expire. */.   
│ │ │ │ +0003dfa0: 2020 7d3b 0a20 2020 2020 7479 7065 6465    };.     typede
│ │ │ │ +0003dfb0: 6620 7374 7275 6374 2053 6869 7361 5f70  f struct Shisa_p
│ │ │ │ +0003dfc0: 7269 6e63 6970 616c 2053 6869 7361 5f70  rincipal Shisa_p
│ │ │ │ +0003dfd0: 7269 6e63 6970 616c 3b0a 0a20 2020 5468  rincipal;..   Th
│ │ │ │ +0003dfe0: 6520 7365 636f 6e64 2073 7472 7563 7475  e second structu
│ │ │ │ +0003dff0: 7265 2069 7320 6361 6c6c 6564 20e2 8098  re is called ...
│ │ │ │ +0003e000: 5368 6973 615f 6b65 79e2 8099 2061 6e64  Shisa_key... and
│ │ │ │ +0003e010: 2068 6f6c 6420 696e 666f 726d 6174 696f   hold informatio
│ │ │ │ +0003e020: 6e20 6162 6f75 740a 6372 7970 746f 6772  n about.cryptogr
│ │ │ │ +0003e030: 6170 6869 6320 6b65 7973 2e20 2042 6563  aphic keys.  Bec
│ │ │ │ +0003e040: 6175 7365 2074 6865 2073 7472 7563 7420  ause the struct 
│ │ │ │ +0003e050: 636f 6e74 6169 6e20 706f 696e 7465 7273  contain pointers
│ │ │ │ +0003e060: 2c20 616e 6420 7468 6520 6361 6c6c 6572  , and the caller
│ │ │ │ +0003e070: 0a63 616e 6e6f 7420 6b6e 6f77 2068 6f77  .cannot know how
│ │ │ │ +0003e080: 206d 616e 7920 6b65 7973 2061 2070 7269   many keys a pri
│ │ │ │ +0003e090: 6e63 6970 616c 2068 6176 652c 2074 6865  ncipal have, the
│ │ │ │ +0003e0a0: 2053 6869 7361 206c 6962 7261 7279 206d   Shisa library m
│ │ │ │ +0003e0b0: 616e 6167 6573 0a6d 656d 6f72 7920 666f  anages.memory fo
│ │ │ │ +0003e0c0: 7220 7468 6520 7374 7275 6374 2e20 2054  r the struct.  T
│ │ │ │ +0003e0d0: 6865 206c 6962 7261 7279 2061 6c6c 6f63  he library alloc
│ │ │ │ +0003e0e0: 6174 6520 7468 6520 7374 7275 6374 732c  ate the structs,
│ │ │ │ +0003e0f0: 2061 6e64 2074 6865 0a70 6f69 6e74 6572   and the.pointer
│ │ │ │ +0003e100: 7320 7769 7468 696e 2074 6865 6d2e 2020  s within them.  
│ │ │ │ +0003e110: 5468 6520 6361 6c6c 6572 206d 6179 2064  The caller may d
│ │ │ │ +0003e120: 6561 6c6c 6f63 6174 6520 7468 656d 2c20  eallocate them, 
│ │ │ │ +0003e130: 6275 7420 6974 2069 730a 7265 636f 6d6d  but it is.recomm
│ │ │ │ +0003e140: 656e 6465 6420 746f 2075 7365 20e2 8098  ended to use ...
│ │ │ │ +0003e150: 7368 6973 615f 6b65 795f 6672 6565 e280  shisa_key_free..
│ │ │ │ +0003e160: 9920 6f72 20e2 8098 7368 6973 615f 6b65  . or ...shisa_ke
│ │ │ │ +0003e170: 7973 5f66 7265 65e2 8099 2069 6e73 7465  ys_free... inste
│ │ │ │ +0003e180: 6164 2e20 204e 6f74 650a 7468 6174 2065  ad.  Note.that e
│ │ │ │ +0003e190: 6163 6820 7072 696e 6369 7061 6c20 6d61  ach principal ma
│ │ │ │ +0003e1a0: 7920 6861 7665 206d 756c 7469 706c 6520  y have multiple 
│ │ │ │ +0003e1b0: 6b65 7973 2e0a 0a20 2020 2020 7374 7275  keys...     stru
│ │ │ │ +0003e1c0: 6374 2053 6869 7361 5f6b 6579 0a20 2020  ct Shisa_key.   
│ │ │ │ +0003e1d0: 2020 7b0a 2020 2020 2020 2075 696e 7433    {.       uint3
│ │ │ │ +0003e1e0: 325f 7420 6b76 6e6f 3b0a 2020 2020 2020  2_t kvno;.      
│ │ │ │ +0003e1f0: 2069 6e74 3332 5f74 2065 7479 7065 3b0a   int32_t etype;.
│ │ │ │ +0003e200: 2020 2020 2020 2069 6e74 2070 7269 6f72         int prior
│ │ │ │ +0003e210: 6974 793b 0a20 2020 2020 2020 6368 6172  ity;.       char
│ │ │ │ +0003e220: 202a 6b65 793b 0a20 2020 2020 2020 7369   *key;.       si
│ │ │ │ +0003e230: 7a65 5f74 206b 6579 6c65 6e3b 0a20 2020  ze_t keylen;.   
│ │ │ │ +0003e240: 2020 2020 6368 6172 202a 7361 6c74 3b0a      char *salt;.
│ │ │ │ +0003e250: 2020 2020 2020 2073 697a 655f 7420 7361         size_t sa
│ │ │ │ +0003e260: 6c74 6c65 6e3b 0a20 2020 2020 2020 6368  ltlen;.       ch
│ │ │ │ +0003e270: 6172 202a 7374 7232 6b65 7970 6172 616d  ar *str2keyparam
│ │ │ │ +0003e280: 3b0a 2020 2020 2020 2073 697a 655f 7420  ;.       size_t 
│ │ │ │ +0003e290: 7374 7232 6b65 7970 6172 616d 6c65 6e3b  str2keyparamlen;
│ │ │ │ +0003e2a0: 0a20 2020 2020 2020 6368 6172 202a 7061  .       char *pa
│ │ │ │ +0003e2b0: 7373 776f 7264 3b0a 2020 2020 207d 3b0a  ssword;.     };.
│ │ │ │ +0003e2c0: 2020 2020 2074 7970 6564 6566 2073 7472       typedef str
│ │ │ │ +0003e2d0: 7563 7420 5368 6973 615f 6b65 7920 5368  uct Shisa_key Sh
│ │ │ │ +0003e2e0: 6973 615f 6b65 793b 0a0a 2020 2053 6869  isa_key;..   Shi
│ │ │ │ +0003e2f0: 7361 2069 7320 7479 7069 6361 6c6c 7920  sa is typically 
│ │ │ │ +0003e300: 696e 6974 6961 6c69 7a65 6420 6279 2063  initialized by c
│ │ │ │ +0003e310: 616c 6c69 6e67 20e2 8098 7368 6973 615f  alling ...shisa_
│ │ │ │ +0003e320: 696e 6974 e280 992c 2061 6e64 0a64 6569  init..., and.dei
│ │ │ │ +0003e330: 6e69 7469 616c 697a 6564 2028 7768 656e  nitialized (when
│ │ │ │ +0003e340: 2074 6865 2061 7070 6c69 6361 7469 6f6e   the application
│ │ │ │ +0003e350: 206e 6f20 6c6f 6e67 6572 206e 6565 6420   no longer need 
│ │ │ │ +0003e360: 746f 2075 7365 2053 6869 7361 2c0a 7479  to use Shisa,.ty
│ │ │ │ +0003e370: 7069 6361 6c6c 7920 7768 656e 2069 7420  pically when it 
│ │ │ │ +0003e380: 7368 7574 7320 646f 776e 2920 6279 2063  shuts down) by c
│ │ │ │ +0003e390: 616c 6c69 6e67 20e2 8098 7368 6973 615f  alling ...shisa_
│ │ │ │ +0003e3a0: 646f 6e65 e280 992c 2062 7574 2068 6572  done..., but her
│ │ │ │ +0003e3b0: 6520 6172 6520 7468 650a 636f 6d70 6c65  e are the.comple
│ │ │ │ +0003e3c0: 7465 2028 6465 2969 6e69 7469 616c 697a  te (de)initializ
│ │ │ │ +0003e3d0: 6174 696f 6e20 696e 7465 7266 6163 6520  ation interface 
│ │ │ │ +0003e3e0: 6675 6e63 7469 6f6e 732e 0a0a 7368 6973  functions...shis
│ │ │ │ +0003e3f0: 610a 2d2d 2d2d 2d0a 0a20 2d2d 2046 756e  a.-----.. -- Fun
│ │ │ │ +0003e400: 6374 696f 6e3a 2053 6869 7361 202a 2073  ction: Shisa * s
│ │ │ │ +0003e410: 6869 7361 2028 290a 0a20 2020 2020 2a44  hisa ()..     *D
│ │ │ │ +0003e420: 6573 6372 6970 7469 6f6e 3a2a 2049 6e69  escription:* Ini
│ │ │ │ +0003e430: 7469 616c 697a 6573 2074 6865 2053 6869  tializes the Shi
│ │ │ │ +0003e440: 7361 206c 6962 7261 7279 2e20 2049 6620  sa library.  If 
│ │ │ │ +0003e450: 7468 6973 2066 756e 6374 696f 6e0a 2020  this function.  
│ │ │ │ +0003e460: 2020 2066 6169 6c73 2c20 6974 206d 6179     fails, it may
│ │ │ │ +0003e470: 2070 7269 6e74 2064 6961 676e 6f73 7469   print diagnosti
│ │ │ │ +0003e480: 6320 6572 726f 7273 2074 6f20 7374 616e  c errors to stan
│ │ │ │ +0003e490: 6461 7264 2065 7272 6f72 2e0a 0a20 2020  dard error...   
│ │ │ │ +0003e4a0: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ +0003e4b0: 2a20 5265 7475 726e 7320 6120 5368 6973  * Returns a Shis
│ │ │ │ +0003e4c0: 6120 6c69 6272 6172 7920 6861 6e64 6c65  a library handle
│ │ │ │ +0003e4d0: 2c20 6f72 20e2 8098 4e55 4c4c e280 9920  , or ...NULL... 
│ │ │ │ +0003e4e0: 6f6e 2065 7272 6f72 2e0a 0a73 6869 7361  on error...shisa
│ │ │ │ +0003e4f0: 5f64 6f6e 650a 2d2d 2d2d 2d2d 2d2d 2d2d  _done.----------
│ │ │ │ +0003e500: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ +0003e510: 766f 6964 2073 6869 7361 5f64 6f6e 6520  void shisa_done 
│ │ │ │ +0003e520: 2853 6869 7361 202a 2044 4248 290a 2020  (Shisa * DBH).  
│ │ │ │ +0003e530: 2020 2044 4248 3a20 5368 6973 6120 6861     DBH: Shisa ha
│ │ │ │ +0003e540: 6e64 6c65 2061 7320 616c 6c6f 6361 7465  ndle as allocate
│ │ │ │ +0003e550: 6420 6279 20e2 8098 7368 6973 6128 29e2  d by ...shisa().
│ │ │ │ +0003e560: 8099 2e0a 0a20 2020 2020 2a44 6573 6372  .....     *Descr
│ │ │ │ +0003e570: 6970 7469 6f6e 3a2a 2044 6561 6c6c 6f63  iption:* Dealloc
│ │ │ │ +0003e580: 6174 6573 2074 6865 2073 6869 7361 206c  ates the shisa l
│ │ │ │ +0003e590: 6962 7261 7279 2068 616e 646c 652e 2020  ibrary handle.  
│ │ │ │ +0003e5a0: 5468 6520 6861 6e64 6c65 0a20 2020 2020  The handle.     
│ │ │ │ +0003e5b0: 6d75 7374 206e 6f74 2062 6520 7573 6564  must not be used
│ │ │ │ +0003e5c0: 2069 6e20 6361 6c6c 7320 746f 2061 6e79   in calls to any
│ │ │ │ +0003e5d0: 2073 6869 7361 2066 756e 6374 696f 6e20   shisa function 
│ │ │ │ +0003e5e0: 6166 7465 7220 7468 650a 2020 2020 2063  after the.     c
│ │ │ │ +0003e5f0: 6f6d 706c 6574 696f 6e20 6f66 2074 6869  ompletion of thi
│ │ │ │ +0003e600: 7320 6361 6c6c 2e0a 0a73 6869 7361 5f69  s call...shisa_i
│ │ │ │ +0003e610: 6e69 740a 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  nit.----------..
│ │ │ │ +0003e620: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ +0003e630: 7420 7368 6973 615f 696e 6974 2028 5368  t shisa_init (Sh
│ │ │ │ +0003e640: 6973 6120 2a2a 2044 4248 290a 2020 2020  isa ** DBH).    
│ │ │ │ +0003e650: 2044 4248 3a20 5265 7475 726e 6564 2070   DBH: Returned p
│ │ │ │ +0003e660: 6f69 6e74 6572 2074 6f20 6120 6372 6561  ointer to a crea
│ │ │ │ +0003e670: 7465 6420 5368 6973 6120 6c69 6272 6172  ted Shisa librar
│ │ │ │ +0003e680: 7920 6861 6e64 6c65 2e0a 0a20 2020 2020  y handle...     
│ │ │ │ +0003e690: 2a44 6573 6372 6970 7469 6f6e 3a2a 2043  *Description:* C
│ │ │ │ +0003e6a0: 7265 6174 6573 2061 2053 6869 7361 206c  reates a Shisa l
│ │ │ │ +0003e6b0: 6962 7261 7279 2068 616e 646c 652c 2075  ibrary handle, u
│ │ │ │ +0003e6c0: 7369 6e67 20e2 8098 7368 6973 6128 29e2  sing ...shisa().
│ │ │ │ +0003e6d0: 8099 2c0a 2020 2020 2072 6561 6469 6e67  ..,.     reading
│ │ │ │ +0003e6e0: 2074 6865 2073 7973 7465 6d20 636f 6e66   the system conf
│ │ │ │ +0003e6f0: 6967 7572 6174 696f 6e20 6669 6c65 2066  iguration file f
│ │ │ │ +0003e700: 726f 6d20 6974 7320 6465 6661 756c 7420  rom its default 
│ │ │ │ +0003e710: 6c6f 6361 7469 6f6e 2e0a 2020 2020 2054  location..     T
│ │ │ │ +0003e720: 6865 2070 6174 6820 746f 2074 6865 2064  he path to the d
│ │ │ │ +0003e730: 6566 6175 6c74 2073 7973 7465 6d20 636f  efault system co
│ │ │ │ +0003e740: 6e66 6967 7572 6174 696f 6e20 6669 6c65  nfiguration file
│ │ │ │ +0003e750: 2069 7320 6465 6369 6465 6420 6174 0a20   is decided at. 
│ │ │ │ +0003e760: 2020 2020 636f 6d70 696c 6520 7469 6d65      compile time
│ │ │ │ +0003e770: 2028 e280 9873 7973 636f 6e66 6469 72e2   (...sysconfdir.
│ │ │ │ +0003e780: 8099 2f73 6869 7361 2e63 6f6e 6629 2e0a  ../shisa.conf)..
│ │ │ │ +0003e790: 0a20 2020 2020 5468 6520 6861 6e64 6c65  .     The handle
│ │ │ │ +0003e7a0: 2069 7320 616c 6c6f 6361 7465 6420 7265   is allocated re
│ │ │ │ +0003e7b0: 6761 7264 6c65 7373 206f 6620 7265 7475  gardless of retu
│ │ │ │ +0003e7c0: 726e 2076 616c 7565 2c20 7468 6520 6f6e  rn value, the on
│ │ │ │ +0003e7d0: 6c79 0a20 2020 2020 6578 6365 7074 696f  ly.     exceptio
│ │ │ │ +0003e7e0: 6e20 6265 696e 6720 e280 9853 4849 5341  n being ...SHISA
│ │ │ │ +0003e7f0: 5f49 4e49 545f 4552 524f 52e2 8099 2c20  _INIT_ERROR..., 
│ │ │ │ +0003e800: 7768 6963 6820 696e 6469 6361 7465 7320  which indicates 
│ │ │ │ +0003e810: 6120 7072 6f62 6c65 6d20 696e 0a20 2020  a problem in.   
│ │ │ │ +0003e820: 2020 616c 6c6f 6361 7469 6e67 2074 6865    allocating the
│ │ │ │ +0003e830: 2068 616e 646c 652e 2020 4f74 6865 7220   handle.  Other 
│ │ │ │ +0003e840: 6572 726f 7220 636f 6e64 6974 696f 6e73  error conditions
│ │ │ │ +0003e850: 2061 7269 7365 2077 6869 6c65 2072 6561   arise while rea
│ │ │ │ +0003e860: 6469 6e67 0a20 2020 2020 6120 6669 6c65  ding.     a file
│ │ │ │ +0003e870: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ +0003e880: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ +0003e890: e280 9853 4849 5341 5f4f 4be2 8099 2c20  ...SHISA_OK..., 
│ │ │ │ +0003e8a0: 6f72 2061 6e20 6572 726f 7220 636f 6465  or an error code
│ │ │ │ +0003e8b0: 2e20 2054 6865 2076 616c 7565 0a20 2020  .  The value.   
│ │ │ │ +0003e8c0: 2020 e280 9853 4849 5341 5f49 4e49 545f    ...SHISA_INIT_
│ │ │ │ +0003e8d0: 4552 524f 52e2 8099 2069 6e64 6963 6174  ERROR... indicat
│ │ │ │ +0003e8e0: 6573 2061 2066 6169 6c75 7265 2074 6f20  es a failure to 
│ │ │ │ +0003e8f0: 6372 6561 7465 2074 6865 2068 616e 646c  create the handl
│ │ │ │ +0003e900: 652e 0a0a 7368 6973 615f 696e 6974 5f77  e...shisa_init_w
│ │ │ │ +0003e910: 6974 685f 7061 7468 730a 2d2d 2d2d 2d2d  ith_paths.------
│ │ │ │ +0003e920: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ +0003e930: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ +0003e940: 6e74 2073 6869 7361 5f69 6e69 745f 7769  nt shisa_init_wi
│ │ │ │ +0003e950: 7468 5f70 6174 6873 2028 5368 6973 6120  th_paths (Shisa 
│ │ │ │ +0003e960: 2a2a 2044 4248 2c0a 2020 2020 2020 2020  ** DBH,.        
│ │ │ │ +0003e970: 2020 636f 6e73 7420 6368 6172 202a 2046    const char * F
│ │ │ │ +0003e980: 494c 4529 0a20 2020 2020 4442 483a 2052  ILE).     DBH: R
│ │ │ │ +0003e990: 6574 7572 6e65 6420 706f 696e 7465 7220  eturned pointer 
│ │ │ │ +0003e9a0: 746f 2061 2063 7265 6174 6564 2053 6869  to a created Shi
│ │ │ │ +0003e9b0: 7361 206c 6962 7261 7279 2068 616e 646c  sa library handl
│ │ │ │ +0003e9c0: 652e 0a20 2020 2020 4649 4c45 3a20 4669  e..     FILE: Fi
│ │ │ │ +0003e9d0: 6c65 6e61 6d65 206f 6620 7379 7374 656d  lename of system
│ │ │ │ +0003e9e0: 2063 6f6e 6669 6775 7261 7469 6f6e 2c20   configuration, 
│ │ │ │ +0003e9f0: 6f72 20e2 8098 4e55 4c4c e280 992e 0a0a  or ...NULL......
│ │ │ │ +0003ea00: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ +0003ea10: 6e3a 2a20 4372 6561 7465 7320 6120 5368  n:* Creates a Sh
│ │ │ │ +0003ea20: 6973 6120 6c69 6272 6172 7920 6861 6e64  isa library hand
│ │ │ │ +0003ea30: 6c65 2c20 7573 696e 6720 e280 9873 6869  le, using ...shi
│ │ │ │ +0003ea40: 7361 2829 e280 992c 2062 7574 0a20 2020  sa()..., but.   
│ │ │ │ +0003ea50: 2020 7265 6164 696e 6720 7468 6520 7379    reading the sy
│ │ │ │ +0003ea60: 7374 656d 2063 6f6e 6669 6775 7261 7469  stem configurati
│ │ │ │ +0003ea70: 6f6e 2066 696c 6520 6174 2074 6865 206c  on file at the l
│ │ │ │ +0003ea80: 6f63 6174 696f 6e20 4649 4c45 2c20 6f72  ocation FILE, or
│ │ │ │ +0003ea90: 2061 740a 2020 2020 2074 6865 2064 6566   at.     the def
│ │ │ │ +0003eaa0: 6175 6c74 206c 6f63 6174 696f 6e2c 2073  ault location, s
│ │ │ │ +0003eab0: 686f 756c 6420 4649 4c45 2062 6520 e280  hould FILE be ..
│ │ │ │ +0003eac0: 984e 554c 4ce2 8099 2e20 2054 6865 2070  .NULL....  The p
│ │ │ │ +0003ead0: 6174 6820 746f 2074 6865 0a20 2020 2020  ath to the.     
│ │ │ │ +0003eae0: 6465 6661 756c 7420 7379 7374 656d 2063  default system c
│ │ │ │ +0003eaf0: 6f6e 6669 6775 7261 7469 6f6e 2066 696c  onfiguration fil
│ │ │ │ +0003eb00: 6520 6973 2064 6563 6964 6564 2061 7420  e is decided at 
│ │ │ │ +0003eb10: 636f 6d70 696c 6520 7469 6d65 0a20 2020  compile time.   
│ │ │ │ +0003eb20: 2020 28e2 8098 7379 7363 6f6e 6664 6972    (...sysconfdir
│ │ │ │ +0003eb30: e280 992f 7368 6973 612e 636f 6e66 292e  .../shisa.conf).
│ │ │ │ +0003eb40: 0a0a 2020 2020 2054 6865 2068 616e 646c  ..     The handl
│ │ │ │ +0003eb50: 6520 6973 2061 6c6c 6f63 6174 6564 2072  e is allocated r
│ │ │ │ +0003eb60: 6567 6172 646c 6573 7320 6f66 2072 6574  egardless of ret
│ │ │ │ +0003eb70: 7572 6e20 7661 6c75 652c 2074 6865 206f  urn value, the o
│ │ │ │ +0003eb80: 6e6c 790a 2020 2020 2065 7863 6570 7469  nly.     excepti
│ │ │ │ +0003eb90: 6f6e 2062 6569 6e67 20e2 8098 5348 4953  on being ...SHIS
│ │ │ │ +0003eba0: 415f 494e 4954 5f45 5252 4f52 e280 992c  A_INIT_ERROR...,
│ │ │ │ +0003ebb0: 2077 6869 6368 2069 6e64 6963 6174 6573   which indicates
│ │ │ │ +0003ebc0: 2061 2070 726f 626c 656d 2069 6e0a 2020   a problem in.  
│ │ │ │ +0003ebd0: 2020 2061 6c6c 6f63 6174 696e 6720 7468     allocating th
│ │ │ │ +0003ebe0: 6520 6861 6e64 6c65 2e20 204f 7468 6572  e handle.  Other
│ │ │ │ +0003ebf0: 2065 7272 6f72 2063 6f6e 6469 7469 6f6e   error condition
│ │ │ │ +0003ec00: 7320 6172 6973 6520 7768 696c 6520 7265  s arise while re
│ │ │ │ +0003ec10: 6164 696e 670a 2020 2020 2061 2066 696c  ading.     a fil
│ │ │ │ +0003ec20: 652e 0a0a 2020 2020 202a 5265 7475 726e  e...     *Return
│ │ │ │ +0003ec30: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ +0003ec40: 20e2 8098 5348 4953 415f 4f4b e280 992c   ...SHISA_OK...,
│ │ │ │ +0003ec50: 206f 7220 616e 2065 7272 6f72 2063 6f64   or an error cod
│ │ │ │ +0003ec60: 652e 2020 5468 6520 7661 6c75 650a 2020  e.  The value.  
│ │ │ │ +0003ec70: 2020 20e2 8098 5348 4953 415f 494e 4954     ...SHISA_INIT
│ │ │ │ +0003ec80: 5f45 5252 4f52 e280 9920 696e 6469 6361  _ERROR... indica
│ │ │ │ +0003ec90: 7465 7320 6120 6661 696c 7572 6520 746f  tes a failure to
│ │ │ │ +0003eca0: 2063 7265 6174 6520 7468 6520 6861 6e64   create the hand
│ │ │ │ +0003ecb0: 6c65 2e0a 0a20 2020 5468 6520 6465 6661  le...   The defa
│ │ │ │ +0003ecc0: 756c 7420 636f 6e66 6967 7572 6174 696f  ult configuratio
│ │ │ │ +0003ecd0: 6e20 6669 6c65 2069 7320 7479 7069 6361  n file is typica
│ │ │ │ +0003ece0: 6c6c 7920 7265 6164 2061 7574 6f6d 6174  lly read automat
│ │ │ │ +0003ecf0: 6963 616c 6c79 2062 790a 6361 6c6c 696e  ically by.callin
│ │ │ │ +0003ed00: 6720 e280 9873 6869 7361 5f69 6e69 74e2  g ...shisa_init.
│ │ │ │ +0003ed10: 8099 2c20 6275 7420 6966 2079 6f75 2077  .., but if you w
│ │ │ │ +0003ed20: 6973 6820 746f 206d 616e 7561 6c6c 7920  ish to manually 
│ │ │ │ +0003ed30: 6163 6365 7373 2074 6865 2053 6869 7361  access the Shisa
│ │ │ │ +0003ed40: 0a63 6f6e 6669 6775 7261 7469 6f6e 2066  .configuration f
│ │ │ │ +0003ed50: 696c 6520 6675 6e63 7469 6f6e 732c 2068  ile functions, h
│ │ │ │ +0003ed60: 6572 6520 6973 2074 6865 2063 6f6d 706c  ere is the compl
│ │ │ │ +0003ed70: 6574 6520 696e 7465 7266 6163 652e 0a0a  ete interface...
│ │ │ │ +0003ed80: 7368 6973 615f 6366 675f 6462 0a2d 2d2d  shisa_cfg_db.---
│ │ │ │ +0003ed90: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +0003eda0: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ +0003edb0: 7361 5f63 6667 5f64 6220 2853 6869 7361  sa_cfg_db (Shisa
│ │ │ │ +0003edc0: 202a 2044 4248 2c20 636f 6e73 7420 6368   * DBH, const ch
│ │ │ │ +0003edd0: 6172 202a 2056 414c 5545 290a 2020 2020  ar * VALUE).    
│ │ │ │ +0003ede0: 2044 4248 3a20 5368 6973 6120 6c69 6272   DBH: Shisa libr
│ │ │ │ +0003edf0: 6172 7920 6861 6e64 6c65 2063 7265 6174  ary handle creat
│ │ │ │ +0003ee00: 6564 2062 7920 e280 9873 6869 7361 2829  ed by ...shisa()
│ │ │ │ +0003ee10: e280 992e 0a20 2020 2020 5641 4c55 453a  .....     VALUE:
│ │ │ │ +0003ee20: 2053 7472 696e 6720 636f 6e74 6169 6e69   String containi
│ │ │ │ +0003ee30: 6e67 2064 6174 6162 6173 6520 6465 6669  ng database defi
│ │ │ │ +0003ee40: 6e69 7469 6f6e 2e0a 0a20 2020 2020 2a44  nition...     *D
│ │ │ │ +0003ee50: 6573 6372 6970 7469 6f6e 3a2a 2053 6574  escription:* Set
│ │ │ │ +0003ee60: 7320 7570 2061 6e64 206f 7065 6e73 2061  s up and opens a
│ │ │ │ +0003ee70: 206e 6577 2064 6174 6162 6173 652e 2020   new database.  
│ │ │ │ +0003ee80: 5468 6520 7379 6e74 6178 206f 6620 7468  The syntax of th
│ │ │ │ +0003ee90: 650a 2020 2020 2070 6172 616d 6574 6572  e.     parameter
│ │ │ │ +0003eea0: 2056 414c 5545 2069 7320 2254 5950 455b   VALUE is "TYPE[
│ │ │ │ +0003eeb0: 204c 4f43 4154 494f 4e5b 2050 4152 414d   LOCATION[ PARAM
│ │ │ │ +0003eec0: 4554 4552 5d5d 222c 2077 6865 7265 2054  ETER]]", where T
│ │ │ │ +0003eed0: 5950 4520 6973 206f 6e65 0a20 2020 2020  YPE is one.     
│ │ │ │ +0003eee0: 6f66 2074 6865 2073 7570 706f 7274 6564  of the supported
│ │ │ │ +0003eef0: 2064 6174 6162 6173 6520 7479 7065 732c   database types,
│ │ │ │ +0003ef00: 2074 7970 6963 616c 6c79 2022 6669 6c65   typically "file
│ │ │ │ +0003ef10: 222e 0a0a 2020 2020 2054 6865 2061 626f  "...     The abo
│ │ │ │ +0003ef20: 7665 2073 7562 7374 7269 6e67 7320 4c4f  ve substrings LO
│ │ │ │ +0003ef30: 4341 5449 4f4e 2061 6e64 2050 4152 414d  CATION and PARAM
│ │ │ │ +0003ef40: 4554 4552 2061 7265 206f 7074 696f 6e61  ETER are optiona
│ │ │ │ +0003ef50: 6c20 7374 7269 6e67 730a 2020 2020 2070  l strings.     p
│ │ │ │ +0003ef60: 6173 7365 6420 6f6e 2076 6572 6261 7469  assed on verbati
│ │ │ │ +0003ef70: 6d20 746f 2074 6865 2064 6174 6162 6173  m to the databas
│ │ │ │ +0003ef80: 6520 6475 7269 6e67 2069 6e69 7469 616c  e during initial
│ │ │ │ +0003ef90: 697a 6174 696f 6e2e 2020 4e65 6974 6865  ization.  Neithe
│ │ │ │ +0003efa0: 720a 2020 2020 2054 5950 4520 6e6f 7220  r.     TYPE nor 
│ │ │ │ +0003efb0: 4c4f 4341 5449 4f4e 206d 6179 2063 6f6e  LOCATION may con
│ │ │ │ +0003efc0: 7461 696e 2065 6d62 6564 6465 6420 7370  tain embedded sp
│ │ │ │ +0003efd0: 6163 6573 2c20 6275 7420 5041 5241 4d45  aces, but PARAME
│ │ │ │ +0003efe0: 5445 5220 6d61 7920 646f 0a20 2020 2020  TER may do.     
│ │ │ │ +0003eff0: 736f 2e0a 0a20 2020 2020 2a52 6574 7572  so...     *Retur
│ │ │ │ +0003f000: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ +0003f010: 7320 e280 9853 4849 5341 5f4f 4be2 8099  s ...SHISA_OK...
│ │ │ │ +0003f020: 2069 6620 6120 6461 7461 6261 7365 2077   if a database w
│ │ │ │ +0003f030: 6173 2070 6172 7365 6420 616e 640a 2020  as parsed and.  
│ │ │ │ +0003f040: 2020 206f 7065 6e65 6420 7375 6363 6573     opened succes
│ │ │ │ +0003f050: 7366 756c 6c79 2e0a 0a73 6869 7361 5f63  sfully...shisa_c
│ │ │ │ +0003f060: 6667 0a2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  fg.---------.. -
│ │ │ │ +0003f070: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ +0003f080: 7368 6973 615f 6366 6720 2853 6869 7361  shisa_cfg (Shisa
│ │ │ │ +0003f090: 202a 2044 4248 2c20 636f 6e73 7420 6368   * DBH, const ch
│ │ │ │ +0003f0a0: 6172 202a 204f 5054 494f 4e29 0a20 2020  ar * OPTION).   
│ │ │ │ +0003f0b0: 2020 4442 483a 2053 6869 7361 206c 6962    DBH: Shisa lib
│ │ │ │ +0003f0c0: 7261 7279 2068 616e 646c 6520 6372 6561  rary handle crea
│ │ │ │ +0003f0d0: 7465 6420 6279 20e2 8098 7368 6973 6128  ted by ...shisa(
│ │ │ │ +0003f0e0: 29e2 8099 2e0a 2020 2020 204f 5054 494f  ).....     OPTIO
│ │ │ │ +0003f0f0: 4e3a 2053 7472 696e 6720 7769 7468 206f  N: String with o
│ │ │ │ +0003f100: 7074 696f 6e73 2074 6f20 7072 696d 6520  ptions to prime 
│ │ │ │ +0003f110: 7468 6520 5368 6973 6120 6c69 6272 6172  the Shisa librar
│ │ │ │ +0003f120: 792e 0a0a 2020 2020 202a 4465 7363 7269  y...     *Descri
│ │ │ │ +0003f130: 7074 696f 6e3a 2a20 436f 6e66 6967 7572  ption:* Configur
│ │ │ │ +0003f140: 6573 2074 6865 2053 6869 7361 206c 6962  es the Shisa lib
│ │ │ │ +0003f150: 7261 7279 2066 726f 6d20 7468 6520 7370  rary from the sp
│ │ │ │ +0003f160: 6563 6966 6963 6174 696f 6e0a 2020 2020  ecification.    
│ │ │ │ +0003f170: 204f 5054 494f 4e2e 2020 5468 6973 2063   OPTION.  This c
│ │ │ │ +0003f180: 616c 6c20 6578 7065 6374 7320 6120 7374  all expects a st
│ │ │ │ +0003f190: 7269 6e67 2064 6563 6c61 7261 7469 6f6e  ring declaration
│ │ │ │ +0003f1a0: 206f 6620 7468 6520 666f 726d 0a20 2020   of the form.   
│ │ │ │ +0003f1b0: 2020 2264 623d 5641 4c55 4522 2c20 6f72    "db=VALUE", or
│ │ │ │ +0003f1c0: 2022 6462 2056 414c 5545 222e 2048 6572   "db VALUE". Her
│ │ │ │ +0003f1d0: 6520 5641 4c55 4520 6973 2074 6865 2073  e VALUE is the s
│ │ │ │ +0003f1e0: 616d 6520 6465 636c 6172 6174 696f 6e20  ame declaration 
│ │ │ │ +0003f1f0: 6173 0a20 2020 2020 7573 6564 2062 7920  as.     used by 
│ │ │ │ +0003f200: e280 9873 6869 7361 5f63 6667 5f64 6228  ...shisa_cfg_db(
│ │ │ │ +0003f210: 29e2 8099 2c20 692e 652e 2c20 6f66 2074  )..., i.e., of t
│ │ │ │ +0003f220: 6865 2066 6f72 6d20 2254 5950 455b 204c  he form "TYPE[ L
│ │ │ │ +0003f230: 4f43 4154 494f 4e5b 0a20 2020 2020 5041  OCATION[.     PA
│ │ │ │ +0003f240: 5241 4d45 5445 525d 5d22 2e0a 0a20 2020  RAMETER]]"...   
│ │ │ │ +0003f250: 2020 5468 6520 7072 6566 6978 2022 6462    The prefix "db
│ │ │ │ +0003f260: 222c 206d 616e 6461 746f 7279 2069 6e20  ", mandatory in 
│ │ │ │ +0003f270: 4f50 5449 4f4e 2c20 6d61 6b65 7320 e280  OPTION, makes ..
│ │ │ │ +0003f280: 9873 6869 7361 5f63 6667 2829 e280 9920  .shisa_cfg()... 
│ │ │ │ +0003f290: 7375 6974 6564 2074 6f0a 2020 2020 2061  suited to.     a
│ │ │ │ +0003f2a0: 2073 796e 7461 7820 7769 7468 206b 6579   syntax with key
│ │ │ │ +0003f2b0: 2d76 616c 7565 2070 6169 7273 2061 6c73  -value pairs als
│ │ │ │ +0003f2c0: 6f20 696e 2050 4152 414d 4554 4552 2e0a  o in PARAMETER..
│ │ │ │ +0003f2d0: 0a20 2020 2020 2a52 6574 7572 6e20 7661  .     *Return va
│ │ │ │ +0003f2e0: 6c75 653a 2a20 5265 7475 726e 7320 e280  lue:* Returns ..
│ │ │ │ +0003f2f0: 9853 4849 5341 5f4f 4be2 8099 2069 6620  .SHISA_OK... if 
│ │ │ │ +0003f300: 4f50 5449 4f4e 2069 7320 7661 6c69 642e  OPTION is valid.
│ │ │ │ +0003f310: 0a0a 7368 6973 615f 6366 675f 6672 6f6d  ..shisa_cfg_from
│ │ │ │ +0003f320: 5f66 696c 650a 2d2d 2d2d 2d2d 2d2d 2d2d  _file.----------
│ │ │ │ +0003f330: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +0003f340: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ +0003f350: 7361 5f63 6667 5f66 726f 6d5f 6669 6c65  sa_cfg_from_file
│ │ │ │ +0003f360: 2028 5368 6973 6120 2a20 4442 482c 2063   (Shisa * DBH, c
│ │ │ │ +0003f370: 6f6e 7374 2063 6861 7220 2a20 4346 4729  onst char * CFG)
│ │ │ │ +0003f380: 0a20 2020 2020 4442 483a 2053 6869 7361  .     DBH: Shisa
│ │ │ │ +0003f390: 206c 6962 7261 7279 2068 616e 646c 6520   library handle 
│ │ │ │ +0003f3a0: 6372 6561 7465 6420 6279 20e2 8098 7368  created by ...sh
│ │ │ │ +0003f3b0: 6973 6128 29e2 8099 2e0a 2020 2020 2043  isa().....     C
│ │ │ │ +0003f3c0: 4647 3a20 4669 6c65 206e 616d 6520 7768  FG: File name wh
│ │ │ │ +0003f3d0: 6572 6520 746f 2072 6561 6420 636f 6e66  ere to read conf
│ │ │ │ +0003f3e0: 6967 7572 6174 696f 6e2e 0a0a 2020 2020  iguration...    
│ │ │ │ +0003f3f0: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ +0003f400: 436f 6e66 6967 7572 6573 2074 6865 2053  Configures the S
│ │ │ │ +0003f410: 6869 7361 206c 6962 7261 7279 2075 7369  hisa library usi
│ │ │ │ +0003f420: 6e67 2061 2063 6f6e 6669 6775 7261 7469  ng a configurati
│ │ │ │ +0003f430: 6f6e 0a20 2020 2020 6669 6c65 206c 6f63  on.     file loc
│ │ │ │ +0003f440: 6174 6564 2061 7420 4346 472e 0a0a 2020  ated at CFG...  
│ │ │ │ +0003f450: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ +0003f460: 3a2a 2052 6574 7572 6e73 20e2 8098 5348  :* Returns ...SH
│ │ │ │ +0003f470: 4953 415f 4f4b e280 9920 6966 2073 7563  ISA_OK... if suc
│ │ │ │ +0003f480: 6365 7373 6675 6c2e 2020 5479 7069 6361  cessful.  Typica
│ │ │ │ +0003f490: 6c6c 790a 2020 2020 2072 6574 7572 6e73  lly.     returns
│ │ │ │ +0003f4a0: 20e2 8098 5348 4953 415f 4346 475f 4e4f   ...SHISA_CFG_NO
│ │ │ │ +0003f4b0: 5f46 494c 45e2 8099 2069 6e20 7265 7370  _FILE... in resp
│ │ │ │ +0003f4c0: 6f6e 7365 2074 6f20 6120 6d69 736e 616d  onse to a misnam
│ │ │ │ +0003f4d0: 6564 2066 696c 652e 0a0a 7368 6973 615f  ed file...shisa_
│ │ │ │ +0003f4e0: 6366 675f 6465 6661 756c 745f 7379 7374  cfg_default_syst
│ │ │ │ +0003f4f0: 656d 6669 6c65 0a2d 2d2d 2d2d 2d2d 2d2d  emfile.---------
│ │ │ │  0003f500: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0003f510: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ -0003f520: 3a20 636f 6e73 7420 6368 6172 202a 2073  : const char * s
│ │ │ │ -0003f530: 6869 7361 5f63 6667 5f64 6566 6175 6c74  hisa_cfg_default
│ │ │ │ -0003f540: 5f73 7973 7465 6d66 696c 6520 2853 6869  _systemfile (Shi
│ │ │ │ -0003f550: 7361 202a 2044 4248 290a 2020 2020 2044  sa * DBH).     D
│ │ │ │ -0003f560: 4248 3a20 5368 6973 6120 6c69 6272 6172  BH: Shisa librar
│ │ │ │ -0003f570: 7920 6861 6e64 6c65 2063 7265 6174 6564  y handle created
│ │ │ │ -0003f580: 2062 7920 e280 9873 6869 7361 2829 e280   by ...shisa()..
│ │ │ │ -0003f590: 992e 0a0a 2020 2020 202a 4465 7363 7269  ....     *Descri
│ │ │ │ -0003f5a0: 7074 696f 6e3a 2a20 4665 7463 6865 7320  ption:* Fetches 
│ │ │ │ -0003f5b0: 696e 666f 726d 6174 696f 6e20 6f6e 2074  information on t
│ │ │ │ -0003f5c0: 6865 2069 6e73 7461 6c6c 6564 2063 6f6e  he installed con
│ │ │ │ -0003f5d0: 6669 6775 7261 7469 6f6e 2e0a 0a20 2020  figuration...   
│ │ │ │ -0003f5e0: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ -0003f5f0: 2a20 5265 7475 726e 7320 6669 6c65 206e  * Returns file n
│ │ │ │ -0003f600: 616d 6520 6f66 2074 6865 2061 6374 6976  ame of the activ
│ │ │ │ -0003f610: 6520 7379 7374 656d 0a20 2020 2020 636f  e system.     co
│ │ │ │ -0003f620: 6e66 6967 7572 6174 696f 6e2e 0a0a 2020  nfiguration...  
│ │ │ │ -0003f630: 2054 6865 2063 6f72 6520 7061 7274 206f   The core part o
│ │ │ │ -0003f640: 6620 7468 6520 5368 6973 6120 696e 7465  f the Shisa inte
│ │ │ │ -0003f650: 7266 6163 6520 666f 6c6c 6f77 732e 2020  rface follows.  
│ │ │ │ -0003f660: 5468 6520 7479 7069 6361 6c20 7072 6f63  The typical proc
│ │ │ │ -0003f670: 6564 7572 650a 6973 2074 6f20 7573 6520  edure.is to use 
│ │ │ │ -0003f680: e280 9873 6869 7361 5f70 7269 6e63 6970  ...shisa_princip
│ │ │ │ -0003f690: 616c 5f66 696e 64e2 8099 2074 6f20 7665  al_find... to ve
│ │ │ │ -0003f6a0: 7269 6679 2074 6861 7420 6120 7370 6563  rify that a spec
│ │ │ │ -0003f6b0: 6966 6963 2070 7269 6e63 6970 616c 0a65  ific principal.e
│ │ │ │ -0003f6c0: 7869 7374 732c 2061 6e64 2074 6f20 6578  xists, and to ex
│ │ │ │ -0003f6d0: 7472 6163 7420 736f 6d65 2069 6e66 6f72  tract some infor
│ │ │ │ -0003f6e0: 6d61 7469 6f6e 2061 626f 7574 2069 742c  mation about it,
│ │ │ │ -0003f6f0: 2061 6e64 2074 6865 6e20 7573 650a e280   and then use...
│ │ │ │ -0003f700: 9873 6869 7361 5f6b 6579 735f 6669 6e64  .shisa_keys_find
│ │ │ │ -0003f710: e280 9920 746f 2067 6574 2074 6865 2063  ... to get the c
│ │ │ │ -0003f720: 7279 7074 6f67 7261 7068 6963 206b 6579  ryptographic key
│ │ │ │ -0003f730: 7320 666f 7220 7468 6520 7072 696e 6369  s for the princi
│ │ │ │ -0003f740: 7061 6c2c 0a75 7375 616c 6c79 2073 7570  pal,.usually sup
│ │ │ │ -0003f750: 706c 6979 696e 6720 736f 6d65 2068 696e  pliying some hin
│ │ │ │ -0003f760: 7473 2061 7320 746f 2077 6869 6368 206f  ts as to which o
│ │ │ │ -0003f770: 6620 616c 6c20 6b65 7973 2079 6f75 2061  f all keys you a
│ │ │ │ -0003f780: 7265 2069 6e74 6572 6573 7465 640a 696e  re interested.in
│ │ │ │ -0003f790: 2028 652e 672e 2c20 6b65 7920 7665 7273   (e.g., key vers
│ │ │ │ -0003f7a0: 696f 6e20 6e75 6d62 6572 2061 6e64 2065  ion number and e
│ │ │ │ -0003f7b0: 6e63 7279 7074 696f 6e20 616c 676f 7269  ncryption algori
│ │ │ │ -0003f7c0: 7468 6d20 6e75 6d62 6572 292e 0a0a 7368  thm number)...sh
│ │ │ │ -0003f7d0: 6973 615f 656e 756d 6572 6174 655f 7265  isa_enumerate_re
│ │ │ │ -0003f7e0: 616c 6d73 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  alms.-----------
│ │ │ │ -0003f7f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ -0003f800: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ -0003f810: 6869 7361 5f65 6e75 6d65 7261 7465 5f72  hisa_enumerate_r
│ │ │ │ -0003f820: 6561 6c6d 7320 2853 6869 7361 202a 2044  ealms (Shisa * D
│ │ │ │ -0003f830: 4248 2c20 6368 6172 202a 2a2a 2052 4541  BH, char *** REA
│ │ │ │ -0003f840: 4c4d 532c 0a20 2020 2020 2020 2020 2073  LMS,.          s
│ │ │ │ -0003f850: 697a 655f 7420 2a20 4e52 4541 4c4d 5329  ize_t * NREALMS)
│ │ │ │ -0003f860: 0a20 2020 2020 4442 483a 2053 6869 7361  .     DBH: Shisa
│ │ │ │ -0003f870: 206c 6962 7261 7279 2068 616e 646c 6520   library handle 
│ │ │ │ -0003f880: 6372 6561 7465 6420 6279 20e2 8098 7368  created by ...sh
│ │ │ │ -0003f890: 6973 6128 29e2 8099 2e0a 2020 2020 2052  isa().....     R
│ │ │ │ -0003f8a0: 4541 4c4d 533a 2052 6574 7572 6e65 6420  EALMS: Returned 
│ │ │ │ -0003f8b0: 706f 696e 7465 7220 746f 2061 206e 6577  pointer to a new
│ │ │ │ -0003f8c0: 6c79 2061 6c6c 6f63 6174 6564 2061 7272  ly allocated arr
│ │ │ │ -0003f8d0: 6179 206f 6620 616c 736f 0a20 2020 2020  ay of also.     
│ │ │ │ -0003f8e0: 616c 6c6f 6361 7465 6420 616e 6420 6e75  allocated and nu
│ │ │ │ -0003f8f0: 6c6c 2d74 6572 6d69 6e61 7465 6420 5554  ll-terminated UT
│ │ │ │ -0003f900: 462d 3820 7374 7269 6e67 7320 7769 7468  F-8 strings with
│ │ │ │ -0003f910: 2072 6561 6c6d 206e 616d 6573 2e0a 2020   realm names..  
│ │ │ │ -0003f920: 2020 204e 5245 414c 4d53 3a20 506f 696e     NREALMS: Poin
│ │ │ │ -0003f930: 7465 7220 746f 2061 206e 756d 6265 7220  ter to a number 
│ │ │ │ -0003f940: 7768 6963 6820 6973 2075 7064 6174 6564  which is updated
│ │ │ │ -0003f950: 2077 6974 6820 7468 6520 6e75 6d62 6572   with the number
│ │ │ │ -0003f960: 206f 660a 2020 2020 206a 7573 7420 616c   of.     just al
│ │ │ │ -0003f970: 6c6f 6361 7465 6420 616e 6420 7265 7475  located and retu
│ │ │ │ -0003f980: 726e 6564 2072 6561 6c6d 2073 7472 696e  rned realm strin
│ │ │ │ -0003f990: 6773 2e0a 0a20 2020 2020 2a44 6573 6372  gs...     *Descr
│ │ │ │ -0003f9a0: 6970 7469 6f6e 3a2a 2045 7874 7261 6374  iption:* Extract
│ │ │ │ -0003f9b0: 7320 6120 6c69 7374 206f 6620 616c 6c20  s a list of all 
│ │ │ │ -0003f9c0: 7265 616c 6d20 6e61 6d65 7320 696e 2062  realm names in b
│ │ │ │ -0003f9d0: 6163 6b65 6e64 2c20 6173 0a20 2020 2020  ackend, as.     
│ │ │ │ -0003f9e0: 6e75 6c6c 2d74 6572 6d69 6e61 7465 6420  null-terminated 
│ │ │ │ -0003f9f0: 5554 462d 3820 7374 7269 6e67 732e 2020  UTF-8 strings.  
│ │ │ │ -0003fa00: 5468 6520 6361 6c6c 6572 2069 7320 7265  The caller is re
│ │ │ │ -0003fa10: 7370 6f6e 7369 626c 6520 666f 720a 2020  sponsible for.  
│ │ │ │ -0003fa20: 2020 2064 6561 6c6c 6f63 6174 696e 6720     deallocating 
│ │ │ │ -0003fa30: 616c 6c20 7374 7269 6e67 7320 6173 2077  all strings as w
│ │ │ │ -0003fa40: 656c 6c20 6173 2074 6865 2061 7272 6179  ell as the array
│ │ │ │ -0003fa50: 202a 5245 414c 4d53 2e0a 0a20 2020 2020   *REALMS...     
│ │ │ │ -0003fa60: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ -0003fa70: 5265 7475 726e 7320 e280 9853 4849 5341  Returns ...SHISA
│ │ │ │ -0003fa80: 5f4f 4be2 8099 206f 6e20 7375 6363 6573  _OK... on succes
│ │ │ │ -0003fa90: 732c 206f 7220 616e 2065 7272 6f72 2063  s, or an error c
│ │ │ │ -0003faa0: 6f64 652e 0a0a 7368 6973 615f 656e 756d  ode...shisa_enum
│ │ │ │ -0003fab0: 6572 6174 655f 7072 696e 6369 7061 6c73  erate_principals
│ │ │ │ -0003fac0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ -0003fad0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ -0003fae0: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ -0003faf0: 6869 7361 5f65 6e75 6d65 7261 7465 5f70  hisa_enumerate_p
│ │ │ │ -0003fb00: 7269 6e63 6970 616c 7320 2853 6869 7361  rincipals (Shisa
│ │ │ │ -0003fb10: 202a 2044 4248 2c0a 2020 2020 2020 2020   * DBH,.        
│ │ │ │ -0003fb20: 2020 636f 6e73 7420 6368 6172 202a 2052    const char * R
│ │ │ │ -0003fb30: 4541 4c4d 2c20 6368 6172 202a 2a2a 2050  EALM, char *** P
│ │ │ │ -0003fb40: 5249 4e43 4950 414c 532c 2073 697a 655f  RINCIPALS, size_
│ │ │ │ -0003fb50: 7420 2a20 4e50 5249 4e43 4950 414c 5329  t * NPRINCIPALS)
│ │ │ │ -0003fb60: 0a20 2020 2020 4442 483a 2053 6869 7361  .     DBH: Shisa
│ │ │ │ -0003fb70: 206c 6962 7261 7279 2068 616e 646c 6520   library handle 
│ │ │ │ -0003fb80: 6372 6561 7465 6420 6279 20e2 8098 7368  created by ...sh
│ │ │ │ -0003fb90: 6973 6128 29e2 8099 2e0a 2020 2020 2052  isa().....     R
│ │ │ │ -0003fba0: 4541 4c4d 3a20 4e61 6d65 206f 6620 7265  EALM: Name of re
│ │ │ │ -0003fbb0: 616c 6d2c 2061 7320 6e75 6c6c 2d74 6572  alm, as null-ter
│ │ │ │ -0003fbc0: 6d69 6e61 7465 6420 5554 462d 3820 7374  minated UTF-8 st
│ │ │ │ -0003fbd0: 7269 6e67 2e0a 2020 2020 2050 5249 4e43  ring..     PRINC
│ │ │ │ -0003fbe0: 4950 414c 533a 2052 6574 7572 6e65 6420  IPALS: Returned 
│ │ │ │ -0003fbf0: 706f 696e 7465 7220 746f 206e 6577 6c79  pointer to newly
│ │ │ │ -0003fc00: 2061 6c6c 6f63 6174 6564 2061 7272 6179   allocated array
│ │ │ │ -0003fc10: 206f 6620 6a75 7374 0a20 2020 2020 616c   of just.     al
│ │ │ │ -0003fc20: 6c6f 6361 7465 6420 6e75 6c6c 2d74 6572  located null-ter
│ │ │ │ -0003fc30: 6d69 6e61 7465 6420 5554 462d 3820 7374  minated UTF-8 st
│ │ │ │ -0003fc40: 7269 6e67 7320 7769 7468 2070 7269 6e63  rings with princ
│ │ │ │ -0003fc50: 6970 616c 206e 616d 6573 2e0a 2020 2020  ipal names..    
│ │ │ │ -0003fc60: 204e 5052 494e 4349 5041 4c53 3a20 506f   NPRINCIPALS: Po
│ │ │ │ -0003fc70: 696e 7465 7220 746f 2061 6e20 696e 7465  inter to an inte
│ │ │ │ -0003fc80: 6765 7220 7570 6461 7465 6420 7769 7468  ger updated with
│ │ │ │ -0003fc90: 2074 6865 206e 756d 6265 7220 6f66 206a   the number of j
│ │ │ │ -0003fca0: 7573 740a 2020 2020 2061 6c6c 6f63 6174  ust.     allocat
│ │ │ │ -0003fcb0: 6564 2061 6e64 2072 6574 7572 6e65 6420  ed and returned 
│ │ │ │ -0003fcc0: 7072 696e 6369 7061 6c20 6e61 6d65 732e  principal names.
│ │ │ │ -0003fcd0: 0a0a 2020 2020 202a 4465 7363 7269 7074  ..     *Descript
│ │ │ │ -0003fce0: 696f 6e3a 2a20 4578 7472 6163 7473 2061  ion:* Extracts a
│ │ │ │ -0003fcf0: 206c 6973 7420 6f66 2061 6c6c 2070 7269   list of all pri
│ │ │ │ -0003fd00: 6e63 6970 616c 206e 616d 6573 2069 6e20  ncipal names in 
│ │ │ │ -0003fd10: 6261 636b 656e 640a 2020 2020 2062 656c  backend.     bel
│ │ │ │ -0003fd20: 6f6e 6769 6e67 2074 6f20 7468 6520 7265  onging to the re
│ │ │ │ -0003fd30: 616c 6d20 5245 414c 4d2c 2061 7320 6e75  alm REALM, as nu
│ │ │ │ -0003fd40: 6c6c 2d74 6572 6d69 6e61 7465 6420 5554  ll-terminated UT
│ │ │ │ -0003fd50: 462d 3820 7374 7269 6e67 732e 0a20 2020  F-8 strings..   
│ │ │ │ -0003fd60: 2020 5468 6520 6361 6c6c 6572 2069 7320    The caller is 
│ │ │ │ -0003fd70: 7265 7370 6f6e 7369 626c 6520 666f 7220  responsible for 
│ │ │ │ -0003fd80: 6465 616c 6c6f 6361 7469 6e67 2061 6c6c  deallocating all
│ │ │ │ -0003fd90: 2073 7472 696e 6773 2061 6e64 2074 6865   strings and the
│ │ │ │ -0003fda0: 0a20 2020 2020 6172 7261 7920 2a50 5249  .     array *PRI
│ │ │ │ -0003fdb0: 4e43 4950 414c 532e 0a0a 2020 2020 202a  NCIPALS...     *
│ │ │ │ -0003fdc0: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ -0003fdd0: 6574 7572 6e73 20e2 8098 5348 4953 415f  eturns ...SHISA_
│ │ │ │ -0003fde0: 4f4b e280 9920 6f6e 2073 7563 6365 7373  OK... on success
│ │ │ │ -0003fdf0: 2c20 e280 9853 4849 5341 5f4e 4f5f 5245  , ...SHISA_NO_RE
│ │ │ │ -0003fe00: 414c 4de2 8099 2069 660a 2020 2020 2074  ALM... if.     t
│ │ │ │ -0003fe10: 6865 2073 7065 6369 6669 6564 2072 6561  he specified rea
│ │ │ │ -0003fe20: 6c6d 2064 6f65 7320 6e6f 7420 6578 6973  lm does not exis
│ │ │ │ -0003fe30: 742c 206f 7220 616e 2065 7272 6f72 2063  t, or an error c
│ │ │ │ -0003fe40: 6f64 6520 6f74 6865 7277 6973 652e 0a0a  ode otherwise...
│ │ │ │ -0003fe50: 7368 6973 615f 7072 696e 6369 7061 6c5f  shisa_principal_
│ │ │ │ -0003fe60: 6669 6e64 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  find.-----------
│ │ │ │ -0003fe70: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ -0003fe80: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ -0003fe90: 7361 5f70 7269 6e63 6970 616c 5f66 696e  sa_principal_fin
│ │ │ │ -0003fea0: 6420 2853 6869 7361 202a 2044 4248 2c20  d (Shisa * DBH, 
│ │ │ │ -0003feb0: 636f 6e73 7420 6368 6172 202a 2052 4541  const char * REA
│ │ │ │ -0003fec0: 4c4d 2c0a 2020 2020 2020 2020 2020 636f  LM,.          co
│ │ │ │ -0003fed0: 6e73 7420 6368 6172 202a 2050 5249 4e43  nst char * PRINC
│ │ │ │ -0003fee0: 4950 414c 2c20 5368 6973 615f 7072 696e  IPAL, Shisa_prin
│ │ │ │ -0003fef0: 6369 7061 6c20 2a20 5048 290a 2020 2020  cipal * PH).    
│ │ │ │ -0003ff00: 2044 4248 3a20 5368 6973 6120 6c69 6272   DBH: Shisa libr
│ │ │ │ -0003ff10: 6172 7920 6861 6e64 6c65 2063 7265 6174  ary handle creat
│ │ │ │ -0003ff20: 6564 2062 7920 e280 9873 6869 7361 2829  ed by ...shisa()
│ │ │ │ -0003ff30: e280 992e 0a20 2020 2020 5245 414c 4d3a  .....     REALM:
│ │ │ │ -0003ff40: 204e 616d 6520 6f66 2074 6865 2072 6561   Name of the rea
│ │ │ │ -0003ff50: 6c6d 2074 6865 2070 7269 6e63 6970 616c  lm the principal
│ │ │ │ -0003ff60: 2062 656c 6f6e 6773 2074 6f2e 0a20 2020   belongs to..   
│ │ │ │ -0003ff70: 2020 5052 494e 4349 5041 4c3a 204e 616d    PRINCIPAL: Nam
│ │ │ │ -0003ff80: 6520 6f66 2070 7269 6e63 6970 616c 2074  e of principal t
│ │ │ │ -0003ff90: 6f20 6765 7420 696e 666f 726d 6174 696f  o get informatio
│ │ │ │ -0003ffa0: 6e20 6162 6f75 742e 0a20 2020 2020 5048  n about..     PH
│ │ │ │ -0003ffb0: 3a20 506f 696e 7465 7220 746f 2061 2070  : Pointer to a p
│ │ │ │ -0003ffc0: 7265 7669 6f75 736c 7920 616c 6c6f 6361  reviously alloca
│ │ │ │ -0003ffd0: 7465 6420 7072 696e 6369 7061 6c20 7374  ted principal st
│ │ │ │ -0003ffe0: 7275 6374 7572 6520 7768 6572 650a 2020  ructure where.  
│ │ │ │ -0003fff0: 2020 2069 6e66 6f72 6d61 7469 6f6e 2061     information a
│ │ │ │ -00040000: 626f 7574 2074 6865 2070 7269 6e63 6970  bout the princip
│ │ │ │ -00040010: 616c 2069 7320 746f 2062 6520 7374 6f72  al is to be stor
│ │ │ │ -00040020: 6564 2e0a 0a20 2020 2020 2a44 6573 6372  ed...     *Descr
│ │ │ │ -00040030: 6970 7469 6f6e 3a2a 2045 7874 7261 6374  iption:* Extract
│ │ │ │ -00040040: 7320 696e 666f 726d 6174 696f 6e20 6162  s information ab
│ │ │ │ -00040050: 6f75 7420 6769 7665 6e20 7468 6520 5052  out given the PR
│ │ │ │ -00040060: 494e 4349 5041 4c40 5245 414c 4d0a 2020  INCIPAL@REALM.  
│ │ │ │ -00040070: 2020 2070 6169 7220 7365 6c65 6374 6564     pair selected
│ │ │ │ -00040080: 2062 7920 5052 494e 4349 5041 4c20 616e   by PRINCIPAL an
│ │ │ │ -00040090: 6420 5245 414c 4d2e 0a0a 2020 2020 202a  d REALM...     *
│ │ │ │ -000400a0: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ -000400b0: 6574 7572 6e73 20e2 8098 5348 4953 415f  eturns ...SHISA_
│ │ │ │ -000400c0: 4f4b e280 9920 6966 2073 7563 6365 7373  OK... if success
│ │ │ │ -000400d0: 6675 6c2c 20e2 8098 5348 4953 415f 4e4f  ful, ...SHISA_NO
│ │ │ │ -000400e0: 5f52 4541 4c4d e280 990a 2020 2020 2069  _REALM....     i
│ │ │ │ -000400f0: 6620 7468 6520 696e 6469 6361 7465 6420  f the indicated 
│ │ │ │ -00040100: 7265 616c 6d20 646f 6573 206e 6f74 2065  realm does not e
│ │ │ │ -00040110: 7869 7374 2c20 e280 9853 4849 5341 5f4e  xist, ...SHISA_N
│ │ │ │ -00040120: 4f5f 5052 494e 4349 5041 4ce2 8099 2069  O_PRINCIPAL... i
│ │ │ │ -00040130: 6620 7468 650a 2020 2020 2069 6e64 6963  f the.     indic
│ │ │ │ -00040140: 6174 6564 2070 7269 6e63 6970 616c 2064  ated principal d
│ │ │ │ -00040150: 6f65 7320 6e6f 7420 6578 6973 742c 206f  oes not exist, o
│ │ │ │ -00040160: 7220 616e 2065 7272 6f72 2063 6f64 6520  r an error code 
│ │ │ │ -00040170: 6f74 6865 7277 6973 652e 0a0a 7368 6973  otherwise...shis
│ │ │ │ -00040180: 615f 7072 696e 6369 7061 6c5f 7570 6461  a_principal_upda
│ │ │ │ -00040190: 7465 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  te.-------------
│ │ │ │ -000401a0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ -000401b0: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ -000401c0: 7361 5f70 7269 6e63 6970 616c 5f75 7064  sa_principal_upd
│ │ │ │ -000401d0: 6174 6520 2853 6869 7361 202a 2044 4248  ate (Shisa * DBH
│ │ │ │ -000401e0: 2c0a 2020 2020 2020 2020 2020 636f 6e73  ,.          cons
│ │ │ │ -000401f0: 7420 6368 6172 202a 2052 4541 4c4d 2c20  t char * REALM, 
│ │ │ │ -00040200: 636f 6e73 7420 6368 6172 202a 2050 5249  const char * PRI
│ │ │ │ -00040210: 4e43 4950 414c 2c0a 2020 2020 2020 2020  NCIPAL,.        
│ │ │ │ -00040220: 2020 636f 6e73 7420 5368 6973 615f 7072    const Shisa_pr
│ │ │ │ -00040230: 696e 6369 7061 6c20 2a20 5048 290a 2020  incipal * PH).  
│ │ │ │ -00040240: 2020 2044 4248 3a20 5368 6973 6120 6c69     DBH: Shisa li
│ │ │ │ -00040250: 6272 6172 7920 6861 6e64 6c65 2063 7265  brary handle cre
│ │ │ │ -00040260: 6174 6564 2062 7920 e280 9873 6869 7361  ated by ...shisa
│ │ │ │ -00040270: 2829 e280 992e 0a20 2020 2020 5245 414c  ().....     REAL
│ │ │ │ -00040280: 4d3a 204e 616d 6520 6f66 2074 6865 2072  M: Name of the r
│ │ │ │ -00040290: 6561 6c6d 2074 6865 2070 7269 6e63 6970  ealm the princip
│ │ │ │ -000402a0: 616c 2062 656c 6f6e 6773 2074 6f2e 0a20  al belongs to.. 
│ │ │ │ -000402b0: 2020 2020 5052 494e 4349 5041 4c3a 204e      PRINCIPAL: N
│ │ │ │ -000402c0: 616d 6520 6f66 2070 7269 6e63 6970 616c  ame of principal
│ │ │ │ -000402d0: 2074 6f20 6765 7420 696e 666f 726d 6174   to get informat
│ │ │ │ -000402e0: 696f 6e20 6162 6f75 742e 0a20 2020 2020  ion about..     
│ │ │ │ -000402f0: 5048 3a20 506f 696e 7465 7220 746f 2061  PH: Pointer to a
│ │ │ │ -00040300: 6e20 6578 6973 7469 6e67 2070 7269 6e63  n existing princ
│ │ │ │ -00040310: 6970 616c 2073 7472 7563 7475 7265 2063  ipal structure c
│ │ │ │ -00040320: 6f6e 7461 696e 696e 670a 2020 2020 2069  ontaining.     i
│ │ │ │ -00040330: 6e66 6f72 6d61 7469 6f6e 2074 6f20 7374  nformation to st
│ │ │ │ -00040340: 6f72 6520 696e 2074 6865 2064 6174 6162  ore in the datab
│ │ │ │ -00040350: 6173 652e 0a0a 2020 2020 202a 4465 7363  ase...     *Desc
│ │ │ │ -00040360: 7269 7074 696f 6e3a 2a20 4d6f 6469 6669  ription:* Modifi
│ │ │ │ -00040370: 6573 2069 6e66 6f72 6d61 7469 6f6e 2073  es information s
│ │ │ │ -00040380: 746f 7265 6420 6162 6f75 7420 7468 6520  tored about the 
│ │ │ │ -00040390: 6769 7665 6e0a 2020 2020 2070 7269 6e63  given.     princ
│ │ │ │ -000403a0: 6970 616c 2050 5249 4e43 4950 414c 4052  ipal PRINCIPAL@R
│ │ │ │ -000403b0: 4541 4c4d 2e20 4e6f 7465 2074 6861 7420  EALM. Note that 
│ │ │ │ -000403c0: 6974 2069 7320 7573 7561 6c6c 7920 6120  it is usually a 
│ │ │ │ -000403d0: 676f 6f64 2069 6465 6120 746f 0a20 2020  good idea to.   
│ │ │ │ -000403e0: 2020 7365 7420 696e 2050 4820 6f6e 6c79    set in PH only
│ │ │ │ -000403f0: 2074 6865 2066 6965 6c64 7320 7468 6174   the fields that
│ │ │ │ -00040400: 2061 7265 2074 6f20 6265 2075 7064 6174   are to be updat
│ │ │ │ -00040410: 6564 2e0a 0a20 2020 2020 4974 2069 7320  ed...     It is 
│ │ │ │ -00040420: 6765 6e65 7261 6c6c 7920 7375 6767 6573  generally sugges
│ │ │ │ -00040430: 7465 6420 746f 2066 6972 7374 2063 616c  ted to first cal
│ │ │ │ -00040440: 6c20 e280 9873 6869 7361 5f70 7269 6e63  l ...shisa_princ
│ │ │ │ -00040450: 6970 616c 5f66 696e 6428 29e2 8099 2c0a  ipal_find()...,.
│ │ │ │ -00040460: 2020 2020 2074 6f20 6765 7420 7468 6520       to get the 
│ │ │ │ -00040470: 6375 7272 656e 7420 696e 666f 726d 6174  current informat
│ │ │ │ -00040480: 696f 6e2c 2074 6865 6e20 746f 206d 6f64  ion, then to mod
│ │ │ │ -00040490: 6966 7920 6f6e 6520 6669 656c 6420 616e  ify one field an
│ │ │ │ -000404a0: 6420 6361 6c6c 0a20 2020 2020 e280 9873  d call.     ...s
│ │ │ │ -000404b0: 6869 7361 5f70 7269 6e63 6970 616c 5f75  hisa_principal_u
│ │ │ │ -000404c0: 7064 6174 6528 29e2 8099 2e0a 0a20 2020  pdate()......   
│ │ │ │ -000404d0: 2020 4d6f 6469 6679 696e 6720 7365 7665    Modifying seve
│ │ │ │ -000404e0: 7261 6c20 7661 6c75 6573 2069 7320 6e6f  ral values is no
│ │ │ │ -000404f0: 7420 7265 636f 6d6d 656e 6465 6420 696e  t recommended in
│ │ │ │ -00040500: 2067 656e 6572 616c 2c20 6173 2074 6869   general, as thi
│ │ │ │ -00040510: 730a 2020 2020 2077 696c 6c20 3129 206f  s.     will 1) o
│ │ │ │ -00040520: 7665 7277 7269 7465 2061 6e79 206d 6f64  verwrite any mod
│ │ │ │ -00040530: 6966 6963 6174 696f 6e73 206d 6164 6520  ifications made 
│ │ │ │ -00040540: 746f 206f 7468 6572 2066 6965 6c64 7320  to other fields 
│ │ │ │ -00040550: 6265 7477 6565 6e0a 2020 2020 2074 6865  between.     the
│ │ │ │ -00040560: 2074 776f 2063 616c 6c73 2028 6279 206f   two calls (by o
│ │ │ │ -00040570: 7468 6572 2070 726f 6365 7373 6573 2920  ther processes) 
│ │ │ │ -00040580: 616e 6420 3229 2077 696c 6c20 6361 7573  and 2) will caus
│ │ │ │ -00040590: 6520 616c 6c20 7661 6c75 6573 2074 6f0a  e all values to.
│ │ │ │ -000405a0: 2020 2020 2062 6520 7772 6974 7465 6e20       be written 
│ │ │ │ -000405b0: 6167 6169 6e2c 2077 6869 6368 206d 6179  again, which may
│ │ │ │ -000405c0: 2067 656e 6572 6174 6520 6d6f 7265 206f   generate more o
│ │ │ │ -000405d0: 7665 7268 6561 642e 0a0a 2020 2020 202a  verhead...     *
│ │ │ │ -000405e0: 5265 7475 726e 2076 616c 7565 3a2a 2052  Return value:* R
│ │ │ │ -000405f0: 6574 7572 6e73 20e2 8098 5348 4953 415f  eturns ...SHISA_
│ │ │ │ -00040600: 4f4b e280 9920 6966 2073 7563 6365 7373  OK... if success
│ │ │ │ -00040610: 6675 6c2c 20e2 8098 5348 4953 415f 4e4f  ful, ...SHISA_NO
│ │ │ │ -00040620: 5f52 4541 4c4d e280 990a 2020 2020 2069  _REALM....     i
│ │ │ │ -00040630: 6620 7468 6520 696e 6469 6361 7465 6420  f the indicated 
│ │ │ │ -00040640: 7265 616c 6d20 646f 6573 206e 6f74 2065  realm does not e
│ │ │ │ -00040650: 7869 7374 2c20 e280 9853 4849 5341 5f4e  xist, ...SHISA_N
│ │ │ │ -00040660: 4f5f 5052 494e 4349 5041 4ce2 8099 2069  O_PRINCIPAL... i
│ │ │ │ -00040670: 6620 7468 650a 2020 2020 2069 6e64 6963  f the.     indic
│ │ │ │ -00040680: 6174 6564 2070 7269 6e63 6970 616c 2064  ated principal d
│ │ │ │ -00040690: 6f65 7320 6e6f 7420 6578 6973 742c 206f  oes not exist, o
│ │ │ │ -000406a0: 7220 616e 2065 7272 6f72 2063 6f64 6520  r an error code 
│ │ │ │ -000406b0: 6f74 6865 7277 6973 652e 0a0a 7368 6973  otherwise...shis
│ │ │ │ -000406c0: 615f 7072 696e 6369 7061 6c5f 6164 640a  a_principal_add.
│ │ │ │ -000406d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000406e0: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ -000406f0: 6e3a 2069 6e74 2073 6869 7361 5f70 7269  n: int shisa_pri
│ │ │ │ -00040700: 6e63 6970 616c 5f61 6464 2028 5368 6973  ncipal_add (Shis
│ │ │ │ -00040710: 6120 2a20 4442 482c 2063 6f6e 7374 2063  a * DBH, const c
│ │ │ │ -00040720: 6861 7220 2a20 5245 414c 4d2c 0a20 2020  har * REALM,.   
│ │ │ │ -00040730: 2020 2020 2020 2063 6f6e 7374 2063 6861         const cha
│ │ │ │ -00040740: 7220 2a20 5052 494e 4349 5041 4c2c 2063  r * PRINCIPAL, c
│ │ │ │ -00040750: 6f6e 7374 2053 6869 7361 5f70 7269 6e63  onst Shisa_princ
│ │ │ │ -00040760: 6970 616c 202a 2050 482c 0a20 2020 2020  ipal * PH,.     
│ │ │ │ -00040770: 2020 2020 2063 6f6e 7374 2053 6869 7361       const Shisa
│ │ │ │ -00040780: 5f6b 6579 202a 204b 4559 290a 2020 2020  _key * KEY).    
│ │ │ │ -00040790: 2044 4248 3a20 5368 6973 6120 6c69 6272   DBH: Shisa libr
│ │ │ │ -000407a0: 6172 7920 6861 6e64 6c65 2063 7265 6174  ary handle creat
│ │ │ │ -000407b0: 6564 2062 7920 e280 9873 6869 7361 2829  ed by ...shisa()
│ │ │ │ -000407c0: e280 992e 0a20 2020 2020 5245 414c 4d3a  .....     REALM:
│ │ │ │ -000407d0: 204e 616d 6520 6f66 2074 6865 2072 6561   Name of the rea
│ │ │ │ -000407e0: 6c6d 2074 6865 2070 7269 6e63 6970 616c  lm the principal
│ │ │ │ -000407f0: 2062 656c 6f6e 6773 2074 6f2e 0a20 2020   belongs to..   
│ │ │ │ -00040800: 2020 5052 494e 4349 5041 4c3a 204e 616d    PRINCIPAL: Nam
│ │ │ │ -00040810: 6520 6f66 2070 7269 6e63 6970 616c 2074  e of principal t
│ │ │ │ -00040820: 6f20 6164 642e 2020 5768 656e 2073 6574  o add.  When set
│ │ │ │ -00040830: 2074 6f20 e280 984e 554c 4ce2 8099 2c20   to ...NULL..., 
│ │ │ │ -00040840: 6f6e 6c79 2074 6865 0a20 2020 2020 7265  only the.     re
│ │ │ │ -00040850: 616c 6d20 5245 414c 4d20 6973 2063 7265  alm REALM is cre
│ │ │ │ -00040860: 6174 6564 2e0a 2020 2020 2050 483a 2050  ated..     PH: P
│ │ │ │ -00040870: 6f69 6e74 6572 2074 6f20 6120 7072 696e  ointer to a prin
│ │ │ │ -00040880: 6369 7061 6c20 7374 7275 6374 7572 6520  cipal structure 
│ │ │ │ -00040890: 7769 7468 2069 6e66 6f72 6d61 7469 6f6e  with information
│ │ │ │ -000408a0: 2074 6f20 7374 6f72 6520 696e 0a20 2020   to store in.   
│ │ │ │ -000408b0: 2020 7468 6520 6461 7461 6261 7365 2e0a    the database..
│ │ │ │ -000408c0: 2020 2020 204b 4559 3a20 506f 696e 7465       KEY: Pointe
│ │ │ │ -000408d0: 7220 746f 2061 206b 6579 2073 7472 7563  r to a key struc
│ │ │ │ -000408e0: 7475 7265 2077 6974 6820 696e 666f 726d  ture with inform
│ │ │ │ -000408f0: 6174 696f 6e20 746f 2073 746f 7265 2069  ation to store i
│ │ │ │ -00040900: 6e20 7468 650a 2020 2020 2064 6174 6162  n the.     datab
│ │ │ │ -00040910: 6173 652e 0a0a 2020 2020 202a 4465 7363  ase...     *Desc
│ │ │ │ -00040920: 7269 7074 696f 6e3a 2a20 496e 7365 7274  ription:* Insert
│ │ │ │ -00040930: 7320 7468 6520 6769 7665 6e20 696e 666f  s the given info
│ │ │ │ -00040940: 726d 6174 696f 6e20 696e 746f 2074 6865  rmation into the
│ │ │ │ -00040950: 2064 6174 6162 6173 6520 666f 720a 2020   database for.  
│ │ │ │ -00040960: 2020 2074 6865 2070 7269 6e63 6970 616c     the principal
│ │ │ │ -00040970: 2050 5249 4e43 4950 414c 4052 4541 4c4d   PRINCIPAL@REALM
│ │ │ │ -00040980: 2e20 496e 2063 6173 6520 5052 494e 4349  . In case PRINCI
│ │ │ │ -00040990: 5041 4c20 6973 20e2 8098 4e55 4c4c e280  PAL is ...NULL..
│ │ │ │ -000409a0: 992c 2074 6865 0a20 2020 2020 7061 7261  ., the.     para
│ │ │ │ -000409b0: 6d65 7465 7273 2050 4820 616e 6420 4b45  meters PH and KE
│ │ │ │ -000409c0: 5920 6172 6520 6e6f 7420 7573 6564 2c20  Y are not used, 
│ │ │ │ -000409d0: 736f 206f 6e6c 7920 7468 6520 7265 616c  so only the real
│ │ │ │ -000409e0: 6d20 6973 2061 6464 6564 2074 6f0a 2020  m is added to.  
│ │ │ │ -000409f0: 2020 2074 6865 2064 6174 6162 6173 652e     the database.
│ │ │ │ -00040a00: 0a0a 2020 2020 202a 5265 7475 726e 2076  ..     *Return v
│ │ │ │ -00040a10: 616c 7565 3a2a 2052 6574 7572 6e73 20e2  alue:* Returns .
│ │ │ │ -00040a20: 8098 5348 4953 415f 4f4b e280 9920 6966  ..SHISA_OK... if
│ │ │ │ -00040a30: 2074 6865 2069 6e66 6f72 6d61 7469 6f6e   the information
│ │ │ │ -00040a40: 2077 6173 0a20 2020 2020 7375 6363 6573   was.     succes
│ │ │ │ -00040a50: 7366 756c 6c79 2061 6464 6564 2c20 6f72  sfully added, or
│ │ │ │ -00040a60: 2061 6e20 6572 726f 7220 636f 6465 206f   an error code o
│ │ │ │ -00040a70: 7468 6572 7769 7365 2e0a 0a73 6869 7361  therwise...shisa
│ │ │ │ -00040a80: 5f70 7269 6e63 6970 616c 5f72 656d 6f76  _principal_remov
│ │ │ │ -00040a90: 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  e.--------------
│ │ │ │ -00040aa0: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -00040ab0: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ -00040ac0: 615f 7072 696e 6369 7061 6c5f 7265 6d6f  a_principal_remo
│ │ │ │ -00040ad0: 7665 2028 5368 6973 6120 2a20 4442 482c  ve (Shisa * DBH,
│ │ │ │ -00040ae0: 0a20 2020 2020 2020 2020 2063 6f6e 7374  .          const
│ │ │ │ -00040af0: 2063 6861 7220 2a20 5245 414c 4d2c 2063   char * REALM, c
│ │ │ │ -00040b00: 6f6e 7374 2063 6861 7220 2a20 5052 494e  onst char * PRIN
│ │ │ │ -00040b10: 4349 5041 4c29 0a20 2020 2020 4442 483a  CIPAL).     DBH:
│ │ │ │ -00040b20: 2053 6869 7361 206c 6962 7261 7279 2068   Shisa library h
│ │ │ │ -00040b30: 616e 646c 6520 6372 6561 7465 6420 6279  andle created by
│ │ │ │ -00040b40: 20e2 8098 7368 6973 6128 29e2 8099 2e0a   ...shisa().....
│ │ │ │ -00040b50: 2020 2020 2052 4541 4c4d 3a20 4e61 6d65       REALM: Name
│ │ │ │ -00040b60: 206f 6620 7468 6520 7265 616c 6d20 7468   of the realm th
│ │ │ │ -00040b70: 6520 7072 696e 6369 7061 6c20 6265 6c6f  e principal belo
│ │ │ │ -00040b80: 6e67 7320 746f 2e0a 2020 2020 2050 5249  ngs to..     PRI
│ │ │ │ -00040b90: 4e43 4950 414c 3a20 4e61 6d65 206f 6620  NCIPAL: Name of 
│ │ │ │ -00040ba0: 7468 6520 7072 696e 6369 7061 6c20 746f  the principal to
│ │ │ │ -00040bb0: 2072 656d 6f76 652e 2020 5365 7420 746f   remove.  Set to
│ │ │ │ -00040bc0: 20e2 8098 4e55 4c4c e280 992c 206f 6e6c   ...NULL..., onl
│ │ │ │ -00040bd0: 790a 2020 2020 2074 6865 2072 6561 6c6d  y.     the realm
│ │ │ │ -00040be0: 2052 4541 4c4d 2069 7320 7265 6d6f 7665   REALM is remove
│ │ │ │ -00040bf0: 642e 0a0a 2020 2020 202a 4465 7363 7269  d...     *Descri
│ │ │ │ -00040c00: 7074 696f 6e3a 2a20 5265 6d6f 7665 7320  ption:* Removes 
│ │ │ │ -00040c10: 616c 6c20 696e 666f 726d 6174 696f 6e20  all information 
│ │ │ │ -00040c20: 7374 6f72 6564 2069 6e20 7468 6520 6461  stored in the da
│ │ │ │ -00040c30: 7461 6261 7365 2066 6f72 0a20 2020 2020  tabase for.     
│ │ │ │ -00040c40: 7468 6520 6769 7665 6e20 7072 696e 6369  the given princi
│ │ │ │ -00040c50: 7061 6c20 5052 494e 4349 5041 4c40 5245  pal PRINCIPAL@RE
│ │ │ │ -00040c60: 414c 4d2e 2057 6865 6e20 5052 494e 4349  ALM. When PRINCI
│ │ │ │ -00040c70: 5041 4c20 6973 20e2 8098 4e55 4c4c e280  PAL is ...NULL..
│ │ │ │ -00040c80: 992c 2074 6865 6e0a 2020 2020 2074 6865  ., then.     the
│ │ │ │ -00040c90: 2072 6561 6c6d 2052 4541 4c4d 2069 7320   realm REALM is 
│ │ │ │ -00040ca0: 6974 7365 6c66 2072 656d 6f76 6564 2c20  itself removed, 
│ │ │ │ -00040cb0: 6275 7420 7468 6973 2063 616e 206f 6e6c  but this can onl
│ │ │ │ -00040cc0: 7920 7375 6363 6565 6420 6966 2074 6865  y succeed if the
│ │ │ │ -00040cd0: 0a20 2020 2020 7265 616c 6d20 6973 2061  .     realm is a
│ │ │ │ -00040ce0: 6c72 6561 6479 2065 6d70 7479 206f 6620  lready empty of 
│ │ │ │ -00040cf0: 7072 696e 6369 7061 6c73 2e0a 0a20 2020  principals...   
│ │ │ │ -00040d00: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ -00040d10: 2a20 5265 7475 726e 7320 e280 9853 4849  * Returns ...SHI
│ │ │ │ -00040d20: 5341 5f4f 4be2 8099 2069 6620 7375 6363  SA_OK... if succ
│ │ │ │ -00040d30: 6573 7366 756c 2c20 6f72 2061 6e20 6572  essful, or an er
│ │ │ │ -00040d40: 726f 7220 636f 6465 2e0a 0a73 6869 7361  ror code...shisa
│ │ │ │ -00040d50: 5f6b 6579 735f 6669 6e64 0a2d 2d2d 2d2d  _keys_find.-----
│ │ │ │ -00040d60: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ -00040d70: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ -00040d80: 6973 615f 6b65 7973 5f66 696e 6420 2853  isa_keys_find (S
│ │ │ │ -00040d90: 6869 7361 202a 2044 4248 2c20 636f 6e73  hisa * DBH, cons
│ │ │ │ -00040da0: 7420 6368 6172 202a 2052 4541 4c4d 2c0a  t char * REALM,.
│ │ │ │ -00040db0: 2020 2020 2020 2020 2020 636f 6e73 7420            const 
│ │ │ │ -00040dc0: 6368 6172 202a 2050 5249 4e43 4950 414c  char * PRINCIPAL
│ │ │ │ -00040dd0: 2c20 636f 6e73 7420 5368 6973 615f 6b65  , const Shisa_ke
│ │ │ │ -00040de0: 7920 2a20 4849 4e54 2c0a 2020 2020 2020  y * HINT,.      
│ │ │ │ -00040df0: 2020 2020 5368 6973 615f 6b65 7920 2a2a      Shisa_key **
│ │ │ │ -00040e00: 2a20 4b45 5953 2c20 7369 7a65 5f74 202a  * KEYS, size_t *
│ │ │ │ -00040e10: 204e 4b45 5953 290a 2020 2020 2044 4248   NKEYS).     DBH
│ │ │ │ -00040e20: 3a20 5368 6973 6120 6c69 6272 6172 7920  : Shisa library 
│ │ │ │ -00040e30: 6861 6e64 6c65 2063 7265 6174 6564 2062  handle created b
│ │ │ │ -00040e40: 7920 e280 9873 6869 7361 2829 e280 992e  y ...shisa()....
│ │ │ │ -00040e50: 0a20 2020 2020 5245 414c 4d3a 204e 616d  .     REALM: Nam
│ │ │ │ -00040e60: 6520 6f66 2074 6865 2072 6561 6c6d 2074  e of the realm t
│ │ │ │ -00040e70: 6865 2070 7269 6e63 6970 616c 2062 656c  he principal bel
│ │ │ │ -00040e80: 6f6e 6773 2074 6f2e 0a20 2020 2020 5052  ongs to..     PR
│ │ │ │ -00040e90: 494e 4349 5041 4c3a 204e 616d 6520 6f66  INCIPAL: Name of
│ │ │ │ -00040ea0: 2074 6865 2070 7269 6e63 6970 616c 2077   the principal w
│ │ │ │ -00040eb0: 686f 7365 206b 6579 7320 6172 6520 6578  hose keys are ex
│ │ │ │ -00040ec0: 616d 696e 6564 2e0a 2020 2020 2048 494e  amined..     HIN
│ │ │ │ -00040ed0: 543a 2050 6f69 6e74 6572 2074 6f20 6120  T: Pointer to a 
│ │ │ │ -00040ee0: 5368 6973 6120 6b65 7920 7374 7275 6374  Shisa key struct
│ │ │ │ -00040ef0: 7572 6520 7769 7468 2068 696e 7473 206f  ure with hints o
│ │ │ │ -00040f00: 6e20 6d61 7463 6869 6e67 0a20 2020 2020  n matching.     
│ │ │ │ -00040f10: 6372 6974 6572 6961 2066 6f72 2072 656c  criteria for rel
│ │ │ │ -00040f20: 6576 616e 7420 6b65 7973 2e20 20e2 8098  evant keys.  ...
│ │ │ │ -00040f30: 4e55 4c4c e280 9920 6d61 7463 6865 7320  NULL... matches 
│ │ │ │ -00040f40: 616c 6c20 6b65 7973 2e0a 2020 2020 204b  all keys..     K
│ │ │ │ -00040f50: 4559 533a 2052 6574 7572 6e65 6420 706f  EYS: Returned po
│ │ │ │ -00040f60: 696e 7465 7220 746f 2061 206e 6577 6c79  inter to a newly
│ │ │ │ -00040f70: 2061 6c6c 6f63 6174 6564 2061 7272 6179   allocated array
│ │ │ │ -00040f80: 206f 6620 5368 6973 6120 6b65 790a 2020   of Shisa key.  
│ │ │ │ -00040f90: 2020 2073 7472 7563 7475 7265 732e 0a20     structures.. 
│ │ │ │ -00040fa0: 2020 2020 4e4b 4559 533a 2050 6f69 6e74      NKEYS: Point
│ │ │ │ -00040fb0: 6572 2074 6f20 616e 2069 6e74 6567 6572  er to an integer
│ │ │ │ -00040fc0: 2075 7064 6174 6564 2077 6974 6820 7468   updated with th
│ │ │ │ -00040fd0: 6520 6e75 6d62 6572 206f 6620 616c 6c6f  e number of allo
│ │ │ │ -00040fe0: 6361 7465 640a 2020 2020 2053 6869 7361  cated.     Shisa
│ │ │ │ -00040ff0: 206b 6579 2073 7472 7563 7475 7265 7320   key structures 
│ │ │ │ -00041000: 696e 202a 4b45 5953 2e0a 0a20 2020 2020  in *KEYS...     
│ │ │ │ -00041010: 2a44 6573 6372 6970 7469 6f6e 3a2a 2049  *Description:* I
│ │ │ │ -00041020: 7465 7261 7465 7320 7468 726f 7567 6820  terates through 
│ │ │ │ -00041030: 7468 6520 7365 7420 6f66 206b 6579 7320  the set of keys 
│ │ │ │ -00041040: 6265 6c6f 6e67 696e 6720 746f 0a20 2020  belonging to.   
│ │ │ │ -00041050: 2020 5052 494e 4349 5041 4c40 5245 414c    PRINCIPAL@REAL
│ │ │ │ -00041060: 4d2c 2061 7320 7365 6c65 6374 6564 2062  M, as selected b
│ │ │ │ -00041070: 7920 5052 494e 4349 5041 4c20 616e 6420  y PRINCIPAL and 
│ │ │ │ -00041080: 5245 414c 4d2e 2020 5468 656e 2065 7874  REALM.  Then ext
│ │ │ │ -00041090: 7261 6374 730a 2020 2020 2061 6e79 206b  racts.     any k
│ │ │ │ -000410a0: 6579 7320 7468 6174 206d 6174 6368 2074  eys that match t
│ │ │ │ -000410b0: 6865 2063 7269 7465 7269 6120 696e 2048  he criteria in H
│ │ │ │ -000410c0: 494e 542e 0a0a 2020 2020 204e 6f74 2061  INT...     Not a
│ │ │ │ -000410d0: 6c6c 2065 6c65 6d65 6e74 7320 6f66 2048  ll elements of H
│ │ │ │ -000410e0: 494e 5420 6e65 6564 2074 6f20 6265 2066  INT need to be f
│ │ │ │ -000410f0: 696c 6c65 6420 696e 2e20 2053 6574 206f  illed in.  Set o
│ │ │ │ -00041100: 6e6c 7920 7468 6520 6669 656c 6473 0a20  nly the fields. 
│ │ │ │ -00041110: 2020 2020 796f 7520 6172 6520 696e 7465      you are inte
│ │ │ │ -00041120: 7265 7374 6564 2069 6e2e 2020 466f 7220  rested in.  For 
│ │ │ │ -00041130: 6578 616d 706c 652c 2069 6620 796f 7520  example, if you 
│ │ │ │ -00041140: 7761 6e74 2074 6f20 6578 7472 6163 7420  want to extract 
│ │ │ │ -00041150: 616c 6c0a 2020 2020 206b 6579 7320 6f66  all.     keys of
│ │ │ │ -00041160: 2065 7479 7065 2033 2c20 692e 652e 2c20   etype 3, i.e., 
│ │ │ │ -00041170: 4445 532d 4342 432d 4d44 352c 2074 6865  DES-CBC-MD5, the
│ │ │ │ -00041180: 6e20 7365 7420 7468 6520 6669 656c 6420  n set the field 
│ │ │ │ -00041190: 4b45 592d 3e65 7479 7065 0a20 2020 2020  KEY->etype.     
│ │ │ │ -000411a0: 746f 2033 2c20 616e 6420 616c 6c20 6f74  to 3, and all ot
│ │ │ │ -000411b0: 6865 7220 6669 656c 6473 2074 6f20 7a65  her fields to ze
│ │ │ │ -000411c0: 726f 2e0a 0a20 2020 2020 2a52 6574 7572  ro...     *Retur
│ │ │ │ -000411d0: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ -000411e0: 7320 e280 9853 4849 5341 5f4f 4be2 8099  s ...SHISA_OK...
│ │ │ │ -000411f0: 2069 6620 7375 6363 6573 7366 756c 2c20   if successful, 
│ │ │ │ -00041200: 6f72 2061 6e20 6572 726f 7220 636f 6465  or an error code
│ │ │ │ -00041210: 2e0a 0a73 6869 7361 5f6b 6579 5f61 6464  ...shisa_key_add
│ │ │ │ -00041220: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  .-------------..
│ │ │ │ -00041230: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ -00041240: 7420 7368 6973 615f 6b65 795f 6164 6420  t shisa_key_add 
│ │ │ │ -00041250: 2853 6869 7361 202a 2044 4248 2c20 636f  (Shisa * DBH, co
│ │ │ │ -00041260: 6e73 7420 6368 6172 202a 2052 4541 4c4d  nst char * REALM
│ │ │ │ -00041270: 2c0a 2020 2020 2020 2020 2020 636f 6e73  ,.          cons
│ │ │ │ -00041280: 7420 6368 6172 202a 2050 5249 4e43 4950  t char * PRINCIP
│ │ │ │ -00041290: 414c 2c20 636f 6e73 7420 5368 6973 615f  AL, const Shisa_
│ │ │ │ -000412a0: 6b65 7920 2a20 4b45 5929 0a20 2020 2020  key * KEY).     
│ │ │ │ -000412b0: 4442 483a 2053 6869 7361 206c 6962 7261  DBH: Shisa libra
│ │ │ │ -000412c0: 7279 2068 616e 646c 6520 6372 6561 7465  ry handle create
│ │ │ │ -000412d0: 6420 6279 20e2 8098 7368 6973 6128 29e2  d by ...shisa().
│ │ │ │ -000412e0: 8099 2e0a 2020 2020 2052 4541 4c4d 3a20  ....     REALM: 
│ │ │ │ -000412f0: 4e61 6d65 206f 6620 7468 6520 7265 616c  Name of the real
│ │ │ │ -00041300: 6d20 7468 6520 7072 696e 6369 7061 6c20  m the principal 
│ │ │ │ -00041310: 6265 6c6f 6e67 7320 746f 2e0a 2020 2020  belongs to..    
│ │ │ │ -00041320: 2050 5249 4e43 4950 414c 3a20 4e61 6d65   PRINCIPAL: Name
│ │ │ │ -00041330: 206f 6620 7468 6520 7072 696e 6369 7061   of the principa
│ │ │ │ -00041340: 6c20 746f 2061 6464 2061 206e 6577 206b  l to add a new k
│ │ │ │ -00041350: 6579 2066 6f72 2e0a 2020 2020 204b 4559  ey for..     KEY
│ │ │ │ -00041360: 3a20 506f 696e 7465 7220 746f 2061 2053  : Pointer to a S
│ │ │ │ -00041370: 6869 7361 206b 6579 2073 7472 7563 7475  hisa key structu
│ │ │ │ -00041380: 7265 2077 6974 6820 7468 6520 6e65 7720  re with the new 
│ │ │ │ -00041390: 6b65 792e 0a0a 2020 2020 202a 4465 7363  key...     *Desc
│ │ │ │ -000413a0: 7269 7074 696f 6e3a 2a20 4164 6473 2061  ription:* Adds a
│ │ │ │ -000413b0: 2063 6f6d 706c 6574 6520 6b65 7920 4b45   complete key KE
│ │ │ │ -000413c0: 5920 746f 2074 6865 2064 6174 6162 6173  Y to the databas
│ │ │ │ -000413d0: 6520 656e 7472 790a 2020 2020 2062 656c  e entry.     bel
│ │ │ │ -000413e0: 6f6e 6769 6e67 2074 6f20 7468 6520 7072  onging to the pr
│ │ │ │ -000413f0: 696e 6369 7061 6c20 5052 494e 4349 5041  incipal PRINCIPA
│ │ │ │ -00041400: 4c40 5245 414c 4d2c 2061 7320 7365 7420  L@REALM, as set 
│ │ │ │ -00041410: 6279 2050 5249 4e43 4950 414c 2061 6e64  by PRINCIPAL and
│ │ │ │ -00041420: 0a20 2020 2020 5245 414c 4d2e 0a0a 2020  .     REALM...  
│ │ │ │ -00041430: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ -00041440: 3a2a 2052 6574 7572 6e73 20e2 8098 5348  :* Returns ...SH
│ │ │ │ -00041450: 4953 415f 4f4b e280 9920 6966 2073 7563  ISA_OK... if suc
│ │ │ │ -00041460: 6365 7373 6675 6c2c 206f 7220 616e 2065  cessful, or an e
│ │ │ │ -00041470: 7272 6f72 2063 6f64 652e 0a0a 7368 6973  rror code...shis
│ │ │ │ -00041480: 615f 6b65 795f 7570 6461 7465 0a2d 2d2d  a_key_update.---
│ │ │ │ -00041490: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -000414a0: 2d2d 2046 756e 6374 696f 6e3a 2069 6e74  -- Function: int
│ │ │ │ -000414b0: 2073 6869 7361 5f6b 6579 5f75 7064 6174   shisa_key_updat
│ │ │ │ -000414c0: 6520 2853 6869 7361 202a 2044 4248 2c20  e (Shisa * DBH, 
│ │ │ │ -000414d0: 636f 6e73 7420 6368 6172 202a 2052 4541  const char * REA
│ │ │ │ -000414e0: 4c4d 2c0a 2020 2020 2020 2020 2020 636f  LM,.          co
│ │ │ │ -000414f0: 6e73 7420 6368 6172 202a 2050 5249 4e43  nst char * PRINC
│ │ │ │ -00041500: 4950 414c 2c20 636f 6e73 7420 5368 6973  IPAL, const Shis
│ │ │ │ -00041510: 615f 6b65 7920 2a20 4f4c 444b 4559 2c0a  a_key * OLDKEY,.
│ │ │ │ -00041520: 2020 2020 2020 2020 2020 636f 6e73 7420            const 
│ │ │ │ -00041530: 5368 6973 615f 6b65 7920 2a20 4e45 574b  Shisa_key * NEWK
│ │ │ │ -00041540: 4559 290a 2020 2020 2044 4248 3a20 5368  EY).     DBH: Sh
│ │ │ │ -00041550: 6973 6120 6c69 6272 6172 7920 6861 6e64  isa library hand
│ │ │ │ -00041560: 6c65 2063 7265 6174 6564 2062 7920 e280  le created by ..
│ │ │ │ -00041570: 9873 6869 7361 2829 e280 992e 0a20 2020  .shisa().....   
│ │ │ │ -00041580: 2020 5245 414c 4d3a 204e 616d 6520 6f66    REALM: Name of
│ │ │ │ -00041590: 2074 6865 2072 6561 6c6d 2074 6865 2070   the realm the p
│ │ │ │ -000415a0: 7269 6e63 6970 616c 2062 656c 6f6e 6773  rincipal belongs
│ │ │ │ -000415b0: 2074 6f2e 0a20 2020 2020 5052 494e 4349   to..     PRINCI
│ │ │ │ -000415c0: 5041 4c3a 204e 616d 6520 6f66 2074 6865  PAL: Name of the
│ │ │ │ -000415d0: 2070 7269 6e63 6970 616c 206e 6565 6469   principal needi
│ │ │ │ -000415e0: 6e67 2061 6e20 7570 6461 7465 6420 6b65  ng an updated ke
│ │ │ │ -000415f0: 792e 0a20 2020 2020 4f4c 444b 4559 3a20  y..     OLDKEY: 
│ │ │ │ -00041600: 506f 696e 7465 7220 746f 2061 2053 6869  Pointer to a Shi
│ │ │ │ -00041610: 7361 206b 6579 2073 7472 7563 7475 7265  sa key structure
│ │ │ │ -00041620: 2067 6976 696e 6720 6d61 7463 6869 6e67   giving matching
│ │ │ │ -00041630: 2063 7269 7465 7269 610a 2020 2020 2066   criteria.     f
│ │ │ │ -00041640: 6f72 206c 6f63 6174 696e 6720 7468 6520  or locating the 
│ │ │ │ -00041650: 6b65 7920 746f 2062 6520 7570 6461 7465  key to be update
│ │ │ │ -00041660: 642e 0a20 2020 2020 4e45 574b 4559 3a20  d..     NEWKEY: 
│ │ │ │ -00041670: 506f 696e 7465 7220 746f 2061 2063 6f6d  Pointer to a com
│ │ │ │ -00041680: 706c 6574 6520 5368 6973 6120 6b65 7920  plete Shisa key 
│ │ │ │ -00041690: 7374 7275 6374 7572 652c 2069 6e20 7768  structure, in wh
│ │ │ │ -000416a0: 6963 6820 616c 6c0a 2020 2020 2066 6965  ich all.     fie
│ │ │ │ -000416b0: 6c64 7320 6172 6520 7573 6564 2066 6f72  lds are used for
│ │ │ │ -000416c0: 2074 6865 206e 6577 206b 6579 2e20 204e   the new key.  N
│ │ │ │ -000416d0: 6f74 6520 7468 6174 204f 4c44 4b45 5920  ote that OLDKEY 
│ │ │ │ -000416e0: 6e6f 726d 616c 6c79 2068 6173 2066 6172  normally has far
│ │ │ │ -000416f0: 0a20 2020 2020 6665 7765 7220 6669 656c  .     fewer fiel
│ │ │ │ -00041700: 6473 2066 696c 6c65 642d 696e 2e0a 0a20  ds filled-in... 
│ │ │ │ -00041710: 2020 2020 2a44 6573 6372 6970 7469 6f6e      *Description
│ │ │ │ -00041720: 3a2a 204d 6f64 6966 6965 7320 6461 7461  :* Modifies data
│ │ │ │ -00041730: 2061 626f 7574 2061 206b 6579 2073 746f   about a key sto
│ │ │ │ -00041740: 7265 6420 696e 2074 6865 2064 6174 6162  red in the datab
│ │ │ │ -00041750: 6173 652c 2061 0a20 2020 2020 6b65 7920  ase, a.     key 
│ │ │ │ -00041760: 6265 6c6f 6e67 696e 6720 746f 2074 6865  belonging to the
│ │ │ │ -00041770: 2070 7269 6e63 6970 616c 2073 656c 6563   principal selec
│ │ │ │ -00041780: 7465 6420 6279 2050 5249 4e43 4950 414c  ted by PRINCIPAL
│ │ │ │ -00041790: 2061 6e64 2052 4541 4c4d 2e0a 2020 2020   and REALM..    
│ │ │ │ -000417a0: 2046 6972 7374 204f 4c44 4b45 5920 6973   First OLDKEY is
│ │ │ │ -000417b0: 2075 7365 6420 746f 206c 6f63 6174 6520   used to locate 
│ │ │ │ -000417c0: 7468 6520 6b65 7920 746f 2075 7064 6174  the key to updat
│ │ │ │ -000417d0: 652c 2061 7320 646f 6573 0a20 2020 2020  e, as does.     
│ │ │ │ -000417e0: e280 9873 6869 7361 5f6b 6579 735f 6669  ...shisa_keys_fi
│ │ │ │ -000417f0: 6e64 2829 e280 992e 2020 5468 656e 2074  nd()....  Then t
│ │ │ │ -00041800: 6865 2066 6f75 6e64 206b 6579 2069 7320  he found key is 
│ │ │ │ -00041810: 6d6f 6469 6669 6564 2074 6f20 6361 7272  modified to carr
│ │ │ │ -00041820: 790a 2020 2020 2077 6861 7465 7665 7220  y.     whatever 
│ │ │ │ -00041830: 696e 666f 726d 6174 696f 6e20 6973 2073  information is s
│ │ │ │ -00041840: 746f 7265 6420 696e 204e 4557 4b45 592e  tored in NEWKEY.
│ │ │ │ -00041850: 0a0a 2020 2020 204e 6f74 2061 6c6c 2065  ..     Not all e
│ │ │ │ -00041860: 6c65 6d65 6e74 7320 6f66 204f 4c44 4b45  lements of OLDKE
│ │ │ │ -00041870: 5920 6e65 6564 2074 6f20 6265 2066 696c  Y need to be fil
│ │ │ │ -00041880: 6c65 6420 6f75 742c 206f 6e6c 7920 7375  led out, only su
│ │ │ │ -00041890: 6666 6963 6965 6e74 6c79 0a20 2020 2020  fficiently.     
│ │ │ │ -000418a0: 6d61 6e79 2073 6f20 6173 2074 6f20 756e  many so as to un
│ │ │ │ -000418b0: 6971 7565 6c79 2069 6465 6e74 6966 7920  iquely identify 
│ │ │ │ -000418c0: 7468 6520 6465 7369 7265 6420 6b65 792e  the desired key.
│ │ │ │ -000418d0: 2020 466f 7220 6578 616d 706c 652c 2069    For example, i
│ │ │ │ -000418e0: 660a 2020 2020 2079 6f75 2077 616e 7420  f.     you want 
│ │ │ │ -000418f0: 746f 206d 6f64 6966 7920 7468 6520 696e  to modify the in
│ │ │ │ -00041900: 666f 726d 6174 696f 6e20 7374 6f72 6564  formation stored
│ │ │ │ -00041910: 2061 626f 7574 2061 2075 6e69 7175 6520   about a unique 
│ │ │ │ -00041920: 6b65 7920 6f66 0a20 2020 2020 6574 7970  key of.     etyp
│ │ │ │ -00041930: 6520 332c 2069 2e65 2e2c 2044 4553 2d43  e 3, i.e., DES-C
│ │ │ │ -00041940: 4243 2d4d 4435 2c20 7468 656e 2073 6574  BC-MD5, then set
│ │ │ │ -00041950: 2074 6865 2066 6965 6c64 204b 4559 2d3e   the field KEY->
│ │ │ │ -00041960: 6574 7970 6520 746f 2033 2c0a 2020 2020  etype to 3,.    
│ │ │ │ -00041970: 206c 6561 7669 6e67 2061 6c6c 206f 7468   leaving all oth
│ │ │ │ -00041980: 6572 2066 6965 6c64 7320 6173 207a 6572  er fields as zer
│ │ │ │ -00041990: 6f2e 0a0a 2020 2020 202a 5265 7475 726e  o...     *Return
│ │ │ │ -000419a0: 2076 616c 7565 3a2a 2052 6574 7572 6e73   value:* Returns
│ │ │ │ -000419b0: 20e2 8098 5348 4953 415f 4f4b e280 9920   ...SHISA_OK... 
│ │ │ │ -000419c0: 6f6e 2073 7563 6365 7373 2c20 e280 9853  on success, ...S
│ │ │ │ -000419d0: 4849 5341 5f4e 4f5f 4b45 59e2 8099 2069  HISA_NO_KEY... i
│ │ │ │ -000419e0: 6620 6e6f 0a20 2020 2020 6b65 7920 636f  f no.     key co
│ │ │ │ -000419f0: 756c 6420 6265 206c 6f63 6174 6564 2c20  uld be located, 
│ │ │ │ -00041a00: e280 9853 4849 5341 5f4d 554c 5449 504c  ...SHISA_MULTIPL
│ │ │ │ -00041a10: 455f 4b45 595f 4d41 5443 48e2 8099 2069  E_KEY_MATCH... i
│ │ │ │ -00041a20: 6620 6d6f 7265 2074 6861 6e20 610a 2020  f more than a.  
│ │ │ │ -00041a30: 2020 2073 696e 676c 6520 6b65 7920 6d61     single key ma
│ │ │ │ -00041a40: 7463 6865 6420 7468 6520 6769 7665 6e20  tched the given 
│ │ │ │ -00041a50: 6372 6974 6572 6961 2c20 6f72 2061 6e20  criteria, or an 
│ │ │ │ -00041a60: 6572 726f 7220 636f 6465 206f 7468 6572  error code other
│ │ │ │ -00041a70: 7769 7365 2e0a 0a73 6869 7361 5f6b 6579  wise...shisa_key
│ │ │ │ -00041a80: 5f72 656d 6f76 650a 2d2d 2d2d 2d2d 2d2d  _remove.--------
│ │ │ │ -00041a90: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 4675  --------.. -- Fu
│ │ │ │ -00041aa0: 6e63 7469 6f6e 3a20 696e 7420 7368 6973  nction: int shis
│ │ │ │ -00041ab0: 615f 6b65 795f 7265 6d6f 7665 2028 5368  a_key_remove (Sh
│ │ │ │ -00041ac0: 6973 6120 2a20 4442 482c 2063 6f6e 7374  isa * DBH, const
│ │ │ │ -00041ad0: 2063 6861 7220 2a20 5245 414c 4d2c 0a20   char * REALM,. 
│ │ │ │ -00041ae0: 2020 2020 2020 2020 2063 6f6e 7374 2063           const c
│ │ │ │ -00041af0: 6861 7220 2a20 5052 494e 4349 5041 4c2c  har * PRINCIPAL,
│ │ │ │ -00041b00: 2063 6f6e 7374 2053 6869 7361 5f6b 6579   const Shisa_key
│ │ │ │ -00041b10: 202a 204b 4559 290a 2020 2020 2044 4248   * KEY).     DBH
│ │ │ │ -00041b20: 3a20 5368 6973 6120 6c69 6272 6172 7920  : Shisa library 
│ │ │ │ -00041b30: 6861 6e64 6c65 2063 7265 6174 6564 2062  handle created b
│ │ │ │ -00041b40: 7920 e280 9873 6869 7361 2829 e280 992e  y ...shisa()....
│ │ │ │ -00041b50: 0a20 2020 2020 5245 414c 4d3a 204e 616d  .     REALM: Nam
│ │ │ │ -00041b60: 6520 6f66 2074 6865 2072 6561 6c6d 2074  e of the realm t
│ │ │ │ -00041b70: 6865 2070 7269 6e63 6970 616c 2062 656c  he principal bel
│ │ │ │ -00041b80: 6f6e 6773 2074 6f2e 0a20 2020 2020 5052  ongs to..     PR
│ │ │ │ -00041b90: 494e 4349 5041 4c3a 204e 616d 6520 6f66  INCIPAL: Name of
│ │ │ │ -00041ba0: 2074 6865 2070 7269 6e63 6970 616c 2077   the principal w
│ │ │ │ -00041bb0: 686f 7365 206b 6579 2069 7320 746f 2062  hose key is to b
│ │ │ │ -00041bc0: 6520 7265 6d6f 7665 642e 0a20 2020 2020  e removed..     
│ │ │ │ -00041bd0: 4b45 593a 2050 6f69 6e74 6572 2074 6f20  KEY: Pointer to 
│ │ │ │ -00041be0: 6120 5368 6973 6120 6b65 7920 7374 7275  a Shisa key stru
│ │ │ │ -00041bf0: 6374 7572 6520 7769 7468 2068 696e 7473  cture with hints
│ │ │ │ -00041c00: 206f 6e20 6d61 7463 6869 6e67 0a20 2020   on matching.   
│ │ │ │ -00041c10: 2020 6372 6974 6572 6961 2066 6f72 2074    criteria for t
│ │ │ │ -00041c20: 6865 206b 6579 2074 6f20 7365 6c65 6374  he key to select
│ │ │ │ -00041c30: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ -00041c40: 7469 6f6e 3a2a 2052 656d 6f76 6573 2066  tion:* Removes f
│ │ │ │ -00041c50: 726f 6d20 7468 6520 5368 6973 6120 6461  rom the Shisa da
│ │ │ │ -00041c60: 7461 6261 7365 2061 206b 6579 2c20 6d61  tabase a key, ma
│ │ │ │ -00041c70: 7463 6869 6e67 2074 6865 0a20 2020 2020  tching the.     
│ │ │ │ -00041c80: 6869 6e74 7320 696e 204b 4559 2c20 666f  hints in KEY, fo
│ │ │ │ -00041c90: 7220 7468 6520 7573 6572 2050 5249 4e43  r the user PRINC
│ │ │ │ -00041ca0: 4950 414c 4052 4541 4c4d 2e20 4e6f 7420  IPAL@REALM. Not 
│ │ │ │ -00041cb0: 616c 6c20 656c 656d 656e 7473 206f 6620  all elements of 
│ │ │ │ -00041cc0: 4b45 590a 2020 2020 206e 6565 6420 746f  KEY.     need to
│ │ │ │ -00041cd0: 2062 6520 6669 6c6c 6564 2069 6e2c 206f   be filled in, o
│ │ │ │ -00041ce0: 6e6c 7920 7468 6f73 6520 7265 6c65 7661  nly those releva
│ │ │ │ -00041cf0: 6e74 2074 6f20 6c6f 6361 7465 2074 6865  nt to locate the
│ │ │ │ -00041d00: 206b 6579 0a20 2020 2020 756e 6971 7565   key.     unique
│ │ │ │ -00041d10: 6c79 2e0a 0a20 2020 2020 466f 7220 6578  ly...     For ex
│ │ │ │ -00041d20: 616d 706c 652c 2069 6620 796f 7520 7761  ample, if you wa
│ │ │ │ -00041d30: 6e74 2074 6f20 7265 6d6f 7665 2074 6865  nt to remove the
│ │ │ │ -00041d40: 206f 6e6c 7920 6b65 7920 6f66 2065 7479   only key of ety
│ │ │ │ -00041d50: 7065 2033 2c20 692e 652e 2c0a 2020 2020  pe 3, i.e.,.    
│ │ │ │ -00041d60: 2044 4553 2d43 4243 2d4d 4435 2c20 7468   DES-CBC-MD5, th
│ │ │ │ -00041d70: 656e 2073 6574 2074 6865 2066 6965 6c64  en set the field
│ │ │ │ -00041d80: 204b 4559 2d3e 6574 7970 6520 746f 2033   KEY->etype to 3
│ │ │ │ -00041d90: 2c20 616e 6420 616c 6c20 6f74 6865 720a  , and all other.
│ │ │ │ -00041da0: 2020 2020 2066 6965 6c64 7320 746f 207a       fields to z
│ │ │ │ -00041db0: 6572 6f2e 0a0a 2020 2020 202a 5265 7475  ero...     *Retu
│ │ │ │ -00041dc0: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ -00041dd0: 6e73 20e2 8098 5348 4953 415f 4f4b e280  ns ...SHISA_OK..
│ │ │ │ -00041de0: 9920 6f6e 2073 7563 6365 7373 2c20 e280  . on success, ..
│ │ │ │ -00041df0: 9853 4849 5341 5f4e 4f5f 4b45 59e2 8099  .SHISA_NO_KEY...
│ │ │ │ -00041e00: 2069 6620 6e6f 0a20 2020 2020 6b65 7920   if no.     key 
│ │ │ │ -00041e10: 636f 756c 6420 6265 206c 6f63 6174 6564  could be located
│ │ │ │ -00041e20: 2c20 e280 9853 4849 5341 5f4d 554c 5449  , ...SHISA_MULTI
│ │ │ │ -00041e30: 504c 455f 4b45 595f 4d41 5443 48e2 8099  PLE_KEY_MATCH...
│ │ │ │ -00041e40: 2069 6620 6d6f 7265 2074 6861 6e20 6f6e   if more than on
│ │ │ │ -00041e50: 650a 2020 2020 206b 6579 206d 6174 6368  e.     key match
│ │ │ │ -00041e60: 6564 2074 6865 2067 6976 656e 2063 7269  ed the given cri
│ │ │ │ -00041e70: 7465 7269 612c 206f 7220 616e 2065 7272  teria, or an err
│ │ │ │ -00041e80: 6f72 2063 6f64 6520 6f74 6865 7277 6973  or code otherwis
│ │ │ │ -00041e90: 652e 0a0a 7368 6973 615f 6b65 795f 6672  e...shisa_key_fr
│ │ │ │ -00041ea0: 6565 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ee.-------------
│ │ │ │ -00041eb0: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ -00041ec0: 2076 6f69 6420 7368 6973 615f 6b65 795f   void shisa_key_
│ │ │ │ -00041ed0: 6672 6565 2028 5368 6973 6120 2a20 4442  free (Shisa * DB
│ │ │ │ -00041ee0: 482c 2053 6869 7361 5f6b 6579 202a 204b  H, Shisa_key * K
│ │ │ │ -00041ef0: 4559 290a 2020 2020 2044 4248 3a20 5368  EY).     DBH: Sh
│ │ │ │ -00041f00: 6973 6120 6c69 6272 6172 7920 6861 6e64  isa library hand
│ │ │ │ -00041f10: 6c65 2063 7265 6174 6564 2062 7920 e280  le created by ..
│ │ │ │ -00041f20: 9873 6869 7361 2829 e280 992e 0a20 2020  .shisa().....   
│ │ │ │ -00041f30: 2020 4b45 593a 2050 6f69 6e74 6572 2074    KEY: Pointer t
│ │ │ │ -00041f40: 6f20 6120 5368 6973 6120 6b65 7920 7374  o a Shisa key st
│ │ │ │ -00041f50: 7275 6374 7572 6520 746f 2064 6561 6c6c  ructure to deall
│ │ │ │ -00041f60: 6f63 6174 652e 0a0a 2020 2020 202a 4465  ocate...     *De
│ │ │ │ -00041f70: 7363 7269 7074 696f 6e3a 2a20 4465 616c  scription:* Deal
│ │ │ │ -00041f80: 6c6f 6361 7465 7320 7468 6520 6669 656c  locates the fiel
│ │ │ │ -00041f90: 6473 206f 6620 6120 5368 6973 6120 6b65  ds of a Shisa ke
│ │ │ │ -00041fa0: 7920 7374 7275 6374 7572 652c 2061 730a  y structure, as.
│ │ │ │ -00041fb0: 2020 2020 2077 656c 6c20 6173 2074 6865       well as the
│ │ │ │ -00041fc0: 2073 7472 7563 7475 7265 2069 7473 656c   structure itsel
│ │ │ │ -00041fd0: 662e 0a0a 7368 6973 615f 6b65 7973 5f66  f...shisa_keys_f
│ │ │ │ -00041fe0: 7265 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ree.------------
│ │ │ │ -00041ff0: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ -00042000: 6e3a 2076 6f69 6420 7368 6973 615f 6b65  n: void shisa_ke
│ │ │ │ -00042010: 7973 5f66 7265 6520 2853 6869 7361 202a  ys_free (Shisa *
│ │ │ │ -00042020: 2044 4248 2c20 5368 6973 615f 6b65 7920   DBH, Shisa_key 
│ │ │ │ -00042030: 2a2a 204b 4559 532c 0a20 2020 2020 2020  ** KEYS,.       
│ │ │ │ -00042040: 2020 2073 697a 655f 7420 4e4b 4559 5329     size_t NKEYS)
│ │ │ │ -00042050: 0a20 2020 2020 4442 483a 2053 6869 7361  .     DBH: Shisa
│ │ │ │ -00042060: 206c 6962 7261 7279 2068 616e 646c 6520   library handle 
│ │ │ │ -00042070: 6372 6561 7465 6420 6279 20e2 8098 7368  created by ...sh
│ │ │ │ -00042080: 6973 6128 29e2 8099 2e0a 2020 2020 204b  isa().....     K
│ │ │ │ -00042090: 4559 533a 2050 6f69 6e74 6572 2074 6f20  EYS: Pointer to 
│ │ │ │ -000420a0: 616e 2061 7272 6179 206f 6620 5368 6973  an array of Shis
│ │ │ │ -000420b0: 6120 6b65 7920 7374 7275 6374 7572 6573  a key structures
│ │ │ │ -000420c0: 2e0a 2020 2020 204e 4b45 5953 3a20 4e75  ..     NKEYS: Nu
│ │ │ │ -000420d0: 6d62 6572 206f 6620 6b65 7920 656c 656d  mber of key elem
│ │ │ │ -000420e0: 656e 7473 2069 6e20 7468 6520 6172 7261  ents in the arra
│ │ │ │ -000420f0: 7920 4b45 5953 2e0a 0a20 2020 2020 2a44  y KEYS...     *D
│ │ │ │ -00042100: 6573 6372 6970 7469 6f6e 3a2a 2044 6561  escription:* Dea
│ │ │ │ -00042110: 6c6c 6f63 6174 6573 2065 6163 6820 6b65  llocates each ke
│ │ │ │ -00042120: 7920 656c 656d 656e 7420 696e 2074 6865  y element in the
│ │ │ │ -00042130: 2061 7272 6179 204b 4559 5320 6f66 0a20   array KEYS of. 
│ │ │ │ -00042140: 2020 2020 5368 6973 6120 6461 7461 6261      Shisa databa
│ │ │ │ -00042150: 7365 206b 6579 732c 2075 7369 6e67 2072  se keys, using r
│ │ │ │ -00042160: 6570 6561 7465 6420 6361 6c6c 7320 746f  epeated calls to
│ │ │ │ -00042170: 20e2 8098 7368 6973 615f 6b65 795f 6672   ...shisa_key_fr
│ │ │ │ -00042180: 6565 2829 e280 992e 0a0a 2020 2045 7272  ee()......   Err
│ │ │ │ -00042190: 6f72 2068 616e 646c 696e 6720 6973 2073  or handling is s
│ │ │ │ -000421a0: 696d 696c 6172 2074 6f20 7468 6174 2066  imilar to that f
│ │ │ │ -000421b0: 6f72 2053 6869 7368 6920 696e 2067 656e  or Shishi in gen
│ │ │ │ -000421c0: 6572 616c 2028 2a6e 6f74 6520 4572 726f  eral (*note Erro
│ │ │ │ -000421d0: 720a 4861 6e64 6c69 6e67 3a3a 292c 2069  r.Handling::), i
│ │ │ │ -000421e0: 2e65 2e2c 2079 6f75 2069 6e76 6f6b 6520  .e., you invoke 
│ │ │ │ -000421f0: e280 9873 6869 7361 5f73 7472 6572 726f  ...shisa_strerro
│ │ │ │ -00042200: 72e2 8099 206f 6e20 7468 6520 696e 7465  r... on the inte
│ │ │ │ -00042210: 6765 7220 7265 7475 726e 0a76 616c 7565  ger return.value
│ │ │ │ -00042220: 2072 6563 6569 7665 6420 6279 2073 6f6d   received by som
│ │ │ │ -00042230: 6520 6675 6e63 7469 6f6e 2c20 6966 2074  e function, if t
│ │ │ │ -00042240: 6865 2072 6574 7572 6e20 7661 6c75 6520  he return value 
│ │ │ │ -00042250: 6973 206e 6f6e 2d7a 6572 6f2e 2020 4265  is non-zero.  Be
│ │ │ │ -00042260: 6c6f 770a 6973 2074 6865 2063 6f6d 706c  low.is the compl
│ │ │ │ -00042270: 6574 6520 696e 7465 7266 6163 652e 0a0a  ete interface...
│ │ │ │ -00042280: 7368 6973 615f 7374 7265 7272 6f72 0a2d  shisa_strerror.-
│ │ │ │ -00042290: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20  -------------.. 
│ │ │ │ -000422a0: 2d2d 2046 756e 6374 696f 6e3a 2063 6f6e  -- Function: con
│ │ │ │ -000422b0: 7374 2063 6861 7220 2a20 7368 6973 615f  st char * shisa_
│ │ │ │ -000422c0: 7374 7265 7272 6f72 2028 696e 7420 4552  strerror (int ER
│ │ │ │ -000422d0: 5229 0a20 2020 2020 4552 523a 2053 6869  R).     ERR: Shi
│ │ │ │ -000422e0: 7361 2065 7272 6f72 2063 6f64 652e 0a0a  sa error code...
│ │ │ │ -000422f0: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ -00042300: 6e3a 2a20 4578 706c 6169 6e73 2076 6572  n:* Explains ver
│ │ │ │ -00042310: 6261 6c6c 7920 616e 2065 7272 6f72 2073  bally an error s
│ │ │ │ -00042320: 7461 7475 7320 4552 522e 2020 5468 6520  tatus ERR.  The 
│ │ │ │ -00042330: 7265 7475 726e 6564 0a20 2020 2020 7374  returned.     st
│ │ │ │ -00042340: 7269 6e67 2063 616e 2062 6520 7573 6564  ring can be used
│ │ │ │ -00042350: 2074 6f20 636f 6d70 6f73 6520 6120 6469   to compose a di
│ │ │ │ -00042360: 6167 6e6f 7374 6963 206d 6573 7361 6765  agnostic message
│ │ │ │ -00042370: 206f 6620 6265 6e65 6669 7420 746f 2061   of benefit to a
│ │ │ │ -00042380: 0a20 2020 2020 7573 6572 2e0a 0a20 2020  .     user...   
│ │ │ │ -00042390: 2020 2a52 6574 7572 6e20 7661 6c75 653a    *Return value:
│ │ │ │ -000423a0: 2a20 5265 7475 726e 7320 6120 706f 696e  * Returns a poin
│ │ │ │ -000423b0: 7465 7220 746f 2061 2073 7461 7469 6361  ter to a statica
│ │ │ │ -000423c0: 6c6c 7920 616c 6c6f 6361 7465 6420 7374  lly allocated st
│ │ │ │ -000423d0: 7269 6e67 2c0a 2020 2020 2063 6f6e 7461  ring,.     conta
│ │ │ │ -000423e0: 696e 696e 6720 6120 6465 7363 7269 7074  ining a descript
│ │ │ │ -000423f0: 696f 6e20 6f66 2074 6865 2065 7272 6f72  ion of the error
│ │ │ │ -00042400: 2067 6976 656e 2061 7320 696e 7075 7420   given as input 
│ │ │ │ -00042410: 6172 6775 6d65 6e74 2e0a 0a73 6869 7361  argument...shisa
│ │ │ │ -00042420: 5f69 6e66 6f0a 2d2d 2d2d 2d2d 2d2d 2d2d  _info.----------
│ │ │ │ -00042430: 0a0a 202d 2d20 4675 6e63 7469 6f6e 3a20  .. -- Function: 
│ │ │ │ -00042440: 766f 6964 2073 6869 7361 5f69 6e66 6f20  void shisa_info 
│ │ │ │ -00042450: 2853 6869 7361 202a 2044 4248 2c20 636f  (Shisa * DBH, co
│ │ │ │ -00042460: 6e73 7420 6368 6172 202a 2046 4f52 4d41  nst char * FORMA
│ │ │ │ -00042470: 542c 202e 2e2e 290a 2020 2020 2044 4248  T, ...).     DBH
│ │ │ │ -00042480: 3a20 5368 6973 6120 6c69 6272 6172 7920  : Shisa library 
│ │ │ │ -00042490: 6861 6e64 6c65 2063 7265 6174 6564 2062  handle created b
│ │ │ │ -000424a0: 7920 e280 9873 6869 7361 2829 e280 992e  y ...shisa()....
│ │ │ │ -000424b0: 0a20 2020 2020 464f 524d 4154 3a20 7072  .     FORMAT: pr
│ │ │ │ -000424c0: 696e 7466 2073 7479 6c65 2066 6f72 6d61  intf style forma
│ │ │ │ -000424d0: 7420 7374 7269 6e67 2e0a 2020 2020 202e  t string..     .
│ │ │ │ -000424e0: 2e2e 3a20 7072 696e 7466 2073 7479 6c65  ..: printf style
│ │ │ │ -000424f0: 2061 7267 756d 656e 7473 2e0a 0a20 2020   arguments...   
│ │ │ │ -00042500: 2020 2a44 6573 6372 6970 7469 6f6e 3a2a    *Description:*
│ │ │ │ -00042510: 2050 7269 6e74 7320 616e 2069 6e66 6f72   Prints an infor
│ │ │ │ -00042520: 6d61 7469 6f6e 616c 206d 6573 7361 6765  mational message
│ │ │ │ -00042530: 2074 6f20 7374 616e 6461 7264 2065 7272   to standard err
│ │ │ │ -00042540: 6f72 2e0a 2020 2020 2054 6865 2074 6578  or..     The tex
│ │ │ │ -00042550: 7420 6973 2063 6f6d 706f 7365 6420 6672  t is composed fr
│ │ │ │ -00042560: 6f6d 2074 6865 2061 7267 756d 656e 7473  om the arguments
│ │ │ │ -00042570: 2c20 6c69 6b65 2070 7269 6e74 6628 3329  , like printf(3)
│ │ │ │ -00042580: 2e0a 0a1f 0a46 696c 653a 2073 6869 7368  .....File: shish
│ │ │ │ -00042590: 692e 696e 666f 2c20 204e 6f64 653a 2047  i.info,  Node: G
│ │ │ │ -000425a0: 656e 6572 6963 2053 6563 7572 6974 7920  eneric Security 
│ │ │ │ -000425b0: 5365 7276 6963 652c 2020 5072 6576 3a20  Service,  Prev: 
│ │ │ │ -000425c0: 4b65 7262 6572 6f73 2044 6174 6162 6173  Kerberos Databas
│ │ │ │ -000425d0: 6520 4675 6e63 7469 6f6e 732c 2020 5570  e Functions,  Up
│ │ │ │ -000425e0: 3a20 5072 6f67 7261 6d6d 696e 6720 4d61  : Programming Ma
│ │ │ │ -000425f0: 6e75 616c 0a0a 352e 3230 2047 656e 6572  nual..5.20 Gener
│ │ │ │ -00042600: 6963 2053 6563 7572 6974 7920 5365 7276  ic Security Serv
│ │ │ │ -00042610: 6963 650a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ice.============
│ │ │ │ +0003f510: 2d2d 2d0a 0a20 2d2d 2046 756e 6374 696f  ---.. -- Functio
│ │ │ │ +0003f520: 6e3a 2063 6f6e 7374 2063 6861 7220 2a20  n: const char * 
│ │ │ │ +0003f530: 7368 6973 615f 6366 675f 6465 6661 756c  shisa_cfg_defaul
│ │ │ │ +0003f540: 745f 7379 7374 656d 6669 6c65 2028 5368  t_systemfile (Sh
│ │ │ │ +0003f550: 6973 6120 2a20 4442 4829 0a20 2020 2020  isa * DBH).     
│ │ │ │ +0003f560: 4442 483a 2053 6869 7361 206c 6962 7261  DBH: Shisa libra
│ │ │ │ +0003f570: 7279 2068 616e 646c 6520 6372 6561 7465  ry handle create
│ │ │ │ +0003f580: 6420 6279 20e2 8098 7368 6973 6128 29e2  d by ...shisa().
│ │ │ │ +0003f590: 8099 2e0a 0a20 2020 2020 2a44 6573 6372  .....     *Descr
│ │ │ │ +0003f5a0: 6970 7469 6f6e 3a2a 2046 6574 6368 6573  iption:* Fetches
│ │ │ │ +0003f5b0: 2069 6e66 6f72 6d61 7469 6f6e 206f 6e20   information on 
│ │ │ │ +0003f5c0: 7468 6520 696e 7374 616c 6c65 6420 636f  the installed co
│ │ │ │ +0003f5d0: 6e66 6967 7572 6174 696f 6e2e 0a0a 2020  nfiguration...  
│ │ │ │ +0003f5e0: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ +0003f5f0: 3a2a 2052 6574 7572 6e73 2066 696c 6520  :* Returns file 
│ │ │ │ +0003f600: 6e61 6d65 206f 6620 7468 6520 6163 7469  name of the acti
│ │ │ │ +0003f610: 7665 2073 7973 7465 6d0a 2020 2020 2063  ve system.     c
│ │ │ │ +0003f620: 6f6e 6669 6775 7261 7469 6f6e 2e0a 0a20  onfiguration... 
│ │ │ │ +0003f630: 2020 5468 6520 636f 7265 2070 6172 7420    The core part 
│ │ │ │ +0003f640: 6f66 2074 6865 2053 6869 7361 2069 6e74  of the Shisa int
│ │ │ │ +0003f650: 6572 6661 6365 2066 6f6c 6c6f 7773 2e20  erface follows. 
│ │ │ │ +0003f660: 2054 6865 2074 7970 6963 616c 2070 726f   The typical pro
│ │ │ │ +0003f670: 6365 6475 7265 0a69 7320 746f 2075 7365  cedure.is to use
│ │ │ │ +0003f680: 20e2 8098 7368 6973 615f 7072 696e 6369   ...shisa_princi
│ │ │ │ +0003f690: 7061 6c5f 6669 6e64 e280 9920 746f 2076  pal_find... to v
│ │ │ │ +0003f6a0: 6572 6966 7920 7468 6174 2061 2073 7065  erify that a spe
│ │ │ │ +0003f6b0: 6369 6669 6320 7072 696e 6369 7061 6c0a  cific principal.
│ │ │ │ +0003f6c0: 6578 6973 7473 2c20 616e 6420 746f 2065  exists, and to e
│ │ │ │ +0003f6d0: 7874 7261 6374 2073 6f6d 6520 696e 666f  xtract some info
│ │ │ │ +0003f6e0: 726d 6174 696f 6e20 6162 6f75 7420 6974  rmation about it
│ │ │ │ +0003f6f0: 2c20 616e 6420 7468 656e 2075 7365 0ae2  , and then use..
│ │ │ │ +0003f700: 8098 7368 6973 615f 6b65 7973 5f66 696e  ..shisa_keys_fin
│ │ │ │ +0003f710: 64e2 8099 2074 6f20 6765 7420 7468 6520  d... to get the 
│ │ │ │ +0003f720: 6372 7970 746f 6772 6170 6869 6320 6b65  cryptographic ke
│ │ │ │ +0003f730: 7973 2066 6f72 2074 6865 2070 7269 6e63  ys for the princ
│ │ │ │ +0003f740: 6970 616c 2c0a 7573 7561 6c6c 7920 7375  ipal,.usually su
│ │ │ │ +0003f750: 7070 6c69 7969 6e67 2073 6f6d 6520 6869  ppliying some hi
│ │ │ │ +0003f760: 6e74 7320 6173 2074 6f20 7768 6963 6820  nts as to which 
│ │ │ │ +0003f770: 6f66 2061 6c6c 206b 6579 7320 796f 7520  of all keys you 
│ │ │ │ +0003f780: 6172 6520 696e 7465 7265 7374 6564 0a69  are interested.i
│ │ │ │ +0003f790: 6e20 2865 2e67 2e2c 206b 6579 2076 6572  n (e.g., key ver
│ │ │ │ +0003f7a0: 7369 6f6e 206e 756d 6265 7220 616e 6420  sion number and 
│ │ │ │ +0003f7b0: 656e 6372 7970 7469 6f6e 2061 6c67 6f72  encryption algor
│ │ │ │ +0003f7c0: 6974 686d 206e 756d 6265 7229 2e0a 0a73  ithm number)...s
│ │ │ │ +0003f7d0: 6869 7361 5f65 6e75 6d65 7261 7465 5f72  hisa_enumerate_r
│ │ │ │ +0003f7e0: 6561 6c6d 730a 2d2d 2d2d 2d2d 2d2d 2d2d  ealms.----------
│ │ │ │ +0003f7f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ +0003f800: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ +0003f810: 7368 6973 615f 656e 756d 6572 6174 655f  shisa_enumerate_
│ │ │ │ +0003f820: 7265 616c 6d73 2028 5368 6973 6120 2a20  realms (Shisa * 
│ │ │ │ +0003f830: 4442 482c 2063 6861 7220 2a2a 2a20 5245  DBH, char *** RE
│ │ │ │ +0003f840: 414c 4d53 2c0a 2020 2020 2020 2020 2020  ALMS,.          
│ │ │ │ +0003f850: 7369 7a65 5f74 202a 204e 5245 414c 4d53  size_t * NREALMS
│ │ │ │ +0003f860: 290a 2020 2020 2044 4248 3a20 5368 6973  ).     DBH: Shis
│ │ │ │ +0003f870: 6120 6c69 6272 6172 7920 6861 6e64 6c65  a library handle
│ │ │ │ +0003f880: 2063 7265 6174 6564 2062 7920 e280 9873   created by ...s
│ │ │ │ +0003f890: 6869 7361 2829 e280 992e 0a20 2020 2020  hisa().....     
│ │ │ │ +0003f8a0: 5245 414c 4d53 3a20 5265 7475 726e 6564  REALMS: Returned
│ │ │ │ +0003f8b0: 2070 6f69 6e74 6572 2074 6f20 6120 6e65   pointer to a ne
│ │ │ │ +0003f8c0: 776c 7920 616c 6c6f 6361 7465 6420 6172  wly allocated ar
│ │ │ │ +0003f8d0: 7261 7920 6f66 2061 6c73 6f0a 2020 2020  ray of also.    
│ │ │ │ +0003f8e0: 2061 6c6c 6f63 6174 6564 2061 6e64 206e   allocated and n
│ │ │ │ +0003f8f0: 756c 6c2d 7465 726d 696e 6174 6564 2055  ull-terminated U
│ │ │ │ +0003f900: 5446 2d38 2073 7472 696e 6773 2077 6974  TF-8 strings wit
│ │ │ │ +0003f910: 6820 7265 616c 6d20 6e61 6d65 732e 0a20  h realm names.. 
│ │ │ │ +0003f920: 2020 2020 4e52 4541 4c4d 533a 2050 6f69      NREALMS: Poi
│ │ │ │ +0003f930: 6e74 6572 2074 6f20 6120 6e75 6d62 6572  nter to a number
│ │ │ │ +0003f940: 2077 6869 6368 2069 7320 7570 6461 7465   which is update
│ │ │ │ +0003f950: 6420 7769 7468 2074 6865 206e 756d 6265  d with the numbe
│ │ │ │ +0003f960: 7220 6f66 0a20 2020 2020 6a75 7374 2061  r of.     just a
│ │ │ │ +0003f970: 6c6c 6f63 6174 6564 2061 6e64 2072 6574  llocated and ret
│ │ │ │ +0003f980: 7572 6e65 6420 7265 616c 6d20 7374 7269  urned realm stri
│ │ │ │ +0003f990: 6e67 732e 0a0a 2020 2020 202a 4465 7363  ngs...     *Desc
│ │ │ │ +0003f9a0: 7269 7074 696f 6e3a 2a20 4578 7472 6163  ription:* Extrac
│ │ │ │ +0003f9b0: 7473 2061 206c 6973 7420 6f66 2061 6c6c  ts a list of all
│ │ │ │ +0003f9c0: 2072 6561 6c6d 206e 616d 6573 2069 6e20   realm names in 
│ │ │ │ +0003f9d0: 6261 636b 656e 642c 2061 730a 2020 2020  backend, as.    
│ │ │ │ +0003f9e0: 206e 756c 6c2d 7465 726d 696e 6174 6564   null-terminated
│ │ │ │ +0003f9f0: 2055 5446 2d38 2073 7472 696e 6773 2e20   UTF-8 strings. 
│ │ │ │ +0003fa00: 2054 6865 2063 616c 6c65 7220 6973 2072   The caller is r
│ │ │ │ +0003fa10: 6573 706f 6e73 6962 6c65 2066 6f72 0a20  esponsible for. 
│ │ │ │ +0003fa20: 2020 2020 6465 616c 6c6f 6361 7469 6e67      deallocating
│ │ │ │ +0003fa30: 2061 6c6c 2073 7472 696e 6773 2061 7320   all strings as 
│ │ │ │ +0003fa40: 7765 6c6c 2061 7320 7468 6520 6172 7261  well as the arra
│ │ │ │ +0003fa50: 7920 2a52 4541 4c4d 532e 0a0a 2020 2020  y *REALMS...    
│ │ │ │ +0003fa60: 202a 5265 7475 726e 2076 616c 7565 3a2a   *Return value:*
│ │ │ │ +0003fa70: 2052 6574 7572 6e73 20e2 8098 5348 4953   Returns ...SHIS
│ │ │ │ +0003fa80: 415f 4f4b e280 9920 6f6e 2073 7563 6365  A_OK... on succe
│ │ │ │ +0003fa90: 7373 2c20 6f72 2061 6e20 6572 726f 7220  ss, or an error 
│ │ │ │ +0003faa0: 636f 6465 2e0a 0a73 6869 7361 5f65 6e75  code...shisa_enu
│ │ │ │ +0003fab0: 6d65 7261 7465 5f70 7269 6e63 6970 616c  merate_principal
│ │ │ │ +0003fac0: 730a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  s.--------------
│ │ │ │ +0003fad0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d  ------------.. -
│ │ │ │ +0003fae0: 2d20 4675 6e63 7469 6f6e 3a20 696e 7420  - Function: int 
│ │ │ │ +0003faf0: 7368 6973 615f 656e 756d 6572 6174 655f  shisa_enumerate_
│ │ │ │ +0003fb00: 7072 696e 6369 7061 6c73 2028 5368 6973  principals (Shis
│ │ │ │ +0003fb10: 6120 2a20 4442 482c 0a20 2020 2020 2020  a * DBH,.       
│ │ │ │ +0003fb20: 2020 2063 6f6e 7374 2063 6861 7220 2a20     const char * 
│ │ │ │ +0003fb30: 5245 414c 4d2c 2063 6861 7220 2a2a 2a20  REALM, char *** 
│ │ │ │ +0003fb40: 5052 494e 4349 5041 4c53 2c20 7369 7a65  PRINCIPALS, size
│ │ │ │ +0003fb50: 5f74 202a 204e 5052 494e 4349 5041 4c53  _t * NPRINCIPALS
│ │ │ │ +0003fb60: 290a 2020 2020 2044 4248 3a20 5368 6973  ).     DBH: Shis
│ │ │ │ +0003fb70: 6120 6c69 6272 6172 7920 6861 6e64 6c65  a library handle
│ │ │ │ +0003fb80: 2063 7265 6174 6564 2062 7920 e280 9873   created by ...s
│ │ │ │ +0003fb90: 6869 7361 2829 e280 992e 0a20 2020 2020  hisa().....     
│ │ │ │ +0003fba0: 5245 414c 4d3a 204e 616d 6520 6f66 2072  REALM: Name of r
│ │ │ │ +0003fbb0: 6561 6c6d 2c20 6173 206e 756c 6c2d 7465  ealm, as null-te
│ │ │ │ +0003fbc0: 726d 696e 6174 6564 2055 5446 2d38 2073  rminated UTF-8 s
│ │ │ │ +0003fbd0: 7472 696e 672e 0a20 2020 2020 5052 494e  tring..     PRIN
│ │ │ │ +0003fbe0: 4349 5041 4c53 3a20 5265 7475 726e 6564  CIPALS: Returned
│ │ │ │ +0003fbf0: 2070 6f69 6e74 6572 2074 6f20 6e65 776c   pointer to newl
│ │ │ │ +0003fc00: 7920 616c 6c6f 6361 7465 6420 6172 7261  y allocated arra
│ │ │ │ +0003fc10: 7920 6f66 206a 7573 740a 2020 2020 2061  y of just.     a
│ │ │ │ +0003fc20: 6c6c 6f63 6174 6564 206e 756c 6c2d 7465  llocated null-te
│ │ │ │ +0003fc30: 726d 696e 6174 6564 2055 5446 2d38 2073  rminated UTF-8 s
│ │ │ │ +0003fc40: 7472 696e 6773 2077 6974 6820 7072 696e  trings with prin
│ │ │ │ +0003fc50: 6369 7061 6c20 6e61 6d65 732e 0a20 2020  cipal names..   
│ │ │ │ +0003fc60: 2020 4e50 5249 4e43 4950 414c 533a 2050    NPRINCIPALS: P
│ │ │ │ +0003fc70: 6f69 6e74 6572 2074 6f20 616e 2069 6e74  ointer to an int
│ │ │ │ +0003fc80: 6567 6572 2075 7064 6174 6564 2077 6974  eger updated wit
│ │ │ │ +0003fc90: 6820 7468 6520 6e75 6d62 6572 206f 6620  h the number of 
│ │ │ │ +0003fca0: 6a75 7374 0a20 2020 2020 616c 6c6f 6361  just.     alloca
│ │ │ │ +0003fcb0: 7465 6420 616e 6420 7265 7475 726e 6564  ted and returned
│ │ │ │ +0003fcc0: 2070 7269 6e63 6970 616c 206e 616d 6573   principal names
│ │ │ │ +0003fcd0: 2e0a 0a20 2020 2020 2a44 6573 6372 6970  ...     *Descrip
│ │ │ │ +0003fce0: 7469 6f6e 3a2a 2045 7874 7261 6374 7320  tion:* Extracts 
│ │ │ │ +0003fcf0: 6120 6c69 7374 206f 6620 616c 6c20 7072  a list of all pr
│ │ │ │ +0003fd00: 696e 6369 7061 6c20 6e61 6d65 7320 696e  incipal names in
│ │ │ │ +0003fd10: 2062 6163 6b65 6e64 0a20 2020 2020 6265   backend.     be
│ │ │ │ +0003fd20: 6c6f 6e67 696e 6720 746f 2074 6865 2072  longing to the r
│ │ │ │ +0003fd30: 6561 6c6d 2052 4541 4c4d 2c20 6173 206e  ealm REALM, as n
│ │ │ │ +0003fd40: 756c 6c2d 7465 726d 696e 6174 6564 2055  ull-terminated U
│ │ │ │ +0003fd50: 5446 2d38 2073 7472 696e 6773 2e0a 2020  TF-8 strings..  
│ │ │ │ +0003fd60: 2020 2054 6865 2063 616c 6c65 7220 6973     The caller is
│ │ │ │ +0003fd70: 2072 6573 706f 6e73 6962 6c65 2066 6f72   responsible for
│ │ │ │ +0003fd80: 2064 6561 6c6c 6f63 6174 696e 6720 616c   deallocating al
│ │ │ │ +0003fd90: 6c20 7374 7269 6e67 7320 616e 6420 7468  l strings and th
│ │ │ │ +0003fda0: 650a 2020 2020 2061 7272 6179 202a 5052  e.     array *PR
│ │ │ │ +0003fdb0: 494e 4349 5041 4c53 2e0a 0a20 2020 2020  INCIPALS...     
│ │ │ │ +0003fdc0: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ +0003fdd0: 5265 7475 726e 7320 e280 9853 4849 5341  Returns ...SHISA
│ │ │ │ +0003fde0: 5f4f 4be2 8099 206f 6e20 7375 6363 6573  _OK... on succes
│ │ │ │ +0003fdf0: 732c 20e2 8098 5348 4953 415f 4e4f 5f52  s, ...SHISA_NO_R
│ │ │ │ +0003fe00: 4541 4c4d e280 9920 6966 0a20 2020 2020  EALM... if.     
│ │ │ │ +0003fe10: 7468 6520 7370 6563 6966 6965 6420 7265  the specified re
│ │ │ │ +0003fe20: 616c 6d20 646f 6573 206e 6f74 2065 7869  alm does not exi
│ │ │ │ +0003fe30: 7374 2c20 6f72 2061 6e20 6572 726f 7220  st, or an error 
│ │ │ │ +0003fe40: 636f 6465 206f 7468 6572 7769 7365 2e0a  code otherwise..
│ │ │ │ +0003fe50: 0a73 6869 7361 5f70 7269 6e63 6970 616c  .shisa_principal
│ │ │ │ +0003fe60: 5f66 696e 640a 2d2d 2d2d 2d2d 2d2d 2d2d  _find.----------
│ │ │ │ +0003fe70: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +0003fe80: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ +0003fe90: 6973 615f 7072 696e 6369 7061 6c5f 6669  isa_principal_fi
│ │ │ │ +0003fea0: 6e64 2028 5368 6973 6120 2a20 4442 482c  nd (Shisa * DBH,
│ │ │ │ +0003feb0: 2063 6f6e 7374 2063 6861 7220 2a20 5245   const char * RE
│ │ │ │ +0003fec0: 414c 4d2c 0a20 2020 2020 2020 2020 2063  ALM,.          c
│ │ │ │ +0003fed0: 6f6e 7374 2063 6861 7220 2a20 5052 494e  onst char * PRIN
│ │ │ │ +0003fee0: 4349 5041 4c2c 2053 6869 7361 5f70 7269  CIPAL, Shisa_pri
│ │ │ │ +0003fef0: 6e63 6970 616c 202a 2050 4829 0a20 2020  ncipal * PH).   
│ │ │ │ +0003ff00: 2020 4442 483a 2053 6869 7361 206c 6962    DBH: Shisa lib
│ │ │ │ +0003ff10: 7261 7279 2068 616e 646c 6520 6372 6561  rary handle crea
│ │ │ │ +0003ff20: 7465 6420 6279 20e2 8098 7368 6973 6128  ted by ...shisa(
│ │ │ │ +0003ff30: 29e2 8099 2e0a 2020 2020 2052 4541 4c4d  ).....     REALM
│ │ │ │ +0003ff40: 3a20 4e61 6d65 206f 6620 7468 6520 7265  : Name of the re
│ │ │ │ +0003ff50: 616c 6d20 7468 6520 7072 696e 6369 7061  alm the principa
│ │ │ │ +0003ff60: 6c20 6265 6c6f 6e67 7320 746f 2e0a 2020  l belongs to..  
│ │ │ │ +0003ff70: 2020 2050 5249 4e43 4950 414c 3a20 4e61     PRINCIPAL: Na
│ │ │ │ +0003ff80: 6d65 206f 6620 7072 696e 6369 7061 6c20  me of principal 
│ │ │ │ +0003ff90: 746f 2067 6574 2069 6e66 6f72 6d61 7469  to get informati
│ │ │ │ +0003ffa0: 6f6e 2061 626f 7574 2e0a 2020 2020 2050  on about..     P
│ │ │ │ +0003ffb0: 483a 2050 6f69 6e74 6572 2074 6f20 6120  H: Pointer to a 
│ │ │ │ +0003ffc0: 7072 6576 696f 7573 6c79 2061 6c6c 6f63  previously alloc
│ │ │ │ +0003ffd0: 6174 6564 2070 7269 6e63 6970 616c 2073  ated principal s
│ │ │ │ +0003ffe0: 7472 7563 7475 7265 2077 6865 7265 0a20  tructure where. 
│ │ │ │ +0003fff0: 2020 2020 696e 666f 726d 6174 696f 6e20      information 
│ │ │ │ +00040000: 6162 6f75 7420 7468 6520 7072 696e 6369  about the princi
│ │ │ │ +00040010: 7061 6c20 6973 2074 6f20 6265 2073 746f  pal is to be sto
│ │ │ │ +00040020: 7265 642e 0a0a 2020 2020 202a 4465 7363  red...     *Desc
│ │ │ │ +00040030: 7269 7074 696f 6e3a 2a20 4578 7472 6163  ription:* Extrac
│ │ │ │ +00040040: 7473 2069 6e66 6f72 6d61 7469 6f6e 2061  ts information a
│ │ │ │ +00040050: 626f 7574 2067 6976 656e 2074 6865 2050  bout given the P
│ │ │ │ +00040060: 5249 4e43 4950 414c 4052 4541 4c4d 0a20  RINCIPAL@REALM. 
│ │ │ │ +00040070: 2020 2020 7061 6972 2073 656c 6563 7465      pair selecte
│ │ │ │ +00040080: 6420 6279 2050 5249 4e43 4950 414c 2061  d by PRINCIPAL a
│ │ │ │ +00040090: 6e64 2052 4541 4c4d 2e0a 0a20 2020 2020  nd REALM...     
│ │ │ │ +000400a0: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ +000400b0: 5265 7475 726e 7320 e280 9853 4849 5341  Returns ...SHISA
│ │ │ │ +000400c0: 5f4f 4be2 8099 2069 6620 7375 6363 6573  _OK... if succes
│ │ │ │ +000400d0: 7366 756c 2c20 e280 9853 4849 5341 5f4e  sful, ...SHISA_N
│ │ │ │ +000400e0: 4f5f 5245 414c 4de2 8099 0a20 2020 2020  O_REALM....     
│ │ │ │ +000400f0: 6966 2074 6865 2069 6e64 6963 6174 6564  if the indicated
│ │ │ │ +00040100: 2072 6561 6c6d 2064 6f65 7320 6e6f 7420   realm does not 
│ │ │ │ +00040110: 6578 6973 742c 20e2 8098 5348 4953 415f  exist, ...SHISA_
│ │ │ │ +00040120: 4e4f 5f50 5249 4e43 4950 414c e280 9920  NO_PRINCIPAL... 
│ │ │ │ +00040130: 6966 2074 6865 0a20 2020 2020 696e 6469  if the.     indi
│ │ │ │ +00040140: 6361 7465 6420 7072 696e 6369 7061 6c20  cated principal 
│ │ │ │ +00040150: 646f 6573 206e 6f74 2065 7869 7374 2c20  does not exist, 
│ │ │ │ +00040160: 6f72 2061 6e20 6572 726f 7220 636f 6465  or an error code
│ │ │ │ +00040170: 206f 7468 6572 7769 7365 2e0a 0a73 6869   otherwise...shi
│ │ │ │ +00040180: 7361 5f70 7269 6e63 6970 616c 5f75 7064  sa_principal_upd
│ │ │ │ +00040190: 6174 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ate.------------
│ │ │ │ +000401a0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20  ----------.. -- 
│ │ │ │ +000401b0: 4675 6e63 7469 6f6e 3a20 696e 7420 7368  Function: int sh
│ │ │ │ +000401c0: 6973 615f 7072 696e 6369 7061 6c5f 7570  isa_principal_up
│ │ │ │ +000401d0: 6461 7465 2028 5368 6973 6120 2a20 4442  date (Shisa * DB
│ │ │ │ +000401e0: 482c 0a20 2020 2020 2020 2020 2063 6f6e  H,.          con
│ │ │ │ +000401f0: 7374 2063 6861 7220 2a20 5245 414c 4d2c  st char * REALM,
│ │ │ │ +00040200: 2063 6f6e 7374 2063 6861 7220 2a20 5052   const char * PR
│ │ │ │ +00040210: 494e 4349 5041 4c2c 0a20 2020 2020 2020  INCIPAL,.       
│ │ │ │ +00040220: 2020 2063 6f6e 7374 2053 6869 7361 5f70     const Shisa_p
│ │ │ │ +00040230: 7269 6e63 6970 616c 202a 2050 4829 0a20  rincipal * PH). 
│ │ │ │ +00040240: 2020 2020 4442 483a 2053 6869 7361 206c      DBH: Shisa l
│ │ │ │ +00040250: 6962 7261 7279 2068 616e 646c 6520 6372  ibrary handle cr
│ │ │ │ +00040260: 6561 7465 6420 6279 20e2 8098 7368 6973  eated by ...shis
│ │ │ │ +00040270: 6128 29e2 8099 2e0a 2020 2020 2052 4541  a().....     REA
│ │ │ │ +00040280: 4c4d 3a20 4e61 6d65 206f 6620 7468 6520  LM: Name of the 
│ │ │ │ +00040290: 7265 616c 6d20 7468 6520 7072 696e 6369  realm the princi
│ │ │ │ +000402a0: 7061 6c20 6265 6c6f 6e67 7320 746f 2e0a  pal belongs to..
│ │ │ │ +000402b0: 2020 2020 2050 5249 4e43 4950 414c 3a20       PRINCIPAL: 
│ │ │ │ +000402c0: 4e61 6d65 206f 6620 7072 696e 6369 7061  Name of principa
│ │ │ │ +000402d0: 6c20 746f 2067 6574 2069 6e66 6f72 6d61  l to get informa
│ │ │ │ +000402e0: 7469 6f6e 2061 626f 7574 2e0a 2020 2020  tion about..    
│ │ │ │ +000402f0: 2050 483a 2050 6f69 6e74 6572 2074 6f20   PH: Pointer to 
│ │ │ │ +00040300: 616e 2065 7869 7374 696e 6720 7072 696e  an existing prin
│ │ │ │ +00040310: 6369 7061 6c20 7374 7275 6374 7572 6520  cipal structure 
│ │ │ │ +00040320: 636f 6e74 6169 6e69 6e67 0a20 2020 2020  containing.     
│ │ │ │ +00040330: 696e 666f 726d 6174 696f 6e20 746f 2073  information to s
│ │ │ │ +00040340: 746f 7265 2069 6e20 7468 6520 6461 7461  tore in the data
│ │ │ │ +00040350: 6261 7365 2e0a 0a20 2020 2020 2a44 6573  base...     *Des
│ │ │ │ +00040360: 6372 6970 7469 6f6e 3a2a 204d 6f64 6966  cription:* Modif
│ │ │ │ +00040370: 6965 7320 696e 666f 726d 6174 696f 6e20  ies information 
│ │ │ │ +00040380: 7374 6f72 6564 2061 626f 7574 2074 6865  stored about the
│ │ │ │ +00040390: 2067 6976 656e 0a20 2020 2020 7072 696e   given.     prin
│ │ │ │ +000403a0: 6369 7061 6c20 5052 494e 4349 5041 4c40  cipal PRINCIPAL@
│ │ │ │ +000403b0: 5245 414c 4d2e 204e 6f74 6520 7468 6174  REALM. Note that
│ │ │ │ +000403c0: 2069 7420 6973 2075 7375 616c 6c79 2061   it is usually a
│ │ │ │ +000403d0: 2067 6f6f 6420 6964 6561 2074 6f0a 2020   good idea to.  
│ │ │ │ +000403e0: 2020 2073 6574 2069 6e20 5048 206f 6e6c     set in PH onl
│ │ │ │ +000403f0: 7920 7468 6520 6669 656c 6473 2074 6861  y the fields tha
│ │ │ │ +00040400: 7420 6172 6520 746f 2062 6520 7570 6461  t are to be upda
│ │ │ │ +00040410: 7465 642e 0a0a 2020 2020 2049 7420 6973  ted...     It is
│ │ │ │ +00040420: 2067 656e 6572 616c 6c79 2073 7567 6765   generally sugge
│ │ │ │ +00040430: 7374 6564 2074 6f20 6669 7273 7420 6361  sted to first ca
│ │ │ │ +00040440: 6c6c 20e2 8098 7368 6973 615f 7072 696e  ll ...shisa_prin
│ │ │ │ +00040450: 6369 7061 6c5f 6669 6e64 2829 e280 992c  cipal_find()...,
│ │ │ │ +00040460: 0a20 2020 2020 746f 2067 6574 2074 6865  .     to get the
│ │ │ │ +00040470: 2063 7572 7265 6e74 2069 6e66 6f72 6d61   current informa
│ │ │ │ +00040480: 7469 6f6e 2c20 7468 656e 2074 6f20 6d6f  tion, then to mo
│ │ │ │ +00040490: 6469 6679 206f 6e65 2066 6965 6c64 2061  dify one field a
│ │ │ │ +000404a0: 6e64 2063 616c 6c0a 2020 2020 20e2 8098  nd call.     ...
│ │ │ │ +000404b0: 7368 6973 615f 7072 696e 6369 7061 6c5f  shisa_principal_
│ │ │ │ +000404c0: 7570 6461 7465 2829 e280 992e 0a0a 2020  update()......  
│ │ │ │ +000404d0: 2020 204d 6f64 6966 7969 6e67 2073 6576     Modifying sev
│ │ │ │ +000404e0: 6572 616c 2076 616c 7565 7320 6973 206e  eral values is n
│ │ │ │ +000404f0: 6f74 2072 6563 6f6d 6d65 6e64 6564 2069  ot recommended i
│ │ │ │ +00040500: 6e20 6765 6e65 7261 6c2c 2061 7320 7468  n general, as th
│ │ │ │ +00040510: 6973 0a20 2020 2020 7769 6c6c 2031 2920  is.     will 1) 
│ │ │ │ +00040520: 6f76 6572 7772 6974 6520 616e 7920 6d6f  overwrite any mo
│ │ │ │ +00040530: 6469 6669 6361 7469 6f6e 7320 6d61 6465  difications made
│ │ │ │ +00040540: 2074 6f20 6f74 6865 7220 6669 656c 6473   to other fields
│ │ │ │ +00040550: 2062 6574 7765 656e 0a20 2020 2020 7468   between.     th
│ │ │ │ +00040560: 6520 7477 6f20 6361 6c6c 7320 2862 7920  e two calls (by 
│ │ │ │ +00040570: 6f74 6865 7220 7072 6f63 6573 7365 7329  other processes)
│ │ │ │ +00040580: 2061 6e64 2032 2920 7769 6c6c 2063 6175   and 2) will cau
│ │ │ │ +00040590: 7365 2061 6c6c 2076 616c 7565 7320 746f  se all values to
│ │ │ │ +000405a0: 0a20 2020 2020 6265 2077 7269 7474 656e  .     be written
│ │ │ │ +000405b0: 2061 6761 696e 2c20 7768 6963 6820 6d61   again, which ma
│ │ │ │ +000405c0: 7920 6765 6e65 7261 7465 206d 6f72 6520  y generate more 
│ │ │ │ +000405d0: 6f76 6572 6865 6164 2e0a 0a20 2020 2020  overhead...     
│ │ │ │ +000405e0: 2a52 6574 7572 6e20 7661 6c75 653a 2a20  *Return value:* 
│ │ │ │ +000405f0: 5265 7475 726e 7320 e280 9853 4849 5341  Returns ...SHISA
│ │ │ │ +00040600: 5f4f 4be2 8099 2069 6620 7375 6363 6573  _OK... if succes
│ │ │ │ +00040610: 7366 756c 2c20 e280 9853 4849 5341 5f4e  sful, ...SHISA_N
│ │ │ │ +00040620: 4f5f 5245 414c 4de2 8099 0a20 2020 2020  O_REALM....     
│ │ │ │ +00040630: 6966 2074 6865 2069 6e64 6963 6174 6564  if the indicated
│ │ │ │ +00040640: 2072 6561 6c6d 2064 6f65 7320 6e6f 7420   realm does not 
│ │ │ │ +00040650: 6578 6973 742c 20e2 8098 5348 4953 415f  exist, ...SHISA_
│ │ │ │ +00040660: 4e4f 5f50 5249 4e43 4950 414c e280 9920  NO_PRINCIPAL... 
│ │ │ │ +00040670: 6966 2074 6865 0a20 2020 2020 696e 6469  if the.     indi
│ │ │ │ +00040680: 6361 7465 6420 7072 696e 6369 7061 6c20  cated principal 
│ │ │ │ +00040690: 646f 6573 206e 6f74 2065 7869 7374 2c20  does not exist, 
│ │ │ │ +000406a0: 6f72 2061 6e20 6572 726f 7220 636f 6465  or an error code
│ │ │ │ +000406b0: 206f 7468 6572 7769 7365 2e0a 0a73 6869   otherwise...shi
│ │ │ │ +000406c0: 7361 5f70 7269 6e63 6970 616c 5f61 6464  sa_principal_add
│ │ │ │ +000406d0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  .---------------
│ │ │ │ +000406e0: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ +000406f0: 6f6e 3a20 696e 7420 7368 6973 615f 7072  on: int shisa_pr
│ │ │ │ +00040700: 696e 6369 7061 6c5f 6164 6420 2853 6869  incipal_add (Shi
│ │ │ │ +00040710: 7361 202a 2044 4248 2c20 636f 6e73 7420  sa * DBH, const 
│ │ │ │ +00040720: 6368 6172 202a 2052 4541 4c4d 2c0a 2020  char * REALM,.  
│ │ │ │ +00040730: 2020 2020 2020 2020 636f 6e73 7420 6368          const ch
│ │ │ │ +00040740: 6172 202a 2050 5249 4e43 4950 414c 2c20  ar * PRINCIPAL, 
│ │ │ │ +00040750: 636f 6e73 7420 5368 6973 615f 7072 696e  const Shisa_prin
│ │ │ │ +00040760: 6369 7061 6c20 2a20 5048 2c0a 2020 2020  cipal * PH,.    
│ │ │ │ +00040770: 2020 2020 2020 636f 6e73 7420 5368 6973        const Shis
│ │ │ │ +00040780: 615f 6b65 7920 2a20 4b45 5929 0a20 2020  a_key * KEY).   
│ │ │ │ +00040790: 2020 4442 483a 2053 6869 7361 206c 6962    DBH: Shisa lib
│ │ │ │ +000407a0: 7261 7279 2068 616e 646c 6520 6372 6561  rary handle crea
│ │ │ │ +000407b0: 7465 6420 6279 20e2 8098 7368 6973 6128  ted by ...shisa(
│ │ │ │ +000407c0: 29e2 8099 2e0a 2020 2020 2052 4541 4c4d  ).....     REALM
│ │ │ │ +000407d0: 3a20 4e61 6d65 206f 6620 7468 6520 7265  : Name of the re
│ │ │ │ +000407e0: 616c 6d20 7468 6520 7072 696e 6369 7061  alm the principa
│ │ │ │ +000407f0: 6c20 6265 6c6f 6e67 7320 746f 2e0a 2020  l belongs to..  
│ │ │ │ +00040800: 2020 2050 5249 4e43 4950 414c 3a20 4e61     PRINCIPAL: Na
│ │ │ │ +00040810: 6d65 206f 6620 7072 696e 6369 7061 6c20  me of principal 
│ │ │ │ +00040820: 746f 2061 6464 2e20 2057 6865 6e20 7365  to add.  When se
│ │ │ │ +00040830: 7420 746f 20e2 8098 4e55 4c4c e280 992c  t to ...NULL...,
│ │ │ │ +00040840: 206f 6e6c 7920 7468 650a 2020 2020 2072   only the.     r
│ │ │ │ +00040850: 6561 6c6d 2052 4541 4c4d 2069 7320 6372  ealm REALM is cr
│ │ │ │ +00040860: 6561 7465 642e 0a20 2020 2020 5048 3a20  eated..     PH: 
│ │ │ │ +00040870: 506f 696e 7465 7220 746f 2061 2070 7269  Pointer to a pri
│ │ │ │ +00040880: 6e63 6970 616c 2073 7472 7563 7475 7265  ncipal structure
│ │ │ │ +00040890: 2077 6974 6820 696e 666f 726d 6174 696f   with informatio
│ │ │ │ +000408a0: 6e20 746f 2073 746f 7265 2069 6e0a 2020  n to store in.  
│ │ │ │ +000408b0: 2020 2074 6865 2064 6174 6162 6173 652e     the database.
│ │ │ │ +000408c0: 0a20 2020 2020 4b45 593a 2050 6f69 6e74  .     KEY: Point
│ │ │ │ +000408d0: 6572 2074 6f20 6120 6b65 7920 7374 7275  er to a key stru
│ │ │ │ +000408e0: 6374 7572 6520 7769 7468 2069 6e66 6f72  cture with infor
│ │ │ │ +000408f0: 6d61 7469 6f6e 2074 6f20 7374 6f72 6520  mation to store 
│ │ │ │ +00040900: 696e 2074 6865 0a20 2020 2020 6461 7461  in the.     data
│ │ │ │ +00040910: 6261 7365 2e0a 0a20 2020 2020 2a44 6573  base...     *Des
│ │ │ │ +00040920: 6372 6970 7469 6f6e 3a2a 2049 6e73 6572  cription:* Inser
│ │ │ │ +00040930: 7473 2074 6865 2067 6976 656e 2069 6e66  ts the given inf
│ │ │ │ +00040940: 6f72 6d61 7469 6f6e 2069 6e74 6f20 7468  ormation into th
│ │ │ │ +00040950: 6520 6461 7461 6261 7365 2066 6f72 0a20  e database for. 
│ │ │ │ +00040960: 2020 2020 7468 6520 7072 696e 6369 7061      the principa
│ │ │ │ +00040970: 6c20 5052 494e 4349 5041 4c40 5245 414c  l PRINCIPAL@REAL
│ │ │ │ +00040980: 4d2e 2049 6e20 6361 7365 2050 5249 4e43  M. In case PRINC
│ │ │ │ +00040990: 4950 414c 2069 7320 e280 984e 554c 4ce2  IPAL is ...NULL.
│ │ │ │ +000409a0: 8099 2c20 7468 650a 2020 2020 2070 6172  .., the.     par
│ │ │ │ +000409b0: 616d 6574 6572 7320 5048 2061 6e64 204b  ameters PH and K
│ │ │ │ +000409c0: 4559 2061 7265 206e 6f74 2075 7365 642c  EY are not used,
│ │ │ │ +000409d0: 2073 6f20 6f6e 6c79 2074 6865 2072 6561   so only the rea
│ │ │ │ +000409e0: 6c6d 2069 7320 6164 6465 6420 746f 0a20  lm is added to. 
│ │ │ │ +000409f0: 2020 2020 7468 6520 6461 7461 6261 7365      the database
│ │ │ │ +00040a00: 2e0a 0a20 2020 2020 2a52 6574 7572 6e20  ...     *Return 
│ │ │ │ +00040a10: 7661 6c75 653a 2a20 5265 7475 726e 7320  value:* Returns 
│ │ │ │ +00040a20: e280 9853 4849 5341 5f4f 4be2 8099 2069  ...SHISA_OK... i
│ │ │ │ +00040a30: 6620 7468 6520 696e 666f 726d 6174 696f  f the informatio
│ │ │ │ +00040a40: 6e20 7761 730a 2020 2020 2073 7563 6365  n was.     succe
│ │ │ │ +00040a50: 7373 6675 6c6c 7920 6164 6465 642c 206f  ssfully added, o
│ │ │ │ +00040a60: 7220 616e 2065 7272 6f72 2063 6f64 6520  r an error code 
│ │ │ │ +00040a70: 6f74 6865 7277 6973 652e 0a0a 7368 6973  otherwise...shis
│ │ │ │ +00040a80: 615f 7072 696e 6369 7061 6c5f 7265 6d6f  a_principal_remo
│ │ │ │ +00040a90: 7665 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ve.-------------
│ │ │ │ +00040aa0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +00040ab0: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ +00040ac0: 7361 5f70 7269 6e63 6970 616c 5f72 656d  sa_principal_rem
│ │ │ │ +00040ad0: 6f76 6520 2853 6869 7361 202a 2044 4248  ove (Shisa * DBH
│ │ │ │ +00040ae0: 2c0a 2020 2020 2020 2020 2020 636f 6e73  ,.          cons
│ │ │ │ +00040af0: 7420 6368 6172 202a 2052 4541 4c4d 2c20  t char * REALM, 
│ │ │ │ +00040b00: 636f 6e73 7420 6368 6172 202a 2050 5249  const char * PRI
│ │ │ │ +00040b10: 4e43 4950 414c 290a 2020 2020 2044 4248  NCIPAL).     DBH
│ │ │ │ +00040b20: 3a20 5368 6973 6120 6c69 6272 6172 7920  : Shisa library 
│ │ │ │ +00040b30: 6861 6e64 6c65 2063 7265 6174 6564 2062  handle created b
│ │ │ │ +00040b40: 7920 e280 9873 6869 7361 2829 e280 992e  y ...shisa()....
│ │ │ │ +00040b50: 0a20 2020 2020 5245 414c 4d3a 204e 616d  .     REALM: Nam
│ │ │ │ +00040b60: 6520 6f66 2074 6865 2072 6561 6c6d 2074  e of the realm t
│ │ │ │ +00040b70: 6865 2070 7269 6e63 6970 616c 2062 656c  he principal bel
│ │ │ │ +00040b80: 6f6e 6773 2074 6f2e 0a20 2020 2020 5052  ongs to..     PR
│ │ │ │ +00040b90: 494e 4349 5041 4c3a 204e 616d 6520 6f66  INCIPAL: Name of
│ │ │ │ +00040ba0: 2074 6865 2070 7269 6e63 6970 616c 2074   the principal t
│ │ │ │ +00040bb0: 6f20 7265 6d6f 7665 2e20 2053 6574 2074  o remove.  Set t
│ │ │ │ +00040bc0: 6f20 e280 984e 554c 4ce2 8099 2c20 6f6e  o ...NULL..., on
│ │ │ │ +00040bd0: 6c79 0a20 2020 2020 7468 6520 7265 616c  ly.     the real
│ │ │ │ +00040be0: 6d20 5245 414c 4d20 6973 2072 656d 6f76  m REALM is remov
│ │ │ │ +00040bf0: 6564 2e0a 0a20 2020 2020 2a44 6573 6372  ed...     *Descr
│ │ │ │ +00040c00: 6970 7469 6f6e 3a2a 2052 656d 6f76 6573  iption:* Removes
│ │ │ │ +00040c10: 2061 6c6c 2069 6e66 6f72 6d61 7469 6f6e   all information
│ │ │ │ +00040c20: 2073 746f 7265 6420 696e 2074 6865 2064   stored in the d
│ │ │ │ +00040c30: 6174 6162 6173 6520 666f 720a 2020 2020  atabase for.    
│ │ │ │ +00040c40: 2074 6865 2067 6976 656e 2070 7269 6e63   the given princ
│ │ │ │ +00040c50: 6970 616c 2050 5249 4e43 4950 414c 4052  ipal PRINCIPAL@R
│ │ │ │ +00040c60: 4541 4c4d 2e20 5768 656e 2050 5249 4e43  EALM. When PRINC
│ │ │ │ +00040c70: 4950 414c 2069 7320 e280 984e 554c 4ce2  IPAL is ...NULL.
│ │ │ │ +00040c80: 8099 2c20 7468 656e 0a20 2020 2020 7468  .., then.     th
│ │ │ │ +00040c90: 6520 7265 616c 6d20 5245 414c 4d20 6973  e realm REALM is
│ │ │ │ +00040ca0: 2069 7473 656c 6620 7265 6d6f 7665 642c   itself removed,
│ │ │ │ +00040cb0: 2062 7574 2074 6869 7320 6361 6e20 6f6e   but this can on
│ │ │ │ +00040cc0: 6c79 2073 7563 6365 6564 2069 6620 7468  ly succeed if th
│ │ │ │ +00040cd0: 650a 2020 2020 2072 6561 6c6d 2069 7320  e.     realm is 
│ │ │ │ +00040ce0: 616c 7265 6164 7920 656d 7074 7920 6f66  already empty of
│ │ │ │ +00040cf0: 2070 7269 6e63 6970 616c 732e 0a0a 2020   principals...  
│ │ │ │ +00040d00: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ +00040d10: 3a2a 2052 6574 7572 6e73 20e2 8098 5348  :* Returns ...SH
│ │ │ │ +00040d20: 4953 415f 4f4b e280 9920 6966 2073 7563  ISA_OK... if suc
│ │ │ │ +00040d30: 6365 7373 6675 6c2c 206f 7220 616e 2065  cessful, or an e
│ │ │ │ +00040d40: 7272 6f72 2063 6f64 652e 0a0a 7368 6973  rror code...shis
│ │ │ │ +00040d50: 615f 6b65 7973 5f66 696e 640a 2d2d 2d2d  a_keys_find.----
│ │ │ │ +00040d60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d  -----------.. --
│ │ │ │ +00040d70: 2046 756e 6374 696f 6e3a 2069 6e74 2073   Function: int s
│ │ │ │ +00040d80: 6869 7361 5f6b 6579 735f 6669 6e64 2028  hisa_keys_find (
│ │ │ │ +00040d90: 5368 6973 6120 2a20 4442 482c 2063 6f6e  Shisa * DBH, con
│ │ │ │ +00040da0: 7374 2063 6861 7220 2a20 5245 414c 4d2c  st char * REALM,
│ │ │ │ +00040db0: 0a20 2020 2020 2020 2020 2063 6f6e 7374  .          const
│ │ │ │ +00040dc0: 2063 6861 7220 2a20 5052 494e 4349 5041   char * PRINCIPA
│ │ │ │ +00040dd0: 4c2c 2063 6f6e 7374 2053 6869 7361 5f6b  L, const Shisa_k
│ │ │ │ +00040de0: 6579 202a 2048 494e 542c 0a20 2020 2020  ey * HINT,.     
│ │ │ │ +00040df0: 2020 2020 2053 6869 7361 5f6b 6579 202a       Shisa_key *
│ │ │ │ +00040e00: 2a2a 204b 4559 532c 2073 697a 655f 7420  ** KEYS, size_t 
│ │ │ │ +00040e10: 2a20 4e4b 4559 5329 0a20 2020 2020 4442  * NKEYS).     DB
│ │ │ │ +00040e20: 483a 2053 6869 7361 206c 6962 7261 7279  H: Shisa library
│ │ │ │ +00040e30: 2068 616e 646c 6520 6372 6561 7465 6420   handle created 
│ │ │ │ +00040e40: 6279 20e2 8098 7368 6973 6128 29e2 8099  by ...shisa()...
│ │ │ │ +00040e50: 2e0a 2020 2020 2052 4541 4c4d 3a20 4e61  ..     REALM: Na
│ │ │ │ +00040e60: 6d65 206f 6620 7468 6520 7265 616c 6d20  me of the realm 
│ │ │ │ +00040e70: 7468 6520 7072 696e 6369 7061 6c20 6265  the principal be
│ │ │ │ +00040e80: 6c6f 6e67 7320 746f 2e0a 2020 2020 2050  longs to..     P
│ │ │ │ +00040e90: 5249 4e43 4950 414c 3a20 4e61 6d65 206f  RINCIPAL: Name o
│ │ │ │ +00040ea0: 6620 7468 6520 7072 696e 6369 7061 6c20  f the principal 
│ │ │ │ +00040eb0: 7768 6f73 6520 6b65 7973 2061 7265 2065  whose keys are e
│ │ │ │ +00040ec0: 7861 6d69 6e65 642e 0a20 2020 2020 4849  xamined..     HI
│ │ │ │ +00040ed0: 4e54 3a20 506f 696e 7465 7220 746f 2061  NT: Pointer to a
│ │ │ │ +00040ee0: 2053 6869 7361 206b 6579 2073 7472 7563   Shisa key struc
│ │ │ │ +00040ef0: 7475 7265 2077 6974 6820 6869 6e74 7320  ture with hints 
│ │ │ │ +00040f00: 6f6e 206d 6174 6368 696e 670a 2020 2020  on matching.    
│ │ │ │ +00040f10: 2063 7269 7465 7269 6120 666f 7220 7265   criteria for re
│ │ │ │ +00040f20: 6c65 7661 6e74 206b 6579 732e 2020 e280  levant keys.  ..
│ │ │ │ +00040f30: 984e 554c 4ce2 8099 206d 6174 6368 6573  .NULL... matches
│ │ │ │ +00040f40: 2061 6c6c 206b 6579 732e 0a20 2020 2020   all keys..     
│ │ │ │ +00040f50: 4b45 5953 3a20 5265 7475 726e 6564 2070  KEYS: Returned p
│ │ │ │ +00040f60: 6f69 6e74 6572 2074 6f20 6120 6e65 776c  ointer to a newl
│ │ │ │ +00040f70: 7920 616c 6c6f 6361 7465 6420 6172 7261  y allocated arra
│ │ │ │ +00040f80: 7920 6f66 2053 6869 7361 206b 6579 0a20  y of Shisa key. 
│ │ │ │ +00040f90: 2020 2020 7374 7275 6374 7572 6573 2e0a      structures..
│ │ │ │ +00040fa0: 2020 2020 204e 4b45 5953 3a20 506f 696e       NKEYS: Poin
│ │ │ │ +00040fb0: 7465 7220 746f 2061 6e20 696e 7465 6765  ter to an intege
│ │ │ │ +00040fc0: 7220 7570 6461 7465 6420 7769 7468 2074  r updated with t
│ │ │ │ +00040fd0: 6865 206e 756d 6265 7220 6f66 2061 6c6c  he number of all
│ │ │ │ +00040fe0: 6f63 6174 6564 0a20 2020 2020 5368 6973  ocated.     Shis
│ │ │ │ +00040ff0: 6120 6b65 7920 7374 7275 6374 7572 6573  a key structures
│ │ │ │ +00041000: 2069 6e20 2a4b 4559 532e 0a0a 2020 2020   in *KEYS...    
│ │ │ │ +00041010: 202a 4465 7363 7269 7074 696f 6e3a 2a20   *Description:* 
│ │ │ │ +00041020: 4974 6572 6174 6573 2074 6872 6f75 6768  Iterates through
│ │ │ │ +00041030: 2074 6865 2073 6574 206f 6620 6b65 7973   the set of keys
│ │ │ │ +00041040: 2062 656c 6f6e 6769 6e67 2074 6f0a 2020   belonging to.  
│ │ │ │ +00041050: 2020 2050 5249 4e43 4950 414c 4052 4541     PRINCIPAL@REA
│ │ │ │ +00041060: 4c4d 2c20 6173 2073 656c 6563 7465 6420  LM, as selected 
│ │ │ │ +00041070: 6279 2050 5249 4e43 4950 414c 2061 6e64  by PRINCIPAL and
│ │ │ │ +00041080: 2052 4541 4c4d 2e20 2054 6865 6e20 6578   REALM.  Then ex
│ │ │ │ +00041090: 7472 6163 7473 0a20 2020 2020 616e 7920  tracts.     any 
│ │ │ │ +000410a0: 6b65 7973 2074 6861 7420 6d61 7463 6820  keys that match 
│ │ │ │ +000410b0: 7468 6520 6372 6974 6572 6961 2069 6e20  the criteria in 
│ │ │ │ +000410c0: 4849 4e54 2e0a 0a20 2020 2020 4e6f 7420  HINT...     Not 
│ │ │ │ +000410d0: 616c 6c20 656c 656d 656e 7473 206f 6620  all elements of 
│ │ │ │ +000410e0: 4849 4e54 206e 6565 6420 746f 2062 6520  HINT need to be 
│ │ │ │ +000410f0: 6669 6c6c 6564 2069 6e2e 2020 5365 7420  filled in.  Set 
│ │ │ │ +00041100: 6f6e 6c79 2074 6865 2066 6965 6c64 730a  only the fields.
│ │ │ │ +00041110: 2020 2020 2079 6f75 2061 7265 2069 6e74       you are int
│ │ │ │ +00041120: 6572 6573 7465 6420 696e 2e20 2046 6f72  erested in.  For
│ │ │ │ +00041130: 2065 7861 6d70 6c65 2c20 6966 2079 6f75   example, if you
│ │ │ │ +00041140: 2077 616e 7420 746f 2065 7874 7261 6374   want to extract
│ │ │ │ +00041150: 2061 6c6c 0a20 2020 2020 6b65 7973 206f   all.     keys o
│ │ │ │ +00041160: 6620 6574 7970 6520 332c 2069 2e65 2e2c  f etype 3, i.e.,
│ │ │ │ +00041170: 2044 4553 2d43 4243 2d4d 4435 2c20 7468   DES-CBC-MD5, th
│ │ │ │ +00041180: 656e 2073 6574 2074 6865 2066 6965 6c64  en set the field
│ │ │ │ +00041190: 204b 4559 2d3e 6574 7970 650a 2020 2020   KEY->etype.    
│ │ │ │ +000411a0: 2074 6f20 332c 2061 6e64 2061 6c6c 206f   to 3, and all o
│ │ │ │ +000411b0: 7468 6572 2066 6965 6c64 7320 746f 207a  ther fields to z
│ │ │ │ +000411c0: 6572 6f2e 0a0a 2020 2020 202a 5265 7475  ero...     *Retu
│ │ │ │ +000411d0: 726e 2076 616c 7565 3a2a 2052 6574 7572  rn value:* Retur
│ │ │ │ +000411e0: 6e73 20e2 8098 5348 4953 415f 4f4b e280  ns ...SHISA_OK..
│ │ │ │ +000411f0: 9920 6966 2073 7563 6365 7373 6675 6c2c  . if successful,
│ │ │ │ +00041200: 206f 7220 616e 2065 7272 6f72 2063 6f64   or an error cod
│ │ │ │ +00041210: 652e 0a0a 7368 6973 615f 6b65 795f 6164  e...shisa_key_ad
│ │ │ │ +00041220: 640a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  d.-------------.
│ │ │ │ +00041230: 0a20 2d2d 2046 756e 6374 696f 6e3a 2069  . -- Function: i
│ │ │ │ +00041240: 6e74 2073 6869 7361 5f6b 6579 5f61 6464  nt shisa_key_add
│ │ │ │ +00041250: 2028 5368 6973 6120 2a20 4442 482c 2063   (Shisa * DBH, c
│ │ │ │ +00041260: 6f6e 7374 2063 6861 7220 2a20 5245 414c  onst char * REAL
│ │ │ │ +00041270: 4d2c 0a20 2020 2020 2020 2020 2063 6f6e  M,.          con
│ │ │ │ +00041280: 7374 2063 6861 7220 2a20 5052 494e 4349  st char * PRINCI
│ │ │ │ +00041290: 5041 4c2c 2063 6f6e 7374 2053 6869 7361  PAL, const Shisa
│ │ │ │ +000412a0: 5f6b 6579 202a 204b 4559 290a 2020 2020  _key * KEY).    
│ │ │ │ +000412b0: 2044 4248 3a20 5368 6973 6120 6c69 6272   DBH: Shisa libr
│ │ │ │ +000412c0: 6172 7920 6861 6e64 6c65 2063 7265 6174  ary handle creat
│ │ │ │ +000412d0: 6564 2062 7920 e280 9873 6869 7361 2829  ed by ...shisa()
│ │ │ │ +000412e0: e280 992e 0a20 2020 2020 5245 414c 4d3a  .....     REALM:
│ │ │ │ +000412f0: 204e 616d 6520 6f66 2074 6865 2072 6561   Name of the rea
│ │ │ │ +00041300: 6c6d 2074 6865 2070 7269 6e63 6970 616c  lm the principal
│ │ │ │ +00041310: 2062 656c 6f6e 6773 2074 6f2e 0a20 2020   belongs to..   
│ │ │ │ +00041320: 2020 5052 494e 4349 5041 4c3a 204e 616d    PRINCIPAL: Nam
│ │ │ │ +00041330: 6520 6f66 2074 6865 2070 7269 6e63 6970  e of the princip
│ │ │ │ +00041340: 616c 2074 6f20 6164 6420 6120 6e65 7720  al to add a new 
│ │ │ │ +00041350: 6b65 7920 666f 722e 0a20 2020 2020 4b45  key for..     KE
│ │ │ │ +00041360: 593a 2050 6f69 6e74 6572 2074 6f20 6120  Y: Pointer to a 
│ │ │ │ +00041370: 5368 6973 6120 6b65 7920 7374 7275 6374  Shisa key struct
│ │ │ │ +00041380: 7572 6520 7769 7468 2074 6865 206e 6577  ure with the new
│ │ │ │ +00041390: 206b 6579 2e0a 0a20 2020 2020 2a44 6573   key...     *Des
│ │ │ │ +000413a0: 6372 6970 7469 6f6e 3a2a 2041 6464 7320  cription:* Adds 
│ │ │ │ +000413b0: 6120 636f 6d70 6c65 7465 206b 6579 204b  a complete key K
│ │ │ │ +000413c0: 4559 2074 6f20 7468 6520 6461 7461 6261  EY to the databa
│ │ │ │ +000413d0: 7365 2065 6e74 7279 0a20 2020 2020 6265  se entry.     be
│ │ │ │ +000413e0: 6c6f 6e67 696e 6720 746f 2074 6865 2070  longing to the p
│ │ │ │ +000413f0: 7269 6e63 6970 616c 2050 5249 4e43 4950  rincipal PRINCIP
│ │ │ │ +00041400: 414c 4052 4541 4c4d 2c20 6173 2073 6574  AL@REALM, as set
│ │ │ │ +00041410: 2062 7920 5052 494e 4349 5041 4c20 616e   by PRINCIPAL an
│ │ │ │ +00041420: 640a 2020 2020 2052 4541 4c4d 2e0a 0a20  d.     REALM... 
│ │ │ │ +00041430: 2020 2020 2a52 6574 7572 6e20 7661 6c75      *Return valu
│ │ │ │ +00041440: 653a 2a20 5265 7475 726e 7320 e280 9853  e:* Returns ...S
│ │ │ │ +00041450: 4849 5341 5f4f 4be2 8099 2069 6620 7375  HISA_OK... if su
│ │ │ │ +00041460: 6363 6573 7366 756c 2c20 6f72 2061 6e20  ccessful, or an 
│ │ │ │ +00041470: 6572 726f 7220 636f 6465 2e0a 0a73 6869  error code...shi
│ │ │ │ +00041480: 7361 5f6b 6579 5f75 7064 6174 650a 2d2d  sa_key_update.--
│ │ │ │ +00041490: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ +000414a0: 202d 2d20 4675 6e63 7469 6f6e 3a20 696e   -- Function: in
│ │ │ │ +000414b0: 7420 7368 6973 615f 6b65 795f 7570 6461  t shisa_key_upda
│ │ │ │ +000414c0: 7465 2028 5368 6973 6120 2a20 4442 482c  te (Shisa * DBH,
│ │ │ │ +000414d0: 2063 6f6e 7374 2063 6861 7220 2a20 5245   const char * RE
│ │ │ │ +000414e0: 414c 4d2c 0a20 2020 2020 2020 2020 2063  ALM,.          c
│ │ │ │ +000414f0: 6f6e 7374 2063 6861 7220 2a20 5052 494e  onst char * PRIN
│ │ │ │ +00041500: 4349 5041 4c2c 2063 6f6e 7374 2053 6869  CIPAL, const Shi
│ │ │ │ +00041510: 7361 5f6b 6579 202a 204f 4c44 4b45 592c  sa_key * OLDKEY,
│ │ │ │ +00041520: 0a20 2020 2020 2020 2020 2063 6f6e 7374  .          const
│ │ │ │ +00041530: 2053 6869 7361 5f6b 6579 202a 204e 4557   Shisa_key * NEW
│ │ │ │ +00041540: 4b45 5929 0a20 2020 2020 4442 483a 2053  KEY).     DBH: S
│ │ │ │ +00041550: 6869 7361 206c 6962 7261 7279 2068 616e  hisa library han
│ │ │ │ +00041560: 646c 6520 6372 6561 7465 6420 6279 20e2  dle created by .
│ │ │ │ +00041570: 8098 7368 6973 6128 29e2 8099 2e0a 2020  ..shisa().....  
│ │ │ │ +00041580: 2020 2052 4541 4c4d 3a20 4e61 6d65 206f     REALM: Name o
│ │ │ │ +00041590: 6620 7468 6520 7265 616c 6d20 7468 6520  f the realm the 
│ │ │ │ +000415a0: 7072 696e 6369 7061 6c20 6265 6c6f 6e67  principal belong
│ │ │ │ +000415b0: 7320 746f 2e0a 2020 2020 2050 5249 4e43  s to..     PRINC
│ │ │ │ +000415c0: 4950 414c 3a20 4e61 6d65 206f 6620 7468  IPAL: Name of th
│ │ │ │ +000415d0: 6520 7072 696e 6369 7061 6c20 6e65 6564  e principal need
│ │ │ │ +000415e0: 696e 6720 616e 2075 7064 6174 6564 206b  ing an updated k
│ │ │ │ +000415f0: 6579 2e0a 2020 2020 204f 4c44 4b45 593a  ey..     OLDKEY:
│ │ │ │ +00041600: 2050 6f69 6e74 6572 2074 6f20 6120 5368   Pointer to a Sh
│ │ │ │ +00041610: 6973 6120 6b65 7920 7374 7275 6374 7572  isa key structur
│ │ │ │ +00041620: 6520 6769 7669 6e67 206d 6174 6368 696e  e giving matchin
│ │ │ │ +00041630: 6720 6372 6974 6572 6961 0a20 2020 2020  g criteria.     
│ │ │ │ +00041640: 666f 7220 6c6f 6361 7469 6e67 2074 6865  for locating the
│ │ │ │ +00041650: 206b 6579 2074 6f20 6265 2075 7064 6174   key to be updat
│ │ │ │ +00041660: 6564 2e0a 2020 2020 204e 4557 4b45 593a  ed..     NEWKEY:
│ │ │ │ +00041670: 2050 6f69 6e74 6572 2074 6f20 6120 636f   Pointer to a co
│ │ │ │ +00041680: 6d70 6c65 7465 2053 6869 7361 206b 6579  mplete Shisa key
│ │ │ │ +00041690: 2073 7472 7563 7475 7265 2c20 696e 2077   structure, in w
│ │ │ │ +000416a0: 6869 6368 2061 6c6c 0a20 2020 2020 6669  hich all.     fi
│ │ │ │ +000416b0: 656c 6473 2061 7265 2075 7365 6420 666f  elds are used fo
│ │ │ │ +000416c0: 7220 7468 6520 6e65 7720 6b65 792e 2020  r the new key.  
│ │ │ │ +000416d0: 4e6f 7465 2074 6861 7420 4f4c 444b 4559  Note that OLDKEY
│ │ │ │ +000416e0: 206e 6f72 6d61 6c6c 7920 6861 7320 6661   normally has fa
│ │ │ │ +000416f0: 720a 2020 2020 2066 6577 6572 2066 6965  r.     fewer fie
│ │ │ │ +00041700: 6c64 7320 6669 6c6c 6564 2d69 6e2e 0a0a  lds filled-in...
│ │ │ │ +00041710: 2020 2020 202a 4465 7363 7269 7074 696f       *Descriptio
│ │ │ │ +00041720: 6e3a 2a20 4d6f 6469 6669 6573 2064 6174  n:* Modifies dat
│ │ │ │ +00041730: 6120 6162 6f75 7420 6120 6b65 7920 7374  a about a key st
│ │ │ │ +00041740: 6f72 6564 2069 6e20 7468 6520 6461 7461  ored in the data
│ │ │ │ +00041750: 6261 7365 2c20 610a 2020 2020 206b 6579  base, a.     key
│ │ │ │ +00041760: 2062 656c 6f6e 6769 6e67 2074 6f20 7468   belonging to th
│ │ │ │ +00041770: 6520 7072 696e 6369 7061 6c20 7365 6c65  e principal sele
│ │ │ │ +00041780: 6374 6564 2062 7920 5052 494e 4349 5041  cted by PRINCIPA
│ │ │ │ +00041790: 4c20 616e 6420 5245 414c 4d2e 0a20 2020  L and REALM..   
│ │ │ │ +000417a0: 2020 4669 7273 7420 4f4c 444b 4559 2069    First OLDKEY i
│ │ │ │ +000417b0: 7320 7573 6564 2074 6f20 6c6f 6361 7465  s used to locate
│ │ │ │ +000417c0: 2074 6865 206b 6579 2074 6f20 7570 6461   the key to upda
│ │ │ │ +000417d0: 7465 2c20 6173 2064 6f65 730a 2020 2020  te, as does.    
│ │ │ │ +000417e0: 20e2 8098 7368 6973 615f 6b65 7973 5f66   ...shisa_keys_f
│ │ │ │ +000417f0: 696e 6428 29e2 8099 2e20 2054 6865 6e20  ind()....  Then 
│ │ │ │ +00041800: 7468 6520 666f 756e 6420 6b65 7920 6973  the found key is
│ │ │ │ +00041810: 206d 6f64 6966 6965 6420 746f 2063 6172   modified to car
│ │ │ │ +00041820: 7279 0a20 2020 2020 7768 6174 6576 6572  ry.     whatever
│ │ │ │ +00041830: 2069 6e66 6f72 6d61 7469 6f6e 2069 7320   information is 
│ │ │ │ +00041840: 7374 6f72 6564 2069 6e20 4e45 574b 4559  stored in NEWKEY
│ │ │ │ +00041850: 2e0a 0a20 2020 2020 4e6f 7420 616c 6c20  ...     Not all 
│ │ │ │ +00041860: 656c 656d 656e 7473 206f 6620 4f4c 444b  elements of OLDK
│ │ │ │ +00041870: 4559 206e 6565 6420 746f 2062 6520 6669  EY need to be fi
│ │ │ │ +00041880: 6c6c 6564 206f 7574 2c20 6f6e 6c79 2073  lled out, only s
│ │ │ │ +00041890: 7566 6669 6369 656e 746c 790a 2020 2020  ufficiently.    
│ │ │ │ +000418a0: 206d 616e 7920 736f 2061 7320 746f 2075   many so as to u
│ │ │ │ +000418b0: 6e69 7175 656c 7920 6964 656e 7469 6679  niquely identify
│ │ │ │ +000418c0: 2074 6865 2064 6573 6972 6564 206b 6579   the desired key
│ │ │ │ +000418d0: 2e20 2046 6f72 2065 7861 6d70 6c65 2c20  .  For example, 
│ │ │ │ +000418e0: 6966 0a20 2020 2020 796f 7520 7761 6e74  if.     you want
│ │ │ │ +000418f0: 2074 6f20 6d6f 6469 6679 2074 6865 2069   to modify the i
│ │ │ │ +00041900: 6e66 6f72 6d61 7469 6f6e 2073 746f 7265  nformation store
│ │ │ │ +00041910: 6420 6162 6f75 7420 6120 756e 6971 7565  d about a unique
│ │ │ │ +00041920: 206b 6579 206f 660a 2020 2020 2065 7479   key of.     ety
│ │ │ │ +00041930: 7065 2033 2c20 692e 652e 2c20 4445 532d  pe 3, i.e., DES-
│ │ │ │ +00041940: 4342 432d 4d44 352c 2074 6865 6e20 7365  CBC-MD5, then se
│ │ │ │ +00041950: 7420 7468 6520 6669 656c 6420 4b45 592d  t the field KEY-
│ │ │ │ +00041960: 3e65 7479 7065 2074 6f20 332c 0a20 2020  >etype to 3,.   
│ │ │ │ +00041970: 2020 6c65 6176 696e 6720 616c 6c20 6f74    leaving all ot
│ │ │ │ +00041980: 6865 7220 6669 656c 6473 2061 7320 7a65  her fields as ze
│ │ │ │ +00041990: 726f 2e0a 0a20 2020 2020 2a52 6574 7572  ro...     *Retur
│ │ │ │ +000419a0: 6e20 7661 6c75 653a 2a20 5265 7475 726e  n value:* Return
│ │ │ │ +000419b0: 7320 e280 9853 4849 5341 5f4f 4be2 8099  s ...SHISA_OK...
│ │ │ │ +000419c0: 206f 6e20 7375 6363 6573 732c 20e2 8098   on success, ...
│ │ │ │ +000419d0: 5348 4953 415f 4e4f 5f4b 4559 e280 9920  SHISA_NO_KEY... 
│ │ │ │ +000419e0: 6966 206e 6f0a 2020 2020 206b 6579 2063  if no.     key c
│ │ │ │ +000419f0: 6f75 6c64 2062 6520 6c6f 6361 7465 642c  ould be located,
│ │ │ │ +00041a00: 20e2 8098 5348 4953 415f 4d55 4c54 4950   ...SHISA_MULTIP
│ │ │ │ +00041a10: 4c45 5f4b 4559 5f4d 4154 4348 e280 9920  LE_KEY_MATCH... 
│ │ │ │ +00041a20: 6966 206d 6f72 6520 7468 616e 2061 0a20  if more than a. 
│ │ │ │ +00041a30: 2020 2020 7369 6e67 6c65 206b 6579 206d      single key m
│ │ │ │ +00041a40: 6174 6368 6564 2074 6865 2067 6976 656e  atched the given
│ │ │ │ +00041a50: 2063 7269 7465 7269 612c 206f 7220 616e   criteria, or an
│ │ │ │ +00041a60: 2065 7272 6f72 2063 6f64 6520 6f74 6865   error code othe
│ │ │ │ +00041a70: 7277 6973 652e 0a0a 7368 6973 615f 6b65  rwise...shisa_ke
│ │ │ │ +00041a80: 795f 7265 6d6f 7665 0a2d 2d2d 2d2d 2d2d  y_remove.-------
│ │ │ │ +00041a90: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2046  ---------.. -- F
│ │ │ │ +00041aa0: 756e 6374 696f 6e3a 2069 6e74 2073 6869  unction: int shi
│ │ │ │ +00041ab0: 7361 5f6b 6579 5f72 656d 6f76 6520 2853  sa_key_remove (S
│ │ │ │ +00041ac0: 6869 7361 202a 2044 4248 2c20 636f 6e73  hisa * DBH, cons
│ │ │ │ +00041ad0: 7420 6368 6172 202a 2052 4541 4c4d 2c0a  t char * REALM,.
│ │ │ │ +00041ae0: 2020 2020 2020 2020 2020 636f 6e73 7420            const 
│ │ │ │ +00041af0: 6368 6172 202a 2050 5249 4e43 4950 414c  char * PRINCIPAL
│ │ │ │ +00041b00: 2c20 636f 6e73 7420 5368 6973 615f 6b65  , const Shisa_ke
│ │ │ │ +00041b10: 7920 2a20 4b45 5929 0a20 2020 2020 4442  y * KEY).     DB
│ │ │ │ +00041b20: 483a 2053 6869 7361 206c 6962 7261 7279  H: Shisa library
│ │ │ │ +00041b30: 2068 616e 646c 6520 6372 6561 7465 6420   handle created 
│ │ │ │ +00041b40: 6279 20e2 8098 7368 6973 6128 29e2 8099  by ...shisa()...
│ │ │ │ +00041b50: 2e0a 2020 2020 2052 4541 4c4d 3a20 4e61  ..     REALM: Na
│ │ │ │ +00041b60: 6d65 206f 6620 7468 6520 7265 616c 6d20  me of the realm 
│ │ │ │ +00041b70: 7468 6520 7072 696e 6369 7061 6c20 6265  the principal be
│ │ │ │ +00041b80: 6c6f 6e67 7320 746f 2e0a 2020 2020 2050  longs to..     P
│ │ │ │ +00041b90: 5249 4e43 4950 414c 3a20 4e61 6d65 206f  RINCIPAL: Name o
│ │ │ │ +00041ba0: 6620 7468 6520 7072 696e 6369 7061 6c20  f the principal 
│ │ │ │ +00041bb0: 7768 6f73 6520 6b65 7920 6973 2074 6f20  whose key is to 
│ │ │ │ +00041bc0: 6265 2072 656d 6f76 6564 2e0a 2020 2020  be removed..    
│ │ │ │ +00041bd0: 204b 4559 3a20 506f 696e 7465 7220 746f   KEY: Pointer to
│ │ │ │ +00041be0: 2061 2053 6869 7361 206b 6579 2073 7472   a Shisa key str
│ │ │ │ +00041bf0: 7563 7475 7265 2077 6974 6820 6869 6e74  ucture with hint
│ │ │ │ +00041c00: 7320 6f6e 206d 6174 6368 696e 670a 2020  s on matching.  
│ │ │ │ +00041c10: 2020 2063 7269 7465 7269 6120 666f 7220     criteria for 
│ │ │ │ +00041c20: 7468 6520 6b65 7920 746f 2073 656c 6563  the key to selec
│ │ │ │ +00041c30: 742e 0a0a 2020 2020 202a 4465 7363 7269  t...     *Descri
│ │ │ │ +00041c40: 7074 696f 6e3a 2a20 5265 6d6f 7665 7320  ption:* Removes 
│ │ │ │ +00041c50: 6672 6f6d 2074 6865 2053 6869 7361 2064  from the Shisa d
│ │ │ │ +00041c60: 6174 6162 6173 6520 6120 6b65 792c 206d  atabase a key, m
│ │ │ │ +00041c70: 6174 6368 696e 6720 7468 650a 2020 2020  atching the.    
│ │ │ │ +00041c80: 2068 696e 7473 2069 6e20 4b45 592c 2066   hints in KEY, f
│ │ │ │ +00041c90: 6f72 2074 6865 2075 7365 7220 5052 494e  or the user PRIN
│ │ │ │ +00041ca0: 4349 5041 4c40 5245 414c 4d2e 204e 6f74  CIPAL@REALM. Not
│ │ │ │ +00041cb0: 2061 6c6c 2065 6c65 6d65 6e74 7320 6f66   all elements of
│ │ │ │ +00041cc0: 204b 4559 0a20 2020 2020 6e65 6564 2074   KEY.     need t
│ │ │ │ +00041cd0: 6f20 6265 2066 696c 6c65 6420 696e 2c20  o be filled in, 
│ │ │ │ +00041ce0: 6f6e 6c79 2074 686f 7365 2072 656c 6576  only those relev
│ │ │ │ +00041cf0: 616e 7420 746f 206c 6f63 6174 6520 7468  ant to locate th
│ │ │ │ +00041d00: 6520 6b65 790a 2020 2020 2075 6e69 7175  e key.     uniqu
│ │ │ │ +00041d10: 656c 792e 0a0a 2020 2020 2046 6f72 2065  ely...     For e
│ │ │ │ +00041d20: 7861 6d70 6c65 2c20 6966 2079 6f75 2077  xample, if you w
│ │ │ │ +00041d30: 616e 7420 746f 2072 656d 6f76 6520 7468  ant to remove th
│ │ │ │ +00041d40: 6520 6f6e 6c79 206b 6579 206f 6620 6574  e only key of et
│ │ │ │ +00041d50: 7970 6520 332c 2069 2e65 2e2c 0a20 2020  ype 3, i.e.,.   
│ │ │ │ +00041d60: 2020 4445 532d 4342 432d 4d44 352c 2074    DES-CBC-MD5, t
│ │ │ │ +00041d70: 6865 6e20 7365 7420 7468 6520 6669 656c  hen set the fiel
│ │ │ │ +00041d80: 6420 4b45 592d 3e65 7479 7065 2074 6f20  d KEY->etype to 
│ │ │ │ +00041d90: 332c 2061 6e64 2061 6c6c 206f 7468 6572  3, and all other
│ │ │ │ +00041da0: 0a20 2020 2020 6669 656c 6473 2074 6f20  .     fields to 
│ │ │ │ +00041db0: 7a65 726f 2e0a 0a20 2020 2020 2a52 6574  zero...     *Ret
│ │ │ │ +00041dc0: 7572 6e20 7661 6c75 653a 2a20 5265 7475  urn value:* Retu
│ │ │ │ +00041dd0: 726e 7320 e280 9853 4849 5341 5f4f 4be2  rns ...SHISA_OK.
│ │ │ │ +00041de0: 8099 206f 6e20 7375 6363 6573 732c 20e2  .. on success, .
│ │ │ │ +00041df0: 8098 5348 4953 415f 4e4f 5f4b 4559 e280  ..SHISA_NO_KEY..
│ │ │ │ +00041e00: 9920 6966 206e 6f0a 2020 2020 206b 6579  . if no.     key
│ │ │ │ +00041e10: 2063 6f75 6c64 2062 6520 6c6f 6361 7465   could be locate
│ │ │ │ +00041e20: 642c 20e2 8098 5348 4953 415f 4d55 4c54  d, ...SHISA_MULT
│ │ │ │ +00041e30: 4950 4c45 5f4b 4559 5f4d 4154 4348 e280  IPLE_KEY_MATCH..
│ │ │ │ +00041e40: 9920 6966 206d 6f72 6520 7468 616e 206f  . if more than o
│ │ │ │ +00041e50: 6e65 0a20 2020 2020 6b65 7920 6d61 7463  ne.     key matc
│ │ │ │ +00041e60: 6865 6420 7468 6520 6769 7665 6e20 6372  hed the given cr
│ │ │ │ +00041e70: 6974 6572 6961 2c20 6f72 2061 6e20 6572  iteria, or an er
│ │ │ │ +00041e80: 726f 7220 636f 6465 206f 7468 6572 7769  ror code otherwi
│ │ │ │ +00041e90: 7365 2e0a 0a73 6869 7361 5f6b 6579 5f66  se...shisa_key_f
│ │ │ │ +00041ea0: 7265 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ree.------------
│ │ │ │ +00041eb0: 2d2d 0a0a 202d 2d20 4675 6e63 7469 6f6e  --.. -- Function
│ │ │ │ +00041ec0: 3a20 766f 6964 2073 6869 7361 5f6b 6579  : void shisa_key
│ │ │ │ +00041ed0: 5f66 7265 6520 2853 6869 7361 202a 2044  _free (Shisa * D
│ │ │ │ +00041ee0: 4248 2c20 5368 6973 615f 6b65 7920 2a20  BH, Shisa_key * 
│ │ │ │ +00041ef0: 4b45 5929 0a20 2020 2020 4442 483a 2053  KEY).     DBH: S
│ │ │ │ +00041f00: 6869 7361 206c 6962 7261 7279 2068 616e  hisa library han
│ │ │ │ +00041f10: 646c 6520 6372 6561 7465 6420 6279 20e2  dle created by .
│ │ │ │ +00041f20: 8098 7368 6973 6128 29e2 8099 2e0a 2020  ..shisa().....  
│ │ │ │ +00041f30: 2020 204b 4559 3a20 506f 696e 7465 7220     KEY: Pointer 
│ │ │ │ +00041f40: 746f 2061 2053 6869 7361 206b 6579 2073  to a Shisa key s
│ │ │ │ +00041f50: 7472 7563 7475 7265 2074 6f20 6465 616c  tructure to deal
│ │ │ │ +00041f60: 6c6f 6361 7465 2e0a 0a20 2020 2020 2a44  locate...     *D
│ │ │ │ +00041f70: 6573 6372 6970 7469 6f6e 3a2a 2044 6561  escription:* Dea
│ │ │ │ +00041f80: 6c6c 6f63 6174 6573 2074 6865 2066 6965  llocates the fie
│ │ │ │ +00041f90: 6c64 7320 6f66 2061 2053 6869 7361 206b  lds of a Shisa k
│ │ │ │ +00041fa0: 6579 2073 7472 7563 7475 7265 2c20 6173  ey structure, as
│ │ │ │ +00041fb0: 0a20 2020 2020 7765 6c6c 2061 7320 7468  .     well as th
│ │ │ │ +00041fc0: 6520 7374 7275 6374 7572 6520 6974 7365  e structure itse
│ │ │ │ +00041fd0: 6c66 2e0a 0a73 6869 7361 5f6b 6579 735f  lf...shisa_keys_
│ │ │ │ +00041fe0: 6672 6565 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  free.-----------
│ │ │ │ +00041ff0: 2d2d 2d2d 0a0a 202d 2d20 4675 6e63 7469  ----.. -- Functi
│ │ │ │ +00042000: 6f6e 3a20 766f 6964 2073 6869 7361 5f6b  on: void shisa_k
│ │ │ │ +00042010: 6579 735f 6672 6565 2028 5368 6973 6120  eys_free (Shisa 
│ │ │ │ +00042020: 2a20 4442 482c 2053 6869 7361 5f6b 6579  * DBH, Shisa_key
│ │ │ │ +00042030: 202a 2a20 4b45 5953 2c0a 2020 2020 2020   ** KEYS,.      
│ │ │ │ +00042040: 2020 2020 7369 7a65 5f74 204e 4b45 5953      size_t NKEYS
│ │ │ │ +00042050: 290a 2020 2020 2044 4248 3a20 5368 6973  ).     DBH: Shis
│ │ │ │ +00042060: 6120 6c69 6272 6172 7920 6861 6e64 6c65  a library handle
│ │ │ │ +00042070: 2063 7265 6174 6564 2062 7920 e280 9873   created by ...s
│ │ │ │ +00042080: 6869 7361 2829 e280 992e 0a20 2020 2020  hisa().....     
│ │ │ │ +00042090: 4b45 5953 3a20 506f 696e 7465 7220 746f  KEYS: Pointer to
│ │ │ │ +000420a0: 2061 6e20 6172 7261 7920 6f66 2053 6869   an array of Shi
│ │ │ │ +000420b0: 7361 206b 6579 2073 7472 7563 7475 7265  sa key structure
│ │ │ │ +000420c0: 732e 0a20 2020 2020 4e4b 4559 533a 204e  s..     NKEYS: N
│ │ │ │ +000420d0: 756d 6265 7220 6f66 206b 6579 2065 6c65  umber of key ele
│ │ │ │ +000420e0: 6d65 6e74 7320 696e 2074 6865 2061 7272  ments in the arr
│ │ │ │ +000420f0: 6179 204b 4559 532e 0a0a 2020 2020 202a  ay KEYS...     *
│ │ │ │ +00042100: 4465 7363 7269 7074 696f 6e3a 2a20 4465  Description:* De
│ │ │ │ +00042110: 616c 6c6f 6361 7465 7320 6561 6368 206b  allocates each k
│ │ │ │ +00042120: 6579 2065 6c65 6d65 6e74 2069 6e20 7468  ey element in th
│ │ │ │ +00042130: 6520 6172 7261 7920 4b45 5953 206f 660a  e array KEYS of.
│ │ │ │ +00042140: 2020 2020 2053 6869 7361 2064 6174 6162       Shisa datab
│ │ │ │ +00042150: 6173 6520 6b65 7973 2c20 7573 696e 6720  ase keys, using 
│ │ │ │ +00042160: 7265 7065 6174 6564 2063 616c 6c73 2074  repeated calls t
│ │ │ │ +00042170: 6f20 e280 9873 6869 7361 5f6b 6579 5f66  o ...shisa_key_f
│ │ │ │ +00042180: 7265 6528 29e2 8099 2e0a 0a20 2020 4572  ree()......   Er
│ │ │ │ +00042190: 726f 7220 6861 6e64 6c69 6e67 2069 7320  ror handling is 
│ │ │ │ +000421a0: 7369 6d69 6c61 7220 746f 2074 6861 7420  similar to that 
│ │ │ │ +000421b0: 666f 7220 5368 6973 6869 2069 6e20 6765  for Shishi in ge
│ │ │ │ +000421c0: 6e65 7261 6c20 282a 6e6f 7465 2045 7272  neral (*note Err
│ │ │ │ +000421d0: 6f72 0a48 616e 646c 696e 673a 3a29 2c20  or.Handling::), 
│ │ │ │ +000421e0: 692e 652e 2c20 796f 7520 696e 766f 6b65  i.e., you invoke
│ │ │ │ +000421f0: 20e2 8098 7368 6973 615f 7374 7265 7272   ...shisa_strerr
│ │ │ │ +00042200: 6f72 e280 9920 6f6e 2074 6865 2069 6e74  or... on the int
│ │ │ │ +00042210: 6567 6572 2072 6574 7572 6e0a 7661 6c75  eger return.valu
│ │ │ │ +00042220: 6520 7265 6365 6976 6564 2062 7920 736f  e received by so
│ │ │ │ +00042230: 6d65 2066 756e 6374 696f 6e2c 2069 6620  me function, if 
│ │ │ │ +00042240: 7468 6520 7265 7475 726e 2076 616c 7565  the return value
│ │ │ │ +00042250: 2069 7320 6e6f 6e2d 7a65 726f 2e20 2042   is non-zero.  B
│ │ │ │ +00042260: 656c 6f77 0a69 7320 7468 6520 636f 6d70  elow.is the comp
│ │ │ │ +00042270: 6c65 7465 2069 6e74 6572 6661 6365 2e0a  lete interface..
│ │ │ │ +00042280: 0a73 6869 7361 5f73 7472 6572 726f 720a  .shisa_strerror.
│ │ │ │ +00042290: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ +000422a0: 202d 2d20 4675 6e63 7469 6f6e 3a20 636f   -- Function: co
│ │ │ │ +000422b0: 6e73 7420 6368 6172 202a 2073 6869 7361  nst char * shisa
│ │ │ │ +000422c0: 5f73 7472 6572 726f 7220 2869 6e74 2045  _strerror (int E
│ │ │ │ +000422d0: 5252 290a 2020 2020 2045 5252 3a20 5368  RR).     ERR: Sh
│ │ │ │ +000422e0: 6973 6120 6572 726f 7220 636f 6465 2e0a  isa error code..
│ │ │ │ +000422f0: 0a20 2020 2020 2a44 6573 6372 6970 7469  .     *Descripti
│ │ │ │ +00042300: 6f6e 3a2a 2045 7870 6c61 696e 7320 7665  on:* Explains ve
│ │ │ │ +00042310: 7262 616c 6c79 2061 6e20 6572 726f 7220  rbally an error 
│ │ │ │ +00042320: 7374 6174 7573 2045 5252 2e20 2054 6865  status ERR.  The
│ │ │ │ +00042330: 2072 6574 7572 6e65 640a 2020 2020 2073   returned.     s
│ │ │ │ +00042340: 7472 696e 6720 6361 6e20 6265 2075 7365  tring can be use
│ │ │ │ +00042350: 6420 746f 2063 6f6d 706f 7365 2061 2064  d to compose a d
│ │ │ │ +00042360: 6961 676e 6f73 7469 6320 6d65 7373 6167  iagnostic messag
│ │ │ │ +00042370: 6520 6f66 2062 656e 6566 6974 2074 6f20  e of benefit to 
│ │ │ │ +00042380: 610a 2020 2020 2075 7365 722e 0a0a 2020  a.     user...  
│ │ │ │ +00042390: 2020 202a 5265 7475 726e 2076 616c 7565     *Return value
│ │ │ │ +000423a0: 3a2a 2052 6574 7572 6e73 2061 2070 6f69  :* Returns a poi
│ │ │ │ +000423b0: 6e74 6572 2074 6f20 6120 7374 6174 6963  nter to a static
│ │ │ │ +000423c0: 616c 6c79 2061 6c6c 6f63 6174 6564 2073  ally allocated s
│ │ │ │ +000423d0: 7472 696e 672c 0a20 2020 2020 636f 6e74  tring,.     cont
│ │ │ │ +000423e0: 6169 6e69 6e67 2061 2064 6573 6372 6970  aining a descrip
│ │ │ │ +000423f0: 7469 6f6e 206f 6620 7468 6520 6572 726f  tion of the erro
│ │ │ │ +00042400: 7220 6769 7665 6e20 6173 2069 6e70 7574  r given as input
│ │ │ │ +00042410: 2061 7267 756d 656e 742e 0a0a 7368 6973   argument...shis
│ │ │ │ +00042420: 615f 696e 666f 0a2d 2d2d 2d2d 2d2d 2d2d  a_info.---------
│ │ │ │ +00042430: 2d0a 0a20 2d2d 2046 756e 6374 696f 6e3a  -.. -- Function:
│ │ │ │ +00042440: 2076 6f69 6420 7368 6973 615f 696e 666f   void shisa_info
│ │ │ │ +00042450: 2028 5368 6973 6120 2a20 4442 482c 2063   (Shisa * DBH, c
│ │ │ │ +00042460: 6f6e 7374 2063 6861 7220 2a20 464f 524d  onst char * FORM
│ │ │ │ +00042470: 4154 2c20 2e2e 2e29 0a20 2020 2020 4442  AT, ...).     DB
│ │ │ │ +00042480: 483a 2053 6869 7361 206c 6962 7261 7279  H: Shisa library
│ │ │ │ +00042490: 2068 616e 646c 6520 6372 6561 7465 6420   handle created 
│ │ │ │ +000424a0: 6279 20e2 8098 7368 6973 6128 29e2 8099  by ...shisa()...
│ │ │ │ +000424b0: 2e0a 2020 2020 2046 4f52 4d41 543a 2070  ..     FORMAT: p
│ │ │ │ +000424c0: 7269 6e74 6620 7374 796c 6520 666f 726d  rintf style form
│ │ │ │ +000424d0: 6174 2073 7472 696e 672e 0a20 2020 2020  at string..     
│ │ │ │ +000424e0: 2e2e 2e3a 2070 7269 6e74 6620 7374 796c  ...: printf styl
│ │ │ │ +000424f0: 6520 6172 6775 6d65 6e74 732e 0a0a 2020  e arguments...  
│ │ │ │ +00042500: 2020 202a 4465 7363 7269 7074 696f 6e3a     *Description:
│ │ │ │ +00042510: 2a20 5072 696e 7473 2061 6e20 696e 666f  * Prints an info
│ │ │ │ +00042520: 726d 6174 696f 6e61 6c20 6d65 7373 6167  rmational messag
│ │ │ │ +00042530: 6520 746f 2073 7461 6e64 6172 6420 6572  e to standard er
│ │ │ │ +00042540: 726f 722e 0a20 2020 2020 5468 6520 7465  ror..     The te
│ │ │ │ +00042550: 7874 2069 7320 636f 6d70 6f73 6564 2066  xt is composed f
│ │ │ │ +00042560: 726f 6d20 7468 6520 6172 6775 6d65 6e74  rom the argument
│ │ │ │ +00042570: 732c 206c 696b 6520 7072 696e 7466 2833  s, like printf(3
│ │ │ │ +00042580: 292e 0a0a 1f0a 4669 6c65 3a20 7368 6973  ).....File: shis
│ │ │ │ +00042590: 6869 2e69 6e66 6f2c 2020 4e6f 6465 3a20  hi.info,  Node: 
│ │ │ │ +000425a0: 4765 6e65 7269 6320 5365 6375 7269 7479  Generic Security
│ │ │ │ +000425b0: 2053 6572 7669 6365 2c20 2050 7265 763a   Service,  Prev:
│ │ │ │ +000425c0: 204b 6572 6265 726f 7320 4461 7461 6261   Kerberos Databa
│ │ │ │ +000425d0: 7365 2046 756e 6374 696f 6e73 2c20 2055  se Functions,  U
│ │ │ │ +000425e0: 703a 2050 726f 6772 616d 6d69 6e67 204d  p: Programming M
│ │ │ │ +000425f0: 616e 7561 6c0a 0a35 2e32 3020 4765 6e65  anual..5.20 Gene
│ │ │ │ +00042600: 7269 6320 5365 6375 7269 7479 2053 6572  ric Security Ser
│ │ │ │ +00042610: 7669 6365 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d  vice.===========
│ │ │ │  00042620: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ -00042630: 3d0a 0a41 7320 616e 2061 6c74 6572 6e61  =..As an alterna
│ │ │ │ -00042640: 7469 7665 2074 6f20 7468 6520 6e61 7469  tive to the nati
│ │ │ │ -00042650: 7665 2053 6869 7368 6920 7072 6f67 7261  ve Shishi progra
│ │ │ │ -00042660: 6d6d 696e 6720 4150 492c 2069 7420 6973  mming API, it is
│ │ │ │ -00042670: 2070 6f73 7369 626c 650a 746f 2070 726f   possible.to pro
│ │ │ │ -00042680: 6772 616d 2053 6869 7368 6920 7468 726f  gram Shishi thro
│ │ │ │ -00042690: 7567 6820 7468 6520 4765 6e65 7269 6320  ugh the Generic 
│ │ │ │ -000426a0: 5365 6375 7269 7479 2053 6572 7669 6365  Security Service
│ │ │ │ -000426b0: 7320 2847 5353 2920 4150 492e 2054 6865  s (GSS) API. The
│ │ │ │ -000426c0: 0a61 6476 616e 7461 6765 206f 6620 7573  .advantage of us
│ │ │ │ -000426d0: 696e 6720 4753 532d 4150 4920 696e 2079  ing GSS-API in y
│ │ │ │ -000426e0: 6f75 7220 7365 6375 7269 7479 2061 7070  our security app
│ │ │ │ -000426f0: 6c69 6361 7469 6f6e 2c20 696e 7374 6561  lication, instea
│ │ │ │ -00042700: 6420 6f66 2074 6865 0a6e 6174 6976 6520  d of the.native 
│ │ │ │ -00042710: 5368 6973 6869 2041 5049 2c20 6973 2074  Shishi API, is t
│ │ │ │ -00042720: 6861 7420 6974 2077 696c 6c20 6265 2065  hat it will be e
│ │ │ │ -00042730: 6173 6965 7220 746f 2070 6f72 7420 796f  asier to port yo
│ │ │ │ -00042740: 7572 2061 7070 6c69 6361 7469 6f6e 0a62  ur application.b
│ │ │ │ -00042750: 6574 7765 656e 2064 6966 6665 7265 6e74  etween different
│ │ │ │ -00042760: 204b 6572 6265 726f 7320 3520 696d 706c   Kerberos 5 impl
│ │ │ │ -00042770: 656d 656e 7461 7469 6f6e 732c 2061 6e64  ementations, and
│ │ │ │ -00042780: 2065 7665 6e20 6265 796f 6e64 204b 6572   even beyond Ker
│ │ │ │ -00042790: 6265 726f 7320 350a 746f 2064 6966 6665  beros 5.to diffe
│ │ │ │ -000427a0: 7265 6e74 2073 6563 7572 6974 7920 7379  rent security sy
│ │ │ │ -000427b0: 7374 656d 732c 2074 6861 7420 7375 7070  stems, that supp
│ │ │ │ -000427c0: 6f72 7420 4753 532d 4150 492e 2049 6e20  ort GSS-API. In 
│ │ │ │ -000427d0: 7468 6520 6672 6565 0a73 6f66 7477 6172  the free.softwar
│ │ │ │ -000427e0: 6520 776f 726c 642c 2068 6f77 6576 6572  e world, however
│ │ │ │ -000427f0: 2c20 616c 6d6f 7374 2074 6865 206f 6e6c  , almost the onl
│ │ │ │ -00042800: 7920 7769 6465 6c79 2075 7365 6420 7365  y widely used se
│ │ │ │ -00042810: 6375 7269 7479 2073 7973 7465 6d0a 7468  curity system.th
│ │ │ │ -00042820: 6174 2073 7570 706f 7274 7320 4753 532d  at supports GSS-
│ │ │ │ -00042830: 4150 4920 6973 204b 6572 6265 726f 7320  API is Kerberos 
│ │ │ │ -00042840: 352c 2073 6f20 7468 6520 6c61 7374 2061  5, so the last a
│ │ │ │ -00042850: 6476 616e 7461 6765 2069 7320 736f 6d65  dvantage is some
│ │ │ │ -00042860: 7768 6174 0a61 6361 6465 6d69 632e 2020  what.academic.  
│ │ │ │ -00042870: 4275 7420 6966 2079 6f75 2061 7265 2070  But if you are p
│ │ │ │ -00042880: 6f72 7469 6e67 2061 7070 6c69 6361 7469  orting applicati
│ │ │ │ -00042890: 6f6e 7320 7573 696e 6720 4753 532d 4150  ons using GSS-AP
│ │ │ │ -000428a0: 4920 666f 7220 6f74 6865 720a 4b65 7262  I for other.Kerb
│ │ │ │ -000428b0: 6572 6f73 2035 2069 6d70 6c65 6d65 6e74  eros 5 implement
│ │ │ │ -000428c0: 6174 696f 6e73 2c20 6f72 2077 616e 7420  ations, or want 
│ │ │ │ -000428d0: 6120 6d6f 7265 206d 6174 7572 6520 616e  a more mature an
│ │ │ │ -000428e0: 6420 7374 6162 6c65 2041 5049 2074 6861  d stable API tha
│ │ │ │ -000428f0: 6e0a 7468 6520 6e61 7469 7665 2053 6869  n.the native Shi
│ │ │ │ -00042900: 7368 6920 4150 492c 2079 6f75 206d 6179  shi API, you may
│ │ │ │ -00042910: 2066 696e 6420 7573 696e 6720 5368 6973   find using Shis
│ │ │ │ -00042920: 6869 2773 2047 5353 2d41 5049 2069 6e74  hi's GSS-API int
│ │ │ │ -00042930: 6572 6661 6365 0a63 6f6d 7065 6c6c 696e  erface.compellin
│ │ │ │ -00042940: 672e 2020 4e6f 7465 2074 6861 7420 4753  g.  Note that GS
│ │ │ │ -00042950: 532d 4150 4920 6f6e 6c79 206f 6666 6572  S-API only offer
│ │ │ │ -00042960: 2062 6173 6963 2073 6572 7669 6365 732c   basic services,
│ │ │ │ -00042970: 2066 6f72 206d 6f72 650a 6164 7661 6e63   for more.advanc
│ │ │ │ -00042980: 6564 2075 7365 7320 796f 7520 6d75 7374  ed uses you must
│ │ │ │ -00042990: 2075 7365 2074 6865 206e 6174 6976 6520   use the native 
│ │ │ │ -000429a0: 4150 492e 0a0a 2020 2053 696e 6365 2074  API...   Since t
│ │ │ │ -000429b0: 6865 2047 5353 2d41 5049 2069 7320 6e6f  he GSS-API is no
│ │ │ │ -000429c0: 7420 7370 6563 6966 6963 2074 6f20 5368  t specific to Sh
│ │ │ │ -000429d0: 6973 6869 2c20 6974 2069 7320 6469 7374  ishi, it is dist
│ │ │ │ -000429e0: 7269 6275 7465 640a 696e 6465 7065 6e64  ributed.independ
│ │ │ │ -000429f0: 656e 746c 7920 6672 6f6d 2053 6869 7368  ently from Shish
│ │ │ │ -00042a00: 692e 2020 4675 7274 6865 7220 696e 666f  i.  Further info
│ │ │ │ -00042a10: 726d 6174 696f 6e20 6f6e 2074 6865 2047  rmation on the G
│ │ │ │ -00042a20: 5353 2070 726f 6a65 6374 2063 616e 0a62  SS project can.b
│ │ │ │ -00042a30: 6520 666f 756e 6420 6174 203c 6874 7470  e found at <http
│ │ │ │ -00042a40: 3a2f 2f77 7777 2e67 6e75 2e6f 7267 2f73  ://www.gnu.org/s
│ │ │ │ -00042a50: 6f66 7477 6172 652f 6773 732f 3e2e 0a0a  oftware/gss/>...
│ │ │ │ -00042a60: 1f0a 4669 6c65 3a20 7368 6973 6869 2e69  ..File: shishi.i
│ │ │ │ -00042a70: 6e66 6f2c 2020 4e6f 6465 3a20 4163 6b6e  nfo,  Node: Ackn
│ │ │ │ -00042a80: 6f77 6c65 6467 656d 656e 7473 2c20 204e  owledgements,  N
│ │ │ │ -00042a90: 6578 743a 2043 7269 7469 6369 736d 206f  ext: Criticism o
│ │ │ │ -00042aa0: 6620 4b65 7262 6572 6f73 2c20 2050 7265  f Kerberos,  Pre
│ │ │ │ -00042ab0: 763a 2050 726f 6772 616d 6d69 6e67 204d  v: Programming M
│ │ │ │ -00042ac0: 616e 7561 6c2c 2020 5570 3a20 546f 700a  anual,  Up: Top.
│ │ │ │ -00042ad0: 0a36 2041 636b 6e6f 776c 6564 6765 6d65  .6 Acknowledgeme
│ │ │ │ -00042ae0: 6e74 730a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a  nts.************
│ │ │ │ -00042af0: 2a2a 2a2a 2a2a 0a0a 5368 6973 6869 2075  ******..Shishi u
│ │ │ │ -00042b00: 7365 7320 4c69 6274 6173 6e31 2062 7920  ses Libtasn1 by 
│ │ │ │ -00042b10: 4661 6269 6f20 4669 6f72 696e 612c 204c  Fabio Fiorina, L
│ │ │ │ -00042b20: 6962 6763 7279 7074 2061 6e64 204c 6962  ibgcrypt and Lib
│ │ │ │ -00042b30: 6770 672d 6572 726f 7220 6279 0a57 6572  gpg-error by.Wer
│ │ │ │ -00042b40: 6e65 7220 4b6f 6368 2c20 4c69 6269 646e  ner Koch, Libidn
│ │ │ │ -00042b50: 2062 7920 5369 6d6f 6e20 4a6f 7365 6673   by Simon Josefs
│ │ │ │ -00042b60: 736f 6e2c 2063 7673 3263 6c20 6279 204b  son, cvs2cl by K
│ │ │ │ -00042b70: 6172 6c20 466f 6765 6c2c 2061 6e64 2067  arl Fogel, and g
│ │ │ │ -00042b80: 646f 630a 6279 204d 6963 6861 656c 205a  doc.by Michael Z
│ │ │ │ -00042b90: 7563 6368 692e 0a0a 2020 2053 6576 6572  ucchi...   Sever
│ │ │ │ -00042ba0: 616c 2047 4e55 2070 6163 6b61 6765 7320  al GNU packages 
│ │ │ │ -00042bb0: 7369 6d70 6c69 6669 6564 2064 6576 656c  simplified devel
│ │ │ │ -00042bc0: 6f70 6d65 6e74 2063 6f6e 7369 6465 7261  opment considera
│ │ │ │ -00042bd0: 626c 792c 2074 686f 7365 0a70 6163 6b61  bly, those.packa
│ │ │ │ -00042be0: 6765 7320 696e 636c 7564 6520 4175 746f  ges include Auto
│ │ │ │ -00042bf0: 636f 6e66 2c20 4175 746f 6d61 6b65 2c20  conf, Automake, 
│ │ │ │ -00042c00: 4c69 6274 6f6f 6c2c 2047 6e75 6c69 622c  Libtool, Gnulib,
│ │ │ │ -00042c10: 2047 6574 7465 7874 2c20 496e 6465 6e74   Gettext, Indent
│ │ │ │ -00042c20: 2c0a 4356 532c 2054 6578 696e 666f 2c20  ,.CVS, Texinfo, 
│ │ │ │ -00042c30: 4865 6c70 326d 616e 2061 6e64 2045 6d61  Help2man and Ema
│ │ │ │ -00042c40: 6373 2e0a 0a20 2020 5365 7665 7261 6c20  cs...   Several 
│ │ │ │ -00042c50: 7065 6f70 6c65 2072 6570 6f72 7465 6420  people reported 
│ │ │ │ -00042c60: 6275 6773 2c20 7365 6e74 2070 6174 6368  bugs, sent patch
│ │ │ │ -00042c70: 6573 206f 7220 7375 6767 6573 7465 6420  es or suggested 
│ │ │ │ -00042c80: 696d 7072 6f76 656d 656e 7473 2c0a 7365  improvements,.se
│ │ │ │ -00042c90: 6520 7468 6520 6669 6c65 2054 4841 4e4b  e the file THANK
│ │ │ │ -00042ca0: 532e 0a0a 2020 204e 6963 6f6c 6173 2050  S...   Nicolas P
│ │ │ │ -00042cb0: 6f75 7665 736c 6520 7772 6f74 6520 7468  ouvesle wrote th
│ │ │ │ -00042cc0: 6520 7365 6374 696f 6e20 6162 6f75 7420  e section about 
│ │ │ │ -00042cd0: 7468 6520 4b65 7262 6572 6f73 2072 7368  the Kerberos rsh
│ │ │ │ -00042ce0: 2f72 6c6f 6769 6e0a 7072 6f74 6f63 6f6c  /rlogin.protocol
│ │ │ │ -00042cf0: 2e0a 0a20 2020 5468 6973 206d 616e 7561  ...   This manua
│ │ │ │ -00042d00: 6c20 626f 7272 6f77 7320 7465 7874 2066  l borrows text f
│ │ │ │ -00042d10: 726f 6d20 7468 6520 4b65 7262 6572 6f73  rom the Kerberos
│ │ │ │ -00042d20: 2035 2073 7065 6369 6669 6361 7469 6f6e   5 specification
│ │ │ │ -00042d30: 2e0a 0a1f 0a46 696c 653a 2073 6869 7368  .....File: shish
│ │ │ │ -00042d40: 692e 696e 666f 2c20 204e 6f64 653a 2043  i.info,  Node: C
│ │ │ │ -00042d50: 7269 7469 6369 736d 206f 6620 4b65 7262  riticism of Kerb
│ │ │ │ -00042d60: 6572 6f73 2c20 204e 6578 743a 2050 726f  eros,  Next: Pro
│ │ │ │ -00042d70: 746f 636f 6c20 4578 7465 6e73 696f 6e73  tocol Extensions
│ │ │ │ -00042d80: 2c20 2050 7265 763a 2041 636b 6e6f 776c  ,  Prev: Acknowl
│ │ │ │ -00042d90: 6564 6765 6d65 6e74 732c 2020 5570 3a20  edgements,  Up: 
│ │ │ │ -00042da0: 546f 700a 0a41 7070 656e 6469 7820 4120  Top..Appendix A 
│ │ │ │ -00042db0: 4372 6974 6963 6973 6d20 6f66 204b 6572  Criticism of Ker
│ │ │ │ -00042dc0: 6265 726f 730a 2a2a 2a2a 2a2a 2a2a 2a2a  beros.**********
│ │ │ │ +00042630: 3d3d 0a0a 4173 2061 6e20 616c 7465 726e  ==..As an altern
│ │ │ │ +00042640: 6174 6976 6520 746f 2074 6865 206e 6174  ative to the nat
│ │ │ │ +00042650: 6976 6520 5368 6973 6869 2070 726f 6772  ive Shishi progr
│ │ │ │ +00042660: 616d 6d69 6e67 2041 5049 2c20 6974 2069  amming API, it i
│ │ │ │ +00042670: 7320 706f 7373 6962 6c65 0a74 6f20 7072  s possible.to pr
│ │ │ │ +00042680: 6f67 7261 6d20 5368 6973 6869 2074 6872  ogram Shishi thr
│ │ │ │ +00042690: 6f75 6768 2074 6865 2047 656e 6572 6963  ough the Generic
│ │ │ │ +000426a0: 2053 6563 7572 6974 7920 5365 7276 6963   Security Servic
│ │ │ │ +000426b0: 6573 2028 4753 5329 2041 5049 2e20 5468  es (GSS) API. Th
│ │ │ │ +000426c0: 650a 6164 7661 6e74 6167 6520 6f66 2075  e.advantage of u
│ │ │ │ +000426d0: 7369 6e67 2047 5353 2d41 5049 2069 6e20  sing GSS-API in 
│ │ │ │ +000426e0: 796f 7572 2073 6563 7572 6974 7920 6170  your security ap
│ │ │ │ +000426f0: 706c 6963 6174 696f 6e2c 2069 6e73 7465  plication, inste
│ │ │ │ +00042700: 6164 206f 6620 7468 650a 6e61 7469 7665  ad of the.native
│ │ │ │ +00042710: 2053 6869 7368 6920 4150 492c 2069 7320   Shishi API, is 
│ │ │ │ +00042720: 7468 6174 2069 7420 7769 6c6c 2062 6520  that it will be 
│ │ │ │ +00042730: 6561 7369 6572 2074 6f20 706f 7274 2079  easier to port y
│ │ │ │ +00042740: 6f75 7220 6170 706c 6963 6174 696f 6e0a  our application.
│ │ │ │ +00042750: 6265 7477 6565 6e20 6469 6666 6572 656e  between differen
│ │ │ │ +00042760: 7420 4b65 7262 6572 6f73 2035 2069 6d70  t Kerberos 5 imp
│ │ │ │ +00042770: 6c65 6d65 6e74 6174 696f 6e73 2c20 616e  lementations, an
│ │ │ │ +00042780: 6420 6576 656e 2062 6579 6f6e 6420 4b65  d even beyond Ke
│ │ │ │ +00042790: 7262 6572 6f73 2035 0a74 6f20 6469 6666  rberos 5.to diff
│ │ │ │ +000427a0: 6572 656e 7420 7365 6375 7269 7479 2073  erent security s
│ │ │ │ +000427b0: 7973 7465 6d73 2c20 7468 6174 2073 7570  ystems, that sup
│ │ │ │ +000427c0: 706f 7274 2047 5353 2d41 5049 2e20 496e  port GSS-API. In
│ │ │ │ +000427d0: 2074 6865 2066 7265 650a 736f 6674 7761   the free.softwa
│ │ │ │ +000427e0: 7265 2077 6f72 6c64 2c20 686f 7765 7665  re world, howeve
│ │ │ │ +000427f0: 722c 2061 6c6d 6f73 7420 7468 6520 6f6e  r, almost the on
│ │ │ │ +00042800: 6c79 2077 6964 656c 7920 7573 6564 2073  ly widely used s
│ │ │ │ +00042810: 6563 7572 6974 7920 7379 7374 656d 0a74  ecurity system.t
│ │ │ │ +00042820: 6861 7420 7375 7070 6f72 7473 2047 5353  hat supports GSS
│ │ │ │ +00042830: 2d41 5049 2069 7320 4b65 7262 6572 6f73  -API is Kerberos
│ │ │ │ +00042840: 2035 2c20 736f 2074 6865 206c 6173 7420   5, so the last 
│ │ │ │ +00042850: 6164 7661 6e74 6167 6520 6973 2073 6f6d  advantage is som
│ │ │ │ +00042860: 6577 6861 740a 6163 6164 656d 6963 2e20  ewhat.academic. 
│ │ │ │ +00042870: 2042 7574 2069 6620 796f 7520 6172 6520   But if you are 
│ │ │ │ +00042880: 706f 7274 696e 6720 6170 706c 6963 6174  porting applicat
│ │ │ │ +00042890: 696f 6e73 2075 7369 6e67 2047 5353 2d41  ions using GSS-A
│ │ │ │ +000428a0: 5049 2066 6f72 206f 7468 6572 0a4b 6572  PI for other.Ker
│ │ │ │ +000428b0: 6265 726f 7320 3520 696d 706c 656d 656e  beros 5 implemen
│ │ │ │ +000428c0: 7461 7469 6f6e 732c 206f 7220 7761 6e74  tations, or want
│ │ │ │ +000428d0: 2061 206d 6f72 6520 6d61 7475 7265 2061   a more mature a
│ │ │ │ +000428e0: 6e64 2073 7461 626c 6520 4150 4920 7468  nd stable API th
│ │ │ │ +000428f0: 616e 0a74 6865 206e 6174 6976 6520 5368  an.the native Sh
│ │ │ │ +00042900: 6973 6869 2041 5049 2c20 796f 7520 6d61  ishi API, you ma
│ │ │ │ +00042910: 7920 6669 6e64 2075 7369 6e67 2053 6869  y find using Shi
│ │ │ │ +00042920: 7368 6927 7320 4753 532d 4150 4920 696e  shi's GSS-API in
│ │ │ │ +00042930: 7465 7266 6163 650a 636f 6d70 656c 6c69  terface.compelli
│ │ │ │ +00042940: 6e67 2e20 204e 6f74 6520 7468 6174 2047  ng.  Note that G
│ │ │ │ +00042950: 5353 2d41 5049 206f 6e6c 7920 6f66 6665  SS-API only offe
│ │ │ │ +00042960: 7220 6261 7369 6320 7365 7276 6963 6573  r basic services
│ │ │ │ +00042970: 2c20 666f 7220 6d6f 7265 0a61 6476 616e  , for more.advan
│ │ │ │ +00042980: 6365 6420 7573 6573 2079 6f75 206d 7573  ced uses you mus
│ │ │ │ +00042990: 7420 7573 6520 7468 6520 6e61 7469 7665  t use the native
│ │ │ │ +000429a0: 2041 5049 2e0a 0a20 2020 5369 6e63 6520   API...   Since 
│ │ │ │ +000429b0: 7468 6520 4753 532d 4150 4920 6973 206e  the GSS-API is n
│ │ │ │ +000429c0: 6f74 2073 7065 6369 6669 6320 746f 2053  ot specific to S
│ │ │ │ +000429d0: 6869 7368 692c 2069 7420 6973 2064 6973  hishi, it is dis
│ │ │ │ +000429e0: 7472 6962 7574 6564 0a69 6e64 6570 656e  tributed.indepen
│ │ │ │ +000429f0: 6465 6e74 6c79 2066 726f 6d20 5368 6973  dently from Shis
│ │ │ │ +00042a00: 6869 2e20 2046 7572 7468 6572 2069 6e66  hi.  Further inf
│ │ │ │ +00042a10: 6f72 6d61 7469 6f6e 206f 6e20 7468 6520  ormation on the 
│ │ │ │ +00042a20: 4753 5320 7072 6f6a 6563 7420 6361 6e0a  GSS project can.
│ │ │ │ +00042a30: 6265 2066 6f75 6e64 2061 7420 3c68 7474  be found at <htt
│ │ │ │ +00042a40: 703a 2f2f 7777 772e 676e 752e 6f72 672f  p://www.gnu.org/
│ │ │ │ +00042a50: 736f 6674 7761 7265 2f67 7373 2f3e 2e0a  software/gss/>..
│ │ │ │ +00042a60: 0a1f 0a46 696c 653a 2073 6869 7368 692e  ...File: shishi.
│ │ │ │ +00042a70: 696e 666f 2c20 204e 6f64 653a 2041 636b  info,  Node: Ack
│ │ │ │ +00042a80: 6e6f 776c 6564 6765 6d65 6e74 732c 2020  nowledgements,  
│ │ │ │ +00042a90: 4e65 7874 3a20 4372 6974 6963 6973 6d20  Next: Criticism 
│ │ │ │ +00042aa0: 6f66 204b 6572 6265 726f 732c 2020 5072  of Kerberos,  Pr
│ │ │ │ +00042ab0: 6576 3a20 5072 6f67 7261 6d6d 696e 6720  ev: Programming 
│ │ │ │ +00042ac0: 4d61 6e75 616c 2c20 2055 703a 2054 6f70  Manual,  Up: Top
│ │ │ │ +00042ad0: 0a0a 3620 4163 6b6e 6f77 6c65 6467 656d  ..6 Acknowledgem
│ │ │ │ +00042ae0: 656e 7473 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a  ents.***********
│ │ │ │ +00042af0: 2a2a 2a2a 2a2a 2a0a 0a53 6869 7368 6920  *******..Shishi 
│ │ │ │ +00042b00: 7573 6573 204c 6962 7461 736e 3120 6279  uses Libtasn1 by
│ │ │ │ +00042b10: 2046 6162 696f 2046 696f 7269 6e61 2c20   Fabio Fiorina, 
│ │ │ │ +00042b20: 4c69 6267 6372 7970 7420 616e 6420 4c69  Libgcrypt and Li
│ │ │ │ +00042b30: 6267 7067 2d65 7272 6f72 2062 790a 5765  bgpg-error by.We
│ │ │ │ +00042b40: 726e 6572 204b 6f63 682c 204c 6962 6964  rner Koch, Libid
│ │ │ │ +00042b50: 6e20 6279 2053 696d 6f6e 204a 6f73 6566  n by Simon Josef
│ │ │ │ +00042b60: 7373 6f6e 2c20 6376 7332 636c 2062 7920  sson, cvs2cl by 
│ │ │ │ +00042b70: 4b61 726c 2046 6f67 656c 2c20 616e 6420  Karl Fogel, and 
│ │ │ │ +00042b80: 6764 6f63 0a62 7920 4d69 6368 6165 6c20  gdoc.by Michael 
│ │ │ │ +00042b90: 5a75 6363 6869 2e0a 0a20 2020 5365 7665  Zucchi...   Seve
│ │ │ │ +00042ba0: 7261 6c20 474e 5520 7061 636b 6167 6573  ral GNU packages
│ │ │ │ +00042bb0: 2073 696d 706c 6966 6965 6420 6465 7665   simplified deve
│ │ │ │ +00042bc0: 6c6f 706d 656e 7420 636f 6e73 6964 6572  lopment consider
│ │ │ │ +00042bd0: 6162 6c79 2c20 7468 6f73 650a 7061 636b  ably, those.pack
│ │ │ │ +00042be0: 6167 6573 2069 6e63 6c75 6465 2041 7574  ages include Aut
│ │ │ │ +00042bf0: 6f63 6f6e 662c 2041 7574 6f6d 616b 652c  oconf, Automake,
│ │ │ │ +00042c00: 204c 6962 746f 6f6c 2c20 476e 756c 6962   Libtool, Gnulib
│ │ │ │ +00042c10: 2c20 4765 7474 6578 742c 2049 6e64 656e  , Gettext, Inden
│ │ │ │ +00042c20: 742c 0a43 5653 2c20 5465 7869 6e66 6f2c  t,.CVS, Texinfo,
│ │ │ │ +00042c30: 2048 656c 7032 6d61 6e20 616e 6420 456d   Help2man and Em
│ │ │ │ +00042c40: 6163 732e 0a0a 2020 2053 6576 6572 616c  acs...   Several
│ │ │ │ +00042c50: 2070 656f 706c 6520 7265 706f 7274 6564   people reported
│ │ │ │ +00042c60: 2062 7567 732c 2073 656e 7420 7061 7463   bugs, sent patc
│ │ │ │ +00042c70: 6865 7320 6f72 2073 7567 6765 7374 6564  hes or suggested
│ │ │ │ +00042c80: 2069 6d70 726f 7665 6d65 6e74 732c 0a73   improvements,.s
│ │ │ │ +00042c90: 6565 2074 6865 2066 696c 6520 5448 414e  ee the file THAN
│ │ │ │ +00042ca0: 4b53 2e0a 0a20 2020 4e69 636f 6c61 7320  KS...   Nicolas 
│ │ │ │ +00042cb0: 506f 7576 6573 6c65 2077 726f 7465 2074  Pouvesle wrote t
│ │ │ │ +00042cc0: 6865 2073 6563 7469 6f6e 2061 626f 7574  he section about
│ │ │ │ +00042cd0: 2074 6865 204b 6572 6265 726f 7320 7273   the Kerberos rs
│ │ │ │ +00042ce0: 682f 726c 6f67 696e 0a70 726f 746f 636f  h/rlogin.protoco
│ │ │ │ +00042cf0: 6c2e 0a0a 2020 2054 6869 7320 6d61 6e75  l...   This manu
│ │ │ │ +00042d00: 616c 2062 6f72 726f 7773 2074 6578 7420  al borrows text 
│ │ │ │ +00042d10: 6672 6f6d 2074 6865 204b 6572 6265 726f  from the Kerbero
│ │ │ │ +00042d20: 7320 3520 7370 6563 6966 6963 6174 696f  s 5 specificatio
│ │ │ │ +00042d30: 6e2e 0a0a 1f0a 4669 6c65 3a20 7368 6973  n.....File: shis
│ │ │ │ +00042d40: 6869 2e69 6e66 6f2c 2020 4e6f 6465 3a20  hi.info,  Node: 
│ │ │ │ +00042d50: 4372 6974 6963 6973 6d20 6f66 204b 6572  Criticism of Ker
│ │ │ │ +00042d60: 6265 726f 732c 2020 4e65 7874 3a20 5072  beros,  Next: Pr
│ │ │ │ +00042d70: 6f74 6f63 6f6c 2045 7874 656e 7369 6f6e  otocol Extension
│ │ │ │ +00042d80: 732c 2020 5072 6576 3a20 4163 6b6e 6f77  s,  Prev: Acknow
│ │ │ │ +00042d90: 6c65 6467 656d 656e 7473 2c20 2055 703a  ledgements,  Up:
│ │ │ │ +00042da0: 2054 6f70 0a0a 4170 7065 6e64 6978 2041   Top..Appendix A
│ │ │ │ +00042db0: 2043 7269 7469 6369 736d 206f 6620 4b65   Criticism of Ke
│ │ │ │ +00042dc0: 7262 6572 6f73 0a2a 2a2a 2a2a 2a2a 2a2a  rberos.*********
│ │ │ │  00042dd0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a  ****************
│ │ │ │ -00042de0: 2a2a 2a2a 2a2a 0a0a 5468 6520 696e 7465  ******..The inte
│ │ │ │ -00042df0: 6e74 696f 6e20 7769 7468 2074 6869 7320  ntion with this 
│ │ │ │ -00042e00: 7365 6374 696f 6e20 6973 2074 6f20 6469  section is to di
│ │ │ │ -00042e10: 7363 7573 7320 7661 7269 6f75 7320 7072  scuss various pr
│ │ │ │ -00042e20: 6f62 6c65 6d73 2077 6974 680a 4b65 7262  oblems with.Kerb
│ │ │ │ -00042e30: 6572 6f73 2035 2c20 736f 2079 6f75 2063  eros 5, so you c
│ │ │ │ -00042e40: 616e 2066 6f72 6d20 6120 636f 6e73 6369  an form a consci
│ │ │ │ -00042e50: 6f75 7320 6465 6369 7369 6f6e 2068 6f77  ous decision how
│ │ │ │ -00042e60: 2074 6f20 6465 706c 6f79 2061 6e64 2075   to deploy and u
│ │ │ │ -00042e70: 7365 0a53 6869 7368 6920 636f 7272 6563  se.Shishi correc
│ │ │ │ -00042e80: 746c 7920 696e 2079 6f75 7220 6f72 6761  tly in your orga
│ │ │ │ -00042e90: 6e69 7a61 7469 6f6e 2e20 2043 7572 7265  nization.  Curre
│ │ │ │ -00042ea0: 6e74 6c79 2074 6865 2069 7373 7565 7320  ntly the issues 
│ │ │ │ -00042eb0: 6265 6c6f 7720 6172 650a 636f 6e64 656e  below are.conden
│ │ │ │ -00042ec0: 7365 642c 2061 6e64 206d 6f73 746c 7920  sed, and mostly 
│ │ │ │ -00042ed0: 7365 7276 6520 6173 2061 2072 656d 696e  serve as a remin
│ │ │ │ -00042ee0: 6465 7220 666f 7220 7468 6520 6175 7468  der for the auth
│ │ │ │ -00042ef0: 6f72 2074 6f20 656c 6162 6f72 6174 6520  or to elaborate 
│ │ │ │ -00042f00: 6f6e 0a74 6865 6d2e 0a0a 2020 204e 6f20  on.them...   No 
│ │ │ │ -00042f10: 656e 6372 7970 7469 6f6e 2073 6368 656d  encryption schem
│ │ │ │ -00042f20: 6520 7769 7468 2073 6563 7572 6974 7920  e with security 
│ │ │ │ -00042f30: 7072 6f6f 662e 0a0a 2020 204e 6f20 7374  proof...   No st
│ │ │ │ -00042f40: 616e 6461 7264 697a 6564 2041 5049 2c20  andardized API, 
│ │ │ │ -00042f50: 616e 6420 4753 5320 6d65 6368 616e 6973  and GSS mechanis
│ │ │ │ -00042f60: 6d20 6c61 636b 2069 6d70 6f72 7461 6e74  m lack important
│ │ │ │ -00042f70: 2066 756e 6374 696f 6e61 6c69 7479 2e0a   functionality..
│ │ │ │ -00042f80: 0a20 2020 4c61 636b 206f 6620 6175 7468  .   Lack of auth
│ │ │ │ -00042f90: 6f72 697a 6174 696f 6e20 7379 7374 656d  orization system
│ │ │ │ -00042fa0: 2e20 2028 6b72 6235 5f6b 7573 6572 6f6b  .  (krb5_kuserok
│ │ │ │ -00042fb0: 2829 290a 0a20 2020 486f 7374 2074 6f20  ())..   Host to 
│ │ │ │ -00042fc0: 7265 616c 6d20 6d61 7070 696e 6720 7265  realm mapping re
│ │ │ │ -00042fd0: 6c69 6573 206f 6e20 696e 7365 6375 7265  lies on insecure
│ │ │ │ -00042fe0: 2044 4e53 206f 7220 7374 6174 6963 2063   DNS or static c
│ │ │ │ -00042ff0: 6f6e 6669 6775 7261 7469 6f6e 0a66 696c  onfiguration.fil
│ │ │ │ -00043000: 6573 2e0a 0a20 2020 496e 666f 726d 6174  es...   Informat
│ │ │ │ -00043010: 696f 6e61 6c20 6d6f 6465 6c20 616e 6420  ional model and 
│ │ │ │ -00043020: 7573 6572 2064 6174 6162 6173 6520 6164  user database ad
│ │ │ │ -00043030: 6d69 6e69 7374 7261 7469 6f6e 2e0a 0a20  ministration... 
│ │ │ │ -00043040: 2020 4e6f 6e2d 666f 726d 616c 2073 7065    Non-formal spe
│ │ │ │ -00043050: 6369 6669 6361 7469 6f6e 2e20 2055 6e63  cification.  Unc
│ │ │ │ -00043060: 6c65 6172 206f 6e20 7468 6520 6574 7970  lear on the etyp
│ │ │ │ -00043070: 6520 746f 2075 7365 2066 6f72 2073 6573  e to use for ses
│ │ │ │ -00043080: 7369 6f6e 0a6b 6579 7320 2865 7479 7065  sion.keys (etype
│ │ │ │ -00043090: 2069 6e20 7265 7175 6573 7420 6f72 2064   in request or d
│ │ │ │ -000430a0: 6174 6162 6173 653f 292e 2020 556e 636c  atabase?).  Uncl
│ │ │ │ -000430b0: 6561 7220 6f6e 2068 6f77 2074 6f20 706f  ear on how to po
│ │ │ │ -000430c0: 7075 6c61 7465 2073 6f6d 650a 2265 7669  pulate some."evi
│ │ │ │ -000430d0: 6465 6e74 2220 6669 656c 6473 2028 652e  dent" fields (e.
│ │ │ │ -000430e0: 672e 2c20 636e 616d 6520 696e 2074 6963  g., cname in tic
│ │ │ │ -000430f0: 6b65 7473 2066 6f72 2041 532d 5245 512c  kets for AS-REQ,
│ │ │ │ -00043100: 206f 7220 6372 6561 6c6d 2c20 636e 616d   or crealm, cnam
│ │ │ │ -00043110: 652c 0a72 6561 6c6d 2c20 736e 616d 652c  e,.realm, sname,
│ │ │ │ -00043120: 2063 7469 6d65 2061 6e64 2063 7573 6563   ctime and cusec
│ │ │ │ -00043130: 2069 6e20 4b52 422d 4552 524f 5229 2e20   in KRB-ERROR). 
│ │ │ │ -00043140: 556e 636c 6561 7220 6572 726f 7220 636f  Unclear error co
│ │ │ │ -00043150: 6465 0a73 656d 616e 7469 6373 2028 652e  de.semantics (e.
│ │ │ │ -00043160: 672e 2c20 6c6f 6769 6320 666f 7220 7768  g., logic for wh
│ │ │ │ -00043170: 656e 2074 6f20 7573 6520 535f 5052 494e  en to use S_PRIN
│ │ │ │ -00043180: 4349 5041 4c5f 554e 4b4e 4f57 4e20 6162  CIPAL_UNKNOWN ab
│ │ │ │ -00043190: 7365 6e74 292e 0a53 6f6d 6520 4b52 422d  sent)..Some KRB-
│ │ │ │ -000431a0: 4552 524f 5220 6669 656c 6473 2061 7265  ERROR fields are
│ │ │ │ -000431b0: 2072 6571 7569 7265 642c 2062 7574 2063   required, but c
│ │ │ │ -000431c0: 616e 2774 2062 6520 7573 6566 756c 6c79  an't be usefully
│ │ │ │ -000431d0: 2070 6f70 756c 6174 6564 2069 6e0a 736f   populated in.so
│ │ │ │ -000431e0: 6d65 2073 6974 7561 7469 6f6e 732c 2061  me situations, a
│ │ │ │ -000431f0: 6e64 206e 6f20 6775 6964 616e 6365 2069  nd no guidance i
│ │ │ │ -00043200: 7320 6769 7665 6e20 6f6e 2077 6861 7420  s given on what 
│ │ │ │ -00043210: 7468 6579 2073 686f 756c 6420 636f 6e74  they should cont
│ │ │ │ -00043220: 6169 6e2e 0a0a 2020 2052 4643 2031 3531  ain...   RFC 151
│ │ │ │ -00043230: 302f 3135 3130 6269 7320 696e 636f 6d70  0/1510bis incomp
│ │ │ │ -00043240: 6174 6962 696c 6974 6965 732e 2020 4e55  atibilities.  NU
│ │ │ │ -00043250: 4c4c 2065 6e63 7479 7065 2072 656d 6f76  LL enctype remov
│ │ │ │ -00043260: 6564 2077 6974 686f 7574 0a64 6973 6375  ed without.discu
│ │ │ │ -00043270: 7373 696f 6e2c 2061 6e64 2069 7420 6973  ssion, and it is
│ │ │ │ -00043280: 2073 7469 6c6c 2075 7365 6420 6279 2073   still used by s
│ │ │ │ -00043290: 6f6d 6520 3139 3634 2047 5353 4150 4920  ome 1964 GSSAPI 
│ │ │ │ -000432a0: 696d 706c 656d 656e 7461 7469 6f6e 732e  implementations.
│ │ │ │ -000432b0: 0a4b 5242 5f53 4146 4520 7465 7874 2028  .KRB_SAFE text (
│ │ │ │ -000432c0: 332e 342e 3129 2073 6179 7320 7468 6520  3.4.1) says the 
│ │ │ │ -000432d0: 6368 6563 6b73 756d 2069 7320 6765 6e65  checksum is gene
│ │ │ │ -000432e0: 7261 7465 6420 7573 696e 6720 7468 6520  rated using the 
│ │ │ │ -000432f0: 7365 7373 696f 6e0a 6f72 2073 7562 2d73  session.or sub-s
│ │ │ │ -00043300: 6573 7369 6f6e 206b 6579 2c20 7768 6963  ession key, whic
│ │ │ │ -00043310: 6820 636f 6e74 7261 6469 6374 7320 6974  h contradicts it
│ │ │ │ -00043320: 7365 6c66 2028 636f 6d70 6172 6520 7365  self (compare se
│ │ │ │ -00043330: 6374 696f 6e20 332e 322e 3629 2061 6e64  ction 3.2.6) and
│ │ │ │ -00043340: 0a61 6c73 6f20 5246 4320 3135 3130 2c20  .also RFC 1510, 
│ │ │ │ -00043350: 7768 6963 6820 626f 7468 2061 6c6c 6f77  which both allow
│ │ │ │ -00043360: 2074 6865 2061 7070 6c69 6361 7469 6f6e   the application
│ │ │ │ -00043370: 2074 6f20 6465 6669 6e65 2074 6865 206b   to define the k
│ │ │ │ -00043380: 6579 2e0a 5665 7269 6669 6361 7469 6f6e  ey..Verification
│ │ │ │ -00043390: 206f 6620 4b52 425f 5341 4645 206e 6f77   of KRB_SAFE now
│ │ │ │ -000433a0: 2072 6571 7569 7265 2074 6865 206b 6579   require the key
│ │ │ │ -000433b0: 2074 6f20 6265 2063 6f6d 7061 7469 626c   to be compatibl
│ │ │ │ -000433c0: 6520 7769 7468 2074 6865 0a28 7375 622d  e with the.(sub-
│ │ │ │ -000433d0: 2973 6573 7369 6f6e 206b 6579 2c20 696e  )session key, in
│ │ │ │ -000433e0: 2031 3531 3020 7468 6520 6f6e 6c79 2072   1510 the only r
│ │ │ │ -000433f0: 6571 7569 7265 6d65 6e74 2077 6173 2074  equirement was t
│ │ │ │ -00043400: 6861 7420 6974 2077 6173 0a63 6f6c 6c69  hat it was.colli
│ │ │ │ -00043410: 7369 6f6e 2070 726f 6f66 2e0a 0a20 2020  sion proof...   
│ │ │ │ -00043420: 5072 6f62 6c65 6d73 2077 6974 6820 5246  Problems with RF
│ │ │ │ -00043430: 4320 3135 3130 6269 732e 2020 5573 6573  C 1510bis.  Uses
│ │ │ │ -00043440: 2062 6967 6e75 6d20 494e 5445 4745 5220   bignum INTEGER 
│ │ │ │ -00043450: 666f 7220 5459 5045 442d 4441 5441 2061  for TYPED-DATA a
│ │ │ │ -00043460: 6e64 0a41 442d 414e 442d 4f52 2e0a 0a20  nd.AD-AND-OR... 
│ │ │ │ -00043470: 2020 5072 6f62 6c65 6d73 2077 6974 6820    Problems with 
│ │ │ │ -00043480: 6372 7970 746f 2073 7065 6369 6669 6361  crypto specifica
│ │ │ │ -00043490: 7469 6f6e 2e20 2049 7420 7573 6573 2074  tion.  It uses t
│ │ │ │ -000434a0: 6865 2077 6f72 6420 2272 616e 646f 6d22  he word "random"
│ │ │ │ -000434b0: 206d 616e 790a 7469 6d65 732c 2062 7574   many.times, but
│ │ │ │ -000434c0: 2074 6865 7265 2069 7320 6e6f 2064 6973   there is no dis
│ │ │ │ -000434d0: 6375 7373 696f 6e20 6f6e 2074 6865 2072  cussion on the r
│ │ │ │ -000434e0: 616e 646f 6d6e 6573 7320 7265 7175 6972  andomness requir
│ │ │ │ -000434f0: 656d 656e 7473 2e0a 5072 6163 7469 6361  ements..Practica
│ │ │ │ -00043500: 6c20 6578 7065 7269 656e 6365 2069 6e64  l experience ind
│ │ │ │ -00043510: 6963 6174 6520 6974 2069 7320 696d 706f  icate it is impo
│ │ │ │ -00043520: 7373 6962 6c65 2074 6f20 7573 6520 7472  ssible to use tr
│ │ │ │ -00043530: 7565 2072 616e 646f 6d6e 6573 730a 666f  ue randomness.fo
│ │ │ │ -00043540: 7220 616c 6c20 2272 616e 646f 6d22 2066  r all "random" f
│ │ │ │ -00043550: 6965 6c64 732c 2061 6e64 206e 6f20 696d  ields, and no im
│ │ │ │ -00043560: 706c 656d 656e 7461 7469 6f6e 2064 6f65  plementation doe
│ │ │ │ -00043570: 7320 7468 6973 2e20 2041 2070 6f73 7420  s this.  A post 
│ │ │ │ -00043580: 6279 2044 6f6e 0a44 6176 6973 206f 6e20  by Don.Davis on 
│ │ │ │ -00043590: 7468 6520 6965 7466 2d6b 7262 2d77 6720  the ietf-krb-wg 
│ │ │ │ -000435a0: 6c69 7374 2074 7269 6564 2074 6f20 7072  list tried to pr
│ │ │ │ -000435b0: 6f76 6964 6520 696e 7369 6768 742c 2062  ovide insight, b
│ │ │ │ -000435c0: 7574 2074 6865 0a69 6e66 6f72 6d61 7469  ut the.informati
│ │ │ │ -000435d0: 6f6e 2077 6173 206e 6576 6572 2061 6464  on was never add
│ │ │ │ -000435e0: 6564 2074 6f20 7468 6520 7370 6563 6966  ed to the specif
│ │ │ │ -000435f0: 6963 6174 696f 6e2e 0a0a 1f0a 4669 6c65  ication.....File
│ │ │ │ -00043600: 3a20 7368 6973 6869 2e69 6e66 6f2c 2020  : shishi.info,  
│ │ │ │ -00043610: 4e6f 6465 3a20 5072 6f74 6f63 6f6c 2045  Node: Protocol E
│ │ │ │ -00043620: 7874 656e 7369 6f6e 732c 2020 4e65 7874  xtensions,  Next
│ │ │ │ -00043630: 3a20 436f 7079 696e 6720 496e 666f 726d  : Copying Inform
│ │ │ │ -00043640: 6174 696f 6e2c 2020 5072 6576 3a20 4372  ation,  Prev: Cr
│ │ │ │ -00043650: 6974 6963 6973 6d20 6f66 204b 6572 6265  iticism of Kerbe
│ │ │ │ -00043660: 726f 732c 2020 5570 3a20 546f 700a 0a41  ros,  Up: Top..A
│ │ │ │ -00043670: 7070 656e 6469 7820 4220 5072 6f74 6f63  ppendix B Protoc
│ │ │ │ -00043680: 6f6c 2045 7874 656e 7369 6f6e 730a 2a2a  ol Extensions.**
│ │ │ │ +00042de0: 2a2a 2a2a 2a2a 2a0a 0a54 6865 2069 6e74  *******..The int
│ │ │ │ +00042df0: 656e 7469 6f6e 2077 6974 6820 7468 6973  ention with this
│ │ │ │ +00042e00: 2073 6563 7469 6f6e 2069 7320 746f 2064   section is to d
│ │ │ │ +00042e10: 6973 6375 7373 2076 6172 696f 7573 2070  iscuss various p
│ │ │ │ +00042e20: 726f 626c 656d 7320 7769 7468 0a4b 6572  roblems with.Ker
│ │ │ │ +00042e30: 6265 726f 7320 352c 2073 6f20 796f 7520  beros 5, so you 
│ │ │ │ +00042e40: 6361 6e20 666f 726d 2061 2063 6f6e 7363  can form a consc
│ │ │ │ +00042e50: 696f 7573 2064 6563 6973 696f 6e20 686f  ious decision ho
│ │ │ │ +00042e60: 7720 746f 2064 6570 6c6f 7920 616e 6420  w to deploy and 
│ │ │ │ +00042e70: 7573 650a 5368 6973 6869 2063 6f72 7265  use.Shishi corre
│ │ │ │ +00042e80: 6374 6c79 2069 6e20 796f 7572 206f 7267  ctly in your org
│ │ │ │ +00042e90: 616e 697a 6174 696f 6e2e 2020 4375 7272  anization.  Curr
│ │ │ │ +00042ea0: 656e 746c 7920 7468 6520 6973 7375 6573  ently the issues
│ │ │ │ +00042eb0: 2062 656c 6f77 2061 7265 0a63 6f6e 6465   below are.conde
│ │ │ │ +00042ec0: 6e73 6564 2c20 616e 6420 6d6f 7374 6c79  nsed, and mostly
│ │ │ │ +00042ed0: 2073 6572 7665 2061 7320 6120 7265 6d69   serve as a remi
│ │ │ │ +00042ee0: 6e64 6572 2066 6f72 2074 6865 2061 7574  nder for the aut
│ │ │ │ +00042ef0: 686f 7220 746f 2065 6c61 626f 7261 7465  hor to elaborate
│ │ │ │ +00042f00: 206f 6e0a 7468 656d 2e0a 0a20 2020 4e6f   on.them...   No
│ │ │ │ +00042f10: 2065 6e63 7279 7074 696f 6e20 7363 6865   encryption sche
│ │ │ │ +00042f20: 6d65 2077 6974 6820 7365 6375 7269 7479  me with security
│ │ │ │ +00042f30: 2070 726f 6f66 2e0a 0a20 2020 4e6f 2073   proof...   No s
│ │ │ │ +00042f40: 7461 6e64 6172 6469 7a65 6420 4150 492c  tandardized API,
│ │ │ │ +00042f50: 2061 6e64 2047 5353 206d 6563 6861 6e69   and GSS mechani
│ │ │ │ +00042f60: 736d 206c 6163 6b20 696d 706f 7274 616e  sm lack importan
│ │ │ │ +00042f70: 7420 6675 6e63 7469 6f6e 616c 6974 792e  t functionality.
│ │ │ │ +00042f80: 0a0a 2020 204c 6163 6b20 6f66 2061 7574  ..   Lack of aut
│ │ │ │ +00042f90: 686f 7269 7a61 7469 6f6e 2073 7973 7465  horization syste
│ │ │ │ +00042fa0: 6d2e 2020 286b 7262 355f 6b75 7365 726f  m.  (krb5_kusero
│ │ │ │ +00042fb0: 6b28 2929 0a0a 2020 2048 6f73 7420 746f  k())..   Host to
│ │ │ │ +00042fc0: 2072 6561 6c6d 206d 6170 7069 6e67 2072   realm mapping r
│ │ │ │ +00042fd0: 656c 6965 7320 6f6e 2069 6e73 6563 7572  elies on insecur
│ │ │ │ +00042fe0: 6520 444e 5320 6f72 2073 7461 7469 6320  e DNS or static 
│ │ │ │ +00042ff0: 636f 6e66 6967 7572 6174 696f 6e0a 6669  configuration.fi
│ │ │ │ +00043000: 6c65 732e 0a0a 2020 2049 6e66 6f72 6d61  les...   Informa
│ │ │ │ +00043010: 7469 6f6e 616c 206d 6f64 656c 2061 6e64  tional model and
│ │ │ │ +00043020: 2075 7365 7220 6461 7461 6261 7365 2061   user database a
│ │ │ │ +00043030: 646d 696e 6973 7472 6174 696f 6e2e 0a0a  dministration...
│ │ │ │ +00043040: 2020 204e 6f6e 2d66 6f72 6d61 6c20 7370     Non-formal sp
│ │ │ │ +00043050: 6563 6966 6963 6174 696f 6e2e 2020 556e  ecification.  Un
│ │ │ │ +00043060: 636c 6561 7220 6f6e 2074 6865 2065 7479  clear on the ety
│ │ │ │ +00043070: 7065 2074 6f20 7573 6520 666f 7220 7365  pe to use for se
│ │ │ │ +00043080: 7373 696f 6e0a 6b65 7973 2028 6574 7970  ssion.keys (etyp
│ │ │ │ +00043090: 6520 696e 2072 6571 7565 7374 206f 7220  e in request or 
│ │ │ │ +000430a0: 6461 7461 6261 7365 3f29 2e20 2055 6e63  database?).  Unc
│ │ │ │ +000430b0: 6c65 6172 206f 6e20 686f 7720 746f 2070  lear on how to p
│ │ │ │ +000430c0: 6f70 756c 6174 6520 736f 6d65 0a22 6576  opulate some."ev
│ │ │ │ +000430d0: 6964 656e 7422 2066 6965 6c64 7320 2865  ident" fields (e
│ │ │ │ +000430e0: 2e67 2e2c 2063 6e61 6d65 2069 6e20 7469  .g., cname in ti
│ │ │ │ +000430f0: 636b 6574 7320 666f 7220 4153 2d52 4551  ckets for AS-REQ
│ │ │ │ +00043100: 2c20 6f72 2063 7265 616c 6d2c 2063 6e61  , or crealm, cna
│ │ │ │ +00043110: 6d65 2c0a 7265 616c 6d2c 2073 6e61 6d65  me,.realm, sname
│ │ │ │ +00043120: 2c20 6374 696d 6520 616e 6420 6375 7365  , ctime and cuse
│ │ │ │ +00043130: 6320 696e 204b 5242 2d45 5252 4f52 292e  c in KRB-ERROR).
│ │ │ │ +00043140: 2055 6e63 6c65 6172 2065 7272 6f72 2063   Unclear error c
│ │ │ │ +00043150: 6f64 650a 7365 6d61 6e74 6963 7320 2865  ode.semantics (e
│ │ │ │ +00043160: 2e67 2e2c 206c 6f67 6963 2066 6f72 2077  .g., logic for w
│ │ │ │ +00043170: 6865 6e20 746f 2075 7365 2053 5f50 5249  hen to use S_PRI
│ │ │ │ +00043180: 4e43 4950 414c 5f55 4e4b 4e4f 574e 2061  NCIPAL_UNKNOWN a
│ │ │ │ +00043190: 6273 656e 7429 2e0a 536f 6d65 204b 5242  bsent)..Some KRB
│ │ │ │ +000431a0: 2d45 5252 4f52 2066 6965 6c64 7320 6172  -ERROR fields ar
│ │ │ │ +000431b0: 6520 7265 7175 6972 6564 2c20 6275 7420  e required, but 
│ │ │ │ +000431c0: 6361 6e27 7420 6265 2075 7365 6675 6c6c  can't be usefull
│ │ │ │ +000431d0: 7920 706f 7075 6c61 7465 6420 696e 0a73  y populated in.s
│ │ │ │ +000431e0: 6f6d 6520 7369 7475 6174 696f 6e73 2c20  ome situations, 
│ │ │ │ +000431f0: 616e 6420 6e6f 2067 7569 6461 6e63 6520  and no guidance 
│ │ │ │ +00043200: 6973 2067 6976 656e 206f 6e20 7768 6174  is given on what
│ │ │ │ +00043210: 2074 6865 7920 7368 6f75 6c64 2063 6f6e   they should con
│ │ │ │ +00043220: 7461 696e 2e0a 0a20 2020 5246 4320 3135  tain...   RFC 15
│ │ │ │ +00043230: 3130 2f31 3531 3062 6973 2069 6e63 6f6d  10/1510bis incom
│ │ │ │ +00043240: 7061 7469 6269 6c69 7469 6573 2e20 204e  patibilities.  N
│ │ │ │ +00043250: 554c 4c20 656e 6374 7970 6520 7265 6d6f  ULL enctype remo
│ │ │ │ +00043260: 7665 6420 7769 7468 6f75 740a 6469 7363  ved without.disc
│ │ │ │ +00043270: 7573 7369 6f6e 2c20 616e 6420 6974 2069  ussion, and it i
│ │ │ │ +00043280: 7320 7374 696c 6c20 7573 6564 2062 7920  s still used by 
│ │ │ │ +00043290: 736f 6d65 2031 3936 3420 4753 5341 5049  some 1964 GSSAPI
│ │ │ │ +000432a0: 2069 6d70 6c65 6d65 6e74 6174 696f 6e73   implementations
│ │ │ │ +000432b0: 2e0a 4b52 425f 5341 4645 2074 6578 7420  ..KRB_SAFE text 
│ │ │ │ +000432c0: 2833 2e34 2e31 2920 7361 7973 2074 6865  (3.4.1) says the
│ │ │ │ +000432d0: 2063 6865 636b 7375 6d20 6973 2067 656e   checksum is gen
│ │ │ │ +000432e0: 6572 6174 6564 2075 7369 6e67 2074 6865  erated using the
│ │ │ │ +000432f0: 2073 6573 7369 6f6e 0a6f 7220 7375 622d   session.or sub-
│ │ │ │ +00043300: 7365 7373 696f 6e20 6b65 792c 2077 6869  session key, whi
│ │ │ │ +00043310: 6368 2063 6f6e 7472 6164 6963 7473 2069  ch contradicts i
│ │ │ │ +00043320: 7473 656c 6620 2863 6f6d 7061 7265 2073  tself (compare s
│ │ │ │ +00043330: 6563 7469 6f6e 2033 2e32 2e36 2920 616e  ection 3.2.6) an
│ │ │ │ +00043340: 640a 616c 736f 2052 4643 2031 3531 302c  d.also RFC 1510,
│ │ │ │ +00043350: 2077 6869 6368 2062 6f74 6820 616c 6c6f   which both allo
│ │ │ │ +00043360: 7720 7468 6520 6170 706c 6963 6174 696f  w the applicatio
│ │ │ │ +00043370: 6e20 746f 2064 6566 696e 6520 7468 6520  n to define the 
│ │ │ │ +00043380: 6b65 792e 0a56 6572 6966 6963 6174 696f  key..Verificatio
│ │ │ │ +00043390: 6e20 6f66 204b 5242 5f53 4146 4520 6e6f  n of KRB_SAFE no
│ │ │ │ +000433a0: 7720 7265 7175 6972 6520 7468 6520 6b65  w require the ke
│ │ │ │ +000433b0: 7920 746f 2062 6520 636f 6d70 6174 6962  y to be compatib
│ │ │ │ +000433c0: 6c65 2077 6974 6820 7468 650a 2873 7562  le with the.(sub
│ │ │ │ +000433d0: 2d29 7365 7373 696f 6e20 6b65 792c 2069  -)session key, i
│ │ │ │ +000433e0: 6e20 3135 3130 2074 6865 206f 6e6c 7920  n 1510 the only 
│ │ │ │ +000433f0: 7265 7175 6972 656d 656e 7420 7761 7320  requirement was 
│ │ │ │ +00043400: 7468 6174 2069 7420 7761 730a 636f 6c6c  that it was.coll
│ │ │ │ +00043410: 6973 696f 6e20 7072 6f6f 662e 0a0a 2020  ision proof...  
│ │ │ │ +00043420: 2050 726f 626c 656d 7320 7769 7468 2052   Problems with R
│ │ │ │ +00043430: 4643 2031 3531 3062 6973 2e20 2055 7365  FC 1510bis.  Use
│ │ │ │ +00043440: 7320 6269 676e 756d 2049 4e54 4547 4552  s bignum INTEGER
│ │ │ │ +00043450: 2066 6f72 2054 5950 4544 2d44 4154 4120   for TYPED-DATA 
│ │ │ │ +00043460: 616e 640a 4144 2d41 4e44 2d4f 522e 0a0a  and.AD-AND-OR...
│ │ │ │ +00043470: 2020 2050 726f 626c 656d 7320 7769 7468     Problems with
│ │ │ │ +00043480: 2063 7279 7074 6f20 7370 6563 6966 6963   crypto specific
│ │ │ │ +00043490: 6174 696f 6e2e 2020 4974 2075 7365 7320  ation.  It uses 
│ │ │ │ +000434a0: 7468 6520 776f 7264 2022 7261 6e64 6f6d  the word "random
│ │ │ │ +000434b0: 2220 6d61 6e79 0a74 696d 6573 2c20 6275  " many.times, bu
│ │ │ │ +000434c0: 7420 7468 6572 6520 6973 206e 6f20 6469  t there is no di
│ │ │ │ +000434d0: 7363 7573 7369 6f6e 206f 6e20 7468 6520  scussion on the 
│ │ │ │ +000434e0: 7261 6e64 6f6d 6e65 7373 2072 6571 7569  randomness requi
│ │ │ │ +000434f0: 7265 6d65 6e74 732e 0a50 7261 6374 6963  rements..Practic
│ │ │ │ +00043500: 616c 2065 7870 6572 6965 6e63 6520 696e  al experience in
│ │ │ │ +00043510: 6469 6361 7465 2069 7420 6973 2069 6d70  dicate it is imp
│ │ │ │ +00043520: 6f73 7369 626c 6520 746f 2075 7365 2074  ossible to use t
│ │ │ │ +00043530: 7275 6520 7261 6e64 6f6d 6e65 7373 0a66  rue randomness.f
│ │ │ │ +00043540: 6f72 2061 6c6c 2022 7261 6e64 6f6d 2220  or all "random" 
│ │ │ │ +00043550: 6669 656c 6473 2c20 616e 6420 6e6f 2069  fields, and no i
│ │ │ │ +00043560: 6d70 6c65 6d65 6e74 6174 696f 6e20 646f  mplementation do
│ │ │ │ +00043570: 6573 2074 6869 732e 2020 4120 706f 7374  es this.  A post
│ │ │ │ +00043580: 2062 7920 446f 6e0a 4461 7669 7320 6f6e   by Don.Davis on
│ │ │ │ +00043590: 2074 6865 2069 6574 662d 6b72 622d 7767   the ietf-krb-wg
│ │ │ │ +000435a0: 206c 6973 7420 7472 6965 6420 746f 2070   list tried to p
│ │ │ │ +000435b0: 726f 7669 6465 2069 6e73 6967 6874 2c20  rovide insight, 
│ │ │ │ +000435c0: 6275 7420 7468 650a 696e 666f 726d 6174  but the.informat
│ │ │ │ +000435d0: 696f 6e20 7761 7320 6e65 7665 7220 6164  ion was never ad
│ │ │ │ +000435e0: 6465 6420 746f 2074 6865 2073 7065 6369  ded to the speci
│ │ │ │ +000435f0: 6669 6361 7469 6f6e 2e0a 0a1f 0a46 696c  fication.....Fil
│ │ │ │ +00043600: 653a 2073 6869 7368 692e 696e 666f 2c20  e: shishi.info, 
│ │ │ │ +00043610: 204e 6f64 653a 2050 726f 746f 636f 6c20   Node: Protocol 
│ │ │ │ +00043620: 4578 7465 6e73 696f 6e73 2c20 204e 6578  Extensions,  Nex
│ │ │ │ +00043630: 743a 2043 6f70 7969 6e67 2049 6e66 6f72  t: Copying Infor
│ │ │ │ +00043640: 6d61 7469 6f6e 2c20 2050 7265 763a 2043  mation,  Prev: C
│ │ │ │ +00043650: 7269 7469 6369 736d 206f 6620 4b65 7262  riticism of Kerb
│ │ │ │ +00043660: 6572 6f73 2c20 2055 703a 2054 6f70 0a0a  eros,  Up: Top..
│ │ │ │ +00043670: 4170 7065 6e64 6978 2042 2050 726f 746f  Appendix B Proto
│ │ │ │ +00043680: 636f 6c20 4578 7465 6e73 696f 6e73 0a2a  col Extensions.*
│ │ │ │  00043690: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a  ****************
│ │ │ │ -000436a0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a 5468  ************..Th
│ │ │ │ -000436b0: 6973 2061 7070 656e 6469 7820 7370 6563  is appendix spec
│ │ │ │ -000436c0: 6966 6965 7320 7468 6520 6e6f 6e2d 7374  ifies the non-st
│ │ │ │ -000436d0: 616e 6461 7264 2070 726f 746f 636f 6c20  andard protocol 
│ │ │ │ -000436e0: 656c 656d 656e 7473 2069 6d70 6c65 6d65  elements impleme
│ │ │ │ -000436f0: 6e74 6564 0a62 7920 5368 6973 6869 2e20  nted.by Shishi. 
│ │ │ │ -00043700: 2042 7920 6e61 7475 7265 206f 6620 6265   By nature of be
│ │ │ │ -00043710: 696e 6720 6e6f 6e2d 7374 616e 6461 7264  ing non-standard
│ │ │ │ -00043720: 2c20 6576 6572 7974 6869 6e67 2064 6573  , everything des
│ │ │ │ -00043730: 6372 6962 6564 2068 6572 650a 6973 2065  cribed here.is e
│ │ │ │ -00043740: 7870 6572 696d 656e 7461 6c2e 2020 436f  xperimental.  Co
│ │ │ │ -00043750: 6d6d 656e 7473 2061 6e64 2066 6565 6462  mments and feedb
│ │ │ │ -00043760: 6163 6b20 6973 2061 7070 7265 6369 6174  ack is appreciat
│ │ │ │ -00043770: 6564 2e0a 0a2a 204d 656e 753a 0a0a 2a20  ed...* Menu:..* 
│ │ │ │ -00043780: 5354 4152 5454 4c53 2070 726f 7465 6374  STARTTLS protect
│ │ │ │ -00043790: 6564 204b 4443 2065 7863 6861 6e67 6573  ed KDC exchanges
│ │ │ │ -000437a0: 3a3a 0948 6f77 2053 6869 7368 6920 7461  ::.How Shishi ta
│ │ │ │ -000437b0: 6c6b 7320 746f 204b 4443 2070 726f 7465  lks to KDC prote
│ │ │ │ -000437c0: 6374 6564 2062 7920 544c 532e 0a2a 2054  cted by TLS..* T
│ │ │ │ -000437d0: 656c 6e65 7420 656e 6372 7970 7469 6f6e  elnet encryption
│ │ │ │ -000437e0: 2077 6974 6820 4145 532d 4343 4d3a 3a20   with AES-CCM:: 
│ │ │ │ -000437f0: 2020 2020 2049 6e74 6567 7269 7479 2061       Integrity a
│ │ │ │ -00043800: 6e64 2070 7269 7661 6379 2070 726f 7465  nd privacy prote
│ │ │ │ -00043810: 6374 6564 2074 656c 6e65 742e 0a2a 204b  cted telnet..* K
│ │ │ │ -00043820: 6572 6265 7269 7a65 6420 7273 6820 616e  erberized rsh an
│ │ │ │ -00043830: 6420 726c 6f67 696e 3a3a 2020 2020 2020  d rlogin::      
│ │ │ │ -00043840: 2020 2020 2044 6573 6372 6970 7469 6f6e       Description
│ │ │ │ -00043850: 206f 6620 4b43 4d44 2070 726f 746f 636f   of KCMD protoco
│ │ │ │ -00043860: 6c2e 0a2a 204b 6579 2061 7320 696e 6974  l..* Key as init
│ │ │ │ -00043870: 6961 6c69 7a61 7469 6f6e 2076 6563 746f  ialization vecto
│ │ │ │ -00043880: 723a 3a20 2020 2020 2020 2053 6f6d 6520  r::        Some 
│ │ │ │ -00043890: 6372 7970 746f 6772 6170 6879 2064 6973  cryptography dis
│ │ │ │ -000438a0: 6375 7373 696f 6e2e 0a2a 2054 6865 204b  cussion..* The K
│ │ │ │ -000438b0: 6579 7461 6220 4269 6e61 7279 2046 696c  eytab Binary Fil
│ │ │ │ -000438c0: 6520 466f 726d 6174 3a3a 2020 2020 2020  e Format::      
│ │ │ │ -000438d0: 2046 6f72 6d61 7420 6f66 206b 6579 7461   Format of keyta
│ │ │ │ -000438e0: 6220 6669 6c65 732e 0a2a 2054 6865 2043  b files..* The C
│ │ │ │ -000438f0: 7265 6465 6e74 6961 6c20 4361 6368 6520  redential Cache 
│ │ │ │ -00043900: 4269 6e61 7279 2046 696c 6520 466f 726d  Binary File Form
│ │ │ │ -00043910: 6174 3a3a 2046 6f72 6d61 7420 6f66 2063  at:: Format of c
│ │ │ │ -00043920: 6361 6368 6520 6669 6c65 732e 0a0a 1f0a  cache files.....
│ │ │ │ -00043930: 4669 6c65 3a20 7368 6973 6869 2e69 6e66  File: shishi.inf
│ │ │ │ -00043940: 6f2c 2020 4e6f 6465 3a20 5354 4152 5454  o,  Node: STARTT
│ │ │ │ -00043950: 4c53 2070 726f 7465 6374 6564 204b 4443  LS protected KDC
│ │ │ │ -00043960: 2065 7863 6861 6e67 6573 2c20 204e 6578   exchanges,  Nex
│ │ │ │ -00043970: 743a 2054 656c 6e65 7420 656e 6372 7970  t: Telnet encryp
│ │ │ │ -00043980: 7469 6f6e 2077 6974 6820 4145 532d 4343  tion with AES-CC
│ │ │ │ -00043990: 4d2c 2020 5570 3a20 5072 6f74 6f63 6f6c  M,  Up: Protocol
│ │ │ │ -000439a0: 2045 7874 656e 7369 6f6e 730a 0a42 2e31   Extensions..B.1
│ │ │ │ -000439b0: 2053 5441 5254 544c 5320 7072 6f74 6563   STARTTLS protec
│ │ │ │ -000439c0: 7465 6420 4b44 4320 6578 6368 616e 6765  ted KDC exchange
│ │ │ │ -000439d0: 730a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  s.==============
│ │ │ │ +000436a0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a54  *************..T
│ │ │ │ +000436b0: 6869 7320 6170 7065 6e64 6978 2073 7065  his appendix spe
│ │ │ │ +000436c0: 6369 6669 6573 2074 6865 206e 6f6e 2d73  cifies the non-s
│ │ │ │ +000436d0: 7461 6e64 6172 6420 7072 6f74 6f63 6f6c  tandard protocol
│ │ │ │ +000436e0: 2065 6c65 6d65 6e74 7320 696d 706c 656d   elements implem
│ │ │ │ +000436f0: 656e 7465 640a 6279 2053 6869 7368 692e  ented.by Shishi.
│ │ │ │ +00043700: 2020 4279 206e 6174 7572 6520 6f66 2062    By nature of b
│ │ │ │ +00043710: 6569 6e67 206e 6f6e 2d73 7461 6e64 6172  eing non-standar
│ │ │ │ +00043720: 642c 2065 7665 7279 7468 696e 6720 6465  d, everything de
│ │ │ │ +00043730: 7363 7269 6265 6420 6865 7265 0a69 7320  scribed here.is 
│ │ │ │ +00043740: 6578 7065 7269 6d65 6e74 616c 2e20 2043  experimental.  C
│ │ │ │ +00043750: 6f6d 6d65 6e74 7320 616e 6420 6665 6564  omments and feed
│ │ │ │ +00043760: 6261 636b 2069 7320 6170 7072 6563 6961  back is apprecia
│ │ │ │ +00043770: 7465 642e 0a0a 2a20 4d65 6e75 3a0a 0a2a  ted...* Menu:..*
│ │ │ │ +00043780: 2053 5441 5254 544c 5320 7072 6f74 6563   STARTTLS protec
│ │ │ │ +00043790: 7465 6420 4b44 4320 6578 6368 616e 6765  ted KDC exchange
│ │ │ │ +000437a0: 733a 3a09 486f 7720 5368 6973 6869 2074  s::.How Shishi t
│ │ │ │ +000437b0: 616c 6b73 2074 6f20 4b44 4320 7072 6f74  alks to KDC prot
│ │ │ │ +000437c0: 6563 7465 6420 6279 2054 4c53 2e0a 2a20  ected by TLS..* 
│ │ │ │ +000437d0: 5465 6c6e 6574 2065 6e63 7279 7074 696f  Telnet encryptio
│ │ │ │ +000437e0: 6e20 7769 7468 2041 4553 2d43 434d 3a3a  n with AES-CCM::
│ │ │ │ +000437f0: 2020 2020 2020 496e 7465 6772 6974 7920        Integrity 
│ │ │ │ +00043800: 616e 6420 7072 6976 6163 7920 7072 6f74  and privacy prot
│ │ │ │ +00043810: 6563 7465 6420 7465 6c6e 6574 2e0a 2a20  ected telnet..* 
│ │ │ │ +00043820: 4b65 7262 6572 697a 6564 2072 7368 2061  Kerberized rsh a
│ │ │ │ +00043830: 6e64 2072 6c6f 6769 6e3a 3a20 2020 2020  nd rlogin::     
│ │ │ │ +00043840: 2020 2020 2020 4465 7363 7269 7074 696f        Descriptio
│ │ │ │ +00043850: 6e20 6f66 204b 434d 4420 7072 6f74 6f63  n of KCMD protoc
│ │ │ │ +00043860: 6f6c 2e0a 2a20 4b65 7920 6173 2069 6e69  ol..* Key as ini
│ │ │ │ +00043870: 7469 616c 697a 6174 696f 6e20 7665 6374  tialization vect
│ │ │ │ +00043880: 6f72 3a3a 2020 2020 2020 2020 536f 6d65  or::        Some
│ │ │ │ +00043890: 2063 7279 7074 6f67 7261 7068 7920 6469   cryptography di
│ │ │ │ +000438a0: 7363 7573 7369 6f6e 2e0a 2a20 5468 6520  scussion..* The 
│ │ │ │ +000438b0: 4b65 7974 6162 2042 696e 6172 7920 4669  Keytab Binary Fi
│ │ │ │ +000438c0: 6c65 2046 6f72 6d61 743a 3a20 2020 2020  le Format::     
│ │ │ │ +000438d0: 2020 466f 726d 6174 206f 6620 6b65 7974    Format of keyt
│ │ │ │ +000438e0: 6162 2066 696c 6573 2e0a 2a20 5468 6520  ab files..* The 
│ │ │ │ +000438f0: 4372 6564 656e 7469 616c 2043 6163 6865  Credential Cache
│ │ │ │ +00043900: 2042 696e 6172 7920 4669 6c65 2046 6f72   Binary File For
│ │ │ │ +00043910: 6d61 743a 3a20 466f 726d 6174 206f 6620  mat:: Format of 
│ │ │ │ +00043920: 6363 6163 6865 2066 696c 6573 2e0a 0a1f  ccache files....
│ │ │ │ +00043930: 0a46 696c 653a 2073 6869 7368 692e 696e  .File: shishi.in
│ │ │ │ +00043940: 666f 2c20 204e 6f64 653a 2053 5441 5254  fo,  Node: START
│ │ │ │ +00043950: 544c 5320 7072 6f74 6563 7465 6420 4b44  TLS protected KD
│ │ │ │ +00043960: 4320 6578 6368 616e 6765 732c 2020 4e65  C exchanges,  Ne
│ │ │ │ +00043970: 7874 3a20 5465 6c6e 6574 2065 6e63 7279  xt: Telnet encry
│ │ │ │ +00043980: 7074 696f 6e20 7769 7468 2041 4553 2d43  ption with AES-C
│ │ │ │ +00043990: 434d 2c20 2055 703a 2050 726f 746f 636f  CM,  Up: Protoco
│ │ │ │ +000439a0: 6c20 4578 7465 6e73 696f 6e73 0a0a 422e  l Extensions..B.
│ │ │ │ +000439b0: 3120 5354 4152 5454 4c53 2070 726f 7465  1 STARTTLS prote
│ │ │ │ +000439c0: 6374 6564 204b 4443 2065 7863 6861 6e67  cted KDC exchang
│ │ │ │ +000439d0: 6573 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  es.=============
│ │ │ │  000439e0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ -000439f0: 3d3d 3d3d 3d3d 0a0a 5368 6973 6869 2069  ======..Shishi i
│ │ │ │ -00043a00: 7320 6162 6c65 2074 6f20 2275 7067 7261  s able to "upgra
│ │ │ │ -00043a10: 6465 2220 5443 5020 636f 6d6d 756e 6963  de" TCP communic
│ │ │ │ -00043a20: 6174 696f 6e73 2077 6974 6820 7468 6520  ations with the 
│ │ │ │ -00043a30: 4b44 4320 746f 2075 7365 2074 6865 0a54  KDC to use the.T
│ │ │ │ -00043a40: 7261 6e73 706f 7274 204c 6179 6572 2053  ransport Layer S
│ │ │ │ -00043a50: 6563 7572 6974 7920 2854 4c53 2920 7072  ecurity (TLS) pr
│ │ │ │ -00043a60: 6f74 6f63 6f6c 2e20 2054 6865 2054 4c53  otocol.  The TLS
│ │ │ │ -00043a70: 2070 726f 746f 636f 6c20 6f66 6665 7273   protocol offers
│ │ │ │ -00043a80: 0a69 6e74 6567 7269 7479 2061 6e64 2070  .integrity and p
│ │ │ │ -00043a90: 7269 7661 6379 2070 726f 7465 6374 6564  rivacy protected
│ │ │ │ -00043aa0: 2065 7863 6861 6e67 6573 2e20 2054 4c53   exchanges.  TLS
│ │ │ │ -00043ab0: 2061 6c73 6f20 6f66 6665 7273 0a61 7574   also offers.aut
│ │ │ │ -00043ac0: 6865 6e74 6963 6174 696f 6e20 7573 696e  hentication usin
│ │ │ │ -00043ad0: 6720 7573 6572 6e61 6d65 2061 6e64 2070  g username and p
│ │ │ │ -00043ae0: 6173 7377 6f72 6473 2c20 582e 3530 3920  asswords, X.509 
│ │ │ │ -00043af0: 6365 7274 6966 6963 6174 6573 2c20 6f72  certificates, or
│ │ │ │ -00043b00: 0a4f 7065 6e50 4750 2063 6572 7469 6669  .OpenPGP certifi
│ │ │ │ -00043b10: 6361 7465 732e 2020 4b65 7262 6572 6f73  cates.  Kerberos
│ │ │ │ -00043b20: 2035 2063 6c61 696d 7320 746f 206f 6666   5 claims to off
│ │ │ │ -00043b30: 6572 2073 6f6d 6520 6f66 2074 6865 7365  er some of these
│ │ │ │ -00043b40: 0a66 6561 7475 7265 732c 2061 6c74 686f  .features, altho
│ │ │ │ -00043b50: 7567 6820 6974 2069 7320 6e6f 7420 6173  ugh it is not as
│ │ │ │ -00043b60: 2072 6963 6820 6173 2074 6865 2054 4c53   rich as the TLS
│ │ │ │ -00043b70: 2070 726f 746f 636f 6c2e 2020 416e 0a69   protocol.  An.i
│ │ │ │ -00043b80: 6e63 6f6e 636c 7573 6976 6520 6c69 7374  nconclusive list
│ │ │ │ -00043b90: 206f 6620 7468 6520 6d6f 7469 7661 7469   of the motivati
│ │ │ │ -00043ba0: 6f6e 2066 6f72 2075 7369 6e67 2054 4c53  on for using TLS
│ │ │ │ -00043bb0: 2069 7320 6769 7665 6e20 6265 6c6f 772e   is given below.
│ │ │ │ -00043bc0: 0a0a 2020 20e2 80a2 2053 6572 7665 7220  ..   ... Server 
│ │ │ │ -00043bd0: 6175 7468 656e 7469 6361 7469 6f6e 206f  authentication o
│ │ │ │ -00043be0: 6620 7468 6520 4b44 4320 746f 2074 6865  f the KDC to the
│ │ │ │ -00043bf0: 2063 6c69 656e 742e 2020 496e 2074 7261   client.  In tra
│ │ │ │ -00043c00: 6469 7469 6f6e 616c 0a20 2020 2020 4b65  ditional.     Ke
│ │ │ │ -00043c10: 7262 6572 6f73 2035 2c20 4b44 4320 6175  rberos 5, KDC au
│ │ │ │ -00043c20: 7468 656e 7469 6361 7469 6f6e 2069 7320  thentication is 
│ │ │ │ -00043c30: 6f6e 6c79 2070 726f 7665 6420 6173 2061  only proved as a
│ │ │ │ -00043c40: 2073 6964 6520 6566 6665 6374 2074 6861   side effect tha
│ │ │ │ -00043c50: 740a 2020 2020 2074 6865 204b 4443 206b  t.     the KDC k
│ │ │ │ -00043c60: 6e6f 7773 2079 6f75 7220 656e 6372 7970  nows your encryp
│ │ │ │ -00043c70: 7469 6f6e 206b 6579 2028 692e 652e 2c20  tion key (i.e., 
│ │ │ │ -00043c80: 796f 7572 2070 6173 7377 6f72 6429 2e0a  your password)..
│ │ │ │ -00043c90: 0a20 2020 e280 a220 436c 6965 6e74 2061  .   ... Client a
│ │ │ │ -00043ca0: 7574 6865 6e74 6963 6174 696f 6e20 6167  uthentication ag
│ │ │ │ -00043cb0: 6169 6e73 7420 4b44 432e 204b 6572 6265  ainst KDC. Kerbe
│ │ │ │ -00043cc0: 726f 7320 3520 6173 7375 6d65 2074 6865  ros 5 assume the
│ │ │ │ -00043cd0: 2075 7365 7220 6b6e 6f77 730a 2020 2020   user knows.    
│ │ │ │ -00043ce0: 2061 206b 6579 2028 7573 7561 6c6c 7920   a key (usually 
│ │ │ │ -00043cf0: 696e 2074 6865 2066 6f72 6d20 6f66 2061  in the form of a
│ │ │ │ -00043d00: 2070 6173 7377 6f72 6429 2e20 2053 6f6d   password).  Som
│ │ │ │ -00043d10: 6574 696d 6573 2065 7874 6572 6e61 6c0a  etimes external.
│ │ │ │ -00043d20: 2020 2020 2066 6163 746f 7273 206d 616b       factors mak
│ │ │ │ -00043d30: 6520 7468 6973 2068 6172 6420 746f 2066  e this hard to f
│ │ │ │ -00043d40: 756c 6669 6c6c 2e20 2049 6e20 736f 6d65  ulfill.  In some
│ │ │ │ -00043d50: 2073 6974 7561 7469 6f6e 732c 2075 7365   situations, use
│ │ │ │ -00043d60: 7273 2061 7265 0a20 2020 2020 6571 7569  rs are.     equi
│ │ │ │ -00043d70: 7070 6564 2077 6974 6820 736d 6172 7420  pped with smart 
│ │ │ │ -00043d80: 6361 7264 7320 7769 7468 2061 2052 5341  cards with a RSA
│ │ │ │ -00043d90: 2061 7574 6865 6e74 6963 6174 696f 6e20   authentication 
│ │ │ │ -00043da0: 6b65 792e 2020 496e 0a20 2020 2020 6f74  key.  In.     ot
│ │ │ │ -00043db0: 6865 7273 2c20 7573 6572 7320 6861 7665  hers, users have
│ │ │ │ -00043dc0: 2061 204f 7065 6e50 4750 2063 6c69 656e   a OpenPGP clien
│ │ │ │ -00043dd0: 7420 6f6e 2074 6865 6972 2064 6573 6b74  t on their deskt
│ │ │ │ -00043de0: 6f70 2c20 7769 7468 2061 2070 7562 6c69  op, with a publi
│ │ │ │ -00043df0: 630a 2020 2020 204f 7065 6e50 4750 206b  c.     OpenPGP k
│ │ │ │ -00043e00: 6579 206b 6e6f 776e 2074 6f20 7468 6520  ey known to the 
│ │ │ │ -00043e10: 7365 7276 6572 2e20 2049 6e20 736f 6d65  server.  In some
│ │ │ │ -00043e20: 2073 6974 7561 7469 6f6e 732c 2074 6865   situations, the
│ │ │ │ -00043e30: 2070 6f6c 6963 790a 2020 2020 206d 6179   policy.     may
│ │ │ │ -00043e40: 2062 6520 7468 6174 2070 6173 7377 6f72   be that passwor
│ │ │ │ -00043e50: 6420 6175 7468 656e 7469 6361 7469 6f6e  d authentication
│ │ │ │ -00043e60: 206d 6179 206f 6e6c 7920 6265 2064 6f6e   may only be don
│ │ │ │ -00043e70: 6520 7468 726f 7567 6820 5352 502e 0a0a  e through SRP...
│ │ │ │ -00043e80: 2020 20e2 80a2 204b 6572 6265 726f 7320     ... Kerberos 
│ │ │ │ -00043e90: 6578 6368 616e 6765 7320 6172 6520 7072  exchanges are pr
│ │ │ │ -00043ea0: 6976 6163 7920 7072 6f74 6563 7465 642e  ivacy protected.
│ │ │ │ -00043eb0: 2020 5061 7274 206f 6620 6d61 6e79 204b    Part of many K
│ │ │ │ -00043ec0: 6572 6265 726f 730a 2020 2020 2070 6163  erberos.     pac
│ │ │ │ -00043ed0: 6b65 7473 2061 7265 2074 7261 6e73 6665  kets are transfe
│ │ │ │ -00043ee0: 7265 6420 7769 7468 6f75 7420 7072 6976  red without priv
│ │ │ │ -00043ef0: 6163 7920 7072 6f74 6563 7469 6f6e 2028  acy protection (
│ │ │ │ -00043f00: 692e 652e 2c0a 2020 2020 2065 6e63 7279  i.e.,.     encry
│ │ │ │ -00043f10: 7074 696f 6e29 2e20 2054 6861 7420 7061  ption).  That pa
│ │ │ │ -00043f20: 7274 2063 6f6e 7461 696e 7320 696e 666f  rt contains info
│ │ │ │ -00043f30: 726d 6174 696f 6e2c 2073 7563 6820 6173  rmation, such as
│ │ │ │ -00043f40: 2074 6865 2063 6c69 656e 740a 2020 2020   the client.    
│ │ │ │ -00043f50: 2070 7269 6e63 6970 616c 206e 616d 652c   principal name,
│ │ │ │ -00043f60: 2074 6865 2073 6572 7665 7220 7072 696e   the server prin
│ │ │ │ -00043f70: 6369 7061 6c20 6e61 6d65 2c20 7468 6520  cipal name, the 
│ │ │ │ -00043f80: 656e 6372 7970 7469 6f6e 2074 7970 6573  encryption types
│ │ │ │ -00043f90: 0a20 2020 2020 7375 7070 6f72 7465 6420  .     supported 
│ │ │ │ -00043fa0: 6279 2074 6865 2063 6c69 656e 742c 2074  by the client, t
│ │ │ │ -00043fb0: 6865 206c 6966 6574 696d 6520 6f66 2074  he lifetime of t
│ │ │ │ -00043fc0: 6963 6b65 7473 2c20 6574 632e 2020 5265  ickets, etc.  Re
│ │ │ │ -00043fd0: 7665 616c 696e 670a 2020 2020 2073 7563  vealing.     suc
│ │ │ │ -00043fe0: 6820 696e 666f 726d 6174 696f 6e20 6973  h information is
│ │ │ │ -00043ff0: 2c20 696e 2073 6f6d 6520 7468 7265 6174  , in some threat
│ │ │ │ -00044000: 206d 6f64 656c 732c 2063 6f6e 7369 6465   models, conside
│ │ │ │ -00044010: 7265 6420 6120 7072 6f62 6c65 6d2e 0a20  red a problem.. 
│ │ │ │ -00044020: 2020 2020 5468 7573 2c20 7468 6973 2065      Thus, this e
│ │ │ │ -00044030: 6e61 626c 6573 2022 616e 6f6e 796d 6974  nables "anonymit
│ │ │ │ -00044040: 7922 2e0a 0a20 2020 e280 a220 5072 6576  y"...   ... Prev
│ │ │ │ -00044050: 656e 7473 2064 6f77 6e67 7261 6465 2061  ents downgrade a
│ │ │ │ -00044060: 7474 6163 6b73 2061 6666 6563 7469 6e67  ttacks affecting
│ │ │ │ -00044070: 2065 6e63 7279 7074 696f 6e20 7479 7065   encryption type
│ │ │ │ -00044080: 732e 2020 5468 650a 2020 2020 2065 6e63  s.  The.     enc
│ │ │ │ -00044090: 7279 7074 696f 6e20 7479 7065 206f 6620  ryption type of 
│ │ │ │ -000440a0: 7468 6520 7469 636b 6574 2069 6e20 4b44  the ticket in KD
│ │ │ │ -000440b0: 432d 5245 5120 6172 6520 7365 6e74 2069  C-REQ are sent i
│ │ │ │ -000440c0: 6e20 7468 6520 636c 6561 7220 696e 0a20  n the clear in. 
│ │ │ │ -000440d0: 2020 2020 4b65 7262 6572 6f73 2035 2e20      Kerberos 5. 
│ │ │ │ -000440e0: 2054 6869 7320 616c 6c6f 7773 2061 6e20   This allows an 
│ │ │ │ -000440f0: 6174 7461 636b 6572 2074 6f20 7265 706c  attacker to repl
│ │ │ │ -00044100: 6163 6520 7468 6520 656e 6372 7970 7469  ace the encrypti
│ │ │ │ -00044110: 6f6e 2074 7970 650a 2020 2020 2077 6974  on type.     wit
│ │ │ │ -00044120: 6820 6120 636f 6d70 726f 6d69 7365 6420  h a compromised 
│ │ │ │ -00044130: 6d65 6368 616e 6973 6d73 2c20 652e 672e  mechanisms, e.g.
│ │ │ │ -00044140: 2020 3536 2d62 6974 2044 4553 2e20 5369    56-bit DES. Si
│ │ │ │ -00044150: 6e63 6520 636c 6965 6e74 7320 696e 0a20  nce clients in. 
│ │ │ │ -00044160: 2020 2020 6765 6e65 7261 6c20 6361 6e6e      general cann
│ │ │ │ -00044170: 6f74 206b 6e6f 7720 7468 6520 656e 6372  ot know the encr
│ │ │ │ -00044180: 7970 7469 6f6e 2074 7970 6573 206f 7468  yption types oth
│ │ │ │ -00044190: 6572 2073 6572 7665 7273 2073 7570 706f  er servers suppo
│ │ │ │ -000441a0: 7274 2c20 6974 0a20 2020 2020 6973 2064  rt, it.     is d
│ │ │ │ -000441b0: 6966 6669 6375 6c74 2066 6f72 2074 6865  ifficult for the
│ │ │ │ -000441c0: 2063 6c69 656e 7420 746f 2064 6574 6563   client to detec
│ │ │ │ -000441d0: 7420 6966 2074 6865 7265 2077 6173 2061  t if there was a
│ │ │ │ -000441e0: 0a20 2020 2020 6d61 6e2d 696e 2d74 6865  .     man-in-the
│ │ │ │ -000441f0: 2d6d 6964 646c 6520 6f72 2069 6620 7468  -middle or if th
│ │ │ │ -00044200: 6520 7265 6d6f 7465 2073 6572 7665 7220  e remote server 
│ │ │ │ -00044210: 7369 6d70 6c79 2064 6964 206e 6f74 2073  simply did not s
│ │ │ │ -00044220: 7570 706f 7274 2061 0a20 2020 2020 7374  upport a.     st
│ │ │ │ -00044230: 726f 6e67 6572 206d 6563 6861 6e69 736d  ronger mechanism
│ │ │ │ -00044240: 2e20 2043 6c69 656e 7473 206d 6179 2063  .  Clients may c
│ │ │ │ -00044250: 686f 7365 2074 6f20 7265 6675 7365 2035  hose to refuse 5
│ │ │ │ -00044260: 362d 6269 7420 4445 530a 2020 2020 2061  6-bit DES.     a
│ │ │ │ -00044270: 6c74 6f67 6574 6865 722c 2062 7574 2069  ltogether, but i
│ │ │ │ -00044280: 6e20 736f 6d65 2065 6e76 6972 6f6e 6d65  n some environme
│ │ │ │ -00044290: 6e74 7320 7468 6973 206c 6561 6473 2074  nts this leads t
│ │ │ │ -000442a0: 6f20 6f70 6572 6174 696f 6e61 6c0a 2020  o operational.  
│ │ │ │ -000442b0: 2020 2064 6966 6669 6375 6c74 6965 732e     difficulties.
│ │ │ │ -000442c0: 0a0a 2020 20e2 80a2 2054 4c53 2069 7320  ..   ... TLS is 
│ │ │ │ -000442d0: 7765 6c6c 2d70 726f 7665 6420 616e 6420  well-proved and 
│ │ │ │ -000442e0: 7468 6520 7072 6f74 6f63 6f6c 2069 7320  the protocol is 
│ │ │ │ -000442f0: 7374 7564 6965 6420 6279 206d 616e 7920  studied by many 
│ │ │ │ -00044300: 7061 7274 6965 732e 0a20 2020 2020 5468  parties..     Th
│ │ │ │ -00044310: 6973 2069 7320 616e 2061 6476 616e 7461  is is an advanta
│ │ │ │ -00044320: 6765 2069 6e20 6e65 7477 6f72 6b20 6465  ge in network de
│ │ │ │ -00044330: 7369 676e 2c20 7768 6572 6520 544c 5320  sign, where TLS 
│ │ │ │ -00044340: 6973 206f 6674 656e 2061 6c72 6561 6479  is often already
│ │ │ │ -00044350: 0a20 2020 2020 6173 7375 6d65 6420 6173  .     assumed as
│ │ │ │ -00044360: 2070 6172 7420 6f66 2074 6865 2073 6f6c   part of the sol
│ │ │ │ -00044370: 7574 696f 6e20 7369 6e63 6520 6974 2069  ution since it i
│ │ │ │ -00044380: 7320 7573 6564 2074 6f20 7072 6f74 6563  s used to protec
│ │ │ │ -00044390: 7420 4854 5450 2c0a 2020 2020 2049 4d41  t HTTP,.     IMA
│ │ │ │ -000443a0: 502c 2053 4d54 5020 6574 632e 2020 496e  P, SMTP etc.  In
│ │ │ │ -000443b0: 2073 6f6d 6520 7468 7265 6174 206d 6f64   some threat mod
│ │ │ │ -000443c0: 656c 732c 2074 6865 2064 6573 6967 6e65  els, the designe
│ │ │ │ -000443d0: 7220 7072 6566 6572 2074 6f0a 2020 2020  r prefer to.    
│ │ │ │ -000443e0: 2072 6564 7563 6520 7468 6520 6e75 6d62   reduce the numb
│ │ │ │ -000443f0: 6572 206f 6620 7072 6f74 6f63 6f6c 7320  er of protocols 
│ │ │ │ -00044400: 7468 6174 2063 616e 2068 7572 7420 7468  that can hurt th
│ │ │ │ -00044410: 6520 6f76 6572 616c 6c20 7379 7374 656d  e overall system
│ │ │ │ -00044420: 0a20 2020 2020 7365 6375 7269 7479 2069  .     security i
│ │ │ │ -00044430: 6620 7468 6579 2061 7265 2063 6f6d 7072  f they are compr
│ │ │ │ -00044440: 6f6d 6973 6564 2e0a 0a20 2020 4f74 6865  omised...   Othe
│ │ │ │ -00044450: 7220 7265 6173 6f6e 7320 666f 7220 7573  r reasons for us
│ │ │ │ -00044460: 696e 6720 544c 5320 6578 6973 7473 2e0a  ing TLS exists..
│ │ │ │ -00044470: 0a42 2e31 2e31 2054 4350 2f49 5020 7472  .B.1.1 TCP/IP tr
│ │ │ │ -00044480: 616e 7370 6f72 7420 7769 7468 2054 4c53  ansport with TLS
│ │ │ │ -00044490: 2075 7067 7261 6465 2028 5354 4152 5454   upgrade (STARTT
│ │ │ │ -000444a0: 4c53 290a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  LS).------------
│ │ │ │ +000439f0: 3d3d 3d3d 3d3d 3d0a 0a53 6869 7368 6920  =======..Shishi 
│ │ │ │ +00043a00: 6973 2061 626c 6520 746f 2022 7570 6772  is able to "upgr
│ │ │ │ +00043a10: 6164 6522 2054 4350 2063 6f6d 6d75 6e69  ade" TCP communi
│ │ │ │ +00043a20: 6361 7469 6f6e 7320 7769 7468 2074 6865  cations with the
│ │ │ │ +00043a30: 204b 4443 2074 6f20 7573 6520 7468 650a   KDC to use the.
│ │ │ │ +00043a40: 5472 616e 7370 6f72 7420 4c61 7965 7220  Transport Layer 
│ │ │ │ +00043a50: 5365 6375 7269 7479 2028 544c 5329 2070  Security (TLS) p
│ │ │ │ +00043a60: 726f 746f 636f 6c2e 2020 5468 6520 544c  rotocol.  The TL
│ │ │ │ +00043a70: 5320 7072 6f74 6f63 6f6c 206f 6666 6572  S protocol offer
│ │ │ │ +00043a80: 730a 696e 7465 6772 6974 7920 616e 6420  s.integrity and 
│ │ │ │ +00043a90: 7072 6976 6163 7920 7072 6f74 6563 7465  privacy protecte
│ │ │ │ +00043aa0: 6420 6578 6368 616e 6765 732e 2020 544c  d exchanges.  TL
│ │ │ │ +00043ab0: 5320 616c 736f 206f 6666 6572 730a 6175  S also offers.au
│ │ │ │ +00043ac0: 7468 656e 7469 6361 7469 6f6e 2075 7369  thentication usi
│ │ │ │ +00043ad0: 6e67 2075 7365 726e 616d 6520 616e 6420  ng username and 
│ │ │ │ +00043ae0: 7061 7373 776f 7264 732c 2058 2e35 3039  passwords, X.509
│ │ │ │ +00043af0: 2063 6572 7469 6669 6361 7465 732c 206f   certificates, o
│ │ │ │ +00043b00: 720a 4f70 656e 5047 5020 6365 7274 6966  r.OpenPGP certif
│ │ │ │ +00043b10: 6963 6174 6573 2e20 204b 6572 6265 726f  icates.  Kerbero
│ │ │ │ +00043b20: 7320 3520 636c 6169 6d73 2074 6f20 6f66  s 5 claims to of
│ │ │ │ +00043b30: 6665 7220 736f 6d65 206f 6620 7468 6573  fer some of thes
│ │ │ │ +00043b40: 650a 6665 6174 7572 6573 2c20 616c 7468  e.features, alth
│ │ │ │ +00043b50: 6f75 6768 2069 7420 6973 206e 6f74 2061  ough it is not a
│ │ │ │ +00043b60: 7320 7269 6368 2061 7320 7468 6520 544c  s rich as the TL
│ │ │ │ +00043b70: 5320 7072 6f74 6f63 6f6c 2e20 2041 6e0a  S protocol.  An.
│ │ │ │ +00043b80: 696e 636f 6e63 6c75 7369 7665 206c 6973  inconclusive lis
│ │ │ │ +00043b90: 7420 6f66 2074 6865 206d 6f74 6976 6174  t of the motivat
│ │ │ │ +00043ba0: 696f 6e20 666f 7220 7573 696e 6720 544c  ion for using TL
│ │ │ │ +00043bb0: 5320 6973 2067 6976 656e 2062 656c 6f77  S is given below
│ │ │ │ +00043bc0: 2e0a 0a20 2020 e280 a220 5365 7276 6572  ...   ... Server
│ │ │ │ +00043bd0: 2061 7574 6865 6e74 6963 6174 696f 6e20   authentication 
│ │ │ │ +00043be0: 6f66 2074 6865 204b 4443 2074 6f20 7468  of the KDC to th
│ │ │ │ +00043bf0: 6520 636c 6965 6e74 2e20 2049 6e20 7472  e client.  In tr
│ │ │ │ +00043c00: 6164 6974 696f 6e61 6c0a 2020 2020 204b  aditional.     K
│ │ │ │ +00043c10: 6572 6265 726f 7320 352c 204b 4443 2061  erberos 5, KDC a
│ │ │ │ +00043c20: 7574 6865 6e74 6963 6174 696f 6e20 6973  uthentication is
│ │ │ │ +00043c30: 206f 6e6c 7920 7072 6f76 6564 2061 7320   only proved as 
│ │ │ │ +00043c40: 6120 7369 6465 2065 6666 6563 7420 7468  a side effect th
│ │ │ │ +00043c50: 6174 0a20 2020 2020 7468 6520 4b44 4320  at.     the KDC 
│ │ │ │ +00043c60: 6b6e 6f77 7320 796f 7572 2065 6e63 7279  knows your encry
│ │ │ │ +00043c70: 7074 696f 6e20 6b65 7920 2869 2e65 2e2c  ption key (i.e.,
│ │ │ │ +00043c80: 2079 6f75 7220 7061 7373 776f 7264 292e   your password).
│ │ │ │ +00043c90: 0a0a 2020 20e2 80a2 2043 6c69 656e 7420  ..   ... Client 
│ │ │ │ +00043ca0: 6175 7468 656e 7469 6361 7469 6f6e 2061  authentication a
│ │ │ │ +00043cb0: 6761 696e 7374 204b 4443 2e20 4b65 7262  gainst KDC. Kerb
│ │ │ │ +00043cc0: 6572 6f73 2035 2061 7373 756d 6520 7468  eros 5 assume th
│ │ │ │ +00043cd0: 6520 7573 6572 206b 6e6f 7773 0a20 2020  e user knows.   
│ │ │ │ +00043ce0: 2020 6120 6b65 7920 2875 7375 616c 6c79    a key (usually
│ │ │ │ +00043cf0: 2069 6e20 7468 6520 666f 726d 206f 6620   in the form of 
│ │ │ │ +00043d00: 6120 7061 7373 776f 7264 292e 2020 536f  a password).  So
│ │ │ │ +00043d10: 6d65 7469 6d65 7320 6578 7465 726e 616c  metimes external
│ │ │ │ +00043d20: 0a20 2020 2020 6661 6374 6f72 7320 6d61  .     factors ma
│ │ │ │ +00043d30: 6b65 2074 6869 7320 6861 7264 2074 6f20  ke this hard to 
│ │ │ │ +00043d40: 6675 6c66 696c 6c2e 2020 496e 2073 6f6d  fulfill.  In som
│ │ │ │ +00043d50: 6520 7369 7475 6174 696f 6e73 2c20 7573  e situations, us
│ │ │ │ +00043d60: 6572 7320 6172 650a 2020 2020 2065 7175  ers are.     equ
│ │ │ │ +00043d70: 6970 7065 6420 7769 7468 2073 6d61 7274  ipped with smart
│ │ │ │ +00043d80: 2063 6172 6473 2077 6974 6820 6120 5253   cards with a RS
│ │ │ │ +00043d90: 4120 6175 7468 656e 7469 6361 7469 6f6e  A authentication
│ │ │ │ +00043da0: 206b 6579 2e20 2049 6e0a 2020 2020 206f   key.  In.     o
│ │ │ │ +00043db0: 7468 6572 732c 2075 7365 7273 2068 6176  thers, users hav
│ │ │ │ +00043dc0: 6520 6120 4f70 656e 5047 5020 636c 6965  e a OpenPGP clie
│ │ │ │ +00043dd0: 6e74 206f 6e20 7468 6569 7220 6465 736b  nt on their desk
│ │ │ │ +00043de0: 746f 702c 2077 6974 6820 6120 7075 626c  top, with a publ
│ │ │ │ +00043df0: 6963 0a20 2020 2020 4f70 656e 5047 5020  ic.     OpenPGP 
│ │ │ │ +00043e00: 6b65 7920 6b6e 6f77 6e20 746f 2074 6865  key known to the
│ │ │ │ +00043e10: 2073 6572 7665 722e 2020 496e 2073 6f6d   server.  In som
│ │ │ │ +00043e20: 6520 7369 7475 6174 696f 6e73 2c20 7468  e situations, th
│ │ │ │ +00043e30: 6520 706f 6c69 6379 0a20 2020 2020 6d61  e policy.     ma
│ │ │ │ +00043e40: 7920 6265 2074 6861 7420 7061 7373 776f  y be that passwo
│ │ │ │ +00043e50: 7264 2061 7574 6865 6e74 6963 6174 696f  rd authenticatio
│ │ │ │ +00043e60: 6e20 6d61 7920 6f6e 6c79 2062 6520 646f  n may only be do
│ │ │ │ +00043e70: 6e65 2074 6872 6f75 6768 2053 5250 2e0a  ne through SRP..
│ │ │ │ +00043e80: 0a20 2020 e280 a220 4b65 7262 6572 6f73  .   ... Kerberos
│ │ │ │ +00043e90: 2065 7863 6861 6e67 6573 2061 7265 2070   exchanges are p
│ │ │ │ +00043ea0: 7269 7661 6379 2070 726f 7465 6374 6564  rivacy protected
│ │ │ │ +00043eb0: 2e20 2050 6172 7420 6f66 206d 616e 7920  .  Part of many 
│ │ │ │ +00043ec0: 4b65 7262 6572 6f73 0a20 2020 2020 7061  Kerberos.     pa
│ │ │ │ +00043ed0: 636b 6574 7320 6172 6520 7472 616e 7366  ckets are transf
│ │ │ │ +00043ee0: 6572 6564 2077 6974 686f 7574 2070 7269  ered without pri
│ │ │ │ +00043ef0: 7661 6379 2070 726f 7465 6374 696f 6e20  vacy protection 
│ │ │ │ +00043f00: 2869 2e65 2e2c 0a20 2020 2020 656e 6372  (i.e.,.     encr
│ │ │ │ +00043f10: 7970 7469 6f6e 292e 2020 5468 6174 2070  yption).  That p
│ │ │ │ +00043f20: 6172 7420 636f 6e74 6169 6e73 2069 6e66  art contains inf
│ │ │ │ +00043f30: 6f72 6d61 7469 6f6e 2c20 7375 6368 2061  ormation, such a
│ │ │ │ +00043f40: 7320 7468 6520 636c 6965 6e74 0a20 2020  s the client.   
│ │ │ │ +00043f50: 2020 7072 696e 6369 7061 6c20 6e61 6d65    principal name
│ │ │ │ +00043f60: 2c20 7468 6520 7365 7276 6572 2070 7269  , the server pri
│ │ │ │ +00043f70: 6e63 6970 616c 206e 616d 652c 2074 6865  ncipal name, the
│ │ │ │ +00043f80: 2065 6e63 7279 7074 696f 6e20 7479 7065   encryption type
│ │ │ │ +00043f90: 730a 2020 2020 2073 7570 706f 7274 6564  s.     supported
│ │ │ │ +00043fa0: 2062 7920 7468 6520 636c 6965 6e74 2c20   by the client, 
│ │ │ │ +00043fb0: 7468 6520 6c69 6665 7469 6d65 206f 6620  the lifetime of 
│ │ │ │ +00043fc0: 7469 636b 6574 732c 2065 7463 2e20 2052  tickets, etc.  R
│ │ │ │ +00043fd0: 6576 6561 6c69 6e67 0a20 2020 2020 7375  evealing.     su
│ │ │ │ +00043fe0: 6368 2069 6e66 6f72 6d61 7469 6f6e 2069  ch information i
│ │ │ │ +00043ff0: 732c 2069 6e20 736f 6d65 2074 6872 6561  s, in some threa
│ │ │ │ +00044000: 7420 6d6f 6465 6c73 2c20 636f 6e73 6964  t models, consid
│ │ │ │ +00044010: 6572 6564 2061 2070 726f 626c 656d 2e0a  ered a problem..
│ │ │ │ +00044020: 2020 2020 2054 6875 732c 2074 6869 7320       Thus, this 
│ │ │ │ +00044030: 656e 6162 6c65 7320 2261 6e6f 6e79 6d69  enables "anonymi
│ │ │ │ +00044040: 7479 222e 0a0a 2020 20e2 80a2 2050 7265  ty"...   ... Pre
│ │ │ │ +00044050: 7665 6e74 7320 646f 776e 6772 6164 6520  vents downgrade 
│ │ │ │ +00044060: 6174 7461 636b 7320 6166 6665 6374 696e  attacks affectin
│ │ │ │ +00044070: 6720 656e 6372 7970 7469 6f6e 2074 7970  g encryption typ
│ │ │ │ +00044080: 6573 2e20 2054 6865 0a20 2020 2020 656e  es.  The.     en
│ │ │ │ +00044090: 6372 7970 7469 6f6e 2074 7970 6520 6f66  cryption type of
│ │ │ │ +000440a0: 2074 6865 2074 6963 6b65 7420 696e 204b   the ticket in K
│ │ │ │ +000440b0: 4443 2d52 4551 2061 7265 2073 656e 7420  DC-REQ are sent 
│ │ │ │ +000440c0: 696e 2074 6865 2063 6c65 6172 2069 6e0a  in the clear in.
│ │ │ │ +000440d0: 2020 2020 204b 6572 6265 726f 7320 352e       Kerberos 5.
│ │ │ │ +000440e0: 2020 5468 6973 2061 6c6c 6f77 7320 616e    This allows an
│ │ │ │ +000440f0: 2061 7474 6163 6b65 7220 746f 2072 6570   attacker to rep
│ │ │ │ +00044100: 6c61 6365 2074 6865 2065 6e63 7279 7074  lace the encrypt
│ │ │ │ +00044110: 696f 6e20 7479 7065 0a20 2020 2020 7769  ion type.     wi
│ │ │ │ +00044120: 7468 2061 2063 6f6d 7072 6f6d 6973 6564  th a compromised
│ │ │ │ +00044130: 206d 6563 6861 6e69 736d 732c 2065 2e67   mechanisms, e.g
│ │ │ │ +00044140: 2e20 2035 362d 6269 7420 4445 532e 2053  .  56-bit DES. S
│ │ │ │ +00044150: 696e 6365 2063 6c69 656e 7473 2069 6e0a  ince clients in.
│ │ │ │ +00044160: 2020 2020 2067 656e 6572 616c 2063 616e       general can
│ │ │ │ +00044170: 6e6f 7420 6b6e 6f77 2074 6865 2065 6e63  not know the enc
│ │ │ │ +00044180: 7279 7074 696f 6e20 7479 7065 7320 6f74  ryption types ot
│ │ │ │ +00044190: 6865 7220 7365 7276 6572 7320 7375 7070  her servers supp
│ │ │ │ +000441a0: 6f72 742c 2069 740a 2020 2020 2069 7320  ort, it.     is 
│ │ │ │ +000441b0: 6469 6666 6963 756c 7420 666f 7220 7468  difficult for th
│ │ │ │ +000441c0: 6520 636c 6965 6e74 2074 6f20 6465 7465  e client to dete
│ │ │ │ +000441d0: 6374 2069 6620 7468 6572 6520 7761 7320  ct if there was 
│ │ │ │ +000441e0: 610a 2020 2020 206d 616e 2d69 6e2d 7468  a.     man-in-th
│ │ │ │ +000441f0: 652d 6d69 6464 6c65 206f 7220 6966 2074  e-middle or if t
│ │ │ │ +00044200: 6865 2072 656d 6f74 6520 7365 7276 6572  he remote server
│ │ │ │ +00044210: 2073 696d 706c 7920 6469 6420 6e6f 7420   simply did not 
│ │ │ │ +00044220: 7375 7070 6f72 7420 610a 2020 2020 2073  support a.     s
│ │ │ │ +00044230: 7472 6f6e 6765 7220 6d65 6368 616e 6973  tronger mechanis
│ │ │ │ +00044240: 6d2e 2020 436c 6965 6e74 7320 6d61 7920  m.  Clients may 
│ │ │ │ +00044250: 6368 6f73 6520 746f 2072 6566 7573 6520  chose to refuse 
│ │ │ │ +00044260: 3536 2d62 6974 2044 4553 0a20 2020 2020  56-bit DES.     
│ │ │ │ +00044270: 616c 746f 6765 7468 6572 2c20 6275 7420  altogether, but 
│ │ │ │ +00044280: 696e 2073 6f6d 6520 656e 7669 726f 6e6d  in some environm
│ │ │ │ +00044290: 656e 7473 2074 6869 7320 6c65 6164 7320  ents this leads 
│ │ │ │ +000442a0: 746f 206f 7065 7261 7469 6f6e 616c 0a20  to operational. 
│ │ │ │ +000442b0: 2020 2020 6469 6666 6963 756c 7469 6573      difficulties
│ │ │ │ +000442c0: 2e0a 0a20 2020 e280 a220 544c 5320 6973  ...   ... TLS is
│ │ │ │ +000442d0: 2077 656c 6c2d 7072 6f76 6564 2061 6e64   well-proved and
│ │ │ │ +000442e0: 2074 6865 2070 726f 746f 636f 6c20 6973   the protocol is
│ │ │ │ +000442f0: 2073 7475 6469 6564 2062 7920 6d61 6e79   studied by many
│ │ │ │ +00044300: 2070 6172 7469 6573 2e0a 2020 2020 2054   parties..     T
│ │ │ │ +00044310: 6869 7320 6973 2061 6e20 6164 7661 6e74  his is an advant
│ │ │ │ +00044320: 6167 6520 696e 206e 6574 776f 726b 2064  age in network d
│ │ │ │ +00044330: 6573 6967 6e2c 2077 6865 7265 2054 4c53  esign, where TLS
│ │ │ │ +00044340: 2069 7320 6f66 7465 6e20 616c 7265 6164   is often alread
│ │ │ │ +00044350: 790a 2020 2020 2061 7373 756d 6564 2061  y.     assumed a
│ │ │ │ +00044360: 7320 7061 7274 206f 6620 7468 6520 736f  s part of the so
│ │ │ │ +00044370: 6c75 7469 6f6e 2073 696e 6365 2069 7420  lution since it 
│ │ │ │ +00044380: 6973 2075 7365 6420 746f 2070 726f 7465  is used to prote
│ │ │ │ +00044390: 6374 2048 5454 502c 0a20 2020 2020 494d  ct HTTP,.     IM
│ │ │ │ +000443a0: 4150 2c20 534d 5450 2065 7463 2e20 2049  AP, SMTP etc.  I
│ │ │ │ +000443b0: 6e20 736f 6d65 2074 6872 6561 7420 6d6f  n some threat mo
│ │ │ │ +000443c0: 6465 6c73 2c20 7468 6520 6465 7369 676e  dels, the design
│ │ │ │ +000443d0: 6572 2070 7265 6665 7220 746f 0a20 2020  er prefer to.   
│ │ │ │ +000443e0: 2020 7265 6475 6365 2074 6865 206e 756d    reduce the num
│ │ │ │ +000443f0: 6265 7220 6f66 2070 726f 746f 636f 6c73  ber of protocols
│ │ │ │ +00044400: 2074 6861 7420 6361 6e20 6875 7274 2074   that can hurt t
│ │ │ │ +00044410: 6865 206f 7665 7261 6c6c 2073 7973 7465  he overall syste
│ │ │ │ +00044420: 6d0a 2020 2020 2073 6563 7572 6974 7920  m.     security 
│ │ │ │ +00044430: 6966 2074 6865 7920 6172 6520 636f 6d70  if they are comp
│ │ │ │ +00044440: 726f 6d69 7365 642e 0a0a 2020 204f 7468  romised...   Oth
│ │ │ │ +00044450: 6572 2072 6561 736f 6e73 2066 6f72 2075  er reasons for u
│ │ │ │ +00044460: 7369 6e67 2054 4c53 2065 7869 7374 732e  sing TLS exists.
│ │ │ │ +00044470: 0a0a 422e 312e 3120 5443 502f 4950 2074  ..B.1.1 TCP/IP t
│ │ │ │ +00044480: 7261 6e73 706f 7274 2077 6974 6820 544c  ransport with TL
│ │ │ │ +00044490: 5320 7570 6772 6164 6520 2853 5441 5254  S upgrade (START
│ │ │ │ +000444a0: 544c 5329 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  TLS).-----------
│ │ │ │  000444b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │  000444c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000444d0: 2d2d 2d2d 2d2d 0a0a 5246 4320 3135 3130  ------..RFC 1510
│ │ │ │ -000444e0: 6269 7320 7265 7175 6972 6573 204b 6572  bis requires Ker
│ │ │ │ -000444f0: 6265 726f 7320 7365 7276 6572 7320 284b  beros servers (K
│ │ │ │ -00044500: 4443 7329 2074 6f20 6163 6365 7074 2054  DCs) to accept T
│ │ │ │ -00044510: 4350 2072 6571 7565 7374 732e 0a45 6163  CP requests..Eac
│ │ │ │ -00044520: 6820 7265 7175 6573 7420 616e 6420 7265  h request and re
│ │ │ │ -00044530: 7370 6f6e 7365 2069 7320 7072 6566 6978  sponse is prefix
│ │ │ │ -00044540: 6564 2062 7920 6120 3420 6f63 7465 7420  ed by a 4 octet 
│ │ │ │ -00044550: 696e 7465 6765 7220 696e 206e 6574 776f  integer in netwo
│ │ │ │ -00044560: 726b 0a62 7974 6520 6f72 6465 722c 2069  rk.byte order, i
│ │ │ │ -00044570: 6e64 6963 6174 696e 6720 7468 6520 6c65  ndicating the le
│ │ │ │ -00044580: 6e67 7468 206f 6620 7468 6520 7061 636b  ngth of the pack
│ │ │ │ -00044590: 6574 2e20 2054 6865 2068 6967 6820 6269  et.  The high bi
│ │ │ │ -000445a0: 7420 6f66 2074 6865 0a6c 656e 6774 6820  t of the.length 
│ │ │ │ -000445b0: 7761 7320 7265 7365 7276 6564 2066 6f72  was reserved for
│ │ │ │ -000445c0: 2066 7574 7572 6520 6578 7061 6e73 696f   future expansio
│ │ │ │ -000445d0: 6e2c 2061 6e64 2073 6572 7665 7273 2074  n, and servers t
│ │ │ │ -000445e0: 6861 7420 646f 206e 6f74 0a75 6e64 6572  hat do not.under
│ │ │ │ -000445f0: 7374 616e 6420 686f 7720 746f 2069 6e74  stand how to int
│ │ │ │ -00044600: 6572 7072 6574 2061 2073 6574 2068 6967  erpret a set hig
│ │ │ │ -00044610: 6820 6269 7420 6d75 7374 2072 6574 7572  h bit must retur
│ │ │ │ -00044620: 6e20 6120 e280 984b 5242 2d45 5252 4f52  n a ...KRB-ERROR
│ │ │ │ -00044630: e280 990a 7769 7468 2061 20e2 8098 4b52  ....with a ...KR
│ │ │ │ -00044640: 425f 4552 525f 4649 454c 445f 544f 4f4c  B_ERR_FIELD_TOOL
│ │ │ │ -00044650: 4f4e 47e2 8099 2061 6e64 2063 6c6f 7365  ONG... and close
│ │ │ │ -00044660: 2074 6865 2054 4350 2073 7472 6561 6d2e   the TCP stream.
│ │ │ │ -00044670: 0a0a 2020 2054 6865 2054 4350 2f49 5020  ..   The TCP/IP 
│ │ │ │ -00044680: 7472 616e 7370 6f72 7420 7769 7468 2054  transport with T
│ │ │ │ -00044690: 4c53 2075 7067 7261 6465 2028 5354 4152  LS upgrade (STAR
│ │ │ │ -000446a0: 5454 4c53 2920 7573 6573 2074 6869 7320  TTLS) uses this 
│ │ │ │ -000446b0: 7265 7365 7276 6564 0a62 6974 2061 7320  reserved.bit as 
│ │ │ │ -000446c0: 666f 6c6c 6f77 732e 2020 4669 7273 7420  follows.  First 
│ │ │ │ -000446d0: 7765 2064 6566 696e 6520 6120 6e65 7720  we define a new 
│ │ │ │ -000446e0: 6578 7465 6e73 6962 6c65 2074 7970 6564  extensible typed
│ │ │ │ -000446f0: 2068 6f6c 6520 666f 720a 4b65 7262 6572   hole for.Kerber
│ │ │ │ -00044700: 6f73 2035 206d 6573 7361 6765 732c 2062  os 5 messages, b
│ │ │ │ -00044710: 6563 6175 7365 2077 6520 7573 6564 2074  ecause we used t
│ │ │ │ -00044720: 6865 206f 6e6c 7920 7265 7365 7276 6564  he only reserved
│ │ │ │ -00044730: 2062 6974 2e20 2049 7420 6973 2074 6875   bit.  It is thu
│ │ │ │ -00044740: 730a 7072 7564 656e 7420 746f 206f 6666  s.prudent to off
│ │ │ │ -00044750: 6572 2066 7574 7572 6520 6578 7465 6e73  er future extens
│ │ │ │ -00044760: 696f 6e73 206f 6e20 6f75 7220 7072 6f70  ions on our prop
│ │ │ │ -00044770: 6f73 616c 2e20 2053 6563 6f6e 646c 7920  osal.  Secondly 
│ │ │ │ -00044780: 7765 2072 6573 6572 7665 0a74 776f 2076  we reserve.two v
│ │ │ │ -00044790: 616c 7565 7320 696e 2074 6869 7320 6e65  alues in this ne
│ │ │ │ -000447a0: 7720 7479 7065 6420 686f 6c65 2c20 616e  w typed hole, an
│ │ │ │ -000447b0: 6420 6465 7363 7269 6265 6420 686f 7720  d described how 
│ │ │ │ -000447c0: 7468 6579 2061 7265 2075 7365 6420 746f  they are used to
│ │ │ │ -000447d0: 0a69 6d70 6c65 6d65 6e74 2053 5441 5254  .implement START
│ │ │ │ -000447e0: 544c 532e 0a0a 422e 312e 3220 4578 7465  TLS...B.1.2 Exte
│ │ │ │ -000447f0: 6e73 6962 6c65 2074 7970 6564 2068 6f6c  nsible typed hol
│ │ │ │ -00044800: 6520 6261 7365 6420 6f6e 2072 6573 6572  e based on reser
│ │ │ │ -00044810: 7665 6420 6869 6768 2062 6974 0a2d 2d2d  ved high bit.---
│ │ │ │ +000444d0: 2d2d 2d2d 2d2d 2d0a 0a52 4643 2031 3531  -------..RFC 151
│ │ │ │ +000444e0: 3062 6973 2072 6571 7569 7265 7320 4b65  0bis requires Ke
│ │ │ │ +000444f0: 7262 6572 6f73 2073 6572 7665 7273 2028  rberos servers (
│ │ │ │ +00044500: 4b44 4373 2920 746f 2061 6363 6570 7420  KDCs) to accept 
│ │ │ │ +00044510: 5443 5020 7265 7175 6573 7473 2e0a 4561  TCP requests..Ea
│ │ │ │ +00044520: 6368 2072 6571 7565 7374 2061 6e64 2072  ch request and r
│ │ │ │ +00044530: 6573 706f 6e73 6520 6973 2070 7265 6669  esponse is prefi
│ │ │ │ +00044540: 7865 6420 6279 2061 2034 206f 6374 6574  xed by a 4 octet
│ │ │ │ +00044550: 2069 6e74 6567 6572 2069 6e20 6e65 7477   integer in netw
│ │ │ │ +00044560: 6f72 6b0a 6279 7465 206f 7264 6572 2c20  ork.byte order, 
│ │ │ │ +00044570: 696e 6469 6361 7469 6e67 2074 6865 206c  indicating the l
│ │ │ │ +00044580: 656e 6774 6820 6f66 2074 6865 2070 6163  ength of the pac
│ │ │ │ +00044590: 6b65 742e 2020 5468 6520 6869 6768 2062  ket.  The high b
│ │ │ │ +000445a0: 6974 206f 6620 7468 650a 6c65 6e67 7468  it of the.length
│ │ │ │ +000445b0: 2077 6173 2072 6573 6572 7665 6420 666f   was reserved fo
│ │ │ │ +000445c0: 7220 6675 7475 7265 2065 7870 616e 7369  r future expansi
│ │ │ │ +000445d0: 6f6e 2c20 616e 6420 7365 7276 6572 7320  on, and servers 
│ │ │ │ +000445e0: 7468 6174 2064 6f20 6e6f 740a 756e 6465  that do not.unde
│ │ │ │ +000445f0: 7273 7461 6e64 2068 6f77 2074 6f20 696e  rstand how to in
│ │ │ │ +00044600: 7465 7270 7265 7420 6120 7365 7420 6869  terpret a set hi
│ │ │ │ +00044610: 6768 2062 6974 206d 7573 7420 7265 7475  gh bit must retu
│ │ │ │ +00044620: 726e 2061 20e2 8098 4b52 422d 4552 524f  rn a ...KRB-ERRO
│ │ │ │ +00044630: 52e2 8099 0a77 6974 6820 6120 e280 984b  R....with a ...K
│ │ │ │ +00044640: 5242 5f45 5252 5f46 4945 4c44 5f54 4f4f  RB_ERR_FIELD_TOO
│ │ │ │ +00044650: 4c4f 4e47 e280 9920 616e 6420 636c 6f73  LONG... and clos
│ │ │ │ +00044660: 6520 7468 6520 5443 5020 7374 7265 616d  e the TCP stream
│ │ │ │ +00044670: 2e0a 0a20 2020 5468 6520 5443 502f 4950  ...   The TCP/IP
│ │ │ │ +00044680: 2074 7261 6e73 706f 7274 2077 6974 6820   transport with 
│ │ │ │ +00044690: 544c 5320 7570 6772 6164 6520 2853 5441  TLS upgrade (STA
│ │ │ │ +000446a0: 5254 544c 5329 2075 7365 7320 7468 6973  RTTLS) uses this
│ │ │ │ +000446b0: 2072 6573 6572 7665 640a 6269 7420 6173   reserved.bit as
│ │ │ │ +000446c0: 2066 6f6c 6c6f 7773 2e20 2046 6972 7374   follows.  First
│ │ │ │ +000446d0: 2077 6520 6465 6669 6e65 2061 206e 6577   we define a new
│ │ │ │ +000446e0: 2065 7874 656e 7369 626c 6520 7479 7065   extensible type
│ │ │ │ +000446f0: 6420 686f 6c65 2066 6f72 0a4b 6572 6265  d hole for.Kerbe
│ │ │ │ +00044700: 726f 7320 3520 6d65 7373 6167 6573 2c20  ros 5 messages, 
│ │ │ │ +00044710: 6265 6361 7573 6520 7765 2075 7365 6420  because we used 
│ │ │ │ +00044720: 7468 6520 6f6e 6c79 2072 6573 6572 7665  the only reserve
│ │ │ │ +00044730: 6420 6269 742e 2020 4974 2069 7320 7468  d bit.  It is th
│ │ │ │ +00044740: 7573 0a70 7275 6465 6e74 2074 6f20 6f66  us.prudent to of
│ │ │ │ +00044750: 6665 7220 6675 7475 7265 2065 7874 656e  fer future exten
│ │ │ │ +00044760: 7369 6f6e 7320 6f6e 206f 7572 2070 726f  sions on our pro
│ │ │ │ +00044770: 706f 7361 6c2e 2020 5365 636f 6e64 6c79  posal.  Secondly
│ │ │ │ +00044780: 2077 6520 7265 7365 7276 650a 7477 6f20   we reserve.two 
│ │ │ │ +00044790: 7661 6c75 6573 2069 6e20 7468 6973 206e  values in this n
│ │ │ │ +000447a0: 6577 2074 7970 6564 2068 6f6c 652c 2061  ew typed hole, a
│ │ │ │ +000447b0: 6e64 2064 6573 6372 6962 6564 2068 6f77  nd described how
│ │ │ │ +000447c0: 2074 6865 7920 6172 6520 7573 6564 2074   they are used t
│ │ │ │ +000447d0: 6f0a 696d 706c 656d 656e 7420 5354 4152  o.implement STAR
│ │ │ │ +000447e0: 5454 4c53 2e0a 0a42 2e31 2e32 2045 7874  TTLS...B.1.2 Ext
│ │ │ │ +000447f0: 656e 7369 626c 6520 7479 7065 6420 686f  ensible typed ho
│ │ │ │ +00044800: 6c65 2062 6173 6564 206f 6e20 7265 7365  le based on rese
│ │ │ │ +00044810: 7276 6564 2068 6967 6820 6269 740a 2d2d  rved high bit.--
│ │ │ │  00044820: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │  00044830: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │  00044840: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00044850: 2d2d 2d0a 0a57 6865 6e20 7468 6520 6869  ---..When the hi
│ │ │ │ -00044860: 6768 2062 6974 2069 7320 7365 742c 2074  gh bit is set, t
│ │ │ │ -00044870: 6865 2072 656d 6169 6e69 6e67 2033 3120  he remaining 31 
│ │ │ │ -00044880: 6269 7473 206f 6620 7468 6520 3420 6f63  bits of the 4 oc
│ │ │ │ -00044890: 7465 7473 2061 7265 0a74 7265 6174 6564  tets are.treated
│ │ │ │ -000448a0: 2061 7320 616e 2065 7874 656e 7369 626c   as an extensibl
│ │ │ │ -000448b0: 6520 7479 7065 6420 686f 6c65 2c20 616e  e typed hole, an
│ │ │ │ -000448c0: 6420 7468 7573 2066 6f72 6d20 6120 3331  d thus form a 31
│ │ │ │ -000448d0: 2062 6974 2069 6e74 6567 6572 0a65 6e75   bit integer.enu
│ │ │ │ -000448e0: 6d65 7261 7469 6e67 2076 6172 696f 7573  merating various
│ │ │ │ -000448f0: 2065 7874 656e 7369 6f6e 732e 2020 4561   extensions.  Ea
│ │ │ │ -00044900: 6368 206f 6620 7468 6520 7661 6c75 6573  ch of the values
│ │ │ │ -00044910: 2069 6e64 6963 6174 6520 6120 7370 6563   indicate a spec
│ │ │ │ -00044920: 6966 6963 0a65 7874 656e 6465 6420 6f70  ific.extended op
│ │ │ │ -00044930: 6572 6174 696f 6e20 6d6f 6465 2c20 7477  eration mode, tw
│ │ │ │ -00044940: 6f20 6f66 2077 6869 6368 2061 7265 2075  o of which are u
│ │ │ │ -00044950: 7365 6420 616e 6420 6465 6669 6e65 6420  sed and defined 
│ │ │ │ -00044960: 6865 7265 2c20 616e 6420 7468 650a 7265  here, and the.re
│ │ │ │ -00044970: 7374 2061 7265 206c 6566 7420 666f 7220  st are left for 
│ │ │ │ -00044980: 6f74 6865 7273 2074 6f20 7573 652e 2020  others to use.  
│ │ │ │ -00044990: 4966 2074 6865 204b 4443 2064 6f20 6e6f  If the KDC do no
│ │ │ │ -000449a0: 7420 756e 6465 7273 7461 6e64 2061 0a72  t understand a.r
│ │ │ │ -000449b0: 6571 7565 7374 6564 2065 7874 656e 7369  equested extensi
│ │ │ │ -000449c0: 6f6e 2c20 6974 204d 5553 5420 7265 7475  on, it MUST retu
│ │ │ │ -000449d0: 726e 2061 20e2 8098 4b52 422d 4552 524f  rn a ...KRB-ERRO
│ │ │ │ -000449e0: 52e2 8099 2077 6974 6820 610a e280 984b  R... with a....K
│ │ │ │ -000449f0: 5242 5f45 5252 5f46 4945 4c44 5f54 4f4f  RB_ERR_FIELD_TOO
│ │ │ │ -00044a00: 4c4f 4e47 e280 9920 7661 6c75 6520 2870  LONG... value (p
│ │ │ │ -00044a10: 7265 6669 7865 6420 6279 2074 6865 2034  refixed by the 4
│ │ │ │ -00044a20: 206f 6374 6574 206c 656e 6774 6820 696e   octet length in
│ │ │ │ -00044a30: 7465 6765 722c 0a77 6974 6820 7468 6520  teger,.with the 
│ │ │ │ -00044a40: 6869 6768 2062 6974 2063 6c65 6172 2c20  high bit clear, 
│ │ │ │ -00044a50: 6173 2075 7375 616c 2920 616e 6420 636c  as usual) and cl
│ │ │ │ -00044a60: 6f73 6520 7468 6520 5443 5020 7374 7265  ose the TCP stre
│ │ │ │ -00044a70: 616d 2e0a 0a20 2020 4d65 616e 696e 6720  am...   Meaning 
│ │ │ │ -00044a80: 6f66 2074 6865 2033 3120 6c6f 7765 7220  of the 31 lower 
│ │ │ │ -00044a90: 6269 7473 2069 6e20 7468 6520 3420 6f63  bits in the 4 oc
│ │ │ │ -00044aa0: 7465 7420 6669 656c 642c 2077 6865 6e20  tet field, when 
│ │ │ │ -00044ab0: 7468 6520 6869 6768 2062 6974 0a69 7320  the high bit.is 
│ │ │ │ -00044ac0: 7365 743a 0a0a 2030 2020 2020 2020 2020  set:.. 0        
│ │ │ │ -00044ad0: 2020 2020 2020 2052 4553 4552 5645 442e         RESERVED.
│ │ │ │ -00044ae0: 0a20 3120 2020 2020 2020 2020 2020 2020  . 1             
│ │ │ │ -00044af0: 2020 5354 4152 5454 4c53 2072 6571 7565    STARTTLS reque
│ │ │ │ -00044b00: 7374 6564 2062 7920 636c 6965 6e74 2e0a  sted by client..
│ │ │ │ -00044b10: 2032 2020 2020 2020 2020 2020 2020 2020   2              
│ │ │ │ -00044b20: 2053 5441 5254 544c 5320 7265 7175 6573   STARTTLS reques
│ │ │ │ -00044b30: 7420 6163 6365 7074 6564 2062 7920 7365  t accepted by se
│ │ │ │ -00044b40: 7276 6572 2e0a 2033 2e2e 2e32 3134 3734  rver.. 3...21474
│ │ │ │ -00044b50: 3833 3634 3720 2041 5641 494c 4142 4c45  83647  AVAILABLE
│ │ │ │ -00044b60: 2066 6f72 2072 6567 6973 7472 6174 696f   for registratio
│ │ │ │ -00044b70: 6e20 2876 6961 2062 7567 2d73 6869 7368  n (via bug-shish
│ │ │ │ -00044b80: 6940 6a6f 7365 6673 736f 6e2e 6f72 6729  i@josefsson.org)
│ │ │ │ -00044b90: 2e0a 2032 3134 3734 3833 3634 3820 2020  .. 2147483648   
│ │ │ │ -00044ba0: 2020 2052 4553 4552 5645 442e 0a0a 422e     RESERVED...B.
│ │ │ │ -00044bb0: 312e 3320 5354 4152 5454 4c53 2072 6571  1.3 STARTTLS req
│ │ │ │ -00044bc0: 7565 7374 6564 2062 7920 636c 6965 6e74  uested by client
│ │ │ │ -00044bd0: 2028 6578 7465 6e73 696f 6e20 6d6f 6465   (extension mode
│ │ │ │ -00044be0: 2031 290a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d   1).------------
│ │ │ │ +00044850: 2d2d 2d2d 0a0a 5768 656e 2074 6865 2068  ----..When the h
│ │ │ │ +00044860: 6967 6820 6269 7420 6973 2073 6574 2c20  igh bit is set, 
│ │ │ │ +00044870: 7468 6520 7265 6d61 696e 696e 6720 3331  the remaining 31
│ │ │ │ +00044880: 2062 6974 7320 6f66 2074 6865 2034 206f   bits of the 4 o
│ │ │ │ +00044890: 6374 6574 7320 6172 650a 7472 6561 7465  ctets are.treate
│ │ │ │ +000448a0: 6420 6173 2061 6e20 6578 7465 6e73 6962  d as an extensib
│ │ │ │ +000448b0: 6c65 2074 7970 6564 2068 6f6c 652c 2061  le typed hole, a
│ │ │ │ +000448c0: 6e64 2074 6875 7320 666f 726d 2061 2033  nd thus form a 3
│ │ │ │ +000448d0: 3120 6269 7420 696e 7465 6765 720a 656e  1 bit integer.en
│ │ │ │ +000448e0: 756d 6572 6174 696e 6720 7661 7269 6f75  umerating variou
│ │ │ │ +000448f0: 7320 6578 7465 6e73 696f 6e73 2e20 2045  s extensions.  E
│ │ │ │ +00044900: 6163 6820 6f66 2074 6865 2076 616c 7565  ach of the value
│ │ │ │ +00044910: 7320 696e 6469 6361 7465 2061 2073 7065  s indicate a spe
│ │ │ │ +00044920: 6369 6669 630a 6578 7465 6e64 6564 206f  cific.extended o
│ │ │ │ +00044930: 7065 7261 7469 6f6e 206d 6f64 652c 2074  peration mode, t
│ │ │ │ +00044940: 776f 206f 6620 7768 6963 6820 6172 6520  wo of which are 
│ │ │ │ +00044950: 7573 6564 2061 6e64 2064 6566 696e 6564  used and defined
│ │ │ │ +00044960: 2068 6572 652c 2061 6e64 2074 6865 0a72   here, and the.r
│ │ │ │ +00044970: 6573 7420 6172 6520 6c65 6674 2066 6f72  est are left for
│ │ │ │ +00044980: 206f 7468 6572 7320 746f 2075 7365 2e20   others to use. 
│ │ │ │ +00044990: 2049 6620 7468 6520 4b44 4320 646f 206e   If the KDC do n
│ │ │ │ +000449a0: 6f74 2075 6e64 6572 7374 616e 6420 610a  ot understand a.
│ │ │ │ +000449b0: 7265 7175 6573 7465 6420 6578 7465 6e73  requested extens
│ │ │ │ +000449c0: 696f 6e2c 2069 7420 4d55 5354 2072 6574  ion, it MUST ret
│ │ │ │ +000449d0: 7572 6e20 6120 e280 984b 5242 2d45 5252  urn a ...KRB-ERR
│ │ │ │ +000449e0: 4f52 e280 9920 7769 7468 2061 0ae2 8098  OR... with a....
│ │ │ │ +000449f0: 4b52 425f 4552 525f 4649 454c 445f 544f  KRB_ERR_FIELD_TO
│ │ │ │ +00044a00: 4f4c 4f4e 47e2 8099 2076 616c 7565 2028  OLONG... value (
│ │ │ │ +00044a10: 7072 6566 6978 6564 2062 7920 7468 6520  prefixed by the 
│ │ │ │ +00044a20: 3420 6f63 7465 7420 6c65 6e67 7468 2069  4 octet length i
│ │ │ │ +00044a30: 6e74 6567 6572 2c0a 7769 7468 2074 6865  nteger,.with the
│ │ │ │ +00044a40: 2068 6967 6820 6269 7420 636c 6561 722c   high bit clear,
│ │ │ │ +00044a50: 2061 7320 7573 7561 6c29 2061 6e64 2063   as usual) and c
│ │ │ │ +00044a60: 6c6f 7365 2074 6865 2054 4350 2073 7472  lose the TCP str
│ │ │ │ +00044a70: 6561 6d2e 0a0a 2020 204d 6561 6e69 6e67  eam...   Meaning
│ │ │ │ +00044a80: 206f 6620 7468 6520 3331 206c 6f77 6572   of the 31 lower
│ │ │ │ +00044a90: 2062 6974 7320 696e 2074 6865 2034 206f   bits in the 4 o
│ │ │ │ +00044aa0: 6374 6574 2066 6965 6c64 2c20 7768 656e  ctet field, when
│ │ │ │ +00044ab0: 2074 6865 2068 6967 6820 6269 740a 6973   the high bit.is
│ │ │ │ +00044ac0: 2073 6574 3a0a 0a20 3020 2020 2020 2020   set:.. 0       
│ │ │ │ +00044ad0: 2020 2020 2020 2020 5245 5345 5256 4544          RESERVED
│ │ │ │ +00044ae0: 2e0a 2031 2020 2020 2020 2020 2020 2020  .. 1            
│ │ │ │ +00044af0: 2020 2053 5441 5254 544c 5320 7265 7175     STARTTLS requ
│ │ │ │ +00044b00: 6573 7465 6420 6279 2063 6c69 656e 742e  ested by client.
│ │ │ │ +00044b10: 0a20 3220 2020 2020 2020 2020 2020 2020  . 2             
│ │ │ │ +00044b20: 2020 5354 4152 5454 4c53 2072 6571 7565    STARTTLS reque
│ │ │ │ +00044b30: 7374 2061 6363 6570 7465 6420 6279 2073  st accepted by s
│ │ │ │ +00044b40: 6572 7665 722e 0a20 332e 2e2e 3231 3437  erver.. 3...2147
│ │ │ │ +00044b50: 3438 3336 3437 2020 4156 4149 4c41 424c  483647  AVAILABL
│ │ │ │ +00044b60: 4520 666f 7220 7265 6769 7374 7261 7469  E for registrati
│ │ │ │ +00044b70: 6f6e 2028 7669 6120 6275 672d 7368 6973  on (via bug-shis
│ │ │ │ +00044b80: 6869 406a 6f73 6566 7373 6f6e 2e6f 7267  hi@josefsson.org
│ │ │ │ +00044b90: 292e 0a20 3231 3437 3438 3336 3438 2020  ).. 2147483648  
│ │ │ │ +00044ba0: 2020 2020 5245 5345 5256 4544 2e0a 0a42      RESERVED...B
│ │ │ │ +00044bb0: 2e31 2e33 2053 5441 5254 544c 5320 7265  .1.3 STARTTLS re
│ │ │ │ +00044bc0: 7175 6573 7465 6420 6279 2063 6c69 656e  quested by clien
│ │ │ │ +00044bd0: 7420 2865 7874 656e 7369 6f6e 206d 6f64  t (extension mod
│ │ │ │ +00044be0: 6520 3129 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  e 1).-----------
│ │ │ │  00044bf0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │  00044c00: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00044c10: 2d2d 2d2d 2d2d 2d2d 2d0a 0a57 6865 6e20  ---------..When 
│ │ │ │ -00044c20: 7468 6973 2069 7320 7365 6e74 2062 7920  this is sent by 
│ │ │ │ -00044c30: 7468 6520 636c 6965 6e74 2c20 7468 6520  the client, the 
│ │ │ │ -00044c40: 636c 6965 6e74 2069 7320 7265 7175 6573  client is reques
│ │ │ │ -00044c50: 7469 6e67 2074 6865 2073 6572 7665 7220  ting the server 
│ │ │ │ -00044c60: 746f 0a73 7461 7274 2054 4c53 206e 6567  to.start TLS neg
│ │ │ │ -00044c70: 6f74 6961 7469 6f6e 206f 6e20 7468 6520  otiation on the 
│ │ │ │ -00044c80: 5443 5020 7374 7265 616d 2e20 2054 6865  TCP stream.  The
│ │ │ │ -00044c90: 2063 6c69 656e 7420 4d55 5354 204e 4f54   client MUST NOT
│ │ │ │ -00044ca0: 2073 7461 7274 2054 4c53 0a6e 6567 6f74   start TLS.negot
│ │ │ │ -00044cb0: 6961 7469 6f6e 2069 6d6d 6564 6961 7465  iation immediate
│ │ │ │ -00044cc0: 6c79 2e20 2049 6e73 7465 6164 2c20 7468  ly.  Instead, th
│ │ │ │ -00044cd0: 6520 636c 6965 6e74 2077 6169 7420 666f  e client wait fo
│ │ │ │ -00044ce0: 7220 6569 7468 6572 2061 0a4b 5242 2d45  r either a.KRB-E
│ │ │ │ -00044cf0: 5252 4f52 2028 7365 6e74 206e 6f72 6d61  RROR (sent norma
│ │ │ │ -00044d00: 6c6c 792c 2070 7265 6669 7865 6420 6279  lly, prefixed by
│ │ │ │ -00044d10: 2061 2034 206f 6374 6574 206c 656e 6774   a 4 octet lengt
│ │ │ │ -00044d20: 6820 696e 7465 6765 7229 0a69 6e64 6963  h integer).indic
│ │ │ │ -00044d30: 6174 696e 6720 7468 6520 7365 7276 6572  ating the server
│ │ │ │ -00044d40: 2064 6f20 6e6f 7420 756e 6465 7273 7461   do not understa
│ │ │ │ -00044d50: 6e64 2074 6865 2073 6574 2068 6967 6820  nd the set high 
│ │ │ │ -00044d60: 6269 742c 206f 7220 3420 6f63 7465 740a  bit, or 4 octet.
│ │ │ │ -00044d70: 7768 6963 6820 6973 2074 6f20 696e 7465  which is to inte
│ │ │ │ -00044d80: 7270 7265 7465 6420 6173 2061 6e20 696e  rpreted as an in
│ │ │ │ -00044d90: 7465 6765 7220 696e 206e 6574 776f 726b  teger in network
│ │ │ │ -00044da0: 2062 7974 6520 6f72 6465 722c 2077 6865   byte order, whe
│ │ │ │ -00044db0: 7265 2074 6865 0a68 6967 6820 6269 7420  re the.high bit 
│ │ │ │ -00044dc0: 6973 2073 6574 2061 6e64 2074 6865 2072  is set and the r
│ │ │ │ -00044dd0: 656d 6169 6e69 6e67 2033 3120 6269 7420  emaining 31 bit 
│ │ │ │ -00044de0: 6172 6520 696e 7465 7270 7265 7465 6420  are interpreted 
│ │ │ │ -00044df0: 6173 2061 6e20 696e 7465 6765 720a 7370  as an integer.sp
│ │ │ │ -00044e00: 6563 6966 7969 6e67 2074 6865 2022 5354  ecifying the "ST
│ │ │ │ -00044e10: 4152 5454 4c53 2072 6571 7565 7374 2061  ARTTLS request a
│ │ │ │ -00044e20: 6363 6570 7465 6420 6279 2073 6572 7665  ccepted by serve
│ │ │ │ -00044e30: 7222 2e20 2049 6e20 7468 6520 6669 7273  r".  In the firs
│ │ │ │ -00044e40: 740a 6361 7365 2c20 7468 6520 636c 6965  t.case, the clie
│ │ │ │ -00044e50: 6e74 2069 6e66 6572 2074 6861 7420 7468  nt infer that th
│ │ │ │ -00044e60: 6520 7365 7276 6572 2064 6f20 6e6f 7420  e server do not 
│ │ │ │ -00044e70: 756e 6465 7273 7461 6e64 2028 6f72 2077  understand (or w
│ │ │ │ -00044e80: 6973 6820 746f 0a73 7570 706f 7274 2920  ish to.support) 
│ │ │ │ -00044e90: 5354 4152 5454 4c53 2c20 616e 6420 6361  STARTTLS, and ca
│ │ │ │ -00044ea0: 6e20 7265 2d74 7279 2075 7369 6e67 206e  n re-try using n
│ │ │ │ -00044eb0: 6f72 6d61 6c20 5443 502c 2069 6620 756e  ormal TCP, if un
│ │ │ │ -00044ec0: 7072 6f74 6563 7465 640a 4b65 7262 6572  protected.Kerber
│ │ │ │ -00044ed0: 6f73 2035 2065 7863 6861 6e67 6573 2061  os 5 exchanges a
│ │ │ │ -00044ee0: 7265 2061 6363 6570 7461 626c 6520 746f  re acceptable to
│ │ │ │ -00044ef0: 2074 6865 2063 6c69 656e 7420 706f 6c69   the client poli
│ │ │ │ -00044f00: 6379 2e20 2049 6e20 7468 6520 6c61 7474  cy.  In the latt
│ │ │ │ -00044f10: 6572 0a63 6173 652c 2069 7420 7368 6f75  er.case, it shou
│ │ │ │ -00044f20: 6c64 2069 6e76 6f6b 6520 544c 5320 6e65  ld invoke TLS ne
│ │ │ │ -00044f30: 676f 7469 6174 696f 6e20 6f6e 2074 6865  gotiation on the
│ │ │ │ -00044f40: 2073 7472 6561 6d2e 2020 4966 2061 6e79   stream.  If any
│ │ │ │ -00044f50: 206f 7468 6572 2064 6174 610a 6973 2072   other data.is r
│ │ │ │ -00044f60: 6563 6569 7665 642c 2074 6865 2063 6c69  eceived, the cli
│ │ │ │ -00044f70: 656e 7420 4d55 5354 2063 6c6f 7365 2074  ent MUST close t
│ │ │ │ -00044f80: 6865 2054 4350 2073 7472 6561 6d2e 0a0a  he TCP stream...
│ │ │ │ -00044f90: 422e 312e 3420 5354 4152 5454 4c53 2072  B.1.4 STARTTLS r
│ │ │ │ -00044fa0: 6571 7565 7374 2061 6363 6570 7465 6420  equest accepted 
│ │ │ │ -00044fb0: 6279 2073 6572 7665 7220 2865 7874 656e  by server (exten
│ │ │ │ -00044fc0: 7369 6f6e 206d 6f64 6520 3229 0a2d 2d2d  sion mode 2).---
│ │ │ │ +00044c10: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 5768 656e  ----------..When
│ │ │ │ +00044c20: 2074 6869 7320 6973 2073 656e 7420 6279   this is sent by
│ │ │ │ +00044c30: 2074 6865 2063 6c69 656e 742c 2074 6865   the client, the
│ │ │ │ +00044c40: 2063 6c69 656e 7420 6973 2072 6571 7565   client is reque
│ │ │ │ +00044c50: 7374 696e 6720 7468 6520 7365 7276 6572  sting the server
│ │ │ │ +00044c60: 2074 6f0a 7374 6172 7420 544c 5320 6e65   to.start TLS ne
│ │ │ │ +00044c70: 676f 7469 6174 696f 6e20 6f6e 2074 6865  gotiation on the
│ │ │ │ +00044c80: 2054 4350 2073 7472 6561 6d2e 2020 5468   TCP stream.  Th
│ │ │ │ +00044c90: 6520 636c 6965 6e74 204d 5553 5420 4e4f  e client MUST NO
│ │ │ │ +00044ca0: 5420 7374 6172 7420 544c 530a 6e65 676f  T start TLS.nego
│ │ │ │ +00044cb0: 7469 6174 696f 6e20 696d 6d65 6469 6174  tiation immediat
│ │ │ │ +00044cc0: 656c 792e 2020 496e 7374 6561 642c 2074  ely.  Instead, t
│ │ │ │ +00044cd0: 6865 2063 6c69 656e 7420 7761 6974 2066  he client wait f
│ │ │ │ +00044ce0: 6f72 2065 6974 6865 7220 610a 4b52 422d  or either a.KRB-
│ │ │ │ +00044cf0: 4552 524f 5220 2873 656e 7420 6e6f 726d  ERROR (sent norm
│ │ │ │ +00044d00: 616c 6c79 2c20 7072 6566 6978 6564 2062  ally, prefixed b
│ │ │ │ +00044d10: 7920 6120 3420 6f63 7465 7420 6c65 6e67  y a 4 octet leng
│ │ │ │ +00044d20: 7468 2069 6e74 6567 6572 290a 696e 6469  th integer).indi
│ │ │ │ +00044d30: 6361 7469 6e67 2074 6865 2073 6572 7665  cating the serve
│ │ │ │ +00044d40: 7220 646f 206e 6f74 2075 6e64 6572 7374  r do not underst
│ │ │ │ +00044d50: 616e 6420 7468 6520 7365 7420 6869 6768  and the set high
│ │ │ │ +00044d60: 2062 6974 2c20 6f72 2034 206f 6374 6574   bit, or 4 octet
│ │ │ │ +00044d70: 0a77 6869 6368 2069 7320 746f 2069 6e74  .which is to int
│ │ │ │ +00044d80: 6572 7072 6574 6564 2061 7320 616e 2069  erpreted as an i
│ │ │ │ +00044d90: 6e74 6567 6572 2069 6e20 6e65 7477 6f72  nteger in networ
│ │ │ │ +00044da0: 6b20 6279 7465 206f 7264 6572 2c20 7768  k byte order, wh
│ │ │ │ +00044db0: 6572 6520 7468 650a 6869 6768 2062 6974  ere the.high bit
│ │ │ │ +00044dc0: 2069 7320 7365 7420 616e 6420 7468 6520   is set and the 
│ │ │ │ +00044dd0: 7265 6d61 696e 696e 6720 3331 2062 6974  remaining 31 bit
│ │ │ │ +00044de0: 2061 7265 2069 6e74 6572 7072 6574 6564   are interpreted
│ │ │ │ +00044df0: 2061 7320 616e 2069 6e74 6567 6572 0a73   as an integer.s
│ │ │ │ +00044e00: 7065 6369 6679 696e 6720 7468 6520 2253  pecifying the "S
│ │ │ │ +00044e10: 5441 5254 544c 5320 7265 7175 6573 7420  TARTTLS request 
│ │ │ │ +00044e20: 6163 6365 7074 6564 2062 7920 7365 7276  accepted by serv
│ │ │ │ +00044e30: 6572 222e 2020 496e 2074 6865 2066 6972  er".  In the fir
│ │ │ │ +00044e40: 7374 0a63 6173 652c 2074 6865 2063 6c69  st.case, the cli
│ │ │ │ +00044e50: 656e 7420 696e 6665 7220 7468 6174 2074  ent infer that t
│ │ │ │ +00044e60: 6865 2073 6572 7665 7220 646f 206e 6f74  he server do not
│ │ │ │ +00044e70: 2075 6e64 6572 7374 616e 6420 286f 7220   understand (or 
│ │ │ │ +00044e80: 7769 7368 2074 6f0a 7375 7070 6f72 7429  wish to.support)
│ │ │ │ +00044e90: 2053 5441 5254 544c 532c 2061 6e64 2063   STARTTLS, and c
│ │ │ │ +00044ea0: 616e 2072 652d 7472 7920 7573 696e 6720  an re-try using 
│ │ │ │ +00044eb0: 6e6f 726d 616c 2054 4350 2c20 6966 2075  normal TCP, if u
│ │ │ │ +00044ec0: 6e70 726f 7465 6374 6564 0a4b 6572 6265  nprotected.Kerbe
│ │ │ │ +00044ed0: 726f 7320 3520 6578 6368 616e 6765 7320  ros 5 exchanges 
│ │ │ │ +00044ee0: 6172 6520 6163 6365 7074 6162 6c65 2074  are acceptable t
│ │ │ │ +00044ef0: 6f20 7468 6520 636c 6965 6e74 2070 6f6c  o the client pol
│ │ │ │ +00044f00: 6963 792e 2020 496e 2074 6865 206c 6174  icy.  In the lat
│ │ │ │ +00044f10: 7465 720a 6361 7365 2c20 6974 2073 686f  ter.case, it sho
│ │ │ │ +00044f20: 756c 6420 696e 766f 6b65 2054 4c53 206e  uld invoke TLS n
│ │ │ │ +00044f30: 6567 6f74 6961 7469 6f6e 206f 6e20 7468  egotiation on th
│ │ │ │ +00044f40: 6520 7374 7265 616d 2e20 2049 6620 616e  e stream.  If an
│ │ │ │ +00044f50: 7920 6f74 6865 7220 6461 7461 0a69 7320  y other data.is 
│ │ │ │ +00044f60: 7265 6365 6976 6564 2c20 7468 6520 636c  received, the cl
│ │ │ │ +00044f70: 6965 6e74 204d 5553 5420 636c 6f73 6520  ient MUST close 
│ │ │ │ +00044f80: 7468 6520 5443 5020 7374 7265 616d 2e0a  the TCP stream..
│ │ │ │ +00044f90: 0a42 2e31 2e34 2053 5441 5254 544c 5320  .B.1.4 STARTTLS 
│ │ │ │ +00044fa0: 7265 7175 6573 7420 6163 6365 7074 6564  request accepted
│ │ │ │ +00044fb0: 2062 7920 7365 7276 6572 2028 6578 7465   by server (exte
│ │ │ │ +00044fc0: 6e73 696f 6e20 6d6f 6465 2032 290a 2d2d  nsion mode 2).--
│ │ │ │  00044fd0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │  00044fe0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │  00044ff0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00045000: 2d2d 2d2d 2d2d 2d2d 2d0a 0a54 6869 7320  ---------..This 
│ │ │ │ -00045010: 3420 6f63 7465 7420 6d65 7373 6167 6520  4 octet message 
│ │ │ │ -00045020: 7368 6f75 6c64 2062 6520 7365 6e74 2062  should be sent b
│ │ │ │ -00045030: 7920 7468 6520 7365 7276 6572 2077 6865  y the server whe
│ │ │ │ -00045040: 6e20 6974 2068 6173 2072 6563 6569 7665  n it has receive
│ │ │ │ -00045050: 640a 7468 6520 7072 6576 696f 7573 2034  d.the previous 4
│ │ │ │ -00045060: 206f 6374 6574 206d 6573 7361 6765 2e20   octet message. 
│ │ │ │ -00045070: 2054 6865 206d 6573 7361 6765 2069 7320   The message is 
│ │ │ │ -00045080: 616e 2061 636b 6e6f 776c 6564 676d 656e  an acknowledgmen
│ │ │ │ -00045090: 7420 6f66 2074 6865 0a63 6c69 656e 7427  t of the.client'
│ │ │ │ -000450a0: 7320 7265 7175 6573 7420 746f 2069 6e69  s request to ini
│ │ │ │ -000450b0: 7469 6174 6520 5354 4152 5454 4c53 206f  tiate STARTTLS o
│ │ │ │ -000450c0: 6e20 7468 6520 6368 616e 6e65 6c2e 2020  n the channel.  
│ │ │ │ -000450d0: 5468 6520 7365 7276 6572 204d 5553 540a  The server MUST.
│ │ │ │ -000450e0: 7468 656e 2069 6e76 6f6b 6520 6120 544c  then invoke a TL
│ │ │ │ -000450f0: 5320 6e65 676f 7469 6174 696f 6e2e 0a0a  S negotiation...
│ │ │ │ -00045100: 422e 312e 3520 5072 6f63 6565 6469 6e67  B.1.5 Proceeding
│ │ │ │ -00045110: 2061 6674 6572 2073 7563 6365 7373 6675   after successfu
│ │ │ │ -00045120: 6c20 544c 5320 6e65 676f 7469 6174 696f  l TLS negotiatio
│ │ │ │ -00045130: 6e0a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  n.--------------
│ │ │ │ +00045000: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 5468 6973  ----------..This
│ │ │ │ +00045010: 2034 206f 6374 6574 206d 6573 7361 6765   4 octet message
│ │ │ │ +00045020: 2073 686f 756c 6420 6265 2073 656e 7420   should be sent 
│ │ │ │ +00045030: 6279 2074 6865 2073 6572 7665 7220 7768  by the server wh
│ │ │ │ +00045040: 656e 2069 7420 6861 7320 7265 6365 6976  en it has receiv
│ │ │ │ +00045050: 6564 0a74 6865 2070 7265 7669 6f75 7320  ed.the previous 
│ │ │ │ +00045060: 3420 6f63 7465 7420 6d65 7373 6167 652e  4 octet message.
│ │ │ │ +00045070: 2020 5468 6520 6d65 7373 6167 6520 6973    The message is
│ │ │ │ +00045080: 2061 6e20 6163 6b6e 6f77 6c65 6467 6d65   an acknowledgme
│ │ │ │ +00045090: 6e74 206f 6620 7468 650a 636c 6965 6e74  nt of the.client
│ │ │ │ +000450a0: 2773 2072 6571 7565 7374 2074 6f20 696e  's request to in
│ │ │ │ +000450b0: 6974 6961 7465 2053 5441 5254 544c 5320  itiate STARTTLS 
│ │ │ │ +000450c0: 6f6e 2074 6865 2063 6861 6e6e 656c 2e20  on the channel. 
│ │ │ │ +000450d0: 2054 6865 2073 6572 7665 7220 4d55 5354   The server MUST
│ │ │ │ +000450e0: 0a74 6865 6e20 696e 766f 6b65 2061 2054  .then invoke a T
│ │ │ │ +000450f0: 4c53 206e 6567 6f74 6961 7469 6f6e 2e0a  LS negotiation..
│ │ │ │ +00045100: 0a42 2e31 2e35 2050 726f 6365 6564 696e  .B.1.5 Proceedin
│ │ │ │ +00045110: 6720 6166 7465 7220 7375 6363 6573 7366  g after successf
│ │ │ │ +00045120: 756c 2054 4c53 206e 6567 6f74 6961 7469  ul TLS negotiati
│ │ │ │ +00045130: 6f6e 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  on.-------------
│ │ │ │  00045140: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │  00045150: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00045160: 2d2d 2d0a 0a49 6620 7468 6520 544c 5320  ---..If the TLS 
│ │ │ │ -00045170: 6e65 676f 7469 6174 696f 6e20 656e 6465  negotiation ende
│ │ │ │ -00045180: 6420 7375 6363 6573 7366 756c 6c79 2c20  d successfully, 
│ │ │ │ -00045190: 706f 7373 6962 6c79 2061 6c73 6f20 636f  possibly also co
│ │ │ │ -000451a0: 6e73 6964 6572 696e 670a 636c 6965 6e74  nsidering.client
│ │ │ │ -000451b0: 206f 7220 7365 7276 6572 2070 6f6c 6963   or server polic
│ │ │ │ -000451c0: 6965 732c 2074 6865 2065 7863 6861 6e67  ies, the exchang
│ │ │ │ -000451d0: 6520 7769 7468 696e 2074 6865 2054 4c53  e within the TLS
│ │ │ │ -000451e0: 2070 726f 7465 6374 6564 2073 7472 6561   protected strea
│ │ │ │ -000451f0: 6d0a 6973 2070 6572 666f 726d 6564 206c  m.is performed l
│ │ │ │ -00045200: 696b 6520 6e6f 726d 616c 2055 4450 204b  ike normal UDP K
│ │ │ │ -00045210: 6572 6265 726f 7320 3520 6578 6368 616e  erberos 5 exchan
│ │ │ │ -00045220: 6765 732c 2069 2e65 2e2c 2074 6865 7265  ges, i.e., there
│ │ │ │ -00045230: 2069 7320 6e6f 2054 4350 0a34 206f 6374   is no TCP.4 oct
│ │ │ │ -00045240: 6574 206c 656e 6774 6820 6669 656c 6420  et length field 
│ │ │ │ -00045250: 6265 666f 7265 2065 6163 6820 7061 636b  before each pack
│ │ │ │ -00045260: 6574 2e20 2049 6e73 7465 6164 2065 6163  et.  Instead eac
│ │ │ │ -00045270: 6820 4b65 7262 6572 6f73 2070 6163 6b65  h Kerberos packe
│ │ │ │ -00045280: 740a 4d55 5354 2062 6520 7365 6e74 2077  t.MUST be sent w
│ │ │ │ -00045290: 6974 6869 6e20 6f6e 6520 544c 5320 7265  ithin one TLS re
│ │ │ │ -000452a0: 636f 7264 2c20 736f 2074 6865 2061 7070  cord, so the app
│ │ │ │ -000452b0: 6c69 6361 7469 6f6e 2063 616e 2075 7365  lication can use
│ │ │ │ -000452c0: 2074 6865 2054 4c53 0a72 6563 6f72 6420   the TLS.record 
│ │ │ │ -000452d0: 6c65 6e67 7468 2061 7320 7468 6520 4b65  length as the Ke
│ │ │ │ -000452e0: 7262 6572 6f73 2035 2070 6163 6b65 7420  rberos 5 packet 
│ │ │ │ -000452f0: 6c65 6e67 7468 2e0a 0a42 2e31 2e36 2050  length...B.1.6 P
│ │ │ │ -00045300: 726f 6365 6564 696e 6720 6166 7465 7220  roceeding after 
│ │ │ │ -00045310: 6661 696c 6564 2054 4c53 206e 6567 6f74  failed TLS negot
│ │ │ │ -00045320: 6961 7469 6f6e 0a2d 2d2d 2d2d 2d2d 2d2d  iation.---------
│ │ │ │ +00045160: 2d2d 2d2d 0a0a 4966 2074 6865 2054 4c53  ----..If the TLS
│ │ │ │ +00045170: 206e 6567 6f74 6961 7469 6f6e 2065 6e64   negotiation end
│ │ │ │ +00045180: 6564 2073 7563 6365 7373 6675 6c6c 792c  ed successfully,
│ │ │ │ +00045190: 2070 6f73 7369 626c 7920 616c 736f 2063   possibly also c
│ │ │ │ +000451a0: 6f6e 7369 6465 7269 6e67 0a63 6c69 656e  onsidering.clien
│ │ │ │ +000451b0: 7420 6f72 2073 6572 7665 7220 706f 6c69  t or server poli
│ │ │ │ +000451c0: 6369 6573 2c20 7468 6520 6578 6368 616e  cies, the exchan
│ │ │ │ +000451d0: 6765 2077 6974 6869 6e20 7468 6520 544c  ge within the TL
│ │ │ │ +000451e0: 5320 7072 6f74 6563 7465 6420 7374 7265  S protected stre
│ │ │ │ +000451f0: 616d 0a69 7320 7065 7266 6f72 6d65 6420  am.is performed 
│ │ │ │ +00045200: 6c69 6b65 206e 6f72 6d61 6c20 5544 5020  like normal UDP 
│ │ │ │ +00045210: 4b65 7262 6572 6f73 2035 2065 7863 6861  Kerberos 5 excha
│ │ │ │ +00045220: 6e67 6573 2c20 692e 652e 2c20 7468 6572  nges, i.e., ther
│ │ │ │ +00045230: 6520 6973 206e 6f20 5443 500a 3420 6f63  e is no TCP.4 oc
│ │ │ │ +00045240: 7465 7420 6c65 6e67 7468 2066 6965 6c64  tet length field
│ │ │ │ +00045250: 2062 6566 6f72 6520 6561 6368 2070 6163   before each pac
│ │ │ │ +00045260: 6b65 742e 2020 496e 7374 6561 6420 6561  ket.  Instead ea
│ │ │ │ +00045270: 6368 204b 6572 6265 726f 7320 7061 636b  ch Kerberos pack
│ │ │ │ +00045280: 6574 0a4d 5553 5420 6265 2073 656e 7420  et.MUST be sent 
│ │ │ │ +00045290: 7769 7468 696e 206f 6e65 2054 4c53 2072  within one TLS r
│ │ │ │ +000452a0: 6563 6f72 642c 2073 6f20 7468 6520 6170  ecord, so the ap
│ │ │ │ +000452b0: 706c 6963 6174 696f 6e20 6361 6e20 7573  plication can us
│ │ │ │ +000452c0: 6520 7468 6520 544c 530a 7265 636f 7264  e the TLS.record
│ │ │ │ +000452d0: 206c 656e 6774 6820 6173 2074 6865 204b   length as the K
│ │ │ │ +000452e0: 6572 6265 726f 7320 3520 7061 636b 6574  erberos 5 packet
│ │ │ │ +000452f0: 206c 656e 6774 682e 0a0a 422e 312e 3620   length...B.1.6 
│ │ │ │ +00045300: 5072 6f63 6565 6469 6e67 2061 6674 6572  Proceeding after
│ │ │ │ +00045310: 2066 6169 6c65 6420 544c 5320 6e65 676f   failed TLS nego
│ │ │ │ +00045320: 7469 6174 696f 6e0a 2d2d 2d2d 2d2d 2d2d  tiation.--------
│ │ │ │  00045330: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │  00045340: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00045350: 2d2d 2d2d 0a0a 4966 2074 6865 2054 4c53  ----..If the TLS
│ │ │ │ -00045360: 206e 6567 6f74 6961 7469 6f6e 2066 6169   negotiation fai
│ │ │ │ -00045370: 6c73 2c20 706f 7373 6962 6c79 2064 7565  ls, possibly due
│ │ │ │ -00045380: 2074 6f20 636c 6965 6e74 206f 7220 7365   to client or se
│ │ │ │ -00045390: 7276 6572 2070 6f6c 6963 790a 2865 2e67  rver policy.(e.g
│ │ │ │ -000453a0: 2e2c 2069 6e61 6465 7175 6174 6520 7375  ., inadequate su
│ │ │ │ -000453b0: 7070 6f72 7420 6f66 2065 6e63 7279 7074  pport of encrypt
│ │ │ │ -000453c0: 696f 6e20 7479 7065 7320 696e 2054 4c53  ion types in TLS
│ │ │ │ -000453d0: 2c20 6f72 206c 6163 6b20 6f66 2063 6c69  , or lack of cli
│ │ │ │ -000453e0: 656e 740a 6f72 2073 6572 7665 7220 6175  ent.or server au
│ │ │ │ -000453f0: 7468 656e 7469 6361 7469 6f6e 2920 7468  thentication) th
│ │ │ │ -00045400: 6520 656e 7469 7479 2074 6861 7420 6465  e entity that de
│ │ │ │ -00045410: 7465 6374 2074 6865 2066 6169 6c75 7265  tect the failure
│ │ │ │ -00045420: 204d 5553 540a 6469 7363 6f6e 6e65 6374   MUST.disconnect
│ │ │ │ -00045430: 6564 2074 6865 2063 6f6e 6e65 6374 696f  ed the connectio
│ │ │ │ -00045440: 6e2e 2020 4974 2069 7320 6578 7065 6374  n.  It is expect
│ │ │ │ -00045450: 6564 2074 6861 7420 616e 7920 6572 726f  ed that any erro
│ │ │ │ -00045460: 7220 6d65 7373 6167 6573 0a74 6861 7420  r messages.that 
│ │ │ │ -00045470: 6578 706c 6169 6e20 7468 6520 6572 726f  explain the erro
│ │ │ │ -00045480: 7220 636f 6e64 6974 696f 6e20 6973 2074  r condition is t
│ │ │ │ -00045490: 7261 6e73 6665 7265 6420 6279 2054 4c53  ransfered by TLS
│ │ │ │ -000454a0: 2e0a 0a42 2e31 2e37 2049 6e74 6572 6163  ...B.1.7 Interac
│ │ │ │ -000454b0: 7469 6f6e 2077 6974 6820 4b44 4320 6164  tion with KDC ad
│ │ │ │ -000454c0: 6472 6573 7365 7320 696e 2044 4e53 0a2d  dresses in DNS.-
│ │ │ │ +00045350: 2d2d 2d2d 2d0a 0a49 6620 7468 6520 544c  -----..If the TL
│ │ │ │ +00045360: 5320 6e65 676f 7469 6174 696f 6e20 6661  S negotiation fa
│ │ │ │ +00045370: 696c 732c 2070 6f73 7369 626c 7920 6475  ils, possibly du
│ │ │ │ +00045380: 6520 746f 2063 6c69 656e 7420 6f72 2073  e to client or s
│ │ │ │ +00045390: 6572 7665 7220 706f 6c69 6379 0a28 652e  erver policy.(e.
│ │ │ │ +000453a0: 672e 2c20 696e 6164 6571 7561 7465 2073  g., inadequate s
│ │ │ │ +000453b0: 7570 706f 7274 206f 6620 656e 6372 7970  upport of encryp
│ │ │ │ +000453c0: 7469 6f6e 2074 7970 6573 2069 6e20 544c  tion types in TL
│ │ │ │ +000453d0: 532c 206f 7220 6c61 636b 206f 6620 636c  S, or lack of cl
│ │ │ │ +000453e0: 6965 6e74 0a6f 7220 7365 7276 6572 2061  ient.or server a
│ │ │ │ +000453f0: 7574 6865 6e74 6963 6174 696f 6e29 2074  uthentication) t
│ │ │ │ +00045400: 6865 2065 6e74 6974 7920 7468 6174 2064  he entity that d
│ │ │ │ +00045410: 6574 6563 7420 7468 6520 6661 696c 7572  etect the failur
│ │ │ │ +00045420: 6520 4d55 5354 0a64 6973 636f 6e6e 6563  e MUST.disconnec
│ │ │ │ +00045430: 7465 6420 7468 6520 636f 6e6e 6563 7469  ted the connecti
│ │ │ │ +00045440: 6f6e 2e20 2049 7420 6973 2065 7870 6563  on.  It is expec
│ │ │ │ +00045450: 7465 6420 7468 6174 2061 6e79 2065 7272  ted that any err
│ │ │ │ +00045460: 6f72 206d 6573 7361 6765 730a 7468 6174  or messages.that
│ │ │ │ +00045470: 2065 7870 6c61 696e 2074 6865 2065 7272   explain the err
│ │ │ │ +00045480: 6f72 2063 6f6e 6469 7469 6f6e 2069 7320  or condition is 
│ │ │ │ +00045490: 7472 616e 7366 6572 6564 2062 7920 544c  transfered by TL
│ │ │ │ +000454a0: 532e 0a0a 422e 312e 3720 496e 7465 7261  S...B.1.7 Intera
│ │ │ │ +000454b0: 6374 696f 6e20 7769 7468 204b 4443 2061  ction with KDC a
│ │ │ │ +000454c0: 6464 7265 7373 6573 2069 6e20 444e 530a  ddresses in DNS.
│ │ │ │  000454d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │  000454e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000454f0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 4164 6d69  ----------..Admi
│ │ │ │ -00045500: 6e69 7374 7261 746f 7273 2066 6f72 2061  nistrators for a
│ │ │ │ -00045510: 204b 4443 206d 6179 2061 6e6e 6f75 6e63   KDC may announc
│ │ │ │ -00045520: 6520 7468 6520 4b44 4320 6164 6472 6573  e the KDC addres
│ │ │ │ -00045530: 7320 6279 2070 6c61 6369 6e67 2053 5256  s by placing SRV
│ │ │ │ -00045540: 0a72 6563 6f72 6473 2069 6e20 444e 5320  .records in DNS 
│ │ │ │ -00045550: 666f 7220 7468 6520 7265 616c 6d2c 2061  for the realm, a
│ │ │ │ -00045560: 7320 6465 7363 7269 6265 6420 696e 0ae2  s described in..
│ │ │ │ -00045570: 8098 6472 6166 742d 6965 7466 2d6b 7262  ..draft-ietf-krb
│ │ │ │ -00045580: 2d77 672d 6b72 622d 646e 732d 6c6f 6361  -wg-krb-dns-loca
│ │ │ │ -00045590: 7465 2d30 332e 7478 74e2 8099 2e20 2054  te-03.txt....  T
│ │ │ │ -000455a0: 6861 7420 646f 6375 6d65 6e74 206d 656e  hat document men
│ │ │ │ -000455b0: 7469 6f6e 2054 4c53 2c0a 6275 7420 646f  tion TLS,.but do
│ │ │ │ -000455c0: 206e 6f74 2072 6566 6572 656e 6365 2061   not reference a
│ │ │ │ -000455d0: 6e79 2077 6f72 6b20 7468 6174 2064 6573  ny work that des
│ │ │ │ -000455e0: 6372 6962 6520 686f 7720 4b44 4373 2075  cribe how KDCs u
│ │ │ │ -000455f0: 7365 7320 544c 532e 2055 6e74 696c 0a66  ses TLS. Until.f
│ │ │ │ -00045600: 7572 7468 6572 2063 6c61 7269 6669 6564  urther clarified
│ │ │ │ -00045610: 2c20 636f 6e73 6964 6572 2074 6865 2054  , consider the T
│ │ │ │ -00045620: 4c53 2066 6965 6c64 2069 6e20 7468 6174  LS field in that
│ │ │ │ -00045630: 2064 6f63 756d 656e 7420 746f 2072 6566   document to ref
│ │ │ │ -00045640: 6572 2074 6f0a 696d 706c 656d 656e 7461  er to.implementa
│ │ │ │ -00045650: 7469 6f6e 2073 7570 706f 7274 696e 6720  tion supporting 
│ │ │ │ -00045660: 7468 6973 2053 5441 5254 544c 5320 7072  this STARTTLS pr
│ │ │ │ -00045670: 6f74 6f63 6f6c 2e0a 0a42 2e31 2e38 2055  otocol...B.1.8 U
│ │ │ │ -00045680: 7369 6e67 2054 4c53 2061 7574 6865 6e74  sing TLS authent
│ │ │ │ -00045690: 6963 6174 696f 6e20 6c6f 6769 6320 696e  ication logic in
│ │ │ │ -000456a0: 204b 6572 6265 726f 730a 2d2d 2d2d 2d2d   Kerberos.------
│ │ │ │ +000454f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a41 646d  -----------..Adm
│ │ │ │ +00045500: 696e 6973 7472 6174 6f72 7320 666f 7220  inistrators for 
│ │ │ │ +00045510: 6120 4b44 4320 6d61 7920 616e 6e6f 756e  a KDC may announ
│ │ │ │ +00045520: 6365 2074 6865 204b 4443 2061 6464 7265  ce the KDC addre
│ │ │ │ +00045530: 7373 2062 7920 706c 6163 696e 6720 5352  ss by placing SR
│ │ │ │ +00045540: 560a 7265 636f 7264 7320 696e 2044 4e53  V.records in DNS
│ │ │ │ +00045550: 2066 6f72 2074 6865 2072 6561 6c6d 2c20   for the realm, 
│ │ │ │ +00045560: 6173 2064 6573 6372 6962 6564 2069 6e0a  as described in.
│ │ │ │ +00045570: e280 9864 7261 6674 2d69 6574 662d 6b72  ...draft-ietf-kr
│ │ │ │ +00045580: 622d 7767 2d6b 7262 2d64 6e73 2d6c 6f63  b-wg-krb-dns-loc
│ │ │ │ +00045590: 6174 652d 3033 2e74 7874 e280 992e 2020  ate-03.txt....  
│ │ │ │ +000455a0: 5468 6174 2064 6f63 756d 656e 7420 6d65  That document me
│ │ │ │ +000455b0: 6e74 696f 6e20 544c 532c 0a62 7574 2064  ntion TLS,.but d
│ │ │ │ +000455c0: 6f20 6e6f 7420 7265 6665 7265 6e63 6520  o not reference 
│ │ │ │ +000455d0: 616e 7920 776f 726b 2074 6861 7420 6465  any work that de
│ │ │ │ +000455e0: 7363 7269 6265 2068 6f77 204b 4443 7320  scribe how KDCs 
│ │ │ │ +000455f0: 7573 6573 2054 4c53 2e20 556e 7469 6c0a  uses TLS. Until.
│ │ │ │ +00045600: 6675 7274 6865 7220 636c 6172 6966 6965  further clarifie
│ │ │ │ +00045610: 642c 2063 6f6e 7369 6465 7220 7468 6520  d, consider the 
│ │ │ │ +00045620: 544c 5320 6669 656c 6420 696e 2074 6861  TLS field in tha
│ │ │ │ +00045630: 7420 646f 6375 6d65 6e74 2074 6f20 7265  t document to re
│ │ │ │ +00045640: 6665 7220 746f 0a69 6d70 6c65 6d65 6e74  fer to.implement
│ │ │ │ +00045650: 6174 696f 6e20 7375 7070 6f72 7469 6e67  ation supporting
│ │ │ │ +00045660: 2074 6869 7320 5354 4152 5454 4c53 2070   this STARTTLS p
│ │ │ │ +00045670: 726f 746f 636f 6c2e 0a0a 422e 312e 3820  rotocol...B.1.8 
│ │ │ │ +00045680: 5573 696e 6720 544c 5320 6175 7468 656e  Using TLS authen
│ │ │ │ +00045690: 7469 6361 7469 6f6e 206c 6f67 6963 2069  tication logic i
│ │ │ │ +000456a0: 6e20 4b65 7262 6572 6f73 0a2d 2d2d 2d2d  n Kerberos.-----
│ │ │ │  000456b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │  000456c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000456d0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 5468 6520  ----------..The 
│ │ │ │ -000456e0: 7365 7276 6572 204d 4159 2063 6f6e 7369  server MAY consi
│ │ │ │ -000456f0: 6465 7220 7468 6520 6175 7468 656e 7469  der the authenti
│ │ │ │ -00045700: 6361 7469 6f6e 2070 6572 666f 726d 6564  cation performed
│ │ │ │ -00045710: 2062 7920 7468 6520 544c 5320 6578 6368   by the TLS exch
│ │ │ │ -00045720: 616e 6765 0a61 7320 7375 6666 6963 6965  ange.as sufficie
│ │ │ │ -00045730: 6e74 2074 6f20 6973 7375 6520 4b65 7262  nt to issue Kerb
│ │ │ │ -00045740: 6572 6f73 2035 2074 6963 6b65 7473 2074  eros 5 tickets t
│ │ │ │ -00045750: 6f20 7468 6520 636c 6965 6e74 2c20 7769  o the client, wi
│ │ │ │ -00045760: 7468 6f75 740a 7265 7175 6972 696e 672c  thout.requiring,
│ │ │ │ -00045770: 2065 2e67 2e2c 2070 7265 2d61 7574 6865   e.g., pre-authe
│ │ │ │ -00045780: 6e74 6963 6174 696f 6e2e 2020 486f 7765  ntication.  Howe
│ │ │ │ -00045790: 7665 722c 2069 7420 6973 206e 6f74 2061  ver, it is not a
│ │ │ │ -000457a0: 6e20 6572 726f 7220 746f 0a72 6571 7569  n error to.requi
│ │ │ │ -000457b0: 7265 206f 7220 7573 6520 7072 652d 6175  re or use pre-au
│ │ │ │ -000457c0: 7468 656e 7469 6361 7469 6f6e 2061 7320  thentication as 
│ │ │ │ -000457d0: 7765 6c6c 2e0a 0a20 2020 5468 6520 636c  well...   The cl
│ │ │ │ -000457e0: 6965 6e74 206d 6179 2061 6c73 6f20 696e  ient may also in
│ │ │ │ -000457f0: 6469 6361 7465 2074 6861 7420 6974 2077  dicate that it w
│ │ │ │ -00045800: 6973 6865 7320 746f 2075 7365 2054 4c53  ishes to use TLS
│ │ │ │ -00045810: 2062 6f74 6820 666f 720a 6175 7468 656e   both for.authen
│ │ │ │ -00045820: 7469 6361 7469 6f6e 2061 6e64 2064 6174  tication and dat
│ │ │ │ -00045830: 6120 7072 6f74 6563 7469 6f6e 2062 7920  a protection by 
│ │ │ │ -00045840: 7573 696e 6720 7468 6520 e280 984e 554c  using the ...NUL
│ │ │ │ -00045850: 4ce2 8099 2065 6e63 7279 7074 696f 6e20  L... encryption 
│ │ │ │ -00045860: 7479 7065 0a69 6e20 6974 7320 7265 7175  type.in its requ
│ │ │ │ -00045870: 6573 742e 2020 5468 6520 7365 7276 6572  est.  The server
│ │ │ │ -00045880: 2063 616e 2064 6563 6964 6520 6672 6f6d   can decide from
│ │ │ │ -00045890: 2069 7473 206c 6f63 616c 2070 6f6c 6963   its local polic
│ │ │ │ -000458a0: 7920 7768 6574 6865 7220 6f72 0a6e 6f74  y whether or.not
│ │ │ │ -000458b0: 2069 7373 7569 6e67 2074 6963 6b65 7473   issuing tickets
│ │ │ │ -000458c0: 2062 6173 6564 2073 6f6c 656c 7920 6f6e   based solely on
│ │ │ │ -000458d0: 2054 4c53 2061 7574 6865 6e74 6963 6174   TLS authenticat
│ │ │ │ -000458e0: 696f 6e2c 2061 6e64 2077 6865 7468 6572  ion, and whether
│ │ │ │ -000458f0: 0ae2 8098 4e55 4c4c e280 9920 656e 6372  ....NULL... encr
│ │ │ │ -00045900: 7970 7469 6f6e 2077 6974 6869 6e20 544c  yption within TL
│ │ │ │ -00045910: 532c 2069 7320 6163 6365 7074 6162 6c65  S, is acceptable
│ │ │ │ -00045920: 206f 7220 6e6f 742e 2020 5468 6973 206d   or not.  This m
│ │ │ │ -00045930: 6f64 6520 6973 0a63 7572 7265 6e74 6c79  ode is.currently
│ │ │ │ -00045940: 2075 6e64 6572 2069 6e76 6573 7469 6761   under investiga
│ │ │ │ -00045950: 7469 6f6e 2e0a 0a42 2e31 2e39 2053 6563  tion...B.1.9 Sec
│ │ │ │ -00045960: 7572 6974 7920 636f 6e73 6964 6572 6174  urity considerat
│ │ │ │ -00045970: 696f 6e73 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  ions.-----------
│ │ │ │ +000456d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a54 6865  -----------..The
│ │ │ │ +000456e0: 2073 6572 7665 7220 4d41 5920 636f 6e73   server MAY cons
│ │ │ │ +000456f0: 6964 6572 2074 6865 2061 7574 6865 6e74  ider the authent
│ │ │ │ +00045700: 6963 6174 696f 6e20 7065 7266 6f72 6d65  ication performe
│ │ │ │ +00045710: 6420 6279 2074 6865 2054 4c53 2065 7863  d by the TLS exc
│ │ │ │ +00045720: 6861 6e67 650a 6173 2073 7566 6669 6369  hange.as suffici
│ │ │ │ +00045730: 656e 7420 746f 2069 7373 7565 204b 6572  ent to issue Ker
│ │ │ │ +00045740: 6265 726f 7320 3520 7469 636b 6574 7320  beros 5 tickets 
│ │ │ │ +00045750: 746f 2074 6865 2063 6c69 656e 742c 2077  to the client, w
│ │ │ │ +00045760: 6974 686f 7574 0a72 6571 7569 7269 6e67  ithout.requiring
│ │ │ │ +00045770: 2c20 652e 672e 2c20 7072 652d 6175 7468  , e.g., pre-auth
│ │ │ │ +00045780: 656e 7469 6361 7469 6f6e 2e20 2048 6f77  entication.  How
│ │ │ │ +00045790: 6576 6572 2c20 6974 2069 7320 6e6f 7420  ever, it is not 
│ │ │ │ +000457a0: 616e 2065 7272 6f72 2074 6f0a 7265 7175  an error to.requ
│ │ │ │ +000457b0: 6972 6520 6f72 2075 7365 2070 7265 2d61  ire or use pre-a
│ │ │ │ +000457c0: 7574 6865 6e74 6963 6174 696f 6e20 6173  uthentication as
│ │ │ │ +000457d0: 2077 656c 6c2e 0a0a 2020 2054 6865 2063   well...   The c
│ │ │ │ +000457e0: 6c69 656e 7420 6d61 7920 616c 736f 2069  lient may also i
│ │ │ │ +000457f0: 6e64 6963 6174 6520 7468 6174 2069 7420  ndicate that it 
│ │ │ │ +00045800: 7769 7368 6573 2074 6f20 7573 6520 544c  wishes to use TL
│ │ │ │ +00045810: 5320 626f 7468 2066 6f72 0a61 7574 6865  S both for.authe
│ │ │ │ +00045820: 6e74 6963 6174 696f 6e20 616e 6420 6461  ntication and da
│ │ │ │ +00045830: 7461 2070 726f 7465 6374 696f 6e20 6279  ta protection by
│ │ │ │ +00045840: 2075 7369 6e67 2074 6865 20e2 8098 4e55   using the ...NU
│ │ │ │ +00045850: 4c4c e280 9920 656e 6372 7970 7469 6f6e  LL... encryption
│ │ │ │ +00045860: 2074 7970 650a 696e 2069 7473 2072 6571   type.in its req
│ │ │ │ +00045870: 7565 7374 2e20 2054 6865 2073 6572 7665  uest.  The serve
│ │ │ │ +00045880: 7220 6361 6e20 6465 6369 6465 2066 726f  r can decide fro
│ │ │ │ +00045890: 6d20 6974 7320 6c6f 6361 6c20 706f 6c69  m its local poli
│ │ │ │ +000458a0: 6379 2077 6865 7468 6572 206f 720a 6e6f  cy whether or.no
│ │ │ │ +000458b0: 7420 6973 7375 696e 6720 7469 636b 6574  t issuing ticket
│ │ │ │ +000458c0: 7320 6261 7365 6420 736f 6c65 6c79 206f  s based solely o
│ │ │ │ +000458d0: 6e20 544c 5320 6175 7468 656e 7469 6361  n TLS authentica
│ │ │ │ +000458e0: 7469 6f6e 2c20 616e 6420 7768 6574 6865  tion, and whethe
│ │ │ │ +000458f0: 720a e280 984e 554c 4ce2 8099 2065 6e63  r....NULL... enc
│ │ │ │ +00045900: 7279 7074 696f 6e20 7769 7468 696e 2054  ryption within T
│ │ │ │ +00045910: 4c53 2c20 6973 2061 6363 6570 7461 626c  LS, is acceptabl
│ │ │ │ +00045920: 6520 6f72 206e 6f74 2e20 2054 6869 7320  e or not.  This 
│ │ │ │ +00045930: 6d6f 6465 2069 730a 6375 7272 656e 746c  mode is.currentl
│ │ │ │ +00045940: 7920 756e 6465 7220 696e 7665 7374 6967  y under investig
│ │ │ │ +00045950: 6174 696f 6e2e 0a0a 422e 312e 3920 5365  ation...B.1.9 Se
│ │ │ │ +00045960: 6375 7269 7479 2063 6f6e 7369 6465 7261  curity considera
│ │ │ │ +00045970: 7469 6f6e 730a 2d2d 2d2d 2d2d 2d2d 2d2d  tions.----------
│ │ │ │  00045980: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00045990: 2d2d 0a0a 4265 6361 7573 6520 7468 6520  --..Because the 
│ │ │ │ -000459a0: 696e 6974 6961 6c20 746f 6b65 6e20 6973  initial token is
│ │ │ │ -000459b0: 206e 6f74 2070 726f 7465 6374 6564 2c20   not protected, 
│ │ │ │ -000459c0: 6974 2069 7320 706f 7373 6962 6c65 2066  it is possible f
│ │ │ │ -000459d0: 6f72 2061 6e20 6163 7469 7665 0a61 7474  or an active.att
│ │ │ │ -000459e0: 6163 6b65 7220 746f 206d 616b 6520 6974  acker to make it
│ │ │ │ -000459f0: 2061 7070 6561 7220 746f 2074 6865 2063   appear to the c
│ │ │ │ -00045a00: 6c69 656e 7420 7468 6174 2074 6865 2073  lient that the s
│ │ │ │ -00045a10: 6572 7665 7220 646f 206e 6f74 2073 7570  erver do not sup
│ │ │ │ -00045a20: 706f 7274 0a74 6869 7320 6578 7465 6e73  port.this extens
│ │ │ │ -00045a30: 696f 6e2e 2020 4974 2069 7320 7570 2074  ion.  It is up t
│ │ │ │ -00045a40: 6f20 636c 6965 6e74 2063 6f6e 6669 6775  o client configu
│ │ │ │ -00045a50: 7261 7469 6f6e 2074 6f20 6469 7361 6c6c  ration to disall
│ │ │ │ -00045a60: 6f77 206e 6f6e 2d54 4c53 0a63 6f6e 6e65  ow non-TLS.conne
│ │ │ │ -00045a70: 6374 696f 6e73 2c20 6966 2074 6869 7320  ctions, if this 
│ │ │ │ -00045a80: 7675 6c6e 6572 6162 696c 6974 7920 6973  vulnerability is
│ │ │ │ -00045a90: 2064 6565 6d65 6420 756e 6163 6365 7074   deemed unaccept
│ │ │ │ -00045aa0: 6162 6c65 2e20 2046 6f72 0a69 6e74 6572  able.  For.inter
│ │ │ │ -00045ab0: 6f70 6572 6162 696c 6974 792c 2077 6520  operability, we 
│ │ │ │ -00045ac0: 7375 6767 6573 7420 7468 6520 6465 6661  suggest the defa
│ │ │ │ -00045ad0: 756c 7420 6265 6861 7669 6f75 7220 7368  ult behaviour sh
│ │ │ │ -00045ae0: 6f75 6c64 2062 6520 746f 2061 6c6c 6f77  ould be to allow
│ │ │ │ -00045af0: 0a61 7574 6f6d 6174 6963 2066 616c 6c62  .automatic fallb
│ │ │ │ -00045b00: 6163 6b20 746f 2054 4350 206f 7220 5544  ack to TCP or UD
│ │ │ │ -00045b10: 502e 0a0a 2020 2054 6865 2073 6563 7572  P...   The secur
│ │ │ │ -00045b20: 6974 7920 636f 6e73 6964 6572 6174 696f  ity consideratio
│ │ │ │ -00045b30: 6e73 206f 6620 626f 7468 2054 4c53 2061  ns of both TLS a
│ │ │ │ -00045b40: 6e64 204b 6572 6265 726f 7320 3520 6172  nd Kerberos 5 ar
│ │ │ │ -00045b50: 6520 696e 6865 7269 7465 642e 0a55 7369  e inherited..Usi
│ │ │ │ -00045b60: 6e67 2054 4c53 2066 6f72 2061 7574 6865  ng TLS for authe
│ │ │ │ -00045b70: 6e74 6963 6174 696f 6e20 616e 642f 6f72  ntication and/or
│ │ │ │ -00045b80: 2064 6174 6120 7072 6f74 6563 7469 6f6e   data protection
│ │ │ │ -00045b90: 2074 6f67 6574 6865 7220 7769 7468 0a4b   together with.K
│ │ │ │ -00045ba0: 6572 6265 726f 7320 616c 7465 7220 7468  erberos alter th
│ │ │ │ -00045bb0: 6520 6175 7468 656e 7469 6361 7469 6f6e  e authentication
│ │ │ │ -00045bc0: 206c 6f67 6963 2066 756e 6461 6d65 6e74   logic fundament
│ │ │ │ -00045bd0: 616c 6c79 2e20 2054 6875 732c 2069 7420  ally.  Thus, it 
│ │ │ │ -00045be0: 6d61 7920 6265 0a74 6861 7420 6576 656e  may be.that even
│ │ │ │ -00045bf0: 2069 6620 7468 6520 544c 5320 616e 6420   if the TLS and 
│ │ │ │ -00045c00: 4b65 7262 6572 6f73 2035 2070 726f 746f  Kerberos 5 proto
│ │ │ │ -00045c10: 636f 6c73 2061 6e64 2069 6d70 6c65 6d65  cols and impleme
│ │ │ │ -00045c20: 6e74 6174 696f 6e73 2077 6572 650a 7365  ntations were.se
│ │ │ │ -00045c30: 6375 7265 2c20 7468 6520 636f 6d62 696e  cure, the combin
│ │ │ │ -00045c40: 6174 696f 6e20 6f66 2054 4c53 2061 6e64  ation of TLS and
│ │ │ │ -00045c50: 204b 6572 6265 726f 7320 3520 6465 7363   Kerberos 5 desc
│ │ │ │ -00045c60: 7269 6265 6420 6865 7265 2063 6f75 6c64  ribed here could
│ │ │ │ -00045c70: 2062 650a 696e 7365 6375 7265 2e0a 0a20   be.insecure... 
│ │ │ │ -00045c80: 2020 4e6f 2063 6861 6e6e 656c 2062 696e    No channel bin
│ │ │ │ -00045c90: 6469 6e67 7320 6172 6520 7072 6f76 6964  dings are provid
│ │ │ │ -00045ca0: 6564 2069 6e20 7468 6520 4b65 7262 6572  ed in the Kerber
│ │ │ │ -00045cb0: 6f73 206d 6573 7361 6765 732e 2020 4974  os messages.  It
│ │ │ │ -00045cc0: 2069 7320 616e 0a6f 7065 6e20 7175 6573   is an.open ques
│ │ │ │ -00045cd0: 7469 6f6e 2077 6865 7468 6572 2c20 616e  tion whether, an
│ │ │ │ -00045ce0: 6420 686f 772c 2074 6869 7320 7368 6f75  d how, this shou
│ │ │ │ -00045cf0: 6c64 2062 6520 6669 7865 642e 0a0a 1f0a  ld be fixed.....
│ │ │ │ -00045d00: 4669 6c65 3a20 7368 6973 6869 2e69 6e66  File: shishi.inf
│ │ │ │ -00045d10: 6f2c 2020 4e6f 6465 3a20 5465 6c6e 6574  o,  Node: Telnet
│ │ │ │ -00045d20: 2065 6e63 7279 7074 696f 6e20 7769 7468   encryption with
│ │ │ │ -00045d30: 2041 4553 2d43 434d 2c20 204e 6578 743a   AES-CCM,  Next:
│ │ │ │ -00045d40: 204b 6572 6265 7269 7a65 6420 7273 6820   Kerberized rsh 
│ │ │ │ -00045d50: 616e 6420 726c 6f67 696e 2c20 2050 7265  and rlogin,  Pre
│ │ │ │ -00045d60: 763a 2053 5441 5254 544c 5320 7072 6f74  v: STARTTLS prot
│ │ │ │ -00045d70: 6563 7465 6420 4b44 4320 6578 6368 616e  ected KDC exchan
│ │ │ │ -00045d80: 6765 732c 2020 5570 3a20 5072 6f74 6f63  ges,  Up: Protoc
│ │ │ │ -00045d90: 6f6c 2045 7874 656e 7369 6f6e 730a 0a42  ol Extensions..B
│ │ │ │ -00045da0: 2e32 2054 656c 6e65 7420 656e 6372 7970  .2 Telnet encryp
│ │ │ │ -00045db0: 7469 6f6e 2077 6974 6820 4145 532d 4343  tion with AES-CC
│ │ │ │ -00045dc0: 4d0a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  M.==============
│ │ │ │ +00045990: 2d2d 2d0a 0a42 6563 6175 7365 2074 6865  ---..Because the
│ │ │ │ +000459a0: 2069 6e69 7469 616c 2074 6f6b 656e 2069   initial token i
│ │ │ │ +000459b0: 7320 6e6f 7420 7072 6f74 6563 7465 642c  s not protected,
│ │ │ │ +000459c0: 2069 7420 6973 2070 6f73 7369 626c 6520   it is possible 
│ │ │ │ +000459d0: 666f 7220 616e 2061 6374 6976 650a 6174  for an active.at
│ │ │ │ +000459e0: 7461 636b 6572 2074 6f20 6d61 6b65 2069  tacker to make i
│ │ │ │ +000459f0: 7420 6170 7065 6172 2074 6f20 7468 6520  t appear to the 
│ │ │ │ +00045a00: 636c 6965 6e74 2074 6861 7420 7468 6520  client that the 
│ │ │ │ +00045a10: 7365 7276 6572 2064 6f20 6e6f 7420 7375  server do not su
│ │ │ │ +00045a20: 7070 6f72 740a 7468 6973 2065 7874 656e  pport.this exten
│ │ │ │ +00045a30: 7369 6f6e 2e20 2049 7420 6973 2075 7020  sion.  It is up 
│ │ │ │ +00045a40: 746f 2063 6c69 656e 7420 636f 6e66 6967  to client config
│ │ │ │ +00045a50: 7572 6174 696f 6e20 746f 2064 6973 616c  uration to disal
│ │ │ │ +00045a60: 6c6f 7720 6e6f 6e2d 544c 530a 636f 6e6e  low non-TLS.conn
│ │ │ │ +00045a70: 6563 7469 6f6e 732c 2069 6620 7468 6973  ections, if this
│ │ │ │ +00045a80: 2076 756c 6e65 7261 6269 6c69 7479 2069   vulnerability i
│ │ │ │ +00045a90: 7320 6465 656d 6564 2075 6e61 6363 6570  s deemed unaccep
│ │ │ │ +00045aa0: 7461 626c 652e 2020 466f 720a 696e 7465  table.  For.inte
│ │ │ │ +00045ab0: 726f 7065 7261 6269 6c69 7479 2c20 7765  roperability, we
│ │ │ │ +00045ac0: 2073 7567 6765 7374 2074 6865 2064 6566   suggest the def
│ │ │ │ +00045ad0: 6175 6c74 2062 6568 6176 696f 7572 2073  ault behaviour s
│ │ │ │ +00045ae0: 686f 756c 6420 6265 2074 6f20 616c 6c6f  hould be to allo
│ │ │ │ +00045af0: 770a 6175 746f 6d61 7469 6320 6661 6c6c  w.automatic fall
│ │ │ │ +00045b00: 6261 636b 2074 6f20 5443 5020 6f72 2055  back to TCP or U
│ │ │ │ +00045b10: 4450 2e0a 0a20 2020 5468 6520 7365 6375  DP...   The secu
│ │ │ │ +00045b20: 7269 7479 2063 6f6e 7369 6465 7261 7469  rity considerati
│ │ │ │ +00045b30: 6f6e 7320 6f66 2062 6f74 6820 544c 5320  ons of both TLS 
│ │ │ │ +00045b40: 616e 6420 4b65 7262 6572 6f73 2035 2061  and Kerberos 5 a
│ │ │ │ +00045b50: 7265 2069 6e68 6572 6974 6564 2e0a 5573  re inherited..Us
│ │ │ │ +00045b60: 696e 6720 544c 5320 666f 7220 6175 7468  ing TLS for auth
│ │ │ │ +00045b70: 656e 7469 6361 7469 6f6e 2061 6e64 2f6f  entication and/o
│ │ │ │ +00045b80: 7220 6461 7461 2070 726f 7465 6374 696f  r data protectio
│ │ │ │ +00045b90: 6e20 746f 6765 7468 6572 2077 6974 680a  n together with.
│ │ │ │ +00045ba0: 4b65 7262 6572 6f73 2061 6c74 6572 2074  Kerberos alter t
│ │ │ │ +00045bb0: 6865 2061 7574 6865 6e74 6963 6174 696f  he authenticatio
│ │ │ │ +00045bc0: 6e20 6c6f 6769 6320 6675 6e64 616d 656e  n logic fundamen
│ │ │ │ +00045bd0: 7461 6c6c 792e 2020 5468 7573 2c20 6974  tally.  Thus, it
│ │ │ │ +00045be0: 206d 6179 2062 650a 7468 6174 2065 7665   may be.that eve
│ │ │ │ +00045bf0: 6e20 6966 2074 6865 2054 4c53 2061 6e64  n if the TLS and
│ │ │ │ +00045c00: 204b 6572 6265 726f 7320 3520 7072 6f74   Kerberos 5 prot
│ │ │ │ +00045c10: 6f63 6f6c 7320 616e 6420 696d 706c 656d  ocols and implem
│ │ │ │ +00045c20: 656e 7461 7469 6f6e 7320 7765 7265 0a73  entations were.s
│ │ │ │ +00045c30: 6563 7572 652c 2074 6865 2063 6f6d 6269  ecure, the combi
│ │ │ │ +00045c40: 6e61 7469 6f6e 206f 6620 544c 5320 616e  nation of TLS an
│ │ │ │ +00045c50: 6420 4b65 7262 6572 6f73 2035 2064 6573  d Kerberos 5 des
│ │ │ │ +00045c60: 6372 6962 6564 2068 6572 6520 636f 756c  cribed here coul
│ │ │ │ +00045c70: 6420 6265 0a69 6e73 6563 7572 652e 0a0a  d be.insecure...
│ │ │ │ +00045c80: 2020 204e 6f20 6368 616e 6e65 6c20 6269     No channel bi
│ │ │ │ +00045c90: 6e64 696e 6773 2061 7265 2070 726f 7669  ndings are provi
│ │ │ │ +00045ca0: 6465 6420 696e 2074 6865 204b 6572 6265  ded in the Kerbe
│ │ │ │ +00045cb0: 726f 7320 6d65 7373 6167 6573 2e20 2049  ros messages.  I
│ │ │ │ +00045cc0: 7420 6973 2061 6e0a 6f70 656e 2071 7565  t is an.open que
│ │ │ │ +00045cd0: 7374 696f 6e20 7768 6574 6865 722c 2061  stion whether, a
│ │ │ │ +00045ce0: 6e64 2068 6f77 2c20 7468 6973 2073 686f  nd how, this sho
│ │ │ │ +00045cf0: 756c 6420 6265 2066 6978 6564 2e0a 0a1f  uld be fixed....
│ │ │ │ +00045d00: 0a46 696c 653a 2073 6869 7368 692e 696e  .File: shishi.in
│ │ │ │ +00045d10: 666f 2c20 204e 6f64 653a 2054 656c 6e65  fo,  Node: Telne
│ │ │ │ +00045d20: 7420 656e 6372 7970 7469 6f6e 2077 6974  t encryption wit
│ │ │ │ +00045d30: 6820 4145 532d 4343 4d2c 2020 4e65 7874  h AES-CCM,  Next
│ │ │ │ +00045d40: 3a20 4b65 7262 6572 697a 6564 2072 7368  : Kerberized rsh
│ │ │ │ +00045d50: 2061 6e64 2072 6c6f 6769 6e2c 2020 5072   and rlogin,  Pr
│ │ │ │ +00045d60: 6576 3a20 5354 4152 5454 4c53 2070 726f  ev: STARTTLS pro
│ │ │ │ +00045d70: 7465 6374 6564 204b 4443 2065 7863 6861  tected KDC excha
│ │ │ │ +00045d80: 6e67 6573 2c20 2055 703a 2050 726f 746f  nges,  Up: Proto
│ │ │ │ +00045d90: 636f 6c20 4578 7465 6e73 696f 6e73 0a0a  col Extensions..
│ │ │ │ +00045da0: 422e 3220 5465 6c6e 6574 2065 6e63 7279  B.2 Telnet encry
│ │ │ │ +00045db0: 7074 696f 6e20 7769 7468 2041 4553 2d43  ption with AES-C
│ │ │ │ +00045dc0: 434d 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  CM.=============
│ │ │ │  00045dd0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ -00045de0: 3d3d 3d3d 0a0a 5468 6973 2061 7070 656e  ====..This appen
│ │ │ │ -00045df0: 6469 7820 6465 7363 7269 6265 2068 6f77  dix describe how
│ │ │ │ -00045e00: 2053 6869 7368 6920 7573 6520 7468 6520   Shishi use the 
│ │ │ │ -00045e10: 4164 7661 6e63 6564 2045 6e63 7279 7074  Advanced Encrypt
│ │ │ │ -00045e20: 696f 6e20 5374 616e 6461 7264 0a28 4145  ion Standard.(AE
│ │ │ │ -00045e30: 5329 2065 6e63 7279 7074 696f 6e20 616c  S) encryption al
│ │ │ │ -00045e40: 676f 7269 7468 6d20 696e 2043 6f75 6e74  gorithm in Count
│ │ │ │ -00045e50: 6572 2077 6974 6820 4342 432d 4d41 4320  er with CBC-MAC 
│ │ │ │ -00045e60: 6d6f 6465 2028 5246 4320 3336 3130 2920  mode (RFC 3610) 
│ │ │ │ -00045e70: 7769 7468 0a74 6865 2074 656c 6e65 7420  with.the telnet 
│ │ │ │ -00045e80: 656e 6372 7970 7469 6f6e 206f 7074 696f  encryption optio
│ │ │ │ -00045e90: 6e20 2852 4643 2032 3934 3629 2e0a 0a42  n (RFC 2946)...B
│ │ │ │ -00045ea0: 2e32 2e31 2043 6f6d 6d61 6e64 204e 616d  .2.1 Command Nam
│ │ │ │ -00045eb0: 6573 2061 6e64 2043 6f64 6573 0a2d 2d2d  es and Codes.---
│ │ │ │ +00045de0: 3d3d 3d3d 3d0a 0a54 6869 7320 6170 7065  =====..This appe
│ │ │ │ +00045df0: 6e64 6978 2064 6573 6372 6962 6520 686f  ndix describe ho
│ │ │ │ +00045e00: 7720 5368 6973 6869 2075 7365 2074 6865  w Shishi use the
│ │ │ │ +00045e10: 2041 6476 616e 6365 6420 456e 6372 7970   Advanced Encryp
│ │ │ │ +00045e20: 7469 6f6e 2053 7461 6e64 6172 640a 2841  tion Standard.(A
│ │ │ │ +00045e30: 4553 2920 656e 6372 7970 7469 6f6e 2061  ES) encryption a
│ │ │ │ +00045e40: 6c67 6f72 6974 686d 2069 6e20 436f 756e  lgorithm in Coun
│ │ │ │ +00045e50: 7465 7220 7769 7468 2043 4243 2d4d 4143  ter with CBC-MAC
│ │ │ │ +00045e60: 206d 6f64 6520 2852 4643 2033 3631 3029   mode (RFC 3610)
│ │ │ │ +00045e70: 2077 6974 680a 7468 6520 7465 6c6e 6574   with.the telnet
│ │ │ │ +00045e80: 2065 6e63 7279 7074 696f 6e20 6f70 7469   encryption opti
│ │ │ │ +00045e90: 6f6e 2028 5246 4320 3239 3436 292e 0a0a  on (RFC 2946)...
│ │ │ │ +00045ea0: 422e 322e 3120 436f 6d6d 616e 6420 4e61  B.2.1 Command Na
│ │ │ │ +00045eb0: 6d65 7320 616e 6420 436f 6465 730a 2d2d  mes and Codes.--
│ │ │ │  00045ec0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00045ed0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 456e 6372  ----------..Encr
│ │ │ │ -00045ee0: 7970 7469 6f6e 2054 7970 650a 0a20 2020  yption Type..   
│ │ │ │ -00045ef0: 2020 2041 4553 5f43 434d 2020 2020 2020     AES_CCM      
│ │ │ │ -00045f00: 2020 2020 2020 2031 320a 0a53 7562 6f70         12..Subop
│ │ │ │ -00045f10: 7469 6f6e 2043 6f6d 6d61 6e64 730a 0a20  tion Commands.. 
│ │ │ │ -00045f20: 2020 2020 2041 4553 5f43 434d 5f49 4e46       AES_CCM_INF
│ │ │ │ -00045f30: 4f20 2020 2020 2020 2020 310a 2020 2020  O         1.    
│ │ │ │ -00045f40: 2020 4145 535f 4343 4d5f 494e 464f 5f4f    AES_CCM_INFO_O
│ │ │ │ -00045f50: 4b20 2020 2020 2032 0a20 2020 2020 2041  K      2.      A
│ │ │ │ -00045f60: 4553 5f43 434d 5f49 4e46 4f5f 4241 4420  ES_CCM_INFO_BAD 
│ │ │ │ -00045f70: 2020 2020 330a 0a42 2e32 2e32 2043 6f6d      3..B.2.2 Com
│ │ │ │ -00045f80: 6d61 6e64 204d 6561 6e69 6e67 730a 2d2d  mand Meanings.--
│ │ │ │ +00045ed0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a45 6e63  -----------..Enc
│ │ │ │ +00045ee0: 7279 7074 696f 6e20 5479 7065 0a0a 2020  ryption Type..  
│ │ │ │ +00045ef0: 2020 2020 4145 535f 4343 4d20 2020 2020      AES_CCM     
│ │ │ │ +00045f00: 2020 2020 2020 2020 3132 0a0a 5375 626f          12..Subo
│ │ │ │ +00045f10: 7074 696f 6e20 436f 6d6d 616e 6473 0a0a  ption Commands..
│ │ │ │ +00045f20: 2020 2020 2020 4145 535f 4343 4d5f 494e        AES_CCM_IN
│ │ │ │ +00045f30: 464f 2020 2020 2020 2020 2031 0a20 2020  FO         1.   
│ │ │ │ +00045f40: 2020 2041 4553 5f43 434d 5f49 4e46 4f5f     AES_CCM_INFO_
│ │ │ │ +00045f50: 4f4b 2020 2020 2020 320a 2020 2020 2020  OK      2.      
│ │ │ │ +00045f60: 4145 535f 4343 4d5f 494e 464f 5f42 4144  AES_CCM_INFO_BAD
│ │ │ │ +00045f70: 2020 2020 2033 0a0a 422e 322e 3220 436f       3..B.2.2 Co
│ │ │ │ +00045f80: 6d6d 616e 6420 4d65 616e 696e 6773 0a2d  mmand Meanings.-
│ │ │ │  00045f90: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00045fa0: 2d2d 2d2d 0a0a 2020 2049 4143 2053 4220  ----..   IAC SB 
│ │ │ │ -00045fb0: 454e 4352 5950 5420 4953 2041 4553 5f43  ENCRYPT IS AES_C
│ │ │ │ -00045fc0: 434d 2041 4553 5f43 434d 5f49 4e46 4f20  CM AES_CCM_INFO 
│ │ │ │ -00045fd0: 3c4d 3e20 3c4c 3e20 3c6e 6f6e 6365 3e20  <M> <L> <nonce> 
│ │ │ │ -00045fe0: 4941 4320 5345 0a0a 2020 2054 6865 2073  IAC SE..   The s
│ │ │ │ -00045ff0: 656e 6465 7220 6f66 2074 6869 7320 636f  ender of this co
│ │ │ │ -00046000: 6d6d 616e 6420 7365 6c65 6374 7320 6465  mmand selects de
│ │ │ │ -00046010: 7369 7265 6420 4d20 616e 6420 4c20 7061  sired M and L pa
│ │ │ │ -00046020: 7261 6d65 7465 7273 2c20 616e 640a e280  rameters, and...
│ │ │ │ -00046030: 986e 6f6e 6365 e280 992c 2061 7320 6465  .nonce..., as de
│ │ │ │ -00046040: 7363 7269 6265 6420 696e 2052 4643 2033  scribed in RFC 3
│ │ │ │ -00046050: 3631 302c 2061 6e64 2073 656e 6473 2069  610, and sends i
│ │ │ │ -00046060: 7420 746f 2074 6865 206f 7468 6572 2073  t to the other s
│ │ │ │ -00046070: 6964 6520 6f66 2074 6865 0a63 6f6e 6e65  ide of the.conne
│ │ │ │ -00046080: 6374 696f 6e2e 2020 5468 6520 7061 7261  ction.  The para
│ │ │ │ -00046090: 6d65 7465 7273 2061 6e64 2074 6865 20e2  meters and the .
│ │ │ │ -000460a0: 8098 6e6f 6e63 65e2 8099 2061 7265 2073  ..nonce... are s
│ │ │ │ -000460b0: 656e 7420 696e 2063 6c65 6172 2074 6578  ent in clear tex
│ │ │ │ -000460c0: 742e 0a4f 6e6c 7920 7468 6520 7369 6465  t..Only the side
│ │ │ │ -000460d0: 206f 6620 7468 6520 636f 6e6e 6563 7469   of the connecti
│ │ │ │ -000460e0: 6f6e 2074 6861 7420 6973 2057 494c 4c20  on that is WILL 
│ │ │ │ -000460f0: 454e 4352 5950 5420 6d61 7920 7365 6e64  ENCRYPT may send
│ │ │ │ -00046100: 2074 6865 0a41 4553 5f43 434d 5f49 4e46   the.AES_CCM_INF
│ │ │ │ -00046110: 4f20 636f 6d6d 616e 642e 0a0a 2020 2049  O command...   I
│ │ │ │ -00046120: 4143 2053 4220 454e 4352 5950 5420 5245  AC SB ENCRYPT RE
│ │ │ │ -00046130: 504c 5920 4145 535f 4343 4d20 4145 535f  PLY AES_CCM AES_
│ │ │ │ -00046140: 4343 4d5f 494e 464f 5f42 4144 2049 4143  CCM_INFO_BAD IAC
│ │ │ │ -00046150: 2053 450a 0a20 2020 5468 6520 7365 6e64   SE..   The send
│ │ │ │ -00046160: 6572 206f 6620 7468 6973 2063 6f6d 6d61  er of this comma
│ │ │ │ -00046170: 6e64 2072 656a 6563 7473 2074 6865 2070  nd rejects the p
│ │ │ │ -00046180: 6172 616d 6574 6572 7320 7265 6365 6976  arameters receiv
│ │ │ │ -00046190: 6564 2069 6e20 7468 650a 4145 535f 4343  ed in the.AES_CC
│ │ │ │ -000461a0: 4d5f 494e 464f 2063 6f6d 6d61 6e64 2e20  M_INFO command. 
│ │ │ │ -000461b0: 204f 6e6c 7920 7468 6520 7369 6465 206f   Only the side o
│ │ │ │ -000461c0: 6620 7468 6520 636f 6e6e 6563 7469 6f6e  f the connection
│ │ │ │ -000461d0: 2074 6861 7420 6973 0a44 4f20 454e 4352   that is.DO ENCR
│ │ │ │ -000461e0: 5950 5420 6d61 7920 7365 6e64 2074 6865  YPT may send the
│ │ │ │ -000461f0: 2041 4553 5f43 434d 5f49 4e46 4f5f 4241   AES_CCM_INFO_BA
│ │ │ │ -00046200: 4420 636f 6d6d 616e 642e 2020 5468 6520  D command.  The 
│ │ │ │ -00046210: 636f 6d6d 616e 6420 4d55 5354 2062 650a  command MUST be.
│ │ │ │ -00046220: 7365 6e74 2069 6620 7468 6520 e280 986e  sent if the ...n
│ │ │ │ -00046230: 6f6e 6365 e280 9920 6669 656c 6420 6c65  once... field le
│ │ │ │ -00046240: 6e67 7468 2064 6f65 7320 6e6f 7420 6d61  ngth does not ma
│ │ │ │ -00046250: 7463 6820 7468 6520 7365 6c65 6374 6564  tch the selected
│ │ │ │ -00046260: 2076 616c 7565 206f 6620 4c2e 0a54 6865   value of L..The
│ │ │ │ -00046270: 2063 6f6d 6d61 6e64 204d 4159 2062 6520   command MAY be 
│ │ │ │ -00046280: 7365 6e74 2069 6620 7468 6520 7265 6365  sent if the rece
│ │ │ │ -00046290: 6976 6572 2064 6f65 7320 6e6f 7420 6163  iver does not ac
│ │ │ │ -000462a0: 6365 7074 2074 6865 2070 6172 616d 6574  cept the paramet
│ │ │ │ -000462b0: 6572 730a 666f 7220 6120 7265 6173 6f6e  ers.for a reason
│ │ │ │ -000462c0: 2073 7563 6820 6173 2070 6f6c 6963 792e   such as policy.
│ │ │ │ -000462d0: 2020 4e6f 2063 6170 6162 696c 6974 7920    No capability 
│ │ │ │ -000462e0: 6973 2070 726f 7669 6465 6420 666f 7220  is provided for 
│ │ │ │ -000462f0: 6e65 676f 7469 6174 696e 670a 7468 6573  negotiating.thes
│ │ │ │ -00046300: 6520 7061 7261 6d65 7465 7273 2e0a 0a20  e parameters... 
│ │ │ │ -00046310: 2020 4941 4320 5342 2045 4e43 5259 5054    IAC SB ENCRYPT
│ │ │ │ -00046320: 2052 4550 4c59 2041 4553 5f43 434d 2041   REPLY AES_CCM A
│ │ │ │ -00046330: 4553 5f43 434d 5f49 4e46 4f5f 4f4b 2049  ES_CCM_INFO_OK I
│ │ │ │ -00046340: 4143 2053 450a 0a20 2020 5468 6520 7365  AC SE..   The se
│ │ │ │ -00046350: 6e64 6572 206f 6620 7468 6973 2063 6f6d  nder of this com
│ │ │ │ -00046360: 6d61 6e64 2061 6363 6570 7473 2074 6865  mand accepts the
│ │ │ │ -00046370: 2070 6172 616d 6574 6572 7320 7265 6365   parameters rece
│ │ │ │ -00046380: 6976 6564 2069 6e20 7468 650a 4145 535f  ived in the.AES_
│ │ │ │ -00046390: 4343 4d5f 494e 464f 2063 6f6d 6d61 6e64  CCM_INFO command
│ │ │ │ -000463a0: 2e20 204f 6e6c 7920 7468 6520 7369 6465  .  Only the side
│ │ │ │ -000463b0: 206f 6620 7468 6520 636f 6e6e 6563 7469   of the connecti
│ │ │ │ -000463c0: 6f6e 2074 6861 7420 6973 0a44 4f20 454e  on that is.DO EN
│ │ │ │ -000463d0: 4352 5950 5420 6d61 7920 7365 6e64 2074  CRYPT may send t
│ │ │ │ -000463e0: 6865 2041 4553 5f43 434d 5f49 4e46 4f5f  he AES_CCM_INFO_
│ │ │ │ -000463f0: 4241 4420 636f 6d6d 616e 642e 2020 5468  BAD command.  Th
│ │ │ │ -00046400: 6520 636f 6d6d 616e 6420 4d55 5354 204e  e command MUST N
│ │ │ │ -00046410: 4f54 0a62 6520 7365 6e74 2069 6620 7468  OT.be sent if th
│ │ │ │ -00046420: 6520 e280 986e 6f6e 6365 e280 9920 6669  e ...nonce... fi
│ │ │ │ -00046430: 656c 6420 6c65 6e67 7468 2064 6f65 7320  eld length does 
│ │ │ │ -00046440: 6e6f 7420 6d61 7463 6820 7468 6520 7365  not match the se
│ │ │ │ -00046450: 6c65 6374 6564 2076 616c 7565 206f 660a  lected value of.
│ │ │ │ -00046460: 4c2e 0a0a 422e 322e 3320 496d 706c 656d  L...B.2.3 Implem
│ │ │ │ -00046470: 656e 7461 7469 6f6e 2052 756c 6573 0a2d  entation Rules.-
│ │ │ │ +00045fa0: 2d2d 2d2d 2d0a 0a20 2020 4941 4320 5342  -----..   IAC SB
│ │ │ │ +00045fb0: 2045 4e43 5259 5054 2049 5320 4145 535f   ENCRYPT IS AES_
│ │ │ │ +00045fc0: 4343 4d20 4145 535f 4343 4d5f 494e 464f  CCM AES_CCM_INFO
│ │ │ │ +00045fd0: 203c 4d3e 203c 4c3e 203c 6e6f 6e63 653e   <M> <L> <nonce>
│ │ │ │ +00045fe0: 2049 4143 2053 450a 0a20 2020 5468 6520   IAC SE..   The 
│ │ │ │ +00045ff0: 7365 6e64 6572 206f 6620 7468 6973 2063  sender of this c
│ │ │ │ +00046000: 6f6d 6d61 6e64 2073 656c 6563 7473 2064  ommand selects d
│ │ │ │ +00046010: 6573 6972 6564 204d 2061 6e64 204c 2070  esired M and L p
│ │ │ │ +00046020: 6172 616d 6574 6572 732c 2061 6e64 0ae2  arameters, and..
│ │ │ │ +00046030: 8098 6e6f 6e63 65e2 8099 2c20 6173 2064  ..nonce..., as d
│ │ │ │ +00046040: 6573 6372 6962 6564 2069 6e20 5246 4320  escribed in RFC 
│ │ │ │ +00046050: 3336 3130 2c20 616e 6420 7365 6e64 7320  3610, and sends 
│ │ │ │ +00046060: 6974 2074 6f20 7468 6520 6f74 6865 7220  it to the other 
│ │ │ │ +00046070: 7369 6465 206f 6620 7468 650a 636f 6e6e  side of the.conn
│ │ │ │ +00046080: 6563 7469 6f6e 2e20 2054 6865 2070 6172  ection.  The par
│ │ │ │ +00046090: 616d 6574 6572 7320 616e 6420 7468 6520  ameters and the 
│ │ │ │ +000460a0: e280 986e 6f6e 6365 e280 9920 6172 6520  ...nonce... are 
│ │ │ │ +000460b0: 7365 6e74 2069 6e20 636c 6561 7220 7465  sent in clear te
│ │ │ │ +000460c0: 7874 2e0a 4f6e 6c79 2074 6865 2073 6964  xt..Only the sid
│ │ │ │ +000460d0: 6520 6f66 2074 6865 2063 6f6e 6e65 6374  e of the connect
│ │ │ │ +000460e0: 696f 6e20 7468 6174 2069 7320 5749 4c4c  ion that is WILL
│ │ │ │ +000460f0: 2045 4e43 5259 5054 206d 6179 2073 656e   ENCRYPT may sen
│ │ │ │ +00046100: 6420 7468 650a 4145 535f 4343 4d5f 494e  d the.AES_CCM_IN
│ │ │ │ +00046110: 464f 2063 6f6d 6d61 6e64 2e0a 0a20 2020  FO command...   
│ │ │ │ +00046120: 4941 4320 5342 2045 4e43 5259 5054 2052  IAC SB ENCRYPT R
│ │ │ │ +00046130: 4550 4c59 2041 4553 5f43 434d 2041 4553  EPLY AES_CCM AES
│ │ │ │ +00046140: 5f43 434d 5f49 4e46 4f5f 4241 4420 4941  _CCM_INFO_BAD IA
│ │ │ │ +00046150: 4320 5345 0a0a 2020 2054 6865 2073 656e  C SE..   The sen
│ │ │ │ +00046160: 6465 7220 6f66 2074 6869 7320 636f 6d6d  der of this comm
│ │ │ │ +00046170: 616e 6420 7265 6a65 6374 7320 7468 6520  and rejects the 
│ │ │ │ +00046180: 7061 7261 6d65 7465 7273 2072 6563 6569  parameters recei
│ │ │ │ +00046190: 7665 6420 696e 2074 6865 0a41 4553 5f43  ved in the.AES_C
│ │ │ │ +000461a0: 434d 5f49 4e46 4f20 636f 6d6d 616e 642e  CM_INFO command.
│ │ │ │ +000461b0: 2020 4f6e 6c79 2074 6865 2073 6964 6520    Only the side 
│ │ │ │ +000461c0: 6f66 2074 6865 2063 6f6e 6e65 6374 696f  of the connectio
│ │ │ │ +000461d0: 6e20 7468 6174 2069 730a 444f 2045 4e43  n that is.DO ENC
│ │ │ │ +000461e0: 5259 5054 206d 6179 2073 656e 6420 7468  RYPT may send th
│ │ │ │ +000461f0: 6520 4145 535f 4343 4d5f 494e 464f 5f42  e AES_CCM_INFO_B
│ │ │ │ +00046200: 4144 2063 6f6d 6d61 6e64 2e20 2054 6865  AD command.  The
│ │ │ │ +00046210: 2063 6f6d 6d61 6e64 204d 5553 5420 6265   command MUST be
│ │ │ │ +00046220: 0a73 656e 7420 6966 2074 6865 20e2 8098  .sent if the ...
│ │ │ │ +00046230: 6e6f 6e63 65e2 8099 2066 6965 6c64 206c  nonce... field l
│ │ │ │ +00046240: 656e 6774 6820 646f 6573 206e 6f74 206d  ength does not m
│ │ │ │ +00046250: 6174 6368 2074 6865 2073 656c 6563 7465  atch the selecte
│ │ │ │ +00046260: 6420 7661 6c75 6520 6f66 204c 2e0a 5468  d value of L..Th
│ │ │ │ +00046270: 6520 636f 6d6d 616e 6420 4d41 5920 6265  e command MAY be
│ │ │ │ +00046280: 2073 656e 7420 6966 2074 6865 2072 6563   sent if the rec
│ │ │ │ +00046290: 6569 7665 7220 646f 6573 206e 6f74 2061  eiver does not a
│ │ │ │ +000462a0: 6363 6570 7420 7468 6520 7061 7261 6d65  ccept the parame
│ │ │ │ +000462b0: 7465 7273 0a66 6f72 2061 2072 6561 736f  ters.for a reaso
│ │ │ │ +000462c0: 6e20 7375 6368 2061 7320 706f 6c69 6379  n such as policy
│ │ │ │ +000462d0: 2e20 204e 6f20 6361 7061 6269 6c69 7479  .  No capability
│ │ │ │ +000462e0: 2069 7320 7072 6f76 6964 6564 2066 6f72   is provided for
│ │ │ │ +000462f0: 206e 6567 6f74 6961 7469 6e67 0a74 6865   negotiating.the
│ │ │ │ +00046300: 7365 2070 6172 616d 6574 6572 732e 0a0a  se parameters...
│ │ │ │ +00046310: 2020 2049 4143 2053 4220 454e 4352 5950     IAC SB ENCRYP
│ │ │ │ +00046320: 5420 5245 504c 5920 4145 535f 4343 4d20  T REPLY AES_CCM 
│ │ │ │ +00046330: 4145 535f 4343 4d5f 494e 464f 5f4f 4b20  AES_CCM_INFO_OK 
│ │ │ │ +00046340: 4941 4320 5345 0a0a 2020 2054 6865 2073  IAC SE..   The s
│ │ │ │ +00046350: 656e 6465 7220 6f66 2074 6869 7320 636f  ender of this co
│ │ │ │ +00046360: 6d6d 616e 6420 6163 6365 7074 7320 7468  mmand accepts th
│ │ │ │ +00046370: 6520 7061 7261 6d65 7465 7273 2072 6563  e parameters rec
│ │ │ │ +00046380: 6569 7665 6420 696e 2074 6865 0a41 4553  eived in the.AES
│ │ │ │ +00046390: 5f43 434d 5f49 4e46 4f20 636f 6d6d 616e  _CCM_INFO comman
│ │ │ │ +000463a0: 642e 2020 4f6e 6c79 2074 6865 2073 6964  d.  Only the sid
│ │ │ │ +000463b0: 6520 6f66 2074 6865 2063 6f6e 6e65 6374  e of the connect
│ │ │ │ +000463c0: 696f 6e20 7468 6174 2069 730a 444f 2045  ion that is.DO E
│ │ │ │ +000463d0: 4e43 5259 5054 206d 6179 2073 656e 6420  NCRYPT may send 
│ │ │ │ +000463e0: 7468 6520 4145 535f 4343 4d5f 494e 464f  the AES_CCM_INFO
│ │ │ │ +000463f0: 5f42 4144 2063 6f6d 6d61 6e64 2e20 2054  _BAD command.  T
│ │ │ │ +00046400: 6865 2063 6f6d 6d61 6e64 204d 5553 5420  he command MUST 
│ │ │ │ +00046410: 4e4f 540a 6265 2073 656e 7420 6966 2074  NOT.be sent if t
│ │ │ │ +00046420: 6865 20e2 8098 6e6f 6e63 65e2 8099 2066  he ...nonce... f
│ │ │ │ +00046430: 6965 6c64 206c 656e 6774 6820 646f 6573  ield length does
│ │ │ │ +00046440: 206e 6f74 206d 6174 6368 2074 6865 2073   not match the s
│ │ │ │ +00046450: 656c 6563 7465 6420 7661 6c75 6520 6f66  elected value of
│ │ │ │ +00046460: 0a4c 2e0a 0a42 2e32 2e33 2049 6d70 6c65  .L...B.2.3 Imple
│ │ │ │ +00046470: 6d65 6e74 6174 696f 6e20 5275 6c65 730a  mentation Rules.
│ │ │ │  00046480: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00046490: 2d2d 2d2d 2d2d 2d2d 2d0a 0a4f 6e63 6520  ---------..Once 
│ │ │ │ -000464a0: 616e 2041 4553 5f43 434d 5f49 4e46 4f5f  an AES_CCM_INFO_
│ │ │ │ -000464b0: 4f4b 2063 6f6d 6d61 6e64 2068 6173 2062  OK command has b
│ │ │ │ -000464c0: 6565 6e20 7265 6365 6976 6564 2c20 7468  een received, th
│ │ │ │ -000464d0: 6520 5749 4c4c 2045 4e43 5259 5054 2073  e WILL ENCRYPT s
│ │ │ │ -000464e0: 6964 650a 6f66 2074 6865 2063 6f6e 6e65  ide.of the conne
│ │ │ │ -000464f0: 6374 696f 6e20 7368 6f75 6c64 2064 6f20  ction should do 
│ │ │ │ -00046500: 6b65 7969 6420 6e65 676f 7469 6174 696f  keyid negotiatio
│ │ │ │ -00046510: 6e20 7573 696e 6720 7468 6520 454e 435f  n using the ENC_
│ │ │ │ -00046520: 4b45 5949 440a 636f 6d6d 616e 642e 2020  KEYID.command.  
│ │ │ │ -00046530: 4f6e 6365 2074 6865 206b 6579 6964 206e  Once the keyid n
│ │ │ │ -00046540: 6567 6f74 6961 7469 6f6e 2068 6173 2073  egotiation has s
│ │ │ │ -00046550: 7563 6365 7373 6675 6c6c 7920 6964 656e  uccessfully iden
│ │ │ │ -00046560: 7469 6669 6564 2061 0a63 6f6d 6d6f 6e20  tified a.common 
│ │ │ │ -00046570: 6b65 7969 642c 2074 6865 6e20 5354 4152  keyid, then STAR
│ │ │ │ -00046580: 5420 616e 6420 454e 4420 636f 6d6d 616e  T and END comman
│ │ │ │ -00046590: 6473 206d 6179 2062 6520 7365 6e74 2062  ds may be sent b
│ │ │ │ -000465a0: 7920 7468 6520 7369 6465 206f 6620 7468  y the side of th
│ │ │ │ -000465b0: 650a 636f 6e6e 6563 7469 6f6e 2074 6861  e.connection tha
│ │ │ │ -000465c0: 7420 6973 2057 494c 4c20 454e 4352 5950  t is WILL ENCRYP
│ │ │ │ -000465d0: 542e 2044 6174 6120 7769 6c6c 2062 6520  T. Data will be 
│ │ │ │ -000465e0: 656e 6372 7970 7465 6420 7573 696e 6720  encrypted using 
│ │ │ │ -000465f0: 7468 650a 4145 532d 4343 4d20 616c 676f  the.AES-CCM algo
│ │ │ │ -00046600: 7269 7468 6d2c 2077 6974 6820 7468 6520  rithm, with the 
│ │ │ │ -00046610: 6e65 676f 7469 6174 6564 20e2 8098 6e6f  negotiated ...no
│ │ │ │ -00046620: 6e63 65e2 8099 2061 6e64 2070 6172 616d  nce... and param
│ │ │ │ -00046630: 6574 6572 7320 4d20 616e 6420 4c2e 0a41  eters M and L..A
│ │ │ │ -00046640: 6674 6572 2065 6163 6820 7375 6363 6573  fter each succes
│ │ │ │ -00046650: 7366 756c 2065 6e63 7279 7074 696f 6e20  sful encryption 
│ │ │ │ -00046660: 616e 6420 6465 6372 7970 7469 6f6e 2c20  and decryption, 
│ │ │ │ -00046670: 7468 6520 e280 986e 6f6e 6365 e280 9920  the ...nonce... 
│ │ │ │ -00046680: 6973 2074 7265 6174 6564 0a61 7320 616e  is treated.as an
│ │ │ │ -00046690: 2069 6e74 6567 6572 2069 6e20 6e65 7477   integer in netw
│ │ │ │ -000466a0: 6f72 6b20 6279 7465 206f 7264 6572 2c20  ork byte order, 
│ │ │ │ -000466b0: 616e 6420 6973 2069 6e63 7265 6d65 6e74  and is increment
│ │ │ │ -000466c0: 6564 2062 7920 6f6e 652e 0a0a 2020 2049  ed by one...   I
│ │ │ │ -000466d0: 6620 656e 6372 7970 7469 6f6e 2028 6465  f encryption (de
│ │ │ │ -000466e0: 6372 7970 7469 6f6e 2920 6973 2074 7572  cryption) is tur
│ │ │ │ -000466f0: 6e65 6420 6f66 6620 616e 6420 6261 636b  ned off and back
│ │ │ │ -00046700: 206f 6e20 6167 6169 6e2c 2061 6e64 2074   on again, and t
│ │ │ │ -00046710: 6865 0a73 616d 6520 6b65 7969 6420 6973  he.same keyid is
│ │ │ │ -00046720: 2075 7365 6420 7768 656e 2072 652d 7374   used when re-st
│ │ │ │ -00046730: 6172 7469 6e67 2074 6865 2065 6e63 7279  arting the encry
│ │ │ │ -00046740: 7074 696f 6e20 2864 6563 7279 7074 696f  ption (decryptio
│ │ │ │ -00046750: 6e29 2c20 7468 656e 0a74 6865 2069 6e74  n), then.the int
│ │ │ │ -00046760: 6572 7665 6e69 6e67 2063 6c65 6172 2074  ervening clear t
│ │ │ │ -00046770: 6578 7420 6d75 7374 206e 6f74 2063 6861  ext must not cha
│ │ │ │ -00046780: 6e67 6520 7468 6520 7374 6174 6520 6f66  nge the state of
│ │ │ │ -00046790: 2074 6865 2065 6e63 7279 7074 696f 6e0a   the encryption.
│ │ │ │ -000467a0: 2864 6563 7279 7074 696f 6e29 206d 6163  (decryption) mac
│ │ │ │ -000467b0: 6869 6e65 2e20 2049 6e20 7061 7274 6963  hine.  In partic
│ │ │ │ -000467c0: 756c 6172 2c20 7468 6520 4145 532d 4343  ular, the AES-CC
│ │ │ │ -000467d0: 4d20 e280 986e 6f6e 6365 e280 9920 6d75  M ...nonce... mu
│ │ │ │ -000467e0: 7374 206e 6f74 2068 6176 650a 6265 656e  st not have.been
│ │ │ │ -000467f0: 2072 652d 7365 742e 0a0a 2020 2049 6620   re-set...   If 
│ │ │ │ -00046800: 6120 5354 4152 5420 636f 6d6d 616e 6420  a START command 
│ │ │ │ -00046810: 6973 2073 656e 7420 2872 6563 6569 7665  is sent (receive
│ │ │ │ -00046820: 6429 2077 6974 6820 6120 6469 6666 6572  d) with a differ
│ │ │ │ -00046830: 656e 7420 6b65 7969 642c 2074 6865 0a65  ent keyid, the.e
│ │ │ │ -00046840: 6e63 7279 7074 696f 6e20 2864 6563 7279  ncryption (decry
│ │ │ │ -00046850: 7074 696f 6e29 206d 6163 6869 6e65 206d  ption) machine m
│ │ │ │ -00046860: 7573 7420 6265 2072 652d 696e 6974 6961  ust be re-initia
│ │ │ │ -00046870: 6c69 7a65 6420 696d 6d65 6469 6174 656c  lized immediatel
│ │ │ │ -00046880: 790a 666f 6c6c 6f77 696e 6720 7468 6520  y.following the 
│ │ │ │ -00046890: 656e 6420 6f66 2074 6865 2053 5441 5254  end of the START
│ │ │ │ -000468a0: 2063 6f6d 6d61 6e64 2077 6974 6820 7468   command with th
│ │ │ │ -000468b0: 6520 6e65 7720 6b65 7920 616e 6420 7468  e new key and th
│ │ │ │ -000468c0: 650a 7061 7261 6d65 7465 7273 2073 656e  e.parameters sen
│ │ │ │ -000468d0: 7420 2872 6563 6569 7665 6429 2069 6e20  t (received) in 
│ │ │ │ -000468e0: 7468 6520 6c61 7374 2041 4553 5f43 434d  the last AES_CCM
│ │ │ │ -000468f0: 5f49 4e46 4f20 636f 6d6d 616e 642e 0a0a  _INFO command...
│ │ │ │ -00046900: 2020 2049 6620 6120 6e65 7720 4145 535f     If a new AES_
│ │ │ │ -00046910: 4343 4d5f 494e 464f 2063 6f6d 6d61 6e64  CCM_INFO command
│ │ │ │ -00046920: 2069 7320 7365 6e74 2028 7265 6365 6976   is sent (receiv
│ │ │ │ -00046930: 6564 292c 2061 6e64 2065 6e63 7279 7074  ed), and encrypt
│ │ │ │ -00046940: 696f 6e0a 2864 6563 7279 7074 696f 6e29  ion.(decryption)
│ │ │ │ -00046950: 2069 7320 656e 6162 6c65 642c 2074 6865   is enabled, the
│ │ │ │ -00046960: 2065 6e63 7279 7074 696f 6e20 2864 6563   encryption (dec
│ │ │ │ -00046970: 7279 7074 696f 6e29 206d 6163 6869 6e65  ryption) machine
│ │ │ │ -00046980: 206d 7573 7420 6265 0a72 652d 696e 6974   must be.re-init
│ │ │ │ -00046990: 6961 6c69 7a65 6420 696d 6d65 6469 6174  ialized immediat
│ │ │ │ -000469a0: 656c 7920 666f 6c6c 6f77 696e 6720 7468  ely following th
│ │ │ │ -000469b0: 6520 656e 6420 6f66 2074 6865 2041 4553  e end of the AES
│ │ │ │ -000469c0: 5f43 434d 5f49 4e46 4f20 636f 6d6d 616e  _CCM_INFO comman
│ │ │ │ -000469d0: 640a 7769 7468 2074 6865 206e 6577 20e2  d.with the new .
│ │ │ │ -000469e0: 8098 6e6f 6e63 65e2 8099 2061 6e64 2070  ..nonce... and p
│ │ │ │ -000469f0: 6172 616d 6574 6572 732c 2061 6e64 2074  arameters, and t
│ │ │ │ -00046a00: 6865 206b 6579 6964 2073 656e 7420 2872  he keyid sent (r
│ │ │ │ -00046a10: 6563 6569 7665 6429 2069 6e0a 7468 6520  eceived) in.the 
│ │ │ │ -00046a20: 6c61 7374 2053 5441 5254 2063 6f6d 6d61  last START comma
│ │ │ │ -00046a30: 6e64 2e0a 0a20 2020 4966 2065 6e63 7279  nd...   If encry
│ │ │ │ -00046a40: 7074 696f 6e20 2864 6563 7279 7074 696f  ption (decryptio
│ │ │ │ -00046a50: 6e29 2069 7320 6e6f 7420 656e 6162 6c65  n) is not enable
│ │ │ │ -00046a60: 6420 7768 656e 2061 6e20 4145 535f 4343  d when an AES_CC
│ │ │ │ -00046a70: 4d5f 494e 464f 0a63 6f6d 6d61 6e64 2069  M_INFO.command i
│ │ │ │ -00046a80: 7320 7365 6e74 2028 7265 6365 6976 6564  s sent (received
│ │ │ │ -00046a90: 292c 2074 6865 2065 6e63 7279 7074 696f  ), the encryptio
│ │ │ │ -00046aa0: 6e20 2864 6563 7279 7074 696f 6e29 206d  n (decryption) m
│ │ │ │ -00046ab0: 6163 6869 6e65 206d 7573 7420 6265 0a72  achine must be.r
│ │ │ │ -00046ac0: 652d 2069 6e69 7469 616c 697a 6564 2061  e- initialized a
│ │ │ │ -00046ad0: 6674 6572 2074 6865 206e 6578 7420 5354  fter the next ST
│ │ │ │ -00046ae0: 4152 5420 636f 6d6d 616e 642c 2077 6974  ART command, wit
│ │ │ │ -00046af0: 6820 7468 6520 6b65 7969 6420 7365 6e74  h the keyid sent
│ │ │ │ -00046b00: 0a28 7265 6365 6976 6564 2920 696e 2074  .(received) in t
│ │ │ │ -00046b10: 6861 7420 5354 4152 5420 636f 6d6d 616e  hat START comman
│ │ │ │ -00046b20: 642c 2061 6e64 2074 6865 20e2 8098 6e6f  d, and the ...no
│ │ │ │ -00046b30: 6e63 65e2 8099 2061 6e64 2070 6172 616d  nce... and param
│ │ │ │ -00046b40: 6574 6572 7320 7365 6e74 0a28 7265 6365  eters sent.(rece
│ │ │ │ -00046b50: 6976 6564 2920 696e 2074 6869 7320 4145  ived) in this AE
│ │ │ │ -00046b60: 535f 4343 4d5f 494e 464f 2063 6f6d 6d61  S_CCM_INFO comma
│ │ │ │ -00046b70: 6e64 2e0a 0a20 2020 4174 2061 6c6c 2074  nd...   At all t
│ │ │ │ -00046b80: 696d 6573 2065 6163 6820 7065 6572 204d  imes each peer M
│ │ │ │ -00046b90: 5553 5420 6d61 6b65 2073 7572 6520 7468  UST make sure th
│ │ │ │ -00046ba0: 6174 2061 6e20 4145 532d 4343 4d20 e280  at an AES-CCM ..
│ │ │ │ -00046bb0: 986e 6f6e 6365 e280 9920 6973 206e 6f74  .nonce... is not
│ │ │ │ -00046bc0: 0a75 7365 6420 7477 6963 6520 7769 7468  .used twice with
│ │ │ │ -00046bd0: 2074 6865 2073 616d 6520 656e 6372 7970   the same encryp
│ │ │ │ -00046be0: 7469 6f6e 206b 6579 2e20 2054 6865 2072  tion key.  The r
│ │ │ │ -00046bf0: 756c 6573 2061 626f 7665 2068 656c 700a  ules above help.
│ │ │ │ -00046c00: 6163 636f 6d70 6c69 7368 2074 6869 7320  accomplish this 
│ │ │ │ -00046c10: 696e 2061 6e20 696e 7465 726f 7065 7261  in an interopera
│ │ │ │ -00046c20: 626c 6520 7761 792e 0a0a 422e 322e 3420  ble way...B.2.4 
│ │ │ │ -00046c30: 496e 7465 6772 6174 696f 6e20 7769 7468  Integration with
│ │ │ │ -00046c40: 2074 6865 2041 5554 4845 4e54 4943 4154   the AUTHENTICAT
│ │ │ │ -00046c50: 494f 4e20 7465 6c6e 6574 206f 7074 696f  ION telnet optio
│ │ │ │ -00046c60: 6e0a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  n.--------------
│ │ │ │ +00046490: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 4f6e 6365  ----------..Once
│ │ │ │ +000464a0: 2061 6e20 4145 535f 4343 4d5f 494e 464f   an AES_CCM_INFO
│ │ │ │ +000464b0: 5f4f 4b20 636f 6d6d 616e 6420 6861 7320  _OK command has 
│ │ │ │ +000464c0: 6265 656e 2072 6563 6569 7665 642c 2074  been received, t
│ │ │ │ +000464d0: 6865 2057 494c 4c20 454e 4352 5950 5420  he WILL ENCRYPT 
│ │ │ │ +000464e0: 7369 6465 0a6f 6620 7468 6520 636f 6e6e  side.of the conn
│ │ │ │ +000464f0: 6563 7469 6f6e 2073 686f 756c 6420 646f  ection should do
│ │ │ │ +00046500: 206b 6579 6964 206e 6567 6f74 6961 7469   keyid negotiati
│ │ │ │ +00046510: 6f6e 2075 7369 6e67 2074 6865 2045 4e43  on using the ENC
│ │ │ │ +00046520: 5f4b 4559 4944 0a63 6f6d 6d61 6e64 2e20  _KEYID.command. 
│ │ │ │ +00046530: 204f 6e63 6520 7468 6520 6b65 7969 6420   Once the keyid 
│ │ │ │ +00046540: 6e65 676f 7469 6174 696f 6e20 6861 7320  negotiation has 
│ │ │ │ +00046550: 7375 6363 6573 7366 756c 6c79 2069 6465  successfully ide
│ │ │ │ +00046560: 6e74 6966 6965 6420 610a 636f 6d6d 6f6e  ntified a.common
│ │ │ │ +00046570: 206b 6579 6964 2c20 7468 656e 2053 5441   keyid, then STA
│ │ │ │ +00046580: 5254 2061 6e64 2045 4e44 2063 6f6d 6d61  RT and END comma
│ │ │ │ +00046590: 6e64 7320 6d61 7920 6265 2073 656e 7420  nds may be sent 
│ │ │ │ +000465a0: 6279 2074 6865 2073 6964 6520 6f66 2074  by the side of t
│ │ │ │ +000465b0: 6865 0a63 6f6e 6e65 6374 696f 6e20 7468  he.connection th
│ │ │ │ +000465c0: 6174 2069 7320 5749 4c4c 2045 4e43 5259  at is WILL ENCRY
│ │ │ │ +000465d0: 5054 2e20 4461 7461 2077 696c 6c20 6265  PT. Data will be
│ │ │ │ +000465e0: 2065 6e63 7279 7074 6564 2075 7369 6e67   encrypted using
│ │ │ │ +000465f0: 2074 6865 0a41 4553 2d43 434d 2061 6c67   the.AES-CCM alg
│ │ │ │ +00046600: 6f72 6974 686d 2c20 7769 7468 2074 6865  orithm, with the
│ │ │ │ +00046610: 206e 6567 6f74 6961 7465 6420 e280 986e   negotiated ...n
│ │ │ │ +00046620: 6f6e 6365 e280 9920 616e 6420 7061 7261  once... and para
│ │ │ │ +00046630: 6d65 7465 7273 204d 2061 6e64 204c 2e0a  meters M and L..
│ │ │ │ +00046640: 4166 7465 7220 6561 6368 2073 7563 6365  After each succe
│ │ │ │ +00046650: 7373 6675 6c20 656e 6372 7970 7469 6f6e  ssful encryption
│ │ │ │ +00046660: 2061 6e64 2064 6563 7279 7074 696f 6e2c   and decryption,
│ │ │ │ +00046670: 2074 6865 20e2 8098 6e6f 6e63 65e2 8099   the ...nonce...
│ │ │ │ +00046680: 2069 7320 7472 6561 7465 640a 6173 2061   is treated.as a
│ │ │ │ +00046690: 6e20 696e 7465 6765 7220 696e 206e 6574  n integer in net
│ │ │ │ +000466a0: 776f 726b 2062 7974 6520 6f72 6465 722c  work byte order,
│ │ │ │ +000466b0: 2061 6e64 2069 7320 696e 6372 656d 656e   and is incremen
│ │ │ │ +000466c0: 7465 6420 6279 206f 6e65 2e0a 0a20 2020  ted by one...   
│ │ │ │ +000466d0: 4966 2065 6e63 7279 7074 696f 6e20 2864  If encryption (d
│ │ │ │ +000466e0: 6563 7279 7074 696f 6e29 2069 7320 7475  ecryption) is tu
│ │ │ │ +000466f0: 726e 6564 206f 6666 2061 6e64 2062 6163  rned off and bac
│ │ │ │ +00046700: 6b20 6f6e 2061 6761 696e 2c20 616e 6420  k on again, and 
│ │ │ │ +00046710: 7468 650a 7361 6d65 206b 6579 6964 2069  the.same keyid i
│ │ │ │ +00046720: 7320 7573 6564 2077 6865 6e20 7265 2d73  s used when re-s
│ │ │ │ +00046730: 7461 7274 696e 6720 7468 6520 656e 6372  tarting the encr
│ │ │ │ +00046740: 7970 7469 6f6e 2028 6465 6372 7970 7469  yption (decrypti
│ │ │ │ +00046750: 6f6e 292c 2074 6865 6e0a 7468 6520 696e  on), then.the in
│ │ │ │ +00046760: 7465 7276 656e 696e 6720 636c 6561 7220  tervening clear 
│ │ │ │ +00046770: 7465 7874 206d 7573 7420 6e6f 7420 6368  text must not ch
│ │ │ │ +00046780: 616e 6765 2074 6865 2073 7461 7465 206f  ange the state o
│ │ │ │ +00046790: 6620 7468 6520 656e 6372 7970 7469 6f6e  f the encryption
│ │ │ │ +000467a0: 0a28 6465 6372 7970 7469 6f6e 2920 6d61  .(decryption) ma
│ │ │ │ +000467b0: 6368 696e 652e 2020 496e 2070 6172 7469  chine.  In parti
│ │ │ │ +000467c0: 6375 6c61 722c 2074 6865 2041 4553 2d43  cular, the AES-C
│ │ │ │ +000467d0: 434d 20e2 8098 6e6f 6e63 65e2 8099 206d  CM ...nonce... m
│ │ │ │ +000467e0: 7573 7420 6e6f 7420 6861 7665 0a62 6565  ust not have.bee
│ │ │ │ +000467f0: 6e20 7265 2d73 6574 2e0a 0a20 2020 4966  n re-set...   If
│ │ │ │ +00046800: 2061 2053 5441 5254 2063 6f6d 6d61 6e64   a START command
│ │ │ │ +00046810: 2069 7320 7365 6e74 2028 7265 6365 6976   is sent (receiv
│ │ │ │ +00046820: 6564 2920 7769 7468 2061 2064 6966 6665  ed) with a diffe
│ │ │ │ +00046830: 7265 6e74 206b 6579 6964 2c20 7468 650a  rent keyid, the.
│ │ │ │ +00046840: 656e 6372 7970 7469 6f6e 2028 6465 6372  encryption (decr
│ │ │ │ +00046850: 7970 7469 6f6e 2920 6d61 6368 696e 6520  yption) machine 
│ │ │ │ +00046860: 6d75 7374 2062 6520 7265 2d69 6e69 7469  must be re-initi
│ │ │ │ +00046870: 616c 697a 6564 2069 6d6d 6564 6961 7465  alized immediate
│ │ │ │ +00046880: 6c79 0a66 6f6c 6c6f 7769 6e67 2074 6865  ly.following the
│ │ │ │ +00046890: 2065 6e64 206f 6620 7468 6520 5354 4152   end of the STAR
│ │ │ │ +000468a0: 5420 636f 6d6d 616e 6420 7769 7468 2074  T command with t
│ │ │ │ +000468b0: 6865 206e 6577 206b 6579 2061 6e64 2074  he new key and t
│ │ │ │ +000468c0: 6865 0a70 6172 616d 6574 6572 7320 7365  he.parameters se
│ │ │ │ +000468d0: 6e74 2028 7265 6365 6976 6564 2920 696e  nt (received) in
│ │ │ │ +000468e0: 2074 6865 206c 6173 7420 4145 535f 4343   the last AES_CC
│ │ │ │ +000468f0: 4d5f 494e 464f 2063 6f6d 6d61 6e64 2e0a  M_INFO command..
│ │ │ │ +00046900: 0a20 2020 4966 2061 206e 6577 2041 4553  .   If a new AES
│ │ │ │ +00046910: 5f43 434d 5f49 4e46 4f20 636f 6d6d 616e  _CCM_INFO comman
│ │ │ │ +00046920: 6420 6973 2073 656e 7420 2872 6563 6569  d is sent (recei
│ │ │ │ +00046930: 7665 6429 2c20 616e 6420 656e 6372 7970  ved), and encryp
│ │ │ │ +00046940: 7469 6f6e 0a28 6465 6372 7970 7469 6f6e  tion.(decryption
│ │ │ │ +00046950: 2920 6973 2065 6e61 626c 6564 2c20 7468  ) is enabled, th
│ │ │ │ +00046960: 6520 656e 6372 7970 7469 6f6e 2028 6465  e encryption (de
│ │ │ │ +00046970: 6372 7970 7469 6f6e 2920 6d61 6368 696e  cryption) machin
│ │ │ │ +00046980: 6520 6d75 7374 2062 650a 7265 2d69 6e69  e must be.re-ini
│ │ │ │ +00046990: 7469 616c 697a 6564 2069 6d6d 6564 6961  tialized immedia
│ │ │ │ +000469a0: 7465 6c79 2066 6f6c 6c6f 7769 6e67 2074  tely following t
│ │ │ │ +000469b0: 6865 2065 6e64 206f 6620 7468 6520 4145  he end of the AE
│ │ │ │ +000469c0: 535f 4343 4d5f 494e 464f 2063 6f6d 6d61  S_CCM_INFO comma
│ │ │ │ +000469d0: 6e64 0a77 6974 6820 7468 6520 6e65 7720  nd.with the new 
│ │ │ │ +000469e0: e280 986e 6f6e 6365 e280 9920 616e 6420  ...nonce... and 
│ │ │ │ +000469f0: 7061 7261 6d65 7465 7273 2c20 616e 6420  parameters, and 
│ │ │ │ +00046a00: 7468 6520 6b65 7969 6420 7365 6e74 2028  the keyid sent (
│ │ │ │ +00046a10: 7265 6365 6976 6564 2920 696e 0a74 6865  received) in.the
│ │ │ │ +00046a20: 206c 6173 7420 5354 4152 5420 636f 6d6d   last START comm
│ │ │ │ +00046a30: 616e 642e 0a0a 2020 2049 6620 656e 6372  and...   If encr
│ │ │ │ +00046a40: 7970 7469 6f6e 2028 6465 6372 7970 7469  yption (decrypti
│ │ │ │ +00046a50: 6f6e 2920 6973 206e 6f74 2065 6e61 626c  on) is not enabl
│ │ │ │ +00046a60: 6564 2077 6865 6e20 616e 2041 4553 5f43  ed when an AES_C
│ │ │ │ +00046a70: 434d 5f49 4e46 4f0a 636f 6d6d 616e 6420  CM_INFO.command 
│ │ │ │ +00046a80: 6973 2073 656e 7420 2872 6563 6569 7665  is sent (receive
│ │ │ │ +00046a90: 6429 2c20 7468 6520 656e 6372 7970 7469  d), the encrypti
│ │ │ │ +00046aa0: 6f6e 2028 6465 6372 7970 7469 6f6e 2920  on (decryption) 
│ │ │ │ +00046ab0: 6d61 6368 696e 6520 6d75 7374 2062 650a  machine must be.
│ │ │ │ +00046ac0: 7265 2d20 696e 6974 6961 6c69 7a65 6420  re- initialized 
│ │ │ │ +00046ad0: 6166 7465 7220 7468 6520 6e65 7874 2053  after the next S
│ │ │ │ +00046ae0: 5441 5254 2063 6f6d 6d61 6e64 2c20 7769  TART command, wi
│ │ │ │ +00046af0: 7468 2074 6865 206b 6579 6964 2073 656e  th the keyid sen
│ │ │ │ +00046b00: 740a 2872 6563 6569 7665 6429 2069 6e20  t.(received) in 
│ │ │ │ +00046b10: 7468 6174 2053 5441 5254 2063 6f6d 6d61  that START comma
│ │ │ │ +00046b20: 6e64 2c20 616e 6420 7468 6520 e280 986e  nd, and the ...n
│ │ │ │ +00046b30: 6f6e 6365 e280 9920 616e 6420 7061 7261  once... and para
│ │ │ │ +00046b40: 6d65 7465 7273 2073 656e 740a 2872 6563  meters sent.(rec
│ │ │ │ +00046b50: 6569 7665 6429 2069 6e20 7468 6973 2041  eived) in this A
│ │ │ │ +00046b60: 4553 5f43 434d 5f49 4e46 4f20 636f 6d6d  ES_CCM_INFO comm
│ │ │ │ +00046b70: 616e 642e 0a0a 2020 2041 7420 616c 6c20  and...   At all 
│ │ │ │ +00046b80: 7469 6d65 7320 6561 6368 2070 6565 7220  times each peer 
│ │ │ │ +00046b90: 4d55 5354 206d 616b 6520 7375 7265 2074  MUST make sure t
│ │ │ │ +00046ba0: 6861 7420 616e 2041 4553 2d43 434d 20e2  hat an AES-CCM .
│ │ │ │ +00046bb0: 8098 6e6f 6e63 65e2 8099 2069 7320 6e6f  ..nonce... is no
│ │ │ │ +00046bc0: 740a 7573 6564 2074 7769 6365 2077 6974  t.used twice wit
│ │ │ │ +00046bd0: 6820 7468 6520 7361 6d65 2065 6e63 7279  h the same encry
│ │ │ │ +00046be0: 7074 696f 6e20 6b65 792e 2020 5468 6520  ption key.  The 
│ │ │ │ +00046bf0: 7275 6c65 7320 6162 6f76 6520 6865 6c70  rules above help
│ │ │ │ +00046c00: 0a61 6363 6f6d 706c 6973 6820 7468 6973  .accomplish this
│ │ │ │ +00046c10: 2069 6e20 616e 2069 6e74 6572 6f70 6572   in an interoper
│ │ │ │ +00046c20: 6162 6c65 2077 6179 2e0a 0a42 2e32 2e34  able way...B.2.4
│ │ │ │ +00046c30: 2049 6e74 6567 7261 7469 6f6e 2077 6974   Integration wit
│ │ │ │ +00046c40: 6820 7468 6520 4155 5448 454e 5449 4341  h the AUTHENTICA
│ │ │ │ +00046c50: 5449 4f4e 2074 656c 6e65 7420 6f70 7469  TION telnet opti
│ │ │ │ +00046c60: 6f6e 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  on.-------------
│ │ │ │  00046c70: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │  00046c80: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00046c90: 2d2d 2d2d 2d2d 2d2d 2d0a 0a41 7320 6e6f  ---------..As no
│ │ │ │ -00046ca0: 7465 6420 696e 2074 6865 2074 656c 6e65  ted in the telne
│ │ │ │ -00046cb0: 7420 454e 4352 5950 5449 4f4e 206f 7074  t ENCRYPTION opt
│ │ │ │ -00046cc0: 696f 6e20 7370 6563 6966 6963 6174 696f  ion specificatio
│ │ │ │ -00046cd0: 6e73 2c20 6120 6b65 7969 6420 7661 6c75  ns, a keyid valu
│ │ │ │ -00046ce0: 650a 6f66 207a 6572 6f20 696e 6469 6361  e.of zero indica
│ │ │ │ -00046cf0: 7465 7320 7468 6520 6465 6661 756c 7420  tes the default 
│ │ │ │ -00046d00: 656e 6372 7970 7469 6f6e 206b 6579 2c20  encryption key, 
│ │ │ │ -00046d10: 6173 206d 6967 6874 2062 6520 6465 7269  as might be deri
│ │ │ │ -00046d20: 7665 6420 6672 6f6d 0a74 6865 2074 656c  ved from.the tel
│ │ │ │ -00046d30: 6e65 7420 4155 5448 454e 5449 4341 5449  net AUTHENTICATI
│ │ │ │ -00046d40: 4f4e 206f 7074 696f 6e2e 2020 4966 2074  ON option.  If t
│ │ │ │ -00046d50: 6865 2064 6566 6175 6c74 2065 6e63 7279  he default encry
│ │ │ │ -00046d60: 7074 696f 6e20 6b65 790a 6e65 676f 7469  ption key.negoti
│ │ │ │ -00046d70: 6174 6564 2061 7320 6120 7265 7375 6c74  ated as a result
│ │ │ │ -00046d80: 206f 6620 7468 6520 7465 6c6e 6574 2041   of the telnet A
│ │ │ │ -00046d90: 5554 4845 4e54 4943 4154 494f 4e20 6f70  UTHENTICATION op
│ │ │ │ -00046da0: 7469 6f6e 2063 6f6e 7461 696e 7320 6c65  tion contains le
│ │ │ │ -00046db0: 7373 0a74 6861 6e20 3332 2062 7974 6573  ss.than 32 bytes
│ │ │ │ -00046dc0: 2028 636f 7272 6573 706f 6e64 696e 6720   (corresponding 
│ │ │ │ -00046dd0: 746f 2074 776f 2031 3238 2062 6974 206b  to two 128 bit k
│ │ │ │ -00046de0: 6579 7329 2c20 7468 656e 2074 6865 2041  eys), then the A
│ │ │ │ -00046df0: 4553 5f43 434d 0a6f 7074 696f 6e20 4d55  ES_CCM.option MU
│ │ │ │ -00046e00: 5354 204e 4f54 2062 6520 6f66 6665 7265  ST NOT be offere
│ │ │ │ -00046e10: 6420 6f72 2075 7365 6420 6173 2061 2076  d or used as a v
│ │ │ │ -00046e20: 616c 6964 2074 656c 6e65 7420 656e 6372  alid telnet encr
│ │ │ │ -00046e30: 7970 7469 6f6e 206f 7074 696f 6e2e 0a46  yption option..F
│ │ │ │ -00046e40: 7572 7468 6572 6d6f 7265 2c20 6465 7065  urthermore, depe
│ │ │ │ -00046e50: 6e64 696e 6720 6f6e 2070 6f6c 6963 7920  nding on policy 
│ │ │ │ -00046e60: 666f 7220 6b65 7920 6c65 6e67 7468 732c  for key lengths,
│ │ │ │ -00046e70: 2074 6865 2041 4553 5f43 434d 206f 7074   the AES_CCM opt
│ │ │ │ -00046e80: 696f 6e20 4d41 590a 6265 2064 6973 6162  ion MAY.be disab
│ │ │ │ -00046e90: 6c65 6420 6966 2074 6865 2064 6566 6175  led if the defau
│ │ │ │ -00046ea0: 6c74 2065 6e63 7279 7074 696f 6e20 6b65  lt encryption ke
│ │ │ │ -00046eb0: 7920 636f 6e74 6169 6e20 6c65 7373 2074  y contain less t
│ │ │ │ -00046ec0: 6861 6e20 3438 2062 7974 6573 0a28 666f  han 48 bytes.(fo
│ │ │ │ -00046ed0: 7220 7477 6f20 3139 3220 6269 7420 6b65  r two 192 bit ke
│ │ │ │ -00046ee0: 7973 292c 206f 7220 6c65 7373 2074 6861  ys), or less tha
│ │ │ │ -00046ef0: 6e20 3634 2062 7974 6573 2028 666f 7220  n 64 bytes (for 
│ │ │ │ -00046f00: 7477 6f20 3235 3620 6269 7420 6b65 7973  two 256 bit keys
│ │ │ │ -00046f10: 292c 2061 730a 7765 6c6c 2e0a 0a20 2020  ), as.well...   
│ │ │ │ -00046f20: 5468 6520 6176 6169 6c61 626c 6520 656e  The available en
│ │ │ │ -00046f30: 6372 7970 7420 6b65 7920 6461 7461 2069  crypt key data i
│ │ │ │ -00046f40: 7320 6469 7669 6465 6420 6f6e 2074 776f  s divided on two
│ │ │ │ -00046f50: 2068 616c 7665 732c 2077 6865 7265 2074   halves, where t
│ │ │ │ -00046f60: 6865 0a66 6972 7374 2068 616c 6620 6973  he.first half is
│ │ │ │ -00046f70: 2075 7365 6420 746f 2065 6e63 7279 7074   used to encrypt
│ │ │ │ -00046f80: 2064 6174 6120 7365 6e74 2066 726f 6d20   data sent from 
│ │ │ │ -00046f90: 7468 6520 7365 7276 6572 2028 6465 6372  the server (decr
│ │ │ │ -00046fa0: 7970 7420 6461 7461 0a72 6563 6569 7665  ypt data.receive
│ │ │ │ -00046fb0: 6420 6279 2074 6865 2063 6c69 656e 7429  d by the client)
│ │ │ │ -00046fc0: 2c20 616e 6420 7468 6520 7365 636f 6e64  , and the second
│ │ │ │ -00046fd0: 2068 616c 6620 6973 2075 7365 6420 746f   half is used to
│ │ │ │ -00046fe0: 2065 6e63 7279 7074 2064 6174 610a 7365   encrypt data.se
│ │ │ │ -00046ff0: 6e74 2066 726f 6d20 7468 6520 636c 6965  nt from the clie
│ │ │ │ -00047000: 6e74 2028 6465 6372 7970 7420 6461 7461  nt (decrypt data
│ │ │ │ -00047010: 2072 6563 6569 7665 6420 6279 2074 6865   received by the
│ │ │ │ -00047020: 2073 6572 7665 7229 2e0a 0a20 2020 4e6f   server)...   No
│ │ │ │ -00047030: 7465 2074 6861 7420 7468 6520 6162 6f76  te that the abov
│ │ │ │ -00047040: 6520 616c 676f 7269 7468 6d20 6173 7375  e algorithm assu
│ │ │ │ -00047050: 6d65 7320 7468 6174 2074 6865 2041 5554  mes that the AUT
│ │ │ │ -00047060: 4845 4e54 4943 4154 494f 4e0a 6d65 6368  HENTICATION.mech
│ │ │ │ -00047070: 616e 6973 6d20 6765 6e65 7261 7465 206b  anism generate k
│ │ │ │ -00047080: 6579 696e 6720 6d61 7465 7269 616c 2073  eying material s
│ │ │ │ -00047090: 7569 7461 626c 6520 666f 7220 4145 532d  uitable for AES-
│ │ │ │ -000470a0: 4343 4d20 6173 2075 7365 6420 696e 2074  CCM as used in t
│ │ │ │ -000470b0: 6869 730a 7370 6563 6966 6963 6174 696f  his.specificatio
│ │ │ │ -000470c0: 6e2e 2020 5468 6973 2069 7320 6e6f 7420  n.  This is not 
│ │ │ │ -000470d0: 6e65 6365 7373 6172 696c 7920 7472 7565  necessarily true
│ │ │ │ -000470e0: 2069 6e20 6765 6e65 7261 6c2c 2062 7574   in general, but
│ │ │ │ -000470f0: 2077 6520 7370 6563 6966 790a 7468 6973   we specify.this
│ │ │ │ -00047100: 2062 6568 6176 696f 7572 2061 7320 7468   behaviour as th
│ │ │ │ -00047110: 6520 6465 6661 756c 7420 7369 6e63 6520  e default since 
│ │ │ │ -00047120: 6974 2069 7320 7472 7565 2066 6f72 206d  it is true for m
│ │ │ │ -00047130: 6f73 7420 6175 7468 656e 7469 6361 7469  ost authenticati
│ │ │ │ -00047140: 6f6e 0a73 7973 7465 6d73 2069 6e20 706f  on.systems in po
│ │ │ │ -00047150: 7075 6c61 7220 7573 6520 746f 6461 792e  pular use today.
│ │ │ │ -00047160: 2020 4e65 7720 7465 6c6e 6574 2041 5554    New telnet AUT
│ │ │ │ -00047170: 4845 4e54 4943 4154 494f 4e20 6d65 6368  HENTICATION mech
│ │ │ │ -00047180: 616e 6973 6d73 206d 6179 0a73 7065 6369  anisms may.speci
│ │ │ │ -00047190: 6679 2061 6c74 6572 6e61 7469 7665 206d  fy alternative m
│ │ │ │ -000471a0: 6574 686f 6473 2066 6f72 2064 6574 6572  ethods for deter
│ │ │ │ -000471b0: 6d69 6e69 6e67 2074 6865 206b 6579 7320  mining the keys 
│ │ │ │ -000471c0: 746f 2062 6520 7573 6564 2066 6f72 2074  to be used for t
│ │ │ │ -000471d0: 6869 730a 6369 7068 6572 2073 7569 7465  his.cipher suite
│ │ │ │ -000471e0: 2069 6e20 7468 6569 7220 7370 6563 6966   in their specif
│ │ │ │ -000471f0: 6963 6174 696f 6e2c 2069 6620 7468 6520  ication, if the 
│ │ │ │ -00047200: 7365 7373 696f 6e20 6b65 7920 6e65 676f  session key nego
│ │ │ │ -00047210: 7469 6174 6564 2062 790a 7468 6174 2061  tiated by.that a
│ │ │ │ -00047220: 7574 6865 6e74 6963 6174 696f 6e20 6d65  uthentication me
│ │ │ │ -00047230: 6368 616e 6973 6d20 6973 206e 6f74 2061  chanism is not a
│ │ │ │ -00047240: 2044 4553 206b 6579 2061 6e64 2077 6865   DES key and whe
│ │ │ │ -00047250: 7265 2074 6869 7320 616c 676f 7269 7468  re this algorith
│ │ │ │ -00047260: 6d0a 6d61 7920 6e6f 7420 6265 2073 6166  m.may not be saf
│ │ │ │ -00047270: 656c 7920 7573 6564 2e0a 0a20 2020 4b65  ely used...   Ke
│ │ │ │ -00047280: 7262 6572 6f73 2035 2061 7574 6865 6e74  rberos 5 authent
│ │ │ │ -00047290: 6963 6174 696f 6e20 636c 6172 6966 6963  ication clarific
│ │ │ │ -000472a0: 6174 696f 6e3a 2054 6865 206b 6579 2075  ation: The key u
│ │ │ │ -000472b0: 7365 6420 746f 2065 6e63 7279 7074 2064  sed to encrypt d
│ │ │ │ -000472c0: 6174 610a 6672 6f6d 2074 6865 2063 6c69  ata.from the cli
│ │ │ │ -000472d0: 656e 7420 746f 2074 6865 2073 6572 7665  ent to the serve
│ │ │ │ -000472e0: 7220 6973 2074 616b 656e 2066 726f 6d20  r is taken from 
│ │ │ │ -000472f0: 7468 6520 7375 622d 7365 7373 696f 6e20  the sub-session 
│ │ │ │ -00047300: 6b65 7920 696e 2074 6865 0a41 502d 5245  key in the.AP-RE
│ │ │ │ -00047310: 512e 2020 5468 6520 6b65 7920 7573 6564  Q.  The key used
│ │ │ │ -00047320: 2074 6f20 6465 6372 7970 7420 6461 7461   to decrypt data
│ │ │ │ -00047330: 2066 726f 6d20 7468 6520 7365 7276 6572   from the server
│ │ │ │ -00047340: 2074 6f20 7468 6520 636c 6965 6e74 2069   to the client i
│ │ │ │ -00047350: 730a 7461 6b65 6e20 6672 6f6d 2074 6865  s.taken from the
│ │ │ │ -00047360: 2073 7562 2d73 6573 7369 6f6e 206b 6579   sub-session key
│ │ │ │ -00047370: 2069 6e20 7468 6520 4150 2d52 4550 2e20   in the AP-REP. 
│ │ │ │ -00047380: 4966 206d 7574 7561 6c20 6175 7468 656e  If mutual authen
│ │ │ │ -00047390: 7469 6361 7469 6f6e 0a69 7320 6e6f 7420  tication.is not 
│ │ │ │ -000473a0: 6e65 676f 7469 6174 6564 2c20 7468 6520  negotiated, the 
│ │ │ │ -000473b0: 6b65 7920 7573 6564 2074 6f20 656e 6372  key used to encr
│ │ │ │ -000473c0: 7970 7420 6461 7461 2066 726f 6d20 7468  ypt data from th
│ │ │ │ -000473d0: 6520 636c 6965 6e74 2074 6f20 7468 650a  e client to the.
│ │ │ │ -000473e0: 7365 7276 6572 2069 7320 7461 6b65 6e20  server is taken 
│ │ │ │ -000473f0: 6672 6f6d 2074 6865 2073 6573 7369 6f6e  from the session
│ │ │ │ -00047400: 206b 6579 2069 6e20 7468 6520 7469 636b   key in the tick
│ │ │ │ -00047410: 6574 2c20 616e 6420 7468 6520 6b65 7920  et, and the key 
│ │ │ │ -00047420: 7573 6564 2074 6f0a 6465 6372 7970 7420  used to.decrypt 
│ │ │ │ -00047430: 6461 7461 2066 726f 6d20 7468 6520 7365  data from the se
│ │ │ │ -00047440: 7276 6572 2074 6f20 7468 6520 636c 6965  rver to the clie
│ │ │ │ -00047450: 6e74 2069 7320 7461 6b65 6e20 6672 6f6d  nt is taken from
│ │ │ │ -00047460: 2074 6865 2073 7562 2d73 6573 7369 6f6e   the sub-session
│ │ │ │ -00047470: 0a6b 6579 2069 6e20 7468 6520 4150 2d52  .key in the AP-R
│ │ │ │ -00047480: 4551 2e20 4c65 6176 696e 6720 7468 6520  EQ. Leaving the 
│ │ │ │ -00047490: 4150 2d52 4551 2073 7562 2d6b 6579 2066  AP-REQ sub-key f
│ │ │ │ -000474a0: 6965 6c64 2065 6d70 7479 204d 5553 5420  ield empty MUST 
│ │ │ │ -000474b0: 6469 7361 626c 650a 7468 6520 4145 535f  disable.the AES_
│ │ │ │ -000474c0: 4343 4d20 6f70 7469 6f6e 2e0a 0a42 2e32  CCM option...B.2
│ │ │ │ -000474d0: 2e35 2053 6563 7572 6974 7920 436f 6e73  .5 Security Cons
│ │ │ │ -000474e0: 6964 6572 6174 696f 6e73 0a2d 2d2d 2d2d  iderations.-----
│ │ │ │ +00046c90: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 4173 206e  ----------..As n
│ │ │ │ +00046ca0: 6f74 6564 2069 6e20 7468 6520 7465 6c6e  oted in the teln
│ │ │ │ +00046cb0: 6574 2045 4e43 5259 5054 494f 4e20 6f70  et ENCRYPTION op
│ │ │ │ +00046cc0: 7469 6f6e 2073 7065 6369 6669 6361 7469  tion specificati
│ │ │ │ +00046cd0: 6f6e 732c 2061 206b 6579 6964 2076 616c  ons, a keyid val
│ │ │ │ +00046ce0: 7565 0a6f 6620 7a65 726f 2069 6e64 6963  ue.of zero indic
│ │ │ │ +00046cf0: 6174 6573 2074 6865 2064 6566 6175 6c74  ates the default
│ │ │ │ +00046d00: 2065 6e63 7279 7074 696f 6e20 6b65 792c   encryption key,
│ │ │ │ +00046d10: 2061 7320 6d69 6768 7420 6265 2064 6572   as might be der
│ │ │ │ +00046d20: 6976 6564 2066 726f 6d0a 7468 6520 7465  ived from.the te
│ │ │ │ +00046d30: 6c6e 6574 2041 5554 4845 4e54 4943 4154  lnet AUTHENTICAT
│ │ │ │ +00046d40: 494f 4e20 6f70 7469 6f6e 2e20 2049 6620  ION option.  If 
│ │ │ │ +00046d50: 7468 6520 6465 6661 756c 7420 656e 6372  the default encr
│ │ │ │ +00046d60: 7970 7469 6f6e 206b 6579 0a6e 6567 6f74  yption key.negot
│ │ │ │ +00046d70: 6961 7465 6420 6173 2061 2072 6573 756c  iated as a resul
│ │ │ │ +00046d80: 7420 6f66 2074 6865 2074 656c 6e65 7420  t of the telnet 
│ │ │ │ +00046d90: 4155 5448 454e 5449 4341 5449 4f4e 206f  AUTHENTICATION o
│ │ │ │ +00046da0: 7074 696f 6e20 636f 6e74 6169 6e73 206c  ption contains l
│ │ │ │ +00046db0: 6573 730a 7468 616e 2033 3220 6279 7465  ess.than 32 byte
│ │ │ │ +00046dc0: 7320 2863 6f72 7265 7370 6f6e 6469 6e67  s (corresponding
│ │ │ │ +00046dd0: 2074 6f20 7477 6f20 3132 3820 6269 7420   to two 128 bit 
│ │ │ │ +00046de0: 6b65 7973 292c 2074 6865 6e20 7468 6520  keys), then the 
│ │ │ │ +00046df0: 4145 535f 4343 4d0a 6f70 7469 6f6e 204d  AES_CCM.option M
│ │ │ │ +00046e00: 5553 5420 4e4f 5420 6265 206f 6666 6572  UST NOT be offer
│ │ │ │ +00046e10: 6564 206f 7220 7573 6564 2061 7320 6120  ed or used as a 
│ │ │ │ +00046e20: 7661 6c69 6420 7465 6c6e 6574 2065 6e63  valid telnet enc
│ │ │ │ +00046e30: 7279 7074 696f 6e20 6f70 7469 6f6e 2e0a  ryption option..
│ │ │ │ +00046e40: 4675 7274 6865 726d 6f72 652c 2064 6570  Furthermore, dep
│ │ │ │ +00046e50: 656e 6469 6e67 206f 6e20 706f 6c69 6379  ending on policy
│ │ │ │ +00046e60: 2066 6f72 206b 6579 206c 656e 6774 6873   for key lengths
│ │ │ │ +00046e70: 2c20 7468 6520 4145 535f 4343 4d20 6f70  , the AES_CCM op
│ │ │ │ +00046e80: 7469 6f6e 204d 4159 0a62 6520 6469 7361  tion MAY.be disa
│ │ │ │ +00046e90: 626c 6564 2069 6620 7468 6520 6465 6661  bled if the defa
│ │ │ │ +00046ea0: 756c 7420 656e 6372 7970 7469 6f6e 206b  ult encryption k
│ │ │ │ +00046eb0: 6579 2063 6f6e 7461 696e 206c 6573 7320  ey contain less 
│ │ │ │ +00046ec0: 7468 616e 2034 3820 6279 7465 730a 2866  than 48 bytes.(f
│ │ │ │ +00046ed0: 6f72 2074 776f 2031 3932 2062 6974 206b  or two 192 bit k
│ │ │ │ +00046ee0: 6579 7329 2c20 6f72 206c 6573 7320 7468  eys), or less th
│ │ │ │ +00046ef0: 616e 2036 3420 6279 7465 7320 2866 6f72  an 64 bytes (for
│ │ │ │ +00046f00: 2074 776f 2032 3536 2062 6974 206b 6579   two 256 bit key
│ │ │ │ +00046f10: 7329 2c20 6173 0a77 656c 6c2e 0a0a 2020  s), as.well...  
│ │ │ │ +00046f20: 2054 6865 2061 7661 696c 6162 6c65 2065   The available e
│ │ │ │ +00046f30: 6e63 7279 7074 206b 6579 2064 6174 6120  ncrypt key data 
│ │ │ │ +00046f40: 6973 2064 6976 6964 6564 206f 6e20 7477  is divided on tw
│ │ │ │ +00046f50: 6f20 6861 6c76 6573 2c20 7768 6572 6520  o halves, where 
│ │ │ │ +00046f60: 7468 650a 6669 7273 7420 6861 6c66 2069  the.first half i
│ │ │ │ +00046f70: 7320 7573 6564 2074 6f20 656e 6372 7970  s used to encryp
│ │ │ │ +00046f80: 7420 6461 7461 2073 656e 7420 6672 6f6d  t data sent from
│ │ │ │ +00046f90: 2074 6865 2073 6572 7665 7220 2864 6563   the server (dec
│ │ │ │ +00046fa0: 7279 7074 2064 6174 610a 7265 6365 6976  rypt data.receiv
│ │ │ │ +00046fb0: 6564 2062 7920 7468 6520 636c 6965 6e74  ed by the client
│ │ │ │ +00046fc0: 292c 2061 6e64 2074 6865 2073 6563 6f6e  ), and the secon
│ │ │ │ +00046fd0: 6420 6861 6c66 2069 7320 7573 6564 2074  d half is used t
│ │ │ │ +00046fe0: 6f20 656e 6372 7970 7420 6461 7461 0a73  o encrypt data.s
│ │ │ │ +00046ff0: 656e 7420 6672 6f6d 2074 6865 2063 6c69  ent from the cli
│ │ │ │ +00047000: 656e 7420 2864 6563 7279 7074 2064 6174  ent (decrypt dat
│ │ │ │ +00047010: 6120 7265 6365 6976 6564 2062 7920 7468  a received by th
│ │ │ │ +00047020: 6520 7365 7276 6572 292e 0a0a 2020 204e  e server)...   N
│ │ │ │ +00047030: 6f74 6520 7468 6174 2074 6865 2061 626f  ote that the abo
│ │ │ │ +00047040: 7665 2061 6c67 6f72 6974 686d 2061 7373  ve algorithm ass
│ │ │ │ +00047050: 756d 6573 2074 6861 7420 7468 6520 4155  umes that the AU
│ │ │ │ +00047060: 5448 454e 5449 4341 5449 4f4e 0a6d 6563  THENTICATION.mec
│ │ │ │ +00047070: 6861 6e69 736d 2067 656e 6572 6174 6520  hanism generate 
│ │ │ │ +00047080: 6b65 7969 6e67 206d 6174 6572 6961 6c20  keying material 
│ │ │ │ +00047090: 7375 6974 6162 6c65 2066 6f72 2041 4553  suitable for AES
│ │ │ │ +000470a0: 2d43 434d 2061 7320 7573 6564 2069 6e20  -CCM as used in 
│ │ │ │ +000470b0: 7468 6973 0a73 7065 6369 6669 6361 7469  this.specificati
│ │ │ │ +000470c0: 6f6e 2e20 2054 6869 7320 6973 206e 6f74  on.  This is not
│ │ │ │ +000470d0: 206e 6563 6573 7361 7269 6c79 2074 7275   necessarily tru
│ │ │ │ +000470e0: 6520 696e 2067 656e 6572 616c 2c20 6275  e in general, bu
│ │ │ │ +000470f0: 7420 7765 2073 7065 6369 6679 0a74 6869  t we specify.thi
│ │ │ │ +00047100: 7320 6265 6861 7669 6f75 7220 6173 2074  s behaviour as t
│ │ │ │ +00047110: 6865 2064 6566 6175 6c74 2073 696e 6365  he default since
│ │ │ │ +00047120: 2069 7420 6973 2074 7275 6520 666f 7220   it is true for 
│ │ │ │ +00047130: 6d6f 7374 2061 7574 6865 6e74 6963 6174  most authenticat
│ │ │ │ +00047140: 696f 6e0a 7379 7374 656d 7320 696e 2070  ion.systems in p
│ │ │ │ +00047150: 6f70 756c 6172 2075 7365 2074 6f64 6179  opular use today
│ │ │ │ +00047160: 2e20 204e 6577 2074 656c 6e65 7420 4155  .  New telnet AU
│ │ │ │ +00047170: 5448 454e 5449 4341 5449 4f4e 206d 6563  THENTICATION mec
│ │ │ │ +00047180: 6861 6e69 736d 7320 6d61 790a 7370 6563  hanisms may.spec
│ │ │ │ +00047190: 6966 7920 616c 7465 726e 6174 6976 6520  ify alternative 
│ │ │ │ +000471a0: 6d65 7468 6f64 7320 666f 7220 6465 7465  methods for dete
│ │ │ │ +000471b0: 726d 696e 696e 6720 7468 6520 6b65 7973  rmining the keys
│ │ │ │ +000471c0: 2074 6f20 6265 2075 7365 6420 666f 7220   to be used for 
│ │ │ │ +000471d0: 7468 6973 0a63 6970 6865 7220 7375 6974  this.cipher suit
│ │ │ │ +000471e0: 6520 696e 2074 6865 6972 2073 7065 6369  e in their speci
│ │ │ │ +000471f0: 6669 6361 7469 6f6e 2c20 6966 2074 6865  fication, if the
│ │ │ │ +00047200: 2073 6573 7369 6f6e 206b 6579 206e 6567   session key neg
│ │ │ │ +00047210: 6f74 6961 7465 6420 6279 0a74 6861 7420  otiated by.that 
│ │ │ │ +00047220: 6175 7468 656e 7469 6361 7469 6f6e 206d  authentication m
│ │ │ │ +00047230: 6563 6861 6e69 736d 2069 7320 6e6f 7420  echanism is not 
│ │ │ │ +00047240: 6120 4445 5320 6b65 7920 616e 6420 7768  a DES key and wh
│ │ │ │ +00047250: 6572 6520 7468 6973 2061 6c67 6f72 6974  ere this algorit
│ │ │ │ +00047260: 686d 0a6d 6179 206e 6f74 2062 6520 7361  hm.may not be sa
│ │ │ │ +00047270: 6665 6c79 2075 7365 642e 0a0a 2020 204b  fely used...   K
│ │ │ │ +00047280: 6572 6265 726f 7320 3520 6175 7468 656e  erberos 5 authen
│ │ │ │ +00047290: 7469 6361 7469 6f6e 2063 6c61 7269 6669  tication clarifi
│ │ │ │ +000472a0: 6361 7469 6f6e 3a20 5468 6520 6b65 7920  cation: The key 
│ │ │ │ +000472b0: 7573 6564 2074 6f20 656e 6372 7970 7420  used to encrypt 
│ │ │ │ +000472c0: 6461 7461 0a66 726f 6d20 7468 6520 636c  data.from the cl
│ │ │ │ +000472d0: 6965 6e74 2074 6f20 7468 6520 7365 7276  ient to the serv
│ │ │ │ +000472e0: 6572 2069 7320 7461 6b65 6e20 6672 6f6d  er is taken from
│ │ │ │ +000472f0: 2074 6865 2073 7562 2d73 6573 7369 6f6e   the sub-session
│ │ │ │ +00047300: 206b 6579 2069 6e20 7468 650a 4150 2d52   key in the.AP-R
│ │ │ │ +00047310: 4551 2e20 2054 6865 206b 6579 2075 7365  EQ.  The key use
│ │ │ │ +00047320: 6420 746f 2064 6563 7279 7074 2064 6174  d to decrypt dat
│ │ │ │ +00047330: 6120 6672 6f6d 2074 6865 2073 6572 7665  a from the serve
│ │ │ │ +00047340: 7220 746f 2074 6865 2063 6c69 656e 7420  r to the client 
│ │ │ │ +00047350: 6973 0a74 616b 656e 2066 726f 6d20 7468  is.taken from th
│ │ │ │ +00047360: 6520 7375 622d 7365 7373 696f 6e20 6b65  e sub-session ke
│ │ │ │ +00047370: 7920 696e 2074 6865 2041 502d 5245 502e  y in the AP-REP.
│ │ │ │ +00047380: 2049 6620 6d75 7475 616c 2061 7574 6865   If mutual authe
│ │ │ │ +00047390: 6e74 6963 6174 696f 6e0a 6973 206e 6f74  ntication.is not
│ │ │ │ +000473a0: 206e 6567 6f74 6961 7465 642c 2074 6865   negotiated, the
│ │ │ │ +000473b0: 206b 6579 2075 7365 6420 746f 2065 6e63   key used to enc
│ │ │ │ +000473c0: 7279 7074 2064 6174 6120 6672 6f6d 2074  rypt data from t
│ │ │ │ +000473d0: 6865 2063 6c69 656e 7420 746f 2074 6865  he client to the
│ │ │ │ +000473e0: 0a73 6572 7665 7220 6973 2074 616b 656e  .server is taken
│ │ │ │ +000473f0: 2066 726f 6d20 7468 6520 7365 7373 696f   from the sessio
│ │ │ │ +00047400: 6e20 6b65 7920 696e 2074 6865 2074 6963  n key in the tic
│ │ │ │ +00047410: 6b65 742c 2061 6e64 2074 6865 206b 6579  ket, and the key
│ │ │ │ +00047420: 2075 7365 6420 746f 0a64 6563 7279 7074   used to.decrypt
│ │ │ │ +00047430: 2064 6174 6120 6672 6f6d 2074 6865 2073   data from the s
│ │ │ │ +00047440: 6572 7665 7220 746f 2074 6865 2063 6c69  erver to the cli
│ │ │ │ +00047450: 656e 7420 6973 2074 616b 656e 2066 726f  ent is taken fro
│ │ │ │ +00047460: 6d20 7468 6520 7375 622d 7365 7373 696f  m the sub-sessio
│ │ │ │ +00047470: 6e0a 6b65 7920 696e 2074 6865 2041 502d  n.key in the AP-
│ │ │ │ +00047480: 5245 512e 204c 6561 7669 6e67 2074 6865  REQ. Leaving the
│ │ │ │ +00047490: 2041 502d 5245 5120 7375 622d 6b65 7920   AP-REQ sub-key 
│ │ │ │ +000474a0: 6669 656c 6420 656d 7074 7920 4d55 5354  field empty MUST
│ │ │ │ +000474b0: 2064 6973 6162 6c65 0a74 6865 2041 4553   disable.the AES
│ │ │ │ +000474c0: 5f43 434d 206f 7074 696f 6e2e 0a0a 422e  _CCM option...B.
│ │ │ │ +000474d0: 322e 3520 5365 6375 7269 7479 2043 6f6e  2.5 Security Con
│ │ │ │ +000474e0: 7369 6465 7261 7469 6f6e 730a 2d2d 2d2d  siderations.----
│ │ │ │  000474f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00047500: 2d2d 2d2d 2d2d 2d2d 0a0a 5468 6520 7072  --------..The pr
│ │ │ │ -00047510: 6f74 6f63 6f6c 206d 7573 7420 6265 2070  otocol must be p
│ │ │ │ -00047520: 726f 7065 726c 7920 616e 6420 7365 6375  roperly and secu
│ │ │ │ -00047530: 7265 6c79 2069 6d70 6c65 6d65 6e74 6564  rely implemented
│ │ │ │ -00047540: 2e20 2046 6f72 2065 7861 6d70 6c65 2c20  .  For example, 
│ │ │ │ -00047550: 616e 0a69 6d70 6c65 6d65 6e74 6174 696f  an.implementatio
│ │ │ │ -00047560: 6e20 7368 6f75 6c64 206e 6f74 2062 6520  n should not be 
│ │ │ │ -00047570: 7675 6c6e 6572 6162 6c65 2074 6f20 7661  vulnerable to va
│ │ │ │ -00047580: 7269 6f75 730a 696d 706c 656d 656e 7461  rious.implementa
│ │ │ │ -00047590: 7469 6f6e 2d73 7065 6369 6669 6320 6174  tion-specific at
│ │ │ │ -000475a0: 7461 636b 7320 7375 6368 2061 7320 6275  tacks such as bu
│ │ │ │ -000475b0: 6666 6572 206f 7665 7266 6c6f 7773 206f  ffer overflows o
│ │ │ │ -000475c0: 7220 7369 6465 2d63 6861 6e6e 656c 0a61  r side-channel.a
│ │ │ │ -000475d0: 6e61 6c79 7369 732e 0a0a 2020 2057 6520  nalysis...   We 
│ │ │ │ -000475e0: 7769 7368 2074 6f20 7265 7065 6174 2074  wish to repeat t
│ │ │ │ -000475f0: 6865 2073 7567 6765 7374 696f 6e20 6672  he suggestion fr
│ │ │ │ -00047600: 6f6d 2052 4643 2032 3934 362c 2074 6f20  om RFC 2946, to 
│ │ │ │ -00047610: 696e 7665 7374 6967 6174 6520 610a 5354  investigate a.ST
│ │ │ │ -00047620: 4152 5454 4c53 2061 7070 726f 6163 6820  ARTTLS approach 
│ │ │ │ -00047630: 666f 7220 5465 6c6e 6574 2065 6e63 7279  for Telnet encry
│ │ │ │ -00047640: 7074 696f 6e20 2861 6e64 2061 6c73 6f20  ption (and also 
│ │ │ │ -00047650: 6175 7468 656e 7469 6361 7469 6f6e 292c  authentication),
│ │ │ │ -00047660: 2077 6865 6e0a 7468 6520 7365 6375 7269   when.the securi
│ │ │ │ -00047670: 7479 206c 6576 656c 2070 726f 7669 6465  ty level provide
│ │ │ │ -00047680: 6420 6279 2074 6869 7320 7370 6563 6966  d by this specif
│ │ │ │ -00047690: 6963 6174 696f 6e20 6973 206e 6f74 2061  ication is not a
│ │ │ │ -000476a0: 6465 7175 6174 652e 0a0a 422e 322e 352e  dequate...B.2.5.
│ │ │ │ -000476b0: 3120 5465 6c6e 6574 2045 6e63 7279 7074  1 Telnet Encrypt
│ │ │ │ -000476c0: 696f 6e20 5072 6f74 6f63 6f6c 2053 6563  ion Protocol Sec
│ │ │ │ -000476d0: 7572 6974 7920 436f 6e73 6964 6572 6174  urity Considerat
│ │ │ │ -000476e0: 696f 6e73 0a2e 2e2e 2e2e 2e2e 2e2e 2e2e  ions............
│ │ │ │ +00047500: 2d2d 2d2d 2d2d 2d2d 2d0a 0a54 6865 2070  ---------..The p
│ │ │ │ +00047510: 726f 746f 636f 6c20 6d75 7374 2062 6520  rotocol must be 
│ │ │ │ +00047520: 7072 6f70 6572 6c79 2061 6e64 2073 6563  properly and sec
│ │ │ │ +00047530: 7572 656c 7920 696d 706c 656d 656e 7465  urely implemente
│ │ │ │ +00047540: 642e 2020 466f 7220 6578 616d 706c 652c  d.  For example,
│ │ │ │ +00047550: 2061 6e0a 696d 706c 656d 656e 7461 7469   an.implementati
│ │ │ │ +00047560: 6f6e 2073 686f 756c 6420 6e6f 7420 6265  on should not be
│ │ │ │ +00047570: 2076 756c 6e65 7261 626c 6520 746f 2076   vulnerable to v
│ │ │ │ +00047580: 6172 696f 7573 0a69 6d70 6c65 6d65 6e74  arious.implement
│ │ │ │ +00047590: 6174 696f 6e2d 7370 6563 6966 6963 2061  ation-specific a
│ │ │ │ +000475a0: 7474 6163 6b73 2073 7563 6820 6173 2062  ttacks such as b
│ │ │ │ +000475b0: 7566 6665 7220 6f76 6572 666c 6f77 7320  uffer overflows 
│ │ │ │ +000475c0: 6f72 2073 6964 652d 6368 616e 6e65 6c0a  or side-channel.
│ │ │ │ +000475d0: 616e 616c 7973 6973 2e0a 0a20 2020 5765  analysis...   We
│ │ │ │ +000475e0: 2077 6973 6820 746f 2072 6570 6561 7420   wish to repeat 
│ │ │ │ +000475f0: 7468 6520 7375 6767 6573 7469 6f6e 2066  the suggestion f
│ │ │ │ +00047600: 726f 6d20 5246 4320 3239 3436 2c20 746f  rom RFC 2946, to
│ │ │ │ +00047610: 2069 6e76 6573 7469 6761 7465 2061 0a53   investigate a.S
│ │ │ │ +00047620: 5441 5254 544c 5320 6170 7072 6f61 6368  TARTTLS approach
│ │ │ │ +00047630: 2066 6f72 2054 656c 6e65 7420 656e 6372   for Telnet encr
│ │ │ │ +00047640: 7970 7469 6f6e 2028 616e 6420 616c 736f  yption (and also
│ │ │ │ +00047650: 2061 7574 6865 6e74 6963 6174 696f 6e29   authentication)
│ │ │ │ +00047660: 2c20 7768 656e 0a74 6865 2073 6563 7572  , when.the secur
│ │ │ │ +00047670: 6974 7920 6c65 7665 6c20 7072 6f76 6964  ity level provid
│ │ │ │ +00047680: 6564 2062 7920 7468 6973 2073 7065 6369  ed by this speci
│ │ │ │ +00047690: 6669 6361 7469 6f6e 2069 7320 6e6f 7420  fication is not 
│ │ │ │ +000476a0: 6164 6571 7561 7465 2e0a 0a42 2e32 2e35  adequate...B.2.5
│ │ │ │ +000476b0: 2e31 2054 656c 6e65 7420 456e 6372 7970  .1 Telnet Encryp
│ │ │ │ +000476c0: 7469 6f6e 2050 726f 746f 636f 6c20 5365  tion Protocol Se
│ │ │ │ +000476d0: 6375 7269 7479 2043 6f6e 7369 6465 7261  curity Considera
│ │ │ │ +000476e0: 7469 6f6e 730a 2e2e 2e2e 2e2e 2e2e 2e2e  tions...........
│ │ │ │  000476f0: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e  ................
│ │ │ │  00047700: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e  ................
│ │ │ │ -00047710: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e0a  ................
│ │ │ │ -00047720: 0a54 6865 2073 6563 7572 6974 7920 636f  .The security co
│ │ │ │ -00047730: 6e73 6964 6572 6174 696f 6e20 6f66 2074  nsideration of t
│ │ │ │ -00047740: 6865 2054 656c 6e65 7420 656e 6372 7970  he Telnet encryp
│ │ │ │ -00047750: 7469 6f6e 2070 726f 746f 636f 6c20 6172  tion protocol ar
│ │ │ │ -00047760: 650a 696e 6865 7269 7465 642e 0a0a 2020  e.inherited...  
│ │ │ │ -00047770: 2049 7420 7368 6f75 6c64 2062 6520 6e6f   It should be no
│ │ │ │ -00047780: 7465 6420 7468 6174 2069 7420 6973 2075  ted that it is u
│ │ │ │ -00047790: 7020 746f 2074 6865 2061 7574 6865 6e74  p to the authent
│ │ │ │ -000477a0: 6963 6174 696f 6e20 7072 6f74 6f63 6f6c  ication protocol
│ │ │ │ -000477b0: 2075 7365 642c 0a69 6620 616e 792c 2074   used,.if any, t
│ │ │ │ -000477c0: 6f20 6269 6e64 2074 6865 2061 7574 6865  o bind the authe
│ │ │ │ -000477d0: 6e74 6963 6974 7920 6f66 2074 6865 2070  nticity of the p
│ │ │ │ -000477e0: 6565 7273 2074 6f20 6120 7370 6563 6966  eers to a specif
│ │ │ │ -000477f0: 6963 2073 6573 7369 6f6e 2e0a 0a20 2020  ic session...   
│ │ │ │ -00047800: 5468 6520 5465 6c6e 6574 2065 6e63 7279  The Telnet encry
│ │ │ │ -00047810: 7074 696f 6e20 7072 6f74 6f63 6f6c 2064  ption protocol d
│ │ │ │ -00047820: 6f65 7320 6e6f 742c 2069 6e20 6765 6e65  oes not, in gene
│ │ │ │ -00047830: 7261 6c2c 2070 726f 7465 6374 2061 6761  ral, protect aga
│ │ │ │ -00047840: 696e 7374 0a70 6f73 7369 626c 7920 6d61  inst.possibly ma
│ │ │ │ -00047850: 6c69 6369 6f75 7320 646f 776e 6772 6164  licious downgrad
│ │ │ │ -00047860: 696e 6720 746f 2061 6e79 206d 7574 7561  ing to any mutua
│ │ │ │ -00047870: 6c6c 7920 6163 6365 7074 6162 6c65 2c20  lly acceptable, 
│ │ │ │ -00047880: 6275 7420 6e6f 740a 7072 6566 6572 7265  but not.preferre
│ │ │ │ -00047890: 642c 2065 6e63 7279 7074 696f 6e20 7479  d, encryption ty
│ │ │ │ -000478a0: 7065 2e20 2054 6869 7320 706c 6163 6573  pe.  This places
│ │ │ │ -000478b0: 2061 2072 6571 7569 7265 6d65 6e74 206f   a requirement o
│ │ │ │ -000478c0: 6e20 6561 6368 2070 6565 7220 746f 0a6f  n each peer to.o
│ │ │ │ -000478d0: 6e6c 7920 6163 6365 7074 2065 6e63 7279  nly accept encry
│ │ │ │ -000478e0: 7074 696f 6e20 7479 7065 7320 6974 2074  ption types it t
│ │ │ │ -000478f0: 7275 7374 2066 756c 6c79 2e20 2049 6e20  rust fully.  In 
│ │ │ │ -00047900: 6f74 6865 7220 776f 7264 732c 2074 6865  other words, the
│ │ │ │ -00047910: 2054 656c 6e65 740a 656e 6372 7970 7469   Telnet.encrypti
│ │ │ │ -00047920: 6f6e 2070 726f 746f 636f 6c20 646f 206e  on protocol do n
│ │ │ │ -00047930: 6f74 2067 7561 7261 6e74 6565 2074 6861  ot guarantee tha
│ │ │ │ -00047940: 7420 7468 6520 7374 726f 6e67 6573 7420  t the strongest 
│ │ │ │ -00047950: 6d75 7475 616c 6c79 0a61 6363 6570 7461  mutually.accepta
│ │ │ │ -00047960: 626c 6520 656e 6372 7970 7469 6f6e 2074  ble encryption t
│ │ │ │ -00047970: 7970 6520 6973 2061 6c77 6179 7320 7365  ype is always se
│ │ │ │ -00047980: 6c65 6374 6564 2e0a 0a42 2e32 2e35 2e32  lected...B.2.5.2
│ │ │ │ -00047990: 2041 4553 2d43 434d 2053 6563 7572 6974   AES-CCM Securit
│ │ │ │ -000479a0: 7920 436f 6e73 6964 6572 6174 696f 6e73  y Considerations
│ │ │ │ -000479b0: 0a2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e  ................
│ │ │ │ +00047710: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e  ................
│ │ │ │ +00047720: 0a0a 5468 6520 7365 6375 7269 7479 2063  ..The security c
│ │ │ │ +00047730: 6f6e 7369 6465 7261 7469 6f6e 206f 6620  onsideration of 
│ │ │ │ +00047740: 7468 6520 5465 6c6e 6574 2065 6e63 7279  the Telnet encry
│ │ │ │ +00047750: 7074 696f 6e20 7072 6f74 6f63 6f6c 2061  ption protocol a
│ │ │ │ +00047760: 7265 0a69 6e68 6572 6974 6564 2e0a 0a20  re.inherited... 
│ │ │ │ +00047770: 2020 4974 2073 686f 756c 6420 6265 206e    It should be n
│ │ │ │ +00047780: 6f74 6564 2074 6861 7420 6974 2069 7320  oted that it is 
│ │ │ │ +00047790: 7570 2074 6f20 7468 6520 6175 7468 656e  up to the authen
│ │ │ │ +000477a0: 7469 6361 7469 6f6e 2070 726f 746f 636f  tication protoco
│ │ │ │ +000477b0: 6c20 7573 6564 2c0a 6966 2061 6e79 2c20  l used,.if any, 
│ │ │ │ +000477c0: 746f 2062 696e 6420 7468 6520 6175 7468  to bind the auth
│ │ │ │ +000477d0: 656e 7469 6369 7479 206f 6620 7468 6520  enticity of the 
│ │ │ │ +000477e0: 7065 6572 7320 746f 2061 2073 7065 6369  peers to a speci
│ │ │ │ +000477f0: 6669 6320 7365 7373 696f 6e2e 0a0a 2020  fic session...  
│ │ │ │ +00047800: 2054 6865 2054 656c 6e65 7420 656e 6372   The Telnet encr
│ │ │ │ +00047810: 7970 7469 6f6e 2070 726f 746f 636f 6c20  yption protocol 
│ │ │ │ +00047820: 646f 6573 206e 6f74 2c20 696e 2067 656e  does not, in gen
│ │ │ │ +00047830: 6572 616c 2c20 7072 6f74 6563 7420 6167  eral, protect ag
│ │ │ │ +00047840: 6169 6e73 740a 706f 7373 6962 6c79 206d  ainst.possibly m
│ │ │ │ +00047850: 616c 6963 696f 7573 2064 6f77 6e67 7261  alicious downgra
│ │ │ │ +00047860: 6469 6e67 2074 6f20 616e 7920 6d75 7475  ding to any mutu
│ │ │ │ +00047870: 616c 6c79 2061 6363 6570 7461 626c 652c  ally acceptable,
│ │ │ │ +00047880: 2062 7574 206e 6f74 0a70 7265 6665 7272   but not.preferr
│ │ │ │ +00047890: 6564 2c20 656e 6372 7970 7469 6f6e 2074  ed, encryption t
│ │ │ │ +000478a0: 7970 652e 2020 5468 6973 2070 6c61 6365  ype.  This place
│ │ │ │ +000478b0: 7320 6120 7265 7175 6972 656d 656e 7420  s a requirement 
│ │ │ │ +000478c0: 6f6e 2065 6163 6820 7065 6572 2074 6f0a  on each peer to.
│ │ │ │ +000478d0: 6f6e 6c79 2061 6363 6570 7420 656e 6372  only accept encr
│ │ │ │ +000478e0: 7970 7469 6f6e 2074 7970 6573 2069 7420  yption types it 
│ │ │ │ +000478f0: 7472 7573 7420 6675 6c6c 792e 2020 496e  trust fully.  In
│ │ │ │ +00047900: 206f 7468 6572 2077 6f72 6473 2c20 7468   other words, th
│ │ │ │ +00047910: 6520 5465 6c6e 6574 0a65 6e63 7279 7074  e Telnet.encrypt
│ │ │ │ +00047920: 696f 6e20 7072 6f74 6f63 6f6c 2064 6f20  ion protocol do 
│ │ │ │ +00047930: 6e6f 7420 6775 6172 616e 7465 6520 7468  not guarantee th
│ │ │ │ +00047940: 6174 2074 6865 2073 7472 6f6e 6765 7374  at the strongest
│ │ │ │ +00047950: 206d 7574 7561 6c6c 790a 6163 6365 7074   mutually.accept
│ │ │ │ +00047960: 6162 6c65 2065 6e63 7279 7074 696f 6e20  able encryption 
│ │ │ │ +00047970: 7479 7065 2069 7320 616c 7761 7973 2073  type is always s
│ │ │ │ +00047980: 656c 6563 7465 642e 0a0a 422e 322e 352e  elected...B.2.5.
│ │ │ │ +00047990: 3220 4145 532d 4343 4d20 5365 6375 7269  2 AES-CCM Securi
│ │ │ │ +000479a0: 7479 2043 6f6e 7369 6465 7261 7469 6f6e  ty Consideration
│ │ │ │ +000479b0: 730a 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e  s...............
│ │ │ │  000479c0: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e  ................
│ │ │ │ -000479d0: 2e2e 2e2e 2e2e 2e2e 0a0a 5468 6520 696e  ..........The in
│ │ │ │ -000479e0: 7465 6772 6974 7920 616e 6420 7072 6976  tegrity and priv
│ │ │ │ -000479f0: 6163 7920 636c 6169 6d73 2061 7265 2069  acy claims are i
│ │ │ │ -00047a00: 6e68 6572 6974 6564 2066 726f 6d20 4145  nherited from AE
│ │ │ │ -00047a10: 532d 4343 4d2e 2049 6e0a 7061 7274 6963  S-CCM. In.partic
│ │ │ │ -00047a20: 756c 6172 2c20 7468 6520 696d 706c 656d  ular, the implem
│ │ │ │ -00047a30: 656e 7461 7469 6f6e 206d 7573 7420 6d61  entation must ma
│ │ │ │ -00047a40: 6b65 2073 7572 6520 6120 e280 986e 6f6e  ke sure a ...non
│ │ │ │ -00047a50: 6365 e280 9920 6973 206e 6f74 2075 7365  ce... is not use
│ │ │ │ -00047a60: 6420 6d6f 7265 0a74 6861 6e20 6f6e 6365  d more.than once
│ │ │ │ -00047a70: 2074 6f67 6574 6865 7220 7769 7468 2061   together with a
│ │ │ │ -00047a80: 2073 696e 676c 6520 6b65 792e 0a0a 2020   single key...  
│ │ │ │ -00047a90: 2046 7572 7468 6572 6d6f 7265 2c20 7468   Furthermore, th
│ │ │ │ -00047aa0: 6520 656e 6372 7970 7469 6f6e 206b 6579  e encryption key
│ │ │ │ -00047ab0: 2069 7320 6173 7375 6d65 6420 746f 2062   is assumed to b
│ │ │ │ -00047ac0: 6520 7261 6e64 6f6d 2c20 692e 652e 2c20  e random, i.e., 
│ │ │ │ -00047ad0: 6974 0a73 686f 756c 6420 6e6f 7420 6265  it.should not be
│ │ │ │ -00047ae0: 2070 6f73 7369 626c 6520 746f 2067 7565   possible to gue
│ │ │ │ -00047af0: 7373 2069 7420 7769 7468 2070 726f 6261  ss it with proba
│ │ │ │ -00047b00: 6269 6c69 7479 206f 6620 7375 6363 6573  bility of succes
│ │ │ │ -00047b10: 7320 6869 6768 6572 0a74 6861 6e20 6775  s higher.than gu
│ │ │ │ -00047b20: 6573 7369 6e67 2061 6e79 2075 6e69 666f  essing any unifo
│ │ │ │ -00047b30: 726d 6c79 2073 656c 6563 7465 6420 7261  rmly selected ra
│ │ │ │ -00047b40: 6e64 6f6d 206b 6579 2e20 2052 4643 2031  ndom key.  RFC 1
│ │ │ │ -00047b50: 3735 3020 6769 7665 7320 616e 0a6f 7665  750 gives an.ove
│ │ │ │ -00047b60: 7276 6965 7720 6f66 2069 7373 7565 7320  rview of issues 
│ │ │ │ -00047b70: 616e 6420 7265 636f 6d6d 656e 6461 7469  and recommendati
│ │ │ │ -00047b80: 6f6e 7320 7265 6c61 7465 6420 746f 2072  ons related to r
│ │ │ │ -00047b90: 616e 646f 6d6e 6573 732e 0a0a 422e 322e  andomness...B.2.
│ │ │ │ -00047ba0: 3620 4163 6b6e 6f77 6c65 6467 6d65 6e74  6 Acknowledgment
│ │ │ │ -00047bb0: 730a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  s.--------------
│ │ │ │ -00047bc0: 2d2d 2d2d 2d2d 2d0a 0a54 6869 7320 646f  -------..This do
│ │ │ │ -00047bd0: 6375 6d65 6e74 2069 7320 6261 7365 6420  cument is based 
│ │ │ │ -00047be0: 6f6e 2074 6865 2076 6172 696f 7573 2054  on the various T
│ │ │ │ -00047bf0: 656c 6e65 7420 456e 6372 7970 7469 6f6e  elnet Encryption
│ │ │ │ -00047c00: 2052 4643 7320 2852 4643 2032 3934 362c   RFCs (RFC 2946,
│ │ │ │ -00047c10: 0a52 4643 2032 3934 372c 2052 4643 2032  .RFC 2947, RFC 2
│ │ │ │ -00047c20: 3934 382c 2052 4643 2032 3935 3220 616e  948, RFC 2952 an
│ │ │ │ -00047c30: 6420 5246 4320 3239 3533 292e 0a0a 1f0a  d RFC 2953).....
│ │ │ │ -00047c40: 4669 6c65 3a20 7368 6973 6869 2e69 6e66  File: shishi.inf
│ │ │ │ -00047c50: 6f2c 2020 4e6f 6465 3a20 4b65 7262 6572  o,  Node: Kerber
│ │ │ │ -00047c60: 697a 6564 2072 7368 2061 6e64 2072 6c6f  ized rsh and rlo
│ │ │ │ -00047c70: 6769 6e2c 2020 4e65 7874 3a20 4b65 7920  gin,  Next: Key 
│ │ │ │ -00047c80: 6173 2069 6e69 7469 616c 697a 6174 696f  as initializatio
│ │ │ │ -00047c90: 6e20 7665 6374 6f72 2c20 2050 7265 763a  n vector,  Prev:
│ │ │ │ -00047ca0: 2054 656c 6e65 7420 656e 6372 7970 7469   Telnet encrypti
│ │ │ │ -00047cb0: 6f6e 2077 6974 6820 4145 532d 4343 4d2c  on with AES-CCM,
│ │ │ │ -00047cc0: 2020 5570 3a20 5072 6f74 6f63 6f6c 2045    Up: Protocol E
│ │ │ │ -00047cd0: 7874 656e 7369 6f6e 730a 0a42 2e33 204b  xtensions..B.3 K
│ │ │ │ -00047ce0: 6572 6265 7269 7a65 6420 7273 6820 616e  erberized rsh an
│ │ │ │ -00047cf0: 6420 726c 6f67 696e 0a3d 3d3d 3d3d 3d3d  d rlogin.=======
│ │ │ │ +000479d0: 2e2e 2e2e 2e2e 2e2e 2e0a 0a54 6865 2069  ...........The i
│ │ │ │ +000479e0: 6e74 6567 7269 7479 2061 6e64 2070 7269  ntegrity and pri
│ │ │ │ +000479f0: 7661 6379 2063 6c61 696d 7320 6172 6520  vacy claims are 
│ │ │ │ +00047a00: 696e 6865 7269 7465 6420 6672 6f6d 2041  inherited from A
│ │ │ │ +00047a10: 4553 2d43 434d 2e20 496e 0a70 6172 7469  ES-CCM. In.parti
│ │ │ │ +00047a20: 6375 6c61 722c 2074 6865 2069 6d70 6c65  cular, the imple
│ │ │ │ +00047a30: 6d65 6e74 6174 696f 6e20 6d75 7374 206d  mentation must m
│ │ │ │ +00047a40: 616b 6520 7375 7265 2061 20e2 8098 6e6f  ake sure a ...no
│ │ │ │ +00047a50: 6e63 65e2 8099 2069 7320 6e6f 7420 7573  nce... is not us
│ │ │ │ +00047a60: 6564 206d 6f72 650a 7468 616e 206f 6e63  ed more.than onc
│ │ │ │ +00047a70: 6520 746f 6765 7468 6572 2077 6974 6820  e together with 
│ │ │ │ +00047a80: 6120 7369 6e67 6c65 206b 6579 2e0a 0a20  a single key... 
│ │ │ │ +00047a90: 2020 4675 7274 6865 726d 6f72 652c 2074    Furthermore, t
│ │ │ │ +00047aa0: 6865 2065 6e63 7279 7074 696f 6e20 6b65  he encryption ke
│ │ │ │ +00047ab0: 7920 6973 2061 7373 756d 6564 2074 6f20  y is assumed to 
│ │ │ │ +00047ac0: 6265 2072 616e 646f 6d2c 2069 2e65 2e2c  be random, i.e.,
│ │ │ │ +00047ad0: 2069 740a 7368 6f75 6c64 206e 6f74 2062   it.should not b
│ │ │ │ +00047ae0: 6520 706f 7373 6962 6c65 2074 6f20 6775  e possible to gu
│ │ │ │ +00047af0: 6573 7320 6974 2077 6974 6820 7072 6f62  ess it with prob
│ │ │ │ +00047b00: 6162 696c 6974 7920 6f66 2073 7563 6365  ability of succe
│ │ │ │ +00047b10: 7373 2068 6967 6865 720a 7468 616e 2067  ss higher.than g
│ │ │ │ +00047b20: 7565 7373 696e 6720 616e 7920 756e 6966  uessing any unif
│ │ │ │ +00047b30: 6f72 6d6c 7920 7365 6c65 6374 6564 2072  ormly selected r
│ │ │ │ +00047b40: 616e 646f 6d20 6b65 792e 2020 5246 4320  andom key.  RFC 
│ │ │ │ +00047b50: 3137 3530 2067 6976 6573 2061 6e0a 6f76  1750 gives an.ov
│ │ │ │ +00047b60: 6572 7669 6577 206f 6620 6973 7375 6573  erview of issues
│ │ │ │ +00047b70: 2061 6e64 2072 6563 6f6d 6d65 6e64 6174   and recommendat
│ │ │ │ +00047b80: 696f 6e73 2072 656c 6174 6564 2074 6f20  ions related to 
│ │ │ │ +00047b90: 7261 6e64 6f6d 6e65 7373 2e0a 0a42 2e32  randomness...B.2
│ │ │ │ +00047ba0: 2e36 2041 636b 6e6f 776c 6564 676d 656e  .6 Acknowledgmen
│ │ │ │ +00047bb0: 7473 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ts.-------------
│ │ │ │ +00047bc0: 2d2d 2d2d 2d2d 2d2d 0a0a 5468 6973 2064  --------..This d
│ │ │ │ +00047bd0: 6f63 756d 656e 7420 6973 2062 6173 6564  ocument is based
│ │ │ │ +00047be0: 206f 6e20 7468 6520 7661 7269 6f75 7320   on the various 
│ │ │ │ +00047bf0: 5465 6c6e 6574 2045 6e63 7279 7074 696f  Telnet Encryptio
│ │ │ │ +00047c00: 6e20 5246 4373 2028 5246 4320 3239 3436  n RFCs (RFC 2946
│ │ │ │ +00047c10: 2c0a 5246 4320 3239 3437 2c20 5246 4320  ,.RFC 2947, RFC 
│ │ │ │ +00047c20: 3239 3438 2c20 5246 4320 3239 3532 2061  2948, RFC 2952 a
│ │ │ │ +00047c30: 6e64 2052 4643 2032 3935 3329 2e0a 0a1f  nd RFC 2953)....
│ │ │ │ +00047c40: 0a46 696c 653a 2073 6869 7368 692e 696e  .File: shishi.in
│ │ │ │ +00047c50: 666f 2c20 204e 6f64 653a 204b 6572 6265  fo,  Node: Kerbe
│ │ │ │ +00047c60: 7269 7a65 6420 7273 6820 616e 6420 726c  rized rsh and rl
│ │ │ │ +00047c70: 6f67 696e 2c20 204e 6578 743a 204b 6579  ogin,  Next: Key
│ │ │ │ +00047c80: 2061 7320 696e 6974 6961 6c69 7a61 7469   as initializati
│ │ │ │ +00047c90: 6f6e 2076 6563 746f 722c 2020 5072 6576  on vector,  Prev
│ │ │ │ +00047ca0: 3a20 5465 6c6e 6574 2065 6e63 7279 7074  : Telnet encrypt
│ │ │ │ +00047cb0: 696f 6e20 7769 7468 2041 4553 2d43 434d  ion with AES-CCM
│ │ │ │ +00047cc0: 2c20 2055 703a 2050 726f 746f 636f 6c20  ,  Up: Protocol 
│ │ │ │ +00047cd0: 4578 7465 6e73 696f 6e73 0a0a 422e 3320  Extensions..B.3 
│ │ │ │ +00047ce0: 4b65 7262 6572 697a 6564 2072 7368 2061  Kerberized rsh a
│ │ │ │ +00047cf0: 6e64 2072 6c6f 6769 6e0a 3d3d 3d3d 3d3d  nd rlogin.======
│ │ │ │  00047d00: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ -00047d10: 3d3d 3d3d 3d3d 0a0a 5468 6973 2061 7070  ======..This app
│ │ │ │ -00047d20: 656e 6469 7820 6465 7363 7269 6265 7320  endix describes 
│ │ │ │ -00047d30: 7468 6520 4b43 4d44 5630 2e32 2070 726f  the KCMDV0.2 pro
│ │ │ │ -00047d40: 746f 636f 6c20 7573 6564 2069 6e20 7665  tocol used in ve
│ │ │ │ -00047d50: 7273 696f 6e73 206f 660a 696e 6574 7574  rsions of.inetut
│ │ │ │ -00047d60: 696c 7320 7061 7463 6865 6420 666f 7220  ils patched for 
│ │ │ │ -00047d70: 7368 6973 6869 2e20 2054 6865 204b 434d  shishi.  The KCM
│ │ │ │ -00047d80: 4420 7072 6f74 6f63 6f6c 2077 6173 2064  D protocol was d
│ │ │ │ -00047d90: 6576 656c 6f70 6564 2062 7920 7468 650a  eveloped by the.
│ │ │ │ -00047da0: 4d49 5420 4b65 7262 6572 6f73 2074 6561  MIT Kerberos tea
│ │ │ │ -00047db0: 6d20 666f 7220 7468 6520 6b65 7262 6572  m for the kerber
│ │ │ │ -00047dc0: 697a 6564 20e2 8098 7273 68e2 8099 2061  ized ...rsh... a
│ │ │ │ -00047dd0: 6e64 20e2 8098 726c 6f67 696e e280 9920  nd ...rlogin... 
│ │ │ │ -00047de0: 7072 6f67 7261 6d73 2e20 2054 6865 0a64  programs.  The.d
│ │ │ │ -00047df0: 6966 6665 7265 6e63 6573 2062 6574 7765  ifferences betwe
│ │ │ │ -00047e00: 656e 20e2 8098 726c 6f67 696e e280 9920  en ...rlogin... 
│ │ │ │ -00047e10: 616e 6420 e280 9872 7368 e280 9920 6172  and ...rsh... ar
│ │ │ │ -00047e20: 6520 6578 706c 6169 6e65 6420 6265 6c6f  e explained belo
│ │ │ │ -00047e30: 772c 2061 7320 6172 650a 6469 6666 6572  w, as are.differ
│ │ │ │ -00047e40: 656e 6365 7320 6265 7477 6565 6e20 7072  ences between pr
│ │ │ │ -00047e50: 6f74 6f63 6f6c 2076 6572 7369 6f6e 7320  otocol versions 
│ │ │ │ -00047e60: 7630 2e31 2061 6e64 2076 302e 322e 2020  v0.1 and v0.2.  
│ │ │ │ -00047e70: 426f 7468 2072 656d 6169 6e20 696e 2075  Both remain in u
│ │ │ │ -00047e80: 7365 0a72 6573 6f6e 7320 6f66 2063 6f6d  se.resons of com
│ │ │ │ -00047e90: 7061 7469 6269 6c69 7479 2e0a 0a20 2020  patibility...   
│ │ │ │ -00047ea0: 4974 2069 7320 706f 7373 6962 6c65 2074  It is possible t
│ │ │ │ -00047eb0: 6861 7420 736f 6d65 2070 6172 7473 206f  hat some parts o
│ │ │ │ -00047ec0: 6620 7468 6973 2064 6f63 756d 656e 7420  f this document 
│ │ │ │ -00047ed0: 6172 6520 6e6f 7420 696e 2063 6f6e 666f  are not in confo
│ │ │ │ -00047ee0: 726d 6974 790a 7769 7468 2074 6865 206f  rmity.with the o
│ │ │ │ -00047ef0: 7269 6769 6e61 6c20 4b43 4d44 2070 726f  riginal KCMD pro
│ │ │ │ -00047f00: 746f 636f 6c2c 2062 6563 6175 7365 2074  tocol, because t
│ │ │ │ -00047f10: 6865 7265 2069 7320 6e6f 206f 6666 6963  here is no offic
│ │ │ │ -00047f20: 6961 6c0a 7370 6563 6966 6963 6174 696f  ial.specificatio
│ │ │ │ -00047f30: 6e20 6f66 2069 742e 2020 486f 7765 7665  n of it.  Howeve
│ │ │ │ -00047f40: 722c 2069 7420 7365 656d 7320 7468 6174  r, it seems that
│ │ │ │ -00047f50: 2073 6869 7368 6927 7320 696d 706c 656d   shishi's implem
│ │ │ │ -00047f60: 656e 7461 7469 6f6e 2069 730a 636f 6d70  entation is.comp
│ │ │ │ -00047f70: 6174 6962 6c65 2077 6974 6820 4d49 5427  atible with MIT'
│ │ │ │ -00047f80: 7320 7072 6f74 6f63 6f6c 2e0a 0a20 2020  s protocol...   
│ │ │ │ -00047f90: 2a57 6172 6e69 6e67 3a2a 2049 6620 796f  *Warning:* If yo
│ │ │ │ -00047fa0: 7520 6172 6520 7365 7269 6f75 736c 7920  u are seriously 
│ │ │ │ -00047fb0: 636f 6e73 6964 6572 696e 6720 7573 696e  considering usin
│ │ │ │ -00047fc0: 6720 4b65 7262 6572 697a 6564 20e2 8098  g Kerberized ...
│ │ │ │ -00047fd0: 7273 68e2 8099 206f 720a e280 9872 6c6f  rsh... or....rlo
│ │ │ │ -00047fe0: 6769 6ee2 8099 2c20 696e 7374 6561 6420  gin..., instead 
│ │ │ │ -00047ff0: 6f66 206d 6f72 6520 726f 6275 7374 2072  of more robust r
│ │ │ │ -00048000: 656d 6f74 6520 6163 6365 7373 2070 726f  emote access pro
│ │ │ │ -00048010: 746f 636f 6c73 2c20 7375 6368 2061 7320  tocols, such as 
│ │ │ │ -00048020: 5f53 5348 5f2c 0a79 6f75 206d 6179 2066  _SSH_,.you may f
│ │ │ │ -00048030: 6972 7374 2077 616e 7420 746f 2065 7870  irst want to exp
│ │ │ │ -00048040: 6c6f 7265 0a3c 6874 7470 3a2f 2f77 7777  lore.<http://www
│ │ │ │ -00048050: 2e63 732e 6265 726b 656c 6579 2e65 6475  .cs.berkeley.edu
│ │ │ │ -00048060: 2f7e 6869 6c64 7275 6d2f 6b65 7262 6572  /~hildrum/kerber
│ │ │ │ -00048070: 6f73 2f3e 206f 7220 7468 6520 6675 6c6c  os/> or the full
│ │ │ │ -00048080: 2070 6170 6572 2061 740a 3c68 7474 703a   paper at.<http:
│ │ │ │ -00048090: 2f2f 7777 772e 6373 2e62 6572 6b65 6c65  //www.cs.berkele
│ │ │ │ -000480a0: 792e 6564 752f 7e68 696c 6472 756d 2f30  y.edu/~hildrum/0
│ │ │ │ -000480b0: 3433 2e70 6466 3e2e 0a0a 422e 332e 3120  43.pdf>...B.3.1 
│ │ │ │ -000480c0: 4573 7461 626c 6973 6820 636f 6e6e 6563  Establish connec
│ │ │ │ -000480d0: 7469 6f6e 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d  tion.-----------
│ │ │ │ -000480e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -000480f0: 0a49 6e69 7469 616c 6c79 2074 6865 2063  .Initially the c
│ │ │ │ -00048100: 6c69 656e 7420 6573 7461 626c 6973 6873  lient establishs
│ │ │ │ -00048110: 2061 2054 4350 2063 6f6e 6e65 6374 696f   a TCP connectio
│ │ │ │ -00048120: 6e20 746f 2074 6865 2073 6572 7665 722e  n to the server.
│ │ │ │ -00048130: 2020 4465 6661 756c 740a 706f 7274 7320    Default.ports 
│ │ │ │ -00048140: 6172 6520 3534 3320 28e2 8098 6b6c 6f67  are 543 (...klog
│ │ │ │ -00048150: 696e e280 9929 2c20 3534 3420 28e2 8098  in...), 544 (...
│ │ │ │ -00048160: 6b73 6865 6c6c e280 9929 2c20 616e 6420  kshell...), and 
│ │ │ │ -00048170: 3231 3035 2028 e280 9865 6b6c 6f67 696e  2105 (...eklogin
│ │ │ │ -00048180: e280 9929 2e20 2048 6572 650a e280 9865  ...).  Here....e
│ │ │ │ -00048190: 6b6c 6f67 696e e280 9920 6973 2074 6865  klogin... is the
│ │ │ │ -000481a0: 2073 616d 6520 6173 20e2 8098 6b6c 6f67   same as ...klog
│ │ │ │ -000481b0: 696e e280 992c 2062 7574 2077 6974 6820  in..., but with 
│ │ │ │ -000481c0: 656e 6372 7970 7469 6f6e 2e20 2054 6865  encryption.  The
│ │ │ │ -000481d0: 7265 2069 7320 6e6f 0a6c 6f6e 6765 7220  re is no.longer 
│ │ │ │ -000481e0: 6120 7365 7061 7261 7465 20e2 8098 656b  a separate ...ek
│ │ │ │ -000481f0: 7368 656c 6ce2 8099 2070 6f72 742c 2062  shell... port, b
│ │ │ │ -00048200: 6563 6175 7365 2065 6e63 7279 7074 6564  ecause encrypted
│ │ │ │ -00048210: 2061 6e64 206e 6f72 6d61 6c0a 636f 6e6e   and normal.conn
│ │ │ │ -00048220: 6563 7469 6f6e 206e 6f77 2075 7365 2074  ection now use t
│ │ │ │ -00048230: 6865 2073 616d 6520 706f 7274 20e2 8098  he same port ...
│ │ │ │ -00048240: 6b73 6865 6c6c e280 992e 0a0a 2020 204e  kshell......   N
│ │ │ │ -00048250: 6f72 6d61 6c6c 7920 e280 986b 7368 656c  ormally ...kshel
│ │ │ │ -00048260: 6ce2 8099 206e 6565 6473 2061 2073 6563  l... needs a sec
│ │ │ │ -00048270: 6f6e 6420 636f 6e6e 6563 7469 6f6e 2066  ond connection f
│ │ │ │ -00048280: 6f72 20e2 8098 7374 6465 7272 e280 992e  or ...stderr....
│ │ │ │ -00048290: 2020 5468 6520 636c 6965 6e74 0a73 686f    The client.sho
│ │ │ │ -000482a0: 756c 6420 7365 6e64 2061 206e 756c 6c20  uld send a null 
│ │ │ │ -000482b0: 7465 726d 696e 6174 6564 2073 7472 696e  terminated strin
│ │ │ │ -000482c0: 6720 636f 6e74 6169 6e69 6e67 2061 6e20  g containing an 
│ │ │ │ -000482d0: 6173 6369 6920 656e 636f 6469 6e67 206f  ascii encoding o
│ │ │ │ -000482e0: 6620 7468 650a 706f 7274 206e 756d 6265  f the.port numbe
│ │ │ │ -000482f0: 7220 746f 2062 6520 7573 6564 2066 6f72  r to be used for
│ │ │ │ -00048300: 2074 6869 7320 7365 636f 6e64 2063 6f6e   this second con
│ │ │ │ -00048310: 6e65 6374 696f 6e2e 2020 5369 6e63 6520  nection.  Since 
│ │ │ │ -00048320: e280 986b 6c6f 6769 6ee2 8099 2061 6e64  ...klogin... and
│ │ │ │ -00048330: 0ae2 8098 656b 6c6f 6769 6ee2 8099 2064  ....eklogin... d
│ │ │ │ -00048340: 6f20 6e6f 7420 7573 6520 6120 7365 636f  o not use a seco
│ │ │ │ -00048350: 6e64 2063 6f6e 6e65 6374 696f 6e20 666f  nd connection fo
│ │ │ │ -00048360: 7220 e280 9873 7464 6572 72e2 8099 2c20  r ...stderr..., 
│ │ │ │ -00048370: 7468 6520 636c 6965 6e74 206a 7573 740a  the client just.
│ │ │ │ -00048380: 7365 6e64 7320 616e 2061 6464 6974 696f  sends an additio
│ │ │ │ -00048390: 6e61 6c20 6e75 6c6c 2062 7974 6520 746f  nal null byte to
│ │ │ │ -000483a0: 2074 6865 2073 6572 7665 722c 2077 6869   the server, whi
│ │ │ │ -000483b0: 6368 2063 616e 2062 6520 7468 6f75 6768  ch can be though
│ │ │ │ -000483c0: 7420 6f66 2061 730a 616e 2065 6d70 7479  t of as.an empty
│ │ │ │ -000483d0: 2073 7472 696e 672e 2020 436f 6e74 7261   string.  Contra
│ │ │ │ -000483e0: 7279 2074 6f20 636c 6173 7369 6320 e280  ry to classic ..
│ │ │ │ -000483f0: 9872 7368 e280 9920 616e 6420 e280 9872  .rsh... and ...r
│ │ │ │ -00048400: 6c6f 6769 6ee2 8099 2c20 7468 6520 7365  login..., the se
│ │ │ │ -00048410: 7276 6572 0a6e 6565 6420 6e6f 7420 6368  rver.need not ch
│ │ │ │ -00048420: 6563 6b20 6966 2074 6865 2063 6c69 656e  eck if the clien
│ │ │ │ -00048430: 7427 7320 706f 7274 206c 6965 7320 696e  t's port lies in
│ │ │ │ -00048440: 2074 6865 2072 616e 6765 2030 2d31 3032   the range 0-102
│ │ │ │ -00048450: 332e 0a0a 422e 332e 3220 4b65 7262 6572  3...B.3.2 Kerber
│ │ │ │ -00048460: 6f73 2069 6465 6e74 6966 6963 6174 696f  os identificatio
│ │ │ │ -00048470: 6e0a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  n.--------------
│ │ │ │ -00048480: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a  ---------------.
│ │ │ │ -00048490: 0a57 6865 6e20 6120 636f 6e6e 6563 7469  .When a connecti
│ │ │ │ -000484a0: 6f6e 2069 7320 6265 696e 6720 6573 7461  on is being esta
│ │ │ │ -000484b0: 626c 6973 6865 642c 2074 6865 2066 6972  blished, the fir
│ │ │ │ -000484c0: 7374 2074 6869 6e67 2074 6f20 646f 2069  st thing to do i
│ │ │ │ -000484d0: 7320 746f 0a69 6e64 6963 6174 6520 7468  s to.indicate th
│ │ │ │ -000484e0: 6174 204b 6572 6265 726f 7320 6175 7468  at Kerberos auth
│ │ │ │ -000484f0: 656e 7469 6361 7469 6f6e 2069 7320 6465  entication is de
│ │ │ │ -00048500: 7369 7265 642e 2020 5468 6520 636c 6965  sired.  The clie
│ │ │ │ -00048510: 6e74 2077 696c 6c20 7365 6e64 0a61 2073  nt will send.a s
│ │ │ │ -00048520: 7472 696e 6720 746f 2069 6e64 6963 6174  tring to indicat
│ │ │ │ -00048530: 6520 6974 2077 696c 6c20 7573 6520 4b65  e it will use Ke
│ │ │ │ -00048540: 7262 6572 6f73 2035 2e20 204c 6574 2075  rberos 5.  Let u
│ │ │ │ -00048550: 7320 7361 7920 226c 656e 6774 682d 7374  s say "length-st
│ │ │ │ -00048560: 7269 6e67 220a 6f66 2053 5452 4c2c 2061  ring".of STRL, a
│ │ │ │ -00048570: 6e64 206d 6561 6e20 7468 6520 636f 7570  nd mean the coup
│ │ │ │ -00048580: 6c65 0a0a 2020 286c 656e 6774 6820 6f66  le..  (length of
│ │ │ │ -00048590: 2074 6865 2073 7472 696e 6720 7374 726c   the string strl
│ │ │ │ -000485a0: 2c20 6e75 6c6c 2d74 6572 6d69 6e61 7465  , null-terminate
│ │ │ │ -000485b0: 6420 7374 7269 6e67 2073 7472 6c29 2e0a  d string strl)..
│ │ │ │ -000485c0: 0a77 6865 6e20 5354 524c 2069 7473 656c  .when STRL itsel
│ │ │ │ -000485d0: 6620 6973 2067 6976 656e 2e20 2054 6865  f is given.  The
│ │ │ │ -000485e0: 2073 7472 696e 6720 6c65 6e67 7468 2069   string length i
│ │ │ │ -000485f0: 7320 656e 636f 6465 6420 6173 2061 6e20  s encoded as an 
│ │ │ │ -00048600: e280 9869 6e74 3332 e280 990a 2833 322d  ...int32....(32-
│ │ │ │ -00048610: 6269 7420 696e 7465 6765 7229 2069 6e20  bit integer) in 
│ │ │ │ -00048620: 4d53 4220 6f72 6465 722c 2069 2e65 2e2c  MSB order, i.e.,
│ │ │ │ -00048630: 206e 6574 776f 726b 2062 7974 6520 6f72   network byte or
│ │ │ │ -00048640: 6465 722e 2020 536f 2074 6865 2063 6c69  der.  So the cli
│ │ │ │ -00048650: 656e 740a 6669 7273 7420 7365 6e64 7320  ent.first sends 
│ │ │ │ -00048660: 616e 2061 7574 6865 6e74 6963 6174 696f  an authenticatio
│ │ │ │ -00048670: 6e20 6d65 7373 6167 652c 2074 6865 206c  n message, the l
│ │ │ │ -00048680: 656e 6774 682d 7374 7269 6e67 206f 660a  ength-string of.
│ │ │ │ -00048690: 0a20 2020 4b52 4235 5f53 454e 4441 5554  .   KRB5_SENDAUT
│ │ │ │ -000486a0: 485f 5631 2e30 0a0a 4166 7465 7220 7468  H_V1.0..After th
│ │ │ │ -000486b0: 6174 2c20 7468 6520 636c 6965 6e74 206d  at, the client m
│ │ │ │ -000486c0: 7573 7420 7465 6c6c 2077 6869 6368 2076  ust tell which v
│ │ │ │ -000486d0: 6572 7369 6f6e 206f 6620 7468 6520 7072  ersion of the pr
│ │ │ │ -000486e0: 6f74 6f63 6f6c 2069 7420 7573 6573 0a62  otocol it uses.b
│ │ │ │ -000486f0: 7920 7365 6e64 696e 6720 6120 7665 7273  y sending a vers
│ │ │ │ -00048700: 696f 6e20 6d65 7373 6167 652c 2063 6f6e  ion message, con
│ │ │ │ -00048710: 7369 7374 696e 6720 6f66 2061 2073 6563  sisting of a sec
│ │ │ │ -00048720: 6f6e 6420 6c65 6e67 7468 2d73 7472 696e  ond length-strin
│ │ │ │ -00048730: 672e 0a54 6869 7320 7469 6d65 2062 6173  g..This time bas
│ │ │ │ -00048740: 6564 206f 6e0a 0a20 2020 4b43 4d44 5630  ed on..   KCMDV0
│ │ │ │ -00048750: 2e32 0a0a 6f72 206f 6e20 224b 434d 4456  .2..or on "KCMDV
│ │ │ │ -00048760: 302e 3122 2c20 666f 7220 7468 6520 6f6c  0.1", for the ol
│ │ │ │ -00048770: 6465 7220 7665 7273 696f 6e2e 0a0a 2020  der version...  
│ │ │ │ -00048780: 2049 6620 7468 6520 636c 6965 6e74 2773   If the client's
│ │ │ │ -00048790: 2069 6e64 656e 7469 6669 6361 7469 6f6e   indentification
│ │ │ │ -000487a0: 2069 7320 6163 6365 7074 6162 6c65 2c20   is acceptable, 
│ │ │ │ -000487b0: 7468 6520 7365 7276 6572 2077 696c 6c0a  the server will.
│ │ │ │ -000487c0: 7265 7370 6f6e 6420 7769 7468 2061 206e  respond with a n
│ │ │ │ -000487d0: 756c 6c20 6279 7465 2028 e280 9830 7830  ull byte (...0x0
│ │ │ │ -000487e0: 30e2 8099 292e 2020 4f74 6865 7277 6973  0...).  Otherwis
│ │ │ │ -000487f0: 652c 2069 6620 7468 6520 6175 7468 656e  e, if the authen
│ │ │ │ -00048800: 7469 6361 7469 6f6e 0a6d 6573 7361 6765  tication.message
│ │ │ │ -00048810: 2077 6173 2069 6e63 6f72 7265 6374 2c20   was incorrect, 
│ │ │ │ -00048820: 7468 656e 2074 6865 2073 6572 7665 7220  then the server 
│ │ │ │ -00048830: 7265 7370 6f6e 6473 2077 6974 6820 7468  responds with th
│ │ │ │ -00048840: 6520 7369 6e67 6c65 2062 7974 650a e280  e single byte...
│ │ │ │ -00048850: 9830 7830 31e2 8099 2c20 7768 696c 6520  .0x01..., while 
│ │ │ │ -00048860: 6966 2074 6865 2070 726f 746f 636f 6c20  if the protocol 
│ │ │ │ -00048870: 7665 7273 696f 6e20 6d65 7373 6167 6520  version message 
│ │ │ │ -00048880: 7761 7320 756e 6163 6365 7074 6162 6c65  was unacceptable
│ │ │ │ -00048890: 2c20 7468 656e 2074 6865 0a72 6573 706f  , then the.respo
│ │ │ │ -000488a0: 6e73 6520 6973 2061 2073 696e 676c 6520  nse is a single 
│ │ │ │ -000488b0: e280 9830 7830 32e2 8099 2e0a 0a42 2e33  ...0x02......B.3
│ │ │ │ -000488c0: 2e33 204b 6572 6265 726f 7320 6175 7468  .3 Kerberos auth
│ │ │ │ -000488d0: 656e 7469 6361 7469 6f6e 0a2d 2d2d 2d2d  entication.-----
│ │ │ │ +00047d10: 3d3d 3d3d 3d3d 3d0a 0a54 6869 7320 6170  =======..This ap
│ │ │ │ +00047d20: 7065 6e64 6978 2064 6573 6372 6962 6573  pendix describes
│ │ │ │ +00047d30: 2074 6865 204b 434d 4456 302e 3220 7072   the KCMDV0.2 pr
│ │ │ │ +00047d40: 6f74 6f63 6f6c 2075 7365 6420 696e 2076  otocol used in v
│ │ │ │ +00047d50: 6572 7369 6f6e 7320 6f66 0a69 6e65 7475  ersions of.inetu
│ │ │ │ +00047d60: 7469 6c73 2070 6174 6368 6564 2066 6f72  tils patched for
│ │ │ │ +00047d70: 2073 6869 7368 692e 2020 5468 6520 4b43   shishi.  The KC
│ │ │ │ +00047d80: 4d44 2070 726f 746f 636f 6c20 7761 7320  MD protocol was 
│ │ │ │ +00047d90: 6465 7665 6c6f 7065 6420 6279 2074 6865  developed by the
│ │ │ │ +00047da0: 0a4d 4954 204b 6572 6265 726f 7320 7465  .MIT Kerberos te
│ │ │ │ +00047db0: 616d 2066 6f72 2074 6865 206b 6572 6265  am for the kerbe
│ │ │ │ +00047dc0: 7269 7a65 6420 e280 9872 7368 e280 9920  rized ...rsh... 
│ │ │ │ +00047dd0: 616e 6420 e280 9872 6c6f 6769 6ee2 8099  and ...rlogin...
│ │ │ │ +00047de0: 2070 726f 6772 616d 732e 2020 5468 650a   programs.  The.
│ │ │ │ +00047df0: 6469 6666 6572 656e 6365 7320 6265 7477  differences betw
│ │ │ │ +00047e00: 6565 6e20 e280 9872 6c6f 6769 6ee2 8099  een ...rlogin...
│ │ │ │ +00047e10: 2061 6e64 20e2 8098 7273 68e2 8099 2061   and ...rsh... a
│ │ │ │ +00047e20: 7265 2065 7870 6c61 696e 6564 2062 656c  re explained bel
│ │ │ │ +00047e30: 6f77 2c20 6173 2061 7265 0a64 6966 6665  ow, as are.diffe
│ │ │ │ +00047e40: 7265 6e63 6573 2062 6574 7765 656e 2070  rences between p
│ │ │ │ +00047e50: 726f 746f 636f 6c20 7665 7273 696f 6e73  rotocol versions
│ │ │ │ +00047e60: 2076 302e 3120 616e 6420 7630 2e32 2e20   v0.1 and v0.2. 
│ │ │ │ +00047e70: 2042 6f74 6820 7265 6d61 696e 2069 6e20   Both remain in 
│ │ │ │ +00047e80: 7573 650a 7265 736f 6e73 206f 6620 636f  use.resons of co
│ │ │ │ +00047e90: 6d70 6174 6962 696c 6974 792e 0a0a 2020  mpatibility...  
│ │ │ │ +00047ea0: 2049 7420 6973 2070 6f73 7369 626c 6520   It is possible 
│ │ │ │ +00047eb0: 7468 6174 2073 6f6d 6520 7061 7274 7320  that some parts 
│ │ │ │ +00047ec0: 6f66 2074 6869 7320 646f 6375 6d65 6e74  of this document
│ │ │ │ +00047ed0: 2061 7265 206e 6f74 2069 6e20 636f 6e66   are not in conf
│ │ │ │ +00047ee0: 6f72 6d69 7479 0a77 6974 6820 7468 6520  ormity.with the 
│ │ │ │ +00047ef0: 6f72 6967 696e 616c 204b 434d 4420 7072  original KCMD pr
│ │ │ │ +00047f00: 6f74 6f63 6f6c 2c20 6265 6361 7573 6520  otocol, because 
│ │ │ │ +00047f10: 7468 6572 6520 6973 206e 6f20 6f66 6669  there is no offi
│ │ │ │ +00047f20: 6369 616c 0a73 7065 6369 6669 6361 7469  cial.specificati
│ │ │ │ +00047f30: 6f6e 206f 6620 6974 2e20 2048 6f77 6576  on of it.  Howev
│ │ │ │ +00047f40: 6572 2c20 6974 2073 6565 6d73 2074 6861  er, it seems tha
│ │ │ │ +00047f50: 7420 7368 6973 6869 2773 2069 6d70 6c65  t shishi's imple
│ │ │ │ +00047f60: 6d65 6e74 6174 696f 6e20 6973 0a63 6f6d  mentation is.com
│ │ │ │ +00047f70: 7061 7469 626c 6520 7769 7468 204d 4954  patible with MIT
│ │ │ │ +00047f80: 2773 2070 726f 746f 636f 6c2e 0a0a 2020  's protocol...  
│ │ │ │ +00047f90: 202a 5761 726e 696e 673a 2a20 4966 2079   *Warning:* If y
│ │ │ │ +00047fa0: 6f75 2061 7265 2073 6572 696f 7573 6c79  ou are seriously
│ │ │ │ +00047fb0: 2063 6f6e 7369 6465 7269 6e67 2075 7369   considering usi
│ │ │ │ +00047fc0: 6e67 204b 6572 6265 7269 7a65 6420 e280  ng Kerberized ..
│ │ │ │ +00047fd0: 9872 7368 e280 9920 6f72 0ae2 8098 726c  .rsh... or....rl
│ │ │ │ +00047fe0: 6f67 696e e280 992c 2069 6e73 7465 6164  ogin..., instead
│ │ │ │ +00047ff0: 206f 6620 6d6f 7265 2072 6f62 7573 7420   of more robust 
│ │ │ │ +00048000: 7265 6d6f 7465 2061 6363 6573 7320 7072  remote access pr
│ │ │ │ +00048010: 6f74 6f63 6f6c 732c 2073 7563 6820 6173  otocols, such as
│ │ │ │ +00048020: 205f 5353 485f 2c0a 796f 7520 6d61 7920   _SSH_,.you may 
│ │ │ │ +00048030: 6669 7273 7420 7761 6e74 2074 6f20 6578  first want to ex
│ │ │ │ +00048040: 706c 6f72 650a 3c68 7474 703a 2f2f 7777  plore.<http://ww
│ │ │ │ +00048050: 772e 6373 2e62 6572 6b65 6c65 792e 6564  w.cs.berkeley.ed
│ │ │ │ +00048060: 752f 7e68 696c 6472 756d 2f6b 6572 6265  u/~hildrum/kerbe
│ │ │ │ +00048070: 726f 732f 3e20 6f72 2074 6865 2066 756c  ros/> or the ful
│ │ │ │ +00048080: 6c20 7061 7065 7220 6174 0a3c 6874 7470  l paper at.<http
│ │ │ │ +00048090: 3a2f 2f77 7777 2e63 732e 6265 726b 656c  ://www.cs.berkel
│ │ │ │ +000480a0: 6579 2e65 6475 2f7e 6869 6c64 7275 6d2f  ey.edu/~hildrum/
│ │ │ │ +000480b0: 3034 332e 7064 663e 2e0a 0a42 2e33 2e31  043.pdf>...B.3.1
│ │ │ │ +000480c0: 2045 7374 6162 6c69 7368 2063 6f6e 6e65   Establish conne
│ │ │ │ +000480d0: 6374 696f 6e0a 2d2d 2d2d 2d2d 2d2d 2d2d  ction.----------
│ │ │ │ +000480e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +000480f0: 0a0a 496e 6974 6961 6c6c 7920 7468 6520  ..Initially the 
│ │ │ │ +00048100: 636c 6965 6e74 2065 7374 6162 6c69 7368  client establish
│ │ │ │ +00048110: 7320 6120 5443 5020 636f 6e6e 6563 7469  s a TCP connecti
│ │ │ │ +00048120: 6f6e 2074 6f20 7468 6520 7365 7276 6572  on to the server
│ │ │ │ +00048130: 2e20 2044 6566 6175 6c74 0a70 6f72 7473  .  Default.ports
│ │ │ │ +00048140: 2061 7265 2035 3433 2028 e280 986b 6c6f   are 543 (...klo
│ │ │ │ +00048150: 6769 6ee2 8099 292c 2035 3434 2028 e280  gin...), 544 (..
│ │ │ │ +00048160: 986b 7368 656c 6ce2 8099 292c 2061 6e64  .kshell...), and
│ │ │ │ +00048170: 2032 3130 3520 28e2 8098 656b 6c6f 6769   2105 (...eklogi
│ │ │ │ +00048180: 6ee2 8099 292e 2020 4865 7265 0ae2 8098  n...).  Here....
│ │ │ │ +00048190: 656b 6c6f 6769 6ee2 8099 2069 7320 7468  eklogin... is th
│ │ │ │ +000481a0: 6520 7361 6d65 2061 7320 e280 986b 6c6f  e same as ...klo
│ │ │ │ +000481b0: 6769 6ee2 8099 2c20 6275 7420 7769 7468  gin..., but with
│ │ │ │ +000481c0: 2065 6e63 7279 7074 696f 6e2e 2020 5468   encryption.  Th
│ │ │ │ +000481d0: 6572 6520 6973 206e 6f0a 6c6f 6e67 6572  ere is no.longer
│ │ │ │ +000481e0: 2061 2073 6570 6172 6174 6520 e280 9865   a separate ...e
│ │ │ │ +000481f0: 6b73 6865 6c6c e280 9920 706f 7274 2c20  kshell... port, 
│ │ │ │ +00048200: 6265 6361 7573 6520 656e 6372 7970 7465  because encrypte
│ │ │ │ +00048210: 6420 616e 6420 6e6f 726d 616c 0a63 6f6e  d and normal.con
│ │ │ │ +00048220: 6e65 6374 696f 6e20 6e6f 7720 7573 6520  nection now use 
│ │ │ │ +00048230: 7468 6520 7361 6d65 2070 6f72 7420 e280  the same port ..
│ │ │ │ +00048240: 986b 7368 656c 6ce2 8099 2e0a 0a20 2020  .kshell......   
│ │ │ │ +00048250: 4e6f 726d 616c 6c79 20e2 8098 6b73 6865  Normally ...kshe
│ │ │ │ +00048260: 6c6c e280 9920 6e65 6564 7320 6120 7365  ll... needs a se
│ │ │ │ +00048270: 636f 6e64 2063 6f6e 6e65 6374 696f 6e20  cond connection 
│ │ │ │ +00048280: 666f 7220 e280 9873 7464 6572 72e2 8099  for ...stderr...
│ │ │ │ +00048290: 2e20 2054 6865 2063 6c69 656e 740a 7368  .  The client.sh
│ │ │ │ +000482a0: 6f75 6c64 2073 656e 6420 6120 6e75 6c6c  ould send a null
│ │ │ │ +000482b0: 2074 6572 6d69 6e61 7465 6420 7374 7269   terminated stri
│ │ │ │ +000482c0: 6e67 2063 6f6e 7461 696e 696e 6720 616e  ng containing an
│ │ │ │ +000482d0: 2061 7363 6969 2065 6e63 6f64 696e 6720   ascii encoding 
│ │ │ │ +000482e0: 6f66 2074 6865 0a70 6f72 7420 6e75 6d62  of the.port numb
│ │ │ │ +000482f0: 6572 2074 6f20 6265 2075 7365 6420 666f  er to be used fo
│ │ │ │ +00048300: 7220 7468 6973 2073 6563 6f6e 6420 636f  r this second co
│ │ │ │ +00048310: 6e6e 6563 7469 6f6e 2e20 2053 696e 6365  nnection.  Since
│ │ │ │ +00048320: 20e2 8098 6b6c 6f67 696e e280 9920 616e   ...klogin... an
│ │ │ │ +00048330: 640a e280 9865 6b6c 6f67 696e e280 9920  d....eklogin... 
│ │ │ │ +00048340: 646f 206e 6f74 2075 7365 2061 2073 6563  do not use a sec
│ │ │ │ +00048350: 6f6e 6420 636f 6e6e 6563 7469 6f6e 2066  ond connection f
│ │ │ │ +00048360: 6f72 20e2 8098 7374 6465 7272 e280 992c  or ...stderr...,
│ │ │ │ +00048370: 2074 6865 2063 6c69 656e 7420 6a75 7374   the client just
│ │ │ │ +00048380: 0a73 656e 6473 2061 6e20 6164 6469 7469  .sends an additi
│ │ │ │ +00048390: 6f6e 616c 206e 756c 6c20 6279 7465 2074  onal null byte t
│ │ │ │ +000483a0: 6f20 7468 6520 7365 7276 6572 2c20 7768  o the server, wh
│ │ │ │ +000483b0: 6963 6820 6361 6e20 6265 2074 686f 7567  ich can be thoug
│ │ │ │ +000483c0: 6874 206f 6620 6173 0a61 6e20 656d 7074  ht of as.an empt
│ │ │ │ +000483d0: 7920 7374 7269 6e67 2e20 2043 6f6e 7472  y string.  Contr
│ │ │ │ +000483e0: 6172 7920 746f 2063 6c61 7373 6963 20e2  ary to classic .
│ │ │ │ +000483f0: 8098 7273 68e2 8099 2061 6e64 20e2 8098  ..rsh... and ...
│ │ │ │ +00048400: 726c 6f67 696e e280 992c 2074 6865 2073  rlogin..., the s
│ │ │ │ +00048410: 6572 7665 720a 6e65 6564 206e 6f74 2063  erver.need not c
│ │ │ │ +00048420: 6865 636b 2069 6620 7468 6520 636c 6965  heck if the clie
│ │ │ │ +00048430: 6e74 2773 2070 6f72 7420 6c69 6573 2069  nt's port lies i
│ │ │ │ +00048440: 6e20 7468 6520 7261 6e67 6520 302d 3130  n the range 0-10
│ │ │ │ +00048450: 3233 2e0a 0a42 2e33 2e32 204b 6572 6265  23...B.3.2 Kerbe
│ │ │ │ +00048460: 726f 7320 6964 656e 7469 6669 6361 7469  ros identificati
│ │ │ │ +00048470: 6f6e 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  on.-------------
│ │ │ │ +00048480: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ +00048490: 0a0a 5768 656e 2061 2063 6f6e 6e65 6374  ..When a connect
│ │ │ │ +000484a0: 696f 6e20 6973 2062 6569 6e67 2065 7374  ion is being est
│ │ │ │ +000484b0: 6162 6c69 7368 6564 2c20 7468 6520 6669  ablished, the fi
│ │ │ │ +000484c0: 7273 7420 7468 696e 6720 746f 2064 6f20  rst thing to do 
│ │ │ │ +000484d0: 6973 2074 6f0a 696e 6469 6361 7465 2074  is to.indicate t
│ │ │ │ +000484e0: 6861 7420 4b65 7262 6572 6f73 2061 7574  hat Kerberos aut
│ │ │ │ +000484f0: 6865 6e74 6963 6174 696f 6e20 6973 2064  hentication is d
│ │ │ │ +00048500: 6573 6972 6564 2e20 2054 6865 2063 6c69  esired.  The cli
│ │ │ │ +00048510: 656e 7420 7769 6c6c 2073 656e 640a 6120  ent will send.a 
│ │ │ │ +00048520: 7374 7269 6e67 2074 6f20 696e 6469 6361  string to indica
│ │ │ │ +00048530: 7465 2069 7420 7769 6c6c 2075 7365 204b  te it will use K
│ │ │ │ +00048540: 6572 6265 726f 7320 352e 2020 4c65 7420  erberos 5.  Let 
│ │ │ │ +00048550: 7573 2073 6179 2022 6c65 6e67 7468 2d73  us say "length-s
│ │ │ │ +00048560: 7472 696e 6722 0a6f 6620 5354 524c 2c20  tring".of STRL, 
│ │ │ │ +00048570: 616e 6420 6d65 616e 2074 6865 2063 6f75  and mean the cou
│ │ │ │ +00048580: 706c 650a 0a20 2028 6c65 6e67 7468 206f  ple..  (length o
│ │ │ │ +00048590: 6620 7468 6520 7374 7269 6e67 2073 7472  f the string str
│ │ │ │ +000485a0: 6c2c 206e 756c 6c2d 7465 726d 696e 6174  l, null-terminat
│ │ │ │ +000485b0: 6564 2073 7472 696e 6720 7374 726c 292e  ed string strl).
│ │ │ │ +000485c0: 0a0a 7768 656e 2053 5452 4c20 6974 7365  ..when STRL itse
│ │ │ │ +000485d0: 6c66 2069 7320 6769 7665 6e2e 2020 5468  lf is given.  Th
│ │ │ │ +000485e0: 6520 7374 7269 6e67 206c 656e 6774 6820  e string length 
│ │ │ │ +000485f0: 6973 2065 6e63 6f64 6564 2061 7320 616e  is encoded as an
│ │ │ │ +00048600: 20e2 8098 696e 7433 32e2 8099 0a28 3332   ...int32....(32
│ │ │ │ +00048610: 2d62 6974 2069 6e74 6567 6572 2920 696e  -bit integer) in
│ │ │ │ +00048620: 204d 5342 206f 7264 6572 2c20 692e 652e   MSB order, i.e.
│ │ │ │ +00048630: 2c20 6e65 7477 6f72 6b20 6279 7465 206f  , network byte o
│ │ │ │ +00048640: 7264 6572 2e20 2053 6f20 7468 6520 636c  rder.  So the cl
│ │ │ │ +00048650: 6965 6e74 0a66 6972 7374 2073 656e 6473  ient.first sends
│ │ │ │ +00048660: 2061 6e20 6175 7468 656e 7469 6361 7469   an authenticati
│ │ │ │ +00048670: 6f6e 206d 6573 7361 6765 2c20 7468 6520  on message, the 
│ │ │ │ +00048680: 6c65 6e67 7468 2d73 7472 696e 6720 6f66  length-string of
│ │ │ │ +00048690: 0a0a 2020 204b 5242 355f 5345 4e44 4155  ..   KRB5_SENDAU
│ │ │ │ +000486a0: 5448 5f56 312e 300a 0a41 6674 6572 2074  TH_V1.0..After t
│ │ │ │ +000486b0: 6861 742c 2074 6865 2063 6c69 656e 7420  hat, the client 
│ │ │ │ +000486c0: 6d75 7374 2074 656c 6c20 7768 6963 6820  must tell which 
│ │ │ │ +000486d0: 7665 7273 696f 6e20 6f66 2074 6865 2070  version of the p
│ │ │ │ +000486e0: 726f 746f 636f 6c20 6974 2075 7365 730a  rotocol it uses.
│ │ │ │ +000486f0: 6279 2073 656e 6469 6e67 2061 2076 6572  by sending a ver
│ │ │ │ +00048700: 7369 6f6e 206d 6573 7361 6765 2c20 636f  sion message, co
│ │ │ │ +00048710: 6e73 6973 7469 6e67 206f 6620 6120 7365  nsisting of a se
│ │ │ │ +00048720: 636f 6e64 206c 656e 6774 682d 7374 7269  cond length-stri
│ │ │ │ +00048730: 6e67 2e0a 5468 6973 2074 696d 6520 6261  ng..This time ba
│ │ │ │ +00048740: 7365 6420 6f6e 0a0a 2020 204b 434d 4456  sed on..   KCMDV
│ │ │ │ +00048750: 302e 320a 0a6f 7220 6f6e 2022 4b43 4d44  0.2..or on "KCMD
│ │ │ │ +00048760: 5630 2e31 222c 2066 6f72 2074 6865 206f  V0.1", for the o
│ │ │ │ +00048770: 6c64 6572 2076 6572 7369 6f6e 2e0a 0a20  lder version... 
│ │ │ │ +00048780: 2020 4966 2074 6865 2063 6c69 656e 7427    If the client'
│ │ │ │ +00048790: 7320 696e 6465 6e74 6966 6963 6174 696f  s indentificatio
│ │ │ │ +000487a0: 6e20 6973 2061 6363 6570 7461 626c 652c  n is acceptable,
│ │ │ │ +000487b0: 2074 6865 2073 6572 7665 7220 7769 6c6c   the server will
│ │ │ │ +000487c0: 0a72 6573 706f 6e64 2077 6974 6820 6120  .respond with a 
│ │ │ │ +000487d0: 6e75 6c6c 2062 7974 6520 28e2 8098 3078  null byte (...0x
│ │ │ │ +000487e0: 3030 e280 9929 2e20 204f 7468 6572 7769  00...).  Otherwi
│ │ │ │ +000487f0: 7365 2c20 6966 2074 6865 2061 7574 6865  se, if the authe
│ │ │ │ +00048800: 6e74 6963 6174 696f 6e0a 6d65 7373 6167  ntication.messag
│ │ │ │ +00048810: 6520 7761 7320 696e 636f 7272 6563 742c  e was incorrect,
│ │ │ │ +00048820: 2074 6865 6e20 7468 6520 7365 7276 6572   then the server
│ │ │ │ +00048830: 2072 6573 706f 6e64 7320 7769 7468 2074   responds with t
│ │ │ │ +00048840: 6865 2073 696e 676c 6520 6279 7465 0ae2  he single byte..
│ │ │ │ +00048850: 8098 3078 3031 e280 992c 2077 6869 6c65  ..0x01..., while
│ │ │ │ +00048860: 2069 6620 7468 6520 7072 6f74 6f63 6f6c   if the protocol
│ │ │ │ +00048870: 2076 6572 7369 6f6e 206d 6573 7361 6765   version message
│ │ │ │ +00048880: 2077 6173 2075 6e61 6363 6570 7461 626c   was unacceptabl
│ │ │ │ +00048890: 652c 2074 6865 6e20 7468 650a 7265 7370  e, then the.resp
│ │ │ │ +000488a0: 6f6e 7365 2069 7320 6120 7369 6e67 6c65  onse is a single
│ │ │ │ +000488b0: 20e2 8098 3078 3032 e280 992e 0a0a 422e   ...0x02......B.
│ │ │ │ +000488c0: 332e 3320 4b65 7262 6572 6f73 2061 7574  3.3 Kerberos aut
│ │ │ │ +000488d0: 6865 6e74 6963 6174 696f 6e0a 2d2d 2d2d  hentication.----
│ │ │ │  000488e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -000488f0: 2d2d 2d2d 2d2d 2d2d 0a0a 5768 656e 2074  --------..When t
│ │ │ │ -00048900: 6865 2063 6c69 656e 7420 6973 2069 6e64  he client is ind
│ │ │ │ -00048910: 656e 7469 6669 6564 2c20 4b65 7262 6572  entified, Kerber
│ │ │ │ -00048920: 6f73 2061 7574 6865 6e74 6963 6174 696f  os authenticatio
│ │ │ │ -00048930: 6e20 6361 6e20 6265 6769 6e2e 2020 5468  n can begin.  Th
│ │ │ │ -00048940: 650a 636c 6965 6e74 206d 7573 7420 7365  e.client must se
│ │ │ │ -00048950: 6e64 2061 6e20 4150 2d52 4551 2074 6f20  nd an AP-REQ to 
│ │ │ │ -00048960: 7468 6520 7365 7276 6572 3b20 616e 2041  the server; an A
│ │ │ │ -00048970: 502d 5245 5120 6175 7468 656e 7469 6361  P-REQ authentica
│ │ │ │ -00048980: 746f 7220 6d75 7374 0a63 6f6e 7461 696e  tor must.contain
│ │ │ │ -00048990: 2061 2073 7562 6b65 7920 286f 6e6c 7920   a subkey (only 
│ │ │ │ -000489a0: 666f 7220 4b43 4d44 5630 2e32 2920 616e  for KCMDV0.2) an
│ │ │ │ -000489b0: 6420 6120 6368 6563 6b73 756d 2e20 2054  d a checksum.  T
│ │ │ │ -000489c0: 6865 2061 7574 6865 6e74 6963 6174 6f72  he authenticator
│ │ │ │ -000489d0: 0a63 6865 636b 7375 6d20 6973 2063 616c  .checksum is cal
│ │ │ │ -000489e0: 6375 6c61 7465 6420 6672 6f6d 2074 6865  culated from the
│ │ │ │ -000489f0: 2066 6f6c 6c6f 7769 6e67 2073 7472 696e   following strin
│ │ │ │ -00048a00: 672e 0a0a 2020 2020 2022 7365 7276 6572  g...     "server
│ │ │ │ -00048a10: 706f 7274 223a 2274 6572 6d69 6e61 6c74  port":"terminalt
│ │ │ │ -00048a20: 7970 6522 2272 656d 6f74 6575 7365 726e  ype""remoteusern
│ │ │ │ -00048a30: 616d 6522 0a0a 4f62 7365 7276 6520 7468  ame"..Observe th
│ │ │ │ -00048a40: 6520 6d61 6e64 6174 6f72 7920 636f 6c6f  e mandatory colo
│ │ │ │ -00048a50: 6e2c 2073 6572 7669 6e67 2061 7320 6120  n, serving as a 
│ │ │ │ -00048a60: 6465 6c69 6d69 7465 7220 746f 2074 6865  delimiter to the
│ │ │ │ -00048a70: 2074 6572 6d69 6e61 6c0a 7479 7065 2e20   terminal.type. 
│ │ │ │ -00048a80: 2048 6572 6520 5245 4d4f 5445 5553 4552   Here REMOTEUSER
│ │ │ │ -00048a90: 4e41 4d45 2069 7320 7768 6174 6576 6572  NAME is whatever
│ │ │ │ -00048aa0: 2069 6465 6e74 6974 7920 7468 6520 636c   identity the cl
│ │ │ │ -00048ab0: 6965 6e74 2064 6573 6972 6573 2074 6f0a  ient desires to.
│ │ │ │ -00048ac0: 7573 6520 6174 2074 6865 2072 656d 6f74  use at the remot
│ │ │ │ -00048ad0: 6520 656e 642e 2020 5468 6520 7369 6d70  e end.  The simp
│ │ │ │ -00048ae0: 6c65 2065 7861 6d70 6c65 0a0a 2020 2020  le example..    
│ │ │ │ -00048af0: 2035 3433 3a6c 696e 7578 2f33 3834 3030   543:linux/38400
│ │ │ │ -00048b00: 7573 6572 0a0a 6465 6d6f 6e73 7472 6174  user..demonstrat
│ │ │ │ -00048b10: 6573 2074 6861 7420 7468 6520 7465 726d  es that the term
│ │ │ │ -00048b20: 696e 616c 2074 7970 6520 6578 7065 6374  inal type expect
│ │ │ │ -00048b30: 7320 6120 7465 726d 696e 666f 206e 616d  s a terminfo nam
│ │ │ │ -00048b40: 6520 616e 6420 6120 7370 6565 640a 6173  e and a speed.as
│ │ │ │ -00048b50: 2064 6563 696d 616c 206e 756d 6265 722e   decimal number.
│ │ │ │ -00048b60: 0a0a 2020 204f 6e63 6520 7468 6520 4150  ..   Once the AP
│ │ │ │ -00048b70: 2d52 4551 2068 6173 2062 6565 6e20 7570  -REQ has been up
│ │ │ │ -00048b80: 6461 7465 6420 7769 7468 2074 6865 2063  dated with the c
│ │ │ │ -00048b90: 6865 636b 7375 6d2c 2069 7420 6973 2072  hecksum, it is r
│ │ │ │ -00048ba0: 6561 6479 2066 6f72 0a74 7261 6e73 6d69  eady for.transmi
│ │ │ │ -00048bb0: 7373 696f 6e20 746f 2074 6865 2073 6572  ssion to the ser
│ │ │ │ -00048bc0: 7665 722e 2020 4974 7320 6c65 6e67 7468  ver.  Its length
│ │ │ │ -00048bd0: 2028 6173 20e2 8098 696e 7433 32e2 8099   (as ...int32...
│ │ │ │ -00048be0: 2920 6973 2066 6972 7374 2073 656e 7420  ) is first sent 
│ │ │ │ -00048bf0: 696e 0a6e 6574 776f 726b 206f 7264 6572  in.network order
│ │ │ │ -00048c00: 2028 4d53 4229 2c20 666f 6c6c 6f77 6564   (MSB), followed
│ │ │ │ -00048c10: 2062 7920 7468 6520 4445 5220 656e 636f   by the DER enco
│ │ │ │ -00048c20: 6465 6420 4150 2d52 4551 2069 7473 656c  ded AP-REQ itsel
│ │ │ │ -00048c30: 662e 0a0a 2020 2049 6620 616c 6c20 6973  f...   If all is
│ │ │ │ -00048c40: 2061 6363 6570 7461 626c 652c 2074 6865   acceptable, the
│ │ │ │ -00048c50: 2073 6572 7665 7220 7265 706f 6e64 7320   server reponds 
│ │ │ │ -00048c60: 7769 7468 2061 6e20 e280 9869 6e74 3332  with an ...int32
│ │ │ │ -00048c70: e280 9920 6f66 2076 616c 7565 0a6e 756c  ... of value.nul
│ │ │ │ -00048c80: 6c2e 2020 2849 6e20 4d53 4220 6f72 6465  l.  (In MSB orde
│ │ │ │ -00048c90: 722c 2062 7574 2061 7320 6974 2069 7320  r, but as it is 
│ │ │ │ -00048ca0: 6e75 6c6c 2c20 6f72 6465 7220 6973 2069  null, order is i
│ │ │ │ -00048cb0: 7272 656c 6576 616e 7421 292e 2020 5468  rrelevant!).  Th
│ │ │ │ -00048cc0: 650a 4b43 4d44 2070 726f 746f 636f 6c20  e.KCMD protocol 
│ │ │ │ -00048cd0: 7573 6573 206d 7574 7561 6c20 6175 7468  uses mutual auth
│ │ │ │ -00048ce0: 656e 7469 6361 7469 6f6e 2c20 736f 2074  entication, so t
│ │ │ │ -00048cf0: 6865 2073 6572 7665 7220 6d75 7374 2061  he server must a
│ │ │ │ -00048d00: 6c73 6f20 7365 6e64 0a61 6e20 4150 2d52  lso send.an AP-R
│ │ │ │ -00048d10: 4550 2062 6163 6b3a 0a0a 2020 2020 2028  EP back:..     (
│ │ │ │ -00048d20: 696e 7433 322d 6c65 6e67 7468 2069 6e20  int32-length in 
│ │ │ │ -00048d30: 4d53 4220 6f66 2044 4552 2065 6e63 6f64  MSB of DER encod
│ │ │ │ -00048d40: 6564 2041 502d 5245 5029 0a20 2020 2020  ed AP-REP).     
│ │ │ │ -00048d50: 2844 4552 2065 6e63 6f64 6564 2041 502d  (DER encoded AP-
│ │ │ │ -00048d60: 5245 5029 0a0a 4e6f 7720 7365 7276 6572  REP)..Now server
│ │ │ │ -00048d70: 2061 6e64 2063 6c69 656e 7420 6172 6520   and client are 
│ │ │ │ -00048d80: 7072 6f76 6973 696f 6e61 6c6c 7920 6175  provisionally au
│ │ │ │ -00048d90: 7468 656e 7469 6361 7465 642e 0a0a 422e  thenticated...B.
│ │ │ │ -00048da0: 332e 3420 4578 7465 6e64 6564 2061 7574  3.4 Extended aut
│ │ │ │ -00048db0: 6865 6e74 6963 6174 696f 6e0a 2d2d 2d2d  hentication.----
│ │ │ │ +000488f0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a57 6865 6e20  ---------..When 
│ │ │ │ +00048900: 7468 6520 636c 6965 6e74 2069 7320 696e  the client is in
│ │ │ │ +00048910: 6465 6e74 6966 6965 642c 204b 6572 6265  dentified, Kerbe
│ │ │ │ +00048920: 726f 7320 6175 7468 656e 7469 6361 7469  ros authenticati
│ │ │ │ +00048930: 6f6e 2063 616e 2062 6567 696e 2e20 2054  on can begin.  T
│ │ │ │ +00048940: 6865 0a63 6c69 656e 7420 6d75 7374 2073  he.client must s
│ │ │ │ +00048950: 656e 6420 616e 2041 502d 5245 5120 746f  end an AP-REQ to
│ │ │ │ +00048960: 2074 6865 2073 6572 7665 723b 2061 6e20   the server; an 
│ │ │ │ +00048970: 4150 2d52 4551 2061 7574 6865 6e74 6963  AP-REQ authentic
│ │ │ │ +00048980: 6174 6f72 206d 7573 740a 636f 6e74 6169  ator must.contai
│ │ │ │ +00048990: 6e20 6120 7375 626b 6579 2028 6f6e 6c79  n a subkey (only
│ │ │ │ +000489a0: 2066 6f72 204b 434d 4456 302e 3229 2061   for KCMDV0.2) a
│ │ │ │ +000489b0: 6e64 2061 2063 6865 636b 7375 6d2e 2020  nd a checksum.  
│ │ │ │ +000489c0: 5468 6520 6175 7468 656e 7469 6361 746f  The authenticato
│ │ │ │ +000489d0: 720a 6368 6563 6b73 756d 2069 7320 6361  r.checksum is ca
│ │ │ │ +000489e0: 6c63 756c 6174 6564 2066 726f 6d20 7468  lculated from th
│ │ │ │ +000489f0: 6520 666f 6c6c 6f77 696e 6720 7374 7269  e following stri
│ │ │ │ +00048a00: 6e67 2e0a 0a20 2020 2020 2273 6572 7665  ng...     "serve
│ │ │ │ +00048a10: 7270 6f72 7422 3a22 7465 726d 696e 616c  rport":"terminal
│ │ │ │ +00048a20: 7479 7065 2222 7265 6d6f 7465 7573 6572  type""remoteuser
│ │ │ │ +00048a30: 6e61 6d65 220a 0a4f 6273 6572 7665 2074  name"..Observe t
│ │ │ │ +00048a40: 6865 206d 616e 6461 746f 7279 2063 6f6c  he mandatory col
│ │ │ │ +00048a50: 6f6e 2c20 7365 7276 696e 6720 6173 2061  on, serving as a
│ │ │ │ +00048a60: 2064 656c 696d 6974 6572 2074 6f20 7468   delimiter to th
│ │ │ │ +00048a70: 6520 7465 726d 696e 616c 0a74 7970 652e  e terminal.type.
│ │ │ │ +00048a80: 2020 4865 7265 2052 454d 4f54 4555 5345    Here REMOTEUSE
│ │ │ │ +00048a90: 524e 414d 4520 6973 2077 6861 7465 7665  RNAME is whateve
│ │ │ │ +00048aa0: 7220 6964 656e 7469 7479 2074 6865 2063  r identity the c
│ │ │ │ +00048ab0: 6c69 656e 7420 6465 7369 7265 7320 746f  lient desires to
│ │ │ │ +00048ac0: 0a75 7365 2061 7420 7468 6520 7265 6d6f  .use at the remo
│ │ │ │ +00048ad0: 7465 2065 6e64 2e20 2054 6865 2073 696d  te end.  The sim
│ │ │ │ +00048ae0: 706c 6520 6578 616d 706c 650a 0a20 2020  ple example..   
│ │ │ │ +00048af0: 2020 3534 333a 6c69 6e75 782f 3338 3430    543:linux/3840
│ │ │ │ +00048b00: 3075 7365 720a 0a64 656d 6f6e 7374 7261  0user..demonstra
│ │ │ │ +00048b10: 7465 7320 7468 6174 2074 6865 2074 6572  tes that the ter
│ │ │ │ +00048b20: 6d69 6e61 6c20 7479 7065 2065 7870 6563  minal type expec
│ │ │ │ +00048b30: 7473 2061 2074 6572 6d69 6e66 6f20 6e61  ts a terminfo na
│ │ │ │ +00048b40: 6d65 2061 6e64 2061 2073 7065 6564 0a61  me and a speed.a
│ │ │ │ +00048b50: 7320 6465 6369 6d61 6c20 6e75 6d62 6572  s decimal number
│ │ │ │ +00048b60: 2e0a 0a20 2020 4f6e 6365 2074 6865 2041  ...   Once the A
│ │ │ │ +00048b70: 502d 5245 5120 6861 7320 6265 656e 2075  P-REQ has been u
│ │ │ │ +00048b80: 7064 6174 6564 2077 6974 6820 7468 6520  pdated with the 
│ │ │ │ +00048b90: 6368 6563 6b73 756d 2c20 6974 2069 7320  checksum, it is 
│ │ │ │ +00048ba0: 7265 6164 7920 666f 720a 7472 616e 736d  ready for.transm
│ │ │ │ +00048bb0: 6973 7369 6f6e 2074 6f20 7468 6520 7365  ission to the se
│ │ │ │ +00048bc0: 7276 6572 2e20 2049 7473 206c 656e 6774  rver.  Its lengt
│ │ │ │ +00048bd0: 6820 2861 7320 e280 9869 6e74 3332 e280  h (as ...int32..
│ │ │ │ +00048be0: 9929 2069 7320 6669 7273 7420 7365 6e74  .) is first sent
│ │ │ │ +00048bf0: 2069 6e0a 6e65 7477 6f72 6b20 6f72 6465   in.network orde
│ │ │ │ +00048c00: 7220 284d 5342 292c 2066 6f6c 6c6f 7765  r (MSB), followe
│ │ │ │ +00048c10: 6420 6279 2074 6865 2044 4552 2065 6e63  d by the DER enc
│ │ │ │ +00048c20: 6f64 6564 2041 502d 5245 5120 6974 7365  oded AP-REQ itse
│ │ │ │ +00048c30: 6c66 2e0a 0a20 2020 4966 2061 6c6c 2069  lf...   If all i
│ │ │ │ +00048c40: 7320 6163 6365 7074 6162 6c65 2c20 7468  s acceptable, th
│ │ │ │ +00048c50: 6520 7365 7276 6572 2072 6570 6f6e 6473  e server reponds
│ │ │ │ +00048c60: 2077 6974 6820 616e 20e2 8098 696e 7433   with an ...int3
│ │ │ │ +00048c70: 32e2 8099 206f 6620 7661 6c75 650a 6e75  2... of value.nu
│ │ │ │ +00048c80: 6c6c 2e20 2028 496e 204d 5342 206f 7264  ll.  (In MSB ord
│ │ │ │ +00048c90: 6572 2c20 6275 7420 6173 2069 7420 6973  er, but as it is
│ │ │ │ +00048ca0: 206e 756c 6c2c 206f 7264 6572 2069 7320   null, order is 
│ │ │ │ +00048cb0: 6972 7265 6c65 7661 6e74 2129 2e20 2054  irrelevant!).  T
│ │ │ │ +00048cc0: 6865 0a4b 434d 4420 7072 6f74 6f63 6f6c  he.KCMD protocol
│ │ │ │ +00048cd0: 2075 7365 7320 6d75 7475 616c 2061 7574   uses mutual aut
│ │ │ │ +00048ce0: 6865 6e74 6963 6174 696f 6e2c 2073 6f20  hentication, so 
│ │ │ │ +00048cf0: 7468 6520 7365 7276 6572 206d 7573 7420  the server must 
│ │ │ │ +00048d00: 616c 736f 2073 656e 640a 616e 2041 502d  also send.an AP-
│ │ │ │ +00048d10: 5245 5020 6261 636b 3a0a 0a20 2020 2020  REP back:..     
│ │ │ │ +00048d20: 2869 6e74 3332 2d6c 656e 6774 6820 696e  (int32-length in
│ │ │ │ +00048d30: 204d 5342 206f 6620 4445 5220 656e 636f   MSB of DER enco
│ │ │ │ +00048d40: 6465 6420 4150 2d52 4550 290a 2020 2020  ded AP-REP).    
│ │ │ │ +00048d50: 2028 4445 5220 656e 636f 6465 6420 4150   (DER encoded AP
│ │ │ │ +00048d60: 2d52 4550 290a 0a4e 6f77 2073 6572 7665  -REP)..Now serve
│ │ │ │ +00048d70: 7220 616e 6420 636c 6965 6e74 2061 7265  r and client are
│ │ │ │ +00048d80: 2070 726f 7669 7369 6f6e 616c 6c79 2061   provisionally a
│ │ │ │ +00048d90: 7574 6865 6e74 6963 6174 6564 2e0a 0a42  uthenticated...B
│ │ │ │ +00048da0: 2e33 2e34 2045 7874 656e 6465 6420 6175  .3.4 Extended au
│ │ │ │ +00048db0: 7468 656e 7469 6361 7469 6f6e 0a2d 2d2d  thentication.---
│ │ │ │  00048dc0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00048dd0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a54 6865 2063  ---------..The c
│ │ │ │ -00048de0: 6c69 656e 7420 6e65 7874 2073 656e 6473  lient next sends
│ │ │ │ -00048df0: 2074 6872 6565 2064 6966 6665 7265 6e74   three different
│ │ │ │ -00048e00: 206e 756c 6c20 7465 726d 696e 6174 6564   null terminated
│ │ │ │ -00048e10: 2073 7472 696e 6773 2c20 7769 7468 6f75   strings, withou
│ │ │ │ -00048e20: 740a 6c65 6e67 7468 203a 0a0a 2020 20e2  t.length :..   .
│ │ │ │ -00048e30: 80a2 2072 656d 6f74 6520 7573 6572 206e  .. remote user n
│ │ │ │ -00048e40: 616d 6520 2875 7365 7220 6964 656e 7469  ame (user identi
│ │ │ │ -00048e50: 7479 206f 6e20 7265 6d6f 7465 206d 6163  ty on remote mac
│ │ │ │ -00048e60: 6869 6e65 290a 2020 20e2 80a2 2074 6572  hine).   ... ter
│ │ │ │ -00048e70: 6d69 6e61 6c20 7479 7065 2066 6f72 20e2  minal type for .
│ │ │ │ -00048e80: 8098 726c 6f67 696e e280 9920 6f72 2063  ..rlogin... or c
│ │ │ │ -00048e90: 6f6d 6d61 6e64 2066 6f72 20e2 8098 7273  ommand for ...rs
│ │ │ │ -00048ea0: 68e2 8099 0a20 2020 e280 a220 6c6f 6361  h....   ... loca
│ │ │ │ -00048eb0: 6c20 7573 6572 206e 616d 6520 2875 7365  l user name (use
│ │ │ │ -00048ec0: 7220 6964 656e 7469 7479 206f 6e20 636c  r identity on cl
│ │ │ │ -00048ed0: 6965 6e74 206d 6163 6869 6e65 290a 0a20  ient machine).. 
│ │ │ │ -00048ee0: 2020 416e 2065 7861 6d70 6c65 2066 6f72    An example for
│ │ │ │ -00048ef0: 20e2 8098 7273 68e2 8099 203a 0a0a 2020   ...rsh... :..  
│ │ │ │ -00048f00: 2020 2022 726e 616d 655c 3022 0a20 2020     "rname\0".   
│ │ │ │ -00048f10: 2020 2263 6174 202f 7573 722f 6c6f 6361    "cat /usr/loca
│ │ │ │ -00048f20: 6c2f 6574 632f 7368 6973 6869 2e63 6f6e  l/etc/shishi.con
│ │ │ │ -00048f30: 6622 0a20 2020 2020 226c 6e61 6d65 5c30  f".     "lname\0
│ │ │ │ -00048f40: 220a 0a20 2020 5468 6520 7365 7276 6572  "..   The server
│ │ │ │ -00048f50: 206d 7573 7420 6e65 7874 2076 6572 6966   must next verif
│ │ │ │ -00048f60: 7920 7468 6174 2074 6865 2063 6865 636b  y that the check
│ │ │ │ -00048f70: 7375 6d20 6465 6c69 7665 7265 6420 696e  sum delivered in
│ │ │ │ -00048f80: 2074 6865 2041 502d 5245 510a 6175 7468   the AP-REQ.auth
│ │ │ │ -00048f90: 656e 7469 6361 746f 7220 6973 2063 6f72  enticator is cor
│ │ │ │ -00048fa0: 7265 6374 2c20 6279 2063 6f6d 7075 7469  rect, by computi
│ │ │ │ -00048fb0: 6e67 2061 206e 6577 2068 6173 6820 6c69  ng a new hash li
│ │ │ │ -00048fc0: 6b65 2074 6865 2063 6c69 656e 7420 6861  ke the client ha
│ │ │ │ -00048fd0: 730a 7072 6576 696f 7573 6c79 2064 6f6e  s.previously don
│ │ │ │ -00048fe0: 652e 0a0a 2020 2054 6865 2073 6572 7665  e...   The serve
│ │ │ │ -00048ff0: 7220 6d75 7374 2061 6c73 6f20 7665 7269  r must also veri
│ │ │ │ -00049000: 6679 2074 6861 7420 7468 6520 7265 7175  fy that the requ
│ │ │ │ -00049010: 6573 7469 6e67 2070 7269 6e63 6970 616c  esting principal
│ │ │ │ -00049020: 2028 666f 756e 6420 696e 0a41 502d 5245   (found in.AP-RE
│ │ │ │ -00049030: 5129 2068 6173 2074 6865 2072 6967 6874  Q) has the right
│ │ │ │ -00049040: 2074 6f20 6c6f 6720 696e 2074 6f20 7468   to log in to th
│ │ │ │ -00049050: 6520 7265 6d6f 7465 2075 7365 7220 6163  e remote user ac
│ │ │ │ -00049060: 636f 756e 742e 2020 496e 2074 6865 0ae2  count.  In the..
│ │ │ │ -00049070: 8098 6261 7369 63e2 8099 2061 7574 686f  ..basic... autho
│ │ │ │ -00049080: 7269 7a61 7469 6f6e 2c20 7468 6973 2069  rization, this i
│ │ │ │ -00049090: 7320 646f 6e65 2062 7920 6368 6563 6b69  s done by checki
│ │ │ │ -000490a0: 6e67 2077 6865 7468 6572 2074 6865 2072  ng whether the r
│ │ │ │ -000490b0: 656d 6f74 6520 7573 6572 0a6e 616d 6520  emote user.name 
│ │ │ │ -000490c0: 6973 2069 6465 6e74 6963 616c 2074 6f20  is identical to 
│ │ │ │ -000490d0: 7468 6520 7072 696e 6369 7061 6c27 7320  the principal's 
│ │ │ │ -000490e0: 6e61 6d65 2e20 2054 6865 2061 6c74 6572  name.  The alter
│ │ │ │ -000490f0: 6e61 7469 7665 2069 7320 e280 986b 356c  native is ...k5l
│ │ │ │ -00049100: 6f67 696e e280 990a 6d6f 6465 2c20 7768  ogin....mode, wh
│ │ │ │ -00049110: 6963 6820 6973 2064 6973 6375 7373 6564  ich is discussed
│ │ │ │ -00049120: 2069 6e20 2a6e 6f74 6520 6b65 7262 6572   in *note kerber
│ │ │ │ -00049130: 6f73 2061 7574 686f 7269 7a61 7469 6f6e  os authorization
│ │ │ │ -00049140: 3a3a 2e0a 0a20 2020 4966 2061 6c6c 2069  ::...   If all i
│ │ │ │ -00049150: 7320 636f 7272 6563 742c 2074 6865 2073  s correct, the s
│ │ │ │ -00049160: 6572 7665 7220 7365 6e64 7320 6120 6e75  erver sends a nu
│ │ │ │ -00049170: 6c6c 2062 7974 652c 2069 2e65 2e2c 2061  ll byte, i.e., a
│ │ │ │ -00049180: 6e20 656d 7074 790a 7374 7269 6e67 2c20  n empty.string, 
│ │ │ │ -00049190: 6f72 2065 6c73 6520 616e 2065 7272 6f72  or else an error
│ │ │ │ -000491a0: 206d 6573 7361 6765 2073 7472 696e 6720   message string 
│ │ │ │ -000491b0: 286e 756c 6c20 7465 726d 696e 6174 6564  (null terminated
│ │ │ │ -000491c0: 292e 2020 5468 6520 7265 6d6f 7465 0a63  ).  The remote.c
│ │ │ │ -000491d0: 6c69 656e 7420 7265 6164 7320 7468 6520  lient reads the 
│ │ │ │ -000491e0: 6669 7273 7420 6279 7465 2e20 2049 6620  first byte.  If 
│ │ │ │ -000491f0: 6974 2069 7320 6571 7561 6c20 746f 207a  it is equal to z
│ │ │ │ -00049200: 6572 6f2c 2061 7574 6865 6e74 6963 6174  ero, authenticat
│ │ │ │ -00049210: 696f 6e20 6973 0a73 7563 6365 7373 6675  ion is.successfu
│ │ │ │ -00049220: 6c20 616e 6420 7468 6520 7573 6572 2069  l and the user i
│ │ │ │ -00049230: 7320 6c6f 6767 6564 2069 6e20 6174 2074  s logged in at t
│ │ │ │ -00049240: 6865 2072 656d 6f74 6520 686f 7374 2e20  he remote host. 
│ │ │ │ -00049250: 2049 6e20 616e 7920 6f74 6865 720a 6361   In any other.ca
│ │ │ │ -00049260: 7365 2c20 7468 6520 636c 6965 6e74 2068  se, the client h
│ │ │ │ -00049270: 6173 2074 6865 2065 7272 6f72 206d 6573  as the error mes
│ │ │ │ -00049280: 7361 6765 2061 7661 696c 6162 6c65 2c20  sage available, 
│ │ │ │ -00049290: 6173 2073 656e 7420 6279 2074 6865 2073  as sent by the s
│ │ │ │ -000492a0: 6572 7665 722c 0a74 6f20 6865 6c70 2074  erver,.to help t
│ │ │ │ -000492b0: 6865 2075 7365 7220 756e 6465 7273 7461  he user understa
│ │ │ │ -000492c0: 6e64 2074 6865 2066 6169 6c75 7265 2e0a  nd the failure..
│ │ │ │ -000492d0: 0a42 2e33 2e35 2057 696e 646f 7720 7369  .B.3.5 Window si
│ │ │ │ -000492e0: 7a65 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ze.-------------
│ │ │ │ -000492f0: 2d2d 2d2d 0a0a 496e 2074 6865 20e2 8098  ----..In the ...
│ │ │ │ -00049300: 726c 6f67 696e e280 9920 7072 6f74 6f63  rlogin... protoc
│ │ │ │ -00049310: 6f6c 2c20 7768 656e 2061 7574 6865 6e74  ol, when authent
│ │ │ │ -00049320: 6963 6174 696f 6e20 636f 6d70 6c65 7465  ication complete
│ │ │ │ -00049330: 732c 2074 6865 2073 6572 7665 7220 6361  s, the server ca
│ │ │ │ -00049340: 6e0a 6f70 7469 6f6e 616c 6c79 2073 656e  n.optionally sen
│ │ │ │ -00049350: 6420 6120 6d65 7373 6167 6520 6173 6b69  d a message aski
│ │ │ │ -00049360: 6e67 2066 6f72 2074 6572 6d69 6e61 6c20  ng for terminal 
│ │ │ │ -00049370: 7769 6e64 6f77 2073 697a 6520 7375 6974  window size suit
│ │ │ │ -00049380: 6162 6c65 2066 6f72 0a74 6865 2075 7365  able for.the use
│ │ │ │ -00049390: 722e 2020 5468 6520 636c 6965 6e74 2063  r.  The client c
│ │ │ │ -000493a0: 616e 2072 6573 706f 6e64 2c20 6275 7420  an respond, but 
│ │ │ │ -000493b0: 6974 2069 7320 6e6f 7420 6f62 6c69 6765  it is not oblige
│ │ │ │ -000493c0: 6420 746f 2064 6f20 736f 2e0a 0a20 2020  d to do so...   
│ │ │ │ -000493d0: 556e 6465 7220 4b43 4d44 5630 2e31 2c20  Under KCMDV0.1, 
│ │ │ │ -000493e0: 7468 6520 7365 7276 6572 2073 656e 6473  the server sends
│ │ │ │ -000493f0: 2061 2073 696e 676c 6520 6279 7465 2c20   a single byte, 
│ │ │ │ -00049400: 616e 2075 7267 656e 7420 5443 5020 6d65  an urgent TCP me
│ │ │ │ -00049410: 7373 6167 650a 28e2 8098 4d53 475f 4f4f  ssage.(...MSG_OO
│ │ │ │ -00049420: 42e2 8099 2920 3a0a 0a20 2020 2020 5449  B...) :..     TI
│ │ │ │ -00049430: 4f43 504b 545f 5749 4e44 4f57 203d 2030  OCPKT_WINDOW = 0
│ │ │ │ -00049440: 7838 300a 0a20 2020 5769 7468 204b 434d  x80..   With KCM
│ │ │ │ -00049450: 4456 302e 322c 2074 6865 2073 6572 7665  DV0.2, the serve
│ │ │ │ -00049460: 7220 646f 6573 206e 6f74 2073 656e 6420  r does not send 
│ │ │ │ -00049470: 616e 2075 7267 656e 7420 6d65 7373 6167  an urgent messag
│ │ │ │ -00049480: 6520 6174 2061 6c6c 2c20 6275 740a 7772  e at all, but.wr
│ │ │ │ -00049490: 6974 6573 2066 6976 6520 6279 7465 7320  ites five bytes 
│ │ │ │ -000494a0: 746f 2074 6865 2073 6f63 6b65 7420 3a0a  to the socket :.
│ │ │ │ -000494b0: 0a20 2020 2020 275c 3337 3727 2c20 275c  .     '\377', '\
│ │ │ │ -000494c0: 3337 3727 2c20 276f 272c 2027 6f27 2c20  377', 'o', 'o', 
│ │ │ │ -000494d0: 5449 4f43 504b 545f 5749 4e44 4f57 0a0a  TIOCPKT_WINDOW..
│ │ │ │ -000494e0: 2020 2049 6620 656e 6372 7970 7469 6f6e     If encryption
│ │ │ │ -000494f0: 2069 7320 656e 6162 6c65 6420 28e2 8098   is enabled (...
│ │ │ │ -00049500: 656b 6c6f 6769 6ee2 8099 2920 7468 6520  eklogin...) the 
│ │ │ │ -00049510: 7365 7276 6572 206d 7573 7420 7365 6e64  server must send
│ │ │ │ -00049520: 2074 686f 7365 2066 6976 650a 6279 7465   those five.byte
│ │ │ │ -00049530: 7320 696e 2065 6e63 7279 7074 6564 2066  s in encrypted f
│ │ │ │ -00049540: 6f72 6d2e 0a0a 2020 2054 6865 2063 6c69  orm...   The cli
│ │ │ │ -00049550: 656e 7420 616e 7377 6572 7320 616c 696b  ent answers alik
│ │ │ │ -00049560: 6520 696e 2062 6f74 6820 7072 6f74 6f63  e in both protoc
│ │ │ │ -00049570: 6f6c 2076 6572 7369 6f6e 7320 3a0a 0a20  ol versions :.. 
│ │ │ │ -00049580: 2020 2020 275c 3337 3727 2c20 275c 3337      '\377', '\37
│ │ │ │ -00049590: 3727 2c20 2773 272c 2027 7327 2c20 2273  7', 's', 's', "s
│ │ │ │ -000495a0: 7472 7563 7420 7769 6e73 697a 6522 0a0a  truct winsize"..
│ │ │ │ -000495b0: 2020 2054 6865 2077 696e 7369 7a65 2073     The winsize s
│ │ │ │ -000495c0: 7472 7563 7475 7265 2069 7320 6669 6c6c  tructure is fill
│ │ │ │ -000495d0: 6564 2069 6e20 7769 7468 2074 6865 2073  ed in with the s
│ │ │ │ -000495e0: 6574 7469 6e67 7320 6672 6f6d 2074 6865  ettings from the
│ │ │ │ -000495f0: 0a63 6c69 656e 7427 7320 7465 726d 696e  .client's termin
│ │ │ │ -00049600: 616c 2e20 2057 6974 6820 656e 6372 7970  al.  With encryp
│ │ │ │ -00049610: 7469 6f6e 2065 6e61 626c 6564 2c20 7468  tion enabled, th
│ │ │ │ -00049620: 6973 2061 6e73 7765 7220 6d75 7374 2062  is answer must b
│ │ │ │ -00049630: 6520 7365 6e74 0a65 6e63 7279 7074 6564  e sent.encrypted
│ │ │ │ -00049640: 2e0a 0a42 2e33 2e36 2045 6e64 206f 6620  ...B.3.6 End of 
│ │ │ │ -00049650: 6175 7468 656e 7469 6361 7469 6f6e 0a2d  authentication.-
│ │ │ │ +00048dd0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 5468 6520  ----------..The 
│ │ │ │ +00048de0: 636c 6965 6e74 206e 6578 7420 7365 6e64  client next send
│ │ │ │ +00048df0: 7320 7468 7265 6520 6469 6666 6572 656e  s three differen
│ │ │ │ +00048e00: 7420 6e75 6c6c 2074 6572 6d69 6e61 7465  t null terminate
│ │ │ │ +00048e10: 6420 7374 7269 6e67 732c 2077 6974 686f  d strings, witho
│ │ │ │ +00048e20: 7574 0a6c 656e 6774 6820 3a0a 0a20 2020  ut.length :..   
│ │ │ │ +00048e30: e280 a220 7265 6d6f 7465 2075 7365 7220  ... remote user 
│ │ │ │ +00048e40: 6e61 6d65 2028 7573 6572 2069 6465 6e74  name (user ident
│ │ │ │ +00048e50: 6974 7920 6f6e 2072 656d 6f74 6520 6d61  ity on remote ma
│ │ │ │ +00048e60: 6368 696e 6529 0a20 2020 e280 a220 7465  chine).   ... te
│ │ │ │ +00048e70: 726d 696e 616c 2074 7970 6520 666f 7220  rminal type for 
│ │ │ │ +00048e80: e280 9872 6c6f 6769 6ee2 8099 206f 7220  ...rlogin... or 
│ │ │ │ +00048e90: 636f 6d6d 616e 6420 666f 7220 e280 9872  command for ...r
│ │ │ │ +00048ea0: 7368 e280 990a 2020 20e2 80a2 206c 6f63  sh....   ... loc
│ │ │ │ +00048eb0: 616c 2075 7365 7220 6e61 6d65 2028 7573  al user name (us
│ │ │ │ +00048ec0: 6572 2069 6465 6e74 6974 7920 6f6e 2063  er identity on c
│ │ │ │ +00048ed0: 6c69 656e 7420 6d61 6368 696e 6529 0a0a  lient machine)..
│ │ │ │ +00048ee0: 2020 2041 6e20 6578 616d 706c 6520 666f     An example fo
│ │ │ │ +00048ef0: 7220 e280 9872 7368 e280 9920 3a0a 0a20  r ...rsh... :.. 
│ │ │ │ +00048f00: 2020 2020 2272 6e61 6d65 5c30 220a 2020      "rname\0".  
│ │ │ │ +00048f10: 2020 2022 6361 7420 2f75 7372 2f6c 6f63     "cat /usr/loc
│ │ │ │ +00048f20: 616c 2f65 7463 2f73 6869 7368 692e 636f  al/etc/shishi.co
│ │ │ │ +00048f30: 6e66 220a 2020 2020 2022 6c6e 616d 655c  nf".     "lname\
│ │ │ │ +00048f40: 3022 0a0a 2020 2054 6865 2073 6572 7665  0"..   The serve
│ │ │ │ +00048f50: 7220 6d75 7374 206e 6578 7420 7665 7269  r must next veri
│ │ │ │ +00048f60: 6679 2074 6861 7420 7468 6520 6368 6563  fy that the chec
│ │ │ │ +00048f70: 6b73 756d 2064 656c 6976 6572 6564 2069  ksum delivered i
│ │ │ │ +00048f80: 6e20 7468 6520 4150 2d52 4551 0a61 7574  n the AP-REQ.aut
│ │ │ │ +00048f90: 6865 6e74 6963 6174 6f72 2069 7320 636f  henticator is co
│ │ │ │ +00048fa0: 7272 6563 742c 2062 7920 636f 6d70 7574  rrect, by comput
│ │ │ │ +00048fb0: 696e 6720 6120 6e65 7720 6861 7368 206c  ing a new hash l
│ │ │ │ +00048fc0: 696b 6520 7468 6520 636c 6965 6e74 2068  ike the client h
│ │ │ │ +00048fd0: 6173 0a70 7265 7669 6f75 736c 7920 646f  as.previously do
│ │ │ │ +00048fe0: 6e65 2e0a 0a20 2020 5468 6520 7365 7276  ne...   The serv
│ │ │ │ +00048ff0: 6572 206d 7573 7420 616c 736f 2076 6572  er must also ver
│ │ │ │ +00049000: 6966 7920 7468 6174 2074 6865 2072 6571  ify that the req
│ │ │ │ +00049010: 7565 7374 696e 6720 7072 696e 6369 7061  uesting principa
│ │ │ │ +00049020: 6c20 2866 6f75 6e64 2069 6e0a 4150 2d52  l (found in.AP-R
│ │ │ │ +00049030: 4551 2920 6861 7320 7468 6520 7269 6768  EQ) has the righ
│ │ │ │ +00049040: 7420 746f 206c 6f67 2069 6e20 746f 2074  t to log in to t
│ │ │ │ +00049050: 6865 2072 656d 6f74 6520 7573 6572 2061  he remote user a
│ │ │ │ +00049060: 6363 6f75 6e74 2e20 2049 6e20 7468 650a  ccount.  In the.
│ │ │ │ +00049070: e280 9862 6173 6963 e280 9920 6175 7468  ...basic... auth
│ │ │ │ +00049080: 6f72 697a 6174 696f 6e2c 2074 6869 7320  orization, this 
│ │ │ │ +00049090: 6973 2064 6f6e 6520 6279 2063 6865 636b  is done by check
│ │ │ │ +000490a0: 696e 6720 7768 6574 6865 7220 7468 6520  ing whether the 
│ │ │ │ +000490b0: 7265 6d6f 7465 2075 7365 720a 6e61 6d65  remote user.name
│ │ │ │ +000490c0: 2069 7320 6964 656e 7469 6361 6c20 746f   is identical to
│ │ │ │ +000490d0: 2074 6865 2070 7269 6e63 6970 616c 2773   the principal's
│ │ │ │ +000490e0: 206e 616d 652e 2020 5468 6520 616c 7465   name.  The alte
│ │ │ │ +000490f0: 726e 6174 6976 6520 6973 20e2 8098 6b35  rnative is ...k5
│ │ │ │ +00049100: 6c6f 6769 6ee2 8099 0a6d 6f64 652c 2077  login....mode, w
│ │ │ │ +00049110: 6869 6368 2069 7320 6469 7363 7573 7365  hich is discusse
│ │ │ │ +00049120: 6420 696e 202a 6e6f 7465 206b 6572 6265  d in *note kerbe
│ │ │ │ +00049130: 726f 7320 6175 7468 6f72 697a 6174 696f  ros authorizatio
│ │ │ │ +00049140: 6e3a 3a2e 0a0a 2020 2049 6620 616c 6c20  n::...   If all 
│ │ │ │ +00049150: 6973 2063 6f72 7265 6374 2c20 7468 6520  is correct, the 
│ │ │ │ +00049160: 7365 7276 6572 2073 656e 6473 2061 206e  server sends a n
│ │ │ │ +00049170: 756c 6c20 6279 7465 2c20 692e 652e 2c20  ull byte, i.e., 
│ │ │ │ +00049180: 616e 2065 6d70 7479 0a73 7472 696e 672c  an empty.string,
│ │ │ │ +00049190: 206f 7220 656c 7365 2061 6e20 6572 726f   or else an erro
│ │ │ │ +000491a0: 7220 6d65 7373 6167 6520 7374 7269 6e67  r message string
│ │ │ │ +000491b0: 2028 6e75 6c6c 2074 6572 6d69 6e61 7465   (null terminate
│ │ │ │ +000491c0: 6429 2e20 2054 6865 2072 656d 6f74 650a  d).  The remote.
│ │ │ │ +000491d0: 636c 6965 6e74 2072 6561 6473 2074 6865  client reads the
│ │ │ │ +000491e0: 2066 6972 7374 2062 7974 652e 2020 4966   first byte.  If
│ │ │ │ +000491f0: 2069 7420 6973 2065 7175 616c 2074 6f20   it is equal to 
│ │ │ │ +00049200: 7a65 726f 2c20 6175 7468 656e 7469 6361  zero, authentica
│ │ │ │ +00049210: 7469 6f6e 2069 730a 7375 6363 6573 7366  tion is.successf
│ │ │ │ +00049220: 756c 2061 6e64 2074 6865 2075 7365 7220  ul and the user 
│ │ │ │ +00049230: 6973 206c 6f67 6765 6420 696e 2061 7420  is logged in at 
│ │ │ │ +00049240: 7468 6520 7265 6d6f 7465 2068 6f73 742e  the remote host.
│ │ │ │ +00049250: 2020 496e 2061 6e79 206f 7468 6572 0a63    In any other.c
│ │ │ │ +00049260: 6173 652c 2074 6865 2063 6c69 656e 7420  ase, the client 
│ │ │ │ +00049270: 6861 7320 7468 6520 6572 726f 7220 6d65  has the error me
│ │ │ │ +00049280: 7373 6167 6520 6176 6169 6c61 626c 652c  ssage available,
│ │ │ │ +00049290: 2061 7320 7365 6e74 2062 7920 7468 6520   as sent by the 
│ │ │ │ +000492a0: 7365 7276 6572 2c0a 746f 2068 656c 7020  server,.to help 
│ │ │ │ +000492b0: 7468 6520 7573 6572 2075 6e64 6572 7374  the user underst
│ │ │ │ +000492c0: 616e 6420 7468 6520 6661 696c 7572 652e  and the failure.
│ │ │ │ +000492d0: 0a0a 422e 332e 3520 5769 6e64 6f77 2073  ..B.3.5 Window s
│ │ │ │ +000492e0: 697a 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ize.------------
│ │ │ │ +000492f0: 2d2d 2d2d 2d0a 0a49 6e20 7468 6520 e280  -----..In the ..
│ │ │ │ +00049300: 9872 6c6f 6769 6ee2 8099 2070 726f 746f  .rlogin... proto
│ │ │ │ +00049310: 636f 6c2c 2077 6865 6e20 6175 7468 656e  col, when authen
│ │ │ │ +00049320: 7469 6361 7469 6f6e 2063 6f6d 706c 6574  tication complet
│ │ │ │ +00049330: 6573 2c20 7468 6520 7365 7276 6572 2063  es, the server c
│ │ │ │ +00049340: 616e 0a6f 7074 696f 6e61 6c6c 7920 7365  an.optionally se
│ │ │ │ +00049350: 6e64 2061 206d 6573 7361 6765 2061 736b  nd a message ask
│ │ │ │ +00049360: 696e 6720 666f 7220 7465 726d 696e 616c  ing for terminal
│ │ │ │ +00049370: 2077 696e 646f 7720 7369 7a65 2073 7569   window size sui
│ │ │ │ +00049380: 7461 626c 6520 666f 720a 7468 6520 7573  table for.the us
│ │ │ │ +00049390: 6572 2e20 2054 6865 2063 6c69 656e 7420  er.  The client 
│ │ │ │ +000493a0: 6361 6e20 7265 7370 6f6e 642c 2062 7574  can respond, but
│ │ │ │ +000493b0: 2069 7420 6973 206e 6f74 206f 626c 6967   it is not oblig
│ │ │ │ +000493c0: 6564 2074 6f20 646f 2073 6f2e 0a0a 2020  ed to do so...  
│ │ │ │ +000493d0: 2055 6e64 6572 204b 434d 4456 302e 312c   Under KCMDV0.1,
│ │ │ │ +000493e0: 2074 6865 2073 6572 7665 7220 7365 6e64   the server send
│ │ │ │ +000493f0: 7320 6120 7369 6e67 6c65 2062 7974 652c  s a single byte,
│ │ │ │ +00049400: 2061 6e20 7572 6765 6e74 2054 4350 206d   an urgent TCP m
│ │ │ │ +00049410: 6573 7361 6765 0a28 e280 984d 5347 5f4f  essage.(...MSG_O
│ │ │ │ +00049420: 4f42 e280 9929 203a 0a0a 2020 2020 2054  OB...) :..     T
│ │ │ │ +00049430: 494f 4350 4b54 5f57 494e 444f 5720 3d20  IOCPKT_WINDOW = 
│ │ │ │ +00049440: 3078 3830 0a0a 2020 2057 6974 6820 4b43  0x80..   With KC
│ │ │ │ +00049450: 4d44 5630 2e32 2c20 7468 6520 7365 7276  MDV0.2, the serv
│ │ │ │ +00049460: 6572 2064 6f65 7320 6e6f 7420 7365 6e64  er does not send
│ │ │ │ +00049470: 2061 6e20 7572 6765 6e74 206d 6573 7361   an urgent messa
│ │ │ │ +00049480: 6765 2061 7420 616c 6c2c 2062 7574 0a77  ge at all, but.w
│ │ │ │ +00049490: 7269 7465 7320 6669 7665 2062 7974 6573  rites five bytes
│ │ │ │ +000494a0: 2074 6f20 7468 6520 736f 636b 6574 203a   to the socket :
│ │ │ │ +000494b0: 0a0a 2020 2020 2027 5c33 3737 272c 2027  ..     '\377', '
│ │ │ │ +000494c0: 5c33 3737 272c 2027 6f27 2c20 276f 272c  \377', 'o', 'o',
│ │ │ │ +000494d0: 2054 494f 4350 4b54 5f57 494e 444f 570a   TIOCPKT_WINDOW.
│ │ │ │ +000494e0: 0a20 2020 4966 2065 6e63 7279 7074 696f  .   If encryptio
│ │ │ │ +000494f0: 6e20 6973 2065 6e61 626c 6564 2028 e280  n is enabled (..
│ │ │ │ +00049500: 9865 6b6c 6f67 696e e280 9929 2074 6865  .eklogin...) the
│ │ │ │ +00049510: 2073 6572 7665 7220 6d75 7374 2073 656e   server must sen
│ │ │ │ +00049520: 6420 7468 6f73 6520 6669 7665 0a62 7974  d those five.byt
│ │ │ │ +00049530: 6573 2069 6e20 656e 6372 7970 7465 6420  es in encrypted 
│ │ │ │ +00049540: 666f 726d 2e0a 0a20 2020 5468 6520 636c  form...   The cl
│ │ │ │ +00049550: 6965 6e74 2061 6e73 7765 7273 2061 6c69  ient answers ali
│ │ │ │ +00049560: 6b65 2069 6e20 626f 7468 2070 726f 746f  ke in both proto
│ │ │ │ +00049570: 636f 6c20 7665 7273 696f 6e73 203a 0a0a  col versions :..
│ │ │ │ +00049580: 2020 2020 2027 5c33 3737 272c 2027 5c33       '\377', '\3
│ │ │ │ +00049590: 3737 272c 2027 7327 2c20 2773 272c 2022  77', 's', 's', "
│ │ │ │ +000495a0: 7374 7275 6374 2077 696e 7369 7a65 220a  struct winsize".
│ │ │ │ +000495b0: 0a20 2020 5468 6520 7769 6e73 697a 6520  .   The winsize 
│ │ │ │ +000495c0: 7374 7275 6374 7572 6520 6973 2066 696c  structure is fil
│ │ │ │ +000495d0: 6c65 6420 696e 2077 6974 6820 7468 6520  led in with the 
│ │ │ │ +000495e0: 7365 7474 696e 6773 2066 726f 6d20 7468  settings from th
│ │ │ │ +000495f0: 650a 636c 6965 6e74 2773 2074 6572 6d69  e.client's termi
│ │ │ │ +00049600: 6e61 6c2e 2020 5769 7468 2065 6e63 7279  nal.  With encry
│ │ │ │ +00049610: 7074 696f 6e20 656e 6162 6c65 642c 2074  ption enabled, t
│ │ │ │ +00049620: 6869 7320 616e 7377 6572 206d 7573 7420  his answer must 
│ │ │ │ +00049630: 6265 2073 656e 740a 656e 6372 7970 7465  be sent.encrypte
│ │ │ │ +00049640: 642e 0a0a 422e 332e 3620 456e 6420 6f66  d...B.3.6 End of
│ │ │ │ +00049650: 2061 7574 6865 6e74 6963 6174 696f 6e0a   authentication.
│ │ │ │  00049660: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -00049670: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 5468 6520  ----------..The 
│ │ │ │ -00049680: 6c65 6761 6379 2065 7863 6861 6e67 6520  legacy exchange 
│ │ │ │ -00049690: 7375 7070 6f72 7465 6420 6279 20e2 8098  supported by ...
│ │ │ │ -000496a0: 7273 68e2 8099 2061 6e64 20e2 8098 726c  rsh... and ...rl
│ │ │ │ -000496b0: 6f67 696e e280 9920 636f 6e74 696e 7565  ogin... continue
│ │ │ │ -000496c0: 7320 6672 6f6d 2074 6869 730a 706f 696e  s from this.poin
│ │ │ │ -000496d0: 7420 6f6e 7761 7264 732e 0a0a 422e 332e  t onwards...B.3.
│ │ │ │ -000496e0: 3720 456e 6372 7970 7469 6f6e 0a2d 2d2d  7 Encryption.---
│ │ │ │ -000496f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a45  -------------..E
│ │ │ │ -00049700: 6e63 7279 7074 696f 6e20 6d6f 6465 2069  ncryption mode i
│ │ │ │ -00049710: 7320 616c 7761 7973 2075 7365 6420 7768  s always used wh
│ │ │ │ -00049720: 656e 2063 6f6e 6e65 6374 696e 6720 7669  en connecting vi
│ │ │ │ -00049730: 6120 7468 6520 706f 7274 20e2 8098 656b  a the port ...ek
│ │ │ │ -00049740: 6c6f 6769 6ee2 8099 2e0a 5468 6520 706f  login.....The po
│ │ │ │ -00049750: 7274 20e2 8098 6b73 6865 6c6c e280 9920  rt ...kshell... 
│ │ │ │ -00049760: 616c 736f 2073 7570 706f 7274 7320 656e  also supports en
│ │ │ │ -00049770: 6372 7970 7469 6f6e 2e20 2050 7265 7669  cryption.  Previ
│ │ │ │ -00049780: 6f75 736c 792c 2074 6865 7265 2077 6173  ously, there was
│ │ │ │ -00049790: 2061 0a73 7065 6369 6669 6320 706f 7274   a.specific port
│ │ │ │ -000497a0: 20e2 8098 656b 7368 656c 6ce2 8099 2066   ...ekshell... f
│ │ │ │ -000497b0: 6f72 2074 6861 7420 7075 7270 6f73 652c  or that purpose,
│ │ │ │ -000497c0: 2061 2075 7365 2077 6869 6368 2069 7320   a use which is 
│ │ │ │ -000497d0: 6e6f 7720 6578 7469 6e63 742e 0a49 6e73  now extinct..Ins
│ │ │ │ -000497e0: 7465 6164 2c20 7768 656e 6576 6572 2061  tead, whenever a
│ │ │ │ -000497f0: 6e20 656e 6372 7970 7465 6420 6578 6368  n encrypted exch
│ │ │ │ -00049800: 616e 6765 2069 7320 6465 7369 7265 6420  ange is desired 
│ │ │ │ -00049810: 7669 6120 7468 6520 706f 7274 0ae2 8098  via the port....
│ │ │ │ -00049820: 6b73 6865 6c6c e280 992c 2063 6c69 656e  kshell..., clien
│ │ │ │ -00049830: 7420 6d75 7374 2070 7265 6669 7820 7468  t must prefix th
│ │ │ │ -00049840: 6520 7374 7269 6e67 2022 2d78 2022 2074  e string "-x " t
│ │ │ │ -00049850: 6f20 7468 6520 636f 6d6d 616e 6420 7374  o the command st
│ │ │ │ -00049860: 7269 6e67 2c0a 7768 656e 2069 7420 6973  ring,.when it is
│ │ │ │ -00049870: 2073 656e 7420 696e 6265 7477 6565 6e20   sent inbetween 
│ │ │ │ -00049880: 7468 6520 7265 6d6f 7465 2075 7365 7220  the remote user 
│ │ │ │ -00049890: 6e61 6d65 2061 6e64 2074 6865 206c 6f63  name and the loc
│ │ │ │ -000498a0: 616c 2075 7365 7220 6e61 6d65 2e0a 496e  al user name..In
│ │ │ │ -000498b0: 2063 6f6e 7472 6173 742c 2077 6865 6e20   contrast, when 
│ │ │ │ -000498c0: 7468 6520 636c 6965 6e74 2063 6f6d 7075  the client compu
│ │ │ │ -000498d0: 7465 7320 7468 6520 6368 6563 6b73 756d  tes the checksum
│ │ │ │ -000498e0: 2066 6f72 2074 6865 2041 502d 5245 510a   for the AP-REQ.
│ │ │ │ -000498f0: 6175 7468 656e 7469 6361 746f 722c 2074  authenticator, t
│ │ │ │ -00049900: 6865 2073 7472 696e 6720 222d 7820 2220  he string "-x " 
│ │ │ │ -00049910: 6d75 7374 206e 6f74 2062 6520 696e 636c  must not be incl
│ │ │ │ -00049920: 7564 6564 2e0a 0a20 2020 456e 6372 7970  uded...   Encryp
│ │ │ │ -00049930: 7469 6f6e 2070 6f72 6365 6475 7265 2075  tion porcedure u
│ │ │ │ -00049940: 6e64 6572 2076 6572 7369 6f6e 204b 434d  nder version KCM
│ │ │ │ -00049950: 4456 302e 3220 6469 6666 6572 7320 6672  DV0.2 differs fr
│ │ │ │ -00049960: 6f6d 2074 6861 7420 696e 2074 6865 0a6f  om that in the.o
│ │ │ │ -00049970: 6c64 6572 2070 726f 746f 636f 6c20 7665  lder protocol ve
│ │ │ │ -00049980: 7273 696f 6e2e 2020 556e 6465 7220 7665  rsion.  Under ve
│ │ │ │ -00049990: 7273 696f 6e20 4b43 4d44 5630 2e31 2c20  rsion KCMDV0.1, 
│ │ │ │ -000499a0: 7468 6520 7469 636b 6574 2073 6573 7369  the ticket sessi
│ │ │ │ -000499b0: 6f6e 206b 6579 0a69 7320 7075 7420 746f  on key.is put to
│ │ │ │ -000499c0: 2075 7365 2061 7320 656e 6372 7970 7469   use as encrypti
│ │ │ │ -000499d0: 6f6e 206b 6579 2c20 616e 6420 6f6e 6c79  on key, and only
│ │ │ │ -000499e0: 2073 7461 6e64 6172 6420 4b65 7262 6572   standard Kerber
│ │ │ │ -000499f0: 6f73 2065 6e63 7279 7074 696f 6e0a 6675  os encryption.fu
│ │ │ │ -00049a00: 6e63 7469 6f6e 7320 6172 6520 7573 6162  nctions are usab
│ │ │ │ -00049a10: 6c65 2e20 2054 6875 7320 6974 2073 7570  le.  Thus it sup
│ │ │ │ -00049a20: 706f 7274 7320 6f6e 6c79 20e2 8098 6465  ports only ...de
│ │ │ │ -00049a30: 732d 6362 632d 6372 63e2 8099 2c0a e280  s-cbc-crc...,...
│ │ │ │ -00049a40: 9864 6573 2d63 6263 2d6d 6434 e280 992c  .des-cbc-md4...,
│ │ │ │ -00049a50: 20e2 8098 6465 732d 6362 632d 6d64 35e2   ...des-cbc-md5.
│ │ │ │ -00049a60: 8099 2c20 616e 6420 646f 6573 206e 6f74  .., and does not
│ │ │ │ -00049a70: 2061 6c6c 6f77 2075 7365 206f 6620 696e   allow use of in
│ │ │ │ -00049a80: 6974 6961 6c69 7361 7469 6f6e 0a76 6563  itialisation.vec
│ │ │ │ -00049a90: 746f 7273 2e0a 0a20 2020 4173 2061 6e20  tors...   As an 
│ │ │ │ -00049aa0: 6578 616d 706c 6520 6f66 2065 6e63 7279  example of encry
│ │ │ │ -00049ab0: 7074 696f 6e2f 6465 6372 7970 7469 6f6e  ption/decryption
│ │ │ │ -00049ac0: 2063 616c 6c73 2c20 7468 6520 666f 6c6c   calls, the foll
│ │ │ │ -00049ad0: 6f77 696e 6720 4b65 7262 6572 6f73 0a66  owing Kerberos.f
│ │ │ │ -00049ae0: 756e 6374 696f 6e20 7072 6f74 6f74 7970  unction prototyp
│ │ │ │ -00049af0: 6520 7368 6f75 6c64 2062 6520 7573 6564  e should be used
│ │ │ │ -00049b00: 203a 0a0a 2020 2020 206b 6572 6265 726f   :..     kerbero
│ │ │ │ -00049b10: 735f 656e 6372 7970 7420 286b 6579 2c20  s_encrypt (key, 
│ │ │ │ -00049b20: 6b65 7975 7361 6765 2c20 696e 2c20 6f75  keyusage, in, ou
│ │ │ │ -00049b30: 7429 2020 286f 7220 6b65 7262 6572 6f73  t)  (or kerberos
│ │ │ │ -00049b40: 5f64 6563 7279 7074 290a 0a20 2020 546f  _decrypt)..   To
│ │ │ │ -00049b50: 2063 6f6e 7472 6173 742c 204b 434d 4456   contrast, KCMDV
│ │ │ │ -00049b60: 302e 3220 6361 6e20 6265 2075 7365 6420  0.2 can be used 
│ │ │ │ -00049b70: 7769 7468 2061 6c6c 204b 6572 6265 726f  with all Kerbero
│ │ │ │ -00049b80: 7320 656e 6372 7970 7469 6f6e 206d 6f64  s encryption mod
│ │ │ │ -00049b90: 6573 2c0a 692e 652e 2c20 e280 9864 6573  es,.i.e., ...des
│ │ │ │ -00049ba0: e280 992c 20e2 8098 3364 6573 e280 992c  ..., ...3des...,
│ │ │ │ -00049bb0: 20e2 8098 6165 73e2 8099 2c20 e280 9861   ...aes..., ...a
│ │ │ │ -00049bc0: 7263 666f 7572 e280 992c 2061 6e64 2069  rcfour..., and i
│ │ │ │ -00049bd0: 7420 7573 6573 2061 6e20 4150 2d52 4551  t uses an AP-REQ
│ │ │ │ -00049be0: 0a61 7574 6865 6e74 6963 6174 6f72 2073  .authenticator s
│ │ │ │ -00049bf0: 7562 6b65 792e 2020 496e 206f 7070 6f73  ubkey.  In oppos
│ │ │ │ -00049c00: 6974 696f 6e20 746f 204b 434d 4456 302e  ition to KCMDV0.
│ │ │ │ -00049c10: 312c 2069 6e69 7469 616c 6973 6174 696f  1, initialisatio
│ │ │ │ -00049c20: 6e20 7665 6374 6f72 730a 6172 6520 7573  n vectors.are us
│ │ │ │ -00049c30: 6564 2e20 2041 6c6c 2065 6e63 7279 7074  ed.  All encrypt
│ │ │ │ -00049c40: 696f 6e20 616e 6420 6465 7363 7279 7074  ion and descrypt
│ │ │ │ -00049c50: 696f 6e20 6d75 7374 2062 6520 6d61 6465  ion must be made
│ │ │ │ -00049c60: 2075 7369 6e67 2061 0a63 7279 7074 6f67   using a.cryptog
│ │ │ │ -00049c70: 7261 7068 6963 2063 6f6e 7465 7874 2e20  raphic context. 
│ │ │ │ -00049c80: 2041 2074 7970 6963 616c 2063 6f64 696e   A typical codin
│ │ │ │ -00049c90: 6720 6578 616d 706c 6520 7570 6461 7465  g example update
│ │ │ │ -00049ca0: 7320 7468 6520 636f 6e74 6578 740a 7769  s the context.wi
│ │ │ │ -00049cb0: 7468 2061 6e20 e280 9869 76e2 8099 2c20  th an ...iv..., 
│ │ │ │ -00049cc0: 7468 656e 2065 7865 6375 7465 7320 616e  then executes an
│ │ │ │ -00049cd0: 2065 6e63 7279 7074 696f 6e20 6361 6c6c   encryption call
│ │ │ │ -00049ce0: 203a 0a0a 2020 2020 206b 6572 6265 726f   :..     kerbero
│ │ │ │ -00049cf0: 735f 696e 6974 2863 7478 2c20 6976 2c20  s_init(ctx, iv, 
│ │ │ │ -00049d00: 6b65 792c 206b 6579 7573 6167 6529 0a20  key, keyusage). 
│ │ │ │ -00049d10: 2020 2020 6b65 7262 6572 6f73 5f65 6e63      kerberos_enc
│ │ │ │ -00049d20: 7279 7074 2028 6374 782c 2069 6e2c 206f  rypt (ctx, in, o
│ │ │ │ -00049d30: 7574 290a 0a20 2020 466f 7220 626f 7468  ut)..   For both
│ │ │ │ -00049d40: 2070 726f 746f 636f 6c73 2c20 6465 6661   protocols, defa
│ │ │ │ -00049d50: 756c 7420 6b65 7975 7361 6765 2069 6465  ult keyusage ide
│ │ │ │ -00049d60: 6e74 6974 7920 616c 6c6f 7769 6e67 20e2  ntity allowing .
│ │ │ │ -00049d70: 8098 6465 732d 6362 632d 6d64 35e2 8099  ..des-cbc-md5...
│ │ │ │ -00049d80: 2c0a e280 9864 6573 2d63 6263 2d6d 6434  ,....des-cbc-md4
│ │ │ │ -00049d90: e280 992c 20e2 8098 6465 732d 6362 632d  ..., ...des-cbc-
│ │ │ │ -00049da0: 6372 63e2 8099 2c20 616e 6420 e280 9864  crc..., and ...d
│ │ │ │ -00049db0: 6573 332d 6362 632d 7368 6131 e280 9920  es3-cbc-sha1... 
│ │ │ │ -00049dc0: 2874 6865 206c 6174 7465 7220 6170 706c  (the latter appl
│ │ │ │ -00049dd0: 6963 6162 6c65 0a6f 6e6c 7920 746f 204b  icable.only to K
│ │ │ │ -00049de0: 434d 4456 302e 3229 2069 7320 6964 656e  CMDV0.2) is iden
│ │ │ │ -00049df0: 7469 6361 6c20 3a0a 0a20 2020 2020 6b65  tical :..     ke
│ │ │ │ -00049e00: 7975 7361 6765 203d 2031 3032 360a 0a20  yusage = 1026.. 
│ │ │ │ -00049e10: 2020 4b43 4d44 5630 2e32 2065 6e63 7279    KCMDV0.2 encry
│ │ │ │ -00049e20: 7074 696f 6e20 6d6f 6465 732c 206f 7468  ption modes, oth
│ │ │ │ -00049e30: 6572 2074 6861 6e20 7468 6520 666f 7572  er than the four
│ │ │ │ -00049e40: 206e 616d 6564 2061 626f 7665 2c20 7370   named above, sp
│ │ │ │ -00049e50: 6563 6966 790a 6469 7374 696e 6374 2076  ecify.distinct v
│ │ │ │ -00049e60: 616c 7565 7320 666f 7220 4b45 5955 5341  alues for KEYUSA
│ │ │ │ -00049e70: 4745 2c20 756e 6971 7565 2074 6f20 6561  GE, unique to ea
│ │ │ │ -00049e80: 6368 2065 6e63 7279 7074 696f 6e2f 6465  ch encryption/de
│ │ │ │ -00049e90: 6372 7970 7469 6f6e 206d 6f64 652e 0a0a  cryption mode...
│ │ │ │ -00049ea0: 2020 2049 6e20 636f 6e63 6c75 7369 6f6e     In conclusion
│ │ │ │ -00049eb0: 2c20 e280 9865 6b6c 6f67 696e e280 9920  , ...eklogin... 
│ │ │ │ -00049ec0: 7573 6573 2061 2073 696e 676c 6520 736f  uses a single so
│ │ │ │ -00049ed0: 636b 6574 2e20 2049 7420 656e 6372 7970  cket.  It encryp
│ │ │ │ -00049ee0: 7473 2064 6174 610a 226f 7574 7075 7420  ts data."output 
│ │ │ │ -00049ef0: 3122 2070 7269 6f72 2074 6f20 7365 6e64  1" prior to send
│ │ │ │ -00049f00: 696e 672c 2061 6e64 2069 7420 6465 6372  ing, and it decr
│ │ │ │ -00049f10: 7970 7473 2022 696e 7075 7420 3122 2072  ypts "input 1" r
│ │ │ │ -00049f20: 6563 6569 7665 6420 6461 7461 2e0a 0a20  eceived data... 
│ │ │ │ -00049f30: 2020 e280 986b 7368 656c 6ce2 8099 2075    ...kshell... u
│ │ │ │ -00049f40: 7365 7320 7477 6f20 736f 636b 6574 733a  ses two sockets:
│ │ │ │ -00049f50: 206f 6e65 2066 6f72 2074 7261 6e73 6d69   one for transmi
│ │ │ │ -00049f60: 7474 696e 6720 6461 7461 2c20 616e 6420  tting data, and 
│ │ │ │ -00049f70: 6f6e 6520 666f 7220 610a 7369 6465 2063  one for a.side c
│ │ │ │ -00049f80: 6861 6e6e 656c 2063 6172 7279 696e 6720  hannel carrying 
│ │ │ │ -00049f90: e280 9873 7464 6572 72e2 8099 2e20 2054  ...stderr....  T
│ │ │ │ -00049fa0: 6875 7320 7468 6572 6520 6172 6520 666f  hus there are fo
│ │ │ │ -00049fb0: 7572 2073 7472 6561 6d73 2061 7661 696c  ur streams avail
│ │ │ │ -00049fc0: 6162 6c65 203a 0a0a 2020 2074 7261 6e73  able :..   trans
│ │ │ │ -00049fd0: 6d69 7420 203a 2069 6e70 7574 2020 310a  mit  : input  1.
│ │ │ │ -00049fe0: 0920 2020 2020 2020 6f75 7470 7574 2031  .       output 1
│ │ │ │ -00049ff0: 0a0a 2020 2073 7464 6572 7220 2020 203a  ..   stderr    :
│ │ │ │ -0004a000: 2069 6e70 7574 2020 320a 0920 2020 2020   input  2..     
│ │ │ │ -0004a010: 2020 6f75 7470 7574 2032 0a0a 2020 2054    output 2..   T
│ │ │ │ -0004a020: 6865 7265 2069 7320 6120 6b65 7920 7573  here is a key us
│ │ │ │ -0004a030: 6167 6520 7365 7420 666f 7220 6561 6368  age set for each
│ │ │ │ -0004a040: 206d 6f64 652e 2020 5468 6520 7661 6c75   mode.  The valu
│ │ │ │ -0004a050: 6573 206f 6620 6561 6368 204b 4559 5553  es of each KEYUS
│ │ │ │ -0004a060: 4147 450a 6d75 7374 2062 6520 636f 6d70  AGE.must be comp
│ │ │ │ -0004a070: 6174 6962 6c65 2062 6574 7765 656e 2063  atible between c
│ │ │ │ -0004a080: 6c69 656e 7420 616e 6420 7365 7276 6572  lient and server
│ │ │ │ -0004a090: 2073 6964 652e 0a0a 2020 2041 6e20 6578   side...   An ex
│ │ │ │ -0004a0a0: 616d 706c 6520 7769 7468 20e2 8098 6b6c  ample with ...kl
│ │ │ │ -0004a0b0: 6f67 696e e280 992c 2073 686f 7773 2074  ogin..., shows t
│ │ │ │ -0004a0c0: 6865 2063 6c69 656e 7427 7320 2269 6e70  he client's "inp
│ │ │ │ -0004a0d0: 7574 2031 2220 6b65 7920 7573 6167 6520  ut 1" key usage 
│ │ │ │ -0004a0e0: 746f 0a62 6520 6964 656e 7469 6361 6c20  to.be identical 
│ │ │ │ -0004a0f0: 746f 2074 6865 2073 6572 7665 7227 7320  to the server's 
│ │ │ │ -0004a100: 226f 7574 7075 7420 3122 2075 7361 6765  "output 1" usage
│ │ │ │ -0004a110: 2e0a 0a49 2f4f 2020 2020 2020 2020 2043  ...I/O         C
│ │ │ │ -0004a120: 6c69 656e 7420 2020 2020 2053 6572 7665  lient      Serve
│ │ │ │ -0004a130: 720a 696e 7075 7420 3120 2020 2020 3130  r.input 1     10
│ │ │ │ -0004a140: 3238 2020 2020 2020 2020 3130 3330 0a6f  28        1030.o
│ │ │ │ -0004a150: 7574 7075 7420 3120 2020 2031 3033 3020  utput 1    1030 
│ │ │ │ -0004a160: 2020 2020 2020 2031 3032 380a 696e 7075         1028.inpu
│ │ │ │ -0004a170: 7420 3220 2020 2020 3130 3332 2020 2020  t 2     1032    
│ │ │ │ -0004a180: 2020 2020 3130 3334 0a6f 7574 7075 7420      1034.output 
│ │ │ │ -0004a190: 3220 2020 2031 3033 3420 2020 2020 2020  2    1034       
│ │ │ │ -0004a1a0: 2031 3033 320a 0a20 2020 5468 6520 7374   1032..   The st
│ │ │ │ -0004a1b0: 6174 6564 206b 6579 2075 7361 6765 7320  ated key usages 
│ │ │ │ -0004a1c0: 6172 6520 666f 7220 4145 5320 616e 6420  are for AES and 
│ │ │ │ -0004a1d0: 4152 4346 4f55 5220 6d6f 6465 732e 0a0a  ARCFOUR modes...
│ │ │ │ -0004a1e0: 2020 204b 434d 4456 302e 3220 7573 6573     KCMDV0.2 uses
│ │ │ │ -0004a1f0: 2061 6e20 4956 2028 696e 6974 6961 6c69   an IV (initiali
│ │ │ │ -0004a200: 7361 7469 6f6e 2076 6563 746f 7229 2077  sation vector) w
│ │ │ │ -0004a210: 6974 6820 4145 532e 204c 696b 6520 666f  ith AES. Like fo
│ │ │ │ -0004a220: 7220 6b65 790a 7573 6167 652c 2074 6865  r key.usage, the
│ │ │ │ -0004a230: 2063 6c69 656e 7420 4956 206d 7573 7420   client IV must 
│ │ │ │ -0004a240: 636f 7272 6573 706f 6e64 2074 6f20 7468  correspond to th
│ │ │ │ -0004a250: 6520 7365 7276 6572 2049 562e 2054 6865  e server IV. The
│ │ │ │ -0004a260: 2049 5620 7369 7a65 2069 730a 6571 7561   IV size is.equa
│ │ │ │ -0004a270: 6c20 746f 2074 6865 2062 6c6f 636b 7369  l to the blocksi
│ │ │ │ -0004a280: 7a65 206f 6620 7468 6520 6368 6f73 656e  ze of the chosen
│ │ │ │ -0004a290: 206b 6579 2074 7970 652e 2020 416c 6c20   key type.  All 
│ │ │ │ -0004a2a0: 6279 7465 7320 6f66 2049 5620 6d75 7374  bytes of IV must
│ │ │ │ -0004a2b0: 2062 650a 696e 6974 6961 6c69 7365 6420   be.initialised 
│ │ │ │ -0004a2c0: 746f 6f20 3a0a 0a49 2f4f 2020 2020 2020  too :..I/O      
│ │ │ │ -0004a2d0: 2020 2043 6c69 656e 7420 2020 2020 2053     Client      S
│ │ │ │ -0004a2e0: 6572 7665 720a 696e 7075 7420 3120 2020  erver.input 1   
│ │ │ │ -0004a2f0: 2020 3020 2020 2020 2020 2020 2020 310a    0           1.
│ │ │ │ -0004a300: 6f75 7470 7574 2031 2020 2020 3120 2020  output 1    1   
│ │ │ │ -0004a310: 2020 2020 2020 2020 300a 696e 7075 7420          0.input 
│ │ │ │ -0004a320: 3220 2020 2020 3220 2020 2020 2020 2020  2     2         
│ │ │ │ -0004a330: 2020 330a 6f75 7470 7574 2032 2020 2020    3.output 2    
│ │ │ │ -0004a340: 3320 2020 2020 2020 2020 2020 320a 0a20  3           2.. 
│ │ │ │ -0004a350: 2020 4152 4346 4f55 5220 6d6f 6465 2064    ARCFOUR mode d
│ │ │ │ -0004a360: 6f65 7320 6e6f 7420 7573 6520 616e 2049  oes not use an I
│ │ │ │ -0004a370: 562e 2048 6f77 6576 6572 2c20 6c69 6b65  V. However, like
│ │ │ │ -0004a380: 206d 656e 7469 6f6e 6564 2062 6566 6f72   mentioned befor
│ │ │ │ -0004a390: 652c 2061 0a63 6f6e 7465 7874 206d 7573  e, a.context mus
│ │ │ │ -0004a3a0: 7420 6265 2075 7365 6420 746f 206b 6565  t be used to kee
│ │ │ │ -0004a3b0: 7020 7468 6520 7570 6461 7469 6e67 2074  p the updating t
│ │ │ │ -0004a3c0: 6865 2073 626f 782e 0a0a 2020 2041 206e  he sbox...   A n
│ │ │ │ -0004a3d0: 6f72 6d61 6c20 6d65 7373 6167 6520 666f  ormal message fo
│ │ │ │ -0004a3e0: 7220 e280 986b 6c6f 6769 6ee2 8099 206f  r ...klogin... o
│ │ │ │ -0004a3f0: 7220 e280 986b 7368 656c 6ce2 8099 2069  r ...kshell... i
│ │ │ │ -0004a400: 7320 7365 7420 7570 206c 696b 6520 7468  s set up like th
│ │ │ │ -0004a410: 6973 203a 0a0a 2020 2020 2028 696e 7433  is :..     (int3
│ │ │ │ -0004a420: 322d 6c65 6e67 7468 206f 6620 6d65 7373  2-length of mess
│ │ │ │ -0004a430: 6167 6520 696e 204d 5342 206f 7264 6572  age in MSB order
│ │ │ │ -0004a440: 290a 2020 2020 2028 6d65 7373 6167 6529  ).     (message)
│ │ │ │ -0004a450: 0a0a 2020 2049 6e20 656e 6372 7970 7465  ..   In encrypte
│ │ │ │ -0004a460: 6420 6d6f 6465 2c20 7468 6520 666f 726d  d mode, the form
│ │ │ │ -0004a470: 6174 2069 7320 6f6e 6c79 2073 6c69 6768  at is only sligh
│ │ │ │ -0004a480: 746c 7920 6469 6666 6572 656e 7420 3a0a  tly different :.
│ │ │ │ -0004a490: 0a20 2020 2020 2869 6e74 3332 2d6c 656e  .     (int32-len
│ │ │ │ -0004a4a0: 6774 6820 6f66 2075 6e65 6e63 7279 7074  gth of unencrypt
│ │ │ │ -0004a4b0: 6564 206d 6573 7361 6765 2069 6e20 4d53  ed message in MS
│ │ │ │ -0004a4c0: 4220 6f72 6465 7229 0a20 2020 2020 2865  B order).     (e
│ │ │ │ -0004a4d0: 6e63 7279 7074 6564 206d 6573 7361 6765  ncrypted message
│ │ │ │ -0004a4e0: 290a 0a20 2020 556e 6465 7220 4b43 4d44  )..   Under KCMD
│ │ │ │ -0004a4f0: 5630 2e32 2c20 7468 6520 656e 6372 7970  V0.2, the encryp
│ │ │ │ -0004a500: 7465 6420 6d65 7373 6167 6520 6973 2063  ted message is c
│ │ │ │ -0004a510: 7265 6174 6520 6c69 6b65 2074 6869 7320  reate like this 
│ │ │ │ -0004a520: 3a0a 0a20 2020 2020 656e 6372 7970 7420  :..     encrypt 
│ │ │ │ -0004a530: 280a 2020 2020 2028 696e 7433 322d 6c65  (.     (int32-le
│ │ │ │ -0004a540: 6e67 7468 206f 6620 6d65 7373 6167 6520  ngth of message 
│ │ │ │ -0004a550: 696e 204d 5342 206f 7264 6572 290a 2020  in MSB order).  
│ │ │ │ -0004a560: 2020 2028 6d65 7373 6167 6529 0a20 2020     (message).   
│ │ │ │ -0004a570: 2020 290a 0a20 2020 4120 6368 6563 6b20    )..   A check 
│ │ │ │ -0004a580: 6f6e 206d 6573 7361 6765 2073 697a 6520  on message size 
│ │ │ │ -0004a590: 6361 6e20 6265 206d 6164 6520 696e 2073  can be made in s
│ │ │ │ -0004a5a0: 6563 6f6e 6420 7665 7273 696f 6e20 6f66  econd version of
│ │ │ │ -0004a5b0: 2074 6865 0a70 726f 746f 636f 6c2e 0a0a   the.protocol...
│ │ │ │ -0004a5c0: 422e 332e 3820 4b43 4d44 5630 2e33 0a2d  B.3.8 KCMDV0.3.-
│ │ │ │ -0004a5d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a54  -------------..T
│ │ │ │ -0004a5e0: 6869 7320 7061 7274 206f 6e6c 7920 6769  his part only gi
│ │ │ │ -0004a5f0: 7665 7320 706f 7373 6962 6c65 2077 6179  ves possible way
│ │ │ │ -0004a600: 7320 746f 2065 7874 656e 6420 7468 6520  s to extend the 
│ │ │ │ -0004a610: 4b43 4d44 2070 726f 746f 636f 6c2e 2020  KCMD protocol.  
│ │ │ │ -0004a620: 5468 6579 0a73 686f 756c 6420 6e6f 7420  They.should not 
│ │ │ │ -0004a630: 6265 2075 6e64 6572 7374 6f6f 6420 6173  be understood as
│ │ │ │ -0004a640: 2073 6f6d 6520 6b69 6e64 206f 6620 226d   some kind of "m
│ │ │ │ -0004a650: 7573 7420 6861 7665 2220 696e 2061 2066  ust have" in a f
│ │ │ │ -0004a660: 7574 7572 6520 4b43 4d44 0a69 6d70 6c65  uture KCMD.imple
│ │ │ │ -0004a670: 6d65 6e74 6174 696f 6e2e 0a0a 2020 2045  mentation...   E
│ │ │ │ -0004a680: 7874 656e 7369 6f6e 7320 746f 204b 434d  xtensions to KCM
│ │ │ │ -0004a690: 5630 2e32 2063 616e 2062 6520 696d 6167  V0.2 can be imag
│ │ │ │ -0004a6a0: 696e 6564 2e20 2046 6f72 2065 7861 6d70  ined.  For examp
│ │ │ │ -0004a6b0: 6c65 2c20 e280 986b 7368 656c 6ce2 8099  le, ...kshell...
│ │ │ │ -0004a6c0: 2061 7373 756d 6573 0a74 6865 7265 2061   assumes.there a
│ │ │ │ -0004a6d0: 7265 206e 6f20 6669 6c65 7320 6f66 206e  re no files of n
│ │ │ │ -0004a6e0: 616d 6573 206c 696b 6520 222d 7820 2a22  ames like "-x *"
│ │ │ │ -0004a6f0: 2e20 2049 2074 6869 6e6b 2074 6865 2073  .  I think the s
│ │ │ │ -0004a700: 616d 6520 7468 696e 6720 6361 6e20 6265  ame thing can be
│ │ │ │ -0004a710: 0a61 7373 756d 6564 206f 6620 7465 726d  .assumed of term
│ │ │ │ -0004a720: 696e 616c 206e 616d 6573 2066 6f72 20e2  inal names for .
│ │ │ │ -0004a730: 8098 6b6c 6f67 696e e280 992e 2020 536f  ..klogin....  So
│ │ │ │ -0004a740: 2074 6865 2063 6c69 656e 7420 636f 756c   the client coul
│ │ │ │ -0004a750: 6420 6164 6420 222d 7820 220a 746f 2074  d add "-x ".to t
│ │ │ │ -0004a760: 6865 2074 6572 6d69 6e61 6c20 7479 7065  he terminal type
│ │ │ │ -0004a770: 2069 7420 7472 616e 736d 6974 7320 746f   it transmits to
│ │ │ │ -0004a780: 2074 6865 2073 6572 7665 722c 2069 6e20   the server, in 
│ │ │ │ -0004a790: 6f72 6465 7220 746f 2069 6e64 6963 6174  order to indicat
│ │ │ │ -0004a7a0: 650a 7468 6520 6465 7369 7265 2074 6f20  e.the desire to 
│ │ │ │ -0004a7b0: 7573 6520 656e 6372 7970 7469 6f6e 2e0a  use encryption..
│ │ │ │ -0004a7c0: 0a20 2020 556e 6465 7220 7468 6973 2070  .   Under this p
│ │ │ │ -0004a7d0: 726f 7669 7369 6f6e 2c20 7468 6572 6520  rovision, there 
│ │ │ │ -0004a7e0: 6e65 6564 206f 6e6c 7920 6265 206f 6e65  need only be one
│ │ │ │ -0004a7f0: 2070 6f72 7420 7368 6172 6564 2062 7920   port shared by 
│ │ │ │ -0004a800: e280 986b 6c6f 6769 6ee2 8099 0a61 6e64  ...klogin....and
│ │ │ │ -0004a810: 20e2 8098 656b 6c6f 6769 6ee2 8099 2c20   ...eklogin..., 
│ │ │ │ -0004a820: 6e61 6d65 6c79 2074 6865 2049 414e 4120  namely the IANA 
│ │ │ │ -0004a830: 6465 6669 6e65 6420 706f 7274 206e 756d  defined port num
│ │ │ │ -0004a840: 6265 7220 3534 332e 0a0a 2020 2042 6566  ber 543...   Bef
│ │ │ │ -0004a850: 6f72 6520 656e 6372 7970 7469 6f6e 2062  ore encryption b
│ │ │ │ -0004a860: 6567 696e 732c 20e2 8098 6b73 6865 6c6c  egins, ...kshell
│ │ │ │ -0004a870: e280 9920 7061 7373 6573 2074 6865 2069  ... passes the i
│ │ │ │ -0004a880: 6e74 656e 6465 6420 636f 6d6d 616e 6473  ntended commands
│ │ │ │ -0004a890: 2069 6e0a 7468 6520 636c 6561 7220 7468   in.the clear th
│ │ │ │ -0004a8a0: 726f 7567 6820 7468 6520 6e65 7477 6f72  rough the networ
│ │ │ │ -0004a8b0: 6b2e 2020 5468 6973 2063 6f75 6c64 2062  k.  This could b
│ │ │ │ -0004a8c0: 6520 636f 6e73 6964 6572 6564 2069 6e73  e considered ins
│ │ │ │ -0004a8d0: 6563 7572 652c 206f 6e63 650a 7468 6520  ecure, once.the 
│ │ │ │ -0004a8e0: 7573 6572 2068 6173 2064 6563 6964 6564  user has decided
│ │ │ │ -0004a8f0: 2074 6f20 7573 6520 656e 6372 7970 7469   to use encrypti
│ │ │ │ -0004a900: 6f6e 2e20 2049 7420 6973 206e 6f74 2072  on.  It is not r
│ │ │ │ -0004a910: 6561 6c6c 7920 6120 7072 6f62 6c65 6d20  eally a problem 
│ │ │ │ -0004a920: 7769 7468 0ae2 8098 6b6c 6f67 696e e280  with....klogin..
│ │ │ │ -0004a930: 992c 2062 6563 6175 7365 2069 7420 6a75  ., because it ju
│ │ │ │ -0004a940: 7374 2074 656c 6c73 2077 6869 6368 2074  st tells which t
│ │ │ │ -0004a950: 6572 6d69 6e61 6c20 7479 7065 2074 6f20  erminal type to 
│ │ │ │ -0004a960: 7461 7267 6574 2e0a 0a20 2020 4f6e 6520  target...   One 
│ │ │ │ -0004a970: 636f 756c 6420 696d 6167 696e 652c 2077  could imagine, w
│ │ │ │ -0004a980: 6865 6e20 7468 6520 636c 6965 6e74 2069  hen the client i
│ │ │ │ -0004a990: 6e74 656e 6473 2074 6f20 7573 6520 656e  ntends to use en
│ │ │ │ -0004a9a0: 6372 7970 7465 6420 6d6f 6465 2c0a 7468  crypted mode,.th
│ │ │ │ -0004a9b0: 6174 2074 6865 2063 6c69 656e 7420 7369  at the client si
│ │ │ │ -0004a9c0: 6465 2069 6e69 7469 616c 6c79 2074 7261  de initially tra
│ │ │ │ -0004a9d0: 6e73 6d69 7473 2061 206d 756e 6461 6e65  nsmits a mundane
│ │ │ │ -0004a9e0: 2022 2d78 2220 616e 6420 6e6f 7468 696e   "-x" and nothin
│ │ │ │ -0004a9f0: 6720 656c 7365 0a74 6f20 6569 7468 6572  g else.to either
│ │ │ │ -0004aa00: 206f 6620 e280 986b 6c6f 6769 6ee2 8099   of ...klogin...
│ │ │ │ -0004aa10: 2061 6e64 20e2 8098 6b73 6865 6c6c e280   and ...kshell..
│ │ │ │ -0004aa20: 992c 2069 6e20 706c 6163 6520 6f66 2065  ., in place of e
│ │ │ │ -0004aa30: 6974 6865 7220 6120 636f 6d6d 616e 6420  ither a command 
│ │ │ │ -0004aa40: 6f72 2061 0a74 6572 6d69 6e61 6c20 7479  or a.terminal ty
│ │ │ │ -0004aa50: 7065 2c20 7265 7370 6563 7469 7665 6c79  pe, respectively
│ │ │ │ -0004aa60: 2e20 204f 6e63 6520 656e 6372 7970 7469  .  Once encrypti
│ │ │ │ -0004aa70: 6f6e 2069 7320 696e 2070 6c61 6365 2c20  on is in place, 
│ │ │ │ -0004aa80: 7468 6520 636c 6965 6e74 0a63 6f75 6c64  the client.could
│ │ │ │ -0004aa90: 2073 656e 6420 7465 726d 696e 616c 2074   send terminal t
│ │ │ │ -0004aaa0: 7970 6520 6f72 2063 6f6d 6d61 6e64 2069  ype or command i
│ │ │ │ -0004aab0: 6e20 6120 7365 636f 6e64 2c20 6e6f 7720  n a second, now 
│ │ │ │ -0004aac0: 656e 6372 7970 7465 6420 6578 6368 616e  encrypted exchan
│ │ │ │ -0004aad0: 6765 2e0a 5468 6520 7365 7276 6572 2063  ge..The server c
│ │ │ │ -0004aae0: 6f75 6c64 2072 6573 706f 6e64 2077 6974  ould respond wit
│ │ │ │ -0004aaf0: 6820 6120 7369 6e67 6c65 206e 756c 6c20  h a single null 
│ │ │ │ -0004ab00: 6279 7465 2c20 7361 7969 6e67 2074 6861  byte, saying tha
│ │ │ │ -0004ab10: 7420 616c 6c20 6973 0a77 656c 6c2c 206f  t all is.well, o
│ │ │ │ -0004ab20: 7220 7265 7370 6f6e 6420 7769 7468 2061  r respond with a
│ │ │ │ -0004ab30: 6e20 6572 726f 7220 6d65 7373 6167 652c  n error message,
│ │ │ │ -0004ab40: 2077 6869 6368 2061 6c72 6561 6479 2065   which already e
│ │ │ │ -0004ab50: 6e6a 6f79 7320 7468 6520 6164 6465 640a  njoys the added.
│ │ │ │ -0004ab60: 6265 6e65 6669 7420 6f66 2062 6569 6e67  benefit of being
│ │ │ │ -0004ab70: 2065 6e63 7279 7074 6564 2e0a 0a42 2e33   encrypted...B.3
│ │ │ │ -0004ab80: 2e39 204d 4954 2f48 6569 6d64 616c 2061  .9 MIT/Heimdal a
│ │ │ │ -0004ab90: 7574 686f 7269 7a61 7469 6f6e 0a2d 2d2d  uthorization.---
│ │ │ │ +00049670: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a54 6865  -----------..The
│ │ │ │ +00049680: 206c 6567 6163 7920 6578 6368 616e 6765   legacy exchange
│ │ │ │ +00049690: 2073 7570 706f 7274 6564 2062 7920 e280   supported by ..
│ │ │ │ +000496a0: 9872 7368 e280 9920 616e 6420 e280 9872  .rsh... and ...r
│ │ │ │ +000496b0: 6c6f 6769 6ee2 8099 2063 6f6e 7469 6e75  login... continu
│ │ │ │ +000496c0: 6573 2066 726f 6d20 7468 6973 0a70 6f69  es from this.poi
│ │ │ │ +000496d0: 6e74 206f 6e77 6172 6473 2e0a 0a42 2e33  nt onwards...B.3
│ │ │ │ +000496e0: 2e37 2045 6e63 7279 7074 696f 6e0a 2d2d  .7 Encryption.--
│ │ │ │ +000496f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ +00049700: 456e 6372 7970 7469 6f6e 206d 6f64 6520  Encryption mode 
│ │ │ │ +00049710: 6973 2061 6c77 6179 7320 7573 6564 2077  is always used w
│ │ │ │ +00049720: 6865 6e20 636f 6e6e 6563 7469 6e67 2076  hen connecting v
│ │ │ │ +00049730: 6961 2074 6865 2070 6f72 7420 e280 9865  ia the port ...e
│ │ │ │ +00049740: 6b6c 6f67 696e e280 992e 0a54 6865 2070  klogin.....The p
│ │ │ │ +00049750: 6f72 7420 e280 986b 7368 656c 6ce2 8099  ort ...kshell...
│ │ │ │ +00049760: 2061 6c73 6f20 7375 7070 6f72 7473 2065   also supports e
│ │ │ │ +00049770: 6e63 7279 7074 696f 6e2e 2020 5072 6576  ncryption.  Prev
│ │ │ │ +00049780: 696f 7573 6c79 2c20 7468 6572 6520 7761  iously, there wa
│ │ │ │ +00049790: 7320 610a 7370 6563 6966 6963 2070 6f72  s a.specific por
│ │ │ │ +000497a0: 7420 e280 9865 6b73 6865 6c6c e280 9920  t ...ekshell... 
│ │ │ │ +000497b0: 666f 7220 7468 6174 2070 7572 706f 7365  for that purpose
│ │ │ │ +000497c0: 2c20 6120 7573 6520 7768 6963 6820 6973  , a use which is
│ │ │ │ +000497d0: 206e 6f77 2065 7874 696e 6374 2e0a 496e   now extinct..In
│ │ │ │ +000497e0: 7374 6561 642c 2077 6865 6e65 7665 7220  stead, whenever 
│ │ │ │ +000497f0: 616e 2065 6e63 7279 7074 6564 2065 7863  an encrypted exc
│ │ │ │ +00049800: 6861 6e67 6520 6973 2064 6573 6972 6564  hange is desired
│ │ │ │ +00049810: 2076 6961 2074 6865 2070 6f72 740a e280   via the port...
│ │ │ │ +00049820: 986b 7368 656c 6ce2 8099 2c20 636c 6965  .kshell..., clie
│ │ │ │ +00049830: 6e74 206d 7573 7420 7072 6566 6978 2074  nt must prefix t
│ │ │ │ +00049840: 6865 2073 7472 696e 6720 222d 7820 2220  he string "-x " 
│ │ │ │ +00049850: 746f 2074 6865 2063 6f6d 6d61 6e64 2073  to the command s
│ │ │ │ +00049860: 7472 696e 672c 0a77 6865 6e20 6974 2069  tring,.when it i
│ │ │ │ +00049870: 7320 7365 6e74 2069 6e62 6574 7765 656e  s sent inbetween
│ │ │ │ +00049880: 2074 6865 2072 656d 6f74 6520 7573 6572   the remote user
│ │ │ │ +00049890: 206e 616d 6520 616e 6420 7468 6520 6c6f   name and the lo
│ │ │ │ +000498a0: 6361 6c20 7573 6572 206e 616d 652e 0a49  cal user name..I
│ │ │ │ +000498b0: 6e20 636f 6e74 7261 7374 2c20 7768 656e  n contrast, when
│ │ │ │ +000498c0: 2074 6865 2063 6c69 656e 7420 636f 6d70   the client comp
│ │ │ │ +000498d0: 7574 6573 2074 6865 2063 6865 636b 7375  utes the checksu
│ │ │ │ +000498e0: 6d20 666f 7220 7468 6520 4150 2d52 4551  m for the AP-REQ
│ │ │ │ +000498f0: 0a61 7574 6865 6e74 6963 6174 6f72 2c20  .authenticator, 
│ │ │ │ +00049900: 7468 6520 7374 7269 6e67 2022 2d78 2022  the string "-x "
│ │ │ │ +00049910: 206d 7573 7420 6e6f 7420 6265 2069 6e63   must not be inc
│ │ │ │ +00049920: 6c75 6465 642e 0a0a 2020 2045 6e63 7279  luded...   Encry
│ │ │ │ +00049930: 7074 696f 6e20 706f 7263 6564 7572 6520  ption porcedure 
│ │ │ │ +00049940: 756e 6465 7220 7665 7273 696f 6e20 4b43  under version KC
│ │ │ │ +00049950: 4d44 5630 2e32 2064 6966 6665 7273 2066  MDV0.2 differs f
│ │ │ │ +00049960: 726f 6d20 7468 6174 2069 6e20 7468 650a  rom that in the.
│ │ │ │ +00049970: 6f6c 6465 7220 7072 6f74 6f63 6f6c 2076  older protocol v
│ │ │ │ +00049980: 6572 7369 6f6e 2e20 2055 6e64 6572 2076  ersion.  Under v
│ │ │ │ +00049990: 6572 7369 6f6e 204b 434d 4456 302e 312c  ersion KCMDV0.1,
│ │ │ │ +000499a0: 2074 6865 2074 6963 6b65 7420 7365 7373   the ticket sess
│ │ │ │ +000499b0: 696f 6e20 6b65 790a 6973 2070 7574 2074  ion key.is put t
│ │ │ │ +000499c0: 6f20 7573 6520 6173 2065 6e63 7279 7074  o use as encrypt
│ │ │ │ +000499d0: 696f 6e20 6b65 792c 2061 6e64 206f 6e6c  ion key, and onl
│ │ │ │ +000499e0: 7920 7374 616e 6461 7264 204b 6572 6265  y standard Kerbe
│ │ │ │ +000499f0: 726f 7320 656e 6372 7970 7469 6f6e 0a66  ros encryption.f
│ │ │ │ +00049a00: 756e 6374 696f 6e73 2061 7265 2075 7361  unctions are usa
│ │ │ │ +00049a10: 626c 652e 2020 5468 7573 2069 7420 7375  ble.  Thus it su
│ │ │ │ +00049a20: 7070 6f72 7473 206f 6e6c 7920 e280 9864  pports only ...d
│ │ │ │ +00049a30: 6573 2d63 6263 2d63 7263 e280 992c 0ae2  es-cbc-crc...,..
│ │ │ │ +00049a40: 8098 6465 732d 6362 632d 6d64 34e2 8099  ..des-cbc-md4...
│ │ │ │ +00049a50: 2c20 e280 9864 6573 2d63 6263 2d6d 6435  , ...des-cbc-md5
│ │ │ │ +00049a60: e280 992c 2061 6e64 2064 6f65 7320 6e6f  ..., and does no
│ │ │ │ +00049a70: 7420 616c 6c6f 7720 7573 6520 6f66 2069  t allow use of i
│ │ │ │ +00049a80: 6e69 7469 616c 6973 6174 696f 6e0a 7665  nitialisation.ve
│ │ │ │ +00049a90: 6374 6f72 732e 0a0a 2020 2041 7320 616e  ctors...   As an
│ │ │ │ +00049aa0: 2065 7861 6d70 6c65 206f 6620 656e 6372   example of encr
│ │ │ │ +00049ab0: 7970 7469 6f6e 2f64 6563 7279 7074 696f  yption/decryptio
│ │ │ │ +00049ac0: 6e20 6361 6c6c 732c 2074 6865 2066 6f6c  n calls, the fol
│ │ │ │ +00049ad0: 6c6f 7769 6e67 204b 6572 6265 726f 730a  lowing Kerberos.
│ │ │ │ +00049ae0: 6675 6e63 7469 6f6e 2070 726f 746f 7479  function prototy
│ │ │ │ +00049af0: 7065 2073 686f 756c 6420 6265 2075 7365  pe should be use
│ │ │ │ +00049b00: 6420 3a0a 0a20 2020 2020 6b65 7262 6572  d :..     kerber
│ │ │ │ +00049b10: 6f73 5f65 6e63 7279 7074 2028 6b65 792c  os_encrypt (key,
│ │ │ │ +00049b20: 206b 6579 7573 6167 652c 2069 6e2c 206f   keyusage, in, o
│ │ │ │ +00049b30: 7574 2920 2028 6f72 206b 6572 6265 726f  ut)  (or kerbero
│ │ │ │ +00049b40: 735f 6465 6372 7970 7429 0a0a 2020 2054  s_decrypt)..   T
│ │ │ │ +00049b50: 6f20 636f 6e74 7261 7374 2c20 4b43 4d44  o contrast, KCMD
│ │ │ │ +00049b60: 5630 2e32 2063 616e 2062 6520 7573 6564  V0.2 can be used
│ │ │ │ +00049b70: 2077 6974 6820 616c 6c20 4b65 7262 6572   with all Kerber
│ │ │ │ +00049b80: 6f73 2065 6e63 7279 7074 696f 6e20 6d6f  os encryption mo
│ │ │ │ +00049b90: 6465 732c 0a69 2e65 2e2c 20e2 8098 6465  des,.i.e., ...de
│ │ │ │ +00049ba0: 73e2 8099 2c20 e280 9833 6465 73e2 8099  s..., ...3des...
│ │ │ │ +00049bb0: 2c20 e280 9861 6573 e280 992c 20e2 8098  , ...aes..., ...
│ │ │ │ +00049bc0: 6172 6366 6f75 72e2 8099 2c20 616e 6420  arcfour..., and 
│ │ │ │ +00049bd0: 6974 2075 7365 7320 616e 2041 502d 5245  it uses an AP-RE
│ │ │ │ +00049be0: 510a 6175 7468 656e 7469 6361 746f 7220  Q.authenticator 
│ │ │ │ +00049bf0: 7375 626b 6579 2e20 2049 6e20 6f70 706f  subkey.  In oppo
│ │ │ │ +00049c00: 7369 7469 6f6e 2074 6f20 4b43 4d44 5630  sition to KCMDV0
│ │ │ │ +00049c10: 2e31 2c20 696e 6974 6961 6c69 7361 7469  .1, initialisati
│ │ │ │ +00049c20: 6f6e 2076 6563 746f 7273 0a61 7265 2075  on vectors.are u
│ │ │ │ +00049c30: 7365 642e 2020 416c 6c20 656e 6372 7970  sed.  All encryp
│ │ │ │ +00049c40: 7469 6f6e 2061 6e64 2064 6573 6372 7970  tion and descryp
│ │ │ │ +00049c50: 7469 6f6e 206d 7573 7420 6265 206d 6164  tion must be mad
│ │ │ │ +00049c60: 6520 7573 696e 6720 610a 6372 7970 746f  e using a.crypto
│ │ │ │ +00049c70: 6772 6170 6869 6320 636f 6e74 6578 742e  graphic context.
│ │ │ │ +00049c80: 2020 4120 7479 7069 6361 6c20 636f 6469    A typical codi
│ │ │ │ +00049c90: 6e67 2065 7861 6d70 6c65 2075 7064 6174  ng example updat
│ │ │ │ +00049ca0: 6573 2074 6865 2063 6f6e 7465 7874 0a77  es the context.w
│ │ │ │ +00049cb0: 6974 6820 616e 20e2 8098 6976 e280 992c  ith an ...iv...,
│ │ │ │ +00049cc0: 2074 6865 6e20 6578 6563 7574 6573 2061   then executes a
│ │ │ │ +00049cd0: 6e20 656e 6372 7970 7469 6f6e 2063 616c  n encryption cal
│ │ │ │ +00049ce0: 6c20 3a0a 0a20 2020 2020 6b65 7262 6572  l :..     kerber
│ │ │ │ +00049cf0: 6f73 5f69 6e69 7428 6374 782c 2069 762c  os_init(ctx, iv,
│ │ │ │ +00049d00: 206b 6579 2c20 6b65 7975 7361 6765 290a   key, keyusage).
│ │ │ │ +00049d10: 2020 2020 206b 6572 6265 726f 735f 656e       kerberos_en
│ │ │ │ +00049d20: 6372 7970 7420 2863 7478 2c20 696e 2c20  crypt (ctx, in, 
│ │ │ │ +00049d30: 6f75 7429 0a0a 2020 2046 6f72 2062 6f74  out)..   For bot
│ │ │ │ +00049d40: 6820 7072 6f74 6f63 6f6c 732c 2064 6566  h protocols, def
│ │ │ │ +00049d50: 6175 6c74 206b 6579 7573 6167 6520 6964  ault keyusage id
│ │ │ │ +00049d60: 656e 7469 7479 2061 6c6c 6f77 696e 6720  entity allowing 
│ │ │ │ +00049d70: e280 9864 6573 2d63 6263 2d6d 6435 e280  ...des-cbc-md5..
│ │ │ │ +00049d80: 992c 0ae2 8098 6465 732d 6362 632d 6d64  .,....des-cbc-md
│ │ │ │ +00049d90: 34e2 8099 2c20 e280 9864 6573 2d63 6263  4..., ...des-cbc
│ │ │ │ +00049da0: 2d63 7263 e280 992c 2061 6e64 20e2 8098  -crc..., and ...
│ │ │ │ +00049db0: 6465 7333 2d63 6263 2d73 6861 31e2 8099  des3-cbc-sha1...
│ │ │ │ +00049dc0: 2028 7468 6520 6c61 7474 6572 2061 7070   (the latter app
│ │ │ │ +00049dd0: 6c69 6361 626c 650a 6f6e 6c79 2074 6f20  licable.only to 
│ │ │ │ +00049de0: 4b43 4d44 5630 2e32 2920 6973 2069 6465  KCMDV0.2) is ide
│ │ │ │ +00049df0: 6e74 6963 616c 203a 0a0a 2020 2020 206b  ntical :..     k
│ │ │ │ +00049e00: 6579 7573 6167 6520 3d20 3130 3236 0a0a  eyusage = 1026..
│ │ │ │ +00049e10: 2020 204b 434d 4456 302e 3220 656e 6372     KCMDV0.2 encr
│ │ │ │ +00049e20: 7970 7469 6f6e 206d 6f64 6573 2c20 6f74  yption modes, ot
│ │ │ │ +00049e30: 6865 7220 7468 616e 2074 6865 2066 6f75  her than the fou
│ │ │ │ +00049e40: 7220 6e61 6d65 6420 6162 6f76 652c 2073  r named above, s
│ │ │ │ +00049e50: 7065 6369 6679 0a64 6973 7469 6e63 7420  pecify.distinct 
│ │ │ │ +00049e60: 7661 6c75 6573 2066 6f72 204b 4559 5553  values for KEYUS
│ │ │ │ +00049e70: 4147 452c 2075 6e69 7175 6520 746f 2065  AGE, unique to e
│ │ │ │ +00049e80: 6163 6820 656e 6372 7970 7469 6f6e 2f64  ach encryption/d
│ │ │ │ +00049e90: 6563 7279 7074 696f 6e20 6d6f 6465 2e0a  ecryption mode..
│ │ │ │ +00049ea0: 0a20 2020 496e 2063 6f6e 636c 7573 696f  .   In conclusio
│ │ │ │ +00049eb0: 6e2c 20e2 8098 656b 6c6f 6769 6ee2 8099  n, ...eklogin...
│ │ │ │ +00049ec0: 2075 7365 7320 6120 7369 6e67 6c65 2073   uses a single s
│ │ │ │ +00049ed0: 6f63 6b65 742e 2020 4974 2065 6e63 7279  ocket.  It encry
│ │ │ │ +00049ee0: 7074 7320 6461 7461 0a22 6f75 7470 7574  pts data."output
│ │ │ │ +00049ef0: 2031 2220 7072 696f 7220 746f 2073 656e   1" prior to sen
│ │ │ │ +00049f00: 6469 6e67 2c20 616e 6420 6974 2064 6563  ding, and it dec
│ │ │ │ +00049f10: 7279 7074 7320 2269 6e70 7574 2031 2220  rypts "input 1" 
│ │ │ │ +00049f20: 7265 6365 6976 6564 2064 6174 612e 0a0a  received data...
│ │ │ │ +00049f30: 2020 20e2 8098 6b73 6865 6c6c e280 9920     ...kshell... 
│ │ │ │ +00049f40: 7573 6573 2074 776f 2073 6f63 6b65 7473  uses two sockets
│ │ │ │ +00049f50: 3a20 6f6e 6520 666f 7220 7472 616e 736d  : one for transm
│ │ │ │ +00049f60: 6974 7469 6e67 2064 6174 612c 2061 6e64  itting data, and
│ │ │ │ +00049f70: 206f 6e65 2066 6f72 2061 0a73 6964 6520   one for a.side 
│ │ │ │ +00049f80: 6368 616e 6e65 6c20 6361 7272 7969 6e67  channel carrying
│ │ │ │ +00049f90: 20e2 8098 7374 6465 7272 e280 992e 2020   ...stderr....  
│ │ │ │ +00049fa0: 5468 7573 2074 6865 7265 2061 7265 2066  Thus there are f
│ │ │ │ +00049fb0: 6f75 7220 7374 7265 616d 7320 6176 6169  our streams avai
│ │ │ │ +00049fc0: 6c61 626c 6520 3a0a 0a20 2020 7472 616e  lable :..   tran
│ │ │ │ +00049fd0: 736d 6974 2020 3a20 696e 7075 7420 2031  smit  : input  1
│ │ │ │ +00049fe0: 0a09 2020 2020 2020 206f 7574 7075 7420  ..       output 
│ │ │ │ +00049ff0: 310a 0a20 2020 7374 6465 7272 2020 2020  1..   stderr    
│ │ │ │ +0004a000: 3a20 696e 7075 7420 2032 0a09 2020 2020  : input  2..    
│ │ │ │ +0004a010: 2020 206f 7574 7075 7420 320a 0a20 2020     output 2..   
│ │ │ │ +0004a020: 5468 6572 6520 6973 2061 206b 6579 2075  There is a key u
│ │ │ │ +0004a030: 7361 6765 2073 6574 2066 6f72 2065 6163  sage set for eac
│ │ │ │ +0004a040: 6820 6d6f 6465 2e20 2054 6865 2076 616c  h mode.  The val
│ │ │ │ +0004a050: 7565 7320 6f66 2065 6163 6820 4b45 5955  ues of each KEYU
│ │ │ │ +0004a060: 5341 4745 0a6d 7573 7420 6265 2063 6f6d  SAGE.must be com
│ │ │ │ +0004a070: 7061 7469 626c 6520 6265 7477 6565 6e20  patible between 
│ │ │ │ +0004a080: 636c 6965 6e74 2061 6e64 2073 6572 7665  client and serve
│ │ │ │ +0004a090: 7220 7369 6465 2e0a 0a20 2020 416e 2065  r side...   An e
│ │ │ │ +0004a0a0: 7861 6d70 6c65 2077 6974 6820 e280 986b  xample with ...k
│ │ │ │ +0004a0b0: 6c6f 6769 6ee2 8099 2c20 7368 6f77 7320  login..., shows 
│ │ │ │ +0004a0c0: 7468 6520 636c 6965 6e74 2773 2022 696e  the client's "in
│ │ │ │ +0004a0d0: 7075 7420 3122 206b 6579 2075 7361 6765  put 1" key usage
│ │ │ │ +0004a0e0: 2074 6f0a 6265 2069 6465 6e74 6963 616c   to.be identical
│ │ │ │ +0004a0f0: 2074 6f20 7468 6520 7365 7276 6572 2773   to the server's
│ │ │ │ +0004a100: 2022 6f75 7470 7574 2031 2220 7573 6167   "output 1" usag
│ │ │ │ +0004a110: 652e 0a0a 492f 4f20 2020 2020 2020 2020  e...I/O         
│ │ │ │ +0004a120: 436c 6965 6e74 2020 2020 2020 5365 7276  Client      Serv
│ │ │ │ +0004a130: 6572 0a69 6e70 7574 2031 2020 2020 2031  er.input 1     1
│ │ │ │ +0004a140: 3032 3820 2020 2020 2020 2031 3033 300a  028        1030.
│ │ │ │ +0004a150: 6f75 7470 7574 2031 2020 2020 3130 3330  output 1    1030
│ │ │ │ +0004a160: 2020 2020 2020 2020 3130 3238 0a69 6e70          1028.inp
│ │ │ │ +0004a170: 7574 2032 2020 2020 2031 3033 3220 2020  ut 2     1032   
│ │ │ │ +0004a180: 2020 2020 2031 3033 340a 6f75 7470 7574       1034.output
│ │ │ │ +0004a190: 2032 2020 2020 3130 3334 2020 2020 2020   2    1034      
│ │ │ │ +0004a1a0: 2020 3130 3332 0a0a 2020 2054 6865 2073    1032..   The s
│ │ │ │ +0004a1b0: 7461 7465 6420 6b65 7920 7573 6167 6573  tated key usages
│ │ │ │ +0004a1c0: 2061 7265 2066 6f72 2041 4553 2061 6e64   are for AES and
│ │ │ │ +0004a1d0: 2041 5243 464f 5552 206d 6f64 6573 2e0a   ARCFOUR modes..
│ │ │ │ +0004a1e0: 0a20 2020 4b43 4d44 5630 2e32 2075 7365  .   KCMDV0.2 use
│ │ │ │ +0004a1f0: 7320 616e 2049 5620 2869 6e69 7469 616c  s an IV (initial
│ │ │ │ +0004a200: 6973 6174 696f 6e20 7665 6374 6f72 2920  isation vector) 
│ │ │ │ +0004a210: 7769 7468 2041 4553 2e20 4c69 6b65 2066  with AES. Like f
│ │ │ │ +0004a220: 6f72 206b 6579 0a75 7361 6765 2c20 7468  or key.usage, th
│ │ │ │ +0004a230: 6520 636c 6965 6e74 2049 5620 6d75 7374  e client IV must
│ │ │ │ +0004a240: 2063 6f72 7265 7370 6f6e 6420 746f 2074   correspond to t
│ │ │ │ +0004a250: 6865 2073 6572 7665 7220 4956 2e20 5468  he server IV. Th
│ │ │ │ +0004a260: 6520 4956 2073 697a 6520 6973 0a65 7175  e IV size is.equ
│ │ │ │ +0004a270: 616c 2074 6f20 7468 6520 626c 6f63 6b73  al to the blocks
│ │ │ │ +0004a280: 697a 6520 6f66 2074 6865 2063 686f 7365  ize of the chose
│ │ │ │ +0004a290: 6e20 6b65 7920 7479 7065 2e20 2041 6c6c  n key type.  All
│ │ │ │ +0004a2a0: 2062 7974 6573 206f 6620 4956 206d 7573   bytes of IV mus
│ │ │ │ +0004a2b0: 7420 6265 0a69 6e69 7469 616c 6973 6564  t be.initialised
│ │ │ │ +0004a2c0: 2074 6f6f 203a 0a0a 492f 4f20 2020 2020   too :..I/O     
│ │ │ │ +0004a2d0: 2020 2020 436c 6965 6e74 2020 2020 2020      Client      
│ │ │ │ +0004a2e0: 5365 7276 6572 0a69 6e70 7574 2031 2020  Server.input 1  
│ │ │ │ +0004a2f0: 2020 2030 2020 2020 2020 2020 2020 2031     0           1
│ │ │ │ +0004a300: 0a6f 7574 7075 7420 3120 2020 2031 2020  .output 1    1  
│ │ │ │ +0004a310: 2020 2020 2020 2020 2030 0a69 6e70 7574           0.input
│ │ │ │ +0004a320: 2032 2020 2020 2032 2020 2020 2020 2020   2     2        
│ │ │ │ +0004a330: 2020 2033 0a6f 7574 7075 7420 3220 2020     3.output 2   
│ │ │ │ +0004a340: 2033 2020 2020 2020 2020 2020 2032 0a0a   3           2..
│ │ │ │ +0004a350: 2020 2041 5243 464f 5552 206d 6f64 6520     ARCFOUR mode 
│ │ │ │ +0004a360: 646f 6573 206e 6f74 2075 7365 2061 6e20  does not use an 
│ │ │ │ +0004a370: 4956 2e20 486f 7765 7665 722c 206c 696b  IV. However, lik
│ │ │ │ +0004a380: 6520 6d65 6e74 696f 6e65 6420 6265 666f  e mentioned befo
│ │ │ │ +0004a390: 7265 2c20 610a 636f 6e74 6578 7420 6d75  re, a.context mu
│ │ │ │ +0004a3a0: 7374 2062 6520 7573 6564 2074 6f20 6b65  st be used to ke
│ │ │ │ +0004a3b0: 6570 2074 6865 2075 7064 6174 696e 6720  ep the updating 
│ │ │ │ +0004a3c0: 7468 6520 7362 6f78 2e0a 0a20 2020 4120  the sbox...   A 
│ │ │ │ +0004a3d0: 6e6f 726d 616c 206d 6573 7361 6765 2066  normal message f
│ │ │ │ +0004a3e0: 6f72 20e2 8098 6b6c 6f67 696e e280 9920  or ...klogin... 
│ │ │ │ +0004a3f0: 6f72 20e2 8098 6b73 6865 6c6c e280 9920  or ...kshell... 
│ │ │ │ +0004a400: 6973 2073 6574 2075 7020 6c69 6b65 2074  is set up like t
│ │ │ │ +0004a410: 6869 7320 3a0a 0a20 2020 2020 2869 6e74  his :..     (int
│ │ │ │ +0004a420: 3332 2d6c 656e 6774 6820 6f66 206d 6573  32-length of mes
│ │ │ │ +0004a430: 7361 6765 2069 6e20 4d53 4220 6f72 6465  sage in MSB orde
│ │ │ │ +0004a440: 7229 0a20 2020 2020 286d 6573 7361 6765  r).     (message
│ │ │ │ +0004a450: 290a 0a20 2020 496e 2065 6e63 7279 7074  )..   In encrypt
│ │ │ │ +0004a460: 6564 206d 6f64 652c 2074 6865 2066 6f72  ed mode, the for
│ │ │ │ +0004a470: 6d61 7420 6973 206f 6e6c 7920 736c 6967  mat is only slig
│ │ │ │ +0004a480: 6874 6c79 2064 6966 6665 7265 6e74 203a  htly different :
│ │ │ │ +0004a490: 0a0a 2020 2020 2028 696e 7433 322d 6c65  ..     (int32-le
│ │ │ │ +0004a4a0: 6e67 7468 206f 6620 756e 656e 6372 7970  ngth of unencryp
│ │ │ │ +0004a4b0: 7465 6420 6d65 7373 6167 6520 696e 204d  ted message in M
│ │ │ │ +0004a4c0: 5342 206f 7264 6572 290a 2020 2020 2028  SB order).     (
│ │ │ │ +0004a4d0: 656e 6372 7970 7465 6420 6d65 7373 6167  encrypted messag
│ │ │ │ +0004a4e0: 6529 0a0a 2020 2055 6e64 6572 204b 434d  e)..   Under KCM
│ │ │ │ +0004a4f0: 4456 302e 322c 2074 6865 2065 6e63 7279  DV0.2, the encry
│ │ │ │ +0004a500: 7074 6564 206d 6573 7361 6765 2069 7320  pted message is 
│ │ │ │ +0004a510: 6372 6561 7465 206c 696b 6520 7468 6973  create like this
│ │ │ │ +0004a520: 203a 0a0a 2020 2020 2065 6e63 7279 7074   :..     encrypt
│ │ │ │ +0004a530: 2028 0a20 2020 2020 2869 6e74 3332 2d6c   (.     (int32-l
│ │ │ │ +0004a540: 656e 6774 6820 6f66 206d 6573 7361 6765  ength of message
│ │ │ │ +0004a550: 2069 6e20 4d53 4220 6f72 6465 7229 0a20   in MSB order). 
│ │ │ │ +0004a560: 2020 2020 286d 6573 7361 6765 290a 2020      (message).  
│ │ │ │ +0004a570: 2020 2029 0a0a 2020 2041 2063 6865 636b     )..   A check
│ │ │ │ +0004a580: 206f 6e20 6d65 7373 6167 6520 7369 7a65   on message size
│ │ │ │ +0004a590: 2063 616e 2062 6520 6d61 6465 2069 6e20   can be made in 
│ │ │ │ +0004a5a0: 7365 636f 6e64 2076 6572 7369 6f6e 206f  second version o
│ │ │ │ +0004a5b0: 6620 7468 650a 7072 6f74 6f63 6f6c 2e0a  f the.protocol..
│ │ │ │ +0004a5c0: 0a42 2e33 2e38 204b 434d 4456 302e 330a  .B.3.8 KCMDV0.3.
│ │ │ │ +0004a5d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  --------------..
│ │ │ │ +0004a5e0: 5468 6973 2070 6172 7420 6f6e 6c79 2067  This part only g
│ │ │ │ +0004a5f0: 6976 6573 2070 6f73 7369 626c 6520 7761  ives possible wa
│ │ │ │ +0004a600: 7973 2074 6f20 6578 7465 6e64 2074 6865  ys to extend the
│ │ │ │ +0004a610: 204b 434d 4420 7072 6f74 6f63 6f6c 2e20   KCMD protocol. 
│ │ │ │ +0004a620: 2054 6865 790a 7368 6f75 6c64 206e 6f74   They.should not
│ │ │ │ +0004a630: 2062 6520 756e 6465 7273 746f 6f64 2061   be understood a
│ │ │ │ +0004a640: 7320 736f 6d65 206b 696e 6420 6f66 2022  s some kind of "
│ │ │ │ +0004a650: 6d75 7374 2068 6176 6522 2069 6e20 6120  must have" in a 
│ │ │ │ +0004a660: 6675 7475 7265 204b 434d 440a 696d 706c  future KCMD.impl
│ │ │ │ +0004a670: 656d 656e 7461 7469 6f6e 2e0a 0a20 2020  ementation...   
│ │ │ │ +0004a680: 4578 7465 6e73 696f 6e73 2074 6f20 4b43  Extensions to KC
│ │ │ │ +0004a690: 4d56 302e 3220 6361 6e20 6265 2069 6d61  MV0.2 can be ima
│ │ │ │ +0004a6a0: 6769 6e65 642e 2020 466f 7220 6578 616d  gined.  For exam
│ │ │ │ +0004a6b0: 706c 652c 20e2 8098 6b73 6865 6c6c e280  ple, ...kshell..
│ │ │ │ +0004a6c0: 9920 6173 7375 6d65 730a 7468 6572 6520  . assumes.there 
│ │ │ │ +0004a6d0: 6172 6520 6e6f 2066 696c 6573 206f 6620  are no files of 
│ │ │ │ +0004a6e0: 6e61 6d65 7320 6c69 6b65 2022 2d78 202a  names like "-x *
│ │ │ │ +0004a6f0: 222e 2020 4920 7468 696e 6b20 7468 6520  ".  I think the 
│ │ │ │ +0004a700: 7361 6d65 2074 6869 6e67 2063 616e 2062  same thing can b
│ │ │ │ +0004a710: 650a 6173 7375 6d65 6420 6f66 2074 6572  e.assumed of ter
│ │ │ │ +0004a720: 6d69 6e61 6c20 6e61 6d65 7320 666f 7220  minal names for 
│ │ │ │ +0004a730: e280 986b 6c6f 6769 6ee2 8099 2e20 2053  ...klogin....  S
│ │ │ │ +0004a740: 6f20 7468 6520 636c 6965 6e74 2063 6f75  o the client cou
│ │ │ │ +0004a750: 6c64 2061 6464 2022 2d78 2022 0a74 6f20  ld add "-x ".to 
│ │ │ │ +0004a760: 7468 6520 7465 726d 696e 616c 2074 7970  the terminal typ
│ │ │ │ +0004a770: 6520 6974 2074 7261 6e73 6d69 7473 2074  e it transmits t
│ │ │ │ +0004a780: 6f20 7468 6520 7365 7276 6572 2c20 696e  o the server, in
│ │ │ │ +0004a790: 206f 7264 6572 2074 6f20 696e 6469 6361   order to indica
│ │ │ │ +0004a7a0: 7465 0a74 6865 2064 6573 6972 6520 746f  te.the desire to
│ │ │ │ +0004a7b0: 2075 7365 2065 6e63 7279 7074 696f 6e2e   use encryption.
│ │ │ │ +0004a7c0: 0a0a 2020 2055 6e64 6572 2074 6869 7320  ..   Under this 
│ │ │ │ +0004a7d0: 7072 6f76 6973 696f 6e2c 2074 6865 7265  provision, there
│ │ │ │ +0004a7e0: 206e 6565 6420 6f6e 6c79 2062 6520 6f6e   need only be on
│ │ │ │ +0004a7f0: 6520 706f 7274 2073 6861 7265 6420 6279  e port shared by
│ │ │ │ +0004a800: 20e2 8098 6b6c 6f67 696e e280 990a 616e   ...klogin....an
│ │ │ │ +0004a810: 6420 e280 9865 6b6c 6f67 696e e280 992c  d ...eklogin...,
│ │ │ │ +0004a820: 206e 616d 656c 7920 7468 6520 4941 4e41   namely the IANA
│ │ │ │ +0004a830: 2064 6566 696e 6564 2070 6f72 7420 6e75   defined port nu
│ │ │ │ +0004a840: 6d62 6572 2035 3433 2e0a 0a20 2020 4265  mber 543...   Be
│ │ │ │ +0004a850: 666f 7265 2065 6e63 7279 7074 696f 6e20  fore encryption 
│ │ │ │ +0004a860: 6265 6769 6e73 2c20 e280 986b 7368 656c  begins, ...kshel
│ │ │ │ +0004a870: 6ce2 8099 2070 6173 7365 7320 7468 6520  l... passes the 
│ │ │ │ +0004a880: 696e 7465 6e64 6564 2063 6f6d 6d61 6e64  intended command
│ │ │ │ +0004a890: 7320 696e 0a74 6865 2063 6c65 6172 2074  s in.the clear t
│ │ │ │ +0004a8a0: 6872 6f75 6768 2074 6865 206e 6574 776f  hrough the netwo
│ │ │ │ +0004a8b0: 726b 2e20 2054 6869 7320 636f 756c 6420  rk.  This could 
│ │ │ │ +0004a8c0: 6265 2063 6f6e 7369 6465 7265 6420 696e  be considered in
│ │ │ │ +0004a8d0: 7365 6375 7265 2c20 6f6e 6365 0a74 6865  secure, once.the
│ │ │ │ +0004a8e0: 2075 7365 7220 6861 7320 6465 6369 6465   user has decide
│ │ │ │ +0004a8f0: 6420 746f 2075 7365 2065 6e63 7279 7074  d to use encrypt
│ │ │ │ +0004a900: 696f 6e2e 2020 4974 2069 7320 6e6f 7420  ion.  It is not 
│ │ │ │ +0004a910: 7265 616c 6c79 2061 2070 726f 626c 656d  really a problem
│ │ │ │ +0004a920: 2077 6974 680a e280 986b 6c6f 6769 6ee2   with....klogin.
│ │ │ │ +0004a930: 8099 2c20 6265 6361 7573 6520 6974 206a  .., because it j
│ │ │ │ +0004a940: 7573 7420 7465 6c6c 7320 7768 6963 6820  ust tells which 
│ │ │ │ +0004a950: 7465 726d 696e 616c 2074 7970 6520 746f  terminal type to
│ │ │ │ +0004a960: 2074 6172 6765 742e 0a0a 2020 204f 6e65   target...   One
│ │ │ │ +0004a970: 2063 6f75 6c64 2069 6d61 6769 6e65 2c20   could imagine, 
│ │ │ │ +0004a980: 7768 656e 2074 6865 2063 6c69 656e 7420  when the client 
│ │ │ │ +0004a990: 696e 7465 6e64 7320 746f 2075 7365 2065  intends to use e
│ │ │ │ +0004a9a0: 6e63 7279 7074 6564 206d 6f64 652c 0a74  ncrypted mode,.t
│ │ │ │ +0004a9b0: 6861 7420 7468 6520 636c 6965 6e74 2073  hat the client s
│ │ │ │ +0004a9c0: 6964 6520 696e 6974 6961 6c6c 7920 7472  ide initially tr
│ │ │ │ +0004a9d0: 616e 736d 6974 7320 6120 6d75 6e64 616e  ansmits a mundan
│ │ │ │ +0004a9e0: 6520 222d 7822 2061 6e64 206e 6f74 6869  e "-x" and nothi
│ │ │ │ +0004a9f0: 6e67 2065 6c73 650a 746f 2065 6974 6865  ng else.to eithe
│ │ │ │ +0004aa00: 7220 6f66 20e2 8098 6b6c 6f67 696e e280  r of ...klogin..
│ │ │ │ +0004aa10: 9920 616e 6420 e280 986b 7368 656c 6ce2  . and ...kshell.
│ │ │ │ +0004aa20: 8099 2c20 696e 2070 6c61 6365 206f 6620  .., in place of 
│ │ │ │ +0004aa30: 6569 7468 6572 2061 2063 6f6d 6d61 6e64  either a command
│ │ │ │ +0004aa40: 206f 7220 610a 7465 726d 696e 616c 2074   or a.terminal t
│ │ │ │ +0004aa50: 7970 652c 2072 6573 7065 6374 6976 656c  ype, respectivel
│ │ │ │ +0004aa60: 792e 2020 4f6e 6365 2065 6e63 7279 7074  y.  Once encrypt
│ │ │ │ +0004aa70: 696f 6e20 6973 2069 6e20 706c 6163 652c  ion is in place,
│ │ │ │ +0004aa80: 2074 6865 2063 6c69 656e 740a 636f 756c   the client.coul
│ │ │ │ +0004aa90: 6420 7365 6e64 2074 6572 6d69 6e61 6c20  d send terminal 
│ │ │ │ +0004aaa0: 7479 7065 206f 7220 636f 6d6d 616e 6420  type or command 
│ │ │ │ +0004aab0: 696e 2061 2073 6563 6f6e 642c 206e 6f77  in a second, now
│ │ │ │ +0004aac0: 2065 6e63 7279 7074 6564 2065 7863 6861   encrypted excha
│ │ │ │ +0004aad0: 6e67 652e 0a54 6865 2073 6572 7665 7220  nge..The server 
│ │ │ │ +0004aae0: 636f 756c 6420 7265 7370 6f6e 6420 7769  could respond wi
│ │ │ │ +0004aaf0: 7468 2061 2073 696e 676c 6520 6e75 6c6c  th a single null
│ │ │ │ +0004ab00: 2062 7974 652c 2073 6179 696e 6720 7468   byte, saying th
│ │ │ │ +0004ab10: 6174 2061 6c6c 2069 730a 7765 6c6c 2c20  at all is.well, 
│ │ │ │ +0004ab20: 6f72 2072 6573 706f 6e64 2077 6974 6820  or respond with 
│ │ │ │ +0004ab30: 616e 2065 7272 6f72 206d 6573 7361 6765  an error message
│ │ │ │ +0004ab40: 2c20 7768 6963 6820 616c 7265 6164 7920  , which already 
│ │ │ │ +0004ab50: 656e 6a6f 7973 2074 6865 2061 6464 6564  enjoys the added
│ │ │ │ +0004ab60: 0a62 656e 6566 6974 206f 6620 6265 696e  .benefit of bein
│ │ │ │ +0004ab70: 6720 656e 6372 7970 7465 642e 0a0a 422e  g encrypted...B.
│ │ │ │ +0004ab80: 332e 3920 4d49 542f 4865 696d 6461 6c20  3.9 MIT/Heimdal 
│ │ │ │ +0004ab90: 6175 7468 6f72 697a 6174 696f 6e0a 2d2d  authorization.--
│ │ │ │  0004aba0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d  ----------------
│ │ │ │ -0004abb0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 5468  ------------..Th
│ │ │ │ -0004abc0: 6973 2073 686f 7274 2070 6172 7420 6465  is short part de
│ │ │ │ -0004abd0: 7363 7269 6265 7320 686f 7720 4d49 542f  scribes how MIT/
│ │ │ │ -0004abe0: 4865 696d 6461 6c20 7665 7273 696f 6e73  Heimdal versions
│ │ │ │ -0004abf0: 206f 6620 4b65 7262 6572 6f73 2035 2063   of Kerberos 5 c
│ │ │ │ -0004ac00: 6865 636b 0a61 7574 686f 7269 7a61 7469  heck.authorizati
│ │ │ │ -0004ac10: 6f6e 206f 6620 616e 7920 7573 6572 2073  on of any user s
│ │ │ │ -0004ac20: 6565 6b69 6e67 2074 6f20 6c6f 6720 696e  eeking to log in
│ │ │ │ -0004ac30: 2074 6f20 6120 7265 6d6f 7465 206d 6163   to a remote mac
│ │ │ │ -0004ac40: 6869 6e65 2e0a 0a20 2020 5468 6520 6175  hine...   The au
│ │ │ │ -0004ac50: 7468 6f72 697a 6174 696f 6e20 7374 6167  thorization stag
│ │ │ │ -0004ac60: 6520 6265 6769 6e73 2062 7920 7465 7374  e begins by test
│ │ │ │ -0004ac70: 696e 6720 7768 6574 6865 7220 7468 6520  ing whether the 
│ │ │ │ -0004ac80: 6669 6c65 20e2 8098 2e6b 356c 6f67 696e  file ....k5login
│ │ │ │ -0004ac90: e280 990a 6578 6973 7473 2069 6e20 7468  ....exists in th
│ │ │ │ -0004aca0: 6520 686f 6d65 2064 6972 6563 746f 7279  e home directory
│ │ │ │ -0004acb0: 206f 6620 7468 6520 7265 6d6f 7465 2075   of the remote u
│ │ │ │ -0004acc0: 7365 722e 2020 4966 2074 6869 7320 6669  ser.  If this fi
│ │ │ │ -0004acd0: 6c65 2064 6f65 7320 6e6f 740a 6578 6973  le does not.exis
│ │ │ │ -0004ace0: 742c 2074 6865 6e20 6120 7661 6c69 6420  t, then a valid 
│ │ │ │ -0004acf0: 6175 7468 6f72 697a 6174 696f 6e20 6465  authorization de
│ │ │ │ -0004ad00: 6d61 6e64 7320 7468 6174 2074 6865 2072  mands that the r
│ │ │ │ -0004ad10: 656d 6f74 6520 7573 6572 2773 206e 616d  emote user's nam
│ │ │ │ -0004ad20: 650a 6d75 7374 2062 6520 7468 6520 7361  e.must be the sa
│ │ │ │ -0004ad30: 6d65 2061 7320 7468 6520 6e61 6d65 206f  me as the name o
│ │ │ │ -0004ad40: 6620 7468 6520 7072 696e 6369 7061 6c20  f the principal 
│ │ │ │ -0004ad50: 636f 6e74 6169 6e65 6420 696e 2074 6865  contained in the
│ │ │ │ -0004ad60: 2072 6571 7565 7374 0a41 502d 5245 512e   request.AP-REQ.
│ │ │ │ -0004ad70: 2020 2854 6869 7320 6973 2074 6865 206c    (This is the l
│ │ │ │ -0004ad80: 6567 6163 7920 e280 9862 6173 6963 e280  egacy ...basic..
│ │ │ │ -0004ad90: 9920 6175 7468 6f72 697a 6174 696f 6e2e  . authorization.
│ │ │ │ -0004ada0: 2920 2045 6c73 652c 2069 6620 7468 6520  )  Else, if the 
│ │ │ │ -0004adb0: 6669 6c65 0a69 7320 7072 6573 656e 742c  file.is present,
│ │ │ │ -0004adc0: 2074 6865 2073 6572 7665 2066 6972 7374   the serve first
│ │ │ │ -0004add0: 2076 6572 6966 6965 7320 7468 6174 2074   verifies that t
│ │ │ │ -0004ade0: 6865 2072 656d 6f74 6520 7573 6572 2c20  he remote user, 
│ │ │ │ -0004adf0: 6f72 2072 6f6f 742c 2069 730a 7468 6520  or root, is.the 
│ │ │ │ -0004ae00: 6f77 6e65 7220 6f66 20e2 8098 2e6b 356c  owner of ....k5l
│ │ │ │ -0004ae10: 6f67 696e e280 992c 2074 6865 6e20 676f  ogin..., then go
│ │ │ │ -0004ae20: 6573 206f 6e20 746f 2076 6572 6966 7920  es on to verify 
│ │ │ │ -0004ae30: 7468 6174 2074 6865 2066 696c 6520 6973  that the file is
│ │ │ │ -0004ae40: 206e 6f74 0a72 6561 6461 626c 6520 6279   not.readable by
│ │ │ │ -0004ae50: 2067 726f 7570 2c20 6e6f 7220 6279 2077   group, nor by w
│ │ │ │ -0004ae60: 6f72 6c64 2e20 2049 6620 6569 7468 6572  orld.  If either
│ │ │ │ -0004ae70: 2066 6169 6c73 2c20 7468 656e 2074 6865   fails, then the
│ │ │ │ -0004ae80: 2063 6865 636b 2066 6169 6c73 0a65 6e74   check fails.ent
│ │ │ │ -0004ae90: 6972 656c 792e 0a0a 2020 2049 6620 616c  irely...   If al
│ │ │ │ -0004aea0: 6c20 6973 2067 6f6f 6420 736f 2066 6172  l is good so far
│ │ │ │ -0004aeb0: 2c20 7468 656e 2065 6163 6820 6c69 6e65  , then each line
│ │ │ │ -0004aec0: 206f 6620 7468 6174 2066 696c 6520 6973   of that file is
│ │ │ │ -0004aed0: 2065 7861 6d69 6e65 642c 2061 6e64 0a65   examined, and.e
│ │ │ │ -0004aee0: 6163 6820 6e61 6d65 2072 6561 6420 696e  ach name read in
│ │ │ │ -0004aef0: 2069 7320 636f 6d70 6172 6564 2074 6f20   is compared to 
│ │ │ │ -0004af00: 7468 6520 7072 696e 6369 7061 6c2e 2020  the principal.  
│ │ │ │ -0004af10: 4966 2074 6865 2070 7269 6e63 6970 616c  If the principal
│ │ │ │ -0004af20: 2069 730a 666f 756e 6420 6c69 7374 6564   is.found listed
│ │ │ │ -0004af30: 2073 6f6d 6577 6865 7265 2069 6e20 e280   somewhere in ..
│ │ │ │ -0004af40: 982e 6b35 6c6f 6769 6ee2 8099 2c20 7468  ..k5login..., th
│ │ │ │ -0004af50: 656e 2061 7574 686f 7269 7a61 7469 6f6e  en authorization
│ │ │ │ -0004af60: 2069 7320 7375 6363 6573 7366 756c 2e0a   is successful..
│ │ │ │ -0004af70: 496e 2074 6865 2063 6f6e 7472 6172 7920  In the contrary 
│ │ │ │ -0004af80: 6361 7365 2c20 7468 6520 7573 6572 2069  case, the user i
│ │ │ │ -0004af90: 7320 6e6f 7420 6164 6d69 7474 6564 2074  s not admitted t
│ │ │ │ -0004afa0: 6f20 7468 6520 7265 6d6f 7465 2068 6f73  o the remote hos
│ │ │ │ -0004afb0: 7420 6173 2074 6865 0a72 6571 7565 7374  t as the.request
│ │ │ │ -0004afc0: 6564 2072 656d 6f74 6520 7573 6572 2c20  ed remote user, 
│ │ │ │ -0004afd0: 6120 6e61 6d65 2074 6861 7420 636f 756c  a name that coul
│ │ │ │ -0004afe0: 6420 6861 7665 2062 6565 6e20 6465 7269  d have been deri
│ │ │ │ -0004aff0: 7665 6420 746f 2062 6520 7468 650a 7665  ved to be the.ve
│ │ │ │ -0004b000: 7279 2073 616d 6520 6173 2069 6e20 7468  ry same as in th
│ │ │ │ -0004b010: 6520 7072 696e 6369 7061 6c20 6974 7365  e principal itse
│ │ │ │ -0004b020: 6c66 2e0a 0a20 2020 536f 2073 6f6d 656f  lf...   So someo
│ │ │ │ -0004b030: 6e65 2c20 2275 7365 7231 2220 7361 792c  ne, "user1" say,
│ │ │ │ -0004b040: 2063 616e 2072 656d 6f74 656c 7920 6c6f   can remotely lo
│ │ │ │ -0004b050: 6720 696e 2074 6f20 7468 6520 6163 636f  g in to the acco
│ │ │ │ -0004b060: 756e 7420 6f66 0a22 7573 6572 3222 2c20  unt of."user2", 
│ │ │ │ -0004b070: 6966 2074 6865 2066 696c 6520 e280 982e  if the file ....
│ │ │ │ -0004b080: 6b35 6c6f 6769 6ee2 8099 2069 7320 7072  k5login... is pr
│ │ │ │ -0004b090: 6573 656e 7420 696e 2074 6865 2068 6f6d  esent in the hom
│ │ │ │ -0004b0a0: 6520 6469 7265 6374 6f72 7920 6f66 0a22  e directory of."
│ │ │ │ -0004b0b0: 7573 6572 3222 2c20 616e 6420 6974 2069  user2", and it i
│ │ │ │ -0004b0c0: 7320 6f77 6e65 6420 6279 2022 7573 6572  s owned by "user
│ │ │ │ -0004b0d0: 3222 206f 7220 6279 2072 6f6f 742c 2061  2" or by root, a
│ │ │ │ -0004b0e0: 6e64 2061 7420 7468 6520 7361 6d65 2074  nd at the same t
│ │ │ │ -0004b0f0: 696d 6520 7468 650a 6e61 6d65 2022 7573  ime the.name "us
│ │ │ │ -0004b100: 6572 3122 2069 7320 6c69 7374 6564 2069  er1" is listed i
│ │ │ │ -0004b110: 6e20 7468 6973 2066 696c 652e 0a0a       n this file...
│ │ │ │ +0004abb0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a54  -------------..T
│ │ │ │ +0004abc0: 6869 7320 7368 6f72 7420 7061 7274 2064  his short part d
│ │ │ │ +0004abd0: 6573 6372 6962 6573 2068 6f77 204d 4954  escribes how MIT
│ │ │ │ +0004abe0: 2f48 6569 6d64 616c 2076 6572 7369 6f6e  /Heimdal version
│ │ │ │ +0004abf0: 7320 6f66 204b 6572 6265 726f 7320 3520  s of Kerberos 5 
│ │ │ │ +0004ac00: 6368 6563 6b0a 6175 7468 6f72 697a 6174  check.authorizat
│ │ │ │ +0004ac10: 696f 6e20 6f66 2061 6e79 2075 7365 7220  ion of any user 
│ │ │ │ +0004ac20: 7365 656b 696e 6720 746f 206c 6f67 2069  seeking to log i
│ │ │ │ +0004ac30: 6e20 746f 2061 2072 656d 6f74 6520 6d61  n to a remote ma
│ │ │ │ +0004ac40: 6368 696e 652e 0a0a 2020 2054 6865 2061  chine...   The a
│ │ │ │ +0004ac50: 7574 686f 7269 7a61 7469 6f6e 2073 7461  uthorization sta
│ │ │ │ +0004ac60: 6765 2062 6567 696e 7320 6279 2074 6573  ge begins by tes
│ │ │ │ +0004ac70: 7469 6e67 2077 6865 7468 6572 2074 6865  ting whether the
│ │ │ │ +0004ac80: 2066 696c 6520 e280 982e 6b35 6c6f 6769   file ....k5logi
│ │ │ │ +0004ac90: 6ee2 8099 0a65 7869 7374 7320 696e 2074  n....exists in t
│ │ │ │ +0004aca0: 6865 2068 6f6d 6520 6469 7265 6374 6f72  he home director
│ │ │ │ +0004acb0: 7920 6f66 2074 6865 2072 656d 6f74 6520  y of the remote 
│ │ │ │ +0004acc0: 7573 6572 2e20 2049 6620 7468 6973 2066  user.  If this f
│ │ │ │ +0004acd0: 696c 6520 646f 6573 206e 6f74 0a65 7869  ile does not.exi
│ │ │ │ +0004ace0: 7374 2c20 7468 656e 2061 2076 616c 6964  st, then a valid
│ │ │ │ +0004acf0: 2061 7574 686f 7269 7a61 7469 6f6e 2064   authorization d
│ │ │ │ +0004ad00: 656d 616e 6473 2074 6861 7420 7468 6520  emands that the 
│ │ │ │ +0004ad10: 7265 6d6f 7465 2075 7365 7227 7320 6e61  remote user's na
│ │ │ │ +0004ad20: 6d65 0a6d 7573 7420 6265 2074 6865 2073  me.must be the s
│ │ │ │ +0004ad30: 616d 6520 6173 2074 6865 206e 616d 6520  ame as the name 
│ │ │ │ +0004ad40: 6f66 2074 6865 2070 7269 6e63 6970 616c  of the principal
│ │ │ │ +0004ad50: 2063 6f6e 7461 696e 6564 2069 6e20 7468   contained in th
│ │ │ │ +0004ad60: 6520 7265 7175 6573 740a 4150 2d52 4551  e request.AP-REQ
│ │ │ │ +0004ad70: 2e20 2028 5468 6973 2069 7320 7468 6520  .  (This is the 
│ │ │ │ +0004ad80: 6c65 6761 6379 20e2 8098 6261 7369 63e2  legacy ...basic.
│ │ │ │ +0004ad90: 8099 2061 7574 686f 7269 7a61 7469 6f6e  .. authorization
│ │ │ │ +0004ada0: 2e29 2020 456c 7365 2c20 6966 2074 6865  .)  Else, if the
│ │ │ │ +0004adb0: 2066 696c 650a 6973 2070 7265 7365 6e74   file.is present
│ │ │ │ +0004adc0: 2c20 7468 6520 7365 7276 6520 6669 7273  , the serve firs
│ │ │ │ +0004add0: 7420 7665 7269 6669 6573 2074 6861 7420  t verifies that 
│ │ │ │ +0004ade0: 7468 6520 7265 6d6f 7465 2075 7365 722c  the remote user,
│ │ │ │ +0004adf0: 206f 7220 726f 6f74 2c20 6973 0a74 6865   or root, is.the
│ │ │ │ +0004ae00: 206f 776e 6572 206f 6620 e280 982e 6b35   owner of ....k5
│ │ │ │ +0004ae10: 6c6f 6769 6ee2 8099 2c20 7468 656e 2067  login..., then g
│ │ │ │ +0004ae20: 6f65 7320 6f6e 2074 6f20 7665 7269 6679  oes on to verify
│ │ │ │ +0004ae30: 2074 6861 7420 7468 6520 6669 6c65 2069   that the file i
│ │ │ │ +0004ae40: 7320 6e6f 740a 7265 6164 6162 6c65 2062  s not.readable b
│ │ │ │ +0004ae50: 7920 6772 6f75 702c 206e 6f72 2062 7920  y group, nor by 
│ │ │ │ +0004ae60: 776f 726c 642e 2020 4966 2065 6974 6865  world.  If eithe
│ │ │ │ +0004ae70: 7220 6661 696c 732c 2074 6865 6e20 7468  r fails, then th
│ │ │ │ +0004ae80: 6520 6368 6563 6b20 6661 696c 730a 656e  e check fails.en
│ │ │ │ +0004ae90: 7469 7265 6c79 2e0a 0a20 2020 4966 2061  tirely...   If a
│ │ │ │ +0004aea0: 6c6c 2069 7320 676f 6f64 2073 6f20 6661  ll is good so fa
│ │ │ │ +0004aeb0: 722c 2074 6865 6e20 6561 6368 206c 696e  r, then each lin
│ │ │ │ +0004aec0: 6520 6f66 2074 6861 7420 6669 6c65 2069  e of that file i
│ │ │ │ +0004aed0: 7320 6578 616d 696e 6564 2c20 616e 640a  s examined, and.
│ │ │ │ +0004aee0: 6561 6368 206e 616d 6520 7265 6164 2069  each name read i
│ │ │ │ +0004aef0: 6e20 6973 2063 6f6d 7061 7265 6420 746f  n is compared to
│ │ │ │ +0004af00: 2074 6865 2070 7269 6e63 6970 616c 2e20   the principal. 
│ │ │ │ +0004af10: 2049 6620 7468 6520 7072 696e 6369 7061   If the principa
│ │ │ │ +0004af20: 6c20 6973 0a66 6f75 6e64 206c 6973 7465  l is.found liste
│ │ │ │ +0004af30: 6420 736f 6d65 7768 6572 6520 696e 20e2  d somewhere in .
│ │ │ │ +0004af40: 8098 2e6b 356c 6f67 696e e280 992c 2074  ...k5login..., t
│ │ │ │ +0004af50: 6865 6e20 6175 7468 6f72 697a 6174 696f  hen authorizatio
│ │ │ │ +0004af60: 6e20 6973 2073 7563 6365 7373 6675 6c2e  n is successful.
│ │ │ │ +0004af70: 0a49 6e20 7468 6520 636f 6e74 7261 7279  .In the contrary
│ │ │ │ +0004af80: 2063 6173 652c 2074 6865 2075 7365 7220   case, the user 
│ │ │ │ +0004af90: 6973 206e 6f74 2061 646d 6974 7465 6420  is not admitted 
│ │ │ │ +0004afa0: 746f 2074 6865 2072 656d 6f74 6520 686f  to the remote ho
│ │ │ │ +0004afb0: 7374 2061 7320 7468 650a 7265 7175 6573  st as the.reques
│ │ │ │ +0004afc0: 7465 6420 7265 6d6f 7465 2075 7365 722c  ted remote user,
│ │ │ │ +0004afd0: 2061 206e 616d 6520 7468 6174 2063 6f75   a name that cou
│ │ │ │ +0004afe0: 6c64 2068 6176 6520 6265 656e 2064 6572  ld have been der
│ │ │ │ +0004aff0: 6976 6564 2074 6f20 6265 2074 6865 0a76  ived to be the.v
│ │ │ │ +0004b000: 6572 7920 7361 6d65 2061 7320 696e 2074  ery same as in t
│ │ │ │ +0004b010: 6865 2070 7269 6e63 6970 616c 2069 7473  he principal its
│ │ │ │ +0004b020: 656c 662e 0a0a 2020 2053 6f20 736f 6d65  elf...   So some
│ │ │ │ +0004b030: 6f6e 652c 2022 7573 6572 3122 2073 6179  one, "user1" say
│ │ │ │ +0004b040: 2c20 6361 6e20 7265 6d6f 7465 6c79 206c  , can remotely l
│ │ │ │ +0004b050: 6f67 2069 6e20 746f 2074 6865 2061 6363  og in to the acc
│ │ │ │ +0004b060: 6f75 6e74 206f 660a 2275 7365 7232 222c  ount of."user2",
│ │ │ │ +0004b070: 2069 6620 7468 6520 6669 6c65 20e2 8098   if the file ...
│ │ │ │ +0004b080: 2e6b 356c 6f67 696e e280 9920 6973 2070  .k5login... is p
│ │ │ │ +0004b090: 7265 7365 6e74 2069 6e20 7468 6520 686f  resent in the ho
│ │ │ │ +0004b0a0: 6d65 2064 6972 6563 746f 7279 206f 660a  me directory of.
│ │ │ │ +0004b0b0: 2275 7365 7232 222c 2061 6e64 2069 7420  "user2", and it 
│ │ │ │ +0004b0c0: 6973 206f 776e 6564 2062 7920 2275 7365  is owned by "use
│ │ │ │ +0004b0d0: 7232 2220 6f72 2062 7920 726f 6f74 2c20  r2" or by root, 
│ │ │ │ +0004b0e0: 616e 6420 6174 2074 6865 2073 616d 6520  and at the same 
│ │ │ │ +0004b0f0: 7469 6d65 2074 6865 0a6e 616d 6520 2275  time the.name "u
│ │ │ │ +0004b100: 7365 7231 2220 6973 206c 6973 7465 6420  ser1" is listed 
│ │ │ │ +0004b110: 696e 2074 6869 7320 6669 6c65 2e0a 0a    in this file...
│ │ ├── ./usr/share/info/shishi.info-3.gz
│ │ │ ├── shishi.info-3
│ │ │ │ @@ -1,7990 +1,7990 @@
│ │ │ │  00000000: 5468 6973 2069 7320 7368 6973 6869 2e69  This is shishi.i
│ │ │ │  00000010: 6e66 6f2c 2070 726f 6475 6365 6420 6279  nfo, produced by
│ │ │ │  00000020: 206d 616b 6569 6e66 6f20 7665 7273 696f   makeinfo versio
│ │ │ │  00000030: 6e20 372e 3220 6672 6f6d 2073 6869 7368  n 7.2 from shish
│ │ │ │  00000040: 692e 7465 7869 2e0a 0a54 6869 7320 6d61  i.texi...This ma
│ │ │ │  00000050: 6e75 616c 2069 7320 6c61 7374 2075 7064  nual is last upd
│ │ │ │ -00000060: 6174 6564 2038 204d 6172 6368 2032 3032  ated 8 March 202
│ │ │ │ -00000070: 3620 666f 7220 7665 7273 696f 6e20 312e  6 for version 1.
│ │ │ │ -00000080: 302e 3320 6f66 2053 6869 7368 692e 0a0a  0.3 of Shishi...
│ │ │ │ -00000090: 2020 2043 6f70 7972 6967 6874 20c2 a920     Copyright .. 
│ │ │ │ -000000a0: 3230 3032 2d32 3032 3220 5369 6d6f 6e20  2002-2022 Simon 
│ │ │ │ -000000b0: 4a6f 7365 6673 736f 6e2e 0a0a 2020 2020  Josefsson...    
│ │ │ │ -000000c0: 2050 6572 6d69 7373 696f 6e20 6973 2067   Permission is g
│ │ │ │ -000000d0: 7261 6e74 6564 2074 6f20 636f 7079 2c20  ranted to copy, 
│ │ │ │ -000000e0: 6469 7374 7269 6275 7465 2061 6e64 2f6f  distribute and/o
│ │ │ │ -000000f0: 7220 6d6f 6469 6679 2074 6869 730a 2020  r modify this.  
│ │ │ │ -00000100: 2020 2064 6f63 756d 656e 7420 756e 6465     document unde
│ │ │ │ -00000110: 7220 7468 6520 7465 726d 7320 6f66 2074  r the terms of t
│ │ │ │ -00000120: 6865 2047 4e55 2046 7265 6520 446f 6375  he GNU Free Docu
│ │ │ │ -00000130: 6d65 6e74 6174 696f 6e20 4c69 6365 6e73  mentation Licens
│ │ │ │ -00000140: 652c 0a20 2020 2020 5665 7273 696f 6e20  e,.     Version 
│ │ │ │ -00000150: 312e 3320 6f72 2061 6e79 206c 6174 6572  1.3 or any later
│ │ │ │ -00000160: 2076 6572 7369 6f6e 2070 7562 6c69 7368   version publish
│ │ │ │ -00000170: 6564 2062 7920 7468 6520 4672 6565 2053  ed by the Free S
│ │ │ │ -00000180: 6f66 7477 6172 650a 2020 2020 2046 6f75  oftware.     Fou
│ │ │ │ -00000190: 6e64 6174 696f 6e3b 2077 6974 6820 6e6f  ndation; with no
│ │ │ │ -000001a0: 2049 6e76 6172 6961 6e74 2053 6563 7469   Invariant Secti
│ │ │ │ -000001b0: 6f6e 732c 206e 6f20 4672 6f6e 742d 436f  ons, no Front-Co
│ │ │ │ -000001c0: 7665 7220 5465 7874 732c 2061 6e64 0a20  ver Texts, and. 
│ │ │ │ -000001d0: 2020 2020 6e6f 2042 6163 6b2d 436f 7665      no Back-Cove
│ │ │ │ -000001e0: 7220 5465 7874 732e 2020 4120 636f 7079  r Texts.  A copy
│ │ │ │ -000001f0: 206f 6620 7468 6520 6c69 6365 6e73 6520   of the license 
│ │ │ │ -00000200: 6973 2069 6e63 6c75 6465 6420 696e 2074  is included in t
│ │ │ │ -00000210: 6865 0a20 2020 2020 7365 6374 696f 6e20  he.     section 
│ │ │ │ -00000220: 656e 7469 746c 6564 2022 474e 5520 4672  entitled "GNU Fr
│ │ │ │ -00000230: 6565 2044 6f63 756d 656e 7461 7469 6f6e  ee Documentation
│ │ │ │ -00000240: 204c 6963 656e 7365 222e 0a49 4e46 4f2d   License"..INFO-
│ │ │ │ -00000250: 4449 522d 5345 4354 494f 4e20 474e 5520  DIR-SECTION GNU 
│ │ │ │ -00000260: 7574 696c 6974 6965 730a 5354 4152 542d  utilities.START-
│ │ │ │ -00000270: 494e 464f 2d44 4952 2d45 4e54 5259 0a2a  INFO-DIR-ENTRY.*
│ │ │ │ -00000280: 2073 6869 7368 693a 2028 7368 6973 6869   shishi: (shishi
│ │ │ │ -00000290: 292e 0909 4120 4b65 7262 6572 6f73 2035  )...A Kerberos 5
│ │ │ │ -000002a0: 2069 6d70 6c65 6d65 6e74 6174 696f 6e0a   implementation.
│ │ │ │ -000002b0: 454e 442d 494e 464f 2d44 4952 2d45 4e54  END-INFO-DIR-ENT
│ │ │ │ -000002c0: 5259 0a0a 494e 464f 2d44 4952 2d53 4543  RY..INFO-DIR-SEC
│ │ │ │ -000002d0: 5449 4f4e 2047 4e55 204c 6962 7261 7269  TION GNU Librari
│ │ │ │ -000002e0: 6573 0a53 5441 5254 2d49 4e46 4f2d 4449  es.START-INFO-DI
│ │ │ │ -000002f0: 522d 454e 5452 590a 2a20 6c69 6273 6869  R-ENTRY.* libshi
│ │ │ │ -00000300: 7368 693a 2028 7368 6973 6869 292e 0909  shi: (shishi)...
│ │ │ │ -00000310: 4c69 6272 6172 7920 696d 706c 656d 656e  Library implemen
│ │ │ │ -00000320: 7469 6e67 204b 6572 6265 726f 7320 352e  ting Kerberos 5.
│ │ │ │ -00000330: 0a45 4e44 2d49 4e46 4f2d 4449 522d 454e  .END-INFO-DIR-EN
│ │ │ │ -00000340: 5452 590a 0a1f 0a46 696c 653a 2073 6869  TRY....File: shi
│ │ │ │ -00000350: 7368 692e 696e 666f 2c20 204e 6f64 653a  shi.info,  Node:
│ │ │ │ -00000360: 204b 6579 2061 7320 696e 6974 6961 6c69   Key as initiali
│ │ │ │ -00000370: 7a61 7469 6f6e 2076 6563 746f 722c 2020  zation vector,  
│ │ │ │ -00000380: 4e65 7874 3a20 5468 6520 4b65 7974 6162  Next: The Keytab
│ │ │ │ -00000390: 2042 696e 6172 7920 4669 6c65 2046 6f72   Binary File For
│ │ │ │ -000003a0: 6d61 742c 2020 5072 6576 3a20 4b65 7262  mat,  Prev: Kerb
│ │ │ │ -000003b0: 6572 697a 6564 2072 7368 2061 6e64 2072  erized rsh and r
│ │ │ │ -000003c0: 6c6f 6769 6e2c 2020 5570 3a20 5072 6f74  login,  Up: Prot
│ │ │ │ -000003d0: 6f63 6f6c 2045 7874 656e 7369 6f6e 730a  ocol Extensions.
│ │ │ │ -000003e0: 0a42 2e34 204b 6579 2061 7320 696e 6974  .B.4 Key as init
│ │ │ │ -000003f0: 6961 6c69 7a61 7469 6f6e 2076 6563 746f  ialization vecto
│ │ │ │ -00000400: 720a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  r.==============
│ │ │ │ +00000060: 6174 6564 2031 3420 4d61 7263 6820 3230  ated 14 March 20
│ │ │ │ +00000070: 3236 2066 6f72 2076 6572 7369 6f6e 2031  26 for version 1
│ │ │ │ +00000080: 2e30 2e33 206f 6620 5368 6973 6869 2e0a  .0.3 of Shishi..
│ │ │ │ +00000090: 0a20 2020 436f 7079 7269 6768 7420 c2a9  .   Copyright ..
│ │ │ │ +000000a0: 2032 3030 322d 3230 3232 2053 696d 6f6e   2002-2022 Simon
│ │ │ │ +000000b0: 204a 6f73 6566 7373 6f6e 2e0a 0a20 2020   Josefsson...   
│ │ │ │ +000000c0: 2020 5065 726d 6973 7369 6f6e 2069 7320    Permission is 
│ │ │ │ +000000d0: 6772 616e 7465 6420 746f 2063 6f70 792c  granted to copy,
│ │ │ │ +000000e0: 2064 6973 7472 6962 7574 6520 616e 642f   distribute and/
│ │ │ │ +000000f0: 6f72 206d 6f64 6966 7920 7468 6973 0a20  or modify this. 
│ │ │ │ +00000100: 2020 2020 646f 6375 6d65 6e74 2075 6e64      document und
│ │ │ │ +00000110: 6572 2074 6865 2074 6572 6d73 206f 6620  er the terms of 
│ │ │ │ +00000120: 7468 6520 474e 5520 4672 6565 2044 6f63  the GNU Free Doc
│ │ │ │ +00000130: 756d 656e 7461 7469 6f6e 204c 6963 656e  umentation Licen
│ │ │ │ +00000140: 7365 2c0a 2020 2020 2056 6572 7369 6f6e  se,.     Version
│ │ │ │ +00000150: 2031 2e33 206f 7220 616e 7920 6c61 7465   1.3 or any late
│ │ │ │ +00000160: 7220 7665 7273 696f 6e20 7075 626c 6973  r version publis
│ │ │ │ +00000170: 6865 6420 6279 2074 6865 2046 7265 6520  hed by the Free 
│ │ │ │ +00000180: 536f 6674 7761 7265 0a20 2020 2020 466f  Software.     Fo
│ │ │ │ +00000190: 756e 6461 7469 6f6e 3b20 7769 7468 206e  undation; with n
│ │ │ │ +000001a0: 6f20 496e 7661 7269 616e 7420 5365 6374  o Invariant Sect
│ │ │ │ +000001b0: 696f 6e73 2c20 6e6f 2046 726f 6e74 2d43  ions, no Front-C
│ │ │ │ +000001c0: 6f76 6572 2054 6578 7473 2c20 616e 640a  over Texts, and.
│ │ │ │ +000001d0: 2020 2020 206e 6f20 4261 636b 2d43 6f76       no Back-Cov
│ │ │ │ +000001e0: 6572 2054 6578 7473 2e20 2041 2063 6f70  er Texts.  A cop
│ │ │ │ +000001f0: 7920 6f66 2074 6865 206c 6963 656e 7365  y of the license
│ │ │ │ +00000200: 2069 7320 696e 636c 7564 6564 2069 6e20   is included in 
│ │ │ │ +00000210: 7468 650a 2020 2020 2073 6563 7469 6f6e  the.     section
│ │ │ │ +00000220: 2065 6e74 6974 6c65 6420 2247 4e55 2046   entitled "GNU F
│ │ │ │ +00000230: 7265 6520 446f 6375 6d65 6e74 6174 696f  ree Documentatio
│ │ │ │ +00000240: 6e20 4c69 6365 6e73 6522 2e0a 494e 464f  n License"..INFO
│ │ │ │ +00000250: 2d44 4952 2d53 4543 5449 4f4e 2047 4e55  -DIR-SECTION GNU
│ │ │ │ +00000260: 2075 7469 6c69 7469 6573 0a53 5441 5254   utilities.START
│ │ │ │ +00000270: 2d49 4e46 4f2d 4449 522d 454e 5452 590a  -INFO-DIR-ENTRY.
│ │ │ │ +00000280: 2a20 7368 6973 6869 3a20 2873 6869 7368  * shishi: (shish
│ │ │ │ +00000290: 6929 2e09 0941 204b 6572 6265 726f 7320  i)...A Kerberos 
│ │ │ │ +000002a0: 3520 696d 706c 656d 656e 7461 7469 6f6e  5 implementation
│ │ │ │ +000002b0: 0a45 4e44 2d49 4e46 4f2d 4449 522d 454e  .END-INFO-DIR-EN
│ │ │ │ +000002c0: 5452 590a 0a49 4e46 4f2d 4449 522d 5345  TRY..INFO-DIR-SE
│ │ │ │ +000002d0: 4354 494f 4e20 474e 5520 4c69 6272 6172  CTION GNU Librar
│ │ │ │ +000002e0: 6965 730a 5354 4152 542d 494e 464f 2d44  ies.START-INFO-D
│ │ │ │ +000002f0: 4952 2d45 4e54 5259 0a2a 206c 6962 7368  IR-ENTRY.* libsh
│ │ │ │ +00000300: 6973 6869 3a20 2873 6869 7368 6929 2e09  ishi: (shishi)..
│ │ │ │ +00000310: 094c 6962 7261 7279 2069 6d70 6c65 6d65  .Library impleme
│ │ │ │ +00000320: 6e74 696e 6720 4b65 7262 6572 6f73 2035  nting Kerberos 5
│ │ │ │ +00000330: 2e0a 454e 442d 494e 464f 2d44 4952 2d45  ..END-INFO-DIR-E
│ │ │ │ +00000340: 4e54 5259 0a0a 1f0a 4669 6c65 3a20 7368  NTRY....File: sh
│ │ │ │ +00000350: 6973 6869 2e69 6e66 6f2c 2020 4e6f 6465  ishi.info,  Node
│ │ │ │ +00000360: 3a20 4b65 7920 6173 2069 6e69 7469 616c  : Key as initial
│ │ │ │ +00000370: 697a 6174 696f 6e20 7665 6374 6f72 2c20  ization vector, 
│ │ │ │ +00000380: 204e 6578 743a 2054 6865 204b 6579 7461   Next: The Keyta
│ │ │ │ +00000390: 6220 4269 6e61 7279 2046 696c 6520 466f  b Binary File Fo
│ │ │ │ +000003a0: 726d 6174 2c20 2050 7265 763a 204b 6572  rmat,  Prev: Ker
│ │ │ │ +000003b0: 6265 7269 7a65 6420 7273 6820 616e 6420  berized rsh and 
│ │ │ │ +000003c0: 726c 6f67 696e 2c20 2055 703a 2050 726f  rlogin,  Up: Pro
│ │ │ │ +000003d0: 746f 636f 6c20 4578 7465 6e73 696f 6e73  tocol Extensions
│ │ │ │ +000003e0: 0a0a 422e 3420 4b65 7920 6173 2069 6e69  ..B.4 Key as ini
│ │ │ │ +000003f0: 7469 616c 697a 6174 696f 6e20 7665 6374  tialization vect
│ │ │ │ +00000400: 6f72 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  or.=============
│ │ │ │  00000410: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ -00000420: 3d3d 0a0a 5468 6520 e280 9864 6573 2d63  ==..The ...des-c
│ │ │ │ -00000430: 6263 2d63 7263 e280 9920 616c 676f 7269  bc-crc... algori
│ │ │ │ -00000440: 7468 6d20 282a 6e6f 7465 2043 7279 7074  thm (*note Crypt
│ │ │ │ -00000450: 6f67 7261 7068 6963 204f 7665 7276 6965  ographic Overvie
│ │ │ │ -00000460: 773a 3a29 2075 7365 7320 7468 650a 4445  w::) uses the.DE
│ │ │ │ -00000470: 5320 6b65 7920 6173 2074 6865 2069 6e69  S key as the ini
│ │ │ │ -00000480: 7469 616c 697a 6174 696f 6e20 7665 6374  tialization vect
│ │ │ │ -00000490: 6f72 2e20 2054 6869 7320 6973 2070 726f  or.  This is pro
│ │ │ │ -000004a0: 626c 656d 6174 6963 2069 6e20 6765 6e65  blematic in gene
│ │ │ │ -000004b0: 7261 6c0a 2873 6565 2062 656c 6f77 2831  ral.(see below(1
│ │ │ │ -000004c0: 2929 2c20 6275 7420 6d61 7920 6265 206d  )), but may be m
│ │ │ │ -000004d0: 6974 6967 6174 6564 2069 6e20 4b65 7262  itigated in Kerb
│ │ │ │ -000004e0: 6572 6f73 2062 7920 7468 6520 4352 4320  eros by the CRC 
│ │ │ │ -000004f0: 6368 6563 6b73 756d 0a74 6861 7420 6973  checksum.that is
│ │ │ │ -00000500: 2061 6c73 6f20 696e 636c 7564 6564 2e0a   also included..
│ │ │ │ -00000510: 0a46 726f 6d20 6461 7740 6573 7072 6573  .From daw@espres
│ │ │ │ -00000520: 736f 2e43 532e 4265 726b 656c 6579 2e45  so.CS.Berkeley.E
│ │ │ │ -00000530: 4455 2046 7269 204d 6172 2020 3120 3133  DU Fri Mar  1 13
│ │ │ │ -00000540: 3a33 323a 3334 2050 5354 2031 3939 360a  :32:34 PST 1996.
│ │ │ │ -00000550: 4172 7469 636c 653a 2035 3034 3430 206f  Article: 50440 o
│ │ │ │ -00000560: 6620 7363 692e 6372 7970 740a 5061 7468  f sci.crypt.Path
│ │ │ │ -00000570: 3a20 6167 6174 6521 6461 770a 4672 6f6d  : agate!daw.From
│ │ │ │ -00000580: 3a20 6461 7740 6573 7072 6573 736f 2e43  : daw@espresso.C
│ │ │ │ -00000590: 532e 4265 726b 656c 6579 2e45 4455 2028  S.Berkeley.EDU (
│ │ │ │ -000005a0: 4461 7669 6420 4120 5761 676e 6572 290a  David A Wagner).
│ │ │ │ -000005b0: 4e65 7773 6772 6f75 7073 3a20 7363 692e  Newsgroups: sci.
│ │ │ │ -000005c0: 6372 7970 740a 5375 626a 6563 743a 2052  crypt.Subject: R
│ │ │ │ -000005d0: 653a 2044 4553 2d43 4243 2061 6e64 2049  e: DES-CBC and I
│ │ │ │ -000005e0: 6e69 7469 616c 697a 6174 696f 6e20 5665  nitialization Ve
│ │ │ │ -000005f0: 6374 6f72 730a 4461 7465 3a20 3239 2046  ctors.Date: 29 F
│ │ │ │ -00000600: 6562 2031 3939 3620 3231 3a34 383a 3136  eb 1996 21:48:16
│ │ │ │ -00000610: 2047 4d54 0a4f 7267 616e 697a 6174 696f   GMT.Organizatio
│ │ │ │ -00000620: 6e3a 2055 6e69 7665 7273 6974 7920 6f66  n: University of
│ │ │ │ -00000630: 2043 616c 6966 6f72 6e69 612c 2042 6572   California, Ber
│ │ │ │ -00000640: 6b65 6c65 790a 4c69 6e65 733a 2033 310a  keley.Lines: 31.
│ │ │ │ -00000650: 4d65 7373 6167 652d 4944 3a20 3c34 6835  Message-ID: <4h5
│ │ │ │ -00000660: 3676 3024 336e 6f40 6167 6174 652e 6265  6v0$3no@agate.be
│ │ │ │ -00000670: 726b 656c 6579 2e65 6475 3e0a 5265 6665  rkeley.edu>.Refe
│ │ │ │ -00000680: 7265 6e63 6573 3a20 3c34 6833 396c 6924  rences: <4h39li$
│ │ │ │ -00000690: 3333 6f40 6761 6961 2e6e 732e 7574 6b2e  33o@gaia.ns.utk.
│ │ │ │ -000006a0: 6564 753e 0a4e 4e54 502d 506f 7374 696e  edu>.NNTP-Postin
│ │ │ │ -000006b0: 672d 486f 7374 3a20 6573 7072 6573 736f  g-Host: espresso
│ │ │ │ -000006c0: 2e63 732e 6265 726b 656c 6579 2e65 6475  .cs.berkeley.edu
│ │ │ │ -000006d0: 0a0a 496e 2061 7274 6963 6c65 203c 3468  ..In article <4h
│ │ │ │ -000006e0: 3339 6c69 2433 336f 4067 6169 612e 6e73  39li$33o@gaia.ns
│ │ │ │ -000006f0: 2e75 746b 2e65 6475 3e2c 0a4e 6169 7220  .utk.edu>,.Nair 
│ │ │ │ -00000700: 5665 6e75 676f 7061 6c20 3c76 656e 7540  Venugopal <venu@
│ │ │ │ -00000710: 6d61 7273 2e75 7463 632e 7574 6b2e 6564  mars.utcc.utk.ed
│ │ │ │ -00000720: 753e 2077 726f 7465 3a0a 3e20 4973 2074  u> wrote:.> Is t
│ │ │ │ -00000730: 6865 7265 2061 6e79 7468 696e 6720 7772  here anything wr
│ │ │ │ -00000740: 6f6e 6720 696e 2075 7369 6e67 2074 6865  ong in using the
│ │ │ │ -00000750: 206b 6579 2061 7320 7468 6520 492e 562e   key as the I.V.
│ │ │ │ -00000760: 2069 6e20 4445 532d 4342 4320 6d6f 6465   in DES-CBC mode
│ │ │ │ -00000770: 3f0a 0a59 6573 2c20 796f 7527 7265 206f  ?..Yes, you're o
│ │ │ │ -00000780: 7065 6e20 746f 2061 2063 686f 7365 6e2d  pen to a chosen-
│ │ │ │ -00000790: 6369 7068 6572 7465 7874 2061 7474 6163  ciphertext attac
│ │ │ │ -000007a0: 6b20 7768 6963 6820 7265 636f 7665 7273  k which recovers
│ │ │ │ -000007b0: 2074 6865 206b 6579 2e0a 0a41 6c69 6365   the key...Alice
│ │ │ │ -000007c0: 2069 7320 7365 6e64 696e 6720 7374 7566   is sending stuf
│ │ │ │ -000007d0: 6620 4445 532d 4342 4320 656e 6372 7970  f DES-CBC encryp
│ │ │ │ -000007e0: 7465 6420 7769 7468 206b 6579 204b 2074  ted with key K t
│ │ │ │ -000007f0: 6f20 426f 622e 2020 4d61 7279 2069 7320  o Bob.  Mary is 
│ │ │ │ -00000800: 616e 0a61 6374 6976 6520 6164 7665 7273  an.active advers
│ │ │ │ -00000810: 6172 7920 696e 2074 6865 206d 6964 646c  ary in the middl
│ │ │ │ -00000820: 652e 2020 5375 7070 6f73 6520 416c 6963  e.  Suppose Alic
│ │ │ │ -00000830: 6520 656e 6372 7970 7473 2073 6f6d 6520  e encrypts some 
│ │ │ │ -00000840: 706c 6169 6e74 6578 740a 626c 6f63 6b73  plaintext.blocks
│ │ │ │ -00000850: 2050 5f31 2c20 505f 322c 2050 5f33 2c20   P_1, P_2, P_3, 
│ │ │ │ -00000860: 2e2e 2e20 696e 2044 4553 2d43 4243 206d  ... in DES-CBC m
│ │ │ │ -00000870: 6f64 6520 7769 7468 204b 2061 7320 7468  ode with K as th
│ │ │ │ -00000880: 6520 4956 2c20 616e 6420 7365 6e64 7320  e IV, and sends 
│ │ │ │ -00000890: 6f66 660a 7468 6520 7265 7375 6c74 696e  off.the resultin
│ │ │ │ -000008a0: 6720 6369 7068 6572 7465 7874 0a09 412d  g ciphertext..A-
│ │ │ │ -000008b0: 3e42 3a20 435f 312c 2043 5f32 2c20 435f  >B: C_1, C_2, C_
│ │ │ │ -000008c0: 332c 202e 2e2e 0a77 6865 7265 2065 6163  3, ....where eac
│ │ │ │ -000008d0: 6820 435f 6a20 6973 2061 2038 2d62 7974  h C_j is a 8-byt
│ │ │ │ -000008e0: 6520 4445 5320 6369 7068 6572 7465 7874  e DES ciphertext
│ │ │ │ -000008f0: 2062 6c6f 636b 2e20 204d 6172 7920 7761   block.  Mary wa
│ │ │ │ -00000900: 6e74 7320 746f 2064 6973 636f 7665 720a  nts to discover.
│ │ │ │ -00000910: 7468 6520 6b65 7920 4b2c 2062 7574 2064  the key K, but d
│ │ │ │ -00000920: 6f65 736e 2774 2065 7665 6e20 6b6e 6f77  oesn't even know
│ │ │ │ -00000930: 2061 6e79 206f 6620 7468 6520 505f 6a27   any of the P_j'
│ │ │ │ -00000940: 732e 2020 5368 6520 7265 706c 6163 6573  s.  She replaces
│ │ │ │ -00000950: 2074 6865 2061 626f 7665 0a6d 6573 7361   the above.messa
│ │ │ │ -00000960: 6765 2062 790a 094d 2d3e 423a 2043 5f31  ge by..M->B: C_1
│ │ │ │ -00000970: 2c20 302c 2043 5f31 0a77 6865 7265 2030  , 0, C_1.where 0
│ │ │ │ -00000980: 2069 7320 7468 6520 382d 6279 7465 2061   is the 8-byte a
│ │ │ │ -00000990: 6c6c 2d7a 6572 6f73 2062 6c6f 636b 2e20  ll-zeros block. 
│ │ │ │ -000009a0: 2042 6f62 2077 696c 6c20 6465 6372 7970   Bob will decryp
│ │ │ │ -000009b0: 7420 756e 6465 7220 4445 532d 4342 432c  t under DES-CBC,
│ │ │ │ -000009c0: 0a72 6563 6f76 6572 696e 6720 7468 6520  .recovering the 
│ │ │ │ -000009d0: 626c 6f63 6b73 0a09 515f 312c 2051 5f32  blocks..Q_1, Q_2
│ │ │ │ -000009e0: 2c20 515f 330a 7768 6572 650a 0951 5f31  , Q_3.where..Q_1
│ │ │ │ -000009f0: 203d 2044 4553 2d64 6563 7279 7074 284b   = DES-decrypt(K
│ │ │ │ -00000a00: 2c20 435f 3129 2078 6f72 204b 203d 2050  , C_1) xor K = P
│ │ │ │ -00000a10: 5f31 0a09 515f 3220 3d20 4445 532d 6465  _1..Q_2 = DES-de
│ │ │ │ -00000a20: 6372 7970 7428 4b2c 2043 5f32 2920 786f  crypt(K, C_2) xo
│ │ │ │ -00000a30: 7220 435f 3120 3d20 2873 6f6d 6520 756e  r C_1 = (some un
│ │ │ │ -00000a40: 696d 706f 7274 616e 7420 6a75 6e6b 290a  important junk).
│ │ │ │ -00000a50: 0951 5f33 203d 2044 4553 2d64 6563 7279  .Q_3 = DES-decry
│ │ │ │ -00000a60: 7074 284b 2c20 435f 3129 2078 6f72 2030  pt(K, C_1) xor 0
│ │ │ │ -00000a70: 203d 2050 5f31 2078 6f72 204b 0a42 6f62   = P_1 xor K.Bob
│ │ │ │ -00000a80: 2067 6574 7320 7468 6973 2067 6172 6261   gets this garba
│ │ │ │ -00000a90: 6765 2d6c 6f6f 6b69 6e67 206d 6573 7361  ge-looking messa
│ │ │ │ -00000aa0: 6765 2051 5f31 2c51 5f32 2c51 5f33 2077  ge Q_1,Q_2,Q_3 w
│ │ │ │ -00000ab0: 6869 6368 204d 6172 7920 7265 636f 7665  hich Mary recove
│ │ │ │ -00000ac0: 7273 0a28 756e 6465 7220 7468 6520 6368  rs.(under the ch
│ │ │ │ -00000ad0: 6f73 656e 2d63 6970 6865 7274 6578 7420  osen-ciphertext 
│ │ │ │ -00000ae0: 6173 7375 6d70 7469 6f6e 3a20 7468 6973  assumption: this
│ │ │ │ -00000af0: 2069 7320 6c69 6b65 2061 206b 6e6f 776e   is like a known
│ │ │ │ -00000b00: 2d70 6c61 696e 7465 7874 0a61 7474 6163  -plaintext.attac
│ │ │ │ -00000b10: 6b2c 2077 6869 6368 2069 736e 2774 2074  k, which isn't t
│ │ │ │ -00000b20: 6f6f 2069 6d70 6c61 7573 6962 6c65 292e  oo implausible).
│ │ │ │ -00000b30: 2020 4e6f 7469 6365 2074 6861 7420 4d61    Notice that Ma
│ │ │ │ -00000b40: 7279 2063 616e 2072 6563 6f76 6572 204b  ry can recover K
│ │ │ │ -00000b50: 2062 790a 094b 203d 2051 5f31 2078 6f72   by..K = Q_1 xor
│ │ │ │ -00000b60: 2051 5f33 3b0a 736f 2061 6674 6572 2074   Q_3;.so after t
│ │ │ │ -00000b70: 6869 7320 6f6e 6520 7369 6d70 6c65 2061  his one simple a
│ │ │ │ -00000b80: 6374 6976 6520 6174 7461 636b 2c20 4d61  ctive attack, Ma
│ │ │ │ -00000b90: 7279 2067 6574 7320 7468 6520 6b65 7920  ry gets the key 
│ │ │ │ -00000ba0: 6261 636b 210a 0a53 6f2c 2069 6620 796f  back!..So, if yo
│ │ │ │ -00000bb0: 7520 6d75 7374 2075 7365 2061 2066 6978  u must use a fix
│ │ │ │ -00000bc0: 6564 2049 562c 2064 6f6e 2774 2075 7365  ed IV, don't use
│ │ │ │ -00000bd0: 2074 6865 206b 6579 2d2d 2075 7365 2030   the key-- use 0
│ │ │ │ -00000be0: 206f 7220 736f 6d65 7468 696e 670a 6c69   or something.li
│ │ │ │ -00000bf0: 6b65 2074 6861 742e 2020 4576 656e 2062  ke that.  Even b
│ │ │ │ -00000c00: 6574 7465 722c 2064 6f6e 2774 2075 7365  etter, don't use
│ │ │ │ -00000c10: 2061 2066 6978 6564 2049 562d 2d20 7573   a fixed IV-- us
│ │ │ │ -00000c20: 6520 7468 6520 4445 5320 656e 6372 7970  e the DES encryp
│ │ │ │ -00000c30: 7469 6f6e 0a6f 6620 6120 636f 756e 7465  tion.of a counte
│ │ │ │ -00000c40: 722c 206f 7220 736f 6d65 7468 696e 6720  r, or something 
│ │ │ │ -00000c50: 6c69 6b65 2074 6861 742e 0a0a 2020 202d  like that...   -
│ │ │ │ -00000c60: 2d2d 2d2d 2d2d 2d2d 2d20 466f 6f74 6e6f  --------- Footno
│ │ │ │ -00000c70: 7465 7320 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a  tes ----------..
│ │ │ │ -00000c80: 2020 2028 3129 2054 6865 2070 6f73 7420     (1) The post 
│ │ │ │ -00000c90: 6973 2063 6f70 7972 6967 6874 6564 2062  is copyrighted b
│ │ │ │ -00000ca0: 7920 4461 7669 6420 5761 676e 6572 2c20  y David Wagner, 
│ │ │ │ -00000cb0: 696e 636c 7564 6564 2068 6572 6520 7769  included here wi
│ │ │ │ -00000cc0: 7468 0a70 6572 6d69 7373 696f 6e2c 2074  th.permission, t
│ │ │ │ -00000cd0: 6865 2063 616e 6f6e 6963 616c 206c 6f63  he canonical loc
│ │ │ │ -00000ce0: 6174 696f 6e20 6973 0a3c 6874 7470 3a2f  ation is.<http:/
│ │ │ │ -00000cf0: 2f77 7777 2e63 732e 6265 726b 656c 6579  /www.cs.berkeley
│ │ │ │ -00000d00: 2e65 6475 2f7e 6461 772f 6d79 2d70 6f73  .edu/~daw/my-pos
│ │ │ │ -00000d10: 7473 2f6b 6579 2d61 732d 6976 2d62 726f  ts/key-as-iv-bro
│ │ │ │ -00000d20: 6b65 6e3e 0a0a 1f0a 4669 6c65 3a20 7368  ken>....File: sh
│ │ │ │ -00000d30: 6973 6869 2e69 6e66 6f2c 2020 4e6f 6465  ishi.info,  Node
│ │ │ │ -00000d40: 3a20 5468 6520 4b65 7974 6162 2042 696e  : The Keytab Bin
│ │ │ │ -00000d50: 6172 7920 4669 6c65 2046 6f72 6d61 742c  ary File Format,
│ │ │ │ -00000d60: 2020 4e65 7874 3a20 5468 6520 4372 6564    Next: The Cred
│ │ │ │ -00000d70: 656e 7469 616c 2043 6163 6865 2042 696e  ential Cache Bin
│ │ │ │ -00000d80: 6172 7920 4669 6c65 2046 6f72 6d61 742c  ary File Format,
│ │ │ │ -00000d90: 2020 5072 6576 3a20 4b65 7920 6173 2069    Prev: Key as i
│ │ │ │ -00000da0: 6e69 7469 616c 697a 6174 696f 6e20 7665  nitialization ve
│ │ │ │ -00000db0: 6374 6f72 2c20 2055 703a 2050 726f 746f  ctor,  Up: Proto
│ │ │ │ -00000dc0: 636f 6c20 4578 7465 6e73 696f 6e73 0a0a  col Extensions..
│ │ │ │ -00000dd0: 422e 3520 5468 6520 4b65 7974 6162 2042  B.5 The Keytab B
│ │ │ │ -00000de0: 696e 6172 7920 4669 6c65 2046 6f72 6d61  inary File Forma
│ │ │ │ -00000df0: 740a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  t.==============
│ │ │ │ +00000420: 3d3d 3d0a 0a54 6865 20e2 8098 6465 732d  ===..The ...des-
│ │ │ │ +00000430: 6362 632d 6372 63e2 8099 2061 6c67 6f72  cbc-crc... algor
│ │ │ │ +00000440: 6974 686d 2028 2a6e 6f74 6520 4372 7970  ithm (*note Cryp
│ │ │ │ +00000450: 746f 6772 6170 6869 6320 4f76 6572 7669  tographic Overvi
│ │ │ │ +00000460: 6577 3a3a 2920 7573 6573 2074 6865 0a44  ew::) uses the.D
│ │ │ │ +00000470: 4553 206b 6579 2061 7320 7468 6520 696e  ES key as the in
│ │ │ │ +00000480: 6974 6961 6c69 7a61 7469 6f6e 2076 6563  itialization vec
│ │ │ │ +00000490: 746f 722e 2020 5468 6973 2069 7320 7072  tor.  This is pr
│ │ │ │ +000004a0: 6f62 6c65 6d61 7469 6320 696e 2067 656e  oblematic in gen
│ │ │ │ +000004b0: 6572 616c 0a28 7365 6520 6265 6c6f 7728  eral.(see below(
│ │ │ │ +000004c0: 3129 292c 2062 7574 206d 6179 2062 6520  1)), but may be 
│ │ │ │ +000004d0: 6d69 7469 6761 7465 6420 696e 204b 6572  mitigated in Ker
│ │ │ │ +000004e0: 6265 726f 7320 6279 2074 6865 2043 5243  beros by the CRC
│ │ │ │ +000004f0: 2063 6865 636b 7375 6d0a 7468 6174 2069   checksum.that i
│ │ │ │ +00000500: 7320 616c 736f 2069 6e63 6c75 6465 642e  s also included.
│ │ │ │ +00000510: 0a0a 4672 6f6d 2064 6177 4065 7370 7265  ..From daw@espre
│ │ │ │ +00000520: 7373 6f2e 4353 2e42 6572 6b65 6c65 792e  sso.CS.Berkeley.
│ │ │ │ +00000530: 4544 5520 4672 6920 4d61 7220 2031 2031  EDU Fri Mar  1 1
│ │ │ │ +00000540: 333a 3332 3a33 3420 5053 5420 3139 3936  3:32:34 PST 1996
│ │ │ │ +00000550: 0a41 7274 6963 6c65 3a20 3530 3434 3020  .Article: 50440 
│ │ │ │ +00000560: 6f66 2073 6369 2e63 7279 7074 0a50 6174  of sci.crypt.Pat
│ │ │ │ +00000570: 683a 2061 6761 7465 2164 6177 0a46 726f  h: agate!daw.Fro
│ │ │ │ +00000580: 6d3a 2064 6177 4065 7370 7265 7373 6f2e  m: daw@espresso.
│ │ │ │ +00000590: 4353 2e42 6572 6b65 6c65 792e 4544 5520  CS.Berkeley.EDU 
│ │ │ │ +000005a0: 2844 6176 6964 2041 2057 6167 6e65 7229  (David A Wagner)
│ │ │ │ +000005b0: 0a4e 6577 7367 726f 7570 733a 2073 6369  .Newsgroups: sci
│ │ │ │ +000005c0: 2e63 7279 7074 0a53 7562 6a65 6374 3a20  .crypt.Subject: 
│ │ │ │ +000005d0: 5265 3a20 4445 532d 4342 4320 616e 6420  Re: DES-CBC and 
│ │ │ │ +000005e0: 496e 6974 6961 6c69 7a61 7469 6f6e 2056  Initialization V
│ │ │ │ +000005f0: 6563 746f 7273 0a44 6174 653a 2032 3920  ectors.Date: 29 
│ │ │ │ +00000600: 4665 6220 3139 3936 2032 313a 3438 3a31  Feb 1996 21:48:1
│ │ │ │ +00000610: 3620 474d 540a 4f72 6761 6e69 7a61 7469  6 GMT.Organizati
│ │ │ │ +00000620: 6f6e 3a20 556e 6976 6572 7369 7479 206f  on: University o
│ │ │ │ +00000630: 6620 4361 6c69 666f 726e 6961 2c20 4265  f California, Be
│ │ │ │ +00000640: 726b 656c 6579 0a4c 696e 6573 3a20 3331  rkeley.Lines: 31
│ │ │ │ +00000650: 0a4d 6573 7361 6765 2d49 443a 203c 3468  .Message-ID: <4h
│ │ │ │ +00000660: 3536 7630 2433 6e6f 4061 6761 7465 2e62  56v0$3no@agate.b
│ │ │ │ +00000670: 6572 6b65 6c65 792e 6564 753e 0a52 6566  erkeley.edu>.Ref
│ │ │ │ +00000680: 6572 656e 6365 733a 203c 3468 3339 6c69  erences: <4h39li
│ │ │ │ +00000690: 2433 336f 4067 6169 612e 6e73 2e75 746b  $33o@gaia.ns.utk
│ │ │ │ +000006a0: 2e65 6475 3e0a 4e4e 5450 2d50 6f73 7469  .edu>.NNTP-Posti
│ │ │ │ +000006b0: 6e67 2d48 6f73 743a 2065 7370 7265 7373  ng-Host: espress
│ │ │ │ +000006c0: 6f2e 6373 2e62 6572 6b65 6c65 792e 6564  o.cs.berkeley.ed
│ │ │ │ +000006d0: 750a 0a49 6e20 6172 7469 636c 6520 3c34  u..In article <4
│ │ │ │ +000006e0: 6833 396c 6924 3333 6f40 6761 6961 2e6e  h39li$33o@gaia.n
│ │ │ │ +000006f0: 732e 7574 6b2e 6564 753e 2c0a 4e61 6972  s.utk.edu>,.Nair
│ │ │ │ +00000700: 2056 656e 7567 6f70 616c 203c 7665 6e75   Venugopal <venu
│ │ │ │ +00000710: 406d 6172 732e 7574 6363 2e75 746b 2e65  @mars.utcc.utk.e
│ │ │ │ +00000720: 6475 3e20 7772 6f74 653a 0a3e 2049 7320  du> wrote:.> Is 
│ │ │ │ +00000730: 7468 6572 6520 616e 7974 6869 6e67 2077  there anything w
│ │ │ │ +00000740: 726f 6e67 2069 6e20 7573 696e 6720 7468  rong in using th
│ │ │ │ +00000750: 6520 6b65 7920 6173 2074 6865 2049 2e56  e key as the I.V
│ │ │ │ +00000760: 2e20 696e 2044 4553 2d43 4243 206d 6f64  . in DES-CBC mod
│ │ │ │ +00000770: 653f 0a0a 5965 732c 2079 6f75 2772 6520  e?..Yes, you're 
│ │ │ │ +00000780: 6f70 656e 2074 6f20 6120 6368 6f73 656e  open to a chosen
│ │ │ │ +00000790: 2d63 6970 6865 7274 6578 7420 6174 7461  -ciphertext atta
│ │ │ │ +000007a0: 636b 2077 6869 6368 2072 6563 6f76 6572  ck which recover
│ │ │ │ +000007b0: 7320 7468 6520 6b65 792e 0a0a 416c 6963  s the key...Alic
│ │ │ │ +000007c0: 6520 6973 2073 656e 6469 6e67 2073 7475  e is sending stu
│ │ │ │ +000007d0: 6666 2044 4553 2d43 4243 2065 6e63 7279  ff DES-CBC encry
│ │ │ │ +000007e0: 7074 6564 2077 6974 6820 6b65 7920 4b20  pted with key K 
│ │ │ │ +000007f0: 746f 2042 6f62 2e20 204d 6172 7920 6973  to Bob.  Mary is
│ │ │ │ +00000800: 2061 6e0a 6163 7469 7665 2061 6476 6572   an.active adver
│ │ │ │ +00000810: 7361 7279 2069 6e20 7468 6520 6d69 6464  sary in the midd
│ │ │ │ +00000820: 6c65 2e20 2053 7570 706f 7365 2041 6c69  le.  Suppose Ali
│ │ │ │ +00000830: 6365 2065 6e63 7279 7074 7320 736f 6d65  ce encrypts some
│ │ │ │ +00000840: 2070 6c61 696e 7465 7874 0a62 6c6f 636b   plaintext.block
│ │ │ │ +00000850: 7320 505f 312c 2050 5f32 2c20 505f 332c  s P_1, P_2, P_3,
│ │ │ │ +00000860: 202e 2e2e 2069 6e20 4445 532d 4342 4320   ... in DES-CBC 
│ │ │ │ +00000870: 6d6f 6465 2077 6974 6820 4b20 6173 2074  mode with K as t
│ │ │ │ +00000880: 6865 2049 562c 2061 6e64 2073 656e 6473  he IV, and sends
│ │ │ │ +00000890: 206f 6666 0a74 6865 2072 6573 756c 7469   off.the resulti
│ │ │ │ +000008a0: 6e67 2063 6970 6865 7274 6578 740a 0941  ng ciphertext..A
│ │ │ │ +000008b0: 2d3e 423a 2043 5f31 2c20 435f 322c 2043  ->B: C_1, C_2, C
│ │ │ │ +000008c0: 5f33 2c20 2e2e 2e0a 7768 6572 6520 6561  _3, ....where ea
│ │ │ │ +000008d0: 6368 2043 5f6a 2069 7320 6120 382d 6279  ch C_j is a 8-by
│ │ │ │ +000008e0: 7465 2044 4553 2063 6970 6865 7274 6578  te DES ciphertex
│ │ │ │ +000008f0: 7420 626c 6f63 6b2e 2020 4d61 7279 2077  t block.  Mary w
│ │ │ │ +00000900: 616e 7473 2074 6f20 6469 7363 6f76 6572  ants to discover
│ │ │ │ +00000910: 0a74 6865 206b 6579 204b 2c20 6275 7420  .the key K, but 
│ │ │ │ +00000920: 646f 6573 6e27 7420 6576 656e 206b 6e6f  doesn't even kno
│ │ │ │ +00000930: 7720 616e 7920 6f66 2074 6865 2050 5f6a  w any of the P_j
│ │ │ │ +00000940: 2773 2e20 2053 6865 2072 6570 6c61 6365  's.  She replace
│ │ │ │ +00000950: 7320 7468 6520 6162 6f76 650a 6d65 7373  s the above.mess
│ │ │ │ +00000960: 6167 6520 6279 0a09 4d2d 3e42 3a20 435f  age by..M->B: C_
│ │ │ │ +00000970: 312c 2030 2c20 435f 310a 7768 6572 6520  1, 0, C_1.where 
│ │ │ │ +00000980: 3020 6973 2074 6865 2038 2d62 7974 6520  0 is the 8-byte 
│ │ │ │ +00000990: 616c 6c2d 7a65 726f 7320 626c 6f63 6b2e  all-zeros block.
│ │ │ │ +000009a0: 2020 426f 6220 7769 6c6c 2064 6563 7279    Bob will decry
│ │ │ │ +000009b0: 7074 2075 6e64 6572 2044 4553 2d43 4243  pt under DES-CBC
│ │ │ │ +000009c0: 2c0a 7265 636f 7665 7269 6e67 2074 6865  ,.recovering the
│ │ │ │ +000009d0: 2062 6c6f 636b 730a 0951 5f31 2c20 515f   blocks..Q_1, Q_
│ │ │ │ +000009e0: 322c 2051 5f33 0a77 6865 7265 0a09 515f  2, Q_3.where..Q_
│ │ │ │ +000009f0: 3120 3d20 4445 532d 6465 6372 7970 7428  1 = DES-decrypt(
│ │ │ │ +00000a00: 4b2c 2043 5f31 2920 786f 7220 4b20 3d20  K, C_1) xor K = 
│ │ │ │ +00000a10: 505f 310a 0951 5f32 203d 2044 4553 2d64  P_1..Q_2 = DES-d
│ │ │ │ +00000a20: 6563 7279 7074 284b 2c20 435f 3229 2078  ecrypt(K, C_2) x
│ │ │ │ +00000a30: 6f72 2043 5f31 203d 2028 736f 6d65 2075  or C_1 = (some u
│ │ │ │ +00000a40: 6e69 6d70 6f72 7461 6e74 206a 756e 6b29  nimportant junk)
│ │ │ │ +00000a50: 0a09 515f 3320 3d20 4445 532d 6465 6372  ..Q_3 = DES-decr
│ │ │ │ +00000a60: 7970 7428 4b2c 2043 5f31 2920 786f 7220  ypt(K, C_1) xor 
│ │ │ │ +00000a70: 3020 3d20 505f 3120 786f 7220 4b0a 426f  0 = P_1 xor K.Bo
│ │ │ │ +00000a80: 6220 6765 7473 2074 6869 7320 6761 7262  b gets this garb
│ │ │ │ +00000a90: 6167 652d 6c6f 6f6b 696e 6720 6d65 7373  age-looking mess
│ │ │ │ +00000aa0: 6167 6520 515f 312c 515f 322c 515f 3320  age Q_1,Q_2,Q_3 
│ │ │ │ +00000ab0: 7768 6963 6820 4d61 7279 2072 6563 6f76  which Mary recov
│ │ │ │ +00000ac0: 6572 730a 2875 6e64 6572 2074 6865 2063  ers.(under the c
│ │ │ │ +00000ad0: 686f 7365 6e2d 6369 7068 6572 7465 7874  hosen-ciphertext
│ │ │ │ +00000ae0: 2061 7373 756d 7074 696f 6e3a 2074 6869   assumption: thi
│ │ │ │ +00000af0: 7320 6973 206c 696b 6520 6120 6b6e 6f77  s is like a know
│ │ │ │ +00000b00: 6e2d 706c 6169 6e74 6578 740a 6174 7461  n-plaintext.atta
│ │ │ │ +00000b10: 636b 2c20 7768 6963 6820 6973 6e27 7420  ck, which isn't 
│ │ │ │ +00000b20: 746f 6f20 696d 706c 6175 7369 626c 6529  too implausible)
│ │ │ │ +00000b30: 2e20 204e 6f74 6963 6520 7468 6174 204d  .  Notice that M
│ │ │ │ +00000b40: 6172 7920 6361 6e20 7265 636f 7665 7220  ary can recover 
│ │ │ │ +00000b50: 4b20 6279 0a09 4b20 3d20 515f 3120 786f  K by..K = Q_1 xo
│ │ │ │ +00000b60: 7220 515f 333b 0a73 6f20 6166 7465 7220  r Q_3;.so after 
│ │ │ │ +00000b70: 7468 6973 206f 6e65 2073 696d 706c 6520  this one simple 
│ │ │ │ +00000b80: 6163 7469 7665 2061 7474 6163 6b2c 204d  active attack, M
│ │ │ │ +00000b90: 6172 7920 6765 7473 2074 6865 206b 6579  ary gets the key
│ │ │ │ +00000ba0: 2062 6163 6b21 0a0a 536f 2c20 6966 2079   back!..So, if y
│ │ │ │ +00000bb0: 6f75 206d 7573 7420 7573 6520 6120 6669  ou must use a fi
│ │ │ │ +00000bc0: 7865 6420 4956 2c20 646f 6e27 7420 7573  xed IV, don't us
│ │ │ │ +00000bd0: 6520 7468 6520 6b65 792d 2d20 7573 6520  e the key-- use 
│ │ │ │ +00000be0: 3020 6f72 2073 6f6d 6574 6869 6e67 0a6c  0 or something.l
│ │ │ │ +00000bf0: 696b 6520 7468 6174 2e20 2045 7665 6e20  ike that.  Even 
│ │ │ │ +00000c00: 6265 7474 6572 2c20 646f 6e27 7420 7573  better, don't us
│ │ │ │ +00000c10: 6520 6120 6669 7865 6420 4956 2d2d 2075  e a fixed IV-- u
│ │ │ │ +00000c20: 7365 2074 6865 2044 4553 2065 6e63 7279  se the DES encry
│ │ │ │ +00000c30: 7074 696f 6e0a 6f66 2061 2063 6f75 6e74  ption.of a count
│ │ │ │ +00000c40: 6572 2c20 6f72 2073 6f6d 6574 6869 6e67  er, or something
│ │ │ │ +00000c50: 206c 696b 6520 7468 6174 2e0a 0a20 2020   like that...   
│ │ │ │ +00000c60: 2d2d 2d2d 2d2d 2d2d 2d2d 2046 6f6f 746e  ---------- Footn
│ │ │ │ +00000c70: 6f74 6573 202d 2d2d 2d2d 2d2d 2d2d 2d0a  otes ----------.
│ │ │ │ +00000c80: 0a20 2020 2831 2920 5468 6520 706f 7374  .   (1) The post
│ │ │ │ +00000c90: 2069 7320 636f 7079 7269 6768 7465 6420   is copyrighted 
│ │ │ │ +00000ca0: 6279 2044 6176 6964 2057 6167 6e65 722c  by David Wagner,
│ │ │ │ +00000cb0: 2069 6e63 6c75 6465 6420 6865 7265 2077   included here w
│ │ │ │ +00000cc0: 6974 680a 7065 726d 6973 7369 6f6e 2c20  ith.permission, 
│ │ │ │ +00000cd0: 7468 6520 6361 6e6f 6e69 6361 6c20 6c6f  the canonical lo
│ │ │ │ +00000ce0: 6361 7469 6f6e 2069 730a 3c68 7474 703a  cation is.<http:
│ │ │ │ +00000cf0: 2f2f 7777 772e 6373 2e62 6572 6b65 6c65  //www.cs.berkele
│ │ │ │ +00000d00: 792e 6564 752f 7e64 6177 2f6d 792d 706f  y.edu/~daw/my-po
│ │ │ │ +00000d10: 7374 732f 6b65 792d 6173 2d69 762d 6272  sts/key-as-iv-br
│ │ │ │ +00000d20: 6f6b 656e 3e0a 0a1f 0a46 696c 653a 2073  oken>....File: s
│ │ │ │ +00000d30: 6869 7368 692e 696e 666f 2c20 204e 6f64  hishi.info,  Nod
│ │ │ │ +00000d40: 653a 2054 6865 204b 6579 7461 6220 4269  e: The Keytab Bi
│ │ │ │ +00000d50: 6e61 7279 2046 696c 6520 466f 726d 6174  nary File Format
│ │ │ │ +00000d60: 2c20 204e 6578 743a 2054 6865 2043 7265  ,  Next: The Cre
│ │ │ │ +00000d70: 6465 6e74 6961 6c20 4361 6368 6520 4269  dential Cache Bi
│ │ │ │ +00000d80: 6e61 7279 2046 696c 6520 466f 726d 6174  nary File Format
│ │ │ │ +00000d90: 2c20 2050 7265 763a 204b 6579 2061 7320  ,  Prev: Key as 
│ │ │ │ +00000da0: 696e 6974 6961 6c69 7a61 7469 6f6e 2076  initialization v
│ │ │ │ +00000db0: 6563 746f 722c 2020 5570 3a20 5072 6f74  ector,  Up: Prot
│ │ │ │ +00000dc0: 6f63 6f6c 2045 7874 656e 7369 6f6e 730a  ocol Extensions.
│ │ │ │ +00000dd0: 0a42 2e35 2054 6865 204b 6579 7461 6220  .B.5 The Keytab 
│ │ │ │ +00000de0: 4269 6e61 7279 2046 696c 6520 466f 726d  Binary File Form
│ │ │ │ +00000df0: 6174 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  at.=============
│ │ │ │  00000e00: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ -00000e10: 3d3d 3d0a 0a54 6865 206b 6579 7461 6220  ===..The keytab 
│ │ │ │ -00000e20: 6669 6c65 2066 6f72 6d61 7420 6973 2064  file format is d
│ │ │ │ -00000e30: 6573 6372 6962 6564 2069 6e20 7468 6520  escribed in the 
│ │ │ │ -00000e40: 6669 6c65 20e2 8098 6b65 7974 6162 2e74  file ...keytab.t
│ │ │ │ -00000e50: 7874 e280 992c 2068 6572 650a 696e 636c  xt..., here.incl
│ │ │ │ -00000e60: 7564 6564 2076 6572 6261 7469 6d2e 0a0a  uded verbatim...
│ │ │ │ -00000e70: 5468 6520 4b65 7262 6572 6f73 204b 6579  The Kerberos Key
│ │ │ │ -00000e80: 7461 6220 4269 6e61 7279 2046 696c 6520  tab Binary File 
│ │ │ │ -00000e90: 466f 726d 6174 0a43 6f70 7972 6967 6874  Format.Copyright
│ │ │ │ -00000ea0: 2028 4329 2032 3030 3620 4d69 6368 6165   (C) 2006 Michae
│ │ │ │ -00000eb0: 6c20 4220 416c 6c65 6e20 3c6d 6261 3230  l B Allen <mba20
│ │ │ │ -00000ec0: 3030 2069 6f70 6c65 782e 636f 6d3e 0a68  00 ioplex.com>.h
│ │ │ │ -00000ed0: 7474 703a 2f2f 7777 772e 696f 706c 6578  ttp://www.ioplex
│ │ │ │ -00000ee0: 2e63 6f6d 2f75 7469 6c69 7469 6573 2f6b  .com/utilities/k
│ │ │ │ -00000ef0: 6579 7461 622e 7478 740a 4c61 7374 2075  eytab.txt.Last u
│ │ │ │ -00000f00: 7064 6174 6564 3a20 4672 6920 4d61 7920  pdated: Fri May 
│ │ │ │ -00000f10: 2035 2031 333a 3339 3a34 3020 4544 5420   5 13:39:40 EDT 
│ │ │ │ -00000f20: 3230 3036 0a0a 5468 6520 4d49 5420 6b65  2006..The MIT ke
│ │ │ │ -00000f30: 7974 6162 2062 696e 6172 7920 666f 726d  ytab binary form
│ │ │ │ -00000f40: 6174 2069 7320 6e6f 7420 6120 7374 616e  at is not a stan
│ │ │ │ -00000f50: 6461 7264 2066 6f72 6d61 742c 206e 6f72  dard format, nor
│ │ │ │ -00000f60: 2069 7320 6974 0a64 6f63 756d 656e 7465   is it.documente
│ │ │ │ -00000f70: 6420 616e 7977 6865 7265 2069 6e20 6465  d anywhere in de
│ │ │ │ -00000f80: 7461 696c 2e20 5468 6520 666f 726d 6174  tail. The format
│ │ │ │ -00000f90: 2068 6173 2065 766f 6c76 6564 2061 6e64   has evolved and
│ │ │ │ -00000fa0: 206d 6179 2063 6f6e 7469 6e75 650a 746f   may continue.to
│ │ │ │ -00000fb0: 2e20 4974 2069 7320 686f 7765 7665 7220  . It is however 
│ │ │ │ -00000fc0: 756e 6465 7273 746f 6f64 2062 7920 7365  understood by se
│ │ │ │ -00000fd0: 7665 7261 6c20 4b65 7262 6572 6f73 2069  veral Kerberos i
│ │ │ │ -00000fe0: 6d70 6c65 6d65 6e74 6174 696f 6e73 2069  mplementations i
│ │ │ │ -00000ff0: 6e63 6c75 6469 6e67 0a48 6569 6d64 616c  ncluding.Heimdal
│ │ │ │ -00001000: 2061 6e64 206f 6620 636f 7572 7365 204d   and of course M
│ │ │ │ -00001010: 4954 2061 6e64 206b 6579 7461 6220 6669  IT and keytab fi
│ │ │ │ -00001020: 6c65 7320 6172 6520 6372 6561 7465 6420  les are created 
│ │ │ │ -00001030: 6279 2074 6865 206b 7470 6173 732e 6578  by the ktpass.ex
│ │ │ │ -00001040: 650a 7574 696c 6974 7920 6672 6f6d 2057  e.utility from W
│ │ │ │ -00001050: 696e 646f 7773 2e20 536f 2069 7420 6861  indows. So it ha
│ │ │ │ -00001060: 7320 6573 7461 626c 6973 6865 6420 6974  s established it
│ │ │ │ -00001070: 7365 6c66 2061 7320 7468 6520 6465 6661  self as the defa
│ │ │ │ -00001080: 6374 6f20 666f 726d 6174 0a66 6f72 2073  cto format.for s
│ │ │ │ -00001090: 746f 7269 6e67 204b 6572 6265 726f 7320  toring Kerberos 
│ │ │ │ -000010a0: 6b65 7973 2e0a 0a54 6865 2066 6f6c 6c6f  keys...The follo
│ │ │ │ -000010b0: 7769 6e67 2043 2d6c 696b 6520 7374 7275  wing C-like stru
│ │ │ │ -000010c0: 6374 7572 6520 6465 6669 6e69 7469 6f6e  cture definition
│ │ │ │ -000010d0: 7320 696c 6c75 7374 7261 7465 2074 6865  s illustrate the
│ │ │ │ -000010e0: 204d 4954 206b 6579 7461 620a 6669 6c65   MIT keytab.file
│ │ │ │ -000010f0: 2066 6f72 6d61 742e 2041 6c6c 2076 616c   format. All val
│ │ │ │ -00001100: 7565 7320 6172 6520 696e 206e 6574 776f  ues are in netwo
│ │ │ │ -00001110: 726b 2062 7974 6520 6f72 6465 722e 2041  rk byte order. A
│ │ │ │ -00001120: 6c6c 2074 6578 7420 6973 2041 5343 4949  ll text is ASCII
│ │ │ │ -00001130: 2e0a 0a20 206b 6579 7461 6220 7b0a 2020  ...  keytab {.  
│ │ │ │ -00001140: 2020 2020 7569 6e74 3136 5f74 2066 696c      uint16_t fil
│ │ │ │ -00001150: 655f 666f 726d 6174 5f76 6572 7369 6f6e  e_format_version
│ │ │ │ -00001160: 3b20 2020 2020 2020 2020 2020 2020 2020  ;               
│ │ │ │ -00001170: 2020 2020 202f 2a20 3078 3530 3220 2a2f       /* 0x502 */
│ │ │ │ -00001180: 0a20 2020 2020 206b 6579 7461 625f 656e  .      keytab_en
│ │ │ │ -00001190: 7472 7920 656e 7472 6965 735b 2a5d 3b0a  try entries[*];.
│ │ │ │ -000011a0: 2020 7d3b 0a0a 2020 6b65 7974 6162 5f65    };..  keytab_e
│ │ │ │ -000011b0: 6e74 7279 207b 0a20 2020 2020 2069 6e74  ntry {.      int
│ │ │ │ -000011c0: 3332 5f74 2073 697a 653b 0a20 2020 2020  32_t size;.     
│ │ │ │ -000011d0: 2075 696e 7431 365f 7420 6e75 6d5f 636f   uint16_t num_co
│ │ │ │ -000011e0: 6d70 6f6e 656e 7473 3b20 2020 202f 2a20  mponents;    /* 
│ │ │ │ -000011f0: 7375 6220 3120 6966 2076 6572 7369 6f6e  sub 1 if version
│ │ │ │ -00001200: 2030 7835 3031 202a 2f0a 2020 2020 2020   0x501 */.      
│ │ │ │ -00001210: 636f 756e 7465 645f 6f63 7465 745f 7374  counted_octet_st
│ │ │ │ -00001220: 7269 6e67 2072 6561 6c6d 3b0a 2020 2020  ring realm;.    
│ │ │ │ -00001230: 2020 636f 756e 7465 645f 6f63 7465 745f    counted_octet_
│ │ │ │ -00001240: 7374 7269 6e67 2063 6f6d 706f 6e65 6e74  string component
│ │ │ │ -00001250: 735b 6e75 6d5f 636f 6d70 6f6e 656e 7473  s[num_components
│ │ │ │ -00001260: 5d3b 0a20 2020 2020 2075 696e 7433 325f  ];.      uint32_
│ │ │ │ -00001270: 7420 6e61 6d65 5f74 7970 653b 2020 202f  t name_type;   /
│ │ │ │ -00001280: 2a20 6e6f 7420 7072 6573 656e 7420 6966  * not present if
│ │ │ │ -00001290: 2076 6572 7369 6f6e 2030 7835 3031 202a   version 0x501 *
│ │ │ │ -000012a0: 2f0a 2020 2020 2020 7569 6e74 3332 5f74  /.      uint32_t
│ │ │ │ -000012b0: 2074 696d 6573 7461 6d70 3b0a 2020 2020   timestamp;.    
│ │ │ │ -000012c0: 2020 7569 6e74 385f 7420 766e 6f38 3b0a    uint8_t vno8;.
│ │ │ │ -000012d0: 2020 2020 2020 6b65 7962 6c6f 636b 206b        keyblock k
│ │ │ │ -000012e0: 6579 3b0a 2020 2020 2020 7569 6e74 3332  ey;.      uint32
│ │ │ │ -000012f0: 5f74 2076 6e6f 3b20 2f2a 206f 6e6c 7920  _t vno; /* only 
│ │ │ │ -00001300: 7072 6573 656e 7420 6966 203e 3d20 3420  present if >= 4 
│ │ │ │ -00001310: 6279 7465 7320 6c65 6674 2069 6e20 656e  bytes left in en
│ │ │ │ -00001320: 7472 7920 2a2f 0a20 207d 3b0a 0a20 2063  try */.  };..  c
│ │ │ │ -00001330: 6f75 6e74 6564 5f6f 6374 6574 5f73 7472  ounted_octet_str
│ │ │ │ -00001340: 696e 6720 7b0a 2020 2020 2020 7569 6e74  ing {.      uint
│ │ │ │ -00001350: 3136 5f74 206c 656e 6774 683b 0a20 2020  16_t length;.   
│ │ │ │ -00001360: 2020 2075 696e 7438 5f74 2064 6174 615b     uint8_t data[
│ │ │ │ -00001370: 6c65 6e67 7468 5d3b 0a20 207d 3b0a 0a20  length];.  };.. 
│ │ │ │ -00001380: 206b 6579 626c 6f63 6b20 7b0a 2020 2020   keyblock {.    
│ │ │ │ -00001390: 2020 7569 6e74 3136 5f74 2074 7970 653b    uint16_t type;
│ │ │ │ -000013a0: 0a20 2020 2020 2063 6f75 6e74 6564 5f6f  .      counted_o
│ │ │ │ -000013b0: 6374 6574 5f73 7472 696e 673b 0a20 207d  ctet_string;.  }
│ │ │ │ -000013c0: 3b0a 0a54 6865 206b 6579 7461 6220 6669  ;..The keytab fi
│ │ │ │ -000013d0: 6c65 2066 6f72 6d61 7420 6265 6769 6e73  le format begins
│ │ │ │ -000013e0: 2077 6974 6820 7468 6520 3136 2062 6974   with the 16 bit
│ │ │ │ -000013f0: 2066 696c 655f 666f 726d 6174 5f76 6572   file_format_ver
│ │ │ │ -00001400: 7369 6f6e 2077 6869 6368 0a61 7420 7468  sion which.at th
│ │ │ │ -00001410: 6520 7469 6d65 2074 6869 7320 646f 6375  e time this docu
│ │ │ │ -00001420: 6d65 6e74 2077 6173 2061 7574 686f 7265  ment was authore
│ │ │ │ -00001430: 6420 6973 2030 7835 3032 2e20 5468 6520  d is 0x502. The 
│ │ │ │ -00001440: 666f 726d 6174 206f 6620 6f6c 6465 720a  format of older.
│ │ │ │ -00001450: 6b65 7974 6162 7320 6973 2064 6573 6372  keytabs is descr
│ │ │ │ -00001460: 6962 6564 2061 7420 7468 6520 656e 6420  ibed at the end 
│ │ │ │ -00001470: 6f66 2074 6869 7320 646f 6375 6d65 6e74  of this document
│ │ │ │ -00001480: 2e0a 0a54 6865 2066 696c 655f 666f 726d  ...The file_form
│ │ │ │ -00001490: 6174 5f76 6572 7369 6f6e 2069 7320 696d  at_version is im
│ │ │ │ -000014a0: 6d65 6469 6174 656c 7920 666f 6c6c 6f77  mediately follow
│ │ │ │ -000014b0: 6564 2062 7920 616e 2061 7272 6179 206f  ed by an array o
│ │ │ │ -000014c0: 660a 6b65 7974 6162 5f65 6e74 7279 2073  f.keytab_entry s
│ │ │ │ -000014d0: 7472 7563 7475 7265 7320 7768 6963 6820  tructures which 
│ │ │ │ -000014e0: 6172 6520 7072 6566 6978 6564 2077 6974  are prefixed wit
│ │ │ │ -000014f0: 6820 6120 3332 2062 6974 2073 697a 6520  h a 32 bit size 
│ │ │ │ -00001500: 696e 6469 6361 7469 6e67 0a74 6865 206e  indicating.the n
│ │ │ │ -00001510: 756d 6265 7220 6f66 2062 7974 6573 2074  umber of bytes t
│ │ │ │ -00001520: 6861 7420 666f 6c6c 6f77 2069 6e20 7468  hat follow in th
│ │ │ │ -00001530: 6520 656e 7472 792e 204e 6f74 6520 7468  e entry. Note th
│ │ │ │ -00001540: 6174 2074 6865 2073 697a 6520 7368 6f75  at the size shou
│ │ │ │ -00001550: 6c64 2062 650a 6576 616c 7561 7465 6420  ld be.evaluated 
│ │ │ │ -00001560: 6173 2073 6967 6e65 642e 2054 6869 7320  as signed. This 
│ │ │ │ -00001570: 6973 2062 6563 6175 7365 2061 206e 6567  is because a neg
│ │ │ │ -00001580: 6174 6976 6520 7661 6c75 6520 696e 6469  ative value indi
│ │ │ │ -00001590: 6361 7465 7320 7468 6174 2074 6865 0a65  cates that the.e
│ │ │ │ -000015a0: 6e74 7279 2069 7320 696e 2066 6163 7420  ntry is in fact 
│ │ │ │ -000015b0: 656d 7074 7920 2865 2e67 2e20 6974 2068  empty (e.g. it h
│ │ │ │ -000015c0: 6173 2062 6565 6e20 6465 6c65 7465 6429  as been deleted)
│ │ │ │ -000015d0: 2061 6e64 2074 6861 7420 7468 6520 6e65   and that the ne
│ │ │ │ -000015e0: 6761 7469 7665 0a76 616c 7565 206f 6620  gative.value of 
│ │ │ │ -000015f0: 7468 6174 206e 6567 6174 6976 6520 7661  that negative va
│ │ │ │ -00001600: 6c75 6520 2877 6869 6368 2069 7320 6f66  lue (which is of
│ │ │ │ -00001610: 2063 6f75 7273 6520 6120 706f 7369 7469   course a positi
│ │ │ │ -00001620: 7665 2076 616c 7565 2920 6973 0a74 6865  ve value) is.the
│ │ │ │ -00001630: 206f 6666 7365 7420 746f 2074 6865 206e   offset to the n
│ │ │ │ -00001640: 6578 7420 6b65 7974 6162 5f65 6e74 7279  ext keytab_entry
│ │ │ │ -00001650: 2e20 4261 7365 6420 6f6e 2074 6865 7365  . Based on these
│ │ │ │ -00001660: 2073 697a 6520 7661 6c75 6573 2061 6c6f   size values alo
│ │ │ │ -00001670: 6e65 0a74 6865 2065 6e74 6972 6520 6b65  ne.the entire ke
│ │ │ │ -00001680: 7974 6162 2066 696c 6520 6361 6e20 6265  ytab file can be
│ │ │ │ -00001690: 2074 7261 7665 7273 6564 2e0a 0a54 6865   traversed...The
│ │ │ │ -000016a0: 2073 697a 6520 6973 2066 6f6c 6c6f 7765   size is followe
│ │ │ │ -000016b0: 6420 6279 2061 2031 3620 6269 7420 6e75  d by a 16 bit nu
│ │ │ │ -000016c0: 6d5f 636f 6d70 6f6e 656e 7473 2066 6965  m_components fie
│ │ │ │ -000016d0: 6c64 2069 6e64 6963 6174 696e 6720 7468  ld indicating th
│ │ │ │ -000016e0: 650a 6e75 6d62 6572 206f 6620 636f 756e  e.number of coun
│ │ │ │ -000016f0: 7465 645f 6f63 7465 745f 7374 7269 6e67  ted_octet_string
│ │ │ │ -00001700: 2063 6f6d 706f 6e65 6e74 7320 696e 2074   components in t
│ │ │ │ -00001710: 6865 2063 6f6d 706f 6e65 6e74 7320 6172  he components ar
│ │ │ │ -00001720: 7261 792e 0a0a 5468 6520 6e75 6d5f 636f  ray...The num_co
│ │ │ │ -00001730: 6d70 6f6e 656e 7473 2066 6965 6c64 2069  mponents field i
│ │ │ │ -00001740: 7320 666f 6c6c 6f77 6564 2062 7920 6120  s followed by a 
│ │ │ │ -00001750: 636f 756e 7465 645f 6f63 7465 745f 7374  counted_octet_st
│ │ │ │ -00001760: 7269 6e67 0a72 6570 7265 7365 6e74 696e  ring.representin
│ │ │ │ -00001770: 6720 7468 6520 7265 616c 6d20 6f66 2074  g the realm of t
│ │ │ │ -00001780: 6865 2070 7269 6e63 6970 616c 2e0a 0a41  he principal...A
│ │ │ │ -00001790: 2063 6f75 6e74 6564 5f6f 6374 6574 5f73   counted_octet_s
│ │ │ │ -000017a0: 7472 696e 6720 6973 2073 696d 706c 7920  tring is simply 
│ │ │ │ -000017b0: 616e 2061 7272 6179 206f 6620 6279 7465  an array of byte
│ │ │ │ -000017c0: 7320 7072 6566 6978 6564 2077 6974 6820  s prefixed with 
│ │ │ │ -000017d0: 6120 3136 0a62 6974 206c 656e 6774 682e  a 16.bit length.
│ │ │ │ -000017e0: 2046 6f72 2074 6865 2072 6561 6c6d 2061   For the realm a
│ │ │ │ -000017f0: 6e64 206e 616d 6520 636f 6d70 6f6e 656e  nd name componen
│ │ │ │ -00001800: 7473 2c20 7468 6520 636f 756e 7465 645f  ts, the counted_
│ │ │ │ -00001810: 6f63 7465 745f 7374 7269 6e67 0a62 7974  octet_string.byt
│ │ │ │ -00001820: 6573 2061 7265 2041 5343 4949 2065 6e63  es are ASCII enc
│ │ │ │ -00001830: 6f64 6564 2074 6578 7420 7769 7468 206e  oded text with n
│ │ │ │ -00001840: 6f20 7a65 726f 2074 6572 6d69 6e61 746f  o zero terminato
│ │ │ │ -00001850: 722e 0a0a 466f 6c6c 6f77 696e 6720 7468  r...Following th
│ │ │ │ -00001860: 6520 7265 616c 6d20 6973 2074 6865 2063  e realm is the c
│ │ │ │ -00001870: 6f6d 706f 6e65 6e74 7320 6172 7261 7920  omponents array 
│ │ │ │ -00001880: 7468 6174 2072 6570 7265 7365 6e74 7320  that represents 
│ │ │ │ -00001890: 7468 6520 6e61 6d65 206f 660a 7468 6520  the name of.the 
│ │ │ │ -000018a0: 7072 696e 6369 7061 6c2e 2054 6865 2074  principal. The t
│ │ │ │ -000018b0: 6578 7420 6f66 2074 6865 7365 2063 6f6d  ext of these com
│ │ │ │ -000018c0: 706f 6e65 6e74 7320 6d61 7920 6265 206a  ponents may be j
│ │ │ │ -000018d0: 6f69 6e65 6420 7769 7468 2073 6c61 7368  oined with slash
│ │ │ │ -000018e0: 730a 746f 2063 6f6e 7374 7275 6374 2074  s.to construct t
│ │ │ │ -000018f0: 6865 2074 7970 6963 616c 2053 504e 2072  he typical SPN r
│ │ │ │ -00001900: 6570 7265 7365 6e74 6174 696f 6e2e 2046  epresentation. F
│ │ │ │ -00001910: 6f72 2065 7861 6d70 6c65 2c20 7468 6520  or example, the 
│ │ │ │ -00001920: 7365 7276 6963 650a 7072 696e 6369 7061  service.principa
│ │ │ │ -00001930: 6c20 4854 5450 2f77 7777 2e66 6f6f 2e6e  l HTTP/www.foo.n
│ │ │ │ -00001940: 6574 4046 4f4f 2e4e 4554 2077 6f75 6c64  et@FOO.NET would
│ │ │ │ -00001950: 2063 6f6e 7369 7374 206f 6620 6e61 6d65   consist of name
│ │ │ │ -00001960: 2063 6f6d 706f 6e65 6e74 730a 2248 5454   components."HTT
│ │ │ │ -00001970: 5022 2066 6f6c 6c6f 7765 6420 6279 2022  P" followed by "
│ │ │ │ -00001980: 7777 772e 666f 6f2e 6e65 7422 2e0a 0a46  www.foo.net"...F
│ │ │ │ -00001990: 6f6c 6c6f 7769 6e67 2074 6865 2063 6f6d  ollowing the com
│ │ │ │ -000019a0: 706f 6e65 6e74 7320 6172 7261 7920 6973  ponents array is
│ │ │ │ -000019b0: 2074 6865 2033 3220 6269 7420 6e61 6d65   the 32 bit name
│ │ │ │ -000019c0: 5f74 7970 6520 2865 2e67 2e20 3120 6973  _type (e.g. 1 is
│ │ │ │ -000019d0: 0a4b 5242 355f 4e54 5f50 5249 4e43 4950  .KRB5_NT_PRINCIP
│ │ │ │ -000019e0: 414c 2c20 3220 6973 204b 5242 355f 4e54  AL, 2 is KRB5_NT
│ │ │ │ -000019f0: 5f53 5256 5f49 4e53 542c 2035 2069 7320  _SRV_INST, 5 is 
│ │ │ │ -00001a00: 4b52 4235 5f4e 545f 5549 442c 2065 7463  KRB5_NT_UID, etc
│ │ │ │ -00001a10: 292e 2049 6e0a 7072 6163 7469 6365 2074  ). In.practice t
│ │ │ │ -00001a20: 6865 206e 616d 655f 7479 7065 2069 7320  he name_type is 
│ │ │ │ -00001a30: 616c 6d6f 7374 2063 6572 7461 696e 6c79  almost certainly
│ │ │ │ -00001a40: 2031 206d 6561 6e69 6e67 204b 5242 355f   1 meaning KRB5_
│ │ │ │ -00001a50: 4e54 5f50 5249 4e43 4950 414c 2e0a 0a54  NT_PRINCIPAL...T
│ │ │ │ -00001a60: 6865 2033 3220 6269 7420 7469 6d65 7374  he 32 bit timest
│ │ │ │ -00001a70: 616d 7020 696e 6469 6361 7465 7320 7468  amp indicates th
│ │ │ │ -00001a80: 6520 7469 6d65 2074 6865 206b 6579 2077  e time the key w
│ │ │ │ -00001a90: 6173 2065 7374 6162 6c69 7368 6564 2066  as established f
│ │ │ │ -00001aa0: 6f72 2074 6861 740a 7072 696e 6369 7061  or that.principa
│ │ │ │ -00001ab0: 6c2e 2054 6865 2076 616c 7565 2072 6570  l. The value rep
│ │ │ │ -00001ac0: 7265 7365 6e74 7320 7468 6520 6e75 6d62  resents the numb
│ │ │ │ -00001ad0: 6572 206f 6620 7365 636f 6e64 7320 7369  er of seconds si
│ │ │ │ -00001ae0: 6e63 6520 4a61 6e20 312c 2031 3937 302e  nce Jan 1, 1970.
│ │ │ │ -00001af0: 0a0a 5468 6520 3820 6269 7420 766e 6f38  ..The 8 bit vno8
│ │ │ │ -00001b00: 2066 6965 6c64 2069 7320 7468 6520 7665   field is the ve
│ │ │ │ -00001b10: 7273 696f 6e20 6e75 6d62 6572 206f 6620  rsion number of 
│ │ │ │ -00001b20: 7468 6520 6b65 792e 2054 6869 7320 7661  the key. This va
│ │ │ │ -00001b30: 6c75 6520 6973 0a6f 7665 7272 6964 6465  lue is.overridde
│ │ │ │ -00001b40: 6e20 6279 2074 6865 2033 3220 6269 7420  n by the 32 bit 
│ │ │ │ -00001b50: 766e 6f20 6669 656c 6420 6966 2069 7420  vno field if it 
│ │ │ │ -00001b60: 6973 2070 7265 7365 6e74 2e0a 0a54 6865  is present...The
│ │ │ │ -00001b70: 206b 6579 626c 6f63 6b20 7374 7275 6374   keyblock struct
│ │ │ │ -00001b80: 7572 6520 636f 6e73 6973 7473 206f 6620  ure consists of 
│ │ │ │ -00001b90: 6120 3136 2062 6974 2076 616c 7565 2069  a 16 bit value i
│ │ │ │ -00001ba0: 6e64 6963 6174 696e 6720 7468 6520 6b65  ndicating the ke
│ │ │ │ -00001bb0: 7974 7970 650a 2865 2e67 2e20 3320 6973  ytype.(e.g. 3 is
│ │ │ │ -00001bc0: 2064 6573 2d63 6263 2d6d 6435 2c20 3233   des-cbc-md5, 23
│ │ │ │ -00001bd0: 2069 7320 6172 6366 6f75 722d 686d 6163   is arcfour-hmac
│ │ │ │ -00001be0: 2d6d 6435 2c20 3136 2069 7320 6465 7333  -md5, 16 is des3
│ │ │ │ -00001bf0: 2d63 6263 2d73 6861 312c 0a65 7463 292e  -cbc-sha1,.etc).
│ │ │ │ -00001c00: 2054 6869 7320 6973 2066 6f6c 6c6f 7765   This is followe
│ │ │ │ -00001c10: 6420 6279 2061 2063 6f75 6e74 6564 5f6f  d by a counted_o
│ │ │ │ -00001c20: 6374 6574 5f73 7472 696e 6720 636f 6e74  ctet_string cont
│ │ │ │ -00001c30: 6169 6e69 6e67 2074 6865 206b 6579 2e0a  aining the key..
│ │ │ │ -00001c40: 0a54 6865 206c 6173 7420 6669 656c 6420  .The last field 
│ │ │ │ -00001c50: 6f66 2074 6865 206b 6579 7461 625f 656e  of the keytab_en
│ │ │ │ -00001c60: 7472 7920 7374 7275 6374 7572 6520 6973  try structure is
│ │ │ │ -00001c70: 206f 7074 696f 6e61 6c2e 2049 6620 7468   optional. If th
│ │ │ │ -00001c80: 6520 7369 7a65 206f 660a 7468 6520 6b65  e size of.the ke
│ │ │ │ -00001c90: 7974 6162 5f65 6e74 7279 2069 6e64 6963  ytab_entry indic
│ │ │ │ -00001ca0: 6174 6573 2074 6861 7420 7468 6572 6520  ates that there 
│ │ │ │ -00001cb0: 6172 6520 6174 206c 6561 7374 2034 2062  are at least 4 b
│ │ │ │ -00001cc0: 7974 6573 2072 656d 6169 6e69 6e67 2c0a  ytes remaining,.
│ │ │ │ -00001cd0: 6120 3332 2062 6974 2076 616c 7565 2072  a 32 bit value r
│ │ │ │ -00001ce0: 6570 7265 7365 6e74 696e 6720 7468 6520  epresenting the 
│ │ │ │ -00001cf0: 6b65 7920 7665 7273 696f 6e20 6e75 6d62  key version numb
│ │ │ │ -00001d00: 6572 2069 7320 7072 6573 656e 742e 2054  er is present. T
│ │ │ │ -00001d10: 6869 730a 7661 6c75 6520 7375 7065 7273  his.value supers
│ │ │ │ -00001d20: 6564 6573 2074 6865 2038 2062 6974 2076  edes the 8 bit v
│ │ │ │ -00001d30: 6e6f 3820 7661 6c75 6520 7072 6563 6565  no8 value precee
│ │ │ │ -00001d40: 6469 6e67 2074 6865 206b 6579 626c 6f63  ding the keybloc
│ │ │ │ -00001d50: 6b2e 0a0a 4f6c 6465 7220 6b65 7974 6162  k...Older keytab
│ │ │ │ -00001d60: 7320 7769 7468 2061 2066 696c 655f 666f  s with a file_fo
│ │ │ │ -00001d70: 726d 6174 5f76 6572 7369 6f6e 206f 6620  rmat_version of 
│ │ │ │ -00001d80: 3078 3530 3120 6172 6520 6469 6666 6572  0x501 are differ
│ │ │ │ -00001d90: 656e 7420 696e 0a74 6872 6565 2077 6179  ent in.three way
│ │ │ │ -00001da0: 733a 0a0a 2020 3129 2041 6c6c 2069 6e74  s:..  1) All int
│ │ │ │ -00001db0: 6567 6572 7320 6172 6520 696e 2068 6f73  egers are in hos
│ │ │ │ -00001dc0: 7420 6279 7465 206f 7264 6572 205b 315d  t byte order [1]
│ │ │ │ -00001dd0: 2e0a 2020 3229 2054 6865 206e 756d 5f63  ..  2) The num_c
│ │ │ │ -00001de0: 6f6d 706f 6e65 6e74 7320 6669 656c 6420  omponents field 
│ │ │ │ -00001df0: 6973 2031 2074 6f6f 206c 6172 6765 2028  is 1 too large (
│ │ │ │ -00001e00: 692e 652e 2061 6674 6572 2064 6563 6f64  i.e. after decod
│ │ │ │ -00001e10: 696e 672c 0a20 2020 2020 6465 6372 656d  ing,.     decrem
│ │ │ │ -00001e20: 656e 7420 6279 2031 292e 0a20 2033 2920  ent by 1)..  3) 
│ │ │ │ -00001e30: 5468 6520 3332 2062 6974 206e 616d 655f  The 32 bit name_
│ │ │ │ -00001e40: 7479 7065 2066 6965 6c64 2069 7320 6e6f  type field is no
│ │ │ │ -00001e50: 7420 7072 6573 656e 742e 0a0a 5b31 5d20  t present...[1] 
│ │ │ │ -00001e60: 5468 6520 6669 6c65 5f66 6f72 6d61 745f  The file_format_
│ │ │ │ -00001e70: 7665 7273 696f 6e20 6669 656c 6420 7368  version field sh
│ │ │ │ -00001e80: 6f75 6c64 2072 6561 6c6c 7920 6265 2074  ould really be t
│ │ │ │ -00001e90: 7265 6174 6564 2061 7320 7477 6f0a 2020  reated as two.  
│ │ │ │ -00001ea0: 2020 7365 7061 7261 7465 2038 2062 6974    separate 8 bit
│ │ │ │ -00001eb0: 2071 7561 6e74 6974 6965 7320 7265 7072   quantities repr
│ │ │ │ -00001ec0: 6573 656e 7469 6e67 2074 6865 206d 616a  esenting the maj
│ │ │ │ -00001ed0: 6f72 2061 6e64 206d 696e 6f72 2076 6572  or and minor ver
│ │ │ │ -00001ee0: 7369 6f6e 0a20 2020 206e 756d 6265 7220  sion.    number 
│ │ │ │ -00001ef0: 7265 7370 6563 7469 7665 6c79 2e0a 0a50  respectively...P
│ │ │ │ -00001f00: 6572 6d69 7373 696f 6e20 746f 2063 6f70  ermission to cop
│ │ │ │ -00001f10: 792c 206d 6f64 6966 792c 2061 6e64 2064  y, modify, and d
│ │ │ │ -00001f20: 6973 7472 6962 7574 6520 7468 6973 2064  istribute this d
│ │ │ │ -00001f30: 6f63 756d 656e 742c 2077 6974 6820 6f72  ocument, with or
│ │ │ │ -00001f40: 0a77 6974 686f 7574 206d 6f64 6966 6963  .without modific
│ │ │ │ -00001f50: 6174 696f 6e2c 2066 6f72 2061 6e79 2070  ation, for any p
│ │ │ │ -00001f60: 7572 706f 7365 2061 6e64 2077 6974 686f  urpose and witho
│ │ │ │ -00001f70: 7574 2066 6565 206f 7220 726f 7961 6c74  ut fee or royalt
│ │ │ │ -00001f80: 7920 6973 0a68 6572 6562 7920 6772 616e  y is.hereby gran
│ │ │ │ -00001f90: 7465 642c 2070 726f 7669 6465 6420 7468  ted, provided th
│ │ │ │ -00001fa0: 6174 2079 6f75 2069 6e63 6c75 6465 2074  at you include t
│ │ │ │ -00001fb0: 6869 7320 636f 7079 7269 6768 7420 6e6f  his copyright no
│ │ │ │ -00001fc0: 7469 6365 2069 6e20 414c 4c0a 636f 7069  tice in ALL.copi
│ │ │ │ -00001fd0: 6573 206f 6620 7468 6520 646f 6375 6d65  es of the docume
│ │ │ │ -00001fe0: 6e74 206f 7220 706f 7274 696f 6e73 2074  nt or portions t
│ │ │ │ -00001ff0: 6865 7265 6f66 2c20 696e 636c 7564 696e  hereof, includin
│ │ │ │ -00002000: 6720 6d6f 6469 6669 6361 7469 6f6e 732e  g modifications.
│ │ │ │ -00002010: 0a0a 1f0a 4669 6c65 3a20 7368 6973 6869  ....File: shishi
│ │ │ │ -00002020: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 5468  .info,  Node: Th
│ │ │ │ -00002030: 6520 4372 6564 656e 7469 616c 2043 6163  e Credential Cac
│ │ │ │ -00002040: 6865 2042 696e 6172 7920 4669 6c65 2046  he Binary File F
│ │ │ │ -00002050: 6f72 6d61 742c 2020 5072 6576 3a20 5468  ormat,  Prev: Th
│ │ │ │ -00002060: 6520 4b65 7974 6162 2042 696e 6172 7920  e Keytab Binary 
│ │ │ │ -00002070: 4669 6c65 2046 6f72 6d61 742c 2020 5570  File Format,  Up
│ │ │ │ -00002080: 3a20 5072 6f74 6f63 6f6c 2045 7874 656e  : Protocol Exten
│ │ │ │ -00002090: 7369 6f6e 730a 0a42 2e36 2054 6865 2043  sions..B.6 The C
│ │ │ │ -000020a0: 7265 6465 6e74 6961 6c20 4361 6368 6520  redential Cache 
│ │ │ │ -000020b0: 4269 6e61 7279 2046 696c 6520 466f 726d  Binary File Form
│ │ │ │ -000020c0: 6174 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  at.=============
│ │ │ │ +00000e10: 3d3d 3d3d 0a0a 5468 6520 6b65 7974 6162  ====..The keytab
│ │ │ │ +00000e20: 2066 696c 6520 666f 726d 6174 2069 7320   file format is 
│ │ │ │ +00000e30: 6465 7363 7269 6265 6420 696e 2074 6865  described in the
│ │ │ │ +00000e40: 2066 696c 6520 e280 986b 6579 7461 622e   file ...keytab.
│ │ │ │ +00000e50: 7478 74e2 8099 2c20 6865 7265 0a69 6e63  txt..., here.inc
│ │ │ │ +00000e60: 6c75 6465 6420 7665 7262 6174 696d 2e0a  luded verbatim..
│ │ │ │ +00000e70: 0a54 6865 204b 6572 6265 726f 7320 4b65  .The Kerberos Ke
│ │ │ │ +00000e80: 7974 6162 2042 696e 6172 7920 4669 6c65  ytab Binary File
│ │ │ │ +00000e90: 2046 6f72 6d61 740a 436f 7079 7269 6768   Format.Copyrigh
│ │ │ │ +00000ea0: 7420 2843 2920 3230 3036 204d 6963 6861  t (C) 2006 Micha
│ │ │ │ +00000eb0: 656c 2042 2041 6c6c 656e 203c 6d62 6132  el B Allen <mba2
│ │ │ │ +00000ec0: 3030 3020 696f 706c 6578 2e63 6f6d 3e0a  000 ioplex.com>.
│ │ │ │ +00000ed0: 6874 7470 3a2f 2f77 7777 2e69 6f70 6c65  http://www.iople
│ │ │ │ +00000ee0: 782e 636f 6d2f 7574 696c 6974 6965 732f  x.com/utilities/
│ │ │ │ +00000ef0: 6b65 7974 6162 2e74 7874 0a4c 6173 7420  keytab.txt.Last 
│ │ │ │ +00000f00: 7570 6461 7465 643a 2046 7269 204d 6179  updated: Fri May
│ │ │ │ +00000f10: 2020 3520 3133 3a33 393a 3430 2045 4454    5 13:39:40 EDT
│ │ │ │ +00000f20: 2032 3030 360a 0a54 6865 204d 4954 206b   2006..The MIT k
│ │ │ │ +00000f30: 6579 7461 6220 6269 6e61 7279 2066 6f72  eytab binary for
│ │ │ │ +00000f40: 6d61 7420 6973 206e 6f74 2061 2073 7461  mat is not a sta
│ │ │ │ +00000f50: 6e64 6172 6420 666f 726d 6174 2c20 6e6f  ndard format, no
│ │ │ │ +00000f60: 7220 6973 2069 740a 646f 6375 6d65 6e74  r is it.document
│ │ │ │ +00000f70: 6564 2061 6e79 7768 6572 6520 696e 2064  ed anywhere in d
│ │ │ │ +00000f80: 6574 6169 6c2e 2054 6865 2066 6f72 6d61  etail. The forma
│ │ │ │ +00000f90: 7420 6861 7320 6576 6f6c 7665 6420 616e  t has evolved an
│ │ │ │ +00000fa0: 6420 6d61 7920 636f 6e74 696e 7565 0a74  d may continue.t
│ │ │ │ +00000fb0: 6f2e 2049 7420 6973 2068 6f77 6576 6572  o. It is however
│ │ │ │ +00000fc0: 2075 6e64 6572 7374 6f6f 6420 6279 2073   understood by s
│ │ │ │ +00000fd0: 6576 6572 616c 204b 6572 6265 726f 7320  everal Kerberos 
│ │ │ │ +00000fe0: 696d 706c 656d 656e 7461 7469 6f6e 7320  implementations 
│ │ │ │ +00000ff0: 696e 636c 7564 696e 670a 4865 696d 6461  including.Heimda
│ │ │ │ +00001000: 6c20 616e 6420 6f66 2063 6f75 7273 6520  l and of course 
│ │ │ │ +00001010: 4d49 5420 616e 6420 6b65 7974 6162 2066  MIT and keytab f
│ │ │ │ +00001020: 696c 6573 2061 7265 2063 7265 6174 6564  iles are created
│ │ │ │ +00001030: 2062 7920 7468 6520 6b74 7061 7373 2e65   by the ktpass.e
│ │ │ │ +00001040: 7865 0a75 7469 6c69 7479 2066 726f 6d20  xe.utility from 
│ │ │ │ +00001050: 5769 6e64 6f77 732e 2053 6f20 6974 2068  Windows. So it h
│ │ │ │ +00001060: 6173 2065 7374 6162 6c69 7368 6564 2069  as established i
│ │ │ │ +00001070: 7473 656c 6620 6173 2074 6865 2064 6566  tself as the def
│ │ │ │ +00001080: 6163 746f 2066 6f72 6d61 740a 666f 7220  acto format.for 
│ │ │ │ +00001090: 7374 6f72 696e 6720 4b65 7262 6572 6f73  storing Kerberos
│ │ │ │ +000010a0: 206b 6579 732e 0a0a 5468 6520 666f 6c6c   keys...The foll
│ │ │ │ +000010b0: 6f77 696e 6720 432d 6c69 6b65 2073 7472  owing C-like str
│ │ │ │ +000010c0: 7563 7475 7265 2064 6566 696e 6974 696f  ucture definitio
│ │ │ │ +000010d0: 6e73 2069 6c6c 7573 7472 6174 6520 7468  ns illustrate th
│ │ │ │ +000010e0: 6520 4d49 5420 6b65 7974 6162 0a66 696c  e MIT keytab.fil
│ │ │ │ +000010f0: 6520 666f 726d 6174 2e20 416c 6c20 7661  e format. All va
│ │ │ │ +00001100: 6c75 6573 2061 7265 2069 6e20 6e65 7477  lues are in netw
│ │ │ │ +00001110: 6f72 6b20 6279 7465 206f 7264 6572 2e20  ork byte order. 
│ │ │ │ +00001120: 416c 6c20 7465 7874 2069 7320 4153 4349  All text is ASCI
│ │ │ │ +00001130: 492e 0a0a 2020 6b65 7974 6162 207b 0a20  I...  keytab {. 
│ │ │ │ +00001140: 2020 2020 2075 696e 7431 365f 7420 6669       uint16_t fi
│ │ │ │ +00001150: 6c65 5f66 6f72 6d61 745f 7665 7273 696f  le_format_versio
│ │ │ │ +00001160: 6e3b 2020 2020 2020 2020 2020 2020 2020  n;              
│ │ │ │ +00001170: 2020 2020 2020 2f2a 2030 7835 3032 202a        /* 0x502 *
│ │ │ │ +00001180: 2f0a 2020 2020 2020 6b65 7974 6162 5f65  /.      keytab_e
│ │ │ │ +00001190: 6e74 7279 2065 6e74 7269 6573 5b2a 5d3b  ntry entries[*];
│ │ │ │ +000011a0: 0a20 207d 3b0a 0a20 206b 6579 7461 625f  .  };..  keytab_
│ │ │ │ +000011b0: 656e 7472 7920 7b0a 2020 2020 2020 696e  entry {.      in
│ │ │ │ +000011c0: 7433 325f 7420 7369 7a65 3b0a 2020 2020  t32_t size;.    
│ │ │ │ +000011d0: 2020 7569 6e74 3136 5f74 206e 756d 5f63    uint16_t num_c
│ │ │ │ +000011e0: 6f6d 706f 6e65 6e74 733b 2020 2020 2f2a  omponents;    /*
│ │ │ │ +000011f0: 2073 7562 2031 2069 6620 7665 7273 696f   sub 1 if versio
│ │ │ │ +00001200: 6e20 3078 3530 3120 2a2f 0a20 2020 2020  n 0x501 */.     
│ │ │ │ +00001210: 2063 6f75 6e74 6564 5f6f 6374 6574 5f73   counted_octet_s
│ │ │ │ +00001220: 7472 696e 6720 7265 616c 6d3b 0a20 2020  tring realm;.   
│ │ │ │ +00001230: 2020 2063 6f75 6e74 6564 5f6f 6374 6574     counted_octet
│ │ │ │ +00001240: 5f73 7472 696e 6720 636f 6d70 6f6e 656e  _string componen
│ │ │ │ +00001250: 7473 5b6e 756d 5f63 6f6d 706f 6e65 6e74  ts[num_component
│ │ │ │ +00001260: 735d 3b0a 2020 2020 2020 7569 6e74 3332  s];.      uint32
│ │ │ │ +00001270: 5f74 206e 616d 655f 7479 7065 3b20 2020  _t name_type;   
│ │ │ │ +00001280: 2f2a 206e 6f74 2070 7265 7365 6e74 2069  /* not present i
│ │ │ │ +00001290: 6620 7665 7273 696f 6e20 3078 3530 3120  f version 0x501 
│ │ │ │ +000012a0: 2a2f 0a20 2020 2020 2075 696e 7433 325f  */.      uint32_
│ │ │ │ +000012b0: 7420 7469 6d65 7374 616d 703b 0a20 2020  t timestamp;.   
│ │ │ │ +000012c0: 2020 2075 696e 7438 5f74 2076 6e6f 383b     uint8_t vno8;
│ │ │ │ +000012d0: 0a20 2020 2020 206b 6579 626c 6f63 6b20  .      keyblock 
│ │ │ │ +000012e0: 6b65 793b 0a20 2020 2020 2075 696e 7433  key;.      uint3
│ │ │ │ +000012f0: 325f 7420 766e 6f3b 202f 2a20 6f6e 6c79  2_t vno; /* only
│ │ │ │ +00001300: 2070 7265 7365 6e74 2069 6620 3e3d 2034   present if >= 4
│ │ │ │ +00001310: 2062 7974 6573 206c 6566 7420 696e 2065   bytes left in e
│ │ │ │ +00001320: 6e74 7279 202a 2f0a 2020 7d3b 0a0a 2020  ntry */.  };..  
│ │ │ │ +00001330: 636f 756e 7465 645f 6f63 7465 745f 7374  counted_octet_st
│ │ │ │ +00001340: 7269 6e67 207b 0a20 2020 2020 2075 696e  ring {.      uin
│ │ │ │ +00001350: 7431 365f 7420 6c65 6e67 7468 3b0a 2020  t16_t length;.  
│ │ │ │ +00001360: 2020 2020 7569 6e74 385f 7420 6461 7461      uint8_t data
│ │ │ │ +00001370: 5b6c 656e 6774 685d 3b0a 2020 7d3b 0a0a  [length];.  };..
│ │ │ │ +00001380: 2020 6b65 7962 6c6f 636b 207b 0a20 2020    keyblock {.   
│ │ │ │ +00001390: 2020 2075 696e 7431 365f 7420 7479 7065     uint16_t type
│ │ │ │ +000013a0: 3b0a 2020 2020 2020 636f 756e 7465 645f  ;.      counted_
│ │ │ │ +000013b0: 6f63 7465 745f 7374 7269 6e67 3b0a 2020  octet_string;.  
│ │ │ │ +000013c0: 7d3b 0a0a 5468 6520 6b65 7974 6162 2066  };..The keytab f
│ │ │ │ +000013d0: 696c 6520 666f 726d 6174 2062 6567 696e  ile format begin
│ │ │ │ +000013e0: 7320 7769 7468 2074 6865 2031 3620 6269  s with the 16 bi
│ │ │ │ +000013f0: 7420 6669 6c65 5f66 6f72 6d61 745f 7665  t file_format_ve
│ │ │ │ +00001400: 7273 696f 6e20 7768 6963 680a 6174 2074  rsion which.at t
│ │ │ │ +00001410: 6865 2074 696d 6520 7468 6973 2064 6f63  he time this doc
│ │ │ │ +00001420: 756d 656e 7420 7761 7320 6175 7468 6f72  ument was author
│ │ │ │ +00001430: 6564 2069 7320 3078 3530 322e 2054 6865  ed is 0x502. The
│ │ │ │ +00001440: 2066 6f72 6d61 7420 6f66 206f 6c64 6572   format of older
│ │ │ │ +00001450: 0a6b 6579 7461 6273 2069 7320 6465 7363  .keytabs is desc
│ │ │ │ +00001460: 7269 6265 6420 6174 2074 6865 2065 6e64  ribed at the end
│ │ │ │ +00001470: 206f 6620 7468 6973 2064 6f63 756d 656e   of this documen
│ │ │ │ +00001480: 742e 0a0a 5468 6520 6669 6c65 5f66 6f72  t...The file_for
│ │ │ │ +00001490: 6d61 745f 7665 7273 696f 6e20 6973 2069  mat_version is i
│ │ │ │ +000014a0: 6d6d 6564 6961 7465 6c79 2066 6f6c 6c6f  mmediately follo
│ │ │ │ +000014b0: 7765 6420 6279 2061 6e20 6172 7261 7920  wed by an array 
│ │ │ │ +000014c0: 6f66 0a6b 6579 7461 625f 656e 7472 7920  of.keytab_entry 
│ │ │ │ +000014d0: 7374 7275 6374 7572 6573 2077 6869 6368  structures which
│ │ │ │ +000014e0: 2061 7265 2070 7265 6669 7865 6420 7769   are prefixed wi
│ │ │ │ +000014f0: 7468 2061 2033 3220 6269 7420 7369 7a65  th a 32 bit size
│ │ │ │ +00001500: 2069 6e64 6963 6174 696e 670a 7468 6520   indicating.the 
│ │ │ │ +00001510: 6e75 6d62 6572 206f 6620 6279 7465 7320  number of bytes 
│ │ │ │ +00001520: 7468 6174 2066 6f6c 6c6f 7720 696e 2074  that follow in t
│ │ │ │ +00001530: 6865 2065 6e74 7279 2e20 4e6f 7465 2074  he entry. Note t
│ │ │ │ +00001540: 6861 7420 7468 6520 7369 7a65 2073 686f  hat the size sho
│ │ │ │ +00001550: 756c 6420 6265 0a65 7661 6c75 6174 6564  uld be.evaluated
│ │ │ │ +00001560: 2061 7320 7369 676e 6564 2e20 5468 6973   as signed. This
│ │ │ │ +00001570: 2069 7320 6265 6361 7573 6520 6120 6e65   is because a ne
│ │ │ │ +00001580: 6761 7469 7665 2076 616c 7565 2069 6e64  gative value ind
│ │ │ │ +00001590: 6963 6174 6573 2074 6861 7420 7468 650a  icates that the.
│ │ │ │ +000015a0: 656e 7472 7920 6973 2069 6e20 6661 6374  entry is in fact
│ │ │ │ +000015b0: 2065 6d70 7479 2028 652e 672e 2069 7420   empty (e.g. it 
│ │ │ │ +000015c0: 6861 7320 6265 656e 2064 656c 6574 6564  has been deleted
│ │ │ │ +000015d0: 2920 616e 6420 7468 6174 2074 6865 206e  ) and that the n
│ │ │ │ +000015e0: 6567 6174 6976 650a 7661 6c75 6520 6f66  egative.value of
│ │ │ │ +000015f0: 2074 6861 7420 6e65 6761 7469 7665 2076   that negative v
│ │ │ │ +00001600: 616c 7565 2028 7768 6963 6820 6973 206f  alue (which is o
│ │ │ │ +00001610: 6620 636f 7572 7365 2061 2070 6f73 6974  f course a posit
│ │ │ │ +00001620: 6976 6520 7661 6c75 6529 2069 730a 7468  ive value) is.th
│ │ │ │ +00001630: 6520 6f66 6673 6574 2074 6f20 7468 6520  e offset to the 
│ │ │ │ +00001640: 6e65 7874 206b 6579 7461 625f 656e 7472  next keytab_entr
│ │ │ │ +00001650: 792e 2042 6173 6564 206f 6e20 7468 6573  y. Based on thes
│ │ │ │ +00001660: 6520 7369 7a65 2076 616c 7565 7320 616c  e size values al
│ │ │ │ +00001670: 6f6e 650a 7468 6520 656e 7469 7265 206b  one.the entire k
│ │ │ │ +00001680: 6579 7461 6220 6669 6c65 2063 616e 2062  eytab file can b
│ │ │ │ +00001690: 6520 7472 6176 6572 7365 642e 0a0a 5468  e traversed...Th
│ │ │ │ +000016a0: 6520 7369 7a65 2069 7320 666f 6c6c 6f77  e size is follow
│ │ │ │ +000016b0: 6564 2062 7920 6120 3136 2062 6974 206e  ed by a 16 bit n
│ │ │ │ +000016c0: 756d 5f63 6f6d 706f 6e65 6e74 7320 6669  um_components fi
│ │ │ │ +000016d0: 656c 6420 696e 6469 6361 7469 6e67 2074  eld indicating t
│ │ │ │ +000016e0: 6865 0a6e 756d 6265 7220 6f66 2063 6f75  he.number of cou
│ │ │ │ +000016f0: 6e74 6564 5f6f 6374 6574 5f73 7472 696e  nted_octet_strin
│ │ │ │ +00001700: 6720 636f 6d70 6f6e 656e 7473 2069 6e20  g components in 
│ │ │ │ +00001710: 7468 6520 636f 6d70 6f6e 656e 7473 2061  the components a
│ │ │ │ +00001720: 7272 6179 2e0a 0a54 6865 206e 756d 5f63  rray...The num_c
│ │ │ │ +00001730: 6f6d 706f 6e65 6e74 7320 6669 656c 6420  omponents field 
│ │ │ │ +00001740: 6973 2066 6f6c 6c6f 7765 6420 6279 2061  is followed by a
│ │ │ │ +00001750: 2063 6f75 6e74 6564 5f6f 6374 6574 5f73   counted_octet_s
│ │ │ │ +00001760: 7472 696e 670a 7265 7072 6573 656e 7469  tring.representi
│ │ │ │ +00001770: 6e67 2074 6865 2072 6561 6c6d 206f 6620  ng the realm of 
│ │ │ │ +00001780: 7468 6520 7072 696e 6369 7061 6c2e 0a0a  the principal...
│ │ │ │ +00001790: 4120 636f 756e 7465 645f 6f63 7465 745f  A counted_octet_
│ │ │ │ +000017a0: 7374 7269 6e67 2069 7320 7369 6d70 6c79  string is simply
│ │ │ │ +000017b0: 2061 6e20 6172 7261 7920 6f66 2062 7974   an array of byt
│ │ │ │ +000017c0: 6573 2070 7265 6669 7865 6420 7769 7468  es prefixed with
│ │ │ │ +000017d0: 2061 2031 360a 6269 7420 6c65 6e67 7468   a 16.bit length
│ │ │ │ +000017e0: 2e20 466f 7220 7468 6520 7265 616c 6d20  . For the realm 
│ │ │ │ +000017f0: 616e 6420 6e61 6d65 2063 6f6d 706f 6e65  and name compone
│ │ │ │ +00001800: 6e74 732c 2074 6865 2063 6f75 6e74 6564  nts, the counted
│ │ │ │ +00001810: 5f6f 6374 6574 5f73 7472 696e 670a 6279  _octet_string.by
│ │ │ │ +00001820: 7465 7320 6172 6520 4153 4349 4920 656e  tes are ASCII en
│ │ │ │ +00001830: 636f 6465 6420 7465 7874 2077 6974 6820  coded text with 
│ │ │ │ +00001840: 6e6f 207a 6572 6f20 7465 726d 696e 6174  no zero terminat
│ │ │ │ +00001850: 6f72 2e0a 0a46 6f6c 6c6f 7769 6e67 2074  or...Following t
│ │ │ │ +00001860: 6865 2072 6561 6c6d 2069 7320 7468 6520  he realm is the 
│ │ │ │ +00001870: 636f 6d70 6f6e 656e 7473 2061 7272 6179  components array
│ │ │ │ +00001880: 2074 6861 7420 7265 7072 6573 656e 7473   that represents
│ │ │ │ +00001890: 2074 6865 206e 616d 6520 6f66 0a74 6865   the name of.the
│ │ │ │ +000018a0: 2070 7269 6e63 6970 616c 2e20 5468 6520   principal. The 
│ │ │ │ +000018b0: 7465 7874 206f 6620 7468 6573 6520 636f  text of these co
│ │ │ │ +000018c0: 6d70 6f6e 656e 7473 206d 6179 2062 6520  mponents may be 
│ │ │ │ +000018d0: 6a6f 696e 6564 2077 6974 6820 736c 6173  joined with slas
│ │ │ │ +000018e0: 6873 0a74 6f20 636f 6e73 7472 7563 7420  hs.to construct 
│ │ │ │ +000018f0: 7468 6520 7479 7069 6361 6c20 5350 4e20  the typical SPN 
│ │ │ │ +00001900: 7265 7072 6573 656e 7461 7469 6f6e 2e20  representation. 
│ │ │ │ +00001910: 466f 7220 6578 616d 706c 652c 2074 6865  For example, the
│ │ │ │ +00001920: 2073 6572 7669 6365 0a70 7269 6e63 6970   service.princip
│ │ │ │ +00001930: 616c 2048 5454 502f 7777 772e 666f 6f2e  al HTTP/www.foo.
│ │ │ │ +00001940: 6e65 7440 464f 4f2e 4e45 5420 776f 756c  net@FOO.NET woul
│ │ │ │ +00001950: 6420 636f 6e73 6973 7420 6f66 206e 616d  d consist of nam
│ │ │ │ +00001960: 6520 636f 6d70 6f6e 656e 7473 0a22 4854  e components."HT
│ │ │ │ +00001970: 5450 2220 666f 6c6c 6f77 6564 2062 7920  TP" followed by 
│ │ │ │ +00001980: 2277 7777 2e66 6f6f 2e6e 6574 222e 0a0a  "www.foo.net"...
│ │ │ │ +00001990: 466f 6c6c 6f77 696e 6720 7468 6520 636f  Following the co
│ │ │ │ +000019a0: 6d70 6f6e 656e 7473 2061 7272 6179 2069  mponents array i
│ │ │ │ +000019b0: 7320 7468 6520 3332 2062 6974 206e 616d  s the 32 bit nam
│ │ │ │ +000019c0: 655f 7479 7065 2028 652e 672e 2031 2069  e_type (e.g. 1 i
│ │ │ │ +000019d0: 730a 4b52 4235 5f4e 545f 5052 494e 4349  s.KRB5_NT_PRINCI
│ │ │ │ +000019e0: 5041 4c2c 2032 2069 7320 4b52 4235 5f4e  PAL, 2 is KRB5_N
│ │ │ │ +000019f0: 545f 5352 565f 494e 5354 2c20 3520 6973  T_SRV_INST, 5 is
│ │ │ │ +00001a00: 204b 5242 355f 4e54 5f55 4944 2c20 6574   KRB5_NT_UID, et
│ │ │ │ +00001a10: 6329 2e20 496e 0a70 7261 6374 6963 6520  c). In.practice 
│ │ │ │ +00001a20: 7468 6520 6e61 6d65 5f74 7970 6520 6973  the name_type is
│ │ │ │ +00001a30: 2061 6c6d 6f73 7420 6365 7274 6169 6e6c   almost certainl
│ │ │ │ +00001a40: 7920 3120 6d65 616e 696e 6720 4b52 4235  y 1 meaning KRB5
│ │ │ │ +00001a50: 5f4e 545f 5052 494e 4349 5041 4c2e 0a0a  _NT_PRINCIPAL...
│ │ │ │ +00001a60: 5468 6520 3332 2062 6974 2074 696d 6573  The 32 bit times
│ │ │ │ +00001a70: 7461 6d70 2069 6e64 6963 6174 6573 2074  tamp indicates t
│ │ │ │ +00001a80: 6865 2074 696d 6520 7468 6520 6b65 7920  he time the key 
│ │ │ │ +00001a90: 7761 7320 6573 7461 626c 6973 6865 6420  was established 
│ │ │ │ +00001aa0: 666f 7220 7468 6174 0a70 7269 6e63 6970  for that.princip
│ │ │ │ +00001ab0: 616c 2e20 5468 6520 7661 6c75 6520 7265  al. The value re
│ │ │ │ +00001ac0: 7072 6573 656e 7473 2074 6865 206e 756d  presents the num
│ │ │ │ +00001ad0: 6265 7220 6f66 2073 6563 6f6e 6473 2073  ber of seconds s
│ │ │ │ +00001ae0: 696e 6365 204a 616e 2031 2c20 3139 3730  ince Jan 1, 1970
│ │ │ │ +00001af0: 2e0a 0a54 6865 2038 2062 6974 2076 6e6f  ...The 8 bit vno
│ │ │ │ +00001b00: 3820 6669 656c 6420 6973 2074 6865 2076  8 field is the v
│ │ │ │ +00001b10: 6572 7369 6f6e 206e 756d 6265 7220 6f66  ersion number of
│ │ │ │ +00001b20: 2074 6865 206b 6579 2e20 5468 6973 2076   the key. This v
│ │ │ │ +00001b30: 616c 7565 2069 730a 6f76 6572 7269 6464  alue is.overridd
│ │ │ │ +00001b40: 656e 2062 7920 7468 6520 3332 2062 6974  en by the 32 bit
│ │ │ │ +00001b50: 2076 6e6f 2066 6965 6c64 2069 6620 6974   vno field if it
│ │ │ │ +00001b60: 2069 7320 7072 6573 656e 742e 0a0a 5468   is present...Th
│ │ │ │ +00001b70: 6520 6b65 7962 6c6f 636b 2073 7472 7563  e keyblock struc
│ │ │ │ +00001b80: 7475 7265 2063 6f6e 7369 7374 7320 6f66  ture consists of
│ │ │ │ +00001b90: 2061 2031 3620 6269 7420 7661 6c75 6520   a 16 bit value 
│ │ │ │ +00001ba0: 696e 6469 6361 7469 6e67 2074 6865 206b  indicating the k
│ │ │ │ +00001bb0: 6579 7479 7065 0a28 652e 672e 2033 2069  eytype.(e.g. 3 i
│ │ │ │ +00001bc0: 7320 6465 732d 6362 632d 6d64 352c 2032  s des-cbc-md5, 2
│ │ │ │ +00001bd0: 3320 6973 2061 7263 666f 7572 2d68 6d61  3 is arcfour-hma
│ │ │ │ +00001be0: 632d 6d64 352c 2031 3620 6973 2064 6573  c-md5, 16 is des
│ │ │ │ +00001bf0: 332d 6362 632d 7368 6131 2c0a 6574 6329  3-cbc-sha1,.etc)
│ │ │ │ +00001c00: 2e20 5468 6973 2069 7320 666f 6c6c 6f77  . This is follow
│ │ │ │ +00001c10: 6564 2062 7920 6120 636f 756e 7465 645f  ed by a counted_
│ │ │ │ +00001c20: 6f63 7465 745f 7374 7269 6e67 2063 6f6e  octet_string con
│ │ │ │ +00001c30: 7461 696e 696e 6720 7468 6520 6b65 792e  taining the key.
│ │ │ │ +00001c40: 0a0a 5468 6520 6c61 7374 2066 6965 6c64  ..The last field
│ │ │ │ +00001c50: 206f 6620 7468 6520 6b65 7974 6162 5f65   of the keytab_e
│ │ │ │ +00001c60: 6e74 7279 2073 7472 7563 7475 7265 2069  ntry structure i
│ │ │ │ +00001c70: 7320 6f70 7469 6f6e 616c 2e20 4966 2074  s optional. If t
│ │ │ │ +00001c80: 6865 2073 697a 6520 6f66 0a74 6865 206b  he size of.the k
│ │ │ │ +00001c90: 6579 7461 625f 656e 7472 7920 696e 6469  eytab_entry indi
│ │ │ │ +00001ca0: 6361 7465 7320 7468 6174 2074 6865 7265  cates that there
│ │ │ │ +00001cb0: 2061 7265 2061 7420 6c65 6173 7420 3420   are at least 4 
│ │ │ │ +00001cc0: 6279 7465 7320 7265 6d61 696e 696e 672c  bytes remaining,
│ │ │ │ +00001cd0: 0a61 2033 3220 6269 7420 7661 6c75 6520  .a 32 bit value 
│ │ │ │ +00001ce0: 7265 7072 6573 656e 7469 6e67 2074 6865  representing the
│ │ │ │ +00001cf0: 206b 6579 2076 6572 7369 6f6e 206e 756d   key version num
│ │ │ │ +00001d00: 6265 7220 6973 2070 7265 7365 6e74 2e20  ber is present. 
│ │ │ │ +00001d10: 5468 6973 0a76 616c 7565 2073 7570 6572  This.value super
│ │ │ │ +00001d20: 7365 6465 7320 7468 6520 3820 6269 7420  sedes the 8 bit 
│ │ │ │ +00001d30: 766e 6f38 2076 616c 7565 2070 7265 6365  vno8 value prece
│ │ │ │ +00001d40: 6564 696e 6720 7468 6520 6b65 7962 6c6f  eding the keyblo
│ │ │ │ +00001d50: 636b 2e0a 0a4f 6c64 6572 206b 6579 7461  ck...Older keyta
│ │ │ │ +00001d60: 6273 2077 6974 6820 6120 6669 6c65 5f66  bs with a file_f
│ │ │ │ +00001d70: 6f72 6d61 745f 7665 7273 696f 6e20 6f66  ormat_version of
│ │ │ │ +00001d80: 2030 7835 3031 2061 7265 2064 6966 6665   0x501 are diffe
│ │ │ │ +00001d90: 7265 6e74 2069 6e0a 7468 7265 6520 7761  rent in.three wa
│ │ │ │ +00001da0: 7973 3a0a 0a20 2031 2920 416c 6c20 696e  ys:..  1) All in
│ │ │ │ +00001db0: 7465 6765 7273 2061 7265 2069 6e20 686f  tegers are in ho
│ │ │ │ +00001dc0: 7374 2062 7974 6520 6f72 6465 7220 5b31  st byte order [1
│ │ │ │ +00001dd0: 5d2e 0a20 2032 2920 5468 6520 6e75 6d5f  ]..  2) The num_
│ │ │ │ +00001de0: 636f 6d70 6f6e 656e 7473 2066 6965 6c64  components field
│ │ │ │ +00001df0: 2069 7320 3120 746f 6f20 6c61 7267 6520   is 1 too large 
│ │ │ │ +00001e00: 2869 2e65 2e20 6166 7465 7220 6465 636f  (i.e. after deco
│ │ │ │ +00001e10: 6469 6e67 2c0a 2020 2020 2064 6563 7265  ding,.     decre
│ │ │ │ +00001e20: 6d65 6e74 2062 7920 3129 2e0a 2020 3329  ment by 1)..  3)
│ │ │ │ +00001e30: 2054 6865 2033 3220 6269 7420 6e61 6d65   The 32 bit name
│ │ │ │ +00001e40: 5f74 7970 6520 6669 656c 6420 6973 206e  _type field is n
│ │ │ │ +00001e50: 6f74 2070 7265 7365 6e74 2e0a 0a5b 315d  ot present...[1]
│ │ │ │ +00001e60: 2054 6865 2066 696c 655f 666f 726d 6174   The file_format
│ │ │ │ +00001e70: 5f76 6572 7369 6f6e 2066 6965 6c64 2073  _version field s
│ │ │ │ +00001e80: 686f 756c 6420 7265 616c 6c79 2062 6520  hould really be 
│ │ │ │ +00001e90: 7472 6561 7465 6420 6173 2074 776f 0a20  treated as two. 
│ │ │ │ +00001ea0: 2020 2073 6570 6172 6174 6520 3820 6269     separate 8 bi
│ │ │ │ +00001eb0: 7420 7175 616e 7469 7469 6573 2072 6570  t quantities rep
│ │ │ │ +00001ec0: 7265 7365 6e74 696e 6720 7468 6520 6d61  resenting the ma
│ │ │ │ +00001ed0: 6a6f 7220 616e 6420 6d69 6e6f 7220 7665  jor and minor ve
│ │ │ │ +00001ee0: 7273 696f 6e0a 2020 2020 6e75 6d62 6572  rsion.    number
│ │ │ │ +00001ef0: 2072 6573 7065 6374 6976 656c 792e 0a0a   respectively...
│ │ │ │ +00001f00: 5065 726d 6973 7369 6f6e 2074 6f20 636f  Permission to co
│ │ │ │ +00001f10: 7079 2c20 6d6f 6469 6679 2c20 616e 6420  py, modify, and 
│ │ │ │ +00001f20: 6469 7374 7269 6275 7465 2074 6869 7320  distribute this 
│ │ │ │ +00001f30: 646f 6375 6d65 6e74 2c20 7769 7468 206f  document, with o
│ │ │ │ +00001f40: 720a 7769 7468 6f75 7420 6d6f 6469 6669  r.without modifi
│ │ │ │ +00001f50: 6361 7469 6f6e 2c20 666f 7220 616e 7920  cation, for any 
│ │ │ │ +00001f60: 7075 7270 6f73 6520 616e 6420 7769 7468  purpose and with
│ │ │ │ +00001f70: 6f75 7420 6665 6520 6f72 2072 6f79 616c  out fee or royal
│ │ │ │ +00001f80: 7479 2069 730a 6865 7265 6279 2067 7261  ty is.hereby gra
│ │ │ │ +00001f90: 6e74 6564 2c20 7072 6f76 6964 6564 2074  nted, provided t
│ │ │ │ +00001fa0: 6861 7420 796f 7520 696e 636c 7564 6520  hat you include 
│ │ │ │ +00001fb0: 7468 6973 2063 6f70 7972 6967 6874 206e  this copyright n
│ │ │ │ +00001fc0: 6f74 6963 6520 696e 2041 4c4c 0a63 6f70  otice in ALL.cop
│ │ │ │ +00001fd0: 6965 7320 6f66 2074 6865 2064 6f63 756d  ies of the docum
│ │ │ │ +00001fe0: 656e 7420 6f72 2070 6f72 7469 6f6e 7320  ent or portions 
│ │ │ │ +00001ff0: 7468 6572 656f 662c 2069 6e63 6c75 6469  thereof, includi
│ │ │ │ +00002000: 6e67 206d 6f64 6966 6963 6174 696f 6e73  ng modifications
│ │ │ │ +00002010: 2e0a 0a1f 0a46 696c 653a 2073 6869 7368  .....File: shish
│ │ │ │ +00002020: 692e 696e 666f 2c20 204e 6f64 653a 2054  i.info,  Node: T
│ │ │ │ +00002030: 6865 2043 7265 6465 6e74 6961 6c20 4361  he Credential Ca
│ │ │ │ +00002040: 6368 6520 4269 6e61 7279 2046 696c 6520  che Binary File 
│ │ │ │ +00002050: 466f 726d 6174 2c20 2050 7265 763a 2054  Format,  Prev: T
│ │ │ │ +00002060: 6865 204b 6579 7461 6220 4269 6e61 7279  he Keytab Binary
│ │ │ │ +00002070: 2046 696c 6520 466f 726d 6174 2c20 2055   File Format,  U
│ │ │ │ +00002080: 703a 2050 726f 746f 636f 6c20 4578 7465  p: Protocol Exte
│ │ │ │ +00002090: 6e73 696f 6e73 0a0a 422e 3620 5468 6520  nsions..B.6 The 
│ │ │ │ +000020a0: 4372 6564 656e 7469 616c 2043 6163 6865  Credential Cache
│ │ │ │ +000020b0: 2042 696e 6172 7920 4669 6c65 2046 6f72   Binary File For
│ │ │ │ +000020c0: 6d61 740a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  mat.============
│ │ │ │  000020d0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ -000020e0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a  ==============..
│ │ │ │ -000020f0: 5468 6520 6372 6564 656e 7469 616c 2063  The credential c
│ │ │ │ -00002100: 6163 6865 2066 696c 6520 666f 726d 6174  ache file format
│ │ │ │ -00002110: 2069 7320 6465 7363 7269 6265 6420 696e   is described in
│ │ │ │ -00002120: 2074 6865 2066 696c 6520 e280 986b 6579   the file ...key
│ │ │ │ -00002130: 7461 622e 7478 74e2 8099 2c0a 696e 636c  tab.txt...,.incl
│ │ │ │ -00002140: 7564 6564 2076 6572 6261 7469 6d2e 0a0a  uded verbatim...
│ │ │ │ -00002150: 5468 6520 4b65 7262 6572 6f73 2043 7265  The Kerberos Cre
│ │ │ │ -00002160: 6465 6e74 6961 6c20 4361 6368 6520 4269  dential Cache Bi
│ │ │ │ -00002170: 6e61 7279 2046 696c 6520 466f 726d 6174  nary File Format
│ │ │ │ -00002180: 0a43 6f70 7972 6967 6874 2028 4329 2032  .Copyright (C) 2
│ │ │ │ -00002190: 3030 362d 3230 3232 2053 696d 6f6e 204a  006-2022 Simon J
│ │ │ │ -000021a0: 6f73 6566 7373 6f6e 203c 7369 6d6f 6e20  osefsson <simon 
│ │ │ │ -000021b0: 6a6f 7365 6673 736f 6e2e 6f72 673e 0a68  josefsson.org>.h
│ │ │ │ -000021c0: 7474 703a 2f2f 6a6f 7365 6673 736f 6e2e  ttp://josefsson.
│ │ │ │ -000021d0: 6f72 672f 7368 6973 6869 2f63 6361 6368  org/shishi/ccach
│ │ │ │ -000021e0: 652e 7478 740a 4c61 7374 2075 7064 6174  e.txt.Last updat
│ │ │ │ -000021f0: 6564 3a20 5361 7420 5365 7020 3233 2031  ed: Sat Sep 23 1
│ │ │ │ -00002200: 323a 3034 3a31 3120 4345 5354 2032 3030  2:04:11 CEST 200
│ │ │ │ -00002210: 360a 0a4c 696b 6520 7468 6520 4d49 5420  6..Like the MIT 
│ │ │ │ -00002220: 6b65 7974 6162 2062 696e 6172 7920 666f  keytab binary fo
│ │ │ │ -00002230: 726d 6174 2028 7365 6520 4d69 6368 6165  rmat (see Michae
│ │ │ │ -00002240: 6c20 4220 416c 6c65 6e27 7320 7265 7665  l B Allen's reve
│ │ │ │ -00002250: 7273 650a 656e 6769 6e65 6572 6564 2064  rse.engineered d
│ │ │ │ -00002260: 6573 6372 6970 7469 6f6e 2069 6e20 6b65  escription in ke
│ │ │ │ -00002270: 7974 6162 2e74 7874 292c 2074 6865 2063  ytab.txt), the c
│ │ │ │ -00002280: 7265 6465 6e74 6961 6c20 6361 6368 6520  redential cache 
│ │ │ │ -00002290: 666f 726d 6174 2069 730a 6e6f 7420 7374  format is.not st
│ │ │ │ -000022a0: 616e 6461 7264 206e 6f72 2064 6f63 756d  andard nor docum
│ │ │ │ -000022b0: 656e 7465 6420 616e 7977 6865 7265 2e0a  ented anywhere..
│ │ │ │ -000022c0: 0a49 6e20 4320 7374 796c 6520 6e6f 7461  .In C style nota
│ │ │ │ -000022d0: 7469 6f6e 2c20 7468 6520 4d49 5420 6372  tion, the MIT cr
│ │ │ │ -000022e0: 6564 656e 7469 616c 2063 6163 6865 2066  edential cache f
│ │ │ │ -000022f0: 696c 6520 666f 726d 6174 2069 7320 6173  ile format is as
│ │ │ │ -00002300: 0a66 6f6c 6c6f 7773 2e20 2041 6c6c 2076  .follows.  All v
│ │ │ │ -00002310: 616c 7565 7320 6172 6520 696e 206e 6574  alues are in net
│ │ │ │ -00002320: 776f 726b 2062 7974 6520 6f72 6465 722e  work byte order.
│ │ │ │ -00002330: 2020 416c 6c20 7465 7874 2069 7320 4153    All text is AS
│ │ │ │ -00002340: 4349 492e 0a0a 6363 6163 6865 207b 0a20  CII...ccache {. 
│ │ │ │ -00002350: 2020 2020 2020 2020 2075 696e 7431 365f           uint16_
│ │ │ │ -00002360: 7420 6669 6c65 5f66 6f72 6d61 745f 7665  t file_format_ve
│ │ │ │ -00002370: 7273 696f 6e3b 202f 2a20 3078 3035 3034  rsion; /* 0x0504
│ │ │ │ -00002380: 202a 2f0a 2020 2020 2020 2020 2020 7569   */.          ui
│ │ │ │ -00002390: 6e74 3136 5f74 2068 6561 6465 726c 656e  nt16_t headerlen
│ │ │ │ -000023a0: 3b20 2020 2020 2020 2020 2020 2f2a 206f  ;           /* o
│ │ │ │ -000023b0: 6e6c 7920 6966 2076 6572 7369 6f6e 2069  nly if version i
│ │ │ │ -000023c0: 7320 3078 3035 3034 202a 2f0a 2020 2020  s 0x0504 */.    
│ │ │ │ -000023d0: 2020 2020 2020 6865 6164 6572 2068 6561        header hea
│ │ │ │ -000023e0: 6465 7273 5b5d 3b20 2020 2020 2020 2020  ders[];         
│ │ │ │ -000023f0: 2020 2020 2f2a 206f 6e6c 7920 6966 2076      /* only if v
│ │ │ │ -00002400: 6572 7369 6f6e 2069 7320 3078 3035 3034  ersion is 0x0504
│ │ │ │ -00002410: 202a 2f0a 2020 2020 2020 2020 2020 7072   */.          pr
│ │ │ │ -00002420: 696e 6369 7061 6c20 7072 696d 6172 795f  incipal primary_
│ │ │ │ -00002430: 7072 696e 6369 7061 6c3b 0a20 2020 2020  principal;.     
│ │ │ │ -00002440: 2020 2020 2063 7265 6465 6e74 6961 6c20       credential 
│ │ │ │ -00002450: 6372 6564 656e 7469 616c 735b 2a5d 3b0a  credentials[*];.
│ │ │ │ -00002460: 7d3b 0a0a 6865 6164 6572 207b 0a20 2020  };..header {.   
│ │ │ │ -00002470: 2020 2020 7569 6e74 3136 5f74 2074 6167      uint16_t tag
│ │ │ │ -00002480: 3b20 2020 2020 2020 2020 2020 2020 2020  ;               
│ │ │ │ -00002490: 2020 2020 202f 2a20 3120 3d20 4465 6c74       /* 1 = Delt
│ │ │ │ -000024a0: 6154 696d 6520 2a2f 0a20 2020 2020 2020  aTime */.       
│ │ │ │ -000024b0: 7569 6e74 3136 5f74 2074 6167 6c65 6e3b  uint16_t taglen;
│ │ │ │ -000024c0: 0a20 2020 2020 2020 7569 6e74 385f 7420  .       uint8_t 
│ │ │ │ -000024d0: 7461 6764 6174 615b 7461 676c 656e 5d0a  tagdata[taglen].
│ │ │ │ -000024e0: 7d3b 0a0a 5468 6520 6363 6163 6865 2e74  };..The ccache.t
│ │ │ │ -000024f0: 6167 6c65 6e20 616e 6420 6363 6163 6865  aglen and ccache
│ │ │ │ -00002500: 2e74 6167 7320 6669 656c 6473 2061 7265  .tags fields are
│ │ │ │ -00002510: 206f 6e6c 7920 7072 6573 656e 7420 696e   only present in
│ │ │ │ -00002520: 2030 7830 3530 340a 7665 7273 696f 6e73   0x0504.versions
│ │ │ │ -00002530: 2c20 6e6f 7420 696e 2065 6172 6c69 6572  , not in earlier
│ │ │ │ -00002540: 2e20 2042 6f74 6820 4d49 5420 616e 6420  .  Both MIT and 
│ │ │ │ -00002550: 4865 696d 6461 6c20 6170 7065 6172 2074  Heimdal appear t
│ │ │ │ -00002560: 6f20 636f 7272 6563 746c 790a 6967 6e6f  o correctly.igno
│ │ │ │ -00002570: 7265 2075 6e6b 6e6f 776e 2074 6167 732c  re unknown tags,
│ │ │ │ -00002580: 2073 6f20 6974 2061 7070 6561 7273 2073   so it appears s
│ │ │ │ -00002590: 6166 6520 746f 2061 6464 2074 6865 6d20  afe to add them 
│ │ │ │ -000025a0: 2861 6c74 686f 7567 6820 7468 6572 6520  (although there 
│ │ │ │ -000025b0: 6973 0a6e 6f20 6365 6e74 7261 6c20 706c  is.no central pl
│ │ │ │ -000025c0: 6163 6520 746f 2022 7265 6769 7374 6572  ace to "register
│ │ │ │ -000025d0: 2220 7461 6773 292e 0a0a 4375 7272 656e  " tags)...Curren
│ │ │ │ -000025e0: 746c 7920 6f6e 6c79 206f 6e65 2074 6167  tly only one tag
│ │ │ │ -000025f0: 2069 7320 7769 6465 6c79 2069 6d70 6c65   is widely imple
│ │ │ │ -00002600: 6d65 6e74 6564 2c20 4465 6c74 6154 696d  mented, DeltaTim
│ │ │ │ -00002610: 6520 2830 7830 3030 3129 2e20 2049 7473  e (0x0001).  Its
│ │ │ │ -00002620: 0a74 6167 6c65 6e20 6973 2061 6c77 6179  .taglen is alway
│ │ │ │ -00002630: 7320 382c 2061 6e64 2074 6167 6461 7461  s 8, and tagdata
│ │ │ │ -00002640: 2077 696c 6c20 636f 6e74 6169 6e3a 0a0a   will contain:..
│ │ │ │ -00002650: 4465 6c74 6154 696d 6520 7b0a 2020 2020  DeltaTime {.    
│ │ │ │ -00002660: 2020 2075 696e 7433 325f 7420 7469 6d65     uint32_t time
│ │ │ │ -00002670: 5f6f 6666 7365 743b 0a20 2020 2020 2020  _offset;.       
│ │ │ │ -00002680: 7569 6e74 3332 5f74 2075 7365 635f 6f66  uint32_t usec_of
│ │ │ │ -00002690: 6673 6574 3b0a 7d3b 0a0a 4166 7465 7220  fset;.};..After 
│ │ │ │ -000026a0: 7265 6164 696e 6720 7468 6520 6669 6c65  reading the file
│ │ │ │ -000026b0: 5f66 6f72 6d61 745f 7665 7273 696f 6e2c  _format_version,
│ │ │ │ -000026c0: 2068 6561 6465 7220 7461 6773 2c20 616e   header tags, an
│ │ │ │ -000026d0: 6420 6465 6661 756c 740a 7072 696e 6369  d default.princi
│ │ │ │ -000026e0: 7061 6c2c 2061 206c 6973 7420 6f66 2063  pal, a list of c
│ │ │ │ -000026f0: 7265 6465 6e74 6961 6c73 2066 6f6c 6c6f  redentials follo
│ │ │ │ -00002700: 772e 2020 596f 7520 6465 6475 6365 2066  w.  You deduce f
│ │ │ │ -00002710: 726f 6d20 7468 6520 6669 6c65 0a6c 656e  rom the file.len
│ │ │ │ -00002720: 6774 6820 7768 656e 2074 6865 7265 2061  gth when there a
│ │ │ │ -00002730: 7265 206e 6f20 6d6f 7265 2063 7265 6465  re no more crede
│ │ │ │ -00002740: 6e74 6961 6c73 2e0a 0a63 7265 6465 6e74  ntials...credent
│ │ │ │ -00002750: 6961 6c20 7b0a 2020 2020 2020 2020 2020  ial {.          
│ │ │ │ -00002760: 2070 7269 6e63 6970 616c 2063 6c69 656e   principal clien
│ │ │ │ -00002770: 743b 0a20 2020 2020 2020 2020 2020 7072  t;.           pr
│ │ │ │ -00002780: 696e 6369 7061 6c20 7365 7276 6572 3b0a  incipal server;.
│ │ │ │ -00002790: 2020 2020 2020 2020 2020 206b 6579 626c             keybl
│ │ │ │ -000027a0: 6f63 6b20 6b65 793b 0a20 2020 2020 2020  ock key;.       
│ │ │ │ -000027b0: 2020 2020 7469 6d65 7320 2020 2074 696d      times    tim
│ │ │ │ -000027c0: 653b 0a20 2020 2020 2020 2020 2020 7569  e;.           ui
│ │ │ │ -000027d0: 6e74 385f 7420 2069 735f 736b 6579 3b20  nt8_t  is_skey; 
│ │ │ │ -000027e0: 2020 2020 2020 2020 2020 202f 2a20 3120             /* 1 
│ │ │ │ -000027f0: 6966 2073 6b65 792c 2030 206f 7468 6572  if skey, 0 other
│ │ │ │ -00002800: 7769 7365 202a 2f0a 2020 2020 2020 2020  wise */.        
│ │ │ │ -00002810: 2020 2075 696e 7433 325f 7420 746b 7466     uint32_t tktf
│ │ │ │ -00002820: 6c61 6773 3b20 2020 2020 2020 2020 2020  lags;           
│ │ │ │ -00002830: 2f2a 2073 746f 7265 6420 696e 2072 6576  /* stored in rev
│ │ │ │ -00002840: 6572 7365 6420 6279 7465 206f 7264 6572  ersed byte order
│ │ │ │ -00002850: 202a 2f0a 2020 2020 2020 2020 2020 2075   */.           u
│ │ │ │ -00002860: 696e 7433 325f 7420 6e75 6d5f 6164 6472  int32_t num_addr
│ │ │ │ -00002870: 6573 733b 0a20 2020 2020 2020 2020 2020  ess;.           
│ │ │ │ -00002880: 6164 6472 6573 7320 2061 6464 7273 5b6e  address  addrs[n
│ │ │ │ -00002890: 756d 5f61 6464 7265 7373 5d3b 0a20 2020  um_address];.   
│ │ │ │ -000028a0: 2020 2020 2020 2020 7569 6e74 3332 5f74          uint32_t
│ │ │ │ -000028b0: 206e 756d 5f61 7574 6864 6174 613b 0a20   num_authdata;. 
│ │ │ │ -000028c0: 2020 2020 2020 2020 2020 6175 7468 6461            authda
│ │ │ │ -000028d0: 7461 2061 7574 6864 6174 615b 6e75 6d5f  ta authdata[num_
│ │ │ │ -000028e0: 6175 7468 6461 7461 5d3b 0a20 2020 2020  authdata];.     
│ │ │ │ -000028f0: 2020 2020 2020 636f 756e 7465 745f 6f63        countet_oc
│ │ │ │ -00002900: 7465 745f 7374 7269 6e67 2074 6963 6b65  tet_string ticke
│ │ │ │ -00002910: 743b 0a20 2020 2020 2020 2020 2020 636f  t;.           co
│ │ │ │ -00002920: 756e 7465 745f 6f63 7465 745f 7374 7269  untet_octet_stri
│ │ │ │ -00002930: 6e67 2073 6563 6f6e 645f 7469 636b 6574  ng second_ticket
│ │ │ │ -00002940: 3b0a 7d3b 0a0a 6b65 7962 6c6f 636b 207b  ;.};..keyblock {
│ │ │ │ -00002950: 0a20 2020 2020 2020 2020 7569 6e74 3136  .         uint16
│ │ │ │ -00002960: 5f74 206b 6579 7479 7065 3b0a 2020 2020  _t keytype;.    
│ │ │ │ -00002970: 2020 2020 2075 696e 7431 365f 7420 6574       uint16_t et
│ │ │ │ -00002980: 7970 653b 2020 2020 2020 2020 2020 2020  ype;            
│ │ │ │ -00002990: 2020 2020 2f2a 206f 6e6c 7920 7072 6573      /* only pres
│ │ │ │ -000029a0: 656e 7420 6966 2076 6572 7369 6f6e 2030  ent if version 0
│ │ │ │ -000029b0: 7830 3530 3320 2a2f 0a20 2020 2020 2020  x0503 */.       
│ │ │ │ -000029c0: 2020 7569 6e74 3136 5f74 206b 6579 6c65    uint16_t keyle
│ │ │ │ -000029d0: 6e3b 0a20 2020 2020 2020 2020 7569 6e74  n;.         uint
│ │ │ │ -000029e0: 385f 7420 6b65 7976 616c 7565 5b6b 6579  8_t keyvalue[key
│ │ │ │ -000029f0: 6c65 6e5d 3b0a 7d3b 0a0a 7469 6d65 7320  len];.};..times 
│ │ │ │ -00002a00: 7b0a 2020 2020 2020 7569 6e74 3332 5f74  {.      uint32_t
│ │ │ │ -00002a10: 2020 6175 7468 7469 6d65 3b0a 2020 2020    authtime;.    
│ │ │ │ -00002a20: 2020 7569 6e74 3332 5f74 2020 7374 6172    uint32_t  star
│ │ │ │ -00002a30: 7474 696d 653b 0a20 2020 2020 2075 696e  ttime;.      uin
│ │ │ │ -00002a40: 7433 325f 7420 2065 6e64 7469 6d65 3b0a  t32_t  endtime;.
│ │ │ │ -00002a50: 2020 2020 2020 7569 6e74 3332 5f74 2020        uint32_t  
│ │ │ │ -00002a60: 7265 6e65 775f 7469 6c6c 3b0a 7d3b 0a0a  renew_till;.};..
│ │ │ │ -00002a70: 6164 6472 6573 7320 7b0a 2020 2020 2020  address {.      
│ │ │ │ -00002a80: 2020 7569 6e74 3136 5f74 2061 6464 7274    uint16_t addrt
│ │ │ │ -00002a90: 7970 653b 0a20 2020 2020 2020 2063 6f75  ype;.        cou
│ │ │ │ -00002aa0: 6e74 6564 5f6f 6374 6574 5f73 7472 696e  nted_octet_strin
│ │ │ │ -00002ab0: 6720 6164 6472 6461 7461 3b0a 7d3b 0a0a  g addrdata;.};..
│ │ │ │ -00002ac0: 6175 7468 6461 7461 207b 0a20 2020 2020  authdata {.     
│ │ │ │ -00002ad0: 2020 2020 7569 6e74 3136 5f74 2061 7574      uint16_t aut
│ │ │ │ -00002ae0: 6874 7970 653b 0a20 2020 2020 2020 2020  htype;.         
│ │ │ │ -00002af0: 636f 756e 7465 645f 6f63 7465 745f 7374  counted_octet_st
│ │ │ │ -00002b00: 7269 6e67 2061 7574 6864 6174 613b 0a7d  ring authdata;.}
│ │ │ │ -00002b10: 3b0a 0a70 7269 6e63 6970 616c 207b 0a20  ;..principal {. 
│ │ │ │ -00002b20: 2020 2020 2020 2020 2075 696e 7433 325f           uint32_
│ │ │ │ -00002b30: 7420 6e61 6d65 5f74 7970 653b 2020 2020  t name_type;    
│ │ │ │ -00002b40: 2020 2020 2020 202f 2a20 6e6f 7420 7072         /* not pr
│ │ │ │ -00002b50: 6573 656e 7420 6966 2076 6572 7369 6f6e  esent if version
│ │ │ │ -00002b60: 2030 7830 3530 3120 2a2f 0a20 2020 2020   0x0501 */.     
│ │ │ │ -00002b70: 2020 2020 2075 696e 7433 325f 7420 6e75       uint32_t nu
│ │ │ │ -00002b80: 6d5f 636f 6d70 6f6e 656e 7473 3b20 2020  m_components;   
│ │ │ │ -00002b90: 2020 202f 2a20 7375 6220 3120 6966 2076     /* sub 1 if v
│ │ │ │ -00002ba0: 6572 7369 6f6e 2030 7835 3031 202a 2f0a  ersion 0x501 */.
│ │ │ │ -00002bb0: 2020 2020 2020 2020 2020 636f 756e 7465            counte
│ │ │ │ -00002bc0: 645f 6f63 7465 745f 7374 7269 6e67 2072  d_octet_string r
│ │ │ │ -00002bd0: 6561 6c6d 3b0a 2020 2020 2020 2020 2020  ealm;.          
│ │ │ │ -00002be0: 636f 756e 7465 645f 6f63 7465 745f 7374  counted_octet_st
│ │ │ │ -00002bf0: 7269 6e67 2063 6f6d 706f 6e65 6e74 735b  ring components[
│ │ │ │ -00002c00: 6e75 6d5f 636f 6d70 6f6e 656e 7473 5d3b  num_components];
│ │ │ │ -00002c10: 0a7d 3b0a 0a63 6f75 6e74 6564 5f6f 6374  .};..counted_oct
│ │ │ │ -00002c20: 6574 5f73 7472 696e 6720 7b0a 2020 2020  et_string {.    
│ │ │ │ -00002c30: 7569 6e74 3332 5f74 206c 656e 6774 683b  uint32_t length;
│ │ │ │ -00002c40: 0a20 2020 2075 696e 7438 5f74 2064 6174  .    uint8_t dat
│ │ │ │ -00002c50: 615b 6c65 6e67 7468 5d3b 0a7d 3b0a 0a50  a[length];.};..P
│ │ │ │ -00002c60: 6572 6d69 7373 696f 6e20 746f 2063 6f70  ermission to cop
│ │ │ │ -00002c70: 792c 206d 6f64 6966 792c 2061 6e64 2064  y, modify, and d
│ │ │ │ -00002c80: 6973 7472 6962 7574 6520 7468 6973 2064  istribute this d
│ │ │ │ -00002c90: 6f63 756d 656e 742c 2077 6974 6820 6f72  ocument, with or
│ │ │ │ -00002ca0: 0a77 6974 686f 7574 206d 6f64 6966 6963  .without modific
│ │ │ │ -00002cb0: 6174 696f 6e2c 2066 6f72 2061 6e79 2070  ation, for any p
│ │ │ │ -00002cc0: 7572 706f 7365 2061 6e64 2077 6974 686f  urpose and witho
│ │ │ │ -00002cd0: 7574 2066 6565 206f 7220 726f 7961 6c74  ut fee or royalt
│ │ │ │ -00002ce0: 7920 6973 0a68 6572 6562 7920 6772 616e  y is.hereby gran
│ │ │ │ -00002cf0: 7465 642c 2070 726f 7669 6465 6420 7468  ted, provided th
│ │ │ │ -00002d00: 6174 2079 6f75 2069 6e63 6c75 6465 2074  at you include t
│ │ │ │ -00002d10: 6869 7320 636f 7079 7269 6768 7420 6e6f  his copyright no
│ │ │ │ -00002d20: 7469 6365 2069 6e20 414c 4c0a 636f 7069  tice in ALL.copi
│ │ │ │ -00002d30: 6573 206f 6620 7468 6520 646f 6375 6d65  es of the docume
│ │ │ │ -00002d40: 6e74 206f 7220 706f 7274 696f 6e73 2074  nt or portions t
│ │ │ │ -00002d50: 6865 7265 6f66 2c20 696e 636c 7564 696e  hereof, includin
│ │ │ │ -00002d60: 6720 6d6f 6469 6669 6361 7469 6f6e 732e  g modifications.
│ │ │ │ -00002d70: 0a0a 1f0a 4669 6c65 3a20 7368 6973 6869  ....File: shishi
│ │ │ │ -00002d80: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 436f  .info,  Node: Co
│ │ │ │ -00002d90: 7079 696e 6720 496e 666f 726d 6174 696f  pying Informatio
│ │ │ │ -00002da0: 6e2c 2020 4e65 7874 3a20 4675 6e63 7469  n,  Next: Functi
│ │ │ │ -00002db0: 6f6e 2061 6e64 2044 6174 6120 496e 6465  on and Data Inde
│ │ │ │ -00002dc0: 782c 2020 5072 6576 3a20 5072 6f74 6f63  x,  Prev: Protoc
│ │ │ │ -00002dd0: 6f6c 2045 7874 656e 7369 6f6e 732c 2020  ol Extensions,  
│ │ │ │ -00002de0: 5570 3a20 546f 700a 0a41 7070 656e 6469  Up: Top..Appendi
│ │ │ │ -00002df0: 7820 4320 436f 7079 696e 6720 496e 666f  x C Copying Info
│ │ │ │ -00002e00: 726d 6174 696f 6e0a 2a2a 2a2a 2a2a 2a2a  rmation.********
│ │ │ │ +000020e0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a  ===============.
│ │ │ │ +000020f0: 0a54 6865 2063 7265 6465 6e74 6961 6c20  .The credential 
│ │ │ │ +00002100: 6361 6368 6520 6669 6c65 2066 6f72 6d61  cache file forma
│ │ │ │ +00002110: 7420 6973 2064 6573 6372 6962 6564 2069  t is described i
│ │ │ │ +00002120: 6e20 7468 6520 6669 6c65 20e2 8098 6b65  n the file ...ke
│ │ │ │ +00002130: 7974 6162 2e74 7874 e280 992c 0a69 6e63  ytab.txt...,.inc
│ │ │ │ +00002140: 6c75 6465 6420 7665 7262 6174 696d 2e0a  luded verbatim..
│ │ │ │ +00002150: 0a54 6865 204b 6572 6265 726f 7320 4372  .The Kerberos Cr
│ │ │ │ +00002160: 6564 656e 7469 616c 2043 6163 6865 2042  edential Cache B
│ │ │ │ +00002170: 696e 6172 7920 4669 6c65 2046 6f72 6d61  inary File Forma
│ │ │ │ +00002180: 740a 436f 7079 7269 6768 7420 2843 2920  t.Copyright (C) 
│ │ │ │ +00002190: 3230 3036 2d32 3032 3220 5369 6d6f 6e20  2006-2022 Simon 
│ │ │ │ +000021a0: 4a6f 7365 6673 736f 6e20 3c73 696d 6f6e  Josefsson <simon
│ │ │ │ +000021b0: 206a 6f73 6566 7373 6f6e 2e6f 7267 3e0a   josefsson.org>.
│ │ │ │ +000021c0: 6874 7470 3a2f 2f6a 6f73 6566 7373 6f6e  http://josefsson
│ │ │ │ +000021d0: 2e6f 7267 2f73 6869 7368 692f 6363 6163  .org/shishi/ccac
│ │ │ │ +000021e0: 6865 2e74 7874 0a4c 6173 7420 7570 6461  he.txt.Last upda
│ │ │ │ +000021f0: 7465 643a 2053 6174 2053 6570 2032 3320  ted: Sat Sep 23 
│ │ │ │ +00002200: 3132 3a30 343a 3131 2043 4553 5420 3230  12:04:11 CEST 20
│ │ │ │ +00002210: 3036 0a0a 4c69 6b65 2074 6865 204d 4954  06..Like the MIT
│ │ │ │ +00002220: 206b 6579 7461 6220 6269 6e61 7279 2066   keytab binary f
│ │ │ │ +00002230: 6f72 6d61 7420 2873 6565 204d 6963 6861  ormat (see Micha
│ │ │ │ +00002240: 656c 2042 2041 6c6c 656e 2773 2072 6576  el B Allen's rev
│ │ │ │ +00002250: 6572 7365 0a65 6e67 696e 6565 7265 6420  erse.engineered 
│ │ │ │ +00002260: 6465 7363 7269 7074 696f 6e20 696e 206b  description in k
│ │ │ │ +00002270: 6579 7461 622e 7478 7429 2c20 7468 6520  eytab.txt), the 
│ │ │ │ +00002280: 6372 6564 656e 7469 616c 2063 6163 6865  credential cache
│ │ │ │ +00002290: 2066 6f72 6d61 7420 6973 0a6e 6f74 2073   format is.not s
│ │ │ │ +000022a0: 7461 6e64 6172 6420 6e6f 7220 646f 6375  tandard nor docu
│ │ │ │ +000022b0: 6d65 6e74 6564 2061 6e79 7768 6572 652e  mented anywhere.
│ │ │ │ +000022c0: 0a0a 496e 2043 2073 7479 6c65 206e 6f74  ..In C style not
│ │ │ │ +000022d0: 6174 696f 6e2c 2074 6865 204d 4954 2063  ation, the MIT c
│ │ │ │ +000022e0: 7265 6465 6e74 6961 6c20 6361 6368 6520  redential cache 
│ │ │ │ +000022f0: 6669 6c65 2066 6f72 6d61 7420 6973 2061  file format is a
│ │ │ │ +00002300: 730a 666f 6c6c 6f77 732e 2020 416c 6c20  s.follows.  All 
│ │ │ │ +00002310: 7661 6c75 6573 2061 7265 2069 6e20 6e65  values are in ne
│ │ │ │ +00002320: 7477 6f72 6b20 6279 7465 206f 7264 6572  twork byte order
│ │ │ │ +00002330: 2e20 2041 6c6c 2074 6578 7420 6973 2041  .  All text is A
│ │ │ │ +00002340: 5343 4949 2e0a 0a63 6361 6368 6520 7b0a  SCII...ccache {.
│ │ │ │ +00002350: 2020 2020 2020 2020 2020 7569 6e74 3136            uint16
│ │ │ │ +00002360: 5f74 2066 696c 655f 666f 726d 6174 5f76  _t file_format_v
│ │ │ │ +00002370: 6572 7369 6f6e 3b20 2f2a 2030 7830 3530  ersion; /* 0x050
│ │ │ │ +00002380: 3420 2a2f 0a20 2020 2020 2020 2020 2075  4 */.          u
│ │ │ │ +00002390: 696e 7431 365f 7420 6865 6164 6572 6c65  int16_t headerle
│ │ │ │ +000023a0: 6e3b 2020 2020 2020 2020 2020 202f 2a20  n;           /* 
│ │ │ │ +000023b0: 6f6e 6c79 2069 6620 7665 7273 696f 6e20  only if version 
│ │ │ │ +000023c0: 6973 2030 7830 3530 3420 2a2f 0a20 2020  is 0x0504 */.   
│ │ │ │ +000023d0: 2020 2020 2020 2068 6561 6465 7220 6865         header he
│ │ │ │ +000023e0: 6164 6572 735b 5d3b 2020 2020 2020 2020  aders[];        
│ │ │ │ +000023f0: 2020 2020 202f 2a20 6f6e 6c79 2069 6620       /* only if 
│ │ │ │ +00002400: 7665 7273 696f 6e20 6973 2030 7830 3530  version is 0x050
│ │ │ │ +00002410: 3420 2a2f 0a20 2020 2020 2020 2020 2070  4 */.          p
│ │ │ │ +00002420: 7269 6e63 6970 616c 2070 7269 6d61 7279  rincipal primary
│ │ │ │ +00002430: 5f70 7269 6e63 6970 616c 3b0a 2020 2020  _principal;.    
│ │ │ │ +00002440: 2020 2020 2020 6372 6564 656e 7469 616c        credential
│ │ │ │ +00002450: 2063 7265 6465 6e74 6961 6c73 5b2a 5d3b   credentials[*];
│ │ │ │ +00002460: 0a7d 3b0a 0a68 6561 6465 7220 7b0a 2020  .};..header {.  
│ │ │ │ +00002470: 2020 2020 2075 696e 7431 365f 7420 7461       uint16_t ta
│ │ │ │ +00002480: 673b 2020 2020 2020 2020 2020 2020 2020  g;              
│ │ │ │ +00002490: 2020 2020 2020 2f2a 2031 203d 2044 656c        /* 1 = Del
│ │ │ │ +000024a0: 7461 5469 6d65 202a 2f0a 2020 2020 2020  taTime */.      
│ │ │ │ +000024b0: 2075 696e 7431 365f 7420 7461 676c 656e   uint16_t taglen
│ │ │ │ +000024c0: 3b0a 2020 2020 2020 2075 696e 7438 5f74  ;.       uint8_t
│ │ │ │ +000024d0: 2074 6167 6461 7461 5b74 6167 6c65 6e5d   tagdata[taglen]
│ │ │ │ +000024e0: 0a7d 3b0a 0a54 6865 2063 6361 6368 652e  .};..The ccache.
│ │ │ │ +000024f0: 7461 676c 656e 2061 6e64 2063 6361 6368  taglen and ccach
│ │ │ │ +00002500: 652e 7461 6773 2066 6965 6c64 7320 6172  e.tags fields ar
│ │ │ │ +00002510: 6520 6f6e 6c79 2070 7265 7365 6e74 2069  e only present i
│ │ │ │ +00002520: 6e20 3078 3035 3034 0a76 6572 7369 6f6e  n 0x0504.version
│ │ │ │ +00002530: 732c 206e 6f74 2069 6e20 6561 726c 6965  s, not in earlie
│ │ │ │ +00002540: 722e 2020 426f 7468 204d 4954 2061 6e64  r.  Both MIT and
│ │ │ │ +00002550: 2048 6569 6d64 616c 2061 7070 6561 7220   Heimdal appear 
│ │ │ │ +00002560: 746f 2063 6f72 7265 6374 6c79 0a69 676e  to correctly.ign
│ │ │ │ +00002570: 6f72 6520 756e 6b6e 6f77 6e20 7461 6773  ore unknown tags
│ │ │ │ +00002580: 2c20 736f 2069 7420 6170 7065 6172 7320  , so it appears 
│ │ │ │ +00002590: 7361 6665 2074 6f20 6164 6420 7468 656d  safe to add them
│ │ │ │ +000025a0: 2028 616c 7468 6f75 6768 2074 6865 7265   (although there
│ │ │ │ +000025b0: 2069 730a 6e6f 2063 656e 7472 616c 2070   is.no central p
│ │ │ │ +000025c0: 6c61 6365 2074 6f20 2272 6567 6973 7465  lace to "registe
│ │ │ │ +000025d0: 7222 2074 6167 7329 2e0a 0a43 7572 7265  r" tags)...Curre
│ │ │ │ +000025e0: 6e74 6c79 206f 6e6c 7920 6f6e 6520 7461  ntly only one ta
│ │ │ │ +000025f0: 6720 6973 2077 6964 656c 7920 696d 706c  g is widely impl
│ │ │ │ +00002600: 656d 656e 7465 642c 2044 656c 7461 5469  emented, DeltaTi
│ │ │ │ +00002610: 6d65 2028 3078 3030 3031 292e 2020 4974  me (0x0001).  It
│ │ │ │ +00002620: 730a 7461 676c 656e 2069 7320 616c 7761  s.taglen is alwa
│ │ │ │ +00002630: 7973 2038 2c20 616e 6420 7461 6764 6174  ys 8, and tagdat
│ │ │ │ +00002640: 6120 7769 6c6c 2063 6f6e 7461 696e 3a0a  a will contain:.
│ │ │ │ +00002650: 0a44 656c 7461 5469 6d65 207b 0a20 2020  .DeltaTime {.   
│ │ │ │ +00002660: 2020 2020 7569 6e74 3332 5f74 2074 696d      uint32_t tim
│ │ │ │ +00002670: 655f 6f66 6673 6574 3b0a 2020 2020 2020  e_offset;.      
│ │ │ │ +00002680: 2075 696e 7433 325f 7420 7573 6563 5f6f   uint32_t usec_o
│ │ │ │ +00002690: 6666 7365 743b 0a7d 3b0a 0a41 6674 6572  ffset;.};..After
│ │ │ │ +000026a0: 2072 6561 6469 6e67 2074 6865 2066 696c   reading the fil
│ │ │ │ +000026b0: 655f 666f 726d 6174 5f76 6572 7369 6f6e  e_format_version
│ │ │ │ +000026c0: 2c20 6865 6164 6572 2074 6167 732c 2061  , header tags, a
│ │ │ │ +000026d0: 6e64 2064 6566 6175 6c74 0a70 7269 6e63  nd default.princ
│ │ │ │ +000026e0: 6970 616c 2c20 6120 6c69 7374 206f 6620  ipal, a list of 
│ │ │ │ +000026f0: 6372 6564 656e 7469 616c 7320 666f 6c6c  credentials foll
│ │ │ │ +00002700: 6f77 2e20 2059 6f75 2064 6564 7563 6520  ow.  You deduce 
│ │ │ │ +00002710: 6672 6f6d 2074 6865 2066 696c 650a 6c65  from the file.le
│ │ │ │ +00002720: 6e67 7468 2077 6865 6e20 7468 6572 6520  ngth when there 
│ │ │ │ +00002730: 6172 6520 6e6f 206d 6f72 6520 6372 6564  are no more cred
│ │ │ │ +00002740: 656e 7469 616c 732e 0a0a 6372 6564 656e  entials...creden
│ │ │ │ +00002750: 7469 616c 207b 0a20 2020 2020 2020 2020  tial {.         
│ │ │ │ +00002760: 2020 7072 696e 6369 7061 6c20 636c 6965    principal clie
│ │ │ │ +00002770: 6e74 3b0a 2020 2020 2020 2020 2020 2070  nt;.           p
│ │ │ │ +00002780: 7269 6e63 6970 616c 2073 6572 7665 723b  rincipal server;
│ │ │ │ +00002790: 0a20 2020 2020 2020 2020 2020 6b65 7962  .           keyb
│ │ │ │ +000027a0: 6c6f 636b 206b 6579 3b0a 2020 2020 2020  lock key;.      
│ │ │ │ +000027b0: 2020 2020 2074 696d 6573 2020 2020 7469       times    ti
│ │ │ │ +000027c0: 6d65 3b0a 2020 2020 2020 2020 2020 2075  me;.           u
│ │ │ │ +000027d0: 696e 7438 5f74 2020 6973 5f73 6b65 793b  int8_t  is_skey;
│ │ │ │ +000027e0: 2020 2020 2020 2020 2020 2020 2f2a 2031              /* 1
│ │ │ │ +000027f0: 2069 6620 736b 6579 2c20 3020 6f74 6865   if skey, 0 othe
│ │ │ │ +00002800: 7277 6973 6520 2a2f 0a20 2020 2020 2020  rwise */.       
│ │ │ │ +00002810: 2020 2020 7569 6e74 3332 5f74 2074 6b74      uint32_t tkt
│ │ │ │ +00002820: 666c 6167 733b 2020 2020 2020 2020 2020  flags;          
│ │ │ │ +00002830: 202f 2a20 7374 6f72 6564 2069 6e20 7265   /* stored in re
│ │ │ │ +00002840: 7665 7273 6564 2062 7974 6520 6f72 6465  versed byte orde
│ │ │ │ +00002850: 7220 2a2f 0a20 2020 2020 2020 2020 2020  r */.           
│ │ │ │ +00002860: 7569 6e74 3332 5f74 206e 756d 5f61 6464  uint32_t num_add
│ │ │ │ +00002870: 7265 7373 3b0a 2020 2020 2020 2020 2020  ress;.          
│ │ │ │ +00002880: 2061 6464 7265 7373 2020 6164 6472 735b   address  addrs[
│ │ │ │ +00002890: 6e75 6d5f 6164 6472 6573 735d 3b0a 2020  num_address];.  
│ │ │ │ +000028a0: 2020 2020 2020 2020 2075 696e 7433 325f           uint32_
│ │ │ │ +000028b0: 7420 6e75 6d5f 6175 7468 6461 7461 3b0a  t num_authdata;.
│ │ │ │ +000028c0: 2020 2020 2020 2020 2020 2061 7574 6864             authd
│ │ │ │ +000028d0: 6174 6120 6175 7468 6461 7461 5b6e 756d  ata authdata[num
│ │ │ │ +000028e0: 5f61 7574 6864 6174 615d 3b0a 2020 2020  _authdata];.    
│ │ │ │ +000028f0: 2020 2020 2020 2063 6f75 6e74 6574 5f6f         countet_o
│ │ │ │ +00002900: 6374 6574 5f73 7472 696e 6720 7469 636b  ctet_string tick
│ │ │ │ +00002910: 6574 3b0a 2020 2020 2020 2020 2020 2063  et;.           c
│ │ │ │ +00002920: 6f75 6e74 6574 5f6f 6374 6574 5f73 7472  ountet_octet_str
│ │ │ │ +00002930: 696e 6720 7365 636f 6e64 5f74 6963 6b65  ing second_ticke
│ │ │ │ +00002940: 743b 0a7d 3b0a 0a6b 6579 626c 6f63 6b20  t;.};..keyblock 
│ │ │ │ +00002950: 7b0a 2020 2020 2020 2020 2075 696e 7431  {.         uint1
│ │ │ │ +00002960: 365f 7420 6b65 7974 7970 653b 0a20 2020  6_t keytype;.   
│ │ │ │ +00002970: 2020 2020 2020 7569 6e74 3136 5f74 2065        uint16_t e
│ │ │ │ +00002980: 7479 7065 3b20 2020 2020 2020 2020 2020  type;           
│ │ │ │ +00002990: 2020 2020 202f 2a20 6f6e 6c79 2070 7265       /* only pre
│ │ │ │ +000029a0: 7365 6e74 2069 6620 7665 7273 696f 6e20  sent if version 
│ │ │ │ +000029b0: 3078 3035 3033 202a 2f0a 2020 2020 2020  0x0503 */.      
│ │ │ │ +000029c0: 2020 2075 696e 7431 365f 7420 6b65 796c     uint16_t keyl
│ │ │ │ +000029d0: 656e 3b0a 2020 2020 2020 2020 2075 696e  en;.         uin
│ │ │ │ +000029e0: 7438 5f74 206b 6579 7661 6c75 655b 6b65  t8_t keyvalue[ke
│ │ │ │ +000029f0: 796c 656e 5d3b 0a7d 3b0a 0a74 696d 6573  ylen];.};..times
│ │ │ │ +00002a00: 207b 0a20 2020 2020 2075 696e 7433 325f   {.      uint32_
│ │ │ │ +00002a10: 7420 2061 7574 6874 696d 653b 0a20 2020  t  authtime;.   
│ │ │ │ +00002a20: 2020 2075 696e 7433 325f 7420 2073 7461     uint32_t  sta
│ │ │ │ +00002a30: 7274 7469 6d65 3b0a 2020 2020 2020 7569  rttime;.      ui
│ │ │ │ +00002a40: 6e74 3332 5f74 2020 656e 6474 696d 653b  nt32_t  endtime;
│ │ │ │ +00002a50: 0a20 2020 2020 2075 696e 7433 325f 7420  .      uint32_t 
│ │ │ │ +00002a60: 2072 656e 6577 5f74 696c 6c3b 0a7d 3b0a   renew_till;.};.
│ │ │ │ +00002a70: 0a61 6464 7265 7373 207b 0a20 2020 2020  .address {.     
│ │ │ │ +00002a80: 2020 2075 696e 7431 365f 7420 6164 6472     uint16_t addr
│ │ │ │ +00002a90: 7479 7065 3b0a 2020 2020 2020 2020 636f  type;.        co
│ │ │ │ +00002aa0: 756e 7465 645f 6f63 7465 745f 7374 7269  unted_octet_stri
│ │ │ │ +00002ab0: 6e67 2061 6464 7264 6174 613b 0a7d 3b0a  ng addrdata;.};.
│ │ │ │ +00002ac0: 0a61 7574 6864 6174 6120 7b0a 2020 2020  .authdata {.    
│ │ │ │ +00002ad0: 2020 2020 2075 696e 7431 365f 7420 6175       uint16_t au
│ │ │ │ +00002ae0: 7468 7479 7065 3b0a 2020 2020 2020 2020  thtype;.        
│ │ │ │ +00002af0: 2063 6f75 6e74 6564 5f6f 6374 6574 5f73   counted_octet_s
│ │ │ │ +00002b00: 7472 696e 6720 6175 7468 6461 7461 3b0a  tring authdata;.
│ │ │ │ +00002b10: 7d3b 0a0a 7072 696e 6369 7061 6c20 7b0a  };..principal {.
│ │ │ │ +00002b20: 2020 2020 2020 2020 2020 7569 6e74 3332            uint32
│ │ │ │ +00002b30: 5f74 206e 616d 655f 7479 7065 3b20 2020  _t name_type;   
│ │ │ │ +00002b40: 2020 2020 2020 2020 2f2a 206e 6f74 2070          /* not p
│ │ │ │ +00002b50: 7265 7365 6e74 2069 6620 7665 7273 696f  resent if versio
│ │ │ │ +00002b60: 6e20 3078 3035 3031 202a 2f0a 2020 2020  n 0x0501 */.    
│ │ │ │ +00002b70: 2020 2020 2020 7569 6e74 3332 5f74 206e        uint32_t n
│ │ │ │ +00002b80: 756d 5f63 6f6d 706f 6e65 6e74 733b 2020  um_components;  
│ │ │ │ +00002b90: 2020 2020 2f2a 2073 7562 2031 2069 6620      /* sub 1 if 
│ │ │ │ +00002ba0: 7665 7273 696f 6e20 3078 3530 3120 2a2f  version 0x501 */
│ │ │ │ +00002bb0: 0a20 2020 2020 2020 2020 2063 6f75 6e74  .          count
│ │ │ │ +00002bc0: 6564 5f6f 6374 6574 5f73 7472 696e 6720  ed_octet_string 
│ │ │ │ +00002bd0: 7265 616c 6d3b 0a20 2020 2020 2020 2020  realm;.         
│ │ │ │ +00002be0: 2063 6f75 6e74 6564 5f6f 6374 6574 5f73   counted_octet_s
│ │ │ │ +00002bf0: 7472 696e 6720 636f 6d70 6f6e 656e 7473  tring components
│ │ │ │ +00002c00: 5b6e 756d 5f63 6f6d 706f 6e65 6e74 735d  [num_components]
│ │ │ │ +00002c10: 3b0a 7d3b 0a0a 636f 756e 7465 645f 6f63  ;.};..counted_oc
│ │ │ │ +00002c20: 7465 745f 7374 7269 6e67 207b 0a20 2020  tet_string {.   
│ │ │ │ +00002c30: 2075 696e 7433 325f 7420 6c65 6e67 7468   uint32_t length
│ │ │ │ +00002c40: 3b0a 2020 2020 7569 6e74 385f 7420 6461  ;.    uint8_t da
│ │ │ │ +00002c50: 7461 5b6c 656e 6774 685d 3b0a 7d3b 0a0a  ta[length];.};..
│ │ │ │ +00002c60: 5065 726d 6973 7369 6f6e 2074 6f20 636f  Permission to co
│ │ │ │ +00002c70: 7079 2c20 6d6f 6469 6679 2c20 616e 6420  py, modify, and 
│ │ │ │ +00002c80: 6469 7374 7269 6275 7465 2074 6869 7320  distribute this 
│ │ │ │ +00002c90: 646f 6375 6d65 6e74 2c20 7769 7468 206f  document, with o
│ │ │ │ +00002ca0: 720a 7769 7468 6f75 7420 6d6f 6469 6669  r.without modifi
│ │ │ │ +00002cb0: 6361 7469 6f6e 2c20 666f 7220 616e 7920  cation, for any 
│ │ │ │ +00002cc0: 7075 7270 6f73 6520 616e 6420 7769 7468  purpose and with
│ │ │ │ +00002cd0: 6f75 7420 6665 6520 6f72 2072 6f79 616c  out fee or royal
│ │ │ │ +00002ce0: 7479 2069 730a 6865 7265 6279 2067 7261  ty is.hereby gra
│ │ │ │ +00002cf0: 6e74 6564 2c20 7072 6f76 6964 6564 2074  nted, provided t
│ │ │ │ +00002d00: 6861 7420 796f 7520 696e 636c 7564 6520  hat you include 
│ │ │ │ +00002d10: 7468 6973 2063 6f70 7972 6967 6874 206e  this copyright n
│ │ │ │ +00002d20: 6f74 6963 6520 696e 2041 4c4c 0a63 6f70  otice in ALL.cop
│ │ │ │ +00002d30: 6965 7320 6f66 2074 6865 2064 6f63 756d  ies of the docum
│ │ │ │ +00002d40: 656e 7420 6f72 2070 6f72 7469 6f6e 7320  ent or portions 
│ │ │ │ +00002d50: 7468 6572 656f 662c 2069 6e63 6c75 6469  thereof, includi
│ │ │ │ +00002d60: 6e67 206d 6f64 6966 6963 6174 696f 6e73  ng modifications
│ │ │ │ +00002d70: 2e0a 0a1f 0a46 696c 653a 2073 6869 7368  .....File: shish
│ │ │ │ +00002d80: 692e 696e 666f 2c20 204e 6f64 653a 2043  i.info,  Node: C
│ │ │ │ +00002d90: 6f70 7969 6e67 2049 6e66 6f72 6d61 7469  opying Informati
│ │ │ │ +00002da0: 6f6e 2c20 204e 6578 743a 2046 756e 6374  on,  Next: Funct
│ │ │ │ +00002db0: 696f 6e20 616e 6420 4461 7461 2049 6e64  ion and Data Ind
│ │ │ │ +00002dc0: 6578 2c20 2050 7265 763a 2050 726f 746f  ex,  Prev: Proto
│ │ │ │ +00002dd0: 636f 6c20 4578 7465 6e73 696f 6e73 2c20  col Extensions, 
│ │ │ │ +00002de0: 2055 703a 2054 6f70 0a0a 4170 7065 6e64   Up: Top..Append
│ │ │ │ +00002df0: 6978 2043 2043 6f70 7969 6e67 2049 6e66  ix C Copying Inf
│ │ │ │ +00002e00: 6f72 6d61 7469 6f6e 0a2a 2a2a 2a2a 2a2a  ormation.*******
│ │ │ │  00002e10: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a  ****************
│ │ │ │ -00002e20: 2a2a 2a2a 2a2a 0a0a 2a20 4d65 6e75 3a0a  ******..* Menu:.
│ │ │ │ -00002e30: 0a2a 2047 4e55 2046 7265 6520 446f 6375  .* GNU Free Docu
│ │ │ │ -00002e40: 6d65 6e74 6174 696f 6e20 4c69 6365 6e73  mentation Licens
│ │ │ │ -00002e50: 653a 3a20 2020 4c69 6365 6e73 6520 666f  e::   License fo
│ │ │ │ -00002e60: 7220 636f 7079 696e 6720 7468 6973 206d  r copying this m
│ │ │ │ -00002e70: 616e 7561 6c2e 0a0a 1f0a 4669 6c65 3a20  anual.....File: 
│ │ │ │ -00002e80: 7368 6973 6869 2e69 6e66 6f2c 2020 4e6f  shishi.info,  No
│ │ │ │ -00002e90: 6465 3a20 474e 5520 4672 6565 2044 6f63  de: GNU Free Doc
│ │ │ │ -00002ea0: 756d 656e 7461 7469 6f6e 204c 6963 656e  umentation Licen
│ │ │ │ -00002eb0: 7365 2c20 2055 703a 2043 6f70 7969 6e67  se,  Up: Copying
│ │ │ │ -00002ec0: 2049 6e66 6f72 6d61 7469 6f6e 0a0a 432e   Information..C.
│ │ │ │ -00002ed0: 3120 474e 5520 4672 6565 2044 6f63 756d  1 GNU Free Docum
│ │ │ │ -00002ee0: 656e 7461 7469 6f6e 204c 6963 656e 7365  entation License
│ │ │ │ -00002ef0: 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  .===============
│ │ │ │ +00002e20: 2a2a 2a2a 2a2a 2a0a 0a2a 204d 656e 753a  *******..* Menu:
│ │ │ │ +00002e30: 0a0a 2a20 474e 5520 4672 6565 2044 6f63  ..* GNU Free Doc
│ │ │ │ +00002e40: 756d 656e 7461 7469 6f6e 204c 6963 656e  umentation Licen
│ │ │ │ +00002e50: 7365 3a3a 2020 204c 6963 656e 7365 2066  se::   License f
│ │ │ │ +00002e60: 6f72 2063 6f70 7969 6e67 2074 6869 7320  or copying this 
│ │ │ │ +00002e70: 6d61 6e75 616c 2e0a 0a1f 0a46 696c 653a  manual.....File:
│ │ │ │ +00002e80: 2073 6869 7368 692e 696e 666f 2c20 204e   shishi.info,  N
│ │ │ │ +00002e90: 6f64 653a 2047 4e55 2046 7265 6520 446f  ode: GNU Free Do
│ │ │ │ +00002ea0: 6375 6d65 6e74 6174 696f 6e20 4c69 6365  cumentation Lice
│ │ │ │ +00002eb0: 6e73 652c 2020 5570 3a20 436f 7079 696e  nse,  Up: Copyin
│ │ │ │ +00002ec0: 6720 496e 666f 726d 6174 696f 6e0a 0a43  g Information..C
│ │ │ │ +00002ed0: 2e31 2047 4e55 2046 7265 6520 446f 6375  .1 GNU Free Docu
│ │ │ │ +00002ee0: 6d65 6e74 6174 696f 6e20 4c69 6365 6e73  mentation Licens
│ │ │ │ +00002ef0: 650a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  e.==============
│ │ │ │  00002f00: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ -00002f10: 3d3d 3d0a 0a20 2020 2020 2020 2020 2020  ===..           
│ │ │ │ -00002f20: 2020 2020 2020 2020 2020 5665 7273 696f            Versio
│ │ │ │ -00002f30: 6e20 312e 332c 2033 204e 6f76 656d 6265  n 1.3, 3 Novembe
│ │ │ │ -00002f40: 7220 3230 3038 0a0a 2020 2020 2043 6f70  r 2008..     Cop
│ │ │ │ -00002f50: 7972 6967 6874 20c2 a920 3230 3030 2c20  yright .. 2000, 
│ │ │ │ -00002f60: 3230 3031 2c20 3230 3032 2c20 3230 3037  2001, 2002, 2007
│ │ │ │ -00002f70: 2c20 3230 3038 2046 7265 6520 536f 6674  , 2008 Free Soft
│ │ │ │ -00002f80: 7761 7265 2046 6f75 6e64 6174 696f 6e2c  ware Foundation,
│ │ │ │ -00002f90: 2049 6e63 2e0a 2020 2020 203c 6874 7470   Inc..     <http
│ │ │ │ -00002fa0: 733a 2f2f 6673 662e 6f72 672f 3e0a 0a20  s://fsf.org/>.. 
│ │ │ │ -00002fb0: 2020 2020 4576 6572 796f 6e65 2069 7320      Everyone is 
│ │ │ │ -00002fc0: 7065 726d 6974 7465 6420 746f 2063 6f70  permitted to cop
│ │ │ │ -00002fd0: 7920 616e 6420 6469 7374 7269 6275 7465  y and distribute
│ │ │ │ -00002fe0: 2076 6572 6261 7469 6d20 636f 7069 6573   verbatim copies
│ │ │ │ -00002ff0: 0a20 2020 2020 6f66 2074 6869 7320 6c69  .     of this li
│ │ │ │ -00003000: 6365 6e73 6520 646f 6375 6d65 6e74 2c20  cense document, 
│ │ │ │ -00003010: 6275 7420 6368 616e 6769 6e67 2069 7420  but changing it 
│ │ │ │ -00003020: 6973 206e 6f74 2061 6c6c 6f77 6564 2e0a  is not allowed..
│ │ │ │ -00003030: 0a20 2030 2e20 5052 4541 4d42 4c45 0a0a  .  0. PREAMBLE..
│ │ │ │ -00003040: 2020 2020 2054 6865 2070 7572 706f 7365       The purpose
│ │ │ │ -00003050: 206f 6620 7468 6973 204c 6963 656e 7365   of this License
│ │ │ │ -00003060: 2069 7320 746f 206d 616b 6520 6120 6d61   is to make a ma
│ │ │ │ -00003070: 6e75 616c 2c20 7465 7874 626f 6f6b 2c20  nual, textbook, 
│ │ │ │ -00003080: 6f72 206f 7468 6572 0a20 2020 2020 6675  or other.     fu
│ │ │ │ -00003090: 6e63 7469 6f6e 616c 2061 6e64 2075 7365  nctional and use
│ │ │ │ -000030a0: 6675 6c20 646f 6375 6d65 6e74 20e2 809c  ful document ...
│ │ │ │ -000030b0: 6672 6565 e280 9d20 696e 2074 6865 2073  free... in the s
│ │ │ │ -000030c0: 656e 7365 206f 6620 6672 6565 646f 6d3a  ense of freedom:
│ │ │ │ -000030d0: 2074 6f0a 2020 2020 2061 7373 7572 6520   to.     assure 
│ │ │ │ -000030e0: 6576 6572 796f 6e65 2074 6865 2065 6666  everyone the eff
│ │ │ │ -000030f0: 6563 7469 7665 2066 7265 6564 6f6d 2074  ective freedom t
│ │ │ │ -00003100: 6f20 636f 7079 2061 6e64 2072 6564 6973  o copy and redis
│ │ │ │ -00003110: 7472 6962 7574 6520 6974 2c0a 2020 2020  tribute it,.    
│ │ │ │ -00003120: 2077 6974 6820 6f72 2077 6974 686f 7574   with or without
│ │ │ │ -00003130: 206d 6f64 6966 7969 6e67 2069 742c 2065   modifying it, e
│ │ │ │ -00003140: 6974 6865 7220 636f 6d6d 6572 6369 616c  ither commercial
│ │ │ │ -00003150: 6c79 206f 720a 2020 2020 206e 6f6e 636f  ly or.     nonco
│ │ │ │ -00003160: 6d6d 6572 6369 616c 6c79 2e20 2053 6563  mmercially.  Sec
│ │ │ │ -00003170: 6f6e 6461 7269 6c79 2c20 7468 6973 204c  ondarily, this L
│ │ │ │ -00003180: 6963 656e 7365 2070 7265 7365 7276 6573  icense preserves
│ │ │ │ -00003190: 2066 6f72 2074 6865 0a20 2020 2020 6175   for the.     au
│ │ │ │ -000031a0: 7468 6f72 2061 6e64 2070 7562 6c69 7368  thor and publish
│ │ │ │ -000031b0: 6572 2061 2077 6179 2074 6f20 6765 7420  er a way to get 
│ │ │ │ -000031c0: 6372 6564 6974 2066 6f72 2074 6865 6972  credit for their
│ │ │ │ -000031d0: 2077 6f72 6b2c 2077 6869 6c65 206e 6f74   work, while not
│ │ │ │ -000031e0: 0a20 2020 2020 6265 696e 6720 636f 6e73  .     being cons
│ │ │ │ -000031f0: 6964 6572 6564 2072 6573 706f 6e73 6962  idered responsib
│ │ │ │ -00003200: 6c65 2066 6f72 206d 6f64 6966 6963 6174  le for modificat
│ │ │ │ -00003210: 696f 6e73 206d 6164 6520 6279 206f 7468  ions made by oth
│ │ │ │ -00003220: 6572 732e 0a0a 2020 2020 2054 6869 7320  ers...     This 
│ │ │ │ -00003230: 4c69 6365 6e73 6520 6973 2061 206b 696e  License is a kin
│ │ │ │ -00003240: 6420 6f66 2022 636f 7079 6c65 6674 222c  d of "copyleft",
│ │ │ │ -00003250: 2077 6869 6368 206d 6561 6e73 2074 6861   which means tha
│ │ │ │ -00003260: 7420 6465 7269 7661 7469 7665 0a20 2020  t derivative.   
│ │ │ │ -00003270: 2020 776f 726b 7320 6f66 2074 6865 2064    works of the d
│ │ │ │ -00003280: 6f63 756d 656e 7420 6d75 7374 2074 6865  ocument must the
│ │ │ │ -00003290: 6d73 656c 7665 7320 6265 2066 7265 6520  mselves be free 
│ │ │ │ -000032a0: 696e 2074 6865 2073 616d 6520 7365 6e73  in the same sens
│ │ │ │ -000032b0: 652e 0a20 2020 2020 4974 2063 6f6d 706c  e..     It compl
│ │ │ │ -000032c0: 656d 656e 7473 2074 6865 2047 4e55 2047  ements the GNU G
│ │ │ │ -000032d0: 656e 6572 616c 2050 7562 6c69 6320 4c69  eneral Public Li
│ │ │ │ -000032e0: 6365 6e73 652c 2077 6869 6368 2069 7320  cense, which is 
│ │ │ │ -000032f0: 6120 636f 7079 6c65 6674 0a20 2020 2020  a copyleft.     
│ │ │ │ -00003300: 6c69 6365 6e73 6520 6465 7369 676e 6564  license designed
│ │ │ │ -00003310: 2066 6f72 2066 7265 6520 736f 6674 7761   for free softwa
│ │ │ │ -00003320: 7265 2e0a 0a20 2020 2020 5765 2068 6176  re...     We hav
│ │ │ │ -00003330: 6520 6465 7369 676e 6564 2074 6869 7320  e designed this 
│ │ │ │ -00003340: 4c69 6365 6e73 6520 696e 206f 7264 6572  License in order
│ │ │ │ -00003350: 2074 6f20 7573 6520 6974 2066 6f72 206d   to use it for m
│ │ │ │ -00003360: 616e 7561 6c73 2066 6f72 0a20 2020 2020  anuals for.     
│ │ │ │ -00003370: 6672 6565 2073 6f66 7477 6172 652c 2062  free software, b
│ │ │ │ -00003380: 6563 6175 7365 2066 7265 6520 736f 6674  ecause free soft
│ │ │ │ -00003390: 7761 7265 206e 6565 6473 2066 7265 6520  ware needs free 
│ │ │ │ -000033a0: 646f 6375 6d65 6e74 6174 696f 6e3a 2061  documentation: a
│ │ │ │ -000033b0: 0a20 2020 2020 6672 6565 2070 726f 6772  .     free progr
│ │ │ │ -000033c0: 616d 2073 686f 756c 6420 636f 6d65 2077  am should come w
│ │ │ │ -000033d0: 6974 6820 6d61 6e75 616c 7320 7072 6f76  ith manuals prov
│ │ │ │ -000033e0: 6964 696e 6720 7468 6520 7361 6d65 2066  iding the same f
│ │ │ │ -000033f0: 7265 6564 6f6d 730a 2020 2020 2074 6861  reedoms.     tha
│ │ │ │ -00003400: 7420 7468 6520 736f 6674 7761 7265 2064  t the software d
│ │ │ │ -00003410: 6f65 732e 2020 4275 7420 7468 6973 204c  oes.  But this L
│ │ │ │ -00003420: 6963 656e 7365 2069 7320 6e6f 7420 6c69  icense is not li
│ │ │ │ -00003430: 6d69 7465 6420 746f 0a20 2020 2020 736f  mited to.     so
│ │ │ │ -00003440: 6674 7761 7265 206d 616e 7561 6c73 3b20  ftware manuals; 
│ │ │ │ -00003450: 6974 2063 616e 2062 6520 7573 6564 2066  it can be used f
│ │ │ │ -00003460: 6f72 2061 6e79 2074 6578 7475 616c 2077  or any textual w
│ │ │ │ -00003470: 6f72 6b2c 2072 6567 6172 646c 6573 730a  ork, regardless.
│ │ │ │ -00003480: 2020 2020 206f 6620 7375 626a 6563 7420       of subject 
│ │ │ │ -00003490: 6d61 7474 6572 206f 7220 7768 6574 6865  matter or whethe
│ │ │ │ -000034a0: 7220 6974 2069 7320 7075 626c 6973 6865  r it is publishe
│ │ │ │ -000034b0: 6420 6173 2061 2070 7269 6e74 6564 2062  d as a printed b
│ │ │ │ -000034c0: 6f6f 6b2e 2020 5765 0a20 2020 2020 7265  ook.  We.     re
│ │ │ │ -000034d0: 636f 6d6d 656e 6420 7468 6973 204c 6963  commend this Lic
│ │ │ │ -000034e0: 656e 7365 2070 7269 6e63 6970 616c 6c79  ense principally
│ │ │ │ -000034f0: 2066 6f72 2077 6f72 6b73 2077 686f 7365   for works whose
│ │ │ │ -00003500: 2070 7572 706f 7365 2069 730a 2020 2020   purpose is.    
│ │ │ │ -00003510: 2069 6e73 7472 7563 7469 6f6e 206f 7220   instruction or 
│ │ │ │ -00003520: 7265 6665 7265 6e63 652e 0a0a 2020 312e  reference...  1.
│ │ │ │ -00003530: 2041 5050 4c49 4341 4249 4c49 5459 2041   APPLICABILITY A
│ │ │ │ -00003540: 4e44 2044 4546 494e 4954 494f 4e53 0a0a  ND DEFINITIONS..
│ │ │ │ -00003550: 2020 2020 2054 6869 7320 4c69 6365 6e73       This Licens
│ │ │ │ -00003560: 6520 6170 706c 6965 7320 746f 2061 6e79  e applies to any
│ │ │ │ -00003570: 206d 616e 7561 6c20 6f72 206f 7468 6572   manual or other
│ │ │ │ -00003580: 2077 6f72 6b2c 2069 6e20 616e 7920 6d65   work, in any me
│ │ │ │ -00003590: 6469 756d 2c0a 2020 2020 2074 6861 7420  dium,.     that 
│ │ │ │ -000035a0: 636f 6e74 6169 6e73 2061 206e 6f74 6963  contains a notic
│ │ │ │ -000035b0: 6520 706c 6163 6564 2062 7920 7468 6520  e placed by the 
│ │ │ │ -000035c0: 636f 7079 7269 6768 7420 686f 6c64 6572  copyright holder
│ │ │ │ -000035d0: 2073 6179 696e 6720 6974 2063 616e 0a20   saying it can. 
│ │ │ │ -000035e0: 2020 2020 6265 2064 6973 7472 6962 7574      be distribut
│ │ │ │ -000035f0: 6564 2075 6e64 6572 2074 6865 2074 6572  ed under the ter
│ │ │ │ -00003600: 6d73 206f 6620 7468 6973 204c 6963 656e  ms of this Licen
│ │ │ │ -00003610: 7365 2e20 2053 7563 6820 6120 6e6f 7469  se.  Such a noti
│ │ │ │ -00003620: 6365 0a20 2020 2020 6772 616e 7473 2061  ce.     grants a
│ │ │ │ -00003630: 2077 6f72 6c64 2d77 6964 652c 2072 6f79   world-wide, roy
│ │ │ │ -00003640: 616c 7479 2d66 7265 6520 6c69 6365 6e73  alty-free licens
│ │ │ │ -00003650: 652c 2075 6e6c 696d 6974 6564 2069 6e20  e, unlimited in 
│ │ │ │ -00003660: 6475 7261 7469 6f6e 2c0a 2020 2020 2074  duration,.     t
│ │ │ │ -00003670: 6f20 7573 6520 7468 6174 2077 6f72 6b20  o use that work 
│ │ │ │ -00003680: 756e 6465 7220 7468 6520 636f 6e64 6974  under the condit
│ │ │ │ -00003690: 696f 6e73 2073 7461 7465 6420 6865 7265  ions stated here
│ │ │ │ -000036a0: 696e 2e20 2054 6865 0a20 2020 2020 2244  in.  The.     "D
│ │ │ │ -000036b0: 6f63 756d 656e 7422 2c20 6265 6c6f 772c  ocument", below,
│ │ │ │ -000036c0: 2072 6566 6572 7320 746f 2061 6e79 2073   refers to any s
│ │ │ │ -000036d0: 7563 6820 6d61 6e75 616c 206f 7220 776f  uch manual or wo
│ │ │ │ -000036e0: 726b 2e20 2041 6e79 206d 656d 6265 720a  rk.  Any member.
│ │ │ │ -000036f0: 2020 2020 206f 6620 7468 6520 7075 626c       of the publ
│ │ │ │ -00003700: 6963 2069 7320 6120 6c69 6365 6e73 6565  ic is a licensee
│ │ │ │ -00003710: 2c20 616e 6420 6973 2061 6464 7265 7373  , and is address
│ │ │ │ -00003720: 6564 2061 7320 2279 6f75 222e 2020 596f  ed as "you".  Yo
│ │ │ │ -00003730: 7520 6163 6365 7074 0a20 2020 2020 7468  u accept.     th
│ │ │ │ -00003740: 6520 6c69 6365 6e73 6520 6966 2079 6f75  e license if you
│ │ │ │ -00003750: 2063 6f70 792c 206d 6f64 6966 7920 6f72   copy, modify or
│ │ │ │ -00003760: 2064 6973 7472 6962 7574 6520 7468 6520   distribute the 
│ │ │ │ -00003770: 776f 726b 2069 6e20 6120 7761 790a 2020  work in a way.  
│ │ │ │ -00003780: 2020 2072 6571 7569 7269 6e67 2070 6572     requiring per
│ │ │ │ -00003790: 6d69 7373 696f 6e20 756e 6465 7220 636f  mission under co
│ │ │ │ -000037a0: 7079 7269 6768 7420 6c61 772e 0a0a 2020  pyright law...  
│ │ │ │ -000037b0: 2020 2041 2022 4d6f 6469 6669 6564 2056     A "Modified V
│ │ │ │ -000037c0: 6572 7369 6f6e 2220 6f66 2074 6865 2044  ersion" of the D
│ │ │ │ -000037d0: 6f63 756d 656e 7420 6d65 616e 7320 616e  ocument means an
│ │ │ │ -000037e0: 7920 776f 726b 2063 6f6e 7461 696e 696e  y work containin
│ │ │ │ -000037f0: 6720 7468 650a 2020 2020 2044 6f63 756d  g the.     Docum
│ │ │ │ -00003800: 656e 7420 6f72 2061 2070 6f72 7469 6f6e  ent or a portion
│ │ │ │ -00003810: 206f 6620 6974 2c20 6569 7468 6572 2063   of it, either c
│ │ │ │ -00003820: 6f70 6965 6420 7665 7262 6174 696d 2c20  opied verbatim, 
│ │ │ │ -00003830: 6f72 2077 6974 680a 2020 2020 206d 6f64  or with.     mod
│ │ │ │ -00003840: 6966 6963 6174 696f 6e73 2061 6e64 2f6f  ifications and/o
│ │ │ │ -00003850: 7220 7472 616e 736c 6174 6564 2069 6e74  r translated int
│ │ │ │ -00003860: 6f20 616e 6f74 6865 7220 6c61 6e67 7561  o another langua
│ │ │ │ -00003870: 6765 2e0a 0a20 2020 2020 4120 2253 6563  ge...     A "Sec
│ │ │ │ -00003880: 6f6e 6461 7279 2053 6563 7469 6f6e 2220  ondary Section" 
│ │ │ │ -00003890: 6973 2061 206e 616d 6564 2061 7070 656e  is a named appen
│ │ │ │ -000038a0: 6469 7820 6f72 2061 2066 726f 6e74 2d6d  dix or a front-m
│ │ │ │ -000038b0: 6174 7465 7220 7365 6374 696f 6e0a 2020  atter section.  
│ │ │ │ -000038c0: 2020 206f 6620 7468 6520 446f 6375 6d65     of the Docume
│ │ │ │ -000038d0: 6e74 2074 6861 7420 6465 616c 7320 6578  nt that deals ex
│ │ │ │ -000038e0: 636c 7573 6976 656c 7920 7769 7468 2074  clusively with t
│ │ │ │ -000038f0: 6865 2072 656c 6174 696f 6e73 6869 7020  he relationship 
│ │ │ │ -00003900: 6f66 2074 6865 0a20 2020 2020 7075 626c  of the.     publ
│ │ │ │ -00003910: 6973 6865 7273 206f 7220 6175 7468 6f72  ishers or author
│ │ │ │ -00003920: 7320 6f66 2074 6865 2044 6f63 756d 656e  s of the Documen
│ │ │ │ -00003930: 7420 746f 2074 6865 2044 6f63 756d 656e  t to the Documen
│ │ │ │ -00003940: 7427 7320 6f76 6572 616c 6c0a 2020 2020  t's overall.    
│ │ │ │ -00003950: 2073 7562 6a65 6374 2028 6f72 2074 6f20   subject (or to 
│ │ │ │ -00003960: 7265 6c61 7465 6420 6d61 7474 6572 7329  related matters)
│ │ │ │ -00003970: 2061 6e64 2063 6f6e 7461 696e 7320 6e6f   and contains no
│ │ │ │ -00003980: 7468 696e 6720 7468 6174 2063 6f75 6c64  thing that could
│ │ │ │ -00003990: 0a20 2020 2020 6661 6c6c 2064 6972 6563  .     fall direc
│ │ │ │ -000039a0: 746c 7920 7769 7468 696e 2074 6861 7420  tly within that 
│ │ │ │ -000039b0: 6f76 6572 616c 6c20 7375 626a 6563 742e  overall subject.
│ │ │ │ -000039c0: 2020 2854 6875 732c 2069 6620 7468 6520    (Thus, if the 
│ │ │ │ -000039d0: 446f 6375 6d65 6e74 0a20 2020 2020 6973  Document.     is
│ │ │ │ -000039e0: 2069 6e20 7061 7274 2061 2074 6578 7462   in part a textb
│ │ │ │ -000039f0: 6f6f 6b20 6f66 206d 6174 6865 6d61 7469  ook of mathemati
│ │ │ │ -00003a00: 6373 2c20 6120 5365 636f 6e64 6172 7920  cs, a Secondary 
│ │ │ │ -00003a10: 5365 6374 696f 6e20 6d61 7920 6e6f 740a  Section may not.
│ │ │ │ -00003a20: 2020 2020 2065 7870 6c61 696e 2061 6e79       explain any
│ │ │ │ -00003a30: 206d 6174 6865 6d61 7469 6373 2e29 2020   mathematics.)  
│ │ │ │ -00003a40: 5468 6520 7265 6c61 7469 6f6e 7368 6970  The relationship
│ │ │ │ -00003a50: 2063 6f75 6c64 2062 6520 6120 6d61 7474   could be a matt
│ │ │ │ -00003a60: 6572 206f 660a 2020 2020 2068 6973 746f  er of.     histo
│ │ │ │ -00003a70: 7269 6361 6c20 636f 6e6e 6563 7469 6f6e  rical connection
│ │ │ │ -00003a80: 2077 6974 6820 7468 6520 7375 626a 6563   with the subjec
│ │ │ │ -00003a90: 7420 6f72 2077 6974 6820 7265 6c61 7465  t or with relate
│ │ │ │ -00003aa0: 6420 6d61 7474 6572 732c 206f 720a 2020  d matters, or.  
│ │ │ │ -00003ab0: 2020 206f 6620 6c65 6761 6c2c 2063 6f6d     of legal, com
│ │ │ │ -00003ac0: 6d65 7263 6961 6c2c 2070 6869 6c6f 736f  mercial, philoso
│ │ │ │ -00003ad0: 7068 6963 616c 2c20 6574 6869 6361 6c20  phical, ethical 
│ │ │ │ -00003ae0: 6f72 2070 6f6c 6974 6963 616c 2070 6f73  or political pos
│ │ │ │ -00003af0: 6974 696f 6e0a 2020 2020 2072 6567 6172  ition.     regar
│ │ │ │ -00003b00: 6469 6e67 2074 6865 6d2e 0a0a 2020 2020  ding them...    
│ │ │ │ -00003b10: 2054 6865 2022 496e 7661 7269 616e 7420   The "Invariant 
│ │ │ │ -00003b20: 5365 6374 696f 6e73 2220 6172 6520 6365  Sections" are ce
│ │ │ │ -00003b30: 7274 6169 6e20 5365 636f 6e64 6172 7920  rtain Secondary 
│ │ │ │ -00003b40: 5365 6374 696f 6e73 2077 686f 7365 0a20  Sections whose. 
│ │ │ │ -00003b50: 2020 2020 7469 746c 6573 2061 7265 2064      titles are d
│ │ │ │ -00003b60: 6573 6967 6e61 7465 642c 2061 7320 6265  esignated, as be
│ │ │ │ -00003b70: 696e 6720 7468 6f73 6520 6f66 2049 6e76  ing those of Inv
│ │ │ │ -00003b80: 6172 6961 6e74 2053 6563 7469 6f6e 732c  ariant Sections,
│ │ │ │ -00003b90: 2069 6e20 7468 650a 2020 2020 206e 6f74   in the.     not
│ │ │ │ -00003ba0: 6963 6520 7468 6174 2073 6179 7320 7468  ice that says th
│ │ │ │ -00003bb0: 6174 2074 6865 2044 6f63 756d 656e 7420  at the Document 
│ │ │ │ -00003bc0: 6973 2072 656c 6561 7365 6420 756e 6465  is released unde
│ │ │ │ -00003bd0: 7220 7468 6973 204c 6963 656e 7365 2e0a  r this License..
│ │ │ │ -00003be0: 2020 2020 2049 6620 6120 7365 6374 696f       If a sectio
│ │ │ │ -00003bf0: 6e20 646f 6573 206e 6f74 2066 6974 2074  n does not fit t
│ │ │ │ -00003c00: 6865 2061 626f 7665 2064 6566 696e 6974  he above definit
│ │ │ │ -00003c10: 696f 6e20 6f66 2053 6563 6f6e 6461 7279  ion of Secondary
│ │ │ │ -00003c20: 2074 6865 6e20 6974 0a20 2020 2020 6973   then it.     is
│ │ │ │ -00003c30: 206e 6f74 2061 6c6c 6f77 6564 2074 6f20   not allowed to 
│ │ │ │ -00003c40: 6265 2064 6573 6967 6e61 7465 6420 6173  be designated as
│ │ │ │ -00003c50: 2049 6e76 6172 6961 6e74 2e20 2054 6865   Invariant.  The
│ │ │ │ -00003c60: 2044 6f63 756d 656e 7420 6d61 790a 2020   Document may.  
│ │ │ │ -00003c70: 2020 2063 6f6e 7461 696e 207a 6572 6f20     contain zero 
│ │ │ │ -00003c80: 496e 7661 7269 616e 7420 5365 6374 696f  Invariant Sectio
│ │ │ │ -00003c90: 6e73 2e20 2049 6620 7468 6520 446f 6375  ns.  If the Docu
│ │ │ │ -00003ca0: 6d65 6e74 2064 6f65 7320 6e6f 7420 6964  ment does not id
│ │ │ │ -00003cb0: 656e 7469 6679 0a20 2020 2020 616e 7920  entify.     any 
│ │ │ │ -00003cc0: 496e 7661 7269 616e 7420 5365 6374 696f  Invariant Sectio
│ │ │ │ -00003cd0: 6e73 2074 6865 6e20 7468 6572 6520 6172  ns then there ar
│ │ │ │ -00003ce0: 6520 6e6f 6e65 2e0a 0a20 2020 2020 5468  e none...     Th
│ │ │ │ -00003cf0: 6520 2243 6f76 6572 2054 6578 7473 2220  e "Cover Texts" 
│ │ │ │ -00003d00: 6172 6520 6365 7274 6169 6e20 7368 6f72  are certain shor
│ │ │ │ -00003d10: 7420 7061 7373 6167 6573 206f 6620 7465  t passages of te
│ │ │ │ -00003d20: 7874 2074 6861 7420 6172 650a 2020 2020  xt that are.    
│ │ │ │ -00003d30: 206c 6973 7465 642c 2061 7320 4672 6f6e   listed, as Fron
│ │ │ │ -00003d40: 742d 436f 7665 7220 5465 7874 7320 6f72  t-Cover Texts or
│ │ │ │ -00003d50: 2042 6163 6b2d 436f 7665 7220 5465 7874   Back-Cover Text
│ │ │ │ -00003d60: 732c 2069 6e20 7468 6520 6e6f 7469 6365  s, in the notice
│ │ │ │ -00003d70: 0a20 2020 2020 7468 6174 2073 6179 7320  .     that says 
│ │ │ │ -00003d80: 7468 6174 2074 6865 2044 6f63 756d 656e  that the Documen
│ │ │ │ -00003d90: 7420 6973 2072 656c 6561 7365 6420 756e  t is released un
│ │ │ │ -00003da0: 6465 7220 7468 6973 204c 6963 656e 7365  der this License
│ │ │ │ -00003db0: 2e20 2041 0a20 2020 2020 4672 6f6e 742d  .  A.     Front-
│ │ │ │ -00003dc0: 436f 7665 7220 5465 7874 206d 6179 2062  Cover Text may b
│ │ │ │ -00003dd0: 6520 6174 206d 6f73 7420 3520 776f 7264  e at most 5 word
│ │ │ │ -00003de0: 732c 2061 6e64 2061 2042 6163 6b2d 436f  s, and a Back-Co
│ │ │ │ -00003df0: 7665 7220 5465 7874 206d 6179 0a20 2020  ver Text may.   
│ │ │ │ -00003e00: 2020 6265 2061 7420 6d6f 7374 2032 3520    be at most 25 
│ │ │ │ -00003e10: 776f 7264 732e 0a0a 2020 2020 2041 2022  words...     A "
│ │ │ │ -00003e20: 5472 616e 7370 6172 656e 7422 2063 6f70  Transparent" cop
│ │ │ │ -00003e30: 7920 6f66 2074 6865 2044 6f63 756d 656e  y of the Documen
│ │ │ │ -00003e40: 7420 6d65 616e 7320 6120 6d61 6368 696e  t means a machin
│ │ │ │ -00003e50: 652d 7265 6164 6162 6c65 2063 6f70 792c  e-readable copy,
│ │ │ │ -00003e60: 0a20 2020 2020 7265 7072 6573 656e 7465  .     represente
│ │ │ │ -00003e70: 6420 696e 2061 2066 6f72 6d61 7420 7768  d in a format wh
│ │ │ │ -00003e80: 6f73 6520 7370 6563 6966 6963 6174 696f  ose specificatio
│ │ │ │ -00003e90: 6e20 6973 2061 7661 696c 6162 6c65 2074  n is available t
│ │ │ │ -00003ea0: 6f20 7468 650a 2020 2020 2067 656e 6572  o the.     gener
│ │ │ │ -00003eb0: 616c 2070 7562 6c69 632c 2074 6861 7420  al public, that 
│ │ │ │ -00003ec0: 6973 2073 7569 7461 626c 6520 666f 7220  is suitable for 
│ │ │ │ -00003ed0: 7265 7669 7369 6e67 2074 6865 2064 6f63  revising the doc
│ │ │ │ -00003ee0: 756d 656e 740a 2020 2020 2073 7472 6169  ument.     strai
│ │ │ │ -00003ef0: 6768 7466 6f72 7761 7264 6c79 2077 6974  ghtforwardly wit
│ │ │ │ -00003f00: 6820 6765 6e65 7269 6320 7465 7874 2065  h generic text e
│ │ │ │ -00003f10: 6469 746f 7273 206f 7220 2866 6f72 2069  ditors or (for i
│ │ │ │ -00003f20: 6d61 6765 7320 636f 6d70 6f73 6564 0a20  mages composed. 
│ │ │ │ -00003f30: 2020 2020 6f66 2070 6978 656c 7329 2067      of pixels) g
│ │ │ │ -00003f40: 656e 6572 6963 2070 6169 6e74 2070 726f  eneric paint pro
│ │ │ │ -00003f50: 6772 616d 7320 6f72 2028 666f 7220 6472  grams or (for dr
│ │ │ │ -00003f60: 6177 696e 6773 2920 736f 6d65 2077 6964  awings) some wid
│ │ │ │ -00003f70: 656c 790a 2020 2020 2061 7661 696c 6162  ely.     availab
│ │ │ │ -00003f80: 6c65 2064 7261 7769 6e67 2065 6469 746f  le drawing edito
│ │ │ │ -00003f90: 722c 2061 6e64 2074 6861 7420 6973 2073  r, and that is s
│ │ │ │ -00003fa0: 7569 7461 626c 6520 666f 7220 696e 7075  uitable for inpu
│ │ │ │ -00003fb0: 7420 746f 2074 6578 740a 2020 2020 2066  t to text.     f
│ │ │ │ -00003fc0: 6f72 6d61 7474 6572 7320 6f72 2066 6f72  ormatters or for
│ │ │ │ -00003fd0: 2061 7574 6f6d 6174 6963 2074 7261 6e73   automatic trans
│ │ │ │ -00003fe0: 6c61 7469 6f6e 2074 6f20 6120 7661 7269  lation to a vari
│ │ │ │ -00003ff0: 6574 7920 6f66 2066 6f72 6d61 7473 0a20  ety of formats. 
│ │ │ │ -00004000: 2020 2020 7375 6974 6162 6c65 2066 6f72      suitable for
│ │ │ │ -00004010: 2069 6e70 7574 2074 6f20 7465 7874 2066   input to text f
│ │ │ │ -00004020: 6f72 6d61 7474 6572 732e 2020 4120 636f  ormatters.  A co
│ │ │ │ -00004030: 7079 206d 6164 6520 696e 2061 6e20 6f74  py made in an ot
│ │ │ │ -00004040: 6865 7277 6973 650a 2020 2020 2054 7261  herwise.     Tra
│ │ │ │ -00004050: 6e73 7061 7265 6e74 2066 696c 6520 666f  nsparent file fo
│ │ │ │ -00004060: 726d 6174 2077 686f 7365 206d 6172 6b75  rmat whose marku
│ │ │ │ -00004070: 702c 206f 7220 6162 7365 6e63 6520 6f66  p, or absence of
│ │ │ │ -00004080: 206d 6172 6b75 702c 2068 6173 0a20 2020   markup, has.   
│ │ │ │ -00004090: 2020 6265 656e 2061 7272 616e 6765 6420    been arranged 
│ │ │ │ -000040a0: 746f 2074 6877 6172 7420 6f72 2064 6973  to thwart or dis
│ │ │ │ -000040b0: 636f 7572 6167 6520 7375 6273 6571 7565  courage subseque
│ │ │ │ -000040c0: 6e74 206d 6f64 6966 6963 6174 696f 6e20  nt modification 
│ │ │ │ -000040d0: 6279 0a20 2020 2020 7265 6164 6572 7320  by.     readers 
│ │ │ │ -000040e0: 6973 206e 6f74 2054 7261 6e73 7061 7265  is not Transpare
│ │ │ │ -000040f0: 6e74 2e20 2041 6e20 696d 6167 6520 666f  nt.  An image fo
│ │ │ │ -00004100: 726d 6174 2069 7320 6e6f 7420 5472 616e  rmat is not Tran
│ │ │ │ -00004110: 7370 6172 656e 7420 6966 0a20 2020 2020  sparent if.     
│ │ │ │ -00004120: 7573 6564 2066 6f72 2061 6e79 2073 7562  used for any sub
│ │ │ │ -00004130: 7374 616e 7469 616c 2061 6d6f 756e 7420  stantial amount 
│ │ │ │ -00004140: 6f66 2074 6578 742e 2020 4120 636f 7079  of text.  A copy
│ │ │ │ -00004150: 2074 6861 7420 6973 206e 6f74 0a20 2020   that is not.   
│ │ │ │ -00004160: 2020 2254 7261 6e73 7061 7265 6e74 2220    "Transparent" 
│ │ │ │ -00004170: 6973 2063 616c 6c65 6420 224f 7061 7175  is called "Opaqu
│ │ │ │ -00004180: 6522 2e0a 0a20 2020 2020 4578 616d 706c  e"...     Exampl
│ │ │ │ -00004190: 6573 206f 6620 7375 6974 6162 6c65 2066  es of suitable f
│ │ │ │ -000041a0: 6f72 6d61 7473 2066 6f72 2054 7261 6e73  ormats for Trans
│ │ │ │ -000041b0: 7061 7265 6e74 2063 6f70 6965 7320 696e  parent copies in
│ │ │ │ -000041c0: 636c 7564 6520 706c 6169 6e0a 2020 2020  clude plain.    
│ │ │ │ -000041d0: 2041 5343 4949 2077 6974 686f 7574 206d   ASCII without m
│ │ │ │ -000041e0: 6172 6b75 702c 2054 6578 696e 666f 2069  arkup, Texinfo i
│ │ │ │ -000041f0: 6e70 7574 2066 6f72 6d61 742c 204c 6154  nput format, LaT
│ │ │ │ -00004200: 6558 2069 6e70 7574 2066 6f72 6d61 742c  eX input format,
│ │ │ │ -00004210: 0a20 2020 2020 5347 4d4c 206f 7220 584d  .     SGML or XM
│ │ │ │ -00004220: 4c20 7573 696e 6720 6120 7075 626c 6963  L using a public
│ │ │ │ -00004230: 6c79 2061 7661 696c 6162 6c65 2044 5444  ly available DTD
│ │ │ │ -00004240: 2c20 616e 6420 7374 616e 6461 7264 2d63  , and standard-c
│ │ │ │ -00004250: 6f6e 666f 726d 696e 670a 2020 2020 2073  onforming.     s
│ │ │ │ -00004260: 696d 706c 6520 4854 4d4c 2c20 506f 7374  imple HTML, Post
│ │ │ │ -00004270: 5363 7269 7074 206f 7220 5044 4620 6465  Script or PDF de
│ │ │ │ -00004280: 7369 676e 6564 2066 6f72 2068 756d 616e  signed for human
│ │ │ │ -00004290: 206d 6f64 6966 6963 6174 696f 6e2e 0a20   modification.. 
│ │ │ │ -000042a0: 2020 2020 4578 616d 706c 6573 206f 6620      Examples of 
│ │ │ │ -000042b0: 7472 616e 7370 6172 656e 7420 696d 6167  transparent imag
│ │ │ │ -000042c0: 6520 666f 726d 6174 7320 696e 636c 7564  e formats includ
│ │ │ │ -000042d0: 6520 504e 472c 2058 4346 2061 6e64 204a  e PNG, XCF and J
│ │ │ │ -000042e0: 5047 2e0a 2020 2020 204f 7061 7175 6520  PG..     Opaque 
│ │ │ │ -000042f0: 666f 726d 6174 7320 696e 636c 7564 6520  formats include 
│ │ │ │ -00004300: 7072 6f70 7269 6574 6172 7920 666f 726d  proprietary form
│ │ │ │ -00004310: 6174 7320 7468 6174 2063 616e 2062 6520  ats that can be 
│ │ │ │ -00004320: 7265 6164 2061 6e64 0a20 2020 2020 6564  read and.     ed
│ │ │ │ -00004330: 6974 6564 206f 6e6c 7920 6279 2070 726f  ited only by pro
│ │ │ │ -00004340: 7072 6965 7461 7279 2077 6f72 6420 7072  prietary word pr
│ │ │ │ -00004350: 6f63 6573 736f 7273 2c20 5347 4d4c 206f  ocessors, SGML o
│ │ │ │ -00004360: 7220 584d 4c20 666f 7220 7768 6963 680a  r XML for which.
│ │ │ │ -00004370: 2020 2020 2074 6865 2044 5444 2061 6e64       the DTD and
│ │ │ │ -00004380: 2f6f 7220 7072 6f63 6573 7369 6e67 2074  /or processing t
│ │ │ │ -00004390: 6f6f 6c73 2061 7265 206e 6f74 2067 656e  ools are not gen
│ │ │ │ -000043a0: 6572 616c 6c79 2061 7661 696c 6162 6c65  erally available
│ │ │ │ -000043b0: 2c20 616e 640a 2020 2020 2074 6865 206d  , and.     the m
│ │ │ │ -000043c0: 6163 6869 6e65 2d67 656e 6572 6174 6564  achine-generated
│ │ │ │ -000043d0: 2048 544d 4c2c 2050 6f73 7453 6372 6970   HTML, PostScrip
│ │ │ │ -000043e0: 7420 6f72 2050 4446 2070 726f 6475 6365  t or PDF produce
│ │ │ │ -000043f0: 6420 6279 2073 6f6d 6520 776f 7264 0a20  d by some word. 
│ │ │ │ -00004400: 2020 2020 7072 6f63 6573 736f 7273 2066      processors f
│ │ │ │ -00004410: 6f72 206f 7574 7075 7420 7075 7270 6f73  or output purpos
│ │ │ │ -00004420: 6573 206f 6e6c 792e 0a0a 2020 2020 2054  es only...     T
│ │ │ │ -00004430: 6865 2022 5469 746c 6520 5061 6765 2220  he "Title Page" 
│ │ │ │ -00004440: 6d65 616e 732c 2066 6f72 2061 2070 7269  means, for a pri
│ │ │ │ -00004450: 6e74 6564 2062 6f6f 6b2c 2074 6865 2074  nted book, the t
│ │ │ │ -00004460: 6974 6c65 2070 6167 6520 6974 7365 6c66  itle page itself
│ │ │ │ -00004470: 2c0a 2020 2020 2070 6c75 7320 7375 6368  ,.     plus such
│ │ │ │ -00004480: 2066 6f6c 6c6f 7769 6e67 2070 6167 6573   following pages
│ │ │ │ -00004490: 2061 7320 6172 6520 6e65 6564 6564 2074   as are needed t
│ │ │ │ -000044a0: 6f20 686f 6c64 2c20 6c65 6769 626c 792c  o hold, legibly,
│ │ │ │ -000044b0: 2074 6865 0a20 2020 2020 6d61 7465 7269   the.     materi
│ │ │ │ -000044c0: 616c 2074 6869 7320 4c69 6365 6e73 6520  al this License 
│ │ │ │ -000044d0: 7265 7175 6972 6573 2074 6f20 6170 7065  requires to appe
│ │ │ │ -000044e0: 6172 2069 6e20 7468 6520 7469 746c 6520  ar in the title 
│ │ │ │ -000044f0: 7061 6765 2e20 2046 6f72 0a20 2020 2020  page.  For.     
│ │ │ │ -00004500: 776f 726b 7320 696e 2066 6f72 6d61 7473  works in formats
│ │ │ │ -00004510: 2077 6869 6368 2064 6f20 6e6f 7420 6861   which do not ha
│ │ │ │ -00004520: 7665 2061 6e79 2074 6974 6c65 2070 6167  ve any title pag
│ │ │ │ -00004530: 6520 6173 2073 7563 682c 2022 5469 746c  e as such, "Titl
│ │ │ │ -00004540: 650a 2020 2020 2050 6167 6522 206d 6561  e.     Page" mea
│ │ │ │ -00004550: 6e73 2074 6865 2074 6578 7420 6e65 6172  ns the text near
│ │ │ │ -00004560: 2074 6865 206d 6f73 7420 7072 6f6d 696e   the most promin
│ │ │ │ -00004570: 656e 7420 6170 7065 6172 616e 6365 206f  ent appearance o
│ │ │ │ -00004580: 6620 7468 650a 2020 2020 2077 6f72 6b27  f the.     work'
│ │ │ │ -00004590: 7320 7469 746c 652c 2070 7265 6365 6469  s title, precedi
│ │ │ │ -000045a0: 6e67 2074 6865 2062 6567 696e 6e69 6e67  ng the beginning
│ │ │ │ -000045b0: 206f 6620 7468 6520 626f 6479 206f 6620   of the body of 
│ │ │ │ -000045c0: 7468 6520 7465 7874 2e0a 0a20 2020 2020  the text...     
│ │ │ │ -000045d0: 5468 6520 2270 7562 6c69 7368 6572 2220  The "publisher" 
│ │ │ │ -000045e0: 6d65 616e 7320 616e 7920 7065 7273 6f6e  means any person
│ │ │ │ -000045f0: 206f 7220 656e 7469 7479 2074 6861 7420   or entity that 
│ │ │ │ -00004600: 6469 7374 7269 6275 7465 7320 636f 7069  distributes copi
│ │ │ │ -00004610: 6573 0a20 2020 2020 6f66 2074 6865 2044  es.     of the D
│ │ │ │ -00004620: 6f63 756d 656e 7420 746f 2074 6865 2070  ocument to the p
│ │ │ │ -00004630: 7562 6c69 632e 0a0a 2020 2020 2041 2073  ublic...     A s
│ │ │ │ -00004640: 6563 7469 6f6e 2022 456e 7469 746c 6564  ection "Entitled
│ │ │ │ -00004650: 2058 595a 2220 6d65 616e 7320 6120 6e61   XYZ" means a na
│ │ │ │ -00004660: 6d65 6420 7375 6275 6e69 7420 6f66 2074  med subunit of t
│ │ │ │ -00004670: 6865 2044 6f63 756d 656e 740a 2020 2020  he Document.    
│ │ │ │ -00004680: 2077 686f 7365 2074 6974 6c65 2065 6974   whose title eit
│ │ │ │ -00004690: 6865 7220 6973 2070 7265 6369 7365 6c79  her is precisely
│ │ │ │ -000046a0: 2058 595a 206f 7220 636f 6e74 6169 6e73   XYZ or contains
│ │ │ │ -000046b0: 2058 595a 2069 6e20 7061 7265 6e74 6865   XYZ in parenthe
│ │ │ │ -000046c0: 7365 730a 2020 2020 2066 6f6c 6c6f 7769  ses.     followi
│ │ │ │ -000046d0: 6e67 2074 6578 7420 7468 6174 2074 7261  ng text that tra
│ │ │ │ -000046e0: 6e73 6c61 7465 7320 5859 5a20 696e 2061  nslates XYZ in a
│ │ │ │ -000046f0: 6e6f 7468 6572 206c 616e 6775 6167 652e  nother language.
│ │ │ │ -00004700: 2020 2848 6572 6520 5859 5a0a 2020 2020    (Here XYZ.    
│ │ │ │ -00004710: 2073 7461 6e64 7320 666f 7220 6120 7370   stands for a sp
│ │ │ │ -00004720: 6563 6966 6963 2073 6563 7469 6f6e 206e  ecific section n
│ │ │ │ -00004730: 616d 6520 6d65 6e74 696f 6e65 6420 6265  ame mentioned be
│ │ │ │ -00004740: 6c6f 772c 2073 7563 6820 6173 0a20 2020  low, such as.   
│ │ │ │ -00004750: 2020 2241 636b 6e6f 776c 6564 6765 6d65    "Acknowledgeme
│ │ │ │ -00004760: 6e74 7322 2c20 2244 6564 6963 6174 696f  nts", "Dedicatio
│ │ │ │ -00004770: 6e73 222c 2022 456e 646f 7273 656d 656e  ns", "Endorsemen
│ │ │ │ -00004780: 7473 222c 206f 7220 2248 6973 746f 7279  ts", or "History
│ │ │ │ -00004790: 222e 290a 2020 2020 2054 6f20 2250 7265  ".).     To "Pre
│ │ │ │ -000047a0: 7365 7276 6520 7468 6520 5469 746c 6522  serve the Title"
│ │ │ │ -000047b0: 206f 6620 7375 6368 2061 2073 6563 7469   of such a secti
│ │ │ │ -000047c0: 6f6e 2077 6865 6e20 796f 7520 6d6f 6469  on when you modi
│ │ │ │ -000047d0: 6679 2074 6865 0a20 2020 2020 446f 6375  fy the.     Docu
│ │ │ │ -000047e0: 6d65 6e74 206d 6561 6e73 2074 6861 7420  ment means that 
│ │ │ │ -000047f0: 6974 2072 656d 6169 6e73 2061 2073 6563  it remains a sec
│ │ │ │ -00004800: 7469 6f6e 2022 456e 7469 746c 6564 2058  tion "Entitled X
│ │ │ │ -00004810: 595a 2220 6163 636f 7264 696e 670a 2020  YZ" according.  
│ │ │ │ -00004820: 2020 2074 6f20 7468 6973 2064 6566 696e     to this defin
│ │ │ │ -00004830: 6974 696f 6e2e 0a0a 2020 2020 2054 6865  ition...     The
│ │ │ │ -00004840: 2044 6f63 756d 656e 7420 6d61 7920 696e   Document may in
│ │ │ │ -00004850: 636c 7564 6520 5761 7272 616e 7479 2044  clude Warranty D
│ │ │ │ -00004860: 6973 636c 6169 6d65 7273 206e 6578 7420  isclaimers next 
│ │ │ │ -00004870: 746f 2074 6865 206e 6f74 6963 650a 2020  to the notice.  
│ │ │ │ -00004880: 2020 2077 6869 6368 2073 7461 7465 7320     which states 
│ │ │ │ -00004890: 7468 6174 2074 6869 7320 4c69 6365 6e73  that this Licens
│ │ │ │ -000048a0: 6520 6170 706c 6965 7320 746f 2074 6865  e applies to the
│ │ │ │ -000048b0: 2044 6f63 756d 656e 742e 2020 5468 6573   Document.  Thes
│ │ │ │ -000048c0: 650a 2020 2020 2057 6172 7261 6e74 7920  e.     Warranty 
│ │ │ │ -000048d0: 4469 7363 6c61 696d 6572 7320 6172 6520  Disclaimers are 
│ │ │ │ -000048e0: 636f 6e73 6964 6572 6564 2074 6f20 6265  considered to be
│ │ │ │ -000048f0: 2069 6e63 6c75 6465 6420 6279 2072 6566   included by ref
│ │ │ │ -00004900: 6572 656e 6365 2069 6e0a 2020 2020 2074  erence in.     t
│ │ │ │ -00004910: 6869 7320 4c69 6365 6e73 652c 2062 7574  his License, but
│ │ │ │ -00004920: 206f 6e6c 7920 6173 2072 6567 6172 6473   only as regards
│ │ │ │ -00004930: 2064 6973 636c 6169 6d69 6e67 2077 6172   disclaiming war
│ │ │ │ -00004940: 7261 6e74 6965 733a 2061 6e79 206f 7468  ranties: any oth
│ │ │ │ -00004950: 6572 0a20 2020 2020 696d 706c 6963 6174  er.     implicat
│ │ │ │ -00004960: 696f 6e20 7468 6174 2074 6865 7365 2057  ion that these W
│ │ │ │ -00004970: 6172 7261 6e74 7920 4469 7363 6c61 696d  arranty Disclaim
│ │ │ │ -00004980: 6572 7320 6d61 7920 6861 7665 2069 7320  ers may have is 
│ │ │ │ -00004990: 766f 6964 2061 6e64 0a20 2020 2020 6861  void and.     ha
│ │ │ │ -000049a0: 7320 6e6f 2065 6666 6563 7420 6f6e 2074  s no effect on t
│ │ │ │ -000049b0: 6865 206d 6561 6e69 6e67 206f 6620 7468  he meaning of th
│ │ │ │ -000049c0: 6973 204c 6963 656e 7365 2e0a 0a20 2032  is License...  2
│ │ │ │ -000049d0: 2e20 5645 5242 4154 494d 2043 4f50 5949  . VERBATIM COPYI
│ │ │ │ -000049e0: 4e47 0a0a 2020 2020 2059 6f75 206d 6179  NG..     You may
│ │ │ │ -000049f0: 2063 6f70 7920 616e 6420 6469 7374 7269   copy and distri
│ │ │ │ -00004a00: 6275 7465 2074 6865 2044 6f63 756d 656e  bute the Documen
│ │ │ │ -00004a10: 7420 696e 2061 6e79 206d 6564 6975 6d2c  t in any medium,
│ │ │ │ -00004a20: 2065 6974 6865 720a 2020 2020 2063 6f6d   either.     com
│ │ │ │ -00004a30: 6d65 7263 6961 6c6c 7920 6f72 206e 6f6e  mercially or non
│ │ │ │ -00004a40: 636f 6d6d 6572 6369 616c 6c79 2c20 7072  commercially, pr
│ │ │ │ -00004a50: 6f76 6964 6564 2074 6861 7420 7468 6973  ovided that this
│ │ │ │ -00004a60: 204c 6963 656e 7365 2c20 7468 650a 2020   License, the.  
│ │ │ │ -00004a70: 2020 2063 6f70 7972 6967 6874 206e 6f74     copyright not
│ │ │ │ -00004a80: 6963 6573 2c20 616e 6420 7468 6520 6c69  ices, and the li
│ │ │ │ -00004a90: 6365 6e73 6520 6e6f 7469 6365 2073 6179  cense notice say
│ │ │ │ -00004aa0: 696e 6720 7468 6973 204c 6963 656e 7365  ing this License
│ │ │ │ -00004ab0: 0a20 2020 2020 6170 706c 6965 7320 746f  .     applies to
│ │ │ │ -00004ac0: 2074 6865 2044 6f63 756d 656e 7420 6172   the Document ar
│ │ │ │ -00004ad0: 6520 7265 7072 6f64 7563 6564 2069 6e20  e reproduced in 
│ │ │ │ -00004ae0: 616c 6c20 636f 7069 6573 2c20 616e 6420  all copies, and 
│ │ │ │ -00004af0: 7468 6174 2079 6f75 0a20 2020 2020 6164  that you.     ad
│ │ │ │ -00004b00: 6420 6e6f 206f 7468 6572 2063 6f6e 6469  d no other condi
│ │ │ │ -00004b10: 7469 6f6e 7320 7768 6174 736f 6576 6572  tions whatsoever
│ │ │ │ -00004b20: 2074 6f20 7468 6f73 6520 6f66 2074 6869   to those of thi
│ │ │ │ -00004b30: 7320 4c69 6365 6e73 652e 2020 596f 750a  s License.  You.
│ │ │ │ -00004b40: 2020 2020 206d 6179 206e 6f74 2075 7365       may not use
│ │ │ │ -00004b50: 2074 6563 686e 6963 616c 206d 6561 7375   technical measu
│ │ │ │ -00004b60: 7265 7320 746f 206f 6273 7472 7563 7420  res to obstruct 
│ │ │ │ -00004b70: 6f72 2063 6f6e 7472 6f6c 2074 6865 2072  or control the r
│ │ │ │ -00004b80: 6561 6469 6e67 0a20 2020 2020 6f72 2066  eading.     or f
│ │ │ │ -00004b90: 7572 7468 6572 2063 6f70 7969 6e67 206f  urther copying o
│ │ │ │ -00004ba0: 6620 7468 6520 636f 7069 6573 2079 6f75  f the copies you
│ │ │ │ -00004bb0: 206d 616b 6520 6f72 2064 6973 7472 6962   make or distrib
│ │ │ │ -00004bc0: 7574 652e 2020 486f 7765 7665 722c 0a20  ute.  However,. 
│ │ │ │ -00004bd0: 2020 2020 796f 7520 6d61 7920 6163 6365      you may acce
│ │ │ │ -00004be0: 7074 2063 6f6d 7065 6e73 6174 696f 6e20  pt compensation 
│ │ │ │ -00004bf0: 696e 2065 7863 6861 6e67 6520 666f 7220  in exchange for 
│ │ │ │ -00004c00: 636f 7069 6573 2e20 2049 6620 796f 750a  copies.  If you.
│ │ │ │ -00004c10: 2020 2020 2064 6973 7472 6962 7574 6520       distribute 
│ │ │ │ -00004c20: 6120 6c61 7267 6520 656e 6f75 6768 206e  a large enough n
│ │ │ │ -00004c30: 756d 6265 7220 6f66 2063 6f70 6965 7320  umber of copies 
│ │ │ │ -00004c40: 796f 7520 6d75 7374 2061 6c73 6f20 666f  you must also fo
│ │ │ │ -00004c50: 6c6c 6f77 2074 6865 0a20 2020 2020 636f  llow the.     co
│ │ │ │ -00004c60: 6e64 6974 696f 6e73 2069 6e20 7365 6374  nditions in sect
│ │ │ │ -00004c70: 696f 6e20 332e 0a0a 2020 2020 2059 6f75  ion 3...     You
│ │ │ │ -00004c80: 206d 6179 2061 6c73 6f20 6c65 6e64 2063   may also lend c
│ │ │ │ -00004c90: 6f70 6965 732c 2075 6e64 6572 2074 6865  opies, under the
│ │ │ │ -00004ca0: 2073 616d 6520 636f 6e64 6974 696f 6e73   same conditions
│ │ │ │ -00004cb0: 2073 7461 7465 6420 6162 6f76 652c 0a20   stated above,. 
│ │ │ │ -00004cc0: 2020 2020 616e 6420 796f 7520 6d61 7920      and you may 
│ │ │ │ -00004cd0: 7075 626c 6963 6c79 2064 6973 706c 6179  publicly display
│ │ │ │ -00004ce0: 2063 6f70 6965 732e 0a0a 2020 332e 2043   copies...  3. C
│ │ │ │ -00004cf0: 4f50 5949 4e47 2049 4e20 5155 414e 5449  OPYING IN QUANTI
│ │ │ │ -00004d00: 5459 0a0a 2020 2020 2049 6620 796f 7520  TY..     If you 
│ │ │ │ -00004d10: 7075 626c 6973 6820 7072 696e 7465 6420  publish printed 
│ │ │ │ -00004d20: 636f 7069 6573 2028 6f72 2063 6f70 6965  copies (or copie
│ │ │ │ -00004d30: 7320 696e 206d 6564 6961 2074 6861 7420  s in media that 
│ │ │ │ -00004d40: 636f 6d6d 6f6e 6c79 0a20 2020 2020 6861  commonly.     ha
│ │ │ │ -00004d50: 7665 2070 7269 6e74 6564 2063 6f76 6572  ve printed cover
│ │ │ │ -00004d60: 7329 206f 6620 7468 6520 446f 6375 6d65  s) of the Docume
│ │ │ │ -00004d70: 6e74 2c20 6e75 6d62 6572 696e 6720 6d6f  nt, numbering mo
│ │ │ │ -00004d80: 7265 2074 6861 6e20 3130 302c 2061 6e64  re than 100, and
│ │ │ │ -00004d90: 0a20 2020 2020 7468 6520 446f 6375 6d65  .     the Docume
│ │ │ │ -00004da0: 6e74 2773 206c 6963 656e 7365 206e 6f74  nt's license not
│ │ │ │ -00004db0: 6963 6520 7265 7175 6972 6573 2043 6f76  ice requires Cov
│ │ │ │ -00004dc0: 6572 2054 6578 7473 2c20 796f 7520 6d75  er Texts, you mu
│ │ │ │ -00004dd0: 7374 0a20 2020 2020 656e 636c 6f73 6520  st.     enclose 
│ │ │ │ -00004de0: 7468 6520 636f 7069 6573 2069 6e20 636f  the copies in co
│ │ │ │ -00004df0: 7665 7273 2074 6861 7420 6361 7272 792c  vers that carry,
│ │ │ │ -00004e00: 2063 6c65 6172 6c79 2061 6e64 206c 6567   clearly and leg
│ │ │ │ -00004e10: 6962 6c79 2c20 616c 6c0a 2020 2020 2074  ibly, all.     t
│ │ │ │ -00004e20: 6865 7365 2043 6f76 6572 2054 6578 7473  hese Cover Texts
│ │ │ │ -00004e30: 3a20 4672 6f6e 742d 436f 7665 7220 5465  : Front-Cover Te
│ │ │ │ -00004e40: 7874 7320 6f6e 2074 6865 2066 726f 6e74  xts on the front
│ │ │ │ -00004e50: 2063 6f76 6572 2c20 616e 640a 2020 2020   cover, and.    
│ │ │ │ -00004e60: 2042 6163 6b2d 436f 7665 7220 5465 7874   Back-Cover Text
│ │ │ │ -00004e70: 7320 6f6e 2074 6865 2062 6163 6b20 636f  s on the back co
│ │ │ │ -00004e80: 7665 722e 2020 426f 7468 2063 6f76 6572  ver.  Both cover
│ │ │ │ -00004e90: 7320 6d75 7374 2061 6c73 6f20 636c 6561  s must also clea
│ │ │ │ -00004ea0: 726c 790a 2020 2020 2061 6e64 206c 6567  rly.     and leg
│ │ │ │ -00004eb0: 6962 6c79 2069 6465 6e74 6966 7920 796f  ibly identify yo
│ │ │ │ -00004ec0: 7520 6173 2074 6865 2070 7562 6c69 7368  u as the publish
│ │ │ │ -00004ed0: 6572 206f 6620 7468 6573 6520 636f 7069  er of these copi
│ │ │ │ -00004ee0: 6573 2e20 2054 6865 0a20 2020 2020 6672  es.  The.     fr
│ │ │ │ -00004ef0: 6f6e 7420 636f 7665 7220 6d75 7374 2070  ont cover must p
│ │ │ │ -00004f00: 7265 7365 6e74 2074 6865 2066 756c 6c20  resent the full 
│ │ │ │ -00004f10: 7469 746c 6520 7769 7468 2061 6c6c 2077  title with all w
│ │ │ │ -00004f20: 6f72 6473 206f 6620 7468 6520 7469 746c  ords of the titl
│ │ │ │ -00004f30: 650a 2020 2020 2065 7175 616c 6c79 2070  e.     equally p
│ │ │ │ -00004f40: 726f 6d69 6e65 6e74 2061 6e64 2076 6973  rominent and vis
│ │ │ │ -00004f50: 6962 6c65 2e20 2059 6f75 206d 6179 2061  ible.  You may a
│ │ │ │ -00004f60: 6464 206f 7468 6572 206d 6174 6572 6961  dd other materia
│ │ │ │ -00004f70: 6c20 6f6e 2074 6865 0a20 2020 2020 636f  l on the.     co
│ │ │ │ -00004f80: 7665 7273 2069 6e20 6164 6469 7469 6f6e  vers in addition
│ │ │ │ -00004f90: 2e20 2043 6f70 7969 6e67 2077 6974 6820  .  Copying with 
│ │ │ │ -00004fa0: 6368 616e 6765 7320 6c69 6d69 7465 6420  changes limited 
│ │ │ │ -00004fb0: 746f 2074 6865 2063 6f76 6572 732c 2061  to the covers, a
│ │ │ │ -00004fc0: 730a 2020 2020 206c 6f6e 6720 6173 2074  s.     long as t
│ │ │ │ -00004fd0: 6865 7920 7072 6573 6572 7665 2074 6865  hey preserve the
│ │ │ │ -00004fe0: 2074 6974 6c65 206f 6620 7468 6520 446f   title of the Do
│ │ │ │ -00004ff0: 6375 6d65 6e74 2061 6e64 2073 6174 6973  cument and satis
│ │ │ │ -00005000: 6679 2074 6865 7365 0a20 2020 2020 636f  fy these.     co
│ │ │ │ -00005010: 6e64 6974 696f 6e73 2c20 6361 6e20 6265  nditions, can be
│ │ │ │ -00005020: 2074 7265 6174 6564 2061 7320 7665 7262   treated as verb
│ │ │ │ -00005030: 6174 696d 2063 6f70 7969 6e67 2069 6e20  atim copying in 
│ │ │ │ -00005040: 6f74 6865 7220 7265 7370 6563 7473 2e0a  other respects..
│ │ │ │ -00005050: 0a20 2020 2020 4966 2074 6865 2072 6571  .     If the req
│ │ │ │ -00005060: 7569 7265 6420 7465 7874 7320 666f 7220  uired texts for 
│ │ │ │ -00005070: 6569 7468 6572 2063 6f76 6572 2061 7265  either cover are
│ │ │ │ -00005080: 2074 6f6f 2076 6f6c 756d 696e 6f75 7320   too voluminous 
│ │ │ │ -00005090: 746f 2066 6974 0a20 2020 2020 6c65 6769  to fit.     legi
│ │ │ │ -000050a0: 626c 792c 2079 6f75 2073 686f 756c 6420  bly, you should 
│ │ │ │ -000050b0: 7075 7420 7468 6520 6669 7273 7420 6f6e  put the first on
│ │ │ │ -000050c0: 6573 206c 6973 7465 6420 2861 7320 6d61  es listed (as ma
│ │ │ │ -000050d0: 6e79 2061 7320 6669 740a 2020 2020 2072  ny as fit.     r
│ │ │ │ -000050e0: 6561 736f 6e61 626c 7929 206f 6e20 7468  easonably) on th
│ │ │ │ -000050f0: 6520 6163 7475 616c 2063 6f76 6572 2c20  e actual cover, 
│ │ │ │ -00005100: 616e 6420 636f 6e74 696e 7565 2074 6865  and continue the
│ │ │ │ -00005110: 2072 6573 7420 6f6e 746f 0a20 2020 2020   rest onto.     
│ │ │ │ -00005120: 6164 6a61 6365 6e74 2070 6167 6573 2e0a  adjacent pages..
│ │ │ │ -00005130: 0a20 2020 2020 4966 2079 6f75 2070 7562  .     If you pub
│ │ │ │ -00005140: 6c69 7368 206f 7220 6469 7374 7269 6275  lish or distribu
│ │ │ │ -00005150: 7465 204f 7061 7175 6520 636f 7069 6573  te Opaque copies
│ │ │ │ -00005160: 206f 6620 7468 6520 446f 6375 6d65 6e74   of the Document
│ │ │ │ -00005170: 0a20 2020 2020 6e75 6d62 6572 696e 6720  .     numbering 
│ │ │ │ -00005180: 6d6f 7265 2074 6861 6e20 3130 302c 2079  more than 100, y
│ │ │ │ -00005190: 6f75 206d 7573 7420 6569 7468 6572 2069  ou must either i
│ │ │ │ -000051a0: 6e63 6c75 6465 2061 206d 6163 6869 6e65  nclude a machine
│ │ │ │ -000051b0: 2d72 6561 6461 626c 650a 2020 2020 2054  -readable.     T
│ │ │ │ -000051c0: 7261 6e73 7061 7265 6e74 2063 6f70 7920  ransparent copy 
│ │ │ │ -000051d0: 616c 6f6e 6720 7769 7468 2065 6163 6820  along with each 
│ │ │ │ -000051e0: 4f70 6171 7565 2063 6f70 792c 206f 7220  Opaque copy, or 
│ │ │ │ -000051f0: 7374 6174 6520 696e 206f 7220 7769 7468  state in or with
│ │ │ │ -00005200: 0a20 2020 2020 6561 6368 204f 7061 7175  .     each Opaqu
│ │ │ │ -00005210: 6520 636f 7079 2061 2063 6f6d 7075 7465  e copy a compute
│ │ │ │ -00005220: 722d 6e65 7477 6f72 6b20 6c6f 6361 7469  r-network locati
│ │ │ │ -00005230: 6f6e 2066 726f 6d20 7768 6963 6820 7468  on from which th
│ │ │ │ -00005240: 6520 6765 6e65 7261 6c0a 2020 2020 206e  e general.     n
│ │ │ │ -00005250: 6574 776f 726b 2d75 7369 6e67 2070 7562  etwork-using pub
│ │ │ │ -00005260: 6c69 6320 6861 7320 6163 6365 7373 2074  lic has access t
│ │ │ │ -00005270: 6f20 646f 776e 6c6f 6164 2075 7369 6e67  o download using
│ │ │ │ -00005280: 2070 7562 6c69 632d 7374 616e 6461 7264   public-standard
│ │ │ │ -00005290: 0a20 2020 2020 6e65 7477 6f72 6b20 7072  .     network pr
│ │ │ │ -000052a0: 6f74 6f63 6f6c 7320 6120 636f 6d70 6c65  otocols a comple
│ │ │ │ -000052b0: 7465 2054 7261 6e73 7061 7265 6e74 2063  te Transparent c
│ │ │ │ -000052c0: 6f70 7920 6f66 2074 6865 2044 6f63 756d  opy of the Docum
│ │ │ │ -000052d0: 656e 742c 2066 7265 650a 2020 2020 206f  ent, free.     o
│ │ │ │ -000052e0: 6620 6164 6465 6420 6d61 7465 7269 616c  f added material
│ │ │ │ -000052f0: 2e20 2049 6620 796f 7520 7573 6520 7468  .  If you use th
│ │ │ │ -00005300: 6520 6c61 7474 6572 206f 7074 696f 6e2c  e latter option,
│ │ │ │ -00005310: 2079 6f75 206d 7573 7420 7461 6b65 0a20   you must take. 
│ │ │ │ -00005320: 2020 2020 7265 6173 6f6e 6162 6c79 2070      reasonably p
│ │ │ │ -00005330: 7275 6465 6e74 2073 7465 7073 2c20 7768  rudent steps, wh
│ │ │ │ -00005340: 656e 2079 6f75 2062 6567 696e 2064 6973  en you begin dis
│ │ │ │ -00005350: 7472 6962 7574 696f 6e20 6f66 204f 7061  tribution of Opa
│ │ │ │ -00005360: 7175 650a 2020 2020 2063 6f70 6965 7320  que.     copies 
│ │ │ │ -00005370: 696e 2071 7561 6e74 6974 792c 2074 6f20  in quantity, to 
│ │ │ │ -00005380: 656e 7375 7265 2074 6861 7420 7468 6973  ensure that this
│ │ │ │ -00005390: 2054 7261 6e73 7061 7265 6e74 2063 6f70   Transparent cop
│ │ │ │ -000053a0: 7920 7769 6c6c 0a20 2020 2020 7265 6d61  y will.     rema
│ │ │ │ -000053b0: 696e 2074 6875 7320 6163 6365 7373 6962  in thus accessib
│ │ │ │ -000053c0: 6c65 2061 7420 7468 6520 7374 6174 6564  le at the stated
│ │ │ │ -000053d0: 206c 6f63 6174 696f 6e20 756e 7469 6c20   location until 
│ │ │ │ -000053e0: 6174 206c 6561 7374 206f 6e65 0a20 2020  at least one.   
│ │ │ │ -000053f0: 2020 7965 6172 2061 6674 6572 2074 6865    year after the
│ │ │ │ -00005400: 206c 6173 7420 7469 6d65 2079 6f75 2064   last time you d
│ │ │ │ -00005410: 6973 7472 6962 7574 6520 616e 204f 7061  istribute an Opa
│ │ │ │ -00005420: 7175 6520 636f 7079 2028 6469 7265 6374  que copy (direct
│ │ │ │ -00005430: 6c79 206f 720a 2020 2020 2074 6872 6f75  ly or.     throu
│ │ │ │ -00005440: 6768 2079 6f75 7220 6167 656e 7473 206f  gh your agents o
│ │ │ │ -00005450: 7220 7265 7461 696c 6572 7329 206f 6620  r retailers) of 
│ │ │ │ -00005460: 7468 6174 2065 6469 7469 6f6e 2074 6f20  that edition to 
│ │ │ │ -00005470: 7468 6520 7075 626c 6963 2e0a 0a20 2020  the public...   
│ │ │ │ -00005480: 2020 4974 2069 7320 7265 7175 6573 7465    It is requeste
│ │ │ │ -00005490: 642c 2062 7574 206e 6f74 2072 6571 7569  d, but not requi
│ │ │ │ -000054a0: 7265 642c 2074 6861 7420 796f 7520 636f  red, that you co
│ │ │ │ -000054b0: 6e74 6163 7420 7468 6520 6175 7468 6f72  ntact the author
│ │ │ │ -000054c0: 7320 6f66 0a20 2020 2020 7468 6520 446f  s of.     the Do
│ │ │ │ -000054d0: 6375 6d65 6e74 2077 656c 6c20 6265 666f  cument well befo
│ │ │ │ -000054e0: 7265 2072 6564 6973 7472 6962 7574 696e  re redistributin
│ │ │ │ -000054f0: 6720 616e 7920 6c61 7267 6520 6e75 6d62  g any large numb
│ │ │ │ -00005500: 6572 206f 6620 636f 7069 6573 2c0a 2020  er of copies,.  
│ │ │ │ -00005510: 2020 2074 6f20 6769 7665 2074 6865 6d20     to give them 
│ │ │ │ -00005520: 6120 6368 616e 6365 2074 6f20 7072 6f76  a chance to prov
│ │ │ │ -00005530: 6964 6520 796f 7520 7769 7468 2061 6e20  ide you with an 
│ │ │ │ -00005540: 7570 6461 7465 6420 7665 7273 696f 6e20  updated version 
│ │ │ │ -00005550: 6f66 2074 6865 0a20 2020 2020 446f 6375  of the.     Docu
│ │ │ │ -00005560: 6d65 6e74 2e0a 0a20 2034 2e20 4d4f 4449  ment...  4. MODI
│ │ │ │ -00005570: 4649 4341 5449 4f4e 530a 0a20 2020 2020  FICATIONS..     
│ │ │ │ -00005580: 596f 7520 6d61 7920 636f 7079 2061 6e64  You may copy and
│ │ │ │ -00005590: 2064 6973 7472 6962 7574 6520 6120 4d6f   distribute a Mo
│ │ │ │ -000055a0: 6469 6669 6564 2056 6572 7369 6f6e 206f  dified Version o
│ │ │ │ -000055b0: 6620 7468 6520 446f 6375 6d65 6e74 0a20  f the Document. 
│ │ │ │ -000055c0: 2020 2020 756e 6465 7220 7468 6520 636f      under the co
│ │ │ │ -000055d0: 6e64 6974 696f 6e73 206f 6620 7365 6374  nditions of sect
│ │ │ │ -000055e0: 696f 6e73 2032 2061 6e64 2033 2061 626f  ions 2 and 3 abo
│ │ │ │ -000055f0: 7665 2c20 7072 6f76 6964 6564 2074 6861  ve, provided tha
│ │ │ │ -00005600: 7420 796f 750a 2020 2020 2072 656c 6561  t you.     relea
│ │ │ │ -00005610: 7365 2074 6865 204d 6f64 6966 6965 6420  se the Modified 
│ │ │ │ -00005620: 5665 7273 696f 6e20 756e 6465 7220 7072  Version under pr
│ │ │ │ -00005630: 6563 6973 656c 7920 7468 6973 204c 6963  ecisely this Lic
│ │ │ │ -00005640: 656e 7365 2c20 7769 7468 2074 6865 0a20  ense, with the. 
│ │ │ │ -00005650: 2020 2020 4d6f 6469 6669 6564 2056 6572      Modified Ver
│ │ │ │ -00005660: 7369 6f6e 2066 696c 6c69 6e67 2074 6865  sion filling the
│ │ │ │ -00005670: 2072 6f6c 6520 6f66 2074 6865 2044 6f63   role of the Doc
│ │ │ │ -00005680: 756d 656e 742c 2074 6875 7320 6c69 6365  ument, thus lice
│ │ │ │ -00005690: 6e73 696e 670a 2020 2020 2064 6973 7472  nsing.     distr
│ │ │ │ -000056a0: 6962 7574 696f 6e20 616e 6420 6d6f 6469  ibution and modi
│ │ │ │ -000056b0: 6669 6361 7469 6f6e 206f 6620 7468 6520  fication of the 
│ │ │ │ -000056c0: 4d6f 6469 6669 6564 2056 6572 7369 6f6e  Modified Version
│ │ │ │ -000056d0: 2074 6f20 7768 6f65 7665 720a 2020 2020   to whoever.    
│ │ │ │ -000056e0: 2070 6f73 7365 7373 6573 2061 2063 6f70   possesses a cop
│ │ │ │ -000056f0: 7920 6f66 2069 742e 2020 496e 2061 6464  y of it.  In add
│ │ │ │ -00005700: 6974 696f 6e2c 2079 6f75 206d 7573 7420  ition, you must 
│ │ │ │ -00005710: 646f 2074 6865 7365 2074 6869 6e67 7320  do these things 
│ │ │ │ -00005720: 696e 0a20 2020 2020 7468 6520 4d6f 6469  in.     the Modi
│ │ │ │ -00005730: 6669 6564 2056 6572 7369 6f6e 3a0a 0a20  fied Version:.. 
│ │ │ │ -00005740: 2020 2020 2020 412e 2055 7365 2069 6e20        A. Use in 
│ │ │ │ -00005750: 7468 6520 5469 746c 6520 5061 6765 2028  the Title Page (
│ │ │ │ -00005760: 616e 6420 6f6e 2074 6865 2063 6f76 6572  and on the cover
│ │ │ │ -00005770: 732c 2069 6620 616e 7929 2061 2074 6974  s, if any) a tit
│ │ │ │ -00005780: 6c65 0a20 2020 2020 2020 2020 2064 6973  le.          dis
│ │ │ │ -00005790: 7469 6e63 7420 6672 6f6d 2074 6861 7420  tinct from that 
│ │ │ │ -000057a0: 6f66 2074 6865 2044 6f63 756d 656e 742c  of the Document,
│ │ │ │ -000057b0: 2061 6e64 2066 726f 6d20 7468 6f73 6520   and from those 
│ │ │ │ -000057c0: 6f66 2070 7265 7669 6f75 730a 2020 2020  of previous.    
│ │ │ │ -000057d0: 2020 2020 2020 7665 7273 696f 6e73 2028        versions (
│ │ │ │ -000057e0: 7768 6963 6820 7368 6f75 6c64 2c20 6966  which should, if
│ │ │ │ -000057f0: 2074 6865 7265 2077 6572 6520 616e 792c   there were any,
│ │ │ │ -00005800: 2062 6520 6c69 7374 6564 2069 6e20 7468   be listed in th
│ │ │ │ -00005810: 650a 2020 2020 2020 2020 2020 4869 7374  e.          Hist
│ │ │ │ -00005820: 6f72 7920 7365 6374 696f 6e20 6f66 2074  ory section of t
│ │ │ │ -00005830: 6865 2044 6f63 756d 656e 7429 2e20 2059  he Document).  Y
│ │ │ │ -00005840: 6f75 206d 6179 2075 7365 2074 6865 2073  ou may use the s
│ │ │ │ -00005850: 616d 6520 7469 746c 650a 2020 2020 2020  ame title.      
│ │ │ │ -00005860: 2020 2020 6173 2061 2070 7265 7669 6f75      as a previou
│ │ │ │ -00005870: 7320 7665 7273 696f 6e20 6966 2074 6865  s version if the
│ │ │ │ -00005880: 206f 7269 6769 6e61 6c20 7075 626c 6973   original publis
│ │ │ │ -00005890: 6865 7220 6f66 2074 6861 740a 2020 2020  her of that.    
│ │ │ │ -000058a0: 2020 2020 2020 7665 7273 696f 6e20 6769        version gi
│ │ │ │ -000058b0: 7665 7320 7065 726d 6973 7369 6f6e 2e0a  ves permission..
│ │ │ │ -000058c0: 0a20 2020 2020 2020 422e 204c 6973 7420  .       B. List 
│ │ │ │ -000058d0: 6f6e 2074 6865 2054 6974 6c65 2050 6167  on the Title Pag
│ │ │ │ -000058e0: 652c 2061 7320 6175 7468 6f72 732c 206f  e, as authors, o
│ │ │ │ -000058f0: 6e65 206f 7220 6d6f 7265 2070 6572 736f  ne or more perso
│ │ │ │ -00005900: 6e73 206f 720a 2020 2020 2020 2020 2020  ns or.          
│ │ │ │ -00005910: 656e 7469 7469 6573 2072 6573 706f 6e73  entities respons
│ │ │ │ -00005920: 6962 6c65 2066 6f72 2061 7574 686f 7273  ible for authors
│ │ │ │ -00005930: 6869 7020 6f66 2074 6865 206d 6f64 6966  hip of the modif
│ │ │ │ -00005940: 6963 6174 696f 6e73 2069 6e0a 2020 2020  ications in.    
│ │ │ │ -00005950: 2020 2020 2020 7468 6520 4d6f 6469 6669        the Modifi
│ │ │ │ -00005960: 6564 2056 6572 7369 6f6e 2c20 746f 6765  ed Version, toge
│ │ │ │ -00005970: 7468 6572 2077 6974 6820 6174 206c 6561  ther with at lea
│ │ │ │ -00005980: 7374 2066 6976 6520 6f66 2074 6865 0a20  st five of the. 
│ │ │ │ -00005990: 2020 2020 2020 2020 2070 7269 6e63 6970           princip
│ │ │ │ -000059a0: 616c 2061 7574 686f 7273 206f 6620 7468  al authors of th
│ │ │ │ -000059b0: 6520 446f 6375 6d65 6e74 2028 616c 6c20  e Document (all 
│ │ │ │ -000059c0: 6f66 2069 7473 2070 7269 6e63 6970 616c  of its principal
│ │ │ │ -000059d0: 0a20 2020 2020 2020 2020 2061 7574 686f  .          autho
│ │ │ │ -000059e0: 7273 2c20 6966 2069 7420 6861 7320 6665  rs, if it has fe
│ │ │ │ -000059f0: 7765 7220 7468 616e 2066 6976 6529 2c20  wer than five), 
│ │ │ │ -00005a00: 756e 6c65 7373 2074 6865 7920 7265 6c65  unless they rele
│ │ │ │ -00005a10: 6173 6520 796f 750a 2020 2020 2020 2020  ase you.        
│ │ │ │ -00005a20: 2020 6672 6f6d 2074 6869 7320 7265 7175    from this requ
│ │ │ │ -00005a30: 6972 656d 656e 742e 0a0a 2020 2020 2020  irement...      
│ │ │ │ -00005a40: 2043 2e20 5374 6174 6520 6f6e 2074 6865   C. State on the
│ │ │ │ -00005a50: 2054 6974 6c65 2070 6167 6520 7468 6520   Title page the 
│ │ │ │ -00005a60: 6e61 6d65 206f 6620 7468 6520 7075 626c  name of the publ
│ │ │ │ -00005a70: 6973 6865 7220 6f66 2074 6865 0a20 2020  isher of the.   
│ │ │ │ -00005a80: 2020 2020 2020 204d 6f64 6966 6965 6420         Modified 
│ │ │ │ -00005a90: 5665 7273 696f 6e2c 2061 7320 7468 6520  Version, as the 
│ │ │ │ -00005aa0: 7075 626c 6973 6865 722e 0a0a 2020 2020  publisher...    
│ │ │ │ -00005ab0: 2020 2044 2e20 5072 6573 6572 7665 2061     D. Preserve a
│ │ │ │ -00005ac0: 6c6c 2074 6865 2063 6f70 7972 6967 6874  ll the copyright
│ │ │ │ -00005ad0: 206e 6f74 6963 6573 206f 6620 7468 6520   notices of the 
│ │ │ │ -00005ae0: 446f 6375 6d65 6e74 2e0a 0a20 2020 2020  Document...     
│ │ │ │ -00005af0: 2020 452e 2041 6464 2061 6e20 6170 7072    E. Add an appr
│ │ │ │ -00005b00: 6f70 7269 6174 6520 636f 7079 7269 6768  opriate copyrigh
│ │ │ │ -00005b10: 7420 6e6f 7469 6365 2066 6f72 2079 6f75  t notice for you
│ │ │ │ -00005b20: 7220 6d6f 6469 6669 6361 7469 6f6e 730a  r modifications.
│ │ │ │ -00005b30: 2020 2020 2020 2020 2020 6164 6a61 6365            adjace
│ │ │ │ -00005b40: 6e74 2074 6f20 7468 6520 6f74 6865 7220  nt to the other 
│ │ │ │ -00005b50: 636f 7079 7269 6768 7420 6e6f 7469 6365  copyright notice
│ │ │ │ -00005b60: 732e 0a0a 2020 2020 2020 2046 2e20 496e  s...       F. In
│ │ │ │ -00005b70: 636c 7564 652c 2069 6d6d 6564 6961 7465  clude, immediate
│ │ │ │ -00005b80: 6c79 2061 6674 6572 2074 6865 2063 6f70  ly after the cop
│ │ │ │ -00005b90: 7972 6967 6874 206e 6f74 6963 6573 2c20  yright notices, 
│ │ │ │ -00005ba0: 6120 6c69 6365 6e73 650a 2020 2020 2020  a license.      
│ │ │ │ -00005bb0: 2020 2020 6e6f 7469 6365 2067 6976 696e      notice givin
│ │ │ │ -00005bc0: 6720 7468 6520 7075 626c 6963 2070 6572  g the public per
│ │ │ │ -00005bd0: 6d69 7373 696f 6e20 746f 2075 7365 2074  mission to use t
│ │ │ │ -00005be0: 6865 204d 6f64 6966 6965 640a 2020 2020  he Modified.    
│ │ │ │ -00005bf0: 2020 2020 2020 5665 7273 696f 6e20 756e        Version un
│ │ │ │ -00005c00: 6465 7220 7468 6520 7465 726d 7320 6f66  der the terms of
│ │ │ │ -00005c10: 2074 6869 7320 4c69 6365 6e73 652c 2069   this License, i
│ │ │ │ -00005c20: 6e20 7468 6520 666f 726d 2073 686f 776e  n the form shown
│ │ │ │ -00005c30: 2069 6e0a 2020 2020 2020 2020 2020 7468   in.          th
│ │ │ │ -00005c40: 6520 4164 6465 6e64 756d 2062 656c 6f77  e Addendum below
│ │ │ │ -00005c50: 2e0a 0a20 2020 2020 2020 472e 2050 7265  ...       G. Pre
│ │ │ │ -00005c60: 7365 7276 6520 696e 2074 6861 7420 6c69  serve in that li
│ │ │ │ -00005c70: 6365 6e73 6520 6e6f 7469 6365 2074 6865  cense notice the
│ │ │ │ -00005c80: 2066 756c 6c20 6c69 7374 7320 6f66 2049   full lists of I
│ │ │ │ -00005c90: 6e76 6172 6961 6e74 0a20 2020 2020 2020  nvariant.       
│ │ │ │ -00005ca0: 2020 2053 6563 7469 6f6e 7320 616e 6420     Sections and 
│ │ │ │ -00005cb0: 7265 7175 6972 6564 2043 6f76 6572 2054  required Cover T
│ │ │ │ -00005cc0: 6578 7473 2067 6976 656e 2069 6e20 7468  exts given in th
│ │ │ │ -00005cd0: 6520 446f 6375 6d65 6e74 2773 0a20 2020  e Document's.   
│ │ │ │ -00005ce0: 2020 2020 2020 206c 6963 656e 7365 206e         license n
│ │ │ │ -00005cf0: 6f74 6963 652e 0a0a 2020 2020 2020 2048  otice...       H
│ │ │ │ -00005d00: 2e20 496e 636c 7564 6520 616e 2075 6e61  . Include an una
│ │ │ │ -00005d10: 6c74 6572 6564 2063 6f70 7920 6f66 2074  ltered copy of t
│ │ │ │ -00005d20: 6869 7320 4c69 6365 6e73 652e 0a0a 2020  his License...  
│ │ │ │ -00005d30: 2020 2020 2049 2e20 5072 6573 6572 7665       I. Preserve
│ │ │ │ -00005d40: 2074 6865 2073 6563 7469 6f6e 2045 6e74   the section Ent
│ │ │ │ -00005d50: 6974 6c65 6420 2248 6973 746f 7279 222c  itled "History",
│ │ │ │ -00005d60: 2050 7265 7365 7276 6520 6974 7320 5469   Preserve its Ti
│ │ │ │ -00005d70: 746c 652c 0a20 2020 2020 2020 2020 2061  tle,.          a
│ │ │ │ -00005d80: 6e64 2061 6464 2074 6f20 6974 2061 6e20  nd add to it an 
│ │ │ │ -00005d90: 6974 656d 2073 7461 7469 6e67 2061 7420  item stating at 
│ │ │ │ -00005da0: 6c65 6173 7420 7468 6520 7469 746c 652c  least the title,
│ │ │ │ -00005db0: 2079 6561 722c 206e 6577 0a20 2020 2020   year, new.     
│ │ │ │ -00005dc0: 2020 2020 2061 7574 686f 7273 2c20 616e       authors, an
│ │ │ │ -00005dd0: 6420 7075 626c 6973 6865 7220 6f66 2074  d publisher of t
│ │ │ │ -00005de0: 6865 204d 6f64 6966 6965 6420 5665 7273  he Modified Vers
│ │ │ │ -00005df0: 696f 6e20 6173 2067 6976 656e 206f 6e20  ion as given on 
│ │ │ │ -00005e00: 7468 650a 2020 2020 2020 2020 2020 5469  the.          Ti
│ │ │ │ -00005e10: 746c 6520 5061 6765 2e20 2049 6620 7468  tle Page.  If th
│ │ │ │ -00005e20: 6572 6520 6973 206e 6f20 7365 6374 696f  ere is no sectio
│ │ │ │ -00005e30: 6e20 456e 7469 746c 6564 2022 4869 7374  n Entitled "Hist
│ │ │ │ -00005e40: 6f72 7922 2069 6e20 7468 650a 2020 2020  ory" in the.    
│ │ │ │ -00005e50: 2020 2020 2020 446f 6375 6d65 6e74 2c20        Document, 
│ │ │ │ -00005e60: 6372 6561 7465 206f 6e65 2073 7461 7469  create one stati
│ │ │ │ -00005e70: 6e67 2074 6865 2074 6974 6c65 2c20 7965  ng the title, ye
│ │ │ │ -00005e80: 6172 2c20 6175 7468 6f72 732c 2061 6e64  ar, authors, and
│ │ │ │ -00005e90: 0a20 2020 2020 2020 2020 2070 7562 6c69  .          publi
│ │ │ │ -00005ea0: 7368 6572 206f 6620 7468 6520 446f 6375  sher of the Docu
│ │ │ │ -00005eb0: 6d65 6e74 2061 7320 6769 7665 6e20 6f6e  ment as given on
│ │ │ │ -00005ec0: 2069 7473 2054 6974 6c65 2050 6167 652c   its Title Page,
│ │ │ │ -00005ed0: 2074 6865 6e20 6164 640a 2020 2020 2020   then add.      
│ │ │ │ -00005ee0: 2020 2020 616e 2069 7465 6d20 6465 7363      an item desc
│ │ │ │ -00005ef0: 7269 6269 6e67 2074 6865 204d 6f64 6966  ribing the Modif
│ │ │ │ -00005f00: 6965 6420 5665 7273 696f 6e20 6173 2073  ied Version as s
│ │ │ │ -00005f10: 7461 7465 6420 696e 2074 6865 0a20 2020  tated in the.   
│ │ │ │ -00005f20: 2020 2020 2020 2070 7265 7669 6f75 7320         previous 
│ │ │ │ -00005f30: 7365 6e74 656e 6365 2e0a 0a20 2020 2020  sentence...     
│ │ │ │ -00005f40: 2020 4a2e 2050 7265 7365 7276 6520 7468    J. Preserve th
│ │ │ │ -00005f50: 6520 6e65 7477 6f72 6b20 6c6f 6361 7469  e network locati
│ │ │ │ -00005f60: 6f6e 2c20 6966 2061 6e79 2c20 6769 7665  on, if any, give
│ │ │ │ -00005f70: 6e20 696e 2074 6865 2044 6f63 756d 656e  n in the Documen
│ │ │ │ -00005f80: 740a 2020 2020 2020 2020 2020 666f 7220  t.          for 
│ │ │ │ -00005f90: 7075 626c 6963 2061 6363 6573 7320 746f  public access to
│ │ │ │ -00005fa0: 2061 2054 7261 6e73 7061 7265 6e74 2063   a Transparent c
│ │ │ │ -00005fb0: 6f70 7920 6f66 2074 6865 2044 6f63 756d  opy of the Docum
│ │ │ │ -00005fc0: 656e 742c 2061 6e64 0a20 2020 2020 2020  ent, and.       
│ │ │ │ -00005fd0: 2020 206c 696b 6577 6973 6520 7468 6520     likewise the 
│ │ │ │ -00005fe0: 6e65 7477 6f72 6b20 6c6f 6361 7469 6f6e  network location
│ │ │ │ -00005ff0: 7320 6769 7665 6e20 696e 2074 6865 2044  s given in the D
│ │ │ │ -00006000: 6f63 756d 656e 7420 666f 720a 2020 2020  ocument for.    
│ │ │ │ -00006010: 2020 2020 2020 7072 6576 696f 7573 2076        previous v
│ │ │ │ -00006020: 6572 7369 6f6e 7320 6974 2077 6173 2062  ersions it was b
│ │ │ │ -00006030: 6173 6564 206f 6e2e 2020 5468 6573 6520  ased on.  These 
│ │ │ │ -00006040: 6d61 7920 6265 2070 6c61 6365 6420 696e  may be placed in
│ │ │ │ -00006050: 2074 6865 0a20 2020 2020 2020 2020 2022   the.          "
│ │ │ │ -00006060: 4869 7374 6f72 7922 2073 6563 7469 6f6e  History" section
│ │ │ │ -00006070: 2e20 2059 6f75 206d 6179 206f 6d69 7420  .  You may omit 
│ │ │ │ -00006080: 6120 6e65 7477 6f72 6b20 6c6f 6361 7469  a network locati
│ │ │ │ -00006090: 6f6e 2066 6f72 2061 2077 6f72 6b0a 2020  on for a work.  
│ │ │ │ -000060a0: 2020 2020 2020 2020 7468 6174 2077 6173          that was
│ │ │ │ -000060b0: 2070 7562 6c69 7368 6564 2061 7420 6c65   published at le
│ │ │ │ -000060c0: 6173 7420 666f 7572 2079 6561 7273 2062  ast four years b
│ │ │ │ -000060d0: 6566 6f72 6520 7468 6520 446f 6375 6d65  efore the Docume
│ │ │ │ -000060e0: 6e74 0a20 2020 2020 2020 2020 2069 7473  nt.          its
│ │ │ │ -000060f0: 656c 662c 206f 7220 6966 2074 6865 206f  elf, or if the o
│ │ │ │ -00006100: 7269 6769 6e61 6c20 7075 626c 6973 6865  riginal publishe
│ │ │ │ -00006110: 7220 6f66 2074 6865 2076 6572 7369 6f6e  r of the version
│ │ │ │ -00006120: 2069 7420 7265 6665 7273 0a20 2020 2020   it refers.     
│ │ │ │ -00006130: 2020 2020 2074 6f20 6769 7665 7320 7065       to gives pe
│ │ │ │ -00006140: 726d 6973 7369 6f6e 2e0a 0a20 2020 2020  rmission...     
│ │ │ │ -00006150: 2020 4b2e 2046 6f72 2061 6e79 2073 6563    K. For any sec
│ │ │ │ -00006160: 7469 6f6e 2045 6e74 6974 6c65 6420 2241  tion Entitled "A
│ │ │ │ -00006170: 636b 6e6f 776c 6564 6765 6d65 6e74 7322  cknowledgements"
│ │ │ │ -00006180: 206f 7220 2244 6564 6963 6174 696f 6e73   or "Dedications
│ │ │ │ -00006190: 222c 0a20 2020 2020 2020 2020 2050 7265  ",.          Pre
│ │ │ │ -000061a0: 7365 7276 6520 7468 6520 5469 746c 6520  serve the Title 
│ │ │ │ -000061b0: 6f66 2074 6865 2073 6563 7469 6f6e 2c20  of the section, 
│ │ │ │ -000061c0: 616e 6420 7072 6573 6572 7665 2069 6e20  and preserve in 
│ │ │ │ -000061d0: 7468 6520 7365 6374 696f 6e0a 2020 2020  the section.    
│ │ │ │ -000061e0: 2020 2020 2020 616c 6c20 7468 6520 7375        all the su
│ │ │ │ -000061f0: 6273 7461 6e63 6520 616e 6420 746f 6e65  bstance and tone
│ │ │ │ -00006200: 206f 6620 6561 6368 206f 6620 7468 6520   of each of the 
│ │ │ │ -00006210: 636f 6e74 7269 6275 746f 720a 2020 2020  contributor.    
│ │ │ │ -00006220: 2020 2020 2020 6163 6b6e 6f77 6c65 6467        acknowledg
│ │ │ │ -00006230: 656d 656e 7473 2061 6e64 2f6f 7220 6465  ements and/or de
│ │ │ │ -00006240: 6469 6361 7469 6f6e 7320 6769 7665 6e20  dications given 
│ │ │ │ -00006250: 7468 6572 6569 6e2e 0a0a 2020 2020 2020  therein...      
│ │ │ │ -00006260: 204c 2e20 5072 6573 6572 7665 2061 6c6c   L. Preserve all
│ │ │ │ -00006270: 2074 6865 2049 6e76 6172 6961 6e74 2053   the Invariant S
│ │ │ │ -00006280: 6563 7469 6f6e 7320 6f66 2074 6865 2044  ections of the D
│ │ │ │ -00006290: 6f63 756d 656e 742c 2075 6e61 6c74 6572  ocument, unalter
│ │ │ │ -000062a0: 6564 0a20 2020 2020 2020 2020 2069 6e20  ed.          in 
│ │ │ │ -000062b0: 7468 6569 7220 7465 7874 2061 6e64 2069  their text and i
│ │ │ │ -000062c0: 6e20 7468 6569 7220 7469 746c 6573 2e20  n their titles. 
│ │ │ │ -000062d0: 2053 6563 7469 6f6e 206e 756d 6265 7273   Section numbers
│ │ │ │ -000062e0: 206f 7220 7468 650a 2020 2020 2020 2020   or the.        
│ │ │ │ -000062f0: 2020 6571 7569 7661 6c65 6e74 2061 7265    equivalent are
│ │ │ │ -00006300: 206e 6f74 2063 6f6e 7369 6465 7265 6420   not considered 
│ │ │ │ -00006310: 7061 7274 206f 6620 7468 6520 7365 6374  part of the sect
│ │ │ │ -00006320: 696f 6e20 7469 746c 6573 2e0a 0a20 2020  ion titles...   
│ │ │ │ -00006330: 2020 2020 4d2e 2044 656c 6574 6520 616e      M. Delete an
│ │ │ │ -00006340: 7920 7365 6374 696f 6e20 456e 7469 746c  y section Entitl
│ │ │ │ -00006350: 6564 2022 456e 646f 7273 656d 656e 7473  ed "Endorsements
│ │ │ │ -00006360: 222e 2020 5375 6368 2061 2073 6563 7469  ".  Such a secti
│ │ │ │ -00006370: 6f6e 0a20 2020 2020 2020 2020 206d 6179  on.          may
│ │ │ │ -00006380: 206e 6f74 2062 6520 696e 636c 7564 6564   not be included
│ │ │ │ -00006390: 2069 6e20 7468 6520 4d6f 6469 6669 6564   in the Modified
│ │ │ │ -000063a0: 2056 6572 7369 6f6e 2e0a 0a20 2020 2020   Version...     
│ │ │ │ -000063b0: 2020 4e2e 2044 6f20 6e6f 7420 7265 7469    N. Do not reti
│ │ │ │ -000063c0: 746c 6520 616e 7920 6578 6973 7469 6e67  tle any existing
│ │ │ │ -000063d0: 2073 6563 7469 6f6e 2074 6f20 6265 2045   section to be E
│ │ │ │ -000063e0: 6e74 6974 6c65 640a 2020 2020 2020 2020  ntitled.        
│ │ │ │ -000063f0: 2020 2245 6e64 6f72 7365 6d65 6e74 7322    "Endorsements"
│ │ │ │ -00006400: 206f 7220 746f 2063 6f6e 666c 6963 7420   or to conflict 
│ │ │ │ -00006410: 696e 2074 6974 6c65 2077 6974 6820 616e  in title with an
│ │ │ │ -00006420: 7920 496e 7661 7269 616e 740a 2020 2020  y Invariant.    
│ │ │ │ -00006430: 2020 2020 2020 5365 6374 696f 6e2e 0a0a        Section...
│ │ │ │ -00006440: 2020 2020 2020 204f 2e20 5072 6573 6572         O. Preser
│ │ │ │ -00006450: 7665 2061 6e79 2057 6172 7261 6e74 7920  ve any Warranty 
│ │ │ │ -00006460: 4469 7363 6c61 696d 6572 732e 0a0a 2020  Disclaimers...  
│ │ │ │ -00006470: 2020 2049 6620 7468 6520 4d6f 6469 6669     If the Modifi
│ │ │ │ -00006480: 6564 2056 6572 7369 6f6e 2069 6e63 6c75  ed Version inclu
│ │ │ │ -00006490: 6465 7320 6e65 7720 6672 6f6e 742d 6d61  des new front-ma
│ │ │ │ -000064a0: 7474 6572 2073 6563 7469 6f6e 7320 6f72  tter sections or
│ │ │ │ -000064b0: 0a20 2020 2020 6170 7065 6e64 6963 6573  .     appendices
│ │ │ │ -000064c0: 2074 6861 7420 7175 616c 6966 7920 6173   that qualify as
│ │ │ │ -000064d0: 2053 6563 6f6e 6461 7279 2053 6563 7469   Secondary Secti
│ │ │ │ -000064e0: 6f6e 7320 616e 6420 636f 6e74 6169 6e20  ons and contain 
│ │ │ │ -000064f0: 6e6f 0a20 2020 2020 6d61 7465 7269 616c  no.     material
│ │ │ │ -00006500: 2063 6f70 6965 6420 6672 6f6d 2074 6865   copied from the
│ │ │ │ -00006510: 2044 6f63 756d 656e 742c 2079 6f75 206d   Document, you m
│ │ │ │ -00006520: 6179 2061 7420 796f 7572 206f 7074 696f  ay at your optio
│ │ │ │ -00006530: 6e20 6465 7369 676e 6174 650a 2020 2020  n designate.    
│ │ │ │ -00006540: 2073 6f6d 6520 6f72 2061 6c6c 206f 6620   some or all of 
│ │ │ │ -00006550: 7468 6573 6520 7365 6374 696f 6e73 2061  these sections a
│ │ │ │ -00006560: 7320 696e 7661 7269 616e 742e 2020 546f  s invariant.  To
│ │ │ │ -00006570: 2064 6f20 7468 6973 2c20 6164 6420 7468   do this, add th
│ │ │ │ -00006580: 6569 720a 2020 2020 2074 6974 6c65 7320  eir.     titles 
│ │ │ │ -00006590: 746f 2074 6865 206c 6973 7420 6f66 2049  to the list of I
│ │ │ │ -000065a0: 6e76 6172 6961 6e74 2053 6563 7469 6f6e  nvariant Section
│ │ │ │ -000065b0: 7320 696e 2074 6865 204d 6f64 6966 6965  s in the Modifie
│ │ │ │ -000065c0: 6420 5665 7273 696f 6e27 730a 2020 2020  d Version's.    
│ │ │ │ -000065d0: 206c 6963 656e 7365 206e 6f74 6963 652e   license notice.
│ │ │ │ -000065e0: 2020 5468 6573 6520 7469 746c 6573 206d    These titles m
│ │ │ │ -000065f0: 7573 7420 6265 2064 6973 7469 6e63 7420  ust be distinct 
│ │ │ │ -00006600: 6672 6f6d 2061 6e79 206f 7468 6572 0a20  from any other. 
│ │ │ │ -00006610: 2020 2020 7365 6374 696f 6e20 7469 746c      section titl
│ │ │ │ -00006620: 6573 2e0a 0a20 2020 2020 596f 7520 6d61  es...     You ma
│ │ │ │ -00006630: 7920 6164 6420 6120 7365 6374 696f 6e20  y add a section 
│ │ │ │ -00006640: 456e 7469 746c 6564 2022 456e 646f 7273  Entitled "Endors
│ │ │ │ -00006650: 656d 656e 7473 222c 2070 726f 7669 6465  ements", provide
│ │ │ │ -00006660: 6420 6974 2063 6f6e 7461 696e 730a 2020  d it contains.  
│ │ │ │ -00006670: 2020 206e 6f74 6869 6e67 2062 7574 2065     nothing but e
│ │ │ │ -00006680: 6e64 6f72 7365 6d65 6e74 7320 6f66 2079  ndorsements of y
│ │ │ │ -00006690: 6f75 7220 4d6f 6469 6669 6564 2056 6572  our Modified Ver
│ │ │ │ -000066a0: 7369 6f6e 2062 7920 7661 7269 6f75 730a  sion by various.
│ │ │ │ -000066b0: 2020 2020 2070 6172 7469 6573 2d2d 666f       parties--fo
│ │ │ │ -000066c0: 7220 6578 616d 706c 652c 2073 7461 7465  r example, state
│ │ │ │ -000066d0: 6d65 6e74 7320 6f66 2070 6565 7220 7265  ments of peer re
│ │ │ │ -000066e0: 7669 6577 206f 7220 7468 6174 2074 6865  view or that the
│ │ │ │ -000066f0: 2074 6578 740a 2020 2020 2068 6173 2062   text.     has b
│ │ │ │ -00006700: 6565 6e20 6170 7072 6f76 6564 2062 7920  een approved by 
│ │ │ │ -00006710: 616e 206f 7267 616e 697a 6174 696f 6e20  an organization 
│ │ │ │ -00006720: 6173 2074 6865 2061 7574 686f 7269 7461  as the authorita
│ │ │ │ -00006730: 7469 7665 0a20 2020 2020 6465 6669 6e69  tive.     defini
│ │ │ │ -00006740: 7469 6f6e 206f 6620 6120 7374 616e 6461  tion of a standa
│ │ │ │ -00006750: 7264 2e0a 0a20 2020 2020 596f 7520 6d61  rd...     You ma
│ │ │ │ -00006760: 7920 6164 6420 6120 7061 7373 6167 6520  y add a passage 
│ │ │ │ -00006770: 6f66 2075 7020 746f 2066 6976 6520 776f  of up to five wo
│ │ │ │ -00006780: 7264 7320 6173 2061 2046 726f 6e74 2d43  rds as a Front-C
│ │ │ │ -00006790: 6f76 6572 2054 6578 742c 0a20 2020 2020  over Text,.     
│ │ │ │ -000067a0: 616e 6420 6120 7061 7373 6167 6520 6f66  and a passage of
│ │ │ │ -000067b0: 2075 7020 746f 2032 3520 776f 7264 7320   up to 25 words 
│ │ │ │ -000067c0: 6173 2061 2042 6163 6b2d 436f 7665 7220  as a Back-Cover 
│ │ │ │ -000067d0: 5465 7874 2c20 746f 2074 6865 2065 6e64  Text, to the end
│ │ │ │ -000067e0: 206f 660a 2020 2020 2074 6865 206c 6973   of.     the lis
│ │ │ │ -000067f0: 7420 6f66 2043 6f76 6572 2054 6578 7473  t of Cover Texts
│ │ │ │ -00006800: 2069 6e20 7468 6520 4d6f 6469 6669 6564   in the Modified
│ │ │ │ -00006810: 2056 6572 7369 6f6e 2e20 204f 6e6c 7920   Version.  Only 
│ │ │ │ -00006820: 6f6e 6520 7061 7373 6167 650a 2020 2020  one passage.    
│ │ │ │ -00006830: 206f 6620 4672 6f6e 742d 436f 7665 7220   of Front-Cover 
│ │ │ │ -00006840: 5465 7874 2061 6e64 206f 6e65 206f 6620  Text and one of 
│ │ │ │ -00006850: 4261 636b 2d43 6f76 6572 2054 6578 7420  Back-Cover Text 
│ │ │ │ -00006860: 6d61 7920 6265 2061 6464 6564 2062 7920  may be added by 
│ │ │ │ -00006870: 286f 720a 2020 2020 2074 6872 6f75 6768  (or.     through
│ │ │ │ -00006880: 2061 7272 616e 6765 6d65 6e74 7320 6d61   arrangements ma
│ │ │ │ -00006890: 6465 2062 7929 2061 6e79 206f 6e65 2065  de by) any one e
│ │ │ │ -000068a0: 6e74 6974 792e 2020 4966 2074 6865 2044  ntity.  If the D
│ │ │ │ -000068b0: 6f63 756d 656e 740a 2020 2020 2061 6c72  ocument.     alr
│ │ │ │ -000068c0: 6561 6479 2069 6e63 6c75 6465 7320 6120  eady includes a 
│ │ │ │ -000068d0: 636f 7665 7220 7465 7874 2066 6f72 2074  cover text for t
│ │ │ │ -000068e0: 6865 2073 616d 6520 636f 7665 722c 2070  he same cover, p
│ │ │ │ -000068f0: 7265 7669 6f75 736c 7920 6164 6465 640a  reviously added.
│ │ │ │ -00006900: 2020 2020 2062 7920 796f 7520 6f72 2062       by you or b
│ │ │ │ -00006910: 7920 6172 7261 6e67 656d 656e 7420 6d61  y arrangement ma
│ │ │ │ -00006920: 6465 2062 7920 7468 6520 7361 6d65 2065  de by the same e
│ │ │ │ -00006930: 6e74 6974 7920 796f 7520 6172 6520 6163  ntity you are ac
│ │ │ │ -00006940: 7469 6e67 206f 6e0a 2020 2020 2062 6568  ting on.     beh
│ │ │ │ -00006950: 616c 6620 6f66 2c20 796f 7520 6d61 7920  alf of, you may 
│ │ │ │ -00006960: 6e6f 7420 6164 6420 616e 6f74 6865 723b  not add another;
│ │ │ │ -00006970: 2062 7574 2079 6f75 206d 6179 2072 6570   but you may rep
│ │ │ │ -00006980: 6c61 6365 2074 6865 206f 6c64 0a20 2020  lace the old.   
│ │ │ │ -00006990: 2020 6f6e 652c 206f 6e20 6578 706c 6963    one, on explic
│ │ │ │ -000069a0: 6974 2070 6572 6d69 7373 696f 6e20 6672  it permission fr
│ │ │ │ -000069b0: 6f6d 2074 6865 2070 7265 7669 6f75 7320  om the previous 
│ │ │ │ -000069c0: 7075 626c 6973 6865 7220 7468 6174 2061  publisher that a
│ │ │ │ -000069d0: 6464 6564 0a20 2020 2020 7468 6520 6f6c  dded.     the ol
│ │ │ │ -000069e0: 6420 6f6e 652e 0a0a 2020 2020 2054 6865  d one...     The
│ │ │ │ -000069f0: 2061 7574 686f 7228 7329 2061 6e64 2070   author(s) and p
│ │ │ │ -00006a00: 7562 6c69 7368 6572 2873 2920 6f66 2074  ublisher(s) of t
│ │ │ │ -00006a10: 6865 2044 6f63 756d 656e 7420 646f 206e  he Document do n
│ │ │ │ -00006a20: 6f74 2062 7920 7468 6973 0a20 2020 2020  ot by this.     
│ │ │ │ -00006a30: 4c69 6365 6e73 6520 6769 7665 2070 6572  License give per
│ │ │ │ -00006a40: 6d69 7373 696f 6e20 746f 2075 7365 2074  mission to use t
│ │ │ │ -00006a50: 6865 6972 206e 616d 6573 2066 6f72 2070  heir names for p
│ │ │ │ -00006a60: 7562 6c69 6369 7479 2066 6f72 206f 7220  ublicity for or 
│ │ │ │ -00006a70: 746f 0a20 2020 2020 6173 7365 7274 206f  to.     assert o
│ │ │ │ -00006a80: 7220 696d 706c 7920 656e 646f 7273 656d  r imply endorsem
│ │ │ │ -00006a90: 656e 7420 6f66 2061 6e79 204d 6f64 6966  ent of any Modif
│ │ │ │ -00006aa0: 6965 6420 5665 7273 696f 6e2e 0a0a 2020  ied Version...  
│ │ │ │ -00006ab0: 352e 2043 4f4d 4249 4e49 4e47 2044 4f43  5. COMBINING DOC
│ │ │ │ -00006ac0: 554d 454e 5453 0a0a 2020 2020 2059 6f75  UMENTS..     You
│ │ │ │ -00006ad0: 206d 6179 2063 6f6d 6269 6e65 2074 6865   may combine the
│ │ │ │ -00006ae0: 2044 6f63 756d 656e 7420 7769 7468 206f   Document with o
│ │ │ │ -00006af0: 7468 6572 2064 6f63 756d 656e 7473 2072  ther documents r
│ │ │ │ -00006b00: 656c 6561 7365 6420 756e 6465 720a 2020  eleased under.  
│ │ │ │ -00006b10: 2020 2074 6869 7320 4c69 6365 6e73 652c     this License,
│ │ │ │ -00006b20: 2075 6e64 6572 2074 6865 2074 6572 6d73   under the terms
│ │ │ │ -00006b30: 2064 6566 696e 6564 2069 6e20 7365 6374   defined in sect
│ │ │ │ -00006b40: 696f 6e20 3420 6162 6f76 6520 666f 720a  ion 4 above for.
│ │ │ │ -00006b50: 2020 2020 206d 6f64 6966 6965 6420 7665       modified ve
│ │ │ │ -00006b60: 7273 696f 6e73 2c20 7072 6f76 6964 6564  rsions, provided
│ │ │ │ -00006b70: 2074 6861 7420 796f 7520 696e 636c 7564   that you includ
│ │ │ │ -00006b80: 6520 696e 2074 6865 2063 6f6d 6269 6e61  e in the combina
│ │ │ │ -00006b90: 7469 6f6e 2061 6c6c 0a20 2020 2020 6f66  tion all.     of
│ │ │ │ -00006ba0: 2074 6865 2049 6e76 6172 6961 6e74 2053   the Invariant S
│ │ │ │ -00006bb0: 6563 7469 6f6e 7320 6f66 2061 6c6c 206f  ections of all o
│ │ │ │ -00006bc0: 6620 7468 6520 6f72 6967 696e 616c 2064  f the original d
│ │ │ │ -00006bd0: 6f63 756d 656e 7473 2c0a 2020 2020 2075  ocuments,.     u
│ │ │ │ -00006be0: 6e6d 6f64 6966 6965 642c 2061 6e64 206c  nmodified, and l
│ │ │ │ -00006bf0: 6973 7420 7468 656d 2061 6c6c 2061 7320  ist them all as 
│ │ │ │ -00006c00: 496e 7661 7269 616e 7420 5365 6374 696f  Invariant Sectio
│ │ │ │ -00006c10: 6e73 206f 6620 796f 7572 0a20 2020 2020  ns of your.     
│ │ │ │ -00006c20: 636f 6d62 696e 6564 2077 6f72 6b20 696e  combined work in
│ │ │ │ -00006c30: 2069 7473 206c 6963 656e 7365 206e 6f74   its license not
│ │ │ │ -00006c40: 6963 652c 2061 6e64 2074 6861 7420 796f  ice, and that yo
│ │ │ │ -00006c50: 7520 7072 6573 6572 7665 2061 6c6c 0a20  u preserve all. 
│ │ │ │ -00006c60: 2020 2020 7468 6569 7220 5761 7272 616e      their Warran
│ │ │ │ -00006c70: 7479 2044 6973 636c 6169 6d65 7273 2e0a  ty Disclaimers..
│ │ │ │ -00006c80: 0a20 2020 2020 5468 6520 636f 6d62 696e  .     The combin
│ │ │ │ -00006c90: 6564 2077 6f72 6b20 6e65 6564 206f 6e6c  ed work need onl
│ │ │ │ -00006ca0: 7920 636f 6e74 6169 6e20 6f6e 6520 636f  y contain one co
│ │ │ │ -00006cb0: 7079 206f 6620 7468 6973 204c 6963 656e  py of this Licen
│ │ │ │ -00006cc0: 7365 2c20 616e 640a 2020 2020 206d 756c  se, and.     mul
│ │ │ │ -00006cd0: 7469 706c 6520 6964 656e 7469 6361 6c20  tiple identical 
│ │ │ │ -00006ce0: 496e 7661 7269 616e 7420 5365 6374 696f  Invariant Sectio
│ │ │ │ -00006cf0: 6e73 206d 6179 2062 6520 7265 706c 6163  ns may be replac
│ │ │ │ -00006d00: 6564 2077 6974 6820 6120 7369 6e67 6c65  ed with a single
│ │ │ │ -00006d10: 0a20 2020 2020 636f 7079 2e20 2049 6620  .     copy.  If 
│ │ │ │ -00006d20: 7468 6572 6520 6172 6520 6d75 6c74 6970  there are multip
│ │ │ │ -00006d30: 6c65 2049 6e76 6172 6961 6e74 2053 6563  le Invariant Sec
│ │ │ │ -00006d40: 7469 6f6e 7320 7769 7468 2074 6865 2073  tions with the s
│ │ │ │ -00006d50: 616d 6520 6e61 6d65 0a20 2020 2020 6275  ame name.     bu
│ │ │ │ -00006d60: 7420 6469 6666 6572 656e 7420 636f 6e74  t different cont
│ │ │ │ -00006d70: 656e 7473 2c20 6d61 6b65 2074 6865 2074  ents, make the t
│ │ │ │ -00006d80: 6974 6c65 206f 6620 6561 6368 2073 7563  itle of each suc
│ │ │ │ -00006d90: 6820 7365 6374 696f 6e20 756e 6971 7565  h section unique
│ │ │ │ -00006da0: 0a20 2020 2020 6279 2061 6464 696e 6720  .     by adding 
│ │ │ │ -00006db0: 6174 2074 6865 2065 6e64 206f 6620 6974  at the end of it
│ │ │ │ -00006dc0: 2c20 696e 2070 6172 656e 7468 6573 6573  , in parentheses
│ │ │ │ -00006dd0: 2c20 7468 6520 6e61 6d65 206f 6620 7468  , the name of th
│ │ │ │ -00006de0: 650a 2020 2020 206f 7269 6769 6e61 6c20  e.     original 
│ │ │ │ -00006df0: 6175 7468 6f72 206f 7220 7075 626c 6973  author or publis
│ │ │ │ -00006e00: 6865 7220 6f66 2074 6861 7420 7365 6374  her of that sect
│ │ │ │ -00006e10: 696f 6e20 6966 206b 6e6f 776e 2c20 6f72  ion if known, or
│ │ │ │ -00006e20: 2065 6c73 6520 610a 2020 2020 2075 6e69   else a.     uni
│ │ │ │ -00006e30: 7175 6520 6e75 6d62 6572 2e20 204d 616b  que number.  Mak
│ │ │ │ -00006e40: 6520 7468 6520 7361 6d65 2061 646a 7573  e the same adjus
│ │ │ │ -00006e50: 746d 656e 7420 746f 2074 6865 2073 6563  tment to the sec
│ │ │ │ -00006e60: 7469 6f6e 2074 6974 6c65 7320 696e 0a20  tion titles in. 
│ │ │ │ -00006e70: 2020 2020 7468 6520 6c69 7374 206f 6620      the list of 
│ │ │ │ -00006e80: 496e 7661 7269 616e 7420 5365 6374 696f  Invariant Sectio
│ │ │ │ -00006e90: 6e73 2069 6e20 7468 6520 6c69 6365 6e73  ns in the licens
│ │ │ │ -00006ea0: 6520 6e6f 7469 6365 206f 6620 7468 650a  e notice of the.
│ │ │ │ -00006eb0: 2020 2020 2063 6f6d 6269 6e65 6420 776f       combined wo
│ │ │ │ -00006ec0: 726b 2e0a 0a20 2020 2020 496e 2074 6865  rk...     In the
│ │ │ │ -00006ed0: 2063 6f6d 6269 6e61 7469 6f6e 2c20 796f   combination, yo
│ │ │ │ -00006ee0: 7520 6d75 7374 2063 6f6d 6269 6e65 2061  u must combine a
│ │ │ │ -00006ef0: 6e79 2073 6563 7469 6f6e 7320 456e 7469  ny sections Enti
│ │ │ │ -00006f00: 746c 6564 0a20 2020 2020 2248 6973 746f  tled.     "Histo
│ │ │ │ -00006f10: 7279 2220 696e 2074 6865 2076 6172 696f  ry" in the vario
│ │ │ │ -00006f20: 7573 206f 7269 6769 6e61 6c20 646f 6375  us original docu
│ │ │ │ -00006f30: 6d65 6e74 732c 2066 6f72 6d69 6e67 206f  ments, forming o
│ │ │ │ -00006f40: 6e65 2073 6563 7469 6f6e 0a20 2020 2020  ne section.     
│ │ │ │ -00006f50: 456e 7469 746c 6564 2022 4869 7374 6f72  Entitled "Histor
│ │ │ │ -00006f60: 7922 3b20 6c69 6b65 7769 7365 2063 6f6d  y"; likewise com
│ │ │ │ -00006f70: 6269 6e65 2061 6e79 2073 6563 7469 6f6e  bine any section
│ │ │ │ -00006f80: 7320 456e 7469 746c 6564 0a20 2020 2020  s Entitled.     
│ │ │ │ -00006f90: 2241 636b 6e6f 776c 6564 6765 6d65 6e74  "Acknowledgement
│ │ │ │ -00006fa0: 7322 2c20 616e 6420 616e 7920 7365 6374  s", and any sect
│ │ │ │ -00006fb0: 696f 6e73 2045 6e74 6974 6c65 6420 2244  ions Entitled "D
│ │ │ │ -00006fc0: 6564 6963 6174 696f 6e73 222e 2020 596f  edications".  Yo
│ │ │ │ -00006fd0: 750a 2020 2020 206d 7573 7420 6465 6c65  u.     must dele
│ │ │ │ -00006fe0: 7465 2061 6c6c 2073 6563 7469 6f6e 7320  te all sections 
│ │ │ │ -00006ff0: 456e 7469 746c 6564 2022 456e 646f 7273  Entitled "Endors
│ │ │ │ -00007000: 656d 656e 7473 2e22 0a0a 2020 362e 2043  ements."..  6. C
│ │ │ │ -00007010: 4f4c 4c45 4354 494f 4e53 204f 4620 444f  OLLECTIONS OF DO
│ │ │ │ -00007020: 4355 4d45 4e54 530a 0a20 2020 2020 596f  CUMENTS..     Yo
│ │ │ │ -00007030: 7520 6d61 7920 6d61 6b65 2061 2063 6f6c  u may make a col
│ │ │ │ -00007040: 6c65 6374 696f 6e20 636f 6e73 6973 7469  lection consisti
│ │ │ │ -00007050: 6e67 206f 6620 7468 6520 446f 6375 6d65  ng of the Docume
│ │ │ │ -00007060: 6e74 2061 6e64 206f 7468 6572 0a20 2020  nt and other.   
│ │ │ │ -00007070: 2020 646f 6375 6d65 6e74 7320 7265 6c65    documents rele
│ │ │ │ -00007080: 6173 6564 2075 6e64 6572 2074 6869 7320  ased under this 
│ │ │ │ -00007090: 4c69 6365 6e73 652c 2061 6e64 2072 6570  License, and rep
│ │ │ │ -000070a0: 6c61 6365 2074 6865 2069 6e64 6976 6964  lace the individ
│ │ │ │ -000070b0: 7561 6c0a 2020 2020 2063 6f70 6965 7320  ual.     copies 
│ │ │ │ -000070c0: 6f66 2074 6869 7320 4c69 6365 6e73 6520  of this License 
│ │ │ │ -000070d0: 696e 2074 6865 2076 6172 696f 7573 2064  in the various d
│ │ │ │ -000070e0: 6f63 756d 656e 7473 2077 6974 6820 6120  ocuments with a 
│ │ │ │ -000070f0: 7369 6e67 6c65 2063 6f70 790a 2020 2020  single copy.    
│ │ │ │ -00007100: 2074 6861 7420 6973 2069 6e63 6c75 6465   that is include
│ │ │ │ -00007110: 6420 696e 2074 6865 2063 6f6c 6c65 6374  d in the collect
│ │ │ │ -00007120: 696f 6e2c 2070 726f 7669 6465 6420 7468  ion, provided th
│ │ │ │ -00007130: 6174 2079 6f75 2066 6f6c 6c6f 7720 7468  at you follow th
│ │ │ │ -00007140: 650a 2020 2020 2072 756c 6573 206f 6620  e.     rules of 
│ │ │ │ -00007150: 7468 6973 204c 6963 656e 7365 2066 6f72  this License for
│ │ │ │ -00007160: 2076 6572 6261 7469 6d20 636f 7079 696e   verbatim copyin
│ │ │ │ -00007170: 6720 6f66 2065 6163 6820 6f66 2074 6865  g of each of the
│ │ │ │ -00007180: 2064 6f63 756d 656e 7473 0a20 2020 2020   documents.     
│ │ │ │ -00007190: 696e 2061 6c6c 206f 7468 6572 2072 6573  in all other res
│ │ │ │ -000071a0: 7065 6374 732e 0a0a 2020 2020 2059 6f75  pects...     You
│ │ │ │ -000071b0: 206d 6179 2065 7874 7261 6374 2061 2073   may extract a s
│ │ │ │ -000071c0: 696e 676c 6520 646f 6375 6d65 6e74 2066  ingle document f
│ │ │ │ -000071d0: 726f 6d20 7375 6368 2061 2063 6f6c 6c65  rom such a colle
│ │ │ │ -000071e0: 6374 696f 6e2c 2061 6e64 0a20 2020 2020  ction, and.     
│ │ │ │ -000071f0: 6469 7374 7269 6275 7465 2069 7420 696e  distribute it in
│ │ │ │ -00007200: 6469 7669 6475 616c 6c79 2075 6e64 6572  dividually under
│ │ │ │ -00007210: 2074 6869 7320 4c69 6365 6e73 652c 2070   this License, p
│ │ │ │ -00007220: 726f 7669 6465 6420 796f 7520 696e 7365  rovided you inse
│ │ │ │ -00007230: 7274 0a20 2020 2020 6120 636f 7079 206f  rt.     a copy o
│ │ │ │ -00007240: 6620 7468 6973 204c 6963 656e 7365 2069  f this License i
│ │ │ │ -00007250: 6e74 6f20 7468 6520 6578 7472 6163 7465  nto the extracte
│ │ │ │ -00007260: 6420 646f 6375 6d65 6e74 2c20 616e 6420  d document, and 
│ │ │ │ -00007270: 666f 6c6c 6f77 2074 6869 730a 2020 2020  follow this.    
│ │ │ │ -00007280: 204c 6963 656e 7365 2069 6e20 616c 6c20   License in all 
│ │ │ │ -00007290: 6f74 6865 7220 7265 7370 6563 7473 2072  other respects r
│ │ │ │ -000072a0: 6567 6172 6469 6e67 2076 6572 6261 7469  egarding verbati
│ │ │ │ -000072b0: 6d20 636f 7079 696e 6720 6f66 2074 6861  m copying of tha
│ │ │ │ -000072c0: 740a 2020 2020 2064 6f63 756d 656e 742e  t.     document.
│ │ │ │ -000072d0: 0a0a 2020 372e 2041 4747 5245 4741 5449  ..  7. AGGREGATI
│ │ │ │ -000072e0: 4f4e 2057 4954 4820 494e 4445 5045 4e44  ON WITH INDEPEND
│ │ │ │ -000072f0: 454e 5420 574f 524b 530a 0a20 2020 2020  ENT WORKS..     
│ │ │ │ -00007300: 4120 636f 6d70 696c 6174 696f 6e20 6f66  A compilation of
│ │ │ │ -00007310: 2074 6865 2044 6f63 756d 656e 7420 6f72   the Document or
│ │ │ │ -00007320: 2069 7473 2064 6572 6976 6174 6976 6573   its derivatives
│ │ │ │ -00007330: 2077 6974 6820 6f74 6865 720a 2020 2020   with other.    
│ │ │ │ -00007340: 2073 6570 6172 6174 6520 616e 6420 696e   separate and in
│ │ │ │ -00007350: 6465 7065 6e64 656e 7420 646f 6375 6d65  dependent docume
│ │ │ │ -00007360: 6e74 7320 6f72 2077 6f72 6b73 2c20 696e  nts or works, in
│ │ │ │ -00007370: 206f 7220 6f6e 2061 2076 6f6c 756d 6520   or on a volume 
│ │ │ │ -00007380: 6f66 2061 0a20 2020 2020 7374 6f72 6167  of a.     storag
│ │ │ │ -00007390: 6520 6f72 2064 6973 7472 6962 7574 696f  e or distributio
│ │ │ │ -000073a0: 6e20 6d65 6469 756d 2c20 6973 2063 616c  n medium, is cal
│ │ │ │ -000073b0: 6c65 6420 616e 2022 6167 6772 6567 6174  led an "aggregat
│ │ │ │ -000073c0: 6522 2069 6620 7468 650a 2020 2020 2063  e" if the.     c
│ │ │ │ -000073d0: 6f70 7972 6967 6874 2072 6573 756c 7469  opyright resulti
│ │ │ │ -000073e0: 6e67 2066 726f 6d20 7468 6520 636f 6d70  ng from the comp
│ │ │ │ -000073f0: 696c 6174 696f 6e20 6973 206e 6f74 2075  ilation is not u
│ │ │ │ -00007400: 7365 6420 746f 206c 696d 6974 2074 6865  sed to limit the
│ │ │ │ -00007410: 0a20 2020 2020 6c65 6761 6c20 7269 6768  .     legal righ
│ │ │ │ -00007420: 7473 206f 6620 7468 6520 636f 6d70 696c  ts of the compil
│ │ │ │ -00007430: 6174 696f 6e27 7320 7573 6572 7320 6265  ation's users be
│ │ │ │ -00007440: 796f 6e64 2077 6861 7420 7468 6520 696e  yond what the in
│ │ │ │ -00007450: 6469 7669 6475 616c 0a20 2020 2020 776f  dividual.     wo
│ │ │ │ -00007460: 726b 7320 7065 726d 6974 2e20 2057 6865  rks permit.  Whe
│ │ │ │ -00007470: 6e20 7468 6520 446f 6375 6d65 6e74 2069  n the Document i
│ │ │ │ -00007480: 7320 696e 636c 7564 6564 2069 6e20 616e  s included in an
│ │ │ │ -00007490: 2061 6767 7265 6761 7465 2c20 7468 6973   aggregate, this
│ │ │ │ -000074a0: 0a20 2020 2020 4c69 6365 6e73 6520 646f  .     License do
│ │ │ │ -000074b0: 6573 206e 6f74 2061 7070 6c79 2074 6f20  es not apply to 
│ │ │ │ -000074c0: 7468 6520 6f74 6865 7220 776f 726b 7320  the other works 
│ │ │ │ -000074d0: 696e 2074 6865 2061 6767 7265 6761 7465  in the aggregate
│ │ │ │ -000074e0: 2077 6869 6368 0a20 2020 2020 6172 6520   which.     are 
│ │ │ │ -000074f0: 6e6f 7420 7468 656d 7365 6c76 6573 2064  not themselves d
│ │ │ │ -00007500: 6572 6976 6174 6976 6520 776f 726b 7320  erivative works 
│ │ │ │ -00007510: 6f66 2074 6865 2044 6f63 756d 656e 742e  of the Document.
│ │ │ │ -00007520: 0a0a 2020 2020 2049 6620 7468 6520 436f  ..     If the Co
│ │ │ │ -00007530: 7665 7220 5465 7874 2072 6571 7569 7265  ver Text require
│ │ │ │ -00007540: 6d65 6e74 206f 6620 7365 6374 696f 6e20  ment of section 
│ │ │ │ -00007550: 3320 6973 2061 7070 6c69 6361 626c 6520  3 is applicable 
│ │ │ │ -00007560: 746f 2074 6865 7365 0a20 2020 2020 636f  to these.     co
│ │ │ │ -00007570: 7069 6573 206f 6620 7468 6520 446f 6375  pies of the Docu
│ │ │ │ -00007580: 6d65 6e74 2c20 7468 656e 2069 6620 7468  ment, then if th
│ │ │ │ -00007590: 6520 446f 6375 6d65 6e74 2069 7320 6c65  e Document is le
│ │ │ │ -000075a0: 7373 2074 6861 6e20 6f6e 6520 6861 6c66  ss than one half
│ │ │ │ -000075b0: 0a20 2020 2020 6f66 2074 6865 2065 6e74  .     of the ent
│ │ │ │ -000075c0: 6972 6520 6167 6772 6567 6174 652c 2074  ire aggregate, t
│ │ │ │ -000075d0: 6865 2044 6f63 756d 656e 7427 7320 436f  he Document's Co
│ │ │ │ -000075e0: 7665 7220 5465 7874 7320 6d61 7920 6265  ver Texts may be
│ │ │ │ -000075f0: 2070 6c61 6365 640a 2020 2020 206f 6e20   placed.     on 
│ │ │ │ -00007600: 636f 7665 7273 2074 6861 7420 6272 6163  covers that brac
│ │ │ │ -00007610: 6b65 7420 7468 6520 446f 6375 6d65 6e74  ket the Document
│ │ │ │ -00007620: 2077 6974 6869 6e20 7468 6520 6167 6772   within the aggr
│ │ │ │ -00007630: 6567 6174 652c 206f 7220 7468 650a 2020  egate, or the.  
│ │ │ │ -00007640: 2020 2065 6c65 6374 726f 6e69 6320 6571     electronic eq
│ │ │ │ -00007650: 7569 7661 6c65 6e74 206f 6620 636f 7665  uivalent of cove
│ │ │ │ -00007660: 7273 2069 6620 7468 6520 446f 6375 6d65  rs if the Docume
│ │ │ │ -00007670: 6e74 2069 7320 696e 2065 6c65 6374 726f  nt is in electro
│ │ │ │ -00007680: 6e69 630a 2020 2020 2066 6f72 6d2e 2020  nic.     form.  
│ │ │ │ -00007690: 4f74 6865 7277 6973 6520 7468 6579 206d  Otherwise they m
│ │ │ │ -000076a0: 7573 7420 6170 7065 6172 206f 6e20 7072  ust appear on pr
│ │ │ │ -000076b0: 696e 7465 6420 636f 7665 7273 2074 6861  inted covers tha
│ │ │ │ -000076c0: 7420 6272 6163 6b65 740a 2020 2020 2074  t bracket.     t
│ │ │ │ -000076d0: 6865 2077 686f 6c65 2061 6767 7265 6761  he whole aggrega
│ │ │ │ -000076e0: 7465 2e0a 0a20 2038 2e20 5452 414e 534c  te...  8. TRANSL
│ │ │ │ -000076f0: 4154 494f 4e0a 0a20 2020 2020 5472 616e  ATION..     Tran
│ │ │ │ -00007700: 736c 6174 696f 6e20 6973 2063 6f6e 7369  slation is consi
│ │ │ │ -00007710: 6465 7265 6420 6120 6b69 6e64 206f 6620  dered a kind of 
│ │ │ │ -00007720: 6d6f 6469 6669 6361 7469 6f6e 2c20 736f  modification, so
│ │ │ │ -00007730: 2079 6f75 206d 6179 0a20 2020 2020 6469   you may.     di
│ │ │ │ -00007740: 7374 7269 6275 7465 2074 7261 6e73 6c61  stribute transla
│ │ │ │ -00007750: 7469 6f6e 7320 6f66 2074 6865 2044 6f63  tions of the Doc
│ │ │ │ -00007760: 756d 656e 7420 756e 6465 7220 7468 6520  ument under the 
│ │ │ │ -00007770: 7465 726d 7320 6f66 2073 6563 7469 6f6e  terms of section
│ │ │ │ -00007780: 0a20 2020 2020 342e 2020 5265 706c 6163  .     4.  Replac
│ │ │ │ -00007790: 696e 6720 496e 7661 7269 616e 7420 5365  ing Invariant Se
│ │ │ │ -000077a0: 6374 696f 6e73 2077 6974 6820 7472 616e  ctions with tran
│ │ │ │ -000077b0: 736c 6174 696f 6e73 2072 6571 7569 7265  slations require
│ │ │ │ -000077c0: 7320 7370 6563 6961 6c0a 2020 2020 2070  s special.     p
│ │ │ │ -000077d0: 6572 6d69 7373 696f 6e20 6672 6f6d 2074  ermission from t
│ │ │ │ -000077e0: 6865 6972 2063 6f70 7972 6967 6874 2068  heir copyright h
│ │ │ │ -000077f0: 6f6c 6465 7273 2c20 6275 7420 796f 7520  olders, but you 
│ │ │ │ -00007800: 6d61 7920 696e 636c 7564 650a 2020 2020  may include.    
│ │ │ │ -00007810: 2074 7261 6e73 6c61 7469 6f6e 7320 6f66   translations of
│ │ │ │ -00007820: 2073 6f6d 6520 6f72 2061 6c6c 2049 6e76   some or all Inv
│ │ │ │ -00007830: 6172 6961 6e74 2053 6563 7469 6f6e 7320  ariant Sections 
│ │ │ │ -00007840: 696e 2061 6464 6974 696f 6e20 746f 2074  in addition to t
│ │ │ │ -00007850: 6865 0a20 2020 2020 6f72 6967 696e 616c  he.     original
│ │ │ │ -00007860: 2076 6572 7369 6f6e 7320 6f66 2074 6865   versions of the
│ │ │ │ -00007870: 7365 2049 6e76 6172 6961 6e74 2053 6563  se Invariant Sec
│ │ │ │ -00007880: 7469 6f6e 732e 2020 596f 7520 6d61 7920  tions.  You may 
│ │ │ │ -00007890: 696e 636c 7564 6520 610a 2020 2020 2074  include a.     t
│ │ │ │ -000078a0: 7261 6e73 6c61 7469 6f6e 206f 6620 7468  ranslation of th
│ │ │ │ -000078b0: 6973 204c 6963 656e 7365 2c20 616e 6420  is License, and 
│ │ │ │ -000078c0: 616c 6c20 7468 6520 6c69 6365 6e73 6520  all the license 
│ │ │ │ -000078d0: 6e6f 7469 6365 7320 696e 2074 6865 0a20  notices in the. 
│ │ │ │ -000078e0: 2020 2020 446f 6375 6d65 6e74 2c20 616e      Document, an
│ │ │ │ -000078f0: 6420 616e 7920 5761 7272 616e 7479 2044  d any Warranty D
│ │ │ │ -00007900: 6973 636c 6169 6d65 7273 2c20 7072 6f76  isclaimers, prov
│ │ │ │ -00007910: 6964 6564 2074 6861 7420 796f 7520 616c  ided that you al
│ │ │ │ -00007920: 736f 0a20 2020 2020 696e 636c 7564 6520  so.     include 
│ │ │ │ -00007930: 7468 6520 6f72 6967 696e 616c 2045 6e67  the original Eng
│ │ │ │ -00007940: 6c69 7368 2076 6572 7369 6f6e 206f 6620  lish version of 
│ │ │ │ -00007950: 7468 6973 204c 6963 656e 7365 2061 6e64  this License and
│ │ │ │ -00007960: 2074 6865 0a20 2020 2020 6f72 6967 696e   the.     origin
│ │ │ │ -00007970: 616c 2076 6572 7369 6f6e 7320 6f66 2074  al versions of t
│ │ │ │ -00007980: 686f 7365 206e 6f74 6963 6573 2061 6e64  hose notices and
│ │ │ │ -00007990: 2064 6973 636c 6169 6d65 7273 2e20 2049   disclaimers.  I
│ │ │ │ -000079a0: 6e20 6361 7365 206f 6620 610a 2020 2020  n case of a.    
│ │ │ │ -000079b0: 2064 6973 6167 7265 656d 656e 7420 6265   disagreement be
│ │ │ │ -000079c0: 7477 6565 6e20 7468 6520 7472 616e 736c  tween the transl
│ │ │ │ -000079d0: 6174 696f 6e20 616e 6420 7468 6520 6f72  ation and the or
│ │ │ │ -000079e0: 6967 696e 616c 2076 6572 7369 6f6e 206f  iginal version o
│ │ │ │ -000079f0: 660a 2020 2020 2074 6869 7320 4c69 6365  f.     this Lice
│ │ │ │ -00007a00: 6e73 6520 6f72 2061 206e 6f74 6963 6520  nse or a notice 
│ │ │ │ -00007a10: 6f72 2064 6973 636c 6169 6d65 722c 2074  or disclaimer, t
│ │ │ │ -00007a20: 6865 206f 7269 6769 6e61 6c20 7665 7273  he original vers
│ │ │ │ -00007a30: 696f 6e20 7769 6c6c 0a20 2020 2020 7072  ion will.     pr
│ │ │ │ -00007a40: 6576 6169 6c2e 0a0a 2020 2020 2049 6620  evail...     If 
│ │ │ │ -00007a50: 6120 7365 6374 696f 6e20 696e 2074 6865  a section in the
│ │ │ │ -00007a60: 2044 6f63 756d 656e 7420 6973 2045 6e74   Document is Ent
│ │ │ │ -00007a70: 6974 6c65 6420 2241 636b 6e6f 776c 6564  itled "Acknowled
│ │ │ │ -00007a80: 6765 6d65 6e74 7322 2c0a 2020 2020 2022  gements",.     "
│ │ │ │ -00007a90: 4465 6469 6361 7469 6f6e 7322 2c20 6f72  Dedications", or
│ │ │ │ -00007aa0: 2022 4869 7374 6f72 7922 2c20 7468 6520   "History", the 
│ │ │ │ -00007ab0: 7265 7175 6972 656d 656e 7420 2873 6563  requirement (sec
│ │ │ │ -00007ac0: 7469 6f6e 2034 2920 746f 0a20 2020 2020  tion 4) to.     
│ │ │ │ -00007ad0: 5072 6573 6572 7665 2069 7473 2054 6974  Preserve its Tit
│ │ │ │ -00007ae0: 6c65 2028 7365 6374 696f 6e20 3129 2077  le (section 1) w
│ │ │ │ -00007af0: 696c 6c20 7479 7069 6361 6c6c 7920 7265  ill typically re
│ │ │ │ -00007b00: 7175 6972 6520 6368 616e 6769 6e67 2074  quire changing t
│ │ │ │ -00007b10: 6865 0a20 2020 2020 6163 7475 616c 2074  he.     actual t
│ │ │ │ -00007b20: 6974 6c65 2e0a 0a20 2039 2e20 5445 524d  itle...  9. TERM
│ │ │ │ -00007b30: 494e 4154 494f 4e0a 0a20 2020 2020 596f  INATION..     Yo
│ │ │ │ -00007b40: 7520 6d61 7920 6e6f 7420 636f 7079 2c20  u may not copy, 
│ │ │ │ -00007b50: 6d6f 6469 6679 2c20 7375 626c 6963 656e  modify, sublicen
│ │ │ │ -00007b60: 7365 2c20 6f72 2064 6973 7472 6962 7574  se, or distribut
│ │ │ │ -00007b70: 6520 7468 6520 446f 6375 6d65 6e74 0a20  e the Document. 
│ │ │ │ -00007b80: 2020 2020 6578 6365 7074 2061 7320 6578      except as ex
│ │ │ │ -00007b90: 7072 6573 736c 7920 7072 6f76 6964 6564  pressly provided
│ │ │ │ -00007ba0: 2075 6e64 6572 2074 6869 7320 4c69 6365   under this Lice
│ │ │ │ -00007bb0: 6e73 652e 2020 416e 7920 6174 7465 6d70  nse.  Any attemp
│ │ │ │ -00007bc0: 740a 2020 2020 206f 7468 6572 7769 7365  t.     otherwise
│ │ │ │ -00007bd0: 2074 6f20 636f 7079 2c20 6d6f 6469 6679   to copy, modify
│ │ │ │ -00007be0: 2c20 7375 626c 6963 656e 7365 2c20 6f72  , sublicense, or
│ │ │ │ -00007bf0: 2064 6973 7472 6962 7574 6520 6974 2069   distribute it i
│ │ │ │ -00007c00: 7320 766f 6964 2c0a 2020 2020 2061 6e64  s void,.     and
│ │ │ │ -00007c10: 2077 696c 6c20 6175 746f 6d61 7469 6361   will automatica
│ │ │ │ -00007c20: 6c6c 7920 7465 726d 696e 6174 6520 796f  lly terminate yo
│ │ │ │ -00007c30: 7572 2072 6967 6874 7320 756e 6465 7220  ur rights under 
│ │ │ │ -00007c40: 7468 6973 204c 6963 656e 7365 2e0a 0a20  this License... 
│ │ │ │ -00007c50: 2020 2020 486f 7765 7665 722c 2069 6620      However, if 
│ │ │ │ -00007c60: 796f 7520 6365 6173 6520 616c 6c20 7669  you cease all vi
│ │ │ │ -00007c70: 6f6c 6174 696f 6e20 6f66 2074 6869 7320  olation of this 
│ │ │ │ -00007c80: 4c69 6365 6e73 652c 2074 6865 6e20 796f  License, then yo
│ │ │ │ -00007c90: 7572 0a20 2020 2020 6c69 6365 6e73 6520  ur.     license 
│ │ │ │ -00007ca0: 6672 6f6d 2061 2070 6172 7469 6375 6c61  from a particula
│ │ │ │ -00007cb0: 7220 636f 7079 7269 6768 7420 686f 6c64  r copyright hold
│ │ │ │ -00007cc0: 6572 2069 7320 7265 696e 7374 6174 6564  er is reinstated
│ │ │ │ -00007cd0: 2028 6129 0a20 2020 2020 7072 6f76 6973   (a).     provis
│ │ │ │ -00007ce0: 696f 6e61 6c6c 792c 2075 6e6c 6573 7320  ionally, unless 
│ │ │ │ -00007cf0: 616e 6420 756e 7469 6c20 7468 6520 636f  and until the co
│ │ │ │ -00007d00: 7079 7269 6768 7420 686f 6c64 6572 2065  pyright holder e
│ │ │ │ -00007d10: 7870 6c69 6369 746c 7920 616e 640a 2020  xplicitly and.  
│ │ │ │ -00007d20: 2020 2066 696e 616c 6c79 2074 6572 6d69     finally termi
│ │ │ │ -00007d30: 6e61 7465 7320 796f 7572 206c 6963 656e  nates your licen
│ │ │ │ -00007d40: 7365 2c20 616e 6420 2862 2920 7065 726d  se, and (b) perm
│ │ │ │ -00007d50: 616e 656e 746c 792c 2069 6620 7468 650a  anently, if the.
│ │ │ │ -00007d60: 2020 2020 2063 6f70 7972 6967 6874 2068       copyright h
│ │ │ │ -00007d70: 6f6c 6465 7220 6661 696c 7320 746f 206e  older fails to n
│ │ │ │ -00007d80: 6f74 6966 7920 796f 7520 6f66 2074 6865  otify you of the
│ │ │ │ -00007d90: 2076 696f 6c61 7469 6f6e 2062 7920 736f   violation by so
│ │ │ │ -00007da0: 6d65 0a20 2020 2020 7265 6173 6f6e 6162  me.     reasonab
│ │ │ │ -00007db0: 6c65 206d 6561 6e73 2070 7269 6f72 2074  le means prior t
│ │ │ │ -00007dc0: 6f20 3630 2064 6179 7320 6166 7465 7220  o 60 days after 
│ │ │ │ -00007dd0: 7468 6520 6365 7373 6174 696f 6e2e 0a0a  the cessation...
│ │ │ │ -00007de0: 2020 2020 204d 6f72 656f 7665 722c 2079       Moreover, y
│ │ │ │ -00007df0: 6f75 7220 6c69 6365 6e73 6520 6672 6f6d  our license from
│ │ │ │ -00007e00: 2061 2070 6172 7469 6375 6c61 7220 636f   a particular co
│ │ │ │ -00007e10: 7079 7269 6768 7420 686f 6c64 6572 2069  pyright holder i
│ │ │ │ -00007e20: 730a 2020 2020 2072 6569 6e73 7461 7465  s.     reinstate
│ │ │ │ -00007e30: 6420 7065 726d 616e 656e 746c 7920 6966  d permanently if
│ │ │ │ -00007e40: 2074 6865 2063 6f70 7972 6967 6874 2068   the copyright h
│ │ │ │ -00007e50: 6f6c 6465 7220 6e6f 7469 6669 6573 2079  older notifies y
│ │ │ │ -00007e60: 6f75 206f 6620 7468 650a 2020 2020 2076  ou of the.     v
│ │ │ │ -00007e70: 696f 6c61 7469 6f6e 2062 7920 736f 6d65  iolation by some
│ │ │ │ -00007e80: 2072 6561 736f 6e61 626c 6520 6d65 616e   reasonable mean
│ │ │ │ -00007e90: 732c 2074 6869 7320 6973 2074 6865 2066  s, this is the f
│ │ │ │ -00007ea0: 6972 7374 2074 696d 6520 796f 7520 6861  irst time you ha
│ │ │ │ -00007eb0: 7665 0a20 2020 2020 7265 6365 6976 6564  ve.     received
│ │ │ │ -00007ec0: 206e 6f74 6963 6520 6f66 2076 696f 6c61   notice of viola
│ │ │ │ -00007ed0: 7469 6f6e 206f 6620 7468 6973 204c 6963  tion of this Lic
│ │ │ │ -00007ee0: 656e 7365 2028 666f 7220 616e 7920 776f  ense (for any wo
│ │ │ │ -00007ef0: 726b 2920 6672 6f6d 0a20 2020 2020 7468  rk) from.     th
│ │ │ │ -00007f00: 6174 2063 6f70 7972 6967 6874 2068 6f6c  at copyright hol
│ │ │ │ -00007f10: 6465 722c 2061 6e64 2079 6f75 2063 7572  der, and you cur
│ │ │ │ -00007f20: 6520 7468 6520 7669 6f6c 6174 696f 6e20  e the violation 
│ │ │ │ -00007f30: 7072 696f 7220 746f 2033 3020 6461 7973  prior to 30 days
│ │ │ │ -00007f40: 0a20 2020 2020 6166 7465 7220 796f 7572  .     after your
│ │ │ │ -00007f50: 2072 6563 6569 7074 206f 6620 7468 6520   receipt of the 
│ │ │ │ -00007f60: 6e6f 7469 6365 2e0a 0a20 2020 2020 5465  notice...     Te
│ │ │ │ -00007f70: 726d 696e 6174 696f 6e20 6f66 2079 6f75  rmination of you
│ │ │ │ -00007f80: 7220 7269 6768 7473 2075 6e64 6572 2074  r rights under t
│ │ │ │ -00007f90: 6869 7320 7365 6374 696f 6e20 646f 6573  his section does
│ │ │ │ -00007fa0: 206e 6f74 2074 6572 6d69 6e61 7465 0a20   not terminate. 
│ │ │ │ -00007fb0: 2020 2020 7468 6520 6c69 6365 6e73 6573      the licenses
│ │ │ │ -00007fc0: 206f 6620 7061 7274 6965 7320 7768 6f20   of parties who 
│ │ │ │ -00007fd0: 6861 7665 2072 6563 6569 7665 6420 636f  have received co
│ │ │ │ -00007fe0: 7069 6573 206f 7220 7269 6768 7473 2066  pies or rights f
│ │ │ │ -00007ff0: 726f 6d20 796f 750a 2020 2020 2075 6e64  rom you.     und
│ │ │ │ -00008000: 6572 2074 6869 7320 4c69 6365 6e73 652e  er this License.
│ │ │ │ -00008010: 2020 4966 2079 6f75 7220 7269 6768 7473    If your rights
│ │ │ │ -00008020: 2068 6176 6520 6265 656e 2074 6572 6d69   have been termi
│ │ │ │ -00008030: 6e61 7465 6420 616e 6420 6e6f 740a 2020  nated and not.  
│ │ │ │ -00008040: 2020 2070 6572 6d61 6e65 6e74 6c79 2072     permanently r
│ │ │ │ -00008050: 6569 6e73 7461 7465 642c 2072 6563 6569  einstated, recei
│ │ │ │ -00008060: 7074 206f 6620 6120 636f 7079 206f 6620  pt of a copy of 
│ │ │ │ -00008070: 736f 6d65 206f 7220 616c 6c20 6f66 2074  some or all of t
│ │ │ │ -00008080: 6865 0a20 2020 2020 7361 6d65 206d 6174  he.     same mat
│ │ │ │ -00008090: 6572 6961 6c20 646f 6573 206e 6f74 2067  erial does not g
│ │ │ │ -000080a0: 6976 6520 796f 7520 616e 7920 7269 6768  ive you any righ
│ │ │ │ -000080b0: 7473 2074 6f20 7573 6520 6974 2e0a 0a20  ts to use it... 
│ │ │ │ -000080c0: 2031 302e 2046 5554 5552 4520 5245 5649   10. FUTURE REVI
│ │ │ │ -000080d0: 5349 4f4e 5320 4f46 2054 4849 5320 4c49  SIONS OF THIS LI
│ │ │ │ -000080e0: 4345 4e53 450a 0a20 2020 2020 5468 6520  CENSE..     The 
│ │ │ │ -000080f0: 4672 6565 2053 6f66 7477 6172 6520 466f  Free Software Fo
│ │ │ │ -00008100: 756e 6461 7469 6f6e 206d 6179 2070 7562  undation may pub
│ │ │ │ -00008110: 6c69 7368 206e 6577 2c20 7265 7669 7365  lish new, revise
│ │ │ │ -00008120: 6420 7665 7273 696f 6e73 206f 660a 2020  d versions of.  
│ │ │ │ -00008130: 2020 2074 6865 2047 4e55 2046 7265 6520     the GNU Free 
│ │ │ │ -00008140: 446f 6375 6d65 6e74 6174 696f 6e20 4c69  Documentation Li
│ │ │ │ -00008150: 6365 6e73 6520 6672 6f6d 2074 696d 6520  cense from time 
│ │ │ │ -00008160: 746f 2074 696d 652e 2020 5375 6368 206e  to time.  Such n
│ │ │ │ -00008170: 6577 0a20 2020 2020 7665 7273 696f 6e73  ew.     versions
│ │ │ │ -00008180: 2077 696c 6c20 6265 2073 696d 696c 6172   will be similar
│ │ │ │ -00008190: 2069 6e20 7370 6972 6974 2074 6f20 7468   in spirit to th
│ │ │ │ -000081a0: 6520 7072 6573 656e 7420 7665 7273 696f  e present versio
│ │ │ │ -000081b0: 6e2c 2062 7574 206d 6179 0a20 2020 2020  n, but may.     
│ │ │ │ -000081c0: 6469 6666 6572 2069 6e20 6465 7461 696c  differ in detail
│ │ │ │ -000081d0: 2074 6f20 6164 6472 6573 7320 6e65 7720   to address new 
│ │ │ │ -000081e0: 7072 6f62 6c65 6d73 206f 7220 636f 6e63  problems or conc
│ │ │ │ -000081f0: 6572 6e73 2e20 2053 6565 0a20 2020 2020  erns.  See.     
│ │ │ │ -00008200: 3c68 7474 7073 3a2f 2f77 7777 2e67 6e75  <https://www.gnu
│ │ │ │ -00008210: 2e6f 7267 2f6c 6963 656e 7365 732f 3e2e  .org/licenses/>.
│ │ │ │ -00008220: 0a0a 2020 2020 2045 6163 6820 7665 7273  ..     Each vers
│ │ │ │ -00008230: 696f 6e20 6f66 2074 6865 204c 6963 656e  ion of the Licen
│ │ │ │ -00008240: 7365 2069 7320 6769 7665 6e20 6120 6469  se is given a di
│ │ │ │ -00008250: 7374 696e 6775 6973 6869 6e67 2076 6572  stinguishing ver
│ │ │ │ -00008260: 7369 6f6e 0a20 2020 2020 6e75 6d62 6572  sion.     number
│ │ │ │ -00008270: 2e20 2049 6620 7468 6520 446f 6375 6d65  .  If the Docume
│ │ │ │ -00008280: 6e74 2073 7065 6369 6669 6573 2074 6861  nt specifies tha
│ │ │ │ -00008290: 7420 6120 7061 7274 6963 756c 6172 206e  t a particular n
│ │ │ │ -000082a0: 756d 6265 7265 640a 2020 2020 2076 6572  umbered.     ver
│ │ │ │ -000082b0: 7369 6f6e 206f 6620 7468 6973 204c 6963  sion of this Lic
│ │ │ │ -000082c0: 656e 7365 2022 6f72 2061 6e79 206c 6174  ense "or any lat
│ │ │ │ -000082d0: 6572 2076 6572 7369 6f6e 2220 6170 706c  er version" appl
│ │ │ │ -000082e0: 6965 7320 746f 2069 742c 2079 6f75 0a20  ies to it, you. 
│ │ │ │ -000082f0: 2020 2020 6861 7665 2074 6865 206f 7074      have the opt
│ │ │ │ -00008300: 696f 6e20 6f66 2066 6f6c 6c6f 7769 6e67  ion of following
│ │ │ │ -00008310: 2074 6865 2074 6572 6d73 2061 6e64 2063   the terms and c
│ │ │ │ -00008320: 6f6e 6469 7469 6f6e 7320 6569 7468 6572  onditions either
│ │ │ │ -00008330: 206f 660a 2020 2020 2074 6861 7420 7370   of.     that sp
│ │ │ │ -00008340: 6563 6966 6965 6420 7665 7273 696f 6e20  ecified version 
│ │ │ │ -00008350: 6f72 206f 6620 616e 7920 6c61 7465 7220  or of any later 
│ │ │ │ -00008360: 7665 7273 696f 6e20 7468 6174 2068 6173  version that has
│ │ │ │ -00008370: 2062 6565 6e0a 2020 2020 2070 7562 6c69   been.     publi
│ │ │ │ -00008380: 7368 6564 2028 6e6f 7420 6173 2061 2064  shed (not as a d
│ │ │ │ -00008390: 7261 6674 2920 6279 2074 6865 2046 7265  raft) by the Fre
│ │ │ │ -000083a0: 6520 536f 6674 7761 7265 2046 6f75 6e64  e Software Found
│ │ │ │ -000083b0: 6174 696f 6e2e 2020 4966 2074 6865 0a20  ation.  If the. 
│ │ │ │ -000083c0: 2020 2020 446f 6375 6d65 6e74 2064 6f65      Document doe
│ │ │ │ -000083d0: 7320 6e6f 7420 7370 6563 6966 7920 6120  s not specify a 
│ │ │ │ -000083e0: 7665 7273 696f 6e20 6e75 6d62 6572 206f  version number o
│ │ │ │ -000083f0: 6620 7468 6973 204c 6963 656e 7365 2c20  f this License, 
│ │ │ │ -00008400: 796f 7520 6d61 790a 2020 2020 2063 686f  you may.     cho
│ │ │ │ -00008410: 6f73 6520 616e 7920 7665 7273 696f 6e20  ose any version 
│ │ │ │ -00008420: 6576 6572 2070 7562 6c69 7368 6564 2028  ever published (
│ │ │ │ -00008430: 6e6f 7420 6173 2061 2064 7261 6674 2920  not as a draft) 
│ │ │ │ -00008440: 6279 2074 6865 2046 7265 650a 2020 2020  by the Free.    
│ │ │ │ -00008450: 2053 6f66 7477 6172 6520 466f 756e 6461   Software Founda
│ │ │ │ -00008460: 7469 6f6e 2e20 2049 6620 7468 6520 446f  tion.  If the Do
│ │ │ │ -00008470: 6375 6d65 6e74 2073 7065 6369 6669 6573  cument specifies
│ │ │ │ -00008480: 2074 6861 7420 6120 7072 6f78 7920 6361   that a proxy ca
│ │ │ │ -00008490: 6e0a 2020 2020 2064 6563 6964 6520 7768  n.     decide wh
│ │ │ │ -000084a0: 6963 6820 6675 7475 7265 2076 6572 7369  ich future versi
│ │ │ │ -000084b0: 6f6e 7320 6f66 2074 6869 7320 4c69 6365  ons of this Lice
│ │ │ │ -000084c0: 6e73 6520 6361 6e20 6265 2075 7365 642c  nse can be used,
│ │ │ │ -000084d0: 2074 6861 740a 2020 2020 2070 726f 7879   that.     proxy
│ │ │ │ -000084e0: 2773 2070 7562 6c69 6320 7374 6174 656d  's public statem
│ │ │ │ -000084f0: 656e 7420 6f66 2061 6363 6570 7461 6e63  ent of acceptanc
│ │ │ │ -00008500: 6520 6f66 2061 2076 6572 7369 6f6e 2070  e of a version p
│ │ │ │ -00008510: 6572 6d61 6e65 6e74 6c79 0a20 2020 2020  ermanently.     
│ │ │ │ -00008520: 6175 7468 6f72 697a 6573 2079 6f75 2074  authorizes you t
│ │ │ │ -00008530: 6f20 6368 6f6f 7365 2074 6861 7420 7665  o choose that ve
│ │ │ │ -00008540: 7273 696f 6e20 666f 7220 7468 6520 446f  rsion for the Do
│ │ │ │ -00008550: 6375 6d65 6e74 2e0a 0a20 2031 312e 2052  cument...  11. R
│ │ │ │ -00008560: 454c 4943 454e 5349 4e47 0a0a 2020 2020  ELICENSING..    
│ │ │ │ -00008570: 2022 4d61 7373 6976 6520 4d75 6c74 6961   "Massive Multia
│ │ │ │ -00008580: 7574 686f 7220 436f 6c6c 6162 6f72 6174  uthor Collaborat
│ │ │ │ -00008590: 696f 6e20 5369 7465 2220 286f 7220 224d  ion Site" (or "M
│ │ │ │ -000085a0: 4d43 2053 6974 6522 2920 6d65 616e 7320  MC Site") means 
│ │ │ │ -000085b0: 616e 790a 2020 2020 2057 6f72 6c64 2057  any.     World W
│ │ │ │ -000085c0: 6964 6520 5765 6220 7365 7276 6572 2074  ide Web server t
│ │ │ │ -000085d0: 6861 7420 7075 626c 6973 6865 7320 636f  hat publishes co
│ │ │ │ -000085e0: 7079 7269 6768 7461 626c 6520 776f 726b  pyrightable work
│ │ │ │ -000085f0: 7320 616e 6420 616c 736f 0a20 2020 2020  s and also.     
│ │ │ │ -00008600: 7072 6f76 6964 6573 2070 726f 6d69 6e65  provides promine
│ │ │ │ -00008610: 6e74 2066 6163 696c 6974 6965 7320 666f  nt facilities fo
│ │ │ │ -00008620: 7220 616e 7962 6f64 7920 746f 2065 6469  r anybody to edi
│ │ │ │ -00008630: 7420 7468 6f73 6520 776f 726b 732e 2020  t those works.  
│ │ │ │ -00008640: 410a 2020 2020 2070 7562 6c69 6320 7769  A.     public wi
│ │ │ │ -00008650: 6b69 2074 6861 7420 616e 7962 6f64 7920  ki that anybody 
│ │ │ │ -00008660: 6361 6e20 6564 6974 2069 7320 616e 2065  can edit is an e
│ │ │ │ -00008670: 7861 6d70 6c65 206f 6620 7375 6368 2061  xample of such a
│ │ │ │ -00008680: 2073 6572 7665 722e 0a20 2020 2020 4120   server..     A 
│ │ │ │ -00008690: 224d 6173 7369 7665 204d 756c 7469 6175  "Massive Multiau
│ │ │ │ -000086a0: 7468 6f72 2043 6f6c 6c61 626f 7261 7469  thor Collaborati
│ │ │ │ -000086b0: 6f6e 2220 286f 7220 224d 4d43 2229 2063  on" (or "MMC") c
│ │ │ │ -000086c0: 6f6e 7461 696e 6564 2069 6e20 7468 650a  ontained in the.
│ │ │ │ -000086d0: 2020 2020 2073 6974 6520 6d65 616e 7320       site means 
│ │ │ │ -000086e0: 616e 7920 7365 7420 6f66 2063 6f70 7972  any set of copyr
│ │ │ │ -000086f0: 6967 6874 6162 6c65 2077 6f72 6b73 2074  ightable works t
│ │ │ │ -00008700: 6875 7320 7075 626c 6973 6865 6420 6f6e  hus published on
│ │ │ │ -00008710: 2074 6865 204d 4d43 0a20 2020 2020 7369   the MMC.     si
│ │ │ │ -00008720: 7465 2e0a 0a20 2020 2020 2243 432d 4259  te...     "CC-BY
│ │ │ │ -00008730: 2d53 4122 206d 6561 6e73 2074 6865 2043  -SA" means the C
│ │ │ │ -00008740: 7265 6174 6976 6520 436f 6d6d 6f6e 7320  reative Commons 
│ │ │ │ -00008750: 4174 7472 6962 7574 696f 6e2d 5368 6172  Attribution-Shar
│ │ │ │ -00008760: 6520 416c 696b 6520 332e 300a 2020 2020  e Alike 3.0.    
│ │ │ │ -00008770: 206c 6963 656e 7365 2070 7562 6c69 7368   license publish
│ │ │ │ -00008780: 6564 2062 7920 4372 6561 7469 7665 2043  ed by Creative C
│ │ │ │ -00008790: 6f6d 6d6f 6e73 2043 6f72 706f 7261 7469  ommons Corporati
│ │ │ │ -000087a0: 6f6e 2c20 6120 6e6f 742d 666f 722d 7072  on, a not-for-pr
│ │ │ │ -000087b0: 6f66 6974 0a20 2020 2020 636f 7270 6f72  ofit.     corpor
│ │ │ │ -000087c0: 6174 696f 6e20 7769 7468 2061 2070 7269  ation with a pri
│ │ │ │ -000087d0: 6e63 6970 616c 2070 6c61 6365 206f 6620  ncipal place of 
│ │ │ │ -000087e0: 6275 7369 6e65 7373 2069 6e20 5361 6e20  business in San 
│ │ │ │ -000087f0: 4672 616e 6369 7363 6f2c 0a20 2020 2020  Francisco,.     
│ │ │ │ -00008800: 4361 6c69 666f 726e 6961 2c20 6173 2077  California, as w
│ │ │ │ -00008810: 656c 6c20 6173 2066 7574 7572 6520 636f  ell as future co
│ │ │ │ -00008820: 7079 6c65 6674 2076 6572 7369 6f6e 7320  pyleft versions 
│ │ │ │ -00008830: 6f66 2074 6861 7420 6c69 6365 6e73 650a  of that license.
│ │ │ │ -00008840: 2020 2020 2070 7562 6c69 7368 6564 2062       published b
│ │ │ │ -00008850: 7920 7468 6174 2073 616d 6520 6f72 6761  y that same orga
│ │ │ │ -00008860: 6e69 7a61 7469 6f6e 2e0a 0a20 2020 2020  nization...     
│ │ │ │ -00008870: 2249 6e63 6f72 706f 7261 7465 2220 6d65  "Incorporate" me
│ │ │ │ -00008880: 616e 7320 746f 2070 7562 6c69 7368 206f  ans to publish o
│ │ │ │ -00008890: 7220 7265 7075 626c 6973 6820 6120 446f  r republish a Do
│ │ │ │ -000088a0: 6375 6d65 6e74 2c20 696e 2077 686f 6c65  cument, in whole
│ │ │ │ -000088b0: 206f 720a 2020 2020 2069 6e20 7061 7274   or.     in part
│ │ │ │ -000088c0: 2c20 6173 2070 6172 7420 6f66 2061 6e6f  , as part of ano
│ │ │ │ -000088d0: 7468 6572 2044 6f63 756d 656e 742e 0a0a  ther Document...
│ │ │ │ -000088e0: 2020 2020 2041 6e20 4d4d 4320 6973 2022       An MMC is "
│ │ │ │ -000088f0: 656c 6967 6962 6c65 2066 6f72 2072 656c  eligible for rel
│ │ │ │ -00008900: 6963 656e 7369 6e67 2220 6966 2069 7420  icensing" if it 
│ │ │ │ -00008910: 6973 206c 6963 656e 7365 6420 756e 6465  is licensed unde
│ │ │ │ -00008920: 7220 7468 6973 0a20 2020 2020 4c69 6365  r this.     Lice
│ │ │ │ -00008930: 6e73 652c 2061 6e64 2069 6620 616c 6c20  nse, and if all 
│ │ │ │ -00008940: 776f 726b 7320 7468 6174 2077 6572 6520  works that were 
│ │ │ │ -00008950: 6669 7273 7420 7075 626c 6973 6865 6420  first published 
│ │ │ │ -00008960: 756e 6465 7220 7468 6973 0a20 2020 2020  under this.     
│ │ │ │ -00008970: 4c69 6365 6e73 6520 736f 6d65 7768 6572  License somewher
│ │ │ │ -00008980: 6520 6f74 6865 7220 7468 616e 2074 6869  e other than thi
│ │ │ │ -00008990: 7320 4d4d 432c 2061 6e64 2073 7562 7365  s MMC, and subse
│ │ │ │ -000089a0: 7175 656e 746c 790a 2020 2020 2069 6e63  quently.     inc
│ │ │ │ -000089b0: 6f72 706f 7261 7465 6420 696e 2077 686f  orporated in who
│ │ │ │ -000089c0: 6c65 206f 7220 696e 2070 6172 7420 696e  le or in part in
│ │ │ │ -000089d0: 746f 2074 6865 204d 4d43 2c20 2831 2920  to the MMC, (1) 
│ │ │ │ -000089e0: 6861 6420 6e6f 2063 6f76 6572 0a20 2020  had no cover.   
│ │ │ │ -000089f0: 2020 7465 7874 7320 6f72 2069 6e76 6172    texts or invar
│ │ │ │ -00008a00: 6961 6e74 2073 6563 7469 6f6e 732c 2061  iant sections, a
│ │ │ │ -00008a10: 6e64 2028 3229 2077 6572 6520 7468 7573  nd (2) were thus
│ │ │ │ -00008a20: 2069 6e63 6f72 706f 7261 7465 6420 7072   incorporated pr
│ │ │ │ -00008a30: 696f 720a 2020 2020 2074 6f20 4e6f 7665  ior.     to Nove
│ │ │ │ -00008a40: 6d62 6572 2031 2c20 3230 3038 2e0a 0a20  mber 1, 2008... 
│ │ │ │ -00008a50: 2020 2020 5468 6520 6f70 6572 6174 6f72      The operator
│ │ │ │ -00008a60: 206f 6620 616e 204d 4d43 2053 6974 6520   of an MMC Site 
│ │ │ │ -00008a70: 6d61 7920 7265 7075 626c 6973 6820 616e  may republish an
│ │ │ │ -00008a80: 204d 4d43 2063 6f6e 7461 696e 6564 2069   MMC contained i
│ │ │ │ -00008a90: 6e20 7468 650a 2020 2020 2073 6974 6520  n the.     site 
│ │ │ │ -00008aa0: 756e 6465 7220 4343 2d42 592d 5341 206f  under CC-BY-SA o
│ │ │ │ -00008ab0: 6e20 7468 6520 7361 6d65 2073 6974 6520  n the same site 
│ │ │ │ -00008ac0: 6174 2061 6e79 2074 696d 6520 6265 666f  at any time befo
│ │ │ │ -00008ad0: 7265 2041 7567 7573 7420 312c 0a20 2020  re August 1,.   
│ │ │ │ -00008ae0: 2020 3230 3039 2c20 7072 6f76 6964 6564    2009, provided
│ │ │ │ -00008af0: 2074 6865 204d 4d43 2069 7320 656c 6967   the MMC is elig
│ │ │ │ -00008b00: 6962 6c65 2066 6f72 2072 656c 6963 656e  ible for relicen
│ │ │ │ -00008b10: 7369 6e67 2e0a 0a41 4444 454e 4455 4d3a  sing...ADDENDUM:
│ │ │ │ -00008b20: 2048 6f77 2074 6f20 7573 6520 7468 6973   How to use this
│ │ │ │ -00008b30: 204c 6963 656e 7365 2066 6f72 2079 6f75   License for you
│ │ │ │ -00008b40: 7220 646f 6375 6d65 6e74 730a 3d3d 3d3d  r documents.====
│ │ │ │ +00002f10: 3d3d 3d3d 0a0a 2020 2020 2020 2020 2020  ====..          
│ │ │ │ +00002f20: 2020 2020 2020 2020 2020 2056 6572 7369             Versi
│ │ │ │ +00002f30: 6f6e 2031 2e33 2c20 3320 4e6f 7665 6d62  on 1.3, 3 Novemb
│ │ │ │ +00002f40: 6572 2032 3030 380a 0a20 2020 2020 436f  er 2008..     Co
│ │ │ │ +00002f50: 7079 7269 6768 7420 c2a9 2032 3030 302c  pyright .. 2000,
│ │ │ │ +00002f60: 2032 3030 312c 2032 3030 322c 2032 3030   2001, 2002, 200
│ │ │ │ +00002f70: 372c 2032 3030 3820 4672 6565 2053 6f66  7, 2008 Free Sof
│ │ │ │ +00002f80: 7477 6172 6520 466f 756e 6461 7469 6f6e  tware Foundation
│ │ │ │ +00002f90: 2c20 496e 632e 0a20 2020 2020 3c68 7474  , Inc..     <htt
│ │ │ │ +00002fa0: 7073 3a2f 2f66 7366 2e6f 7267 2f3e 0a0a  ps://fsf.org/>..
│ │ │ │ +00002fb0: 2020 2020 2045 7665 7279 6f6e 6520 6973       Everyone is
│ │ │ │ +00002fc0: 2070 6572 6d69 7474 6564 2074 6f20 636f   permitted to co
│ │ │ │ +00002fd0: 7079 2061 6e64 2064 6973 7472 6962 7574  py and distribut
│ │ │ │ +00002fe0: 6520 7665 7262 6174 696d 2063 6f70 6965  e verbatim copie
│ │ │ │ +00002ff0: 730a 2020 2020 206f 6620 7468 6973 206c  s.     of this l
│ │ │ │ +00003000: 6963 656e 7365 2064 6f63 756d 656e 742c  icense document,
│ │ │ │ +00003010: 2062 7574 2063 6861 6e67 696e 6720 6974   but changing it
│ │ │ │ +00003020: 2069 7320 6e6f 7420 616c 6c6f 7765 642e   is not allowed.
│ │ │ │ +00003030: 0a0a 2020 302e 2050 5245 414d 424c 450a  ..  0. PREAMBLE.
│ │ │ │ +00003040: 0a20 2020 2020 5468 6520 7075 7270 6f73  .     The purpos
│ │ │ │ +00003050: 6520 6f66 2074 6869 7320 4c69 6365 6e73  e of this Licens
│ │ │ │ +00003060: 6520 6973 2074 6f20 6d61 6b65 2061 206d  e is to make a m
│ │ │ │ +00003070: 616e 7561 6c2c 2074 6578 7462 6f6f 6b2c  anual, textbook,
│ │ │ │ +00003080: 206f 7220 6f74 6865 720a 2020 2020 2066   or other.     f
│ │ │ │ +00003090: 756e 6374 696f 6e61 6c20 616e 6420 7573  unctional and us
│ │ │ │ +000030a0: 6566 756c 2064 6f63 756d 656e 7420 e280  eful document ..
│ │ │ │ +000030b0: 9c66 7265 65e2 809d 2069 6e20 7468 6520  .free... in the 
│ │ │ │ +000030c0: 7365 6e73 6520 6f66 2066 7265 6564 6f6d  sense of freedom
│ │ │ │ +000030d0: 3a20 746f 0a20 2020 2020 6173 7375 7265  : to.     assure
│ │ │ │ +000030e0: 2065 7665 7279 6f6e 6520 7468 6520 6566   everyone the ef
│ │ │ │ +000030f0: 6665 6374 6976 6520 6672 6565 646f 6d20  fective freedom 
│ │ │ │ +00003100: 746f 2063 6f70 7920 616e 6420 7265 6469  to copy and redi
│ │ │ │ +00003110: 7374 7269 6275 7465 2069 742c 0a20 2020  stribute it,.   
│ │ │ │ +00003120: 2020 7769 7468 206f 7220 7769 7468 6f75    with or withou
│ │ │ │ +00003130: 7420 6d6f 6469 6679 696e 6720 6974 2c20  t modifying it, 
│ │ │ │ +00003140: 6569 7468 6572 2063 6f6d 6d65 7263 6961  either commercia
│ │ │ │ +00003150: 6c6c 7920 6f72 0a20 2020 2020 6e6f 6e63  lly or.     nonc
│ │ │ │ +00003160: 6f6d 6d65 7263 6961 6c6c 792e 2020 5365  ommercially.  Se
│ │ │ │ +00003170: 636f 6e64 6172 696c 792c 2074 6869 7320  condarily, this 
│ │ │ │ +00003180: 4c69 6365 6e73 6520 7072 6573 6572 7665  License preserve
│ │ │ │ +00003190: 7320 666f 7220 7468 650a 2020 2020 2061  s for the.     a
│ │ │ │ +000031a0: 7574 686f 7220 616e 6420 7075 626c 6973  uthor and publis
│ │ │ │ +000031b0: 6865 7220 6120 7761 7920 746f 2067 6574  her a way to get
│ │ │ │ +000031c0: 2063 7265 6469 7420 666f 7220 7468 6569   credit for thei
│ │ │ │ +000031d0: 7220 776f 726b 2c20 7768 696c 6520 6e6f  r work, while no
│ │ │ │ +000031e0: 740a 2020 2020 2062 6569 6e67 2063 6f6e  t.     being con
│ │ │ │ +000031f0: 7369 6465 7265 6420 7265 7370 6f6e 7369  sidered responsi
│ │ │ │ +00003200: 626c 6520 666f 7220 6d6f 6469 6669 6361  ble for modifica
│ │ │ │ +00003210: 7469 6f6e 7320 6d61 6465 2062 7920 6f74  tions made by ot
│ │ │ │ +00003220: 6865 7273 2e0a 0a20 2020 2020 5468 6973  hers...     This
│ │ │ │ +00003230: 204c 6963 656e 7365 2069 7320 6120 6b69   License is a ki
│ │ │ │ +00003240: 6e64 206f 6620 2263 6f70 796c 6566 7422  nd of "copyleft"
│ │ │ │ +00003250: 2c20 7768 6963 6820 6d65 616e 7320 7468  , which means th
│ │ │ │ +00003260: 6174 2064 6572 6976 6174 6976 650a 2020  at derivative.  
│ │ │ │ +00003270: 2020 2077 6f72 6b73 206f 6620 7468 6520     works of the 
│ │ │ │ +00003280: 646f 6375 6d65 6e74 206d 7573 7420 7468  document must th
│ │ │ │ +00003290: 656d 7365 6c76 6573 2062 6520 6672 6565  emselves be free
│ │ │ │ +000032a0: 2069 6e20 7468 6520 7361 6d65 2073 656e   in the same sen
│ │ │ │ +000032b0: 7365 2e0a 2020 2020 2049 7420 636f 6d70  se..     It comp
│ │ │ │ +000032c0: 6c65 6d65 6e74 7320 7468 6520 474e 5520  lements the GNU 
│ │ │ │ +000032d0: 4765 6e65 7261 6c20 5075 626c 6963 204c  General Public L
│ │ │ │ +000032e0: 6963 656e 7365 2c20 7768 6963 6820 6973  icense, which is
│ │ │ │ +000032f0: 2061 2063 6f70 796c 6566 740a 2020 2020   a copyleft.    
│ │ │ │ +00003300: 206c 6963 656e 7365 2064 6573 6967 6e65   license designe
│ │ │ │ +00003310: 6420 666f 7220 6672 6565 2073 6f66 7477  d for free softw
│ │ │ │ +00003320: 6172 652e 0a0a 2020 2020 2057 6520 6861  are...     We ha
│ │ │ │ +00003330: 7665 2064 6573 6967 6e65 6420 7468 6973  ve designed this
│ │ │ │ +00003340: 204c 6963 656e 7365 2069 6e20 6f72 6465   License in orde
│ │ │ │ +00003350: 7220 746f 2075 7365 2069 7420 666f 7220  r to use it for 
│ │ │ │ +00003360: 6d61 6e75 616c 7320 666f 720a 2020 2020  manuals for.    
│ │ │ │ +00003370: 2066 7265 6520 736f 6674 7761 7265 2c20   free software, 
│ │ │ │ +00003380: 6265 6361 7573 6520 6672 6565 2073 6f66  because free sof
│ │ │ │ +00003390: 7477 6172 6520 6e65 6564 7320 6672 6565  tware needs free
│ │ │ │ +000033a0: 2064 6f63 756d 656e 7461 7469 6f6e 3a20   documentation: 
│ │ │ │ +000033b0: 610a 2020 2020 2066 7265 6520 7072 6f67  a.     free prog
│ │ │ │ +000033c0: 7261 6d20 7368 6f75 6c64 2063 6f6d 6520  ram should come 
│ │ │ │ +000033d0: 7769 7468 206d 616e 7561 6c73 2070 726f  with manuals pro
│ │ │ │ +000033e0: 7669 6469 6e67 2074 6865 2073 616d 6520  viding the same 
│ │ │ │ +000033f0: 6672 6565 646f 6d73 0a20 2020 2020 7468  freedoms.     th
│ │ │ │ +00003400: 6174 2074 6865 2073 6f66 7477 6172 6520  at the software 
│ │ │ │ +00003410: 646f 6573 2e20 2042 7574 2074 6869 7320  does.  But this 
│ │ │ │ +00003420: 4c69 6365 6e73 6520 6973 206e 6f74 206c  License is not l
│ │ │ │ +00003430: 696d 6974 6564 2074 6f0a 2020 2020 2073  imited to.     s
│ │ │ │ +00003440: 6f66 7477 6172 6520 6d61 6e75 616c 733b  oftware manuals;
│ │ │ │ +00003450: 2069 7420 6361 6e20 6265 2075 7365 6420   it can be used 
│ │ │ │ +00003460: 666f 7220 616e 7920 7465 7874 7561 6c20  for any textual 
│ │ │ │ +00003470: 776f 726b 2c20 7265 6761 7264 6c65 7373  work, regardless
│ │ │ │ +00003480: 0a20 2020 2020 6f66 2073 7562 6a65 6374  .     of subject
│ │ │ │ +00003490: 206d 6174 7465 7220 6f72 2077 6865 7468   matter or wheth
│ │ │ │ +000034a0: 6572 2069 7420 6973 2070 7562 6c69 7368  er it is publish
│ │ │ │ +000034b0: 6564 2061 7320 6120 7072 696e 7465 6420  ed as a printed 
│ │ │ │ +000034c0: 626f 6f6b 2e20 2057 650a 2020 2020 2072  book.  We.     r
│ │ │ │ +000034d0: 6563 6f6d 6d65 6e64 2074 6869 7320 4c69  ecommend this Li
│ │ │ │ +000034e0: 6365 6e73 6520 7072 696e 6369 7061 6c6c  cense principall
│ │ │ │ +000034f0: 7920 666f 7220 776f 726b 7320 7768 6f73  y for works whos
│ │ │ │ +00003500: 6520 7075 7270 6f73 6520 6973 0a20 2020  e purpose is.   
│ │ │ │ +00003510: 2020 696e 7374 7275 6374 696f 6e20 6f72    instruction or
│ │ │ │ +00003520: 2072 6566 6572 656e 6365 2e0a 0a20 2031   reference...  1
│ │ │ │ +00003530: 2e20 4150 504c 4943 4142 494c 4954 5920  . APPLICABILITY 
│ │ │ │ +00003540: 414e 4420 4445 4649 4e49 5449 4f4e 530a  AND DEFINITIONS.
│ │ │ │ +00003550: 0a20 2020 2020 5468 6973 204c 6963 656e  .     This Licen
│ │ │ │ +00003560: 7365 2061 7070 6c69 6573 2074 6f20 616e  se applies to an
│ │ │ │ +00003570: 7920 6d61 6e75 616c 206f 7220 6f74 6865  y manual or othe
│ │ │ │ +00003580: 7220 776f 726b 2c20 696e 2061 6e79 206d  r work, in any m
│ │ │ │ +00003590: 6564 6975 6d2c 0a20 2020 2020 7468 6174  edium,.     that
│ │ │ │ +000035a0: 2063 6f6e 7461 696e 7320 6120 6e6f 7469   contains a noti
│ │ │ │ +000035b0: 6365 2070 6c61 6365 6420 6279 2074 6865  ce placed by the
│ │ │ │ +000035c0: 2063 6f70 7972 6967 6874 2068 6f6c 6465   copyright holde
│ │ │ │ +000035d0: 7220 7361 7969 6e67 2069 7420 6361 6e0a  r saying it can.
│ │ │ │ +000035e0: 2020 2020 2062 6520 6469 7374 7269 6275       be distribu
│ │ │ │ +000035f0: 7465 6420 756e 6465 7220 7468 6520 7465  ted under the te
│ │ │ │ +00003600: 726d 7320 6f66 2074 6869 7320 4c69 6365  rms of this Lice
│ │ │ │ +00003610: 6e73 652e 2020 5375 6368 2061 206e 6f74  nse.  Such a not
│ │ │ │ +00003620: 6963 650a 2020 2020 2067 7261 6e74 7320  ice.     grants 
│ │ │ │ +00003630: 6120 776f 726c 642d 7769 6465 2c20 726f  a world-wide, ro
│ │ │ │ +00003640: 7961 6c74 792d 6672 6565 206c 6963 656e  yalty-free licen
│ │ │ │ +00003650: 7365 2c20 756e 6c69 6d69 7465 6420 696e  se, unlimited in
│ │ │ │ +00003660: 2064 7572 6174 696f 6e2c 0a20 2020 2020   duration,.     
│ │ │ │ +00003670: 746f 2075 7365 2074 6861 7420 776f 726b  to use that work
│ │ │ │ +00003680: 2075 6e64 6572 2074 6865 2063 6f6e 6469   under the condi
│ │ │ │ +00003690: 7469 6f6e 7320 7374 6174 6564 2068 6572  tions stated her
│ │ │ │ +000036a0: 6569 6e2e 2020 5468 650a 2020 2020 2022  ein.  The.     "
│ │ │ │ +000036b0: 446f 6375 6d65 6e74 222c 2062 656c 6f77  Document", below
│ │ │ │ +000036c0: 2c20 7265 6665 7273 2074 6f20 616e 7920  , refers to any 
│ │ │ │ +000036d0: 7375 6368 206d 616e 7561 6c20 6f72 2077  such manual or w
│ │ │ │ +000036e0: 6f72 6b2e 2020 416e 7920 6d65 6d62 6572  ork.  Any member
│ │ │ │ +000036f0: 0a20 2020 2020 6f66 2074 6865 2070 7562  .     of the pub
│ │ │ │ +00003700: 6c69 6320 6973 2061 206c 6963 656e 7365  lic is a license
│ │ │ │ +00003710: 652c 2061 6e64 2069 7320 6164 6472 6573  e, and is addres
│ │ │ │ +00003720: 7365 6420 6173 2022 796f 7522 2e20 2059  sed as "you".  Y
│ │ │ │ +00003730: 6f75 2061 6363 6570 740a 2020 2020 2074  ou accept.     t
│ │ │ │ +00003740: 6865 206c 6963 656e 7365 2069 6620 796f  he license if yo
│ │ │ │ +00003750: 7520 636f 7079 2c20 6d6f 6469 6679 206f  u copy, modify o
│ │ │ │ +00003760: 7220 6469 7374 7269 6275 7465 2074 6865  r distribute the
│ │ │ │ +00003770: 2077 6f72 6b20 696e 2061 2077 6179 0a20   work in a way. 
│ │ │ │ +00003780: 2020 2020 7265 7175 6972 696e 6720 7065      requiring pe
│ │ │ │ +00003790: 726d 6973 7369 6f6e 2075 6e64 6572 2063  rmission under c
│ │ │ │ +000037a0: 6f70 7972 6967 6874 206c 6177 2e0a 0a20  opyright law... 
│ │ │ │ +000037b0: 2020 2020 4120 224d 6f64 6966 6965 6420      A "Modified 
│ │ │ │ +000037c0: 5665 7273 696f 6e22 206f 6620 7468 6520  Version" of the 
│ │ │ │ +000037d0: 446f 6375 6d65 6e74 206d 6561 6e73 2061  Document means a
│ │ │ │ +000037e0: 6e79 2077 6f72 6b20 636f 6e74 6169 6e69  ny work containi
│ │ │ │ +000037f0: 6e67 2074 6865 0a20 2020 2020 446f 6375  ng the.     Docu
│ │ │ │ +00003800: 6d65 6e74 206f 7220 6120 706f 7274 696f  ment or a portio
│ │ │ │ +00003810: 6e20 6f66 2069 742c 2065 6974 6865 7220  n of it, either 
│ │ │ │ +00003820: 636f 7069 6564 2076 6572 6261 7469 6d2c  copied verbatim,
│ │ │ │ +00003830: 206f 7220 7769 7468 0a20 2020 2020 6d6f   or with.     mo
│ │ │ │ +00003840: 6469 6669 6361 7469 6f6e 7320 616e 642f  difications and/
│ │ │ │ +00003850: 6f72 2074 7261 6e73 6c61 7465 6420 696e  or translated in
│ │ │ │ +00003860: 746f 2061 6e6f 7468 6572 206c 616e 6775  to another langu
│ │ │ │ +00003870: 6167 652e 0a0a 2020 2020 2041 2022 5365  age...     A "Se
│ │ │ │ +00003880: 636f 6e64 6172 7920 5365 6374 696f 6e22  condary Section"
│ │ │ │ +00003890: 2069 7320 6120 6e61 6d65 6420 6170 7065   is a named appe
│ │ │ │ +000038a0: 6e64 6978 206f 7220 6120 6672 6f6e 742d  ndix or a front-
│ │ │ │ +000038b0: 6d61 7474 6572 2073 6563 7469 6f6e 0a20  matter section. 
│ │ │ │ +000038c0: 2020 2020 6f66 2074 6865 2044 6f63 756d      of the Docum
│ │ │ │ +000038d0: 656e 7420 7468 6174 2064 6561 6c73 2065  ent that deals e
│ │ │ │ +000038e0: 7863 6c75 7369 7665 6c79 2077 6974 6820  xclusively with 
│ │ │ │ +000038f0: 7468 6520 7265 6c61 7469 6f6e 7368 6970  the relationship
│ │ │ │ +00003900: 206f 6620 7468 650a 2020 2020 2070 7562   of the.     pub
│ │ │ │ +00003910: 6c69 7368 6572 7320 6f72 2061 7574 686f  lishers or autho
│ │ │ │ +00003920: 7273 206f 6620 7468 6520 446f 6375 6d65  rs of the Docume
│ │ │ │ +00003930: 6e74 2074 6f20 7468 6520 446f 6375 6d65  nt to the Docume
│ │ │ │ +00003940: 6e74 2773 206f 7665 7261 6c6c 0a20 2020  nt's overall.   
│ │ │ │ +00003950: 2020 7375 626a 6563 7420 286f 7220 746f    subject (or to
│ │ │ │ +00003960: 2072 656c 6174 6564 206d 6174 7465 7273   related matters
│ │ │ │ +00003970: 2920 616e 6420 636f 6e74 6169 6e73 206e  ) and contains n
│ │ │ │ +00003980: 6f74 6869 6e67 2074 6861 7420 636f 756c  othing that coul
│ │ │ │ +00003990: 640a 2020 2020 2066 616c 6c20 6469 7265  d.     fall dire
│ │ │ │ +000039a0: 6374 6c79 2077 6974 6869 6e20 7468 6174  ctly within that
│ │ │ │ +000039b0: 206f 7665 7261 6c6c 2073 7562 6a65 6374   overall subject
│ │ │ │ +000039c0: 2e20 2028 5468 7573 2c20 6966 2074 6865  .  (Thus, if the
│ │ │ │ +000039d0: 2044 6f63 756d 656e 740a 2020 2020 2069   Document.     i
│ │ │ │ +000039e0: 7320 696e 2070 6172 7420 6120 7465 7874  s in part a text
│ │ │ │ +000039f0: 626f 6f6b 206f 6620 6d61 7468 656d 6174  book of mathemat
│ │ │ │ +00003a00: 6963 732c 2061 2053 6563 6f6e 6461 7279  ics, a Secondary
│ │ │ │ +00003a10: 2053 6563 7469 6f6e 206d 6179 206e 6f74   Section may not
│ │ │ │ +00003a20: 0a20 2020 2020 6578 706c 6169 6e20 616e  .     explain an
│ │ │ │ +00003a30: 7920 6d61 7468 656d 6174 6963 732e 2920  y mathematics.) 
│ │ │ │ +00003a40: 2054 6865 2072 656c 6174 696f 6e73 6869   The relationshi
│ │ │ │ +00003a50: 7020 636f 756c 6420 6265 2061 206d 6174  p could be a mat
│ │ │ │ +00003a60: 7465 7220 6f66 0a20 2020 2020 6869 7374  ter of.     hist
│ │ │ │ +00003a70: 6f72 6963 616c 2063 6f6e 6e65 6374 696f  orical connectio
│ │ │ │ +00003a80: 6e20 7769 7468 2074 6865 2073 7562 6a65  n with the subje
│ │ │ │ +00003a90: 6374 206f 7220 7769 7468 2072 656c 6174  ct or with relat
│ │ │ │ +00003aa0: 6564 206d 6174 7465 7273 2c20 6f72 0a20  ed matters, or. 
│ │ │ │ +00003ab0: 2020 2020 6f66 206c 6567 616c 2c20 636f      of legal, co
│ │ │ │ +00003ac0: 6d6d 6572 6369 616c 2c20 7068 696c 6f73  mmercial, philos
│ │ │ │ +00003ad0: 6f70 6869 6361 6c2c 2065 7468 6963 616c  ophical, ethical
│ │ │ │ +00003ae0: 206f 7220 706f 6c69 7469 6361 6c20 706f   or political po
│ │ │ │ +00003af0: 7369 7469 6f6e 0a20 2020 2020 7265 6761  sition.     rega
│ │ │ │ +00003b00: 7264 696e 6720 7468 656d 2e0a 0a20 2020  rding them...   
│ │ │ │ +00003b10: 2020 5468 6520 2249 6e76 6172 6961 6e74    The "Invariant
│ │ │ │ +00003b20: 2053 6563 7469 6f6e 7322 2061 7265 2063   Sections" are c
│ │ │ │ +00003b30: 6572 7461 696e 2053 6563 6f6e 6461 7279  ertain Secondary
│ │ │ │ +00003b40: 2053 6563 7469 6f6e 7320 7768 6f73 650a   Sections whose.
│ │ │ │ +00003b50: 2020 2020 2074 6974 6c65 7320 6172 6520       titles are 
│ │ │ │ +00003b60: 6465 7369 676e 6174 6564 2c20 6173 2062  designated, as b
│ │ │ │ +00003b70: 6569 6e67 2074 686f 7365 206f 6620 496e  eing those of In
│ │ │ │ +00003b80: 7661 7269 616e 7420 5365 6374 696f 6e73  variant Sections
│ │ │ │ +00003b90: 2c20 696e 2074 6865 0a20 2020 2020 6e6f  , in the.     no
│ │ │ │ +00003ba0: 7469 6365 2074 6861 7420 7361 7973 2074  tice that says t
│ │ │ │ +00003bb0: 6861 7420 7468 6520 446f 6375 6d65 6e74  hat the Document
│ │ │ │ +00003bc0: 2069 7320 7265 6c65 6173 6564 2075 6e64   is released und
│ │ │ │ +00003bd0: 6572 2074 6869 7320 4c69 6365 6e73 652e  er this License.
│ │ │ │ +00003be0: 0a20 2020 2020 4966 2061 2073 6563 7469  .     If a secti
│ │ │ │ +00003bf0: 6f6e 2064 6f65 7320 6e6f 7420 6669 7420  on does not fit 
│ │ │ │ +00003c00: 7468 6520 6162 6f76 6520 6465 6669 6e69  the above defini
│ │ │ │ +00003c10: 7469 6f6e 206f 6620 5365 636f 6e64 6172  tion of Secondar
│ │ │ │ +00003c20: 7920 7468 656e 2069 740a 2020 2020 2069  y then it.     i
│ │ │ │ +00003c30: 7320 6e6f 7420 616c 6c6f 7765 6420 746f  s not allowed to
│ │ │ │ +00003c40: 2062 6520 6465 7369 676e 6174 6564 2061   be designated a
│ │ │ │ +00003c50: 7320 496e 7661 7269 616e 742e 2020 5468  s Invariant.  Th
│ │ │ │ +00003c60: 6520 446f 6375 6d65 6e74 206d 6179 0a20  e Document may. 
│ │ │ │ +00003c70: 2020 2020 636f 6e74 6169 6e20 7a65 726f      contain zero
│ │ │ │ +00003c80: 2049 6e76 6172 6961 6e74 2053 6563 7469   Invariant Secti
│ │ │ │ +00003c90: 6f6e 732e 2020 4966 2074 6865 2044 6f63  ons.  If the Doc
│ │ │ │ +00003ca0: 756d 656e 7420 646f 6573 206e 6f74 2069  ument does not i
│ │ │ │ +00003cb0: 6465 6e74 6966 790a 2020 2020 2061 6e79  dentify.     any
│ │ │ │ +00003cc0: 2049 6e76 6172 6961 6e74 2053 6563 7469   Invariant Secti
│ │ │ │ +00003cd0: 6f6e 7320 7468 656e 2074 6865 7265 2061  ons then there a
│ │ │ │ +00003ce0: 7265 206e 6f6e 652e 0a0a 2020 2020 2054  re none...     T
│ │ │ │ +00003cf0: 6865 2022 436f 7665 7220 5465 7874 7322  he "Cover Texts"
│ │ │ │ +00003d00: 2061 7265 2063 6572 7461 696e 2073 686f   are certain sho
│ │ │ │ +00003d10: 7274 2070 6173 7361 6765 7320 6f66 2074  rt passages of t
│ │ │ │ +00003d20: 6578 7420 7468 6174 2061 7265 0a20 2020  ext that are.   
│ │ │ │ +00003d30: 2020 6c69 7374 6564 2c20 6173 2046 726f    listed, as Fro
│ │ │ │ +00003d40: 6e74 2d43 6f76 6572 2054 6578 7473 206f  nt-Cover Texts o
│ │ │ │ +00003d50: 7220 4261 636b 2d43 6f76 6572 2054 6578  r Back-Cover Tex
│ │ │ │ +00003d60: 7473 2c20 696e 2074 6865 206e 6f74 6963  ts, in the notic
│ │ │ │ +00003d70: 650a 2020 2020 2074 6861 7420 7361 7973  e.     that says
│ │ │ │ +00003d80: 2074 6861 7420 7468 6520 446f 6375 6d65   that the Docume
│ │ │ │ +00003d90: 6e74 2069 7320 7265 6c65 6173 6564 2075  nt is released u
│ │ │ │ +00003da0: 6e64 6572 2074 6869 7320 4c69 6365 6e73  nder this Licens
│ │ │ │ +00003db0: 652e 2020 410a 2020 2020 2046 726f 6e74  e.  A.     Front
│ │ │ │ +00003dc0: 2d43 6f76 6572 2054 6578 7420 6d61 7920  -Cover Text may 
│ │ │ │ +00003dd0: 6265 2061 7420 6d6f 7374 2035 2077 6f72  be at most 5 wor
│ │ │ │ +00003de0: 6473 2c20 616e 6420 6120 4261 636b 2d43  ds, and a Back-C
│ │ │ │ +00003df0: 6f76 6572 2054 6578 7420 6d61 790a 2020  over Text may.  
│ │ │ │ +00003e00: 2020 2062 6520 6174 206d 6f73 7420 3235     be at most 25
│ │ │ │ +00003e10: 2077 6f72 6473 2e0a 0a20 2020 2020 4120   words...     A 
│ │ │ │ +00003e20: 2254 7261 6e73 7061 7265 6e74 2220 636f  "Transparent" co
│ │ │ │ +00003e30: 7079 206f 6620 7468 6520 446f 6375 6d65  py of the Docume
│ │ │ │ +00003e40: 6e74 206d 6561 6e73 2061 206d 6163 6869  nt means a machi
│ │ │ │ +00003e50: 6e65 2d72 6561 6461 626c 6520 636f 7079  ne-readable copy
│ │ │ │ +00003e60: 2c0a 2020 2020 2072 6570 7265 7365 6e74  ,.     represent
│ │ │ │ +00003e70: 6564 2069 6e20 6120 666f 726d 6174 2077  ed in a format w
│ │ │ │ +00003e80: 686f 7365 2073 7065 6369 6669 6361 7469  hose specificati
│ │ │ │ +00003e90: 6f6e 2069 7320 6176 6169 6c61 626c 6520  on is available 
│ │ │ │ +00003ea0: 746f 2074 6865 0a20 2020 2020 6765 6e65  to the.     gene
│ │ │ │ +00003eb0: 7261 6c20 7075 626c 6963 2c20 7468 6174  ral public, that
│ │ │ │ +00003ec0: 2069 7320 7375 6974 6162 6c65 2066 6f72   is suitable for
│ │ │ │ +00003ed0: 2072 6576 6973 696e 6720 7468 6520 646f   revising the do
│ │ │ │ +00003ee0: 6375 6d65 6e74 0a20 2020 2020 7374 7261  cument.     stra
│ │ │ │ +00003ef0: 6967 6874 666f 7277 6172 646c 7920 7769  ightforwardly wi
│ │ │ │ +00003f00: 7468 2067 656e 6572 6963 2074 6578 7420  th generic text 
│ │ │ │ +00003f10: 6564 6974 6f72 7320 6f72 2028 666f 7220  editors or (for 
│ │ │ │ +00003f20: 696d 6167 6573 2063 6f6d 706f 7365 640a  images composed.
│ │ │ │ +00003f30: 2020 2020 206f 6620 7069 7865 6c73 2920       of pixels) 
│ │ │ │ +00003f40: 6765 6e65 7269 6320 7061 696e 7420 7072  generic paint pr
│ │ │ │ +00003f50: 6f67 7261 6d73 206f 7220 2866 6f72 2064  ograms or (for d
│ │ │ │ +00003f60: 7261 7769 6e67 7329 2073 6f6d 6520 7769  rawings) some wi
│ │ │ │ +00003f70: 6465 6c79 0a20 2020 2020 6176 6169 6c61  dely.     availa
│ │ │ │ +00003f80: 626c 6520 6472 6177 696e 6720 6564 6974  ble drawing edit
│ │ │ │ +00003f90: 6f72 2c20 616e 6420 7468 6174 2069 7320  or, and that is 
│ │ │ │ +00003fa0: 7375 6974 6162 6c65 2066 6f72 2069 6e70  suitable for inp
│ │ │ │ +00003fb0: 7574 2074 6f20 7465 7874 0a20 2020 2020  ut to text.     
│ │ │ │ +00003fc0: 666f 726d 6174 7465 7273 206f 7220 666f  formatters or fo
│ │ │ │ +00003fd0: 7220 6175 746f 6d61 7469 6320 7472 616e  r automatic tran
│ │ │ │ +00003fe0: 736c 6174 696f 6e20 746f 2061 2076 6172  slation to a var
│ │ │ │ +00003ff0: 6965 7479 206f 6620 666f 726d 6174 730a  iety of formats.
│ │ │ │ +00004000: 2020 2020 2073 7569 7461 626c 6520 666f       suitable fo
│ │ │ │ +00004010: 7220 696e 7075 7420 746f 2074 6578 7420  r input to text 
│ │ │ │ +00004020: 666f 726d 6174 7465 7273 2e20 2041 2063  formatters.  A c
│ │ │ │ +00004030: 6f70 7920 6d61 6465 2069 6e20 616e 206f  opy made in an o
│ │ │ │ +00004040: 7468 6572 7769 7365 0a20 2020 2020 5472  therwise.     Tr
│ │ │ │ +00004050: 616e 7370 6172 656e 7420 6669 6c65 2066  ansparent file f
│ │ │ │ +00004060: 6f72 6d61 7420 7768 6f73 6520 6d61 726b  ormat whose mark
│ │ │ │ +00004070: 7570 2c20 6f72 2061 6273 656e 6365 206f  up, or absence o
│ │ │ │ +00004080: 6620 6d61 726b 7570 2c20 6861 730a 2020  f markup, has.  
│ │ │ │ +00004090: 2020 2062 6565 6e20 6172 7261 6e67 6564     been arranged
│ │ │ │ +000040a0: 2074 6f20 7468 7761 7274 206f 7220 6469   to thwart or di
│ │ │ │ +000040b0: 7363 6f75 7261 6765 2073 7562 7365 7175  scourage subsequ
│ │ │ │ +000040c0: 656e 7420 6d6f 6469 6669 6361 7469 6f6e  ent modification
│ │ │ │ +000040d0: 2062 790a 2020 2020 2072 6561 6465 7273   by.     readers
│ │ │ │ +000040e0: 2069 7320 6e6f 7420 5472 616e 7370 6172   is not Transpar
│ │ │ │ +000040f0: 656e 742e 2020 416e 2069 6d61 6765 2066  ent.  An image f
│ │ │ │ +00004100: 6f72 6d61 7420 6973 206e 6f74 2054 7261  ormat is not Tra
│ │ │ │ +00004110: 6e73 7061 7265 6e74 2069 660a 2020 2020  nsparent if.    
│ │ │ │ +00004120: 2075 7365 6420 666f 7220 616e 7920 7375   used for any su
│ │ │ │ +00004130: 6273 7461 6e74 6961 6c20 616d 6f75 6e74  bstantial amount
│ │ │ │ +00004140: 206f 6620 7465 7874 2e20 2041 2063 6f70   of text.  A cop
│ │ │ │ +00004150: 7920 7468 6174 2069 7320 6e6f 740a 2020  y that is not.  
│ │ │ │ +00004160: 2020 2022 5472 616e 7370 6172 656e 7422     "Transparent"
│ │ │ │ +00004170: 2069 7320 6361 6c6c 6564 2022 4f70 6171   is called "Opaq
│ │ │ │ +00004180: 7565 222e 0a0a 2020 2020 2045 7861 6d70  ue"...     Examp
│ │ │ │ +00004190: 6c65 7320 6f66 2073 7569 7461 626c 6520  les of suitable 
│ │ │ │ +000041a0: 666f 726d 6174 7320 666f 7220 5472 616e  formats for Tran
│ │ │ │ +000041b0: 7370 6172 656e 7420 636f 7069 6573 2069  sparent copies i
│ │ │ │ +000041c0: 6e63 6c75 6465 2070 6c61 696e 0a20 2020  nclude plain.   
│ │ │ │ +000041d0: 2020 4153 4349 4920 7769 7468 6f75 7420    ASCII without 
│ │ │ │ +000041e0: 6d61 726b 7570 2c20 5465 7869 6e66 6f20  markup, Texinfo 
│ │ │ │ +000041f0: 696e 7075 7420 666f 726d 6174 2c20 4c61  input format, La
│ │ │ │ +00004200: 5465 5820 696e 7075 7420 666f 726d 6174  TeX input format
│ │ │ │ +00004210: 2c0a 2020 2020 2053 474d 4c20 6f72 2058  ,.     SGML or X
│ │ │ │ +00004220: 4d4c 2075 7369 6e67 2061 2070 7562 6c69  ML using a publi
│ │ │ │ +00004230: 636c 7920 6176 6169 6c61 626c 6520 4454  cly available DT
│ │ │ │ +00004240: 442c 2061 6e64 2073 7461 6e64 6172 642d  D, and standard-
│ │ │ │ +00004250: 636f 6e66 6f72 6d69 6e67 0a20 2020 2020  conforming.     
│ │ │ │ +00004260: 7369 6d70 6c65 2048 544d 4c2c 2050 6f73  simple HTML, Pos
│ │ │ │ +00004270: 7453 6372 6970 7420 6f72 2050 4446 2064  tScript or PDF d
│ │ │ │ +00004280: 6573 6967 6e65 6420 666f 7220 6875 6d61  esigned for huma
│ │ │ │ +00004290: 6e20 6d6f 6469 6669 6361 7469 6f6e 2e0a  n modification..
│ │ │ │ +000042a0: 2020 2020 2045 7861 6d70 6c65 7320 6f66       Examples of
│ │ │ │ +000042b0: 2074 7261 6e73 7061 7265 6e74 2069 6d61   transparent ima
│ │ │ │ +000042c0: 6765 2066 6f72 6d61 7473 2069 6e63 6c75  ge formats inclu
│ │ │ │ +000042d0: 6465 2050 4e47 2c20 5843 4620 616e 6420  de PNG, XCF and 
│ │ │ │ +000042e0: 4a50 472e 0a20 2020 2020 4f70 6171 7565  JPG..     Opaque
│ │ │ │ +000042f0: 2066 6f72 6d61 7473 2069 6e63 6c75 6465   formats include
│ │ │ │ +00004300: 2070 726f 7072 6965 7461 7279 2066 6f72   proprietary for
│ │ │ │ +00004310: 6d61 7473 2074 6861 7420 6361 6e20 6265  mats that can be
│ │ │ │ +00004320: 2072 6561 6420 616e 640a 2020 2020 2065   read and.     e
│ │ │ │ +00004330: 6469 7465 6420 6f6e 6c79 2062 7920 7072  dited only by pr
│ │ │ │ +00004340: 6f70 7269 6574 6172 7920 776f 7264 2070  oprietary word p
│ │ │ │ +00004350: 726f 6365 7373 6f72 732c 2053 474d 4c20  rocessors, SGML 
│ │ │ │ +00004360: 6f72 2058 4d4c 2066 6f72 2077 6869 6368  or XML for which
│ │ │ │ +00004370: 0a20 2020 2020 7468 6520 4454 4420 616e  .     the DTD an
│ │ │ │ +00004380: 642f 6f72 2070 726f 6365 7373 696e 6720  d/or processing 
│ │ │ │ +00004390: 746f 6f6c 7320 6172 6520 6e6f 7420 6765  tools are not ge
│ │ │ │ +000043a0: 6e65 7261 6c6c 7920 6176 6169 6c61 626c  nerally availabl
│ │ │ │ +000043b0: 652c 2061 6e64 0a20 2020 2020 7468 6520  e, and.     the 
│ │ │ │ +000043c0: 6d61 6368 696e 652d 6765 6e65 7261 7465  machine-generate
│ │ │ │ +000043d0: 6420 4854 4d4c 2c20 506f 7374 5363 7269  d HTML, PostScri
│ │ │ │ +000043e0: 7074 206f 7220 5044 4620 7072 6f64 7563  pt or PDF produc
│ │ │ │ +000043f0: 6564 2062 7920 736f 6d65 2077 6f72 640a  ed by some word.
│ │ │ │ +00004400: 2020 2020 2070 726f 6365 7373 6f72 7320       processors 
│ │ │ │ +00004410: 666f 7220 6f75 7470 7574 2070 7572 706f  for output purpo
│ │ │ │ +00004420: 7365 7320 6f6e 6c79 2e0a 0a20 2020 2020  ses only...     
│ │ │ │ +00004430: 5468 6520 2254 6974 6c65 2050 6167 6522  The "Title Page"
│ │ │ │ +00004440: 206d 6561 6e73 2c20 666f 7220 6120 7072   means, for a pr
│ │ │ │ +00004450: 696e 7465 6420 626f 6f6b 2c20 7468 6520  inted book, the 
│ │ │ │ +00004460: 7469 746c 6520 7061 6765 2069 7473 656c  title page itsel
│ │ │ │ +00004470: 662c 0a20 2020 2020 706c 7573 2073 7563  f,.     plus suc
│ │ │ │ +00004480: 6820 666f 6c6c 6f77 696e 6720 7061 6765  h following page
│ │ │ │ +00004490: 7320 6173 2061 7265 206e 6565 6465 6420  s as are needed 
│ │ │ │ +000044a0: 746f 2068 6f6c 642c 206c 6567 6962 6c79  to hold, legibly
│ │ │ │ +000044b0: 2c20 7468 650a 2020 2020 206d 6174 6572  , the.     mater
│ │ │ │ +000044c0: 6961 6c20 7468 6973 204c 6963 656e 7365  ial this License
│ │ │ │ +000044d0: 2072 6571 7569 7265 7320 746f 2061 7070   requires to app
│ │ │ │ +000044e0: 6561 7220 696e 2074 6865 2074 6974 6c65  ear in the title
│ │ │ │ +000044f0: 2070 6167 652e 2020 466f 720a 2020 2020   page.  For.    
│ │ │ │ +00004500: 2077 6f72 6b73 2069 6e20 666f 726d 6174   works in format
│ │ │ │ +00004510: 7320 7768 6963 6820 646f 206e 6f74 2068  s which do not h
│ │ │ │ +00004520: 6176 6520 616e 7920 7469 746c 6520 7061  ave any title pa
│ │ │ │ +00004530: 6765 2061 7320 7375 6368 2c20 2254 6974  ge as such, "Tit
│ │ │ │ +00004540: 6c65 0a20 2020 2020 5061 6765 2220 6d65  le.     Page" me
│ │ │ │ +00004550: 616e 7320 7468 6520 7465 7874 206e 6561  ans the text nea
│ │ │ │ +00004560: 7220 7468 6520 6d6f 7374 2070 726f 6d69  r the most promi
│ │ │ │ +00004570: 6e65 6e74 2061 7070 6561 7261 6e63 6520  nent appearance 
│ │ │ │ +00004580: 6f66 2074 6865 0a20 2020 2020 776f 726b  of the.     work
│ │ │ │ +00004590: 2773 2074 6974 6c65 2c20 7072 6563 6564  's title, preced
│ │ │ │ +000045a0: 696e 6720 7468 6520 6265 6769 6e6e 696e  ing the beginnin
│ │ │ │ +000045b0: 6720 6f66 2074 6865 2062 6f64 7920 6f66  g of the body of
│ │ │ │ +000045c0: 2074 6865 2074 6578 742e 0a0a 2020 2020   the text...    
│ │ │ │ +000045d0: 2054 6865 2022 7075 626c 6973 6865 7222   The "publisher"
│ │ │ │ +000045e0: 206d 6561 6e73 2061 6e79 2070 6572 736f   means any perso
│ │ │ │ +000045f0: 6e20 6f72 2065 6e74 6974 7920 7468 6174  n or entity that
│ │ │ │ +00004600: 2064 6973 7472 6962 7574 6573 2063 6f70   distributes cop
│ │ │ │ +00004610: 6965 730a 2020 2020 206f 6620 7468 6520  ies.     of the 
│ │ │ │ +00004620: 446f 6375 6d65 6e74 2074 6f20 7468 6520  Document to the 
│ │ │ │ +00004630: 7075 626c 6963 2e0a 0a20 2020 2020 4120  public...     A 
│ │ │ │ +00004640: 7365 6374 696f 6e20 2245 6e74 6974 6c65  section "Entitle
│ │ │ │ +00004650: 6420 5859 5a22 206d 6561 6e73 2061 206e  d XYZ" means a n
│ │ │ │ +00004660: 616d 6564 2073 7562 756e 6974 206f 6620  amed subunit of 
│ │ │ │ +00004670: 7468 6520 446f 6375 6d65 6e74 0a20 2020  the Document.   
│ │ │ │ +00004680: 2020 7768 6f73 6520 7469 746c 6520 6569    whose title ei
│ │ │ │ +00004690: 7468 6572 2069 7320 7072 6563 6973 656c  ther is precisel
│ │ │ │ +000046a0: 7920 5859 5a20 6f72 2063 6f6e 7461 696e  y XYZ or contain
│ │ │ │ +000046b0: 7320 5859 5a20 696e 2070 6172 656e 7468  s XYZ in parenth
│ │ │ │ +000046c0: 6573 6573 0a20 2020 2020 666f 6c6c 6f77  eses.     follow
│ │ │ │ +000046d0: 696e 6720 7465 7874 2074 6861 7420 7472  ing text that tr
│ │ │ │ +000046e0: 616e 736c 6174 6573 2058 595a 2069 6e20  anslates XYZ in 
│ │ │ │ +000046f0: 616e 6f74 6865 7220 6c61 6e67 7561 6765  another language
│ │ │ │ +00004700: 2e20 2028 4865 7265 2058 595a 0a20 2020  .  (Here XYZ.   
│ │ │ │ +00004710: 2020 7374 616e 6473 2066 6f72 2061 2073    stands for a s
│ │ │ │ +00004720: 7065 6369 6669 6320 7365 6374 696f 6e20  pecific section 
│ │ │ │ +00004730: 6e61 6d65 206d 656e 7469 6f6e 6564 2062  name mentioned b
│ │ │ │ +00004740: 656c 6f77 2c20 7375 6368 2061 730a 2020  elow, such as.  
│ │ │ │ +00004750: 2020 2022 4163 6b6e 6f77 6c65 6467 656d     "Acknowledgem
│ │ │ │ +00004760: 656e 7473 222c 2022 4465 6469 6361 7469  ents", "Dedicati
│ │ │ │ +00004770: 6f6e 7322 2c20 2245 6e64 6f72 7365 6d65  ons", "Endorseme
│ │ │ │ +00004780: 6e74 7322 2c20 6f72 2022 4869 7374 6f72  nts", or "Histor
│ │ │ │ +00004790: 7922 2e29 0a20 2020 2020 546f 2022 5072  y".).     To "Pr
│ │ │ │ +000047a0: 6573 6572 7665 2074 6865 2054 6974 6c65  eserve the Title
│ │ │ │ +000047b0: 2220 6f66 2073 7563 6820 6120 7365 6374  " of such a sect
│ │ │ │ +000047c0: 696f 6e20 7768 656e 2079 6f75 206d 6f64  ion when you mod
│ │ │ │ +000047d0: 6966 7920 7468 650a 2020 2020 2044 6f63  ify the.     Doc
│ │ │ │ +000047e0: 756d 656e 7420 6d65 616e 7320 7468 6174  ument means that
│ │ │ │ +000047f0: 2069 7420 7265 6d61 696e 7320 6120 7365   it remains a se
│ │ │ │ +00004800: 6374 696f 6e20 2245 6e74 6974 6c65 6420  ction "Entitled 
│ │ │ │ +00004810: 5859 5a22 2061 6363 6f72 6469 6e67 0a20  XYZ" according. 
│ │ │ │ +00004820: 2020 2020 746f 2074 6869 7320 6465 6669      to this defi
│ │ │ │ +00004830: 6e69 7469 6f6e 2e0a 0a20 2020 2020 5468  nition...     Th
│ │ │ │ +00004840: 6520 446f 6375 6d65 6e74 206d 6179 2069  e Document may i
│ │ │ │ +00004850: 6e63 6c75 6465 2057 6172 7261 6e74 7920  nclude Warranty 
│ │ │ │ +00004860: 4469 7363 6c61 696d 6572 7320 6e65 7874  Disclaimers next
│ │ │ │ +00004870: 2074 6f20 7468 6520 6e6f 7469 6365 0a20   to the notice. 
│ │ │ │ +00004880: 2020 2020 7768 6963 6820 7374 6174 6573      which states
│ │ │ │ +00004890: 2074 6861 7420 7468 6973 204c 6963 656e   that this Licen
│ │ │ │ +000048a0: 7365 2061 7070 6c69 6573 2074 6f20 7468  se applies to th
│ │ │ │ +000048b0: 6520 446f 6375 6d65 6e74 2e20 2054 6865  e Document.  The
│ │ │ │ +000048c0: 7365 0a20 2020 2020 5761 7272 616e 7479  se.     Warranty
│ │ │ │ +000048d0: 2044 6973 636c 6169 6d65 7273 2061 7265   Disclaimers are
│ │ │ │ +000048e0: 2063 6f6e 7369 6465 7265 6420 746f 2062   considered to b
│ │ │ │ +000048f0: 6520 696e 636c 7564 6564 2062 7920 7265  e included by re
│ │ │ │ +00004900: 6665 7265 6e63 6520 696e 0a20 2020 2020  ference in.     
│ │ │ │ +00004910: 7468 6973 204c 6963 656e 7365 2c20 6275  this License, bu
│ │ │ │ +00004920: 7420 6f6e 6c79 2061 7320 7265 6761 7264  t only as regard
│ │ │ │ +00004930: 7320 6469 7363 6c61 696d 696e 6720 7761  s disclaiming wa
│ │ │ │ +00004940: 7272 616e 7469 6573 3a20 616e 7920 6f74  rranties: any ot
│ │ │ │ +00004950: 6865 720a 2020 2020 2069 6d70 6c69 6361  her.     implica
│ │ │ │ +00004960: 7469 6f6e 2074 6861 7420 7468 6573 6520  tion that these 
│ │ │ │ +00004970: 5761 7272 616e 7479 2044 6973 636c 6169  Warranty Disclai
│ │ │ │ +00004980: 6d65 7273 206d 6179 2068 6176 6520 6973  mers may have is
│ │ │ │ +00004990: 2076 6f69 6420 616e 640a 2020 2020 2068   void and.     h
│ │ │ │ +000049a0: 6173 206e 6f20 6566 6665 6374 206f 6e20  as no effect on 
│ │ │ │ +000049b0: 7468 6520 6d65 616e 696e 6720 6f66 2074  the meaning of t
│ │ │ │ +000049c0: 6869 7320 4c69 6365 6e73 652e 0a0a 2020  his License...  
│ │ │ │ +000049d0: 322e 2056 4552 4241 5449 4d20 434f 5059  2. VERBATIM COPY
│ │ │ │ +000049e0: 494e 470a 0a20 2020 2020 596f 7520 6d61  ING..     You ma
│ │ │ │ +000049f0: 7920 636f 7079 2061 6e64 2064 6973 7472  y copy and distr
│ │ │ │ +00004a00: 6962 7574 6520 7468 6520 446f 6375 6d65  ibute the Docume
│ │ │ │ +00004a10: 6e74 2069 6e20 616e 7920 6d65 6469 756d  nt in any medium
│ │ │ │ +00004a20: 2c20 6569 7468 6572 0a20 2020 2020 636f  , either.     co
│ │ │ │ +00004a30: 6d6d 6572 6369 616c 6c79 206f 7220 6e6f  mmercially or no
│ │ │ │ +00004a40: 6e63 6f6d 6d65 7263 6961 6c6c 792c 2070  ncommercially, p
│ │ │ │ +00004a50: 726f 7669 6465 6420 7468 6174 2074 6869  rovided that thi
│ │ │ │ +00004a60: 7320 4c69 6365 6e73 652c 2074 6865 0a20  s License, the. 
│ │ │ │ +00004a70: 2020 2020 636f 7079 7269 6768 7420 6e6f      copyright no
│ │ │ │ +00004a80: 7469 6365 732c 2061 6e64 2074 6865 206c  tices, and the l
│ │ │ │ +00004a90: 6963 656e 7365 206e 6f74 6963 6520 7361  icense notice sa
│ │ │ │ +00004aa0: 7969 6e67 2074 6869 7320 4c69 6365 6e73  ying this Licens
│ │ │ │ +00004ab0: 650a 2020 2020 2061 7070 6c69 6573 2074  e.     applies t
│ │ │ │ +00004ac0: 6f20 7468 6520 446f 6375 6d65 6e74 2061  o the Document a
│ │ │ │ +00004ad0: 7265 2072 6570 726f 6475 6365 6420 696e  re reproduced in
│ │ │ │ +00004ae0: 2061 6c6c 2063 6f70 6965 732c 2061 6e64   all copies, and
│ │ │ │ +00004af0: 2074 6861 7420 796f 750a 2020 2020 2061   that you.     a
│ │ │ │ +00004b00: 6464 206e 6f20 6f74 6865 7220 636f 6e64  dd no other cond
│ │ │ │ +00004b10: 6974 696f 6e73 2077 6861 7473 6f65 7665  itions whatsoeve
│ │ │ │ +00004b20: 7220 746f 2074 686f 7365 206f 6620 7468  r to those of th
│ │ │ │ +00004b30: 6973 204c 6963 656e 7365 2e20 2059 6f75  is License.  You
│ │ │ │ +00004b40: 0a20 2020 2020 6d61 7920 6e6f 7420 7573  .     may not us
│ │ │ │ +00004b50: 6520 7465 6368 6e69 6361 6c20 6d65 6173  e technical meas
│ │ │ │ +00004b60: 7572 6573 2074 6f20 6f62 7374 7275 6374  ures to obstruct
│ │ │ │ +00004b70: 206f 7220 636f 6e74 726f 6c20 7468 6520   or control the 
│ │ │ │ +00004b80: 7265 6164 696e 670a 2020 2020 206f 7220  reading.     or 
│ │ │ │ +00004b90: 6675 7274 6865 7220 636f 7079 696e 6720  further copying 
│ │ │ │ +00004ba0: 6f66 2074 6865 2063 6f70 6965 7320 796f  of the copies yo
│ │ │ │ +00004bb0: 7520 6d61 6b65 206f 7220 6469 7374 7269  u make or distri
│ │ │ │ +00004bc0: 6275 7465 2e20 2048 6f77 6576 6572 2c0a  bute.  However,.
│ │ │ │ +00004bd0: 2020 2020 2079 6f75 206d 6179 2061 6363       you may acc
│ │ │ │ +00004be0: 6570 7420 636f 6d70 656e 7361 7469 6f6e  ept compensation
│ │ │ │ +00004bf0: 2069 6e20 6578 6368 616e 6765 2066 6f72   in exchange for
│ │ │ │ +00004c00: 2063 6f70 6965 732e 2020 4966 2079 6f75   copies.  If you
│ │ │ │ +00004c10: 0a20 2020 2020 6469 7374 7269 6275 7465  .     distribute
│ │ │ │ +00004c20: 2061 206c 6172 6765 2065 6e6f 7567 6820   a large enough 
│ │ │ │ +00004c30: 6e75 6d62 6572 206f 6620 636f 7069 6573  number of copies
│ │ │ │ +00004c40: 2079 6f75 206d 7573 7420 616c 736f 2066   you must also f
│ │ │ │ +00004c50: 6f6c 6c6f 7720 7468 650a 2020 2020 2063  ollow the.     c
│ │ │ │ +00004c60: 6f6e 6469 7469 6f6e 7320 696e 2073 6563  onditions in sec
│ │ │ │ +00004c70: 7469 6f6e 2033 2e0a 0a20 2020 2020 596f  tion 3...     Yo
│ │ │ │ +00004c80: 7520 6d61 7920 616c 736f 206c 656e 6420  u may also lend 
│ │ │ │ +00004c90: 636f 7069 6573 2c20 756e 6465 7220 7468  copies, under th
│ │ │ │ +00004ca0: 6520 7361 6d65 2063 6f6e 6469 7469 6f6e  e same condition
│ │ │ │ +00004cb0: 7320 7374 6174 6564 2061 626f 7665 2c0a  s stated above,.
│ │ │ │ +00004cc0: 2020 2020 2061 6e64 2079 6f75 206d 6179       and you may
│ │ │ │ +00004cd0: 2070 7562 6c69 636c 7920 6469 7370 6c61   publicly displa
│ │ │ │ +00004ce0: 7920 636f 7069 6573 2e0a 0a20 2033 2e20  y copies...  3. 
│ │ │ │ +00004cf0: 434f 5059 494e 4720 494e 2051 5541 4e54  COPYING IN QUANT
│ │ │ │ +00004d00: 4954 590a 0a20 2020 2020 4966 2079 6f75  ITY..     If you
│ │ │ │ +00004d10: 2070 7562 6c69 7368 2070 7269 6e74 6564   publish printed
│ │ │ │ +00004d20: 2063 6f70 6965 7320 286f 7220 636f 7069   copies (or copi
│ │ │ │ +00004d30: 6573 2069 6e20 6d65 6469 6120 7468 6174  es in media that
│ │ │ │ +00004d40: 2063 6f6d 6d6f 6e6c 790a 2020 2020 2068   commonly.     h
│ │ │ │ +00004d50: 6176 6520 7072 696e 7465 6420 636f 7665  ave printed cove
│ │ │ │ +00004d60: 7273 2920 6f66 2074 6865 2044 6f63 756d  rs) of the Docum
│ │ │ │ +00004d70: 656e 742c 206e 756d 6265 7269 6e67 206d  ent, numbering m
│ │ │ │ +00004d80: 6f72 6520 7468 616e 2031 3030 2c20 616e  ore than 100, an
│ │ │ │ +00004d90: 640a 2020 2020 2074 6865 2044 6f63 756d  d.     the Docum
│ │ │ │ +00004da0: 656e 7427 7320 6c69 6365 6e73 6520 6e6f  ent's license no
│ │ │ │ +00004db0: 7469 6365 2072 6571 7569 7265 7320 436f  tice requires Co
│ │ │ │ +00004dc0: 7665 7220 5465 7874 732c 2079 6f75 206d  ver Texts, you m
│ │ │ │ +00004dd0: 7573 740a 2020 2020 2065 6e63 6c6f 7365  ust.     enclose
│ │ │ │ +00004de0: 2074 6865 2063 6f70 6965 7320 696e 2063   the copies in c
│ │ │ │ +00004df0: 6f76 6572 7320 7468 6174 2063 6172 7279  overs that carry
│ │ │ │ +00004e00: 2c20 636c 6561 726c 7920 616e 6420 6c65  , clearly and le
│ │ │ │ +00004e10: 6769 626c 792c 2061 6c6c 0a20 2020 2020  gibly, all.     
│ │ │ │ +00004e20: 7468 6573 6520 436f 7665 7220 5465 7874  these Cover Text
│ │ │ │ +00004e30: 733a 2046 726f 6e74 2d43 6f76 6572 2054  s: Front-Cover T
│ │ │ │ +00004e40: 6578 7473 206f 6e20 7468 6520 6672 6f6e  exts on the fron
│ │ │ │ +00004e50: 7420 636f 7665 722c 2061 6e64 0a20 2020  t cover, and.   
│ │ │ │ +00004e60: 2020 4261 636b 2d43 6f76 6572 2054 6578    Back-Cover Tex
│ │ │ │ +00004e70: 7473 206f 6e20 7468 6520 6261 636b 2063  ts on the back c
│ │ │ │ +00004e80: 6f76 6572 2e20 2042 6f74 6820 636f 7665  over.  Both cove
│ │ │ │ +00004e90: 7273 206d 7573 7420 616c 736f 2063 6c65  rs must also cle
│ │ │ │ +00004ea0: 6172 6c79 0a20 2020 2020 616e 6420 6c65  arly.     and le
│ │ │ │ +00004eb0: 6769 626c 7920 6964 656e 7469 6679 2079  gibly identify y
│ │ │ │ +00004ec0: 6f75 2061 7320 7468 6520 7075 626c 6973  ou as the publis
│ │ │ │ +00004ed0: 6865 7220 6f66 2074 6865 7365 2063 6f70  her of these cop
│ │ │ │ +00004ee0: 6965 732e 2020 5468 650a 2020 2020 2066  ies.  The.     f
│ │ │ │ +00004ef0: 726f 6e74 2063 6f76 6572 206d 7573 7420  ront cover must 
│ │ │ │ +00004f00: 7072 6573 656e 7420 7468 6520 6675 6c6c  present the full
│ │ │ │ +00004f10: 2074 6974 6c65 2077 6974 6820 616c 6c20   title with all 
│ │ │ │ +00004f20: 776f 7264 7320 6f66 2074 6865 2074 6974  words of the tit
│ │ │ │ +00004f30: 6c65 0a20 2020 2020 6571 7561 6c6c 7920  le.     equally 
│ │ │ │ +00004f40: 7072 6f6d 696e 656e 7420 616e 6420 7669  prominent and vi
│ │ │ │ +00004f50: 7369 626c 652e 2020 596f 7520 6d61 7920  sible.  You may 
│ │ │ │ +00004f60: 6164 6420 6f74 6865 7220 6d61 7465 7269  add other materi
│ │ │ │ +00004f70: 616c 206f 6e20 7468 650a 2020 2020 2063  al on the.     c
│ │ │ │ +00004f80: 6f76 6572 7320 696e 2061 6464 6974 696f  overs in additio
│ │ │ │ +00004f90: 6e2e 2020 436f 7079 696e 6720 7769 7468  n.  Copying with
│ │ │ │ +00004fa0: 2063 6861 6e67 6573 206c 696d 6974 6564   changes limited
│ │ │ │ +00004fb0: 2074 6f20 7468 6520 636f 7665 7273 2c20   to the covers, 
│ │ │ │ +00004fc0: 6173 0a20 2020 2020 6c6f 6e67 2061 7320  as.     long as 
│ │ │ │ +00004fd0: 7468 6579 2070 7265 7365 7276 6520 7468  they preserve th
│ │ │ │ +00004fe0: 6520 7469 746c 6520 6f66 2074 6865 2044  e title of the D
│ │ │ │ +00004ff0: 6f63 756d 656e 7420 616e 6420 7361 7469  ocument and sati
│ │ │ │ +00005000: 7366 7920 7468 6573 650a 2020 2020 2063  sfy these.     c
│ │ │ │ +00005010: 6f6e 6469 7469 6f6e 732c 2063 616e 2062  onditions, can b
│ │ │ │ +00005020: 6520 7472 6561 7465 6420 6173 2076 6572  e treated as ver
│ │ │ │ +00005030: 6261 7469 6d20 636f 7079 696e 6720 696e  batim copying in
│ │ │ │ +00005040: 206f 7468 6572 2072 6573 7065 6374 732e   other respects.
│ │ │ │ +00005050: 0a0a 2020 2020 2049 6620 7468 6520 7265  ..     If the re
│ │ │ │ +00005060: 7175 6972 6564 2074 6578 7473 2066 6f72  quired texts for
│ │ │ │ +00005070: 2065 6974 6865 7220 636f 7665 7220 6172   either cover ar
│ │ │ │ +00005080: 6520 746f 6f20 766f 6c75 6d69 6e6f 7573  e too voluminous
│ │ │ │ +00005090: 2074 6f20 6669 740a 2020 2020 206c 6567   to fit.     leg
│ │ │ │ +000050a0: 6962 6c79 2c20 796f 7520 7368 6f75 6c64  ibly, you should
│ │ │ │ +000050b0: 2070 7574 2074 6865 2066 6972 7374 206f   put the first o
│ │ │ │ +000050c0: 6e65 7320 6c69 7374 6564 2028 6173 206d  nes listed (as m
│ │ │ │ +000050d0: 616e 7920 6173 2066 6974 0a20 2020 2020  any as fit.     
│ │ │ │ +000050e0: 7265 6173 6f6e 6162 6c79 2920 6f6e 2074  reasonably) on t
│ │ │ │ +000050f0: 6865 2061 6374 7561 6c20 636f 7665 722c  he actual cover,
│ │ │ │ +00005100: 2061 6e64 2063 6f6e 7469 6e75 6520 7468   and continue th
│ │ │ │ +00005110: 6520 7265 7374 206f 6e74 6f0a 2020 2020  e rest onto.    
│ │ │ │ +00005120: 2061 646a 6163 656e 7420 7061 6765 732e   adjacent pages.
│ │ │ │ +00005130: 0a0a 2020 2020 2049 6620 796f 7520 7075  ..     If you pu
│ │ │ │ +00005140: 626c 6973 6820 6f72 2064 6973 7472 6962  blish or distrib
│ │ │ │ +00005150: 7574 6520 4f70 6171 7565 2063 6f70 6965  ute Opaque copie
│ │ │ │ +00005160: 7320 6f66 2074 6865 2044 6f63 756d 656e  s of the Documen
│ │ │ │ +00005170: 740a 2020 2020 206e 756d 6265 7269 6e67  t.     numbering
│ │ │ │ +00005180: 206d 6f72 6520 7468 616e 2031 3030 2c20   more than 100, 
│ │ │ │ +00005190: 796f 7520 6d75 7374 2065 6974 6865 7220  you must either 
│ │ │ │ +000051a0: 696e 636c 7564 6520 6120 6d61 6368 696e  include a machin
│ │ │ │ +000051b0: 652d 7265 6164 6162 6c65 0a20 2020 2020  e-readable.     
│ │ │ │ +000051c0: 5472 616e 7370 6172 656e 7420 636f 7079  Transparent copy
│ │ │ │ +000051d0: 2061 6c6f 6e67 2077 6974 6820 6561 6368   along with each
│ │ │ │ +000051e0: 204f 7061 7175 6520 636f 7079 2c20 6f72   Opaque copy, or
│ │ │ │ +000051f0: 2073 7461 7465 2069 6e20 6f72 2077 6974   state in or wit
│ │ │ │ +00005200: 680a 2020 2020 2065 6163 6820 4f70 6171  h.     each Opaq
│ │ │ │ +00005210: 7565 2063 6f70 7920 6120 636f 6d70 7574  ue copy a comput
│ │ │ │ +00005220: 6572 2d6e 6574 776f 726b 206c 6f63 6174  er-network locat
│ │ │ │ +00005230: 696f 6e20 6672 6f6d 2077 6869 6368 2074  ion from which t
│ │ │ │ +00005240: 6865 2067 656e 6572 616c 0a20 2020 2020  he general.     
│ │ │ │ +00005250: 6e65 7477 6f72 6b2d 7573 696e 6720 7075  network-using pu
│ │ │ │ +00005260: 626c 6963 2068 6173 2061 6363 6573 7320  blic has access 
│ │ │ │ +00005270: 746f 2064 6f77 6e6c 6f61 6420 7573 696e  to download usin
│ │ │ │ +00005280: 6720 7075 626c 6963 2d73 7461 6e64 6172  g public-standar
│ │ │ │ +00005290: 640a 2020 2020 206e 6574 776f 726b 2070  d.     network p
│ │ │ │ +000052a0: 726f 746f 636f 6c73 2061 2063 6f6d 706c  rotocols a compl
│ │ │ │ +000052b0: 6574 6520 5472 616e 7370 6172 656e 7420  ete Transparent 
│ │ │ │ +000052c0: 636f 7079 206f 6620 7468 6520 446f 6375  copy of the Docu
│ │ │ │ +000052d0: 6d65 6e74 2c20 6672 6565 0a20 2020 2020  ment, free.     
│ │ │ │ +000052e0: 6f66 2061 6464 6564 206d 6174 6572 6961  of added materia
│ │ │ │ +000052f0: 6c2e 2020 4966 2079 6f75 2075 7365 2074  l.  If you use t
│ │ │ │ +00005300: 6865 206c 6174 7465 7220 6f70 7469 6f6e  he latter option
│ │ │ │ +00005310: 2c20 796f 7520 6d75 7374 2074 616b 650a  , you must take.
│ │ │ │ +00005320: 2020 2020 2072 6561 736f 6e61 626c 7920       reasonably 
│ │ │ │ +00005330: 7072 7564 656e 7420 7374 6570 732c 2077  prudent steps, w
│ │ │ │ +00005340: 6865 6e20 796f 7520 6265 6769 6e20 6469  hen you begin di
│ │ │ │ +00005350: 7374 7269 6275 7469 6f6e 206f 6620 4f70  stribution of Op
│ │ │ │ +00005360: 6171 7565 0a20 2020 2020 636f 7069 6573  aque.     copies
│ │ │ │ +00005370: 2069 6e20 7175 616e 7469 7479 2c20 746f   in quantity, to
│ │ │ │ +00005380: 2065 6e73 7572 6520 7468 6174 2074 6869   ensure that thi
│ │ │ │ +00005390: 7320 5472 616e 7370 6172 656e 7420 636f  s Transparent co
│ │ │ │ +000053a0: 7079 2077 696c 6c0a 2020 2020 2072 656d  py will.     rem
│ │ │ │ +000053b0: 6169 6e20 7468 7573 2061 6363 6573 7369  ain thus accessi
│ │ │ │ +000053c0: 626c 6520 6174 2074 6865 2073 7461 7465  ble at the state
│ │ │ │ +000053d0: 6420 6c6f 6361 7469 6f6e 2075 6e74 696c  d location until
│ │ │ │ +000053e0: 2061 7420 6c65 6173 7420 6f6e 650a 2020   at least one.  
│ │ │ │ +000053f0: 2020 2079 6561 7220 6166 7465 7220 7468     year after th
│ │ │ │ +00005400: 6520 6c61 7374 2074 696d 6520 796f 7520  e last time you 
│ │ │ │ +00005410: 6469 7374 7269 6275 7465 2061 6e20 4f70  distribute an Op
│ │ │ │ +00005420: 6171 7565 2063 6f70 7920 2864 6972 6563  aque copy (direc
│ │ │ │ +00005430: 746c 7920 6f72 0a20 2020 2020 7468 726f  tly or.     thro
│ │ │ │ +00005440: 7567 6820 796f 7572 2061 6765 6e74 7320  ugh your agents 
│ │ │ │ +00005450: 6f72 2072 6574 6169 6c65 7273 2920 6f66  or retailers) of
│ │ │ │ +00005460: 2074 6861 7420 6564 6974 696f 6e20 746f   that edition to
│ │ │ │ +00005470: 2074 6865 2070 7562 6c69 632e 0a0a 2020   the public...  
│ │ │ │ +00005480: 2020 2049 7420 6973 2072 6571 7565 7374     It is request
│ │ │ │ +00005490: 6564 2c20 6275 7420 6e6f 7420 7265 7175  ed, but not requ
│ │ │ │ +000054a0: 6972 6564 2c20 7468 6174 2079 6f75 2063  ired, that you c
│ │ │ │ +000054b0: 6f6e 7461 6374 2074 6865 2061 7574 686f  ontact the autho
│ │ │ │ +000054c0: 7273 206f 660a 2020 2020 2074 6865 2044  rs of.     the D
│ │ │ │ +000054d0: 6f63 756d 656e 7420 7765 6c6c 2062 6566  ocument well bef
│ │ │ │ +000054e0: 6f72 6520 7265 6469 7374 7269 6275 7469  ore redistributi
│ │ │ │ +000054f0: 6e67 2061 6e79 206c 6172 6765 206e 756d  ng any large num
│ │ │ │ +00005500: 6265 7220 6f66 2063 6f70 6965 732c 0a20  ber of copies,. 
│ │ │ │ +00005510: 2020 2020 746f 2067 6976 6520 7468 656d      to give them
│ │ │ │ +00005520: 2061 2063 6861 6e63 6520 746f 2070 726f   a chance to pro
│ │ │ │ +00005530: 7669 6465 2079 6f75 2077 6974 6820 616e  vide you with an
│ │ │ │ +00005540: 2075 7064 6174 6564 2076 6572 7369 6f6e   updated version
│ │ │ │ +00005550: 206f 6620 7468 650a 2020 2020 2044 6f63   of the.     Doc
│ │ │ │ +00005560: 756d 656e 742e 0a0a 2020 342e 204d 4f44  ument...  4. MOD
│ │ │ │ +00005570: 4946 4943 4154 494f 4e53 0a0a 2020 2020  IFICATIONS..    
│ │ │ │ +00005580: 2059 6f75 206d 6179 2063 6f70 7920 616e   You may copy an
│ │ │ │ +00005590: 6420 6469 7374 7269 6275 7465 2061 204d  d distribute a M
│ │ │ │ +000055a0: 6f64 6966 6965 6420 5665 7273 696f 6e20  odified Version 
│ │ │ │ +000055b0: 6f66 2074 6865 2044 6f63 756d 656e 740a  of the Document.
│ │ │ │ +000055c0: 2020 2020 2075 6e64 6572 2074 6865 2063       under the c
│ │ │ │ +000055d0: 6f6e 6469 7469 6f6e 7320 6f66 2073 6563  onditions of sec
│ │ │ │ +000055e0: 7469 6f6e 7320 3220 616e 6420 3320 6162  tions 2 and 3 ab
│ │ │ │ +000055f0: 6f76 652c 2070 726f 7669 6465 6420 7468  ove, provided th
│ │ │ │ +00005600: 6174 2079 6f75 0a20 2020 2020 7265 6c65  at you.     rele
│ │ │ │ +00005610: 6173 6520 7468 6520 4d6f 6469 6669 6564  ase the Modified
│ │ │ │ +00005620: 2056 6572 7369 6f6e 2075 6e64 6572 2070   Version under p
│ │ │ │ +00005630: 7265 6369 7365 6c79 2074 6869 7320 4c69  recisely this Li
│ │ │ │ +00005640: 6365 6e73 652c 2077 6974 6820 7468 650a  cense, with the.
│ │ │ │ +00005650: 2020 2020 204d 6f64 6966 6965 6420 5665       Modified Ve
│ │ │ │ +00005660: 7273 696f 6e20 6669 6c6c 696e 6720 7468  rsion filling th
│ │ │ │ +00005670: 6520 726f 6c65 206f 6620 7468 6520 446f  e role of the Do
│ │ │ │ +00005680: 6375 6d65 6e74 2c20 7468 7573 206c 6963  cument, thus lic
│ │ │ │ +00005690: 656e 7369 6e67 0a20 2020 2020 6469 7374  ensing.     dist
│ │ │ │ +000056a0: 7269 6275 7469 6f6e 2061 6e64 206d 6f64  ribution and mod
│ │ │ │ +000056b0: 6966 6963 6174 696f 6e20 6f66 2074 6865  ification of the
│ │ │ │ +000056c0: 204d 6f64 6966 6965 6420 5665 7273 696f   Modified Versio
│ │ │ │ +000056d0: 6e20 746f 2077 686f 6576 6572 0a20 2020  n to whoever.   
│ │ │ │ +000056e0: 2020 706f 7373 6573 7365 7320 6120 636f    possesses a co
│ │ │ │ +000056f0: 7079 206f 6620 6974 2e20 2049 6e20 6164  py of it.  In ad
│ │ │ │ +00005700: 6469 7469 6f6e 2c20 796f 7520 6d75 7374  dition, you must
│ │ │ │ +00005710: 2064 6f20 7468 6573 6520 7468 696e 6773   do these things
│ │ │ │ +00005720: 2069 6e0a 2020 2020 2074 6865 204d 6f64   in.     the Mod
│ │ │ │ +00005730: 6966 6965 6420 5665 7273 696f 6e3a 0a0a  ified Version:..
│ │ │ │ +00005740: 2020 2020 2020 2041 2e20 5573 6520 696e         A. Use in
│ │ │ │ +00005750: 2074 6865 2054 6974 6c65 2050 6167 6520   the Title Page 
│ │ │ │ +00005760: 2861 6e64 206f 6e20 7468 6520 636f 7665  (and on the cove
│ │ │ │ +00005770: 7273 2c20 6966 2061 6e79 2920 6120 7469  rs, if any) a ti
│ │ │ │ +00005780: 746c 650a 2020 2020 2020 2020 2020 6469  tle.          di
│ │ │ │ +00005790: 7374 696e 6374 2066 726f 6d20 7468 6174  stinct from that
│ │ │ │ +000057a0: 206f 6620 7468 6520 446f 6375 6d65 6e74   of the Document
│ │ │ │ +000057b0: 2c20 616e 6420 6672 6f6d 2074 686f 7365  , and from those
│ │ │ │ +000057c0: 206f 6620 7072 6576 696f 7573 0a20 2020   of previous.   
│ │ │ │ +000057d0: 2020 2020 2020 2076 6572 7369 6f6e 7320         versions 
│ │ │ │ +000057e0: 2877 6869 6368 2073 686f 756c 642c 2069  (which should, i
│ │ │ │ +000057f0: 6620 7468 6572 6520 7765 7265 2061 6e79  f there were any
│ │ │ │ +00005800: 2c20 6265 206c 6973 7465 6420 696e 2074  , be listed in t
│ │ │ │ +00005810: 6865 0a20 2020 2020 2020 2020 2048 6973  he.          His
│ │ │ │ +00005820: 746f 7279 2073 6563 7469 6f6e 206f 6620  tory section of 
│ │ │ │ +00005830: 7468 6520 446f 6375 6d65 6e74 292e 2020  the Document).  
│ │ │ │ +00005840: 596f 7520 6d61 7920 7573 6520 7468 6520  You may use the 
│ │ │ │ +00005850: 7361 6d65 2074 6974 6c65 0a20 2020 2020  same title.     
│ │ │ │ +00005860: 2020 2020 2061 7320 6120 7072 6576 696f       as a previo
│ │ │ │ +00005870: 7573 2076 6572 7369 6f6e 2069 6620 7468  us version if th
│ │ │ │ +00005880: 6520 6f72 6967 696e 616c 2070 7562 6c69  e original publi
│ │ │ │ +00005890: 7368 6572 206f 6620 7468 6174 0a20 2020  sher of that.   
│ │ │ │ +000058a0: 2020 2020 2020 2076 6572 7369 6f6e 2067         version g
│ │ │ │ +000058b0: 6976 6573 2070 6572 6d69 7373 696f 6e2e  ives permission.
│ │ │ │ +000058c0: 0a0a 2020 2020 2020 2042 2e20 4c69 7374  ..       B. List
│ │ │ │ +000058d0: 206f 6e20 7468 6520 5469 746c 6520 5061   on the Title Pa
│ │ │ │ +000058e0: 6765 2c20 6173 2061 7574 686f 7273 2c20  ge, as authors, 
│ │ │ │ +000058f0: 6f6e 6520 6f72 206d 6f72 6520 7065 7273  one or more pers
│ │ │ │ +00005900: 6f6e 7320 6f72 0a20 2020 2020 2020 2020  ons or.         
│ │ │ │ +00005910: 2065 6e74 6974 6965 7320 7265 7370 6f6e   entities respon
│ │ │ │ +00005920: 7369 626c 6520 666f 7220 6175 7468 6f72  sible for author
│ │ │ │ +00005930: 7368 6970 206f 6620 7468 6520 6d6f 6469  ship of the modi
│ │ │ │ +00005940: 6669 6361 7469 6f6e 7320 696e 0a20 2020  fications in.   
│ │ │ │ +00005950: 2020 2020 2020 2074 6865 204d 6f64 6966         the Modif
│ │ │ │ +00005960: 6965 6420 5665 7273 696f 6e2c 2074 6f67  ied Version, tog
│ │ │ │ +00005970: 6574 6865 7220 7769 7468 2061 7420 6c65  ether with at le
│ │ │ │ +00005980: 6173 7420 6669 7665 206f 6620 7468 650a  ast five of the.
│ │ │ │ +00005990: 2020 2020 2020 2020 2020 7072 696e 6369            princi
│ │ │ │ +000059a0: 7061 6c20 6175 7468 6f72 7320 6f66 2074  pal authors of t
│ │ │ │ +000059b0: 6865 2044 6f63 756d 656e 7420 2861 6c6c  he Document (all
│ │ │ │ +000059c0: 206f 6620 6974 7320 7072 696e 6369 7061   of its principa
│ │ │ │ +000059d0: 6c0a 2020 2020 2020 2020 2020 6175 7468  l.          auth
│ │ │ │ +000059e0: 6f72 732c 2069 6620 6974 2068 6173 2066  ors, if it has f
│ │ │ │ +000059f0: 6577 6572 2074 6861 6e20 6669 7665 292c  ewer than five),
│ │ │ │ +00005a00: 2075 6e6c 6573 7320 7468 6579 2072 656c   unless they rel
│ │ │ │ +00005a10: 6561 7365 2079 6f75 0a20 2020 2020 2020  ease you.       
│ │ │ │ +00005a20: 2020 2066 726f 6d20 7468 6973 2072 6571     from this req
│ │ │ │ +00005a30: 7569 7265 6d65 6e74 2e0a 0a20 2020 2020  uirement...     
│ │ │ │ +00005a40: 2020 432e 2053 7461 7465 206f 6e20 7468    C. State on th
│ │ │ │ +00005a50: 6520 5469 746c 6520 7061 6765 2074 6865  e Title page the
│ │ │ │ +00005a60: 206e 616d 6520 6f66 2074 6865 2070 7562   name of the pub
│ │ │ │ +00005a70: 6c69 7368 6572 206f 6620 7468 650a 2020  lisher of the.  
│ │ │ │ +00005a80: 2020 2020 2020 2020 4d6f 6469 6669 6564          Modified
│ │ │ │ +00005a90: 2056 6572 7369 6f6e 2c20 6173 2074 6865   Version, as the
│ │ │ │ +00005aa0: 2070 7562 6c69 7368 6572 2e0a 0a20 2020   publisher...   
│ │ │ │ +00005ab0: 2020 2020 442e 2050 7265 7365 7276 6520      D. Preserve 
│ │ │ │ +00005ac0: 616c 6c20 7468 6520 636f 7079 7269 6768  all the copyrigh
│ │ │ │ +00005ad0: 7420 6e6f 7469 6365 7320 6f66 2074 6865  t notices of the
│ │ │ │ +00005ae0: 2044 6f63 756d 656e 742e 0a0a 2020 2020   Document...    
│ │ │ │ +00005af0: 2020 2045 2e20 4164 6420 616e 2061 7070     E. Add an app
│ │ │ │ +00005b00: 726f 7072 6961 7465 2063 6f70 7972 6967  ropriate copyrig
│ │ │ │ +00005b10: 6874 206e 6f74 6963 6520 666f 7220 796f  ht notice for yo
│ │ │ │ +00005b20: 7572 206d 6f64 6966 6963 6174 696f 6e73  ur modifications
│ │ │ │ +00005b30: 0a20 2020 2020 2020 2020 2061 646a 6163  .          adjac
│ │ │ │ +00005b40: 656e 7420 746f 2074 6865 206f 7468 6572  ent to the other
│ │ │ │ +00005b50: 2063 6f70 7972 6967 6874 206e 6f74 6963   copyright notic
│ │ │ │ +00005b60: 6573 2e0a 0a20 2020 2020 2020 462e 2049  es...       F. I
│ │ │ │ +00005b70: 6e63 6c75 6465 2c20 696d 6d65 6469 6174  nclude, immediat
│ │ │ │ +00005b80: 656c 7920 6166 7465 7220 7468 6520 636f  ely after the co
│ │ │ │ +00005b90: 7079 7269 6768 7420 6e6f 7469 6365 732c  pyright notices,
│ │ │ │ +00005ba0: 2061 206c 6963 656e 7365 0a20 2020 2020   a license.     
│ │ │ │ +00005bb0: 2020 2020 206e 6f74 6963 6520 6769 7669       notice givi
│ │ │ │ +00005bc0: 6e67 2074 6865 2070 7562 6c69 6320 7065  ng the public pe
│ │ │ │ +00005bd0: 726d 6973 7369 6f6e 2074 6f20 7573 6520  rmission to use 
│ │ │ │ +00005be0: 7468 6520 4d6f 6469 6669 6564 0a20 2020  the Modified.   
│ │ │ │ +00005bf0: 2020 2020 2020 2056 6572 7369 6f6e 2075         Version u
│ │ │ │ +00005c00: 6e64 6572 2074 6865 2074 6572 6d73 206f  nder the terms o
│ │ │ │ +00005c10: 6620 7468 6973 204c 6963 656e 7365 2c20  f this License, 
│ │ │ │ +00005c20: 696e 2074 6865 2066 6f72 6d20 7368 6f77  in the form show
│ │ │ │ +00005c30: 6e20 696e 0a20 2020 2020 2020 2020 2074  n in.          t
│ │ │ │ +00005c40: 6865 2041 6464 656e 6475 6d20 6265 6c6f  he Addendum belo
│ │ │ │ +00005c50: 772e 0a0a 2020 2020 2020 2047 2e20 5072  w...       G. Pr
│ │ │ │ +00005c60: 6573 6572 7665 2069 6e20 7468 6174 206c  eserve in that l
│ │ │ │ +00005c70: 6963 656e 7365 206e 6f74 6963 6520 7468  icense notice th
│ │ │ │ +00005c80: 6520 6675 6c6c 206c 6973 7473 206f 6620  e full lists of 
│ │ │ │ +00005c90: 496e 7661 7269 616e 740a 2020 2020 2020  Invariant.      
│ │ │ │ +00005ca0: 2020 2020 5365 6374 696f 6e73 2061 6e64      Sections and
│ │ │ │ +00005cb0: 2072 6571 7569 7265 6420 436f 7665 7220   required Cover 
│ │ │ │ +00005cc0: 5465 7874 7320 6769 7665 6e20 696e 2074  Texts given in t
│ │ │ │ +00005cd0: 6865 2044 6f63 756d 656e 7427 730a 2020  he Document's.  
│ │ │ │ +00005ce0: 2020 2020 2020 2020 6c69 6365 6e73 6520          license 
│ │ │ │ +00005cf0: 6e6f 7469 6365 2e0a 0a20 2020 2020 2020  notice...       
│ │ │ │ +00005d00: 482e 2049 6e63 6c75 6465 2061 6e20 756e  H. Include an un
│ │ │ │ +00005d10: 616c 7465 7265 6420 636f 7079 206f 6620  altered copy of 
│ │ │ │ +00005d20: 7468 6973 204c 6963 656e 7365 2e0a 0a20  this License... 
│ │ │ │ +00005d30: 2020 2020 2020 492e 2050 7265 7365 7276        I. Preserv
│ │ │ │ +00005d40: 6520 7468 6520 7365 6374 696f 6e20 456e  e the section En
│ │ │ │ +00005d50: 7469 746c 6564 2022 4869 7374 6f72 7922  titled "History"
│ │ │ │ +00005d60: 2c20 5072 6573 6572 7665 2069 7473 2054  , Preserve its T
│ │ │ │ +00005d70: 6974 6c65 2c0a 2020 2020 2020 2020 2020  itle,.          
│ │ │ │ +00005d80: 616e 6420 6164 6420 746f 2069 7420 616e  and add to it an
│ │ │ │ +00005d90: 2069 7465 6d20 7374 6174 696e 6720 6174   item stating at
│ │ │ │ +00005da0: 206c 6561 7374 2074 6865 2074 6974 6c65   least the title
│ │ │ │ +00005db0: 2c20 7965 6172 2c20 6e65 770a 2020 2020  , year, new.    
│ │ │ │ +00005dc0: 2020 2020 2020 6175 7468 6f72 732c 2061        authors, a
│ │ │ │ +00005dd0: 6e64 2070 7562 6c69 7368 6572 206f 6620  nd publisher of 
│ │ │ │ +00005de0: 7468 6520 4d6f 6469 6669 6564 2056 6572  the Modified Ver
│ │ │ │ +00005df0: 7369 6f6e 2061 7320 6769 7665 6e20 6f6e  sion as given on
│ │ │ │ +00005e00: 2074 6865 0a20 2020 2020 2020 2020 2054   the.          T
│ │ │ │ +00005e10: 6974 6c65 2050 6167 652e 2020 4966 2074  itle Page.  If t
│ │ │ │ +00005e20: 6865 7265 2069 7320 6e6f 2073 6563 7469  here is no secti
│ │ │ │ +00005e30: 6f6e 2045 6e74 6974 6c65 6420 2248 6973  on Entitled "His
│ │ │ │ +00005e40: 746f 7279 2220 696e 2074 6865 0a20 2020  tory" in the.   
│ │ │ │ +00005e50: 2020 2020 2020 2044 6f63 756d 656e 742c         Document,
│ │ │ │ +00005e60: 2063 7265 6174 6520 6f6e 6520 7374 6174   create one stat
│ │ │ │ +00005e70: 696e 6720 7468 6520 7469 746c 652c 2079  ing the title, y
│ │ │ │ +00005e80: 6561 722c 2061 7574 686f 7273 2c20 616e  ear, authors, an
│ │ │ │ +00005e90: 640a 2020 2020 2020 2020 2020 7075 626c  d.          publ
│ │ │ │ +00005ea0: 6973 6865 7220 6f66 2074 6865 2044 6f63  isher of the Doc
│ │ │ │ +00005eb0: 756d 656e 7420 6173 2067 6976 656e 206f  ument as given o
│ │ │ │ +00005ec0: 6e20 6974 7320 5469 746c 6520 5061 6765  n its Title Page
│ │ │ │ +00005ed0: 2c20 7468 656e 2061 6464 0a20 2020 2020  , then add.     
│ │ │ │ +00005ee0: 2020 2020 2061 6e20 6974 656d 2064 6573       an item des
│ │ │ │ +00005ef0: 6372 6962 696e 6720 7468 6520 4d6f 6469  cribing the Modi
│ │ │ │ +00005f00: 6669 6564 2056 6572 7369 6f6e 2061 7320  fied Version as 
│ │ │ │ +00005f10: 7374 6174 6564 2069 6e20 7468 650a 2020  stated in the.  
│ │ │ │ +00005f20: 2020 2020 2020 2020 7072 6576 696f 7573          previous
│ │ │ │ +00005f30: 2073 656e 7465 6e63 652e 0a0a 2020 2020   sentence...    
│ │ │ │ +00005f40: 2020 204a 2e20 5072 6573 6572 7665 2074     J. Preserve t
│ │ │ │ +00005f50: 6865 206e 6574 776f 726b 206c 6f63 6174  he network locat
│ │ │ │ +00005f60: 696f 6e2c 2069 6620 616e 792c 2067 6976  ion, if any, giv
│ │ │ │ +00005f70: 656e 2069 6e20 7468 6520 446f 6375 6d65  en in the Docume
│ │ │ │ +00005f80: 6e74 0a20 2020 2020 2020 2020 2066 6f72  nt.          for
│ │ │ │ +00005f90: 2070 7562 6c69 6320 6163 6365 7373 2074   public access t
│ │ │ │ +00005fa0: 6f20 6120 5472 616e 7370 6172 656e 7420  o a Transparent 
│ │ │ │ +00005fb0: 636f 7079 206f 6620 7468 6520 446f 6375  copy of the Docu
│ │ │ │ +00005fc0: 6d65 6e74 2c20 616e 640a 2020 2020 2020  ment, and.      
│ │ │ │ +00005fd0: 2020 2020 6c69 6b65 7769 7365 2074 6865      likewise the
│ │ │ │ +00005fe0: 206e 6574 776f 726b 206c 6f63 6174 696f   network locatio
│ │ │ │ +00005ff0: 6e73 2067 6976 656e 2069 6e20 7468 6520  ns given in the 
│ │ │ │ +00006000: 446f 6375 6d65 6e74 2066 6f72 0a20 2020  Document for.   
│ │ │ │ +00006010: 2020 2020 2020 2070 7265 7669 6f75 7320         previous 
│ │ │ │ +00006020: 7665 7273 696f 6e73 2069 7420 7761 7320  versions it was 
│ │ │ │ +00006030: 6261 7365 6420 6f6e 2e20 2054 6865 7365  based on.  These
│ │ │ │ +00006040: 206d 6179 2062 6520 706c 6163 6564 2069   may be placed i
│ │ │ │ +00006050: 6e20 7468 650a 2020 2020 2020 2020 2020  n the.          
│ │ │ │ +00006060: 2248 6973 746f 7279 2220 7365 6374 696f  "History" sectio
│ │ │ │ +00006070: 6e2e 2020 596f 7520 6d61 7920 6f6d 6974  n.  You may omit
│ │ │ │ +00006080: 2061 206e 6574 776f 726b 206c 6f63 6174   a network locat
│ │ │ │ +00006090: 696f 6e20 666f 7220 6120 776f 726b 0a20  ion for a work. 
│ │ │ │ +000060a0: 2020 2020 2020 2020 2074 6861 7420 7761           that wa
│ │ │ │ +000060b0: 7320 7075 626c 6973 6865 6420 6174 206c  s published at l
│ │ │ │ +000060c0: 6561 7374 2066 6f75 7220 7965 6172 7320  east four years 
│ │ │ │ +000060d0: 6265 666f 7265 2074 6865 2044 6f63 756d  before the Docum
│ │ │ │ +000060e0: 656e 740a 2020 2020 2020 2020 2020 6974  ent.          it
│ │ │ │ +000060f0: 7365 6c66 2c20 6f72 2069 6620 7468 6520  self, or if the 
│ │ │ │ +00006100: 6f72 6967 696e 616c 2070 7562 6c69 7368  original publish
│ │ │ │ +00006110: 6572 206f 6620 7468 6520 7665 7273 696f  er of the versio
│ │ │ │ +00006120: 6e20 6974 2072 6566 6572 730a 2020 2020  n it refers.    
│ │ │ │ +00006130: 2020 2020 2020 746f 2067 6976 6573 2070        to gives p
│ │ │ │ +00006140: 6572 6d69 7373 696f 6e2e 0a0a 2020 2020  ermission...    
│ │ │ │ +00006150: 2020 204b 2e20 466f 7220 616e 7920 7365     K. For any se
│ │ │ │ +00006160: 6374 696f 6e20 456e 7469 746c 6564 2022  ction Entitled "
│ │ │ │ +00006170: 4163 6b6e 6f77 6c65 6467 656d 656e 7473  Acknowledgements
│ │ │ │ +00006180: 2220 6f72 2022 4465 6469 6361 7469 6f6e  " or "Dedication
│ │ │ │ +00006190: 7322 2c0a 2020 2020 2020 2020 2020 5072  s",.          Pr
│ │ │ │ +000061a0: 6573 6572 7665 2074 6865 2054 6974 6c65  eserve the Title
│ │ │ │ +000061b0: 206f 6620 7468 6520 7365 6374 696f 6e2c   of the section,
│ │ │ │ +000061c0: 2061 6e64 2070 7265 7365 7276 6520 696e   and preserve in
│ │ │ │ +000061d0: 2074 6865 2073 6563 7469 6f6e 0a20 2020   the section.   
│ │ │ │ +000061e0: 2020 2020 2020 2061 6c6c 2074 6865 2073         all the s
│ │ │ │ +000061f0: 7562 7374 616e 6365 2061 6e64 2074 6f6e  ubstance and ton
│ │ │ │ +00006200: 6520 6f66 2065 6163 6820 6f66 2074 6865  e of each of the
│ │ │ │ +00006210: 2063 6f6e 7472 6962 7574 6f72 0a20 2020   contributor.   
│ │ │ │ +00006220: 2020 2020 2020 2061 636b 6e6f 776c 6564         acknowled
│ │ │ │ +00006230: 6765 6d65 6e74 7320 616e 642f 6f72 2064  gements and/or d
│ │ │ │ +00006240: 6564 6963 6174 696f 6e73 2067 6976 656e  edications given
│ │ │ │ +00006250: 2074 6865 7265 696e 2e0a 0a20 2020 2020   therein...     
│ │ │ │ +00006260: 2020 4c2e 2050 7265 7365 7276 6520 616c    L. Preserve al
│ │ │ │ +00006270: 6c20 7468 6520 496e 7661 7269 616e 7420  l the Invariant 
│ │ │ │ +00006280: 5365 6374 696f 6e73 206f 6620 7468 6520  Sections of the 
│ │ │ │ +00006290: 446f 6375 6d65 6e74 2c20 756e 616c 7465  Document, unalte
│ │ │ │ +000062a0: 7265 640a 2020 2020 2020 2020 2020 696e  red.          in
│ │ │ │ +000062b0: 2074 6865 6972 2074 6578 7420 616e 6420   their text and 
│ │ │ │ +000062c0: 696e 2074 6865 6972 2074 6974 6c65 732e  in their titles.
│ │ │ │ +000062d0: 2020 5365 6374 696f 6e20 6e75 6d62 6572    Section number
│ │ │ │ +000062e0: 7320 6f72 2074 6865 0a20 2020 2020 2020  s or the.       
│ │ │ │ +000062f0: 2020 2065 7175 6976 616c 656e 7420 6172     equivalent ar
│ │ │ │ +00006300: 6520 6e6f 7420 636f 6e73 6964 6572 6564  e not considered
│ │ │ │ +00006310: 2070 6172 7420 6f66 2074 6865 2073 6563   part of the sec
│ │ │ │ +00006320: 7469 6f6e 2074 6974 6c65 732e 0a0a 2020  tion titles...  
│ │ │ │ +00006330: 2020 2020 204d 2e20 4465 6c65 7465 2061       M. Delete a
│ │ │ │ +00006340: 6e79 2073 6563 7469 6f6e 2045 6e74 6974  ny section Entit
│ │ │ │ +00006350: 6c65 6420 2245 6e64 6f72 7365 6d65 6e74  led "Endorsement
│ │ │ │ +00006360: 7322 2e20 2053 7563 6820 6120 7365 6374  s".  Such a sect
│ │ │ │ +00006370: 696f 6e0a 2020 2020 2020 2020 2020 6d61  ion.          ma
│ │ │ │ +00006380: 7920 6e6f 7420 6265 2069 6e63 6c75 6465  y not be include
│ │ │ │ +00006390: 6420 696e 2074 6865 204d 6f64 6966 6965  d in the Modifie
│ │ │ │ +000063a0: 6420 5665 7273 696f 6e2e 0a0a 2020 2020  d Version...    
│ │ │ │ +000063b0: 2020 204e 2e20 446f 206e 6f74 2072 6574     N. Do not ret
│ │ │ │ +000063c0: 6974 6c65 2061 6e79 2065 7869 7374 696e  itle any existin
│ │ │ │ +000063d0: 6720 7365 6374 696f 6e20 746f 2062 6520  g section to be 
│ │ │ │ +000063e0: 456e 7469 746c 6564 0a20 2020 2020 2020  Entitled.       
│ │ │ │ +000063f0: 2020 2022 456e 646f 7273 656d 656e 7473     "Endorsements
│ │ │ │ +00006400: 2220 6f72 2074 6f20 636f 6e66 6c69 6374  " or to conflict
│ │ │ │ +00006410: 2069 6e20 7469 746c 6520 7769 7468 2061   in title with a
│ │ │ │ +00006420: 6e79 2049 6e76 6172 6961 6e74 0a20 2020  ny Invariant.   
│ │ │ │ +00006430: 2020 2020 2020 2053 6563 7469 6f6e 2e0a         Section..
│ │ │ │ +00006440: 0a20 2020 2020 2020 4f2e 2050 7265 7365  .       O. Prese
│ │ │ │ +00006450: 7276 6520 616e 7920 5761 7272 616e 7479  rve any Warranty
│ │ │ │ +00006460: 2044 6973 636c 6169 6d65 7273 2e0a 0a20   Disclaimers... 
│ │ │ │ +00006470: 2020 2020 4966 2074 6865 204d 6f64 6966      If the Modif
│ │ │ │ +00006480: 6965 6420 5665 7273 696f 6e20 696e 636c  ied Version incl
│ │ │ │ +00006490: 7564 6573 206e 6577 2066 726f 6e74 2d6d  udes new front-m
│ │ │ │ +000064a0: 6174 7465 7220 7365 6374 696f 6e73 206f  atter sections o
│ │ │ │ +000064b0: 720a 2020 2020 2061 7070 656e 6469 6365  r.     appendice
│ │ │ │ +000064c0: 7320 7468 6174 2071 7561 6c69 6679 2061  s that qualify a
│ │ │ │ +000064d0: 7320 5365 636f 6e64 6172 7920 5365 6374  s Secondary Sect
│ │ │ │ +000064e0: 696f 6e73 2061 6e64 2063 6f6e 7461 696e  ions and contain
│ │ │ │ +000064f0: 206e 6f0a 2020 2020 206d 6174 6572 6961   no.     materia
│ │ │ │ +00006500: 6c20 636f 7069 6564 2066 726f 6d20 7468  l copied from th
│ │ │ │ +00006510: 6520 446f 6375 6d65 6e74 2c20 796f 7520  e Document, you 
│ │ │ │ +00006520: 6d61 7920 6174 2079 6f75 7220 6f70 7469  may at your opti
│ │ │ │ +00006530: 6f6e 2064 6573 6967 6e61 7465 0a20 2020  on designate.   
│ │ │ │ +00006540: 2020 736f 6d65 206f 7220 616c 6c20 6f66    some or all of
│ │ │ │ +00006550: 2074 6865 7365 2073 6563 7469 6f6e 7320   these sections 
│ │ │ │ +00006560: 6173 2069 6e76 6172 6961 6e74 2e20 2054  as invariant.  T
│ │ │ │ +00006570: 6f20 646f 2074 6869 732c 2061 6464 2074  o do this, add t
│ │ │ │ +00006580: 6865 6972 0a20 2020 2020 7469 746c 6573  heir.     titles
│ │ │ │ +00006590: 2074 6f20 7468 6520 6c69 7374 206f 6620   to the list of 
│ │ │ │ +000065a0: 496e 7661 7269 616e 7420 5365 6374 696f  Invariant Sectio
│ │ │ │ +000065b0: 6e73 2069 6e20 7468 6520 4d6f 6469 6669  ns in the Modifi
│ │ │ │ +000065c0: 6564 2056 6572 7369 6f6e 2773 0a20 2020  ed Version's.   
│ │ │ │ +000065d0: 2020 6c69 6365 6e73 6520 6e6f 7469 6365    license notice
│ │ │ │ +000065e0: 2e20 2054 6865 7365 2074 6974 6c65 7320  .  These titles 
│ │ │ │ +000065f0: 6d75 7374 2062 6520 6469 7374 696e 6374  must be distinct
│ │ │ │ +00006600: 2066 726f 6d20 616e 7920 6f74 6865 720a   from any other.
│ │ │ │ +00006610: 2020 2020 2073 6563 7469 6f6e 2074 6974       section tit
│ │ │ │ +00006620: 6c65 732e 0a0a 2020 2020 2059 6f75 206d  les...     You m
│ │ │ │ +00006630: 6179 2061 6464 2061 2073 6563 7469 6f6e  ay add a section
│ │ │ │ +00006640: 2045 6e74 6974 6c65 6420 2245 6e64 6f72   Entitled "Endor
│ │ │ │ +00006650: 7365 6d65 6e74 7322 2c20 7072 6f76 6964  sements", provid
│ │ │ │ +00006660: 6564 2069 7420 636f 6e74 6169 6e73 0a20  ed it contains. 
│ │ │ │ +00006670: 2020 2020 6e6f 7468 696e 6720 6275 7420      nothing but 
│ │ │ │ +00006680: 656e 646f 7273 656d 656e 7473 206f 6620  endorsements of 
│ │ │ │ +00006690: 796f 7572 204d 6f64 6966 6965 6420 5665  your Modified Ve
│ │ │ │ +000066a0: 7273 696f 6e20 6279 2076 6172 696f 7573  rsion by various
│ │ │ │ +000066b0: 0a20 2020 2020 7061 7274 6965 732d 2d66  .     parties--f
│ │ │ │ +000066c0: 6f72 2065 7861 6d70 6c65 2c20 7374 6174  or example, stat
│ │ │ │ +000066d0: 656d 656e 7473 206f 6620 7065 6572 2072  ements of peer r
│ │ │ │ +000066e0: 6576 6965 7720 6f72 2074 6861 7420 7468  eview or that th
│ │ │ │ +000066f0: 6520 7465 7874 0a20 2020 2020 6861 7320  e text.     has 
│ │ │ │ +00006700: 6265 656e 2061 7070 726f 7665 6420 6279  been approved by
│ │ │ │ +00006710: 2061 6e20 6f72 6761 6e69 7a61 7469 6f6e   an organization
│ │ │ │ +00006720: 2061 7320 7468 6520 6175 7468 6f72 6974   as the authorit
│ │ │ │ +00006730: 6174 6976 650a 2020 2020 2064 6566 696e  ative.     defin
│ │ │ │ +00006740: 6974 696f 6e20 6f66 2061 2073 7461 6e64  ition of a stand
│ │ │ │ +00006750: 6172 642e 0a0a 2020 2020 2059 6f75 206d  ard...     You m
│ │ │ │ +00006760: 6179 2061 6464 2061 2070 6173 7361 6765  ay add a passage
│ │ │ │ +00006770: 206f 6620 7570 2074 6f20 6669 7665 2077   of up to five w
│ │ │ │ +00006780: 6f72 6473 2061 7320 6120 4672 6f6e 742d  ords as a Front-
│ │ │ │ +00006790: 436f 7665 7220 5465 7874 2c0a 2020 2020  Cover Text,.    
│ │ │ │ +000067a0: 2061 6e64 2061 2070 6173 7361 6765 206f   and a passage o
│ │ │ │ +000067b0: 6620 7570 2074 6f20 3235 2077 6f72 6473  f up to 25 words
│ │ │ │ +000067c0: 2061 7320 6120 4261 636b 2d43 6f76 6572   as a Back-Cover
│ │ │ │ +000067d0: 2054 6578 742c 2074 6f20 7468 6520 656e   Text, to the en
│ │ │ │ +000067e0: 6420 6f66 0a20 2020 2020 7468 6520 6c69  d of.     the li
│ │ │ │ +000067f0: 7374 206f 6620 436f 7665 7220 5465 7874  st of Cover Text
│ │ │ │ +00006800: 7320 696e 2074 6865 204d 6f64 6966 6965  s in the Modifie
│ │ │ │ +00006810: 6420 5665 7273 696f 6e2e 2020 4f6e 6c79  d Version.  Only
│ │ │ │ +00006820: 206f 6e65 2070 6173 7361 6765 0a20 2020   one passage.   
│ │ │ │ +00006830: 2020 6f66 2046 726f 6e74 2d43 6f76 6572    of Front-Cover
│ │ │ │ +00006840: 2054 6578 7420 616e 6420 6f6e 6520 6f66   Text and one of
│ │ │ │ +00006850: 2042 6163 6b2d 436f 7665 7220 5465 7874   Back-Cover Text
│ │ │ │ +00006860: 206d 6179 2062 6520 6164 6465 6420 6279   may be added by
│ │ │ │ +00006870: 2028 6f72 0a20 2020 2020 7468 726f 7567   (or.     throug
│ │ │ │ +00006880: 6820 6172 7261 6e67 656d 656e 7473 206d  h arrangements m
│ │ │ │ +00006890: 6164 6520 6279 2920 616e 7920 6f6e 6520  ade by) any one 
│ │ │ │ +000068a0: 656e 7469 7479 2e20 2049 6620 7468 6520  entity.  If the 
│ │ │ │ +000068b0: 446f 6375 6d65 6e74 0a20 2020 2020 616c  Document.     al
│ │ │ │ +000068c0: 7265 6164 7920 696e 636c 7564 6573 2061  ready includes a
│ │ │ │ +000068d0: 2063 6f76 6572 2074 6578 7420 666f 7220   cover text for 
│ │ │ │ +000068e0: 7468 6520 7361 6d65 2063 6f76 6572 2c20  the same cover, 
│ │ │ │ +000068f0: 7072 6576 696f 7573 6c79 2061 6464 6564  previously added
│ │ │ │ +00006900: 0a20 2020 2020 6279 2079 6f75 206f 7220  .     by you or 
│ │ │ │ +00006910: 6279 2061 7272 616e 6765 6d65 6e74 206d  by arrangement m
│ │ │ │ +00006920: 6164 6520 6279 2074 6865 2073 616d 6520  ade by the same 
│ │ │ │ +00006930: 656e 7469 7479 2079 6f75 2061 7265 2061  entity you are a
│ │ │ │ +00006940: 6374 696e 6720 6f6e 0a20 2020 2020 6265  cting on.     be
│ │ │ │ +00006950: 6861 6c66 206f 662c 2079 6f75 206d 6179  half of, you may
│ │ │ │ +00006960: 206e 6f74 2061 6464 2061 6e6f 7468 6572   not add another
│ │ │ │ +00006970: 3b20 6275 7420 796f 7520 6d61 7920 7265  ; but you may re
│ │ │ │ +00006980: 706c 6163 6520 7468 6520 6f6c 640a 2020  place the old.  
│ │ │ │ +00006990: 2020 206f 6e65 2c20 6f6e 2065 7870 6c69     one, on expli
│ │ │ │ +000069a0: 6369 7420 7065 726d 6973 7369 6f6e 2066  cit permission f
│ │ │ │ +000069b0: 726f 6d20 7468 6520 7072 6576 696f 7573  rom the previous
│ │ │ │ +000069c0: 2070 7562 6c69 7368 6572 2074 6861 7420   publisher that 
│ │ │ │ +000069d0: 6164 6465 640a 2020 2020 2074 6865 206f  added.     the o
│ │ │ │ +000069e0: 6c64 206f 6e65 2e0a 0a20 2020 2020 5468  ld one...     Th
│ │ │ │ +000069f0: 6520 6175 7468 6f72 2873 2920 616e 6420  e author(s) and 
│ │ │ │ +00006a00: 7075 626c 6973 6865 7228 7329 206f 6620  publisher(s) of 
│ │ │ │ +00006a10: 7468 6520 446f 6375 6d65 6e74 2064 6f20  the Document do 
│ │ │ │ +00006a20: 6e6f 7420 6279 2074 6869 730a 2020 2020  not by this.    
│ │ │ │ +00006a30: 204c 6963 656e 7365 2067 6976 6520 7065   License give pe
│ │ │ │ +00006a40: 726d 6973 7369 6f6e 2074 6f20 7573 6520  rmission to use 
│ │ │ │ +00006a50: 7468 6569 7220 6e61 6d65 7320 666f 7220  their names for 
│ │ │ │ +00006a60: 7075 626c 6963 6974 7920 666f 7220 6f72  publicity for or
│ │ │ │ +00006a70: 2074 6f0a 2020 2020 2061 7373 6572 7420   to.     assert 
│ │ │ │ +00006a80: 6f72 2069 6d70 6c79 2065 6e64 6f72 7365  or imply endorse
│ │ │ │ +00006a90: 6d65 6e74 206f 6620 616e 7920 4d6f 6469  ment of any Modi
│ │ │ │ +00006aa0: 6669 6564 2056 6572 7369 6f6e 2e0a 0a20  fied Version... 
│ │ │ │ +00006ab0: 2035 2e20 434f 4d42 494e 494e 4720 444f   5. COMBINING DO
│ │ │ │ +00006ac0: 4355 4d45 4e54 530a 0a20 2020 2020 596f  CUMENTS..     Yo
│ │ │ │ +00006ad0: 7520 6d61 7920 636f 6d62 696e 6520 7468  u may combine th
│ │ │ │ +00006ae0: 6520 446f 6375 6d65 6e74 2077 6974 6820  e Document with 
│ │ │ │ +00006af0: 6f74 6865 7220 646f 6375 6d65 6e74 7320  other documents 
│ │ │ │ +00006b00: 7265 6c65 6173 6564 2075 6e64 6572 0a20  released under. 
│ │ │ │ +00006b10: 2020 2020 7468 6973 204c 6963 656e 7365      this License
│ │ │ │ +00006b20: 2c20 756e 6465 7220 7468 6520 7465 726d  , under the term
│ │ │ │ +00006b30: 7320 6465 6669 6e65 6420 696e 2073 6563  s defined in sec
│ │ │ │ +00006b40: 7469 6f6e 2034 2061 626f 7665 2066 6f72  tion 4 above for
│ │ │ │ +00006b50: 0a20 2020 2020 6d6f 6469 6669 6564 2076  .     modified v
│ │ │ │ +00006b60: 6572 7369 6f6e 732c 2070 726f 7669 6465  ersions, provide
│ │ │ │ +00006b70: 6420 7468 6174 2079 6f75 2069 6e63 6c75  d that you inclu
│ │ │ │ +00006b80: 6465 2069 6e20 7468 6520 636f 6d62 696e  de in the combin
│ │ │ │ +00006b90: 6174 696f 6e20 616c 6c0a 2020 2020 206f  ation all.     o
│ │ │ │ +00006ba0: 6620 7468 6520 496e 7661 7269 616e 7420  f the Invariant 
│ │ │ │ +00006bb0: 5365 6374 696f 6e73 206f 6620 616c 6c20  Sections of all 
│ │ │ │ +00006bc0: 6f66 2074 6865 206f 7269 6769 6e61 6c20  of the original 
│ │ │ │ +00006bd0: 646f 6375 6d65 6e74 732c 0a20 2020 2020  documents,.     
│ │ │ │ +00006be0: 756e 6d6f 6469 6669 6564 2c20 616e 6420  unmodified, and 
│ │ │ │ +00006bf0: 6c69 7374 2074 6865 6d20 616c 6c20 6173  list them all as
│ │ │ │ +00006c00: 2049 6e76 6172 6961 6e74 2053 6563 7469   Invariant Secti
│ │ │ │ +00006c10: 6f6e 7320 6f66 2079 6f75 720a 2020 2020  ons of your.    
│ │ │ │ +00006c20: 2063 6f6d 6269 6e65 6420 776f 726b 2069   combined work i
│ │ │ │ +00006c30: 6e20 6974 7320 6c69 6365 6e73 6520 6e6f  n its license no
│ │ │ │ +00006c40: 7469 6365 2c20 616e 6420 7468 6174 2079  tice, and that y
│ │ │ │ +00006c50: 6f75 2070 7265 7365 7276 6520 616c 6c0a  ou preserve all.
│ │ │ │ +00006c60: 2020 2020 2074 6865 6972 2057 6172 7261       their Warra
│ │ │ │ +00006c70: 6e74 7920 4469 7363 6c61 696d 6572 732e  nty Disclaimers.
│ │ │ │ +00006c80: 0a0a 2020 2020 2054 6865 2063 6f6d 6269  ..     The combi
│ │ │ │ +00006c90: 6e65 6420 776f 726b 206e 6565 6420 6f6e  ned work need on
│ │ │ │ +00006ca0: 6c79 2063 6f6e 7461 696e 206f 6e65 2063  ly contain one c
│ │ │ │ +00006cb0: 6f70 7920 6f66 2074 6869 7320 4c69 6365  opy of this Lice
│ │ │ │ +00006cc0: 6e73 652c 2061 6e64 0a20 2020 2020 6d75  nse, and.     mu
│ │ │ │ +00006cd0: 6c74 6970 6c65 2069 6465 6e74 6963 616c  ltiple identical
│ │ │ │ +00006ce0: 2049 6e76 6172 6961 6e74 2053 6563 7469   Invariant Secti
│ │ │ │ +00006cf0: 6f6e 7320 6d61 7920 6265 2072 6570 6c61  ons may be repla
│ │ │ │ +00006d00: 6365 6420 7769 7468 2061 2073 696e 676c  ced with a singl
│ │ │ │ +00006d10: 650a 2020 2020 2063 6f70 792e 2020 4966  e.     copy.  If
│ │ │ │ +00006d20: 2074 6865 7265 2061 7265 206d 756c 7469   there are multi
│ │ │ │ +00006d30: 706c 6520 496e 7661 7269 616e 7420 5365  ple Invariant Se
│ │ │ │ +00006d40: 6374 696f 6e73 2077 6974 6820 7468 6520  ctions with the 
│ │ │ │ +00006d50: 7361 6d65 206e 616d 650a 2020 2020 2062  same name.     b
│ │ │ │ +00006d60: 7574 2064 6966 6665 7265 6e74 2063 6f6e  ut different con
│ │ │ │ +00006d70: 7465 6e74 732c 206d 616b 6520 7468 6520  tents, make the 
│ │ │ │ +00006d80: 7469 746c 6520 6f66 2065 6163 6820 7375  title of each su
│ │ │ │ +00006d90: 6368 2073 6563 7469 6f6e 2075 6e69 7175  ch section uniqu
│ │ │ │ +00006da0: 650a 2020 2020 2062 7920 6164 6469 6e67  e.     by adding
│ │ │ │ +00006db0: 2061 7420 7468 6520 656e 6420 6f66 2069   at the end of i
│ │ │ │ +00006dc0: 742c 2069 6e20 7061 7265 6e74 6865 7365  t, in parenthese
│ │ │ │ +00006dd0: 732c 2074 6865 206e 616d 6520 6f66 2074  s, the name of t
│ │ │ │ +00006de0: 6865 0a20 2020 2020 6f72 6967 696e 616c  he.     original
│ │ │ │ +00006df0: 2061 7574 686f 7220 6f72 2070 7562 6c69   author or publi
│ │ │ │ +00006e00: 7368 6572 206f 6620 7468 6174 2073 6563  sher of that sec
│ │ │ │ +00006e10: 7469 6f6e 2069 6620 6b6e 6f77 6e2c 206f  tion if known, o
│ │ │ │ +00006e20: 7220 656c 7365 2061 0a20 2020 2020 756e  r else a.     un
│ │ │ │ +00006e30: 6971 7565 206e 756d 6265 722e 2020 4d61  ique number.  Ma
│ │ │ │ +00006e40: 6b65 2074 6865 2073 616d 6520 6164 6a75  ke the same adju
│ │ │ │ +00006e50: 7374 6d65 6e74 2074 6f20 7468 6520 7365  stment to the se
│ │ │ │ +00006e60: 6374 696f 6e20 7469 746c 6573 2069 6e0a  ction titles in.
│ │ │ │ +00006e70: 2020 2020 2074 6865 206c 6973 7420 6f66       the list of
│ │ │ │ +00006e80: 2049 6e76 6172 6961 6e74 2053 6563 7469   Invariant Secti
│ │ │ │ +00006e90: 6f6e 7320 696e 2074 6865 206c 6963 656e  ons in the licen
│ │ │ │ +00006ea0: 7365 206e 6f74 6963 6520 6f66 2074 6865  se notice of the
│ │ │ │ +00006eb0: 0a20 2020 2020 636f 6d62 696e 6564 2077  .     combined w
│ │ │ │ +00006ec0: 6f72 6b2e 0a0a 2020 2020 2049 6e20 7468  ork...     In th
│ │ │ │ +00006ed0: 6520 636f 6d62 696e 6174 696f 6e2c 2079  e combination, y
│ │ │ │ +00006ee0: 6f75 206d 7573 7420 636f 6d62 696e 6520  ou must combine 
│ │ │ │ +00006ef0: 616e 7920 7365 6374 696f 6e73 2045 6e74  any sections Ent
│ │ │ │ +00006f00: 6974 6c65 640a 2020 2020 2022 4869 7374  itled.     "Hist
│ │ │ │ +00006f10: 6f72 7922 2069 6e20 7468 6520 7661 7269  ory" in the vari
│ │ │ │ +00006f20: 6f75 7320 6f72 6967 696e 616c 2064 6f63  ous original doc
│ │ │ │ +00006f30: 756d 656e 7473 2c20 666f 726d 696e 6720  uments, forming 
│ │ │ │ +00006f40: 6f6e 6520 7365 6374 696f 6e0a 2020 2020  one section.    
│ │ │ │ +00006f50: 2045 6e74 6974 6c65 6420 2248 6973 746f   Entitled "Histo
│ │ │ │ +00006f60: 7279 223b 206c 696b 6577 6973 6520 636f  ry"; likewise co
│ │ │ │ +00006f70: 6d62 696e 6520 616e 7920 7365 6374 696f  mbine any sectio
│ │ │ │ +00006f80: 6e73 2045 6e74 6974 6c65 640a 2020 2020  ns Entitled.    
│ │ │ │ +00006f90: 2022 4163 6b6e 6f77 6c65 6467 656d 656e   "Acknowledgemen
│ │ │ │ +00006fa0: 7473 222c 2061 6e64 2061 6e79 2073 6563  ts", and any sec
│ │ │ │ +00006fb0: 7469 6f6e 7320 456e 7469 746c 6564 2022  tions Entitled "
│ │ │ │ +00006fc0: 4465 6469 6361 7469 6f6e 7322 2e20 2059  Dedications".  Y
│ │ │ │ +00006fd0: 6f75 0a20 2020 2020 6d75 7374 2064 656c  ou.     must del
│ │ │ │ +00006fe0: 6574 6520 616c 6c20 7365 6374 696f 6e73  ete all sections
│ │ │ │ +00006ff0: 2045 6e74 6974 6c65 6420 2245 6e64 6f72   Entitled "Endor
│ │ │ │ +00007000: 7365 6d65 6e74 732e 220a 0a20 2036 2e20  sements."..  6. 
│ │ │ │ +00007010: 434f 4c4c 4543 5449 4f4e 5320 4f46 2044  COLLECTIONS OF D
│ │ │ │ +00007020: 4f43 554d 454e 5453 0a0a 2020 2020 2059  OCUMENTS..     Y
│ │ │ │ +00007030: 6f75 206d 6179 206d 616b 6520 6120 636f  ou may make a co
│ │ │ │ +00007040: 6c6c 6563 7469 6f6e 2063 6f6e 7369 7374  llection consist
│ │ │ │ +00007050: 696e 6720 6f66 2074 6865 2044 6f63 756d  ing of the Docum
│ │ │ │ +00007060: 656e 7420 616e 6420 6f74 6865 720a 2020  ent and other.  
│ │ │ │ +00007070: 2020 2064 6f63 756d 656e 7473 2072 656c     documents rel
│ │ │ │ +00007080: 6561 7365 6420 756e 6465 7220 7468 6973  eased under this
│ │ │ │ +00007090: 204c 6963 656e 7365 2c20 616e 6420 7265   License, and re
│ │ │ │ +000070a0: 706c 6163 6520 7468 6520 696e 6469 7669  place the indivi
│ │ │ │ +000070b0: 6475 616c 0a20 2020 2020 636f 7069 6573  dual.     copies
│ │ │ │ +000070c0: 206f 6620 7468 6973 204c 6963 656e 7365   of this License
│ │ │ │ +000070d0: 2069 6e20 7468 6520 7661 7269 6f75 7320   in the various 
│ │ │ │ +000070e0: 646f 6375 6d65 6e74 7320 7769 7468 2061  documents with a
│ │ │ │ +000070f0: 2073 696e 676c 6520 636f 7079 0a20 2020   single copy.   
│ │ │ │ +00007100: 2020 7468 6174 2069 7320 696e 636c 7564    that is includ
│ │ │ │ +00007110: 6564 2069 6e20 7468 6520 636f 6c6c 6563  ed in the collec
│ │ │ │ +00007120: 7469 6f6e 2c20 7072 6f76 6964 6564 2074  tion, provided t
│ │ │ │ +00007130: 6861 7420 796f 7520 666f 6c6c 6f77 2074  hat you follow t
│ │ │ │ +00007140: 6865 0a20 2020 2020 7275 6c65 7320 6f66  he.     rules of
│ │ │ │ +00007150: 2074 6869 7320 4c69 6365 6e73 6520 666f   this License fo
│ │ │ │ +00007160: 7220 7665 7262 6174 696d 2063 6f70 7969  r verbatim copyi
│ │ │ │ +00007170: 6e67 206f 6620 6561 6368 206f 6620 7468  ng of each of th
│ │ │ │ +00007180: 6520 646f 6375 6d65 6e74 730a 2020 2020  e documents.    
│ │ │ │ +00007190: 2069 6e20 616c 6c20 6f74 6865 7220 7265   in all other re
│ │ │ │ +000071a0: 7370 6563 7473 2e0a 0a20 2020 2020 596f  spects...     Yo
│ │ │ │ +000071b0: 7520 6d61 7920 6578 7472 6163 7420 6120  u may extract a 
│ │ │ │ +000071c0: 7369 6e67 6c65 2064 6f63 756d 656e 7420  single document 
│ │ │ │ +000071d0: 6672 6f6d 2073 7563 6820 6120 636f 6c6c  from such a coll
│ │ │ │ +000071e0: 6563 7469 6f6e 2c20 616e 640a 2020 2020  ection, and.    
│ │ │ │ +000071f0: 2064 6973 7472 6962 7574 6520 6974 2069   distribute it i
│ │ │ │ +00007200: 6e64 6976 6964 7561 6c6c 7920 756e 6465  ndividually unde
│ │ │ │ +00007210: 7220 7468 6973 204c 6963 656e 7365 2c20  r this License, 
│ │ │ │ +00007220: 7072 6f76 6964 6564 2079 6f75 2069 6e73  provided you ins
│ │ │ │ +00007230: 6572 740a 2020 2020 2061 2063 6f70 7920  ert.     a copy 
│ │ │ │ +00007240: 6f66 2074 6869 7320 4c69 6365 6e73 6520  of this License 
│ │ │ │ +00007250: 696e 746f 2074 6865 2065 7874 7261 6374  into the extract
│ │ │ │ +00007260: 6564 2064 6f63 756d 656e 742c 2061 6e64  ed document, and
│ │ │ │ +00007270: 2066 6f6c 6c6f 7720 7468 6973 0a20 2020   follow this.   
│ │ │ │ +00007280: 2020 4c69 6365 6e73 6520 696e 2061 6c6c    License in all
│ │ │ │ +00007290: 206f 7468 6572 2072 6573 7065 6374 7320   other respects 
│ │ │ │ +000072a0: 7265 6761 7264 696e 6720 7665 7262 6174  regarding verbat
│ │ │ │ +000072b0: 696d 2063 6f70 7969 6e67 206f 6620 7468  im copying of th
│ │ │ │ +000072c0: 6174 0a20 2020 2020 646f 6375 6d65 6e74  at.     document
│ │ │ │ +000072d0: 2e0a 0a20 2037 2e20 4147 4752 4547 4154  ...  7. AGGREGAT
│ │ │ │ +000072e0: 494f 4e20 5749 5448 2049 4e44 4550 454e  ION WITH INDEPEN
│ │ │ │ +000072f0: 4445 4e54 2057 4f52 4b53 0a0a 2020 2020  DENT WORKS..    
│ │ │ │ +00007300: 2041 2063 6f6d 7069 6c61 7469 6f6e 206f   A compilation o
│ │ │ │ +00007310: 6620 7468 6520 446f 6375 6d65 6e74 206f  f the Document o
│ │ │ │ +00007320: 7220 6974 7320 6465 7269 7661 7469 7665  r its derivative
│ │ │ │ +00007330: 7320 7769 7468 206f 7468 6572 0a20 2020  s with other.   
│ │ │ │ +00007340: 2020 7365 7061 7261 7465 2061 6e64 2069    separate and i
│ │ │ │ +00007350: 6e64 6570 656e 6465 6e74 2064 6f63 756d  ndependent docum
│ │ │ │ +00007360: 656e 7473 206f 7220 776f 726b 732c 2069  ents or works, i
│ │ │ │ +00007370: 6e20 6f72 206f 6e20 6120 766f 6c75 6d65  n or on a volume
│ │ │ │ +00007380: 206f 6620 610a 2020 2020 2073 746f 7261   of a.     stora
│ │ │ │ +00007390: 6765 206f 7220 6469 7374 7269 6275 7469  ge or distributi
│ │ │ │ +000073a0: 6f6e 206d 6564 6975 6d2c 2069 7320 6361  on medium, is ca
│ │ │ │ +000073b0: 6c6c 6564 2061 6e20 2261 6767 7265 6761  lled an "aggrega
│ │ │ │ +000073c0: 7465 2220 6966 2074 6865 0a20 2020 2020  te" if the.     
│ │ │ │ +000073d0: 636f 7079 7269 6768 7420 7265 7375 6c74  copyright result
│ │ │ │ +000073e0: 696e 6720 6672 6f6d 2074 6865 2063 6f6d  ing from the com
│ │ │ │ +000073f0: 7069 6c61 7469 6f6e 2069 7320 6e6f 7420  pilation is not 
│ │ │ │ +00007400: 7573 6564 2074 6f20 6c69 6d69 7420 7468  used to limit th
│ │ │ │ +00007410: 650a 2020 2020 206c 6567 616c 2072 6967  e.     legal rig
│ │ │ │ +00007420: 6874 7320 6f66 2074 6865 2063 6f6d 7069  hts of the compi
│ │ │ │ +00007430: 6c61 7469 6f6e 2773 2075 7365 7273 2062  lation's users b
│ │ │ │ +00007440: 6579 6f6e 6420 7768 6174 2074 6865 2069  eyond what the i
│ │ │ │ +00007450: 6e64 6976 6964 7561 6c0a 2020 2020 2077  ndividual.     w
│ │ │ │ +00007460: 6f72 6b73 2070 6572 6d69 742e 2020 5768  orks permit.  Wh
│ │ │ │ +00007470: 656e 2074 6865 2044 6f63 756d 656e 7420  en the Document 
│ │ │ │ +00007480: 6973 2069 6e63 6c75 6465 6420 696e 2061  is included in a
│ │ │ │ +00007490: 6e20 6167 6772 6567 6174 652c 2074 6869  n aggregate, thi
│ │ │ │ +000074a0: 730a 2020 2020 204c 6963 656e 7365 2064  s.     License d
│ │ │ │ +000074b0: 6f65 7320 6e6f 7420 6170 706c 7920 746f  oes not apply to
│ │ │ │ +000074c0: 2074 6865 206f 7468 6572 2077 6f72 6b73   the other works
│ │ │ │ +000074d0: 2069 6e20 7468 6520 6167 6772 6567 6174   in the aggregat
│ │ │ │ +000074e0: 6520 7768 6963 680a 2020 2020 2061 7265  e which.     are
│ │ │ │ +000074f0: 206e 6f74 2074 6865 6d73 656c 7665 7320   not themselves 
│ │ │ │ +00007500: 6465 7269 7661 7469 7665 2077 6f72 6b73  derivative works
│ │ │ │ +00007510: 206f 6620 7468 6520 446f 6375 6d65 6e74   of the Document
│ │ │ │ +00007520: 2e0a 0a20 2020 2020 4966 2074 6865 2043  ...     If the C
│ │ │ │ +00007530: 6f76 6572 2054 6578 7420 7265 7175 6972  over Text requir
│ │ │ │ +00007540: 656d 656e 7420 6f66 2073 6563 7469 6f6e  ement of section
│ │ │ │ +00007550: 2033 2069 7320 6170 706c 6963 6162 6c65   3 is applicable
│ │ │ │ +00007560: 2074 6f20 7468 6573 650a 2020 2020 2063   to these.     c
│ │ │ │ +00007570: 6f70 6965 7320 6f66 2074 6865 2044 6f63  opies of the Doc
│ │ │ │ +00007580: 756d 656e 742c 2074 6865 6e20 6966 2074  ument, then if t
│ │ │ │ +00007590: 6865 2044 6f63 756d 656e 7420 6973 206c  he Document is l
│ │ │ │ +000075a0: 6573 7320 7468 616e 206f 6e65 2068 616c  ess than one hal
│ │ │ │ +000075b0: 660a 2020 2020 206f 6620 7468 6520 656e  f.     of the en
│ │ │ │ +000075c0: 7469 7265 2061 6767 7265 6761 7465 2c20  tire aggregate, 
│ │ │ │ +000075d0: 7468 6520 446f 6375 6d65 6e74 2773 2043  the Document's C
│ │ │ │ +000075e0: 6f76 6572 2054 6578 7473 206d 6179 2062  over Texts may b
│ │ │ │ +000075f0: 6520 706c 6163 6564 0a20 2020 2020 6f6e  e placed.     on
│ │ │ │ +00007600: 2063 6f76 6572 7320 7468 6174 2062 7261   covers that bra
│ │ │ │ +00007610: 636b 6574 2074 6865 2044 6f63 756d 656e  cket the Documen
│ │ │ │ +00007620: 7420 7769 7468 696e 2074 6865 2061 6767  t within the agg
│ │ │ │ +00007630: 7265 6761 7465 2c20 6f72 2074 6865 0a20  regate, or the. 
│ │ │ │ +00007640: 2020 2020 656c 6563 7472 6f6e 6963 2065      electronic e
│ │ │ │ +00007650: 7175 6976 616c 656e 7420 6f66 2063 6f76  quivalent of cov
│ │ │ │ +00007660: 6572 7320 6966 2074 6865 2044 6f63 756d  ers if the Docum
│ │ │ │ +00007670: 656e 7420 6973 2069 6e20 656c 6563 7472  ent is in electr
│ │ │ │ +00007680: 6f6e 6963 0a20 2020 2020 666f 726d 2e20  onic.     form. 
│ │ │ │ +00007690: 204f 7468 6572 7769 7365 2074 6865 7920   Otherwise they 
│ │ │ │ +000076a0: 6d75 7374 2061 7070 6561 7220 6f6e 2070  must appear on p
│ │ │ │ +000076b0: 7269 6e74 6564 2063 6f76 6572 7320 7468  rinted covers th
│ │ │ │ +000076c0: 6174 2062 7261 636b 6574 0a20 2020 2020  at bracket.     
│ │ │ │ +000076d0: 7468 6520 7768 6f6c 6520 6167 6772 6567  the whole aggreg
│ │ │ │ +000076e0: 6174 652e 0a0a 2020 382e 2054 5241 4e53  ate...  8. TRANS
│ │ │ │ +000076f0: 4c41 5449 4f4e 0a0a 2020 2020 2054 7261  LATION..     Tra
│ │ │ │ +00007700: 6e73 6c61 7469 6f6e 2069 7320 636f 6e73  nslation is cons
│ │ │ │ +00007710: 6964 6572 6564 2061 206b 696e 6420 6f66  idered a kind of
│ │ │ │ +00007720: 206d 6f64 6966 6963 6174 696f 6e2c 2073   modification, s
│ │ │ │ +00007730: 6f20 796f 7520 6d61 790a 2020 2020 2064  o you may.     d
│ │ │ │ +00007740: 6973 7472 6962 7574 6520 7472 616e 736c  istribute transl
│ │ │ │ +00007750: 6174 696f 6e73 206f 6620 7468 6520 446f  ations of the Do
│ │ │ │ +00007760: 6375 6d65 6e74 2075 6e64 6572 2074 6865  cument under the
│ │ │ │ +00007770: 2074 6572 6d73 206f 6620 7365 6374 696f   terms of sectio
│ │ │ │ +00007780: 6e0a 2020 2020 2034 2e20 2052 6570 6c61  n.     4.  Repla
│ │ │ │ +00007790: 6369 6e67 2049 6e76 6172 6961 6e74 2053  cing Invariant S
│ │ │ │ +000077a0: 6563 7469 6f6e 7320 7769 7468 2074 7261  ections with tra
│ │ │ │ +000077b0: 6e73 6c61 7469 6f6e 7320 7265 7175 6972  nslations requir
│ │ │ │ +000077c0: 6573 2073 7065 6369 616c 0a20 2020 2020  es special.     
│ │ │ │ +000077d0: 7065 726d 6973 7369 6f6e 2066 726f 6d20  permission from 
│ │ │ │ +000077e0: 7468 6569 7220 636f 7079 7269 6768 7420  their copyright 
│ │ │ │ +000077f0: 686f 6c64 6572 732c 2062 7574 2079 6f75  holders, but you
│ │ │ │ +00007800: 206d 6179 2069 6e63 6c75 6465 0a20 2020   may include.   
│ │ │ │ +00007810: 2020 7472 616e 736c 6174 696f 6e73 206f    translations o
│ │ │ │ +00007820: 6620 736f 6d65 206f 7220 616c 6c20 496e  f some or all In
│ │ │ │ +00007830: 7661 7269 616e 7420 5365 6374 696f 6e73  variant Sections
│ │ │ │ +00007840: 2069 6e20 6164 6469 7469 6f6e 2074 6f20   in addition to 
│ │ │ │ +00007850: 7468 650a 2020 2020 206f 7269 6769 6e61  the.     origina
│ │ │ │ +00007860: 6c20 7665 7273 696f 6e73 206f 6620 7468  l versions of th
│ │ │ │ +00007870: 6573 6520 496e 7661 7269 616e 7420 5365  ese Invariant Se
│ │ │ │ +00007880: 6374 696f 6e73 2e20 2059 6f75 206d 6179  ctions.  You may
│ │ │ │ +00007890: 2069 6e63 6c75 6465 2061 0a20 2020 2020   include a.     
│ │ │ │ +000078a0: 7472 616e 736c 6174 696f 6e20 6f66 2074  translation of t
│ │ │ │ +000078b0: 6869 7320 4c69 6365 6e73 652c 2061 6e64  his License, and
│ │ │ │ +000078c0: 2061 6c6c 2074 6865 206c 6963 656e 7365   all the license
│ │ │ │ +000078d0: 206e 6f74 6963 6573 2069 6e20 7468 650a   notices in the.
│ │ │ │ +000078e0: 2020 2020 2044 6f63 756d 656e 742c 2061       Document, a
│ │ │ │ +000078f0: 6e64 2061 6e79 2057 6172 7261 6e74 7920  nd any Warranty 
│ │ │ │ +00007900: 4469 7363 6c61 696d 6572 732c 2070 726f  Disclaimers, pro
│ │ │ │ +00007910: 7669 6465 6420 7468 6174 2079 6f75 2061  vided that you a
│ │ │ │ +00007920: 6c73 6f0a 2020 2020 2069 6e63 6c75 6465  lso.     include
│ │ │ │ +00007930: 2074 6865 206f 7269 6769 6e61 6c20 456e   the original En
│ │ │ │ +00007940: 676c 6973 6820 7665 7273 696f 6e20 6f66  glish version of
│ │ │ │ +00007950: 2074 6869 7320 4c69 6365 6e73 6520 616e   this License an
│ │ │ │ +00007960: 6420 7468 650a 2020 2020 206f 7269 6769  d the.     origi
│ │ │ │ +00007970: 6e61 6c20 7665 7273 696f 6e73 206f 6620  nal versions of 
│ │ │ │ +00007980: 7468 6f73 6520 6e6f 7469 6365 7320 616e  those notices an
│ │ │ │ +00007990: 6420 6469 7363 6c61 696d 6572 732e 2020  d disclaimers.  
│ │ │ │ +000079a0: 496e 2063 6173 6520 6f66 2061 0a20 2020  In case of a.   
│ │ │ │ +000079b0: 2020 6469 7361 6772 6565 6d65 6e74 2062    disagreement b
│ │ │ │ +000079c0: 6574 7765 656e 2074 6865 2074 7261 6e73  etween the trans
│ │ │ │ +000079d0: 6c61 7469 6f6e 2061 6e64 2074 6865 206f  lation and the o
│ │ │ │ +000079e0: 7269 6769 6e61 6c20 7665 7273 696f 6e20  riginal version 
│ │ │ │ +000079f0: 6f66 0a20 2020 2020 7468 6973 204c 6963  of.     this Lic
│ │ │ │ +00007a00: 656e 7365 206f 7220 6120 6e6f 7469 6365  ense or a notice
│ │ │ │ +00007a10: 206f 7220 6469 7363 6c61 696d 6572 2c20   or disclaimer, 
│ │ │ │ +00007a20: 7468 6520 6f72 6967 696e 616c 2076 6572  the original ver
│ │ │ │ +00007a30: 7369 6f6e 2077 696c 6c0a 2020 2020 2070  sion will.     p
│ │ │ │ +00007a40: 7265 7661 696c 2e0a 0a20 2020 2020 4966  revail...     If
│ │ │ │ +00007a50: 2061 2073 6563 7469 6f6e 2069 6e20 7468   a section in th
│ │ │ │ +00007a60: 6520 446f 6375 6d65 6e74 2069 7320 456e  e Document is En
│ │ │ │ +00007a70: 7469 746c 6564 2022 4163 6b6e 6f77 6c65  titled "Acknowle
│ │ │ │ +00007a80: 6467 656d 656e 7473 222c 0a20 2020 2020  dgements",.     
│ │ │ │ +00007a90: 2244 6564 6963 6174 696f 6e73 222c 206f  "Dedications", o
│ │ │ │ +00007aa0: 7220 2248 6973 746f 7279 222c 2074 6865  r "History", the
│ │ │ │ +00007ab0: 2072 6571 7569 7265 6d65 6e74 2028 7365   requirement (se
│ │ │ │ +00007ac0: 6374 696f 6e20 3429 2074 6f0a 2020 2020  ction 4) to.    
│ │ │ │ +00007ad0: 2050 7265 7365 7276 6520 6974 7320 5469   Preserve its Ti
│ │ │ │ +00007ae0: 746c 6520 2873 6563 7469 6f6e 2031 2920  tle (section 1) 
│ │ │ │ +00007af0: 7769 6c6c 2074 7970 6963 616c 6c79 2072  will typically r
│ │ │ │ +00007b00: 6571 7569 7265 2063 6861 6e67 696e 6720  equire changing 
│ │ │ │ +00007b10: 7468 650a 2020 2020 2061 6374 7561 6c20  the.     actual 
│ │ │ │ +00007b20: 7469 746c 652e 0a0a 2020 392e 2054 4552  title...  9. TER
│ │ │ │ +00007b30: 4d49 4e41 5449 4f4e 0a0a 2020 2020 2059  MINATION..     Y
│ │ │ │ +00007b40: 6f75 206d 6179 206e 6f74 2063 6f70 792c  ou may not copy,
│ │ │ │ +00007b50: 206d 6f64 6966 792c 2073 7562 6c69 6365   modify, sublice
│ │ │ │ +00007b60: 6e73 652c 206f 7220 6469 7374 7269 6275  nse, or distribu
│ │ │ │ +00007b70: 7465 2074 6865 2044 6f63 756d 656e 740a  te the Document.
│ │ │ │ +00007b80: 2020 2020 2065 7863 6570 7420 6173 2065       except as e
│ │ │ │ +00007b90: 7870 7265 7373 6c79 2070 726f 7669 6465  xpressly provide
│ │ │ │ +00007ba0: 6420 756e 6465 7220 7468 6973 204c 6963  d under this Lic
│ │ │ │ +00007bb0: 656e 7365 2e20 2041 6e79 2061 7474 656d  ense.  Any attem
│ │ │ │ +00007bc0: 7074 0a20 2020 2020 6f74 6865 7277 6973  pt.     otherwis
│ │ │ │ +00007bd0: 6520 746f 2063 6f70 792c 206d 6f64 6966  e to copy, modif
│ │ │ │ +00007be0: 792c 2073 7562 6c69 6365 6e73 652c 206f  y, sublicense, o
│ │ │ │ +00007bf0: 7220 6469 7374 7269 6275 7465 2069 7420  r distribute it 
│ │ │ │ +00007c00: 6973 2076 6f69 642c 0a20 2020 2020 616e  is void,.     an
│ │ │ │ +00007c10: 6420 7769 6c6c 2061 7574 6f6d 6174 6963  d will automatic
│ │ │ │ +00007c20: 616c 6c79 2074 6572 6d69 6e61 7465 2079  ally terminate y
│ │ │ │ +00007c30: 6f75 7220 7269 6768 7473 2075 6e64 6572  our rights under
│ │ │ │ +00007c40: 2074 6869 7320 4c69 6365 6e73 652e 0a0a   this License...
│ │ │ │ +00007c50: 2020 2020 2048 6f77 6576 6572 2c20 6966       However, if
│ │ │ │ +00007c60: 2079 6f75 2063 6561 7365 2061 6c6c 2076   you cease all v
│ │ │ │ +00007c70: 696f 6c61 7469 6f6e 206f 6620 7468 6973  iolation of this
│ │ │ │ +00007c80: 204c 6963 656e 7365 2c20 7468 656e 2079   License, then y
│ │ │ │ +00007c90: 6f75 720a 2020 2020 206c 6963 656e 7365  our.     license
│ │ │ │ +00007ca0: 2066 726f 6d20 6120 7061 7274 6963 756c   from a particul
│ │ │ │ +00007cb0: 6172 2063 6f70 7972 6967 6874 2068 6f6c  ar copyright hol
│ │ │ │ +00007cc0: 6465 7220 6973 2072 6569 6e73 7461 7465  der is reinstate
│ │ │ │ +00007cd0: 6420 2861 290a 2020 2020 2070 726f 7669  d (a).     provi
│ │ │ │ +00007ce0: 7369 6f6e 616c 6c79 2c20 756e 6c65 7373  sionally, unless
│ │ │ │ +00007cf0: 2061 6e64 2075 6e74 696c 2074 6865 2063   and until the c
│ │ │ │ +00007d00: 6f70 7972 6967 6874 2068 6f6c 6465 7220  opyright holder 
│ │ │ │ +00007d10: 6578 706c 6963 6974 6c79 2061 6e64 0a20  explicitly and. 
│ │ │ │ +00007d20: 2020 2020 6669 6e61 6c6c 7920 7465 726d      finally term
│ │ │ │ +00007d30: 696e 6174 6573 2079 6f75 7220 6c69 6365  inates your lice
│ │ │ │ +00007d40: 6e73 652c 2061 6e64 2028 6229 2070 6572  nse, and (b) per
│ │ │ │ +00007d50: 6d61 6e65 6e74 6c79 2c20 6966 2074 6865  manently, if the
│ │ │ │ +00007d60: 0a20 2020 2020 636f 7079 7269 6768 7420  .     copyright 
│ │ │ │ +00007d70: 686f 6c64 6572 2066 6169 6c73 2074 6f20  holder fails to 
│ │ │ │ +00007d80: 6e6f 7469 6679 2079 6f75 206f 6620 7468  notify you of th
│ │ │ │ +00007d90: 6520 7669 6f6c 6174 696f 6e20 6279 2073  e violation by s
│ │ │ │ +00007da0: 6f6d 650a 2020 2020 2072 6561 736f 6e61  ome.     reasona
│ │ │ │ +00007db0: 626c 6520 6d65 616e 7320 7072 696f 7220  ble means prior 
│ │ │ │ +00007dc0: 746f 2036 3020 6461 7973 2061 6674 6572  to 60 days after
│ │ │ │ +00007dd0: 2074 6865 2063 6573 7361 7469 6f6e 2e0a   the cessation..
│ │ │ │ +00007de0: 0a20 2020 2020 4d6f 7265 6f76 6572 2c20  .     Moreover, 
│ │ │ │ +00007df0: 796f 7572 206c 6963 656e 7365 2066 726f  your license fro
│ │ │ │ +00007e00: 6d20 6120 7061 7274 6963 756c 6172 2063  m a particular c
│ │ │ │ +00007e10: 6f70 7972 6967 6874 2068 6f6c 6465 7220  opyright holder 
│ │ │ │ +00007e20: 6973 0a20 2020 2020 7265 696e 7374 6174  is.     reinstat
│ │ │ │ +00007e30: 6564 2070 6572 6d61 6e65 6e74 6c79 2069  ed permanently i
│ │ │ │ +00007e40: 6620 7468 6520 636f 7079 7269 6768 7420  f the copyright 
│ │ │ │ +00007e50: 686f 6c64 6572 206e 6f74 6966 6965 7320  holder notifies 
│ │ │ │ +00007e60: 796f 7520 6f66 2074 6865 0a20 2020 2020  you of the.     
│ │ │ │ +00007e70: 7669 6f6c 6174 696f 6e20 6279 2073 6f6d  violation by som
│ │ │ │ +00007e80: 6520 7265 6173 6f6e 6162 6c65 206d 6561  e reasonable mea
│ │ │ │ +00007e90: 6e73 2c20 7468 6973 2069 7320 7468 6520  ns, this is the 
│ │ │ │ +00007ea0: 6669 7273 7420 7469 6d65 2079 6f75 2068  first time you h
│ │ │ │ +00007eb0: 6176 650a 2020 2020 2072 6563 6569 7665  ave.     receive
│ │ │ │ +00007ec0: 6420 6e6f 7469 6365 206f 6620 7669 6f6c  d notice of viol
│ │ │ │ +00007ed0: 6174 696f 6e20 6f66 2074 6869 7320 4c69  ation of this Li
│ │ │ │ +00007ee0: 6365 6e73 6520 2866 6f72 2061 6e79 2077  cense (for any w
│ │ │ │ +00007ef0: 6f72 6b29 2066 726f 6d0a 2020 2020 2074  ork) from.     t
│ │ │ │ +00007f00: 6861 7420 636f 7079 7269 6768 7420 686f  hat copyright ho
│ │ │ │ +00007f10: 6c64 6572 2c20 616e 6420 796f 7520 6375  lder, and you cu
│ │ │ │ +00007f20: 7265 2074 6865 2076 696f 6c61 7469 6f6e  re the violation
│ │ │ │ +00007f30: 2070 7269 6f72 2074 6f20 3330 2064 6179   prior to 30 day
│ │ │ │ +00007f40: 730a 2020 2020 2061 6674 6572 2079 6f75  s.     after you
│ │ │ │ +00007f50: 7220 7265 6365 6970 7420 6f66 2074 6865  r receipt of the
│ │ │ │ +00007f60: 206e 6f74 6963 652e 0a0a 2020 2020 2054   notice...     T
│ │ │ │ +00007f70: 6572 6d69 6e61 7469 6f6e 206f 6620 796f  ermination of yo
│ │ │ │ +00007f80: 7572 2072 6967 6874 7320 756e 6465 7220  ur rights under 
│ │ │ │ +00007f90: 7468 6973 2073 6563 7469 6f6e 2064 6f65  this section doe
│ │ │ │ +00007fa0: 7320 6e6f 7420 7465 726d 696e 6174 650a  s not terminate.
│ │ │ │ +00007fb0: 2020 2020 2074 6865 206c 6963 656e 7365       the license
│ │ │ │ +00007fc0: 7320 6f66 2070 6172 7469 6573 2077 686f  s of parties who
│ │ │ │ +00007fd0: 2068 6176 6520 7265 6365 6976 6564 2063   have received c
│ │ │ │ +00007fe0: 6f70 6965 7320 6f72 2072 6967 6874 7320  opies or rights 
│ │ │ │ +00007ff0: 6672 6f6d 2079 6f75 0a20 2020 2020 756e  from you.     un
│ │ │ │ +00008000: 6465 7220 7468 6973 204c 6963 656e 7365  der this License
│ │ │ │ +00008010: 2e20 2049 6620 796f 7572 2072 6967 6874  .  If your right
│ │ │ │ +00008020: 7320 6861 7665 2062 6565 6e20 7465 726d  s have been term
│ │ │ │ +00008030: 696e 6174 6564 2061 6e64 206e 6f74 0a20  inated and not. 
│ │ │ │ +00008040: 2020 2020 7065 726d 616e 656e 746c 7920      permanently 
│ │ │ │ +00008050: 7265 696e 7374 6174 6564 2c20 7265 6365  reinstated, rece
│ │ │ │ +00008060: 6970 7420 6f66 2061 2063 6f70 7920 6f66  ipt of a copy of
│ │ │ │ +00008070: 2073 6f6d 6520 6f72 2061 6c6c 206f 6620   some or all of 
│ │ │ │ +00008080: 7468 650a 2020 2020 2073 616d 6520 6d61  the.     same ma
│ │ │ │ +00008090: 7465 7269 616c 2064 6f65 7320 6e6f 7420  terial does not 
│ │ │ │ +000080a0: 6769 7665 2079 6f75 2061 6e79 2072 6967  give you any rig
│ │ │ │ +000080b0: 6874 7320 746f 2075 7365 2069 742e 0a0a  hts to use it...
│ │ │ │ +000080c0: 2020 3130 2e20 4655 5455 5245 2052 4556    10. FUTURE REV
│ │ │ │ +000080d0: 4953 494f 4e53 204f 4620 5448 4953 204c  ISIONS OF THIS L
│ │ │ │ +000080e0: 4943 454e 5345 0a0a 2020 2020 2054 6865  ICENSE..     The
│ │ │ │ +000080f0: 2046 7265 6520 536f 6674 7761 7265 2046   Free Software F
│ │ │ │ +00008100: 6f75 6e64 6174 696f 6e20 6d61 7920 7075  oundation may pu
│ │ │ │ +00008110: 626c 6973 6820 6e65 772c 2072 6576 6973  blish new, revis
│ │ │ │ +00008120: 6564 2076 6572 7369 6f6e 7320 6f66 0a20  ed versions of. 
│ │ │ │ +00008130: 2020 2020 7468 6520 474e 5520 4672 6565      the GNU Free
│ │ │ │ +00008140: 2044 6f63 756d 656e 7461 7469 6f6e 204c   Documentation L
│ │ │ │ +00008150: 6963 656e 7365 2066 726f 6d20 7469 6d65  icense from time
│ │ │ │ +00008160: 2074 6f20 7469 6d65 2e20 2053 7563 6820   to time.  Such 
│ │ │ │ +00008170: 6e65 770a 2020 2020 2076 6572 7369 6f6e  new.     version
│ │ │ │ +00008180: 7320 7769 6c6c 2062 6520 7369 6d69 6c61  s will be simila
│ │ │ │ +00008190: 7220 696e 2073 7069 7269 7420 746f 2074  r in spirit to t
│ │ │ │ +000081a0: 6865 2070 7265 7365 6e74 2076 6572 7369  he present versi
│ │ │ │ +000081b0: 6f6e 2c20 6275 7420 6d61 790a 2020 2020  on, but may.    
│ │ │ │ +000081c0: 2064 6966 6665 7220 696e 2064 6574 6169   differ in detai
│ │ │ │ +000081d0: 6c20 746f 2061 6464 7265 7373 206e 6577  l to address new
│ │ │ │ +000081e0: 2070 726f 626c 656d 7320 6f72 2063 6f6e   problems or con
│ │ │ │ +000081f0: 6365 726e 732e 2020 5365 650a 2020 2020  cerns.  See.    
│ │ │ │ +00008200: 203c 6874 7470 733a 2f2f 7777 772e 676e   <https://www.gn
│ │ │ │ +00008210: 752e 6f72 672f 6c69 6365 6e73 6573 2f3e  u.org/licenses/>
│ │ │ │ +00008220: 2e0a 0a20 2020 2020 4561 6368 2076 6572  ...     Each ver
│ │ │ │ +00008230: 7369 6f6e 206f 6620 7468 6520 4c69 6365  sion of the Lice
│ │ │ │ +00008240: 6e73 6520 6973 2067 6976 656e 2061 2064  nse is given a d
│ │ │ │ +00008250: 6973 7469 6e67 7569 7368 696e 6720 7665  istinguishing ve
│ │ │ │ +00008260: 7273 696f 6e0a 2020 2020 206e 756d 6265  rsion.     numbe
│ │ │ │ +00008270: 722e 2020 4966 2074 6865 2044 6f63 756d  r.  If the Docum
│ │ │ │ +00008280: 656e 7420 7370 6563 6966 6965 7320 7468  ent specifies th
│ │ │ │ +00008290: 6174 2061 2070 6172 7469 6375 6c61 7220  at a particular 
│ │ │ │ +000082a0: 6e75 6d62 6572 6564 0a20 2020 2020 7665  numbered.     ve
│ │ │ │ +000082b0: 7273 696f 6e20 6f66 2074 6869 7320 4c69  rsion of this Li
│ │ │ │ +000082c0: 6365 6e73 6520 226f 7220 616e 7920 6c61  cense "or any la
│ │ │ │ +000082d0: 7465 7220 7665 7273 696f 6e22 2061 7070  ter version" app
│ │ │ │ +000082e0: 6c69 6573 2074 6f20 6974 2c20 796f 750a  lies to it, you.
│ │ │ │ +000082f0: 2020 2020 2068 6176 6520 7468 6520 6f70       have the op
│ │ │ │ +00008300: 7469 6f6e 206f 6620 666f 6c6c 6f77 696e  tion of followin
│ │ │ │ +00008310: 6720 7468 6520 7465 726d 7320 616e 6420  g the terms and 
│ │ │ │ +00008320: 636f 6e64 6974 696f 6e73 2065 6974 6865  conditions eithe
│ │ │ │ +00008330: 7220 6f66 0a20 2020 2020 7468 6174 2073  r of.     that s
│ │ │ │ +00008340: 7065 6369 6669 6564 2076 6572 7369 6f6e  pecified version
│ │ │ │ +00008350: 206f 7220 6f66 2061 6e79 206c 6174 6572   or of any later
│ │ │ │ +00008360: 2076 6572 7369 6f6e 2074 6861 7420 6861   version that ha
│ │ │ │ +00008370: 7320 6265 656e 0a20 2020 2020 7075 626c  s been.     publ
│ │ │ │ +00008380: 6973 6865 6420 286e 6f74 2061 7320 6120  ished (not as a 
│ │ │ │ +00008390: 6472 6166 7429 2062 7920 7468 6520 4672  draft) by the Fr
│ │ │ │ +000083a0: 6565 2053 6f66 7477 6172 6520 466f 756e  ee Software Foun
│ │ │ │ +000083b0: 6461 7469 6f6e 2e20 2049 6620 7468 650a  dation.  If the.
│ │ │ │ +000083c0: 2020 2020 2044 6f63 756d 656e 7420 646f       Document do
│ │ │ │ +000083d0: 6573 206e 6f74 2073 7065 6369 6679 2061  es not specify a
│ │ │ │ +000083e0: 2076 6572 7369 6f6e 206e 756d 6265 7220   version number 
│ │ │ │ +000083f0: 6f66 2074 6869 7320 4c69 6365 6e73 652c  of this License,
│ │ │ │ +00008400: 2079 6f75 206d 6179 0a20 2020 2020 6368   you may.     ch
│ │ │ │ +00008410: 6f6f 7365 2061 6e79 2076 6572 7369 6f6e  oose any version
│ │ │ │ +00008420: 2065 7665 7220 7075 626c 6973 6865 6420   ever published 
│ │ │ │ +00008430: 286e 6f74 2061 7320 6120 6472 6166 7429  (not as a draft)
│ │ │ │ +00008440: 2062 7920 7468 6520 4672 6565 0a20 2020   by the Free.   
│ │ │ │ +00008450: 2020 536f 6674 7761 7265 2046 6f75 6e64    Software Found
│ │ │ │ +00008460: 6174 696f 6e2e 2020 4966 2074 6865 2044  ation.  If the D
│ │ │ │ +00008470: 6f63 756d 656e 7420 7370 6563 6966 6965  ocument specifie
│ │ │ │ +00008480: 7320 7468 6174 2061 2070 726f 7879 2063  s that a proxy c
│ │ │ │ +00008490: 616e 0a20 2020 2020 6465 6369 6465 2077  an.     decide w
│ │ │ │ +000084a0: 6869 6368 2066 7574 7572 6520 7665 7273  hich future vers
│ │ │ │ +000084b0: 696f 6e73 206f 6620 7468 6973 204c 6963  ions of this Lic
│ │ │ │ +000084c0: 656e 7365 2063 616e 2062 6520 7573 6564  ense can be used
│ │ │ │ +000084d0: 2c20 7468 6174 0a20 2020 2020 7072 6f78  , that.     prox
│ │ │ │ +000084e0: 7927 7320 7075 626c 6963 2073 7461 7465  y's public state
│ │ │ │ +000084f0: 6d65 6e74 206f 6620 6163 6365 7074 616e  ment of acceptan
│ │ │ │ +00008500: 6365 206f 6620 6120 7665 7273 696f 6e20  ce of a version 
│ │ │ │ +00008510: 7065 726d 616e 656e 746c 790a 2020 2020  permanently.    
│ │ │ │ +00008520: 2061 7574 686f 7269 7a65 7320 796f 7520   authorizes you 
│ │ │ │ +00008530: 746f 2063 686f 6f73 6520 7468 6174 2076  to choose that v
│ │ │ │ +00008540: 6572 7369 6f6e 2066 6f72 2074 6865 2044  ersion for the D
│ │ │ │ +00008550: 6f63 756d 656e 742e 0a0a 2020 3131 2e20  ocument...  11. 
│ │ │ │ +00008560: 5245 4c49 4345 4e53 494e 470a 0a20 2020  RELICENSING..   
│ │ │ │ +00008570: 2020 224d 6173 7369 7665 204d 756c 7469    "Massive Multi
│ │ │ │ +00008580: 6175 7468 6f72 2043 6f6c 6c61 626f 7261  author Collabora
│ │ │ │ +00008590: 7469 6f6e 2053 6974 6522 2028 6f72 2022  tion Site" (or "
│ │ │ │ +000085a0: 4d4d 4320 5369 7465 2229 206d 6561 6e73  MMC Site") means
│ │ │ │ +000085b0: 2061 6e79 0a20 2020 2020 576f 726c 6420   any.     World 
│ │ │ │ +000085c0: 5769 6465 2057 6562 2073 6572 7665 7220  Wide Web server 
│ │ │ │ +000085d0: 7468 6174 2070 7562 6c69 7368 6573 2063  that publishes c
│ │ │ │ +000085e0: 6f70 7972 6967 6874 6162 6c65 2077 6f72  opyrightable wor
│ │ │ │ +000085f0: 6b73 2061 6e64 2061 6c73 6f0a 2020 2020  ks and also.    
│ │ │ │ +00008600: 2070 726f 7669 6465 7320 7072 6f6d 696e   provides promin
│ │ │ │ +00008610: 656e 7420 6661 6369 6c69 7469 6573 2066  ent facilities f
│ │ │ │ +00008620: 6f72 2061 6e79 626f 6479 2074 6f20 6564  or anybody to ed
│ │ │ │ +00008630: 6974 2074 686f 7365 2077 6f72 6b73 2e20  it those works. 
│ │ │ │ +00008640: 2041 0a20 2020 2020 7075 626c 6963 2077   A.     public w
│ │ │ │ +00008650: 696b 6920 7468 6174 2061 6e79 626f 6479  iki that anybody
│ │ │ │ +00008660: 2063 616e 2065 6469 7420 6973 2061 6e20   can edit is an 
│ │ │ │ +00008670: 6578 616d 706c 6520 6f66 2073 7563 6820  example of such 
│ │ │ │ +00008680: 6120 7365 7276 6572 2e0a 2020 2020 2041  a server..     A
│ │ │ │ +00008690: 2022 4d61 7373 6976 6520 4d75 6c74 6961   "Massive Multia
│ │ │ │ +000086a0: 7574 686f 7220 436f 6c6c 6162 6f72 6174  uthor Collaborat
│ │ │ │ +000086b0: 696f 6e22 2028 6f72 2022 4d4d 4322 2920  ion" (or "MMC") 
│ │ │ │ +000086c0: 636f 6e74 6169 6e65 6420 696e 2074 6865  contained in the
│ │ │ │ +000086d0: 0a20 2020 2020 7369 7465 206d 6561 6e73  .     site means
│ │ │ │ +000086e0: 2061 6e79 2073 6574 206f 6620 636f 7079   any set of copy
│ │ │ │ +000086f0: 7269 6768 7461 626c 6520 776f 726b 7320  rightable works 
│ │ │ │ +00008700: 7468 7573 2070 7562 6c69 7368 6564 206f  thus published o
│ │ │ │ +00008710: 6e20 7468 6520 4d4d 430a 2020 2020 2073  n the MMC.     s
│ │ │ │ +00008720: 6974 652e 0a0a 2020 2020 2022 4343 2d42  ite...     "CC-B
│ │ │ │ +00008730: 592d 5341 2220 6d65 616e 7320 7468 6520  Y-SA" means the 
│ │ │ │ +00008740: 4372 6561 7469 7665 2043 6f6d 6d6f 6e73  Creative Commons
│ │ │ │ +00008750: 2041 7474 7269 6275 7469 6f6e 2d53 6861   Attribution-Sha
│ │ │ │ +00008760: 7265 2041 6c69 6b65 2033 2e30 0a20 2020  re Alike 3.0.   
│ │ │ │ +00008770: 2020 6c69 6365 6e73 6520 7075 626c 6973    license publis
│ │ │ │ +00008780: 6865 6420 6279 2043 7265 6174 6976 6520  hed by Creative 
│ │ │ │ +00008790: 436f 6d6d 6f6e 7320 436f 7270 6f72 6174  Commons Corporat
│ │ │ │ +000087a0: 696f 6e2c 2061 206e 6f74 2d66 6f72 2d70  ion, a not-for-p
│ │ │ │ +000087b0: 726f 6669 740a 2020 2020 2063 6f72 706f  rofit.     corpo
│ │ │ │ +000087c0: 7261 7469 6f6e 2077 6974 6820 6120 7072  ration with a pr
│ │ │ │ +000087d0: 696e 6369 7061 6c20 706c 6163 6520 6f66  incipal place of
│ │ │ │ +000087e0: 2062 7573 696e 6573 7320 696e 2053 616e   business in San
│ │ │ │ +000087f0: 2046 7261 6e63 6973 636f 2c0a 2020 2020   Francisco,.    
│ │ │ │ +00008800: 2043 616c 6966 6f72 6e69 612c 2061 7320   California, as 
│ │ │ │ +00008810: 7765 6c6c 2061 7320 6675 7475 7265 2063  well as future c
│ │ │ │ +00008820: 6f70 796c 6566 7420 7665 7273 696f 6e73  opyleft versions
│ │ │ │ +00008830: 206f 6620 7468 6174 206c 6963 656e 7365   of that license
│ │ │ │ +00008840: 0a20 2020 2020 7075 626c 6973 6865 6420  .     published 
│ │ │ │ +00008850: 6279 2074 6861 7420 7361 6d65 206f 7267  by that same org
│ │ │ │ +00008860: 616e 697a 6174 696f 6e2e 0a0a 2020 2020  anization...    
│ │ │ │ +00008870: 2022 496e 636f 7270 6f72 6174 6522 206d   "Incorporate" m
│ │ │ │ +00008880: 6561 6e73 2074 6f20 7075 626c 6973 6820  eans to publish 
│ │ │ │ +00008890: 6f72 2072 6570 7562 6c69 7368 2061 2044  or republish a D
│ │ │ │ +000088a0: 6f63 756d 656e 742c 2069 6e20 7768 6f6c  ocument, in whol
│ │ │ │ +000088b0: 6520 6f72 0a20 2020 2020 696e 2070 6172  e or.     in par
│ │ │ │ +000088c0: 742c 2061 7320 7061 7274 206f 6620 616e  t, as part of an
│ │ │ │ +000088d0: 6f74 6865 7220 446f 6375 6d65 6e74 2e0a  other Document..
│ │ │ │ +000088e0: 0a20 2020 2020 416e 204d 4d43 2069 7320  .     An MMC is 
│ │ │ │ +000088f0: 2265 6c69 6769 626c 6520 666f 7220 7265  "eligible for re
│ │ │ │ +00008900: 6c69 6365 6e73 696e 6722 2069 6620 6974  licensing" if it
│ │ │ │ +00008910: 2069 7320 6c69 6365 6e73 6564 2075 6e64   is licensed und
│ │ │ │ +00008920: 6572 2074 6869 730a 2020 2020 204c 6963  er this.     Lic
│ │ │ │ +00008930: 656e 7365 2c20 616e 6420 6966 2061 6c6c  ense, and if all
│ │ │ │ +00008940: 2077 6f72 6b73 2074 6861 7420 7765 7265   works that were
│ │ │ │ +00008950: 2066 6972 7374 2070 7562 6c69 7368 6564   first published
│ │ │ │ +00008960: 2075 6e64 6572 2074 6869 730a 2020 2020   under this.    
│ │ │ │ +00008970: 204c 6963 656e 7365 2073 6f6d 6577 6865   License somewhe
│ │ │ │ +00008980: 7265 206f 7468 6572 2074 6861 6e20 7468  re other than th
│ │ │ │ +00008990: 6973 204d 4d43 2c20 616e 6420 7375 6273  is MMC, and subs
│ │ │ │ +000089a0: 6571 7565 6e74 6c79 0a20 2020 2020 696e  equently.     in
│ │ │ │ +000089b0: 636f 7270 6f72 6174 6564 2069 6e20 7768  corporated in wh
│ │ │ │ +000089c0: 6f6c 6520 6f72 2069 6e20 7061 7274 2069  ole or in part i
│ │ │ │ +000089d0: 6e74 6f20 7468 6520 4d4d 432c 2028 3129  nto the MMC, (1)
│ │ │ │ +000089e0: 2068 6164 206e 6f20 636f 7665 720a 2020   had no cover.  
│ │ │ │ +000089f0: 2020 2074 6578 7473 206f 7220 696e 7661     texts or inva
│ │ │ │ +00008a00: 7269 616e 7420 7365 6374 696f 6e73 2c20  riant sections, 
│ │ │ │ +00008a10: 616e 6420 2832 2920 7765 7265 2074 6875  and (2) were thu
│ │ │ │ +00008a20: 7320 696e 636f 7270 6f72 6174 6564 2070  s incorporated p
│ │ │ │ +00008a30: 7269 6f72 0a20 2020 2020 746f 204e 6f76  rior.     to Nov
│ │ │ │ +00008a40: 656d 6265 7220 312c 2032 3030 382e 0a0a  ember 1, 2008...
│ │ │ │ +00008a50: 2020 2020 2054 6865 206f 7065 7261 746f       The operato
│ │ │ │ +00008a60: 7220 6f66 2061 6e20 4d4d 4320 5369 7465  r of an MMC Site
│ │ │ │ +00008a70: 206d 6179 2072 6570 7562 6c69 7368 2061   may republish a
│ │ │ │ +00008a80: 6e20 4d4d 4320 636f 6e74 6169 6e65 6420  n MMC contained 
│ │ │ │ +00008a90: 696e 2074 6865 0a20 2020 2020 7369 7465  in the.     site
│ │ │ │ +00008aa0: 2075 6e64 6572 2043 432d 4259 2d53 4120   under CC-BY-SA 
│ │ │ │ +00008ab0: 6f6e 2074 6865 2073 616d 6520 7369 7465  on the same site
│ │ │ │ +00008ac0: 2061 7420 616e 7920 7469 6d65 2062 6566   at any time bef
│ │ │ │ +00008ad0: 6f72 6520 4175 6775 7374 2031 2c0a 2020  ore August 1,.  
│ │ │ │ +00008ae0: 2020 2032 3030 392c 2070 726f 7669 6465     2009, provide
│ │ │ │ +00008af0: 6420 7468 6520 4d4d 4320 6973 2065 6c69  d the MMC is eli
│ │ │ │ +00008b00: 6769 626c 6520 666f 7220 7265 6c69 6365  gible for relice
│ │ │ │ +00008b10: 6e73 696e 672e 0a0a 4144 4445 4e44 554d  nsing...ADDENDUM
│ │ │ │ +00008b20: 3a20 486f 7720 746f 2075 7365 2074 6869  : How to use thi
│ │ │ │ +00008b30: 7320 4c69 6365 6e73 6520 666f 7220 796f  s License for yo
│ │ │ │ +00008b40: 7572 2064 6f63 756d 656e 7473 0a3d 3d3d  ur documents.===
│ │ │ │  00008b50: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │  00008b60: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │  00008b70: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d  ================
│ │ │ │ -00008b80: 0a0a 546f 2075 7365 2074 6869 7320 4c69  ..To use this Li
│ │ │ │ -00008b90: 6365 6e73 6520 696e 2061 2064 6f63 756d  cense in a docum
│ │ │ │ -00008ba0: 656e 7420 796f 7520 6861 7665 2077 7269  ent you have wri
│ │ │ │ -00008bb0: 7474 656e 2c20 696e 636c 7564 6520 6120  tten, include a 
│ │ │ │ -00008bc0: 636f 7079 206f 660a 7468 6520 4c69 6365  copy of.the Lice
│ │ │ │ -00008bd0: 6e73 6520 696e 2074 6865 2064 6f63 756d  nse in the docum
│ │ │ │ -00008be0: 656e 7420 616e 6420 7075 7420 7468 6520  ent and put the 
│ │ │ │ -00008bf0: 666f 6c6c 6f77 696e 6720 636f 7079 7269  following copyri
│ │ │ │ -00008c00: 6768 7420 616e 6420 6c69 6365 6e73 650a  ght and license.
│ │ │ │ -00008c10: 6e6f 7469 6365 7320 6a75 7374 2061 6674  notices just aft
│ │ │ │ -00008c20: 6572 2074 6865 2074 6974 6c65 2070 6167  er the title pag
│ │ │ │ -00008c30: 653a 0a0a 2020 2020 2020 2043 6f70 7972  e:..       Copyr
│ │ │ │ -00008c40: 6967 6874 2028 4329 2020 5945 4152 2020  ight (C)  YEAR  
│ │ │ │ -00008c50: 594f 5552 204e 414d 452e 0a20 2020 2020  YOUR NAME..     
│ │ │ │ -00008c60: 2020 5065 726d 6973 7369 6f6e 2069 7320    Permission is 
│ │ │ │ -00008c70: 6772 616e 7465 6420 746f 2063 6f70 792c  granted to copy,
│ │ │ │ -00008c80: 2064 6973 7472 6962 7574 6520 616e 642f   distribute and/
│ │ │ │ -00008c90: 6f72 206d 6f64 6966 7920 7468 6973 2064  or modify this d
│ │ │ │ -00008ca0: 6f63 756d 656e 740a 2020 2020 2020 2075  ocument.       u
│ │ │ │ -00008cb0: 6e64 6572 2074 6865 2074 6572 6d73 206f  nder the terms o
│ │ │ │ -00008cc0: 6620 7468 6520 474e 5520 4672 6565 2044  f the GNU Free D
│ │ │ │ -00008cd0: 6f63 756d 656e 7461 7469 6f6e 204c 6963  ocumentation Lic
│ │ │ │ -00008ce0: 656e 7365 2c20 5665 7273 696f 6e20 312e  ense, Version 1.
│ │ │ │ -00008cf0: 330a 2020 2020 2020 206f 7220 616e 7920  3.       or any 
│ │ │ │ -00008d00: 6c61 7465 7220 7665 7273 696f 6e20 7075  later version pu
│ │ │ │ -00008d10: 626c 6973 6865 6420 6279 2074 6865 2046  blished by the F
│ │ │ │ -00008d20: 7265 6520 536f 6674 7761 7265 2046 6f75  ree Software Fou
│ │ │ │ -00008d30: 6e64 6174 696f 6e3b 0a20 2020 2020 2020  ndation;.       
│ │ │ │ -00008d40: 7769 7468 206e 6f20 496e 7661 7269 616e  with no Invarian
│ │ │ │ -00008d50: 7420 5365 6374 696f 6e73 2c20 6e6f 2046  t Sections, no F
│ │ │ │ -00008d60: 726f 6e74 2d43 6f76 6572 2054 6578 7473  ront-Cover Texts
│ │ │ │ -00008d70: 2c20 616e 6420 6e6f 2042 6163 6b2d 436f  , and no Back-Co
│ │ │ │ -00008d80: 7665 720a 2020 2020 2020 2054 6578 7473  ver.       Texts
│ │ │ │ -00008d90: 2e20 2041 2063 6f70 7920 6f66 2074 6865  .  A copy of the
│ │ │ │ -00008da0: 206c 6963 656e 7365 2069 7320 696e 636c   license is incl
│ │ │ │ -00008db0: 7564 6564 2069 6e20 7468 6520 7365 6374  uded in the sect
│ │ │ │ -00008dc0: 696f 6e20 656e 7469 746c 6564 2060 6047  ion entitled ``G
│ │ │ │ -00008dd0: 4e55 0a20 2020 2020 2020 4672 6565 2044  NU.       Free D
│ │ │ │ -00008de0: 6f63 756d 656e 7461 7469 6f6e 204c 6963  ocumentation Lic
│ │ │ │ -00008df0: 656e 7365 2727 2e0a 0a20 2020 4966 2079  ense''...   If y
│ │ │ │ -00008e00: 6f75 2068 6176 6520 496e 7661 7269 616e  ou have Invarian
│ │ │ │ -00008e10: 7420 5365 6374 696f 6e73 2c20 4672 6f6e  t Sections, Fron
│ │ │ │ -00008e20: 742d 436f 7665 7220 5465 7874 7320 616e  t-Cover Texts an
│ │ │ │ -00008e30: 6420 4261 636b 2d43 6f76 6572 0a54 6578  d Back-Cover.Tex
│ │ │ │ -00008e40: 7473 2c20 7265 706c 6163 6520 7468 6520  ts, replace the 
│ │ │ │ -00008e50: 2277 6974 682e 2e2e 5465 7874 732e 2220  "with...Texts." 
│ │ │ │ -00008e60: 6c69 6e65 2077 6974 6820 7468 6973 3a0a  line with this:.
│ │ │ │ -00008e70: 0a20 2020 2020 2020 2020 7769 7468 2074  .         with t
│ │ │ │ -00008e80: 6865 2049 6e76 6172 6961 6e74 2053 6563  he Invariant Sec
│ │ │ │ -00008e90: 7469 6f6e 7320 6265 696e 6720 4c49 5354  tions being LIST
│ │ │ │ -00008ea0: 2054 4845 4952 2054 4954 4c45 532c 2077   THEIR TITLES, w
│ │ │ │ -00008eb0: 6974 680a 2020 2020 2020 2020 2074 6865  ith.         the
│ │ │ │ -00008ec0: 2046 726f 6e74 2d43 6f76 6572 2054 6578   Front-Cover Tex
│ │ │ │ -00008ed0: 7473 2062 6569 6e67 204c 4953 542c 2061  ts being LIST, a
│ │ │ │ -00008ee0: 6e64 2077 6974 6820 7468 6520 4261 636b  nd with the Back
│ │ │ │ -00008ef0: 2d43 6f76 6572 2054 6578 7473 0a20 2020  -Cover Texts.   
│ │ │ │ -00008f00: 2020 2020 2020 6265 696e 6720 4c49 5354        being LIST
│ │ │ │ -00008f10: 2e0a 0a20 2020 4966 2079 6f75 2068 6176  ...   If you hav
│ │ │ │ -00008f20: 6520 496e 7661 7269 616e 7420 5365 6374  e Invariant Sect
│ │ │ │ -00008f30: 696f 6e73 2077 6974 686f 7574 2043 6f76  ions without Cov
│ │ │ │ -00008f40: 6572 2054 6578 7473 2c20 6f72 2073 6f6d  er Texts, or som
│ │ │ │ -00008f50: 6520 6f74 6865 720a 636f 6d62 696e 6174  e other.combinat
│ │ │ │ -00008f60: 696f 6e20 6f66 2074 6865 2074 6872 6565  ion of the three
│ │ │ │ -00008f70: 2c20 6d65 7267 6520 7468 6f73 6520 7477  , merge those tw
│ │ │ │ -00008f80: 6f20 616c 7465 726e 6174 6976 6573 2074  o alternatives t
│ │ │ │ -00008f90: 6f20 7375 6974 2074 6865 0a73 6974 7561  o suit the.situa
│ │ │ │ -00008fa0: 7469 6f6e 2e0a 0a20 2020 4966 2079 6f75  tion...   If you
│ │ │ │ -00008fb0: 7220 646f 6375 6d65 6e74 2063 6f6e 7461  r document conta
│ │ │ │ -00008fc0: 696e 7320 6e6f 6e74 7269 7669 616c 2065  ins nontrivial e
│ │ │ │ -00008fd0: 7861 6d70 6c65 7320 6f66 2070 726f 6772  xamples of progr
│ │ │ │ -00008fe0: 616d 2063 6f64 652c 2077 650a 7265 636f  am code, we.reco
│ │ │ │ -00008ff0: 6d6d 656e 6420 7265 6c65 6173 696e 6720  mmend releasing 
│ │ │ │ -00009000: 7468 6573 6520 6578 616d 706c 6573 2069  these examples i
│ │ │ │ -00009010: 6e20 7061 7261 6c6c 656c 2075 6e64 6572  n parallel under
│ │ │ │ -00009020: 2079 6f75 7220 6368 6f69 6365 206f 6620   your choice of 
│ │ │ │ -00009030: 6672 6565 0a73 6f66 7477 6172 6520 6c69  free.software li
│ │ │ │ -00009040: 6365 6e73 652c 2073 7563 6820 6173 2074  cense, such as t
│ │ │ │ -00009050: 6865 2047 4e55 2047 656e 6572 616c 2050  he GNU General P
│ │ │ │ -00009060: 7562 6c69 6320 4c69 6365 6e73 652c 2074  ublic License, t
│ │ │ │ -00009070: 6f20 7065 726d 6974 0a74 6865 6972 2075  o permit.their u
│ │ │ │ -00009080: 7365 2069 6e20 6672 6565 2073 6f66 7477  se in free softw
│ │ │ │ -00009090: 6172 652e 0a0a 1f0a 4669 6c65 3a20 7368  are.....File: sh
│ │ │ │ -000090a0: 6973 6869 2e69 6e66 6f2c 2020 4e6f 6465  ishi.info,  Node
│ │ │ │ -000090b0: 3a20 4675 6e63 7469 6f6e 2061 6e64 2044  : Function and D
│ │ │ │ -000090c0: 6174 6120 496e 6465 782c 2020 4e65 7874  ata Index,  Next
│ │ │ │ -000090d0: 3a20 436f 6e63 6570 7420 496e 6465 782c  : Concept Index,
│ │ │ │ -000090e0: 2020 5072 6576 3a20 436f 7079 696e 6720    Prev: Copying 
│ │ │ │ -000090f0: 496e 666f 726d 6174 696f 6e2c 2020 5570  Information,  Up
│ │ │ │ -00009100: 3a20 546f 700a 0a46 756e 6374 696f 6e20  : Top..Function 
│ │ │ │ -00009110: 616e 6420 4461 7461 2049 6e64 6578 0a2a  and Data Index.*
│ │ │ │ +00008b80: 3d0a 0a54 6f20 7573 6520 7468 6973 204c  =..To use this L
│ │ │ │ +00008b90: 6963 656e 7365 2069 6e20 6120 646f 6375  icense in a docu
│ │ │ │ +00008ba0: 6d65 6e74 2079 6f75 2068 6176 6520 7772  ment you have wr
│ │ │ │ +00008bb0: 6974 7465 6e2c 2069 6e63 6c75 6465 2061  itten, include a
│ │ │ │ +00008bc0: 2063 6f70 7920 6f66 0a74 6865 204c 6963   copy of.the Lic
│ │ │ │ +00008bd0: 656e 7365 2069 6e20 7468 6520 646f 6375  ense in the docu
│ │ │ │ +00008be0: 6d65 6e74 2061 6e64 2070 7574 2074 6865  ment and put the
│ │ │ │ +00008bf0: 2066 6f6c 6c6f 7769 6e67 2063 6f70 7972   following copyr
│ │ │ │ +00008c00: 6967 6874 2061 6e64 206c 6963 656e 7365  ight and license
│ │ │ │ +00008c10: 0a6e 6f74 6963 6573 206a 7573 7420 6166  .notices just af
│ │ │ │ +00008c20: 7465 7220 7468 6520 7469 746c 6520 7061  ter the title pa
│ │ │ │ +00008c30: 6765 3a0a 0a20 2020 2020 2020 436f 7079  ge:..       Copy
│ │ │ │ +00008c40: 7269 6768 7420 2843 2920 2059 4541 5220  right (C)  YEAR 
│ │ │ │ +00008c50: 2059 4f55 5220 4e41 4d45 2e0a 2020 2020   YOUR NAME..    
│ │ │ │ +00008c60: 2020 2050 6572 6d69 7373 696f 6e20 6973     Permission is
│ │ │ │ +00008c70: 2067 7261 6e74 6564 2074 6f20 636f 7079   granted to copy
│ │ │ │ +00008c80: 2c20 6469 7374 7269 6275 7465 2061 6e64  , distribute and
│ │ │ │ +00008c90: 2f6f 7220 6d6f 6469 6679 2074 6869 7320  /or modify this 
│ │ │ │ +00008ca0: 646f 6375 6d65 6e74 0a20 2020 2020 2020  document.       
│ │ │ │ +00008cb0: 756e 6465 7220 7468 6520 7465 726d 7320  under the terms 
│ │ │ │ +00008cc0: 6f66 2074 6865 2047 4e55 2046 7265 6520  of the GNU Free 
│ │ │ │ +00008cd0: 446f 6375 6d65 6e74 6174 696f 6e20 4c69  Documentation Li
│ │ │ │ +00008ce0: 6365 6e73 652c 2056 6572 7369 6f6e 2031  cense, Version 1
│ │ │ │ +00008cf0: 2e33 0a20 2020 2020 2020 6f72 2061 6e79  .3.       or any
│ │ │ │ +00008d00: 206c 6174 6572 2076 6572 7369 6f6e 2070   later version p
│ │ │ │ +00008d10: 7562 6c69 7368 6564 2062 7920 7468 6520  ublished by the 
│ │ │ │ +00008d20: 4672 6565 2053 6f66 7477 6172 6520 466f  Free Software Fo
│ │ │ │ +00008d30: 756e 6461 7469 6f6e 3b0a 2020 2020 2020  undation;.      
│ │ │ │ +00008d40: 2077 6974 6820 6e6f 2049 6e76 6172 6961   with no Invaria
│ │ │ │ +00008d50: 6e74 2053 6563 7469 6f6e 732c 206e 6f20  nt Sections, no 
│ │ │ │ +00008d60: 4672 6f6e 742d 436f 7665 7220 5465 7874  Front-Cover Text
│ │ │ │ +00008d70: 732c 2061 6e64 206e 6f20 4261 636b 2d43  s, and no Back-C
│ │ │ │ +00008d80: 6f76 6572 0a20 2020 2020 2020 5465 7874  over.       Text
│ │ │ │ +00008d90: 732e 2020 4120 636f 7079 206f 6620 7468  s.  A copy of th
│ │ │ │ +00008da0: 6520 6c69 6365 6e73 6520 6973 2069 6e63  e license is inc
│ │ │ │ +00008db0: 6c75 6465 6420 696e 2074 6865 2073 6563  luded in the sec
│ │ │ │ +00008dc0: 7469 6f6e 2065 6e74 6974 6c65 6420 6060  tion entitled ``
│ │ │ │ +00008dd0: 474e 550a 2020 2020 2020 2046 7265 6520  GNU.       Free 
│ │ │ │ +00008de0: 446f 6375 6d65 6e74 6174 696f 6e20 4c69  Documentation Li
│ │ │ │ +00008df0: 6365 6e73 6527 272e 0a0a 2020 2049 6620  cense''...   If 
│ │ │ │ +00008e00: 796f 7520 6861 7665 2049 6e76 6172 6961  you have Invaria
│ │ │ │ +00008e10: 6e74 2053 6563 7469 6f6e 732c 2046 726f  nt Sections, Fro
│ │ │ │ +00008e20: 6e74 2d43 6f76 6572 2054 6578 7473 2061  nt-Cover Texts a
│ │ │ │ +00008e30: 6e64 2042 6163 6b2d 436f 7665 720a 5465  nd Back-Cover.Te
│ │ │ │ +00008e40: 7874 732c 2072 6570 6c61 6365 2074 6865  xts, replace the
│ │ │ │ +00008e50: 2022 7769 7468 2e2e 2e54 6578 7473 2e22   "with...Texts."
│ │ │ │ +00008e60: 206c 696e 6520 7769 7468 2074 6869 733a   line with this:
│ │ │ │ +00008e70: 0a0a 2020 2020 2020 2020 2077 6974 6820  ..         with 
│ │ │ │ +00008e80: 7468 6520 496e 7661 7269 616e 7420 5365  the Invariant Se
│ │ │ │ +00008e90: 6374 696f 6e73 2062 6569 6e67 204c 4953  ctions being LIS
│ │ │ │ +00008ea0: 5420 5448 4549 5220 5449 544c 4553 2c20  T THEIR TITLES, 
│ │ │ │ +00008eb0: 7769 7468 0a20 2020 2020 2020 2020 7468  with.         th
│ │ │ │ +00008ec0: 6520 4672 6f6e 742d 436f 7665 7220 5465  e Front-Cover Te
│ │ │ │ +00008ed0: 7874 7320 6265 696e 6720 4c49 5354 2c20  xts being LIST, 
│ │ │ │ +00008ee0: 616e 6420 7769 7468 2074 6865 2042 6163  and with the Bac
│ │ │ │ +00008ef0: 6b2d 436f 7665 7220 5465 7874 730a 2020  k-Cover Texts.  
│ │ │ │ +00008f00: 2020 2020 2020 2062 6569 6e67 204c 4953         being LIS
│ │ │ │ +00008f10: 542e 0a0a 2020 2049 6620 796f 7520 6861  T...   If you ha
│ │ │ │ +00008f20: 7665 2049 6e76 6172 6961 6e74 2053 6563  ve Invariant Sec
│ │ │ │ +00008f30: 7469 6f6e 7320 7769 7468 6f75 7420 436f  tions without Co
│ │ │ │ +00008f40: 7665 7220 5465 7874 732c 206f 7220 736f  ver Texts, or so
│ │ │ │ +00008f50: 6d65 206f 7468 6572 0a63 6f6d 6269 6e61  me other.combina
│ │ │ │ +00008f60: 7469 6f6e 206f 6620 7468 6520 7468 7265  tion of the thre
│ │ │ │ +00008f70: 652c 206d 6572 6765 2074 686f 7365 2074  e, merge those t
│ │ │ │ +00008f80: 776f 2061 6c74 6572 6e61 7469 7665 7320  wo alternatives 
│ │ │ │ +00008f90: 746f 2073 7569 7420 7468 650a 7369 7475  to suit the.situ
│ │ │ │ +00008fa0: 6174 696f 6e2e 0a0a 2020 2049 6620 796f  ation...   If yo
│ │ │ │ +00008fb0: 7572 2064 6f63 756d 656e 7420 636f 6e74  ur document cont
│ │ │ │ +00008fc0: 6169 6e73 206e 6f6e 7472 6976 6961 6c20  ains nontrivial 
│ │ │ │ +00008fd0: 6578 616d 706c 6573 206f 6620 7072 6f67  examples of prog
│ │ │ │ +00008fe0: 7261 6d20 636f 6465 2c20 7765 0a72 6563  ram code, we.rec
│ │ │ │ +00008ff0: 6f6d 6d65 6e64 2072 656c 6561 7369 6e67  ommend releasing
│ │ │ │ +00009000: 2074 6865 7365 2065 7861 6d70 6c65 7320   these examples 
│ │ │ │ +00009010: 696e 2070 6172 616c 6c65 6c20 756e 6465  in parallel unde
│ │ │ │ +00009020: 7220 796f 7572 2063 686f 6963 6520 6f66  r your choice of
│ │ │ │ +00009030: 2066 7265 650a 736f 6674 7761 7265 206c   free.software l
│ │ │ │ +00009040: 6963 656e 7365 2c20 7375 6368 2061 7320  icense, such as 
│ │ │ │ +00009050: 7468 6520 474e 5520 4765 6e65 7261 6c20  the GNU General 
│ │ │ │ +00009060: 5075 626c 6963 204c 6963 656e 7365 2c20  Public License, 
│ │ │ │ +00009070: 746f 2070 6572 6d69 740a 7468 6569 7220  to permit.their 
│ │ │ │ +00009080: 7573 6520 696e 2066 7265 6520 736f 6674  use in free soft
│ │ │ │ +00009090: 7761 7265 2e0a 0a1f 0a46 696c 653a 2073  ware.....File: s
│ │ │ │ +000090a0: 6869 7368 692e 696e 666f 2c20 204e 6f64  hishi.info,  Nod
│ │ │ │ +000090b0: 653a 2046 756e 6374 696f 6e20 616e 6420  e: Function and 
│ │ │ │ +000090c0: 4461 7461 2049 6e64 6578 2c20 204e 6578  Data Index,  Nex
│ │ │ │ +000090d0: 743a 2043 6f6e 6365 7074 2049 6e64 6578  t: Concept Index
│ │ │ │ +000090e0: 2c20 2050 7265 763a 2043 6f70 7969 6e67  ,  Prev: Copying
│ │ │ │ +000090f0: 2049 6e66 6f72 6d61 7469 6f6e 2c20 2055   Information,  U
│ │ │ │ +00009100: 703a 2054 6f70 0a0a 4675 6e63 7469 6f6e  p: Top..Function
│ │ │ │ +00009110: 2061 6e64 2044 6174 6120 496e 6465 780a   and Data Index.
│ │ │ │  00009120: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a  ****************
│ │ │ │ -00009130: 2a2a 2a2a 2a2a 0a0a 0008 5b69 6e64 6578  ******....[index
│ │ │ │ -00009140: 0008 5d0a 2a20 4d65 6e75 3a0a 0a2a 2061  ..].* Menu:..* a
│ │ │ │ -00009150: 676f 2069 6e20 6461 7465 2073 7472 696e  go in date strin
│ │ │ │ -00009160: 6773 3a20 2020 2020 2020 2020 2020 2020  gs:             
│ │ │ │ -00009170: 2020 2020 2020 5265 6c61 7469 7665 2069        Relative i
│ │ │ │ -00009180: 7465 6d73 2069 6e20 6461 7465 2073 7472  tems in date str
│ │ │ │ -00009190: 696e 6773 2e0a 2020 2020 2020 2020 2020  ings..          
│ │ │ │ +00009130: 2a2a 2a2a 2a2a 2a0a 0a00 085b 696e 6465  *******....[inde
│ │ │ │ +00009140: 7800 085d 0a2a 204d 656e 753a 0a0a 2a20  x..].* Menu:..* 
│ │ │ │ +00009150: 6167 6f20 696e 2064 6174 6520 7374 7269  ago in date stri
│ │ │ │ +00009160: 6e67 733a 2020 2020 2020 2020 2020 2020  ngs:            
│ │ │ │ +00009170: 2020 2020 2020 2052 656c 6174 6976 6520         Relative 
│ │ │ │ +00009180: 6974 656d 7320 696e 2064 6174 6520 7374  items in date st
│ │ │ │ +00009190: 7269 6e67 732e 0a20 2020 2020 2020 2020  rings..         
│ │ │ │  000091a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000091b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000091c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000091d0: 2020 2028 6c69 6e65 2020 2032 3329 0a2a     (line   23).*
│ │ │ │ -000091e0: 2061 6d20 696e 2064 6174 6520 7374 7269   am in date stri
│ │ │ │ -000091f0: 6e67 733a 2020 2020 2020 2020 2020 2020  ngs:            
│ │ │ │ -00009200: 2020 2020 2020 2020 5469 6d65 206f 6620          Time of 
│ │ │ │ -00009210: 6461 7920 6974 656d 732e 2020 286c 696e  day items.  (lin
│ │ │ │ -00009220: 6520 2020 3231 290a 2a20 6461 7920 696e  e   21).* day in
│ │ │ │ -00009230: 2064 6174 6520 7374 7269 6e67 733a 2020   date strings:  
│ │ │ │ +000091d0: 2020 2020 286c 696e 6520 2020 3233 290a      (line   23).
│ │ │ │ +000091e0: 2a20 616d 2069 6e20 6461 7465 2073 7472  * am in date str
│ │ │ │ +000091f0: 696e 6773 3a20 2020 2020 2020 2020 2020  ings:           
│ │ │ │ +00009200: 2020 2020 2020 2020 2054 696d 6520 6f66           Time of
│ │ │ │ +00009210: 2064 6179 2069 7465 6d73 2e20 2028 6c69   day items.  (li
│ │ │ │ +00009220: 6e65 2020 2032 3129 0a2a 2064 6179 2069  ne   21).* day i
│ │ │ │ +00009230: 6e20 6461 7465 2073 7472 696e 6773 3a20  n date strings: 
│ │ │ │  00009240: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00009250: 2052 656c 6174 6976 6520 6974 656d 7320   Relative items 
│ │ │ │ -00009260: 696e 2064 6174 6520 7374 7269 6e67 732e  in date strings.
│ │ │ │ -00009270: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ +00009250: 2020 5265 6c61 7469 7665 2069 7465 6d73    Relative items
│ │ │ │ +00009260: 2069 6e20 6461 7465 2073 7472 696e 6773   in date strings
│ │ │ │ +00009270: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │  00009280: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00009290: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000092a0: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ -000092b0: 696e 6520 2020 3135 290a 2a20 6461 7920  ine   15).* day 
│ │ │ │ -000092c0: 696e 2064 6174 6520 7374 7269 6e67 7320  in date strings 
│ │ │ │ -000092d0: 3c31 3e3a 2020 2020 2020 2020 2020 2020  <1>:            
│ │ │ │ -000092e0: 2020 2052 656c 6174 6976 6520 6974 656d     Relative item
│ │ │ │ -000092f0: 7320 696e 2064 6174 6520 7374 7269 6e67  s in date string
│ │ │ │ -00009300: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │ +000092a0: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ +000092b0: 6c69 6e65 2020 2031 3529 0a2a 2064 6179  line   15).* day
│ │ │ │ +000092c0: 2069 6e20 6461 7465 2073 7472 696e 6773   in date strings
│ │ │ │ +000092d0: 203c 313e 3a20 2020 2020 2020 2020 2020   <1>:           
│ │ │ │ +000092e0: 2020 2020 5265 6c61 7469 7665 2069 7465      Relative ite
│ │ │ │ +000092f0: 6d73 2069 6e20 6461 7465 2073 7472 696e  ms in date strin
│ │ │ │ +00009300: 6773 2e0a 2020 2020 2020 2020 2020 2020  gs..            
│ │ │ │  00009310: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00009320: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00009330: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00009340: 286c 696e 6520 2020 3239 290a 2a20 6669  (line   29).* fi
│ │ │ │ -00009350: 7273 7420 696e 2064 6174 6520 7374 7269  rst in date stri
│ │ │ │ -00009360: 6e67 733a 2020 2020 2020 2020 2020 2020  ngs:            
│ │ │ │ -00009370: 2020 2020 2047 656e 6572 616c 2064 6174       General dat
│ │ │ │ -00009380: 6520 7379 6e74 6178 2e0a 2020 2020 2020  e syntax..      
│ │ │ │ +00009340: 2028 6c69 6e65 2020 2032 3929 0a2a 2066   (line   29).* f
│ │ │ │ +00009350: 6972 7374 2069 6e20 6461 7465 2073 7472  irst in date str
│ │ │ │ +00009360: 696e 6773 3a20 2020 2020 2020 2020 2020  ings:           
│ │ │ │ +00009370: 2020 2020 2020 4765 6e65 7261 6c20 6461        General da
│ │ │ │ +00009380: 7465 2073 796e 7461 782e 0a20 2020 2020  te syntax..     
│ │ │ │  00009390: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000093a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000093b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000093c0: 2020 2020 2020 2028 6c69 6e65 2020 2032         (line   2
│ │ │ │ -000093d0: 3229 0a2a 2066 6f72 746e 6967 6874 2069  2).* fortnight i
│ │ │ │ -000093e0: 6e20 6461 7465 2073 7472 696e 6773 3a20  n date strings: 
│ │ │ │ -000093f0: 2020 2020 2020 2020 2020 2020 5265 6c61              Rela
│ │ │ │ -00009400: 7469 7665 2069 7465 6d73 2069 6e20 6461  tive items in da
│ │ │ │ -00009410: 7465 2073 7472 696e 6773 2e0a 2020 2020  te strings..    
│ │ │ │ +000093c0: 2020 2020 2020 2020 286c 696e 6520 2020          (line   
│ │ │ │ +000093d0: 3232 290a 2a20 666f 7274 6e69 6768 7420  22).* fortnight 
│ │ │ │ +000093e0: 696e 2064 6174 6520 7374 7269 6e67 733a  in date strings:
│ │ │ │ +000093f0: 2020 2020 2020 2020 2020 2020 2052 656c               Rel
│ │ │ │ +00009400: 6174 6976 6520 6974 656d 7320 696e 2064  ative items in d
│ │ │ │ +00009410: 6174 6520 7374 7269 6e67 732e 0a20 2020  ate strings..   
│ │ │ │  00009420: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00009430: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00009440: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00009450: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ -00009460: 2031 3529 0a2a 2068 6f75 7220 696e 2064   15).* hour in d
│ │ │ │ -00009470: 6174 6520 7374 7269 6e67 733a 2020 2020  ate strings:    
│ │ │ │ -00009480: 2020 2020 2020 2020 2020 2020 2020 5265                Re
│ │ │ │ -00009490: 6c61 7469 7665 2069 7465 6d73 2069 6e20  lative items in 
│ │ │ │ -000094a0: 6461 7465 2073 7472 696e 6773 2e0a 2020  date strings..  
│ │ │ │ +00009450: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ +00009460: 2020 3135 290a 2a20 686f 7572 2069 6e20    15).* hour in 
│ │ │ │ +00009470: 6461 7465 2073 7472 696e 6773 3a20 2020  date strings:   
│ │ │ │ +00009480: 2020 2020 2020 2020 2020 2020 2020 2052                 R
│ │ │ │ +00009490: 656c 6174 6976 6520 6974 656d 7320 696e  elative items in
│ │ │ │ +000094a0: 2064 6174 6520 7374 7269 6e67 732e 0a20   date strings.. 
│ │ │ │  000094b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000094c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000094d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000094e0: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ -000094f0: 2020 2031 3529 0a2a 206c 6173 7420 4441     15).* last DA
│ │ │ │ -00009500: 593a 2020 2020 2020 2020 2020 2020 2020  Y:              
│ │ │ │ +000094e0: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ +000094f0: 6520 2020 3135 290a 2a20 6c61 7374 2044  e   15).* last D
│ │ │ │ +00009500: 4159 3a20 2020 2020 2020 2020 2020 2020  AY:             
│ │ │ │  00009510: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00009520: 4461 7920 6f66 2077 6565 6b20 6974 656d  Day of week item
│ │ │ │ -00009530: 732e 2020 286c 696e 6520 2020 3135 290a  s.  (line   15).
│ │ │ │ -00009540: 2a20 6c61 7374 2069 6e20 6461 7465 2073  * last in date s
│ │ │ │ -00009550: 7472 696e 6773 3a20 2020 2020 2020 2020  trings:         
│ │ │ │ -00009560: 2020 2020 2020 2020 2047 656e 6572 616c           General
│ │ │ │ -00009570: 2064 6174 6520 7379 6e74 6178 2e0a 2020   date syntax..  
│ │ │ │ +00009520: 2044 6179 206f 6620 7765 656b 2069 7465   Day of week ite
│ │ │ │ +00009530: 6d73 2e20 2028 6c69 6e65 2020 2031 3529  ms.  (line   15)
│ │ │ │ +00009540: 0a2a 206c 6173 7420 696e 2064 6174 6520  .* last in date 
│ │ │ │ +00009550: 7374 7269 6e67 733a 2020 2020 2020 2020  strings:        
│ │ │ │ +00009560: 2020 2020 2020 2020 2020 4765 6e65 7261            Genera
│ │ │ │ +00009570: 6c20 6461 7465 2073 796e 7461 782e 0a20  l date syntax.. 
│ │ │ │  00009580: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00009590: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000095a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000095b0: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ -000095c0: 2020 2032 3229 0a2a 206d 6964 6e69 6768     22).* midnigh
│ │ │ │ -000095d0: 7420 696e 2064 6174 6520 7374 7269 6e67  t in date string
│ │ │ │ -000095e0: 733a 2020 2020 2020 2020 2020 2020 2020  s:              
│ │ │ │ -000095f0: 5469 6d65 206f 6620 6461 7920 6974 656d  Time of day item
│ │ │ │ -00009600: 732e 2020 286c 696e 6520 2020 3231 290a  s.  (line   21).
│ │ │ │ -00009610: 2a20 6d69 6e75 7465 2069 6e20 6461 7465  * minute in date
│ │ │ │ -00009620: 2073 7472 696e 6773 3a20 2020 2020 2020   strings:       
│ │ │ │ -00009630: 2020 2020 2020 2020 2052 656c 6174 6976           Relativ
│ │ │ │ -00009640: 6520 6974 656d 7320 696e 2064 6174 6520  e items in date 
│ │ │ │ -00009650: 7374 7269 6e67 732e 0a20 2020 2020 2020  strings..       
│ │ │ │ +000095b0: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ +000095c0: 6520 2020 3232 290a 2a20 6d69 646e 6967  e   22).* midnig
│ │ │ │ +000095d0: 6874 2069 6e20 6461 7465 2073 7472 696e  ht in date strin
│ │ │ │ +000095e0: 6773 3a20 2020 2020 2020 2020 2020 2020  gs:             
│ │ │ │ +000095f0: 2054 696d 6520 6f66 2064 6179 2069 7465   Time of day ite
│ │ │ │ +00009600: 6d73 2e20 2028 6c69 6e65 2020 2032 3129  ms.  (line   21)
│ │ │ │ +00009610: 0a2a 206d 696e 7574 6520 696e 2064 6174  .* minute in dat
│ │ │ │ +00009620: 6520 7374 7269 6e67 733a 2020 2020 2020  e strings:      
│ │ │ │ +00009630: 2020 2020 2020 2020 2020 5265 6c61 7469            Relati
│ │ │ │ +00009640: 7665 2069 7465 6d73 2069 6e20 6461 7465  ve items in date
│ │ │ │ +00009650: 2073 7472 696e 6773 2e0a 2020 2020 2020   strings..      
│ │ │ │  00009660: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00009670: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00009680: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00009690: 2020 2020 2020 286c 696e 6520 2020 3135        (line   15
│ │ │ │ -000096a0: 290a 2a20 6d6f 6e74 6820 696e 2064 6174  ).* month in dat
│ │ │ │ -000096b0: 6520 7374 7269 6e67 733a 2020 2020 2020  e strings:      
│ │ │ │ -000096c0: 2020 2020 2020 2020 2020 2052 656c 6174             Relat
│ │ │ │ -000096d0: 6976 6520 6974 656d 7320 696e 2064 6174  ive items in dat
│ │ │ │ -000096e0: 6520 7374 7269 6e67 732e 0a20 2020 2020  e strings..     
│ │ │ │ +00009690: 2020 2020 2020 2028 6c69 6e65 2020 2031         (line   1
│ │ │ │ +000096a0: 3529 0a2a 206d 6f6e 7468 2069 6e20 6461  5).* month in da
│ │ │ │ +000096b0: 7465 2073 7472 696e 6773 3a20 2020 2020  te strings:     
│ │ │ │ +000096c0: 2020 2020 2020 2020 2020 2020 5265 6c61              Rela
│ │ │ │ +000096d0: 7469 7665 2069 7465 6d73 2069 6e20 6461  tive items in da
│ │ │ │ +000096e0: 7465 2073 7472 696e 6773 2e0a 2020 2020  te strings..    
│ │ │ │  000096f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00009700: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00009710: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00009720: 2020 2020 2020 2020 286c 696e 6520 2020          (line   
│ │ │ │ -00009730: 3135 290a 2a20 6e65 7874 2044 4159 3a20  15).* next DAY: 
│ │ │ │ +00009720: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ +00009730: 2031 3529 0a2a 206e 6578 7420 4441 593a   15).* next DAY:
│ │ │ │  00009740: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00009750: 2020 2020 2020 2020 2020 2020 2044 6179               Day
│ │ │ │ -00009760: 206f 6620 7765 656b 2069 7465 6d73 2e20   of week items. 
│ │ │ │ -00009770: 2028 6c69 6e65 2020 2031 3529 0a2a 206e   (line   15).* n
│ │ │ │ -00009780: 6578 7420 696e 2064 6174 6520 7374 7269  ext in date stri
│ │ │ │ -00009790: 6e67 733a 2020 2020 2020 2020 2020 2020  ngs:            
│ │ │ │ -000097a0: 2020 2020 2020 4765 6e65 7261 6c20 6461        General da
│ │ │ │ -000097b0: 7465 2073 796e 7461 782e 0a20 2020 2020  te syntax..     
│ │ │ │ +00009750: 2020 2020 2020 2020 2020 2020 2020 4461                Da
│ │ │ │ +00009760: 7920 6f66 2077 6565 6b20 6974 656d 732e  y of week items.
│ │ │ │ +00009770: 2020 286c 696e 6520 2020 3135 290a 2a20    (line   15).* 
│ │ │ │ +00009780: 6e65 7874 2069 6e20 6461 7465 2073 7472  next in date str
│ │ │ │ +00009790: 696e 6773 3a20 2020 2020 2020 2020 2020  ings:           
│ │ │ │ +000097a0: 2020 2020 2020 2047 656e 6572 616c 2064         General d
│ │ │ │ +000097b0: 6174 6520 7379 6e74 6178 2e0a 2020 2020  ate syntax..    
│ │ │ │  000097c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000097d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000097e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000097f0: 2020 2020 2020 2020 286c 696e 6520 2020          (line   
│ │ │ │ -00009800: 3232 290a 2a20 6e6f 6f6e 2069 6e20 6461  22).* noon in da
│ │ │ │ -00009810: 7465 2073 7472 696e 6773 3a20 2020 2020  te strings:     
│ │ │ │ -00009820: 2020 2020 2020 2020 2020 2020 2054 696d               Tim
│ │ │ │ -00009830: 6520 6f66 2064 6179 2069 7465 6d73 2e20  e of day items. 
│ │ │ │ -00009840: 2028 6c69 6e65 2020 2032 3129 0a2a 206e   (line   21).* n
│ │ │ │ -00009850: 6f77 2069 6e20 6461 7465 2073 7472 696e  ow in date strin
│ │ │ │ -00009860: 6773 3a20 2020 2020 2020 2020 2020 2020  gs:             
│ │ │ │ -00009870: 2020 2020 2020 5265 6c61 7469 7665 2069        Relative i
│ │ │ │ -00009880: 7465 6d73 2069 6e20 6461 7465 2073 7472  tems in date str
│ │ │ │ -00009890: 696e 6773 2e0a 2020 2020 2020 2020 2020  ings..          
│ │ │ │ +000097f0: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ +00009800: 2032 3229 0a2a 206e 6f6f 6e20 696e 2064   22).* noon in d
│ │ │ │ +00009810: 6174 6520 7374 7269 6e67 733a 2020 2020  ate strings:    
│ │ │ │ +00009820: 2020 2020 2020 2020 2020 2020 2020 5469                Ti
│ │ │ │ +00009830: 6d65 206f 6620 6461 7920 6974 656d 732e  me of day items.
│ │ │ │ +00009840: 2020 286c 696e 6520 2020 3231 290a 2a20    (line   21).* 
│ │ │ │ +00009850: 6e6f 7720 696e 2064 6174 6520 7374 7269  now in date stri
│ │ │ │ +00009860: 6e67 733a 2020 2020 2020 2020 2020 2020  ngs:            
│ │ │ │ +00009870: 2020 2020 2020 2052 656c 6174 6976 6520         Relative 
│ │ │ │ +00009880: 6974 656d 7320 696e 2064 6174 6520 7374  items in date st
│ │ │ │ +00009890: 7269 6e67 732e 0a20 2020 2020 2020 2020  rings..         
│ │ │ │  000098a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000098b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000098c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000098d0: 2020 2028 6c69 6e65 2020 2033 3329 0a2a     (line   33).*
│ │ │ │ -000098e0: 2070 6172 7365 5f64 6174 6574 696d 653a   parse_datetime:
│ │ │ │ -000098f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00009900: 2020 2020 2020 2020 4461 7465 2069 6e70          Date inp
│ │ │ │ -00009910: 7574 2066 6f72 6d61 7473 2e20 286c 696e  ut formats. (lin
│ │ │ │ -00009920: 6520 2020 2036 290a 2a20 706d 2069 6e20  e    6).* pm in 
│ │ │ │ -00009930: 6461 7465 2073 7472 696e 6773 3a20 2020  date strings:   
│ │ │ │ +000098d0: 2020 2020 286c 696e 6520 2020 3333 290a      (line   33).
│ │ │ │ +000098e0: 2a20 7061 7273 655f 6461 7465 7469 6d65  * parse_datetime
│ │ │ │ +000098f0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ +00009900: 2020 2020 2020 2020 2044 6174 6520 696e           Date in
│ │ │ │ +00009910: 7075 7420 666f 726d 6174 732e 2028 6c69  put formats. (li
│ │ │ │ +00009920: 6e65 2020 2020 3629 0a2a 2070 6d20 696e  ne    6).* pm in
│ │ │ │ +00009930: 2064 6174 6520 7374 7269 6e67 733a 2020   date strings:  
│ │ │ │  00009940: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00009950: 2054 696d 6520 6f66 2064 6179 2069 7465   Time of day ite
│ │ │ │ -00009960: 6d73 2e20 2028 6c69 6e65 2020 2032 3129  ms.  (line   21)
│ │ │ │ -00009970: 0a2a 2073 6869 7361 3a20 2020 2020 2020  .* shisa:       
│ │ │ │ +00009950: 2020 5469 6d65 206f 6620 6461 7920 6974    Time of day it
│ │ │ │ +00009960: 656d 732e 2020 286c 696e 6520 2020 3231  ems.  (line   21
│ │ │ │ +00009970: 290a 2a20 7368 6973 613a 2020 2020 2020  ).* shisa:      
│ │ │ │  00009980: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00009990: 2020 2020 2020 2020 2020 4b65 7262 6572            Kerber
│ │ │ │ -000099a0: 6f73 2044 6174 6162 6173 6520 4675 6e63  os Database Func
│ │ │ │ -000099b0: 7469 6f6e 732e 0a20 2020 2020 2020 2020  tions..         
│ │ │ │ +00009990: 2020 2020 2020 2020 2020 204b 6572 6265             Kerbe
│ │ │ │ +000099a0: 726f 7320 4461 7461 6261 7365 2046 756e  ros Database Fun
│ │ │ │ +000099b0: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │  000099c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000099d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000099e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000099f0: 2020 2020 286c 696e 6520 2020 3638 290a      (line   68).
│ │ │ │ -00009a00: 2a20 7368 6973 615f 6366 673a 2020 2020  * shisa_cfg:    
│ │ │ │ +000099f0: 2020 2020 2028 6c69 6e65 2020 2036 3829       (line   68)
│ │ │ │ +00009a00: 0a2a 2073 6869 7361 5f63 6667 3a20 2020  .* shisa_cfg:   
│ │ │ │  00009a10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00009a20: 2020 2020 2020 2020 204b 6572 6265 726f           Kerbero
│ │ │ │ -00009a30: 7320 4461 7461 6261 7365 2046 756e 6374  s Database Funct
│ │ │ │ -00009a40: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │ +00009a20: 2020 2020 2020 2020 2020 4b65 7262 6572            Kerber
│ │ │ │ +00009a30: 6f73 2044 6174 6162 6173 6520 4675 6e63  os Database Func
│ │ │ │ +00009a40: 7469 6f6e 732e 0a20 2020 2020 2020 2020  tions..         
│ │ │ │  00009a50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00009a60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00009a70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00009a80: 2020 2028 6c69 6e65 2020 3135 3229 0a2a     (line  152).*
│ │ │ │ -00009a90: 2073 6869 7361 5f63 6667 5f64 623a 2020   shisa_cfg_db:  
│ │ │ │ +00009a80: 2020 2020 286c 696e 6520 2031 3532 290a      (line  152).
│ │ │ │ +00009a90: 2a20 7368 6973 615f 6366 675f 6462 3a20  * shisa_cfg_db: 
│ │ │ │  00009aa0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00009ab0: 2020 2020 2020 2020 4b65 7262 6572 6f73          Kerberos
│ │ │ │ -00009ac0: 2044 6174 6162 6173 6520 4675 6e63 7469   Database Functi
│ │ │ │ -00009ad0: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │ +00009ab0: 2020 2020 2020 2020 204b 6572 6265 726f           Kerbero
│ │ │ │ +00009ac0: 7320 4461 7461 6261 7365 2046 756e 6374  s Database Funct
│ │ │ │ +00009ad0: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │  00009ae0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00009af0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00009b00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00009b10: 2020 286c 696e 6520 2031 3333 290a 2a20    (line  133).* 
│ │ │ │ -00009b20: 7368 6973 615f 6366 675f 6465 6661 756c  shisa_cfg_defaul
│ │ │ │ -00009b30: 745f 7379 7374 656d 6669 6c65 3a20 2020  t_systemfile:   
│ │ │ │ -00009b40: 2020 2020 2020 204b 6572 6265 726f 7320         Kerberos 
│ │ │ │ -00009b50: 4461 7461 6261 7365 2046 756e 6374 696f  Database Functio
│ │ │ │ -00009b60: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │ +00009b10: 2020 2028 6c69 6e65 2020 3133 3329 0a2a     (line  133).*
│ │ │ │ +00009b20: 2073 6869 7361 5f63 6667 5f64 6566 6175   shisa_cfg_defau
│ │ │ │ +00009b30: 6c74 5f73 7973 7465 6d66 696c 653a 2020  lt_systemfile:  
│ │ │ │ +00009b40: 2020 2020 2020 2020 4b65 7262 6572 6f73          Kerberos
│ │ │ │ +00009b50: 2044 6174 6162 6173 6520 4675 6e63 7469   Database Functi
│ │ │ │ +00009b60: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │  00009b70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00009b80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00009b90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00009ba0: 2028 6c69 6e65 2020 3138 3329 0a2a 2073   (line  183).* s
│ │ │ │ -00009bb0: 6869 7361 5f63 6667 5f66 726f 6d5f 6669  hisa_cfg_from_fi
│ │ │ │ -00009bc0: 6c65 3a20 2020 2020 2020 2020 2020 2020  le:             
│ │ │ │ -00009bd0: 2020 2020 2020 4b65 7262 6572 6f73 2044        Kerberos D
│ │ │ │ -00009be0: 6174 6162 6173 6520 4675 6e63 7469 6f6e  atabase Function
│ │ │ │ -00009bf0: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │ +00009ba0: 2020 286c 696e 6520 2031 3833 290a 2a20    (line  183).* 
│ │ │ │ +00009bb0: 7368 6973 615f 6366 675f 6672 6f6d 5f66  shisa_cfg_from_f
│ │ │ │ +00009bc0: 696c 653a 2020 2020 2020 2020 2020 2020  ile:            
│ │ │ │ +00009bd0: 2020 2020 2020 204b 6572 6265 726f 7320         Kerberos 
│ │ │ │ +00009be0: 4461 7461 6261 7365 2046 756e 6374 696f  Database Functio
│ │ │ │ +00009bf0: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │  00009c00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00009c10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00009c20: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00009c30: 286c 696e 6520 2031 3730 290a 2a20 7368  (line  170).* sh
│ │ │ │ -00009c40: 6973 615f 646f 6e65 3a20 2020 2020 2020  isa_done:       
│ │ │ │ +00009c30: 2028 6c69 6e65 2020 3137 3029 0a2a 2073   (line  170).* s
│ │ │ │ +00009c40: 6869 7361 5f64 6f6e 653a 2020 2020 2020  hisa_done:      
│ │ │ │  00009c50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00009c60: 2020 2020 204b 6572 6265 726f 7320 4461       Kerberos Da
│ │ │ │ -00009c70: 7461 6261 7365 2046 756e 6374 696f 6e73  tabase Functions
│ │ │ │ -00009c80: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │ +00009c60: 2020 2020 2020 4b65 7262 6572 6f73 2044        Kerberos D
│ │ │ │ +00009c70: 6174 6162 6173 6520 4675 6e63 7469 6f6e  atabase Function
│ │ │ │ +00009c80: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │  00009c90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00009ca0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00009cb0: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ -00009cc0: 6c69 6e65 2020 2037 3829 0a2a 2073 6869  line   78).* shi
│ │ │ │ -00009cd0: 7361 5f65 6e75 6d65 7261 7465 5f70 7269  sa_enumerate_pri
│ │ │ │ -00009ce0: 6e63 6970 616c 733a 2020 2020 2020 2020  ncipals:        
│ │ │ │ -00009cf0: 2020 2020 4b65 7262 6572 6f73 2044 6174      Kerberos Dat
│ │ │ │ -00009d00: 6162 6173 6520 4675 6e63 7469 6f6e 732e  abase Functions.
│ │ │ │ -00009d10: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ +00009cb0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +00009cc0: 286c 696e 6520 2020 3738 290a 2a20 7368  (line   78).* sh
│ │ │ │ +00009cd0: 6973 615f 656e 756d 6572 6174 655f 7072  isa_enumerate_pr
│ │ │ │ +00009ce0: 696e 6369 7061 6c73 3a20 2020 2020 2020  incipals:       
│ │ │ │ +00009cf0: 2020 2020 204b 6572 6265 726f 7320 4461       Kerberos Da
│ │ │ │ +00009d00: 7461 6261 7365 2046 756e 6374 696f 6e73  tabase Functions
│ │ │ │ +00009d10: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │  00009d20: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00009d30: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00009d40: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ -00009d50: 696e 6520 2032 3138 290a 2a20 7368 6973  ine  218).* shis
│ │ │ │ -00009d60: 615f 656e 756d 6572 6174 655f 7265 616c  a_enumerate_real
│ │ │ │ -00009d70: 6d73 3a20 2020 2020 2020 2020 2020 2020  ms:             
│ │ │ │ -00009d80: 2020 204b 6572 6265 726f 7320 4461 7461     Kerberos Data
│ │ │ │ -00009d90: 6261 7365 2046 756e 6374 696f 6e73 2e0a  base Functions..
│ │ │ │ -00009da0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +00009d40: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ +00009d50: 6c69 6e65 2020 3231 3829 0a2a 2073 6869  line  218).* shi
│ │ │ │ +00009d60: 7361 5f65 6e75 6d65 7261 7465 5f72 6561  sa_enumerate_rea
│ │ │ │ +00009d70: 6c6d 733a 2020 2020 2020 2020 2020 2020  lms:            
│ │ │ │ +00009d80: 2020 2020 4b65 7262 6572 6f73 2044 6174      Kerberos Dat
│ │ │ │ +00009d90: 6162 6173 6520 4675 6e63 7469 6f6e 732e  abase Functions.
│ │ │ │ +00009da0: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │  00009db0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00009dc0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00009dd0: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ -00009de0: 6e65 2020 3230 3129 0a2a 2073 6869 7361  ne  201).* shisa
│ │ │ │ -00009df0: 5f69 6e66 6f3a 2020 2020 2020 2020 2020  _info:          
│ │ │ │ +00009dd0: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ +00009de0: 696e 6520 2032 3031 290a 2a20 7368 6973  ine  201).* shis
│ │ │ │ +00009df0: 615f 696e 666f 3a20 2020 2020 2020 2020  a_info:         
│ │ │ │  00009e00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00009e10: 2020 4b65 7262 6572 6f73 2044 6174 6162    Kerberos Datab
│ │ │ │ -00009e20: 6173 6520 4675 6e63 7469 6f6e 732e 0a20  ase Functions.. 
│ │ │ │ +00009e10: 2020 204b 6572 6265 726f 7320 4461 7461     Kerberos Data
│ │ │ │ +00009e20: 6261 7365 2046 756e 6374 696f 6e73 2e0a  base Functions..
│ │ │ │  00009e30: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00009e40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00009e50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00009e60: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ -00009e70: 6520 2034 3633 290a 2a20 7368 6973 615f  e  463).* shisa_
│ │ │ │ -00009e80: 696e 6974 3a20 2020 2020 2020 2020 2020  init:           
│ │ │ │ +00009e60: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ +00009e70: 6e65 2020 3436 3329 0a2a 2073 6869 7361  ne  463).* shisa
│ │ │ │ +00009e80: 5f69 6e69 743a 2020 2020 2020 2020 2020  _init:          
│ │ │ │  00009e90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00009ea0: 204b 6572 6265 726f 7320 4461 7461 6261   Kerberos Databa
│ │ │ │ -00009eb0: 7365 2046 756e 6374 696f 6e73 2e0a 2020  se Functions..  
│ │ │ │ +00009ea0: 2020 4b65 7262 6572 6f73 2044 6174 6162    Kerberos Datab
│ │ │ │ +00009eb0: 6173 6520 4675 6e63 7469 6f6e 732e 0a20  ase Functions.. 
│ │ │ │  00009ec0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00009ed0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00009ee0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00009ef0: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ -00009f00: 2020 2038 3829 0a2a 2073 6869 7361 5f69     88).* shisa_i
│ │ │ │ -00009f10: 6e69 745f 7769 7468 5f70 6174 6873 3a20  nit_with_paths: 
│ │ │ │ +00009ef0: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ +00009f00: 6520 2020 3838 290a 2a20 7368 6973 615f  e   88).* shisa_
│ │ │ │ +00009f10: 696e 6974 5f77 6974 685f 7061 7468 733a  init_with_paths:
│ │ │ │  00009f20: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00009f30: 4b65 7262 6572 6f73 2044 6174 6162 6173  Kerberos Databas
│ │ │ │ -00009f40: 6520 4675 6e63 7469 6f6e 732e 0a20 2020  e Functions..   
│ │ │ │ +00009f30: 204b 6572 6265 726f 7320 4461 7461 6261   Kerberos Databa
│ │ │ │ +00009f40: 7365 2046 756e 6374 696f 6e73 2e0a 2020  se Functions..  
│ │ │ │  00009f50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00009f60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00009f70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00009f80: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ -00009f90: 2031 3037 290a 2a20 7368 6973 615f 6b65   107).* shisa_ke
│ │ │ │ -00009fa0: 795f 6164 643a 2020 2020 2020 2020 2020  y_add:          
│ │ │ │ -00009fb0: 2020 2020 2020 2020 2020 2020 2020 204b                 K
│ │ │ │ -00009fc0: 6572 6265 726f 7320 4461 7461 6261 7365  erberos Database
│ │ │ │ -00009fd0: 2046 756e 6374 696f 6e73 2e0a 2020 2020   Functions..    
│ │ │ │ +00009f80: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ +00009f90: 2020 3130 3729 0a2a 2073 6869 7361 5f6b    107).* shisa_k
│ │ │ │ +00009fa0: 6579 5f61 6464 3a20 2020 2020 2020 2020  ey_add:         
│ │ │ │ +00009fb0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +00009fc0: 4b65 7262 6572 6f73 2044 6174 6162 6173  Kerberos Databas
│ │ │ │ +00009fd0: 6520 4675 6e63 7469 6f6e 732e 0a20 2020  e Functions..   
│ │ │ │  00009fe0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00009ff0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000a000: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000a010: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ -0000a020: 3335 3229 0a2a 2073 6869 7361 5f6b 6579  352).* shisa_key
│ │ │ │ -0000a030: 5f66 7265 653a 2020 2020 2020 2020 2020  _free:          
│ │ │ │ -0000a040: 2020 2020 2020 2020 2020 2020 2020 4b65                Ke
│ │ │ │ -0000a050: 7262 6572 6f73 2044 6174 6162 6173 6520  rberos Database 
│ │ │ │ -0000a060: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │ +0000a010: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ +0000a020: 2033 3532 290a 2a20 7368 6973 615f 6b65   352).* shisa_ke
│ │ │ │ +0000a030: 795f 6672 6565 3a20 2020 2020 2020 2020  y_free:         
│ │ │ │ +0000a040: 2020 2020 2020 2020 2020 2020 2020 204b                 K
│ │ │ │ +0000a050: 6572 6265 726f 7320 4461 7461 6261 7365  erberos Database
│ │ │ │ +0000a060: 2046 756e 6374 696f 6e73 2e0a 2020 2020   Functions..    
│ │ │ │  0000a070: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000a080: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000a090: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000a0a0: 2020 2020 2020 2020 286c 696e 6520 2034          (line  4
│ │ │ │ -0000a0b0: 3233 290a 2a20 7368 6973 615f 6b65 795f  23).* shisa_key_
│ │ │ │ -0000a0c0: 7265 6d6f 7665 3a20 2020 2020 2020 2020  remove:         
│ │ │ │ -0000a0d0: 2020 2020 2020 2020 2020 2020 204b 6572               Ker
│ │ │ │ -0000a0e0: 6265 726f 7320 4461 7461 6261 7365 2046  beros Database F
│ │ │ │ -0000a0f0: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │ +0000a0a0: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ +0000a0b0: 3432 3329 0a2a 2073 6869 7361 5f6b 6579  423).* shisa_key
│ │ │ │ +0000a0c0: 5f72 656d 6f76 653a 2020 2020 2020 2020  _remove:        
│ │ │ │ +0000a0d0: 2020 2020 2020 2020 2020 2020 2020 4b65                Ke
│ │ │ │ +0000a0e0: 7262 6572 6f73 2044 6174 6162 6173 6520  rberos Database 
│ │ │ │ +0000a0f0: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │  0000a100: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000a110: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000a120: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000a130: 2020 2020 2020 2028 6c69 6e65 2020 3339         (line  39
│ │ │ │ -0000a140: 3929 0a2a 2073 6869 7361 5f6b 6579 5f75  9).* shisa_key_u
│ │ │ │ -0000a150: 7064 6174 653a 2020 2020 2020 2020 2020  pdate:          
│ │ │ │ -0000a160: 2020 2020 2020 2020 2020 2020 4b65 7262              Kerb
│ │ │ │ -0000a170: 6572 6f73 2044 6174 6162 6173 6520 4675  eros Database Fu
│ │ │ │ -0000a180: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │ +0000a130: 2020 2020 2020 2020 286c 696e 6520 2033          (line  3
│ │ │ │ +0000a140: 3939 290a 2a20 7368 6973 615f 6b65 795f  99).* shisa_key_
│ │ │ │ +0000a150: 7570 6461 7465 3a20 2020 2020 2020 2020  update:         
│ │ │ │ +0000a160: 2020 2020 2020 2020 2020 2020 204b 6572               Ker
│ │ │ │ +0000a170: 6265 726f 7320 4461 7461 6261 7365 2046  beros Database F
│ │ │ │ +0000a180: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │  0000a190: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000a1a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000a1b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000a1c0: 2020 2020 2020 286c 696e 6520 2033 3638        (line  368
│ │ │ │ -0000a1d0: 290a 2a20 7368 6973 615f 6b65 7973 5f66  ).* shisa_keys_f
│ │ │ │ -0000a1e0: 696e 643a 2020 2020 2020 2020 2020 2020  ind:            
│ │ │ │ -0000a1f0: 2020 2020 2020 2020 2020 204b 6572 6265             Kerbe
│ │ │ │ -0000a200: 726f 7320 4461 7461 6261 7365 2046 756e  ros Database Fun
│ │ │ │ -0000a210: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │ +0000a1c0: 2020 2020 2020 2028 6c69 6e65 2020 3336         (line  36
│ │ │ │ +0000a1d0: 3829 0a2a 2073 6869 7361 5f6b 6579 735f  8).* shisa_keys_
│ │ │ │ +0000a1e0: 6669 6e64 3a20 2020 2020 2020 2020 2020  find:           
│ │ │ │ +0000a1f0: 2020 2020 2020 2020 2020 2020 4b65 7262              Kerb
│ │ │ │ +0000a200: 6572 6f73 2044 6174 6162 6173 6520 4675  eros Database Fu
│ │ │ │ +0000a210: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │  0000a220: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000a230: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000a240: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000a250: 2020 2020 2028 6c69 6e65 2020 3332 3529       (line  325)
│ │ │ │ -0000a260: 0a2a 2073 6869 7361 5f6b 6579 735f 6672  .* shisa_keys_fr
│ │ │ │ -0000a270: 6565 3a20 2020 2020 2020 2020 2020 2020  ee:             
│ │ │ │ -0000a280: 2020 2020 2020 2020 2020 4b65 7262 6572            Kerber
│ │ │ │ -0000a290: 6f73 2044 6174 6162 6173 6520 4675 6e63  os Database Func
│ │ │ │ -0000a2a0: 7469 6f6e 732e 0a20 2020 2020 2020 2020  tions..         
│ │ │ │ +0000a250: 2020 2020 2020 286c 696e 6520 2033 3235        (line  325
│ │ │ │ +0000a260: 290a 2a20 7368 6973 615f 6b65 7973 5f66  ).* shisa_keys_f
│ │ │ │ +0000a270: 7265 653a 2020 2020 2020 2020 2020 2020  ree:            
│ │ │ │ +0000a280: 2020 2020 2020 2020 2020 204b 6572 6265             Kerbe
│ │ │ │ +0000a290: 726f 7320 4461 7461 6261 7365 2046 756e  ros Database Fun
│ │ │ │ +0000a2a0: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │  0000a2b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000a2c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000a2d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000a2e0: 2020 2020 286c 696e 6520 2034 3333 290a      (line  433).
│ │ │ │ -0000a2f0: 2a20 7368 6973 615f 7072 696e 6369 7061  * shisa_principa
│ │ │ │ -0000a300: 6c5f 6164 643a 2020 2020 2020 2020 2020  l_add:          
│ │ │ │ -0000a310: 2020 2020 2020 2020 204b 6572 6265 726f           Kerbero
│ │ │ │ -0000a320: 7320 4461 7461 6261 7365 2046 756e 6374  s Database Funct
│ │ │ │ -0000a330: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │ +0000a2e0: 2020 2020 2028 6c69 6e65 2020 3433 3329       (line  433)
│ │ │ │ +0000a2f0: 0a2a 2073 6869 7361 5f70 7269 6e63 6970  .* shisa_princip
│ │ │ │ +0000a300: 616c 5f61 6464 3a20 2020 2020 2020 2020  al_add:         
│ │ │ │ +0000a310: 2020 2020 2020 2020 2020 4b65 7262 6572            Kerber
│ │ │ │ +0000a320: 6f73 2044 6174 6162 6173 6520 4675 6e63  os Database Func
│ │ │ │ +0000a330: 7469 6f6e 732e 0a20 2020 2020 2020 2020  tions..         
│ │ │ │  0000a340: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000a350: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000a360: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000a370: 2020 2028 6c69 6e65 2020 3238 3529 0a2a     (line  285).*
│ │ │ │ -0000a380: 2073 6869 7361 5f70 7269 6e63 6970 616c   shisa_principal
│ │ │ │ -0000a390: 5f66 696e 643a 2020 2020 2020 2020 2020  _find:          
│ │ │ │ -0000a3a0: 2020 2020 2020 2020 4b65 7262 6572 6f73          Kerberos
│ │ │ │ -0000a3b0: 2044 6174 6162 6173 6520 4675 6e63 7469   Database Functi
│ │ │ │ -0000a3c0: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │ +0000a370: 2020 2020 286c 696e 6520 2032 3835 290a      (line  285).
│ │ │ │ +0000a380: 2a20 7368 6973 615f 7072 696e 6369 7061  * shisa_principa
│ │ │ │ +0000a390: 6c5f 6669 6e64 3a20 2020 2020 2020 2020  l_find:         
│ │ │ │ +0000a3a0: 2020 2020 2020 2020 204b 6572 6265 726f           Kerbero
│ │ │ │ +0000a3b0: 7320 4461 7461 6261 7365 2046 756e 6374  s Database Funct
│ │ │ │ +0000a3c0: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │  0000a3d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000a3e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000a3f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000a400: 2020 286c 696e 6520 2032 3338 290a 2a20    (line  238).* 
│ │ │ │ -0000a410: 7368 6973 615f 7072 696e 6369 7061 6c5f  shisa_principal_
│ │ │ │ -0000a420: 7265 6d6f 7665 3a20 2020 2020 2020 2020  remove:         
│ │ │ │ -0000a430: 2020 2020 2020 204b 6572 6265 726f 7320         Kerberos 
│ │ │ │ -0000a440: 4461 7461 6261 7365 2046 756e 6374 696f  Database Functio
│ │ │ │ -0000a450: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │ +0000a400: 2020 2028 6c69 6e65 2020 3233 3829 0a2a     (line  238).*
│ │ │ │ +0000a410: 2073 6869 7361 5f70 7269 6e63 6970 616c   shisa_principal
│ │ │ │ +0000a420: 5f72 656d 6f76 653a 2020 2020 2020 2020  _remove:        
│ │ │ │ +0000a430: 2020 2020 2020 2020 4b65 7262 6572 6f73          Kerberos
│ │ │ │ +0000a440: 2044 6174 6162 6173 6520 4675 6e63 7469   Database Functi
│ │ │ │ +0000a450: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │  0000a460: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000a470: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000a480: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000a490: 2028 6c69 6e65 2020 3330 3829 0a2a 2073   (line  308).* s
│ │ │ │ -0000a4a0: 6869 7361 5f70 7269 6e63 6970 616c 5f75  hisa_principal_u
│ │ │ │ -0000a4b0: 7064 6174 653a 2020 2020 2020 2020 2020  pdate:          
│ │ │ │ -0000a4c0: 2020 2020 2020 4b65 7262 6572 6f73 2044        Kerberos D
│ │ │ │ -0000a4d0: 6174 6162 6173 6520 4675 6e63 7469 6f6e  atabase Function
│ │ │ │ -0000a4e0: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │ +0000a490: 2020 286c 696e 6520 2033 3038 290a 2a20    (line  308).* 
│ │ │ │ +0000a4a0: 7368 6973 615f 7072 696e 6369 7061 6c5f  shisa_principal_
│ │ │ │ +0000a4b0: 7570 6461 7465 3a20 2020 2020 2020 2020  update:         
│ │ │ │ +0000a4c0: 2020 2020 2020 204b 6572 6265 726f 7320         Kerberos 
│ │ │ │ +0000a4d0: 4461 7461 6261 7365 2046 756e 6374 696f  Database Functio
│ │ │ │ +0000a4e0: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │  0000a4f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000a500: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000a510: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000a520: 286c 696e 6520 2032 3536 290a 2a20 7368  (line  256).* sh
│ │ │ │ -0000a530: 6973 615f 7374 7265 7272 6f72 3a20 2020  isa_strerror:   
│ │ │ │ +0000a520: 2028 6c69 6e65 2020 3235 3629 0a2a 2073   (line  256).* s
│ │ │ │ +0000a530: 6869 7361 5f73 7472 6572 726f 723a 2020  hisa_strerror:  
│ │ │ │  0000a540: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000a550: 2020 2020 204b 6572 6265 726f 7320 4461       Kerberos Da
│ │ │ │ -0000a560: 7461 6261 7365 2046 756e 6374 696f 6e73  tabase Functions
│ │ │ │ -0000a570: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │ +0000a550: 2020 2020 2020 4b65 7262 6572 6f73 2044        Kerberos D
│ │ │ │ +0000a560: 6174 6162 6173 6520 4675 6e63 7469 6f6e  atabase Function
│ │ │ │ +0000a570: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │  0000a580: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000a590: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000a5a0: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ -0000a5b0: 6c69 6e65 2020 3435 3029 0a2a 2073 6869  line  450).* shi
│ │ │ │ -0000a5c0: 7368 693a 2020 2020 2020 2020 2020 2020  shi:            
│ │ │ │ +0000a5a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0000a5b0: 286c 696e 6520 2034 3530 290a 2a20 7368  (line  450).* sh
│ │ │ │ +0000a5c0: 6973 6869 3a20 2020 2020 2020 2020 2020  ishi:           
│ │ │ │  0000a5d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000a5e0: 2020 2020 496e 6974 6961 6c69 7a61 7469      Initializati
│ │ │ │ -0000a5f0: 6f6e 2046 756e 6374 696f 6e73 2e0a 2020  on Functions..  
│ │ │ │ +0000a5e0: 2020 2020 2049 6e69 7469 616c 697a 6174       Initializat
│ │ │ │ +0000a5f0: 696f 6e20 4675 6e63 7469 6f6e 732e 0a20  ion Functions.. 
│ │ │ │  0000a600: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000a610: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000a620: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000a630: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ -0000a640: 2020 2020 3929 0a2a 2073 6869 7368 695f      9).* shishi_
│ │ │ │ -0000a650: 3364 6573 3a20 2020 2020 2020 2020 2020  3des:           
│ │ │ │ +0000a630: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ +0000a640: 6520 2020 2039 290a 2a20 7368 6973 6869  e    9).* shishi
│ │ │ │ +0000a650: 5f33 6465 733a 2020 2020 2020 2020 2020  _3des:          
│ │ │ │  0000a660: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000a670: 4372 7970 746f 6772 6170 6869 6320 4675  Cryptographic Fu
│ │ │ │ -0000a680: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │ +0000a670: 2043 7279 7074 6f67 7261 7068 6963 2046   Cryptographic F
│ │ │ │ +0000a680: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │  0000a690: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000a6a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000a6b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000a6c0: 2020 2020 2020 286c 696e 6520 3135 3634        (line 1564
│ │ │ │ -0000a6d0: 290a 2a20 7368 6973 6869 5f61 6573 5f63  ).* shishi_aes_c
│ │ │ │ -0000a6e0: 7473 3a20 2020 2020 2020 2020 2020 2020  ts:             
│ │ │ │ -0000a6f0: 2020 2020 2020 2020 2020 2043 7279 7074             Crypt
│ │ │ │ -0000a700: 6f67 7261 7068 6963 2046 756e 6374 696f  ographic Functio
│ │ │ │ -0000a710: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │ +0000a6c0: 2020 2020 2020 2028 6c69 6e65 2031 3536         (line 156
│ │ │ │ +0000a6d0: 3429 0a2a 2073 6869 7368 695f 6165 735f  4).* shishi_aes_
│ │ │ │ +0000a6e0: 6374 733a 2020 2020 2020 2020 2020 2020  cts:            
│ │ │ │ +0000a6f0: 2020 2020 2020 2020 2020 2020 4372 7970              Cryp
│ │ │ │ +0000a700: 746f 6772 6170 6869 6320 4675 6e63 7469  tographic Functi
│ │ │ │ +0000a710: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │  0000a720: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000a730: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000a740: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000a750: 2028 6c69 6e65 2031 3538 3829 0a2a 2073   (line 1588).* s
│ │ │ │ -0000a760: 6869 7368 695f 6170 3a20 2020 2020 2020  hishi_ap:       
│ │ │ │ +0000a750: 2020 286c 696e 6520 3135 3838 290a 2a20    (line 1588).* 
│ │ │ │ +0000a760: 7368 6973 6869 5f61 703a 2020 2020 2020  shishi_ap:      
│ │ │ │  0000a770: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000a780: 2020 2020 2020 4150 2d52 4551 2061 6e64        AP-REQ and
│ │ │ │ -0000a790: 2041 502d 5245 5020 4675 6e63 7469 6f6e   AP-REP Function
│ │ │ │ -0000a7a0: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │ +0000a780: 2020 2020 2020 2041 502d 5245 5120 616e         AP-REQ an
│ │ │ │ +0000a790: 6420 4150 2d52 4550 2046 756e 6374 696f  d AP-REP Functio
│ │ │ │ +0000a7a0: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │  0000a7b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000a7c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000a7d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000a7e0: 286c 696e 6520 2020 3339 290a 2a20 7368  (line   39).* sh
│ │ │ │ -0000a7f0: 6973 6869 5f61 705f 6175 7468 656e 7469  ishi_ap_authenti
│ │ │ │ -0000a800: 6361 746f 723a 2020 2020 2020 2020 2020  cator:          
│ │ │ │ -0000a810: 2020 2020 2041 502d 5245 5120 616e 6420       AP-REQ and 
│ │ │ │ -0000a820: 4150 2d52 4550 2046 756e 6374 696f 6e73  AP-REP Functions
│ │ │ │ -0000a830: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │ +0000a7e0: 2028 6c69 6e65 2020 2033 3929 0a2a 2073   (line   39).* s
│ │ │ │ +0000a7f0: 6869 7368 695f 6170 5f61 7574 6865 6e74  hishi_ap_authent
│ │ │ │ +0000a800: 6963 6174 6f72 3a20 2020 2020 2020 2020  icator:         
│ │ │ │ +0000a810: 2020 2020 2020 4150 2d52 4551 2061 6e64        AP-REQ and
│ │ │ │ +0000a820: 2041 502d 5245 5020 4675 6e63 7469 6f6e   AP-REP Function
│ │ │ │ +0000a830: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │  0000a840: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000a850: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000a860: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ -0000a870: 6c69 6e65 2020 3337 3929 0a2a 2073 6869  line  379).* shi
│ │ │ │ -0000a880: 7368 695f 6170 5f61 7574 6865 6e74 6963  shi_ap_authentic
│ │ │ │ -0000a890: 6174 6f72 5f63 6b73 756d 6461 7461 3a20  ator_cksumdata: 
│ │ │ │ -0000a8a0: 2020 2020 4150 2d52 4551 2061 6e64 2041      AP-REQ and A
│ │ │ │ -0000a8b0: 502d 5245 5020 4675 6e63 7469 6f6e 732e  P-REP Functions.
│ │ │ │ -0000a8c0: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ +0000a860: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0000a870: 286c 696e 6520 2033 3739 290a 2a20 7368  (line  379).* sh
│ │ │ │ +0000a880: 6973 6869 5f61 705f 6175 7468 656e 7469  ishi_ap_authenti
│ │ │ │ +0000a890: 6361 746f 725f 636b 7375 6d64 6174 613a  cator_cksumdata:
│ │ │ │ +0000a8a0: 2020 2020 2041 502d 5245 5120 616e 6420       AP-REQ and 
│ │ │ │ +0000a8b0: 4150 2d52 4550 2046 756e 6374 696f 6e73  AP-REP Functions
│ │ │ │ +0000a8c0: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │  0000a8d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000a8e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000a8f0: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ -0000a900: 696e 6520 2033 3034 290a 2a20 7368 6973  ine  304).* shis
│ │ │ │ -0000a910: 6869 5f61 705f 6175 7468 656e 7469 6361  hi_ap_authentica
│ │ │ │ -0000a920: 746f 725f 636b 7375 6d64 6174 615f 7365  tor_cksumdata_se
│ │ │ │ -0000a930: 743a 2041 502d 5245 5120 616e 6420 4150  t: AP-REQ and AP
│ │ │ │ -0000a940: 2d52 4550 2046 756e 6374 696f 6e73 2e0a  -REP Functions..
│ │ │ │ -0000a950: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0000a8f0: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ +0000a900: 6c69 6e65 2020 3330 3429 0a2a 2073 6869  line  304).* shi
│ │ │ │ +0000a910: 7368 695f 6170 5f61 7574 6865 6e74 6963  shi_ap_authentic
│ │ │ │ +0000a920: 6174 6f72 5f63 6b73 756d 6461 7461 5f73  ator_cksumdata_s
│ │ │ │ +0000a930: 6574 3a20 4150 2d52 4551 2061 6e64 2041  et: AP-REQ and A
│ │ │ │ +0000a940: 502d 5245 5020 4675 6e63 7469 6f6e 732e  P-REP Functions.
│ │ │ │ +0000a950: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │  0000a960: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000a970: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000a980: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ -0000a990: 6e65 2020 3332 3129 0a2a 2073 6869 7368  ne  321).* shish
│ │ │ │ -0000a9a0: 695f 6170 5f61 7574 6865 6e74 6963 6174  i_ap_authenticat
│ │ │ │ -0000a9b0: 6f72 5f63 6b73 756d 7261 775f 7365 743a  or_cksumraw_set:
│ │ │ │ -0000a9c0: 2020 4150 2d52 4551 2061 6e64 2041 502d    AP-REQ and AP-
│ │ │ │ -0000a9d0: 5245 5020 4675 6e63 7469 6f6e 732e 0a20  REP Functions.. 
│ │ │ │ +0000a980: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ +0000a990: 696e 6520 2033 3231 290a 2a20 7368 6973  ine  321).* shis
│ │ │ │ +0000a9a0: 6869 5f61 705f 6175 7468 656e 7469 6361  hi_ap_authentica
│ │ │ │ +0000a9b0: 746f 725f 636b 7375 6d72 6177 5f73 6574  tor_cksumraw_set
│ │ │ │ +0000a9c0: 3a20 2041 502d 5245 5120 616e 6420 4150  :  AP-REQ and AP
│ │ │ │ +0000a9d0: 2d52 4550 2046 756e 6374 696f 6e73 2e0a  -REP Functions..
│ │ │ │  0000a9e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000a9f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000aa00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000aa10: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ -0000aa20: 6520 2033 3338 290a 2a20 7368 6973 6869  e  338).* shishi
│ │ │ │ -0000aa30: 5f61 705f 6175 7468 656e 7469 6361 746f  _ap_authenticato
│ │ │ │ -0000aa40: 725f 636b 7375 6d74 7970 653a 2020 2020  r_cksumtype:    
│ │ │ │ -0000aa50: 2041 502d 5245 5120 616e 6420 4150 2d52   AP-REQ and AP-R
│ │ │ │ -0000aa60: 4550 2046 756e 6374 696f 6e73 2e0a 2020  EP Functions..  
│ │ │ │ +0000aa10: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ +0000aa20: 6e65 2020 3333 3829 0a2a 2073 6869 7368  ne  338).* shish
│ │ │ │ +0000aa30: 695f 6170 5f61 7574 6865 6e74 6963 6174  i_ap_authenticat
│ │ │ │ +0000aa40: 6f72 5f63 6b73 756d 7479 7065 3a20 2020  or_cksumtype:   
│ │ │ │ +0000aa50: 2020 4150 2d52 4551 2061 6e64 2041 502d    AP-REQ and AP-
│ │ │ │ +0000aa60: 5245 5020 4675 6e63 7469 6f6e 732e 0a20  REP Functions.. 
│ │ │ │  0000aa70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000aa80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000aa90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000aaa0: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ -0000aab0: 2020 3335 3729 0a2a 2073 6869 7368 695f    357).* shishi_
│ │ │ │ -0000aac0: 6170 5f61 7574 6865 6e74 6963 6174 6f72  ap_authenticator
│ │ │ │ -0000aad0: 5f63 6b73 756d 7479 7065 5f73 6574 3a20  _cksumtype_set: 
│ │ │ │ -0000aae0: 4150 2d52 4551 2061 6e64 2041 502d 5245  AP-REQ and AP-RE
│ │ │ │ -0000aaf0: 5020 4675 6e63 7469 6f6e 732e 0a20 2020  P Functions..   
│ │ │ │ +0000aaa0: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ +0000aab0: 6520 2033 3537 290a 2a20 7368 6973 6869  e  357).* shishi
│ │ │ │ +0000aac0: 5f61 705f 6175 7468 656e 7469 6361 746f  _ap_authenticato
│ │ │ │ +0000aad0: 725f 636b 7375 6d74 7970 655f 7365 743a  r_cksumtype_set:
│ │ │ │ +0000aae0: 2041 502d 5245 5120 616e 6420 4150 2d52   AP-REQ and AP-R
│ │ │ │ +0000aaf0: 4550 2046 756e 6374 696f 6e73 2e0a 2020  EP Functions..  
│ │ │ │  0000ab00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000ab10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000ab20: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000ab30: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ -0000ab40: 2033 3638 290a 2a20 7368 6973 6869 5f61   368).* shishi_a
│ │ │ │ -0000ab50: 705f 6175 7468 656e 7469 6361 746f 725f  p_authenticator_
│ │ │ │ -0000ab60: 7365 743a 2020 2020 2020 2020 2020 2041  set:           A
│ │ │ │ -0000ab70: 502d 5245 5120 616e 6420 4150 2d52 4550  P-REQ and AP-REP
│ │ │ │ -0000ab80: 2046 756e 6374 696f 6e73 2e0a 2020 2020   Functions..    
│ │ │ │ +0000ab30: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ +0000ab40: 2020 3336 3829 0a2a 2073 6869 7368 695f    368).* shishi_
│ │ │ │ +0000ab50: 6170 5f61 7574 6865 6e74 6963 6174 6f72  ap_authenticator
│ │ │ │ +0000ab60: 5f73 6574 3a20 2020 2020 2020 2020 2020  _set:           
│ │ │ │ +0000ab70: 4150 2d52 4551 2061 6e64 2041 502d 5245  AP-REQ and AP-RE
│ │ │ │ +0000ab80: 5020 4675 6e63 7469 6f6e 732e 0a20 2020  P Functions..   
│ │ │ │  0000ab90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000aba0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000abb0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000abc0: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ -0000abd0: 3339 3029 0a2a 2073 6869 7368 695f 6170  390).* shishi_ap
│ │ │ │ -0000abe0: 5f64 6f6e 653a 2020 2020 2020 2020 2020  _done:          
│ │ │ │ -0000abf0: 2020 2020 2020 2020 2020 2020 2020 4150                AP
│ │ │ │ -0000ac00: 2d52 4551 2061 6e64 2041 502d 5245 5020  -REQ and AP-REP 
│ │ │ │ -0000ac10: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │ +0000abc0: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ +0000abd0: 2033 3930 290a 2a20 7368 6973 6869 5f61   390).* shishi_a
│ │ │ │ +0000abe0: 705f 646f 6e65 3a20 2020 2020 2020 2020  p_done:         
│ │ │ │ +0000abf0: 2020 2020 2020 2020 2020 2020 2020 2041                 A
│ │ │ │ +0000ac00: 502d 5245 5120 616e 6420 4150 2d52 4550  P-REQ and AP-REP
│ │ │ │ +0000ac10: 2046 756e 6374 696f 6e73 2e0a 2020 2020   Functions..    
│ │ │ │  0000ac20: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000ac30: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000ac40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000ac50: 2020 2020 2020 2020 286c 696e 6520 2020          (line   
│ │ │ │ -0000ac60: 3834 290a 2a20 7368 6973 6869 5f61 705f  84).* shishi_ap_
│ │ │ │ -0000ac70: 656e 6361 7072 6570 7061 7274 3a20 2020  encapreppart:   
│ │ │ │ -0000ac80: 2020 2020 2020 2020 2020 2020 2041 502d               AP-
│ │ │ │ -0000ac90: 5245 5120 616e 6420 4150 2d52 4550 2046  REQ and AP-REP F
│ │ │ │ -0000aca0: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │ +0000ac50: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ +0000ac60: 2038 3429 0a2a 2073 6869 7368 695f 6170   84).* shishi_ap
│ │ │ │ +0000ac70: 5f65 6e63 6170 7265 7070 6172 743a 2020  _encapreppart:  
│ │ │ │ +0000ac80: 2020 2020 2020 2020 2020 2020 2020 4150                AP
│ │ │ │ +0000ac90: 2d52 4551 2061 6e64 2041 502d 5245 5020  -REQ and AP-REP 
│ │ │ │ +0000aca0: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │  0000acb0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000acc0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000acd0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000ace0: 2020 2020 2020 2028 6c69 6e65 2020 3634         (line  64
│ │ │ │ -0000acf0: 3529 0a2a 2073 6869 7368 695f 6170 5f65  5).* shishi_ap_e
│ │ │ │ -0000ad00: 6e63 6170 7265 7070 6172 745f 7365 743a  ncapreppart_set:
│ │ │ │ -0000ad10: 2020 2020 2020 2020 2020 2020 4150 2d52              AP-R
│ │ │ │ -0000ad20: 4551 2061 6e64 2041 502d 5245 5020 4675  EQ and AP-REP Fu
│ │ │ │ -0000ad30: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │ +0000ace0: 2020 2020 2020 2020 286c 696e 6520 2036          (line  6
│ │ │ │ +0000acf0: 3435 290a 2a20 7368 6973 6869 5f61 705f  45).* shishi_ap_
│ │ │ │ +0000ad00: 656e 6361 7072 6570 7061 7274 5f73 6574  encapreppart_set
│ │ │ │ +0000ad10: 3a20 2020 2020 2020 2020 2020 2041 502d  :            AP-
│ │ │ │ +0000ad20: 5245 5120 616e 6420 4150 2d52 4550 2046  REQ and AP-REP F
│ │ │ │ +0000ad30: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │  0000ad40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000ad50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000ad60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000ad70: 2020 2020 2020 286c 696e 6520 2036 3536        (line  656
│ │ │ │ -0000ad80: 290a 2a20 7368 6973 6869 5f61 705f 6574  ).* shishi_ap_et
│ │ │ │ -0000ad90: 7970 653a 2020 2020 2020 2020 2020 2020  ype:            
│ │ │ │ -0000ada0: 2020 2020 2020 2020 2020 2041 502d 5245             AP-RE
│ │ │ │ -0000adb0: 5120 616e 6420 4150 2d52 4550 2046 756e  Q and AP-REP Fun
│ │ │ │ -0000adc0: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │ +0000ad70: 2020 2020 2020 2028 6c69 6e65 2020 3635         (line  65
│ │ │ │ +0000ad80: 3629 0a2a 2073 6869 7368 695f 6170 5f65  6).* shishi_ap_e
│ │ │ │ +0000ad90: 7479 7065 3a20 2020 2020 2020 2020 2020  type:           
│ │ │ │ +0000ada0: 2020 2020 2020 2020 2020 2020 4150 2d52              AP-R
│ │ │ │ +0000adb0: 4551 2061 6e64 2041 502d 5245 5020 4675  EQ and AP-REP Fu
│ │ │ │ +0000adc0: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │  0000add0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000ade0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000adf0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000ae00: 2020 2020 2028 6c69 6e65 2020 2035 3629       (line   56)
│ │ │ │ -0000ae10: 0a2a 2073 6869 7368 695f 6170 5f65 7479  .* shishi_ap_ety
│ │ │ │ -0000ae20: 7065 5f74 6b74 6f70 7469 6f6e 7364 6174  pe_tktoptionsdat
│ │ │ │ -0000ae30: 613a 2020 2020 2020 2020 4150 2d52 4551  a:        AP-REQ
│ │ │ │ -0000ae40: 2061 6e64 2041 502d 5245 5020 4675 6e63   and AP-REP Func
│ │ │ │ -0000ae50: 7469 6f6e 732e 0a20 2020 2020 2020 2020  tions..         
│ │ │ │ +0000ae00: 2020 2020 2020 286c 696e 6520 2020 3536        (line   56
│ │ │ │ +0000ae10: 290a 2a20 7368 6973 6869 5f61 705f 6574  ).* shishi_ap_et
│ │ │ │ +0000ae20: 7970 655f 746b 746f 7074 696f 6e73 6461  ype_tktoptionsda
│ │ │ │ +0000ae30: 7461 3a20 2020 2020 2020 2041 502d 5245  ta:        AP-RE
│ │ │ │ +0000ae40: 5120 616e 6420 4150 2d52 4550 2046 756e  Q and AP-REP Fun
│ │ │ │ +0000ae50: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │  0000ae60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000ae70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000ae80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000ae90: 2020 2020 286c 696e 6520 2032 3334 290a      (line  234).
│ │ │ │ -0000aea0: 2a20 7368 6973 6869 5f61 705f 6b65 793a  * shishi_ap_key:
│ │ │ │ -0000aeb0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000aec0: 2020 2020 2020 2020 2041 502d 5245 5120           AP-REQ 
│ │ │ │ -0000aed0: 616e 6420 4150 2d52 4550 2046 756e 6374  and AP-REP Funct
│ │ │ │ -0000aee0: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │ +0000ae90: 2020 2020 2028 6c69 6e65 2020 3233 3429       (line  234)
│ │ │ │ +0000aea0: 0a2a 2073 6869 7368 695f 6170 5f6b 6579  .* shishi_ap_key
│ │ │ │ +0000aeb0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ +0000aec0: 2020 2020 2020 2020 2020 4150 2d52 4551            AP-REQ
│ │ │ │ +0000aed0: 2061 6e64 2041 502d 5245 5020 4675 6e63   and AP-REP Func
│ │ │ │ +0000aee0: 7469 6f6e 732e 0a20 2020 2020 2020 2020  tions..         
│ │ │ │  0000aef0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000af00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000af10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000af20: 2020 2028 6c69 6e65 2020 3531 3929 0a2a     (line  519).*
│ │ │ │ -0000af30: 2073 6869 7368 695f 6170 5f6e 6f73 7562   shishi_ap_nosub
│ │ │ │ -0000af40: 6b65 793a 2020 2020 2020 2020 2020 2020  key:            
│ │ │ │ -0000af50: 2020 2020 2020 2020 4150 2d52 4551 2061          AP-REQ a
│ │ │ │ -0000af60: 6e64 2041 502d 5245 5020 4675 6e63 7469  nd AP-REP Functi
│ │ │ │ -0000af70: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │ +0000af20: 2020 2020 286c 696e 6520 2035 3139 290a      (line  519).
│ │ │ │ +0000af30: 2a20 7368 6973 6869 5f61 705f 6e6f 7375  * shishi_ap_nosu
│ │ │ │ +0000af40: 626b 6579 3a20 2020 2020 2020 2020 2020  bkey:           
│ │ │ │ +0000af50: 2020 2020 2020 2020 2041 502d 5245 5120           AP-REQ 
│ │ │ │ +0000af60: 616e 6420 4150 2d52 4550 2046 756e 6374  and AP-REP Funct
│ │ │ │ +0000af70: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │  0000af80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000af90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000afa0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000afb0: 2020 286c 696e 6520 2020 3731 290a 2a20    (line   71).* 
│ │ │ │ -0000afc0: 7368 6973 6869 5f61 705f 6f70 7469 6f6e  shishi_ap_option
│ │ │ │ -0000afd0: 3273 7472 696e 673a 2020 2020 2020 2020  2string:        
│ │ │ │ -0000afe0: 2020 2020 2020 2041 502d 5245 5120 616e         AP-REQ an
│ │ │ │ -0000aff0: 6420 4150 2d52 4550 2046 756e 6374 696f  d AP-REP Functio
│ │ │ │ -0000b000: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │ +0000afb0: 2020 2028 6c69 6e65 2020 2037 3129 0a2a     (line   71).*
│ │ │ │ +0000afc0: 2073 6869 7368 695f 6170 5f6f 7074 696f   shishi_ap_optio
│ │ │ │ +0000afd0: 6e32 7374 7269 6e67 3a20 2020 2020 2020  n2string:       
│ │ │ │ +0000afe0: 2020 2020 2020 2020 4150 2d52 4551 2061          AP-REQ a
│ │ │ │ +0000aff0: 6e64 2041 502d 5245 5020 4675 6e63 7469  nd AP-REP Functi
│ │ │ │ +0000b000: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │  0000b010: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000b020: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000b030: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000b040: 2028 6c69 6e65 2020 3636 3629 0a2a 2073   (line  666).* s
│ │ │ │ -0000b050: 6869 7368 695f 6170 5f72 6570 3a20 2020  hishi_ap_rep:   
│ │ │ │ +0000b040: 2020 286c 696e 6520 2036 3636 290a 2a20    (line  666).* 
│ │ │ │ +0000b050: 7368 6973 6869 5f61 705f 7265 703a 2020  shishi_ap_rep:  
│ │ │ │  0000b060: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000b070: 2020 2020 2020 4150 2d52 4551 2061 6e64        AP-REQ and
│ │ │ │ -0000b080: 2041 502d 5245 5020 4675 6e63 7469 6f6e   AP-REP Function
│ │ │ │ -0000b090: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │ +0000b070: 2020 2020 2020 2041 502d 5245 5120 616e         AP-REQ an
│ │ │ │ +0000b080: 6420 4150 2d52 4550 2046 756e 6374 696f  d AP-REP Functio
│ │ │ │ +0000b090: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │  0000b0a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000b0b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000b0c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000b0d0: 286c 696e 6520 2035 3331 290a 2a20 7368  (line  531).* sh
│ │ │ │ -0000b0e0: 6973 6869 5f61 705f 7265 705f 6173 6e31  ishi_ap_rep_asn1
│ │ │ │ -0000b0f0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ -0000b100: 2020 2020 2041 502d 5245 5120 616e 6420       AP-REQ and 
│ │ │ │ -0000b110: 4150 2d52 4550 2046 756e 6374 696f 6e73  AP-REP Functions
│ │ │ │ -0000b120: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │ +0000b0d0: 2028 6c69 6e65 2020 3533 3129 0a2a 2073   (line  531).* s
│ │ │ │ +0000b0e0: 6869 7368 695f 6170 5f72 6570 5f61 736e  hishi_ap_rep_asn
│ │ │ │ +0000b0f0: 313a 2020 2020 2020 2020 2020 2020 2020  1:              
│ │ │ │ +0000b100: 2020 2020 2020 4150 2d52 4551 2061 6e64        AP-REQ and
│ │ │ │ +0000b110: 2041 502d 5245 5020 4675 6e63 7469 6f6e   AP-REP Function
│ │ │ │ +0000b120: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │  0000b130: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000b140: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000b150: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ -0000b160: 6c69 6e65 2020 3539 3129 0a2a 2073 6869  line  591).* shi
│ │ │ │ -0000b170: 7368 695f 6170 5f72 6570 5f62 7569 6c64  shi_ap_rep_build
│ │ │ │ -0000b180: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ -0000b190: 2020 2020 4150 2d52 4551 2061 6e64 2041      AP-REQ and A
│ │ │ │ -0000b1a0: 502d 5245 5020 4675 6e63 7469 6f6e 732e  P-REP Functions.
│ │ │ │ -0000b1b0: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ +0000b150: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0000b160: 286c 696e 6520 2035 3931 290a 2a20 7368  (line  591).* sh
│ │ │ │ +0000b170: 6973 6869 5f61 705f 7265 705f 6275 696c  ishi_ap_rep_buil
│ │ │ │ +0000b180: 643a 2020 2020 2020 2020 2020 2020 2020  d:              
│ │ │ │ +0000b190: 2020 2020 2041 502d 5245 5120 616e 6420       AP-REQ and 
│ │ │ │ +0000b1a0: 4150 2d52 4550 2046 756e 6374 696f 6e73  AP-REP Functions
│ │ │ │ +0000b1b0: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │  0000b1c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000b1d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000b1e0: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ -0000b1f0: 696e 6520 2035 3830 290a 2a20 7368 6973  ine  580).* shis
│ │ │ │ -0000b200: 6869 5f61 705f 7265 705f 6465 723a 2020  hi_ap_rep_der:  
│ │ │ │ +0000b1e0: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ +0000b1f0: 6c69 6e65 2020 3538 3029 0a2a 2073 6869  line  580).* shi
│ │ │ │ +0000b200: 7368 695f 6170 5f72 6570 5f64 6572 3a20  shi_ap_rep_der: 
│ │ │ │  0000b210: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000b220: 2020 2041 502d 5245 5120 616e 6420 4150     AP-REQ and AP
│ │ │ │ -0000b230: 2d52 4550 2046 756e 6374 696f 6e73 2e0a  -REP Functions..
│ │ │ │ -0000b240: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0000b220: 2020 2020 4150 2d52 4551 2061 6e64 2041      AP-REQ and A
│ │ │ │ +0000b230: 502d 5245 5020 4675 6e63 7469 6f6e 732e  P-REP Functions.
│ │ │ │ +0000b240: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │  0000b250: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000b260: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000b270: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ -0000b280: 6e65 2020 3535 3129 0a2a 2073 6869 7368  ne  551).* shish
│ │ │ │ -0000b290: 695f 6170 5f72 6570 5f64 6572 5f73 6574  i_ap_rep_der_set
│ │ │ │ -0000b2a0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ -0000b2b0: 2020 4150 2d52 4551 2061 6e64 2041 502d    AP-REQ and AP-
│ │ │ │ -0000b2c0: 5245 5020 4675 6e63 7469 6f6e 732e 0a20  REP Functions.. 
│ │ │ │ +0000b270: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ +0000b280: 696e 6520 2035 3531 290a 2a20 7368 6973  ine  551).* shis
│ │ │ │ +0000b290: 6869 5f61 705f 7265 705f 6465 725f 7365  hi_ap_rep_der_se
│ │ │ │ +0000b2a0: 743a 2020 2020 2020 2020 2020 2020 2020  t:              
│ │ │ │ +0000b2b0: 2020 2041 502d 5245 5120 616e 6420 4150     AP-REQ and AP
│ │ │ │ +0000b2c0: 2d52 4550 2046 756e 6374 696f 6e73 2e0a  -REP Functions..
│ │ │ │  0000b2d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000b2e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000b2f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000b300: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ -0000b310: 6520 2035 3636 290a 2a20 7368 6973 6869  e  566).* shishi
│ │ │ │ -0000b320: 5f61 705f 7265 705f 7365 743a 2020 2020  _ap_rep_set:    
│ │ │ │ +0000b300: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ +0000b310: 6e65 2020 3536 3629 0a2a 2073 6869 7368  ne  566).* shish
│ │ │ │ +0000b320: 695f 6170 5f72 6570 5f73 6574 3a20 2020  i_ap_rep_set:   
│ │ │ │  0000b330: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000b340: 2041 502d 5245 5120 616e 6420 4150 2d52   AP-REQ and AP-R
│ │ │ │ -0000b350: 4550 2046 756e 6374 696f 6e73 2e0a 2020  EP Functions..  
│ │ │ │ +0000b340: 2020 4150 2d52 4551 2061 6e64 2041 502d    AP-REQ and AP-
│ │ │ │ +0000b350: 5245 5020 4675 6e63 7469 6f6e 732e 0a20  REP Functions.. 
│ │ │ │  0000b360: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000b370: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000b380: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000b390: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ -0000b3a0: 2020 3534 3229 0a2a 2073 6869 7368 695f    542).* shishi_
│ │ │ │ -0000b3b0: 6170 5f72 6570 5f76 6572 6966 793a 2020  ap_rep_verify:  
│ │ │ │ +0000b390: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ +0000b3a0: 6520 2035 3432 290a 2a20 7368 6973 6869  e  542).* shishi
│ │ │ │ +0000b3b0: 5f61 705f 7265 705f 7665 7269 6679 3a20  _ap_rep_verify: 
│ │ │ │  0000b3c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000b3d0: 4150 2d52 4551 2061 6e64 2041 502d 5245  AP-REQ and AP-RE
│ │ │ │ -0000b3e0: 5020 4675 6e63 7469 6f6e 732e 0a20 2020  P Functions..   
│ │ │ │ +0000b3d0: 2041 502d 5245 5120 616e 6420 4150 2d52   AP-REQ and AP-R
│ │ │ │ +0000b3e0: 4550 2046 756e 6374 696f 6e73 2e0a 2020  EP Functions..  
│ │ │ │  0000b3f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000b400: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000b410: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000b420: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ -0000b430: 2036 3034 290a 2a20 7368 6973 6869 5f61   604).* shishi_a
│ │ │ │ -0000b440: 705f 7265 705f 7665 7269 6679 5f61 736e  p_rep_verify_asn
│ │ │ │ -0000b450: 313a 2020 2020 2020 2020 2020 2020 2041  1:             A
│ │ │ │ -0000b460: 502d 5245 5120 616e 6420 4150 2d52 4550  P-REQ and AP-REP
│ │ │ │ -0000b470: 2046 756e 6374 696f 6e73 2e0a 2020 2020   Functions..    
│ │ │ │ +0000b420: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ +0000b430: 2020 3630 3429 0a2a 2073 6869 7368 695f    604).* shishi_
│ │ │ │ +0000b440: 6170 5f72 6570 5f76 6572 6966 795f 6173  ap_rep_verify_as
│ │ │ │ +0000b450: 6e31 3a20 2020 2020 2020 2020 2020 2020  n1:             
│ │ │ │ +0000b460: 4150 2d52 4551 2061 6e64 2041 502d 5245  AP-REQ and AP-RE
│ │ │ │ +0000b470: 5020 4675 6e63 7469 6f6e 732e 0a20 2020  P Functions..   
│ │ │ │  0000b480: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000b490: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000b4a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000b4b0: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ -0000b4c0: 3633 3129 0a2a 2073 6869 7368 695f 6170  631).* shishi_ap
│ │ │ │ -0000b4d0: 5f72 6570 5f76 6572 6966 795f 6465 723a  _rep_verify_der:
│ │ │ │ -0000b4e0: 2020 2020 2020 2020 2020 2020 2020 4150                AP
│ │ │ │ -0000b4f0: 2d52 4551 2061 6e64 2041 502d 5245 5020  -REQ and AP-REP 
│ │ │ │ -0000b500: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │ +0000b4b0: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ +0000b4c0: 2036 3331 290a 2a20 7368 6973 6869 5f61   631).* shishi_a
│ │ │ │ +0000b4d0: 705f 7265 705f 7665 7269 6679 5f64 6572  p_rep_verify_der
│ │ │ │ +0000b4e0: 3a20 2020 2020 2020 2020 2020 2020 2041  :              A
│ │ │ │ +0000b4f0: 502d 5245 5120 616e 6420 4150 2d52 4550  P-REQ and AP-REP
│ │ │ │ +0000b500: 2046 756e 6374 696f 6e73 2e0a 2020 2020   Functions..    
│ │ │ │  0000b510: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000b520: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000b530: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000b540: 2020 2020 2020 2020 286c 696e 6520 2036          (line  6
│ │ │ │ -0000b550: 3135 290a 2a20 7368 6973 6869 5f61 705f  15).* shishi_ap_
│ │ │ │ -0000b560: 7265 713a 2020 2020 2020 2020 2020 2020  req:            
│ │ │ │ -0000b570: 2020 2020 2020 2020 2020 2020 2041 502d               AP-
│ │ │ │ -0000b580: 5245 5120 616e 6420 4150 2d52 4550 2046  REQ and AP-REP F
│ │ │ │ -0000b590: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │ +0000b540: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ +0000b550: 3631 3529 0a2a 2073 6869 7368 695f 6170  615).* shishi_ap
│ │ │ │ +0000b560: 5f72 6571 3a20 2020 2020 2020 2020 2020  _req:           
│ │ │ │ +0000b570: 2020 2020 2020 2020 2020 2020 2020 4150                AP
│ │ │ │ +0000b580: 2d52 4551 2061 6e64 2041 502d 5245 5020  -REQ and AP-REP 
│ │ │ │ +0000b590: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │  0000b5a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000b5b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000b5c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000b5d0: 2020 2020 2020 2028 6c69 6e65 2020 3430         (line  40
│ │ │ │ -0000b5e0: 3029 0a2a 2073 6869 7368 695f 6170 5f72  0).* shishi_ap_r
│ │ │ │ -0000b5f0: 6571 5f61 736e 313a 2020 2020 2020 2020  eq_asn1:        
│ │ │ │ -0000b600: 2020 2020 2020 2020 2020 2020 4150 2d52              AP-R
│ │ │ │ -0000b610: 4551 2061 6e64 2041 502d 5245 5020 4675  EQ and AP-REP Fu
│ │ │ │ -0000b620: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │ +0000b5d0: 2020 2020 2020 2020 286c 696e 6520 2034          (line  4
│ │ │ │ +0000b5e0: 3030 290a 2a20 7368 6973 6869 5f61 705f  00).* shishi_ap_
│ │ │ │ +0000b5f0: 7265 715f 6173 6e31 3a20 2020 2020 2020  req_asn1:       
│ │ │ │ +0000b600: 2020 2020 2020 2020 2020 2020 2041 502d               AP-
│ │ │ │ +0000b610: 5245 5120 616e 6420 4150 2d52 4550 2046  REQ and AP-REP F
│ │ │ │ +0000b620: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │  0000b630: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000b640: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000b650: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000b660: 2020 2020 2020 286c 696e 6520 2035 3036        (line  506
│ │ │ │ -0000b670: 290a 2a20 7368 6973 6869 5f61 705f 7265  ).* shishi_ap_re
│ │ │ │ -0000b680: 715f 6275 696c 643a 2020 2020 2020 2020  q_build:        
│ │ │ │ -0000b690: 2020 2020 2020 2020 2020 2041 502d 5245             AP-RE
│ │ │ │ -0000b6a0: 5120 616e 6420 4150 2d52 4550 2046 756e  Q and AP-REP Fun
│ │ │ │ -0000b6b0: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │ +0000b660: 2020 2020 2020 2028 6c69 6e65 2020 3530         (line  50
│ │ │ │ +0000b670: 3629 0a2a 2073 6869 7368 695f 6170 5f72  6).* shishi_ap_r
│ │ │ │ +0000b680: 6571 5f62 7569 6c64 3a20 2020 2020 2020  eq_build:       
│ │ │ │ +0000b690: 2020 2020 2020 2020 2020 2020 4150 2d52              AP-R
│ │ │ │ +0000b6a0: 4551 2061 6e64 2041 502d 5245 5020 4675  EQ and AP-REP Fu
│ │ │ │ +0000b6b0: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │  0000b6c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000b6d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000b6e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000b6f0: 2020 2020 2028 6c69 6e65 2020 3435 3029       (line  450)
│ │ │ │ -0000b700: 0a2a 2073 6869 7368 695f 6170 5f72 6571  .* shishi_ap_req
│ │ │ │ -0000b710: 5f64 6563 6f64 653a 2020 2020 2020 2020  _decode:        
│ │ │ │ -0000b720: 2020 2020 2020 2020 2020 4150 2d52 4551            AP-REQ
│ │ │ │ -0000b730: 2061 6e64 2041 502d 5245 5020 4675 6e63   and AP-REP Func
│ │ │ │ -0000b740: 7469 6f6e 732e 0a20 2020 2020 2020 2020  tions..         
│ │ │ │ +0000b6f0: 2020 2020 2020 286c 696e 6520 2034 3530        (line  450
│ │ │ │ +0000b700: 290a 2a20 7368 6973 6869 5f61 705f 7265  ).* shishi_ap_re
│ │ │ │ +0000b710: 715f 6465 636f 6465 3a20 2020 2020 2020  q_decode:       
│ │ │ │ +0000b720: 2020 2020 2020 2020 2020 2041 502d 5245             AP-RE
│ │ │ │ +0000b730: 5120 616e 6420 4150 2d52 4550 2046 756e  Q and AP-REP Fun
│ │ │ │ +0000b740: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │  0000b750: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000b760: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000b770: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000b780: 2020 2020 286c 696e 6520 2034 3631 290a      (line  461).
│ │ │ │ -0000b790: 2a20 7368 6973 6869 5f61 705f 7265 715f  * shishi_ap_req_
│ │ │ │ -0000b7a0: 6465 723a 2020 2020 2020 2020 2020 2020  der:            
│ │ │ │ -0000b7b0: 2020 2020 2020 2020 2041 502d 5245 5120           AP-REQ 
│ │ │ │ -0000b7c0: 616e 6420 4150 2d52 4550 2046 756e 6374  and AP-REP Funct
│ │ │ │ -0000b7d0: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │ +0000b780: 2020 2020 2028 6c69 6e65 2020 3436 3129       (line  461)
│ │ │ │ +0000b790: 0a2a 2073 6869 7368 695f 6170 5f72 6571  .* shishi_ap_req
│ │ │ │ +0000b7a0: 5f64 6572 3a20 2020 2020 2020 2020 2020  _der:           
│ │ │ │ +0000b7b0: 2020 2020 2020 2020 2020 4150 2d52 4551            AP-REQ
│ │ │ │ +0000b7c0: 2061 6e64 2041 502d 5245 5020 4675 6e63   and AP-REP Func
│ │ │ │ +0000b7d0: 7469 6f6e 732e 0a20 2020 2020 2020 2020  tions..         
│ │ │ │  0000b7e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000b7f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000b800: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000b810: 2020 2028 6c69 6e65 2020 3432 3029 0a2a     (line  420).*
│ │ │ │ -0000b820: 2073 6869 7368 695f 6170 5f72 6571 5f64   shishi_ap_req_d
│ │ │ │ -0000b830: 6572 5f73 6574 3a20 2020 2020 2020 2020  er_set:         
│ │ │ │ -0000b840: 2020 2020 2020 2020 4150 2d52 4551 2061          AP-REQ a
│ │ │ │ -0000b850: 6e64 2041 502d 5245 5020 4675 6e63 7469  nd AP-REP Functi
│ │ │ │ -0000b860: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │ +0000b810: 2020 2020 286c 696e 6520 2034 3230 290a      (line  420).
│ │ │ │ +0000b820: 2a20 7368 6973 6869 5f61 705f 7265 715f  * shishi_ap_req_
│ │ │ │ +0000b830: 6465 725f 7365 743a 2020 2020 2020 2020  der_set:        
│ │ │ │ +0000b840: 2020 2020 2020 2020 2041 502d 5245 5120           AP-REQ 
│ │ │ │ +0000b850: 616e 6420 4150 2d52 4550 2046 756e 6374  and AP-REP Funct
│ │ │ │ +0000b860: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │  0000b870: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000b880: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000b890: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000b8a0: 2020 286c 696e 6520 2034 3336 290a 2a20    (line  436).* 
│ │ │ │ -0000b8b0: 7368 6973 6869 5f61 705f 7265 715f 7072  shishi_ap_req_pr
│ │ │ │ -0000b8c0: 6f63 6573 733a 2020 2020 2020 2020 2020  ocess:          
│ │ │ │ -0000b8d0: 2020 2020 2020 2041 502d 5245 5120 616e         AP-REQ an
│ │ │ │ -0000b8e0: 6420 4150 2d52 4550 2046 756e 6374 696f  d AP-REP Functio
│ │ │ │ -0000b8f0: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │ +0000b8a0: 2020 2028 6c69 6e65 2020 3433 3629 0a2a     (line  436).*
│ │ │ │ +0000b8b0: 2073 6869 7368 695f 6170 5f72 6571 5f70   shishi_ap_req_p
│ │ │ │ +0000b8c0: 726f 6365 7373 3a20 2020 2020 2020 2020  rocess:         
│ │ │ │ +0000b8d0: 2020 2020 2020 2020 4150 2d52 4551 2061          AP-REQ a
│ │ │ │ +0000b8e0: 6e64 2041 502d 5245 5020 4675 6e63 7469  nd AP-REP Functi
│ │ │ │ +0000b8f0: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │  0000b900: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000b910: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000b920: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000b930: 2028 6c69 6e65 2020 3439 3129 0a2a 2073   (line  491).* s
│ │ │ │ -0000b940: 6869 7368 695f 6170 5f72 6571 5f70 726f  hishi_ap_req_pro
│ │ │ │ -0000b950: 6365 7373 5f6b 6579 7573 6167 653a 2020  cess_keyusage:  
│ │ │ │ -0000b960: 2020 2020 2020 4150 2d52 4551 2061 6e64        AP-REQ and
│ │ │ │ -0000b970: 2041 502d 5245 5020 4675 6e63 7469 6f6e   AP-REP Function
│ │ │ │ -0000b980: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │ +0000b930: 2020 286c 696e 6520 2034 3931 290a 2a20    (line  491).* 
│ │ │ │ +0000b940: 7368 6973 6869 5f61 705f 7265 715f 7072  shishi_ap_req_pr
│ │ │ │ +0000b950: 6f63 6573 735f 6b65 7975 7361 6765 3a20  ocess_keyusage: 
│ │ │ │ +0000b960: 2020 2020 2020 2041 502d 5245 5120 616e         AP-REQ an
│ │ │ │ +0000b970: 6420 4150 2d52 4550 2046 756e 6374 696f  d AP-REP Functio
│ │ │ │ +0000b980: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │  0000b990: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000b9a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000b9b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000b9c0: 286c 696e 6520 2034 3732 290a 2a20 7368  (line  472).* sh
│ │ │ │ -0000b9d0: 6973 6869 5f61 705f 7265 715f 7365 743a  ishi_ap_req_set:
│ │ │ │ -0000b9e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000b9f0: 2020 2020 2041 502d 5245 5120 616e 6420       AP-REQ and 
│ │ │ │ -0000ba00: 4150 2d52 4550 2046 756e 6374 696f 6e73  AP-REP Functions
│ │ │ │ -0000ba10: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │ +0000b9c0: 2028 6c69 6e65 2020 3437 3229 0a2a 2073   (line  472).* s
│ │ │ │ +0000b9d0: 6869 7368 695f 6170 5f72 6571 5f73 6574  hishi_ap_req_set
│ │ │ │ +0000b9e0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ +0000b9f0: 2020 2020 2020 4150 2d52 4551 2061 6e64        AP-REQ and
│ │ │ │ +0000ba00: 2041 502d 5245 5020 4675 6e63 7469 6f6e   AP-REP Function
│ │ │ │ +0000ba10: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │  0000ba20: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000ba30: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000ba40: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ -0000ba50: 6c69 6e65 2020 3431 3129 0a2a 2073 6869  line  411).* shi
│ │ │ │ -0000ba60: 7368 695f 6170 5f73 6574 5f74 6b74 6f70  shi_ap_set_tktop
│ │ │ │ -0000ba70: 7469 6f6e 733a 2020 2020 2020 2020 2020  tions:          
│ │ │ │ -0000ba80: 2020 2020 4150 2d52 4551 2061 6e64 2041      AP-REQ and A
│ │ │ │ -0000ba90: 502d 5245 5020 4675 6e63 7469 6f6e 732e  P-REP Functions.
│ │ │ │ -0000baa0: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ +0000ba40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0000ba50: 286c 696e 6520 2034 3131 290a 2a20 7368  (line  411).* sh
│ │ │ │ +0000ba60: 6973 6869 5f61 705f 7365 745f 746b 746f  ishi_ap_set_tkto
│ │ │ │ +0000ba70: 7074 696f 6e73 3a20 2020 2020 2020 2020  ptions:         
│ │ │ │ +0000ba80: 2020 2020 2041 502d 5245 5120 616e 6420       AP-REQ and 
│ │ │ │ +0000ba90: 4150 2d52 4550 2046 756e 6374 696f 6e73  AP-REP Functions
│ │ │ │ +0000baa0: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │  0000bab0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000bac0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000bad0: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ -0000bae0: 696e 6520 2020 3934 290a 2a20 7368 6973  ine   94).* shis
│ │ │ │ -0000baf0: 6869 5f61 705f 7365 745f 746b 746f 7074  hi_ap_set_tktopt
│ │ │ │ -0000bb00: 696f 6e73 6173 6e31 7573 6167 653a 2020  ionsasn1usage:  
│ │ │ │ -0000bb10: 2020 2041 502d 5245 5120 616e 6420 4150     AP-REQ and AP
│ │ │ │ -0000bb20: 2d52 4550 2046 756e 6374 696f 6e73 2e0a  -REP Functions..
│ │ │ │ -0000bb30: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0000bad0: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ +0000bae0: 6c69 6e65 2020 2039 3429 0a2a 2073 6869  line   94).* shi
│ │ │ │ +0000baf0: 7368 695f 6170 5f73 6574 5f74 6b74 6f70  shi_ap_set_tktop
│ │ │ │ +0000bb00: 7469 6f6e 7361 736e 3175 7361 6765 3a20  tionsasn1usage: 
│ │ │ │ +0000bb10: 2020 2020 4150 2d52 4551 2061 6e64 2041      AP-REQ and A
│ │ │ │ +0000bb20: 502d 5245 5020 4675 6e63 7469 6f6e 732e  P-REP Functions.
│ │ │ │ +0000bb30: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │  0000bb40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000bb50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000bb60: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ -0000bb70: 6e65 2020 3134 3629 0a2a 2073 6869 7368  ne  146).* shish
│ │ │ │ -0000bb80: 695f 6170 5f73 6574 5f74 6b74 6f70 7469  i_ap_set_tktopti
│ │ │ │ -0000bb90: 6f6e 7364 6174 613a 2020 2020 2020 2020  onsdata:        
│ │ │ │ -0000bba0: 2020 4150 2d52 4551 2061 6e64 2041 502d    AP-REQ and AP-
│ │ │ │ -0000bbb0: 5245 5020 4675 6e63 7469 6f6e 732e 0a20  REP Functions.. 
│ │ │ │ +0000bb60: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ +0000bb70: 696e 6520 2031 3436 290a 2a20 7368 6973  ine  146).* shis
│ │ │ │ +0000bb80: 6869 5f61 705f 7365 745f 746b 746f 7074  hi_ap_set_tktopt
│ │ │ │ +0000bb90: 696f 6e73 6461 7461 3a20 2020 2020 2020  ionsdata:       
│ │ │ │ +0000bba0: 2020 2041 502d 5245 5120 616e 6420 4150     AP-REQ and AP
│ │ │ │ +0000bbb0: 2d52 4550 2046 756e 6374 696f 6e73 2e0a  -REP Functions..
│ │ │ │  0000bbc0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000bbd0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000bbe0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000bbf0: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ -0000bc00: 6520 2031 3038 290a 2a20 7368 6973 6869  e  108).* shishi
│ │ │ │ -0000bc10: 5f61 705f 7365 745f 746b 746f 7074 696f  _ap_set_tktoptio
│ │ │ │ -0000bc20: 6e73 7261 773a 2020 2020 2020 2020 2020  nsraw:          
│ │ │ │ -0000bc30: 2041 502d 5245 5120 616e 6420 4150 2d52   AP-REQ and AP-R
│ │ │ │ -0000bc40: 4550 2046 756e 6374 696f 6e73 2e0a 2020  EP Functions..  
│ │ │ │ +0000bbf0: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ +0000bc00: 6e65 2020 3130 3829 0a2a 2073 6869 7368  ne  108).* shish
│ │ │ │ +0000bc10: 695f 6170 5f73 6574 5f74 6b74 6f70 7469  i_ap_set_tktopti
│ │ │ │ +0000bc20: 6f6e 7372 6177 3a20 2020 2020 2020 2020  onsraw:         
│ │ │ │ +0000bc30: 2020 4150 2d52 4551 2061 6e64 2041 502d    AP-REQ and AP-
│ │ │ │ +0000bc40: 5245 5020 4675 6e63 7469 6f6e 732e 0a20  REP Functions.. 
│ │ │ │  0000bc50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000bc60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000bc70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000bc80: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ -0000bc90: 2020 3132 3529 0a2a 2073 6869 7368 695f    125).* shishi_
│ │ │ │ -0000bca0: 6170 5f73 7472 696e 6732 6f70 7469 6f6e  ap_string2option
│ │ │ │ -0000bcb0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ -0000bcc0: 4150 2d52 4551 2061 6e64 2041 502d 5245  AP-REQ and AP-RE
│ │ │ │ -0000bcd0: 5020 4675 6e63 7469 6f6e 732e 0a20 2020  P Functions..   
│ │ │ │ +0000bc80: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ +0000bc90: 6520 2031 3235 290a 2a20 7368 6973 6869  e  125).* shishi
│ │ │ │ +0000bca0: 5f61 705f 7374 7269 6e67 326f 7074 696f  _ap_string2optio
│ │ │ │ +0000bcb0: 6e3a 2020 2020 2020 2020 2020 2020 2020  n:              
│ │ │ │ +0000bcc0: 2041 502d 5245 5120 616e 6420 4150 2d52   AP-REQ and AP-R
│ │ │ │ +0000bcd0: 4550 2046 756e 6374 696f 6e73 2e0a 2020  EP Functions..  
│ │ │ │  0000bce0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000bcf0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000bd00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000bd10: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ -0000bd20: 2036 3831 290a 2a20 7368 6973 6869 5f61   681).* shishi_a
│ │ │ │ -0000bd30: 705f 746b 743a 2020 2020 2020 2020 2020  p_tkt:          
│ │ │ │ -0000bd40: 2020 2020 2020 2020 2020 2020 2020 2041                 A
│ │ │ │ -0000bd50: 502d 5245 5120 616e 6420 4150 2d52 4550  P-REQ and AP-REP
│ │ │ │ -0000bd60: 2046 756e 6374 696f 6e73 2e0a 2020 2020   Functions..    
│ │ │ │ +0000bd10: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ +0000bd20: 2020 3638 3129 0a2a 2073 6869 7368 695f    681).* shishi_
│ │ │ │ +0000bd30: 6170 5f74 6b74 3a20 2020 2020 2020 2020  ap_tkt:         
│ │ │ │ +0000bd40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0000bd50: 4150 2d52 4551 2061 6e64 2041 502d 5245  AP-REQ and AP-RE
│ │ │ │ +0000bd60: 5020 4675 6e63 7469 6f6e 732e 0a20 2020  P Functions..   
│ │ │ │  0000bd70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000bd80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000bd90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000bda0: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ -0000bdb0: 3238 3429 0a2a 2073 6869 7368 695f 6170  284).* shishi_ap
│ │ │ │ -0000bdc0: 5f74 6b74 5f73 6574 3a20 2020 2020 2020  _tkt_set:       
│ │ │ │ -0000bdd0: 2020 2020 2020 2020 2020 2020 2020 4150                AP
│ │ │ │ -0000bde0: 2d52 4551 2061 6e64 2041 502d 5245 5020  -REQ and AP-REP 
│ │ │ │ -0000bdf0: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │ +0000bda0: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ +0000bdb0: 2032 3834 290a 2a20 7368 6973 6869 5f61   284).* shishi_a
│ │ │ │ +0000bdc0: 705f 746b 745f 7365 743a 2020 2020 2020  p_tkt_set:      
│ │ │ │ +0000bdd0: 2020 2020 2020 2020 2020 2020 2020 2041                 A
│ │ │ │ +0000bde0: 502d 5245 5120 616e 6420 4150 2d52 4550  P-REQ and AP-REP
│ │ │ │ +0000bdf0: 2046 756e 6374 696f 6e73 2e0a 2020 2020   Functions..    
│ │ │ │  0000be00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000be10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000be20: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000be30: 2020 2020 2020 2020 286c 696e 6520 2032          (line  2
│ │ │ │ -0000be40: 3935 290a 2a20 7368 6973 6869 5f61 705f  95).* shishi_ap_
│ │ │ │ -0000be50: 746b 746f 7074 696f 6e73 3a20 2020 2020  tktoptions:     
│ │ │ │ -0000be60: 2020 2020 2020 2020 2020 2020 2041 502d               AP-
│ │ │ │ -0000be70: 5245 5120 616e 6420 4150 2d52 4550 2046  REQ and AP-REP F
│ │ │ │ -0000be80: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │ +0000be30: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ +0000be40: 3239 3529 0a2a 2073 6869 7368 695f 6170  295).* shishi_ap
│ │ │ │ +0000be50: 5f74 6b74 6f70 7469 6f6e 733a 2020 2020  _tktoptions:    
│ │ │ │ +0000be60: 2020 2020 2020 2020 2020 2020 2020 4150                AP
│ │ │ │ +0000be70: 2d52 4551 2061 6e64 2041 502d 5245 5020  -REQ and AP-REP 
│ │ │ │ +0000be80: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │  0000be90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000bea0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000beb0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000bec0: 2020 2020 2020 2028 6c69 6e65 2020 3136         (line  16
│ │ │ │ -0000bed0: 3929 0a2a 2073 6869 7368 695f 6170 5f74  9).* shishi_ap_t
│ │ │ │ -0000bee0: 6b74 6f70 7469 6f6e 7361 736e 3175 7361  ktoptionsasn1usa
│ │ │ │ -0000bef0: 6765 3a20 2020 2020 2020 2020 4150 2d52  ge:         AP-R
│ │ │ │ -0000bf00: 4551 2061 6e64 2041 502d 5245 5020 4675  EQ and AP-REP Fu
│ │ │ │ -0000bf10: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │ +0000bec0: 2020 2020 2020 2020 286c 696e 6520 2031          (line  1
│ │ │ │ +0000bed0: 3639 290a 2a20 7368 6973 6869 5f61 705f  69).* shishi_ap_
│ │ │ │ +0000bee0: 746b 746f 7074 696f 6e73 6173 6e31 7573  tktoptionsasn1us
│ │ │ │ +0000bef0: 6167 653a 2020 2020 2020 2020 2041 502d  age:         AP-
│ │ │ │ +0000bf00: 5245 5120 616e 6420 4150 2d52 4550 2046  REQ and AP-REP F
│ │ │ │ +0000bf10: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │  0000bf20: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000bf30: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000bf40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000bf50: 2020 2020 2020 286c 696e 6520 2032 3537        (line  257
│ │ │ │ -0000bf60: 290a 2a20 7368 6973 6869 5f61 705f 746b  ).* shishi_ap_tk
│ │ │ │ -0000bf70: 746f 7074 696f 6e73 6461 7461 3a20 2020  toptionsdata:   
│ │ │ │ -0000bf80: 2020 2020 2020 2020 2020 2041 502d 5245             AP-RE
│ │ │ │ -0000bf90: 5120 616e 6420 4150 2d52 4550 2046 756e  Q and AP-REP Fun
│ │ │ │ -0000bfa0: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │ +0000bf50: 2020 2020 2020 2028 6c69 6e65 2020 3235         (line  25
│ │ │ │ +0000bf60: 3729 0a2a 2073 6869 7368 695f 6170 5f74  7).* shishi_ap_t
│ │ │ │ +0000bf70: 6b74 6f70 7469 6f6e 7364 6174 613a 2020  ktoptionsdata:  
│ │ │ │ +0000bf80: 2020 2020 2020 2020 2020 2020 4150 2d52              AP-R
│ │ │ │ +0000bf90: 4551 2061 6e64 2041 502d 5245 5020 4675  EQ and AP-REP Fu
│ │ │ │ +0000bfa0: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │  0000bfb0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000bfc0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000bfd0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000bfe0: 2020 2020 2028 6c69 6e65 2020 3138 3729       (line  187)
│ │ │ │ -0000bff0: 0a2a 2073 6869 7368 695f 6170 5f74 6b74  .* shishi_ap_tkt
│ │ │ │ -0000c000: 6f70 7469 6f6e 7372 6177 3a20 2020 2020  optionsraw:     
│ │ │ │ -0000c010: 2020 2020 2020 2020 2020 4150 2d52 4551            AP-REQ
│ │ │ │ -0000c020: 2061 6e64 2041 502d 5245 5020 4675 6e63   and AP-REP Func
│ │ │ │ -0000c030: 7469 6f6e 732e 0a20 2020 2020 2020 2020  tions..         
│ │ │ │ +0000bfe0: 2020 2020 2020 286c 696e 6520 2031 3837        (line  187
│ │ │ │ +0000bff0: 290a 2a20 7368 6973 6869 5f61 705f 746b  ).* shishi_ap_tk
│ │ │ │ +0000c000: 746f 7074 696f 6e73 7261 773a 2020 2020  toptionsraw:    
│ │ │ │ +0000c010: 2020 2020 2020 2020 2020 2041 502d 5245             AP-RE
│ │ │ │ +0000c020: 5120 616e 6420 4150 2d52 4550 2046 756e  Q and AP-REP Fun
│ │ │ │ +0000c030: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │  0000c040: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000c050: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000c060: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000c070: 2020 2020 286c 696e 6520 2032 3039 290a      (line  209).
│ │ │ │ -0000c080: 2a20 7368 6973 6869 5f61 7072 6570 3a20  * shishi_aprep: 
│ │ │ │ +0000c070: 2020 2020 2028 6c69 6e65 2020 3230 3929       (line  209)
│ │ │ │ +0000c080: 0a2a 2073 6869 7368 695f 6170 7265 703a  .* shishi_aprep:
│ │ │ │  0000c090: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000c0a0: 2020 2020 2020 2020 2041 502d 5245 5120           AP-REQ 
│ │ │ │ -0000c0b0: 616e 6420 4150 2d52 4550 2046 756e 6374  and AP-REP Funct
│ │ │ │ -0000c0c0: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │ +0000c0a0: 2020 2020 2020 2020 2020 4150 2d52 4551            AP-REQ
│ │ │ │ +0000c0b0: 2061 6e64 2041 502d 5245 5020 4675 6e63   and AP-REP Func
│ │ │ │ +0000c0c0: 7469 6f6e 732e 0a20 2020 2020 2020 2020  tions..         
│ │ │ │  0000c0d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000c0e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000c0f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000c100: 2020 2028 6c69 6e65 2020 3934 3929 0a2a     (line  949).*
│ │ │ │ -0000c110: 2073 6869 7368 695f 6170 7265 705f 6672   shishi_aprep_fr
│ │ │ │ -0000c120: 6f6d 5f66 696c 653a 2020 2020 2020 2020  om_file:        
│ │ │ │ -0000c130: 2020 2020 2020 2020 4150 2d52 4551 2061          AP-REQ a
│ │ │ │ -0000c140: 6e64 2041 502d 5245 5020 4675 6e63 7469  nd AP-REP Functi
│ │ │ │ -0000c150: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │ +0000c100: 2020 2020 286c 696e 6520 2039 3439 290a      (line  949).
│ │ │ │ +0000c110: 2a20 7368 6973 6869 5f61 7072 6570 5f66  * shishi_aprep_f
│ │ │ │ +0000c120: 726f 6d5f 6669 6c65 3a20 2020 2020 2020  rom_file:       
│ │ │ │ +0000c130: 2020 2020 2020 2020 2041 502d 5245 5120           AP-REQ 
│ │ │ │ +0000c140: 616e 6420 4150 2d52 4550 2046 756e 6374  and AP-REP Funct
│ │ │ │ +0000c150: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │  0000c160: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000c170: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000c180: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000c190: 2020 286c 696e 6520 3130 3330 290a 2a20    (line 1030).* 
│ │ │ │ -0000c1a0: 7368 6973 6869 5f61 7072 6570 5f67 6574  shishi_aprep_get
│ │ │ │ -0000c1b0: 5f65 6e63 5f70 6172 745f 6574 7970 653a  _enc_part_etype:
│ │ │ │ -0000c1c0: 2020 2020 2020 2041 502d 5245 5120 616e         AP-REQ an
│ │ │ │ -0000c1d0: 6420 4150 2d52 4550 2046 756e 6374 696f  d AP-REP Functio
│ │ │ │ -0000c1e0: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │ +0000c190: 2020 2028 6c69 6e65 2031 3033 3029 0a2a     (line 1030).*
│ │ │ │ +0000c1a0: 2073 6869 7368 695f 6170 7265 705f 6765   shishi_aprep_ge
│ │ │ │ +0000c1b0: 745f 656e 635f 7061 7274 5f65 7479 7065  t_enc_part_etype
│ │ │ │ +0000c1c0: 3a20 2020 2020 2020 4150 2d52 4551 2061  :       AP-REQ a
│ │ │ │ +0000c1d0: 6e64 2041 502d 5245 5020 4675 6e63 7469  nd AP-REP Functi
│ │ │ │ +0000c1e0: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │  0000c1f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000c200: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000c210: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000c220: 2028 6c69 6e65 2031 3034 3529 0a2a 2073   (line 1045).* s
│ │ │ │ -0000c230: 6869 7368 695f 6170 7265 705f 7061 7273  hishi_aprep_pars
│ │ │ │ -0000c240: 653a 2020 2020 2020 2020 2020 2020 2020  e:              
│ │ │ │ -0000c250: 2020 2020 2020 4150 2d52 4551 2061 6e64        AP-REQ and
│ │ │ │ -0000c260: 2041 502d 5245 5020 4675 6e63 7469 6f6e   AP-REP Function
│ │ │ │ -0000c270: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │ +0000c220: 2020 286c 696e 6520 3130 3435 290a 2a20    (line 1045).* 
│ │ │ │ +0000c230: 7368 6973 6869 5f61 7072 6570 5f70 6172  shishi_aprep_par
│ │ │ │ +0000c240: 7365 3a20 2020 2020 2020 2020 2020 2020  se:             
│ │ │ │ +0000c250: 2020 2020 2020 2041 502d 5245 5120 616e         AP-REQ an
│ │ │ │ +0000c260: 6420 4150 2d52 4550 2046 756e 6374 696f  d AP-REP Functio
│ │ │ │ +0000c270: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │  0000c280: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000c290: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000c2a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000c2b0: 286c 696e 6520 3130 3032 290a 2a20 7368  (line 1002).* sh
│ │ │ │ -0000c2c0: 6973 6869 5f61 7072 6570 5f70 7269 6e74  ishi_aprep_print
│ │ │ │ -0000c2d0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ -0000c2e0: 2020 2020 2041 502d 5245 5120 616e 6420       AP-REQ and 
│ │ │ │ -0000c2f0: 4150 2d52 4550 2046 756e 6374 696f 6e73  AP-REP Functions
│ │ │ │ -0000c300: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │ +0000c2b0: 2028 6c69 6e65 2031 3030 3229 0a2a 2073   (line 1002).* s
│ │ │ │ +0000c2c0: 6869 7368 695f 6170 7265 705f 7072 696e  hishi_aprep_prin
│ │ │ │ +0000c2d0: 743a 2020 2020 2020 2020 2020 2020 2020  t:              
│ │ │ │ +0000c2e0: 2020 2020 2020 4150 2d52 4551 2061 6e64        AP-REQ and
│ │ │ │ +0000c2f0: 2041 502d 5245 5020 4675 6e63 7469 6f6e   AP-REP Function
│ │ │ │ +0000c300: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │  0000c310: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000c320: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000c330: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ -0000c340: 6c69 6e65 2020 3936 3029 0a2a 2073 6869  line  960).* shi
│ │ │ │ -0000c350: 7368 695f 6170 7265 705f 7265 6164 3a20  shi_aprep_read: 
│ │ │ │ +0000c330: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0000c340: 286c 696e 6520 2039 3630 290a 2a20 7368  (line  960).* sh
│ │ │ │ +0000c350: 6973 6869 5f61 7072 6570 5f72 6561 643a  ishi_aprep_read:
│ │ │ │  0000c360: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000c370: 2020 2020 4150 2d52 4551 2061 6e64 2041      AP-REQ and A
│ │ │ │ -0000c380: 502d 5245 5020 4675 6e63 7469 6f6e 732e  P-REP Functions.
│ │ │ │ -0000c390: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ +0000c370: 2020 2020 2041 502d 5245 5120 616e 6420       AP-REQ and 
│ │ │ │ +0000c380: 4150 2d52 4550 2046 756e 6374 696f 6e73  AP-REP Functions
│ │ │ │ +0000c390: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │  0000c3a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000c3b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000c3c0: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ -0000c3d0: 696e 6520 3130 3136 290a 2a20 7368 6973  ine 1016).* shis
│ │ │ │ -0000c3e0: 6869 5f61 7072 6570 5f73 6176 653a 2020  hi_aprep_save:  
│ │ │ │ +0000c3c0: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ +0000c3d0: 6c69 6e65 2031 3031 3629 0a2a 2073 6869  line 1016).* shi
│ │ │ │ +0000c3e0: 7368 695f 6170 7265 705f 7361 7665 3a20  shi_aprep_save: 
│ │ │ │  0000c3f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000c400: 2020 2041 502d 5245 5120 616e 6420 4150     AP-REQ and AP
│ │ │ │ -0000c410: 2d52 4550 2046 756e 6374 696f 6e73 2e0a  -REP Functions..
│ │ │ │ -0000c420: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0000c400: 2020 2020 4150 2d52 4551 2061 6e64 2041      AP-REQ and A
│ │ │ │ +0000c410: 502d 5245 5020 4675 6e63 7469 6f6e 732e  P-REP Functions.
│ │ │ │ +0000c420: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │  0000c430: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000c440: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000c450: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ -0000c460: 6e65 2020 3937 3329 0a2a 2073 6869 7368  ne  973).* shish
│ │ │ │ -0000c470: 695f 6170 7265 705f 746f 5f66 696c 653a  i_aprep_to_file:
│ │ │ │ -0000c480: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000c490: 2020 4150 2d52 4551 2061 6e64 2041 502d    AP-REQ and AP-
│ │ │ │ -0000c4a0: 5245 5020 4675 6e63 7469 6f6e 732e 0a20  REP Functions.. 
│ │ │ │ +0000c450: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ +0000c460: 696e 6520 2039 3733 290a 2a20 7368 6973  ine  973).* shis
│ │ │ │ +0000c470: 6869 5f61 7072 6570 5f74 6f5f 6669 6c65  hi_aprep_to_file
│ │ │ │ +0000c480: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ +0000c490: 2020 2041 502d 5245 5120 616e 6420 4150     AP-REQ and AP
│ │ │ │ +0000c4a0: 2d52 4550 2046 756e 6374 696f 6e73 2e0a  -REP Functions..
│ │ │ │  0000c4b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000c4c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000c4d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000c4e0: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ -0000c4f0: 6520 2039 3836 290a 2a20 7368 6973 6869  e  986).* shishi
│ │ │ │ -0000c500: 5f61 7072 6571 3a20 2020 2020 2020 2020  _apreq:         
│ │ │ │ +0000c4e0: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ +0000c4f0: 6e65 2020 3938 3629 0a2a 2073 6869 7368  ne  986).* shish
│ │ │ │ +0000c500: 695f 6170 7265 713a 2020 2020 2020 2020  i_apreq:        
│ │ │ │  0000c510: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000c520: 2041 502d 5245 5120 616e 6420 4150 2d52   AP-REQ and AP-R
│ │ │ │ -0000c530: 4550 2046 756e 6374 696f 6e73 2e0a 2020  EP Functions..  
│ │ │ │ +0000c520: 2020 4150 2d52 4551 2061 6e64 2041 502d    AP-REQ and AP-
│ │ │ │ +0000c530: 5245 5020 4675 6e63 7469 6f6e 732e 0a20  REP Functions.. 
│ │ │ │  0000c540: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000c550: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000c560: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000c570: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ -0000c580: 2020 3639 3429 0a2a 2073 6869 7368 695f    694).* shishi_
│ │ │ │ -0000c590: 6170 7265 715f 6164 645f 6175 7468 656e  apreq_add_authen
│ │ │ │ -0000c5a0: 7469 6361 746f 723a 2020 2020 2020 2020  ticator:        
│ │ │ │ -0000c5b0: 4150 2d52 4551 2061 6e64 2041 502d 5245  AP-REQ and AP-RE
│ │ │ │ -0000c5c0: 5020 4675 6e63 7469 6f6e 732e 0a20 2020  P Functions..   
│ │ │ │ +0000c570: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ +0000c580: 6520 2036 3934 290a 2a20 7368 6973 6869  e  694).* shishi
│ │ │ │ +0000c590: 5f61 7072 6571 5f61 6464 5f61 7574 6865  _apreq_add_authe
│ │ │ │ +0000c5a0: 6e74 6963 6174 6f72 3a20 2020 2020 2020  nticator:       
│ │ │ │ +0000c5b0: 2041 502d 5245 5120 616e 6420 4150 2d52   AP-REQ and AP-R
│ │ │ │ +0000c5c0: 4550 2046 756e 6374 696f 6e73 2e0a 2020  EP Functions..  
│ │ │ │  0000c5d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000c5e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000c5f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000c600: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ -0000c610: 2038 3131 290a 2a20 7368 6973 6869 5f61   811).* shishi_a
│ │ │ │ -0000c620: 7072 6571 5f66 726f 6d5f 6669 6c65 3a20  preq_from_file: 
│ │ │ │ -0000c630: 2020 2020 2020 2020 2020 2020 2020 2041                 A
│ │ │ │ -0000c640: 502d 5245 5120 616e 6420 4150 2d52 4550  P-REQ and AP-REP
│ │ │ │ -0000c650: 2046 756e 6374 696f 6e73 2e0a 2020 2020   Functions..    
│ │ │ │ +0000c600: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ +0000c610: 2020 3831 3129 0a2a 2073 6869 7368 695f    811).* shishi_
│ │ │ │ +0000c620: 6170 7265 715f 6672 6f6d 5f66 696c 653a  apreq_from_file:
│ │ │ │ +0000c630: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0000c640: 4150 2d52 4551 2061 6e64 2041 502d 5245  AP-REQ and AP-RE
│ │ │ │ +0000c650: 5020 4675 6e63 7469 6f6e 732e 0a20 2020  P Functions..   
│ │ │ │  0000c660: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000c670: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000c680: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000c690: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ -0000c6a0: 3737 3529 0a2a 2073 6869 7368 695f 6170  775).* shishi_ap
│ │ │ │ -0000c6b0: 7265 715f 6765 745f 6175 7468 656e 7469  req_get_authenti
│ │ │ │ -0000c6c0: 6361 746f 725f 6574 7970 653a 2020 4150  cator_etype:  AP
│ │ │ │ -0000c6d0: 2d52 4551 2061 6e64 2041 502d 5245 5020  -REQ and AP-REP 
│ │ │ │ -0000c6e0: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │ +0000c690: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ +0000c6a0: 2037 3735 290a 2a20 7368 6973 6869 5f61   775).* shishi_a
│ │ │ │ +0000c6b0: 7072 6571 5f67 6574 5f61 7574 6865 6e74  preq_get_authent
│ │ │ │ +0000c6c0: 6963 6174 6f72 5f65 7479 7065 3a20 2041  icator_etype:  A
│ │ │ │ +0000c6d0: 502d 5245 5120 616e 6420 4150 2d52 4550  P-REQ and AP-REP
│ │ │ │ +0000c6e0: 2046 756e 6374 696f 6e73 2e0a 2020 2020   Functions..    
│ │ │ │  0000c6f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000c700: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000c710: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000c720: 2020 2020 2020 2020 286c 696e 6520 2039          (line  9
│ │ │ │ -0000c730: 3233 290a 2a20 7368 6973 6869 5f61 7072  23).* shishi_apr
│ │ │ │ -0000c740: 6571 5f67 6574 5f74 6963 6b65 743a 2020  eq_get_ticket:  
│ │ │ │ -0000c750: 2020 2020 2020 2020 2020 2020 2041 502d               AP-
│ │ │ │ -0000c760: 5245 5120 616e 6420 4150 2d52 4550 2046  REQ and AP-REP F
│ │ │ │ -0000c770: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │ +0000c720: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ +0000c730: 3932 3329 0a2a 2073 6869 7368 695f 6170  923).* shishi_ap
│ │ │ │ +0000c740: 7265 715f 6765 745f 7469 636b 6574 3a20  req_get_ticket: 
│ │ │ │ +0000c750: 2020 2020 2020 2020 2020 2020 2020 4150                AP
│ │ │ │ +0000c760: 2d52 4551 2061 6e64 2041 502d 5245 5020  -REQ and AP-REP 
│ │ │ │ +0000c770: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │  0000c780: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000c790: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000c7a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000c7b0: 2020 2020 2020 2028 6c69 6e65 2020 3933         (line  93
│ │ │ │ -0000c7c0: 3629 0a2a 2073 6869 7368 695f 6170 7265  6).* shishi_apre
│ │ │ │ -0000c7d0: 715f 6d75 7475 616c 5f72 6571 7569 7265  q_mutual_require
│ │ │ │ -0000c7e0: 645f 703a 2020 2020 2020 2020 4150 2d52  d_p:        AP-R
│ │ │ │ -0000c7f0: 4551 2061 6e64 2041 502d 5245 5020 4675  EQ and AP-REP Fu
│ │ │ │ -0000c800: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │ +0000c7b0: 2020 2020 2020 2020 286c 696e 6520 2039          (line  9
│ │ │ │ +0000c7c0: 3336 290a 2a20 7368 6973 6869 5f61 7072  36).* shishi_apr
│ │ │ │ +0000c7d0: 6571 5f6d 7574 7561 6c5f 7265 7175 6972  eq_mutual_requir
│ │ │ │ +0000c7e0: 6564 5f70 3a20 2020 2020 2020 2041 502d  ed_p:        AP-
│ │ │ │ +0000c7f0: 5245 5120 616e 6420 4150 2d52 4550 2046  REQ and AP-REP F
│ │ │ │ +0000c800: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │  0000c810: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000c820: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000c830: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000c840: 2020 2020 2020 286c 696e 6520 2038 3639        (line  869
│ │ │ │ -0000c850: 290a 2a20 7368 6973 6869 5f61 7072 6571  ).* shishi_apreq
│ │ │ │ -0000c860: 5f6f 7074 696f 6e73 3a20 2020 2020 2020  _options:       
│ │ │ │ -0000c870: 2020 2020 2020 2020 2020 2041 502d 5245             AP-RE
│ │ │ │ -0000c880: 5120 616e 6420 4150 2d52 4550 2046 756e  Q and AP-REP Fun
│ │ │ │ -0000c890: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │ +0000c840: 2020 2020 2020 2028 6c69 6e65 2020 3836         (line  86
│ │ │ │ +0000c850: 3929 0a2a 2073 6869 7368 695f 6170 7265  9).* shishi_apre
│ │ │ │ +0000c860: 715f 6f70 7469 6f6e 733a 2020 2020 2020  q_options:      
│ │ │ │ +0000c870: 2020 2020 2020 2020 2020 2020 4150 2d52              AP-R
│ │ │ │ +0000c880: 4551 2061 6e64 2041 502d 5245 5020 4675  EQ and AP-REP Fu
│ │ │ │ +0000c890: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │  0000c8a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000c8b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000c8c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000c8d0: 2020 2020 2028 6c69 6e65 2020 3834 3229       (line  842)
│ │ │ │ -0000c8e0: 0a2a 2073 6869 7368 695f 6170 7265 715f  .* shishi_apreq_
│ │ │ │ -0000c8f0: 6f70 7469 6f6e 735f 6164 643a 2020 2020  options_add:    
│ │ │ │ -0000c900: 2020 2020 2020 2020 2020 4150 2d52 4551            AP-REQ
│ │ │ │ -0000c910: 2061 6e64 2041 502d 5245 5020 4675 6e63   and AP-REP Func
│ │ │ │ -0000c920: 7469 6f6e 732e 0a20 2020 2020 2020 2020  tions..         
│ │ │ │ +0000c8d0: 2020 2020 2020 286c 696e 6520 2038 3432        (line  842
│ │ │ │ +0000c8e0: 290a 2a20 7368 6973 6869 5f61 7072 6571  ).* shishi_apreq
│ │ │ │ +0000c8f0: 5f6f 7074 696f 6e73 5f61 6464 3a20 2020  _options_add:   
│ │ │ │ +0000c900: 2020 2020 2020 2020 2020 2041 502d 5245             AP-RE
│ │ │ │ +0000c910: 5120 616e 6420 4150 2d52 4550 2046 756e  Q and AP-REP Fun
│ │ │ │ +0000c920: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │  0000c930: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000c940: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000c950: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000c960: 2020 2020 286c 696e 6520 2038 3935 290a      (line  895).
│ │ │ │ -0000c970: 2a20 7368 6973 6869 5f61 7072 6571 5f6f  * shishi_apreq_o
│ │ │ │ -0000c980: 7074 696f 6e73 5f72 656d 6f76 653a 2020  ptions_remove:  
│ │ │ │ -0000c990: 2020 2020 2020 2020 2041 502d 5245 5120           AP-REQ 
│ │ │ │ -0000c9a0: 616e 6420 4150 2d52 4550 2046 756e 6374  and AP-REP Funct
│ │ │ │ -0000c9b0: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │ +0000c960: 2020 2020 2028 6c69 6e65 2020 3839 3529       (line  895)
│ │ │ │ +0000c970: 0a2a 2073 6869 7368 695f 6170 7265 715f  .* shishi_apreq_
│ │ │ │ +0000c980: 6f70 7469 6f6e 735f 7265 6d6f 7665 3a20  options_remove: 
│ │ │ │ +0000c990: 2020 2020 2020 2020 2020 4150 2d52 4551            AP-REQ
│ │ │ │ +0000c9a0: 2061 6e64 2041 502d 5245 5020 4675 6e63   and AP-REP Func
│ │ │ │ +0000c9b0: 7469 6f6e 732e 0a20 2020 2020 2020 2020  tions..         
│ │ │ │  0000c9c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000c9d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000c9e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000c9f0: 2020 2028 6c69 6e65 2020 3930 3929 0a2a     (line  909).*
│ │ │ │ -0000ca00: 2073 6869 7368 695f 6170 7265 715f 6f70   shishi_apreq_op
│ │ │ │ -0000ca10: 7469 6f6e 735f 7365 743a 2020 2020 2020  tions_set:      
│ │ │ │ -0000ca20: 2020 2020 2020 2020 4150 2d52 4551 2061          AP-REQ a
│ │ │ │ -0000ca30: 6e64 2041 502d 5245 5020 4675 6e63 7469  nd AP-REP Functi
│ │ │ │ -0000ca40: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │ +0000c9f0: 2020 2020 286c 696e 6520 2039 3039 290a      (line  909).
│ │ │ │ +0000ca00: 2a20 7368 6973 6869 5f61 7072 6571 5f6f  * shishi_apreq_o
│ │ │ │ +0000ca10: 7074 696f 6e73 5f73 6574 3a20 2020 2020  ptions_set:     
│ │ │ │ +0000ca20: 2020 2020 2020 2020 2041 502d 5245 5120           AP-REQ 
│ │ │ │ +0000ca30: 616e 6420 4150 2d52 4550 2046 756e 6374  and AP-REP Funct
│ │ │ │ +0000ca40: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │  0000ca50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000ca60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000ca70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000ca80: 2020 286c 696e 6520 2038 3832 290a 2a20    (line  882).* 
│ │ │ │ -0000ca90: 7368 6973 6869 5f61 7072 6571 5f70 6172  shishi_apreq_par
│ │ │ │ -0000caa0: 7365 3a20 2020 2020 2020 2020 2020 2020  se:             
│ │ │ │ -0000cab0: 2020 2020 2020 2041 502d 5245 5120 616e         AP-REQ an
│ │ │ │ -0000cac0: 6420 4150 2d52 4550 2046 756e 6374 696f  d AP-REP Functio
│ │ │ │ -0000cad0: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │ +0000ca80: 2020 2028 6c69 6e65 2020 3838 3229 0a2a     (line  882).*
│ │ │ │ +0000ca90: 2073 6869 7368 695f 6170 7265 715f 7061   shishi_apreq_pa
│ │ │ │ +0000caa0: 7273 653a 2020 2020 2020 2020 2020 2020  rse:            
│ │ │ │ +0000cab0: 2020 2020 2020 2020 4150 2d52 4551 2061          AP-REQ a
│ │ │ │ +0000cac0: 6e64 2041 502d 5245 5020 4675 6e63 7469  nd AP-REP Functi
│ │ │ │ +0000cad0: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │  0000cae0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000caf0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000cb00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000cb10: 2028 6c69 6e65 2020 3734 3729 0a2a 2073   (line  747).* s
│ │ │ │ -0000cb20: 6869 7368 695f 6170 7265 715f 7072 696e  hishi_apreq_prin
│ │ │ │ -0000cb30: 743a 2020 2020 2020 2020 2020 2020 2020  t:              
│ │ │ │ -0000cb40: 2020 2020 2020 4150 2d52 4551 2061 6e64        AP-REQ and
│ │ │ │ -0000cb50: 2041 502d 5245 5020 4675 6e63 7469 6f6e   AP-REP Function
│ │ │ │ -0000cb60: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │ +0000cb10: 2020 286c 696e 6520 2037 3437 290a 2a20    (line  747).* 
│ │ │ │ +0000cb20: 7368 6973 6869 5f61 7072 6571 5f70 7269  shishi_apreq_pri
│ │ │ │ +0000cb30: 6e74 3a20 2020 2020 2020 2020 2020 2020  nt:             
│ │ │ │ +0000cb40: 2020 2020 2020 2041 502d 5245 5120 616e         AP-REQ an
│ │ │ │ +0000cb50: 6420 4150 2d52 4550 2046 756e 6374 696f  d AP-REP Functio
│ │ │ │ +0000cb60: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │  0000cb70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000cb80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000cb90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000cba0: 286c 696e 6520 2037 3035 290a 2a20 7368  (line  705).* sh
│ │ │ │ -0000cbb0: 6973 6869 5f61 7072 6571 5f72 6561 643a  ishi_apreq_read:
│ │ │ │ -0000cbc0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000cbd0: 2020 2020 2041 502d 5245 5120 616e 6420       AP-REQ and 
│ │ │ │ -0000cbe0: 4150 2d52 4550 2046 756e 6374 696f 6e73  AP-REP Functions
│ │ │ │ -0000cbf0: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │ +0000cba0: 2028 6c69 6e65 2020 3730 3529 0a2a 2073   (line  705).* s
│ │ │ │ +0000cbb0: 6869 7368 695f 6170 7265 715f 7265 6164  hishi_apreq_read
│ │ │ │ +0000cbc0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ +0000cbd0: 2020 2020 2020 4150 2d52 4551 2061 6e64        AP-REQ and
│ │ │ │ +0000cbe0: 2041 502d 5245 5020 4675 6e63 7469 6f6e   AP-REP Function
│ │ │ │ +0000cbf0: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │  0000cc00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000cc10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000cc20: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ -0000cc30: 6c69 6e65 2020 3736 3129 0a2a 2073 6869  line  761).* shi
│ │ │ │ -0000cc40: 7368 695f 6170 7265 715f 7361 7665 3a20  shi_apreq_save: 
│ │ │ │ +0000cc20: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0000cc30: 286c 696e 6520 2037 3631 290a 2a20 7368  (line  761).* sh
│ │ │ │ +0000cc40: 6973 6869 5f61 7072 6571 5f73 6176 653a  ishi_apreq_save:
│ │ │ │  0000cc50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000cc60: 2020 2020 4150 2d52 4551 2061 6e64 2041      AP-REQ and A
│ │ │ │ -0000cc70: 502d 5245 5020 4675 6e63 7469 6f6e 732e  P-REP Functions.
│ │ │ │ -0000cc80: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ +0000cc60: 2020 2020 2041 502d 5245 5120 616e 6420       AP-REQ and 
│ │ │ │ +0000cc70: 4150 2d52 4550 2046 756e 6374 696f 6e73  AP-REP Functions
│ │ │ │ +0000cc80: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │  0000cc90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000cca0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000ccb0: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ -0000ccc0: 696e 6520 2037 3138 290a 2a20 7368 6973  ine  718).* shis
│ │ │ │ -0000ccd0: 6869 5f61 7072 6571 5f73 6574 5f61 7574  hi_apreq_set_aut
│ │ │ │ -0000cce0: 6865 6e74 6963 6174 6f72 3a20 2020 2020  henticator:     
│ │ │ │ -0000ccf0: 2020 2041 502d 5245 5120 616e 6420 4150     AP-REQ and AP
│ │ │ │ -0000cd00: 2d52 4550 2046 756e 6374 696f 6e73 2e0a  -REP Functions..
│ │ │ │ -0000cd10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0000ccb0: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ +0000ccc0: 6c69 6e65 2020 3731 3829 0a2a 2073 6869  line  718).* shi
│ │ │ │ +0000ccd0: 7368 695f 6170 7265 715f 7365 745f 6175  shi_apreq_set_au
│ │ │ │ +0000cce0: 7468 656e 7469 6361 746f 723a 2020 2020  thenticator:    
│ │ │ │ +0000ccf0: 2020 2020 4150 2d52 4551 2061 6e64 2041      AP-REQ and A
│ │ │ │ +0000cd00: 502d 5245 5020 4675 6e63 7469 6f6e 732e  P-REP Functions.
│ │ │ │ +0000cd10: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │  0000cd20: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000cd30: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000cd40: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ -0000cd50: 6e65 2020 3739 3029 0a2a 2073 6869 7368  ne  790).* shish
│ │ │ │ -0000cd60: 695f 6170 7265 715f 7365 745f 7469 636b  i_apreq_set_tick
│ │ │ │ -0000cd70: 6574 3a20 2020 2020 2020 2020 2020 2020  et:             
│ │ │ │ -0000cd80: 2020 4150 2d52 4551 2061 6e64 2041 502d    AP-REQ and AP-
│ │ │ │ -0000cd90: 5245 5020 4675 6e63 7469 6f6e 732e 0a20  REP Functions.. 
│ │ │ │ +0000cd40: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ +0000cd50: 696e 6520 2037 3930 290a 2a20 7368 6973  ine  790).* shis
│ │ │ │ +0000cd60: 6869 5f61 7072 6571 5f73 6574 5f74 6963  hi_apreq_set_tic
│ │ │ │ +0000cd70: 6b65 743a 2020 2020 2020 2020 2020 2020  ket:            
│ │ │ │ +0000cd80: 2020 2041 502d 5245 5120 616e 6420 4150     AP-REQ and AP
│ │ │ │ +0000cd90: 2d52 4550 2046 756e 6374 696f 6e73 2e0a  -REP Functions..
│ │ │ │  0000cda0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000cdb0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000cdc0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000cdd0: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ -0000cde0: 6520 2038 3239 290a 2a20 7368 6973 6869  e  829).* shishi
│ │ │ │ -0000cdf0: 5f61 7072 6571 5f74 6f5f 6669 6c65 3a20  _apreq_to_file: 
│ │ │ │ +0000cdd0: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ +0000cde0: 6e65 2020 3832 3929 0a2a 2073 6869 7368  ne  829).* shish
│ │ │ │ +0000cdf0: 695f 6170 7265 715f 746f 5f66 696c 653a  i_apreq_to_file:
│ │ │ │  0000ce00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000ce10: 2041 502d 5245 5120 616e 6420 4150 2d52   AP-REQ and AP-R
│ │ │ │ -0000ce20: 4550 2046 756e 6374 696f 6e73 2e0a 2020  EP Functions..  
│ │ │ │ +0000ce10: 2020 4150 2d52 4551 2061 6e64 2041 502d    AP-REQ and AP-
│ │ │ │ +0000ce20: 5245 5020 4675 6e63 7469 6f6e 732e 0a20  REP Functions.. 
│ │ │ │  0000ce30: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000ce40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000ce50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000ce60: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ -0000ce70: 2020 3733 3129 0a2a 2073 6869 7368 695f    731).* shishi_
│ │ │ │ -0000ce80: 6170 7265 715f 7573 655f 7365 7373 696f  apreq_use_sessio
│ │ │ │ -0000ce90: 6e5f 6b65 795f 703a 2020 2020 2020 2020  n_key_p:        
│ │ │ │ -0000cea0: 4150 2d52 4551 2061 6e64 2041 502d 5245  AP-REQ and AP-RE
│ │ │ │ -0000ceb0: 5020 4675 6e63 7469 6f6e 732e 0a20 2020  P Functions..   
│ │ │ │ +0000ce60: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ +0000ce70: 6520 2037 3331 290a 2a20 7368 6973 6869  e  731).* shishi
│ │ │ │ +0000ce80: 5f61 7072 6571 5f75 7365 5f73 6573 7369  _apreq_use_sessi
│ │ │ │ +0000ce90: 6f6e 5f6b 6579 5f70 3a20 2020 2020 2020  on_key_p:       
│ │ │ │ +0000cea0: 2041 502d 5245 5120 616e 6420 4150 2d52   AP-REQ and AP-R
│ │ │ │ +0000ceb0: 4550 2046 756e 6374 696f 6e73 2e0a 2020  EP Functions..  
│ │ │ │  0000cec0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000ced0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000cee0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000cef0: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ -0000cf00: 2038 3536 290a 2a20 7368 6973 6869 5f61   856).* shishi_a
│ │ │ │ -0000cf10: 7263 666f 7572 3a20 2020 2020 2020 2020  rcfour:         
│ │ │ │ -0000cf20: 2020 2020 2020 2020 2020 2020 2020 2043                 C
│ │ │ │ -0000cf30: 7279 7074 6f67 7261 7068 6963 2046 756e  ryptographic Fun
│ │ │ │ -0000cf40: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │ +0000cef0: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ +0000cf00: 2020 3835 3629 0a2a 2073 6869 7368 695f    856).* shishi_
│ │ │ │ +0000cf10: 6172 6366 6f75 723a 2020 2020 2020 2020  arcfour:        
│ │ │ │ +0000cf20: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0000cf30: 4372 7970 746f 6772 6170 6869 6320 4675  Cryptographic Fu
│ │ │ │ +0000cf40: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │  0000cf50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000cf60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000cf70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000cf80: 2020 2020 2028 6c69 6e65 2031 3531 3129       (line 1511)
│ │ │ │ -0000cf90: 0a2a 2073 6869 7368 695f 6173 3a20 2020  .* shishi_as:   
│ │ │ │ +0000cf80: 2020 2020 2020 286c 696e 6520 3135 3131        (line 1511
│ │ │ │ +0000cf90: 290a 2a20 7368 6973 6869 5f61 733a 2020  ).* shishi_as:  
│ │ │ │  0000cfa0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000cfb0: 2020 2020 2020 2020 2020 4153 2046 756e            AS Fun
│ │ │ │ -0000cfc0: 6374 696f 6e73 2e20 2020 2020 2020 286c  ctions.       (l
│ │ │ │ -0000cfd0: 696e 6520 2020 3830 290a 2a20 7368 6973  ine   80).* shis
│ │ │ │ -0000cfe0: 6869 5f61 735f 6368 6563 6b5f 636e 616d  hi_as_check_cnam
│ │ │ │ -0000cff0: 653a 2020 2020 2020 2020 2020 2020 2020  e:              
│ │ │ │ -0000d000: 2020 2041 532f 5447 5320 4675 6e63 7469     AS/TGS Functi
│ │ │ │ -0000d010: 6f6e 732e 2020 2028 6c69 6e65 2020 3230  ons.   (line  20
│ │ │ │ -0000d020: 3329 0a2a 2073 6869 7368 695f 6173 5f63  3).* shishi_as_c
│ │ │ │ -0000d030: 6865 636b 5f63 7265 616c 6d3a 2020 2020  heck_crealm:    
│ │ │ │ -0000d040: 2020 2020 2020 2020 2020 2020 4153 2f54              AS/T
│ │ │ │ -0000d050: 4753 2046 756e 6374 696f 6e73 2e20 2020  GS Functions.   
│ │ │ │ -0000d060: 286c 696e 6520 2031 3730 290a 2a20 7368  (line  170).* sh
│ │ │ │ -0000d070: 6973 6869 5f61 735f 6465 7269 7665 5f73  ishi_as_derive_s
│ │ │ │ -0000d080: 616c 743a 2020 2020 2020 2020 2020 2020  alt:            
│ │ │ │ -0000d090: 2020 2020 2041 532f 5447 5320 4675 6e63       AS/TGS Func
│ │ │ │ -0000d0a0: 7469 6f6e 732e 2020 2028 6c69 6e65 2020  tions.   (line  
│ │ │ │ -0000d0b0: 2039 3429 0a2a 2073 6869 7368 695f 6173   94).* shishi_as
│ │ │ │ -0000d0c0: 5f64 6f6e 653a 2020 2020 2020 2020 2020  _done:          
│ │ │ │ -0000d0d0: 2020 2020 2020 2020 2020 2020 2020 4153                AS
│ │ │ │ -0000d0e0: 2046 756e 6374 696f 6e73 2e20 2020 2020   Functions.     
│ │ │ │ -0000d0f0: 2020 286c 696e 6520 2020 3931 290a 2a20    (line   91).* 
│ │ │ │ -0000d100: 7368 6973 6869 5f61 735f 6b72 6265 7272  shishi_as_krberr
│ │ │ │ -0000d110: 6f72 3a20 2020 2020 2020 2020 2020 2020  or:             
│ │ │ │ -0000d120: 2020 2020 2020 2041 5320 4675 6e63 7469         AS Functi
│ │ │ │ -0000d130: 6f6e 732e 2020 2020 2020 2028 6c69 6e65  ons.       (line
│ │ │ │ -0000d140: 2020 3233 3329 0a2a 2073 6869 7368 695f    233).* shishi_
│ │ │ │ -0000d150: 6173 5f6b 7262 6572 726f 725f 6465 723a  as_krberror_der:
│ │ │ │ -0000d160: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000d170: 4153 2046 756e 6374 696f 6e73 2e20 2020  AS Functions.   
│ │ │ │ -0000d180: 2020 2020 286c 696e 6520 2032 3434 290a      (line  244).
│ │ │ │ -0000d190: 2a20 7368 6973 6869 5f61 735f 6b72 6265  * shishi_as_krbe
│ │ │ │ -0000d1a0: 7272 6f72 5f73 6574 3a20 2020 2020 2020  rror_set:       
│ │ │ │ -0000d1b0: 2020 2020 2020 2020 2041 5320 4675 6e63           AS Func
│ │ │ │ -0000d1c0: 7469 6f6e 732e 2020 2020 2020 2028 6c69  tions.       (li
│ │ │ │ -0000d1d0: 6e65 2020 3235 3829 0a2a 2073 6869 7368  ne  258).* shish
│ │ │ │ -0000d1e0: 695f 6173 5f70 726f 6365 7373 3a20 2020  i_as_process:   
│ │ │ │ +0000cfb0: 2020 2020 2020 2020 2020 2041 5320 4675             AS Fu
│ │ │ │ +0000cfc0: 6e63 7469 6f6e 732e 2020 2020 2020 2028  nctions.       (
│ │ │ │ +0000cfd0: 6c69 6e65 2020 2038 3029 0a2a 2073 6869  line   80).* shi
│ │ │ │ +0000cfe0: 7368 695f 6173 5f63 6865 636b 5f63 6e61  shi_as_check_cna
│ │ │ │ +0000cff0: 6d65 3a20 2020 2020 2020 2020 2020 2020  me:             
│ │ │ │ +0000d000: 2020 2020 4153 2f54 4753 2046 756e 6374      AS/TGS Funct
│ │ │ │ +0000d010: 696f 6e73 2e20 2020 286c 696e 6520 2032  ions.   (line  2
│ │ │ │ +0000d020: 3033 290a 2a20 7368 6973 6869 5f61 735f  03).* shishi_as_
│ │ │ │ +0000d030: 6368 6563 6b5f 6372 6561 6c6d 3a20 2020  check_crealm:   
│ │ │ │ +0000d040: 2020 2020 2020 2020 2020 2020 2041 532f               AS/
│ │ │ │ +0000d050: 5447 5320 4675 6e63 7469 6f6e 732e 2020  TGS Functions.  
│ │ │ │ +0000d060: 2028 6c69 6e65 2020 3137 3029 0a2a 2073   (line  170).* s
│ │ │ │ +0000d070: 6869 7368 695f 6173 5f64 6572 6976 655f  hishi_as_derive_
│ │ │ │ +0000d080: 7361 6c74 3a20 2020 2020 2020 2020 2020  salt:           
│ │ │ │ +0000d090: 2020 2020 2020 4153 2f54 4753 2046 756e        AS/TGS Fun
│ │ │ │ +0000d0a0: 6374 696f 6e73 2e20 2020 286c 696e 6520  ctions.   (line 
│ │ │ │ +0000d0b0: 2020 3934 290a 2a20 7368 6973 6869 5f61    94).* shishi_a
│ │ │ │ +0000d0c0: 735f 646f 6e65 3a20 2020 2020 2020 2020  s_done:         
│ │ │ │ +0000d0d0: 2020 2020 2020 2020 2020 2020 2020 2041                 A
│ │ │ │ +0000d0e0: 5320 4675 6e63 7469 6f6e 732e 2020 2020  S Functions.    
│ │ │ │ +0000d0f0: 2020 2028 6c69 6e65 2020 2039 3129 0a2a     (line   91).*
│ │ │ │ +0000d100: 2073 6869 7368 695f 6173 5f6b 7262 6572   shishi_as_krber
│ │ │ │ +0000d110: 726f 723a 2020 2020 2020 2020 2020 2020  ror:            
│ │ │ │ +0000d120: 2020 2020 2020 2020 4153 2046 756e 6374          AS Funct
│ │ │ │ +0000d130: 696f 6e73 2e20 2020 2020 2020 286c 696e  ions.       (lin
│ │ │ │ +0000d140: 6520 2032 3333 290a 2a20 7368 6973 6869  e  233).* shishi
│ │ │ │ +0000d150: 5f61 735f 6b72 6265 7272 6f72 5f64 6572  _as_krberror_der
│ │ │ │ +0000d160: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ +0000d170: 2041 5320 4675 6e63 7469 6f6e 732e 2020   AS Functions.  
│ │ │ │ +0000d180: 2020 2020 2028 6c69 6e65 2020 3234 3429       (line  244)
│ │ │ │ +0000d190: 0a2a 2073 6869 7368 695f 6173 5f6b 7262  .* shishi_as_krb
│ │ │ │ +0000d1a0: 6572 726f 725f 7365 743a 2020 2020 2020  error_set:      
│ │ │ │ +0000d1b0: 2020 2020 2020 2020 2020 4153 2046 756e            AS Fun
│ │ │ │ +0000d1c0: 6374 696f 6e73 2e20 2020 2020 2020 286c  ctions.       (l
│ │ │ │ +0000d1d0: 696e 6520 2032 3538 290a 2a20 7368 6973  ine  258).* shis
│ │ │ │ +0000d1e0: 6869 5f61 735f 7072 6f63 6573 733a 2020  hi_as_process:  
│ │ │ │  0000d1f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000d200: 2020 4153 2f54 4753 2046 756e 6374 696f    AS/TGS Functio
│ │ │ │ -0000d210: 6e73 2e20 2020 286c 696e 6520 2032 3830  ns.   (line  280
│ │ │ │ -0000d220: 290a 2a20 7368 6973 6869 5f61 735f 7265  ).* shishi_as_re
│ │ │ │ -0000d230: 703a 2020 2020 2020 2020 2020 2020 2020  p:              
│ │ │ │ -0000d240: 2020 2020 2020 2020 2020 2041 5320 4675             AS Fu
│ │ │ │ -0000d250: 6e63 7469 6f6e 732e 2020 2020 2020 2028  nctions.       (
│ │ │ │ -0000d260: 6c69 6e65 2020 3135 3929 0a2a 2073 6869  line  159).* shi
│ │ │ │ -0000d270: 7368 695f 6173 5f72 6570 5f62 7569 6c64  shi_as_rep_build
│ │ │ │ -0000d280: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ -0000d290: 2020 2020 4153 2046 756e 6374 696f 6e73      AS Functions
│ │ │ │ -0000d2a0: 2e20 2020 2020 2020 286c 696e 6520 2031  .       (line  1
│ │ │ │ -0000d2b0: 3835 290a 2a20 7368 6973 6869 5f61 735f  85).* shishi_as_
│ │ │ │ -0000d2c0: 7265 705f 6465 723a 2020 2020 2020 2020  rep_der:        
│ │ │ │ -0000d2d0: 2020 2020 2020 2020 2020 2020 2041 5320               AS 
│ │ │ │ -0000d2e0: 4675 6e63 7469 6f6e 732e 2020 2020 2020  Functions.      
│ │ │ │ -0000d2f0: 2028 6c69 6e65 2020 3139 3629 0a2a 2073   (line  196).* s
│ │ │ │ -0000d300: 6869 7368 695f 6173 5f72 6570 5f64 6572  hishi_as_rep_der
│ │ │ │ -0000d310: 5f73 6574 3a20 2020 2020 2020 2020 2020  _set:           
│ │ │ │ -0000d320: 2020 2020 2020 4153 2046 756e 6374 696f        AS Functio
│ │ │ │ -0000d330: 6e73 2e20 2020 2020 2020 286c 696e 6520  ns.       (line 
│ │ │ │ -0000d340: 2032 3139 290a 2a20 7368 6973 6869 5f61   219).* shishi_a
│ │ │ │ -0000d350: 735f 7265 705f 7072 6f63 6573 733a 2020  s_rep_process:  
│ │ │ │ -0000d360: 2020 2020 2020 2020 2020 2020 2020 2041                 A
│ │ │ │ -0000d370: 5320 4675 6e63 7469 6f6e 732e 2020 2020  S Functions.    
│ │ │ │ -0000d380: 2020 2028 6c69 6e65 2020 3137 3029 0a2a     (line  170).*
│ │ │ │ -0000d390: 2073 6869 7368 695f 6173 5f72 6570 5f73   shishi_as_rep_s
│ │ │ │ -0000d3a0: 6574 3a20 2020 2020 2020 2020 2020 2020  et:             
│ │ │ │ -0000d3b0: 2020 2020 2020 2020 4153 2046 756e 6374          AS Funct
│ │ │ │ -0000d3c0: 696f 6e73 2e20 2020 2020 2020 286c 696e  ions.       (lin
│ │ │ │ -0000d3d0: 6520 2032 3130 290a 2a20 7368 6973 6869  e  210).* shishi
│ │ │ │ -0000d3e0: 5f61 735f 7265 713a 2020 2020 2020 2020  _as_req:        
│ │ │ │ +0000d200: 2020 2041 532f 5447 5320 4675 6e63 7469     AS/TGS Functi
│ │ │ │ +0000d210: 6f6e 732e 2020 2028 6c69 6e65 2020 3238  ons.   (line  28
│ │ │ │ +0000d220: 3029 0a2a 2073 6869 7368 695f 6173 5f72  0).* shishi_as_r
│ │ │ │ +0000d230: 6570 3a20 2020 2020 2020 2020 2020 2020  ep:             
│ │ │ │ +0000d240: 2020 2020 2020 2020 2020 2020 4153 2046              AS F
│ │ │ │ +0000d250: 756e 6374 696f 6e73 2e20 2020 2020 2020  unctions.       
│ │ │ │ +0000d260: 286c 696e 6520 2031 3539 290a 2a20 7368  (line  159).* sh
│ │ │ │ +0000d270: 6973 6869 5f61 735f 7265 705f 6275 696c  ishi_as_rep_buil
│ │ │ │ +0000d280: 643a 2020 2020 2020 2020 2020 2020 2020  d:              
│ │ │ │ +0000d290: 2020 2020 2041 5320 4675 6e63 7469 6f6e       AS Function
│ │ │ │ +0000d2a0: 732e 2020 2020 2020 2028 6c69 6e65 2020  s.       (line  
│ │ │ │ +0000d2b0: 3138 3529 0a2a 2073 6869 7368 695f 6173  185).* shishi_as
│ │ │ │ +0000d2c0: 5f72 6570 5f64 6572 3a20 2020 2020 2020  _rep_der:       
│ │ │ │ +0000d2d0: 2020 2020 2020 2020 2020 2020 2020 4153                AS
│ │ │ │ +0000d2e0: 2046 756e 6374 696f 6e73 2e20 2020 2020   Functions.     
│ │ │ │ +0000d2f0: 2020 286c 696e 6520 2031 3936 290a 2a20    (line  196).* 
│ │ │ │ +0000d300: 7368 6973 6869 5f61 735f 7265 705f 6465  shishi_as_rep_de
│ │ │ │ +0000d310: 725f 7365 743a 2020 2020 2020 2020 2020  r_set:          
│ │ │ │ +0000d320: 2020 2020 2020 2041 5320 4675 6e63 7469         AS Functi
│ │ │ │ +0000d330: 6f6e 732e 2020 2020 2020 2028 6c69 6e65  ons.       (line
│ │ │ │ +0000d340: 2020 3231 3929 0a2a 2073 6869 7368 695f    219).* shishi_
│ │ │ │ +0000d350: 6173 5f72 6570 5f70 726f 6365 7373 3a20  as_rep_process: 
│ │ │ │ +0000d360: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0000d370: 4153 2046 756e 6374 696f 6e73 2e20 2020  AS Functions.   
│ │ │ │ +0000d380: 2020 2020 286c 696e 6520 2031 3730 290a      (line  170).
│ │ │ │ +0000d390: 2a20 7368 6973 6869 5f61 735f 7265 705f  * shishi_as_rep_
│ │ │ │ +0000d3a0: 7365 743a 2020 2020 2020 2020 2020 2020  set:            
│ │ │ │ +0000d3b0: 2020 2020 2020 2020 2041 5320 4675 6e63           AS Func
│ │ │ │ +0000d3c0: 7469 6f6e 732e 2020 2020 2020 2028 6c69  tions.       (li
│ │ │ │ +0000d3d0: 6e65 2020 3231 3029 0a2a 2073 6869 7368  ne  210).* shish
│ │ │ │ +0000d3e0: 695f 6173 5f72 6571 3a20 2020 2020 2020  i_as_req:       
│ │ │ │  0000d3f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000d400: 2041 5320 4675 6e63 7469 6f6e 732e 2020   AS Functions.  
│ │ │ │ -0000d410: 2020 2020 2028 6c69 6e65 2020 3130 3129       (line  101)
│ │ │ │ -0000d420: 0a2a 2073 6869 7368 695f 6173 5f72 6571  .* shishi_as_req
│ │ │ │ -0000d430: 5f62 7569 6c64 3a20 2020 2020 2020 2020  _build:         
│ │ │ │ -0000d440: 2020 2020 2020 2020 2020 4153 2046 756e            AS Fun
│ │ │ │ -0000d450: 6374 696f 6e73 2e20 2020 2020 2020 286c  ctions.       (l
│ │ │ │ -0000d460: 696e 6520 2031 3132 290a 2a20 7368 6973  ine  112).* shis
│ │ │ │ -0000d470: 6869 5f61 735f 7265 715f 6465 723a 2020  hi_as_req_der:  
│ │ │ │ +0000d400: 2020 4153 2046 756e 6374 696f 6e73 2e20    AS Functions. 
│ │ │ │ +0000d410: 2020 2020 2020 286c 696e 6520 2031 3031        (line  101
│ │ │ │ +0000d420: 290a 2a20 7368 6973 6869 5f61 735f 7265  ).* shishi_as_re
│ │ │ │ +0000d430: 715f 6275 696c 643a 2020 2020 2020 2020  q_build:        
│ │ │ │ +0000d440: 2020 2020 2020 2020 2020 2041 5320 4675             AS Fu
│ │ │ │ +0000d450: 6e63 7469 6f6e 732e 2020 2020 2020 2028  nctions.       (
│ │ │ │ +0000d460: 6c69 6e65 2020 3131 3229 0a2a 2073 6869  line  112).* shi
│ │ │ │ +0000d470: 7368 695f 6173 5f72 6571 5f64 6572 3a20  shi_as_req_der: 
│ │ │ │  0000d480: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000d490: 2020 2041 5320 4675 6e63 7469 6f6e 732e     AS Functions.
│ │ │ │ -0000d4a0: 2020 2020 2020 2028 6c69 6e65 2020 3133         (line  13
│ │ │ │ -0000d4b0: 3129 0a2a 2073 6869 7368 695f 6173 5f72  1).* shishi_as_r
│ │ │ │ -0000d4c0: 6571 5f64 6572 5f73 6574 3a20 2020 2020  eq_der_set:     
│ │ │ │ -0000d4d0: 2020 2020 2020 2020 2020 2020 4153 2046              AS F
│ │ │ │ -0000d4e0: 756e 6374 696f 6e73 2e20 2020 2020 2020  unctions.       
│ │ │ │ -0000d4f0: 286c 696e 6520 2031 3435 290a 2a20 7368  (line  145).* sh
│ │ │ │ -0000d500: 6973 6869 5f61 735f 7265 715f 7365 743a  ishi_as_req_set:
│ │ │ │ -0000d510: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000d520: 2020 2020 2041 5320 4675 6e63 7469 6f6e       AS Function
│ │ │ │ -0000d530: 732e 2020 2020 2020 2028 6c69 6e65 2020  s.       (line  
│ │ │ │ -0000d540: 3132 3229 0a2a 2073 6869 7368 695f 6173  122).* shishi_as
│ │ │ │ -0000d550: 5f73 656e 6472 6563 763a 2020 2020 2020  _sendrecv:      
│ │ │ │ -0000d560: 2020 2020 2020 2020 2020 2020 2020 4153                AS
│ │ │ │ -0000d570: 2046 756e 6374 696f 6e73 2e20 2020 2020   Functions.     
│ │ │ │ -0000d580: 2020 286c 696e 6520 2033 3034 290a 2a20    (line  304).* 
│ │ │ │ -0000d590: 7368 6973 6869 5f61 735f 7365 6e64 7265  shishi_as_sendre
│ │ │ │ -0000d5a0: 6376 5f68 696e 743a 2020 2020 2020 2020  cv_hint:        
│ │ │ │ -0000d5b0: 2020 2020 2020 2041 5320 4675 6e63 7469         AS Functi
│ │ │ │ -0000d5c0: 6f6e 732e 2020 2020 2020 2028 6c69 6e65  ons.       (line
│ │ │ │ -0000d5d0: 2020 3238 3829 0a2a 2073 6869 7368 695f    288).* shishi_
│ │ │ │ -0000d5e0: 6173 5f74 6b74 3a20 2020 2020 2020 2020  as_tkt:         
│ │ │ │ +0000d490: 2020 2020 4153 2046 756e 6374 696f 6e73      AS Functions
│ │ │ │ +0000d4a0: 2e20 2020 2020 2020 286c 696e 6520 2031  .       (line  1
│ │ │ │ +0000d4b0: 3331 290a 2a20 7368 6973 6869 5f61 735f  31).* shishi_as_
│ │ │ │ +0000d4c0: 7265 715f 6465 725f 7365 743a 2020 2020  req_der_set:    
│ │ │ │ +0000d4d0: 2020 2020 2020 2020 2020 2020 2041 5320               AS 
│ │ │ │ +0000d4e0: 4675 6e63 7469 6f6e 732e 2020 2020 2020  Functions.      
│ │ │ │ +0000d4f0: 2028 6c69 6e65 2020 3134 3529 0a2a 2073   (line  145).* s
│ │ │ │ +0000d500: 6869 7368 695f 6173 5f72 6571 5f73 6574  hishi_as_req_set
│ │ │ │ +0000d510: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ +0000d520: 2020 2020 2020 4153 2046 756e 6374 696f        AS Functio
│ │ │ │ +0000d530: 6e73 2e20 2020 2020 2020 286c 696e 6520  ns.       (line 
│ │ │ │ +0000d540: 2031 3232 290a 2a20 7368 6973 6869 5f61   122).* shishi_a
│ │ │ │ +0000d550: 735f 7365 6e64 7265 6376 3a20 2020 2020  s_sendrecv:     
│ │ │ │ +0000d560: 2020 2020 2020 2020 2020 2020 2020 2041                 A
│ │ │ │ +0000d570: 5320 4675 6e63 7469 6f6e 732e 2020 2020  S Functions.    
│ │ │ │ +0000d580: 2020 2028 6c69 6e65 2020 3330 3429 0a2a     (line  304).*
│ │ │ │ +0000d590: 2073 6869 7368 695f 6173 5f73 656e 6472   shishi_as_sendr
│ │ │ │ +0000d5a0: 6563 765f 6869 6e74 3a20 2020 2020 2020  ecv_hint:       
│ │ │ │ +0000d5b0: 2020 2020 2020 2020 4153 2046 756e 6374          AS Funct
│ │ │ │ +0000d5c0: 696f 6e73 2e20 2020 2020 2020 286c 696e  ions.       (lin
│ │ │ │ +0000d5d0: 6520 2032 3838 290a 2a20 7368 6973 6869  e  288).* shishi
│ │ │ │ +0000d5e0: 5f61 735f 746b 743a 2020 2020 2020 2020  _as_tkt:        
│ │ │ │  0000d5f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000d600: 4153 2046 756e 6374 696f 6e73 2e20 2020  AS Functions.   
│ │ │ │ -0000d610: 2020 2020 286c 696e 6520 2032 3638 290a      (line  268).
│ │ │ │ -0000d620: 2a20 7368 6973 6869 5f61 735f 746b 745f  * shishi_as_tkt_
│ │ │ │ -0000d630: 7365 743a 2020 2020 2020 2020 2020 2020  set:            
│ │ │ │ -0000d640: 2020 2020 2020 2020 2041 5320 4675 6e63           AS Func
│ │ │ │ -0000d650: 7469 6f6e 732e 2020 2020 2020 2028 6c69  tions.       (li
│ │ │ │ -0000d660: 6e65 2020 3237 3929 0a2a 2073 6869 7368  ne  279).* shish
│ │ │ │ -0000d670: 695f 6173 6e31 5f61 7072 6570 3a20 2020  i_asn1_aprep:   
│ │ │ │ +0000d600: 2041 5320 4675 6e63 7469 6f6e 732e 2020   AS Functions.  
│ │ │ │ +0000d610: 2020 2020 2028 6c69 6e65 2020 3236 3829       (line  268)
│ │ │ │ +0000d620: 0a2a 2073 6869 7368 695f 6173 5f74 6b74  .* shishi_as_tkt
│ │ │ │ +0000d630: 5f73 6574 3a20 2020 2020 2020 2020 2020  _set:           
│ │ │ │ +0000d640: 2020 2020 2020 2020 2020 4153 2046 756e            AS Fun
│ │ │ │ +0000d650: 6374 696f 6e73 2e20 2020 2020 2020 286c  ctions.       (l
│ │ │ │ +0000d660: 696e 6520 2032 3739 290a 2a20 7368 6973  ine  279).* shis
│ │ │ │ +0000d670: 6869 5f61 736e 315f 6170 7265 703a 2020  hi_asn1_aprep:  
│ │ │ │  0000d680: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000d690: 2020 4153 4e2e 3120 4675 6e63 7469 6f6e    ASN.1 Function
│ │ │ │ -0000d6a0: 732e 2020 2020 286c 696e 6520 2031 3939  s.    (line  199
│ │ │ │ -0000d6b0: 290a 2a20 7368 6973 6869 5f61 736e 315f  ).* shishi_asn1_
│ │ │ │ -0000d6c0: 6170 7265 713a 2020 2020 2020 2020 2020  apreq:          
│ │ │ │ -0000d6d0: 2020 2020 2020 2020 2020 2041 534e 2e31             ASN.1
│ │ │ │ -0000d6e0: 2046 756e 6374 696f 6e73 2e20 2020 2028   Functions.    (
│ │ │ │ -0000d6f0: 6c69 6e65 2020 3138 3929 0a2a 2073 6869  line  189).* shi
│ │ │ │ -0000d700: 7368 695f 6173 6e31 5f61 7372 6570 3a20  shi_asn1_asrep: 
│ │ │ │ +0000d690: 2020 2041 534e 2e31 2046 756e 6374 696f     ASN.1 Functio
│ │ │ │ +0000d6a0: 6e73 2e20 2020 2028 6c69 6e65 2020 3139  ns.    (line  19
│ │ │ │ +0000d6b0: 3929 0a2a 2073 6869 7368 695f 6173 6e31  9).* shishi_asn1
│ │ │ │ +0000d6c0: 5f61 7072 6571 3a20 2020 2020 2020 2020  _apreq:         
│ │ │ │ +0000d6d0: 2020 2020 2020 2020 2020 2020 4153 4e2e              ASN.
│ │ │ │ +0000d6e0: 3120 4675 6e63 7469 6f6e 732e 2020 2020  1 Functions.    
│ │ │ │ +0000d6f0: 286c 696e 6520 2031 3839 290a 2a20 7368  (line  189).* sh
│ │ │ │ +0000d700: 6973 6869 5f61 736e 315f 6173 7265 703a  ishi_asn1_asrep:
│ │ │ │  0000d710: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000d720: 2020 2020 4153 4e2e 3120 4675 6e63 7469      ASN.1 Functi
│ │ │ │ -0000d730: 6f6e 732e 2020 2020 286c 696e 6520 2031  ons.    (line  1
│ │ │ │ -0000d740: 3539 290a 2a20 7368 6973 6869 5f61 736e  59).* shishi_asn
│ │ │ │ -0000d750: 315f 6173 7265 713a 2020 2020 2020 2020  1_asreq:        
│ │ │ │ -0000d760: 2020 2020 2020 2020 2020 2020 2041 534e               ASN
│ │ │ │ -0000d770: 2e31 2046 756e 6374 696f 6e73 2e20 2020  .1 Functions.   
│ │ │ │ -0000d780: 2028 6c69 6e65 2020 3134 3929 0a2a 2073   (line  149).* s
│ │ │ │ -0000d790: 6869 7368 695f 6173 6e31 5f61 7574 6865  hishi_asn1_authe
│ │ │ │ -0000d7a0: 6e74 6963 6174 6f72 3a20 2020 2020 2020  nticator:       
│ │ │ │ -0000d7b0: 2020 2020 2020 4153 4e2e 3120 4675 6e63        ASN.1 Func
│ │ │ │ -0000d7c0: 7469 6f6e 732e 2020 2020 286c 696e 6520  tions.    (line 
│ │ │ │ -0000d7d0: 2032 3339 290a 2a20 7368 6973 6869 5f61   239).* shishi_a
│ │ │ │ -0000d7e0: 736e 315f 646f 6e65 3a20 2020 2020 2020  sn1_done:       
│ │ │ │ -0000d7f0: 2020 2020 2020 2020 2020 2020 2020 2041                 A
│ │ │ │ -0000d800: 534e 2e31 2046 756e 6374 696f 6e73 2e20  SN.1 Functions. 
│ │ │ │ -0000d810: 2020 2028 6c69 6e65 2020 2037 3929 0a2a     (line   79).*
│ │ │ │ -0000d820: 2073 6869 7368 695f 6173 6e31 5f65 6e63   shishi_asn1_enc
│ │ │ │ -0000d830: 6170 7265 7070 6172 743a 2020 2020 2020  apreppart:      
│ │ │ │ -0000d840: 2020 2020 2020 2020 4153 4e2e 3120 4675          ASN.1 Fu
│ │ │ │ -0000d850: 6e63 7469 6f6e 732e 2020 2020 286c 696e  nctions.    (lin
│ │ │ │ -0000d860: 6520 2032 3039 290a 2a20 7368 6973 6869  e  209).* shishi
│ │ │ │ -0000d870: 5f61 736e 315f 656e 6361 7372 6570 7061  _asn1_encasreppa
│ │ │ │ -0000d880: 7274 3a20 2020 2020 2020 2020 2020 2020  rt:             
│ │ │ │ -0000d890: 2041 534e 2e31 2046 756e 6374 696f 6e73   ASN.1 Functions
│ │ │ │ -0000d8a0: 2e20 2020 2028 6c69 6e65 2020 3235 3929  .    (line  259)
│ │ │ │ -0000d8b0: 0a2a 2073 6869 7368 695f 6173 6e31 5f65  .* shishi_asn1_e
│ │ │ │ -0000d8c0: 6e63 6b64 6372 6570 7061 7274 3a20 2020  nckdcreppart:   
│ │ │ │ -0000d8d0: 2020 2020 2020 2020 2020 4153 4e2e 3120            ASN.1 
│ │ │ │ -0000d8e0: 4675 6e63 7469 6f6e 732e 2020 2020 286c  Functions.    (l
│ │ │ │ -0000d8f0: 696e 6520 2032 3439 290a 2a20 7368 6973  ine  249).* shis
│ │ │ │ -0000d900: 6869 5f61 736e 315f 656e 6370 7269 7670  hi_asn1_encprivp
│ │ │ │ -0000d910: 6172 743a 2020 2020 2020 2020 2020 2020  art:            
│ │ │ │ -0000d920: 2020 2041 534e 2e31 2046 756e 6374 696f     ASN.1 Functio
│ │ │ │ -0000d930: 6e73 2e20 2020 2028 6c69 6e65 2020 3239  ns.    (line  29
│ │ │ │ -0000d940: 3929 0a2a 2073 6869 7368 695f 6173 6e31  9).* shishi_asn1
│ │ │ │ -0000d950: 5f65 6e63 7279 7074 6564 6461 7461 3a20  _encrypteddata: 
│ │ │ │ -0000d960: 2020 2020 2020 2020 2020 2020 4153 4e2e              ASN.
│ │ │ │ -0000d970: 3120 4675 6e63 7469 6f6e 732e 2020 2020  1 Functions.    
│ │ │ │ -0000d980: 286c 696e 6520 2020 3939 290a 2a20 7368  (line   99).* sh
│ │ │ │ -0000d990: 6973 6869 5f61 736e 315f 656e 6374 6963  ishi_asn1_enctic
│ │ │ │ -0000d9a0: 6b65 7470 6172 743a 2020 2020 2020 2020  ketpart:        
│ │ │ │ -0000d9b0: 2020 2020 2041 534e 2e31 2046 756e 6374       ASN.1 Funct
│ │ │ │ -0000d9c0: 696f 6e73 2e20 2020 2028 6c69 6e65 2020  ions.    (line  
│ │ │ │ -0000d9d0: 3232 3929 0a2a 2073 6869 7368 695f 6173  229).* shishi_as
│ │ │ │ -0000d9e0: 6e31 5f65 7479 7065 5f69 6e66 6f3a 2020  n1_etype_info:  
│ │ │ │ -0000d9f0: 2020 2020 2020 2020 2020 2020 2020 4153                AS
│ │ │ │ -0000da00: 4e2e 3120 4675 6e63 7469 6f6e 732e 2020  N.1 Functions.  
│ │ │ │ -0000da10: 2020 286c 696e 6520 2031 3239 290a 2a20    (line  129).* 
│ │ │ │ -0000da20: 7368 6973 6869 5f61 736e 315f 6574 7970  shishi_asn1_etyp
│ │ │ │ -0000da30: 655f 696e 666f 323a 2020 2020 2020 2020  e_info2:        
│ │ │ │ -0000da40: 2020 2020 2020 2041 534e 2e31 2046 756e         ASN.1 Fun
│ │ │ │ -0000da50: 6374 696f 6e73 2e20 2020 2028 6c69 6e65  ctions.    (line
│ │ │ │ -0000da60: 2020 3133 3929 0a2a 2073 6869 7368 695f    139).* shishi_
│ │ │ │ -0000da70: 6173 6e31 5f6b 7262 6572 726f 723a 2020  asn1_krberror:  
│ │ │ │ +0000d720: 2020 2020 2041 534e 2e31 2046 756e 6374       ASN.1 Funct
│ │ │ │ +0000d730: 696f 6e73 2e20 2020 2028 6c69 6e65 2020  ions.    (line  
│ │ │ │ +0000d740: 3135 3929 0a2a 2073 6869 7368 695f 6173  159).* shishi_as
│ │ │ │ +0000d750: 6e31 5f61 7372 6571 3a20 2020 2020 2020  n1_asreq:       
│ │ │ │ +0000d760: 2020 2020 2020 2020 2020 2020 2020 4153                AS
│ │ │ │ +0000d770: 4e2e 3120 4675 6e63 7469 6f6e 732e 2020  N.1 Functions.  
│ │ │ │ +0000d780: 2020 286c 696e 6520 2031 3439 290a 2a20    (line  149).* 
│ │ │ │ +0000d790: 7368 6973 6869 5f61 736e 315f 6175 7468  shishi_asn1_auth
│ │ │ │ +0000d7a0: 656e 7469 6361 746f 723a 2020 2020 2020  enticator:      
│ │ │ │ +0000d7b0: 2020 2020 2020 2041 534e 2e31 2046 756e         ASN.1 Fun
│ │ │ │ +0000d7c0: 6374 696f 6e73 2e20 2020 2028 6c69 6e65  ctions.    (line
│ │ │ │ +0000d7d0: 2020 3233 3929 0a2a 2073 6869 7368 695f    239).* shishi_
│ │ │ │ +0000d7e0: 6173 6e31 5f64 6f6e 653a 2020 2020 2020  asn1_done:      
│ │ │ │ +0000d7f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0000d800: 4153 4e2e 3120 4675 6e63 7469 6f6e 732e  ASN.1 Functions.
│ │ │ │ +0000d810: 2020 2020 286c 696e 6520 2020 3739 290a      (line   79).
│ │ │ │ +0000d820: 2a20 7368 6973 6869 5f61 736e 315f 656e  * shishi_asn1_en
│ │ │ │ +0000d830: 6361 7072 6570 7061 7274 3a20 2020 2020  capreppart:     
│ │ │ │ +0000d840: 2020 2020 2020 2020 2041 534e 2e31 2046           ASN.1 F
│ │ │ │ +0000d850: 756e 6374 696f 6e73 2e20 2020 2028 6c69  unctions.    (li
│ │ │ │ +0000d860: 6e65 2020 3230 3929 0a2a 2073 6869 7368  ne  209).* shish
│ │ │ │ +0000d870: 695f 6173 6e31 5f65 6e63 6173 7265 7070  i_asn1_encasrepp
│ │ │ │ +0000d880: 6172 743a 2020 2020 2020 2020 2020 2020  art:            
│ │ │ │ +0000d890: 2020 4153 4e2e 3120 4675 6e63 7469 6f6e    ASN.1 Function
│ │ │ │ +0000d8a0: 732e 2020 2020 286c 696e 6520 2032 3539  s.    (line  259
│ │ │ │ +0000d8b0: 290a 2a20 7368 6973 6869 5f61 736e 315f  ).* shishi_asn1_
│ │ │ │ +0000d8c0: 656e 636b 6463 7265 7070 6172 743a 2020  enckdcreppart:  
│ │ │ │ +0000d8d0: 2020 2020 2020 2020 2020 2041 534e 2e31             ASN.1
│ │ │ │ +0000d8e0: 2046 756e 6374 696f 6e73 2e20 2020 2028   Functions.    (
│ │ │ │ +0000d8f0: 6c69 6e65 2020 3234 3929 0a2a 2073 6869  line  249).* shi
│ │ │ │ +0000d900: 7368 695f 6173 6e31 5f65 6e63 7072 6976  shi_asn1_encpriv
│ │ │ │ +0000d910: 7061 7274 3a20 2020 2020 2020 2020 2020  part:           
│ │ │ │ +0000d920: 2020 2020 4153 4e2e 3120 4675 6e63 7469      ASN.1 Functi
│ │ │ │ +0000d930: 6f6e 732e 2020 2020 286c 696e 6520 2032  ons.    (line  2
│ │ │ │ +0000d940: 3939 290a 2a20 7368 6973 6869 5f61 736e  99).* shishi_asn
│ │ │ │ +0000d950: 315f 656e 6372 7970 7465 6464 6174 613a  1_encrypteddata:
│ │ │ │ +0000d960: 2020 2020 2020 2020 2020 2020 2041 534e               ASN
│ │ │ │ +0000d970: 2e31 2046 756e 6374 696f 6e73 2e20 2020  .1 Functions.   
│ │ │ │ +0000d980: 2028 6c69 6e65 2020 2039 3929 0a2a 2073   (line   99).* s
│ │ │ │ +0000d990: 6869 7368 695f 6173 6e31 5f65 6e63 7469  hishi_asn1_encti
│ │ │ │ +0000d9a0: 636b 6574 7061 7274 3a20 2020 2020 2020  cketpart:       
│ │ │ │ +0000d9b0: 2020 2020 2020 4153 4e2e 3120 4675 6e63        ASN.1 Func
│ │ │ │ +0000d9c0: 7469 6f6e 732e 2020 2020 286c 696e 6520  tions.    (line 
│ │ │ │ +0000d9d0: 2032 3239 290a 2a20 7368 6973 6869 5f61   229).* shishi_a
│ │ │ │ +0000d9e0: 736e 315f 6574 7970 655f 696e 666f 3a20  sn1_etype_info: 
│ │ │ │ +0000d9f0: 2020 2020 2020 2020 2020 2020 2020 2041                 A
│ │ │ │ +0000da00: 534e 2e31 2046 756e 6374 696f 6e73 2e20  SN.1 Functions. 
│ │ │ │ +0000da10: 2020 2028 6c69 6e65 2020 3132 3929 0a2a     (line  129).*
│ │ │ │ +0000da20: 2073 6869 7368 695f 6173 6e31 5f65 7479   shishi_asn1_ety
│ │ │ │ +0000da30: 7065 5f69 6e66 6f32 3a20 2020 2020 2020  pe_info2:       
│ │ │ │ +0000da40: 2020 2020 2020 2020 4153 4e2e 3120 4675          ASN.1 Fu
│ │ │ │ +0000da50: 6e63 7469 6f6e 732e 2020 2020 286c 696e  nctions.    (lin
│ │ │ │ +0000da60: 6520 2031 3339 290a 2a20 7368 6973 6869  e  139).* shishi
│ │ │ │ +0000da70: 5f61 736e 315f 6b72 6265 7272 6f72 3a20  _asn1_krberror: 
│ │ │ │  0000da80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000da90: 4153 4e2e 3120 4675 6e63 7469 6f6e 732e  ASN.1 Functions.
│ │ │ │ -0000daa0: 2020 2020 286c 696e 6520 2032 3639 290a      (line  269).
│ │ │ │ -0000dab0: 2a20 7368 6973 6869 5f61 736e 315f 6b72  * shishi_asn1_kr
│ │ │ │ -0000dac0: 6273 6166 653a 2020 2020 2020 2020 2020  bsafe:          
│ │ │ │ -0000dad0: 2020 2020 2020 2020 2041 534e 2e31 2046           ASN.1 F
│ │ │ │ -0000dae0: 756e 6374 696f 6e73 2e20 2020 2028 6c69  unctions.    (li
│ │ │ │ -0000daf0: 6e65 2020 3237 3929 0a2a 2073 6869 7368  ne  279).* shish
│ │ │ │ -0000db00: 695f 6173 6e31 5f6d 6574 686f 6464 6174  i_asn1_methoddat
│ │ │ │ -0000db10: 613a 2020 2020 2020 2020 2020 2020 2020  a:              
│ │ │ │ -0000db20: 2020 4153 4e2e 3120 4675 6e63 7469 6f6e    ASN.1 Function
│ │ │ │ -0000db30: 732e 2020 2020 286c 696e 6520 2031 3139  s.    (line  119
│ │ │ │ -0000db40: 290a 2a20 7368 6973 6869 5f61 736e 315f  ).* shishi_asn1_
│ │ │ │ -0000db50: 6d73 6774 7970 653a 2020 2020 2020 2020  msgtype:        
│ │ │ │ -0000db60: 2020 2020 2020 2020 2020 2041 534e 2e31             ASN.1
│ │ │ │ -0000db70: 2046 756e 6374 696f 6e73 2e20 2020 2028   Functions.    (
│ │ │ │ -0000db80: 6c69 6e65 2020 3334 3529 0a2a 2073 6869  line  345).* shi
│ │ │ │ -0000db90: 7368 695f 6173 6e31 5f70 615f 656e 635f  shi_asn1_pa_enc_
│ │ │ │ -0000dba0: 7473 5f65 6e63 3a20 2020 2020 2020 2020  ts_enc:         
│ │ │ │ -0000dbb0: 2020 2020 4153 4e2e 3120 4675 6e63 7469      ASN.1 Functi
│ │ │ │ -0000dbc0: 6f6e 732e 2020 2020 286c 696e 6520 2020  ons.    (line   
│ │ │ │ -0000dbd0: 3839 290a 2a20 7368 6973 6869 5f61 736e  89).* shishi_asn
│ │ │ │ -0000dbe0: 315f 7061 6461 7461 3a20 2020 2020 2020  1_padata:       
│ │ │ │ -0000dbf0: 2020 2020 2020 2020 2020 2020 2041 534e               ASN
│ │ │ │ -0000dc00: 2e31 2046 756e 6374 696f 6e73 2e20 2020  .1 Functions.   
│ │ │ │ -0000dc10: 2028 6c69 6e65 2020 3130 3929 0a2a 2073   (line  109).* s
│ │ │ │ -0000dc20: 6869 7368 695f 6173 6e31 5f70 7269 6e74  hishi_asn1_print
│ │ │ │ -0000dc30: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ -0000dc40: 2020 2020 2020 4153 4e2e 3120 4675 6e63        ASN.1 Func
│ │ │ │ -0000dc50: 7469 6f6e 732e 2020 2020 286c 696e 6520  tions.    (line 
│ │ │ │ -0000dc60: 2037 3039 290a 2a20 7368 6973 6869 5f61   709).* shishi_a
│ │ │ │ -0000dc70: 736e 315f 7072 6976 3a20 2020 2020 2020  sn1_priv:       
│ │ │ │ -0000dc80: 2020 2020 2020 2020 2020 2020 2020 2041                 A
│ │ │ │ -0000dc90: 534e 2e31 2046 756e 6374 696f 6e73 2e20  SN.1 Functions. 
│ │ │ │ -0000dca0: 2020 2028 6c69 6e65 2020 3238 3929 0a2a     (line  289).*
│ │ │ │ -0000dcb0: 2073 6869 7368 695f 6173 6e31 5f72 6561   shishi_asn1_rea
│ │ │ │ -0000dcc0: 643a 2020 2020 2020 2020 2020 2020 2020  d:              
│ │ │ │ -0000dcd0: 2020 2020 2020 2020 4153 4e2e 3120 4675          ASN.1 Fu
│ │ │ │ -0000dce0: 6e63 7469 6f6e 732e 2020 2020 286c 696e  nctions.    (lin
│ │ │ │ -0000dcf0: 6520 2020 3334 290a 2a20 7368 6973 6869  e   34).* shishi
│ │ │ │ -0000dd00: 5f61 736e 315f 7265 6164 5f69 6e6c 696e  _asn1_read_inlin
│ │ │ │ -0000dd10: 653a 2020 2020 2020 2020 2020 2020 2020  e:              
│ │ │ │ -0000dd20: 2041 534e 2e31 2046 756e 6374 696f 6e73   ASN.1 Functions
│ │ │ │ -0000dd30: 2e20 2020 2028 6c69 6e65 2020 2020 3929  .    (line    9)
│ │ │ │ -0000dd40: 0a2a 2073 6869 7368 695f 6173 6e31 5f72  .* shishi_asn1_r
│ │ │ │ -0000dd50: 6561 645f 6f70 7469 6f6e 616c 3a20 2020  ead_optional:   
│ │ │ │ -0000dd60: 2020 2020 2020 2020 2020 4153 4e2e 3120            ASN.1 
│ │ │ │ -0000dd70: 4675 6e63 7469 6f6e 732e 2020 2020 286c  Functions.    (l
│ │ │ │ -0000dd80: 696e 6520 2020 3535 290a 2a20 7368 6973  ine   55).* shis
│ │ │ │ -0000dd90: 6869 5f61 736e 315f 7467 7372 6570 3a20  hi_asn1_tgsrep: 
│ │ │ │ +0000da90: 2041 534e 2e31 2046 756e 6374 696f 6e73   ASN.1 Functions
│ │ │ │ +0000daa0: 2e20 2020 2028 6c69 6e65 2020 3236 3929  .    (line  269)
│ │ │ │ +0000dab0: 0a2a 2073 6869 7368 695f 6173 6e31 5f6b  .* shishi_asn1_k
│ │ │ │ +0000dac0: 7262 7361 6665 3a20 2020 2020 2020 2020  rbsafe:         
│ │ │ │ +0000dad0: 2020 2020 2020 2020 2020 4153 4e2e 3120            ASN.1 
│ │ │ │ +0000dae0: 4675 6e63 7469 6f6e 732e 2020 2020 286c  Functions.    (l
│ │ │ │ +0000daf0: 696e 6520 2032 3739 290a 2a20 7368 6973  ine  279).* shis
│ │ │ │ +0000db00: 6869 5f61 736e 315f 6d65 7468 6f64 6461  hi_asn1_methodda
│ │ │ │ +0000db10: 7461 3a20 2020 2020 2020 2020 2020 2020  ta:             
│ │ │ │ +0000db20: 2020 2041 534e 2e31 2046 756e 6374 696f     ASN.1 Functio
│ │ │ │ +0000db30: 6e73 2e20 2020 2028 6c69 6e65 2020 3131  ns.    (line  11
│ │ │ │ +0000db40: 3929 0a2a 2073 6869 7368 695f 6173 6e31  9).* shishi_asn1
│ │ │ │ +0000db50: 5f6d 7367 7479 7065 3a20 2020 2020 2020  _msgtype:       
│ │ │ │ +0000db60: 2020 2020 2020 2020 2020 2020 4153 4e2e              ASN.
│ │ │ │ +0000db70: 3120 4675 6e63 7469 6f6e 732e 2020 2020  1 Functions.    
│ │ │ │ +0000db80: 286c 696e 6520 2033 3435 290a 2a20 7368  (line  345).* sh
│ │ │ │ +0000db90: 6973 6869 5f61 736e 315f 7061 5f65 6e63  ishi_asn1_pa_enc
│ │ │ │ +0000dba0: 5f74 735f 656e 633a 2020 2020 2020 2020  _ts_enc:        
│ │ │ │ +0000dbb0: 2020 2020 2041 534e 2e31 2046 756e 6374       ASN.1 Funct
│ │ │ │ +0000dbc0: 696f 6e73 2e20 2020 2028 6c69 6e65 2020  ions.    (line  
│ │ │ │ +0000dbd0: 2038 3929 0a2a 2073 6869 7368 695f 6173   89).* shishi_as
│ │ │ │ +0000dbe0: 6e31 5f70 6164 6174 613a 2020 2020 2020  n1_padata:      
│ │ │ │ +0000dbf0: 2020 2020 2020 2020 2020 2020 2020 4153                AS
│ │ │ │ +0000dc00: 4e2e 3120 4675 6e63 7469 6f6e 732e 2020  N.1 Functions.  
│ │ │ │ +0000dc10: 2020 286c 696e 6520 2031 3039 290a 2a20    (line  109).* 
│ │ │ │ +0000dc20: 7368 6973 6869 5f61 736e 315f 7072 696e  shishi_asn1_prin
│ │ │ │ +0000dc30: 743a 2020 2020 2020 2020 2020 2020 2020  t:              
│ │ │ │ +0000dc40: 2020 2020 2020 2041 534e 2e31 2046 756e         ASN.1 Fun
│ │ │ │ +0000dc50: 6374 696f 6e73 2e20 2020 2028 6c69 6e65  ctions.    (line
│ │ │ │ +0000dc60: 2020 3730 3929 0a2a 2073 6869 7368 695f    709).* shishi_
│ │ │ │ +0000dc70: 6173 6e31 5f70 7269 763a 2020 2020 2020  asn1_priv:      
│ │ │ │ +0000dc80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0000dc90: 4153 4e2e 3120 4675 6e63 7469 6f6e 732e  ASN.1 Functions.
│ │ │ │ +0000dca0: 2020 2020 286c 696e 6520 2032 3839 290a      (line  289).
│ │ │ │ +0000dcb0: 2a20 7368 6973 6869 5f61 736e 315f 7265  * shishi_asn1_re
│ │ │ │ +0000dcc0: 6164 3a20 2020 2020 2020 2020 2020 2020  ad:             
│ │ │ │ +0000dcd0: 2020 2020 2020 2020 2041 534e 2e31 2046           ASN.1 F
│ │ │ │ +0000dce0: 756e 6374 696f 6e73 2e20 2020 2028 6c69  unctions.    (li
│ │ │ │ +0000dcf0: 6e65 2020 2033 3429 0a2a 2073 6869 7368  ne   34).* shish
│ │ │ │ +0000dd00: 695f 6173 6e31 5f72 6561 645f 696e 6c69  i_asn1_read_inli
│ │ │ │ +0000dd10: 6e65 3a20 2020 2020 2020 2020 2020 2020  ne:             
│ │ │ │ +0000dd20: 2020 4153 4e2e 3120 4675 6e63 7469 6f6e    ASN.1 Function
│ │ │ │ +0000dd30: 732e 2020 2020 286c 696e 6520 2020 2039  s.    (line    9
│ │ │ │ +0000dd40: 290a 2a20 7368 6973 6869 5f61 736e 315f  ).* shishi_asn1_
│ │ │ │ +0000dd50: 7265 6164 5f6f 7074 696f 6e61 6c3a 2020  read_optional:  
│ │ │ │ +0000dd60: 2020 2020 2020 2020 2020 2041 534e 2e31             ASN.1
│ │ │ │ +0000dd70: 2046 756e 6374 696f 6e73 2e20 2020 2028   Functions.    (
│ │ │ │ +0000dd80: 6c69 6e65 2020 2035 3529 0a2a 2073 6869  line   55).* shi
│ │ │ │ +0000dd90: 7368 695f 6173 6e31 5f74 6773 7265 703a  shi_asn1_tgsrep:
│ │ │ │  0000dda0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000ddb0: 2020 2041 534e 2e31 2046 756e 6374 696f     ASN.1 Functio
│ │ │ │ -0000ddc0: 6e73 2e20 2020 2028 6c69 6e65 2020 3137  ns.    (line  17
│ │ │ │ -0000ddd0: 3929 0a2a 2073 6869 7368 695f 6173 6e31  9).* shishi_asn1
│ │ │ │ -0000dde0: 5f74 6773 7265 713a 2020 2020 2020 2020  _tgsreq:        
│ │ │ │ -0000ddf0: 2020 2020 2020 2020 2020 2020 4153 4e2e              ASN.
│ │ │ │ -0000de00: 3120 4675 6e63 7469 6f6e 732e 2020 2020  1 Functions.    
│ │ │ │ -0000de10: 286c 696e 6520 2031 3639 290a 2a20 7368  (line  169).* sh
│ │ │ │ -0000de20: 6973 6869 5f61 736e 315f 7469 636b 6574  ishi_asn1_ticket
│ │ │ │ -0000de30: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ -0000de40: 2020 2020 2041 534e 2e31 2046 756e 6374       ASN.1 Funct
│ │ │ │ -0000de50: 696f 6e73 2e20 2020 2028 6c69 6e65 2020  ions.    (line  
│ │ │ │ -0000de60: 3231 3929 0a2a 2073 6869 7368 695f 6173  219).* shishi_as
│ │ │ │ -0000de70: 6e31 5f74 6f5f 6465 723a 2020 2020 2020  n1_to_der:      
│ │ │ │ -0000de80: 2020 2020 2020 2020 2020 2020 2020 4153                AS
│ │ │ │ -0000de90: 4e2e 3120 4675 6e63 7469 6f6e 732e 2020  N.1 Functions.  
│ │ │ │ -0000dea0: 2020 286c 696e 6520 2033 3238 290a 2a20    (line  328).* 
│ │ │ │ -0000deb0: 7368 6973 6869 5f61 736e 315f 746f 5f64  shishi_asn1_to_d
│ │ │ │ -0000dec0: 6572 5f66 6965 6c64 3a20 2020 2020 2020  er_field:       
│ │ │ │ -0000ded0: 2020 2020 2020 2041 534e 2e31 2046 756e         ASN.1 Fun
│ │ │ │ -0000dee0: 6374 696f 6e73 2e20 2020 2028 6c69 6e65  ctions.    (line
│ │ │ │ -0000def0: 2020 3330 3929 0a2a 2073 6869 7368 695f    309).* shishi_
│ │ │ │ -0000df00: 6173 7265 703a 2020 2020 2020 2020 2020  asrep:          
│ │ │ │ +0000ddb0: 2020 2020 4153 4e2e 3120 4675 6e63 7469      ASN.1 Functi
│ │ │ │ +0000ddc0: 6f6e 732e 2020 2020 286c 696e 6520 2031  ons.    (line  1
│ │ │ │ +0000ddd0: 3739 290a 2a20 7368 6973 6869 5f61 736e  79).* shishi_asn
│ │ │ │ +0000dde0: 315f 7467 7372 6571 3a20 2020 2020 2020  1_tgsreq:       
│ │ │ │ +0000ddf0: 2020 2020 2020 2020 2020 2020 2041 534e               ASN
│ │ │ │ +0000de00: 2e31 2046 756e 6374 696f 6e73 2e20 2020  .1 Functions.   
│ │ │ │ +0000de10: 2028 6c69 6e65 2020 3136 3929 0a2a 2073   (line  169).* s
│ │ │ │ +0000de20: 6869 7368 695f 6173 6e31 5f74 6963 6b65  hishi_asn1_ticke
│ │ │ │ +0000de30: 743a 2020 2020 2020 2020 2020 2020 2020  t:              
│ │ │ │ +0000de40: 2020 2020 2020 4153 4e2e 3120 4675 6e63        ASN.1 Func
│ │ │ │ +0000de50: 7469 6f6e 732e 2020 2020 286c 696e 6520  tions.    (line 
│ │ │ │ +0000de60: 2032 3139 290a 2a20 7368 6973 6869 5f61   219).* shishi_a
│ │ │ │ +0000de70: 736e 315f 746f 5f64 6572 3a20 2020 2020  sn1_to_der:     
│ │ │ │ +0000de80: 2020 2020 2020 2020 2020 2020 2020 2041                 A
│ │ │ │ +0000de90: 534e 2e31 2046 756e 6374 696f 6e73 2e20  SN.1 Functions. 
│ │ │ │ +0000dea0: 2020 2028 6c69 6e65 2020 3332 3829 0a2a     (line  328).*
│ │ │ │ +0000deb0: 2073 6869 7368 695f 6173 6e31 5f74 6f5f   shishi_asn1_to_
│ │ │ │ +0000dec0: 6465 725f 6669 656c 643a 2020 2020 2020  der_field:      
│ │ │ │ +0000ded0: 2020 2020 2020 2020 4153 4e2e 3120 4675          ASN.1 Fu
│ │ │ │ +0000dee0: 6e63 7469 6f6e 732e 2020 2020 286c 696e  nctions.    (lin
│ │ │ │ +0000def0: 6520 2033 3039 290a 2a20 7368 6973 6869  e  309).* shishi
│ │ │ │ +0000df00: 5f61 7372 6570 3a20 2020 2020 2020 2020  _asrep:         
│ │ │ │  0000df10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000df20: 4153 2f54 4753 2046 756e 6374 696f 6e73  AS/TGS Functions
│ │ │ │ -0000df30: 2e20 2020 286c 696e 6520 3130 3132 290a  .   (line 1012).
│ │ │ │ -0000df40: 2a20 7368 6973 6869 5f61 7372 6571 3a20  * shishi_asreq: 
│ │ │ │ +0000df20: 2041 532f 5447 5320 4675 6e63 7469 6f6e   AS/TGS Function
│ │ │ │ +0000df30: 732e 2020 2028 6c69 6e65 2031 3031 3229  s.   (line 1012)
│ │ │ │ +0000df40: 0a2a 2073 6869 7368 695f 6173 7265 713a  .* shishi_asreq:
│ │ │ │  0000df50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000df60: 2020 2020 2020 2020 2041 532f 5447 5320           AS/TGS 
│ │ │ │ -0000df70: 4675 6e63 7469 6f6e 732e 2020 2028 6c69  Functions.   (li
│ │ │ │ -0000df80: 6e65 2020 3332 3929 0a2a 2073 6869 7368  ne  329).* shish
│ │ │ │ -0000df90: 695f 6173 7265 715f 636c 6965 6e74 7265  i_asreq_clientre
│ │ │ │ -0000dfa0: 616c 6d3a 2020 2020 2020 2020 2020 2020  alm:            
│ │ │ │ -0000dfb0: 2020 4153 2f54 4753 2046 756e 6374 696f    AS/TGS Functio
│ │ │ │ -0000dfc0: 6e73 2e20 2020 286c 696e 6520 2034 3836  ns.   (line  486
│ │ │ │ -0000dfd0: 290a 2a20 7368 6973 6869 5f61 7574 6865  ).* shishi_authe
│ │ │ │ -0000dfe0: 6e74 6963 6174 6f72 3a20 2020 2020 2020  nticator:       
│ │ │ │ -0000dff0: 2020 2020 2020 2020 2020 2041 7574 6865             Authe
│ │ │ │ -0000e000: 6e74 6963 6174 6f72 2046 756e 6374 696f  nticator Functio
│ │ │ │ -0000e010: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │ +0000df60: 2020 2020 2020 2020 2020 4153 2f54 4753            AS/TGS
│ │ │ │ +0000df70: 2046 756e 6374 696f 6e73 2e20 2020 286c   Functions.   (l
│ │ │ │ +0000df80: 696e 6520 2033 3239 290a 2a20 7368 6973  ine  329).* shis
│ │ │ │ +0000df90: 6869 5f61 7372 6571 5f63 6c69 656e 7472  hi_asreq_clientr
│ │ │ │ +0000dfa0: 6561 6c6d 3a20 2020 2020 2020 2020 2020  ealm:           
│ │ │ │ +0000dfb0: 2020 2041 532f 5447 5320 4675 6e63 7469     AS/TGS Functi
│ │ │ │ +0000dfc0: 6f6e 732e 2020 2028 6c69 6e65 2020 3438  ons.   (line  48
│ │ │ │ +0000dfd0: 3629 0a2a 2073 6869 7368 695f 6175 7468  6).* shishi_auth
│ │ │ │ +0000dfe0: 656e 7469 6361 746f 723a 2020 2020 2020  enticator:      
│ │ │ │ +0000dff0: 2020 2020 2020 2020 2020 2020 4175 7468              Auth
│ │ │ │ +0000e000: 656e 7469 6361 746f 7220 4675 6e63 7469  enticator Functi
│ │ │ │ +0000e010: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │  0000e020: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000e030: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000e040: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000e050: 2028 6c69 6e65 2020 2032 3729 0a2a 2073   (line   27).* s
│ │ │ │ -0000e060: 6869 7368 695f 6175 7468 656e 7469 6361  hishi_authentica
│ │ │ │ -0000e070: 746f 725f 6164 645f 6175 7468 6f72 697a  tor_add_authoriz
│ │ │ │ -0000e080: 6174 696f 6e64 6174 613a 2041 7574 6865  ationdata: Authe
│ │ │ │ -0000e090: 6e74 6963 6174 6f72 2046 756e 6374 696f  nticator Functio
│ │ │ │ -0000e0a0: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │ +0000e050: 2020 286c 696e 6520 2020 3237 290a 2a20    (line   27).* 
│ │ │ │ +0000e060: 7368 6973 6869 5f61 7574 6865 6e74 6963  shishi_authentic
│ │ │ │ +0000e070: 6174 6f72 5f61 6464 5f61 7574 686f 7269  ator_add_authori
│ │ │ │ +0000e080: 7a61 7469 6f6e 6461 7461 3a20 4175 7468  zationdata: Auth
│ │ │ │ +0000e090: 656e 7469 6361 746f 7220 4675 6e63 7469  enticator Functi
│ │ │ │ +0000e0a0: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │  0000e0b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000e0c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000e0d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000e0e0: 2028 6c69 6e65 2020 3432 3729 0a2a 2073   (line  427).* s
│ │ │ │ -0000e0f0: 6869 7368 695f 6175 7468 656e 7469 6361  hishi_authentica
│ │ │ │ -0000e100: 746f 725f 6164 645f 636b 7375 6d3a 2020  tor_add_cksum:  
│ │ │ │ -0000e110: 2020 2020 2020 4175 7468 656e 7469 6361        Authentica
│ │ │ │ -0000e120: 746f 7220 4675 6e63 7469 6f6e 732e 0a20  tor Functions.. 
│ │ │ │ +0000e0e0: 2020 286c 696e 6520 2034 3237 290a 2a20    (line  427).* 
│ │ │ │ +0000e0f0: 7368 6973 6869 5f61 7574 6865 6e74 6963  shishi_authentic
│ │ │ │ +0000e100: 6174 6f72 5f61 6464 5f63 6b73 756d 3a20  ator_add_cksum: 
│ │ │ │ +0000e110: 2020 2020 2020 2041 7574 6865 6e74 6963         Authentic
│ │ │ │ +0000e120: 6174 6f72 2046 756e 6374 696f 6e73 2e0a  ator Functions..
│ │ │ │  0000e130: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000e140: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000e150: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000e160: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ -0000e170: 6520 2033 3734 290a 2a20 7368 6973 6869  e  374).* shishi
│ │ │ │ -0000e180: 5f61 7574 6865 6e74 6963 6174 6f72 5f61  _authenticator_a
│ │ │ │ -0000e190: 6464 5f63 6b73 756d 5f74 7970 653a 2020  dd_cksum_type:  
│ │ │ │ -0000e1a0: 2041 7574 6865 6e74 6963 6174 6f72 2046   Authenticator F
│ │ │ │ -0000e1b0: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │ +0000e160: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ +0000e170: 6e65 2020 3337 3429 0a2a 2073 6869 7368  ne  374).* shish
│ │ │ │ +0000e180: 695f 6175 7468 656e 7469 6361 746f 725f  i_authenticator_
│ │ │ │ +0000e190: 6164 645f 636b 7375 6d5f 7479 7065 3a20  add_cksum_type: 
│ │ │ │ +0000e1a0: 2020 4175 7468 656e 7469 6361 746f 7220    Authenticator 
│ │ │ │ +0000e1b0: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │  0000e1c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000e1d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000e1e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000e1f0: 2020 2020 2020 2028 6c69 6e65 2020 3339         (line  39
│ │ │ │ -0000e200: 3329 0a2a 2073 6869 7368 695f 6175 7468  3).* shishi_auth
│ │ │ │ -0000e210: 656e 7469 6361 746f 725f 6164 645f 7261  enticator_add_ra
│ │ │ │ -0000e220: 6e64 6f6d 5f73 7562 6b65 793a 2041 7574  ndom_subkey: Aut
│ │ │ │ -0000e230: 6865 6e74 6963 6174 6f72 2046 756e 6374  henticator Funct
│ │ │ │ -0000e240: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │ +0000e1f0: 2020 2020 2020 2020 286c 696e 6520 2033          (line  3
│ │ │ │ +0000e200: 3933 290a 2a20 7368 6973 6869 5f61 7574  93).* shishi_aut
│ │ │ │ +0000e210: 6865 6e74 6963 6174 6f72 5f61 6464 5f72  henticator_add_r
│ │ │ │ +0000e220: 616e 646f 6d5f 7375 626b 6579 3a20 4175  andom_subkey: Au
│ │ │ │ +0000e230: 7468 656e 7469 6361 746f 7220 4675 6e63  thenticator Func
│ │ │ │ +0000e240: 7469 6f6e 732e 0a20 2020 2020 2020 2020  tions..         
│ │ │ │  0000e250: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000e260: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000e270: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000e280: 2020 2028 6c69 6e65 2020 3531 3429 0a2a     (line  514).*
│ │ │ │ -0000e290: 2073 6869 7368 695f 6175 7468 656e 7469   shishi_authenti
│ │ │ │ -0000e2a0: 6361 746f 725f 6164 645f 7261 6e64 6f6d  cator_add_random
│ │ │ │ -0000e2b0: 5f73 7562 6b65 795f 6574 7970 653a 2041  _subkey_etype: A
│ │ │ │ -0000e2c0: 7574 6865 6e74 6963 6174 6f72 2046 756e  uthenticator Fun
│ │ │ │ -0000e2d0: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │ +0000e280: 2020 2020 286c 696e 6520 2035 3134 290a      (line  514).
│ │ │ │ +0000e290: 2a20 7368 6973 6869 5f61 7574 6865 6e74  * shishi_authent
│ │ │ │ +0000e2a0: 6963 6174 6f72 5f61 6464 5f72 616e 646f  icator_add_rando
│ │ │ │ +0000e2b0: 6d5f 7375 626b 6579 5f65 7479 7065 3a20  m_subkey_etype: 
│ │ │ │ +0000e2c0: 4175 7468 656e 7469 6361 746f 7220 4675  Authenticator Fu
│ │ │ │ +0000e2d0: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │  0000e2e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000e2f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000e300: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000e310: 2020 2020 2028 6c69 6e65 2020 3532 3829       (line  528)
│ │ │ │ -0000e320: 0a2a 2073 6869 7368 695f 6175 7468 656e  .* shishi_authen
│ │ │ │ -0000e330: 7469 6361 746f 725f 6164 645f 7375 626b  ticator_add_subk
│ │ │ │ -0000e340: 6579 3a20 2020 2020 2020 4175 7468 656e  ey:       Authen
│ │ │ │ -0000e350: 7469 6361 746f 7220 4675 6e63 7469 6f6e  ticator Function
│ │ │ │ -0000e360: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │ +0000e310: 2020 2020 2020 286c 696e 6520 2035 3238        (line  528
│ │ │ │ +0000e320: 290a 2a20 7368 6973 6869 5f61 7574 6865  ).* shishi_authe
│ │ │ │ +0000e330: 6e74 6963 6174 6f72 5f61 6464 5f73 7562  nticator_add_sub
│ │ │ │ +0000e340: 6b65 793a 2020 2020 2020 2041 7574 6865  key:       Authe
│ │ │ │ +0000e350: 6e74 6963 6174 6f72 2046 756e 6374 696f  nticator Functio
│ │ │ │ +0000e360: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │  0000e370: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000e380: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000e390: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000e3a0: 286c 696e 6520 2035 3433 290a 2a20 7368  (line  543).* sh
│ │ │ │ -0000e3b0: 6973 6869 5f61 7574 6865 6e74 6963 6174  ishi_authenticat
│ │ │ │ -0000e3c0: 6f72 5f61 7574 686f 7269 7a61 7469 6f6e  or_authorization
│ │ │ │ -0000e3d0: 6461 7461 3a20 4175 7468 656e 7469 6361  data: Authentica
│ │ │ │ -0000e3e0: 746f 7220 4675 6e63 7469 6f6e 732e 0a20  tor Functions.. 
│ │ │ │ +0000e3a0: 2028 6c69 6e65 2020 3534 3329 0a2a 2073   (line  543).* s
│ │ │ │ +0000e3b0: 6869 7368 695f 6175 7468 656e 7469 6361  hishi_authentica
│ │ │ │ +0000e3c0: 746f 725f 6175 7468 6f72 697a 6174 696f  tor_authorizatio
│ │ │ │ +0000e3d0: 6e64 6174 613a 2041 7574 6865 6e74 6963  ndata: Authentic
│ │ │ │ +0000e3e0: 6174 6f72 2046 756e 6374 696f 6e73 2e0a  ator Functions..
│ │ │ │  0000e3f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000e400: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000e410: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000e420: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ -0000e430: 6520 2034 3434 290a 2a20 7368 6973 6869  e  444).* shishi
│ │ │ │ -0000e440: 5f61 7574 6865 6e74 6963 6174 6f72 5f63  _authenticator_c
│ │ │ │ -0000e450: 6b73 756d 3a20 2020 2020 2020 2020 2020  ksum:           
│ │ │ │ -0000e460: 2041 7574 6865 6e74 6963 6174 6f72 2046   Authenticator F
│ │ │ │ -0000e470: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │ +0000e420: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ +0000e430: 6e65 2020 3434 3429 0a2a 2073 6869 7368  ne  444).* shish
│ │ │ │ +0000e440: 695f 6175 7468 656e 7469 6361 746f 725f  i_authenticator_
│ │ │ │ +0000e450: 636b 7375 6d3a 2020 2020 2020 2020 2020  cksum:          
│ │ │ │ +0000e460: 2020 4175 7468 656e 7469 6361 746f 7220    Authenticator 
│ │ │ │ +0000e470: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │  0000e480: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000e490: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000e4a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000e4b0: 2020 2020 2020 2028 6c69 6e65 2020 3333         (line  33
│ │ │ │ -0000e4c0: 3229 0a2a 2073 6869 7368 695f 6175 7468  2).* shishi_auth
│ │ │ │ -0000e4d0: 656e 7469 6361 746f 725f 636c 6561 725f  enticator_clear_
│ │ │ │ -0000e4e0: 6175 7468 6f72 697a 6174 696f 6e64 6174  authorizationdat
│ │ │ │ -0000e4f0: 613a 2041 7574 6865 6e74 6963 6174 6f72  a: Authenticator
│ │ │ │ -0000e500: 2046 756e 6374 696f 6e73 2e0a 2020 2020   Functions..    
│ │ │ │ +0000e4b0: 2020 2020 2020 2020 286c 696e 6520 2033          (line  3
│ │ │ │ +0000e4c0: 3332 290a 2a20 7368 6973 6869 5f61 7574  32).* shishi_aut
│ │ │ │ +0000e4d0: 6865 6e74 6963 6174 6f72 5f63 6c65 6172  henticator_clear
│ │ │ │ +0000e4e0: 5f61 7574 686f 7269 7a61 7469 6f6e 6461  _authorizationda
│ │ │ │ +0000e4f0: 7461 3a20 4175 7468 656e 7469 6361 746f  ta: Authenticato
│ │ │ │ +0000e500: 7220 4675 6e63 7469 6f6e 732e 0a20 2020  r Functions..   
│ │ │ │  0000e510: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000e520: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000e530: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000e540: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ -0000e550: 3431 3329 0a2a 2073 6869 7368 695f 6175  413).* shishi_au
│ │ │ │ -0000e560: 7468 656e 7469 6361 746f 725f 636c 6965  thenticator_clie
│ │ │ │ -0000e570: 6e74 3a20 2020 2020 2020 2020 2020 4175  nt:           Au
│ │ │ │ -0000e580: 7468 656e 7469 6361 746f 7220 4675 6e63  thenticator Func
│ │ │ │ -0000e590: 7469 6f6e 732e 0a20 2020 2020 2020 2020  tions..         
│ │ │ │ +0000e540: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ +0000e550: 2034 3133 290a 2a20 7368 6973 6869 5f61   413).* shishi_a
│ │ │ │ +0000e560: 7574 6865 6e74 6963 6174 6f72 5f63 6c69  uthenticator_cli
│ │ │ │ +0000e570: 656e 743a 2020 2020 2020 2020 2020 2041  ent:           A
│ │ │ │ +0000e580: 7574 6865 6e74 6963 6174 6f72 2046 756e  uthenticator Fun
│ │ │ │ +0000e590: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │  0000e5a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000e5b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000e5c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000e5d0: 2020 2020 286c 696e 6520 2032 3839 290a      (line  289).
│ │ │ │ -0000e5e0: 2a20 7368 6973 6869 5f61 7574 6865 6e74  * shishi_authent
│ │ │ │ -0000e5f0: 6963 6174 6f72 5f63 6c69 656e 745f 7365  icator_client_se
│ │ │ │ -0000e600: 743a 2020 2020 2020 2041 7574 6865 6e74  t:       Authent
│ │ │ │ -0000e610: 6963 6174 6f72 2046 756e 6374 696f 6e73  icator Functions
│ │ │ │ -0000e620: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │ +0000e5d0: 2020 2020 2028 6c69 6e65 2020 3238 3929       (line  289)
│ │ │ │ +0000e5e0: 0a2a 2073 6869 7368 695f 6175 7468 656e  .* shishi_authen
│ │ │ │ +0000e5f0: 7469 6361 746f 725f 636c 6965 6e74 5f73  ticator_client_s
│ │ │ │ +0000e600: 6574 3a20 2020 2020 2020 4175 7468 656e  et:       Authen
│ │ │ │ +0000e610: 7469 6361 746f 7220 4675 6e63 7469 6f6e  ticator Function
│ │ │ │ +0000e620: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │  0000e630: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000e640: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000e650: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ -0000e660: 6c69 6e65 2020 3137 3529 0a2a 2073 6869  line  175).* shi
│ │ │ │ -0000e670: 7368 695f 6175 7468 656e 7469 6361 746f  shi_authenticato
│ │ │ │ -0000e680: 725f 636c 6965 6e74 7265 616c 6d3a 2020  r_clientrealm:  
│ │ │ │ -0000e690: 2020 2020 4175 7468 656e 7469 6361 746f      Authenticato
│ │ │ │ -0000e6a0: 7220 4675 6e63 7469 6f6e 732e 0a20 2020  r Functions..   
│ │ │ │ +0000e650: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0000e660: 286c 696e 6520 2031 3735 290a 2a20 7368  (line  175).* sh
│ │ │ │ +0000e670: 6973 6869 5f61 7574 6865 6e74 6963 6174  ishi_authenticat
│ │ │ │ +0000e680: 6f72 5f63 6c69 656e 7472 6561 6c6d 3a20  or_clientrealm: 
│ │ │ │ +0000e690: 2020 2020 2041 7574 6865 6e74 6963 6174       Authenticat
│ │ │ │ +0000e6a0: 6f72 2046 756e 6374 696f 6e73 2e0a 2020  or Functions..  
│ │ │ │  0000e6b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000e6c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000e6d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000e6e0: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ -0000e6f0: 2033 3130 290a 2a20 7368 6973 6869 5f61   310).* shishi_a
│ │ │ │ -0000e700: 7574 6865 6e74 6963 6174 6f72 5f63 7469  uthenticator_cti
│ │ │ │ -0000e710: 6d65 3a20 2020 2020 2020 2020 2020 2041  me:            A
│ │ │ │ -0000e720: 7574 6865 6e74 6963 6174 6f72 2046 756e  uthenticator Fun
│ │ │ │ -0000e730: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │ +0000e6e0: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ +0000e6f0: 2020 3331 3029 0a2a 2073 6869 7368 695f    310).* shishi_
│ │ │ │ +0000e700: 6175 7468 656e 7469 6361 746f 725f 6374  authenticator_ct
│ │ │ │ +0000e710: 696d 653a 2020 2020 2020 2020 2020 2020  ime:            
│ │ │ │ +0000e720: 4175 7468 656e 7469 6361 746f 7220 4675  Authenticator Fu
│ │ │ │ +0000e730: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │  0000e740: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000e750: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000e760: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000e770: 2020 2020 2028 6c69 6e65 2020 3138 3929       (line  189)
│ │ │ │ -0000e780: 0a2a 2073 6869 7368 695f 6175 7468 656e  .* shishi_authen
│ │ │ │ -0000e790: 7469 6361 746f 725f 6374 696d 655f 7365  ticator_ctime_se
│ │ │ │ -0000e7a0: 743a 2020 2020 2020 2020 4175 7468 656e  t:        Authen
│ │ │ │ -0000e7b0: 7469 6361 746f 7220 4675 6e63 7469 6f6e  ticator Function
│ │ │ │ -0000e7c0: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │ +0000e770: 2020 2020 2020 286c 696e 6520 2031 3839        (line  189
│ │ │ │ +0000e780: 290a 2a20 7368 6973 6869 5f61 7574 6865  ).* shishi_authe
│ │ │ │ +0000e790: 6e74 6963 6174 6f72 5f63 7469 6d65 5f73  nticator_ctime_s
│ │ │ │ +0000e7a0: 6574 3a20 2020 2020 2020 2041 7574 6865  et:        Authe
│ │ │ │ +0000e7b0: 6e74 6963 6174 6f72 2046 756e 6374 696f  nticator Functio
│ │ │ │ +0000e7c0: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │  0000e7d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000e7e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000e7f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000e800: 286c 696e 6520 2032 3034 290a 2a20 7368  (line  204).* sh
│ │ │ │ -0000e810: 6973 6869 5f61 7574 6865 6e74 6963 6174  ishi_authenticat
│ │ │ │ -0000e820: 6f72 5f63 7573 6563 5f67 6574 3a20 2020  or_cusec_get:   
│ │ │ │ -0000e830: 2020 2020 2041 7574 6865 6e74 6963 6174       Authenticat
│ │ │ │ -0000e840: 6f72 2046 756e 6374 696f 6e73 2e0a 2020  or Functions..  
│ │ │ │ +0000e800: 2028 6c69 6e65 2020 3230 3429 0a2a 2073   (line  204).* s
│ │ │ │ +0000e810: 6869 7368 695f 6175 7468 656e 7469 6361  hishi_authentica
│ │ │ │ +0000e820: 746f 725f 6375 7365 635f 6765 743a 2020  tor_cusec_get:  
│ │ │ │ +0000e830: 2020 2020 2020 4175 7468 656e 7469 6361        Authentica
│ │ │ │ +0000e840: 746f 7220 4675 6e63 7469 6f6e 732e 0a20  tor Functions.. 
│ │ │ │  0000e850: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000e860: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000e870: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000e880: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ -0000e890: 2020 3231 3829 0a2a 2073 6869 7368 695f    218).* shishi_
│ │ │ │ -0000e8a0: 6175 7468 656e 7469 6361 746f 725f 6375  authenticator_cu
│ │ │ │ -0000e8b0: 7365 635f 7365 743a 2020 2020 2020 2020  sec_set:        
│ │ │ │ -0000e8c0: 4175 7468 656e 7469 6361 746f 7220 4675  Authenticator Fu
│ │ │ │ -0000e8d0: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │ +0000e880: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ +0000e890: 6520 2032 3138 290a 2a20 7368 6973 6869  e  218).* shishi
│ │ │ │ +0000e8a0: 5f61 7574 6865 6e74 6963 6174 6f72 5f63  _authenticator_c
│ │ │ │ +0000e8b0: 7573 6563 5f73 6574 3a20 2020 2020 2020  usec_set:       
│ │ │ │ +0000e8c0: 2041 7574 6865 6e74 6963 6174 6f72 2046   Authenticator F
│ │ │ │ +0000e8d0: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │  0000e8e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000e8f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000e900: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000e910: 2020 2020 2020 286c 696e 6520 2032 3333        (line  233
│ │ │ │ -0000e920: 290a 2a20 7368 6973 6869 5f61 7574 6865  ).* shishi_authe
│ │ │ │ -0000e930: 6e74 6963 6174 6f72 5f66 726f 6d5f 6669  nticator_from_fi
│ │ │ │ -0000e940: 6c65 3a20 2020 2020 2020 2041 7574 6865  le:        Authe
│ │ │ │ -0000e950: 6e74 6963 6174 6f72 2046 756e 6374 696f  nticator Functio
│ │ │ │ -0000e960: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │ +0000e910: 2020 2020 2020 2028 6c69 6e65 2020 3233         (line  23
│ │ │ │ +0000e920: 3329 0a2a 2073 6869 7368 695f 6175 7468  3).* shishi_auth
│ │ │ │ +0000e930: 656e 7469 6361 746f 725f 6672 6f6d 5f66  enticator_from_f
│ │ │ │ +0000e940: 696c 653a 2020 2020 2020 2020 4175 7468  ile:        Auth
│ │ │ │ +0000e950: 656e 7469 6361 746f 7220 4675 6e63 7469  enticator Functi
│ │ │ │ +0000e960: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │  0000e970: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000e980: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000e990: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000e9a0: 2028 6c69 6e65 2020 3132 3629 0a2a 2073   (line  126).* s
│ │ │ │ -0000e9b0: 6869 7368 695f 6175 7468 656e 7469 6361  hishi_authentica
│ │ │ │ -0000e9c0: 746f 725f 6765 745f 7375 626b 6579 3a20  tor_get_subkey: 
│ │ │ │ -0000e9d0: 2020 2020 2020 4175 7468 656e 7469 6361        Authentica
│ │ │ │ -0000e9e0: 746f 7220 4675 6e63 7469 6f6e 732e 0a20  tor Functions.. 
│ │ │ │ +0000e9a0: 2020 286c 696e 6520 2031 3236 290a 2a20    (line  126).* 
│ │ │ │ +0000e9b0: 7368 6973 6869 5f61 7574 6865 6e74 6963  shishi_authentic
│ │ │ │ +0000e9c0: 6174 6f72 5f67 6574 5f73 7562 6b65 793a  ator_get_subkey:
│ │ │ │ +0000e9d0: 2020 2020 2020 2041 7574 6865 6e74 6963         Authentic
│ │ │ │ +0000e9e0: 6174 6f72 2046 756e 6374 696f 6e73 2e0a  ator Functions..
│ │ │ │  0000e9f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000ea00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000ea10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000ea20: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ -0000ea30: 6520 2034 3737 290a 2a20 7368 6973 6869  e  477).* shishi
│ │ │ │ -0000ea40: 5f61 7574 6865 6e74 6963 6174 6f72 5f70  _authenticator_p
│ │ │ │ -0000ea50: 6172 7365 3a20 2020 2020 2020 2020 2020  arse:           
│ │ │ │ -0000ea60: 2041 7574 6865 6e74 6963 6174 6f72 2046   Authenticator F
│ │ │ │ -0000ea70: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │ +0000ea20: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ +0000ea30: 6e65 2020 3437 3729 0a2a 2073 6869 7368  ne  477).* shish
│ │ │ │ +0000ea40: 695f 6175 7468 656e 7469 6361 746f 725f  i_authenticator_
│ │ │ │ +0000ea50: 7061 7273 653a 2020 2020 2020 2020 2020  parse:          
│ │ │ │ +0000ea60: 2020 4175 7468 656e 7469 6361 746f 7220    Authenticator 
│ │ │ │ +0000ea70: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │  0000ea80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000ea90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000eaa0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000eab0: 2020 2020 2020 2028 6c69 6e65 2020 2039         (line   9
│ │ │ │ -0000eac0: 3829 0a2a 2073 6869 7368 695f 6175 7468  8).* shishi_auth
│ │ │ │ -0000ead0: 656e 7469 6361 746f 725f 7072 696e 743a  enticator_print:
│ │ │ │ -0000eae0: 2020 2020 2020 2020 2020 2020 4175 7468              Auth
│ │ │ │ -0000eaf0: 656e 7469 6361 746f 7220 4675 6e63 7469  enticator Functi
│ │ │ │ -0000eb00: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │ +0000eab0: 2020 2020 2020 2020 286c 696e 6520 2020          (line   
│ │ │ │ +0000eac0: 3938 290a 2a20 7368 6973 6869 5f61 7574  98).* shishi_aut
│ │ │ │ +0000ead0: 6865 6e74 6963 6174 6f72 5f70 7269 6e74  henticator_print
│ │ │ │ +0000eae0: 3a20 2020 2020 2020 2020 2020 2041 7574  :            Aut
│ │ │ │ +0000eaf0: 6865 6e74 6963 6174 6f72 2046 756e 6374  henticator Funct
│ │ │ │ +0000eb00: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │  0000eb10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000eb20: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000eb30: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000eb40: 2020 286c 696e 6520 2020 3532 290a 2a20    (line   52).* 
│ │ │ │ -0000eb50: 7368 6973 6869 5f61 7574 6865 6e74 6963  shishi_authentic
│ │ │ │ -0000eb60: 6174 6f72 5f72 6561 643a 2020 2020 2020  ator_read:      
│ │ │ │ -0000eb70: 2020 2020 2020 2041 7574 6865 6e74 6963         Authentic
│ │ │ │ -0000eb80: 6174 6f72 2046 756e 6374 696f 6e73 2e0a  ator Functions..
│ │ │ │ -0000eb90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0000eb40: 2020 2028 6c69 6e65 2020 2035 3229 0a2a     (line   52).*
│ │ │ │ +0000eb50: 2073 6869 7368 695f 6175 7468 656e 7469   shishi_authenti
│ │ │ │ +0000eb60: 6361 746f 725f 7265 6164 3a20 2020 2020  cator_read:     
│ │ │ │ +0000eb70: 2020 2020 2020 2020 4175 7468 656e 7469          Authenti
│ │ │ │ +0000eb80: 6361 746f 7220 4675 6e63 7469 6f6e 732e  cator Functions.
│ │ │ │ +0000eb90: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │  0000eba0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000ebb0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000ebc0: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ -0000ebd0: 6e65 2020 3131 3229 0a2a 2073 6869 7368  ne  112).* shish
│ │ │ │ -0000ebe0: 695f 6175 7468 656e 7469 6361 746f 725f  i_authenticator_
│ │ │ │ -0000ebf0: 7265 6d6f 7665 5f73 7562 6b65 793a 2020  remove_subkey:  
│ │ │ │ -0000ec00: 2020 4175 7468 656e 7469 6361 746f 7220    Authenticator 
│ │ │ │ -0000ec10: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │ +0000ebc0: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ +0000ebd0: 696e 6520 2031 3132 290a 2a20 7368 6973  ine  112).* shis
│ │ │ │ +0000ebe0: 6869 5f61 7574 6865 6e74 6963 6174 6f72  hi_authenticator
│ │ │ │ +0000ebf0: 5f72 656d 6f76 655f 7375 626b 6579 3a20  _remove_subkey: 
│ │ │ │ +0000ec00: 2020 2041 7574 6865 6e74 6963 6174 6f72     Authenticator
│ │ │ │ +0000ec10: 2046 756e 6374 696f 6e73 2e0a 2020 2020   Functions..    
│ │ │ │  0000ec20: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000ec30: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000ec40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000ec50: 2020 2020 2020 2020 286c 696e 6520 2034          (line  4
│ │ │ │ -0000ec60: 3634 290a 2a20 7368 6973 6869 5f61 7574  64).* shishi_aut
│ │ │ │ -0000ec70: 6865 6e74 6963 6174 6f72 5f73 6176 653a  henticator_save:
│ │ │ │ -0000ec80: 2020 2020 2020 2020 2020 2020 2041 7574               Aut
│ │ │ │ -0000ec90: 6865 6e74 6963 6174 6f72 2046 756e 6374  henticator Funct
│ │ │ │ -0000eca0: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │ +0000ec50: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ +0000ec60: 3436 3429 0a2a 2073 6869 7368 695f 6175  464).* shishi_au
│ │ │ │ +0000ec70: 7468 656e 7469 6361 746f 725f 7361 7665  thenticator_save
│ │ │ │ +0000ec80: 3a20 2020 2020 2020 2020 2020 2020 4175  :             Au
│ │ │ │ +0000ec90: 7468 656e 7469 6361 746f 7220 4675 6e63  thenticator Func
│ │ │ │ +0000eca0: 7469 6f6e 732e 0a20 2020 2020 2020 2020  tions..         
│ │ │ │  0000ecb0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000ecc0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000ecd0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000ece0: 2020 2028 6c69 6e65 2020 2036 3729 0a2a     (line   67).*
│ │ │ │ -0000ecf0: 2073 6869 7368 695f 6175 7468 656e 7469   shishi_authenti
│ │ │ │ -0000ed00: 6361 746f 725f 7365 716e 756d 6265 725f  cator_seqnumber_
│ │ │ │ -0000ed10: 6765 743a 2020 2020 4175 7468 656e 7469  get:    Authenti
│ │ │ │ -0000ed20: 6361 746f 7220 4675 6e63 7469 6f6e 732e  cator Functions.
│ │ │ │ -0000ed30: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ +0000ece0: 2020 2020 286c 696e 6520 2020 3637 290a      (line   67).
│ │ │ │ +0000ecf0: 2a20 7368 6973 6869 5f61 7574 6865 6e74  * shishi_authent
│ │ │ │ +0000ed00: 6963 6174 6f72 5f73 6571 6e75 6d62 6572  icator_seqnumber
│ │ │ │ +0000ed10: 5f67 6574 3a20 2020 2041 7574 6865 6e74  _get:    Authent
│ │ │ │ +0000ed20: 6963 6174 6f72 2046 756e 6374 696f 6e73  icator Functions
│ │ │ │ +0000ed30: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │  0000ed40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000ed50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000ed60: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ -0000ed70: 696e 6520 2032 3437 290a 2a20 7368 6973  ine  247).* shis
│ │ │ │ -0000ed80: 6869 5f61 7574 6865 6e74 6963 6174 6f72  hi_authenticator
│ │ │ │ -0000ed90: 5f73 6571 6e75 6d62 6572 5f72 656d 6f76  _seqnumber_remov
│ │ │ │ -0000eda0: 653a 2041 7574 6865 6e74 6963 6174 6f72  e: Authenticator
│ │ │ │ -0000edb0: 2046 756e 6374 696f 6e73 2e0a 2020 2020   Functions..    
│ │ │ │ +0000ed60: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ +0000ed70: 6c69 6e65 2020 3234 3729 0a2a 2073 6869  line  247).* shi
│ │ │ │ +0000ed80: 7368 695f 6175 7468 656e 7469 6361 746f  shi_authenticato
│ │ │ │ +0000ed90: 725f 7365 716e 756d 6265 725f 7265 6d6f  r_seqnumber_remo
│ │ │ │ +0000eda0: 7665 3a20 4175 7468 656e 7469 6361 746f  ve: Authenticato
│ │ │ │ +0000edb0: 7220 4675 6e63 7469 6f6e 732e 0a20 2020  r Functions..   
│ │ │ │  0000edc0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000edd0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000ede0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000edf0: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ -0000ee00: 3236 3129 0a2a 2073 6869 7368 695f 6175  261).* shishi_au
│ │ │ │ -0000ee10: 7468 656e 7469 6361 746f 725f 7365 716e  thenticator_seqn
│ │ │ │ -0000ee20: 756d 6265 725f 7365 743a 2020 2020 4175  umber_set:    Au
│ │ │ │ -0000ee30: 7468 656e 7469 6361 746f 7220 4675 6e63  thenticator Func
│ │ │ │ -0000ee40: 7469 6f6e 732e 0a20 2020 2020 2020 2020  tions..         
│ │ │ │ +0000edf0: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ +0000ee00: 2032 3631 290a 2a20 7368 6973 6869 5f61   261).* shishi_a
│ │ │ │ +0000ee10: 7574 6865 6e74 6963 6174 6f72 5f73 6571  uthenticator_seq
│ │ │ │ +0000ee20: 6e75 6d62 6572 5f73 6574 3a20 2020 2041  number_set:    A
│ │ │ │ +0000ee30: 7574 6865 6e74 6963 6174 6f72 2046 756e  uthenticator Fun
│ │ │ │ +0000ee40: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │  0000ee50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000ee60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000ee70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000ee80: 2020 2020 286c 696e 6520 2032 3734 290a      (line  274).
│ │ │ │ -0000ee90: 2a20 7368 6973 6869 5f61 7574 6865 6e74  * shishi_authent
│ │ │ │ -0000eea0: 6963 6174 6f72 5f73 6574 5f63 6b73 756d  icator_set_cksum
│ │ │ │ -0000eeb0: 3a20 2020 2020 2020 2041 7574 6865 6e74  :        Authent
│ │ │ │ -0000eec0: 6963 6174 6f72 2046 756e 6374 696f 6e73  icator Functions
│ │ │ │ -0000eed0: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │ +0000ee80: 2020 2020 2028 6c69 6e65 2020 3237 3429       (line  274)
│ │ │ │ +0000ee90: 0a2a 2073 6869 7368 695f 6175 7468 656e  .* shishi_authen
│ │ │ │ +0000eea0: 7469 6361 746f 725f 7365 745f 636b 7375  ticator_set_cksu
│ │ │ │ +0000eeb0: 6d3a 2020 2020 2020 2020 4175 7468 656e  m:        Authen
│ │ │ │ +0000eec0: 7469 6361 746f 7220 4675 6e63 7469 6f6e  ticator Function
│ │ │ │ +0000eed0: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │  0000eee0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000eef0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000ef00: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ -0000ef10: 6c69 6e65 2020 3335 3229 0a2a 2073 6869  line  352).* shi
│ │ │ │ -0000ef20: 7368 695f 6175 7468 656e 7469 6361 746f  shi_authenticato
│ │ │ │ -0000ef30: 725f 7365 745f 636e 616d 653a 2020 2020  r_set_cname:    
│ │ │ │ -0000ef40: 2020 2020 4175 7468 656e 7469 6361 746f      Authenticato
│ │ │ │ -0000ef50: 7220 4675 6e63 7469 6f6e 732e 0a20 2020  r Functions..   
│ │ │ │ +0000ef00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0000ef10: 286c 696e 6520 2033 3532 290a 2a20 7368  (line  352).* sh
│ │ │ │ +0000ef20: 6973 6869 5f61 7574 6865 6e74 6963 6174  ishi_authenticat
│ │ │ │ +0000ef30: 6f72 5f73 6574 5f63 6e61 6d65 3a20 2020  or_set_cname:   
│ │ │ │ +0000ef40: 2020 2020 2041 7574 6865 6e74 6963 6174       Authenticat
│ │ │ │ +0000ef50: 6f72 2046 756e 6374 696f 6e73 2e0a 2020  or Functions..  
│ │ │ │  0000ef60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000ef70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000ef80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000ef90: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ -0000efa0: 2031 3537 290a 2a20 7368 6973 6869 5f61   157).* shishi_a
│ │ │ │ -0000efb0: 7574 6865 6e74 6963 6174 6f72 5f73 6574  uthenticator_set
│ │ │ │ -0000efc0: 5f63 7265 616c 6d3a 2020 2020 2020 2041  _crealm:       A
│ │ │ │ -0000efd0: 7574 6865 6e74 6963 6174 6f72 2046 756e  uthenticator Fun
│ │ │ │ -0000efe0: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │ +0000ef90: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ +0000efa0: 2020 3135 3729 0a2a 2073 6869 7368 695f    157).* shishi_
│ │ │ │ +0000efb0: 6175 7468 656e 7469 6361 746f 725f 7365  authenticator_se
│ │ │ │ +0000efc0: 745f 6372 6561 6c6d 3a20 2020 2020 2020  t_crealm:       
│ │ │ │ +0000efd0: 4175 7468 656e 7469 6361 746f 7220 4675  Authenticator Fu
│ │ │ │ +0000efe0: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │  0000eff0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000f000: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000f010: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000f020: 2020 2020 2028 6c69 6e65 2020 3134 3329       (line  143)
│ │ │ │ -0000f030: 0a2a 2073 6869 7368 695f 6175 7468 656e  .* shishi_authen
│ │ │ │ -0000f040: 7469 6361 746f 725f 7365 745f 7375 626b  ticator_set_subk
│ │ │ │ -0000f050: 6579 3a20 2020 2020 2020 4175 7468 656e  ey:       Authen
│ │ │ │ -0000f060: 7469 6361 746f 7220 4675 6e63 7469 6f6e  ticator Function
│ │ │ │ -0000f070: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │ +0000f020: 2020 2020 2020 286c 696e 6520 2031 3433        (line  143
│ │ │ │ +0000f030: 290a 2a20 7368 6973 6869 5f61 7574 6865  ).* shishi_authe
│ │ │ │ +0000f040: 6e74 6963 6174 6f72 5f73 6574 5f73 7562  nticator_set_sub
│ │ │ │ +0000f050: 6b65 793a 2020 2020 2020 2041 7574 6865  key:       Authe
│ │ │ │ +0000f060: 6e74 6963 6174 6f72 2046 756e 6374 696f  nticator Functio
│ │ │ │ +0000f070: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │  0000f080: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000f090: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000f0a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000f0b0: 286c 696e 6520 2034 3932 290a 2a20 7368  (line  492).* sh
│ │ │ │ -0000f0c0: 6973 6869 5f61 7574 6865 6e74 6963 6174  ishi_authenticat
│ │ │ │ -0000f0d0: 6f72 5f73 7562 6b65 793a 2020 2020 2020  or_subkey:      
│ │ │ │ -0000f0e0: 2020 2020 2041 7574 6865 6e74 6963 6174       Authenticat
│ │ │ │ -0000f0f0: 6f72 2046 756e 6374 696f 6e73 2e0a 2020  or Functions..  
│ │ │ │ +0000f0b0: 2028 6c69 6e65 2020 3439 3229 0a2a 2073   (line  492).* s
│ │ │ │ +0000f0c0: 6869 7368 695f 6175 7468 656e 7469 6361  hishi_authentica
│ │ │ │ +0000f0d0: 746f 725f 7375 626b 6579 3a20 2020 2020  tor_subkey:     
│ │ │ │ +0000f0e0: 2020 2020 2020 4175 7468 656e 7469 6361        Authentica
│ │ │ │ +0000f0f0: 746f 7220 4675 6e63 7469 6f6e 732e 0a20  tor Functions.. 
│ │ │ │  0000f100: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000f110: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000f120: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000f130: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ -0000f140: 2020 2033 3929 0a2a 2073 6869 7368 695f     39).* shishi_
│ │ │ │ -0000f150: 6175 7468 656e 7469 6361 746f 725f 746f  authenticator_to
│ │ │ │ -0000f160: 5f66 696c 653a 2020 2020 2020 2020 2020  _file:          
│ │ │ │ -0000f170: 4175 7468 656e 7469 6361 746f 7220 4675  Authenticator Fu
│ │ │ │ -0000f180: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │ +0000f130: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ +0000f140: 6520 2020 3339 290a 2a20 7368 6973 6869  e   39).* shishi
│ │ │ │ +0000f150: 5f61 7574 6865 6e74 6963 6174 6f72 5f74  _authenticator_t
│ │ │ │ +0000f160: 6f5f 6669 6c65 3a20 2020 2020 2020 2020  o_file:         
│ │ │ │ +0000f170: 2041 7574 6865 6e74 6963 6174 6f72 2046   Authenticator F
│ │ │ │ +0000f180: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │  0000f190: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000f1a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000f1b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000f1c0: 2020 2020 2020 286c 696e 6520 2020 3831        (line   81
│ │ │ │ -0000f1d0: 290a 2a20 7368 6973 6869 5f61 7574 686f  ).* shishi_autho
│ │ │ │ -0000f1e0: 7269 7a61 7469 6f6e 5f70 6172 7365 3a20  rization_parse: 
│ │ │ │ -0000f1f0: 2020 2020 2020 2020 2020 2055 7469 6c69             Utili
│ │ │ │ -0000f200: 7479 2046 756e 6374 696f 6e73 2e20 2028  ty Functions.  (
│ │ │ │ -0000f210: 6c69 6e65 2020 3333 3629 0a2a 2073 6869  line  336).* shi
│ │ │ │ -0000f220: 7368 695f 6175 7468 6f72 697a 655f 6b35  shi_authorize_k5
│ │ │ │ -0000f230: 6c6f 6769 6e3a 2020 2020 2020 2020 2020  login:          
│ │ │ │ -0000f240: 2020 2020 5574 696c 6974 7920 4675 6e63      Utility Func
│ │ │ │ -0000f250: 7469 6f6e 732e 2020 286c 696e 6520 2033  tions.  (line  3
│ │ │ │ -0000f260: 3231 290a 2a20 7368 6973 6869 5f61 7574  21).* shishi_aut
│ │ │ │ -0000f270: 686f 7269 7a65 5f73 7472 636d 703a 2020  horize_strcmp:  
│ │ │ │ -0000f280: 2020 2020 2020 2020 2020 2020 2055 7469               Uti
│ │ │ │ -0000f290: 6c69 7479 2046 756e 6374 696f 6e73 2e20  lity Functions. 
│ │ │ │ -0000f2a0: 2028 6c69 6e65 2020 3330 3529 0a2a 2073   (line  305).* s
│ │ │ │ -0000f2b0: 6869 7368 695f 6175 7468 6f72 697a 6564  hishi_authorized
│ │ │ │ -0000f2c0: 5f70 3a20 2020 2020 2020 2020 2020 2020  _p:             
│ │ │ │ -0000f2d0: 2020 2020 2020 5574 696c 6974 7920 4675        Utility Fu
│ │ │ │ -0000f2e0: 6e63 7469 6f6e 732e 2020 286c 696e 6520  nctions.  (line 
│ │ │ │ -0000f2f0: 2033 3438 290a 2a20 7368 6973 6869 5f63   348).* shishi_c
│ │ │ │ -0000f300: 6667 3a20 2020 2020 2020 2020 2020 2020  fg:             
│ │ │ │ -0000f310: 2020 2020 2020 2020 2020 2020 2020 2049                 I
│ │ │ │ -0000f320: 6e69 7469 616c 697a 6174 696f 6e20 4675  nitialization Fu
│ │ │ │ -0000f330: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │ +0000f1c0: 2020 2020 2020 2028 6c69 6e65 2020 2038         (line   8
│ │ │ │ +0000f1d0: 3129 0a2a 2073 6869 7368 695f 6175 7468  1).* shishi_auth
│ │ │ │ +0000f1e0: 6f72 697a 6174 696f 6e5f 7061 7273 653a  orization_parse:
│ │ │ │ +0000f1f0: 2020 2020 2020 2020 2020 2020 5574 696c              Util
│ │ │ │ +0000f200: 6974 7920 4675 6e63 7469 6f6e 732e 2020  ity Functions.  
│ │ │ │ +0000f210: 286c 696e 6520 2033 3336 290a 2a20 7368  (line  336).* sh
│ │ │ │ +0000f220: 6973 6869 5f61 7574 686f 7269 7a65 5f6b  ishi_authorize_k
│ │ │ │ +0000f230: 356c 6f67 696e 3a20 2020 2020 2020 2020  5login:         
│ │ │ │ +0000f240: 2020 2020 2055 7469 6c69 7479 2046 756e       Utility Fun
│ │ │ │ +0000f250: 6374 696f 6e73 2e20 2028 6c69 6e65 2020  ctions.  (line  
│ │ │ │ +0000f260: 3332 3129 0a2a 2073 6869 7368 695f 6175  321).* shishi_au
│ │ │ │ +0000f270: 7468 6f72 697a 655f 7374 7263 6d70 3a20  thorize_strcmp: 
│ │ │ │ +0000f280: 2020 2020 2020 2020 2020 2020 2020 5574                Ut
│ │ │ │ +0000f290: 696c 6974 7920 4675 6e63 7469 6f6e 732e  ility Functions.
│ │ │ │ +0000f2a0: 2020 286c 696e 6520 2033 3035 290a 2a20    (line  305).* 
│ │ │ │ +0000f2b0: 7368 6973 6869 5f61 7574 686f 7269 7a65  shishi_authorize
│ │ │ │ +0000f2c0: 645f 703a 2020 2020 2020 2020 2020 2020  d_p:            
│ │ │ │ +0000f2d0: 2020 2020 2020 2055 7469 6c69 7479 2046         Utility F
│ │ │ │ +0000f2e0: 756e 6374 696f 6e73 2e20 2028 6c69 6e65  unctions.  (line
│ │ │ │ +0000f2f0: 2020 3334 3829 0a2a 2073 6869 7368 695f    348).* shishi_
│ │ │ │ +0000f300: 6366 673a 2020 2020 2020 2020 2020 2020  cfg:            
│ │ │ │ +0000f310: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0000f320: 496e 6974 6961 6c69 7a61 7469 6f6e 2046  Initialization F
│ │ │ │ +0000f330: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │  0000f340: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000f350: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000f360: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000f370: 2020 2020 2020 286c 696e 6520 2031 3337        (line  137
│ │ │ │ -0000f380: 290a 2a20 7368 6973 6869 5f63 6667 5f61  ).* shishi_cfg_a
│ │ │ │ -0000f390: 7574 686f 7269 7a61 7469 6f6e 7479 7065  uthorizationtype
│ │ │ │ -0000f3a0: 5f73 6574 3a20 2020 2020 2049 6e69 7469  _set:      Initi
│ │ │ │ -0000f3b0: 616c 697a 6174 696f 6e20 4675 6e63 7469  alization Functi
│ │ │ │ -0000f3c0: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │ +0000f370: 2020 2020 2020 2028 6c69 6e65 2020 3133         (line  13
│ │ │ │ +0000f380: 3729 0a2a 2073 6869 7368 695f 6366 675f  7).* shishi_cfg_
│ │ │ │ +0000f390: 6175 7468 6f72 697a 6174 696f 6e74 7970  authorizationtyp
│ │ │ │ +0000f3a0: 655f 7365 743a 2020 2020 2020 496e 6974  e_set:      Init
│ │ │ │ +0000f3b0: 6961 6c69 7a61 7469 6f6e 2046 756e 6374  ialization Funct
│ │ │ │ +0000f3c0: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │  0000f3d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000f3e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000f3f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000f400: 2020 286c 696e 6520 2032 3931 290a 2a20    (line  291).* 
│ │ │ │ -0000f410: 7368 6973 6869 5f63 6667 5f63 6c69 656e  shishi_cfg_clien
│ │ │ │ -0000f420: 746b 6463 6574 7970 653a 2020 2020 2020  tkdcetype:      
│ │ │ │ -0000f430: 2020 2020 2020 2049 6e69 7469 616c 697a         Initializ
│ │ │ │ -0000f440: 6174 696f 6e20 4675 6e63 7469 6f6e 732e  ation Functions.
│ │ │ │ -0000f450: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ +0000f400: 2020 2028 6c69 6e65 2020 3239 3129 0a2a     (line  291).*
│ │ │ │ +0000f410: 2073 6869 7368 695f 6366 675f 636c 6965   shishi_cfg_clie
│ │ │ │ +0000f420: 6e74 6b64 6365 7479 7065 3a20 2020 2020  ntkdcetype:     
│ │ │ │ +0000f430: 2020 2020 2020 2020 496e 6974 6961 6c69          Initiali
│ │ │ │ +0000f440: 7a61 7469 6f6e 2046 756e 6374 696f 6e73  zation Functions
│ │ │ │ +0000f450: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │  0000f460: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000f470: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000f480: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ -0000f490: 696e 6520 2032 3435 290a 2a20 7368 6973  ine  245).* shis
│ │ │ │ -0000f4a0: 6869 5f63 6667 5f63 6c69 656e 746b 6463  hi_cfg_clientkdc
│ │ │ │ -0000f4b0: 6574 7970 655f 6661 7374 3a20 2020 2020  etype_fast:     
│ │ │ │ -0000f4c0: 2020 2049 6e69 7469 616c 697a 6174 696f     Initializatio
│ │ │ │ -0000f4d0: 6e20 4675 6e63 7469 6f6e 732e 0a20 2020  n Functions..   
│ │ │ │ +0000f480: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ +0000f490: 6c69 6e65 2020 3234 3529 0a2a 2073 6869  line  245).* shi
│ │ │ │ +0000f4a0: 7368 695f 6366 675f 636c 6965 6e74 6b64  shi_cfg_clientkd
│ │ │ │ +0000f4b0: 6365 7479 7065 5f66 6173 743a 2020 2020  cetype_fast:    
│ │ │ │ +0000f4c0: 2020 2020 496e 6974 6961 6c69 7a61 7469      Initializati
│ │ │ │ +0000f4d0: 6f6e 2046 756e 6374 696f 6e73 2e0a 2020  on Functions..  
│ │ │ │  0000f4e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000f4f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000f500: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000f510: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ -0000f520: 2032 3539 290a 2a20 7368 6973 6869 5f63   259).* shishi_c
│ │ │ │ -0000f530: 6667 5f63 6c69 656e 746b 6463 6574 7970  fg_clientkdcetyp
│ │ │ │ -0000f540: 655f 7365 743a 2020 2020 2020 2020 2049  e_set:         I
│ │ │ │ -0000f550: 6e69 7469 616c 697a 6174 696f 6e20 4675  nitialization Fu
│ │ │ │ -0000f560: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │ +0000f510: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ +0000f520: 2020 3235 3929 0a2a 2073 6869 7368 695f    259).* shishi_
│ │ │ │ +0000f530: 6366 675f 636c 6965 6e74 6b64 6365 7479  cfg_clientkdcety
│ │ │ │ +0000f540: 7065 5f73 6574 3a20 2020 2020 2020 2020  pe_set:         
│ │ │ │ +0000f550: 496e 6974 6961 6c69 7a61 7469 6f6e 2046  Initialization F
│ │ │ │ +0000f560: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │  0000f570: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000f580: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000f590: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000f5a0: 2020 2020 2020 286c 696e 6520 2032 3733        (line  273
│ │ │ │ -0000f5b0: 290a 2a20 7368 6973 6869 5f63 6667 5f64  ).* shishi_cfg_d
│ │ │ │ -0000f5c0: 6566 6175 6c74 5f73 7973 7465 6d66 696c  efault_systemfil
│ │ │ │ -0000f5d0: 653a 2020 2020 2020 2020 2049 6e69 7469  e:         Initi
│ │ │ │ -0000f5e0: 616c 697a 6174 696f 6e20 4675 6e63 7469  alization Functi
│ │ │ │ -0000f5f0: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │ +0000f5a0: 2020 2020 2020 2028 6c69 6e65 2020 3237         (line  27
│ │ │ │ +0000f5b0: 3329 0a2a 2073 6869 7368 695f 6366 675f  3).* shishi_cfg_
│ │ │ │ +0000f5c0: 6465 6661 756c 745f 7379 7374 656d 6669  default_systemfi
│ │ │ │ +0000f5d0: 6c65 3a20 2020 2020 2020 2020 496e 6974  le:         Init
│ │ │ │ +0000f5e0: 6961 6c69 7a61 7469 6f6e 2046 756e 6374  ialization Funct
│ │ │ │ +0000f5f0: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │  0000f600: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000f610: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000f620: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000f630: 2020 286c 696e 6520 2031 3735 290a 2a20    (line  175).* 
│ │ │ │ -0000f640: 7368 6973 6869 5f63 6667 5f64 6566 6175  shishi_cfg_defau
│ │ │ │ -0000f650: 6c74 5f75 7365 7264 6972 6563 746f 7279  lt_userdirectory
│ │ │ │ -0000f660: 3a20 2020 2020 2049 6e69 7469 616c 697a  :      Initializ
│ │ │ │ -0000f670: 6174 696f 6e20 4675 6e63 7469 6f6e 732e  ation Functions.
│ │ │ │ -0000f680: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ +0000f630: 2020 2028 6c69 6e65 2020 3137 3529 0a2a     (line  175).*
│ │ │ │ +0000f640: 2073 6869 7368 695f 6366 675f 6465 6661   shishi_cfg_defa
│ │ │ │ +0000f650: 756c 745f 7573 6572 6469 7265 6374 6f72  ult_userdirector
│ │ │ │ +0000f660: 793a 2020 2020 2020 496e 6974 6961 6c69  y:      Initiali
│ │ │ │ +0000f670: 7a61 7469 6f6e 2046 756e 6374 696f 6e73  zation Functions
│ │ │ │ +0000f680: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │  0000f690: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000f6a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000f6b0: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ -0000f6c0: 696e 6520 2031 3930 290a 2a20 7368 6973  ine  190).* shis
│ │ │ │ -0000f6d0: 6869 5f63 6667 5f64 6566 6175 6c74 5f75  hi_cfg_default_u
│ │ │ │ -0000f6e0: 7365 7266 696c 653a 2020 2020 2020 2020  serfile:        
│ │ │ │ -0000f6f0: 2020 2049 6e69 7469 616c 697a 6174 696f     Initializatio
│ │ │ │ -0000f700: 6e20 4675 6e63 7469 6f6e 732e 0a20 2020  n Functions..   
│ │ │ │ +0000f6b0: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ +0000f6c0: 6c69 6e65 2020 3139 3029 0a2a 2073 6869  line  190).* shi
│ │ │ │ +0000f6d0: 7368 695f 6366 675f 6465 6661 756c 745f  shi_cfg_default_
│ │ │ │ +0000f6e0: 7573 6572 6669 6c65 3a20 2020 2020 2020  userfile:       
│ │ │ │ +0000f6f0: 2020 2020 496e 6974 6961 6c69 7a61 7469      Initializati
│ │ │ │ +0000f700: 6f6e 2046 756e 6374 696f 6e73 2e0a 2020  on Functions..  
│ │ │ │  0000f710: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000f720: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000f730: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000f740: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ -0000f750: 2032 3330 290a 2a20 7368 6973 6869 5f63   230).* shishi_c
│ │ │ │ -0000f760: 6667 5f66 726f 6d5f 6669 6c65 3a20 2020  fg_from_file:   
│ │ │ │ -0000f770: 2020 2020 2020 2020 2020 2020 2020 2049                 I
│ │ │ │ -0000f780: 6e69 7469 616c 697a 6174 696f 6e20 4675  nitialization Fu
│ │ │ │ -0000f790: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │ +0000f740: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ +0000f750: 2020 3233 3029 0a2a 2073 6869 7368 695f    230).* shishi_
│ │ │ │ +0000f760: 6366 675f 6672 6f6d 5f66 696c 653a 2020  cfg_from_file:  
│ │ │ │ +0000f770: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0000f780: 496e 6974 6961 6c69 7a61 7469 6f6e 2046  Initialization F
│ │ │ │ +0000f790: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │  0000f7a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000f7b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000f7c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000f7d0: 2020 2020 2020 286c 696e 6520 2031 3530        (line  150
│ │ │ │ -0000f7e0: 290a 2a20 7368 6973 6869 5f63 6667 5f70  ).* shishi_cfg_p
│ │ │ │ -0000f7f0: 7269 6e74 3a20 2020 2020 2020 2020 2020  rint:           
│ │ │ │ -0000f800: 2020 2020 2020 2020 2020 2049 6e69 7469             Initi
│ │ │ │ -0000f810: 616c 697a 6174 696f 6e20 4675 6e63 7469  alization Functi
│ │ │ │ -0000f820: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │ +0000f7d0: 2020 2020 2020 2028 6c69 6e65 2020 3135         (line  15
│ │ │ │ +0000f7e0: 3029 0a2a 2073 6869 7368 695f 6366 675f  0).* shishi_cfg_
│ │ │ │ +0000f7f0: 7072 696e 743a 2020 2020 2020 2020 2020  print:          
│ │ │ │ +0000f800: 2020 2020 2020 2020 2020 2020 496e 6974              Init
│ │ │ │ +0000f810: 6961 6c69 7a61 7469 6f6e 2046 756e 6374  ialization Funct
│ │ │ │ +0000f820: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │  0000f830: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000f840: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000f850: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000f860: 2020 286c 696e 6520 2031 3633 290a 2a20    (line  163).* 
│ │ │ │ -0000f870: 7368 6973 6869 5f63 6667 5f75 7365 7264  shishi_cfg_userd
│ │ │ │ -0000f880: 6972 6563 746f 7279 5f66 696c 653a 2020  irectory_file:  
│ │ │ │ -0000f890: 2020 2020 2020 2049 6e69 7469 616c 697a         Initializ
│ │ │ │ -0000f8a0: 6174 696f 6e20 4675 6e63 7469 6f6e 732e  ation Functions.
│ │ │ │ -0000f8b0: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ +0000f860: 2020 2028 6c69 6e65 2020 3136 3329 0a2a     (line  163).*
│ │ │ │ +0000f870: 2073 6869 7368 695f 6366 675f 7573 6572   shishi_cfg_user
│ │ │ │ +0000f880: 6469 7265 6374 6f72 795f 6669 6c65 3a20  directory_file: 
│ │ │ │ +0000f890: 2020 2020 2020 2020 496e 6974 6961 6c69          Initiali
│ │ │ │ +0000f8a0: 7a61 7469 6f6e 2046 756e 6374 696f 6e73  zation Functions
│ │ │ │ +0000f8b0: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │  0000f8c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000f8d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000f8e0: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ -0000f8f0: 696e 6520 2032 3130 290a 2a20 7368 6973  ine  210).* shis
│ │ │ │ -0000f900: 6869 5f63 6865 636b 5f76 6572 7369 6f6e  hi_check_version
│ │ │ │ -0000f910: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ -0000f920: 2020 2056 6572 7369 6f6e 2043 6865 636b     Version Check
│ │ │ │ -0000f930: 2e20 2020 2020 2028 6c69 6e65 2020 2031  .      (line   1
│ │ │ │ -0000f940: 3529 0a2a 2073 6869 7368 695f 6368 6563  5).* shishi_chec
│ │ │ │ -0000f950: 6b73 756d 3a20 2020 2020 2020 2020 2020  ksum:           
│ │ │ │ -0000f960: 2020 2020 2020 2020 2020 2020 4372 7970              Cryp
│ │ │ │ -0000f970: 746f 6772 6170 6869 6320 4675 6e63 7469  tographic Functi
│ │ │ │ -0000f980: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │ +0000f8e0: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ +0000f8f0: 6c69 6e65 2020 3231 3029 0a2a 2073 6869  line  210).* shi
│ │ │ │ +0000f900: 7368 695f 6368 6563 6b5f 7665 7273 696f  shi_check_versio
│ │ │ │ +0000f910: 6e3a 2020 2020 2020 2020 2020 2020 2020  n:              
│ │ │ │ +0000f920: 2020 2020 5665 7273 696f 6e20 4368 6563      Version Chec
│ │ │ │ +0000f930: 6b2e 2020 2020 2020 286c 696e 6520 2020  k.      (line   
│ │ │ │ +0000f940: 3135 290a 2a20 7368 6973 6869 5f63 6865  15).* shishi_che
│ │ │ │ +0000f950: 636b 7375 6d3a 2020 2020 2020 2020 2020  cksum:          
│ │ │ │ +0000f960: 2020 2020 2020 2020 2020 2020 2043 7279               Cry
│ │ │ │ +0000f970: 7074 6f67 7261 7068 6963 2046 756e 6374  ptographic Funct
│ │ │ │ +0000f980: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │  0000f990: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000f9a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000f9b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000f9c0: 2020 286c 696e 6520 2037 3737 290a 2a20    (line  777).* 
│ │ │ │ -0000f9d0: 7368 6973 6869 5f63 6865 636b 7375 6d5f  shishi_checksum_
│ │ │ │ -0000f9e0: 636b 7375 6d6c 656e 3a20 2020 2020 2020  cksumlen:       
│ │ │ │ -0000f9f0: 2020 2020 2020 2043 7279 7074 6f67 7261         Cryptogra
│ │ │ │ -0000fa00: 7068 6963 2046 756e 6374 696f 6e73 2e0a  phic Functions..
│ │ │ │ -0000fa10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0000f9c0: 2020 2028 6c69 6e65 2020 3737 3729 0a2a     (line  777).*
│ │ │ │ +0000f9d0: 2073 6869 7368 695f 6368 6563 6b73 756d   shishi_checksum
│ │ │ │ +0000f9e0: 5f63 6b73 756d 6c65 6e3a 2020 2020 2020  _cksumlen:      
│ │ │ │ +0000f9f0: 2020 2020 2020 2020 4372 7970 746f 6772          Cryptogr
│ │ │ │ +0000fa00: 6170 6869 6320 4675 6e63 7469 6f6e 732e  aphic Functions.
│ │ │ │ +0000fa10: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │  0000fa20: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000fa30: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000fa40: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ -0000fa50: 6e65 2020 3731 3329 0a2a 2073 6869 7368  ne  713).* shish
│ │ │ │ -0000fa60: 695f 6368 6563 6b73 756d 5f6e 616d 653a  i_checksum_name:
│ │ │ │ -0000fa70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000fa80: 2020 4372 7970 746f 6772 6170 6869 6320    Cryptographic 
│ │ │ │ -0000fa90: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │ +0000fa40: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ +0000fa50: 696e 6520 2037 3133 290a 2a20 7368 6973  ine  713).* shis
│ │ │ │ +0000fa60: 6869 5f63 6865 636b 7375 6d5f 6e61 6d65  hi_checksum_name
│ │ │ │ +0000fa70: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ +0000fa80: 2020 2043 7279 7074 6f67 7261 7068 6963     Cryptographic
│ │ │ │ +0000fa90: 2046 756e 6374 696f 6e73 2e0a 2020 2020   Functions..    
│ │ │ │  0000faa0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000fab0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000fac0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000fad0: 2020 2020 2020 2020 286c 696e 6520 2037          (line  7
│ │ │ │ -0000fae0: 3032 290a 2a20 7368 6973 6869 5f63 6865  02).* shishi_che
│ │ │ │ -0000faf0: 636b 7375 6d5f 7061 7273 653a 2020 2020  cksum_parse:    
│ │ │ │ -0000fb00: 2020 2020 2020 2020 2020 2020 2043 7279               Cry
│ │ │ │ -0000fb10: 7074 6f67 7261 7068 6963 2046 756e 6374  ptographic Funct
│ │ │ │ -0000fb20: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │ +0000fad0: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ +0000fae0: 3730 3229 0a2a 2073 6869 7368 695f 6368  702).* shishi_ch
│ │ │ │ +0000faf0: 6563 6b73 756d 5f70 6172 7365 3a20 2020  ecksum_parse:   
│ │ │ │ +0000fb00: 2020 2020 2020 2020 2020 2020 2020 4372                Cr
│ │ │ │ +0000fb10: 7970 746f 6772 6170 6869 6320 4675 6e63  yptographic Func
│ │ │ │ +0000fb20: 7469 6f6e 732e 0a20 2020 2020 2020 2020  tions..         
│ │ │ │  0000fb30: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000fb40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000fb50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000fb60: 2020 2028 6c69 6e65 2020 3732 3429 0a2a     (line  724).*
│ │ │ │ -0000fb70: 2073 6869 7368 695f 6368 6563 6b73 756d   shishi_checksum
│ │ │ │ -0000fb80: 5f73 7570 706f 7274 6564 5f70 3a20 2020  _supported_p:   
│ │ │ │ -0000fb90: 2020 2020 2020 2020 4372 7970 746f 6772          Cryptogr
│ │ │ │ -0000fba0: 6170 6869 6320 4675 6e63 7469 6f6e 732e  aphic Functions.
│ │ │ │ -0000fbb0: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ +0000fb60: 2020 2020 286c 696e 6520 2037 3234 290a      (line  724).
│ │ │ │ +0000fb70: 2a20 7368 6973 6869 5f63 6865 636b 7375  * shishi_checksu
│ │ │ │ +0000fb80: 6d5f 7375 7070 6f72 7465 645f 703a 2020  m_supported_p:  
│ │ │ │ +0000fb90: 2020 2020 2020 2020 2043 7279 7074 6f67           Cryptog
│ │ │ │ +0000fba0: 7261 7068 6963 2046 756e 6374 696f 6e73  raphic Functions
│ │ │ │ +0000fbb0: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │  0000fbc0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000fbd0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000fbe0: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ -0000fbf0: 696e 6520 2036 3932 290a 2a20 7368 6973  ine  692).* shis
│ │ │ │ -0000fc00: 6869 5f63 6970 6865 725f 626c 6f63 6b73  hi_cipher_blocks
│ │ │ │ -0000fc10: 697a 653a 2020 2020 2020 2020 2020 2020  ize:            
│ │ │ │ -0000fc20: 2020 2043 7279 7074 6f67 7261 7068 6963     Cryptographic
│ │ │ │ -0000fc30: 2046 756e 6374 696f 6e73 2e0a 2020 2020   Functions..    
│ │ │ │ +0000fbe0: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ +0000fbf0: 6c69 6e65 2020 3639 3229 0a2a 2073 6869  line  692).* shi
│ │ │ │ +0000fc00: 7368 695f 6369 7068 6572 5f62 6c6f 636b  shi_cipher_block
│ │ │ │ +0000fc10: 7369 7a65 3a20 2020 2020 2020 2020 2020  size:           
│ │ │ │ +0000fc20: 2020 2020 4372 7970 746f 6772 6170 6869      Cryptographi
│ │ │ │ +0000fc30: 6320 4675 6e63 7469 6f6e 732e 0a20 2020  c Functions..   
│ │ │ │  0000fc40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000fc50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000fc60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000fc70: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ -0000fc80: 3632 3529 0a2a 2073 6869 7368 695f 6369  625).* shishi_ci
│ │ │ │ -0000fc90: 7068 6572 5f63 6f6e 666f 756e 6465 7273  pher_confounders
│ │ │ │ -0000fca0: 697a 653a 2020 2020 2020 2020 2020 4372  ize:          Cr
│ │ │ │ -0000fcb0: 7970 746f 6772 6170 6869 6320 4675 6e63  yptographic Func
│ │ │ │ -0000fcc0: 7469 6f6e 732e 0a20 2020 2020 2020 2020  tions..         
│ │ │ │ +0000fc70: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ +0000fc80: 2036 3235 290a 2a20 7368 6973 6869 5f63   625).* shishi_c
│ │ │ │ +0000fc90: 6970 6865 725f 636f 6e66 6f75 6e64 6572  ipher_confounder
│ │ │ │ +0000fca0: 7369 7a65 3a20 2020 2020 2020 2020 2043  size:          C
│ │ │ │ +0000fcb0: 7279 7074 6f67 7261 7068 6963 2046 756e  ryptographic Fun
│ │ │ │ +0000fcc0: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │  0000fcd0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000fce0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000fcf0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000fd00: 2020 2020 286c 696e 6520 2036 3336 290a      (line  636).
│ │ │ │ -0000fd10: 2a20 7368 6973 6869 5f63 6970 6865 725f  * shishi_cipher_
│ │ │ │ -0000fd20: 6465 6661 756c 7463 6b73 756d 7479 7065  defaultcksumtype
│ │ │ │ -0000fd30: 3a20 2020 2020 2020 2043 7279 7074 6f67  :        Cryptog
│ │ │ │ -0000fd40: 7261 7068 6963 2046 756e 6374 696f 6e73  raphic Functions
│ │ │ │ -0000fd50: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │ +0000fd00: 2020 2020 2028 6c69 6e65 2020 3633 3629       (line  636)
│ │ │ │ +0000fd10: 0a2a 2073 6869 7368 695f 6369 7068 6572  .* shishi_cipher
│ │ │ │ +0000fd20: 5f64 6566 6175 6c74 636b 7375 6d74 7970  _defaultcksumtyp
│ │ │ │ +0000fd30: 653a 2020 2020 2020 2020 4372 7970 746f  e:        Crypto
│ │ │ │ +0000fd40: 6772 6170 6869 6320 4675 6e63 7469 6f6e  graphic Function
│ │ │ │ +0000fd50: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │  0000fd60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000fd70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000fd80: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ -0000fd90: 6c69 6e65 2020 3637 3129 0a2a 2073 6869  line  671).* shi
│ │ │ │ -0000fda0: 7368 695f 6369 7068 6572 5f6b 6579 6c65  shi_cipher_keyle
│ │ │ │ -0000fdb0: 6e3a 2020 2020 2020 2020 2020 2020 2020  n:              
│ │ │ │ -0000fdc0: 2020 2020 4372 7970 746f 6772 6170 6869      Cryptographi
│ │ │ │ -0000fdd0: 6320 4675 6e63 7469 6f6e 732e 0a20 2020  c Functions..   
│ │ │ │ +0000fd80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0000fd90: 286c 696e 6520 2036 3731 290a 2a20 7368  (line  671).* sh
│ │ │ │ +0000fda0: 6973 6869 5f63 6970 6865 725f 6b65 796c  ishi_cipher_keyl
│ │ │ │ +0000fdb0: 656e 3a20 2020 2020 2020 2020 2020 2020  en:             
│ │ │ │ +0000fdc0: 2020 2020 2043 7279 7074 6f67 7261 7068       Cryptograph
│ │ │ │ +0000fdd0: 6963 2046 756e 6374 696f 6e73 2e0a 2020  ic Functions..  
│ │ │ │  0000fde0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000fdf0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000fe00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000fe10: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ -0000fe20: 2036 3438 290a 2a20 7368 6973 6869 5f63   648).* shishi_c
│ │ │ │ -0000fe30: 6970 6865 725f 6e61 6d65 3a20 2020 2020  ipher_name:     
│ │ │ │ -0000fe40: 2020 2020 2020 2020 2020 2020 2020 2043                 C
│ │ │ │ -0000fe50: 7279 7074 6f67 7261 7068 6963 2046 756e  ryptographic Fun
│ │ │ │ -0000fe60: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │ +0000fe10: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ +0000fe20: 2020 3634 3829 0a2a 2073 6869 7368 695f    648).* shishi_
│ │ │ │ +0000fe30: 6369 7068 6572 5f6e 616d 653a 2020 2020  cipher_name:    
│ │ │ │ +0000fe40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0000fe50: 4372 7970 746f 6772 6170 6869 6320 4675  Cryptographic Fu
│ │ │ │ +0000fe60: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │  0000fe70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000fe80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000fe90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000fea0: 2020 2020 2028 6c69 6e65 2020 3631 3429       (line  614)
│ │ │ │ -0000feb0: 0a2a 2073 6869 7368 695f 6369 7068 6572  .* shishi_cipher
│ │ │ │ -0000fec0: 5f70 6172 7365 3a20 2020 2020 2020 2020  _parse:         
│ │ │ │ -0000fed0: 2020 2020 2020 2020 2020 4372 7970 746f            Crypto
│ │ │ │ -0000fee0: 6772 6170 6869 6320 4675 6e63 7469 6f6e  graphic Function
│ │ │ │ -0000fef0: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │ +0000fea0: 2020 2020 2020 286c 696e 6520 2036 3134        (line  614
│ │ │ │ +0000feb0: 290a 2a20 7368 6973 6869 5f63 6970 6865  ).* shishi_ciphe
│ │ │ │ +0000fec0: 725f 7061 7273 653a 2020 2020 2020 2020  r_parse:        
│ │ │ │ +0000fed0: 2020 2020 2020 2020 2020 2043 7279 7074             Crypt
│ │ │ │ +0000fee0: 6f67 7261 7068 6963 2046 756e 6374 696f  ographic Functio
│ │ │ │ +0000fef0: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │  0000ff00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000ff10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000ff20: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000ff30: 286c 696e 6520 2036 3832 290a 2a20 7368  (line  682).* sh
│ │ │ │ -0000ff40: 6973 6869 5f63 6970 6865 725f 7261 6e64  ishi_cipher_rand
│ │ │ │ -0000ff50: 6f6d 6c65 6e3a 2020 2020 2020 2020 2020  omlen:          
│ │ │ │ -0000ff60: 2020 2020 2043 7279 7074 6f67 7261 7068       Cryptograph
│ │ │ │ -0000ff70: 6963 2046 756e 6374 696f 6e73 2e0a 2020  ic Functions..  
│ │ │ │ +0000ff30: 2028 6c69 6e65 2020 3638 3229 0a2a 2073   (line  682).* s
│ │ │ │ +0000ff40: 6869 7368 695f 6369 7068 6572 5f72 616e  hishi_cipher_ran
│ │ │ │ +0000ff50: 646f 6d6c 656e 3a20 2020 2020 2020 2020  domlen:         
│ │ │ │ +0000ff60: 2020 2020 2020 4372 7970 746f 6772 6170        Cryptograp
│ │ │ │ +0000ff70: 6869 6320 4675 6e63 7469 6f6e 732e 0a20  hic Functions.. 
│ │ │ │  0000ff80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000ff90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0000ffa0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0000ffb0: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ -0000ffc0: 2020 3635 3929 0a2a 2073 6869 7368 695f    659).* shishi_
│ │ │ │ -0000ffd0: 6369 7068 6572 5f73 7570 706f 7274 6564  cipher_supported
│ │ │ │ -0000ffe0: 5f70 3a20 2020 2020 2020 2020 2020 2020  _p:             
│ │ │ │ -0000fff0: 4372 7970 746f 6772 6170 6869 6320 4675  Cryptographic Fu
│ │ │ │ -00010000: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │ +0000ffb0: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ +0000ffc0: 6520 2036 3539 290a 2a20 7368 6973 6869  e  659).* shishi
│ │ │ │ +0000ffd0: 5f63 6970 6865 725f 7375 7070 6f72 7465  _cipher_supporte
│ │ │ │ +0000ffe0: 645f 703a 2020 2020 2020 2020 2020 2020  d_p:            
│ │ │ │ +0000fff0: 2043 7279 7074 6f67 7261 7068 6963 2046   Cryptographic F
│ │ │ │ +00010000: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │  00010010: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00010020: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00010030: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00010040: 2020 2020 2020 286c 696e 6520 2036 3034        (line  604
│ │ │ │ -00010050: 290a 2a20 7368 6973 6869 5f63 7263 3a20  ).* shishi_crc: 
│ │ │ │ +00010040: 2020 2020 2020 2028 6c69 6e65 2020 3630         (line  60
│ │ │ │ +00010050: 3429 0a2a 2073 6869 7368 695f 6372 633a  4).* shishi_crc:
│ │ │ │  00010060: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00010070: 2020 2020 2020 2020 2020 2043 7279 7074             Crypt
│ │ │ │ -00010080: 6f67 7261 7068 6963 2046 756e 6374 696f  ographic Functio
│ │ │ │ -00010090: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │ +00010070: 2020 2020 2020 2020 2020 2020 4372 7970              Cryp
│ │ │ │ +00010080: 746f 6772 6170 6869 6320 4675 6e63 7469  tographic Functi
│ │ │ │ +00010090: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │  000100a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000100b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000100c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000100d0: 2028 6c69 6e65 2031 3430 3629 0a2a 2073   (line 1406).* s
│ │ │ │ -000100e0: 6869 7368 695f 6372 7970 746f 3a20 2020  hishi_crypto:   
│ │ │ │ +000100d0: 2020 286c 696e 6520 3134 3036 290a 2a20    (line 1406).* 
│ │ │ │ +000100e0: 7368 6973 6869 5f63 7279 7074 6f3a 2020  shishi_crypto:  
│ │ │ │  000100f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00010100: 2020 2020 2020 4372 7970 746f 6772 6170        Cryptograp
│ │ │ │ -00010110: 6869 6320 4675 6e63 7469 6f6e 732e 0a20  hic Functions.. 
│ │ │ │ +00010100: 2020 2020 2020 2043 7279 7074 6f67 7261         Cryptogra
│ │ │ │ +00010110: 7068 6963 2046 756e 6374 696f 6e73 2e0a  phic Functions..
│ │ │ │  00010120: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00010130: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00010140: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00010150: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ -00010160: 6520 3133 3037 290a 2a20 7368 6973 6869  e 1307).* shishi
│ │ │ │ -00010170: 5f63 7279 7074 6f5f 636c 6f73 653a 2020  _crypto_close:  
│ │ │ │ +00010150: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ +00010160: 6e65 2031 3330 3729 0a2a 2073 6869 7368  ne 1307).* shish
│ │ │ │ +00010170: 695f 6372 7970 746f 5f63 6c6f 7365 3a20  i_crypto_close: 
│ │ │ │  00010180: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00010190: 2043 7279 7074 6f67 7261 7068 6963 2046   Cryptographic F
│ │ │ │ -000101a0: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │ +00010190: 2020 4372 7970 746f 6772 6170 6869 6320    Cryptographic 
│ │ │ │ +000101a0: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │  000101b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000101c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000101d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000101e0: 2020 2020 2020 2028 6c69 6e65 2031 3337         (line 137
│ │ │ │ -000101f0: 3629 0a2a 2073 6869 7368 695f 6372 7970  6).* shishi_cryp
│ │ │ │ -00010200: 746f 5f64 6563 7279 7074 3a20 2020 2020  to_decrypt:     
│ │ │ │ -00010210: 2020 2020 2020 2020 2020 2020 4372 7970              Cryp
│ │ │ │ -00010220: 746f 6772 6170 6869 6320 4675 6e63 7469  tographic Functi
│ │ │ │ -00010230: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │ +000101e0: 2020 2020 2020 2020 286c 696e 6520 3133          (line 13
│ │ │ │ +000101f0: 3736 290a 2a20 7368 6973 6869 5f63 7279  76).* shishi_cry
│ │ │ │ +00010200: 7074 6f5f 6465 6372 7970 743a 2020 2020  pto_decrypt:    
│ │ │ │ +00010210: 2020 2020 2020 2020 2020 2020 2043 7279               Cry
│ │ │ │ +00010220: 7074 6f67 7261 7068 6963 2046 756e 6374  ptographic Funct
│ │ │ │ +00010230: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │  00010240: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00010250: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00010260: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00010270: 2020 286c 696e 6520 3133 3535 290a 2a20    (line 1355).* 
│ │ │ │ -00010280: 7368 6973 6869 5f63 7279 7074 6f5f 656e  shishi_crypto_en
│ │ │ │ -00010290: 6372 7970 743a 2020 2020 2020 2020 2020  crypt:          
│ │ │ │ -000102a0: 2020 2020 2020 2043 7279 7074 6f67 7261         Cryptogra
│ │ │ │ -000102b0: 7068 6963 2046 756e 6374 696f 6e73 2e0a  phic Functions..
│ │ │ │ -000102c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +00010270: 2020 2028 6c69 6e65 2031 3335 3529 0a2a     (line 1355).*
│ │ │ │ +00010280: 2073 6869 7368 695f 6372 7970 746f 5f65   shishi_crypto_e
│ │ │ │ +00010290: 6e63 7279 7074 3a20 2020 2020 2020 2020  ncrypt:         
│ │ │ │ +000102a0: 2020 2020 2020 2020 4372 7970 746f 6772          Cryptogr
│ │ │ │ +000102b0: 6170 6869 6320 4675 6e63 7469 6f6e 732e  aphic Functions.
│ │ │ │ +000102c0: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │  000102d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000102e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000102f0: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ -00010300: 6e65 2031 3333 3429 0a2a 2073 6869 7368  ne 1334).* shish
│ │ │ │ -00010310: 695f 6374 696d 653a 2020 2020 2020 2020  i_ctime:        
│ │ │ │ +000102f0: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ +00010300: 696e 6520 3133 3334 290a 2a20 7368 6973  ine 1334).* shis
│ │ │ │ +00010310: 6869 5f63 7469 6d65 3a20 2020 2020 2020  hi_ctime:       
│ │ │ │  00010320: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00010330: 2020 5574 696c 6974 7920 4675 6e63 7469    Utility Functi
│ │ │ │ -00010340: 6f6e 732e 2020 286c 696e 6520 2034 3235  ons.  (line  425
│ │ │ │ -00010350: 290a 2a20 7368 6973 6869 5f64 6563 7279  ).* shishi_decry
│ │ │ │ -00010360: 7074 3a20 2020 2020 2020 2020 2020 2020  pt:             
│ │ │ │ -00010370: 2020 2020 2020 2020 2020 2043 7279 7074             Crypt
│ │ │ │ -00010380: 6f67 7261 7068 6963 2046 756e 6374 696f  ographic Functio
│ │ │ │ -00010390: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │ +00010330: 2020 2055 7469 6c69 7479 2046 756e 6374     Utility Funct
│ │ │ │ +00010340: 696f 6e73 2e20 2028 6c69 6e65 2020 3432  ions.  (line  42
│ │ │ │ +00010350: 3529 0a2a 2073 6869 7368 695f 6465 6372  5).* shishi_decr
│ │ │ │ +00010360: 7970 743a 2020 2020 2020 2020 2020 2020  ypt:            
│ │ │ │ +00010370: 2020 2020 2020 2020 2020 2020 4372 7970              Cryp
│ │ │ │ +00010380: 746f 6772 6170 6869 6320 4675 6e63 7469  tographic Functi
│ │ │ │ +00010390: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │  000103a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000103b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000103c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000103d0: 2028 6c69 6e65 2031 3231 3129 0a2a 2073   (line 1211).* s
│ │ │ │ -000103e0: 6869 7368 695f 6465 6372 7970 745f 6574  hishi_decrypt_et
│ │ │ │ -000103f0: 7970 653a 2020 2020 2020 2020 2020 2020  ype:            
│ │ │ │ -00010400: 2020 2020 2020 4372 7970 746f 6772 6170        Cryptograp
│ │ │ │ -00010410: 6869 6320 4675 6e63 7469 6f6e 732e 0a20  hic Functions.. 
│ │ │ │ +000103d0: 2020 286c 696e 6520 3132 3131 290a 2a20    (line 1211).* 
│ │ │ │ +000103e0: 7368 6973 6869 5f64 6563 7279 7074 5f65  shishi_decrypt_e
│ │ │ │ +000103f0: 7479 7065 3a20 2020 2020 2020 2020 2020  type:           
│ │ │ │ +00010400: 2020 2020 2020 2043 7279 7074 6f67 7261         Cryptogra
│ │ │ │ +00010410: 7068 6963 2046 756e 6374 696f 6e73 2e0a  phic Functions..
│ │ │ │  00010420: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00010430: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00010440: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00010450: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ -00010460: 6520 3131 3037 290a 2a20 7368 6973 6869  e 1107).* shishi
│ │ │ │ -00010470: 5f64 6563 7279 7074 5f69 763a 2020 2020  _decrypt_iv:    
│ │ │ │ +00010450: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ +00010460: 6e65 2031 3130 3729 0a2a 2073 6869 7368  ne 1107).* shish
│ │ │ │ +00010470: 695f 6465 6372 7970 745f 6976 3a20 2020  i_decrypt_iv:   
│ │ │ │  00010480: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00010490: 2043 7279 7074 6f67 7261 7068 6963 2046   Cryptographic F
│ │ │ │ -000104a0: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │ +00010490: 2020 4372 7970 746f 6772 6170 6869 6320    Cryptographic 
│ │ │ │ +000104a0: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │  000104b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000104c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000104d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000104e0: 2020 2020 2020 2028 6c69 6e65 2031 3137         (line 117
│ │ │ │ -000104f0: 3829 0a2a 2073 6869 7368 695f 6465 6372  8).* shishi_decr
│ │ │ │ -00010500: 7970 745f 6976 5f65 7479 7065 3a20 2020  ypt_iv_etype:   
│ │ │ │ -00010510: 2020 2020 2020 2020 2020 2020 4372 7970              Cryp
│ │ │ │ -00010520: 746f 6772 6170 6869 6320 4675 6e63 7469  tographic Functi
│ │ │ │ -00010530: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │ +000104e0: 2020 2020 2020 2020 286c 696e 6520 3131          (line 11
│ │ │ │ +000104f0: 3738 290a 2a20 7368 6973 6869 5f64 6563  78).* shishi_dec
│ │ │ │ +00010500: 7279 7074 5f69 765f 6574 7970 653a 2020  rypt_iv_etype:  
│ │ │ │ +00010510: 2020 2020 2020 2020 2020 2020 2043 7279               Cry
│ │ │ │ +00010520: 7074 6f67 7261 7068 6963 2046 756e 6374  ptographic Funct
│ │ │ │ +00010530: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │  00010540: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00010550: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00010560: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00010570: 2020 286c 696e 6520 3130 3732 290a 2a20    (line 1072).* 
│ │ │ │ -00010580: 7368 6973 6869 5f64 6563 7279 7074 5f69  shishi_decrypt_i
│ │ │ │ -00010590: 7675 7064 6174 653a 2020 2020 2020 2020  vupdate:        
│ │ │ │ -000105a0: 2020 2020 2020 2043 7279 7074 6f67 7261         Cryptogra
│ │ │ │ -000105b0: 7068 6963 2046 756e 6374 696f 6e73 2e0a  phic Functions..
│ │ │ │ -000105c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +00010570: 2020 2028 6c69 6e65 2031 3037 3229 0a2a     (line 1072).*
│ │ │ │ +00010580: 2073 6869 7368 695f 6465 6372 7970 745f   shishi_decrypt_
│ │ │ │ +00010590: 6976 7570 6461 7465 3a20 2020 2020 2020  ivupdate:       
│ │ │ │ +000105a0: 2020 2020 2020 2020 4372 7970 746f 6772          Cryptogr
│ │ │ │ +000105b0: 6170 6869 6320 4675 6e63 7469 6f6e 732e  aphic Functions.
│ │ │ │ +000105c0: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │  000105d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000105e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000105f0: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ -00010600: 6e65 2031 3134 3029 0a2a 2073 6869 7368  ne 1140).* shish
│ │ │ │ -00010610: 695f 6465 6372 7970 745f 6976 7570 6461  i_decrypt_ivupda
│ │ │ │ -00010620: 7465 5f65 7479 7065 3a20 2020 2020 2020  te_etype:       
│ │ │ │ -00010630: 2020 4372 7970 746f 6772 6170 6869 6320    Cryptographic 
│ │ │ │ -00010640: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │ +000105f0: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ +00010600: 696e 6520 3131 3430 290a 2a20 7368 6973  ine 1140).* shis
│ │ │ │ +00010610: 6869 5f64 6563 7279 7074 5f69 7675 7064  hi_decrypt_ivupd
│ │ │ │ +00010620: 6174 655f 6574 7970 653a 2020 2020 2020  ate_etype:      
│ │ │ │ +00010630: 2020 2043 7279 7074 6f67 7261 7068 6963     Cryptographic
│ │ │ │ +00010640: 2046 756e 6374 696f 6e73 2e0a 2020 2020   Functions..    
│ │ │ │  00010650: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00010660: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00010670: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00010680: 2020 2020 2020 2020 286c 696e 6520 3130          (line 10
│ │ │ │ -00010690: 3332 290a 2a20 7368 6973 6869 5f64 6572  32).* shishi_der
│ │ │ │ -000106a0: 5f6d 7367 7479 7065 3a20 2020 2020 2020  _msgtype:       
│ │ │ │ -000106b0: 2020 2020 2020 2020 2020 2020 2041 534e               ASN
│ │ │ │ -000106c0: 2e31 2046 756e 6374 696f 6e73 2e20 2020  .1 Functions.   
│ │ │ │ -000106d0: 2028 6c69 6e65 2020 3335 3929 0a2a 2073   (line  359).* s
│ │ │ │ -000106e0: 6869 7368 695f 6465 7232 6173 6e31 3a20  hishi_der2asn1: 
│ │ │ │ +00010680: 2020 2020 2020 2020 2028 6c69 6e65 2031           (line 1
│ │ │ │ +00010690: 3033 3229 0a2a 2073 6869 7368 695f 6465  032).* shishi_de
│ │ │ │ +000106a0: 725f 6d73 6774 7970 653a 2020 2020 2020  r_msgtype:      
│ │ │ │ +000106b0: 2020 2020 2020 2020 2020 2020 2020 4153                AS
│ │ │ │ +000106c0: 4e2e 3120 4675 6e63 7469 6f6e 732e 2020  N.1 Functions.  
│ │ │ │ +000106d0: 2020 286c 696e 6520 2033 3539 290a 2a20    (line  359).* 
│ │ │ │ +000106e0: 7368 6973 6869 5f64 6572 3261 736e 313a  shishi_der2asn1:
│ │ │ │  000106f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00010700: 2020 2020 2020 4153 4e2e 3120 4675 6e63        ASN.1 Func
│ │ │ │ -00010710: 7469 6f6e 732e 2020 2020 286c 696e 6520  tions.    (line 
│ │ │ │ -00010720: 2033 3732 290a 2a20 7368 6973 6869 5f64   372).* shishi_d
│ │ │ │ -00010730: 6572 3261 736e 315f 6170 7265 703a 2020  er2asn1_aprep:  
│ │ │ │ -00010740: 2020 2020 2020 2020 2020 2020 2020 2041                 A
│ │ │ │ -00010750: 534e 2e31 2046 756e 6374 696f 6e73 2e20  SN.1 Functions. 
│ │ │ │ -00010760: 2020 2028 6c69 6e65 2020 3636 3729 0a2a     (line  667).*
│ │ │ │ -00010770: 2073 6869 7368 695f 6465 7232 6173 6e31   shishi_der2asn1
│ │ │ │ -00010780: 5f61 7072 6571 3a20 2020 2020 2020 2020  _apreq:         
│ │ │ │ -00010790: 2020 2020 2020 2020 4153 4e2e 3120 4675          ASN.1 Fu
│ │ │ │ -000107a0: 6e63 7469 6f6e 732e 2020 2020 286c 696e  nctions.    (lin
│ │ │ │ -000107b0: 6520 2036 3533 290a 2a20 7368 6973 6869  e  653).* shishi
│ │ │ │ -000107c0: 5f64 6572 3261 736e 315f 6173 7265 703a  _der2asn1_asrep:
│ │ │ │ -000107d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000107e0: 2041 534e 2e31 2046 756e 6374 696f 6e73   ASN.1 Functions
│ │ │ │ -000107f0: 2e20 2020 2028 6c69 6e65 2020 3439 3929  .    (line  499)
│ │ │ │ -00010800: 0a2a 2073 6869 7368 695f 6465 7232 6173  .* shishi_der2as
│ │ │ │ -00010810: 6e31 5f61 7372 6571 3a20 2020 2020 2020  n1_asreq:       
│ │ │ │ -00010820: 2020 2020 2020 2020 2020 4153 4e2e 3120            ASN.1 
│ │ │ │ -00010830: 4675 6e63 7469 6f6e 732e 2020 2020 286c  Functions.    (l
│ │ │ │ -00010840: 696e 6520 2034 3731 290a 2a20 7368 6973  ine  471).* shis
│ │ │ │ -00010850: 6869 5f64 6572 3261 736e 315f 6175 7468  hi_der2asn1_auth
│ │ │ │ -00010860: 656e 7469 6361 746f 723a 2020 2020 2020  enticator:      
│ │ │ │ -00010870: 2020 2041 534e 2e31 2046 756e 6374 696f     ASN.1 Functio
│ │ │ │ -00010880: 6e73 2e20 2020 2028 6c69 6e65 2020 3538  ns.    (line  58
│ │ │ │ -00010890: 3329 0a2a 2073 6869 7368 695f 6465 7232  3).* shishi_der2
│ │ │ │ -000108a0: 6173 6e31 5f65 6e63 6170 7265 7070 6172  asn1_encapreppar
│ │ │ │ -000108b0: 743a 2020 2020 2020 2020 2020 4153 4e2e  t:          ASN.
│ │ │ │ -000108c0: 3120 4675 6e63 7469 6f6e 732e 2020 2020  1 Functions.    
│ │ │ │ -000108d0: 286c 696e 6520 2036 3831 290a 2a20 7368  (line  681).* sh
│ │ │ │ -000108e0: 6973 6869 5f64 6572 3261 736e 315f 656e  ishi_der2asn1_en
│ │ │ │ -000108f0: 6361 7372 6570 7061 7274 3a20 2020 2020  casreppart:     
│ │ │ │ -00010900: 2020 2020 2041 534e 2e31 2046 756e 6374       ASN.1 Funct
│ │ │ │ -00010910: 696f 6e73 2e20 2020 2028 6c69 6e65 2020  ions.    (line  
│ │ │ │ -00010920: 3534 3129 0a2a 2073 6869 7368 695f 6465  541).* shishi_de
│ │ │ │ -00010930: 7232 6173 6e31 5f65 6e63 6b64 6372 6570  r2asn1_enckdcrep
│ │ │ │ -00010940: 7061 7274 3a20 2020 2020 2020 2020 4153  part:         AS
│ │ │ │ -00010950: 4e2e 3120 4675 6e63 7469 6f6e 732e 2020  N.1 Functions.  
│ │ │ │ -00010960: 2020 286c 696e 6520 2035 3639 290a 2a20    (line  569).* 
│ │ │ │ -00010970: 7368 6973 6869 5f64 6572 3261 736e 315f  shishi_der2asn1_
│ │ │ │ -00010980: 656e 6370 7269 7670 6172 743a 2020 2020  encprivpart:    
│ │ │ │ -00010990: 2020 2020 2020 2041 534e 2e31 2046 756e         ASN.1 Fun
│ │ │ │ -000109a0: 6374 696f 6e73 2e20 2020 2028 6c69 6e65  ctions.    (line
│ │ │ │ -000109b0: 2020 3633 3929 0a2a 2073 6869 7368 695f    639).* shishi_
│ │ │ │ -000109c0: 6465 7232 6173 6e31 5f65 6e63 7467 7372  der2asn1_enctgsr
│ │ │ │ -000109d0: 6570 7061 7274 3a20 2020 2020 2020 2020  eppart:         
│ │ │ │ -000109e0: 4153 4e2e 3120 4675 6e63 7469 6f6e 732e  ASN.1 Functions.
│ │ │ │ -000109f0: 2020 2020 286c 696e 6520 2035 3535 290a      (line  555).
│ │ │ │ -00010a00: 2a20 7368 6973 6869 5f64 6572 3261 736e  * shishi_der2asn
│ │ │ │ -00010a10: 315f 656e 6374 6963 6b65 7470 6172 743a  1_encticketpart:
│ │ │ │ -00010a20: 2020 2020 2020 2020 2041 534e 2e31 2046           ASN.1 F
│ │ │ │ -00010a30: 756e 6374 696f 6e73 2e20 2020 2028 6c69  unctions.    (li
│ │ │ │ -00010a40: 6e65 2020 3435 3729 0a2a 2073 6869 7368  ne  457).* shish
│ │ │ │ -00010a50: 695f 6465 7232 6173 6e31 5f65 7479 7065  i_der2asn1_etype
│ │ │ │ -00010a60: 5f69 6e66 6f3a 2020 2020 2020 2020 2020  _info:          
│ │ │ │ -00010a70: 2020 4153 4e2e 3120 4675 6e63 7469 6f6e    ASN.1 Function
│ │ │ │ -00010a80: 732e 2020 2020 286c 696e 6520 2034 3135  s.    (line  415
│ │ │ │ -00010a90: 290a 2a20 7368 6973 6869 5f64 6572 3261  ).* shishi_der2a
│ │ │ │ -00010aa0: 736e 315f 6574 7970 655f 696e 666f 323a  sn1_etype_info2:
│ │ │ │ -00010ab0: 2020 2020 2020 2020 2020 2041 534e 2e31             ASN.1
│ │ │ │ -00010ac0: 2046 756e 6374 696f 6e73 2e20 2020 2028   Functions.    (
│ │ │ │ -00010ad0: 6c69 6e65 2020 3432 3929 0a2a 2073 6869  line  429).* shi
│ │ │ │ -00010ae0: 7368 695f 6465 7232 6173 6e31 5f6b 6463  shi_der2asn1_kdc
│ │ │ │ -00010af0: 7265 703a 2020 2020 2020 2020 2020 2020  rep:            
│ │ │ │ -00010b00: 2020 2020 4153 4e2e 3120 4675 6e63 7469      ASN.1 Functi
│ │ │ │ -00010b10: 6f6e 732e 2020 2020 286c 696e 6520 2035  ons.    (line  5
│ │ │ │ -00010b20: 3237 290a 2a20 7368 6973 6869 5f64 6572  27).* shishi_der
│ │ │ │ -00010b30: 3261 736e 315f 6b64 6372 6571 3a20 2020  2asn1_kdcreq:   
│ │ │ │ -00010b40: 2020 2020 2020 2020 2020 2020 2041 534e               ASN
│ │ │ │ -00010b50: 2e31 2046 756e 6374 696f 6e73 2e20 2020  .1 Functions.   
│ │ │ │ -00010b60: 2028 6c69 6e65 2020 3639 3529 0a2a 2073   (line  695).* s
│ │ │ │ -00010b70: 6869 7368 695f 6465 7232 6173 6e31 5f6b  hishi_der2asn1_k
│ │ │ │ -00010b80: 7262 6572 726f 723a 2020 2020 2020 2020  rberror:        
│ │ │ │ -00010b90: 2020 2020 2020 4153 4e2e 3120 4675 6e63        ASN.1 Func
│ │ │ │ -00010ba0: 7469 6f6e 732e 2020 2020 286c 696e 6520  tions.    (line 
│ │ │ │ -00010bb0: 2035 3937 290a 2a20 7368 6973 6869 5f64   597).* shishi_d
│ │ │ │ -00010bc0: 6572 3261 736e 315f 6b72 6273 6166 653a  er2asn1_krbsafe:
│ │ │ │ -00010bd0: 2020 2020 2020 2020 2020 2020 2020 2041                 A
│ │ │ │ -00010be0: 534e 2e31 2046 756e 6374 696f 6e73 2e20  SN.1 Functions. 
│ │ │ │ -00010bf0: 2020 2028 6c69 6e65 2020 3631 3129 0a2a     (line  611).*
│ │ │ │ -00010c00: 2073 6869 7368 695f 6465 7232 6173 6e31   shishi_der2asn1
│ │ │ │ -00010c10: 5f6d 6574 686f 6464 6174 613a 2020 2020  _methoddata:    
│ │ │ │ -00010c20: 2020 2020 2020 2020 4153 4e2e 3120 4675          ASN.1 Fu
│ │ │ │ -00010c30: 6e63 7469 6f6e 732e 2020 2020 286c 696e  nctions.    (lin
│ │ │ │ -00010c40: 6520 2034 3031 290a 2a20 7368 6973 6869  e  401).* shishi
│ │ │ │ -00010c50: 5f64 6572 3261 736e 315f 7061 6461 7461  _der2asn1_padata
│ │ │ │ -00010c60: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ -00010c70: 2041 534e 2e31 2046 756e 6374 696f 6e73   ASN.1 Functions
│ │ │ │ -00010c80: 2e20 2020 2028 6c69 6e65 2020 3338 3729  .    (line  387)
│ │ │ │ -00010c90: 0a2a 2073 6869 7368 695f 6465 7232 6173  .* shishi_der2as
│ │ │ │ -00010ca0: 6e31 5f70 7269 763a 2020 2020 2020 2020  n1_priv:        
│ │ │ │ -00010cb0: 2020 2020 2020 2020 2020 4153 4e2e 3120            ASN.1 
│ │ │ │ -00010cc0: 4675 6e63 7469 6f6e 732e 2020 2020 286c  Functions.    (l
│ │ │ │ -00010cd0: 696e 6520 2036 3235 290a 2a20 7368 6973  ine  625).* shis
│ │ │ │ -00010ce0: 6869 5f64 6572 3261 736e 315f 7467 7372  hi_der2asn1_tgsr
│ │ │ │ -00010cf0: 6570 3a20 2020 2020 2020 2020 2020 2020  ep:             
│ │ │ │ -00010d00: 2020 2041 534e 2e31 2046 756e 6374 696f     ASN.1 Functio
│ │ │ │ -00010d10: 6e73 2e20 2020 2028 6c69 6e65 2020 3531  ns.    (line  51
│ │ │ │ -00010d20: 3329 0a2a 2073 6869 7368 695f 6465 7232  3).* shishi_der2
│ │ │ │ -00010d30: 6173 6e31 5f74 6773 7265 713a 2020 2020  asn1_tgsreq:    
│ │ │ │ -00010d40: 2020 2020 2020 2020 2020 2020 4153 4e2e              ASN.
│ │ │ │ -00010d50: 3120 4675 6e63 7469 6f6e 732e 2020 2020  1 Functions.    
│ │ │ │ -00010d60: 286c 696e 6520 2034 3835 290a 2a20 7368  (line  485).* sh
│ │ │ │ -00010d70: 6973 6869 5f64 6572 3261 736e 315f 7469  ishi_der2asn1_ti
│ │ │ │ -00010d80: 636b 6574 3a20 2020 2020 2020 2020 2020  cket:           
│ │ │ │ -00010d90: 2020 2020 2041 534e 2e31 2046 756e 6374       ASN.1 Funct
│ │ │ │ -00010da0: 696f 6e73 2e20 2020 2028 6c69 6e65 2020  ions.    (line  
│ │ │ │ -00010db0: 3434 3329 0a2a 2073 6869 7368 695f 6465  443).* shishi_de
│ │ │ │ -00010dc0: 7269 7665 5f64 6566 6175 6c74 5f73 616c  rive_default_sal
│ │ │ │ -00010dd0: 743a 2020 2020 2020 2020 2020 2020 5574  t:            Ut
│ │ │ │ -00010de0: 696c 6974 7920 4675 6e63 7469 6f6e 732e  ility Functions.
│ │ │ │ -00010df0: 2020 286c 696e 6520 2032 3734 290a 2a20    (line  274).* 
│ │ │ │ -00010e00: 7368 6973 6869 5f64 6573 3a20 2020 2020  shishi_des:     
│ │ │ │ +00010700: 2020 2020 2020 2041 534e 2e31 2046 756e         ASN.1 Fun
│ │ │ │ +00010710: 6374 696f 6e73 2e20 2020 2028 6c69 6e65  ctions.    (line
│ │ │ │ +00010720: 2020 3337 3229 0a2a 2073 6869 7368 695f    372).* shishi_
│ │ │ │ +00010730: 6465 7232 6173 6e31 5f61 7072 6570 3a20  der2asn1_aprep: 
│ │ │ │ +00010740: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +00010750: 4153 4e2e 3120 4675 6e63 7469 6f6e 732e  ASN.1 Functions.
│ │ │ │ +00010760: 2020 2020 286c 696e 6520 2036 3637 290a      (line  667).
│ │ │ │ +00010770: 2a20 7368 6973 6869 5f64 6572 3261 736e  * shishi_der2asn
│ │ │ │ +00010780: 315f 6170 7265 713a 2020 2020 2020 2020  1_apreq:        
│ │ │ │ +00010790: 2020 2020 2020 2020 2041 534e 2e31 2046           ASN.1 F
│ │ │ │ +000107a0: 756e 6374 696f 6e73 2e20 2020 2028 6c69  unctions.    (li
│ │ │ │ +000107b0: 6e65 2020 3635 3329 0a2a 2073 6869 7368  ne  653).* shish
│ │ │ │ +000107c0: 695f 6465 7232 6173 6e31 5f61 7372 6570  i_der2asn1_asrep
│ │ │ │ +000107d0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ +000107e0: 2020 4153 4e2e 3120 4675 6e63 7469 6f6e    ASN.1 Function
│ │ │ │ +000107f0: 732e 2020 2020 286c 696e 6520 2034 3939  s.    (line  499
│ │ │ │ +00010800: 290a 2a20 7368 6973 6869 5f64 6572 3261  ).* shishi_der2a
│ │ │ │ +00010810: 736e 315f 6173 7265 713a 2020 2020 2020  sn1_asreq:      
│ │ │ │ +00010820: 2020 2020 2020 2020 2020 2041 534e 2e31             ASN.1
│ │ │ │ +00010830: 2046 756e 6374 696f 6e73 2e20 2020 2028   Functions.    (
│ │ │ │ +00010840: 6c69 6e65 2020 3437 3129 0a2a 2073 6869  line  471).* shi
│ │ │ │ +00010850: 7368 695f 6465 7232 6173 6e31 5f61 7574  shi_der2asn1_aut
│ │ │ │ +00010860: 6865 6e74 6963 6174 6f72 3a20 2020 2020  henticator:     
│ │ │ │ +00010870: 2020 2020 4153 4e2e 3120 4675 6e63 7469      ASN.1 Functi
│ │ │ │ +00010880: 6f6e 732e 2020 2020 286c 696e 6520 2035  ons.    (line  5
│ │ │ │ +00010890: 3833 290a 2a20 7368 6973 6869 5f64 6572  83).* shishi_der
│ │ │ │ +000108a0: 3261 736e 315f 656e 6361 7072 6570 7061  2asn1_encapreppa
│ │ │ │ +000108b0: 7274 3a20 2020 2020 2020 2020 2041 534e  rt:          ASN
│ │ │ │ +000108c0: 2e31 2046 756e 6374 696f 6e73 2e20 2020  .1 Functions.   
│ │ │ │ +000108d0: 2028 6c69 6e65 2020 3638 3129 0a2a 2073   (line  681).* s
│ │ │ │ +000108e0: 6869 7368 695f 6465 7232 6173 6e31 5f65  hishi_der2asn1_e
│ │ │ │ +000108f0: 6e63 6173 7265 7070 6172 743a 2020 2020  ncasreppart:    
│ │ │ │ +00010900: 2020 2020 2020 4153 4e2e 3120 4675 6e63        ASN.1 Func
│ │ │ │ +00010910: 7469 6f6e 732e 2020 2020 286c 696e 6520  tions.    (line 
│ │ │ │ +00010920: 2035 3431 290a 2a20 7368 6973 6869 5f64   541).* shishi_d
│ │ │ │ +00010930: 6572 3261 736e 315f 656e 636b 6463 7265  er2asn1_enckdcre
│ │ │ │ +00010940: 7070 6172 743a 2020 2020 2020 2020 2041  ppart:         A
│ │ │ │ +00010950: 534e 2e31 2046 756e 6374 696f 6e73 2e20  SN.1 Functions. 
│ │ │ │ +00010960: 2020 2028 6c69 6e65 2020 3536 3929 0a2a     (line  569).*
│ │ │ │ +00010970: 2073 6869 7368 695f 6465 7232 6173 6e31   shishi_der2asn1
│ │ │ │ +00010980: 5f65 6e63 7072 6976 7061 7274 3a20 2020  _encprivpart:   
│ │ │ │ +00010990: 2020 2020 2020 2020 4153 4e2e 3120 4675          ASN.1 Fu
│ │ │ │ +000109a0: 6e63 7469 6f6e 732e 2020 2020 286c 696e  nctions.    (lin
│ │ │ │ +000109b0: 6520 2036 3339 290a 2a20 7368 6973 6869  e  639).* shishi
│ │ │ │ +000109c0: 5f64 6572 3261 736e 315f 656e 6374 6773  _der2asn1_enctgs
│ │ │ │ +000109d0: 7265 7070 6172 743a 2020 2020 2020 2020  reppart:        
│ │ │ │ +000109e0: 2041 534e 2e31 2046 756e 6374 696f 6e73   ASN.1 Functions
│ │ │ │ +000109f0: 2e20 2020 2028 6c69 6e65 2020 3535 3529  .    (line  555)
│ │ │ │ +00010a00: 0a2a 2073 6869 7368 695f 6465 7232 6173  .* shishi_der2as
│ │ │ │ +00010a10: 6e31 5f65 6e63 7469 636b 6574 7061 7274  n1_encticketpart
│ │ │ │ +00010a20: 3a20 2020 2020 2020 2020 4153 4e2e 3120  :         ASN.1 
│ │ │ │ +00010a30: 4675 6e63 7469 6f6e 732e 2020 2020 286c  Functions.    (l
│ │ │ │ +00010a40: 696e 6520 2034 3537 290a 2a20 7368 6973  ine  457).* shis
│ │ │ │ +00010a50: 6869 5f64 6572 3261 736e 315f 6574 7970  hi_der2asn1_etyp
│ │ │ │ +00010a60: 655f 696e 666f 3a20 2020 2020 2020 2020  e_info:         
│ │ │ │ +00010a70: 2020 2041 534e 2e31 2046 756e 6374 696f     ASN.1 Functio
│ │ │ │ +00010a80: 6e73 2e20 2020 2028 6c69 6e65 2020 3431  ns.    (line  41
│ │ │ │ +00010a90: 3529 0a2a 2073 6869 7368 695f 6465 7232  5).* shishi_der2
│ │ │ │ +00010aa0: 6173 6e31 5f65 7479 7065 5f69 6e66 6f32  asn1_etype_info2
│ │ │ │ +00010ab0: 3a20 2020 2020 2020 2020 2020 4153 4e2e  :           ASN.
│ │ │ │ +00010ac0: 3120 4675 6e63 7469 6f6e 732e 2020 2020  1 Functions.    
│ │ │ │ +00010ad0: 286c 696e 6520 2034 3239 290a 2a20 7368  (line  429).* sh
│ │ │ │ +00010ae0: 6973 6869 5f64 6572 3261 736e 315f 6b64  ishi_der2asn1_kd
│ │ │ │ +00010af0: 6372 6570 3a20 2020 2020 2020 2020 2020  crep:           
│ │ │ │ +00010b00: 2020 2020 2041 534e 2e31 2046 756e 6374       ASN.1 Funct
│ │ │ │ +00010b10: 696f 6e73 2e20 2020 2028 6c69 6e65 2020  ions.    (line  
│ │ │ │ +00010b20: 3532 3729 0a2a 2073 6869 7368 695f 6465  527).* shishi_de
│ │ │ │ +00010b30: 7232 6173 6e31 5f6b 6463 7265 713a 2020  r2asn1_kdcreq:  
│ │ │ │ +00010b40: 2020 2020 2020 2020 2020 2020 2020 4153                AS
│ │ │ │ +00010b50: 4e2e 3120 4675 6e63 7469 6f6e 732e 2020  N.1 Functions.  
│ │ │ │ +00010b60: 2020 286c 696e 6520 2036 3935 290a 2a20    (line  695).* 
│ │ │ │ +00010b70: 7368 6973 6869 5f64 6572 3261 736e 315f  shishi_der2asn1_
│ │ │ │ +00010b80: 6b72 6265 7272 6f72 3a20 2020 2020 2020  krberror:       
│ │ │ │ +00010b90: 2020 2020 2020 2041 534e 2e31 2046 756e         ASN.1 Fun
│ │ │ │ +00010ba0: 6374 696f 6e73 2e20 2020 2028 6c69 6e65  ctions.    (line
│ │ │ │ +00010bb0: 2020 3539 3729 0a2a 2073 6869 7368 695f    597).* shishi_
│ │ │ │ +00010bc0: 6465 7232 6173 6e31 5f6b 7262 7361 6665  der2asn1_krbsafe
│ │ │ │ +00010bd0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ +00010be0: 4153 4e2e 3120 4675 6e63 7469 6f6e 732e  ASN.1 Functions.
│ │ │ │ +00010bf0: 2020 2020 286c 696e 6520 2036 3131 290a      (line  611).
│ │ │ │ +00010c00: 2a20 7368 6973 6869 5f64 6572 3261 736e  * shishi_der2asn
│ │ │ │ +00010c10: 315f 6d65 7468 6f64 6461 7461 3a20 2020  1_methoddata:   
│ │ │ │ +00010c20: 2020 2020 2020 2020 2041 534e 2e31 2046           ASN.1 F
│ │ │ │ +00010c30: 756e 6374 696f 6e73 2e20 2020 2028 6c69  unctions.    (li
│ │ │ │ +00010c40: 6e65 2020 3430 3129 0a2a 2073 6869 7368  ne  401).* shish
│ │ │ │ +00010c50: 695f 6465 7232 6173 6e31 5f70 6164 6174  i_der2asn1_padat
│ │ │ │ +00010c60: 613a 2020 2020 2020 2020 2020 2020 2020  a:              
│ │ │ │ +00010c70: 2020 4153 4e2e 3120 4675 6e63 7469 6f6e    ASN.1 Function
│ │ │ │ +00010c80: 732e 2020 2020 286c 696e 6520 2033 3837  s.    (line  387
│ │ │ │ +00010c90: 290a 2a20 7368 6973 6869 5f64 6572 3261  ).* shishi_der2a
│ │ │ │ +00010ca0: 736e 315f 7072 6976 3a20 2020 2020 2020  sn1_priv:       
│ │ │ │ +00010cb0: 2020 2020 2020 2020 2020 2041 534e 2e31             ASN.1
│ │ │ │ +00010cc0: 2046 756e 6374 696f 6e73 2e20 2020 2028   Functions.    (
│ │ │ │ +00010cd0: 6c69 6e65 2020 3632 3529 0a2a 2073 6869  line  625).* shi
│ │ │ │ +00010ce0: 7368 695f 6465 7232 6173 6e31 5f74 6773  shi_der2asn1_tgs
│ │ │ │ +00010cf0: 7265 703a 2020 2020 2020 2020 2020 2020  rep:            
│ │ │ │ +00010d00: 2020 2020 4153 4e2e 3120 4675 6e63 7469      ASN.1 Functi
│ │ │ │ +00010d10: 6f6e 732e 2020 2020 286c 696e 6520 2035  ons.    (line  5
│ │ │ │ +00010d20: 3133 290a 2a20 7368 6973 6869 5f64 6572  13).* shishi_der
│ │ │ │ +00010d30: 3261 736e 315f 7467 7372 6571 3a20 2020  2asn1_tgsreq:   
│ │ │ │ +00010d40: 2020 2020 2020 2020 2020 2020 2041 534e               ASN
│ │ │ │ +00010d50: 2e31 2046 756e 6374 696f 6e73 2e20 2020  .1 Functions.   
│ │ │ │ +00010d60: 2028 6c69 6e65 2020 3438 3529 0a2a 2073   (line  485).* s
│ │ │ │ +00010d70: 6869 7368 695f 6465 7232 6173 6e31 5f74  hishi_der2asn1_t
│ │ │ │ +00010d80: 6963 6b65 743a 2020 2020 2020 2020 2020  icket:          
│ │ │ │ +00010d90: 2020 2020 2020 4153 4e2e 3120 4675 6e63        ASN.1 Func
│ │ │ │ +00010da0: 7469 6f6e 732e 2020 2020 286c 696e 6520  tions.    (line 
│ │ │ │ +00010db0: 2034 3433 290a 2a20 7368 6973 6869 5f64   443).* shishi_d
│ │ │ │ +00010dc0: 6572 6976 655f 6465 6661 756c 745f 7361  erive_default_sa
│ │ │ │ +00010dd0: 6c74 3a20 2020 2020 2020 2020 2020 2055  lt:            U
│ │ │ │ +00010de0: 7469 6c69 7479 2046 756e 6374 696f 6e73  tility Functions
│ │ │ │ +00010df0: 2e20 2028 6c69 6e65 2020 3237 3429 0a2a  .  (line  274).*
│ │ │ │ +00010e00: 2073 6869 7368 695f 6465 733a 2020 2020   shishi_des:    
│ │ │ │  00010e10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00010e20: 2020 2020 2020 2043 7279 7074 6f67 7261         Cryptogra
│ │ │ │ -00010e30: 7068 6963 2046 756e 6374 696f 6e73 2e0a  phic Functions..
│ │ │ │ -00010e40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +00010e20: 2020 2020 2020 2020 4372 7970 746f 6772          Cryptogr
│ │ │ │ +00010e30: 6170 6869 6320 4675 6e63 7469 6f6e 732e  aphic Functions.
│ │ │ │ +00010e40: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │  00010e50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00010e60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00010e70: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ -00010e80: 6e65 2031 3534 3029 0a2a 2073 6869 7368  ne 1540).* shish
│ │ │ │ -00010e90: 695f 6465 735f 6362 635f 6d61 633a 2020  i_des_cbc_mac:  
│ │ │ │ +00010e70: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ +00010e80: 696e 6520 3135 3430 290a 2a20 7368 6973  ine 1540).* shis
│ │ │ │ +00010e90: 6869 5f64 6573 5f63 6263 5f6d 6163 3a20  hi_des_cbc_mac: 
│ │ │ │  00010ea0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00010eb0: 2020 4372 7970 746f 6772 6170 6869 6320    Cryptographic 
│ │ │ │ -00010ec0: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │ +00010eb0: 2020 2043 7279 7074 6f67 7261 7068 6963     Cryptographic
│ │ │ │ +00010ec0: 2046 756e 6374 696f 6e73 2e0a 2020 2020   Functions..    
│ │ │ │  00010ed0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00010ee0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00010ef0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00010f00: 2020 2020 2020 2020 286c 696e 6520 3134          (line 14
│ │ │ │ -00010f10: 3932 290a 2a20 7368 6973 6869 5f64 6b3a  92).* shishi_dk:
│ │ │ │ -00010f20: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00010f30: 2020 2020 2020 2020 2020 2020 2043 7279               Cry
│ │ │ │ -00010f40: 7074 6f67 7261 7068 6963 2046 756e 6374  ptographic Funct
│ │ │ │ -00010f50: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │ +00010f00: 2020 2020 2020 2020 2028 6c69 6e65 2031           (line 1
│ │ │ │ +00010f10: 3439 3229 0a2a 2073 6869 7368 695f 646b  492).* shishi_dk
│ │ │ │ +00010f20: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ +00010f30: 2020 2020 2020 2020 2020 2020 2020 4372                Cr
│ │ │ │ +00010f40: 7970 746f 6772 6170 6869 6320 4675 6e63  yptographic Func
│ │ │ │ +00010f50: 7469 6f6e 732e 0a20 2020 2020 2020 2020  tions..         
│ │ │ │  00010f60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00010f70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00010f80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00010f90: 2020 2028 6c69 6e65 2031 3238 3429 0a2a     (line 1284).*
│ │ │ │ -00010fa0: 2073 6869 7368 695f 646f 6e65 3a20 2020   shishi_done:   
│ │ │ │ +00010f90: 2020 2020 286c 696e 6520 3132 3834 290a      (line 1284).
│ │ │ │ +00010fa0: 2a20 7368 6973 6869 5f64 6f6e 653a 2020  * shishi_done:  
│ │ │ │  00010fb0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00010fc0: 2020 2020 2020 2020 496e 6974 6961 6c69          Initiali
│ │ │ │ -00010fd0: 7a61 7469 6f6e 2046 756e 6374 696f 6e73  zation Functions
│ │ │ │ -00010fe0: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │ +00010fc0: 2020 2020 2020 2020 2049 6e69 7469 616c           Initial
│ │ │ │ +00010fd0: 697a 6174 696f 6e20 4675 6e63 7469 6f6e  ization Function
│ │ │ │ +00010fe0: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │  00010ff0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00011000: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00011010: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ -00011020: 6c69 6e65 2020 2033 3529 0a2a 2073 6869  line   35).* shi
│ │ │ │ -00011030: 7368 695f 6472 3a20 2020 2020 2020 2020  shi_dr:         
│ │ │ │ +00011010: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +00011020: 286c 696e 6520 2020 3335 290a 2a20 7368  (line   35).* sh
│ │ │ │ +00011030: 6973 6869 5f64 723a 2020 2020 2020 2020  ishi_dr:        
│ │ │ │  00011040: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00011050: 2020 2020 4372 7970 746f 6772 6170 6869      Cryptographi
│ │ │ │ -00011060: 6320 4675 6e63 7469 6f6e 732e 0a20 2020  c Functions..   
│ │ │ │ +00011050: 2020 2020 2043 7279 7074 6f67 7261 7068       Cryptograph
│ │ │ │ +00011060: 6963 2046 756e 6374 696f 6e73 2e0a 2020  ic Functions..  
│ │ │ │  00011070: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00011080: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00011090: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000110a0: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ -000110b0: 3132 3635 290a 2a20 7368 6973 6869 5f65  1265).* shishi_e
│ │ │ │ -000110c0: 6e63 6170 7265 7070 6172 743a 2020 2020  ncapreppart:    
│ │ │ │ -000110d0: 2020 2020 2020 2020 2020 2020 2020 2041                 A
│ │ │ │ -000110e0: 502d 5245 5120 616e 6420 4150 2d52 4550  P-REQ and AP-REP
│ │ │ │ -000110f0: 2046 756e 6374 696f 6e73 2e0a 2020 2020   Functions..    
│ │ │ │ +000110a0: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ +000110b0: 2031 3236 3529 0a2a 2073 6869 7368 695f   1265).* shishi_
│ │ │ │ +000110c0: 656e 6361 7072 6570 7061 7274 3a20 2020  encapreppart:   
│ │ │ │ +000110d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +000110e0: 4150 2d52 4551 2061 6e64 2041 502d 5245  AP-REQ and AP-RE
│ │ │ │ +000110f0: 5020 4675 6e63 7469 6f6e 732e 0a20 2020  P Functions..   
│ │ │ │  00011100: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00011110: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00011120: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00011130: 2020 2020 2020 2020 2028 6c69 6e65 2031           (line 1
│ │ │ │ -00011140: 3035 3829 0a2a 2073 6869 7368 695f 656e  058).* shishi_en
│ │ │ │ -00011150: 6361 7072 6570 7061 7274 5f63 7469 6d65  capreppart_ctime
│ │ │ │ -00011160: 3a20 2020 2020 2020 2020 2020 2020 4150  :             AP
│ │ │ │ -00011170: 2d52 4551 2061 6e64 2041 502d 5245 5020  -REQ and AP-REP 
│ │ │ │ -00011180: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │ +00011130: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ +00011140: 3130 3538 290a 2a20 7368 6973 6869 5f65  1058).* shishi_e
│ │ │ │ +00011150: 6e63 6170 7265 7070 6172 745f 6374 696d  ncapreppart_ctim
│ │ │ │ +00011160: 653a 2020 2020 2020 2020 2020 2020 2041  e:             A
│ │ │ │ +00011170: 502d 5245 5120 616e 6420 4150 2d52 4550  P-REQ and AP-REP
│ │ │ │ +00011180: 2046 756e 6374 696f 6e73 2e0a 2020 2020   Functions..    
│ │ │ │  00011190: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000111a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000111b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000111c0: 2020 2020 2020 2020 286c 696e 6520 3131          (line 11
│ │ │ │ -000111d0: 3730 290a 2a20 7368 6973 6869 5f65 6e63  70).* shishi_enc
│ │ │ │ -000111e0: 6170 7265 7070 6172 745f 6374 696d 655f  apreppart_ctime_
│ │ │ │ -000111f0: 7365 743a 2020 2020 2020 2020 2041 502d  set:         AP-
│ │ │ │ -00011200: 5245 5120 616e 6420 4150 2d52 4550 2046  REQ and AP-REP F
│ │ │ │ -00011210: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │ +000111c0: 2020 2020 2020 2020 2028 6c69 6e65 2031           (line 1
│ │ │ │ +000111d0: 3137 3029 0a2a 2073 6869 7368 695f 656e  170).* shishi_en
│ │ │ │ +000111e0: 6361 7072 6570 7061 7274 5f63 7469 6d65  capreppart_ctime
│ │ │ │ +000111f0: 5f73 6574 3a20 2020 2020 2020 2020 4150  _set:         AP
│ │ │ │ +00011200: 2d52 4551 2061 6e64 2041 502d 5245 5020  -REQ and AP-REP 
│ │ │ │ +00011210: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │  00011220: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00011230: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00011240: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00011250: 2020 2020 2020 2028 6c69 6e65 2031 3138         (line 118
│ │ │ │ -00011260: 3529 0a2a 2073 6869 7368 695f 656e 6361  5).* shishi_enca
│ │ │ │ -00011270: 7072 6570 7061 7274 5f63 7573 6563 5f67  preppart_cusec_g
│ │ │ │ -00011280: 6574 3a20 2020 2020 2020 2020 4150 2d52  et:         AP-R
│ │ │ │ -00011290: 4551 2061 6e64 2041 502d 5245 5020 4675  EQ and AP-REP Fu
│ │ │ │ -000112a0: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │ +00011250: 2020 2020 2020 2020 286c 696e 6520 3131          (line 11
│ │ │ │ +00011260: 3835 290a 2a20 7368 6973 6869 5f65 6e63  85).* shishi_enc
│ │ │ │ +00011270: 6170 7265 7070 6172 745f 6375 7365 635f  apreppart_cusec_
│ │ │ │ +00011280: 6765 743a 2020 2020 2020 2020 2041 502d  get:         AP-
│ │ │ │ +00011290: 5245 5120 616e 6420 4150 2d52 4550 2046  REQ and AP-REP F
│ │ │ │ +000112a0: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │  000112b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000112c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000112d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000112e0: 2020 2020 2020 286c 696e 6520 3131 3939        (line 1199
│ │ │ │ -000112f0: 290a 2a20 7368 6973 6869 5f65 6e63 6170  ).* shishi_encap
│ │ │ │ -00011300: 7265 7070 6172 745f 6375 7365 635f 7365  reppart_cusec_se
│ │ │ │ -00011310: 743a 2020 2020 2020 2020 2041 502d 5245  t:         AP-RE
│ │ │ │ -00011320: 5120 616e 6420 4150 2d52 4550 2046 756e  Q and AP-REP Fun
│ │ │ │ -00011330: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │ +000112e0: 2020 2020 2020 2028 6c69 6e65 2031 3139         (line 119
│ │ │ │ +000112f0: 3929 0a2a 2073 6869 7368 695f 656e 6361  9).* shishi_enca
│ │ │ │ +00011300: 7072 6570 7061 7274 5f63 7573 6563 5f73  preppart_cusec_s
│ │ │ │ +00011310: 6574 3a20 2020 2020 2020 2020 4150 2d52  et:         AP-R
│ │ │ │ +00011320: 4551 2061 6e64 2041 502d 5245 5020 4675  EQ and AP-REP Fu
│ │ │ │ +00011330: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │  00011340: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00011350: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00011360: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00011370: 2020 2020 2028 6c69 6e65 2031 3231 3329       (line 1213)
│ │ │ │ -00011380: 0a2a 2073 6869 7368 695f 656e 6361 7072  .* shishi_encapr
│ │ │ │ -00011390: 6570 7061 7274 5f66 726f 6d5f 6669 6c65  eppart_from_file
│ │ │ │ -000113a0: 3a20 2020 2020 2020 2020 4150 2d52 4551  :         AP-REQ
│ │ │ │ -000113b0: 2061 6e64 2041 502d 5245 5020 4675 6e63   and AP-REP Func
│ │ │ │ -000113c0: 7469 6f6e 732e 0a20 2020 2020 2020 2020  tions..         
│ │ │ │ +00011370: 2020 2020 2020 286c 696e 6520 3132 3133        (line 1213
│ │ │ │ +00011380: 290a 2a20 7368 6973 6869 5f65 6e63 6170  ).* shishi_encap
│ │ │ │ +00011390: 7265 7070 6172 745f 6672 6f6d 5f66 696c  reppart_from_fil
│ │ │ │ +000113a0: 653a 2020 2020 2020 2020 2041 502d 5245  e:         AP-RE
│ │ │ │ +000113b0: 5120 616e 6420 4150 2d52 4550 2046 756e  Q and AP-REP Fun
│ │ │ │ +000113c0: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │  000113d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000113e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000113f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00011400: 2020 2020 286c 696e 6520 3131 3431 290a      (line 1141).
│ │ │ │ -00011410: 2a20 7368 6973 6869 5f65 6e63 6170 7265  * shishi_encapre
│ │ │ │ -00011420: 7070 6172 745f 6765 745f 6b65 793a 2020  ppart_get_key:  
│ │ │ │ -00011430: 2020 2020 2020 2020 2041 502d 5245 5120           AP-REQ 
│ │ │ │ -00011440: 616e 6420 4150 2d52 4550 2046 756e 6374  and AP-REP Funct
│ │ │ │ -00011450: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │ +00011400: 2020 2020 2028 6c69 6e65 2031 3134 3129       (line 1141)
│ │ │ │ +00011410: 0a2a 2073 6869 7368 695f 656e 6361 7072  .* shishi_encapr
│ │ │ │ +00011420: 6570 7061 7274 5f67 6574 5f6b 6579 3a20  eppart_get_key: 
│ │ │ │ +00011430: 2020 2020 2020 2020 2020 4150 2d52 4551            AP-REQ
│ │ │ │ +00011440: 2061 6e64 2041 502d 5245 5020 4675 6e63   and AP-REP Func
│ │ │ │ +00011450: 7469 6f6e 732e 0a20 2020 2020 2020 2020  tions..         
│ │ │ │  00011460: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00011470: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00011480: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00011490: 2020 2028 6c69 6e65 2031 3135 3729 0a2a     (line 1157).*
│ │ │ │ -000114a0: 2073 6869 7368 695f 656e 6361 7072 6570   shishi_encaprep
│ │ │ │ -000114b0: 7061 7274 5f70 6172 7365 3a20 2020 2020  part_parse:     
│ │ │ │ -000114c0: 2020 2020 2020 2020 4150 2d52 4551 2061          AP-REQ a
│ │ │ │ -000114d0: 6e64 2041 502d 5245 5020 4675 6e63 7469  nd AP-REP Functi
│ │ │ │ -000114e0: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │ +00011490: 2020 2020 286c 696e 6520 3131 3537 290a      (line 1157).
│ │ │ │ +000114a0: 2a20 7368 6973 6869 5f65 6e63 6170 7265  * shishi_encapre
│ │ │ │ +000114b0: 7070 6172 745f 7061 7273 653a 2020 2020  ppart_parse:    
│ │ │ │ +000114c0: 2020 2020 2020 2020 2041 502d 5245 5120           AP-REQ 
│ │ │ │ +000114d0: 616e 6420 4150 2d52 4550 2046 756e 6374  and AP-REP Funct
│ │ │ │ +000114e0: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │  000114f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00011500: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00011510: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00011520: 2020 286c 696e 6520 3131 3133 290a 2a20    (line 1113).* 
│ │ │ │ -00011530: 7368 6973 6869 5f65 6e63 6170 7265 7070  shishi_encaprepp
│ │ │ │ -00011540: 6172 745f 7072 696e 743a 2020 2020 2020  art_print:      
│ │ │ │ -00011550: 2020 2020 2020 2041 502d 5245 5120 616e         AP-REQ an
│ │ │ │ -00011560: 6420 4150 2d52 4550 2046 756e 6374 696f  d AP-REP Functio
│ │ │ │ -00011570: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │ +00011520: 2020 2028 6c69 6e65 2031 3131 3329 0a2a     (line 1113).*
│ │ │ │ +00011530: 2073 6869 7368 695f 656e 6361 7072 6570   shishi_encaprep
│ │ │ │ +00011540: 7061 7274 5f70 7269 6e74 3a20 2020 2020  part_print:     
│ │ │ │ +00011550: 2020 2020 2020 2020 4150 2d52 4551 2061          AP-REQ a
│ │ │ │ +00011560: 6e64 2041 502d 5245 5020 4675 6e63 7469  nd AP-REP Functi
│ │ │ │ +00011570: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │  00011580: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00011590: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000115a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000115b0: 2028 6c69 6e65 2031 3037 3029 0a2a 2073   (line 1070).* s
│ │ │ │ -000115c0: 6869 7368 695f 656e 6361 7072 6570 7061  hishi_encapreppa
│ │ │ │ -000115d0: 7274 5f72 6561 643a 2020 2020 2020 2020  rt_read:        
│ │ │ │ -000115e0: 2020 2020 2020 4150 2d52 4551 2061 6e64        AP-REQ and
│ │ │ │ -000115f0: 2041 502d 5245 5020 4675 6e63 7469 6f6e   AP-REP Function
│ │ │ │ -00011600: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │ +000115b0: 2020 286c 696e 6520 3130 3730 290a 2a20    (line 1070).* 
│ │ │ │ +000115c0: 7368 6973 6869 5f65 6e63 6170 7265 7070  shishi_encaprepp
│ │ │ │ +000115d0: 6172 745f 7265 6164 3a20 2020 2020 2020  art_read:       
│ │ │ │ +000115e0: 2020 2020 2020 2041 502d 5245 5120 616e         AP-REQ an
│ │ │ │ +000115f0: 6420 4150 2d52 4550 2046 756e 6374 696f  d AP-REP Functio
│ │ │ │ +00011600: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │  00011610: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00011620: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00011630: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00011640: 286c 696e 6520 3131 3237 290a 2a20 7368  (line 1127).* sh
│ │ │ │ -00011650: 6973 6869 5f65 6e63 6170 7265 7070 6172  ishi_encapreppar
│ │ │ │ -00011660: 745f 7361 7665 3a20 2020 2020 2020 2020  t_save:         
│ │ │ │ -00011670: 2020 2020 2041 502d 5245 5120 616e 6420       AP-REQ and 
│ │ │ │ -00011680: 4150 2d52 4550 2046 756e 6374 696f 6e73  AP-REP Functions
│ │ │ │ -00011690: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │ +00011640: 2028 6c69 6e65 2031 3132 3729 0a2a 2073   (line 1127).* s
│ │ │ │ +00011650: 6869 7368 695f 656e 6361 7072 6570 7061  hishi_encapreppa
│ │ │ │ +00011660: 7274 5f73 6176 653a 2020 2020 2020 2020  rt_save:        
│ │ │ │ +00011670: 2020 2020 2020 4150 2d52 4551 2061 6e64        AP-REQ and
│ │ │ │ +00011680: 2041 502d 5245 5020 4675 6e63 7469 6f6e   AP-REP Function
│ │ │ │ +00011690: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │  000116a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000116b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000116c0: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ -000116d0: 6c69 6e65 2031 3038 3429 0a2a 2073 6869  line 1084).* shi
│ │ │ │ -000116e0: 7368 695f 656e 6361 7072 6570 7061 7274  shi_encapreppart
│ │ │ │ -000116f0: 5f73 6571 6e75 6d62 6572 5f67 6574 3a20  _seqnumber_get: 
│ │ │ │ -00011700: 2020 2020 4150 2d52 4551 2061 6e64 2041      AP-REQ and A
│ │ │ │ -00011710: 502d 5245 5020 4675 6e63 7469 6f6e 732e  P-REP Functions.
│ │ │ │ -00011720: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ +000116c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +000116d0: 286c 696e 6520 3130 3834 290a 2a20 7368  (line 1084).* sh
│ │ │ │ +000116e0: 6973 6869 5f65 6e63 6170 7265 7070 6172  ishi_encapreppar
│ │ │ │ +000116f0: 745f 7365 716e 756d 6265 725f 6765 743a  t_seqnumber_get:
│ │ │ │ +00011700: 2020 2020 2041 502d 5245 5120 616e 6420       AP-REQ and 
│ │ │ │ +00011710: 4150 2d52 4550 2046 756e 6374 696f 6e73  AP-REP Functions
│ │ │ │ +00011720: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │  00011730: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00011740: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00011750: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ -00011760: 696e 6520 3132 3237 290a 2a20 7368 6973  ine 1227).* shis
│ │ │ │ -00011770: 6869 5f65 6e63 6170 7265 7070 6172 745f  hi_encapreppart_
│ │ │ │ -00011780: 7365 716e 756d 6265 725f 7265 6d6f 7665  seqnumber_remove
│ │ │ │ -00011790: 3a20 2041 502d 5245 5120 616e 6420 4150  :  AP-REQ and AP
│ │ │ │ -000117a0: 2d52 4550 2046 756e 6374 696f 6e73 2e0a  -REP Functions..
│ │ │ │ -000117b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +00011750: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ +00011760: 6c69 6e65 2031 3232 3729 0a2a 2073 6869  line 1227).* shi
│ │ │ │ +00011770: 7368 695f 656e 6361 7072 6570 7061 7274  shi_encapreppart
│ │ │ │ +00011780: 5f73 6571 6e75 6d62 6572 5f72 656d 6f76  _seqnumber_remov
│ │ │ │ +00011790: 653a 2020 4150 2d52 4551 2061 6e64 2041  e:  AP-REQ and A
│ │ │ │ +000117a0: 502d 5245 5020 4675 6e63 7469 6f6e 732e  P-REP Functions.
│ │ │ │ +000117b0: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │  000117c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000117d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000117e0: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ -000117f0: 6e65 2031 3234 3129 0a2a 2073 6869 7368  ne 1241).* shish
│ │ │ │ -00011800: 695f 656e 6361 7072 6570 7061 7274 5f73  i_encapreppart_s
│ │ │ │ -00011810: 6571 6e75 6d62 6572 5f73 6574 3a20 2020  eqnumber_set:   
│ │ │ │ -00011820: 2020 4150 2d52 4551 2061 6e64 2041 502d    AP-REQ and AP-
│ │ │ │ -00011830: 5245 5020 4675 6e63 7469 6f6e 732e 0a20  REP Functions.. 
│ │ │ │ +000117e0: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ +000117f0: 696e 6520 3132 3431 290a 2a20 7368 6973  ine 1241).* shis
│ │ │ │ +00011800: 6869 5f65 6e63 6170 7265 7070 6172 745f  hi_encapreppart_
│ │ │ │ +00011810: 7365 716e 756d 6265 725f 7365 743a 2020  seqnumber_set:  
│ │ │ │ +00011820: 2020 2041 502d 5245 5120 616e 6420 4150     AP-REQ and AP
│ │ │ │ +00011830: 2d52 4550 2046 756e 6374 696f 6e73 2e0a  -REP Functions..
│ │ │ │  00011840: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00011850: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00011860: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00011870: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ -00011880: 6520 3132 3533 290a 2a20 7368 6973 6869  e 1253).* shishi
│ │ │ │ -00011890: 5f65 6e63 6170 7265 7070 6172 745f 7469  _encapreppart_ti
│ │ │ │ -000118a0: 6d65 5f63 6f70 793a 2020 2020 2020 2020  me_copy:        
│ │ │ │ -000118b0: 2041 502d 5245 5120 616e 6420 4150 2d52   AP-REQ and AP-R
│ │ │ │ -000118c0: 4550 2046 756e 6374 696f 6e73 2e0a 2020  EP Functions..  
│ │ │ │ +00011870: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ +00011880: 6e65 2031 3235 3329 0a2a 2073 6869 7368  ne 1253).* shish
│ │ │ │ +00011890: 695f 656e 6361 7072 6570 7061 7274 5f74  i_encapreppart_t
│ │ │ │ +000118a0: 696d 655f 636f 7079 3a20 2020 2020 2020  ime_copy:       
│ │ │ │ +000118b0: 2020 4150 2d52 4551 2061 6e64 2041 502d    AP-REQ and AP-
│ │ │ │ +000118c0: 5245 5020 4675 6e63 7469 6f6e 732e 0a20  REP Functions.. 
│ │ │ │  000118d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000118e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000118f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00011900: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ -00011910: 2031 3236 3829 0a2a 2073 6869 7368 695f   1268).* shishi_
│ │ │ │ -00011920: 656e 6361 7072 6570 7061 7274 5f74 6f5f  encapreppart_to_
│ │ │ │ -00011930: 6669 6c65 3a20 2020 2020 2020 2020 2020  file:           
│ │ │ │ -00011940: 4150 2d52 4551 2061 6e64 2041 502d 5245  AP-REQ and AP-RE
│ │ │ │ -00011950: 5020 4675 6e63 7469 6f6e 732e 0a20 2020  P Functions..   
│ │ │ │ +00011900: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ +00011910: 6520 3132 3638 290a 2a20 7368 6973 6869  e 1268).* shishi
│ │ │ │ +00011920: 5f65 6e63 6170 7265 7070 6172 745f 746f  _encapreppart_to
│ │ │ │ +00011930: 5f66 696c 653a 2020 2020 2020 2020 2020  _file:          
│ │ │ │ +00011940: 2041 502d 5245 5120 616e 6420 4150 2d52   AP-REQ and AP-R
│ │ │ │ +00011950: 4550 2046 756e 6374 696f 6e73 2e0a 2020  EP Functions..  
│ │ │ │  00011960: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00011970: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00011980: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00011990: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ -000119a0: 3130 3937 290a 2a20 7368 6973 6869 5f65  1097).* shishi_e
│ │ │ │ -000119b0: 6e63 6b64 6372 6570 7061 7274 5f61 7574  nckdcreppart_aut
│ │ │ │ -000119c0: 6874 696d 655f 7365 743a 2020 2020 2041  htime_set:     A
│ │ │ │ -000119d0: 532f 5447 5320 4675 6e63 7469 6f6e 732e  S/TGS Functions.
│ │ │ │ -000119e0: 2020 2028 6c69 6e65 2031 3330 3729 0a2a     (line 1307).*
│ │ │ │ -000119f0: 2073 6869 7368 695f 656e 636b 6463 7265   shishi_enckdcre
│ │ │ │ -00011a00: 7070 6172 745f 656e 6474 696d 655f 7365  ppart_endtime_se
│ │ │ │ -00011a10: 743a 2020 2020 2020 4153 2f54 4753 2046  t:      AS/TGS F
│ │ │ │ -00011a20: 756e 6374 696f 6e73 2e20 2020 286c 696e  unctions.   (lin
│ │ │ │ -00011a30: 6520 3133 3334 290a 2a20 7368 6973 6869  e 1334).* shishi
│ │ │ │ -00011a40: 5f65 6e63 6b64 6372 6570 7061 7274 5f66  _enckdcreppart_f
│ │ │ │ -00011a50: 6c61 6773 5f73 6574 3a20 2020 2020 2020  lags_set:       
│ │ │ │ -00011a60: 2041 532f 5447 5320 4675 6e63 7469 6f6e   AS/TGS Function
│ │ │ │ -00011a70: 732e 2020 2028 6c69 6e65 2031 3239 3429  s.   (line 1294)
│ │ │ │ -00011a80: 0a2a 2073 6869 7368 695f 656e 636b 6463  .* shishi_enckdc
│ │ │ │ -00011a90: 7265 7070 6172 745f 6765 745f 6b65 793a  reppart_get_key:
│ │ │ │ -00011aa0: 2020 2020 2020 2020 2020 4153 2f54 4753            AS/TGS
│ │ │ │ -00011ab0: 2046 756e 6374 696f 6e73 2e20 2020 286c   Functions.   (l
│ │ │ │ -00011ac0: 696e 6520 3132 3533 290a 2a20 7368 6973  ine 1253).* shis
│ │ │ │ -00011ad0: 6869 5f65 6e63 6b64 6372 6570 7061 7274  hi_enckdcreppart
│ │ │ │ -00011ae0: 5f6b 6579 5f73 6574 3a20 2020 2020 2020  _key_set:       
│ │ │ │ -00011af0: 2020 2041 532f 5447 5320 4675 6e63 7469     AS/TGS Functi
│ │ │ │ -00011b00: 6f6e 732e 2020 2028 6c69 6e65 2031 3236  ons.   (line 126
│ │ │ │ -00011b10: 3729 0a2a 2073 6869 7368 695f 656e 636b  7).* shishi_enck
│ │ │ │ -00011b20: 6463 7265 7070 6172 745f 6e6f 6e63 655f  dcreppart_nonce_
│ │ │ │ -00011b30: 7365 743a 2020 2020 2020 2020 4153 2f54  set:        AS/T
│ │ │ │ -00011b40: 4753 2046 756e 6374 696f 6e73 2e20 2020  GS Functions.   
│ │ │ │ -00011b50: 286c 696e 6520 3132 3831 290a 2a20 7368  (line 1281).* sh
│ │ │ │ -00011b60: 6973 6869 5f65 6e63 6b64 6372 6570 7061  ishi_enckdcreppa
│ │ │ │ -00011b70: 7274 5f70 6f70 756c 6174 655f 656e 6374  rt_populate_enct
│ │ │ │ -00011b80: 6963 6b65 7470 6172 743a 2041 532f 5447  icketpart: AS/TG
│ │ │ │ -00011b90: 5320 4675 6e63 7469 6f6e 732e 0a20 2020  S Functions..   
│ │ │ │ +00011990: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ +000119a0: 2031 3039 3729 0a2a 2073 6869 7368 695f   1097).* shishi_
│ │ │ │ +000119b0: 656e 636b 6463 7265 7070 6172 745f 6175  enckdcreppart_au
│ │ │ │ +000119c0: 7468 7469 6d65 5f73 6574 3a20 2020 2020  thtime_set:     
│ │ │ │ +000119d0: 4153 2f54 4753 2046 756e 6374 696f 6e73  AS/TGS Functions
│ │ │ │ +000119e0: 2e20 2020 286c 696e 6520 3133 3037 290a  .   (line 1307).
│ │ │ │ +000119f0: 2a20 7368 6973 6869 5f65 6e63 6b64 6372  * shishi_enckdcr
│ │ │ │ +00011a00: 6570 7061 7274 5f65 6e64 7469 6d65 5f73  eppart_endtime_s
│ │ │ │ +00011a10: 6574 3a20 2020 2020 2041 532f 5447 5320  et:      AS/TGS 
│ │ │ │ +00011a20: 4675 6e63 7469 6f6e 732e 2020 2028 6c69  Functions.   (li
│ │ │ │ +00011a30: 6e65 2031 3333 3429 0a2a 2073 6869 7368  ne 1334).* shish
│ │ │ │ +00011a40: 695f 656e 636b 6463 7265 7070 6172 745f  i_enckdcreppart_
│ │ │ │ +00011a50: 666c 6167 735f 7365 743a 2020 2020 2020  flags_set:      
│ │ │ │ +00011a60: 2020 4153 2f54 4753 2046 756e 6374 696f    AS/TGS Functio
│ │ │ │ +00011a70: 6e73 2e20 2020 286c 696e 6520 3132 3934  ns.   (line 1294
│ │ │ │ +00011a80: 290a 2a20 7368 6973 6869 5f65 6e63 6b64  ).* shishi_enckd
│ │ │ │ +00011a90: 6372 6570 7061 7274 5f67 6574 5f6b 6579  creppart_get_key
│ │ │ │ +00011aa0: 3a20 2020 2020 2020 2020 2041 532f 5447  :          AS/TG
│ │ │ │ +00011ab0: 5320 4675 6e63 7469 6f6e 732e 2020 2028  S Functions.   (
│ │ │ │ +00011ac0: 6c69 6e65 2031 3235 3329 0a2a 2073 6869  line 1253).* shi
│ │ │ │ +00011ad0: 7368 695f 656e 636b 6463 7265 7070 6172  shi_enckdcreppar
│ │ │ │ +00011ae0: 745f 6b65 795f 7365 743a 2020 2020 2020  t_key_set:      
│ │ │ │ +00011af0: 2020 2020 4153 2f54 4753 2046 756e 6374      AS/TGS Funct
│ │ │ │ +00011b00: 696f 6e73 2e20 2020 286c 696e 6520 3132  ions.   (line 12
│ │ │ │ +00011b10: 3637 290a 2a20 7368 6973 6869 5f65 6e63  67).* shishi_enc
│ │ │ │ +00011b20: 6b64 6372 6570 7061 7274 5f6e 6f6e 6365  kdcreppart_nonce
│ │ │ │ +00011b30: 5f73 6574 3a20 2020 2020 2020 2041 532f  _set:        AS/
│ │ │ │ +00011b40: 5447 5320 4675 6e63 7469 6f6e 732e 2020  TGS Functions.  
│ │ │ │ +00011b50: 2028 6c69 6e65 2031 3238 3129 0a2a 2073   (line 1281).* s
│ │ │ │ +00011b60: 6869 7368 695f 656e 636b 6463 7265 7070  hishi_enckdcrepp
│ │ │ │ +00011b70: 6172 745f 706f 7075 6c61 7465 5f65 6e63  art_populate_enc
│ │ │ │ +00011b80: 7469 636b 6574 7061 7274 3a20 4153 2f54  ticketpart: AS/T
│ │ │ │ +00011b90: 4753 2046 756e 6374 696f 6e73 2e0a 2020  GS Functions..  
│ │ │ │  00011ba0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00011bb0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00011bc0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00011bd0: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ -00011be0: 3133 3931 290a 2a20 7368 6973 6869 5f65  1391).* shishi_e
│ │ │ │ -00011bf0: 6e63 6b64 6372 6570 7061 7274 5f72 656e  nckdcreppart_ren
│ │ │ │ -00011c00: 6577 5f74 696c 6c5f 7365 743a 2020 2041  ew_till_set:   A
│ │ │ │ -00011c10: 532f 5447 5320 4675 6e63 7469 6f6e 732e  S/TGS Functions.
│ │ │ │ -00011c20: 2020 2028 6c69 6e65 2031 3334 3729 0a2a     (line 1347).*
│ │ │ │ -00011c30: 2073 6869 7368 695f 656e 636b 6463 7265   shishi_enckdcre
│ │ │ │ -00011c40: 7070 6172 745f 736e 616d 655f 7365 743a  ppart_sname_set:
│ │ │ │ -00011c50: 2020 2020 2020 2020 4153 2f54 4753 2046          AS/TGS F
│ │ │ │ -00011c60: 756e 6374 696f 6e73 2e20 2020 286c 696e  unctions.   (lin
│ │ │ │ -00011c70: 6520 3133 3734 290a 2a20 7368 6973 6869  e 1374).* shishi
│ │ │ │ -00011c80: 5f65 6e63 6b64 6372 6570 7061 7274 5f73  _enckdcreppart_s
│ │ │ │ -00011c90: 7265 616c 6d5f 7365 743a 2020 2020 2020  realm_set:      
│ │ │ │ -00011ca0: 2041 532f 5447 5320 4675 6e63 7469 6f6e   AS/TGS Function
│ │ │ │ -00011cb0: 732e 2020 2028 6c69 6e65 2031 3336 3129  s.   (line 1361)
│ │ │ │ -00011cc0: 0a2a 2073 6869 7368 695f 656e 636b 6463  .* shishi_enckdc
│ │ │ │ -00011cd0: 7265 7070 6172 745f 7374 6172 7474 696d  reppart_starttim
│ │ │ │ -00011ce0: 655f 7365 743a 2020 2020 4153 2f54 4753  e_set:    AS/TGS
│ │ │ │ -00011cf0: 2046 756e 6374 696f 6e73 2e20 2020 286c   Functions.   (l
│ │ │ │ -00011d00: 696e 6520 3133 3230 290a 2a20 7368 6973  ine 1320).* shis
│ │ │ │ -00011d10: 6869 5f65 6e63 7072 6976 7061 7274 5f73  hi_encprivpart_s
│ │ │ │ -00011d20: 6574 5f75 7365 725f 6461 7461 3a20 2020  et_user_data:   
│ │ │ │ -00011d30: 2020 2053 4146 4520 616e 6420 5052 4956     SAFE and PRIV
│ │ │ │ -00011d40: 2046 756e 6374 696f 6e73 2e0a 2020 2020   Functions..    
│ │ │ │ +00011bd0: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ +00011be0: 2031 3339 3129 0a2a 2073 6869 7368 695f   1391).* shishi_
│ │ │ │ +00011bf0: 656e 636b 6463 7265 7070 6172 745f 7265  enckdcreppart_re
│ │ │ │ +00011c00: 6e65 775f 7469 6c6c 5f73 6574 3a20 2020  new_till_set:   
│ │ │ │ +00011c10: 4153 2f54 4753 2046 756e 6374 696f 6e73  AS/TGS Functions
│ │ │ │ +00011c20: 2e20 2020 286c 696e 6520 3133 3437 290a  .   (line 1347).
│ │ │ │ +00011c30: 2a20 7368 6973 6869 5f65 6e63 6b64 6372  * shishi_enckdcr
│ │ │ │ +00011c40: 6570 7061 7274 5f73 6e61 6d65 5f73 6574  eppart_sname_set
│ │ │ │ +00011c50: 3a20 2020 2020 2020 2041 532f 5447 5320  :        AS/TGS 
│ │ │ │ +00011c60: 4675 6e63 7469 6f6e 732e 2020 2028 6c69  Functions.   (li
│ │ │ │ +00011c70: 6e65 2031 3337 3429 0a2a 2073 6869 7368  ne 1374).* shish
│ │ │ │ +00011c80: 695f 656e 636b 6463 7265 7070 6172 745f  i_enckdcreppart_
│ │ │ │ +00011c90: 7372 6561 6c6d 5f73 6574 3a20 2020 2020  srealm_set:     
│ │ │ │ +00011ca0: 2020 4153 2f54 4753 2046 756e 6374 696f    AS/TGS Functio
│ │ │ │ +00011cb0: 6e73 2e20 2020 286c 696e 6520 3133 3631  ns.   (line 1361
│ │ │ │ +00011cc0: 290a 2a20 7368 6973 6869 5f65 6e63 6b64  ).* shishi_enckd
│ │ │ │ +00011cd0: 6372 6570 7061 7274 5f73 7461 7274 7469  creppart_startti
│ │ │ │ +00011ce0: 6d65 5f73 6574 3a20 2020 2041 532f 5447  me_set:    AS/TG
│ │ │ │ +00011cf0: 5320 4675 6e63 7469 6f6e 732e 2020 2028  S Functions.   (
│ │ │ │ +00011d00: 6c69 6e65 2031 3332 3029 0a2a 2073 6869  line 1320).* shi
│ │ │ │ +00011d10: 7368 695f 656e 6370 7269 7670 6172 745f  shi_encprivpart_
│ │ │ │ +00011d20: 7365 745f 7573 6572 5f64 6174 613a 2020  set_user_data:  
│ │ │ │ +00011d30: 2020 2020 5341 4645 2061 6e64 2050 5249      SAFE and PRI
│ │ │ │ +00011d40: 5620 4675 6e63 7469 6f6e 732e 0a20 2020  V Functions..   
│ │ │ │  00011d50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00011d60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00011d70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00011d80: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ -00011d90: 3631 3129 0a2a 2073 6869 7368 695f 656e  611).* shishi_en
│ │ │ │ -00011da0: 6370 7269 7670 6172 745f 7573 6572 5f64  cprivpart_user_d
│ │ │ │ -00011db0: 6174 613a 2020 2020 2020 2020 2020 5341  ata:          SA
│ │ │ │ -00011dc0: 4645 2061 6e64 2050 5249 5620 4675 6e63  FE and PRIV Func
│ │ │ │ -00011dd0: 7469 6f6e 732e 0a20 2020 2020 2020 2020  tions..         
│ │ │ │ +00011d80: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ +00011d90: 2036 3131 290a 2a20 7368 6973 6869 5f65   611).* shishi_e
│ │ │ │ +00011da0: 6e63 7072 6976 7061 7274 5f75 7365 725f  ncprivpart_user_
│ │ │ │ +00011db0: 6461 7461 3a20 2020 2020 2020 2020 2053  data:          S
│ │ │ │ +00011dc0: 4146 4520 616e 6420 5052 4956 2046 756e  AFE and PRIV Fun
│ │ │ │ +00011dd0: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │  00011de0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00011df0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00011e00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00011e10: 2020 2020 286c 696e 6520 2035 3933 290a      (line  593).
│ │ │ │ -00011e20: 2a20 7368 6973 6869 5f65 6e63 7279 7074  * shishi_encrypt
│ │ │ │ -00011e30: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ -00011e40: 2020 2020 2020 2020 2043 7279 7074 6f67           Cryptog
│ │ │ │ -00011e50: 7261 7068 6963 2046 756e 6374 696f 6e73  raphic Functions
│ │ │ │ -00011e60: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │ +00011e10: 2020 2020 2028 6c69 6e65 2020 3539 3329       (line  593)
│ │ │ │ +00011e20: 0a2a 2073 6869 7368 695f 656e 6372 7970  .* shishi_encryp
│ │ │ │ +00011e30: 743a 2020 2020 2020 2020 2020 2020 2020  t:              
│ │ │ │ +00011e40: 2020 2020 2020 2020 2020 4372 7970 746f            Crypto
│ │ │ │ +00011e50: 6772 6170 6869 6320 4675 6e63 7469 6f6e  graphic Function
│ │ │ │ +00011e60: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │  00011e70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00011e80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00011e90: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ -00011ea0: 6c69 6e65 2031 3030 3029 0a2a 2073 6869  line 1000).* shi
│ │ │ │ -00011eb0: 7368 695f 656e 6372 7970 745f 6574 7970  shi_encrypt_etyp
│ │ │ │ -00011ec0: 653a 2020 2020 2020 2020 2020 2020 2020  e:              
│ │ │ │ -00011ed0: 2020 2020 4372 7970 746f 6772 6170 6869      Cryptographi
│ │ │ │ -00011ee0: 6320 4675 6e63 7469 6f6e 732e 0a20 2020  c Functions..   
│ │ │ │ +00011e90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +00011ea0: 286c 696e 6520 3130 3030 290a 2a20 7368  (line 1000).* sh
│ │ │ │ +00011eb0: 6973 6869 5f65 6e63 7279 7074 5f65 7479  ishi_encrypt_ety
│ │ │ │ +00011ec0: 7065 3a20 2020 2020 2020 2020 2020 2020  pe:             
│ │ │ │ +00011ed0: 2020 2020 2043 7279 7074 6f67 7261 7068       Cryptograph
│ │ │ │ +00011ee0: 6963 2046 756e 6374 696f 6e73 2e0a 2020  ic Functions..  
│ │ │ │  00011ef0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00011f00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00011f10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00011f20: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ -00011f30: 2038 3935 290a 2a20 7368 6973 6869 5f65   895).* shishi_e
│ │ │ │ -00011f40: 6e63 7279 7074 5f69 763a 2020 2020 2020  ncrypt_iv:      
│ │ │ │ -00011f50: 2020 2020 2020 2020 2020 2020 2020 2043                 C
│ │ │ │ -00011f60: 7279 7074 6f67 7261 7068 6963 2046 756e  ryptographic Fun
│ │ │ │ -00011f70: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │ +00011f20: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ +00011f30: 2020 3839 3529 0a2a 2073 6869 7368 695f    895).* shishi_
│ │ │ │ +00011f40: 656e 6372 7970 745f 6976 3a20 2020 2020  encrypt_iv:     
│ │ │ │ +00011f50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +00011f60: 4372 7970 746f 6772 6170 6869 6320 4675  Cryptographic Fu
│ │ │ │ +00011f70: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │  00011f80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00011f90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00011fa0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00011fb0: 2020 2020 2028 6c69 6e65 2020 3936 3729       (line  967)
│ │ │ │ -00011fc0: 0a2a 2073 6869 7368 695f 656e 6372 7970  .* shishi_encryp
│ │ │ │ -00011fd0: 745f 6976 5f65 7479 7065 3a20 2020 2020  t_iv_etype:     
│ │ │ │ -00011fe0: 2020 2020 2020 2020 2020 4372 7970 746f            Crypto
│ │ │ │ -00011ff0: 6772 6170 6869 6320 4675 6e63 7469 6f6e  graphic Function
│ │ │ │ -00012000: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │ +00011fb0: 2020 2020 2020 286c 696e 6520 2039 3637        (line  967
│ │ │ │ +00011fc0: 290a 2a20 7368 6973 6869 5f65 6e63 7279  ).* shishi_encry
│ │ │ │ +00011fd0: 7074 5f69 765f 6574 7970 653a 2020 2020  pt_iv_etype:    
│ │ │ │ +00011fe0: 2020 2020 2020 2020 2020 2043 7279 7074             Crypt
│ │ │ │ +00011ff0: 6f67 7261 7068 6963 2046 756e 6374 696f  ographic Functio
│ │ │ │ +00012000: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │  00012010: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00012020: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00012030: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00012040: 286c 696e 6520 2038 3630 290a 2a20 7368  (line  860).* sh
│ │ │ │ -00012050: 6973 6869 5f65 6e63 7279 7074 5f69 7675  ishi_encrypt_ivu
│ │ │ │ -00012060: 7064 6174 653a 2020 2020 2020 2020 2020  pdate:          
│ │ │ │ -00012070: 2020 2020 2043 7279 7074 6f67 7261 7068       Cryptograph
│ │ │ │ -00012080: 6963 2046 756e 6374 696f 6e73 2e0a 2020  ic Functions..  
│ │ │ │ +00012040: 2028 6c69 6e65 2020 3836 3029 0a2a 2073   (line  860).* s
│ │ │ │ +00012050: 6869 7368 695f 656e 6372 7970 745f 6976  hishi_encrypt_iv
│ │ │ │ +00012060: 7570 6461 7465 3a20 2020 2020 2020 2020  update:         
│ │ │ │ +00012070: 2020 2020 2020 4372 7970 746f 6772 6170        Cryptograp
│ │ │ │ +00012080: 6869 6320 4675 6e63 7469 6f6e 732e 0a20  hic Functions.. 
│ │ │ │  00012090: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000120a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000120b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000120c0: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ -000120d0: 2020 3932 3929 0a2a 2073 6869 7368 695f    929).* shishi_
│ │ │ │ -000120e0: 656e 6372 7970 745f 6976 7570 6461 7465  encrypt_ivupdate
│ │ │ │ -000120f0: 5f65 7479 7065 3a20 2020 2020 2020 2020  _etype:         
│ │ │ │ -00012100: 4372 7970 746f 6772 6170 6869 6320 4675  Cryptographic Fu
│ │ │ │ -00012110: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │ +000120c0: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ +000120d0: 6520 2039 3239 290a 2a20 7368 6973 6869  e  929).* shishi
│ │ │ │ +000120e0: 5f65 6e63 7279 7074 5f69 7675 7064 6174  _encrypt_ivupdat
│ │ │ │ +000120f0: 655f 6574 7970 653a 2020 2020 2020 2020  e_etype:        
│ │ │ │ +00012100: 2043 7279 7074 6f67 7261 7068 6963 2046   Cryptographic F
│ │ │ │ +00012110: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │  00012120: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00012130: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00012140: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00012150: 2020 2020 2020 286c 696e 6520 2038 3230        (line  820
│ │ │ │ -00012160: 290a 2a20 7368 6973 6869 5f65 6e63 7469  ).* shishi_encti
│ │ │ │ -00012170: 636b 6574 7061 7274 5f61 7574 6874 696d  cketpart_authtim
│ │ │ │ -00012180: 655f 7365 743a 2020 2020 2054 6963 6b65  e_set:     Ticke
│ │ │ │ -00012190: 7420 2841 534e 2e31 2920 4675 6e63 7469  t (ASN.1) Functi
│ │ │ │ -000121a0: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │ +00012150: 2020 2020 2020 2028 6c69 6e65 2020 3832         (line  82
│ │ │ │ +00012160: 3029 0a2a 2073 6869 7368 695f 656e 6374  0).* shishi_enct
│ │ │ │ +00012170: 6963 6b65 7470 6172 745f 6175 7468 7469  icketpart_authti
│ │ │ │ +00012180: 6d65 5f73 6574 3a20 2020 2020 5469 636b  me_set:     Tick
│ │ │ │ +00012190: 6574 2028 4153 4e2e 3129 2046 756e 6374  et (ASN.1) Funct
│ │ │ │ +000121a0: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │  000121b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000121c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000121d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000121e0: 2020 286c 696e 6520 2032 3436 290a 2a20    (line  246).* 
│ │ │ │ -000121f0: 7368 6973 6869 5f65 6e63 7469 636b 6574  shishi_encticket
│ │ │ │ -00012200: 7061 7274 5f63 6c69 656e 743a 2020 2020  part_client:    
│ │ │ │ -00012210: 2020 2020 2020 2054 6963 6b65 7420 2841         Ticket (A
│ │ │ │ -00012220: 534e 2e31 2920 4675 6e63 7469 6f6e 732e  SN.1) Functions.
│ │ │ │ -00012230: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ +000121e0: 2020 2028 6c69 6e65 2020 3234 3629 0a2a     (line  246).*
│ │ │ │ +000121f0: 2073 6869 7368 695f 656e 6374 6963 6b65   shishi_encticke
│ │ │ │ +00012200: 7470 6172 745f 636c 6965 6e74 3a20 2020  tpart_client:   
│ │ │ │ +00012210: 2020 2020 2020 2020 5469 636b 6574 2028          Ticket (
│ │ │ │ +00012220: 4153 4e2e 3129 2046 756e 6374 696f 6e73  ASN.1) Functions
│ │ │ │ +00012230: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │  00012240: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00012250: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00012260: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ -00012270: 696e 6520 2032 3732 290a 2a20 7368 6973  ine  272).* shis
│ │ │ │ -00012280: 6869 5f65 6e63 7469 636b 6574 7061 7274  hi_encticketpart
│ │ │ │ -00012290: 5f63 6c69 656e 7472 6561 6c6d 3a20 2020  _clientrealm:   
│ │ │ │ -000122a0: 2020 2054 6963 6b65 7420 2841 534e 2e31     Ticket (ASN.1
│ │ │ │ -000122b0: 2920 4675 6e63 7469 6f6e 732e 0a20 2020  ) Functions..   
│ │ │ │ +00012260: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ +00012270: 6c69 6e65 2020 3237 3229 0a2a 2073 6869  line  272).* shi
│ │ │ │ +00012280: 7368 695f 656e 6374 6963 6b65 7470 6172  shi_encticketpar
│ │ │ │ +00012290: 745f 636c 6965 6e74 7265 616c 6d3a 2020  t_clientrealm:  
│ │ │ │ +000122a0: 2020 2020 5469 636b 6574 2028 4153 4e2e      Ticket (ASN.
│ │ │ │ +000122b0: 3129 2046 756e 6374 696f 6e73 2e0a 2020  1) Functions..  
│ │ │ │  000122c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000122d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000122e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000122f0: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ -00012300: 2032 3933 290a 2a20 7368 6973 6869 5f65   293).* shishi_e
│ │ │ │ -00012310: 6e63 7469 636b 6574 7061 7274 5f63 6e61  ncticketpart_cna
│ │ │ │ -00012320: 6d65 5f73 6574 3a20 2020 2020 2020 2054  me_set:        T
│ │ │ │ -00012330: 6963 6b65 7420 2841 534e 2e31 2920 4675  icket (ASN.1) Fu
│ │ │ │ -00012340: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │ +000122f0: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ +00012300: 2020 3239 3329 0a2a 2073 6869 7368 695f    293).* shishi_
│ │ │ │ +00012310: 656e 6374 6963 6b65 7470 6172 745f 636e  encticketpart_cn
│ │ │ │ +00012320: 616d 655f 7365 743a 2020 2020 2020 2020  ame_set:        
│ │ │ │ +00012330: 5469 636b 6574 2028 4153 4e2e 3129 2046  Ticket (ASN.1) F
│ │ │ │ +00012340: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │  00012350: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00012360: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00012370: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00012380: 2020 2020 2020 286c 696e 6520 2032 3132        (line  212
│ │ │ │ -00012390: 290a 2a20 7368 6973 6869 5f65 6e63 7469  ).* shishi_encti
│ │ │ │ -000123a0: 636b 6574 7061 7274 5f63 7265 616c 6d5f  cketpart_crealm_
│ │ │ │ -000123b0: 7365 743a 2020 2020 2020 2054 6963 6b65  set:       Ticke
│ │ │ │ -000123c0: 7420 2841 534e 2e31 2920 4675 6e63 7469  t (ASN.1) Functi
│ │ │ │ -000123d0: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │ +00012380: 2020 2020 2020 2028 6c69 6e65 2020 3231         (line  21
│ │ │ │ +00012390: 3229 0a2a 2073 6869 7368 695f 656e 6374  2).* shishi_enct
│ │ │ │ +000123a0: 6963 6b65 7470 6172 745f 6372 6561 6c6d  icketpart_crealm
│ │ │ │ +000123b0: 5f73 6574 3a20 2020 2020 2020 5469 636b  _set:       Tick
│ │ │ │ +000123c0: 6574 2028 4153 4e2e 3129 2046 756e 6374  et (ASN.1) Funct
│ │ │ │ +000123d0: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │  000123e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000123f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00012400: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00012410: 2020 286c 696e 6520 2031 3939 290a 2a20    (line  199).* 
│ │ │ │ -00012420: 7368 6973 6869 5f65 6e63 7469 636b 6574  shishi_encticket
│ │ │ │ -00012430: 7061 7274 5f65 6e64 7469 6d65 5f73 6574  part_endtime_set
│ │ │ │ -00012440: 3a20 2020 2020 2054 6963 6b65 7420 2841  :      Ticket (A
│ │ │ │ -00012450: 534e 2e31 2920 4675 6e63 7469 6f6e 732e  SN.1) Functions.
│ │ │ │ -00012460: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ +00012410: 2020 2028 6c69 6e65 2020 3139 3929 0a2a     (line  199).*
│ │ │ │ +00012420: 2073 6869 7368 695f 656e 6374 6963 6b65   shishi_encticke
│ │ │ │ +00012430: 7470 6172 745f 656e 6474 696d 655f 7365  tpart_endtime_se
│ │ │ │ +00012440: 743a 2020 2020 2020 5469 636b 6574 2028  t:      Ticket (
│ │ │ │ +00012450: 4153 4e2e 3129 2046 756e 6374 696f 6e73  ASN.1) Functions
│ │ │ │ +00012460: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │  00012470: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00012480: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00012490: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ -000124a0: 696e 6520 2032 3539 290a 2a20 7368 6973  ine  259).* shis
│ │ │ │ -000124b0: 6869 5f65 6e63 7469 636b 6574 7061 7274  hi_encticketpart
│ │ │ │ -000124c0: 5f66 6c61 6773 5f73 6574 3a20 2020 2020  _flags_set:     
│ │ │ │ -000124d0: 2020 2054 6963 6b65 7420 2841 534e 2e31     Ticket (ASN.1
│ │ │ │ -000124e0: 2920 4675 6e63 7469 6f6e 732e 0a20 2020  ) Functions..   
│ │ │ │ +00012490: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ +000124a0: 6c69 6e65 2020 3235 3929 0a2a 2073 6869  line  259).* shi
│ │ │ │ +000124b0: 7368 695f 656e 6374 6963 6b65 7470 6172  shi_encticketpar
│ │ │ │ +000124c0: 745f 666c 6167 735f 7365 743a 2020 2020  t_flags_set:    
│ │ │ │ +000124d0: 2020 2020 5469 636b 6574 2028 4153 4e2e      Ticket (ASN.
│ │ │ │ +000124e0: 3129 2046 756e 6374 696f 6e73 2e0a 2020  1) Functions..  
│ │ │ │  000124f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00012500: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00012510: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00012520: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ -00012530: 2031 3836 290a 2a20 7368 6973 6869 5f65   186).* shishi_e
│ │ │ │ -00012540: 6e63 7469 636b 6574 7061 7274 5f67 6574  ncticketpart_get
│ │ │ │ -00012550: 5f6b 6579 3a20 2020 2020 2020 2020 2054  _key:          T
│ │ │ │ -00012560: 6963 6b65 7420 2841 534e 2e31 2920 4675  icket (ASN.1) Fu
│ │ │ │ -00012570: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │ +00012520: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ +00012530: 2020 3138 3629 0a2a 2073 6869 7368 695f    186).* shishi_
│ │ │ │ +00012540: 656e 6374 6963 6b65 7470 6172 745f 6765  encticketpart_ge
│ │ │ │ +00012550: 745f 6b65 793a 2020 2020 2020 2020 2020  t_key:          
│ │ │ │ +00012560: 5469 636b 6574 2028 4153 4e2e 3129 2046  Ticket (ASN.1) F
│ │ │ │ +00012570: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │  00012580: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00012590: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000125a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000125b0: 2020 2020 2020 286c 696e 6520 2031 3539        (line  159
│ │ │ │ -000125c0: 290a 2a20 7368 6973 6869 5f65 6e63 7469  ).* shishi_encti
│ │ │ │ -000125d0: 636b 6574 7061 7274 5f6b 6579 5f73 6574  cketpart_key_set
│ │ │ │ -000125e0: 3a20 2020 2020 2020 2020 2054 6963 6b65  :          Ticke
│ │ │ │ -000125f0: 7420 2841 534e 2e31 2920 4675 6e63 7469  t (ASN.1) Functi
│ │ │ │ -00012600: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │ +000125b0: 2020 2020 2020 2028 6c69 6e65 2020 3135         (line  15
│ │ │ │ +000125c0: 3929 0a2a 2073 6869 7368 695f 656e 6374  9).* shishi_enct
│ │ │ │ +000125d0: 6963 6b65 7470 6172 745f 6b65 795f 7365  icketpart_key_se
│ │ │ │ +000125e0: 743a 2020 2020 2020 2020 2020 5469 636b  t:          Tick
│ │ │ │ +000125f0: 6574 2028 4153 4e2e 3129 2046 756e 6374  et (ASN.1) Funct
│ │ │ │ +00012600: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │  00012610: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00012620: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00012630: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00012640: 2020 286c 696e 6520 2031 3732 290a 2a20    (line  172).* 
│ │ │ │ -00012650: 7368 6973 6869 5f65 6e63 7469 636b 6574  shishi_encticket
│ │ │ │ -00012660: 7061 7274 5f74 7261 6e73 6974 6564 5f73  part_transited_s
│ │ │ │ -00012670: 6574 3a20 2020 2054 6963 6b65 7420 2841  et:    Ticket (A
│ │ │ │ -00012680: 534e 2e31 2920 4675 6e63 7469 6f6e 732e  SN.1) Functions.
│ │ │ │ -00012690: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ +00012640: 2020 2028 6c69 6e65 2020 3137 3229 0a2a     (line  172).*
│ │ │ │ +00012650: 2073 6869 7368 695f 656e 6374 6963 6b65   shishi_encticke
│ │ │ │ +00012660: 7470 6172 745f 7472 616e 7369 7465 645f  tpart_transited_
│ │ │ │ +00012670: 7365 743a 2020 2020 5469 636b 6574 2028  set:    Ticket (
│ │ │ │ +00012680: 4153 4e2e 3129 2046 756e 6374 696f 6e73  ASN.1) Functions
│ │ │ │ +00012690: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │  000126a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000126b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000126c0: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ -000126d0: 696e 6520 2032 3238 290a 2a20 7368 6973  ine  228).* shis
│ │ │ │ -000126e0: 6869 5f65 7272 6f72 3a20 2020 2020 2020  hi_error:       
│ │ │ │ +000126c0: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ +000126d0: 6c69 6e65 2020 3232 3829 0a2a 2073 6869  line  228).* shi
│ │ │ │ +000126e0: 7368 695f 6572 726f 723a 2020 2020 2020  shi_error:      
│ │ │ │  000126f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00012700: 2020 2045 7272 6f72 2046 756e 6374 696f     Error Functio
│ │ │ │ -00012710: 6e73 2e20 2020 2028 6c69 6e65 2020 2032  ns.    (line   2
│ │ │ │ -00012720: 3229 0a2a 2073 6869 7368 695f 6572 726f  2).* shishi_erro
│ │ │ │ -00012730: 725f 636c 6561 723a 2020 2020 2020 2020  r_clear:        
│ │ │ │ -00012740: 2020 2020 2020 2020 2020 2020 4572 726f              Erro
│ │ │ │ -00012750: 7220 4675 6e63 7469 6f6e 732e 2020 2020  r Functions.    
│ │ │ │ -00012760: 286c 696e 6520 2020 3335 290a 2a20 7368  (line   35).* sh
│ │ │ │ -00012770: 6973 6869 5f65 7272 6f72 5f6f 7574 7075  ishi_error_outpu
│ │ │ │ -00012780: 7474 7970 653a 2020 2020 2020 2020 2020  ttype:          
│ │ │ │ -00012790: 2020 2020 2045 7272 6f72 2046 756e 6374       Error Funct
│ │ │ │ -000127a0: 696f 6e73 2e20 2020 2028 6c69 6e65 2020  ions.    (line  
│ │ │ │ -000127b0: 2038 3129 0a2a 2073 6869 7368 695f 6572   81).* shishi_er
│ │ │ │ -000127c0: 726f 725f 7072 696e 7466 3a20 2020 2020  ror_printf:     
│ │ │ │ -000127d0: 2020 2020 2020 2020 2020 2020 2020 4572                Er
│ │ │ │ -000127e0: 726f 7220 4675 6e63 7469 6f6e 732e 2020  ror Functions.  
│ │ │ │ -000127f0: 2020 286c 696e 6520 2020 3637 290a 2a20    (line   67).* 
│ │ │ │ -00012800: 7368 6973 6869 5f65 7272 6f72 5f73 6574  shishi_error_set
│ │ │ │ -00012810: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ -00012820: 2020 2020 2020 2045 7272 6f72 2046 756e         Error Fun
│ │ │ │ -00012830: 6374 696f 6e73 2e20 2020 2028 6c69 6e65  ctions.    (line
│ │ │ │ -00012840: 2020 2035 3029 0a2a 2073 6869 7368 695f     50).* shishi_
│ │ │ │ -00012850: 6572 726f 725f 7365 745f 6f75 7470 7574  error_set_output
│ │ │ │ -00012860: 7479 7065 3a20 2020 2020 2020 2020 2020  type:           
│ │ │ │ -00012870: 4572 726f 7220 4675 6e63 7469 6f6e 732e  Error Functions.
│ │ │ │ -00012880: 2020 2020 286c 696e 6520 2020 3935 290a      (line   95).
│ │ │ │ -00012890: 2a20 7368 6973 6869 5f67 656e 6572 616c  * shishi_general
│ │ │ │ -000128a0: 697a 655f 6374 696d 653a 2020 2020 2020  ize_ctime:      
│ │ │ │ -000128b0: 2020 2020 2020 2020 2055 7469 6c69 7479           Utility
│ │ │ │ -000128c0: 2046 756e 6374 696f 6e73 2e20 2028 6c69   Functions.  (li
│ │ │ │ -000128d0: 6e65 2020 3339 3429 0a2a 2073 6869 7368  ne  394).* shish
│ │ │ │ -000128e0: 695f 6765 6e65 7261 6c69 7a65 5f6e 6f77  i_generalize_now
│ │ │ │ -000128f0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ -00012900: 2020 5574 696c 6974 7920 4675 6e63 7469    Utility Functi
│ │ │ │ -00012910: 6f6e 732e 2020 286c 696e 6520 2033 3832  ons.  (line  382
│ │ │ │ -00012920: 290a 2a20 7368 6973 6869 5f67 656e 6572  ).* shishi_gener
│ │ │ │ -00012930: 616c 697a 655f 7469 6d65 3a20 2020 2020  alize_time:     
│ │ │ │ -00012940: 2020 2020 2020 2020 2020 2055 7469 6c69             Utili
│ │ │ │ -00012950: 7479 2046 756e 6374 696f 6e73 2e20 2028  ty Functions.  (
│ │ │ │ -00012960: 6c69 6e65 2020 3336 3729 0a2a 2073 6869  line  367).* shi
│ │ │ │ -00012970: 7368 695f 686d 6163 5f6d 6435 3a20 2020  shi_hmac_md5:   
│ │ │ │ +00012700: 2020 2020 4572 726f 7220 4675 6e63 7469      Error Functi
│ │ │ │ +00012710: 6f6e 732e 2020 2020 286c 696e 6520 2020  ons.    (line   
│ │ │ │ +00012720: 3232 290a 2a20 7368 6973 6869 5f65 7272  22).* shishi_err
│ │ │ │ +00012730: 6f72 5f63 6c65 6172 3a20 2020 2020 2020  or_clear:       
│ │ │ │ +00012740: 2020 2020 2020 2020 2020 2020 2045 7272               Err
│ │ │ │ +00012750: 6f72 2046 756e 6374 696f 6e73 2e20 2020  or Functions.   
│ │ │ │ +00012760: 2028 6c69 6e65 2020 2033 3529 0a2a 2073   (line   35).* s
│ │ │ │ +00012770: 6869 7368 695f 6572 726f 725f 6f75 7470  hishi_error_outp
│ │ │ │ +00012780: 7574 7479 7065 3a20 2020 2020 2020 2020  uttype:         
│ │ │ │ +00012790: 2020 2020 2020 4572 726f 7220 4675 6e63        Error Func
│ │ │ │ +000127a0: 7469 6f6e 732e 2020 2020 286c 696e 6520  tions.    (line 
│ │ │ │ +000127b0: 2020 3831 290a 2a20 7368 6973 6869 5f65    81).* shishi_e
│ │ │ │ +000127c0: 7272 6f72 5f70 7269 6e74 663a 2020 2020  rror_printf:    
│ │ │ │ +000127d0: 2020 2020 2020 2020 2020 2020 2020 2045                 E
│ │ │ │ +000127e0: 7272 6f72 2046 756e 6374 696f 6e73 2e20  rror Functions. 
│ │ │ │ +000127f0: 2020 2028 6c69 6e65 2020 2036 3729 0a2a     (line   67).*
│ │ │ │ +00012800: 2073 6869 7368 695f 6572 726f 725f 7365   shishi_error_se
│ │ │ │ +00012810: 743a 2020 2020 2020 2020 2020 2020 2020  t:              
│ │ │ │ +00012820: 2020 2020 2020 2020 4572 726f 7220 4675          Error Fu
│ │ │ │ +00012830: 6e63 7469 6f6e 732e 2020 2020 286c 696e  nctions.    (lin
│ │ │ │ +00012840: 6520 2020 3530 290a 2a20 7368 6973 6869  e   50).* shishi
│ │ │ │ +00012850: 5f65 7272 6f72 5f73 6574 5f6f 7574 7075  _error_set_outpu
│ │ │ │ +00012860: 7474 7970 653a 2020 2020 2020 2020 2020  ttype:          
│ │ │ │ +00012870: 2045 7272 6f72 2046 756e 6374 696f 6e73   Error Functions
│ │ │ │ +00012880: 2e20 2020 2028 6c69 6e65 2020 2039 3529  .    (line   95)
│ │ │ │ +00012890: 0a2a 2073 6869 7368 695f 6765 6e65 7261  .* shishi_genera
│ │ │ │ +000128a0: 6c69 7a65 5f63 7469 6d65 3a20 2020 2020  lize_ctime:     
│ │ │ │ +000128b0: 2020 2020 2020 2020 2020 5574 696c 6974            Utilit
│ │ │ │ +000128c0: 7920 4675 6e63 7469 6f6e 732e 2020 286c  y Functions.  (l
│ │ │ │ +000128d0: 696e 6520 2033 3934 290a 2a20 7368 6973  ine  394).* shis
│ │ │ │ +000128e0: 6869 5f67 656e 6572 616c 697a 655f 6e6f  hi_generalize_no
│ │ │ │ +000128f0: 773a 2020 2020 2020 2020 2020 2020 2020  w:              
│ │ │ │ +00012900: 2020 2055 7469 6c69 7479 2046 756e 6374     Utility Funct
│ │ │ │ +00012910: 696f 6e73 2e20 2028 6c69 6e65 2020 3338  ions.  (line  38
│ │ │ │ +00012920: 3229 0a2a 2073 6869 7368 695f 6765 6e65  2).* shishi_gene
│ │ │ │ +00012930: 7261 6c69 7a65 5f74 696d 653a 2020 2020  ralize_time:    
│ │ │ │ +00012940: 2020 2020 2020 2020 2020 2020 5574 696c              Util
│ │ │ │ +00012950: 6974 7920 4675 6e63 7469 6f6e 732e 2020  ity Functions.  
│ │ │ │ +00012960: 286c 696e 6520 2033 3637 290a 2a20 7368  (line  367).* sh
│ │ │ │ +00012970: 6973 6869 5f68 6d61 635f 6d64 353a 2020  ishi_hmac_md5:  
│ │ │ │  00012980: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00012990: 2020 2020 4372 7970 746f 6772 6170 6869      Cryptographi
│ │ │ │ -000129a0: 6320 4675 6e63 7469 6f6e 732e 0a20 2020  c Functions..   
│ │ │ │ +00012990: 2020 2020 2043 7279 7074 6f67 7261 7068       Cryptograph
│ │ │ │ +000129a0: 6963 2046 756e 6374 696f 6e73 2e0a 2020  ic Functions..  
│ │ │ │  000129b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000129c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000129d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000129e0: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ -000129f0: 3134 3536 290a 2a20 7368 6973 6869 5f68  1456).* shishi_h
│ │ │ │ -00012a00: 6d61 635f 7368 6131 3a20 2020 2020 2020  mac_sha1:       
│ │ │ │ -00012a10: 2020 2020 2020 2020 2020 2020 2020 2043                 C
│ │ │ │ -00012a20: 7279 7074 6f67 7261 7068 6963 2046 756e  ryptographic Fun
│ │ │ │ -00012a30: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │ +000129e0: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ +000129f0: 2031 3435 3629 0a2a 2073 6869 7368 695f   1456).* shishi_
│ │ │ │ +00012a00: 686d 6163 5f73 6861 313a 2020 2020 2020  hmac_sha1:      
│ │ │ │ +00012a10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +00012a20: 4372 7970 746f 6772 6170 6869 6320 4675  Cryptographic Fu
│ │ │ │ +00012a30: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │  00012a40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00012a50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00012a60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00012a70: 2020 2020 2028 6c69 6e65 2031 3437 3429       (line 1474)
│ │ │ │ -00012a80: 0a2a 2073 6869 7368 695f 686f 7374 6b65  .* shishi_hostke
│ │ │ │ -00012a90: 7973 5f64 6566 6175 6c74 5f66 696c 653a  ys_default_file:
│ │ │ │ -00012aa0: 2020 2020 2020 2020 2020 4372 7970 746f            Crypto
│ │ │ │ -00012ab0: 6772 6170 6869 6320 4675 6e63 7469 6f6e  graphic Function
│ │ │ │ -00012ac0: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │ +00012a70: 2020 2020 2020 286c 696e 6520 3134 3734        (line 1474
│ │ │ │ +00012a80: 290a 2a20 7368 6973 6869 5f68 6f73 746b  ).* shishi_hostk
│ │ │ │ +00012a90: 6579 735f 6465 6661 756c 745f 6669 6c65  eys_default_file
│ │ │ │ +00012aa0: 3a20 2020 2020 2020 2020 2043 7279 7074  :          Crypt
│ │ │ │ +00012ab0: 6f67 7261 7068 6963 2046 756e 6374 696f  ographic Functio
│ │ │ │ +00012ac0: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │  00012ad0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00012ae0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00012af0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00012b00: 286c 696e 6520 2035 3132 290a 2a20 7368  (line  512).* sh
│ │ │ │ -00012b10: 6973 6869 5f68 6f73 746b 6579 735f 6465  ishi_hostkeys_de
│ │ │ │ -00012b20: 6661 756c 745f 6669 6c65 5f73 6574 3a20  fault_file_set: 
│ │ │ │ -00012b30: 2020 2020 2043 7279 7074 6f67 7261 7068       Cryptograph
│ │ │ │ -00012b40: 6963 2046 756e 6374 696f 6e73 2e0a 2020  ic Functions..  
│ │ │ │ +00012b00: 2028 6c69 6e65 2020 3531 3229 0a2a 2073   (line  512).* s
│ │ │ │ +00012b10: 6869 7368 695f 686f 7374 6b65 7973 5f64  hishi_hostkeys_d
│ │ │ │ +00012b20: 6566 6175 6c74 5f66 696c 655f 7365 743a  efault_file_set:
│ │ │ │ +00012b30: 2020 2020 2020 4372 7970 746f 6772 6170        Cryptograp
│ │ │ │ +00012b40: 6869 6320 4675 6e63 7469 6f6e 732e 0a20  hic Functions.. 
│ │ │ │  00012b50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00012b60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00012b70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00012b80: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ -00012b90: 2020 3532 3429 0a2a 2073 6869 7368 695f    524).* shishi_
│ │ │ │ -00012ba0: 686f 7374 6b65 7973 5f66 6f72 5f6c 6f63  hostkeys_for_loc
│ │ │ │ -00012bb0: 616c 7365 7276 6963 653a 2020 2020 2020  alservice:      
│ │ │ │ -00012bc0: 4372 7970 746f 6772 6170 6869 6320 4675  Cryptographic Fu
│ │ │ │ -00012bd0: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │ +00012b80: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ +00012b90: 6520 2035 3234 290a 2a20 7368 6973 6869  e  524).* shishi
│ │ │ │ +00012ba0: 5f68 6f73 746b 6579 735f 666f 725f 6c6f  _hostkeys_for_lo
│ │ │ │ +00012bb0: 6361 6c73 6572 7669 6365 3a20 2020 2020  calservice:     
│ │ │ │ +00012bc0: 2043 7279 7074 6f67 7261 7068 6963 2046   Cryptographic F
│ │ │ │ +00012bd0: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │  00012be0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00012bf0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00012c00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00012c10: 2020 2020 2020 286c 696e 6520 2035 3834        (line  584
│ │ │ │ -00012c20: 290a 2a20 7368 6973 6869 5f68 6f73 746b  ).* shishi_hostk
│ │ │ │ -00012c30: 6579 735f 666f 725f 6c6f 6361 6c73 6572  eys_for_localser
│ │ │ │ -00012c40: 7669 6365 7265 616c 6d3a 2043 7279 7074  vicerealm: Crypt
│ │ │ │ -00012c50: 6f67 7261 7068 6963 2046 756e 6374 696f  ographic Functio
│ │ │ │ -00012c60: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │ +00012c10: 2020 2020 2020 2028 6c69 6e65 2020 3538         (line  58
│ │ │ │ +00012c20: 3429 0a2a 2073 6869 7368 695f 686f 7374  4).* shishi_host
│ │ │ │ +00012c30: 6b65 7973 5f66 6f72 5f6c 6f63 616c 7365  keys_for_localse
│ │ │ │ +00012c40: 7276 6963 6572 6561 6c6d 3a20 4372 7970  rvicerealm: Cryp
│ │ │ │ +00012c50: 746f 6772 6170 6869 6320 4675 6e63 7469  tographic Functi
│ │ │ │ +00012c60: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │  00012c70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00012c80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00012c90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00012ca0: 2028 6c69 6e65 2020 3536 3729 0a2a 2073   (line  567).* s
│ │ │ │ -00012cb0: 6869 7368 695f 686f 7374 6b65 7973 5f66  hishi_hostkeys_f
│ │ │ │ -00012cc0: 6f72 5f73 6572 7665 723a 2020 2020 2020  or_server:      
│ │ │ │ -00012cd0: 2020 2020 2020 4372 7970 746f 6772 6170        Cryptograp
│ │ │ │ -00012ce0: 6869 6320 4675 6e63 7469 6f6e 732e 0a20  hic Functions.. 
│ │ │ │ +00012ca0: 2020 286c 696e 6520 2035 3637 290a 2a20    (line  567).* 
│ │ │ │ +00012cb0: 7368 6973 6869 5f68 6f73 746b 6579 735f  shishi_hostkeys_
│ │ │ │ +00012cc0: 666f 725f 7365 7276 6572 3a20 2020 2020  for_server:     
│ │ │ │ +00012cd0: 2020 2020 2020 2043 7279 7074 6f67 7261         Cryptogra
│ │ │ │ +00012ce0: 7068 6963 2046 756e 6374 696f 6e73 2e0a  phic Functions..
│ │ │ │  00012cf0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00012d00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00012d10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00012d20: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ -00012d30: 6520 2035 3337 290a 2a20 7368 6973 6869  e  537).* shishi
│ │ │ │ -00012d40: 5f68 6f73 746b 6579 735f 666f 725f 7365  _hostkeys_for_se
│ │ │ │ -00012d50: 7276 6572 7265 616c 6d3a 2020 2020 2020  rverrealm:      
│ │ │ │ -00012d60: 2043 7279 7074 6f67 7261 7068 6963 2046   Cryptographic F
│ │ │ │ -00012d70: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │ +00012d20: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ +00012d30: 6e65 2020 3533 3729 0a2a 2073 6869 7368  ne  537).* shish
│ │ │ │ +00012d40: 695f 686f 7374 6b65 7973 5f66 6f72 5f73  i_hostkeys_for_s
│ │ │ │ +00012d50: 6572 7665 7272 6561 6c6d 3a20 2020 2020  erverrealm:     
│ │ │ │ +00012d60: 2020 4372 7970 746f 6772 6170 6869 6320    Cryptographic 
│ │ │ │ +00012d70: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │  00012d80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00012d90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00012da0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00012db0: 2020 2020 2020 2028 6c69 6e65 2020 3535         (line  55
│ │ │ │ -00012dc0: 3129 0a2a 2073 6869 7368 695f 696e 666f  1).* shishi_info
│ │ │ │ -00012dd0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ -00012de0: 2020 2020 2020 2020 2020 2020 4572 726f              Erro
│ │ │ │ -00012df0: 7220 4675 6e63 7469 6f6e 732e 2020 2020  r Functions.    
│ │ │ │ -00012e00: 286c 696e 6520 2031 3130 290a 2a20 7368  (line  110).* sh
│ │ │ │ -00012e10: 6973 6869 5f69 6e69 743a 2020 2020 2020  ishi_init:      
│ │ │ │ +00012db0: 2020 2020 2020 2020 286c 696e 6520 2035          (line  5
│ │ │ │ +00012dc0: 3531 290a 2a20 7368 6973 6869 5f69 6e66  51).* shishi_inf
│ │ │ │ +00012dd0: 6f3a 2020 2020 2020 2020 2020 2020 2020  o:              
│ │ │ │ +00012de0: 2020 2020 2020 2020 2020 2020 2045 7272               Err
│ │ │ │ +00012df0: 6f72 2046 756e 6374 696f 6e73 2e20 2020  or Functions.   
│ │ │ │ +00012e00: 2028 6c69 6e65 2020 3131 3029 0a2a 2073   (line  110).* s
│ │ │ │ +00012e10: 6869 7368 695f 696e 6974 3a20 2020 2020  hishi_init:     
│ │ │ │  00012e20: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00012e30: 2020 2020 2049 6e69 7469 616c 697a 6174       Initializat
│ │ │ │ -00012e40: 696f 6e20 4675 6e63 7469 6f6e 732e 0a20  ion Functions.. 
│ │ │ │ +00012e30: 2020 2020 2020 496e 6974 6961 6c69 7a61        Initializa
│ │ │ │ +00012e40: 7469 6f6e 2046 756e 6374 696f 6e73 2e0a  tion Functions..
│ │ │ │  00012e50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00012e60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00012e70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00012e80: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ -00012e90: 6520 2020 3531 290a 2a20 7368 6973 6869  e   51).* shishi
│ │ │ │ -00012ea0: 5f69 6e69 745f 7365 7276 6572 3a20 2020  _init_server:   
│ │ │ │ +00012e80: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ +00012e90: 6e65 2020 2035 3129 0a2a 2073 6869 7368  ne   51).* shish
│ │ │ │ +00012ea0: 695f 696e 6974 5f73 6572 7665 723a 2020  i_init_server:  
│ │ │ │  00012eb0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00012ec0: 2049 6e69 7469 616c 697a 6174 696f 6e20   Initialization 
│ │ │ │ -00012ed0: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │ +00012ec0: 2020 496e 6974 6961 6c69 7a61 7469 6f6e    Initialization
│ │ │ │ +00012ed0: 2046 756e 6374 696f 6e73 2e0a 2020 2020   Functions..    
│ │ │ │  00012ee0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00012ef0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00012f00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00012f10: 2020 2020 2020 2020 286c 696e 6520 2020          (line   
│ │ │ │ -00012f20: 3939 290a 2a20 7368 6973 6869 5f69 6e69  99).* shishi_ini
│ │ │ │ -00012f30: 745f 7365 7276 6572 5f77 6974 685f 7061  t_server_with_pa
│ │ │ │ -00012f40: 7468 733a 2020 2020 2020 2020 2049 6e69  ths:         Ini
│ │ │ │ -00012f50: 7469 616c 697a 6174 696f 6e20 4675 6e63  tialization Func
│ │ │ │ -00012f60: 7469 6f6e 732e 0a20 2020 2020 2020 2020  tions..         
│ │ │ │ +00012f10: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ +00012f20: 2039 3929 0a2a 2073 6869 7368 695f 696e   99).* shishi_in
│ │ │ │ +00012f30: 6974 5f73 6572 7665 725f 7769 7468 5f70  it_server_with_p
│ │ │ │ +00012f40: 6174 6873 3a20 2020 2020 2020 2020 496e  aths:         In
│ │ │ │ +00012f50: 6974 6961 6c69 7a61 7469 6f6e 2046 756e  itialization Fun
│ │ │ │ +00012f60: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │  00012f70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00012f80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00012f90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00012fa0: 2020 2020 286c 696e 6520 2031 3137 290a      (line  117).
│ │ │ │ -00012fb0: 2a20 7368 6973 6869 5f69 6e69 745f 7769  * shishi_init_wi
│ │ │ │ -00012fc0: 7468 5f70 6174 6873 3a20 2020 2020 2020  th_paths:       
│ │ │ │ -00012fd0: 2020 2020 2020 2020 2049 6e69 7469 616c           Initial
│ │ │ │ -00012fe0: 697a 6174 696f 6e20 4675 6e63 7469 6f6e  ization Function
│ │ │ │ -00012ff0: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │ +00012fa0: 2020 2020 2028 6c69 6e65 2020 3131 3729       (line  117)
│ │ │ │ +00012fb0: 0a2a 2073 6869 7368 695f 696e 6974 5f77  .* shishi_init_w
│ │ │ │ +00012fc0: 6974 685f 7061 7468 733a 2020 2020 2020  ith_paths:      
│ │ │ │ +00012fd0: 2020 2020 2020 2020 2020 496e 6974 6961            Initia
│ │ │ │ +00012fe0: 6c69 7a61 7469 6f6e 2046 756e 6374 696f  lization Functio
│ │ │ │ +00012ff0: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │  00013000: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00013010: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00013020: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00013030: 286c 696e 6520 2020 3732 290a 2a20 7368  (line   72).* sh
│ │ │ │ -00013040: 6973 6869 5f6b 6463 5f63 6865 636b 5f6e  ishi_kdc_check_n
│ │ │ │ -00013050: 6f6e 6365 3a20 2020 2020 2020 2020 2020  once:           
│ │ │ │ -00013060: 2020 2020 2041 532f 5447 5320 4675 6e63       AS/TGS Func
│ │ │ │ -00013070: 7469 6f6e 732e 2020 2028 6c69 6e65 2020  tions.   (line  
│ │ │ │ -00013080: 3233 3529 0a2a 2073 6869 7368 695f 6b64  235).* shishi_kd
│ │ │ │ -00013090: 635f 636f 7079 5f63 6e61 6d65 3a20 2020  c_copy_cname:   
│ │ │ │ -000130a0: 2020 2020 2020 2020 2020 2020 2020 4153                AS
│ │ │ │ -000130b0: 2f54 4753 2046 756e 6374 696f 6e73 2e20  /TGS Functions. 
│ │ │ │ -000130c0: 2020 286c 696e 6520 2031 3838 290a 2a20    (line  188).* 
│ │ │ │ -000130d0: 7368 6973 6869 5f6b 6463 5f63 6f70 795f  shishi_kdc_copy_
│ │ │ │ -000130e0: 6372 6561 6c6d 3a20 2020 2020 2020 2020  crealm:         
│ │ │ │ -000130f0: 2020 2020 2020 2041 532f 5447 5320 4675         AS/TGS Fu
│ │ │ │ -00013100: 6e63 7469 6f6e 732e 2020 2028 6c69 6e65  nctions.   (line
│ │ │ │ -00013110: 2020 3135 3529 0a2a 2073 6869 7368 695f    155).* shishi_
│ │ │ │ -00013120: 6b64 635f 636f 7079 5f6e 6f6e 6365 3a20  kdc_copy_nonce: 
│ │ │ │ +00013030: 2028 6c69 6e65 2020 2037 3229 0a2a 2073   (line   72).* s
│ │ │ │ +00013040: 6869 7368 695f 6b64 635f 6368 6563 6b5f  hishi_kdc_check_
│ │ │ │ +00013050: 6e6f 6e63 653a 2020 2020 2020 2020 2020  nonce:          
│ │ │ │ +00013060: 2020 2020 2020 4153 2f54 4753 2046 756e        AS/TGS Fun
│ │ │ │ +00013070: 6374 696f 6e73 2e20 2020 286c 696e 6520  ctions.   (line 
│ │ │ │ +00013080: 2032 3335 290a 2a20 7368 6973 6869 5f6b   235).* shishi_k
│ │ │ │ +00013090: 6463 5f63 6f70 795f 636e 616d 653a 2020  dc_copy_cname:  
│ │ │ │ +000130a0: 2020 2020 2020 2020 2020 2020 2020 2041                 A
│ │ │ │ +000130b0: 532f 5447 5320 4675 6e63 7469 6f6e 732e  S/TGS Functions.
│ │ │ │ +000130c0: 2020 2028 6c69 6e65 2020 3138 3829 0a2a     (line  188).*
│ │ │ │ +000130d0: 2073 6869 7368 695f 6b64 635f 636f 7079   shishi_kdc_copy
│ │ │ │ +000130e0: 5f63 7265 616c 6d3a 2020 2020 2020 2020  _crealm:        
│ │ │ │ +000130f0: 2020 2020 2020 2020 4153 2f54 4753 2046          AS/TGS F
│ │ │ │ +00013100: 756e 6374 696f 6e73 2e20 2020 286c 696e  unctions.   (lin
│ │ │ │ +00013110: 6520 2031 3535 290a 2a20 7368 6973 6869  e  155).* shishi
│ │ │ │ +00013120: 5f6b 6463 5f63 6f70 795f 6e6f 6e63 653a  _kdc_copy_nonce:
│ │ │ │  00013130: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00013140: 4153 2f54 4753 2046 756e 6374 696f 6e73  AS/TGS Functions
│ │ │ │ -00013150: 2e20 2020 286c 696e 6520 2032 3231 290a  .   (line  221).
│ │ │ │ -00013160: 2a20 7368 6973 6869 5f6b 6463 5f70 726f  * shishi_kdc_pro
│ │ │ │ -00013170: 6365 7373 3a20 2020 2020 2020 2020 2020  cess:           
│ │ │ │ -00013180: 2020 2020 2020 2020 2041 532f 5447 5320           AS/TGS 
│ │ │ │ -00013190: 4675 6e63 7469 6f6e 732e 2020 2028 6c69  Functions.   (li
│ │ │ │ -000131a0: 6e65 2020 3330 3029 0a2a 2073 6869 7368  ne  300).* shish
│ │ │ │ -000131b0: 695f 6b64 6372 6570 5f61 6464 5f65 6e63  i_kdcrep_add_enc
│ │ │ │ -000131c0: 5f70 6172 743a 2020 2020 2020 2020 2020  _part:          
│ │ │ │ -000131d0: 2020 4153 2f54 4753 2046 756e 6374 696f    AS/TGS Functio
│ │ │ │ -000131e0: 6e73 2e20 2020 286c 696e 6520 3132 3232  ns.   (line 1222
│ │ │ │ -000131f0: 290a 2a20 7368 6973 6869 5f6b 6463 7265  ).* shishi_kdcre
│ │ │ │ -00013200: 705f 636c 6561 725f 7061 6461 7461 3a20  p_clear_padata: 
│ │ │ │ -00013210: 2020 2020 2020 2020 2020 2041 532f 5447             AS/TG
│ │ │ │ -00013220: 5320 4675 6e63 7469 6f6e 732e 2020 2028  S Functions.   (
│ │ │ │ -00013230: 6c69 6e65 2031 3234 3129 0a2a 2073 6869  line 1241).* shi
│ │ │ │ -00013240: 7368 695f 6b64 6372 6570 5f63 6c69 656e  shi_kdcrep_clien
│ │ │ │ -00013250: 745f 7365 743a 2020 2020 2020 2020 2020  t_set:          
│ │ │ │ -00013260: 2020 2020 4153 2f54 4753 2046 756e 6374      AS/TGS Funct
│ │ │ │ -00013270: 696f 6e73 2e20 2020 286c 696e 6520 3131  ions.   (line 11
│ │ │ │ -00013280: 3438 290a 2a20 7368 6973 6869 5f6b 6463  48).* shishi_kdc
│ │ │ │ -00013290: 7265 705f 636e 616d 655f 7365 743a 2020  rep_cname_set:  
│ │ │ │ -000132a0: 2020 2020 2020 2020 2020 2020 2041 532f               AS/
│ │ │ │ -000132b0: 5447 5320 4675 6e63 7469 6f6e 732e 2020  TGS Functions.  
│ │ │ │ -000132c0: 2028 6c69 6e65 2031 3133 3229 0a2a 2073   (line 1132).* s
│ │ │ │ -000132d0: 6869 7368 695f 6b64 6372 6570 5f63 7265  hishi_kdcrep_cre
│ │ │ │ -000132e0: 616c 6d5f 7365 743a 2020 2020 2020 2020  alm_set:        
│ │ │ │ -000132f0: 2020 2020 2020 4153 2f54 4753 2046 756e        AS/TGS Fun
│ │ │ │ -00013300: 6374 696f 6e73 2e20 2020 286c 696e 6520  ctions.   (line 
│ │ │ │ -00013310: 3131 3139 290a 2a20 7368 6973 6869 5f6b  1119).* shishi_k
│ │ │ │ -00013320: 6463 7265 705f 6672 6f6d 5f66 696c 653a  dcrep_from_file:
│ │ │ │ -00013330: 2020 2020 2020 2020 2020 2020 2020 2041                 A
│ │ │ │ -00013340: 532f 5447 5320 4675 6e63 7469 6f6e 732e  S/TGS Functions.
│ │ │ │ -00013350: 2020 2028 6c69 6e65 2031 3130 3429 0a2a     (line 1104).*
│ │ │ │ -00013360: 2073 6869 7368 695f 6b64 6372 6570 5f67   shishi_kdcrep_g
│ │ │ │ -00013370: 6574 5f65 6e63 5f70 6172 745f 6574 7970  et_enc_part_etyp
│ │ │ │ -00013380: 653a 2020 2020 2020 4153 2f54 4753 2046  e:      AS/TGS F
│ │ │ │ -00013390: 756e 6374 696f 6e73 2e20 2020 286c 696e  unctions.   (lin
│ │ │ │ -000133a0: 6520 3131 3632 290a 2a20 7368 6973 6869  e 1162).* shishi
│ │ │ │ -000133b0: 5f6b 6463 7265 705f 6765 745f 7469 636b  _kdcrep_get_tick
│ │ │ │ -000133c0: 6574 3a20 2020 2020 2020 2020 2020 2020  et:             
│ │ │ │ -000133d0: 2041 532f 5447 5320 4675 6e63 7469 6f6e   AS/TGS Function
│ │ │ │ -000133e0: 732e 2020 2028 6c69 6e65 2031 3137 3529  s.   (line 1175)
│ │ │ │ -000133f0: 0a2a 2073 6869 7368 695f 6b64 6372 6570  .* shishi_kdcrep
│ │ │ │ -00013400: 5f70 6172 7365 3a20 2020 2020 2020 2020  _parse:         
│ │ │ │ -00013410: 2020 2020 2020 2020 2020 4153 2f54 4753            AS/TGS
│ │ │ │ -00013420: 2046 756e 6374 696f 6e73 2e20 2020 286c   Functions.   (l
│ │ │ │ -00013430: 696e 6520 3130 3736 290a 2a20 7368 6973  ine 1076).* shis
│ │ │ │ -00013440: 6869 5f6b 6463 7265 705f 7072 696e 743a  hi_kdcrep_print:
│ │ │ │ -00013450: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00013460: 2020 2041 532f 5447 5320 4675 6e63 7469     AS/TGS Functi
│ │ │ │ -00013470: 6f6e 732e 2020 2028 6c69 6e65 2031 3033  ons.   (line 103
│ │ │ │ -00013480: 3429 0a2a 2073 6869 7368 695f 6b64 6372  4).* shishi_kdcr
│ │ │ │ -00013490: 6570 5f72 6561 643a 2020 2020 2020 2020  ep_read:        
│ │ │ │ -000134a0: 2020 2020 2020 2020 2020 2020 4153 2f54              AS/T
│ │ │ │ -000134b0: 4753 2046 756e 6374 696f 6e73 2e20 2020  GS Functions.   
│ │ │ │ -000134c0: 286c 696e 6520 3130 3930 290a 2a20 7368  (line 1090).* sh
│ │ │ │ -000134d0: 6973 6869 5f6b 6463 7265 705f 7361 7665  ishi_kdcrep_save
│ │ │ │ -000134e0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ -000134f0: 2020 2020 2041 532f 5447 5320 4675 6e63       AS/TGS Func
│ │ │ │ -00013500: 7469 6f6e 732e 2020 2028 6c69 6e65 2031  tions.   (line 1
│ │ │ │ -00013510: 3034 3729 0a2a 2073 6869 7368 695f 6b64  047).* shishi_kd
│ │ │ │ -00013520: 6372 6570 5f73 6574 5f65 6e63 5f70 6172  crep_set_enc_par
│ │ │ │ -00013530: 743a 2020 2020 2020 2020 2020 2020 4153  t:            AS
│ │ │ │ -00013540: 2f54 4753 2046 756e 6374 696f 6e73 2e20  /TGS Functions. 
│ │ │ │ -00013550: 2020 286c 696e 6520 3132 3031 290a 2a20    (line 1201).* 
│ │ │ │ -00013560: 7368 6973 6869 5f6b 6463 7265 705f 7365  shishi_kdcrep_se
│ │ │ │ -00013570: 745f 7469 636b 6574 3a20 2020 2020 2020  t_ticket:       
│ │ │ │ -00013580: 2020 2020 2020 2041 532f 5447 5320 4675         AS/TGS Fu
│ │ │ │ -00013590: 6e63 7469 6f6e 732e 2020 2028 6c69 6e65  nctions.   (line
│ │ │ │ -000135a0: 2031 3138 3829 0a2a 2073 6869 7368 695f   1188).* shishi_
│ │ │ │ -000135b0: 6b64 6372 6570 5f74 6f5f 6669 6c65 3a20  kdcrep_to_file: 
│ │ │ │ +00013140: 2041 532f 5447 5320 4675 6e63 7469 6f6e   AS/TGS Function
│ │ │ │ +00013150: 732e 2020 2028 6c69 6e65 2020 3232 3129  s.   (line  221)
│ │ │ │ +00013160: 0a2a 2073 6869 7368 695f 6b64 635f 7072  .* shishi_kdc_pr
│ │ │ │ +00013170: 6f63 6573 733a 2020 2020 2020 2020 2020  ocess:          
│ │ │ │ +00013180: 2020 2020 2020 2020 2020 4153 2f54 4753            AS/TGS
│ │ │ │ +00013190: 2046 756e 6374 696f 6e73 2e20 2020 286c   Functions.   (l
│ │ │ │ +000131a0: 696e 6520 2033 3030 290a 2a20 7368 6973  ine  300).* shis
│ │ │ │ +000131b0: 6869 5f6b 6463 7265 705f 6164 645f 656e  hi_kdcrep_add_en
│ │ │ │ +000131c0: 635f 7061 7274 3a20 2020 2020 2020 2020  c_part:         
│ │ │ │ +000131d0: 2020 2041 532f 5447 5320 4675 6e63 7469     AS/TGS Functi
│ │ │ │ +000131e0: 6f6e 732e 2020 2028 6c69 6e65 2031 3232  ons.   (line 122
│ │ │ │ +000131f0: 3229 0a2a 2073 6869 7368 695f 6b64 6372  2).* shishi_kdcr
│ │ │ │ +00013200: 6570 5f63 6c65 6172 5f70 6164 6174 613a  ep_clear_padata:
│ │ │ │ +00013210: 2020 2020 2020 2020 2020 2020 4153 2f54              AS/T
│ │ │ │ +00013220: 4753 2046 756e 6374 696f 6e73 2e20 2020  GS Functions.   
│ │ │ │ +00013230: 286c 696e 6520 3132 3431 290a 2a20 7368  (line 1241).* sh
│ │ │ │ +00013240: 6973 6869 5f6b 6463 7265 705f 636c 6965  ishi_kdcrep_clie
│ │ │ │ +00013250: 6e74 5f73 6574 3a20 2020 2020 2020 2020  nt_set:         
│ │ │ │ +00013260: 2020 2020 2041 532f 5447 5320 4675 6e63       AS/TGS Func
│ │ │ │ +00013270: 7469 6f6e 732e 2020 2028 6c69 6e65 2031  tions.   (line 1
│ │ │ │ +00013280: 3134 3829 0a2a 2073 6869 7368 695f 6b64  148).* shishi_kd
│ │ │ │ +00013290: 6372 6570 5f63 6e61 6d65 5f73 6574 3a20  crep_cname_set: 
│ │ │ │ +000132a0: 2020 2020 2020 2020 2020 2020 2020 4153                AS
│ │ │ │ +000132b0: 2f54 4753 2046 756e 6374 696f 6e73 2e20  /TGS Functions. 
│ │ │ │ +000132c0: 2020 286c 696e 6520 3131 3332 290a 2a20    (line 1132).* 
│ │ │ │ +000132d0: 7368 6973 6869 5f6b 6463 7265 705f 6372  shishi_kdcrep_cr
│ │ │ │ +000132e0: 6561 6c6d 5f73 6574 3a20 2020 2020 2020  ealm_set:       
│ │ │ │ +000132f0: 2020 2020 2020 2041 532f 5447 5320 4675         AS/TGS Fu
│ │ │ │ +00013300: 6e63 7469 6f6e 732e 2020 2028 6c69 6e65  nctions.   (line
│ │ │ │ +00013310: 2031 3131 3929 0a2a 2073 6869 7368 695f   1119).* shishi_
│ │ │ │ +00013320: 6b64 6372 6570 5f66 726f 6d5f 6669 6c65  kdcrep_from_file
│ │ │ │ +00013330: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ +00013340: 4153 2f54 4753 2046 756e 6374 696f 6e73  AS/TGS Functions
│ │ │ │ +00013350: 2e20 2020 286c 696e 6520 3131 3034 290a  .   (line 1104).
│ │ │ │ +00013360: 2a20 7368 6973 6869 5f6b 6463 7265 705f  * shishi_kdcrep_
│ │ │ │ +00013370: 6765 745f 656e 635f 7061 7274 5f65 7479  get_enc_part_ety
│ │ │ │ +00013380: 7065 3a20 2020 2020 2041 532f 5447 5320  pe:      AS/TGS 
│ │ │ │ +00013390: 4675 6e63 7469 6f6e 732e 2020 2028 6c69  Functions.   (li
│ │ │ │ +000133a0: 6e65 2031 3136 3229 0a2a 2073 6869 7368  ne 1162).* shish
│ │ │ │ +000133b0: 695f 6b64 6372 6570 5f67 6574 5f74 6963  i_kdcrep_get_tic
│ │ │ │ +000133c0: 6b65 743a 2020 2020 2020 2020 2020 2020  ket:            
│ │ │ │ +000133d0: 2020 4153 2f54 4753 2046 756e 6374 696f    AS/TGS Functio
│ │ │ │ +000133e0: 6e73 2e20 2020 286c 696e 6520 3131 3735  ns.   (line 1175
│ │ │ │ +000133f0: 290a 2a20 7368 6973 6869 5f6b 6463 7265  ).* shishi_kdcre
│ │ │ │ +00013400: 705f 7061 7273 653a 2020 2020 2020 2020  p_parse:        
│ │ │ │ +00013410: 2020 2020 2020 2020 2020 2041 532f 5447             AS/TG
│ │ │ │ +00013420: 5320 4675 6e63 7469 6f6e 732e 2020 2028  S Functions.   (
│ │ │ │ +00013430: 6c69 6e65 2031 3037 3629 0a2a 2073 6869  line 1076).* shi
│ │ │ │ +00013440: 7368 695f 6b64 6372 6570 5f70 7269 6e74  shi_kdcrep_print
│ │ │ │ +00013450: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ +00013460: 2020 2020 4153 2f54 4753 2046 756e 6374      AS/TGS Funct
│ │ │ │ +00013470: 696f 6e73 2e20 2020 286c 696e 6520 3130  ions.   (line 10
│ │ │ │ +00013480: 3334 290a 2a20 7368 6973 6869 5f6b 6463  34).* shishi_kdc
│ │ │ │ +00013490: 7265 705f 7265 6164 3a20 2020 2020 2020  rep_read:       
│ │ │ │ +000134a0: 2020 2020 2020 2020 2020 2020 2041 532f               AS/
│ │ │ │ +000134b0: 5447 5320 4675 6e63 7469 6f6e 732e 2020  TGS Functions.  
│ │ │ │ +000134c0: 2028 6c69 6e65 2031 3039 3029 0a2a 2073   (line 1090).* s
│ │ │ │ +000134d0: 6869 7368 695f 6b64 6372 6570 5f73 6176  hishi_kdcrep_sav
│ │ │ │ +000134e0: 653a 2020 2020 2020 2020 2020 2020 2020  e:              
│ │ │ │ +000134f0: 2020 2020 2020 4153 2f54 4753 2046 756e        AS/TGS Fun
│ │ │ │ +00013500: 6374 696f 6e73 2e20 2020 286c 696e 6520  ctions.   (line 
│ │ │ │ +00013510: 3130 3437 290a 2a20 7368 6973 6869 5f6b  1047).* shishi_k
│ │ │ │ +00013520: 6463 7265 705f 7365 745f 656e 635f 7061  dcrep_set_enc_pa
│ │ │ │ +00013530: 7274 3a20 2020 2020 2020 2020 2020 2041  rt:            A
│ │ │ │ +00013540: 532f 5447 5320 4675 6e63 7469 6f6e 732e  S/TGS Functions.
│ │ │ │ +00013550: 2020 2028 6c69 6e65 2031 3230 3129 0a2a     (line 1201).*
│ │ │ │ +00013560: 2073 6869 7368 695f 6b64 6372 6570 5f73   shishi_kdcrep_s
│ │ │ │ +00013570: 6574 5f74 6963 6b65 743a 2020 2020 2020  et_ticket:      
│ │ │ │ +00013580: 2020 2020 2020 2020 4153 2f54 4753 2046          AS/TGS F
│ │ │ │ +00013590: 756e 6374 696f 6e73 2e20 2020 286c 696e  unctions.   (lin
│ │ │ │ +000135a0: 6520 3131 3838 290a 2a20 7368 6973 6869  e 1188).* shishi
│ │ │ │ +000135b0: 5f6b 6463 7265 705f 746f 5f66 696c 653a  _kdcrep_to_file:
│ │ │ │  000135c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000135d0: 4153 2f54 4753 2046 756e 6374 696f 6e73  AS/TGS Functions
│ │ │ │ -000135e0: 2e20 2020 286c 696e 6520 3130 3630 290a  .   (line 1060).
│ │ │ │ -000135f0: 2a20 7368 6973 6869 5f6b 6463 7265 715f  * shishi_kdcreq_
│ │ │ │ -00013600: 6164 645f 7061 6461 7461 3a20 2020 2020  add_padata:     
│ │ │ │ -00013610: 2020 2020 2020 2020 2041 532f 5447 5320           AS/TGS 
│ │ │ │ -00013620: 4675 6e63 7469 6f6e 732e 2020 2028 6c69  Functions.   (li
│ │ │ │ -00013630: 6e65 2020 3936 3329 0a2a 2073 6869 7368  ne  963).* shish
│ │ │ │ -00013640: 695f 6b64 6372 6571 5f61 6464 5f70 6164  i_kdcreq_add_pad
│ │ │ │ -00013650: 6174 615f 7072 6561 7574 683a 2020 2020  ata_preauth:    
│ │ │ │ -00013660: 2020 4153 2f54 4753 2046 756e 6374 696f    AS/TGS Functio
│ │ │ │ -00013670: 6e73 2e20 2020 286c 696e 6520 2039 3939  ns.   (line  999
│ │ │ │ -00013680: 290a 2a20 7368 6973 6869 5f6b 6463 7265  ).* shishi_kdcre
│ │ │ │ -00013690: 715f 6164 645f 7061 6461 7461 5f74 6773  q_add_padata_tgs
│ │ │ │ -000136a0: 3a20 2020 2020 2020 2020 2041 532f 5447  :          AS/TG
│ │ │ │ -000136b0: 5320 4675 6e63 7469 6f6e 732e 2020 2028  S Functions.   (
│ │ │ │ -000136c0: 6c69 6e65 2020 3938 3329 0a2a 2073 6869  line  983).* shi
│ │ │ │ -000136d0: 7368 695f 6b64 6372 6571 5f61 6c6c 6f77  shi_kdcreq_allow
│ │ │ │ -000136e0: 5f70 6f73 7464 6174 655f 703a 2020 2020  _postdate_p:    
│ │ │ │ -000136f0: 2020 2020 4153 2f54 4753 2046 756e 6374      AS/TGS Funct
│ │ │ │ -00013700: 696f 6e73 2e20 2020 286c 696e 6520 2037  ions.   (line  7
│ │ │ │ -00013710: 3235 290a 2a20 7368 6973 6869 5f6b 6463  25).* shishi_kdc
│ │ │ │ -00013720: 7265 715f 636c 6561 725f 7061 6461 7461  req_clear_padata
│ │ │ │ -00013730: 3a20 2020 2020 2020 2020 2020 2041 532f  :            AS/
│ │ │ │ -00013740: 5447 5320 4675 6e63 7469 6f6e 732e 2020  TGS Functions.  
│ │ │ │ -00013750: 2028 6c69 6e65 2020 3931 3629 0a2a 2073   (line  916).* s
│ │ │ │ -00013760: 6869 7368 695f 6b64 6372 6571 5f63 6c69  hishi_kdcreq_cli
│ │ │ │ -00013770: 656e 743a 2020 2020 2020 2020 2020 2020  ent:            
│ │ │ │ -00013780: 2020 2020 2020 4153 2f54 4753 2046 756e        AS/TGS Fun
│ │ │ │ -00013790: 6374 696f 6e73 2e20 2020 286c 696e 6520  ctions.   (line 
│ │ │ │ -000137a0: 2034 3635 290a 2a20 7368 6973 6869 5f6b   465).* shishi_k
│ │ │ │ -000137b0: 6463 7265 715f 6469 7361 626c 655f 7472  dcreq_disable_tr
│ │ │ │ -000137c0: 616e 7369 7465 645f 6368 6563 6b5f 703a  ansited_check_p:
│ │ │ │ -000137d0: 2041 532f 5447 5320 4675 6e63 7469 6f6e   AS/TGS Function
│ │ │ │ -000137e0: 732e 2028 6c69 6e65 2020 3738 3129 0a2a  s. (line  781).*
│ │ │ │ -000137f0: 2073 6869 7368 695f 6b64 6372 6571 5f65   shishi_kdcreq_e
│ │ │ │ -00013800: 6e63 5f74 6b74 5f69 6e5f 736b 6579 5f70  nc_tkt_in_skey_p
│ │ │ │ -00013810: 3a20 2020 2020 2020 4153 2f54 4753 2046  :       AS/TGS F
│ │ │ │ -00013820: 756e 6374 696f 6e73 2e20 2020 286c 696e  unctions.   (lin
│ │ │ │ -00013830: 6520 2038 3239 290a 2a20 7368 6973 6869  e  829).* shishi
│ │ │ │ -00013840: 5f6b 6463 7265 715f 6574 7970 653a 2020  _kdcreq_etype:  
│ │ │ │ +000135d0: 2041 532f 5447 5320 4675 6e63 7469 6f6e   AS/TGS Function
│ │ │ │ +000135e0: 732e 2020 2028 6c69 6e65 2031 3036 3029  s.   (line 1060)
│ │ │ │ +000135f0: 0a2a 2073 6869 7368 695f 6b64 6372 6571  .* shishi_kdcreq
│ │ │ │ +00013600: 5f61 6464 5f70 6164 6174 613a 2020 2020  _add_padata:    
│ │ │ │ +00013610: 2020 2020 2020 2020 2020 4153 2f54 4753            AS/TGS
│ │ │ │ +00013620: 2046 756e 6374 696f 6e73 2e20 2020 286c   Functions.   (l
│ │ │ │ +00013630: 696e 6520 2039 3633 290a 2a20 7368 6973  ine  963).* shis
│ │ │ │ +00013640: 6869 5f6b 6463 7265 715f 6164 645f 7061  hi_kdcreq_add_pa
│ │ │ │ +00013650: 6461 7461 5f70 7265 6175 7468 3a20 2020  data_preauth:   
│ │ │ │ +00013660: 2020 2041 532f 5447 5320 4675 6e63 7469     AS/TGS Functi
│ │ │ │ +00013670: 6f6e 732e 2020 2028 6c69 6e65 2020 3939  ons.   (line  99
│ │ │ │ +00013680: 3929 0a2a 2073 6869 7368 695f 6b64 6372  9).* shishi_kdcr
│ │ │ │ +00013690: 6571 5f61 6464 5f70 6164 6174 615f 7467  eq_add_padata_tg
│ │ │ │ +000136a0: 733a 2020 2020 2020 2020 2020 4153 2f54  s:          AS/T
│ │ │ │ +000136b0: 4753 2046 756e 6374 696f 6e73 2e20 2020  GS Functions.   
│ │ │ │ +000136c0: 286c 696e 6520 2039 3833 290a 2a20 7368  (line  983).* sh
│ │ │ │ +000136d0: 6973 6869 5f6b 6463 7265 715f 616c 6c6f  ishi_kdcreq_allo
│ │ │ │ +000136e0: 775f 706f 7374 6461 7465 5f70 3a20 2020  w_postdate_p:   
│ │ │ │ +000136f0: 2020 2020 2041 532f 5447 5320 4675 6e63       AS/TGS Func
│ │ │ │ +00013700: 7469 6f6e 732e 2020 2028 6c69 6e65 2020  tions.   (line  
│ │ │ │ +00013710: 3732 3529 0a2a 2073 6869 7368 695f 6b64  725).* shishi_kd
│ │ │ │ +00013720: 6372 6571 5f63 6c65 6172 5f70 6164 6174  creq_clear_padat
│ │ │ │ +00013730: 613a 2020 2020 2020 2020 2020 2020 4153  a:            AS
│ │ │ │ +00013740: 2f54 4753 2046 756e 6374 696f 6e73 2e20  /TGS Functions. 
│ │ │ │ +00013750: 2020 286c 696e 6520 2039 3136 290a 2a20    (line  916).* 
│ │ │ │ +00013760: 7368 6973 6869 5f6b 6463 7265 715f 636c  shishi_kdcreq_cl
│ │ │ │ +00013770: 6965 6e74 3a20 2020 2020 2020 2020 2020  ient:           
│ │ │ │ +00013780: 2020 2020 2020 2041 532f 5447 5320 4675         AS/TGS Fu
│ │ │ │ +00013790: 6e63 7469 6f6e 732e 2020 2028 6c69 6e65  nctions.   (line
│ │ │ │ +000137a0: 2020 3436 3529 0a2a 2073 6869 7368 695f    465).* shishi_
│ │ │ │ +000137b0: 6b64 6372 6571 5f64 6973 6162 6c65 5f74  kdcreq_disable_t
│ │ │ │ +000137c0: 7261 6e73 6974 6564 5f63 6865 636b 5f70  ransited_check_p
│ │ │ │ +000137d0: 3a20 4153 2f54 4753 2046 756e 6374 696f  : AS/TGS Functio
│ │ │ │ +000137e0: 6e73 2e20 286c 696e 6520 2037 3831 290a  ns. (line  781).
│ │ │ │ +000137f0: 2a20 7368 6973 6869 5f6b 6463 7265 715f  * shishi_kdcreq_
│ │ │ │ +00013800: 656e 635f 746b 745f 696e 5f73 6b65 795f  enc_tkt_in_skey_
│ │ │ │ +00013810: 703a 2020 2020 2020 2041 532f 5447 5320  p:       AS/TGS 
│ │ │ │ +00013820: 4675 6e63 7469 6f6e 732e 2020 2028 6c69  Functions.   (li
│ │ │ │ +00013830: 6e65 2020 3832 3929 0a2a 2073 6869 7368  ne  829).* shish
│ │ │ │ +00013840: 695f 6b64 6372 6571 5f65 7479 7065 3a20  i_kdcreq_etype: 
│ │ │ │  00013850: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00013860: 2041 532f 5447 5320 4675 6e63 7469 6f6e   AS/TGS Function
│ │ │ │ -00013870: 732e 2020 2028 6c69 6e65 2020 3631 3029  s.   (line  610)
│ │ │ │ -00013880: 0a2a 2073 6869 7368 695f 6b64 6372 6571  .* shishi_kdcreq
│ │ │ │ -00013890: 5f66 6f72 7761 7264 6162 6c65 5f70 3a20  _forwardable_p: 
│ │ │ │ -000138a0: 2020 2020 2020 2020 2020 4153 2f54 4753            AS/TGS
│ │ │ │ -000138b0: 2046 756e 6374 696f 6e73 2e20 2020 286c   Functions.   (l
│ │ │ │ -000138c0: 696e 6520 2036 3533 290a 2a20 7368 6973  ine  653).* shis
│ │ │ │ -000138d0: 6869 5f6b 6463 7265 715f 666f 7277 6172  hi_kdcreq_forwar
│ │ │ │ -000138e0: 6465 645f 703a 2020 2020 2020 2020 2020  ded_p:          
│ │ │ │ -000138f0: 2020 2041 532f 5447 5320 4675 6e63 7469     AS/TGS Functi
│ │ │ │ -00013900: 6f6e 732e 2020 2028 6c69 6e65 2020 3637  ons.   (line  67
│ │ │ │ -00013910: 3129 0a2a 2073 6869 7368 695f 6b64 6372  1).* shishi_kdcr
│ │ │ │ -00013920: 6571 5f66 726f 6d5f 6669 6c65 3a20 2020  eq_from_file:   
│ │ │ │ -00013930: 2020 2020 2020 2020 2020 2020 4153 2f54              AS/T
│ │ │ │ -00013940: 4753 2046 756e 6374 696f 6e73 2e20 2020  GS Functions.   
│ │ │ │ -00013950: 286c 696e 6520 2034 3231 290a 2a20 7368  (line  421).* sh
│ │ │ │ -00013960: 6973 6869 5f6b 6463 7265 715f 6765 745f  ishi_kdcreq_get_
│ │ │ │ -00013970: 7061 6461 7461 3a20 2020 2020 2020 2020  padata:         
│ │ │ │ -00013980: 2020 2020 2041 532f 5447 5320 4675 6e63       AS/TGS Func
│ │ │ │ -00013990: 7469 6f6e 732e 2020 2028 6c69 6e65 2020  tions.   (line  
│ │ │ │ -000139a0: 3932 3829 0a2a 2073 6869 7368 695f 6b64  928).* shishi_kd
│ │ │ │ -000139b0: 6372 6571 5f67 6574 5f70 6164 6174 615f  creq_get_padata_
│ │ │ │ -000139c0: 7467 733a 2020 2020 2020 2020 2020 4153  tgs:          AS
│ │ │ │ -000139d0: 2f54 4753 2046 756e 6374 696f 6e73 2e20  /TGS Functions. 
│ │ │ │ -000139e0: 2020 286c 696e 6520 2039 3437 290a 2a20    (line  947).* 
│ │ │ │ -000139f0: 7368 6973 6869 5f6b 6463 7265 715f 6e6f  shishi_kdcreq_no
│ │ │ │ -00013a00: 6e63 655f 7365 743a 2020 2020 2020 2020  nce_set:        
│ │ │ │ -00013a10: 2020 2020 2020 2041 532f 5447 5320 4675         AS/TGS Fu
│ │ │ │ -00013a20: 6e63 7469 6f6e 732e 2020 2028 6c69 6e65  nctions.   (line
│ │ │ │ -00013a30: 2020 3433 3629 0a2a 2073 6869 7368 695f    436).* shishi_
│ │ │ │ -00013a40: 6b64 6372 6571 5f6f 7074 696f 6e73 3a20  kdcreq_options: 
│ │ │ │ +00013860: 2020 4153 2f54 4753 2046 756e 6374 696f    AS/TGS Functio
│ │ │ │ +00013870: 6e73 2e20 2020 286c 696e 6520 2036 3130  ns.   (line  610
│ │ │ │ +00013880: 290a 2a20 7368 6973 6869 5f6b 6463 7265  ).* shishi_kdcre
│ │ │ │ +00013890: 715f 666f 7277 6172 6461 626c 655f 703a  q_forwardable_p:
│ │ │ │ +000138a0: 2020 2020 2020 2020 2020 2041 532f 5447             AS/TG
│ │ │ │ +000138b0: 5320 4675 6e63 7469 6f6e 732e 2020 2028  S Functions.   (
│ │ │ │ +000138c0: 6c69 6e65 2020 3635 3329 0a2a 2073 6869  line  653).* shi
│ │ │ │ +000138d0: 7368 695f 6b64 6372 6571 5f66 6f72 7761  shi_kdcreq_forwa
│ │ │ │ +000138e0: 7264 6564 5f70 3a20 2020 2020 2020 2020  rded_p:         
│ │ │ │ +000138f0: 2020 2020 4153 2f54 4753 2046 756e 6374      AS/TGS Funct
│ │ │ │ +00013900: 696f 6e73 2e20 2020 286c 696e 6520 2036  ions.   (line  6
│ │ │ │ +00013910: 3731 290a 2a20 7368 6973 6869 5f6b 6463  71).* shishi_kdc
│ │ │ │ +00013920: 7265 715f 6672 6f6d 5f66 696c 653a 2020  req_from_file:  
│ │ │ │ +00013930: 2020 2020 2020 2020 2020 2020 2041 532f               AS/
│ │ │ │ +00013940: 5447 5320 4675 6e63 7469 6f6e 732e 2020  TGS Functions.  
│ │ │ │ +00013950: 2028 6c69 6e65 2020 3432 3129 0a2a 2073   (line  421).* s
│ │ │ │ +00013960: 6869 7368 695f 6b64 6372 6571 5f67 6574  hishi_kdcreq_get
│ │ │ │ +00013970: 5f70 6164 6174 613a 2020 2020 2020 2020  _padata:        
│ │ │ │ +00013980: 2020 2020 2020 4153 2f54 4753 2046 756e        AS/TGS Fun
│ │ │ │ +00013990: 6374 696f 6e73 2e20 2020 286c 696e 6520  ctions.   (line 
│ │ │ │ +000139a0: 2039 3238 290a 2a20 7368 6973 6869 5f6b   928).* shishi_k
│ │ │ │ +000139b0: 6463 7265 715f 6765 745f 7061 6461 7461  dcreq_get_padata
│ │ │ │ +000139c0: 5f74 6773 3a20 2020 2020 2020 2020 2041  _tgs:          A
│ │ │ │ +000139d0: 532f 5447 5320 4675 6e63 7469 6f6e 732e  S/TGS Functions.
│ │ │ │ +000139e0: 2020 2028 6c69 6e65 2020 3934 3729 0a2a     (line  947).*
│ │ │ │ +000139f0: 2073 6869 7368 695f 6b64 6372 6571 5f6e   shishi_kdcreq_n
│ │ │ │ +00013a00: 6f6e 6365 5f73 6574 3a20 2020 2020 2020  once_set:       
│ │ │ │ +00013a10: 2020 2020 2020 2020 4153 2f54 4753 2046          AS/TGS F
│ │ │ │ +00013a20: 756e 6374 696f 6e73 2e20 2020 286c 696e  unctions.   (lin
│ │ │ │ +00013a30: 6520 2034 3336 290a 2a20 7368 6973 6869  e  436).* shishi
│ │ │ │ +00013a40: 5f6b 6463 7265 715f 6f70 7469 6f6e 733a  _kdcreq_options:
│ │ │ │  00013a50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00013a60: 4153 2f54 4753 2046 756e 6374 696f 6e73  AS/TGS Functions
│ │ │ │ -00013a70: 2e20 2020 286c 696e 6520 2036 3430 290a  .   (line  640).
│ │ │ │ -00013a80: 2a20 7368 6973 6869 5f6b 6463 7265 715f  * shishi_kdcreq_
│ │ │ │ -00013a90: 6f70 7469 6f6e 735f 6164 643a 2020 2020  options_add:    
│ │ │ │ -00013aa0: 2020 2020 2020 2020 2041 532f 5447 5320           AS/TGS 
│ │ │ │ -00013ab0: 4675 6e63 7469 6f6e 732e 2020 2028 6c69  Functions.   (li
│ │ │ │ -00013ac0: 6e65 2020 3930 3229 0a2a 2073 6869 7368  ne  902).* shish
│ │ │ │ -00013ad0: 695f 6b64 6372 6571 5f6f 7074 696f 6e73  i_kdcreq_options
│ │ │ │ -00013ae0: 5f73 6574 3a20 2020 2020 2020 2020 2020  _set:           
│ │ │ │ -00013af0: 2020 4153 2f54 4753 2046 756e 6374 696f    AS/TGS Functio
│ │ │ │ -00013b00: 6e73 2e20 2020 286c 696e 6520 2038 3838  ns.   (line  888
│ │ │ │ -00013b10: 290a 2a20 7368 6973 6869 5f6b 6463 7265  ).* shishi_kdcre
│ │ │ │ -00013b20: 715f 7061 7273 653a 2020 2020 2020 2020  q_parse:        
│ │ │ │ -00013b30: 2020 2020 2020 2020 2020 2041 532f 5447             AS/TG
│ │ │ │ -00013b40: 5320 4675 6e63 7469 6f6e 732e 2020 2028  S Functions.   (
│ │ │ │ -00013b50: 6c69 6e65 2020 3339 3329 0a2a 2073 6869  line  393).* shi
│ │ │ │ -00013b60: 7368 695f 6b64 6372 6571 5f70 6f73 7464  shi_kdcreq_postd
│ │ │ │ -00013b70: 6174 6564 5f70 3a20 2020 2020 2020 2020  ated_p:         
│ │ │ │ -00013b80: 2020 2020 4153 2f54 4753 2046 756e 6374      AS/TGS Funct
│ │ │ │ -00013b90: 696f 6e73 2e20 2020 286c 696e 6520 2037  ions.   (line  7
│ │ │ │ -00013ba0: 3433 290a 2a20 7368 6973 6869 5f6b 6463  43).* shishi_kdc
│ │ │ │ -00013bb0: 7265 715f 7072 696e 743a 2020 2020 2020  req_print:      
│ │ │ │ -00013bc0: 2020 2020 2020 2020 2020 2020 2041 532f               AS/
│ │ │ │ -00013bd0: 5447 5320 4675 6e63 7469 6f6e 732e 2020  TGS Functions.  
│ │ │ │ -00013be0: 2028 6c69 6e65 2020 3335 3129 0a2a 2073   (line  351).* s
│ │ │ │ -00013bf0: 6869 7368 695f 6b64 6372 6571 5f70 726f  hishi_kdcreq_pro
│ │ │ │ -00013c00: 7869 6162 6c65 5f70 3a20 2020 2020 2020  xiable_p:       
│ │ │ │ -00013c10: 2020 2020 2020 4153 2f54 4753 2046 756e        AS/TGS Fun
│ │ │ │ -00013c20: 6374 696f 6e73 2e20 2020 286c 696e 6520  ctions.   (line 
│ │ │ │ -00013c30: 2036 3930 290a 2a20 7368 6973 6869 5f6b   690).* shishi_k
│ │ │ │ -00013c40: 6463 7265 715f 7072 6f78 795f 703a 2020  dcreq_proxy_p:  
│ │ │ │ -00013c50: 2020 2020 2020 2020 2020 2020 2020 2041                 A
│ │ │ │ -00013c60: 532f 5447 5320 4675 6e63 7469 6f6e 732e  S/TGS Functions.
│ │ │ │ -00013c70: 2020 2028 6c69 6e65 2020 3730 3729 0a2a     (line  707).*
│ │ │ │ -00013c80: 2073 6869 7368 695f 6b64 6372 6571 5f72   shishi_kdcreq_r
│ │ │ │ -00013c90: 6561 643a 2020 2020 2020 2020 2020 2020  ead:            
│ │ │ │ -00013ca0: 2020 2020 2020 2020 4153 2f54 4753 2046          AS/TGS F
│ │ │ │ -00013cb0: 756e 6374 696f 6e73 2e20 2020 286c 696e  unctions.   (lin
│ │ │ │ -00013cc0: 6520 2034 3037 290a 2a20 7368 6973 6869  e  407).* shishi
│ │ │ │ -00013cd0: 5f6b 6463 7265 715f 7265 616c 6d3a 2020  _kdcreq_realm:  
│ │ │ │ +00013a60: 2041 532f 5447 5320 4675 6e63 7469 6f6e   AS/TGS Function
│ │ │ │ +00013a70: 732e 2020 2028 6c69 6e65 2020 3634 3029  s.   (line  640)
│ │ │ │ +00013a80: 0a2a 2073 6869 7368 695f 6b64 6372 6571  .* shishi_kdcreq
│ │ │ │ +00013a90: 5f6f 7074 696f 6e73 5f61 6464 3a20 2020  _options_add:   
│ │ │ │ +00013aa0: 2020 2020 2020 2020 2020 4153 2f54 4753            AS/TGS
│ │ │ │ +00013ab0: 2046 756e 6374 696f 6e73 2e20 2020 286c   Functions.   (l
│ │ │ │ +00013ac0: 696e 6520 2039 3032 290a 2a20 7368 6973  ine  902).* shis
│ │ │ │ +00013ad0: 6869 5f6b 6463 7265 715f 6f70 7469 6f6e  hi_kdcreq_option
│ │ │ │ +00013ae0: 735f 7365 743a 2020 2020 2020 2020 2020  s_set:          
│ │ │ │ +00013af0: 2020 2041 532f 5447 5320 4675 6e63 7469     AS/TGS Functi
│ │ │ │ +00013b00: 6f6e 732e 2020 2028 6c69 6e65 2020 3838  ons.   (line  88
│ │ │ │ +00013b10: 3829 0a2a 2073 6869 7368 695f 6b64 6372  8).* shishi_kdcr
│ │ │ │ +00013b20: 6571 5f70 6172 7365 3a20 2020 2020 2020  eq_parse:       
│ │ │ │ +00013b30: 2020 2020 2020 2020 2020 2020 4153 2f54              AS/T
│ │ │ │ +00013b40: 4753 2046 756e 6374 696f 6e73 2e20 2020  GS Functions.   
│ │ │ │ +00013b50: 286c 696e 6520 2033 3933 290a 2a20 7368  (line  393).* sh
│ │ │ │ +00013b60: 6973 6869 5f6b 6463 7265 715f 706f 7374  ishi_kdcreq_post
│ │ │ │ +00013b70: 6461 7465 645f 703a 2020 2020 2020 2020  dated_p:        
│ │ │ │ +00013b80: 2020 2020 2041 532f 5447 5320 4675 6e63       AS/TGS Func
│ │ │ │ +00013b90: 7469 6f6e 732e 2020 2028 6c69 6e65 2020  tions.   (line  
│ │ │ │ +00013ba0: 3734 3329 0a2a 2073 6869 7368 695f 6b64  743).* shishi_kd
│ │ │ │ +00013bb0: 6372 6571 5f70 7269 6e74 3a20 2020 2020  creq_print:     
│ │ │ │ +00013bc0: 2020 2020 2020 2020 2020 2020 2020 4153                AS
│ │ │ │ +00013bd0: 2f54 4753 2046 756e 6374 696f 6e73 2e20  /TGS Functions. 
│ │ │ │ +00013be0: 2020 286c 696e 6520 2033 3531 290a 2a20    (line  351).* 
│ │ │ │ +00013bf0: 7368 6973 6869 5f6b 6463 7265 715f 7072  shishi_kdcreq_pr
│ │ │ │ +00013c00: 6f78 6961 626c 655f 703a 2020 2020 2020  oxiable_p:      
│ │ │ │ +00013c10: 2020 2020 2020 2041 532f 5447 5320 4675         AS/TGS Fu
│ │ │ │ +00013c20: 6e63 7469 6f6e 732e 2020 2028 6c69 6e65  nctions.   (line
│ │ │ │ +00013c30: 2020 3639 3029 0a2a 2073 6869 7368 695f    690).* shishi_
│ │ │ │ +00013c40: 6b64 6372 6571 5f70 726f 7879 5f70 3a20  kdcreq_proxy_p: 
│ │ │ │ +00013c50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +00013c60: 4153 2f54 4753 2046 756e 6374 696f 6e73  AS/TGS Functions
│ │ │ │ +00013c70: 2e20 2020 286c 696e 6520 2037 3037 290a  .   (line  707).
│ │ │ │ +00013c80: 2a20 7368 6973 6869 5f6b 6463 7265 715f  * shishi_kdcreq_
│ │ │ │ +00013c90: 7265 6164 3a20 2020 2020 2020 2020 2020  read:           
│ │ │ │ +00013ca0: 2020 2020 2020 2020 2041 532f 5447 5320           AS/TGS 
│ │ │ │ +00013cb0: 4675 6e63 7469 6f6e 732e 2020 2028 6c69  Functions.   (li
│ │ │ │ +00013cc0: 6e65 2020 3430 3729 0a2a 2073 6869 7368  ne  407).* shish
│ │ │ │ +00013cd0: 695f 6b64 6372 6571 5f72 6561 6c6d 3a20  i_kdcreq_realm: 
│ │ │ │  00013ce0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00013cf0: 2041 532f 5447 5320 4675 6e63 7469 6f6e   AS/TGS Function
│ │ │ │ -00013d00: 732e 2020 2028 6c69 6e65 2020 3530 3729  s.   (line  507)
│ │ │ │ -00013d10: 0a2a 2073 6869 7368 695f 6b64 6372 6571  .* shishi_kdcreq
│ │ │ │ -00013d20: 5f72 656e 6577 5f70 3a20 2020 2020 2020  _renew_p:       
│ │ │ │ -00013d30: 2020 2020 2020 2020 2020 4153 2f54 4753            AS/TGS
│ │ │ │ -00013d40: 2046 756e 6374 696f 6e73 2e20 2020 286c   Functions.   (l
│ │ │ │ -00013d50: 696e 6520 2038 3437 290a 2a20 7368 6973  ine  847).* shis
│ │ │ │ -00013d60: 6869 5f6b 6463 7265 715f 7265 6e65 7761  hi_kdcreq_renewa
│ │ │ │ -00013d70: 626c 655f 6f6b 5f70 3a20 2020 2020 2020  ble_ok_p:       
│ │ │ │ -00013d80: 2020 2041 532f 5447 5320 4675 6e63 7469     AS/TGS Functi
│ │ │ │ -00013d90: 6f6e 732e 2020 2028 6c69 6e65 2020 3830  ons.   (line  80
│ │ │ │ -00013da0: 3829 0a2a 2073 6869 7368 695f 6b64 6372  8).* shishi_kdcr
│ │ │ │ -00013db0: 6571 5f72 656e 6577 6162 6c65 5f70 3a20  eq_renewable_p: 
│ │ │ │ -00013dc0: 2020 2020 2020 2020 2020 2020 4153 2f54              AS/T
│ │ │ │ -00013dd0: 4753 2046 756e 6374 696f 6e73 2e20 2020  GS Functions.   
│ │ │ │ -00013de0: 286c 696e 6520 2037 3632 290a 2a20 7368  (line  762).* sh
│ │ │ │ -00013df0: 6973 6869 5f6b 6463 7265 715f 7361 7665  ishi_kdcreq_save
│ │ │ │ -00013e00: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ -00013e10: 2020 2020 2041 532f 5447 5320 4675 6e63       AS/TGS Func
│ │ │ │ -00013e20: 7469 6f6e 732e 2020 2028 6c69 6e65 2020  tions.   (line  
│ │ │ │ -00013e30: 3336 3429 0a2a 2073 6869 7368 695f 6b64  364).* shishi_kd
│ │ │ │ -00013e40: 6372 6571 5f73 656e 6472 6563 763a 2020  creq_sendrecv:  
│ │ │ │ -00013e50: 2020 2020 2020 2020 2020 2020 2020 4153                AS
│ │ │ │ -00013e60: 2f54 4753 2046 756e 6374 696f 6e73 2e20  /TGS Functions. 
│ │ │ │ -00013e70: 2020 286c 696e 6520 2031 3337 290a 2a20    (line  137).* 
│ │ │ │ -00013e80: 7368 6973 6869 5f6b 6463 7265 715f 7365  shishi_kdcreq_se
│ │ │ │ -00013e90: 6e64 7265 6376 5f68 696e 743a 2020 2020  ndrecv_hint:    
│ │ │ │ -00013ea0: 2020 2020 2020 2041 532f 5447 5320 4675         AS/TGS Fu
│ │ │ │ -00013eb0: 6e63 7469 6f6e 732e 2020 2028 6c69 6e65  nctions.   (line
│ │ │ │ -00013ec0: 2020 3131 3629 0a2a 2073 6869 7368 695f    116).* shishi_
│ │ │ │ -00013ed0: 6b64 6372 6571 5f73 6572 7665 723a 2020  kdcreq_server:  
│ │ │ │ +00013cf0: 2020 4153 2f54 4753 2046 756e 6374 696f    AS/TGS Functio
│ │ │ │ +00013d00: 6e73 2e20 2020 286c 696e 6520 2035 3037  ns.   (line  507
│ │ │ │ +00013d10: 290a 2a20 7368 6973 6869 5f6b 6463 7265  ).* shishi_kdcre
│ │ │ │ +00013d20: 715f 7265 6e65 775f 703a 2020 2020 2020  q_renew_p:      
│ │ │ │ +00013d30: 2020 2020 2020 2020 2020 2041 532f 5447             AS/TG
│ │ │ │ +00013d40: 5320 4675 6e63 7469 6f6e 732e 2020 2028  S Functions.   (
│ │ │ │ +00013d50: 6c69 6e65 2020 3834 3729 0a2a 2073 6869  line  847).* shi
│ │ │ │ +00013d60: 7368 695f 6b64 6372 6571 5f72 656e 6577  shi_kdcreq_renew
│ │ │ │ +00013d70: 6162 6c65 5f6f 6b5f 703a 2020 2020 2020  able_ok_p:      
│ │ │ │ +00013d80: 2020 2020 4153 2f54 4753 2046 756e 6374      AS/TGS Funct
│ │ │ │ +00013d90: 696f 6e73 2e20 2020 286c 696e 6520 2038  ions.   (line  8
│ │ │ │ +00013da0: 3038 290a 2a20 7368 6973 6869 5f6b 6463  08).* shishi_kdc
│ │ │ │ +00013db0: 7265 715f 7265 6e65 7761 626c 655f 703a  req_renewable_p:
│ │ │ │ +00013dc0: 2020 2020 2020 2020 2020 2020 2041 532f               AS/
│ │ │ │ +00013dd0: 5447 5320 4675 6e63 7469 6f6e 732e 2020  TGS Functions.  
│ │ │ │ +00013de0: 2028 6c69 6e65 2020 3736 3229 0a2a 2073   (line  762).* s
│ │ │ │ +00013df0: 6869 7368 695f 6b64 6372 6571 5f73 6176  hishi_kdcreq_sav
│ │ │ │ +00013e00: 653a 2020 2020 2020 2020 2020 2020 2020  e:              
│ │ │ │ +00013e10: 2020 2020 2020 4153 2f54 4753 2046 756e        AS/TGS Fun
│ │ │ │ +00013e20: 6374 696f 6e73 2e20 2020 286c 696e 6520  ctions.   (line 
│ │ │ │ +00013e30: 2033 3634 290a 2a20 7368 6973 6869 5f6b   364).* shishi_k
│ │ │ │ +00013e40: 6463 7265 715f 7365 6e64 7265 6376 3a20  dcreq_sendrecv: 
│ │ │ │ +00013e50: 2020 2020 2020 2020 2020 2020 2020 2041                 A
│ │ │ │ +00013e60: 532f 5447 5320 4675 6e63 7469 6f6e 732e  S/TGS Functions.
│ │ │ │ +00013e70: 2020 2028 6c69 6e65 2020 3133 3729 0a2a     (line  137).*
│ │ │ │ +00013e80: 2073 6869 7368 695f 6b64 6372 6571 5f73   shishi_kdcreq_s
│ │ │ │ +00013e90: 656e 6472 6563 765f 6869 6e74 3a20 2020  endrecv_hint:   
│ │ │ │ +00013ea0: 2020 2020 2020 2020 4153 2f54 4753 2046          AS/TGS F
│ │ │ │ +00013eb0: 756e 6374 696f 6e73 2e20 2020 286c 696e  unctions.   (lin
│ │ │ │ +00013ec0: 6520 2031 3136 290a 2a20 7368 6973 6869  e  116).* shishi
│ │ │ │ +00013ed0: 5f6b 6463 7265 715f 7365 7276 6572 3a20  _kdcreq_server: 
│ │ │ │  00013ee0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00013ef0: 4153 2f54 4753 2046 756e 6374 696f 6e73  AS/TGS Functions
│ │ │ │ -00013f00: 2e20 2020 286c 696e 6520 2035 3339 290a  .   (line  539).
│ │ │ │ -00013f10: 2a20 7368 6973 6869 5f6b 6463 7265 715f  * shishi_kdcreq_
│ │ │ │ -00013f20: 7365 745f 636e 616d 653a 2020 2020 2020  set_cname:      
│ │ │ │ -00013f30: 2020 2020 2020 2020 2041 532f 5447 5320           AS/TGS 
│ │ │ │ -00013f40: 4675 6e63 7469 6f6e 732e 2020 2028 6c69  Functions.   (li
│ │ │ │ -00013f50: 6e65 2020 3434 3929 0a2a 2073 6869 7368  ne  449).* shish
│ │ │ │ -00013f60: 695f 6b64 6372 6571 5f73 6574 5f65 7479  i_kdcreq_set_ety
│ │ │ │ -00013f70: 7065 3a20 2020 2020 2020 2020 2020 2020  pe:             
│ │ │ │ -00013f80: 2020 4153 2f54 4753 2046 756e 6374 696f    AS/TGS Functio
│ │ │ │ -00013f90: 6e73 2e20 2020 286c 696e 6520 2036 3235  ns.   (line  625
│ │ │ │ -00013fa0: 290a 2a20 7368 6973 6869 5f6b 6463 7265  ).* shishi_kdcre
│ │ │ │ -00013fb0: 715f 7365 745f 7265 616c 6d3a 2020 2020  q_set_realm:    
│ │ │ │ -00013fc0: 2020 2020 2020 2020 2020 2041 532f 5447             AS/TG
│ │ │ │ -00013fd0: 5320 4675 6e63 7469 6f6e 732e 2020 2028  S Functions.   (
│ │ │ │ -00013fe0: 6c69 6e65 2020 3532 3629 0a2a 2073 6869  line  526).* shi
│ │ │ │ -00013ff0: 7368 695f 6b64 6372 6571 5f73 6574 5f73  shi_kdcreq_set_s
│ │ │ │ -00014000: 6e61 6d65 3a20 2020 2020 2020 2020 2020  name:           
│ │ │ │ -00014010: 2020 2020 4153 2f54 4753 2046 756e 6374      AS/TGS Funct
│ │ │ │ -00014020: 696f 6e73 2e20 2020 286c 696e 6520 2035  ions.   (line  5
│ │ │ │ -00014030: 3630 290a 2a20 7368 6973 6869 5f6b 6463  60).* shishi_kdc
│ │ │ │ -00014040: 7265 715f 7469 6c6c 3a20 2020 2020 2020  req_till:       
│ │ │ │ -00014050: 2020 2020 2020 2020 2020 2020 2041 532f               AS/
│ │ │ │ -00014060: 5447 5320 4675 6e63 7469 6f6e 732e 2020  TGS Functions.  
│ │ │ │ -00014070: 2028 6c69 6e65 2020 3537 3629 0a2a 2073   (line  576).* s
│ │ │ │ -00014080: 6869 7368 695f 6b64 6372 6571 5f74 696c  hishi_kdcreq_til
│ │ │ │ -00014090: 6c63 3a20 2020 2020 2020 2020 2020 2020  lc:             
│ │ │ │ -000140a0: 2020 2020 2020 4153 2f54 4753 2046 756e        AS/TGS Fun
│ │ │ │ -000140b0: 6374 696f 6e73 2e20 2020 286c 696e 6520  ctions.   (line 
│ │ │ │ -000140c0: 2035 3937 290a 2a20 7368 6973 6869 5f6b   597).* shishi_k
│ │ │ │ -000140d0: 6463 7265 715f 746f 5f66 696c 653a 2020  dcreq_to_file:  
│ │ │ │ -000140e0: 2020 2020 2020 2020 2020 2020 2020 2041                 A
│ │ │ │ -000140f0: 532f 5447 5320 4675 6e63 7469 6f6e 732e  S/TGS Functions.
│ │ │ │ -00014100: 2020 2028 6c69 6e65 2020 3337 3729 0a2a     (line  377).*
│ │ │ │ -00014110: 2073 6869 7368 695f 6b64 6372 6571 5f76   shishi_kdcreq_v
│ │ │ │ -00014120: 616c 6964 6174 655f 703a 2020 2020 2020  alidate_p:      
│ │ │ │ -00014130: 2020 2020 2020 2020 4153 2f54 4753 2046          AS/TGS F
│ │ │ │ -00014140: 756e 6374 696f 6e73 2e20 2020 286c 696e  unctions.   (lin
│ │ │ │ -00014150: 6520 2038 3637 290a 2a20 7368 6973 6869  e  867).* shishi
│ │ │ │ -00014160: 5f6b 6579 3a20 2020 2020 2020 2020 2020  _key:           
│ │ │ │ +00013ef0: 2041 532f 5447 5320 4675 6e63 7469 6f6e   AS/TGS Function
│ │ │ │ +00013f00: 732e 2020 2028 6c69 6e65 2020 3533 3929  s.   (line  539)
│ │ │ │ +00013f10: 0a2a 2073 6869 7368 695f 6b64 6372 6571  .* shishi_kdcreq
│ │ │ │ +00013f20: 5f73 6574 5f63 6e61 6d65 3a20 2020 2020  _set_cname:     
│ │ │ │ +00013f30: 2020 2020 2020 2020 2020 4153 2f54 4753            AS/TGS
│ │ │ │ +00013f40: 2046 756e 6374 696f 6e73 2e20 2020 286c   Functions.   (l
│ │ │ │ +00013f50: 696e 6520 2034 3439 290a 2a20 7368 6973  ine  449).* shis
│ │ │ │ +00013f60: 6869 5f6b 6463 7265 715f 7365 745f 6574  hi_kdcreq_set_et
│ │ │ │ +00013f70: 7970 653a 2020 2020 2020 2020 2020 2020  ype:            
│ │ │ │ +00013f80: 2020 2041 532f 5447 5320 4675 6e63 7469     AS/TGS Functi
│ │ │ │ +00013f90: 6f6e 732e 2020 2028 6c69 6e65 2020 3632  ons.   (line  62
│ │ │ │ +00013fa0: 3529 0a2a 2073 6869 7368 695f 6b64 6372  5).* shishi_kdcr
│ │ │ │ +00013fb0: 6571 5f73 6574 5f72 6561 6c6d 3a20 2020  eq_set_realm:   
│ │ │ │ +00013fc0: 2020 2020 2020 2020 2020 2020 4153 2f54              AS/T
│ │ │ │ +00013fd0: 4753 2046 756e 6374 696f 6e73 2e20 2020  GS Functions.   
│ │ │ │ +00013fe0: 286c 696e 6520 2035 3236 290a 2a20 7368  (line  526).* sh
│ │ │ │ +00013ff0: 6973 6869 5f6b 6463 7265 715f 7365 745f  ishi_kdcreq_set_
│ │ │ │ +00014000: 736e 616d 653a 2020 2020 2020 2020 2020  sname:          
│ │ │ │ +00014010: 2020 2020 2041 532f 5447 5320 4675 6e63       AS/TGS Func
│ │ │ │ +00014020: 7469 6f6e 732e 2020 2028 6c69 6e65 2020  tions.   (line  
│ │ │ │ +00014030: 3536 3029 0a2a 2073 6869 7368 695f 6b64  560).* shishi_kd
│ │ │ │ +00014040: 6372 6571 5f74 696c 6c3a 2020 2020 2020  creq_till:      
│ │ │ │ +00014050: 2020 2020 2020 2020 2020 2020 2020 4153                AS
│ │ │ │ +00014060: 2f54 4753 2046 756e 6374 696f 6e73 2e20  /TGS Functions. 
│ │ │ │ +00014070: 2020 286c 696e 6520 2035 3736 290a 2a20    (line  576).* 
│ │ │ │ +00014080: 7368 6973 6869 5f6b 6463 7265 715f 7469  shishi_kdcreq_ti
│ │ │ │ +00014090: 6c6c 633a 2020 2020 2020 2020 2020 2020  llc:            
│ │ │ │ +000140a0: 2020 2020 2020 2041 532f 5447 5320 4675         AS/TGS Fu
│ │ │ │ +000140b0: 6e63 7469 6f6e 732e 2020 2028 6c69 6e65  nctions.   (line
│ │ │ │ +000140c0: 2020 3539 3729 0a2a 2073 6869 7368 695f    597).* shishi_
│ │ │ │ +000140d0: 6b64 6372 6571 5f74 6f5f 6669 6c65 3a20  kdcreq_to_file: 
│ │ │ │ +000140e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +000140f0: 4153 2f54 4753 2046 756e 6374 696f 6e73  AS/TGS Functions
│ │ │ │ +00014100: 2e20 2020 286c 696e 6520 2033 3737 290a  .   (line  377).
│ │ │ │ +00014110: 2a20 7368 6973 6869 5f6b 6463 7265 715f  * shishi_kdcreq_
│ │ │ │ +00014120: 7661 6c69 6461 7465 5f70 3a20 2020 2020  validate_p:     
│ │ │ │ +00014130: 2020 2020 2020 2020 2041 532f 5447 5320           AS/TGS 
│ │ │ │ +00014140: 4675 6e63 7469 6f6e 732e 2020 2028 6c69  Functions.   (li
│ │ │ │ +00014150: 6e65 2020 3836 3729 0a2a 2073 6869 7368  ne  867).* shish
│ │ │ │ +00014160: 695f 6b65 793a 2020 2020 2020 2020 2020  i_key:          
│ │ │ │  00014170: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00014180: 2043 7279 7074 6f67 7261 7068 6963 2046   Cryptographic F
│ │ │ │ -00014190: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │ +00014180: 2020 4372 7970 746f 6772 6170 6869 6320    Cryptographic 
│ │ │ │ +00014190: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │  000141a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000141b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000141c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000141d0: 2020 2020 2020 2028 6c69 6e65 2020 3138         (line  18
│ │ │ │ -000141e0: 3829 0a2a 2073 6869 7368 695f 6b65 795f  8).* shishi_key_
│ │ │ │ -000141f0: 636f 7079 3a20 2020 2020 2020 2020 2020  copy:           
│ │ │ │ -00014200: 2020 2020 2020 2020 2020 2020 4372 7970              Cryp
│ │ │ │ -00014210: 746f 6772 6170 6869 6320 4675 6e63 7469  tographic Functi
│ │ │ │ -00014220: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │ +000141d0: 2020 2020 2020 2020 286c 696e 6520 2031          (line  1
│ │ │ │ +000141e0: 3838 290a 2a20 7368 6973 6869 5f6b 6579  88).* shishi_key
│ │ │ │ +000141f0: 5f63 6f70 793a 2020 2020 2020 2020 2020  _copy:          
│ │ │ │ +00014200: 2020 2020 2020 2020 2020 2020 2043 7279               Cry
│ │ │ │ +00014210: 7074 6f67 7261 7068 6963 2046 756e 6374  ptographic Funct
│ │ │ │ +00014220: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │  00014230: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00014240: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00014250: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00014260: 2020 286c 696e 6520 2032 3038 290a 2a20    (line  208).* 
│ │ │ │ -00014270: 7368 6973 6869 5f6b 6579 5f64 6f6e 653a  shishi_key_done:
│ │ │ │ -00014280: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00014290: 2020 2020 2020 2043 7279 7074 6f67 7261         Cryptogra
│ │ │ │ -000142a0: 7068 6963 2046 756e 6374 696f 6e73 2e0a  phic Functions..
│ │ │ │ -000142b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +00014260: 2020 2028 6c69 6e65 2020 3230 3829 0a2a     (line  208).*
│ │ │ │ +00014270: 2073 6869 7368 695f 6b65 795f 646f 6e65   shishi_key_done
│ │ │ │ +00014280: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ +00014290: 2020 2020 2020 2020 4372 7970 746f 6772          Cryptogr
│ │ │ │ +000142a0: 6170 6869 6320 4675 6e63 7469 6f6e 732e  aphic Functions.
│ │ │ │ +000142b0: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │  000142c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000142d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000142e0: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ -000142f0: 6e65 2020 3230 3029 0a2a 2073 6869 7368  ne  200).* shish
│ │ │ │ -00014300: 695f 6b65 795f 6672 6f6d 5f62 6173 6536  i_key_from_base6
│ │ │ │ -00014310: 343a 2020 2020 2020 2020 2020 2020 2020  4:              
│ │ │ │ -00014320: 2020 4372 7970 746f 6772 6170 6869 6320    Cryptographic 
│ │ │ │ -00014330: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │ +000142e0: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ +000142f0: 696e 6520 2032 3030 290a 2a20 7368 6973  ine  200).* shis
│ │ │ │ +00014300: 6869 5f6b 6579 5f66 726f 6d5f 6261 7365  hi_key_from_base
│ │ │ │ +00014310: 3634 3a20 2020 2020 2020 2020 2020 2020  64:             
│ │ │ │ +00014320: 2020 2043 7279 7074 6f67 7261 7068 6963     Cryptographic
│ │ │ │ +00014330: 2046 756e 6374 696f 6e73 2e0a 2020 2020   Functions..    
│ │ │ │  00014340: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00014350: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00014360: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00014370: 2020 2020 2020 2020 286c 696e 6520 2032          (line  2
│ │ │ │ -00014380: 3336 290a 2a20 7368 6973 6869 5f6b 6579  36).* shishi_key
│ │ │ │ -00014390: 5f66 726f 6d5f 6e61 6d65 3a20 2020 2020  _from_name:     
│ │ │ │ -000143a0: 2020 2020 2020 2020 2020 2020 2043 7279               Cry
│ │ │ │ -000143b0: 7074 6f67 7261 7068 6963 2046 756e 6374  ptographic Funct
│ │ │ │ -000143c0: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │ +00014370: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ +00014380: 3233 3629 0a2a 2073 6869 7368 695f 6b65  236).* shishi_ke
│ │ │ │ +00014390: 795f 6672 6f6d 5f6e 616d 653a 2020 2020  y_from_name:    
│ │ │ │ +000143a0: 2020 2020 2020 2020 2020 2020 2020 4372                Cr
│ │ │ │ +000143b0: 7970 746f 6772 6170 6869 6320 4675 6e63  yptographic Func
│ │ │ │ +000143c0: 7469 6f6e 732e 0a20 2020 2020 2020 2020  tions..         
│ │ │ │  000143d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000143e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000143f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00014400: 2020 2028 6c69 6e65 2020 3331 3329 0a2a     (line  313).*
│ │ │ │ -00014410: 2073 6869 7368 695f 6b65 795f 6672 6f6d   shishi_key_from
│ │ │ │ -00014420: 5f72 616e 646f 6d3a 2020 2020 2020 2020  _random:        
│ │ │ │ -00014430: 2020 2020 2020 2020 4372 7970 746f 6772          Cryptogr
│ │ │ │ -00014440: 6170 6869 6320 4675 6e63 7469 6f6e 732e  aphic Functions.
│ │ │ │ -00014450: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ +00014400: 2020 2020 286c 696e 6520 2033 3133 290a      (line  313).
│ │ │ │ +00014410: 2a20 7368 6973 6869 5f6b 6579 5f66 726f  * shishi_key_fro
│ │ │ │ +00014420: 6d5f 7261 6e64 6f6d 3a20 2020 2020 2020  m_random:       
│ │ │ │ +00014430: 2020 2020 2020 2020 2043 7279 7074 6f67           Cryptog
│ │ │ │ +00014440: 7261 7068 6963 2046 756e 6374 696f 6e73  raphic Functions
│ │ │ │ +00014450: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │  00014460: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00014470: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00014480: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ -00014490: 696e 6520 2032 3730 290a 2a20 7368 6973  ine  270).* shis
│ │ │ │ -000144a0: 6869 5f6b 6579 5f66 726f 6d5f 7374 7269  hi_key_from_stri
│ │ │ │ -000144b0: 6e67 3a20 2020 2020 2020 2020 2020 2020  ng:             
│ │ │ │ -000144c0: 2020 2043 7279 7074 6f67 7261 7068 6963     Cryptographic
│ │ │ │ -000144d0: 2046 756e 6374 696f 6e73 2e0a 2020 2020   Functions..    
│ │ │ │ +00014480: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ +00014490: 6c69 6e65 2020 3237 3029 0a2a 2073 6869  line  270).* shi
│ │ │ │ +000144a0: 7368 695f 6b65 795f 6672 6f6d 5f73 7472  shi_key_from_str
│ │ │ │ +000144b0: 696e 673a 2020 2020 2020 2020 2020 2020  ing:            
│ │ │ │ +000144c0: 2020 2020 4372 7970 746f 6772 6170 6869      Cryptographi
│ │ │ │ +000144d0: 6320 4675 6e63 7469 6f6e 732e 0a20 2020  c Functions..   
│ │ │ │  000144e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000144f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00014500: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00014510: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ -00014520: 3238 3929 0a2a 2073 6869 7368 695f 6b65  289).* shishi_ke
│ │ │ │ -00014530: 795f 6672 6f6d 5f76 616c 7565 3a20 2020  y_from_value:   
│ │ │ │ -00014540: 2020 2020 2020 2020 2020 2020 2020 4372                Cr
│ │ │ │ -00014550: 7970 746f 6772 6170 6869 6320 4675 6e63  yptographic Func
│ │ │ │ -00014560: 7469 6f6e 732e 0a20 2020 2020 2020 2020  tions..         
│ │ │ │ +00014510: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ +00014520: 2032 3839 290a 2a20 7368 6973 6869 5f6b   289).* shishi_k
│ │ │ │ +00014530: 6579 5f66 726f 6d5f 7661 6c75 653a 2020  ey_from_value:  
│ │ │ │ +00014540: 2020 2020 2020 2020 2020 2020 2020 2043                 C
│ │ │ │ +00014550: 7279 7074 6f67 7261 7068 6963 2046 756e  ryptographic Fun
│ │ │ │ +00014560: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │  00014570: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00014580: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00014590: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000145a0: 2020 2020 286c 696e 6520 2032 3139 290a      (line  219).
│ │ │ │ -000145b0: 2a20 7368 6973 6869 5f6b 6579 5f6c 656e  * shishi_key_len
│ │ │ │ -000145c0: 6774 683a 2020 2020 2020 2020 2020 2020  gth:            
│ │ │ │ -000145d0: 2020 2020 2020 2020 2043 7279 7074 6f67           Cryptog
│ │ │ │ -000145e0: 7261 7068 6963 2046 756e 6374 696f 6e73  raphic Functions
│ │ │ │ -000145f0: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │ +000145a0: 2020 2020 2028 6c69 6e65 2020 3231 3929       (line  219)
│ │ │ │ +000145b0: 0a2a 2073 6869 7368 695f 6b65 795f 6c65  .* shishi_key_le
│ │ │ │ +000145c0: 6e67 7468 3a20 2020 2020 2020 2020 2020  ngth:           
│ │ │ │ +000145d0: 2020 2020 2020 2020 2020 4372 7970 746f            Crypto
│ │ │ │ +000145e0: 6772 6170 6869 6320 4675 6e63 7469 6f6e  graphic Function
│ │ │ │ +000145f0: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │  00014600: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00014610: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00014620: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ -00014630: 6c69 6e65 2020 3137 3829 0a2a 2073 6869  line  178).* shi
│ │ │ │ -00014640: 7368 695f 6b65 795f 6e61 6d65 3a20 2020  shi_key_name:   
│ │ │ │ +00014620: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +00014630: 286c 696e 6520 2031 3738 290a 2a20 7368  (line  178).* sh
│ │ │ │ +00014640: 6973 6869 5f6b 6579 5f6e 616d 653a 2020  ishi_key_name:  
│ │ │ │  00014650: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00014660: 2020 2020 4372 7970 746f 6772 6170 6869      Cryptographi
│ │ │ │ -00014670: 6320 4675 6e63 7469 6f6e 732e 0a20 2020  c Functions..   
│ │ │ │ +00014660: 2020 2020 2043 7279 7074 6f67 7261 7068       Cryptograph
│ │ │ │ +00014670: 6963 2046 756e 6374 696f 6e73 2e0a 2020  ic Functions..  
│ │ │ │  00014680: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00014690: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000146a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000146b0: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ -000146c0: 2031 3638 290a 2a20 7368 6973 6869 5f6b   168).* shishi_k
│ │ │ │ -000146d0: 6579 5f70 7269 6e63 6970 616c 3a20 2020  ey_principal:   
│ │ │ │ -000146e0: 2020 2020 2020 2020 2020 2020 2020 2043                 C
│ │ │ │ -000146f0: 7279 7074 6f67 7261 7068 6963 2046 756e  ryptographic Fun
│ │ │ │ -00014700: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │ +000146b0: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ +000146c0: 2020 3136 3829 0a2a 2073 6869 7368 695f    168).* shishi_
│ │ │ │ +000146d0: 6b65 795f 7072 696e 6369 7061 6c3a 2020  key_principal:  
│ │ │ │ +000146e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +000146f0: 4372 7970 746f 6772 6170 6869 6320 4675  Cryptographic Fu
│ │ │ │ +00014700: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │  00014710: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00014720: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00014730: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00014740: 2020 2020 2028 6c69 6e65 2020 2032 3829       (line   28)
│ │ │ │ -00014750: 0a2a 2073 6869 7368 695f 6b65 795f 7072  .* shishi_key_pr
│ │ │ │ -00014760: 696e 6369 7061 6c5f 7365 743a 2020 2020  incipal_set:    
│ │ │ │ -00014770: 2020 2020 2020 2020 2020 4372 7970 746f            Crypto
│ │ │ │ -00014780: 6772 6170 6869 6320 4675 6e63 7469 6f6e  graphic Function
│ │ │ │ -00014790: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │ +00014740: 2020 2020 2020 286c 696e 6520 2020 3238        (line   28
│ │ │ │ +00014750: 290a 2a20 7368 6973 6869 5f6b 6579 5f70  ).* shishi_key_p
│ │ │ │ +00014760: 7269 6e63 6970 616c 5f73 6574 3a20 2020  rincipal_set:   
│ │ │ │ +00014770: 2020 2020 2020 2020 2020 2043 7279 7074             Crypt
│ │ │ │ +00014780: 6f67 7261 7068 6963 2046 756e 6374 696f  ographic Functio
│ │ │ │ +00014790: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │  000147a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000147b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000147c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000147d0: 286c 696e 6520 2020 3430 290a 2a20 7368  (line   40).* sh
│ │ │ │ -000147e0: 6973 6869 5f6b 6579 5f72 616e 646f 6d3a  ishi_key_random:
│ │ │ │ -000147f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00014800: 2020 2020 2043 7279 7074 6f67 7261 7068       Cryptograph
│ │ │ │ -00014810: 6963 2046 756e 6374 696f 6e73 2e0a 2020  ic Functions..  
│ │ │ │ +000147d0: 2028 6c69 6e65 2020 2034 3029 0a2a 2073   (line   40).* s
│ │ │ │ +000147e0: 6869 7368 695f 6b65 795f 7261 6e64 6f6d  hishi_key_random
│ │ │ │ +000147f0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ +00014800: 2020 2020 2020 4372 7970 746f 6772 6170        Cryptograp
│ │ │ │ +00014810: 6869 6320 4675 6e63 7469 6f6e 732e 0a20  hic Functions.. 
│ │ │ │  00014820: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00014830: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00014840: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00014850: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ -00014860: 2020 3235 3429 0a2a 2073 6869 7368 695f    254).* shishi_
│ │ │ │ -00014870: 6b65 795f 7265 616c 6d3a 2020 2020 2020  key_realm:      
│ │ │ │ +00014850: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ +00014860: 6520 2032 3534 290a 2a20 7368 6973 6869  e  254).* shishi
│ │ │ │ +00014870: 5f6b 6579 5f72 6561 6c6d 3a20 2020 2020  _key_realm:     
│ │ │ │  00014880: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00014890: 4372 7970 746f 6772 6170 6869 6320 4675  Cryptographic Fu
│ │ │ │ -000148a0: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │ +00014890: 2043 7279 7074 6f67 7261 7068 6963 2046   Cryptographic F
│ │ │ │ +000148a0: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │  000148b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000148c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000148d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000148e0: 2020 2020 2020 286c 696e 6520 2020 3532        (line   52
│ │ │ │ -000148f0: 290a 2a20 7368 6973 6869 5f6b 6579 5f72  ).* shishi_key_r
│ │ │ │ -00014900: 6561 6c6d 5f73 6574 3a20 2020 2020 2020  ealm_set:       
│ │ │ │ -00014910: 2020 2020 2020 2020 2020 2043 7279 7074             Crypt
│ │ │ │ -00014920: 6f67 7261 7068 6963 2046 756e 6374 696f  ographic Functio
│ │ │ │ -00014930: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │ +000148e0: 2020 2020 2020 2028 6c69 6e65 2020 2035         (line   5
│ │ │ │ +000148f0: 3229 0a2a 2073 6869 7368 695f 6b65 795f  2).* shishi_key_
│ │ │ │ +00014900: 7265 616c 6d5f 7365 743a 2020 2020 2020  realm_set:      
│ │ │ │ +00014910: 2020 2020 2020 2020 2020 2020 4372 7970              Cryp
│ │ │ │ +00014920: 746f 6772 6170 6869 6320 4675 6e63 7469  tographic Functi
│ │ │ │ +00014930: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │  00014940: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00014950: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00014960: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00014970: 2028 6c69 6e65 2020 2036 3329 0a2a 2073   (line   63).* s
│ │ │ │ -00014980: 6869 7368 695f 6b65 795f 7469 6d65 7374  hishi_key_timest
│ │ │ │ -00014990: 616d 703a 2020 2020 2020 2020 2020 2020  amp:            
│ │ │ │ -000149a0: 2020 2020 2020 4372 7970 746f 6772 6170        Cryptograp
│ │ │ │ -000149b0: 6869 6320 4675 6e63 7469 6f6e 732e 0a20  hic Functions.. 
│ │ │ │ +00014970: 2020 286c 696e 6520 2020 3633 290a 2a20    (line   63).* 
│ │ │ │ +00014980: 7368 6973 6869 5f6b 6579 5f74 696d 6573  shishi_key_times
│ │ │ │ +00014990: 7461 6d70 3a20 2020 2020 2020 2020 2020  tamp:           
│ │ │ │ +000149a0: 2020 2020 2020 2043 7279 7074 6f67 7261         Cryptogra
│ │ │ │ +000149b0: 7068 6963 2046 756e 6374 696f 6e73 2e0a  phic Functions..
│ │ │ │  000149c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000149d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000149e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000149f0: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ -00014a00: 6520 2031 3431 290a 2a20 7368 6973 6869  e  141).* shishi
│ │ │ │ -00014a10: 5f6b 6579 5f74 696d 6573 7461 6d70 5f73  _key_timestamp_s
│ │ │ │ -00014a20: 6574 3a20 2020 2020 2020 2020 2020 2020  et:             
│ │ │ │ -00014a30: 2043 7279 7074 6f67 7261 7068 6963 2046   Cryptographic F
│ │ │ │ -00014a40: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │ +000149f0: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ +00014a00: 6e65 2020 3134 3129 0a2a 2073 6869 7368  ne  141).* shish
│ │ │ │ +00014a10: 695f 6b65 795f 7469 6d65 7374 616d 705f  i_key_timestamp_
│ │ │ │ +00014a20: 7365 743a 2020 2020 2020 2020 2020 2020  set:            
│ │ │ │ +00014a30: 2020 4372 7970 746f 6772 6170 6869 6320    Cryptographic 
│ │ │ │ +00014a40: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │  00014a50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00014a60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00014a70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00014a80: 2020 2020 2020 2028 6c69 6e65 2020 3135         (line  15
│ │ │ │ -00014a90: 3529 0a2a 2073 6869 7368 695f 6b65 795f  5).* shishi_key_
│ │ │ │ -00014aa0: 7479 7065 3a20 2020 2020 2020 2020 2020  type:           
│ │ │ │ -00014ab0: 2020 2020 2020 2020 2020 2020 4372 7970              Cryp
│ │ │ │ -00014ac0: 746f 6772 6170 6869 6320 4675 6e63 7469  tographic Functi
│ │ │ │ -00014ad0: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │ +00014a80: 2020 2020 2020 2020 286c 696e 6520 2031          (line  1
│ │ │ │ +00014a90: 3535 290a 2a20 7368 6973 6869 5f6b 6579  55).* shishi_key
│ │ │ │ +00014aa0: 5f74 7970 653a 2020 2020 2020 2020 2020  _type:          
│ │ │ │ +00014ab0: 2020 2020 2020 2020 2020 2020 2043 7279               Cry
│ │ │ │ +00014ac0: 7074 6f67 7261 7068 6963 2046 756e 6374  ptographic Funct
│ │ │ │ +00014ad0: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │  00014ae0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00014af0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00014b00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00014b10: 2020 286c 696e 6520 2020 3735 290a 2a20    (line   75).* 
│ │ │ │ -00014b20: 7368 6973 6869 5f6b 6579 5f74 7970 655f  shishi_key_type_
│ │ │ │ -00014b30: 7365 743a 2020 2020 2020 2020 2020 2020  set:            
│ │ │ │ -00014b40: 2020 2020 2020 2043 7279 7074 6f67 7261         Cryptogra
│ │ │ │ -00014b50: 7068 6963 2046 756e 6374 696f 6e73 2e0a  phic Functions..
│ │ │ │ -00014b60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +00014b10: 2020 2028 6c69 6e65 2020 2037 3529 0a2a     (line   75).*
│ │ │ │ +00014b20: 2073 6869 7368 695f 6b65 795f 7479 7065   shishi_key_type
│ │ │ │ +00014b30: 5f73 6574 3a20 2020 2020 2020 2020 2020  _set:           
│ │ │ │ +00014b40: 2020 2020 2020 2020 4372 7970 746f 6772          Cryptogr
│ │ │ │ +00014b50: 6170 6869 6320 4675 6e63 7469 6f6e 732e  aphic Functions.
│ │ │ │ +00014b60: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │  00014b70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00014b80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00014b90: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ -00014ba0: 6e65 2020 2038 3629 0a2a 2073 6869 7368  ne   86).* shish
│ │ │ │ -00014bb0: 695f 6b65 795f 7661 6c75 653a 2020 2020  i_key_value:    
│ │ │ │ +00014b90: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ +00014ba0: 696e 6520 2020 3836 290a 2a20 7368 6973  ine   86).* shis
│ │ │ │ +00014bb0: 6869 5f6b 6579 5f76 616c 7565 3a20 2020  hi_key_value:   
│ │ │ │  00014bc0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00014bd0: 2020 4372 7970 746f 6772 6170 6869 6320    Cryptographic 
│ │ │ │ -00014be0: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │ +00014bd0: 2020 2043 7279 7074 6f67 7261 7068 6963     Cryptographic
│ │ │ │ +00014be0: 2046 756e 6374 696f 6e73 2e0a 2020 2020   Functions..    
│ │ │ │  00014bf0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00014c00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00014c10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00014c20: 2020 2020 2020 2020 286c 696e 6520 2020          (line   
│ │ │ │ -00014c30: 3935 290a 2a20 7368 6973 6869 5f6b 6579  95).* shishi_key
│ │ │ │ -00014c40: 5f76 616c 7565 5f73 6574 3a20 2020 2020  _value_set:     
│ │ │ │ -00014c50: 2020 2020 2020 2020 2020 2020 2043 7279               Cry
│ │ │ │ -00014c60: 7074 6f67 7261 7068 6963 2046 756e 6374  ptographic Funct
│ │ │ │ -00014c70: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │ +00014c20: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ +00014c30: 2039 3529 0a2a 2073 6869 7368 695f 6b65   95).* shishi_ke
│ │ │ │ +00014c40: 795f 7661 6c75 655f 7365 743a 2020 2020  y_value_set:    
│ │ │ │ +00014c50: 2020 2020 2020 2020 2020 2020 2020 4372                Cr
│ │ │ │ +00014c60: 7970 746f 6772 6170 6869 6320 4675 6e63  yptographic Func
│ │ │ │ +00014c70: 7469 6f6e 732e 0a20 2020 2020 2020 2020  tions..         
│ │ │ │  00014c80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00014c90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00014ca0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00014cb0: 2020 2028 6c69 6e65 2020 3130 3629 0a2a     (line  106).*
│ │ │ │ -00014cc0: 2073 6869 7368 695f 6b65 795f 7665 7273   shishi_key_vers
│ │ │ │ -00014cd0: 696f 6e3a 2020 2020 2020 2020 2020 2020  ion:            
│ │ │ │ -00014ce0: 2020 2020 2020 2020 4372 7970 746f 6772          Cryptogr
│ │ │ │ -00014cf0: 6170 6869 6320 4675 6e63 7469 6f6e 732e  aphic Functions.
│ │ │ │ -00014d00: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ +00014cb0: 2020 2020 286c 696e 6520 2031 3036 290a      (line  106).
│ │ │ │ +00014cc0: 2a20 7368 6973 6869 5f6b 6579 5f76 6572  * shishi_key_ver
│ │ │ │ +00014cd0: 7369 6f6e 3a20 2020 2020 2020 2020 2020  sion:           
│ │ │ │ +00014ce0: 2020 2020 2020 2020 2043 7279 7074 6f67           Cryptog
│ │ │ │ +00014cf0: 7261 7068 6963 2046 756e 6374 696f 6e73  raphic Functions
│ │ │ │ +00014d00: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │  00014d10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00014d20: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00014d30: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ -00014d40: 696e 6520 2031 3139 290a 2a20 7368 6973  ine  119).* shis
│ │ │ │ -00014d50: 6869 5f6b 6579 5f76 6572 7369 6f6e 5f73  hi_key_version_s
│ │ │ │ -00014d60: 6574 3a20 2020 2020 2020 2020 2020 2020  et:             
│ │ │ │ -00014d70: 2020 2043 7279 7074 6f67 7261 7068 6963     Cryptographic
│ │ │ │ -00014d80: 2046 756e 6374 696f 6e73 2e0a 2020 2020   Functions..    
│ │ │ │ +00014d30: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ +00014d40: 6c69 6e65 2020 3131 3929 0a2a 2073 6869  line  119).* shi
│ │ │ │ +00014d50: 7368 695f 6b65 795f 7665 7273 696f 6e5f  shi_key_version_
│ │ │ │ +00014d60: 7365 743a 2020 2020 2020 2020 2020 2020  set:            
│ │ │ │ +00014d70: 2020 2020 4372 7970 746f 6772 6170 6869      Cryptographi
│ │ │ │ +00014d80: 6320 4675 6e63 7469 6f6e 732e 0a20 2020  c Functions..   
│ │ │ │  00014d90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00014da0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00014db0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00014dc0: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ -00014dd0: 3133 3029 0a2a 2073 6869 7368 695f 6b65  130).* shishi_ke
│ │ │ │ -00014de0: 7973 3a20 2020 2020 2020 2020 2020 2020  ys:             
│ │ │ │ -00014df0: 2020 2020 2020 2020 2020 2020 2020 4372                Cr
│ │ │ │ -00014e00: 7970 746f 6772 6170 6869 6320 4675 6e63  yptographic Func
│ │ │ │ -00014e10: 7469 6f6e 732e 0a20 2020 2020 2020 2020  tions..         
│ │ │ │ +00014dc0: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ +00014dd0: 2031 3330 290a 2a20 7368 6973 6869 5f6b   130).* shishi_k
│ │ │ │ +00014de0: 6579 733a 2020 2020 2020 2020 2020 2020  eys:            
│ │ │ │ +00014df0: 2020 2020 2020 2020 2020 2020 2020 2043                 C
│ │ │ │ +00014e00: 7279 7074 6f67 7261 7068 6963 2046 756e  ryptographic Fun
│ │ │ │ +00014e10: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │  00014e20: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00014e30: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00014e40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00014e50: 2020 2020 286c 696e 6520 2033 3433 290a      (line  343).
│ │ │ │ -00014e60: 2a20 7368 6973 6869 5f6b 6579 735f 6164  * shishi_keys_ad
│ │ │ │ -00014e70: 643a 2020 2020 2020 2020 2020 2020 2020  d:              
│ │ │ │ -00014e80: 2020 2020 2020 2020 2043 7279 7074 6f67           Cryptog
│ │ │ │ -00014e90: 7261 7068 6963 2046 756e 6374 696f 6e73  raphic Functions
│ │ │ │ -00014ea0: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │ +00014e50: 2020 2020 2028 6c69 6e65 2020 3334 3329       (line  343)
│ │ │ │ +00014e60: 0a2a 2073 6869 7368 695f 6b65 7973 5f61  .* shishi_keys_a
│ │ │ │ +00014e70: 6464 3a20 2020 2020 2020 2020 2020 2020  dd:             
│ │ │ │ +00014e80: 2020 2020 2020 2020 2020 4372 7970 746f            Crypto
│ │ │ │ +00014e90: 6772 6170 6869 6320 4675 6e63 7469 6f6e  graphic Function
│ │ │ │ +00014ea0: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │  00014eb0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00014ec0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00014ed0: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ -00014ee0: 6c69 6e65 2020 3339 3829 0a2a 2073 6869  line  398).* shi
│ │ │ │ -00014ef0: 7368 695f 6b65 7973 5f64 6f6e 653a 2020  shi_keys_done:  
│ │ │ │ +00014ed0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +00014ee0: 286c 696e 6520 2033 3938 290a 2a20 7368  (line  398).* sh
│ │ │ │ +00014ef0: 6973 6869 5f6b 6579 735f 646f 6e65 3a20  ishi_keys_done: 
│ │ │ │  00014f00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00014f10: 2020 2020 4372 7970 746f 6772 6170 6869      Cryptographi
│ │ │ │ -00014f20: 6320 4675 6e63 7469 6f6e 732e 0a20 2020  c Functions..   
│ │ │ │ +00014f10: 2020 2020 2043 7279 7074 6f67 7261 7068       Cryptograph
│ │ │ │ +00014f20: 6963 2046 756e 6374 696f 6e73 2e0a 2020  ic Functions..  
│ │ │ │  00014f30: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00014f40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00014f50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00014f60: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ -00014f70: 2033 3534 290a 2a20 7368 6973 6869 5f6b   354).* shishi_k
│ │ │ │ -00014f80: 6579 735f 666f 725f 6c6f 6361 6c73 6572  eys_for_localser
│ │ │ │ -00014f90: 7669 6365 7265 616c 6d5f 696e 5f66 696c  vicerealm_in_fil
│ │ │ │ -00014fa0: 653a 2043 7279 7074 6f67 7261 7068 6963  e: Cryptographic
│ │ │ │ -00014fb0: 2046 756e 6374 696f 6e73 2e0a 2020 2020   Functions..    
│ │ │ │ +00014f60: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ +00014f70: 2020 3335 3429 0a2a 2073 6869 7368 695f    354).* shishi_
│ │ │ │ +00014f80: 6b65 7973 5f66 6f72 5f6c 6f63 616c 7365  keys_for_localse
│ │ │ │ +00014f90: 7276 6963 6572 6561 6c6d 5f69 6e5f 6669  rvicerealm_in_fi
│ │ │ │ +00014fa0: 6c65 3a20 4372 7970 746f 6772 6170 6869  le: Cryptographi
│ │ │ │ +00014fb0: 6320 4675 6e63 7469 6f6e 732e 0a20 2020  c Functions..   
│ │ │ │  00014fc0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00014fd0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00014fe0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00014ff0: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ -00015000: 3438 3629 0a2a 2073 6869 7368 695f 6b65  486).* shishi_ke
│ │ │ │ -00015010: 7973 5f66 6f72 5f73 6572 7665 725f 696e  ys_for_server_in
│ │ │ │ -00015020: 5f66 696c 653a 2020 2020 2020 2020 4372  _file:        Cr
│ │ │ │ -00015030: 7970 746f 6772 6170 6869 6320 4675 6e63  yptographic Func
│ │ │ │ -00015040: 7469 6f6e 732e 0a20 2020 2020 2020 2020  tions..         
│ │ │ │ +00014ff0: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ +00015000: 2034 3836 290a 2a20 7368 6973 6869 5f6b   486).* shishi_k
│ │ │ │ +00015010: 6579 735f 666f 725f 7365 7276 6572 5f69  eys_for_server_i
│ │ │ │ +00015020: 6e5f 6669 6c65 3a20 2020 2020 2020 2043  n_file:        C
│ │ │ │ +00015030: 7279 7074 6f67 7261 7068 6963 2046 756e  ryptographic Fun
│ │ │ │ +00015040: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │  00015050: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00015060: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00015070: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00015080: 2020 2020 286c 696e 6520 2034 3731 290a      (line  471).
│ │ │ │ -00015090: 2a20 7368 6973 6869 5f6b 6579 735f 666f  * shishi_keys_fo
│ │ │ │ -000150a0: 725f 7365 7276 6572 7265 616c 6d5f 696e  r_serverrealm_in
│ │ │ │ -000150b0: 5f66 696c 653a 2020 2043 7279 7074 6f67  _file:   Cryptog
│ │ │ │ -000150c0: 7261 7068 6963 2046 756e 6374 696f 6e73  raphic Functions
│ │ │ │ -000150d0: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │ +00015080: 2020 2020 2028 6c69 6e65 2020 3437 3129       (line  471)
│ │ │ │ +00015090: 0a2a 2073 6869 7368 695f 6b65 7973 5f66  .* shishi_keys_f
│ │ │ │ +000150a0: 6f72 5f73 6572 7665 7272 6561 6c6d 5f69  or_serverrealm_i
│ │ │ │ +000150b0: 6e5f 6669 6c65 3a20 2020 4372 7970 746f  n_file:   Crypto
│ │ │ │ +000150c0: 6772 6170 6869 6320 4675 6e63 7469 6f6e  graphic Function
│ │ │ │ +000150d0: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │  000150e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000150f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00015100: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ -00015110: 6c69 6e65 2020 3435 3329 0a2a 2073 6869  line  453).* shi
│ │ │ │ -00015120: 7368 695f 6b65 7973 5f66 726f 6d5f 6669  shi_keys_from_fi
│ │ │ │ -00015130: 6c65 3a20 2020 2020 2020 2020 2020 2020  le:             
│ │ │ │ -00015140: 2020 2020 4372 7970 746f 6772 6170 6869      Cryptographi
│ │ │ │ -00015150: 6320 4675 6e63 7469 6f6e 732e 0a20 2020  c Functions..   
│ │ │ │ +00015100: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +00015110: 286c 696e 6520 2034 3533 290a 2a20 7368  (line  453).* sh
│ │ │ │ +00015120: 6973 6869 5f6b 6579 735f 6672 6f6d 5f66  ishi_keys_from_f
│ │ │ │ +00015130: 696c 653a 2020 2020 2020 2020 2020 2020  ile:            
│ │ │ │ +00015140: 2020 2020 2043 7279 7074 6f67 7261 7068       Cryptograph
│ │ │ │ +00015150: 6963 2046 756e 6374 696f 6e73 2e0a 2020  ic Functions..  
│ │ │ │  00015160: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00015170: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00015180: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00015190: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ -000151a0: 2034 3337 290a 2a20 7368 6973 6869 5f6b   437).* shishi_k
│ │ │ │ -000151b0: 6579 735f 6e74 683a 2020 2020 2020 2020  eys_nth:        
│ │ │ │ -000151c0: 2020 2020 2020 2020 2020 2020 2020 2043                 C
│ │ │ │ -000151d0: 7279 7074 6f67 7261 7068 6963 2046 756e  ryptographic Fun
│ │ │ │ -000151e0: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │ +00015190: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ +000151a0: 2020 3433 3729 0a2a 2073 6869 7368 695f    437).* shishi_
│ │ │ │ +000151b0: 6b65 7973 5f6e 7468 3a20 2020 2020 2020  keys_nth:       
│ │ │ │ +000151c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +000151d0: 4372 7970 746f 6772 6170 6869 6320 4675  Cryptographic Fu
│ │ │ │ +000151e0: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │  000151f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00015200: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00015210: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00015220: 2020 2020 2028 6c69 6e65 2020 3337 3429       (line  374)
│ │ │ │ -00015230: 0a2a 2073 6869 7368 695f 6b65 7973 5f70  .* shishi_keys_p
│ │ │ │ -00015240: 7269 6e74 3a20 2020 2020 2020 2020 2020  rint:           
│ │ │ │ -00015250: 2020 2020 2020 2020 2020 4372 7970 746f            Crypto
│ │ │ │ -00015260: 6772 6170 6869 6320 4675 6e63 7469 6f6e  graphic Function
│ │ │ │ -00015270: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │ +00015220: 2020 2020 2020 286c 696e 6520 2033 3734        (line  374
│ │ │ │ +00015230: 290a 2a20 7368 6973 6869 5f6b 6579 735f  ).* shishi_keys_
│ │ │ │ +00015240: 7072 696e 743a 2020 2020 2020 2020 2020  print:          
│ │ │ │ +00015250: 2020 2020 2020 2020 2020 2043 7279 7074             Crypt
│ │ │ │ +00015260: 6f67 7261 7068 6963 2046 756e 6374 696f  ographic Functio
│ │ │ │ +00015270: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │  00015280: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00015290: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000152a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000152b0: 286c 696e 6520 2034 3131 290a 2a20 7368  (line  411).* sh
│ │ │ │ -000152c0: 6973 6869 5f6b 6579 735f 7265 6d6f 7665  ishi_keys_remove
│ │ │ │ -000152d0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ -000152e0: 2020 2020 2043 7279 7074 6f67 7261 7068       Cryptograph
│ │ │ │ -000152f0: 6963 2046 756e 6374 696f 6e73 2e0a 2020  ic Functions..  
│ │ │ │ +000152b0: 2028 6c69 6e65 2020 3431 3129 0a2a 2073   (line  411).* s
│ │ │ │ +000152c0: 6869 7368 695f 6b65 7973 5f72 656d 6f76  hishi_keys_remov
│ │ │ │ +000152d0: 653a 2020 2020 2020 2020 2020 2020 2020  e:              
│ │ │ │ +000152e0: 2020 2020 2020 4372 7970 746f 6772 6170        Cryptograp
│ │ │ │ +000152f0: 6869 6320 4675 6e63 7469 6f6e 732e 0a20  hic Functions.. 
│ │ │ │  00015300: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00015310: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00015320: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00015330: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ -00015340: 2020 3338 3829 0a2a 2073 6869 7368 695f    388).* shishi_
│ │ │ │ -00015350: 6b65 7973 5f73 697a 653a 2020 2020 2020  keys_size:      
│ │ │ │ +00015330: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ +00015340: 6520 2033 3838 290a 2a20 7368 6973 6869  e  388).* shishi
│ │ │ │ +00015350: 5f6b 6579 735f 7369 7a65 3a20 2020 2020  _keys_size:     
│ │ │ │  00015360: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00015370: 4372 7970 746f 6772 6170 6869 6320 4675  Cryptographic Fu
│ │ │ │ -00015380: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │ +00015370: 2043 7279 7074 6f67 7261 7068 6963 2046   Cryptographic F
│ │ │ │ +00015380: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │  00015390: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000153a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000153b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000153c0: 2020 2020 2020 286c 696e 6520 2033 3634        (line  364
│ │ │ │ -000153d0: 290a 2a20 7368 6973 6869 5f6b 6579 735f  ).* shishi_keys_
│ │ │ │ -000153e0: 746f 5f66 696c 653a 2020 2020 2020 2020  to_file:        
│ │ │ │ -000153f0: 2020 2020 2020 2020 2020 2043 7279 7074             Crypt
│ │ │ │ -00015400: 6f67 7261 7068 6963 2046 756e 6374 696f  ographic Functio
│ │ │ │ -00015410: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │ +000153c0: 2020 2020 2020 2028 6c69 6e65 2020 3336         (line  36
│ │ │ │ +000153d0: 3429 0a2a 2073 6869 7368 695f 6b65 7973  4).* shishi_keys
│ │ │ │ +000153e0: 5f74 6f5f 6669 6c65 3a20 2020 2020 2020  _to_file:       
│ │ │ │ +000153f0: 2020 2020 2020 2020 2020 2020 4372 7970              Cryp
│ │ │ │ +00015400: 746f 6772 6170 6869 6320 4675 6e63 7469  tographic Functi
│ │ │ │ +00015410: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │  00015420: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00015430: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00015440: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00015450: 2028 6c69 6e65 2020 3432 3229 0a2a 2073   (line  422).* s
│ │ │ │ -00015460: 6869 7368 695f 6b72 6265 7272 6f72 3a20  hishi_krberror: 
│ │ │ │ +00015450: 2020 286c 696e 6520 2034 3232 290a 2a20    (line  422).* 
│ │ │ │ +00015460: 7368 6973 6869 5f6b 7262 6572 726f 723a  shishi_krberror:
│ │ │ │  00015470: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00015480: 2020 2020 2020 4b52 422d 4552 524f 5220        KRB-ERROR 
│ │ │ │ -00015490: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │ +00015480: 2020 2020 2020 204b 5242 2d45 5252 4f52         KRB-ERROR
│ │ │ │ +00015490: 2046 756e 6374 696f 6e73 2e0a 2020 2020   Functions..    
│ │ │ │  000154a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000154b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000154c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000154d0: 2020 2020 2020 2020 286c 696e 6520 2020          (line   
│ │ │ │ -000154e0: 3332 290a 2a20 7368 6973 6869 5f6b 7262  32).* shishi_krb
│ │ │ │ -000154f0: 6572 726f 725f 6275 696c 643a 2020 2020  error_build:    
│ │ │ │ -00015500: 2020 2020 2020 2020 2020 2020 204b 5242               KRB
│ │ │ │ -00015510: 2d45 5252 4f52 2046 756e 6374 696f 6e73  -ERROR Functions
│ │ │ │ -00015520: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │ +000154d0: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ +000154e0: 2033 3229 0a2a 2073 6869 7368 695f 6b72   32).* shishi_kr
│ │ │ │ +000154f0: 6265 7272 6f72 5f62 7569 6c64 3a20 2020  berror_build:   
│ │ │ │ +00015500: 2020 2020 2020 2020 2020 2020 2020 4b52                KR
│ │ │ │ +00015510: 422d 4552 524f 5220 4675 6e63 7469 6f6e  B-ERROR Function
│ │ │ │ +00015520: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │  00015530: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00015540: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00015550: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ -00015560: 6c69 6e65 2020 3132 3929 0a2a 2073 6869  line  129).* shi
│ │ │ │ -00015570: 7368 695f 6b72 6265 7272 6f72 5f63 6c69  shi_krberror_cli
│ │ │ │ -00015580: 656e 743a 2020 2020 2020 2020 2020 2020  ent:            
│ │ │ │ -00015590: 2020 2020 4b52 422d 4552 524f 5220 4675      KRB-ERROR Fu
│ │ │ │ -000155a0: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │ +00015550: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +00015560: 286c 696e 6520 2031 3239 290a 2a20 7368  (line  129).* sh
│ │ │ │ +00015570: 6973 6869 5f6b 7262 6572 726f 725f 636c  ishi_krberror_cl
│ │ │ │ +00015580: 6965 6e74 3a20 2020 2020 2020 2020 2020  ient:           
│ │ │ │ +00015590: 2020 2020 204b 5242 2d45 5252 4f52 2046       KRB-ERROR F
│ │ │ │ +000155a0: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │  000155b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000155c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000155d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000155e0: 2020 2020 2020 286c 696e 6520 2031 3938        (line  198
│ │ │ │ -000155f0: 290a 2a20 7368 6973 6869 5f6b 7262 6572  ).* shishi_krber
│ │ │ │ -00015600: 726f 725f 636c 6965 6e74 5f73 6574 3a20  ror_client_set: 
│ │ │ │ -00015610: 2020 2020 2020 2020 2020 204b 5242 2d45             KRB-E
│ │ │ │ -00015620: 5252 4f52 2046 756e 6374 696f 6e73 2e0a  RROR Functions..
│ │ │ │ -00015630: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +000155e0: 2020 2020 2020 2028 6c69 6e65 2020 3139         (line  19
│ │ │ │ +000155f0: 3829 0a2a 2073 6869 7368 695f 6b72 6265  8).* shishi_krbe
│ │ │ │ +00015600: 7272 6f72 5f63 6c69 656e 745f 7365 743a  rror_client_set:
│ │ │ │ +00015610: 2020 2020 2020 2020 2020 2020 4b52 422d              KRB-
│ │ │ │ +00015620: 4552 524f 5220 4675 6e63 7469 6f6e 732e  ERROR Functions.
│ │ │ │ +00015630: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │  00015640: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00015650: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00015660: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ -00015670: 6e65 2020 3234 3329 0a2a 2073 6869 7368  ne  243).* shish
│ │ │ │ -00015680: 695f 6b72 6265 7272 6f72 5f63 7265 616c  i_krberror_creal
│ │ │ │ -00015690: 6d3a 2020 2020 2020 2020 2020 2020 2020  m:              
│ │ │ │ -000156a0: 2020 4b52 422d 4552 524f 5220 4675 6e63    KRB-ERROR Func
│ │ │ │ -000156b0: 7469 6f6e 732e 0a20 2020 2020 2020 2020  tions..         
│ │ │ │ +00015660: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ +00015670: 696e 6520 2032 3433 290a 2a20 7368 6973  ine  243).* shis
│ │ │ │ +00015680: 6869 5f6b 7262 6572 726f 725f 6372 6561  hi_krberror_crea
│ │ │ │ +00015690: 6c6d 3a20 2020 2020 2020 2020 2020 2020  lm:             
│ │ │ │ +000156a0: 2020 204b 5242 2d45 5252 4f52 2046 756e     KRB-ERROR Fun
│ │ │ │ +000156b0: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │  000156c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000156d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000156e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000156f0: 2020 2020 286c 696e 6520 2031 3538 290a      (line  158).
│ │ │ │ -00015700: 2a20 7368 6973 6869 5f6b 7262 6572 726f  * shishi_krberro
│ │ │ │ -00015710: 725f 6374 696d 653a 2020 2020 2020 2020  r_ctime:        
│ │ │ │ -00015720: 2020 2020 2020 2020 204b 5242 2d45 5252           KRB-ERR
│ │ │ │ -00015730: 4f52 2046 756e 6374 696f 6e73 2e0a 2020  OR Functions..  
│ │ │ │ +000156f0: 2020 2020 2028 6c69 6e65 2020 3135 3829       (line  158)
│ │ │ │ +00015700: 0a2a 2073 6869 7368 695f 6b72 6265 7272  .* shishi_krberr
│ │ │ │ +00015710: 6f72 5f63 7469 6d65 3a20 2020 2020 2020  or_ctime:       
│ │ │ │ +00015720: 2020 2020 2020 2020 2020 4b52 422d 4552            KRB-ER
│ │ │ │ +00015730: 524f 5220 4675 6e63 7469 6f6e 732e 0a20  ROR Functions.. 
│ │ │ │  00015740: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00015750: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00015760: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00015770: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ -00015780: 2020 3334 3829 0a2a 2073 6869 7368 695f    348).* shishi_
│ │ │ │ -00015790: 6b72 6265 7272 6f72 5f63 7469 6d65 5f73  krberror_ctime_s
│ │ │ │ -000157a0: 6574 3a20 2020 2020 2020 2020 2020 2020  et:             
│ │ │ │ -000157b0: 4b52 422d 4552 524f 5220 4675 6e63 7469  KRB-ERROR Functi
│ │ │ │ -000157c0: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │ +00015770: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ +00015780: 6520 2033 3438 290a 2a20 7368 6973 6869  e  348).* shishi
│ │ │ │ +00015790: 5f6b 7262 6572 726f 725f 6374 696d 655f  _krberror_ctime_
│ │ │ │ +000157a0: 7365 743a 2020 2020 2020 2020 2020 2020  set:            
│ │ │ │ +000157b0: 204b 5242 2d45 5252 4f52 2046 756e 6374   KRB-ERROR Funct
│ │ │ │ +000157c0: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │  000157d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000157e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000157f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00015800: 2020 286c 696e 6520 2033 3631 290a 2a20    (line  361).* 
│ │ │ │ -00015810: 7368 6973 6869 5f6b 7262 6572 726f 725f  shishi_krberror_
│ │ │ │ -00015820: 6375 7365 633a 2020 2020 2020 2020 2020  cusec:          
│ │ │ │ -00015830: 2020 2020 2020 204b 5242 2d45 5252 4f52         KRB-ERROR
│ │ │ │ -00015840: 2046 756e 6374 696f 6e73 2e0a 2020 2020   Functions..    
│ │ │ │ +00015800: 2020 2028 6c69 6e65 2020 3336 3129 0a2a     (line  361).*
│ │ │ │ +00015810: 2073 6869 7368 695f 6b72 6265 7272 6f72   shishi_krberror
│ │ │ │ +00015820: 5f63 7573 6563 3a20 2020 2020 2020 2020  _cusec:         
│ │ │ │ +00015830: 2020 2020 2020 2020 4b52 422d 4552 524f          KRB-ERRO
│ │ │ │ +00015840: 5220 4675 6e63 7469 6f6e 732e 0a20 2020  R Functions..   
│ │ │ │  00015850: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00015860: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00015870: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00015880: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ -00015890: 3338 3629 0a2a 2073 6869 7368 695f 6b72  386).* shishi_kr
│ │ │ │ -000158a0: 6265 7272 6f72 5f63 7573 6563 5f73 6574  berror_cusec_set
│ │ │ │ -000158b0: 3a20 2020 2020 2020 2020 2020 2020 4b52  :             KR
│ │ │ │ -000158c0: 422d 4552 524f 5220 4675 6e63 7469 6f6e  B-ERROR Function
│ │ │ │ -000158d0: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │ +00015880: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ +00015890: 2033 3836 290a 2a20 7368 6973 6869 5f6b   386).* shishi_k
│ │ │ │ +000158a0: 7262 6572 726f 725f 6375 7365 635f 7365  rberror_cusec_se
│ │ │ │ +000158b0: 743a 2020 2020 2020 2020 2020 2020 204b  t:             K
│ │ │ │ +000158c0: 5242 2d45 5252 4f52 2046 756e 6374 696f  RB-ERROR Functio
│ │ │ │ +000158d0: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │  000158e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000158f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00015900: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00015910: 286c 696e 6520 2033 3939 290a 2a20 7368  (line  399).* sh
│ │ │ │ -00015920: 6973 6869 5f6b 7262 6572 726f 725f 6465  ishi_krberror_de
│ │ │ │ -00015930: 723a 2020 2020 2020 2020 2020 2020 2020  r:              
│ │ │ │ -00015940: 2020 2020 204b 5242 2d45 5252 4f52 2046       KRB-ERROR F
│ │ │ │ -00015950: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │ +00015910: 2028 6c69 6e65 2020 3339 3929 0a2a 2073   (line  399).* s
│ │ │ │ +00015920: 6869 7368 695f 6b72 6265 7272 6f72 5f64  hishi_krberror_d
│ │ │ │ +00015930: 6572 3a20 2020 2020 2020 2020 2020 2020  er:             
│ │ │ │ +00015940: 2020 2020 2020 4b52 422d 4552 524f 5220        KRB-ERROR 
│ │ │ │ +00015950: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │  00015960: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00015970: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00015980: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00015990: 2020 2020 2020 2028 6c69 6e65 2020 3134         (line  14
│ │ │ │ -000159a0: 3329 0a2a 2073 6869 7368 695f 6b72 6265  3).* shishi_krbe
│ │ │ │ -000159b0: 7272 6f72 5f65 6461 7461 3a20 2020 2020  rror_edata:     
│ │ │ │ -000159c0: 2020 2020 2020 2020 2020 2020 4b52 422d              KRB-
│ │ │ │ -000159d0: 4552 524f 5220 4675 6e63 7469 6f6e 732e  ERROR Functions.
│ │ │ │ -000159e0: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ +00015990: 2020 2020 2020 2020 286c 696e 6520 2031          (line  1
│ │ │ │ +000159a0: 3433 290a 2a20 7368 6973 6869 5f6b 7262  43).* shishi_krb
│ │ │ │ +000159b0: 6572 726f 725f 6564 6174 613a 2020 2020  error_edata:    
│ │ │ │ +000159c0: 2020 2020 2020 2020 2020 2020 204b 5242               KRB
│ │ │ │ +000159d0: 2d45 5252 4f52 2046 756e 6374 696f 6e73  -ERROR Functions
│ │ │ │ +000159e0: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │  000159f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00015a00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00015a10: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ -00015a20: 696e 6520 2035 3537 290a 2a20 7368 6973  ine  557).* shis
│ │ │ │ -00015a30: 6869 5f6b 7262 6572 726f 725f 6572 726f  hi_krberror_erro
│ │ │ │ -00015a40: 7263 6f64 653a 2020 2020 2020 2020 2020  rcode:          
│ │ │ │ -00015a50: 2020 204b 5242 2d45 5252 4f52 2046 756e     KRB-ERROR Fun
│ │ │ │ -00015a60: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │ +00015a10: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ +00015a20: 6c69 6e65 2020 3535 3729 0a2a 2073 6869  line  557).* shi
│ │ │ │ +00015a30: 7368 695f 6b72 6265 7272 6f72 5f65 7272  shi_krberror_err
│ │ │ │ +00015a40: 6f72 636f 6465 3a20 2020 2020 2020 2020  orcode:         
│ │ │ │ +00015a50: 2020 2020 4b52 422d 4552 524f 5220 4675      KRB-ERROR Fu
│ │ │ │ +00015a60: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │  00015a70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00015a80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00015a90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00015aa0: 2020 2020 2028 6c69 6e65 2020 3437 3629       (line  476)
│ │ │ │ -00015ab0: 0a2a 2073 6869 7368 695f 6b72 6265 7272  .* shishi_krberr
│ │ │ │ -00015ac0: 6f72 5f65 7272 6f72 636f 6465 5f66 6173  or_errorcode_fas
│ │ │ │ -00015ad0: 743a 2020 2020 2020 2020 4b52 422d 4552  t:        KRB-ER
│ │ │ │ -00015ae0: 524f 5220 4675 6e63 7469 6f6e 732e 0a20  ROR Functions.. 
│ │ │ │ +00015aa0: 2020 2020 2020 286c 696e 6520 2034 3736        (line  476
│ │ │ │ +00015ab0: 290a 2a20 7368 6973 6869 5f6b 7262 6572  ).* shishi_krber
│ │ │ │ +00015ac0: 726f 725f 6572 726f 7263 6f64 655f 6661  ror_errorcode_fa
│ │ │ │ +00015ad0: 7374 3a20 2020 2020 2020 204b 5242 2d45  st:        KRB-E
│ │ │ │ +00015ae0: 5252 4f52 2046 756e 6374 696f 6e73 2e0a  RROR Functions..
│ │ │ │  00015af0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00015b00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00015b10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00015b20: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ -00015b30: 6520 2034 3839 290a 2a20 7368 6973 6869  e  489).* shishi
│ │ │ │ -00015b40: 5f6b 7262 6572 726f 725f 6572 726f 7263  _krberror_errorc
│ │ │ │ -00015b50: 6f64 655f 6d65 7373 6167 653a 2020 2020  ode_message:    
│ │ │ │ -00015b60: 204b 5242 2d45 5252 4f52 2046 756e 6374   KRB-ERROR Funct
│ │ │ │ -00015b70: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │ +00015b20: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ +00015b30: 6e65 2020 3438 3929 0a2a 2073 6869 7368  ne  489).* shish
│ │ │ │ +00015b40: 695f 6b72 6265 7272 6f72 5f65 7272 6f72  i_krberror_error
│ │ │ │ +00015b50: 636f 6465 5f6d 6573 7361 6765 3a20 2020  code_message:   
│ │ │ │ +00015b60: 2020 4b52 422d 4552 524f 5220 4675 6e63    KRB-ERROR Func
│ │ │ │ +00015b70: 7469 6f6e 732e 0a20 2020 2020 2020 2020  tions..         
│ │ │ │  00015b80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00015b90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00015ba0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00015bb0: 2020 2028 6c69 6e65 2020 3632 3729 0a2a     (line  627).*
│ │ │ │ -00015bc0: 2073 6869 7368 695f 6b72 6265 7272 6f72   shishi_krberror
│ │ │ │ -00015bd0: 5f65 7272 6f72 636f 6465 5f73 6574 3a20  _errorcode_set: 
│ │ │ │ -00015be0: 2020 2020 2020 2020 4b52 422d 4552 524f          KRB-ERRO
│ │ │ │ -00015bf0: 5220 4675 6e63 7469 6f6e 732e 0a20 2020  R Functions..   
│ │ │ │ +00015bb0: 2020 2020 286c 696e 6520 2036 3237 290a      (line  627).
│ │ │ │ +00015bc0: 2a20 7368 6973 6869 5f6b 7262 6572 726f  * shishi_krberro
│ │ │ │ +00015bd0: 725f 6572 726f 7263 6f64 655f 7365 743a  r_errorcode_set:
│ │ │ │ +00015be0: 2020 2020 2020 2020 204b 5242 2d45 5252           KRB-ERR
│ │ │ │ +00015bf0: 4f52 2046 756e 6374 696f 6e73 2e0a 2020  OR Functions..  
│ │ │ │  00015c00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00015c10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00015c20: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00015c30: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ -00015c40: 2035 3033 290a 2a20 7368 6973 6869 5f6b   503).* shishi_k
│ │ │ │ -00015c50: 7262 6572 726f 725f 6574 6578 743a 2020  rberror_etext:  
│ │ │ │ -00015c60: 2020 2020 2020 2020 2020 2020 2020 204b                 K
│ │ │ │ -00015c70: 5242 2d45 5252 4f52 2046 756e 6374 696f  RB-ERROR Functio
│ │ │ │ -00015c80: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │ +00015c30: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ +00015c40: 2020 3530 3329 0a2a 2073 6869 7368 695f    503).* shishi_
│ │ │ │ +00015c50: 6b72 6265 7272 6f72 5f65 7465 7874 3a20  krberror_etext: 
│ │ │ │ +00015c60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +00015c70: 4b52 422d 4552 524f 5220 4675 6e63 7469  KRB-ERROR Functi
│ │ │ │ +00015c80: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │  00015c90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00015ca0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00015cb0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00015cc0: 2028 6c69 6e65 2020 3531 3629 0a2a 2073   (line  516).* s
│ │ │ │ -00015cd0: 6869 7368 695f 6b72 6265 7272 6f72 5f66  hishi_krberror_f
│ │ │ │ -00015ce0: 726f 6d5f 6669 6c65 3a20 2020 2020 2020  rom_file:       
│ │ │ │ -00015cf0: 2020 2020 2020 4b52 422d 4552 524f 5220        KRB-ERROR 
│ │ │ │ -00015d00: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │ +00015cc0: 2020 286c 696e 6520 2035 3136 290a 2a20    (line  516).* 
│ │ │ │ +00015cd0: 7368 6973 6869 5f6b 7262 6572 726f 725f  shishi_krberror_
│ │ │ │ +00015ce0: 6672 6f6d 5f66 696c 653a 2020 2020 2020  from_file:      
│ │ │ │ +00015cf0: 2020 2020 2020 204b 5242 2d45 5252 4f52         KRB-ERROR
│ │ │ │ +00015d00: 2046 756e 6374 696f 6e73 2e0a 2020 2020   Functions..    
│ │ │ │  00015d10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00015d20: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00015d30: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00015d40: 2020 2020 2020 2020 286c 696e 6520 2031          (line  1
│ │ │ │ -00015d50: 3134 290a 2a20 7368 6973 6869 5f6b 7262  14).* shishi_krb
│ │ │ │ -00015d60: 6572 726f 725f 6d65 7373 6167 653a 2020  error_message:  
│ │ │ │ -00015d70: 2020 2020 2020 2020 2020 2020 204b 5242               KRB
│ │ │ │ -00015d80: 2d45 5252 4f52 2046 756e 6374 696f 6e73  -ERROR Functions
│ │ │ │ -00015d90: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │ +00015d40: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ +00015d50: 3131 3429 0a2a 2073 6869 7368 695f 6b72  114).* shishi_kr
│ │ │ │ +00015d60: 6265 7272 6f72 5f6d 6573 7361 6765 3a20  berror_message: 
│ │ │ │ +00015d70: 2020 2020 2020 2020 2020 2020 2020 4b52                KR
│ │ │ │ +00015d80: 422d 4552 524f 5220 4675 6e63 7469 6f6e  B-ERROR Function
│ │ │ │ +00015d90: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │  00015da0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00015db0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00015dc0: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ -00015dd0: 6c69 6e65 2020 3634 3129 0a2a 2073 6869  line  641).* shi
│ │ │ │ -00015de0: 7368 695f 6b72 6265 7272 6f72 5f6d 6574  shi_krberror_met
│ │ │ │ -00015df0: 686f 6464 6174 613a 2020 2020 2020 2020  hoddata:        
│ │ │ │ -00015e00: 2020 2020 4b52 422d 4552 524f 5220 4675      KRB-ERROR Fu
│ │ │ │ -00015e10: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │ +00015dc0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +00015dd0: 286c 696e 6520 2036 3431 290a 2a20 7368  (line  641).* sh
│ │ │ │ +00015de0: 6973 6869 5f6b 7262 6572 726f 725f 6d65  ishi_krberror_me
│ │ │ │ +00015df0: 7468 6f64 6461 7461 3a20 2020 2020 2020  thoddata:       
│ │ │ │ +00015e00: 2020 2020 204b 5242 2d45 5252 4f52 2046       KRB-ERROR F
│ │ │ │ +00015e10: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │  00015e20: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00015e30: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00015e40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00015e50: 2020 2020 2020 286c 696e 6520 2035 3732        (line  572
│ │ │ │ -00015e60: 290a 2a20 7368 6973 6869 5f6b 7262 6572  ).* shishi_krber
│ │ │ │ -00015e70: 726f 725f 7061 7273 653a 2020 2020 2020  ror_parse:      
│ │ │ │ -00015e80: 2020 2020 2020 2020 2020 204b 5242 2d45             KRB-E
│ │ │ │ -00015e90: 5252 4f52 2046 756e 6374 696f 6e73 2e0a  RROR Functions..
│ │ │ │ -00015ea0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +00015e50: 2020 2020 2020 2028 6c69 6e65 2020 3537         (line  57
│ │ │ │ +00015e60: 3229 0a2a 2073 6869 7368 695f 6b72 6265  2).* shishi_krbe
│ │ │ │ +00015e70: 7272 6f72 5f70 6172 7365 3a20 2020 2020  rror_parse:     
│ │ │ │ +00015e80: 2020 2020 2020 2020 2020 2020 4b52 422d              KRB-
│ │ │ │ +00015e90: 4552 524f 5220 4675 6e63 7469 6f6e 732e  ERROR Functions.
│ │ │ │ +00015ea0: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │  00015eb0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00015ec0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00015ed0: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ -00015ee0: 6e65 2020 2038 3629 0a2a 2073 6869 7368  ne   86).* shish
│ │ │ │ -00015ef0: 695f 6b72 6265 7272 6f72 5f70 7265 7474  i_krberror_prett
│ │ │ │ -00015f00: 795f 7072 696e 743a 2020 2020 2020 2020  y_print:        
│ │ │ │ -00015f10: 2020 4b52 422d 4552 524f 5220 4675 6e63    KRB-ERROR Func
│ │ │ │ -00015f20: 7469 6f6e 732e 0a20 2020 2020 2020 2020  tions..         
│ │ │ │ +00015ed0: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ +00015ee0: 696e 6520 2020 3836 290a 2a20 7368 6973  ine   86).* shis
│ │ │ │ +00015ef0: 6869 5f6b 7262 6572 726f 725f 7072 6574  hi_krberror_pret
│ │ │ │ +00015f00: 7479 5f70 7269 6e74 3a20 2020 2020 2020  ty_print:       
│ │ │ │ +00015f10: 2020 204b 5242 2d45 5252 4f52 2046 756e     KRB-ERROR Fun
│ │ │ │ +00015f20: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │  00015f30: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00015f40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00015f50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00015f60: 2020 2020 286c 696e 6520 2036 3133 290a      (line  613).
│ │ │ │ -00015f70: 2a20 7368 6973 6869 5f6b 7262 6572 726f  * shishi_krberro
│ │ │ │ -00015f80: 725f 7072 696e 743a 2020 2020 2020 2020  r_print:        
│ │ │ │ -00015f90: 2020 2020 2020 2020 204b 5242 2d45 5252           KRB-ERR
│ │ │ │ -00015fa0: 4f52 2046 756e 6374 696f 6e73 2e0a 2020  OR Functions..  
│ │ │ │ +00015f60: 2020 2020 2028 6c69 6e65 2020 3631 3329       (line  613)
│ │ │ │ +00015f70: 0a2a 2073 6869 7368 695f 6b72 6265 7272  .* shishi_krberr
│ │ │ │ +00015f80: 6f72 5f70 7269 6e74 3a20 2020 2020 2020  or_print:       
│ │ │ │ +00015f90: 2020 2020 2020 2020 2020 4b52 422d 4552            KRB-ER
│ │ │ │ +00015fa0: 524f 5220 4675 6e63 7469 6f6e 732e 0a20  ROR Functions.. 
│ │ │ │  00015fb0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00015fc0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00015fd0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00015fe0: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ -00015ff0: 2020 2034 3329 0a2a 2073 6869 7368 695f     43).* shishi_
│ │ │ │ -00016000: 6b72 6265 7272 6f72 5f72 6561 643a 2020  krberror_read:  
│ │ │ │ +00015fe0: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ +00015ff0: 6520 2020 3433 290a 2a20 7368 6973 6869  e   43).* shishi
│ │ │ │ +00016000: 5f6b 7262 6572 726f 725f 7265 6164 3a20  _krberror_read: 
│ │ │ │  00016010: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00016020: 4b52 422d 4552 524f 5220 4675 6e63 7469  KRB-ERROR Functi
│ │ │ │ -00016030: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │ +00016020: 204b 5242 2d45 5252 4f52 2046 756e 6374   KRB-ERROR Funct
│ │ │ │ +00016030: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │  00016040: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00016050: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00016060: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00016070: 2020 286c 696e 6520 2031 3030 290a 2a20    (line  100).* 
│ │ │ │ -00016080: 7368 6973 6869 5f6b 7262 6572 726f 725f  shishi_krberror_
│ │ │ │ -00016090: 7265 616c 6d3a 2020 2020 2020 2020 2020  realm:          
│ │ │ │ -000160a0: 2020 2020 2020 204b 5242 2d45 5252 4f52         KRB-ERROR
│ │ │ │ -000160b0: 2046 756e 6374 696f 6e73 2e0a 2020 2020   Functions..    
│ │ │ │ +00016070: 2020 2028 6c69 6e65 2020 3130 3029 0a2a     (line  100).*
│ │ │ │ +00016080: 2073 6869 7368 695f 6b72 6265 7272 6f72   shishi_krberror
│ │ │ │ +00016090: 5f72 6561 6c6d 3a20 2020 2020 2020 2020  _realm:         
│ │ │ │ +000160a0: 2020 2020 2020 2020 4b52 422d 4552 524f          KRB-ERRO
│ │ │ │ +000160b0: 5220 4675 6e63 7469 6f6e 732e 0a20 2020  R Functions..   
│ │ │ │  000160c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000160d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000160e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000160f0: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ -00016100: 3235 3729 0a2a 2073 6869 7368 695f 6b72  257).* shishi_kr
│ │ │ │ -00016110: 6265 7272 6f72 5f72 656d 6f76 655f 636e  berror_remove_cn
│ │ │ │ -00016120: 616d 653a 2020 2020 2020 2020 2020 4b52  ame:          KR
│ │ │ │ -00016130: 422d 4552 524f 5220 4675 6e63 7469 6f6e  B-ERROR Function
│ │ │ │ -00016140: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │ +000160f0: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ +00016100: 2032 3537 290a 2a20 7368 6973 6869 5f6b   257).* shishi_k
│ │ │ │ +00016110: 7262 6572 726f 725f 7265 6d6f 7665 5f63  rberror_remove_c
│ │ │ │ +00016120: 6e61 6d65 3a20 2020 2020 2020 2020 204b  name:          K
│ │ │ │ +00016130: 5242 2d45 5252 4f52 2046 756e 6374 696f  RB-ERROR Functio
│ │ │ │ +00016140: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │  00016150: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00016160: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00016170: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00016180: 286c 696e 6520 2032 3331 290a 2a20 7368  (line  231).* sh
│ │ │ │ -00016190: 6973 6869 5f6b 7262 6572 726f 725f 7265  ishi_krberror_re
│ │ │ │ -000161a0: 6d6f 7665 5f63 7265 616c 6d3a 2020 2020  move_crealm:    
│ │ │ │ -000161b0: 2020 2020 204b 5242 2d45 5252 4f52 2046       KRB-ERROR F
│ │ │ │ -000161c0: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │ +00016180: 2028 6c69 6e65 2020 3233 3129 0a2a 2073   (line  231).* s
│ │ │ │ +00016190: 6869 7368 695f 6b72 6265 7272 6f72 5f72  hishi_krberror_r
│ │ │ │ +000161a0: 656d 6f76 655f 6372 6561 6c6d 3a20 2020  emove_crealm:   
│ │ │ │ +000161b0: 2020 2020 2020 4b52 422d 4552 524f 5220        KRB-ERROR 
│ │ │ │ +000161c0: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │  000161d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000161e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000161f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00016200: 2020 2020 2020 2028 6c69 6e65 2020 3137         (line  17
│ │ │ │ -00016210: 3329 0a2a 2073 6869 7368 695f 6b72 6265  3).* shishi_krbe
│ │ │ │ -00016220: 7272 6f72 5f72 656d 6f76 655f 6374 696d  rror_remove_ctim
│ │ │ │ -00016230: 653a 2020 2020 2020 2020 2020 4b52 422d  e:          KRB-
│ │ │ │ -00016240: 4552 524f 5220 4675 6e63 7469 6f6e 732e  ERROR Functions.
│ │ │ │ -00016250: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ +00016200: 2020 2020 2020 2020 286c 696e 6520 2031          (line  1
│ │ │ │ +00016210: 3733 290a 2a20 7368 6973 6869 5f6b 7262  73).* shishi_krb
│ │ │ │ +00016220: 6572 726f 725f 7265 6d6f 7665 5f63 7469  error_remove_cti
│ │ │ │ +00016230: 6d65 3a20 2020 2020 2020 2020 204b 5242  me:          KRB
│ │ │ │ +00016240: 2d45 5252 4f52 2046 756e 6374 696f 6e73  -ERROR Functions
│ │ │ │ +00016250: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │  00016260: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00016270: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00016280: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ -00016290: 696e 6520 2033 3734 290a 2a20 7368 6973  ine  374).* shis
│ │ │ │ -000162a0: 6869 5f6b 7262 6572 726f 725f 7265 6d6f  hi_krberror_remo
│ │ │ │ -000162b0: 7665 5f63 7573 6563 3a20 2020 2020 2020  ve_cusec:       
│ │ │ │ -000162c0: 2020 204b 5242 2d45 5252 4f52 2046 756e     KRB-ERROR Fun
│ │ │ │ -000162d0: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │ +00016280: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ +00016290: 6c69 6e65 2020 3337 3429 0a2a 2073 6869  line  374).* shi
│ │ │ │ +000162a0: 7368 695f 6b72 6265 7272 6f72 5f72 656d  shi_krberror_rem
│ │ │ │ +000162b0: 6f76 655f 6375 7365 633a 2020 2020 2020  ove_cusec:      
│ │ │ │ +000162c0: 2020 2020 4b52 422d 4552 524f 5220 4675      KRB-ERROR Fu
│ │ │ │ +000162d0: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │  000162e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000162f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00016300: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00016310: 2020 2020 2028 6c69 6e65 2020 3431 3229       (line  412)
│ │ │ │ -00016320: 0a2a 2073 6869 7368 695f 6b72 6265 7272  .* shishi_krberr
│ │ │ │ -00016330: 6f72 5f72 656d 6f76 655f 6564 6174 613a  or_remove_edata:
│ │ │ │ -00016340: 2020 2020 2020 2020 2020 4b52 422d 4552            KRB-ER
│ │ │ │ -00016350: 524f 5220 4675 6e63 7469 6f6e 732e 0a20  ROR Functions.. 
│ │ │ │ +00016310: 2020 2020 2020 286c 696e 6520 2034 3132        (line  412
│ │ │ │ +00016320: 290a 2a20 7368 6973 6869 5f6b 7262 6572  ).* shishi_krber
│ │ │ │ +00016330: 726f 725f 7265 6d6f 7665 5f65 6461 7461  ror_remove_edata
│ │ │ │ +00016340: 3a20 2020 2020 2020 2020 204b 5242 2d45  :          KRB-E
│ │ │ │ +00016350: 5252 4f52 2046 756e 6374 696f 6e73 2e0a  RROR Functions..
│ │ │ │  00016360: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00016370: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00016380: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00016390: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ -000163a0: 6520 2036 3031 290a 2a20 7368 6973 6869  e  601).* shishi
│ │ │ │ -000163b0: 5f6b 7262 6572 726f 725f 7265 6d6f 7665  _krberror_remove
│ │ │ │ -000163c0: 5f65 7465 7874 3a20 2020 2020 2020 2020  _etext:         
│ │ │ │ -000163d0: 204b 5242 2d45 5252 4f52 2046 756e 6374   KRB-ERROR Funct
│ │ │ │ -000163e0: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │ +00016390: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ +000163a0: 6e65 2020 3630 3129 0a2a 2073 6869 7368  ne  601).* shish
│ │ │ │ +000163b0: 695f 6b72 6265 7272 6f72 5f72 656d 6f76  i_krberror_remov
│ │ │ │ +000163c0: 655f 6574 6578 743a 2020 2020 2020 2020  e_etext:        
│ │ │ │ +000163d0: 2020 4b52 422d 4552 524f 5220 4675 6e63    KRB-ERROR Func
│ │ │ │ +000163e0: 7469 6f6e 732e 0a20 2020 2020 2020 2020  tions..         
│ │ │ │  000163f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00016400: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00016410: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00016420: 2020 2028 6c69 6e65 2020 3534 3529 0a2a     (line  545).*
│ │ │ │ -00016430: 2073 6869 7368 695f 6b72 6265 7272 6f72   shishi_krberror
│ │ │ │ -00016440: 5f72 656d 6f76 655f 736e 616d 653a 2020  _remove_sname:  
│ │ │ │ -00016450: 2020 2020 2020 2020 4b52 422d 4552 524f          KRB-ERRO
│ │ │ │ -00016460: 5220 4675 6e63 7469 6f6e 732e 0a20 2020  R Functions..   
│ │ │ │ +00016420: 2020 2020 286c 696e 6520 2035 3435 290a      (line  545).
│ │ │ │ +00016430: 2a20 7368 6973 6869 5f6b 7262 6572 726f  * shishi_krberro
│ │ │ │ +00016440: 725f 7265 6d6f 7665 5f73 6e61 6d65 3a20  r_remove_sname: 
│ │ │ │ +00016450: 2020 2020 2020 2020 204b 5242 2d45 5252           KRB-ERR
│ │ │ │ +00016460: 4f52 2046 756e 6374 696f 6e73 2e0a 2020  OR Functions..  
│ │ │ │  00016470: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00016480: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00016490: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000164a0: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ -000164b0: 2033 3033 290a 2a20 7368 6973 6869 5f6b   303).* shishi_k
│ │ │ │ -000164c0: 7262 6572 726f 725f 7361 7665 3a20 2020  rberror_save:   
│ │ │ │ -000164d0: 2020 2020 2020 2020 2020 2020 2020 204b                 K
│ │ │ │ -000164e0: 5242 2d45 5252 4f52 2046 756e 6374 696f  RB-ERROR Functio
│ │ │ │ -000164f0: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │ +000164a0: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ +000164b0: 2020 3330 3329 0a2a 2073 6869 7368 695f    303).* shishi_
│ │ │ │ +000164c0: 6b72 6265 7272 6f72 5f73 6176 653a 2020  krberror_save:  
│ │ │ │ +000164d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +000164e0: 4b52 422d 4552 524f 5220 4675 6e63 7469  KRB-ERROR Functi
│ │ │ │ +000164f0: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │  00016500: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00016510: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00016520: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00016530: 2028 6c69 6e65 2020 2035 3729 0a2a 2073   (line   57).* s
│ │ │ │ -00016540: 6869 7368 695f 6b72 6265 7272 6f72 5f73  hishi_krberror_s
│ │ │ │ -00016550: 6572 7665 723a 2020 2020 2020 2020 2020  erver:          
│ │ │ │ -00016560: 2020 2020 2020 4b52 422d 4552 524f 5220        KRB-ERROR 
│ │ │ │ -00016570: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │ +00016530: 2020 286c 696e 6520 2020 3537 290a 2a20    (line   57).* 
│ │ │ │ +00016540: 7368 6973 6869 5f6b 7262 6572 726f 725f  shishi_krberror_
│ │ │ │ +00016550: 7365 7276 6572 3a20 2020 2020 2020 2020  server:         
│ │ │ │ +00016560: 2020 2020 2020 204b 5242 2d45 5252 4f52         KRB-ERROR
│ │ │ │ +00016570: 2046 756e 6374 696f 6e73 2e0a 2020 2020   Functions..    
│ │ │ │  00016580: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00016590: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000165a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000165b0: 2020 2020 2020 2020 286c 696e 6520 2032          (line  2
│ │ │ │ -000165c0: 3836 290a 2a20 7368 6973 6869 5f6b 7262  86).* shishi_krb
│ │ │ │ -000165d0: 6572 726f 725f 7365 7276 6572 5f73 6574  error_server_set
│ │ │ │ -000165e0: 3a20 2020 2020 2020 2020 2020 204b 5242  :            KRB
│ │ │ │ -000165f0: 2d45 5252 4f52 2046 756e 6374 696f 6e73  -ERROR Functions
│ │ │ │ -00016600: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │ +000165b0: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ +000165c0: 3238 3629 0a2a 2073 6869 7368 695f 6b72  286).* shishi_kr
│ │ │ │ +000165d0: 6265 7272 6f72 5f73 6572 7665 725f 7365  berror_server_se
│ │ │ │ +000165e0: 743a 2020 2020 2020 2020 2020 2020 4b52  t:            KR
│ │ │ │ +000165f0: 422d 4552 524f 5220 4675 6e63 7469 6f6e  B-ERROR Function
│ │ │ │ +00016600: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │  00016610: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00016620: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00016630: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ -00016640: 6c69 6e65 2020 3333 3429 0a2a 2073 6869  line  334).* shi
│ │ │ │ -00016650: 7368 695f 6b72 6265 7272 6f72 5f73 6574  shi_krberror_set
│ │ │ │ -00016660: 5f63 6e61 6d65 3a20 2020 2020 2020 2020  _cname:         
│ │ │ │ -00016670: 2020 2020 4b52 422d 4552 524f 5220 4675      KRB-ERROR Fu
│ │ │ │ -00016680: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │ +00016630: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +00016640: 286c 696e 6520 2033 3334 290a 2a20 7368  (line  334).* sh
│ │ │ │ +00016650: 6973 6869 5f6b 7262 6572 726f 725f 7365  ishi_krberror_se
│ │ │ │ +00016660: 745f 636e 616d 653a 2020 2020 2020 2020  t_cname:        
│ │ │ │ +00016670: 2020 2020 204b 5242 2d45 5252 4f52 2046       KRB-ERROR F
│ │ │ │ +00016680: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │  00016690: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000166a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000166b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000166c0: 2020 2020 2020 286c 696e 6520 2032 3135        (line  215
│ │ │ │ -000166d0: 290a 2a20 7368 6973 6869 5f6b 7262 6572  ).* shishi_krber
│ │ │ │ -000166e0: 726f 725f 7365 745f 6372 6561 6c6d 3a20  ror_set_crealm: 
│ │ │ │ -000166f0: 2020 2020 2020 2020 2020 204b 5242 2d45             KRB-E
│ │ │ │ -00016700: 5252 4f52 2046 756e 6374 696f 6e73 2e0a  RROR Functions..
│ │ │ │ -00016710: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +000166c0: 2020 2020 2020 2028 6c69 6e65 2020 3231         (line  21
│ │ │ │ +000166d0: 3529 0a2a 2073 6869 7368 695f 6b72 6265  5).* shishi_krbe
│ │ │ │ +000166e0: 7272 6f72 5f73 6574 5f63 7265 616c 6d3a  rror_set_crealm:
│ │ │ │ +000166f0: 2020 2020 2020 2020 2020 2020 4b52 422d              KRB-
│ │ │ │ +00016700: 4552 524f 5220 4675 6e63 7469 6f6e 732e  ERROR Functions.
│ │ │ │ +00016710: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │  00016720: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00016730: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00016740: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ -00016750: 6e65 2020 3138 3529 0a2a 2073 6869 7368  ne  185).* shish
│ │ │ │ -00016760: 695f 6b72 6265 7272 6f72 5f73 6574 5f65  i_krberror_set_e
│ │ │ │ -00016770: 6461 7461 3a20 2020 2020 2020 2020 2020  data:           
│ │ │ │ -00016780: 2020 4b52 422d 4552 524f 5220 4675 6e63    KRB-ERROR Func
│ │ │ │ -00016790: 7469 6f6e 732e 0a20 2020 2020 2020 2020  tions..         
│ │ │ │ +00016740: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ +00016750: 696e 6520 2031 3835 290a 2a20 7368 6973  ine  185).* shis
│ │ │ │ +00016760: 6869 5f6b 7262 6572 726f 725f 7365 745f  hi_krberror_set_
│ │ │ │ +00016770: 6564 6174 613a 2020 2020 2020 2020 2020  edata:          
│ │ │ │ +00016780: 2020 204b 5242 2d45 5252 4f52 2046 756e     KRB-ERROR Fun
│ │ │ │ +00016790: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │  000167a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000167b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000167c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000167d0: 2020 2020 286c 696e 6520 2035 3837 290a      (line  587).
│ │ │ │ -000167e0: 2a20 7368 6973 6869 5f6b 7262 6572 726f  * shishi_krberro
│ │ │ │ -000167f0: 725f 7365 745f 6574 6578 743a 2020 2020  r_set_etext:    
│ │ │ │ -00016800: 2020 2020 2020 2020 204b 5242 2d45 5252           KRB-ERR
│ │ │ │ -00016810: 4f52 2046 756e 6374 696f 6e73 2e0a 2020  OR Functions..  
│ │ │ │ +000167d0: 2020 2020 2028 6c69 6e65 2020 3538 3729       (line  587)
│ │ │ │ +000167e0: 0a2a 2073 6869 7368 695f 6b72 6265 7272  .* shishi_krberr
│ │ │ │ +000167f0: 6f72 5f73 6574 5f65 7465 7874 3a20 2020  or_set_etext:   
│ │ │ │ +00016800: 2020 2020 2020 2020 2020 4b52 422d 4552            KRB-ER
│ │ │ │ +00016810: 524f 5220 4675 6e63 7469 6f6e 732e 0a20  ROR Functions.. 
│ │ │ │  00016820: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00016830: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00016840: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00016850: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ -00016860: 2020 3533 3129 0a2a 2073 6869 7368 695f    531).* shishi_
│ │ │ │ -00016870: 6b72 6265 7272 6f72 5f73 6574 5f72 6561  krberror_set_rea
│ │ │ │ -00016880: 6c6d 3a20 2020 2020 2020 2020 2020 2020  lm:             
│ │ │ │ -00016890: 4b52 422d 4552 524f 5220 4675 6e63 7469  KRB-ERROR Functi
│ │ │ │ -000168a0: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │ +00016850: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ +00016860: 6520 2035 3331 290a 2a20 7368 6973 6869  e  531).* shishi
│ │ │ │ +00016870: 5f6b 7262 6572 726f 725f 7365 745f 7265  _krberror_set_re
│ │ │ │ +00016880: 616c 6d3a 2020 2020 2020 2020 2020 2020  alm:            
│ │ │ │ +00016890: 204b 5242 2d45 5252 4f52 2046 756e 6374   KRB-ERROR Funct
│ │ │ │ +000168a0: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │  000168b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000168c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000168d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000168e0: 2020 286c 696e 6520 2032 3732 290a 2a20    (line  272).* 
│ │ │ │ -000168f0: 7368 6973 6869 5f6b 7262 6572 726f 725f  shishi_krberror_
│ │ │ │ -00016900: 7365 745f 736e 616d 653a 2020 2020 2020  set_sname:      
│ │ │ │ -00016910: 2020 2020 2020 204b 5242 2d45 5252 4f52         KRB-ERROR
│ │ │ │ -00016920: 2046 756e 6374 696f 6e73 2e0a 2020 2020   Functions..    
│ │ │ │ +000168e0: 2020 2028 6c69 6e65 2020 3237 3229 0a2a     (line  272).*
│ │ │ │ +000168f0: 2073 6869 7368 695f 6b72 6265 7272 6f72   shishi_krberror
│ │ │ │ +00016900: 5f73 6574 5f73 6e61 6d65 3a20 2020 2020  _set_sname:     
│ │ │ │ +00016910: 2020 2020 2020 2020 4b52 422d 4552 524f          KRB-ERRO
│ │ │ │ +00016920: 5220 4675 6e63 7469 6f6e 732e 0a20 2020  R Functions..   
│ │ │ │  00016930: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00016940: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00016950: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00016960: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ -00016970: 3331 3829 0a2a 2073 6869 7368 695f 6b72  318).* shishi_kr
│ │ │ │ -00016980: 6265 7272 6f72 5f73 7469 6d65 3a20 2020  berror_stime:   
│ │ │ │ -00016990: 2020 2020 2020 2020 2020 2020 2020 4b52                KR
│ │ │ │ -000169a0: 422d 4552 524f 5220 4675 6e63 7469 6f6e  B-ERROR Function
│ │ │ │ -000169b0: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │ +00016960: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ +00016970: 2033 3138 290a 2a20 7368 6973 6869 5f6b   318).* shishi_k
│ │ │ │ +00016980: 7262 6572 726f 725f 7374 696d 653a 2020  rberror_stime:  
│ │ │ │ +00016990: 2020 2020 2020 2020 2020 2020 2020 204b                 K
│ │ │ │ +000169a0: 5242 2d45 5252 4f52 2046 756e 6374 696f  RB-ERROR Functio
│ │ │ │ +000169b0: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │  000169c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000169d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000169e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000169f0: 286c 696e 6520 2034 3234 290a 2a20 7368  (line  424).* sh
│ │ │ │ -00016a00: 6973 6869 5f6b 7262 6572 726f 725f 7374  ishi_krberror_st
│ │ │ │ -00016a10: 696d 655f 7365 743a 2020 2020 2020 2020  ime_set:        
│ │ │ │ -00016a20: 2020 2020 204b 5242 2d45 5252 4f52 2046       KRB-ERROR F
│ │ │ │ -00016a30: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │ +000169f0: 2028 6c69 6e65 2020 3432 3429 0a2a 2073   (line  424).* s
│ │ │ │ +00016a00: 6869 7368 695f 6b72 6265 7272 6f72 5f73  hishi_krberror_s
│ │ │ │ +00016a10: 7469 6d65 5f73 6574 3a20 2020 2020 2020  time_set:       
│ │ │ │ +00016a20: 2020 2020 2020 4b52 422d 4552 524f 5220        KRB-ERROR 
│ │ │ │ +00016a30: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │  00016a40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00016a50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00016a60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00016a70: 2020 2020 2020 2028 6c69 6e65 2020 3433         (line  43
│ │ │ │ -00016a80: 3729 0a2a 2073 6869 7368 695f 6b72 6265  7).* shishi_krbe
│ │ │ │ -00016a90: 7272 6f72 5f73 7573 6563 3a20 2020 2020  rror_susec:     
│ │ │ │ -00016aa0: 2020 2020 2020 2020 2020 2020 4b52 422d              KRB-
│ │ │ │ -00016ab0: 4552 524f 5220 4675 6e63 7469 6f6e 732e  ERROR Functions.
│ │ │ │ -00016ac0: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ +00016a70: 2020 2020 2020 2020 286c 696e 6520 2034          (line  4
│ │ │ │ +00016a80: 3337 290a 2a20 7368 6973 6869 5f6b 7262  37).* shishi_krb
│ │ │ │ +00016a90: 6572 726f 725f 7375 7365 633a 2020 2020  error_susec:    
│ │ │ │ +00016aa0: 2020 2020 2020 2020 2020 2020 204b 5242               KRB
│ │ │ │ +00016ab0: 2d45 5252 4f52 2046 756e 6374 696f 6e73  -ERROR Functions
│ │ │ │ +00016ac0: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │  00016ad0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00016ae0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00016af0: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ -00016b00: 696e 6520 2034 3530 290a 2a20 7368 6973  ine  450).* shis
│ │ │ │ -00016b10: 6869 5f6b 7262 6572 726f 725f 7375 7365  hi_krberror_suse
│ │ │ │ -00016b20: 635f 7365 743a 2020 2020 2020 2020 2020  c_set:          
│ │ │ │ -00016b30: 2020 204b 5242 2d45 5252 4f52 2046 756e     KRB-ERROR Fun
│ │ │ │ -00016b40: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │ +00016af0: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ +00016b00: 6c69 6e65 2020 3435 3029 0a2a 2073 6869  line  450).* shi
│ │ │ │ +00016b10: 7368 695f 6b72 6265 7272 6f72 5f73 7573  shi_krberror_sus
│ │ │ │ +00016b20: 6563 5f73 6574 3a20 2020 2020 2020 2020  ec_set:         
│ │ │ │ +00016b30: 2020 2020 4b52 422d 4552 524f 5220 4675      KRB-ERROR Fu
│ │ │ │ +00016b40: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │  00016b50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00016b60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00016b70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00016b80: 2020 2020 2028 6c69 6e65 2020 3436 3329       (line  463)
│ │ │ │ -00016b90: 0a2a 2073 6869 7368 695f 6b72 6265 7272  .* shishi_krberr
│ │ │ │ -00016ba0: 6f72 5f74 6f5f 6669 6c65 3a20 2020 2020  or_to_file:     
│ │ │ │ -00016bb0: 2020 2020 2020 2020 2020 4b52 422d 4552            KRB-ER
│ │ │ │ -00016bc0: 524f 5220 4675 6e63 7469 6f6e 732e 0a20  ROR Functions.. 
│ │ │ │ +00016b80: 2020 2020 2020 286c 696e 6520 2034 3633        (line  463
│ │ │ │ +00016b90: 290a 2a20 7368 6973 6869 5f6b 7262 6572  ).* shishi_krber
│ │ │ │ +00016ba0: 726f 725f 746f 5f66 696c 653a 2020 2020  ror_to_file:    
│ │ │ │ +00016bb0: 2020 2020 2020 2020 2020 204b 5242 2d45             KRB-E
│ │ │ │ +00016bc0: 5252 4f52 2046 756e 6374 696f 6e73 2e0a  RROR Functions..
│ │ │ │  00016bd0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00016be0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00016bf0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00016c00: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ -00016c10: 6520 2020 3730 290a 2a20 7368 6973 6869  e   70).* shishi
│ │ │ │ -00016c20: 5f6d 6434 3a20 2020 2020 2020 2020 2020  _md4:           
│ │ │ │ +00016c00: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ +00016c10: 6e65 2020 2037 3029 0a2a 2073 6869 7368  ne   70).* shish
│ │ │ │ +00016c20: 695f 6d64 343a 2020 2020 2020 2020 2020  i_md4:          
│ │ │ │  00016c30: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00016c40: 2043 7279 7074 6f67 7261 7068 6963 2046   Cryptographic F
│ │ │ │ -00016c50: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │ +00016c40: 2020 4372 7970 746f 6772 6170 6869 6320    Cryptographic 
│ │ │ │ +00016c50: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │  00016c60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00016c70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00016c80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00016c90: 2020 2020 2020 2028 6c69 6e65 2031 3432         (line 142
│ │ │ │ -00016ca0: 3629 0a2a 2073 6869 7368 695f 6d64 353a  6).* shishi_md5:
│ │ │ │ -00016cb0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00016cc0: 2020 2020 2020 2020 2020 2020 4372 7970              Cryp
│ │ │ │ -00016cd0: 746f 6772 6170 6869 6320 4675 6e63 7469  tographic Functi
│ │ │ │ -00016ce0: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │ +00016c90: 2020 2020 2020 2020 286c 696e 6520 3134          (line 14
│ │ │ │ +00016ca0: 3236 290a 2a20 7368 6973 6869 5f6d 6435  26).* shishi_md5
│ │ │ │ +00016cb0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ +00016cc0: 2020 2020 2020 2020 2020 2020 2043 7279               Cry
│ │ │ │ +00016cd0: 7074 6f67 7261 7068 6963 2046 756e 6374  ptographic Funct
│ │ │ │ +00016ce0: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │  00016cf0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00016d00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00016d10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00016d20: 2020 286c 696e 6520 3134 3431 290a 2a20    (line 1441).* 
│ │ │ │ -00016d30: 7368 6973 6869 5f6e 5f66 6f6c 643a 2020  shishi_n_fold:  
│ │ │ │ +00016d20: 2020 2028 6c69 6e65 2031 3434 3129 0a2a     (line 1441).*
│ │ │ │ +00016d30: 2073 6869 7368 695f 6e5f 666f 6c64 3a20   shishi_n_fold: 
│ │ │ │  00016d40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00016d50: 2020 2020 2020 2043 7279 7074 6f67 7261         Cryptogra
│ │ │ │ -00016d60: 7068 6963 2046 756e 6374 696f 6e73 2e0a  phic Functions..
│ │ │ │ -00016d70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +00016d50: 2020 2020 2020 2020 4372 7970 746f 6772          Cryptogr
│ │ │ │ +00016d60: 6170 6869 6320 4675 6e63 7469 6f6e 732e  aphic Functions.
│ │ │ │ +00016d70: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │  00016d80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00016d90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00016da0: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ -00016db0: 6e65 2031 3234 3329 0a2a 2073 6869 7368  ne 1243).* shish
│ │ │ │ -00016dc0: 695f 7061 7273 655f 6e61 6d65 3a20 2020  i_parse_name:   
│ │ │ │ +00016da0: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ +00016db0: 696e 6520 3132 3433 290a 2a20 7368 6973  ine 1243).* shis
│ │ │ │ +00016dc0: 6869 5f70 6172 7365 5f6e 616d 653a 2020  hi_parse_name:  
│ │ │ │  00016dd0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00016de0: 2020 5574 696c 6974 7920 4675 6e63 7469    Utility Functi
│ │ │ │ -00016df0: 6f6e 732e 2020 286c 696e 6520 2031 3732  ons.  (line  172
│ │ │ │ -00016e00: 290a 2a20 7368 6973 6869 5f70 626b 6466  ).* shishi_pbkdf
│ │ │ │ -00016e10: 325f 7368 6131 3a20 2020 2020 2020 2020  2_sha1:         
│ │ │ │ -00016e20: 2020 2020 2020 2020 2020 2043 7279 7074             Crypt
│ │ │ │ -00016e30: 6f67 7261 7068 6963 2046 756e 6374 696f  ographic Functio
│ │ │ │ -00016e40: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │ +00016de0: 2020 2055 7469 6c69 7479 2046 756e 6374     Utility Funct
│ │ │ │ +00016df0: 696f 6e73 2e20 2028 6c69 6e65 2020 3137  ions.  (line  17
│ │ │ │ +00016e00: 3229 0a2a 2073 6869 7368 695f 7062 6b64  2).* shishi_pbkd
│ │ │ │ +00016e10: 6632 5f73 6861 313a 2020 2020 2020 2020  f2_sha1:        
│ │ │ │ +00016e20: 2020 2020 2020 2020 2020 2020 4372 7970              Cryp
│ │ │ │ +00016e30: 746f 6772 6170 6869 6320 4675 6e63 7469  tographic Functi
│ │ │ │ +00016e40: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │  00016e50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00016e60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00016e70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00016e80: 2028 6c69 6e65 2031 3631 3429 0a2a 2073   (line 1614).* s
│ │ │ │ -00016e90: 6869 7368 695f 7072 696e 6369 7061 6c5f  hishi_principal_
│ │ │ │ -00016ea0: 6465 6661 756c 743a 2020 2020 2020 2020  default:        
│ │ │ │ -00016eb0: 2020 2020 2020 5574 696c 6974 7920 4675        Utility Fu
│ │ │ │ -00016ec0: 6e63 7469 6f6e 732e 2020 286c 696e 6520  nctions.  (line 
│ │ │ │ -00016ed0: 2031 3436 290a 2a20 7368 6973 6869 5f70   146).* shishi_p
│ │ │ │ -00016ee0: 7269 6e63 6970 616c 5f64 6566 6175 6c74  rincipal_default
│ │ │ │ -00016ef0: 5f67 7565 7373 3a20 2020 2020 2020 2055  _guess:        U
│ │ │ │ -00016f00: 7469 6c69 7479 2046 756e 6374 696f 6e73  tility Functions
│ │ │ │ -00016f10: 2e20 2028 6c69 6e65 2020 3133 3429 0a2a  .  (line  134).*
│ │ │ │ -00016f20: 2073 6869 7368 695f 7072 696e 6369 7061   shishi_principa
│ │ │ │ -00016f30: 6c5f 6465 6661 756c 745f 7365 743a 2020  l_default_set:  
│ │ │ │ -00016f40: 2020 2020 2020 2020 5574 696c 6974 7920          Utility 
│ │ │ │ -00016f50: 4675 6e63 7469 6f6e 732e 2020 286c 696e  Functions.  (lin
│ │ │ │ -00016f60: 6520 2031 3539 290a 2a20 7368 6973 6869  e  159).* shishi
│ │ │ │ -00016f70: 5f70 7269 6e63 6970 616c 5f6e 616d 653a  _principal_name:
│ │ │ │ -00016f80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00016f90: 2055 7469 6c69 7479 2046 756e 6374 696f   Utility Functio
│ │ │ │ -00016fa0: 6e73 2e20 2028 6c69 6e65 2020 3139 3229  ns.  (line  192)
│ │ │ │ -00016fb0: 0a2a 2073 6869 7368 695f 7072 696e 6369  .* shishi_princi
│ │ │ │ -00016fc0: 7061 6c5f 6e61 6d65 5f72 6561 6c6d 3a20  pal_name_realm: 
│ │ │ │ -00016fd0: 2020 2020 2020 2020 2020 5574 696c 6974            Utilit
│ │ │ │ -00016fe0: 7920 4675 6e63 7469 6f6e 732e 2020 286c  y Functions.  (l
│ │ │ │ -00016ff0: 696e 6520 2032 3134 290a 2a20 7368 6973  ine  214).* shis
│ │ │ │ -00017000: 6869 5f70 7269 6e63 6970 616c 5f6e 616d  hi_principal_nam
│ │ │ │ -00017010: 655f 7365 743a 2020 2020 2020 2020 2020  e_set:          
│ │ │ │ -00017020: 2020 2055 7469 6c69 7479 2046 756e 6374     Utility Funct
│ │ │ │ -00017030: 696f 6e73 2e20 2028 6c69 6e65 2020 3234  ions.  (line  24
│ │ │ │ -00017040: 3029 0a2a 2073 6869 7368 695f 7072 696e  0).* shishi_prin
│ │ │ │ -00017050: 6369 7061 6c5f 7365 743a 2020 2020 2020  cipal_set:      
│ │ │ │ -00017060: 2020 2020 2020 2020 2020 2020 5574 696c              Util
│ │ │ │ -00017070: 6974 7920 4675 6e63 7469 6f6e 732e 2020  ity Functions.  
│ │ │ │ -00017080: 286c 696e 6520 2032 3538 290a 2a20 7368  (line  258).* sh
│ │ │ │ -00017090: 6973 6869 5f70 7269 763a 2020 2020 2020  ishi_priv:      
│ │ │ │ +00016e80: 2020 286c 696e 6520 3136 3134 290a 2a20    (line 1614).* 
│ │ │ │ +00016e90: 7368 6973 6869 5f70 7269 6e63 6970 616c  shishi_principal
│ │ │ │ +00016ea0: 5f64 6566 6175 6c74 3a20 2020 2020 2020  _default:       
│ │ │ │ +00016eb0: 2020 2020 2020 2055 7469 6c69 7479 2046         Utility F
│ │ │ │ +00016ec0: 756e 6374 696f 6e73 2e20 2028 6c69 6e65  unctions.  (line
│ │ │ │ +00016ed0: 2020 3134 3629 0a2a 2073 6869 7368 695f    146).* shishi_
│ │ │ │ +00016ee0: 7072 696e 6369 7061 6c5f 6465 6661 756c  principal_defaul
│ │ │ │ +00016ef0: 745f 6775 6573 733a 2020 2020 2020 2020  t_guess:        
│ │ │ │ +00016f00: 5574 696c 6974 7920 4675 6e63 7469 6f6e  Utility Function
│ │ │ │ +00016f10: 732e 2020 286c 696e 6520 2031 3334 290a  s.  (line  134).
│ │ │ │ +00016f20: 2a20 7368 6973 6869 5f70 7269 6e63 6970  * shishi_princip
│ │ │ │ +00016f30: 616c 5f64 6566 6175 6c74 5f73 6574 3a20  al_default_set: 
│ │ │ │ +00016f40: 2020 2020 2020 2020 2055 7469 6c69 7479           Utility
│ │ │ │ +00016f50: 2046 756e 6374 696f 6e73 2e20 2028 6c69   Functions.  (li
│ │ │ │ +00016f60: 6e65 2020 3135 3929 0a2a 2073 6869 7368  ne  159).* shish
│ │ │ │ +00016f70: 695f 7072 696e 6369 7061 6c5f 6e61 6d65  i_principal_name
│ │ │ │ +00016f80: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ +00016f90: 2020 5574 696c 6974 7920 4675 6e63 7469    Utility Functi
│ │ │ │ +00016fa0: 6f6e 732e 2020 286c 696e 6520 2031 3932  ons.  (line  192
│ │ │ │ +00016fb0: 290a 2a20 7368 6973 6869 5f70 7269 6e63  ).* shishi_princ
│ │ │ │ +00016fc0: 6970 616c 5f6e 616d 655f 7265 616c 6d3a  ipal_name_realm:
│ │ │ │ +00016fd0: 2020 2020 2020 2020 2020 2055 7469 6c69             Utili
│ │ │ │ +00016fe0: 7479 2046 756e 6374 696f 6e73 2e20 2028  ty Functions.  (
│ │ │ │ +00016ff0: 6c69 6e65 2020 3231 3429 0a2a 2073 6869  line  214).* shi
│ │ │ │ +00017000: 7368 695f 7072 696e 6369 7061 6c5f 6e61  shi_principal_na
│ │ │ │ +00017010: 6d65 5f73 6574 3a20 2020 2020 2020 2020  me_set:         
│ │ │ │ +00017020: 2020 2020 5574 696c 6974 7920 4675 6e63      Utility Func
│ │ │ │ +00017030: 7469 6f6e 732e 2020 286c 696e 6520 2032  tions.  (line  2
│ │ │ │ +00017040: 3430 290a 2a20 7368 6973 6869 5f70 7269  40).* shishi_pri
│ │ │ │ +00017050: 6e63 6970 616c 5f73 6574 3a20 2020 2020  ncipal_set:     
│ │ │ │ +00017060: 2020 2020 2020 2020 2020 2020 2055 7469               Uti
│ │ │ │ +00017070: 6c69 7479 2046 756e 6374 696f 6e73 2e20  lity Functions. 
│ │ │ │ +00017080: 2028 6c69 6e65 2020 3235 3829 0a2a 2073   (line  258).* s
│ │ │ │ +00017090: 6869 7368 695f 7072 6976 3a20 2020 2020  hishi_priv:     
│ │ │ │  000170a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000170b0: 2020 2020 2053 4146 4520 616e 6420 5052       SAFE and PR
│ │ │ │ -000170c0: 4956 2046 756e 6374 696f 6e73 2e0a 2020  IV Functions..  
│ │ │ │ +000170b0: 2020 2020 2020 5341 4645 2061 6e64 2050        SAFE and P
│ │ │ │ +000170c0: 5249 5620 4675 6e63 7469 6f6e 732e 0a20  RIV Functions.. 
│ │ │ │  000170d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000170e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000170f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00017100: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ -00017110: 2020 3333 3029 0a2a 2073 6869 7368 695f    330).* shishi_
│ │ │ │ -00017120: 7072 6976 5f62 7569 6c64 3a20 2020 2020  priv_build:     
│ │ │ │ +00017100: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ +00017110: 6520 2033 3330 290a 2a20 7368 6973 6869  e  330).* shishi
│ │ │ │ +00017120: 5f70 7269 765f 6275 696c 643a 2020 2020  _priv_build:    
│ │ │ │  00017130: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00017140: 5341 4645 2061 6e64 2050 5249 5620 4675  SAFE and PRIV Fu
│ │ │ │ -00017150: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │ +00017140: 2053 4146 4520 616e 6420 5052 4956 2046   SAFE and PRIV F
│ │ │ │ +00017150: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │  00017160: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00017170: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00017180: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00017190: 2020 2020 2020 286c 696e 6520 2036 3236        (line  626
│ │ │ │ -000171a0: 290a 2a20 7368 6973 6869 5f70 7269 765f  ).* shishi_priv_
│ │ │ │ -000171b0: 646f 6e65 3a20 2020 2020 2020 2020 2020  done:           
│ │ │ │ -000171c0: 2020 2020 2020 2020 2020 2053 4146 4520             SAFE 
│ │ │ │ -000171d0: 616e 6420 5052 4956 2046 756e 6374 696f  and PRIV Functio
│ │ │ │ -000171e0: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │ +00017190: 2020 2020 2020 2028 6c69 6e65 2020 3632         (line  62
│ │ │ │ +000171a0: 3629 0a2a 2073 6869 7368 695f 7072 6976  6).* shishi_priv
│ │ │ │ +000171b0: 5f64 6f6e 653a 2020 2020 2020 2020 2020  _done:          
│ │ │ │ +000171c0: 2020 2020 2020 2020 2020 2020 5341 4645              SAFE
│ │ │ │ +000171d0: 2061 6e64 2050 5249 5620 4675 6e63 7469   and PRIV Functi
│ │ │ │ +000171e0: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │  000171f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00017200: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00017210: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00017220: 2028 6c69 6e65 2020 3334 3229 0a2a 2073   (line  342).* s
│ │ │ │ -00017230: 6869 7368 695f 7072 6976 5f65 6e63 5f70  hishi_priv_enc_p
│ │ │ │ -00017240: 6172 745f 6574 7970 653a 2020 2020 2020  art_etype:      
│ │ │ │ -00017250: 2020 2020 2020 5341 4645 2061 6e64 2050        SAFE and P
│ │ │ │ -00017260: 5249 5620 4675 6e63 7469 6f6e 732e 0a20  RIV Functions.. 
│ │ │ │ +00017220: 2020 286c 696e 6520 2033 3432 290a 2a20    (line  342).* 
│ │ │ │ +00017230: 7368 6973 6869 5f70 7269 765f 656e 635f  shishi_priv_enc_
│ │ │ │ +00017240: 7061 7274 5f65 7479 7065 3a20 2020 2020  part_etype:     
│ │ │ │ +00017250: 2020 2020 2020 2053 4146 4520 616e 6420         SAFE and 
│ │ │ │ +00017260: 5052 4956 2046 756e 6374 696f 6e73 2e0a  PRIV Functions..
│ │ │ │  00017270: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00017280: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00017290: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000172a0: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ -000172b0: 6520 2035 3630 290a 2a20 7368 6973 6869  e  560).* shishi
│ │ │ │ -000172c0: 5f70 7269 765f 656e 6370 7269 7670 6172  _priv_encprivpar
│ │ │ │ -000172d0: 743a 2020 2020 2020 2020 2020 2020 2020  t:              
│ │ │ │ -000172e0: 2053 4146 4520 616e 6420 5052 4956 2046   SAFE and PRIV F
│ │ │ │ -000172f0: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │ +000172a0: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ +000172b0: 6e65 2020 3536 3029 0a2a 2073 6869 7368  ne  560).* shish
│ │ │ │ +000172c0: 695f 7072 6976 5f65 6e63 7072 6976 7061  i_priv_encprivpa
│ │ │ │ +000172d0: 7274 3a20 2020 2020 2020 2020 2020 2020  rt:             
│ │ │ │ +000172e0: 2020 5341 4645 2061 6e64 2050 5249 5620    SAFE and PRIV 
│ │ │ │ +000172f0: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │  00017300: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00017310: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00017320: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00017330: 2020 2020 2020 2028 6c69 6e65 2020 3432         (line  42
│ │ │ │ -00017340: 3429 0a2a 2073 6869 7368 695f 7072 6976  4).* shishi_priv
│ │ │ │ -00017350: 5f65 6e63 7072 6976 7061 7274 5f64 6572  _encprivpart_der
│ │ │ │ -00017360: 3a20 2020 2020 2020 2020 2020 5341 4645  :           SAFE
│ │ │ │ -00017370: 2061 6e64 2050 5249 5620 4675 6e63 7469   and PRIV Functi
│ │ │ │ -00017380: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │ +00017330: 2020 2020 2020 2020 286c 696e 6520 2034          (line  4
│ │ │ │ +00017340: 3234 290a 2a20 7368 6973 6869 5f70 7269  24).* shishi_pri
│ │ │ │ +00017350: 765f 656e 6370 7269 7670 6172 745f 6465  v_encprivpart_de
│ │ │ │ +00017360: 723a 2020 2020 2020 2020 2020 2053 4146  r:           SAF
│ │ │ │ +00017370: 4520 616e 6420 5052 4956 2046 756e 6374  E and PRIV Funct
│ │ │ │ +00017380: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │  00017390: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000173a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000173b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000173c0: 2020 286c 696e 6520 2034 3435 290a 2a20    (line  445).* 
│ │ │ │ -000173d0: 7368 6973 6869 5f70 7269 765f 656e 6370  shishi_priv_encp
│ │ │ │ -000173e0: 7269 7670 6172 745f 6465 725f 7365 743a  rivpart_der_set:
│ │ │ │ -000173f0: 2020 2020 2020 2053 4146 4520 616e 6420         SAFE and 
│ │ │ │ -00017400: 5052 4956 2046 756e 6374 696f 6e73 2e0a  PRIV Functions..
│ │ │ │ -00017410: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +000173c0: 2020 2028 6c69 6e65 2020 3434 3529 0a2a     (line  445).*
│ │ │ │ +000173d0: 2073 6869 7368 695f 7072 6976 5f65 6e63   shishi_priv_enc
│ │ │ │ +000173e0: 7072 6976 7061 7274 5f64 6572 5f73 6574  privpart_der_set
│ │ │ │ +000173f0: 3a20 2020 2020 2020 5341 4645 2061 6e64  :       SAFE and
│ │ │ │ +00017400: 2050 5249 5620 4675 6e63 7469 6f6e 732e   PRIV Functions.
│ │ │ │ +00017410: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │  00017420: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00017430: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00017440: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ -00017450: 6e65 2020 3436 3129 0a2a 2073 6869 7368  ne  461).* shish
│ │ │ │ -00017460: 695f 7072 6976 5f65 6e63 7072 6976 7061  i_priv_encprivpa
│ │ │ │ -00017470: 7274 5f73 6574 3a20 2020 2020 2020 2020  rt_set:         
│ │ │ │ -00017480: 2020 5341 4645 2061 6e64 2050 5249 5620    SAFE and PRIV 
│ │ │ │ -00017490: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │ +00017440: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ +00017450: 696e 6520 2034 3631 290a 2a20 7368 6973  ine  461).* shis
│ │ │ │ +00017460: 6869 5f70 7269 765f 656e 6370 7269 7670  hi_priv_encprivp
│ │ │ │ +00017470: 6172 745f 7365 743a 2020 2020 2020 2020  art_set:        
│ │ │ │ +00017480: 2020 2053 4146 4520 616e 6420 5052 4956     SAFE and PRIV
│ │ │ │ +00017490: 2046 756e 6374 696f 6e73 2e0a 2020 2020   Functions..    
│ │ │ │  000174a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000174b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000174c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000174d0: 2020 2020 2020 2020 286c 696e 6520 2034          (line  4
│ │ │ │ -000174e0: 3335 290a 2a20 7368 6973 6869 5f70 7269  35).* shishi_pri
│ │ │ │ -000174f0: 765f 6672 6f6d 5f66 696c 653a 2020 2020  v_from_file:    
│ │ │ │ -00017500: 2020 2020 2020 2020 2020 2020 2053 4146               SAF
│ │ │ │ -00017510: 4520 616e 6420 5052 4956 2046 756e 6374  E and PRIV Funct
│ │ │ │ -00017520: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │ +000174d0: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ +000174e0: 3433 3529 0a2a 2073 6869 7368 695f 7072  435).* shishi_pr
│ │ │ │ +000174f0: 6976 5f66 726f 6d5f 6669 6c65 3a20 2020  iv_from_file:   
│ │ │ │ +00017500: 2020 2020 2020 2020 2020 2020 2020 5341                SA
│ │ │ │ +00017510: 4645 2061 6e64 2050 5249 5620 4675 6e63  FE and PRIV Func
│ │ │ │ +00017520: 7469 6f6e 732e 0a20 2020 2020 2020 2020  tions..         
│ │ │ │  00017530: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00017540: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00017550: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00017560: 2020 2028 6c69 6e65 2020 3534 3529 0a2a     (line  545).*
│ │ │ │ -00017570: 2073 6869 7368 695f 7072 6976 5f6b 6579   shishi_priv_key
│ │ │ │ -00017580: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ -00017590: 2020 2020 2020 2020 5341 4645 2061 6e64          SAFE and
│ │ │ │ -000175a0: 2050 5249 5620 4675 6e63 7469 6f6e 732e   PRIV Functions.
│ │ │ │ -000175b0: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ +00017560: 2020 2020 286c 696e 6520 2035 3435 290a      (line  545).
│ │ │ │ +00017570: 2a20 7368 6973 6869 5f70 7269 765f 6b65  * shishi_priv_ke
│ │ │ │ +00017580: 793a 2020 2020 2020 2020 2020 2020 2020  y:              
│ │ │ │ +00017590: 2020 2020 2020 2020 2053 4146 4520 616e           SAFE an
│ │ │ │ +000175a0: 6420 5052 4956 2046 756e 6374 696f 6e73  d PRIV Functions
│ │ │ │ +000175b0: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │  000175c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000175d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000175e0: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ -000175f0: 696e 6520 2033 3532 290a 2a20 7368 6973  ine  352).* shis
│ │ │ │ -00017600: 6869 5f70 7269 765f 6b65 795f 7365 743a  hi_priv_key_set:
│ │ │ │ -00017610: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00017620: 2020 2053 4146 4520 616e 6420 5052 4956     SAFE and PRIV
│ │ │ │ -00017630: 2046 756e 6374 696f 6e73 2e0a 2020 2020   Functions..    
│ │ │ │ +000175e0: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ +000175f0: 6c69 6e65 2020 3335 3229 0a2a 2073 6869  line  352).* shi
│ │ │ │ +00017600: 7368 695f 7072 6976 5f6b 6579 5f73 6574  shi_priv_key_set
│ │ │ │ +00017610: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ +00017620: 2020 2020 5341 4645 2061 6e64 2050 5249      SAFE and PRI
│ │ │ │ +00017630: 5620 4675 6e63 7469 6f6e 732e 0a20 2020  V Functions..   
│ │ │ │  00017640: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00017650: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00017660: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00017670: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ -00017680: 3336 3329 0a2a 2073 6869 7368 695f 7072  363).* shishi_pr
│ │ │ │ -00017690: 6976 5f70 6172 7365 3a20 2020 2020 2020  iv_parse:       
│ │ │ │ -000176a0: 2020 2020 2020 2020 2020 2020 2020 5341                SA
│ │ │ │ -000176b0: 4645 2061 6e64 2050 5249 5620 4675 6e63  FE and PRIV Func
│ │ │ │ -000176c0: 7469 6f6e 732e 0a20 2020 2020 2020 2020  tions..         
│ │ │ │ +00017670: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ +00017680: 2033 3633 290a 2a20 7368 6973 6869 5f70   363).* shishi_p
│ │ │ │ +00017690: 7269 765f 7061 7273 653a 2020 2020 2020  riv_parse:      
│ │ │ │ +000176a0: 2020 2020 2020 2020 2020 2020 2020 2053                 S
│ │ │ │ +000176b0: 4146 4520 616e 6420 5052 4956 2046 756e  AFE and PRIV Fun
│ │ │ │ +000176c0: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │  000176d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000176e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000176f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00017700: 2020 2020 286c 696e 6520 2035 3137 290a      (line  517).
│ │ │ │ -00017710: 2a20 7368 6973 6869 5f70 7269 765f 7072  * shishi_priv_pr
│ │ │ │ -00017720: 696e 743a 2020 2020 2020 2020 2020 2020  int:            
│ │ │ │ -00017730: 2020 2020 2020 2020 2053 4146 4520 616e           SAFE an
│ │ │ │ -00017740: 6420 5052 4956 2046 756e 6374 696f 6e73  d PRIV Functions
│ │ │ │ -00017750: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │ +00017700: 2020 2020 2028 6c69 6e65 2020 3531 3729       (line  517)
│ │ │ │ +00017710: 0a2a 2073 6869 7368 695f 7072 6976 5f70  .* shishi_priv_p
│ │ │ │ +00017720: 7269 6e74 3a20 2020 2020 2020 2020 2020  rint:           
│ │ │ │ +00017730: 2020 2020 2020 2020 2020 5341 4645 2061            SAFE a
│ │ │ │ +00017740: 6e64 2050 5249 5620 4675 6e63 7469 6f6e  nd PRIV Function
│ │ │ │ +00017750: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │  00017760: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00017770: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00017780: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ -00017790: 6c69 6e65 2020 3437 3529 0a2a 2073 6869  line  475).* shi
│ │ │ │ -000177a0: 7368 695f 7072 6976 5f70 7269 763a 2020  shi_priv_priv:  
│ │ │ │ +00017780: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +00017790: 286c 696e 6520 2034 3735 290a 2a20 7368  (line  475).* sh
│ │ │ │ +000177a0: 6973 6869 5f70 7269 765f 7072 6976 3a20  ishi_priv_priv: 
│ │ │ │  000177b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000177c0: 2020 2020 5341 4645 2061 6e64 2050 5249      SAFE and PRI
│ │ │ │ -000177d0: 5620 4675 6e63 7469 6f6e 732e 0a20 2020  V Functions..   
│ │ │ │ +000177c0: 2020 2020 2053 4146 4520 616e 6420 5052       SAFE and PR
│ │ │ │ +000177d0: 4956 2046 756e 6374 696f 6e73 2e0a 2020  IV Functions..  
│ │ │ │  000177e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000177f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00017800: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00017810: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ -00017820: 2033 3733 290a 2a20 7368 6973 6869 5f70   373).* shishi_p
│ │ │ │ -00017830: 7269 765f 7072 6976 5f64 6572 3a20 2020  riv_priv_der:   
│ │ │ │ -00017840: 2020 2020 2020 2020 2020 2020 2020 2053                 S
│ │ │ │ -00017850: 4146 4520 616e 6420 5052 4956 2046 756e  AFE and PRIV Fun
│ │ │ │ -00017860: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │ +00017810: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ +00017820: 2020 3337 3329 0a2a 2073 6869 7368 695f    373).* shishi_
│ │ │ │ +00017830: 7072 6976 5f70 7269 765f 6465 723a 2020  priv_priv_der:  
│ │ │ │ +00017840: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +00017850: 5341 4645 2061 6e64 2050 5249 5620 4675  SAFE and PRIV Fu
│ │ │ │ +00017860: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │  00017870: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00017880: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00017890: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000178a0: 2020 2020 2028 6c69 6e65 2020 3339 3429       (line  394)
│ │ │ │ -000178b0: 0a2a 2073 6869 7368 695f 7072 6976 5f70  .* shishi_priv_p
│ │ │ │ -000178c0: 7269 765f 6465 725f 7365 743a 2020 2020  riv_der_set:    
│ │ │ │ -000178d0: 2020 2020 2020 2020 2020 5341 4645 2061            SAFE a
│ │ │ │ -000178e0: 6e64 2050 5249 5620 4675 6e63 7469 6f6e  nd PRIV Function
│ │ │ │ -000178f0: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │ +000178a0: 2020 2020 2020 286c 696e 6520 2033 3934        (line  394
│ │ │ │ +000178b0: 290a 2a20 7368 6973 6869 5f70 7269 765f  ).* shishi_priv_
│ │ │ │ +000178c0: 7072 6976 5f64 6572 5f73 6574 3a20 2020  priv_der_set:   
│ │ │ │ +000178d0: 2020 2020 2020 2020 2020 2053 4146 4520             SAFE 
│ │ │ │ +000178e0: 616e 6420 5052 4956 2046 756e 6374 696f  and PRIV Functio
│ │ │ │ +000178f0: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │  00017900: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00017910: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00017920: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00017930: 286c 696e 6520 2034 3130 290a 2a20 7368  (line  410).* sh
│ │ │ │ -00017940: 6973 6869 5f70 7269 765f 7072 6976 5f73  ishi_priv_priv_s
│ │ │ │ -00017950: 6574 3a20 2020 2020 2020 2020 2020 2020  et:             
│ │ │ │ -00017960: 2020 2020 2053 4146 4520 616e 6420 5052       SAFE and PR
│ │ │ │ -00017970: 4956 2046 756e 6374 696f 6e73 2e0a 2020  IV Functions..  
│ │ │ │ +00017930: 2028 6c69 6e65 2020 3431 3029 0a2a 2073   (line  410).* s
│ │ │ │ +00017940: 6869 7368 695f 7072 6976 5f70 7269 765f  hishi_priv_priv_
│ │ │ │ +00017950: 7365 743a 2020 2020 2020 2020 2020 2020  set:            
│ │ │ │ +00017960: 2020 2020 2020 5341 4645 2061 6e64 2050        SAFE and P
│ │ │ │ +00017970: 5249 5620 4675 6e63 7469 6f6e 732e 0a20  RIV Functions.. 
│ │ │ │  00017980: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00017990: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000179a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000179b0: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ -000179c0: 2020 3338 3429 0a2a 2073 6869 7368 695f    384).* shishi_
│ │ │ │ -000179d0: 7072 6976 5f70 726f 6365 7373 3a20 2020  priv_process:   
│ │ │ │ +000179b0: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ +000179c0: 6520 2033 3834 290a 2a20 7368 6973 6869  e  384).* shishi
│ │ │ │ +000179d0: 5f70 7269 765f 7072 6f63 6573 733a 2020  _priv_process:  
│ │ │ │  000179e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000179f0: 5341 4645 2061 6e64 2050 5249 5620 4675  SAFE and PRIV Fu
│ │ │ │ -00017a00: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │ +000179f0: 2053 4146 4520 616e 6420 5052 4956 2046   SAFE and PRIV F
│ │ │ │ +00017a00: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │  00017a10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00017a20: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00017a30: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00017a40: 2020 2020 2020 286c 696e 6520 2036 3430        (line  640
│ │ │ │ -00017a50: 290a 2a20 7368 6973 6869 5f70 7269 765f  ).* shishi_priv_
│ │ │ │ -00017a60: 7265 6164 3a20 2020 2020 2020 2020 2020  read:           
│ │ │ │ -00017a70: 2020 2020 2020 2020 2020 2053 4146 4520             SAFE 
│ │ │ │ -00017a80: 616e 6420 5052 4956 2046 756e 6374 696f  and PRIV Functio
│ │ │ │ -00017a90: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │ +00017a40: 2020 2020 2020 2028 6c69 6e65 2020 3634         (line  64
│ │ │ │ +00017a50: 3029 0a2a 2073 6869 7368 695f 7072 6976  0).* shishi_priv
│ │ │ │ +00017a60: 5f72 6561 643a 2020 2020 2020 2020 2020  _read:          
│ │ │ │ +00017a70: 2020 2020 2020 2020 2020 2020 5341 4645              SAFE
│ │ │ │ +00017a80: 2061 6e64 2050 5249 5620 4675 6e63 7469   and PRIV Functi
│ │ │ │ +00017a90: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │  00017aa0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00017ab0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00017ac0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00017ad0: 2028 6c69 6e65 2020 3533 3129 0a2a 2073   (line  531).* s
│ │ │ │ -00017ae0: 6869 7368 695f 7072 6976 5f73 6176 653a  hishi_priv_save:
│ │ │ │ -00017af0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00017b00: 2020 2020 2020 5341 4645 2061 6e64 2050        SAFE and P
│ │ │ │ -00017b10: 5249 5620 4675 6e63 7469 6f6e 732e 0a20  RIV Functions.. 
│ │ │ │ +00017ad0: 2020 286c 696e 6520 2035 3331 290a 2a20    (line  531).* 
│ │ │ │ +00017ae0: 7368 6973 6869 5f70 7269 765f 7361 7665  shishi_priv_save
│ │ │ │ +00017af0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ +00017b00: 2020 2020 2020 2053 4146 4520 616e 6420         SAFE and 
│ │ │ │ +00017b10: 5052 4956 2046 756e 6374 696f 6e73 2e0a  PRIV Functions..
│ │ │ │  00017b20: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00017b30: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00017b40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00017b50: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ -00017b60: 6520 2034 3838 290a 2a20 7368 6973 6869  e  488).* shishi
│ │ │ │ -00017b70: 5f70 7269 765f 7365 745f 656e 635f 7061  _priv_set_enc_pa
│ │ │ │ -00017b80: 7274 3a20 2020 2020 2020 2020 2020 2020  rt:             
│ │ │ │ -00017b90: 2053 4146 4520 616e 6420 5052 4956 2046   SAFE and PRIV F
│ │ │ │ -00017ba0: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │ +00017b50: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ +00017b60: 6e65 2020 3438 3829 0a2a 2073 6869 7368  ne  488).* shish
│ │ │ │ +00017b70: 695f 7072 6976 5f73 6574 5f65 6e63 5f70  i_priv_set_enc_p
│ │ │ │ +00017b80: 6172 743a 2020 2020 2020 2020 2020 2020  art:            
│ │ │ │ +00017b90: 2020 5341 4645 2061 6e64 2050 5249 5620    SAFE and PRIV 
│ │ │ │ +00017ba0: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │  00017bb0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00017bc0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00017bd0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00017be0: 2020 2020 2020 2028 6c69 6e65 2020 3537         (line  57
│ │ │ │ -00017bf0: 3329 0a2a 2073 6869 7368 695f 7072 6976  3).* shishi_priv
│ │ │ │ -00017c00: 5f74 6f5f 6669 6c65 3a20 2020 2020 2020  _to_file:       
│ │ │ │ -00017c10: 2020 2020 2020 2020 2020 2020 5341 4645              SAFE
│ │ │ │ -00017c20: 2061 6e64 2050 5249 5620 4675 6e63 7469   and PRIV Functi
│ │ │ │ -00017c30: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │ +00017be0: 2020 2020 2020 2020 286c 696e 6520 2035          (line  5
│ │ │ │ +00017bf0: 3733 290a 2a20 7368 6973 6869 5f70 7269  73).* shishi_pri
│ │ │ │ +00017c00: 765f 746f 5f66 696c 653a 2020 2020 2020  v_to_file:      
│ │ │ │ +00017c10: 2020 2020 2020 2020 2020 2020 2053 4146               SAF
│ │ │ │ +00017c20: 4520 616e 6420 5052 4956 2046 756e 6374  E and PRIV Funct
│ │ │ │ +00017c30: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │  00017c40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00017c50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00017c60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00017c70: 2020 286c 696e 6520 2035 3031 290a 2a20    (line  501).* 
│ │ │ │ -00017c80: 7368 6973 6869 5f70 726f 6d70 745f 7061  shishi_prompt_pa
│ │ │ │ -00017c90: 7373 776f 7264 3a20 2020 2020 2020 2020  ssword:         
│ │ │ │ -00017ca0: 2020 2020 2020 2055 7469 6c69 7479 2046         Utility F
│ │ │ │ -00017cb0: 756e 6374 696f 6e73 2e20 2028 6c69 6e65  unctions.  (line
│ │ │ │ -00017cc0: 2020 3438 3029 0a2a 2073 6869 7368 695f    480).* shishi_
│ │ │ │ -00017cd0: 7072 6f6d 7074 5f70 6173 7377 6f72 645f  prompt_password_
│ │ │ │ -00017ce0: 6361 6c6c 6261 636b 5f67 6574 3a20 2020  callback_get:   
│ │ │ │ -00017cf0: 5574 696c 6974 7920 4675 6e63 7469 6f6e  Utility Function
│ │ │ │ -00017d00: 732e 2020 286c 696e 6520 2034 3637 290a  s.  (line  467).
│ │ │ │ -00017d10: 2a20 7368 6973 6869 5f70 726f 6d70 745f  * shishi_prompt_
│ │ │ │ -00017d20: 7061 7373 776f 7264 5f63 616c 6c62 6163  password_callbac
│ │ │ │ -00017d30: 6b5f 7365 743a 2020 2055 7469 6c69 7479  k_set:   Utility
│ │ │ │ -00017d40: 2046 756e 6374 696f 6e73 2e20 2028 6c69   Functions.  (li
│ │ │ │ -00017d50: 6e65 2020 3434 3429 0a2a 2073 6869 7368  ne  444).* shish
│ │ │ │ -00017d60: 695f 7261 6e64 6f6d 5f74 6f5f 6b65 793a  i_random_to_key:
│ │ │ │ -00017d70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00017d80: 2020 4372 7970 746f 6772 6170 6869 6320    Cryptographic 
│ │ │ │ -00017d90: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │ +00017c70: 2020 2028 6c69 6e65 2020 3530 3129 0a2a     (line  501).*
│ │ │ │ +00017c80: 2073 6869 7368 695f 7072 6f6d 7074 5f70   shishi_prompt_p
│ │ │ │ +00017c90: 6173 7377 6f72 643a 2020 2020 2020 2020  assword:        
│ │ │ │ +00017ca0: 2020 2020 2020 2020 5574 696c 6974 7920          Utility 
│ │ │ │ +00017cb0: 4675 6e63 7469 6f6e 732e 2020 286c 696e  Functions.  (lin
│ │ │ │ +00017cc0: 6520 2034 3830 290a 2a20 7368 6973 6869  e  480).* shishi
│ │ │ │ +00017cd0: 5f70 726f 6d70 745f 7061 7373 776f 7264  _prompt_password
│ │ │ │ +00017ce0: 5f63 616c 6c62 6163 6b5f 6765 743a 2020  _callback_get:  
│ │ │ │ +00017cf0: 2055 7469 6c69 7479 2046 756e 6374 696f   Utility Functio
│ │ │ │ +00017d00: 6e73 2e20 2028 6c69 6e65 2020 3436 3729  ns.  (line  467)
│ │ │ │ +00017d10: 0a2a 2073 6869 7368 695f 7072 6f6d 7074  .* shishi_prompt
│ │ │ │ +00017d20: 5f70 6173 7377 6f72 645f 6361 6c6c 6261  _password_callba
│ │ │ │ +00017d30: 636b 5f73 6574 3a20 2020 5574 696c 6974  ck_set:   Utilit
│ │ │ │ +00017d40: 7920 4675 6e63 7469 6f6e 732e 2020 286c  y Functions.  (l
│ │ │ │ +00017d50: 696e 6520 2034 3434 290a 2a20 7368 6973  ine  444).* shis
│ │ │ │ +00017d60: 6869 5f72 616e 646f 6d5f 746f 5f6b 6579  hi_random_to_key
│ │ │ │ +00017d70: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ +00017d80: 2020 2043 7279 7074 6f67 7261 7068 6963     Cryptographic
│ │ │ │ +00017d90: 2046 756e 6374 696f 6e73 2e0a 2020 2020   Functions..    
│ │ │ │  00017da0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00017db0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00017dc0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00017dd0: 2020 2020 2020 2020 286c 696e 6520 2037          (line  7
│ │ │ │ -00017de0: 3630 290a 2a20 7368 6973 6869 5f72 616e  60).* shishi_ran
│ │ │ │ -00017df0: 646f 6d69 7a65 3a20 2020 2020 2020 2020  domize:         
│ │ │ │ -00017e00: 2020 2020 2020 2020 2020 2020 2043 7279               Cry
│ │ │ │ -00017e10: 7074 6f67 7261 7068 6963 2046 756e 6374  ptographic Funct
│ │ │ │ -00017e20: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │ +00017dd0: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ +00017de0: 3736 3029 0a2a 2073 6869 7368 695f 7261  760).* shishi_ra
│ │ │ │ +00017df0: 6e64 6f6d 697a 653a 2020 2020 2020 2020  ndomize:        
│ │ │ │ +00017e00: 2020 2020 2020 2020 2020 2020 2020 4372                Cr
│ │ │ │ +00017e10: 7970 746f 6772 6170 6869 6320 4675 6e63  yptographic Func
│ │ │ │ +00017e20: 7469 6f6e 732e 0a20 2020 2020 2020 2020  tions..         
│ │ │ │  00017e30: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00017e40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00017e50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00017e60: 2020 2028 6c69 6e65 2031 3339 3029 0a2a     (line 1390).*
│ │ │ │ -00017e70: 2073 6869 7368 695f 7265 616c 6d5f 6465   shishi_realm_de
│ │ │ │ -00017e80: 6661 756c 743a 2020 2020 2020 2020 2020  fault:          
│ │ │ │ -00017e90: 2020 2020 2020 2020 5574 696c 6974 7920          Utility 
│ │ │ │ -00017ea0: 4675 6e63 7469 6f6e 732e 2020 286c 696e  Functions.  (lin
│ │ │ │ -00017eb0: 6520 2020 3333 290a 2a20 7368 6973 6869  e   33).* shishi
│ │ │ │ -00017ec0: 5f72 6561 6c6d 5f64 6566 6175 6c74 5f67  _realm_default_g
│ │ │ │ -00017ed0: 7565 7373 3a20 2020 2020 2020 2020 2020  uess:           
│ │ │ │ -00017ee0: 2055 7469 6c69 7479 2046 756e 6374 696f   Utility Functio
│ │ │ │ -00017ef0: 6e73 2e20 2028 6c69 6e65 2020 2020 3929  ns.  (line    9)
│ │ │ │ -00017f00: 0a2a 2073 6869 7368 695f 7265 616c 6d5f  .* shishi_realm_
│ │ │ │ -00017f10: 6465 6661 756c 745f 7365 743a 2020 2020  default_set:    
│ │ │ │ -00017f20: 2020 2020 2020 2020 2020 5574 696c 6974            Utilit
│ │ │ │ -00017f30: 7920 4675 6e63 7469 6f6e 732e 2020 286c  y Functions.  (l
│ │ │ │ -00017f40: 696e 6520 2020 3436 290a 2a20 7368 6973  ine   46).* shis
│ │ │ │ -00017f50: 6869 5f72 6561 6c6d 5f66 6f72 5f73 6572  hi_realm_for_ser
│ │ │ │ -00017f60: 7665 723a 2020 2020 2020 2020 2020 2020  ver:            
│ │ │ │ -00017f70: 2020 2055 7469 6c69 7479 2046 756e 6374     Utility Funct
│ │ │ │ -00017f80: 696f 6e73 2e20 2028 6c69 6e65 2020 3131  ions.  (line  11
│ │ │ │ -00017f90: 3429 0a2a 2073 6869 7368 695f 7265 616c  4).* shishi_real
│ │ │ │ -00017fa0: 6d5f 666f 725f 7365 7276 6572 5f64 6e73  m_for_server_dns
│ │ │ │ -00017fb0: 3a20 2020 2020 2020 2020 2020 5574 696c  :           Util
│ │ │ │ -00017fc0: 6974 7920 4675 6e63 7469 6f6e 732e 2020  ity Functions.  
│ │ │ │ -00017fd0: 286c 696e 6520 2020 3734 290a 2a20 7368  (line   74).* sh
│ │ │ │ -00017fe0: 6973 6869 5f72 6561 6c6d 5f66 6f72 5f73  ishi_realm_for_s
│ │ │ │ -00017ff0: 6572 7665 725f 6669 6c65 3a20 2020 2020  erver_file:     
│ │ │ │ -00018000: 2020 2020 2055 7469 6c69 7479 2046 756e       Utility Fun
│ │ │ │ -00018010: 6374 696f 6e73 2e20 2028 6c69 6e65 2020  ctions.  (line  
│ │ │ │ -00018020: 2036 3129 0a2a 2073 6869 7368 695f 7265   61).* shishi_re
│ │ │ │ -00018030: 736f 6c76 3a20 2020 2020 2020 2020 2020  solv:           
│ │ │ │ -00018040: 2020 2020 2020 2020 2020 2020 2020 5574                Ut
│ │ │ │ -00018050: 696c 6974 7920 4675 6e63 7469 6f6e 732e  ility Functions.
│ │ │ │ -00018060: 2020 286c 696e 6520 2034 3937 290a 2a20    (line  497).* 
│ │ │ │ -00018070: 7368 6973 6869 5f72 6573 6f6c 765f 6672  shishi_resolv_fr
│ │ │ │ -00018080: 6565 3a20 2020 2020 2020 2020 2020 2020  ee:             
│ │ │ │ -00018090: 2020 2020 2020 2055 7469 6c69 7479 2046         Utility F
│ │ │ │ -000180a0: 756e 6374 696f 6e73 2e20 2028 6c69 6e65  unctions.  (line
│ │ │ │ -000180b0: 2020 3531 3529 0a2a 2073 6869 7368 695f    515).* shishi_
│ │ │ │ -000180c0: 7361 6665 3a20 2020 2020 2020 2020 2020  safe:           
│ │ │ │ +00017e60: 2020 2020 286c 696e 6520 3133 3930 290a      (line 1390).
│ │ │ │ +00017e70: 2a20 7368 6973 6869 5f72 6561 6c6d 5f64  * shishi_realm_d
│ │ │ │ +00017e80: 6566 6175 6c74 3a20 2020 2020 2020 2020  efault:         
│ │ │ │ +00017e90: 2020 2020 2020 2020 2055 7469 6c69 7479           Utility
│ │ │ │ +00017ea0: 2046 756e 6374 696f 6e73 2e20 2028 6c69   Functions.  (li
│ │ │ │ +00017eb0: 6e65 2020 2033 3329 0a2a 2073 6869 7368  ne   33).* shish
│ │ │ │ +00017ec0: 695f 7265 616c 6d5f 6465 6661 756c 745f  i_realm_default_
│ │ │ │ +00017ed0: 6775 6573 733a 2020 2020 2020 2020 2020  guess:          
│ │ │ │ +00017ee0: 2020 5574 696c 6974 7920 4675 6e63 7469    Utility Functi
│ │ │ │ +00017ef0: 6f6e 732e 2020 286c 696e 6520 2020 2039  ons.  (line    9
│ │ │ │ +00017f00: 290a 2a20 7368 6973 6869 5f72 6561 6c6d  ).* shishi_realm
│ │ │ │ +00017f10: 5f64 6566 6175 6c74 5f73 6574 3a20 2020  _default_set:   
│ │ │ │ +00017f20: 2020 2020 2020 2020 2020 2055 7469 6c69             Utili
│ │ │ │ +00017f30: 7479 2046 756e 6374 696f 6e73 2e20 2028  ty Functions.  (
│ │ │ │ +00017f40: 6c69 6e65 2020 2034 3629 0a2a 2073 6869  line   46).* shi
│ │ │ │ +00017f50: 7368 695f 7265 616c 6d5f 666f 725f 7365  shi_realm_for_se
│ │ │ │ +00017f60: 7276 6572 3a20 2020 2020 2020 2020 2020  rver:           
│ │ │ │ +00017f70: 2020 2020 5574 696c 6974 7920 4675 6e63      Utility Func
│ │ │ │ +00017f80: 7469 6f6e 732e 2020 286c 696e 6520 2031  tions.  (line  1
│ │ │ │ +00017f90: 3134 290a 2a20 7368 6973 6869 5f72 6561  14).* shishi_rea
│ │ │ │ +00017fa0: 6c6d 5f66 6f72 5f73 6572 7665 725f 646e  lm_for_server_dn
│ │ │ │ +00017fb0: 733a 2020 2020 2020 2020 2020 2055 7469  s:           Uti
│ │ │ │ +00017fc0: 6c69 7479 2046 756e 6374 696f 6e73 2e20  lity Functions. 
│ │ │ │ +00017fd0: 2028 6c69 6e65 2020 2037 3429 0a2a 2073   (line   74).* s
│ │ │ │ +00017fe0: 6869 7368 695f 7265 616c 6d5f 666f 725f  hishi_realm_for_
│ │ │ │ +00017ff0: 7365 7276 6572 5f66 696c 653a 2020 2020  server_file:    
│ │ │ │ +00018000: 2020 2020 2020 5574 696c 6974 7920 4675        Utility Fu
│ │ │ │ +00018010: 6e63 7469 6f6e 732e 2020 286c 696e 6520  nctions.  (line 
│ │ │ │ +00018020: 2020 3631 290a 2a20 7368 6973 6869 5f72    61).* shishi_r
│ │ │ │ +00018030: 6573 6f6c 763a 2020 2020 2020 2020 2020  esolv:          
│ │ │ │ +00018040: 2020 2020 2020 2020 2020 2020 2020 2055                 U
│ │ │ │ +00018050: 7469 6c69 7479 2046 756e 6374 696f 6e73  tility Functions
│ │ │ │ +00018060: 2e20 2028 6c69 6e65 2020 3439 3729 0a2a  .  (line  497).*
│ │ │ │ +00018070: 2073 6869 7368 695f 7265 736f 6c76 5f66   shishi_resolv_f
│ │ │ │ +00018080: 7265 653a 2020 2020 2020 2020 2020 2020  ree:            
│ │ │ │ +00018090: 2020 2020 2020 2020 5574 696c 6974 7920          Utility 
│ │ │ │ +000180a0: 4675 6e63 7469 6f6e 732e 2020 286c 696e  Functions.  (lin
│ │ │ │ +000180b0: 6520 2035 3135 290a 2a20 7368 6973 6869  e  515).* shishi
│ │ │ │ +000180c0: 5f73 6166 653a 2020 2020 2020 2020 2020  _safe:          
│ │ │ │  000180d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000180e0: 5341 4645 2061 6e64 2050 5249 5620 4675  SAFE and PRIV Fu
│ │ │ │ -000180f0: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │ +000180e0: 2053 4146 4520 616e 6420 5052 4956 2046   SAFE and PRIV F
│ │ │ │ +000180f0: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │  00018100: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00018110: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00018120: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00018130: 2020 2020 2020 286c 696e 6520 2020 3331        (line   31
│ │ │ │ -00018140: 290a 2a20 7368 6973 6869 5f73 6166 655f  ).* shishi_safe_
│ │ │ │ -00018150: 6275 696c 643a 2020 2020 2020 2020 2020  build:          
│ │ │ │ -00018160: 2020 2020 2020 2020 2020 2053 4146 4520             SAFE 
│ │ │ │ -00018170: 616e 6420 5052 4956 2046 756e 6374 696f  and PRIV Functio
│ │ │ │ -00018180: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │ +00018130: 2020 2020 2020 2028 6c69 6e65 2020 2033         (line   3
│ │ │ │ +00018140: 3129 0a2a 2073 6869 7368 695f 7361 6665  1).* shishi_safe
│ │ │ │ +00018150: 5f62 7569 6c64 3a20 2020 2020 2020 2020  _build:         
│ │ │ │ +00018160: 2020 2020 2020 2020 2020 2020 5341 4645              SAFE
│ │ │ │ +00018170: 2061 6e64 2050 5249 5620 4675 6e63 7469   and PRIV Functi
│ │ │ │ +00018180: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │  00018190: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000181a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000181b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000181c0: 2028 6c69 6e65 2020 3237 3829 0a2a 2073   (line  278).* s
│ │ │ │ -000181d0: 6869 7368 695f 7361 6665 5f63 6b73 756d  hishi_safe_cksum
│ │ │ │ -000181e0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ -000181f0: 2020 2020 2020 5341 4645 2061 6e64 2050        SAFE and P
│ │ │ │ -00018200: 5249 5620 4675 6e63 7469 6f6e 732e 0a20  RIV Functions.. 
│ │ │ │ +000181c0: 2020 286c 696e 6520 2032 3738 290a 2a20    (line  278).* 
│ │ │ │ +000181d0: 7368 6973 6869 5f73 6166 655f 636b 7375  shishi_safe_cksu
│ │ │ │ +000181e0: 6d3a 2020 2020 2020 2020 2020 2020 2020  m:              
│ │ │ │ +000181f0: 2020 2020 2020 2053 4146 4520 616e 6420         SAFE and 
│ │ │ │ +00018200: 5052 4956 2046 756e 6374 696f 6e73 2e0a  PRIV Functions..
│ │ │ │  00018210: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00018220: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00018230: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00018240: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ -00018250: 6520 2032 3130 290a 2a20 7368 6973 6869  e  210).* shishi
│ │ │ │ -00018260: 5f73 6166 655f 646f 6e65 3a20 2020 2020  _safe_done:     
│ │ │ │ +00018240: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ +00018250: 6e65 2020 3231 3029 0a2a 2073 6869 7368  ne  210).* shish
│ │ │ │ +00018260: 695f 7361 6665 5f64 6f6e 653a 2020 2020  i_safe_done:    
│ │ │ │  00018270: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00018280: 2053 4146 4520 616e 6420 5052 4956 2046   SAFE and PRIV F
│ │ │ │ -00018290: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │ +00018280: 2020 5341 4645 2061 6e64 2050 5249 5620    SAFE and PRIV 
│ │ │ │ +00018290: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │  000182a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000182b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000182c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000182d0: 2020 2020 2020 2028 6c69 6e65 2020 2034         (line   4
│ │ │ │ -000182e0: 3329 0a2a 2073 6869 7368 695f 7361 6665  3).* shishi_safe
│ │ │ │ -000182f0: 5f66 726f 6d5f 6669 6c65 3a20 2020 2020  _from_file:     
│ │ │ │ -00018300: 2020 2020 2020 2020 2020 2020 5341 4645              SAFE
│ │ │ │ -00018310: 2061 6e64 2050 5249 5620 4675 6e63 7469   and PRIV Functi
│ │ │ │ -00018320: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │ +000182d0: 2020 2020 2020 2020 286c 696e 6520 2020          (line   
│ │ │ │ +000182e0: 3433 290a 2a20 7368 6973 6869 5f73 6166  43).* shishi_saf
│ │ │ │ +000182f0: 655f 6672 6f6d 5f66 696c 653a 2020 2020  e_from_file:    
│ │ │ │ +00018300: 2020 2020 2020 2020 2020 2020 2053 4146               SAF
│ │ │ │ +00018310: 4520 616e 6420 5052 4956 2046 756e 6374  E and PRIV Funct
│ │ │ │ +00018320: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │  00018330: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00018340: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00018350: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00018360: 2020 286c 696e 6520 2031 3935 290a 2a20    (line  195).* 
│ │ │ │ -00018370: 7368 6973 6869 5f73 6166 655f 6b65 793a  shishi_safe_key:
│ │ │ │ -00018380: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00018390: 2020 2020 2020 2053 4146 4520 616e 6420         SAFE and 
│ │ │ │ -000183a0: 5052 4956 2046 756e 6374 696f 6e73 2e0a  PRIV Functions..
│ │ │ │ -000183b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +00018360: 2020 2028 6c69 6e65 2020 3139 3529 0a2a     (line  195).*
│ │ │ │ +00018370: 2073 6869 7368 695f 7361 6665 5f6b 6579   shishi_safe_key
│ │ │ │ +00018380: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ +00018390: 2020 2020 2020 2020 5341 4645 2061 6e64          SAFE and
│ │ │ │ +000183a0: 2050 5249 5620 4675 6e63 7469 6f6e 732e   PRIV Functions.
│ │ │ │ +000183b0: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │  000183c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000183d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000183e0: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ -000183f0: 6e65 2020 2035 3329 0a2a 2073 6869 7368  ne   53).* shish
│ │ │ │ -00018400: 695f 7361 6665 5f6b 6579 5f73 6574 3a20  i_safe_key_set: 
│ │ │ │ +000183e0: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ +000183f0: 696e 6520 2020 3533 290a 2a20 7368 6973  ine   53).* shis
│ │ │ │ +00018400: 6869 5f73 6166 655f 6b65 795f 7365 743a  hi_safe_key_set:
│ │ │ │  00018410: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00018420: 2020 5341 4645 2061 6e64 2050 5249 5620    SAFE and PRIV 
│ │ │ │ -00018430: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │ +00018420: 2020 2053 4146 4520 616e 6420 5052 4956     SAFE and PRIV
│ │ │ │ +00018430: 2046 756e 6374 696f 6e73 2e0a 2020 2020   Functions..    
│ │ │ │  00018440: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00018450: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00018460: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00018470: 2020 2020 2020 2020 286c 696e 6520 2020          (line   
│ │ │ │ -00018480: 3634 290a 2a20 7368 6973 6869 5f73 6166  64).* shishi_saf
│ │ │ │ -00018490: 655f 7061 7273 653a 2020 2020 2020 2020  e_parse:        
│ │ │ │ -000184a0: 2020 2020 2020 2020 2020 2020 2053 4146               SAF
│ │ │ │ -000184b0: 4520 616e 6420 5052 4956 2046 756e 6374  E and PRIV Funct
│ │ │ │ -000184c0: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │ +00018470: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ +00018480: 2036 3429 0a2a 2073 6869 7368 695f 7361   64).* shishi_sa
│ │ │ │ +00018490: 6665 5f70 6172 7365 3a20 2020 2020 2020  fe_parse:       
│ │ │ │ +000184a0: 2020 2020 2020 2020 2020 2020 2020 5341                SA
│ │ │ │ +000184b0: 4645 2061 6e64 2050 5249 5620 4675 6e63  FE and PRIV Func
│ │ │ │ +000184c0: 7469 6f6e 732e 0a20 2020 2020 2020 2020  tions..         
│ │ │ │  000184d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000184e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000184f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00018500: 2020 2028 6c69 6e65 2020 3136 3729 0a2a     (line  167).*
│ │ │ │ -00018510: 2073 6869 7368 695f 7361 6665 5f70 7269   shishi_safe_pri
│ │ │ │ -00018520: 6e74 3a20 2020 2020 2020 2020 2020 2020  nt:             
│ │ │ │ -00018530: 2020 2020 2020 2020 5341 4645 2061 6e64          SAFE and
│ │ │ │ -00018540: 2050 5249 5620 4675 6e63 7469 6f6e 732e   PRIV Functions.
│ │ │ │ -00018550: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ +00018500: 2020 2020 286c 696e 6520 2031 3637 290a      (line  167).
│ │ │ │ +00018510: 2a20 7368 6973 6869 5f73 6166 655f 7072  * shishi_safe_pr
│ │ │ │ +00018520: 696e 743a 2020 2020 2020 2020 2020 2020  int:            
│ │ │ │ +00018530: 2020 2020 2020 2020 2053 4146 4520 616e           SAFE an
│ │ │ │ +00018540: 6420 5052 4956 2046 756e 6374 696f 6e73  d PRIV Functions
│ │ │ │ +00018550: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │  00018560: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00018570: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00018580: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ -00018590: 696e 6520 2031 3235 290a 2a20 7368 6973  ine  125).* shis
│ │ │ │ -000185a0: 6869 5f73 6166 655f 7265 6164 3a20 2020  hi_safe_read:   
│ │ │ │ +00018580: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ +00018590: 6c69 6e65 2020 3132 3529 0a2a 2073 6869  line  125).* shi
│ │ │ │ +000185a0: 7368 695f 7361 6665 5f72 6561 643a 2020  shi_safe_read:  
│ │ │ │  000185b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000185c0: 2020 2053 4146 4520 616e 6420 5052 4956     SAFE and PRIV
│ │ │ │ -000185d0: 2046 756e 6374 696f 6e73 2e0a 2020 2020   Functions..    
│ │ │ │ +000185c0: 2020 2020 5341 4645 2061 6e64 2050 5249      SAFE and PRI
│ │ │ │ +000185d0: 5620 4675 6e63 7469 6f6e 732e 0a20 2020  V Functions..   
│ │ │ │  000185e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000185f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00018600: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00018610: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ -00018620: 3138 3129 0a2a 2073 6869 7368 695f 7361  181).* shishi_sa
│ │ │ │ -00018630: 6665 5f73 6166 653a 2020 2020 2020 2020  fe_safe:        
│ │ │ │ -00018640: 2020 2020 2020 2020 2020 2020 2020 5341                SA
│ │ │ │ -00018650: 4645 2061 6e64 2050 5249 5620 4675 6e63  FE and PRIV Func
│ │ │ │ -00018660: 7469 6f6e 732e 0a20 2020 2020 2020 2020  tions..         
│ │ │ │ +00018610: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ +00018620: 2031 3831 290a 2a20 7368 6973 6869 5f73   181).* shishi_s
│ │ │ │ +00018630: 6166 655f 7361 6665 3a20 2020 2020 2020  afe_safe:       
│ │ │ │ +00018640: 2020 2020 2020 2020 2020 2020 2020 2053                 S
│ │ │ │ +00018650: 4146 4520 616e 6420 5052 4956 2046 756e  AFE and PRIV Fun
│ │ │ │ +00018660: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │  00018670: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00018680: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00018690: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000186a0: 2020 2020 286c 696e 6520 2020 3734 290a      (line   74).
│ │ │ │ -000186b0: 2a20 7368 6973 6869 5f73 6166 655f 7361  * shishi_safe_sa
│ │ │ │ -000186c0: 6665 5f64 6572 3a20 2020 2020 2020 2020  fe_der:         
│ │ │ │ -000186d0: 2020 2020 2020 2020 2053 4146 4520 616e           SAFE an
│ │ │ │ -000186e0: 6420 5052 4956 2046 756e 6374 696f 6e73  d PRIV Functions
│ │ │ │ -000186f0: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │ +000186a0: 2020 2020 2028 6c69 6e65 2020 2037 3429       (line   74)
│ │ │ │ +000186b0: 0a2a 2073 6869 7368 695f 7361 6665 5f73  .* shishi_safe_s
│ │ │ │ +000186c0: 6166 655f 6465 723a 2020 2020 2020 2020  afe_der:        
│ │ │ │ +000186d0: 2020 2020 2020 2020 2020 5341 4645 2061            SAFE a
│ │ │ │ +000186e0: 6e64 2050 5249 5620 4675 6e63 7469 6f6e  nd PRIV Function
│ │ │ │ +000186f0: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │  00018700: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00018710: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00018720: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ -00018730: 6c69 6e65 2020 2039 3529 0a2a 2073 6869  line   95).* shi
│ │ │ │ -00018740: 7368 695f 7361 6665 5f73 6166 655f 6465  shi_safe_safe_de
│ │ │ │ -00018750: 725f 7365 743a 2020 2020 2020 2020 2020  r_set:          
│ │ │ │ -00018760: 2020 2020 5341 4645 2061 6e64 2050 5249      SAFE and PRI
│ │ │ │ -00018770: 5620 4675 6e63 7469 6f6e 732e 0a20 2020  V Functions..   
│ │ │ │ +00018720: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +00018730: 286c 696e 6520 2020 3935 290a 2a20 7368  (line   95).* sh
│ │ │ │ +00018740: 6973 6869 5f73 6166 655f 7361 6665 5f64  ishi_safe_safe_d
│ │ │ │ +00018750: 6572 5f73 6574 3a20 2020 2020 2020 2020  er_set:         
│ │ │ │ +00018760: 2020 2020 2053 4146 4520 616e 6420 5052       SAFE and PR
│ │ │ │ +00018770: 4956 2046 756e 6374 696f 6e73 2e0a 2020  IV Functions..  
│ │ │ │  00018780: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00018790: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000187a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000187b0: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ -000187c0: 2031 3131 290a 2a20 7368 6973 6869 5f73   111).* shishi_s
│ │ │ │ -000187d0: 6166 655f 7361 6665 5f73 6574 3a20 2020  afe_safe_set:   
│ │ │ │ -000187e0: 2020 2020 2020 2020 2020 2020 2020 2053                 S
│ │ │ │ -000187f0: 4146 4520 616e 6420 5052 4956 2046 756e  AFE and PRIV Fun
│ │ │ │ -00018800: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │ +000187b0: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ +000187c0: 2020 3131 3129 0a2a 2073 6869 7368 695f    111).* shishi_
│ │ │ │ +000187d0: 7361 6665 5f73 6166 655f 7365 743a 2020  safe_safe_set:  
│ │ │ │ +000187e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +000187f0: 5341 4645 2061 6e64 2050 5249 5620 4675  SAFE and PRIV Fu
│ │ │ │ +00018800: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │  00018810: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00018820: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00018830: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00018840: 2020 2020 2028 6c69 6e65 2020 2038 3529       (line   85)
│ │ │ │ -00018850: 0a2a 2073 6869 7368 695f 7361 6665 5f73  .* shishi_safe_s
│ │ │ │ -00018860: 6176 653a 2020 2020 2020 2020 2020 2020  ave:            
│ │ │ │ -00018870: 2020 2020 2020 2020 2020 5341 4645 2061            SAFE a
│ │ │ │ -00018880: 6e64 2050 5249 5620 4675 6e63 7469 6f6e  nd PRIV Function
│ │ │ │ -00018890: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │ +00018840: 2020 2020 2020 286c 696e 6520 2020 3835        (line   85
│ │ │ │ +00018850: 290a 2a20 7368 6973 6869 5f73 6166 655f  ).* shishi_safe_
│ │ │ │ +00018860: 7361 7665 3a20 2020 2020 2020 2020 2020  save:           
│ │ │ │ +00018870: 2020 2020 2020 2020 2020 2053 4146 4520             SAFE 
│ │ │ │ +00018880: 616e 6420 5052 4956 2046 756e 6374 696f  and PRIV Functio
│ │ │ │ +00018890: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │  000188a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000188b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000188c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000188d0: 286c 696e 6520 2031 3338 290a 2a20 7368  (line  138).* sh
│ │ │ │ -000188e0: 6973 6869 5f73 6166 655f 7365 745f 636b  ishi_safe_set_ck
│ │ │ │ -000188f0: 7375 6d3a 2020 2020 2020 2020 2020 2020  sum:            
│ │ │ │ -00018900: 2020 2020 2053 4146 4520 616e 6420 5052       SAFE and PR
│ │ │ │ -00018910: 4956 2046 756e 6374 696f 6e73 2e0a 2020  IV Functions..  
│ │ │ │ +000188d0: 2028 6c69 6e65 2020 3133 3829 0a2a 2073   (line  138).* s
│ │ │ │ +000188e0: 6869 7368 695f 7361 6665 5f73 6574 5f63  hishi_safe_set_c
│ │ │ │ +000188f0: 6b73 756d 3a20 2020 2020 2020 2020 2020  ksum:           
│ │ │ │ +00018900: 2020 2020 2020 5341 4645 2061 6e64 2050        SAFE and P
│ │ │ │ +00018910: 5249 5620 4675 6e63 7469 6f6e 732e 0a20  RIV Functions.. 
│ │ │ │  00018920: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00018930: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00018940: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00018950: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ -00018960: 2020 3232 3729 0a2a 2073 6869 7368 695f    227).* shishi_
│ │ │ │ -00018970: 7361 6665 5f73 6574 5f75 7365 725f 6461  safe_set_user_da
│ │ │ │ -00018980: 7461 3a20 2020 2020 2020 2020 2020 2020  ta:             
│ │ │ │ -00018990: 5341 4645 2061 6e64 2050 5249 5620 4675  SAFE and PRIV Fu
│ │ │ │ -000189a0: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │ +00018950: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ +00018960: 6520 2032 3237 290a 2a20 7368 6973 6869  e  227).* shishi
│ │ │ │ +00018970: 5f73 6166 655f 7365 745f 7573 6572 5f64  _safe_set_user_d
│ │ │ │ +00018980: 6174 613a 2020 2020 2020 2020 2020 2020  ata:            
│ │ │ │ +00018990: 2053 4146 4520 616e 6420 5052 4956 2046   SAFE and PRIV F
│ │ │ │ +000189a0: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │  000189b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000189c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000189d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000189e0: 2020 2020 2020 286c 696e 6520 2032 3634        (line  264
│ │ │ │ -000189f0: 290a 2a20 7368 6973 6869 5f73 6166 655f  ).* shishi_safe_
│ │ │ │ -00018a00: 746f 5f66 696c 653a 2020 2020 2020 2020  to_file:        
│ │ │ │ -00018a10: 2020 2020 2020 2020 2020 2053 4146 4520             SAFE 
│ │ │ │ -00018a20: 616e 6420 5052 4956 2046 756e 6374 696f  and PRIV Functio
│ │ │ │ -00018a30: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │ +000189e0: 2020 2020 2020 2028 6c69 6e65 2020 3236         (line  26
│ │ │ │ +000189f0: 3429 0a2a 2073 6869 7368 695f 7361 6665  4).* shishi_safe
│ │ │ │ +00018a00: 5f74 6f5f 6669 6c65 3a20 2020 2020 2020  _to_file:       
│ │ │ │ +00018a10: 2020 2020 2020 2020 2020 2020 5341 4645              SAFE
│ │ │ │ +00018a20: 2061 6e64 2050 5249 5620 4675 6e63 7469   and PRIV Functi
│ │ │ │ +00018a30: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │  00018a40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00018a50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00018a60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00018a70: 2028 6c69 6e65 2020 3135 3129 0a2a 2073   (line  151).* s
│ │ │ │ -00018a80: 6869 7368 695f 7361 6665 5f75 7365 725f  hishi_safe_user_
│ │ │ │ -00018a90: 6461 7461 3a20 2020 2020 2020 2020 2020  data:           
│ │ │ │ -00018aa0: 2020 2020 2020 5341 4645 2061 6e64 2050        SAFE and P
│ │ │ │ -00018ab0: 5249 5620 4675 6e63 7469 6f6e 732e 0a20  RIV Functions.. 
│ │ │ │ +00018a70: 2020 286c 696e 6520 2031 3531 290a 2a20    (line  151).* 
│ │ │ │ +00018a80: 7368 6973 6869 5f73 6166 655f 7573 6572  shishi_safe_user
│ │ │ │ +00018a90: 5f64 6174 613a 2020 2020 2020 2020 2020  _data:          
│ │ │ │ +00018aa0: 2020 2020 2020 2053 4146 4520 616e 6420         SAFE and 
│ │ │ │ +00018ab0: 5052 4956 2046 756e 6374 696f 6e73 2e0a  PRIV Functions..
│ │ │ │  00018ac0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00018ad0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00018ae0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00018af0: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ -00018b00: 6520 2032 3437 290a 2a20 7368 6973 6869  e  247).* shishi
│ │ │ │ -00018b10: 5f73 6166 655f 7665 7269 6679 3a20 2020  _safe_verify:   
│ │ │ │ +00018af0: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ +00018b00: 6e65 2020 3234 3729 0a2a 2073 6869 7368  ne  247).* shish
│ │ │ │ +00018b10: 695f 7361 6665 5f76 6572 6966 793a 2020  i_safe_verify:  
│ │ │ │  00018b20: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00018b30: 2053 4146 4520 616e 6420 5052 4956 2046   SAFE and PRIV F
│ │ │ │ -00018b40: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │ +00018b30: 2020 5341 4645 2061 6e64 2050 5249 5620    SAFE and PRIV 
│ │ │ │ +00018b40: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │  00018b50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00018b60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00018b70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00018b80: 2020 2020 2020 2028 6c69 6e65 2020 3239         (line  29
│ │ │ │ -00018b90: 3229 0a2a 2073 6869 7368 695f 7365 7276  2).* shishi_serv
│ │ │ │ -00018ba0: 6572 3a20 2020 2020 2020 2020 2020 2020  er:             
│ │ │ │ -00018bb0: 2020 2020 2020 2020 2020 2020 496e 6974              Init
│ │ │ │ -00018bc0: 6961 6c69 7a61 7469 6f6e 2046 756e 6374  ialization Funct
│ │ │ │ -00018bd0: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │ +00018b80: 2020 2020 2020 2020 286c 696e 6520 2032          (line  2
│ │ │ │ +00018b90: 3932 290a 2a20 7368 6973 6869 5f73 6572  92).* shishi_ser
│ │ │ │ +00018ba0: 7665 723a 2020 2020 2020 2020 2020 2020  ver:            
│ │ │ │ +00018bb0: 2020 2020 2020 2020 2020 2020 2049 6e69               Ini
│ │ │ │ +00018bc0: 7469 616c 697a 6174 696f 6e20 4675 6e63  tialization Func
│ │ │ │ +00018bd0: 7469 6f6e 732e 0a20 2020 2020 2020 2020  tions..         
│ │ │ │  00018be0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00018bf0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00018c00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00018c10: 2020 2028 6c69 6e65 2020 2032 3229 0a2a     (line   22).*
│ │ │ │ -00018c20: 2073 6869 7368 695f 7365 7276 6572 5f66   shishi_server_f
│ │ │ │ -00018c30: 6f72 5f6c 6f63 616c 5f73 6572 7669 6365  or_local_service
│ │ │ │ -00018c40: 3a20 2020 2020 2020 5574 696c 6974 7920  :       Utility 
│ │ │ │ -00018c50: 4675 6e63 7469 6f6e 732e 2020 286c 696e  Functions.  (lin
│ │ │ │ -00018c60: 6520 2032 3839 290a 2a20 7368 6973 6869  e  289).* shishi
│ │ │ │ -00018c70: 5f73 7472 6572 726f 723a 2020 2020 2020  _strerror:      
│ │ │ │ +00018c10: 2020 2020 286c 696e 6520 2020 3232 290a      (line   22).
│ │ │ │ +00018c20: 2a20 7368 6973 6869 5f73 6572 7665 725f  * shishi_server_
│ │ │ │ +00018c30: 666f 725f 6c6f 6361 6c5f 7365 7276 6963  for_local_servic
│ │ │ │ +00018c40: 653a 2020 2020 2020 2055 7469 6c69 7479  e:       Utility
│ │ │ │ +00018c50: 2046 756e 6374 696f 6e73 2e20 2028 6c69   Functions.  (li
│ │ │ │ +00018c60: 6e65 2020 3238 3929 0a2a 2073 6869 7368  ne  289).* shish
│ │ │ │ +00018c70: 695f 7374 7265 7272 6f72 3a20 2020 2020  i_strerror:     
│ │ │ │  00018c80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00018c90: 2045 7272 6f72 2046 756e 6374 696f 6e73   Error Functions
│ │ │ │ -00018ca0: 2e20 2020 2028 6c69 6e65 2020 2020 3929  .    (line    9)
│ │ │ │ -00018cb0: 0a2a 2073 6869 7368 695f 7374 7269 6e67  .* shishi_string
│ │ │ │ -00018cc0: 5f74 6f5f 6b65 793a 2020 2020 2020 2020  _to_key:        
│ │ │ │ -00018cd0: 2020 2020 2020 2020 2020 4372 7970 746f            Crypto
│ │ │ │ -00018ce0: 6772 6170 6869 6320 4675 6e63 7469 6f6e  graphic Function
│ │ │ │ -00018cf0: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │ +00018c90: 2020 4572 726f 7220 4675 6e63 7469 6f6e    Error Function
│ │ │ │ +00018ca0: 732e 2020 2020 286c 696e 6520 2020 2039  s.    (line    9
│ │ │ │ +00018cb0: 290a 2a20 7368 6973 6869 5f73 7472 696e  ).* shishi_strin
│ │ │ │ +00018cc0: 675f 746f 5f6b 6579 3a20 2020 2020 2020  g_to_key:       
│ │ │ │ +00018cd0: 2020 2020 2020 2020 2020 2043 7279 7074             Crypt
│ │ │ │ +00018ce0: 6f67 7261 7068 6963 2046 756e 6374 696f  ographic Functio
│ │ │ │ +00018cf0: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │  00018d00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00018d10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00018d20: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00018d30: 286c 696e 6520 2037 3335 290a 2a20 7368  (line  735).* sh
│ │ │ │ -00018d40: 6973 6869 5f74 6773 3a20 2020 2020 2020  ishi_tgs:       
│ │ │ │ +00018d30: 2028 6c69 6e65 2020 3733 3529 0a2a 2073   (line  735).* s
│ │ │ │ +00018d40: 6869 7368 695f 7467 733a 2020 2020 2020  hishi_tgs:      
│ │ │ │  00018d50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00018d60: 2020 2020 2054 4753 2046 756e 6374 696f       TGS Functio
│ │ │ │ -00018d70: 6e73 2e20 2020 2020 2028 6c69 6e65 2020  ns.      (line  
│ │ │ │ -00018d80: 2038 3229 0a2a 2073 6869 7368 695f 7467   82).* shishi_tg
│ │ │ │ -00018d90: 735f 6170 3a20 2020 2020 2020 2020 2020  s_ap:           
│ │ │ │ -00018da0: 2020 2020 2020 2020 2020 2020 2020 5447                TG
│ │ │ │ -00018db0: 5320 4675 6e63 7469 6f6e 732e 2020 2020  S Functions.    
│ │ │ │ -00018dc0: 2020 286c 696e 6520 2031 3234 290a 2a20    (line  124).* 
│ │ │ │ -00018dd0: 7368 6973 6869 5f74 6773 5f64 6f6e 653a  shishi_tgs_done:
│ │ │ │ -00018de0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00018df0: 2020 2020 2020 2054 4753 2046 756e 6374         TGS Funct
│ │ │ │ -00018e00: 696f 6e73 2e20 2020 2020 2028 6c69 6e65  ions.      (line
│ │ │ │ -00018e10: 2020 2039 3329 0a2a 2073 6869 7368 695f     93).* shishi_
│ │ │ │ -00018e20: 7467 735f 6b72 6265 7272 6f72 3a20 2020  tgs_krberror:   
│ │ │ │ +00018d60: 2020 2020 2020 5447 5320 4675 6e63 7469        TGS Functi
│ │ │ │ +00018d70: 6f6e 732e 2020 2020 2020 286c 696e 6520  ons.      (line 
│ │ │ │ +00018d80: 2020 3832 290a 2a20 7368 6973 6869 5f74    82).* shishi_t
│ │ │ │ +00018d90: 6773 5f61 703a 2020 2020 2020 2020 2020  gs_ap:          
│ │ │ │ +00018da0: 2020 2020 2020 2020 2020 2020 2020 2054                 T
│ │ │ │ +00018db0: 4753 2046 756e 6374 696f 6e73 2e20 2020  GS Functions.   
│ │ │ │ +00018dc0: 2020 2028 6c69 6e65 2020 3132 3429 0a2a     (line  124).*
│ │ │ │ +00018dd0: 2073 6869 7368 695f 7467 735f 646f 6e65   shishi_tgs_done
│ │ │ │ +00018de0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ +00018df0: 2020 2020 2020 2020 5447 5320 4675 6e63          TGS Func
│ │ │ │ +00018e00: 7469 6f6e 732e 2020 2020 2020 286c 696e  tions.      (lin
│ │ │ │ +00018e10: 6520 2020 3933 290a 2a20 7368 6973 6869  e   93).* shishi
│ │ │ │ +00018e20: 5f74 6773 5f6b 7262 6572 726f 723a 2020  _tgs_krberror:  
│ │ │ │  00018e30: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00018e40: 5447 5320 4675 6e63 7469 6f6e 732e 2020  TGS Functions.  
│ │ │ │ -00018e50: 2020 2020 286c 696e 6520 2032 3537 290a      (line  257).
│ │ │ │ -00018e60: 2a20 7368 6973 6869 5f74 6773 5f6b 7262  * shishi_tgs_krb
│ │ │ │ -00018e70: 6572 726f 725f 6465 723a 2020 2020 2020  error_der:      
│ │ │ │ -00018e80: 2020 2020 2020 2020 2054 4753 2046 756e           TGS Fun
│ │ │ │ -00018e90: 6374 696f 6e73 2e20 2020 2020 2028 6c69  ctions.      (li
│ │ │ │ -00018ea0: 6e65 2020 3236 3829 0a2a 2073 6869 7368  ne  268).* shish
│ │ │ │ -00018eb0: 695f 7467 735f 6b72 6265 7272 6f72 5f73  i_tgs_krberror_s
│ │ │ │ -00018ec0: 6574 3a20 2020 2020 2020 2020 2020 2020  et:             
│ │ │ │ -00018ed0: 2020 5447 5320 4675 6e63 7469 6f6e 732e    TGS Functions.
│ │ │ │ -00018ee0: 2020 2020 2020 286c 696e 6520 2032 3832        (line  282
│ │ │ │ -00018ef0: 290a 2a20 7368 6973 6869 5f74 6773 5f70  ).* shishi_tgs_p
│ │ │ │ -00018f00: 726f 6365 7373 3a20 2020 2020 2020 2020  rocess:         
│ │ │ │ -00018f10: 2020 2020 2020 2020 2020 2041 532f 5447             AS/TG
│ │ │ │ -00018f20: 5320 4675 6e63 7469 6f6e 732e 2020 2028  S Functions.   (
│ │ │ │ -00018f30: 6c69 6e65 2020 3235 3529 0a2a 2073 6869  line  255).* shi
│ │ │ │ -00018f40: 7368 695f 7467 735f 7265 703a 2020 2020  shi_tgs_rep:    
│ │ │ │ +00018e40: 2054 4753 2046 756e 6374 696f 6e73 2e20   TGS Functions. 
│ │ │ │ +00018e50: 2020 2020 2028 6c69 6e65 2020 3235 3729       (line  257)
│ │ │ │ +00018e60: 0a2a 2073 6869 7368 695f 7467 735f 6b72  .* shishi_tgs_kr
│ │ │ │ +00018e70: 6265 7272 6f72 5f64 6572 3a20 2020 2020  berror_der:     
│ │ │ │ +00018e80: 2020 2020 2020 2020 2020 5447 5320 4675            TGS Fu
│ │ │ │ +00018e90: 6e63 7469 6f6e 732e 2020 2020 2020 286c  nctions.      (l
│ │ │ │ +00018ea0: 696e 6520 2032 3638 290a 2a20 7368 6973  ine  268).* shis
│ │ │ │ +00018eb0: 6869 5f74 6773 5f6b 7262 6572 726f 725f  hi_tgs_krberror_
│ │ │ │ +00018ec0: 7365 743a 2020 2020 2020 2020 2020 2020  set:            
│ │ │ │ +00018ed0: 2020 2054 4753 2046 756e 6374 696f 6e73     TGS Functions
│ │ │ │ +00018ee0: 2e20 2020 2020 2028 6c69 6e65 2020 3238  .      (line  28
│ │ │ │ +00018ef0: 3229 0a2a 2073 6869 7368 695f 7467 735f  2).* shishi_tgs_
│ │ │ │ +00018f00: 7072 6f63 6573 733a 2020 2020 2020 2020  process:        
│ │ │ │ +00018f10: 2020 2020 2020 2020 2020 2020 4153 2f54              AS/T
│ │ │ │ +00018f20: 4753 2046 756e 6374 696f 6e73 2e20 2020  GS Functions.   
│ │ │ │ +00018f30: 286c 696e 6520 2032 3535 290a 2a20 7368  (line  255).* sh
│ │ │ │ +00018f40: 6973 6869 5f74 6773 5f72 6570 3a20 2020  ishi_tgs_rep:   
│ │ │ │  00018f50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00018f60: 2020 2020 5447 5320 4675 6e63 7469 6f6e      TGS Function
│ │ │ │ -00018f70: 732e 2020 2020 2020 286c 696e 6520 2032  s.      (line  2
│ │ │ │ -00018f80: 3037 290a 2a20 7368 6973 6869 5f74 6773  07).* shishi_tgs
│ │ │ │ -00018f90: 5f72 6570 5f62 7569 6c64 3a20 2020 2020  _rep_build:     
│ │ │ │ -00018fa0: 2020 2020 2020 2020 2020 2020 2054 4753               TGS
│ │ │ │ -00018fb0: 2046 756e 6374 696f 6e73 2e20 2020 2020   Functions.     
│ │ │ │ -00018fc0: 2028 6c69 6e65 2020 3234 3429 0a2a 2073   (line  244).* s
│ │ │ │ -00018fd0: 6869 7368 695f 7467 735f 7265 705f 6465  hishi_tgs_rep_de
│ │ │ │ -00018fe0: 723a 2020 2020 2020 2020 2020 2020 2020  r:              
│ │ │ │ -00018ff0: 2020 2020 2020 5447 5320 4675 6e63 7469        TGS Functi
│ │ │ │ -00019000: 6f6e 732e 2020 2020 2020 286c 696e 6520  ons.      (line 
│ │ │ │ -00019010: 2032 3138 290a 2a20 7368 6973 6869 5f74   218).* shishi_t
│ │ │ │ -00019020: 6773 5f72 6570 5f70 726f 6365 7373 3a20  gs_rep_process: 
│ │ │ │ -00019030: 2020 2020 2020 2020 2020 2020 2020 2054                 T
│ │ │ │ -00019040: 4753 2046 756e 6374 696f 6e73 2e20 2020  GS Functions.   
│ │ │ │ -00019050: 2020 2028 6c69 6e65 2020 3233 3229 0a2a     (line  232).*
│ │ │ │ -00019060: 2073 6869 7368 695f 7467 735f 7265 713a   shishi_tgs_req:
│ │ │ │ -00019070: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00019080: 2020 2020 2020 2020 5447 5320 4675 6e63          TGS Func
│ │ │ │ -00019090: 7469 6f6e 732e 2020 2020 2020 286c 696e  tions.      (lin
│ │ │ │ -000190a0: 6520 2031 3335 290a 2a20 7368 6973 6869  e  135).* shishi
│ │ │ │ -000190b0: 5f74 6773 5f72 6571 5f62 7569 6c64 3a20  _tgs_req_build: 
│ │ │ │ +00018f60: 2020 2020 2054 4753 2046 756e 6374 696f       TGS Functio
│ │ │ │ +00018f70: 6e73 2e20 2020 2020 2028 6c69 6e65 2020  ns.      (line  
│ │ │ │ +00018f80: 3230 3729 0a2a 2073 6869 7368 695f 7467  207).* shishi_tg
│ │ │ │ +00018f90: 735f 7265 705f 6275 696c 643a 2020 2020  s_rep_build:    
│ │ │ │ +00018fa0: 2020 2020 2020 2020 2020 2020 2020 5447                TG
│ │ │ │ +00018fb0: 5320 4675 6e63 7469 6f6e 732e 2020 2020  S Functions.    
│ │ │ │ +00018fc0: 2020 286c 696e 6520 2032 3434 290a 2a20    (line  244).* 
│ │ │ │ +00018fd0: 7368 6973 6869 5f74 6773 5f72 6570 5f64  shishi_tgs_rep_d
│ │ │ │ +00018fe0: 6572 3a20 2020 2020 2020 2020 2020 2020  er:             
│ │ │ │ +00018ff0: 2020 2020 2020 2054 4753 2046 756e 6374         TGS Funct
│ │ │ │ +00019000: 696f 6e73 2e20 2020 2020 2028 6c69 6e65  ions.      (line
│ │ │ │ +00019010: 2020 3231 3829 0a2a 2073 6869 7368 695f    218).* shishi_
│ │ │ │ +00019020: 7467 735f 7265 705f 7072 6f63 6573 733a  tgs_rep_process:
│ │ │ │ +00019030: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +00019040: 5447 5320 4675 6e63 7469 6f6e 732e 2020  TGS Functions.  
│ │ │ │ +00019050: 2020 2020 286c 696e 6520 2032 3332 290a      (line  232).
│ │ │ │ +00019060: 2a20 7368 6973 6869 5f74 6773 5f72 6571  * shishi_tgs_req
│ │ │ │ +00019070: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ +00019080: 2020 2020 2020 2020 2054 4753 2046 756e           TGS Fun
│ │ │ │ +00019090: 6374 696f 6e73 2e20 2020 2020 2028 6c69  ctions.      (li
│ │ │ │ +000190a0: 6e65 2020 3133 3529 0a2a 2073 6869 7368  ne  135).* shish
│ │ │ │ +000190b0: 695f 7467 735f 7265 715f 6275 696c 643a  i_tgs_req_build:
│ │ │ │  000190c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000190d0: 2054 4753 2046 756e 6374 696f 6e73 2e20   TGS Functions. 
│ │ │ │ -000190e0: 2020 2020 2028 6c69 6e65 2020 3139 3629       (line  196)
│ │ │ │ -000190f0: 0a2a 2073 6869 7368 695f 7467 735f 7265  .* shishi_tgs_re
│ │ │ │ -00019100: 715f 6465 723a 2020 2020 2020 2020 2020  q_der:          
│ │ │ │ -00019110: 2020 2020 2020 2020 2020 5447 5320 4675            TGS Fu
│ │ │ │ -00019120: 6e63 7469 6f6e 732e 2020 2020 2020 286c  nctions.      (l
│ │ │ │ -00019130: 696e 6520 2031 3536 290a 2a20 7368 6973  ine  156).* shis
│ │ │ │ -00019140: 6869 5f74 6773 5f72 6571 5f64 6572 5f73  hi_tgs_req_der_s
│ │ │ │ -00019150: 6574 3a20 2020 2020 2020 2020 2020 2020  et:             
│ │ │ │ -00019160: 2020 2054 4753 2046 756e 6374 696f 6e73     TGS Functions
│ │ │ │ -00019170: 2e20 2020 2020 2028 6c69 6e65 2020 3137  .      (line  17
│ │ │ │ -00019180: 3029 0a2a 2073 6869 7368 695f 7467 735f  0).* shishi_tgs_
│ │ │ │ -00019190: 7265 715f 7072 6f63 6573 733a 2020 2020  req_process:    
│ │ │ │ -000191a0: 2020 2020 2020 2020 2020 2020 5447 5320              TGS 
│ │ │ │ -000191b0: 4675 6e63 7469 6f6e 732e 2020 2020 2020  Functions.      
│ │ │ │ -000191c0: 286c 696e 6520 2031 3834 290a 2a20 7368  (line  184).* sh
│ │ │ │ -000191d0: 6973 6869 5f74 6773 5f72 6571 5f73 6574  ishi_tgs_req_set
│ │ │ │ -000191e0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ -000191f0: 2020 2020 2054 4753 2046 756e 6374 696f       TGS Functio
│ │ │ │ -00019200: 6e73 2e20 2020 2020 2028 6c69 6e65 2020  ns.      (line  
│ │ │ │ -00019210: 3134 3629 0a2a 2073 6869 7368 695f 7467  146).* shishi_tg
│ │ │ │ -00019220: 735f 7365 6e64 7265 6376 3a20 2020 2020  s_sendrecv:     
│ │ │ │ -00019230: 2020 2020 2020 2020 2020 2020 2020 5447                TG
│ │ │ │ -00019240: 5320 4675 6e63 7469 6f6e 732e 2020 2020  S Functions.    
│ │ │ │ -00019250: 2020 286c 696e 6520 2033 3239 290a 2a20    (line  329).* 
│ │ │ │ -00019260: 7368 6973 6869 5f74 6773 5f73 656e 6472  shishi_tgs_sendr
│ │ │ │ -00019270: 6563 765f 6869 6e74 3a20 2020 2020 2020  ecv_hint:       
│ │ │ │ -00019280: 2020 2020 2020 2054 4753 2046 756e 6374         TGS Funct
│ │ │ │ -00019290: 696f 6e73 2e20 2020 2020 2028 6c69 6e65  ions.      (line
│ │ │ │ -000192a0: 2020 3331 3329 0a2a 2073 6869 7368 695f    313).* shishi_
│ │ │ │ -000192b0: 7467 735f 7365 745f 7265 616c 6d3a 2020  tgs_set_realm:  
│ │ │ │ +000190d0: 2020 5447 5320 4675 6e63 7469 6f6e 732e    TGS Functions.
│ │ │ │ +000190e0: 2020 2020 2020 286c 696e 6520 2031 3936        (line  196
│ │ │ │ +000190f0: 290a 2a20 7368 6973 6869 5f74 6773 5f72  ).* shishi_tgs_r
│ │ │ │ +00019100: 6571 5f64 6572 3a20 2020 2020 2020 2020  eq_der:         
│ │ │ │ +00019110: 2020 2020 2020 2020 2020 2054 4753 2046             TGS F
│ │ │ │ +00019120: 756e 6374 696f 6e73 2e20 2020 2020 2028  unctions.      (
│ │ │ │ +00019130: 6c69 6e65 2020 3135 3629 0a2a 2073 6869  line  156).* shi
│ │ │ │ +00019140: 7368 695f 7467 735f 7265 715f 6465 725f  shi_tgs_req_der_
│ │ │ │ +00019150: 7365 743a 2020 2020 2020 2020 2020 2020  set:            
│ │ │ │ +00019160: 2020 2020 5447 5320 4675 6e63 7469 6f6e      TGS Function
│ │ │ │ +00019170: 732e 2020 2020 2020 286c 696e 6520 2031  s.      (line  1
│ │ │ │ +00019180: 3730 290a 2a20 7368 6973 6869 5f74 6773  70).* shishi_tgs
│ │ │ │ +00019190: 5f72 6571 5f70 726f 6365 7373 3a20 2020  _req_process:   
│ │ │ │ +000191a0: 2020 2020 2020 2020 2020 2020 2054 4753               TGS
│ │ │ │ +000191b0: 2046 756e 6374 696f 6e73 2e20 2020 2020   Functions.     
│ │ │ │ +000191c0: 2028 6c69 6e65 2020 3138 3429 0a2a 2073   (line  184).* s
│ │ │ │ +000191d0: 6869 7368 695f 7467 735f 7265 715f 7365  hishi_tgs_req_se
│ │ │ │ +000191e0: 743a 2020 2020 2020 2020 2020 2020 2020  t:              
│ │ │ │ +000191f0: 2020 2020 2020 5447 5320 4675 6e63 7469        TGS Functi
│ │ │ │ +00019200: 6f6e 732e 2020 2020 2020 286c 696e 6520  ons.      (line 
│ │ │ │ +00019210: 2031 3436 290a 2a20 7368 6973 6869 5f74   146).* shishi_t
│ │ │ │ +00019220: 6773 5f73 656e 6472 6563 763a 2020 2020  gs_sendrecv:    
│ │ │ │ +00019230: 2020 2020 2020 2020 2020 2020 2020 2054                 T
│ │ │ │ +00019240: 4753 2046 756e 6374 696f 6e73 2e20 2020  GS Functions.   
│ │ │ │ +00019250: 2020 2028 6c69 6e65 2020 3332 3929 0a2a     (line  329).*
│ │ │ │ +00019260: 2073 6869 7368 695f 7467 735f 7365 6e64   shishi_tgs_send
│ │ │ │ +00019270: 7265 6376 5f68 696e 743a 2020 2020 2020  recv_hint:      
│ │ │ │ +00019280: 2020 2020 2020 2020 5447 5320 4675 6e63          TGS Func
│ │ │ │ +00019290: 7469 6f6e 732e 2020 2020 2020 286c 696e  tions.      (lin
│ │ │ │ +000192a0: 6520 2033 3133 290a 2a20 7368 6973 6869  e  313).* shishi
│ │ │ │ +000192b0: 5f74 6773 5f73 6574 5f72 6561 6c6d 3a20  _tgs_set_realm: 
│ │ │ │  000192c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000192d0: 5447 5320 4675 6e63 7469 6f6e 732e 2020  TGS Functions.  
│ │ │ │ -000192e0: 2020 2020 286c 696e 6520 2033 3533 290a      (line  353).
│ │ │ │ -000192f0: 2a20 7368 6973 6869 5f74 6773 5f73 6574  * shishi_tgs_set
│ │ │ │ -00019300: 5f72 6561 6c6d 7365 7276 6572 3a20 2020  _realmserver:   
│ │ │ │ -00019310: 2020 2020 2020 2020 2054 4753 2046 756e           TGS Fun
│ │ │ │ -00019320: 6374 696f 6e73 2e20 2020 2020 2028 6c69  ctions.      (li
│ │ │ │ -00019330: 6e65 2020 3336 3529 0a2a 2073 6869 7368  ne  365).* shish
│ │ │ │ -00019340: 695f 7467 735f 7365 745f 7365 7276 6572  i_tgs_set_server
│ │ │ │ -00019350: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ -00019360: 2020 5447 5320 4675 6e63 7469 6f6e 732e    TGS Functions.
│ │ │ │ -00019370: 2020 2020 2020 286c 696e 6520 2033 3431        (line  341
│ │ │ │ -00019380: 290a 2a20 7368 6973 6869 5f74 6773 5f74  ).* shishi_tgs_t
│ │ │ │ -00019390: 6774 6b74 3a20 2020 2020 2020 2020 2020  gtkt:           
│ │ │ │ -000193a0: 2020 2020 2020 2020 2020 2054 4753 2046             TGS F
│ │ │ │ -000193b0: 756e 6374 696f 6e73 2e20 2020 2020 2028  unctions.      (
│ │ │ │ -000193c0: 6c69 6e65 2020 3130 3329 0a2a 2073 6869  line  103).* shi
│ │ │ │ -000193d0: 7368 695f 7467 735f 7467 746b 745f 7365  shi_tgs_tgtkt_se
│ │ │ │ -000193e0: 743a 2020 2020 2020 2020 2020 2020 2020  t:              
│ │ │ │ -000193f0: 2020 2020 5447 5320 4675 6e63 7469 6f6e      TGS Function
│ │ │ │ -00019400: 732e 2020 2020 2020 286c 696e 6520 2031  s.      (line  1
│ │ │ │ -00019410: 3134 290a 2a20 7368 6973 6869 5f74 6773  14).* shishi_tgs
│ │ │ │ -00019420: 5f74 6b74 3a20 2020 2020 2020 2020 2020  _tkt:           
│ │ │ │ -00019430: 2020 2020 2020 2020 2020 2020 2054 4753               TGS
│ │ │ │ -00019440: 2046 756e 6374 696f 6e73 2e20 2020 2020   Functions.     
│ │ │ │ -00019450: 2028 6c69 6e65 2020 3239 3229 0a2a 2073   (line  292).* s
│ │ │ │ -00019460: 6869 7368 695f 7467 735f 746b 745f 7365  hishi_tgs_tkt_se
│ │ │ │ -00019470: 743a 2020 2020 2020 2020 2020 2020 2020  t:              
│ │ │ │ -00019480: 2020 2020 2020 5447 5320 4675 6e63 7469        TGS Functi
│ │ │ │ -00019490: 6f6e 732e 2020 2020 2020 286c 696e 6520  ons.      (line 
│ │ │ │ -000194a0: 2033 3033 290a 2a20 7368 6973 6869 5f74   303).* shishi_t
│ │ │ │ -000194b0: 6773 7265 703a 2020 2020 2020 2020 2020  gsrep:          
│ │ │ │ -000194c0: 2020 2020 2020 2020 2020 2020 2020 2041                 A
│ │ │ │ -000194d0: 532f 5447 5320 4675 6e63 7469 6f6e 732e  S/TGS Functions.
│ │ │ │ -000194e0: 2020 2028 6c69 6e65 2031 3032 3329 0a2a     (line 1023).*
│ │ │ │ -000194f0: 2073 6869 7368 695f 7467 7372 6571 3a20   shishi_tgsreq: 
│ │ │ │ +000192d0: 2054 4753 2046 756e 6374 696f 6e73 2e20   TGS Functions. 
│ │ │ │ +000192e0: 2020 2020 2028 6c69 6e65 2020 3335 3329       (line  353)
│ │ │ │ +000192f0: 0a2a 2073 6869 7368 695f 7467 735f 7365  .* shishi_tgs_se
│ │ │ │ +00019300: 745f 7265 616c 6d73 6572 7665 723a 2020  t_realmserver:  
│ │ │ │ +00019310: 2020 2020 2020 2020 2020 5447 5320 4675            TGS Fu
│ │ │ │ +00019320: 6e63 7469 6f6e 732e 2020 2020 2020 286c  nctions.      (l
│ │ │ │ +00019330: 696e 6520 2033 3635 290a 2a20 7368 6973  ine  365).* shis
│ │ │ │ +00019340: 6869 5f74 6773 5f73 6574 5f73 6572 7665  hi_tgs_set_serve
│ │ │ │ +00019350: 723a 2020 2020 2020 2020 2020 2020 2020  r:              
│ │ │ │ +00019360: 2020 2054 4753 2046 756e 6374 696f 6e73     TGS Functions
│ │ │ │ +00019370: 2e20 2020 2020 2028 6c69 6e65 2020 3334  .      (line  34
│ │ │ │ +00019380: 3129 0a2a 2073 6869 7368 695f 7467 735f  1).* shishi_tgs_
│ │ │ │ +00019390: 7467 746b 743a 2020 2020 2020 2020 2020  tgtkt:          
│ │ │ │ +000193a0: 2020 2020 2020 2020 2020 2020 5447 5320              TGS 
│ │ │ │ +000193b0: 4675 6e63 7469 6f6e 732e 2020 2020 2020  Functions.      
│ │ │ │ +000193c0: 286c 696e 6520 2031 3033 290a 2a20 7368  (line  103).* sh
│ │ │ │ +000193d0: 6973 6869 5f74 6773 5f74 6774 6b74 5f73  ishi_tgs_tgtkt_s
│ │ │ │ +000193e0: 6574 3a20 2020 2020 2020 2020 2020 2020  et:             
│ │ │ │ +000193f0: 2020 2020 2054 4753 2046 756e 6374 696f       TGS Functio
│ │ │ │ +00019400: 6e73 2e20 2020 2020 2028 6c69 6e65 2020  ns.      (line  
│ │ │ │ +00019410: 3131 3429 0a2a 2073 6869 7368 695f 7467  114).* shishi_tg
│ │ │ │ +00019420: 735f 746b 743a 2020 2020 2020 2020 2020  s_tkt:          
│ │ │ │ +00019430: 2020 2020 2020 2020 2020 2020 2020 5447                TG
│ │ │ │ +00019440: 5320 4675 6e63 7469 6f6e 732e 2020 2020  S Functions.    
│ │ │ │ +00019450: 2020 286c 696e 6520 2032 3932 290a 2a20    (line  292).* 
│ │ │ │ +00019460: 7368 6973 6869 5f74 6773 5f74 6b74 5f73  shishi_tgs_tkt_s
│ │ │ │ +00019470: 6574 3a20 2020 2020 2020 2020 2020 2020  et:             
│ │ │ │ +00019480: 2020 2020 2020 2054 4753 2046 756e 6374         TGS Funct
│ │ │ │ +00019490: 696f 6e73 2e20 2020 2020 2028 6c69 6e65  ions.      (line
│ │ │ │ +000194a0: 2020 3330 3329 0a2a 2073 6869 7368 695f    303).* shishi_
│ │ │ │ +000194b0: 7467 7372 6570 3a20 2020 2020 2020 2020  tgsrep:         
│ │ │ │ +000194c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +000194d0: 4153 2f54 4753 2046 756e 6374 696f 6e73  AS/TGS Functions
│ │ │ │ +000194e0: 2e20 2020 286c 696e 6520 3130 3233 290a  .   (line 1023).
│ │ │ │ +000194f0: 2a20 7368 6973 6869 5f74 6773 7265 713a  * shishi_tgsreq:
│ │ │ │  00019500: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00019510: 2020 2020 2020 2020 4153 2f54 4753 2046          AS/TGS F
│ │ │ │ -00019520: 756e 6374 696f 6e73 2e20 2020 286c 696e  unctions.   (lin
│ │ │ │ -00019530: 6520 2033 3430 290a 2a20 7368 6973 6869  e  340).* shishi
│ │ │ │ -00019540: 5f74 6963 6b65 743a 2020 2020 2020 2020  _ticket:        
│ │ │ │ +00019510: 2020 2020 2020 2020 2041 532f 5447 5320           AS/TGS 
│ │ │ │ +00019520: 4675 6e63 7469 6f6e 732e 2020 2028 6c69  Functions.   (li
│ │ │ │ +00019530: 6e65 2020 3334 3029 0a2a 2073 6869 7368  ne  340).* shish
│ │ │ │ +00019540: 695f 7469 636b 6574 3a20 2020 2020 2020  i_ticket:       
│ │ │ │  00019550: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00019560: 2054 6963 6b65 7420 2841 534e 2e31 2920   Ticket (ASN.1) 
│ │ │ │ -00019570: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │ +00019560: 2020 5469 636b 6574 2028 4153 4e2e 3129    Ticket (ASN.1)
│ │ │ │ +00019570: 2046 756e 6374 696f 6e73 2e0a 2020 2020   Functions..    
│ │ │ │  00019580: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00019590: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000195a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000195b0: 2020 2020 2020 2020 286c 696e 6520 2020          (line   
│ │ │ │ -000195c0: 3334 290a 2a20 7368 6973 6869 5f74 6963  34).* shishi_tic
│ │ │ │ -000195d0: 6b65 745f 6164 645f 656e 635f 7061 7274  ket_add_enc_part
│ │ │ │ -000195e0: 3a20 2020 2020 2020 2020 2020 2054 6963  :            Tic
│ │ │ │ -000195f0: 6b65 7420 2841 534e 2e31 2920 4675 6e63  ket (ASN.1) Func
│ │ │ │ -00019600: 7469 6f6e 732e 0a20 2020 2020 2020 2020  tions..         
│ │ │ │ +000195b0: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ +000195c0: 2033 3429 0a2a 2073 6869 7368 695f 7469   34).* shishi_ti
│ │ │ │ +000195d0: 636b 6574 5f61 6464 5f65 6e63 5f70 6172  cket_add_enc_par
│ │ │ │ +000195e0: 743a 2020 2020 2020 2020 2020 2020 5469  t:            Ti
│ │ │ │ +000195f0: 636b 6574 2028 4153 4e2e 3129 2046 756e  cket (ASN.1) Fun
│ │ │ │ +00019600: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │  00019610: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00019620: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00019630: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00019640: 2020 2020 286c 696e 6520 2031 3433 290a      (line  143).
│ │ │ │ -00019650: 2a20 7368 6973 6869 5f74 6963 6b65 745f  * shishi_ticket_
│ │ │ │ -00019660: 6765 745f 656e 635f 7061 7274 5f65 7479  get_enc_part_ety
│ │ │ │ -00019670: 7065 3a20 2020 2020 2054 6963 6b65 7420  pe:      Ticket 
│ │ │ │ -00019680: 2841 534e 2e31 2920 4675 6e63 7469 6f6e  (ASN.1) Function
│ │ │ │ -00019690: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │ +00019640: 2020 2020 2028 6c69 6e65 2020 3134 3329       (line  143)
│ │ │ │ +00019650: 0a2a 2073 6869 7368 695f 7469 636b 6574  .* shishi_ticket
│ │ │ │ +00019660: 5f67 6574 5f65 6e63 5f70 6172 745f 6574  _get_enc_part_et
│ │ │ │ +00019670: 7970 653a 2020 2020 2020 5469 636b 6574  ype:      Ticket
│ │ │ │ +00019680: 2028 4153 4e2e 3129 2046 756e 6374 696f   (ASN.1) Functio
│ │ │ │ +00019690: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │  000196a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000196b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000196c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000196d0: 286c 696e 6520 2031 3039 290a 2a20 7368  (line  109).* sh
│ │ │ │ -000196e0: 6973 6869 5f74 6963 6b65 745f 7265 616c  ishi_ticket_real
│ │ │ │ -000196f0: 6d5f 6765 743a 2020 2020 2020 2020 2020  m_get:          
│ │ │ │ -00019700: 2020 2020 2054 6963 6b65 7420 2841 534e       Ticket (ASN
│ │ │ │ -00019710: 2e31 2920 4675 6e63 7469 6f6e 732e 0a20  .1) Functions.. 
│ │ │ │ +000196d0: 2028 6c69 6e65 2020 3130 3929 0a2a 2073   (line  109).* s
│ │ │ │ +000196e0: 6869 7368 695f 7469 636b 6574 5f72 6561  hishi_ticket_rea
│ │ │ │ +000196f0: 6c6d 5f67 6574 3a20 2020 2020 2020 2020  lm_get:         
│ │ │ │ +00019700: 2020 2020 2020 5469 636b 6574 2028 4153        Ticket (AS
│ │ │ │ +00019710: 4e2e 3129 2046 756e 6374 696f 6e73 2e0a  N.1) Functions..
│ │ │ │  00019720: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00019730: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00019740: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00019750: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ -00019760: 6520 2020 3435 290a 2a20 7368 6973 6869  e   45).* shishi
│ │ │ │ -00019770: 5f74 6963 6b65 745f 7265 616c 6d5f 7365  _ticket_realm_se
│ │ │ │ -00019780: 743a 2020 2020 2020 2020 2020 2020 2020  t:              
│ │ │ │ -00019790: 2054 6963 6b65 7420 2841 534e 2e31 2920   Ticket (ASN.1) 
│ │ │ │ -000197a0: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │ +00019750: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ +00019760: 6e65 2020 2034 3529 0a2a 2073 6869 7368  ne   45).* shish
│ │ │ │ +00019770: 695f 7469 636b 6574 5f72 6561 6c6d 5f73  i_ticket_realm_s
│ │ │ │ +00019780: 6574 3a20 2020 2020 2020 2020 2020 2020  et:             
│ │ │ │ +00019790: 2020 5469 636b 6574 2028 4153 4e2e 3129    Ticket (ASN.1)
│ │ │ │ +000197a0: 2046 756e 6374 696f 6e73 2e0a 2020 2020   Functions..    
│ │ │ │  000197b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000197c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000197d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000197e0: 2020 2020 2020 2020 286c 696e 6520 2020          (line   
│ │ │ │ -000197f0: 3539 290a 2a20 7368 6973 6869 5f74 6963  59).* shishi_tic
│ │ │ │ -00019800: 6b65 745f 7365 7276 6572 3a20 2020 2020  ket_server:     
│ │ │ │ -00019810: 2020 2020 2020 2020 2020 2020 2054 6963               Tic
│ │ │ │ -00019820: 6b65 7420 2841 534e 2e31 2920 4675 6e63  ket (ASN.1) Func
│ │ │ │ -00019830: 7469 6f6e 732e 0a20 2020 2020 2020 2020  tions..         
│ │ │ │ +000197e0: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ +000197f0: 2035 3929 0a2a 2073 6869 7368 695f 7469   59).* shishi_ti
│ │ │ │ +00019800: 636b 6574 5f73 6572 7665 723a 2020 2020  cket_server:    
│ │ │ │ +00019810: 2020 2020 2020 2020 2020 2020 2020 5469                Ti
│ │ │ │ +00019820: 636b 6574 2028 4153 4e2e 3129 2046 756e  cket (ASN.1) Fun
│ │ │ │ +00019830: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │  00019840: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00019850: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00019860: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00019870: 2020 2020 286c 696e 6520 2020 3732 290a      (line   72).
│ │ │ │ -00019880: 2a20 7368 6973 6869 5f74 6963 6b65 745f  * shishi_ticket_
│ │ │ │ -00019890: 7365 745f 656e 635f 7061 7274 3a20 2020  set_enc_part:   
│ │ │ │ -000198a0: 2020 2020 2020 2020 2054 6963 6b65 7420           Ticket 
│ │ │ │ -000198b0: 2841 534e 2e31 2920 4675 6e63 7469 6f6e  (ASN.1) Function
│ │ │ │ -000198c0: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │ +00019870: 2020 2020 2028 6c69 6e65 2020 2037 3229       (line   72)
│ │ │ │ +00019880: 0a2a 2073 6869 7368 695f 7469 636b 6574  .* shishi_ticket
│ │ │ │ +00019890: 5f73 6574 5f65 6e63 5f70 6172 743a 2020  _set_enc_part:  
│ │ │ │ +000198a0: 2020 2020 2020 2020 2020 5469 636b 6574            Ticket
│ │ │ │ +000198b0: 2028 4153 4e2e 3129 2046 756e 6374 696f   (ASN.1) Functio
│ │ │ │ +000198c0: 6e73 2e0a 2020 2020 2020 2020 2020 2020  ns..            
│ │ │ │  000198d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000198e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  000198f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00019900: 286c 696e 6520 2031 3232 290a 2a20 7368  (line  122).* sh
│ │ │ │ -00019910: 6973 6869 5f74 6963 6b65 745f 736e 616d  ishi_ticket_snam
│ │ │ │ -00019920: 655f 7365 743a 2020 2020 2020 2020 2020  e_set:          
│ │ │ │ -00019930: 2020 2020 2054 6963 6b65 7420 2841 534e       Ticket (ASN
│ │ │ │ -00019940: 2e31 2920 4675 6e63 7469 6f6e 732e 0a20  .1) Functions.. 
│ │ │ │ +00019900: 2028 6c69 6e65 2020 3132 3229 0a2a 2073   (line  122).* s
│ │ │ │ +00019910: 6869 7368 695f 7469 636b 6574 5f73 6e61  hishi_ticket_sna
│ │ │ │ +00019920: 6d65 5f73 6574 3a20 2020 2020 2020 2020  me_set:         
│ │ │ │ +00019930: 2020 2020 2020 5469 636b 6574 2028 4153        Ticket (AS
│ │ │ │ +00019940: 4e2e 3129 2046 756e 6374 696f 6e73 2e0a  N.1) Functions..
│ │ │ │  00019950: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00019960: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  00019970: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00019980: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ -00019990: 6520 2020 3933 290a 2a20 7368 6973 6869  e   93).* shishi
│ │ │ │ -000199a0: 5f74 696d 653a 2020 2020 2020 2020 2020  _time:          
│ │ │ │ +00019980: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ +00019990: 6e65 2020 2039 3329 0a2a 2073 6869 7368  ne   93).* shish
│ │ │ │ +000199a0: 695f 7469 6d65 3a20 2020 2020 2020 2020  i_time:         
│ │ │ │  000199b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -000199c0: 2055 7469 6c69 7479 2046 756e 6374 696f   Utility Functio
│ │ │ │ -000199d0: 6e73 2e20 2028 6c69 6e65 2020 3430 3829  ns.  (line  408)
│ │ │ │ -000199e0: 0a2a 2073 6869 7368 695f 746b 743a 2020  .* shishi_tkt:  
│ │ │ │ +000199c0: 2020 5574 696c 6974 7920 4675 6e63 7469    Utility Functi
│ │ │ │ +000199d0: 6f6e 732e 2020 286c 696e 6520 2034 3038  ons.  (line  408
│ │ │ │ +000199e0: 290a 2a20 7368 6973 6869 5f74 6b74 3a20  ).* shishi_tkt: 
│ │ │ │  000199f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00019a00: 2020 2020 2020 2020 2020 5469 636b 6574            Ticket
│ │ │ │ -00019a10: 2046 756e 6374 696f 6e73 2e20 2020 286c   Functions.   (l
│ │ │ │ -00019a20: 696e 6520 2020 3136 290a 2a20 7368 6973  ine   16).* shis
│ │ │ │ -00019a30: 6869 5f74 6b74 5f61 7574 6863 7469 6d65  hi_tkt_authctime
│ │ │ │ -00019a40: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ -00019a50: 2020 2054 6963 6b65 7420 4675 6e63 7469     Ticket Functi
│ │ │ │ -00019a60: 6f6e 732e 2020 2028 6c69 6e65 2020 3631  ons.   (line  61
│ │ │ │ -00019a70: 3829 0a2a 2073 6869 7368 695f 746b 745f  8).* shishi_tkt_
│ │ │ │ -00019a80: 636c 6965 6e74 3a20 2020 2020 2020 2020  client:         
│ │ │ │ -00019a90: 2020 2020 2020 2020 2020 2020 5469 636b              Tick
│ │ │ │ -00019aa0: 6574 2046 756e 6374 696f 6e73 2e20 2020  et Functions.   
│ │ │ │ -00019ab0: 286c 696e 6520 2031 3436 290a 2a20 7368  (line  146).* sh
│ │ │ │ -00019ac0: 6973 6869 5f74 6b74 5f63 6c69 656e 745f  ishi_tkt_client_
│ │ │ │ -00019ad0: 703a 2020 2020 2020 2020 2020 2020 2020  p:              
│ │ │ │ -00019ae0: 2020 2020 2054 6963 6b65 7420 4675 6e63       Ticket Func
│ │ │ │ -00019af0: 7469 6f6e 732e 2020 2028 6c69 6e65 2020  tions.   (line  
│ │ │ │ -00019b00: 3136 3629 0a2a 2073 6869 7368 695f 746b  166).* shishi_tk
│ │ │ │ -00019b10: 745f 636c 6965 6e74 7265 616c 6d3a 2020  t_clientrealm:  
│ │ │ │ -00019b20: 2020 2020 2020 2020 2020 2020 2020 5469                Ti
│ │ │ │ -00019b30: 636b 6574 2046 756e 6374 696f 6e73 2e20  cket Functions. 
│ │ │ │ -00019b40: 2020 286c 696e 6520 2031 3738 290a 2a20    (line  178).* 
│ │ │ │ -00019b50: 7368 6973 6869 5f74 6b74 5f63 6c69 656e  shishi_tkt_clien
│ │ │ │ -00019b60: 7472 6561 6c6d 5f70 3a20 2020 2020 2020  trealm_p:       
│ │ │ │ -00019b70: 2020 2020 2020 2054 6963 6b65 7420 4675         Ticket Fu
│ │ │ │ -00019b80: 6e63 7469 6f6e 732e 2020 2028 6c69 6e65  nctions.   (line
│ │ │ │ -00019b90: 2020 3139 3829 0a2a 2073 6869 7368 695f    198).* shishi_
│ │ │ │ -00019ba0: 746b 745f 646f 6e65 3a20 2020 2020 2020  tkt_done:       
│ │ │ │ +00019a00: 2020 2020 2020 2020 2020 2054 6963 6b65             Ticke
│ │ │ │ +00019a10: 7420 4675 6e63 7469 6f6e 732e 2020 2028  t Functions.   (
│ │ │ │ +00019a20: 6c69 6e65 2020 2031 3629 0a2a 2073 6869  line   16).* shi
│ │ │ │ +00019a30: 7368 695f 746b 745f 6175 7468 6374 696d  shi_tkt_authctim
│ │ │ │ +00019a40: 653a 2020 2020 2020 2020 2020 2020 2020  e:              
│ │ │ │ +00019a50: 2020 2020 5469 636b 6574 2046 756e 6374      Ticket Funct
│ │ │ │ +00019a60: 696f 6e73 2e20 2020 286c 696e 6520 2036  ions.   (line  6
│ │ │ │ +00019a70: 3138 290a 2a20 7368 6973 6869 5f74 6b74  18).* shishi_tkt
│ │ │ │ +00019a80: 5f63 6c69 656e 743a 2020 2020 2020 2020  _client:        
│ │ │ │ +00019a90: 2020 2020 2020 2020 2020 2020 2054 6963               Tic
│ │ │ │ +00019aa0: 6b65 7420 4675 6e63 7469 6f6e 732e 2020  ket Functions.  
│ │ │ │ +00019ab0: 2028 6c69 6e65 2020 3134 3629 0a2a 2073   (line  146).* s
│ │ │ │ +00019ac0: 6869 7368 695f 746b 745f 636c 6965 6e74  hishi_tkt_client
│ │ │ │ +00019ad0: 5f70 3a20 2020 2020 2020 2020 2020 2020  _p:             
│ │ │ │ +00019ae0: 2020 2020 2020 5469 636b 6574 2046 756e        Ticket Fun
│ │ │ │ +00019af0: 6374 696f 6e73 2e20 2020 286c 696e 6520  ctions.   (line 
│ │ │ │ +00019b00: 2031 3636 290a 2a20 7368 6973 6869 5f74   166).* shishi_t
│ │ │ │ +00019b10: 6b74 5f63 6c69 656e 7472 6561 6c6d 3a20  kt_clientrealm: 
│ │ │ │ +00019b20: 2020 2020 2020 2020 2020 2020 2020 2054                 T
│ │ │ │ +00019b30: 6963 6b65 7420 4675 6e63 7469 6f6e 732e  icket Functions.
│ │ │ │ +00019b40: 2020 2028 6c69 6e65 2020 3137 3829 0a2a     (line  178).*
│ │ │ │ +00019b50: 2073 6869 7368 695f 746b 745f 636c 6965   shishi_tkt_clie
│ │ │ │ +00019b60: 6e74 7265 616c 6d5f 703a 2020 2020 2020  ntrealm_p:      
│ │ │ │ +00019b70: 2020 2020 2020 2020 5469 636b 6574 2046          Ticket F
│ │ │ │ +00019b80: 756e 6374 696f 6e73 2e20 2020 286c 696e  unctions.   (lin
│ │ │ │ +00019b90: 6520 2031 3938 290a 2a20 7368 6973 6869  e  198).* shishi
│ │ │ │ +00019ba0: 5f74 6b74 5f64 6f6e 653a 2020 2020 2020  _tkt_done:      
│ │ │ │  00019bb0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00019bc0: 5469 636b 6574 2046 756e 6374 696f 6e73  Ticket Functions
│ │ │ │ -00019bd0: 2e20 2020 286c 696e 6520 2020 3432 290a  .   (line   42).
│ │ │ │ -00019be0: 2a20 7368 6973 6869 5f74 6b74 5f65 6e63  * shishi_tkt_enc
│ │ │ │ -00019bf0: 6b64 6372 6570 7061 7274 3a20 2020 2020  kdcreppart:     
│ │ │ │ -00019c00: 2020 2020 2020 2020 2054 6963 6b65 7420           Ticket 
│ │ │ │ -00019c10: 4675 6e63 7469 6f6e 732e 2020 2028 6c69  Functions.   (li
│ │ │ │ -00019c20: 6e65 2020 2037 3129 0a2a 2073 6869 7368  ne   71).* shish
│ │ │ │ -00019c30: 695f 746b 745f 656e 636b 6463 7265 7070  i_tkt_enckdcrepp
│ │ │ │ -00019c40: 6172 745f 7365 743a 2020 2020 2020 2020  art_set:        
│ │ │ │ -00019c50: 2020 5469 636b 6574 2046 756e 6374 696f    Ticket Functio
│ │ │ │ -00019c60: 6e73 2e20 2020 286c 696e 6520 2020 3831  ns.   (line   81
│ │ │ │ -00019c70: 290a 2a20 7368 6973 6869 5f74 6b74 5f65  ).* shishi_tkt_e
│ │ │ │ -00019c80: 6e63 7469 636b 6574 7061 7274 3a20 2020  ncticketpart:   
│ │ │ │ -00019c90: 2020 2020 2020 2020 2020 2054 6963 6b65             Ticke
│ │ │ │ -00019ca0: 7420 4675 6e63 7469 6f6e 732e 2020 2028  t Functions.   (
│ │ │ │ -00019cb0: 6c69 6e65 2020 3130 3129 0a2a 2073 6869  line  101).* shi
│ │ │ │ -00019cc0: 7368 695f 746b 745f 656e 6374 6963 6b65  shi_tkt_encticke
│ │ │ │ -00019cd0: 7470 6172 745f 7365 743a 2020 2020 2020  tpart_set:      
│ │ │ │ -00019ce0: 2020 2020 5469 636b 6574 2046 756e 6374      Ticket Funct
│ │ │ │ -00019cf0: 696f 6e73 2e20 2020 286c 696e 6520 2031  ions.   (line  1
│ │ │ │ -00019d00: 3131 290a 2a20 7368 6973 6869 5f74 6b74  11).* shishi_tkt
│ │ │ │ -00019d10: 5f65 6e64 6374 696d 653a 2020 2020 2020  _endctime:      
│ │ │ │ -00019d20: 2020 2020 2020 2020 2020 2020 2054 6963               Tic
│ │ │ │ -00019d30: 6b65 7420 4675 6e63 7469 6f6e 732e 2020  ket Functions.  
│ │ │ │ -00019d40: 2028 6c69 6e65 2020 3634 3429 0a2a 2073   (line  644).* s
│ │ │ │ -00019d50: 6869 7368 695f 746b 745f 6578 7069 7265  hishi_tkt_expire
│ │ │ │ -00019d60: 645f 703a 2020 2020 2020 2020 2020 2020  d_p:            
│ │ │ │ -00019d70: 2020 2020 2020 5469 636b 6574 2046 756e        Ticket Fun
│ │ │ │ -00019d80: 6374 696f 6e73 2e20 2020 286c 696e 6520  ctions.   (line 
│ │ │ │ -00019d90: 2036 3934 290a 2a20 7368 6973 6869 5f74   694).* shishi_t
│ │ │ │ -00019da0: 6b74 5f66 6c61 6773 3a20 2020 2020 2020  kt_flags:       
│ │ │ │ -00019db0: 2020 2020 2020 2020 2020 2020 2020 2054                 T
│ │ │ │ -00019dc0: 6963 6b65 7420 4675 6e63 7469 6f6e 732e  icket Functions.
│ │ │ │ -00019dd0: 2020 2028 6c69 6e65 2020 3235 3929 0a2a     (line  259).*
│ │ │ │ -00019de0: 2073 6869 7368 695f 746b 745f 666c 6167   shishi_tkt_flag
│ │ │ │ -00019df0: 735f 6164 643a 2020 2020 2020 2020 2020  s_add:          
│ │ │ │ -00019e00: 2020 2020 2020 2020 5469 636b 6574 2046          Ticket F
│ │ │ │ -00019e10: 756e 6374 696f 6e73 2e20 2020 286c 696e  unctions.   (lin
│ │ │ │ -00019e20: 6520 2032 3833 290a 2a20 7368 6973 6869  e  283).* shishi
│ │ │ │ -00019e30: 5f74 6b74 5f66 6c61 6773 5f73 6574 3a20  _tkt_flags_set: 
│ │ │ │ +00019bc0: 2054 6963 6b65 7420 4675 6e63 7469 6f6e   Ticket Function
│ │ │ │ +00019bd0: 732e 2020 2028 6c69 6e65 2020 2034 3229  s.   (line   42)
│ │ │ │ +00019be0: 0a2a 2073 6869 7368 695f 746b 745f 656e  .* shishi_tkt_en
│ │ │ │ +00019bf0: 636b 6463 7265 7070 6172 743a 2020 2020  ckdcreppart:    
│ │ │ │ +00019c00: 2020 2020 2020 2020 2020 5469 636b 6574            Ticket
│ │ │ │ +00019c10: 2046 756e 6374 696f 6e73 2e20 2020 286c   Functions.   (l
│ │ │ │ +00019c20: 696e 6520 2020 3731 290a 2a20 7368 6973  ine   71).* shis
│ │ │ │ +00019c30: 6869 5f74 6b74 5f65 6e63 6b64 6372 6570  hi_tkt_enckdcrep
│ │ │ │ +00019c40: 7061 7274 5f73 6574 3a20 2020 2020 2020  part_set:       
│ │ │ │ +00019c50: 2020 2054 6963 6b65 7420 4675 6e63 7469     Ticket Functi
│ │ │ │ +00019c60: 6f6e 732e 2020 2028 6c69 6e65 2020 2038  ons.   (line   8
│ │ │ │ +00019c70: 3129 0a2a 2073 6869 7368 695f 746b 745f  1).* shishi_tkt_
│ │ │ │ +00019c80: 656e 6374 6963 6b65 7470 6172 743a 2020  encticketpart:  
│ │ │ │ +00019c90: 2020 2020 2020 2020 2020 2020 5469 636b              Tick
│ │ │ │ +00019ca0: 6574 2046 756e 6374 696f 6e73 2e20 2020  et Functions.   
│ │ │ │ +00019cb0: 286c 696e 6520 2031 3031 290a 2a20 7368  (line  101).* sh
│ │ │ │ +00019cc0: 6973 6869 5f74 6b74 5f65 6e63 7469 636b  ishi_tkt_enctick
│ │ │ │ +00019cd0: 6574 7061 7274 5f73 6574 3a20 2020 2020  etpart_set:     
│ │ │ │ +00019ce0: 2020 2020 2054 6963 6b65 7420 4675 6e63       Ticket Func
│ │ │ │ +00019cf0: 7469 6f6e 732e 2020 2028 6c69 6e65 2020  tions.   (line  
│ │ │ │ +00019d00: 3131 3129 0a2a 2073 6869 7368 695f 746b  111).* shishi_tk
│ │ │ │ +00019d10: 745f 656e 6463 7469 6d65 3a20 2020 2020  t_endctime:     
│ │ │ │ +00019d20: 2020 2020 2020 2020 2020 2020 2020 5469                Ti
│ │ │ │ +00019d30: 636b 6574 2046 756e 6374 696f 6e73 2e20  cket Functions. 
│ │ │ │ +00019d40: 2020 286c 696e 6520 2036 3434 290a 2a20    (line  644).* 
│ │ │ │ +00019d50: 7368 6973 6869 5f74 6b74 5f65 7870 6972  shishi_tkt_expir
│ │ │ │ +00019d60: 6564 5f70 3a20 2020 2020 2020 2020 2020  ed_p:           
│ │ │ │ +00019d70: 2020 2020 2020 2054 6963 6b65 7420 4675         Ticket Fu
│ │ │ │ +00019d80: 6e63 7469 6f6e 732e 2020 2028 6c69 6e65  nctions.   (line
│ │ │ │ +00019d90: 2020 3639 3429 0a2a 2073 6869 7368 695f    694).* shishi_
│ │ │ │ +00019da0: 746b 745f 666c 6167 733a 2020 2020 2020  tkt_flags:      
│ │ │ │ +00019db0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +00019dc0: 5469 636b 6574 2046 756e 6374 696f 6e73  Ticket Functions
│ │ │ │ +00019dd0: 2e20 2020 286c 696e 6520 2032 3539 290a  .   (line  259).
│ │ │ │ +00019de0: 2a20 7368 6973 6869 5f74 6b74 5f66 6c61  * shishi_tkt_fla
│ │ │ │ +00019df0: 6773 5f61 6464 3a20 2020 2020 2020 2020  gs_add:         
│ │ │ │ +00019e00: 2020 2020 2020 2020 2054 6963 6b65 7420           Ticket 
│ │ │ │ +00019e10: 4675 6e63 7469 6f6e 732e 2020 2028 6c69  Functions.   (li
│ │ │ │ +00019e20: 6e65 2020 3238 3329 0a2a 2073 6869 7368  ne  283).* shish
│ │ │ │ +00019e30: 695f 746b 745f 666c 6167 735f 7365 743a  i_tkt_flags_set:
│ │ │ │  00019e40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -00019e50: 2054 6963 6b65 7420 4675 6e63 7469 6f6e   Ticket Function
│ │ │ │ -00019e60: 732e 2020 2028 6c69 6e65 2020 3237 3029  s.   (line  270)
│ │ │ │ -00019e70: 0a2a 2073 6869 7368 695f 746b 745f 666f  .* shishi_tkt_fo
│ │ │ │ -00019e80: 7277 6172 6461 626c 655f 703a 2020 2020  rwardable_p:    
│ │ │ │ -00019e90: 2020 2020 2020 2020 2020 5469 636b 6574            Ticket
│ │ │ │ -00019ea0: 2046 756e 6374 696f 6e73 2e20 2020 286c   Functions.   (l
│ │ │ │ -00019eb0: 696e 6520 2032 3935 290a 2a20 7368 6973  ine  295).* shis
│ │ │ │ -00019ec0: 6869 5f74 6b74 5f66 6f72 7761 7264 6564  hi_tkt_forwarded
│ │ │ │ -00019ed0: 5f70 3a20 2020 2020 2020 2020 2020 2020  _p:             
│ │ │ │ -00019ee0: 2020 2054 6963 6b65 7420 4675 6e63 7469     Ticket Functi
│ │ │ │ -00019ef0: 6f6e 732e 2020 2028 6c69 6e65 2020 3331  ons.   (line  31
│ │ │ │ -00019f00: 3529 0a2a 2073 6869 7368 695f 746b 745f  5).* shishi_tkt_
│ │ │ │ -00019f10: 6877 5f61 7574 6865 6e74 5f70 3a20 2020  hw_authent_p:   
│ │ │ │ -00019f20: 2020 2020 2020 2020 2020 2020 5469 636b              Tick
│ │ │ │ -00019f30: 6574 2046 756e 6374 696f 6e73 2e20 2020  et Functions.   
│ │ │ │ -00019f40: 286c 696e 6520 2034 3835 290a 2a20 7368  (line  485).* sh
│ │ │ │ -00019f50: 6973 6869 5f74 6b74 5f69 6e69 7469 616c  ishi_tkt_initial
│ │ │ │ -00019f60: 5f70 3a20 2020 2020 2020 2020 2020 2020  _p:             
│ │ │ │ -00019f70: 2020 2020 2054 6963 6b65 7420 4675 6e63       Ticket Func
│ │ │ │ -00019f80: 7469 6f6e 732e 2020 2028 6c69 6e65 2020  tions.   (line  
│ │ │ │ -00019f90: 3434 3929 0a2a 2073 6869 7368 695f 746b  449).* shishi_tk
│ │ │ │ -00019fa0: 745f 696e 7661 6c69 645f 703a 2020 2020  t_invalid_p:    
│ │ │ │ -00019fb0: 2020 2020 2020 2020 2020 2020 2020 5469                Ti
│ │ │ │ -00019fc0: 636b 6574 2046 756e 6374 696f 6e73 2e20  cket Functions. 
│ │ │ │ -00019fd0: 2020 286c 696e 6520 2034 3133 290a 2a20    (line  413).* 
│ │ │ │ -00019fe0: 7368 6973 6869 5f74 6b74 5f6b 6463 7265  shishi_tkt_kdcre
│ │ │ │ -00019ff0: 703a 2020 2020 2020 2020 2020 2020 2020  p:              
│ │ │ │ -0001a000: 2020 2020 2020 2054 6963 6b65 7420 4675         Ticket Fu
│ │ │ │ -0001a010: 6e63 7469 6f6e 732e 2020 2028 6c69 6e65  nctions.   (line
│ │ │ │ -0001a020: 2020 2039 3129 0a2a 2073 6869 7368 695f     91).* shishi_
│ │ │ │ -0001a030: 746b 745f 6b65 793a 2020 2020 2020 2020  tkt_key:        
│ │ │ │ +00019e50: 2020 5469 636b 6574 2046 756e 6374 696f    Ticket Functio
│ │ │ │ +00019e60: 6e73 2e20 2020 286c 696e 6520 2032 3730  ns.   (line  270
│ │ │ │ +00019e70: 290a 2a20 7368 6973 6869 5f74 6b74 5f66  ).* shishi_tkt_f
│ │ │ │ +00019e80: 6f72 7761 7264 6162 6c65 5f70 3a20 2020  orwardable_p:   
│ │ │ │ +00019e90: 2020 2020 2020 2020 2020 2054 6963 6b65             Ticke
│ │ │ │ +00019ea0: 7420 4675 6e63 7469 6f6e 732e 2020 2028  t Functions.   (
│ │ │ │ +00019eb0: 6c69 6e65 2020 3239 3529 0a2a 2073 6869  line  295).* shi
│ │ │ │ +00019ec0: 7368 695f 746b 745f 666f 7277 6172 6465  shi_tkt_forwarde
│ │ │ │ +00019ed0: 645f 703a 2020 2020 2020 2020 2020 2020  d_p:            
│ │ │ │ +00019ee0: 2020 2020 5469 636b 6574 2046 756e 6374      Ticket Funct
│ │ │ │ +00019ef0: 696f 6e73 2e20 2020 286c 696e 6520 2033  ions.   (line  3
│ │ │ │ +00019f00: 3135 290a 2a20 7368 6973 6869 5f74 6b74  15).* shishi_tkt
│ │ │ │ +00019f10: 5f68 775f 6175 7468 656e 745f 703a 2020  _hw_authent_p:  
│ │ │ │ +00019f20: 2020 2020 2020 2020 2020 2020 2054 6963               Tic
│ │ │ │ +00019f30: 6b65 7420 4675 6e63 7469 6f6e 732e 2020  ket Functions.  
│ │ │ │ +00019f40: 2028 6c69 6e65 2020 3438 3529 0a2a 2073   (line  485).* s
│ │ │ │ +00019f50: 6869 7368 695f 746b 745f 696e 6974 6961  hishi_tkt_initia
│ │ │ │ +00019f60: 6c5f 703a 2020 2020 2020 2020 2020 2020  l_p:            
│ │ │ │ +00019f70: 2020 2020 2020 5469 636b 6574 2046 756e        Ticket Fun
│ │ │ │ +00019f80: 6374 696f 6e73 2e20 2020 286c 696e 6520  ctions.   (line 
│ │ │ │ +00019f90: 2034 3439 290a 2a20 7368 6973 6869 5f74   449).* shishi_t
│ │ │ │ +00019fa0: 6b74 5f69 6e76 616c 6964 5f70 3a20 2020  kt_invalid_p:   
│ │ │ │ +00019fb0: 2020 2020 2020 2020 2020 2020 2020 2054                 T
│ │ │ │ +00019fc0: 6963 6b65 7420 4675 6e63 7469 6f6e 732e  icket Functions.
│ │ │ │ +00019fd0: 2020 2028 6c69 6e65 2020 3431 3329 0a2a     (line  413).*
│ │ │ │ +00019fe0: 2073 6869 7368 695f 746b 745f 6b64 6372   shishi_tkt_kdcr
│ │ │ │ +00019ff0: 6570 3a20 2020 2020 2020 2020 2020 2020  ep:             
│ │ │ │ +0001a000: 2020 2020 2020 2020 5469 636b 6574 2046          Ticket F
│ │ │ │ +0001a010: 756e 6374 696f 6e73 2e20 2020 286c 696e  unctions.   (lin
│ │ │ │ +0001a020: 6520 2020 3931 290a 2a20 7368 6973 6869  e   91).* shishi
│ │ │ │ +0001a030: 5f74 6b74 5f6b 6579 3a20 2020 2020 2020  _tkt_key:       
│ │ │ │  0001a040: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001a050: 5469 636b 6574 2046 756e 6374 696f 6e73  Ticket Functions
│ │ │ │ -0001a060: 2e20 2020 286c 696e 6520 2031 3231 290a  .   (line  121).
│ │ │ │ -0001a070: 2a20 7368 6973 6869 5f74 6b74 5f6b 6579  * shishi_tkt_key
│ │ │ │ -0001a080: 5f73 6574 3a20 2020 2020 2020 2020 2020  _set:           
│ │ │ │ -0001a090: 2020 2020 2020 2020 2054 6963 6b65 7420           Ticket 
│ │ │ │ -0001a0a0: 4675 6e63 7469 6f6e 732e 2020 2028 6c69  Functions.   (li
│ │ │ │ -0001a0b0: 6e65 2020 3133 3429 0a2a 2073 6869 7368  ne  134).* shish
│ │ │ │ -0001a0c0: 695f 746b 745f 6b65 7974 7970 653a 2020  i_tkt_keytype:  
│ │ │ │ +0001a050: 2054 6963 6b65 7420 4675 6e63 7469 6f6e   Ticket Function
│ │ │ │ +0001a060: 732e 2020 2028 6c69 6e65 2020 3132 3129  s.   (line  121)
│ │ │ │ +0001a070: 0a2a 2073 6869 7368 695f 746b 745f 6b65  .* shishi_tkt_ke
│ │ │ │ +0001a080: 795f 7365 743a 2020 2020 2020 2020 2020  y_set:          
│ │ │ │ +0001a090: 2020 2020 2020 2020 2020 5469 636b 6574            Ticket
│ │ │ │ +0001a0a0: 2046 756e 6374 696f 6e73 2e20 2020 286c   Functions.   (l
│ │ │ │ +0001a0b0: 696e 6520 2031 3334 290a 2a20 7368 6973  ine  134).* shis
│ │ │ │ +0001a0c0: 6869 5f74 6b74 5f6b 6579 7479 7065 3a20  hi_tkt_keytype: 
│ │ │ │  0001a0d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001a0e0: 2020 5469 636b 6574 2046 756e 6374 696f    Ticket Functio
│ │ │ │ -0001a0f0: 6e73 2e20 2020 286c 696e 6520 2035 3636  ns.   (line  566
│ │ │ │ -0001a100: 290a 2a20 7368 6973 6869 5f74 6b74 5f6b  ).* shishi_tkt_k
│ │ │ │ -0001a110: 6579 7479 7065 5f66 6173 743a 2020 2020  eytype_fast:    
│ │ │ │ -0001a120: 2020 2020 2020 2020 2020 2054 6963 6b65             Ticke
│ │ │ │ -0001a130: 7420 4675 6e63 7469 6f6e 732e 2020 2028  t Functions.   (
│ │ │ │ -0001a140: 6c69 6e65 2020 3537 3829 0a2a 2073 6869  line  578).* shi
│ │ │ │ -0001a150: 7368 695f 746b 745f 6b65 7974 7970 655f  shi_tkt_keytype_
│ │ │ │ -0001a160: 703a 2020 2020 2020 2020 2020 2020 2020  p:              
│ │ │ │ -0001a170: 2020 2020 5469 636b 6574 2046 756e 6374      Ticket Funct
│ │ │ │ -0001a180: 696f 6e73 2e20 2020 286c 696e 6520 2035  ions.   (line  5
│ │ │ │ -0001a190: 3930 290a 2a20 7368 6973 6869 5f74 6b74  90).* shishi_tkt
│ │ │ │ -0001a1a0: 5f6c 6173 7472 6571 5f70 7265 7474 795f  _lastreq_pretty_
│ │ │ │ -0001a1b0: 7072 696e 743a 2020 2020 2020 2054 6963  print:       Tic
│ │ │ │ -0001a1c0: 6b65 7420 4675 6e63 7469 6f6e 732e 2020  ket Functions.  
│ │ │ │ -0001a1d0: 2028 6c69 6e65 2020 3730 3529 0a2a 2073   (line  705).* s
│ │ │ │ -0001a1e0: 6869 7368 695f 746b 745f 6c61 7374 7265  hishi_tkt_lastre
│ │ │ │ -0001a1f0: 7163 3a20 2020 2020 2020 2020 2020 2020  qc:             
│ │ │ │ -0001a200: 2020 2020 2020 5469 636b 6574 2046 756e        Ticket Fun
│ │ │ │ -0001a210: 6374 696f 6e73 2e20 2020 286c 696e 6520  ctions.   (line 
│ │ │ │ -0001a220: 2036 3033 290a 2a20 7368 6973 6869 5f74   603).* shishi_t
│ │ │ │ -0001a230: 6b74 5f6d 6174 6368 5f70 3a20 2020 2020  kt_match_p:     
│ │ │ │ -0001a240: 2020 2020 2020 2020 2020 2020 2020 2054                 T
│ │ │ │ -0001a250: 6963 6b65 7420 5365 7420 4675 6e63 7469  icket Set Functi
│ │ │ │ -0001a260: 6f6e 732e 0a20 2020 2020 2020 2020 2020  ons..           
│ │ │ │ +0001a0e0: 2020 2054 6963 6b65 7420 4675 6e63 7469     Ticket Functi
│ │ │ │ +0001a0f0: 6f6e 732e 2020 2028 6c69 6e65 2020 3536  ons.   (line  56
│ │ │ │ +0001a100: 3629 0a2a 2073 6869 7368 695f 746b 745f  6).* shishi_tkt_
│ │ │ │ +0001a110: 6b65 7974 7970 655f 6661 7374 3a20 2020  keytype_fast:   
│ │ │ │ +0001a120: 2020 2020 2020 2020 2020 2020 5469 636b              Tick
│ │ │ │ +0001a130: 6574 2046 756e 6374 696f 6e73 2e20 2020  et Functions.   
│ │ │ │ +0001a140: 286c 696e 6520 2035 3738 290a 2a20 7368  (line  578).* sh
│ │ │ │ +0001a150: 6973 6869 5f74 6b74 5f6b 6579 7479 7065  ishi_tkt_keytype
│ │ │ │ +0001a160: 5f70 3a20 2020 2020 2020 2020 2020 2020  _p:             
│ │ │ │ +0001a170: 2020 2020 2054 6963 6b65 7420 4675 6e63       Ticket Func
│ │ │ │ +0001a180: 7469 6f6e 732e 2020 2028 6c69 6e65 2020  tions.   (line  
│ │ │ │ +0001a190: 3539 3029 0a2a 2073 6869 7368 695f 746b  590).* shishi_tk
│ │ │ │ +0001a1a0: 745f 6c61 7374 7265 715f 7072 6574 7479  t_lastreq_pretty
│ │ │ │ +0001a1b0: 5f70 7269 6e74 3a20 2020 2020 2020 5469  _print:       Ti
│ │ │ │ +0001a1c0: 636b 6574 2046 756e 6374 696f 6e73 2e20  cket Functions. 
│ │ │ │ +0001a1d0: 2020 286c 696e 6520 2037 3035 290a 2a20    (line  705).* 
│ │ │ │ +0001a1e0: 7368 6973 6869 5f74 6b74 5f6c 6173 7472  shishi_tkt_lastr
│ │ │ │ +0001a1f0: 6571 633a 2020 2020 2020 2020 2020 2020  eqc:            
│ │ │ │ +0001a200: 2020 2020 2020 2054 6963 6b65 7420 4675         Ticket Fu
│ │ │ │ +0001a210: 6e63 7469 6f6e 732e 2020 2028 6c69 6e65  nctions.   (line
│ │ │ │ +0001a220: 2020 3630 3329 0a2a 2073 6869 7368 695f    603).* shishi_
│ │ │ │ +0001a230: 746b 745f 6d61 7463 685f 703a 2020 2020  tkt_match_p:    
│ │ │ │ +0001a240: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0001a250: 5469 636b 6574 2053 6574 2046 756e 6374  Ticket Set Funct
│ │ │ │ +0001a260: 696f 6e73 2e0a 2020 2020 2020 2020 2020  ions..          
│ │ │ │  0001a270: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001a280: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001a290: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001a2a0: 2020 286c 696e 6520 2032 3432 290a 2a20    (line  242).* 
│ │ │ │ -0001a2b0: 7368 6973 6869 5f74 6b74 5f6d 6179 5f70  shishi_tkt_may_p
│ │ │ │ -0001a2c0: 6f73 7464 6174 655f 703a 2020 2020 2020  ostdate_p:      
│ │ │ │ -0001a2d0: 2020 2020 2020 2054 6963 6b65 7420 4675         Ticket Fu
│ │ │ │ -0001a2e0: 6e63 7469 6f6e 732e 2020 2028 6c69 6e65  nctions.   (line
│ │ │ │ -0001a2f0: 2020 3336 3729 0a2a 2073 6869 7368 695f    367).* shishi_
│ │ │ │ -0001a300: 746b 745f 6f6b 5f61 735f 6465 6c65 6761  tkt_ok_as_delega
│ │ │ │ -0001a310: 7465 5f70 3a20 2020 2020 2020 2020 2020  te_p:           
│ │ │ │ -0001a320: 5469 636b 6574 2046 756e 6374 696f 6e73  Ticket Functions
│ │ │ │ -0001a330: 2e20 2020 286c 696e 6520 2035 3433 290a  .   (line  543).
│ │ │ │ -0001a340: 2a20 7368 6973 6869 5f74 6b74 5f70 6f73  * shishi_tkt_pos
│ │ │ │ -0001a350: 7464 6174 6564 5f70 3a20 2020 2020 2020  tdated_p:       
│ │ │ │ -0001a360: 2020 2020 2020 2020 2054 6963 6b65 7420           Ticket 
│ │ │ │ -0001a370: 4675 6e63 7469 6f6e 732e 2020 2028 6c69  Functions.   (li
│ │ │ │ -0001a380: 6e65 2020 3339 3429 0a2a 2073 6869 7368  ne  394).* shish
│ │ │ │ -0001a390: 695f 746b 745f 7072 655f 6175 7468 656e  i_tkt_pre_authen
│ │ │ │ -0001a3a0: 745f 703a 2020 2020 2020 2020 2020 2020  t_p:            
│ │ │ │ -0001a3b0: 2020 5469 636b 6574 2046 756e 6374 696f    Ticket Functio
│ │ │ │ -0001a3c0: 6e73 2e20 2020 286c 696e 6520 2034 3637  ns.   (line  467
│ │ │ │ -0001a3d0: 290a 2a20 7368 6973 6869 5f74 6b74 5f70  ).* shishi_tkt_p
│ │ │ │ -0001a3e0: 7265 7474 795f 7072 696e 743a 2020 2020  retty_print:    
│ │ │ │ -0001a3f0: 2020 2020 2020 2020 2020 2054 6963 6b65             Ticke
│ │ │ │ -0001a400: 7420 4675 6e63 7469 6f6e 732e 2020 2028  t Functions.   (
│ │ │ │ -0001a410: 6c69 6e65 2020 3731 3629 0a2a 2073 6869  line  716).* shi
│ │ │ │ -0001a420: 7368 695f 746b 745f 7072 6f78 6961 626c  shi_tkt_proxiabl
│ │ │ │ -0001a430: 655f 703a 2020 2020 2020 2020 2020 2020  e_p:            
│ │ │ │ -0001a440: 2020 2020 5469 636b 6574 2046 756e 6374      Ticket Funct
│ │ │ │ -0001a450: 696f 6e73 2e20 2020 286c 696e 6520 2033  ions.   (line  3
│ │ │ │ -0001a460: 3333 290a 2a20 7368 6973 6869 5f74 6b74  33).* shishi_tkt
│ │ │ │ -0001a470: 5f70 726f 7879 5f70 3a20 2020 2020 2020  _proxy_p:       
│ │ │ │ -0001a480: 2020 2020 2020 2020 2020 2020 2054 6963               Tic
│ │ │ │ -0001a490: 6b65 7420 4675 6e63 7469 6f6e 732e 2020  ket Functions.  
│ │ │ │ -0001a4a0: 2028 6c69 6e65 2020 3335 3229 0a2a 2073   (line  352).* s
│ │ │ │ -0001a4b0: 6869 7368 695f 746b 745f 7265 616c 6d3a  hishi_tkt_realm:
│ │ │ │ -0001a4c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001a4d0: 2020 2020 2020 5469 636b 6574 2046 756e        Ticket Fun
│ │ │ │ -0001a4e0: 6374 696f 6e73 2e20 2020 286c 696e 6520  ctions.   (line 
│ │ │ │ -0001a4f0: 2032 3132 290a 2a20 7368 6973 6869 5f74   212).* shishi_t
│ │ │ │ -0001a500: 6b74 5f72 656e 6577 5f74 696c 6c63 3a20  kt_renew_tillc: 
│ │ │ │ -0001a510: 2020 2020 2020 2020 2020 2020 2020 2054                 T
│ │ │ │ -0001a520: 6963 6b65 7420 4675 6e63 7469 6f6e 732e  icket Functions.
│ │ │ │ -0001a530: 2020 2028 6c69 6e65 2020 3635 3629 0a2a     (line  656).*
│ │ │ │ -0001a540: 2073 6869 7368 695f 746b 745f 7265 6e65   shishi_tkt_rene
│ │ │ │ -0001a550: 7761 626c 655f 703a 2020 2020 2020 2020  wable_p:        
│ │ │ │ -0001a560: 2020 2020 2020 2020 5469 636b 6574 2046          Ticket F
│ │ │ │ -0001a570: 756e 6374 696f 6e73 2e20 2020 286c 696e  unctions.   (lin
│ │ │ │ -0001a580: 6520 2034 3333 290a 2a20 7368 6973 6869  e  433).* shishi
│ │ │ │ -0001a590: 5f74 6b74 5f73 6572 7665 723a 2020 2020  _tkt_server:    
│ │ │ │ +0001a2a0: 2020 2028 6c69 6e65 2020 3234 3229 0a2a     (line  242).*
│ │ │ │ +0001a2b0: 2073 6869 7368 695f 746b 745f 6d61 795f   shishi_tkt_may_
│ │ │ │ +0001a2c0: 706f 7374 6461 7465 5f70 3a20 2020 2020  postdate_p:     
│ │ │ │ +0001a2d0: 2020 2020 2020 2020 5469 636b 6574 2046          Ticket F
│ │ │ │ +0001a2e0: 756e 6374 696f 6e73 2e20 2020 286c 696e  unctions.   (lin
│ │ │ │ +0001a2f0: 6520 2033 3637 290a 2a20 7368 6973 6869  e  367).* shishi
│ │ │ │ +0001a300: 5f74 6b74 5f6f 6b5f 6173 5f64 656c 6567  _tkt_ok_as_deleg
│ │ │ │ +0001a310: 6174 655f 703a 2020 2020 2020 2020 2020  ate_p:          
│ │ │ │ +0001a320: 2054 6963 6b65 7420 4675 6e63 7469 6f6e   Ticket Function
│ │ │ │ +0001a330: 732e 2020 2028 6c69 6e65 2020 3534 3329  s.   (line  543)
│ │ │ │ +0001a340: 0a2a 2073 6869 7368 695f 746b 745f 706f  .* shishi_tkt_po
│ │ │ │ +0001a350: 7374 6461 7465 645f 703a 2020 2020 2020  stdated_p:      
│ │ │ │ +0001a360: 2020 2020 2020 2020 2020 5469 636b 6574            Ticket
│ │ │ │ +0001a370: 2046 756e 6374 696f 6e73 2e20 2020 286c   Functions.   (l
│ │ │ │ +0001a380: 696e 6520 2033 3934 290a 2a20 7368 6973  ine  394).* shis
│ │ │ │ +0001a390: 6869 5f74 6b74 5f70 7265 5f61 7574 6865  hi_tkt_pre_authe
│ │ │ │ +0001a3a0: 6e74 5f70 3a20 2020 2020 2020 2020 2020  nt_p:           
│ │ │ │ +0001a3b0: 2020 2054 6963 6b65 7420 4675 6e63 7469     Ticket Functi
│ │ │ │ +0001a3c0: 6f6e 732e 2020 2028 6c69 6e65 2020 3436  ons.   (line  46
│ │ │ │ +0001a3d0: 3729 0a2a 2073 6869 7368 695f 746b 745f  7).* shishi_tkt_
│ │ │ │ +0001a3e0: 7072 6574 7479 5f70 7269 6e74 3a20 2020  pretty_print:   
│ │ │ │ +0001a3f0: 2020 2020 2020 2020 2020 2020 5469 636b              Tick
│ │ │ │ +0001a400: 6574 2046 756e 6374 696f 6e73 2e20 2020  et Functions.   
│ │ │ │ +0001a410: 286c 696e 6520 2037 3136 290a 2a20 7368  (line  716).* sh
│ │ │ │ +0001a420: 6973 6869 5f74 6b74 5f70 726f 7869 6162  ishi_tkt_proxiab
│ │ │ │ +0001a430: 6c65 5f70 3a20 2020 2020 2020 2020 2020  le_p:           
│ │ │ │ +0001a440: 2020 2020 2054 6963 6b65 7420 4675 6e63       Ticket Func
│ │ │ │ +0001a450: 7469 6f6e 732e 2020 2028 6c69 6e65 2020  tions.   (line  
│ │ │ │ +0001a460: 3333 3329 0a2a 2073 6869 7368 695f 746b  333).* shishi_tk
│ │ │ │ +0001a470: 745f 7072 6f78 795f 703a 2020 2020 2020  t_proxy_p:      
│ │ │ │ +0001a480: 2020 2020 2020 2020 2020 2020 2020 5469                Ti
│ │ │ │ +0001a490: 636b 6574 2046 756e 6374 696f 6e73 2e20  cket Functions. 
│ │ │ │ +0001a4a0: 2020 286c 696e 6520 2033 3532 290a 2a20    (line  352).* 
│ │ │ │ +0001a4b0: 7368 6973 6869 5f74 6b74 5f72 6561 6c6d  shishi_tkt_realm
│ │ │ │ +0001a4c0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ +0001a4d0: 2020 2020 2020 2054 6963 6b65 7420 4675         Ticket Fu
│ │ │ │ +0001a4e0: 6e63 7469 6f6e 732e 2020 2028 6c69 6e65  nctions.   (line
│ │ │ │ +0001a4f0: 2020 3231 3229 0a2a 2073 6869 7368 695f    212).* shishi_
│ │ │ │ +0001a500: 746b 745f 7265 6e65 775f 7469 6c6c 633a  tkt_renew_tillc:
│ │ │ │ +0001a510: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0001a520: 5469 636b 6574 2046 756e 6374 696f 6e73  Ticket Functions
│ │ │ │ +0001a530: 2e20 2020 286c 696e 6520 2036 3536 290a  .   (line  656).
│ │ │ │ +0001a540: 2a20 7368 6973 6869 5f74 6b74 5f72 656e  * shishi_tkt_ren
│ │ │ │ +0001a550: 6577 6162 6c65 5f70 3a20 2020 2020 2020  ewable_p:       
│ │ │ │ +0001a560: 2020 2020 2020 2020 2054 6963 6b65 7420           Ticket 
│ │ │ │ +0001a570: 4675 6e63 7469 6f6e 732e 2020 2028 6c69  Functions.   (li
│ │ │ │ +0001a580: 6e65 2020 3433 3329 0a2a 2073 6869 7368  ne  433).* shish
│ │ │ │ +0001a590: 695f 746b 745f 7365 7276 6572 3a20 2020  i_tkt_server:   
│ │ │ │  0001a5a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001a5b0: 2054 6963 6b65 7420 4675 6e63 7469 6f6e   Ticket Function
│ │ │ │ -0001a5c0: 732e 2020 2028 6c69 6e65 2020 3232 3729  s.   (line  227)
│ │ │ │ -0001a5d0: 0a2a 2073 6869 7368 695f 746b 745f 7365  .* shishi_tkt_se
│ │ │ │ -0001a5e0: 7276 6572 5f70 3a20 2020 2020 2020 2020  rver_p:         
│ │ │ │ -0001a5f0: 2020 2020 2020 2020 2020 5469 636b 6574            Ticket
│ │ │ │ -0001a600: 2046 756e 6374 696f 6e73 2e20 2020 286c   Functions.   (l
│ │ │ │ -0001a610: 696e 6520 2032 3437 290a 2a20 7368 6973  ine  247).* shis
│ │ │ │ -0001a620: 6869 5f74 6b74 5f73 7461 7274 6374 696d  hi_tkt_startctim
│ │ │ │ -0001a630: 653a 2020 2020 2020 2020 2020 2020 2020  e:              
│ │ │ │ -0001a640: 2020 2054 6963 6b65 7420 4675 6e63 7469     Ticket Functi
│ │ │ │ -0001a650: 6f6e 732e 2020 2028 6c69 6e65 2020 3633  ons.   (line  63
│ │ │ │ -0001a660: 3129 0a2a 2073 6869 7368 695f 746b 745f  1).* shishi_tkt_
│ │ │ │ -0001a670: 7469 636b 6574 3a20 2020 2020 2020 2020  ticket:         
│ │ │ │ -0001a680: 2020 2020 2020 2020 2020 2020 5469 636b              Tick
│ │ │ │ -0001a690: 6574 2046 756e 6374 696f 6e73 2e20 2020  et Functions.   
│ │ │ │ -0001a6a0: 286c 696e 6520 2020 3531 290a 2a20 7368  (line   51).* sh
│ │ │ │ -0001a6b0: 6973 6869 5f74 6b74 5f74 6963 6b65 745f  ishi_tkt_ticket_
│ │ │ │ -0001a6c0: 7365 743a 2020 2020 2020 2020 2020 2020  set:            
│ │ │ │ -0001a6d0: 2020 2020 2054 6963 6b65 7420 4675 6e63       Ticket Func
│ │ │ │ -0001a6e0: 7469 6f6e 732e 2020 2028 6c69 6e65 2020  tions.   (line  
│ │ │ │ -0001a6f0: 2036 3129 0a2a 2073 6869 7368 695f 746b   61).* shishi_tk
│ │ │ │ -0001a700: 745f 7472 616e 7369 7465 645f 706f 6c69  t_transited_poli
│ │ │ │ -0001a710: 6379 5f63 6865 636b 6564 5f70 3a20 5469  cy_checked_p: Ti
│ │ │ │ -0001a720: 636b 6574 2046 756e 6374 696f 6e73 2e20  cket Functions. 
│ │ │ │ -0001a730: 2020 286c 696e 6520 2035 3033 290a 2a20    (line  503).* 
│ │ │ │ -0001a740: 7368 6973 6869 5f74 6b74 5f76 616c 6964  shishi_tkt_valid
│ │ │ │ -0001a750: 5f61 745f 7469 6d65 5f70 3a20 2020 2020  _at_time_p:     
│ │ │ │ -0001a760: 2020 2020 2020 2054 6963 6b65 7420 4675         Ticket Fu
│ │ │ │ -0001a770: 6e63 7469 6f6e 732e 2020 2028 6c69 6e65  nctions.   (line
│ │ │ │ -0001a780: 2020 3636 3929 0a2a 2073 6869 7368 695f    669).* shishi_
│ │ │ │ -0001a790: 746b 745f 7661 6c69 645f 6e6f 775f 703a  tkt_valid_now_p:
│ │ │ │ -0001a7a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001a7b0: 5469 636b 6574 2046 756e 6374 696f 6e73  Ticket Functions
│ │ │ │ -0001a7c0: 2e20 2020 286c 696e 6520 2036 3833 290a  .   (line  683).
│ │ │ │ -0001a7d0: 2a20 7368 6973 6869 5f74 6b74 323a 2020  * shishi_tkt2:  
│ │ │ │ +0001a5b0: 2020 5469 636b 6574 2046 756e 6374 696f    Ticket Functio
│ │ │ │ +0001a5c0: 6e73 2e20 2020 286c 696e 6520 2032 3237  ns.   (line  227
│ │ │ │ +0001a5d0: 290a 2a20 7368 6973 6869 5f74 6b74 5f73  ).* shishi_tkt_s
│ │ │ │ +0001a5e0: 6572 7665 725f 703a 2020 2020 2020 2020  erver_p:        
│ │ │ │ +0001a5f0: 2020 2020 2020 2020 2020 2054 6963 6b65             Ticke
│ │ │ │ +0001a600: 7420 4675 6e63 7469 6f6e 732e 2020 2028  t Functions.   (
│ │ │ │ +0001a610: 6c69 6e65 2020 3234 3729 0a2a 2073 6869  line  247).* shi
│ │ │ │ +0001a620: 7368 695f 746b 745f 7374 6172 7463 7469  shi_tkt_startcti
│ │ │ │ +0001a630: 6d65 3a20 2020 2020 2020 2020 2020 2020  me:             
│ │ │ │ +0001a640: 2020 2020 5469 636b 6574 2046 756e 6374      Ticket Funct
│ │ │ │ +0001a650: 696f 6e73 2e20 2020 286c 696e 6520 2036  ions.   (line  6
│ │ │ │ +0001a660: 3331 290a 2a20 7368 6973 6869 5f74 6b74  31).* shishi_tkt
│ │ │ │ +0001a670: 5f74 6963 6b65 743a 2020 2020 2020 2020  _ticket:        
│ │ │ │ +0001a680: 2020 2020 2020 2020 2020 2020 2054 6963               Tic
│ │ │ │ +0001a690: 6b65 7420 4675 6e63 7469 6f6e 732e 2020  ket Functions.  
│ │ │ │ +0001a6a0: 2028 6c69 6e65 2020 2035 3129 0a2a 2073   (line   51).* s
│ │ │ │ +0001a6b0: 6869 7368 695f 746b 745f 7469 636b 6574  hishi_tkt_ticket
│ │ │ │ +0001a6c0: 5f73 6574 3a20 2020 2020 2020 2020 2020  _set:           
│ │ │ │ +0001a6d0: 2020 2020 2020 5469 636b 6574 2046 756e        Ticket Fun
│ │ │ │ +0001a6e0: 6374 696f 6e73 2e20 2020 286c 696e 6520  ctions.   (line 
│ │ │ │ +0001a6f0: 2020 3631 290a 2a20 7368 6973 6869 5f74    61).* shishi_t
│ │ │ │ +0001a700: 6b74 5f74 7261 6e73 6974 6564 5f70 6f6c  kt_transited_pol
│ │ │ │ +0001a710: 6963 795f 6368 6563 6b65 645f 703a 2054  icy_checked_p: T
│ │ │ │ +0001a720: 6963 6b65 7420 4675 6e63 7469 6f6e 732e  icket Functions.
│ │ │ │ +0001a730: 2020 2028 6c69 6e65 2020 3530 3329 0a2a     (line  503).*
│ │ │ │ +0001a740: 2073 6869 7368 695f 746b 745f 7661 6c69   shishi_tkt_vali
│ │ │ │ +0001a750: 645f 6174 5f74 696d 655f 703a 2020 2020  d_at_time_p:    
│ │ │ │ +0001a760: 2020 2020 2020 2020 5469 636b 6574 2046          Ticket F
│ │ │ │ +0001a770: 756e 6374 696f 6e73 2e20 2020 286c 696e  unctions.   (lin
│ │ │ │ +0001a780: 6520 2036 3639 290a 2a20 7368 6973 6869  e  669).* shishi
│ │ │ │ +0001a790: 5f74 6b74 5f76 616c 6964 5f6e 6f77 5f70  _tkt_valid_now_p
│ │ │ │ +0001a7a0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ +0001a7b0: 2054 6963 6b65 7420 4675 6e63 7469 6f6e   Ticket Function
│ │ │ │ +0001a7c0: 732e 2020 2028 6c69 6e65 2020 3638 3329  s.   (line  683)
│ │ │ │ +0001a7d0: 0a2a 2073 6869 7368 695f 746b 7432 3a20  .* shishi_tkt2: 
│ │ │ │  0001a7e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001a7f0: 2020 2020 2020 2020 2054 6963 6b65 7420           Ticket 
│ │ │ │ -0001a800: 4675 6e63 7469 6f6e 732e 2020 2028 6c69  Functions.   (li
│ │ │ │ -0001a810: 6e65 2020 2032 3729 0a2a 2073 6869 7368  ne   27).* shish
│ │ │ │ -0001a820: 695f 746b 7473 3a20 2020 2020 2020 2020  i_tkts:         
│ │ │ │ +0001a7f0: 2020 2020 2020 2020 2020 5469 636b 6574            Ticket
│ │ │ │ +0001a800: 2046 756e 6374 696f 6e73 2e20 2020 286c   Functions.   (l
│ │ │ │ +0001a810: 696e 6520 2020 3237 290a 2a20 7368 6973  ine   27).* shis
│ │ │ │ +0001a820: 6869 5f74 6b74 733a 2020 2020 2020 2020  hi_tkts:        
│ │ │ │  0001a830: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001a840: 2020 5469 636b 6574 2053 6574 2046 756e    Ticket Set Fun
│ │ │ │ -0001a850: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │ +0001a840: 2020 2054 6963 6b65 7420 5365 7420 4675     Ticket Set Fu
│ │ │ │ +0001a850: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │  0001a860: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001a870: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001a880: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001a890: 2020 2020 2028 6c69 6e65 2020 2036 3829       (line   68)
│ │ │ │ -0001a8a0: 0a2a 2073 6869 7368 695f 746b 7473 5f61  .* shishi_tkts_a
│ │ │ │ -0001a8b0: 6464 3a20 2020 2020 2020 2020 2020 2020  dd:             
│ │ │ │ -0001a8c0: 2020 2020 2020 2020 2020 5469 636b 6574            Ticket
│ │ │ │ -0001a8d0: 2053 6574 2046 756e 6374 696f 6e73 2e0a   Set Functions..
│ │ │ │ -0001a8e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0001a890: 2020 2020 2020 286c 696e 6520 2020 3638        (line   68
│ │ │ │ +0001a8a0: 290a 2a20 7368 6973 6869 5f74 6b74 735f  ).* shishi_tkts_
│ │ │ │ +0001a8b0: 6164 643a 2020 2020 2020 2020 2020 2020  add:            
│ │ │ │ +0001a8c0: 2020 2020 2020 2020 2020 2054 6963 6b65             Ticke
│ │ │ │ +0001a8d0: 7420 5365 7420 4675 6e63 7469 6f6e 732e  t Set Functions.
│ │ │ │ +0001a8e0: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │  0001a8f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001a900: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001a910: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ -0001a920: 6e65 2020 3132 3729 0a2a 2073 6869 7368  ne  127).* shish
│ │ │ │ -0001a930: 695f 746b 7473 5f64 6566 6175 6c74 3a20  i_tkts_default: 
│ │ │ │ +0001a910: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ +0001a920: 696e 6520 2031 3237 290a 2a20 7368 6973  ine  127).* shis
│ │ │ │ +0001a930: 6869 5f74 6b74 735f 6465 6661 756c 743a  hi_tkts_default:
│ │ │ │  0001a940: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001a950: 2020 5469 636b 6574 2053 6574 2046 756e    Ticket Set Fun
│ │ │ │ -0001a960: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │ +0001a950: 2020 2054 6963 6b65 7420 5365 7420 4675     Ticket Set Fu
│ │ │ │ +0001a960: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │  0001a970: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001a980: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001a990: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001a9a0: 2020 2020 2028 6c69 6e65 2020 2035 3829       (line   58)
│ │ │ │ -0001a9b0: 0a2a 2073 6869 7368 695f 746b 7473 5f64  .* shishi_tkts_d
│ │ │ │ -0001a9c0: 6566 6175 6c74 5f66 696c 653a 2020 2020  efault_file:    
│ │ │ │ -0001a9d0: 2020 2020 2020 2020 2020 5469 636b 6574            Ticket
│ │ │ │ -0001a9e0: 2053 6574 2046 756e 6374 696f 6e73 2e0a   Set Functions..
│ │ │ │ -0001a9f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0001a9a0: 2020 2020 2020 286c 696e 6520 2020 3538        (line   58
│ │ │ │ +0001a9b0: 290a 2a20 7368 6973 6869 5f74 6b74 735f  ).* shishi_tkts_
│ │ │ │ +0001a9c0: 6465 6661 756c 745f 6669 6c65 3a20 2020  default_file:   
│ │ │ │ +0001a9d0: 2020 2020 2020 2020 2020 2054 6963 6b65             Ticke
│ │ │ │ +0001a9e0: 7420 5365 7420 4675 6e63 7469 6f6e 732e  t Set Functions.
│ │ │ │ +0001a9f0: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │  0001aa00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001aa10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001aa20: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ -0001aa30: 6e65 2020 2033 3329 0a2a 2073 6869 7368  ne   33).* shish
│ │ │ │ -0001aa40: 695f 746b 7473 5f64 6566 6175 6c74 5f66  i_tkts_default_f
│ │ │ │ -0001aa50: 696c 655f 6775 6573 733a 2020 2020 2020  ile_guess:      
│ │ │ │ -0001aa60: 2020 5469 636b 6574 2053 6574 2046 756e    Ticket Set Fun
│ │ │ │ -0001aa70: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │ +0001aa20: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ +0001aa30: 696e 6520 2020 3333 290a 2a20 7368 6973  ine   33).* shis
│ │ │ │ +0001aa40: 6869 5f74 6b74 735f 6465 6661 756c 745f  hi_tkts_default_
│ │ │ │ +0001aa50: 6669 6c65 5f67 7565 7373 3a20 2020 2020  file_guess:     
│ │ │ │ +0001aa60: 2020 2054 6963 6b65 7420 5365 7420 4675     Ticket Set Fu
│ │ │ │ +0001aa70: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │  0001aa80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001aa90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001aaa0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001aab0: 2020 2020 2028 6c69 6e65 2020 2032 3129       (line   21)
│ │ │ │ -0001aac0: 0a2a 2073 6869 7368 695f 746b 7473 5f64  .* shishi_tkts_d
│ │ │ │ -0001aad0: 6566 6175 6c74 5f66 696c 655f 7365 743a  efault_file_set:
│ │ │ │ -0001aae0: 2020 2020 2020 2020 2020 5469 636b 6574            Ticket
│ │ │ │ -0001aaf0: 2053 6574 2046 756e 6374 696f 6e73 2e0a   Set Functions..
│ │ │ │ -0001ab00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0001aab0: 2020 2020 2020 286c 696e 6520 2020 3231        (line   21
│ │ │ │ +0001aac0: 290a 2a20 7368 6973 6869 5f74 6b74 735f  ).* shishi_tkts_
│ │ │ │ +0001aad0: 6465 6661 756c 745f 6669 6c65 5f73 6574  default_file_set
│ │ │ │ +0001aae0: 3a20 2020 2020 2020 2020 2054 6963 6b65  :          Ticke
│ │ │ │ +0001aaf0: 7420 5365 7420 4675 6e63 7469 6f6e 732e  t Set Functions.
│ │ │ │ +0001ab00: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │  0001ab10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001ab20: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001ab30: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ -0001ab40: 6e65 2020 2034 3529 0a2a 2073 6869 7368  ne   45).* shish
│ │ │ │ -0001ab50: 695f 746b 7473 5f64 6f6e 653a 2020 2020  i_tkts_done:    
│ │ │ │ +0001ab30: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ +0001ab40: 696e 6520 2020 3435 290a 2a20 7368 6973  ine   45).* shis
│ │ │ │ +0001ab50: 6869 5f74 6b74 735f 646f 6e65 3a20 2020  hi_tkts_done:   
│ │ │ │  0001ab60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001ab70: 2020 5469 636b 6574 2053 6574 2046 756e    Ticket Set Fun
│ │ │ │ -0001ab80: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │ +0001ab70: 2020 2054 6963 6b65 7420 5365 7420 4675     Ticket Set Fu
│ │ │ │ +0001ab80: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │  0001ab90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001aba0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001abb0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001abc0: 2020 2020 2028 6c69 6e65 2020 2037 3929       (line   79)
│ │ │ │ -0001abd0: 0a2a 2073 6869 7368 695f 746b 7473 5f65  .* shishi_tkts_e
│ │ │ │ -0001abe0: 7870 6972 653a 2020 2020 2020 2020 2020  xpire:          
│ │ │ │ -0001abf0: 2020 2020 2020 2020 2020 5469 636b 6574            Ticket
│ │ │ │ -0001ac00: 2053 6574 2046 756e 6374 696f 6e73 2e0a   Set Functions..
│ │ │ │ -0001ac10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0001abc0: 2020 2020 2020 286c 696e 6520 2020 3739        (line   79
│ │ │ │ +0001abd0: 290a 2a20 7368 6973 6869 5f74 6b74 735f  ).* shishi_tkts_
│ │ │ │ +0001abe0: 6578 7069 7265 3a20 2020 2020 2020 2020  expire:         
│ │ │ │ +0001abf0: 2020 2020 2020 2020 2020 2054 6963 6b65             Ticke
│ │ │ │ +0001ac00: 7420 5365 7420 4675 6e63 7469 6f6e 732e  t Set Functions.
│ │ │ │ +0001ac10: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │  0001ac20: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001ac30: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001ac40: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ -0001ac50: 6e65 2020 3139 3529 0a2a 2073 6869 7368  ne  195).* shish
│ │ │ │ -0001ac60: 695f 746b 7473 5f66 696e 643a 2020 2020  i_tkts_find:    
│ │ │ │ +0001ac40: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ +0001ac50: 696e 6520 2031 3935 290a 2a20 7368 6973  ine  195).* shis
│ │ │ │ +0001ac60: 6869 5f74 6b74 735f 6669 6e64 3a20 2020  hi_tkts_find:   
│ │ │ │  0001ac70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001ac80: 2020 5469 636b 6574 2053 6574 2046 756e    Ticket Set Fun
│ │ │ │ -0001ac90: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │ +0001ac80: 2020 2054 6963 6b65 7420 5365 7420 4675     Ticket Set Fu
│ │ │ │ +0001ac90: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │  0001aca0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001acb0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001acc0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001acd0: 2020 2020 2028 6c69 6e65 2020 3235 3429       (line  254)
│ │ │ │ -0001ace0: 0a2a 2073 6869 7368 695f 746b 7473 5f66  .* shishi_tkts_f
│ │ │ │ -0001acf0: 696e 645f 666f 725f 636c 6965 6e74 7365  ind_for_clientse
│ │ │ │ -0001ad00: 7276 6572 3a20 2020 2020 5469 636b 6574  rver:     Ticket
│ │ │ │ -0001ad10: 2053 6574 2046 756e 6374 696f 6e73 2e0a   Set Functions..
│ │ │ │ -0001ad20: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0001acd0: 2020 2020 2020 286c 696e 6520 2032 3534        (line  254
│ │ │ │ +0001ace0: 290a 2a20 7368 6973 6869 5f74 6b74 735f  ).* shishi_tkts_
│ │ │ │ +0001acf0: 6669 6e64 5f66 6f72 5f63 6c69 656e 7473  find_for_clients
│ │ │ │ +0001ad00: 6572 7665 723a 2020 2020 2054 6963 6b65  erver:     Ticke
│ │ │ │ +0001ad10: 7420 5365 7420 4675 6e63 7469 6f6e 732e  t Set Functions.
│ │ │ │ +0001ad20: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │  0001ad30: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001ad40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001ad50: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ -0001ad60: 6e65 2020 3239 3429 0a2a 2073 6869 7368  ne  294).* shish
│ │ │ │ -0001ad70: 695f 746b 7473 5f66 696e 645f 666f 725f  i_tkts_find_for_
│ │ │ │ -0001ad80: 7365 7276 6572 3a20 2020 2020 2020 2020  server:         
│ │ │ │ -0001ad90: 2020 5469 636b 6574 2053 6574 2046 756e    Ticket Set Fun
│ │ │ │ -0001ada0: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │ +0001ad50: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ +0001ad60: 696e 6520 2032 3934 290a 2a20 7368 6973  ine  294).* shis
│ │ │ │ +0001ad70: 6869 5f74 6b74 735f 6669 6e64 5f66 6f72  hi_tkts_find_for
│ │ │ │ +0001ad80: 5f73 6572 7665 723a 2020 2020 2020 2020  _server:        
│ │ │ │ +0001ad90: 2020 2054 6963 6b65 7420 5365 7420 4675     Ticket Set Fu
│ │ │ │ +0001ada0: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │  0001adb0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001adc0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001add0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001ade0: 2020 2020 2028 6c69 6e65 2020 3330 3929       (line  309)
│ │ │ │ -0001adf0: 0a2a 2073 6869 7368 695f 746b 7473 5f66  .* shishi_tkts_f
│ │ │ │ -0001ae00: 726f 6d5f 6669 6c65 3a20 2020 2020 2020  rom_file:       
│ │ │ │ -0001ae10: 2020 2020 2020 2020 2020 5469 636b 6574            Ticket
│ │ │ │ -0001ae20: 2053 6574 2046 756e 6374 696f 6e73 2e0a   Set Functions..
│ │ │ │ -0001ae30: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0001ade0: 2020 2020 2020 286c 696e 6520 2033 3039        (line  309
│ │ │ │ +0001adf0: 290a 2a20 7368 6973 6869 5f74 6b74 735f  ).* shishi_tkts_
│ │ │ │ +0001ae00: 6672 6f6d 5f66 696c 653a 2020 2020 2020  from_file:      
│ │ │ │ +0001ae10: 2020 2020 2020 2020 2020 2054 6963 6b65             Ticke
│ │ │ │ +0001ae20: 7420 5365 7420 4675 6e63 7469 6f6e 732e  t Set Functions.
│ │ │ │ +0001ae30: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │  0001ae40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001ae50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001ae60: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ -0001ae70: 6e65 2020 3137 3129 0a2a 2073 6869 7368  ne  171).* shish
│ │ │ │ -0001ae80: 695f 746b 7473 5f67 6574 3a20 2020 2020  i_tkts_get:     
│ │ │ │ +0001ae60: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ +0001ae70: 696e 6520 2031 3731 290a 2a20 7368 6973  ine  171).* shis
│ │ │ │ +0001ae80: 6869 5f74 6b74 735f 6765 743a 2020 2020  hi_tkts_get:    
│ │ │ │  0001ae90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001aea0: 2020 5469 636b 6574 2053 6574 2046 756e    Ticket Set Fun
│ │ │ │ -0001aeb0: 6374 696f 6e73 2e0a 2020 2020 2020 2020  ctions..        
│ │ │ │ +0001aea0: 2020 2054 6963 6b65 7420 5365 7420 4675     Ticket Set Fu
│ │ │ │ +0001aeb0: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │  0001aec0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001aed0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001aee0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001aef0: 2020 2020 2028 6c69 6e65 2020 3336 3229       (line  362)
│ │ │ │ -0001af00: 0a2a 2073 6869 7368 695f 746b 7473 5f67  .* shishi_tkts_g
│ │ │ │ -0001af10: 6574 5f66 6f72 5f63 6c69 656e 7473 6572  et_for_clientser
│ │ │ │ -0001af20: 7665 723a 2020 2020 2020 5469 636b 6574  ver:      Ticket
│ │ │ │ -0001af30: 2053 6574 2046 756e 6374 696f 6e73 2e0a   Set Functions..
│ │ │ │ -0001af40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0001aef0: 2020 2020 2020 286c 696e 6520 2033 3632        (line  362
│ │ │ │ +0001af00: 290a 2a20 7368 6973 6869 5f74 6b74 735f  ).* shishi_tkts_
│ │ │ │ +0001af10: 6765 745f 666f 725f 636c 6965 6e74 7365  get_for_clientse
│ │ │ │ +0001af20: 7276 6572 3a20 2020 2020 2054 6963 6b65  rver:      Ticke
│ │ │ │ +0001af30: 7420 5365 7420 4675 6e63 7469 6f6e 732e  t Set Functions.
│ │ │ │ +0001af40: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │  0001af50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001af60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001af70: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ -0001af80: 6e65 2020 3338 3129 0a2a 2073 6869 7368  ne  381).* shish
│ │ │ │ -0001af90: 695f 746b 7473 5f67 6574 5f66 6f72 5f6c  i_tkts_get_for_l
│ │ │ │ -0001afa0: 6f63 616c 7365 7276 6963 6570 6173 7377  ocalservicepassw
│ │ │ │ -0001afb0: 643a 2054 6963 6b65 7420 5365 7420 4675  d: Ticket Set Fu
│ │ │ │ -0001afc0: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │ +0001af70: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ +0001af80: 696e 6520 2033 3831 290a 2a20 7368 6973  ine  381).* shis
│ │ │ │ +0001af90: 6869 5f74 6b74 735f 6765 745f 666f 725f  hi_tkts_get_for_
│ │ │ │ +0001afa0: 6c6f 6361 6c73 6572 7669 6365 7061 7373  localservicepass
│ │ │ │ +0001afb0: 7764 3a20 5469 636b 6574 2053 6574 2046  wd: Ticket Set F
│ │ │ │ +0001afc0: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │  0001afd0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001afe0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001aff0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001b000: 2020 2020 2020 286c 696e 6520 2034 3039        (line  409
│ │ │ │ -0001b010: 290a 2a20 7368 6973 6869 5f74 6b74 735f  ).* shishi_tkts_
│ │ │ │ -0001b020: 6765 745f 666f 725f 7365 7276 6572 3a20  get_for_server: 
│ │ │ │ -0001b030: 2020 2020 2020 2020 2020 2054 6963 6b65             Ticke
│ │ │ │ -0001b040: 7420 5365 7420 4675 6e63 7469 6f6e 732e  t Set Functions.
│ │ │ │ -0001b050: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ +0001b000: 2020 2020 2020 2028 6c69 6e65 2020 3430         (line  40
│ │ │ │ +0001b010: 3929 0a2a 2073 6869 7368 695f 746b 7473  9).* shishi_tkts
│ │ │ │ +0001b020: 5f67 6574 5f66 6f72 5f73 6572 7665 723a  _get_for_server:
│ │ │ │ +0001b030: 2020 2020 2020 2020 2020 2020 5469 636b              Tick
│ │ │ │ +0001b040: 6574 2053 6574 2046 756e 6374 696f 6e73  et Set Functions
│ │ │ │ +0001b050: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │  0001b060: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001b070: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001b080: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ -0001b090: 696e 6520 2033 3935 290a 2a20 7368 6973  ine  395).* shis
│ │ │ │ -0001b0a0: 6869 5f74 6b74 735f 6765 745f 7467 733a  hi_tkts_get_tgs:
│ │ │ │ -0001b0b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001b0c0: 2020 2054 6963 6b65 7420 5365 7420 4675     Ticket Set Fu
│ │ │ │ -0001b0d0: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │ +0001b080: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ +0001b090: 6c69 6e65 2020 3339 3529 0a2a 2073 6869  line  395).* shi
│ │ │ │ +0001b0a0: 7368 695f 746b 7473 5f67 6574 5f74 6773  shi_tkts_get_tgs
│ │ │ │ +0001b0b0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ +0001b0c0: 2020 2020 5469 636b 6574 2053 6574 2046      Ticket Set F
│ │ │ │ +0001b0d0: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │  0001b0e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001b0f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001b100: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001b110: 2020 2020 2020 286c 696e 6520 2033 3434        (line  344
│ │ │ │ -0001b120: 290a 2a20 7368 6973 6869 5f74 6b74 735f  ).* shishi_tkts_
│ │ │ │ -0001b130: 6765 745f 7467 743a 2020 2020 2020 2020  get_tgt:        
│ │ │ │ -0001b140: 2020 2020 2020 2020 2020 2054 6963 6b65             Ticke
│ │ │ │ -0001b150: 7420 5365 7420 4675 6e63 7469 6f6e 732e  t Set Functions.
│ │ │ │ -0001b160: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ +0001b110: 2020 2020 2020 2028 6c69 6e65 2020 3334         (line  34
│ │ │ │ +0001b120: 3429 0a2a 2073 6869 7368 695f 746b 7473  4).* shishi_tkts
│ │ │ │ +0001b130: 5f67 6574 5f74 6774 3a20 2020 2020 2020  _get_tgt:       
│ │ │ │ +0001b140: 2020 2020 2020 2020 2020 2020 5469 636b              Tick
│ │ │ │ +0001b150: 6574 2053 6574 2046 756e 6374 696f 6e73  et Set Functions
│ │ │ │ +0001b160: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │  0001b170: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001b180: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001b190: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ -0001b1a0: 696e 6520 2033 3233 290a 2a20 7368 6973  ine  323).* shis
│ │ │ │ -0001b1b0: 6869 5f74 6b74 735f 6e65 773a 2020 2020  hi_tkts_new:    
│ │ │ │ +0001b190: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ +0001b1a0: 6c69 6e65 2020 3332 3329 0a2a 2073 6869  line  323).* shi
│ │ │ │ +0001b1b0: 7368 695f 746b 7473 5f6e 6577 3a20 2020  shi_tkts_new:   
│ │ │ │  0001b1c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001b1d0: 2020 2054 6963 6b65 7420 5365 7420 4675     Ticket Set Fu
│ │ │ │ -0001b1e0: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │ +0001b1d0: 2020 2020 5469 636b 6574 2053 6574 2046      Ticket Set F
│ │ │ │ +0001b1e0: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │  0001b1f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001b200: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001b210: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001b220: 2020 2020 2020 286c 696e 6520 2031 3430        (line  140
│ │ │ │ -0001b230: 290a 2a20 7368 6973 6869 5f74 6b74 735f  ).* shishi_tkts_
│ │ │ │ -0001b240: 6e74 683a 2020 2020 2020 2020 2020 2020  nth:            
│ │ │ │ -0001b250: 2020 2020 2020 2020 2020 2054 6963 6b65             Ticke
│ │ │ │ -0001b260: 7420 5365 7420 4675 6e63 7469 6f6e 732e  t Set Functions.
│ │ │ │ -0001b270: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ +0001b220: 2020 2020 2020 2028 6c69 6e65 2020 3134         (line  14
│ │ │ │ +0001b230: 3029 0a2a 2073 6869 7368 695f 746b 7473  0).* shishi_tkts
│ │ │ │ +0001b240: 5f6e 7468 3a20 2020 2020 2020 2020 2020  _nth:           
│ │ │ │ +0001b250: 2020 2020 2020 2020 2020 2020 5469 636b              Tick
│ │ │ │ +0001b260: 6574 2053 6574 2046 756e 6374 696f 6e73  et Set Functions
│ │ │ │ +0001b270: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │  0001b280: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001b290: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001b2a0: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ -0001b2b0: 696e 6520 2020 3939 290a 2a20 7368 6973  ine   99).* shis
│ │ │ │ -0001b2c0: 6869 5f74 6b74 735f 7072 696e 743a 2020  hi_tkts_print:  
│ │ │ │ +0001b2a0: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ +0001b2b0: 6c69 6e65 2020 2039 3929 0a2a 2073 6869  line   99).* shi
│ │ │ │ +0001b2c0: 7368 695f 746b 7473 5f70 7269 6e74 3a20  shi_tkts_print: 
│ │ │ │  0001b2d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001b2e0: 2020 2054 6963 6b65 7420 5365 7420 4675     Ticket Set Fu
│ │ │ │ -0001b2f0: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │ +0001b2e0: 2020 2020 5469 636b 6574 2053 6574 2046      Ticket Set F
│ │ │ │ +0001b2f0: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │  0001b300: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001b310: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001b320: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001b330: 2020 2020 2020 286c 696e 6520 2032 3331        (line  231
│ │ │ │ -0001b340: 290a 2a20 7368 6973 6869 5f74 6b74 735f  ).* shishi_tkts_
│ │ │ │ -0001b350: 7072 696e 745f 666f 725f 7365 7276 6963  print_for_servic
│ │ │ │ -0001b360: 653a 2020 2020 2020 2020 2054 6963 6b65  e:         Ticke
│ │ │ │ -0001b370: 7420 5365 7420 4675 6e63 7469 6f6e 732e  t Set Functions.
│ │ │ │ -0001b380: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ +0001b330: 2020 2020 2020 2028 6c69 6e65 2020 3233         (line  23
│ │ │ │ +0001b340: 3129 0a2a 2073 6869 7368 695f 746b 7473  1).* shishi_tkts
│ │ │ │ +0001b350: 5f70 7269 6e74 5f66 6f72 5f73 6572 7669  _print_for_servi
│ │ │ │ +0001b360: 6365 3a20 2020 2020 2020 2020 5469 636b  ce:         Tick
│ │ │ │ +0001b370: 6574 2053 6574 2046 756e 6374 696f 6e73  et Set Functions
│ │ │ │ +0001b380: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │  0001b390: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001b3a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001b3b0: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ -0001b3c0: 696e 6520 2032 3137 290a 2a20 7368 6973  ine  217).* shis
│ │ │ │ -0001b3d0: 6869 5f74 6b74 735f 7265 6164 3a20 2020  hi_tkts_read:   
│ │ │ │ +0001b3b0: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ +0001b3c0: 6c69 6e65 2020 3231 3729 0a2a 2073 6869  line  217).* shi
│ │ │ │ +0001b3d0: 7368 695f 746b 7473 5f72 6561 643a 2020  shi_tkts_read:  
│ │ │ │  0001b3e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001b3f0: 2020 2054 6963 6b65 7420 5365 7420 4675     Ticket Set Fu
│ │ │ │ -0001b400: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │ +0001b3f0: 2020 2020 5469 636b 6574 2053 6574 2046      Ticket Set F
│ │ │ │ +0001b400: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │  0001b410: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001b420: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001b430: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001b440: 2020 2020 2020 286c 696e 6520 2031 3539        (line  159
│ │ │ │ -0001b450: 290a 2a20 7368 6973 6869 5f74 6b74 735f  ).* shishi_tkts_
│ │ │ │ -0001b460: 7265 6d6f 7665 3a20 2020 2020 2020 2020  remove:         
│ │ │ │ -0001b470: 2020 2020 2020 2020 2020 2054 6963 6b65             Ticke
│ │ │ │ -0001b480: 7420 5365 7420 4675 6e63 7469 6f6e 732e  t Set Functions.
│ │ │ │ -0001b490: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ +0001b440: 2020 2020 2020 2028 6c69 6e65 2020 3135         (line  15
│ │ │ │ +0001b450: 3929 0a2a 2073 6869 7368 695f 746b 7473  9).* shishi_tkts
│ │ │ │ +0001b460: 5f72 656d 6f76 653a 2020 2020 2020 2020  _remove:        
│ │ │ │ +0001b470: 2020 2020 2020 2020 2020 2020 5469 636b              Tick
│ │ │ │ +0001b480: 6574 2053 6574 2046 756e 6374 696f 6e73  et Set Functions
│ │ │ │ +0001b490: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │  0001b4a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001b4b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001b4c0: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ -0001b4d0: 696e 6520 2031 3134 290a 2a20 7368 6973  ine  114).* shis
│ │ │ │ -0001b4e0: 6869 5f74 6b74 735f 7369 7a65 3a20 2020  hi_tkts_size:   
│ │ │ │ +0001b4c0: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ +0001b4d0: 6c69 6e65 2020 3131 3429 0a2a 2073 6869  line  114).* shi
│ │ │ │ +0001b4e0: 7368 695f 746b 7473 5f73 697a 653a 2020  shi_tkts_size:  
│ │ │ │  0001b4f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001b500: 2020 2054 6963 6b65 7420 5365 7420 4675     Ticket Set Fu
│ │ │ │ -0001b510: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │ +0001b500: 2020 2020 5469 636b 6574 2053 6574 2046      Ticket Set F
│ │ │ │ +0001b510: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │  0001b520: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001b530: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001b540: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001b550: 2020 2020 2020 286c 696e 6520 2020 3839        (line   89
│ │ │ │ -0001b560: 290a 2a20 7368 6973 6869 5f74 6b74 735f  ).* shishi_tkts_
│ │ │ │ -0001b570: 746f 5f66 696c 653a 2020 2020 2020 2020  to_file:        
│ │ │ │ -0001b580: 2020 2020 2020 2020 2020 2054 6963 6b65             Ticke
│ │ │ │ -0001b590: 7420 5365 7420 4675 6e63 7469 6f6e 732e  t Set Functions.
│ │ │ │ -0001b5a0: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ +0001b550: 2020 2020 2020 2028 6c69 6e65 2020 2038         (line   8
│ │ │ │ +0001b560: 3929 0a2a 2073 6869 7368 695f 746b 7473  9).* shishi_tkts
│ │ │ │ +0001b570: 5f74 6f5f 6669 6c65 3a20 2020 2020 2020  _to_file:       
│ │ │ │ +0001b580: 2020 2020 2020 2020 2020 2020 5469 636b              Tick
│ │ │ │ +0001b590: 6574 2053 6574 2046 756e 6374 696f 6e73  et Set Functions
│ │ │ │ +0001b5a0: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │  0001b5b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001b5c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001b5d0: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ -0001b5e0: 696e 6520 2032 3035 290a 2a20 7368 6973  ine  205).* shis
│ │ │ │ -0001b5f0: 6869 5f74 6b74 735f 7772 6974 653a 2020  hi_tkts_write:  
│ │ │ │ +0001b5d0: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ +0001b5e0: 6c69 6e65 2020 3230 3529 0a2a 2073 6869  line  205).* shi
│ │ │ │ +0001b5f0: 7368 695f 746b 7473 5f77 7269 7465 3a20  shi_tkts_write: 
│ │ │ │  0001b600: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001b610: 2020 2054 6963 6b65 7420 5365 7420 4675     Ticket Set Fu
│ │ │ │ -0001b620: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │ +0001b610: 2020 2020 5469 636b 6574 2053 6574 2046      Ticket Set F
│ │ │ │ +0001b620: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │  0001b630: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001b640: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001b650: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001b660: 2020 2020 2020 286c 696e 6520 2031 3834        (line  184
│ │ │ │ -0001b670: 290a 2a20 7368 6973 6869 5f76 6572 626f  ).* shishi_verbo
│ │ │ │ -0001b680: 7365 3a20 2020 2020 2020 2020 2020 2020  se:             
│ │ │ │ -0001b690: 2020 2020 2020 2020 2020 2045 7272 6f72             Error
│ │ │ │ -0001b6a0: 2046 756e 6374 696f 6e73 2e20 2020 2028   Functions.    (
│ │ │ │ -0001b6b0: 6c69 6e65 2020 3133 3429 0a2a 2073 6869  line  134).* shi
│ │ │ │ -0001b6c0: 7368 695f 7665 7269 6679 3a20 2020 2020  shi_verify:     
│ │ │ │ +0001b660: 2020 2020 2020 2028 6c69 6e65 2020 3138         (line  18
│ │ │ │ +0001b670: 3429 0a2a 2073 6869 7368 695f 7665 7262  4).* shishi_verb
│ │ │ │ +0001b680: 6f73 653a 2020 2020 2020 2020 2020 2020  ose:            
│ │ │ │ +0001b690: 2020 2020 2020 2020 2020 2020 4572 726f              Erro
│ │ │ │ +0001b6a0: 7220 4675 6e63 7469 6f6e 732e 2020 2020  r Functions.    
│ │ │ │ +0001b6b0: 286c 696e 6520 2031 3334 290a 2a20 7368  (line  134).* sh
│ │ │ │ +0001b6c0: 6973 6869 5f76 6572 6966 793a 2020 2020  ishi_verify:    
│ │ │ │  0001b6d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001b6e0: 2020 2020 4372 7970 746f 6772 6170 6869      Cryptographi
│ │ │ │ -0001b6f0: 6320 4675 6e63 7469 6f6e 732e 0a20 2020  c Functions..   
│ │ │ │ +0001b6e0: 2020 2020 2043 7279 7074 6f67 7261 7068       Cryptograph
│ │ │ │ +0001b6f0: 6963 2046 756e 6374 696f 6e73 2e0a 2020  ic Functions..  
│ │ │ │  0001b700: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001b710: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001b720: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001b730: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ -0001b740: 2037 3938 290a 2a20 7368 6973 6869 5f77   798).* shishi_w
│ │ │ │ -0001b750: 6172 6e3a 2020 2020 2020 2020 2020 2020  arn:            
│ │ │ │ -0001b760: 2020 2020 2020 2020 2020 2020 2020 2045                 E
│ │ │ │ -0001b770: 7272 6f72 2046 756e 6374 696f 6e73 2e20  rror Functions. 
│ │ │ │ -0001b780: 2020 2028 6c69 6e65 2020 3132 3229 0a2a     (line  122).*
│ │ │ │ -0001b790: 2073 6869 7368 695f 7835 3039 6361 5f64   shishi_x509ca_d
│ │ │ │ -0001b7a0: 6566 6175 6c74 5f66 696c 653a 2020 2020  efault_file:    
│ │ │ │ -0001b7b0: 2020 2020 2020 2020 582e 3530 3920 4675          X.509 Fu
│ │ │ │ -0001b7c0: 6e63 7469 6f6e 732e 2020 2020 286c 696e  nctions.    (lin
│ │ │ │ -0001b7d0: 6520 2020 3339 290a 2a20 7368 6973 6869  e   39).* shishi
│ │ │ │ -0001b7e0: 5f78 3530 3963 615f 6465 6661 756c 745f  _x509ca_default_
│ │ │ │ -0001b7f0: 6669 6c65 5f67 7565 7373 3a20 2020 2020  file_guess:     
│ │ │ │ -0001b800: 2058 2e35 3039 2046 756e 6374 696f 6e73   X.509 Functions
│ │ │ │ -0001b810: 2e20 2020 2028 6c69 6e65 2020 2031 3229  .    (line   12)
│ │ │ │ -0001b820: 0a2a 2073 6869 7368 695f 7835 3039 6361  .* shishi_x509ca
│ │ │ │ -0001b830: 5f64 6566 6175 6c74 5f66 696c 655f 7365  _default_file_se
│ │ │ │ -0001b840: 743a 2020 2020 2020 2020 582e 3530 3920  t:        X.509 
│ │ │ │ -0001b850: 4675 6e63 7469 6f6e 732e 2020 2020 286c  Functions.    (l
│ │ │ │ -0001b860: 696e 6520 2020 3234 290a 2a20 7368 6973  ine   24).* shis
│ │ │ │ -0001b870: 6869 5f78 3530 3963 6572 745f 6465 6661  hi_x509cert_defa
│ │ │ │ -0001b880: 756c 745f 6669 6c65 3a20 2020 2020 2020  ult_file:       
│ │ │ │ -0001b890: 2020 2058 2e35 3039 2046 756e 6374 696f     X.509 Functio
│ │ │ │ -0001b8a0: 6e73 2e20 2020 2028 6c69 6e65 2020 2038  ns.    (line   8
│ │ │ │ -0001b8b0: 3029 0a2a 2073 6869 7368 695f 7835 3039  0).* shishi_x509
│ │ │ │ -0001b8c0: 6365 7274 5f64 6566 6175 6c74 5f66 696c  cert_default_fil
│ │ │ │ -0001b8d0: 655f 6775 6573 733a 2020 2020 582e 3530  e_guess:    X.50
│ │ │ │ -0001b8e0: 3920 4675 6e63 7469 6f6e 732e 2020 2020  9 Functions.    
│ │ │ │ -0001b8f0: 286c 696e 6520 2020 3532 290a 2a20 7368  (line   52).* sh
│ │ │ │ -0001b900: 6973 6869 5f78 3530 3963 6572 745f 6465  ishi_x509cert_de
│ │ │ │ -0001b910: 6661 756c 745f 6669 6c65 5f73 6574 3a20  fault_file_set: 
│ │ │ │ -0001b920: 2020 2020 2058 2e35 3039 2046 756e 6374       X.509 Funct
│ │ │ │ -0001b930: 696f 6e73 2e20 2020 2028 6c69 6e65 2020  ions.    (line  
│ │ │ │ -0001b940: 2036 3529 0a2a 2073 6869 7368 695f 7835   65).* shishi_x5
│ │ │ │ -0001b950: 3039 6b65 795f 6465 6661 756c 745f 6669  09key_default_fi
│ │ │ │ -0001b960: 6c65 3a20 2020 2020 2020 2020 2020 582e  le:           X.
│ │ │ │ -0001b970: 3530 3920 4675 6e63 7469 6f6e 732e 2020  509 Functions.  
│ │ │ │ -0001b980: 2020 286c 696e 6520 2031 3231 290a 2a20    (line  121).* 
│ │ │ │ -0001b990: 7368 6973 6869 5f78 3530 396b 6579 5f64  shishi_x509key_d
│ │ │ │ -0001b9a0: 6566 6175 6c74 5f66 696c 655f 6775 6573  efault_file_gues
│ │ │ │ -0001b9b0: 733a 2020 2020 2058 2e35 3039 2046 756e  s:     X.509 Fun
│ │ │ │ -0001b9c0: 6374 696f 6e73 2e20 2020 2028 6c69 6e65  ctions.    (line
│ │ │ │ -0001b9d0: 2020 2039 3429 0a2a 2073 6869 7368 695f     94).* shishi_
│ │ │ │ -0001b9e0: 7835 3039 6b65 795f 6465 6661 756c 745f  x509key_default_
│ │ │ │ -0001b9f0: 6669 6c65 5f73 6574 3a20 2020 2020 2020  file_set:       
│ │ │ │ -0001ba00: 582e 3530 3920 4675 6e63 7469 6f6e 732e  X.509 Functions.
│ │ │ │ -0001ba10: 2020 2020 286c 696e 6520 2031 3036 290a      (line  106).
│ │ │ │ -0001ba20: 2a20 7468 6973 2069 6e20 6461 7465 2073  * this in date s
│ │ │ │ -0001ba30: 7472 696e 6773 3a20 2020 2020 2020 2020  trings:         
│ │ │ │ -0001ba40: 2020 2020 2020 2020 2052 656c 6174 6976           Relativ
│ │ │ │ -0001ba50: 6520 6974 656d 7320 696e 2064 6174 6520  e items in date 
│ │ │ │ -0001ba60: 7374 7269 6e67 732e 0a20 2020 2020 2020  strings..       
│ │ │ │ +0001b730: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ +0001b740: 2020 3739 3829 0a2a 2073 6869 7368 695f    798).* shishi_
│ │ │ │ +0001b750: 7761 726e 3a20 2020 2020 2020 2020 2020  warn:           
│ │ │ │ +0001b760: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0001b770: 4572 726f 7220 4675 6e63 7469 6f6e 732e  Error Functions.
│ │ │ │ +0001b780: 2020 2020 286c 696e 6520 2031 3232 290a      (line  122).
│ │ │ │ +0001b790: 2a20 7368 6973 6869 5f78 3530 3963 615f  * shishi_x509ca_
│ │ │ │ +0001b7a0: 6465 6661 756c 745f 6669 6c65 3a20 2020  default_file:   
│ │ │ │ +0001b7b0: 2020 2020 2020 2020 2058 2e35 3039 2046           X.509 F
│ │ │ │ +0001b7c0: 756e 6374 696f 6e73 2e20 2020 2028 6c69  unctions.    (li
│ │ │ │ +0001b7d0: 6e65 2020 2033 3929 0a2a 2073 6869 7368  ne   39).* shish
│ │ │ │ +0001b7e0: 695f 7835 3039 6361 5f64 6566 6175 6c74  i_x509ca_default
│ │ │ │ +0001b7f0: 5f66 696c 655f 6775 6573 733a 2020 2020  _file_guess:    
│ │ │ │ +0001b800: 2020 582e 3530 3920 4675 6e63 7469 6f6e    X.509 Function
│ │ │ │ +0001b810: 732e 2020 2020 286c 696e 6520 2020 3132  s.    (line   12
│ │ │ │ +0001b820: 290a 2a20 7368 6973 6869 5f78 3530 3963  ).* shishi_x509c
│ │ │ │ +0001b830: 615f 6465 6661 756c 745f 6669 6c65 5f73  a_default_file_s
│ │ │ │ +0001b840: 6574 3a20 2020 2020 2020 2058 2e35 3039  et:        X.509
│ │ │ │ +0001b850: 2046 756e 6374 696f 6e73 2e20 2020 2028   Functions.    (
│ │ │ │ +0001b860: 6c69 6e65 2020 2032 3429 0a2a 2073 6869  line   24).* shi
│ │ │ │ +0001b870: 7368 695f 7835 3039 6365 7274 5f64 6566  shi_x509cert_def
│ │ │ │ +0001b880: 6175 6c74 5f66 696c 653a 2020 2020 2020  ault_file:      
│ │ │ │ +0001b890: 2020 2020 582e 3530 3920 4675 6e63 7469      X.509 Functi
│ │ │ │ +0001b8a0: 6f6e 732e 2020 2020 286c 696e 6520 2020  ons.    (line   
│ │ │ │ +0001b8b0: 3830 290a 2a20 7368 6973 6869 5f78 3530  80).* shishi_x50
│ │ │ │ +0001b8c0: 3963 6572 745f 6465 6661 756c 745f 6669  9cert_default_fi
│ │ │ │ +0001b8d0: 6c65 5f67 7565 7373 3a20 2020 2058 2e35  le_guess:    X.5
│ │ │ │ +0001b8e0: 3039 2046 756e 6374 696f 6e73 2e20 2020  09 Functions.   
│ │ │ │ +0001b8f0: 2028 6c69 6e65 2020 2035 3229 0a2a 2073   (line   52).* s
│ │ │ │ +0001b900: 6869 7368 695f 7835 3039 6365 7274 5f64  hishi_x509cert_d
│ │ │ │ +0001b910: 6566 6175 6c74 5f66 696c 655f 7365 743a  efault_file_set:
│ │ │ │ +0001b920: 2020 2020 2020 582e 3530 3920 4675 6e63        X.509 Func
│ │ │ │ +0001b930: 7469 6f6e 732e 2020 2020 286c 696e 6520  tions.    (line 
│ │ │ │ +0001b940: 2020 3635 290a 2a20 7368 6973 6869 5f78    65).* shishi_x
│ │ │ │ +0001b950: 3530 396b 6579 5f64 6566 6175 6c74 5f66  509key_default_f
│ │ │ │ +0001b960: 696c 653a 2020 2020 2020 2020 2020 2058  ile:           X
│ │ │ │ +0001b970: 2e35 3039 2046 756e 6374 696f 6e73 2e20  .509 Functions. 
│ │ │ │ +0001b980: 2020 2028 6c69 6e65 2020 3132 3129 0a2a     (line  121).*
│ │ │ │ +0001b990: 2073 6869 7368 695f 7835 3039 6b65 795f   shishi_x509key_
│ │ │ │ +0001b9a0: 6465 6661 756c 745f 6669 6c65 5f67 7565  default_file_gue
│ │ │ │ +0001b9b0: 7373 3a20 2020 2020 582e 3530 3920 4675  ss:     X.509 Fu
│ │ │ │ +0001b9c0: 6e63 7469 6f6e 732e 2020 2020 286c 696e  nctions.    (lin
│ │ │ │ +0001b9d0: 6520 2020 3934 290a 2a20 7368 6973 6869  e   94).* shishi
│ │ │ │ +0001b9e0: 5f78 3530 396b 6579 5f64 6566 6175 6c74  _x509key_default
│ │ │ │ +0001b9f0: 5f66 696c 655f 7365 743a 2020 2020 2020  _file_set:      
│ │ │ │ +0001ba00: 2058 2e35 3039 2046 756e 6374 696f 6e73   X.509 Functions
│ │ │ │ +0001ba10: 2e20 2020 2028 6c69 6e65 2020 3130 3629  .    (line  106)
│ │ │ │ +0001ba20: 0a2a 2074 6869 7320 696e 2064 6174 6520  .* this in date 
│ │ │ │ +0001ba30: 7374 7269 6e67 733a 2020 2020 2020 2020  strings:        
│ │ │ │ +0001ba40: 2020 2020 2020 2020 2020 5265 6c61 7469            Relati
│ │ │ │ +0001ba50: 7665 2069 7465 6d73 2069 6e20 6461 7465  ve items in date
│ │ │ │ +0001ba60: 2073 7472 696e 6773 2e0a 2020 2020 2020   strings..      
│ │ │ │  0001ba70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001ba80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001ba90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001baa0: 2020 2020 2020 286c 696e 6520 2020 3333        (line   33
│ │ │ │ -0001bab0: 290a 2a20 746f 6461 7920 696e 2064 6174  ).* today in dat
│ │ │ │ -0001bac0: 6520 7374 7269 6e67 733a 2020 2020 2020  e strings:      
│ │ │ │ -0001bad0: 2020 2020 2020 2020 2020 2052 656c 6174             Relat
│ │ │ │ -0001bae0: 6976 6520 6974 656d 7320 696e 2064 6174  ive items in dat
│ │ │ │ -0001baf0: 6520 7374 7269 6e67 732e 0a20 2020 2020  e strings..     
│ │ │ │ +0001baa0: 2020 2020 2020 2028 6c69 6e65 2020 2033         (line   3
│ │ │ │ +0001bab0: 3329 0a2a 2074 6f64 6179 2069 6e20 6461  3).* today in da
│ │ │ │ +0001bac0: 7465 2073 7472 696e 6773 3a20 2020 2020  te strings:     
│ │ │ │ +0001bad0: 2020 2020 2020 2020 2020 2020 5265 6c61              Rela
│ │ │ │ +0001bae0: 7469 7665 2069 7465 6d73 2069 6e20 6461  tive items in da
│ │ │ │ +0001baf0: 7465 2073 7472 696e 6773 2e0a 2020 2020  te strings..    
│ │ │ │  0001bb00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001bb10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001bb20: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001bb30: 2020 2020 2020 2020 286c 696e 6520 2020          (line   
│ │ │ │ -0001bb40: 3333 290a 2a20 746f 6d6f 7272 6f77 2069  33).* tomorrow i
│ │ │ │ -0001bb50: 6e20 6461 7465 2073 7472 696e 6773 3a20  n date strings: 
│ │ │ │ -0001bb60: 2020 2020 2020 2020 2020 2020 2052 656c               Rel
│ │ │ │ -0001bb70: 6174 6976 6520 6974 656d 7320 696e 2064  ative items in d
│ │ │ │ -0001bb80: 6174 6520 7374 7269 6e67 732e 0a20 2020  ate strings..   
│ │ │ │ +0001bb30: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ +0001bb40: 2033 3329 0a2a 2074 6f6d 6f72 726f 7720   33).* tomorrow 
│ │ │ │ +0001bb50: 696e 2064 6174 6520 7374 7269 6e67 733a  in date strings:
│ │ │ │ +0001bb60: 2020 2020 2020 2020 2020 2020 2020 5265                Re
│ │ │ │ +0001bb70: 6c61 7469 7665 2069 7465 6d73 2069 6e20  lative items in 
│ │ │ │ +0001bb80: 6461 7465 2073 7472 696e 6773 2e0a 2020  date strings..  
│ │ │ │  0001bb90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001bba0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001bbb0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001bbc0: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ -0001bbd0: 2020 3239 290a 2a20 7765 656b 2069 6e20    29).* week in 
│ │ │ │ -0001bbe0: 6461 7465 2073 7472 696e 6773 3a20 2020  date strings:   
│ │ │ │ -0001bbf0: 2020 2020 2020 2020 2020 2020 2020 2052                 R
│ │ │ │ -0001bc00: 656c 6174 6976 6520 6974 656d 7320 696e  elative items in
│ │ │ │ -0001bc10: 2064 6174 6520 7374 7269 6e67 732e 0a20   date strings.. 
│ │ │ │ +0001bbc0: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ +0001bbd0: 2020 2032 3929 0a2a 2077 6565 6b20 696e     29).* week in
│ │ │ │ +0001bbe0: 2064 6174 6520 7374 7269 6e67 733a 2020   date strings:  
│ │ │ │ +0001bbf0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0001bc00: 5265 6c61 7469 7665 2069 7465 6d73 2069  Relative items i
│ │ │ │ +0001bc10: 6e20 6461 7465 2073 7472 696e 6773 2e0a  n date strings..
│ │ │ │  0001bc20: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001bc30: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001bc40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001bc50: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ -0001bc60: 6520 2020 3135 290a 2a20 7965 6172 2069  e   15).* year i
│ │ │ │ -0001bc70: 6e20 6461 7465 2073 7472 696e 6773 3a20  n date strings: 
│ │ │ │ +0001bc50: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ +0001bc60: 6e65 2020 2031 3529 0a2a 2079 6561 7220  ne   15).* year 
│ │ │ │ +0001bc70: 696e 2064 6174 6520 7374 7269 6e67 733a  in date strings:
│ │ │ │  0001bc80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001bc90: 2052 656c 6174 6976 6520 6974 656d 7320   Relative items 
│ │ │ │ -0001bca0: 696e 2064 6174 6520 7374 7269 6e67 732e  in date strings.
│ │ │ │ -0001bcb0: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ +0001bc90: 2020 5265 6c61 7469 7665 2069 7465 6d73    Relative items
│ │ │ │ +0001bca0: 2069 6e20 6461 7465 2073 7472 696e 6773   in date strings
│ │ │ │ +0001bcb0: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │  0001bcc0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001bcd0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001bce0: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ -0001bcf0: 696e 6520 2020 3135 290a 2a20 7965 7374  ine   15).* yest
│ │ │ │ -0001bd00: 6572 6461 7920 696e 2064 6174 6520 7374  erday in date st
│ │ │ │ -0001bd10: 7269 6e67 733a 2020 2020 2020 2020 2020  rings:          
│ │ │ │ -0001bd20: 2020 2052 656c 6174 6976 6520 6974 656d     Relative item
│ │ │ │ -0001bd30: 7320 696e 2064 6174 6520 7374 7269 6e67  s in date string
│ │ │ │ -0001bd40: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │ +0001bce0: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ +0001bcf0: 6c69 6e65 2020 2031 3529 0a2a 2079 6573  line   15).* yes
│ │ │ │ +0001bd00: 7465 7264 6179 2069 6e20 6461 7465 2073  terday in date s
│ │ │ │ +0001bd10: 7472 696e 6773 3a20 2020 2020 2020 2020  trings:         
│ │ │ │ +0001bd20: 2020 2020 5265 6c61 7469 7665 2069 7465      Relative ite
│ │ │ │ +0001bd30: 6d73 2069 6e20 6461 7465 2073 7472 696e  ms in date strin
│ │ │ │ +0001bd40: 6773 2e0a 2020 2020 2020 2020 2020 2020  gs..            
│ │ │ │  0001bd50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001bd60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001bd70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001bd80: 286c 696e 6520 2020 3239 290a 0a1f 0a46  (line   29)....F
│ │ │ │ -0001bd90: 696c 653a 2073 6869 7368 692e 696e 666f  ile: shishi.info
│ │ │ │ -0001bda0: 2c20 204e 6f64 653a 2043 6f6e 6365 7074  ,  Node: Concept
│ │ │ │ -0001bdb0: 2049 6e64 6578 2c20 2050 7265 763a 2046   Index,  Prev: F
│ │ │ │ -0001bdc0: 756e 6374 696f 6e20 616e 6420 4461 7461  unction and Data
│ │ │ │ -0001bdd0: 2049 6e64 6578 2c20 2055 703a 2054 6f70   Index,  Up: Top
│ │ │ │ -0001bde0: 0a0a 436f 6e63 6570 7420 496e 6465 780a  ..Concept Index.
│ │ │ │ -0001bdf0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a00  *************...
│ │ │ │ -0001be00: 085b 696e 6465 7800 085d 0a2a 204d 656e  .[index..].* Men
│ │ │ │ -0001be10: 753a 0a0a 2a20 3344 4553 3a20 2020 2020  u:..* 3DES:     
│ │ │ │ +0001bd80: 2028 6c69 6e65 2020 2032 3929 0a0a 1f0a   (line   29)....
│ │ │ │ +0001bd90: 4669 6c65 3a20 7368 6973 6869 2e69 6e66  File: shishi.inf
│ │ │ │ +0001bda0: 6f2c 2020 4e6f 6465 3a20 436f 6e63 6570  o,  Node: Concep
│ │ │ │ +0001bdb0: 7420 496e 6465 782c 2020 5072 6576 3a20  t Index,  Prev: 
│ │ │ │ +0001bdc0: 4675 6e63 7469 6f6e 2061 6e64 2044 6174  Function and Dat
│ │ │ │ +0001bdd0: 6120 496e 6465 782c 2020 5570 3a20 546f  a Index,  Up: To
│ │ │ │ +0001bde0: 700a 0a43 6f6e 6365 7074 2049 6e64 6578  p..Concept Index
│ │ │ │ +0001bdf0: 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a  .*************..
│ │ │ │ +0001be00: 0008 5b69 6e64 6578 0008 5d0a 2a20 4d65  ..[index..].* Me
│ │ │ │ +0001be10: 6e75 3a0a 0a2a 2033 4445 533a 2020 2020  nu:..* 3DES:    
│ │ │ │  0001be20: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001be30: 2020 2020 2020 2020 2020 2020 2043 7279               Cry
│ │ │ │ -0001be40: 7074 6f67 7261 7068 6963 204f 7665 7276  ptographic Overv
│ │ │ │ -0001be50: 6965 772e 0a20 2020 2020 2020 2020 2020  iew..           
│ │ │ │ +0001be30: 2020 2020 2020 2020 2020 2020 2020 4372                Cr
│ │ │ │ +0001be40: 7970 746f 6772 6170 6869 6320 4f76 6572  yptographic Over
│ │ │ │ +0001be50: 7669 6577 2e0a 2020 2020 2020 2020 2020  view..          
│ │ │ │  0001be60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001be70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001be80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001be90: 2020 2028 6c69 6e65 2020 3231 290a 2a20     (line  21).* 
│ │ │ │ -0001bea0: 6162 6272 6576 6961 7469 6f6e 7320 666f  abbreviations fo
│ │ │ │ -0001beb0: 7220 6d6f 6e74 6873 3a20 2020 2020 2020  r months:       
│ │ │ │ -0001bec0: 2020 2020 2020 2043 616c 656e 6461 7220         Calendar 
│ │ │ │ -0001bed0: 6461 7465 2069 7465 6d73 2e20 286c 696e  date items. (lin
│ │ │ │ -0001bee0: 6520 2033 3629 0a2a 2041 4553 3a20 2020  e  36).* AES:   
│ │ │ │ +0001be90: 2020 2020 286c 696e 6520 2032 3129 0a2a      (line  21).*
│ │ │ │ +0001bea0: 2061 6262 7265 7669 6174 696f 6e73 2066   abbreviations f
│ │ │ │ +0001beb0: 6f72 206d 6f6e 7468 733a 2020 2020 2020  or months:      
│ │ │ │ +0001bec0: 2020 2020 2020 2020 4361 6c65 6e64 6172          Calendar
│ │ │ │ +0001bed0: 2064 6174 6520 6974 656d 732e 2028 6c69   date items. (li
│ │ │ │ +0001bee0: 6e65 2020 3336 290a 2a20 4145 533a 2020  ne  36).* AES:  
│ │ │ │  0001bef0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001bf00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001bf10: 4372 7970 746f 6772 6170 6869 6320 4f76  Cryptographic Ov
│ │ │ │ -0001bf20: 6572 7669 6577 2e0a 2020 2020 2020 2020  erview..        
│ │ │ │ +0001bf10: 2043 7279 7074 6f67 7261 7068 6963 204f   Cryptographic O
│ │ │ │ +0001bf20: 7665 7276 6965 772e 0a20 2020 2020 2020  verview..       
│ │ │ │  0001bf30: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001bf40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001bf50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001bf60: 2020 2020 2020 286c 696e 6520 2032 3129        (line  21)
│ │ │ │ -0001bf70: 0a2a 2041 4553 2d43 434d 3a20 2020 2020  .* AES-CCM:     
│ │ │ │ +0001bf60: 2020 2020 2020 2028 6c69 6e65 2020 3231         (line  21
│ │ │ │ +0001bf70: 290a 2a20 4145 532d 4343 4d3a 2020 2020  ).* AES-CCM:    
│ │ │ │  0001bf80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001bf90: 2020 2020 2020 2020 2020 5465 6c6e 6574            Telnet
│ │ │ │ -0001bfa0: 2065 6e63 7279 7074 696f 6e20 7769 7468   encryption with
│ │ │ │ -0001bfb0: 2041 4553 2d43 434d 2e0a 2020 2020 2020   AES-CCM..      
│ │ │ │ +0001bf90: 2020 2020 2020 2020 2020 2054 656c 6e65             Telne
│ │ │ │ +0001bfa0: 7420 656e 6372 7970 7469 6f6e 2077 6974  t encryption wit
│ │ │ │ +0001bfb0: 6820 4145 532d 4343 4d2e 0a20 2020 2020  h AES-CCM..     
│ │ │ │  0001bfc0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001bfd0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001bfe0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001bff0: 2020 2020 2020 2020 286c 696e 6520 2020          (line   
│ │ │ │ -0001c000: 3629 0a2a 2041 4958 3a20 2020 2020 2020  6).* AIX:       
│ │ │ │ +0001bff0: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ +0001c000: 2036 290a 2a20 4149 583a 2020 2020 2020   6).* AIX:      
│ │ │ │  0001c010: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001c020: 2020 2020 2020 2020 2020 2020 5375 7070              Supp
│ │ │ │ -0001c030: 6f72 7465 6420 506c 6174 666f 726d 732e  orted Platforms.
│ │ │ │ -0001c040: 2028 6c69 6e65 2020 3730 290a 2a20 616e   (line  70).* an
│ │ │ │ -0001c050: 6f6e 796d 6f75 7320 746c 733a 2020 2020  onymous tls:    
│ │ │ │ +0001c020: 2020 2020 2020 2020 2020 2020 2053 7570               Sup
│ │ │ │ +0001c030: 706f 7274 6564 2050 6c61 7466 6f72 6d73  ported Platforms
│ │ │ │ +0001c040: 2e20 286c 696e 6520 2037 3029 0a2a 2061  . (line  70).* a
│ │ │ │ +0001c050: 6e6f 6e79 6d6f 7573 2074 6c73 3a20 2020  nonymous tls:   
│ │ │ │  0001c060: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001c070: 2020 2020 204b 6572 6265 726f 7320 7669       Kerberos vi
│ │ │ │ -0001c080: 6120 544c 532e 2020 2020 286c 696e 6520  a TLS.    (line 
│ │ │ │ -0001c090: 2034 3129 0a2a 2041 7070 6c69 6361 7469   41).* Applicati
│ │ │ │ -0001c0a0: 6f6e 2050 726f 6772 616d 6d69 6e67 2049  on Programming I
│ │ │ │ -0001c0b0: 6e74 6572 6661 6365 2028 4150 4929 3a20  nterface (API): 
│ │ │ │ -0001c0c0: 5072 6f67 7261 6d6d 696e 6720 4d61 6e75  Programming Manu
│ │ │ │ -0001c0d0: 616c 2e0a 2020 2020 2020 2020 2020 2020  al..            
│ │ │ │ +0001c070: 2020 2020 2020 4b65 7262 6572 6f73 2076        Kerberos v
│ │ │ │ +0001c080: 6961 2054 4c53 2e20 2020 2028 6c69 6e65  ia TLS.    (line
│ │ │ │ +0001c090: 2020 3431 290a 2a20 4170 706c 6963 6174    41).* Applicat
│ │ │ │ +0001c0a0: 696f 6e20 5072 6f67 7261 6d6d 696e 6720  ion Programming 
│ │ │ │ +0001c0b0: 496e 7465 7266 6163 6520 2841 5049 293a  Interface (API):
│ │ │ │ +0001c0c0: 2050 726f 6772 616d 6d69 6e67 204d 616e   Programming Man
│ │ │ │ +0001c0d0: 7561 6c2e 0a20 2020 2020 2020 2020 2020  ual..           
│ │ │ │  0001c0e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001c0f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001c100: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001c110: 2020 286c 696e 6520 2020 3629 0a2a 2041    (line   6).* A
│ │ │ │ -0001c120: 5243 464f 5552 3a20 2020 2020 2020 2020  RCFOUR:         
│ │ │ │ +0001c110: 2020 2028 6c69 6e65 2020 2036 290a 2a20     (line   6).* 
│ │ │ │ +0001c120: 4152 4346 4f55 523a 2020 2020 2020 2020  ARCFOUR:        
│ │ │ │  0001c130: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001c140: 2020 2020 2020 4372 7970 746f 6772 6170        Cryptograp
│ │ │ │ -0001c150: 6869 6320 4f76 6572 7669 6577 2e0a 2020  hic Overview..  
│ │ │ │ +0001c140: 2020 2020 2020 2043 7279 7074 6f67 7261         Cryptogra
│ │ │ │ +0001c150: 7068 6963 204f 7665 7276 6965 772e 0a20  phic Overview.. 
│ │ │ │  0001c160: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001c170: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001c180: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001c190: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ -0001c1a0: 6520 2032 3129 0a2a 2061 7574 6865 6e74  e  21).* authent
│ │ │ │ -0001c1b0: 6963 6174 6564 2074 6c73 3a20 2020 2020  icated tls:     
│ │ │ │ +0001c190: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ +0001c1a0: 6e65 2020 3231 290a 2a20 6175 7468 656e  ne  21).* authen
│ │ │ │ +0001c1b0: 7469 6361 7465 6420 746c 733a 2020 2020  ticated tls:    
│ │ │ │  0001c1c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001c1d0: 4b65 7262 6572 6f73 2076 6961 2054 4c53  Kerberos via TLS
│ │ │ │ -0001c1e0: 2e20 2020 2028 6c69 6e65 2020 3937 290a  .    (line  97).
│ │ │ │ -0001c1f0: 2a20 4175 7468 656e 7469 6361 7469 6f6e  * Authentication
│ │ │ │ -0001c200: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ -0001c210: 2020 2020 2020 2020 2047 6c6f 7373 6172           Glossar
│ │ │ │ -0001c220: 7920 6f66 2074 6572 6d73 2e20 2020 286c  y of terms.   (l
│ │ │ │ -0001c230: 696e 6520 2020 3729 0a2a 2041 7574 6865  ine   7).* Authe
│ │ │ │ -0001c240: 6e74 6963 6174 696f 6e20 6865 6164 6572  ntication header
│ │ │ │ -0001c250: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ -0001c260: 2020 476c 6f73 7361 7279 206f 6620 7465    Glossary of te
│ │ │ │ -0001c270: 726d 732e 2020 2028 6c69 6e65 2020 3130  rms.   (line  10
│ │ │ │ -0001c280: 290a 2a20 4175 7468 656e 7469 6361 7469  ).* Authenticati
│ │ │ │ -0001c290: 6f6e 2070 6174 683a 2020 2020 2020 2020  on path:        
│ │ │ │ -0001c2a0: 2020 2020 2020 2020 2020 2047 6c6f 7373             Gloss
│ │ │ │ -0001c2b0: 6172 7920 6f66 2074 6572 6d73 2e20 2020  ary of terms.   
│ │ │ │ -0001c2c0: 286c 696e 6520 2031 3429 0a2a 2041 7574  (line  14).* Aut
│ │ │ │ -0001c2d0: 6865 6e74 6963 6174 6f72 3a20 2020 2020  henticator:     
│ │ │ │ +0001c1d0: 204b 6572 6265 726f 7320 7669 6120 544c   Kerberos via TL
│ │ │ │ +0001c1e0: 532e 2020 2020 286c 696e 6520 2039 3729  S.    (line  97)
│ │ │ │ +0001c1f0: 0a2a 2041 7574 6865 6e74 6963 6174 696f  .* Authenticatio
│ │ │ │ +0001c200: 6e3a 2020 2020 2020 2020 2020 2020 2020  n:              
│ │ │ │ +0001c210: 2020 2020 2020 2020 2020 476c 6f73 7361            Glossa
│ │ │ │ +0001c220: 7279 206f 6620 7465 726d 732e 2020 2028  ry of terms.   (
│ │ │ │ +0001c230: 6c69 6e65 2020 2037 290a 2a20 4175 7468  line   7).* Auth
│ │ │ │ +0001c240: 656e 7469 6361 7469 6f6e 2068 6561 6465  entication heade
│ │ │ │ +0001c250: 723a 2020 2020 2020 2020 2020 2020 2020  r:              
│ │ │ │ +0001c260: 2020 2047 6c6f 7373 6172 7920 6f66 2074     Glossary of t
│ │ │ │ +0001c270: 6572 6d73 2e20 2020 286c 696e 6520 2031  erms.   (line  1
│ │ │ │ +0001c280: 3029 0a2a 2041 7574 6865 6e74 6963 6174  0).* Authenticat
│ │ │ │ +0001c290: 696f 6e20 7061 7468 3a20 2020 2020 2020  ion path:       
│ │ │ │ +0001c2a0: 2020 2020 2020 2020 2020 2020 476c 6f73              Glos
│ │ │ │ +0001c2b0: 7361 7279 206f 6620 7465 726d 732e 2020  sary of terms.  
│ │ │ │ +0001c2c0: 2028 6c69 6e65 2020 3134 290a 2a20 4175   (line  14).* Au
│ │ │ │ +0001c2d0: 7468 656e 7469 6361 746f 723a 2020 2020  thenticator:    
│ │ │ │  0001c2e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001c2f0: 2020 2020 476c 6f73 7361 7279 206f 6620      Glossary of 
│ │ │ │ -0001c300: 7465 726d 732e 2020 2028 6c69 6e65 2020  terms.   (line  
│ │ │ │ -0001c310: 3138 290a 2a20 4175 7468 6f72 697a 6174  18).* Authorizat
│ │ │ │ -0001c320: 696f 6e3a 2020 2020 2020 2020 2020 2020  ion:            
│ │ │ │ -0001c330: 2020 2020 2020 2020 2020 2020 2047 6c6f               Glo
│ │ │ │ -0001c340: 7373 6172 7920 6f66 2074 6572 6d73 2e20  ssary of terms. 
│ │ │ │ -0001c350: 2020 286c 696e 6520 2032 3329 0a2a 2061    (line  23).* a
│ │ │ │ -0001c360: 7574 686f 7273 206f 6620 7061 7273 655f  uthors of parse_
│ │ │ │ -0001c370: 6461 7465 7469 6d65 3a20 2020 2020 2020  datetime:       
│ │ │ │ -0001c380: 2020 2020 2020 4175 7468 6f72 7320 6f66        Authors of
│ │ │ │ -0001c390: 2070 6172 7365 5f64 6174 6574 696d 652e   parse_datetime.
│ │ │ │ -0001c3a0: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ +0001c2f0: 2020 2020 2047 6c6f 7373 6172 7920 6f66       Glossary of
│ │ │ │ +0001c300: 2074 6572 6d73 2e20 2020 286c 696e 6520   terms.   (line 
│ │ │ │ +0001c310: 2031 3829 0a2a 2041 7574 686f 7269 7a61   18).* Authoriza
│ │ │ │ +0001c320: 7469 6f6e 3a20 2020 2020 2020 2020 2020  tion:           
│ │ │ │ +0001c330: 2020 2020 2020 2020 2020 2020 2020 476c                Gl
│ │ │ │ +0001c340: 6f73 7361 7279 206f 6620 7465 726d 732e  ossary of terms.
│ │ │ │ +0001c350: 2020 2028 6c69 6e65 2020 3233 290a 2a20     (line  23).* 
│ │ │ │ +0001c360: 6175 7468 6f72 7320 6f66 2070 6172 7365  authors of parse
│ │ │ │ +0001c370: 5f64 6174 6574 696d 653a 2020 2020 2020  _datetime:      
│ │ │ │ +0001c380: 2020 2020 2020 2041 7574 686f 7273 206f         Authors o
│ │ │ │ +0001c390: 6620 7061 7273 655f 6461 7465 7469 6d65  f parse_datetime
│ │ │ │ +0001c3a0: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │  0001c3b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001c3c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001c3d0: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ -0001c3e0: 6c69 6e65 2020 2036 290a 2a20 4175 746f  line   6).* Auto
│ │ │ │ -0001c3f0: 636f 6e66 2074 6573 7473 3a20 2020 2020  conf tests:     
│ │ │ │ +0001c3d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0001c3e0: 286c 696e 6520 2020 3629 0a2a 2041 7574  (line   6).* Aut
│ │ │ │ +0001c3f0: 6f63 6f6e 6620 7465 7374 733a 2020 2020  oconf tests:    
│ │ │ │  0001c400: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001c410: 2020 2041 7574 6f63 6f6e 6620 7465 7374     Autoconf test
│ │ │ │ -0001c420: 732e 2020 2020 2020 286c 696e 6520 2020  s.      (line   
│ │ │ │ -0001c430: 3629 0a2a 2062 6173 6963 2061 7574 686f  6).* basic autho
│ │ │ │ -0001c440: 7269 7a61 7469 6f6e 3a20 2020 2020 2020  rization:       
│ │ │ │ -0001c450: 2020 2020 2020 2020 2020 2020 4b65 7262              Kerb
│ │ │ │ -0001c460: 6572 697a 6564 2072 7368 2061 6e64 2072  erized rsh and r
│ │ │ │ -0001c470: 6c6f 6769 6e2e 0a20 2020 2020 2020 2020  login..         
│ │ │ │ +0001c410: 2020 2020 4175 746f 636f 6e66 2074 6573      Autoconf tes
│ │ │ │ +0001c420: 7473 2e20 2020 2020 2028 6c69 6e65 2020  ts.      (line  
│ │ │ │ +0001c430: 2036 290a 2a20 6261 7369 6320 6175 7468   6).* basic auth
│ │ │ │ +0001c440: 6f72 697a 6174 696f 6e3a 2020 2020 2020  orization:      
│ │ │ │ +0001c450: 2020 2020 2020 2020 2020 2020 204b 6572               Ker
│ │ │ │ +0001c460: 6265 7269 7a65 6420 7273 6820 616e 6420  berized rsh and 
│ │ │ │ +0001c470: 726c 6f67 696e 2e0a 2020 2020 2020 2020  rlogin..        
│ │ │ │  0001c480: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001c490: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001c4a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001c4b0: 2020 2020 2028 6c69 6e65 2031 3037 290a       (line 107).
│ │ │ │ -0001c4c0: 2a20 6265 6769 6e6e 696e 6720 6f66 2074  * beginning of t
│ │ │ │ -0001c4d0: 696d 652c 2066 6f72 2050 4f53 4958 3a20  ime, for POSIX: 
│ │ │ │ -0001c4e0: 2020 2020 2020 2020 2053 6563 6f6e 6473           Seconds
│ │ │ │ -0001c4f0: 2073 696e 6365 2074 6865 2045 706f 6368   since the Epoch
│ │ │ │ -0001c500: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │ +0001c4b0: 2020 2020 2020 286c 696e 6520 3130 3729        (line 107)
│ │ │ │ +0001c4c0: 0a2a 2062 6567 696e 6e69 6e67 206f 6620  .* beginning of 
│ │ │ │ +0001c4d0: 7469 6d65 2c20 666f 7220 504f 5349 583a  time, for POSIX:
│ │ │ │ +0001c4e0: 2020 2020 2020 2020 2020 5365 636f 6e64            Second
│ │ │ │ +0001c4f0: 7320 7369 6e63 6520 7468 6520 4570 6f63  s since the Epoc
│ │ │ │ +0001c500: 682e 0a20 2020 2020 2020 2020 2020 2020  h..             
│ │ │ │  0001c510: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001c520: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001c530: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001c540: 286c 696e 6520 2031 3329 0a2a 2042 656c  (line  13).* Bel
│ │ │ │ -0001c550: 6c6f 7669 6e2c 2053 7465 7665 6e20 4d2e  lovin, Steven M.
│ │ │ │ -0001c560: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ -0001c570: 2020 2020 4175 7468 6f72 7320 6f66 2070      Authors of p
│ │ │ │ -0001c580: 6172 7365 5f64 6174 6574 696d 652e 0a20  arse_datetime.. 
│ │ │ │ +0001c540: 2028 6c69 6e65 2020 3133 290a 2a20 4265   (line  13).* Be
│ │ │ │ +0001c550: 6c6c 6f76 696e 2c20 5374 6576 656e 204d  llovin, Steven M
│ │ │ │ +0001c560: 2e3a 2020 2020 2020 2020 2020 2020 2020  .:              
│ │ │ │ +0001c570: 2020 2020 2041 7574 686f 7273 206f 6620       Authors of 
│ │ │ │ +0001c580: 7061 7273 655f 6461 7465 7469 6d65 2e0a  parse_datetime..
│ │ │ │  0001c590: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001c5a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001c5b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001c5c0: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ -0001c5d0: 6e65 2020 2036 290a 2a20 4265 7265 7473  ne   6).* Berets
│ │ │ │ -0001c5e0: 2c20 4a69 6d3a 2020 2020 2020 2020 2020  , Jim:          
│ │ │ │ +0001c5c0: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ +0001c5d0: 696e 6520 2020 3629 0a2a 2042 6572 6574  ine   6).* Beret
│ │ │ │ +0001c5e0: 732c 204a 696d 3a20 2020 2020 2020 2020  s, Jim:         
│ │ │ │  0001c5f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001c600: 2041 7574 686f 7273 206f 6620 7061 7273   Authors of pars
│ │ │ │ -0001c610: 655f 6461 7465 7469 6d65 2e0a 2020 2020  e_datetime..    
│ │ │ │ +0001c600: 2020 4175 7468 6f72 7320 6f66 2070 6172    Authors of par
│ │ │ │ +0001c610: 7365 5f64 6174 6574 696d 652e 0a20 2020  se_datetime..   
│ │ │ │  0001c620: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001c630: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001c640: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001c650: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ -0001c660: 2020 3629 0a2a 2042 6572 7279 2c20 4b2e    6).* Berry, K.
│ │ │ │ -0001c670: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ -0001c680: 2020 2020 2020 2020 2020 2020 2020 4175                Au
│ │ │ │ -0001c690: 7468 6f72 7320 6f66 2070 6172 7365 5f64  thors of parse_d
│ │ │ │ -0001c6a0: 6174 6574 696d 652e 0a20 2020 2020 2020  atetime..       
│ │ │ │ +0001c650: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ +0001c660: 2020 2036 290a 2a20 4265 7272 792c 204b     6).* Berry, K
│ │ │ │ +0001c670: 2e3a 2020 2020 2020 2020 2020 2020 2020  .:              
│ │ │ │ +0001c680: 2020 2020 2020 2020 2020 2020 2020 2041                 A
│ │ │ │ +0001c690: 7574 686f 7273 206f 6620 7061 7273 655f  uthors of parse_
│ │ │ │ +0001c6a0: 6461 7465 7469 6d65 2e0a 2020 2020 2020  datetime..      
│ │ │ │  0001c6b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001c6c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001c6d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001c6e0: 2020 2020 2020 2028 6c69 6e65 2020 3139         (line  19
│ │ │ │ -0001c6f0: 290a 2a20 6361 6c65 6e64 6172 2064 6174  ).* calendar dat
│ │ │ │ -0001c700: 6520 6974 656d 3a20 2020 2020 2020 2020  e item:         
│ │ │ │ -0001c710: 2020 2020 2020 2020 2020 2043 616c 656e             Calen
│ │ │ │ -0001c720: 6461 7220 6461 7465 2069 7465 6d73 2e20  dar date items. 
│ │ │ │ -0001c730: 286c 696e 6520 2020 3629 0a2a 2043 6170  (line   6).* Cap
│ │ │ │ -0001c740: 6162 696c 6974 793a 2020 2020 2020 2020  ability:        
│ │ │ │ +0001c6e0: 2020 2020 2020 2020 286c 696e 6520 2031          (line  1
│ │ │ │ +0001c6f0: 3929 0a2a 2063 616c 656e 6461 7220 6461  9).* calendar da
│ │ │ │ +0001c700: 7465 2069 7465 6d3a 2020 2020 2020 2020  te item:        
│ │ │ │ +0001c710: 2020 2020 2020 2020 2020 2020 4361 6c65              Cale
│ │ │ │ +0001c720: 6e64 6172 2064 6174 6520 6974 656d 732e  ndar date items.
│ │ │ │ +0001c730: 2028 6c69 6e65 2020 2036 290a 2a20 4361   (line   6).* Ca
│ │ │ │ +0001c740: 7061 6269 6c69 7479 3a20 2020 2020 2020  pability:       
│ │ │ │  0001c750: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001c760: 2020 2020 476c 6f73 7361 7279 206f 6620      Glossary of 
│ │ │ │ -0001c770: 7465 726d 732e 2020 2028 6c69 6e65 2020  terms.   (line  
│ │ │ │ -0001c780: 3238 290a 2a20 6361 7365 2c20 6967 6e6f  28).* case, igno
│ │ │ │ -0001c790: 7265 6420 696e 2064 6174 6573 3a20 2020  red in dates:   
│ │ │ │ -0001c7a0: 2020 2020 2020 2020 2020 2020 2047 656e               Gen
│ │ │ │ -0001c7b0: 6572 616c 2064 6174 6520 7379 6e74 6178  eral date syntax
│ │ │ │ -0001c7c0: 2e20 286c 696e 6520 2036 3029 0a2a 2063  . (line  60).* c
│ │ │ │ -0001c7d0: 6572 7469 6669 6361 7465 2061 7574 686f  ertificate autho
│ │ │ │ -0001c7e0: 7269 7479 2028 4341 293a 2020 2020 2020  rity (CA):      
│ │ │ │ -0001c7f0: 2020 2020 2020 4b65 7262 6572 6f73 2076        Kerberos v
│ │ │ │ -0001c800: 6961 2054 4c53 2e20 2020 2028 6c69 6e65  ia TLS.    (line
│ │ │ │ -0001c810: 2020 3937 290a 2a20 4369 7068 6572 7465    97).* Cipherte
│ │ │ │ -0001c820: 7874 3a20 2020 2020 2020 2020 2020 2020  xt:             
│ │ │ │ -0001c830: 2020 2020 2020 2020 2020 2020 2020 2047                 G
│ │ │ │ -0001c840: 6c6f 7373 6172 7920 6f66 2074 6572 6d73  lossary of terms
│ │ │ │ -0001c850: 2e20 2020 286c 696e 6520 2033 3529 0a2a  .   (line  35).*
│ │ │ │ -0001c860: 2043 6c69 656e 743a 2020 2020 2020 2020   Client:        
│ │ │ │ +0001c760: 2020 2020 2047 6c6f 7373 6172 7920 6f66       Glossary of
│ │ │ │ +0001c770: 2074 6572 6d73 2e20 2020 286c 696e 6520   terms.   (line 
│ │ │ │ +0001c780: 2032 3829 0a2a 2063 6173 652c 2069 676e   28).* case, ign
│ │ │ │ +0001c790: 6f72 6564 2069 6e20 6461 7465 733a 2020  ored in dates:  
│ │ │ │ +0001c7a0: 2020 2020 2020 2020 2020 2020 2020 4765                Ge
│ │ │ │ +0001c7b0: 6e65 7261 6c20 6461 7465 2073 796e 7461  neral date synta
│ │ │ │ +0001c7c0: 782e 2028 6c69 6e65 2020 3630 290a 2a20  x. (line  60).* 
│ │ │ │ +0001c7d0: 6365 7274 6966 6963 6174 6520 6175 7468  certificate auth
│ │ │ │ +0001c7e0: 6f72 6974 7920 2843 4129 3a20 2020 2020  ority (CA):     
│ │ │ │ +0001c7f0: 2020 2020 2020 204b 6572 6265 726f 7320         Kerberos 
│ │ │ │ +0001c800: 7669 6120 544c 532e 2020 2020 286c 696e  via TLS.    (lin
│ │ │ │ +0001c810: 6520 2039 3729 0a2a 2043 6970 6865 7274  e  97).* Ciphert
│ │ │ │ +0001c820: 6578 743a 2020 2020 2020 2020 2020 2020  ext:            
│ │ │ │ +0001c830: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0001c840: 476c 6f73 7361 7279 206f 6620 7465 726d  Glossary of term
│ │ │ │ +0001c850: 732e 2020 2028 6c69 6e65 2020 3335 290a  s.   (line  35).
│ │ │ │ +0001c860: 2a20 436c 6965 6e74 3a20 2020 2020 2020  * Client:       
│ │ │ │  0001c870: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001c880: 2020 2020 2020 2020 476c 6f73 7361 7279          Glossary
│ │ │ │ -0001c890: 206f 6620 7465 726d 732e 2020 2028 6c69   of terms.   (li
│ │ │ │ -0001c8a0: 6e65 2020 3339 290a 2a20 636c 6965 6e74  ne  39).* client
│ │ │ │ -0001c8b0: 2061 7574 6865 6e74 6963 6174 696f 6e3a   authentication:
│ │ │ │ -0001c8c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001c8d0: 204b 6572 6265 726f 7320 7669 6120 544c   Kerberos via TL
│ │ │ │ -0001c8e0: 532e 2020 2020 286c 696e 6520 2039 3729  S.    (line  97)
│ │ │ │ -0001c8f0: 0a2a 2063 6f6d 6269 6e65 6420 6461 7465  .* combined date
│ │ │ │ -0001c900: 2061 6e64 2074 696d 6520 6f66 2064 6179   and time of day
│ │ │ │ -0001c910: 2069 7465 6d3a 2020 2020 436f 6d62 696e   item:    Combin
│ │ │ │ -0001c920: 6564 2064 6174 6520 616e 6420 7469 6d65  ed date and time
│ │ │ │ -0001c930: 206f 6620 6461 7920 6974 656d 732e 0a20   of day items.. 
│ │ │ │ +0001c880: 2020 2020 2020 2020 2047 6c6f 7373 6172           Glossar
│ │ │ │ +0001c890: 7920 6f66 2074 6572 6d73 2e20 2020 286c  y of terms.   (l
│ │ │ │ +0001c8a0: 696e 6520 2033 3929 0a2a 2063 6c69 656e  ine  39).* clien
│ │ │ │ +0001c8b0: 7420 6175 7468 656e 7469 6361 7469 6f6e  t authentication
│ │ │ │ +0001c8c0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ +0001c8d0: 2020 4b65 7262 6572 6f73 2076 6961 2054    Kerberos via T
│ │ │ │ +0001c8e0: 4c53 2e20 2020 2028 6c69 6e65 2020 3937  LS.    (line  97
│ │ │ │ +0001c8f0: 290a 2a20 636f 6d62 696e 6564 2064 6174  ).* combined dat
│ │ │ │ +0001c900: 6520 616e 6420 7469 6d65 206f 6620 6461  e and time of da
│ │ │ │ +0001c910: 7920 6974 656d 3a20 2020 2043 6f6d 6269  y item:    Combi
│ │ │ │ +0001c920: 6e65 6420 6461 7465 2061 6e64 2074 696d  ned date and tim
│ │ │ │ +0001c930: 6520 6f66 2064 6179 2069 7465 6d73 2e0a  e of day items..
│ │ │ │  0001c940: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001c950: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001c960: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001c970: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ -0001c980: 6e65 2020 2036 290a 2a20 636f 6d6d 656e  ne   6).* commen
│ │ │ │ -0001c990: 7473 2c20 696e 2064 6174 6573 3a20 2020  ts, in dates:   
│ │ │ │ +0001c970: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ +0001c980: 696e 6520 2020 3629 0a2a 2063 6f6d 6d65  ine   6).* comme
│ │ │ │ +0001c990: 6e74 732c 2069 6e20 6461 7465 733a 2020  nts, in dates:  
│ │ │ │  0001c9a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001c9b0: 2047 656e 6572 616c 2064 6174 6520 7379   General date sy
│ │ │ │ -0001c9c0: 6e74 6178 2e20 286c 696e 6520 2036 3029  ntax. (line  60)
│ │ │ │ -0001c9d0: 0a2a 2043 6f6d 7069 6c69 6e67 2079 6f75  .* Compiling you
│ │ │ │ -0001c9e0: 7220 6170 706c 6963 6174 696f 6e3a 2020  r application:  
│ │ │ │ -0001c9f0: 2020 2020 2020 2020 2020 4275 696c 6469            Buildi
│ │ │ │ -0001ca00: 6e67 2074 6865 2073 6f75 7263 652e 2028  ng the source. (
│ │ │ │ -0001ca10: 6c69 6e65 2020 2036 290a 2a20 636f 6e63  line   6).* conc
│ │ │ │ -0001ca20: 7572 7265 6e74 2077 7269 7465 7273 3a20  urrent writers: 
│ │ │ │ +0001c9b0: 2020 4765 6e65 7261 6c20 6461 7465 2073    General date s
│ │ │ │ +0001c9c0: 796e 7461 782e 2028 6c69 6e65 2020 3630  yntax. (line  60
│ │ │ │ +0001c9d0: 290a 2a20 436f 6d70 696c 696e 6720 796f  ).* Compiling yo
│ │ │ │ +0001c9e0: 7572 2061 7070 6c69 6361 7469 6f6e 3a20  ur application: 
│ │ │ │ +0001c9f0: 2020 2020 2020 2020 2020 2042 7569 6c64             Build
│ │ │ │ +0001ca00: 696e 6720 7468 6520 736f 7572 6365 2e20  ing the source. 
│ │ │ │ +0001ca10: 286c 696e 6520 2020 3629 0a2a 2063 6f6e  (line   6).* con
│ │ │ │ +0001ca20: 6375 7272 656e 7420 7772 6974 6572 733a  current writers:
│ │ │ │  0001ca30: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001ca40: 2020 204d 756c 7469 706c 6520 7365 7276     Multiple serv
│ │ │ │ -0001ca50: 6572 732e 2020 2020 286c 696e 6520 2032  ers.    (line  2
│ │ │ │ -0001ca60: 3429 0a2a 2063 6f6e 6669 6775 7261 7469  4).* configurati
│ │ │ │ -0001ca70: 6f6e 2066 696c 653a 2020 2020 2020 2020  on file:        
│ │ │ │ -0001ca80: 2020 2020 2020 2020 2020 2020 5368 6973              Shis
│ │ │ │ -0001ca90: 6869 2043 6f6e 6669 6775 7261 7469 6f6e  hi Configuration
│ │ │ │ -0001caa0: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │ +0001ca40: 2020 2020 4d75 6c74 6970 6c65 2073 6572      Multiple ser
│ │ │ │ +0001ca50: 7665 7273 2e20 2020 2028 6c69 6e65 2020  vers.    (line  
│ │ │ │ +0001ca60: 3234 290a 2a20 636f 6e66 6967 7572 6174  24).* configurat
│ │ │ │ +0001ca70: 696f 6e20 6669 6c65 3a20 2020 2020 2020  ion file:       
│ │ │ │ +0001ca80: 2020 2020 2020 2020 2020 2020 2053 6869               Shi
│ │ │ │ +0001ca90: 7368 6920 436f 6e66 6967 7572 6174 696f  shi Configuratio
│ │ │ │ +0001caa0: 6e2e 0a20 2020 2020 2020 2020 2020 2020  n..             
│ │ │ │  0001cab0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001cac0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001cad0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001cae0: 286c 696e 6520 2020 3629 0a2a 2043 6f6e  (line   6).* Con
│ │ │ │ -0001caf0: 6669 6775 7265 2074 6573 7473 3a20 2020  figure tests:   
│ │ │ │ +0001cae0: 2028 6c69 6e65 2020 2036 290a 2a20 436f   (line   6).* Co
│ │ │ │ +0001caf0: 6e66 6967 7572 6520 7465 7374 733a 2020  nfigure tests:  
│ │ │ │  0001cb00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001cb10: 2020 2020 4175 746f 636f 6e66 2074 6573      Autoconf tes
│ │ │ │ -0001cb20: 7473 2e20 2020 2020 2028 6c69 6e65 2020  ts.      (line  
│ │ │ │ -0001cb30: 2036 290a 2a20 436f 6e74 7269 6275 7469   6).* Contributi
│ │ │ │ -0001cb40: 6e67 3a20 2020 2020 2020 2020 2020 2020  ng:             
│ │ │ │ -0001cb50: 2020 2020 2020 2020 2020 2020 2043 6f6e               Con
│ │ │ │ -0001cb60: 7472 6962 7574 696e 672e 2020 2020 2020  tributing.      
│ │ │ │ -0001cb70: 2020 286c 696e 6520 2020 3629 0a2a 2063    (line   6).* c
│ │ │ │ -0001cb80: 6f70 7969 6e67 2069 6e66 6f72 6d61 7469  opying informati
│ │ │ │ -0001cb90: 6f6e 3a20 2020 2020 2020 2020 2020 2020  on:             
│ │ │ │ -0001cba0: 2020 2020 2020 436f 7079 696e 6720 496e        Copying In
│ │ │ │ -0001cbb0: 666f 726d 6174 696f 6e2e 2028 6c69 6e65  formation. (line
│ │ │ │ -0001cbc0: 2020 2036 290a 2a20 6372 6564 656e 7469     6).* credenti
│ │ │ │ -0001cbd0: 616c 2063 6163 6865 2c20 6669 6c65 2066  al cache, file f
│ │ │ │ -0001cbe0: 6f72 6d61 7420 6f66 3a20 2020 2020 2054  ormat of:      T
│ │ │ │ -0001cbf0: 6865 2043 7265 6465 6e74 6961 6c20 4361  he Credential Ca
│ │ │ │ -0001cc00: 6368 6520 4269 6e61 7279 2046 696c 6520  che Binary File 
│ │ │ │ -0001cc10: 466f 726d 6174 2e0a 2020 2020 2020 2020  Format..        
│ │ │ │ +0001cb10: 2020 2020 2041 7574 6f63 6f6e 6620 7465       Autoconf te
│ │ │ │ +0001cb20: 7374 732e 2020 2020 2020 286c 696e 6520  sts.      (line 
│ │ │ │ +0001cb30: 2020 3629 0a2a 2043 6f6e 7472 6962 7574    6).* Contribut
│ │ │ │ +0001cb40: 696e 673a 2020 2020 2020 2020 2020 2020  ing:            
│ │ │ │ +0001cb50: 2020 2020 2020 2020 2020 2020 2020 436f                Co
│ │ │ │ +0001cb60: 6e74 7269 6275 7469 6e67 2e20 2020 2020  ntributing.     
│ │ │ │ +0001cb70: 2020 2028 6c69 6e65 2020 2036 290a 2a20     (line   6).* 
│ │ │ │ +0001cb80: 636f 7079 696e 6720 696e 666f 726d 6174  copying informat
│ │ │ │ +0001cb90: 696f 6e3a 2020 2020 2020 2020 2020 2020  ion:            
│ │ │ │ +0001cba0: 2020 2020 2020 2043 6f70 7969 6e67 2049         Copying I
│ │ │ │ +0001cbb0: 6e66 6f72 6d61 7469 6f6e 2e20 286c 696e  nformation. (lin
│ │ │ │ +0001cbc0: 6520 2020 3629 0a2a 2063 7265 6465 6e74  e   6).* credent
│ │ │ │ +0001cbd0: 6961 6c20 6361 6368 652c 2066 696c 6520  ial cache, file 
│ │ │ │ +0001cbe0: 666f 726d 6174 206f 663a 2020 2020 2020  format of:      
│ │ │ │ +0001cbf0: 5468 6520 4372 6564 656e 7469 616c 2043  The Credential C
│ │ │ │ +0001cc00: 6163 6865 2042 696e 6172 7920 4669 6c65  ache Binary File
│ │ │ │ +0001cc10: 2046 6f72 6d61 742e 0a20 2020 2020 2020   Format..       
│ │ │ │  0001cc20: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001cc30: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001cc40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001cc50: 2020 2020 2020 286c 696e 6520 2020 3629        (line   6)
│ │ │ │ -0001cc60: 0a2a 2043 7265 6465 6e74 6961 6c73 3a20  .* Credentials: 
│ │ │ │ +0001cc50: 2020 2020 2020 2028 6c69 6e65 2020 2036         (line   6
│ │ │ │ +0001cc60: 290a 2a20 4372 6564 656e 7469 616c 733a  ).* Credentials:
│ │ │ │  0001cc70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001cc80: 2020 2020 2020 2020 2020 476c 6f73 7361            Glossa
│ │ │ │ -0001cc90: 7279 206f 6620 7465 726d 732e 2020 2028  ry of terms.   (
│ │ │ │ -0001cca0: 6c69 6e65 2020 3435 290a 2a20 6461 7461  line  45).* data
│ │ │ │ -0001ccb0: 6261 7365 2064 6566 696e 6974 696f 6e3a  base definition:
│ │ │ │ -0001ccc0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001ccd0: 2020 2053 6869 7361 2043 6f6e 6669 6775     Shisa Configu
│ │ │ │ -0001cce0: 7261 7469 6f6e 2e20 286c 696e 6520 2020  ration. (line   
│ │ │ │ -0001ccf0: 3629 0a2a 2044 6174 6162 6173 6520 696e  6).* Database in
│ │ │ │ -0001cd00: 7465 7266 6163 653a 2020 2020 2020 2020  terface:        
│ │ │ │ -0001cd10: 2020 2020 2020 2020 2020 2020 4b65 7262              Kerb
│ │ │ │ -0001cd20: 6572 6f73 2044 6174 6162 6173 6520 4675  eros Database Fu
│ │ │ │ -0001cd30: 6e63 7469 6f6e 732e 0a20 2020 2020 2020  nctions..       
│ │ │ │ +0001cc80: 2020 2020 2020 2020 2020 2047 6c6f 7373             Gloss
│ │ │ │ +0001cc90: 6172 7920 6f66 2074 6572 6d73 2e20 2020  ary of terms.   
│ │ │ │ +0001cca0: 286c 696e 6520 2034 3529 0a2a 2064 6174  (line  45).* dat
│ │ │ │ +0001ccb0: 6162 6173 6520 6465 6669 6e69 7469 6f6e  abase definition
│ │ │ │ +0001ccc0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ +0001ccd0: 2020 2020 5368 6973 6120 436f 6e66 6967      Shisa Config
│ │ │ │ +0001cce0: 7572 6174 696f 6e2e 2028 6c69 6e65 2020  uration. (line  
│ │ │ │ +0001ccf0: 2036 290a 2a20 4461 7461 6261 7365 2069   6).* Database i
│ │ │ │ +0001cd00: 6e74 6572 6661 6365 3a20 2020 2020 2020  nterface:       
│ │ │ │ +0001cd10: 2020 2020 2020 2020 2020 2020 204b 6572               Ker
│ │ │ │ +0001cd20: 6265 726f 7320 4461 7461 6261 7365 2046  beros Database F
│ │ │ │ +0001cd30: 756e 6374 696f 6e73 2e0a 2020 2020 2020  unctions..      
│ │ │ │  0001cd40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001cd50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001cd60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001cd70: 2020 2020 2020 2028 6c69 6e65 2020 2036         (line   6
│ │ │ │ -0001cd80: 290a 2a20 6461 7465 2061 6e64 2074 696d  ).* date and tim
│ │ │ │ -0001cd90: 6520 6f66 2064 6179 2066 6f72 6d61 742c  e of day format,
│ │ │ │ -0001cda0: 2049 534f 2038 3630 313a 2043 6f6d 6269   ISO 8601: Combi
│ │ │ │ -0001cdb0: 6e65 6420 6461 7465 2061 6e64 2074 696d  ned date and tim
│ │ │ │ -0001cdc0: 6520 6f66 2064 6179 2069 7465 6d73 2e0a  e of day items..
│ │ │ │ -0001cdd0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0001cd70: 2020 2020 2020 2020 286c 696e 6520 2020          (line   
│ │ │ │ +0001cd80: 3629 0a2a 2064 6174 6520 616e 6420 7469  6).* date and ti
│ │ │ │ +0001cd90: 6d65 206f 6620 6461 7920 666f 726d 6174  me of day format
│ │ │ │ +0001cda0: 2c20 4953 4f20 3836 3031 3a20 436f 6d62  , ISO 8601: Comb
│ │ │ │ +0001cdb0: 696e 6564 2064 6174 6520 616e 6420 7469  ined date and ti
│ │ │ │ +0001cdc0: 6d65 206f 6620 6461 7920 6974 656d 732e  me of day items.
│ │ │ │ +0001cdd0: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │  0001cde0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001cdf0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001ce00: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ -0001ce10: 696e 6520 2020 3629 0a2a 2064 6174 6520  ine   6).* date 
│ │ │ │ -0001ce20: 666f 726d 6174 2c20 4953 4f20 3836 3031  format, ISO 8601
│ │ │ │ -0001ce30: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ -0001ce40: 2020 4361 6c65 6e64 6172 2064 6174 6520    Calendar date 
│ │ │ │ -0001ce50: 6974 656d 732e 2028 6c69 6e65 2020 3238  items. (line  28
│ │ │ │ -0001ce60: 290a 2a20 6461 7465 2069 6e70 7574 2066  ).* date input f
│ │ │ │ -0001ce70: 6f72 6d61 7473 3a20 2020 2020 2020 2020  ormats:         
│ │ │ │ -0001ce80: 2020 2020 2020 2020 2020 2044 6174 6520             Date 
│ │ │ │ -0001ce90: 696e 7075 7420 666f 726d 6174 732e 2020  input formats.  
│ │ │ │ -0001cea0: 286c 696e 6520 2020 3629 0a2a 2064 6179  (line   6).* day
│ │ │ │ -0001ceb0: 206f 6620 7765 656b 2069 7465 6d3a 2020   of week item:  
│ │ │ │ +0001ce00: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ +0001ce10: 6c69 6e65 2020 2036 290a 2a20 6461 7465  line   6).* date
│ │ │ │ +0001ce20: 2066 6f72 6d61 742c 2049 534f 2038 3630   format, ISO 860
│ │ │ │ +0001ce30: 313a 2020 2020 2020 2020 2020 2020 2020  1:              
│ │ │ │ +0001ce40: 2020 2043 616c 656e 6461 7220 6461 7465     Calendar date
│ │ │ │ +0001ce50: 2069 7465 6d73 2e20 286c 696e 6520 2032   items. (line  2
│ │ │ │ +0001ce60: 3829 0a2a 2064 6174 6520 696e 7075 7420  8).* date input 
│ │ │ │ +0001ce70: 666f 726d 6174 733a 2020 2020 2020 2020  formats:        
│ │ │ │ +0001ce80: 2020 2020 2020 2020 2020 2020 4461 7465              Date
│ │ │ │ +0001ce90: 2069 6e70 7574 2066 6f72 6d61 7473 2e20   input formats. 
│ │ │ │ +0001cea0: 2028 6c69 6e65 2020 2036 290a 2a20 6461   (line   6).* da
│ │ │ │ +0001ceb0: 7920 6f66 2077 6565 6b20 6974 656d 3a20  y of week item: 
│ │ │ │  0001cec0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001ced0: 2020 2020 4461 7920 6f66 2077 6565 6b20      Day of week 
│ │ │ │ -0001cee0: 6974 656d 732e 2020 2028 6c69 6e65 2020  items.   (line  
│ │ │ │ -0001cef0: 2036 290a 2a20 4465 6269 616e 3a20 2020   6).* Debian:   
│ │ │ │ +0001ced0: 2020 2020 2044 6179 206f 6620 7765 656b       Day of week
│ │ │ │ +0001cee0: 2069 7465 6d73 2e20 2020 286c 696e 6520   items.   (line 
│ │ │ │ +0001cef0: 2020 3629 0a2a 2044 6562 6961 6e3a 2020    6).* Debian:  
│ │ │ │  0001cf00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001cf10: 2020 2020 2020 2020 2020 2020 2053 7570               Sup
│ │ │ │ -0001cf20: 706f 7274 6564 2050 6c61 7466 6f72 6d73  ported Platforms
│ │ │ │ -0001cf30: 2e20 286c 696e 6520 2031 3029 0a2a 2044  . (line  10).* D
│ │ │ │ -0001cf40: 6562 6961 6e20 3c31 3e3a 2020 2020 2020  ebian <1>:      
│ │ │ │ +0001cf10: 2020 2020 2020 2020 2020 2020 2020 5375                Su
│ │ │ │ +0001cf20: 7070 6f72 7465 6420 506c 6174 666f 726d  pported Platform
│ │ │ │ +0001cf30: 732e 2028 6c69 6e65 2020 3130 290a 2a20  s. (line  10).* 
│ │ │ │ +0001cf40: 4465 6269 616e 203c 313e 3a20 2020 2020  Debian <1>:     
│ │ │ │  0001cf50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001cf60: 2020 2020 2020 5375 7070 6f72 7465 6420        Supported 
│ │ │ │ -0001cf70: 506c 6174 666f 726d 732e 2028 6c69 6e65  Platforms. (line
│ │ │ │ -0001cf80: 2020 3232 290a 2a20 4445 533a 2020 2020    22).* DES:    
│ │ │ │ +0001cf60: 2020 2020 2020 2053 7570 706f 7274 6564         Supported
│ │ │ │ +0001cf70: 2050 6c61 7466 6f72 6d73 2e20 286c 696e   Platforms. (lin
│ │ │ │ +0001cf80: 6520 2032 3229 0a2a 2044 4553 3a20 2020  e  22).* DES:   
│ │ │ │  0001cf90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001cfa0: 2020 2020 2020 2020 2020 2020 2020 2043                 C
│ │ │ │ -0001cfb0: 7279 7074 6f67 7261 7068 6963 204f 7665  ryptographic Ove
│ │ │ │ -0001cfc0: 7276 6965 772e 0a20 2020 2020 2020 2020  rview..         
│ │ │ │ +0001cfa0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0001cfb0: 4372 7970 746f 6772 6170 6869 6320 4f76  Cryptographic Ov
│ │ │ │ +0001cfc0: 6572 7669 6577 2e0a 2020 2020 2020 2020  erview..        
│ │ │ │  0001cfd0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001cfe0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001cff0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001d000: 2020 2020 2028 6c69 6e65 2020 3231 290a       (line  21).
│ │ │ │ -0001d010: 2a20 4469 6666 6965 2048 656c 6c6d 616e  * Diffie Hellman
│ │ │ │ -0001d020: 206b 6579 2065 7863 6861 6e67 653a 2020   key exchange:  
│ │ │ │ -0001d030: 2020 2020 2020 2020 204b 6572 6265 726f           Kerbero
│ │ │ │ -0001d040: 7320 7669 6120 544c 532e 2020 2020 286c  s via TLS.    (l
│ │ │ │ -0001d050: 696e 6520 2034 3129 0a2a 2064 6973 706c  ine  41).* displ
│ │ │ │ -0001d060: 6163 656d 656e 7420 6f66 2064 6174 6573  acement of dates
│ │ │ │ -0001d070: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ -0001d080: 2020 5265 6c61 7469 7665 2069 7465 6d73    Relative items
│ │ │ │ -0001d090: 2069 6e20 6461 7465 2073 7472 696e 6773   in date strings
│ │ │ │ -0001d0a0: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │ +0001d000: 2020 2020 2020 286c 696e 6520 2032 3129        (line  21)
│ │ │ │ +0001d010: 0a2a 2044 6966 6669 6520 4865 6c6c 6d61  .* Diffie Hellma
│ │ │ │ +0001d020: 6e20 6b65 7920 6578 6368 616e 6765 3a20  n key exchange: 
│ │ │ │ +0001d030: 2020 2020 2020 2020 2020 4b65 7262 6572            Kerber
│ │ │ │ +0001d040: 6f73 2076 6961 2054 4c53 2e20 2020 2028  os via TLS.    (
│ │ │ │ +0001d050: 6c69 6e65 2020 3431 290a 2a20 6469 7370  line  41).* disp
│ │ │ │ +0001d060: 6c61 6365 6d65 6e74 206f 6620 6461 7465  lacement of date
│ │ │ │ +0001d070: 733a 2020 2020 2020 2020 2020 2020 2020  s:              
│ │ │ │ +0001d080: 2020 2052 656c 6174 6976 6520 6974 656d     Relative item
│ │ │ │ +0001d090: 7320 696e 2064 6174 6520 7374 7269 6e67  s in date string
│ │ │ │ +0001d0a0: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │  0001d0b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001d0c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001d0d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001d0e0: 286c 696e 6520 2020 3629 0a2a 2044 6f77  (line   6).* Dow
│ │ │ │ -0001d0f0: 6e6c 6f61 643a 2020 2020 2020 2020 2020  nload:          
│ │ │ │ +0001d0e0: 2028 6c69 6e65 2020 2036 290a 2a20 446f   (line   6).* Do
│ │ │ │ +0001d0f0: 776e 6c6f 6164 3a20 2020 2020 2020 2020  wnload:         
│ │ │ │  0001d100: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001d110: 2020 2020 446f 776e 6c6f 6164 696e 6720      Downloading 
│ │ │ │ -0001d120: 616e 6420 496e 7374 616c 6c69 6e67 2e0a  and Installing..
│ │ │ │ -0001d130: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0001d110: 2020 2020 2044 6f77 6e6c 6f61 6469 6e67       Downloading
│ │ │ │ +0001d120: 2061 6e64 2049 6e73 7461 6c6c 696e 672e   and Installing.
│ │ │ │ +0001d130: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │  0001d140: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001d150: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001d160: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ -0001d170: 696e 6520 2020 3629 0a2a 2045 6767 6572  ine   6).* Egger
│ │ │ │ -0001d180: 742c 2050 6175 6c3a 2020 2020 2020 2020  t, Paul:        
│ │ │ │ +0001d160: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ +0001d170: 6c69 6e65 2020 2036 290a 2a20 4567 6765  line   6).* Egge
│ │ │ │ +0001d180: 7274 2c20 5061 756c 3a20 2020 2020 2020  rt, Paul:       
│ │ │ │  0001d190: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001d1a0: 2020 4175 7468 6f72 7320 6f66 2070 6172    Authors of par
│ │ │ │ -0001d1b0: 7365 5f64 6174 6574 696d 652e 0a20 2020  se_datetime..   
│ │ │ │ +0001d1a0: 2020 2041 7574 686f 7273 206f 6620 7061     Authors of pa
│ │ │ │ +0001d1b0: 7273 655f 6461 7465 7469 6d65 2e0a 2020  rse_datetime..  
│ │ │ │  0001d1c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001d1d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001d1e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001d1f0: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ -0001d200: 2020 2036 290a 2a20 656b 6c6f 6769 6e3a     6).* eklogin:
│ │ │ │ -0001d210: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001d220: 2020 2020 2020 2020 2020 2020 2020 204b                 K
│ │ │ │ -0001d230: 6572 6265 7269 7a65 6420 7273 6820 616e  erberized rsh an
│ │ │ │ -0001d240: 6420 726c 6f67 696e 2e0a 2020 2020 2020  d rlogin..      
│ │ │ │ +0001d1f0: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ +0001d200: 6520 2020 3629 0a2a 2065 6b6c 6f67 696e  e   6).* eklogin
│ │ │ │ +0001d210: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ +0001d220: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0001d230: 4b65 7262 6572 697a 6564 2072 7368 2061  Kerberized rsh a
│ │ │ │ +0001d240: 6e64 2072 6c6f 6769 6e2e 0a20 2020 2020  nd rlogin..     
│ │ │ │  0001d250: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001d260: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001d270: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001d280: 2020 2020 2020 2020 286c 696e 6520 3137          (line 17
│ │ │ │ -0001d290: 3429 0a2a 2045 6e63 7279 7074 696f 6e20  4).* Encryption 
│ │ │ │ -0001d2a0: 5479 7065 2028 6574 7970 6529 3a20 2020  Type (etype):   
│ │ │ │ -0001d2b0: 2020 2020 2020 2020 2020 2020 476c 6f73              Glos
│ │ │ │ -0001d2c0: 7361 7279 206f 6620 7465 726d 732e 2020  sary of terms.  
│ │ │ │ -0001d2d0: 2028 6c69 6e65 2020 3439 290a 2a20 456e   (line  49).* En
│ │ │ │ -0001d2e0: 642d 7573 6572 2053 6869 7368 6920 7573  d-user Shishi us
│ │ │ │ -0001d2f0: 6167 653a 2020 2020 2020 2020 2020 2020  age:            
│ │ │ │ -0001d300: 2020 2020 2055 7365 7220 4d61 6e75 616c       User Manual
│ │ │ │ -0001d310: 2e20 2020 2020 2020 2020 286c 696e 6520  .         (line 
│ │ │ │ -0001d320: 2020 3629 0a2a 2045 706f 6368 2c20 666f    6).* Epoch, fo
│ │ │ │ -0001d330: 7220 504f 5349 583a 2020 2020 2020 2020  r POSIX:        
│ │ │ │ -0001d340: 2020 2020 2020 2020 2020 2020 2020 5365                Se
│ │ │ │ -0001d350: 636f 6e64 7320 7369 6e63 6520 7468 6520  conds since the 
│ │ │ │ -0001d360: 4570 6f63 682e 0a20 2020 2020 2020 2020  Epoch..         
│ │ │ │ +0001d280: 2020 2020 2020 2020 2028 6c69 6e65 2031           (line 1
│ │ │ │ +0001d290: 3734 290a 2a20 456e 6372 7970 7469 6f6e  74).* Encryption
│ │ │ │ +0001d2a0: 2054 7970 6520 2865 7479 7065 293a 2020   Type (etype):  
│ │ │ │ +0001d2b0: 2020 2020 2020 2020 2020 2020 2047 6c6f               Glo
│ │ │ │ +0001d2c0: 7373 6172 7920 6f66 2074 6572 6d73 2e20  ssary of terms. 
│ │ │ │ +0001d2d0: 2020 286c 696e 6520 2034 3929 0a2a 2045    (line  49).* E
│ │ │ │ +0001d2e0: 6e64 2d75 7365 7220 5368 6973 6869 2075  nd-user Shishi u
│ │ │ │ +0001d2f0: 7361 6765 3a20 2020 2020 2020 2020 2020  sage:           
│ │ │ │ +0001d300: 2020 2020 2020 5573 6572 204d 616e 7561        User Manua
│ │ │ │ +0001d310: 6c2e 2020 2020 2020 2020 2028 6c69 6e65  l.         (line
│ │ │ │ +0001d320: 2020 2036 290a 2a20 4570 6f63 682c 2066     6).* Epoch, f
│ │ │ │ +0001d330: 6f72 2050 4f53 4958 3a20 2020 2020 2020  or POSIX:       
│ │ │ │ +0001d340: 2020 2020 2020 2020 2020 2020 2020 2053                 S
│ │ │ │ +0001d350: 6563 6f6e 6473 2073 696e 6365 2074 6865  econds since the
│ │ │ │ +0001d360: 2045 706f 6368 2e0a 2020 2020 2020 2020   Epoch..        
│ │ │ │  0001d370: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001d380: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001d390: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001d3a0: 2020 2020 2028 6c69 6e65 2020 3133 290a       (line  13).
│ │ │ │ -0001d3b0: 2a20 4572 726f 7220 4861 6e64 6c69 6e67  * Error Handling
│ │ │ │ -0001d3c0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ -0001d3d0: 2020 2020 2020 2020 2045 7272 6f72 2048           Error H
│ │ │ │ -0001d3e0: 616e 646c 696e 672e 2020 2020 2020 286c  andling.      (l
│ │ │ │ -0001d3f0: 696e 6520 2020 3629 0a2a 2045 7861 6d70  ine   6).* Examp
│ │ │ │ -0001d400: 6c65 733a 2020 2020 2020 2020 2020 2020  les:            
│ │ │ │ +0001d3a0: 2020 2020 2020 286c 696e 6520 2031 3329        (line  13)
│ │ │ │ +0001d3b0: 0a2a 2045 7272 6f72 2048 616e 646c 696e  .* Error Handlin
│ │ │ │ +0001d3c0: 673a 2020 2020 2020 2020 2020 2020 2020  g:              
│ │ │ │ +0001d3d0: 2020 2020 2020 2020 2020 4572 726f 7220            Error 
│ │ │ │ +0001d3e0: 4861 6e64 6c69 6e67 2e20 2020 2020 2028  Handling.      (
│ │ │ │ +0001d3f0: 6c69 6e65 2020 2036 290a 2a20 4578 616d  line   6).* Exam
│ │ │ │ +0001d400: 706c 6573 3a20 2020 2020 2020 2020 2020  ples:           
│ │ │ │  0001d410: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001d420: 2020 4578 616d 706c 6573 2e20 2020 2020    Examples.     
│ │ │ │ -0001d430: 2020 2020 2020 2028 6c69 6e65 2020 2036         (line   6
│ │ │ │ -0001d440: 290a 2a20 6661 696c 206f 7665 723a 2020  ).* fail over:  
│ │ │ │ +0001d420: 2020 2045 7861 6d70 6c65 732e 2020 2020     Examples.    
│ │ │ │ +0001d430: 2020 2020 2020 2020 286c 696e 6520 2020          (line   
│ │ │ │ +0001d440: 3629 0a2a 2066 6169 6c20 6f76 6572 3a20  6).* fail over: 
│ │ │ │  0001d450: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001d460: 2020 2020 2020 2020 2020 204d 756c 7469             Multi
│ │ │ │ -0001d470: 706c 6520 7365 7276 6572 732e 2020 2020  ple servers.    
│ │ │ │ -0001d480: 286c 696e 6520 2038 3029 0a2a 2046 444c  (line  80).* FDL
│ │ │ │ -0001d490: 2c20 474e 5520 4672 6565 2044 6f63 756d  , GNU Free Docum
│ │ │ │ -0001d4a0: 656e 7461 7469 6f6e 204c 6963 656e 7365  entation License
│ │ │ │ -0001d4b0: 3a20 2020 474e 5520 4672 6565 2044 6f63  :   GNU Free Doc
│ │ │ │ -0001d4c0: 756d 656e 7461 7469 6f6e 204c 6963 656e  umentation Licen
│ │ │ │ -0001d4d0: 7365 2e0a 2020 2020 2020 2020 2020 2020  se..            
│ │ │ │ +0001d460: 2020 2020 2020 2020 2020 2020 4d75 6c74              Mult
│ │ │ │ +0001d470: 6970 6c65 2073 6572 7665 7273 2e20 2020  iple servers.   
│ │ │ │ +0001d480: 2028 6c69 6e65 2020 3830 290a 2a20 4644   (line  80).* FD
│ │ │ │ +0001d490: 4c2c 2047 4e55 2046 7265 6520 446f 6375  L, GNU Free Docu
│ │ │ │ +0001d4a0: 6d65 6e74 6174 696f 6e20 4c69 6365 6e73  mentation Licens
│ │ │ │ +0001d4b0: 653a 2020 2047 4e55 2046 7265 6520 446f  e:   GNU Free Do
│ │ │ │ +0001d4c0: 6375 6d65 6e74 6174 696f 6e20 4c69 6365  cumentation Lice
│ │ │ │ +0001d4d0: 6e73 652e 0a20 2020 2020 2020 2020 2020  nse..           
│ │ │ │  0001d4e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001d4f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001d500: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001d510: 2020 286c 696e 6520 2020 3629 0a2a 2046    (line   6).* F
│ │ │ │ -0001d520: 7265 6542 5344 3a20 2020 2020 2020 2020  reeBSD:         
│ │ │ │ +0001d510: 2020 2028 6c69 6e65 2020 2036 290a 2a20     (line   6).* 
│ │ │ │ +0001d520: 4672 6565 4253 443a 2020 2020 2020 2020  FreeBSD:        
│ │ │ │  0001d530: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001d540: 2020 2020 2020 5375 7070 6f72 7465 6420        Supported 
│ │ │ │ -0001d550: 506c 6174 666f 726d 732e 2028 6c69 6e65  Platforms. (line
│ │ │ │ -0001d560: 2020 3933 290a 2a20 6765 6e65 7261 6c20    93).* general 
│ │ │ │ -0001d570: 6461 7465 2073 796e 7461 783a 2020 2020  date syntax:    
│ │ │ │ -0001d580: 2020 2020 2020 2020 2020 2020 2020 2047                 G
│ │ │ │ -0001d590: 656e 6572 616c 2064 6174 6520 7379 6e74  eneral date synt
│ │ │ │ -0001d5a0: 6178 2e20 286c 696e 6520 2020 3629 0a2a  ax. (line   6).*
│ │ │ │ -0001d5b0: 2047 656e 6572 6963 2053 6563 7572 6974   Generic Securit
│ │ │ │ -0001d5c0: 7920 5365 7276 6963 653a 2020 2020 2020  y Service:      
│ │ │ │ -0001d5d0: 2020 2020 2020 2020 4765 6e65 7269 6320          Generic 
│ │ │ │ -0001d5e0: 5365 6375 7269 7479 2053 6572 7669 6365  Security Service
│ │ │ │ -0001d5f0: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │ +0001d540: 2020 2020 2020 2053 7570 706f 7274 6564         Supported
│ │ │ │ +0001d550: 2050 6c61 7466 6f72 6d73 2e20 286c 696e   Platforms. (lin
│ │ │ │ +0001d560: 6520 2039 3329 0a2a 2067 656e 6572 616c  e  93).* general
│ │ │ │ +0001d570: 2064 6174 6520 7379 6e74 6178 3a20 2020   date syntax:   
│ │ │ │ +0001d580: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0001d590: 4765 6e65 7261 6c20 6461 7465 2073 796e  General date syn
│ │ │ │ +0001d5a0: 7461 782e 2028 6c69 6e65 2020 2036 290a  tax. (line   6).
│ │ │ │ +0001d5b0: 2a20 4765 6e65 7269 6320 5365 6375 7269  * Generic Securi
│ │ │ │ +0001d5c0: 7479 2053 6572 7669 6365 3a20 2020 2020  ty Service:     
│ │ │ │ +0001d5d0: 2020 2020 2020 2020 2047 656e 6572 6963           Generic
│ │ │ │ +0001d5e0: 2053 6563 7572 6974 7920 5365 7276 6963   Security Servic
│ │ │ │ +0001d5f0: 652e 0a20 2020 2020 2020 2020 2020 2020  e..             
│ │ │ │  0001d600: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001d610: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001d620: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001d630: 286c 696e 6520 2020 3629 0a2a 2047 4e55  (line   6).* GNU
│ │ │ │ -0001d640: 544c 533a 2020 2020 2020 2020 2020 2020  TLS:            
│ │ │ │ +0001d630: 2028 6c69 6e65 2020 2036 290a 2a20 474e   (line   6).* GN
│ │ │ │ +0001d640: 5554 4c53 3a20 2020 2020 2020 2020 2020  UTLS:           
│ │ │ │  0001d650: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001d660: 2020 2020 4b65 7262 6572 6f73 2076 6961      Kerberos via
│ │ │ │ -0001d670: 2054 4c53 2e20 2020 2028 6c69 6e65 2020   TLS.    (line  
│ │ │ │ -0001d680: 2036 290a 2a20 4753 532d 4150 493a 2020   6).* GSS-API:  
│ │ │ │ +0001d660: 2020 2020 204b 6572 6265 726f 7320 7669       Kerberos vi
│ │ │ │ +0001d670: 6120 544c 532e 2020 2020 286c 696e 6520  a TLS.    (line 
│ │ │ │ +0001d680: 2020 3629 0a2a 2047 5353 2d41 5049 3a20    6).* GSS-API: 
│ │ │ │  0001d690: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001d6a0: 2020 2020 2020 2020 2020 2020 2047 656e               Gen
│ │ │ │ -0001d6b0: 6572 6963 2053 6563 7572 6974 7920 5365  eric Security Se
│ │ │ │ -0001d6c0: 7276 6963 652e 0a20 2020 2020 2020 2020  rvice..         
│ │ │ │ +0001d6a0: 2020 2020 2020 2020 2020 2020 2020 4765                Ge
│ │ │ │ +0001d6b0: 6e65 7269 6320 5365 6375 7269 7479 2053  neric Security S
│ │ │ │ +0001d6c0: 6572 7669 6365 2e0a 2020 2020 2020 2020  ervice..        
│ │ │ │  0001d6d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001d6e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001d6f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001d700: 2020 2020 2028 6c69 6e65 2020 2036 290a       (line   6).
│ │ │ │ -0001d710: 2a20 4753 534c 6962 3a20 2020 2020 2020  * GSSLib:       
│ │ │ │ +0001d700: 2020 2020 2020 286c 696e 6520 2020 3629        (line   6)
│ │ │ │ +0001d710: 0a2a 2047 5353 4c69 623a 2020 2020 2020  .* GSSLib:      
│ │ │ │  0001d720: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001d730: 2020 2020 2020 2020 2047 656e 6572 6963           Generic
│ │ │ │ -0001d740: 2053 6563 7572 6974 7920 5365 7276 6963   Security Servic
│ │ │ │ -0001d750: 652e 0a20 2020 2020 2020 2020 2020 2020  e..             
│ │ │ │ +0001d730: 2020 2020 2020 2020 2020 4765 6e65 7269            Generi
│ │ │ │ +0001d740: 6320 5365 6375 7269 7479 2053 6572 7669  c Security Servi
│ │ │ │ +0001d750: 6365 2e0a 2020 2020 2020 2020 2020 2020  ce..            
│ │ │ │  0001d760: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001d770: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001d780: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001d790: 2028 6c69 6e65 2020 2036 290a 2a20 4861   (line   6).* Ha
│ │ │ │ -0001d7a0: 636b 696e 673a 2020 2020 2020 2020 2020  cking:          
│ │ │ │ +0001d790: 2020 286c 696e 6520 2020 3629 0a2a 2048    (line   6).* H
│ │ │ │ +0001d7a0: 6163 6b69 6e67 3a20 2020 2020 2020 2020  acking:         
│ │ │ │  0001d7b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001d7c0: 2020 2020 2043 6f6e 7472 6962 7574 696e       Contributin
│ │ │ │ -0001d7d0: 672e 2020 2020 2020 2020 286c 696e 6520  g.        (line 
│ │ │ │ -0001d7e0: 2020 3629 0a2a 2048 6967 6820 4176 6169    6).* High Avai
│ │ │ │ -0001d7f0: 6c61 6269 6c69 7479 3a20 2020 2020 2020  lability:       
│ │ │ │ -0001d800: 2020 2020 2020 2020 2020 2020 2020 4d75                Mu
│ │ │ │ -0001d810: 6c74 6970 6c65 2073 6572 7665 7273 2e20  ltiple servers. 
│ │ │ │ -0001d820: 2020 2028 6c69 6e65 2020 3632 290a 2a20     (line  62).* 
│ │ │ │ -0001d830: 4850 2d55 583a 2020 2020 2020 2020 2020  HP-UX:          
│ │ │ │ +0001d7c0: 2020 2020 2020 436f 6e74 7269 6275 7469        Contributi
│ │ │ │ +0001d7d0: 6e67 2e20 2020 2020 2020 2028 6c69 6e65  ng.        (line
│ │ │ │ +0001d7e0: 2020 2036 290a 2a20 4869 6768 2041 7661     6).* High Ava
│ │ │ │ +0001d7f0: 696c 6162 696c 6974 793a 2020 2020 2020  ilability:      
│ │ │ │ +0001d800: 2020 2020 2020 2020 2020 2020 2020 204d                 M
│ │ │ │ +0001d810: 756c 7469 706c 6520 7365 7276 6572 732e  ultiple servers.
│ │ │ │ +0001d820: 2020 2020 286c 696e 6520 2036 3229 0a2a      (line  62).*
│ │ │ │ +0001d830: 2048 502d 5558 3a20 2020 2020 2020 2020   HP-UX:         
│ │ │ │  0001d840: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001d850: 2020 2020 2020 2053 7570 706f 7274 6564         Supported
│ │ │ │ -0001d860: 2050 6c61 7466 6f72 6d73 2e20 286c 696e   Platforms. (lin
│ │ │ │ -0001d870: 6520 2037 3429 0a2a 2049 6e73 7461 6c6c  e  74).* Install
│ │ │ │ -0001d880: 6174 696f 6e3a 2020 2020 2020 2020 2020  ation:          
│ │ │ │ +0001d850: 2020 2020 2020 2020 5375 7070 6f72 7465          Supporte
│ │ │ │ +0001d860: 6420 506c 6174 666f 726d 732e 2028 6c69  d Platforms. (li
│ │ │ │ +0001d870: 6e65 2020 3734 290a 2a20 496e 7374 616c  ne  74).* Instal
│ │ │ │ +0001d880: 6c61 7469 6f6e 3a20 2020 2020 2020 2020  lation:         
│ │ │ │  0001d890: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001d8a0: 446f 776e 6c6f 6164 696e 6720 616e 6420  Downloading and 
│ │ │ │ -0001d8b0: 496e 7374 616c 6c69 6e67 2e0a 2020 2020  Installing..    
│ │ │ │ +0001d8a0: 2044 6f77 6e6c 6f61 6469 6e67 2061 6e64   Downloading and
│ │ │ │ +0001d8b0: 2049 6e73 7461 6c6c 696e 672e 0a20 2020   Installing..   
│ │ │ │  0001d8c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001d8d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001d8e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001d8f0: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ -0001d900: 2020 3629 0a2a 2049 5053 4543 3a20 2020    6).* IPSEC:   
│ │ │ │ +0001d8f0: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ +0001d900: 2020 2036 290a 2a20 4950 5345 433a 2020     6).* IPSEC:  
│ │ │ │  0001d910: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001d920: 2020 2020 2020 2020 2020 2020 2020 4d75                Mu
│ │ │ │ -0001d930: 6c74 6970 6c65 2073 6572 7665 7273 2e20  ltiple servers. 
│ │ │ │ -0001d940: 2020 2028 6c69 6e65 2020 2036 290a 2a20     (line   6).* 
│ │ │ │ -0001d950: 4952 4958 3a20 2020 2020 2020 2020 2020  IRIX:           
│ │ │ │ +0001d920: 2020 2020 2020 2020 2020 2020 2020 204d                 M
│ │ │ │ +0001d930: 756c 7469 706c 6520 7365 7276 6572 732e  ultiple servers.
│ │ │ │ +0001d940: 2020 2020 286c 696e 6520 2020 3629 0a2a      (line   6).*
│ │ │ │ +0001d950: 2049 5249 583a 2020 2020 2020 2020 2020   IRIX:          
│ │ │ │  0001d960: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001d970: 2020 2020 2020 2053 7570 706f 7274 6564         Supported
│ │ │ │ -0001d980: 2050 6c61 7466 6f72 6d73 2e20 286c 696e   Platforms. (lin
│ │ │ │ -0001d990: 6520 2036 3629 0a2a 2049 534f 2038 3630  e  66).* ISO 860
│ │ │ │ -0001d9a0: 3120 6461 7465 2061 6e64 2074 696d 6520  1 date and time 
│ │ │ │ -0001d9b0: 6f66 2064 6179 2066 6f72 6d61 743a 2020  of day format:  
│ │ │ │ -0001d9c0: 436f 6d62 696e 6564 2064 6174 6520 616e  Combined date an
│ │ │ │ -0001d9d0: 6420 7469 6d65 206f 6620 6461 7920 6974  d time of day it
│ │ │ │ -0001d9e0: 656d 732e 0a20 2020 2020 2020 2020 2020  ems..           
│ │ │ │ +0001d970: 2020 2020 2020 2020 5375 7070 6f72 7465          Supporte
│ │ │ │ +0001d980: 6420 506c 6174 666f 726d 732e 2028 6c69  d Platforms. (li
│ │ │ │ +0001d990: 6e65 2020 3636 290a 2a20 4953 4f20 3836  ne  66).* ISO 86
│ │ │ │ +0001d9a0: 3031 2064 6174 6520 616e 6420 7469 6d65  01 date and time
│ │ │ │ +0001d9b0: 206f 6620 6461 7920 666f 726d 6174 3a20   of day format: 
│ │ │ │ +0001d9c0: 2043 6f6d 6269 6e65 6420 6461 7465 2061   Combined date a
│ │ │ │ +0001d9d0: 6e64 2074 696d 6520 6f66 2064 6179 2069  nd time of day i
│ │ │ │ +0001d9e0: 7465 6d73 2e0a 2020 2020 2020 2020 2020  tems..          
│ │ │ │  0001d9f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001da00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001da10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001da20: 2020 2028 6c69 6e65 2020 2036 290a 2a20     (line   6).* 
│ │ │ │ -0001da30: 4953 4f20 3836 3031 2064 6174 6520 666f  ISO 8601 date fo
│ │ │ │ -0001da40: 726d 6174 3a20 2020 2020 2020 2020 2020  rmat:           
│ │ │ │ -0001da50: 2020 2020 2020 2043 616c 656e 6461 7220         Calendar 
│ │ │ │ -0001da60: 6461 7465 2069 7465 6d73 2e20 286c 696e  date items. (lin
│ │ │ │ -0001da70: 6520 2032 3829 0a2a 2069 7465 6d73 2069  e  28).* items i
│ │ │ │ -0001da80: 6e20 6461 7465 2073 7472 696e 6773 3a20  n date strings: 
│ │ │ │ +0001da20: 2020 2020 286c 696e 6520 2020 3629 0a2a      (line   6).*
│ │ │ │ +0001da30: 2049 534f 2038 3630 3120 6461 7465 2066   ISO 8601 date f
│ │ │ │ +0001da40: 6f72 6d61 743a 2020 2020 2020 2020 2020  ormat:          
│ │ │ │ +0001da50: 2020 2020 2020 2020 4361 6c65 6e64 6172          Calendar
│ │ │ │ +0001da60: 2064 6174 6520 6974 656d 732e 2028 6c69   date items. (li
│ │ │ │ +0001da70: 6e65 2020 3238 290a 2a20 6974 656d 7320  ne  28).* items 
│ │ │ │ +0001da80: 696e 2064 6174 6520 7374 7269 6e67 733a  in date strings:
│ │ │ │  0001da90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001daa0: 4765 6e65 7261 6c20 6461 7465 2073 796e  General date syn
│ │ │ │ -0001dab0: 7461 782e 2028 6c69 6e65 2020 2036 290a  tax. (line   6).
│ │ │ │ -0001dac0: 2a20 6b35 6c6f 6769 6e20 6175 7468 6f72  * k5login author
│ │ │ │ -0001dad0: 697a 6174 696f 6e3a 2020 2020 2020 2020  ization:        
│ │ │ │ -0001dae0: 2020 2020 2020 2020 204b 6572 6265 7269           Kerberi
│ │ │ │ -0001daf0: 7a65 6420 7273 6820 616e 6420 726c 6f67  zed rsh and rlog
│ │ │ │ -0001db00: 696e 2e0a 2020 2020 2020 2020 2020 2020  in..            
│ │ │ │ +0001daa0: 2047 656e 6572 616c 2064 6174 6520 7379   General date sy
│ │ │ │ +0001dab0: 6e74 6178 2e20 286c 696e 6520 2020 3629  ntax. (line   6)
│ │ │ │ +0001dac0: 0a2a 206b 356c 6f67 696e 2061 7574 686f  .* k5login autho
│ │ │ │ +0001dad0: 7269 7a61 7469 6f6e 3a20 2020 2020 2020  rization:       
│ │ │ │ +0001dae0: 2020 2020 2020 2020 2020 4b65 7262 6572            Kerber
│ │ │ │ +0001daf0: 697a 6564 2072 7368 2061 6e64 2072 6c6f  ized rsh and rlo
│ │ │ │ +0001db00: 6769 6e2e 0a20 2020 2020 2020 2020 2020  gin..           
│ │ │ │  0001db10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001db20: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001db30: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001db40: 2020 286c 696e 6520 3330 3729 0a2a 204b    (line 307).* K
│ │ │ │ -0001db50: 434d 4456 302e 323a 2020 2020 2020 2020  CMDV0.2:        
│ │ │ │ +0001db40: 2020 2028 6c69 6e65 2033 3037 290a 2a20     (line 307).* 
│ │ │ │ +0001db50: 4b43 4d44 5630 2e32 3a20 2020 2020 2020  KCMDV0.2:       
│ │ │ │  0001db60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001db70: 2020 2020 2020 4b65 7262 6572 697a 6564        Kerberized
│ │ │ │ -0001db80: 2072 7368 2061 6e64 2072 6c6f 6769 6e2e   rsh and rlogin.
│ │ │ │ -0001db90: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │ +0001db70: 2020 2020 2020 204b 6572 6265 7269 7a65         Kerberize
│ │ │ │ +0001db80: 6420 7273 6820 616e 6420 726c 6f67 696e  d rsh and rlogin
│ │ │ │ +0001db90: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │  0001dba0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001dbb0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001dbc0: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ -0001dbd0: 6c69 6e65 2020 2036 290a 2a20 4b43 4d44  line   6).* KCMD
│ │ │ │ -0001dbe0: 5630 2e33 3a20 2020 2020 2020 2020 2020  V0.3:           
│ │ │ │ +0001dbc0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0001dbd0: 286c 696e 6520 2020 3629 0a2a 204b 434d  (line   6).* KCM
│ │ │ │ +0001dbe0: 4456 302e 333a 2020 2020 2020 2020 2020  DV0.3:          
│ │ │ │  0001dbf0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001dc00: 2020 204b 6572 6265 7269 7a65 6420 7273     Kerberized rs
│ │ │ │ -0001dc10: 6820 616e 6420 726c 6f67 696e 2e0a 2020  h and rlogin..  
│ │ │ │ +0001dc00: 2020 2020 4b65 7262 6572 697a 6564 2072      Kerberized r
│ │ │ │ +0001dc10: 7368 2061 6e64 2072 6c6f 6769 6e2e 0a20  sh and rlogin.. 
│ │ │ │  0001dc20: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001dc30: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001dc40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001dc50: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ -0001dc60: 6520 3237 3729 0a2a 204b 4443 3a20 2020  e 277).* KDC:   
│ │ │ │ +0001dc50: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ +0001dc60: 6e65 2032 3737 290a 2a20 4b44 433a 2020  ne 277).* KDC:  
│ │ │ │  0001dc70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001dc80: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001dc90: 476c 6f73 7361 7279 206f 6620 7465 726d  Glossary of term
│ │ │ │ -0001dca0: 732e 2020 2028 6c69 6e65 2020 3539 290a  s.   (line  59).
│ │ │ │ -0001dcb0: 2a20 4b65 7262 6572 6f73 3a20 2020 2020  * Kerberos:     
│ │ │ │ +0001dc90: 2047 6c6f 7373 6172 7920 6f66 2074 6572   Glossary of ter
│ │ │ │ +0001dca0: 6d73 2e20 2020 286c 696e 6520 2035 3929  ms.   (line  59)
│ │ │ │ +0001dcb0: 0a2a 204b 6572 6265 726f 733a 2020 2020  .* Kerberos:    
│ │ │ │  0001dcc0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001dcd0: 2020 2020 2020 2020 2047 6c6f 7373 6172           Glossar
│ │ │ │ -0001dce0: 7920 6f66 2074 6572 6d73 2e20 2020 286c  y of terms.   (l
│ │ │ │ -0001dcf0: 696e 6520 2036 3829 0a2a 204b 6572 6265  ine  68).* Kerbe
│ │ │ │ -0001dd00: 726f 7320 5469 636b 6574 3a20 2020 2020  ros Ticket:     
│ │ │ │ +0001dcd0: 2020 2020 2020 2020 2020 476c 6f73 7361            Glossa
│ │ │ │ +0001dce0: 7279 206f 6620 7465 726d 732e 2020 2028  ry of terms.   (
│ │ │ │ +0001dcf0: 6c69 6e65 2020 3638 290a 2a20 4b65 7262  line  68).* Kerb
│ │ │ │ +0001dd00: 6572 6f73 2054 6963 6b65 743a 2020 2020  eros Ticket:    
│ │ │ │  0001dd10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001dd20: 2020 476c 6f73 7361 7279 206f 6620 7465    Glossary of te
│ │ │ │ -0001dd30: 726d 732e 2020 2028 6c69 6e65 2031 3235  rms.   (line 125
│ │ │ │ -0001dd40: 290a 2a20 4b65 7920 5665 7273 696f 6e20  ).* Key Version 
│ │ │ │ -0001dd50: 4e75 6d62 6572 2028 6b76 6e6f 293a 2020  Number (kvno):  
│ │ │ │ -0001dd60: 2020 2020 2020 2020 2020 2047 6c6f 7373             Gloss
│ │ │ │ -0001dd70: 6172 7920 6f66 2074 6572 6d73 2e20 2020  ary of terms.   
│ │ │ │ -0001dd80: 286c 696e 6520 2037 3429 0a2a 206b 6579  (line  74).* key
│ │ │ │ -0001dd90: 7461 622c 2066 696c 6520 666f 726d 6174  tab, file format
│ │ │ │ -0001dda0: 206f 663a 2020 2020 2020 2020 2020 2020   of:            
│ │ │ │ -0001ddb0: 2020 2020 5468 6520 4b65 7974 6162 2042      The Keytab B
│ │ │ │ -0001ddc0: 696e 6172 7920 4669 6c65 2046 6f72 6d61  inary File Forma
│ │ │ │ -0001ddd0: 742e 0a20 2020 2020 2020 2020 2020 2020  t..             
│ │ │ │ +0001dd20: 2020 2047 6c6f 7373 6172 7920 6f66 2074     Glossary of t
│ │ │ │ +0001dd30: 6572 6d73 2e20 2020 286c 696e 6520 3132  erms.   (line 12
│ │ │ │ +0001dd40: 3529 0a2a 204b 6579 2056 6572 7369 6f6e  5).* Key Version
│ │ │ │ +0001dd50: 204e 756d 6265 7220 286b 766e 6f29 3a20   Number (kvno): 
│ │ │ │ +0001dd60: 2020 2020 2020 2020 2020 2020 476c 6f73              Glos
│ │ │ │ +0001dd70: 7361 7279 206f 6620 7465 726d 732e 2020  sary of terms.  
│ │ │ │ +0001dd80: 2028 6c69 6e65 2020 3734 290a 2a20 6b65   (line  74).* ke
│ │ │ │ +0001dd90: 7974 6162 2c20 6669 6c65 2066 6f72 6d61  ytab, file forma
│ │ │ │ +0001dda0: 7420 6f66 3a20 2020 2020 2020 2020 2020  t of:           
│ │ │ │ +0001ddb0: 2020 2020 2054 6865 204b 6579 7461 6220       The Keytab 
│ │ │ │ +0001ddc0: 4269 6e61 7279 2046 696c 6520 466f 726d  Binary File Form
│ │ │ │ +0001ddd0: 6174 2e0a 2020 2020 2020 2020 2020 2020  at..            
│ │ │ │  0001dde0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001ddf0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001de00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001de10: 2028 6c69 6e65 2020 2036 290a 2a20 6c61   (line   6).* la
│ │ │ │ -0001de20: 6e67 7561 6765 2c20 696e 2064 6174 6573  nguage, in dates
│ │ │ │ -0001de30: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ -0001de40: 2020 2020 2047 656e 6572 616c 2064 6174       General dat
│ │ │ │ -0001de50: 6520 7379 6e74 6178 2e20 286c 696e 6520  e syntax. (line 
│ │ │ │ -0001de60: 2033 3629 0a2a 206c 616e 6775 6167 652c   36).* language,
│ │ │ │ -0001de70: 2069 6e20 6461 7465 7320 3c31 3e3a 2020   in dates <1>:  
│ │ │ │ -0001de80: 2020 2020 2020 2020 2020 2020 2020 4765                Ge
│ │ │ │ -0001de90: 6e65 7261 6c20 6461 7465 2073 796e 7461  neral date synta
│ │ │ │ -0001dea0: 782e 2028 6c69 6e65 2020 3430 290a 2a20  x. (line  40).* 
│ │ │ │ -0001deb0: 4c44 4150 3a20 2020 2020 2020 2020 2020  LDAP:           
│ │ │ │ +0001de10: 2020 286c 696e 6520 2020 3629 0a2a 206c    (line   6).* l
│ │ │ │ +0001de20: 616e 6775 6167 652c 2069 6e20 6461 7465  anguage, in date
│ │ │ │ +0001de30: 733a 2020 2020 2020 2020 2020 2020 2020  s:              
│ │ │ │ +0001de40: 2020 2020 2020 4765 6e65 7261 6c20 6461        General da
│ │ │ │ +0001de50: 7465 2073 796e 7461 782e 2028 6c69 6e65  te syntax. (line
│ │ │ │ +0001de60: 2020 3336 290a 2a20 6c61 6e67 7561 6765    36).* language
│ │ │ │ +0001de70: 2c20 696e 2064 6174 6573 203c 313e 3a20  , in dates <1>: 
│ │ │ │ +0001de80: 2020 2020 2020 2020 2020 2020 2020 2047                 G
│ │ │ │ +0001de90: 656e 6572 616c 2064 6174 6520 7379 6e74  eneral date synt
│ │ │ │ +0001dea0: 6178 2e20 286c 696e 6520 2034 3029 0a2a  ax. (line  40).*
│ │ │ │ +0001deb0: 204c 4441 503a 2020 2020 2020 2020 2020   LDAP:          
│ │ │ │  0001dec0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001ded0: 2020 2020 2020 204d 756c 7469 706c 6520         Multiple 
│ │ │ │ -0001dee0: 7365 7276 6572 732e 2020 2020 286c 696e  servers.    (lin
│ │ │ │ -0001def0: 6520 2020 3629 0a2a 206c 6561 7020 7365  e   6).* leap se
│ │ │ │ -0001df00: 636f 6e64 733a 2020 2020 2020 2020 2020  conds:          
│ │ │ │ +0001ded0: 2020 2020 2020 2020 4d75 6c74 6970 6c65          Multiple
│ │ │ │ +0001dee0: 2073 6572 7665 7273 2e20 2020 2028 6c69   servers.    (li
│ │ │ │ +0001def0: 6e65 2020 2036 290a 2a20 6c65 6170 2073  ne   6).* leap s
│ │ │ │ +0001df00: 6563 6f6e 6473 3a20 2020 2020 2020 2020  econds:         
│ │ │ │  0001df10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001df20: 4765 6e65 7261 6c20 6461 7465 2073 796e  General date syn
│ │ │ │ -0001df30: 7461 782e 2028 6c69 6e65 2020 3635 290a  tax. (line  65).
│ │ │ │ -0001df40: 2a20 6c65 6170 2073 6563 6f6e 6473 203c  * leap seconds <
│ │ │ │ -0001df50: 313e 3a20 2020 2020 2020 2020 2020 2020  1>:             
│ │ │ │ -0001df60: 2020 2020 2020 2020 2054 696d 6520 6f66           Time of
│ │ │ │ -0001df70: 2064 6179 2069 7465 6d73 2e20 2020 286c   day items.   (l
│ │ │ │ -0001df80: 696e 6520 2031 3429 0a2a 206c 6561 7020  ine  14).* leap 
│ │ │ │ -0001df90: 7365 636f 6e64 7320 3c32 3e3a 2020 2020  seconds <2>:    
│ │ │ │ +0001df20: 2047 656e 6572 616c 2064 6174 6520 7379   General date sy
│ │ │ │ +0001df30: 6e74 6178 2e20 286c 696e 6520 2036 3529  ntax. (line  65)
│ │ │ │ +0001df40: 0a2a 206c 6561 7020 7365 636f 6e64 7320  .* leap seconds 
│ │ │ │ +0001df50: 3c31 3e3a 2020 2020 2020 2020 2020 2020  <1>:            
│ │ │ │ +0001df60: 2020 2020 2020 2020 2020 5469 6d65 206f            Time o
│ │ │ │ +0001df70: 6620 6461 7920 6974 656d 732e 2020 2028  f day items.   (
│ │ │ │ +0001df80: 6c69 6e65 2020 3134 290a 2a20 6c65 6170  line  14).* leap
│ │ │ │ +0001df90: 2073 6563 6f6e 6473 203c 323e 3a20 2020   seconds <2>:   
│ │ │ │  0001dfa0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001dfb0: 2020 5365 636f 6e64 7320 7369 6e63 6520    Seconds since 
│ │ │ │ -0001dfc0: 7468 6520 4570 6f63 682e 0a20 2020 2020  the Epoch..     
│ │ │ │ +0001dfb0: 2020 2053 6563 6f6e 6473 2073 696e 6365     Seconds since
│ │ │ │ +0001dfc0: 2074 6865 2045 706f 6368 2e0a 2020 2020   the Epoch..    
│ │ │ │  0001dfd0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001dfe0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001dff0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001e000: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ -0001e010: 3237 290a 2a20 4d61 634b 656e 7a69 652c  27).* MacKenzie,
│ │ │ │ -0001e020: 2044 6176 6964 3a20 2020 2020 2020 2020   David:         
│ │ │ │ -0001e030: 2020 2020 2020 2020 2020 2020 2041 7574               Aut
│ │ │ │ -0001e040: 686f 7273 206f 6620 7061 7273 655f 6461  hors of parse_da
│ │ │ │ -0001e050: 7465 7469 6d65 2e0a 2020 2020 2020 2020  tetime..        
│ │ │ │ +0001e000: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ +0001e010: 2032 3729 0a2a 204d 6163 4b65 6e7a 6965   27).* MacKenzie
│ │ │ │ +0001e020: 2c20 4461 7669 643a 2020 2020 2020 2020  , David:        
│ │ │ │ +0001e030: 2020 2020 2020 2020 2020 2020 2020 4175                Au
│ │ │ │ +0001e040: 7468 6f72 7320 6f66 2070 6172 7365 5f64  thors of parse_d
│ │ │ │ +0001e050: 6174 6574 696d 652e 0a20 2020 2020 2020  atetime..       
│ │ │ │  0001e060: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001e070: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001e080: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001e090: 2020 2020 2020 286c 696e 6520 2020 3629        (line   6)
│ │ │ │ -0001e0a0: 0a2a 204d 6163 4f53 2058 3a20 2020 2020  .* MacOS X:     
│ │ │ │ +0001e090: 2020 2020 2020 2028 6c69 6e65 2020 2036         (line   6
│ │ │ │ +0001e0a0: 290a 2a20 4d61 634f 5320 583a 2020 2020  ).* MacOS X:    
│ │ │ │  0001e0b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001e0c0: 2020 2020 2020 2020 2020 5375 7070 6f72            Suppor
│ │ │ │ -0001e0d0: 7465 6420 506c 6174 666f 726d 732e 2028  ted Platforms. (
│ │ │ │ -0001e0e0: 6c69 6e65 2020 3939 290a 2a20 4d61 6e64  line  99).* Mand
│ │ │ │ -0001e0f0: 7261 6b65 3a20 2020 2020 2020 2020 2020  rake:           
│ │ │ │ +0001e0c0: 2020 2020 2020 2020 2020 2053 7570 706f             Suppo
│ │ │ │ +0001e0d0: 7274 6564 2050 6c61 7466 6f72 6d73 2e20  rted Platforms. 
│ │ │ │ +0001e0e0: 286c 696e 6520 2039 3929 0a2a 204d 616e  (line  99).* Man
│ │ │ │ +0001e0f0: 6472 616b 653a 2020 2020 2020 2020 2020  drake:          
│ │ │ │  0001e100: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001e110: 2020 2053 7570 706f 7274 6564 2050 6c61     Supported Pla
│ │ │ │ -0001e120: 7466 6f72 6d73 2e20 286c 696e 6520 2036  tforms. (line  6
│ │ │ │ -0001e130: 3229 0a2a 206d 6173 7465 7220 7365 7276  2).* master serv
│ │ │ │ -0001e140: 6572 3a20 2020 2020 2020 2020 2020 2020  er:             
│ │ │ │ -0001e150: 2020 2020 2020 2020 2020 2020 4d75 6c74              Mult
│ │ │ │ -0001e160: 6970 6c65 2073 6572 7665 7273 2e20 2020  iple servers.   
│ │ │ │ -0001e170: 2028 6c69 6e65 2020 3133 290a 2a20 4d65   (line  13).* Me
│ │ │ │ -0001e180: 7965 7269 6e67 2c20 4a69 6d3a 2020 2020  yering, Jim:    
│ │ │ │ +0001e110: 2020 2020 5375 7070 6f72 7465 6420 506c      Supported Pl
│ │ │ │ +0001e120: 6174 666f 726d 732e 2028 6c69 6e65 2020  atforms. (line  
│ │ │ │ +0001e130: 3632 290a 2a20 6d61 7374 6572 2073 6572  62).* master ser
│ │ │ │ +0001e140: 7665 723a 2020 2020 2020 2020 2020 2020  ver:            
│ │ │ │ +0001e150: 2020 2020 2020 2020 2020 2020 204d 756c               Mul
│ │ │ │ +0001e160: 7469 706c 6520 7365 7276 6572 732e 2020  tiple servers.  
│ │ │ │ +0001e170: 2020 286c 696e 6520 2031 3329 0a2a 204d    (line  13).* M
│ │ │ │ +0001e180: 6579 6572 696e 672c 204a 696d 3a20 2020  eyering, Jim:   
│ │ │ │  0001e190: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001e1a0: 2020 2020 2041 7574 686f 7273 206f 6620       Authors of 
│ │ │ │ -0001e1b0: 7061 7273 655f 6461 7465 7469 6d65 2e0a  parse_datetime..
│ │ │ │ -0001e1c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0001e1a0: 2020 2020 2020 4175 7468 6f72 7320 6f66        Authors of
│ │ │ │ +0001e1b0: 2070 6172 7365 5f64 6174 6574 696d 652e   parse_datetime.
│ │ │ │ +0001e1c0: 0a20 2020 2020 2020 2020 2020 2020 2020  .               
│ │ │ │  0001e1d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001e1e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001e1f0: 2020 2020 2020 2020 2020 2020 2020 286c                (l
│ │ │ │ -0001e200: 696e 6520 2020 3629 0a2a 206d 696e 7574  ine   6).* minut
│ │ │ │ -0001e210: 6573 2c20 7469 6d65 207a 6f6e 6520 636f  es, time zone co
│ │ │ │ -0001e220: 7272 6563 7469 6f6e 2062 793a 2020 2020  rrection by:    
│ │ │ │ -0001e230: 2020 5469 6d65 206f 6620 6461 7920 6974    Time of day it
│ │ │ │ -0001e240: 656d 732e 2020 2028 6c69 6e65 2020 3239  ems.   (line  29
│ │ │ │ -0001e250: 290a 2a20 6d6f 6e74 6820 6e61 6d65 7320  ).* month names 
│ │ │ │ -0001e260: 696e 2064 6174 6520 7374 7269 6e67 733a  in date strings:
│ │ │ │ -0001e270: 2020 2020 2020 2020 2020 2043 616c 656e             Calen
│ │ │ │ -0001e280: 6461 7220 6461 7465 2069 7465 6d73 2e20  dar date items. 
│ │ │ │ -0001e290: 286c 696e 6520 2033 3629 0a2a 206d 6f6e  (line  36).* mon
│ │ │ │ -0001e2a0: 7468 732c 2077 7269 7474 656e 2d6f 7574  ths, written-out
│ │ │ │ -0001e2b0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ -0001e2c0: 2020 2020 4765 6e65 7261 6c20 6461 7465      General date
│ │ │ │ -0001e2d0: 2073 796e 7461 782e 2028 6c69 6e65 2020   syntax. (line  
│ │ │ │ -0001e2e0: 3332 290a 2a20 4d6f 746f 726f 6c61 2043  32).* Motorola C
│ │ │ │ -0001e2f0: 6f6c 6466 6972 653a 2020 2020 2020 2020  oldfire:        
│ │ │ │ -0001e300: 2020 2020 2020 2020 2020 2020 2053 7570               Sup
│ │ │ │ -0001e310: 706f 7274 6564 2050 6c61 7466 6f72 6d73  ported Platforms
│ │ │ │ -0001e320: 2e20 286c 696e 6520 3130 3329 0a2a 204e  . (line 103).* N
│ │ │ │ -0001e330: 6574 4253 443a 2020 2020 2020 2020 2020  etBSD:          
│ │ │ │ +0001e1f0: 2020 2020 2020 2020 2020 2020 2020 2028                 (
│ │ │ │ +0001e200: 6c69 6e65 2020 2036 290a 2a20 6d69 6e75  line   6).* minu
│ │ │ │ +0001e210: 7465 732c 2074 696d 6520 7a6f 6e65 2063  tes, time zone c
│ │ │ │ +0001e220: 6f72 7265 6374 696f 6e20 6279 3a20 2020  orrection by:   
│ │ │ │ +0001e230: 2020 2054 696d 6520 6f66 2064 6179 2069     Time of day i
│ │ │ │ +0001e240: 7465 6d73 2e20 2020 286c 696e 6520 2032  tems.   (line  2
│ │ │ │ +0001e250: 3929 0a2a 206d 6f6e 7468 206e 616d 6573  9).* month names
│ │ │ │ +0001e260: 2069 6e20 6461 7465 2073 7472 696e 6773   in date strings
│ │ │ │ +0001e270: 3a20 2020 2020 2020 2020 2020 4361 6c65  :           Cale
│ │ │ │ +0001e280: 6e64 6172 2064 6174 6520 6974 656d 732e  ndar date items.
│ │ │ │ +0001e290: 2028 6c69 6e65 2020 3336 290a 2a20 6d6f   (line  36).* mo
│ │ │ │ +0001e2a0: 6e74 6873 2c20 7772 6974 7465 6e2d 6f75  nths, written-ou
│ │ │ │ +0001e2b0: 743a 2020 2020 2020 2020 2020 2020 2020  t:              
│ │ │ │ +0001e2c0: 2020 2020 2047 656e 6572 616c 2064 6174       General dat
│ │ │ │ +0001e2d0: 6520 7379 6e74 6178 2e20 286c 696e 6520  e syntax. (line 
│ │ │ │ +0001e2e0: 2033 3229 0a2a 204d 6f74 6f72 6f6c 6120   32).* Motorola 
│ │ │ │ +0001e2f0: 436f 6c64 6669 7265 3a20 2020 2020 2020  Coldfire:       
│ │ │ │ +0001e300: 2020 2020 2020 2020 2020 2020 2020 5375                Su
│ │ │ │ +0001e310: 7070 6f72 7465 6420 506c 6174 666f 726d  pported Platform
│ │ │ │ +0001e320: 732e 2028 6c69 6e65 2031 3033 290a 2a20  s. (line 103).* 
│ │ │ │ +0001e330: 4e65 7442 5344 3a20 2020 2020 2020 2020  NetBSD:         
│ │ │ │  0001e340: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001e350: 2020 2020 2020 5375 7070 6f72 7465 6420        Supported 
│ │ │ │ -0001e360: 506c 6174 666f 726d 732e 2028 6c69 6e65  Platforms. (line
│ │ │ │ -0001e370: 2020 3833 290a 2a20 4e46 533a 2020 2020    83).* NFS:    
│ │ │ │ +0001e350: 2020 2020 2020 2053 7570 706f 7274 6564         Supported
│ │ │ │ +0001e360: 2050 6c61 7466 6f72 6d73 2e20 286c 696e   Platforms. (lin
│ │ │ │ +0001e370: 6520 2038 3329 0a2a 204e 4653 3a20 2020  e  83).* NFS:   
│ │ │ │  0001e380: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001e390: 2020 2020 2020 2020 2020 2020 2020 204d                 M
│ │ │ │ -0001e3a0: 756c 7469 706c 6520 7365 7276 6572 732e  ultiple servers.
│ │ │ │ -0001e3b0: 2020 2020 286c 696e 6520 2020 3629 0a2a      (line   6).*
│ │ │ │ -0001e3c0: 206e 756d 6265 7273 2c20 7772 6974 7465   numbers, writte
│ │ │ │ -0001e3d0: 6e2d 6f75 743a 2020 2020 2020 2020 2020  n-out:          
│ │ │ │ -0001e3e0: 2020 2020 2020 2020 4765 6e65 7261 6c20          General 
│ │ │ │ -0001e3f0: 6461 7465 2073 796e 7461 782e 2028 6c69  date syntax. (li
│ │ │ │ -0001e400: 6e65 2020 3232 290a 2a20 4f70 656e 4253  ne  22).* OpenBS
│ │ │ │ -0001e410: 443a 2020 2020 2020 2020 2020 2020 2020  D:              
│ │ │ │ +0001e390: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0001e3a0: 4d75 6c74 6970 6c65 2073 6572 7665 7273  Multiple servers
│ │ │ │ +0001e3b0: 2e20 2020 2028 6c69 6e65 2020 2036 290a  .    (line   6).
│ │ │ │ +0001e3c0: 2a20 6e75 6d62 6572 732c 2077 7269 7474  * numbers, writt
│ │ │ │ +0001e3d0: 656e 2d6f 7574 3a20 2020 2020 2020 2020  en-out:         
│ │ │ │ +0001e3e0: 2020 2020 2020 2020 2047 656e 6572 616c           General
│ │ │ │ +0001e3f0: 2064 6174 6520 7379 6e74 6178 2e20 286c   date syntax. (l
│ │ │ │ +0001e400: 696e 6520 2032 3229 0a2a 204f 7065 6e42  ine  22).* OpenB
│ │ │ │ +0001e410: 5344 3a20 2020 2020 2020 2020 2020 2020  SD:             
│ │ │ │  0001e420: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001e430: 2053 7570 706f 7274 6564 2050 6c61 7466   Supported Platf
│ │ │ │ -0001e440: 6f72 6d73 2e20 286c 696e 6520 2038 3829  orms. (line  88)
│ │ │ │ -0001e450: 0a2a 206f 7264 696e 616c 206e 756d 6265  .* ordinal numbe
│ │ │ │ -0001e460: 7273 3a20 2020 2020 2020 2020 2020 2020  rs:             
│ │ │ │ -0001e470: 2020 2020 2020 2020 2020 4765 6e65 7261            Genera
│ │ │ │ -0001e480: 6c20 6461 7465 2073 796e 7461 782e 2028  l date syntax. (
│ │ │ │ -0001e490: 6c69 6e65 2020 3232 290a 2a20 5069 6e61  line  22).* Pina
│ │ │ │ -0001e4a0: 7264 2c20 462e 3a20 2020 2020 2020 2020  rd, F.:         
│ │ │ │ +0001e430: 2020 5375 7070 6f72 7465 6420 506c 6174    Supported Plat
│ │ │ │ +0001e440: 666f 726d 732e 2028 6c69 6e65 2020 3838  forms. (line  88
│ │ │ │ +0001e450: 290a 2a20 6f72 6469 6e61 6c20 6e75 6d62  ).* ordinal numb
│ │ │ │ +0001e460: 6572 733a 2020 2020 2020 2020 2020 2020  ers:            
│ │ │ │ +0001e470: 2020 2020 2020 2020 2020 2047 656e 6572             Gener
│ │ │ │ +0001e480: 616c 2064 6174 6520 7379 6e74 6178 2e20  al date syntax. 
│ │ │ │ +0001e490: 286c 696e 6520 2032 3229 0a2a 2050 696e  (line  22).* Pin
│ │ │ │ +0001e4a0: 6172 642c 2046 2e3a 2020 2020 2020 2020  ard, F.:        
│ │ │ │  0001e4b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001e4c0: 2020 2041 7574 686f 7273 206f 6620 7061     Authors of pa
│ │ │ │ -0001e4d0: 7273 655f 6461 7465 7469 6d65 2e0a 2020  rse_datetime..  
│ │ │ │ +0001e4c0: 2020 2020 4175 7468 6f72 7320 6f66 2070      Authors of p
│ │ │ │ +0001e4d0: 6172 7365 5f64 6174 6574 696d 652e 0a20  arse_datetime.. 
│ │ │ │  0001e4e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001e4f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001e500: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001e510: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ -0001e520: 6520 2031 3929 0a2a 2050 6c61 696e 7465  e  19).* Plainte
│ │ │ │ -0001e530: 7874 3a20 2020 2020 2020 2020 2020 2020  xt:             
│ │ │ │ +0001e510: 2020 2020 2020 2020 2020 2020 2028 6c69               (li
│ │ │ │ +0001e520: 6e65 2020 3139 290a 2a20 506c 6169 6e74  ne  19).* Plaint
│ │ │ │ +0001e530: 6578 743a 2020 2020 2020 2020 2020 2020  ext:            
│ │ │ │  0001e540: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001e550: 476c 6f73 7361 7279 206f 6620 7465 726d  Glossary of term
│ │ │ │ -0001e560: 732e 2020 2028 6c69 6e65 2020 3831 290a  s.   (line  81).
│ │ │ │ -0001e570: 2a20 5072 696e 6369 7061 6c3a 2020 2020  * Principal:    
│ │ │ │ +0001e550: 2047 6c6f 7373 6172 7920 6f66 2074 6572   Glossary of ter
│ │ │ │ +0001e560: 6d73 2e20 2020 286c 696e 6520 2038 3129  ms.   (line  81)
│ │ │ │ +0001e570: 0a2a 2050 7269 6e63 6970 616c 3a20 2020  .* Principal:   
│ │ │ │  0001e580: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001e590: 2020 2020 2020 2020 2047 6c6f 7373 6172           Glossar
│ │ │ │ -0001e5a0: 7920 6f66 2074 6572 6d73 2e20 2020 286c  y of terms.   (l
│ │ │ │ -0001e5b0: 696e 6520 2038 3529 0a2a 2050 7269 6e63  ine  85).* Princ
│ │ │ │ -0001e5c0: 6970 616c 2069 6465 6e74 6966 6965 723a  ipal identifier:
│ │ │ │ -0001e5d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001e5e0: 2020 476c 6f73 7361 7279 206f 6620 7465    Glossary of te
│ │ │ │ -0001e5f0: 726d 732e 2020 2028 6c69 6e65 2020 3839  rms.   (line  89
│ │ │ │ -0001e600: 290a 2a20 5072 6f74 6f63 6f6c 2045 7874  ).* Protocol Ext
│ │ │ │ -0001e610: 656e 7369 6f6e 733a 2020 2020 2020 2020  ensions:        
│ │ │ │ -0001e620: 2020 2020 2020 2020 2020 2050 726f 746f             Proto
│ │ │ │ -0001e630: 636f 6c20 4578 7465 6e73 696f 6e73 2e20  col Extensions. 
│ │ │ │ -0001e640: 286c 696e 6520 2020 3629 0a2a 2070 7572  (line   6).* pur
│ │ │ │ -0001e650: 6520 6e75 6d62 6572 7320 696e 2064 6174  e numbers in dat
│ │ │ │ -0001e660: 6520 7374 7269 6e67 733a 2020 2020 2020  e strings:      
│ │ │ │ -0001e670: 2020 2020 5075 7265 206e 756d 6265 7273      Pure numbers
│ │ │ │ -0001e680: 2069 6e20 6461 7465 2073 7472 696e 6773   in date strings
│ │ │ │ -0001e690: 2e0a 2020 2020 2020 2020 2020 2020 2020  ..              
│ │ │ │ +0001e590: 2020 2020 2020 2020 2020 476c 6f73 7361            Glossa
│ │ │ │ +0001e5a0: 7279 206f 6620 7465 726d 732e 2020 2028  ry of terms.   (
│ │ │ │ +0001e5b0: 6c69 6e65 2020 3835 290a 2a20 5072 696e  line  85).* Prin
│ │ │ │ +0001e5c0: 6369 7061 6c20 6964 656e 7469 6669 6572  cipal identifier
│ │ │ │ +0001e5d0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ +0001e5e0: 2020 2047 6c6f 7373 6172 7920 6f66 2074     Glossary of t
│ │ │ │ +0001e5f0: 6572 6d73 2e20 2020 286c 696e 6520 2038  erms.   (line  8
│ │ │ │ +0001e600: 3929 0a2a 2050 726f 746f 636f 6c20 4578  9).* Protocol Ex
│ │ │ │ +0001e610: 7465 6e73 696f 6e73 3a20 2020 2020 2020  tensions:       
│ │ │ │ +0001e620: 2020 2020 2020 2020 2020 2020 5072 6f74              Prot
│ │ │ │ +0001e630: 6f63 6f6c 2045 7874 656e 7369 6f6e 732e  ocol Extensions.
│ │ │ │ +0001e640: 2028 6c69 6e65 2020 2036 290a 2a20 7075   (line   6).* pu
│ │ │ │ +0001e650: 7265 206e 756d 6265 7273 2069 6e20 6461  re numbers in da
│ │ │ │ +0001e660: 7465 2073 7472 696e 6773 3a20 2020 2020  te strings:     
│ │ │ │ +0001e670: 2020 2020 2050 7572 6520 6e75 6d62 6572       Pure number
│ │ │ │ +0001e680: 7320 696e 2064 6174 6520 7374 7269 6e67  s in date string
│ │ │ │ +0001e690: 732e 0a20 2020 2020 2020 2020 2020 2020  s..             
│ │ │ │  0001e6a0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001e6b0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001e6c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001e6d0: 286c 696e 6520 2020 3629 0a2a 2052 6564  (line   6).* Red
│ │ │ │ -0001e6e0: 4861 743a 2020 2020 2020 2020 2020 2020  Hat:            
│ │ │ │ +0001e6d0: 2028 6c69 6e65 2020 2036 290a 2a20 5265   (line   6).* Re
│ │ │ │ +0001e6e0: 6448 6174 3a20 2020 2020 2020 2020 2020  dHat:           
│ │ │ │  0001e6f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001e700: 2020 2020 5375 7070 6f72 7465 6420 506c      Supported Pl
│ │ │ │ -0001e710: 6174 666f 726d 732e 2028 6c69 6e65 2020  atforms. (line  
│ │ │ │ -0001e720: 3435 290a 2a20 5265 6448 6174 203c 313e  45).* RedHat <1>
│ │ │ │ -0001e730: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ -0001e740: 2020 2020 2020 2020 2020 2020 2053 7570               Sup
│ │ │ │ -0001e750: 706f 7274 6564 2050 6c61 7466 6f72 6d73  ported Platforms
│ │ │ │ -0001e760: 2e20 286c 696e 6520 2035 3029 0a2a 2052  . (line  50).* R
│ │ │ │ -0001e770: 6564 4861 7420 3c32 3e3a 2020 2020 2020  edHat <2>:      
│ │ │ │ +0001e700: 2020 2020 2053 7570 706f 7274 6564 2050       Supported P
│ │ │ │ +0001e710: 6c61 7466 6f72 6d73 2e20 286c 696e 6520  latforms. (line 
│ │ │ │ +0001e720: 2034 3529 0a2a 2052 6564 4861 7420 3c31   45).* RedHat <1
│ │ │ │ +0001e730: 3e3a 2020 2020 2020 2020 2020 2020 2020  >:              
│ │ │ │ +0001e740: 2020 2020 2020 2020 2020 2020 2020 5375                Su
│ │ │ │ +0001e750: 7070 6f72 7465 6420 506c 6174 666f 726d  pported Platform
│ │ │ │ +0001e760: 732e 2028 6c69 6e65 2020 3530 290a 2a20  s. (line  50).* 
│ │ │ │ +0001e770: 5265 6448 6174 203c 323e 3a20 2020 2020  RedHat <2>:     
│ │ │ │  0001e780: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001e790: 2020 2020 2020 5375 7070 6f72 7465 6420        Supported 
│ │ │ │ -0001e7a0: 506c 6174 666f 726d 732e 2028 6c69 6e65  Platforms. (line
│ │ │ │ -0001e7b0: 2020 3538 290a 2a20 5265 6448 6174 2041    58).* RedHat A
│ │ │ │ -0001e7c0: 6476 616e 6365 6420 5365 7276 6572 3a20  dvanced Server: 
│ │ │ │ -0001e7d0: 2020 2020 2020 2020 2020 2020 2020 2053                 S
│ │ │ │ -0001e7e0: 7570 706f 7274 6564 2050 6c61 7466 6f72  upported Platfor
│ │ │ │ -0001e7f0: 6d73 2e20 286c 696e 6520 2035 3429 0a2a  ms. (line  54).*
│ │ │ │ -0001e800: 2072 656c 6174 6976 6520 6974 656d 7320   relative items 
│ │ │ │ -0001e810: 696e 2064 6174 6520 7374 7269 6e67 733a  in date strings:
│ │ │ │ -0001e820: 2020 2020 2020 2020 5265 6c61 7469 7665          Relative
│ │ │ │ -0001e830: 2069 7465 6d73 2069 6e20 6461 7465 2073   items in date s
│ │ │ │ -0001e840: 7472 696e 6773 2e0a 2020 2020 2020 2020  trings..        
│ │ │ │ +0001e790: 2020 2020 2020 2053 7570 706f 7274 6564         Supported
│ │ │ │ +0001e7a0: 2050 6c61 7466 6f72 6d73 2e20 286c 696e   Platforms. (lin
│ │ │ │ +0001e7b0: 6520 2035 3829 0a2a 2052 6564 4861 7420  e  58).* RedHat 
│ │ │ │ +0001e7c0: 4164 7661 6e63 6564 2053 6572 7665 723a  Advanced Server:
│ │ │ │ +0001e7d0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0001e7e0: 5375 7070 6f72 7465 6420 506c 6174 666f  Supported Platfo
│ │ │ │ +0001e7f0: 726d 732e 2028 6c69 6e65 2020 3534 290a  rms. (line  54).
│ │ │ │ +0001e800: 2a20 7265 6c61 7469 7665 2069 7465 6d73  * relative items
│ │ │ │ +0001e810: 2069 6e20 6461 7465 2073 7472 696e 6773   in date strings
│ │ │ │ +0001e820: 3a20 2020 2020 2020 2052 656c 6174 6976  :        Relativ
│ │ │ │ +0001e830: 6520 6974 656d 7320 696e 2064 6174 6520  e items in date 
│ │ │ │ +0001e840: 7374 7269 6e67 732e 0a20 2020 2020 2020  strings..       
│ │ │ │  0001e850: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001e860: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001e870: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001e880: 2020 2020 2020 286c 696e 6520 2020 3629        (line   6)
│ │ │ │ -0001e890: 0a2a 2072 656d 6f74 6520 6461 7461 6261  .* remote databa
│ │ │ │ -0001e8a0: 7365 733a 2020 2020 2020 2020 2020 2020  ses:            
│ │ │ │ -0001e8b0: 2020 2020 2020 2020 2020 4d75 6c74 6970            Multip
│ │ │ │ -0001e8c0: 6c65 2073 6572 7665 7273 2e20 2020 2028  le servers.    (
│ │ │ │ -0001e8d0: 6c69 6e65 2020 2036 290a 2a20 5265 706f  line   6).* Repo
│ │ │ │ -0001e8e0: 7274 696e 6720 4275 6773 3a20 2020 2020  rting Bugs:     
│ │ │ │ +0001e880: 2020 2020 2020 2028 6c69 6e65 2020 2036         (line   6
│ │ │ │ +0001e890: 290a 2a20 7265 6d6f 7465 2064 6174 6162  ).* remote datab
│ │ │ │ +0001e8a0: 6173 6573 3a20 2020 2020 2020 2020 2020  ases:           
│ │ │ │ +0001e8b0: 2020 2020 2020 2020 2020 204d 756c 7469             Multi
│ │ │ │ +0001e8c0: 706c 6520 7365 7276 6572 732e 2020 2020  ple servers.    
│ │ │ │ +0001e8d0: 286c 696e 6520 2020 3629 0a2a 2052 6570  (line   6).* Rep
│ │ │ │ +0001e8e0: 6f72 7469 6e67 2042 7567 733a 2020 2020  orting Bugs:    
│ │ │ │  0001e8f0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001e900: 2020 2042 7567 2052 6570 6f72 7473 2e20     Bug Reports. 
│ │ │ │ -0001e910: 2020 2020 2020 2020 286c 696e 6520 2020          (line   
│ │ │ │ -0001e920: 3629 0a2a 2072 7368 2061 6e64 2072 6c6f  6).* rsh and rlo
│ │ │ │ -0001e930: 6769 6e3a 2020 2020 2020 2020 2020 2020  gin:            
│ │ │ │ -0001e940: 2020 2020 2020 2020 2020 2020 4b65 7262              Kerb
│ │ │ │ -0001e950: 6572 697a 6564 2072 7368 2061 6e64 2072  erized rsh and r
│ │ │ │ -0001e960: 6c6f 6769 6e2e 0a20 2020 2020 2020 2020  login..         
│ │ │ │ +0001e900: 2020 2020 4275 6720 5265 706f 7274 732e      Bug Reports.
│ │ │ │ +0001e910: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ +0001e920: 2036 290a 2a20 7273 6820 616e 6420 726c   6).* rsh and rl
│ │ │ │ +0001e930: 6f67 696e 3a20 2020 2020 2020 2020 2020  ogin:           
│ │ │ │ +0001e940: 2020 2020 2020 2020 2020 2020 204b 6572               Ker
│ │ │ │ +0001e950: 6265 7269 7a65 6420 7273 6820 616e 6420  berized rsh and 
│ │ │ │ +0001e960: 726c 6f67 696e 2e0a 2020 2020 2020 2020  rlogin..        
│ │ │ │  0001e970: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001e980: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001e990: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001e9a0: 2020 2020 2028 6c69 6e65 2020 2036 290a       (line   6).
│ │ │ │ -0001e9b0: 2a20 7273 796e 633a 2020 2020 2020 2020  * rsync:        
│ │ │ │ +0001e9a0: 2020 2020 2020 286c 696e 6520 2020 3629        (line   6)
│ │ │ │ +0001e9b0: 0a2a 2072 7379 6e63 3a20 2020 2020 2020  .* rsync:       
│ │ │ │  0001e9c0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001e9d0: 2020 2020 2020 2020 204d 756c 7469 706c           Multipl
│ │ │ │ -0001e9e0: 6520 7365 7276 6572 732e 2020 2020 286c  e servers.    (l
│ │ │ │ -0001e9f0: 696e 6520 2020 3629 0a2a 2053 616c 7a2c  ine   6).* Salz,
│ │ │ │ -0001ea00: 2052 6963 683a 2020 2020 2020 2020 2020   Rich:          
│ │ │ │ +0001e9d0: 2020 2020 2020 2020 2020 4d75 6c74 6970            Multip
│ │ │ │ +0001e9e0: 6c65 2073 6572 7665 7273 2e20 2020 2028  le servers.    (
│ │ │ │ +0001e9f0: 6c69 6e65 2020 2036 290a 2a20 5361 6c7a  line   6).* Salz
│ │ │ │ +0001ea00: 2c20 5269 6368 3a20 2020 2020 2020 2020  , Rich:         
│ │ │ │  0001ea10: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001ea20: 2020 4175 7468 6f72 7320 6f66 2070 6172    Authors of par
│ │ │ │ -0001ea30: 7365 5f64 6174 6574 696d 652e 0a20 2020  se_datetime..   
│ │ │ │ +0001ea20: 2020 2041 7574 686f 7273 206f 6620 7061     Authors of pa
│ │ │ │ +0001ea30: 7273 655f 6461 7465 7469 6d65 2e0a 2020  rse_datetime..  
│ │ │ │  0001ea40: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001ea50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001ea60: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001ea70: 2020 2020 2020 2020 2020 2028 6c69 6e65             (line
│ │ │ │ -0001ea80: 2020 2036 290a 2a20 5365 616c 3a20 2020     6).* Seal:   
│ │ │ │ +0001ea70: 2020 2020 2020 2020 2020 2020 286c 696e              (lin
│ │ │ │ +0001ea80: 6520 2020 3629 0a2a 2053 6561 6c3a 2020  e   6).* Seal:  
│ │ │ │  0001ea90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001eaa0: 2020 2020 2020 2020 2020 2020 2020 2047                 G
│ │ │ │ -0001eab0: 6c6f 7373 6172 7920 6f66 2074 6572 6d73  lossary of terms
│ │ │ │ -0001eac0: 2e20 2020 286c 696e 6520 2039 3329 0a2a  .   (line  93).*
│ │ │ │ -0001ead0: 2073 6563 6f6e 6461 7279 2073 6572 7665   secondary serve
│ │ │ │ -0001eae0: 723a 2020 2020 2020 2020 2020 2020 2020  r:              
│ │ │ │ -0001eaf0: 2020 2020 2020 2020 4d75 6c74 6970 6c65          Multiple
│ │ │ │ -0001eb00: 2073 6572 7665 7273 2e20 2020 2028 6c69   servers.    (li
│ │ │ │ -0001eb10: 6e65 2020 3133 290a 2a20 5365 6372 6574  ne  13).* Secret
│ │ │ │ -0001eb20: 206b 6579 3a20 2020 2020 2020 2020 2020   key:           
│ │ │ │ +0001eaa0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0001eab0: 476c 6f73 7361 7279 206f 6620 7465 726d  Glossary of term
│ │ │ │ +0001eac0: 732e 2020 2028 6c69 6e65 2020 3933 290a  s.   (line  93).
│ │ │ │ +0001ead0: 2a20 7365 636f 6e64 6172 7920 7365 7276  * secondary serv
│ │ │ │ +0001eae0: 6572 3a20 2020 2020 2020 2020 2020 2020  er:             
│ │ │ │ +0001eaf0: 2020 2020 2020 2020 204d 756c 7469 706c           Multipl
│ │ │ │ +0001eb00: 6520 7365 7276 6572 732e 2020 2020 286c  e servers.    (l
│ │ │ │ +0001eb10: 696e 6520 2031 3329 0a2a 2053 6563 7265  ine  13).* Secre
│ │ │ │ +0001eb20: 7420 6b65 793a 2020 2020 2020 2020 2020  t key:          
│ │ │ │  0001eb30: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001eb40: 2047 6c6f 7373 6172 7920 6f66 2074 6572   Glossary of ter
│ │ │ │ -0001eb50: 6d73 2e20 2020 286c 696e 6520 2039 3829  ms.   (line  98)
│ │ │ │ -0001eb60: 0a2a 2053 6572 7665 723a 2020 2020 2020  .* Server:      
│ │ │ │ +0001eb40: 2020 476c 6f73 7361 7279 206f 6620 7465    Glossary of te
│ │ │ │ +0001eb50: 726d 732e 2020 2028 6c69 6e65 2020 3938  rms.   (line  98
│ │ │ │ +0001eb60: 290a 2a20 5365 7276 6572 3a20 2020 2020  ).* Server:     
│ │ │ │  0001eb70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001eb80: 2020 2020 2020 2020 2020 476c 6f73 7361            Glossa
│ │ │ │ -0001eb90: 7279 206f 6620 7465 726d 732e 2020 2028  ry of terms.   (
│ │ │ │ -0001eba0: 6c69 6e65 2031 3034 290a 2a20 7365 7276  line 104).* serv
│ │ │ │ -0001ebb0: 6572 2061 7574 6865 6e74 6963 6174 696f  er authenticatio
│ │ │ │ -0001ebc0: 6e3a 2020 2020 2020 2020 2020 2020 2020  n:              
│ │ │ │ -0001ebd0: 2020 204b 6572 6265 726f 7320 7669 6120     Kerberos via 
│ │ │ │ -0001ebe0: 544c 532e 2020 2020 286c 696e 6520 2039  TLS.    (line  9
│ │ │ │ -0001ebf0: 3729 0a2a 2053 6572 7669 6365 3a20 2020  7).* Service:   
│ │ │ │ +0001eb80: 2020 2020 2020 2020 2020 2047 6c6f 7373             Gloss
│ │ │ │ +0001eb90: 6172 7920 6f66 2074 6572 6d73 2e20 2020  ary of terms.   
│ │ │ │ +0001eba0: 286c 696e 6520 3130 3429 0a2a 2073 6572  (line 104).* ser
│ │ │ │ +0001ebb0: 7665 7220 6175 7468 656e 7469 6361 7469  ver authenticati
│ │ │ │ +0001ebc0: 6f6e 3a20 2020 2020 2020 2020 2020 2020  on:             
│ │ │ │ +0001ebd0: 2020 2020 4b65 7262 6572 6f73 2076 6961      Kerberos via
│ │ │ │ +0001ebe0: 2054 4c53 2e20 2020 2028 6c69 6e65 2020   TLS.    (line  
│ │ │ │ +0001ebf0: 3937 290a 2a20 5365 7276 6963 653a 2020  97).* Service:  
│ │ │ │  0001ec00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001ec10: 2020 2020 2020 2020 2020 2020 476c 6f73              Glos
│ │ │ │ -0001ec20: 7361 7279 206f 6620 7465 726d 732e 2020  sary of terms.  
│ │ │ │ -0001ec30: 2028 6c69 6e65 2031 3039 290a 2a20 5365   (line 109).* Se
│ │ │ │ -0001ec40: 7373 696f 6e20 6b65 793a 2020 2020 2020  ssion key:      
│ │ │ │ +0001ec10: 2020 2020 2020 2020 2020 2020 2047 6c6f               Glo
│ │ │ │ +0001ec20: 7373 6172 7920 6f66 2074 6572 6d73 2e20  ssary of terms. 
│ │ │ │ +0001ec30: 2020 286c 696e 6520 3130 3929 0a2a 2053    (line 109).* S
│ │ │ │ +0001ec40: 6573 7369 6f6e 206b 6579 3a20 2020 2020  ession key:     
│ │ │ │  0001ec50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001ec60: 2020 2020 2047 6c6f 7373 6172 7920 6f66       Glossary of
│ │ │ │ -0001ec70: 2074 6572 6d73 2e20 2020 286c 696e 6520   terms.   (line 
│ │ │ │ -0001ec80: 3131 3329 0a2a 2053 6869 7361 2041 5049  113).* Shisa API
│ │ │ │ -0001ec90: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ -0001eca0: 2020 2020 2020 2020 2020 2020 2020 4b65                Ke
│ │ │ │ -0001ecb0: 7262 6572 6f73 2044 6174 6162 6173 6520  rberos Database 
│ │ │ │ -0001ecc0: 4675 6e63 7469 6f6e 732e 0a20 2020 2020  Functions..     
│ │ │ │ +0001ec60: 2020 2020 2020 476c 6f73 7361 7279 206f        Glossary o
│ │ │ │ +0001ec70: 6620 7465 726d 732e 2020 2028 6c69 6e65  f terms.   (line
│ │ │ │ +0001ec80: 2031 3133 290a 2a20 5368 6973 6120 4150   113).* Shisa AP
│ │ │ │ +0001ec90: 493a 2020 2020 2020 2020 2020 2020 2020  I:              
│ │ │ │ +0001eca0: 2020 2020 2020 2020 2020 2020 2020 204b                 K
│ │ │ │ +0001ecb0: 6572 6265 726f 7320 4461 7461 6261 7365  erberos Database
│ │ │ │ +0001ecc0: 2046 756e 6374 696f 6e73 2e0a 2020 2020   Functions..    
│ │ │ │  0001ecd0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001ece0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001ecf0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001ed00: 2020 2020 2020 2020 2028 6c69 6e65 2020           (line  
│ │ │ │ -0001ed10: 2036 290a 2a20 536f 6c61 7269 733a 2020   6).* Solaris:  
│ │ │ │ +0001ed00: 2020 2020 2020 2020 2020 286c 696e 6520            (line 
│ │ │ │ +0001ed10: 2020 3629 0a2a 2053 6f6c 6172 6973 3a20    6).* Solaris: 
│ │ │ │  0001ed20: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001ed30: 2020 2020 2020 2020 2020 2020 2053 7570               Sup
│ │ │ │ -0001ed40: 706f 7274 6564 2050 6c61 7466 6f72 6d73  ported Platforms
│ │ │ │ -0001ed50: 2e20 286c 696e 6520 2037 3929 0a2a 2073  . (line  79).* s
│ │ │ │ -0001ed60: 7065 6369 6679 696e 6720 7573 6572 2064  pecifying user d
│ │ │ │ -0001ed70: 6174 6162 6173 653a 2020 2020 2020 2020  atabase:        
│ │ │ │ -0001ed80: 2020 2020 2020 5368 6973 6120 436f 6e66        Shisa Conf
│ │ │ │ -0001ed90: 6967 7572 6174 696f 6e2e 2028 6c69 6e65  iguration. (line
│ │ │ │ -0001eda0: 2020 2036 290a 2a20 5351 4c3a 2020 2020     6).* SQL:    
│ │ │ │ +0001ed30: 2020 2020 2020 2020 2020 2020 2020 5375                Su
│ │ │ │ +0001ed40: 7070 6f72 7465 6420 506c 6174 666f 726d  pported Platform
│ │ │ │ +0001ed50: 732e 2028 6c69 6e65 2020 3739 290a 2a20  s. (line  79).* 
│ │ │ │ +0001ed60: 7370 6563 6966 7969 6e67 2075 7365 7220  specifying user 
│ │ │ │ +0001ed70: 6461 7461 6261 7365 3a20 2020 2020 2020  database:       
│ │ │ │ +0001ed80: 2020 2020 2020 2053 6869 7361 2043 6f6e         Shisa Con
│ │ │ │ +0001ed90: 6669 6775 7261 7469 6f6e 2e20 286c 696e  figuration. (lin
│ │ │ │ +0001eda0: 6520 2020 3629 0a2a 2053 514c 3a20 2020  e   6).* SQL:   
│ │ │ │  0001edb0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001edc0: 2020 2020 2020 2020 2020 2020 2020 204d                 M
│ │ │ │ -0001edd0: 756c 7469 706c 6520 7365 7276 6572 732e  ultiple servers.
│ │ │ │ -0001ede0: 2020 2020 286c 696e 6520 2020 3629 0a2a      (line   6).*
│ │ │ │ -0001edf0: 2053 5441 5254 544c 533a 2020 2020 2020   STARTTLS:      
│ │ │ │ +0001edc0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0001edd0: 4d75 6c74 6970 6c65 2073 6572 7665 7273  Multiple servers
│ │ │ │ +0001ede0: 2e20 2020 2028 6c69 6e65 2020 2036 290a  .    (line   6).
│ │ │ │ +0001edf0: 2a20 5354 4152 5454 4c53 3a20 2020 2020  * STARTTLS:     
│ │ │ │  0001ee00: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001ee10: 2020 2020 2020 2020 4b65 7262 6572 6f73          Kerberos
│ │ │ │ -0001ee20: 2076 6961 2054 4c53 2e20 2020 2028 6c69   via TLS.    (li
│ │ │ │ -0001ee30: 6e65 2020 2036 290a 2a20 5375 622d 7365  ne   6).* Sub-se
│ │ │ │ -0001ee40: 7373 696f 6e20 6b65 793a 2020 2020 2020  ssion key:      
│ │ │ │ +0001ee10: 2020 2020 2020 2020 204b 6572 6265 726f           Kerbero
│ │ │ │ +0001ee20: 7320 7669 6120 544c 532e 2020 2020 286c  s via TLS.    (l
│ │ │ │ +0001ee30: 696e 6520 2020 3629 0a2a 2053 7562 2d73  ine   6).* Sub-s
│ │ │ │ +0001ee40: 6573 7369 6f6e 206b 6579 3a20 2020 2020  ession key:     
│ │ │ │  0001ee50: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001ee60: 2047 6c6f 7373 6172 7920 6f66 2074 6572   Glossary of ter
│ │ │ │ -0001ee70: 6d73 2e20 2020 286c 696e 6520 3131 3929  ms.   (line 119)
│ │ │ │ -0001ee80: 0a2a 2053 7553 453a 2020 2020 2020 2020  .* SuSE:        
│ │ │ │ +0001ee60: 2020 476c 6f73 7361 7279 206f 6620 7465    Glossary of te
│ │ │ │ +0001ee70: 726d 732e 2020 2028 6c69 6e65 2031 3139  rms.   (line 119
│ │ │ │ +0001ee80: 290a 2a20 5375 5345 3a20 2020 2020 2020  ).* SuSE:       
│ │ │ │  0001ee90: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001eea0: 2020 2020 2020 2020 2020 5375 7070 6f72            Suppor
│ │ │ │ -0001eeb0: 7465 6420 506c 6174 666f 726d 732e 2028  ted Platforms. (
│ │ │ │ -0001eec0: 6c69 6e65 2020 3331 290a 2a20 5375 5345  line  31).* SuSE
│ │ │ │ -0001eed0: 204c 696e 7578 3a20 2020 2020 2020 2020   Linux:         
│ │ │ │ +0001eea0: 2020 2020 2020 2020 2020 2053 7570 706f             Suppo
│ │ │ │ +0001eeb0: 7274 6564 2050 6c61 7466 6f72 6d73 2e20  rted Platforms. 
│ │ │ │ +0001eec0: 286c 696e 6520 2033 3129 0a2a 2053 7553  (line  31).* SuS
│ │ │ │ +0001eed0: 4520 4c69 6e75 783a 2020 2020 2020 2020  E Linux:        
│ │ │ │  0001eee0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001eef0: 2020 2053 7570 706f 7274 6564 2050 6c61     Supported Pla
│ │ │ │ -0001ef00: 7466 6f72 6d73 2e20 286c 696e 6520 2033  tforms. (line  3
│ │ │ │ -0001ef10: 3629 0a2a 2053 7553 4520 4c69 6e75 7820  6).* SuSE Linux 
│ │ │ │ -0001ef20: 3c31 3e3a 2020 2020 2020 2020 2020 2020  <1>:            
│ │ │ │ -0001ef30: 2020 2020 2020 2020 2020 2020 5375 7070              Supp
│ │ │ │ -0001ef40: 6f72 7465 6420 506c 6174 666f 726d 732e  orted Platforms.
│ │ │ │ -0001ef50: 2028 6c69 6e65 2020 3430 290a 2a20 5465   (line  40).* Te
│ │ │ │ -0001ef60: 6c6e 6574 2065 6e63 7279 7074 696f 6e3a  lnet encryption:
│ │ │ │ -0001ef70: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001ef80: 2020 2020 2054 656c 6e65 7420 656e 6372       Telnet encr
│ │ │ │ -0001ef90: 7970 7469 6f6e 2077 6974 6820 4145 532d  yption with AES-
│ │ │ │ -0001efa0: 4343 4d2e 0a20 2020 2020 2020 2020 2020  CCM..           
│ │ │ │ +0001eef0: 2020 2020 5375 7070 6f72 7465 6420 506c      Supported Pl
│ │ │ │ +0001ef00: 6174 666f 726d 732e 2028 6c69 6e65 2020  atforms. (line  
│ │ │ │ +0001ef10: 3336 290a 2a20 5375 5345 204c 696e 7578  36).* SuSE Linux
│ │ │ │ +0001ef20: 203c 313e 3a20 2020 2020 2020 2020 2020   <1>:           
│ │ │ │ +0001ef30: 2020 2020 2020 2020 2020 2020 2053 7570               Sup
│ │ │ │ +0001ef40: 706f 7274 6564 2050 6c61 7466 6f72 6d73  ported Platforms
│ │ │ │ +0001ef50: 2e20 286c 696e 6520 2034 3029 0a2a 2054  . (line  40).* T
│ │ │ │ +0001ef60: 656c 6e65 7420 656e 6372 7970 7469 6f6e  elnet encryption
│ │ │ │ +0001ef70: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ +0001ef80: 2020 2020 2020 5465 6c6e 6574 2065 6e63        Telnet enc
│ │ │ │ +0001ef90: 7279 7074 696f 6e20 7769 7468 2041 4553  ryption with AES
│ │ │ │ +0001efa0: 2d43 434d 2e0a 2020 2020 2020 2020 2020  -CCM..          
│ │ │ │  0001efb0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001efc0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │  0001efd0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001efe0: 2020 2028 6c69 6e65 2020 2036 290a 2a20     (line   6).* 
│ │ │ │ -0001eff0: 5469 636b 6574 3a20 2020 2020 2020 2020  Ticket:         
│ │ │ │ +0001efe0: 2020 2020 286c 696e 6520 2020 3629 0a2a      (line   6).*
│ │ │ │ +0001eff0: 2054 6963 6b65 743a 2020 2020 2020 2020   Ticket:        
│ │ │ │  0001f000: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001f010: 2020 2020 2020 2047 6c6f 7373 6172 7920         Glossary 
│ │ │ │ -0001f020: 6f66 2074 6572 6d73 2e20 2020 286c 696e  of terms.   (lin
│ │ │ │ -0001f030: 6520 3132 3529 0a2a 2074 696d 6520 6f66  e 125).* time of
│ │ │ │ -0001f040: 2064 6179 2069 7465 6d3a 2020 2020 2020   day item:      
│ │ │ │ +0001f010: 2020 2020 2020 2020 476c 6f73 7361 7279          Glossary
│ │ │ │ +0001f020: 206f 6620 7465 726d 732e 2020 2028 6c69   of terms.   (li
│ │ │ │ +0001f030: 6e65 2031 3235 290a 2a20 7469 6d65 206f  ne 125).* time o
│ │ │ │ +0001f040: 6620 6461 7920 6974 656d 3a20 2020 2020  f day item:     
│ │ │ │  0001f050: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001f060: 5469 6d65 206f 6620 6461 7920 6974 656d  Time of day item
│ │ │ │ -0001f070: 732e 2020 2028 6c69 6e65 2020 2036 290a  s.   (line   6).
│ │ │ │ -0001f080: 2a20 7469 6d65 207a 6f6e 6520 636f 7272  * time zone corr
│ │ │ │ -0001f090: 6563 7469 6f6e 3a20 2020 2020 2020 2020  ection:         
│ │ │ │ -0001f0a0: 2020 2020 2020 2020 2054 696d 6520 6f66           Time of
│ │ │ │ -0001f0b0: 2064 6179 2069 7465 6d73 2e20 2020 286c   day items.   (l
│ │ │ │ -0001f0c0: 696e 6520 2032 3929 0a2a 2074 696d 6520  ine  29).* time 
│ │ │ │ -0001f0d0: 7a6f 6e65 2069 7465 6d3a 2020 2020 2020  zone item:      
│ │ │ │ +0001f060: 2054 696d 6520 6f66 2064 6179 2069 7465   Time of day ite
│ │ │ │ +0001f070: 6d73 2e20 2020 286c 696e 6520 2020 3629  ms.   (line   6)
│ │ │ │ +0001f080: 0a2a 2074 696d 6520 7a6f 6e65 2063 6f72  .* time zone cor
│ │ │ │ +0001f090: 7265 6374 696f 6e3a 2020 2020 2020 2020  rection:        
│ │ │ │ +0001f0a0: 2020 2020 2020 2020 2020 5469 6d65 206f            Time o
│ │ │ │ +0001f0b0: 6620 6461 7920 6974 656d 732e 2020 2028  f day items.   (
│ │ │ │ +0001f0c0: 6c69 6e65 2020 3239 290a 2a20 7469 6d65  line  29).* time
│ │ │ │ +0001f0d0: 207a 6f6e 6520 6974 656d 3a20 2020 2020   zone item:     
│ │ │ │  0001f0e0: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001f0f0: 2020 4765 6e65 7261 6c20 6461 7465 2073    General date s
│ │ │ │ -0001f100: 796e 7461 782e 2028 6c69 6e65 2020 3430  yntax. (line  40
│ │ │ │ -0001f110: 290a 2a20 7469 6d65 207a 6f6e 6520 6974  ).* time zone it
│ │ │ │ -0001f120: 656d 203c 313e 3a20 2020 2020 2020 2020  em <1>:         
│ │ │ │ -0001f130: 2020 2020 2020 2020 2020 2054 696d 6520             Time 
│ │ │ │ -0001f140: 7a6f 6e65 2069 7465 6d73 2e20 2020 2020  zone items.     
│ │ │ │ -0001f150: 286c 696e 6520 2020 3629 0a2a 2054 4c53  (line   6).* TLS
│ │ │ │ -0001f160: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ +0001f0f0: 2020 2047 656e 6572 616c 2064 6174 6520     General date 
│ │ │ │ +0001f100: 7379 6e74 6178 2e20 286c 696e 6520 2034  syntax. (line  4
│ │ │ │ +0001f110: 3029 0a2a 2074 696d 6520 7a6f 6e65 2069  0).* time zone i
│ │ │ │ +0001f120: 7465 6d20 3c31 3e3a 2020 2020 2020 2020  tem <1>:        
│ │ │ │ +0001f130: 2020 2020 2020 2020 2020 2020 5469 6d65              Time
│ │ │ │ +0001f140: 207a 6f6e 6520 6974 656d 732e 2020 2020   zone items.    
│ │ │ │ +0001f150: 2028 6c69 6e65 2020 2036 290a 2a20 544c   (line   6).* TL
│ │ │ │ +0001f160: 533a 2020 2020 2020 2020 2020 2020 2020  S:              
│ │ │ │  0001f170: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001f180: 2020 2020 4b65 7262 6572 6f73 2076 6961      Kerberos via
│ │ │ │ -0001f190: 2054 4c53 2e20 2020 2028 6c69 6e65 2020   TLS.    (line  
│ │ │ │ -0001f1a0: 2036 290a 2a20 746c 7320 7265 7375 6d65   6).* tls resume
│ │ │ │ -0001f1b0: 3a20 2020 2020 2020 2020 2020 2020 2020  :               
│ │ │ │ -0001f1c0: 2020 2020 2020 2020 2020 2020 204b 6572               Ker
│ │ │ │ -0001f1d0: 6265 726f 7320 7669 6120 544c 532e 2020  beros via TLS.  
│ │ │ │ -0001f1e0: 2020 286c 696e 6520 2031 3829 0a2a 2054    (line  18).* T
│ │ │ │ -0001f1f0: 7275 3634 3a20 2020 2020 2020 2020 2020  ru64:           
│ │ │ │ +0001f180: 2020 2020 204b 6572 6265 726f 7320 7669       Kerberos vi
│ │ │ │ +0001f190: 6120 544c 532e 2020 2020 286c 696e 6520  a TLS.    (line 
│ │ │ │ +0001f1a0: 2020 3629 0a2a 2074 6c73 2072 6573 756d    6).* tls resum
│ │ │ │ +0001f1b0: 653a 2020 2020 2020 2020 2020 2020 2020  e:              
│ │ │ │ +0001f1c0: 2020 2020 2020 2020 2020 2020 2020 4b65                Ke
│ │ │ │ +0001f1d0: 7262 6572 6f73 2076 6961 2054 4c53 2e20  rberos via TLS. 
│ │ │ │ +0001f1e0: 2020 2028 6c69 6e65 2020 3138 290a 2a20     (line  18).* 
│ │ │ │ +0001f1f0: 5472 7536 343a 2020 2020 2020 2020 2020  Tru64:          
│ │ │ │  0001f200: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001f210: 2020 2020 2020 5375 7070 6f72 7465 6420        Supported 
│ │ │ │ -0001f220: 506c 6174 666f 726d 732e 2028 6c69 6e65  Platforms. (line
│ │ │ │ -0001f230: 2020 3236 290a 2a20 7543 6c69 6263 3a20    26).* uClibc: 
│ │ │ │ +0001f210: 2020 2020 2020 2053 7570 706f 7274 6564         Supported
│ │ │ │ +0001f220: 2050 6c61 7466 6f72 6d73 2e20 286c 696e   Platforms. (lin
│ │ │ │ +0001f230: 6520 2032 3629 0a2a 2075 436c 6962 633a  e  26).* uClibc:
│ │ │ │  0001f240: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001f250: 2020 2020 2020 2020 2020 2020 2020 2053                 S
│ │ │ │ -0001f260: 7570 706f 7274 6564 2050 6c61 7466 6f72  upported Platfor
│ │ │ │ -0001f270: 6d73 2e20 286c 696e 6520 3130 3329 0a2a  ms. (line 103).*
│ │ │ │ -0001f280: 2075 436c 696e 7578 3a20 2020 2020 2020   uClinux:       
│ │ │ │ +0001f250: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ +0001f260: 5375 7070 6f72 7465 6420 506c 6174 666f  Supported Platfo
│ │ │ │ +0001f270: 726d 732e 2028 6c69 6e65 2031 3033 290a  rms. (line 103).
│ │ │ │ +0001f280: 2a20 7543 6c69 6e75 783a 2020 2020 2020  * uClinux:      
│ │ │ │  0001f290: 2020 2020 2020 2020 2020 2020 2020 2020                  
│ │ │ │ -0001f2a0: 2020 2020 2020 2020 5375 7070 6f72 7465          Supporte
│ │ │ │ -0001f2b0: 6420 506c 6174 666f 726d 732e 2028 6c69  d Platforms. (li
│ │ │ │ -0001f2c0: 6e65 2031 3033 290a 2a20 7573 6572 2064  ne 103).* user d
│ │ │ │ -0001f2d0: 6174 6162 6173 6520 6465 6669 6e69 7469  atabase definiti
│ │ │ │ -0001f2e0: 6f6e 3a20 2020 2020 2020 2020 2020 2020  on:             
│ │ │ │ -0001f2f0: 2053 6869 7361 2043 6f6e 6669 6775 7261   Shisa Configura
│ │ │ │ -0001f300: 7469 6f6e 2e20 286c 696e 6520 2020 3629  tion. (line   6)
│ │ │ │ -0001f310: 0a2a 2058 2e35 3039 2061 7574 6865 6e74  .* X.509 authent
│ │ │ │ -0001f320: 6963 6174 696f 6e3a 2020 2020 2020 2020  ication:        
│ │ │ │ -0001f330: 2020 2020 2020 2020 2020 4b65 7262 6572            Kerber
│ │ │ │ -0001f340: 6f73 2076 6961 2054 4c53 2e20 2020 2028  os via TLS.    (
│ │ │ │ -0001f350: 6c69 6e65 2020 3937 290a 0a              line  97)..
│ │ │ │ +0001f2a0: 2020 2020 2020 2020 2053 7570 706f 7274           Support
│ │ │ │ +0001f2b0: 6564 2050 6c61 7466 6f72 6d73 2e20 286c  ed Platforms. (l
│ │ │ │ +0001f2c0: 696e 6520 3130 3329 0a2a 2075 7365 7220  ine 103).* user 
│ │ │ │ +0001f2d0: 6461 7461 6261 7365 2064 6566 696e 6974  database definit
│ │ │ │ +0001f2e0: 696f 6e3a 2020 2020 2020 2020 2020 2020  ion:            
│ │ │ │ +0001f2f0: 2020 5368 6973 6120 436f 6e66 6967 7572    Shisa Configur
│ │ │ │ +0001f300: 6174 696f 6e2e 2028 6c69 6e65 2020 2036  ation. (line   6
│ │ │ │ +0001f310: 290a 2a20 582e 3530 3920 6175 7468 656e  ).* X.509 authen
│ │ │ │ +0001f320: 7469 6361 7469 6f6e 3a20 2020 2020 2020  tication:       
│ │ │ │ +0001f330: 2020 2020 2020 2020 2020 204b 6572 6265             Kerbe
│ │ │ │ +0001f340: 726f 7320 7669 6120 544c 532e 2020 2020  ros via TLS.    
│ │ │ │ +0001f350: 286c 696e 6520 2039 3729 0a0a            (line  97)..
│ │ ├── ./usr/share/info/shishi.info.gz
│ │ │ ├── shishi.info
│ │ │ │ @@ -1,1714 +1,1714 @@
│ │ │ │  00000000: 5468 6973 2069 7320 7368 6973 6869 2e69  This is shishi.i
│ │ │ │  00000010: 6e66 6f2c 2070 726f 6475 6365 6420 6279  nfo, produced by
│ │ │ │  00000020: 206d 616b 6569 6e66 6f20 7665 7273 696f   makeinfo versio
│ │ │ │  00000030: 6e20 372e 3220 6672 6f6d 2073 6869 7368  n 7.2 from shish
│ │ │ │  00000040: 692e 7465 7869 2e0a 0a54 6869 7320 6d61  i.texi...This ma
│ │ │ │  00000050: 6e75 616c 2069 7320 6c61 7374 2075 7064  nual is last upd
│ │ │ │ -00000060: 6174 6564 2038 204d 6172 6368 2032 3032  ated 8 March 202
│ │ │ │ -00000070: 3620 666f 7220 7665 7273 696f 6e20 312e  6 for version 1.
│ │ │ │ -00000080: 302e 3320 6f66 2053 6869 7368 692e 0a0a  0.3 of Shishi...
│ │ │ │ -00000090: 2020 2043 6f70 7972 6967 6874 20c2 a920     Copyright .. 
│ │ │ │ -000000a0: 3230 3032 2d32 3032 3220 5369 6d6f 6e20  2002-2022 Simon 
│ │ │ │ -000000b0: 4a6f 7365 6673 736f 6e2e 0a0a 2020 2020  Josefsson...    
│ │ │ │ -000000c0: 2050 6572 6d69 7373 696f 6e20 6973 2067   Permission is g
│ │ │ │ -000000d0: 7261 6e74 6564 2074 6f20 636f 7079 2c20  ranted to copy, 
│ │ │ │ -000000e0: 6469 7374 7269 6275 7465 2061 6e64 2f6f  distribute and/o
│ │ │ │ -000000f0: 7220 6d6f 6469 6679 2074 6869 730a 2020  r modify this.  
│ │ │ │ -00000100: 2020 2064 6f63 756d 656e 7420 756e 6465     document unde
│ │ │ │ -00000110: 7220 7468 6520 7465 726d 7320 6f66 2074  r the terms of t
│ │ │ │ -00000120: 6865 2047 4e55 2046 7265 6520 446f 6375  he GNU Free Docu
│ │ │ │ -00000130: 6d65 6e74 6174 696f 6e20 4c69 6365 6e73  mentation Licens
│ │ │ │ -00000140: 652c 0a20 2020 2020 5665 7273 696f 6e20  e,.     Version 
│ │ │ │ -00000150: 312e 3320 6f72 2061 6e79 206c 6174 6572  1.3 or any later
│ │ │ │ -00000160: 2076 6572 7369 6f6e 2070 7562 6c69 7368   version publish
│ │ │ │ -00000170: 6564 2062 7920 7468 6520 4672 6565 2053  ed by the Free S
│ │ │ │ -00000180: 6f66 7477 6172 650a 2020 2020 2046 6f75  oftware.     Fou
│ │ │ │ -00000190: 6e64 6174 696f 6e3b 2077 6974 6820 6e6f  ndation; with no
│ │ │ │ -000001a0: 2049 6e76 6172 6961 6e74 2053 6563 7469   Invariant Secti
│ │ │ │ -000001b0: 6f6e 732c 206e 6f20 4672 6f6e 742d 436f  ons, no Front-Co
│ │ │ │ -000001c0: 7665 7220 5465 7874 732c 2061 6e64 0a20  ver Texts, and. 
│ │ │ │ -000001d0: 2020 2020 6e6f 2042 6163 6b2d 436f 7665      no Back-Cove
│ │ │ │ -000001e0: 7220 5465 7874 732e 2020 4120 636f 7079  r Texts.  A copy
│ │ │ │ -000001f0: 206f 6620 7468 6520 6c69 6365 6e73 6520   of the license 
│ │ │ │ -00000200: 6973 2069 6e63 6c75 6465 6420 696e 2074  is included in t
│ │ │ │ -00000210: 6865 0a20 2020 2020 7365 6374 696f 6e20  he.     section 
│ │ │ │ -00000220: 656e 7469 746c 6564 2022 474e 5520 4672  entitled "GNU Fr
│ │ │ │ -00000230: 6565 2044 6f63 756d 656e 7461 7469 6f6e  ee Documentation
│ │ │ │ -00000240: 204c 6963 656e 7365 222e 0a49 4e46 4f2d   License"..INFO-
│ │ │ │ -00000250: 4449 522d 5345 4354 494f 4e20 474e 5520  DIR-SECTION GNU 
│ │ │ │ -00000260: 7574 696c 6974 6965 730a 5354 4152 542d  utilities.START-
│ │ │ │ -00000270: 494e 464f 2d44 4952 2d45 4e54 5259 0a2a  INFO-DIR-ENTRY.*
│ │ │ │ -00000280: 2073 6869 7368 693a 2028 7368 6973 6869   shishi: (shishi
│ │ │ │ -00000290: 292e 0909 4120 4b65 7262 6572 6f73 2035  )...A Kerberos 5
│ │ │ │ -000002a0: 2069 6d70 6c65 6d65 6e74 6174 696f 6e0a   implementation.
│ │ │ │ -000002b0: 454e 442d 494e 464f 2d44 4952 2d45 4e54  END-INFO-DIR-ENT
│ │ │ │ -000002c0: 5259 0a0a 494e 464f 2d44 4952 2d53 4543  RY..INFO-DIR-SEC
│ │ │ │ -000002d0: 5449 4f4e 2047 4e55 204c 6962 7261 7269  TION GNU Librari
│ │ │ │ -000002e0: 6573 0a53 5441 5254 2d49 4e46 4f2d 4449  es.START-INFO-DI
│ │ │ │ -000002f0: 522d 454e 5452 590a 2a20 6c69 6273 6869  R-ENTRY.* libshi
│ │ │ │ -00000300: 7368 693a 2028 7368 6973 6869 292e 0909  shi: (shishi)...
│ │ │ │ -00000310: 4c69 6272 6172 7920 696d 706c 656d 656e  Library implemen
│ │ │ │ -00000320: 7469 6e67 204b 6572 6265 726f 7320 352e  ting Kerberos 5.
│ │ │ │ -00000330: 0a45 4e44 2d49 4e46 4f2d 4449 522d 454e  .END-INFO-DIR-EN
│ │ │ │ -00000340: 5452 590a 0a1f 0a49 6e64 6972 6563 743a  TRY....Indirect:
│ │ │ │ -00000350: 0a73 6869 7368 692e 696e 666f 2d31 3a20  .shishi.info-1: 
│ │ │ │ -00000360: 3833 370a 7368 6973 6869 2e69 6e66 6f2d  837.shishi.info-
│ │ │ │ -00000370: 323a 2033 3035 3231 380a 7368 6973 6869  2: 305218.shishi
│ │ │ │ -00000380: 2e69 6e66 6f2d 333a 2036 3132 3730 340a  .info-3: 612704.
│ │ │ │ -00000390: 1f0a 5461 6720 5461 626c 653a 0a28 496e  ..Tag Table:.(In
│ │ │ │ -000003a0: 6469 7265 6374 290a 4e6f 6465 3a20 546f  direct).Node: To
│ │ │ │ -000003b0: 707f 3833 370a 4e6f 6465 3a20 496e 7472  p.837.Node: Intr
│ │ │ │ -000003c0: 6f64 7563 7469 6f6e 7f32 3230 330a 4e6f  oduction.2203.No
│ │ │ │ -000003d0: 6465 3a20 4765 7474 696e 6720 5374 6172  de: Getting Star
│ │ │ │ -000003e0: 7465 647f 3339 3631 0a4e 6f64 653a 2046  ted.3961.Node: F
│ │ │ │ -000003f0: 6561 7475 7265 7320 616e 6420 5374 6174  eatures and Stat
│ │ │ │ -00000400: 7573 7f34 3839 310a 4e6f 6465 3a20 4f76  us.4891.Node: Ov
│ │ │ │ -00000410: 6572 7669 6577 7f39 3836 310a 5265 663a  erview.9861.Ref:
│ │ │ │ -00000420: 204f 7665 7276 6965 772d 466f 6f74 6e6f   Overview-Footno
│ │ │ │ -00000430: 7465 2d31 7f31 3531 3337 0a4e 6f64 653a  te-1.15137.Node:
│ │ │ │ -00000440: 2043 7279 7074 6f67 7261 7068 6963 204f   Cryptographic O
│ │ │ │ -00000450: 7665 7276 6965 777f 3135 3333 350a 5265  verview.15335.Re
│ │ │ │ -00000460: 663a 2043 7279 7074 6f67 7261 7068 6963  f: Cryptographic
│ │ │ │ -00000470: 204f 7665 7276 6965 772d 466f 6f74 6e6f   Overview-Footno
│ │ │ │ -00000480: 7465 2d31 7f32 3630 3730 0a52 6566 3a20  te-1.26070.Ref: 
│ │ │ │ -00000490: 4372 7970 746f 6772 6170 6869 6320 4f76  Cryptographic Ov
│ │ │ │ -000004a0: 6572 7669 6577 2d46 6f6f 746e 6f74 652d  erview-Footnote-
│ │ │ │ -000004b0: 327f 3236 3132 390a 4e6f 6465 3a20 5375  2.26129.Node: Su
│ │ │ │ -000004c0: 7070 6f72 7465 6420 506c 6174 666f 726d  pported Platform
│ │ │ │ -000004d0: 737f 3236 3138 370a 4e6f 6465 3a20 4765  s.26187.Node: Ge
│ │ │ │ -000004e0: 7474 696e 6720 6865 6c70 7f32 3933 3131  tting help.29311
│ │ │ │ -000004f0: 0a4e 6f64 653a 2044 6f77 6e6c 6f61 6469  .Node: Downloadi
│ │ │ │ -00000500: 6e67 2061 6e64 2049 6e73 7461 6c6c 696e  ng and Installin
│ │ │ │ -00000510: 677f 3239 3738 320a 4e6f 6465 3a20 4275  g.29782.Node: Bu
│ │ │ │ -00000520: 6720 5265 706f 7274 737f 3331 3731 340a  g Reports.31714.
│ │ │ │ -00000530: 4e6f 6465 3a20 436f 6e74 7269 6275 7469  Node: Contributi
│ │ │ │ -00000540: 6e67 7f33 3331 3137 0a4e 6f64 653a 2055  ng.33117.Node: U
│ │ │ │ -00000550: 7365 7220 4d61 6e75 616c 7f33 3532 3730  ser Manual.35270
│ │ │ │ -00000560: 0a4e 6f64 653a 2041 646d 696e 6973 7472  .Node: Administr
│ │ │ │ -00000570: 6174 696f 6e20 4d61 6e75 616c 7f34 3831  ation Manual.481
│ │ │ │ -00000580: 3136 0a52 6566 3a20 4164 6d69 6e69 7374  16.Ref: Administ
│ │ │ │ -00000590: 7261 7469 6f6e 204d 616e 7561 6c2d 466f  ration Manual-Fo
│ │ │ │ -000005a0: 6f74 6e6f 7465 2d31 7f34 3936 3534 0a4e  otnote-1.49654.N
│ │ │ │ -000005b0: 6f64 653a 2049 6e74 726f 6475 6374 696f  ode: Introductio
│ │ │ │ -000005c0: 6e20 746f 2053 6869 7361 7f34 3937 3333  n to Shisa.49733
│ │ │ │ -000005d0: 0a4e 6f64 653a 2043 6f6e 6669 6775 7269  .Node: Configuri
│ │ │ │ -000005e0: 6e67 2053 6869 7361 7f35 3232 3632 0a4e  ng Shisa.52262.N
│ │ │ │ -000005f0: 6f64 653a 2055 7369 6e67 2053 6869 7361  ode: Using Shisa
│ │ │ │ -00000600: 7f35 3337 3034 0a4e 6f64 653a 2053 7461  .53704.Node: Sta
│ │ │ │ -00000610: 7274 696e 6720 5368 6973 6869 647f 3634  rting Shishid.64
│ │ │ │ -00000620: 3134 350a 4e6f 6465 3a20 436f 6e66 6967  145.Node: Config
│ │ │ │ -00000630: 7572 696e 6720 444e 5320 666f 7220 4b44  uring DNS for KD
│ │ │ │ -00000640: 437f 3639 3039 360a 4e6f 6465 3a20 4b65  C.69096.Node: Ke
│ │ │ │ -00000650: 7262 6572 6f73 2076 6961 2054 4c53 7f37  rberos via TLS.7
│ │ │ │ -00000660: 3336 3730 0a4e 6f64 653a 204d 756c 7469  3670.Node: Multi
│ │ │ │ -00000670: 706c 6520 7365 7276 6572 737f 3838 3737  ple servers.8877
│ │ │ │ -00000680: 330a 4e6f 6465 3a20 4465 7665 6c6f 7065  3.Node: Develope
│ │ │ │ -00000690: 7220 696e 666f 726d 6174 696f 6e7f 3934  r information.94
│ │ │ │ -000006a0: 3032 380a 4e6f 6465 3a20 5265 6665 7265  028.Node: Refere
│ │ │ │ -000006b0: 6e63 6520 4d61 6e75 616c 7f39 3533 3531  nce Manual.95351
│ │ │ │ -000006c0: 0a4e 6f64 653a 2045 6e76 6972 6f6e 6d65  .Node: Environme
│ │ │ │ -000006d0: 6e74 616c 2041 7373 756d 7074 696f 6e73  ntal Assumptions
│ │ │ │ -000006e0: 7f39 3635 3032 0a4e 6f64 653a 2047 6c6f  .96502.Node: Glo
│ │ │ │ -000006f0: 7373 6172 7920 6f66 2074 6572 6d73 7f39  ssary of terms.9
│ │ │ │ -00000700: 3837 3334 0a4e 6f64 653a 2052 6561 6c6d  8734.Node: Realm
│ │ │ │ -00000710: 2061 6e64 2050 7269 6e63 6970 616c 204e   and Principal N
│ │ │ │ -00000720: 616d 696e 677f 3130 3430 3630 0a52 6566  aming.104060.Ref
│ │ │ │ -00000730: 3a20 6b72 6274 6774 7f31 3132 3439 320a  : krbtgt.112492.
│ │ │ │ -00000740: 4e6f 6465 3a20 5368 6973 6869 2043 6f6e  Node: Shishi Con
│ │ │ │ -00000750: 6669 6775 7261 7469 6f6e 7f31 3137 3939  figuration.11799
│ │ │ │ -00000760: 350a 5265 663a 2072 6561 6c6d 2d6b 6463  5.Ref: realm-kdc
│ │ │ │ -00000770: 7f31 3230 3430 360a 4e6f 6465 3a20 5368  .120406.Node: Sh
│ │ │ │ -00000780: 6973 6120 436f 6e66 6967 7572 6174 696f  isa Configuratio
│ │ │ │ -00000790: 6e7f 3132 3335 3133 0a4e 6f64 653a 2050  n.123513.Node: P
│ │ │ │ -000007a0: 6172 616d 6574 6572 7320 666f 7220 7368  arameters for sh
│ │ │ │ -000007b0: 6973 6869 7f31 3236 3235 300a 4e6f 6465  ishi.126250.Node
│ │ │ │ -000007c0: 3a20 5061 7261 6d65 7465 7273 2066 6f72  : Parameters for
│ │ │ │ -000007d0: 2073 6869 7368 6964 7f31 3332 3138 300a   shishid.132180.
│ │ │ │ -000007e0: 4e6f 6465 3a20 5061 7261 6d65 7465 7273  Node: Parameters
│ │ │ │ -000007f0: 2066 6f72 2073 6869 7361 7f31 3334 3535   for shisa.13455
│ │ │ │ -00000800: 390a 4e6f 6465 3a20 456e 7669 726f 6e6d  9.Node: Environm
│ │ │ │ -00000810: 656e 7420 7661 7269 6162 6c65 737f 3133  ent variables.13
│ │ │ │ -00000820: 3831 3632 0a4e 6f64 653a 2044 6174 6520  8162.Node: Date 
│ │ │ │ -00000830: 696e 7075 7420 666f 726d 6174 737f 3133  input formats.13
│ │ │ │ -00000840: 3933 3531 0a4e 6f64 653a 2047 656e 6572  9351.Node: Gener
│ │ │ │ -00000850: 616c 2064 6174 6520 7379 6e74 6178 7f31  al date syntax.1
│ │ │ │ -00000860: 3431 3735 310a 4e6f 6465 3a20 4361 6c65  41751.Node: Cale
│ │ │ │ -00000870: 6e64 6172 2064 6174 6520 6974 656d 737f  ndar date items.
│ │ │ │ -00000880: 3134 3438 3739 0a4e 6f64 653a 2054 696d  144879.Node: Tim
│ │ │ │ -00000890: 6520 6f66 2064 6179 2069 7465 6d73 7f31  e of day items.1
│ │ │ │ -000008a0: 3436 3836 350a 4e6f 6465 3a20 5469 6d65  46865.Node: Time
│ │ │ │ -000008b0: 207a 6f6e 6520 6974 656d 737f 3134 3931   zone items.1491
│ │ │ │ -000008c0: 3730 0a4e 6f64 653a 2043 6f6d 6269 6e65  70.Node: Combine
│ │ │ │ -000008d0: 6420 6461 7465 2061 6e64 2074 696d 6520  d date and time 
│ │ │ │ -000008e0: 6f66 2064 6179 2069 7465 6d73 7f31 3530  of day items.150
│ │ │ │ -000008f0: 3537 300a 4e6f 6465 3a20 4461 7920 6f66  570.Node: Day of
│ │ │ │ -00000900: 2077 6565 6b20 6974 656d 737f 3135 3134   week items.1514
│ │ │ │ -00000910: 3432 0a4e 6f64 653a 2052 656c 6174 6976  42.Node: Relativ
│ │ │ │ -00000920: 6520 6974 656d 7320 696e 2064 6174 6520  e items in date 
│ │ │ │ -00000930: 7374 7269 6e67 737f 3135 3235 3237 0a4e  strings.152527.N
│ │ │ │ -00000940: 6f64 653a 2050 7572 6520 6e75 6d62 6572  ode: Pure number
│ │ │ │ -00000950: 7320 696e 2064 6174 6520 7374 7269 6e67  s in date string
│ │ │ │ -00000960: 737f 3135 3534 3338 0a4e 6f64 653a 2053  s.155438.Node: S
│ │ │ │ -00000970: 6563 6f6e 6473 2073 696e 6365 2074 6865  econds since the
│ │ │ │ -00000980: 2045 706f 6368 7f31 3536 3432 380a 4e6f   Epoch.156428.No
│ │ │ │ -00000990: 6465 3a20 5370 6563 6966 7969 6e67 2074  de: Specifying t
│ │ │ │ -000009a0: 696d 6520 7a6f 6e65 2072 756c 6573 7f31  ime zone rules.1
│ │ │ │ -000009b0: 3538 3135 350a 4e6f 6465 3a20 4175 7468  58155.Node: Auth
│ │ │ │ -000009c0: 6f72 7320 6f66 2070 6172 7365 5f64 6174  ors of parse_dat
│ │ │ │ -000009d0: 6574 696d 657f 3136 3135 3835 0a52 6566  etime.161585.Ref
│ │ │ │ -000009e0: 3a20 4175 7468 6f72 7320 6f66 2067 6574  : Authors of get
│ │ │ │ -000009f0: 5f64 6174 657f 3136 3137 3737 0a4e 6f64  _date.161777.Nod
│ │ │ │ -00000a00: 653a 2050 726f 6772 616d 6d69 6e67 204d  e: Programming M
│ │ │ │ -00000a10: 616e 7561 6c7f 3136 3237 3736 0a4e 6f64  anual.162776.Nod
│ │ │ │ -00000a20: 653a 2050 7265 7061 7261 7469 6f6e 7f31  e: Preparation.1
│ │ │ │ -00000a30: 3634 3338 390a 4e6f 6465 3a20 4865 6164  64389.Node: Head
│ │ │ │ -00000a40: 6572 7f31 3635 3038 300a 4e6f 6465 3a20  er.165080.Node: 
│ │ │ │ -00000a50: 496e 6974 6961 6c69 7a61 7469 6f6e 7f31  Initialization.1
│ │ │ │ -00000a60: 3635 3731 300a 4e6f 6465 3a20 5665 7273  65710.Node: Vers
│ │ │ │ -00000a70: 696f 6e20 4368 6563 6b7f 3136 3634 3033  ion Check.166403
│ │ │ │ -00000a80: 0a52 6566 3a20 7368 6973 6869 5f63 6865  .Ref: shishi_che
│ │ │ │ -00000a90: 636b 5f76 6572 7369 6f6e 7f31 3636 3933  ck_version.16693
│ │ │ │ -00000aa0: 370a 4e6f 6465 3a20 4275 696c 6469 6e67  7.Node: Building
│ │ │ │ -00000ab0: 2074 6865 2073 6f75 7263 657f 3136 3738   the source.1678
│ │ │ │ -00000ac0: 3434 0a4e 6f64 653a 2041 7574 6f63 6f6e  44.Node: Autocon
│ │ │ │ -00000ad0: 6620 7465 7374 737f 3136 3938 3034 0a4e  f tests.169804.N
│ │ │ │ -00000ae0: 6f64 653a 2049 6e69 7469 616c 697a 6174  ode: Initializat
│ │ │ │ -00000af0: 696f 6e20 4675 6e63 7469 6f6e 737f 3137  ion Functions.17
│ │ │ │ -00000b00: 3237 3934 0a52 6566 3a20 7368 6973 6869  2794.Ref: shishi
│ │ │ │ -00000b10: 7f31 3732 3939 360a 5265 663a 2073 6869  .172996.Ref: shi
│ │ │ │ -00000b20: 7368 695f 7365 7276 6572 7f31 3733 3339  shi_server.17339
│ │ │ │ -00000b30: 300a 5265 663a 2073 6869 7368 695f 646f  0.Ref: shishi_do
│ │ │ │ -00000b40: 6e65 7f31 3733 3738 300a 5265 663a 2073  ne.173780.Ref: s
│ │ │ │ -00000b50: 6869 7368 695f 696e 6974 7f31 3734 3433  hishi_init.17443
│ │ │ │ -00000b60: 390a 5265 663a 2073 6869 7368 695f 696e  9.Ref: shishi_in
│ │ │ │ -00000b70: 6974 5f77 6974 685f 7061 7468 737f 3137  it_with_paths.17
│ │ │ │ -00000b80: 3533 3338 0a52 6566 3a20 7368 6973 6869  5338.Ref: shishi
│ │ │ │ -00000b90: 5f69 6e69 745f 7365 7276 6572 7f31 3736  _init_server.176
│ │ │ │ -00000ba0: 3634 340a 5265 663a 2073 6869 7368 695f  644.Ref: shishi_
│ │ │ │ -00000bb0: 696e 6974 5f73 6572 7665 725f 7769 7468  init_server_with
│ │ │ │ -00000bc0: 5f70 6174 6873 7f31 3737 3337 330a 5265  _paths.177373.Re
│ │ │ │ -00000bd0: 663a 2073 6869 7368 695f 6366 677f 3137  f: shishi_cfg.17
│ │ │ │ -00000be0: 3832 3130 0a52 6566 3a20 7368 6973 6869  8210.Ref: shishi
│ │ │ │ -00000bf0: 5f63 6667 5f66 726f 6d5f 6669 6c65 7f31  _cfg_from_file.1
│ │ │ │ -00000c00: 3738 3634 360a 5265 663a 2073 6869 7368  78646.Ref: shish
│ │ │ │ -00000c10: 695f 6366 675f 7072 696e 747f 3137 3930  i_cfg_print.1790
│ │ │ │ -00000c20: 3332 0a52 6566 3a20 7368 6973 6869 5f63  32.Ref: shishi_c
│ │ │ │ -00000c30: 6667 5f64 6566 6175 6c74 5f73 7973 7465  fg_default_syste
│ │ │ │ -00000c40: 6d66 696c 657f 3137 3934 3534 0a52 6566  mfile.179454.Ref
│ │ │ │ -00000c50: 3a20 7368 6973 6869 5f63 6667 5f64 6566  : shishi_cfg_def
│ │ │ │ -00000c60: 6175 6c74 5f75 7365 7264 6972 6563 746f  ault_userdirecto
│ │ │ │ -00000c70: 7279 7f31 3830 3036 300a 5265 663a 2073  ry.180060.Ref: s
│ │ │ │ -00000c80: 6869 7368 695f 6366 675f 7573 6572 6469  hishi_cfg_userdi
│ │ │ │ -00000c90: 7265 6374 6f72 795f 6669 6c65 7f31 3830  rectory_file.180
│ │ │ │ -00000ca0: 3833 380a 5265 663a 2073 6869 7368 695f  838.Ref: shishi_
│ │ │ │ -00000cb0: 6366 675f 6465 6661 756c 745f 7573 6572  cfg_default_user
│ │ │ │ -00000cc0: 6669 6c65 7f31 3831 3731 310a 5265 663a  file.181711.Ref:
│ │ │ │ -00000cd0: 2073 6869 7368 695f 6366 675f 636c 6965   shishi_cfg_clie
│ │ │ │ -00000ce0: 6e74 6b64 6365 7479 7065 7f31 3832 3236  ntkdcetype.18226
│ │ │ │ -00000cf0: 300a 5265 663a 2073 6869 7368 695f 6366  0.Ref: shishi_cf
│ │ │ │ -00000d00: 675f 636c 6965 6e74 6b64 6365 7479 7065  g_clientkdcetype
│ │ │ │ -00000d10: 5f66 6173 747f 3138 3237 3937 0a52 6566  _fast.182797.Ref
│ │ │ │ -00000d20: 3a20 7368 6973 6869 5f63 6667 5f63 6c69  : shishi_cfg_cli
│ │ │ │ -00000d30: 656e 746b 6463 6574 7970 655f 7365 747f  entkdcetype_set.
│ │ │ │ -00000d40: 3138 3333 3131 0a52 6566 3a20 7368 6973  183311.Ref: shis
│ │ │ │ -00000d50: 6869 5f63 6667 5f61 7574 686f 7269 7a61  hi_cfg_authoriza
│ │ │ │ -00000d60: 7469 6f6e 7479 7065 5f73 6574 7f31 3834  tiontype_set.184
│ │ │ │ -00000d70: 3030 360a 4e6f 6465 3a20 5469 636b 6574  006.Node: Ticket
│ │ │ │ -00000d80: 2053 6574 2046 756e 6374 696f 6e73 7f31   Set Functions.1
│ │ │ │ -00000d90: 3834 3731 320a 5265 663a 2073 6869 7368  84712.Ref: shish
│ │ │ │ -00000da0: 695f 746b 7473 5f64 6566 6175 6c74 5f66  i_tkts_default_f
│ │ │ │ -00000db0: 696c 655f 6775 6573 737f 3138 3536 3236  ile_guess.185626
│ │ │ │ -00000dc0: 0a52 6566 3a20 7368 6973 6869 5f74 6b74  .Ref: shishi_tkt
│ │ │ │ -00000dd0: 735f 6465 6661 756c 745f 6669 6c65 7f31  s_default_file.1
│ │ │ │ -00000de0: 3836 3039 320a 5265 663a 2073 6869 7368  86092.Ref: shish
│ │ │ │ -00000df0: 695f 746b 7473 5f64 6566 6175 6c74 5f66  i_tkts_default_f
│ │ │ │ -00000e00: 696c 655f 7365 747f 3138 3634 3939 0a52  ile_set.186499.R
│ │ │ │ -00000e10: 6566 3a20 7368 6973 6869 5f74 6b74 735f  ef: shishi_tkts_
│ │ │ │ -00000e20: 6465 6661 756c 747f 3138 3639 3939 0a52  default.186999.R
│ │ │ │ -00000e30: 6566 3a20 7368 6973 6869 5f74 6b74 737f  ef: shishi_tkts.
│ │ │ │ -00000e40: 3138 3732 3834 0a52 6566 3a20 7368 6973  187284.Ref: shis
│ │ │ │ -00000e50: 6869 5f74 6b74 735f 646f 6e65 7f31 3837  hi_tkts_done.187
│ │ │ │ -00000e60: 3632 330a 5265 663a 2073 6869 7368 695f  623.Ref: shishi_
│ │ │ │ -00000e70: 746b 7473 5f73 697a 657f 3138 3739 3634  tkts_size.187964
│ │ │ │ -00000e80: 0a52 6566 3a20 7368 6973 6869 5f74 6b74  .Ref: shishi_tkt
│ │ │ │ -00000e90: 735f 6e74 687f 3138 3832 3335 0a52 6566  s_nth.188235.Ref
│ │ │ │ -00000ea0: 3a20 7368 6973 6869 5f74 6b74 735f 7265  : shishi_tkts_re
│ │ │ │ -00000eb0: 6d6f 7665 7f31 3838 3737 350a 5265 663a  move.188775.Ref:
│ │ │ │ -00000ec0: 2073 6869 7368 695f 746b 7473 5f61 6464   shishi_tkts_add
│ │ │ │ -00000ed0: 7f31 3839 3232 390a 5265 663a 2073 6869  .189229.Ref: shi
│ │ │ │ -00000ee0: 7368 695f 746b 7473 5f6e 6577 7f31 3839  shi_tkts_new.189
│ │ │ │ -00000ef0: 3637 340a 5265 663a 2073 6869 7368 695f  674.Ref: shishi_
│ │ │ │ -00000f00: 746b 7473 5f72 6561 647f 3139 3033 3630  tkts_read.190360
│ │ │ │ -00000f10: 0a52 6566 3a20 7368 6973 6869 5f74 6b74  .Ref: shishi_tkt
│ │ │ │ -00000f20: 735f 6672 6f6d 5f66 696c 657f 3139 3037  s_from_file.1907
│ │ │ │ -00000f30: 3332 0a52 6566 3a20 7368 6973 6869 5f74  32.Ref: shishi_t
│ │ │ │ -00000f40: 6b74 735f 7772 6974 657f 3139 3131 3139  kts_write.191119
│ │ │ │ -00000f50: 0a52 6566 3a20 7368 6973 6869 5f74 6b74  .Ref: shishi_tkt
│ │ │ │ -00000f60: 735f 6578 7069 7265 7f31 3931 3436 330a  s_expire.191463.
│ │ │ │ -00000f70: 5265 663a 2073 6869 7368 695f 746b 7473  Ref: shishi_tkts
│ │ │ │ -00000f80: 5f74 6f5f 6669 6c65 7f31 3931 3735 320a  _to_file.191752.
│ │ │ │ -00000f90: 5265 663a 2073 6869 7368 695f 746b 7473  Ref: shishi_tkts
│ │ │ │ -00000fa0: 5f70 7269 6e74 5f66 6f72 5f73 6572 7669  _print_for_servi
│ │ │ │ -00000fb0: 6365 7f31 3932 3133 300a 5265 663a 2073  ce.192130.Ref: s
│ │ │ │ -00000fc0: 6869 7368 695f 746b 7473 5f70 7269 6e74  hishi_tkts_print
│ │ │ │ -00000fd0: 7f31 3932 3634 390a 5265 663a 2073 6869  .192649.Ref: shi
│ │ │ │ -00000fe0: 7368 695f 746b 745f 6d61 7463 685f 707f  shi_tkt_match_p.
│ │ │ │ -00000ff0: 3139 3239 3937 0a52 6566 3a20 7368 6973  192997.Ref: shis
│ │ │ │ -00001000: 6869 5f74 6b74 735f 6669 6e64 7f31 3933  hi_tkts_find.193
│ │ │ │ -00001010: 3336 310a 5265 663a 2073 6869 7368 695f  361.Ref: shishi_
│ │ │ │ -00001020: 746b 7473 5f66 696e 645f 666f 725f 636c  tkts_find_for_cl
│ │ │ │ -00001030: 6965 6e74 7365 7276 6572 7f31 3934 3732  ientserver.19472
│ │ │ │ -00001040: 370a 5265 663a 2073 6869 7368 695f 746b  7.Ref: shishi_tk
│ │ │ │ -00001050: 7473 5f66 696e 645f 666f 725f 7365 7276  ts_find_for_serv
│ │ │ │ -00001060: 6572 7f31 3935 3239 300a 5265 663a 2073  er.195290.Ref: s
│ │ │ │ -00001070: 6869 7368 695f 746b 7473 5f67 6574 5f74  hishi_tkts_get_t
│ │ │ │ -00001080: 6774 7f31 3935 3833 340a 5265 663a 2073  gt.195834.Ref: s
│ │ │ │ -00001090: 6869 7368 695f 746b 7473 5f67 6574 5f74  hishi_tkts_get_t
│ │ │ │ -000010a0: 6773 7f31 3936 3731 390a 5265 663a 2073  gs.196719.Ref: s
│ │ │ │ -000010b0: 6869 7368 695f 746b 7473 5f67 6574 7f31  hishi_tkts_get.1
│ │ │ │ -000010c0: 3937 3338 360a 5265 663a 2073 6869 7368  97386.Ref: shish
│ │ │ │ -000010d0: 695f 746b 7473 5f67 6574 5f66 6f72 5f63  i_tkts_get_for_c
│ │ │ │ -000010e0: 6c69 656e 7473 6572 7665 727f 3139 3831  lientserver.1981
│ │ │ │ -000010f0: 3634 0a52 6566 3a20 7368 6973 6869 5f74  64.Ref: shishi_t
│ │ │ │ -00001100: 6b74 735f 6765 745f 666f 725f 7365 7276  kts_get_for_serv
│ │ │ │ -00001110: 6572 7f31 3938 3639 350a 5265 663a 2073  er.198695.Ref: s
│ │ │ │ -00001120: 6869 7368 695f 746b 7473 5f67 6574 5f66  hishi_tkts_get_f
│ │ │ │ -00001130: 6f72 5f6c 6f63 616c 7365 7276 6963 6570  or_localservicep
│ │ │ │ -00001140: 6173 7377 647f 3139 3932 3039 0a4e 6f64  asswd.199209.Nod
│ │ │ │ -00001150: 653a 2041 502d 5245 5120 616e 6420 4150  e: AP-REQ and AP
│ │ │ │ -00001160: 2d52 4550 2046 756e 6374 696f 6e73 7f31  -REP Functions.1
│ │ │ │ -00001170: 3939 3830 390a 5265 663a 2073 6869 7368  99809.Ref: shish
│ │ │ │ -00001180: 695f 6170 7f32 3030 3938 340a 5265 663a  i_ap.200984.Ref:
│ │ │ │ -00001190: 2073 6869 7368 695f 6170 5f65 7479 7065   shishi_ap_etype
│ │ │ │ -000011a0: 7f32 3031 3732 300a 5265 663a 2073 6869  .201720.Ref: shi
│ │ │ │ -000011b0: 7368 695f 6170 5f6e 6f73 7562 6b65 797f  shi_ap_nosubkey.
│ │ │ │ -000011c0: 3230 3232 3134 0a52 6566 3a20 7368 6973  202214.Ref: shis
│ │ │ │ -000011d0: 6869 5f61 705f 646f 6e65 7f32 3032 3630  hi_ap_done.20260
│ │ │ │ -000011e0: 320a 5265 663a 2073 6869 7368 695f 6170  2.Ref: shishi_ap
│ │ │ │ -000011f0: 5f73 6574 5f74 6b74 6f70 7469 6f6e 737f  _set_tktoptions.
│ │ │ │ -00001200: 3230 3239 3435 0a52 6566 3a20 7368 6973  202945.Ref: shis
│ │ │ │ -00001210: 6869 5f61 705f 7365 745f 746b 746f 7074  hi_ap_set_tktopt
│ │ │ │ -00001220: 696f 6e73 6461 7461 7f32 3033 3433 380a  ionsdata.203438.
│ │ │ │ -00001230: 5265 663a 2073 6869 7368 695f 6170 5f73  Ref: shishi_ap_s
│ │ │ │ -00001240: 6574 5f74 6b74 6f70 7469 6f6e 7372 6177  et_tktoptionsraw
│ │ │ │ -00001250: 7f32 3034 3134 340a 5265 663a 2073 6869  .204144.Ref: shi
│ │ │ │ -00001260: 7368 695f 6170 5f73 6574 5f74 6b74 6f70  shi_ap_set_tktop
│ │ │ │ -00001270: 7469 6f6e 7361 736e 3175 7361 6765 7f32  tionsasn1usage.2
│ │ │ │ -00001280: 3034 3939 320a 5265 663a 2073 6869 7368  04992.Ref: shish
│ │ │ │ -00001290: 695f 6170 5f74 6b74 6f70 7469 6f6e 737f  i_ap_tktoptions.
│ │ │ │ -000012a0: 3230 3539 3232 0a52 6566 3a20 7368 6973  205922.Ref: shis
│ │ │ │ -000012b0: 6869 5f61 705f 746b 746f 7074 696f 6e73  hi_ap_tktoptions
│ │ │ │ -000012c0: 6461 7461 7f32 3036 3634 380a 5265 663a  data.206648.Ref:
│ │ │ │ -000012d0: 2073 6869 7368 695f 6170 5f74 6b74 6f70   shishi_ap_tktop
│ │ │ │ -000012e0: 7469 6f6e 7372 6177 7f32 3037 3539 340a  tionsraw.207594.
│ │ │ │ -000012f0: 5265 663a 2073 6869 7368 695f 6170 5f65  Ref: shishi_ap_e
│ │ │ │ -00001300: 7479 7065 5f74 6b74 6f70 7469 6f6e 7364  type_tktoptionsd
│ │ │ │ -00001310: 6174 617f 3230 3836 3739 0a52 6566 3a20  ata.208679.Ref: 
│ │ │ │ -00001320: 7368 6973 6869 5f61 705f 746b 746f 7074  shishi_ap_tktopt
│ │ │ │ -00001330: 696f 6e73 6173 6e31 7573 6167 657f 3230  ionsasn1usage.20
│ │ │ │ -00001340: 3937 3230 0a52 6566 3a20 7368 6973 6869  9720.Ref: shishi
│ │ │ │ -00001350: 5f61 705f 746b 747f 3231 3038 3831 0a52  _ap_tkt.210881.R
│ │ │ │ -00001360: 6566 3a20 7368 6973 6869 5f61 705f 746b  ef: shishi_ap_tk
│ │ │ │ -00001370: 745f 7365 747f 3231 3131 3939 0a52 6566  t_set.211199.Ref
│ │ │ │ -00001380: 3a20 7368 6973 6869 5f61 705f 6175 7468  : shishi_ap_auth
│ │ │ │ -00001390: 656e 7469 6361 746f 725f 636b 7375 6d64  enticator_cksumd
│ │ │ │ -000013a0: 6174 617f 3231 3134 3930 0a52 6566 3a20  ata.211490.Ref: 
│ │ │ │ -000013b0: 7368 6973 6869 5f61 705f 6175 7468 656e  shishi_ap_authen
│ │ │ │ -000013c0: 7469 6361 746f 725f 636b 7375 6d64 6174  ticator_cksumdat
│ │ │ │ -000013d0: 615f 7365 747f 3231 3232 3137 0a52 6566  a_set.212217.Ref
│ │ │ │ -000013e0: 3a20 7368 6973 6869 5f61 705f 6175 7468  : shishi_ap_auth
│ │ │ │ -000013f0: 656e 7469 6361 746f 725f 636b 7375 6d72  enticator_cksumr
│ │ │ │ -00001400: 6177 5f73 6574 7f32 3133 3033 330a 5265  aw_set.213033.Re
│ │ │ │ -00001410: 663a 2073 6869 7368 695f 6170 5f61 7574  f: shishi_ap_aut
│ │ │ │ -00001420: 6865 6e74 6963 6174 6f72 5f63 6b73 756d  henticator_cksum
│ │ │ │ -00001430: 7479 7065 7f32 3133 3933 380a 5265 663a  type.213938.Ref:
│ │ │ │ -00001440: 2073 6869 7368 695f 6170 5f61 7574 6865   shishi_ap_authe
│ │ │ │ -00001450: 6e74 6963 6174 6f72 5f63 6b73 756d 7479  nticator_cksumty
│ │ │ │ -00001460: 7065 5f73 6574 7f32 3134 3239 330a 5265  pe_set.214293.Re
│ │ │ │ -00001470: 663a 2073 6869 7368 695f 6170 5f61 7574  f: shishi_ap_aut
│ │ │ │ -00001480: 6865 6e74 6963 6174 6f72 7f32 3134 3634  henticator.21464
│ │ │ │ -00001490: 360a 5265 663a 2073 6869 7368 695f 6170  6.Ref: shishi_ap
│ │ │ │ -000014a0: 5f61 7574 6865 6e74 6963 6174 6f72 5f73  _authenticator_s
│ │ │ │ -000014b0: 6574 7f32 3135 3032 330a 5265 663a 2073  et.215023.Ref: s
│ │ │ │ -000014c0: 6869 7368 695f 6170 5f72 6571 7f32 3135  hishi_ap_req.215
│ │ │ │ -000014d0: 3332 370a 5265 663a 2073 6869 7368 695f  327.Ref: shishi_
│ │ │ │ -000014e0: 6170 5f72 6571 5f73 6574 7f32 3135 3636  ap_req_set.21566
│ │ │ │ -000014f0: 300a 5265 663a 2073 6869 7368 695f 6170  0.Ref: shishi_ap
│ │ │ │ -00001500: 5f72 6571 5f64 6572 7f32 3135 3932 310a  _req_der.215921.
│ │ │ │ -00001510: 5265 663a 2073 6869 7368 695f 6170 5f72  Ref: shishi_ap_r
│ │ │ │ -00001520: 6571 5f64 6572 5f73 6574 7f32 3136 3531  eq_der_set.21651
│ │ │ │ -00001530: 300a 5265 663a 2073 6869 7368 695f 6170  0.Ref: shishi_ap
│ │ │ │ -00001540: 5f72 6571 5f62 7569 6c64 7f32 3136 3938  _req_build.21698
│ │ │ │ -00001550: 310a 5265 663a 2073 6869 7368 695f 6170  1.Ref: shishi_ap
│ │ │ │ -00001560: 5f72 6571 5f64 6563 6f64 657f 3231 3732  _req_decode.2172
│ │ │ │ -00001570: 3937 0a52 6566 3a20 7368 6973 6869 5f61  97.Ref: shishi_a
│ │ │ │ -00001580: 705f 7265 715f 7072 6f63 6573 735f 6b65  p_req_process_ke
│ │ │ │ -00001590: 7975 7361 6765 7f32 3137 3632 390a 5265  yusage.217629.Re
│ │ │ │ -000015a0: 663a 2073 6869 7368 695f 6170 5f72 6571  f: shishi_ap_req
│ │ │ │ -000015b0: 5f70 726f 6365 7373 7f32 3138 3432 300a  _process.218420.
│ │ │ │ -000015c0: 5265 663a 2073 6869 7368 695f 6170 5f72  Ref: shishi_ap_r
│ │ │ │ -000015d0: 6571 5f61 736e 317f 3231 3839 3435 0a52  eq_asn1.218945.R
│ │ │ │ -000015e0: 6566 3a20 7368 6973 6869 5f61 705f 6b65  ef: shishi_ap_ke
│ │ │ │ -000015f0: 797f 3231 3933 3030 0a52 6566 3a20 7368  y.219300.Ref: sh
│ │ │ │ -00001600: 6973 6869 5f61 705f 7265 707f 3231 3936  ishi_ap_rep.2196
│ │ │ │ -00001610: 3632 0a52 6566 3a20 7368 6973 6869 5f61  62.Ref: shishi_a
│ │ │ │ -00001620: 705f 7265 705f 7365 747f 3231 3939 3935  p_rep_set.219995
│ │ │ │ -00001630: 0a52 6566 3a20 7368 6973 6869 5f61 705f  .Ref: shishi_ap_
│ │ │ │ -00001640: 7265 705f 6465 727f 3232 3032 3536 0a52  rep_der.220256.R
│ │ │ │ -00001650: 6566 3a20 7368 6973 6869 5f61 705f 7265  ef: shishi_ap_re
│ │ │ │ -00001660: 705f 6465 725f 7365 747f 3232 3038 3334  p_der_set.220834
│ │ │ │ -00001670: 0a52 6566 3a20 7368 6973 6869 5f61 705f  .Ref: shishi_ap_
│ │ │ │ -00001680: 7265 705f 6275 696c 647f 3232 3133 3035  rep_build.221305
│ │ │ │ -00001690: 0a52 6566 3a20 7368 6973 6869 5f61 705f  .Ref: shishi_ap_
│ │ │ │ -000016a0: 7265 705f 6173 6e31 7f32 3231 3631 370a  rep_asn1.221617.
│ │ │ │ -000016b0: 5265 663a 2073 6869 7368 695f 6170 5f72  Ref: shishi_ap_r
│ │ │ │ -000016c0: 6570 5f76 6572 6966 797f 3232 3139 3836  ep_verify.221986
│ │ │ │ -000016d0: 0a52 6566 3a20 7368 6973 6869 5f61 705f  .Ref: shishi_ap_
│ │ │ │ -000016e0: 7265 705f 7665 7269 6679 5f64 6572 7f32  rep_verify_der.2
│ │ │ │ -000016f0: 3232 3330 320a 5265 663a 2073 6869 7368  22302.Ref: shish
│ │ │ │ -00001700: 695f 6170 5f72 6570 5f76 6572 6966 795f  i_ap_rep_verify_
│ │ │ │ -00001710: 6173 6e31 7f32 3232 3836 370a 5265 663a  asn1.222867.Ref:
│ │ │ │ -00001720: 2073 6869 7368 695f 6170 5f65 6e63 6170   shishi_ap_encap
│ │ │ │ -00001730: 7265 7070 6172 747f 3232 3333 3139 0a52  reppart.223319.R
│ │ │ │ -00001740: 6566 3a20 7368 6973 6869 5f61 705f 656e  ef: shishi_ap_en
│ │ │ │ -00001750: 6361 7072 6570 7061 7274 5f73 6574 7f32  capreppart_set.2
│ │ │ │ -00001760: 3233 3639 310a 5265 663a 2073 6869 7368  23691.Ref: shish
│ │ │ │ -00001770: 695f 6170 5f6f 7074 696f 6e32 7374 7269  i_ap_option2stri
│ │ │ │ -00001780: 6e67 7f32 3234 3031 300a 5265 663a 2073  ng.224010.Ref: s
│ │ │ │ -00001790: 6869 7368 695f 6170 5f73 7472 696e 6732  hishi_ap_string2
│ │ │ │ -000017a0: 6f70 7469 6f6e 7f32 3234 3535 390a 5265  option.224559.Re
│ │ │ │ -000017b0: 663a 2073 6869 7368 695f 6170 7265 717f  f: shishi_apreq.
│ │ │ │ -000017c0: 3232 3439 3530 0a52 6566 3a20 7368 6973  224950.Ref: shis
│ │ │ │ -000017d0: 6869 5f61 7072 6571 5f70 7269 6e74 7f32  hi_apreq_print.2
│ │ │ │ -000017e0: 3235 3237 300a 5265 663a 2073 6869 7368  25270.Ref: shish
│ │ │ │ -000017f0: 695f 6170 7265 715f 7361 7665 7f32 3235  i_apreq_save.225
│ │ │ │ -00001800: 3636 340a 5265 663a 2073 6869 7368 695f  664.Ref: shishi_
│ │ │ │ -00001810: 6170 7265 715f 746f 5f66 696c 657f 3232  apreq_to_file.22
│ │ │ │ -00001820: 3630 3437 0a52 6566 3a20 7368 6973 6869  6047.Ref: shishi
│ │ │ │ -00001830: 5f61 7072 6571 5f70 6172 7365 7f32 3236  _apreq_parse.226
│ │ │ │ -00001840: 3631 370a 5265 663a 2073 6869 7368 695f  617.Ref: shishi_
│ │ │ │ -00001850: 6170 7265 715f 7265 6164 7f32 3237 3037  apreq_read.22707
│ │ │ │ -00001860: 310a 5265 663a 2073 6869 7368 695f 6170  1.Ref: shishi_ap
│ │ │ │ -00001870: 7265 715f 6672 6f6d 5f66 696c 657f 3232  req_from_file.22
│ │ │ │ -00001880: 3735 3230 0a52 6566 3a20 7368 6973 6869  7520.Ref: shishi
│ │ │ │ -00001890: 5f61 7072 6571 5f73 6574 5f61 7574 6865  _apreq_set_authe
│ │ │ │ -000018a0: 6e74 6963 6174 6f72 7f32 3238 3130 300a  nticator.228100.
│ │ │ │ -000018b0: 5265 663a 2073 6869 7368 695f 6170 7265  Ref: shishi_apre
│ │ │ │ -000018c0: 715f 6164 645f 6175 7468 656e 7469 6361  q_add_authentica
│ │ │ │ -000018d0: 746f 727f 3232 3930 3930 0a52 6566 3a20  tor.229090.Ref: 
│ │ │ │ -000018e0: 7368 6973 6869 5f61 7072 6571 5f73 6574  shishi_apreq_set
│ │ │ │ -000018f0: 5f74 6963 6b65 747f 3232 3937 3636 0a52  _ticket.229766.R
│ │ │ │ -00001900: 6566 3a20 7368 6973 6869 5f61 7072 6571  ef: shishi_apreq
│ │ │ │ -00001910: 5f6f 7074 696f 6e73 7f32 3330 3138 380a  _options.230188.
│ │ │ │ -00001920: 5265 663a 2073 6869 7368 695f 6170 7265  Ref: shishi_apre
│ │ │ │ -00001930: 715f 7573 655f 7365 7373 696f 6e5f 6b65  q_use_session_ke
│ │ │ │ -00001940: 795f 707f 3233 3036 3537 0a52 6566 3a20  y_p.230657.Ref: 
│ │ │ │ -00001950: 7368 6973 6869 5f61 7072 6571 5f6d 7574  shishi_apreq_mut
│ │ │ │ -00001960: 7561 6c5f 7265 7175 6972 6564 5f70 7f32  ual_required_p.2
│ │ │ │ -00001970: 3331 3038 380a 5265 663a 2073 6869 7368  31088.Ref: shish
│ │ │ │ -00001980: 695f 6170 7265 715f 6f70 7469 6f6e 735f  i_apreq_options_
│ │ │ │ -00001990: 7365 747f 3233 3135 3037 0a52 6566 3a20  set.231507.Ref: 
│ │ │ │ -000019a0: 7368 6973 6869 5f61 7072 6571 5f6f 7074  shishi_apreq_opt
│ │ │ │ -000019b0: 696f 6e73 5f61 6464 7f32 3331 3935 350a  ions_add.231955.
│ │ │ │ -000019c0: 5265 663a 2073 6869 7368 695f 6170 7265  Ref: shishi_apre
│ │ │ │ -000019d0: 715f 6f70 7469 6f6e 735f 7265 6d6f 7665  q_options_remove
│ │ │ │ -000019e0: 7f32 3332 3436 330a 5265 663a 2073 6869  .232463.Ref: shi
│ │ │ │ -000019f0: 7368 695f 6170 7265 715f 6765 745f 6175  shi_apreq_get_au
│ │ │ │ -00001a00: 7468 656e 7469 6361 746f 725f 6574 7970  thenticator_etyp
│ │ │ │ -00001a10: 657f 3233 3330 3032 0a52 6566 3a20 7368  e.233002.Ref: sh
│ │ │ │ -00001a20: 6973 6869 5f61 7072 6571 5f67 6574 5f74  ishi_apreq_get_t
│ │ │ │ -00001a30: 6963 6b65 747f 3233 3334 3435 0a52 6566  icket.233445.Ref
│ │ │ │ -00001a40: 3a20 7368 6973 6869 5f61 7072 6570 7f32  : shishi_aprep.2
│ │ │ │ -00001a50: 3333 3835 360a 5265 663a 2073 6869 7368  33856.Ref: shish
│ │ │ │ -00001a60: 695f 6170 7265 705f 7072 696e 747f 3233  i_aprep_print.23
│ │ │ │ -00001a70: 3431 3833 0a52 6566 3a20 7368 6973 6869  4183.Ref: shishi
│ │ │ │ -00001a80: 5f61 7072 6570 5f73 6176 657f 3233 3435  _aprep_save.2345
│ │ │ │ -00001a90: 3737 0a52 6566 3a20 7368 6973 6869 5f61  77.Ref: shishi_a
│ │ │ │ -00001aa0: 7072 6570 5f74 6f5f 6669 6c65 7f32 3334  prep_to_file.234
│ │ │ │ -00001ab0: 3936 300a 5265 663a 2073 6869 7368 695f  960.Ref: shishi_
│ │ │ │ -00001ac0: 6170 7265 705f 7061 7273 657f 3233 3535  aprep_parse.2355
│ │ │ │ -00001ad0: 3330 0a52 6566 3a20 7368 6973 6869 5f61  30.Ref: shishi_a
│ │ │ │ -00001ae0: 7072 6570 5f72 6561 647f 3233 3539 3834  prep_read.235984
│ │ │ │ -00001af0: 0a52 6566 3a20 7368 6973 6869 5f61 7072  .Ref: shishi_apr
│ │ │ │ -00001b00: 6570 5f66 726f 6d5f 6669 6c65 7f32 3336  ep_from_file.236
│ │ │ │ -00001b10: 3433 330a 5265 663a 2073 6869 7368 695f  433.Ref: shishi_
│ │ │ │ -00001b20: 6170 7265 705f 6765 745f 656e 635f 7061  aprep_get_enc_pa
│ │ │ │ -00001b30: 7274 5f65 7479 7065 7f32 3337 3031 350a  rt_etype.237015.
│ │ │ │ -00001b40: 5265 663a 2073 6869 7368 695f 656e 6361  Ref: shishi_enca
│ │ │ │ -00001b50: 7072 6570 7061 7274 7f32 3337 3434 300a  preppart.237440.
│ │ │ │ -00001b60: 5265 663a 2073 6869 7368 695f 656e 6361  Ref: shishi_enca
│ │ │ │ -00001b70: 7072 6570 7061 7274 5f70 7269 6e74 7f32  preppart_print.2
│ │ │ │ -00001b80: 3337 3838 320a 5265 663a 2073 6869 7368  37882.Ref: shish
│ │ │ │ -00001b90: 695f 656e 6361 7072 6570 7061 7274 5f73  i_encapreppart_s
│ │ │ │ -00001ba0: 6176 657f 3233 3833 3238 0a52 6566 3a20  ave.238328.Ref: 
│ │ │ │ -00001bb0: 7368 6973 6869 5f65 6e63 6170 7265 7070  shishi_encaprepp
│ │ │ │ -00001bc0: 6172 745f 746f 5f66 696c 657f 3233 3837  art_to_file.2387
│ │ │ │ -00001bd0: 3538 0a52 6566 3a20 7368 6973 6869 5f65  58.Ref: shishi_e
│ │ │ │ -00001be0: 6e63 6170 7265 7070 6172 745f 7061 7273  ncapreppart_pars
│ │ │ │ -00001bf0: 657f 3233 3933 3735 0a52 6566 3a20 7368  e.239375.Ref: sh
│ │ │ │ -00001c00: 6973 6869 5f65 6e63 6170 7265 7070 6172  ishi_encapreppar
│ │ │ │ -00001c10: 745f 7265 6164 7f32 3339 3837 360a 5265  t_read.239876.Re
│ │ │ │ -00001c20: 663a 2073 6869 7368 695f 656e 6361 7072  f: shishi_encapr
│ │ │ │ -00001c30: 6570 7061 7274 5f66 726f 6d5f 6669 6c65  eppart_from_file
│ │ │ │ -00001c40: 7f32 3430 3337 320a 5265 663a 2073 6869  .240372.Ref: shi
│ │ │ │ -00001c50: 7368 695f 656e 6361 7072 6570 7061 7274  shi_encapreppart
│ │ │ │ -00001c60: 5f67 6574 5f6b 6579 7f32 3430 3938 390a  _get_key.240989.
│ │ │ │ -00001c70: 5265 663a 2073 6869 7368 695f 656e 6361  Ref: shishi_enca
│ │ │ │ -00001c80: 7072 6570 7061 7274 5f63 7469 6d65 7f32  preppart_ctime.2
│ │ │ │ -00001c90: 3431 3433 390a 5265 663a 2073 6869 7368  41439.Ref: shish
│ │ │ │ -00001ca0: 695f 656e 6361 7072 6570 7061 7274 5f63  i_encapreppart_c
│ │ │ │ -00001cb0: 7469 6d65 5f73 6574 7f32 3431 3934 370a  time_set.241947.
│ │ │ │ -00001cc0: 5265 663a 2073 6869 7368 695f 656e 6361  Ref: shishi_enca
│ │ │ │ -00001cd0: 7072 6570 7061 7274 5f63 7573 6563 5f67  preppart_cusec_g
│ │ │ │ -00001ce0: 6574 7f32 3432 3435 300a 5265 663a 2073  et.242450.Ref: s
│ │ │ │ -00001cf0: 6869 7368 695f 656e 6361 7072 6570 7061  hishi_encapreppa
│ │ │ │ -00001d00: 7274 5f63 7573 6563 5f73 6574 7f32 3432  rt_cusec_set.242
│ │ │ │ -00001d10: 3936 330a 5265 663a 2073 6869 7368 695f  963.Ref: shishi_
│ │ │ │ -00001d20: 656e 6361 7072 6570 7061 7274 5f73 6571  encapreppart_seq
│ │ │ │ -00001d30: 6e75 6d62 6572 5f67 6574 7f32 3433 3437  number_get.24347
│ │ │ │ -00001d40: 390a 5265 663a 2073 6869 7368 695f 656e  9.Ref: shishi_en
│ │ │ │ -00001d50: 6361 7072 6570 7061 7274 5f73 6571 6e75  capreppart_seqnu
│ │ │ │ -00001d60: 6d62 6572 5f72 656d 6f76 657f 3234 3430  mber_remove.2440
│ │ │ │ -00001d70: 3130 0a52 6566 3a20 7368 6973 6869 5f65  10.Ref: shishi_e
│ │ │ │ -00001d80: 6e63 6170 7265 7070 6172 745f 7365 716e  ncapreppart_seqn
│ │ │ │ -00001d90: 756d 6265 725f 7365 747f 3234 3434 3539  umber_set.244459
│ │ │ │ -00001da0: 0a52 6566 3a20 7368 6973 6869 5f65 6e63  .Ref: shishi_enc
│ │ │ │ -00001db0: 6170 7265 7070 6172 745f 7469 6d65 5f63  apreppart_time_c
│ │ │ │ -00001dc0: 6f70 797f 3234 3439 3939 0a4e 6f64 653a  opy.244999.Node:
│ │ │ │ -00001dd0: 2053 4146 4520 616e 6420 5052 4956 2046   SAFE and PRIV F
│ │ │ │ -00001de0: 756e 6374 696f 6e73 7f32 3435 3436 380a  unctions.245468.
│ │ │ │ -00001df0: 5265 663a 2073 6869 7368 695f 7361 6665  Ref: shishi_safe
│ │ │ │ -00001e00: 7f32 3436 3535 340a 5265 663a 2073 6869  .246554.Ref: shi
│ │ │ │ -00001e10: 7368 695f 7361 6665 5f64 6f6e 657f 3234  shi_safe_done.24
│ │ │ │ -00001e20: 3639 3132 0a52 6566 3a20 7368 6973 6869  6912.Ref: shishi
│ │ │ │ -00001e30: 5f73 6166 655f 6b65 797f 3234 3732 3531  _safe_key.247251
│ │ │ │ -00001e40: 0a52 6566 3a20 7368 6973 6869 5f73 6166  .Ref: shishi_saf
│ │ │ │ -00001e50: 655f 6b65 795f 7365 747f 3234 3735 3935  e_key_set.247595
│ │ │ │ -00001e60: 0a52 6566 3a20 7368 6973 6869 5f73 6166  .Ref: shishi_saf
│ │ │ │ -00001e70: 655f 7361 6665 7f32 3437 3837 300a 5265  e_safe.247870.Re
│ │ │ │ -00001e80: 663a 2073 6869 7368 695f 7361 6665 5f73  f: shishi_safe_s
│ │ │ │ -00001e90: 6166 655f 7365 747f 3234 3832 3235 0a52  afe_set.248225.R
│ │ │ │ -00001ea0: 6566 3a20 7368 6973 6869 5f73 6166 655f  ef: shishi_safe_
│ │ │ │ -00001eb0: 7361 6665 5f64 6572 7f32 3438 3533 370a  safe_der.248537.
│ │ │ │ -00001ec0: 5265 663a 2073 6869 7368 695f 7361 6665  Ref: shishi_safe
│ │ │ │ -00001ed0: 5f73 6166 655f 6465 725f 7365 747f 3234  _safe_der_set.24
│ │ │ │ -00001ee0: 3931 3632 0a52 6566 3a20 7368 6973 6869  9162.Ref: shishi
│ │ │ │ -00001ef0: 5f73 6166 655f 7072 696e 747f 3234 3936  _safe_print.2496
│ │ │ │ -00001f00: 3431 0a52 6566 3a20 7368 6973 6869 5f73  41.Ref: shishi_s
│ │ │ │ -00001f10: 6166 655f 7361 7665 7f32 3530 3032 360a  afe_save.250026.
│ │ │ │ -00001f20: 5265 663a 2073 6869 7368 695f 7361 6665  Ref: shishi_safe
│ │ │ │ -00001f30: 5f74 6f5f 6669 6c65 7f32 3530 3430 300a  _to_file.250400.
│ │ │ │ -00001f40: 5265 663a 2073 6869 7368 695f 7361 6665  Ref: shishi_safe
│ │ │ │ -00001f50: 5f70 6172 7365 7f32 3530 3936 310a 5265  _parse.250961.Re
│ │ │ │ -00001f60: 663a 2073 6869 7368 695f 7361 6665 5f72  f: shishi_safe_r
│ │ │ │ -00001f70: 6561 647f 3235 3134 3036 0a52 6566 3a20  ead.251406.Ref: 
│ │ │ │ -00001f80: 7368 6973 6869 5f73 6166 655f 6672 6f6d  shishi_safe_from
│ │ │ │ -00001f90: 5f66 696c 657f 3235 3138 3436 0a52 6566  _file.251846.Ref
│ │ │ │ -00001fa0: 3a20 7368 6973 6869 5f73 6166 655f 636b  : shishi_safe_ck
│ │ │ │ -00001fb0: 7375 6d7f 3235 3233 3933 0a52 6566 3a20  sum.252393.Ref: 
│ │ │ │ -00001fc0: 7368 6973 6869 5f73 6166 655f 7365 745f  shishi_safe_set_
│ │ │ │ -00001fd0: 636b 7375 6d7f 3235 3330 3737 0a52 6566  cksum.253077.Ref
│ │ │ │ -00001fe0: 3a20 7368 6973 6869 5f73 6166 655f 7573  : shishi_safe_us
│ │ │ │ -00001ff0: 6572 5f64 6174 617f 3235 3339 3730 0a52  er_data.253970.R
│ │ │ │ -00002000: 6566 3a20 7368 6973 6869 5f73 6166 655f  ef: shishi_safe_
│ │ │ │ -00002010: 7365 745f 7573 6572 5f64 6174 617f 3235  set_user_data.25
│ │ │ │ -00002020: 3436 3234 0a52 6566 3a20 7368 6973 6869  4624.Ref: shishi
│ │ │ │ -00002030: 5f73 6166 655f 6275 696c 647f 3235 3531  _safe_build.2551
│ │ │ │ -00002040: 3436 0a52 6566 3a20 7368 6973 6869 5f73  46.Ref: shishi_s
│ │ │ │ -00002050: 6166 655f 7665 7269 6679 7f32 3535 3634  afe_verify.25564
│ │ │ │ -00002060: 300a 5265 663a 2073 6869 7368 695f 7072  0.Ref: shishi_pr
│ │ │ │ -00002070: 6976 7f32 3537 3138 370a 5265 663a 2073  iv.257187.Ref: s
│ │ │ │ -00002080: 6869 7368 695f 7072 6976 5f64 6f6e 657f  hishi_priv_done.
│ │ │ │ -00002090: 3235 3735 3435 0a52 6566 3a20 7368 6973  257545.Ref: shis
│ │ │ │ -000020a0: 6869 5f70 7269 765f 6b65 797f 3235 3738  hi_priv_key.2578
│ │ │ │ -000020b0: 3834 0a52 6566 3a20 7368 6973 6869 5f70  84.Ref: shishi_p
│ │ │ │ -000020c0: 7269 765f 6b65 795f 7365 747f 3235 3832  riv_key_set.2582
│ │ │ │ -000020d0: 3137 0a52 6566 3a20 7368 6973 6869 5f70  17.Ref: shishi_p
│ │ │ │ -000020e0: 7269 765f 7072 6976 7f32 3538 3439 320a  riv_priv.258492.
│ │ │ │ -000020f0: 5265 663a 2073 6869 7368 695f 7072 6976  Ref: shishi_priv
│ │ │ │ -00002100: 5f70 7269 765f 7365 747f 3235 3838 3434  _priv_set.258844
│ │ │ │ -00002110: 0a52 6566 3a20 7368 6973 6869 5f70 7269  .Ref: shishi_pri
│ │ │ │ -00002120: 765f 7072 6976 5f64 6572 7f32 3539 3135  v_priv_der.25915
│ │ │ │ -00002130: 360a 5265 663a 2073 6869 7368 695f 7072  6.Ref: shishi_pr
│ │ │ │ -00002140: 6976 5f70 7269 765f 6465 725f 7365 747f  iv_priv_der_set.
│ │ │ │ -00002150: 3235 3937 3831 0a52 6566 3a20 7368 6973  259781.Ref: shis
│ │ │ │ -00002160: 6869 5f70 7269 765f 656e 6370 7269 7670  hi_priv_encprivp
│ │ │ │ -00002170: 6172 747f 3236 3032 3732 0a52 6566 3a20  art.260272.Ref: 
│ │ │ │ -00002180: 7368 6973 6869 5f70 7269 765f 656e 6370  shishi_priv_encp
│ │ │ │ -00002190: 7269 7670 6172 745f 7365 747f 3236 3036  rivpart_set.2606
│ │ │ │ -000021a0: 3631 0a52 6566 3a20 7368 6973 6869 5f70  61.Ref: shishi_p
│ │ │ │ -000021b0: 7269 765f 656e 6370 7269 7670 6172 745f  riv_encprivpart_
│ │ │ │ -000021c0: 6465 727f 3236 3130 3134 0a52 6566 3a20  der.261014.Ref: 
│ │ │ │ -000021d0: 7368 6973 6869 5f70 7269 765f 656e 6370  shishi_priv_encp
│ │ │ │ -000021e0: 7269 7670 6172 745f 6465 725f 7365 747f  rivpart_der_set.
│ │ │ │ -000021f0: 3236 3135 3938 0a52 6566 3a20 7368 6973  261598.Ref: shis
│ │ │ │ -00002200: 6869 5f70 7269 765f 7072 696e 747f 3236  hi_priv_print.26
│ │ │ │ -00002210: 3230 3936 0a52 6566 3a20 7368 6973 6869  2096.Ref: shishi
│ │ │ │ -00002220: 5f70 7269 765f 7361 7665 7f32 3632 3438  _priv_save.26248
│ │ │ │ -00002230: 310a 5265 663a 2073 6869 7368 695f 7072  1.Ref: shishi_pr
│ │ │ │ -00002240: 6976 5f74 6f5f 6669 6c65 7f32 3632 3835  iv_to_file.26285
│ │ │ │ -00002250: 350a 5265 663a 2073 6869 7368 695f 7072  5.Ref: shishi_pr
│ │ │ │ -00002260: 6976 5f70 6172 7365 7f32 3633 3431 360a  iv_parse.263416.
│ │ │ │ -00002270: 5265 663a 2073 6869 7368 695f 7072 6976  Ref: shishi_priv
│ │ │ │ -00002280: 5f72 6561 647f 3236 3338 3631 0a52 6566  _read.263861.Ref
│ │ │ │ -00002290: 3a20 7368 6973 6869 5f70 7269 765f 6672  : shishi_priv_fr
│ │ │ │ -000022a0: 6f6d 5f66 696c 657f 3236 3433 3031 0a52  om_file.264301.R
│ │ │ │ -000022b0: 6566 3a20 7368 6973 6869 5f70 7269 765f  ef: shishi_priv_
│ │ │ │ -000022c0: 656e 635f 7061 7274 5f65 7479 7065 7f32  enc_part_etype.2
│ │ │ │ -000022d0: 3634 3836 360a 5265 663a 2073 6869 7368  64866.Ref: shish
│ │ │ │ -000022e0: 695f 7072 6976 5f73 6574 5f65 6e63 5f70  i_priv_set_enc_p
│ │ │ │ -000022f0: 6172 747f 3236 3532 3930 0a52 6566 3a20  art.265290.Ref: 
│ │ │ │ -00002300: 7368 6973 6869 5f65 6e63 7072 6976 7061  shishi_encprivpa
│ │ │ │ -00002310: 7274 5f75 7365 725f 6461 7461 7f32 3636  rt_user_data.266
│ │ │ │ -00002320: 3230 360a 5265 663a 2073 6869 7368 695f  206.Ref: shishi_
│ │ │ │ -00002330: 656e 6370 7269 7670 6172 745f 7365 745f  encprivpart_set_
│ │ │ │ -00002340: 7573 6572 5f64 6174 617f 3236 3639 3132  user_data.266912
│ │ │ │ -00002350: 0a52 6566 3a20 7368 6973 6869 5f70 7269  .Ref: shishi_pri
│ │ │ │ -00002360: 765f 6275 696c 647f 3236 3734 3732 0a52  v_build.267472.R
│ │ │ │ -00002370: 6566 3a20 7368 6973 6869 5f70 7269 765f  ef: shishi_priv_
│ │ │ │ -00002380: 7072 6f63 6573 737f 3236 3739 3634 0a4e  process.267964.N
│ │ │ │ -00002390: 6f64 653a 2054 6963 6b65 7420 4675 6e63  ode: Ticket Func
│ │ │ │ -000023a0: 7469 6f6e 737f 3236 3834 3430 0a52 6566  tions.268440.Ref
│ │ │ │ -000023b0: 3a20 7368 6973 6869 5f74 6b74 7f32 3639  : shishi_tkt.269
│ │ │ │ -000023c0: 3031 390a 5265 663a 2073 6869 7368 695f  019.Ref: shishi_
│ │ │ │ -000023d0: 746b 7432 7f32 3639 3333 350a 5265 663a  tkt2.269335.Ref:
│ │ │ │ -000023e0: 2073 6869 7368 695f 746b 745f 646f 6e65   shishi_tkt_done
│ │ │ │ -000023f0: 7f32 3639 3837 310a 5265 663a 2073 6869  .269871.Ref: shi
│ │ │ │ -00002400: 7368 695f 746b 745f 7469 636b 6574 7f32  shi_tkt_ticket.2
│ │ │ │ -00002410: 3730 3132 390a 5265 663a 2073 6869 7368  70129.Ref: shish
│ │ │ │ -00002420: 695f 746b 745f 7469 636b 6574 5f73 6574  i_tkt_ticket_set
│ │ │ │ -00002430: 7f32 3730 3338 370a 5265 663a 2073 6869  .270387.Ref: shi
│ │ │ │ -00002440: 7368 695f 746b 745f 656e 636b 6463 7265  shi_tkt_enckdcre
│ │ │ │ -00002450: 7070 6172 747f 3237 3036 3735 0a52 6566  ppart.270675.Ref
│ │ │ │ -00002460: 3a20 7368 6973 6869 5f74 6b74 5f65 6e63  : shishi_tkt_enc
│ │ │ │ -00002470: 6b64 6372 6570 7061 7274 5f73 6574 7f32  kdcreppart_set.2
│ │ │ │ -00002480: 3730 3937 360a 5265 663a 2073 6869 7368  70976.Ref: shish
│ │ │ │ -00002490: 695f 746b 745f 6b64 6372 6570 7f32 3731  i_tkt_kdcrep.271
│ │ │ │ -000024a0: 3239 350a 5265 663a 2073 6869 7368 695f  295.Ref: shishi_
│ │ │ │ -000024b0: 746b 745f 656e 6374 6963 6b65 7470 6172  tkt_encticketpar
│ │ │ │ -000024c0: 747f 3237 3135 3635 0a52 6566 3a20 7368  t.271565.Ref: sh
│ │ │ │ -000024d0: 6973 6869 5f74 6b74 5f65 6e63 7469 636b  ishi_tkt_enctick
│ │ │ │ -000024e0: 6574 7061 7274 5f73 6574 7f32 3731 3836  etpart_set.27186
│ │ │ │ -000024f0: 330a 5265 663a 2073 6869 7368 695f 746b  3.Ref: shishi_tk
│ │ │ │ -00002500: 745f 6b65 797f 3237 3231 3534 0a52 6566  t_key.272154.Ref
│ │ │ │ -00002510: 3a20 7368 6973 6869 5f74 6b74 5f6b 6579  : shishi_tkt_key
│ │ │ │ -00002520: 5f73 6574 7f32 3732 3535 370a 5265 663a  _set.272557.Ref:
│ │ │ │ -00002530: 2073 6869 7368 695f 746b 745f 636c 6965   shishi_tkt_clie
│ │ │ │ -00002540: 6e74 7f32 3732 3836 370a 5265 663a 2073  nt.272867.Ref: s
│ │ │ │ -00002550: 6869 7368 695f 746b 745f 636c 6965 6e74  hishi_tkt_client
│ │ │ │ -00002560: 5f70 7f32 3733 3639 310a 5265 663a 2073  _p.273691.Ref: s
│ │ │ │ -00002570: 6869 7368 695f 746b 745f 636c 6965 6e74  hishi_tkt_client
│ │ │ │ -00002580: 7265 616c 6d7f 3237 3430 3434 0a52 6566  realm.274044.Ref
│ │ │ │ -00002590: 3a20 7368 6973 6869 5f74 6b74 5f63 6c69  : shishi_tkt_cli
│ │ │ │ -000025a0: 656e 7472 6561 6c6d 5f70 7f32 3734 3839  entrealm_p.27489
│ │ │ │ -000025b0: 350a 5265 663a 2073 6869 7368 695f 746b  5.Ref: shishi_tk
│ │ │ │ -000025c0: 745f 7265 616c 6d7f 3237 3532 3938 0a52  t_realm.275298.R
│ │ │ │ -000025d0: 6566 3a20 7368 6973 6869 5f74 6b74 5f73  ef: shishi_tkt_s
│ │ │ │ -000025e0: 6572 7665 727f 3237 3537 3431 0a52 6566  erver.275741.Ref
│ │ │ │ -000025f0: 3a20 7368 6973 6869 5f74 6b74 5f73 6572  : shishi_tkt_ser
│ │ │ │ -00002600: 7665 725f 707f 3237 3635 3537 0a52 6566  ver_p.276557.Ref
│ │ │ │ -00002610: 3a20 7368 6973 6869 5f74 6b74 5f66 6c61  : shishi_tkt_fla
│ │ │ │ -00002620: 6773 7f32 3736 3839 380a 5265 663a 2073  gs.276898.Ref: s
│ │ │ │ -00002630: 6869 7368 695f 746b 745f 666c 6167 735f  hishi_tkt_flags_
│ │ │ │ -00002640: 7365 747f 3237 3732 3331 0a52 6566 3a20  set.277231.Ref: 
│ │ │ │ -00002650: 7368 6973 6869 5f74 6b74 5f66 6c61 6773  shishi_tkt_flags
│ │ │ │ -00002660: 5f61 6464 7f32 3737 3635 300a 5265 663a  _add.277650.Ref:
│ │ │ │ -00002670: 2073 6869 7368 695f 746b 745f 666f 7277   shishi_tkt_forw
│ │ │ │ -00002680: 6172 6461 626c 655f 707f 3237 3830 3334  ardable_p.278034
│ │ │ │ -00002690: 0a52 6566 3a20 7368 6973 6869 5f74 6b74  .Ref: shishi_tkt
│ │ │ │ -000026a0: 5f66 6f72 7761 7264 6564 5f70 7f32 3738  _forwarded_p.278
│ │ │ │ -000026b0: 3834 360a 5265 663a 2073 6869 7368 695f  846.Ref: shishi_
│ │ │ │ -000026c0: 746b 745f 7072 6f78 6961 626c 655f 707f  tkt_proxiable_p.
│ │ │ │ -000026d0: 3237 3935 3639 0a52 6566 3a20 7368 6973  279569.Ref: shis
│ │ │ │ -000026e0: 6869 5f74 6b74 5f70 726f 7879 5f70 7f32  hi_tkt_proxy_p.2
│ │ │ │ -000026f0: 3830 3430 350a 5265 663a 2073 6869 7368  80405.Ref: shish
│ │ │ │ -00002700: 695f 746b 745f 6d61 795f 706f 7374 6461  i_tkt_may_postda
│ │ │ │ -00002710: 7465 5f70 7f32 3830 3935 380a 5265 663a  te_p.280958.Ref:
│ │ │ │ -00002720: 2073 6869 7368 695f 746b 745f 706f 7374   shishi_tkt_post
│ │ │ │ -00002730: 6461 7465 645f 707f 3238 3232 3534 0a52  dated_p.282254.R
│ │ │ │ -00002740: 6566 3a20 7368 6973 6869 5f74 6b74 5f69  ef: shishi_tkt_i
│ │ │ │ -00002750: 6e76 616c 6964 5f70 7f32 3833 3036 330a  nvalid_p.283063.
│ │ │ │ -00002760: 5265 663a 2073 6869 7368 695f 746b 745f  Ref: shishi_tkt_
│ │ │ │ -00002770: 7265 6e65 7761 626c 655f 707f 3238 3339  renewable_p.2839
│ │ │ │ -00002780: 3330 0a52 6566 3a20 7368 6973 6869 5f74  30.Ref: shishi_t
│ │ │ │ -00002790: 6b74 5f69 6e69 7469 616c 5f70 7f32 3834  kt_initial_p.284
│ │ │ │ -000027a0: 3439 350a 5265 663a 2073 6869 7368 695f  495.Ref: shishi_
│ │ │ │ -000027b0: 746b 745f 7072 655f 6175 7468 656e 745f  tkt_pre_authent_
│ │ │ │ -000027c0: 707f 3238 3532 3337 0a52 6566 3a20 7368  p.285237.Ref: sh
│ │ │ │ -000027d0: 6973 6869 5f74 6b74 5f68 775f 6175 7468  ishi_tkt_hw_auth
│ │ │ │ -000027e0: 656e 745f 707f 3238 3539 3539 0a52 6566  ent_p.285959.Ref
│ │ │ │ -000027f0: 3a20 7368 6973 6869 5f74 6b74 5f74 7261  : shishi_tkt_tra
│ │ │ │ -00002800: 6e73 6974 6564 5f70 6f6c 6963 795f 6368  nsited_policy_ch
│ │ │ │ -00002810: 6563 6b65 645f 707f 3238 3637 3235 0a52  ecked_p.286725.R
│ │ │ │ -00002820: 6566 3a20 7368 6973 6869 5f74 6b74 5f6f  ef: shishi_tkt_o
│ │ │ │ -00002830: 6b5f 6173 5f64 656c 6567 6174 655f 707f  k_as_delegate_p.
│ │ │ │ -00002840: 3238 3836 3034 0a52 6566 3a20 7368 6973  288604.Ref: shis
│ │ │ │ -00002850: 6869 5f74 6b74 5f6b 6579 7479 7065 7f32  hi_tkt_keytype.2
│ │ │ │ -00002860: 3839 3635 330a 5265 663a 2073 6869 7368  89653.Ref: shish
│ │ │ │ -00002870: 695f 746b 745f 6b65 7974 7970 655f 6661  i_tkt_keytype_fa
│ │ │ │ -00002880: 7374 7f32 3930 3033 360a 5265 663a 2073  st.290036.Ref: s
│ │ │ │ -00002890: 6869 7368 695f 746b 745f 6b65 7974 7970  hishi_tkt_keytyp
│ │ │ │ -000028a0: 655f 707f 3239 3033 3935 0a52 6566 3a20  e_p.290395.Ref: 
│ │ │ │ -000028b0: 7368 6973 6869 5f74 6b74 5f6c 6173 7472  shishi_tkt_lastr
│ │ │ │ -000028c0: 6571 637f 3239 3038 3139 0a52 6566 3a20  eqc.290819.Ref: 
│ │ │ │ -000028d0: 7368 6973 6869 5f74 6b74 5f61 7574 6863  shishi_tkt_authc
│ │ │ │ -000028e0: 7469 6d65 7f32 3931 3239 380a 5265 663a  time.291298.Ref:
│ │ │ │ -000028f0: 2073 6869 7368 695f 746b 745f 7374 6172   shishi_tkt_star
│ │ │ │ -00002900: 7463 7469 6d65 7f32 3931 3731 390a 5265  tctime.291719.Re
│ │ │ │ -00002910: 663a 2073 6869 7368 695f 746b 745f 656e  f: shishi_tkt_en
│ │ │ │ -00002920: 6463 7469 6d65 7f32 3932 3131 380a 5265  dctime.292118.Re
│ │ │ │ -00002930: 663a 2073 6869 7368 695f 746b 745f 7265  f: shishi_tkt_re
│ │ │ │ -00002940: 6e65 775f 7469 6c6c 637f 3239 3234 3839  new_tillc.292489
│ │ │ │ -00002950: 0a52 6566 3a20 7368 6973 6869 5f74 6b74  .Ref: shishi_tkt
│ │ │ │ -00002960: 5f76 616c 6964 5f61 745f 7469 6d65 5f70  _valid_at_time_p
│ │ │ │ -00002970: 7f32 3932 3839 350a 5265 663a 2073 6869  .292895.Ref: shi
│ │ │ │ -00002980: 7368 695f 746b 745f 7661 6c69 645f 6e6f  shi_tkt_valid_no
│ │ │ │ -00002990: 775f 707f 3239 3332 3939 0a52 6566 3a20  w_p.293299.Ref: 
│ │ │ │ -000029a0: 7368 6973 6869 5f74 6b74 5f65 7870 6972  shishi_tkt_expir
│ │ │ │ -000029b0: 6564 5f70 7f32 3933 3538 380a 5265 663a  ed_p.293588.Ref:
│ │ │ │ -000029c0: 2073 6869 7368 695f 746b 745f 6c61 7374   shishi_tkt_last
│ │ │ │ -000029d0: 7265 715f 7072 6574 7479 5f70 7269 6e74  req_pretty_print
│ │ │ │ -000029e0: 7f32 3933 3930 310a 5265 663a 2073 6869  .293901.Ref: shi
│ │ │ │ -000029f0: 7368 695f 746b 745f 7072 6574 7479 5f70  shi_tkt_pretty_p
│ │ │ │ -00002a00: 7269 6e74 7f32 3934 3235 360a 4e6f 6465  rint.294256.Node
│ │ │ │ -00002a10: 3a20 4153 2046 756e 6374 696f 6e73 7f32  : AS Functions.2
│ │ │ │ -00002a20: 3934 3530 340a 5265 663a 2073 6869 7368  94504.Ref: shish
│ │ │ │ -00002a30: 695f 6173 7f32 3936 3634 350a 5265 663a  i_as.296645.Ref:
│ │ │ │ -00002a40: 2073 6869 7368 695f 6173 5f64 6f6e 657f   shishi_as_done.
│ │ │ │ -00002a50: 3239 3639 3830 0a52 6566 3a20 7368 6973  296980.Ref: shis
│ │ │ │ -00002a60: 6869 5f61 735f 7265 717f 3239 3733 3031  hi_as_req.297301
│ │ │ │ -00002a70: 0a52 6566 3a20 7368 6973 6869 5f61 735f  .Ref: shishi_as_
│ │ │ │ -00002a80: 7265 715f 6275 696c 647f 3239 3736 3535  req_build.297655
│ │ │ │ -00002a90: 0a52 6566 3a20 7368 6973 6869 5f61 735f  .Ref: shishi_as_
│ │ │ │ -00002aa0: 7265 715f 7365 747f 3239 3739 3239 0a52  req_set.297929.R
│ │ │ │ -00002ab0: 6566 3a20 7368 6973 6869 5f61 735f 7265  ef: shishi_as_re
│ │ │ │ -00002ac0: 715f 6465 727f 3239 3831 3930 0a52 6566  q_der.298190.Ref
│ │ │ │ -00002ad0: 3a20 7368 6973 6869 5f61 735f 7265 715f  : shishi_as_req_
│ │ │ │ -00002ae0: 6465 725f 7365 747f 3239 3837 3135 0a52  der_set.298715.R
│ │ │ │ -00002af0: 6566 3a20 7368 6973 6869 5f61 735f 7265  ef: shishi_as_re
│ │ │ │ -00002b00: 707f 3239 3931 3734 0a52 6566 3a20 7368  p.299174.Ref: sh
│ │ │ │ -00002b10: 6973 6869 5f61 735f 7265 705f 7072 6f63  ishi_as_rep_proc
│ │ │ │ -00002b20: 6573 737f 3239 3935 3331 0a52 6566 3a20  ess.299531.Ref: 
│ │ │ │ -00002b30: 7368 6973 6869 5f61 735f 7265 705f 6275  shishi_as_rep_bu
│ │ │ │ -00002b40: 696c 647f 3330 3030 3930 0a52 6566 3a20  ild.300090.Ref: 
│ │ │ │ -00002b50: 7368 6973 6869 5f61 735f 7265 705f 6465  shishi_as_rep_de
│ │ │ │ -00002b60: 727f 3330 3034 3234 0a52 6566 3a20 7368  r.300424.Ref: sh
│ │ │ │ -00002b70: 6973 6869 5f61 735f 7265 705f 7365 747f  ishi_as_rep_set.
│ │ │ │ -00002b80: 3330 3039 3431 0a52 6566 3a20 7368 6973  300941.Ref: shis
│ │ │ │ -00002b90: 6869 5f61 735f 7265 705f 6465 725f 7365  hi_as_rep_der_se
│ │ │ │ -00002ba0: 747f 3330 3132 3130 0a52 6566 3a20 7368  t.301210.Ref: sh
│ │ │ │ -00002bb0: 6973 6869 5f61 735f 6b72 6265 7272 6f72  ishi_as_krberror
│ │ │ │ -00002bc0: 7f33 3031 3637 390a 5265 663a 2073 6869  .301679.Ref: shi
│ │ │ │ -00002bd0: 7368 695f 6173 5f6b 7262 6572 726f 725f  shi_as_krberror_
│ │ │ │ -00002be0: 6465 727f 3330 3230 3439 0a52 6566 3a20  der.302049.Ref: 
│ │ │ │ -00002bf0: 7368 6973 6869 5f61 735f 6b72 6265 7272  shishi_as_krberr
│ │ │ │ -00002c00: 6f72 5f73 6574 7f33 3032 3539 300a 5265  or_set.302590.Re
│ │ │ │ -00002c10: 663a 2073 6869 7368 695f 6173 5f74 6b74  f: shishi_as_tkt
│ │ │ │ -00002c20: 7f33 3032 3837 300a 5265 663a 2073 6869  .302870.Ref: shi
│ │ │ │ -00002c30: 7368 695f 6173 5f74 6b74 5f73 6574 7f33  shi_as_tkt_set.3
│ │ │ │ -00002c40: 3033 3139 380a 5265 663a 2073 6869 7368  03198.Ref: shish
│ │ │ │ -00002c50: 695f 6173 5f73 656e 6472 6563 765f 6869  i_as_sendrecv_hi
│ │ │ │ -00002c60: 6e74 7f33 3033 3436 330a 5265 663a 2073  nt.303463.Ref: s
│ │ │ │ -00002c70: 6869 7368 695f 6173 5f73 656e 6472 6563  hishi_as_sendrec
│ │ │ │ -00002c80: 767f 3330 3430 3438 0a4e 6f64 653a 2054  v.304048.Node: T
│ │ │ │ -00002c90: 4753 2046 756e 6374 696f 6e73 7f33 3035  GS Functions.305
│ │ │ │ -00002ca0: 3231 380a 5265 663a 2073 6869 7368 695f  218.Ref: shishi_
│ │ │ │ -00002cb0: 7467 737f 3330 3734 3731 0a52 6566 3a20  tgs.307471.Ref: 
│ │ │ │ -00002cc0: 7368 6973 6869 5f74 6773 5f64 6f6e 657f  shishi_tgs_done.
│ │ │ │ -00002cd0: 3330 3738 3134 0a52 6566 3a20 7368 6973  307814.Ref: shis
│ │ │ │ -00002ce0: 6869 5f74 6773 5f74 6774 6b74 7f33 3038  hi_tgs_tgtkt.308
│ │ │ │ -00002cf0: 3134 370a 5265 663a 2073 6869 7368 695f  147.Ref: shishi_
│ │ │ │ -00002d00: 7467 735f 7467 746b 745f 7365 747f 3330  tgs_tgtkt_set.30
│ │ │ │ -00002d10: 3835 3135 0a52 6566 3a20 7368 6973 6869  8515.Ref: shishi
│ │ │ │ -00002d20: 5f74 6773 5f61 707f 3330 3838 3035 0a52  _tgs_ap.308805.R
│ │ │ │ -00002d30: 6566 3a20 7368 6973 6869 5f74 6773 5f72  ef: shishi_tgs_r
│ │ │ │ -00002d40: 6571 7f33 3039 3134 350a 5265 663a 2073  eq.309145.Ref: s
│ │ │ │ -00002d50: 6869 7368 695f 7467 735f 7265 715f 7365  hishi_tgs_req_se
│ │ │ │ -00002d60: 747f 3330 3934 3837 0a52 6566 3a20 7368  t.309487.Ref: sh
│ │ │ │ -00002d70: 6973 6869 5f74 6773 5f72 6571 5f64 6572  ishi_tgs_req_der
│ │ │ │ -00002d80: 7f33 3039 3737 310a 5265 663a 2073 6869  .309771.Ref: shi
│ │ │ │ -00002d90: 7368 695f 7467 735f 7265 715f 6465 725f  shi_tgs_req_der_
│ │ │ │ -00002da0: 7365 747f 3331 3033 3036 0a52 6566 3a20  set.310306.Ref: 
│ │ │ │ -00002db0: 7368 6973 6869 5f74 6773 5f72 6571 5f70  shishi_tgs_req_p
│ │ │ │ -00002dc0: 726f 6365 7373 7f33 3130 3739 320a 5265  rocess.310792.Re
│ │ │ │ -00002dd0: 663a 2073 6869 7368 695f 7467 735f 7265  f: shishi_tgs_re
│ │ │ │ -00002de0: 715f 6275 696c 647f 3331 3131 3636 0a52  q_build.311166.R
│ │ │ │ -00002df0: 6566 3a20 7368 6973 6869 5f74 6773 5f72  ef: shishi_tgs_r
│ │ │ │ -00002e00: 6570 7f33 3131 3437 360a 5265 663a 2073  ep.311476.Ref: s
│ │ │ │ -00002e10: 6869 7368 695f 7467 735f 7265 705f 6465  hishi_tgs_rep_de
│ │ │ │ -00002e20: 727f 3331 3138 3133 0a52 6566 3a20 7368  r.311813.Ref: sh
│ │ │ │ -00002e30: 6973 6869 5f74 6773 5f72 6570 5f70 726f  ishi_tgs_rep_pro
│ │ │ │ -00002e40: 6365 7373 7f33 3132 3334 380a 5265 663a  cess.312348.Ref:
│ │ │ │ -00002e50: 2073 6869 7368 695f 7467 735f 7265 705f   shishi_tgs_rep_
│ │ │ │ -00002e60: 6275 696c 647f 3331 3237 3232 0a52 6566  build.312722.Ref
│ │ │ │ -00002e70: 3a20 7368 6973 6869 5f74 6773 5f6b 7262  : shishi_tgs_krb
│ │ │ │ -00002e80: 6572 726f 727f 3331 3331 3234 0a52 6566  error.313124.Ref
│ │ │ │ -00002e90: 3a20 7368 6973 6869 5f74 6773 5f6b 7262  : shishi_tgs_krb
│ │ │ │ -00002ea0: 6572 726f 725f 6465 727f 3331 3334 3738  error_der.313478
│ │ │ │ -00002eb0: 0a52 6566 3a20 7368 6973 6869 5f74 6773  .Ref: shishi_tgs
│ │ │ │ -00002ec0: 5f6b 7262 6572 726f 725f 7365 747f 3331  _krberror_set.31
│ │ │ │ -00002ed0: 3430 3236 0a52 6566 3a20 7368 6973 6869  4026.Ref: shishi
│ │ │ │ -00002ee0: 5f74 6773 5f74 6b74 7f33 3134 3331 350a  _tgs_tkt.314315.
│ │ │ │ -00002ef0: 5265 663a 2073 6869 7368 695f 7467 735f  Ref: shishi_tgs_
│ │ │ │ -00002f00: 746b 745f 7365 747f 3331 3436 3537 0a52  tkt_set.314657.R
│ │ │ │ -00002f10: 6566 3a20 7368 6973 6869 5f74 6773 5f73  ef: shishi_tgs_s
│ │ │ │ -00002f20: 656e 6472 6563 765f 6869 6e74 7f33 3134  endrecv_hint.314
│ │ │ │ -00002f30: 3934 370a 5265 663a 2073 6869 7368 695f  947.Ref: shishi_
│ │ │ │ -00002f40: 7467 735f 7365 6e64 7265 6376 7f33 3135  tgs_sendrecv.315
│ │ │ │ -00002f50: 3533 340a 5265 663a 2073 6869 7368 695f  534.Ref: shishi_
│ │ │ │ -00002f60: 7467 735f 7365 745f 7365 7276 6572 7f33  tgs_set_server.3
│ │ │ │ -00002f70: 3135 3931 320a 5265 663a 2073 6869 7368  15912.Ref: shish
│ │ │ │ -00002f80: 695f 7467 735f 7365 745f 7265 616c 6d7f  i_tgs_set_realm.
│ │ │ │ -00002f90: 3331 3632 3733 0a52 6566 3a20 7368 6973  316273.Ref: shis
│ │ │ │ -00002fa0: 6869 5f74 6773 5f73 6574 5f72 6561 6c6d  hi_tgs_set_realm
│ │ │ │ -00002fb0: 7365 7276 6572 7f33 3136 3634 320a 4e6f  server.316642.No
│ │ │ │ -00002fc0: 6465 3a20 5469 636b 6574 2028 4153 4e2e  de: Ticket (ASN.
│ │ │ │ -00002fd0: 3129 2046 756e 6374 696f 6e73 7f33 3137  1) Functions.317
│ │ │ │ -00002fe0: 3035 300a 5265 663a 2073 6869 7368 695f  050.Ref: shishi_
│ │ │ │ -00002ff0: 7469 636b 6574 7f33 3138 3330 310a 5265  ticket.318301.Re
│ │ │ │ -00003000: 663a 2073 6869 7368 695f 7469 636b 6574  f: shishi_ticket
│ │ │ │ -00003010: 5f72 6561 6c6d 5f67 6574 7f33 3138 3633  _realm_get.31863
│ │ │ │ -00003020: 380a 5265 663a 2073 6869 7368 695f 7469  8.Ref: shishi_ti
│ │ │ │ -00003030: 636b 6574 5f72 6561 6c6d 5f73 6574 7f33  cket_realm_set.3
│ │ │ │ -00003040: 3139 3133 340a 5265 663a 2073 6869 7368  19134.Ref: shish
│ │ │ │ -00003050: 695f 7469 636b 6574 5f73 6572 7665 727f  i_ticket_server.
│ │ │ │ -00003060: 3331 3935 3534 0a52 6566 3a20 7368 6973  319554.Ref: shis
│ │ │ │ -00003070: 6869 5f74 6963 6b65 745f 736e 616d 655f  hi_ticket_sname_
│ │ │ │ -00003080: 7365 747f 3332 3034 3833 0a52 6566 3a20  set.320483.Ref: 
│ │ │ │ -00003090: 7368 6973 6869 5f74 6963 6b65 745f 6765  shishi_ticket_ge
│ │ │ │ -000030a0: 745f 656e 635f 7061 7274 5f65 7479 7065  t_enc_part_etype
│ │ │ │ -000030b0: 7f33 3231 3037 300a 5265 663a 2073 6869  .321070.Ref: shi
│ │ │ │ -000030c0: 7368 695f 7469 636b 6574 5f73 6574 5f65  shi_ticket_set_e
│ │ │ │ -000030d0: 6e63 5f70 6172 747f 3332 3135 3132 0a52  nc_part.321512.R
│ │ │ │ -000030e0: 6566 3a20 7368 6973 6869 5f74 6963 6b65  ef: shishi_ticke
│ │ │ │ -000030f0: 745f 6164 645f 656e 635f 7061 7274 7f33  t_add_enc_part.3
│ │ │ │ -00003100: 3232 3433 330a 5265 663a 2073 6869 7368  22433.Ref: shish
│ │ │ │ -00003110: 695f 656e 6374 6963 6b65 7470 6172 745f  i_encticketpart_
│ │ │ │ -00003120: 6765 745f 6b65 797f 3332 3239 3839 0a52  get_key.322989.R
│ │ │ │ -00003130: 6566 3a20 7368 6973 6869 5f65 6e63 7469  ef: shishi_encti
│ │ │ │ -00003140: 636b 6574 7061 7274 5f6b 6579 5f73 6574  cketpart_key_set
│ │ │ │ -00003150: 7f33 3233 3433 370a 5265 663a 2073 6869  .323437.Ref: shi
│ │ │ │ -00003160: 7368 695f 656e 6374 6963 6b65 7470 6172  shi_encticketpar
│ │ │ │ -00003170: 745f 666c 6167 735f 7365 747f 3332 3339  t_flags_set.3239
│ │ │ │ -00003180: 3539 0a52 6566 3a20 7368 6973 6869 5f65  59.Ref: shishi_e
│ │ │ │ -00003190: 6e63 7469 636b 6574 7061 7274 5f63 7265  ncticketpart_cre
│ │ │ │ -000031a0: 616c 6d5f 7365 747f 3332 3434 3237 0a52  alm_set.324427.R
│ │ │ │ -000031b0: 6566 3a20 7368 6973 6869 5f65 6e63 7469  ef: shishi_encti
│ │ │ │ -000031c0: 636b 6574 7061 7274 5f63 6e61 6d65 5f73  cketpart_cname_s
│ │ │ │ -000031d0: 6574 7f33 3234 3838 370a 5265 663a 2073  et.324887.Ref: s
│ │ │ │ -000031e0: 6869 7368 695f 656e 6374 6963 6b65 7470  hishi_encticketp
│ │ │ │ -000031f0: 6172 745f 7472 616e 7369 7465 645f 7365  art_transited_se
│ │ │ │ -00003200: 747f 3332 3535 3033 0a52 6566 3a20 7368  t.325503.Ref: sh
│ │ │ │ -00003210: 6973 6869 5f65 6e63 7469 636b 6574 7061  ishi_encticketpa
│ │ │ │ -00003220: 7274 5f61 7574 6874 696d 655f 7365 747f  rt_authtime_set.
│ │ │ │ -00003230: 3332 3631 3831 0a52 6566 3a20 7368 6973  326181.Ref: shis
│ │ │ │ -00003240: 6869 5f65 6e63 7469 636b 6574 7061 7274  hi_encticketpart
│ │ │ │ -00003250: 5f65 6e64 7469 6d65 5f73 6574 7f33 3236  _endtime_set.326
│ │ │ │ -00003260: 3639 360a 5265 663a 2073 6869 7368 695f  696.Ref: shishi_
│ │ │ │ -00003270: 656e 6374 6963 6b65 7470 6172 745f 636c  encticketpart_cl
│ │ │ │ -00003280: 6965 6e74 7f33 3237 3139 370a 5265 663a  ient.327197.Ref:
│ │ │ │ -00003290: 2073 6869 7368 695f 656e 6374 6963 6b65   shishi_encticke
│ │ │ │ -000032a0: 7470 6172 745f 636c 6965 6e74 7265 616c  tpart_clientreal
│ │ │ │ -000032b0: 6d7f 3332 3831 3733 0a4e 6f64 653a 2041  m.328173.Node: A
│ │ │ │ -000032c0: 532f 5447 5320 4675 6e63 7469 6f6e 737f  S/TGS Functions.
│ │ │ │ -000032d0: 3332 3931 3232 0a52 6566 3a20 7368 6973  329122.Ref: shis
│ │ │ │ -000032e0: 6869 5f61 735f 6465 7269 7665 5f73 616c  hi_as_derive_sal
│ │ │ │ -000032f0: 747f 3333 3231 3839 0a52 6566 3a20 7368  t.332189.Ref: sh
│ │ │ │ -00003300: 6973 6869 5f6b 6463 7265 715f 7365 6e64  ishi_kdcreq_send
│ │ │ │ -00003310: 7265 6376 5f68 696e 747f 3333 3331 3639  recv_hint.333169
│ │ │ │ -00003320: 0a52 6566 3a20 7368 6973 6869 5f6b 6463  .Ref: shishi_kdc
│ │ │ │ -00003330: 7265 715f 7365 6e64 7265 6376 7f33 3334  req_sendrecv.334
│ │ │ │ -00003340: 3036 340a 5265 663a 2073 6869 7368 695f  064.Ref: shishi_
│ │ │ │ -00003350: 6b64 635f 636f 7079 5f63 7265 616c 6d7f  kdc_copy_crealm.
│ │ │ │ -00003360: 3333 3438 3237 0a52 6566 3a20 7368 6973  334827.Ref: shis
│ │ │ │ -00003370: 6869 5f61 735f 6368 6563 6b5f 6372 6561  hi_as_check_crea
│ │ │ │ -00003380: 6c6d 7f33 3335 3339 340a 5265 663a 2073  lm.335394.Ref: s
│ │ │ │ -00003390: 6869 7368 695f 6b64 635f 636f 7079 5f63  hishi_kdc_copy_c
│ │ │ │ -000033a0: 6e61 6d65 7f33 3336 3133 320a 5265 663a  name.336132.Ref:
│ │ │ │ -000033b0: 2073 6869 7368 695f 6173 5f63 6865 636b   shishi_as_check
│ │ │ │ -000033c0: 5f63 6e61 6d65 7f33 3336 3639 330a 5265  _cname.336693.Re
│ │ │ │ -000033d0: 663a 2073 6869 7368 695f 6b64 635f 636f  f: shishi_kdc_co
│ │ │ │ -000033e0: 7079 5f6e 6f6e 6365 7f33 3337 3431 310a  py_nonce.337411.
│ │ │ │ -000033f0: 5265 663a 2073 6869 7368 695f 6b64 635f  Ref: shishi_kdc_
│ │ │ │ -00003400: 6368 6563 6b5f 6e6f 6e63 657f 3333 3739  check_nonce.3379
│ │ │ │ -00003410: 3338 0a52 6566 3a20 7368 6973 6869 5f74  38.Ref: shishi_t
│ │ │ │ -00003420: 6773 5f70 726f 6365 7373 7f33 3338 3736  gs_process.33876
│ │ │ │ -00003430: 300a 5265 663a 2073 6869 7368 695f 6173  0.Ref: shishi_as
│ │ │ │ -00003440: 5f70 726f 6365 7373 7f33 3339 3839 320a  _process.339892.
│ │ │ │ -00003450: 5265 663a 2073 6869 7368 695f 6b64 635f  Ref: shishi_kdc_
│ │ │ │ -00003460: 7072 6f63 6573 737f 3334 3038 3031 0a52  process.340801.R
│ │ │ │ -00003470: 6566 3a20 7368 6973 6869 5f61 7372 6571  ef: shishi_asreq
│ │ │ │ -00003480: 7f33 3432 3232 390a 5265 663a 2073 6869  .342229.Ref: shi
│ │ │ │ -00003490: 7368 695f 7467 7372 6571 7f33 3432 3533  shi_tgsreq.34253
│ │ │ │ -000034a0: 390a 5265 663a 2073 6869 7368 695f 6b64  9.Ref: shishi_kd
│ │ │ │ -000034b0: 6372 6571 5f70 7269 6e74 7f33 3432 3836  creq_print.34286
│ │ │ │ -000034c0: 340a 5265 663a 2073 6869 7368 695f 6b64  4.Ref: shishi_kd
│ │ │ │ -000034d0: 6372 6571 5f73 6176 657f 3334 3332 3635  creq_save.343265
│ │ │ │ -000034e0: 0a52 6566 3a20 7368 6973 6869 5f6b 6463  .Ref: shishi_kdc
│ │ │ │ -000034f0: 7265 715f 746f 5f66 696c 657f 3334 3336  req_to_file.3436
│ │ │ │ -00003500: 3536 0a52 6566 3a20 7368 6973 6869 5f6b  56.Ref: shishi_k
│ │ │ │ -00003510: 6463 7265 715f 7061 7273 657f 3334 3432  dcreq_parse.3442
│ │ │ │ -00003520: 3333 0a52 6566 3a20 7368 6973 6869 5f6b  33.Ref: shishi_k
│ │ │ │ -00003530: 6463 7265 715f 7265 6164 7f33 3434 3639  dcreq_read.34469
│ │ │ │ -00003540: 340a 5265 663a 2073 6869 7368 695f 6b64  4.Ref: shishi_kd
│ │ │ │ -00003550: 6372 6571 5f66 726f 6d5f 6669 6c65 7f33  creq_from_file.3
│ │ │ │ -00003560: 3435 3135 300a 5265 663a 2073 6869 7368  45150.Ref: shish
│ │ │ │ -00003570: 695f 6b64 6372 6571 5f6e 6f6e 6365 5f73  i_kdcreq_nonce_s
│ │ │ │ -00003580: 6574 7f33 3435 3732 310a 5265 663a 2073  et.345721.Ref: s
│ │ │ │ -00003590: 6869 7368 695f 6b64 6372 6571 5f73 6574  hishi_kdcreq_set
│ │ │ │ -000035a0: 5f63 6e61 6d65 7f33 3436 3136 370a 5265  _cname.346167.Re
│ │ │ │ -000035b0: 663a 2073 6869 7368 695f 6b64 6372 6571  f: shishi_kdcreq
│ │ │ │ -000035c0: 5f63 6c69 656e 747f 3334 3637 3434 0a52  _client.346744.R
│ │ │ │ -000035d0: 6566 3a20 7368 6973 6869 5f61 7372 6571  ef: shishi_asreq
│ │ │ │ -000035e0: 5f63 6c69 656e 7472 6561 6c6d 7f33 3437  _clientrealm.347
│ │ │ │ -000035f0: 3637 310a 5265 663a 2073 6869 7368 695f  671.Ref: shishi_
│ │ │ │ -00003600: 6b64 6372 6571 5f72 6561 6c6d 7f33 3438  kdcreq_realm.348
│ │ │ │ -00003610: 3631 380a 5265 663a 2073 6869 7368 695f  618.Ref: shishi_
│ │ │ │ -00003620: 6b64 6372 6571 5f73 6574 5f72 6561 6c6d  kdcreq_set_realm
│ │ │ │ -00003630: 7f33 3439 3530 320a 5265 663a 2073 6869  .349502.Ref: shi
│ │ │ │ -00003640: 7368 695f 6b64 6372 6571 5f73 6572 7665  shi_kdcreq_serve
│ │ │ │ -00003650: 727f 3334 3939 3330 0a52 6566 3a20 7368  r.349930.Ref: sh
│ │ │ │ -00003660: 6973 6869 5f6b 6463 7265 715f 7365 745f  ishi_kdcreq_set_
│ │ │ │ -00003670: 736e 616d 657f 3335 3038 3535 0a52 6566  sname.350855.Ref
│ │ │ │ -00003680: 3a20 7368 6973 6869 5f6b 6463 7265 715f  : shishi_kdcreq_
│ │ │ │ -00003690: 7469 6c6c 7f33 3531 3432 320a 5265 663a  till.351422.Ref:
│ │ │ │ -000036a0: 2073 6869 7368 695f 6b64 6372 6571 5f74   shishi_kdcreq_t
│ │ │ │ -000036b0: 696c 6c63 7f33 3532 3339 300a 5265 663a  illc.352390.Ref:
│ │ │ │ -000036c0: 2073 6869 7368 695f 6b64 6372 6571 5f65   shishi_kdcreq_e
│ │ │ │ -000036d0: 7479 7065 7f33 3532 3830 380a 5265 663a  type.352808.Ref:
│ │ │ │ -000036e0: 2073 6869 7368 695f 6b64 6372 6571 5f73   shishi_kdcreq_s
│ │ │ │ -000036f0: 6574 5f65 7479 7065 7f33 3533 3332 370a  et_etype.353327.
│ │ │ │ -00003700: 5265 663a 2073 6869 7368 695f 6b64 6372  Ref: shishi_kdcr
│ │ │ │ -00003710: 6571 5f6f 7074 696f 6e73 7f33 3533 3932  eq_options.35392
│ │ │ │ -00003720: 330a 5265 663a 2073 6869 7368 695f 6b64  3.Ref: shishi_kd
│ │ │ │ -00003730: 6372 6571 5f66 6f72 7761 7264 6162 6c65  creq_forwardable
│ │ │ │ -00003740: 5f70 7f33 3534 3337 330a 5265 663a 2073  _p.354373.Ref: s
│ │ │ │ -00003750: 6869 7368 695f 6b64 6372 6571 5f66 6f72  hishi_kdcreq_for
│ │ │ │ -00003760: 7761 7264 6564 5f70 7f33 3535 3036 300a  warded_p.355060.
│ │ │ │ -00003770: 5265 663a 2073 6869 7368 695f 6b64 6372  Ref: shishi_kdcr
│ │ │ │ -00003780: 6571 5f70 726f 7869 6162 6c65 5f70 7f33  eq_proxiable_p.3
│ │ │ │ -00003790: 3535 3837 340a 5265 663a 2073 6869 7368  55874.Ref: shish
│ │ │ │ -000037a0: 695f 6b64 6372 6571 5f70 726f 7879 5f70  i_kdcreq_proxy_p
│ │ │ │ -000037b0: 7f33 3536 3533 360a 5265 663a 2073 6869  .356536.Ref: shi
│ │ │ │ -000037c0: 7368 695f 6b64 6372 6571 5f61 6c6c 6f77  shi_kdcreq_allow
│ │ │ │ -000037d0: 5f70 6f73 7464 6174 655f 707f 3335 3732  _postdate_p.3572
│ │ │ │ -000037e0: 3639 0a52 6566 3a20 7368 6973 6869 5f6b  69.Ref: shishi_k
│ │ │ │ -000037f0: 6463 7265 715f 706f 7374 6461 7465 645f  dcreq_postdated_
│ │ │ │ -00003800: 707f 3335 3739 3834 0a52 6566 3a20 7368  p.357984.Ref: sh
│ │ │ │ -00003810: 6973 6869 5f6b 6463 7265 715f 7265 6e65  ishi_kdcreq_rene
│ │ │ │ -00003820: 7761 626c 655f 707f 3335 3837 3935 0a52  wable_p.358795.R
│ │ │ │ -00003830: 6566 3a20 7368 6973 6869 5f6b 6463 7265  ef: shishi_kdcre
│ │ │ │ -00003840: 715f 6469 7361 626c 655f 7472 616e 7369  q_disable_transi
│ │ │ │ -00003850: 7465 645f 6368 6563 6b5f 707f 3335 3936  ted_check_p.3596
│ │ │ │ -00003860: 3138 0a52 6566 3a20 7368 6973 6869 5f6b  18.Ref: shishi_k
│ │ │ │ -00003870: 6463 7265 715f 7265 6e65 7761 626c 655f  dcreq_renewable_
│ │ │ │ -00003880: 6f6b 5f70 7f33 3630 3735 320a 5265 663a  ok_p.360752.Ref:
│ │ │ │ -00003890: 2073 6869 7368 695f 6b64 6372 6571 5f65   shishi_kdcreq_e
│ │ │ │ -000038a0: 6e63 5f74 6b74 5f69 6e5f 736b 6579 5f70  nc_tkt_in_skey_p
│ │ │ │ -000038b0: 7f33 3631 3634 360a 5265 663a 2073 6869  .361646.Ref: shi
│ │ │ │ -000038c0: 7368 695f 6b64 6372 6571 5f72 656e 6577  shi_kdcreq_renew
│ │ │ │ -000038d0: 5f70 7f33 3632 3331 360a 5265 663a 2073  _p.362316.Ref: s
│ │ │ │ -000038e0: 6869 7368 695f 6b64 6372 6571 5f76 616c  hishi_kdcreq_val
│ │ │ │ -000038f0: 6964 6174 655f 707f 3336 3332 3037 0a52  idate_p.363207.R
│ │ │ │ -00003900: 6566 3a20 7368 6973 6869 5f6b 6463 7265  ef: shishi_kdcre
│ │ │ │ -00003910: 715f 6f70 7469 6f6e 735f 7365 747f 3336  q_options_set.36
│ │ │ │ -00003920: 3431 3632 0a52 6566 3a20 7368 6973 6869  4162.Ref: shishi
│ │ │ │ -00003930: 5f6b 6463 7265 715f 6f70 7469 6f6e 735f  _kdcreq_options_
│ │ │ │ -00003940: 6164 647f 3336 3436 3532 0a52 6566 3a20  add.364652.Ref: 
│ │ │ │ -00003950: 7368 6973 6869 5f6b 6463 7265 715f 636c  shishi_kdcreq_cl
│ │ │ │ -00003960: 6561 725f 7061 6461 7461 7f33 3635 3133  ear_padata.36513
│ │ │ │ -00003970: 330a 5265 663a 2073 6869 7368 695f 6b64  3.Ref: shishi_kd
│ │ │ │ -00003980: 6372 6571 5f67 6574 5f70 6164 6174 617f  creq_get_padata.
│ │ │ │ -00003990: 3336 3535 3032 0a52 6566 3a20 7368 6973  365502.Ref: shis
│ │ │ │ -000039a0: 6869 5f6b 6463 7265 715f 6765 745f 7061  hi_kdcreq_get_pa
│ │ │ │ -000039b0: 6461 7461 5f74 6773 7f33 3636 3332 310a  data_tgs.366321.
│ │ │ │ -000039c0: 5265 663a 2073 6869 7368 695f 6b64 6372  Ref: shishi_kdcr
│ │ │ │ -000039d0: 6571 5f61 6464 5f70 6164 6174 617f 3336  eq_add_padata.36
│ │ │ │ -000039e0: 3639 3736 0a52 6566 3a20 7368 6973 6869  6976.Ref: shishi
│ │ │ │ -000039f0: 5f6b 6463 7265 715f 6164 645f 7061 6461  _kdcreq_add_pada
│ │ │ │ -00003a00: 7461 5f74 6773 7f33 3637 3834 310a 5265  ta_tgs.367841.Re
│ │ │ │ -00003a10: 663a 2073 6869 7368 695f 6b64 6372 6571  f: shishi_kdcreq
│ │ │ │ -00003a20: 5f61 6464 5f70 6164 6174 615f 7072 6561  _add_padata_prea
│ │ │ │ -00003a30: 7574 687f 3336 3834 3831 0a52 6566 3a20  uth.368481.Ref: 
│ │ │ │ -00003a40: 7368 6973 6869 5f61 7372 6570 7f33 3638  shishi_asrep.368
│ │ │ │ -00003a50: 3930 380a 5265 663a 2073 6869 7368 695f  908.Ref: shishi_
│ │ │ │ -00003a60: 7467 7372 6570 7f33 3639 3231 380a 5265  tgsrep.369218.Re
│ │ │ │ -00003a70: 663a 2073 6869 7368 695f 6b64 6372 6570  f: shishi_kdcrep
│ │ │ │ -00003a80: 5f70 7269 6e74 7f33 3639 3534 330a 5265  _print.369543.Re
│ │ │ │ -00003a90: 663a 2073 6869 7368 695f 6b64 6372 6570  f: shishi_kdcrep
│ │ │ │ -00003aa0: 5f73 6176 657f 3336 3939 3434 0a52 6566  _save.369944.Ref
│ │ │ │ -00003ab0: 3a20 7368 6973 6869 5f6b 6463 7265 705f  : shishi_kdcrep_
│ │ │ │ -00003ac0: 746f 5f66 696c 657f 3337 3033 3335 0a52  to_file.370335.R
│ │ │ │ -00003ad0: 6566 3a20 7368 6973 6869 5f6b 6463 7265  ef: shishi_kdcre
│ │ │ │ -00003ae0: 705f 7061 7273 657f 3337 3039 3132 0a52  p_parse.370912.R
│ │ │ │ -00003af0: 6566 3a20 7368 6973 6869 5f6b 6463 7265  ef: shishi_kdcre
│ │ │ │ -00003b00: 705f 7265 6164 7f33 3731 3337 330a 5265  p_read.371373.Re
│ │ │ │ -00003b10: 663a 2073 6869 7368 695f 6b64 6372 6570  f: shishi_kdcrep
│ │ │ │ -00003b20: 5f66 726f 6d5f 6669 6c65 7f33 3731 3832  _from_file.37182
│ │ │ │ -00003b30: 390a 5265 663a 2073 6869 7368 695f 6b64  9.Ref: shishi_kd
│ │ │ │ -00003b40: 6372 6570 5f63 7265 616c 6d5f 7365 747f  crep_crealm_set.
│ │ │ │ -00003b50: 3337 3234 3032 0a52 6566 3a20 7368 6973  372402.Ref: shis
│ │ │ │ -00003b60: 6869 5f6b 6463 7265 705f 636e 616d 655f  hi_kdcrep_cname_
│ │ │ │ -00003b70: 7365 747f 3337 3238 3435 0a52 6566 3a20  set.372845.Ref: 
│ │ │ │ -00003b80: 7368 6973 6869 5f6b 6463 7265 705f 636c  shishi_kdcrep_cl
│ │ │ │ -00003b90: 6965 6e74 5f73 6574 7f33 3733 3432 330a  ient_set.373423.
│ │ │ │ -00003ba0: 5265 663a 2073 6869 7368 695f 6b64 6372  Ref: shishi_kdcr
│ │ │ │ -00003bb0: 6570 5f67 6574 5f65 6e63 5f70 6172 745f  ep_get_enc_part_
│ │ │ │ -00003bc0: 6574 7970 657f 3337 3339 3233 0a52 6566  etype.373923.Ref
│ │ │ │ -00003bd0: 3a20 7368 6973 6869 5f6b 6463 7265 705f  : shishi_kdcrep_
│ │ │ │ -00003be0: 6765 745f 7469 636b 6574 7f33 3734 3336  get_ticket.37436
│ │ │ │ -00003bf0: 330a 5265 663a 2073 6869 7368 695f 6b64  3.Ref: shishi_kd
│ │ │ │ -00003c00: 6372 6570 5f73 6574 5f74 6963 6b65 747f  crep_set_ticket.
│ │ │ │ -00003c10: 3337 3438 3033 0a52 6566 3a20 7368 6973  374803.Ref: shis
│ │ │ │ -00003c20: 6869 5f6b 6463 7265 705f 7365 745f 656e  hi_kdcrep_set_en
│ │ │ │ -00003c30: 635f 7061 7274 7f33 3735 3234 330a 5265  c_part.375243.Re
│ │ │ │ -00003c40: 663a 2073 6869 7368 695f 6b64 6372 6570  f: shishi_kdcrep
│ │ │ │ -00003c50: 5f61 6464 5f65 6e63 5f70 6172 747f 3337  _add_enc_part.37
│ │ │ │ -00003c60: 3631 3635 0a52 6566 3a20 7368 6973 6869  6165.Ref: shishi
│ │ │ │ -00003c70: 5f6b 6463 7265 705f 636c 6561 725f 7061  _kdcrep_clear_pa
│ │ │ │ -00003c80: 6461 7461 7f33 3736 3930 390a 5265 663a  data.376909.Ref:
│ │ │ │ -00003c90: 2073 6869 7368 695f 656e 636b 6463 7265   shishi_enckdcre
│ │ │ │ -00003ca0: 7070 6172 745f 6765 745f 6b65 797f 3337  ppart_get_key.37
│ │ │ │ -00003cb0: 3732 3836 0a52 6566 3a20 7368 6973 6869  7286.Ref: shishi
│ │ │ │ -00003cc0: 5f65 6e63 6b64 6372 6570 7061 7274 5f6b  _enckdcreppart_k
│ │ │ │ -00003cd0: 6579 5f73 6574 7f33 3737 3832 370a 5265  ey_set.377827.Re
│ │ │ │ -00003ce0: 663a 2073 6869 7368 695f 656e 636b 6463  f: shishi_enckdc
│ │ │ │ -00003cf0: 7265 7070 6172 745f 6e6f 6e63 655f 7365  reppart_nonce_se
│ │ │ │ -00003d00: 747f 3337 3833 3439 0a52 6566 3a20 7368  t.378349.Ref: sh
│ │ │ │ -00003d10: 6973 6869 5f65 6e63 6b64 6372 6570 7061  ishi_enckdcreppa
│ │ │ │ -00003d20: 7274 5f66 6c61 6773 5f73 6574 7f33 3738  rt_flags_set.378
│ │ │ │ -00003d30: 3830 380a 5265 663a 2073 6869 7368 695f  808.Ref: shishi_
│ │ │ │ -00003d40: 656e 636b 6463 7265 7070 6172 745f 6175  enckdcreppart_au
│ │ │ │ -00003d50: 7468 7469 6d65 5f73 6574 7f33 3739 3236  thtime_set.37926
│ │ │ │ -00003d60: 380a 5265 663a 2073 6869 7368 695f 656e  8.Ref: shishi_en
│ │ │ │ -00003d70: 636b 6463 7265 7070 6172 745f 7374 6172  ckdcreppart_star
│ │ │ │ -00003d80: 7474 696d 655f 7365 747f 3337 3937 3837  ttime_set.379787
│ │ │ │ -00003d90: 0a52 6566 3a20 7368 6973 6869 5f65 6e63  .Ref: shishi_enc
│ │ │ │ -00003da0: 6b64 6372 6570 7061 7274 5f65 6e64 7469  kdcreppart_endti
│ │ │ │ -00003db0: 6d65 5f73 6574 7f33 3830 3336 330a 5265  me_set.380363.Re
│ │ │ │ -00003dc0: 663a 2073 6869 7368 695f 656e 636b 6463  f: shishi_enckdc
│ │ │ │ -00003dd0: 7265 7070 6172 745f 7265 6e65 775f 7469  reppart_renew_ti
│ │ │ │ -00003de0: 6c6c 5f73 6574 7f33 3830 3838 300a 5265  ll_set.380880.Re
│ │ │ │ -00003df0: 663a 2073 6869 7368 695f 656e 636b 6463  f: shishi_enckdc
│ │ │ │ -00003e00: 7265 7070 6172 745f 7372 6561 6c6d 5f73  reppart_srealm_s
│ │ │ │ -00003e10: 6574 7f33 3831 3435 390a 5265 663a 2073  et.381459.Ref: s
│ │ │ │ -00003e20: 6869 7368 695f 656e 636b 6463 7265 7070  hishi_enckdcrepp
│ │ │ │ -00003e30: 6172 745f 736e 616d 655f 7365 747f 3338  art_sname_set.38
│ │ │ │ -00003e40: 3139 3530 0a52 6566 3a20 7368 6973 6869  1950.Ref: shishi
│ │ │ │ -00003e50: 5f65 6e63 6b64 6372 6570 7061 7274 5f70  _enckdcreppart_p
│ │ │ │ -00003e60: 6f70 756c 6174 655f 656e 6374 6963 6b65  opulate_encticke
│ │ │ │ -00003e70: 7470 6172 747f 3338 3235 3935 0a4e 6f64  tpart.382595.Nod
│ │ │ │ -00003e80: 653a 2041 7574 6865 6e74 6963 6174 6f72  e: Authenticator
│ │ │ │ -00003e90: 2046 756e 6374 696f 6e73 7f33 3833 3135   Functions.38315
│ │ │ │ -00003ea0: 310a 5265 663a 2073 6869 7368 695f 6175  1.Ref: shishi_au
│ │ │ │ -00003eb0: 7468 656e 7469 6361 746f 727f 3338 3430  thenticator.3840
│ │ │ │ -00003ec0: 3632 0a52 6566 3a20 7368 6973 6869 5f61  62.Ref: shishi_a
│ │ │ │ -00003ed0: 7574 6865 6e74 6963 6174 6f72 5f73 7562  uthenticator_sub
│ │ │ │ -00003ee0: 6b65 797f 3338 3435 3131 0a52 6566 3a20  key.384511.Ref: 
│ │ │ │ -00003ef0: 7368 6973 6869 5f61 7574 6865 6e74 6963  shishi_authentic
│ │ │ │ -00003f00: 6174 6f72 5f70 7269 6e74 7f33 3834 3939  ator_print.38499
│ │ │ │ -00003f10: 360a 5265 663a 2073 6869 7368 695f 6175  6.Ref: shishi_au
│ │ │ │ -00003f20: 7468 656e 7469 6361 746f 725f 7361 7665  thenticator_save
│ │ │ │ -00003f30: 7f33 3835 3439 300a 5265 663a 2073 6869  .385490.Ref: shi
│ │ │ │ -00003f40: 7368 695f 6175 7468 656e 7469 6361 746f  shi_authenticato
│ │ │ │ -00003f50: 725f 746f 5f66 696c 657f 3338 3539 3639  r_to_file.385969
│ │ │ │ -00003f60: 0a52 6566 3a20 7368 6973 6869 5f61 7574  .Ref: shishi_aut
│ │ │ │ -00003f70: 6865 6e74 6963 6174 6f72 5f70 6172 7365  henticator_parse
│ │ │ │ -00003f80: 7f33 3836 3630 330a 5265 663a 2073 6869  .386603.Ref: shi
│ │ │ │ -00003f90: 7368 695f 6175 7468 656e 7469 6361 746f  shi_authenticato
│ │ │ │ -00003fa0: 725f 7265 6164 7f33 3837 3132 350a 5265  r_read.387125.Re
│ │ │ │ -00003fb0: 663a 2073 6869 7368 695f 6175 7468 656e  f: shishi_authen
│ │ │ │ -00003fc0: 7469 6361 746f 725f 6672 6f6d 5f66 696c  ticator_from_fil
│ │ │ │ -00003fd0: 657f 3338 3736 3432 0a52 6566 3a20 7368  e.387642.Ref: sh
│ │ │ │ -00003fe0: 6973 6869 5f61 7574 6865 6e74 6963 6174  ishi_authenticat
│ │ │ │ -00003ff0: 6f72 5f73 6574 5f63 7265 616c 6d7f 3338  or_set_crealm.38
│ │ │ │ -00004000: 3832 3733 0a52 6566 3a20 7368 6973 6869  8273.Ref: shishi
│ │ │ │ -00004010: 5f61 7574 6865 6e74 6963 6174 6f72 5f73  _authenticator_s
│ │ │ │ -00004020: 6574 5f63 6e61 6d65 7f33 3838 3737 390a  et_cname.388779.
│ │ │ │ -00004030: 5265 663a 2073 6869 7368 695f 6175 7468  Ref: shishi_auth
│ │ │ │ -00004040: 656e 7469 6361 746f 725f 636c 6965 6e74  enticator_client
│ │ │ │ -00004050: 5f73 6574 7f33 3839 3433 320a 5265 663a  _set.389432.Ref:
│ │ │ │ -00004060: 2073 6869 7368 695f 6175 7468 656e 7469   shishi_authenti
│ │ │ │ -00004070: 6361 746f 725f 6374 696d 657f 3338 3939  cator_ctime.3899
│ │ │ │ -00004080: 3435 0a52 6566 3a20 7368 6973 6869 5f61  45.Ref: shishi_a
│ │ │ │ -00004090: 7574 6865 6e74 6963 6174 6f72 5f63 7469  uthenticator_cti
│ │ │ │ -000040a0: 6d65 5f73 6574 7f33 3930 3436 350a 5265  me_set.390465.Re
│ │ │ │ -000040b0: 663a 2073 6869 7368 695f 6175 7468 656e  f: shishi_authen
│ │ │ │ -000040c0: 7469 6361 746f 725f 6375 7365 635f 6765  ticator_cusec_ge
│ │ │ │ -000040d0: 747f 3339 3039 3831 0a52 6566 3a20 7368  t.390981.Ref: sh
│ │ │ │ -000040e0: 6973 6869 5f61 7574 6865 6e74 6963 6174  ishi_authenticat
│ │ │ │ -000040f0: 6f72 5f63 7573 6563 5f73 6574 7f33 3931  or_cusec_set.391
│ │ │ │ -00004100: 3531 310a 5265 663a 2073 6869 7368 695f  511.Ref: shishi_
│ │ │ │ -00004110: 6175 7468 656e 7469 6361 746f 725f 7365  authenticator_se
│ │ │ │ -00004120: 716e 756d 6265 725f 6765 747f 3339 3230  qnumber_get.3920
│ │ │ │ -00004130: 3338 0a52 6566 3a20 7368 6973 6869 5f61  38.Ref: shishi_a
│ │ │ │ -00004140: 7574 6865 6e74 6963 6174 6f72 5f73 6571  uthenticator_seq
│ │ │ │ -00004150: 6e75 6d62 6572 5f72 656d 6f76 657f 3339  number_remove.39
│ │ │ │ -00004160: 3235 3837 0a52 6566 3a20 7368 6973 6869  2587.Ref: shishi
│ │ │ │ -00004170: 5f61 7574 6865 6e74 6963 6174 6f72 5f73  _authenticator_s
│ │ │ │ -00004180: 6571 6e75 6d62 6572 5f73 6574 7f33 3933  eqnumber_set.393
│ │ │ │ -00004190: 3034 390a 5265 663a 2073 6869 7368 695f  049.Ref: shishi_
│ │ │ │ -000041a0: 6175 7468 656e 7469 6361 746f 725f 636c  authenticator_cl
│ │ │ │ -000041b0: 6965 6e74 7f33 3933 3539 360a 5265 663a  ient.393596.Ref:
│ │ │ │ -000041c0: 2073 6869 7368 695f 6175 7468 656e 7469   shishi_authenti
│ │ │ │ -000041d0: 6361 746f 725f 636c 6965 6e74 7265 616c  cator_clientreal
│ │ │ │ -000041e0: 6d7f 3339 3435 3732 0a52 6566 3a20 7368  m.394572.Ref: sh
│ │ │ │ -000041f0: 6973 6869 5f61 7574 6865 6e74 6963 6174  ishi_authenticat
│ │ │ │ -00004200: 6f72 5f63 6b73 756d 7f33 3935 3537 360a  or_cksum.395576.
│ │ │ │ -00004210: 5265 663a 2073 6869 7368 695f 6175 7468  Ref: shishi_auth
│ │ │ │ -00004220: 656e 7469 6361 746f 725f 7365 745f 636b  enticator_set_ck
│ │ │ │ -00004230: 7375 6d7f 3339 3633 3638 0a52 6566 3a20  sum.396368.Ref: 
│ │ │ │ -00004240: 7368 6973 6869 5f61 7574 6865 6e74 6963  shishi_authentic
│ │ │ │ -00004250: 6174 6f72 5f61 6464 5f63 6b73 756d 7f33  ator_add_cksum.3
│ │ │ │ -00004260: 3937 3337 380a 5265 663a 2073 6869 7368  97378.Ref: shish
│ │ │ │ -00004270: 695f 6175 7468 656e 7469 6361 746f 725f  i_authenticator_
│ │ │ │ -00004280: 6164 645f 636b 7375 6d5f 7479 7065 7f33  add_cksum_type.3
│ │ │ │ -00004290: 3938 3135 370a 5265 663a 2073 6869 7368  98157.Ref: shish
│ │ │ │ -000042a0: 695f 6175 7468 656e 7469 6361 746f 725f  i_authenticator_
│ │ │ │ -000042b0: 636c 6561 725f 6175 7468 6f72 697a 6174  clear_authorizat
│ │ │ │ -000042c0: 696f 6e64 6174 617f 3339 3930 3330 0a52  iondata.399030.R
│ │ │ │ -000042d0: 6566 3a20 7368 6973 6869 5f61 7574 6865  ef: shishi_authe
│ │ │ │ -000042e0: 6e74 6963 6174 6f72 5f61 6464 5f61 7574  nticator_add_aut
│ │ │ │ -000042f0: 686f 7269 7a61 7469 6f6e 6461 7461 7f33  horizationdata.3
│ │ │ │ -00004300: 3939 3532 330a 5265 663a 2073 6869 7368  99523.Ref: shish
│ │ │ │ -00004310: 695f 6175 7468 656e 7469 6361 746f 725f  i_authenticator_
│ │ │ │ -00004320: 6175 7468 6f72 697a 6174 696f 6e64 6174  authorizationdat
│ │ │ │ -00004330: 617f 3430 3032 3035 0a52 6566 3a20 7368  a.400205.Ref: sh
│ │ │ │ -00004340: 6973 6869 5f61 7574 6865 6e74 6963 6174  ishi_authenticat
│ │ │ │ -00004350: 6f72 5f72 656d 6f76 655f 7375 626b 6579  or_remove_subkey
│ │ │ │ -00004360: 7f34 3031 3030 320a 5265 663a 2073 6869  .401002.Ref: shi
│ │ │ │ -00004370: 7368 695f 6175 7468 656e 7469 6361 746f  shi_authenticato
│ │ │ │ -00004380: 725f 6765 745f 7375 626b 6579 7f34 3031  r_get_subkey.401
│ │ │ │ -00004390: 3434 300a 5265 663a 2073 6869 7368 695f  440.Ref: shishi_
│ │ │ │ -000043a0: 6175 7468 656e 7469 6361 746f 725f 7365  authenticator_se
│ │ │ │ -000043b0: 745f 7375 626b 6579 7f34 3032 3031 350a  t_subkey.402015.
│ │ │ │ -000043c0: 5265 663a 2073 6869 7368 695f 6175 7468  Ref: shishi_auth
│ │ │ │ -000043d0: 656e 7469 6361 746f 725f 6164 645f 7261  enticator_add_ra
│ │ │ │ -000043e0: 6e64 6f6d 5f73 7562 6b65 797f 3430 3330  ndom_subkey.4030
│ │ │ │ -000043f0: 3432 0a52 6566 3a20 7368 6973 6869 5f61  42.Ref: shishi_a
│ │ │ │ -00004400: 7574 6865 6e74 6963 6174 6f72 5f61 6464  uthenticator_add
│ │ │ │ -00004410: 5f72 616e 646f 6d5f 7375 626b 6579 5f65  _random_subkey_e
│ │ │ │ -00004420: 7479 7065 7f34 3033 3538 370a 5265 663a  type.403587.Ref:
│ │ │ │ -00004430: 2073 6869 7368 695f 6175 7468 656e 7469   shishi_authenti
│ │ │ │ -00004440: 6361 746f 725f 6164 645f 7375 626b 6579  cator_add_subkey
│ │ │ │ -00004450: 7f34 3034 3135 360a 4e6f 6465 3a20 4b52  .404156.Node: KR
│ │ │ │ -00004460: 422d 4552 524f 5220 4675 6e63 7469 6f6e  B-ERROR Function
│ │ │ │ -00004470: 737f 3430 3435 3839 0a52 6566 3a20 7368  s.404589.Ref: sh
│ │ │ │ -00004480: 6973 6869 5f6b 7262 6572 726f 727f 3430  ishi_krberror.40
│ │ │ │ -00004490: 3538 3433 0a52 6566 3a20 7368 6973 6869  5843.Ref: shishi
│ │ │ │ -000044a0: 5f6b 7262 6572 726f 725f 7072 696e 747f  _krberror_print.
│ │ │ │ -000044b0: 3430 3631 3738 0a52 6566 3a20 7368 6973  406178.Ref: shis
│ │ │ │ -000044c0: 6869 5f6b 7262 6572 726f 725f 7361 7665  hi_krberror_save
│ │ │ │ -000044d0: 7f34 3036 3539 380a 5265 663a 2073 6869  .406598.Ref: shi
│ │ │ │ -000044e0: 7368 695f 6b72 6265 7272 6f72 5f74 6f5f  shi_krberror_to_
│ │ │ │ -000044f0: 6669 6c65 7f34 3037 3030 320a 5265 663a  file.407002.Ref:
│ │ │ │ -00004500: 2073 6869 7368 695f 6b72 6265 7272 6f72   shishi_krberror
│ │ │ │ -00004510: 5f70 6172 7365 7f34 3037 3539 330a 5265  _parse.407593.Re
│ │ │ │ -00004520: 663a 2073 6869 7368 695f 6b72 6265 7272  f: shishi_krberr
│ │ │ │ -00004530: 6f72 5f72 6561 647f 3430 3830 3638 0a52  or_read.408068.R
│ │ │ │ -00004540: 6566 3a20 7368 6973 6869 5f6b 7262 6572  ef: shishi_krber
│ │ │ │ -00004550: 726f 725f 6672 6f6d 5f66 696c 657f 3430  ror_from_file.40
│ │ │ │ -00004560: 3835 3338 0a52 6566 3a20 7368 6973 6869  8538.Ref: shishi
│ │ │ │ -00004570: 5f6b 7262 6572 726f 725f 6275 696c 647f  _krberror_build.
│ │ │ │ -00004580: 3430 3931 3135 0a52 6566 3a20 7368 6973  409115.Ref: shis
│ │ │ │ -00004590: 6869 5f6b 7262 6572 726f 725f 6465 727f  hi_krberror_der.
│ │ │ │ -000045a0: 3430 3935 3931 0a52 6566 3a20 7368 6973  409591.Ref: shis
│ │ │ │ -000045b0: 6869 5f6b 7262 6572 726f 725f 6372 6561  hi_krberror_crea
│ │ │ │ -000045c0: 6c6d 7f34 3130 3137 320a 5265 663a 2073  lm.410172.Ref: s
│ │ │ │ -000045d0: 6869 7368 695f 6b72 6265 7272 6f72 5f72  hishi_krberror_r
│ │ │ │ -000045e0: 656d 6f76 655f 6372 6561 6c6d 7f34 3130  emove_crealm.410
│ │ │ │ -000045f0: 3731 380a 5265 663a 2073 6869 7368 695f  718.Ref: shishi_
│ │ │ │ -00004600: 6b72 6265 7272 6f72 5f73 6574 5f63 7265  krberror_set_cre
│ │ │ │ -00004610: 616c 6d7f 3431 3131 3138 0a52 6566 3a20  alm.411118.Ref: 
│ │ │ │ -00004620: 7368 6973 6869 5f6b 7262 6572 726f 725f  shishi_krberror_
│ │ │ │ -00004630: 636c 6965 6e74 7f34 3131 3537 330a 5265  client.411573.Re
│ │ │ │ -00004640: 663a 2073 6869 7368 695f 6b72 6265 7272  f: shishi_krberr
│ │ │ │ -00004650: 6f72 5f73 6574 5f63 6e61 6d65 7f34 3132  or_set_cname.412
│ │ │ │ -00004660: 3238 360a 5265 663a 2073 6869 7368 695f  286.Ref: shishi_
│ │ │ │ -00004670: 6b72 6265 7272 6f72 5f72 656d 6f76 655f  krberror_remove_
│ │ │ │ -00004680: 636e 616d 657f 3431 3238 3933 0a52 6566  cname.412893.Ref
│ │ │ │ -00004690: 3a20 7368 6973 6869 5f6b 7262 6572 726f  : shishi_krberro
│ │ │ │ -000046a0: 725f 636c 6965 6e74 5f73 6574 7f34 3133  r_client_set.413
│ │ │ │ -000046b0: 3239 320a 5265 663a 2073 6869 7368 695f  292.Ref: shishi_
│ │ │ │ -000046c0: 6b72 6265 7272 6f72 5f72 6561 6c6d 7f34  krberror_realm.4
│ │ │ │ -000046d0: 3133 3737 300a 5265 663a 2073 6869 7368  13770.Ref: shish
│ │ │ │ -000046e0: 695f 6b72 6265 7272 6f72 5f73 6574 5f72  i_krberror_set_r
│ │ │ │ -000046f0: 6561 6c6d 7f34 3134 3330 390a 5265 663a  ealm.414309.Ref:
│ │ │ │ -00004700: 2073 6869 7368 695f 6b72 6265 7272 6f72   shishi_krberror
│ │ │ │ -00004710: 5f73 6572 7665 727f 3431 3437 3834 0a52  _server.414784.R
│ │ │ │ -00004720: 6566 3a20 7368 6973 6869 5f6b 7262 6572  ef: shishi_krber
│ │ │ │ -00004730: 726f 725f 7265 6d6f 7665 5f73 6e61 6d65  ror_remove_sname
│ │ │ │ -00004740: 7f34 3135 3530 300a 5265 663a 2073 6869  .415500.Ref: shi
│ │ │ │ -00004750: 7368 695f 6b72 6265 7272 6f72 5f73 6574  shi_krberror_set
│ │ │ │ -00004760: 5f73 6e61 6d65 7f34 3136 3035 320a 5265  _sname.416052.Re
│ │ │ │ -00004770: 663a 2073 6869 7368 695f 6b72 6265 7272  f: shishi_krberr
│ │ │ │ -00004780: 6f72 5f73 6572 7665 725f 7365 747f 3431  or_server_set.41
│ │ │ │ -00004790: 3636 3535 0a52 6566 3a20 7368 6973 6869  6655.Ref: shishi
│ │ │ │ -000047a0: 5f6b 7262 6572 726f 725f 6374 696d 657f  _krberror_ctime.
│ │ │ │ -000047b0: 3431 3731 3333 0a52 6566 3a20 7368 6973  417133.Ref: shis
│ │ │ │ -000047c0: 6869 5f6b 7262 6572 726f 725f 6374 696d  hi_krberror_ctim
│ │ │ │ -000047d0: 655f 7365 747f 3431 3735 3839 0a52 6566  e_set.417589.Ref
│ │ │ │ -000047e0: 3a20 7368 6973 6869 5f6b 7262 6572 726f  : shishi_krberro
│ │ │ │ -000047f0: 725f 7265 6d6f 7665 5f63 7469 6d65 7f34  r_remove_ctime.4
│ │ │ │ -00004800: 3138 3036 310a 5265 663a 2073 6869 7368  18061.Ref: shish
│ │ │ │ -00004810: 695f 6b72 6265 7272 6f72 5f63 7573 6563  i_krberror_cusec
│ │ │ │ -00004820: 7f34 3138 3434 380a 5265 663a 2073 6869  .418448.Ref: shi
│ │ │ │ -00004830: 7368 695f 6b72 6265 7272 6f72 5f63 7573  shi_krberror_cus
│ │ │ │ -00004840: 6563 5f73 6574 7f34 3138 3932 340a 5265  ec_set.418924.Re
│ │ │ │ -00004850: 663a 2073 6869 7368 695f 6b72 6265 7272  f: shishi_krberr
│ │ │ │ -00004860: 6f72 5f72 656d 6f76 655f 6375 7365 637f  or_remove_cusec.
│ │ │ │ -00004870: 3431 3933 3939 0a52 6566 3a20 7368 6973  419399.Ref: shis
│ │ │ │ -00004880: 6869 5f6b 7262 6572 726f 725f 7374 696d  hi_krberror_stim
│ │ │ │ -00004890: 657f 3431 3937 3836 0a52 6566 3a20 7368  e.419786.Ref: sh
│ │ │ │ -000048a0: 6973 6869 5f6b 7262 6572 726f 725f 7374  ishi_krberror_st
│ │ │ │ -000048b0: 696d 655f 7365 747f 3432 3032 3432 0a52  ime_set.420242.R
│ │ │ │ -000048c0: 6566 3a20 7368 6973 6869 5f6b 7262 6572  ef: shishi_krber
│ │ │ │ -000048d0: 726f 725f 7375 7365 637f 3432 3037 3030  ror_susec.420700
│ │ │ │ -000048e0: 0a52 6566 3a20 7368 6973 6869 5f6b 7262  .Ref: shishi_krb
│ │ │ │ -000048f0: 6572 726f 725f 7375 7365 635f 7365 747f  error_susec_set.
│ │ │ │ -00004900: 3432 3131 3736 0a52 6566 3a20 7368 6973  421176.Ref: shis
│ │ │ │ -00004910: 6869 5f6b 7262 6572 726f 725f 6572 726f  hi_krberror_erro
│ │ │ │ -00004920: 7263 6f64 657f 3432 3136 3435 0a52 6566  rcode.421645.Ref
│ │ │ │ -00004930: 3a20 7368 6973 6869 5f6b 7262 6572 726f  : shishi_krberro
│ │ │ │ -00004940: 725f 6572 726f 7263 6f64 655f 6661 7374  r_errorcode_fast
│ │ │ │ -00004950: 7f34 3232 3130 350a 5265 663a 2073 6869  .422105.Ref: shi
│ │ │ │ -00004960: 7368 695f 6b72 6265 7272 6f72 5f65 7272  shi_krberror_err
│ │ │ │ -00004970: 6f72 636f 6465 5f73 6574 7f34 3232 3537  orcode_set.42257
│ │ │ │ -00004980: 340a 5265 663a 2073 6869 7368 695f 6b72  4.Ref: shishi_kr
│ │ │ │ -00004990: 6265 7272 6f72 5f65 7465 7874 7f34 3233  berror_etext.423
│ │ │ │ -000049a0: 3033 300a 5265 663a 2073 6869 7368 695f  030.Ref: shishi_
│ │ │ │ -000049b0: 6b72 6265 7272 6f72 5f73 6574 5f65 7465  krberror_set_ete
│ │ │ │ -000049c0: 7874 7f34 3233 3536 380a 5265 663a 2073  xt.423568.Ref: s
│ │ │ │ -000049d0: 6869 7368 695f 6b72 6265 7272 6f72 5f72  hishi_krberror_r
│ │ │ │ -000049e0: 656d 6f76 655f 6574 6578 747f 3432 3430  emove_etext.4240
│ │ │ │ -000049f0: 3634 0a52 6566 3a20 7368 6973 6869 5f6b  64.Ref: shishi_k
│ │ │ │ -00004a00: 7262 6572 726f 725f 6564 6174 617f 3432  rberror_edata.42
│ │ │ │ -00004a10: 3434 3630 0a52 6566 3a20 7368 6973 6869  4460.Ref: shishi
│ │ │ │ -00004a20: 5f6b 7262 6572 726f 725f 6d65 7468 6f64  _krberror_method
│ │ │ │ -00004a30: 6461 7461 7f34 3235 3030 300a 5265 663a  data.425000.Ref:
│ │ │ │ -00004a40: 2073 6869 7368 695f 6b72 6265 7272 6f72   shishi_krberror
│ │ │ │ -00004a50: 5f73 6574 5f65 6461 7461 7f34 3235 3539  _set_edata.42559
│ │ │ │ -00004a60: 360a 5265 663a 2073 6869 7368 695f 6b72  6.Ref: shishi_kr
│ │ │ │ -00004a70: 6265 7272 6f72 5f72 656d 6f76 655f 6564  berror_remove_ed
│ │ │ │ -00004a80: 6174 617f 3432 3630 3932 0a52 6566 3a20  ata.426092.Ref: 
│ │ │ │ -00004a90: 7368 6973 6869 5f6b 7262 6572 726f 725f  shishi_krberror_
│ │ │ │ -00004aa0: 7072 6574 7479 5f70 7269 6e74 7f34 3236  pretty_print.426
│ │ │ │ -00004ab0: 3530 320a 5265 663a 2073 6869 7368 695f  502.Ref: shishi_
│ │ │ │ -00004ac0: 6b72 6265 7272 6f72 5f65 7272 6f72 636f  krberror_errorco
│ │ │ │ -00004ad0: 6465 5f6d 6573 7361 6765 7f34 3236 3939  de_message.42699
│ │ │ │ -00004ae0: 370a 5265 663a 2073 6869 7368 695f 6b72  7.Ref: shishi_kr
│ │ │ │ -00004af0: 6265 7272 6f72 5f6d 6573 7361 6765 7f34  berror_message.4
│ │ │ │ -00004b00: 3237 3438 350a 4e6f 6465 3a20 4372 7970  27485.Node: Cryp
│ │ │ │ -00004b10: 746f 6772 6170 6869 6320 4675 6e63 7469  tographic Functi
│ │ │ │ -00004b20: 6f6e 737f 3432 3830 3232 0a52 6566 3a20  ons.428022.Ref: 
│ │ │ │ -00004b30: 7368 6973 6869 5f6b 6579 5f70 7269 6e63  shishi_key_princ
│ │ │ │ -00004b40: 6970 616c 7f34 3238 3939 310a 5265 663a  ipal.428991.Ref:
│ │ │ │ -00004b50: 2073 6869 7368 695f 6b65 795f 7072 696e   shishi_key_prin
│ │ │ │ -00004b60: 6369 7061 6c5f 7365 747f 3432 3933 3839  cipal_set.429389
│ │ │ │ -00004b70: 0a52 6566 3a20 7368 6973 6869 5f6b 6579  .Ref: shishi_key
│ │ │ │ -00004b80: 5f72 6561 6c6d 7f34 3239 3739 340a 5265  _realm.429794.Re
│ │ │ │ -00004b90: 663a 2073 6869 7368 695f 6b65 795f 7265  f: shishi_key_re
│ │ │ │ -00004ba0: 616c 6d5f 7365 747f 3433 3031 3630 0a52  alm_set.430160.R
│ │ │ │ -00004bb0: 6566 3a20 7368 6973 6869 5f6b 6579 5f74  ef: shishi_key_t
│ │ │ │ -00004bc0: 7970 657f 3433 3035 3631 0a52 6566 3a20  ype.430561.Ref: 
│ │ │ │ -00004bd0: 7368 6973 6869 5f6b 6579 5f74 7970 655f  shishi_key_type_
│ │ │ │ -00004be0: 7365 747f 3433 3038 3339 0a52 6566 3a20  set.430839.Ref: 
│ │ │ │ -00004bf0: 7368 6973 6869 5f6b 6579 5f76 616c 7565  shishi_key_value
│ │ │ │ -00004c00: 7f34 3331 3038 340a 5265 663a 2073 6869  .431084.Ref: shi
│ │ │ │ -00004c10: 7368 695f 6b65 795f 7661 6c75 655f 7365  shi_key_value_se
│ │ │ │ -00004c20: 747f 3433 3134 3131 0a52 6566 3a20 7368  t.431411.Ref: sh
│ │ │ │ -00004c30: 6973 6869 5f6b 6579 5f76 6572 7369 6f6e  ishi_key_version
│ │ │ │ -00004c40: 7f34 3331 3836 340a 5265 663a 2073 6869  .431864.Ref: shi
│ │ │ │ -00004c50: 7368 695f 6b65 795f 7665 7273 696f 6e5f  shi_key_version_
│ │ │ │ -00004c60: 7365 747f 3433 3232 3031 0a52 6566 3a20  set.432201.Ref: 
│ │ │ │ -00004c70: 7368 6973 6869 5f6b 6579 5f74 696d 6573  shishi_key_times
│ │ │ │ -00004c80: 7461 6d70 7f34 3332 3532 360a 5265 663a  tamp.432526.Ref:
│ │ │ │ -00004c90: 2073 6869 7368 695f 6b65 795f 7469 6d65   shishi_key_time
│ │ │ │ -00004ca0: 7374 616d 705f 7365 747f 3433 3239 3531  stamp_set.432951
│ │ │ │ -00004cb0: 0a52 6566 3a20 7368 6973 6869 5f6b 6579  .Ref: shishi_key
│ │ │ │ -00004cc0: 5f6e 616d 657f 3433 3333 3036 0a52 6566  _name.433306.Ref
│ │ │ │ -00004cd0: 3a20 7368 6973 6869 5f6b 6579 5f6c 656e  : shishi_key_len
│ │ │ │ -00004ce0: 6774 687f 3433 3335 3535 0a52 6566 3a20  gth.433555.Ref: 
│ │ │ │ -00004cf0: 7368 6973 6869 5f6b 6579 7f34 3333 3831  shishi_key.43381
│ │ │ │ -00004d00: 310a 5265 663a 2073 6869 7368 695f 6b65  1.Ref: shishi_ke
│ │ │ │ -00004d10: 795f 646f 6e65 7f34 3334 3137 350a 5265  y_done.434175.Re
│ │ │ │ -00004d20: 663a 2073 6869 7368 695f 6b65 795f 636f  f: shishi_key_co
│ │ │ │ -00004d30: 7079 7f34 3334 3338 320a 5265 663a 2073  py.434382.Ref: s
│ │ │ │ -00004d40: 6869 7368 695f 6b65 795f 6672 6f6d 5f76  hishi_key_from_v
│ │ │ │ -00004d50: 616c 7565 7f34 3334 3732 300a 5265 663a  alue.434720.Ref:
│ │ │ │ -00004d60: 2073 6869 7368 695f 6b65 795f 6672 6f6d   shishi_key_from
│ │ │ │ -00004d70: 5f62 6173 6536 347f 3433 3533 3531 0a52  _base64.435351.R
│ │ │ │ -00004d80: 6566 3a20 7368 6973 6869 5f6b 6579 5f72  ef: shishi_key_r
│ │ │ │ -00004d90: 616e 646f 6d7f 3433 3630 3734 0a52 6566  andom.436074.Ref
│ │ │ │ -00004da0: 3a20 7368 6973 6869 5f6b 6579 5f66 726f  : shishi_key_fro
│ │ │ │ -00004db0: 6d5f 7261 6e64 6f6d 7f34 3336 3633 340a  m_random.436634.
│ │ │ │ -00004dc0: 5265 663a 2073 6869 7368 695f 6b65 795f  Ref: shishi_key_
│ │ │ │ -00004dd0: 6672 6f6d 5f73 7472 696e 677f 3433 3733  from_string.4373
│ │ │ │ -00004de0: 3335 0a52 6566 3a20 7368 6973 6869 5f6b  35.Ref: shishi_k
│ │ │ │ -00004df0: 6579 5f66 726f 6d5f 6e61 6d65 7f34 3338  ey_from_name.438
│ │ │ │ -00004e00: 3333 370a 5265 663a 2073 6869 7368 695f  337.Ref: shishi_
│ │ │ │ -00004e10: 6b65 7973 7f34 3339 3634 380a 5265 663a  keys.439648.Ref:
│ │ │ │ -00004e20: 2073 6869 7368 695f 6b65 7973 5f64 6f6e   shishi_keys_don
│ │ │ │ -00004e30: 657f 3433 3939 3834 0a52 6566 3a20 7368  e.439984.Ref: sh
│ │ │ │ -00004e40: 6973 6869 5f6b 6579 735f 7369 7a65 7f34  ishi_keys_size.4
│ │ │ │ -00004e50: 3430 3331 350a 5265 663a 2073 6869 7368  40315.Ref: shish
│ │ │ │ -00004e60: 695f 6b65 7973 5f6e 7468 7f34 3430 3537  i_keys_nth.44057
│ │ │ │ -00004e70: 340a 5265 663a 2073 6869 7368 695f 6b65  4.Ref: shishi_ke
│ │ │ │ -00004e80: 7973 5f72 656d 6f76 657f 3434 3130 3731  ys_remove.441071
│ │ │ │ -00004e90: 0a52 6566 3a20 7368 6973 6869 5f6b 6579  .Ref: shishi_key
│ │ │ │ -00004ea0: 735f 6164 647f 3434 3133 3938 0a52 6566  s_add.441398.Ref
│ │ │ │ -00004eb0: 3a20 7368 6973 6869 5f6b 6579 735f 7072  : shishi_keys_pr
│ │ │ │ -00004ec0: 696e 747f 3434 3138 3530 0a52 6566 3a20  int.441850.Ref: 
│ │ │ │ -00004ed0: 7368 6973 6869 5f6b 6579 735f 746f 5f66  shishi_keys_to_f
│ │ │ │ -00004ee0: 696c 657f 3434 3231 3637 0a52 6566 3a20  ile.442167.Ref: 
│ │ │ │ -00004ef0: 7368 6973 6869 5f6b 6579 735f 6672 6f6d  shishi_keys_from
│ │ │ │ -00004f00: 5f66 696c 657f 3434 3237 3432 0a52 6566  _file.442742.Ref
│ │ │ │ -00004f10: 3a20 7368 6973 6869 5f6b 6579 735f 666f  : shishi_keys_fo
│ │ │ │ -00004f20: 725f 7365 7276 6572 7265 616c 6d5f 696e  r_serverrealm_in
│ │ │ │ -00004f30: 5f66 696c 657f 3434 3332 3638 0a52 6566  _file.443268.Ref
│ │ │ │ -00004f40: 3a20 7368 6973 6869 5f6b 6579 735f 666f  : shishi_keys_fo
│ │ │ │ -00004f50: 725f 7365 7276 6572 5f69 6e5f 6669 6c65  r_server_in_file
│ │ │ │ -00004f60: 7f34 3433 3935 390a 5265 663a 2073 6869  .443959.Ref: shi
│ │ │ │ -00004f70: 7368 695f 6b65 7973 5f66 6f72 5f6c 6f63  shi_keys_for_loc
│ │ │ │ -00004f80: 616c 7365 7276 6963 6572 6561 6c6d 5f69  alservicerealm_i
│ │ │ │ -00004f90: 6e5f 6669 6c65 7f34 3434 3534 330a 5265  n_file.444543.Re
│ │ │ │ -00004fa0: 663a 2073 6869 7368 695f 686f 7374 6b65  f: shishi_hostke
│ │ │ │ -00004fb0: 7973 5f64 6566 6175 6c74 5f66 696c 657f  ys_default_file.
│ │ │ │ -00004fc0: 3434 3536 3636 0a52 6566 3a20 7368 6973  445666.Ref: shis
│ │ │ │ -00004fd0: 6869 5f68 6f73 746b 6579 735f 6465 6661  hi_hostkeys_defa
│ │ │ │ -00004fe0: 756c 745f 6669 6c65 5f73 6574 7f34 3436  ult_file_set.446
│ │ │ │ -00004ff0: 3038 360a 5265 663a 2073 6869 7368 695f  086.Ref: shishi_
│ │ │ │ -00005000: 686f 7374 6b65 7973 5f66 6f72 5f73 6572  hostkeys_for_ser
│ │ │ │ -00005010: 7665 727f 3434 3636 3134 0a52 6566 3a20  ver.446614.Ref: 
│ │ │ │ -00005020: 7368 6973 6869 5f68 6f73 746b 6579 735f  shishi_hostkeys_
│ │ │ │ -00005030: 666f 725f 7365 7276 6572 7265 616c 6d7f  for_serverrealm.
│ │ │ │ -00005040: 3434 3731 3433 0a52 6566 3a20 7368 6973  447143.Ref: shis
│ │ │ │ -00005050: 6869 5f68 6f73 746b 6579 735f 666f 725f  hi_hostkeys_for_
│ │ │ │ -00005060: 6c6f 6361 6c73 6572 7669 6365 7265 616c  localservicereal
│ │ │ │ -00005070: 6d7f 3434 3737 3737 0a52 6566 3a20 7368  m.447777.Ref: sh
│ │ │ │ -00005080: 6973 6869 5f68 6f73 746b 6579 735f 666f  ishi_hostkeys_fo
│ │ │ │ -00005090: 725f 6c6f 6361 6c73 6572 7669 6365 7f34  r_localservice.4
│ │ │ │ -000050a0: 3438 3531 350a 5265 663a 2073 6869 7368  48515.Ref: shish
│ │ │ │ -000050b0: 695f 6369 7068 6572 5f73 7570 706f 7274  i_cipher_support
│ │ │ │ -000050c0: 6564 5f70 7f34 3439 3330 330a 5265 663a  ed_p.449303.Ref:
│ │ │ │ -000050d0: 2073 6869 7368 695f 6369 7068 6572 5f6e   shishi_cipher_n
│ │ │ │ -000050e0: 616d 657f 3434 3935 3630 0a52 6566 3a20  ame.449560.Ref: 
│ │ │ │ -000050f0: 7368 6973 6869 5f63 6970 6865 725f 626c  shishi_cipher_bl
│ │ │ │ -00005100: 6f63 6b73 697a 657f 3434 3938 3932 0a52  ocksize.449892.R
│ │ │ │ -00005110: 6566 3a20 7368 6973 6869 5f63 6970 6865  ef: shishi_ciphe
│ │ │ │ -00005120: 725f 636f 6e66 6f75 6e64 6572 7369 7a65  r_confoundersize
│ │ │ │ -00005130: 7f34 3530 3139 380a 5265 663a 2073 6869  .450198.Ref: shi
│ │ │ │ -00005140: 7368 695f 6369 7068 6572 5f6b 6579 6c65  shi_cipher_keyle
│ │ │ │ -00005150: 6e7f 3435 3035 3939 0a52 6566 3a20 7368  n.450599.Ref: sh
│ │ │ │ -00005160: 6973 6869 5f63 6970 6865 725f 7261 6e64  ishi_cipher_rand
│ │ │ │ -00005170: 6f6d 6c65 6e7f 3435 3039 3037 0a52 6566  omlen.450907.Ref
│ │ │ │ -00005180: 3a20 7368 6973 6869 5f63 6970 6865 725f  : shishi_cipher_
│ │ │ │ -00005190: 6465 6661 756c 7463 6b73 756d 7479 7065  defaultcksumtype
│ │ │ │ -000051a0: 7f34 3531 3331 310a 5265 663a 2073 6869  .451311.Ref: shi
│ │ │ │ -000051b0: 7368 695f 6369 7068 6572 5f70 6172 7365  shi_cipher_parse
│ │ │ │ -000051c0: 7f34 3531 3635 310a 5265 663a 2073 6869  .451651.Ref: shi
│ │ │ │ -000051d0: 7368 695f 6368 6563 6b73 756d 5f73 7570  shi_checksum_sup
│ │ │ │ -000051e0: 706f 7274 6564 5f70 7f34 3531 3936 330a  ported_p.451963.
│ │ │ │ -000051f0: 5265 663a 2073 6869 7368 695f 6368 6563  Ref: shishi_chec
│ │ │ │ -00005200: 6b73 756d 5f6e 616d 657f 3435 3232 3337  ksum_name.452237
│ │ │ │ -00005210: 0a52 6566 3a20 7368 6973 6869 5f63 6865  .Ref: shishi_che
│ │ │ │ -00005220: 636b 7375 6d5f 636b 7375 6d6c 656e 7f34  cksum_cksumlen.4
│ │ │ │ -00005230: 3532 3535 370a 5265 663a 2073 6869 7368  52557.Ref: shish
│ │ │ │ -00005240: 695f 6368 6563 6b73 756d 5f70 6172 7365  i_checksum_parse
│ │ │ │ -00005250: 7f34 3532 3837 340a 5265 663a 2073 6869  .452874.Ref: shi
│ │ │ │ -00005260: 7368 695f 7374 7269 6e67 5f74 6f5f 6b65  shi_string_to_ke
│ │ │ │ -00005270: 797f 3435 3332 3039 0a52 6566 3a20 7368  y.453209.Ref: sh
│ │ │ │ -00005280: 6973 6869 5f72 616e 646f 6d5f 746f 5f6b  ishi_random_to_k
│ │ │ │ -00005290: 6579 7f34 3534 3333 300a 5265 663a 2073  ey.454330.Ref: s
│ │ │ │ -000052a0: 6869 7368 695f 6368 6563 6b73 756d 7f34  hishi_checksum.4
│ │ │ │ -000052b0: 3535 3030 310a 5265 663a 2073 6869 7368  55001.Ref: shish
│ │ │ │ -000052c0: 695f 7665 7269 6679 7f34 3535 3934 370a  i_verify.455947.
│ │ │ │ -000052d0: 5265 663a 2073 6869 7368 695f 656e 6372  Ref: shishi_encr
│ │ │ │ -000052e0: 7970 745f 6976 7570 6461 7465 5f65 7479  ypt_ivupdate_ety
│ │ │ │ -000052f0: 7065 7f34 3536 3837 350a 5265 663a 2073  pe.456875.Ref: s
│ │ │ │ -00005300: 6869 7368 695f 656e 6372 7970 745f 6976  hishi_encrypt_iv
│ │ │ │ -00005310: 5f65 7479 7065 7f34 3538 3832 380a 5265  _etype.458828.Re
│ │ │ │ -00005320: 663a 2073 6869 7368 695f 656e 6372 7970  f: shishi_encryp
│ │ │ │ -00005330: 745f 6574 7970 657f 3436 3035 3733 0a52  t_etype.460573.R
│ │ │ │ -00005340: 6566 3a20 7368 6973 6869 5f65 6e63 7279  ef: shishi_encry
│ │ │ │ -00005350: 7074 5f69 7675 7064 6174 657f 3436 3232  pt_ivupdate.4622
│ │ │ │ -00005360: 3630 0a52 6566 3a20 7368 6973 6869 5f65  60.Ref: shishi_e
│ │ │ │ -00005370: 6e63 7279 7074 5f69 767f 3436 3430 3934  ncrypt_iv.464094
│ │ │ │ -00005380: 0a52 6566 3a20 7368 6973 6869 5f65 6e63  .Ref: shishi_enc
│ │ │ │ -00005390: 7279 7074 7f34 3635 3731 340a 5265 663a  rypt.465714.Ref:
│ │ │ │ -000053a0: 2073 6869 7368 695f 6465 6372 7970 745f   shishi_decrypt_
│ │ │ │ -000053b0: 6976 7570 6461 7465 5f65 7479 7065 7f34  ivupdate_etype.4
│ │ │ │ -000053c0: 3637 3236 370a 5265 663a 2073 6869 7368  67267.Ref: shish
│ │ │ │ -000053d0: 695f 6465 6372 7970 745f 6976 5f65 7479  i_decrypt_iv_ety
│ │ │ │ -000053e0: 7065 7f34 3639 3232 300a 5265 663a 2073  pe.469220.Ref: s
│ │ │ │ -000053f0: 6869 7368 695f 6465 6372 7970 745f 6574  hishi_decrypt_et
│ │ │ │ -00005400: 7970 657f 3437 3039 3635 0a52 6566 3a20  ype.470965.Ref: 
│ │ │ │ -00005410: 7368 6973 6869 5f64 6563 7279 7074 5f69  shishi_decrypt_i
│ │ │ │ -00005420: 7675 7064 6174 657f 3437 3236 3231 0a52  vupdate.472621.R
│ │ │ │ -00005430: 6566 3a20 7368 6973 6869 5f64 6563 7279  ef: shishi_decry
│ │ │ │ -00005440: 7074 5f69 767f 3437 3434 3535 0a52 6566  pt_iv.474455.Ref
│ │ │ │ -00005450: 3a20 7368 6973 6869 5f64 6563 7279 7074  : shishi_decrypt
│ │ │ │ -00005460: 7f34 3736 3038 310a 5265 663a 2073 6869  .476081.Ref: shi
│ │ │ │ -00005470: 7368 695f 6e5f 666f 6c64 7f34 3737 3630  shi_n_fold.47760
│ │ │ │ -00005480: 320a 5265 663a 2073 6869 7368 695f 6472  2.Ref: shishi_dr
│ │ │ │ -00005490: 7f34 3738 3438 370a 5265 663a 2073 6869  .478487.Ref: shi
│ │ │ │ -000054a0: 7368 695f 646b 7f34 3739 3239 310a 5265  shi_dk.479291.Re
│ │ │ │ -000054b0: 663a 2073 6869 7368 695f 6372 7970 746f  f: shishi_crypto
│ │ │ │ -000054c0: 7f34 3830 3238 340a 5265 663a 2073 6869  .480284.Ref: shi
│ │ │ │ -000054d0: 7368 695f 6372 7970 746f 5f65 6e63 7279  shi_crypto_encry
│ │ │ │ -000054e0: 7074 7f34 3831 3436 330a 5265 663a 2073  pt.481463.Ref: s
│ │ │ │ -000054f0: 6869 7368 695f 6372 7970 746f 5f64 6563  hishi_crypto_dec
│ │ │ │ -00005500: 7279 7074 7f34 3832 3332 380a 5265 663a  rypt.482328.Ref:
│ │ │ │ -00005510: 2073 6869 7368 695f 6372 7970 746f 5f63   shishi_crypto_c
│ │ │ │ -00005520: 6c6f 7365 7f34 3833 3138 390a 5265 663a  lose.483189.Ref:
│ │ │ │ -00005530: 2073 6869 7368 695f 7261 6e64 6f6d 697a   shishi_randomiz
│ │ │ │ -00005540: 657f 3438 3336 3532 0a52 6566 3a20 7368  e.483652.Ref: sh
│ │ │ │ -00005550: 6973 6869 5f63 7263 7f34 3834 3138 330a  ishi_crc.484183.
│ │ │ │ -00005560: 5265 663a 2073 6869 7368 695f 6d64 347f  Ref: shishi_md4.
│ │ │ │ -00005570: 3438 3439 3233 0a52 6566 3a20 7368 6973  484923.Ref: shis
│ │ │ │ -00005580: 6869 5f6d 6435 7f34 3835 3435 300a 5265  hi_md5.485450.Re
│ │ │ │ -00005590: 663a 2073 6869 7368 695f 686d 6163 5f6d  f: shishi_hmac_m
│ │ │ │ -000055a0: 6435 7f34 3835 3938 370a 5265 663a 2073  d5.485987.Ref: s
│ │ │ │ -000055b0: 6869 7368 695f 686d 6163 5f73 6861 317f  hishi_hmac_sha1.
│ │ │ │ -000055c0: 3438 3637 3138 0a52 6566 3a20 7368 6973  486718.Ref: shis
│ │ │ │ -000055d0: 6869 5f64 6573 5f63 6263 5f6d 6163 7f34  hi_des_cbc_mac.4
│ │ │ │ -000055e0: 3837 3435 350a 5265 663a 2073 6869 7368  87455.Ref: shish
│ │ │ │ -000055f0: 695f 6172 6366 6f75 727f 3438 3832 3031  i_arcfour.488201
│ │ │ │ -00005600: 0a52 6566 3a20 7368 6973 6869 5f64 6573  .Ref: shishi_des
│ │ │ │ -00005610: 7f34 3839 3437 360a 5265 663a 2073 6869  .489476.Ref: shi
│ │ │ │ -00005620: 7368 695f 3364 6573 7f34 3930 3434 340a  shi_3des.490444.
│ │ │ │ -00005630: 5265 663a 2073 6869 7368 695f 6165 735f  Ref: shishi_aes_
│ │ │ │ -00005640: 6374 737f 3439 3134 3230 0a52 6566 3a20  cts.491420.Ref: 
│ │ │ │ -00005650: 7368 6973 6869 5f70 626b 6466 325f 7368  shishi_pbkdf2_sh
│ │ │ │ -00005660: 6131 7f34 3932 3537 300a 4e6f 6465 3a20  a1.492570.Node: 
│ │ │ │ -00005670: 582e 3530 3920 4675 6e63 7469 6f6e 737f  X.509 Functions.
│ │ │ │ -00005680: 3439 3336 3834 0a52 6566 3a20 7368 6973  493684.Ref: shis
│ │ │ │ -00005690: 6869 5f78 3530 3963 615f 6465 6661 756c  hi_x509ca_defaul
│ │ │ │ -000056a0: 745f 6669 6c65 5f67 7565 7373 7f34 3934  t_file_guess.494
│ │ │ │ -000056b0: 3033 330a 5265 663a 2073 6869 7368 695f  033.Ref: shishi_
│ │ │ │ -000056c0: 7835 3039 6361 5f64 6566 6175 6c74 5f66  x509ca_default_f
│ │ │ │ -000056d0: 696c 655f 7365 747f 3439 3434 3937 0a52  ile_set.494497.R
│ │ │ │ -000056e0: 6566 3a20 7368 6973 6869 5f78 3530 3963  ef: shishi_x509c
│ │ │ │ -000056f0: 615f 6465 6661 756c 745f 6669 6c65 7f34  a_default_file.4
│ │ │ │ -00005700: 3935 3134 310a 5265 663a 2073 6869 7368  95141.Ref: shish
│ │ │ │ -00005710: 695f 7835 3039 6365 7274 5f64 6566 6175  i_x509cert_defau
│ │ │ │ -00005720: 6c74 5f66 696c 655f 6775 6573 737f 3439  lt_file_guess.49
│ │ │ │ -00005730: 3536 3733 0a52 6566 3a20 7368 6973 6869  5673.Ref: shishi
│ │ │ │ -00005740: 5f78 3530 3963 6572 745f 6465 6661 756c  _x509cert_defaul
│ │ │ │ -00005750: 745f 6669 6c65 5f73 6574 7f34 3936 3136  t_file_set.49616
│ │ │ │ -00005760: 300a 5265 663a 2073 6869 7368 695f 7835  0.Ref: shishi_x5
│ │ │ │ -00005770: 3039 6365 7274 5f64 6566 6175 6c74 5f66  09cert_default_f
│ │ │ │ -00005780: 696c 657f 3439 3638 3232 0a52 6566 3a20  ile.496822.Ref: 
│ │ │ │ -00005790: 7368 6973 6869 5f78 3530 396b 6579 5f64  shishi_x509key_d
│ │ │ │ -000057a0: 6566 6175 6c74 5f66 696c 655f 6775 6573  efault_file_gues
│ │ │ │ -000057b0: 737f 3439 3733 3639 0a52 6566 3a20 7368  s.497369.Ref: sh
│ │ │ │ -000057c0: 6973 6869 5f78 3530 396b 6579 5f64 6566  ishi_x509key_def
│ │ │ │ -000057d0: 6175 6c74 5f66 696c 655f 7365 747f 3439  ault_file_set.49
│ │ │ │ -000057e0: 3738 3235 0a52 6566 3a20 7368 6973 6869  7825.Ref: shishi
│ │ │ │ -000057f0: 5f78 3530 396b 6579 5f64 6566 6175 6c74  _x509key_default
│ │ │ │ -00005800: 5f66 696c 657f 3439 3834 3538 0a4e 6f64  _file.498458.Nod
│ │ │ │ -00005810: 653a 2055 7469 6c69 7479 2046 756e 6374  e: Utility Funct
│ │ │ │ -00005820: 696f 6e73 7f34 3938 3930 310a 5265 663a  ions.498901.Ref:
│ │ │ │ -00005830: 2073 6869 7368 695f 7265 616c 6d5f 6465   shishi_realm_de
│ │ │ │ -00005840: 6661 756c 745f 6775 6573 737f 3439 3931  fault_guess.4991
│ │ │ │ -00005850: 3233 0a52 6566 3a20 7368 6973 6869 5f72  23.Ref: shishi_r
│ │ │ │ -00005860: 6561 6c6d 5f64 6566 6175 6c74 7f35 3030  ealm_default.500
│ │ │ │ -00005870: 3236 350a 5265 663a 2073 6869 7368 695f  265.Ref: shishi_
│ │ │ │ -00005880: 7265 616c 6d5f 6465 6661 756c 745f 7365  realm_default_se
│ │ │ │ -00005890: 747f 3530 3037 3733 0a52 6566 3a20 7368  t.500773.Ref: sh
│ │ │ │ -000058a0: 6973 6869 5f72 6561 6c6d 5f66 6f72 5f73  ishi_realm_for_s
│ │ │ │ -000058b0: 6572 7665 725f 6669 6c65 7f35 3031 3339  erver_file.50139
│ │ │ │ -000058c0: 340a 5265 663a 2073 6869 7368 695f 7265  4.Ref: shishi_re
│ │ │ │ -000058d0: 616c 6d5f 666f 725f 7365 7276 6572 5f64  alm_for_server_d
│ │ │ │ -000058e0: 6e73 7f35 3031 3834 320a 5265 663a 2073  ns.501842.Ref: s
│ │ │ │ -000058f0: 6869 7368 695f 7265 616c 6d5f 666f 725f  hishi_realm_for_
│ │ │ │ -00005900: 7365 7276 6572 7f35 3033 3430 370a 5265  server.503407.Re
│ │ │ │ -00005910: 663a 2073 6869 7368 695f 7072 696e 6369  f: shishi_princi
│ │ │ │ -00005920: 7061 6c5f 6465 6661 756c 745f 6775 6573  pal_default_gues
│ │ │ │ -00005930: 737f 3530 3431 3636 0a52 6566 3a20 7368  s.504166.Ref: sh
│ │ │ │ -00005940: 6973 6869 5f70 7269 6e63 6970 616c 5f64  ishi_principal_d
│ │ │ │ -00005950: 6566 6175 6c74 7f35 3034 3539 360a 5265  efault.504596.Re
│ │ │ │ -00005960: 663a 2073 6869 7368 695f 7072 696e 6369  f: shishi_princi
│ │ │ │ -00005970: 7061 6c5f 6465 6661 756c 745f 7365 747f  pal_default_set.
│ │ │ │ -00005980: 3530 3531 3431 0a52 6566 3a20 7368 6973  505141.Ref: shis
│ │ │ │ -00005990: 6869 5f70 6172 7365 5f6e 616d 657f 3530  hi_parse_name.50
│ │ │ │ -000059a0: 3536 3330 0a52 6566 3a20 7368 6973 6869  5630.Ref: shishi
│ │ │ │ -000059b0: 5f70 7269 6e63 6970 616c 5f6e 616d 657f  _principal_name.
│ │ │ │ -000059c0: 3530 3634 3530 0a52 6566 3a20 7368 6973  506450.Ref: shis
│ │ │ │ -000059d0: 6869 5f70 7269 6e63 6970 616c 5f6e 616d  hi_principal_nam
│ │ │ │ -000059e0: 655f 7265 616c 6d7f 3530 3734 3639 0a52  e_realm.507469.R
│ │ │ │ -000059f0: 6566 3a20 7368 6973 6869 5f70 7269 6e63  ef: shishi_princ
│ │ │ │ -00005a00: 6970 616c 5f6e 616d 655f 7365 747f 3530  ipal_name_set.50
│ │ │ │ -00005a10: 3837 3039 0a52 6566 3a20 7368 6973 6869  8709.Ref: shishi
│ │ │ │ -00005a20: 5f70 7269 6e63 6970 616c 5f73 6574 7f35  _principal_set.5
│ │ │ │ -00005a30: 3039 3430 370a 5265 663a 2073 6869 7368  09407.Ref: shish
│ │ │ │ -00005a40: 695f 6465 7269 7665 5f64 6566 6175 6c74  i_derive_default
│ │ │ │ -00005a50: 5f73 616c 747f 3531 3030 3137 0a52 6566  _salt.510017.Ref
│ │ │ │ -00005a60: 3a20 7368 6973 6869 5f73 6572 7665 725f  : shishi_server_
│ │ │ │ -00005a70: 666f 725f 6c6f 6361 6c5f 7365 7276 6963  for_local_servic
│ │ │ │ -00005a80: 657f 3531 3035 3535 0a52 6566 3a20 7368  e.510555.Ref: sh
│ │ │ │ -00005a90: 6973 6869 5f61 7574 686f 7269 7a65 5f73  ishi_authorize_s
│ │ │ │ -00005aa0: 7472 636d 707f 3531 3131 3930 0a52 6566  trcmp.511190.Ref
│ │ │ │ -00005ab0: 3a20 7368 6973 6869 5f61 7574 686f 7269  : shishi_authori
│ │ │ │ -00005ac0: 7a65 5f6b 356c 6f67 696e 7f35 3131 3738  ze_k5login.51178
│ │ │ │ -00005ad0: 390a 5265 663a 2073 6869 7368 695f 6175  9.Ref: shishi_au
│ │ │ │ -00005ae0: 7468 6f72 697a 6174 696f 6e5f 7061 7273  thorization_pars
│ │ │ │ -00005af0: 657f 3531 3233 3735 0a52 6566 3a20 7368  e.512375.Ref: sh
│ │ │ │ -00005b00: 6973 6869 5f61 7574 686f 7269 7a65 645f  ishi_authorized_
│ │ │ │ -00005b10: 707f 3531 3237 3034 0a52 6566 3a20 7368  p.512704.Ref: sh
│ │ │ │ -00005b20: 6973 6869 5f67 656e 6572 616c 697a 655f  ishi_generalize_
│ │ │ │ -00005b30: 7469 6d65 7f35 3133 3437 380a 5265 663a  time.513478.Ref:
│ │ │ │ -00005b40: 2073 6869 7368 695f 6765 6e65 7261 6c69   shishi_generali
│ │ │ │ -00005b50: 7a65 5f6e 6f77 7f35 3133 3935 380a 5265  ze_now.513958.Re
│ │ │ │ -00005b60: 663a 2073 6869 7368 695f 6765 6e65 7261  f: shishi_genera
│ │ │ │ -00005b70: 6c69 7a65 5f63 7469 6d65 7f35 3134 3337  lize_ctime.51437
│ │ │ │ -00005b80: 380a 5265 663a 2073 6869 7368 695f 7469  8.Ref: shishi_ti
│ │ │ │ -00005b90: 6d65 7f35 3134 3738 370a 5265 663a 2073  me.514787.Ref: s
│ │ │ │ -00005ba0: 6869 7368 695f 6374 696d 657f 3531 3534  hishi_ctime.5154
│ │ │ │ -00005bb0: 3330 0a52 6566 3a20 7368 6973 6869 5f70  30.Ref: shishi_p
│ │ │ │ -00005bc0: 726f 6d70 745f 7061 7373 776f 7264 5f63  rompt_password_c
│ │ │ │ -00005bd0: 616c 6c62 6163 6b5f 7365 747f 3531 3632  allback_set.5162
│ │ │ │ -00005be0: 3532 0a52 6566 3a20 7368 6973 6869 5f70  52.Ref: shishi_p
│ │ │ │ -00005bf0: 726f 6d70 745f 7061 7373 776f 7264 5f63  rompt_password_c
│ │ │ │ -00005c00: 616c 6c62 6163 6b5f 6765 747f 3531 3731  allback_get.5171
│ │ │ │ -00005c10: 3631 0a52 6566 3a20 7368 6973 6869 5f70  61.Ref: shishi_p
│ │ │ │ -00005c20: 726f 6d70 745f 7061 7373 776f 7264 7f35  rompt_password.5
│ │ │ │ -00005c30: 3137 3631 350a 5265 663a 2073 6869 7368  17615.Ref: shish
│ │ │ │ -00005c40: 695f 7265 736f 6c76 7f35 3138 3239 330a  i_resolv.518293.
│ │ │ │ -00005c50: 5265 663a 2073 6869 7368 695f 7265 736f  Ref: shishi_reso
│ │ │ │ -00005c60: 6c76 5f66 7265 657f 3531 3839 3634 0a4e  lv_free.518964.N
│ │ │ │ -00005c70: 6f64 653a 2041 534e 2e31 2046 756e 6374  ode: ASN.1 Funct
│ │ │ │ -00005c80: 696f 6e73 7f35 3139 3139 380a 5265 663a  ions.519198.Ref:
│ │ │ │ -00005c90: 2073 6869 7368 695f 6173 6e31 5f72 6561   shishi_asn1_rea
│ │ │ │ -00005ca0: 645f 696e 6c69 6e65 7f35 3139 3430 390a  d_inline.519409.
│ │ │ │ -00005cb0: 5265 663a 2073 6869 7368 695f 6173 6e31  Ref: shishi_asn1
│ │ │ │ -00005cc0: 5f72 6561 647f 3532 3033 3731 0a52 6566  _read.520371.Ref
│ │ │ │ -00005cd0: 3a20 7368 6973 6869 5f61 736e 315f 7265  : shishi_asn1_re
│ │ │ │ -00005ce0: 6164 5f6f 7074 696f 6e61 6c7f 3532 3132  ad_optional.5212
│ │ │ │ -00005cf0: 3332 0a52 6566 3a20 7368 6973 6869 5f61  32.Ref: shishi_a
│ │ │ │ -00005d00: 736e 315f 646f 6e65 7f35 3232 3139 370a  sn1_done.522197.
│ │ │ │ -00005d10: 5265 663a 2073 6869 7368 695f 6173 6e31  Ref: shishi_asn1
│ │ │ │ -00005d20: 5f70 615f 656e 635f 7473 5f65 6e63 7f35  _pa_enc_ts_enc.5
│ │ │ │ -00005d30: 3232 3535 380a 5265 663a 2073 6869 7368  22558.Ref: shish
│ │ │ │ -00005d40: 695f 6173 6e31 5f65 6e63 7279 7074 6564  i_asn1_encrypted
│ │ │ │ -00005d50: 6461 7461 7f35 3232 3836 300a 5265 663a  data.522860.Ref:
│ │ │ │ -00005d60: 2073 6869 7368 695f 6173 6e31 5f70 6164   shishi_asn1_pad
│ │ │ │ -00005d70: 6174 617f 3532 3331 3437 0a52 6566 3a20  ata.523147.Ref: 
│ │ │ │ -00005d80: 7368 6973 6869 5f61 736e 315f 6d65 7468  shishi_asn1_meth
│ │ │ │ -00005d90: 6f64 6461 7461 7f35 3233 3433 300a 5265  oddata.523430.Re
│ │ │ │ -00005da0: 663a 2073 6869 7368 695f 6173 6e31 5f65  f: shishi_asn1_e
│ │ │ │ -00005db0: 7479 7065 5f69 6e66 6f7f 3532 3337 3231  type_info.523721
│ │ │ │ -00005dc0: 0a52 6566 3a20 7368 6973 6869 5f61 736e  .Ref: shishi_asn
│ │ │ │ -00005dd0: 315f 6574 7970 655f 696e 666f 327f 3532  1_etype_info2.52
│ │ │ │ -00005de0: 3430 3133 0a52 6566 3a20 7368 6973 6869  4013.Ref: shishi
│ │ │ │ -00005df0: 5f61 736e 315f 6173 7265 717f 3532 3432  _asn1_asreq.5242
│ │ │ │ -00005e00: 3935 0a52 6566 3a20 7368 6973 6869 5f61  95.Ref: shishi_a
│ │ │ │ -00005e10: 736e 315f 6173 7265 707f 3532 3435 3636  sn1_asrep.524566
│ │ │ │ -00005e20: 0a52 6566 3a20 7368 6973 6869 5f61 736e  .Ref: shishi_asn
│ │ │ │ -00005e30: 315f 7467 7372 6571 7f35 3234 3833 390a  1_tgsreq.524839.
│ │ │ │ -00005e40: 5265 663a 2073 6869 7368 695f 6173 6e31  Ref: shishi_asn1
│ │ │ │ -00005e50: 5f74 6773 7265 707f 3532 3531 3134 0a52  _tgsrep.525114.R
│ │ │ │ -00005e60: 6566 3a20 7368 6973 6869 5f61 736e 315f  ef: shishi_asn1_
│ │ │ │ -00005e70: 6170 7265 717f 3532 3533 3837 0a52 6566  apreq.525387.Ref
│ │ │ │ -00005e80: 3a20 7368 6973 6869 5f61 736e 315f 6170  : shishi_asn1_ap
│ │ │ │ -00005e90: 7265 707f 3532 3536 3538 0a52 6566 3a20  rep.525658.Ref: 
│ │ │ │ -00005ea0: 7368 6973 6869 5f61 736e 315f 656e 6361  shishi_asn1_enca
│ │ │ │ -00005eb0: 7072 6570 7061 7274 7f35 3235 3934 330a  preppart.525943.
│ │ │ │ -00005ec0: 5265 663a 2073 6869 7368 695f 6173 6e31  Ref: shishi_asn1
│ │ │ │ -00005ed0: 5f74 6963 6b65 747f 3532 3632 3233 0a52  _ticket.526223.R
│ │ │ │ -00005ee0: 6566 3a20 7368 6973 6869 5f61 736e 315f  ef: shishi_asn1_
│ │ │ │ -00005ef0: 656e 6374 6963 6b65 7470 6172 747f 3532  encticketpart.52
│ │ │ │ -00005f00: 3635 3131 0a52 6566 3a20 7368 6973 6869  6511.Ref: shishi
│ │ │ │ -00005f10: 5f61 736e 315f 6175 7468 656e 7469 6361  _asn1_authentica
│ │ │ │ -00005f20: 746f 727f 3532 3638 3133 0a52 6566 3a20  tor.526813.Ref: 
│ │ │ │ -00005f30: 7368 6973 6869 5f61 736e 315f 656e 636b  shishi_asn1_enck
│ │ │ │ -00005f40: 6463 7265 7070 6172 747f 3532 3731 3135  dcreppart.527115
│ │ │ │ -00005f50: 0a52 6566 3a20 7368 6973 6869 5f61 736e  .Ref: shishi_asn
│ │ │ │ -00005f60: 315f 656e 6361 7372 6570 7061 7274 7f35  1_encasreppart.5
│ │ │ │ -00005f70: 3237 3431 350a 5265 663a 2073 6869 7368  27415.Ref: shish
│ │ │ │ -00005f80: 695f 6173 6e31 5f6b 7262 6572 726f 727f  i_asn1_krberror.
│ │ │ │ -00005f90: 3532 3737 3035 0a52 6566 3a20 7368 6973  527705.Ref: shis
│ │ │ │ -00005fa0: 6869 5f61 736e 315f 6b72 6273 6166 657f  hi_asn1_krbsafe.
│ │ │ │ -00005fb0: 3532 3739 3836 0a52 6566 3a20 7368 6973  527986.Ref: shis
│ │ │ │ -00005fc0: 6869 5f61 736e 315f 7072 6976 7f35 3238  hi_asn1_priv.528
│ │ │ │ -00005fd0: 3235 390a 5265 663a 2073 6869 7368 695f  259.Ref: shishi_
│ │ │ │ -00005fe0: 6173 6e31 5f65 6e63 7072 6976 7061 7274  asn1_encprivpart
│ │ │ │ -00005ff0: 7f35 3238 3534 330a 5265 663a 2073 6869  .528543.Ref: shi
│ │ │ │ -00006000: 7368 695f 6173 6e31 5f74 6f5f 6465 725f  shi_asn1_to_der_
│ │ │ │ -00006010: 6669 656c 647f 3532 3838 3432 0a52 6566  field.528842.Ref
│ │ │ │ -00006020: 3a20 7368 6973 6869 5f61 736e 315f 746f  : shishi_asn1_to
│ │ │ │ -00006030: 5f64 6572 7f35 3239 3538 370a 5265 663a  _der.529587.Ref:
│ │ │ │ -00006040: 2073 6869 7368 695f 6173 6e31 5f6d 7367   shishi_asn1_msg
│ │ │ │ -00006050: 7479 7065 7f35 3330 3233 330a 5265 663a  type.530233.Ref:
│ │ │ │ -00006060: 2073 6869 7368 695f 6465 725f 6d73 6774   shishi_der_msgt
│ │ │ │ -00006070: 7970 657f 3533 3037 3330 0a52 6566 3a20  ype.530730.Ref: 
│ │ │ │ -00006080: 7368 6973 6869 5f64 6572 3261 736e 317f  shishi_der2asn1.
│ │ │ │ -00006090: 3533 3131 3839 0a52 6566 3a20 7368 6973  531189.Ref: shis
│ │ │ │ -000060a0: 6869 5f64 6572 3261 736e 315f 7061 6461  hi_der2asn1_pada
│ │ │ │ -000060b0: 7461 7f35 3331 3731 300a 5265 663a 2073  ta.531710.Ref: s
│ │ │ │ -000060c0: 6869 7368 695f 6465 7232 6173 6e31 5f6d  hishi_der2asn1_m
│ │ │ │ -000060d0: 6574 686f 6464 6174 617f 3533 3232 3135  ethoddata.532215
│ │ │ │ -000060e0: 0a52 6566 3a20 7368 6973 6869 5f64 6572  .Ref: shishi_der
│ │ │ │ -000060f0: 3261 736e 315f 6574 7970 655f 696e 666f  2asn1_etype_info
│ │ │ │ -00006100: 7f35 3332 3732 380a 5265 663a 2073 6869  .532728.Ref: shi
│ │ │ │ -00006110: 7368 695f 6465 7232 6173 6e31 5f65 7479  shi_der2asn1_ety
│ │ │ │ -00006120: 7065 5f69 6e66 6f32 7f35 3333 3234 320a  pe_info2.533242.
│ │ │ │ -00006130: 5265 663a 2073 6869 7368 695f 6465 7232  Ref: shishi_der2
│ │ │ │ -00006140: 6173 6e31 5f74 6963 6b65 747f 3533 3337  asn1_ticket.5337
│ │ │ │ -00006150: 3438 0a52 6566 3a20 7368 6973 6869 5f64  48.Ref: shishi_d
│ │ │ │ -00006160: 6572 3261 736e 315f 656e 6374 6963 6b65  er2asn1_encticke
│ │ │ │ -00006170: 7470 6172 747f 3533 3432 3538 0a52 6566  tpart.534258.Ref
│ │ │ │ -00006180: 3a20 7368 6973 6869 5f64 6572 3261 736e  : shishi_der2asn
│ │ │ │ -00006190: 315f 6173 7265 717f 3533 3437 3636 0a52  1_asreq.534766.R
│ │ │ │ -000061a0: 6566 3a20 7368 6973 6869 5f64 6572 3261  ef: shishi_der2a
│ │ │ │ -000061b0: 736e 315f 7467 7372 6571 7f35 3335 3236  sn1_tgsreq.53526
│ │ │ │ -000061c0: 310a 5265 663a 2073 6869 7368 695f 6465  1.Ref: shishi_de
│ │ │ │ -000061d0: 7232 6173 6e31 5f61 7372 6570 7f35 3335  r2asn1_asrep.535
│ │ │ │ -000061e0: 3735 360a 5265 663a 2073 6869 7368 695f  756.Ref: shishi_
│ │ │ │ -000061f0: 6465 7232 6173 6e31 5f74 6773 7265 707f  der2asn1_tgsrep.
│ │ │ │ -00006200: 3533 3632 3531 0a52 6566 3a20 7368 6973  536251.Ref: shis
│ │ │ │ -00006210: 6869 5f64 6572 3261 736e 315f 6b64 6372  hi_der2asn1_kdcr
│ │ │ │ -00006220: 6570 7f35 3336 3734 380a 5265 663a 2073  ep.536748.Ref: s
│ │ │ │ -00006230: 6869 7368 695f 6465 7232 6173 6e31 5f65  hishi_der2asn1_e
│ │ │ │ -00006240: 6e63 6173 7265 7070 6172 747f 3533 3732  ncasreppart.5372
│ │ │ │ -00006250: 3537 0a52 6566 3a20 7368 6973 6869 5f64  57.Ref: shishi_d
│ │ │ │ -00006260: 6572 3261 736e 315f 656e 6374 6773 7265  er2asn1_enctgsre
│ │ │ │ -00006270: 7070 6172 747f 3533 3737 3739 0a52 6566  ppart.537779.Ref
│ │ │ │ -00006280: 3a20 7368 6973 6869 5f64 6572 3261 736e  : shishi_der2asn
│ │ │ │ -00006290: 315f 656e 636b 6463 7265 7070 6172 747f  1_enckdcreppart.
│ │ │ │ -000062a0: 3533 3833 3033 0a52 6566 3a20 7368 6973  538303.Ref: shis
│ │ │ │ -000062b0: 6869 5f64 6572 3261 736e 315f 6175 7468  hi_der2asn1_auth
│ │ │ │ -000062c0: 656e 7469 6361 746f 727f 3533 3838 3237  enticator.538827
│ │ │ │ -000062d0: 0a52 6566 3a20 7368 6973 6869 5f64 6572  .Ref: shishi_der
│ │ │ │ -000062e0: 3261 736e 315f 6b72 6265 7272 6f72 7f35  2asn1_krberror.5
│ │ │ │ -000062f0: 3339 3334 310a 5265 663a 2073 6869 7368  39341.Ref: shish
│ │ │ │ -00006300: 695f 6465 7232 6173 6e31 5f6b 7262 7361  i_der2asn1_krbsa
│ │ │ │ -00006310: 6665 7f35 3339 3834 340a 5265 663a 2073  fe.539844.Ref: s
│ │ │ │ -00006320: 6869 7368 695f 6465 7232 6173 6e31 5f70  hishi_der2asn1_p
│ │ │ │ -00006330: 7269 767f 3534 3033 3339 0a52 6566 3a20  riv.540339.Ref: 
│ │ │ │ -00006340: 7368 6973 6869 5f64 6572 3261 736e 315f  shishi_der2asn1_
│ │ │ │ -00006350: 656e 6370 7269 7670 6172 747f 3534 3038  encprivpart.5408
│ │ │ │ -00006360: 3435 0a52 6566 3a20 7368 6973 6869 5f64  45.Ref: shishi_d
│ │ │ │ -00006370: 6572 3261 736e 315f 6170 7265 717f 3534  er2asn1_apreq.54
│ │ │ │ -00006380: 3133 3532 0a52 6566 3a20 7368 6973 6869  1352.Ref: shishi
│ │ │ │ -00006390: 5f64 6572 3261 736e 315f 6170 7265 707f  _der2asn1_aprep.
│ │ │ │ -000063a0: 3534 3138 3435 0a52 6566 3a20 7368 6973  541845.Ref: shis
│ │ │ │ -000063b0: 6869 5f64 6572 3261 736e 315f 656e 6361  hi_der2asn1_enca
│ │ │ │ -000063c0: 7072 6570 7061 7274 7f35 3432 3335 320a  preppart.542352.
│ │ │ │ -000063d0: 5265 663a 2073 6869 7368 695f 6465 7232  Ref: shishi_der2
│ │ │ │ -000063e0: 6173 6e31 5f6b 6463 7265 717f 3534 3238  asn1_kdcreq.5428
│ │ │ │ -000063f0: 3630 0a52 6566 3a20 7368 6973 6869 5f61  60.Ref: shishi_a
│ │ │ │ -00006400: 736e 315f 7072 696e 747f 3534 3333 3636  sn1_print.543366
│ │ │ │ -00006410: 0a4e 6f64 653a 2045 7272 6f72 2048 616e  .Node: Error Han
│ │ │ │ -00006420: 646c 696e 677f 3534 3337 3333 0a4e 6f64  dling.543733.Nod
│ │ │ │ -00006430: 653a 2045 7272 6f72 2056 616c 7565 737f  e: Error Values.
│ │ │ │ -00006440: 3534 3434 3934 0a4e 6f64 653a 2045 7272  544494.Node: Err
│ │ │ │ -00006450: 6f72 2046 756e 6374 696f 6e73 7f35 3439  or Functions.549
│ │ │ │ -00006460: 3733 370a 5265 663a 2073 6869 7368 695f  737.Ref: shishi_
│ │ │ │ -00006470: 7374 7265 7272 6f72 7f35 3439 3930 340a  strerror.549904.
│ │ │ │ -00006480: 5265 663a 2073 6869 7368 695f 6572 726f  Ref: shishi_erro
│ │ │ │ -00006490: 727f 3535 3033 3035 0a52 6566 3a20 7368  r.550305.Ref: sh
│ │ │ │ -000064a0: 6973 6869 5f65 7272 6f72 5f63 6c65 6172  ishi_error_clear
│ │ │ │ -000064b0: 7f35 3530 3830 330a 5265 663a 2073 6869  .550803.Ref: shi
│ │ │ │ -000064c0: 7368 695f 6572 726f 725f 7365 747f 3535  shi_error_set.55
│ │ │ │ -000064d0: 3133 3733 0a52 6566 3a20 7368 6973 6869  1373.Ref: shishi
│ │ │ │ -000064e0: 5f65 7272 6f72 5f70 7269 6e74 667f 3535  _error_printf.55
│ │ │ │ -000064f0: 3230 3637 0a52 6566 3a20 7368 6973 6869  2067.Ref: shishi
│ │ │ │ -00006500: 5f65 7272 6f72 5f6f 7574 7075 7474 7970  _error_outputtyp
│ │ │ │ -00006510: 657f 3535 3236 3231 0a52 6566 3a20 7368  e.552621.Ref: sh
│ │ │ │ -00006520: 6973 6869 5f65 7272 6f72 5f73 6574 5f6f  ishi_error_set_o
│ │ │ │ -00006530: 7574 7075 7474 7970 657f 3535 3331 3135  utputtype.553115
│ │ │ │ -00006540: 0a52 6566 3a20 7368 6973 6869 5f69 6e66  .Ref: shishi_inf
│ │ │ │ -00006550: 6f7f 3535 3337 3636 0a52 6566 3a20 7368  o.553766.Ref: sh
│ │ │ │ -00006560: 6973 6869 5f77 6172 6e7f 3535 3431 3430  ishi_warn.554140
│ │ │ │ -00006570: 0a52 6566 3a20 7368 6973 6869 5f76 6572  .Ref: shishi_ver
│ │ │ │ -00006580: 626f 7365 7f35 3534 3530 350a 4e6f 6465  bose.554505.Node
│ │ │ │ -00006590: 3a20 4578 616d 706c 6573 7f35 3534 3938  : Examples.55498
│ │ │ │ -000065a0: 380a 4e6f 6465 3a20 4b65 7262 6572 6f73  8.Node: Kerberos
│ │ │ │ -000065b0: 2044 6174 6162 6173 6520 4675 6e63 7469   Database Functi
│ │ │ │ -000065c0: 6f6e 737f 3535 3636 3232 0a52 6566 3a20  ons.556622.Ref: 
│ │ │ │ -000065d0: 7368 6973 617f 3535 3933 3439 0a52 6566  shisa.559349.Ref
│ │ │ │ -000065e0: 3a20 7368 6973 615f 646f 6e65 7f35 3539  : shisa_done.559
│ │ │ │ -000065f0: 3631 340a 5265 663a 2073 6869 7361 5f69  614.Ref: shisa_i
│ │ │ │ -00006600: 6e69 747f 3535 3939 3030 0a52 6566 3a20  nit.559900.Ref: 
│ │ │ │ -00006610: 7368 6973 615f 696e 6974 5f77 6974 685f  shisa_init_with_
│ │ │ │ -00006620: 7061 7468 737f 3536 3036 3835 0a52 6566  paths.560685.Ref
│ │ │ │ -00006630: 3a20 7368 6973 615f 6366 675f 6462 7f35  : shisa_cfg_db.5
│ │ │ │ -00006640: 3631 3831 350a 5265 663a 2073 6869 7361  61815.Ref: shisa
│ │ │ │ -00006650: 5f63 6667 7f35 3632 3533 380a 5265 663a  _cfg.562538.Ref:
│ │ │ │ -00006660: 2073 6869 7361 5f63 6667 5f66 726f 6d5f   shisa_cfg_from_
│ │ │ │ -00006670: 6669 6c65 7f35 3633 3235 350a 5265 663a  file.563255.Ref:
│ │ │ │ -00006680: 2073 6869 7361 5f63 6667 5f64 6566 6175   shisa_cfg_defau
│ │ │ │ -00006690: 6c74 5f73 7973 7465 6d66 696c 657f 3536  lt_systemfile.56
│ │ │ │ -000066a0: 3337 3239 0a52 6566 3a20 7368 6973 615f  3729.Ref: shisa_
│ │ │ │ -000066b0: 656e 756d 6572 6174 655f 7265 616c 6d73  enumerate_realms
│ │ │ │ -000066c0: 7f35 3634 3437 340a 5265 663a 2073 6869  .564474.Ref: shi
│ │ │ │ -000066d0: 7361 5f65 6e75 6d65 7261 7465 5f70 7269  sa_enumerate_pri
│ │ │ │ -000066e0: 6e63 6970 616c 737f 3536 3532 3130 0a52  ncipals.565210.R
│ │ │ │ -000066f0: 6566 3a20 7368 6973 615f 7072 696e 6369  ef: shisa_princi
│ │ │ │ -00006700: 7061 6c5f 6669 6e64 7f35 3636 3133 360a  pal_find.566136.
│ │ │ │ -00006710: 5265 663a 2073 6869 7361 5f70 7269 6e63  Ref: shisa_princ
│ │ │ │ -00006720: 6970 616c 5f75 7064 6174 657f 3536 3639  ipal_update.5669
│ │ │ │ -00006730: 3532 0a52 6566 3a20 7368 6973 615f 7072  52.Ref: shisa_pr
│ │ │ │ -00006740: 696e 6369 7061 6c5f 6164 647f 3536 3832  incipal_add.5682
│ │ │ │ -00006750: 3930 0a52 6566 3a20 7368 6973 615f 7072  90.Ref: shisa_pr
│ │ │ │ -00006760: 696e 6369 7061 6c5f 7265 6d6f 7665 7f35  incipal_remove.5
│ │ │ │ -00006770: 3639 3235 350a 5265 663a 2073 6869 7361  69255.Ref: shisa
│ │ │ │ -00006780: 5f6b 6579 735f 6669 6e64 7f35 3639 3936  _keys_find.56996
│ │ │ │ -00006790: 310a 5265 663a 2073 6869 7361 5f6b 6579  1.Ref: shisa_key
│ │ │ │ -000067a0: 5f61 6464 7f35 3731 3138 310a 5265 663a  _add.571181.Ref:
│ │ │ │ -000067b0: 2073 6869 7361 5f6b 6579 5f75 7064 6174   shisa_key_updat
│ │ │ │ -000067c0: 657f 3537 3138 3034 0a52 6566 3a20 7368  e.571804.Ref: sh
│ │ │ │ -000067d0: 6973 615f 6b65 795f 7265 6d6f 7665 7f35  isa_key_remove.5
│ │ │ │ -000067e0: 3733 3333 350a 5265 663a 2073 6869 7361  73335.Ref: shisa
│ │ │ │ -000067f0: 5f6b 6579 5f66 7265 657f 3537 3433 3834  _key_free.574384
│ │ │ │ -00006800: 0a52 6566 3a20 7368 6973 615f 6b65 7973  .Ref: shisa_keys
│ │ │ │ -00006810: 5f66 7265 657f 3537 3437 3036 0a52 6566  _free.574706.Ref
│ │ │ │ -00006820: 3a20 7368 6973 615f 7374 7265 7272 6f72  : shisa_strerror
│ │ │ │ -00006830: 7f35 3735 3338 380a 5265 663a 2073 6869  .575388.Ref: shi
│ │ │ │ -00006840: 7361 5f69 6e66 6f7f 3537 3537 3931 0a4e  sa_info.575791.N
│ │ │ │ -00006850: 6f64 653a 2047 656e 6572 6963 2053 6563  ode: Generic Sec
│ │ │ │ -00006860: 7572 6974 7920 5365 7276 6963 657f 3537  urity Service.57
│ │ │ │ -00006870: 3631 3238 0a4e 6f64 653a 2041 636b 6e6f  6128.Node: Ackno
│ │ │ │ -00006880: 776c 6564 6765 6d65 6e74 737f 3537 3733  wledgements.5773
│ │ │ │ -00006890: 3733 0a4e 6f64 653a 2043 7269 7469 6369  73.Node: Critici
│ │ │ │ -000068a0: 736d 206f 6620 4b65 7262 6572 6f73 7f35  sm of Kerberos.5
│ │ │ │ -000068b0: 3738 3039 360a 4e6f 6465 3a20 5072 6f74  78096.Node: Prot
│ │ │ │ -000068c0: 6f63 6f6c 2045 7874 656e 7369 6f6e 737f  ocol Extensions.
│ │ │ │ -000068d0: 3538 3033 3433 0a4e 6f64 653a 2053 5441  580343.Node: STA
│ │ │ │ -000068e0: 5254 544c 5320 7072 6f74 6563 7465 6420  RTTLS protected 
│ │ │ │ -000068f0: 4b44 4320 6578 6368 616e 6765 737f 3538  KDC exchanges.58
│ │ │ │ -00006900: 3131 3633 0a4e 6f64 653a 2054 656c 6e65  1163.Node: Telne
│ │ │ │ -00006910: 7420 656e 6372 7970 7469 6f6e 2077 6974  t encryption wit
│ │ │ │ -00006920: 6820 4145 532d 4343 4d7f 3539 3033 3331  h AES-CCM.590331
│ │ │ │ -00006930: 0a4e 6f64 653a 204b 6572 6265 7269 7a65  .Node: Kerberize
│ │ │ │ -00006940: 6420 7273 6820 616e 6420 726c 6f67 696e  d rsh and rlogin
│ │ │ │ -00006950: 7f35 3938 3333 310a 5265 663a 2062 6173  .598331.Ref: bas
│ │ │ │ -00006960: 6963 2061 7574 686f 7269 7a61 7469 6f6e  ic authorization
│ │ │ │ -00006970: 7f36 3032 3834 300a 5265 663a 206b 6572  .602840.Ref: ker
│ │ │ │ -00006980: 6265 726f 7320 6175 7468 6f72 697a 6174  beros authorizat
│ │ │ │ -00006990: 696f 6e7f 3631 3034 3931 0a4e 6f64 653a  ion.610491.Node:
│ │ │ │ -000069a0: 204b 6579 2061 7320 696e 6974 6961 6c69   Key as initiali
│ │ │ │ -000069b0: 7a61 7469 6f6e 2076 6563 746f 727f 3631  zation vector.61
│ │ │ │ -000069c0: 3237 3034 0a52 6566 3a20 4b65 7920 6173  2704.Ref: Key as
│ │ │ │ -000069d0: 2069 6e69 7469 616c 697a 6174 696f 6e20   initialization 
│ │ │ │ -000069e0: 7665 6374 6f72 2d46 6f6f 746e 6f74 652d  vector-Footnote-
│ │ │ │ -000069f0: 317f 3631 3530 3637 0a4e 6f64 653a 2054  1.615067.Node: T
│ │ │ │ -00006a00: 6865 204b 6579 7461 6220 4269 6e61 7279  he Keytab Binary
│ │ │ │ -00006a10: 2046 696c 6520 466f 726d 6174 7f36 3135   File Format.615
│ │ │ │ -00006a20: 3233 330a 4e6f 6465 3a20 5468 6520 4372  233.Node: The Cr
│ │ │ │ -00006a30: 6564 656e 7469 616c 2043 6163 6865 2042  edential Cache B
│ │ │ │ -00006a40: 696e 6172 7920 4669 6c65 2046 6f72 6d61  inary File Forma
│ │ │ │ -00006a50: 747f 3632 3030 3737 0a4e 6f64 653a 2043  t.620077.Node: C
│ │ │ │ -00006a60: 6f70 7969 6e67 2049 6e66 6f72 6d61 7469  opying Informati
│ │ │ │ -00006a70: 6f6e 7f36 3233 3530 310a 4e6f 6465 3a20  on.623501.Node: 
│ │ │ │ -00006a80: 474e 5520 4672 6565 2044 6f63 756d 656e  GNU Free Documen
│ │ │ │ -00006a90: 7461 7469 6f6e 204c 6963 656e 7365 7f36  tation License.6
│ │ │ │ -00006aa0: 3233 3736 330a 4e6f 6465 3a20 4675 6e63  23763.Node: Func
│ │ │ │ -00006ab0: 7469 6f6e 2061 6e64 2044 6174 6120 496e  tion and Data In
│ │ │ │ -00006ac0: 6465 787f 3634 3838 3831 0a4e 6f64 653a  dex.648881.Node:
│ │ │ │ -00006ad0: 2043 6f6e 6365 7074 2049 6e64 6578 7f37   Concept Index.7
│ │ │ │ -00006ae0: 3235 3932 380a 1f0a 456e 6420 5461 6720  25928...End Tag 
│ │ │ │ -00006af0: 5461 626c 650a 0a1f 0a4c 6f63 616c 2056  Table....Local V
│ │ │ │ -00006b00: 6172 6961 626c 6573 3a0a 636f 6469 6e67  ariables:.coding
│ │ │ │ -00006b10: 3a20 7574 662d 380a 456e 643a 0a         : utf-8.End:.
│ │ │ │ +00000060: 6174 6564 2031 3420 4d61 7263 6820 3230  ated 14 March 20
│ │ │ │ +00000070: 3236 2066 6f72 2076 6572 7369 6f6e 2031  26 for version 1
│ │ │ │ +00000080: 2e30 2e33 206f 6620 5368 6973 6869 2e0a  .0.3 of Shishi..
│ │ │ │ +00000090: 0a20 2020 436f 7079 7269 6768 7420 c2a9  .   Copyright ..
│ │ │ │ +000000a0: 2032 3030 322d 3230 3232 2053 696d 6f6e   2002-2022 Simon
│ │ │ │ +000000b0: 204a 6f73 6566 7373 6f6e 2e0a 0a20 2020   Josefsson...   
│ │ │ │ +000000c0: 2020 5065 726d 6973 7369 6f6e 2069 7320    Permission is 
│ │ │ │ +000000d0: 6772 616e 7465 6420 746f 2063 6f70 792c  granted to copy,
│ │ │ │ +000000e0: 2064 6973 7472 6962 7574 6520 616e 642f   distribute and/
│ │ │ │ +000000f0: 6f72 206d 6f64 6966 7920 7468 6973 0a20  or modify this. 
│ │ │ │ +00000100: 2020 2020 646f 6375 6d65 6e74 2075 6e64      document und
│ │ │ │ +00000110: 6572 2074 6865 2074 6572 6d73 206f 6620  er the terms of 
│ │ │ │ +00000120: 7468 6520 474e 5520 4672 6565 2044 6f63  the GNU Free Doc
│ │ │ │ +00000130: 756d 656e 7461 7469 6f6e 204c 6963 656e  umentation Licen
│ │ │ │ +00000140: 7365 2c0a 2020 2020 2056 6572 7369 6f6e  se,.     Version
│ │ │ │ +00000150: 2031 2e33 206f 7220 616e 7920 6c61 7465   1.3 or any late
│ │ │ │ +00000160: 7220 7665 7273 696f 6e20 7075 626c 6973  r version publis
│ │ │ │ +00000170: 6865 6420 6279 2074 6865 2046 7265 6520  hed by the Free 
│ │ │ │ +00000180: 536f 6674 7761 7265 0a20 2020 2020 466f  Software.     Fo
│ │ │ │ +00000190: 756e 6461 7469 6f6e 3b20 7769 7468 206e  undation; with n
│ │ │ │ +000001a0: 6f20 496e 7661 7269 616e 7420 5365 6374  o Invariant Sect
│ │ │ │ +000001b0: 696f 6e73 2c20 6e6f 2046 726f 6e74 2d43  ions, no Front-C
│ │ │ │ +000001c0: 6f76 6572 2054 6578 7473 2c20 616e 640a  over Texts, and.
│ │ │ │ +000001d0: 2020 2020 206e 6f20 4261 636b 2d43 6f76       no Back-Cov
│ │ │ │ +000001e0: 6572 2054 6578 7473 2e20 2041 2063 6f70  er Texts.  A cop
│ │ │ │ +000001f0: 7920 6f66 2074 6865 206c 6963 656e 7365  y of the license
│ │ │ │ +00000200: 2069 7320 696e 636c 7564 6564 2069 6e20   is included in 
│ │ │ │ +00000210: 7468 650a 2020 2020 2073 6563 7469 6f6e  the.     section
│ │ │ │ +00000220: 2065 6e74 6974 6c65 6420 2247 4e55 2046   entitled "GNU F
│ │ │ │ +00000230: 7265 6520 446f 6375 6d65 6e74 6174 696f  ree Documentatio
│ │ │ │ +00000240: 6e20 4c69 6365 6e73 6522 2e0a 494e 464f  n License"..INFO
│ │ │ │ +00000250: 2d44 4952 2d53 4543 5449 4f4e 2047 4e55  -DIR-SECTION GNU
│ │ │ │ +00000260: 2075 7469 6c69 7469 6573 0a53 5441 5254   utilities.START
│ │ │ │ +00000270: 2d49 4e46 4f2d 4449 522d 454e 5452 590a  -INFO-DIR-ENTRY.
│ │ │ │ +00000280: 2a20 7368 6973 6869 3a20 2873 6869 7368  * shishi: (shish
│ │ │ │ +00000290: 6929 2e09 0941 204b 6572 6265 726f 7320  i)...A Kerberos 
│ │ │ │ +000002a0: 3520 696d 706c 656d 656e 7461 7469 6f6e  5 implementation
│ │ │ │ +000002b0: 0a45 4e44 2d49 4e46 4f2d 4449 522d 454e  .END-INFO-DIR-EN
│ │ │ │ +000002c0: 5452 590a 0a49 4e46 4f2d 4449 522d 5345  TRY..INFO-DIR-SE
│ │ │ │ +000002d0: 4354 494f 4e20 474e 5520 4c69 6272 6172  CTION GNU Librar
│ │ │ │ +000002e0: 6965 730a 5354 4152 542d 494e 464f 2d44  ies.START-INFO-D
│ │ │ │ +000002f0: 4952 2d45 4e54 5259 0a2a 206c 6962 7368  IR-ENTRY.* libsh
│ │ │ │ +00000300: 6973 6869 3a20 2873 6869 7368 6929 2e09  ishi: (shishi)..
│ │ │ │ +00000310: 094c 6962 7261 7279 2069 6d70 6c65 6d65  .Library impleme
│ │ │ │ +00000320: 6e74 696e 6720 4b65 7262 6572 6f73 2035  nting Kerberos 5
│ │ │ │ +00000330: 2e0a 454e 442d 494e 464f 2d44 4952 2d45  ..END-INFO-DIR-E
│ │ │ │ +00000340: 4e54 5259 0a0a 1f0a 496e 6469 7265 6374  NTRY....Indirect
│ │ │ │ +00000350: 3a0a 7368 6973 6869 2e69 6e66 6f2d 313a  :.shishi.info-1:
│ │ │ │ +00000360: 2038 3338 0a73 6869 7368 692e 696e 666f   838.shishi.info
│ │ │ │ +00000370: 2d32 3a20 3330 3532 3231 0a73 6869 7368  -2: 305221.shish
│ │ │ │ +00000380: 692e 696e 666f 2d33 3a20 3631 3237 3038  i.info-3: 612708
│ │ │ │ +00000390: 0a1f 0a54 6167 2054 6162 6c65 3a0a 2849  ...Tag Table:.(I
│ │ │ │ +000003a0: 6e64 6972 6563 7429 0a4e 6f64 653a 2054  ndirect).Node: T
│ │ │ │ +000003b0: 6f70 7f38 3338 0a4e 6f64 653a 2049 6e74  op.838.Node: Int
│ │ │ │ +000003c0: 726f 6475 6374 696f 6e7f 3232 3035 0a4e  roduction.2205.N
│ │ │ │ +000003d0: 6f64 653a 2047 6574 7469 6e67 2053 7461  ode: Getting Sta
│ │ │ │ +000003e0: 7274 6564 7f33 3936 330a 4e6f 6465 3a20  rted.3963.Node: 
│ │ │ │ +000003f0: 4665 6174 7572 6573 2061 6e64 2053 7461  Features and Sta
│ │ │ │ +00000400: 7475 737f 3438 3933 0a4e 6f64 653a 204f  tus.4893.Node: O
│ │ │ │ +00000410: 7665 7276 6965 777f 3938 3633 0a52 6566  verview.9863.Ref
│ │ │ │ +00000420: 3a20 4f76 6572 7669 6577 2d46 6f6f 746e  : Overview-Footn
│ │ │ │ +00000430: 6f74 652d 317f 3135 3133 390a 4e6f 6465  ote-1.15139.Node
│ │ │ │ +00000440: 3a20 4372 7970 746f 6772 6170 6869 6320  : Cryptographic 
│ │ │ │ +00000450: 4f76 6572 7669 6577 7f31 3533 3337 0a52  Overview.15337.R
│ │ │ │ +00000460: 6566 3a20 4372 7970 746f 6772 6170 6869  ef: Cryptographi
│ │ │ │ +00000470: 6320 4f76 6572 7669 6577 2d46 6f6f 746e  c Overview-Footn
│ │ │ │ +00000480: 6f74 652d 317f 3236 3037 320a 5265 663a  ote-1.26072.Ref:
│ │ │ │ +00000490: 2043 7279 7074 6f67 7261 7068 6963 204f   Cryptographic O
│ │ │ │ +000004a0: 7665 7276 6965 772d 466f 6f74 6e6f 7465  verview-Footnote
│ │ │ │ +000004b0: 2d32 7f32 3631 3331 0a4e 6f64 653a 2053  -2.26131.Node: S
│ │ │ │ +000004c0: 7570 706f 7274 6564 2050 6c61 7466 6f72  upported Platfor
│ │ │ │ +000004d0: 6d73 7f32 3631 3839 0a4e 6f64 653a 2047  ms.26189.Node: G
│ │ │ │ +000004e0: 6574 7469 6e67 2068 656c 707f 3239 3331  etting help.2931
│ │ │ │ +000004f0: 330a 4e6f 6465 3a20 446f 776e 6c6f 6164  3.Node: Download
│ │ │ │ +00000500: 696e 6720 616e 6420 496e 7374 616c 6c69  ing and Installi
│ │ │ │ +00000510: 6e67 7f32 3937 3834 0a4e 6f64 653a 2042  ng.29784.Node: B
│ │ │ │ +00000520: 7567 2052 6570 6f72 7473 7f33 3137 3136  ug Reports.31716
│ │ │ │ +00000530: 0a4e 6f64 653a 2043 6f6e 7472 6962 7574  .Node: Contribut
│ │ │ │ +00000540: 696e 677f 3333 3131 390a 4e6f 6465 3a20  ing.33119.Node: 
│ │ │ │ +00000550: 5573 6572 204d 616e 7561 6c7f 3335 3237  User Manual.3527
│ │ │ │ +00000560: 320a 4e6f 6465 3a20 4164 6d69 6e69 7374  2.Node: Administ
│ │ │ │ +00000570: 7261 7469 6f6e 204d 616e 7561 6c7f 3438  ration Manual.48
│ │ │ │ +00000580: 3131 380a 5265 663a 2041 646d 696e 6973  118.Ref: Adminis
│ │ │ │ +00000590: 7472 6174 696f 6e20 4d61 6e75 616c 2d46  tration Manual-F
│ │ │ │ +000005a0: 6f6f 746e 6f74 652d 317f 3439 3635 360a  ootnote-1.49656.
│ │ │ │ +000005b0: 4e6f 6465 3a20 496e 7472 6f64 7563 7469  Node: Introducti
│ │ │ │ +000005c0: 6f6e 2074 6f20 5368 6973 617f 3439 3733  on to Shisa.4973
│ │ │ │ +000005d0: 350a 4e6f 6465 3a20 436f 6e66 6967 7572  5.Node: Configur
│ │ │ │ +000005e0: 696e 6720 5368 6973 617f 3532 3236 340a  ing Shisa.52264.
│ │ │ │ +000005f0: 4e6f 6465 3a20 5573 696e 6720 5368 6973  Node: Using Shis
│ │ │ │ +00000600: 617f 3533 3730 360a 4e6f 6465 3a20 5374  a.53706.Node: St
│ │ │ │ +00000610: 6172 7469 6e67 2053 6869 7368 6964 7f36  arting Shishid.6
│ │ │ │ +00000620: 3431 3437 0a4e 6f64 653a 2043 6f6e 6669  4147.Node: Confi
│ │ │ │ +00000630: 6775 7269 6e67 2044 4e53 2066 6f72 204b  guring DNS for K
│ │ │ │ +00000640: 4443 7f36 3930 3938 0a4e 6f64 653a 204b  DC.69098.Node: K
│ │ │ │ +00000650: 6572 6265 726f 7320 7669 6120 544c 537f  erberos via TLS.
│ │ │ │ +00000660: 3733 3637 320a 4e6f 6465 3a20 4d75 6c74  73672.Node: Mult
│ │ │ │ +00000670: 6970 6c65 2073 6572 7665 7273 7f38 3837  iple servers.887
│ │ │ │ +00000680: 3735 0a4e 6f64 653a 2044 6576 656c 6f70  75.Node: Develop
│ │ │ │ +00000690: 6572 2069 6e66 6f72 6d61 7469 6f6e 7f39  er information.9
│ │ │ │ +000006a0: 3430 3330 0a4e 6f64 653a 2052 6566 6572  4030.Node: Refer
│ │ │ │ +000006b0: 656e 6365 204d 616e 7561 6c7f 3935 3335  ence Manual.9535
│ │ │ │ +000006c0: 330a 4e6f 6465 3a20 456e 7669 726f 6e6d  3.Node: Environm
│ │ │ │ +000006d0: 656e 7461 6c20 4173 7375 6d70 7469 6f6e  ental Assumption
│ │ │ │ +000006e0: 737f 3936 3530 340a 4e6f 6465 3a20 476c  s.96504.Node: Gl
│ │ │ │ +000006f0: 6f73 7361 7279 206f 6620 7465 726d 737f  ossary of terms.
│ │ │ │ +00000700: 3938 3733 360a 4e6f 6465 3a20 5265 616c  98736.Node: Real
│ │ │ │ +00000710: 6d20 616e 6420 5072 696e 6369 7061 6c20  m and Principal 
│ │ │ │ +00000720: 4e61 6d69 6e67 7f31 3034 3036 320a 5265  Naming.104062.Re
│ │ │ │ +00000730: 663a 206b 7262 7467 747f 3131 3234 3934  f: krbtgt.112494
│ │ │ │ +00000740: 0a4e 6f64 653a 2053 6869 7368 6920 436f  .Node: Shishi Co
│ │ │ │ +00000750: 6e66 6967 7572 6174 696f 6e7f 3131 3739  nfiguration.1179
│ │ │ │ +00000760: 3937 0a52 6566 3a20 7265 616c 6d2d 6b64  97.Ref: realm-kd
│ │ │ │ +00000770: 637f 3132 3034 3038 0a4e 6f64 653a 2053  c.120408.Node: S
│ │ │ │ +00000780: 6869 7361 2043 6f6e 6669 6775 7261 7469  hisa Configurati
│ │ │ │ +00000790: 6f6e 7f31 3233 3531 350a 4e6f 6465 3a20  on.123515.Node: 
│ │ │ │ +000007a0: 5061 7261 6d65 7465 7273 2066 6f72 2073  Parameters for s
│ │ │ │ +000007b0: 6869 7368 697f 3132 3632 3532 0a4e 6f64  hishi.126252.Nod
│ │ │ │ +000007c0: 653a 2050 6172 616d 6574 6572 7320 666f  e: Parameters fo
│ │ │ │ +000007d0: 7220 7368 6973 6869 647f 3133 3231 3832  r shishid.132182
│ │ │ │ +000007e0: 0a4e 6f64 653a 2050 6172 616d 6574 6572  .Node: Parameter
│ │ │ │ +000007f0: 7320 666f 7220 7368 6973 617f 3133 3435  s for shisa.1345
│ │ │ │ +00000800: 3631 0a4e 6f64 653a 2045 6e76 6972 6f6e  61.Node: Environ
│ │ │ │ +00000810: 6d65 6e74 2076 6172 6961 626c 6573 7f31  ment variables.1
│ │ │ │ +00000820: 3338 3136 340a 4e6f 6465 3a20 4461 7465  38164.Node: Date
│ │ │ │ +00000830: 2069 6e70 7574 2066 6f72 6d61 7473 7f31   input formats.1
│ │ │ │ +00000840: 3339 3335 330a 4e6f 6465 3a20 4765 6e65  39353.Node: Gene
│ │ │ │ +00000850: 7261 6c20 6461 7465 2073 796e 7461 787f  ral date syntax.
│ │ │ │ +00000860: 3134 3137 3533 0a4e 6f64 653a 2043 616c  141753.Node: Cal
│ │ │ │ +00000870: 656e 6461 7220 6461 7465 2069 7465 6d73  endar date items
│ │ │ │ +00000880: 7f31 3434 3838 310a 4e6f 6465 3a20 5469  .144881.Node: Ti
│ │ │ │ +00000890: 6d65 206f 6620 6461 7920 6974 656d 737f  me of day items.
│ │ │ │ +000008a0: 3134 3638 3637 0a4e 6f64 653a 2054 696d  146867.Node: Tim
│ │ │ │ +000008b0: 6520 7a6f 6e65 2069 7465 6d73 7f31 3439  e zone items.149
│ │ │ │ +000008c0: 3137 320a 4e6f 6465 3a20 436f 6d62 696e  172.Node: Combin
│ │ │ │ +000008d0: 6564 2064 6174 6520 616e 6420 7469 6d65  ed date and time
│ │ │ │ +000008e0: 206f 6620 6461 7920 6974 656d 737f 3135   of day items.15
│ │ │ │ +000008f0: 3035 3732 0a4e 6f64 653a 2044 6179 206f  0572.Node: Day o
│ │ │ │ +00000900: 6620 7765 656b 2069 7465 6d73 7f31 3531  f week items.151
│ │ │ │ +00000910: 3434 340a 4e6f 6465 3a20 5265 6c61 7469  444.Node: Relati
│ │ │ │ +00000920: 7665 2069 7465 6d73 2069 6e20 6461 7465  ve items in date
│ │ │ │ +00000930: 2073 7472 696e 6773 7f31 3532 3532 390a   strings.152529.
│ │ │ │ +00000940: 4e6f 6465 3a20 5075 7265 206e 756d 6265  Node: Pure numbe
│ │ │ │ +00000950: 7273 2069 6e20 6461 7465 2073 7472 696e  rs in date strin
│ │ │ │ +00000960: 6773 7f31 3535 3434 300a 4e6f 6465 3a20  gs.155440.Node: 
│ │ │ │ +00000970: 5365 636f 6e64 7320 7369 6e63 6520 7468  Seconds since th
│ │ │ │ +00000980: 6520 4570 6f63 687f 3135 3634 3330 0a4e  e Epoch.156430.N
│ │ │ │ +00000990: 6f64 653a 2053 7065 6369 6679 696e 6720  ode: Specifying 
│ │ │ │ +000009a0: 7469 6d65 207a 6f6e 6520 7275 6c65 737f  time zone rules.
│ │ │ │ +000009b0: 3135 3831 3537 0a4e 6f64 653a 2041 7574  158157.Node: Aut
│ │ │ │ +000009c0: 686f 7273 206f 6620 7061 7273 655f 6461  hors of parse_da
│ │ │ │ +000009d0: 7465 7469 6d65 7f31 3631 3538 370a 5265  tetime.161587.Re
│ │ │ │ +000009e0: 663a 2041 7574 686f 7273 206f 6620 6765  f: Authors of ge
│ │ │ │ +000009f0: 745f 6461 7465 7f31 3631 3737 390a 4e6f  t_date.161779.No
│ │ │ │ +00000a00: 6465 3a20 5072 6f67 7261 6d6d 696e 6720  de: Programming 
│ │ │ │ +00000a10: 4d61 6e75 616c 7f31 3632 3737 380a 4e6f  Manual.162778.No
│ │ │ │ +00000a20: 6465 3a20 5072 6570 6172 6174 696f 6e7f  de: Preparation.
│ │ │ │ +00000a30: 3136 3433 3931 0a4e 6f64 653a 2048 6561  164391.Node: Hea
│ │ │ │ +00000a40: 6465 727f 3136 3530 3832 0a4e 6f64 653a  der.165082.Node:
│ │ │ │ +00000a50: 2049 6e69 7469 616c 697a 6174 696f 6e7f   Initialization.
│ │ │ │ +00000a60: 3136 3537 3132 0a4e 6f64 653a 2056 6572  165712.Node: Ver
│ │ │ │ +00000a70: 7369 6f6e 2043 6865 636b 7f31 3636 3430  sion Check.16640
│ │ │ │ +00000a80: 350a 5265 663a 2073 6869 7368 695f 6368  5.Ref: shishi_ch
│ │ │ │ +00000a90: 6563 6b5f 7665 7273 696f 6e7f 3136 3639  eck_version.1669
│ │ │ │ +00000aa0: 3339 0a4e 6f64 653a 2042 7569 6c64 696e  39.Node: Buildin
│ │ │ │ +00000ab0: 6720 7468 6520 736f 7572 6365 7f31 3637  g the source.167
│ │ │ │ +00000ac0: 3834 360a 4e6f 6465 3a20 4175 746f 636f  846.Node: Autoco
│ │ │ │ +00000ad0: 6e66 2074 6573 7473 7f31 3639 3830 360a  nf tests.169806.
│ │ │ │ +00000ae0: 4e6f 6465 3a20 496e 6974 6961 6c69 7a61  Node: Initializa
│ │ │ │ +00000af0: 7469 6f6e 2046 756e 6374 696f 6e73 7f31  tion Functions.1
│ │ │ │ +00000b00: 3732 3739 360a 5265 663a 2073 6869 7368  72796.Ref: shish
│ │ │ │ +00000b10: 697f 3137 3239 3938 0a52 6566 3a20 7368  i.172998.Ref: sh
│ │ │ │ +00000b20: 6973 6869 5f73 6572 7665 727f 3137 3333  ishi_server.1733
│ │ │ │ +00000b30: 3932 0a52 6566 3a20 7368 6973 6869 5f64  92.Ref: shishi_d
│ │ │ │ +00000b40: 6f6e 657f 3137 3337 3832 0a52 6566 3a20  one.173782.Ref: 
│ │ │ │ +00000b50: 7368 6973 6869 5f69 6e69 747f 3137 3434  shishi_init.1744
│ │ │ │ +00000b60: 3431 0a52 6566 3a20 7368 6973 6869 5f69  41.Ref: shishi_i
│ │ │ │ +00000b70: 6e69 745f 7769 7468 5f70 6174 6873 7f31  nit_with_paths.1
│ │ │ │ +00000b80: 3735 3334 300a 5265 663a 2073 6869 7368  75340.Ref: shish
│ │ │ │ +00000b90: 695f 696e 6974 5f73 6572 7665 727f 3137  i_init_server.17
│ │ │ │ +00000ba0: 3636 3436 0a52 6566 3a20 7368 6973 6869  6646.Ref: shishi
│ │ │ │ +00000bb0: 5f69 6e69 745f 7365 7276 6572 5f77 6974  _init_server_wit
│ │ │ │ +00000bc0: 685f 7061 7468 737f 3137 3733 3735 0a52  h_paths.177375.R
│ │ │ │ +00000bd0: 6566 3a20 7368 6973 6869 5f63 6667 7f31  ef: shishi_cfg.1
│ │ │ │ +00000be0: 3738 3231 320a 5265 663a 2073 6869 7368  78212.Ref: shish
│ │ │ │ +00000bf0: 695f 6366 675f 6672 6f6d 5f66 696c 657f  i_cfg_from_file.
│ │ │ │ +00000c00: 3137 3836 3438 0a52 6566 3a20 7368 6973  178648.Ref: shis
│ │ │ │ +00000c10: 6869 5f63 6667 5f70 7269 6e74 7f31 3739  hi_cfg_print.179
│ │ │ │ +00000c20: 3033 340a 5265 663a 2073 6869 7368 695f  034.Ref: shishi_
│ │ │ │ +00000c30: 6366 675f 6465 6661 756c 745f 7379 7374  cfg_default_syst
│ │ │ │ +00000c40: 656d 6669 6c65 7f31 3739 3435 360a 5265  emfile.179456.Re
│ │ │ │ +00000c50: 663a 2073 6869 7368 695f 6366 675f 6465  f: shishi_cfg_de
│ │ │ │ +00000c60: 6661 756c 745f 7573 6572 6469 7265 6374  fault_userdirect
│ │ │ │ +00000c70: 6f72 797f 3138 3030 3632 0a52 6566 3a20  ory.180062.Ref: 
│ │ │ │ +00000c80: 7368 6973 6869 5f63 6667 5f75 7365 7264  shishi_cfg_userd
│ │ │ │ +00000c90: 6972 6563 746f 7279 5f66 696c 657f 3138  irectory_file.18
│ │ │ │ +00000ca0: 3038 3430 0a52 6566 3a20 7368 6973 6869  0840.Ref: shishi
│ │ │ │ +00000cb0: 5f63 6667 5f64 6566 6175 6c74 5f75 7365  _cfg_default_use
│ │ │ │ +00000cc0: 7266 696c 657f 3138 3137 3133 0a52 6566  rfile.181713.Ref
│ │ │ │ +00000cd0: 3a20 7368 6973 6869 5f63 6667 5f63 6c69  : shishi_cfg_cli
│ │ │ │ +00000ce0: 656e 746b 6463 6574 7970 657f 3138 3232  entkdcetype.1822
│ │ │ │ +00000cf0: 3632 0a52 6566 3a20 7368 6973 6869 5f63  62.Ref: shishi_c
│ │ │ │ +00000d00: 6667 5f63 6c69 656e 746b 6463 6574 7970  fg_clientkdcetyp
│ │ │ │ +00000d10: 655f 6661 7374 7f31 3832 3739 390a 5265  e_fast.182799.Re
│ │ │ │ +00000d20: 663a 2073 6869 7368 695f 6366 675f 636c  f: shishi_cfg_cl
│ │ │ │ +00000d30: 6965 6e74 6b64 6365 7479 7065 5f73 6574  ientkdcetype_set
│ │ │ │ +00000d40: 7f31 3833 3331 330a 5265 663a 2073 6869  .183313.Ref: shi
│ │ │ │ +00000d50: 7368 695f 6366 675f 6175 7468 6f72 697a  shi_cfg_authoriz
│ │ │ │ +00000d60: 6174 696f 6e74 7970 655f 7365 747f 3138  ationtype_set.18
│ │ │ │ +00000d70: 3430 3038 0a4e 6f64 653a 2054 6963 6b65  4008.Node: Ticke
│ │ │ │ +00000d80: 7420 5365 7420 4675 6e63 7469 6f6e 737f  t Set Functions.
│ │ │ │ +00000d90: 3138 3437 3134 0a52 6566 3a20 7368 6973  184714.Ref: shis
│ │ │ │ +00000da0: 6869 5f74 6b74 735f 6465 6661 756c 745f  hi_tkts_default_
│ │ │ │ +00000db0: 6669 6c65 5f67 7565 7373 7f31 3835 3632  file_guess.18562
│ │ │ │ +00000dc0: 380a 5265 663a 2073 6869 7368 695f 746b  8.Ref: shishi_tk
│ │ │ │ +00000dd0: 7473 5f64 6566 6175 6c74 5f66 696c 657f  ts_default_file.
│ │ │ │ +00000de0: 3138 3630 3934 0a52 6566 3a20 7368 6973  186094.Ref: shis
│ │ │ │ +00000df0: 6869 5f74 6b74 735f 6465 6661 756c 745f  hi_tkts_default_
│ │ │ │ +00000e00: 6669 6c65 5f73 6574 7f31 3836 3530 310a  file_set.186501.
│ │ │ │ +00000e10: 5265 663a 2073 6869 7368 695f 746b 7473  Ref: shishi_tkts
│ │ │ │ +00000e20: 5f64 6566 6175 6c74 7f31 3837 3030 310a  _default.187001.
│ │ │ │ +00000e30: 5265 663a 2073 6869 7368 695f 746b 7473  Ref: shishi_tkts
│ │ │ │ +00000e40: 7f31 3837 3238 360a 5265 663a 2073 6869  .187286.Ref: shi
│ │ │ │ +00000e50: 7368 695f 746b 7473 5f64 6f6e 657f 3138  shi_tkts_done.18
│ │ │ │ +00000e60: 3736 3235 0a52 6566 3a20 7368 6973 6869  7625.Ref: shishi
│ │ │ │ +00000e70: 5f74 6b74 735f 7369 7a65 7f31 3837 3936  _tkts_size.18796
│ │ │ │ +00000e80: 360a 5265 663a 2073 6869 7368 695f 746b  6.Ref: shishi_tk
│ │ │ │ +00000e90: 7473 5f6e 7468 7f31 3838 3233 370a 5265  ts_nth.188237.Re
│ │ │ │ +00000ea0: 663a 2073 6869 7368 695f 746b 7473 5f72  f: shishi_tkts_r
│ │ │ │ +00000eb0: 656d 6f76 657f 3138 3837 3737 0a52 6566  emove.188777.Ref
│ │ │ │ +00000ec0: 3a20 7368 6973 6869 5f74 6b74 735f 6164  : shishi_tkts_ad
│ │ │ │ +00000ed0: 647f 3138 3932 3331 0a52 6566 3a20 7368  d.189231.Ref: sh
│ │ │ │ +00000ee0: 6973 6869 5f74 6b74 735f 6e65 777f 3138  ishi_tkts_new.18
│ │ │ │ +00000ef0: 3936 3736 0a52 6566 3a20 7368 6973 6869  9676.Ref: shishi
│ │ │ │ +00000f00: 5f74 6b74 735f 7265 6164 7f31 3930 3336  _tkts_read.19036
│ │ │ │ +00000f10: 320a 5265 663a 2073 6869 7368 695f 746b  2.Ref: shishi_tk
│ │ │ │ +00000f20: 7473 5f66 726f 6d5f 6669 6c65 7f31 3930  ts_from_file.190
│ │ │ │ +00000f30: 3733 340a 5265 663a 2073 6869 7368 695f  734.Ref: shishi_
│ │ │ │ +00000f40: 746b 7473 5f77 7269 7465 7f31 3931 3132  tkts_write.19112
│ │ │ │ +00000f50: 310a 5265 663a 2073 6869 7368 695f 746b  1.Ref: shishi_tk
│ │ │ │ +00000f60: 7473 5f65 7870 6972 657f 3139 3134 3635  ts_expire.191465
│ │ │ │ +00000f70: 0a52 6566 3a20 7368 6973 6869 5f74 6b74  .Ref: shishi_tkt
│ │ │ │ +00000f80: 735f 746f 5f66 696c 657f 3139 3137 3534  s_to_file.191754
│ │ │ │ +00000f90: 0a52 6566 3a20 7368 6973 6869 5f74 6b74  .Ref: shishi_tkt
│ │ │ │ +00000fa0: 735f 7072 696e 745f 666f 725f 7365 7276  s_print_for_serv
│ │ │ │ +00000fb0: 6963 657f 3139 3231 3332 0a52 6566 3a20  ice.192132.Ref: 
│ │ │ │ +00000fc0: 7368 6973 6869 5f74 6b74 735f 7072 696e  shishi_tkts_prin
│ │ │ │ +00000fd0: 747f 3139 3236 3531 0a52 6566 3a20 7368  t.192651.Ref: sh
│ │ │ │ +00000fe0: 6973 6869 5f74 6b74 5f6d 6174 6368 5f70  ishi_tkt_match_p
│ │ │ │ +00000ff0: 7f31 3932 3939 390a 5265 663a 2073 6869  .192999.Ref: shi
│ │ │ │ +00001000: 7368 695f 746b 7473 5f66 696e 647f 3139  shi_tkts_find.19
│ │ │ │ +00001010: 3333 3633 0a52 6566 3a20 7368 6973 6869  3363.Ref: shishi
│ │ │ │ +00001020: 5f74 6b74 735f 6669 6e64 5f66 6f72 5f63  _tkts_find_for_c
│ │ │ │ +00001030: 6c69 656e 7473 6572 7665 727f 3139 3437  lientserver.1947
│ │ │ │ +00001040: 3239 0a52 6566 3a20 7368 6973 6869 5f74  29.Ref: shishi_t
│ │ │ │ +00001050: 6b74 735f 6669 6e64 5f66 6f72 5f73 6572  kts_find_for_ser
│ │ │ │ +00001060: 7665 727f 3139 3532 3932 0a52 6566 3a20  ver.195292.Ref: 
│ │ │ │ +00001070: 7368 6973 6869 5f74 6b74 735f 6765 745f  shishi_tkts_get_
│ │ │ │ +00001080: 7467 747f 3139 3538 3336 0a52 6566 3a20  tgt.195836.Ref: 
│ │ │ │ +00001090: 7368 6973 6869 5f74 6b74 735f 6765 745f  shishi_tkts_get_
│ │ │ │ +000010a0: 7467 737f 3139 3637 3231 0a52 6566 3a20  tgs.196721.Ref: 
│ │ │ │ +000010b0: 7368 6973 6869 5f74 6b74 735f 6765 747f  shishi_tkts_get.
│ │ │ │ +000010c0: 3139 3733 3838 0a52 6566 3a20 7368 6973  197388.Ref: shis
│ │ │ │ +000010d0: 6869 5f74 6b74 735f 6765 745f 666f 725f  hi_tkts_get_for_
│ │ │ │ +000010e0: 636c 6965 6e74 7365 7276 6572 7f31 3938  clientserver.198
│ │ │ │ +000010f0: 3136 360a 5265 663a 2073 6869 7368 695f  166.Ref: shishi_
│ │ │ │ +00001100: 746b 7473 5f67 6574 5f66 6f72 5f73 6572  tkts_get_for_ser
│ │ │ │ +00001110: 7665 727f 3139 3836 3937 0a52 6566 3a20  ver.198697.Ref: 
│ │ │ │ +00001120: 7368 6973 6869 5f74 6b74 735f 6765 745f  shishi_tkts_get_
│ │ │ │ +00001130: 666f 725f 6c6f 6361 6c73 6572 7669 6365  for_localservice
│ │ │ │ +00001140: 7061 7373 7764 7f31 3939 3231 310a 4e6f  passwd.199211.No
│ │ │ │ +00001150: 6465 3a20 4150 2d52 4551 2061 6e64 2041  de: AP-REQ and A
│ │ │ │ +00001160: 502d 5245 5020 4675 6e63 7469 6f6e 737f  P-REP Functions.
│ │ │ │ +00001170: 3139 3938 3131 0a52 6566 3a20 7368 6973  199811.Ref: shis
│ │ │ │ +00001180: 6869 5f61 707f 3230 3039 3836 0a52 6566  hi_ap.200986.Ref
│ │ │ │ +00001190: 3a20 7368 6973 6869 5f61 705f 6574 7970  : shishi_ap_etyp
│ │ │ │ +000011a0: 657f 3230 3137 3232 0a52 6566 3a20 7368  e.201722.Ref: sh
│ │ │ │ +000011b0: 6973 6869 5f61 705f 6e6f 7375 626b 6579  ishi_ap_nosubkey
│ │ │ │ +000011c0: 7f32 3032 3231 360a 5265 663a 2073 6869  .202216.Ref: shi
│ │ │ │ +000011d0: 7368 695f 6170 5f64 6f6e 657f 3230 3236  shi_ap_done.2026
│ │ │ │ +000011e0: 3034 0a52 6566 3a20 7368 6973 6869 5f61  04.Ref: shishi_a
│ │ │ │ +000011f0: 705f 7365 745f 746b 746f 7074 696f 6e73  p_set_tktoptions
│ │ │ │ +00001200: 7f32 3032 3934 370a 5265 663a 2073 6869  .202947.Ref: shi
│ │ │ │ +00001210: 7368 695f 6170 5f73 6574 5f74 6b74 6f70  shi_ap_set_tktop
│ │ │ │ +00001220: 7469 6f6e 7364 6174 617f 3230 3334 3430  tionsdata.203440
│ │ │ │ +00001230: 0a52 6566 3a20 7368 6973 6869 5f61 705f  .Ref: shishi_ap_
│ │ │ │ +00001240: 7365 745f 746b 746f 7074 696f 6e73 7261  set_tktoptionsra
│ │ │ │ +00001250: 777f 3230 3431 3436 0a52 6566 3a20 7368  w.204146.Ref: sh
│ │ │ │ +00001260: 6973 6869 5f61 705f 7365 745f 746b 746f  ishi_ap_set_tkto
│ │ │ │ +00001270: 7074 696f 6e73 6173 6e31 7573 6167 657f  ptionsasn1usage.
│ │ │ │ +00001280: 3230 3439 3934 0a52 6566 3a20 7368 6973  204994.Ref: shis
│ │ │ │ +00001290: 6869 5f61 705f 746b 746f 7074 696f 6e73  hi_ap_tktoptions
│ │ │ │ +000012a0: 7f32 3035 3932 340a 5265 663a 2073 6869  .205924.Ref: shi
│ │ │ │ +000012b0: 7368 695f 6170 5f74 6b74 6f70 7469 6f6e  shi_ap_tktoption
│ │ │ │ +000012c0: 7364 6174 617f 3230 3636 3530 0a52 6566  sdata.206650.Ref
│ │ │ │ +000012d0: 3a20 7368 6973 6869 5f61 705f 746b 746f  : shishi_ap_tkto
│ │ │ │ +000012e0: 7074 696f 6e73 7261 777f 3230 3735 3936  ptionsraw.207596
│ │ │ │ +000012f0: 0a52 6566 3a20 7368 6973 6869 5f61 705f  .Ref: shishi_ap_
│ │ │ │ +00001300: 6574 7970 655f 746b 746f 7074 696f 6e73  etype_tktoptions
│ │ │ │ +00001310: 6461 7461 7f32 3038 3638 310a 5265 663a  data.208681.Ref:
│ │ │ │ +00001320: 2073 6869 7368 695f 6170 5f74 6b74 6f70   shishi_ap_tktop
│ │ │ │ +00001330: 7469 6f6e 7361 736e 3175 7361 6765 7f32  tionsasn1usage.2
│ │ │ │ +00001340: 3039 3732 320a 5265 663a 2073 6869 7368  09722.Ref: shish
│ │ │ │ +00001350: 695f 6170 5f74 6b74 7f32 3130 3838 330a  i_ap_tkt.210883.
│ │ │ │ +00001360: 5265 663a 2073 6869 7368 695f 6170 5f74  Ref: shishi_ap_t
│ │ │ │ +00001370: 6b74 5f73 6574 7f32 3131 3230 310a 5265  kt_set.211201.Re
│ │ │ │ +00001380: 663a 2073 6869 7368 695f 6170 5f61 7574  f: shishi_ap_aut
│ │ │ │ +00001390: 6865 6e74 6963 6174 6f72 5f63 6b73 756d  henticator_cksum
│ │ │ │ +000013a0: 6461 7461 7f32 3131 3439 320a 5265 663a  data.211492.Ref:
│ │ │ │ +000013b0: 2073 6869 7368 695f 6170 5f61 7574 6865   shishi_ap_authe
│ │ │ │ +000013c0: 6e74 6963 6174 6f72 5f63 6b73 756d 6461  nticator_cksumda
│ │ │ │ +000013d0: 7461 5f73 6574 7f32 3132 3231 390a 5265  ta_set.212219.Re
│ │ │ │ +000013e0: 663a 2073 6869 7368 695f 6170 5f61 7574  f: shishi_ap_aut
│ │ │ │ +000013f0: 6865 6e74 6963 6174 6f72 5f63 6b73 756d  henticator_cksum
│ │ │ │ +00001400: 7261 775f 7365 747f 3231 3330 3335 0a52  raw_set.213035.R
│ │ │ │ +00001410: 6566 3a20 7368 6973 6869 5f61 705f 6175  ef: shishi_ap_au
│ │ │ │ +00001420: 7468 656e 7469 6361 746f 725f 636b 7375  thenticator_cksu
│ │ │ │ +00001430: 6d74 7970 657f 3231 3339 3430 0a52 6566  mtype.213940.Ref
│ │ │ │ +00001440: 3a20 7368 6973 6869 5f61 705f 6175 7468  : shishi_ap_auth
│ │ │ │ +00001450: 656e 7469 6361 746f 725f 636b 7375 6d74  enticator_cksumt
│ │ │ │ +00001460: 7970 655f 7365 747f 3231 3432 3935 0a52  ype_set.214295.R
│ │ │ │ +00001470: 6566 3a20 7368 6973 6869 5f61 705f 6175  ef: shishi_ap_au
│ │ │ │ +00001480: 7468 656e 7469 6361 746f 727f 3231 3436  thenticator.2146
│ │ │ │ +00001490: 3438 0a52 6566 3a20 7368 6973 6869 5f61  48.Ref: shishi_a
│ │ │ │ +000014a0: 705f 6175 7468 656e 7469 6361 746f 725f  p_authenticator_
│ │ │ │ +000014b0: 7365 747f 3231 3530 3235 0a52 6566 3a20  set.215025.Ref: 
│ │ │ │ +000014c0: 7368 6973 6869 5f61 705f 7265 717f 3231  shishi_ap_req.21
│ │ │ │ +000014d0: 3533 3239 0a52 6566 3a20 7368 6973 6869  5329.Ref: shishi
│ │ │ │ +000014e0: 5f61 705f 7265 715f 7365 747f 3231 3536  _ap_req_set.2156
│ │ │ │ +000014f0: 3632 0a52 6566 3a20 7368 6973 6869 5f61  62.Ref: shishi_a
│ │ │ │ +00001500: 705f 7265 715f 6465 727f 3231 3539 3233  p_req_der.215923
│ │ │ │ +00001510: 0a52 6566 3a20 7368 6973 6869 5f61 705f  .Ref: shishi_ap_
│ │ │ │ +00001520: 7265 715f 6465 725f 7365 747f 3231 3635  req_der_set.2165
│ │ │ │ +00001530: 3132 0a52 6566 3a20 7368 6973 6869 5f61  12.Ref: shishi_a
│ │ │ │ +00001540: 705f 7265 715f 6275 696c 647f 3231 3639  p_req_build.2169
│ │ │ │ +00001550: 3833 0a52 6566 3a20 7368 6973 6869 5f61  83.Ref: shishi_a
│ │ │ │ +00001560: 705f 7265 715f 6465 636f 6465 7f32 3137  p_req_decode.217
│ │ │ │ +00001570: 3239 390a 5265 663a 2073 6869 7368 695f  299.Ref: shishi_
│ │ │ │ +00001580: 6170 5f72 6571 5f70 726f 6365 7373 5f6b  ap_req_process_k
│ │ │ │ +00001590: 6579 7573 6167 657f 3231 3736 3331 0a52  eyusage.217631.R
│ │ │ │ +000015a0: 6566 3a20 7368 6973 6869 5f61 705f 7265  ef: shishi_ap_re
│ │ │ │ +000015b0: 715f 7072 6f63 6573 737f 3231 3834 3232  q_process.218422
│ │ │ │ +000015c0: 0a52 6566 3a20 7368 6973 6869 5f61 705f  .Ref: shishi_ap_
│ │ │ │ +000015d0: 7265 715f 6173 6e31 7f32 3138 3934 370a  req_asn1.218947.
│ │ │ │ +000015e0: 5265 663a 2073 6869 7368 695f 6170 5f6b  Ref: shishi_ap_k
│ │ │ │ +000015f0: 6579 7f32 3139 3330 320a 5265 663a 2073  ey.219302.Ref: s
│ │ │ │ +00001600: 6869 7368 695f 6170 5f72 6570 7f32 3139  hishi_ap_rep.219
│ │ │ │ +00001610: 3636 340a 5265 663a 2073 6869 7368 695f  664.Ref: shishi_
│ │ │ │ +00001620: 6170 5f72 6570 5f73 6574 7f32 3139 3939  ap_rep_set.21999
│ │ │ │ +00001630: 370a 5265 663a 2073 6869 7368 695f 6170  7.Ref: shishi_ap
│ │ │ │ +00001640: 5f72 6570 5f64 6572 7f32 3230 3235 380a  _rep_der.220258.
│ │ │ │ +00001650: 5265 663a 2073 6869 7368 695f 6170 5f72  Ref: shishi_ap_r
│ │ │ │ +00001660: 6570 5f64 6572 5f73 6574 7f32 3230 3833  ep_der_set.22083
│ │ │ │ +00001670: 360a 5265 663a 2073 6869 7368 695f 6170  6.Ref: shishi_ap
│ │ │ │ +00001680: 5f72 6570 5f62 7569 6c64 7f32 3231 3330  _rep_build.22130
│ │ │ │ +00001690: 370a 5265 663a 2073 6869 7368 695f 6170  7.Ref: shishi_ap
│ │ │ │ +000016a0: 5f72 6570 5f61 736e 317f 3232 3136 3139  _rep_asn1.221619
│ │ │ │ +000016b0: 0a52 6566 3a20 7368 6973 6869 5f61 705f  .Ref: shishi_ap_
│ │ │ │ +000016c0: 7265 705f 7665 7269 6679 7f32 3231 3938  rep_verify.22198
│ │ │ │ +000016d0: 380a 5265 663a 2073 6869 7368 695f 6170  8.Ref: shishi_ap
│ │ │ │ +000016e0: 5f72 6570 5f76 6572 6966 795f 6465 727f  _rep_verify_der.
│ │ │ │ +000016f0: 3232 3233 3034 0a52 6566 3a20 7368 6973  222304.Ref: shis
│ │ │ │ +00001700: 6869 5f61 705f 7265 705f 7665 7269 6679  hi_ap_rep_verify
│ │ │ │ +00001710: 5f61 736e 317f 3232 3238 3639 0a52 6566  _asn1.222869.Ref
│ │ │ │ +00001720: 3a20 7368 6973 6869 5f61 705f 656e 6361  : shishi_ap_enca
│ │ │ │ +00001730: 7072 6570 7061 7274 7f32 3233 3332 310a  preppart.223321.
│ │ │ │ +00001740: 5265 663a 2073 6869 7368 695f 6170 5f65  Ref: shishi_ap_e
│ │ │ │ +00001750: 6e63 6170 7265 7070 6172 745f 7365 747f  ncapreppart_set.
│ │ │ │ +00001760: 3232 3336 3933 0a52 6566 3a20 7368 6973  223693.Ref: shis
│ │ │ │ +00001770: 6869 5f61 705f 6f70 7469 6f6e 3273 7472  hi_ap_option2str
│ │ │ │ +00001780: 696e 677f 3232 3430 3132 0a52 6566 3a20  ing.224012.Ref: 
│ │ │ │ +00001790: 7368 6973 6869 5f61 705f 7374 7269 6e67  shishi_ap_string
│ │ │ │ +000017a0: 326f 7074 696f 6e7f 3232 3435 3631 0a52  2option.224561.R
│ │ │ │ +000017b0: 6566 3a20 7368 6973 6869 5f61 7072 6571  ef: shishi_apreq
│ │ │ │ +000017c0: 7f32 3234 3935 320a 5265 663a 2073 6869  .224952.Ref: shi
│ │ │ │ +000017d0: 7368 695f 6170 7265 715f 7072 696e 747f  shi_apreq_print.
│ │ │ │ +000017e0: 3232 3532 3732 0a52 6566 3a20 7368 6973  225272.Ref: shis
│ │ │ │ +000017f0: 6869 5f61 7072 6571 5f73 6176 657f 3232  hi_apreq_save.22
│ │ │ │ +00001800: 3536 3636 0a52 6566 3a20 7368 6973 6869  5666.Ref: shishi
│ │ │ │ +00001810: 5f61 7072 6571 5f74 6f5f 6669 6c65 7f32  _apreq_to_file.2
│ │ │ │ +00001820: 3236 3034 390a 5265 663a 2073 6869 7368  26049.Ref: shish
│ │ │ │ +00001830: 695f 6170 7265 715f 7061 7273 657f 3232  i_apreq_parse.22
│ │ │ │ +00001840: 3636 3139 0a52 6566 3a20 7368 6973 6869  6619.Ref: shishi
│ │ │ │ +00001850: 5f61 7072 6571 5f72 6561 647f 3232 3730  _apreq_read.2270
│ │ │ │ +00001860: 3733 0a52 6566 3a20 7368 6973 6869 5f61  73.Ref: shishi_a
│ │ │ │ +00001870: 7072 6571 5f66 726f 6d5f 6669 6c65 7f32  preq_from_file.2
│ │ │ │ +00001880: 3237 3532 320a 5265 663a 2073 6869 7368  27522.Ref: shish
│ │ │ │ +00001890: 695f 6170 7265 715f 7365 745f 6175 7468  i_apreq_set_auth
│ │ │ │ +000018a0: 656e 7469 6361 746f 727f 3232 3831 3032  enticator.228102
│ │ │ │ +000018b0: 0a52 6566 3a20 7368 6973 6869 5f61 7072  .Ref: shishi_apr
│ │ │ │ +000018c0: 6571 5f61 6464 5f61 7574 6865 6e74 6963  eq_add_authentic
│ │ │ │ +000018d0: 6174 6f72 7f32 3239 3039 320a 5265 663a  ator.229092.Ref:
│ │ │ │ +000018e0: 2073 6869 7368 695f 6170 7265 715f 7365   shishi_apreq_se
│ │ │ │ +000018f0: 745f 7469 636b 6574 7f32 3239 3736 380a  t_ticket.229768.
│ │ │ │ +00001900: 5265 663a 2073 6869 7368 695f 6170 7265  Ref: shishi_apre
│ │ │ │ +00001910: 715f 6f70 7469 6f6e 737f 3233 3031 3930  q_options.230190
│ │ │ │ +00001920: 0a52 6566 3a20 7368 6973 6869 5f61 7072  .Ref: shishi_apr
│ │ │ │ +00001930: 6571 5f75 7365 5f73 6573 7369 6f6e 5f6b  eq_use_session_k
│ │ │ │ +00001940: 6579 5f70 7f32 3330 3635 390a 5265 663a  ey_p.230659.Ref:
│ │ │ │ +00001950: 2073 6869 7368 695f 6170 7265 715f 6d75   shishi_apreq_mu
│ │ │ │ +00001960: 7475 616c 5f72 6571 7569 7265 645f 707f  tual_required_p.
│ │ │ │ +00001970: 3233 3130 3930 0a52 6566 3a20 7368 6973  231090.Ref: shis
│ │ │ │ +00001980: 6869 5f61 7072 6571 5f6f 7074 696f 6e73  hi_apreq_options
│ │ │ │ +00001990: 5f73 6574 7f32 3331 3530 390a 5265 663a  _set.231509.Ref:
│ │ │ │ +000019a0: 2073 6869 7368 695f 6170 7265 715f 6f70   shishi_apreq_op
│ │ │ │ +000019b0: 7469 6f6e 735f 6164 647f 3233 3139 3537  tions_add.231957
│ │ │ │ +000019c0: 0a52 6566 3a20 7368 6973 6869 5f61 7072  .Ref: shishi_apr
│ │ │ │ +000019d0: 6571 5f6f 7074 696f 6e73 5f72 656d 6f76  eq_options_remov
│ │ │ │ +000019e0: 657f 3233 3234 3635 0a52 6566 3a20 7368  e.232465.Ref: sh
│ │ │ │ +000019f0: 6973 6869 5f61 7072 6571 5f67 6574 5f61  ishi_apreq_get_a
│ │ │ │ +00001a00: 7574 6865 6e74 6963 6174 6f72 5f65 7479  uthenticator_ety
│ │ │ │ +00001a10: 7065 7f32 3333 3030 340a 5265 663a 2073  pe.233004.Ref: s
│ │ │ │ +00001a20: 6869 7368 695f 6170 7265 715f 6765 745f  hishi_apreq_get_
│ │ │ │ +00001a30: 7469 636b 6574 7f32 3333 3434 370a 5265  ticket.233447.Re
│ │ │ │ +00001a40: 663a 2073 6869 7368 695f 6170 7265 707f  f: shishi_aprep.
│ │ │ │ +00001a50: 3233 3338 3538 0a52 6566 3a20 7368 6973  233858.Ref: shis
│ │ │ │ +00001a60: 6869 5f61 7072 6570 5f70 7269 6e74 7f32  hi_aprep_print.2
│ │ │ │ +00001a70: 3334 3138 350a 5265 663a 2073 6869 7368  34185.Ref: shish
│ │ │ │ +00001a80: 695f 6170 7265 705f 7361 7665 7f32 3334  i_aprep_save.234
│ │ │ │ +00001a90: 3537 390a 5265 663a 2073 6869 7368 695f  579.Ref: shishi_
│ │ │ │ +00001aa0: 6170 7265 705f 746f 5f66 696c 657f 3233  aprep_to_file.23
│ │ │ │ +00001ab0: 3439 3632 0a52 6566 3a20 7368 6973 6869  4962.Ref: shishi
│ │ │ │ +00001ac0: 5f61 7072 6570 5f70 6172 7365 7f32 3335  _aprep_parse.235
│ │ │ │ +00001ad0: 3533 320a 5265 663a 2073 6869 7368 695f  532.Ref: shishi_
│ │ │ │ +00001ae0: 6170 7265 705f 7265 6164 7f32 3335 3938  aprep_read.23598
│ │ │ │ +00001af0: 360a 5265 663a 2073 6869 7368 695f 6170  6.Ref: shishi_ap
│ │ │ │ +00001b00: 7265 705f 6672 6f6d 5f66 696c 657f 3233  rep_from_file.23
│ │ │ │ +00001b10: 3634 3335 0a52 6566 3a20 7368 6973 6869  6435.Ref: shishi
│ │ │ │ +00001b20: 5f61 7072 6570 5f67 6574 5f65 6e63 5f70  _aprep_get_enc_p
│ │ │ │ +00001b30: 6172 745f 6574 7970 657f 3233 3730 3137  art_etype.237017
│ │ │ │ +00001b40: 0a52 6566 3a20 7368 6973 6869 5f65 6e63  .Ref: shishi_enc
│ │ │ │ +00001b50: 6170 7265 7070 6172 747f 3233 3734 3432  apreppart.237442
│ │ │ │ +00001b60: 0a52 6566 3a20 7368 6973 6869 5f65 6e63  .Ref: shishi_enc
│ │ │ │ +00001b70: 6170 7265 7070 6172 745f 7072 696e 747f  apreppart_print.
│ │ │ │ +00001b80: 3233 3738 3834 0a52 6566 3a20 7368 6973  237884.Ref: shis
│ │ │ │ +00001b90: 6869 5f65 6e63 6170 7265 7070 6172 745f  hi_encapreppart_
│ │ │ │ +00001ba0: 7361 7665 7f32 3338 3333 300a 5265 663a  save.238330.Ref:
│ │ │ │ +00001bb0: 2073 6869 7368 695f 656e 6361 7072 6570   shishi_encaprep
│ │ │ │ +00001bc0: 7061 7274 5f74 6f5f 6669 6c65 7f32 3338  part_to_file.238
│ │ │ │ +00001bd0: 3736 300a 5265 663a 2073 6869 7368 695f  760.Ref: shishi_
│ │ │ │ +00001be0: 656e 6361 7072 6570 7061 7274 5f70 6172  encapreppart_par
│ │ │ │ +00001bf0: 7365 7f32 3339 3337 370a 5265 663a 2073  se.239377.Ref: s
│ │ │ │ +00001c00: 6869 7368 695f 656e 6361 7072 6570 7061  hishi_encapreppa
│ │ │ │ +00001c10: 7274 5f72 6561 647f 3233 3938 3738 0a52  rt_read.239878.R
│ │ │ │ +00001c20: 6566 3a20 7368 6973 6869 5f65 6e63 6170  ef: shishi_encap
│ │ │ │ +00001c30: 7265 7070 6172 745f 6672 6f6d 5f66 696c  reppart_from_fil
│ │ │ │ +00001c40: 657f 3234 3033 3734 0a52 6566 3a20 7368  e.240374.Ref: sh
│ │ │ │ +00001c50: 6973 6869 5f65 6e63 6170 7265 7070 6172  ishi_encapreppar
│ │ │ │ +00001c60: 745f 6765 745f 6b65 797f 3234 3039 3931  t_get_key.240991
│ │ │ │ +00001c70: 0a52 6566 3a20 7368 6973 6869 5f65 6e63  .Ref: shishi_enc
│ │ │ │ +00001c80: 6170 7265 7070 6172 745f 6374 696d 657f  apreppart_ctime.
│ │ │ │ +00001c90: 3234 3134 3431 0a52 6566 3a20 7368 6973  241441.Ref: shis
│ │ │ │ +00001ca0: 6869 5f65 6e63 6170 7265 7070 6172 745f  hi_encapreppart_
│ │ │ │ +00001cb0: 6374 696d 655f 7365 747f 3234 3139 3439  ctime_set.241949
│ │ │ │ +00001cc0: 0a52 6566 3a20 7368 6973 6869 5f65 6e63  .Ref: shishi_enc
│ │ │ │ +00001cd0: 6170 7265 7070 6172 745f 6375 7365 635f  apreppart_cusec_
│ │ │ │ +00001ce0: 6765 747f 3234 3234 3532 0a52 6566 3a20  get.242452.Ref: 
│ │ │ │ +00001cf0: 7368 6973 6869 5f65 6e63 6170 7265 7070  shishi_encaprepp
│ │ │ │ +00001d00: 6172 745f 6375 7365 635f 7365 747f 3234  art_cusec_set.24
│ │ │ │ +00001d10: 3239 3635 0a52 6566 3a20 7368 6973 6869  2965.Ref: shishi
│ │ │ │ +00001d20: 5f65 6e63 6170 7265 7070 6172 745f 7365  _encapreppart_se
│ │ │ │ +00001d30: 716e 756d 6265 725f 6765 747f 3234 3334  qnumber_get.2434
│ │ │ │ +00001d40: 3831 0a52 6566 3a20 7368 6973 6869 5f65  81.Ref: shishi_e
│ │ │ │ +00001d50: 6e63 6170 7265 7070 6172 745f 7365 716e  ncapreppart_seqn
│ │ │ │ +00001d60: 756d 6265 725f 7265 6d6f 7665 7f32 3434  umber_remove.244
│ │ │ │ +00001d70: 3031 320a 5265 663a 2073 6869 7368 695f  012.Ref: shishi_
│ │ │ │ +00001d80: 656e 6361 7072 6570 7061 7274 5f73 6571  encapreppart_seq
│ │ │ │ +00001d90: 6e75 6d62 6572 5f73 6574 7f32 3434 3436  number_set.24446
│ │ │ │ +00001da0: 310a 5265 663a 2073 6869 7368 695f 656e  1.Ref: shishi_en
│ │ │ │ +00001db0: 6361 7072 6570 7061 7274 5f74 696d 655f  capreppart_time_
│ │ │ │ +00001dc0: 636f 7079 7f32 3435 3030 310a 4e6f 6465  copy.245001.Node
│ │ │ │ +00001dd0: 3a20 5341 4645 2061 6e64 2050 5249 5620  : SAFE and PRIV 
│ │ │ │ +00001de0: 4675 6e63 7469 6f6e 737f 3234 3534 3730  Functions.245470
│ │ │ │ +00001df0: 0a52 6566 3a20 7368 6973 6869 5f73 6166  .Ref: shishi_saf
│ │ │ │ +00001e00: 657f 3234 3635 3536 0a52 6566 3a20 7368  e.246556.Ref: sh
│ │ │ │ +00001e10: 6973 6869 5f73 6166 655f 646f 6e65 7f32  ishi_safe_done.2
│ │ │ │ +00001e20: 3436 3931 340a 5265 663a 2073 6869 7368  46914.Ref: shish
│ │ │ │ +00001e30: 695f 7361 6665 5f6b 6579 7f32 3437 3235  i_safe_key.24725
│ │ │ │ +00001e40: 330a 5265 663a 2073 6869 7368 695f 7361  3.Ref: shishi_sa
│ │ │ │ +00001e50: 6665 5f6b 6579 5f73 6574 7f32 3437 3539  fe_key_set.24759
│ │ │ │ +00001e60: 370a 5265 663a 2073 6869 7368 695f 7361  7.Ref: shishi_sa
│ │ │ │ +00001e70: 6665 5f73 6166 657f 3234 3738 3732 0a52  fe_safe.247872.R
│ │ │ │ +00001e80: 6566 3a20 7368 6973 6869 5f73 6166 655f  ef: shishi_safe_
│ │ │ │ +00001e90: 7361 6665 5f73 6574 7f32 3438 3232 370a  safe_set.248227.
│ │ │ │ +00001ea0: 5265 663a 2073 6869 7368 695f 7361 6665  Ref: shishi_safe
│ │ │ │ +00001eb0: 5f73 6166 655f 6465 727f 3234 3835 3339  _safe_der.248539
│ │ │ │ +00001ec0: 0a52 6566 3a20 7368 6973 6869 5f73 6166  .Ref: shishi_saf
│ │ │ │ +00001ed0: 655f 7361 6665 5f64 6572 5f73 6574 7f32  e_safe_der_set.2
│ │ │ │ +00001ee0: 3439 3136 340a 5265 663a 2073 6869 7368  49164.Ref: shish
│ │ │ │ +00001ef0: 695f 7361 6665 5f70 7269 6e74 7f32 3439  i_safe_print.249
│ │ │ │ +00001f00: 3634 330a 5265 663a 2073 6869 7368 695f  643.Ref: shishi_
│ │ │ │ +00001f10: 7361 6665 5f73 6176 657f 3235 3030 3238  safe_save.250028
│ │ │ │ +00001f20: 0a52 6566 3a20 7368 6973 6869 5f73 6166  .Ref: shishi_saf
│ │ │ │ +00001f30: 655f 746f 5f66 696c 657f 3235 3034 3032  e_to_file.250402
│ │ │ │ +00001f40: 0a52 6566 3a20 7368 6973 6869 5f73 6166  .Ref: shishi_saf
│ │ │ │ +00001f50: 655f 7061 7273 657f 3235 3039 3633 0a52  e_parse.250963.R
│ │ │ │ +00001f60: 6566 3a20 7368 6973 6869 5f73 6166 655f  ef: shishi_safe_
│ │ │ │ +00001f70: 7265 6164 7f32 3531 3430 380a 5265 663a  read.251408.Ref:
│ │ │ │ +00001f80: 2073 6869 7368 695f 7361 6665 5f66 726f   shishi_safe_fro
│ │ │ │ +00001f90: 6d5f 6669 6c65 7f32 3531 3834 380a 5265  m_file.251848.Re
│ │ │ │ +00001fa0: 663a 2073 6869 7368 695f 7361 6665 5f63  f: shishi_safe_c
│ │ │ │ +00001fb0: 6b73 756d 7f32 3532 3339 350a 5265 663a  ksum.252395.Ref:
│ │ │ │ +00001fc0: 2073 6869 7368 695f 7361 6665 5f73 6574   shishi_safe_set
│ │ │ │ +00001fd0: 5f63 6b73 756d 7f32 3533 3037 390a 5265  _cksum.253079.Re
│ │ │ │ +00001fe0: 663a 2073 6869 7368 695f 7361 6665 5f75  f: shishi_safe_u
│ │ │ │ +00001ff0: 7365 725f 6461 7461 7f32 3533 3937 320a  ser_data.253972.
│ │ │ │ +00002000: 5265 663a 2073 6869 7368 695f 7361 6665  Ref: shishi_safe
│ │ │ │ +00002010: 5f73 6574 5f75 7365 725f 6461 7461 7f32  _set_user_data.2
│ │ │ │ +00002020: 3534 3632 360a 5265 663a 2073 6869 7368  54626.Ref: shish
│ │ │ │ +00002030: 695f 7361 6665 5f62 7569 6c64 7f32 3535  i_safe_build.255
│ │ │ │ +00002040: 3134 380a 5265 663a 2073 6869 7368 695f  148.Ref: shishi_
│ │ │ │ +00002050: 7361 6665 5f76 6572 6966 797f 3235 3536  safe_verify.2556
│ │ │ │ +00002060: 3432 0a52 6566 3a20 7368 6973 6869 5f70  42.Ref: shishi_p
│ │ │ │ +00002070: 7269 767f 3235 3731 3839 0a52 6566 3a20  riv.257189.Ref: 
│ │ │ │ +00002080: 7368 6973 6869 5f70 7269 765f 646f 6e65  shishi_priv_done
│ │ │ │ +00002090: 7f32 3537 3534 370a 5265 663a 2073 6869  .257547.Ref: shi
│ │ │ │ +000020a0: 7368 695f 7072 6976 5f6b 6579 7f32 3537  shi_priv_key.257
│ │ │ │ +000020b0: 3838 360a 5265 663a 2073 6869 7368 695f  886.Ref: shishi_
│ │ │ │ +000020c0: 7072 6976 5f6b 6579 5f73 6574 7f32 3538  priv_key_set.258
│ │ │ │ +000020d0: 3231 390a 5265 663a 2073 6869 7368 695f  219.Ref: shishi_
│ │ │ │ +000020e0: 7072 6976 5f70 7269 767f 3235 3834 3934  priv_priv.258494
│ │ │ │ +000020f0: 0a52 6566 3a20 7368 6973 6869 5f70 7269  .Ref: shishi_pri
│ │ │ │ +00002100: 765f 7072 6976 5f73 6574 7f32 3538 3834  v_priv_set.25884
│ │ │ │ +00002110: 360a 5265 663a 2073 6869 7368 695f 7072  6.Ref: shishi_pr
│ │ │ │ +00002120: 6976 5f70 7269 765f 6465 727f 3235 3931  iv_priv_der.2591
│ │ │ │ +00002130: 3538 0a52 6566 3a20 7368 6973 6869 5f70  58.Ref: shishi_p
│ │ │ │ +00002140: 7269 765f 7072 6976 5f64 6572 5f73 6574  riv_priv_der_set
│ │ │ │ +00002150: 7f32 3539 3738 330a 5265 663a 2073 6869  .259783.Ref: shi
│ │ │ │ +00002160: 7368 695f 7072 6976 5f65 6e63 7072 6976  shi_priv_encpriv
│ │ │ │ +00002170: 7061 7274 7f32 3630 3237 340a 5265 663a  part.260274.Ref:
│ │ │ │ +00002180: 2073 6869 7368 695f 7072 6976 5f65 6e63   shishi_priv_enc
│ │ │ │ +00002190: 7072 6976 7061 7274 5f73 6574 7f32 3630  privpart_set.260
│ │ │ │ +000021a0: 3636 330a 5265 663a 2073 6869 7368 695f  663.Ref: shishi_
│ │ │ │ +000021b0: 7072 6976 5f65 6e63 7072 6976 7061 7274  priv_encprivpart
│ │ │ │ +000021c0: 5f64 6572 7f32 3631 3031 360a 5265 663a  _der.261016.Ref:
│ │ │ │ +000021d0: 2073 6869 7368 695f 7072 6976 5f65 6e63   shishi_priv_enc
│ │ │ │ +000021e0: 7072 6976 7061 7274 5f64 6572 5f73 6574  privpart_der_set
│ │ │ │ +000021f0: 7f32 3631 3630 300a 5265 663a 2073 6869  .261600.Ref: shi
│ │ │ │ +00002200: 7368 695f 7072 6976 5f70 7269 6e74 7f32  shi_priv_print.2
│ │ │ │ +00002210: 3632 3039 380a 5265 663a 2073 6869 7368  62098.Ref: shish
│ │ │ │ +00002220: 695f 7072 6976 5f73 6176 657f 3236 3234  i_priv_save.2624
│ │ │ │ +00002230: 3833 0a52 6566 3a20 7368 6973 6869 5f70  83.Ref: shishi_p
│ │ │ │ +00002240: 7269 765f 746f 5f66 696c 657f 3236 3238  riv_to_file.2628
│ │ │ │ +00002250: 3537 0a52 6566 3a20 7368 6973 6869 5f70  57.Ref: shishi_p
│ │ │ │ +00002260: 7269 765f 7061 7273 657f 3236 3334 3138  riv_parse.263418
│ │ │ │ +00002270: 0a52 6566 3a20 7368 6973 6869 5f70 7269  .Ref: shishi_pri
│ │ │ │ +00002280: 765f 7265 6164 7f32 3633 3836 330a 5265  v_read.263863.Re
│ │ │ │ +00002290: 663a 2073 6869 7368 695f 7072 6976 5f66  f: shishi_priv_f
│ │ │ │ +000022a0: 726f 6d5f 6669 6c65 7f32 3634 3330 330a  rom_file.264303.
│ │ │ │ +000022b0: 5265 663a 2073 6869 7368 695f 7072 6976  Ref: shishi_priv
│ │ │ │ +000022c0: 5f65 6e63 5f70 6172 745f 6574 7970 657f  _enc_part_etype.
│ │ │ │ +000022d0: 3236 3438 3638 0a52 6566 3a20 7368 6973  264868.Ref: shis
│ │ │ │ +000022e0: 6869 5f70 7269 765f 7365 745f 656e 635f  hi_priv_set_enc_
│ │ │ │ +000022f0: 7061 7274 7f32 3635 3239 320a 5265 663a  part.265292.Ref:
│ │ │ │ +00002300: 2073 6869 7368 695f 656e 6370 7269 7670   shishi_encprivp
│ │ │ │ +00002310: 6172 745f 7573 6572 5f64 6174 617f 3236  art_user_data.26
│ │ │ │ +00002320: 3632 3038 0a52 6566 3a20 7368 6973 6869  6208.Ref: shishi
│ │ │ │ +00002330: 5f65 6e63 7072 6976 7061 7274 5f73 6574  _encprivpart_set
│ │ │ │ +00002340: 5f75 7365 725f 6461 7461 7f32 3636 3931  _user_data.26691
│ │ │ │ +00002350: 340a 5265 663a 2073 6869 7368 695f 7072  4.Ref: shishi_pr
│ │ │ │ +00002360: 6976 5f62 7569 6c64 7f32 3637 3437 340a  iv_build.267474.
│ │ │ │ +00002370: 5265 663a 2073 6869 7368 695f 7072 6976  Ref: shishi_priv
│ │ │ │ +00002380: 5f70 726f 6365 7373 7f32 3637 3936 360a  _process.267966.
│ │ │ │ +00002390: 4e6f 6465 3a20 5469 636b 6574 2046 756e  Node: Ticket Fun
│ │ │ │ +000023a0: 6374 696f 6e73 7f32 3638 3434 320a 5265  ctions.268442.Re
│ │ │ │ +000023b0: 663a 2073 6869 7368 695f 746b 747f 3236  f: shishi_tkt.26
│ │ │ │ +000023c0: 3930 3231 0a52 6566 3a20 7368 6973 6869  9021.Ref: shishi
│ │ │ │ +000023d0: 5f74 6b74 327f 3236 3933 3337 0a52 6566  _tkt2.269337.Ref
│ │ │ │ +000023e0: 3a20 7368 6973 6869 5f74 6b74 5f64 6f6e  : shishi_tkt_don
│ │ │ │ +000023f0: 657f 3236 3938 3733 0a52 6566 3a20 7368  e.269873.Ref: sh
│ │ │ │ +00002400: 6973 6869 5f74 6b74 5f74 6963 6b65 747f  ishi_tkt_ticket.
│ │ │ │ +00002410: 3237 3031 3331 0a52 6566 3a20 7368 6973  270131.Ref: shis
│ │ │ │ +00002420: 6869 5f74 6b74 5f74 6963 6b65 745f 7365  hi_tkt_ticket_se
│ │ │ │ +00002430: 747f 3237 3033 3839 0a52 6566 3a20 7368  t.270389.Ref: sh
│ │ │ │ +00002440: 6973 6869 5f74 6b74 5f65 6e63 6b64 6372  ishi_tkt_enckdcr
│ │ │ │ +00002450: 6570 7061 7274 7f32 3730 3637 370a 5265  eppart.270677.Re
│ │ │ │ +00002460: 663a 2073 6869 7368 695f 746b 745f 656e  f: shishi_tkt_en
│ │ │ │ +00002470: 636b 6463 7265 7070 6172 745f 7365 747f  ckdcreppart_set.
│ │ │ │ +00002480: 3237 3039 3738 0a52 6566 3a20 7368 6973  270978.Ref: shis
│ │ │ │ +00002490: 6869 5f74 6b74 5f6b 6463 7265 707f 3237  hi_tkt_kdcrep.27
│ │ │ │ +000024a0: 3132 3937 0a52 6566 3a20 7368 6973 6869  1297.Ref: shishi
│ │ │ │ +000024b0: 5f74 6b74 5f65 6e63 7469 636b 6574 7061  _tkt_encticketpa
│ │ │ │ +000024c0: 7274 7f32 3731 3536 370a 5265 663a 2073  rt.271567.Ref: s
│ │ │ │ +000024d0: 6869 7368 695f 746b 745f 656e 6374 6963  hishi_tkt_enctic
│ │ │ │ +000024e0: 6b65 7470 6172 745f 7365 747f 3237 3138  ketpart_set.2718
│ │ │ │ +000024f0: 3635 0a52 6566 3a20 7368 6973 6869 5f74  65.Ref: shishi_t
│ │ │ │ +00002500: 6b74 5f6b 6579 7f32 3732 3135 360a 5265  kt_key.272156.Re
│ │ │ │ +00002510: 663a 2073 6869 7368 695f 746b 745f 6b65  f: shishi_tkt_ke
│ │ │ │ +00002520: 795f 7365 747f 3237 3235 3539 0a52 6566  y_set.272559.Ref
│ │ │ │ +00002530: 3a20 7368 6973 6869 5f74 6b74 5f63 6c69  : shishi_tkt_cli
│ │ │ │ +00002540: 656e 747f 3237 3238 3639 0a52 6566 3a20  ent.272869.Ref: 
│ │ │ │ +00002550: 7368 6973 6869 5f74 6b74 5f63 6c69 656e  shishi_tkt_clien
│ │ │ │ +00002560: 745f 707f 3237 3336 3933 0a52 6566 3a20  t_p.273693.Ref: 
│ │ │ │ +00002570: 7368 6973 6869 5f74 6b74 5f63 6c69 656e  shishi_tkt_clien
│ │ │ │ +00002580: 7472 6561 6c6d 7f32 3734 3034 360a 5265  trealm.274046.Re
│ │ │ │ +00002590: 663a 2073 6869 7368 695f 746b 745f 636c  f: shishi_tkt_cl
│ │ │ │ +000025a0: 6965 6e74 7265 616c 6d5f 707f 3237 3438  ientrealm_p.2748
│ │ │ │ +000025b0: 3937 0a52 6566 3a20 7368 6973 6869 5f74  97.Ref: shishi_t
│ │ │ │ +000025c0: 6b74 5f72 6561 6c6d 7f32 3735 3330 300a  kt_realm.275300.
│ │ │ │ +000025d0: 5265 663a 2073 6869 7368 695f 746b 745f  Ref: shishi_tkt_
│ │ │ │ +000025e0: 7365 7276 6572 7f32 3735 3734 330a 5265  server.275743.Re
│ │ │ │ +000025f0: 663a 2073 6869 7368 695f 746b 745f 7365  f: shishi_tkt_se
│ │ │ │ +00002600: 7276 6572 5f70 7f32 3736 3535 390a 5265  rver_p.276559.Re
│ │ │ │ +00002610: 663a 2073 6869 7368 695f 746b 745f 666c  f: shishi_tkt_fl
│ │ │ │ +00002620: 6167 737f 3237 3639 3030 0a52 6566 3a20  ags.276900.Ref: 
│ │ │ │ +00002630: 7368 6973 6869 5f74 6b74 5f66 6c61 6773  shishi_tkt_flags
│ │ │ │ +00002640: 5f73 6574 7f32 3737 3233 330a 5265 663a  _set.277233.Ref:
│ │ │ │ +00002650: 2073 6869 7368 695f 746b 745f 666c 6167   shishi_tkt_flag
│ │ │ │ +00002660: 735f 6164 647f 3237 3736 3532 0a52 6566  s_add.277652.Ref
│ │ │ │ +00002670: 3a20 7368 6973 6869 5f74 6b74 5f66 6f72  : shishi_tkt_for
│ │ │ │ +00002680: 7761 7264 6162 6c65 5f70 7f32 3738 3033  wardable_p.27803
│ │ │ │ +00002690: 360a 5265 663a 2073 6869 7368 695f 746b  6.Ref: shishi_tk
│ │ │ │ +000026a0: 745f 666f 7277 6172 6465 645f 707f 3237  t_forwarded_p.27
│ │ │ │ +000026b0: 3838 3438 0a52 6566 3a20 7368 6973 6869  8848.Ref: shishi
│ │ │ │ +000026c0: 5f74 6b74 5f70 726f 7869 6162 6c65 5f70  _tkt_proxiable_p
│ │ │ │ +000026d0: 7f32 3739 3537 310a 5265 663a 2073 6869  .279571.Ref: shi
│ │ │ │ +000026e0: 7368 695f 746b 745f 7072 6f78 795f 707f  shi_tkt_proxy_p.
│ │ │ │ +000026f0: 3238 3034 3037 0a52 6566 3a20 7368 6973  280407.Ref: shis
│ │ │ │ +00002700: 6869 5f74 6b74 5f6d 6179 5f70 6f73 7464  hi_tkt_may_postd
│ │ │ │ +00002710: 6174 655f 707f 3238 3039 3630 0a52 6566  ate_p.280960.Ref
│ │ │ │ +00002720: 3a20 7368 6973 6869 5f74 6b74 5f70 6f73  : shishi_tkt_pos
│ │ │ │ +00002730: 7464 6174 6564 5f70 7f32 3832 3235 360a  tdated_p.282256.
│ │ │ │ +00002740: 5265 663a 2073 6869 7368 695f 746b 745f  Ref: shishi_tkt_
│ │ │ │ +00002750: 696e 7661 6c69 645f 707f 3238 3330 3635  invalid_p.283065
│ │ │ │ +00002760: 0a52 6566 3a20 7368 6973 6869 5f74 6b74  .Ref: shishi_tkt
│ │ │ │ +00002770: 5f72 656e 6577 6162 6c65 5f70 7f32 3833  _renewable_p.283
│ │ │ │ +00002780: 3933 320a 5265 663a 2073 6869 7368 695f  932.Ref: shishi_
│ │ │ │ +00002790: 746b 745f 696e 6974 6961 6c5f 707f 3238  tkt_initial_p.28
│ │ │ │ +000027a0: 3434 3937 0a52 6566 3a20 7368 6973 6869  4497.Ref: shishi
│ │ │ │ +000027b0: 5f74 6b74 5f70 7265 5f61 7574 6865 6e74  _tkt_pre_authent
│ │ │ │ +000027c0: 5f70 7f32 3835 3233 390a 5265 663a 2073  _p.285239.Ref: s
│ │ │ │ +000027d0: 6869 7368 695f 746b 745f 6877 5f61 7574  hishi_tkt_hw_aut
│ │ │ │ +000027e0: 6865 6e74 5f70 7f32 3835 3936 310a 5265  hent_p.285961.Re
│ │ │ │ +000027f0: 663a 2073 6869 7368 695f 746b 745f 7472  f: shishi_tkt_tr
│ │ │ │ +00002800: 616e 7369 7465 645f 706f 6c69 6379 5f63  ansited_policy_c
│ │ │ │ +00002810: 6865 636b 6564 5f70 7f32 3836 3732 370a  hecked_p.286727.
│ │ │ │ +00002820: 5265 663a 2073 6869 7368 695f 746b 745f  Ref: shishi_tkt_
│ │ │ │ +00002830: 6f6b 5f61 735f 6465 6c65 6761 7465 5f70  ok_as_delegate_p
│ │ │ │ +00002840: 7f32 3838 3630 360a 5265 663a 2073 6869  .288606.Ref: shi
│ │ │ │ +00002850: 7368 695f 746b 745f 6b65 7974 7970 657f  shi_tkt_keytype.
│ │ │ │ +00002860: 3238 3936 3535 0a52 6566 3a20 7368 6973  289655.Ref: shis
│ │ │ │ +00002870: 6869 5f74 6b74 5f6b 6579 7479 7065 5f66  hi_tkt_keytype_f
│ │ │ │ +00002880: 6173 747f 3239 3030 3338 0a52 6566 3a20  ast.290038.Ref: 
│ │ │ │ +00002890: 7368 6973 6869 5f74 6b74 5f6b 6579 7479  shishi_tkt_keyty
│ │ │ │ +000028a0: 7065 5f70 7f32 3930 3339 370a 5265 663a  pe_p.290397.Ref:
│ │ │ │ +000028b0: 2073 6869 7368 695f 746b 745f 6c61 7374   shishi_tkt_last
│ │ │ │ +000028c0: 7265 7163 7f32 3930 3832 310a 5265 663a  reqc.290821.Ref:
│ │ │ │ +000028d0: 2073 6869 7368 695f 746b 745f 6175 7468   shishi_tkt_auth
│ │ │ │ +000028e0: 6374 696d 657f 3239 3133 3030 0a52 6566  ctime.291300.Ref
│ │ │ │ +000028f0: 3a20 7368 6973 6869 5f74 6b74 5f73 7461  : shishi_tkt_sta
│ │ │ │ +00002900: 7274 6374 696d 657f 3239 3137 3231 0a52  rtctime.291721.R
│ │ │ │ +00002910: 6566 3a20 7368 6973 6869 5f74 6b74 5f65  ef: shishi_tkt_e
│ │ │ │ +00002920: 6e64 6374 696d 657f 3239 3231 3230 0a52  ndctime.292120.R
│ │ │ │ +00002930: 6566 3a20 7368 6973 6869 5f74 6b74 5f72  ef: shishi_tkt_r
│ │ │ │ +00002940: 656e 6577 5f74 696c 6c63 7f32 3932 3439  enew_tillc.29249
│ │ │ │ +00002950: 310a 5265 663a 2073 6869 7368 695f 746b  1.Ref: shishi_tk
│ │ │ │ +00002960: 745f 7661 6c69 645f 6174 5f74 696d 655f  t_valid_at_time_
│ │ │ │ +00002970: 707f 3239 3238 3937 0a52 6566 3a20 7368  p.292897.Ref: sh
│ │ │ │ +00002980: 6973 6869 5f74 6b74 5f76 616c 6964 5f6e  ishi_tkt_valid_n
│ │ │ │ +00002990: 6f77 5f70 7f32 3933 3330 310a 5265 663a  ow_p.293301.Ref:
│ │ │ │ +000029a0: 2073 6869 7368 695f 746b 745f 6578 7069   shishi_tkt_expi
│ │ │ │ +000029b0: 7265 645f 707f 3239 3335 3930 0a52 6566  red_p.293590.Ref
│ │ │ │ +000029c0: 3a20 7368 6973 6869 5f74 6b74 5f6c 6173  : shishi_tkt_las
│ │ │ │ +000029d0: 7472 6571 5f70 7265 7474 795f 7072 696e  treq_pretty_prin
│ │ │ │ +000029e0: 747f 3239 3339 3033 0a52 6566 3a20 7368  t.293903.Ref: sh
│ │ │ │ +000029f0: 6973 6869 5f74 6b74 5f70 7265 7474 795f  ishi_tkt_pretty_
│ │ │ │ +00002a00: 7072 696e 747f 3239 3432 3538 0a4e 6f64  print.294258.Nod
│ │ │ │ +00002a10: 653a 2041 5320 4675 6e63 7469 6f6e 737f  e: AS Functions.
│ │ │ │ +00002a20: 3239 3435 3036 0a52 6566 3a20 7368 6973  294506.Ref: shis
│ │ │ │ +00002a30: 6869 5f61 737f 3239 3636 3437 0a52 6566  hi_as.296647.Ref
│ │ │ │ +00002a40: 3a20 7368 6973 6869 5f61 735f 646f 6e65  : shishi_as_done
│ │ │ │ +00002a50: 7f32 3936 3938 320a 5265 663a 2073 6869  .296982.Ref: shi
│ │ │ │ +00002a60: 7368 695f 6173 5f72 6571 7f32 3937 3330  shi_as_req.29730
│ │ │ │ +00002a70: 330a 5265 663a 2073 6869 7368 695f 6173  3.Ref: shishi_as
│ │ │ │ +00002a80: 5f72 6571 5f62 7569 6c64 7f32 3937 3635  _req_build.29765
│ │ │ │ +00002a90: 370a 5265 663a 2073 6869 7368 695f 6173  7.Ref: shishi_as
│ │ │ │ +00002aa0: 5f72 6571 5f73 6574 7f32 3937 3933 310a  _req_set.297931.
│ │ │ │ +00002ab0: 5265 663a 2073 6869 7368 695f 6173 5f72  Ref: shishi_as_r
│ │ │ │ +00002ac0: 6571 5f64 6572 7f32 3938 3139 320a 5265  eq_der.298192.Re
│ │ │ │ +00002ad0: 663a 2073 6869 7368 695f 6173 5f72 6571  f: shishi_as_req
│ │ │ │ +00002ae0: 5f64 6572 5f73 6574 7f32 3938 3731 370a  _der_set.298717.
│ │ │ │ +00002af0: 5265 663a 2073 6869 7368 695f 6173 5f72  Ref: shishi_as_r
│ │ │ │ +00002b00: 6570 7f32 3939 3137 360a 5265 663a 2073  ep.299176.Ref: s
│ │ │ │ +00002b10: 6869 7368 695f 6173 5f72 6570 5f70 726f  hishi_as_rep_pro
│ │ │ │ +00002b20: 6365 7373 7f32 3939 3533 330a 5265 663a  cess.299533.Ref:
│ │ │ │ +00002b30: 2073 6869 7368 695f 6173 5f72 6570 5f62   shishi_as_rep_b
│ │ │ │ +00002b40: 7569 6c64 7f33 3030 3039 320a 5265 663a  uild.300092.Ref:
│ │ │ │ +00002b50: 2073 6869 7368 695f 6173 5f72 6570 5f64   shishi_as_rep_d
│ │ │ │ +00002b60: 6572 7f33 3030 3432 360a 5265 663a 2073  er.300426.Ref: s
│ │ │ │ +00002b70: 6869 7368 695f 6173 5f72 6570 5f73 6574  hishi_as_rep_set
│ │ │ │ +00002b80: 7f33 3030 3934 330a 5265 663a 2073 6869  .300943.Ref: shi
│ │ │ │ +00002b90: 7368 695f 6173 5f72 6570 5f64 6572 5f73  shi_as_rep_der_s
│ │ │ │ +00002ba0: 6574 7f33 3031 3231 320a 5265 663a 2073  et.301212.Ref: s
│ │ │ │ +00002bb0: 6869 7368 695f 6173 5f6b 7262 6572 726f  hishi_as_krberro
│ │ │ │ +00002bc0: 727f 3330 3136 3831 0a52 6566 3a20 7368  r.301681.Ref: sh
│ │ │ │ +00002bd0: 6973 6869 5f61 735f 6b72 6265 7272 6f72  ishi_as_krberror
│ │ │ │ +00002be0: 5f64 6572 7f33 3032 3035 310a 5265 663a  _der.302051.Ref:
│ │ │ │ +00002bf0: 2073 6869 7368 695f 6173 5f6b 7262 6572   shishi_as_krber
│ │ │ │ +00002c00: 726f 725f 7365 747f 3330 3235 3932 0a52  ror_set.302592.R
│ │ │ │ +00002c10: 6566 3a20 7368 6973 6869 5f61 735f 746b  ef: shishi_as_tk
│ │ │ │ +00002c20: 747f 3330 3238 3732 0a52 6566 3a20 7368  t.302872.Ref: sh
│ │ │ │ +00002c30: 6973 6869 5f61 735f 746b 745f 7365 747f  ishi_as_tkt_set.
│ │ │ │ +00002c40: 3330 3332 3030 0a52 6566 3a20 7368 6973  303200.Ref: shis
│ │ │ │ +00002c50: 6869 5f61 735f 7365 6e64 7265 6376 5f68  hi_as_sendrecv_h
│ │ │ │ +00002c60: 696e 747f 3330 3334 3635 0a52 6566 3a20  int.303465.Ref: 
│ │ │ │ +00002c70: 7368 6973 6869 5f61 735f 7365 6e64 7265  shishi_as_sendre
│ │ │ │ +00002c80: 6376 7f33 3034 3035 300a 4e6f 6465 3a20  cv.304050.Node: 
│ │ │ │ +00002c90: 5447 5320 4675 6e63 7469 6f6e 737f 3330  TGS Functions.30
│ │ │ │ +00002ca0: 3532 3231 0a52 6566 3a20 7368 6973 6869  5221.Ref: shishi
│ │ │ │ +00002cb0: 5f74 6773 7f33 3037 3437 340a 5265 663a  _tgs.307474.Ref:
│ │ │ │ +00002cc0: 2073 6869 7368 695f 7467 735f 646f 6e65   shishi_tgs_done
│ │ │ │ +00002cd0: 7f33 3037 3831 370a 5265 663a 2073 6869  .307817.Ref: shi
│ │ │ │ +00002ce0: 7368 695f 7467 735f 7467 746b 747f 3330  shi_tgs_tgtkt.30
│ │ │ │ +00002cf0: 3831 3530 0a52 6566 3a20 7368 6973 6869  8150.Ref: shishi
│ │ │ │ +00002d00: 5f74 6773 5f74 6774 6b74 5f73 6574 7f33  _tgs_tgtkt_set.3
│ │ │ │ +00002d10: 3038 3531 380a 5265 663a 2073 6869 7368  08518.Ref: shish
│ │ │ │ +00002d20: 695f 7467 735f 6170 7f33 3038 3830 380a  i_tgs_ap.308808.
│ │ │ │ +00002d30: 5265 663a 2073 6869 7368 695f 7467 735f  Ref: shishi_tgs_
│ │ │ │ +00002d40: 7265 717f 3330 3931 3438 0a52 6566 3a20  req.309148.Ref: 
│ │ │ │ +00002d50: 7368 6973 6869 5f74 6773 5f72 6571 5f73  shishi_tgs_req_s
│ │ │ │ +00002d60: 6574 7f33 3039 3439 300a 5265 663a 2073  et.309490.Ref: s
│ │ │ │ +00002d70: 6869 7368 695f 7467 735f 7265 715f 6465  hishi_tgs_req_de
│ │ │ │ +00002d80: 727f 3330 3937 3734 0a52 6566 3a20 7368  r.309774.Ref: sh
│ │ │ │ +00002d90: 6973 6869 5f74 6773 5f72 6571 5f64 6572  ishi_tgs_req_der
│ │ │ │ +00002da0: 5f73 6574 7f33 3130 3330 390a 5265 663a  _set.310309.Ref:
│ │ │ │ +00002db0: 2073 6869 7368 695f 7467 735f 7265 715f   shishi_tgs_req_
│ │ │ │ +00002dc0: 7072 6f63 6573 737f 3331 3037 3935 0a52  process.310795.R
│ │ │ │ +00002dd0: 6566 3a20 7368 6973 6869 5f74 6773 5f72  ef: shishi_tgs_r
│ │ │ │ +00002de0: 6571 5f62 7569 6c64 7f33 3131 3136 390a  eq_build.311169.
│ │ │ │ +00002df0: 5265 663a 2073 6869 7368 695f 7467 735f  Ref: shishi_tgs_
│ │ │ │ +00002e00: 7265 707f 3331 3134 3739 0a52 6566 3a20  rep.311479.Ref: 
│ │ │ │ +00002e10: 7368 6973 6869 5f74 6773 5f72 6570 5f64  shishi_tgs_rep_d
│ │ │ │ +00002e20: 6572 7f33 3131 3831 360a 5265 663a 2073  er.311816.Ref: s
│ │ │ │ +00002e30: 6869 7368 695f 7467 735f 7265 705f 7072  hishi_tgs_rep_pr
│ │ │ │ +00002e40: 6f63 6573 737f 3331 3233 3531 0a52 6566  ocess.312351.Ref
│ │ │ │ +00002e50: 3a20 7368 6973 6869 5f74 6773 5f72 6570  : shishi_tgs_rep
│ │ │ │ +00002e60: 5f62 7569 6c64 7f33 3132 3732 350a 5265  _build.312725.Re
│ │ │ │ +00002e70: 663a 2073 6869 7368 695f 7467 735f 6b72  f: shishi_tgs_kr
│ │ │ │ +00002e80: 6265 7272 6f72 7f33 3133 3132 370a 5265  berror.313127.Re
│ │ │ │ +00002e90: 663a 2073 6869 7368 695f 7467 735f 6b72  f: shishi_tgs_kr
│ │ │ │ +00002ea0: 6265 7272 6f72 5f64 6572 7f33 3133 3438  berror_der.31348
│ │ │ │ +00002eb0: 310a 5265 663a 2073 6869 7368 695f 7467  1.Ref: shishi_tg
│ │ │ │ +00002ec0: 735f 6b72 6265 7272 6f72 5f73 6574 7f33  s_krberror_set.3
│ │ │ │ +00002ed0: 3134 3032 390a 5265 663a 2073 6869 7368  14029.Ref: shish
│ │ │ │ +00002ee0: 695f 7467 735f 746b 747f 3331 3433 3138  i_tgs_tkt.314318
│ │ │ │ +00002ef0: 0a52 6566 3a20 7368 6973 6869 5f74 6773  .Ref: shishi_tgs
│ │ │ │ +00002f00: 5f74 6b74 5f73 6574 7f33 3134 3636 300a  _tkt_set.314660.
│ │ │ │ +00002f10: 5265 663a 2073 6869 7368 695f 7467 735f  Ref: shishi_tgs_
│ │ │ │ +00002f20: 7365 6e64 7265 6376 5f68 696e 747f 3331  sendrecv_hint.31
│ │ │ │ +00002f30: 3439 3530 0a52 6566 3a20 7368 6973 6869  4950.Ref: shishi
│ │ │ │ +00002f40: 5f74 6773 5f73 656e 6472 6563 767f 3331  _tgs_sendrecv.31
│ │ │ │ +00002f50: 3535 3337 0a52 6566 3a20 7368 6973 6869  5537.Ref: shishi
│ │ │ │ +00002f60: 5f74 6773 5f73 6574 5f73 6572 7665 727f  _tgs_set_server.
│ │ │ │ +00002f70: 3331 3539 3135 0a52 6566 3a20 7368 6973  315915.Ref: shis
│ │ │ │ +00002f80: 6869 5f74 6773 5f73 6574 5f72 6561 6c6d  hi_tgs_set_realm
│ │ │ │ +00002f90: 7f33 3136 3237 360a 5265 663a 2073 6869  .316276.Ref: shi
│ │ │ │ +00002fa0: 7368 695f 7467 735f 7365 745f 7265 616c  shi_tgs_set_real
│ │ │ │ +00002fb0: 6d73 6572 7665 727f 3331 3636 3435 0a4e  mserver.316645.N
│ │ │ │ +00002fc0: 6f64 653a 2054 6963 6b65 7420 2841 534e  ode: Ticket (ASN
│ │ │ │ +00002fd0: 2e31 2920 4675 6e63 7469 6f6e 737f 3331  .1) Functions.31
│ │ │ │ +00002fe0: 3730 3533 0a52 6566 3a20 7368 6973 6869  7053.Ref: shishi
│ │ │ │ +00002ff0: 5f74 6963 6b65 747f 3331 3833 3034 0a52  _ticket.318304.R
│ │ │ │ +00003000: 6566 3a20 7368 6973 6869 5f74 6963 6b65  ef: shishi_ticke
│ │ │ │ +00003010: 745f 7265 616c 6d5f 6765 747f 3331 3836  t_realm_get.3186
│ │ │ │ +00003020: 3431 0a52 6566 3a20 7368 6973 6869 5f74  41.Ref: shishi_t
│ │ │ │ +00003030: 6963 6b65 745f 7265 616c 6d5f 7365 747f  icket_realm_set.
│ │ │ │ +00003040: 3331 3931 3337 0a52 6566 3a20 7368 6973  319137.Ref: shis
│ │ │ │ +00003050: 6869 5f74 6963 6b65 745f 7365 7276 6572  hi_ticket_server
│ │ │ │ +00003060: 7f33 3139 3535 370a 5265 663a 2073 6869  .319557.Ref: shi
│ │ │ │ +00003070: 7368 695f 7469 636b 6574 5f73 6e61 6d65  shi_ticket_sname
│ │ │ │ +00003080: 5f73 6574 7f33 3230 3438 360a 5265 663a  _set.320486.Ref:
│ │ │ │ +00003090: 2073 6869 7368 695f 7469 636b 6574 5f67   shishi_ticket_g
│ │ │ │ +000030a0: 6574 5f65 6e63 5f70 6172 745f 6574 7970  et_enc_part_etyp
│ │ │ │ +000030b0: 657f 3332 3130 3733 0a52 6566 3a20 7368  e.321073.Ref: sh
│ │ │ │ +000030c0: 6973 6869 5f74 6963 6b65 745f 7365 745f  ishi_ticket_set_
│ │ │ │ +000030d0: 656e 635f 7061 7274 7f33 3231 3531 350a  enc_part.321515.
│ │ │ │ +000030e0: 5265 663a 2073 6869 7368 695f 7469 636b  Ref: shishi_tick
│ │ │ │ +000030f0: 6574 5f61 6464 5f65 6e63 5f70 6172 747f  et_add_enc_part.
│ │ │ │ +00003100: 3332 3234 3336 0a52 6566 3a20 7368 6973  322436.Ref: shis
│ │ │ │ +00003110: 6869 5f65 6e63 7469 636b 6574 7061 7274  hi_encticketpart
│ │ │ │ +00003120: 5f67 6574 5f6b 6579 7f33 3232 3939 320a  _get_key.322992.
│ │ │ │ +00003130: 5265 663a 2073 6869 7368 695f 656e 6374  Ref: shishi_enct
│ │ │ │ +00003140: 6963 6b65 7470 6172 745f 6b65 795f 7365  icketpart_key_se
│ │ │ │ +00003150: 747f 3332 3334 3430 0a52 6566 3a20 7368  t.323440.Ref: sh
│ │ │ │ +00003160: 6973 6869 5f65 6e63 7469 636b 6574 7061  ishi_encticketpa
│ │ │ │ +00003170: 7274 5f66 6c61 6773 5f73 6574 7f33 3233  rt_flags_set.323
│ │ │ │ +00003180: 3936 320a 5265 663a 2073 6869 7368 695f  962.Ref: shishi_
│ │ │ │ +00003190: 656e 6374 6963 6b65 7470 6172 745f 6372  encticketpart_cr
│ │ │ │ +000031a0: 6561 6c6d 5f73 6574 7f33 3234 3433 300a  ealm_set.324430.
│ │ │ │ +000031b0: 5265 663a 2073 6869 7368 695f 656e 6374  Ref: shishi_enct
│ │ │ │ +000031c0: 6963 6b65 7470 6172 745f 636e 616d 655f  icketpart_cname_
│ │ │ │ +000031d0: 7365 747f 3332 3438 3930 0a52 6566 3a20  set.324890.Ref: 
│ │ │ │ +000031e0: 7368 6973 6869 5f65 6e63 7469 636b 6574  shishi_encticket
│ │ │ │ +000031f0: 7061 7274 5f74 7261 6e73 6974 6564 5f73  part_transited_s
│ │ │ │ +00003200: 6574 7f33 3235 3530 360a 5265 663a 2073  et.325506.Ref: s
│ │ │ │ +00003210: 6869 7368 695f 656e 6374 6963 6b65 7470  hishi_encticketp
│ │ │ │ +00003220: 6172 745f 6175 7468 7469 6d65 5f73 6574  art_authtime_set
│ │ │ │ +00003230: 7f33 3236 3138 340a 5265 663a 2073 6869  .326184.Ref: shi
│ │ │ │ +00003240: 7368 695f 656e 6374 6963 6b65 7470 6172  shi_encticketpar
│ │ │ │ +00003250: 745f 656e 6474 696d 655f 7365 747f 3332  t_endtime_set.32
│ │ │ │ +00003260: 3636 3939 0a52 6566 3a20 7368 6973 6869  6699.Ref: shishi
│ │ │ │ +00003270: 5f65 6e63 7469 636b 6574 7061 7274 5f63  _encticketpart_c
│ │ │ │ +00003280: 6c69 656e 747f 3332 3732 3030 0a52 6566  lient.327200.Ref
│ │ │ │ +00003290: 3a20 7368 6973 6869 5f65 6e63 7469 636b  : shishi_enctick
│ │ │ │ +000032a0: 6574 7061 7274 5f63 6c69 656e 7472 6561  etpart_clientrea
│ │ │ │ +000032b0: 6c6d 7f33 3238 3137 360a 4e6f 6465 3a20  lm.328176.Node: 
│ │ │ │ +000032c0: 4153 2f54 4753 2046 756e 6374 696f 6e73  AS/TGS Functions
│ │ │ │ +000032d0: 7f33 3239 3132 350a 5265 663a 2073 6869  .329125.Ref: shi
│ │ │ │ +000032e0: 7368 695f 6173 5f64 6572 6976 655f 7361  shi_as_derive_sa
│ │ │ │ +000032f0: 6c74 7f33 3332 3139 320a 5265 663a 2073  lt.332192.Ref: s
│ │ │ │ +00003300: 6869 7368 695f 6b64 6372 6571 5f73 656e  hishi_kdcreq_sen
│ │ │ │ +00003310: 6472 6563 765f 6869 6e74 7f33 3333 3137  drecv_hint.33317
│ │ │ │ +00003320: 320a 5265 663a 2073 6869 7368 695f 6b64  2.Ref: shishi_kd
│ │ │ │ +00003330: 6372 6571 5f73 656e 6472 6563 767f 3333  creq_sendrecv.33
│ │ │ │ +00003340: 3430 3637 0a52 6566 3a20 7368 6973 6869  4067.Ref: shishi
│ │ │ │ +00003350: 5f6b 6463 5f63 6f70 795f 6372 6561 6c6d  _kdc_copy_crealm
│ │ │ │ +00003360: 7f33 3334 3833 300a 5265 663a 2073 6869  .334830.Ref: shi
│ │ │ │ +00003370: 7368 695f 6173 5f63 6865 636b 5f63 7265  shi_as_check_cre
│ │ │ │ +00003380: 616c 6d7f 3333 3533 3937 0a52 6566 3a20  alm.335397.Ref: 
│ │ │ │ +00003390: 7368 6973 6869 5f6b 6463 5f63 6f70 795f  shishi_kdc_copy_
│ │ │ │ +000033a0: 636e 616d 657f 3333 3631 3335 0a52 6566  cname.336135.Ref
│ │ │ │ +000033b0: 3a20 7368 6973 6869 5f61 735f 6368 6563  : shishi_as_chec
│ │ │ │ +000033c0: 6b5f 636e 616d 657f 3333 3636 3936 0a52  k_cname.336696.R
│ │ │ │ +000033d0: 6566 3a20 7368 6973 6869 5f6b 6463 5f63  ef: shishi_kdc_c
│ │ │ │ +000033e0: 6f70 795f 6e6f 6e63 657f 3333 3734 3134  opy_nonce.337414
│ │ │ │ +000033f0: 0a52 6566 3a20 7368 6973 6869 5f6b 6463  .Ref: shishi_kdc
│ │ │ │ +00003400: 5f63 6865 636b 5f6e 6f6e 6365 7f33 3337  _check_nonce.337
│ │ │ │ +00003410: 3934 310a 5265 663a 2073 6869 7368 695f  941.Ref: shishi_
│ │ │ │ +00003420: 7467 735f 7072 6f63 6573 737f 3333 3837  tgs_process.3387
│ │ │ │ +00003430: 3633 0a52 6566 3a20 7368 6973 6869 5f61  63.Ref: shishi_a
│ │ │ │ +00003440: 735f 7072 6f63 6573 737f 3333 3938 3935  s_process.339895
│ │ │ │ +00003450: 0a52 6566 3a20 7368 6973 6869 5f6b 6463  .Ref: shishi_kdc
│ │ │ │ +00003460: 5f70 726f 6365 7373 7f33 3430 3830 340a  _process.340804.
│ │ │ │ +00003470: 5265 663a 2073 6869 7368 695f 6173 7265  Ref: shishi_asre
│ │ │ │ +00003480: 717f 3334 3232 3332 0a52 6566 3a20 7368  q.342232.Ref: sh
│ │ │ │ +00003490: 6973 6869 5f74 6773 7265 717f 3334 3235  ishi_tgsreq.3425
│ │ │ │ +000034a0: 3432 0a52 6566 3a20 7368 6973 6869 5f6b  42.Ref: shishi_k
│ │ │ │ +000034b0: 6463 7265 715f 7072 696e 747f 3334 3238  dcreq_print.3428
│ │ │ │ +000034c0: 3637 0a52 6566 3a20 7368 6973 6869 5f6b  67.Ref: shishi_k
│ │ │ │ +000034d0: 6463 7265 715f 7361 7665 7f33 3433 3236  dcreq_save.34326
│ │ │ │ +000034e0: 380a 5265 663a 2073 6869 7368 695f 6b64  8.Ref: shishi_kd
│ │ │ │ +000034f0: 6372 6571 5f74 6f5f 6669 6c65 7f33 3433  creq_to_file.343
│ │ │ │ +00003500: 3635 390a 5265 663a 2073 6869 7368 695f  659.Ref: shishi_
│ │ │ │ +00003510: 6b64 6372 6571 5f70 6172 7365 7f33 3434  kdcreq_parse.344
│ │ │ │ +00003520: 3233 360a 5265 663a 2073 6869 7368 695f  236.Ref: shishi_
│ │ │ │ +00003530: 6b64 6372 6571 5f72 6561 647f 3334 3436  kdcreq_read.3446
│ │ │ │ +00003540: 3937 0a52 6566 3a20 7368 6973 6869 5f6b  97.Ref: shishi_k
│ │ │ │ +00003550: 6463 7265 715f 6672 6f6d 5f66 696c 657f  dcreq_from_file.
│ │ │ │ +00003560: 3334 3531 3533 0a52 6566 3a20 7368 6973  345153.Ref: shis
│ │ │ │ +00003570: 6869 5f6b 6463 7265 715f 6e6f 6e63 655f  hi_kdcreq_nonce_
│ │ │ │ +00003580: 7365 747f 3334 3537 3234 0a52 6566 3a20  set.345724.Ref: 
│ │ │ │ +00003590: 7368 6973 6869 5f6b 6463 7265 715f 7365  shishi_kdcreq_se
│ │ │ │ +000035a0: 745f 636e 616d 657f 3334 3631 3730 0a52  t_cname.346170.R
│ │ │ │ +000035b0: 6566 3a20 7368 6973 6869 5f6b 6463 7265  ef: shishi_kdcre
│ │ │ │ +000035c0: 715f 636c 6965 6e74 7f33 3436 3734 370a  q_client.346747.
│ │ │ │ +000035d0: 5265 663a 2073 6869 7368 695f 6173 7265  Ref: shishi_asre
│ │ │ │ +000035e0: 715f 636c 6965 6e74 7265 616c 6d7f 3334  q_clientrealm.34
│ │ │ │ +000035f0: 3736 3734 0a52 6566 3a20 7368 6973 6869  7674.Ref: shishi
│ │ │ │ +00003600: 5f6b 6463 7265 715f 7265 616c 6d7f 3334  _kdcreq_realm.34
│ │ │ │ +00003610: 3836 3231 0a52 6566 3a20 7368 6973 6869  8621.Ref: shishi
│ │ │ │ +00003620: 5f6b 6463 7265 715f 7365 745f 7265 616c  _kdcreq_set_real
│ │ │ │ +00003630: 6d7f 3334 3935 3035 0a52 6566 3a20 7368  m.349505.Ref: sh
│ │ │ │ +00003640: 6973 6869 5f6b 6463 7265 715f 7365 7276  ishi_kdcreq_serv
│ │ │ │ +00003650: 6572 7f33 3439 3933 330a 5265 663a 2073  er.349933.Ref: s
│ │ │ │ +00003660: 6869 7368 695f 6b64 6372 6571 5f73 6574  hishi_kdcreq_set
│ │ │ │ +00003670: 5f73 6e61 6d65 7f33 3530 3835 380a 5265  _sname.350858.Re
│ │ │ │ +00003680: 663a 2073 6869 7368 695f 6b64 6372 6571  f: shishi_kdcreq
│ │ │ │ +00003690: 5f74 696c 6c7f 3335 3134 3235 0a52 6566  _till.351425.Ref
│ │ │ │ +000036a0: 3a20 7368 6973 6869 5f6b 6463 7265 715f  : shishi_kdcreq_
│ │ │ │ +000036b0: 7469 6c6c 637f 3335 3233 3933 0a52 6566  tillc.352393.Ref
│ │ │ │ +000036c0: 3a20 7368 6973 6869 5f6b 6463 7265 715f  : shishi_kdcreq_
│ │ │ │ +000036d0: 6574 7970 657f 3335 3238 3131 0a52 6566  etype.352811.Ref
│ │ │ │ +000036e0: 3a20 7368 6973 6869 5f6b 6463 7265 715f  : shishi_kdcreq_
│ │ │ │ +000036f0: 7365 745f 6574 7970 657f 3335 3333 3330  set_etype.353330
│ │ │ │ +00003700: 0a52 6566 3a20 7368 6973 6869 5f6b 6463  .Ref: shishi_kdc
│ │ │ │ +00003710: 7265 715f 6f70 7469 6f6e 737f 3335 3339  req_options.3539
│ │ │ │ +00003720: 3236 0a52 6566 3a20 7368 6973 6869 5f6b  26.Ref: shishi_k
│ │ │ │ +00003730: 6463 7265 715f 666f 7277 6172 6461 626c  dcreq_forwardabl
│ │ │ │ +00003740: 655f 707f 3335 3433 3736 0a52 6566 3a20  e_p.354376.Ref: 
│ │ │ │ +00003750: 7368 6973 6869 5f6b 6463 7265 715f 666f  shishi_kdcreq_fo
│ │ │ │ +00003760: 7277 6172 6465 645f 707f 3335 3530 3633  rwarded_p.355063
│ │ │ │ +00003770: 0a52 6566 3a20 7368 6973 6869 5f6b 6463  .Ref: shishi_kdc
│ │ │ │ +00003780: 7265 715f 7072 6f78 6961 626c 655f 707f  req_proxiable_p.
│ │ │ │ +00003790: 3335 3538 3737 0a52 6566 3a20 7368 6973  355877.Ref: shis
│ │ │ │ +000037a0: 6869 5f6b 6463 7265 715f 7072 6f78 795f  hi_kdcreq_proxy_
│ │ │ │ +000037b0: 707f 3335 3635 3339 0a52 6566 3a20 7368  p.356539.Ref: sh
│ │ │ │ +000037c0: 6973 6869 5f6b 6463 7265 715f 616c 6c6f  ishi_kdcreq_allo
│ │ │ │ +000037d0: 775f 706f 7374 6461 7465 5f70 7f33 3537  w_postdate_p.357
│ │ │ │ +000037e0: 3237 320a 5265 663a 2073 6869 7368 695f  272.Ref: shishi_
│ │ │ │ +000037f0: 6b64 6372 6571 5f70 6f73 7464 6174 6564  kdcreq_postdated
│ │ │ │ +00003800: 5f70 7f33 3537 3938 370a 5265 663a 2073  _p.357987.Ref: s
│ │ │ │ +00003810: 6869 7368 695f 6b64 6372 6571 5f72 656e  hishi_kdcreq_ren
│ │ │ │ +00003820: 6577 6162 6c65 5f70 7f33 3538 3739 380a  ewable_p.358798.
│ │ │ │ +00003830: 5265 663a 2073 6869 7368 695f 6b64 6372  Ref: shishi_kdcr
│ │ │ │ +00003840: 6571 5f64 6973 6162 6c65 5f74 7261 6e73  eq_disable_trans
│ │ │ │ +00003850: 6974 6564 5f63 6865 636b 5f70 7f33 3539  ited_check_p.359
│ │ │ │ +00003860: 3632 310a 5265 663a 2073 6869 7368 695f  621.Ref: shishi_
│ │ │ │ +00003870: 6b64 6372 6571 5f72 656e 6577 6162 6c65  kdcreq_renewable
│ │ │ │ +00003880: 5f6f 6b5f 707f 3336 3037 3535 0a52 6566  _ok_p.360755.Ref
│ │ │ │ +00003890: 3a20 7368 6973 6869 5f6b 6463 7265 715f  : shishi_kdcreq_
│ │ │ │ +000038a0: 656e 635f 746b 745f 696e 5f73 6b65 795f  enc_tkt_in_skey_
│ │ │ │ +000038b0: 707f 3336 3136 3439 0a52 6566 3a20 7368  p.361649.Ref: sh
│ │ │ │ +000038c0: 6973 6869 5f6b 6463 7265 715f 7265 6e65  ishi_kdcreq_rene
│ │ │ │ +000038d0: 775f 707f 3336 3233 3139 0a52 6566 3a20  w_p.362319.Ref: 
│ │ │ │ +000038e0: 7368 6973 6869 5f6b 6463 7265 715f 7661  shishi_kdcreq_va
│ │ │ │ +000038f0: 6c69 6461 7465 5f70 7f33 3633 3231 300a  lidate_p.363210.
│ │ │ │ +00003900: 5265 663a 2073 6869 7368 695f 6b64 6372  Ref: shishi_kdcr
│ │ │ │ +00003910: 6571 5f6f 7074 696f 6e73 5f73 6574 7f33  eq_options_set.3
│ │ │ │ +00003920: 3634 3136 350a 5265 663a 2073 6869 7368  64165.Ref: shish
│ │ │ │ +00003930: 695f 6b64 6372 6571 5f6f 7074 696f 6e73  i_kdcreq_options
│ │ │ │ +00003940: 5f61 6464 7f33 3634 3635 350a 5265 663a  _add.364655.Ref:
│ │ │ │ +00003950: 2073 6869 7368 695f 6b64 6372 6571 5f63   shishi_kdcreq_c
│ │ │ │ +00003960: 6c65 6172 5f70 6164 6174 617f 3336 3531  lear_padata.3651
│ │ │ │ +00003970: 3336 0a52 6566 3a20 7368 6973 6869 5f6b  36.Ref: shishi_k
│ │ │ │ +00003980: 6463 7265 715f 6765 745f 7061 6461 7461  dcreq_get_padata
│ │ │ │ +00003990: 7f33 3635 3530 350a 5265 663a 2073 6869  .365505.Ref: shi
│ │ │ │ +000039a0: 7368 695f 6b64 6372 6571 5f67 6574 5f70  shi_kdcreq_get_p
│ │ │ │ +000039b0: 6164 6174 615f 7467 737f 3336 3633 3234  adata_tgs.366324
│ │ │ │ +000039c0: 0a52 6566 3a20 7368 6973 6869 5f6b 6463  .Ref: shishi_kdc
│ │ │ │ +000039d0: 7265 715f 6164 645f 7061 6461 7461 7f33  req_add_padata.3
│ │ │ │ +000039e0: 3636 3937 390a 5265 663a 2073 6869 7368  66979.Ref: shish
│ │ │ │ +000039f0: 695f 6b64 6372 6571 5f61 6464 5f70 6164  i_kdcreq_add_pad
│ │ │ │ +00003a00: 6174 615f 7467 737f 3336 3738 3434 0a52  ata_tgs.367844.R
│ │ │ │ +00003a10: 6566 3a20 7368 6973 6869 5f6b 6463 7265  ef: shishi_kdcre
│ │ │ │ +00003a20: 715f 6164 645f 7061 6461 7461 5f70 7265  q_add_padata_pre
│ │ │ │ +00003a30: 6175 7468 7f33 3638 3438 340a 5265 663a  auth.368484.Ref:
│ │ │ │ +00003a40: 2073 6869 7368 695f 6173 7265 707f 3336   shishi_asrep.36
│ │ │ │ +00003a50: 3839 3131 0a52 6566 3a20 7368 6973 6869  8911.Ref: shishi
│ │ │ │ +00003a60: 5f74 6773 7265 707f 3336 3932 3231 0a52  _tgsrep.369221.R
│ │ │ │ +00003a70: 6566 3a20 7368 6973 6869 5f6b 6463 7265  ef: shishi_kdcre
│ │ │ │ +00003a80: 705f 7072 696e 747f 3336 3935 3436 0a52  p_print.369546.R
│ │ │ │ +00003a90: 6566 3a20 7368 6973 6869 5f6b 6463 7265  ef: shishi_kdcre
│ │ │ │ +00003aa0: 705f 7361 7665 7f33 3639 3934 370a 5265  p_save.369947.Re
│ │ │ │ +00003ab0: 663a 2073 6869 7368 695f 6b64 6372 6570  f: shishi_kdcrep
│ │ │ │ +00003ac0: 5f74 6f5f 6669 6c65 7f33 3730 3333 380a  _to_file.370338.
│ │ │ │ +00003ad0: 5265 663a 2073 6869 7368 695f 6b64 6372  Ref: shishi_kdcr
│ │ │ │ +00003ae0: 6570 5f70 6172 7365 7f33 3730 3931 350a  ep_parse.370915.
│ │ │ │ +00003af0: 5265 663a 2073 6869 7368 695f 6b64 6372  Ref: shishi_kdcr
│ │ │ │ +00003b00: 6570 5f72 6561 647f 3337 3133 3736 0a52  ep_read.371376.R
│ │ │ │ +00003b10: 6566 3a20 7368 6973 6869 5f6b 6463 7265  ef: shishi_kdcre
│ │ │ │ +00003b20: 705f 6672 6f6d 5f66 696c 657f 3337 3138  p_from_file.3718
│ │ │ │ +00003b30: 3332 0a52 6566 3a20 7368 6973 6869 5f6b  32.Ref: shishi_k
│ │ │ │ +00003b40: 6463 7265 705f 6372 6561 6c6d 5f73 6574  dcrep_crealm_set
│ │ │ │ +00003b50: 7f33 3732 3430 350a 5265 663a 2073 6869  .372405.Ref: shi
│ │ │ │ +00003b60: 7368 695f 6b64 6372 6570 5f63 6e61 6d65  shi_kdcrep_cname
│ │ │ │ +00003b70: 5f73 6574 7f33 3732 3834 380a 5265 663a  _set.372848.Ref:
│ │ │ │ +00003b80: 2073 6869 7368 695f 6b64 6372 6570 5f63   shishi_kdcrep_c
│ │ │ │ +00003b90: 6c69 656e 745f 7365 747f 3337 3334 3236  lient_set.373426
│ │ │ │ +00003ba0: 0a52 6566 3a20 7368 6973 6869 5f6b 6463  .Ref: shishi_kdc
│ │ │ │ +00003bb0: 7265 705f 6765 745f 656e 635f 7061 7274  rep_get_enc_part
│ │ │ │ +00003bc0: 5f65 7479 7065 7f33 3733 3932 360a 5265  _etype.373926.Re
│ │ │ │ +00003bd0: 663a 2073 6869 7368 695f 6b64 6372 6570  f: shishi_kdcrep
│ │ │ │ +00003be0: 5f67 6574 5f74 6963 6b65 747f 3337 3433  _get_ticket.3743
│ │ │ │ +00003bf0: 3636 0a52 6566 3a20 7368 6973 6869 5f6b  66.Ref: shishi_k
│ │ │ │ +00003c00: 6463 7265 705f 7365 745f 7469 636b 6574  dcrep_set_ticket
│ │ │ │ +00003c10: 7f33 3734 3830 360a 5265 663a 2073 6869  .374806.Ref: shi
│ │ │ │ +00003c20: 7368 695f 6b64 6372 6570 5f73 6574 5f65  shi_kdcrep_set_e
│ │ │ │ +00003c30: 6e63 5f70 6172 747f 3337 3532 3436 0a52  nc_part.375246.R
│ │ │ │ +00003c40: 6566 3a20 7368 6973 6869 5f6b 6463 7265  ef: shishi_kdcre
│ │ │ │ +00003c50: 705f 6164 645f 656e 635f 7061 7274 7f33  p_add_enc_part.3
│ │ │ │ +00003c60: 3736 3136 380a 5265 663a 2073 6869 7368  76168.Ref: shish
│ │ │ │ +00003c70: 695f 6b64 6372 6570 5f63 6c65 6172 5f70  i_kdcrep_clear_p
│ │ │ │ +00003c80: 6164 6174 617f 3337 3639 3132 0a52 6566  adata.376912.Ref
│ │ │ │ +00003c90: 3a20 7368 6973 6869 5f65 6e63 6b64 6372  : shishi_enckdcr
│ │ │ │ +00003ca0: 6570 7061 7274 5f67 6574 5f6b 6579 7f33  eppart_get_key.3
│ │ │ │ +00003cb0: 3737 3238 390a 5265 663a 2073 6869 7368  77289.Ref: shish
│ │ │ │ +00003cc0: 695f 656e 636b 6463 7265 7070 6172 745f  i_enckdcreppart_
│ │ │ │ +00003cd0: 6b65 795f 7365 747f 3337 3738 3330 0a52  key_set.377830.R
│ │ │ │ +00003ce0: 6566 3a20 7368 6973 6869 5f65 6e63 6b64  ef: shishi_enckd
│ │ │ │ +00003cf0: 6372 6570 7061 7274 5f6e 6f6e 6365 5f73  creppart_nonce_s
│ │ │ │ +00003d00: 6574 7f33 3738 3335 320a 5265 663a 2073  et.378352.Ref: s
│ │ │ │ +00003d10: 6869 7368 695f 656e 636b 6463 7265 7070  hishi_enckdcrepp
│ │ │ │ +00003d20: 6172 745f 666c 6167 735f 7365 747f 3337  art_flags_set.37
│ │ │ │ +00003d30: 3838 3131 0a52 6566 3a20 7368 6973 6869  8811.Ref: shishi
│ │ │ │ +00003d40: 5f65 6e63 6b64 6372 6570 7061 7274 5f61  _enckdcreppart_a
│ │ │ │ +00003d50: 7574 6874 696d 655f 7365 747f 3337 3932  uthtime_set.3792
│ │ │ │ +00003d60: 3731 0a52 6566 3a20 7368 6973 6869 5f65  71.Ref: shishi_e
│ │ │ │ +00003d70: 6e63 6b64 6372 6570 7061 7274 5f73 7461  nckdcreppart_sta
│ │ │ │ +00003d80: 7274 7469 6d65 5f73 6574 7f33 3739 3739  rttime_set.37979
│ │ │ │ +00003d90: 300a 5265 663a 2073 6869 7368 695f 656e  0.Ref: shishi_en
│ │ │ │ +00003da0: 636b 6463 7265 7070 6172 745f 656e 6474  ckdcreppart_endt
│ │ │ │ +00003db0: 696d 655f 7365 747f 3338 3033 3636 0a52  ime_set.380366.R
│ │ │ │ +00003dc0: 6566 3a20 7368 6973 6869 5f65 6e63 6b64  ef: shishi_enckd
│ │ │ │ +00003dd0: 6372 6570 7061 7274 5f72 656e 6577 5f74  creppart_renew_t
│ │ │ │ +00003de0: 696c 6c5f 7365 747f 3338 3038 3833 0a52  ill_set.380883.R
│ │ │ │ +00003df0: 6566 3a20 7368 6973 6869 5f65 6e63 6b64  ef: shishi_enckd
│ │ │ │ +00003e00: 6372 6570 7061 7274 5f73 7265 616c 6d5f  creppart_srealm_
│ │ │ │ +00003e10: 7365 747f 3338 3134 3632 0a52 6566 3a20  set.381462.Ref: 
│ │ │ │ +00003e20: 7368 6973 6869 5f65 6e63 6b64 6372 6570  shishi_enckdcrep
│ │ │ │ +00003e30: 7061 7274 5f73 6e61 6d65 5f73 6574 7f33  part_sname_set.3
│ │ │ │ +00003e40: 3831 3935 330a 5265 663a 2073 6869 7368  81953.Ref: shish
│ │ │ │ +00003e50: 695f 656e 636b 6463 7265 7070 6172 745f  i_enckdcreppart_
│ │ │ │ +00003e60: 706f 7075 6c61 7465 5f65 6e63 7469 636b  populate_enctick
│ │ │ │ +00003e70: 6574 7061 7274 7f33 3832 3539 380a 4e6f  etpart.382598.No
│ │ │ │ +00003e80: 6465 3a20 4175 7468 656e 7469 6361 746f  de: Authenticato
│ │ │ │ +00003e90: 7220 4675 6e63 7469 6f6e 737f 3338 3331  r Functions.3831
│ │ │ │ +00003ea0: 3534 0a52 6566 3a20 7368 6973 6869 5f61  54.Ref: shishi_a
│ │ │ │ +00003eb0: 7574 6865 6e74 6963 6174 6f72 7f33 3834  uthenticator.384
│ │ │ │ +00003ec0: 3036 350a 5265 663a 2073 6869 7368 695f  065.Ref: shishi_
│ │ │ │ +00003ed0: 6175 7468 656e 7469 6361 746f 725f 7375  authenticator_su
│ │ │ │ +00003ee0: 626b 6579 7f33 3834 3531 340a 5265 663a  bkey.384514.Ref:
│ │ │ │ +00003ef0: 2073 6869 7368 695f 6175 7468 656e 7469   shishi_authenti
│ │ │ │ +00003f00: 6361 746f 725f 7072 696e 747f 3338 3439  cator_print.3849
│ │ │ │ +00003f10: 3939 0a52 6566 3a20 7368 6973 6869 5f61  99.Ref: shishi_a
│ │ │ │ +00003f20: 7574 6865 6e74 6963 6174 6f72 5f73 6176  uthenticator_sav
│ │ │ │ +00003f30: 657f 3338 3534 3933 0a52 6566 3a20 7368  e.385493.Ref: sh
│ │ │ │ +00003f40: 6973 6869 5f61 7574 6865 6e74 6963 6174  ishi_authenticat
│ │ │ │ +00003f50: 6f72 5f74 6f5f 6669 6c65 7f33 3835 3937  or_to_file.38597
│ │ │ │ +00003f60: 320a 5265 663a 2073 6869 7368 695f 6175  2.Ref: shishi_au
│ │ │ │ +00003f70: 7468 656e 7469 6361 746f 725f 7061 7273  thenticator_pars
│ │ │ │ +00003f80: 657f 3338 3636 3036 0a52 6566 3a20 7368  e.386606.Ref: sh
│ │ │ │ +00003f90: 6973 6869 5f61 7574 6865 6e74 6963 6174  ishi_authenticat
│ │ │ │ +00003fa0: 6f72 5f72 6561 647f 3338 3731 3238 0a52  or_read.387128.R
│ │ │ │ +00003fb0: 6566 3a20 7368 6973 6869 5f61 7574 6865  ef: shishi_authe
│ │ │ │ +00003fc0: 6e74 6963 6174 6f72 5f66 726f 6d5f 6669  nticator_from_fi
│ │ │ │ +00003fd0: 6c65 7f33 3837 3634 350a 5265 663a 2073  le.387645.Ref: s
│ │ │ │ +00003fe0: 6869 7368 695f 6175 7468 656e 7469 6361  hishi_authentica
│ │ │ │ +00003ff0: 746f 725f 7365 745f 6372 6561 6c6d 7f33  tor_set_crealm.3
│ │ │ │ +00004000: 3838 3237 360a 5265 663a 2073 6869 7368  88276.Ref: shish
│ │ │ │ +00004010: 695f 6175 7468 656e 7469 6361 746f 725f  i_authenticator_
│ │ │ │ +00004020: 7365 745f 636e 616d 657f 3338 3837 3832  set_cname.388782
│ │ │ │ +00004030: 0a52 6566 3a20 7368 6973 6869 5f61 7574  .Ref: shishi_aut
│ │ │ │ +00004040: 6865 6e74 6963 6174 6f72 5f63 6c69 656e  henticator_clien
│ │ │ │ +00004050: 745f 7365 747f 3338 3934 3335 0a52 6566  t_set.389435.Ref
│ │ │ │ +00004060: 3a20 7368 6973 6869 5f61 7574 6865 6e74  : shishi_authent
│ │ │ │ +00004070: 6963 6174 6f72 5f63 7469 6d65 7f33 3839  icator_ctime.389
│ │ │ │ +00004080: 3934 380a 5265 663a 2073 6869 7368 695f  948.Ref: shishi_
│ │ │ │ +00004090: 6175 7468 656e 7469 6361 746f 725f 6374  authenticator_ct
│ │ │ │ +000040a0: 696d 655f 7365 747f 3339 3034 3638 0a52  ime_set.390468.R
│ │ │ │ +000040b0: 6566 3a20 7368 6973 6869 5f61 7574 6865  ef: shishi_authe
│ │ │ │ +000040c0: 6e74 6963 6174 6f72 5f63 7573 6563 5f67  nticator_cusec_g
│ │ │ │ +000040d0: 6574 7f33 3930 3938 340a 5265 663a 2073  et.390984.Ref: s
│ │ │ │ +000040e0: 6869 7368 695f 6175 7468 656e 7469 6361  hishi_authentica
│ │ │ │ +000040f0: 746f 725f 6375 7365 635f 7365 747f 3339  tor_cusec_set.39
│ │ │ │ +00004100: 3135 3134 0a52 6566 3a20 7368 6973 6869  1514.Ref: shishi
│ │ │ │ +00004110: 5f61 7574 6865 6e74 6963 6174 6f72 5f73  _authenticator_s
│ │ │ │ +00004120: 6571 6e75 6d62 6572 5f67 6574 7f33 3932  eqnumber_get.392
│ │ │ │ +00004130: 3034 310a 5265 663a 2073 6869 7368 695f  041.Ref: shishi_
│ │ │ │ +00004140: 6175 7468 656e 7469 6361 746f 725f 7365  authenticator_se
│ │ │ │ +00004150: 716e 756d 6265 725f 7265 6d6f 7665 7f33  qnumber_remove.3
│ │ │ │ +00004160: 3932 3539 300a 5265 663a 2073 6869 7368  92590.Ref: shish
│ │ │ │ +00004170: 695f 6175 7468 656e 7469 6361 746f 725f  i_authenticator_
│ │ │ │ +00004180: 7365 716e 756d 6265 725f 7365 747f 3339  seqnumber_set.39
│ │ │ │ +00004190: 3330 3532 0a52 6566 3a20 7368 6973 6869  3052.Ref: shishi
│ │ │ │ +000041a0: 5f61 7574 6865 6e74 6963 6174 6f72 5f63  _authenticator_c
│ │ │ │ +000041b0: 6c69 656e 747f 3339 3335 3939 0a52 6566  lient.393599.Ref
│ │ │ │ +000041c0: 3a20 7368 6973 6869 5f61 7574 6865 6e74  : shishi_authent
│ │ │ │ +000041d0: 6963 6174 6f72 5f63 6c69 656e 7472 6561  icator_clientrea
│ │ │ │ +000041e0: 6c6d 7f33 3934 3537 350a 5265 663a 2073  lm.394575.Ref: s
│ │ │ │ +000041f0: 6869 7368 695f 6175 7468 656e 7469 6361  hishi_authentica
│ │ │ │ +00004200: 746f 725f 636b 7375 6d7f 3339 3535 3739  tor_cksum.395579
│ │ │ │ +00004210: 0a52 6566 3a20 7368 6973 6869 5f61 7574  .Ref: shishi_aut
│ │ │ │ +00004220: 6865 6e74 6963 6174 6f72 5f73 6574 5f63  henticator_set_c
│ │ │ │ +00004230: 6b73 756d 7f33 3936 3337 310a 5265 663a  ksum.396371.Ref:
│ │ │ │ +00004240: 2073 6869 7368 695f 6175 7468 656e 7469   shishi_authenti
│ │ │ │ +00004250: 6361 746f 725f 6164 645f 636b 7375 6d7f  cator_add_cksum.
│ │ │ │ +00004260: 3339 3733 3831 0a52 6566 3a20 7368 6973  397381.Ref: shis
│ │ │ │ +00004270: 6869 5f61 7574 6865 6e74 6963 6174 6f72  hi_authenticator
│ │ │ │ +00004280: 5f61 6464 5f63 6b73 756d 5f74 7970 657f  _add_cksum_type.
│ │ │ │ +00004290: 3339 3831 3630 0a52 6566 3a20 7368 6973  398160.Ref: shis
│ │ │ │ +000042a0: 6869 5f61 7574 6865 6e74 6963 6174 6f72  hi_authenticator
│ │ │ │ +000042b0: 5f63 6c65 6172 5f61 7574 686f 7269 7a61  _clear_authoriza
│ │ │ │ +000042c0: 7469 6f6e 6461 7461 7f33 3939 3033 330a  tiondata.399033.
│ │ │ │ +000042d0: 5265 663a 2073 6869 7368 695f 6175 7468  Ref: shishi_auth
│ │ │ │ +000042e0: 656e 7469 6361 746f 725f 6164 645f 6175  enticator_add_au
│ │ │ │ +000042f0: 7468 6f72 697a 6174 696f 6e64 6174 617f  thorizationdata.
│ │ │ │ +00004300: 3339 3935 3236 0a52 6566 3a20 7368 6973  399526.Ref: shis
│ │ │ │ +00004310: 6869 5f61 7574 6865 6e74 6963 6174 6f72  hi_authenticator
│ │ │ │ +00004320: 5f61 7574 686f 7269 7a61 7469 6f6e 6461  _authorizationda
│ │ │ │ +00004330: 7461 7f34 3030 3230 380a 5265 663a 2073  ta.400208.Ref: s
│ │ │ │ +00004340: 6869 7368 695f 6175 7468 656e 7469 6361  hishi_authentica
│ │ │ │ +00004350: 746f 725f 7265 6d6f 7665 5f73 7562 6b65  tor_remove_subke
│ │ │ │ +00004360: 797f 3430 3130 3035 0a52 6566 3a20 7368  y.401005.Ref: sh
│ │ │ │ +00004370: 6973 6869 5f61 7574 6865 6e74 6963 6174  ishi_authenticat
│ │ │ │ +00004380: 6f72 5f67 6574 5f73 7562 6b65 797f 3430  or_get_subkey.40
│ │ │ │ +00004390: 3134 3433 0a52 6566 3a20 7368 6973 6869  1443.Ref: shishi
│ │ │ │ +000043a0: 5f61 7574 6865 6e74 6963 6174 6f72 5f73  _authenticator_s
│ │ │ │ +000043b0: 6574 5f73 7562 6b65 797f 3430 3230 3138  et_subkey.402018
│ │ │ │ +000043c0: 0a52 6566 3a20 7368 6973 6869 5f61 7574  .Ref: shishi_aut
│ │ │ │ +000043d0: 6865 6e74 6963 6174 6f72 5f61 6464 5f72  henticator_add_r
│ │ │ │ +000043e0: 616e 646f 6d5f 7375 626b 6579 7f34 3033  andom_subkey.403
│ │ │ │ +000043f0: 3034 350a 5265 663a 2073 6869 7368 695f  045.Ref: shishi_
│ │ │ │ +00004400: 6175 7468 656e 7469 6361 746f 725f 6164  authenticator_ad
│ │ │ │ +00004410: 645f 7261 6e64 6f6d 5f73 7562 6b65 795f  d_random_subkey_
│ │ │ │ +00004420: 6574 7970 657f 3430 3335 3930 0a52 6566  etype.403590.Ref
│ │ │ │ +00004430: 3a20 7368 6973 6869 5f61 7574 6865 6e74  : shishi_authent
│ │ │ │ +00004440: 6963 6174 6f72 5f61 6464 5f73 7562 6b65  icator_add_subke
│ │ │ │ +00004450: 797f 3430 3431 3539 0a4e 6f64 653a 204b  y.404159.Node: K
│ │ │ │ +00004460: 5242 2d45 5252 4f52 2046 756e 6374 696f  RB-ERROR Functio
│ │ │ │ +00004470: 6e73 7f34 3034 3539 320a 5265 663a 2073  ns.404592.Ref: s
│ │ │ │ +00004480: 6869 7368 695f 6b72 6265 7272 6f72 7f34  hishi_krberror.4
│ │ │ │ +00004490: 3035 3834 360a 5265 663a 2073 6869 7368  05846.Ref: shish
│ │ │ │ +000044a0: 695f 6b72 6265 7272 6f72 5f70 7269 6e74  i_krberror_print
│ │ │ │ +000044b0: 7f34 3036 3138 310a 5265 663a 2073 6869  .406181.Ref: shi
│ │ │ │ +000044c0: 7368 695f 6b72 6265 7272 6f72 5f73 6176  shi_krberror_sav
│ │ │ │ +000044d0: 657f 3430 3636 3031 0a52 6566 3a20 7368  e.406601.Ref: sh
│ │ │ │ +000044e0: 6973 6869 5f6b 7262 6572 726f 725f 746f  ishi_krberror_to
│ │ │ │ +000044f0: 5f66 696c 657f 3430 3730 3035 0a52 6566  _file.407005.Ref
│ │ │ │ +00004500: 3a20 7368 6973 6869 5f6b 7262 6572 726f  : shishi_krberro
│ │ │ │ +00004510: 725f 7061 7273 657f 3430 3735 3936 0a52  r_parse.407596.R
│ │ │ │ +00004520: 6566 3a20 7368 6973 6869 5f6b 7262 6572  ef: shishi_krber
│ │ │ │ +00004530: 726f 725f 7265 6164 7f34 3038 3037 310a  ror_read.408071.
│ │ │ │ +00004540: 5265 663a 2073 6869 7368 695f 6b72 6265  Ref: shishi_krbe
│ │ │ │ +00004550: 7272 6f72 5f66 726f 6d5f 6669 6c65 7f34  rror_from_file.4
│ │ │ │ +00004560: 3038 3534 310a 5265 663a 2073 6869 7368  08541.Ref: shish
│ │ │ │ +00004570: 695f 6b72 6265 7272 6f72 5f62 7569 6c64  i_krberror_build
│ │ │ │ +00004580: 7f34 3039 3131 380a 5265 663a 2073 6869  .409118.Ref: shi
│ │ │ │ +00004590: 7368 695f 6b72 6265 7272 6f72 5f64 6572  shi_krberror_der
│ │ │ │ +000045a0: 7f34 3039 3539 340a 5265 663a 2073 6869  .409594.Ref: shi
│ │ │ │ +000045b0: 7368 695f 6b72 6265 7272 6f72 5f63 7265  shi_krberror_cre
│ │ │ │ +000045c0: 616c 6d7f 3431 3031 3735 0a52 6566 3a20  alm.410175.Ref: 
│ │ │ │ +000045d0: 7368 6973 6869 5f6b 7262 6572 726f 725f  shishi_krberror_
│ │ │ │ +000045e0: 7265 6d6f 7665 5f63 7265 616c 6d7f 3431  remove_crealm.41
│ │ │ │ +000045f0: 3037 3231 0a52 6566 3a20 7368 6973 6869  0721.Ref: shishi
│ │ │ │ +00004600: 5f6b 7262 6572 726f 725f 7365 745f 6372  _krberror_set_cr
│ │ │ │ +00004610: 6561 6c6d 7f34 3131 3132 310a 5265 663a  ealm.411121.Ref:
│ │ │ │ +00004620: 2073 6869 7368 695f 6b72 6265 7272 6f72   shishi_krberror
│ │ │ │ +00004630: 5f63 6c69 656e 747f 3431 3135 3736 0a52  _client.411576.R
│ │ │ │ +00004640: 6566 3a20 7368 6973 6869 5f6b 7262 6572  ef: shishi_krber
│ │ │ │ +00004650: 726f 725f 7365 745f 636e 616d 657f 3431  ror_set_cname.41
│ │ │ │ +00004660: 3232 3839 0a52 6566 3a20 7368 6973 6869  2289.Ref: shishi
│ │ │ │ +00004670: 5f6b 7262 6572 726f 725f 7265 6d6f 7665  _krberror_remove
│ │ │ │ +00004680: 5f63 6e61 6d65 7f34 3132 3839 360a 5265  _cname.412896.Re
│ │ │ │ +00004690: 663a 2073 6869 7368 695f 6b72 6265 7272  f: shishi_krberr
│ │ │ │ +000046a0: 6f72 5f63 6c69 656e 745f 7365 747f 3431  or_client_set.41
│ │ │ │ +000046b0: 3332 3935 0a52 6566 3a20 7368 6973 6869  3295.Ref: shishi
│ │ │ │ +000046c0: 5f6b 7262 6572 726f 725f 7265 616c 6d7f  _krberror_realm.
│ │ │ │ +000046d0: 3431 3337 3733 0a52 6566 3a20 7368 6973  413773.Ref: shis
│ │ │ │ +000046e0: 6869 5f6b 7262 6572 726f 725f 7365 745f  hi_krberror_set_
│ │ │ │ +000046f0: 7265 616c 6d7f 3431 3433 3132 0a52 6566  realm.414312.Ref
│ │ │ │ +00004700: 3a20 7368 6973 6869 5f6b 7262 6572 726f  : shishi_krberro
│ │ │ │ +00004710: 725f 7365 7276 6572 7f34 3134 3738 370a  r_server.414787.
│ │ │ │ +00004720: 5265 663a 2073 6869 7368 695f 6b72 6265  Ref: shishi_krbe
│ │ │ │ +00004730: 7272 6f72 5f72 656d 6f76 655f 736e 616d  rror_remove_snam
│ │ │ │ +00004740: 657f 3431 3535 3033 0a52 6566 3a20 7368  e.415503.Ref: sh
│ │ │ │ +00004750: 6973 6869 5f6b 7262 6572 726f 725f 7365  ishi_krberror_se
│ │ │ │ +00004760: 745f 736e 616d 657f 3431 3630 3535 0a52  t_sname.416055.R
│ │ │ │ +00004770: 6566 3a20 7368 6973 6869 5f6b 7262 6572  ef: shishi_krber
│ │ │ │ +00004780: 726f 725f 7365 7276 6572 5f73 6574 7f34  ror_server_set.4
│ │ │ │ +00004790: 3136 3635 380a 5265 663a 2073 6869 7368  16658.Ref: shish
│ │ │ │ +000047a0: 695f 6b72 6265 7272 6f72 5f63 7469 6d65  i_krberror_ctime
│ │ │ │ +000047b0: 7f34 3137 3133 360a 5265 663a 2073 6869  .417136.Ref: shi
│ │ │ │ +000047c0: 7368 695f 6b72 6265 7272 6f72 5f63 7469  shi_krberror_cti
│ │ │ │ +000047d0: 6d65 5f73 6574 7f34 3137 3539 320a 5265  me_set.417592.Re
│ │ │ │ +000047e0: 663a 2073 6869 7368 695f 6b72 6265 7272  f: shishi_krberr
│ │ │ │ +000047f0: 6f72 5f72 656d 6f76 655f 6374 696d 657f  or_remove_ctime.
│ │ │ │ +00004800: 3431 3830 3634 0a52 6566 3a20 7368 6973  418064.Ref: shis
│ │ │ │ +00004810: 6869 5f6b 7262 6572 726f 725f 6375 7365  hi_krberror_cuse
│ │ │ │ +00004820: 637f 3431 3834 3531 0a52 6566 3a20 7368  c.418451.Ref: sh
│ │ │ │ +00004830: 6973 6869 5f6b 7262 6572 726f 725f 6375  ishi_krberror_cu
│ │ │ │ +00004840: 7365 635f 7365 747f 3431 3839 3237 0a52  sec_set.418927.R
│ │ │ │ +00004850: 6566 3a20 7368 6973 6869 5f6b 7262 6572  ef: shishi_krber
│ │ │ │ +00004860: 726f 725f 7265 6d6f 7665 5f63 7573 6563  ror_remove_cusec
│ │ │ │ +00004870: 7f34 3139 3430 320a 5265 663a 2073 6869  .419402.Ref: shi
│ │ │ │ +00004880: 7368 695f 6b72 6265 7272 6f72 5f73 7469  shi_krberror_sti
│ │ │ │ +00004890: 6d65 7f34 3139 3738 390a 5265 663a 2073  me.419789.Ref: s
│ │ │ │ +000048a0: 6869 7368 695f 6b72 6265 7272 6f72 5f73  hishi_krberror_s
│ │ │ │ +000048b0: 7469 6d65 5f73 6574 7f34 3230 3234 350a  time_set.420245.
│ │ │ │ +000048c0: 5265 663a 2073 6869 7368 695f 6b72 6265  Ref: shishi_krbe
│ │ │ │ +000048d0: 7272 6f72 5f73 7573 6563 7f34 3230 3730  rror_susec.42070
│ │ │ │ +000048e0: 330a 5265 663a 2073 6869 7368 695f 6b72  3.Ref: shishi_kr
│ │ │ │ +000048f0: 6265 7272 6f72 5f73 7573 6563 5f73 6574  berror_susec_set
│ │ │ │ +00004900: 7f34 3231 3137 390a 5265 663a 2073 6869  .421179.Ref: shi
│ │ │ │ +00004910: 7368 695f 6b72 6265 7272 6f72 5f65 7272  shi_krberror_err
│ │ │ │ +00004920: 6f72 636f 6465 7f34 3231 3634 380a 5265  orcode.421648.Re
│ │ │ │ +00004930: 663a 2073 6869 7368 695f 6b72 6265 7272  f: shishi_krberr
│ │ │ │ +00004940: 6f72 5f65 7272 6f72 636f 6465 5f66 6173  or_errorcode_fas
│ │ │ │ +00004950: 747f 3432 3231 3038 0a52 6566 3a20 7368  t.422108.Ref: sh
│ │ │ │ +00004960: 6973 6869 5f6b 7262 6572 726f 725f 6572  ishi_krberror_er
│ │ │ │ +00004970: 726f 7263 6f64 655f 7365 747f 3432 3235  rorcode_set.4225
│ │ │ │ +00004980: 3737 0a52 6566 3a20 7368 6973 6869 5f6b  77.Ref: shishi_k
│ │ │ │ +00004990: 7262 6572 726f 725f 6574 6578 747f 3432  rberror_etext.42
│ │ │ │ +000049a0: 3330 3333 0a52 6566 3a20 7368 6973 6869  3033.Ref: shishi
│ │ │ │ +000049b0: 5f6b 7262 6572 726f 725f 7365 745f 6574  _krberror_set_et
│ │ │ │ +000049c0: 6578 747f 3432 3335 3731 0a52 6566 3a20  ext.423571.Ref: 
│ │ │ │ +000049d0: 7368 6973 6869 5f6b 7262 6572 726f 725f  shishi_krberror_
│ │ │ │ +000049e0: 7265 6d6f 7665 5f65 7465 7874 7f34 3234  remove_etext.424
│ │ │ │ +000049f0: 3036 370a 5265 663a 2073 6869 7368 695f  067.Ref: shishi_
│ │ │ │ +00004a00: 6b72 6265 7272 6f72 5f65 6461 7461 7f34  krberror_edata.4
│ │ │ │ +00004a10: 3234 3436 330a 5265 663a 2073 6869 7368  24463.Ref: shish
│ │ │ │ +00004a20: 695f 6b72 6265 7272 6f72 5f6d 6574 686f  i_krberror_metho
│ │ │ │ +00004a30: 6464 6174 617f 3432 3530 3033 0a52 6566  ddata.425003.Ref
│ │ │ │ +00004a40: 3a20 7368 6973 6869 5f6b 7262 6572 726f  : shishi_krberro
│ │ │ │ +00004a50: 725f 7365 745f 6564 6174 617f 3432 3535  r_set_edata.4255
│ │ │ │ +00004a60: 3939 0a52 6566 3a20 7368 6973 6869 5f6b  99.Ref: shishi_k
│ │ │ │ +00004a70: 7262 6572 726f 725f 7265 6d6f 7665 5f65  rberror_remove_e
│ │ │ │ +00004a80: 6461 7461 7f34 3236 3039 350a 5265 663a  data.426095.Ref:
│ │ │ │ +00004a90: 2073 6869 7368 695f 6b72 6265 7272 6f72   shishi_krberror
│ │ │ │ +00004aa0: 5f70 7265 7474 795f 7072 696e 747f 3432  _pretty_print.42
│ │ │ │ +00004ab0: 3635 3035 0a52 6566 3a20 7368 6973 6869  6505.Ref: shishi
│ │ │ │ +00004ac0: 5f6b 7262 6572 726f 725f 6572 726f 7263  _krberror_errorc
│ │ │ │ +00004ad0: 6f64 655f 6d65 7373 6167 657f 3432 3730  ode_message.4270
│ │ │ │ +00004ae0: 3030 0a52 6566 3a20 7368 6973 6869 5f6b  00.Ref: shishi_k
│ │ │ │ +00004af0: 7262 6572 726f 725f 6d65 7373 6167 657f  rberror_message.
│ │ │ │ +00004b00: 3432 3734 3838 0a4e 6f64 653a 2043 7279  427488.Node: Cry
│ │ │ │ +00004b10: 7074 6f67 7261 7068 6963 2046 756e 6374  ptographic Funct
│ │ │ │ +00004b20: 696f 6e73 7f34 3238 3032 350a 5265 663a  ions.428025.Ref:
│ │ │ │ +00004b30: 2073 6869 7368 695f 6b65 795f 7072 696e   shishi_key_prin
│ │ │ │ +00004b40: 6369 7061 6c7f 3432 3839 3934 0a52 6566  cipal.428994.Ref
│ │ │ │ +00004b50: 3a20 7368 6973 6869 5f6b 6579 5f70 7269  : shishi_key_pri
│ │ │ │ +00004b60: 6e63 6970 616c 5f73 6574 7f34 3239 3339  ncipal_set.42939
│ │ │ │ +00004b70: 320a 5265 663a 2073 6869 7368 695f 6b65  2.Ref: shishi_ke
│ │ │ │ +00004b80: 795f 7265 616c 6d7f 3432 3937 3937 0a52  y_realm.429797.R
│ │ │ │ +00004b90: 6566 3a20 7368 6973 6869 5f6b 6579 5f72  ef: shishi_key_r
│ │ │ │ +00004ba0: 6561 6c6d 5f73 6574 7f34 3330 3136 330a  ealm_set.430163.
│ │ │ │ +00004bb0: 5265 663a 2073 6869 7368 695f 6b65 795f  Ref: shishi_key_
│ │ │ │ +00004bc0: 7479 7065 7f34 3330 3536 340a 5265 663a  type.430564.Ref:
│ │ │ │ +00004bd0: 2073 6869 7368 695f 6b65 795f 7479 7065   shishi_key_type
│ │ │ │ +00004be0: 5f73 6574 7f34 3330 3834 320a 5265 663a  _set.430842.Ref:
│ │ │ │ +00004bf0: 2073 6869 7368 695f 6b65 795f 7661 6c75   shishi_key_valu
│ │ │ │ +00004c00: 657f 3433 3130 3837 0a52 6566 3a20 7368  e.431087.Ref: sh
│ │ │ │ +00004c10: 6973 6869 5f6b 6579 5f76 616c 7565 5f73  ishi_key_value_s
│ │ │ │ +00004c20: 6574 7f34 3331 3431 340a 5265 663a 2073  et.431414.Ref: s
│ │ │ │ +00004c30: 6869 7368 695f 6b65 795f 7665 7273 696f  hishi_key_versio
│ │ │ │ +00004c40: 6e7f 3433 3138 3637 0a52 6566 3a20 7368  n.431867.Ref: sh
│ │ │ │ +00004c50: 6973 6869 5f6b 6579 5f76 6572 7369 6f6e  ishi_key_version
│ │ │ │ +00004c60: 5f73 6574 7f34 3332 3230 340a 5265 663a  _set.432204.Ref:
│ │ │ │ +00004c70: 2073 6869 7368 695f 6b65 795f 7469 6d65   shishi_key_time
│ │ │ │ +00004c80: 7374 616d 707f 3433 3235 3239 0a52 6566  stamp.432529.Ref
│ │ │ │ +00004c90: 3a20 7368 6973 6869 5f6b 6579 5f74 696d  : shishi_key_tim
│ │ │ │ +00004ca0: 6573 7461 6d70 5f73 6574 7f34 3332 3935  estamp_set.43295
│ │ │ │ +00004cb0: 340a 5265 663a 2073 6869 7368 695f 6b65  4.Ref: shishi_ke
│ │ │ │ +00004cc0: 795f 6e61 6d65 7f34 3333 3330 390a 5265  y_name.433309.Re
│ │ │ │ +00004cd0: 663a 2073 6869 7368 695f 6b65 795f 6c65  f: shishi_key_le
│ │ │ │ +00004ce0: 6e67 7468 7f34 3333 3535 380a 5265 663a  ngth.433558.Ref:
│ │ │ │ +00004cf0: 2073 6869 7368 695f 6b65 797f 3433 3338   shishi_key.4338
│ │ │ │ +00004d00: 3134 0a52 6566 3a20 7368 6973 6869 5f6b  14.Ref: shishi_k
│ │ │ │ +00004d10: 6579 5f64 6f6e 657f 3433 3431 3738 0a52  ey_done.434178.R
│ │ │ │ +00004d20: 6566 3a20 7368 6973 6869 5f6b 6579 5f63  ef: shishi_key_c
│ │ │ │ +00004d30: 6f70 797f 3433 3433 3835 0a52 6566 3a20  opy.434385.Ref: 
│ │ │ │ +00004d40: 7368 6973 6869 5f6b 6579 5f66 726f 6d5f  shishi_key_from_
│ │ │ │ +00004d50: 7661 6c75 657f 3433 3437 3233 0a52 6566  value.434723.Ref
│ │ │ │ +00004d60: 3a20 7368 6973 6869 5f6b 6579 5f66 726f  : shishi_key_fro
│ │ │ │ +00004d70: 6d5f 6261 7365 3634 7f34 3335 3335 340a  m_base64.435354.
│ │ │ │ +00004d80: 5265 663a 2073 6869 7368 695f 6b65 795f  Ref: shishi_key_
│ │ │ │ +00004d90: 7261 6e64 6f6d 7f34 3336 3037 370a 5265  random.436077.Re
│ │ │ │ +00004da0: 663a 2073 6869 7368 695f 6b65 795f 6672  f: shishi_key_fr
│ │ │ │ +00004db0: 6f6d 5f72 616e 646f 6d7f 3433 3636 3337  om_random.436637
│ │ │ │ +00004dc0: 0a52 6566 3a20 7368 6973 6869 5f6b 6579  .Ref: shishi_key
│ │ │ │ +00004dd0: 5f66 726f 6d5f 7374 7269 6e67 7f34 3337  _from_string.437
│ │ │ │ +00004de0: 3333 380a 5265 663a 2073 6869 7368 695f  338.Ref: shishi_
│ │ │ │ +00004df0: 6b65 795f 6672 6f6d 5f6e 616d 657f 3433  key_from_name.43
│ │ │ │ +00004e00: 3833 3430 0a52 6566 3a20 7368 6973 6869  8340.Ref: shishi
│ │ │ │ +00004e10: 5f6b 6579 737f 3433 3936 3531 0a52 6566  _keys.439651.Ref
│ │ │ │ +00004e20: 3a20 7368 6973 6869 5f6b 6579 735f 646f  : shishi_keys_do
│ │ │ │ +00004e30: 6e65 7f34 3339 3938 370a 5265 663a 2073  ne.439987.Ref: s
│ │ │ │ +00004e40: 6869 7368 695f 6b65 7973 5f73 697a 657f  hishi_keys_size.
│ │ │ │ +00004e50: 3434 3033 3138 0a52 6566 3a20 7368 6973  440318.Ref: shis
│ │ │ │ +00004e60: 6869 5f6b 6579 735f 6e74 687f 3434 3035  hi_keys_nth.4405
│ │ │ │ +00004e70: 3737 0a52 6566 3a20 7368 6973 6869 5f6b  77.Ref: shishi_k
│ │ │ │ +00004e80: 6579 735f 7265 6d6f 7665 7f34 3431 3037  eys_remove.44107
│ │ │ │ +00004e90: 340a 5265 663a 2073 6869 7368 695f 6b65  4.Ref: shishi_ke
│ │ │ │ +00004ea0: 7973 5f61 6464 7f34 3431 3430 310a 5265  ys_add.441401.Re
│ │ │ │ +00004eb0: 663a 2073 6869 7368 695f 6b65 7973 5f70  f: shishi_keys_p
│ │ │ │ +00004ec0: 7269 6e74 7f34 3431 3835 330a 5265 663a  rint.441853.Ref:
│ │ │ │ +00004ed0: 2073 6869 7368 695f 6b65 7973 5f74 6f5f   shishi_keys_to_
│ │ │ │ +00004ee0: 6669 6c65 7f34 3432 3137 300a 5265 663a  file.442170.Ref:
│ │ │ │ +00004ef0: 2073 6869 7368 695f 6b65 7973 5f66 726f   shishi_keys_fro
│ │ │ │ +00004f00: 6d5f 6669 6c65 7f34 3432 3734 350a 5265  m_file.442745.Re
│ │ │ │ +00004f10: 663a 2073 6869 7368 695f 6b65 7973 5f66  f: shishi_keys_f
│ │ │ │ +00004f20: 6f72 5f73 6572 7665 7272 6561 6c6d 5f69  or_serverrealm_i
│ │ │ │ +00004f30: 6e5f 6669 6c65 7f34 3433 3237 310a 5265  n_file.443271.Re
│ │ │ │ +00004f40: 663a 2073 6869 7368 695f 6b65 7973 5f66  f: shishi_keys_f
│ │ │ │ +00004f50: 6f72 5f73 6572 7665 725f 696e 5f66 696c  or_server_in_fil
│ │ │ │ +00004f60: 657f 3434 3339 3632 0a52 6566 3a20 7368  e.443962.Ref: sh
│ │ │ │ +00004f70: 6973 6869 5f6b 6579 735f 666f 725f 6c6f  ishi_keys_for_lo
│ │ │ │ +00004f80: 6361 6c73 6572 7669 6365 7265 616c 6d5f  calservicerealm_
│ │ │ │ +00004f90: 696e 5f66 696c 657f 3434 3435 3436 0a52  in_file.444546.R
│ │ │ │ +00004fa0: 6566 3a20 7368 6973 6869 5f68 6f73 746b  ef: shishi_hostk
│ │ │ │ +00004fb0: 6579 735f 6465 6661 756c 745f 6669 6c65  eys_default_file
│ │ │ │ +00004fc0: 7f34 3435 3636 390a 5265 663a 2073 6869  .445669.Ref: shi
│ │ │ │ +00004fd0: 7368 695f 686f 7374 6b65 7973 5f64 6566  shi_hostkeys_def
│ │ │ │ +00004fe0: 6175 6c74 5f66 696c 655f 7365 747f 3434  ault_file_set.44
│ │ │ │ +00004ff0: 3630 3839 0a52 6566 3a20 7368 6973 6869  6089.Ref: shishi
│ │ │ │ +00005000: 5f68 6f73 746b 6579 735f 666f 725f 7365  _hostkeys_for_se
│ │ │ │ +00005010: 7276 6572 7f34 3436 3631 370a 5265 663a  rver.446617.Ref:
│ │ │ │ +00005020: 2073 6869 7368 695f 686f 7374 6b65 7973   shishi_hostkeys
│ │ │ │ +00005030: 5f66 6f72 5f73 6572 7665 7272 6561 6c6d  _for_serverrealm
│ │ │ │ +00005040: 7f34 3437 3134 360a 5265 663a 2073 6869  .447146.Ref: shi
│ │ │ │ +00005050: 7368 695f 686f 7374 6b65 7973 5f66 6f72  shi_hostkeys_for
│ │ │ │ +00005060: 5f6c 6f63 616c 7365 7276 6963 6572 6561  _localservicerea
│ │ │ │ +00005070: 6c6d 7f34 3437 3738 300a 5265 663a 2073  lm.447780.Ref: s
│ │ │ │ +00005080: 6869 7368 695f 686f 7374 6b65 7973 5f66  hishi_hostkeys_f
│ │ │ │ +00005090: 6f72 5f6c 6f63 616c 7365 7276 6963 657f  or_localservice.
│ │ │ │ +000050a0: 3434 3835 3138 0a52 6566 3a20 7368 6973  448518.Ref: shis
│ │ │ │ +000050b0: 6869 5f63 6970 6865 725f 7375 7070 6f72  hi_cipher_suppor
│ │ │ │ +000050c0: 7465 645f 707f 3434 3933 3036 0a52 6566  ted_p.449306.Ref
│ │ │ │ +000050d0: 3a20 7368 6973 6869 5f63 6970 6865 725f  : shishi_cipher_
│ │ │ │ +000050e0: 6e61 6d65 7f34 3439 3536 330a 5265 663a  name.449563.Ref:
│ │ │ │ +000050f0: 2073 6869 7368 695f 6369 7068 6572 5f62   shishi_cipher_b
│ │ │ │ +00005100: 6c6f 636b 7369 7a65 7f34 3439 3839 350a  locksize.449895.
│ │ │ │ +00005110: 5265 663a 2073 6869 7368 695f 6369 7068  Ref: shishi_ciph
│ │ │ │ +00005120: 6572 5f63 6f6e 666f 756e 6465 7273 697a  er_confoundersiz
│ │ │ │ +00005130: 657f 3435 3032 3031 0a52 6566 3a20 7368  e.450201.Ref: sh
│ │ │ │ +00005140: 6973 6869 5f63 6970 6865 725f 6b65 796c  ishi_cipher_keyl
│ │ │ │ +00005150: 656e 7f34 3530 3630 320a 5265 663a 2073  en.450602.Ref: s
│ │ │ │ +00005160: 6869 7368 695f 6369 7068 6572 5f72 616e  hishi_cipher_ran
│ │ │ │ +00005170: 646f 6d6c 656e 7f34 3530 3931 300a 5265  domlen.450910.Re
│ │ │ │ +00005180: 663a 2073 6869 7368 695f 6369 7068 6572  f: shishi_cipher
│ │ │ │ +00005190: 5f64 6566 6175 6c74 636b 7375 6d74 7970  _defaultcksumtyp
│ │ │ │ +000051a0: 657f 3435 3133 3134 0a52 6566 3a20 7368  e.451314.Ref: sh
│ │ │ │ +000051b0: 6973 6869 5f63 6970 6865 725f 7061 7273  ishi_cipher_pars
│ │ │ │ +000051c0: 657f 3435 3136 3534 0a52 6566 3a20 7368  e.451654.Ref: sh
│ │ │ │ +000051d0: 6973 6869 5f63 6865 636b 7375 6d5f 7375  ishi_checksum_su
│ │ │ │ +000051e0: 7070 6f72 7465 645f 707f 3435 3139 3636  pported_p.451966
│ │ │ │ +000051f0: 0a52 6566 3a20 7368 6973 6869 5f63 6865  .Ref: shishi_che
│ │ │ │ +00005200: 636b 7375 6d5f 6e61 6d65 7f34 3532 3234  cksum_name.45224
│ │ │ │ +00005210: 300a 5265 663a 2073 6869 7368 695f 6368  0.Ref: shishi_ch
│ │ │ │ +00005220: 6563 6b73 756d 5f63 6b73 756d 6c65 6e7f  ecksum_cksumlen.
│ │ │ │ +00005230: 3435 3235 3630 0a52 6566 3a20 7368 6973  452560.Ref: shis
│ │ │ │ +00005240: 6869 5f63 6865 636b 7375 6d5f 7061 7273  hi_checksum_pars
│ │ │ │ +00005250: 657f 3435 3238 3737 0a52 6566 3a20 7368  e.452877.Ref: sh
│ │ │ │ +00005260: 6973 6869 5f73 7472 696e 675f 746f 5f6b  ishi_string_to_k
│ │ │ │ +00005270: 6579 7f34 3533 3231 320a 5265 663a 2073  ey.453212.Ref: s
│ │ │ │ +00005280: 6869 7368 695f 7261 6e64 6f6d 5f74 6f5f  hishi_random_to_
│ │ │ │ +00005290: 6b65 797f 3435 3433 3333 0a52 6566 3a20  key.454333.Ref: 
│ │ │ │ +000052a0: 7368 6973 6869 5f63 6865 636b 7375 6d7f  shishi_checksum.
│ │ │ │ +000052b0: 3435 3530 3034 0a52 6566 3a20 7368 6973  455004.Ref: shis
│ │ │ │ +000052c0: 6869 5f76 6572 6966 797f 3435 3539 3530  hi_verify.455950
│ │ │ │ +000052d0: 0a52 6566 3a20 7368 6973 6869 5f65 6e63  .Ref: shishi_enc
│ │ │ │ +000052e0: 7279 7074 5f69 7675 7064 6174 655f 6574  rypt_ivupdate_et
│ │ │ │ +000052f0: 7970 657f 3435 3638 3738 0a52 6566 3a20  ype.456878.Ref: 
│ │ │ │ +00005300: 7368 6973 6869 5f65 6e63 7279 7074 5f69  shishi_encrypt_i
│ │ │ │ +00005310: 765f 6574 7970 657f 3435 3838 3331 0a52  v_etype.458831.R
│ │ │ │ +00005320: 6566 3a20 7368 6973 6869 5f65 6e63 7279  ef: shishi_encry
│ │ │ │ +00005330: 7074 5f65 7479 7065 7f34 3630 3537 360a  pt_etype.460576.
│ │ │ │ +00005340: 5265 663a 2073 6869 7368 695f 656e 6372  Ref: shishi_encr
│ │ │ │ +00005350: 7970 745f 6976 7570 6461 7465 7f34 3632  ypt_ivupdate.462
│ │ │ │ +00005360: 3236 330a 5265 663a 2073 6869 7368 695f  263.Ref: shishi_
│ │ │ │ +00005370: 656e 6372 7970 745f 6976 7f34 3634 3039  encrypt_iv.46409
│ │ │ │ +00005380: 370a 5265 663a 2073 6869 7368 695f 656e  7.Ref: shishi_en
│ │ │ │ +00005390: 6372 7970 747f 3436 3537 3137 0a52 6566  crypt.465717.Ref
│ │ │ │ +000053a0: 3a20 7368 6973 6869 5f64 6563 7279 7074  : shishi_decrypt
│ │ │ │ +000053b0: 5f69 7675 7064 6174 655f 6574 7970 657f  _ivupdate_etype.
│ │ │ │ +000053c0: 3436 3732 3730 0a52 6566 3a20 7368 6973  467270.Ref: shis
│ │ │ │ +000053d0: 6869 5f64 6563 7279 7074 5f69 765f 6574  hi_decrypt_iv_et
│ │ │ │ +000053e0: 7970 657f 3436 3932 3233 0a52 6566 3a20  ype.469223.Ref: 
│ │ │ │ +000053f0: 7368 6973 6869 5f64 6563 7279 7074 5f65  shishi_decrypt_e
│ │ │ │ +00005400: 7479 7065 7f34 3730 3936 380a 5265 663a  type.470968.Ref:
│ │ │ │ +00005410: 2073 6869 7368 695f 6465 6372 7970 745f   shishi_decrypt_
│ │ │ │ +00005420: 6976 7570 6461 7465 7f34 3732 3632 340a  ivupdate.472624.
│ │ │ │ +00005430: 5265 663a 2073 6869 7368 695f 6465 6372  Ref: shishi_decr
│ │ │ │ +00005440: 7970 745f 6976 7f34 3734 3435 380a 5265  ypt_iv.474458.Re
│ │ │ │ +00005450: 663a 2073 6869 7368 695f 6465 6372 7970  f: shishi_decryp
│ │ │ │ +00005460: 747f 3437 3630 3834 0a52 6566 3a20 7368  t.476084.Ref: sh
│ │ │ │ +00005470: 6973 6869 5f6e 5f66 6f6c 647f 3437 3736  ishi_n_fold.4776
│ │ │ │ +00005480: 3035 0a52 6566 3a20 7368 6973 6869 5f64  05.Ref: shishi_d
│ │ │ │ +00005490: 727f 3437 3834 3930 0a52 6566 3a20 7368  r.478490.Ref: sh
│ │ │ │ +000054a0: 6973 6869 5f64 6b7f 3437 3932 3934 0a52  ishi_dk.479294.R
│ │ │ │ +000054b0: 6566 3a20 7368 6973 6869 5f63 7279 7074  ef: shishi_crypt
│ │ │ │ +000054c0: 6f7f 3438 3032 3837 0a52 6566 3a20 7368  o.480287.Ref: sh
│ │ │ │ +000054d0: 6973 6869 5f63 7279 7074 6f5f 656e 6372  ishi_crypto_encr
│ │ │ │ +000054e0: 7970 747f 3438 3134 3636 0a52 6566 3a20  ypt.481466.Ref: 
│ │ │ │ +000054f0: 7368 6973 6869 5f63 7279 7074 6f5f 6465  shishi_crypto_de
│ │ │ │ +00005500: 6372 7970 747f 3438 3233 3331 0a52 6566  crypt.482331.Ref
│ │ │ │ +00005510: 3a20 7368 6973 6869 5f63 7279 7074 6f5f  : shishi_crypto_
│ │ │ │ +00005520: 636c 6f73 657f 3438 3331 3932 0a52 6566  close.483192.Ref
│ │ │ │ +00005530: 3a20 7368 6973 6869 5f72 616e 646f 6d69  : shishi_randomi
│ │ │ │ +00005540: 7a65 7f34 3833 3635 350a 5265 663a 2073  ze.483655.Ref: s
│ │ │ │ +00005550: 6869 7368 695f 6372 637f 3438 3431 3836  hishi_crc.484186
│ │ │ │ +00005560: 0a52 6566 3a20 7368 6973 6869 5f6d 6434  .Ref: shishi_md4
│ │ │ │ +00005570: 7f34 3834 3932 360a 5265 663a 2073 6869  .484926.Ref: shi
│ │ │ │ +00005580: 7368 695f 6d64 357f 3438 3534 3533 0a52  shi_md5.485453.R
│ │ │ │ +00005590: 6566 3a20 7368 6973 6869 5f68 6d61 635f  ef: shishi_hmac_
│ │ │ │ +000055a0: 6d64 357f 3438 3539 3930 0a52 6566 3a20  md5.485990.Ref: 
│ │ │ │ +000055b0: 7368 6973 6869 5f68 6d61 635f 7368 6131  shishi_hmac_sha1
│ │ │ │ +000055c0: 7f34 3836 3732 310a 5265 663a 2073 6869  .486721.Ref: shi
│ │ │ │ +000055d0: 7368 695f 6465 735f 6362 635f 6d61 637f  shi_des_cbc_mac.
│ │ │ │ +000055e0: 3438 3734 3538 0a52 6566 3a20 7368 6973  487458.Ref: shis
│ │ │ │ +000055f0: 6869 5f61 7263 666f 7572 7f34 3838 3230  hi_arcfour.48820
│ │ │ │ +00005600: 340a 5265 663a 2073 6869 7368 695f 6465  4.Ref: shishi_de
│ │ │ │ +00005610: 737f 3438 3934 3739 0a52 6566 3a20 7368  s.489479.Ref: sh
│ │ │ │ +00005620: 6973 6869 5f33 6465 737f 3439 3034 3437  ishi_3des.490447
│ │ │ │ +00005630: 0a52 6566 3a20 7368 6973 6869 5f61 6573  .Ref: shishi_aes
│ │ │ │ +00005640: 5f63 7473 7f34 3931 3432 330a 5265 663a  _cts.491423.Ref:
│ │ │ │ +00005650: 2073 6869 7368 695f 7062 6b64 6632 5f73   shishi_pbkdf2_s
│ │ │ │ +00005660: 6861 317f 3439 3235 3733 0a4e 6f64 653a  ha1.492573.Node:
│ │ │ │ +00005670: 2058 2e35 3039 2046 756e 6374 696f 6e73   X.509 Functions
│ │ │ │ +00005680: 7f34 3933 3638 370a 5265 663a 2073 6869  .493687.Ref: shi
│ │ │ │ +00005690: 7368 695f 7835 3039 6361 5f64 6566 6175  shi_x509ca_defau
│ │ │ │ +000056a0: 6c74 5f66 696c 655f 6775 6573 737f 3439  lt_file_guess.49
│ │ │ │ +000056b0: 3430 3336 0a52 6566 3a20 7368 6973 6869  4036.Ref: shishi
│ │ │ │ +000056c0: 5f78 3530 3963 615f 6465 6661 756c 745f  _x509ca_default_
│ │ │ │ +000056d0: 6669 6c65 5f73 6574 7f34 3934 3530 300a  file_set.494500.
│ │ │ │ +000056e0: 5265 663a 2073 6869 7368 695f 7835 3039  Ref: shishi_x509
│ │ │ │ +000056f0: 6361 5f64 6566 6175 6c74 5f66 696c 657f  ca_default_file.
│ │ │ │ +00005700: 3439 3531 3434 0a52 6566 3a20 7368 6973  495144.Ref: shis
│ │ │ │ +00005710: 6869 5f78 3530 3963 6572 745f 6465 6661  hi_x509cert_defa
│ │ │ │ +00005720: 756c 745f 6669 6c65 5f67 7565 7373 7f34  ult_file_guess.4
│ │ │ │ +00005730: 3935 3637 360a 5265 663a 2073 6869 7368  95676.Ref: shish
│ │ │ │ +00005740: 695f 7835 3039 6365 7274 5f64 6566 6175  i_x509cert_defau
│ │ │ │ +00005750: 6c74 5f66 696c 655f 7365 747f 3439 3631  lt_file_set.4961
│ │ │ │ +00005760: 3633 0a52 6566 3a20 7368 6973 6869 5f78  63.Ref: shishi_x
│ │ │ │ +00005770: 3530 3963 6572 745f 6465 6661 756c 745f  509cert_default_
│ │ │ │ +00005780: 6669 6c65 7f34 3936 3832 350a 5265 663a  file.496825.Ref:
│ │ │ │ +00005790: 2073 6869 7368 695f 7835 3039 6b65 795f   shishi_x509key_
│ │ │ │ +000057a0: 6465 6661 756c 745f 6669 6c65 5f67 7565  default_file_gue
│ │ │ │ +000057b0: 7373 7f34 3937 3337 320a 5265 663a 2073  ss.497372.Ref: s
│ │ │ │ +000057c0: 6869 7368 695f 7835 3039 6b65 795f 6465  hishi_x509key_de
│ │ │ │ +000057d0: 6661 756c 745f 6669 6c65 5f73 6574 7f34  fault_file_set.4
│ │ │ │ +000057e0: 3937 3832 380a 5265 663a 2073 6869 7368  97828.Ref: shish
│ │ │ │ +000057f0: 695f 7835 3039 6b65 795f 6465 6661 756c  i_x509key_defaul
│ │ │ │ +00005800: 745f 6669 6c65 7f34 3938 3436 310a 4e6f  t_file.498461.No
│ │ │ │ +00005810: 6465 3a20 5574 696c 6974 7920 4675 6e63  de: Utility Func
│ │ │ │ +00005820: 7469 6f6e 737f 3439 3839 3034 0a52 6566  tions.498904.Ref
│ │ │ │ +00005830: 3a20 7368 6973 6869 5f72 6561 6c6d 5f64  : shishi_realm_d
│ │ │ │ +00005840: 6566 6175 6c74 5f67 7565 7373 7f34 3939  efault_guess.499
│ │ │ │ +00005850: 3132 360a 5265 663a 2073 6869 7368 695f  126.Ref: shishi_
│ │ │ │ +00005860: 7265 616c 6d5f 6465 6661 756c 747f 3530  realm_default.50
│ │ │ │ +00005870: 3032 3638 0a52 6566 3a20 7368 6973 6869  0268.Ref: shishi
│ │ │ │ +00005880: 5f72 6561 6c6d 5f64 6566 6175 6c74 5f73  _realm_default_s
│ │ │ │ +00005890: 6574 7f35 3030 3737 360a 5265 663a 2073  et.500776.Ref: s
│ │ │ │ +000058a0: 6869 7368 695f 7265 616c 6d5f 666f 725f  hishi_realm_for_
│ │ │ │ +000058b0: 7365 7276 6572 5f66 696c 657f 3530 3133  server_file.5013
│ │ │ │ +000058c0: 3937 0a52 6566 3a20 7368 6973 6869 5f72  97.Ref: shishi_r
│ │ │ │ +000058d0: 6561 6c6d 5f66 6f72 5f73 6572 7665 725f  ealm_for_server_
│ │ │ │ +000058e0: 646e 737f 3530 3138 3435 0a52 6566 3a20  dns.501845.Ref: 
│ │ │ │ +000058f0: 7368 6973 6869 5f72 6561 6c6d 5f66 6f72  shishi_realm_for
│ │ │ │ +00005900: 5f73 6572 7665 727f 3530 3334 3130 0a52  _server.503410.R
│ │ │ │ +00005910: 6566 3a20 7368 6973 6869 5f70 7269 6e63  ef: shishi_princ
│ │ │ │ +00005920: 6970 616c 5f64 6566 6175 6c74 5f67 7565  ipal_default_gue
│ │ │ │ +00005930: 7373 7f35 3034 3136 390a 5265 663a 2073  ss.504169.Ref: s
│ │ │ │ +00005940: 6869 7368 695f 7072 696e 6369 7061 6c5f  hishi_principal_
│ │ │ │ +00005950: 6465 6661 756c 747f 3530 3435 3939 0a52  default.504599.R
│ │ │ │ +00005960: 6566 3a20 7368 6973 6869 5f70 7269 6e63  ef: shishi_princ
│ │ │ │ +00005970: 6970 616c 5f64 6566 6175 6c74 5f73 6574  ipal_default_set
│ │ │ │ +00005980: 7f35 3035 3134 340a 5265 663a 2073 6869  .505144.Ref: shi
│ │ │ │ +00005990: 7368 695f 7061 7273 655f 6e61 6d65 7f35  shi_parse_name.5
│ │ │ │ +000059a0: 3035 3633 330a 5265 663a 2073 6869 7368  05633.Ref: shish
│ │ │ │ +000059b0: 695f 7072 696e 6369 7061 6c5f 6e61 6d65  i_principal_name
│ │ │ │ +000059c0: 7f35 3036 3435 330a 5265 663a 2073 6869  .506453.Ref: shi
│ │ │ │ +000059d0: 7368 695f 7072 696e 6369 7061 6c5f 6e61  shi_principal_na
│ │ │ │ +000059e0: 6d65 5f72 6561 6c6d 7f35 3037 3437 320a  me_realm.507472.
│ │ │ │ +000059f0: 5265 663a 2073 6869 7368 695f 7072 696e  Ref: shishi_prin
│ │ │ │ +00005a00: 6369 7061 6c5f 6e61 6d65 5f73 6574 7f35  cipal_name_set.5
│ │ │ │ +00005a10: 3038 3731 320a 5265 663a 2073 6869 7368  08712.Ref: shish
│ │ │ │ +00005a20: 695f 7072 696e 6369 7061 6c5f 7365 747f  i_principal_set.
│ │ │ │ +00005a30: 3530 3934 3130 0a52 6566 3a20 7368 6973  509410.Ref: shis
│ │ │ │ +00005a40: 6869 5f64 6572 6976 655f 6465 6661 756c  hi_derive_defaul
│ │ │ │ +00005a50: 745f 7361 6c74 7f35 3130 3032 300a 5265  t_salt.510020.Re
│ │ │ │ +00005a60: 663a 2073 6869 7368 695f 7365 7276 6572  f: shishi_server
│ │ │ │ +00005a70: 5f66 6f72 5f6c 6f63 616c 5f73 6572 7669  _for_local_servi
│ │ │ │ +00005a80: 6365 7f35 3130 3535 380a 5265 663a 2073  ce.510558.Ref: s
│ │ │ │ +00005a90: 6869 7368 695f 6175 7468 6f72 697a 655f  hishi_authorize_
│ │ │ │ +00005aa0: 7374 7263 6d70 7f35 3131 3139 330a 5265  strcmp.511193.Re
│ │ │ │ +00005ab0: 663a 2073 6869 7368 695f 6175 7468 6f72  f: shishi_author
│ │ │ │ +00005ac0: 697a 655f 6b35 6c6f 6769 6e7f 3531 3137  ize_k5login.5117
│ │ │ │ +00005ad0: 3932 0a52 6566 3a20 7368 6973 6869 5f61  92.Ref: shishi_a
│ │ │ │ +00005ae0: 7574 686f 7269 7a61 7469 6f6e 5f70 6172  uthorization_par
│ │ │ │ +00005af0: 7365 7f35 3132 3337 380a 5265 663a 2073  se.512378.Ref: s
│ │ │ │ +00005b00: 6869 7368 695f 6175 7468 6f72 697a 6564  hishi_authorized
│ │ │ │ +00005b10: 5f70 7f35 3132 3730 370a 5265 663a 2073  _p.512707.Ref: s
│ │ │ │ +00005b20: 6869 7368 695f 6765 6e65 7261 6c69 7a65  hishi_generalize
│ │ │ │ +00005b30: 5f74 696d 657f 3531 3334 3831 0a52 6566  _time.513481.Ref
│ │ │ │ +00005b40: 3a20 7368 6973 6869 5f67 656e 6572 616c  : shishi_general
│ │ │ │ +00005b50: 697a 655f 6e6f 777f 3531 3339 3631 0a52  ize_now.513961.R
│ │ │ │ +00005b60: 6566 3a20 7368 6973 6869 5f67 656e 6572  ef: shishi_gener
│ │ │ │ +00005b70: 616c 697a 655f 6374 696d 657f 3531 3433  alize_ctime.5143
│ │ │ │ +00005b80: 3831 0a52 6566 3a20 7368 6973 6869 5f74  81.Ref: shishi_t
│ │ │ │ +00005b90: 696d 657f 3531 3437 3930 0a52 6566 3a20  ime.514790.Ref: 
│ │ │ │ +00005ba0: 7368 6973 6869 5f63 7469 6d65 7f35 3135  shishi_ctime.515
│ │ │ │ +00005bb0: 3433 330a 5265 663a 2073 6869 7368 695f  433.Ref: shishi_
│ │ │ │ +00005bc0: 7072 6f6d 7074 5f70 6173 7377 6f72 645f  prompt_password_
│ │ │ │ +00005bd0: 6361 6c6c 6261 636b 5f73 6574 7f35 3136  callback_set.516
│ │ │ │ +00005be0: 3235 350a 5265 663a 2073 6869 7368 695f  255.Ref: shishi_
│ │ │ │ +00005bf0: 7072 6f6d 7074 5f70 6173 7377 6f72 645f  prompt_password_
│ │ │ │ +00005c00: 6361 6c6c 6261 636b 5f67 6574 7f35 3137  callback_get.517
│ │ │ │ +00005c10: 3136 340a 5265 663a 2073 6869 7368 695f  164.Ref: shishi_
│ │ │ │ +00005c20: 7072 6f6d 7074 5f70 6173 7377 6f72 647f  prompt_password.
│ │ │ │ +00005c30: 3531 3736 3138 0a52 6566 3a20 7368 6973  517618.Ref: shis
│ │ │ │ +00005c40: 6869 5f72 6573 6f6c 767f 3531 3832 3936  hi_resolv.518296
│ │ │ │ +00005c50: 0a52 6566 3a20 7368 6973 6869 5f72 6573  .Ref: shishi_res
│ │ │ │ +00005c60: 6f6c 765f 6672 6565 7f35 3138 3936 370a  olv_free.518967.
│ │ │ │ +00005c70: 4e6f 6465 3a20 4153 4e2e 3120 4675 6e63  Node: ASN.1 Func
│ │ │ │ +00005c80: 7469 6f6e 737f 3531 3932 3031 0a52 6566  tions.519201.Ref
│ │ │ │ +00005c90: 3a20 7368 6973 6869 5f61 736e 315f 7265  : shishi_asn1_re
│ │ │ │ +00005ca0: 6164 5f69 6e6c 696e 657f 3531 3934 3132  ad_inline.519412
│ │ │ │ +00005cb0: 0a52 6566 3a20 7368 6973 6869 5f61 736e  .Ref: shishi_asn
│ │ │ │ +00005cc0: 315f 7265 6164 7f35 3230 3337 340a 5265  1_read.520374.Re
│ │ │ │ +00005cd0: 663a 2073 6869 7368 695f 6173 6e31 5f72  f: shishi_asn1_r
│ │ │ │ +00005ce0: 6561 645f 6f70 7469 6f6e 616c 7f35 3231  ead_optional.521
│ │ │ │ +00005cf0: 3233 350a 5265 663a 2073 6869 7368 695f  235.Ref: shishi_
│ │ │ │ +00005d00: 6173 6e31 5f64 6f6e 657f 3532 3232 3030  asn1_done.522200
│ │ │ │ +00005d10: 0a52 6566 3a20 7368 6973 6869 5f61 736e  .Ref: shishi_asn
│ │ │ │ +00005d20: 315f 7061 5f65 6e63 5f74 735f 656e 637f  1_pa_enc_ts_enc.
│ │ │ │ +00005d30: 3532 3235 3631 0a52 6566 3a20 7368 6973  522561.Ref: shis
│ │ │ │ +00005d40: 6869 5f61 736e 315f 656e 6372 7970 7465  hi_asn1_encrypte
│ │ │ │ +00005d50: 6464 6174 617f 3532 3238 3633 0a52 6566  ddata.522863.Ref
│ │ │ │ +00005d60: 3a20 7368 6973 6869 5f61 736e 315f 7061  : shishi_asn1_pa
│ │ │ │ +00005d70: 6461 7461 7f35 3233 3135 300a 5265 663a  data.523150.Ref:
│ │ │ │ +00005d80: 2073 6869 7368 695f 6173 6e31 5f6d 6574   shishi_asn1_met
│ │ │ │ +00005d90: 686f 6464 6174 617f 3532 3334 3333 0a52  hoddata.523433.R
│ │ │ │ +00005da0: 6566 3a20 7368 6973 6869 5f61 736e 315f  ef: shishi_asn1_
│ │ │ │ +00005db0: 6574 7970 655f 696e 666f 7f35 3233 3732  etype_info.52372
│ │ │ │ +00005dc0: 340a 5265 663a 2073 6869 7368 695f 6173  4.Ref: shishi_as
│ │ │ │ +00005dd0: 6e31 5f65 7479 7065 5f69 6e66 6f32 7f35  n1_etype_info2.5
│ │ │ │ +00005de0: 3234 3031 360a 5265 663a 2073 6869 7368  24016.Ref: shish
│ │ │ │ +00005df0: 695f 6173 6e31 5f61 7372 6571 7f35 3234  i_asn1_asreq.524
│ │ │ │ +00005e00: 3239 380a 5265 663a 2073 6869 7368 695f  298.Ref: shishi_
│ │ │ │ +00005e10: 6173 6e31 5f61 7372 6570 7f35 3234 3536  asn1_asrep.52456
│ │ │ │ +00005e20: 390a 5265 663a 2073 6869 7368 695f 6173  9.Ref: shishi_as
│ │ │ │ +00005e30: 6e31 5f74 6773 7265 717f 3532 3438 3432  n1_tgsreq.524842
│ │ │ │ +00005e40: 0a52 6566 3a20 7368 6973 6869 5f61 736e  .Ref: shishi_asn
│ │ │ │ +00005e50: 315f 7467 7372 6570 7f35 3235 3131 370a  1_tgsrep.525117.
│ │ │ │ +00005e60: 5265 663a 2073 6869 7368 695f 6173 6e31  Ref: shishi_asn1
│ │ │ │ +00005e70: 5f61 7072 6571 7f35 3235 3339 300a 5265  _apreq.525390.Re
│ │ │ │ +00005e80: 663a 2073 6869 7368 695f 6173 6e31 5f61  f: shishi_asn1_a
│ │ │ │ +00005e90: 7072 6570 7f35 3235 3636 310a 5265 663a  prep.525661.Ref:
│ │ │ │ +00005ea0: 2073 6869 7368 695f 6173 6e31 5f65 6e63   shishi_asn1_enc
│ │ │ │ +00005eb0: 6170 7265 7070 6172 747f 3532 3539 3436  apreppart.525946
│ │ │ │ +00005ec0: 0a52 6566 3a20 7368 6973 6869 5f61 736e  .Ref: shishi_asn
│ │ │ │ +00005ed0: 315f 7469 636b 6574 7f35 3236 3232 360a  1_ticket.526226.
│ │ │ │ +00005ee0: 5265 663a 2073 6869 7368 695f 6173 6e31  Ref: shishi_asn1
│ │ │ │ +00005ef0: 5f65 6e63 7469 636b 6574 7061 7274 7f35  _encticketpart.5
│ │ │ │ +00005f00: 3236 3531 340a 5265 663a 2073 6869 7368  26514.Ref: shish
│ │ │ │ +00005f10: 695f 6173 6e31 5f61 7574 6865 6e74 6963  i_asn1_authentic
│ │ │ │ +00005f20: 6174 6f72 7f35 3236 3831 360a 5265 663a  ator.526816.Ref:
│ │ │ │ +00005f30: 2073 6869 7368 695f 6173 6e31 5f65 6e63   shishi_asn1_enc
│ │ │ │ +00005f40: 6b64 6372 6570 7061 7274 7f35 3237 3131  kdcreppart.52711
│ │ │ │ +00005f50: 380a 5265 663a 2073 6869 7368 695f 6173  8.Ref: shishi_as
│ │ │ │ +00005f60: 6e31 5f65 6e63 6173 7265 7070 6172 747f  n1_encasreppart.
│ │ │ │ +00005f70: 3532 3734 3138 0a52 6566 3a20 7368 6973  527418.Ref: shis
│ │ │ │ +00005f80: 6869 5f61 736e 315f 6b72 6265 7272 6f72  hi_asn1_krberror
│ │ │ │ +00005f90: 7f35 3237 3730 380a 5265 663a 2073 6869  .527708.Ref: shi
│ │ │ │ +00005fa0: 7368 695f 6173 6e31 5f6b 7262 7361 6665  shi_asn1_krbsafe
│ │ │ │ +00005fb0: 7f35 3237 3938 390a 5265 663a 2073 6869  .527989.Ref: shi
│ │ │ │ +00005fc0: 7368 695f 6173 6e31 5f70 7269 767f 3532  shi_asn1_priv.52
│ │ │ │ +00005fd0: 3832 3632 0a52 6566 3a20 7368 6973 6869  8262.Ref: shishi
│ │ │ │ +00005fe0: 5f61 736e 315f 656e 6370 7269 7670 6172  _asn1_encprivpar
│ │ │ │ +00005ff0: 747f 3532 3835 3436 0a52 6566 3a20 7368  t.528546.Ref: sh
│ │ │ │ +00006000: 6973 6869 5f61 736e 315f 746f 5f64 6572  ishi_asn1_to_der
│ │ │ │ +00006010: 5f66 6965 6c64 7f35 3238 3834 350a 5265  _field.528845.Re
│ │ │ │ +00006020: 663a 2073 6869 7368 695f 6173 6e31 5f74  f: shishi_asn1_t
│ │ │ │ +00006030: 6f5f 6465 727f 3532 3935 3930 0a52 6566  o_der.529590.Ref
│ │ │ │ +00006040: 3a20 7368 6973 6869 5f61 736e 315f 6d73  : shishi_asn1_ms
│ │ │ │ +00006050: 6774 7970 657f 3533 3032 3336 0a52 6566  gtype.530236.Ref
│ │ │ │ +00006060: 3a20 7368 6973 6869 5f64 6572 5f6d 7367  : shishi_der_msg
│ │ │ │ +00006070: 7479 7065 7f35 3330 3733 330a 5265 663a  type.530733.Ref:
│ │ │ │ +00006080: 2073 6869 7368 695f 6465 7232 6173 6e31   shishi_der2asn1
│ │ │ │ +00006090: 7f35 3331 3139 320a 5265 663a 2073 6869  .531192.Ref: shi
│ │ │ │ +000060a0: 7368 695f 6465 7232 6173 6e31 5f70 6164  shi_der2asn1_pad
│ │ │ │ +000060b0: 6174 617f 3533 3137 3133 0a52 6566 3a20  ata.531713.Ref: 
│ │ │ │ +000060c0: 7368 6973 6869 5f64 6572 3261 736e 315f  shishi_der2asn1_
│ │ │ │ +000060d0: 6d65 7468 6f64 6461 7461 7f35 3332 3231  methoddata.53221
│ │ │ │ +000060e0: 380a 5265 663a 2073 6869 7368 695f 6465  8.Ref: shishi_de
│ │ │ │ +000060f0: 7232 6173 6e31 5f65 7479 7065 5f69 6e66  r2asn1_etype_inf
│ │ │ │ +00006100: 6f7f 3533 3237 3331 0a52 6566 3a20 7368  o.532731.Ref: sh
│ │ │ │ +00006110: 6973 6869 5f64 6572 3261 736e 315f 6574  ishi_der2asn1_et
│ │ │ │ +00006120: 7970 655f 696e 666f 327f 3533 3332 3435  ype_info2.533245
│ │ │ │ +00006130: 0a52 6566 3a20 7368 6973 6869 5f64 6572  .Ref: shishi_der
│ │ │ │ +00006140: 3261 736e 315f 7469 636b 6574 7f35 3333  2asn1_ticket.533
│ │ │ │ +00006150: 3735 310a 5265 663a 2073 6869 7368 695f  751.Ref: shishi_
│ │ │ │ +00006160: 6465 7232 6173 6e31 5f65 6e63 7469 636b  der2asn1_enctick
│ │ │ │ +00006170: 6574 7061 7274 7f35 3334 3236 310a 5265  etpart.534261.Re
│ │ │ │ +00006180: 663a 2073 6869 7368 695f 6465 7232 6173  f: shishi_der2as
│ │ │ │ +00006190: 6e31 5f61 7372 6571 7f35 3334 3736 390a  n1_asreq.534769.
│ │ │ │ +000061a0: 5265 663a 2073 6869 7368 695f 6465 7232  Ref: shishi_der2
│ │ │ │ +000061b0: 6173 6e31 5f74 6773 7265 717f 3533 3532  asn1_tgsreq.5352
│ │ │ │ +000061c0: 3634 0a52 6566 3a20 7368 6973 6869 5f64  64.Ref: shishi_d
│ │ │ │ +000061d0: 6572 3261 736e 315f 6173 7265 707f 3533  er2asn1_asrep.53
│ │ │ │ +000061e0: 3537 3539 0a52 6566 3a20 7368 6973 6869  5759.Ref: shishi
│ │ │ │ +000061f0: 5f64 6572 3261 736e 315f 7467 7372 6570  _der2asn1_tgsrep
│ │ │ │ +00006200: 7f35 3336 3235 340a 5265 663a 2073 6869  .536254.Ref: shi
│ │ │ │ +00006210: 7368 695f 6465 7232 6173 6e31 5f6b 6463  shi_der2asn1_kdc
│ │ │ │ +00006220: 7265 707f 3533 3637 3531 0a52 6566 3a20  rep.536751.Ref: 
│ │ │ │ +00006230: 7368 6973 6869 5f64 6572 3261 736e 315f  shishi_der2asn1_
│ │ │ │ +00006240: 656e 6361 7372 6570 7061 7274 7f35 3337  encasreppart.537
│ │ │ │ +00006250: 3236 300a 5265 663a 2073 6869 7368 695f  260.Ref: shishi_
│ │ │ │ +00006260: 6465 7232 6173 6e31 5f65 6e63 7467 7372  der2asn1_enctgsr
│ │ │ │ +00006270: 6570 7061 7274 7f35 3337 3738 320a 5265  eppart.537782.Re
│ │ │ │ +00006280: 663a 2073 6869 7368 695f 6465 7232 6173  f: shishi_der2as
│ │ │ │ +00006290: 6e31 5f65 6e63 6b64 6372 6570 7061 7274  n1_enckdcreppart
│ │ │ │ +000062a0: 7f35 3338 3330 360a 5265 663a 2073 6869  .538306.Ref: shi
│ │ │ │ +000062b0: 7368 695f 6465 7232 6173 6e31 5f61 7574  shi_der2asn1_aut
│ │ │ │ +000062c0: 6865 6e74 6963 6174 6f72 7f35 3338 3833  henticator.53883
│ │ │ │ +000062d0: 300a 5265 663a 2073 6869 7368 695f 6465  0.Ref: shishi_de
│ │ │ │ +000062e0: 7232 6173 6e31 5f6b 7262 6572 726f 727f  r2asn1_krberror.
│ │ │ │ +000062f0: 3533 3933 3434 0a52 6566 3a20 7368 6973  539344.Ref: shis
│ │ │ │ +00006300: 6869 5f64 6572 3261 736e 315f 6b72 6273  hi_der2asn1_krbs
│ │ │ │ +00006310: 6166 657f 3533 3938 3437 0a52 6566 3a20  afe.539847.Ref: 
│ │ │ │ +00006320: 7368 6973 6869 5f64 6572 3261 736e 315f  shishi_der2asn1_
│ │ │ │ +00006330: 7072 6976 7f35 3430 3334 320a 5265 663a  priv.540342.Ref:
│ │ │ │ +00006340: 2073 6869 7368 695f 6465 7232 6173 6e31   shishi_der2asn1
│ │ │ │ +00006350: 5f65 6e63 7072 6976 7061 7274 7f35 3430  _encprivpart.540
│ │ │ │ +00006360: 3834 380a 5265 663a 2073 6869 7368 695f  848.Ref: shishi_
│ │ │ │ +00006370: 6465 7232 6173 6e31 5f61 7072 6571 7f35  der2asn1_apreq.5
│ │ │ │ +00006380: 3431 3335 350a 5265 663a 2073 6869 7368  41355.Ref: shish
│ │ │ │ +00006390: 695f 6465 7232 6173 6e31 5f61 7072 6570  i_der2asn1_aprep
│ │ │ │ +000063a0: 7f35 3431 3834 380a 5265 663a 2073 6869  .541848.Ref: shi
│ │ │ │ +000063b0: 7368 695f 6465 7232 6173 6e31 5f65 6e63  shi_der2asn1_enc
│ │ │ │ +000063c0: 6170 7265 7070 6172 747f 3534 3233 3535  apreppart.542355
│ │ │ │ +000063d0: 0a52 6566 3a20 7368 6973 6869 5f64 6572  .Ref: shishi_der
│ │ │ │ +000063e0: 3261 736e 315f 6b64 6372 6571 7f35 3432  2asn1_kdcreq.542
│ │ │ │ +000063f0: 3836 330a 5265 663a 2073 6869 7368 695f  863.Ref: shishi_
│ │ │ │ +00006400: 6173 6e31 5f70 7269 6e74 7f35 3433 3336  asn1_print.54336
│ │ │ │ +00006410: 390a 4e6f 6465 3a20 4572 726f 7220 4861  9.Node: Error Ha
│ │ │ │ +00006420: 6e64 6c69 6e67 7f35 3433 3733 360a 4e6f  ndling.543736.No
│ │ │ │ +00006430: 6465 3a20 4572 726f 7220 5661 6c75 6573  de: Error Values
│ │ │ │ +00006440: 7f35 3434 3439 370a 4e6f 6465 3a20 4572  .544497.Node: Er
│ │ │ │ +00006450: 726f 7220 4675 6e63 7469 6f6e 737f 3534  ror Functions.54
│ │ │ │ +00006460: 3937 3430 0a52 6566 3a20 7368 6973 6869  9740.Ref: shishi
│ │ │ │ +00006470: 5f73 7472 6572 726f 727f 3534 3939 3037  _strerror.549907
│ │ │ │ +00006480: 0a52 6566 3a20 7368 6973 6869 5f65 7272  .Ref: shishi_err
│ │ │ │ +00006490: 6f72 7f35 3530 3330 380a 5265 663a 2073  or.550308.Ref: s
│ │ │ │ +000064a0: 6869 7368 695f 6572 726f 725f 636c 6561  hishi_error_clea
│ │ │ │ +000064b0: 727f 3535 3038 3036 0a52 6566 3a20 7368  r.550806.Ref: sh
│ │ │ │ +000064c0: 6973 6869 5f65 7272 6f72 5f73 6574 7f35  ishi_error_set.5
│ │ │ │ +000064d0: 3531 3337 360a 5265 663a 2073 6869 7368  51376.Ref: shish
│ │ │ │ +000064e0: 695f 6572 726f 725f 7072 696e 7466 7f35  i_error_printf.5
│ │ │ │ +000064f0: 3532 3037 300a 5265 663a 2073 6869 7368  52070.Ref: shish
│ │ │ │ +00006500: 695f 6572 726f 725f 6f75 7470 7574 7479  i_error_outputty
│ │ │ │ +00006510: 7065 7f35 3532 3632 340a 5265 663a 2073  pe.552624.Ref: s
│ │ │ │ +00006520: 6869 7368 695f 6572 726f 725f 7365 745f  hishi_error_set_
│ │ │ │ +00006530: 6f75 7470 7574 7479 7065 7f35 3533 3131  outputtype.55311
│ │ │ │ +00006540: 380a 5265 663a 2073 6869 7368 695f 696e  8.Ref: shishi_in
│ │ │ │ +00006550: 666f 7f35 3533 3736 390a 5265 663a 2073  fo.553769.Ref: s
│ │ │ │ +00006560: 6869 7368 695f 7761 726e 7f35 3534 3134  hishi_warn.55414
│ │ │ │ +00006570: 330a 5265 663a 2073 6869 7368 695f 7665  3.Ref: shishi_ve
│ │ │ │ +00006580: 7262 6f73 657f 3535 3435 3038 0a4e 6f64  rbose.554508.Nod
│ │ │ │ +00006590: 653a 2045 7861 6d70 6c65 737f 3535 3439  e: Examples.5549
│ │ │ │ +000065a0: 3931 0a4e 6f64 653a 204b 6572 6265 726f  91.Node: Kerbero
│ │ │ │ +000065b0: 7320 4461 7461 6261 7365 2046 756e 6374  s Database Funct
│ │ │ │ +000065c0: 696f 6e73 7f35 3536 3632 350a 5265 663a  ions.556625.Ref:
│ │ │ │ +000065d0: 2073 6869 7361 7f35 3539 3335 320a 5265   shisa.559352.Re
│ │ │ │ +000065e0: 663a 2073 6869 7361 5f64 6f6e 657f 3535  f: shisa_done.55
│ │ │ │ +000065f0: 3936 3137 0a52 6566 3a20 7368 6973 615f  9617.Ref: shisa_
│ │ │ │ +00006600: 696e 6974 7f35 3539 3930 330a 5265 663a  init.559903.Ref:
│ │ │ │ +00006610: 2073 6869 7361 5f69 6e69 745f 7769 7468   shisa_init_with
│ │ │ │ +00006620: 5f70 6174 6873 7f35 3630 3638 380a 5265  _paths.560688.Re
│ │ │ │ +00006630: 663a 2073 6869 7361 5f63 6667 5f64 627f  f: shisa_cfg_db.
│ │ │ │ +00006640: 3536 3138 3138 0a52 6566 3a20 7368 6973  561818.Ref: shis
│ │ │ │ +00006650: 615f 6366 677f 3536 3235 3431 0a52 6566  a_cfg.562541.Ref
│ │ │ │ +00006660: 3a20 7368 6973 615f 6366 675f 6672 6f6d  : shisa_cfg_from
│ │ │ │ +00006670: 5f66 696c 657f 3536 3332 3538 0a52 6566  _file.563258.Ref
│ │ │ │ +00006680: 3a20 7368 6973 615f 6366 675f 6465 6661  : shisa_cfg_defa
│ │ │ │ +00006690: 756c 745f 7379 7374 656d 6669 6c65 7f35  ult_systemfile.5
│ │ │ │ +000066a0: 3633 3733 320a 5265 663a 2073 6869 7361  63732.Ref: shisa
│ │ │ │ +000066b0: 5f65 6e75 6d65 7261 7465 5f72 6561 6c6d  _enumerate_realm
│ │ │ │ +000066c0: 737f 3536 3434 3737 0a52 6566 3a20 7368  s.564477.Ref: sh
│ │ │ │ +000066d0: 6973 615f 656e 756d 6572 6174 655f 7072  isa_enumerate_pr
│ │ │ │ +000066e0: 696e 6369 7061 6c73 7f35 3635 3231 330a  incipals.565213.
│ │ │ │ +000066f0: 5265 663a 2073 6869 7361 5f70 7269 6e63  Ref: shisa_princ
│ │ │ │ +00006700: 6970 616c 5f66 696e 647f 3536 3631 3339  ipal_find.566139
│ │ │ │ +00006710: 0a52 6566 3a20 7368 6973 615f 7072 696e  .Ref: shisa_prin
│ │ │ │ +00006720: 6369 7061 6c5f 7570 6461 7465 7f35 3636  cipal_update.566
│ │ │ │ +00006730: 3935 350a 5265 663a 2073 6869 7361 5f70  955.Ref: shisa_p
│ │ │ │ +00006740: 7269 6e63 6970 616c 5f61 6464 7f35 3638  rincipal_add.568
│ │ │ │ +00006750: 3239 330a 5265 663a 2073 6869 7361 5f70  293.Ref: shisa_p
│ │ │ │ +00006760: 7269 6e63 6970 616c 5f72 656d 6f76 657f  rincipal_remove.
│ │ │ │ +00006770: 3536 3932 3538 0a52 6566 3a20 7368 6973  569258.Ref: shis
│ │ │ │ +00006780: 615f 6b65 7973 5f66 696e 647f 3536 3939  a_keys_find.5699
│ │ │ │ +00006790: 3634 0a52 6566 3a20 7368 6973 615f 6b65  64.Ref: shisa_ke
│ │ │ │ +000067a0: 795f 6164 647f 3537 3131 3834 0a52 6566  y_add.571184.Ref
│ │ │ │ +000067b0: 3a20 7368 6973 615f 6b65 795f 7570 6461  : shisa_key_upda
│ │ │ │ +000067c0: 7465 7f35 3731 3830 370a 5265 663a 2073  te.571807.Ref: s
│ │ │ │ +000067d0: 6869 7361 5f6b 6579 5f72 656d 6f76 657f  hisa_key_remove.
│ │ │ │ +000067e0: 3537 3333 3338 0a52 6566 3a20 7368 6973  573338.Ref: shis
│ │ │ │ +000067f0: 615f 6b65 795f 6672 6565 7f35 3734 3338  a_key_free.57438
│ │ │ │ +00006800: 370a 5265 663a 2073 6869 7361 5f6b 6579  7.Ref: shisa_key
│ │ │ │ +00006810: 735f 6672 6565 7f35 3734 3730 390a 5265  s_free.574709.Re
│ │ │ │ +00006820: 663a 2073 6869 7361 5f73 7472 6572 726f  f: shisa_strerro
│ │ │ │ +00006830: 727f 3537 3533 3931 0a52 6566 3a20 7368  r.575391.Ref: sh
│ │ │ │ +00006840: 6973 615f 696e 666f 7f35 3735 3739 340a  isa_info.575794.
│ │ │ │ +00006850: 4e6f 6465 3a20 4765 6e65 7269 6320 5365  Node: Generic Se
│ │ │ │ +00006860: 6375 7269 7479 2053 6572 7669 6365 7f35  curity Service.5
│ │ │ │ +00006870: 3736 3133 310a 4e6f 6465 3a20 4163 6b6e  76131.Node: Ackn
│ │ │ │ +00006880: 6f77 6c65 6467 656d 656e 7473 7f35 3737  owledgements.577
│ │ │ │ +00006890: 3337 360a 4e6f 6465 3a20 4372 6974 6963  376.Node: Critic
│ │ │ │ +000068a0: 6973 6d20 6f66 204b 6572 6265 726f 737f  ism of Kerberos.
│ │ │ │ +000068b0: 3537 3830 3939 0a4e 6f64 653a 2050 726f  578099.Node: Pro
│ │ │ │ +000068c0: 746f 636f 6c20 4578 7465 6e73 696f 6e73  tocol Extensions
│ │ │ │ +000068d0: 7f35 3830 3334 360a 4e6f 6465 3a20 5354  .580346.Node: ST
│ │ │ │ +000068e0: 4152 5454 4c53 2070 726f 7465 6374 6564  ARTTLS protected
│ │ │ │ +000068f0: 204b 4443 2065 7863 6861 6e67 6573 7f35   KDC exchanges.5
│ │ │ │ +00006900: 3831 3136 360a 4e6f 6465 3a20 5465 6c6e  81166.Node: Teln
│ │ │ │ +00006910: 6574 2065 6e63 7279 7074 696f 6e20 7769  et encryption wi
│ │ │ │ +00006920: 7468 2041 4553 2d43 434d 7f35 3930 3333  th AES-CCM.59033
│ │ │ │ +00006930: 340a 4e6f 6465 3a20 4b65 7262 6572 697a  4.Node: Kerberiz
│ │ │ │ +00006940: 6564 2072 7368 2061 6e64 2072 6c6f 6769  ed rsh and rlogi
│ │ │ │ +00006950: 6e7f 3539 3833 3334 0a52 6566 3a20 6261  n.598334.Ref: ba
│ │ │ │ +00006960: 7369 6320 6175 7468 6f72 697a 6174 696f  sic authorizatio
│ │ │ │ +00006970: 6e7f 3630 3238 3433 0a52 6566 3a20 6b65  n.602843.Ref: ke
│ │ │ │ +00006980: 7262 6572 6f73 2061 7574 686f 7269 7a61  rberos authoriza
│ │ │ │ +00006990: 7469 6f6e 7f36 3130 3439 340a 4e6f 6465  tion.610494.Node
│ │ │ │ +000069a0: 3a20 4b65 7920 6173 2069 6e69 7469 616c  : Key as initial
│ │ │ │ +000069b0: 697a 6174 696f 6e20 7665 6374 6f72 7f36  ization vector.6
│ │ │ │ +000069c0: 3132 3730 380a 5265 663a 204b 6579 2061  12708.Ref: Key a
│ │ │ │ +000069d0: 7320 696e 6974 6961 6c69 7a61 7469 6f6e  s initialization
│ │ │ │ +000069e0: 2076 6563 746f 722d 466f 6f74 6e6f 7465   vector-Footnote
│ │ │ │ +000069f0: 2d31 7f36 3135 3037 310a 4e6f 6465 3a20  -1.615071.Node: 
│ │ │ │ +00006a00: 5468 6520 4b65 7974 6162 2042 696e 6172  The Keytab Binar
│ │ │ │ +00006a10: 7920 4669 6c65 2046 6f72 6d61 747f 3631  y File Format.61
│ │ │ │ +00006a20: 3532 3337 0a4e 6f64 653a 2054 6865 2043  5237.Node: The C
│ │ │ │ +00006a30: 7265 6465 6e74 6961 6c20 4361 6368 6520  redential Cache 
│ │ │ │ +00006a40: 4269 6e61 7279 2046 696c 6520 466f 726d  Binary File Form
│ │ │ │ +00006a50: 6174 7f36 3230 3038 310a 4e6f 6465 3a20  at.620081.Node: 
│ │ │ │ +00006a60: 436f 7079 696e 6720 496e 666f 726d 6174  Copying Informat
│ │ │ │ +00006a70: 696f 6e7f 3632 3335 3035 0a4e 6f64 653a  ion.623505.Node:
│ │ │ │ +00006a80: 2047 4e55 2046 7265 6520 446f 6375 6d65   GNU Free Docume
│ │ │ │ +00006a90: 6e74 6174 696f 6e20 4c69 6365 6e73 657f  ntation License.
│ │ │ │ +00006aa0: 3632 3337 3637 0a4e 6f64 653a 2046 756e  623767.Node: Fun
│ │ │ │ +00006ab0: 6374 696f 6e20 616e 6420 4461 7461 2049  ction and Data I
│ │ │ │ +00006ac0: 6e64 6578 7f36 3438 3838 350a 4e6f 6465  ndex.648885.Node
│ │ │ │ +00006ad0: 3a20 436f 6e63 6570 7420 496e 6465 787f  : Concept Index.
│ │ │ │ +00006ae0: 3732 3539 3332 0a1f 0a45 6e64 2054 6167  725932...End Tag
│ │ │ │ +00006af0: 2054 6162 6c65 0a0a 1f0a 4c6f 6361 6c20   Table....Local 
│ │ │ │ +00006b00: 5661 7269 6162 6c65 733a 0a63 6f64 696e  Variables:.codin
│ │ │ │ +00006b10: 673a 2075 7466 2d38 0a45 6e64 3a0a       g: utf-8.End:.