summaryrefslogtreecommitdiffstats
path: root/debian/manpages/a2enconf.8
blob: 6f3a02b2c0f3b49d95ca26f5c950646ee230dea0 (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
.\"                                      Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH A2ENCONF 8 "14 February 2012"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
a2enconf, a2disconf \- enable or disable an apache2 configuration file
.SH SYNOPSIS
.B a2enconf
[ [\-q|\-\-quiet]
.IR configuration ]
.PP
.B a2disconf
[ [\-q|\-\-quiet]
.IR configuration ]
.SH DESCRIPTION
This manual page documents briefly the
.B a2enconf
and
.B a2disconf
commands.
.PP
.B a2enconf
is a script that enables the specified configuration file within the
.B apache2
configuration.  It does this by creating symlinks within
.BR /etc/apache2/conf-enabled .
Likewise,
.B a2disconf
disables a specific configuration part by removing those symlinks.  It is not an
error to enable a configuration which is already enabled, or to disable one which is
already disabled.
.PP
Note that many configuration file may have a dependency to specific modules.
Unlike module dependencies, these are not resolved automatically. Configuration
fragments stored in the conf-available directory are considered non-essential or
being installed and manged by reverse dependencies (e.g. web scripts).
.SH OPTIONS
.TP
.B \-q, \-\-quiet
Don't show informative messages.
.TP
.B \-m, \-\-maintmode
Enables the maintainer mode, that is the program invocation is effectuated
automatically by a maintainer script. This switch should not be used by end
users.
.TP
.B \-p, \-\-purge
When disabling a module, purge all traces of the module in the internal state
data base.
.SH "EXIT STATUS"
.B a2enconf
and
.B a2disconf
exit with status 0 if all
.IR configuration s
are processed successfully, 1 if errors occur, 2 if an invalid option was used.
.SH EXAMPLES
.RS
.B "a2enconf security"
.br
.B "a2disconf charset"
.RE
.PP
Enables Apache security directives stored in the
.B security
configuration files, and disables the
.B charset
configuration.
.SH FILES
.TP
.B /etc/apache2/conf-available
Directory with files giving information on available configuration files.
.TP
.B /etc/apache2/conf-enabled
Directory with links to the files in
.B conf-available
for enabled configuration files.
.SH "SEE ALSO"
.BR apache2ctl (8),
.BR a2enmod (8),
.BR a2dismod (8).
.SH AUTHOR
This manual page was written by Arno Toell <debian@toell.net> for the Debian
GNU/Linux distribution, as it is a Debian-specific script with the package.