.\"   $Id: autallocblock.3,v 1.1 2002/03/21 13:17:23 ludo Exp $
.\" @(#)autallocblock.2 2.7 96/07/02 ; Labo masi cao-vlsi; Author : Jacomme Ludovic
.TH AUTALLOCBLOCK 3 "October 1, 1997" "ASIM/LIP6" "AUT FUNCTIONS"
.SH NAME
autallocblock \- memory allocator
.so buster/alliance/alc_origin.1.en.gz
.SH SYNOPSYS
.nf
.if n \{\
.ft B \}
.if t \{\
.ft CR \}
#include "aut101.h"
char *autallocblock( Size )
   unsigned int Size;
.ft R
.fi
.SH PARAMETERS
.TP 20
\fISize\fP
Number of memory bytes to be contiguously allocated
.TP
.SH DESCRIPTION
\fBautallocblock\fP returns a block of \fISize\fP bytes length.
The memory block is set to zero.
.br
.SH RETURN VALUE
\fBautallocblock\fP returns a pointer to a \fISize\fP bytes long block.
.SH ERRORS
.if n \{\
.ft B \}
.if t \{\
.ft CR \}
"autalloc: alloc error, can't continue !"
.ft R
.RS
System break can't be moved anymore, no more memory can be retrieved from the system.
.SH EXAMPLE
.ta 3n 6n 9n 12n 15n 18n 21n
.nf
.if n \{\
.ft B \}
.if t \{\
.ft CR \}
#include "aut101.h"
char \(**dup_str(s)
  char \(** s;
{
  char \(**t = (char \(**)autalocblock(strlen(s) + (unsigned int)1);
  strcpy(t, s); return t;
}
.ft R
.fi
.SH SEE ALSO
.BR aut (1),
.BR autresizeblock(3),
.BR autallocheap(3),
.BR autfreeblock(3),
.BR autfreeheap(3).


.so buster/alliance/alc_bug_report.1.en.gz