The cl-tls Reference Manual

This is the cl-tls Reference Manual, generated automatically by Declt version 4.0 beta 2 "William Riker" on Thu Sep 15 04:14:17 2022 GMT+0.

1 Introduction
2 Systems
- 2.1 cl-tls
3 Modules
4 Files
- 4.1 Lisp
- 4.2 Static
  - 4.2.1 cl-tls/README
  - 4.2.2 cl-tls/LICENSE
5 Packages
- 5.1 cl-tls
6 Definitions
- 6.1 Public Interface
- 6.2 Internals
Appendix A Indexes

1 Introduction

CL-TLS is a prototype Common Lisp implementation of TLS and related protocols and standards including:

RFC5246
ASN.1
x{501,509}
PKCS{1,3,5,8}

TLS is the IETF-standardized successor of Netscape's SSL protocol. Sometimes TLS/SSL are used interchangeably. At this point, there is no intention to support the older versions of the protocols (SSLv3 and below)

The project is currently in its early development phase and should only be used for experimental purposes.

CL-TLS uses Ironclad as its cryptographic back-end (at the time of writing, the ironclad in quicklisp has not yet been updated to the new maintained repo, use sharplispers/ironclad). See the system definition file for other dependencies

The project started as an attempt to create a network-based TLS fuzzer, but soon morphed of its own volition into a full-fledged TLS implementation.

Extensive testing, fuzzing, and code review is needed. Style guidelines, optimizations, feature-completion patches, bug fixes, and other contributions are welcome.

For an overview of known attacks against TLS and other issues relevant to implementors and users, see https://tools.ietf.org/html/rfc7457 At a minimum, CL-TLS will follow the recommendations and considerations in the aforementioned document before a proper alpha release is announced.

I also intend to fully document the internals of CL-TLS.

So far:

You can initiate sessions and exchange data through a TLS tunnel either as a server or a client, for RSA, DSA, and Diffie-Hellman cipher suites. There is no support for ECDSA suites yet.
Certificate path validation works for certificates signed using RSA or DSA. As above, no support for ECDSA signature verification yet.
Support for PEM-encoded certificate chains.
Support for most features of the TLS 1.2 spec such as fragmentation and session renegotiation.

Major TODOs before alpha release:

Finalizing work on hello extensions.
Fuzzing.
Speed/Memory optimizations.

Features that would be nice, but are not essential

Support for initializing with multiple certificates
ECDSA/ECDH/ECDHE support
Session resumption support
Support for post-RFC5246 cipher suites
rfc{4346,2246,6520}
pkcs#{7,12}
DTLS
Tools for the generation and management of public/private keys and certificates
DANE

CL-TLS does not offer gray streams, threading, sockets, event-loop, or compression functionality. This limits the code of CL-TLS to simply opening and managing a TLS tunnel through an octet stream and enhances portability and extensibility. However, libraries that offer this functionality (such as threaded or evented servers), can be built trivially on top of CL-TLS. See https://github.com/shrdlu68/secure-sockets as an example.

Here is an example of a simple text echo server that implements a simple one-thread-per-request model using usocket and bordeaux-threads:

(require :cl-tls)

(ql:quickload :bordeaux-threads)
(ql:quickload :usockets)
(ql:quickload :babel)

