llRemoteLoadScriptPin
Revision as of 10:35, 3 January 2014 by Maestro Linden (talk | contribs) (Documented dependency of 'can modify my objects' ability being tied to the agent being present in the sim (see BUG-4812 for details))
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: llRemoteLoadScriptPin( key target, string name, integer pin, integer running, integer start_param );
| 3.0 | Forced Delay |
| 10.0 | Energy |
Copy script name into target and set to running with a start_param only if target's pin matches pin
| • key | target | – | prim UUID that is in the same region | |
| • string | name | – | a script in the inventory of the prim this script is in | |
| • integer | pin | – | Must match pin set by llSetRemoteScriptAccessPin | |
| • integer | running | – | boolean, if the script is to be set as running. | |
| • integer | start_param | – | value returned by llGetStartParameter in the target script. |
Only works if the script owner can modify target.
Caveats
- This function causes the script to sleep for 3.0 seconds.
- If target is not owned by the same person, and name does not have transfer permissions, an error is shouted on DEBUG_CHANNEL.
- If name permissions do not allow copy, the transfer fails and an error is shouted on DEBUG_CHANNEL.
- If target is not in the same region an error is shouted on DEBUG_CHANNEL.
- When scripts are copied or moved between inventories, their state does not survive the transfer. Memory, event queue and execution position are all discarded.
- If name is missing from the prim's inventory or it is not a script then an error is shouted on DEBUG_CHANNEL.
- If name is present in the target prim's inventory then it is silently replaced.
- start_param only lasts until the script is reset.
- Only the owner of an attachment can modify it while it is being worn.
- If target is an attachment owned by a different user, regardless of object modify rights granted, this function will silently fail.
- If target is owned by a different user and modify permission has been granted to the script owner via Edit, delete, or take my objects, the script owner must be connected to the sim for this function to succeed.
- If pin fails to match, the error "Task ~Prim~ trying to illegally load script onto task ~Other_Prim~!" is shouted on DEBUG_CHANNEL. "~Prim~" and "~Other_Prim~" are substituted with the applicable prim names.
- If target is the script's parent (
target == llGetKey()) then "Unable to add item!" is shouted on DEBUG_CHANNEL. - If the object containing this script is deeded to a group, than script name needs transfer permissions; even if target is deeded to the same group.
- When the script is set to run (with running, the running checkbox or llSetScriptState) state_entry will be queued.
Examples
Basic Example
Script copier
<lsl>//Copy a script to the second prim integer PIN=1341134;
default {
state_entry() {
llRemoteLoadScriptPin( llGetLinkKey(2), "some script", PIN, TRUE, 0xBEEEEEEF );
}
}</lsl>
Pin setter
Simple script used for setting the pin for a prim, so you can later send scripts to it with llRemoteLoadScriptPin. <lsl>//Child Prim PIN setter integer PIN=1341134;
default {
state_entry() {
llOwnerSay(llGetObjectName()+" : "+(string)llGetKey()+" is ready to accept a describer script using the agreed upon PIN.");
llSetRemoteScriptAccessPin(PIN);
}
}</lsl>
Rez and copy a file from a control object
Notes: There is currently no signing on the starting messages only the owner is checked.
this example rezs a prim from inventory that has a basic control file inside of it and does a basic handshake to setup the pin and transfer the script.
after the transfert the helper script in the rezzed prim deletes itself.
Control prim
<lsl> integer controlchan = 0; integer controlid = -1; start() {
llSetTimerEvent(0);
talkingto = NULL_KEY;
integer a = (integer)llFrand(43);
controlchan = a * a;
controlchan -= controlchan * 3;
controlid = llListen(controlchan,"","","set-connect");
llRezObject("card",llGetPos()+<0,0,0.1>,<0,0,0>,ZERO_ROTATION,a);
llSetTimerEvent(60);
} key talkingto = NULL_KEY; integer busy = FALSE; integer accesspin = 0; default {
timer()
{
llSetTimerEvent(0);
llOwnerSay("Lost connection!");
llListenRemove(controlid);
busy = FALSE;
}
listen(integer chan,string name,key id,string message)
{
if(chan == controlchan)
{
if(llGetOwnerKey(id) == llGetOwner())
{
if(talkingto == NULL_KEY)
{
if(message == "set-connect")
{
llSetTimerEvent(0);
talkingto = id;
llListenRemove(controlid);
controlid = llListen(controlchan,"",talkingto,"ready");
llRegionSayTo(id,controlchan,"auto-connect");
llSetTimerEvent(60);
}
}
else if(id == talkingto)
{
if(message == "ready")
{
llSetTimerEvent(0);
accesspin = (integer)llFrand(2345)+213;
llListenRemove(controlid);
controlid = llListen(controlchan,"",talkingto,"pinset");
llSleep(1);
llRegionSayTo(talkingto,controlchan,(string)accesspin);
llSetTimerEvent(60);
}
else if(message == "pinset")
{
llSetTimerEvent(0);
llListenRemove(controlid);
llRemoteLoadScriptPin(talkingto,"demo.lsl",accesspin,1,0);
llSleep(3);
llRegionSayTo(talkingto,controlchan,"finished");
llOwnerSay("Transfer of file finished - control file should have auto deleted itself!");
busy = FALSE;
}
}
}
}
}
touch_end(integer a)
{
if(busy == FALSE)
{
busy = TRUE;
if(llGetOwner() == llDetectedKey(0))
{
start();
}
}
}
} </lsl>
rezzed prim
<lsl> integer listen_id = -1; integer listen_chan = -1; key details_from = NULL_KEY; default {
on_rez(integer a)
{
if(a == 0)
{
llOwnerSay("- Direct rez -");
}
else
{
llOwnerSay("- Awaiting config connection -");
listen_chan = a * a;
listen_chan -= listen_chan * 3;
listen_id = llListen(listen_chan,"","","auto-connect");
llWhisper(listen_chan,"set-connect");
llSetTimerEvent(30);
}
}
timer()
{
llOwnerSay("Failed to connect to rezzer deleting myself!");
llSetTimerEvent(0);
llDie();
}
listen(integer chan,string name,key id,string message)
{
if(llGetOwnerKey(id) == llGetOwner())
{
if(message == "auto-connect")
{
llSetTimerEvent(0);
llListenRemove(listen_id);
listen_id = llListen(listen_chan,"",id,"");
llRegionSayTo(id,listen_chan,"ready");
details_from = id;
llSetTimerEvent(30);
}
else if(details_from != NULL_KEY)
{
llSetTimerEvent(0);
if(message == "finished")
{
llSetRemoteScriptAccessPin((integer)message);
llRemoveInventory(llGetScriptName());
}
else
{
llSetRemoteScriptAccessPin((integer)message);
llRegionSayTo(id,listen_chan,"pinset");
}
llSetTimerEvent(30);
}
}
}
}
</lsl>See Also
Functions
| • | llSetRemoteScriptAccessPin | – | Used to setup a prim for remote loading | |
| • | llSetScriptState | – | Set a scripts running state | |
| • | llResetOtherScript | – | Reset another script in the prim |
Deep Notes
History
- Added in 1.2.6
- In SL 1.25.4 this function will not copy/move any script into an attachment unless the script is full perm. (SVC-3725)
- SL 1.25.5 will allow this function to copy/move a script into an attachment so long as the target has matching (or more restrictive) copy and transfer permissions. (SVC-3738)
Signature |
|---|
function void llRemoteLoadScriptPin( key target, string name, integer pin, integer running, integer start_param ); |