diff --git a/index.html b/index.html index 73c16cf..ada69a3 100644 --- a/index.html +++ b/index.html @@ -1,46 +1,34 @@ - + - + -Untitled Document + +Guile Knots - - + + - - + + + + + + + @@ -48,76 +36,135 @@ ul.no-bullet {list-style: none} - + - - - - - - - - - - - - - - - -
[ << ][ < ][ Up ][ > ][ >> ]         [Top][Contents][Index][ ? ]
- -

1 API

+ + + + +
+
+

+Next:   [Contents][Index]

+
+

Overview

+ +

Guile Knots is a library providing tools and patterns for programming +with Guile Fibers. Guile Knots +provides higher level building blocks for writing programs using Guile +Fibers, including managing code that can’t run in a thread used by +fibers. Also included is a web server implementation using Fibers, +which while being similar to the web server provided by Fibers, can +provide some benefits in specific circumstances. +

+ + + + + + +
+

Table of Contents

+ +
+ + +
+
+
+
+
+

+Next: , Previous: , Up: Overview   [Contents][Index]

+
+

1 API

The following is the list of modules provided by this library.

+
- - - - - - - - - - - - - - - -
[ << ][ < ][ Up ][ > ][ >> ]         [Top][Contents][Index][ ? ]
- -

1.1 (knots non-blocking)

+
+
+

+Next: , Up: API   [Contents][Index]

+
+

1.1 (knots non-blocking)

-
- - - - - - - - - - - - - - - -
[ << ][ < ][ Up ][ > ][ >> ]         [Top][Contents][Index][ ? ]
-

1.1.1 Procedures

+ +
+

1.1.1 Procedures

-
-
Procedure: non-blocking-open-socket-for-uri uri KEY: #:verify-certificate?
+
+
Procedure: non-blocking-open-socket-for-uri _ KEY: #:verify-certificate?

Undocumented procedure.

@@ -125,8 +172,8 @@ ul.no-bullet {list-style: none} -
-
Procedure: non-blocking-port port
+
+
Procedure: non-blocking-port a

Make PORT non-blocking and return it.

@@ -137,51 +184,29 @@ ul.no-bullet {list-style: none}
- - - - - - - - - - - - - - - -
[ << ][ < ][ Up ][ > ][ >> ]         [Top][Contents][Index][ ? ]
- -

1.2 (knots parallelism)

+
+
+
+
+

+Next: , Previous: , Up: API   [Contents][Index]

+
+

1.2 (knots parallelism)

-
- - - - - - - - - - - - - - - -
[ << ][ < ][ Up ][ > ][ >> ]         [Top][Contents][Index][ ? ]
-

1.2.1 Macros

+ +
+

1.2.1 Macros

-
-
Macro: fibers-let x
+
+
Macro: fibers-let a

Undocumented macro.

@@ -189,8 +214,8 @@ ul.no-bullet {list-style: none} -
-
Macro: fibers-parallel x
+
+
Macro: fibers-parallel a

Undocumented macro.

@@ -199,28 +224,13 @@ ul.no-bullet {list-style: none} -
- - - - - - - - - - - - - - - -
[ << ][ < ][ Up ][ > ][ >> ]         [Top][Contents][Index][ ? ]
-

1.2.2 Procedures

+
+
+

1.2.2 Procedures

-
-
Procedure: fiberize proc KEY: #:parallelism #:input-channel #:process-channel
+
+
Procedure: fiberize _ KEY: #:parallelism #:input-channel #:process-channel

Undocumented procedure.

@@ -228,8 +238,8 @@ ul.no-bullet {list-style: none} -
-
Procedure: fibers-batch-for-each proc parallelism-limit . lists
+
+
Procedure: fibers-batch-for-each a b . rest

Undocumented procedure.

@@ -237,8 +247,8 @@ ul.no-bullet {list-style: none} -
-
Procedure: fibers-batch-map proc parallelism-limit . lists
+
+
Procedure: fibers-batch-map a b . rest

Undocumented procedure.

@@ -246,8 +256,8 @@ ul.no-bullet {list-style: none} -
-
Procedure: fibers-for-each proc . lists
+
+
Procedure: fibers-for-each a . rest

