2020-06-22 04:15:24 +00:00
|
|
|
|
.\" Man page generated from reStructuredText.
|
|
|
|
|
.
|
|
|
|
|
.
|
|
|
|
|
.nr rst2man-indent-level 0
|
|
|
|
|
.
|
|
|
|
|
.de1 rstReportMargin
|
|
|
|
|
\\$1 \\n[an-margin]
|
|
|
|
|
level \\n[rst2man-indent-level]
|
|
|
|
|
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
|
|
|
-
|
|
|
|
|
\\n[rst2man-indent0]
|
|
|
|
|
\\n[rst2man-indent1]
|
|
|
|
|
\\n[rst2man-indent2]
|
|
|
|
|
..
|
|
|
|
|
.de1 INDENT
|
|
|
|
|
.\" .rstReportMargin pre:
|
|
|
|
|
. RS \\$1
|
|
|
|
|
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
|
|
|
|
|
. nr rst2man-indent-level +1
|
|
|
|
|
.\" .rstReportMargin post:
|
|
|
|
|
..
|
|
|
|
|
.de UNINDENT
|
|
|
|
|
. RE
|
|
|
|
|
.\" indent \\n[an-margin]
|
|
|
|
|
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
|
|
|
.nr rst2man-indent-level -1
|
|
|
|
|
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
|
|
|
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
|
|
|
|
..
|
2024-09-09 03:45:15 +00:00
|
|
|
|
.TH "SYNCTHING-EVENT-API" "7" "Sep 04, 2024" "v1.27.11" "Syncthing"
|
2021-04-28 05:45:43 +00:00
|
|
|
|
.SH NAME
|
|
|
|
|
syncthing-event-api \- Event API
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
.sp
|
|
|
|
|
Syncthing provides a simple long polling interface for exposing events from the
|
2023-09-18 03:45:31 +00:00
|
|
|
|
core utility towards a GUI. To receive events, see \fI\%GET /rest/events\fP\&.
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.SH EVENT STRUCTURE
|
|
|
|
|
.sp
|
|
|
|
|
Each event is represented by an object similar to the following:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EX
|
2020-06-22 04:15:24 +00:00
|
|
|
|
{
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqid\(dq: 2,
|
|
|
|
|
\(dqglobalID\(dq: 3,
|
|
|
|
|
\(dqtype\(dq: \(dqDeviceConnected\(dq,
|
|
|
|
|
\(dqtime\(dq: \(dq2014\-07\-13T21:04:33.687836696+02:00\(dq,
|
|
|
|
|
\(dqdata\(dq: {
|
|
|
|
|
\(dqaddr\(dq: \(dq172.16.32.25:22000\(dq,
|
|
|
|
|
\(dqid\(dq: \(dqNFGKEKE\-7Z6RTH7\-I3PRZXS\-DEJF3UJ\-FRWJBFO\-VBBTDND\-4SGNGVZ\-QUQHJAG\(dq
|
2020-06-22 04:15:24 +00:00
|
|
|
|
}
|
|
|
|
|
}
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EE
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
The top level keys \fBid\fP, \fBglobalID\fP, \fBtime\fP, \fBtype\fP and \fBdata\fP are always present,
|
|
|
|
|
though \fBdata\fP may be \fBnull\fP\&.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B id
|
|
|
|
|
A unique ID for this event on the events API. It always increases by 1: the first
|
|
|
|
|
event generated has id \fB1\fP, the next has id \fB2\fP etc. If this increases by
|
|
|
|
|
more than 1, then one or more events have been skipped by the events API.
|
|
|
|
|
.TP
|
|
|
|
|
.B globalID
|
|
|
|
|
A global ID for this event, across the events API, the audit log, and any other
|
|
|
|
|
sources. It may increase by more than 1, but it will always be greater
|
|
|
|
|
than or equal to the id.
|
|
|
|
|
.TP
|
|
|
|
|
.B time
|
|
|
|
|
The time the event was generated.
|
|
|
|
|
.TP
|
|
|
|
|
.B type
|
|
|
|
|
Indicates the type of (i.e. reason for) the event and is one of the event
|
|
|
|
|
types below.
|
|
|
|
|
.TP
|
|
|
|
|
.B data
|
|
|
|
|
An object containing optional extra information; the exact structure is
|
|
|
|
|
determined by the event type.
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.SH EVENT TYPES
|
2022-05-02 04:07:12 +00:00
|
|
|
|
.SS ClusterConfigReceived
|
|
|
|
|
.sp
|
2024-05-13 03:45:18 +00:00
|
|
|
|
Added in version 1.20.0.
|
2022-05-02 04:07:12 +00:00
|
|
|
|
|
|
|
|
|
.sp
|
|
|
|
|
The \fBClusterConfigReceived\fP event is emitted after processing such a protocol
|
|
|
|
|
message received from a remote device. It is mainly used for internal purposes.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EX
|
2022-05-02 04:07:12 +00:00
|
|
|
|
{
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqid\(dq: 84,
|
|
|
|
|
\(dqglobalID\(dq: 84,
|
|
|
|
|
\(dqtype\(dq: \(dqClusterConfigReceived\(dq,
|
|
|
|
|
\(dqtime\(dq: \(dq2022\-04\-27T14:14:27.043576583+09:00\(dq,
|
|
|
|
|
\(dqdata\(dq: {
|
|
|
|
|
\(dqdevice\(dq: \(dqI6KAH76\-66SLLLB\-5PFXSOA\-UFJCDZC\-YAOMLEK\-CP2GB32\-BV5RQST\-3PSROAU\(dq
|
2022-05-02 04:07:12 +00:00
|
|
|
|
}
|
|
|
|
|
}
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EE
|
2022-05-02 04:07:12 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.SS ConfigSaved
|
|
|
|
|
.sp
|
|
|
|
|
Emitted after the config has been saved by the user or by Syncthing
|
|
|
|
|
itself.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EX
|
2020-06-22 04:15:24 +00:00
|
|
|
|
{
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqid\(dq: 50,
|
|
|
|
|
\(dqglobalID\(dq: 50,
|
|
|
|
|
\(dqtype\(dq: \(dqConfigSaved\(dq,
|
|
|
|
|
\(dqtime\(dq: \(dq2014\-12\-13T00:09:13.5166486Z\(dq,
|
|
|
|
|
\(dqdata\(dq: {
|
|
|
|
|
\(dqversion\(dq: 7,
|
|
|
|
|
\(dqfolders\(dq: [{\(dq...\(dq}],
|
|
|
|
|
\(dqdevices\(dq: [{\(dq...\(dq}],
|
|
|
|
|
\(dqgui\(dq: {\(dq...\(dq},
|
|
|
|
|
\(dqldap\(dq: {\(dq...\(dq},
|
|
|
|
|
\(dqoptions\(dq: {\(dq...\(dq},
|
|
|
|
|
\(dqremoteIgnoredDevices\(dq: [{\(dq...\(dq}],
|
|
|
|
|
\(dqdefaults\(dq: {\(dq...\(dq}
|
2020-06-22 04:15:24 +00:00
|
|
|
|
}
|
|
|
|
|
}
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EE
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.SS DeviceConnected
|
|
|
|
|
.sp
|
|
|
|
|
Generated each time a connection to a device has been established.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EX
|
2020-06-22 04:15:24 +00:00
|
|
|
|
{
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqid\(dq: 2,
|
|
|
|
|
\(dqglobalID\(dq: 2,
|
|
|
|
|
\(dqtype\(dq: \(dqDeviceConnected\(dq,
|
|
|
|
|
\(dqtime\(dq: \(dq2014\-07\-13T21:04:33.687836696+02:00\(dq,
|
|
|
|
|
\(dqdata\(dq: {
|
|
|
|
|
\(dqaddr\(dq: \(dq172.16.32.25:22000\(dq,
|
|
|
|
|
\(dqid\(dq: \(dqNFGKEKE\-7Z6RTH7\-I3PRZXS\-DEJF3UJ\-FRWJBFO\-VBBTDND\-4SGNGVZ\-QUQHJAG\(dq,
|
|
|
|
|
\(dqdeviceName\(dq: \(dqLaptop\(dq,
|
|
|
|
|
\(dqclientName\(dq: \(dqsyncthing\(dq,
|
|
|
|
|
\(dqclientVersion\(dq: \(dqv0.13.4\(dq,
|
|
|
|
|
\(dqtype\(dq: \(dqTCP (Client)\(dq
|
2020-06-22 04:15:24 +00:00
|
|
|
|
}
|
|
|
|
|
}
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EE
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.SS DeviceDisconnected
|
|
|
|
|
.sp
|
|
|
|
|
Generated each time a connection to a device has been terminated.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EX
|
2020-06-22 04:15:24 +00:00
|
|
|
|
{
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqid\(dq: 48,
|
|
|
|
|
\(dqglobalID\(dq: 48,
|
|
|
|
|
\(dqtype\(dq: \(dqDeviceDisconnected\(dq,
|
|
|
|
|
\(dqtime\(dq: \(dq2014\-07\-13T21:18:52.859929215+02:00\(dq,
|
|
|
|
|
\(dqdata\(dq: {
|
|
|
|
|
\(dqerror\(dq: \(dqunexpected EOF\(dq,
|
|
|
|
|
\(dqid\(dq: \(dqNFGKEKE\-7Z6RTH7\-I3PRZXS\-DEJF3UJ\-FRWJBFO\-VBBTDND\-4SGNGVZ\-QUQHJAG\(dq
|
2020-06-22 04:15:24 +00:00
|
|
|
|
}
|
|
|
|
|
}
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EE
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
\fBNOTE:\fP
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
The error key contains the cause for disconnection, which might not
|
|
|
|
|
necessarily be an error as such. Specifically, “EOF” and “unexpected
|
|
|
|
|
EOF” both signify TCP connection termination, either due to the other
|
|
|
|
|
device restarting or going offline or due to a network change.
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.SS DeviceDiscovered
|
|
|
|
|
.sp
|
|
|
|
|
Emitted when a new device is discovered using local discovery.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EX
|
2020-06-22 04:15:24 +00:00
|
|
|
|
{
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqid\(dq: 13,
|
|
|
|
|
\(dqglobalID\(dq: 13,
|
|
|
|
|
\(dqtype\(dq: \(dqDeviceDiscovered\(dq,
|
|
|
|
|
\(dqtime\(dq: \(dq2014\-07\-17T13:28:05.043465207+02:00\(dq,
|
|
|
|
|
\(dqdata\(dq: {
|
|
|
|
|
\(dqaddrs\(dq: [
|
|
|
|
|
\(dq172.16.32.25:22000\(dq
|
2020-06-22 04:15:24 +00:00
|
|
|
|
],
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqdevice\(dq: \(dqNFGKEKE\-7Z6RTH7\-I3PRZXS\-DEJF3UJ\-FRWJBFO\-VBBTDND\-4SGNGVZ\-QUQHJAG\(dq
|
2020-06-22 04:15:24 +00:00
|
|
|
|
}
|
|
|
|
|
}
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EE
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.SS DevicePaused
|
|
|
|
|
.sp
|
|
|
|
|
Emitted when a device was paused.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EX
|
2020-06-22 04:15:24 +00:00
|
|
|
|
{
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqid\(dq: 13,
|
|
|
|
|
\(dqglobalID\(dq: 13,
|
|
|
|
|
\(dqtype\(dq: \(dqDevicePaused\(dq,
|
|
|
|
|
\(dqtime\(dq: \(dq2014\-07\-17T13:28:05.043465207+02:00\(dq,
|
|
|
|
|
\(dqdata\(dq: {
|
|
|
|
|
\(dqdevice\(dq: \(dqNFGKEKE\-7Z6RTH7\-I3PRZXS\-DEJF3UJ\-FRWJBFO\-VBBTDND\-4SGNGVZ\-QUQHJAG\(dq
|
2020-06-22 04:15:24 +00:00
|
|
|
|
}
|
|
|
|
|
}
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EE
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
2022-03-14 03:47:23 +00:00
|
|
|
|
.SS DeviceRejected (DEPRECATED)
|
2021-01-27 06:45:21 +00:00
|
|
|
|
.sp
|
|
|
|
|
Deprecated since version v1.13.0: This event is still emitted for compatibility, but deprecated. Use
|
2023-09-18 03:45:31 +00:00
|
|
|
|
the replacement \fI\%PendingDevicesChanged\fP event instead.
|
2021-01-27 06:45:21 +00:00
|
|
|
|
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.sp
|
|
|
|
|
Emitted when there is a connection from a device we are not configured
|
|
|
|
|
to talk to.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EX
|
2020-06-22 04:15:24 +00:00
|
|
|
|
{
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqid\(dq: 24,
|
|
|
|
|
\(dqglobalID\(dq: 24,
|
|
|
|
|
\(dqtype\(dq: \(dqDeviceRejected\(dq,
|
|
|
|
|
\(dqtime\(dq: \(dq2014\-08\-19T10:43:00.562821045+02:00\(dq,
|
|
|
|
|
\(dqdata\(dq: {
|
|
|
|
|
\(dqaddress\(dq: \(dq127.0.0.1:51807\(dq,
|
|
|
|
|
\(dqname\(dq: \(dqMy dusty computer\(dq,
|
|
|
|
|
\(dqdevice\(dq: \(dqEJHMPAQ\-OGCVORE\-ISB4IS3\-SYYVJXF\-TKJGLTU\-66DIQPF\-GJ5D2GX\-GQ3OWQK\(dq
|
2020-06-22 04:15:24 +00:00
|
|
|
|
}
|
|
|
|
|
}
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EE
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.SS DeviceResumed
|
|
|
|
|
.sp
|
|
|
|
|
Generated each time a device was resumed.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EX
|
2020-06-22 04:15:24 +00:00
|
|
|
|
{
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqid\(dq: 2,
|
|
|
|
|
\(dqglobalID\(dq: 2,
|
|
|
|
|
\(dqtype\(dq: \(dqDeviceResumed\(dq,
|
|
|
|
|
\(dqtime\(dq: \(dq2014\-07\-13T21:04:33.687836696+02:00\(dq,
|
|
|
|
|
\(dqdata\(dq: {
|
|
|
|
|
\(dqdevice\(dq: \(dqNFGKEKE\-7Z6RTH7\-I3PRZXS\-DEJF3UJ\-FRWJBFO\-VBBTDND\-4SGNGVZ\-QUQHJAG\(dq
|
2020-06-22 04:15:24 +00:00
|
|
|
|
}
|
|
|
|
|
}
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EE
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.SS DownloadProgress
|
|
|
|
|
.sp
|
|
|
|
|
Emitted during file downloads for each folder for each file. By default
|
|
|
|
|
only a single file in a folder is handled at the same time, but custom
|
|
|
|
|
configuration can cause multiple files to be shown.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EX
|
2020-06-22 04:15:24 +00:00
|
|
|
|
{
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqid\(dq: 221,
|
|
|
|
|
\(dqglobalID\(dq: 221,
|
|
|
|
|
\(dqtype\(dq: \(dqDownloadProgress\(dq,
|
|
|
|
|
\(dqtime\(dq: \(dq2014\-12\-13T00:26:12.9876937Z\(dq,
|
|
|
|
|
\(dqdata\(dq: {
|
|
|
|
|
\(dqfolder1\(dq: {
|
|
|
|
|
\(dqfile1\(dq: {
|
|
|
|
|
\(dqtotal\(dq: 800,
|
|
|
|
|
\(dqpulling\(dq: 2,
|
|
|
|
|
\(dqcopiedFromOrigin\(dq: 0,
|
|
|
|
|
\(dqreused\(dq: 633,
|
|
|
|
|
\(dqcopiedFromElsewhere\(dq: 0,
|
|
|
|
|
\(dqpulled\(dq: 38,
|
|
|
|
|
\(dqbytesTotal\(dq: 104792064,
|
|
|
|
|
\(dqbytesDone\(dq: 87883776
|
2020-06-22 04:15:24 +00:00
|
|
|
|
},
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqdir\e\efile2\(dq: {
|
|
|
|
|
\(dqtotal\(dq: 80,
|
|
|
|
|
\(dqpulling\(dq: 2,
|
|
|
|
|
\(dqcopiedFromOrigin\(dq: 0,
|
|
|
|
|
\(dqreused\(dq: 0,
|
|
|
|
|
\(dqcopiedFromElsewhere\(dq: 0,
|
|
|
|
|
\(dqpulled\(dq: 32,
|
|
|
|
|
\(dqbytesTotal\(dq: 10420224,
|
|
|
|
|
\(dqbytesDone\(dq: 4128768
|
2020-06-22 04:15:24 +00:00
|
|
|
|
}
|
|
|
|
|
},
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqfolder2\(dq: {
|
|
|
|
|
\(dqfile3\(dq: {
|
|
|
|
|
\(dqtotal\(dq: 800,
|
|
|
|
|
\(dqpulling\(dq: 2,
|
|
|
|
|
\(dqcopiedFromOrigin\(dq: 0,
|
|
|
|
|
\(dqreused\(dq: 633,
|
|
|
|
|
\(dqcopiedFromElsewhere\(dq: 0,
|
|
|
|
|
\(dqpulled\(dq: 38,
|
|
|
|
|
\(dqbytesTotal\(dq: 104792064,
|
|
|
|
|
\(dqbytesDone\(dq: 87883776
|
2020-06-22 04:15:24 +00:00
|
|
|
|
},
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqdir\e\efile4\(dq: {
|
|
|
|
|
\(dqtotal\(dq: 80,
|
|
|
|
|
\(dqpulling\(dq: 2,
|
|
|
|
|
\(dqcopiedFromOrigin\(dq: 0,
|
|
|
|
|
\(dqreused\(dq: 0,
|
|
|
|
|
\(dqcopiedFromElsewhere\(dq: 0,
|
|
|
|
|
\(dqpulled\(dq: 32,
|
|
|
|
|
\(dqbytesTotal\(dq: 10420224,
|
|
|
|
|
\(dqbytesDone\(dq: 4128768
|
2020-06-22 04:15:24 +00:00
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EE
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBtotal\fP \- total number of blocks in the file
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBpulling\fP \- number of blocks currently being downloaded
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBcopiedFromOrigin\fP \- number of blocks copied from the file we are
|
|
|
|
|
about to replace
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBreused\fP \- number of blocks reused from a previous temporary file
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBcopiedFromElsewhere\fP \- number of blocks copied from other files or
|
|
|
|
|
potentially other folders
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBpulled\fP \- number of blocks actually downloaded so far
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBbytesTotal\fP \- approximate total file size
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBbytesDone\fP \- approximate number of bytes already handled (already
|
|
|
|
|
reused, copied or pulled)
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Where block size is 128KB.
|
|
|
|
|
.sp
|
|
|
|
|
Files/folders appearing in the event data imply that the download has
|
|
|
|
|
been started for that file/folder, where disappearing implies that the
|
|
|
|
|
downloads have been finished or failed for that file/folder. There is
|
|
|
|
|
always a last event emitted with no data, which implies all downloads
|
|
|
|
|
have finished/failed.
|
2021-06-16 05:45:27 +00:00
|
|
|
|
.SS Failure
|
|
|
|
|
.sp
|
|
|
|
|
Generated for specific errors that will also be sent to the usage
|
|
|
|
|
reporting server, if enabled in the configuration. These are usually
|
|
|
|
|
of special interest to the developers to troubleshoot complex errors.
|
|
|
|
|
The \fBdata\fP field contains a textual error message.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EX
|
2021-06-16 05:45:27 +00:00
|
|
|
|
{
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqid\(dq: 93,
|
|
|
|
|
\(dqglobalID\(dq: 93,
|
|
|
|
|
\(dqtype\(dq: \(dqFailure\(dq,
|
|
|
|
|
\(dqtime\(dq: \(dq2021\-06\-07T21:22:03.414609034+02:00\(dq,
|
|
|
|
|
\(dqdata\(dq: \(dqindex handler got paused while already paused\(dq
|
2021-06-16 05:45:27 +00:00
|
|
|
|
}
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EE
|
2021-06-16 05:45:27 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.SS FolderCompletion
|
|
|
|
|
.sp
|
|
|
|
|
The \fBFolderCompletion\fP event is emitted when the local or remote
|
|
|
|
|
contents for a folder changes. It contains the completion percentage for
|
|
|
|
|
a given remote device and is emitted once per currently connected remote
|
|
|
|
|
device.
|
2022-05-02 04:07:12 +00:00
|
|
|
|
.sp
|
2024-05-13 03:45:18 +00:00
|
|
|
|
Added in version 1.20.0: Indication whether the remote device has accepted the folder (shares it with
|
2022-05-02 04:07:12 +00:00
|
|
|
|
us) as well, and whether it is paused. The \fBremoteState\fP field is
|
|
|
|
|
\fBunknown\fP when the remote device is not connected. Otherwise it can be
|
|
|
|
|
either \fBpaused\fP, \fBnotSharing\fP, or \fBvalid\fP if the remote is sharing back.
|
|
|
|
|
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EX
|
2020-06-22 04:15:24 +00:00
|
|
|
|
{
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqid\(dq: 84,
|
|
|
|
|
\(dqglobalID\(dq: 84,
|
|
|
|
|
\(dqtype\(dq: \(dqFolderCompletion\(dq,
|
|
|
|
|
\(dqtime\(dq: \(dq2022\-04\-27T14:14:27.043576583+09:00\(dq,
|
|
|
|
|
\(dqdata\(dq: {
|
|
|
|
|
\(dqcompletion\(dq: 100,
|
|
|
|
|
\(dqdevice\(dq: \(dqI6KAH76\-66SLLLB\-5PFXSOA\-UFJCDZC\-YAOMLEK\-CP2GB32\-BV5RQST\-3PSROAU\(dq,
|
|
|
|
|
\(dqfolder\(dq: \(dqdefault\(dq,
|
|
|
|
|
\(dqglobalBytes\(dq: 17,
|
|
|
|
|
\(dqglobalItems\(dq: 4,
|
|
|
|
|
\(dqneedBytes\(dq: 0,
|
|
|
|
|
\(dqneedDeletes\(dq: 0,
|
|
|
|
|
\(dqneedItems\(dq: 0,
|
|
|
|
|
\(dqremoteState\(dq: \(dqvalid\(dq,
|
|
|
|
|
\(dqsequence\(dq: 12
|
2020-06-22 04:15:24 +00:00
|
|
|
|
}
|
|
|
|
|
}
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EE
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.SS FolderErrors
|
|
|
|
|
.sp
|
|
|
|
|
The \fBFolderErrors\fP event is emitted when a folder cannot be successfully
|
|
|
|
|
synchronized. The event contains the ID of the affected folder and a list of
|
|
|
|
|
errors for files or directories therein. This list of errors is obsolete once
|
|
|
|
|
the folder changes state to \fBsyncing\fP \- if errors remain after the next
|
|
|
|
|
synchronization attempt, a new \fBFolderErrors\fP event is emitted.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EX
|
2020-06-22 04:15:24 +00:00
|
|
|
|
{
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqid\(dq: 132,
|
|
|
|
|
\(dqtype\(dq: \(dqFolderErrors\(dq,
|
|
|
|
|
\(dqtime\(dq: \(dq2015\-06\-26T13:39:24.697401384+02:00\(dq,
|
|
|
|
|
\(dqdata\(dq: {
|
|
|
|
|
\(dqerrors\(dq: [
|
2020-06-22 04:15:24 +00:00
|
|
|
|
{
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqerror\(dq: \(dqopen /Users/jb/src/github.com/syncthing/syncthing/test/s2/h2j/.syncthing.aslkjd.tmp: permission denied\(dq,
|
|
|
|
|
\(dqpath\(dq: \(dqh2j/aslkjd\(dq
|
2020-06-22 04:15:24 +00:00
|
|
|
|
}
|
|
|
|
|
],
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqfolder\(dq: \(dqdefault\(dq
|
2020-06-22 04:15:24 +00:00
|
|
|
|
}
|
|
|
|
|
}
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EE
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2024-05-13 03:45:18 +00:00
|
|
|
|
Added in version 0.11.12.
|
2020-06-22 04:15:24 +00:00
|
|
|
|
|
|
|
|
|
.sp
|
|
|
|
|
\fBSEE ALSO:\fP
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
2024-07-22 03:45:28 +00:00
|
|
|
|
The \fI\%StateChanged\fP event.
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
2021-06-16 05:45:27 +00:00
|
|
|
|
.SS FolderPaused
|
|
|
|
|
.sp
|
|
|
|
|
Generated when the configuration changes regarding the “paused” state
|
|
|
|
|
of a folder. Sent repeatedly for each changed folder.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EX
|
2021-06-16 05:45:27 +00:00
|
|
|
|
{
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqid\(dq: 93,
|
|
|
|
|
\(dqglobalID\(dq: 93,
|
|
|
|
|
\(dqtype\(dq: \(dqFolderPaused\(dq,
|
|
|
|
|
\(dqtime\(dq: \(dq2021\-06\-07T23:45:03.414609034+02:00\(dq,
|
|
|
|
|
\(dqdata\(dq: {
|
|
|
|
|
\(dqid\(dq: \(dqabcde\-fghij\(dq,
|
|
|
|
|
\(dqlabel\(dq: \(dqMy folder\(dq
|
2021-06-16 05:45:27 +00:00
|
|
|
|
}
|
|
|
|
|
}
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EE
|
2021-06-16 05:45:27 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
2022-03-14 03:47:23 +00:00
|
|
|
|
.SS FolderRejected (DEPRECATED)
|
2021-01-27 06:45:21 +00:00
|
|
|
|
.sp
|
|
|
|
|
Deprecated since version v1.13.0: This event is still emitted for compatibility, but deprecated. Use
|
2023-09-18 03:45:31 +00:00
|
|
|
|
the replacement \fI\%PendingFoldersChanged\fP event instead.
|
2021-01-27 06:45:21 +00:00
|
|
|
|
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.sp
|
|
|
|
|
Emitted when a device sends index information for a folder we do not
|
|
|
|
|
have, or have but do not share with the device in question.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EX
|
2020-06-22 04:15:24 +00:00
|
|
|
|
{
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqid\(dq: 27,
|
|
|
|
|
\(dqglobalID\(dq: 27,
|
|
|
|
|
\(dqtype\(dq: \(dqFolderRejected\(dq,
|
|
|
|
|
\(dqtime\(dq: \(dq2014\-08\-19T10:41:06.761751399+02:00\(dq,
|
|
|
|
|
\(dqdata\(dq: {
|
|
|
|
|
\(dqdevice\(dq: \(dqEJHMPAQ\-OGCVORE\-ISB4IS3\-SYYVJXF\-TKJGLTU\-66DIQPF\-GJ5D2GX\-GQ3OWQK\(dq,
|
|
|
|
|
\(dqfolder\(dq: \(dqGXWxf\-3zgnU\(dq,
|
|
|
|
|
\(dqfolderLabel\(dq: \(dqMy Pictures\(dq
|
2020-06-22 04:15:24 +00:00
|
|
|
|
}
|
|
|
|
|
}
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EE
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
2021-06-16 05:45:27 +00:00
|
|
|
|
.SS FolderResumed
|
|
|
|
|
.sp
|
|
|
|
|
Generated when the configuration changes regarding the “paused” state
|
|
|
|
|
of a folder. Sent repeatedly for each changed folder.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EX
|
2021-06-16 05:45:27 +00:00
|
|
|
|
{
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqid\(dq: 93,
|
|
|
|
|
\(dqglobalID\(dq: 93,
|
|
|
|
|
\(dqtype\(dq: \(dqFolderResumed\(dq,
|
|
|
|
|
\(dqtime\(dq: \(dq2021\-06\-07T23:45:03.414609034+02:00\(dq,
|
|
|
|
|
\(dqdata\(dq: {
|
|
|
|
|
\(dqid\(dq: \(dqabcde\-fghij\(dq,
|
|
|
|
|
\(dqlabel\(dq: \(dqMy folder\(dq
|
2021-06-16 05:45:27 +00:00
|
|
|
|
}
|
|
|
|
|
}
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EE
|
2021-06-16 05:45:27 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.SS FolderScanProgress
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.sp
|
|
|
|
|
Emitted in regular intervals (folder setting ProgressIntervalS, 2s by default)
|
|
|
|
|
during scans giving the amount of bytes already scanned and to be scanned in
|
|
|
|
|
total , as well as the current scanning rates in bytes per second.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EX
|
2020-06-22 04:15:24 +00:00
|
|
|
|
{
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqdata\(dq : {
|
|
|
|
|
\(dqtotal\(dq : 1,
|
|
|
|
|
\(dqrate\(dq : 0,
|
|
|
|
|
\(dqcurrent\(dq : 0,
|
|
|
|
|
\(dqfolder\(dq : \(dqbd7q3\-zskm5\(dq
|
2020-06-22 04:15:24 +00:00
|
|
|
|
},
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqglobalID\(dq : 29,
|
|
|
|
|
\(dqtype\(dq : \(dqFolderScanProgress\(dq,
|
|
|
|
|
\(dqtime\(dq : \(dq2017\-03\-06T15:00:58.072004209+01:00\(dq,
|
|
|
|
|
\(dqid\(dq : 29
|
2020-06-22 04:15:24 +00:00
|
|
|
|
}
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EE
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.SS FolderSummary
|
|
|
|
|
.sp
|
|
|
|
|
The FolderSummary event is emitted when folder contents have changed
|
|
|
|
|
locally. This can be used to calculate the current local completion
|
|
|
|
|
state.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EX
|
2020-06-22 04:15:24 +00:00
|
|
|
|
{
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqid\(dq: 16,
|
|
|
|
|
\(dqtype\(dq: \(dqFolderSummary\(dq,
|
2024-02-05 03:45:33 +00:00
|
|
|
|
\(dqtime\(dq: \(dq2024\-01\-31T08:27:30.777875+01:00\(dq,
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqdata\(dq: {
|
|
|
|
|
\(dqfolder\(dq: \(dqdefault\(dq,
|
|
|
|
|
\(dqsummary\(dq: {
|
2024-02-05 03:45:33 +00:00
|
|
|
|
\(dqerror\(dq: \(dq\(dq,
|
|
|
|
|
\(dqerrors\(dq: 0,
|
|
|
|
|
\(dqglobalBytes\(dq: 4,
|
|
|
|
|
\(dqglobalDeleted\(dq: 18664,
|
|
|
|
|
\(dqglobalDirectories\(dq: 0,
|
|
|
|
|
\(dqglobalFiles\(dq: 1,
|
|
|
|
|
\(dqglobalSymlinks\(dq: 0,
|
|
|
|
|
\(dqglobalTotalItems\(dq: 18665,
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqignorePatterns\(dq: false,
|
2024-02-05 03:45:33 +00:00
|
|
|
|
\(dqinSyncBytes\(dq: 4,
|
|
|
|
|
\(dqinSyncFiles\(dq: 1,
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqinvalid\(dq: \(dq\(dq,
|
2024-02-05 03:45:33 +00:00
|
|
|
|
\(dqlocalBytes\(dq: 4,
|
|
|
|
|
\(dqlocalDeleted\(dq: 18664,
|
|
|
|
|
\(dqlocalDirectories\(dq: 0,
|
|
|
|
|
\(dqlocalFiles\(dq: 1,
|
|
|
|
|
\(dqlocalSymlinks\(dq: 0,
|
|
|
|
|
\(dqlocalTotalItems\(dq: 18665,
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqneedBytes\(dq: 0,
|
2024-02-05 03:45:33 +00:00
|
|
|
|
\(dqneedDeletes\(dq: 0,
|
|
|
|
|
\(dqneedDirectories\(dq: 0,
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqneedFiles\(dq: 0,
|
2024-02-05 03:45:33 +00:00
|
|
|
|
\(dqneedSymlinks\(dq: 0,
|
|
|
|
|
\(dqneedTotalItems\(dq: 0,
|
|
|
|
|
\(dqpullErrors\(dq: 0,
|
|
|
|
|
\(dqreceiveOnlyChangedBytes\(dq: 0,
|
|
|
|
|
\(dqreceiveOnlyChangedDeletes\(dq: 0,
|
|
|
|
|
\(dqreceiveOnlyChangedDirectories\(dq: 0,
|
|
|
|
|
\(dqreceiveOnlyChangedFiles\(dq: 0,
|
|
|
|
|
\(dqreceiveOnlyChangedSymlinks\(dq: 0,
|
|
|
|
|
\(dqreceiveOnlyTotalItems\(dq: 0,
|
|
|
|
|
\(dqremoteSequence\(dq: {
|
|
|
|
|
\(dqMRIW7OK\-NETT3M4\-N6SBWME\-N25O76W\-YJKVXPH\-FUMQJ3S\-P57B74J\-GBITBAC\(dq: 37329
|
|
|
|
|
},
|
|
|
|
|
\(dqsequence\(dq: 37329,
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqstate\(dq: \(dqidle\(dq,
|
2024-02-05 03:45:33 +00:00
|
|
|
|
\(dqstateChanged\(dq: \(dq2024\-01\-31T08:27:24+01:00\(dq,
|
|
|
|
|
\(dqversion\(dq: 37329,
|
|
|
|
|
\(dqwatchError\(dq: \(dq\(dq
|
2020-06-22 04:15:24 +00:00
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EE
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
2022-03-21 03:47:47 +00:00
|
|
|
|
.SS FolderWatchStateChanged
|
|
|
|
|
.sp
|
|
|
|
|
The \fBFolderWatchStateChanged\fP event is emitted when a folder’s watcher routine
|
|
|
|
|
encounters a new error, or when a previous error disappeared after retrying.
|
|
|
|
|
The event contains the ID of the affected folder and textual error messages
|
|
|
|
|
describing the previous (\fBfrom\fP) and the updated (\fBto\fP) error conditions.
|
|
|
|
|
If there was no error in either of these, the respective field is omitted.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EX
|
2022-03-21 03:47:47 +00:00
|
|
|
|
{
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqid\(dq: 123,
|
|
|
|
|
\(dqtype\(dq: \(dqFolderWatchStateChanged\(dq,
|
|
|
|
|
\(dqtime\(dq: \(dq2022\-03\-14T12:34:56.890000000+01:00\(dq,
|
|
|
|
|
\(dqdata\(dq: {
|
|
|
|
|
\(dqfolder\(dq: \(dqdefault\(dq,
|
|
|
|
|
\(dqfrom\(dq: \(dqSomething bad happened.\(dq,
|
|
|
|
|
\(dqto\(dq: \(dqSomething worse happened.\(dq
|
2022-03-21 03:47:47 +00:00
|
|
|
|
}
|
|
|
|
|
}
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EE
|
2022-03-21 03:47:47 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.SS ItemFinished
|
|
|
|
|
.sp
|
|
|
|
|
Generated when Syncthing ends synchronizing a file to a newer version. A
|
|
|
|
|
successful operation:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EX
|
2020-06-22 04:15:24 +00:00
|
|
|
|
{
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqid\(dq: 93,
|
|
|
|
|
\(dqglobalID\(dq: 93,
|
|
|
|
|
\(dqtype\(dq: \(dqItemFinished\(dq,
|
|
|
|
|
\(dqtime\(dq: \(dq2014\-07\-13T21:22:03.414609034+02:00\(dq,
|
|
|
|
|
\(dqdata\(dq: {
|
|
|
|
|
\(dqitem\(dq: \(dqtest.txt\(dq,
|
|
|
|
|
\(dqfolder\(dq: \(dqdefault\(dq,
|
|
|
|
|
\(dqerror\(dq: null,
|
|
|
|
|
\(dqtype\(dq: \(dqfile\(dq,
|
|
|
|
|
\(dqaction\(dq: \(dqupdate\(dq
|
2020-06-22 04:15:24 +00:00
|
|
|
|
}
|
|
|
|
|
}
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EE
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
An unsuccessful operation:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EX
|
2020-06-22 04:15:24 +00:00
|
|
|
|
{
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqid\(dq: 44,
|
|
|
|
|
\(dqglobalID\(dq: 44,
|
|
|
|
|
\(dqtype\(dq: \(dqItemFinished\(dq,
|
|
|
|
|
\(dqtime\(dq: \(dq2015\-05\-27T11:21:05.711133004+02:00\(dq,
|
|
|
|
|
\(dqdata\(dq: {
|
|
|
|
|
\(dqaction\(dq: \(dqupdate\(dq,
|
|
|
|
|
\(dqerror\(dq: \(dqopen /Users/jb/src/github.com/syncthing/syncthing/test/s2/foo/.syncthing.hej.tmp: permission denied\(dq,
|
|
|
|
|
\(dqfolder\(dq: \(dqdefault\(dq,
|
|
|
|
|
\(dqitem\(dq: \(dqfoo/hej\(dq,
|
|
|
|
|
\(dqtype\(dq: \(dqfile\(dq
|
2020-06-22 04:15:24 +00:00
|
|
|
|
}
|
|
|
|
|
}
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EE
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
The \fBaction\fP field is either \fBupdate\fP (contents changed), \fBmetadata\fP (file metadata changed but not contents), or \fBdelete\fP\&.
|
|
|
|
|
.sp
|
2024-05-13 03:45:18 +00:00
|
|
|
|
Added in version 0.11.10: The \fBmetadata\fP action.
|
2020-06-22 04:15:24 +00:00
|
|
|
|
|
|
|
|
|
.SS ItemStarted
|
|
|
|
|
.sp
|
|
|
|
|
Generated when Syncthing begins synchronizing a file to a newer version.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EX
|
2020-06-22 04:15:24 +00:00
|
|
|
|
{
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqid\(dq: 93,
|
|
|
|
|
\(dqglobalID\(dq: 93,
|
|
|
|
|
\(dqtype\(dq: \(dqItemStarted\(dq,
|
|
|
|
|
\(dqtime\(dq: \(dq2014\-07\-13T21:22:03.414609034+02:00\(dq,
|
|
|
|
|
\(dqdata\(dq: {
|
|
|
|
|
\(dqitem\(dq: \(dqtest.txt\(dq,
|
|
|
|
|
\(dqfolder\(dq: \(dqdefault\(dq,
|
|
|
|
|
\(dqtype\(dq: \(dqfile\(dq,
|
|
|
|
|
\(dqaction\(dq: \(dqupdate\(dq
|
2020-06-22 04:15:24 +00:00
|
|
|
|
}
|
|
|
|
|
}
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EE
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
The \fBaction\fP field is either \fBupdate\fP (contents changed), \fBmetadata\fP (file metadata changed but not contents), or \fBdelete\fP\&.
|
|
|
|
|
.sp
|
2024-05-13 03:45:18 +00:00
|
|
|
|
Added in version 0.11.10: The \fBmetadata\fP action.
|
2020-06-22 04:15:24 +00:00
|
|
|
|
|
2021-06-16 05:45:27 +00:00
|
|
|
|
.SS ListenAddressesChanged
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.sp
|
2024-07-22 03:45:28 +00:00
|
|
|
|
This event is emitted when a \fI\%listen address\fP changes.
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EX
|
2020-06-22 04:15:24 +00:00
|
|
|
|
{
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqtype\(dq : \(dqListenAddressesChanged\(dq,
|
|
|
|
|
\(dqid\(dq : 70,
|
|
|
|
|
\(dqtime\(dq : \(dq2017\-03\-06T15:01:24.88340663+01:00\(dq,
|
|
|
|
|
\(dqglobalID\(dq : 70,
|
|
|
|
|
\(dqdata\(dq : {
|
|
|
|
|
\(dqaddress\(dq : {
|
|
|
|
|
\(dqFragment\(dq : \(dq\(dq,
|
|
|
|
|
\(dqRawQuery\(dq : \(dq\(dq,
|
|
|
|
|
\(dqScheme\(dq : \(dqdynamic+https\(dq,
|
|
|
|
|
\(dqPath\(dq : \(dq/endpoint\(dq,
|
|
|
|
|
\(dqRawPath\(dq : \(dq\(dq,
|
|
|
|
|
\(dqUser\(dq : null,
|
|
|
|
|
\(dqForceQuery\(dq : false,
|
|
|
|
|
\(dqHost\(dq : \(dqrelays.syncthing.net\(dq,
|
|
|
|
|
\(dqOpaque\(dq : \(dq\(dq
|
2020-06-22 04:15:24 +00:00
|
|
|
|
},
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqwan\(dq : [
|
2020-06-22 04:15:24 +00:00
|
|
|
|
{
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqForceQuery\(dq : false,
|
|
|
|
|
\(dqUser\(dq : null,
|
|
|
|
|
\(dqHost\(dq : \(dq31.15.66.212:443\(dq,
|
|
|
|
|
\(dqOpaque\(dq : \(dq\(dq,
|
|
|
|
|
\(dqPath\(dq : \(dq/\(dq,
|
|
|
|
|
\(dqRawPath\(dq : \(dq\(dq,
|
|
|
|
|
\(dqRawQuery\(dq : \(dqid=F4HSJVO\-CP2C3IL\-YLQYLSU\-XTYODAG\-PPU4LGV\-PH3MU4N\-G6K56DV\-IPN47A&pingInterval=1m0s&networkTimeout=2m0s&sessionLimitBps=0&globalLimitBps=0&statusAddr=:22070&providedBy=\(dq,
|
|
|
|
|
\(dqScheme\(dq : \(dqrelay\(dq,
|
|
|
|
|
\(dqFragment\(dq : \(dq\(dq
|
2020-06-22 04:15:24 +00:00
|
|
|
|
}
|
|
|
|
|
],
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqlan\(dq : [
|
2020-06-22 04:15:24 +00:00
|
|
|
|
{
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqRawQuery\(dq : \(dqid=F4HSJVO\-CP2C3IL\-YLQYLSU\-XTYODAG\-PPU4LGV\-PH3MU4N\-G6K56DV\-IPN47A&pingInterval=1m0s&networkTimeout=2m0s&sessionLimitBps=0&globalLimitBps=0&statusAddr=:22070&providedBy=\(dq,
|
|
|
|
|
\(dqScheme\(dq : \(dqrelay\(dq,
|
|
|
|
|
\(dqFragment\(dq : \(dq\(dq,
|
|
|
|
|
\(dqRawPath\(dq : \(dq\(dq,
|
|
|
|
|
\(dqPath\(dq : \(dq/\(dq,
|
|
|
|
|
\(dqHost\(dq : \(dq31.15.66.212:443\(dq,
|
|
|
|
|
\(dqOpaque\(dq : \(dq\(dq,
|
|
|
|
|
\(dqForceQuery\(dq : false,
|
|
|
|
|
\(dqUser\(dq : null
|
2020-06-22 04:15:24 +00:00
|
|
|
|
}
|
|
|
|
|
]
|
|
|
|
|
}
|
|
|
|
|
}
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EE
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.SS LocalChangeDetected
|
|
|
|
|
.sp
|
|
|
|
|
Generated upon scan whenever the local disk has discovered an updated file from the
|
|
|
|
|
previous scan. This does \fInot\fP include events that are discovered and copied from
|
2023-09-18 03:45:31 +00:00
|
|
|
|
other devices (\fI\%RemoteChangeDetected\fP), only files that were changed on the
|
2020-06-22 04:15:24 +00:00
|
|
|
|
local filesystem.
|
2022-03-21 03:47:47 +00:00
|
|
|
|
.sp
|
|
|
|
|
\fBNOTE:\fP
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
2023-09-18 03:45:31 +00:00
|
|
|
|
This event is not included in \fI\%GET /rest/events\fP endpoint without
|
2022-03-21 03:47:47 +00:00
|
|
|
|
a mask specified, but needs to be selected explicitly.
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EX
|
2020-06-22 04:15:24 +00:00
|
|
|
|
{
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqid\(dq: 7,
|
|
|
|
|
\(dqglobalID\(dq: 59,
|
|
|
|
|
\(dqtime\(dq: \(dq2016\-09\-26T22:07:10.7189141\-04:00\(dq,
|
|
|
|
|
\(dqtype\(dq: \(dqLocalChangeDetected\(dq,
|
|
|
|
|
\(dqdata\(dq: {
|
|
|
|
|
\(dqaction\(dq: \(dqdeleted\(dq,
|
|
|
|
|
\(dqfolder\(dq: \(dqvitwy\-zjxqt\(dq,
|
|
|
|
|
\(dqfolderID\(dq: \(dqvitwy\-zjxqt\(dq,
|
|
|
|
|
\(dqlabel\(dq: \(dqTestSync\(dq,
|
|
|
|
|
\(dqpath\(dq: \(dqtest file.rtf\(dq,
|
|
|
|
|
\(dqtype\(dq: \(dqfile\(dq
|
2020-06-22 04:15:24 +00:00
|
|
|
|
}
|
|
|
|
|
}
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EE
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
2022-05-09 03:58:03 +00:00
|
|
|
|
.sp
|
|
|
|
|
Deprecated since version v1.1.2: The \fBfolderID\fP field is a legacy name kept only for compatibility. Use the
|
|
|
|
|
\fBfolder\fP field with identical content instead.
|
|
|
|
|
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.SS LocalIndexUpdated
|
|
|
|
|
.sp
|
|
|
|
|
Generated when the local index information has changed, due to
|
|
|
|
|
synchronizing one or more items from the cluster or discovering local
|
|
|
|
|
changes during a scan.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EX
|
2020-06-22 04:15:24 +00:00
|
|
|
|
{
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqid\(dq: 59,
|
|
|
|
|
\(dqglobalID\(dq: 59,
|
|
|
|
|
\(dqtype\(dq: \(dqLocalIndexUpdated\(dq,
|
|
|
|
|
\(dqtime\(dq: \(dq2014\-07\-17T13:27:28.051369434+02:00\(dq,
|
|
|
|
|
\(dqdata\(dq: {
|
|
|
|
|
\(dqfolder\(dq: \(dqdefault\(dq,
|
|
|
|
|
\(dqitems\(dq: 1000,
|
|
|
|
|
\(dqfilenames\(dq: [
|
|
|
|
|
\(dqfoo\(dq,
|
|
|
|
|
\(dqbar\(dq,
|
|
|
|
|
\(dqbaz\(dq
|
2022-05-09 03:58:03 +00:00
|
|
|
|
],
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqsequence\(dq: 12345,
|
|
|
|
|
\(dqversion\(dq: 12345
|
2020-06-22 04:15:24 +00:00
|
|
|
|
}
|
|
|
|
|
}
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EE
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
2022-05-09 03:58:03 +00:00
|
|
|
|
.sp
|
|
|
|
|
Deprecated since version v1.10.0: The \fBversion\fP field is a legacy name kept only for compatibility. Use the
|
|
|
|
|
\fBsequence\fP field with identical content instead.
|
|
|
|
|
|
2021-06-16 05:45:27 +00:00
|
|
|
|
.SS LoginAttempt
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.sp
|
|
|
|
|
When authentication is enabled for the GUI, this event is emitted on every
|
|
|
|
|
login attempt. If either the username or password are incorrect, \fBsuccess\fP
|
2021-04-14 05:45:37 +00:00
|
|
|
|
is false and in any case the given username is returned. The included
|
|
|
|
|
remote address concerns the immediate connecting host, which may not be the
|
|
|
|
|
origin of the request, but e.g. a reverse proxy.
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EX
|
2020-06-22 04:15:24 +00:00
|
|
|
|
{
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqid\(dq : 187,
|
|
|
|
|
\(dqtime\(dq : \(dq2017\-03\-07T00:19:24.420386143+01:00\(dq,
|
|
|
|
|
\(dqdata\(dq : {
|
|
|
|
|
\(dqremoteAddress\(dq : \(dq127.0.0.1:55530\(dq,
|
|
|
|
|
\(dqusername\(dq : \(dqsomename\(dq,
|
|
|
|
|
\(dqsuccess\(dq : false
|
2020-06-22 04:15:24 +00:00
|
|
|
|
},
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqtype\(dq : \(dqLoginAttempt\(dq,
|
|
|
|
|
\(dqglobalID\(dq : 195
|
2020-06-22 04:15:24 +00:00
|
|
|
|
}
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EE
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
2021-01-27 06:45:21 +00:00
|
|
|
|
.SS PendingDevicesChanged
|
|
|
|
|
.sp
|
2024-05-13 03:45:18 +00:00
|
|
|
|
Added in version 1.14.0.
|
2021-01-27 06:45:21 +00:00
|
|
|
|
|
|
|
|
|
.sp
|
|
|
|
|
Emitted when pending devices were added / updated (connection from
|
2021-06-16 05:45:27 +00:00
|
|
|
|
unknown ID) or removed (device is ignored, dismissed or added).
|
2021-01-27 06:45:21 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EX
|
2021-01-27 06:45:21 +00:00
|
|
|
|
{
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqid\(dq: 87,
|
|
|
|
|
\(dqtype\(dq: \(dqPendingDevicesChanged\(dq,
|
|
|
|
|
\(dqtime\(dq: \(dq2020\-12\-22T22:24:37.578586718+01:00\(dq,
|
|
|
|
|
\(dqdata\(dq: {
|
|
|
|
|
\(dqadded\(dq: [
|
2021-01-27 06:45:21 +00:00
|
|
|
|
{
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqaddress\(dq: \(dq127.0.0.1:51807\(dq,
|
|
|
|
|
\(dqdeviceID\(dq: \(dqEJHMPAQ\-OGCVORE\-ISB4IS3\-SYYVJXF\-TKJGLTU\-66DIQPF\-GJ5D2GX\-GQ3OWQK\(dq,
|
|
|
|
|
\(dqname\(dq: \(dqMy dusty computer\(dq
|
2021-01-27 06:45:21 +00:00
|
|
|
|
}
|
|
|
|
|
],
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqremoved\(dq: [
|
2021-01-27 06:45:21 +00:00
|
|
|
|
{
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqdeviceID\(dq: \(dqP56IOI7\-MZJNU2Y\-IQGDREY\-DM2MGTI\-MGL3BXN\-PQ6W5BM\-TBBZ4TJ\-XZWICQ2\(dq
|
2021-01-27 06:45:21 +00:00
|
|
|
|
}
|
|
|
|
|
]
|
|
|
|
|
}
|
|
|
|
|
}
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EE
|
2021-01-27 06:45:21 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.SS PendingFoldersChanged
|
|
|
|
|
.sp
|
2024-05-13 03:45:18 +00:00
|
|
|
|
Added in version 1.14.0.
|
2021-01-27 06:45:21 +00:00
|
|
|
|
|
|
|
|
|
.sp
|
|
|
|
|
Emitted when pending folders were added / updated (offered by some
|
2021-06-16 05:45:27 +00:00
|
|
|
|
device, but not shared to them) or removed (folder ignored, dismissed
|
|
|
|
|
or added or no longer offered from the remote device). A removed
|
|
|
|
|
entry without a \fBdeviceID\fP attribute means that the folder is no
|
|
|
|
|
longer pending for any device.
|
2021-01-27 06:45:21 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EX
|
2021-01-27 06:45:21 +00:00
|
|
|
|
{
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqid\(dq: 101,
|
|
|
|
|
\(dqtype\(dq: \(dqPendingFoldersChanged\(dq,
|
|
|
|
|
\(dqtime\(dq: \(dq2020\-12\-22T22:36:55.66744317+01:00\(dq,
|
|
|
|
|
\(dqdata\(dq: {
|
|
|
|
|
\(dqadded\(dq: [
|
2021-01-27 06:45:21 +00:00
|
|
|
|
{
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqdeviceID\(dq: \(dqEJHMPAQ\-OGCVORE\-ISB4IS3\-SYYVJXF\-TKJGLTU\-66DIQPF\-GJ5D2GX\-GQ3OWQK\(dq,
|
|
|
|
|
\(dqfolderID\(dq: \(dqGXWxf\-3zgnU\(dq,
|
|
|
|
|
\(dqfolderLabel\(dq: \(dqMy Pictures\(dq
|
|
|
|
|
\(dqreceiveEncrypted\(dq: \(dqfalse\(dq
|
|
|
|
|
\(dqremoteEncrypted\(dq: \(dqfalse\(dq
|
2021-01-27 06:45:21 +00:00
|
|
|
|
}
|
|
|
|
|
],
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqremoved\(dq: [
|
2021-01-27 06:45:21 +00:00
|
|
|
|
{
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqdeviceID\(dq: \(dqP56IOI7\-MZJNU2Y\-IQGDREY\-DM2MGTI\-MGL3BXN\-PQ6W5BM\-TBBZ4TJ\-XZWICQ2\(dq,
|
|
|
|
|
\(dqfolderID\(dq: \(dqneyfh\-sa2nu\(dq
|
2021-06-16 05:45:27 +00:00
|
|
|
|
},
|
|
|
|
|
{
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqfolderID\(dq: \(dqabcde\-fghij\(dq
|
2021-01-27 06:45:21 +00:00
|
|
|
|
}
|
|
|
|
|
]
|
|
|
|
|
}
|
|
|
|
|
}
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EE
|
2021-01-27 06:45:21 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.SS RemoteChangeDetected
|
|
|
|
|
.sp
|
|
|
|
|
Generated upon scan whenever a file is locally updated due to a remote change.
|
2023-09-18 03:45:31 +00:00
|
|
|
|
Files that are updated locally produce a \fI\%LocalChangeDetected\fP event.
|
2022-03-21 03:47:47 +00:00
|
|
|
|
.sp
|
|
|
|
|
\fBNOTE:\fP
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
2023-09-18 03:45:31 +00:00
|
|
|
|
This event is not included in \fI\%GET /rest/events\fP endpoint without
|
2022-03-21 03:47:47 +00:00
|
|
|
|
a mask specified, but needs to be selected explicitly.
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EX
|
2020-06-22 04:15:24 +00:00
|
|
|
|
{
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqtime\(dq : \(dq2017\-03\-06T23:58:21.844739891+01:00\(dq,
|
|
|
|
|
\(dqglobalID\(dq : 123,
|
|
|
|
|
\(dqdata\(dq : {
|
|
|
|
|
\(dqtype\(dq : \(dqfile\(dq,
|
|
|
|
|
\(dqaction\(dq : \(dqdeleted\(dq,
|
|
|
|
|
\(dqfolder\(dq: \(dqDokumente\(dq,
|
|
|
|
|
\(dqfolderID\(dq : \(dqDokumente\(dq,
|
|
|
|
|
\(dqpath\(dq : \(dqtestfile\(dq,
|
|
|
|
|
\(dqlabel\(dq : \(dqDokumente\(dq,
|
|
|
|
|
\(dqmodifiedBy\(dq : \(dqBPDFDTU\(dq
|
2020-06-22 04:15:24 +00:00
|
|
|
|
},
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqtype\(dq : \(dqRemoteChangeDetected\(dq,
|
|
|
|
|
\(dqid\(dq : 2
|
2020-06-22 04:15:24 +00:00
|
|
|
|
}
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EE
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
2022-05-09 03:58:03 +00:00
|
|
|
|
.sp
|
|
|
|
|
Deprecated since version v1.1.2: The \fBfolderID\fP field is a legacy name kept only for compatibility. Use the
|
|
|
|
|
\fBfolder\fP field with identical content instead.
|
|
|
|
|
|
2021-06-16 05:45:27 +00:00
|
|
|
|
.SS RemoteDownloadProgress
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.sp
|
2024-07-22 03:45:28 +00:00
|
|
|
|
This event is emitted when a \fI\%DownloadProgress\fP message is
|
2020-06-22 04:15:24 +00:00
|
|
|
|
received. It returns a map \fBdata\fP of filenames with a count of
|
|
|
|
|
downloaded blocks. The files in questions are currently being
|
|
|
|
|
downloaded on the remote \fBdevice\fP and belong to \fBfolder\fP\&.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EX
|
2020-06-22 04:15:24 +00:00
|
|
|
|
{
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqtime\(dq : \(dq2017\-03\-07T00:11:37.65838955+01:00\(dq,
|
|
|
|
|
\(dqglobalID\(dq : 170,
|
|
|
|
|
\(dqdata\(dq : {
|
|
|
|
|
\(dqstate\(dq : {
|
|
|
|
|
\(dqtahr64\-6.0.5.iso\(dq : 1784
|
2020-06-22 04:15:24 +00:00
|
|
|
|
},
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqdevice\(dq : \(dqF4HSJVO\-CP2C3IL\-YLQYLSU\-XTYODAG\-PPU4LGV\-PH3MU4N\-G6K56DV\-IPN47A\(dq,
|
|
|
|
|
\(dqfolder\(dq : \(dqDokumente\(dq
|
2020-06-22 04:15:24 +00:00
|
|
|
|
},
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqtype\(dq : \(dqRemoteDownloadProgress\(dq,
|
|
|
|
|
\(dqid\(dq : 163
|
2020-06-22 04:15:24 +00:00
|
|
|
|
}
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EE
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.SS RemoteIndexUpdated
|
|
|
|
|
.sp
|
|
|
|
|
Generated each time new index information is received from a device.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EX
|
2020-06-22 04:15:24 +00:00
|
|
|
|
{
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqid\(dq: 44,
|
|
|
|
|
\(dqglobalID\(dq: 44,
|
|
|
|
|
\(dqtype\(dq: \(dqRemoteIndexUpdated\(dq,
|
|
|
|
|
\(dqtime\(dq: \(dq2014\-07\-13T21:04:35.394184435+02:00\(dq,
|
|
|
|
|
\(dqdata\(dq: {
|
|
|
|
|
\(dqdevice\(dq: \(dqNFGKEKE\-7Z6RTH7\-I3PRZXS\-DEJF3UJ\-FRWJBFO\-VBBTDND\-4SGNGVZ\-QUQHJAG\(dq,
|
|
|
|
|
\(dqfolder\(dq: \(dqlightroom\(dq,
|
|
|
|
|
\(dqitems\(dq: 1000
|
2020-06-22 04:15:24 +00:00
|
|
|
|
}
|
|
|
|
|
}
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EE
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.SS Starting
|
|
|
|
|
.sp
|
|
|
|
|
Emitted exactly once, when Syncthing starts, before parsing
|
|
|
|
|
configuration etc.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EX
|
2020-06-22 04:15:24 +00:00
|
|
|
|
{
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqid\(dq: 1,
|
|
|
|
|
\(dqglobalID\(dq: 1,
|
|
|
|
|
\(dqtype\(dq: \(dqStarting\(dq,
|
|
|
|
|
\(dqtime\(dq: \(dq2014\-07\-17T13:13:32.044470055+02:00\(dq,
|
|
|
|
|
\(dqdata\(dq: {
|
|
|
|
|
\(dqhome\(dq: \(dq/home/jb/.config/syncthing\(dq
|
2020-06-22 04:15:24 +00:00
|
|
|
|
}
|
|
|
|
|
}
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EE
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.SS StartupComplete
|
|
|
|
|
.sp
|
|
|
|
|
Emitted exactly once, when initialization is complete and Syncthing is
|
|
|
|
|
ready to start exchanging data with other devices.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EX
|
2020-06-22 04:15:24 +00:00
|
|
|
|
{
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqid\(dq: 1,
|
|
|
|
|
\(dqglobalID\(dq: 1,
|
|
|
|
|
\(dqtype\(dq: \(dqStartupComplete\(dq,
|
|
|
|
|
\(dqtime\(dq: \(dq2014\-07\-13T21:03:18.383239179+02:00\(dq,
|
|
|
|
|
\(dqdata\(dq: null
|
2020-06-22 04:15:24 +00:00
|
|
|
|
}
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EE
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.SS StateChanged
|
|
|
|
|
.sp
|
|
|
|
|
Emitted when a folder changes state. Possible states are \fBidle\fP,
|
|
|
|
|
\fBscanning\fP, \fBsyncing\fP and \fBerror\fP\&. The field \fBduration\fP is
|
|
|
|
|
the number of seconds the folder spent in state \fBfrom\fP\&. In the example
|
|
|
|
|
below, the folder \fBdefault\fP was in state \fBscanning\fP for 0.198
|
|
|
|
|
seconds and is now in state \fBidle\fP\&.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EX
|
2020-06-22 04:15:24 +00:00
|
|
|
|
{
|
2023-09-18 03:45:31 +00:00
|
|
|
|
\(dqid\(dq: 8,
|
|
|
|
|
\(dqglobalID\(dq: 8,
|
|
|
|
|
\(dqtype\(dq: \(dqStateChanged\(dq,
|
|
|
|
|
\(dqtime\(dq: \(dq2014\-07\-17T13:14:28.697493016+02:00\(dq,
|
|
|
|
|
\(dqdata\(dq: {
|
|
|
|
|
\(dqfolder\(dq: \(dqdefault\(dq,
|
|
|
|
|
\(dqfrom\(dq: \(dqscanning\(dq,
|
|
|
|
|
\(dqduration\(dq: 0.19782869900000002,
|
|
|
|
|
\(dqto\(dq: \(dqidle\(dq
|
2020-06-22 04:15:24 +00:00
|
|
|
|
}
|
|
|
|
|
}
|
2024-05-13 03:45:18 +00:00
|
|
|
|
.EE
|
2020-06-22 04:15:24 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.SH AUTHOR
|
|
|
|
|
The Syncthing Authors
|
|
|
|
|
.SH COPYRIGHT
|
|
|
|
|
2014-2019, The Syncthing Authors
|
|
|
|
|
.\" Generated by docutils manpage writer.
|
|
|
|
|
.
|