92 lines
2.8 KiB
C
Executable File
92 lines
2.8 KiB
C
Executable File
/*
|
|
* session.c - PPP session control.
|
|
*
|
|
* Copyright (c) 2007 Diego Rivera. All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
*
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer.
|
|
*
|
|
* 2. The name(s) of the authors of this software must not be used to
|
|
* endorse or promote products derived from this software without
|
|
* prior written permission.
|
|
*
|
|
* 3. Redistributions of any form whatsoever must retain the following
|
|
* acknowledgment:
|
|
* "This product includes software developed by Paul Mackerras
|
|
* <paulus@samba.org>".
|
|
*
|
|
* THE AUTHORS OF THIS SOFTWARE DISCLAIM ALL WARRANTIES WITH REGARD TO
|
|
* THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
|
|
* AND FITNESS, IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
|
|
* SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
|
* WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN
|
|
* AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING
|
|
* OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
|
*/
|
|
|
|
#ifndef __SESSION_H
|
|
#define __SESSION_H
|
|
|
|
#define SESS_AUTH 1 /* Check User Authentication */
|
|
#define SESS_ACCT 2 /* Check Account Validity */
|
|
|
|
/* Convenience parameter to do the whole enchilada */
|
|
#define SESS_ALL (SESS_AUTH | SESS_ACCT)
|
|
|
|
/*
|
|
* int session_start(...)
|
|
*
|
|
* Start a session, performing any necessary validations.
|
|
*
|
|
* Parameters:
|
|
* const int flags :
|
|
* Any combination of the SESS_XXX flags, to indicate what the function
|
|
* should do as part of its checks
|
|
*
|
|
* const char* user :
|
|
* The username to validate. May safely be null.
|
|
*
|
|
* const char* passwd :
|
|
* The password to validate the user with. May safely be null.
|
|
*
|
|
* const char* tty :
|
|
* The TTY the user is connected on. May safely be null.
|
|
*
|
|
* char** msg :
|
|
* A char* to return an error or success message. This message will be returned
|
|
* regardless of the result. May safely be null.
|
|
*
|
|
* Return Value:
|
|
* Zero value for failure, non-zero value for successful session verification.
|
|
*/
|
|
int
|
|
session_start(const int flags, const char* user, const char* passwd, const char* tty, char** msg);
|
|
|
|
/* Added these macros for convenience... */
|
|
#define session_auth(user, pass, tty, msg) \
|
|
session_start(SESS_AUTH, user, pass, tty, msg)
|
|
|
|
#define session_check(user, pass, tty, msg) \
|
|
session_start(SESS_ACCT, user, pass, tty, msg)
|
|
|
|
#define session_full(user, pass, tty, msg) \
|
|
session_start(SESS_ALL, user, pass, tty, msg)
|
|
|
|
/*
|
|
* void session_end(...)
|
|
*
|
|
* End a previously-started session.
|
|
*
|
|
* Parameters:
|
|
* const char* tty :
|
|
* The TTY the user is connected on. May safely be null.
|
|
*/
|
|
void
|
|
session_end(const char* tty);
|
|
|
|
#endif
|