Undocumented procedure.

@@ -255,8 +265,8 @@ ul.no-bullet {list-style: none} -
-
Procedure: fibers-map proc . lists
+
+
Procedure: fibers-map a . rest

Undocumented procedure.

@@ -264,8 +274,8 @@ ul.no-bullet {list-style: none} -
-
Procedure: fibers-map-with-progress proc lists KEY: #:report
+
+
Procedure: fibers-map-with-progress _ _ KEY: #:report

Undocumented procedure.

@@ -276,51 +286,29 @@ ul.no-bullet {list-style: none}
- - - - - - - - - - - - - - - -
[ << ][ < ][ Up ][ > ][ >> ]         [Top][Contents][Index][ ? ]
- -

1.3 (knots promise)

+
+
+
+
+

+Next: , Previous: , Up: API   [Contents][Index]

+
+

1.3 (knots promise)

-
- - - - - - - - - - - - - - - -
[ << ][ < ][ Up ][ > ][ >> ]         [Top][Contents][Index][ ? ]
-

1.3.1 Macros

+ +
+

1.3.1 Macros

-
-
Macro: fibers-promise? x
+
+
Macro: fibers-promise? a

Undocumented macro.

@@ -329,28 +317,13 @@ ul.no-bullet {list-style: none} -
- - - - - - - - - - - - - - - -
[ << ][ < ][ Up ][ > ][ >> ]         [Top][Contents][Index][ ? ]
-

1.3.2 Procedures

+
+
+

1.3.2 Procedures

-
-
Procedure: fibers-delay thunk
+
+
Procedure: fibers-delay a

Undocumented procedure.

@@ -358,8 +331,8 @@ ul.no-bullet {list-style: none} -
-
Procedure: fibers-force fp
+
+
Procedure: fibers-force a

Undocumented procedure.

@@ -367,8 +340,8 @@ ul.no-bullet {list-style: none} -
-
Procedure: fibers-promise-reset fp
+
+
Procedure: fibers-promise-reset a

Undocumented procedure.

@@ -376,8 +349,8 @@ ul.no-bullet {list-style: none} -
-
Procedure: fibers-promise-result-available? fp
+
+
Procedure: fibers-promise-result-available? a

Undocumented procedure.

@@ -388,51 +361,28 @@ ul.no-bullet {list-style: none}
- - - - - - - - - - - - - - - -
[ << ][ < ][ Up ][ > ][ >> ]         [Top][Contents][Index][ ? ]
- -

1.4 (knots queue)

+
+
+
+
+

+Next: , Previous: , Up: API   [Contents][Index]

+
+

1.4 (knots queue)

-
- - - - - - - - - - - - - - - -
[ << ][ < ][ Up ][ > ][ >> ]         [Top][Contents][Index][ ? ]
-

1.4.1 Procedures

+ +
+

1.4.1 Procedures

-
-
Procedure: spawn-queueing-fiber dest-channel
+
+
Procedure: spawn-queueing-fiber a

Undocumented procedure.

@@ -443,51 +393,31 @@ ul.no-bullet {list-style: none}
- - - - - - - - - - - - - - - -
[ << ][ < ][ Up ][ > ][ >> ]         [Top][Contents][Index][ ? ]
- -

1.5 (knots resource-pool)

+
+
+
+
+

+Next: , Previous: , Up: API   [Contents][Index]

+
+

1.5 (knots resource-pool)

-
- - - - - - - - - - - - - - - -
[ << ][ < ][ Up ][ > ][ >> ]         [Top][Contents][Index][ ? ]
-

1.5.1 Macros

+ +
+

1.5.1 Macros

-
-
Macro: resource-pool-channel x
+
+
Macro: resource-pool-channel a

Undocumented macro.

@@ -495,8 +425,8 @@ ul.no-bullet {list-style: none} -
-
Macro: resource-pool-configuration x
+
+
Macro: resource-pool-configuration a

Undocumented macro.

@@ -504,8 +434,8 @@ ul.no-bullet {list-style: none} -
-
Macro: resource-pool-name x
+
+
Macro: resource-pool-name a

