Error and Exit Codes

Error codes and status values for ascii-chat. More...

Files
file	error_codes.h
	Error and exit codes - unified status values (0-255).

Enumerations
enum	asciichat_error_t {   ASCIICHAT_OK = 0 , ERROR_GENERAL = 1 , ERROR_USAGE = 2 , ERROR_MEMORY = 3 ,   ERROR_CONFIG = 4 , ERROR_CRYPTO_INIT = 5 , ERROR_LOGGING_INIT = 6 , ERROR_PLATFORM_INIT = 7 ,   ERROR_INIT = 8 , ERROR_WEBCAM = 20 , ERROR_WEBCAM_IN_USE = 21 , ERROR_WEBCAM_PERMISSION = 22 ,   ERROR_AUDIO = 23 , ERROR_AUDIO_IN_USE = 24 , ERROR_TERMINAL = 25 , ERROR_MEDIA_INIT = 26 ,   ERROR_MEDIA_OPEN = 27 , ERROR_MEDIA_DECODE = 28 , ERROR_MEDIA_SEEK = 29 , ERROR_NOT_SUPPORTED = 30 ,   ERROR_NETWORK = 40 , ERROR_NETWORK_BIND = 41 , ERROR_NETWORK_CONNECT = 42 , ERROR_NETWORK_TIMEOUT = 43 ,   ERROR_NETWORK_PROTOCOL = 44 , ERROR_NETWORK_SIZE = 45 , ERROR_RATE_LIMITED = 46 , ERROR_SESSION_NOT_FOUND = 47 ,   ERROR_SESSION_FULL = 48 , ERROR_INVALID_PASSWORD = 49 , ERROR_INVALID_SIGNATURE = 50 , ERROR_ACDS_STRING_TAKEN = 51 ,   ERROR_ACDS_STRING_INVALID = 52 , ERROR_INTERNAL = 53 , ERROR_UNKNOWN_PACKET = 54 , ERROR_NETWORK_INCOMPLETE = 55 ,   ERROR_CRYPTO = 60 , ERROR_CRYPTO_KEY = 61 , ERROR_CRYPTO_AUTH = 62 , ERROR_CRYPTO_HANDSHAKE = 63 ,   ERROR_CRYPTO_VERIFICATION = 64 , ERROR_THREAD = 80 , ERROR_BUFFER = 81 , ERROR_BUFFER_FULL = 82 ,   ERROR_BUFFER_OVERFLOW = 83 , ERROR_DISPLAY = 84 , ERROR_INVALID_STATE = 85 , ERROR_INVALID_PARAM = 86 ,   ERROR_INVALID_FRAME = 87 , ERROR_RESOURCE_EXHAUSTED = 88 , ERROR_FORMAT = 89 , ERROR_STRING = 90 ,   ERROR_PROMPT_TIMEOUT = 92 , ERROR_NOT_FOUND = 91 , ERROR_SIGNAL_INTERRUPT = 100 , ERROR_SIGNAL_CRASH = 101 ,   ERROR_ASSERTION_FAILED = 102 , ERROR_COMPRESSION = 103 , ERROR_DECOMPRESSION = 104 , ERROR_FILE_OPERATION = 105 ,   ERROR_FILE_NOT_FOUND = 106 , ERROR_PROCESS_FAILED = 110 , ERROR_YOUTUBE_INVALID_URL = 111 , ERROR_YOUTUBE_EXTRACT_FAILED = 112 ,   ERROR_YOUTUBE_UNPLAYABLE = 113 , ERROR_YOUTUBE_NETWORK = 114 , ERROR_YOUTUBE_NOT_SUPPORTED = 115 }
	Error and exit codes - unified status values (0-255). More...

Detailed Description

Error codes and status values for ascii-chat.

Single enum for both function return values and process exit codes. Following Unix conventions: 0 = success, 1 = general error, 2 = usage error.

Error codes are organized into ranges:

• 0: Success
• 1-2: Standard errors (general, usage)
• 3-19: Initialization failures
• 20-39: Hardware/Device errors
• 40-59: Network errors
• 60-79: Security/Crypto errors
• 80-99: Runtime errors
• 100-127: Signal/Crash handlers
• 128-255: Reserved (128+N = terminated by signal N on Unix)

Enumeration Type Documentation

asciichat_error_t

enum asciichat_error_t

#include <include/ascii-chat/common/error_codes.h>

Error and exit codes - unified status values (0-255).

Single enum for both function return values and process exit codes. Following Unix conventions: 0 = success, 1 = general error, 2 = usage error.

