Debian Codegraph @

doc/man/botch-build-fixpoint.pod

raw
1 =head1 NAME
2
3 botch-build-fixpoint - find build order until dependency cycles occur
4
5 =head1 SYNOPSIS
6
7 =over
8
9 =item B<botch-build-fixpoint> [options] B<--available=>I<AvailablePackages> I<Packages..> I<Sources>
10
11 =back
12
13 =head1 DESCRIPTION
14
15 Given a list of source packages I<Sources>, return the list of binary packages
16 that can be built without having to break a dependency cycle. The algorithm
17 repeatedly attempts to satisfy build dependencies of all source packages using
18 the available binary packages from I<AvailablePackages> and adds the binary
19 packages of those source packages that satisfy their build dependencies to the
20 set of available binary packages.
21
22 =head1 OPTIONS
23
24 =over 4
25
26 =item B<--version>
27
28 show program's version and exit
29
30 =item B<-h, --help>
31
32 show this help message and exit
33
34 =item B<-v, --verbose>
35
36 print additional information
37
38 =item B<--quiet>
39
40 do no print any messages
41
42 =item B<-A, --available=>I<AvailablePackages>
43
44 List of available packages (arch:all, crossed...) in control file format
45 (setting this argument is required). Packages in this list have to be part of
46 I<Packages>.
47
48 =item B<--deb-drop-b-d-indep>
49
50 Drop Build-Depends-Indep dependencies
51
52 =item B<--deb-drop-b-d-arch>
53
54 Drop Build-Depends-Arch dependencies
55
56 =item B<--allowsrcmismatch>
57
58 If a binary package is without a source package but there is a source package
59 of same name but different version, match this binary package to that source
60 package.
61
62 =item B<--output-order=>I<FILE>
63
64 instead of stderr, write the calculated build order to this file.
65
66 =item B<--fg=>I<PKGS>
67
68 Additional Packages lists that are checked and used for resolving dependencies
69 (can be repeated)
70
71 =item B<--bg=>I<PKGS>
72
73 Additional Packages lists that are NOT checked but used for resolving
74 dependencies (can be repeated)
75
76 =item B<-o, --outfile=>I<FILE>
77
78 Set the output file I<FILE>
79
80 =item B<--deb-native-arch=>I<ARCH>
81
82 Native architecture I<ARCH>
83
84 =item B<--deb-host-arch=>I<arch>
85
86 Host architecture I<arch>. Defaults to native architecture.
87
88 =item B<--deb-foreign-archs=>I<archs>
89
90 Comma-separated foreign architectures in addition to native and host
91 architectures.
92
93 =back
94
95 =head1 EXAMPLE
96
97 Calculate the source packages that can be built in a given state:
98
99 botch-build-fixpoint --deb-native-arch=amd64 --available packages-arch-all --output-order=order.lst packages sources
100
101 =head1 BUGS
102
103 See L<http://bugs.debian.org/botch>.
104
105 =head1 SEE ALSO
106
107 Debian doc-base Manual F</usr/share/doc/botch/wiki/Home.html>
108
109 =head1 AUTHOR
110
111 This man page was written by Johannes Schauer. Botch is written by Johannes
112 Schauer and Pietro Abate.
113
114 =head1 COPYRIGHT
115
116 Copyright 2012-2014 Johannes Schauer, Pietro Abate
117
118 This program is free software: you can redistribute it and/or modify it under
119 the terms of the GNU Lesser General Public License as published by the Free
120 Software Foundation, either version 3 of the License, or (at your option) any
121 later version. A special linking exception to the GNU Lesser General Public
122 License applies to this library, see the COPYING file for more information.
123