Undocumented macro.

@@ -513,8 +443,8 @@ ul.no-bullet {list-style: none} -
-
Macro: resource-pool? x
+
+
Macro: resource-pool? a

Undocumented macro.

@@ -522,8 +452,8 @@ ul.no-bullet {list-style: none} -
-
Macro: with-resource-from-pool x
+
+
Macro: with-resource-from-pool a

Undocumented macro.

@@ -532,28 +462,13 @@ ul.no-bullet {list-style: none} -
- - - - - - - - - - - - - - - -
[ << ][ < ][ Up ][ > ][ >> ]         [Top][Contents][Index][ ? ]
-

1.5.2 Parameters

+
+
+

1.5.2 Parameters

-
-
Parameter: resource-pool-default-timeout-handler
+
+
Parameter: resource-pool-default-timeout-handler

Default value: 

#f
@@ -564,28 +479,13 @@ ul.no-bullet {list-style: none}
 
 
 
-

-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
[ << ][ < ][ Up ][ > ][ >> ]            [Top][Contents][Index][ ? ]

-
1.5.3 Procedures

+
+
+

1.5.3 Procedures

-
-
Procedure: call-with-resource-from-pool pool proc KEY: #:timeout #:timeout-handler #:max-waiters #:channel #:destroy-resource-on-exception?
+
+
Procedure: call-with-resource-from-pool _ _ KEY: #:timeout #:timeout-handler #:max-waiters #:channel #:destroy-resource-on-exception?

Call PROC with a resource from POOL, blocking until a resource becomes available. Return the resource once PROC has returned.

@@ -594,8 +494,8 @@ available. Return the resource once PROC has returned. -
-
Procedure: destroy-resource-pool pool
+
+
Procedure: destroy-resource-pool a

Undocumented procedure.

@@ -603,8 +503,8 @@ available. Return the resource once PROC has returned. -
-
Procedure: make-resource-pool return-new-resource max-size KEY: #:min-size #:idle-seconds #:delay-logger #:duration-logger #:destructor #:lifetime #:scheduler #:name #:add-resources-parallelism #:default-checkout-timeout #:default-max-waiters
+
+
Procedure: make-resource-pool _ _ KEY: #:min-size #:idle-seconds #:delay-logger #:duration-logger #:destructor #:lifetime #:scheduler #:name #:add-resources-parallelism #:default-checkout-timeout #:default-max-waiters

Undocumented procedure.

@@ -612,8 +512,8 @@ available. Return the resource once PROC has returned. -
-
Procedure: make-resource-pool-destroy-resource-exception
+
+
Procedure: make-resource-pool-destroy-resource-exception

Undocumented procedure.

@@ -621,8 +521,8 @@ available. Return the resource once PROC has returned. -
-
Procedure: resource-pool-destroy-resource-exception? obj
+
+
Procedure: resource-pool-destroy-resource-exception? obj

Undocumented procedure.

@@ -630,8 +530,8 @@ available. Return the resource once PROC has returned. -
-
Procedure: resource-pool-destroyed-error-pool obj
+
+
Procedure: resource-pool-destroyed-error-pool obj

Undocumented procedure.

@@ -639,8 +539,8 @@ available. Return the resource once PROC has returned. -
-
Procedure: resource-pool-destroyed-error? obj
+
+
Procedure: resource-pool-destroyed-error? obj

Undocumented procedure.

@@ -648,8 +548,8 @@ available. Return the resource once PROC has returned. -
-
Procedure: resource-pool-stats pool KEY: #:timeout
+
+
Procedure: resource-pool-stats _ KEY: #:timeout

Undocumented procedure.

@@ -657,8 +557,8 @@ available. Return the resource once PROC has returned. -
-
Procedure: resource-pool-timeout-error-pool obj
+
+
Procedure: resource-pool-timeout-error-pool obj

Undocumented procedure.

@@ -666,8 +566,8 @@ available. Return the resource once PROC has returned. -
-
Procedure: resource-pool-timeout-error? obj
+
+
Procedure: resource-pool-timeout-error? obj

Undocumented procedure.

