[Zope-Checkins] CVS: Zope/lib/python/Controller - directives.csv:1.1.2.8 directives.gnumeric:1.1.2.4

Chris McDonough chrism@zope.com
Wed, 9 Oct 2002 01:04:39 -0400


Update of /cvs-repository/Zope/lib/python/Controller
In directory cvs.zope.org:/tmp/cvs-serv12011

Modified Files:
      Tag: chrism-install-branch
	directives.csv directives.gnumeric 
Log Message:
Change some directive names and behaviors based on input from Shane.

Add "lock_filename" directive to support zctl/zope communications.


=== Zope/lib/python/Controller/directives.csv 1.1.2.7 => 1.1.2.8 ===
--- Zope/lib/python/Controller/directives.csv:1.1.2.7	Sun Oct  6 02:05:58 2002
+++ Zope/lib/python/Controller/directives.csv	Wed Oct  9 01:04:39 2002
@@ -2,17 +2,16 @@
 general	5	instance_home	The path to the data files, local product files, import directory, and Extensions directory used by Zope.	env	path	INSTANCE_HOME	The current working directory when Zope is started.	INSTANCE_HOME	/home/chrism/projects/sessions
 general	10	software_home	The path to the majority of the Python software files used by Zope.  One software_home can support many instance_homes.	env	path	SOFTWARE_HOME	ZOPE_HOME/lib/python	SOFTWARE_HOME	/home/chrism/software/Trunk/lib/python
 general	15	client_home	The directory in which a running Zope's process identifier files are placed.	env	path	CLIENT_HOME	INSTANCE_HOME/var	CLIENT_HOME	/home/chrism/projects/sessions/var
