1 .\" Generated from openpam_straddch.c by gendoc.pl
2 .\" $Id: openpam_straddch.c 648 2013-03-05 17:54:27Z des $
8 .Nd add a character to a string, expanding the buffer if needed
13 .In security/pam_appl.h
14 .In security/openpam.h
16 .Fn openpam_straddch "char **str" "size_t *size" "size_t *len" "int ch"
20 function appends a character to a dynamically
21 allocated NUL-terminated buffer, reallocating the buffer as needed.
25 argument points to a variable containing either a pointer to
28 If the value of the variable pointed to by
39 argument point to variables used to hold the size
40 of the buffer and the length of the string it contains, respectively.
44 is the character that should be appended to
47 is 0, nothing is appended, but a new buffer is
50 is NULL. This can be used to
57 If a new buffer is allocated or an existing buffer is reallocated to
58 make room for the additional character,
67 function ensures that the buffer is always
72 function is successful, it increments the
73 integer variable pointed to by
78 Otherwise, it leaves the variables pointed to by
92 function returns 0 on success and -1 on failure.
99 function is an OpenPAM extension.
103 function and this manual page were
105 .An Dag-Erling Sm\(/orgrav Aq des@des.no .