@@ -675,8 +575,8 @@ available. Return the resource once PROC has returned. -
-
Procedure: resource-pool-too-many-waiters-error-pool obj
+
+
Procedure: resource-pool-too-many-waiters-error-pool obj

Undocumented procedure.

@@ -684,8 +584,8 @@ available. Return the resource once PROC has returned. -
-
Procedure: resource-pool-too-many-waiters-error-waiters-count obj
+
+
Procedure: resource-pool-too-many-waiters-error-waiters-count obj

Undocumented procedure.

@@ -693,8 +593,8 @@ available. Return the resource once PROC has returned. -
-
Procedure: resource-pool-too-many-waiters-error? obj
+
+
Procedure: resource-pool-too-many-waiters-error? obj

Undocumented procedure.

@@ -703,31 +603,16 @@ available. Return the resource once PROC has returned. -
- - - - - - - - - - - - - - - -
[ << ][ < ][ Up ][ > ][ >> ]         [Top][Contents][Index][ ? ]
-

1.5.4 Record Types

+
+
+

1.5.4 Record Types

-
-
Record type: &resource-pool-destroy-resource
+
+
Record type: &resource-pool-destroy-resource

This record type has the following fields:

-
    +
@@ -735,40 +620,36 @@ available. Return the resource once PROC has returned. -
-
Record type: &resource-pool-destroyed
+
+
Record type: &resource-pool-destroyed

This record type has the following fields:

-
    -
  • -pool
+
    +
  • pool
-
-
Record type: &resource-pool-timeout
+
+
Record type: &resource-pool-timeout

This record type has the following fields:

-
    -
  • -pool
+
    +
  • pool
-
-
Record type: &resource-pool-too-many-waiters
+
+
Record type: &resource-pool-too-many-waiters

This record type has the following fields:

-
    -
  • -pool
  • -waiters-count
+
    +
  • pool
  • waiters-count
@@ -778,51 +659,30 @@ available. Return the resource once PROC has returned.
- - - - - - - - - - - - - - - -
[ << ][ < ][ Up ][ > ][ >> ]         [Top][Contents][Index][ ? ]
- -

1.6 (knots thread-pool)

+
+
+
+
+

+Next: , Previous: , Up: API   [Contents][Index]

+
+

1.6 (knots thread-pool)

-
- - - - - - - - - - - - - - - -
[ << ][ < ][ Up ][ > ][ >> ]         [Top][Contents][Index][ ? ]
-

1.6.1 Macros

+ +
+

1.6.1 Macros

-
-
Macro: fixed-size-thread-pool-channel x
+
+
Macro: fixed-size-thread-pool-channel a

Undocumented macro.

@@ -830,8 +690,8 @@ available. Return the resource once PROC has returned. -
-
Macro: fixed-size-thread-pool-current-procedures x
+
+
Macro: fixed-size-thread-pool-current-procedures a

Undocumented macro.

@@ -839,8 +699,8 @@ available. Return the resource once PROC has returned. -
-
Macro: fixed-size-thread-pool? x
+
+
Macro: fixed-size-thread-pool? a

Undocumented macro.

@@ -848,8 +708,8 @@ available. Return the resource once PROC has returned. -
-
Macro: thread-pool-resource-pool x
+
+
Macro: thread-pool-resource-pool a

Undocumented macro.

@@ -857,8 +717,8 @@ available. Return the resource once PROC has returned. -
-
Macro: thread-pool? x
+
+
Macro: thread-pool? a

Undocumented macro.

@@ -867,28 +727,13 @@ available. Return the resource once PROC has returned. -
- - - - - - - - - - - - - - - -
[ << ][ < ][ Up ][ > ][ >> ]         [Top][Contents][Index][ ? ]
-

1.6.2 Procedures

+
+
+

1.6.2 Procedures

-
-
Procedure: call-with-thread thread-pool proc KEY: #:duration-logger #:checkout-timeout #:channel #:destroy-thread-on-exception? #:max-waiters
+
+
Procedure: call-with-thread _ _ KEY: #:duration-logger #:checkout-timeout #:channel #:destroy-thread-on-exception? #:max-waiters

