← Back to branch summary

~ubuntu-branches/ubuntu/edgy/sbuild/edgy

« back to all changes in this revision

Viewing changes to bin/README.bins

  • Committer: Bazaar Package Importer
  • Author(s): Michael Banck
  • Date: 2005-04-01 21:23:30 UTC
  • mfrom: (1.1.1 warty)
  • Revision ID: james.westby@ubuntu.com-20050401212330-lnjvuwrm9urpy54l
Tags: 0.35
http://bugs.debian.org/287672
http://bugs.debian.org/300145
http://bugs.debian.org/292717
http://bugs.debian.org/300205
Michael Banck:

* bin/abort-current-build: Remove the `-B' from the grep line as
  `sbuild -s' does not pass that option to dpkg-configure and abort-
  current-build fails in that case.
* sbuild: Set the locale to `POSIX' to make debconf and debhelper calls in
  the chroot not spew out locale warnings all the time.
  (closes: #287672)
* sbuild: Removed check for specific distributions. Instead, fail if
  build/chroot-$dist is not there.
* sbuild: Only override Distribution in .changes if specified as option on
  the command-line.
  (closes: #300145)
* sbuild: Specify full path for Dir::Etc::main and Dir::Etc::parts.
* example.sbuildrc: Clarify that $maintainer_name is not mandatory and
  overrides Maintainer: field, whereas $uploader_name overrides
  the Changed-By: field in changes.
* Applied patch by Santiago Vila:
  - Moves scripts from /usr/lib/sbuild to /usr/share/sbuild and modifies
    all callers accordingly.
  - Add -n option to tail to comply with POSIX.
  - Call /usr/sbin/sendmail instead of /usr/lib/sendmail.
  (closes: #292717)
* sbuild: Tolerate '0' as version number, thanks Santiago Vila.
  (closes: #300205)

Show diffs side-by-side

added added

removed removed

Lines of Context:
bin/README.bins
1
 
[ This doc needs work and the scripts aren't well tested, esp.
2
 
  SBUILD_CHROOT_ROOT. ]
3
 
 
4
 
These are some useful utilities for accessing/maintaining
5
 
the chroots.  Most of them understand the environment
6
 
variable SBUILD_CHROOT_ROOT; useful if your chroots aren't at
7
 
/usr/local/chroot.
8
 
 
9
 
export SBUILD_CHROOT_ROOT=/org/debian
10
 
 
11
 
 ------------------------------------------
12
 
        checkchroot
13
 
 
14
 
Shows how the contents of the chroots differ from a reference.
15
 
This requires the ref-{stable,unstable} files to be in the
 
1
 
 
2
These are some useful utilities for accessing/maintaining the
 
3
chroots.
 
4
 
 
5
The <chroot> arg used by most scripts has two forms:
 
6
 
 
7
  . s,stable,-t,testing,-u,unstable
 
8
 
 
9
    - a symlink ~/build/chroot-{stable,testing,unstable} pointing
 
10
      to the chroot must exist
 
11
 
 
12
  . an absolute path
 
13
 
 
14
    - in this case the argument is parsed to try and determine
 
15
      the distribution, for those scripts that need it:
 
16
 
 
17
      checkchroot /usr/local/chroot/unstable-security
 
18
        - CHROOT=/usr/local/chroot/unstable
 
19
        - DIST=unstable so it can find the ref-unstable reference file
 
20
 
 
21
The scripts:
 
22
 
 
23
 ------------------------------------------
 
24
    abort-current-build
 
25
 
 
26
Aborts the current dpkg-buildpackage process.
 
27
Author: Roman Hodek
 
28
 
 
29
 ------------------------------------------
 
30
    checkchroot <chroot>
 
31
 
 
32
Shows how the contents of the chroot differs from a reference.
 
33
This requires the ref-{stable,testing,unstable} files to be in the
16
34
chroot root:
17
 
# cp /usr/share/doc/sbuild/configs/ref-{stable,unstable} /usr/local/chroot
18
35
 
19
 
If your chroots aren't at /usr/local/chroot, the script
20
 
understands the envvar SBUILD_CHROOT_ROOT,
21
 
$ export SBUILD_CHROOT_ROOT=/org/debian
 
36
    # cp /usr/share/doc/sbuild/configs/ref-{stable,testing,unstable} \
 
37
        /usr/local/chroot
22
38
 
23
39
The chroots should only include essential & build-essential
24
 
packages and the packages that sbuild needs -- apt, fakeroot,
 
40
packages and the extra packages that sbuild needs: apt, fakeroot,
25
41
ssmtp, sudo.  Please check that the references are accurate for
26
42
your arch.
27
43
 
28
44
 ------------------------------------------
29
 
        chr-hold
30
 
        chr-unhold
31
 
 
32
 
For changing the hold/install status of packages in the chroots
33
 
 
34
 
 ------------------------------------------
35
 
        chrapt
36
 
        chrootapt
37
 
 
38
 
These run apt-get in the chroot from base.  chrootapt has
39
 
"apt-get" understood.  You have to actually type apt-get with
40
 
chrapt but it allows you to also run apt-cache.
41
 
 
42
 
 ------------------------------------------
43
 
        finish-build
44
 
 
45
 
 ------------------------------------------
46
 
        gochroot
47
 
 
48
 
Enter the chroot
49
 
 
50
 
 ------------------------------------------
51
 
        updatechroot
52
 
        upgradechroot
 
45
    chr-hold <chroot> pkg [pkg..]
 
46
    chr-unhold <chroot> pkg [pkg..]
 
47
 
 
48
For changing the hold/install status of packages in the chroots.
 
49
 
 
50
 ------------------------------------------
 
51
    chrapt <chroot> apt-get|apt-cache arguments
 
52
 
 
53
Runs apt-get or apt-cache in the chroot from base.
 
54
 
 
55
 ------------------------------------------
 
56
    gochroot <chroot>
 
57
 
 
58
Enter the chroot.
 
59
 
 
60
 ------------------------------------------
 
61
    updatechroot
 
62
    upgradechroot
 
63
 
 
64
Scripts to keep the chroots up to date.  Can be run as cron jobs
 
65
from base.
 
66
 
 
67
 ------------------------------------------
 
68
    add_sbuild_user /path/to/chroot <dist> <user>
 
69
 
 
70
A script to add a new user to a chroot.  See
 
71
/usr/share/doc/sbuild/README-buildd.chroot.
 
72
 
 
73
 ------------------------------------------
 
74
    dobuildlog
 
75
 
 
76
A shell script for mutt & vi to handle the build logs that
 
77
sbuild mails to you.  The "bug" option is generally useful as it
 
78
massages the build log a little so you can easily file a bug.
 
79
The other options are for communicating with a build daemon.
 
80
 
 
81
From the script:
 
82
# craft a bug report or fail/success reply to a buildd log mail
 
83
# using vim, mutt and optionally quintuple-agent:
 
84
#   mutt
 
85
#       'f'orward the message
 
86
#       (may require autoedit & edit_headers .muttrc settings)
 
87
#   vim
 
88
#       map <F3> :%!~buildd/bin/dobuildlog agpg<CR>
 
89
#       map <S-F3> :%!~buildd/bin/dobuildlog gpg<CR>
 
90
#       map <F4> :%!~buildd/bin/dobuildlog bug<CR>
 
91
 
 
92
You'll have to change these to your own settings:
 
93
SIGNOPTS='--clearsign --default-key younie@debian.org'
 
94
FROM="$EMAIL"   # "Your Name <your@addr.ess>"
 
95
ARCH=m68k       # for the bug report log link
 
96
 
 
97
Please see the comments in the script.
53
98
 
54
99
 ------------------------------------------
55
100
<PLUG>
59
104
ppack -r un -I[q] '*'       # shows installed packages in unstable
60
105
ppack -r un -a              # shows anomalies (holds, misconfigured pkgs)
61
106
 
62
 
ppack -Lb pkg               # urlified package listing -> browser
 
107
ppack -r st -Lb pkg         # urlified a package listing -> browser
63
108
  - this is useful for browsing an installed packages contents.  Try
64
109
    "ppack -Lb sbuild" although it may be a little late for that now. :-)
65
110