Difference between revisions of "LlCreateLink"

Revision as of 20:28, 16 April 2007

Function: llCreateLink( key target, integer parent );

Attempt to link task script is attached to and target. If parent == TRUE, task script is attached to is the root

• key	target
• integer	parent

To run this function the script must request the PERMISSION_CHANGE_LINKS permission with llRequestPermissions and it must be granted by the owner.

Do not depend upon the auto-grant status of permissions. Always use the run_time_permissions event.
If the script lacks the permission PERMISSION_CHANGE_LINKS, the script will shout an error on DEBUG_CHANNEL and the operation fails (but the script continues to run).
If PERMISSION_CHANGE_LINKS is granted by anyone other than the owner, then when the function is called an error will be shouted on DEBUG_CHANNEL.

Once the PERMISSION_CHANGE_LINKS permission is granted there is no way to revoke it except from inside the script (for example, with a new llRequestPermissions call) or the script is reset or deleted.

Signature
function void llCreateLink( key target, integer parent );

@@ Line 1: / Line 1: @@
-{{LSL_Function
+{{LSL_Function/permission|PERMISSION_CHANGE_LINKS|grant=the owner}}{{LSL_Function
 |func_id=141|func_sleep=1.0|func_energy=10.0
 |func=llCreateLink|sort=CreateLink
 |p1_type=key|p1_name=target
 |p2_type=integer|p2_name=parent
-|permission=PERMISSION_CHANGE_LINKS
 |func_desc=Attempt to link task script is attached to and target. If '''parent''' == {{LSLG|TRUE}}, task script is attached to is the root
 |return_text

•	llGetPermissions	–	Get the permissions granted
•	llGetPermissionsKey	–	Get the agent who granted permissions
•	llRequestPermissions	–	Request permissions
•	llBreakLink	–	Break a link
•	llBreakAllLinks	–	Break all links