Difference between revisions of "Error Codes"
From SphereWiki
MrSugarCube (talk | contribs) (Tried to improve the garbage collection table with more accurate error descriptions, and the actual error message to help with searching) |
(→Exit Codes) |
||
| (4 intermediate revisions by 2 users not shown) | |||
| Line 18: | Line 18: | ||
| -8 || Failed to load world save(s) | | -8 || Failed to load world save(s) | ||
|- | |- | ||
| − | | -3 || Failed to load server settings (script, ini, mul files) | + | | -3 || Failed to load server settings (script, ini, mul files) ''or'' <br />did not write AGREE=1 in the sphere.ini |
|- | |- | ||
| -1 || Shutdown via commandline (/?, /T and /Q switches) | | -1 || Shutdown via commandline (/?, /T and /Q switches) | ||
| Line 32: | Line 32: | ||
| 6 || SIGABRT signal, process aborted ''(Linux Only)'' | | 6 || SIGABRT signal, process aborted ''(Linux Only)'' | ||
|} | |} | ||
| − | |||
==Garbage Collection== | ==Garbage Collection== | ||
| Line 53: | Line 52: | ||
| 1103 || Ridden NPC not acting as such || An NPC has the [[FLAGS|statf_ridden]] flag set, but does not have its [[ACTION]] property set to 111. || | | 1103 || Ridden NPC not acting as such || An NPC has the [[FLAGS|statf_ridden]] flag set, but does not have its [[ACTION]] property set to 111. || | ||
|- | |- | ||
| − | | 1104 || Ridden NPC without a mount item || An NPC has the [[FLAGS|statf_ridden]] flag set, but its | + | | 1104 || Ridden NPC without a mount item || An NPC has the [[FLAGS|statf_ridden]] flag set, but its [[ACTARG1]] property isn't set to the [[UID]] of an item whose [[TYPE]] property is set to [[TYPE|t_figurine]] or [[TYPE|t_eq_horse]]. || |
|- | |- | ||
| − | | 1105 || Ridden NPC with a mislinked mount item || An NPC has the [[FLAGS|statf_ridden]] flag set, but the | + | | 1105 || Ridden NPC with a mislinked mount item || An NPC has the [[FLAGS|statf_ridden]] flag set, but its [[ACTARG1]] property isn't set to the [[UID]] of an item whose [[MORE2]] property matches the NPC's [[UID]]. || |
|- | |- | ||
| 1106 || Disconnected NPC neither dead nor ridden || An NPC has been disconnected from the world, but does not have either one of the [[FLAGS|statf_ridden]] or [[FLAGS|statf_dead]] flags set. || | | 1106 || Disconnected NPC neither dead nor ridden || An NPC has been disconnected from the world, but does not have either one of the [[FLAGS|statf_ridden]] or [[FLAGS|statf_dead]] flags set. || | ||
| Line 137: | Line 136: | ||
| − | '''Note''': ''Garbage collection codes marked with * generally indicate a serious error within an object's internal state. If you are experiencing and are able to reliably reproduce any such errors then please report the details to the [http://tracker.sphere.torfo.org/bugs/main_page.php bug tracker].'' | + | '''Note''': ''Garbage collection codes marked with * generally indicate a serious error within an object's internal state and should not normally be seen. If you are experiencing and are able to reliably reproduce any such errors then please report the details to the [http://tracker.sphere.torfo.org/bugs/main_page.php bug tracker].'' |
Latest revision as of 18:04, 1 July 2023
Missing languages
Contents
Exit Codes
When Sphere closes, an 'exit code' will normally be shown in the console to describe why it is being shut down. In general, an exit code less than 0 is considered to be an error code, and values above 0 are normal shutdown codes. In most cases, a more descriptive error will be shown in the console and/or log file to help better diagnose the reason behind error codes.
The following table lists all of the current codes and their meanings.
| Code | Description |
| -10 | Unexpected error occurred |
| -9 | Failed to bind server port |
| -8 | Failed to load world save(s) |
| -3 | Failed to load server settings (script, ini, mul files) or did not write AGREE=1 in the sphere.ini |
| -1 | Shutdown via commandline (/?, /T and /Q switches) |
| 1 | X in console or SIGHUP signal, terminal closed (Linux Only) |
| 2 | SHUTDOWN command |
| 4 | Service shutdown (Windows Only) |
| 5 | Console window closed (Windows Only) |
| 6 | SIGABRT signal, process aborted (Linux Only) |
Garbage Collection
The purpose of garbage collection is to validate all of the server objects and free up unused UIDs. Garbage collection is initiated:
- After the world save is loaded at startup.
- Before a world save begins, if the FORCEGARBAGECOLLECT setting is enabled in Sphere.ini.
- After the IMPORT or RESTORE functions have been used on the server object.
- When the 'G' command is entered via the Sphere console
- When the GARBAGE function is used on the server object.
When garbage collection encounters a problem with an object it may attempt to automatically correct the error, otherwise the object will be removed. When an object is removed by garbage collection there will normally be an error shown in the console describing the item that was removed along with the reason. The following table lists all of the garbage collection codes along with their description:
| Code | Message | Description | |
| 1102 | Disconnected charr not acting as such | A character has been marked disconnected from the world, but it is not listed in the sector's disconnected character's list. | * |
| 1103 | Ridden NPC not acting as such | An NPC has the statf_ridden flag set, but does not have its ACTION property set to 111. | |
| 1104 | Ridden NPC without a mount item | An NPC has the statf_ridden flag set, but its ACTARG1 property isn't set to the UID of an item whose TYPE property is set to t_figurine or t_eq_horse. | |
| 1105 | Ridden NPC with a mislinked mount item | An NPC has the statf_ridden flag set, but its ACTARG1 property isn't set to the UID of an item whose MORE2 property matches the NPC's UID. | |
| 1106 | Disconnected NPC neither dead nor ridden | An NPC has been disconnected from the world, but does not have either one of the statf_ridden or statf_dead flags set. | |
| 1107 | In game char that is neither a player nor an NPC | A character is not a player or an NPC. | * |
| 1108 | Char not on a valid position | A character's position is outside of the map boundaries. | |
| 1203 | Ridden NPC not acting as such | Same as 1103. | |
| 1204 | Ridden NPC without a mount item | Same as 1104. | |
| 1205 | In game char that is neither a player nor an NPC | Same as 1107. | |
| 2102 | Item without ITEMDEF | An item does not have an ITEMDEF section. | * |
| 2103 | Item ITEMDEF with ID = 0 | An item's ITEMDEF has an ID of zero. | * |
| 2104 | Disconnected item | An item has been marked as disconnected from the world. | * |
| 2105 | Item not on a valid position | An item is not in a container and its position is outside of the map boundaries. | |
| 2106 | Item flagged as being in a container but it isn't | An item is flagged as not being top level, but it does not have a container. | |
| 2202 | Item flagged as equipped but it isn't | An item is flagged as being equipped, but its parent is not a character. | |
| 2205 | Mislinked item | An item's LINK property matches its UID, or has been set to a UID that doesn't exist. | |
| 2206 | Gm Robe / Deathshroud not on a char | A GM robe or death shroud (ID of 0204E or 0204F) is not equipped to a character. | |
| 2207 | Deathshroud not on a dead char | A death shroud (ID of 0204F) is equipped to a character without the statf_dead flag set. | |
| 2208 | Gm Robe on a char without privilege | A GM robe (ID of 0204E) is equipped to a character whose PLEVEL is less than 2. | |
| 2220 | Trade window memory not equipped in the correct layer | A t_eq_trade window item type is not equipped, has its LAYER property set to something other than layer_none, or is equipped to an NPC. | |
| 2221 | Client linger memory not equipped in the correct layer | A t_eq_client_linger item type is not equipped, has its LAYER property set to something other than layer_flag_clientlinger, or is equipped to an NPC. | |
| 2222 | Memory not equipped / not in the memory layer / without color | A memory item (ID of 02007) is not equipped, or a non-memory item has had its TYPE set to t_eq_memory_obj after creation. | |
| 2226 | Mount memory not equipped in the correct layer | A t_eq_horse item type is not equipped, or has its LAYER property set to something other than layer_horse. | |
| 2227 | Hair/Beard item not equipped / not in a corpse / not in a vendor box | A t_hair or t_beard item type that isn't equipped, is either not in a container or its container has an ID other than 02006 or 02AF8. | |
| 2228 | Hair/Beard item not equipped / not in a corpse / not in a vendor box | A t_hair or t_beard item is equipped, but has its LAYER property set to something other than layer_hair or layer_beard. | |
| 2229 | Game piece not in a game board | A t_game_piece item has been found outside of a container. | |
| 2230 | Item equipped in the trade window layer but it isn't a trade window | An equipped item has been found with its LAYER property set to layer_none, but its type is not t_eq_trade_window. | |
| 2231 | Item equipped in the memory layer but it isn't a memory | An equipped item has been found with its LAYER property set to layer_special, but its type is not t_eq_memory_obj or t_eq_script. | |
| 2233 | Item equipped in the mount memory layer but it isn't a mount memory | An equipped item has been found with its LAYER property set to layer_horse, but its type is not t_eq_horse. | |
| 2234 | Item equipped in the client linger layer but it isn't a client linger memory | An equipped item has been found with its LAYER property set to layer_flag_clientlinger, but its type is not t_eq_client_linger. | |
| 2235 | Item equipped in the murder memory layer but it isn't a murder memory | An equipped item has been found with its LAYER property set to layer_flag_murders, but the character is an NPC or the player has its KILLS property set to 0. | |
| 2236 | Item flagged as decay but without timer set | A top-level item has the attr_decay flag set, but its TIMER property has not been set. | |
| 3101 | Object is totaly lost, no parent exists | An object has no parent. | * |
| 3102 | Object was deleted or UID is incorrect | An object does not have a valid UID. | * |
| 3201 | Object not correctly loaded by server (UID conflict) | More than one object has the same UID value. | * |
| 4222 | Memory not equipped / not in the memory layer / without color | A memory item is not flagged as equipped, has its LAYER property set to something other than layer_special, or has its COLOR property set to 0. | |
| 4223 | Memory not on a char | A memory item is flagged as equipped, but it's parent is not a character. | |
| 4224 | Stone/Guild memory mislinked | A memory item's COLOR property has one of the memory_guild or memory_town flags set, but the LINK property is not set to the UID of a guild or town stone. | |
| 4225 | Stone/Guild memory linked to the wrong stone | A memory item's COLOR property has one of the memory_guild or memory_town flags set, but the character the memory is equipped to is not a member of the guild or town. | |
| 7101 | Object's UID does not match up with server's UID table. | An object does not have the expected UID value. | * |
| 7102 | Object does not exist. | An object does not exist. | * |
| FFFF | Bad memory allocation | An exception was thrown whilst checking the object's validity. | * |
Note: Garbage collection codes marked with * generally indicate a serious error within an object's internal state and should not normally be seen. If you are experiencing and are able to reliably reproduce any such errors then please report the details to the bug tracker.
