Wildcards for Global Filters

*

Any number of characters.

This wildcard is used in following scenarios:

• filter all files of a specific extension

• filter all files when the file name starts with a specific pattern

• filter all files under a specific directory

• filter all files under a specific drive

C:\*.log will filter all files with the .log extension on root of the C drive.

If you want to filter files with the .log extension from a folder on the C drive, you must include the path to the folder in the filter. (for example, C:\Test\*.log)

ntuser* will filter all files for which the file name starts with the word ntuser.

C:\Finance\Test\* will filter only the files in the "Test" folder under the "Finance" folder on the C drive. Any sub-folders under the "Test" folder will get backed up.

C:\* will filter all files located on root of the C drive.

**

All files and folders under a specific directory

All files and folders under a specific drive

C:\Test\Data\** will filter all files and subdirectories under and including C:\Test\Data

C:\**\Data\** will filter all files and subdirectories below and including any directory called "Data" at any level in the C: volume

G:\Users\**\xpprofile\*.log will filter all files with the .log extension from any xpprofile subdirectory under Users directory

G:\Users\**\xpprofile\ntuser* will filter all filenames starting with ntuser from any xpprofile subdirectory under Users directory

C:\** will filter all the directories located on C drive

C:\**\* will filter all the files and directories on C drive

?

Any one character

This wildcard can be used to filter following files or folders:

All files (or folders) for which any one character in the file name or the folder name is variable.

To filter files:

C:\access?.doc will filter any files with the extension .doc on the C drive for which the name begins with- "access" followed by any one character such as access1.doc or access5.doc. However, access12.doc or access15.doc will not be filtered because the last two characters in the name are variable. To filter access12 or access15, you must specify access?? in the subclient filters.

To filter folders:

Class?report will filter any folder for which the character in the place of ? is variable. For example: Class1report and Class2report will be filtered. However, Class15report will get backed up.

[ ]

Set or range of characters.

C:\[a-m]*.doc will filter any file with .doc extension on the C drive for which the name begins with the letters "a" through "m”.

C:\[AEIOU]*.doc will filter any file name that ends with .doc and begins with the letters A, E, I, O, or U.

If you want to treat [] as literal characters and not as wildcards, you must use a special syntax. This will be useful when you want to filter a file which has [] in the file name. The special syntax allows you to define an escape character. Each character immediately following the escape character will then be treated literally and not as a wildcard.

For example: You want to filter a file with the name report[finance].doc on the C drive. In order for the square brackets to not be treated as wildcards, you must define an escape character. In the following example, the escape character is defined as the apostrophe (‘). The "e=" syntax is used to define the escape character. Since the square brackets are to be treated as literals, they both must be preceded by apostrophes. The filter entry in the subclient should look like this:

<P:e='>C:\report'[finance'].doc

Any character can be used as the escape character, as long as it is defined after the “e=” in the syntax and it precedes any character that is to be treated as a literal.

In addition, the escape character can itself be used as a literal. This can be achieved by prefixing it with another escape character. To filter a file with the name Test[Report]’2011’Financials.doc on the C drive, the following syntax should be used:

<P:e=’>C:\Test’[Report’]’’2011’’Financials.doc

[!]

The negation of a set or range of characters. You can use the wildcard in following scenario:

Filter all files in a directory except the files for which the name starts with any character from the specified set or range of characters.

C:\Windows\[!AEIOU]*.doc will filter all .doc files in the C:\Windows directory that start with a letter other than A, E, I, O, or U.

*

Any number of characters. This wildcard is used in the following scenarios:

• Filter all files of a specific extension

• Filter all files under a specific directory

• Filter all files of a specific extension where the file name starts with a specific pattern.

• *.doc filters all files with the extension .doc, for example "status.doc" and "mission.doc," on all partitions on the client computer.

  /Test/*.doc filters all .doc files only in the /Test directory.

• a*.so filters all files with the extension .so, for example "alsvc.so" and "advdcc.so" on the client computer which have the name beginning with "a".

• /Finance/Test/* filters all the files and directories in the "Test" directory under the "Finance" directory on the / partition. Any sub-directories under the Test directory are not get backed up.

?

Any one character.

• This wildcard can be used in the following scenario:

• All files (or directories) for which any one character in the file name or the directory name is variable.

• /access? filters any directory or file on the machine for which the name begins with- "access" followed by any one character such as "access1" or "access5". However, "access12" or "access15" are not backed up because the last two characters in the name are variable.

• /Class/report? filters any directory or file under the /Class directory where the character in place of the question mark (?) is variable. For example: "/Class/report1" and "/Class/report2" are backed up. However, "/Class/report15" is not backed up.

[]

Set or range of characters.

• /[a-m]*.doc filters any file with .doc extension on the / partition for which the name begins with the letters "a" through "m”.

• /[AEIOU]*.doc filters any file name that ends with .doc and begins with the letters A, E, I, O, or U.

• /Finance/report[1-47-9] filters files report1, report2, report4, report7, report8, report9 under the Finance directory.

• /Department-[A-CS] filters files Department-A, Department-B, Department-C, and Department-S.

[!]

The negation of a set or range of characters. You can use the wildcard in the following scenario: filter all files in a directory except the files for which the name starts with any character from the specified set or range of characters.

/root/[!AEIOU]*.doc filters all .doc files in the /root directory that start with a letter other than A, E, I, O, or U.

**

Matches any directory level.

• /**/move.cpp filters the file named move.cpp located at any directory level. For example: /root/newapp/move.cpp/opt/kde3/src/move.cpp.

• /etc/** filters all directories, sub-directories, and files under the /etc directory.

***

Matches any directory level, including the parent directory

• /etc/*** filters all directories, sub-directories, and files under the /etc directory, and the /etc directory itself.

• To filter all directories, sub-directories, and files under the /etc directory, specifying /etc/*** instead of /etc/** improves performance because /etc/*** filters the /etc directory itself. This is especially useful if you have a large subset of the file system under the /etc directory.

*

Any number of any characters. For example:

*.doc - any file name with the extension ".doc" (e.g., status.doc, mission.doc)

a*.dll - any file name that begins with "a" and has the extension .dll (e.g., alsvc.dll, advdcc.dll)

?

Any one character. For example:

access? - any file name that begins with- "access" followed by any one character (e.g., access1, access5).

[ ]

Any range of characters. For example:

[ei]nsure.doc - any file name that ends with "nsure.doc" and begins either "e" or "i". (e.g., ensure.doc, insure.doc)

[a-m].doc - any file name that ends with ".doc" and begins with the letters "a" through "m" inclusive.

[! ]

The negation of a range of characters. For example:

d[!ei]nsure.doc - any file name that ends with "nsure.doc", but does not begin with "e" or "i". (e.g., unsure.doc)