Задание GoodSync в командной строке (GSYNC)

Вернуться к началу

Справочник по командной строке GSYNC

GSYNC — это версия GoodSync для командной строки. Ее можно использовать в пакетных файлах, скриптах, средствах автоматизации и в средах Linux.

GSYNC не отображает графический интерфейс GoodSync и остается открытым до завершения запрошенного задания или действия. В Windows и на Mac для GSYNC требуется лицензия GoodSync Personal или выше.

Общий формат команды:

gsync [profile-options] [run-options] [global-options] global-command | job-command

GSYNC выполняет задания последовательно, в том порядке, в котором они расположены в списке заданий.

Журнал выводится в stdout, если вывод не перенаправлен.

gsync /runner воспроизводит поведение графического интерфейса GoodSync для автоматических заданий:

  • Запускает и выполняет все задания, находящиеся в режиме Авто, например задания «При изменении файла».
  • Не отображает графический интерфейс. Результаты заданий доступны в глобальном журнале и в журналах заданий.
  • Не использует графические ресурсы, так как работает как процесс командной строки.
  • Чтобы остановить GSYNC Runner, отправьте CTRL+C в его консоль.
  • Если параметр /runner не указан, действуют обычные параметры GSYNC.

gsync /? или gsync /help — выводит список всех команд GSYNC.

На этой странице

Выберите раздел ниже, чтобы перейти к соответствующим сведениям о командной строке.

Начало работы

Глобальные команды и параметры

Команды и параметры заданий

Продвинутые настройки

Автоматизация и поддержка

Быстрый старт GSYNC

Следующий порядок действий позволяет проверить работу GSYNC, найти существующее задание, просмотреть предлагаемые им изменения и затем запустить его.

Прежде чем начать: убедитесь, что GoodSync установлен и лицензирован, и откройте Командную строку, PowerShell, Терминал или другую удобную вам командную оболочку.

  1. Проверьте установленную версию GoodSync и лицензию:
    gsync /version
  2. Выведите список заданий, доступных в активном профиле GoodSync:
    gsync job-list
  3. Выполните анализ задания, чтобы просмотреть предлагаемые изменения:
    gsync analyze "Job Name"
  4. Просмотрев результаты анализа, запустите задание:
    gsync sync "Job Name"

Важно: перед первой синхронизацией выполните анализ и просмотрите предлагаемые изменения, особенно если задание допускает удаления, использует режим перемещения или работает в одном направлении.

Руководство по синтаксису команд

В GSYNC параметры необходимо указывать в правильном порядке. Сначала идут параметры профиля, затем параметры запуска, глобальные параметры, команда и относящиеся к ней параметры задания.

gsync [profile-options] [run-options] [global-options] job-command [job-options]

Для глобальной команды, которая не запускает задание, используйте:

gsync [profile-options] global-command

Обозначение Значение
<value> Замените этот заполнитель фактическим значением.
[option] Параметр необязателен.
yes|no Выберите одно из доступных значений.
Суффикс 1 или 2 Используйте 1 для левой стороны и 2 для правой стороны.
"Job Name" Используйте кавычки, если имя задания или путь содержит пробелы.

Важно: не смешивайте параметры задания с глобальными параметрами и не размещайте глобальные параметры перед параметрами профиля. GSYNC требует соблюдения порядка параметров.

Область действия команд

Каждая команда или параметр относится к определенной области GoodSync. Прежде чем добавлять параметр в команду, проверьте его область действия.

Область Назначение
Профиль Выбирает профиль GoodSync, список заданий и расположение журналов.
Запуск Управляет выводом и поведением текущего процесса GSYNC.
Глобальная Управляет действиями и настройками на уровне программы GoodSync.
Задание Создает, обновляет, анализирует, синхронизирует или настраивает конкретное задание.
Connectoid Определяет URL папки задания, аккаунт сервера или параметр подключения.
Сторона Применяется к левой стороне с суффиксом 1 или к правой стороне с суффиксом 2.

Типичные примеры использования GSYNC

Список всех доступных заданий:

gsync job-list

Анализ одного существующего задания:

gsync analyze "Job Name"

Анализ и синхронизация одного существующего задания:

gsync sync "Job Name"

Анализ и синхронизация всех заданий:

gsync sync /all

