svn commit: r246977 - in user/bugmeister/gnats: gnats-adm public_html

Mark Linimon linimon at FreeBSD.org
Tue Feb 19 02:51:34 UTC 2013


Author: linimon (doc,ports committer)
Date: Tue Feb 19 02:51:31 2013
New Revision: 246977
URL: http://svnweb.freebsd.org/changeset/base/246977

Log:
  Checkpoint of GNATS metadata from production on freefall.freebsd.org.
  In theory these correspond to the checked-in versions elsewhere.

Added:
  user/bugmeister/gnats/gnats-adm/
  user/bugmeister/gnats/gnats-adm/addresses
  user/bugmeister/gnats/gnats-adm/categories
  user/bugmeister/gnats/gnats-adm/classes
  user/bugmeister/gnats/gnats-adm/config
  user/bugmeister/gnats/gnats-adm/edit-pr-msg
  user/bugmeister/gnats/gnats-adm/gnatsd.access
  user/bugmeister/gnats/gnats-adm/gnatsd.conf   (contents, props changed)
  user/bugmeister/gnats/gnats-adm/responsible
  user/bugmeister/gnats/gnats-adm/states
  user/bugmeister/gnats/gnats-adm/submitters
  user/bugmeister/gnats/public_html/
  user/bugmeister/gnats/public_html/index.html   (contents, props changed)
  user/bugmeister/gnats/public_html/procedure.html   (contents, props changed)

Added: user/bugmeister/gnats/gnats-adm/addresses
==============================================================================
--- /dev/null	00:00:00 1970	(empty, because file is newly added)
+++ user/bugmeister/gnats/gnats-adm/addresses	Tue Feb 19 02:51:31 2013	(r246977)
@@ -0,0 +1,12 @@
+#	Use this file to store mappings between submitter IDs and their
+#	senders' email addresses.
+#
+#	Entries are of the form:
+#
+#submitter-id:address-fragment
+#
+#	where submitter-id is a valid submitter ID, and address-fragment
+#	is a full or partial e-mail address.  Fragments are compared to the
+#	end of the "From:" header of a Problem Report.  GNATS ignores the
+#	trailing ">" of an incoming e-mail address, so you don't need to
+#	include it in an address fragment.

Added: user/bugmeister/gnats/gnats-adm/categories
==============================================================================
--- /dev/null	00:00:00 1970	(empty, because file is newly added)
+++ user/bugmeister/gnats/gnats-adm/categories	Tue Feb 19 02:51:31 2013	(r246977)
@@ -0,0 +1,46 @@
+#                   Possible categories for a PR.
+#
+# Any line which begins with a `#' is considered a comment, and GNATS
+# will ignore it.
+#
+# Each entry has the format:
+#
+#       category:description:responsible:notify
+#
+# * `category' is the name of the classification for the PR.
+# * `description' can be a normal text description for the
+#   category, like "Development Tools" for the `tools' category.
+# * `responsible' gives the name (which can be found in the remote
+#   file) of the person who will be given responsibility for any PR
+#   appearing in this category.
+# * `notify' are other email addresses which should be given copies of
+#    any PR in this category.
+#
+# The following category is mandatory for GNATS to work.
+#
+pending: Misfiled PRs : gnats-admin : freebsd-bugbusters at freebsd.org
+#
+# Other categories
+#
+advocacy: Advocacy : freebsd-advocacy :
+alpha: Architecture (alpha) specific : freebsd-alpha :
+amd64: Architecture (amd64) specific : freebsd-amd64 :
+arm: Architecture (arm) specific : freebsd-arm :
+bin: All other sources : freebsd-bugs :
+conf: Configuration files : freebsd-bugs :
+docs: Documentation : freebsd-doc :
+gnu: GNU sources : freebsd-bugs :
+i386: Architecture (i386) specific : freebsd-i386 :
+ia64: Architecture (ia64) specific : freebsd-ia64 :
+java: Java support : freebsd-java :
+junk: Wastebin : gnats-admin :
+kern: Kernel sources : freebsd-bugs :
+misc: Miscellaneous : freebsd-bugs :
+ports: The ports collection : freebsd-ports-bugs :
+powerpc: Architecture (powerpc) specific : freebsd-ppc :
+sparc64: Architecture (sparc) specific : freebsd-sparc64 :
+standards: Standards conformance issues : freebsd-standards :
+sun4v: Architecture (sun4v) specific : freebsd-sparc64 :
+threads: Threading issues : freebsd-threads :
+usb: USB issues: freebsd-usb :
+www: FreeBSD website : freebsd-www :

