client.c File Reference

Client mode option parsing and help text. More...

Go to the source code of this file.

Functions
asciichat_error_t	parse_client_options (int argc, char **argv, options_t *opts)
	Parse client-specific command-line options.
void	usage_client (FILE *desc)
	Print client mode usage/help text.

Detailed Description

Client mode option parsing and help text.

Client-specific command-line argument parsing with support for:

• Server connection (positional address[:port])
• Webcam configuration
• Audio capture/playback
• Display settings
• Cryptographic authentication
• Network compression
• Reconnection behavior

Definition in file lib/options/client.c.

Function Documentation

parse_client_options()

asciichat_error_t parse_client_options	(	int	argc,
		char **	argv,
		options_t *	opts
	)

Parse client-specific command-line options.

Parses all client mode options including:

• Positional argument: [address][:port] for server connection
• Client-specific flags (webcam, audio, display, network options)
• Shared options (palette, encryption, output options)

Parsing Logic:

1. getopt_long() loop processes all flags
2. After loop, parse positional argument for server address
3. Validate port conflicts (positional vs –port flag)
4. Set default values for unspecified options

Error Handling:

• Invalid options: Prints error with typo suggestions
• Missing required arguments: Prints usage hint
• Port conflicts: Errors if both positional port and –port specified
• Returns ERROR_INVALID_PARAM on any validation failure

Parameters

argc	Argument count from main()
argv	Argument vector from main()

Returns

ASCIICHAT_OK on success, ERROR_INVALID_PARAM on parse error

Note

Modifies global opt_* variables (opt_address, opt_port, opt_width, etc.)

Prints error messages to stderr on failure

Prints help text and exits if –help flag present

Positional Argument Parsing: After getopt_long() completes, optind points to first non-option argument. Format: [address][:port]

• IPv4: 192.168.1.100, 192.168.1.100:8080
• IPv6: [::1], [2001:db8::1]:8080
• Hostname: localhost, example.com:27224

Port conflicts:

// ❌ WRONG - conflicting port specifications
./ascii-chat client localhost:8080 --port 9090
// Error: Cannot specify port in both positional argument and --port flag
 
// ✅ CORRECT - specify port only once
./ascii-chat client localhost:8080
./ascii-chat client localhost --port 8080

Example usage:

int main(int argc, char **argv) {
    asciichat_error_t err = options_init(argc, argv, MODE_CLIENT);
    if (err != ASCIICHAT_OK) {
        return 1;  // Error already printed
    }
 
    // Option globals are now populated:
    log_info("Connecting to %s:%s", opt_address, opt_port);
    log_info("Terminal size: %dx%d", opt_width, opt_height);
    log_info("Webcam: %d, Audio: %s", opt_webcam_index,
             opt_audio_enabled ? "enabled" : "disabled");
 
    // ... proceed with client initialization
}

See also

parse_server_options()

parse_mirror_options()

options_init()

Definition at line 50 of file lib/options/client.c.

                                                                               {
  const options_config_t *config = options_preset_client("ascii-chat client", "connect to an ascii-chat server");
  int remaining_argc;
  char **remaining_argv;
 
  // Apply defaults from preset before parsing command-line args
  asciichat_error_t defaults_result = options_config_set_defaults(config, opts);
  if (defaults_result != ASCIICHAT_OK) {
    options_config_destroy(config);
    return defaults_result;
  }
 
  asciichat_error_t result = options_config_parse(config, argc, argv, opts, &remaining_argc, &remaining_argv);
  if (result != ASCIICHAT_OK) {
    options_config_destroy(config);
    return result;
  }
 
  // Check for unexpected remaining arguments
  if (remaining_argc > 0) {
    (void)fprintf(stderr, "Error: Unexpected arguments after options:\n");
    for (int i = 0; i < remaining_argc; i++) {
      (void)fprintf(stderr, "  %s\n", remaining_argv[i]);
    }
    options_config_destroy(config);
    return option_error_invalid();
  }
 
  options_config_destroy(config);
  return ASCIICHAT_OK;
}

References ASCIICHAT_OK, options_config_destroy(), options_config_parse(), options_config_set_defaults(), and options_preset_client().

Referenced by options_init().