link

Purpose: ensure a symbolic link at path points to target — or is absent.

Synopsis

- id: vimrc
  type: link
  with:
    path: /etc/vim/vimrc.local
    target: /opt/myapp/vimrc.local

Parameter	Required	Type	Default	Description
`path`	yes	string (absolute path)	—	Symlink path.
`target`	when `present`	string	—	Link target. Required when `state` is `present`.
`state`	no	string	`present`	`present` or `absent`.

present: creates the symlink if absent, or re-points an existing symlink whose target differs.
absent: removes the symlink. Refuses to remove non-symlink objects as a link.
A symlink that really changes a systemd manager input (a unit file, drop-in, alias/mask/.wants/.requires link, or system.conf) makes Sinter run systemctl daemon-reload automatically before the next service or handler that needs it, and at the end of a successful apply. See service.

Fully idempotent — a symlink already pointing at target is left alone.

path is an existing non-symlink (file, directory) → failure; Sinter will not replace it implicitly.
Unexpected symlinks in the parent path are rejected before mutation.

Applies to all supported targets.