X-Git-Url: http://git.ozlabs.org/?a=blobdiff_plain;f=pppd%2Fsession.h;fp=pppd%2Fsession.h;h=bee8c4124eafb425fd85ec01c485a92ec6504ba0;hb=e5b9a1061f126b36c558aea09fd76fd691ebf018;hp=0000000000000000000000000000000000000000;hpb=e3426561f8042f6f231de8103b21f200d2042ef3;p=ppp.git

diff --git a/pppd/session.h b/pppd/session.h
new file mode 100644
index 0000000..bee8c41
--- /dev/null
+++ b/pppd/session.h
@@ -0,0 +1,91 @@
+/*
+ * 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