Создание локального задания одностороннего резервного копирования: gsync job-new "Local Backup" /f1="file:///C:/Source" /f2="file:///D:/Backup" /dir=ltor /deletions=no /analyze

Создание задания двусторонней синхронизации: gsync job-new "Two-Way Sync" /f1="file:///C:/Folder A" /f2="file:///D:/Folder B" /dir=2way /analyze

Запуск временного задания без его сохранения: gsync job-tmp "Temporary Backup" /f1="file:///C:/Source" /f2="file:///D:/Backup" /dir=ltor /analyze

Создание локального задания резервного копирования в Linux: gsync job-new "Linux Backup" /f1="file:///home/user/Documents" /f2="file:///mnt/backup/Documents" /dir=ltor /deletions=no /analyze

Настройка существующего задания на ежедневный запуск в 2:00 ночи: gsync job-update "Backup Job" /on-schedule=sync /schedule-hour=2 /schedule-min=0

Чтобы обрабатывать задания, настроенные на режим Авто, запустите GSYNC командой gsync /runner.

Меры предосторожности и безопасность

Прежде чем использовать GSYNC в рабочих скриптах или в средах, работающих без участия пользователя, учтите следующее.

  • Анализ перед синхронизацией: выполняйте анализ и просматривайте предлагаемые изменения перед первой синхронизацией и после изменения параметров задания.
  • Параметры удаления: /deletions=yes распространяет удаления на другую сторону. Сначала проверьте направление задания и фильтры.
  • Режим перемещения: /move-mode=yes удаляет исходные файлы после их копирования.
  • Файлы блокировки: /override-locks=yes может отменить защиту, установленную другим активным заданием. Используйте этот параметр, только убедившись, что никакой другой процесс GoodSync или GSYNC не использует эти папки.
  • Поведение файла состояния: /no-gsdata1=yes или /no-gsdata2=yes запрещает GoodSync использовать обычную папку файлов состояния на этой стороне и может изменить способ отслеживания истории задания.
  • Проверка сертификатов: /bad-certs1=yes или /bad-certs2=yes отключает обычную проверку SSL-сертификатов для этой стороны; этот параметр следует использовать только в контролируемой среде.
  • Пароли: пароли, введенные непосредственно в команде, могут быть видны в истории оболочки, скриптах, журналах и сведениях об активных процессах.
  • Выбор профиля: перед обновлением или удалением заданий проверьте, какой профиль активен. Задание с тем же именем может существовать в другом профиле GoodSync.

Параметры профиля

Параметры профиля определяют, какие профиль GoodSync, список заданий и настройки журнала используются при запуске GSYNC.

/profile=<folder-path> — папка, в которой находятся файлы jobs.tic и options.tic.

/lf=<folder> — папка, в которую записывается глобальный файл журнала.

/ll=<number> — уровень детализации журнала. По умолчанию: 2 - Информация.

Уровни детализации журнала:

  • 0 - Критический
  • 1 - Ошибки
  • 2 - Информация — по умолчанию
  • 3 - Детально
  • 4 - Транзакция
  • 5 - Отладка

/jobs-file=<file-path> — загружает список заданий из этого файла в формате TIC или TIX.

/no-load-tic — не загружает задания, группы и параметры перед применением изменений.

/no-save-tic — не сохраняет задания, группы и параметры после применения изменений.

Параметры запуска

Параметры запуска управляют выводом команд, отображением хода выполнения, очисткой, блокировками и способом сравнения при анализе во время выполнения заданий.

/progress — показывает сообщения о ходе выполнения при запуске задания.

/noprint — не выводит аргументы командной строки для проверки.

/no-log-stamp — не добавляет метку времени к каждой строке журнала.

/list-changes — выводит список изменений, обнаруженных при анализе.

/cleanup — удаляет старые журналы и временные файлы при запуске GSYNC.

/override-locks — игнорирует и удаляет файлы блокировки во время анализа. По умолчанию: нет.

/comp-cksums — сравнивает контрольные суммы файлов во время анализа. Этот параметр работает медленно.

/comp-bodies — сравнивает содержимое файлов во время анализа. Этот параметр работает очень медленно.

Глобальные команды

Эти команды позволяют вывести справку и сведения о версии, управлять лицензиями и действиями с аккаунтом, запускать GSYNC в режимах Runner, а также синхронизировать или выводить списком задания, группы и аккаунты сервера.

