Skip to content

Commit

Permalink
Add meaning of various client-side errors (#82)
Browse files Browse the repository at this point in the history 
* Add meaning of various client-side errors

* Update faq.md

---------

Co-authored-by: yangheran <[email protected]>
Co-authored-by: Jiaqiang Xu <[email protected]>
  • Loading branch information
@feiniks @killing
3 people authored Jul 29, 2024
1 parent ac524a1 commit 52c4e62
Showing 1 changed file with 37 additions and 0 deletions.
37 changes: 37 additions & 0 deletions en/faq.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -180,3 +180,40 @@ You call also use tools like NSSM (the Non-Sucking Service Manager). For more in

Windows uses only the first 15 of the entries in the registry
(HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Explorer\\ShellIconOverlayIdentifiers). If there are other programs, like Dropbox and OneDrive, use up the overlay icons, Seafile shell icon overlay will not shown. To solve the problem, just delete the registration entries of other programs.

## Meaning file syncing errors

File syncing errors are displayed in various places in Seafile desktop clients, including:

- Main window of the Sync client
- File sync error dialog in both Sync client and SeaDrive
- Notification messages

The detailed meaning of these error messages are explained below.

| Error Message | Error Meaning |
| ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| “File is locked by another application”，“Folder is locked by another application” | If these errors occur, it means that the file or directory is being locked by another application, making synchronization impossible. It is possible that a folder being locked is caused by a file inside the folder being opened by another program.。 |
| “File is locked by another user” | This error indicates that the file may have been locked by another user on the server or by another user via the client. |
| “Error when indexing” | This error indicates that the client cannot index the file properly, the file may not exist or it does not have permission to read or write this file. |
| ”Path ends with space or period characte“ | This error indicates that a file name or directory name ending with a space or dot cannot be synchronized to Windows. |
| “Path contains invalid characters like ‘\|‘ or ‘:’” | This error indicates that the file or directory name contains illegal characters like '\|' and ':' and cannot be synchronized to Windows. |
| “Update to file denied by folder permission setting” | This error indicates that the folder has been set with unwritable folder permissions on the server, making it impossible to upload or update files. |
| “Syncing is denied by cloud-only permission settings” | This error indicates that the library or subfolder has non-synchronizable sharing permissions set on the server (e.g. cloud preview), which makes it impossible to synchronize the library to the computer. |
| ”Created or updated a file in a non-writable library or folder“ | This error indicates that the library or subfolder permissions are not read-write, so the client ignores changes under that folder. |
| “Permission denied on server” | This error indicates that the library has been unshared. |
| “Do not have write permission to the library” | This error indicates that the shared permissions of the library are not read-write. |
| ”internal Server Error“ | This error indicates that synchronization was not possible due to a server error, usually caused by a library or file on the server that has become corrupted. |
| “Internal data corrupt on the client. Please try to resync the library” | This error indicates that the client's metadata has been corrupted, usually due to antivirus software mistakenly deleting the client's metadata. On Windows you need to configure your antivirus software to skip the folder C:\users\username\Seafile\seafile-data, on macOS you need to skip the folder /Users/username/Seafile/.seafile-data. |
| “Failed to write data on the client. Please check disk space or folder permissions” | This error indicates that the file could not be checked out properly due to incorrect permissions on the local directory or insufficient disk space when the file was downloaded. Both metadata directories and synchronization directories can cause this error. |
| “Not enough memor” | This error indicates that the computer does not have enough memory, causing the client to fail to allocate memory. Memory allocation may also fail due to other reasons. |
| “Concurrent updates to file. File is saved as conflict file” | This error indicates that the same file happened to be updated locally when the file was downloaded, and will save the local file as a conflict file. |
| “A folder that may contain not-yet-uploaded files is moved to seafile-recycle-bin folder.” | This error means that when a folder is deleted on the server, there are changes in the folder locally that have not been uploaded, and the folder is moved to the C:\users\username\Seafile\recycle-bin directory on Windows, or to the /Users/username/Seafile/recycle-bin directory on macOS. |
| “The file path contains symbols that are not supported by the Windows system” | This error indicates that the macOS or Linux client is uploading files or directory names that contain symbols that are not supported by Windows. This is just a warning that these files will not be synchronized to Windows and will not affect the upload. You can disable this popup in the client configuration. |
| “Library cannot be synced since it has too many files.” | This error indicates that the number of files in the library exceeds the maximum number of files that can be synchronized, and the client cannot synchronize such a library. |
| “Waiting for confirmation to delete files” | This error indicates that the number of files deleted locally at one time has exceeded the threshold that requires deletion confirmation, and a deletion confirmation operation is required.By default, more than 500 files need to be deleted at one time. Users can modify this threshold in the client configuration. |
| “Files cannot be uploaded to this library due to file number limit settings.” | This error indicates that the number of files in the library is about to exceed the library's file count limit, and the server is refusing to upload more files. |
| “Failed to upload file blocks. Please check network or firewall” | Since the client uploads files in batches, some blocks of files can cause this error when they are not uploaded to the server properly due to network or firewall settings. |
| “Path has character case conflict with existing file or folder. Will not be downloaded” | This error indicates that a file with the same name but a different case has been included locally when the file was downloaded, which is caused by the fact that macOS and Windows are not case-sensitive. |

​

0 comments on commit 52c4e62

Please sign in to comment.