---
name: "libnuclient"
section: "3"
platform: "linux"
package: "libnuclient-dev"
version: "2.4.3-3.4"
release: "Debian 9 (Stretch)"
platforms: ["linux"]
url: "https://new.carta.tech/libnuclient"
---

# libnuclient(3)

NUFW client authentication library

## NAME

libnuclient - NUFW client authentication library

## SYNOPSIS

**#include \<nuclient.h\>**

**NuAuth \* nu\_client\_init (const char \****nptr***,  char \****username***,  unsigned long** *userid***,  char \*** *password***,  char \*** *hostname***,  unsigned int** *port***,  char** *protocol***,  char** *ssl\_on***);**

**int nu\_client\_check (NuAuth \*** *session***);**

**void nu\_client\_free (NuAuth \****session***);**

## DESCRIPTION

This manual page documents the **libnuclient** library.

Use **nu\_client\_init** to initialize a authentication session. Then call **nu\_client\_check** at  regular interval to send authentication packet to the gateway (if needed). When you're finished, call **nu\_client\_free** to free the session.

Original packaging and informations and help can be found from http://www.nufw.org/

## RETURN VALUE

**nu\_client\_init** returns an authentication session usable by **nu\_client\_check** or **nu\_client\_free**.

**nu\_client\_check** 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.

## ERRORS

**nu\_client\_init** return NULL it a problem occur during initiation

## SEE ALSO

[nuauth(8)](/nuauth/8.md)

## AUTHOR

Nufw was designed and coded by Eric Leblond, aka Regit (\<regit@inl.fr\>) , and Vincent Deffontaines, aka gryzor (\<vincent@inl.fr\>). Original idea in 2001, while working on NSM Ldap support.

This manual page was written by Eric Leblond

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.