From 76eba917f9b3dc48faebc4153d1f350dfd1c1eaf Mon Sep 17 00:00:00 2001
From: SignpostMarv
Date: Thu, 23 Aug 2012 13:59:06 +0100
Subject: copying documentation from http://opensimulator.org/wiki/Threat_level
---
.../ScriptEngine/Shared/Api/Interface/IOSSL_Api.cs | 59 ++++++++++++++++++++++
1 file changed, 59 insertions(+)
(limited to 'OpenSim/Region/ScriptEngine/Shared/Api')
diff --git a/OpenSim/Region/ScriptEngine/Shared/Api/Interface/IOSSL_Api.cs b/OpenSim/Region/ScriptEngine/Shared/Api/Interface/IOSSL_Api.cs
index 1f000a3..380f54d 100644
--- a/OpenSim/Region/ScriptEngine/Shared/Api/Interface/IOSSL_Api.cs
+++ b/OpenSim/Region/ScriptEngine/Shared/Api/Interface/IOSSL_Api.cs
@@ -40,16 +40,75 @@ using LSL_Key = OpenSim.Region.ScriptEngine.Shared.LSL_Types.LSLString;
namespace OpenSim.Region.ScriptEngine.Shared.Api.Interfaces
{
+ ///
+ /// To permit region owners to enable the extended scripting functionality
+ /// of OSSL, without allowing malicious scripts to access potentially
+ /// troublesome functions, each OSSL function is assigned a threat level,
+ /// and access to the functions is granted or denied based on a default
+ /// threshold set in OpenSim.ini (which can be overridden for individual
+ /// functions on a case-by-case basis)
+ ///
public enum ThreatLevel
{
+ // Not documented, presumably means permanently disabled ?
NoAccess = -1,
+
+ ///
+ /// Function is no threat at all. It doesn't constitute a threat to
+ /// either users or the system and has no known side effects.
+ ///
None = 0,
+
+ ///
+ /// Abuse of this command can cause a nuisance to the region operator,
+ /// such as log message spew.
+ ///
Nuisance = 1,
+
+ ///
+ /// Extreme levels of abuse of this function can cause impaired
+ /// functioning of the region, or very gullible users can be tricked
+ /// into experiencing harmless effects.
+ ///
VeryLow = 2,
+
+ ///
+ /// Intentional abuse can cause crashes or malfunction under certain
+ /// circumstances, which can be easily rectified; or certain users can
+ /// be tricked into certain situations in an avoidable manner.
+ ///
Low = 3,
+
+ ///
+ /// Intentional abuse can cause denial of service and crashes with
+ /// potential of data or state loss; or trusting users can be tricked
+ /// into embarrassing or uncomfortable situations.
+ ///
Moderate = 4,
+
+ ///
+ /// Casual abuse can cause impaired functionality or temporary denial
+ /// of service conditions. Intentional abuse can easily cause crashes
+ /// with potential data loss, or can be used to trick experienced and
+ /// cautious users into unwanted situations, or changes global data
+ /// permanently and without undo ability.
+ ///
High = 5,
+
+ ///
+ /// Even normal use may, depending on the number of instances, or
+ /// frequency of use, result in severe service impairment or crash
+ /// with loss of data, or can be used to cause unwanted or harmful
+ /// effects on users without giving the user a means to avoid it.
+ ///
VeryHigh = 6,
+
+ ///
+ /// Even casual use is a danger to region stability, or function allows
+ /// console or OS command execution, or function allows taking money
+ /// without consent, or allows deletion or modification of user data,
+ /// or allows the compromise of sensitive data by design.
+ ///
Severe = 7
};
--
cgit v1.1