Services, was: Re: XWayland, /tmp/.X11-unix

[Thorsten Wilms]

On 30.03.2018 06:34, Chris Marusich wrote:
> I hope to eventually go back and improve the services
> documentation further in the manual, once I feel I have a strong enough
> grasp of how it all works.

A few thoughts then, that I hope will be of use:

Initially, I had a hard time understanding the talk about "extending", 
as the first snippets I looked at seemed rather like adding items to 
todo-lists. The 2nd paragraph on 
https://www.gnu.org/software/guix/manual/html_node/Service-Composition.html 
makes it clear.

So it appears to me that the core of this is that there are daemons and 
procedures that attain and control capabilities. Since there may be any 
number of things-to-do dependent on operating-system configuration, 
requiring access to those capabilities, a DAG is constructed and 
flattened to arrive at daemon configuration and executable procedures.

One aspect that makes reading the docs hard are the multiple meanings of 
"service" and the rather unspecific "service type", I think. Makes one 
think of Smurfs. In fairness: it seems hard to avoid ... maybe:
Could we try to reserve a naked "service" to refer to daemons and 
procedures with effects on the operating system? The things that go into 
operating-system/services are ... service-building-blocks, latent 
services, service-parts, proto-services ... OK; not terribly satisfying.

It is mentioned that service types are the nodes in the services DAG. 
Thus they could have been called service-nodes, which would have avoided 
confusion with those other *types* of services: ... printing s., desktop 
s., database s. ... .

Here I notice that I don't quite get how service-types wrapped in 
services in a list of services map to a DAG.


I see 2 main uses cases regarding the documentation:
A. Trying to understand the whole system.
B. Trying to accomplish a specific task and looking for just the 
required information.

The given descriptive nature of the documentation so far is alright for 
A. To serve B, you'd have to work along questions like:
- Is what I'm trying to accomplish within the scope of services? What 
are their capabilities and limitations? (A case like adding files to 
/etc might not come to everyone's mind.)
- What is the nature of what I'm tying to do, regarding time of 
execution, capabilities, dependencies and permissions? Here an overview 
of what service-type allows what?, when?, would shine.


--
Thorsten Wilms

thorwil's design for free software:
http://thorwil.wordpress.com/