/version или /license — показывает версию и лицензию GoodSync и завершает работу.

/help — показывает эту справку.

/check-ver — проверяет версию GoodSync на www.goodsync.com.

/gs-account-enroll=Email — регистрирует этот компьютер в аккаунте GoodSync, заданном адресом Email.

/manage-account — открывает сайт GoodSync для управления вашим аккаунтом GoodSync.

/buy-license — открывает сайт GoodSync для покупки лицензий.

/activate — активирует лицензию, используя аккаунт GoodSync, зарегистрированный на этом компьютере.

/runner — запускает GSYNC в режиме Local Job Runner.

/cc-runner — запускает GSYNC в режиме Control Center Job Runner.

/sync-jobs-accts — синхронизирует задания, группы и аккаунты сервера этого компьютера с аккаунтом GoodSync.

/list-jga — выводит список всех заданий, групп и аккаунтов сервера этого компьютера.

GSYNC Runner Service

GSYNC Runner Service выполняет автоматические задания, не требуя, чтобы графический интерфейс GoodSync оставался открытым.

/auto-unattended=yes|no — выполняет автоматическое задание в службе gs-runner.

Когда параметр /auto-unattended=yes включен:

  • Задание выполняется через GoodSync Runner Service.
  • В Windows задание может выполняться, даже если пользователь вышел из системы.
  • Runner Service создается, когда первое задание настраивается на автоматический запуск в автономном режиме.
  • Не запускайте команду Runner Service вручную. Ее запускает операционная система.
  • Чтобы вернуть задание в графический интерфейс GoodSync, отключите параметр автономного режима в окне «Опции» задания.

Глобальные команды для аккаунтов сервера

Эти команды позволяют из командной строки создавать аккаунты сервера, выводить их список, обновлять, переименовывать и удалять их, а также выполнять для них аутентификацию.

/sa-list [prefix] — выводит список аккаунтов сервера; при необходимости только тех, имена которых начинаются с prefix.

/sa-create — создает новый аккаунт сервера и заполняет его значениями ConnectOptions.

/sa-oauth — выполняет аутентификацию через браузер (OAuth2) и сохраняет результаты в аккаунте сервера.

  • Примеры начальных URL для OAuth:
  • goodrive:// — запускает OAuth для Google All Drive.
  • gcp:// — запускает OAuth для Google Cloud Storage.
  • gteamdrive:// — запускает OAuth для Google Team Drive.
  • gdocs3:// — запускает OAuth для Google Docs.
  • dropbox:// — запускает OAuth для Dropbox.
  • box:// — запускает OAuth для Box.com.
  • msgraph:// — запускает OAuth для OneDrive, Office 365 и SharePoint.
  • pcloud:// — запускает OAuth для pCloud.

/sa-update AcctKey/AcctName ConnectOptions — обновляет существующий аккаунт сервера значениями ConnectOptions.

/sa-rename AcctKey/AcctName NewAcctName — переименовывает аккаунт сервера в NewAcctName.

/sa-delete AcctKey/AcctName — удаляет аккаунт сервера по его ключу или имени.

/encrypt-plain=clear-password — создает зашифрованный пароль из пароля, заданного открытым текстом.

Глобальные параметры

Эти параметры задают общее поведение программы GoodSync, включая настройки системной панели, ведение журналов, сортировку заданий, обработку автоматических заданий, настройки прокси и настройки электронной почты SMTP.

Основные

/sort-jobs-alpha=yes|no — сортирует задания по алфавиту в окне списка заданий.

/system-tray=yes|no — показывает значок в системной панели. Только для Windows.

/tray-on-close=yes|no — сворачивает GoodSync в системную панель при закрытии приложения. Только для Windows.

/compare-prog=<FilePath> — использует указанную программу для сравнения двух файлов в стиле diff.

/warn-time-range=yes|no — предупреждает, если время изменения файла или папки выходит за допустимый диапазон.

/group-log-lines=yes|no — группирует похожие строки журнала.

/log-retain-days=NNN — задает количество дней, в течение которых хранятся старые журналы.

Авто

/auto-hide-mini-win=yes|no — автоматически скрывает мини-окно, когда нет активных заданий. Только для Windows.

/months-old-gens=NNN — хранит историю версий файлов в течение указанного количества месяцев.

