File: README

package info (click to toggle)
deets 0.3.2-1
  • links: PTS
  • area: main
  • in suites: bookworm, forky, sid, trixie
  • size: 492 kB
  • sloc: sh: 1,256; ansic: 387; makefile: 17
file content (44 lines) | stat: -rw-r--r-- 1,360 bytes parent folder | download | duplicates (7)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
This file is meant to be helpful in the absence of proper documentation.

Depending on your needs, you can either start your config from scratch
or use deets to take inventory:

	luau --no-audit /usr/share/deets/inventory.lua > /tmp/model.lua

This will generate a config file based on the state of your system's
packages and conffiles.  You can then audit your system using that
config like this:

	luau /tmp/model.lua

Sample output:

	Audit: 421/421 (100.00%) conformant

Let's say that you then purge the subversion package and rerun.

	Audit: 416/421 (98.81%) conformant

Deets is telling you that your system is not in full conformance
with the model.  The missing 1.19% comprises 1 package (subversion)
and 4 conffiles.  To get more information about this, you can run

	luau --no-audit --report /tmp/model.lua

This will output the commands that would be executed if you were to
demand rectification in this manner:

	sudo luau --no-audit --rectify /tmp/model.lua

If you are interested in seeing the dependency ordering, you can
run

	luau --no-audit --dep-trace /tmp/model.lua

and this will show you the sequence which will be taken by
audit/report/rectify.

For a more informative config, examine /usr/share/deets/example.lua
to see examples of using templating and explicit dependencies.

Assistance with better code and documentation is welcome.