input/doc/schroot.mdwn

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