Send PROC to the thread pool through CHANNEL. Return the result of PROC. If already in the thread pool, call PROC immediately.

@@ -897,8 +742,8 @@ PROC. If already in the thread pool, call PROC immediately. -
-
Procedure: destroy-thread-pool pool
+
+
Procedure: destroy-thread-pool a

Undocumented procedure.

@@ -906,8 +751,8 @@ PROC. If already in the thread pool, call PROC immediately. -
-
Procedure: make-fixed-size-thread-pool size KEY: #:thread-initializer #:thread-destructor #:delay-logger #:duration-logger #:thread-lifetime #:expire-on-exception? #:name #:use-default-io-waiters? #:default-checkout-timeout
+
+
Procedure: make-fixed-size-thread-pool _ KEY: #:thread-initializer #:thread-destructor #:delay-logger #:duration-logger #:thread-lifetime #:expire-on-exception? #:name #:use-default-io-waiters? #:default-checkout-timeout

Undocumented procedure.

@@ -915,8 +760,8 @@ PROC. If already in the thread pool, call PROC immediately. -
-
Procedure: make-thread-pool max-size KEY: #:min-size #:scheduler #:thread-initializer #:thread-destructor #:delay-logger #:duration-logger #:thread-lifetime #:expire-on-exception? #:name #:use-default-io-waiters? #:default-checkout-timeout
+
+
Procedure: make-thread-pool _ KEY: #:min-size #:scheduler #:thread-initializer #:thread-destructor #:delay-logger #:duration-logger #:thread-lifetime #:expire-on-exception? #:name #:use-default-io-waiters? #:default-checkout-timeout

Return a channel used to offload work to a dedicated thread. ARGS are the arguments of the thread pool procedure.

@@ -925,8 +770,8 @@ the arguments of the thread pool procedure. -
-
Procedure: set-thread-name name
+
+
Procedure: set-thread-name a

Set the name of the calling thread to NAME. NAME is truncated to 15 bytes.

@@ -935,8 +780,8 @@ bytes. -
-
Procedure: thread-name
+
+
Procedure: thread-name

Return the name of the calling thread as a string.

@@ -944,8 +789,8 @@ bytes. -
-
Procedure: thread-pool-arguments-parameter pool
+
+
Procedure: thread-pool-arguments-parameter a

Undocumented procedure.

@@ -953,8 +798,8 @@ bytes. -
-
Procedure: thread-pool-default-checkout-timeout pool
+
+
Procedure: thread-pool-default-checkout-timeout a

Undocumented procedure.

@@ -962,8 +807,8 @@ bytes. -
-
Procedure: thread-pool-timeout-error-pool obj
+
+
Procedure: thread-pool-timeout-error-pool obj

Undocumented procedure.

@@ -971,8 +816,8 @@ bytes. -
-
Procedure: thread-pool-timeout-error? obj
+
+
Procedure: thread-pool-timeout-error? obj

Undocumented procedure.

@@ -981,33 +826,17 @@ bytes. -
- - - - - - - - - - - - - - - -
[ << ][ < ][ Up ][ > ][ >> ]         [Top][Contents][Index][ ? ]
-

1.6.3 Record Types

+
+
+

1.6.3 Record Types

-
-
Record type: &thread-pool-timeout-error
+
+
Record type: &thread-pool-timeout-error

This record type has the following fields:

-
    -
  • -pool
+
    +
  • pool
@@ -1017,51 +846,29 @@ bytes.
- - - - - - - - - - - - - - - -
[ << ][ < ][ Up ][ > ][ >> ]         [Top][Contents][Index][ ? ]
- -

1.7 (knots timeout)

+
+
+
+
+

+Next: , Previous: , Up: API   [Contents][Index]

+
+

1.7 (knots timeout)

-
- - - - - - - - - - - - - - - -
[ << ][ < ][ Up ][ > ][ >> ]         [Top][Contents][Index][ ? ]
-

1.7.1 Procedures

+ +
+

1.7.1 Procedures

-
-
Procedure: port-read-timeout-error? obj
+
+
Procedure: port-read-timeout-error? obj

Undocumented procedure.