Enumerator
ASCIICHAT_OK	Success
ERROR_GENERAL	Unspecified error
ERROR_USAGE	Invalid command line arguments or options
ERROR_MEMORY	Memory allocation failed (OOM)
ERROR_CONFIG	Configuration file or settings error
ERROR_CRYPTO_INIT	Cryptographic initialization failed
ERROR_LOGGING_INIT	Logging system initialization failed
ERROR_PLATFORM_INIT	Platform-specific initialization failed
ERROR_INIT	General initialization failed
ERROR_WEBCAM	Webcam initialization or capture failed
ERROR_WEBCAM_IN_USE	Webcam is in use by another application
ERROR_WEBCAM_PERMISSION	Webcam permission denied
ERROR_AUDIO	Audio device initialization or I/O failed
ERROR_AUDIO_IN_USE	Audio device is in use
ERROR_TERMINAL	Terminal initialization or capability detection failed
ERROR_MEDIA_INIT	Media source initialization failed
ERROR_MEDIA_OPEN	Failed to open media file or stream
ERROR_MEDIA_DECODE	Media decoding failed
ERROR_MEDIA_SEEK	Media seek operation failed
ERROR_NOT_SUPPORTED	Operation not supported
ERROR_NETWORK	General network error
ERROR_NETWORK_BIND	Cannot bind to port (server)
ERROR_NETWORK_CONNECT	Cannot connect to server (client)
ERROR_NETWORK_TIMEOUT	Network operation timed out
ERROR_NETWORK_PROTOCOL	Protocol violation or incompatible version
ERROR_NETWORK_SIZE	Network packet size error
ERROR_RATE_LIMITED	Rate limit exceeded
ERROR_SESSION_NOT_FOUND	Session not found or expired
ERROR_SESSION_FULL	Session has reached max participants
ERROR_INVALID_PASSWORD	Incorrect password
ERROR_INVALID_SIGNATURE	Invalid cryptographic signature
ERROR_ACDS_STRING_TAKEN	Requested session string already in use (ACDS)
ERROR_ACDS_STRING_INVALID	Invalid session string format (ACDS)
ERROR_INTERNAL	Internal server error
ERROR_UNKNOWN_PACKET	Unknown packet type received
ERROR_NETWORK_INCOMPLETE	Incomplete buffered message; retry within the receive deadline
ERROR_CRYPTO	Cryptographic operation failed
ERROR_CRYPTO_KEY	Key loading, parsing, or generation failed
ERROR_CRYPTO_AUTH	Authentication failed
ERROR_CRYPTO_HANDSHAKE	Cryptographic handshake failed
ERROR_CRYPTO_VERIFICATION	Signature or key verification failed
ERROR_THREAD	Thread creation or management failed
ERROR_BUFFER	Buffer allocation or overflow
ERROR_BUFFER_FULL	Buffer full
ERROR_BUFFER_OVERFLOW	Buffer overflow
ERROR_DISPLAY	Display rendering or output error
ERROR_INVALID_STATE	Invalid program state
ERROR_INVALID_PARAM	Invalid parameter
ERROR_INVALID_FRAME	Invalid frame data
ERROR_RESOURCE_EXHAUSTED	System resources exhausted
ERROR_FORMAT	String formatting operation failed
ERROR_STRING	String manipulation operation failed
ERROR_PROMPT_TIMEOUT	Interactive prompt deadline expired
ERROR_NOT_FOUND	Resource not found in registry or lookup
ERROR_SIGNAL_INTERRUPT	Interrupted by signal (SIGINT, SIGTERM)
ERROR_SIGNAL_CRASH	Fatal signal (SIGSEGV, SIGABRT, etc.)
ERROR_ASSERTION_FAILED	Assertion or invariant violation
ERROR_COMPRESSION	Compression operation failed
ERROR_DECOMPRESSION	Decompression operation failed
ERROR_FILE_OPERATION	File or directory operation failed
ERROR_FILE_NOT_FOUND	File or directory not found
ERROR_PROCESS_FAILED	Process execution or termination failed
ERROR_YOUTUBE_INVALID_URL	Invalid YouTube URL format
ERROR_YOUTUBE_EXTRACT_FAILED	YouTube URL extraction/parsing failed
ERROR_YOUTUBE_UNPLAYABLE	Video cannot be played (age-restricted, geo-blocked, etc.)
ERROR_YOUTUBE_NETWORK	Network error fetching YouTube watch page
ERROR_YOUTUBE_NOT_SUPPORTED	YouTube support not compiled in (requires libytdl)