/parallel-auto-jobs=NNN — задает максимальное количество автоматических заданий, которые могут выполняться параллельно.

/auto-jobs-quant=NNN — задает интервал запуска автоматических заданий в секундах.

/encrypted-passwords — сохраняет пароли подключений локально в зашифрованном виде.

Фильтры

/exclude=<file-mask> — исключает файлы и папки, соответствующие указанной маске.

/include=<file-mask> — включает только файлы и папки, соответствующие указанной маске.

/exclude-empty=yes|no — исключает пустые папки.

/exclude-hidden=yes|no — исключает скрытые файлы и папки.

/exclude-system=yes|no — исключает системные файлы и папки.

Прокси

/proxy-auto=yes|no — использует автоматические настройки прокси из Internet Options > Connections.

/proxy-host=hostname — использует указанный прокси-сервер.

/proxy-port=port — задает порт прокси-сервера.

/proxy-userid=<userid> — задает имя пользователя прокси для прокси-серверов с аутентификацией.

/proxy-passwd=<password> — задает пароль прокси.

SMTP

/smtp-host=hostname — задает SMTP-сервер, используемый для отправки писем после анализа и после синхронизации.

/smtp-port=port — задает порт SMTP-сервера.

/smtp-secure=yes|no — использует SSL для подключения к SMTP-серверу.

/smtp-starttls=yes|no — использует STARTTLS для подключения к SMTP-серверу.

/smtp-userid=<userid> — задает имя пользователя SMTP-сервера.

/smtp-passwd=<password> — задает пароль SMTP-сервера.

/smtp-sender=<name-email> — задает адрес электронной почты и имя отправителя.

Команды заданий

Эти команды позволяют из командной строки анализировать, синхронизировать, создавать, обновлять и удалять задания GoodSync, а также выводить их список.

analyze /all — анализирует все задания.
Пример: gsync analyze /all

analyze <job list> — анализирует перечисленные задания.
Пример: gsync analyze "Job Name"

sync /all — анализирует и синхронизирует все задания.
Пример: gsync sync /all

sync <job list> — анализирует и синхронизирует перечисленные задания.
Пример: gsync sync "Job Name"

job <job name> [<job options>] — создает новое задание или обновляет существующее.
Пример: gsync job "Backup Job" /f1="file:///C:/Source" /f2="file:///D:/Backup" /dir=ltor

job-new <job name> [<job options>] — создает новое задание.
Пример: gsync job-new "Backup Job" /f1="file:///C:/Source" /f2="file:///D:/Backup" /dir=ltor

job-tmp <job name> [<job options>] — использует временное задание, которое не сохраняется.
Пример: gsync job-tmp "Temp Backup" /f1="file:///C:/Source" /f2="file:///D:/Backup" /sync

job-update <job name> [<job options>] — обновляет существующее задание.
Пример: gsync job-update "Backup Job" /deletions=yes /worker-threads=4

job-delete <job name> — удаляет существующее задание.
Пример: gsync job-delete "Old Backup Job"

job-list — выводит список доступных заданий.
Пример: gsync job-list

Параметры задания

Эти параметры позволяют выполнить анализ или синхронизацию после создания или обновления задания.

/analyze — анализирует задание после его создания или обновления.

/sync — анализирует и синхронизирует задание после его создания или обновления.

/autoclear — убирает дерево после успешной синхронизации либо после анализа, если в режиме Авто изменений нет.

URL сторон задания и параметры Connectoid

Эти параметры определяют левую и правую стороны задания.

/f1=<full folder URL> — полный URL левой папки синхронизации.

/f2=<full folder URL> — полный URL правой папки синхронизации.

/u1=<account URL> — URL левой стороны для аккаунта сервера, сохраненного в Account Manager.

/u2=<account URL> — URL правой стороны для аккаунта сервера, сохраненного в Account Manager.

/n1=<AccountName> — имя аккаунта сервера для левой стороны. Требует /u1.

/n2=<AccountName> — имя аккаунта сервера для правой стороны. Требует /u2.

/d1=<folder path> — путь к левой папке внутри аккаунта сервера при использовании Account Manager.

/d2=<folder path> — путь к правой папке внутри аккаунта сервера при использовании Account Manager.

Пути, содержащие пробелы, заключайте в кавычки.

Пример: /f1="file:///C:/Source Folder" /f2="file:///D:/Backup Folder"

