log.c File Reference

Logging utility stubs for WASM. More...

Go to the source code of this file.

Typedefs
typedef struct session_log_buffer	session_log_buffer_t

Functions
asciichat_error_t	log_mmap_init_simple (const char *log_path, size_t max_size)
	Initialize mmap logging with simple parameters.
bool	log_mmap_is_active (void)
	Check if mmap logging is active.
void	log_mmap_write (int level, const char *file, int line, const char *func, const char *fmt,...)
	Write a log entry directly to the mmap'd file (lock-free)
bool	log_mmap_get_usage (size_t *used, size_t *capacity)
	Get current mmap log usage.
void	log_mmap_rotate (void)
	Rotate the mmap log (tail-keeping rotation)
void	server_status_log_append (const char *message)
void	log_json_write (int fd, int level, uint64_t time_ns, const char *file, int line, const char *func, const char *json_msg)
int	terminal_choose_log_fd (log_level_t level)
	Choose output file descriptor for logging based on level and interactivity.
session_log_buffer_t *	session_log_buffer_create (void)
	Create a new session log buffer instance.
void	session_log_buffer_destroy (session_log_buffer_t *buf)
	Cleanup session log buffer instance.
void	session_log_buffer_clear (session_log_buffer_t *buf)
	Clear all log entries from buffer.
void	session_log_buffer_append (session_log_buffer_t *buf, const char *message)
	Append a log message to the buffer.
size_t	session_log_buffer_get_recent (session_log_buffer_t *buf, session_log_entry_t *out_entries, size_t max_count)
	Get recent log entries from buffer.
void	log_mmap_destroy (void)
	Shutdown mmap logging.

Detailed Description

Logging utility stubs for WASM.

Definition in file platform/wasm/stubs/log.c.

Typedef Documentation

session_log_buffer_t

typedef struct session_log_buffer session_log_buffer_t

Definition at line 77 of file platform/wasm/stubs/log.c.

Function Documentation

log_json_write()

void log_json_write	(	int	fd,
		int	level,
		uint64_t	time_ns,
		const char *	file,
		int	line,
		const char *	func,
		const char *	json_msg
	)

Definition at line 51 of file platform/wasm/stubs/log.c.

                                          {
  (void)fd;
  (void)level;
  (void)time_ns;
  (void)file;
  (void)line;
  (void)func;
  (void)json_msg;
  // No-op - JSON logging in WASM uses console output instead
}

log_mmap_destroy()

void log_mmap_destroy

(

void

)

Shutdown mmap logging.

Syncs and unmaps the log file.

Definition at line 106 of file platform/wasm/stubs/log.c.

                            {
  // No-op - mmap logging not used in WASM
}

log_mmap_get_usage()

bool log_mmap_get_usage	(	size_t *	used,
		size_t *	capacity
	)

Get current mmap log usage.

Parameters

[out]	used	Current bytes used in the log
[out]	capacity	Total capacity of the log

Returns

true if mmap is active and values are valid

Definition at line 32 of file platform/wasm/stubs/log.c.

                                                        {
  if (used)
    *used = 0;
  if (capacity)
    *capacity = 0;
  return false;
}

log_mmap_init_simple()

asciichat_error_t log_mmap_init_simple	(	const char *	log_path,
		size_t	max_size
	)

Initialize mmap logging with simple parameters.

Convenience wrapper around log_mmap_init().

Parameters

log_path	Path to log file
max_size	Maximum file size (0 = default 4MB)

Returns

ASCIICHAT_OK on success, error code on failure

Definition at line 13 of file platform/wasm/stubs/log.c.

                                                                              {
  (void)log_path;
  (void)max_size;
  return ASCIICHAT_OK; // No-op - mmap logging not supported in WASM
}

References ASCIICHAT_OK.

log_mmap_is_active()

bool log_mmap_is_active

(

void

)

Check if mmap logging is active.

Returns

true if mmap logging is initialized and active

Definition at line 19 of file platform/wasm/stubs/log.c.

                              {
  return false; // mmap logging not active in WASM
}

log_mmap_rotate()

void log_mmap_rotate

(

void

)

Rotate the mmap log (tail-keeping rotation)

Keeps the most recent log entries (tail) and discards old ones. This is the mmap equivalent of file-based log rotation.

Note

Caller must hold the rotation mutex from logging.c. This is called by maybe_rotate_log() which handles locking.

Definition at line 40 of file platform/wasm/stubs/log.c.

                           {
  // No-op
}

log_mmap_write()

void log_mmap_write	(	int	level,
		const char *	file,
		int	line,
		const char *	func,
		const char *	fmt,
			...
	)

Write a log entry directly to the mmap'd file (lock-free)

Formats the log message and writes it directly as human-readable text. Uses atomic operations only, no mutex.

