More manual
This commit is contained in:
parent
9277c59f18
commit
c7e2abe1fb
|
@ -12,12 +12,13 @@
|
||||||
|
|
||||||
- [System overview](./operation/index.md)
|
- [System overview](./operation/index.md)
|
||||||
- [The System Bus: syndicate-server](./operation/system-bus.md)
|
- [The System Bus: syndicate-server](./operation/system-bus.md)
|
||||||
- [Bus scripting language](./operation/scripting.md)
|
- [Services and service dependencies](./operation/service.md)
|
||||||
- [Built-in services and service classes](./operation/builtin/index.md)
|
- [Built-in services and service classes](./operation/builtin/index.md)
|
||||||
- [Gatekeeper](./operation/builtin/gatekeeper.md)
|
- [Gatekeeper](./operation/builtin/gatekeeper.md)
|
||||||
- [TCP/IP and Unix-socket Transports](./operation/builtin/relay-listener.md)
|
- [TCP/IP and Unix-socket Transports](./operation/builtin/relay-listener.md)
|
||||||
- [Configuration watcher](./operation/builtin/config-watcher.md)
|
- [Configuration watcher](./operation/builtin/config-watcher.md)
|
||||||
- [Process supervision and management](./operation/builtin/daemon.md)
|
- [Daemons and external programs](./operation/builtin/daemon.md)
|
||||||
|
- [Configuration scripting language](./operation/scripting.md)
|
||||||
- [Configuration files and directories]()
|
- [Configuration files and directories]()
|
||||||
- [The boot layer]()
|
- [The boot layer]()
|
||||||
- [Logging]()
|
- [Logging]()
|
||||||
|
|
|
@ -3,9 +3,9 @@
|
||||||
## Actor
|
## Actor
|
||||||
## Assertion
|
## Assertion
|
||||||
## Attenuation
|
## Attenuation
|
||||||
## Bus Scripting Language
|
|
||||||
## Capability
|
## Capability
|
||||||
## Compositional
|
## Compositional
|
||||||
|
## Configuration Scripting Language
|
||||||
## Conversational State
|
## Conversational State
|
||||||
## Dataspace
|
## Dataspace
|
||||||
## E
|
## E
|
||||||
|
|
|
@ -1 +1,3 @@
|
||||||
# Built-in services and service classes
|
# Built-in services and service classes
|
||||||
|
|
||||||
|
The `syndicate-server` program
|
||||||
|
|
|
@ -7,7 +7,6 @@ tree](../glossary.md#supervision-tree), conceptually rooted at the [system
|
||||||
bus](./system-bus.md) (NB. not at PID 1).
|
bus](./system-bus.md) (NB. not at PID 1).
|
||||||
|
|
||||||
```ditaa system-supervision-tree
|
```ditaa system-supervision-tree
|
||||||
(Example)
|
|
||||||
+----------------------------------+
|
+----------------------------------+
|
||||||
|Root System Bus (syndicate–server)|
|
|Root System Bus (syndicate–server)|
|
||||||
+----------------+-----------------+
|
+----------------+-----------------+
|
||||||
|
|
|
@ -1 +1 @@
|
||||||
# Bus scripting language
|
# Configuration scripting language
|
||||||
|
|
|
@ -0,0 +1 @@
|
||||||
|
# Services and service dependencies
|
|
@ -6,26 +6,36 @@
|
||||||
The `syndicate-server` program has a number of closely-related functions. In many ways, it is a
|
The `syndicate-server` program has a number of closely-related functions. In many ways, it is a
|
||||||
reification of the [system layer concept](../glossary.md#system-layer) itself.
|
reification of the [system layer concept](../glossary.md#system-layer) itself.
|
||||||
|
|
||||||
1. It provides a root **system bus** service for use by other programs. In this way, it is
|
It provides:
|
||||||
|
|
||||||
|
1. A **[root system bus](#the-root-system-bus)** service for use by other programs. In this way, it is
|
||||||
analogous to D-Bus.
|
analogous to D-Bus.
|
||||||
|
|
||||||
2. It provides a [**gatekeeper** service](./builtin/gatekeeper.md), for exposing
|
2. A general-purpose **[service dependency tracking facility](./service.md)**.
|
||||||
|
|
||||||
|
3. A [**gatekeeper** service](./builtin/gatekeeper.md), for exposing
|
||||||
[capabilities](../glossary.md#capability) to running objects as (potentially long-lived)
|
[capabilities](../glossary.md#capability) to running objects as (potentially long-lived)
|
||||||
[macaroon](../glossary.md#macaroon)-style "sturdy references", plus TCP/IP- and
|
[macaroon](../glossary.md#macaroon)-style "sturdy references", plus TCP/IP- and
|
||||||
Unix-socket-based **[transports](./builtin/relay-listener.md)** for accessing capabilities
|
Unix-socket-based **[transports](./builtin/relay-listener.md)** for accessing capabilities
|
||||||
through the gatekeeper.
|
through the gatekeeper.
|
||||||
|
|
||||||
3. It provides a limited **[configuration scripting language](./scripting.md)** suitable for
|
4. A limited **[configuration scripting language](./scripting.md)** suitable for
|
||||||
programming [dataspaces](../glossary.md#dataspace) with simple reactive behaviours.
|
programming [dataspaces](../glossary.md#dataspace) with simple reactive behaviours.
|
||||||
|
|
||||||
4. It provides an [`inotify`](https://en.wikipedia.org/wiki/Inotify)-based **[configuration
|
5. An [`inotify`](https://en.wikipedia.org/wiki/Inotify)-based **[configuration
|
||||||
loader](./builtin/config-watcher.md)** which loads and executes configuration files written
|
loader](./builtin/config-watcher.md)** which loads and executes configuration files written
|
||||||
in the scripting language.
|
in the scripting language.
|
||||||
|
|
||||||
5. It provides [**process supervision** and **dependency tracking**](./builtin/daemon.md)
|
6. [**Process startup and supervision**](./builtin/daemon.md)
|
||||||
services for starting other programs.
|
services for running external programs.
|
||||||
|
|
||||||
## The main system bus
|
The program can also be used as an "inferior" bus. For example, there may be a per-user bus, or
|
||||||
|
a per-session bus, or both. Each bus would appropriately scope the lifetime of its supervised
|
||||||
|
processes.
|
||||||
|
|
||||||
|
Finally, it can be used completely standalone, outside a Synit context.
|
||||||
|
|
||||||
|
## The root system bus
|
||||||
|
|
||||||
The [`synit-pid1`](./index.md#sbinsynit-pid1) program invokes `syndicate-server` like this:
|
The [`synit-pid1`](./index.md#sbinsynit-pid1) program invokes `syndicate-server` like this:
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue