From Second Life Wiki
|LSL Portal||Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials|
Give inventory to destination.
|• key||destination||–||avatar or prim UUID|
|• string||inventory||–||an item in the inventory of the prim this script is in|
If destination is an object then it must be in the same region.
If destination is an avatar they do not have to be in the same region.
- If destination is an avatar the script sleeps for 2.0 seconds. (Giving to objects or attachments has no delay)
- If DEBUG_CHANNEL. is not the owner nor shares the same owner, and does not have transfer permissions, an error is shouted on
- 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 DEBUG_CHANNEL. is missing from the prim's inventory then an error is shouted on
- There is no way to know if the transaction failed.
- Scripts reach destination disabled (not running, and cannot be made to run unless the destination object is taken to inventory and rezzed again, or the script is recompiled). To send a running script to a prim use llSetRemoteScriptAccessPin and llRemoteLoadScriptPin.
- If destination is locked then inventory is not transferred and a Blocked by permissions error is shouted on the DEBUG_CHANNEL.
- If inventory is no-copy it is transfered to destination without copying it. Since it is no-copy the only copy is given to destination; removing it from the source prim's inventory.
- To avoid this problem use llGetInventoryPermMask to check the permissions of inventory.
- Attachments cannot give no-copy inventory. When attempted an error is shouted on DEBUG_CHANNEL.
- If destination is an avatar that refuses to accept it (by manual decline or muting), is in busy mode, or is offline with instant messages capped, it is not returned to the prim's inventory; it is deleted.
- It is not returned to the owner. It does not show up in their lost and found or any other inventory folder.
- It is not put in the target's trash folder.
- As of 31th January 2012, llGiveInventory now has similar throttle to instant messages. A throttle of 5k per hour per owner per region; with a maximum burst of 2.5k.
- "With 3k subscribers you will want to send slow enough that it takes ~45 minutes to send 1 item to each subscriber. A general safe way would be to send ~2k as fast as you can, then wait 31 minutes and send another 2k." Kelly Linden on SVC-7631
- Be aware that while you script a system to handle the top of these limits that other busy scripted objects can be adding up to the throttle as well, such as vendors.
Important Issues~ All Issues ~ Search JIRA for related Bugs
|SVC-7631||A||New rate throttle on llGiveInventory|
This related article at the LSL Wiki is able to bring enlightenment.wasn't helpful for you? Maybe the