Sessions
[Dynamic page interfaces]

Functions
vars_t *	session_get_vars (session_t *ss)
	Get session variables.
const char *	session_get (session_t *ss, const char *name)
	Get session variable with given name.
const char *	session_get_id (session_t *ss)
	Get session id string.
int	session_set (session_t *ss, const char *name, const char *value)
	Set session variable with given name to a value.
int	session_age (session_t *ss)
	Get the amount of time a session has been inactive.
int	session_clean (session_t *ss)
	Remove all session variables.
int	session_del (session_t *ss, const char *name)
	Delete session variable given a name.

---

Function Documentation

vars_t* session_get_vars

(

session_t *

ss

)

Return a vars_t containing the session variables.

Parameters:

ss

session object

Returns:

the variables' list of the given ss (may be NULL)

Definition at line 531 of file session.c.

const char* session_get	(	session_t *	ss,
		const char *	name
	)

Return a string representation of variable in ss with given name.

Parameters:

	ss	session object
	name	session variable name

Returns:

the variable value corresponding to the given name (may be NULL)

Definition at line 550 of file session.c.

const char* session_get_id

(

session_t *

ss

)

Return a string carrying the session id.

Parameters:

ss

session object

Returns:

a string carrying the session id of the given ss (may be NULL)

Definition at line 571 of file session.c.

int session_set	(	session_t *	ss,
		const char *	name,
		const char *	value
	)

Put variable with name and value into ss.

Parameters:

	ss	session object
	name	session variable name
	value	session variable value

Returns:

0 if successful, non-zero on error

Definition at line 590 of file session.c.

int session_age

(

session_t *

ss

)

Return the number of seconds since the session was last modified.

Parameters:

ss

session object

Returns:

• the number of seconds since last modification
• -1 on error

Definition at line 630 of file session.c.

int session_clean

(

session_t *

ss

)

Remove all session variables from ss.

Parameters:

ss

session object

Returns:

0 if successful, non-zero on error

Definition at line 652 of file session.c.

int session_del	(	session_t *	ss,
		const char *	name
	)

Delete session variable name in ss.

Parameters:

	ss	session object
	name	session variable name

Returns:

• 0 if successful
• ~0 on error

Definition at line 682 of file session.c.