.\" (C) 2002 Ian Gulliver .TH firestring_estr_read 3 2002-06-10 .SH NAME firestring_estr_read \- read from a file descriptor into an estring .SH SYNOPSIS .B #include .br .B -lfirestring .LP .BI "int firestring_estr_read(struct firestring_estr_t *" "estring" ", int " "fd" ")" .SH DESCRIPTION firestring_estr_read() .BR read (2)'s as much data as is available from .I fd and will fit in .I estring onto the end of the data that is already there. It updates the length of the string accordingly. .SH RETURN VALUE 0 on success. 1 with errno set properly if read returns an error or indicates EOF. 2 if there is no space in the buffer for further reads. .SH AUTHOR Ian Gulliver .SH SEE ALSO .BR libfirestring (3)