kibi-swipl-linux-x64-gnu 1.0.0

package/lib/swipl/library/ext/clib/uuid.pl

@@ -0,0 +1,207 @@
+/*  Part of SWI-Prolog
+
+    Author:        Jan Wielemaker
+    E-mail:        J.Wielemaker@vu.nl
+    WWW:           http://www.swi-prolog.org
+    Copyright (c)  2012-2024, VU University Amsterdam
+                              SWI-Prolog Solutions b.v.
+    All rights reserved.
+
+    Redistribution and use in source and binary forms, with or without
+    modification, are permitted provided that the following conditions
+    are met:
+
+    1. Redistributions of source code must retain the above copyright
+       notice, this list of conditions and the following disclaimer.
+
+    2. Redistributions in binary form must reproduce the above copyright
+       notice, this list of conditions and the following disclaimer in
+       the documentation and/or other materials provided with the
+       distribution.
+
+    THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+    "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+    LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+    FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+    COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
+    INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
+    BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+    LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+    CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+    LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
+    ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+    POSSIBILITY OF SUCH DAMAGE.
+*/
+
+:- module(uuid,
+          [ uuid/1,                     % -UUID
+            uuid/2,                     % -UUID, +Options
+            is_uuid/1,                  % @UUID
+            uuid_property/2             % +UUID, ?Property
+          ]).
+:- autoload(library(apply), [maplist/2]).
+:- if(exists_source(library(shlib))).
+:- autoload(library(shlib), [load_foreign_library/1]).
+:- endif.
+
+/** <module> Universally Unique Identifier (UUID) Library
+
+The library provides operations on UUIDs.   Please consult other sources
+for understanding UUIDs and  the  implications   of  the  different UUID
+versions.  Some typical calls are given below:
+
+  ==
+  ?- uuid(X).
+  X = 'ea6589fa-19dd-11e2-8a49-001d92e1879d'.
+
+  ?- uuid(X, [url('http://www.swi-prolog.org')]).
+  X = '73a07870-6a90-3f2e-ae2b-ffa538dc7c2c'.
+  ==
+
+@tbd Compare UUIDs, extract time and version from UUIDs
+@see http://www.ossp.org/pkg/lib/uuid/
+@see https://en.wikipedia.org/wiki/Universally_unique_identifier
+*/
+
+link_uuid :-
+    catch(load_foreign_library(foreign(uuid)), error(_,_), true).
+
+:- initialization(link_uuid, now).
+
+%!  uuid(-UUID) is det.
+%
+%   UUID is an atom representing a  new   UUID.  This is the same as
+%   calling uuid(UUID, []).  See uuid/2 for options.
+
+uuid(UUID) :-
+    uuid(UUID, []).
+
+%!  uuid(-UUID, +Options) is det.
+%
+%   Create a new UUID according to   Options.  The following options
+%   are defined:
+%
+%     * version(+Versions)
+%     Integer in the range 1..5, which specifies the UUID version
+%     that is created.  Default is 1.
+%
+%     * dns(DNS)
+%     * url(URL)
+%     * oid(OID)
+%     * x500(X500)
+%     Provide additional context information for UUIDs using version
+%     3 or 5.  If there is no explicit version option, UUID version
+%     3 is used.
+%
+%     * format(+Format)
+%     Representation of the UUID.  Default is =atom=, yielding atoms
+%     such as =|8304efdd-bd6e-5b7c-a27f-83f3f05c64e0|=. The
+%     alternative is =integer=, returning a large integer that
+%     represents the 128 bits of the UUID.
+%
+%   If SWI-Prolog was not built with the  OSSP UUID dependency library a
+%   simple Prolog alternative that  only   implements  version  4 random
+%   UUIDs is provided. In this case  the   default  version is 4 and the
+%   only admissible options are version(4) and format(Format).
+
+:- if(current_predicate(ossp_uuid/2)).
+uuid(UUID, Options) :-
+    ossp_uuid(UUID, Options).
+
+:- else.
+
+uuid(UUID, []) :-
+    !,
+    random_uuid(UUID).
+uuid(UUID, Options) :-
+    option(version(4), Options, 4),
+    option(format(Format), Options, atom),
+    (   Format == atom
+    ->  !, random_uuid(UUID)
+    ;   Format == integer
+    ->  !, random_int_uuid(UUID)
+    ).
+uuid(_UUID, Options) :-
+    domain_error(uuid_options, Options).
+
+random_uuid(UUID) :-
+    Version = 4,
+    A is random(0xffffffff),
+    B is random(0xffff),
+    C is random(0x0fff) \/ Version<<12,
+    D is random(0x3fff) \/ 0x8000,
+    E is random(0xffffffffffff),
+    format(atom(UUID),
+           '~`0t~16r~8+-~|\c
+            ~`0t~16r~4+-~|\c
+            ~`0t~16r~4+-~|\c
+            ~`0t~16r~4+-~|\c
+            ~`0t~16r~12+', [A,B,C,D,E]).
+
+random_int_uuid(UUID) :-
+    Version = 4,
+    A is random(0xffffffff),
+    B is random(0xffff),
+    C is random(0x0fff) \/ Version<<12,
+    D is random(0x3fff) \/ 0x8000,
+    E is random(0xffffffffffff),
+    UUID is (A<<96)+(B<<80)+(C<<84)+(D<<48)+E.
+
+:- endif.
+
+%!  uuid_property(+UUID, ?Property)
+%
+%   True when UUID is a property of the given UUID. Supported properties
+%   are:
+%
+%     - version(V)
+%       Return the version of the UUID (1..5)
+%     - time(-Stamp)
+%       Time using SWI-Prolog's time stamp (float with seconds
+%       since January 1, 1970, UTC).  Only for version 1 and 2
+%       UUIDs
+%
+%   @tbd Implement more properties.
+
+uuid_property(UUID, P) :-
+    property_uuid(P, UUID).
+
+property_uuid(version(V), UUID) :-
+    split_string(UUID, "-", "", [_A,_B,C,_D,_E]),
+    sub_string(C, 0, 1, _, F),
+    char_type(F, xdigit(V)).
+property_uuid(time(Time), UUID) :-
+    split_string(UUID, "-", "", [A,B,C,_D,_E]),
+    sub_atom(C, 0, 1, _, F),
+    has_time(F),
+    sub_string(C, 1, _, 0, T),
+    atomics_to_string(["0x",T,B,A], Hex),
+    number_string(Nanos, Hex),
+    Offset is 24*60*60*141427*10 000 000,
+    Time is (Nanos-Offset)/10000000.0.
+
+has_time('1').
+has_time('2').
+
+%!  is_uuid(@UUID) is semidet.
+%
+%   True when UUID is a UUID represented as an atom. It merely validates
+%   that the length is 36 characters, there   are `-` at the right place
+%   and all other characters are hexadecimal.
+
+is_uuid(UUID) :-
+    atom(UUID),
+    atom_length(UUID, 36),
+    atom_codes(UUID, Codes),
+    Codes = [ _,_,_,_,_,_,_,_, 0'-,
+              _,_,_,_, 0'-,
+              _,_,_,_, 0'-,
+              _,_,_,_, 0'-,
+              _,_,_,_,_,_,_,_,_,_,_,_
+            ],
+    maplist(hex_or_minus, Codes).
+
+hex_or_minus(0'-) :-
+    !.
+hex_or_minus(Code) :-
+    code_type(Code, xdigit(_)).

package/lib/swipl/library/ext/http/http/INDEX.pl

@@ -0,0 +1,266 @@
+/*  Creator: make/0
+
+    Purpose: Provide index for autoload
+*/
+
+index(http_ax_attributes(?,?), http_ax, ax).
+index(ax_form_attributes(?,?), http_ax, ax).
+index(graphql_read_document(?,?,?), graphql, graphql).
+index(graphql_execute_document(?,?,?,?), graphql, graphql).
+index(graphql_document_to_string(?,?,?), graphql, graphql).
+index(graphql_document_to_codes(?,?,?), graphql, graphql).
+index(graphql(?,?,?,?), graphql, graphql).
+index(html_meta(?), html_decl, html_decl).
+index(html_no_content(?), html_decl, html_decl).
+index(:(op,op(1150,fx,html_meta)), html_decl, html_decl).
+index(html_resource(?,?), html_head, html_head).
+index(html_requires(?,?,?), html_head, html_head).
+index(html_current_resource(?), html_head, html_head).
+index(html(?,?,?,?), html_quasi_quotations, html_quasiquotations).
+index(reply_html_page(:,:), html_write, html_write).
+index(reply_html_page(+,:,:), html_write, html_write).
+index(reply_html_partial(?), html_write, html_write).
+index(page(:,-,+), html_write, html_write).
+index(page(:,:,-,+), html_write, html_write).
+index(page(?,?,?,?,?), html_write, html_write).
+index(html(:,-,+), html_write, html_write).
+index(html_set_options(?), html_write, html_write).
+index(html_current_option(?), html_write, html_write).
+index(html_post(+,:,-,+), html_write, html_write).
+index(html_receive(?,?,?), html_write, html_write).
+index(html_receive(+,3,-,+), html_write, html_write).
+index(xhtml_ns(?,?,?,?), html_write, html_write).
+index(html_root_attribute(?,?,?,?), html_write, html_write).
+index(html(?,?,?,?), html_write, html_write).
+index(html_begin(?,?,?), html_write, html_write).
+index(html_end(?,?,?), html_write, html_write).
+index(html_quoted(?,?,?), html_write, html_write).
+index(html_quoted_attribute(?,?,?), html_write, html_write).
+index(print_html(?), html_write, html_write).
+index(print_html(?,?), html_write, html_write).
+index(html_print_length(?,?), html_write, html_write).
+index(html_meta(?), html_write, html_write).
+index(:(op,op(1150,fx,html_meta)), html_write, html_write).
+index(reply_htmx(?), htmx, htmx).
+index(reply_htmx(?,?), htmx, htmx).
+index(htmx_oob(?,?,?,?), htmx, htmx).
+index(http_authenticate(?,?,?), authenticate, http_authenticate).
+index(http_authorization_data(?,?), authenticate, http_authenticate).
+index(http_current_user(?,?,?), authenticate, http_authenticate).
+index(http_read_passwd_file(?,?), authenticate, http_authenticate).
+index(http_write_passwd_file(?,?), authenticate, http_authenticate).
+index(http_get(?,?,?), http_client, http_client).
+index(http_delete(?,?,?), http_client, http_client).
+index(http_post(?,?,?,?), http_client, http_client).
+index(http_put(?,?,?,?), http_client, http_client).
+index(http_patch(?,?,?,?), http_client, http_client).
+index(http_read_data(+,-,:), http_client, http_client).
+index(http_disconnect(?), http_client, http_client).
+index(cookie_remove_client(?), http_cookie, http_cookie).
+index(cookie_remove_all_clients, http_cookie, http_cookie).
+index(cookie_current_cookie(?,?,?,?), http_cookie, http_cookie).
+index(cors_enable, http_cors, http_cors).
+index(cors_enable(?,?), http_cors, http_cors).
+index(http_digest_challenge(?,?,?,?), http_digest, http_digest).
+index(http_digest_password_hash(?,?,?,?), http_digest, http_digest).
+index(http_parse_digest_challenge(?,?), http_digest, http_digest).
+index(http_digest_response(?,?,?,?,?), http_digest, http_digest).
+index(http_reply_dirindex(+,:,+), http_dirindex, http_dirindex).
+index(directory_index(+,:,?,?), http_dirindex, http_dirindex).
+index(http_dispatch(?), http_dispatch, http_dispatch).
+index(http_handler(?,?,?), http_dispatch, http_dispatch).
+index(http_delete_handler(?), http_dispatch, http_dispatch).
+index(http_request_expansion(?,?), http_dispatch, http_dispatch).
+index(http_reply_file(?,?,?), http_dispatch, http_dispatch).
+index(http_redirect(?,?,?), http_dispatch, http_dispatch).
+index(http_404(?,?), http_dispatch, http_dispatch).
+index(http_switch_protocol(?,?), http_dispatch, http_dispatch).
+index(http_current_handler(?,?), http_dispatch, http_dispatch).
+index(http_current_handler(?,?,?), http_dispatch, http_dispatch).
+index(http_location_by_id(?,?), http_dispatch, http_dispatch).
+index(http_link_to_id(?,?,?), http_dispatch, http_dispatch).
+index(http_reload_with_parameters(?,?,?), http_dispatch, http_dispatch).
+index(http_safe_file(?,?), http_dispatch, http_dispatch).
+index(map_exception_to_http_status(?,?,?,?), http_exception, http_exception).
+index(in_or_exclude_backtrace(?,?), http_exception, http_exception).
+index(http_reply_from_files(?,?,?), http_files, http_files).
+index(http_read_request(?,?), http_header, http_header).
+index(http_read_reply_header(?,?), http_header, http_header).
+index(http_reply(?,?), http_header, http_header).
+index(http_reply(?,?,?), http_header, http_header).
+index(http_reply(?,?,?,?), http_header, http_header).
+index(http_reply(?,?,?,?,?), http_header, http_header).
+index(http_reply(?,?,?,?,?,?), http_header, http_header).
+index(http_reply_header(?,?,?), http_header, http_header).
+index(http_status_reply(?,?,?,?), http_header, http_header).
+index(http_status_reply(?,?,?,?,?), http_header, http_header).
+index(http_timestamp(?,?), http_header, http_header).
+index(http_post_data(?,?,?), http_header, http_header).
+index(http_read_header(?,?), http_header, http_header).
+index(http_parse_header(?,?), http_header, http_header).
+index(http_parse_header_value(?,?,?), http_header, http_header).
+index(http_join_headers(?,?,?), http_header, http_header).
+index(http_update_encoding(?,?,?), http_header, http_header).
+index(http_update_connection(?,?,?,?), http_header, http_header).
+index(http_update_transfer(?,?,?,?), http_header, http_header).
+index(http_public_url(?,?), http_host, http_host).
+index(http_public_host_url(?,?), http_host, http_host).
+index(http_public_host(?,?,?,?), http_host, http_host).
+index(http_current_host(?,?,?,?), http_host, http_host).
+index(http_log_stream(?), http_log, http_log).
+index(http_log(?,?), http_log, http_log).
+index(http_log_close(?), http_log, http_log).
+index(post_data_encoded(?,?), http_log, http_log).
+index(http_logrotate(?), http_log, http_log).
+index(http_schedule_logrotate(?,?), http_log, http_log).
+index(http_open(+,-,:), http_open, http_open).
+index(http_set_authorization(?,?), http_open, http_open).
+index(http_close_keep_alive(?), http_open, http_open).
+index(openid_login(?), http_openid, http_openid).
+index(openid_logout(?), http_openid, http_openid).
+index(openid_logged_in(?), http_openid, http_openid).
+index(openid_user(?,?,?), http_openid, http_openid).
+index(openid_verify(?,?), http_openid, http_openid).
+index(openid_authenticate(?,?,?,?), http_openid, http_openid).
+index(openid_associate(?,?,?), http_openid, http_openid).
+index(openid_associate(?,?,?,?), http_openid, http_openid).
+index(openid_server(?,?), http_openid, http_openid).
+index(openid_server(?,?,?), http_openid, http_openid).
+index(openid_grant(?), http_openid, http_openid).
+index(openid_login_form(?,?,?,?), http_openid, http_openid).
+index(openid_current_url(?,?), http_openid, http_openid).
+index(openid_current_host(?,?,?), http_openid, http_openid).
+index(http_parameters(?,?), http_parameters, http_parameters).
+index(http_parameters(?,?,?), http_parameters, http_parameters).
+index(http_convert_parameter(?,?,?,?), http_parameters, http_parameters).
+index(http_convert_parameters(?,?), http_parameters, http_parameters).
+index(http_convert_parameters(?,?,?), http_parameters, http_parameters).
+index(http_absolute_location(?,?,?), http_path, http_path).
+index(http_clean_location_cache, http_path, http_path).
+index(http_absolute_uri(?,?), http_path, http_path).
+index(reply_pwp_page(?,?,?), http_pwp, http_pwp).
+index(pwp_handler(?,?), http_pwp, http_pwp).
+index(http_server(?), http_server, http_server).
+index(http_current_server(?,?), http_server, http_server).
+index(http_server_property(?,?), http_server, http_server).
+index(http_server(?,?), http_server, http_server).
+index(http_workers(?,?), http_server, http_server).
+index(http_add_worker(?,?), http_server, http_server).
+index(http_current_worker(?,?), http_server, http_server).
+index(http_stop_server(?,?), http_server, http_server).
+index(http_spawn(?,?), http_server, http_server).
+index(http_dispatch(?), http_server, http_server).
+index(http_handler(?,?,?), http_server, http_server).
+index(http_delete_handler(?), http_server, http_server).
+index(http_request_expansion(?,?), http_server, http_server).
+index(http_reply_file(?,?,?), http_server, http_server).
+index(http_redirect(?,?,?), http_server, http_server).
+index(http_404(?,?), http_server, http_server).
+index(http_switch_protocol(?,?), http_server, http_server).
+index(http_current_handler(?,?), http_server, http_server).
+index(http_current_handler(?,?,?), http_server, http_server).
+index(http_location_by_id(?,?), http_server, http_server).
+index(http_link_to_id(?,?,?), http_server, http_server).
+index(http_reload_with_parameters(?,?,?), http_server, http_server).
+index(http_current_request(?), http_server, http_server).
+index(http_peer(?,?), http_server, http_server).
+index(http_parameters(?,?), http_server, http_server).
+index(http_parameters(?,?,?), http_server, http_server).
+index(reply_html_page(?,?), http_server, http_server).
+index(html(?,?,?), http_server, http_server).
+index(html_meta(?), http_server, http_server).
+index(:(op,op(1150,fx,html_meta)), http_server, http_server).
+index(reply_json_dict(?), http_server, http_server).
+index(reply_json_dict(?,?), http_server, http_server).
+index(http_read_json_dict(?,?), http_server, http_server).
+index(http_read_json_dict(?,?,?), http_server, http_server).
+index(is_json_content_type(?), http_server, http_server).
+index(serve_files_in_directory(?,?), http_server_files, http_server_files).
+index(server_health(?), http_server_health, http_server_health).
+index(http_set_session_options(?), http_session, http_session).
+index(http_set_session(?), http_session, http_session).
+index(http_set_session(?,?), http_session, http_session).
+index(http_session_option(?), http_session, http_session).
+index(http_session_id(?), http_session, http_session).
+index(http_in_session(?), http_session, http_session).
+index(http_current_session(?,?), http_session, http_session).
+index(http_close_session(?), http_session, http_session).
+index(http_open_session(?,?), http_session, http_session).
+index(http_session_cookie(?), http_session, http_session).
+index(http_session_asserta(?), http_session, http_session).
+index(http_session_assert(?), http_session, http_session).
+index(http_session_retract(?), http_session, http_session).
+index(http_session_retractall(?), http_session, http_session).
+index(http_session_data(?), http_session, http_session).
+index(http_session_asserta(?,?), http_session, http_session).
+index(http_session_assert(?,?), http_session, http_session).
+index(http_session_retract(?,?), http_session, http_session).
+index(http_session_retractall(?,?), http_session, http_session).
+index(http_session_data(?,?), http_session, http_session).
+index(http_chunked_open(?,?,?), http_stream, http_stream).
+index(http_is_chunked(?), http_stream, http_stream).
+index(http_chunked_flush(?,?), http_stream, http_stream).
+index(http_chunked_add_trailer(?,?,?), http_stream, http_stream).
+index(stream_range_open(+,-,:), http_stream, http_stream).
+index(multipart_open(?,?,?), http_stream, http_stream).
+index(multipart_open_next(?), http_stream, http_stream).
+index(cgi_open(?,?,?,?), http_stream, http_stream).
+index(cgi_property(?,?), http_stream, http_stream).
+index(cgi_set(?,?), http_stream, http_stream).
+index(cgi_discard(?), http_stream, http_stream).
+index(is_cgi_stream(?), http_stream, http_stream).
+index(cgi_statistics(?), http_stream, http_stream).
+index(:(public,http_stream_debug(_)), http_stream, http_stream).
+index(http_daemon, http_unix_daemon, http_unix_daemon).
+index(http_daemon(?), http_unix_daemon, http_unix_daemon).
+index(http_opt_type(?,?,?), http_unix_daemon, http_unix_daemon).
+index(http_opt_help(?,?), http_unix_daemon, http_unix_daemon).
+index(http_opt_meta(?,?), http_unix_daemon, http_unix_daemon).
+index(http_wrapper(0,+,+,-,+), httpd_wrapper, http_wrapper).
+index(http_current_request(?), httpd_wrapper, http_wrapper).
+index(http_peer(?,?), httpd_wrapper, http_wrapper).
+index(http_send_header(?), httpd_wrapper, http_wrapper).
+index(http_relative_path(?,?), httpd_wrapper, http_wrapper).
+index(http_wrap_spawned(?,?,?), httpd_wrapper, http_wrapper).
+index(http_spawned(?), httpd_wrapper, http_wrapper).
+index(hub_create(?,?,?), hub, hub).
+index(hub_add(?,?,?), hub, hub).
+index(hub_member(?,?), hub, hub).
+index(hub_send(?,?), hub, hub).
+index(hub_broadcast(?,?), hub, hub).
+index(hub_broadcast(+,+,1), hub, hub).
+index(current_hub(?,?), hub, hub).
+index(js_script(?,?,?), javascript, js_write).
+index(js_call(?,?,?), javascript, js_write).
+index(js_new(?,?,?,?), javascript, js_write).
+index(js_expression(?,?,?), javascript, js_write).
+index(js_arg_list(?,?,?), javascript, js_write).
+index(js_arg(?,?,?), javascript, js_write).
+index(js_args(?,?,?), javascript, js_write).
+index(javascript(?,?,?,?), javascript, js_write).
+index(mime_pack(?,?,?), mime_pack, mimepack).
+index(file_mime_type(?,?), mimetype, mimetype).
+index(file_content_type(?,?), mimetype, mimetype).
+index(file_content_type(?,?,?), mimetype, mimetype).
+index(term(+,:,?,?), term_html, term_html).
+index(http_current_server(?,?), thread_httpd, thread_httpd).
+index(http_server_property(?,?), thread_httpd, thread_httpd).
+index(http_server(?,?), thread_httpd, thread_httpd).
+index(http_workers(?,?), thread_httpd, thread_httpd).
+index(http_add_worker(?,?), thread_httpd, thread_httpd).
+index(http_current_worker(?,?), thread_httpd, thread_httpd).
+index(http_stop_server(?,?), thread_httpd, thread_httpd).
+index(http_spawn(?,?), thread_httpd, thread_httpd).
+index(http_requeue(?), thread_httpd, thread_httpd).
+index(http_close_connection(?), thread_httpd, thread_httpd).
+index(http_enough_workers(?,?,?), thread_httpd, thread_httpd).
+index(http_open_websocket(?,?,?), websocket, websocket).
+index(http_upgrade_to_websocket(1,+,+), websocket, websocket).
+index(ws_send(?,?), websocket, websocket).
+index(ws_receive(?,?), websocket, websocket).
+index(ws_receive(?,?,?), websocket, websocket).
+index(ws_close(?,?,?), websocket, websocket).
+index(ws_open(?,?,?), websocket, websocket).
+index(ws_property(?,?), websocket, websocket).
+index(xrds_dom(?,?), yadis, yadis).
+index(xrds_location(?,?), yadis, yadis).

package/lib/swipl/library/ext/http/http/README.md

@@ -0,0 +1,34 @@
+# SWI-Prolog HTTP support library
+
+This directory provides  the  SWI-Prolog   libraries  for  accessing and
+providing HTTP services.
+
+## Client library
+
+The main client library is `library(http/http_open)`, which can open
+both HTTP and HTTPS connections and handle all request methods.
+
+## Server library
+
+The main server libraries are
+
+  - `library(http/thread_httpd)` implements the server
+  - `library(http/http_dispatch)` implements binding locations
+    predicates
+  - `library(http/http_unix_daemon)` implements integration in various
+    Unix server managers and in general provides a suitable entry point
+    for HTTP servers on Unix.
+  - `library(http/html_write)` implements generating HTML
+  - `library(http/http_json)` implements reading and writing JSON documents.
+
+For simplicity, you can use `library(http/http_server)`, which
+combines the typical HTTP libraries that most servers need. The
+idea of a common request handling system and three controlling
+libraries is outdated; the threaded server now being the only sensible
+controlling library.
+
+# Requirements
+
+This library uses functionality from the `ssl` package to support HTTPS,
+the `sgml` package to read XML/HTML and   the `clib` package for various
+extensions.