Chapter 9
Using Wildcard Patterns
This chapter describes the format of wildcard patterns used by the Sun ONE Web Server. These wildcards are used in:
- Directives in the configuration file obj.conf (see the Sun ONE Web Server 6.1 Administrator’s Configuration File Reference for detailed information about obj.conf).
- Various built-in SAFs (see the Sun ONE Web Server 6.1 Administrator’s Configuration File Reference for more information about these predefined SAFs).
Wildcard patterns use special characters. If you want to use one of these characters without the special meaning, precede it with a backslash (\) character.
This chapter has the following sections:
Wildcard Patterns
The following table describes wildcard patterns, listing the pattern and its use.
Table 9-1 Wildcard Patterns
|
Pattern
|
Use
|
|
*
|
Match zero or more characters.
|
|
?
|
Match exactly one occurrence of any character.
|
|
|
|
An or expression. The substrings used with this operator can contain other special characters such as * or $. The substrings must be enclosed in parentheses, for example, (a|b|c), but the parentheses cannot be nested.
|
|
$
|
Match the end of the string. This is useful in or expressions.
|
|
[abc]
|
Match one occurrence of the characters a, b, or c. Within these expressions, the only character that needs to be treated as a special character is ]; all others are not special.
|
|
[a-z]
|
Match one occurrence of a character between a and z.
|
|
[^az]
|
Match any character except a or z.
|
|
*~
|
This expression, followed by another expression, removes any pattern matching the second expression.
|
|
*
|
Match zero or more characters.
|
Wildcard Examples
The following table provides wildcard examples, listing the pattern and the result.
Table 9-2 Wildcard Examples
|
Pattern
|
Result
|
|
*.netscape.com
|
Matches any string ending with the characters .netscape.com.
|
|
(quark|energy).netscape.com
|
Matches either quark.netscape.com or energy.netscape.com.
|
|
198.93.9[23].???
|
Matches a numeric string starting with either 198.93.92 or 198.93.93 and ending with any 3 characters.
|
|
*.*
|
Matches any string with a period in it.
|
|
*~netscape-*
|
Matches any string except those starting with netscape-.
|
|
*.netscape.com~quark.netscape.com
|
Matches any host from domain netscape.com except for a single host quark.netscape.com.
|
|
*.netscape.com~(quark|energy
|neutrino).netscape.com
|
Matches any host from domain .netscape.com except for hosts quark.netscape.com, energy.netscape.com, and neutrino.netscape.com.
|
|
*.com~*.netscape.com
|
Matches any host from domain .com except for hosts from subdomain netscape.com.
|
|
type=*~magnus-internal/*
|
Matches any type that does not start with magnus-internal/.
This wildcard pattern is used in the file obj.conf in the catch-all Service directive.
|