Added: user/bugmeister/gnats/gnats-adm/classes
==============================================================================
--- /dev/null	00:00:00 1970	(empty, because file is newly added)
+++ user/bugmeister/gnats/gnats-adm/classes	Tue Feb 19 02:51:31 2013	(r246977)
@@ -0,0 +1,43 @@
+#		    Possible classes for a PR.
+#
+# Any line which begins with a `#' is considered a comment, and GNATS
+# will ignore it. 
+#
+# Each entry has the format:
+#
+# 	class[:type[:description]]
+#
+# that is, either of the following is okay:
+#
+#	sw-bug
+#	sw-bug:class
+#	sw-bug:class:Software bug
+#	sw-bug::Software bug
+#
+# * `class' is the name of the class; it can contain alphanumerics,
+#   "-", "_", and ".", but no other characters.
+#
+# * `type' is the optional name of the class type; it can contain
+#   alphanumerics, "-", "_", and ".", but no other characters. The
+#   only defined class type is "class", but it's not actually used 
+#   for anything.
+#
+#   `description' is an optional one-line description of what this
+#   class means.  Any character is okay in the description; a newline
+#   ends it, however.  GNATS does not currently use the description,
+#   other than to include it in the --list-classes command, but
+#   certain external tools (such as TkGnats) look for it, so it's
+#   a good idea include one for every class.
+#
+# The first listed class is the default class for an incoming Problem
+# Report.
+
+sw-bug::Problem requiring a correction to software.
+doc-bug::Problem requiring a correction or improvement in documentation.
+support::A support problem or question.
+change-request::Suggested change in functionality.
+mistaken::Not a problem, bad PR submission.
+duplicate::Duplicate of another existing PR.
+wish::A wishlist request.
+update::Non-maintainer request to update/change software.
+maintainer-update::Maintainer request to update/change software.

Added: user/bugmeister/gnats/gnats-adm/config
==============================================================================
--- /dev/null	00:00:00 1970	(empty, because file is newly added)
+++ user/bugmeister/gnats/gnats-adm/config	Tue Feb 19 02:51:31 2013	(r246977)
@@ -0,0 +1,16 @@
+GNATS_ADDR="FreeBSD-gnats-submit at FreeBSD.org"
+GNATS_USER="gnats"
+GNATS_ADMIN="gnats-admin"
+GNATS_SITE="freefall"
+SUBMITTER="current-users"
+DEFAULT_RELEASE="FreeBSD-2.0"
+DEFAULT_ORGANIZATION="FreeBSD"
+NOTIFY=1
+ACKNOWLEDGE=1
+DEFAULT_SUBMITTER="current-users"
+KEEP_RECEIVED_HEADERS=1
+BDAY_START=8
+BDAY_END=17
+BWEEK_START=1
+BWEEK_END=5
+DEBUG_MODE=0

Added: user/bugmeister/gnats/gnats-adm/edit-pr-msg
==============================================================================
--- /dev/null	00:00:00 1970	(empty, because file is newly added)
+++ user/bugmeister/gnats/gnats-adm/edit-pr-msg	Tue Feb 19 02:51:31 2013	(r246977)
@@ -0,0 +1,3 @@
+
+GNATS: Enter the reason for changing this PR's %%ITEM%% here.
+GNATS: Lines beginning with "GNATS:" will be deleted.

Added: user/bugmeister/gnats/gnats-adm/gnatsd.access
==============================================================================
--- /dev/null	00:00:00 1970	(empty, because file is newly added)
+++ user/bugmeister/gnats/gnats-adm/gnatsd.access	Tue Feb 19 02:51:31 2013	(r246977)
@@ -0,0 +1,31 @@
+#
+#                  User access levels with the GNATS daemon.
+#
+# Any line which begins with a `#' is considered a comment, and GNATS
+# will ignore it. 
+#
+# Each entry has the format:
+# 
+#	userid:password:access-level:database-alias
+#
+#       Wildcard characters are supported for userid, password and database.
+#            "*" matches anything; "?" matches any single character
+#
+#       * userid:   a user id to gain access to gnatsd
+#       * password: a password for the user
+#       * access-level: (default = edit)
+#               deny     - gnatsd closes the connection
+#               none     - no further access until userid and password given
+#               view     - query and view PRs with Confidential=no only
+#               viewconf - query and view PRs with Confidential=yes
+#               edit     - full edit  access
+#               admin    - full admin access (not currently used)
+#         This overrides (increases but never lowers) the access level given
+#         as the default for the user's host in the /etc/gnatsd.conf file.
+#       * database-alias: a comma-separated list of database aliases to
+#         match alias entries from the second field of the database file
+#         /etc/gnats-db.conf. This field is only used in /etc/gnatsd.access.
+#         It's ignored in gnatsd-adm/gnatsd.access since this file is already
+#         database specific.
+#
+#*:*:view:

