diff options
Diffstat (limited to 'debian/manpages/a2enconf.8')
-rw-r--r-- | debian/manpages/a2enconf.8 | 101 |
1 files changed, 101 insertions, 0 deletions
diff --git a/debian/manpages/a2enconf.8 b/debian/manpages/a2enconf.8 new file mode 100644 index 0000000..7cd2df4 --- /dev/null +++ b/debian/manpages/a2enconf.8 @@ -0,0 +1,101 @@ +.\" 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] [\-m|\-\-maintmode] [ +.IR configuration +] +.PP +.B a2disconf +[\-q|\-\-quiet] [\-m|\-\-maintmode] [\-p|\-\-purge] [ +.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), +.BR a2ensite (8), +.BR a2dissite (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. |