AUTOBUILD(1)

πŸ“¦ version 5.3, in nixos 26.05, nixpkgs unstable

πŸ’… AUTOBUILD πŸ’…

okay so bestie, welcome to autobuild β€” the manual page, the whole vibe, the whole thing. This is AUTOBUILD(1), a User Command, and it's literally about reading and parsing build logs. Yes. That's the whole personality. Let's get into it 🫢


✨ NAME ✨

autobuild β€” read and parse build logs. that's it, that's the function. iconic behavior honestly πŸ’…


🌸 SYNOPSIS 🌸

autobuild [OPTION]... FILE...

so many options, so many files, so much potential πŸ”₯


πŸ¦‹ DESCRIPTION πŸ¦‹

okay so here's what it does, no cap: autobuild reads your build logs and parses them to figure out the project name, revision, build mode, build host type, build type (that one's for cross compile builds, iykyk), hostname, and timestamp. Then it prints out a whole HTML page with all that info plus links to the logs. it's giving "i organized your entire life for you" energy πŸ‘‘

and bestie, listen: mandatory arguments to long options are mandatory for short options too. like, the rules apply both ways. periodt πŸ’€

  • --abort β€” this one's dramatic on purpose. it aborts if any of these values can't be guessed: project name, revision, host type, and build type. can't figure it out? we're not doing it. main character energy fr πŸ™ˆ
  • -n, --dry-run β€” just parse it. don't print any output. like reading the group chat but never replying. lowkey relatable 🌸
  • -s, --skip-unknown β€” skips files it can't parse. not my problem, not my files. moving on πŸ’…
  • -v, --verbose β€” explains what's being done, step by step, so you're never left wondering. it's giving narrating my own life ✨
  • -i, --inline-html β€” skips the standard HTML header and footer. you just get the goods, no packaging πŸŽ€
  • --ignore-files=STR β€” skips filenames matching the regexp STR. bye, we don't know her πŸ’€

🧚 for use when autobuild fail to guess the values properly 🧚

real talk, sometimes it just doesn't get it. happens to the best of us. that's what these are for:

  • -p, --project=STRING β€” you specify the project name. you're the boss now πŸ‘‘
  • --revision=STRING β€” you specify the project revision. put it in writing fr fr πŸ“
  • --mode=STRING β€” you specify the build mode. typically 'default', whatever that means to you πŸ¦‹
  • --hosttype=STRING β€” you specify the host type. e.g., i686-pc-linux-gnu. yes that's a real string, don't @ me 🌸
  • --buildtype=STRING β€” you specify the build type. e.g., m68k-uclinux-elf. and here's the tea: this one is different from hosttype for cross compiles. important distinction bestie, don't mix them up 🫢
  • --hostname=STRING β€” you specify the name of the host the log was created on. shoutout to the machine that did the work πŸ–₯️✨
  • --timestamp=STRING β€” you specify when the build was made. any date format will work, but honestly 'YYYY-MM-DDTHH:MM:SS' is recommended. save yourself the chaos ⏰
  • --status=STRING β€” the outcome of the build. any string will work, but "ok" and "fail" are recommended for the two basic outcomes. like yes/no but for builds, we love a binary 🌈

πŸŽ€ other options πŸŽ€

  • --help β€” displays this help and exits. when in doubt, ask for help πŸ’–
  • --version β€” outputs version information and exits. so you know exactly what you're dealing with πŸ‘‘

πŸ’œ AUTHOR πŸ’œ

Written by Simon Josefsson. we stan a legend 🫢


πŸ“£ REPORTING BUGS πŸ“£

Report bugs to <bug-autobuild@josefsson.org>. bestie if it's broken, TELL THEM. they want to know, fr fr 😭


Copyright Β© 2004, 2005, 2007, 2008, 2009, 2010 Simon Josefsson. License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>

This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law. like, none. zero. nada. don't come for them if it breaks πŸ’€


and that's the whole page! this here was autobuild (Autobuild) 5.3, dated July 2010 β€” oldie but a goodie, and honestly? still serving βœ¨πŸ¦‹πŸ’… bye bestie, go parse those logs πŸ’–

πŸ“¦ where this page comes from