This is the mail archive of the glibc-cvs@sourceware.org mailing list for the glibc project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

GNU C Library master sources branch master updated. glibc-2.19-259-g1c21d11


This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "GNU C Library master sources".

The branch, master has been updated
       via  1c21d115e3e47cd66007341de4bae5c4b0a2d547 (commit)
      from  fcccd51286acbf9c19ac57ab7143e257d58323fd (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
http://sourceware.org/git/gitweb.cgi?p=glibc.git;a=commitdiff;h=1c21d115e3e47cd66007341de4bae5c4b0a2d547

commit 1c21d115e3e47cd66007341de4bae5c4b0a2d547
Author: David Svoboda <svoboda@cert.org>
Date:   Wed Apr 2 05:13:02 2014 -0400

    manual: clarify buffer behavior in getline [BZ #5666]
    
    If the user has requested automatic buffer creation, getline may create
    it and not free things when an error occurs.  That means the user is
    always responsible for calling free() regardless of the return value.
    
    The current documentation does not explicitly cover this which leaves it
    slightly ambiguous to the reader.  So clarify things.
    
    URL: https://sourceware.org/bugzilla/show_bug.cgi?id=5666

diff --git a/ChangeLog b/ChangeLog
index 7a1c106..da8ea6d 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2014-04-03  David Svoboda  <svoboda@cert.org>
+
+	[BZ #5666]
+	* manual/stdio.texi (Line-Oriented Input): Document buffer allocation
+	explicitly.
+
 2014-04-03  Roland McGrath  <roland@hack.frob.com>
 
 	* elf/dl-unmap-segments.h: New file.
diff --git a/manual/stdio.texi b/manual/stdio.texi
index a4364f7..efdaaad 100644
--- a/manual/stdio.texi
+++ b/manual/stdio.texi
@@ -1298,7 +1298,8 @@ back in @code{*@var{n}}.
 
 If you set @code{*@var{lineptr}} to a null pointer, and @code{*@var{n}}
 to zero, before the call, then @code{getline} allocates the initial
-buffer for you by calling @code{malloc}.
+buffer for you by calling @code{malloc}.  This buffer remains allocated
+even if @code{getline} encounters errors and is unable to read any bytes.
 
 In either case, when @code{getline} returns,  @code{*@var{lineptr}} is
 a @code{char *} which points to the text of the line.

-----------------------------------------------------------------------

Summary of changes:
 ChangeLog         |    6 ++++++
 manual/stdio.texi |    3 ++-
 2 files changed, 8 insertions(+), 1 deletions(-)


hooks/post-receive
-- 
GNU C Library master sources


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]