The following table provides brief examples of sample pin list entries and their effects on appliance caching.
| URL Mask | Pin Type | Pin Links | Pin Images | Effect on Cache |
|---|---|---|---|---|
http://www.foo.gov/documents/ |
cache |
1 |
Yes |
As a general rule, you should always include fully qualified DNS names or hostnames in the pin list. Excelerator resolves these more quickly than other masks, and you will be able to track the effects on pinning more easily. For this URL mask, Excelerator downloads, caches, and pins all objects whose URL starts with the mask. In other words, all objects below the documents directory will be downloaded, cached, and pinned. Also, all objects that are linked from one of the pinned objects will be downloaded, cached, and pinned. And finally, images that reside on other hosts will be downloaded, cached, and pinned as well. Objects will be refreshed according to the refresh settings (default or specific) as specified in the pin list entry. |
www.foo.gov/groups.html |
cache |
1 |
No |
Excelerator downloads, caches, and pins objects (including images) in the GROUPS.HTML page and in pages linked from that page. Any images referenced from other hosts, however, are not included. |
www.foo.gov/groups.html/ |
normal |
1 |
Yes |
Excelerator downloads and caches objects in the subdirectory named groups.html and in pages linked from any of those objects. The forward slash tells Excelerator that this is a directory rather than a file. Objects are cached but not pinned in cache, meaning they might be bumped by more frequently accessed objects or objects that are pinned. Images linked from other hosts are downloaded and cached. |
www.foo.* |
bypass |
n/a |
n/a |
Excelerator doesn't cache objects from any URLs whose DNS names begin with www.foo. All domain extensions (.com, .net, .org, etc.) are covered by the asterisk wildcard. Link and image pinning is not available for bypass pin types. If this entry appeared in a pin list with either of the previous two entries, it would not prevent caching of objects covered by them because it is less specific than they are. |
w*.f*.com |
bypass |
n/a |
n/a |
Excelerator doesn't cache objects for any URLs whose first domain label begins with w and second domain label begins with f, providing the domain extension is .com. This mask doesn't prevent caching of objects on other domains such as .net or .gov. |
w*.f*.* |
bypass |
n/a |
n/a |
This mask functions like the previous entry, but the domain is not limited to .com. |
*.foo.* |
cache |
n/a |
n/a |
This causes all objects on any Web server whose second domain label is foo to be pinned in cache. Link and image pinning are not available because the mask contains asterisks. This mask would not cover DNS names that don't have a domain label before foo. For example, foo.gov would not normally be covered. However, if foo.gov happened to resolve in DNS to the same IP address as www.foo.gov, Excelerator would apply the pinning rules specified for www.foo.gov to foo.gov. To understand more about IP addresses and URL masks, see Excelerator Records IP Addresses When Resolving URL Masks. |