Skip to content
lsl.devlsl.devLSL Dev

llGetUsedMemory

View as MarkdownThis page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page
function
Function syntax
integer llGetUsedMemory();
Returns
integer
Energy
10

Returns an integer representing the total number of bytes of memory currently used by the script (non-Mono scripts always return 16,384 bytes).

How to use
integer result = llGetUsedMemory();

Specification

Section titled “Specification”

This function’s behavior is dependent upon the VM the script is using. Mono is the new VM, LSO is the old VM. The big difference between Mono and LSO is that Mono scripts run faster and can utilize four times more memory.

Mono

Section titled “Mono”

In Mono the value returned is the amount of memory currently in use by the script. This is achieved by searching the script’s stack and counting all reachable resources. In terms of garbage collection, memory that hasn’t been GC’d doesn’t count against the script’s memory limit when it’s no longer reachable.1

The reason why Mono/SLua implements its memory limits this way is because there’s a single VM/GC governing their scripts, and you don’t want to “stop the world” to run the garbage collector just to see if you can get a single script back under its limit.

LSO

Section titled “LSO”

LSO scripts always use 16KiB of memory.

Caveats

Section titled “Caveats”
  • Scripts compiled to LSO always report 16KB memory used.
  • This can be called at any time and does not require llScriptProfiler

Examples

Section titled “Examples”
Calling llGetUsedMemory can look like this:
integer used_memory = llGetUsedMemory();
llOwnerSay((string)used_memory + " bytes of memory currently used.");

Notes

Section titled “Notes”

The amount of used memory is updated only at the start of a server frame, meaning the values from this function can fluctuate. To ensure stable values, it’s possible to wait until the next frame, e.g. llSleep(0.01) before the call to llGetUsedMemory.

History

Section titled “History”

Date of Release 17/06/2011

See also

Section titled “See also”

Functions

Section titled “Functions”
Original wiki source

Some wiki templates and tables need their original context. View this article on the Second Life Wiki. Technical wording and examples are retained from the source; historical guidance may differ from current behavior.

From the Second Life Wiki

Community documentation adapted from LlGetUsedMemory, by Linden Research, Inc. and contributing residents.View contributors and history.

Imported wiki revision:

Licensed under CC BY-SA 3.0. Last wiki edit: .Formatting and links have been adapted for this site; API metadata follows the LSL definitions.

Footnotes

Section titled “Footnotes”

  1. Explanation given by Harold Linden in the official Discord server. ↩