.\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\"
.\" Please send any bug reports, improvements, comments, patches,
.\" etc. to Steve Cheng .
.TH "LIBNUCLIENT" "3" "12 mars 2007" "" ""
.SH NAME
libnuclient \- NUFW client authentication library
.SH SYNOPSIS
.sp
\fB#include
.sp
NuAuth * nu_client_init (const char *\fInptr\fB, char *\fIusername\fB, unsigned long\fI userid\fB, char *\fI password\fB, char *\fI hostname\fB, unsigned int\fI port\fB, char\fI protocol\fB, char\fI ssl_on\fB);
.sp
int nu_client_check (NuAuth *\fI session\fB);
.sp
void nu_client_free (NuAuth *\fIsession\fB);
\fR
.SH "DESCRIPTION"
.PP
This manual page documents the
\fBlibnuclient\fR library.
.PP
Use \fBnu_client_init\fR to initialize a authentication session. Then call \fBnu_client_check\fR at
regular interval to send authentication packet to the gateway (if needed). When you're finished, call \fBnu_client_free\fR
to free the session.
.PP
Original packaging and informations and help can be found from http://www.nufw.org/
.SH "RETURN VALUE"
.PP
\fBnu_client_init\fR returns an authentication session usable by \fBnu_client_check\fR or \fBnu_client_free\fR\&.
.PP
\fBnu_client_check\fR returns the number of packets authenticated to the nuauth server during the call. It returns -1 if
an error occur when sending authentication packet. Applications MUST considered that the session is unusable when they receive this error.
.SH "ERRORS"
.PP
\fBnu_client_init\fR return NULL it a problem occur during initiation
.SH "SEE ALSO"
.PP
nuauth(8)
.SH "AUTHOR"
.PP
Nufw was designed and coded by Eric Leblond, aka Regit () , and Vincent
Deffontaines, aka gryzor (). Original idea in 2001, while working on NSM Ldap
support.
.PP
This manual page was written by Eric Leblond
.PP
Permission is
granted to copy, distribute and/or modify this document under
the terms of the GNU Free Documentation
License, Version 2 as published by the Free
Software Foundation; with no Invariant Sections, no Front-Cover
Texts and no Back-Cover Texts.