using schroot in debian.org porterboxes

When logging into Debian porterbox machine:

• List available chroots:

    $ schroot -l

• Begin a persistent schroot session on Debian unstable (or in the case of backports replace sid with, for example, jessie-backports):

    # Pick your own session name:
    $ echo -n "Session ID: " && read sessionid && schroot -b -c sid -n $sessionid
    # or use a random one:
    $ sessionid=$(schroot -b -c sid)

• Update and upgrade Debian unstable chroot:

    $ dd-schroot-cmd -c $sessionid apt-get update
    $ dd-schroot-cmd -c $sessionid apt-get dist-upgrade
    [..]
    Do it for real [Y/n]: 
    [..]

• Install your build dependencies:

    $ dd-schroot-cmd -c $sessionid apt-get build-dep hello
    [..]
    Do it for real [Y/n]: 
    [..]

• In the case of backports (or experimental), you can install a given package. You could use, for example:

    $ dd-schroot-cmd -c $sessionid apt-get install debhelper/jessie-backports
    [..]

• Change root to Debian unstable chroot:

    $ schroot -r -c $sessionid

• Download your source:

    (sid_arch-dchroot)user@porterbox:~$ apt-get source hello

• 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:

    (sid_arch-dchroot)user@porterbox:~$ exit
    $ schroot -e -c $sessionid
    $ exit

• List your currently open sessions:

    $ schroot-list-sessions

• List all currently open sessions:

    $ schroot --list --all-sessions

• You should be done by now. If you find any issue, please report to debian-admin@lists.debian.org.