Wildcards

You can also use wildcards to define content and filters for a subclient. The following table describes how to use wildcards while defining the subclient content/filters:

If the subclient content consists of wildcard characters and no eligible files are found for backup, then the backup operation will complete successfully even though no files were backed up.

Wildcards Description Examples
* Any number of characters.

This wildcard is used in the following scenarios:

  • Back up all files of a specific extension
  • Back up all files under a specific directory
  • Back up all files of a specific extension where the file name starts with a specific pattern.
*.doc will backup all files with the extension .doc (e.g., status.doc, mission.doc) on all partitions and paths on the client computer.

/Test/*.doc will backup all .doc files only in the /Test directory

a*.so will backup all files with the extension .so (e.g., alsvc.so, advdcc.so) on the client computer which have the name beginning with a.

/Finance/Test* will backup all the files and directories starting with Test under the /Finance directory.

? 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? will backup 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 will not backup because the last two characters in the name are variable.

/Class/report? will backup any directory or file under /Class directory for which the character in the place of ? is variable. For example: /Class/report1 and /Class/report2 will back up. However, /Class/report15 will not get backed up.

[] Set or range of characters. /[a-m]*.doc will back up any file with .doc extension on the / partition for which the name begins with the letters a through m.

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

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

/Department-[A-CS] will backup 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:

Back up 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 would  backup all .doc files in the /root directory that start with a letter other than A, E, I, O, or U.
** Any number of characters across any number of path levels. /**/move.cpp - the file named move.cpp located at any directory level. (e.g., /root/newapp/move.cpp/opt/kde3/src/move.cpp)

/etc/** - will backup all directories and files under /etc directory. All the sub-directories under these directories will also be included.

When you use wildcards to specify the subclient content, the content path appears in Italics.

If you want all the files with the file extension ".doc" to be backed up from any level, then specify the content as *.doc. If any subclient content doesn’t start with /, then /**/ will be prefixed to the content to match at any level. E.g., *.doc will be /**/*.doc

If user wants to treat *, ?, [ ] as literals in the SC content and not as wildcards, then the user can escape the wildcard by adding ‘\’ before the wildcard. E.g., /Report\[2011-2012\]/*.doc backups all the .doc files under /Report[2011-2012]

More than one type of wildcard can be used when specifying subclient content (e.g., /Dcvol?/oracle[1-47]/**/*.log).