WWW Shield puts all its files into a directory .wwwshield in your home directory. This directory contains the following files:
| pages | This is a softlink to the system's server configuration page directory, usually /usr/local/lib/wwwshield.dir. The -p option of wwwshield overrides the path. |
| rules | All the predefined configuration variable assignments and macros. This file is read at startup time. |
| config | Macro enable/disable statements and global variable assignments. This file is read at startup time after rules, and may override settings in rules. WWW Shield uses this file to store user settings set with the configuration pages. |
| history | A list of recent page accesses, including access statistics. It is read at startup time if it exists, and it is appended to whenever an external page or image is accessed. |
| history.old | When the history file becomes too long, it is renamed history.old and a new history file is started. If this file exists at startup, it is also read. |
This directory is created automatically when wwwshield is first started by a user, assuming that WWW Shield was installed correctly. The -c option of wwwshield overrides the directory path.
Iff you don't want to use the WWW Shield configuration page, you can preset the configuration by editing the ~/.wwwshield/rules file, setting the following variables:
| config.port | This is the port that WWW Shield will listen on. The browser must be configured to use this HTTP proxy port. The default is 1188. |
| config.proxymode | This variable must have set either to "direct" or "proxy". In the first case WWW Shield talks directly to the Internet and the following two variables are ignored. Otherwise, WWW Shield talks to a second-level proxy. The default is "direct". |
| config.proxyhost | The host that runs the second-level proxy that WWW Shield will be talking to. This is probably a firewall or a squid host. If the host is in a different domain, the full name must be given, as in host.domain.com. |
| config.proxyport | The port on the same host that the second-level proxy runs on. Both proxyhost and proxyport were probably configured as your browser proxy before WWW Shield was installed. |
If you made changes, delete the file ~/.wwwshield/config. When the above steps are finished, run wwwshield at a shell prompt, without optiions. You can give the -v mask option to increase the verbosity level. Six bits are defined, so 63 sets the maximum verbosity level.
|
| Browser installation help |
|
| Go to WWW Shield's main menu |
|
| Back to my home page |
|
| Tell me if you found this information interesting or useful, or if you have comments. |