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
125
126
|
.\" 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 A2ENMOD 8 "12 October 2006"
.\" 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
a2enmod, a2dismod \- enable or disable an apache2 module
.SH SYNOPSIS
.B a2enmod
[\-q|\-\-quiet] [\-m|\-\-maintmode] [
.IR module
]
.PP
.B a2dismod
[\-q|\-\-quiet] [\-f|\-\-force] [\-m|\-\-maintmode] [\-p|\-\-purge] [
.IR module
]
.SH DESCRIPTION
This manual page documents briefly the
.B a2enmod
and
.B a2dismod
commands.
.PP
.B a2enmod
is a script that enables the specified module within the
.B apache2
configuration. It does this by creating symlinks within
.BR /etc/apache2/mods-enabled .
Likewise,
.B a2dismod
disables a module by removing those symlinks. It is not an error to
enable a module which is already enabled, or to disable one which is
already disabled.
.PP
Note that many modules have, in addition to a .load file, an
associated .conf file. Enabling the module puts the configuration
directives in the .conf file as directives into the main server context of
.B apache2.
.SH OPTIONS
.TP
.B \-q, \-\-quiet
Don't show informative messages.
.TP
.B \-f, \-\-force
When disabling a module, also cascade disables all modules that depends on it.
.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 a2enmod
and
.B a2dismod
exit with status 0 if all
.IR module s
are processed successfully, 1 if errors occur, 2 if an invalid option was used.
.SH EXAMPLES
.RS
.B "a2enmod imagemap"
.br
.B "a2dismod mime_magic"
.RE
.PP
Enables the
.B mod_imagemap
module, and disables the
.B mod_mime_magic
module.
.SH "ENVIRONMENT"
.sp
The following environment variables may be specified\&.
.sp
.TP
.B dir_suffix
Distinguish different instances of apache2. Suffixes /etc/apache2 to build a new APACHE_CONFDIR
.TP
.B APACHE_CONFDIR
Override the entire configuraation directory (/etc/apache2$dir_suffix)
.TP
.B APACHE_ENVVARS
Override the default envvars file (/etc/apache2$dir_suffix/envvars)
.TP
.B APACHE_{MODS,CONF,SITES}_AVAIL
Override the path to the directory holding the available snippets for modules, configuration and sites.
.TP
.B APACHE_{MODS,CONF,SITES}_ENABLED
Override the path to the directory holding the enabled snippets for modules, configuration and sites. For example, in a multi-instance setup, you can set dir_suffix=-myinstance and override APACHE_MODS_AVAIL back to /etc/apache2/mods-available to have a single store of snippets for all instances
.TP
.B APACHE_STATE_DIRECTORY
Override the path to the state directory (/var/lib/apache2)
.SH FILES
.TP
.B /etc/apache2/mods-available
Directory with files giving information on available modules.
.TP
.B /etc/apache2/mods-enabled
Directory with links to the files in
.B mods-available
for enabled modules.
.SH "SEE ALSO"
.BR apache2ctl (8),
.BR a2enconf (8),
.BR a2disconf (8),
.BR a2ensite (8),
.BR a2dissite (8).
.SH AUTHOR
This manual page was written by Daniel Stone <daniel@sfarc.net> for the Debian
GNU/Linux distribution, as it is a Debian-specific script with the package.
|
