change coments on osslEnable.ini and remove list of functions always suported;

1 files changed, 18 insertions, 88 deletions

diff --git a/bin/config-include/osslEnable.ini b/bin/config-include/osslEnable.ini
index 84943e7..759647d 100644
--- a/bin/config-include/osslEnable.ini
+++ b/bin/config-include/osslEnable.ini
@@ -1,16 +1,10 @@
 ; Enable OSSL functions.
 ; Including this file in a region's set of INI files, causes the OpenSimulator
 ;   specific functions to be enabled.
-; See http://opensimulator.org/wiki/OSSL for a description of OSSL functions and
-;   refer to http://opensimulator.org/wiki/OSSL_Implemented for a list of functions.
-
-; The below file lists all the functions and specifies who has permission to
-;   execute the function. Some of the functions are for maintainance or can be
-;   mis-used so the permission to execute a function can be limited. Ability to
-;   execute a function is based on the owner of the prim holding the script.
+; See http://opensimulator.org/wiki/Category:OSSL_Functions for a description of OSSL functions
 
 [OSSL]
-  ; Allow the use of os* functions (some are dangerous)
+  ; Allow the use of os* functions (some are always avaiable)
   AllowOSFunctions = true
 
   ; Allow the user of mod* functions.  This allows a script to pass messages
@@ -22,19 +16,23 @@
   ; The setting enable_windlight = true must also be enabled in the [LightShare] section.
   AllowLightShareFunctions = true
 
-  ; Threat level to allow. One of None, VeryLow, Low, Moderate, High, VeryHigh, Severe.
+  ; Function Threat level
+  ; Several functions have a predefined threat level, one of:  None, VeryLow, Low, Moderate, High, VeryHigh, Severe.
   ; See http://opensimulator.org/wiki/Threat_level for more information on these levels.
-  ; This is the default level and can be overridden with the Allow_ specifications.
   ; Blanket enabling the ossl functions is dangerous and we do not recommend setting higher
   ;   than 'Low' unless you have a high level of trust in all the users that can run scripts
   ;   in your simulator.  It is safer to explicitly allow certain types of user to run
   ;   higher threat level OSSL functions, as detailed later on.
+  ; This setting defines the highest level allowed to execute
   OSFunctionThreatLevel = VeryLow
 
-  ; Some of the OSSL functions can be enabled or disabled individually.
-  ; To disable, set the value to 'false'.
-  ; To enable for everyone, set the value to 'true'.
-  ; To enable for individuals or groups, set it to a comma separated list. This checks
+  ; The threat level can be replaced by more detailed rules by lines of the form
+  ; Allow_FunctionName = parameters
+  ; To use the default threat level coment the respective line
+  ; parameters can be:
+  ; 'false' disables the function.
+  ; 'true' enables for everyone
+  ;  or to enable for individuals or groups, set it to a comma separated list. This checks
   ;    against the owner of the object containing the script.
   ;    The comma separated entries in the list may be one of:
   ;           "GRID_GOD" -- enable for users with UserLevel >= 200
@@ -63,11 +61,11 @@
   ; NPC macros
   ; These can be mis-used so limit use to those you can trust.
   osslNPC = ${OSSL|osslParcelOG}ESTATE_MANAGER,ESTATE_OWNER
+  
+  ; The threat level also can be replaced by lines of the form
+  ; Creators__FunctionName = comma separated list of UUIDs
+  ; this will enable the function for users that are creators and owners of the prim
 
-  ; The OSSL function name is prepended with "Allow_" and it checks against
-  ;   the owners of the containing prim. There can also be entries beginning with
-  ;   'Creators_". The 'Creators_" parameters can only be a list of UUIDs and it is
-  ;   checked against the creator of the script itself.
 
 ; *************************************************
 
@@ -222,73 +220,5 @@
   Allow_osSetContentType =          false
 
 
-; available functions out of Threat level control (for reference only)
-;  Allow_osAdjustSoundVolume =       true
-;  Allow_osAngleBetween =            true
-;  Allow_osApproxEquals =            true
-;  Allow_osCheckODE =                true
-;  Allow_osClearInertia =            true
-;  Allow_osCollisionSound =          true
-;  Allow_osDrawEllipse =             true
-;  Allow_osDrawFilledEllipse =       true
-;  Allow_osDrawFilledPolygon =       true
-;  Allow_osDrawFilledRectangle =     true
-;  Allow_osDrawImage =               true
-;  Allow_osDrawLine =                true
-;  Allow_osDrawPolygon =             true
-;  Allow_osDrawRectangle =           true
-;  Allow_osDrawResetTransform =      true
-;  Allow_osDrawRotationTransform =   true
-;  Allow_osDrawScaleTransform =      true
-;  Allow_osDrawText =                true
-;  Allow_osDrawTranslationTransform = true
-;  Allow_osGetCurrentSunHour =       true
-;  Allow_osGetInertiaData =          true
-;  Allow_osGetInventoryDesc =        true
-;  Allow_osGetInventoryItemKey =     true
-;  Allow_osGetInventoryLastOwner =   true
-;  Allow_osGetInventoryName =        true 
-;  Allow_osGetLinkNumber =           true
-;  Allow_osGetMapTexture =           true
-;  Allow_osGetPhysicsEngineName =    true
-;  Allow_osGetPrimitiveParams =      true
-;  Allow_osGetRegionSize =           true
-;  Allow_osGetSunParam =             true
-;  Allow_osGetTerrainHeight =        true
-;  Allow_osGetDrawStringSize =       true
-;  Allow_osIsNpc =                   true
-;  Allow_osIsUUID =                  true
-;  Allow_osLoopSound =               true
-;  Allow_osLoopSoundMaster =         true
-;  Allow_osLoopSoundSlave =          true
-;  Allow_osMax =                     true
-;  Allow_osMin =                     true
-;  Allow_osMovePen =                 true
-;  Allow_osPlaySound =               true
-;  Allow_osPlaySoundSlave =          true
-;  Allow_osPreloadSound =            true
-;  Allow_osRound =                   true
-;  Allow_osSetFontName =             true
-;  Allow_osSetFontSize =             true
-;  Allow_osSetInertia =              true
-;  Allow_osSetInertiaAsBox =         true
-;  Allow_osSetInertiaAsSphere =      true
-;  Allow_osSetInertiaAsCylinder =    true
-;  Allow_osSetPenCap =               true
-;  Allow_osSetPenColor =             true
-;  Allow_osSetPenSize =              true
-;  Allow_osSetPrimitiveParams =      true
-;  Allow_osSetSoundRadius =          true
-;  Allow_osStopSound =               true
-;  Allow_osStringSubString =         true
-;  Allow_osStringStartsWith =        true
-;  Allow_osStringEndsWith =          true
-;  Allow_osStringIndexOf =           true
-;  Allow_osStringLastIndexOf =       true
-;  Allow_osStringRemove =            true
-;  Allow_osStringReplace =           true
-;  Allow_osTriggerSound =            true
-;  Allow_osTriggerSoundLimited =     true
-;  Allow_osVecDistSquare =           true
-;  Allow_osVecMagSquare =            true
-;  Allow_osVolumeDetect =            true
+; Always avaiable
+; see http://opensimulator.org/wiki/Category:OSSL_Functions