-general	20	python_path	Set the PYTHONPATH environment variable with the value of this directive.  The PYTHONPATH represents a list of directories which are prefixed to the default list of directories searched by Python when it attempts to look up module names.  See the Python documentation for more information on PYTHONPATH.  It must be a colon-separated list of directory names.	env	string	PYTHONPATH	unset	None	/home/chrism/opt/Python-2.1.3:/usr/lib/python
-admin	25	debug_mode	If this directive is set to 'on', it causes the Zope process to not detach from the controlling terminal after it is run.  It also influences the behavior of some Zope objects at runtime (for example, when debug mode is "on", you are able to view changes made to DTMLFile and PageTemplateFile objects immediately; When it is 'off', you must restart the server to see the changes.  Additionally, event log and other log output will not be sent to the console when this directive is set to 'off'. Setting this to 'off' when Zope is in a production environment is encouraged, as it speeds execution.	env_switch	onoff	Z_DEBUG_MODE	on	1	on
-admin	30	effective_user	If you intend to run Zope as the "root" user, you must supply this directive with an effective username or userid number to which Zope will 'suid' after the server ports are bound.  This directive only works under UNIX and if Zope is started as the root user.	cmd	string		unset	None	chrism
-admin	35	inhibit_product_installation	If this  directive is set, the 'product installation' step performed by Zope at startup is prevented.  This can speed Zope startup time, but it can also cause your Control_Panel Product list to become desynchronized with the contents of your Products directories.  If the 'zeo_client_name' directive is set, and this directive is unset, this directive will be implicitly turned on.  By default, it is off.	env_switch	revonoff	FORCE_PRODUCT_LOAD	off	0	on
-admin	40	locale	Enable locale (internationalization) support by supplying a locale name to be used.  See your operating system documentation for locale information specific to your system.  If your Python module does not support the locale module, or if the requested locale is not supported by your system, an error will be raised and Zope will not start.	cmd	string		unset	None	fr_FR
-admin	45	number_of_threads	Specify the number of threads that Zope will use to service requests.  The default is 4.	cmd	int		4	None	10
-admin	50	python_check_interval	Specify an integer representing the Python interpreter "check interval"  This interval determines how often the interpreter checks for perioding things such as thread switches and signal handlers.  The Zope default is 500, but you may want to experiment with other values in order to attempt to increae performance in your particular environment.	cmd	int		500	500	1000
-admin	55	use_daemon_process	If this directive is set to 'on', Zope will be managed by a 'daemon' process which will restart the Zope process if it dies unexpectedly.	cmd	onoff		on	1	on
-admin	60	zserver_read_only_mode	If this directive is set to 'on', it will cause Zope to inhibit the creation of log files and pid files.  Access and event log files will be presented on standard output.  Setting this directive 'on' causes pcgi, fastcgi, and daemon-related directives to have no effect.	cmd	onoff		off	None	on
-admin	65	pid_filename	The path to the file in which the Zope process id(s) will be written.  This defaults to client_home/Z2.pid.	cmd	path		CLIENT_HOME/Z2.pid	pjoin(reg_get('client_home'), 'Z2.pid')	/home/chrism/projects/sessions/var/Z2.pid
-admin	66	lock_filename	The path to the file which the Zope process uses as a lock file.  This defaults to client_home/Z2.lock.	cmd	path		CLIENT_HOME/Z2.lock	pjoin(reg_get('client_home'), 'Z2.lock')	/home/chrism/projects/sessions/var/Z2.lock
+admin	20	debug_mode	If this directive is set to 'on', it causes the Zope process to not detach from the controlling terminal after it is run.  It also influences the behavior of some Zope objects at runtime (for example, when debug mode is "on", you are able to view changes made to DTMLFile and PageTemplateFile objects immediately; When it is 'off', you must restart the server to see the changes.  Additionally, event log and other log output will not be sent to the console when this directive is set to 'off'. Setting this to 'off' when Zope is in a production environment is encouraged, as it speeds execution.	env_switch	onoff	Z_DEBUG_MODE	on	1	on
+admin	25	effective_user	If you intend to run Zope as the "root" user, you must supply this directive with an effective username or userid number to which Zope will 'suid' after the server ports are bound.  This directive only works under UNIX and if Zope is started as the root user.	cmd	string		unset	None	chrism
+admin	30	enable_product_installation	If this  directive is turned on, Zope performs 'product installation' (the registration of Python modules in various Products directories) at startup.  Turning this off can speed Zope startup time, but it can also cause your Control_Panel Product list to become desynchronized with the contents of your Products directories.  If the 'zeo_client_name' directive is set, and this directive is unset, this directive will be implicitly turned off  By default, it is on.	env_switch	onoff	FORCE_PRODUCT_LOAD	on	1	off
+admin	35	locale	Enable locale (internationalization) support by supplying a locale name to be used.  See your operating system documentation for locale information specific to your system.  If your Python module does not support the locale module, or if the requested locale is not supported by your system, an error will be raised and Zope will not start.	cmd	string		unset	None	fr_FR
+admin	40	zserver_threads	Specify the number of threads that Zope's Zserver web server will use to service requests.  The default is 4.	cmd	int		4	None	10
+admin	45	python_check_interval	Specify an integer representing the Python interpreter "check interval"  This interval determines how often the interpreter checks for perioding things such as thread switches and signal handlers.  The Zope default is 500, but you may want to experiment with other values in order to attempt to increae performance in your particular environment.	cmd	int		500	500	1000
+admin	50	use_daemon_process	If this directive is set to 'on', Zope will be managed by a 'daemon' process which will restart the Zope process if it dies unexpectedly.	cmd	onoff		on	1	on
+admin	55	zserver_read_only_mode	If this directive is set to 'on', it will cause Zope to inhibit the creation of log files and pid files.  Access and event log files will be presented on standard output.  Setting this directive 'on' causes pcgi, fastcgi, and daemon-related directives to have no effect.	cmd	onoff		off	None	on
+admin	60	pid_filename	The path to the file in which the Zope process id(s) will be written.  This defaults to client_home/Z2.pid.	cmd	path		CLIENT_HOME/Z2.pid	pjoin(reg_get('client_home'), 'Z2.pid')	/home/chrism/projects/sessions/var/Z2.pid
+admin	65	lock_filename	The path to a "lock file" which will be locked by Zope while it's running.  This file is used by zctl.py to determine if Zope is currently running.  This defaults to client_home/Z2.lock.	cmd	path		CLIENT_HOME/Z2.lock	pjoin(reg_get('client_home'), 'Z2.lock')	/home/chrism/projects/sessions/var/Z2.lock
 log	70	acccess_syslog_facility	Same as 'event_syslog_facility', only for the "access" log data (z2.log data).	env	string	ZSYSLOG_ACCESS_FACILITY	unset	None	local7
 log	75	access_log_filename	The file path of the Zope 'access' log (z2.log) which is written in the combined logfile format.  The access log will be printed to standard output if the 'zserver_read_only' directive is set to 'on', regardless of this setting.	cmd	string		CLIENT_HOME/z2.log	pjoin(reg_get('client_home'), 'Z2.log')	/home/chrism/projects/sessions/z2.log
 log	80	access_syslog_path	Same as event_syslog_path, only for the "access" log data (z2.log data).	env	path	ZSYSLOG_ACCESS	unset	None	/dev/log
@@ -41,26 +40,25 @@
 security	195	automatically_quote_dtml_request_data	Set this directive to 'off' in order to disable the autoquoting of implicitly retrieved REQUEST data by DTML code which contains a '<' when used in <dtml-var> construction.  When this directive is 'on', all data implicitly retrieved from the REQUEST in DTML (as opposed to addressing REQUEST.somevarname directly) that contains a '<' will be HTML-quoted when interpolated via a <dtml-var> or &dtml- construct.   This mitigates the possibility that DTML programmers will leave their sites open to a "client-side trojan" attack.	env	onoff	ZOPE_DTML_REQUEST_AUTOQUOTE	on	1	on
 security	200	skip_authentication_checking	Set this directive to 'on' to cause Zope to allow unauthenticated access to all resources.  DANGEROUS.  Only works if security_policy_implementation is C	env_switch	onoff	ZSP_AUTHENTICATED_SKIP	off	None	on
 security	205	skip_ownership_checking	Set this directive to 'on' to cause Zope to ignore ownership checking when attempting to execute "through the web" code.  By default, this directive is on in order to prevent 'trojan horse' security problems whereby a user with less privilege can cause a user with more privilege to execute dangerous code.	env_switch	onoff	ZSP_OWNEROUS_SKIP	off	None	on
-security	210	security_policy_implementation	Set this directive to 'PYTHON' to use a pure-Python implementation of Zope's default security policy.  The default value for this directive is 'C".  Setting it to PYTHON causes Zope to run more slowly, but it can be helpful when attempting to debug security-related application failures.	env	string	ZOPE_SECURITY_POLICY	C	'C'	PYTHON
-sessions	215	maximum_number_of_session_objects	An integer value representing the number of items to use as a "maximum number of subobjects" value of the '/temp_folder/session_data' transient object container.	env	int	ZSESSION_OBJECT_LIMIT	1000	1000	10000
-sessions	220	session_add_notify_script_path	An optional fill Zope path name of a callable object to be set as the "script to call on object addition" of the sessioN_data transient object container created in the /temp_folder folder at startup.	env	path	ZSESSION_ADD_NOTIFY	unset	None	/scripts/add_notifier
-sessions	225	session_delete_notify_script_path	An optional fill Zope path name of a callable object to be set as the "script to call on object deletion" of the sessioN_data transient object container created in the /temp_folder folder at startup.	env	path	ZSESSION_DEL_NOTIFY	unset	None	/scripts/del_notifier
-sessions	230	session_timeout_minutes	An integer value representing the number of minutes to be used as the "data object timeout" of the '/temp_folder/session_data' transient object container.	env	int	ZSESSION_TIMEOUT_MINS	20	20	30
-url	235	suppress_all_access_rules 	If this directive is set to on, no access rules in your Zope site will be executed.  This is useful if you "lock yourself out" of a particular part of your site by setting an improper access rule.	env_switch	onoff	SUPPRESS_ACCESRULE	off	None	on
-url	240	suppress_all_site_roots	If this directive is set to on, no site roots in your Zope site will be effective.  This is useful if you "lock yourself out" of a particular part of your site by setting an improper site root.	env_switch	onoff	SUPPRESS_SITEROOT	off	None	on
-zodb	245	zodb_filestorage_filepath	Provide an absolute file path to the file which should be used as the default ZODB FileStorage.  If you leave this unset, it will default to INSTANCE_HOME/var/Data.fs.	cmd	path		CLIENT_HOME/Data.fs	pjoin(reg_get('client_home'), 'Data.fs')	/home/chrism/somedirectory/Data.fs
-zodb	250	zodb_db_cache_size	The target number of objects that will be stored in the local ZODB "pickle cache" (as per the Control_Panel -> Database tab).  The default is 5000.	cmd	int		5000	5000	
-zodb	255	zodb_db_pool_size	The number of ZODB database connections used by a ZODB.DB instance.  The default is 7.	cmd	int		7	7	
-zodb	260	database_quota_size	Set this directive to an integer in bytes in order to place a hard limit on the size which the default FileStorage-backed Zope database can grow.  Additions to the database will not be permitted once this filesize is exceeded.	env	int	ZOPE_DATABASE_QUOTA	unset	None	1000000
-zodb	265	read_only_database	This causes the main Zope FileStorage-backed ZODB to be opened in read-only mode.	env_switch	onoff	ZOPE_READ_ONLY	off	0	on
-zodb	270	use_zeo_server	Specifying this option will cause Zope to use a ZEO server to obtain ZODB data instead of the 'default' FileStorage specified via 'zodb_filestorage_filepath'.   You must install the ZEO software before using this directive successfully.	cmd	onoff		off	0	on
-zodb	275	zeo_client_name	Provide a string value to uniquely identify the local cache files created if this Zope is a ZEO client.  Setting this directive implies setting 'inhibit_product_installation' to 'on' if 'inhibit_product_installation' is left unset.	env	string	ZEO_CLIENT	unset	None	zeo1
-zodb	280	zeo_storage_server_hostname	Provide a an IP address or hostname to specify a ZEO server which serves the "main" ZODB database for this Zope instance.  This directive will be ignored if you use a filepath for 'zeo_storage_server_path_or_port' (localhost is assumed in this case).	cmd	string		unset	None	storage.zope.com
-zodb	285	zeo_storage_server_path_or_port	Specify either a TCP port number (e.g. 2199) or a UNIX domain socket filename (e.g. /home/chrism/zeo.soc) to use as an argument to the ZEO ClientStorage constructor.  If you specify a TCP port number, you must have also specified a storage server name via 'zeo_storage_server_name'.  	cmd	string		unset	None	/home/chrism/zope/var/zeo.soc or 2199
-zodb	290	zeo_storage_server_storagename	Specifies a "storage name" to use under a ZEO-backed configuration.  The "typical" storage name is "1" (this is what ZEO defaults to when it serves only one storage).	cmd	string		unset	'1'	1 or Main
-zodb	295	zeo_client_cache_size	Specifies the size in bytes allocated to the ZEO client disk cache.  The default is 200,000,000 (200MB) bytes if this is left unset.	cmd	int		unset	200000000	20000000
-zodb	300	zeo_client_debug	If this is set to "on", the ZEO ClientStorage will output debugging information to the event log.	cmd	onoff		off	0	on
-zodb	305	zeo_client_cache_directory	Specify a directory in which the ZEO client cache files should be stored.  Defaults to INSTANCE_HOME/var.	cmd	onoff		INSTANCE_HOME/var/	reg_get('client_home')	/home/chrism/projects/sessions/var
-zodb	310	zeo_client_min_disconnect_poll	The minimum number of seconds that a ClientStorage will wait before retrying a connection after a failure.  The default is 5 if this is left unset.	cmd	int		5	5	10
-zodb	315	zeo_client_max_disconnect_poll	The maximum number of seconds that a ClientStorage will wait before retrying a connection after a failure.  The default is 300 if this is left unset.	cmd	int		300	300	300
-zodb	320	zeo_client_wait_for_server_on_startup	If this is set to "on", the ZEO ClientStorage will wait for a connection to its storage before serving data.  If this is set to "off", the ZEO ClientStorage will attempt to serve data out of its cache file at startup even if it cannot make a connection to a storage server.	cmd	onoff		off	0	on
+sessions	210	maximum_number_of_session_objects	An integer value representing the number of items to use as a "maximum number of subobjects" value of the '/temp_folder/session_data' transient object container.	env	int	ZSESSION_OBJECT_LIMIT	1000	1000	10000
+sessions	215	session_add_notify_script_path	An optional fill Zope path name of a callable object to be set as the "script to call on object addition" of the sessioN_data transient object container created in the /temp_folder folder at startup.	env	path	ZSESSION_ADD_NOTIFY	unset	None	/scripts/add_notifier
+sessions	220	session_delete_notify_script_path	An optional fill Zope path name of a callable object to be set as the "script to call on object deletion" of the sessioN_data transient object container created in the /temp_folder folder at startup.	env	path	ZSESSION_DEL_NOTIFY	unset	None	/scripts/del_notifier
+sessions	225	session_timeout_minutes	An integer value representing the number of minutes to be used as the "data object timeout" of the '/temp_folder/session_data' transient object container.	env	int	ZSESSION_TIMEOUT_MINS	20	20	30
+url	230	suppress_all_access_rules 	If this directive is set to on, no access rules in your Zope site will be executed.  This is useful if you "lock yourself out" of a particular part of your site by setting an improper access rule.	env_switch	onoff	SUPPRESS_ACCESRULE	off	None	on
+url	235	suppress_all_site_roots	If this directive is set to on, no site roots in your Zope site will be effective.  This is useful if you "lock yourself out" of a particular part of your site by setting an improper site root.	env_switch	onoff	SUPPRESS_SITEROOT	off	None	on
+zodb	240	zodb_filestorage_filepath	Provide an absolute file path to the file which should be used as the default ZODB FileStorage.  If you leave this unset, it will default to INSTANCE_HOME/var/Data.fs.	cmd	path		CLIENT_HOME/Data.fs	pjoin(reg_get('client_home'), 'Data.fs')	/home/chrism/somedirectory/Data.fs
+zodb	245	zodb_db_cache_size	The target number of objects that will be stored in the local ZODB "pickle cache" (as per the Control_Panel -> Database tab).  The default is 5000.	cmd	int		5000	5000	
+zodb	250	zodb_db_pool_size	The number of ZODB database connections used by a ZODB.DB instance.  The default is 7.	cmd	int		7	7	
+zodb	255	database_quota_size	Set this directive to an integer in bytes in order to place a hard limit on the size which the default FileStorage-backed Zope database can grow.  Additions to the database will not be permitted once this filesize is exceeded.	env	int	ZOPE_DATABASE_QUOTA	unset	None	1000000
+zodb	260	read_only_database	This causes the main Zope FileStorage-backed ZODB to be opened in read-only mode.	env_switch	onoff	ZOPE_READ_ONLY	off	0	on
+zodb	265	use_zeo_server	Specifying this option will cause Zope to use a ZEO server to obtain ZODB data instead of the 'default' FileStorage specified via 'zodb_filestorage_filepath'.   You must install the ZEO software before using this directive successfully.	cmd	onoff		off	0	on
+zodb	270	zeo_client_name	Provide a string value to uniquely identify the local cache files created if this Zope is a ZEO client.  Setting this directive implies setting 'inhibit_product_installation' to 'on' if 'inhibit_product_installation' is left unset.	env	string	ZEO_CLIENT	unset	None	zeo1
+zodb	275	zeo_storage_server_hostname	Provide a an IP address or hostname to specify a ZEO server which serves the "main" ZODB database for this Zope instance.  This directive will be ignored if you use a filepath for 'zeo_storage_server_path_or_port' (localhost is assumed in this case).	cmd	string		unset	None	storage.zope.com
+zodb	280	zeo_storage_server_path_or_port	Specify either a TCP port number (e.g. 2199) or a UNIX domain socket filename (e.g. /home/chrism/zeo.soc) to use as an argument to the ZEO ClientStorage constructor.  If you specify a TCP port number, you must have also specified a storage server name via 'zeo_storage_server_name'.  	cmd	string		unset	None	/home/chrism/zope/var/zeo.soc or 2199
+zodb	285	zeo_storage_server_storagename	Specifies a "storage name" to use under a ZEO-backed configuration.  The "typical" storage name is "1" (this is what ZEO defaults to when it serves only one storage).	cmd	string		unset	'1'	1 or Main
+zodb	290	zeo_client_cache_size	Specifies the size in bytes allocated to the ZEO client disk cache.  The default is 200,000,000 (200MB) bytes if this is left unset.	cmd	int		unset	200000000	20000000
+zodb	295	zeo_client_debug	If this is set to "on", the ZEO ClientStorage will output debugging information to the event log.	cmd	onoff		off	0	on
+zodb	300	zeo_client_cache_directory	Specify a directory in which the ZEO client cache files should be stored.  Defaults to INSTANCE_HOME/var.	cmd	onoff		INSTANCE_HOME/var/	reg_get('client_home')	/home/chrism/projects/sessions/var
+zodb	305	zeo_client_min_disconnect_poll	The minimum number of seconds that a ClientStorage will wait before retrying a connection after a failure.  The default is 5 if this is left unset.	cmd	int		5	5	10
+zodb	310	zeo_client_max_disconnect_poll	The maximum number of seconds that a ClientStorage will wait before retrying a connection after a failure.  The default is 300 if this is left unset.	cmd	int		300	300	300
+zodb	315	zeo_client_wait_for_server_on_startup	If this is set to "on", the ZEO ClientStorage will wait for a connection to its storage before serving data.  If this is set to "off", the ZEO ClientStorage will attempt to serve data out of its cache file at startup even if it cannot make a connection to a storage server.	cmd	onoff		off	0	on


=== Zope/lib/python/Controller/directives.gnumeric 1.1.2.3 => 1.1.2.4 ===