Added: user/bugmeister/gnats/gnats-adm/gnatsd.conf
==============================================================================
--- /dev/null	00:00:00 1970	(empty, because file is newly added)
+++ user/bugmeister/gnats/gnats-adm/gnatsd.conf	Tue Feb 19 02:51:31 2013	(r246977)
@@ -0,0 +1,2 @@
+localhost:edit:
+freefall.freebsd.org:edit:

Added: user/bugmeister/gnats/gnats-adm/responsible
==============================================================================
--- /dev/null	00:00:00 1970	(empty, because file is newly added)
+++ user/bugmeister/gnats/gnats-adm/responsible	Tue Feb 19 02:51:31 2013	(r246977)
@@ -0,0 +1,40 @@
+#
+#		  People responsible for a given PR.
+#
+# Any line which begins with a `#' is considered a comment, and GNATS
+# will ignore it. 
+#
+# Each entry has the format:
+#
+#	person:full name:address
+#
+# * The `person' can either be an abbreviated name, or the person's
+#   username (local to the GNATS site) which should be listed in the PR.
+# * The `full name' is simply their name, as in "Diane Williams".
+# * The `address' field is either empty for local addresses, or should
+#   the electronic mail address of the person.
+#
+# You MUST have this entry for GNATS to work.
+#
+gnats-admin: GNATS administrator:
+#
+# Local changes
+#
+core: FreeBSD core team:
+freebsd-advocacy: FreeBSD advocacy mailing list:
+freebsd-alpha: FreeBSD Alpha mailing list:
+freebsd-amd64: FreeBSD amd64 mailing list:
+freebsd-arm: FreeBSD arm mailing list:
+freebsd-bugs: FreeBSD bugs mailing list:
+freebsd-doc: FreeBSD doc mailing list:
+freebsd-i386: FreeBSD i386 mailing list:
+freebsd-ia64: FreeBSD IA64 mailing list:
+freebsd-java: FreeBSD Java mailing list:
+freebsd-ports-bugs: FreeBSD ports mailing list:
+#freebsd-powerpc: FreeBSD PowerPC mailing list:
+freebsd-sparc64: FreeBSD Sparc mailing list:
+freebsd-standards: FreeBSD Standards mailing list:
+freebsd-threads: FreeBSD Threads mailing list:
+freebsd-usb: FreeBSD USB mailing list:
+freebsd-www: FreeBSD WWW mailing list:
+cvs: FreeBSD Repomeisters:

Added: user/bugmeister/gnats/gnats-adm/states
==============================================================================
--- /dev/null	00:00:00 1970	(empty, because file is newly added)
+++ user/bugmeister/gnats/gnats-adm/states	Tue Feb 19 02:51:31 2013	(r246977)
@@ -0,0 +1,67 @@
+#		    Possible states for a PR.
+#
+# Any line which begins with a `#' is considered a comment, and GNATS
+# will ignore it. 
+#
+# Each entry has the format:
+#
+# 	state[:type[:description]]
+#
+# that is, any of the following are okay:
+#
+#	suspended
+#	suspended:closed
+#	suspended:closed:No solution yet, work on it also suspended for the time being.
+#	suspended::No solution yet, work on it also suspended for the time being.
+#
+# * `state' is the name of the state; it can contain alphanumerics,
+#   "-", "_", and ".", but no other characters.
+#
+# * `type' is the optional name of the state type; it can contain
+#   alphanumerics, "-", "_", and ".", but no other characters. The
+#   only defined state types are "open" and "closed". The "open" state
+#   isn't currently used for anything. Changing the state of a PR to
+#   any state of type "closed" will set the Closed-Date field with a
+#   time stamp. Changing the state of a PR from one "closed" state to
+#   another will leave the Closed-Date field as it was. Changing the
+#   state of a PR from any state of type "closed" to a non-closed
+#   state will clear the Closed-Date field.  The "--skip-closed"
+#   option of query-pr and nquery-pr looks at the state types for the
+#   "closed" type, not for a state name of "closed".
+#
+#   `description' is an optional one-line description of what this
+#   state means.  Any character is okay in the description; a newline
+#   ends it, however.  GNATS does not currently use the description,
+#   other than to include it in the --list-states command, but certain
+#   external tools (such as TkGnats) look for it, so it's a good
+#   idea include one for every state.
+#
+# The first listed state is the default state for an incoming Problem
+# Report.  The last listed state is considered one of the final
+# ("closed") states for a Problem Report and will be forced to have a
+# type of "closed". Once a PR is in this state, its life-cycle is
+# usually over unless someone re-opens it.
+
+# It is recommended that the first state always be "open", as some
+# external tools may look for this to determine whether or not a PR
+# has been acted on.  Change at your own risk.
+
+open::Default state for a new problem report.
+
+# The middle states are what you think is useful; customize them as
+# you wish.  You can add or delete states here; it is not required
+# that there be three of them. Depending on your definition of the
+# suspended state, you may want to set its type to be "closed".
+
+analyzed::The problem is understood and a solution is being sought.
+suspended::Valid, but suspended due to lack of information or resources.
+feedback::Awaiting further information from originator or community.
+patched::Patch committed, awaiting MFC and / or further testing.
+repocopy::Awaiting a repocopy before further action can be taken.
+
+# Where old PRs go to die.  Like "open", there may be external tools
+# which look for this state to know if a PR is still active.  Change
+# at your own risk. The last state will be forced to be a "closed" type
+# even if you specify something else.
+
+closed:closed:Issue has been resolved or abandoned.

