Skip to main content

ri_session_manager_new

ri::c::auth

Function ri_session_manager_new 

Source 
#[unsafe(no_mangle)]
pub extern "C" fn ri_session_manager_new(
    timeout_secs: u64,
) -> *mut CRiSessionManager
Expand description

Creates a new CRiSessionManager instance with specified session timeout.

Initializes a session manager for stateful authentication sessions. Sessions track authenticated user state and provide automatic timeout management for security.

§Parameters

  • timeout_secs: Session idle timeout in seconds. Sessions are considered expired if no activity occurs within this duration. The timeout is reset on each authenticated request. Typical values range from 300 to 1800 seconds.

§Returns

Pointer to newly allocated CRiSessionManager. Never returns NULL as the implementation uses unwrap for default configuration.

§Session Behavior

Active sessions will be invalidated after:

  • timeout_secs seconds of inactivity
  • Explicit call to session invalidation function
  • Server shutdown or process termination

Expired sessions remain in memory until:

  • Automatic cleanup interval runs
  • Session count exceeds maximum capacity
  • Manual cleanup function is called