Definition at line 44 of file error_codes.h.

             {
  /* Standard codes (0-2) - Unix conventions */
  ASCIICHAT_OK = 0,  
  ERROR_GENERAL = 1, 
  ERROR_USAGE = 2,   
 
  /* Initialization failures (3-19) */
  ERROR_MEMORY = 3,        
  ERROR_CONFIG = 4,        
  ERROR_CRYPTO_INIT = 5,   
  ERROR_LOGGING_INIT = 6,  
  ERROR_PLATFORM_INIT = 7, 
  ERROR_INIT = 8,          
 
  /* Hardware/Device errors (20-39) */
  ERROR_WEBCAM = 20,            
  ERROR_WEBCAM_IN_USE = 21,     
  ERROR_WEBCAM_PERMISSION = 22, 
  ERROR_AUDIO = 23,             
  ERROR_AUDIO_IN_USE = 24,      
  ERROR_TERMINAL = 25,          
  ERROR_MEDIA_INIT = 26,        
  ERROR_MEDIA_OPEN = 27,        
  ERROR_MEDIA_DECODE = 28,      
  ERROR_MEDIA_SEEK = 29,        
  ERROR_NOT_SUPPORTED = 30,     
 
  /* Network errors (40-59) */
  ERROR_NETWORK = 40,          
  ERROR_NETWORK_BIND = 41,     
  ERROR_NETWORK_CONNECT = 42,  
  ERROR_NETWORK_TIMEOUT = 43,  
  ERROR_NETWORK_PROTOCOL = 44, 
  ERROR_NETWORK_SIZE = 45,     
 
  /* Session and protocol errors (46-55) */
  ERROR_RATE_LIMITED = 46,        
  ERROR_SESSION_NOT_FOUND = 47,   
  ERROR_SESSION_FULL = 48,        
  ERROR_INVALID_PASSWORD = 49,    
  ERROR_INVALID_SIGNATURE = 50,   
  ERROR_ACDS_STRING_TAKEN = 51,   
  ERROR_ACDS_STRING_INVALID = 52, 
  ERROR_INTERNAL = 53,            
  ERROR_UNKNOWN_PACKET = 54,      
 
  ERROR_NETWORK_INCOMPLETE = 55, 
 
  /* Security/Crypto errors (60-79) */
  ERROR_CRYPTO = 60,              
  ERROR_CRYPTO_KEY = 61,          
  ERROR_CRYPTO_AUTH = 62,         
  ERROR_CRYPTO_HANDSHAKE = 63,    
  ERROR_CRYPTO_VERIFICATION = 64, 
 
  /* Runtime errors (80-99) */
  ERROR_THREAD = 80,             
  ERROR_BUFFER = 81,             
  ERROR_BUFFER_FULL = 82,        
  ERROR_BUFFER_OVERFLOW = 83,    
  ERROR_DISPLAY = 84,            
  ERROR_INVALID_STATE = 85,      
  ERROR_INVALID_PARAM = 86,      
  ERROR_INVALID_FRAME = 87,      
  ERROR_RESOURCE_EXHAUSTED = 88, 
  ERROR_FORMAT = 89,             
  ERROR_STRING = 90,             
  ERROR_PROMPT_TIMEOUT = 92,     
  ERROR_NOT_FOUND = 91,          
 
  /* Signal/Crash handlers (100-127) */
  ERROR_SIGNAL_INTERRUPT = 100, 
  ERROR_SIGNAL_CRASH = 101,     
  ERROR_ASSERTION_FAILED = 102, 
 
  /* Compression errors (103-104) */
  ERROR_COMPRESSION = 103,   
  ERROR_DECOMPRESSION = 104, 
 
  /* File system errors (105-109) */
  ERROR_FILE_OPERATION = 105, 
  ERROR_FILE_NOT_FOUND = 106, 
 
  /* Process errors (110-119) */
  ERROR_PROCESS_FAILED = 110, 
 
  /* YouTube/URL streaming errors (111-116) */
  ERROR_YOUTUBE_INVALID_URL = 111,    
  ERROR_YOUTUBE_EXTRACT_FAILED = 112, 
  ERROR_YOUTUBE_UNPLAYABLE = 113,     
  ERROR_YOUTUBE_NETWORK = 114,        
  ERROR_YOUTUBE_NOT_SUPPORTED = 115,  
 
  /* Reserved (128-255) - Should not be used */
  /* 128+N typically means "terminated by signal N" on Unix systems */
 
} asciichat_error_t;