1 /* Copyright 2007,2008,2012 IPB, Universite de Bordeaux, INRIA & CNRS
2 **
3 ** This file is part of the Scotch software package for static mapping,
4 ** graph partitioning and sparse matrix ordering.
5 **
6 ** This software is governed by the CeCILL-C license under French law
7 ** and abiding by the rules of distribution of free software. You can
8 ** use, modify and/or redistribute the software under the terms of the
9 ** CeCILL-C license as circulated by CEA, CNRS and INRIA at the following
10 ** URL: "http://www.cecill.info".
11 **
12 ** As a counterpart to the access to the source code and rights to copy,
13 ** modify and redistribute granted by the license, users are provided
14 ** only with a limited warranty and the software's author, the holder of
15 ** the economic rights, and the successive licensors have only limited
16 ** liability.
17 **
18 ** In this respect, the user's attention is drawn to the risks associated
19 ** with loading, using, modifying and/or developing or reproducing the
20 ** software by the user in light of its specific status of free software,
21 ** that may mean that it is complicated to manipulate, and that also
22 ** therefore means that it is reserved for developers and experienced
23 ** professionals having in-depth computer knowledge. Users are therefore
24 ** encouraged to load and test the software's suitability as regards
25 ** their requirements in conditions enabling the security of their
26 ** systems and/or data to be ensured and, more generally, to use and
27 ** operate it in the same conditions as regards security.
28 **
29 ** The fact that you are presently reading this means that you have had
30 ** knowledge of the CeCILL-C license and that you accept its terms.
31 */
32 /************************************************************/
33 /**                                                        **/
34 /**   NAME       : library_dgraph_order_io_block.c         **/
35 /**                                                        **/
36 /**   AUTHOR     : Francois PELLEGRINI                     **/
37 /**                                                        **/
38 /**   FUNCTION   : This module is the API for the distri-  **/
39 /**                buted ordering distributed tree         **/
40 /**                building routine of the libSCOTCH       **/
41 /**                library.                                **/
42 /**                                                        **/
43 /**   DATES      : # Version 5.1  : from : 28 may 2008     **/
44 /**                                 to     28 may 2008     **/
45 /**                # Version 6.0  : from : 29 nov 2012     **/
46 /**                                 to     29 nov 2012     **/
47 /**                                                        **/
48 /************************************************************/
49 
50 /*
51 **  The defines and includes.
52 */
53 
54 #define LIBRARY
55 
56 #include "module.h"
57 #include "common.h"
58 #include "dgraph.h"
59 #include "dorder.h"
60 #include "ptscotch.h"
61 
62 /************************************/
63 /*                                  */
64 /* These routines are the C API for */
65 /* the distributed ordering         */
66 /* handling routines.               */
67 /*                                  */
68 /************************************/
69 
70 /*+ This routine saves the contents of
71 *** the given ordering to the given stream
72 *** on the form of a block ordering.
73 *** It returns:
74 *** - 0   : on success.
75 *** - !0  : on error.
76 +*/
77 
78 int
SCOTCH_dgraphOrderSaveBlock(const SCOTCH_Dgraph * const grafptr,const SCOTCH_Dordering * const ordeptr,FILE * const stream)79 SCOTCH_dgraphOrderSaveBlock (
80 const SCOTCH_Dgraph * const     grafptr,          /*+ Graph to order   +*/
81 const SCOTCH_Dordering * const  ordeptr,          /*+ Ordering to save +*/
82 FILE * const                    stream)           /*+ Output stream    +*/
83 {
84   return (dorderSaveBlock ((Dorder *) ordeptr, (Dgraph *) grafptr, stream));
85 }
86