Error Codes - Revision history

Soulless: /* Exit Codes */

2023-07-01T17:04:44Z

‎Exit Codes

Soulless: /* Exit Codes */

2023-07-01T17:04:24Z

‎Exit Codes

Soulless: /* Exit Codes */

2023-07-01T17:04:08Z

‎Exit Codes

MrSugarCube: Changed description of garbage collection codes 1103 and 1104 to indicate how the NPC is linked to its mount item

2011-05-02T02:08:47Z

Changed description of garbage collection codes 1103 and 1104 to indicate how the NPC is linked to its mount item

MrSugarCube at 01:27, 2 May 2011

2011-05-02T01:27:08Z

MrSugarCube: Tried to improve the garbage collection table with more accurate error descriptions, and the actual error message to help with searching

2011-05-02T01:22:25Z

Tried to improve the garbage collection table with more accurate error descriptions, and the actual error message to help with searching

Show changes

Sirius: Added languagemenue

2010-11-26T20:53:56Z

Added languagemenue

MrSugarCube: Created page with 'FORCETOC ==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 i...'

2009-06-25T21:10:29Z

Created page with '__FORCETOC__ ==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 i...'

New page

__FORCETOC__
==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.

{| border="1" cellpadding="3"
| '''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)
|-
| -1 || Shutdown via commandline (/?, /T and /Q switches)
|-
| 1 || X in console ''or'' <br />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|server]] object.
* When the 'G' command is entered via the Sphere console
* When the [[GARBAGE]] function is used on the [[Server|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:

{| border="1" cellpadding="3"
| '''Code''' || '''Description'''
|-
| 1102 || Disconnected character not acting as such.
|-
| 1103 || NPC with STATF_Ridden does not have the correct action set.
|-
| 1104 || Ridden NPC without a mount item.
|-
| 1105 || Ridden NPC with a mount item that is not linked to them.
|-
| 1106 || Disconneced NPC neither dead or ridden.
|-
| 1107 || Ingame character that is neither a player or an NPC.
|-
| 1108 || Character not on a valid position.
|-
| 1203 || NPC with STATF_Ridden does not have the correct action set.
|-
| 1204 || Ridden NPC without a mount item.
|-
| 1205 || Ingame character that is neither a player or an NPC.
|-
| 2102 || Item without an ITEMDEF.
|-
| 2103 || Item ITEMDEF with an ID of 0.
|-
| 2104 || Disconnected item.
|-
| 2105 || Item not on a valid position.
|-
| 2106 || Item flagged as being in a container but it isn't.
|-
| 2202 || Item flagged as equipped but it isn't.
|-
| 2205 || Item's LINK property is set to itself or a UID that doesn't exist.
|-
| 2206 || GM Robe or Deathshroud not on a character.
|-
| 2207 || Deathshroud not on a dead character.
|-
| 2208 || GM Robe on a character without privileges.
|-
| 2220 || Trade window memory not equipped in the correct layer, or not equipped to a player.
|-
| 2221 || Client linger memory not equipped in the correct layer, or not equipped to a player.
|-
| 2222 || Memory not equipped or is not a real memory.
|-
| 2226 || Mount memory not equipped in the correct layer.
|-
| 2227 || Hair or beard item is not equipped, not in a corpse, and not in a vendor box.
|-
| 2228 || Hair or beard item is equipped, but not in the correct layer.
|-
| 2229 || Game piece not in a container.
|-
| 2230 || Item equipped in layer_none but it isn't a trade window.
|-
| 2231 || Item equipped in layer_special but it isn't a memory or script type.
|-
| 2233 || Item equipped in layer_horse but it isn't a mount memory.
|-
| 2234 || Item equipped in the client linger layer but it isn't a client linger memory.
|-
| 2235 || Item equipped in the murder memory layer but it isn't a murder memory.
|-
| 2236 || Item flagged as decay but without timer set.
|-
| 3101 || Object is totally lost, no parent exists.
|-
| 3102 || Object was deleted or UID is incorrect.
|-
| 3201 || More than one object with the same UID.
|-
| 4222 || Memory item is not equipped, not in the memory layer, or without colour
|-
| 4223 || Memory not on a character.
|-
| 4224 || Guild/town memory does not link to the character's town/guild.
|-
| 4225 || Guild/town memory linked to a stone, but the character is not a member.
|-
| 7101 || Object's UID does not match up with server's UID table.
|-
| 7102 || Object does not exist.
|-
| FFFF || Bad memory allocation (unknown error occured).
|}

@@ Line 53: / Line 53: @@
 | 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 rider does not have a mount item. ||
+| 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 mount item's [[MORE2]] property does not match the NPC's [[UID]]. ||
+| 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. ||

← Older revision		Revision as of 01:27, 2 May 2011
Line 137:		Line 137:


−	'''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].''

← Older revision		Revision as of 20:53, 26 November 2010
Line 1:		Line 1:
		+	{{Languages\|Error_Codes}}
		+
	__FORCETOC__		__FORCETOC__
	==Exit Codes==		==Exit Codes==

@@ Line 18: / Line 18: @@
 | -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
+| -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)

Error Codes - Revision history

Soulless: /* Exit Codes */

Soulless: /* Exit Codes */

Soulless: /* Exit Codes */

MrSugarCube: Changed description of garbage collection codes 1103 and 1104 to indicate how the NPC is linked to its mount item

MrSugarCube at 01:27, 2 May 2011

MrSugarCube: Tried to improve the garbage collection table with more accurate error descriptions, and the actual error message to help with searching

Sirius: Added languagemenue

MrSugarCube: Created page with '__FORCETOC__ ==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 i...'

MrSugarCube: Created page with 'FORCETOC ==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 i...'