UPSCLI_READLINE(3) NUT Manual UPSCLI_READLINE(3)NAME
upscli_readline - read a single response from a UPS
SYNOPSIS
#include <upsclient.h>
int upscli_readline(UPSCONN_t *ups, char *buf, size_t buflen);
DESCRIPTION
The upscli_readline() function takes the pointer ups to a UPSCONN_t state structure, receives a single line from the server, and copies up
to buflen bytes of the response into the buffer buf.
Some parsing of the string occurs during reception. In particular, ERR messages from upsd(8) are detected and will cause this function to
return -1.
RETURN VALUE
The upscli_readline() function returns 0 on success, or -1 if an error occurs.
SEE ALSO upscli_fd(3), upscli_get(3), upscli_readline(3), upscli_sendline(3), upscli_ssl(3), upscli_strerror(3), upscli_upserror(3)Network UPS Tools 05/22/2012 UPSCLI_READLINE(3)
Check Out this Related Man Page
UPSCLIENT(3) NUT Manual UPSCLIENT(3)NAME
upsclient - Network UPS Tools client access library
DESCRIPTION
The Network UPS Tools (NUT) upsclient library provides a number of useful functions for programs to use when communicating with upsd(8).
Many of the low-level socket and protocol details are handled automatically when using this interface.
State is maintained across calls in an opaque structure called UPSCONN_t. Callers are expected to create one per connection. These will be
provided to most of the upsclient functions. The format of this structure is subject to change, and client programs must not reference
elements within it directly.
NETWORK FUNCTIONS
To create a new connection, use upscli_connect(3). This will also initialize the UPSCONN_t structure. To verify that a connection has been
established later, upscli_fd(3) can be used to return the file descriptor. Clients wishing to check for the presence and operation of SSL
on a connection may call upscli_ssl(3).
The majority of clients will use upscli_get(3) to retrieve single items from the server. To retrieve a list, use upscli_list_start(3) to
get it started, then call upscli_list_next(3) for each element.
Raw lines of text may be sent to upsd(8) with upscli_sendline(3). Reading raw lines is possible with upscli_readline(3). Client programs
are expected to format these lines according to the protocol, as no checking will be performed before transmission.
At the end of a connection, you must call upsclient_disconnect(3) to disconnect from upsd and release any dynamic memory associated with
the UPSCONN_t structure. Failure to call this function will result in memory and file descriptor leaks in your program.
ERROR HANDLING
In the event of an error, upscli_strerror(3) will provide human-readable details on what happened. upscli_upserror(3) may also be used to
retrieve the error number. These numbers are defined in upsclient.h as UPSCLI_ERR_*.
SEE ALSO libupsclient-config(1), upscli_connect(3), upscli_disconnect(3), upscli_fd(3), upscli_getvar(3), upscli_list_next(3), upscli_list_start(3),
upscli_readline(3), upscli_sendline(3), upscli_splitaddr(3), upscli_splitname(3), upscli_ssl(3), upscli_strerror(3), upscli_upserror(3)Network UPS Tools 05/22/2012 UPSCLIENT(3)
I have a huge matrix file containing some 1.5 million rows and 6000 columns. The matrix looks something like this:
1 2 3
4 5 6
7 8 9
3 4 5
I want to add all the numbers in the columns of this matrix and display the result to my stdout. This means that the numbers in the first column are:
... (2 Replies)
Hi,
Just trying to get to grips with sed and awk for some reporting for work and I need some assistance:
I have a file that lists policy names on the first line and then on the second line whether the policy is active or not.
Policy Name: Policy1
Active: yes
Policy... (8 Replies)
version info :
vi availabe with RHEL 5.4
I have a text file with 10,000 lines. I want to copy lines from 5000th line to 7000th and redirect to a file. Any idea how I can do this?
Note:
The above scenario is just an example. In my actual requirement, the file has 14 million lines and I want... (9 Replies)
Hi everyone,
I know the following questions are noobish questions but I am asking them because I am confused about the basics of history behind UNIX and LINUX.
Ok onto business, my questions are-:
Was/Is UNIX ever an open source operating system ?
If UNIX was... (21 Replies)
Hello,
I couldn't find an actual introduction thread, so I decided to just put this here.
I go by d0wngrade online. I have been programming in multiple languages for about 15+ years. I started with standard web design languages like HTML and CSS, but I then advanced from design to development... (2 Replies)
Hi guys...
The first active code line in AudioScope.sh is set -u .
This causes a complete exit if a variable is used/found but has not been allocated at the start of the program.
However, apart from writing code to do the task, is there a switch to to check which variables have been... (17 Replies)
Hi.
In thread https://www.unix.com/shell-programming-and-scripting/267833-grouping-counting.html rovf and I had a mini-discussion on grep and awk.
Here is a demo script that compares the awk and grep approaches for this single problem:
#!/usr/bin/env bash
# @(#) s2 Demonstrate group... (1 Reply)
Hello,
I have to fish out some specific columns from a file based on the header value. I have the list of columns I need in a different file. I thought I could read in the list of headers I need,
# file with header names of required columns in required order
headers_file=$2
# read contents... (11 Replies)
For those interested in installing dash shell on OSX Lion to help test POSIX compliancy of shell scripts, it is quite easy. I did it like this:
If you don't have gcc on your system:
0. Download and install the Command Line Tools for Xcode package from Sign In - Apple *
1. Download the dash... (2 Replies)
Hello and thanks in advance for any help anyone can offer me
I'm trying to learn the find command and thought I was understanding it... Apparently I was wrong. I was doing compound searches and I started getting weird results with the -size test. I was trying to do a search on a 1G file owned by... (14 Replies)
I have data of an excel files as given below,
file1
org1_1 1 1 2.5 100
org1_2 1 2 5.5 98
org1_3 1 3 7.2 88
file2
org2_1 1 1 2.5 100
org2_2 1 2 5.5 56
org2_3 1 3 7.2 70
I have multiple excel files as above shown.
I have to copy column 1, column 4 and paste into a new excel file as... (26 Replies)
Dear All,
Taking a break from Vue.js coding for the site, SEO and YT videos; and hopefully addressing some well deserved criticism from some here that I have been too focused on the visual aspects of the forums versus the substance and the community....
While the "current generation... (9 Replies)
Hi all...
Well guys and gals, I jumped in at the deep end and found things that PERL cannot do by default.
Many tricky terminal escape codes are not catered for so I had to create workarounds.
One thing I searched for was this:
Passing perl variable to shell command
AND, @Neo this was... (15 Replies)