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         # Pick your own session name:
  14         $ echo -n "Session ID: " && read sessionid && schroot -b -c sid -n $sessionid
  15         # or use a random one:
  16         $ sessionid=$(schroot -b -c sid)
  17 </code></pre>
  18
  19 * Update and upgrade Debian unstable chroot:
  20 <pre><code>
  21         $ dd-schroot-cmd -c $sessionid apt-get update
  22         $ dd-schroot-cmd -c $sessionid apt-get upgrade
  23         [..]
  24         Do it for real [Y/n]: <Enter>
  25         [..]
  26 </code></pre>
  27
  28 * Install your build dependencies:
  29 <pre><code>
  30         $ dd-schroot-cmd -c $sessionid apt-get build-dep hello
  31         [..]
  32         Do it for real [Y/n]: <Enter>
  33         [..]
  34 </code></pre>
  35
  36 * Change root to Debian unstable chroot:
  37 <pre><code>
  38         $ schroot -r -c $sessionid
  39 </code></pre>
  40
  41 * Download your source:
  42 <pre><code>
  43         (sid_arch-dchroot)user@porterbox:~$ apt-get source hello
  44 </code></pre>
  45
  46 * 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:
  47 <pre><code>
  48         (sid_arch-dchroot)user@porterbox:~$ exit
  49         $ schroot -e -c $sessionid
  50         $ exit
  51 </code></pre>
  52
  53 * List (your) open sessions:
  54 <pre><code>
  55         $ schroot-list-sessions
  56 or
  57         $ schroot --list --all-sessions
  58 </code></pre>
  59
  60 * You should be done by now. If you find any issue, please report to debian-admin@lists.debian.org.