dmsc_session_manager_new

dmsc::c::auth

Function dmsc_session_manager_new 

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

Creates a new CDMSCSessionManager 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 CDMSCSessionManager. 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