BOTCH-CROSS(1)

πŸ’… BOTCH-CROSS(1) β€” the botch tools, cross phase edition ✨

okay bestie, so this is botch-cross, part of the botch tools squad, and she runs the botch tools in the cross phase. yes she's that girl. let's get into it πŸŽ€


🌸 NAME 🌸

botch-cross β€” execute botch tools in the cross phase. that's it, that's the whole job, and she does it flawlessly πŸ’–


✨ SYNOPSIS ✨

botch-cross [options] [buildarch hostarch buildpackages sources]

those last four are optional positional besties, they get passed along. don't overthink it πŸ¦‹


🫢 DESCRIPTION 🫢

so like, the whole point is: use the botch tools to analyze the cross bootstrap phase. that's the vibe. that's the mission. she coordinates the whole lil pipeline for you πŸ’…


πŸ‘‘ OPTIONS πŸ‘‘

one bullet per flag, no skips, no cap:

  • -h, --help β€” show the help message. the classic. the "wait what does this do again" button πŸ™ˆ
  • -k, --keep β€” keep the temporary files. normally they'd get yeeted, but with this she holds onto them πŸ’€
  • -w, --online β€” produce stat.html for online consumption. it's giving web-ready 🌈
  • -o, --output=DIR β€” output directory. default is the current directory, so if you don't say anything she just drops everything right where you're standing πŸŽ€
  • -t, --tmp=DIR β€” temporary directory. default is created by mktemp(1) ✨
  • -G, --optgraph β€” calculate a dependency graph where each installation set contains the minimal number of unavailable binary packages. yes she's optimizing, she's that girl πŸ”₯
  • -T, --timers β€” time all program executions. stopwatch energy ⏱️
  • -m, --allowsrcmismatch β€” allow binary packages to be associated with a source package of a different version than themselves. letting the mismatched girlies through πŸ¦‹
  • -e, --ignoresrclessbin β€” ignore binary packages without a source package. if you got no source, you're not invited to this party πŸ’…
  • -b, --sapsb β€” calculate strong articulation points and bridges. graph theory main character moment πŸ‘‘
  • -I, --deb-drop-b-d-indep β€” drop Build-Depends-Indep dependencies. gone, reduced to atoms πŸ“
  • -v, --verbose β€” be more verbose. she starts yapping (lovingly) 🌸
  • -d, --debug β€” maximum verbosity. full yap mode, no filter, everything πŸ’œ
  • -D, --develop β€” execute tools from the source checkout instead of $PATH. dev mode activated, we're not using the installed ones, we're going straight to the source πŸ’–

πŸŽ€ FILES πŸŽ€

the following files are created in the output directory. brace yourself bestie, it's a whole little family:

  • buildgraph_acyclic.xml β€” the output of botch-profile-build-fvs.
  • buildgraph.xml β€” the output of botch-create-graph.
  • cross.json β€” the output of botch-dose2html.
  • cyclic_src:*.xml β€” the strongly connected components created by botch-extract-scc.
  • fas β€” the standard output of botch-extract-scc.
  • feedback_vertex_set.list β€” the concatenated output of multiple runs of botch-find-fvs.
  • ma.diff β€” the output of botch-ma-diff.
  • order1.lst β€” the output of botch-build-fixpoint.
  • order2.lst β€” the output of botch-partial-order.
  • remove.list β€” the output of botch-fasofstats.
  • srcgraph_acyclic.xml β€” buildgraph_acyclic.xml converted by botch-buildgraph2srcgraph.
  • srcgraph.xml β€” buildgraph.xml converted by botch-buildgraph2srcgraph.
  • stats.html β€” the standard output of botch-stat-html
  • stats.json β€” the JSON output of botch-stat-html
heads up: yes, stats.html and stats.json are missing their trailing periods in the original. we keep it exactly as it is, we don't editorialize, periodt. πŸ’…

πŸ’€ BUGS πŸ’€

found something cursed? see <http://bugs.debian.org/botch>. go tell them, they'll handle it 🫢


🌈 SEE ALSO 🌈

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

iykyk πŸ“–βœ¨


πŸ’œ AUTHOR πŸ’œ

this man page was written by Johannes Schauer. Botch is written by Johannes Schauer and Pietro Abate. legends, both of them πŸ‘‘


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. open source girlies stay winning πŸ†


and that's the whole page bestie!! this was perl v5.36.0, dated 2023-02-17, from the botch tools household β€” tysm for reading, mwah πŸ’‹πŸ’–

πŸ“¦ where this page comes from