[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 ===