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.
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’'.
Particularly when specifing an include mask for transfers, bear in mind that it is applied to directories as well.