Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
OPENPAM_READLINE(3)	 BSD Library Functions Manual	   OPENPAM_READLINE(3)

NAME
     openpam_readline -- read a	line from a file

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				April 30, 2017				   BSD

NAME | 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+12.0-RELEASE+and+Ports>

home | help