GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
LIBNUTCLIENT_TCP(3) NUT Manual LIBNUTCLIENT_TCP(3)

libnutclient_tcp, nutclient_tcp_create_client, nutclient_tcp_is_connected, nutclient_tcp_disconnect, nutclient_tcp_reconnect, nutclient_tcp_set_timeout, nutclient_tcp_get_timeout - TCP protocol related function for Network UPS Tools high-level client access library

#include <nutclient.h>

typedef NUTCLIENT_t NUTCLIENT_TCP_t;

NUTCLIENT_TCP_t nutclient_tcp_create_client(const char* host, unsigned short port);
int nutclient_tcp_is_connected(NUTCLIENT_TCP_t client);
void nutclient_tcp_disconnect(NUTCLIENT_TCP_t client);
int nutclient_tcp_reconnect(NUTCLIENT_TCP_t client);
void nutclient_tcp_set_timeout(NUTCLIENT_TCP_t client, long timeout);
long nutclient_tcp_get_timeout(NUTCLIENT_TCP_t client);

These functions allow to manage connections to upsd(8) using NUT TCP protocol.

The nutclient_tcp_create_client() function create the NUTCLIENT_TCP_t context and intend to connect to upsd at host and port. The context must be freed by nutclient_destroy()

host can be a sever name or a valid IPv4 or IPv6 adress like "localhost", "127.0.0.1" or "::1".

port is a valid TCP port, genrally 3493.

The nutclient_tcp_is_connected() function test if the connection is valid.

The nutclient_tcp_disconnect() function force to disconnect the specified connection.

The nutclient_tcp_reconnect() function force to reconnect a connection, disconnecting it if needed.

The nutclient_tcp_set_timeout() function set the timeout duration for I/O operations.

The nutclient_tcp_get_timeout() function retrieve the timeout duration for I/O operations.

timeout values are specified in seconds, negatives values for blocking.

libnutclient(3) libnutclient_general(3)
03/02/2016 Network UPS Tools 2.7.3.

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.