- NetBSD Manual Pages
OPENPAM_READLINE(3) NetBSD Library Functions Manual OPENPAM_READLINE(3)
Powered by man-cgi (2021-06-01).
Maintained for NetBSD
by Kimmo Suominen.
Based on man-cgi by Panagiotis Christias.
openpam_readline -- read a line from a file
openpam_readline(FILE *f, int *lineno, size_t *lenp);
This function is deprecated and may be removed in a future release with-
out further warning. The openpam_readlinev() function may be used to
achieve similar results.
The openpam_readline() function reads a line from a file, and returns it
in a NUL-terminated buffer allocated with malloc(3).
The openpam_readline() function performs a certain amount of processing
on the data it reads:
· Comments (introduced by a hash sign) are stripped.
· Blank lines are ignored.
· If a line ends in a backslash, the backslash is stripped and the next
line is appended.
If lineno is not NULL, the integer variable it points to is incremented
every time a newline character is read.
If lenp is not NULL, the length of the line (not including the terminat-
ing NUL character) is stored in the variable it points to.
The caller is responsible for releasing the returned buffer by passing it
The openpam_readline() function returns NULL on failure.
openpam_readlinev(3), openpam_readword(3), pam(3)
The openpam_readline() function is an OpenPAM extension.
The openpam_readline() function and this manual page were developed for
the FreeBSD Project by ThinkSec AS and Network Associates Laboratories,
the Security Research Division of Network Associates, Inc. under
DARPA/SPAWAR contract N66001-01-C-8035 (``CBOSS''), as part of the DARPA
CHATS research program.
The OpenPAM library is maintained by Dag-Erling Smørgrav <email@example.com>.
NetBSD 9.2 April 30, 2017 NetBSD 9.2