NAME

ffox - The LCFG component to managed Firefox locked preferences

DESCRIPTION

Firefox can set and disable changing configuration options in the GUI. There is a function lockPref() defined in the prefcalls.js file which this component uses.

Locked preferences do not tattoo into the user's prefs.js file.

A file is maintained to include a call to lockPref() for each set resource. A comment is left in the file as a marker for each unset resource.

The Stop method deletes any generated files.

COMPONENT RESOURCES

config_dirs

This is a list of configuration directories for the firefox preferences. These can be exact directory paths or globs, which helps when the path has a version string embedded which changes with each update to the firefox software. For example /usr/lib/firefox-* /usr/lib64/firefox-* on Linux or /Applications/Firefox.app/Contents/MacOS on MacOS X.

lock_prefs

A list of arbitrary Firefox preferences to lock. It is preferable to use one of the provided resources for locking a preference. This list should only be used where there is not a suitable resource available, or where you have to avoid schema validation on an existing resource.

Convention suggests to name your tags after the preference being set, but replacing all periods and hyphens with underscores.

Any preferences locked by this method take precedence over the same preference set by its own resource.

There is no default list.

pref_tag

The preference to lock for the named tag. The schema only allows alphanumerics, periods and underscores.

value_tag

The value to set for the named tag. There is no schema validation for this resource.

FIREFOX PREFERENCE RESOURCES

The following resources are simply renamed Firefox preferences, with periods and hyphens replaces with underscores and prefixed with lock_. The schema constrains them to valid forms, but you should check the Firefox documentation for their effects.

lock_accessibility_browsewithcaret

Lock the accessibility.browsewithcaret preference.

Can be true, false or unset (default).

lock_accessibility_typeaheadfind

Lock the accessibility.typeaheadfind preference.

Can be true, false or unset (default).

lock_app_update_autoUpdateEnabled

Lock the app.update.autoUpdateEnabled preference.

Can be true, false or unset (default).

lock_app_update_enabled

Lock the app.update.enabled preference.

Can be true, false or unset (default).

lock_browser_bookmarks_file

Lock the browser.bookmarks.file preference.

Can be any valid JavaScript code. Default is unset.

lock_browser_cache_disk_cache_ssl

Lock the browser.cache.disk_cache_ssl preference.

Can be true, false or unset (default).

lock_browser_cache_disk_capacity

Lock the browser.cache.disk.capacity preference.

Can be any natural number. Default is unset.

lock_browser_enable_automatic_image_resizing

Lock the browser.enable_automatic_image_resizing preference.

Can be true, false or unset (default).

lock_browser_shell_checkDefaultBrowser

Lock the browser.shell.checkDefaultBrowser preference.

Can be true, false or unset (default).

lock_browser_startup_homepage

Lock the browser.startup.homepage preference.

A quoted URL which is loaded when Firefox is started. The default is unset.

lock_extensions_update_autoUpdateEnabled

Lock the extensions.update.autoUpdateEnabled preference.

Can be true, false or unset (default).

lock_extensions_update_enabled

Lock the extensions.update.enabled preference.

Can be true, false or unset (default).

lock_javascript_enabled

Lock the javascript.enabled preference.

Can be true, false or unset (default).

Lock the network.cookie.cookieBehavior preference.

Unset to not lock this preference.

Possible values are one of the numbers below ...

"0" Enable all cookies
"1" Allow cookies from originating server only
"2" Disable all cookies
"3" Use P3P policy to decide

The default is left unset.

lock_network_enableIDN

Lock the network.enableIDN preference.

Can be true, false or unset (default).

lock_network_negotiate_auth_delegation_uris

Lock the network.negotiate-auth.delegation-uris preference.

The default is unset.

lock_network_negotiate_auth_trusted_uris

Lock the network.negotiate-auth.trusted-uris preference.

The default is unset.

lock_network_prefetch_next

Lock the network.prefetch-next preference.

Can be true, false or unset (default).

lock_network_proxy_autoconfig_url

Lock the network.proxy.autoconfig_url preference.

A quoted URL. Default is unset.

lock_network_proxy_ftp

Lock the network.proxy.ftp preference.

A valid DNS hostname, or unset (default).

lock_network_proxy_ftp_port

Lock the network.proxy.ftp_port preference.

A port number, or unset (default).

lock_network_proxy_gopher

Lock the network.proxy.gopher preference.

A valid DNS hostname, or unset (default).

lock_network_proxy_gopher_port

Lock the network.proxy.gopher_port preference.

A port number, or unset (default).

lock_network_proxy_http

Lock the network.proxy.http preference.

A valid DNS hostname, or unset (default).

lock_network_proxy_http_port

Lock the network.proxy.http_port preference.

A port number, or unset (default).

lock_network_proxy_no_proxies_on

Lock the network.proxy.no_proxies_on preference.

No default.

lock_network_proxy_socks

Lock the network.proxy.socks preference.

A valid DNS hostname, or unset (default).

lock_network_proxy_socks_port

Lock the network.proxy.socks_port preference.

A port number, or unset (default).

lock_network_proxy_socks_version

Lock the network.proxy.socks_version preference.

No default.

lock_network_proxy_ssl

Lock the network.proxy.ssl preference.

A valid DNS hostname, or unset (default).

lock_network_proxy_ssl_port

Lock the network.proxy.ssl_port preference.

A port number, or unset (default).

lock_network_proxy_type

Lock the network.proxy.type preference.

Unset to not lock this preference.

Possible values are one of the numbers below ...

"0" Connect Directly To The Internet
"1" Manual Proxy Configuration
"2" Automatic Proxy Configuration URL
"4" Autodetect Proxy Settings For This Network

The default is unset.

lock_security_checkloaduri

Lock the security.checkloaduri preference.

Can be true, false or unset (default).

lock_security_enable_java

Lock the security.enable_java preference.

Can be true, false or unset (default).

lock_security_enable_ssl2

Lock the security.enable_ssl2 preference.

Can be true, false or unset (default).

lock_security_enable_ssl3

Lock the security.enable_ssl3 preference.

Can be true, false or unset (default).

lock_security_enable_tls

Lock the security.enable_tls preference.

Can be true, false or unset (default).

lock_signon_rememberSignons

Lock the signon.rememberSignons preference.

Can be true, false or unset (default).

lock_xpinstall_enabled

Lock the xpinstall.enabled preference.

Can be true, false or unset (default).

PLATFORMS

Fedora13, Scientific5, MacOS X

AUTHOR

Kenneth MacDonald <K.MacDonald@ed.ac.uk>