@@ -1069,8 +876,8 @@ bytes. -
-
Procedure: port-timeout-error? obj
+
+
Procedure: port-timeout-error? obj

Undocumented procedure.

@@ -1078,8 +885,8 @@ bytes. -
-
Procedure: port-write-timeout-error? obj
+
+
Procedure: port-write-timeout-error? obj

Undocumented procedure.

@@ -1087,8 +894,8 @@ bytes. -
-
Procedure: wait-until-port-readable-operation port
+
+
Procedure: wait-until-port-readable-operation a

Make an operation that will succeed when PORT is readable.

@@ -1096,8 +903,8 @@ bytes. -
-
Procedure: wait-until-port-writable-operation port
+
+
Procedure: wait-until-port-writable-operation a

Make an operation that will succeed when PORT is writable.

@@ -1105,8 +912,8 @@ bytes. -
-
Procedure: with-fibers-timeout thunk KEY: #:timeout #:on-timeout
+
+
Procedure: with-fibers-timeout _ KEY: #:timeout #:on-timeout

Undocumented procedure.

@@ -1114,8 +921,8 @@ bytes. -
-
Procedure: with-port-timeouts thunk KEY: #:timeout #:read-timeout #:write-timeout
+
+
Procedure: with-port-timeouts _ KEY: #:timeout #:read-timeout #:write-timeout

Undocumented procedure.

@@ -1124,62 +931,41 @@ bytes. -
- - - - - - - - - - - - - - - -
[ << ][ < ][ Up ][ > ][ >> ]         [Top][Contents][Index][ ? ]
-

1.7.2 Record Types

+
+
+

1.7.2 Record Types

-
-
Record type: &port-read-timeout-error
+
+
Record type: &port-read-timeout-error

This record type has the following fields:

-
    -
  • -thunk
  • -port
+
    +
  • thunk
  • port
-
-
Record type: &port-timeout-error
+
+
Record type: &port-timeout-error

This record type has the following fields:

-
    -
  • -thunk
  • -port
+
    +
  • thunk
  • port
-
-
Record type: &port-write-timeout-error
+
+
Record type: &port-write-timeout-error

This record type has the following fields:

-
    -
  • -thunk
  • -port
+
    +
  • thunk
  • port
@@ -1189,51 +975,30 @@ bytes.
- - - - - - - - - - - - - - - -
[ << ][ < ][ Up ][ > ][ >> ]         [Top][Contents][Index][ ? ]
- -

1.8 (knots web-server)

+
+
+
+
+

+Previous: , Up: API   [Contents][Index]

+
+

1.8 (knots web-server)

-
- - - - - - - - - - - - - - - -
[ << ][ < ][ Up ][ > ][ >> ]         [Top][Contents][Index][ ? ]
-

1.8.1 Macros

+ +
+

1.8.1 Macros

-
-
Macro: web-server-port x
+
+
Macro: web-server-port a

Undocumented macro.

@@ -1241,8 +1006,8 @@ bytes. -
-
Macro: web-server-socket x
+
+
Macro: web-server-socket a

Undocumented macro.

@@ -1250,8 +1015,8 @@ bytes. -
-
Macro: web-server? x
+
+
Macro: web-server? a

Undocumented macro.

@@ -1260,28 +1025,13 @@ bytes. -
- - - - - - - - - - - - - - - -
[ << ][ < ][ Up ][ > ][ >> ]         [Top][Contents][Index][ ? ]
-

1.8.2 Procedures

+
+
+

1.8.2 Procedures

-
-
Procedure: default-write-response-exception-handler exn request
+
+
Procedure: default-write-response-exception-handler a b

Undocumented procedure.

@@ -1289,8 +1039,8 @@ bytes. -
-
Procedure: make-chunked-output-port/knots port KEY: #:keep-alive? #:buffering
+
+
Procedure: make-chunked-output-port/knots _ KEY: #:keep-alive? #:buffering

Returns a new port which translates non-encoded data into a HTTP chunked transfer encoded data and writes this to PORT. Data written to this port is buffered until the port is flushed, at which point it is all @@ -1305,8 +1055,8 @@ true. -

