diff options
Diffstat (limited to 'debian/manpages/a2enmod.8')
-rw-r--r-- | debian/manpages/a2enmod.8 | 104 |
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. |