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
|
.TH UCF.CONF 5 "Dec 31 2024" Debian "Debian GNU/Linux manual"
.SH NAME
ucf.conf \- site\-wide configuration file for
.B ucf
.SH SYNOPSIS
.I /etc/ucf.conf
.SH DESCRIPTION
The file
.I /etc/ucf.conf
is a
.B POSIX Shell
snippet sourced by
.BR ucf (1)
and
.BR ucfr (1).
It can contain any shell directive
(just ensure you know what you are doing).
.PP
All the variables have reasonable default values,
but they be overridden on a site\-wide or per\-run basis.
.TP 3
a)
Some variables can be set in the config file
.IR /etc/ucf.conf .
These values override the defaults.
.IP b)
Some variables can also be set by setting a corresponding environment
variable.
These values take precedence over the config file.
.SH Configuration File options
At the moment,
the user modifiable variables supported are:
.TP 18
.B DEBUG
Debugging information:
The default value is 0
(no debugging information is printed).
To enable debugging output,
set the value to
1.
.TP
.B VERBOSE
Verbosity:
The default value is 0 (quiet).
To change the default behavior,
set the value to 1.
.TP
.B conf_force_conffold
Force the installed file to be retained.
The default is to have this variable unset,
which makes the script ask in case of doubt.
This can also be overridden by the environment variable
.B UCF_FORCE_CONFFOLD
.TP
.B conf_force_conffnew
Force the installed file to be overwritten.
The default is to have this variable unset,
which makes the script ask in case of doubt.
This can also be overridden by the environment variable
.B UCF_FORCE_CONFFNEW
.TP
.B conf_source_dir
This is the directory where the historical md5sums for a file are
looked for.
Specifically,
the historical md5sums are looked for in either the file
.IR ${filename}.md5sum ,
or the subdirectory
.I ${filename}.md5sum.d/
.TP
.B conf_old_mdsum_file
Force the historical md5sums to be read from this file,
rather than defaulting to living in the source directory.
Setting this option overrides settings in the environment variable
.B UCF_OLD_MDSUM_FILE
.SH Files
System\-wide defaults are placed in
.IR /etc/ucf.conf ,
.SH SEE ALSO
.BR ucf (1), ucfr (1)
.SH BUGS
There are no bugs.
Any resemblance thereof is delirium.
Really.
.SH AUTHOR
This manual page was written by Manoj Srivastava <srivasta@debian.org>,
for the Debian GNU/Linux system.
|