{ "mode": "man", "parameter": "mass-bug", "section": "1", "url": "https://www.chedong.com/phpMan.php/man/mass-bug/1/json", "generated": "2026-05-30T06:06:27Z", "synopsis": "mass-bug [options] --subject=\"bug subject\" template package-list", "sections": { "NAME": { "content": "mass-bug - mass-file a bug report against a list of packages\n", "subsections": [] }, "SYNOPSIS": { "content": "mass-bug [options] --subject=\"bug subject\" template package-list\n", "subsections": [] }, "DESCRIPTION": { "content": "mass-bug assists in filing a mass bug report in the Debian BTS on a set of packages. For each\npackage in the package-list file (which should list one package per line together with an\noptional version number separated from the package name by an underscore), it fills out the\ntemplate, adds BTS pseudo-headers, and either displays or sends the bug report.\n\nWarning: Some care has been taken to avoid unpleasant and common mistakes, but this is still\na power tool that can generate massive amounts of bug report mails. Use it with care, and\nread the documentation in the Developer's Reference about mass filing of bug reports first.\n", "subsections": [] }, "TEMPLATE": { "content": "The template file is the body of the message that will be sent for each bug report, excluding\nthe BTS pseudo-headers. In the template, #PACKAGE# is replaced with the name of the package.\nIf a version was specified for the package, #VERSION# will be replaced by that version.\n\nThe components of the version number may be specified using #EPOCH#, #UPSTREAMVERSION# and\n#REVISION#. #EPOCH# includes the trailing colon and #REVISION# the leading dash so that\n#EPOCH#UPSTREAMVERSION##REVISION# is always the same as #VERSION#.\n\nNote that text in the template will be automatically word-wrapped to 70 columns, up to the\nstart of a signature (indicated by '-- ' at the start of a line on its own). This is another\nreason to avoid including BTS pseudo-headers in your template.\n", "subsections": [] }, "OPTIONS": { "content": "mass-bug examines the devscripts configuration files as described below. Command line\noptions override the configuration file settings, though.\n\n--severity=(wishlist|minor|normal|important|serious|grave|critical)\nSpecify the severity with which bugs should be filed. Default is normal.\n", "subsections": [ { "name": "--display", "content": "Fill out the templates for each package and display them all for verification. This is\nthe default behavior.\n", "long": "--display" }, { "name": "--send", "content": "Actually send the bug reports.\n\n--subject=\"bug subject\"\nSpecify the subject of the bug report. The subject will be automatically prefixed with\nthe name of the package that the bug is filed against.\n", "long": "--send" }, { "name": "--tags", "content": "Set the BTS pseudo-header for tags.\n", "long": "--tags" }, { "name": "--user", "content": "Set the BTS pseudo-header for a usertags' user.\n", "long": "--user" }, { "name": "--usertags", "content": "Set the BTS pseudo-header for usertags.\n\n--control=COMMAND\nAdd a BTS control command. This option may be repeated to add multiple control commands.\nFor example, if you are mass-bug-filing \"please stop depending on this deprecated\npackage\", and bug 123456 represents removal of the deprecated package, you could use:\n\nmass-bug --control='block 123456 by -1' ...\n", "long": "--usertags" }, { "name": "--source", "content": "Specify that package names refer to source packages rather than binary packages.\n\n--sendmail=SENDMAILCMD\nSpecify the sendmail command. The command will be split on white space and will not be\npassed to a shell. Default is /usr/sbin/sendmail.\n", "long": "--source" }, { "name": "--no-wrap", "content": "Do not wrap the template to lines of 70 characters.\n\n--no-conf, --noconf\nDo not read any configuration files. This can only be used as the first option given on\nthe command-line.\n", "long": "--no-wrap" }, { "name": "--help", "content": "Provide a usage message.\n", "long": "--help" }, { "name": "--version", "content": "Display version information.\n", "long": "--version" } ] }, "ENVIRONMENT": { "content": "DEBEMAIL and EMAIL can be set in the environment to control the email address that the bugs\nare sent from.\n", "subsections": [] }, "CONFIGURATION VARIABLES": { "content": "The two configuration files /etc/devscripts.conf and ~/.devscripts are sourced by a shell in\nthat order to set configuration variables. Command line options can be used to override\nconfiguration file settings. Environment variable settings are ignored for this purpose.\nThe currently recognised variables are:\n\nBTSSENDMAILCOMMAND\nIf this is set, specifies a sendmail command to use instead of /usr/sbin/sendmail. Same\nas the --sendmail command line option.\n", "subsections": [] }, "COPYRIGHT": { "content": "This program is Copyright (C) 2006 by Joey Hess .\n\nIt is licensed under the terms of the GPL, either version 2 of the License, or (at your\noption) any later version.\n", "subsections": [] }, "AUTHOR": { "content": "Joey Hess \n\n\n\nDebian Utilities 2026-03-04 MASS-BUG(1)", "subsections": [] } }, "summary": "mass-bug - mass-file a bug report against a list of packages", "flags": [ { "flag": "", "long": "--display", "arg": null, "description": "Fill out the templates for each package and display them all for verification. This is the default behavior." }, { "flag": "", "long": "--send", "arg": null, "description": "Actually send the bug reports. --subject=\"bug subject\" Specify the subject of the bug report. The subject will be automatically prefixed with the name of the package that the bug is filed against." }, { "flag": "", "long": "--tags", "arg": null, "description": "Set the BTS pseudo-header for tags." }, { "flag": "", "long": "--user", "arg": null, "description": "Set the BTS pseudo-header for a usertags' user." }, { "flag": "", "long": "--usertags", "arg": null, "description": "Set the BTS pseudo-header for usertags. --control=COMMAND Add a BTS control command. This option may be repeated to add multiple control commands. For example, if you are mass-bug-filing \"please stop depending on this deprecated package\", and bug 123456 represents removal of the deprecated package, you could use: mass-bug --control='block 123456 by -1' ..." }, { "flag": "", "long": "--source", "arg": null, "description": "Specify that package names refer to source packages rather than binary packages. --sendmail=SENDMAILCMD Specify the sendmail command. The command will be split on white space and will not be passed to a shell. Default is /usr/sbin/sendmail." }, { "flag": "", "long": "--no-wrap", "arg": null, "description": "Do not wrap the template to lines of 70 characters. --no-conf, --noconf Do not read any configuration files. This can only be used as the first option given on the command-line." }, { "flag": "", "long": "--help", "arg": null, "description": "Provide a usage message." }, { "flag": "", "long": "--version", "arg": null, "description": "Display version information." } ], "examples": [], "see_also": [] }