input/doc/schroot.mdwn

   1 using schroot in debian.org porterboxes
   2 =======================================
   3
   4 When logging into Debian porterbox machine:
   5
   6 * List available chroots:
   7 <pre><code>
   8         $ schroot -l
   9 </code></pre>
  10
  11 * Begin a persistent schroot session on Debian unstable:
  12 <pre><code>
  13         $ schroot -b -c sid -n mysid
  14 </code></pre>
  15
  16 * Update and upgrade Debian unstable chroot:
  17 <pre><code>
  18         $ dd-schroot-cmd -c mysid apt-get update
  19         $ dd-schroot-cmd -c mysid apt-get upgrade
  20         [..]
  21         Do it for real [Y/n]: <Enter>
  22         [..]
  23 </code></pre>
  24
  25 * Install your broken package build dependencies:
  26 <pre><code>
  27         $ dd-schroot-cmd -c mysid apt-get build-dep gentoo
  28         [..]
  29         Do it for real [Y/n]: <Enter>
  30         [..]
  31 </code></pre>
  32
  33 * Change root to Debian unstable chroot:
  34 <pre><code>
  35         $ schroot -r -c mysid
  36 </code></pre>
  37
  38 * Download your broken package source:
  39 <pre><code>
  40         (sid_arch-dchroot)user@porterbox:~$ apt-get source gentoo
  41 </code></pre>
  42
  43 * You should be able to reproduce your issue, hack on the package, fix the bug. Once you are done with your work, please, finish your schroot session:
  44 <pre><code>
  45         (sid_arch-dchroot)user@porterbox:~$ exit
  46         $ schroot -e -c mysid
  47         $ exit
  48 </code></pre>
  49
  50 * List (your) open sessions:
  51 <pre><code>
  52         $ schroot --list --all-sessions
  53 or
  54         $ schroot-list-sessions
  55 </code></pre>
  56
  57 * You should be done by now. If you find any issue, please report to debian-admin@lists.debian.org.