Sun Java System Web Server 7.0 Update 4 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`.