states.txt

   1 ====DRAFT====
   2
   3 States a package could be in
   4
   5 After a source package is uploaded (or, equivalently, a binNMU is
   6 scheduled), the corresponding package in the wanna-build database enters
   7 into the transient states (or Auto-Not-For-Us, or Installed if the binary
   8 package is uploaded together with the source package), till it reaches an
   9 final state.
  10
  11 States are considered different whether they might be changed by software
  12 depending on other packages or because a buildd pickes it up ("transient
  13 states"), or whether they are only left by explicit human decision or
  14 upload of the same package (i.e. change of the source version or the binNMU
  15 version) ("final states").
  16
  17
  18 Transient states
  19 ================
  20
  21 If a package is said to enter the transient states, it is always put to
  22 needs-build or bd-uninstallable. Even if the package was previously in
  23 another transient state, it is considered "entering". Upload of a new
  24 version of a package makes it entering the transient state, as well as
  25 scheduling an binNMU.
  26
  27 On entering the transient state all temporary build-priorities, extra
  28 conflicts and depends are removed.
  29
  30
  31 needs-build
  32 bd-uninstallable
  33 ~~~~~~~~~~~~~~~~
  34 The initial state of any package. Which of the two states is choosen only
  35 depends on the buildability of the package, and may change often.
  36
  37 building
  38 ~~~~~~~~
  39 packages from needs-build are picked up from the buildd and move into the
  40 building state. Packages from building might be given back on problems on
  41 the buildd itself, and go back into needs-build/bd-uninstallable. Packages
  42 in building might also short-cut into uploaded, installed or failed (i.e.
  43 the states built, build-attempted and uploaded are technical spoken
  44 optional).
  45
  46 built
  47 ~~~~~
  48 packages are marked built automatically if the buildd is satisfied with the
  49 build of the package. Built is only reached from building, and exited
  50 usually to uploaded or installed.
  51
  52 uploaded
  53 ~~~~~~~~
  54 packages are marked uploaded by buildd-uploader once they are transfered to
  55 the relevant archive server or upload queue (e.g. ftp-master.d.o).
  56
  57 build-attempted
  58 ~~~~~~~~~~~~~~~
  59 packages are marked build-attempted automatically if the buildd is not
  60 satisfied with the build of the package. build-attempted is only reached
  61 from building, and exited usually to failed (or not at all, i.e. it's quite
  62 often an de-facto final state).
  63
  64 dep-wait
  65 ~~~~~~~~
  66 Packages from an transient state could be marked as "dep-wait" if they
  67 should only be built after an certain version of another package is
  68 available. This happens usually for binNMUs.
  69
  70
  71
  72 Final states
  73 ============
  74
  75 Installed
  76 ~~~~~~~~~
  77 After a package is the same in source and binary version, it is marked as
  78 Installed. This state is usually left as a new source package is uploaded,
  79 or a binNMU is scheduled, when the package enters the transient states.
  80
  81 Not-For-Us
  82 ~~~~~~~~~~
  83 Packages are marked by hand that they shouldn't be built. This state is
  84 only left by explicit marking a package as for-us, and not when a new
  85 version is uploaded.
  86
  87 Auto-Not-For-Us
  88 ~~~~~~~~~~~~~~~
  89 Packages are not to be considered for building due to being marked as such
  90 in the source package arch list, in the Packages-arch-specific file or if
  91 all potential binary packages are overwritten by newer arch-all-packages.
  92 This state is entered directly on upload of an source package, and only
  93 left with a new version which includes the architecture, or by removing the
  94 package from Packages-arch-specific.
  95
  96 Failed
  97 ~~~~~~
  98 packages are marked failed by buildd admins decision usually, if they
  99 haven't built sucessfully and need an bug fix or porting. This state is
 100 left with a new source version, and packages enter the transient state.