botch(1)

NAME
botch - bootstrap/build order tool chain

DESCRIPTION
botch is a collection of tools to create and analyze dependency graphs. This task is facilitated by a range of individual tools which use the deb822 and graphml formats to exchange information with each other.

Also consider browsing the HTML based doc-base Manual at /usr/share/doc/botch/wiki/Home.html

The tools that botch ships allow one to:

set operations on Packages or Sources files
    botch-packages-difference: calculate the asymmetric set difference
    botch-packages-intersection: calculate the set intersection
    botch-packages-union: calculate the set union
transform Packages and Sources control files
    botch-latest-version: only keep the latest version
    botch-bin2src: convert binary packages to their source packages
    botch-src2bin: turn source packages into their binary packages
    botch-clean-repository: clean errors in a repository by removing transitively uninstallable or compilable packages
    botch-add-arch: add architecture to source packages
    botch-convert-arch: convert the architecture of a Packages file
    botch-remove-virtual-disjunctions: remove virtual dependency disjunctions
    botch-optuniv: self contained repository with minimal number of source packages
    botch-fix-cross-problems: fix Packages files with the output of botch-cross-problems
    botch-filter-src-builds-for: filter a Sources file for the packages building for a certain architecture
analysis of Packages and Sources control files
    botch-packages-diff: create a diff between two Packages or Sources files
    botch-ma-diff: diff two packages files for differences in their multiarch values
    botch-apply-ma-diff: applies a multiarch diff as created by botch-ma-diff
    botch-check-ma-same-versions: check if Multi-Arch:same versions are in sync
create graphs of different types
    botch-create-graph: create graph based on installation sets, strong dependency sets or dependency closures
    botch-annotate-strong: add strong dependency information to a dependency graph
conversion of graphs
    botch-buildgraph2srcgraph: converts a buildgraph into a srcgraph
    botch-graphml2dot: converts graphml to dot
    botch-collapse-srcgraph: make a srcgraph acyclic by collapsing its strongly connected components
    botch-profile-build-fvs: remove droppable dependencies from graph
    botch-buildgraph2packages: convert buildgraph to packages
    botch-graph-tred: find the transitive reduction of a graph in GraphML or dot format
    botch-graph2text: for each vertex in a graph print a formatted line on standard output
extract regions from graphs
    botch-graph-neighborhood: extract the neighborhood around a vertex
    botch-extract-scc: extract all strongly connected components
    botch-graph-ancestors: find all ancestors of a vertex in a graph in GraphML or dot format
    botch-graph-descendants: find all descendants of a vertex in a graph in GraphML or dot format
    botch-graph-shortest-path: find the shortest path(s) between two vertices of a graph in GraphML or dot format
    botch-graph-sinks: find all sinks (vertices without successors) in a graph in GraphML or dot format
    botch-graph-sources: find all sources (vertices without predecessors) in a graph in GraphML or dot format
dose3 wrappers
    botch-dose2html: turn the yaml output by dose-builddebcheck into html
    botch-buildcheck-more-problems: a tool like dose-builddebcheck but return more than the first reason
    botch-distcheck-more-problems: a tool like dose-distcheck but return more than the first reason
analyze graphs
    botch-calcportsmetric: calculate source package importance
    botch-calculate-fas: calculate a feedback arc set
    botch-find-fvs: calculate a feedback vertex set
    botch-graph-difference: graph diff
    botch-graph-info: show info about a buildgraph or sourcegraph
    botch-partial-order: calculate the partial vertex order
    botch-print-stats: find cycles, selfcycles, amount of cycles through edges, feedback arc and vertex set, strong articulation points and bridges
    botch-multiarch-interpreter-problem: find all arch:all packages that allow switching architectures
create build orders
    botch-build-fixpoint: find build order until dependency cycles occur
    botch-build-order-from-zero: find a build order for a non-existing architecture
    botch-wanna-build-sortblockers: importance of source packages for ports
handling of botch-internal formats
    botch-stat-html: turn the JSON output of botch-print-stats into human readable HTML
    botch-droppable-diff: difference between two *.droppable files
    botch-droppable-union: union of two *.droppable files
    botch-checkfas: check which edges in the fas are not droppable
    botch-fasofstats: extract feedback arc set from output of botch-print-stats
    botch-download-pkgsrc: download Packages and Sources
shell scripts connecting the tools for meaningful operations
    botch-cross: execute botch tools in the cross phase
    botch-native: execute botch tools in the native phase
    botch-transition: calculate a transition order
    botch-y-u-no-bootstrap: Find out why Debian cannot be bootstrapped.
    botch-y-u-b-d-transitive-essential: Find out why source packages are B-D transitive essential.

SEE ALSO
Debian doc-base Manual /usr/share/doc/botch/wiki/Home.html

AUTHOR
This man page was written by Johannes Schauer. Botch is written by Johannes Schauer and Pietro Abate.

COPYRIGHT
Copyright 2012-2014 Johannes Schauer, Pietro Abate

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. A special linking exception to the GNU Lesser General Public License applies to this library, see the COPYING file for more information.