Parameters

level	Log level
file	Source file (can be NULL)
line	Source line
func	Function name (can be NULL)
fmt	Format string
...	Format arguments

Definition at line 23 of file platform/wasm/stubs/log.c.

                                                                                                   {
  (void)level;
  (void)file;
  (void)line;
  (void)func;
  (void)fmt;
  // No-op - mmap logging not supported in WASM
}

server_status_log_append()

void server_status_log_append

(

const char *

message

)

Definition at line 45 of file platform/wasm/stubs/log.c.

                                                   {
  (void)message;
  // No-op - server status screen not used in WASM mirror mode
}

session_log_buffer_append()

void session_log_buffer_append	(	session_log_buffer_t *	buf,
		const char *	message
	)

Append a log message to the buffer.

Thread-safe. Called from logging system to capture messages. Message is copied into circular buffer (oldest entry overwritten if full).

Parameters

buf	Buffer instance (must not be NULL)
message	Log message text (already formatted with colors)

Definition at line 93 of file platform/wasm/stubs/log.c.

                                                                               {
  (void)buf;
  (void)message;
  // No-op - session log buffer not used in WASM
}

session_log_buffer_clear()

void session_log_buffer_clear

(

session_log_buffer_t *

buf

)

Clear all log entries from buffer.

Thread-safe. Resets buffer to empty state, discarding all captured logs. Useful for clearing initialization logs before screen starts rendering.

Parameters

buf	Buffer instance (must not be NULL)

Definition at line 88 of file platform/wasm/stubs/log.c.

                                                         {
  (void)buf;
  // No-op - session log buffer not used in WASM
}

Referenced by terminal_screen_log_clear().

session_log_buffer_create()

session_log_buffer_t * session_log_buffer_create

(

void

)

Create a new session log buffer instance.

Allocates and initializes a circular buffer for log capture. Caller is responsible for calling session_log_buffer_destroy() when done.

Returns

Pointer to new buffer instance, or NULL on allocation failure

Definition at line 79 of file platform/wasm/stubs/log.c.

                                                      {
  return NULL; // No-op - session log buffer not used in WASM
}

Referenced by terminal_screen_log_init().

session_log_buffer_destroy()

void session_log_buffer_destroy

(

session_log_buffer_t *

buf

)

Cleanup session log buffer instance.

Frees the buffer and all internal resources. Safe to call with NULL.

Parameters

buf	Buffer instance to destroy (can be NULL)

Definition at line 83 of file platform/wasm/stubs/log.c.

                                                           {
  (void)buf;
  // No-op - session log buffer not used in WASM
}

Referenced by terminal_screen_log_destroy().

session_log_buffer_get_recent()

size_t session_log_buffer_get_recent	(	session_log_buffer_t *	buf,
		session_log_entry_t *	out_entries,
		size_t	max_count
	)

Get recent log entries from buffer.

Thread-safe. Copies up to max_count recent entries into out_entries. Entries are returned in chronological order (oldest first).

Parameters

buf	Buffer instance (must not be NULL)
out_entries	Output array to fill with log entries
max_count	Maximum number of entries to return

Returns

Number of entries actually copied (may be less than max_count)

Definition at line 99 of file platform/wasm/stubs/log.c.

                                                                                                                    {
  (void)buf;
  (void)out_entries;
  (void)max_count;
  return 0; // No entries in WASM
}

Referenced by log_search_gather_and_filter_logs(), and terminal_screen_render().

terminal_choose_log_fd()

int terminal_choose_log_fd

(

log_level_t

level

)

Choose output file descriptor for logging based on level and interactivity.

Parameters

level

Log level (determines default routing: WARN+ to stderr, others to stdout)

Returns

STDERR_FILENO or STDOUT_FILENO based on log level and terminal state

Routes logs appropriately:

• When terminal is NOT interactive (piped): ALL logs to stderr
• When force_stderr enabled: ALL logs to stderr
• Otherwise: WARN/ERROR/FATAL to stderr, others to stdout

This consolidates log routing logic used throughout the codebase.

Note

Use: int fd = terminal_choose_log_fd(LOG_INFO);

Common usage: platform_write_all(terminal_choose_log_fd(level), data, len);

Definition at line 64 of file platform/wasm/stubs/log.c.

                                              {
  // Route based on level: INFO and below go to stdout, WARN and above go to stderr
  // This matches the native implementation and allows Emscripten to route to
  // console.log for INFO/DEBUG/DEV and console.error for WARN/ERROR/FATAL
  if (level >= 3) { // LOG_WARN = 3, LOG_ERROR = 4, LOG_FATAL = 5
    return 2;       // STDERR_FILENO
  }
  return 1; // STDOUT_FILENO (LOG_DEV=0, LOG_DEBUG=1, LOG_INFO=2)
}