Skip to content

CFE-3275: Documented where report_diffs stores its cached copies #3764

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
nickanderson wants to merge 1 commit into
base: master
Choose a base branch
from
Open

CFE-3275: Documented where report_diffs stores its cached copies #3764

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 13 additions & 0 deletions content/reference/promise-types/files/_index.markdown
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -745,6 +745,13 @@ system files, you should keep a single repository for them and use CFEngine to
synchronize changes from the repository source. Repositories should not be
used to attempt to capture random changes of the system.

To produce a diff, the agent keeps its own copy of each monitored file to
compare the next run against. These copies are kept in a tree under
`$(sys.statedir)/change_details` that mirrors the path of the monitored file,
so the copy of `/etc/ssh/sshd_config` is
`/var/cfengine/state/change_details/etc/ssh/sshd_config`. The location is not
configurable, and `repository` does not change it.

**Limitations:**
Diffs will not be reported for files that are larger than 80MB in size.
Diffs will not be reported if the number of lines between the first and last change exceed 4500.
Expand All @@ -761,6 +768,12 @@ body changes example
}
```

**History:** Before 3.29.0 the copies were kept next to the monitored file as
`<file>_cfchanges`, or under `repository` if one was configured. On the first
run after an upgrade the copy is moved from either location to
`$(sys.statedir)/change_details`, so no baseline is lost and nothing is left
behind.

#### silence

**Description:** The `silence` attribute lists the categories of file change
Expand Down
Loading