date and time created 91/05/02 04:44:11 by cael
authorCynthia A. E. Livingston <cael@ucbvax.Berkeley.EDU>
Thu, 2 May 1991 19:44:11 +0000 (11:44 -0800)
committerCynthia A. E. Livingston <cael@ucbvax.Berkeley.EDU>
Thu, 2 May 1991 19:44:11 +0000 (11:44 -0800)
SCCS-vsn: lib/libc/stdlib/calloc.3 5.1
SCCS-vsn: lib/libc/stdlib/realloc.3 5.1

usr/src/lib/libc/stdlib/calloc.3 [new file with mode: 0644]
usr/src/lib/libc/stdlib/realloc.3 [new file with mode: 0644]

diff --git a/usr/src/lib/libc/stdlib/calloc.3 b/usr/src/lib/libc/stdlib/calloc.3
new file mode 100644 (file)
index 0000000..b6107d9
--- /dev/null
@@ -0,0 +1,41 @@
+.\" Copyright (c) 1991 The Regents of the University of California.
+.\" All rights reserved.
+.\"
+.\"    @(#)calloc.3    5.1 (Berkeley) %G%
+.\" %sccs.include.redist.man%
+.\"
+.\"    @(#)calloc.3    5.1 (Berkeley) %G%
+.\"
+.Dd 
+.Dt CALLOC 3
+.Os
+.Sh NAME
+.Nm calloc
+.Nd allocate clean memory (zero initialized space)
+.Sh SYNOPSIS
+.Fd #include <stdlib.h>
+.Ft void *
+.Fn calloc "size_t nmemb" "size_t size"
+.Sh DESCRIPTION
+The
+.Fn calloc
+function allocates space for an array of 
+.Fa nmemb
+objects, each of whose size is
+.Fa size .
+The space is initialized to all bits zero.
+.Sh RETURN VALUES
+The
+.Fn calloc
+function returns
+a pointer to the
+the allocated space if successful; otherwise a null pointer is returned.
+.Sh SEE ALSO
+.Xr malloc 3 ,
+.Xr realloc 3 ,
+.Xr free 3 ,
+.Sh STANDARDS
+The
+.Fn calloc
+function conforms to
+.St -ansiC .
diff --git a/usr/src/lib/libc/stdlib/realloc.3 b/usr/src/lib/libc/stdlib/realloc.3
new file mode 100644 (file)
index 0000000..feea6c1
--- /dev/null
@@ -0,0 +1,73 @@
+.\" Copyright (c) 1991 The Regents of the University of California.
+.\" All rights reserved.
+.\"
+.\" %sccs.include.redist.man%
+.\"
+.\"     @(#)realloc.3  5.1 (Berkeley) %G%
+.\"
+.Dd 
+.Dt REALLOC 3
+.Os
+.Sh NAME
+.Nm realloc
+.Nd reallocation of memory function
+.Sh SYNOPSIS
+.Fd #include <stdlib.h>
+.Ft void *
+.Fn realloc "void *ptr" "size_t size"
+.Sh DESCRIPTION
+The
+.Fn realloc
+function changes the size of the object pointed to by
+.Fa ptr
+to the size specified by
+.Fa size .
+The contents of the object are unchanged up to the lesser
+of the new and old sizes.
+If the new size is larger, the value of the newly allocated portion
+of the object is indeterminate.
+If
+.Fa ptr
+is a null pointer, the
+.Fn realloc
+function behaves like the
+.Xr malloc 3
+function for the specified size.
+Otherwise, if
+.Fa ptr
+does not match a pointer earlier returned by the
+.Xr calloc 3 ,
+.Xr malloc 3 ,
+or 
+.Fn realloc
+function, or if the space has been deallocated
+by a call to the
+.Xr free
+or
+.Fn realloc
+function, unpredictable and usually detrimental
+behaviour will occur.
+If the space cannot be allocated, the object 
+pointed to by
+.Fa ptr
+is unchanged.
+If
+.Fa size
+is zero and
+.Fa ptr
+is not a null pointer, the object it points to is freed.
+.Pp
+The
+.Fn realloc
+function returns either a null pointer or a pointer
+to the possibly moved allocated space.
+.Sh SEE ALSO
+.Xr alloca 3 ,
+.Xr calloc 3 ,
+.Xr free 3 ,
+.Xr malloc 3 ,
+.Sh STANDARDS
+The
+.Fn realloc
+function conforms to
+.St -ansiC .