AuroraMiddleware/glibc
1
0
Fork 0
mirror of https://sourceware.org/git/glibc.git synced 2024-11-25 14:30:06 +00:00
Code Issues Packages Projects Releases Wiki Activity

manual: fix typos in the memory chapter

Browse Source 
Some of these are obvious grammar fixes while others fix references
to the function prototypes.
This commit is contained in:
Rical Jasan 2016-05-06 00:54:31 -07:00 committed by Mike Frysinger
parent 228a78c21b
commit 3ef569c71b
2 changed files with 16 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
ChangeLog
View File

@ -1,3 +1,7 @@
2016-06-16 Rical Jasan <ricaljasan@pacific.net>
* manual/memory.texi: Fix various typos & grammar errors.
2016-06-14 Joseph Myers <joseph@codesourcery.com> 2016-06-14 Joseph Myers <joseph@codesourcery.com>
[BZ #20255] [BZ #20255]

24
manual/memory.texi
View File

@ -158,7 +158,7 @@ grows, but doesn't shrink when the stack shrinks.
This section covers how ordinary programs manage storage for their data, This section covers how ordinary programs manage storage for their data,
including the famous @code{malloc} function and some fancier facilities including the famous @code{malloc} function and some fancier facilities
special @theglibc{} and GNU Compiler. special to @theglibc{} and GNU Compiler.
@menu @menu
* Memory Allocation and C:: How to get different kinds of allocation in C. * Memory Allocation and C:: How to get different kinds of allocation in C.
@ -997,7 +997,7 @@ The @code{memalign} function returns a null pointer on error and sets
There was insufficient memory available to satisfy the request. There was insufficient memory available to satisfy the request.
@item EINVAL @item EINVAL
@var{alignment} is not a power of two. @var{boundary} is not a power of two.
@end table @end table
@ -1066,7 +1066,7 @@ systems that do not support @w{ISO C11}.
@c _int_memalign dup @acsfd @acsmem @c _int_memalign dup @acsfd @acsmem
@c mutex_unlock dup @aculock @c mutex_unlock dup @aculock
Using @code{valloc} is like using @code{memalign} and passing the page size Using @code{valloc} is like using @code{memalign} and passing the page size
as the value of the second argument. It is implemented like this: as the value of the first argument. It is implemented like this:
@smallexample @smallexample
void * void *
@ -1608,7 +1608,7 @@ Return information about the current dynamic memory usage.
A complicated task when programming with languages which do not use A complicated task when programming with languages which do not use
garbage collected dynamic memory allocation is to find memory leaks. garbage collected dynamic memory allocation is to find memory leaks.
Long running programs must assure that dynamically allocated objects are Long running programs must ensure that dynamically allocated objects are
freed at the end of their lifetime. If this does not happen the system freed at the end of their lifetime. If this does not happen the system
runs out of memory, sooner or later. runs out of memory, sooner or later.
@ -1709,7 +1709,7 @@ main (int argc, char *argv[])
@} @}
@end example @end example
This is all what is needed if you want to trace the calls during the This is all that is needed if you want to trace the calls during the
whole runtime of the program. Alternatively you can stop the tracing at whole runtime of the program. Alternatively you can stop the tracing at
any time with a call to @code{muntrace}. It is even possible to restart any time with a call to @code{muntrace}. It is even possible to restart
the tracing again with a new call to @code{mtrace}. But this can cause the tracing again with a new call to @code{mtrace}. But this can cause
@ -1718,8 +1718,8 @@ not called. Please note that not only the application uses the traced
functions, also libraries (including the C library itself) use these functions, also libraries (including the C library itself) use these
functions. functions.
This last point is also why it is no good idea to call @code{muntrace} This last point is also why it is not a good idea to call @code{muntrace}
before the program terminated. The libraries are informed about the before the program terminates. The libraries are informed about the
termination of the program only after the program returns from termination of the program only after the program returns from
@code{main} or calls @code{exit} and so cannot free the memory they use @code{main} or calls @code{exit} and so cannot free the memory they use
before this time. before this time.
@ -2147,7 +2147,7 @@ in the same obstack.
If @var{object} is a null pointer, everything allocated in the obstack If @var{object} is a null pointer, everything allocated in the obstack
is freed. Otherwise, @var{object} must be the address of an object is freed. Otherwise, @var{object} must be the address of an object
allocated in the obstack. Then @var{object} is freed, along with allocated in the obstack. Then @var{object} is freed, along with
everything allocated in @var{obstack} since @var{object}. everything allocated in @var{obstack-ptr} since @var{object}.
@end deftypefun @end deftypefun
Note that if @var{object} is a null pointer, the result is an Note that if @var{object} is a null pointer, the result is an
@ -2392,7 +2392,7 @@ in the current chunk. It is declared as follows:
@safety{@prelim{}@mtsafe{@mtsrace{:obstack-ptr}}@assafe{}@acsafe{}} @safety{@prelim{}@mtsafe{@mtsrace{:obstack-ptr}}@assafe{}@acsafe{}}
This returns the number of bytes that can be added safely to the current This returns the number of bytes that can be added safely to the current
growing object (or to an object about to be started) in obstack growing object (or to an object about to be started) in obstack
@var{obstack} using the fast growth functions. @var{obstack-ptr} using the fast growth functions.
@end deftypefun @end deftypefun
While you know there is room, you can use these fast growth functions While you know there is room, you can use these fast growth functions
@ -2802,7 +2802,7 @@ open-coded by the GNU C compiler.)
@item @item
Since @code{alloca} does not have separate pools for different sizes of Since @code{alloca} does not have separate pools for different sizes of
block, space used for any size block can be reused for any other size. blocks, space used for any size block can be reused for any other size.
@code{alloca} does not cause memory fragmentation. @code{alloca} does not cause memory fragmentation.
@item @item
@ -2921,7 +2921,7 @@ The address of the end of a segment is defined to be the address of the
last byte in the segment plus 1. last byte in the segment plus 1.
The function has no effect if @var{addr} is lower than the low end of The function has no effect if @var{addr} is lower than the low end of
the data segment. (This is considered success, by the way). the data segment. (This is considered success, by the way.)
The function fails if it would cause the data segment to overlap another The function fails if it would cause the data segment to overlap another
segment or exceed the process' data storage limit (@pxref{Limits on segment or exceed the process' data storage limit (@pxref{Limits on
@ -3243,7 +3243,7 @@ with @code{munlockall} and @code{munlock}.
@safety{@prelim{}@mtsafe{}@assafe{}@acsafe{}} @safety{@prelim{}@mtsafe{}@assafe{}@acsafe{}}
@code{munlockall} unlocks every page in the calling process' virtual @code{munlockall} unlocks every page in the calling process' virtual
address space and turn off @code{MCL_FUTURE} future locking mode. address space and turns off @code{MCL_FUTURE} future locking mode.
The return value is zero if the function succeeds. Otherwise, it is The return value is zero if the function succeeds. Otherwise, it is
@code{-1} and @code{errno} is set accordingly. The only way this @code{-1} and @code{errno} is set accordingly. The only way this