Difference between revisions of "LlSetMemoryLimit"

From Second Life Wiki
Jump to navigation Jump to search
m (Replaced old <LSL> block with <source lang="lsl2">)
 
(22 intermediate revisions by 10 users not shown)
Line 1: Line 1:
<!-- {{LSL Generic/RC|[[Beta/Magnum|RC Magnum]]}} -->
{{LSL_Function
{{LSL_Function
|mode=pre-release
|func_id=???|func_sleep=0.0|func_energy=???
|func_id=???|func_sleep=0.0|func_energy=???
|func=llSetMemoryLimit
|func=llSetMemoryLimit
|p1_type=integer|p1_name=limit
|p1_type=integer|p1_name=limit
|return_type=integer
|return_type=integer|return_subtype=boolean
|func_desc=
|func_desc=Request {{LSLP|limit}} bytes to be reserved for this script.
|Return_text=of the new maximum bytes the script can use. {{Hilite|''That's a guess, verify this!''}}
|Return_text=[[TRUE]] if the memory limit was successfully set (or [[FALSE]] if not).
|func_footer
|func_footer
|spec=
|spec=
This function's behavior is dependent upon the VM the script is using. [[#Mono|Mono]] is the new VM, [[#LSO|LSO]] is the old VM.
This function's behavior is dependent upon the VM the script is using. [[#Mono|Mono]] is the new VM, [[#LSO|LSO]] is the old VM.


;Mono:At present, a maximum of 65536 bytes can be reserved. 65536 is also the default.  
;Mono:Sets the memory limit for the script.
* The memory limit can be set up to 64k.
* The memory limit can not be set lower than the memory currently in use by the script.
* All new scripts start with a limit of 64k
* Mono scripts compiled before this function was introduced continue to use the 64k limit.
* A lower limit will effect the amount of memory reported in the viewer UI and by [[llGetObjectDetails]].
* The memory limit is not the amount of real memory actually used by the script, just the upper limit on it.


;LSO:Always returns 16384, the fixed LSO memory size.
;LSO:Has no effect on LSO scripts which will always use exactly 16k
|caveats
|caveats=
|constants
;Mono:When '''''n''''' is too small, llSetMemoryLimit('''''n''''') is ignored and the memory limit is not changed
|examples
|examples=
<source lang="lsl2">
// Memory-walkthrough by Daemonika Nightfire (daemonika.nightfire)
 
integer limit = 20000; // <- bytes
 
Test()
{
    llSetText("Limited Memory " + (string)llGetMemoryLimit() +
              "\nUsed Memory " + (string)llGetUsedMemory() +
              "\nFree Memory " + (string)llGetFreeMemory(),<1,1,1>,1);
}
 
default
{
    state_entry()
    {
        llSetMemoryLimit(limit);
       
        llScriptProfiler(PROFILE_SCRIPT_MEMORY);
        Test();
        llScriptProfiler(PROFILE_NONE);
       
        llSay(0,"This script used at most " + (string)llGetSPMaxMemory() + " bytes of memory during Test.");
    }
}
 
// Result:
       
// Floating Text:
// Limited Memory 20000
// Used Memory 4972
// Free Memory 15100
       
// Chat:
// [05:11] Object: This script used at most 4972 bytes of memory during Test.
</source>
|helpers
|helpers
|also_functions=
|also_functions=
{{LSL DefineRow||[[llScriptProfiler]]|}}
{{LSL DefineRow||[[llGetSPMaxMemory]]|}}
{{LSL DefineRow||[[llGetMemoryLimit]]|}}
{{LSL DefineRow||[[llGetFreeMemory]]|}}
{{LSL DefineRow||[[llGetFreeMemory]]|}}
{{LSL DefineRow||[[llGetUsedMemory]]|}}
{{LSL DefineRow||[[llGetUsedMemory]]|}}
Line 33: Line 76:
|cat3=Script Profiler
|cat3=Script Profiler
|cat4
|cat4
|history = Date of Release  [[ Release_Notes/Second_Life_Server/11#11.08.10.238207 | 10/08/2011 ]]
}}
}}

Latest revision as of 14:24, 22 January 2015

Summary

Function: integer llSetMemoryLimit( integer limit );

Request limit bytes to be reserved for this script.
Returns the boolean (an integer) TRUE if the memory limit was successfully set (or FALSE if not).

• integer limit

Specification

This function's behavior is dependent upon the VM the script is using. Mono is the new VM, LSO is the old VM.

Mono
Sets the memory limit for the script.
  • The memory limit can be set up to 64k.
  • The memory limit can not be set lower than the memory currently in use by the script.
  • All new scripts start with a limit of 64k
  • Mono scripts compiled before this function was introduced continue to use the 64k limit.
  • A lower limit will effect the amount of memory reported in the viewer UI and by llGetObjectDetails.
  • The memory limit is not the amount of real memory actually used by the script, just the upper limit on it.
LSO
Has no effect on LSO scripts which will always use exactly 16k

Caveats

Mono
When n is too small, llSetMemoryLimit(n) is ignored and the memory limit is not changed
All Issues ~ Search JIRA for related Bugs

Examples

// Memory-walkthrough by Daemonika Nightfire (daemonika.nightfire)

integer limit = 20000; // <- bytes

Test()
{
    llSetText("Limited Memory " + (string)llGetMemoryLimit() +
              "\nUsed Memory " + (string)llGetUsedMemory() +
              "\nFree Memory " + (string)llGetFreeMemory(),<1,1,1>,1);
}

default
{
    state_entry()
    {
        llSetMemoryLimit(limit);
        
        llScriptProfiler(PROFILE_SCRIPT_MEMORY);
        Test();
        llScriptProfiler(PROFILE_NONE);
        
        llSay(0,"This script used at most " + (string)llGetSPMaxMemory() + " bytes of memory during Test.");
    }
}

// Result:
        
// Floating Text:
// Limited Memory 20000
// Used Memory 4972
// Free Memory 15100
        
// Chat:
// [05:11] Object: This script used at most 4972 bytes of memory during Test.

Deep Notes

History

Date of Release 10/08/2011

Search JIRA for related Issues

Signature

function integer llSetMemoryLimit( integer limit );
Retrieved from "https://wiki.secondlife.com/w/index.php?title=LlSetMemoryLimit&oldid=1194459"