ADD_BU...STRAIER(1p)

πŸ¦‹ ADD_BU...STRAIER β€” the manual page, bestie edition

okay so real talk: this is add_bug_to_estraier, a User Contributed Perl Documentation page, living in section 1p of your friendly neighbourhood perl man pages. it's a little script that takes a pile of bug logs and yeets them into an estraier database. that's the whole vibe. let's get into it πŸ’–


✨ NAME ✨

add_bug_to_estraier β€” add a bug log to an estraier database


🌸 SYNOPSIS 🌸

add_bug_to_estraier [options] < list_of_bugs_to_add

 Options:
  --url, -u url to estraier node
  --user, -U user to log into the estraier node
  --pass, -P password for the estraier node
  --spool, -s spool location
  --conf, -c addbug configuration file
  --cron add all bugs to estraier
  --timestamp bug timestamp file
  --debug, -d debugging level (Default 0)
  --help, -h display this help
  --man, -m display manual

so like. it reads the list of bugs you want to add straight from standard input 🌈 and the options go before that. classic.


πŸ’… OPTIONS πŸ’…

  • --url, -u β€” the url of the estraier node. where your index lives, basically. 🏠
  • --user,-U β€” the user you log onto the estraier node as. 🫢 (yes the original writes these two smooshed together with no space after the comma, and we respect that.)
  • --pass,-P β€” the password for logging onto the estraier node. keep it secret, keep it safe. 🀫 (also smooshed. iconic.)
  • --spool,-s β€” where the spool lives; if you don't set it, it defaults to /etc/debbugs/config. so like, that's the fallback, no cap.
  • --conf,-C β€” configuration file. it's a whole set of key = value pairs separated by newlines, and the long name of any option is the name that the configuration file takes. so --url in config-land is just... url. cute, right? (heads up: the synopsis spells this one -c, and the options list spells it -C. both are in this page. i'm just the messenger πŸŽ€)
  • --cron β€” descends through the spool and adds all of the bugs to estraier. every single one. main character energy.
  • --timestamp β€” uses the timestamp file to only add new bugs β€” and it locks the timestamp file so it doesn't race with other invocations running at the same time. polite! considerate! we love a lock. πŸ”’
  • --debug, -d β€” debug verbosity. default is 0. turn it up if you wanna see the tea β˜•
  • --help, -h β€” displays brief useage information. (their spelling, not mine, and honestly? it ate.)
  • --man, -m β€” displays this manual. hi, that's this. you're here. πŸ’œ

πŸ”₯ EXAMPLES πŸ”₯

test_bts --bug 7 --host donbugs.donarmstrong.com

just a lil one-liner showing the vibe. yes it's test_bts and not add_bug_to_estraier, no i will not be taking questions, it's exactly what the page says ✨


πŸ‘‘ DATABASE CREATION πŸ‘‘

this is the spell you cast to actually make the estraier database, and it's long so hold my hand:

estcmd create -si -xh3 -attr status str -attr subject str \
    -attr date num -attr submitter str -attr package str \
    -attr severity str -attr tags str bts

look at those attributes. status, subject, date, submitter, package, severity, tags. a full lil roster of searchable fields, as a treat 🌸


heads up bestie: --spool silently defaults to /etc/debbugs/config if you don't set it, and --debug silently defaults to 0. nothing scary, just know that's what happens when you say nothing.

okay that's the whole page!! no skips, no omissions, we kept every flag and every line πŸ’–

this manual came to you from the User Contributed Perl Documentation collection, written against perl v5.40.1, dated 2026-04-27. mwah, go add some bugs to estraier, you're gonna slay πŸŽ€πŸ’…πŸ¦‹

πŸ“¦ where this page comes from