X-Git-Url: https://ruderich.org/simon/gitweb/?a=blobdiff_plain;f=README.adoc;h=7df94dc4e9da07577cb4f9ffee0a89c8a39be04e;hb=367edc1286a52d96fcfef6f98330148cad8a64e1;hp=f120694f97abdfe5adbc728996efccee8d7be8b0;hpb=583a2695a3ddc9c98e0a03d9f1bad8df30afe887;p=safcm%2Fsafcm.git diff --git a/README.adoc b/README.adoc index f120694..7df94dc 100644 --- a/README.adoc +++ b/README.adoc @@ -43,9 +43,9 @@ contains the files, packages, services and commands which should be applied to all hosts which are members of this group. The configuration of all managed hosts is stored in a directory on the local -host. Safcm uses https://yaml.org/[YAML] for all configuration files. However, -tasks like copying a file require no explicit configuration (see the -documentation for details). +host. Safcm uses https://yaml.org/[YAML] for all configuration files for its +natural syntax. Strict type checks prevent potential pitfalls of more complex +YAML syntax. Tasks like copying a file require no explicit configuration. Files consist of a tree of files (regular files and symbolic links) and directories with permissions, user/group and content. Files can use @@ -63,7 +63,7 @@ Commands are appended so that the same command can be executed multiple times. To sync the configuration to a remote host the local `safcm` binary connects to it via `ssh`. It then copies a _remote helper_ binary to `/tmp` on the remote host to later perform the actual sync. If the remote helper is already -present, has the proper checksum, permissions and user then the copy is +present, has the proper checksum, permissions and user/group then the copy is skipped. `safcm` then queries the remote host for information, including operating system, architecture and detected groups. With all relevant data collected it assigns the host its groups, evaluates the configuration @@ -135,6 +135,7 @@ future, others are due to the design of safcm. ** GNU/Linux with common commands (`uname`, `id`, `stat`, `sha512sum`, `cat`, `mktemp`, `rm`, `ln`, `chmod`) ** FreeBSD (same commands, but uses `sha512`) + ** OpenBSD (same commands, but uses `sha512`) * SSH server * to install packages: ** `apt-get` (Debian or derivative)