Sun Java System Web Proxy Server 4.0.3 2006Q2 NSAPI Developer's Guide

Chapter 6 Using Wildcard Patterns

This chapter describes the format of wildcard patterns used by the Sun Java System Web Proxy Server. These wildcards are used in:

Directives in the configuration file obj.conf (see the Sun Java System Web Proxy Server Configuration File Reference for detailed information about obj.conf).
Various built-in SAFs (see the Sun Java System Web Proxy Server 4.0.2 Configuration File Reference for more information about these predefined SAFs).
Some NSAPI functions .

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 6–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 6–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.