Debian Codegraph @

dune/uggrid/parallel/ddd/PITFALLS

raw
1 <!--
2 SPDX-FileCopyrightInfo: Copyright © DUNE Project contributors, see file LICENSE.md in module root
3 SPDX-License-Identifier: LGPL-2.1-or-later
4 -->
5
6
7 this file collects common errors by ddd users, which
8 are caused by typical ddd pitfalls.
9
10 ---------------------------------------------------------------
11
12 alignment/non-alignment of buffer pointers.
13 960919 kb
14 The handlers for gathering/scattering data during IF-communication
15 are called with non-aligned pointers into the buffer. Therefore,
16 the application program can send n bytes per object in the interface
17 without wasting message buffer space.
18 However, the handlers for gathering/scattering data objects into
19 messages during Xfer (caused by calling DDD_XferAddData()) are called
20 with aligned pointers. This is due to allow access to the copy of
21 the data object inside the message buffer (which correct alignments).
22
23 ---------------------------------------------------------------
24