Differences
This shows you the differences between the selected revisions of the page.
| ui_properties 2009-03-01 | ui_properties 2023-03-08 (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 two tabs. Each is described individually. | ||
| 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 (symlinks 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 ==== |
| - | 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 selected files has 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 boxes are disabled 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]]. |
| ==== Permissions ==== | ==== Permissions ==== | ||
| - | The [[ui_permissions|permissions]] box can be used to change permissions of selected files. | + | The [[ui_permissions|permissions]] box can be used to change permissions of the selected files. |
| The box is disabled if current [[protocols|protocol]] does not allow changing permissions. | The box is disabled if current [[protocols|protocol]] does not allow changing permissions. | ||
| Line 29: | Line 29: | ||
| You can also set permissions for newly uploaded files directly in [[transfer settings]]. | You can also set permissions for newly uploaded files directly in [[transfer settings]]. | ||
| - | ==== Changing Properties Recursively ==== | + | ==== [[recursively]] Changing Properties Recursively ==== |
| - | If the selection contains at least one directory, there will be additional checkbox //Set group, ownership and permissions recursively//. It will make WinSCP change the properties for all files in selected directories. | + | If the selection contains at least one directory, there will be additional checkbox //Set owner, group and permissions recursively//. It will make WinSCP change the properties for all files in selected directories. |
| - | With [[protocols#sftp|SFTP]] and [[protocols#ftp|FTP]] protocols this can take considerable time as the change must be made for each file specially. With [[protocols#scp|SCP]] protocol the change is made once for each selected file or directory only, so it can be much quicker. However as consequence WinSCP will not be able to keep some properties, especially permissions, of files in subdirectories unchanged, when you request it. | + | If you do not want to change ownership recursively, make sure you blank out respective input boxes. If you do not want to change permissions recursively, select //Leave as Is// from //Permissions// box [[ui_context_menu|context menu]]. |
| - | ===== Checksum ===== | + | With [[SFTP]] and [[FTP]] protocols this can take considerable time as the change must be made for each file specially. With [[SCP]] protocol the change is made once for each selected file or directory only, so it can be much quicker. However as consequence WinSCP will not be able to keep some properties, especially permissions, of files in subdirectories unchanged, when you request it. |
| + | |||
| + | ===== [[checksum]] Checksum ===== | ||
| &screenshotpict(properties_checksum) | &screenshotpict(properties_checksum) | ||
| - | The //Checksum// tab lets you calculate checksum/hash of selected file(s). The feature is available with [[protocols#sftp|SFTP protocol]] only, subject to support of respective SFTP 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. The dropdown list contains standard algorithms, however you can type in name of any other algorithm supported by the server. 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. | ||