On several occasions you may need, or you may have the opportunity to set remote file permissions (Unix-style). This includes:
- Setting transfer options when
- Explicitly changing file permissions.
Dialogs associated with the above operations will include box (or popup box) similar to the one below.
The rows of checkboxes are used to set/unset specific permissions for the Owner (the owner of the file); the Group (members of file group); and Others (all others). The label R stands for “read permissions”, W for “write” and X for “execute”. For directories the “execute permission” means permission to enter the directory (make it working directory).
There are three special permissions. Set UID and Set GID are used with executable files. They grant the user, who executes the file, permissions of file owner or group, respectively. Sticky bit for executable files makes the kernel keep the memory image of the process after it has terminated, in order to avoid the overhead of reloading it when it is re-invoked. Sticky bit for directories ensures that only the owner of a file can remove or delete the file or directory.
Note that while non-Unix systems are usually able to map the 9 simple Unix-style permissions to their own style, they probably won’t be able to handle the 3 special permissions.
Also not all Unix SFTP servers are able to set the special permissions.
When explicitly changing permissions of existing remote files, the checkboxes can be set to undefined state.1 It means that the particular permissions should be left to its current state. This is useful when you want to change one particular permission for set of files/directories that have different permissions.
Note that this will not work fully for SCP protocol for files in subdirectories.
The Octal box shows octal number representation of the permissions set by the above checkboxes. You can enter the octal format directly instead of manually ticking the checkboxes. If you enter only three numbers, the leading zero for unset special permissions is added automatically. When any of the checkboxes are in undefined state the Octal box is empty.
Note that if permissions box pops up from an edit box, you can enter permissions in octal format directly into the edit box, without having to pop it up.
The Add X to directories checkbox makes WinSCP add “execute” permission to directories for every permission group (owner/group/others) where there is a “read” permission set already.
The checkbox is disabled, if you check “execute” permissions explicitly for all permission groups, as it makes it effectively useless.
- Small black square on Windows 10 and Windows 8; Blue square on Windows 7 and Vista; Green square on Windows XP (all for default themes) Back