This is an old revision of the document!

Masks

To use the following features of WinSCP you need to specify a mask (wildcard) to select files (or other things):

Advertisement

You can specify several masks separated by semicolon (;) or comma (,). When specifing the mask you can use following patterns:

Pattern Meaning Example
* Matches any number (including zero) of arbitrary characters. *.doc; about*.html
? Matches exactly one arbitrary character. photo????.jpg
[abc] Matches one character from the set. index_[abc].html
[a-z] Matches one character from the range. index_[a-z].html
>size Matches files (never directory) larger than size (K, M and G units can be used). This rule must be used after the file name mask (if any). *.bin>1M
<size Matches files smaller than size. <1G

All other characters are treated literally.

When the mask selects files and it makes sense to select them based on directory, you can extend the mask with a path mask. You should separate the path mask from the filename mask by a slash. For a relative path mask it makes no difference whether you use back (\) or forward slashes (/); the mask will always work for both local and remote paths. For example, the exclude mask */public_html/*.bak will exclude backup files both in D:\Documents\public_html and /home/martinp/public_html. If you want to match directories only, add a slash at the end of the mask.

Particularly when specifing an include mask for transfers, bear in mind that it is applied to directories as well, so that *.bak will only match backup files located in the current directory (unless you happen to have a subdirectory whose own name ends in “.bak”, in which case it will be applied to all backup files in there too).

Advertisement

The mask */ matches any directory. For example to transfer only HTML files located in any directory, use the include mask */; *.html.

For convenience, a masks *.* and *. are exceptions matching any file and any file without an extension, respectively, even if its name does not include any dot.

Last modified: by martin