Differences

This shows you the differences between the selected revisions of the page.

ui_properties 2022-07-21 ui_properties 2025-03-31 (current)
Line 1: Line 1:
====== Properties Dialog ====== ====== Properties Dialog ======
-In Properties Dialog you can view and [[task_properties|change]] properties of remote files and directories. To display the dialog go to //File(s) > Properties//.+In Properties Dialog you can view and [[task_properties|change]] properties of remote files and directories. To display the dialog go to //Files > Properties//.
-The dialog has two tabs. Each is described individually. +The dialog has multiple tabs. Each is described individually.
===== Common ==== ===== Common ====
Line 11: Line 11:
In the upper part of the dialog you can see information about the selected file(s). The counter will initially not include files and directories in subdirectories. Press //Calculate// button to count even these. In the upper part of the dialog you can see information about the selected file(s). The counter will initially not include files and directories in subdirectories. Press //Calculate// button to count even these.
-The //Size// field will state "Unknown", if the selection contains at least one directory. Press //Calculate// button next to it to calculate the total size of all files in the selected directories (symbolic links are not followed).+The //Size// field will state "Unknown", if the selection contains at least one directory. Press //Calculate// button next to it to calculate the total size of all files in the selected directories (symbolic links are not followed). You can also display the [[ui_file_panel#directory_sizes|directory sizes in file panels]].
When properties are shown for single symbolic link (symlink), link target will be shown in additional //Links to// field. If you need to know link target frequently, you may want to display optional //[[ui_file_panel#selecting_columns|Link target]]// column in file panel. When properties are shown for single symbolic link (symlink), link target will be shown in additional //Links to// field. If you need to know link target frequently, you may want to display optional //[[ui_file_panel#selecting_columns|Link target]]// column in file panel.
==== [[ownership]] Ownership ==== ==== [[ownership]] Ownership ====
-The //Group// and //Owner// boxes can be used to change ownership of the selected files. Initially the boxes will show current ownership as long as all of the selected files have the same owner/group. Otherwise the boxes will be empty. Leave them empty not to change the ownership, when you are changing other properties (like permissions).+The //Owner// and //Group// boxes can be used to change ownership of the selected files. Initially the boxes will show current ownership as long as all of the selected files have the same owner/group. Otherwise the boxes will be empty. Leave them empty not to change the ownership, when you are changing other properties (like permissions).
-The boxes are disabled if current [[protocols|protocol]] does not allow changing ownership.+The ownership display is not editable, if current [[protocols|protocol]] does not allow changing ownership.
Some protocols may allow changing ownership by specifying UID/GID numbers only. In that case you will see both username/groupname and %%UID%%/%%GID%% in the boxes in form //name [number]//. If you want to change ownership specify new number only. ((In some cases WinSCP may be able to resolve the %%UID%%/%%GID%% itself if you specify username/groupname instead. However the only certain method is specifying the number.)) You can overcome this limitation by defining [[custom_commands#ownership|appropriate custom command]]. Some protocols may allow changing ownership by specifying UID/GID numbers only. In that case you will see both username/groupname and %%UID%%/%%GID%% in the boxes in form //name [number]//. If you want to change ownership specify new number only. ((In some cases WinSCP may be able to resolve the %%UID%%/%%GID%% itself if you specify username/groupname instead. However the only certain method is specifying the number.)) You can overcome this limitation by defining [[custom_commands#ownership|appropriate custom command]].
Line 40: Line 40:
&screenshotpict(properties_checksum) &screenshotpict(properties_checksum)
-The //Checksum// tab lets you calculate checksum/hash of selected file or files. The feature is available with [[sftp|SFTP]] and [[ftp|FTP]] protocols, subject to support of [[protocols|respective protocol extension]].+The //Checksum// tab lets you calculate checksum/hash of selected file or files. The feature is available with [[sftp|SFTP]] and [[ftp|FTP]] protocols, subject to support of [[protocols#checksum|respective protocol extension]].
-Use //Algorithm// selection to choose checksum/hash algorithm. With SFTP protocol, the drop·down list contains standard algorithms,((The protocol does not allow the server to provide list of algorithms it supports.)) however you can type in name of any other algorithm supported by the server. With FTP protocol, the drop·down list contains algorithms that the server is known to support, there's no point trying other algorithms.+Use //Algorithm// selection to choose checksum/hash algorithm. With SFTP protocol, the drop-down list contains standard algorithms,((The protocol does not allow the server to provide list of algorithms it supports.)) however you can type in name of any other algorithm supported by the server. With FTP protocol, the drop-down list contains algorithms that the server is known to support, there's no point trying other algorithms.
Use button //Calculate checksum// to request the calculation. Use button //Calculate checksum// to request the calculation.
You can copy the calculated checksum(s) to clipboard using //Copy// command of the display context menu. You can copy the calculated checksum(s) to clipboard using //Copy// command of the display context menu.
 +
 +//Alternatively, you can use [[library_example_verify_file_checksum|//Verify Checksum//]] WinSCP extension to compare checksums of local and remote files.//
 +
 +===== [[tags]] Tags =====
 +
 +&screenshotpict(properties_tags)
 +
 +The //Tags// tab lets you manage tags of [[s3|S3]] files/objects. The tab is shown with S3 protocol and when single file is selected only.
 +
 +The list shows existing tags associated with the file. Use button //Add// to add new tag. Use button //Edit// to edit selected tag. In both cases, Tag dialog will appear. On the Tag dialog you can specify a tag key and an optional tag value.
 +
 +Use button //Remove// to remove selected tag.
 +

Last modified: by martin