Skip to content
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.

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

Grammar + Typo in syncing-overview.md for docs #1333

Merged
merged 5 commits into from
Apr 30, 2024
Merged
Changes from all commits
Commits
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
12 changes: 6 additions & 6 deletions docs/introduction/syncing-overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ NOTE: Synchronization is now performed by its own agent, the `santasyncservice`.
The phases of synchronization described below still apply, but references to how
the process starts is outdated. This will be updated soon.

This is a high level overview of the syncing process. For a more a more detailed
This is a high level overview of the syncing process. For a more detailed
account of each part, see the respective documentation. The santaclt binary can
be run in one of two modes, daemon and non-daemon. The non-daemon mode does one
full sync and exits. This is the typical way a user will interact with Santa,
Expand All @@ -29,8 +29,8 @@ syncs, listen for push notifications and upload events.

1. When the santad process starts up, it looks for a `SyncBaseURL` key/value in
the config. If one exists it will `fork()` and `execve()` `santactl sync
—-daemon`. Before the new process calls `execve()`, all privileges are
dropped. All privileged actions are then restricted to the XPC interface
—-daemon`. All privileges are dropped before the new process calls `execve()`.
All privileged actions are then restricted to the XPC interface
made available to santactl by santad. Since this santactl process is running
as a daemon it too exports an XPC interface so santad can interact with the
process efficiently and securely. To ensure syncing reliability santad will
Expand All @@ -51,8 +51,8 @@ syncs, listen for push notifications and upload events.
2. Firebase Cloud Messaging (FCM) can be used*. The sync server can send
down a configuration in the preflight to have the santactl daemon to
start listening for FCM messages. If a connection to FCM is made, the
full sync interval drops to a default of 4 hours. This can be further
configured by a preflight configuration. The FCM connection allows the
full sync interval drops to a default of 4 hours. A preflight configuration can override this.
The FCM connection allows the
sync-sever to talk directly with Santa. This way we can reduce polling
the sync server dramatically.
5. Full syncs will continue to take place at their configured interval. If
Expand All @@ -65,5 +65,5 @@ syncs, listen for push notifications and upload events.
When running as a daemon, the santactl process makes available an XPC interface
for use by santad. This allows santad to send blocked binary or bundle events
directly to santactl for immediate upload to the sync-server, enabling a
smoother user experience. The binary that was blocked on macOS is immediately
smoother user experience. The binary blocked on macOS is immediately
available for viewing or handling on the sync-server.
Loading