Purpose

• A high level light weight document to explain client syncing timers/schedulers
• This document is not intended as guide for planning or development. It is also not intended to detail programming code.
• This page is a 'Living Document.' It will change. It is intended to reflect functionality of production Sync servers and Sync client on mozilla-central. As such, it will need to be maintained to keep up with functional changes as they occur.

Questions and Comments

• Please feel free to add information requests inline (or fill gaps yourself)
• If you have questions or comments regarding this document, contact:

 Tracy Walker
 twalker@mozilla.com
 irc: tracy

Instant Sync Triggers

Bookmarks

The following activities will cause a sync to be triggered instantly (100ms after triggering activity is compete)

• Add a new bookmark
• Delete a bookmark
• alter a bookmark

Passwords

The following activities will cause a sync to be triggered instantly (100ms after triggering activity is compete)

• Add a new password
• Delete a password
• update a password

Notes for instant syncs:

• Instant syncs will set the next scheduled timer per possible configurations below.

Sync Client Timers and Schedulers

The Sync client has a configuration, found in about:config, that controls "how often" syncs are triggered. Below is that configuration and how it affects Syncs timing behavior.

services.sync.scheduler.activeInterval

• value = 600 seconds (10 minutes)
• value may be edited to a custom value of choice

services.sync.syncInterval

• value = 600 seconds (10 minutes)
• client behavior - If the user is active (meaning user is browsing, but not triggering instant syncs or crossing score threshold), then next sync will occur in 10 minutes

services.sync.syncThreshold

Notes

• Returning from idle will trigger an instant sync.