← Back to branch summary

~ubuntu-branches/ubuntu/trusty/scotch/trusty-proposed

« back to all changes in this revision

Viewing changes to debian/dgord.1

  • Committer: Bazaar Package Importer
  • Author(s): "Adam C. Powell, IV", Christophe Trophime, Johannes Ring, Adam C. Powell, IV, Angel Abad
  • Date: 2011-03-27 14:55:43 UTC
  • Revision ID: james.westby@ubuntu.com-20110327145543-4z6ls5frctvzodla
Tags: 5.1.11.dfsg-4
http://bugs.debian.org/619840
http://bugs.debian.org/612621
http://bugs.debian.org/612606
http://bugs.debian.org/612170
[Christophe Trophime]
* Add support for multiple Integer size versions (closes: #619840)
* debian/rules : rewrite to support multiple integer size versions and remove
  cdbs

[Johannes Ring]
* Remove -DSCOTCH_PTHREAD option from debian/Makefile*.inc (closes: #612621)
* Removed no-extra-clean.patch (closes: #612606).

[ Adam C. Powell, IV ]
* Fixed a couple of issues in debian/rules clean target.
* Reinstated debugging package builds after cdbs removal.

[ Angel Abad ]
* Fix FTBFS with binutils-gold (closes: #612170)

Show diffs side-by-side

added added

removed removed

Lines of Context:
debian/dgord.1
1
 
.\" Text automatically generated by txt2man
2
 
.TH pscotch_dgord 1 "June 01, 2008" "" "PT-Scotch user's manual"
3
 
.SH NAME
4
 
\fBpscotch_dgord \fP- compute sparse matrix orderings in parallel
5
 
\fB
6
 
.SH SYNOPSIS
7
 
.nf
8
 
.fam C
9
 
\fBpscotch_dgord\fP [\fIoptions\fP] [\fIgfile\fP] [\fIofile\fP] [\fIlfile\fP]
10
 
.fam T
11
 
.fi
12
 
.SH DESCRIPTION
13
 
The \fBpscotch_dgord\fP program computes, in a parallel way, an ordering of a
14
 
source graph representing the pattern of some symmetric sparse
15
 
matrix.
16
 
.PP
17
 
Source graph file \fIgfile\fP is either a centralized graph file, or a set
18
 
of files representing fragments of a distributed graph. The resulting
19
 
ordering is stored in file \fIofile\fP. Eventual logging information (such
20
 
as the one produced by option \fB-v\fP) is sent to file \fIlfile\fP. When file
21
 
names are not specified, data is read from standard input and
22
 
written to standard output. Standard streams can also be explicitely
23
 
represented by a dash '-'.
24
 
.PP
25
 
When the proper libraries have been included at compile time, \fBdgord\fP
26
 
can directly handle compressed graphs, both as input and output. A
27
 
stream is treated as compressed whenever its name is postfixed with
28
 
a compressed file extension, such as in 'brol.grf.bz2' or '-.gz'. The
29
 
compression formats which can be supported are the bzip2 format
30
 
('.bz2'), the gzip format ('.gz'), and the lzma format ('.lzma', on
31
 
input only).
32
 
.PP
33
 
\fBpscotch_dgord\fP bases on implementations of the MPI interface to spread work
34
 
across the processing elements. It is therefore not likely to be run
35
 
directly, but instead through some launcher command such as \fBmpirun\fP.
36
 
.SH OPTIONS
37
 
.TP
38
 
.B
39
 
\fB-h\fP
40
 
Display some help.
41
 
.TP
42
 
.B
43
 
\fB-m\fP\fImfile\fP
44
 
Save column block mapping data to file \fImfile\fP.
45
 
.TP
46
 
.B
47
 
\fB-o\fP\fIstrat\fP
48
 
Use distributed ordering strategy \fIstrat\fP (see
49
 
PT-Scotch user's manual for more information).
50
 
.TP
51
 
.B
52
 
\fB-r\fP\fIpnum\fP
53
 
Set root process for centralized files (default is 0).
54
 
.TP
55
 
.B
56
 
\fB-t\fP\fItfile\fP
57
 
Save partitioning tree data to file \fItfile\fP.
58
 
.TP
59
 
.B
60
 
\fB-V\fP
61
 
Display program version and copyright.
62
 
.TP
63
 
.B
64
 
\fB-v\fP\fIverb\fP
65
 
Set verbose mode to \fIverb\fP. It is a set of one of more
66
 
characters which can be:
67
 
.RS
68
 
.TP
69
 
.B
70
 
s
71
 
strategy information.
72
 
.TP
73
 
.B
74
 
t
75
 
timing information.
76
 
.SH EXAMPLE
77
 
Run \fBpscotch_dgord\fP on 5 processing elements to reorder matrix graph brol.grf
78
 
and save the resulting ordering to file brol.ord.
79
 
.PP
80
 
.nf
81
 
.fam C
82
 
      $ mpirun -np 5 pscotch_dgord brol.grf brol.ord
83
 
 
84
 
.fam T
85
 
.fi
86
 
Run \fBpscotch_dgord\fP on 5 processing elements to reorder the distributed matrix
87
 
stored on graph fragment files brol5-0.grf to brol5-4.grf, and save
88
 
the resulting ordering to file brol.ord (see \fBdgscat\fP(1) for an
89
 
explanation of the '%p' and '%r' sequences in names of distributed
90
 
graph fragments).
91
 
.PP
92
 
.nf
93
 
.fam C
94
 
      $ mpirun -np 5 pscotch_dgord brol%p-%r.grf brol.ord
95
 
 
96
 
.fam T
97
 
.fi
98
 
.SH SEE ALSO
99
 
\fBpscotch_dgtst\fP(1), \fBpscotch_dgscat\fP(1), \fBscotch_gmk_hy\fP(1), \fBscotch_gord\fP(1).
100
 
.PP
101
 
PT-Scotch user's manual.
102
 
.SH AUTHOR
103
 
Francois Pellegrini <francois.pellegrini@labri.fr>