Difference between revisions of "LlBreakAllLinks"

Revision as of 20:27, 16 April 2007

Function: llBreakAllLinks( );

Delinks all tasks in the link set.

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 llBreakAllLinks();

@@ Line 1: / Line 1: @@
-{{LSL_Function/permission|PERMISSION_ATTACH|grant=the owner}}{{LSL_Function
+{{LSL_Function/permission|PERMISSION_CHANGE_LINKS|grant=the owner}}{{LSL_Function
 |sort=BreakAllLinks
 |func_id=143|func_sleep=0.0|func_energy=10.0
 |func=llBreakAllLinks
 |func_desc=Delinks all tasks in the link set.
-|permission=PERMISSION_CHANGE_LINKS
 |func_footnote
 |return_text

•	llGetPermissions	–	Get the permissions granted
•	llGetPermissionsKey	–	Get the agent who granted permissions
•	llRequestPermissions	–	Request permissions
•	llBreakLink	–	Break a link
•	llCreateLink	–	Link to another object