← Back to branch summary

~ubuntu-branches/ubuntu/saucy/nwchem/saucy

« back to all changes in this revision

Viewing changes to src/tools/ga-4-3/ma/MA.tex

  • Committer: Package Import Robot
  • Author(s): Michael Banck, Michael Banck, Daniel Leidert
  • Date: 2012-02-09 20:02:41 UTC
  • mfrom: (1.1.1)
  • Revision ID: package-import@ubuntu.com-20120209200241-jgk03qfsphal4ug2
Tags: 6.1-1
http://bugs.debian.org/632611
https://launchpad.net/bugs/791308
* New upstream release.

[ Michael Banck ]
* debian/patches/02_makefile_flags.patch: Updated.
* debian/patches/02_makefile_flags.patch: Use internal blas and lapack code.
* debian/patches/02_makefile_flags.patch: Define GCC4 for LINUX and LINUX64
  (Closes: #632611 and LP: #791308).
* debian/control (Build-Depends): Added openssh-client.
* debian/rules (USE_SCALAPACK, SCALAPACK): Removed variables (Closes:
  #654658).
* debian/rules (LIBDIR, USE_MPIF4, ARMCI_NETWORK): New variables.
* debian/TODO: New file.
* debian/control (Build-Depends): Removed libblas-dev, liblapack-dev and
  libscalapack-mpi-dev.
* debian/patches/04_show_testsuite_diff_output.patch: New patch, shows the
  diff output for failed tests.
* debian/patches/series: Adjusted.
* debian/testsuite: Optionally run all tests if "all" is passed as option.
* debian/rules: Run debian/testsuite with "all" if DEB_BUILD_OPTIONS
  contains "checkall".

[ Daniel Leidert ]
* debian/control: Used wrap-and-sort. Added Vcs-Svn and Vcs-Browser fields.
  (Priority): Moved to extra according to policy section 2.5.
  (Standards-Version): Bumped to 3.9.2.
  (Description): Fixed a typo.
* debian/watch: Added.
* debian/patches/03_hurd-i386_define_path_max.patch: Added.
  - Define MAX_PATH if not defines to fix FTBFS on hurd.
* debian/patches/series: Adjusted.

Show diffs side-by-side

added added

removed removed

Lines of Context:
src/tools/ga-4-3/ma/MA.tex
 
1
\documentstyle[11pt,twocolumn]{article}
 
2
 
 
3
% vertical parameters
 
4
\setlength{\topmargin}{0in}
 
5
\setlength{\headheight}{0in}
 
6
\setlength{\headsep}{0in}
 
7
\setlength{\topskip}{0in}
 
8
\setlength{\textheight}{8.5in}
 
9
\setlength{\footheight}{10pt}
 
10
\setlength{\footskip}{0.5in}
 
11
 
 
12
% horizontal parameters
 
13
\setlength{\textwidth}{6.5in}
 
14
\setlength{\oddsidemargin}{0in}
 
15
\setlength{\evensidemargin}{0in}
 
16
\setlength{\marginparwidth}{0in}
 
17
\setlength{\parindent}{0in}
 
18
 
 
19
\begin{document}
 
20
 
 
21
MA is a library of routines that comprises a dynamic memory allocator
 
22
for use by C, FORTRAN, or mixed-language applications.  C applications
 
23
can benefit from using MA instead of the ordinary malloc() and free()
 
24
routines because of the extra features MA provides:  both heap and
 
25
stack memory management disciplines, debugging and verification
 
26
support, usage statistics, and quantitative memory availability
 
27
information.  FORTRAN applications can take advantage of the same
 
28
features, and may in fact require a library such as MA because dynamic
 
29
memory allocation is not supported by all versions of the language.
 
30
 
 
31
MA is designed to be portable across a variety of platforms.
 
32
The following platforms are currently supported:
 
33
 
 
34
\begin{itemize}
 
35
\item Cray Y-MP C90
 
36
\item Cray T3D
 
37
\item DEC Alpha
 
38
\item HP 9000/700
 
39
\item IBM RS/6000
 
40
\item Intel DELTA
 
41
\item Intel iPSC/860
 
42
\item Intel Paragon
 
43
\item KSR1
 
44
\item SGI
 
45
\item SGI Power Challenge
 
46
\item SPARC
 
47
\end{itemize}
 
48
 
 
49
The implementation of MA uses the following memory layout:
 
50
 
 
51
\begin{quote}
 
52
segment = heap\_region stack\_region \\
 
53
region = block block block \ldots \\
 
54
block = AD gap1 guard1 client\_space guard2 gap2
 
55
\end{quote}
 
56
 
 
57
A segment of memory is obtained from the OS upon initialization.
 
58
The low end of the segment is managed as a heap; the heap region
 
59
grows from low addresses to high addresses.  The high end of the
 
60
segment is managed as a stack; the stack region grows from high
 
61
addresses to low addresses.
 
62
 
 
63
Each region consists of a series of contiguous blocks, one per
 
64
allocation request, and possibly some unused space.  Blocks in
 
65
the heap region are either in use by the client (allocated and
 
66
not yet deallocated) or not in use by the client (allocated and
 
67
already deallocated).  A block on the rightmost end of the heap
 
68
region becomes part of the unused space upon deallocation.
 
69
Blocks in the stack region are always in use by the client,
 
70
because when a stack block is deallocated, it becomes part of
 
71
the unused space.
 
72
 
 
73
A block consists of the client space, i.e., the range of memory
 
74
available for use by the application; guard words adjacent to
 
75
each end of the client space to help detect improper memory access
 
76
by the client; bookkeeping info (in an ``allocation descriptor,''
 
77
AD); and two gaps, each zero or more bytes long, to satisfy
 
78
alignment constraints (specifically, to ensure that AD and
 
79
client\_space are aligned properly).
 
80
 
 
81
A set of man pages for the MA routines is available.
 
82
\end{document}