X-Git-Url: https://git.adam-barratt.org.uk/?a=blobdiff_plain;f=input%2Fdoc%2Fschroot.mdwn;h=f052c61ec1337bff961870f5f72b5d2683c9d8de;hb=0721aced26a00ba57591c2f8a9e93a4860d51c40;hp=4fecdde539379a3f9ea2382644726bfb9c96b6fc;hpb=bcf0607bd3940596cb696c2bb10e5542dd15d3dd;p=mirror%2Fdsa-wiki.git diff --git a/input/doc/schroot.mdwn b/input/doc/schroot.mdwn index 4fecdde..f052c61 100644 --- a/input/doc/schroot.mdwn +++ b/input/doc/schroot.mdwn @@ -1,60 +1,69 @@ using schroot in debian.org porterboxes ======================================= -When logging into Debian porterbox machine, it should display similar message: - -
-Welcome to porterbox.debian.org, the Debian arch porterbox.
-
-See 'schroot -l' for a list of available chroots. Start new sessions
-with 'schroot --begin-session -c ', run commands in sessions using
-'schroot --run-session -c [-- command]', and tear down sessions
-using 'schroot --end-session -c '. You can run a limited set of
-privileged commands, for instance some of apt-get, using
-'dd-schroot-cmd -c '.
-Use 'schroot --list --all-sessions' or 'schroot-list-sessions []'
-to list (your) open sessions.
-
-This server is hosted at data centre.
-
-
-The previous description is rather compact and dense, so let's try to describe the usage in more friendly way.
+When logging into Debian porterbox machine:
* List available chroots:
-
+
$ schroot -l
+
-* Begin a persistent schroot session on Debian unstable:
-
- $ schroot -b -c sid -n mysid
+* 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 mysid apt-get update
- $ dd-schroot-cmd -c mysid apt-get upgrade
+
+ $ dd-schroot-cmd -c $sessionid apt-get update
+ $ dd-schroot-cmd -c $sessionid apt-get upgrade
[..]
Do it for real [Y/n]:
[..]
+
-* Install your broken package build dependencies:
-
- $ dd-schroot-cmd -c mysid apt-get build-dep gentoo
+* Install your build dependencies:
+
+ $ dd-schroot-cmd -c $sessionid apt-get build-dep hello
[..]
Do it for real [Y/n]:
[..]
+
-* Change root to Debian unstable chroot:
-
- $ schroot -r -c mysid
+* In the case of backports, you can install a given package. You could use, for example:
+
+ $ dd-schroot-cmd -c $sessionid apt-get install debhelper/jessie-backports
+ [..]
+
-* Download your broken package source:
+* Change root to Debian unstable chroot:
+
+ $ schroot -r -c $sessionid
+
- (sid_arch-dchroot)user@porterbox:~$ apt-get source gentoo
+* 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 mysid
+ $ 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.