ConnectOptions и параметры сторон

Эти параметры можно использовать с командами аккаунтов сервера или как параметры сторон в командах заданий.

/userid1=<userid> /userid2=<userid> — имя пользователя для подключения на левой или правой стороне.

/password1=<password> /password2=<password> — пароль для подключения на левой или правой стороне.

/time-trans1=yes|no /time-trans2=yes|no — использует преобразование времени, если время изменения файла невозможно скопировать или установить.

/bad-certs1=yes|no /bad-certs2=yes|no — отключает обычную проверку SSL-сертификатов на левой или правой стороне.

/useproxy1=yes|no /useproxy2=yes|no — использует настройки прокси на левой или правой стороне.

/wininet1=yes|no /wininet2=yes|no — использует WinInet вместо собственных сокетов для DAV, S3 или FTP на левой или правой стороне.

/utf8-1=yes|no /utf8-2=yes|no — использует кодировку имен файлов UTF-8 или ANSI на левой или правой стороне.

/temp-dest-file1=yes|no /temp-dest-file2=yes|no — использует временные файлы при копировании на левую или правую сторону.

/hostbased1=yes|no /hostbased2=yes|no — использует адресацию на основе хоста для S3 на левой или правой стороне.

/reduced-redundancy1=yes|no /reduced-redundancy2=yes|no — использует хранилище со сниженной избыточностью для S3 на левой или правой стороне.

/server-encrypt1=yes|no /server-encrypt2=yes|no — использует шифрование на стороне сервера для S3 на левой или правой стороне.

/accesspolicy1=<policy> /accesspolicy2=<policy> — использует указанную политику доступа S3 на левой или правой стороне.

/aws4-auth1=yes|no /aws4-auth2=yes|no — использует аутентификацию AWS Signature Version 4 на левой или правой стороне.

/show-native1=yes|no /show-native2=yes|no — экспортирует или импортирует файлы Google Docs в собственном формате на левой или правой стороне.

/active1=yes|no /active2=yes|no — использует активный или пассивный режим FTP на левой или правой стороне.

/mdtm1=yes|no /mdtm2=yes|no — использует MDTM для FTP на левой или правой стороне.

/mlsd1=yes|no /mlsd2=yes|no — использует MLSD для FTP на левой или правой стороне.

/implicit1=yes|no /implicit2=yes|no — использует неявный режим для FTPS на левой или правой стороне.

/listla1=yes|no /listla2=yes|no — использует параметр LIST -la для FTP на левой или правой стороне.

/move-level-only=yes|no — разрешает выполнять MOVE в пределах одного уровня папок. Применяется к FTP.

/tls-sess-reuse=yes|no — требует повторного использования сеанса TLS. Применяется к FTPS.

/pk1=<file-path> /pk2=<file-path> — задает путь к закрытому ключу SFTP или сертификату DAV/GSTP для левой или правой стороны.

/can-otp1=yes|no /can-otp2=yes|no — включает поддержку OTP для GSTP на левой или правой стороне. Этот параметр не сохраняется.

/otp1=value /otp2=value — задает значение OTP для левой или правой стороны. Этот параметр не сохраняется.

Основные параметры задания

Эти параметры задают основное поведение задания, включая направление синхронизации, удаления, предыдущие версии файлов, попытки переподключения, параллельные потоки и ограничения скорости.

/dir=2way|ltor|rtol — задает направление задания: в двух направлениях, слева направо или справа налево.

/deletions=yes|no — распространяет удаления.

/fast-1way=yes|no — включает быстрый односторонний режим без файлов состояния и блокировок.

/create-if-not-found=yes|no — создает папки синхронизации задания, если они не найдены.

/balloon-msg=none|errors|changes — показывает всплывающие сообщения: никогда, при ошибках или при изменениях.

/save-prev-version=yes|no — сохраняет удаленные или замененные файлы в _gsdata_/_saved_. Сохраняется только последняя версия.

/cleanup-prev-version=yes|no — очищает предыдущие версии файлов.

/days-prev-version=<number> — задает количество дней хранения предыдущих версий файлов.

/save-past-versions=yes|no — сохраняет удаленные или замененные файлы в _gsdata_/_history_. Сохраняется несколько версий.

/cleanup-past-versions=yes|no — очищает прошлые версии файлов.