-
Procedure: read-request-body/knots r
+
+
Procedure: read-request-body/knots a

Undocumented procedure.

@@ -1314,8 +1064,8 @@ true. -
-
Procedure: request-body-ended-prematurely-error? obj
+
+
Procedure: request-body-ended-prematurely-error? obj

Undocumented procedure.

@@ -1323,8 +1073,8 @@ true. -
-
Procedure: request-body-port/knots r
+
+
Procedure: request-body-port/knots a

Undocumented procedure.

@@ -1332,8 +1082,8 @@ true. -
-
Procedure: run-knots-web-server handler KEY: #:host #:family #:addr #:port #:socket #:read-request-exception-handler #:write-response-exception-handler #:connection-idle-timeout #:connection-buffer-size
+
+
Procedure: run-knots-web-server _ KEY: #:host #:family #:addr #:port #:socket #:read-request-exception-handler #:write-response-exception-handler #:connection-idle-timeout #:connection-buffer-size

Run the knots web server.

HANDLER should be a procedure that takes one argument, the HTTP request @@ -1342,7 +1092,7 @@ and returns two values, the response and response body.

For example, here is a simple "Hello, World!" server:

-
 (define (handler request)
+
 (define (handler request)
    (let ((body (read-request-body request)))
      (values '((content-type . (text/plain)))
              "Hello, World!")))
@@ -1357,8 +1107,8 @@ sending back to the client.
 
 
 
-

-
Procedure: sanitize-response request response body

+

+
Procedure: sanitize-response a b c

 
"Sanitize" the given response and body, making them appropriate for the
 given request.
 

@@ -1381,33 +1131,17 @@ procedure being called at any particular time.
 
 
 
-

-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
[ << ][ < ][ Up ][ > ][ >> ]            [Top][Contents][Index][ ? ]

-
1.8.3 Record Types

+
+
+

1.8.3 Record Types

-
-
Record type: &request-body-ended-prematurely
+
+
Record type: &request-body-ended-prematurely

This record type has the following fields:

-
    -
  • -bytes-read
+
    +
  • bytes-read
@@ -1415,123 +1149,258 @@ procedure being called at any particular time. -
- - - - - - -
[Top][Contents][Index][ ? ]
-

About This Document

-

- This document was generated on June 24, 2025 using texi2html 5.0. -

-

- The buttons in the navigation panels have the following meaning: -

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Button Name Go to From 1.2.3 go to
[ << ] FastBackBeginning of this chapter or previous chapter1
[ < ] BackPrevious section in reading order1.2.2
[ Up ] UpUp section1.2
[ > ] ForwardNext section in reading order1.2.4
[ >> ] FastForwardNext chapter2
[Top] TopCover (top) of document  
[Contents] ContentsTable of contents  
[Index] IndexIndex  
[ ? ] AboutAbout (help)  
-

- where the Example assumes that the current position is at Subsubsection One-Two-Three of a document of the following structure: -

- -
    -
  • 1. Section One -
      -
    • 1.1 Subsection One-One -
        -
      • ...
        • -
      -
      • -
    • 1.2 Subsection One-Two -
        -
      • 1.2.1 Subsubsection One-Two-One
        • -
      • 1.2.2 Subsubsection One-Two-Two
        • -
      • 1.2.3 Subsubsection One-Two-Three     - <== Current Position
        • -
      • 1.2.4 Subsubsection One-Two-Four
        • -
      -
      • -
    • 1.3 Subsection One-Three -
        -
      • ...
        • -
      -
      • -
    • 1.4 Subsection One-Four
      • -
    -
    • -
+
+
+
+
+

- - This document was generated on June 24, 2025 using texi2html 5.0. - -
+Next: , Previous: , Up: Overview   [Contents][Index]

+
+

Appendix A Version History

+
+
Version 0.Y.0, Month DD, 20YY
+
    +
  • No initial release has yet been made. +
+ +
+
+ + + +
+
+
+
+

+Next: , Previous: , Up: Overview   [Contents][Index]

+
+

Appendix B Copying Information

+ +

Copyright © 2024, 2025 Christopher Baines <mail@cbaines.net>

+

This library is free software; you can redistribute it and/or modify +it under the terms of the GNU Lesser General Public License as +published by the Free Software Foundation; either version 3 of the +License, or (at your option) any later version. +

+ + + +
+
+
+
+

+Next: , Previous: , Up: Overview   [Contents][Index]

+
+

Concept Index

+ + + +
+
+ +
+
+

+Next: , Previous: , Up: Overview   [Contents][Index]

+
+

Procedure Index

+ +
+
Jump to:   C +   +D +   +F +   +M +   +N +   +P +   +R +   +S +   +T +   +W +   +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Index EntrySection
C
call-with-resource-from-poolknots_resource-pool
call-with-threadknots_thread-pool
D
default-write-response-exception-handlerknots_web-server
destroy-resource-poolknots_resource-pool
destroy-thread-poolknots_thread-pool
F
fiberizeknots_parallelism
fibers-batch-for-eachknots_parallelism
fibers-batch-mapknots_parallelism
fibers-delayknots_promise
fibers-for-eachknots_parallelism
fibers-forceknots_promise
fibers-letknots_parallelism
fibers-mapknots_parallelism
fibers-map-with-progressknots_parallelism
fibers-parallelknots_parallelism
fibers-promise-resetknots_promise
fibers-promise-result-available?knots_promise
fibers-promise?knots_promise
fixed-size-thread-pool-channelknots_thread-pool
fixed-size-thread-pool-current-proceduresknots_thread-pool
fixed-size-thread-pool?knots_thread-pool
M
make-chunked-output-port/knotsknots_web-server
make-fixed-size-thread-poolknots_thread-pool
make-resource-poolknots_resource-pool
make-resource-pool-destroy-resource-exceptionknots_resource-pool
make-thread-poolknots_thread-pool
N
non-blocking-open-socket-for-uriknots_non-blocking
non-blocking-portknots_non-blocking
P
port-read-timeout-error?knots_timeout
port-timeout-error?knots_timeout
port-write-timeout-error?knots_timeout
R
read-request-body/knotsknots_web-server
request-body-ended-prematurely-error?knots_web-server
request-body-port/knotsknots_web-server
resource-pool-channelknots_resource-pool
resource-pool-configurationknots_resource-pool
resource-pool-destroy-resource-exception?knots_resource-pool
resource-pool-destroyed-error-poolknots_resource-pool
resource-pool-destroyed-error?knots_resource-pool
resource-pool-nameknots_resource-pool
resource-pool-statsknots_resource-pool
resource-pool-timeout-error-poolknots_resource-pool
resource-pool-timeout-error?knots_resource-pool
resource-pool-too-many-waiters-error-poolknots_resource-pool
resource-pool-too-many-waiters-error-waiters-countknots_resource-pool
resource-pool-too-many-waiters-error?knots_resource-pool
resource-pool?knots_resource-pool
run-knots-web-serverknots_web-server
S
sanitize-responseknots_web-server
set-thread-nameknots_thread-pool
spawn-queueing-fiberknots_queue
T
thread-nameknots_thread-pool
thread-pool-arguments-parameterknots_thread-pool
thread-pool-default-checkout-timeoutknots_thread-pool
thread-pool-resource-poolknots_thread-pool
thread-pool-timeout-error-poolknots_thread-pool
thread-pool-timeout-error?knots_thread-pool
thread-pool?knots_thread-pool
W
wait-until-port-readable-operationknots_timeout
wait-until-port-writable-operationknots_timeout
web-server-portknots_web-server
web-server-socketknots_web-server
web-server?knots_web-server
with-fibers-timeoutknots_timeout
with-port-timeoutsknots_timeout
with-resource-from-poolknots_resource-pool
+
Jump to:   C +   +D +   +F +   +M +   +N +   +P +   +R +   +S +   +T +   +W +   +
+
+ + +
+
+
+
+

+Previous: , Up: Overview   [Contents][Index]

+
+

Variable Index

+ +
+ + + + + + +
Index EntrySection
R
resource-pool-default-timeout-handlerknots_resource-pool
+
+ + +
+
+ + +