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):
- Text file mask for text mode transfers.
- Ignore mask for transfers.
- Selecting/unselecting files by file mask.
- Defining autoselection rule for transfer settings preset.
Advertisement
You can specify several masks separated by semicolon (;
).
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
.
Particularly when specifing an include mask for transfers, bear in mind that it is applied to directories as well.