summaryrefslogtreecommitdiffstats
path: root/man/etc-update.1
blob: 366e8500bd4081b8a30b3d1775e1ba384dae2c4d (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
.TH "ETC-UPDATE" "1" "Mar 2012" "Portage VERSION" "Portage"
.SH NAME
etc-update \- handle configuration file updates
.SH SYNOPSIS
.BR etc-update
[\fIoptions\fR] [\fI--automode <mode>\fR] [\fIpaths to scan\fR]
.SH DESCRIPTION
.I etc-update
is supposed to be run after merging a new package to see if
there are updates to the configuration files.  If a new
configuration file will override an old one, 
.I etc-update 
will prompt the user for a decision.
.PP
.I etc-update
will check all directories specified on the command line.  If no paths
are given, then the \fICONFIG_PROTECT\fR variable will be used.  All
config files found in \fICONFIG_PROTECT_MASK\fR will automatically be
updated for you by \fIetc-update\fR.  See \fBmake.conf\fR(5) for more
information.
.PP
.I etc-update
respects the normal \fIPORTAGE_CONFIGROOT\fR and \fIEROOT\fR variables
for finding the aforementioned config protect variables.
.SH OPTIONS
.TP
.BR \-d ", " \-\-debug
Run with shell tracing enabled.
.TP
.BR \-h ", " \-\-help
Surprisingly, show the help output.
.TP
.BR \-p ", " \-\-preen
Automerge trivial changes only and quit.
.TP
.BR \-v ", " \-\-verbose
Show settings and important decision info while running.
.TP
.BR "\-\-automode <mode>"
Select one of the automatic merge modes.  Valid modes are: -3 -5 -7 -9.
See the \fI\-\-help\fR text for more details.
.SH "REPORTING BUGS"
Please report bugs via http://bugs.gentoo.org/
.SH AUTHORS
.nf
Jochem Kossen and Leo Lipelis
Karl Trygve Kalleberg <karltk@gentoo.org>
Mike Frysinger <vapier@gentoo.org>
.fi
.SH "FILES"
.TP
.B /etc/etc-update.conf
Configuration settings for \fIetc-update\fR are stored here.
.SH "SEE ALSO"
.BR dispatch-conf (1),
.BR make.conf (5)