FreeBSD Manual Pages
OPENPAM_READLINE(3) BSD Library Functions Manual OPENPAM_READLINE(3) NAME openpam_readline -- read a line from a file LIBRARY Pluggable Authentication Module Library (libpam, -lpam) SYNOPSIS #include <sys/types.h> #include <stdio.h> #include <security/pam_appl.h> #include <security/openpam.h> char * openpam_readline(FILE *f, int *lineno, size_t *lenp); DESCRIPTION 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: +o Comments (introduced by a hash sign) are stripped. +o Blank lines are ignored. +o 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 to free(3). RETURN VALUES The openpam_readline() function returns NULL on failure. SEE ALSO openpam_readlinev(3), openpam_readword(3), pam(3) STANDARDS The openpam_readline() function is an OpenPAM extension. AUTHORS 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 Smorgrav <des@des.no>. BSD September 12, 2014 BSD
NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUES | SEE ALSO | STANDARDS | AUTHORS
Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=openpam_readline&sektion=3&manpath=FreeBSD+11.2-RELEASE+and+Ports>