/days-past-versions=<number> — задает количество дней хранения прошлых версий файлов.

/reconnect-secs=<number> — задает общее время в секундах на попытки переподключения.

/run-parallel-threads=yes|no — запускает параллельные потоки при синхронизации.

/worker-threads=N — задает количество потоков, выполняемых параллельно при синхронизации.

/speed-limit=<number> — задает ограничение скорости копирования файлов в КБ/с.

Параметры фильтров задания

Эти параметры определяют, какие файлы и папки включаются или исключаются при анализе или синхронизации задания.
 

/exclude=<file-mask> — исключает файлы и папки, соответствующие указанной маске.

В масках файлов можно использовать шаблоны, например *.obj или \folder\file.

Можно указать несколько параметров /exclude. Их значения объединяются и разделяются символом |.

/include=<file-mask> — включает файлы и папки, соответствующие указанной маске.

В масках файлов можно использовать шаблоны, например *.obj или \folder\file.

Можно указать несколько параметров /include. Их значения объединяются и разделяются символом |.

/exclude-empty=yes|no — исключает пустые папки.

/exclude-hidden=yes|no — исключает скрытые файлы и папки.

/exclude-system=yes|no — исключает системные файлы и папки.

Параметры автоматизации задания

Эти параметры определяют, когда задание запускается автоматически: например, при изменении файлов, при подключении папок, при запуске GoodSync, по расписанию или по таймеру.
 

/on-file-change=analyze|sync|no — автоматически выполняет анализ или синхронизацию при обнаружении изменений файлов в локальных папках синхронизации.

/onfilechange-delay=NNN — задает задержку для режима «При изменении файла» в секундах.

/on-folder-connect=analyze|sync|no — автоматически выполняет анализ или синхронизацию при подключении папки.

/on-start=analyze|sync|no — автоматически выполняет анализ или синхронизацию при запуске GoodSync.

/autostart-delay=NNN — задает задержку для режима «При старте GoodSync» в секундах.

/on-timer=analyze|sync|no — автоматически выполняет анализ или синхронизацию по таймеру.

/timer-period=<NN> — задает период таймера в минутах для /on-timer.

/on-logout=sync — автоматически выполняет синхронизацию при выходе из учетной записи Windows.

/on-schedule=analyze|sync|no — автоматически выполняет анализ или синхронизацию по расписанию.

/schedule-min=list-of-number-ranges (от 0 до 59) — задает минуту расписания.

/schedule-hour=list-of-number-ranges (от 0 до 23) — задает час расписания.

/schedule-day=list-of-number-ranges (от 1 до 31) — задает день месяца для расписания.

/schedule-month=list-of-number-ranges (от 1 до 12) — задает месяц расписания.

/schedule-dow=list-of-number-ranges (от 0=Вс до 6=Сб) — задает день недели для расписания.

/auto-unattended=yes|no — выполняет автоматическое задание в службе gs-runner.

/limit-changes=<NN> — не выполняет синхронизацию, если процент измененных файлов больше NN.

/wait-for-locks=yes|no — ожидает снятия файлов блокировки вместо выдачи ошибки.

/autoclear=yes|no — автоматически очищает дерево синхронизации после синхронизации.

Параметры конфликтов

/resolve-weak-conflicts=yes|no — автоматически разрешает простые конфликты, когда на одной из сторон нет истории версий.

/autoresolve=no|left|right|newer|stopsync — задает параметр автоматического разрешения конфликтов.

/rename-losing-file=yes|no — переименовывает файл, проигравший в конфликте, вместо его удаления.

Параметры скриптов

Эти параметры позволяют запустить программу или отправить электронное письмо до или после операции анализа или синхронизации задания.

/pre-analyze-action=<file-path> — запускает указанную программу перед анализом.

/post-analyze-action=<email>|<file-path> — отправляет электронное письмо или запускает указанную программу после анализа.

/post-sync-action=<email>|<file-path> — отправляет электронное письмо или запускает указанную программу после синхронизации.

Продвинутые настройки

Эти параметры управляют обработкой файлов при анализе и синхронизации, включая способы сравнения, метаданные, разрешения, заблокированные файлы, символические ссылки и особенности работы папок на каждой из сторон.

Параметры этапа синхронизации

