Debian Codegraph @

doc/man/botch-create-graph.pod

raw
1 =head1 NAME
2
3 botch-create-graph - create graph based on installation sets, strong dependency sets or dependency closures
4
5 =head1 SYNOPSIS
6
7 =over
8
9 =item B<botch-create-graph> [options] I<Packages..> I<Sources>
10
11 =back
12
13 =head1 DESCRIPTION
14
15 Given a repository of source packages and binary packages, create the build
16 graph and source graph for it
17
18 =head1 OPTIONS
19
20 =over 4
21
22 =item B<--version>
23
24 show program's version and exit
25
26 =item B<-h, --help>
27
28 show this help message and exit
29
30 =item B<-v, --verbose>
31
32 print additional information
33
34 =item B<--quiet>
35
36 do no print any messages
37
38 =item B<-A, --available=>I<FILE>
39
40 List of available packages (arch:all, crossed...) in control file format
41
42 =item B<--custom-is=>I<FILE>
43
44 list of files with dependencies that should not be part of the IS
45
46 =item B<--deb-drop-b-d-indep>
47
48 Drop Build-Depends-Indep dependencies
49
50 =item B<--deb-drop-b-d-arch>
51
52 Drop Build-Depends-Arch dependencies
53
54 =item B<--allowsrcmismatch>
55
56 If a binary package is without a source package but there is a source package
57 of same name but different version, match this binary package to that source
58 package.
59
60 =item B<--progress>
61
62 print progress bars
63
64 =item B<--timers>
65
66 print timing information
67
68 =item B<--strongtype>
69
70 generate a strong build graph (only strong dependencies)
71
72 =item B<--closuretype>
73
74 generate a dependency closure build graph (all dependency relationships)
75
76 =item B<--fg=>I<PKGS>
77
78 Additional Packages lists that are checked and used for resolving dependencies
79 (can be repeated)
80
81 =item B<--bg=>I<PKGS>
82
83 Additional Packages lists that are NOT checked but used for resolving
84 dependencies (can be repeated)
85
86 =item B<--deb-native-arch=>I<ARCH>
87
88 Native architecture I<ARCH>
89
90 =item B<--deb-host-arch=>I<arch>
91
92 Host architecture I<arch>. Defaults to native architecture.
93
94 =item B<--deb-foreign-archs=>I<archs>
95
96 Comma-separated foreign architectures in addition to native and host
97 architectures.
98
99 =item B<--deb-ignore-essential>
100
101 By default, installing any binary package requires the coinstallation set of
102 all binary packages marked as Essential:yes to be installed as well. This
103 option drops this requirement.
104
105 =item B<--optgraph>
106
107 Calculate a dependency graph where each installation set contains the minimal
108 number of unavailable binary packages.
109
110 =back
111
112 =head1 EXAMPLE
113
114 Calculate a self-contained repository:
115
116 zcat packages | grep-dctrl -X \( -FPackage build-essential --or -FEssential yes \) > minimal
117 dose-deb-coinstall --deb-native-arch=amd64 --bg=packages --fg=minimal > minimal-amd64
118 botch-bin2src --deb-native-arch=amd64 minimal-amd64 sources > minimal-src
119 grep-dctrl -FArchitecture all packages > available
120 botch-create-graph --deb-ignore-essential -A available --deb-native-arch=amd64 --bg sources packages minimal-src > graph.xml
121 botch-buildgraph2packages graph.xml packages > min-closure
122 botch-packages-union min-closure minimal-amd64 min-closure
123 botch-bin2src --deb-native-arch=amd64 min-closure sources > min-closure-src
124 dose-builddebcheck --deb-native-arch=amd64 min-closure min-closure-src
125
126 The self-contained repository will then be I<min-closure> and
127 I<min-closure-src>.
128
129 =head1 BUGS
130
131 See L<http://bugs.debian.org/botch>.
132
133 =head1 SEE ALSO
134
135 Debian doc-base Manual F</usr/share/doc/botch/wiki/Home.html>
136
137 =head1 AUTHOR
138
139 This man page was written by Johannes Schauer. Botch is written by Johannes
140 Schauer and Pietro Abate.
141
142 =head1 COPYRIGHT
143
144 Copyright 2012-2014 Johannes Schauer, Pietro Abate
145
146 This program is free software: you can redistribute it and/or modify it under
147 the terms of the GNU Lesser General Public License as published by the Free
148 Software Foundation, either version 3 of the License, or (at your option) any
149 later version. A special linking exception to the GNU Lesser General Public
150 License applies to this library, see the COPYING file for more information.
151