Sun Java System Web Server 7.0 Update 3 Administrator's Configuration File Reference

Appendix B Using Wildcard Patterns

This appendix describes the wildcard patterns used by the Sun Java System Web Server. Wildcards use special characters and are applicable in the obj.conf file, built-in SAFs, and NSAPI functions. To use a wildcard character without any special meaning, precede it with a backslash (\) character.

This appendix has the following sections

Wildcard Patterns

The following table describes wildcard patterns, listing the patterns and their uses.

Table B–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. 

Wildcard Examples

The following table provides wildcard examples, listing the pattern and the result.

Table B–2 Wildcard Examples

Pattern 

Result 

*.sun.com

Matches any string ending with the characters .sun.com.

(quark|energy).sun.com

Matches either quark.sun.com or energy.sun.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. 

*~sun-*

Matches any string except those starting with sun-.

*.sun.com~quark.sun.com

Matches any host from domain sun.com except for a single host quark.sun.com.

*.sun.com~(quark|energy|neutrino).sun.com

Matches any host from domain .sun.com except for hosts quark.sun.com, energy.sun.com, and neutrino.sun.com.

*.com~*.sun.com

Matches any host from domain .com except for hosts from sub-domain sun.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.

*~*.gif*

Matches any string except those including gif.