llGetFreeURLs

Template:Needs Translation/LSL/de Template:Needs Translation/LSL/es Template:Needs Translation/LSL/el Template:Needs Translation/LSL/fr Template:Needs Translation/LSL/he Template:Needs Translation/LSL/it Template:Needs Translation/LSL/ko Template:Needs Translation/LSL/nl Template:Needs Translation/LSL/hu Template:Needs Translation/LSL/no Template:Needs Translation/LSL/da Template:Needs Translation/LSL/sv Template:Needs Translation/LSL/tr Template:Needs Translation/LSL/pl Template:Needs Translation/LSL/pt Template:Needs Translation/LSL/ru Template:Needs Translation/LSL/th Template:Needs Translation/LSL/uk Template:Needs Translation/LSL/zh-Hans Template:Needs Translation/LSL/zh-Hant

/LSL

GetFreeURLs

llGetFreeURLs

Summary

Function: integer llGetFreeURLs( );

0.0	Forced Delay
10.0	Energy

Returns an integer that is the number of available URLs. If attached, return the URLs remaining for the owner. Otherwise, return the available URLs for the region.

Specification

There is a separate URL limit for the region, and a limit for each agent. The URL limit is the same as the Land Impact limit:

• Agent: 38
• Openspace Sim: 1,250
• Homestead Sim: 5,000
• Full Sim: 20,000
• Mainland Sim: 22,500
• 30k Sim: 30,000

Caveats

• If called from an attachment, there is no way to get the number of free URLs in the region; it will always return the URL count remaining for the agent.

Examples

This script will say the number of currently available HTTP-In URLs left in the region.

default
{
    touch_start(integer num_detected)
    {
        integer numberOfFreeURLs = llGetFreeURLs();

        if (numberOfFreeURLs)
        {
            llSay(0, "There are " + (string)numberOfFreeURLs + " available HTTP-In URLs left in this region.");
        }
        else
        {
            llSay(0, "WARNING: There are no HTTP-In URLs available anymore.");
        }
    }
}

// WARNING:
//
//      This script is only for proof-of-concept (demo purposes).
//      DO NOT use it if you don't have the sim owners and/or
//      estate managers OK to test this script.
//      This script can possibly block HTTP communication from and to the sim.
//      ...bringing down all networked vendors and/or similar machines.
//
//      This script allocates all available URLs.
//      Deleting the script and/or derezzing the object containing the script,
//      will release all previously taken URLs.
 
default
{
    state_entry()
    {
        llRequestURL();
    }
 
    http_request(key request_id, string method, string body)
    {
        if (method == URL_REQUEST_DENIED)
        {
            llSetText("No free URLs!", <1.0, 0.0, 0.0>, 1.0);
        }
        else if (method == URL_REQUEST_GRANTED)
        {
            llSetText((string)llGetFreeURLs() + " URLs left\n" + body, <1.0, 1.0, 1.0>, 1.0);
            llRequestURL();
        }
        else if (method == "GET")
        {
            llHTTPResponse(id, 200, "Hello there!");
        }
    }
}

Notes

URLs are a finite region resource and should be released when no longer needed.

See Also

Functions

•	llRequestURL
•	llRequestSecureURL
•	llReleaseURL
•	llHTTPResponse
•	llGetHTTPHeader

Articles

•

LSL http server

Deep Notes

History

• SVN:1836 r112899 Trunk

Signature
function integer llGetFreeURLs();