Эти параметры определяют, как обрабатываются файлы при синхронизации, включая время файлов, атрибуты, разрешения, режим перемещения, заблокированные файлы и файлы, изменившиеся после анализа.

/do-not-sync-changed-files=yes|no — не синхронизирует файлы, которые изменились после анализа.

/wait-sync-after-analyze=seconds — ожидает указанное количество секунд после анализа перед началом синхронизации.

/copy-create-time=yes|no — копирует время создания файлов и папок.

/copy-attrs=yes|no — копирует биты атрибутов файлов и папок, например rwx.

/copy-ext-attrs=yes|no — копирует расширенные атрибуты. Только для Mac.

/copy-owner=yes|no — копирует сведения о владельце файлов и папок. Не требуется, если включен параметр /copy-acl.

/copy-acl=yes|no — копирует сведения о безопасности ACL, включая владельца и ACL.

/move-mode=yes|no — удаляет исходный файл после копирования, имитируя перемещение.

/delete-empty-folders-on-move=yes|no — удаляет пустые папки при использовании режима перемещения.

/copy-locked=yes|no — копирует заблокированные файлы с помощью службы теневого копирования.

/uber-unlocked=yes|no — включает режим Uber-Unlocked, позволяющий удалять файлы во время их чтения.

Параметры этапа анализа

Эти параметры определяют, как сравниваются файлы при анализе, включая контрольные суммы, обнаружение перемещений, символические ссылки, оценку необходимого места и изменения на стороне назначения.

/compare-md5=yes|no — сравнивает все файлы по контрольным суммам MD5 во время анализа.

/detect-moves=yes|no — обнаруживает перемещения и переименования файлов и папок, вместо того чтобы обрабатывать их как копирование и удаление.

/ignore-changes-on-dest-side — игнорирует изменения на стороне назначения.

/est-req-space=yes|no — оценивает объем свободного места, необходимый для синхронизации.

/links=ignore|copy-asis|drill-down — задает способ обработки символических ссылок.

/copy-original-fs-names=yes|no — сохраняет исходные имена файловой системы и не изменяет запрещенные символы. Применяется к заданиям между двумя Mac.

Параметры папок левой/правой стороны

Эти параметры задают настройки левой или правой стороны задания, включая правила сравнения, поведение файла состояния, временные файлы, сжатие, шифрование и работу с файловой системой.

/compare-checksums1=yes|no /compare-checksums2=yes|no — при необходимости сравнивает контрольные суммы на левой или правой стороне.

/compare-ext-attrs1=yes|no /compare-ext-attrs2=yes|no — сравнивает расширенные атрибуты на левой или правой стороне.

/compare-attrs1=yes|no /compare-attrs2=yes|no — сравнивает атрибуты на левой или правой стороне.

/compare-owner1=yes|no /compare-owner2=yes|no — сравнивает сведения о владельце на левой или правой стороне.

/compare-acl1=yes|no /compare-acl2=yes|no — сравнивает сведения о безопасности ACL на левой или правой стороне.

/no-gsdata1=yes|no /no-gsdata2=yes|no — не создает и не использует папку _gsdata_ на левой или правой стороне.

/no-listdir1=yes|no /no-listdir2=yes|no — не выполняет ListDir и доверяет файлу состояния на левой или правой стороне.

/temp-dest-file1=yes|no /temp-dest-file2=yes|no — использует временные файлы при копировании на левую или правую сторону.

/compress-type1=no|plain|deflate /compress-type2=no|plain|deflate — задает метод сжатия содержимого файлов на левой или правой стороне.

/cipher-type1=no|zipcrypto|aes-256 /cipher-type2=no|zipcrypto|aes-256 — задает метод шифрования содержимого файлов на левой или правой стороне.

/encrypt-files1=yes|no /encrypt-files2=yes|no — шифрует содержимое файлов на левой или правой стороне.

/encrypt-paths1=yes|no /encrypt-paths2=yes|no — шифрует пути файлов на левой или правой стороне.

/encrypt-password1=str /encrypt-password2=str — задает пароль шифрования для левой или правой стороны.

/fat-like1=yes|no /fat-like2=yes|no — считает левую или правую сторону файловой системой типа FAT.

/compress1=yes|no /compress2=yes|no — использует сжатие NTFS на левой или правой стороне.

/uncompress1=yes|no /uncompress2=yes|no — снимает сжатие NTFS на левой или правой стороне.

