Lostarch at 20:34, 3 March 2026

2026-03-03T20:34:20Z

Lostarch: Created page with "{{Hotline_Nav}} == Error Codes == Error codes in the Hotline protocol are 4-byte (32-bit) integers. A value of '''0''' always indicates "No Error" (Success). === General Errors === These are commonly returned in the Transaction Header during basic operations. {| class="wikitable" ! Code (Dec) !! Constant !! Description |- | 0 || err_None || Success / No Error. |- | -1 || err_Generic || A non-specific error occurred. |- | 1 ||
2026-03-03T20:33:48Z

Created page with "{{Hotline_Nav}} == Error Codes == Error codes in the Hotline protocol are 4-byte (32-bit) integers. A value of '''0''' always indicates "No Error" (Success). === General Errors === These are commonly returned in the Transaction Header during basic operations. {| class="wikitable" ! Code (Dec) !! Constant !! Description |- | 0 || <nowiki>err_None</nowiki> || Success / No Error. |- | -1 || <nowiki>err_Generic</nowiki> || A non-specific error occurred. |- | 1 || <nowiki..."

New page
{{Hotline_Nav}}
== Error Codes ==

Error codes in the Hotline protocol are 4-byte (32-bit) integers. A value of '''0''' always indicates "No Error" (Success).

=== General Errors ===
These are commonly returned in the Transaction Header during basic operations.

{| class="wikitable"
! Code (Dec) !! Constant !! Description
|-
| 0 || <nowiki>err_None</nowiki> || Success / No Error.
|-
| -1 || <nowiki>err_Generic</nowiki> || A non-specific error occurred.
|-
| 1 || <nowiki>err_NotConnected</nowiki> || The operation requires a connection that is no longer active.
|-
| 2 || <nowiki>err_Socket</nowiki> || A low-level TCP/IP socket error occurred.
|}

=== Login & Access Errors ===
These typically occur during Transaction 107 (Login) or when trying to perform restricted actions.

{| class="wikitable"
! Code (Dec) !! Constant !! Description
|-
| 1000 || <nowiki>err_LoginFailed</nowiki> || Invalid username or password.
|-
| 1001 || <nowiki>err_AlreadyLoggedIn</nowiki> || The user is already connected to the server.
|-
| 1002 || <nowiki>err_AccessDenied</nowiki> || The user does not have the required [[AccessPriviledges|Access Bit]] for this action.
|-
| 1003 || <nowiki>err_UserBanned</nowiki> || The user's IP or account has been banned from the server.
|-
| 1004 || <nowiki>err_ServerFull</nowiki> || The server has reached its maximum user limit.
|}

=== File & Transfer Errors ===
Returned during file system transactions (200-213).

{| class="wikitable"
! Code (Dec) !! Constant !! Description
|-
| 2000 || <nowiki>err_FileNotFound</nowiki> || The requested file or folder path does not exist.
|-
| 2001 || <nowiki>err_FileInUse</nowiki> || The file is currently being accessed by another process.
|-
| 2002 || <nowiki>err_DiskFull</nowiki> || The server disk is full; upload cannot complete.
|-
| 2003 || <nowiki>err_TransferFailed</nowiki> || The binary transfer was interrupted or failed checksum.
|}

=== News & Messaging Errors ===
{| class="wikitable"
! Code (Dec) !! Constant !! Description
|-
| 3000 || <nowiki>err_NewsFull</nowiki> || The news database cannot accept more posts.
|-
| 3001 || <nowiki>err_MsgRefused</nowiki> || The recipient has the "Refuse Private Messages" flag set.
|}

== Field ID 100 (Error Text) ==
Sometimes, a server will return a generic error code in the header but include '''Field 104 (Error Text)''' in the parameter list. This field contains a human-readable string explaining the error in more detail (e.g., "Maintenance in progress, please try again in 10 minutes").

[[Category:Hotline]]