This is an old revision of the document!

Masks

To use the following features of WinSCP you need to specify a mask 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

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).

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

For convenience, a mask *.* is exception matching any file, even if its name does not include any dot.

Advertisement

Last modified: by martin