Коды возврата и завершения

GSYNC возвращает код завершения последнего выполненного задания. Скрипты автоматизации могут использовать это значение, чтобы определить, было ли задание выполнено, остановлено, столкнулось с ошибкой или завершилось с конфликтами.

Код Результат
0 Нормальное завершение: анализ не обнаружил изменений или синхронизация успешно завершена.
1 Анализ не завершен, так как был остановлен пользователем.
2 Анализ не завершен из-за фатальной ошибки, например из-за отсутствия папки синхронизации.
3 Анализ завершен с нефатальными ошибками и, возможно, с конфликтами.
4 Анализ завершен с конфликтами, но без ошибок.
11 Синхронизация не завершена, так как была остановлена пользователем.
12 Синхронизация не завершена из-за фатальной ошибки, например из-за отсутствия папки синхронизации.
13 Синхронизация завершена с нефатальными ошибками и, возможно, с конфликтами.
14 Синхронизация завершена с конфликтами, но без ошибок.
Отрицательное значение При запуске GSYNC произошла ошибка.

Важно: просматривайте журнал задания, даже если команда выполнена. Некоторые нефатальные ситуации могут быть зафиксированы только в журнале.

Проверка последнего кода завершения в Командной строке:

echo %ERRORLEVEL%

Проверка последнего кода завершения в PowerShell:

$LASTEXITCODE

Проверка последнего кода завершения в macOS или Linux:

echo $?

Перенаправление вывода команды в файл журнала в Windows:

gsync sync "Job Name" > "C:\Logs\GoodSync.log" 2>&1

Перенаправление вывода команды в файл журнала в macOS или Linux:

gsync sync "Job Name" > "/var/log/goodsync.log" 2>&1

Устранение неполадок GSYNC

Проблема Рекомендуемая проверка
Команда GSYNC не найдена Убедитесь, что GoodSync установлен, и запускайте GSYNC из папки его установки либо добавьте эту папку в системную переменную PATH.
Задание не найдено Выполните gsync job-list, проверьте точное имя задания и убедитесь, что загружен правильный профиль.
Путь или имя задания содержит пробелы Заключите полное имя задания или путь в кавычки.
Доступ запрещен Проверьте права пользователя или служебной учетной записи, от имени которых запускается GSYNC, на обе папки задания.
Сбой аутентификации Проверьте аккаунт сервера, имя пользователя, пароль, закрытый ключ, авторизацию OAuth и суффикс параметра, указывающий сторону.
Задание заблокировано Прежде чем снимать блокировку, убедитесь, что другой процесс GoodSync или GSYNC не использует те же папки синхронизации.
Обнаружены непредвиденные изменения Выполните только анализ и, прежде чем запускать синхронизацию, проверьте направление, фильтры, настройки удаления, параметры файла состояния и активный профиль.
Нужен более подробный журнал Повысьте детализацию журнала с помощью /ll=<number> и направьте stdout в файл журнала.

Чтобы просмотреть список команд, доступных в установленной версии, выполните gsync /help или gsync /?.

Глоссарий GSYNC

Анализ — сравнивает обе стороны задания и определяет изменения, которые выполнит синхронизация.

Синхронизация — применяет действия, определенные при анализе.

Задание — сохраненный набор папок синхронизации, направления, фильтров и рабочих параметров.

Профиль — место хранения конфигурации GoodSync, содержащее задания, аккаунты сервера, настройки программы и журналы.

Левая и правая стороны — две папки или файловые системы, которые сравнивает задание GoodSync.

Аккаунт сервера — сохраненная конфигурация подключения и аутентификации для поддерживаемой файловой системы.

Connectoid — свойства подключения, используемые для доступа к локальной, сетевой или удаленной файловой системе.

Файл состояния — данные GoodSync, с помощью которых отслеживается предыдущее состояние задания и определяются изменения между запусками.

Runner — фоновый процесс GSYNC, который запускает и выполняет задания, настроенные на режим Авто.

Режим Авто — параметры задания, запускающие анализ или синхронизацию по событиям, расписаниям, таймерам или при доступности папок.

stdout — стандартный вывод команды, который может отображаться в терминале или перенаправляться в файл.

Чтобы узнать, какие команды поддерживает установленная версия GoodSync, всегда используйте gsync /help как справку для конкретной версии.

Вернуться наверх