aboutsummaryrefslogtreecommitdiffstats
path: root/upgrade-helper.conf
blob: 251c36acc85526636845849cb88a790e52d7c769 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
#
# This file is your upgrade-helper configuration files and is where all local user
# settings specifically for AUH are placed. The comments in this file provide some
# guidelines to the options a new user to AUH tool might want to change.
#
# This file should be placed inside your BUILDDIR/upgrade-helper after initializing
# the OE build environment (this location can be overriden with -c command line option).
#
# Lines starting with the '#' character are commented out and in some cases the
# default values are provided as comments to show people example syntax. Enabling
# the option is a question of removing the # character and making any change to the
# variable as required. For boolean settings, anything not 'yes' is treated as 'no'.

[maintainer_override]
# e-mail message for recipe upgrades will go to john.doe instead of jane.doe, etc
# see also the global_maintainer_override option
#jane.doe@doe.com=john.doe@doe.com
#johhny.bravo@bravo.com=john.doe@doe.com

[settings]
# SMTP server that is used to send e-mails with patches and other information.
# If you are running AUH locally, you do not need to set this up, as AUH
# saves everything to BUILDDIR/upgrade-helper/<timestamp>, and does not attempt
# to send email messages (unless explicitly asked with -e command line option).
# If no port is specified, port 25 is assumed.
#smtp=smtp.my-server.com:25

# from whom should the e-mails be sent (mandatory if --send-emails is passed).
# Also sets the email address of the author of automated commits.
#from=uh@not.set

# If enabled, emails for all recipe upgrades will go to john.doe, 
# except when recipes are owned by specific maintainer_override entries above.
#global_maintainer_override=john.doe@doe.com

# who should be CCd with all upgrade emails (optional)
#cc_recipients=john.doe@doe.com

# who should get the status mail with statistics, at the end (mandatory if
# --send-emails is passed)
#status_recipients=john.doe@doe.com

# Only recipes belonging to maintainers in whitelist will be attempted
# Insert your own e-mail address here together with any other maintainers' addresses
# whose recipes you wish to take care of. This restricts the set of recipes that AUH
# will attempt when it is run with 'all' option.
#maintainers_whitelist=jane.doe@doe.com john.doe@doe.com johhny.bravo@bravo.com

# recipes in blacklist will be skipped (applies only when 'all' or no recipe is
# passed; does not apply when layer_mode is enabled).
#blacklist=python glibc gcc

# specify the directory where work (patches) will be saved 
# (optional; default is BUILDDIR/upgrade-helper/)
#workdir=

# public url with AUH results to include in statistics summary (optional)
#publish_work_url=http://auh.somehost.com/work

# whether to attach a tarball with AUH artefacts (patches, log, buildhistory, etc.)
# to the summary email
#summary_includes_tarball=True

# clean sstate directory before upgrading
# Generally not necessary, as bitbake can handle this automatically.
#clean_sstate=no

# clean tmp directory before upgrading
# Generally not necessary as bitbake can handle this automatically.
#clean_tmp=no

# Machines to test build with.
# Append _libc-name to test with alternative C library implementations
# e.g. qemux86_musl.
#
# Buildhistory and testimages will be created only for the first
# machine in the list, as otherwise it adds enormously to AUH run time.
#
# AUH has a reasonable default for this, so you do not need to set your own,
# at least initially.
#
# Does not apply when layer_mode is enabled.
#machines=qemux86 qemux86-64 qemuarm qemumips qemuppc qemux86_musl

# Enables buildhistory feature; this is useful as it produces information
# about what has changed in the resulting packages, compared to previous version
#
# Requires 'buildhistory' to be present in INHERIT and BUILDHISTORY_COMMIT to be set
# in your conf/local.conf.
#buildhistory=no

# When AUH has built an upgraded recipe it then creates a commit with the upgrade.
# This setting specifies whether to also revert the commit. Possible values are:
# 'failed_to_build' (default) - revert if the recipe failed to build. This is useful
# to prevent further upgrades in the batch from failing, if they're dependent on the
# recipe.
# 'all' - always revert. This is useful when running automatic, unattended upgrades,
#  as it will effectively test each upgrade against the baseline, and will avoid the 
# situation where one successful upgrade thwarts others due to newly introduced 
# incompatibilities.
# 'never' - never revert. Use in interactive upgrade sessions, where any issues can be
# manually fixed.
#commit_revert_policy=failed_to_build

# If enabled, build and boots a test image, and runs integration tests on it
# If upgraded packages have ptest support those are run as well
#
# Requires 'testimage' in INHERIT in your conf/local.conf and 'ptest' in your
# distro's DISTRO_FEATURES.
#testimage=no

# This can be used to change the name of the test image.
#
#testimage_name=core-image-sato

# This can be used to upgrade recipes in a specific layer,
# for example meta-intel, instead of upgrading oe-core recipes.
#
# When layer_mode is enabled, layer_name, layer_dir and layer_machines are
# mandatory. 'blacklist' setting does not apply when in layer_mode.
#layer_mode=no
#layer_name=meta-intel
#layer_dir=DIR/meta-intel
#layer_machines=intel-core2-32 intel-corei7-64 intel-quark