Difference between revisions of "Template:LSL Function/permission"

From Second Life Wiki
Jump to navigation Jump to search
(PERMISSION_TAKE_CONTROLS can be revoked from the viewer.)
m
Line 1: Line 1:
{{#if:
{{#if:
{{#vardefine:header_footnote|{{#var:header_footnote}}{{#if: {{{1|}}}| Requires the [[{{{1}}}]] permission{{#ifeq:{{{grant|anyone}}}|anyone||, granted by {{{grant|anyone}}},}} to run.}}}}
 
{{{{#if:{{#var:DEBUG_CHANNEL}}||:DEBUG_CHANNEL}}|}}
 
{{#vardefine:header_footnote|{{#var:header_footnote}}{{#if: {{{1|<noinclude>*</noinclude>}}}| Requires the [[{{{1}}}]] permission{{#ifeq:{{{grant|anyone}}}|anyone||, granted by {{{grant|anyone}}},}} to run.}}}}
{{#vardefine:caveats|{{#var:caveats}}{{#if: {{{1|<noinclude>*</noinclude>}}}|
{{#vardefine:caveats|{{#var:caveats}}{{#if: {{{1|<noinclude>*</noinclude>}}}|
* Do not depend upon the auto-grant status of permissions. '''Always''' use the [[run_time_permissions]] event.
* Do not depend upon the auto-grant status of permissions. '''Always''' use the [[run_time_permissions]] event.
* If the script lacks the permission [[{{{1}}}]], the script will shout an error on {{LSL Const|DEBUG_CHANNEL|integer|2147483647|hex=0x7FFFFFFF}} and the operation fails (but the script continues to run).{{#ifeq:{{{grant|anyone<noinclude>*</noinclude>}}}|anyone||
* If the script lacks the permission [[{{{1}}}]], the script will shout an error on {{#var:DEBUG_CHANNEL}} and the operation fails (but the script continues to run).{{#ifeq:{{{grant|anyone<noinclude>*</noinclude>}}}|anyone||
* If [[{{{1}}}]] is granted by anyone other than {{{grant|anyone}}}, then when the function is called an error will be shouted on {{LSL Const|DEBUG_CHANNEL|integer|2147483647|hex=0x7FFFFFFF}}.}}}}
* If [[{{{1}}}]] is granted by anyone other than {{{grant|anyone}}}, then when the function is called an error will be shouted on {{#var:DEBUG_CHANNEL}}.}}}}
{{#ifeq:{{{1}}}|PERMISSION_TAKE_CONTROLS|* Once the [[{{{1}}}]] permission is granted, it can be revoked from inside the script (with [[llReleaseControls]] or a new [[llRequestPermissions]] call), or if the user chooses Release Keys from the viewer. Otherwise, the script will only lose the permission if it is reset or the object derezzed (deleted, detached, or taken). |* Once the [[{{{1}}}]] permission is granted there is no way to revoke it except from inside the script (for example, with a new [[llRequestPermissions]] call). Otherwise, the script will only lose the permission if it is reset or the object derezzed (deleted, detached, or taken).}} }}
{{#ifeq:{{{1}}}|PERMISSION_TAKE_CONTROLS|* Once the [[{{{1}}}]] permission is granted, it can be revoked from inside the script (with [[llReleaseControls]] or a new [[llRequestPermissions]] call), or if the user chooses Release Keys from the viewer. Otherwise, the script will only lose the permission if it is reset or the object derezzed (deleted, detached, or taken). |* Once the [[{{{1}}}]] permission is granted there is no way to revoke it except from inside the script (for example, with a new [[llRequestPermissions]] call). Otherwise, the script will only lose the permission if it is reset or the object derezzed (deleted, detached, or taken).}} }}
{{#vardefine:also_events|{{#var:also_events}}
{{#vardefine:also_events|{{#var:also_events}}

Revision as of 06:00, 1 April 2009

Name Value
header_footnote Requires the [[{{{1}}}]] permission to run.
caveats
  • Do not depend upon the auto-grant status of permissions. Always use the run_time_permissions event.
  • If the script lacks the permission [[{{{1}}}]], the script will shout an error on DEBUG_CHANNEL and the operation fails (but the script continues to run).
  • If [[{{{1}}}]] is granted by anyone other than anyone, then when the function is called an error will be shouted on DEBUG_CHANNEL.
  • Once the [[{{{1}}}]] permission is granted there is no way to revoke it except from inside the script (for example, with a new llRequestPermissions call). Otherwise, the script will only lose the permission if it is reset or the object derezzed (deleted, detached, or taken).
also_events
•  run_time_permissions Permission receiving event
also_functions
•  llGetPermissions Get the permissions granted
•  llGetPermissionsKey Get the agent who granted permissions
•  llRequestPermissions Request permissions
also_articles
•  Script permissions