Debug Permissions

2013-03-03T00:22:36Z

Allen Michalski:

{{Help|Object=*|BugFixes=*}}
'''Debug Permissions is a tool which shows you granular attributes of your Second Life items.''' Permissions have numerous subtleties and with some practice, Debug Permissions can help you figure these out. You should have a firm understanding of [[Next-owner permissions FAQ|next-owner permissions]] before using Debug Permissions.

To view Debug Permissions:

# If using Viewer 2.0 or later, open the '''Build''' -> '''Options''' menu, and enable '''Show Advanced Permissions'''. If using Viewer 1.23.5 or earlier, open the [[Advanced menu|'''Advanced''' menu]] and select '''Debug Permissions'''.
# Right-click an object and select '''Edit'''.
# If the '''General''' tab in the build tools isn't selected, click it.

Now, you'll see what was previously a blank spot has been filled in with additional '''Permissions:''' status.

[[Image:Debug-Permissions.png]]

Here's what all the abbreviations mean:

* '''B = Base''' - The object can ''never'' be more permissive than this.
* '''O = Owner''' - The permissions the owner (you) currently has.
* '''G = Group''' - The permissions group members currently have on the object. (The group the object is set or deeded to is shown next to '''Group:''' above.)
* '''E = Everyone''' - The permissions everyone else has on the object.
* '''N = Next Owner''' - The permissions the next person to own the object will have.
* '''F = Full/Folded''' - The permissions of the object as a whole, including all permissions of the object's contents. For example, a copyable object which has a no-copy item added to its contents becomes non-copyable as a whole because it's restricted by the no-copy content item.
* '''M, C, and T = Modify, Copy, and Transfer''' - Standard permissions.
* '''V = Velocity''' - This actually means "can move" permissions. For instance, if an object shows "E: V", this means everyone can move this object around inworld, which is the the same as '''Allow anyone to move''' being enabled.
* '''* = Slam bit''' - Explained more in the next section.

== What is a slam bit? ==
A "slam bit" is an informal term which refers to the "'''*'''" which appears next to the '''N''' (next owner) when changing permissions of an object in your inventory. For this reason, you'll only see the slam bit on inventory objects, not inworld ones. For example:

[[Image:Slam-bit.png]]

This is shown because '''next-owner permissions are only applied when the object is rezzed inworld'''. For example: you've given what you think is a no-copy gift to a friend but are surprised when you visit them and they have multiple copies out on their lawn. The rezzed copies have been restricted to no-copy since when each is rezzed, permissions are applied, but their inventory version (the one you gave them directly) doesn't have such restrictions.

It's also important to note, object transfers between avatars can result in unexpected permission behavior, ''if'' an object isn't rezzed to 'slam' the currently set permissions befor making changes. It's best practice to rez any object you receive before making additional '''in-inventory''' permission changes. (see https://jira.secondlife.com/browse/SVC-8223)

Technically, this is because an object's permissions as seen in your inventory (a database handle pointing to an asset) are out-of-sync with the asset's permission itself. We're aware of the confusion this causes. Unfortunately, it's a very difficult thing to fix.

The important lesson here: '''if you can avoid it, do NOT change an object's permissions when it's in your inventory. If you do, be sure to rez it to apply ("slam") those permissions, then take the resulting copy'''. Make sure earlier copies are archived or deleted as-needed to avoid confusion and accidentally giving the wrong thing out. While it takes a little time, double-checking permissions before distributing objects goes a long way towards preventing trouble.

For those that are wanting to use "Slam Bit" as a tool for games in Second Life such as breedables and trading card games; in the way that you have object B inside the inventory of object A and you desire object B to be rezed many times out from object A but then be No Copy after it has rezed; follow these steps.

1. Rez object B in world.

2. Set the script inside the object to no copy (don't forget No Mod if you need it).

3. Pull prim into inventory (you will now notice the No Copy perm has been set automatically).

4. Edit permissions (object B still in inventory) and set object to Copy.

5. DO NOT rez object B. Edit object A and put object B into Object A's inventory.

[[Category:Permissions]]
[[Category:Advanced menu]]

Debug Permissions

2013-03-03T00:20:37Z

Allen Michalski: Clear instructions on how to use the "Slam Bit" functionality in your own builds.

{{Help|Object=*|BugFixes=*}}
'''Debug Permissions is a tool which shows you granular attributes of your Second Life items.''' Permissions have numerous subtleties and with some practice, Debug Permissions can help you figure these out. You should have a firm understanding of [[Next-owner permissions FAQ|next-owner permissions]] before using Debug Permissions.

To view Debug Permissions:

# If using Viewer 2.0 or later, open the '''Build''' -> '''Options''' menu, and enable '''Show Advanced Permissions'''. If using Viewer 1.23.5 or earlier, open the [[Advanced menu|'''Advanced''' menu]] and select '''Debug Permissions'''.
# Right-click an object and select '''Edit'''.
# If the '''General''' tab in the build tools isn't selected, click it.

Now, you'll see what was previously a blank spot has been filled in with additional '''Permissions:''' status.

[[Image:Debug-Permissions.png]]

Here's what all the abbreviations mean:

* '''B = Base''' - The object can ''never'' be more permissive than this.
* '''O = Owner''' - The permissions the owner (you) currently has.
* '''G = Group''' - The permissions group members currently have on the object. (The group the object is set or deeded to is shown next to '''Group:''' above.)
* '''E = Everyone''' - The permissions everyone else has on the object.
* '''N = Next Owner''' - The permissions the next person to own the object will have.
* '''F = Full/Folded''' - The permissions of the object as a whole, including all permissions of the object's contents. For example, a copyable object which has a no-copy item added to its contents becomes non-copyable as a whole because it's restricted by the no-copy content item.
* '''M, C, and T = Modify, Copy, and Transfer''' - Standard permissions.
* '''V = Velocity''' - This actually means "can move" permissions. For instance, if an object shows "E: V", this means everyone can move this object around inworld, which is the the same as '''Allow anyone to move''' being enabled.
* '''* = Slam bit''' - Explained more in the next section.

== What is a slam bit? ==
A "slam bit" is an informal term which refers to the "'''*'''" which appears next to the '''N''' (next owner) when changing permissions of an object in your inventory. For this reason, you'll only see the slam bit on inventory objects, not inworld ones. For example:

[[Image:Slam-bit.png]]

This is shown because '''next-owner permissions are only applied when the object is rezzed inworld'''. For example: you've given what you think is a no-copy gift to a friend but are surprised when you visit them and they have multiple copies out on their lawn. The rezzed copies have been restricted to no-copy since when each is rezzed, permissions are applied, but their inventory version (the one you gave them directly) doesn't have such restrictions.

It's also important to note, object transfers between avatars can result in unexpected permission behavior, ''if'' an object isn't rezzed to 'slam' the currently set permissions befor making changes. It's best practice to rez any object you receive before making additional '''in-inventory''' permission changes. (see https://jira.secondlife.com/browse/SVC-8223)

Technically, this is because an object's permissions as seen in your inventory (a database handle pointing to an asset) are out-of-sync with the asset's permission itself. We're aware of the confusion this causes. Unfortunately, it's a very difficult thing to fix.

The important lesson here: '''if you can avoid it, do NOT change an object's permissions when it's in your inventory. If you do, be sure to rez it to apply ("slam") those permissions, then take the resulting copy'''. Make sure earlier copies are archived or deleted as-needed to avoid confusion and accidentally giving the wrong thing out. While it takes a little time, double-checking permissions before distributing objects goes a long way towards preventing trouble.

For those that are wanting to use "Slam Bit" as a tool for games in Second Life such as breedables and trading card games; in the way that you have object B inside the inventory of object A and you desire object B to be rezed many times out from object A but then be No Copy after it has rezed; follow these steps.

1. Rez object B in world.
2. Set the script inside the object to no copy (don't forget No Mod if you need it).
3. Pull prim into inventory (you will now notice the No Copy perm has been set automatically).
4. Edit permissions (object B still in inventory) and set object to Copy.
5. DO NOT rez object B. Edit object A and put object B into Object A's inventory.

[[Category:Permissions]]
[[Category:Advanced menu]]

Second Life Wiki - User contributions [en]

Debug Permissions

Debug Permissions