(defun echo-server (port &optional (host "localhost"))
  (let ((sock (usocket:socket-listen host port
				     :reuse-address t
				     :element-type '(unsigned-byte 8))))
    (cl-tls:initialize-listener
     :certificate "/path/to/cert.pem"
     :private-key "/path/to/key.pem")
    (loop
      for thread-id upfrom 0
      for new-sock = (usocket:socket-accept sock)
      for session-stream = (usocket:socket-stream new-sock)
      for handler = (multiple-value-bind (reader writer)
			(cl-tls:accept-tunnel :io-stream session-stream)
		      (lambda ()
			(loop
			  with id = thread-id
			  for in = (funcall reader)
			  for line = (and in
					  (babel:octets-to-string in))
			  if line do
			    (format t "~&~:R thread received data: ~A~%"
				    id line)
			    (funcall writer in)
			  else do
			    (format t
				    "~&Peer closed tunnel, ~:R thread exiting~%" id)
			    (return nil))))
      do
	 (bordeaux-threads:make-thread handler))))

And here is an example using client functionality:

(require :cl-tls)
(ql:quickload :babel)

(defun client-test (port &optional (host "localhost"))
  (let* ((sock (usocket:socket-connect
		host port
		:protocol :stream
		:element-type '(unsigned-byte 8))))
    (multiple-value-bind (reader writer close-callback)
	(cl-tls:request-tunnel
	 :certificate "/path/to/cert.pem"
	 :private-key "/path/to/key.pem"
	 :io-stream (usocket:socket-stream sock)
	 :peer-ip-addresses '((127 0 0 1))
	 :ca-certificates "/path/to/CA/ca-cert.pem")
      (loop
	for out = (read-line *standard-input* nil nil)
	for line = (and out
			(babel:string-to-octets out))
	if line do
	  (funcall writer line)
	  (let ((in (funcall reader)))
	    (cond (in
		   (format t "~&Received data: ~A~%"
			   (babel:octets-to-string in)))
		  (t
		   (funcall close-callback)
		   (return nil))))
	else do
	  (format t "~&Closing tunnel...~%")
	  (funcall close-callback)
	  (return nil)))))

Preliminary API documentation:

request-tunnel (&key certificate private-key ca-certificates
	       	     io-stream input-stream output-stream
		     include-ciphers exclude-ciphers
		     peer-dns-name peer-ip-addresses)

		Attempts to request a TLS tunnel from a server
		through an octet stream
		
		:io-stream A duplex octet stream
		
		:input-stream In the case where separate input and output
			      streams are used, an octet input stream
			      
		:output-stream An octet output stream

		:private-key A (DER/PEM-encoded) private key
			     (currently only DSA, RSA and DH private keys are supported)
			     If the private key is encrypted, you will be prompted for
			     the passphrase
			     
		:certificate A file containing a PEM-encoded list of one
			     or more cerificates
			     The file should consist of one or more
			     ----- BEGIN CERTIFICATE -----
			     ----- END CERTIFICATE -----
			     blocks. White space and other information around these blocks
			     is permitted and will be ignored. Support for PKCS#12-encoded
			     certificate chains is not yet implemented.
		:ca-certificates Either: 1. A directory to look for .crt, .pem, and .der
				 	    CA certificates in
					 2. A PEM-encoded file containing CA certificates,
					    encoded as explained above.
				 For servers, these are only needed if the server
				 needs to authenticate clients, i.e the clients are
				 expected to have client certificates issued to them.
				 This is not used very widely in practice.
				 For clients, CA certificates are used to authenticate
				 servers.
				 TLS clients such as browsers typically use a collection
				 of root certificates that are included by some means of
				 vetting, either provided by the operating system or
				 by the creators/maintainers of the browser.
				 You can use the CAs that your OS/browser has vetted,
				 or you can select which CAs to trust by yourself.
				 For example, most GNU/Linux systems have a package that
				 provides vetted root certificates, typically found in
				 the file "/etc/ssl/certs/ca-certificates.crt"
				 See also: https://curl.haxx.se/docs/sslcerts.html
				 
				 If you want to or have issued your own certificates,
				 include your CA certificate here, either in
				 addition to other CA certificates or as the sole
				 CA certificates. The client and server will only
				 be able to validate remote endpoints whose certificates
				 are signed by a CA certificate that is included,
				 there is no way to "accept" unvalidated certificates.

		
		:include-ciphers A list of symbols of cipher suites to add to the
				 default cipher list.
				 The symbols denote one of the cryptographic characteristics
				 of a cipher suite: key exchange, authentication
				 bulk encryption, mac, digest algorithms, prf, and key sizes.
				 Currently supported options:
				 :rsa-ke (RSA key exchange)
				 :rsa-auth (RSA authentication)
				 :dh (static dh) :dhe (ephemeral dh)
				 :dsa :anon (no authentication-vulnerable to MITM attacks!)
				 :rc4 (broken and prohibited) :3des
				 :aes128 :aes256 :cbc (cipher block chaining mode)
				 :md5 :sha1 :sha256
				 
		:exclude-ciphers A list of symbols of cipher suites to exclude
				 from the default cipher list.
				 :anon and :rc4 are already excluded by default
				 
		:peer-dns-name DNS-name of the peer. This is checked against
			       the dns-name values in the subject alternative name extension
			       of the certificate presented by the peer.
			       It is also used in the SNI extension, which is important
			       for virtual servers to determine which server the client
			       wants to contact.
		
		:peer-ip-addresses List of IP addresses of the peer
				   This is checked against the ip-address values
				   in the subject alternative name extension
			       	   of the certificate presented by the peer.

initialize-listener (&key certificate private-key ca-certificates
				include-ciphers exclude-ciphers force-reinitialize
				authenticate-client-p require-authentication-p
				dh-params)
			
		Loads resources needed for a server session and
		sets configuration options
		Servers need to call this once when initializing.
						 
		:authenticate-client-p When true, an attempt to authenticate the client
				       will be made. However, the client may send back an
				       empty certificate if it does not have
				       (an appropriate) certificate. This option defaults
				       to nil
				       
		:require-authentication-p When true, the server will be asked for a
					  certificate, and the connection will
					  fail if the client fails to provide a certificate.
					  This option defaults to nil.

accept-tunnel (&key io-stream input-stream output-stream)
	      => read-callback,write-callback,close-callback

	      Attempts to accept a client's request for a
	      TLS tunnel through an octet stream

		read-callback A closure whose argument list is in the form
			      (&key (eof-error-p nil) (eof-value nil))
			      that returns the contents
			      of one TLS record (2^14 bytes or less).
			      If :eof-error-p is true, the condition cl:end-of-file
			      will be signaled if the TLS tunnel is closed properly
			      (i.e a close_notify alert is received)
			      If :eof-error-p is false, eof-value is returned rather
			      than isgnalling end-of-file.
			      If an error is encountered while attempting to read from
			      the underlying stream (for example is a socket connection
			      is terminated without properly closing the TLS tunnel),
			      the condition cl:stream-error will be signalled.
		write-callback A closure of one argument, an octet vector of arbitrary size,
			       to be sent down the tunnel
			       Attempting to write to a closed TLS tunnel will
			       signal the condition cl:stream-error
			       If an error is encountered while attempting to write to
			       the underlying stream (for example is a socket connection
			       is terminated without properly closing the TLS tunnel),
			       the condition cl:stream-error will be signalled.
		close-callback A closure of no arguments that politely closes the TLS
			       connection by sending a close_notify alert.

(defclass address ()
  ((host :initarg :host
	 :accessor host)
   (port :initarg :port
	 :accessor port)))

request-stream-to-address (address)
		 =>octet stream
	Specialize this generic function and provide socket functionality.
	This is needed by some of the functionality in cl-tls that may need
	to open sockets, such as contacting OCSP responders.
	For example, to if you are using usockets:
	(defmethod cl-tls:request-stream-to-address ((addr cl-tls:address))
	  (usocket:socket-stream (usocket:socket-connect
	  (cl-tls:host addr) (cl-tls:port addr)
	  :protocol :stream
	  :element-type '(unsigned-byte 8))))

This API will likely change as development continues.

2 Systems

The main system appears first, followed by any subsystem dependency.

cl-tls

2.1 `cl-tls`

An implementation of the Transport Layer Security Protocols

Author

Brian Kamotho

License

BSD-3-Clause

Dependencies

babel (system).
ironclad (system).
alexandria (system).
cl-base64 (system).
fast-io (system).

Source

cl-tls.asd.

Child Components

readme (file).
license (file).
src (module).

3 Modules

Modules are listed depth-first from the system components tree.

cl-tls/src
cl-tls/src/ASN.1
cl-tls/src/pkcs
cl-tls/src/x509
cl-tls/src/PEM
cl-tls/src/tls

3.1 `cl-tls/src`

Dependency

license (file).

Source

cl-tls.asd.

Parent Component

cl-tls (system).

Child Components

package.lisp (file).
utils.lisp (file).
asn.1 (module).
pkcs (module).
x509 (module).
pem (module).
tls (module).

3.2 `cl-tls/src/ASN.1`

Source: cl-tls.asd.
Parent Component: src (module).
Child Component: asn.1.lisp (file).

3.3 `cl-tls/src/pkcs`

Source

cl-tls.asd.

Parent Component

src (module).

Child Components

pkcs1.lisp (file).
pkcs3.lisp (file).
pkcs5.lisp (file).
pkcs8.lisp (file).

3.4 `cl-tls/src/x509`

Source

cl-tls.asd.

Parent Component

src (module).

Child Components

extensions.lisp (file).
x509.lisp (file).
ocsp.lisp (file).
validate.lisp (file).

3.5 `cl-tls/src/PEM`

Source: cl-tls.asd.
Parent Component: src (module).
Child Component: rfc7468.lisp (file).

3.6 `cl-tls/src/tls`

Source

cl-tls.asd.

Parent Component

src (module).

Child Components

transport.lisp (file).
http.lisp (file).
ciphersuites.lisp (file).
alert.lisp (file).
crypto.lisp (file).
extensions.lisp (file).
tls.lisp (file).

4 Files

Files are sorted by type and then listed depth-first from the systems components trees.

Lisp
Static

4.1 Lisp

4.1.1 `cl-tls/cl-tls.asd`

Source: cl-tls.asd.
Parent Component: cl-tls (system).
ASDF Systems: cl-tls.

4.1.2 `cl-tls/src/package.lisp`

Source: cl-tls.asd.
Parent Component: src (module).
Packages: cl-tls.

4.1.3 `cl-tls/src/utils.lisp`

Source

cl-tls.asd.

Parent Component

src (module).

Internals

asn-type-matches-p (function).
bytes-in-int (function).
cat-vectors (function).
dns-match-p (function).
dump-to-file (function).
find-certificates (function).
get-contents (function).
get-random-octets (function).
get-sequence (function).
gmt-unix-time (function).
integer-to-octets (function).
make-octet-vector (function).
octet (type).
octet-vector (type).
octets-to-integer (function).
split-string (function).
stream-octets-to-integer (function).
timing-independent-compare (function).
with-specification-map (macro).

4.1.4 `cl-tls/src/ASN.1/asn.1.lisp`

Source

cl-tls.asd.

Parent Component

asn.1 (module).

Public Interface

asn-sequence-to-list (function).
asn-serialize (function).
create-asn-sequence (function).
encode-oid (function).
parse-der (function).

Internals

*max-int-len* (special variable).
+asn1_application+ (constant).
+asn1_constructed+ (constant).
+asn1_context_specific+ (constant).
+asn1_primitive+ (constant).
+asn1_private+ (constant).
+asn1_universal+ (constant).
asn-sequence-to-indices (function).
asn.1-decoding-error (condition).
create-explicit-tag (function).
decode-oid (function).
from-stream-parse-der (function).
get-der-contents-indices (function).
integer-to-vlq (function).
make-octet-stream (function).
octet-stream (class).
ov-buffer-position (function).
ov-read-byte (generic function).
ov-read-sequence (generic function).
text (reader method).

4.1.5 `cl-tls/src/pkcs/pkcs1.lisp`

Source

cl-tls.asd.

Parent Component

pkcs (module).

Public Interface

rsa-decrypt (function).
rsa-encrypt (function).
rsassa-pkcs1.5-sign (function).
rsassa-pkcs1.5-verify (function).

Internals

emsa-pkcs1-v1.5-encode (function).
fill-random-nonzero-octets (function).

4.1.6 `cl-tls/src/pkcs/pkcs3.lisp`

Source

cl-tls.asd.

Parent Component

pkcs (module).

Internals

compute-shared-secret (function).
dh-params (class).
generate-dh-params (function).
generator (reader method).
make-dh-key-pair (function).
prime-modulus (reader method).
strong-random-range (function).

4.1.7 `cl-tls/src/pkcs/pkcs5.lisp`

Source

cl-tls.asd.

Parent Component

pkcs (module).

Public Interface

pbes2-decrypt (function).

Internals

parse-enc-scheme (function).
parse-kdf (function).
remove-padding (function).

4.1.8 `cl-tls/src/pkcs/pkcs8.lisp`

Source

cl-tls.asd.

Parent Component

pkcs (module).

Internals

load-der-priv-key (function).
load-pem-priv-key (function).
load-priv-key (function).
parse-priv-key (function).

4.1.9 `cl-tls/src/x509/extensions.lisp`

Source

cl-tls.asd.

Parent Component

x509 (module).

Internals

parse-access-description (function).
parse-general-name (function).
parse-general-names (function).
parse-qualifier (function).
process-extension (generic function).

4.1.10 `cl-tls/src/x509/x509.lisp`

Dependency

extensions.lisp (file).

Source

cl-tls.asd.

Parent Component

x509 (module).

Public Interface

print-object (method).
x509-decode (function).

Internals

+md2withrsaencryption+ (constant).
+md5withrsaencryption+ (constant).
+sha1withrsaencryption+ (constant).
+sha224withrsaencryption+ (constant).
+sha256withrsaencryption+ (constant).
+sha384withrsaencryption+ (constant).
+sha512withrsaencryption+ (constant).
asn-time-to-universal-time (function).
authority-information-access (reader method).
(setf authority-information-access) (writer method).
authority-key-identifier (reader method).
(setf authority-key-identifier) (writer method).
basic-constraints (reader method).
(setf basic-constraints) (writer method).
bind-tbs (macro).
certificate-policies (reader method).
(setf certificate-policies) (writer method).
crl-distribution-points (reader method).
(setf crl-distribution-points) (writer method).
extended-key-usage (reader method).
(setf extended-key-usage) (writer method).
extensions (reader method).
(setf extensions) (writer method).
get-raw-tbs (function).
hash (reader method).
(setf hash) (writer method).
issuer (reader method).
(setf issuer) (writer method).
issuer-alternative-name (reader method).
(setf issuer-alternative-name) (writer method).
issuer-unique-id (reader method).
(setf issuer-unique-id) (writer method).
key-usage (reader method).
(setf key-usage) (writer method).
parse-directory-name (function).
parse-pka (function).
parse-pub-key (function).
parse-signature-algorithm (function).
parse-tbs-certificate (function).
policy-mappings (reader method).
(setf policy-mappings) (writer method).
process-extensions (function).
raw (reader method).
(setf raw) (writer method).
serial (reader method).
(setf serial) (writer method).
signature (reader method).
signature (reader method).
(setf signature) (writer method).
(setf signature) (writer method).
signature-algorithm (reader method).
(setf signature-algorithm) (writer method).
subject (reader method).
(setf subject) (writer method).
subject-alternative-name (reader method).
(setf subject-alternative-name) (writer method).
subject-information-access (reader method).
(setf subject-information-access) (writer method).
subject-key-identifier (reader method).
(setf subject-key-identifier) (writer method).
subject-pki (reader method).
(setf subject-pki) (writer method).
subject-unique-id (reader method).
(setf subject-unique-id) (writer method).
tbs-certificate (reader method).
(setf tbs-certificate) (writer method).
tbs-certificate (class).
text (reader method).
time-valid-p (function).
validity (reader method).
(setf validity) (writer method).
verify-signature (function).
version (reader method).
(setf version) (writer method).
x509-decoding-error (condition).
x509-extension (class).
x509v3-certificate (class).

4.1.11 `cl-tls/src/x509/ocsp.lisp`

Dependency

x509.lisp (file).

Source

cl-tls.asd.

Parent Component

x509 (module).

Internals

*id-ad-ocsp* (special variable).
check-ocsp (function).
create-cert-id (function).
create-request (function).
create-tbs-request (function).
log-info (reader method).
(setf log-info) (writer method).
ocsp-catch-asn-error (macro).
ocsp-error (condition).
parse-response-data (function).
prepare-ocsp-request (function).
verify-ocsp-signature (function).

4.1.12 `cl-tls/src/x509/validate.lisp`

Dependency

ocsp.lisp (file).

Source

cl-tls.asd.

Parent Component

x509 (module).

Internals

check-certificate-status (function).
get-issuer-octets (function).
get-pubkey-octets (function).
validate (function).

4.1.13 `cl-tls/src/PEM/rfc7468.lisp`

Source

cl-tls.asd.

Parent Component

pem (module).

Internals

decapsulate (function).
parse-pem (function).

4.1.14 `cl-tls/src/tls/transport.lisp`

Source

cl-tls.asd.

Parent Component

tls (module).

Public Interface

address (class).
host (reader method).
(setf host) (writer method).
port (reader method).
(setf port) (writer method).
request-stream-to-address (generic function).

4.1.15 `cl-tls/src/tls/http.lisp`

Source

cl-tls.asd.

Parent Component

tls (module).

Public Interface

host (reader method).
(setf host) (writer method).
port (reader method).
(setf port) (writer method).

Internals

*crlf* (special variable).
*max-content-length* (special variable).
header-value (function).
http-error (condition).
http-request (function).
log-info (reader method).
(setf log-info) (writer method).
parse-headers-from-stream (function).
parse-uri (function).
path (reader method).
(setf path) (writer method).
read-chunk (function).
read-chunked-response (function).
read-header (function).
scheme (reader method).
(setf scheme) (writer method).
split-header (function).
trim-space (function).
uri (class).

4.1.16 `cl-tls/src/tls/ciphersuites.lisp`

Source

cl-tls.asd.

Parent Component

tls (module).

Internals

*supported-cipher-suites* (special variable).
+3des-block-size+ (special variable).
+3des-encryption-suites+ (special variable).
+aes-128-ciphers+ (special variable).
+aes-256-ciphers+ (special variable).
+aes-block-size+ (special variable).
+aes-encryption-suites+ (special variable).
+anon-authentication-suites+ (special variable).
+cbc-mode-ciphers+ (special variable).
+dh-key-exchange-suites+ (special variable).
+dhe-key-exchange-suites+ (special variable).
+dss-authentication-suites+ (special variable).
+md5-ciphers+ (special variable).
+rc4-encryption-suites+ (special variable).
+rsa-authentication-suites+ (special variable).
+rsa-key-exchange-suites+ (special variable).
+sha1-ciphers+ (special variable).
+sha256-ciphers+ (special variable).
+tls_dh_anon_with_3des_ede_cbc_sha+ (special variable).
+tls_dh_anon_with_aes_128_cbc_sha+ (special variable).
+tls_dh_anon_with_aes_128_cbc_sha256+ (special variable).
+tls_dh_anon_with_aes_256_cbc_sha+ (special variable).
+tls_dh_anon_with_aes_256_cbc_sha256+ (special variable).
+tls_dh_anon_with_rc4_128_md5+ (special variable).
+tls_dh_dss_with_3des_ede_cbc_sha+ (special variable).
+tls_dh_dss_with_aes_128_cbc_sha+ (special variable).
+tls_dh_dss_with_aes_128_cbc_sha256+ (special variable).
+tls_dh_dss_with_aes_256_cbc_sha+ (special variable).
+tls_dh_dss_with_aes_256_cbc_sha256+ (special variable).
+tls_dh_rsa_with_3des_ede_cbc_sha+ (special variable).
+tls_dh_rsa_with_aes_128_cbc_sha+ (special variable).
+tls_dh_rsa_with_aes_128_cbc_sha256+ (special variable).
+tls_dh_rsa_with_aes_256_cbc_sha+ (special variable).
+tls_dh_rsa_with_aes_256_cbc_sha256+ (special variable).
+tls_dhe_dss_with_3des_ede_cbc_sha+ (special variable).
+tls_dhe_dss_with_aes_128_cbc_sha+ (special variable).
+tls_dhe_dss_with_aes_128_cbc_sha256+ (special variable).
+tls_dhe_dss_with_aes_256_cbc_sha+ (special variable).
+tls_dhe_dss_with_aes_256_cbc_sha256+ (special variable).
+tls_dhe_rsa_with_3des_ede_cbc_sha+ (special variable).
+tls_dhe_rsa_with_aes_128_cbc_sha+ (special variable).
+tls_dhe_rsa_with_aes_128_cbc_sha256+ (special variable).
+tls_dhe_rsa_with_aes_256_cbc_sha+ (special variable).
+tls_dhe_rsa_with_aes_256_cbc_sha256+ (special variable).
+tls_rsa_with_3des_ede_cbc_sha+ (special variable).
+tls_rsa_with_aes_128_cbc_sha+ (special variable).
+tls_rsa_with_aes_128_cbc_sha256+ (special variable).
+tls_rsa_with_aes_256_cbc_sha+ (special variable).
+tls_rsa_with_aes_256_cbc_sha256+ (special variable).
+tls_rsa_with_null_md5+ (special variable).
+tls_rsa_with_null_sha+ (special variable).
+tls_rsa_with_null_sha256+ (special variable).
+tls_rsa_with_rc4_128_md5+ (special variable).
+tls_rsa_with_rc4_128_sha+ (special variable).

4.1.17 `cl-tls/src/tls/alert.lisp`

Source

cl-tls.asd.

Parent Component

tls (module).

Internals

+access-denied+ (constant).
+bad-certificate+ (constant).
+bad-record-mac+ (constant).
+certificate-expired+ (constant).
+certificate-revoked+ (constant).
+certificate-unknown+ (constant).
+close-notify+ (constant).
+decode-error+ (constant).
+decompression-failure+ (constant).
+decrypt-error+ (constant).
+decryption-failed-reserved+ (constant).
+export-restriction-reserved+ (constant).
+fatal+ (constant).
+handshake-failure+ (constant).
+illegal-parameter+ (constant).
+insufficient-security+ (constant).
+internal-error+ (constant).
+no-certificate-reserved+ (constant).
+no-renegotiation+ (constant).
+protocol-version+ (constant).
+record-overflow+ (constant).
+unexpected-message+ (constant).
+unknown-ca+ (constant).
+unsupported-certificate+ (constant).
+unsupported-extension+ (constant).
+user-canceled+ (constant).
+warning+ (constant).
alert-record-to-text (function).
send-alert (function).

4.1.18 `cl-tls/src/tls/crypto.lisp`

Source

cl-tls.asd.

Parent Component

tls (module).

Internals

digitally-sign (function).
endpoint-decryption-key (symbol macro).
endpoint-encryption-key (symbol macro).
gen-key-material (function).
p-hash (function).
prf (function).
sign-dh-params (function).
verify-signed-data (function).
verify-signed-params (function).

4.1.19 `cl-tls/src/tls/extensions.lisp`

Source

cl-tls.asd.

Parent Component

tls (module).

Internals

create-cert-status-request (function).
create-sni (function).
pack-extension (function).
parse-extension (generic function).

4.1.20 `cl-tls/src/tls/tls.lisp`

Source

cl-tls.asd.

Parent Component

tls (module).

Public Interface

accept-tunnel (function).
initialize-listener (function).
request-tunnel (function).
tls-error (condition).
tls-stream-error (condition).

Internals

*certificate-request-msg* (special variable).
*debug-stream* (special variable).
*log-level* (special variable).
*max-certificate-chain-length* (special variable).
*max-fragment-length* (special variable).
*version* (special variable).
+alert+ (constant).
+application-data+ (constant).
+certificate+ (constant).
+certificate-request+ (constant).
+certificate-verify+ (constant).
+change-cipher-spec+ (constant).
+client-hello+ (constant).
+client-key-exchange+ (constant).
+finished+ (constant).
+handshake+ (constant).
+hello-request+ (constant).
+server-hello+ (constant).
+server-hello-done+ (constant).
+server-key-exchange+ (constant).
add-handshake-header (function).
alert (reader method).
(setf alert) (writer method).
calculate-mac (function).
calculate-verification-mac (function).
cipher-suite-supported-p (function).
ciphertext-to-compressed (generic function).
client-certificate-url (reader method).
(setf client-certificate-url) (writer method).
client-session (class).
create-cipher-vector (function).
create-listener-session (function).
create-session (function).
decrypt (generic function).
dhparams-from-key-file (function).
encrypt (generic function).
encrypt-and-send (function).
endpoint-mac-decryption-key (symbol macro).
endpoint-mac-encryption-key (symbol macro).
exception (condition).
get-application-data (function).
get-ca-certificates (function).
get-change-cipher-spec (function).
get-dh-params (function).
get-handshake-message (function).
get-private-key (function).
get-record (generic function).
get-session-id (function).
handle-handshake (generic function).
handshake-messages (reader method).
(setf handshake-messages) (writer method).
hello-extensions (class).
host-name (reader method).
(setf host-name) (writer method).
initiate-connection (generic function).
log-info (reader method).
(setf log-info) (writer method).
max-fragment-length (reader method).
(setf max-fragment-length) (writer method).
parse-cipher-suite (function).
pre-master-secret (reader method).
(setf pre-master-secret) (writer method).
pub-key (reader method).
(setf pub-key) (writer method).
reassemble-handshake-message (function).
send (generic function).
send-change-cipher-spec (generic function).
send-handshake (generic function).
send-record (generic function).
server-session (class).
session (class).
shared-session-slots (class).
supported-signature-algorithms (reader method).
(setf supported-signature-algorithms) (writer method).
symbol-to-suite-list (function).
text (reader method).
(setf text) (writer method).

4.2.1 `cl-tls/README`

Source: cl-tls.asd.
Parent Component: cl-tls (system).

4.2.2 `cl-tls/LICENSE`

Dependency: readme (file).
Source: cl-tls.asd.
Parent Component: cl-tls (system).

5 Packages

Packages are listed by definition order.

cl-tls

5.1 `cl-tls`

CL-TLS is a Common Lisp implemetation of TLS and related specifications

Source

package.lisp.

Nickname

tls

Use List

alexandria.
common-lisp.

Public Interface

accept-tunnel (function).
address (class).
asn-sequence-to-list (function).
asn-serialize (function).
create-asn-sequence (function).
encode-oid (function).
host (generic reader).
(setf host) (generic writer).
initialize-listener (function).
parse-der (function).
pbes2-decrypt (function).
port (generic reader).
(setf port) (generic writer).
request-stream-to-address (generic function).
request-tunnel (function).
rsa-decrypt (function).
rsa-encrypt (function).
rsassa-pkcs1.5-sign (function).
rsassa-pkcs1.5-verify (function).
tls-error (condition).
tls-stream-error (condition).
x509-decode (function).

Internals

*certificate-request-msg* (special variable).
*crlf* (special variable).
*debug-stream* (special variable).
*id-ad-ocsp* (special variable).
*log-level* (special variable).
*max-certificate-chain-length* (special variable).
*max-content-length* (special variable).
*max-fragment-length* (special variable).
*max-int-len* (special variable).
*supported-cipher-suites* (special variable).
*version* (special variable).
+3des-block-size+ (special variable).
+3des-encryption-suites+ (special variable).
+access-denied+ (constant).
+aes-128-ciphers+ (special variable).
+aes-256-ciphers+ (special variable).
+aes-block-size+ (special variable).
+aes-encryption-suites+ (special variable).
+alert+ (constant).
+anon-authentication-suites+ (special variable).
+application-data+ (constant).
+asn1_application+ (constant).
+asn1_constructed+ (constant).
+asn1_context_specific+ (constant).
+asn1_primitive+ (constant).
+asn1_private+ (constant).
+asn1_universal+ (constant).
+bad-certificate+ (constant).
+bad-record-mac+ (constant).
+cbc-mode-ciphers+ (special variable).
+certificate+ (constant).
+certificate-expired+ (constant).
+certificate-request+ (constant).
+certificate-revoked+ (constant).
+certificate-unknown+ (constant).
+certificate-verify+ (constant).
+change-cipher-spec+ (constant).
+client-hello+ (constant).
+client-key-exchange+ (constant).
+close-notify+ (constant).
+decode-error+ (constant).
+decompression-failure+ (constant).
+decrypt-error+ (constant).
+decryption-failed-reserved+ (constant).
+dh-key-exchange-suites+ (special variable).
+dhe-key-exchange-suites+ (special variable).
+dss-authentication-suites+ (special variable).
+export-restriction-reserved+ (constant).
+fatal+ (constant).
+finished+ (constant).
+handshake+ (constant).
+handshake-failure+ (constant).
+hello-request+ (constant).
+illegal-parameter+ (constant).
+insufficient-security+ (constant).
+internal-error+ (constant).
+md2withrsaencryption+ (constant).
+md5-ciphers+ (special variable).
+md5withrsaencryption+ (constant).
+no-certificate-reserved+ (constant).
+no-renegotiation+ (constant).
+protocol-version+ (constant).
+rc4-encryption-suites+ (special variable).
+record-overflow+ (constant).
+rsa-authentication-suites+ (special variable).
+rsa-key-exchange-suites+ (special variable).
+server-hello+ (constant).
+server-hello-done+ (constant).
+server-key-exchange+ (constant).
+sha1-ciphers+ (special variable).
+sha1withrsaencryption+ (constant).
+sha224withrsaencryption+ (constant).
+sha256-ciphers+ (special variable).
+sha256withrsaencryption+ (constant).
+sha384withrsaencryption+ (constant).
+sha512withrsaencryption+ (constant).
+tls_dh_anon_with_3des_ede_cbc_sha+ (special variable).
+tls_dh_anon_with_aes_128_cbc_sha+ (special variable).
+tls_dh_anon_with_aes_128_cbc_sha256+ (special variable).
+tls_dh_anon_with_aes_256_cbc_sha+ (special variable).
+tls_dh_anon_with_aes_256_cbc_sha256+ (special variable).
+tls_dh_anon_with_rc4_128_md5+ (special variable).
+tls_dh_dss_with_3des_ede_cbc_sha+ (special variable).
+tls_dh_dss_with_aes_128_cbc_sha+ (special variable).
+tls_dh_dss_with_aes_128_cbc_sha256+ (special variable).
+tls_dh_dss_with_aes_256_cbc_sha+ (special variable).
+tls_dh_dss_with_aes_256_cbc_sha256+ (special variable).
+tls_dh_rsa_with_3des_ede_cbc_sha+ (special variable).
+tls_dh_rsa_with_aes_128_cbc_sha+ (special variable).
+tls_dh_rsa_with_aes_128_cbc_sha256+ (special variable).
+tls_dh_rsa_with_aes_256_cbc_sha+ (special variable).
+tls_dh_rsa_with_aes_256_cbc_sha256+ (special variable).
+tls_dhe_dss_with_3des_ede_cbc_sha+ (special variable).
+tls_dhe_dss_with_aes_128_cbc_sha+ (special variable).
+tls_dhe_dss_with_aes_128_cbc_sha256+ (special variable).
+tls_dhe_dss_with_aes_256_cbc_sha+ (special variable).
+tls_dhe_dss_with_aes_256_cbc_sha256+ (special variable).
+tls_dhe_rsa_with_3des_ede_cbc_sha+ (special variable).
+tls_dhe_rsa_with_aes_128_cbc_sha+ (special variable).
+tls_dhe_rsa_with_aes_128_cbc_sha256+ (special variable).
+tls_dhe_rsa_with_aes_256_cbc_sha+ (special variable).
+tls_dhe_rsa_with_aes_256_cbc_sha256+ (special variable).
+tls_rsa_with_3des_ede_cbc_sha+ (special variable).
+tls_rsa_with_aes_128_cbc_sha+ (special variable).
+tls_rsa_with_aes_128_cbc_sha256+ (special variable).
+tls_rsa_with_aes_256_cbc_sha+ (special variable).
+tls_rsa_with_aes_256_cbc_sha256+ (special variable).
+tls_rsa_with_null_md5+ (special variable).
+tls_rsa_with_null_sha+ (special variable).
+tls_rsa_with_null_sha256+ (special variable).
+tls_rsa_with_rc4_128_md5+ (special variable).
+tls_rsa_with_rc4_128_sha+ (special variable).
+unexpected-message+ (constant).
+unknown-ca+ (constant).
+unsupported-certificate+ (constant).
+unsupported-extension+ (constant).
+user-canceled+ (constant).
+warning+ (constant).
add-handshake-header (function).
alert (generic reader).
(setf alert) (generic writer).
alert-record-to-text (function).
asn-sequence-to-indices (function).
asn-time-to-universal-time (function).
asn-type-matches-p (function).
asn.1-decoding-error (condition).
authority-information-access (generic reader).
(setf authority-information-access) (generic writer).
authority-key-identifier (generic reader).
(setf authority-key-identifier) (generic writer).
basic-constraints (generic reader).
(setf basic-constraints) (generic writer).
bind-tbs (macro).
bytes-in-int (function).
calculate-mac (function).
calculate-verification-mac (function).
cat-vectors (function).
certificate-policies (generic reader).
(setf certificate-policies) (generic writer).
check-certificate-status (function).
check-ocsp (function).
cipher-suite-supported-p (function).
ciphertext-to-compressed (generic function).
client-certificate-url (generic reader).
(setf client-certificate-url) (generic writer).
client-session (class).
compute-shared-secret (function).
create-cert-id (function).
create-cert-status-request (function).
create-cipher-vector (function).
create-explicit-tag (function).
create-listener-session (function).
create-request (function).
create-session (function).
create-sni (function).
create-tbs-request (function).
crl-distribution-points (generic reader).
(setf crl-distribution-points) (generic writer).
decapsulate (function).
decode-oid (function).
decrypt (generic function).
dh-params (class).
dhparams-from-key-file (function).
digitally-sign (function).
dns-match-p (function).
dump-to-file (function).
emsa-pkcs1-v1.5-encode (function).
encrypt (generic function).
encrypt-and-send (function).
endpoint-decryption-key (symbol macro).
endpoint-encryption-key (symbol macro).
endpoint-mac-decryption-key (symbol macro).
endpoint-mac-encryption-key (symbol macro).
exception (condition).
extended-key-usage (generic reader).
(setf extended-key-usage) (generic writer).
extensions (generic reader).
(setf extensions) (generic writer).
fill-random-nonzero-octets (function).
find-certificates (function).
from-stream-parse-der (function).
gen-key-material (function).
generate-dh-params (function).
generator (generic reader).
get-application-data (function).
get-ca-certificates (function).
get-change-cipher-spec (function).
get-contents (function).
get-der-contents-indices (function).
get-dh-params (function).
get-handshake-message (function).
get-issuer-octets (function).
get-private-key (function).
get-pubkey-octets (function).
get-random-octets (function).
get-raw-tbs (function).
get-record (generic function).
get-sequence (function).
get-session-id (function).
gmt-unix-time (function).
handle-handshake (generic function).
handshake-messages (generic reader).
(setf handshake-messages) (generic writer).
hash (generic reader).
(setf hash) (generic writer).
header-value (function).
hello-extensions (class).
host-name (generic reader).
(setf host-name) (generic writer).
http-error (condition).
http-request (function).
initiate-connection (generic function).
integer-to-octets (function).
integer-to-vlq (function).
issuer (generic reader).
(setf issuer) (generic writer).
issuer-alternative-name (generic reader).
(setf issuer-alternative-name) (generic writer).
issuer-unique-id (generic reader).
(setf issuer-unique-id) (generic writer).
key-usage (generic reader).
(setf key-usage) (generic writer).
load-der-priv-key (function).
load-pem-priv-key (function).
load-priv-key (function).
log-info (generic reader).
(setf log-info) (generic writer).
make-dh-key-pair (function).
make-octet-stream (function).
make-octet-vector (function).
max-fragment-length (generic reader).
(setf max-fragment-length) (generic writer).
ocsp-catch-asn-error (macro).
ocsp-error (condition).
octet (type).
octet-stream (class).
octet-vector (type).
octets-to-integer (function).
ov-buffer-position (function).
ov-read-byte (generic function).
ov-read-sequence (generic function).
p-hash (function).
pack-extension (function).
parse-access-description (function).
parse-cipher-suite (function).
parse-directory-name (function).
parse-enc-scheme (function).
parse-extension (generic function).
parse-general-name (function).
parse-general-names (function).
parse-headers-from-stream (function).
parse-kdf (function).
parse-pem (function).
parse-pka (function).
parse-priv-key (function).
parse-pub-key (function).
parse-qualifier (function).
parse-response-data (function).
parse-signature-algorithm (function).
parse-tbs-certificate (function).
parse-uri (function).
path (generic reader).
(setf path) (generic writer).
policy-mappings (generic reader).
(setf policy-mappings) (generic writer).
pre-master-secret (generic reader).
(setf pre-master-secret) (generic writer).
prepare-ocsp-request (function).
prf (function).
prime-modulus (generic reader).
process-extension (generic function).
process-extensions (function).
pub-key (generic reader).
(setf pub-key) (generic writer).
raw (generic reader).
(setf raw) (generic writer).
read-chunk (function).
read-chunked-response (function).
read-header (function).
reassemble-handshake-message (function).
remove-padding (function).
scheme (generic reader).
(setf scheme) (generic writer).
send (generic function).
send-alert (function).
send-change-cipher-spec (generic function).
send-handshake (generic function).
send-record (generic function).
serial (generic reader).
(setf serial) (generic writer).
server-session (class).
session (class).
shared-session-slots (class).
sign-dh-params (function).
signature (generic reader).
(setf signature) (generic writer).
signature-algorithm (generic reader).
(setf signature-algorithm) (generic writer).
split-header (function).
split-string (function).
stream-octets-to-integer (function).
strong-random-range (function).
subject (generic reader).
(setf subject) (generic writer).
subject-alternative-name (generic reader).
(setf subject-alternative-name) (generic writer).
subject-information-access (generic reader).
(setf subject-information-access) (generic writer).
subject-key-identifier (generic reader).
(setf subject-key-identifier) (generic writer).
subject-pki (generic reader).
(setf subject-pki) (generic writer).
subject-unique-id (generic reader).
(setf subject-unique-id) (generic writer).
supported-signature-algorithms (generic reader).
(setf supported-signature-algorithms) (generic writer).
symbol-to-suite-list (function).
tbs-certificate (generic reader).
(setf tbs-certificate) (generic writer).
tbs-certificate (class).
text (generic reader).
(setf text) (generic writer).
time-valid-p (function).
timing-independent-compare (function).
trim-space (function).
uri (class).
validate (function).
validity (generic reader).
(setf validity) (generic writer).
verify-ocsp-signature (function).
verify-signature (function).
verify-signed-data (function).
verify-signed-params (function).
version (generic reader).
(setf version) (generic writer).
with-specification-map (macro).
x509-decoding-error (condition).
x509-extension (class).
x509v3-certificate (class).

6 Definitions

Definitions are sorted by export status, category, package, and then by lexicographic order.

Public Interface
Internals

6.1 Public Interface

Ordinary functions
Generic functions
Standalone methods
Conditions
Classes

6.1.1 Ordinary functions

Function: accept-tunnel (&key io-stream input-stream output-stream) ¶

As a server, accept a new connection from a client

Package: cl-tls.
Source: tls.lisp.

Function: asn-sequence-to-list (vec &key mode) ¶

Given an asn sequence, return a list of the raw der elements

Package: cl-tls.
Source: asn.1.lisp.

Function: asn-serialize (obj type &key class primitivep) ¶

Create an ASN structure

Package: cl-tls.
Source: asn.1.lisp.

Function: create-asn-sequence (&rest coll) ¶

Package: cl-tls.
Source: asn.1.lisp.

Function: encode-oid (nums) ¶

Package: cl-tls.
Source: asn.1.lisp.

Function: initialize-listener (&key certificate private-key ca-certificates include-ciphers exclude-ciphers force-reinitialize authenticate-client-p require-authentication-p dh-params) ¶

Initialize a TLS server session with the given arguments

Package: cl-tls.
Source: tls.lisp.

Function: parse-der (obj &key start mode) ¶

Serialized mode returns the plain contents octets. deserialized mode deserializes the contents octets. Octet strings and Bit Strings are not deserialized

Package: cl-tls.
Source: asn.1.lisp.

Function: pbes2-decrypt (ov &optional passphrase) ¶

Package: cl-tls.
Source: pkcs5.lisp.

Function: request-tunnel (&key certificate private-key ca-certificates io-stream input-stream output-stream include-ciphers exclude-ciphers peer-dns-name peer-ip-addresses) ¶

As a client, request a TLS connection from a server

Package: cl-tls.
Source: tls.lisp.

Function: rsa-decrypt (data private-key) ¶

Returns raw data after decrypting and parsing the Encryption-block

Package: cl-tls.
Source: pkcs1.lisp.

Function: rsa-encrypt (data key) ¶

Converts data into an encryption block then calls ironclad

Package: cl-tls.
Source: pkcs1.lisp.

Function: rsassa-pkcs1.5-sign (priv-key msg hash-algorithm) ¶

Package: cl-tls.
Source: pkcs1.lisp.

Function: rsassa-pkcs1.5-verify (pub-key msg signature hash-algorithm) ¶

Package: cl-tls.
Source: pkcs1.lisp.

Function: x509-decode (octet-vector) ¶

Deserialize an x509 certificate from an octet-vector

Package: cl-tls.
Source: x509.lisp.

6.1.2 Generic functions

Generic Reader: host (object) ¶

Package

	Index Entry	Section

A
	`address`:	Public classes
	`alert.lisp`:	The cl-tls/src/tls/alert․lisp file
	`asn.1`:	The cl-tls/src/asn․1 module
	`asn.1-decoding-error`:	Private conditions
	`asn.1.lisp`:	The cl-tls/src/asn․1/asn․1․lisp file

C
	`ciphersuites.lisp`:	The cl-tls/src/tls/ciphersuites․lisp file
	`cl-tls`:	The cl-tls system
	`cl-tls`:	The cl-tls package
	`cl-tls.asd`:	The cl-tls/cl-tls․asd file
	`Class, address`:	Public classes
	`Class, client-session`:	Private classes
	`Class, dh-params`:	Private classes
	`Class, hello-extensions`:	Private classes
	`Class, octet-stream`:	Private classes
	`Class, server-session`:	Private classes
	`Class, session`:	Private classes
	`Class, shared-session-slots`:	Private classes
	`Class, tbs-certificate`:	Private classes
	`Class, uri`:	Private classes
	`Class, x509-extension`:	Private classes
	`Class, x509v3-certificate`:	Private classes
	`client-session`:	Private classes
	`Condition, asn.1-decoding-error`:	Private conditions
	`Condition, exception`:	Private conditions
	`Condition, http-error`:	Private conditions
	`Condition, ocsp-error`:	Private conditions
	`Condition, tls-error`:	Public conditions
	`Condition, tls-stream-error`:	Public conditions
	`Condition, x509-decoding-error`:	Private conditions
	`crypto.lisp`:	The cl-tls/src/tls/crypto․lisp file

D
	`dh-params`:	Private classes

E
	`exception`:	Private conditions
	`extensions.lisp`:	The cl-tls/src/x509/extensions․lisp file
	`extensions.lisp`:	The cl-tls/src/tls/extensions․lisp file

F
	`File, alert.lisp`:	The cl-tls/src/tls/alert․lisp file
	`File, asn.1.lisp`:	The cl-tls/src/asn․1/asn․1․lisp file
	`File, ciphersuites.lisp`:	The cl-tls/src/tls/ciphersuites․lisp file
	`File, cl-tls.asd`:	The cl-tls/cl-tls․asd file
	`File, crypto.lisp`:	The cl-tls/src/tls/crypto․lisp file
	`File, extensions.lisp`:	The cl-tls/src/x509/extensions․lisp file
	`File, extensions.lisp`:	The cl-tls/src/tls/extensions․lisp file
	`File, http.lisp`:	The cl-tls/src/tls/http․lisp file
	`File, license`:	The cl-tls/license file
	`File, ocsp.lisp`:	The cl-tls/src/x509/ocsp․lisp file
	`File, package.lisp`:	The cl-tls/src/package․lisp file
	`File, pkcs1.lisp`:	The cl-tls/src/pkcs/pkcs1․lisp file
	`File, pkcs3.lisp`:	The cl-tls/src/pkcs/pkcs3․lisp file
	`File, pkcs5.lisp`:	The cl-tls/src/pkcs/pkcs5․lisp file
	`File, pkcs8.lisp`:	The cl-tls/src/pkcs/pkcs8․lisp file
	`File, readme`:	The cl-tls/readme file
	`File, rfc7468.lisp`:	The cl-tls/src/pem/rfc7468․lisp file
	`File, tls.lisp`:	The cl-tls/src/tls/tls․lisp file
	`File, transport.lisp`:	The cl-tls/src/tls/transport․lisp file
	`File, utils.lisp`:	The cl-tls/src/utils․lisp file
	`File, validate.lisp`:	The cl-tls/src/x509/validate․lisp file
	`File, x509.lisp`:	The cl-tls/src/x509/x509․lisp file

H
	`hello-extensions`:	Private classes
	`http-error`:	Private conditions
	`http.lisp`:	The cl-tls/src/tls/http․lisp file

L
	`license`:	The cl-tls/license file

M
	`Module, asn.1`:	The cl-tls/src/asn․1 module
	`Module, pem`:	The cl-tls/src/pem module
	`Module, pkcs`:	The cl-tls/src/pkcs module
	`Module, src`:	The cl-tls/src module
	`Module, tls`:	The cl-tls/src/tls module
	`Module, x509`:	The cl-tls/src/x509 module

O
	`ocsp-error`:	Private conditions
	`ocsp.lisp`:	The cl-tls/src/x509/ocsp․lisp file
	`octet`:	Private types
	`octet-stream`:	Private classes
	`octet-vector`:	Private types

P
	`Package, cl-tls`:	The cl-tls package
	`package.lisp`:	The cl-tls/src/package․lisp file
	`pem`:	The cl-tls/src/pem module
	`pkcs`:	The cl-tls/src/pkcs module
	`pkcs1.lisp`:	The cl-tls/src/pkcs/pkcs1․lisp file
	`pkcs3.lisp`:	The cl-tls/src/pkcs/pkcs3․lisp file
	`pkcs5.lisp`:	The cl-tls/src/pkcs/pkcs5․lisp file
	`pkcs8.lisp`:	The cl-tls/src/pkcs/pkcs8․lisp file

R
	`readme`:	The cl-tls/readme file
	`rfc7468.lisp`:	The cl-tls/src/pem/rfc7468․lisp file

S
	`server-session`:	Private classes
	`session`:	Private classes
	`shared-session-slots`:	Private classes
	`src`:	The cl-tls/src module
	`System, cl-tls`:	The cl-tls system

T
	`tbs-certificate`:	Private classes
	`tls`:	The cl-tls/src/tls module
	`tls-error`:	Public conditions
	`tls-stream-error`:	Public conditions
	`tls.lisp`:	The cl-tls/src/tls/tls․lisp file
	`transport.lisp`:	The cl-tls/src/tls/transport․lisp file
	`Type, octet`:	Private types
	`Type, octet-vector`:	Private types

U
	`uri`:	Private classes
	`utils.lisp`:	The cl-tls/src/utils․lisp file

V
	`validate.lisp`:	The cl-tls/src/x509/validate․lisp file

X
	`x509`:	The cl-tls/src/x509 module
	`x509-decoding-error`:	Private conditions
	`x509-extension`:	Private classes
	`x509.lisp`:	The cl-tls/src/x509/x509․lisp file
	`x509v3-certificate`:	Private classes

The cl-tls Reference Manual

The cl-tls Reference Manual

Table of Contents

1 Introduction

2 Systems

2.1 cl-tls

3 Modules

3.1 cl-tls/src

3.2 cl-tls/src/ASN.1

3.3 cl-tls/src/pkcs

3.4 cl-tls/src/x509

3.5 cl-tls/src/PEM

3.6 cl-tls/src/tls

4 Files

4.1 Lisp

4.1.1 cl-tls/cl-tls.asd

4.1.2 cl-tls/src/package.lisp

4.1.3 cl-tls/src/utils.lisp

4.1.4 cl-tls/src/ASN.1/asn.1.lisp

4.1.5 cl-tls/src/pkcs/pkcs1.lisp

4.1.6 cl-tls/src/pkcs/pkcs3.lisp

4.1.7 cl-tls/src/pkcs/pkcs5.lisp

4.1.8 cl-tls/src/pkcs/pkcs8.lisp

4.1.9 cl-tls/src/x509/extensions.lisp

4.1.10 cl-tls/src/x509/x509.lisp

4.1.11 cl-tls/src/x509/ocsp.lisp

4.1.12 cl-tls/src/x509/validate.lisp

4.1.13 cl-tls/src/PEM/rfc7468.lisp

4.1.14 cl-tls/src/tls/transport.lisp

4.1.15 cl-tls/src/tls/http.lisp

4.1.16 cl-tls/src/tls/ciphersuites.lisp

4.1.17 cl-tls/src/tls/alert.lisp

4.1.18 cl-tls/src/tls/crypto.lisp

4.1.19 cl-tls/src/tls/extensions.lisp

4.1.20 cl-tls/src/tls/tls.lisp

4.2 Static

4.2.1 cl-tls/README

4.2.2 cl-tls/LICENSE

5 Packages

5.1 cl-tls

6 Definitions

6.1 Public Interface

6.1.1 Ordinary functions

6.1.2 Generic functions

6.1.3 Standalone methods

6.1.4 Conditions

6.1.5 Classes

6.2 Internals

6.2.1 Constants

6.2.2 Special variables

6.2.3 Symbol macros

6.2.4 Macros

6.2.5 Ordinary functions

6.2.6 Generic functions

6.2.7 Conditions

6.2.8 Classes

6.2.9 Types

Appendix A Indexes

A.1 Concepts

A.2 Functions

A.3 Variables

A.4 Data types

2.1 `cl-tls`

3.1 `cl-tls/src`

3.2 `cl-tls/src/ASN.1`

3.3 `cl-tls/src/pkcs`

3.4 `cl-tls/src/x509`

3.5 `cl-tls/src/PEM`

3.6 `cl-tls/src/tls`

4.1.1 `cl-tls/cl-tls.asd`

4.1.2 `cl-tls/src/package.lisp`

4.1.3 `cl-tls/src/utils.lisp`

4.1.4 `cl-tls/src/ASN.1/asn.1.lisp`

4.1.5 `cl-tls/src/pkcs/pkcs1.lisp`

4.1.6 `cl-tls/src/pkcs/pkcs3.lisp`

4.1.7 `cl-tls/src/pkcs/pkcs5.lisp`

4.1.8 `cl-tls/src/pkcs/pkcs8.lisp`

4.1.9 `cl-tls/src/x509/extensions.lisp`

4.1.10 `cl-tls/src/x509/x509.lisp`

4.1.11 `cl-tls/src/x509/ocsp.lisp`

4.1.12 `cl-tls/src/x509/validate.lisp`

4.1.13 `cl-tls/src/PEM/rfc7468.lisp`

4.1.14 `cl-tls/src/tls/transport.lisp`

4.1.15 `cl-tls/src/tls/http.lisp`

4.1.16 `cl-tls/src/tls/ciphersuites.lisp`

4.1.17 `cl-tls/src/tls/alert.lisp`

4.1.18 `cl-tls/src/tls/crypto.lisp`

4.1.19 `cl-tls/src/tls/extensions.lisp`

4.1.20 `cl-tls/src/tls/tls.lisp`

4.2.1 `cl-tls/README`

4.2.2 `cl-tls/LICENSE`

5.1 `cl-tls`