Part II. Extensions and Libraries

Table of Contents

1. System building

1.1. Introduction

1.2. System definition files

1.3. Practical examples

1.4. ASDF Reference

asdf:make-build — Block-build an ASDF system definition

asdf:load-fasl-op — Compile and load one ore more libraries using unified FASL

2. Operating System Interface

2.1. Processes

2.2. Command line arguments

2.3. OS Reference

3. Foreign Function Interface

3.1. What is a FFI?

3.2. Two kinds of FFI

3.3. Foreign objects

3.4. Higher level interfaces

3.4.1. UFFI example

3.4.2. CFFI example

3.4.3. Low level example

3.5. FFI Reference

ffi:clines — Insert C declarations and definitions

ffi:c-inline — Inline C code in a lisp form.

4. Multithreading

4.1. Tasks, threads or processes

4.2. Multithreading Reference

mp:all-processes — Return the list of active processes.

mp:exit-process — Exit the task from which it is invoked.

mp:interrupt-process — Interrupt a task.

mp:get-lock — Try to obtain a lock.

mp:giveup-lock — Release a lock we have obtained before.

mp:make-lock — Create a new lock.

mp:make-process — Create a new thread.

mp:process-active-p — Determine whether a task is running.

mp:process-enable — Start up a task which was not running.

mp:process-kill — Try to stop a running task.

mp:process-name — Return the name of a task.

mp:process-preset — Associate a function to a process.

mp:process-run-function — Create a task and execute a function in it.

mp:with-lock — Synchronize a piece of code between different tasks.

5. Memory Management

5.1. Introduction

5.2. Boehm-Weiser garbage collector

5.3. Memory limits

5.4. Memory Conditions

5.5. Finalization

5.6. Memory Management Reference

ext:stack-overflow — Stack overflow condition.

ext:storage-exhausted — Memory overflow condition.

ext:get-finalizer — Return finalizer associated to an object.

ext:get-limit — Query a memory or stack limit.

ext:set-finalizer — Associate a finalizer to an object.

ext:set-limit — Set a memory or stack limit.

6. Meta-Object Protocol (MOP)

6.1. Introduction

6.2. Classes

6.3. Slots

6.4. Generic functions and methods

6.5. Sealed slots and classes

7. Signals and interrupts

7.1. Problems associated to signals

7.2. Kinds of signals

7.2.1. Synchronous signals

7.2.2. Asynchronous signals

7.3. Signals and interrupts in ECL

7.3.1. Handling of asynchronous signals

7.3.2. Handling of synchronous signals

7.4. Considerations when embedding ECL

7.5. Signals Reference

ext:with-interrupts — Execute code with interrupts optionally enabled.

ext:without-interrupts — Execute code without being interrupted.

8. Embedding ECL

8.1. Introduction

8.2. Embedding Reference

CL_CATCH_ALL — Create a protected region.

CL_UNWIND_PROTECT — Create a protected region.

cl_boot — Setup the lisp environment.

cl_shutdown — Close the lisp environment.

ecl_set_option — Set a boot option.

ecl_get_option — Read the value of a boot option.

ecl_clear_interrupts — Clear all pending signals and exceptions.

ecl_disable_interrupts — Postpone handling of signals and exceptions.

ecl_enable_interrupts — Activate handling of signals and exceptions.