Difference between revisions of "LlManageEstateAccess"

From Second Life Wiki
Jump to navigation Jump to search
m
(add caveat: llAddTo*List() returns True even when operation is truncated at max list length)
 
(10 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{LSL_Function
{{LSL_Function
|inject-2={{LSL_Function/avatar|avatar|group=*}}
|inject-2=
{{LSL_Function/avatar|avatar|group=*}}
<!-- Grab caveats etc from them
{{:ESTATE_ACCESS_ALLOWED_AGENT_ADD|set}}
{{:ESTATE_ACCESS_ALLOWED_AGENT_REMOVE|set}}
{{:ESTATE_ACCESS_ALLOWED_GROUP_ADD|set}}
{{:ESTATE_ACCESS_ALLOWED_GROUP_REMOVE|set}}
{{:ESTATE_ACCESS_BANNED_AGENT_ADD|set}}
{{:ESTATE_ACCESS_BANNED_AGENT_REMOVE|set}}
-->
{{Issues/SCR-293}}
|func=llManageEstateAccess
|func=llManageEstateAccess
|sort=ManageEstateAccess
|sort=ManageEstateAccess
Line 7: Line 17:
|p2_type=key|p2_name=avatar
|p2_type=key|p2_name=avatar
|func_desc=Use to add or remove agents from the estate's agent access or ban lists or groups from the estate's group access list.
|func_desc=Use to add or remove agents from the estate's agent access or ban lists or groups from the estate's group access list.
|func_footnote=Only works for objects owned by the Estate Owner or an [[Estate Manager]].
|func_footnote=Only works for objects owned by the Estate Owner or an [[Estate Manager]]. By default, the object owner is notified of every change made using this function.  But if the owner grants [[PERMISSION_SILENT_ESTATE_MANAGEMENT]] to the script, the owner will not be notified.
|return_text= representing a boolean, [[TRUE]] if the call was successful; [[FALSE]] if throttled, invalid action, invalid or null id or object owner is not allowed to manage the estate.  
|return_text=[[TRUE]] if the call was successful; [[FALSE]] if throttled, invalid action, invalid or null id or object owner is not allowed to manage the estate.  
|return_type=integer
|return_type=integer
|return_subtype=boolean
|constants=
|constants=
{{{!}} class="sortable" {{Prettytable}}
{{LSL Constants/llManageEstateAccess}}
{{!}}- {{Hl2}}
|signature
!{{!}} '''{{LSL Param|action}}''' flag
! title="Value" {{!}} V
!{{!}} Description
{{!}}-
{{!}} {{LSL Const|ESTATE_ACCESS_ALLOWED_AGENT_ADD|integer}}
{{!}} {{#var:value}}
{{!}} Add the agent to this estate's Allowed Residents list.
{{!}}-
{{!}} {{LSL Const|ESTATE_ACCESS_ALLOWED_AGENT_REMOVE|integer}}
{{!}} {{#var:value}}
{{!}} Remove the agent from this estate's Allowed Residents list.
{{!}}-
{{!}} {{LSL Const|ESTATE_ACCESS_ALLOWED_GROUP_ADD|integer}}
{{!}} {{#var:value}}
{{!}} Add the group to this estate's Allowed groups list.
{{!}}-
{{!}} {{LSL Const|ESTATE_ACCESS_ALLOWED_GROUP_REMOVE|integer}}
{{!}} {{#var:value}}
{{!}} Remove the group from this estate's Allowed groups list.
{{!}}-
{{!}} {{LSL Const|ESTATE_ACCESS_BANNED_AGENT_ADD|integer}}
{{!}} {{#var:value}}
{{!}} Add the agent to this estate's Banned residents list.
{{!}}-
{{!}} {{LSL Const|ESTATE_ACCESS_BANNED_AGENT_REMOVE|integer}}
{{!}} {{#var:value}}
{{!}} Remove the agent from this estate's Banned residents list.
{{!}}}
|signature=
{{LSL Const/Signature|ESTATE_ACCESS_ALLOWED_AGENT_ADD|integer}}
{{LSL Const/Signature|ESTATE_ACCESS_ALLOWED_AGENT_REMOVE|integer}}
{{LSL Const/Signature|ESTATE_ACCESS_ALLOWED_GROUP_ADD|integer}}
{{LSL Const/Signature|ESTATE_ACCESS_ALLOWED_GROUP_REMOVE|integer}}
{{LSL Const/Signature|ESTATE_ACCESS_BANNED_AGENT_ADD|integer}}
{{LSL Const/Signature|ESTATE_ACCESS_BANNED_AGENT_REMOVE|integer}}
|spec
|spec
|caveats=
|caveats=
Line 53: Line 29:
* [[FALSE]] will be returned...
* [[FALSE]] will be returned...
** if throttled,
** if throttled,
** if '''{{LSL Param|action}}''' is invalid,
** if object owner doesn't have power to perform {{LSLP|action}},
** if '''{{LSL Param|avatar}}''' is invalid or null
** if {{LSLP|avatar}} is invalid or null
** if the object owner is not allowed to manage the estate.  
* If used on [[mainland]] the message "llManageEstateAccess does not work on mainland" is [[llShout|shouted]] on [[DEBUG_CHANNEL]].
* If the object owner is not allowed to manage the estate the message "llManageEstateAccess object owner must manage estate." is [[llShout|shouted]] on [[DEBUG_CHANNEL]]. -- {{Jira|SRC-233}}
* If a legit estate manager tries to exceed the max number of entries in the list the call will return [[TRUE]] but the operation be truncated at the limit.
|examples
|examples
|helpers
|helpers
Line 73: Line 51:
|cat2=Region
|cat2=Region
|cat3=Estate
|cat3=Estate
|cat4}}
|cat4
|history = Date of Release  [[ Release_Notes/Second_Life_Server/11#11.10.18.243270 | 18/10/2011 ]]
}}

Latest revision as of 13:58, 30 June 2023

Summary

Function: integer llManageEstateAccess( integer action, key avatar );

Use to add or remove agents from the estate's agent access or ban lists or groups from the estate's group access list.
Returns a boolean (an integer) TRUE if the call was successful; FALSE if throttled, invalid action, invalid or null id or object owner is not allowed to manage the estate.

• integer action ESTATE_ACCESS_* flag
• key avatar avatar or group UUID

Only works for objects owned by the Estate Owner or an Estate Manager. By default, the object owner is notified of every change made using this function. But if the owner grants PERMISSION_SILENT_ESTATE_MANAGEMENT to the script, the owner will not be notified.

action flag V Description
ESTATE_ACCESS_ALLOWED_AGENT_ADD 0x4 Add the agent to this estate's Allowed Residents list.
ESTATE_ACCESS_ALLOWED_AGENT_REMOVE 0x8 Remove the agent from this estate's Allowed Residents list.
ESTATE_ACCESS_ALLOWED_GROUP_ADD 0x10 Add the group to this estate's Allowed groups list.
ESTATE_ACCESS_ALLOWED_GROUP_REMOVE 0x20 Remove the group from this estate's Allowed groups list.
ESTATE_ACCESS_BANNED_AGENT_ADD 0x40 Add the agent to this estate's Banned residents list.
ESTATE_ACCESS_BANNED_AGENT_REMOVE 0x80 Remove the agent from this estate's Banned residents list.

Caveats

  • Calls are throttled at a rate of 30 calls per 30 seconds.
  • FALSE will be returned...
    • if throttled,
    • if object owner doesn't have power to perform action,
    • if avatar is invalid or null
  • If used on mainland the message "llManageEstateAccess does not work on mainland" is shouted on DEBUG_CHANNEL.
  • If the object owner is not allowed to manage the estate the message "llManageEstateAccess object owner must manage estate." is shouted on DEBUG_CHANNEL. -- SRC-233
  • If a legit estate manager tries to exceed the max number of entries in the list the call will return TRUE but the operation be truncated at the limit.

Important Issues

~ All Issues ~ Search JIRA for related Bugs
   ESTATE_ACCESS_BANNED_AGENT_ADD can ban estate owner!

Examples

Deep Notes

History

Date of Release 18/10/2011

All Issues

~ Search JIRA for related Issues
   ESTATE_ACCESS_BANNED_AGENT_ADD can ban estate owner!

Signature

function integer llManageEstateAccess( integer action, key avatar );