Added: user/bugmeister/gnats/gnats-adm/submitters
==============================================================================
--- /dev/null	00:00:00 1970	(empty, because file is newly added)
+++ user/bugmeister/gnats/gnats-adm/submitters	Tue Feb 19 02:51:31 2013	(r246977)
@@ -0,0 +1,27 @@
+#
+#		    submitters database for GNATS
+#
+# Any line which begins with a `#' is considered a comment, and GNATS
+# will ignore it. 
+#
+# Each entry has the format:
+# 
+#	submitter:full submitter name:type:response-time:contact:notify-others
+#
+#	* submitter: The name of the site, customer, etc., sending the
+#	  report in.
+#	* full submitter name: The description, like `Foo Widgets Inc.'.
+#	* submitter type: Can be contract type, level of expertise, etc.
+#	* response time: If configured with `NOTIFY' set to `TRUE', GNATS
+#	  will use this field to schedule when at_pr should notify the
+#	  gnats-admin and gnats-manager that the PR wasn't analyzed
+#	  within the agreed response time.
+#	* contact: Principal contact for the submitter.
+#	* notify: Others who should be Cc'd on any PRs coming from
+#	  this submitter.
+#
+#
+# The following submitter is mandatory for GNATS to work.
+# The submitter field should be the same as your configured DEFAULT_SUBMITTER.
+#
+current-users:Submitted from a FreeBSD-current user:none:-1::

Added: user/bugmeister/gnats/public_html/index.html
==============================================================================
--- /dev/null	00:00:00 1970	(empty, because file is newly added)
+++ user/bugmeister/gnats/public_html/index.html	Tue Feb 19 02:51:31 2013	(r246977)
@@ -0,0 +1,8 @@
+<html>
+  <head>
+   <title>Gnats</title>
+  </head>
+  <body>
+    <h1>Gnats</h1>
+  </body>
+</html>

Added: user/bugmeister/gnats/public_html/procedure.html
==============================================================================
--- /dev/null	00:00:00 1970	(empty, because file is newly added)
+++ user/bugmeister/gnats/public_html/procedure.html	Tue Feb 19 02:51:31 2013	(r246977)
@@ -0,0 +1,36 @@
+<html>
+  <head>
+    <title>Maintenance Procedure</title>
+  </head>
+  <body>
+    <h1>Gnats Maintenance Procedures</h1>
+
+    <p>Before any maintenance is performed on Gnats, the following steps
+      must be taken to prevent database corruption:</p>
+
+    <ul>
+      <li>Stop the queue and any cron'ed maintenance tasks by commenting out
+        the contents of the <tt>gnats</tt> user's <tt>crontab</tt>.</li>
+
+      <li>Make sure the <tt>gnats-adm/locks</tt> directory is empty, then
+        <tt>chmod 0</tt> it to disable <tt>edit-pr(1)</tt>.</li>
+
+      <li>Take a complete backup of the Gnats database, in case something
+        goes wrong.</li>
+    </ul>
+
+    <p>If you need to restore the database from backup, <b>take care not to
+      clobber the queue directory!</b></p>
+
+    <p>Once maintenance is complete, the database needs to be unfrozen so
+      work on it can resume:</p>
+
+    <ul>
+      <li>Re-enable <tt>edit-pr(1)</tt> by setting the lock directory's
+        access mode back to 0755.</li>
+
+      <li>Restart the queue by un-commenting the <tt>gnats</tt> user's
+        <tt>crontab</tt>.</li>
+    </ul>
+  </body>
+</html>


More information about the svn-src-user mailing list