strings.h File Reference

Session string generation for discovery service. More...

Go to the source code of this file.

Functions
asciichat_error_t	acds_string_generate (char *output, size_t output_size)
	Generate random session string.
bool	acds_string_validate (const char *str)
	Validate session string format.
asciichat_error_t	acds_string_init (void)
	Initialize random number generator for string generation.

Detailed Description

Session string generation for discovery service.

Generates memorable session strings in the format: adjective-noun-noun Example: "swift-river-mountain", "quiet-forest-peak"

This is a minimal inline implementation with embedded wordlists. Future lib/discovery/session_string.c will load from files for larger wordlists.

Definition in file strings.h.

Function Documentation

acds_string_generate()

asciichat_error_t acds_string_generate	(	char *	output,
		size_t	output_size
	)

Generate random session string.

Parameters

output	Output buffer for session string
output_size	Size of output buffer (should be at least 48 bytes)

Returns

ASCIICHAT_OK on success, error code otherwise

Generates strings in format: adjective-noun-noun Example: "swift-river-mountain" (20 characters)

Entropy: ~100 adjectives * 100 nouns * 100 nouns = 1 million combinations (Full wordlist version will have ~10 million combinations)

Definition at line 55 of file strings.c.

                                                                         {
  if (!output || output_size < 48) {
    return SET_ERRNO(ERROR_INVALID_PARAM, "output buffer must be at least 48 bytes");
  }
 
  // Pick random adjective
  uint32_t adj_idx = randombytes_uniform((uint32_t)adjectives_count);
  const char *adj = adjectives[adj_idx];
 
  // Pick two random nouns
  uint32_t noun1_idx = randombytes_uniform((uint32_t)nouns_count);
  uint32_t noun2_idx = randombytes_uniform((uint32_t)nouns_count);
  const char *noun1 = nouns[noun1_idx];
  const char *noun2 = nouns[noun2_idx];
 
  // Format: adjective-noun-noun
  int written = snprintf(output, output_size, "%s-%s-%s", adj, noun1, noun2);
  if (written < 0 || (size_t)written >= output_size) {
    return SET_ERRNO(ERROR_BUFFER_OVERFLOW, "Session string too long for buffer");
  }
 
  log_debug("Generated session string: %s", output);
  return ASCIICHAT_OK;
}

References ASCIICHAT_OK, ERROR_BUFFER_OVERFLOW, ERROR_INVALID_PARAM, log_debug, and SET_ERRNO.

Referenced by session_create().

acds_string_init()

asciichat_error_t acds_string_init

(

void

)

Initialize random number generator for string generation.

Returns

ASCIICHAT_OK on success, error code otherwise

Must be called before acds_string_generate(). Uses libsodium's randombytes for cryptographically secure randomness.

Definition at line 44 of file strings.c.

                                         {
  // libsodium's randombytes is already initialized by sodium_init()
  // which should be called at program startup
  if (sodium_init() < 0) {
    return SET_ERRNO(ERROR_CRYPTO_INIT, "Failed to initialize libsodium");
  }
 
  log_debug("Session string generator initialized (%zu adjectives, %zu nouns)", adjectives_count, nouns_count);
  return ASCIICHAT_OK;
}

References ASCIICHAT_OK, ERROR_CRYPTO_INIT, log_debug, and SET_ERRNO.

Referenced by main().

acds_string_validate()

bool acds_string_validate

(

const char *

str

)

Validate session string format.

Parameters

str	Session string to validate

Returns

true if valid format, false otherwise

Valid format:

• Lowercase letters only
• Exactly 2 hyphens (3 words)
• No leading/trailing hyphens
• Length <= 47 characters

Definition at line 80 of file strings.c.

                                           {
  if (!str) {
    return false;
  }
 
  size_t len = strlen(str);
  if (len == 0 || len > 47) {
    return false;
  }
 
  // Must not start or end with hyphen
  if (str[0] == '-' || str[len - 1] == '-') {
    return false;
  }
 
  // Count hyphens and validate characters
  int hyphen_count = 0;
  for (size_t i = 0; i < len; i++) {
    char c = str[i];
    if (c == '-') {
      hyphen_count++;
      // No consecutive hyphens
      if (i > 0 && str[i - 1] == '-') {
        return false;
      }
    } else if (!islower(c)) {
      // Only lowercase letters and hyphens allowed
      return false;
    }
  }
 
  // Must have exactly 2 hyphens (3 words)
  return hyphen_count == 2;
}

Referenced by session_create().