summaryrefslogtreecommitdiffstats
path: root/debian/manpages/a2enmod.8
diff options
context:
space:
mode:
Diffstat (limited to 'debian/manpages/a2enmod.8')
-rw-r--r--debian/manpages/a2enmod.8104
1 files changed, 104 insertions, 0 deletions
diff --git a/debian/manpages/a2enmod.8 b/debian/manpages/a2enmod.8
new file mode 100644
index 0000000..0d11825
--- /dev/null
+++ b/debian/manpages/a2enmod.8
@@ -0,0 +1,104 @@
+.\" 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 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.